diff --git a/design/N4JSDesign.html b/design/N4JSDesign.html
new file mode 100644
index 0000000..8a7d6d8
--- /dev/null
+++ b/design/N4JSDesign.html
@@ -0,0 +1,16961 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="generator" content="Asciidoctor 1.5.5">
+<meta name="author" content="2019-08-07 15:02:40 CEST">
+<title>N4JS Design Specification</title>
+<link rel="stylesheet" href="styles/spec.min.css">
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.6.3/css/font-awesome.min.css">
+<!-- ************* docinfo ******************************************************************* -->
+
+
+<!-- ************* Favicon ************-->
+<link rel="icon" href="images/favicon.ico" />
+
+<!-- ************* Back-to-top JQuery ************* -->
+<script src="https://code.jquery.com/jquery-1.12.4.js"></script>
+<script src="https://code.jquery.com/ui/1.12.0/jquery-ui.js"></script>
+
+
+<link href="styles/prism.min.css" rel="stylesheet" />
+<script type="text/javascript" async
+  src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2/MathJax.js?config=TeX-MML-AM_CHTML">
+</script>
+
+<!-- ************* Styles ************* -->
+<link rel="stylesheet" type="text/css" href="styles/n4jsspec-adoc.css">
+
+
+<!-- ****************** NavBar ****************** -->
+<div id="menubar">
+	<div class="banner">
+        <a href="https://www.eclipse.org/n4js/#"><img id="logo" src="images/n4js-logo.png" alt="Eclipse N4JS"></a>
+    </div>
+<ul>
+  <li><a href="index.html">Index</a></li>
+</ul>
+</div>
+<!-- ************* docinfo ******************************************************************* -->
+<style>
+      .admonitionblock td.icon .icon-todo:before{content:"\f249";color:#f4ee42}
+    </style>
+</head>
+<body class="book toc2 toc-left">
+<div id="header">
+<h1>N4JS Design Specification</h1>
+<div class="details">
+<span id="author" class="author">2019-08-07 15:02:40 CEST</span><br>
+<span id="revnumber">version 0.9</span>
+</div>
+<div id="toc" class="toc2">
+<div id="toctitle">Table of Contents</div>
+<ul class="sectlevel1">
+<li><a href="#_introduction">1. Introduction</a>
+<ul class="sectlevel2">
+<li><a href="#notation">1.1. Notation</a></li>
+<li><a href="#sec:IDE_Overview">1.2. IDE Components</a>
+<ul class="sectlevel3">
+<li><a href="#sec:Naming_Conventions">1.2.1. Naming Conventions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#_eclipse-setup">2. Eclipse Setup</a>
+<ul class="sectlevel2">
+<li><a href="#_system-requirements">2.1. System Requirements</a></li>
+<li><a href="#_contribute">2.2. Contribute</a>
+<ul class="sectlevel3">
+<li><a href="#_eclipse-installer">2.2.1. Eclipse Installer</a>
+<ul class="sectlevel4">
+<li><a href="#_changing-the-setup-script">2.2.1.1. Changing the Setup Script</a></li>
+</ul>
+</li>
+<li><a href="#_manual-ide-configuration">2.2.2. Manual IDE Configuration</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#_release-engineering">3. Release Engineering</a>
+<ul class="sectlevel2">
+<li><a href="#_nightly-build-on-eclipse-infrastructure">3.1. Nightly build on Eclipse infrastructure</a></li>
+<li><a href="#_build-the-n4js-ide-from-command-line">3.2. Build the N4JS IDE from command line</a>
+<ul class="sectlevel3">
+<li><a href="#_publish-maven-tooling-code-org-eclipse-n4js-releng-util-code">3.2.1. Publish maven-tooling <code>org.eclipse.n4js.releng.util</code></a></li>
+<li><a href="#sec:test-verdaccio">3.2.2. Test Verdaccio containing n4js-libs</a></li>
+<li><a href="#_generation-of-eclipse-help-for-spec-and-design-document">3.2.3. Generation of Eclipse help for spec and design document</a></li>
+</ul>
+</li>
+<li><a href="#_updating-frameworks-and-dependencies">3.3. Updating frameworks and dependencies</a>
+<ul class="sectlevel3">
+<li><a href="#_update-of-eclipse-emf-xtext-etc">3.3.1. Update of Eclipse, EMF, Xtext, etc.</a></li>
+<li><a href="#_update-of-the-embedded-jre">3.3.2. Update of the embedded JRE</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#_tips-and-tricks">4. Tips and Tricks</a>
+<ul class="sectlevel2">
+<li><a href="#_naming">4.1. Naming</a></li>
+<li><a href="#_logging">4.2. Logging</a></li>
+<li><a href="#_cancellation-handling">4.3. Cancellation Handling</a></li>
+<li><a href="#_caching">4.4. Caching</a></li>
+<li><a href="#_dependency-injection">4.5. Dependency Injection</a></li>
+<li><a href="#_miscellaneous">4.6. Miscellaneous</a></li>
+</ul>
+</li>
+<li><a href="#_parser">5. Parser</a>
+<ul class="sectlevel2">
+<li><a href="#sec:Parser_Overview">5.1. Overview</a></li>
+<li><a href="#sec:N4JS_Parser">5.2. N4JS Parser</a></li>
+<li><a href="#sec:Parser_Generation_Post_Processing">5.3. Parser Generation Post-Processing</a>
+<ul class="sectlevel3">
+<li><a href="#sec:Automatic_Semicolon_Insertion">5.3.1. Automatic Semicolon Insertion</a>
+<ul class="sectlevel4">
+<li><a href="#sec:Injected_code_in_the_Antlr_grammar_file">5.3.1.1. Injected code in the Antlr grammar file</a></li>
+<li><a href="#sec:Customized_error_recovery">5.3.1.2. Customized error recovery</a></li>
+</ul>
+</li>
+<li><a href="#sec:_No_line_terminator_allowed_here__handling">5.3.2. Async and <code>No line terminator allowed here</code> Handling</a></li>
+<li><a href="#sec:Regular_Expression">5.3.3. Regular Expression</a></li>
+<li><a href="#sec:Unicode">5.3.4. Unicode</a></li>
+<li><a href="#sec:Literals">5.3.5. Literals</a></li>
+</ul>
+</li>
+<li><a href="#sec:Modifiers">5.4. Modifiers</a></li>
+<li><a href="#sec:Conflict_Resolutions">5.5. Conflict Resolutions</a>
+<ul class="sectlevel3">
+<li><a href="#sec:Reserved_Keywords_vs__Identifier_Names">5.5.1. Reserved Keywords vs. Identifier Names</a></li>
+<li><a href="#sec:Operators_and_Generics">5.5.2. Operators and Generics</a></li>
+</ul>
+</li>
+<li><a href="#sec:Content_Assist_Parser">5.6. Content-Assist Parser</a></li>
+</ul>
+</li>
+<li><a href="#_type-system">6. Type System</a>
+<ul class="sectlevel2">
+<li><a href="#sec:Type_Model_and_Grammar">6.1. Type Model and Grammar</a>
+<ul class="sectlevel3">
+<li><a href="#sec:Type_Model_Overview">6.1.1. Type Model Overview</a></li>
+<li><a href="#sec:Built_in_Types">6.1.2. Built-in and Primitive Types</a></li>
+<li><a href="#sec:Type_Model_DSL">6.1.3. Type Model DSL</a></li>
+</ul>
+</li>
+<li><a href="#sec:Type_System_Implementation">6.2. Type System Implementation</a></li>
+<li><a href="#sec:Type_Inference_combined_with_AST_Traversal">6.3. Type Inference of AST</a>
+<ul class="sectlevel3">
+<li><a href="#sec:Type_Inference_combined_with_AST_Traversal__Background">6.3.1. Background</a></li>
+<li><a href="#sec:Triggering_Type_Inference_of_AST">6.3.2. Triggering</a></li>
+<li><a href="#sec:Traversal_Order_During_Type_Inference_of_AST">6.3.3. Traversal Order</a></li>
+<li><a href="#sec:Cross_References_During_Type_Inference_of_AST">6.3.4. Cross-References</a></li>
+<li><a href="#sec:Function_Accessor_Bodies_During_Type_Inference_of_AST">6.3.5. Function/Accessor Bodies</a></li>
+<li><a href="#sec:Poly_Expressions_During_Type_Inference_of_AST">6.3.6. Poly Expressions</a></li>
+<li><a href="#sec:Constraint_Solver_used_During_Type_Inference_of_AST">6.3.7. Constraint Solver</a></li>
+<li><a href="#sec:Type_Guards_During_Type_Inference_of_AST">6.3.8. Type Guards</a></li>
+</ul>
+</li>
+<li><a href="#sec:Structural_Typing">6.4. Structural Typing</a></li>
+</ul>
+</li>
+<li><a href="#_type-index">7. Type Index</a>
+<ul class="sectlevel2">
+<li><a href="#sec:Type_Index_Design_Rationale">7.1. Design Rationale</a>
+<ul class="sectlevel3">
+<li><a href="#sec:Getting_the_Xtext_Index_Content_IResourceDescriptions">7.1.1. Getting the Xtext Index (<code>IResourceDescriptions</code>) Content</a></li>
+</ul>
+</li>
+<li><a href="#sec:Design_Overview">7.2. Design Overview</a></li>
+<li><a href="#sec:N4JS_Resource_Load_States">7.3. N4JS Resource Load States</a></li>
+<li><a href="#sec:Type_Builder">7.4. Types Builder</a>
+<ul class="sectlevel3">
+<li><a href="#sec:Type_Inference_not_allowed_in_Type_Builder">7.4.1. Type Inference not allowed in Types Builder</a></li>
+<li><a href="#sec:ComputedTypeReferences">7.4.2. Deferred Type References</a></li>
+<li><a href="#sec:Use_cases_of_ComputedTypeRef">7.4.3. Use cases of DeferredTypeRef</a></li>
+</ul>
+</li>
+<li><a href="#sec:Incremental_Builder_Overview">7.5. Incremental Builder (Overview)</a>
+<ul class="sectlevel3">
+<li><a href="#sec:Incremental_Builder_Overview__XtextBuilder">7.5.1. XtextBuilder</a></li>
+<li><a href="#sec:Incremental_Builder_Overview__IBuilderState">7.5.2. IBuilderState</a>
+<ul class="sectlevel4">
+<li><a href="#copy-and-update-xtext-index">7.5.2.1. Copy and Update Xtext Index</a></li>
+<li><a href="#build-state-setup-phase">7.5.2.2. Build State Setup Phase</a></li>
+<li><a href="#process-queued-uris">7.5.2.3. Process Queued URIs</a></li>
+<li><a href="#queueing-affected-resources">7.5.2.4. Queueing Affected Resources</a></li>
+</ul>
+</li>
+<li><a href="#sec:Incremental_Builder_Overview__Example">7.5.3. Example</a></li>
+</ul>
+</li>
+<li><a href="#dirty-state-handling">7.6. Dirty state handling</a>
+<ul class="sectlevel3">
+<li><a href="#use-case-restoring-types-from-user-data">7.6.1. Use case: Restoring types from user data</a></li>
+<li><a href="#use-case-updating-the-xtext-index">7.6.2. Use case: Updating the Xtext index</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#_project-model">8. Project Model</a>
+<ul class="sectlevel2">
+<li><a href="#sec:Package_json">8.1. Package.json File</a></li>
+<li><a href="#_accessing-project-information">8.2. Accessing Project Information</a>
+<ul class="sectlevel3">
+<li><a href="#sec:IN4JSCore">8.2.1. IN4JSCore</a></li>
+<li><a href="#sec:N4JSModel">8.2.2. N4JSModel</a></li>
+<li><a href="#sec:N4JSWorkspace">8.2.3. N4JSWorkspace</a></li>
+<li><a href="#sec:N4JSProject">8.2.4. N4JSProject</a></li>
+<li><a href="#sec:SourceContainer">8.2.5. SourceContainer</a></li>
+<li><a href="#sec:N4JSProjectsStateHelper">8.2.6. N4JSProjectsStateHelper</a></li>
+</ul>
+</li>
+<li><a href="#sec:Caching">8.3. Caching</a>
+<ul class="sectlevel3">
+<li><a href="#_caching-of-externallibraryworkspace">8.3.1. Caching of ExternalLibraryWorkspace</a></li>
+<li><a href="#_caching-of-n4jsprojectsstatehelper">8.3.2. Caching of N4JSProjectsStateHelper</a></li>
+</ul>
+</li>
+<li><a href="#sec:WildcardPathFilter">8.4. WildcardPathFilter</a></li>
+<li><a href="#sec:ProjectUtils">8.5. ProjectUtils</a></li>
+</ul>
+</li>
+<li><a href="#_binding">9. Binding</a>
+<ul class="sectlevel2">
+<li><a href="#sec:Binding_Design_Rationale">9.1. Design Rationale</a></li>
+<li><a href="#sec:Binding_to_Members">9.2. Binding to Members</a></li>
+<li><a href="#sec:Binding_Getter_Setter">9.3. Getter / Setter Binding</a></li>
+<li><a href="#chap:Statics">9.4. Static Member Binding</a></li>
+<li><a href="#sec:Binding_Enumeration">9.5. Enumeration Literals Binding</a></li>
+<li><a href="#sec:Accessibility_of_types_and_members">9.6. Accessibility of types and members</a></li>
+<li><a href="#sec:Member_Scope_Example">9.7. Member Scope Example</a></li>
+<li><a href="#sec:Scoping_for_Members_of_Composed_Type_Explained">9.8. Scoping for Members of Composed Type (Union/Intersection) Example</a></li>
+<li><a href="#sec:Binding_of_Structurally_References_Types">9.9. Structurally References Types</a></li>
+<li><a href="#sec:Building">9.10. Building</a>
+<ul class="sectlevel3">
+<li><a href="#sec:Build_Phases">9.10.1. Build Phases</a></li>
+<li><a href="#sec:Build_Scenarios">9.10.2. Build Scenarios</a></li>
+<li><a href="#sec:Lazy_linking_problem">9.10.3. Lazy linking problem</a></li>
+</ul>
+</li>
+<li><a href="#sec:Proxies_and_Proxy_Resolution">9.11. Proxies and Proxy Resolution (Overview)</a>
+<ul class="sectlevel3">
+<li><a href="#xtexts-lazy-linking-proxies">9.11.1. Xtext’s Lazy Linking Proxies</a></li>
+<li><a href="#standard-emf-proxies">9.11.2. Standard EMF Proxies</a></li>
+<li><a href="#_how-is-proxy-resolution-triggered">9.11.3. How is Proxy Resolution Triggered?</a></li>
+<li><a href="#_when-is-proxy-resolution-allowed">9.11.4. When is Proxy Resolution Allowed?</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#_validation">10. Validation</a>
+<ul class="sectlevel2">
+<li><a href="#sec:validation_overview">10.1. Validation overview</a></li>
+<li><a href="#sec:validation_control_flow">10.2. Validation control flow</a></li>
+<li><a href="#sec:validation_issue_ids">10.3. Issue IDs and Messages</a></li>
+<li><a href="#sec:validation_usage_patterns">10.4. Usage Pattern</a></li>
+<li><a href="#sec:validation_links">10.5. Links</a></li>
+</ul>
+</li>
+<li><a href="#_references">11. References</a>
+<ul class="sectlevel2">
+<li><a href="#sec:usecases">11.1. Use cases</a></li>
+<li><a href="#sec:calculation_algorithm">11.2. Calculation algorithm</a>
+<ul class="sectlevel3">
+<li><a href="#sec:Xtext_default_implementation">11.2.1. Xtext default implementation</a></li>
+<li><a href="#sec:N4_implementation">11.2.2. N4JS implementation</a></li>
+</ul>
+</li>
+<li><a href="#sec:PerformanceOfDependencyCalculation">11.3. Performance Of Dependency Calculation</a></li>
+<li><a href="#sec:kinds_of_references">11.4. Kinds of references</a>
+<ul class="sectlevel3">
+<li><a href="#sec:Cross_References_to_be_ignored">11.4.1. Cross References to be ignored</a></li>
+<li><a href="#sec:Cross_References_to_be_handled">11.4.2. Cross References to be handled</a></li>
+</ul>
+</li>
+<li><a href="#sec:transitive_dependencies">11.5. Transitive dependencies</a></li>
+<li><a href="#sec:find-references">11.6. Find references</a>
+<ul class="sectlevel3">
+<li><a href="#_background">11.6.1. Background</a></li>
+<li><a href="#_how-find-references-work">11.6.2. How Find References Work</a>
+<ul class="sectlevel4">
+<li><a href="#_step-1-convert-cursor-position-to-declared-element">11.6.2.1. Step 1: Convert Cursor Position to Declared Element</a></li>
+<li><a href="#_step-2-convert-declared-element-to-target-uris">11.6.2.2. Step 2: Convert Declared Element to Target URIs</a></li>
+<li><a href="#_step-3-filter-potential-resources">11.6.2.3. Step 3: Filter Potential Resources</a></li>
+<li><a href="#_step-4-search-references-in-resource">11.6.2.4. Step 4: Search References in Resource</a></li>
+<li><a href="#_limitations-and-possible-enhancements">11.6.2.5. Limitations and Possible Enhancements</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#_compilation">12. Compilation</a>
+<ul class="sectlevel2">
+<li><a href="#chap:compilation">12.1. Introduction</a>
+<ul class="sectlevel3">
+<li><a href="#sec:general_design_rationals">12.1.1. General design rationals</a>
+<ul class="sectlevel4">
+<li><a href="#sec:logging_and_error_reporting">12.1.1.1. Logging and error reporting</a></li>
+<li><a href="#sec:progress_monitor">12.1.1.2. Progress monitor</a></li>
+</ul>
+</li>
+<li><a href="#sec:Xtext_Integration">12.1.2. Xtext Integration</a>
+<ul class="sectlevel4">
+<li><a href="#sec:xtext_default_behaviour">12.1.2.1. Xtext default behaviour</a></li>
+<li><a href="#sec:n4js_requirements">12.1.2.2. N4JS requirements</a></li>
+<li><a href="#sec:compiler_discovery_in_ui">12.1.2.3. Compiler discovery in UI</a></li>
+<li><a href="#sec:compiler_discovery_in_headless">12.1.2.4. Compiler discovery in headless</a></li>
+<li><a href="#sec:general_generator_implementation">12.1.2.5. General generator implementation</a></li>
+<li><a href="#sec:general_generator_activation">12.1.2.6. General generator activation</a></li>
+</ul>
+</li>
+<li><a href="#sec:Overview_of_Input_Models">12.1.3. Overview of the Input Models</a></li>
+</ul>
+</li>
+<li><a href="#sec:Core_Generator">12.2. Generators</a>
+<ul class="sectlevel3">
+<li><a href="#sec:Compiler_Components">12.2.1. Generator Components</a></li>
+<li><a href="#sec:Generator_architecture">12.2.2. Generator architecture</a></li>
+<li><a href="#sec:Unified_Compiler_Configuration">12.2.3. Unified Compiler Configuration</a></li>
+</ul>
+</li>
+<li><a href="#sec:Transpilers">12.3. Transpilers</a>
+<ul class="sectlevel3">
+<li><a href="#sec:Phases">12.3.1. Overview</a></li>
+<li><a href="#relation-between-ast-and-im">12.3.2. Relation between AST and IM</a></li>
+<li><a href="#implementation-overview">12.3.3. Implementation Overview</a></li>
+<li><a href="#sec:Guidelines_for_Implementing_Transformations">12.3.4. Guidelines for Implementing Transformations</a></li>
+<li><a href="#symbol-table-in-the-im">12.3.5. Symbol Table in the IM</a></li>
+</ul>
+</li>
+<li><a href="#sec:N4JS_to_EcmaScript_Transpiler">12.4. N4JS-to-EcmaScript Transpiler</a>
+<ul class="sectlevel3">
+<li><a href="#sec:Overview_of_Transformations">12.4.1. Overview of Transformations</a></li>
+<li><a href="#sec:Transpiling_members">12.4.2. Transpiling members</a>
+<ul class="sectlevel4">
+<li><a href="#sec:Transpiling_members__Delegating_members">12.4.2.1. Techniques for special member handling</a></li>
+<li><a href="#sec:Transpiling_members__Partial_shadowing_of_getter_setter_pairs">12.4.2.2. Partial shadowing</a></li>
+<li><a href="#sec:Transpiling_members__Consuming_or_inheriting_members_of_an_interface">12.4.2.3. Consuming or inheriting members of an interface</a></li>
+<li><a href="#sec:Transpiling_members__Static_polyfill">12.4.2.4. Static polyfill</a></li>
+<li><a href="#sec:Transpiling_members__API_implementation_stubs">12.4.2.5. API / implementation stubs</a></li>
+</ul>
+</li>
+<li><a href="#sec:Support_for_incomplete_API_implementation_testing_in_the_N4JS_to_EcmaScript_5_Transpiler">12.4.3. Support for incomplete API implementation testing</a>
+<ul class="sectlevel4">
+<li><a href="#sec:Modifications_in_Impl_projects">12.4.3.1. Modifications in Impl projects</a></li>
+<li><a href="#sec:Implementation_of_stub_generation">12.4.3.2. Implementation of stub-generation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#sec:n4jsc_Headless_Compiler_Interface">12.5. n4jsc Headless Compiler Interface</a>
+<ul class="sectlevel3">
+<li><a href="#sec:building_the_headless_compiler">12.5.1. building the headless compiler</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#_execution">13. Execution</a>
+<ul class="sectlevel2">
+<li><a href="#sec:N4JS_Project_Execution_And_Linking_Model">13.1. N4JS Project Execution And Linking Model</a>
+<ul class="sectlevel3">
+<li><a href="#subsec:N4JS_Execution_With_NodeJS">13.1.1. N4JS Execution With NodeJS</a></li>
+</ul>
+</li>
+<li><a href="#sec:N4JS_Execution_And_Linking_File">13.2. N4JS Execution And Linking File</a>
+<ul class="sectlevel3">
+<li><a href="#subsec:NodeJS_Specific_ELF">13.2.1. NodeJS Specific ELF</a></li>
+</ul>
+</li>
+<li><a href="#sec:Runners-execution">13.3. Runners</a>
+<ul class="sectlevel3">
+<li><a href="#subsec:N4_Runtime_Environments_Convention">13.3.1. N4 Runtime Environments Convention</a></li>
+<li><a href="#subsec:Passing_Information_from_IDE_to_Execution_Code_in_Runtime_Environment">13.3.2. Passing Information from IDE to Execution Code in Runtime Environment</a></li>
+<li><a href="#subsec:Runners_Design">13.3.3. Runners Design</a></li>
+</ul>
+</li>
+<li><a href="#sec:Legacy_Execution_Engine">13.4. Legacy Execution Engine</a></li>
+<li><a href="#sec:Design">13.5. Design</a>
+<ul class="sectlevel3">
+<li><a href="#sec:Usage_Outside_N4JSIDE">13.5.1. Usage Outside N4JSIDE</a>
+<ul class="sectlevel4">
+<li><a href="#sec:Use_Node_with_Maven">13.5.1.1. Use Node with Maven</a></li>
+</ul>
+</li>
+<li><a href="#sec:Usage_Inside_N4JSIDE">13.5.2. Usage Inside N4JSIDE</a></li>
+</ul>
+</li>
+<li><a href="#sec:Runtime_Injection">13.6. Runtime Injection</a>
+<ul class="sectlevel3">
+<li><a href="#sec:Running_String_Code">13.6.1. Running String Code</a></li>
+<li><a href="#sec:Running_File_Code">13.6.2. Running File Code</a></li>
+<li><a href="#sec:Injection_Code_Example">13.6.3. Injection Code Example</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#_tests">14. Tests</a>
+<ul class="sectlevel2">
+<li><a href="#sec:Performance_Tests">14.1. Performance Tests</a>
+<ul class="sectlevel3">
+<li><a href="#sec:Synthetic_Performance_Tests">14.1.1. Synthetic Performance Tests</a>
+<ul class="sectlevel4">
+<li><a href="#sec:Design_of_Generator">14.1.1.1. Design of Generator</a></li>
+<li><a href="#sec:Design_of_Performance_Test_Execution">14.1.1.2. Design of Performance Test Configuration and Execution</a></li>
+<li><a href="#sec:JUnit_Configuration">14.1.1.3. JUnit Configuration</a></li>
+<li><a href="#sec:JUnitBenchmark_Test_Configuration">14.1.1.4. JUnitBenchmark Test Configuration</a></li>
+<li><a href="#sec:JUnitBenchmark_Report_Configuration">14.1.1.5. JUnitBenchmark Report Configuration</a></li>
+<li><a href="#sec:JUnitBenchmark_Run_Configuration">14.1.1.6. JUnitBenchmark Run Configuration</a></li>
+<li><a href="#sec:JUnitBenchmark_Example">14.1.1.7. JUnitBenchmark Example</a></li>
+<li><a href="#sec:Note_on_Jenkins_Job">14.1.1.8. Note on Jenkins Job</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#sec:ECMA_Tests">14.2. ECMA Tests</a>
+<ul class="sectlevel3">
+<li><a href="#sec:Grammar_Tests">14.2.1. Grammar Tests</a>
+<ul class="sectlevel4">
+<li><a href="#sec:Negative_Tests">14.2.1.1. Negative Tests</a></li>
+<li><a href="#sec:Test_Exclusion">14.2.1.2. Test Exclusion</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#sec:Integration_Tests">14.3. Integration Tests</a></li>
+<li><a href="#sec:Test_Helpers">14.4. Test Helpers</a>
+<ul class="sectlevel3">
+<li><a href="#sec:Parameterized_N4JS_Tests">14.4.1. Parameterized N4JS tests</a>
+<ul class="sectlevel4">
+<li><a href="#sec:ParameterizedXtextRunner">14.4.1.1. ParameterizedXtextRunner</a></li>
+<li><a href="#sec:TestCodeProvider">14.4.1.2. TestCodeProvider</a></li>
+<li><a href="#sec:Example_Of_Parameterized_Parser_Test">14.4.1.3. Example of parameterized parser test</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#sec:Issue_Suppression">14.5. Issue Suppression</a></li>
+<li><a href="#sec:Xpect_Tests">14.6. Xpect Tests</a>
+<ul class="sectlevel3">
+<li><a href="#sec:Xpect_Test_Setup">14.6.1. Xpect Test Setup</a></li>
+<li><a href="#sec:Xpect_Issue_Suppression">14.6.2. Xpect Issue Suppression</a></li>
+<li><a href="#sec:Xpect_Provided_Test_Methods">14.6.3. Xpect Provided Test Methods</a>
+<ul class="sectlevel4">
+<li><a href="#errors">14.6.3.1. errors</a></li>
+<li><a href="#warnings">14.6.3.2. warnings</a></li>
+</ul>
+</li>
+<li><a href="#sec:N4JS_Specific_Xpect_Test_Methods">14.6.4. N4JS Specific Xpect Test Methods</a>
+<ul class="sectlevel4">
+<li><a href="#sec:XPECT_noerrors">14.6.4.1. noerrors and nowarnings</a></li>
+<li><a href="#sec:XPECT_scope">14.6.4.2. scope</a></li>
+<li><a href="#sec:XPECT_scopeWithPosition">14.6.4.3. scopeWithPosition</a></li>
+<li><a href="#sec:XPECT_scopeWithResource">14.6.4.4. scopeWithResource</a></li>
+<li><a href="#sec:XPECT_binding">14.6.4.5. binding</a></li>
+<li><a href="#sec:XPECT_linkedPathname">14.6.4.6. linkedPathname</a></li>
+<li><a href="#sec:XPECT_type_of">14.6.4.7. type of</a></li>
+<li><a href="#sec:XPECT_expectedType">14.6.4.8. expectedType</a></li>
+<li><a href="#sec:XPECT_elementKeyword">14.6.4.9. elementKeyword</a></li>
+<li><a href="#sec:XPECT_accessModifier">14.6.4.10. accessModifier</a></li>
+<li><a href="#sec:XPECT_compileResult">14.6.4.11. compileResult</a></li>
+<li><a href="#sec:XPECT_output">14.6.4.12. output</a></li>
+<li><a href="#sec:XPECT_outputRegEx">14.6.4.13. outputRegEx</a></li>
+<li><a href="#sec:XPECT_calculatedAccessModifier">14.6.4.14. calculatedAccessModifier</a></li>
+<li><a href="#sec:XPECT_spec">14.6.4.15. spec</a></li>
+<li><a href="#sec:XPECT_deadCode">14.6.4.16. deadCode</a></li>
+<li><a href="#sec:XPECT_returnOrThrows">14.6.4.17. returnOrThrows</a></li>
+<li><a href="#sec:XPECT_lint">14.6.4.18. lint</a></li>
+<li><a href="#sec:XPECT_lintFails">14.6.4.19. lintFails</a></li>
+</ul>
+</li>
+<li><a href="#sec:FIXME_Xpect_modifier">14.6.5. FIXME Xpect modifier</a></li>
+<li><a href="#sec:Expectmatrix_Xpect_Test_Methods">14.6.6. Expectmatrix Xpect tests</a></li>
+<li><a href="#xpect-lint-tests">14.6.7. Xpect Lint Tests</a></li>
+</ul>
+</li>
+<li><a href="#xpect-proposal-tests">14.7. Xpect Proposal Tests</a>
+<ul class="sectlevel3">
+<li><a href="#sec:Validation_vs__Non_Validation">14.7.1. Validation vs. Non-Validation</a></li>
+<li><a href="#sec:General_Proposal_Test_Features">14.7.2. General Proposal Test Features</a>
+<ul class="sectlevel4">
+<li><a href="#sec:Test_Variables">14.7.2.1. Test Variables</a></li>
+<li><a href="#sec:Location_and_Selection">14.7.2.2. at – Location and Selection</a></li>
+<li><a href="#sec:Multi_Line_Expectations_in_Proposal_Tests">14.7.2.3. Multi Line Expectations in Proposal Tests</a></li>
+<li><a href="#sec:Timeout">14.7.2.4. Timeout and Performance</a></li>
+</ul>
+</li>
+<li><a href="#proposals-verify-existence-of-proposals">14.7.3. proposals – Verify Existence of Proposals</a></li>
+<li><a href="#sec:Verify_displayed_string">14.7.4. display – Verify displayed string</a></li>
+<li><a href="#sec:Apply_Proposal">14.7.5. apply – Apply Proposal</a>
+<ul class="sectlevel4">
+<li><a href="#resource-application-in-other-files">14.7.5.1. resource – application in other files</a></li>
+</ul>
+</li>
+<li><a href="#sec:Content_Assist_Cycling">14.7.6. kind – Content Assist Cycling</a></li>
+<li><a href="#fileValidVerify-validation-status">14.7.7. fileValid – Verify validation status</a></li>
+</ul>
+</li>
+<li><a href="#sec:Apply_Proposal_And_Execute_Tests">14.8. Apply Proposal And Execute Tests</a></li>
+<li><a href="#sec:Organize_Imports_Test">14.9. Organize Imports Test</a>
+<ul class="sectlevel3">
+<li><a href="#organizeimports">14.9.1. organizeImports</a></li>
+</ul>
+</li>
+<li><a href="#sec:Access_Control_Test">14.10. Access Control Test</a>
+<ul class="sectlevel3">
+<li><a href="#test-scenarios">14.10.1. Test Scenarios</a></li>
+<li><a href="#n4js-code-generator">14.10.2. N4JS Code Generator</a></li>
+<li><a href="#xtext-issue-matcher">14.10.3. Xtext Issue Matcher</a></li>
+</ul>
+</li>
+<li><a href="#sec:Smoke_Tests">14.11. Smoke Tests</a>
+<ul class="sectlevel3">
+<li><a href="#how-to-handle-smoke-test-errors">14.11.1. How to handle smoke test errors?</a></li>
+<li><a href="#smoketester-and-exceptionanalyzer">14.11.2. SmokeTester and ExceptionAnalyzer</a></li>
+</ul>
+</li>
+<li><a href="#sec:UI_Tests_with_SWTBot">14.12. UI Tests with SWTBot</a>
+<ul class="sectlevel3">
+<li><a href="#writing-swtbot-tests">14.12.1. Writing SWTBot Tests</a></li>
+<li><a href="#running-swtbot-tests">14.12.2. Running SWTBot Tests</a></li>
+</ul>
+</li>
+<li><a href="#sec:Debugging_UI_Tests">14.13. Debugging UI Tests</a>
+<ul class="sectlevel3">
+<li><a href="#sec:Connecting_to_the_X_server_on_the_build_node">14.13.1. Connecting to the X-server on the build-node</a></li>
+<li><a href="#sec:Tools_to_investigate_the_java_stack">14.13.2. Tools to investigate the java-stack</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#_ui-concepts">15. UI Concepts</a>
+<ul class="sectlevel2">
+<li><a href="#sec:User_Interface_Concepts">15.1. User Interface Concepts</a>
+<ul class="sectlevel3">
+<li><a href="#sec:Eclipse_UI_Concepts">15.1.1. Eclipse UI Concepts</a>
+<ul class="sectlevel4">
+<li><a href="#sec:Label_Provider">15.1.1.1. Label Provider</a></li>
+<li><a href="#sec:Markers">15.1.1.2. Markers</a></li>
+<li><a href="#sec:Commands__Toolbar_and_Menus">15.1.1.3. Commands, Toolbar and Menus</a></li>
+<li><a href="#sec:Content_Assist">15.1.1.4. Content Assist</a></li>
+<li><a href="#sec:Quick_Fixes">15.1.1.5. Quick Fixes</a></li>
+<li><a href="#sec:Quick_Assist">15.1.1.6. Quick Assist</a></li>
+<li><a href="#sec:Clean_Up_Actions">15.1.1.7. Clean Up Actions</a></li>
+<li><a href="#sec:Save_Actions">15.1.1.8. Save Actions</a></li>
+<li><a href="#sec:Auto_Edit">15.1.1.9. Auto Edit</a></li>
+<li><a href="#sec:Template_Proposals">15.1.1.10. Template Proposals</a></li>
+<li><a href="#sec:Outline_View___Quick_Outline">15.1.1.11. Outline View / Quick Outline</a></li>
+<li><a href="#sec:Navigator__Package_Explorer__Project_Explorer">15.1.1.12. Navigator, Package Explorer, Project Explorer</a></li>
+<li><a href="#sec:Hyperlinking_and_Navigation">15.1.1.13. Hyperlinking and Navigation</a></li>
+<li><a href="#sec:Syntax_and_Semantic_Coloring">15.1.1.14. Syntax and Semantic Coloring</a></li>
+<li><a href="#sec:Code_Formatter">15.1.1.15. Code Formatter</a></li>
+<li><a href="#sec:Wizards">15.1.1.16. Wizards</a></li>
+<li><a href="#sec:Cheat_Sheets">15.1.1.17. Cheat Sheets</a></li>
+<li><a href="#sec:Context_sensitive_Help">15.1.1.18. Context-sensitive Help</a></li>
+<li><a href="#sec:Hovers">15.1.1.19. Hovers</a></li>
+<li><a href="#sec:Folding">15.1.1.20. Folding</a></li>
+<li><a href="#sec:Customizable_validation___severity">15.1.1.21. Customizable validation / severity</a></li>
+<li><a href="#sec:Proposals">15.1.1.22. Proposals</a></li>
+</ul>
+</li>
+<li><a href="#sec:Non_Eclipse_UI_Concepts">15.1.2. Non-Eclipse UI Concepts</a>
+<ul class="sectlevel4">
+<li><a href="#sec:Overlays">15.1.2.1. Overlays</a></li>
+<li><a href="#sec:Goto__Inferred__Type">15.1.2.2. Goto (Inferred) Type</a></li>
+<li><a href="#sec:Postfix_Completion">15.1.2.3. Postfix Completion</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#_user-interface-resources">15.2. User Interface Resources</a>
+<ul class="sectlevel3">
+<li><a href="#_icons">15.2.1. Icons</a>
+<ul class="sectlevel4">
+<li><a href="#_eclipse-platform-icons">15.2.1.1. Eclipse Platform Icons</a></li>
+<li><a href="#_n4js-specific-icons">15.2.1.2. N4JS Specific Icons</a></li>
+<li><a href="#_high-resolution-icons">15.2.1.3. High Resolution Icons</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#_formatting">16. Formatting</a>
+<ul class="sectlevel2">
+<li><a href="#sec:FmtObjective">16.1. Objective</a>
+<ul class="sectlevel3">
+<li><a href="#sec:FmtFormatting_Comments">16.1.1. Formatting Comments</a></li>
+</ul>
+</li>
+<li><a href="#sec:FmtArchitecture">16.2. Architecture</a>
+<ul class="sectlevel3">
+<li><a href="#sec:Implementation_example">16.2.1. Implementation example</a></li>
+</ul>
+</li>
+<li><a href="#sec:FmtFormatter_Implementation_Guidelines">16.3. Formatter Implementation Guidelines</a></li>
+<li><a href="#sec:FmtConfiguration">16.4. Configuration</a></li>
+<li><a href="#sec:FmtUI_Integration">16.5. UI Integration</a></li>
+<li><a href="#sec:FmtUnit_Testing_with_Xpect">16.6. Unit Testing with Xpect</a></li>
+</ul>
+</li>
+<li><a href="#_external-libraries">17. External Libraries</a>
+<ul class="sectlevel2">
+<li><a href="#sec:Major_Components">17.1. Major Components</a>
+<ul class="sectlevel3">
+<li><a href="#subsec:External_Resources">17.1.1. External Resources</a></li>
+<li><a href="#subsec:External_Library_Workspace">17.1.2. External Library Workspace</a></li>
+<li><a href="#subsec:External_Library_Preference_Store">17.1.3. External Library Preference Store</a></li>
+<li><a href="#subsec:npm_Manager">17.1.4. Library Manager</a></li>
+<li><a href="#subsec:External_Library_Builder_Helper">17.1.5. External Library Builder</a></li>
+<li><a href="#subsec:External_Library_Xtext_Index_Persister">17.1.6. External Library Xtext Index Persister</a></li>
+<li><a href="#subsec:External_Library_Preference_Page">17.1.7. External Library Preference Page</a></li>
+</ul>
+</li>
+<li><a href="#sec:Headless_External_Library_Support">17.2. Headless External Library Support</a>
+<ul class="sectlevel3">
+<li><a href="#_custom-npm-settings">17.2.1. Custom npm settings</a></li>
+</ul>
+</li>
+<li><a href="#sec:lmFutureWork">17.3. Future Work</a>
+<ul class="sectlevel3">
+<li><a href="#subsec:lmMultipleDependencyScope">17.3.1. Multiple Dependency Scope</a></li>
+<li><a href="#subsec:lmRunTestsFromLibrary">17.3.2. Run Tests from TestLibrary</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#sec:JSON_Support">18. JSON Support</a>
+<ul class="sectlevel2">
+<li><a href="#sec:JSON_Parser">18.1. JSON Parser</a>
+<ul class="sectlevel3">
+<li><a href="#sec:JSON_Parser_Unicode_Escaping">18.1.1. Escaping Unicode Control Characters in String Literals</a></li>
+<li><a href="#sec:JSON_Parser_Empty_Text">18.1.2. Empty Text</a></li>
+<li><a href="#sec:JSON_Parser_Nested_Structures">18.1.3. Nested Structures</a></li>
+<li><a href="#sec:JSON_Parser_Whitespace">18.1.4. Whitespace</a></li>
+<li><a href="#sec:JSON_Parser_Comments">18.1.5. Comments</a></li>
+</ul>
+</li>
+<li><a href="#sec:JSON_Language_Extensions">18.2. JSON Language Extensions</a>
+<ul class="sectlevel3">
+<li><a href="#sec:JSON_Validator_Extensions">18.2.1. JSON Validator Extensions</a>
+<ul class="sectlevel4">
+<li><a href="#sec:File_Specitic_Validator_Extensions">18.2.1.1. File-Specific Validator Extensions</a></li>
+<li><a href="#sec:JSON_Declarative_JSON_Validator_Extensions">18.2.1.2. Declarative JSON Validator Extensions</a></li>
+</ul>
+</li>
+<li><a href="#_json-resource-description-strategy">18.2.2. JSON Resource Description Strategy</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#_jsdoc">19. JSDoc</a>
+<ul class="sectlevel2">
+<li><a href="#sec:Design_Rationale">19.1. Design Rationale</a>
+<ul class="sectlevel3">
+<li><a href="#_general-design">19.1.1. General Design</a></li>
+<li><a href="#sec:Type_Expressions">19.1.2. Type Expressions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#_docexporter">20. DocExporter</a>
+<ul class="sectlevel2">
+<li><a href="#sec:Specification_Exporter">20.1. Specification Exporter</a></li>
+</ul>
+</li>
+<li><a href="#_rename-refactoring">21. Rename Refactoring</a>
+<ul class="sectlevel2">
+<li><a href="#_rename-refactoring-ui-interaction">21.1. Rename Refactoring UI interaction</a></li>
+<li><a href="#_renameelementprocessor-interaction">21.2. RenameElementProcessor interaction</a></li>
+</ul>
+</li>
+<li><a href="#chap:flowgraphs">22. Flow Graphs</a>
+<ul class="sectlevel2">
+<li><a href="#sec:flowgraphs_overview">22.1. Flow graphs overview</a>
+<ul class="sectlevel3">
+<li><a href="#_internal-graph">22.1.1. Internal graph</a></li>
+<li><a href="#_optimizations">22.1.2. Optimizations</a></li>
+<li><a href="#_api-for-client-analyses">22.1.3. API for client analyses</a>
+<ul class="sectlevel4">
+<li><a href="#_mapping-from-internal-to-ast-elements">22.1.3.1. Mapping from internal to AST elements</a></li>
+<li><a href="#_graph-visitor">22.1.3.2. Graph visitor</a></li>
+<li><a href="#_graph-explorer">22.1.3.3. Graph explorer</a></li>
+<li><a href="#_branch-walker">22.1.3.4. Branch walker</a></li>
+<li><a href="#_example-1-compute-string-for-each-path">22.1.3.5. Example 1: Compute string for each path</a></li>
+<li><a href="#_path-quantor">22.1.3.6. Path quantor</a></li>
+</ul>
+</li>
+<li><a href="#_control-flow-analyses">22.1.4. Control flow analyses</a>
+<ul class="sectlevel4">
+<li><a href="#_dead-code-analysis">22.1.4.1. Dead code analysis</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#sec:dataflow">22.2. Dataflow</a>
+<ul class="sectlevel3">
+<li><a href="#_dataflow-graph">22.2.1. Dataflow graph</a></li>
+<li><a href="#_dataflow-analyses">22.2.2. Dataflow analyses</a>
+<ul class="sectlevel4">
+<li><a href="#_def-def-def-nothing-analysis">22.2.2.1. Def&#8594;Def / Def&#8594;Nothing analysis</a></li>
+<li><a href="#_def-use-decl-analysis">22.2.2.2. Def|Use&#8592;Decl analysis</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#sec:publish-npms-to-public">23. Publish npms</a>
+<ul class="sectlevel2">
+<li><a href="#sec:publish-npms-n4js-maven">23.1. Publish n4js-libs to during  maven build</a></li>
+</ul>
+</li>
+<li><a href="#sec:Hints">Appendix A: Hints</a>
+<ul class="sectlevel2">
+<li><a href="#sec:XtextInjection">A.1. Xtext Injection</a>
+<ul class="sectlevel3">
+<li><a href="#sec:DI_MultipleInjectors_Singletons">A.1.1. Multiple Injectors and Singletons</a>
+<ul class="sectlevel4">
+<li><a href="#sec:DI_avoid_duplicate_singletons">A.1.1.1. Avoiding duplicate singletons</a>
+<ul class="sectlevel5">
+<li><a href="#sec:DI_binding_in_shared">A.1.1.1.1. Defining binding in the shared injector</a></li>
+<li><a href="#sec:DI_binding_in_custom">A.1.1.1.2. Defining binding in the custom injector</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#sec:DI_Hints">A.1.2. Dependency Injection Hints</a>
+<ul class="sectlevel4">
+<li><a href="#sec:DI_custom_bundle">A.1.2.1. Use DI in custom bundle, use DI with extensions</a>
+<ul class="sectlevel5">
+<li><a href="#sec:DI_custom_bundle_problem">A.1.2.1.1. Problem</a></li>
+<li><a href="#sec:DI_custom_bundle_solution">A.1.2.1.2. Solution</a></li>
+</ul>
+</li>
+<li><a href="#sec:Access_Other_DSL_Injector">A.1.2.2. How do I get the Guice Injector of my language?</a>
+<ul class="sectlevel5">
+<li><a href="#sec:DSL_Injector_UI_context">A.1.2.2.1. UI context</a></li>
+<li><a href="#sec:DSL_Injector_Non_UI_context">A.1.2.2.2. Non UI context but with injection context</a></li>
+<li><a href="#sec:DSL_Injector_Non_UI_non_injection_context">A.1.2.2.3. Non UI context without injection context</a></li>
+</ul>
+</li>
+<li><a href="#sec:Cancel_Indicator">A.1.2.3. How do I get cancel indicators in different contexts?</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#sec:Eclipse">A.2. Eclipse</a>
+<ul class="sectlevel3">
+<li><a href="#sec:Show_Xtext_Index">A.2.1. Show the current Xtext index</a></li>
+<li><a href="#sec:Plugin_spy">A.2.2. Plug-in spy</a></li>
+</ul>
+</li>
+<li><a href="#sec:Maven-hints">A.3. Maven</a>
+<ul class="sectlevel3">
+<li><a href="#how-to-check-for-maven-mojo-updates">A.3.1. How to check for Maven MOJO updates</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#_module-loading">Appendix B: Module Loading</a>
+<ul class="sectlevel2">
+<li><a href="#sec:Dependency_Management">B.1. Dependency Management</a></li>
+<li><a href="#ecmascript-modules">B.2. ECMAScript Modules</a>
+<ul class="sectlevel3">
+<li><a href="#sec:ES5_Modules_Systems">B.2.1. ES5 Modules Systems</a></li>
+<li><a href="#sec:ES6_Modules">B.2.2. ES6 Modules</a></li>
+</ul>
+</li>
+<li><a href="#sec:ECMAScript_Module_Loaders">B.3. ECMAScript Module Loaders</a>
+<ul class="sectlevel3">
+<li><a href="#sec:ES6_Module_Loaders">B.3.1. ES6 Module Loaders</a></li>
+<li><a href="#sec:Polyfills_for_ES6_Module_Loaders">B.3.2. Polyfills for ES6 Module Loaders</a>
+<ul class="sectlevel4">
+<li><a href="#sec:es6_module_loader">B.3.2.1. es6-module-loader</a></li>
+<li><a href="#sec:SystemJS">B.3.2.2. SystemJS</a></li>
+<li><a href="#sec:Demo">B.3.2.3. Demo</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#case-study-typescript">B.4. Case Study : TypeScript</a>
+<ul class="sectlevel3">
+<li><a href="#sec:ES6_Modules_Support">B.4.1. ES6 Modules Support</a></li>
+<li><a href="#sec:TypeScript_and_Module_Loading">B.4.2. TypeScript and Module Loading</a></li>
+</ul>
+</li>
+<li><a href="#sec:Cyclic_Dependencies">B.5. Cyclic Dependencies</a>
+<ul class="sectlevel3">
+<li><a href="#sec:Setup">B.5.1. Setup</a></li>
+<li><a href="#sec:Transpile_and_Execute">B.5.2. Transpile and Execute</a>
+<ul class="sectlevel4">
+<li><a href="#sec:Module_Format___AMD">B.5.2.1. Module Format = AMD</a></li>
+<li><a href="#sec:Module_Format___CommonJS">B.5.2.2. Module Format = CommonJS</a></li>
+<li><a href="#sec:Module_Format___SystemJS">B.5.2.3. Module Format = SystemJS</a></li>
+</ul>
+</li>
+<li><a href="#sec:Conclusion">B.5.3. Conclusion</a></li>
+</ul>
+</li>
+<li><a href="#system.register-as-transpilation-target">B.6. System.register as transpilation target</a>
+<ul class="sectlevel3">
+<li><a href="#sec:Introduction">B.6.1. Introduction</a>
+<ul class="sectlevel4">
+<li><a href="#sec:External_Transpilers">B.6.1.1. External Transpilers</a></li>
+<li><a href="#sec:Example_of_a_System_register_module">B.6.1.2. Example of a System.register module</a></li>
+</ul>
+</li>
+<li><a href="#sec:Structure_of_a_System_register_module">B.6.2. Structure of a System.register module</a></li>
+<li><a href="#_transpilation-hints">B.6.3. Transpilation Hints</a>
+<ul class="sectlevel4">
+<li><a href="#sec:Handling_Imports">B.6.3.1. Handling Imports</a></li>
+<li><a href="#sec:__exportFn__">B.6.3.2. &lt;&lt;exportFn&gt;&gt;</a></li>
+<li><a href="#sec:Handling_Exports">B.6.3.3. Handling Exports</a></li>
+</ul>
+</li>
+<li><a href="#sec:Examples_w__Circular_Dependencies">B.6.4. Examples w/ Circular Dependencies</a></li>
+<li><a href="#sec:N4JS_Examples_w__Circular_Dependencies">B.6.5. N4JS Examples w/ Circular Dependencies</a>
+<ul class="sectlevel4">
+<li><a href="#sec:Unresolved_Cyclic_Dependencies">B.6.5.1. Unresolved Cyclic Dependencies</a></li>
+<li><a href="#sec:Variables___Functions">B.6.5.2. Examples with Variables &amp; Functions</a></li>
+<li><a href="#sec:Classes">B.6.5.3. Examples with Classes</a></li>
+<li><a href="#sec:Examples_with_SubClassing">B.6.5.4. Examples with SubClassing</a></li>
+<li><a href="#sec:Miscellaneous">B.6.5.5. Miscellaneous</a></li>
+</ul>
+</li>
+<li><a href="#_resources">B.6.6. Resources</a></li>
+</ul>
+</li>
+<li><a href="#sec:CommonJS_as_transpilation_target">B.7. CommonJS as transpilation target</a>
+<ul class="sectlevel3">
+<li><a href="#_introduction-2">B.7.1. Introduction</a></li>
+<li><a href="#sec:Transpilation_Hints">B.7.2. Transpilation Hints</a>
+<ul class="sectlevel4">
+<li><a href="#sec:Import_Statements">B.7.2.1. Import Statements</a></li>
+<li><a href="#sec:Export_Statements">B.7.2.2. Export Statements</a></li>
+<li><a href="#sec:Tracking_Live_Bindings">B.7.2.3. Tracking Live Bindings</a></li>
+<li><a href="#sec:A_complete_example">B.7.2.4. A complete example</a></li>
+</ul>
+</li>
+<li><a href="#_resources-2">B.7.3. Resources</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#sec:License">Appendix C: License</a></li>
+<li><a href="#sec:Acronyms">Appendix D: Acronyms</a></li>
+<li><a href="#_bibliography-and-footnotes">Appendix E: Bibliography and Footnotes</a></li>
+</ul>
+</div>
+</div>
+<div id="content">
+<div id="preamble">
+<div class="sectionbody">
+<div class="paragraph center">
+<p><strong>Last Updated: 2019-08-07</strong></p>
+</div>
+<div class="paragraph center">
+<p><strong>Authors:</strong><br>
+Jens von Pilgrim, Jakub Siberski, Mark-Oliver Reiser, Torsten Krämer, Ákos Kitta, Sebastian Zarnekow, Lorenzo Bettini, Jörg Reichert, Kristian Duske, Marcus Mews, Minh Quang Tran, Luca Beurer-Kellner</p>
+</div>
+<div style="page-break-after: always;"></div>
+<div class="paragraph">
+<p>This document contains the N4JS Design and Implementation documentation.</p>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_introduction"><a class="anchor" href="#_introduction"></a><a class="link" href="#_introduction">1. Introduction</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>This document describes design aspects of the N4JS compiler and IDE. It relies on the following N4JS related specifications:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>N4JS Language Specification [<a href="#N4JSSpec">N4JSSpec</a>]</p>
+</li>
+</ul>
+</div>
+<div class="sect2">
+<h3 id="notation"><a class="anchor" href="#notation"></a><a class="link" href="#notation">1.1. Notation</a></h3>
+<div class="paragraph">
+<p>We reuse the notation specified in [<a href="#N4JSSpec">N4JSSpec</a>].</p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="sec:IDE_Overview"><a class="anchor" href="#sec:IDE_Overview"></a><a class="link" href="#sec:IDE_Overview">1.2. IDE Components</a></h3>
+<div class="paragraph">
+<p>The N4JS and N4JSIDE components are organized via features. The following features with included plugins are defined
+(the common prefix "org.eclipse.n4js" is omitted at the plugin name):</p>
+</div>
+<table class="tableblock frame-all grid-all spread">
+<colgroup>
+<col style="width: 5.8823%;">
+<col style="width: 11.7647%;">
+<col style="width: 82.353%;">
+</colgroup>
+<thead>
+<tr>
+<th class="tableblock halign-left valign-top">Feature</th>
+<th class="tableblock halign-left valign-top">Plugin</th>
+<th class="tableblock halign-left valign-top">Description</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td class="tableblock halign-left valign-top" colspan="2"><p class="tableblock"><strong>org.eclipse.n4js.lang.sdk</strong></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">N4JS core language with parser, validation etc.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">org.eclipse.n4js</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Xtext grammar with generator and custom code for N4JS, scoping (and binding) implementation, basic validation (and Xsemantics type system).</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">doc</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">(in doc folder) General documentation (including web page) written in AsciiDoc</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">external.libraries</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Support for N4JS libraries shipped with the IDE, i.e. core N4JS library and mangelhaft.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">ui</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">UI components for N4JS, e.g., proposal provider, labels, outline, quickfixes.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">jsdoc</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Parser and model for JSDoc</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">external.libraries.update</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Not included in feature</strong>. Updates the external library plugin</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top" colspan="2"><p class="tableblock"><strong>org.eclipse.n4js.ts.sdk</strong></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Type System</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">ts</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Xtext grammar with generator and custom code for type expressions and standalone type definitions.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">ts.model</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Xcore based types model with helper classes etc.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">ts.ui</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Xtext generated UI for type system, not really used as this TS files are not editable by users.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top" colspan="2"><p class="tableblock"><strong>org.eclipse.n4js.unicode.sdk</strong></p></td>
+<td class="tableblock halign-left valign-top"></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">common.unicode</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Xtext grammar with generator and custom code used by all other grammars for proper unicode support.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top" colspan="2"><p class="tableblock"><strong>org.eclipse.n4js.regex.sdk</strong></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Regular expression grammar and UI, used by N4JS grammar and UI</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">regex</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Xtext grammar with generator and custom code used by N4JS grammars for regular expressions.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">regex.ui</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">UI components for regular expressions, e.g., proposal provider, labels, outline, quickfixes.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top" colspan="2"><p class="tableblock"><strong>org.eclipse.n4js.sdk</strong></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">This feature defines the N4JSIDE. It contains core UI plugins and all includes (almost all) other features!</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">environments</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Utility plugin, registers n4scheme for EMF proxy resolution.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">model</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Xcore based N4JS model with helper classes etc.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">product</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">N4JSIDE main application.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">releng.utils</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">(in releng folder) Contains utility classes only used for building the system, e.g., tools for generating antlr based parser with extended features.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">utils</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">general utilities</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">utils.ui</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">general UI utilities</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top" colspan="2"><p class="tableblock"><strong>org.eclipse.n4js.compiler.sdk</strong></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Compilers and Transpilers</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">generator.common</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Not included in feature, logically associated.</strong></p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">generator.headless</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">N4JS headless generator (i.e. command line compiler).</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">transpiler</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Generic transpiler infrastructure</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">transpiler.es</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Transpiler to compile to EcmaScript</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top" colspan="2"><p class="tableblock"><strong>org.eclipse.n4js.json.sdk</strong></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">N4JS JSON</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">json</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Xtext grammar with generator and custom code for a extensible JSON language support. Used in N4JS for the project description in terms of a <code>package.json</code> file.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">json.ui</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">UI components for extensible JSON language support, e.g., proposal provider, labels, outline.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">json.model</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Not included in feature, logically associated.</strong> Xcore based model for the JSON language.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top" colspan="2"><p class="tableblock"><strong>org.eclipse.n4js.semver.sdk</strong></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Semantic version string support.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">semver</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Parser and tools for semantic version strings.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">semver.ui</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">UI tools for semantic version strings.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">semver.model</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Not included in feature, logically associated.</strong> Xcore model of semantic version strings.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top" colspan="2"><p class="tableblock"><strong>org.eclipse.n4js.runner.sdk</strong></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Runners for executing N4JS or JavaScript code</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">runner</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Generic interfaces and helper for runners, i.e. JavaScript engines executing N4JS or JavaScript code.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">runner.chrome</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Runner for executing N4JS or JavaScript with Chrome.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">runner.chrome.ui</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">UI classes for launching the Chrome runner via the org.eclipse.debug.ui</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">runner.nodejs</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Runner for executing N4JS or JavaScript with node.js.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">runner.nodejs.ui</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">UI classes for launching the node.js runner via the org.eclipse.debug.ui</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">runner.ui</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Generic interfaces for configuring N4JS runner via the debug ui.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top" colspan="2"><p class="tableblock"><strong>org.eclipse.n4js.tester.sdk</strong></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Runners and UI for tests (via mangelhaft).</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">tester</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Generic interfaces and helper for testers, i.e. JavaScript engines executing N4JS tests (using mangelhaft).</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">tester.nodejs</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Tester based on the nodejs runner for executing mangelhaft tests with node.js</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">tester.nodejs.ui</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">UI for showing test results.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">tester.ui</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Configuration of tests via the debug UI.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top" colspan="2"><p class="tableblock"><strong>org.eclipse.n4js.jsdoc2spec.sdk</strong></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">JSDoc 2 Specification</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">jsdoc2spec</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Exporter to generate API documentation with specification tests awareness</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">jsdoc2spec.ui</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">UI for API doc exporter</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top" colspan="2"><p class="tableblock"><strong>org.eclipse.n4js.xpect.sdk</strong></p></td>
+<td class="tableblock halign-left valign-top"></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">xpect</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Xpect test methods.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">xpect.ui</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">UI for running Xpext tests methods from the N4JSIDE (for creating bug reports).</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top" colspan="2"><p class="tableblock"><strong>org.eclipse.n4js.smith.sdk</strong></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Feature for internal N4JS IDE plugins only intended for development (for example, the AST Graph view).</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">smith</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Non-UI classes for tools for smiths, that is, tools for developers of the N4JS IDE such as AST views etc.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">smith.ui</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">UI classes for tools for smiths, that is, tools for developers of the N4JS IDE such as AST views etc.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top" colspan="2"><p class="tableblock"><strong>org.eclipse.n4js.tests.helper.sdk</strong></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Test helpers.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top" colspan="2"><p class="tableblock"><strong>org.eclipse.n4js.dependencies.sdk</strong></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Collection of all external non-ui dependencies, used for local mirroring of update sites.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top" colspan="2"><p class="tableblock"><strong>org.eclipse.n4js.dependencies.ui.sdk</strong></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Collection of all external ui dependencies, used for local mirroring of update sites.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top" colspan="3"><p class="tableblock"><strong>uncategorized plugins</strong></p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">flowgraphs</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Control and data flow graph model and computer.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top" colspan="2"><p class="tableblock"><strong>Fragments</strong></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">not associated to features, only listed here for completeness</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">utils.logging</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Fragment only, configuration for loggers, in particular for the product and for the tests</p></td>
+</tr>
+</tbody>
+</table>
+<div class="sect3">
+<h4 id="sec:Naming_Conventions"><a class="anchor" href="#sec:Naming_Conventions"></a><a class="link" href="#sec:Naming_Conventions">1.2.1. Naming Conventions</a></h4>
+<div class="paragraph">
+<p>In the above sections, tests were omitted. We use the following naming conventions (by example) for test and tests helper:</p>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+project
+</td>
+<td class="hdlist2">
+<p>-</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+project.tests
+</td>
+<td class="hdlist2">
+<p>tests for project, is a fragment</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+project.tests.helper
+</td>
+<td class="hdlist2">
+<p>helper classes used ONLY by tests</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+project.tests.performance
+</td>
+<td class="hdlist2">
+<p>performance tests</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+project.tests.integration
+</td>
+<td class="hdlist2">
+<p>integration tests</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+project.ui
+</td>
+<td class="hdlist2">
+<p>-</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+project.ui.tests
+</td>
+<td class="hdlist2">
+<p>tests for ui project, fragment of project.ui</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+project.ui.tests.helper
+</td>
+<td class="hdlist2">
+<p>helper classes used ONLY by tests</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+project.ui.tests.performance
+</td>
+<td class="hdlist2">
+<p>-</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+tests.helper
+</td>
+<td class="hdlist2">
+<p>general test helper</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+ui.tests.helper
+</td>
+<td class="hdlist2">
+<p>general ui test helper</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+project.xpect.tests
+</td>
+<td class="hdlist2">
+<p>xpect tests for the project, despite dependnecies to UI the can be executed as plain JUnit tests</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+project.xpect.ui.tests
+</td>
+<td class="hdlist2">
+<p>xpect tests for the project, need to be executed as eclipse plugin tests</p>
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>Due to Maven, tests are in subfolder tests (incl. helpers), implementation bundles in plugins, and release engineering related bundles in releng.</p>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_eclipse-setup"><a class="anchor" href="#_eclipse-setup"></a><a class="link" href="#_eclipse-setup">2. Eclipse Setup</a></h2>
+<div class="sectionbody">
+<div class="sect2">
+<h3 id="_system-requirements"><a class="anchor" href="#_system-requirements"></a><a class="link" href="#_system-requirements">2.1. System Requirements</a></h3>
+<div class="paragraph">
+<p>In all cases, <a href="https://adoptopenjdk.net/">Java 11</a> is required to be installed on your system. <a href="https://nodejs.org/en/download/">Node.js</a> version 10+ is also required, and for some tests you need <a href="https://yarnpkg.com">Yarn</a> to be globally installed.</p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_contribute"><a class="anchor" href="#_contribute"></a><a class="link" href="#_contribute">2.2. Contribute</a></h3>
+<div class="paragraph">
+<p>Eclipse developers who want to develop N4JS itself should use the <a href="https://www.eclipse.org/downloads/">Oomph Eclipse installer</a>. The N4JS project is listed under "Eclipse Projects/N4JS"
+This setup installs the correct Eclipse version, creates a new workspace and clones all projects into it (for details see below).</p>
+</div>
+<div class="sect3">
+<h4 id="_eclipse-installer"><a class="anchor" href="#_eclipse-installer"></a><a class="link" href="#_eclipse-installer">2.2.1. Eclipse Installer</a></h4>
+<div class="paragraph">
+<p>The recommended way to install the Eclipse IDE and set up the workspace is to use the Eclipse Installer.
+This installer is to be downloaded from <a href="https://wiki.eclipse.org/Eclipse_Installer" class="bare">https://wiki.eclipse.org/Eclipse_Installer</a></p>
+</div>
+<div class="paragraph">
+<p>Run the installer and apply the following steps:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>change to "Advance Mode" via the menu (upper-right corner) (no need to move the installer)</p>
+</li>
+<li>
+<p>select a product, e.g. "Eclipse IDE for Eclipse Committers" with product version "latest"</p>
+</li>
+<li>
+<p>double-click the entry <strong>Eclipse Projects/N4JS</strong> so that it is shown in the catalog view below</p>
+</li>
+<li>
+<p>on the next page, configure paths accordingly. You only have to configure the installation and workspace folder. You may want to use git with https instead of ssh.</p>
+</li>
+<li>
+<p>start installation</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>The installer will then guide you through the rest of the installation. All plug-ins are downloaded and configured automatically, so is the workspace including downloading the git repository and setting up the workspace.</p>
+</div>
+<div class="paragraph">
+<p>The workspace is configured automatically. This includes fetching the necessary git repository. If you have selected git with SSH you may run into problems. In this case you can re-run the scripts and select HTTPS instead, this should work in any case.</p>
+</div>
+<div class="paragraph">
+<p>Eventually the installer scripts are done, that means the git repository has been cloned and the workspace has been configured (including the project set setup).
+Now the automatic build kicks in as you can see in the status bar. Screenshot 6</p>
+</div>
+<div class="paragraph">
+<p>The build will show a lot of errors while still working. Eventually the whole project should have been compiled without any errors. Unfortunately, due to a <a href="https://github.com/eclipse/n4js/issues/1373">known issue</a>, two problems exists. Please have a look at the linked issue on how to fix that (it is quite easy).</p>
+</div>
+<div class="sect4">
+<h5 id="_changing-the-setup-script"><a class="anchor" href="#_changing-the-setup-script"></a><a class="link" href="#_changing-the-setup-script">2.2.1.1. Changing the Setup Script</a></h5>
+<div class="paragraph">
+<p>The setup scripts is stored at</p>
+</div>
+<div class="paragraph">
+<p><code>n4js/releng/org.eclipse.n4js.targetplatform/N4JS.setup</code></p>
+</div>
+<div class="paragraph">
+<p>Details about Oomph-Setup scripts can be found at</p>
+</div>
+<div class="paragraph">
+<p><a href="https://wiki.eclipse.org/Eclipse_Installer" class="bare">https://wiki.eclipse.org/Eclipse_Installer</a></p>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_manual-ide-configuration"><a class="anchor" href="#_manual-ide-configuration"></a><a class="link" href="#_manual-ide-configuration">2.2.2. Manual IDE Configuration</a></h4>
+<div class="admonitionblock warning">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-warning" title=""></i>
+</td>
+<td class="content">
+Manual IDE configuration is not recommended!
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>For a manual install, clone the code and import all top-level projects from the docs, features, plugins, releng, testhelpers, and tests folders. Activate the targetplatform contained in the <code>releng/org.eclipse.n4js.targetplatform/</code> project.</p>
+</div>
+<div class="paragraph">
+<p>The N4JS IDE is developed with Eclipse 2019-06 or better since the system is based on Eclipse anyway.
+It is almost impossible to use another IDE to develop Eclipse plugins. The list of required plugins includes:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Xtext/Xtend 2.18.0</p>
+</li>
+<li>
+<p>Xcore 1.9.0</p>
+</li>
+<li>
+<p>Xpect 0.2.0.201906240918 from <a href="https://ci.eclipse.org/xpect/job/Xpect-Integration-Release/20/artifact/org.eclipse.xpect.releng/p2-repository/target/repository/" class="bare">https://ci.eclipse.org/xpect/job/Xpect-Integration-Release/20/artifact/org.eclipse.xpect.releng/p2-repository/target/repository/</a></p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>It is important to use the latest version of Xtext and the corresponding service release of Xcore. You will find the latest version numbers and plugins used in the target platform definition at
+<a href="https://github.com/eclipse/n4js/blob/master/releng/org.eclipse.n4js.targetplatform/org.eclipse.n4js.targetplatform.target" class="bare">https://github.com/eclipse/n4js/blob/master/releng/org.eclipse.n4js.targetplatform/org.eclipse.n4js.targetplatform.target</a></p>
+</div>
+<div class="paragraph">
+<p>You may need to adjust some settings in Eclipse, most importantly</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><strong>Text file encoding</strong> to <code>Other: UTF-8</code> and</p>
+</li>
+<li>
+<p><strong>New text file line delimiter</strong> to <code>Unix</code> .</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_release-engineering"><a class="anchor" href="#_release-engineering"></a><a class="link" href="#_release-engineering">3. Release Engineering</a></h2>
+<div class="sectionbody">
+<div class="sect2">
+<h3 id="_nightly-build-on-eclipse-infrastructure"><a class="anchor" href="#_nightly-build-on-eclipse-infrastructure"></a><a class="link" href="#_nightly-build-on-eclipse-infrastructure">3.1. Nightly build on Eclipse infrastructure</a></h3>
+<div class="paragraph">
+<p>The N4JS IDE, headless n4jsc.jar, and the N4JS update site is being built on the Eclipse Common Build
+Infrastructure (CBI). For this purpose the N4JS project is using a dedicated Jenkins instance, referred
+to as a "Jenkins Instance Per Project" (JIPP) in Eclipse CBI documentation. At this time, the N4JS
+project&#8217;s JIPP is running on the "old" infrastructure, not yet using docker. This will be migrated
+at a later point in time.</p>
+</div>
+<div class="paragraph">
+<p>The N4JS JIPP is available at: <a href="https://ci.eclipse.org/n4js/" class="bare">https://ci.eclipse.org/n4js/</a></p>
+</div>
+<div class="paragraph">
+<p>The nightly build performs the following main steps:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>compile the N4JS implementation,</p>
+</li>
+<li>
+<p>build the n4jsc.jar, the IDE products for MacOS, Windows, Linux, and the update site,</p>
+</li>
+<li>
+<p>run tests,</p>
+</li>
+<li>
+<p>sign the IDE product for macOS and package it in a .dmg file,</p>
+</li>
+<li>
+<p>deploy to n4jsc.jar, IDE products and update sites to Eclipse download server (i.e. download.eclipse.org),</p>
+</li>
+<li>
+<p>move all artifacts older than 7 days from download.eclipse.org to archive.eclipse.org.</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>Details about all the above steps can be found in the Jenkinsfile <code>eclipse-nightly.jenkinsfile</code>, located in
+the root folder of the N4JS source repository on GitHub.</p>
+</div>
+<div class="paragraph">
+<p>The most accurate documentation for our JIPP can be found at <a href="https://wiki.eclipse.org/IT_Infrastructure_Doc" class="bare">https://wiki.eclipse.org/IT_Infrastructure_Doc</a>.
+Note that many other documents do not apply to our JIPP, at the moment, as they refer to the new
+infrastructure, e.g. <a href="https://wiki.eclipse.org/CBI" class="bare">https://wiki.eclipse.org/CBI</a> and <a href="https://wiki.eclipse.org/Jenkins" class="bare">https://wiki.eclipse.org/Jenkins</a>.</p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_build-the-n4js-ide-from-command-line"><a class="anchor" href="#_build-the-n4js-ide-from-command-line"></a><a class="link" href="#_build-the-n4js-ide-from-command-line">3.2. Build the N4JS IDE from command line</a></h3>
+<div class="paragraph">
+<p>Ensure you have</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Java 11</p>
+</li>
+<li>
+<p>Maven 3.2.x and</p>
+</li>
+<li>
+<p>Node.js 8</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>installed on your system.</p>
+</div>
+<div class="paragraph">
+<p>Clone the repository</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre>git clone https://github.com/Eclipse/n4js.git</pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Change to the n4js folder:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre>cd n4js</pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Run the Maven build:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre>mvn clean verify</pre>
+</div>
+</div>
+<div class="paragraph">
+<p>You may have to increase the memory for maven via <code>export MAVEN_OPTS="-Xmx2048m"</code> (Unix) or <code>set MAVEN_OPTS="-Xmx2048m"</code> (Windows).</p>
+</div>
+<div class="paragraph">
+<p>Available optional maven profiles are:</p>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+buildProduct
+</td>
+<td class="hdlist2">
+<p>create IDE products (Windows, macOS, Linux) and a jar for headless compilation</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+execute-plugin-tests
+</td>
+<td class="hdlist2">
+<p>run OSGi tests (without UI)</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+execute-plugin-ui-tests
+</td>
+<td class="hdlist2">
+<p>run UI-based OSGi tests</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+execute-ecmas-tests
+</td>
+<td class="hdlist2">
+<p>run ECMA test suite</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+execute-smoke-tests
+</td>
+<td class="hdlist2">
+<p>run generated tests using corrupted source code as input</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+execute-accesscontrol-tests
+</td>
+<td class="hdlist2">
+<p>run generated tests for checking accessibility of class/interface members</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+execute-hlc-integration-tests
+</td>
+<td class="hdlist2">
+<p>run integration tests using the headless jar (requires docker!)</p>
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>Available system properties:</p>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+noTests
+</td>
+<td class="hdlist2">
+<p>suppress execution of all tests</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+startAndKeepVerdaccio
+</td>
+<td class="hdlist2">
+<p>enforce starting and suppress stopping of the test verdaccio (see <a href="#sec:test-verdaccio">Test Verdaccio containing n4js-libs</a>)</p>
+</td>
+</tr>
+</table>
+</div>
+<div class="sect3">
+<h4 id="_publish-maven-tooling-code-org-eclipse-n4js-releng-util-code"><a class="anchor" href="#_publish-maven-tooling-code-org-eclipse-n4js-releng-util-code"></a><a class="link" href="#_publish-maven-tooling-code-org-eclipse-n4js-releng-util-code">3.2.1. Publish maven-tooling <code>org.eclipse.n4js.releng.util</code></a></h4>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title=""></i>
+</td>
+<td class="content">
+For extending the N4JS-language in a different project, the <code>org.eclipse.n4js.releng.util</code> module needs to be published as a maven-plugin. You can deploy this SNAPSHOT-artifact to a local folder by providing the <code>local-snapshot-deploy-folder</code>-property pointing to an absolute path in the local file system:
+</td>
+</tr>
+</table>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre>mvn clean deploy -Dlocal-snapshot-deploy-folder=/var/lib/my/folder/local-mvn-deploy-repository</pre>
+</div>
+</div>
+<div class="paragraph">
+<p>The existence of <code>local-snapshot-deploy-folder</code> will trigger a profile enabling the deploy-goal for the project <code>org.eclipse.n4js.releng.util</code></p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:test-verdaccio"><a class="anchor" href="#sec:test-verdaccio"></a><a class="link" href="#sec:test-verdaccio">3.2.2. Test Verdaccio containing n4js-libs</a></h4>
+<div class="paragraph">
+<p>If profile <code>execute-hlc-integration-tests</code> is active, a local verdaccio instance is started and populated with
+freshly-compiled n4js-libs (the libraries located under top-level folder <code>/n4js-libs</code>) and is stopped before the
+end of the build. The verdaccio instance is started as a docker container called <code>n4js-test-verdaccio</code>.</p>
+</div>
+<div class="paragraph">
+<p>When giving <code>-DstartAndKeepVerdaccio</code> on the command line, such a test verdaccio will always be started/populated but
+never stopped, regardless of whether profile <code>execute-hlc-integration-tests</code> is active or not. This is useful to enforce
+starting of the test verdaccio (even without running integration tests) and then reusing it in subsequent builds.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_generation-of-eclipse-help-for-spec-and-design-document"><a class="anchor" href="#_generation-of-eclipse-help-for-spec-and-design-document"></a><a class="link" href="#_generation-of-eclipse-help-for-spec-and-design-document">3.2.3. Generation of Eclipse help for spec and design document</a></h4>
+<div class="paragraph">
+<p>The HTML pages for N4JSSpec and N4JSDesign documents are generated from the Asciidoc sources in the project <code>org.eclipse.n4js.spec</code> <code>org.eclipse.n4js.design</code> by Asciispec. </p>
+</div>
+<div id="img:eclipse-help-doc-process" class="imageblock">
+<div class="content">
+<img src="chapters/03_releng/images/eclipse-help-process.svg" alt="Creating Eclipse help for N4JSSpec">
+</div>
+<div class="title">Figure 1. The process of creating Eclipse help for N4JSSpec</div>
+</div>
+<div class="paragraph">
+<p>Figure <a href="#img:eclipse-help-doc-process">The process of creating Eclipse help for N4JSSpec</a> shows the generation process for N4JSSpec document. The process for N4JSDesign (and other adoc documents) is the same. The following explains the diagram.</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>Asciispec</code> is used to compile the source N4JSSpec Asciidoc into a single large <code>N4JSSpec.html</code> file which contains all the chapters. The use of the custom parameter <code>-a eclipse-help-mode</code> indicates that a special header and footer styles as well as CSS style should be used (i.e. no table of content menu, no download links etc.). Here, we are using the possibility provided by Asciidoctor to configure header/footer as well as CSS style via parameter <code>:docinfodir:</code> and <code>:stylesheet:</code>.</p>
+</li>
+<li>
+<p>Our custom tool <code>Chunker</code> splits <code>N4JSSpec.html</code> (and other documents) into multiple chunked HTML files, each of which corresponds to either the <code>index</code> file or a chapter. It automatically re-writes internal links.</p>
+</li>
+<li>
+<p>Another custom tool <code>EclipseHelpTOCGenerator</code> takes to Docbook file <code>N4JSSpec.xml</code> and generates an XML file describing the table of content (TOC) in the Eclipse format. This TOC file references the chunked HTML files above.</p>
+</li>
+<li>
+<p>Another custom tool <code>IndexTocGenerator</code> takes to Docbook file <code>N4JSSpec.xml</code> similar to <code>EclipseHelpTOCGenerator</code>, but it generates an HTML fragment which can be embedded into the <code>index.html</code> page generated by the <code>Chunker</code> (Thus it has to run before the Chunker in that case).</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_updating-frameworks-and-dependencies"><a class="anchor" href="#_updating-frameworks-and-dependencies"></a><a class="link" href="#_updating-frameworks-and-dependencies">3.3. Updating frameworks and dependencies</a></h3>
+<div class="sect3">
+<h4 id="_update-of-eclipse-emf-xtext-etc"><a class="anchor" href="#_update-of-eclipse-emf-xtext-etc"></a><a class="link" href="#_update-of-eclipse-emf-xtext-etc">3.3.1. Update of Eclipse, EMF, Xtext, etc.</a></h4>
+<div class="paragraph">
+<p>For updating the N4JS IDE to a new version of Eclipse, EMF, Xtext, etc. follow these steps:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Create a new branch.</p>
+</li>
+<li>
+<p>Bump versions of all dependencies mentioned in file <code>N4JS.setup</code>:</p>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p>Update all labels that refer to the version of the Ooomph setup (search for "label!" to find them).</p>
+</li>
+<li>
+<p>Choose a new Eclipse version and define this in <code>N4JS.setup</code>.</p>
+</li>
+<li>
+<p>For those other dependencies <em>that come with Eclipse</em> (e.g. EMF, Xtext) find out which version matches the chosen Eclipse version
+and define that version in <code>N4JS.setup</code>.<br>
+Tip: use the contents list of the SimRel you are targeting, e.g. <a href="https://projects.eclipse.org/releases/2019-03" class="bare">https://projects.eclipse.org/releases/2019-03</a></p>
+</li>
+<li>
+<p>For those other dependencies <em>that are available via the Eclipse Orbit</em>, find out which version is the latest version available in
+the Orbit and define that version in <code>N4JS.setup</code>.<br>
+Tip: contents of the Eclipse Orbit can be found at <a href="https://download.eclipse.org/tools/orbit/downloads/" class="bare">https://download.eclipse.org/tools/orbit/downloads/</a><br>
+(choose the correct link for the chosen Eclipse version!)</p>
+</li>
+<li>
+<p>For all remaining dependencies (i.e. unrelated to Eclipse and not in Orbit), choose a version to use and define it in <code>N4JS.setup</code>.</p>
+</li>
+</ol>
+</div>
+</li>
+<li>
+<p>Check <code>Require-Bundle</code> sections of MANIFEST.MF files by searching for related bundle names or for <code>;bundle-version="</code>:</p>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p>There should be at most one version constraint for a specific bundle<br>
+NOTE: the version constraints in the MANIFEST.MF files are just lower bounds and - at this time - we do not bump them to the latest version, in most cases.</p>
+</li>
+<li>
+<p>There should be no version constraints to our bundles (i.e. <code>org.eclipse.n4js&#8230;&#8203;</code>)</p>
+</li>
+</ol>
+</div>
+</li>
+<li>
+<p>Review parent pom.xml files, i.e. <code>releng/org.eclipse.n4js.parent/pom.xml</code>:</p>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p>Update property <code>xtext-version</code>.</p>
+</li>
+<li>
+<p>Check all other <code>*-version</code> properties and update them where needed.</p>
+</li>
+</ol>
+</div>
+</li>
+<li>
+<p>Update target platform file <code>org.eclipse.n4js.targetplatform.target</code> using Ooomph&#8217;s auto-generation:</p>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p>Start the Eclipse Installer.</p>
+</li>
+<li>
+<p>Update the Eclipse Installer (using the button with the turning arrows).</p>
+</li>
+<li>
+<p>On the second page, add the <code>N4JS.setup</code> file from your branch to the Eclipse Installer, using a GitHub raw(!) URL:<br>
+<code><a href="https://raw.githubusercontent.com/eclipse/n4js/BRANCH_NAME/releng/org.eclipse.n4js.targetplatform/N4JS.setup" class="bare">https://raw.githubusercontent.com/eclipse/n4js/BRANCH_NAME/releng/org.eclipse.n4js.targetplatform/N4JS.setup</a></code></p>
+</li>
+<li>
+<p>Ooomph a new development environment with this setup.</p>
+</li>
+<li>
+<p>In the new Eclipse workspace created by Ooomph, the target platform file should have uncommitted changes:</p>
+<div class="olist lowerroman">
+<ol class="lowerroman" type="i">
+<li>
+<p>carefully review these changes, to be sure they make sense, and then</p>
+</li>
+<li>
+<p>commit &amp; push those changes to your branch.</p>
+</li>
+</ol>
+</div>
+</li>
+</ol>
+</div>
+</li>
+<li>
+<p>Thoroughly test the new versions, including some manual(!) tests:</p>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p>Run Jenkins builds.</p>
+</li>
+<li>
+<p>Ooomph another N4JS development environment with Eclipse Installer.
+This time, after Ooomphing is completed, the target platform file should no longer have any uncommitted changes.</p>
+</li>
+<li>
+<p>Ensure the following types of tests can be executed locally in the newly installed Eclipse:</p>
+<div class="olist lowerroman">
+<ol class="lowerroman" type="i">
+<li>
+<p>plain JUnit tests (e.g. <code>org.eclipse.n4js.lang.tests</code>).</p>
+</li>
+<li>
+<p>Plugin tests.</p>
+</li>
+<li>
+<p>Plugin UI tests.</p>
+</li>
+<li>
+<p>SWTBot tests.</p>
+</li>
+<li>
+<p>Xpect tests (individual files and entire bundles; e.g. <code>org.eclipse.n4js.spec.tests</code>).</p>
+</li>
+<li>
+<p>Xpect UI tests.</p>
+</li>
+</ol>
+</div>
+</li>
+<li>
+<p>Ensure an N4JS IDE product can be launched from within the newly installed Eclipse using the launch configuration
+provided in the n4js repository.</p>
+</li>
+<li>
+<p>After launching the N4JS IDE product, refresh the workspace and review/commit any changes in file <code>N4JS__IDE.launch</code>.</p>
+</li>
+<li>
+<p>Download a product created in a Jenkins CI build and test it manually.</p>
+</li>
+<li>
+<p>After merging to master: download a product created in a nightly build and test it manually.
+Ensure signing and JRE bundling are still working properly.</p>
+</li>
+</ol>
+</div>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>All the above steps need to be performed in the <code>n4js-n4</code> repository, accordingly (e.g. file <code>N4JS-N4.setup</code>).</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_update-of-the-embedded-jre"><a class="anchor" href="#_update-of-the-embedded-jre"></a><a class="link" href="#_update-of-the-embedded-jre">3.3.2. Update of the embedded JRE</a></h4>
+<div class="paragraph">
+<p>For updating the embedded JRE inside the N4JS IDE follow these steps:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Given a new JRE download location for Linux, MacOS and Windows with a common new version</p>
+</li>
+<li>
+<p>Update the location related properties in the pom.xml files of</p>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p>n4js/builds/pom.xml</p>
+</li>
+<li>
+<p>n4js/builds/org.eclipse.n4js.jre.linux.gtk.x86_64/pom.xml</p>
+</li>
+<li>
+<p>n4js/builds/org.eclipse.n4js.jre.macosx.cocoa.x86_64/pom.xml</p>
+</li>
+<li>
+<p>n4js/builds/org.eclipse.n4js.jre.win32.win32.x86_64/pom.xml</p>
+</li>
+</ol>
+</div>
+</li>
+<li>
+<p>Update the versions at all following locations:</p>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p>n4js/builds/org.eclipse.n4js.jre.linux.gtk.x86_64/META-INF/MANIFEST.MF</p>
+</li>
+<li>
+<p>n4js/builds/org.eclipse.n4js.jre.linux.gtk.x86_64/META-INF/p2.inf</p>
+</li>
+<li>
+<p>n4js/builds/org.eclipse.n4js.jre.macosx.cocoa.x86_64/META-INF/MANIFEST.MF</p>
+</li>
+<li>
+<p>n4js/builds/org.eclipse.n4js.jre.macosx.cocoa.x86_64/META-INF/p2.inf</p>
+</li>
+<li>
+<p>n4js/builds/org.eclipse.n4js.jre.win32.win32.x86_64/META-INF/MANIFEST.MF</p>
+</li>
+<li>
+<p>n4js/builds/org.eclipse.n4js.jre.win32.win32.x86_64/META-INF/p2.inf</p>
+</li>
+</ol>
+</div>
+</li>
+<li>
+<p>Update the openjdk docker image used as base image in the "FROM" line at the top of all docker files:</p>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p>n4js-n4/jenkins/docker-build/Dockerfile</p>
+</li>
+</ol>
+</div>
+</li>
+</ol>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_tips-and-tricks"><a class="anchor" href="#_tips-and-tricks"></a><a class="link" href="#_tips-and-tricks">4. Tips and Tricks</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>In this chapter we collect some coding hints and guidelines on how to properly use the APIs of Eclipse, EMF, Xtext and
+other dependencies we are using, as well as our own utilities and helpers.</p>
+</div>
+<div class="paragraph">
+<p>This chapter is only about coding; add information on things like Eclipse setup or Maven/Jenkins to one of the preceding
+chapters. Similarly, this chapter is intended to provide just a quick overview, check-list and reminder; add detailed
+information and diagrams to one of the succeeding chapters.</p>
+</div>
+<div class="sect2">
+<h3 id="_naming"><a class="anchor" href="#_naming"></a><a class="link" href="#_naming">4.1. Naming</a></h3>
+<div class="ulist">
+<ul>
+<li>
+<p>The internal handling of N4JS project names is non-trivial (due to the support for npm scopes), see
+API documentation of <code>ProjectDescriptionUtils#isProjectNameWithScope(String)</code> for a detailed overview.
+In short:</p>
+<div class="ulist">
+<ul>
+<li>
+<p><code>IN4JSProject#getProjectName()</code> and <code>IProject#getName()</code> return different values!</p>
+</li>
+<li>
+<p>Avoid using the Eclipse project name, i.e. the return value of <code>IProject#getName()</code>, as far as possible
+(only use it in UI code when actually dealing with what is shown in the Eclipse UI).</p>
+</li>
+<li>
+<p>The last segment of an URI or path pointing to an N4JS project is <strong>not</strong> always the project name; use
+utilities in <code>ProjectDescriptionUtils</code> instead, e.g. <code>#deriveN4JSProjectNameFromURI()</code>!
+(However, given an URI or path pointing to a file inside an N4JS project, you can use its last segment
+to obtain the file name.)</p>
+</li>
+</ul>
+</div>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_logging"><a class="anchor" href="#_logging"></a><a class="link" href="#_logging">4.2. Logging</a></h3>
+<div class="paragraph">
+<p>In many situations developer needs to use some kind of logging. When in need, follow these rules:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Use <code>org.apache.log4j.Logger;</code> for logging. Other logging utilities (like java built in logger) are not configured.</p>
+</li>
+<li>
+<p>do not use <code>System.out</code> nor <code>Sysetem.err</code> for logging. It is ok to use it for debugging purposes, but those calls
+should never be merged to master. <em>(with exception of headless compiler, which uses them explicitly)</em></p>
+</li>
+<li>
+<p>There is central logger configuration in <code>org.eclipse.n4js.utils.logging</code> (and <code>org.eclipse.n4js.utils.logging</code>) that should
+be used</p>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p><code>log4j.xml</code> used for production</p>
+</li>
+<li>
+<p><code>log4j_tests.xml</code> used when running tests</p>
+</li>
+</ol>
+</div>
+</li>
+<li>
+<p>in Eclipse run configurations logger has to be set properly, e.g.
+<code>log4j.configuration=file:${workspace_loc:org.eclipse.n4js.utils.logging/log4j_tests.xml}</code></p>
+</li>
+<li>
+<p>in maven configurations logger has to be set separately, e.g.
+<code>-Dlog4j.configuration="file:${basedir}/../../plugins/org.eclipse.n4js.utils.logging/log4j_tests.xml</code></p>
+</li>
+</ol>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_cancellation-handling"><a class="anchor" href="#_cancellation-handling"></a><a class="link" href="#_cancellation-handling">4.3. Cancellation Handling</a></h3>
+<div class="paragraph">
+<p>At various occasions, Xtext provides an instance of class <code>CancelIndicator</code> to allow our code to handle cancellation of
+long-running task.</p>
+</div>
+<div class="paragraph">
+<p>Some things to keep in mind:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>whenever a <code>CancelIndicator</code> is available any code that might not return immediately should implement proper
+cancellation handling (as explained in the next items).</p>
+</li>
+<li>
+<p>most importantly: reacting to a cancellation by returning early from a method is an anti-pattern that leads to
+problems (client code might continue work on a canceled and thus invalid state); instead: throw an
+<code>OperationCanceledException</code>!</p>
+</li>
+<li>
+<p>don&#8217;t use <code>CancelIndicator#isCanceled()</code> for cancellation handling, except in certain special cases. A valid exception
+case might be during logging to show a message like "operation was canceled".</p>
+</li>
+<li>
+<p>instead, inject the Xtext service called <code>OperationCanceledManager</code> and invoke its method <code>#checkCanceled()</code>, passing-in
+the cancel indicator (this method is null-safe; it will throw an <code>OperationCanceledException</code> in case a cancellation has
+occurred). Don&#8217;t directly create and throw an <code>OperationCanceledException</code> yourself.</p>
+</li>
+<li>
+<p>use the other methods provided by <code>OperationCanceledManager</code> when appropriate (see code of that class for details).</p>
+</li>
+<li>
+<p>in try/catch blocks, when catching exceptions of a super type of <code>OperationCanceledException</code>, be sure to <strong>not suppress</strong>
+cancellation exceptions. For example:</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-java" data-lang="java">// Java code
+@Inject private OperationCanceledManager operationCanceledManager;
+/** Returns true on success, false otherwise. */
+public boolean doSomething(CancelIndicator ci) {
+  try {
+    // do something that might be canceled
+    return true;
+  } catch(Exception e) {
+    operationCanceledManager.propagateIfCancelException(e); // &lt;- IMPORTANT!
+    return false;
+  }
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Try/finally blocks, on the other hand, do not need any special handling.</p>
+</div>
+</li>
+<li>
+<p>a cancel indicator can also be stored in the rule environment (see <code>RuleEnvironmentExtensions#addCancelIndicator()</code>). This
+means:</p>
+<div class="ulist">
+<ul>
+<li>
+<p>if you create a rule environment completely from scratch and you have a cancel indicator at hand, add it to the rule
+environment via <code>RuleEnvironmentExtensions#addCancelIndicator()</code> (not required when using <code>RuleEnvironmentExtensions#wrap()</code> for
+deriving a rule environment from an existing one).</p>
+</li>
+<li>
+<p>if you have a rule environment available, be sure to use its cancel indicator in long-running operations, i.e. with
+code like:</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-java" data-lang="java">// Xtend code
+import static extension org.eclipse.n4js.typesystem.utils.RuleEnvironmentExtensions.*
+class C {
+  @Inject private OperationCanceledManager operationCanceledManager;
+  def void doSomething() {
+    for(a : aLotOfStuff) {
+      operationCanceledManager.checkCanceled(G.cancelIndicator);
+      // main work ...
+    }
+  }</code></pre>
+</div>
+</div>
+</li>
+</ul>
+</div>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_caching"><a class="anchor" href="#_caching"></a><a class="link" href="#_caching">4.4. Caching</a></h3>
+<div class="ulist">
+<ul>
+<li>
+<p>Caching of external libraries (implemented in ExternalProjectMappings)</p>
+<div class="ulist">
+<ul>
+<li>
+<p>update <em>only</em> using <code>EclipseExternalLibraryWorkspace#updateState()</code></p>
+</li>
+<li>
+<p>always mind that the diff of current state and cached state is a necessary information for cleaning dependencies of removed npms</p>
+<div class="ulist">
+<ul>
+<li>
+<p>see <code>EclipseExternalIndexSynchronizer#synchronizeNpms()</code> for implementation</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>updating also happens when external root locations change (see ExternalIndexUpdater)</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>Caching of user workspace projects (implemented in MuliCleartriggerCache)</p>
+<div class="ulist">
+<ul>
+<li>
+<p>caches only some project information and should be refactored along with Core, Model and EclipseBasedN4JSWorkspace</p>
+</li>
+</ul>
+</div>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_dependency-injection"><a class="anchor" href="#_dependency-injection"></a><a class="link" href="#_dependency-injection">4.5. Dependency Injection</a></h3>
+<div class="paragraph">
+<p>There are some things to keep in mind when using dependency injection in the context of Xtext. This is a longer topic and it is discussed in the appendix
+<a href="#sec:XtextInjection">Xtext Injection</a>.</p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_miscellaneous"><a class="anchor" href="#_miscellaneous"></a><a class="link" href="#_miscellaneous">4.6. Miscellaneous</a></h3>
+<div class="ulist">
+<ul>
+<li>
+<p>Resource load states: when an N4JS/N4JSD file is loaded, a certain sequence of processing is triggered (parsing,
+linking, validation, etc.) and thus an <code>N4JSResource</code> transitions through a sequence of "load states". For details,
+see <a href="#sec:N4JS_Resource_Load_States">N4JS Resource Load States</a>.</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_parser"><a class="anchor" href="#_parser"></a><a class="link" href="#_parser">5. Parser</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>Some of the concepts described here were presented at
+<a href="https://www.youtube.com/watch?v=Xm-7aE1UMGY&amp;feature=youtu.be">EclipseCon 2013</a> and
+<a href="https://vimeo.com/channels/xtextcon/98446435">XtextCon 2014</a>. Note that the material presented at the linked videos may be outdated.</p>
+</div>
+<div class="sect2">
+<h3 id="sec:Parser_Overview"><a class="anchor" href="#sec:Parser_Overview"></a><a class="link" href="#sec:Parser_Overview">5.1. Overview</a></h3>
+<div class="paragraph">
+<p>The parser is created from an Xtext grammar. Actually, there are several grammars used as shown in <a href="#fig:cd_grammars">Figure CD Grammars</a>. These grammars and the parsers generated from them are described more closely in the following sections.</p>
+</div>
+<div id="fig:cd_grammars" class="imageblock center">
+<div class="content">
+<img src="chapters/05_parser/images/cd_grammars.svg" alt="cd grammars">
+</div>
+<div class="title">Figure 2. N4 Grammars</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="sec:N4JS_Parser"><a class="anchor" href="#sec:N4JS_Parser"></a><a class="link" href="#sec:N4JS_Parser">5.2. N4JS Parser</a></h3>
+<div class="paragraph">
+<p>One of the most tricky parts of JavaScript is the parsing because there is a conceptual mismatch between the <a href="#AC">ANTLR</a> runtime and the specified grammar. Another challenge is the disambiguation of regular expressions and binary operations. Both features require significant customizing of the generated parser (see figure below).</p>
+</div>
+<div id="fig:cd_ASIParser" class="imageblock center">
+<div class="content">
+<img src="chapters/05_parser/images/cd_ASIParser.svg" alt="cd ASIParser">
+</div>
+<div class="title">Figure 3. Overview custom parser implementation (runtime only)</div>
+</div>
+</div>
+<div class="sect2 language-bash">
+<h3 id="sec:Parser_Generation_Post_Processing"><a class="anchor" href="#sec:Parser_Generation_Post_Processing"></a><a class="link" href="#sec:Parser_Generation_Post_Processing">5.3. Parser Generation Post-Processing</a></h3>
+<div class="paragraph">
+<p>The ANTLR grammar that is generated by Xtext is post-processed to inject custom code into the grammar file before it is passed to the ANTLR tool. This is required in particular due to <a href="#AC">ASI</a> (Automated Semicolon Insertion), but for some other reasons as well.</p>
+</div>
+<div class="paragraph">
+<p>Actually, there are several injections:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Due to Xtext restrictions, the generated ANTLR grammar file (<strong>*.g</strong>) is modified. This means that some some additional actions are added and some rules are rewritten.</p>
+</li>
+<li>
+<p>Due to ANTLR restrictions, the generated ANTLR Java parser (<strong>*.java</strong>) os modified. This means that some generated rules are slightly modified to match certain requirements.</p>
+</li>
+<li>
+<p>Due to Java restrictions, the generated Java parser needs to be preprocessed in order to reduce the size of certain methods since they must not exceed 64k characters. This is implemented by means of an MWE fragment, activated after the other post processing steps are done.</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>The first two steps are handled by <code>AntlrGeneratorWithCustomKeywordLogic</code>, which is configured with additional helpers in <code>GenerateN4JS.mwe2</code>. shows the customized classes which modify the code generation. These classes are all part of the <code>releng.utils</code> bundle.</p>
+</div>
+<div class="imageblock center">
+<div class="content">
+<img src="chapters/05_parser/images/cd_parsergeneration.svg" alt="cd parsergeneration">
+</div>
+<div class="title">Figure 4. Class Diagram Parser Generation</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Automatic_Semicolon_Insertion"><a class="anchor" href="#sec:Automatic_Semicolon_Insertion"></a><a class="link" href="#sec:Automatic_Semicolon_Insertion">5.3.1. Automatic Semicolon Insertion</a></h4>
+<div class="paragraph">
+<p>The EcmaScript specification mandates that valid implementations automatically insert a semicolon as a statement delimiter if it is missing and the input file would become invalid due to the missing semicolon. This is known as <a href="#AC">ASI</a>. It implies that not only valid implementations have to perform this, but a valid parser has to mimic this behavior in order to parse executable code. The <a href="#AC">ASI</a> is implemented by two different means.</p>
+</div>
+<div class="paragraph">
+<p>The parser’s error recovery strategy is customized so it attempts to insert a semicolon if it was expected. Both strategies have to work hand in hand in order to consume all sorts of legal JavaScript code.</p>
+</div>
+<div class="sect4">
+<h5 id="sec:Injected_code_in_the_Antlr_grammar_file"><a class="anchor" href="#sec:Injected_code_in_the_Antlr_grammar_file"></a><a class="link" href="#sec:Injected_code_in_the_Antlr_grammar_file">5.3.1.1. Injected code in the Antlr grammar file</a></h5>
+<div class="paragraph">
+<p>Under certain circumstances, the parser has to actively promote a token to become a semicolon even though it may be a syntactically a closing brace or line break. This has to happen before that token is consumed thus the rules for return statements, continue statements and break statements are enhanced to actively promote these tokens to semicolons.</p>
+</div>
+<div class="paragraph">
+<p>The same rule is applied to promote line breaks between an expression and a possible postfix operator <code>++</code> or <code>–</code>. At this location the line break is always treated as a semicolon even though the operator may be validly consumed and produce a postfix expression.</p>
+</div>
+<div class="paragraph">
+<p>In both cases, the method <code>promoteEOL()</code> is used to move a token that may serve as an automatically injected semicolon from the so called hidden token channel to the semantic channel. The hidden tokens are usually not handled by the parser explicitly thus they are semantically invisible (therefore the term hidden token). Nevertheless, they can be put on the semantic channel explicitly to make them recognizable. That’s implemented in the EOL promotion. The offending tokens include the hidden line terminators and multi-line comments that include line breaks. Furthermore, closing braces (right curly brackets) are included in the set of offending tokens as well as explicit semicolons.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Customized_error_recovery"><a class="anchor" href="#sec:Customized_error_recovery"></a><a class="link" href="#sec:Customized_error_recovery">5.3.1.2. Customized error recovery</a></h5>
+<div class="paragraph">
+<p>Since the EOL promotion does not work well with Antlr prediction mode, another customization complements that feature. As soon as an invalid token sequence is attempted to be parsed and missing semicolon would make that sequence valid, an offending token is sought and moved to the semantic channel. This is implemented in the custom recovery strategy.</p>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:_No_line_terminator_allowed_here__handling"><a class="anchor" href="#sec:_No_line_terminator_allowed_here__handling"></a><a class="link" href="#sec:_No_line_terminator_allowed_here__handling">5.3.2. Async and <code>No line terminator allowed here</code> Handling</a></h4>
+<div class="paragraph">
+<p>There is no way of directly defining <code>No line terminator allowed here</code>. This is required not only for <a href="#AC">ASI</a>, but also for <code>async</code>. This requires not only a special rule (using some rules from <a href="#sec:Automatic_Semicolon_Insertion">ASI</a>), but also a special error recovery since the token ’async’ may be rejected (by the manually enriched rule) which is of course unexpected behavior from the generated source code.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Regular_Expression"><a class="anchor" href="#sec:Regular_Expression"></a><a class="link" href="#sec:Regular_Expression">5.3.3. Regular Expression</a></h4>
+<div class="paragraph">
+<p>The ANTLR parsing process can basically be divided into three steps. First of all, the file contents has to be read from disk. This includes the proper encoding of bytes to characters. The second step is the lexing or tokenizing of the character stream. A token is a basically a typed region in the stream, that is a triplet of token-id, offset and length. The last step is the parsing of these tokens. The result is a semantic model that is associated with a node tree. All necessary information to validate the model can be deduced from these two interlinked representations.</p>
+</div>
+<div class="imageblock center">
+<div class="content">
+<img src="chapters/05_parser/images/ad_parsing_simplified.svg" alt="ad parsing simplified">
+</div>
+<div class="title">Figure 5. Simplified visualization of the parsing</div>
+</div>
+<div class="paragraph">
+<p>Since the default semantics and control flow of Antlr generated parsers do not really fit the requirements of a fully working JavaScript parser, some customizations are necessary. <strong>Regular expression literals in JavaScript cannot be syntactically disambiguated from div operations without contextual information.</strong> Nevertheless, the spec clearly describes, where a regular expression may appear and where it is prohibited. Unfortunately, it is not possible to implement these rules in the lexer alone, since it does not have enough contextual information. Therefore, the parser has been enhanced to establish a communication channel with the lexer. It announces when it expects a regular expression rather than a binary operation.</p>
+</div>
+<div class="paragraph">
+<p>This required a reworking of the Antlr internals. Instead of a completely pre-populated <code>TokenStream</code>, the parser works on a lazy implementation that only reads as many characters as possible without a disambiguation between regular expression literals and divide operators.</p>
+</div>
+<div class="paragraph">
+<p>Only after the parser has read this buffered tokens and potentially announced that it expects a regular expression, another batch of characters is processed by the lexer until the next ambiguous situation occurs. This is fundamentally different from the default behavior of Antlr.</p>
+</div>
+<div class="imageblock center">
+<div class="content">
+<img src="chapters/05_parser/images/sd_parsing_sequence.svg" alt="sd parsing sequence">
+</div>
+<div class="title">Figure 6. Abstract control and object flow during parsing</div>
+</div>
+<div class="paragraph">
+<p>shows the involved classes which allow for this lexer-parser communication.</p>
+</div>
+<div class="imageblock center">
+<div class="content">
+<img src="chapters/05_parser/images/cd_parserlexercommunication.svg" alt="cd parserlexercommunication">
+</div>
+<div class="title">Figure 7. Class Diagram Parser-Lexer Communication</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Unicode"><a class="anchor" href="#sec:Unicode"></a><a class="link" href="#sec:Unicode">5.3.4. Unicode</a></h4>
+<div class="paragraph">
+<p>Unicode support in JavaScript includes the possibility to use unicode escape sequences in identifiers, string literals and regular expression literals. Another issue in this field is the specification of valid identifiers in JavaScript. They are described by means of unicode character classes. These have to be enumerated in the terminal rules in order to fully accept or reject valid or invalid JS identifiers.</p>
+</div>
+<div class="paragraph">
+<p>For that purpose, a small code generator is used to define the terminal fragments for certain unicode categories. The <code>UnicodeGrammarGenerator</code> basically iterates all characters from <code>Character.MIN_VALUE</code> to <code>Character.MAX_VALUE</code> and adds them as alternatives to the respective terminal fragments, e.g. <code>UNICODE_DIGIT_FRAGMENT</code>.</p>
+</div>
+<div class="paragraph">
+<p>The real terminal rules are defined as a composition of these generated fragments. Besides that, each character in an identifier, in a string literal or in a regular expression literal may be represented by its unicode escape value, e.g. ` u0060`. These escape sequences are handled and validated by the <code>IValueConverter</code> for the corresponding terminal rules.</p>
+</div>
+<div class="paragraph">
+<p>The second piece of the puzzle are the unicode escaped sequences that may be used in keywords. This issue is covered by the <code>UnicodeKeywordHelper</code> which replaces the default terminal representation in the generated Antlr grammar by more elaborated alternatives. The keyword <code>if</code> is not only lexed as <code>’if’</code> but as seen in snippet
+<a href="#lst:terminal_if">Terminal if listing</a>.</p>
+</div>
+<div id="lst:terminal_if" class="listingblock">
+<div class="title">Terminal if</div>
+<div class="content">
+<pre class="highlight"><code>If :
+    ( 'i' | '\\' 'u' '0``   0``   6``   9' )
+    ( 'f' | '\\' 'u' '0``   0``   6``   6' );</code></pre>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Literals"><a class="anchor" href="#sec:Literals"></a><a class="link" href="#sec:Literals">5.3.5. Literals</a></h4>
+<div class="paragraph">
+<p>Template literals are also to be handled specially, see <code>TemplateLiteralDisambiguationInjector</code> for details.</p>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:Modifiers"><a class="anchor" href="#sec:Modifiers"></a><a class="link" href="#sec:Modifiers">5.4. Modifiers</a></h3>
+<div class="paragraph">
+<p>On the AST side, all modifiers are included in a single enumeration <code>N4Modifier</code>. In the types model however, the individual modifiers are mapped to two different enumerations of <em>access</em> modifiers (namely <code>TypeAccessModifier</code> and <code>MemberAccessModifier</code>) and a number of boolean properties (in case of non-access modifiers such as <code>abstract</code> or <code>static</code>). This mapping is done by the types builder, mostly by calling methods in class <code>ModifierUtils</code>.</p>
+</div>
+<div class="paragraph">
+<p>The grammar allows the use of certain modifiers in many places that are actually invalid. Rules where a certain modifier may appear in the AST are implemented in method isValid(EClass,N4Modifier) in class <code>ModifierUtils</code> and checked via several validations in <code>N4JSSyntaxValidator</code>. Those validations also check for a particular order of modifiers that is not enforced by the grammar.</p>
+</div>
+<div class="paragraph">
+<p>See API documentation of enumeration <code>N4Modifier</code> in file <code>N4JS.xcore</code> and the utility class <code>ModifierUtils</code> for more details.</p>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:Conflict_Resolutions"><a class="anchor" href="#sec:Conflict_Resolutions"></a><a class="link" href="#sec:Conflict_Resolutions">5.5. Conflict Resolutions</a></h3>
+<div class="sect3">
+<h4 id="sec:Reserved_Keywords_vs__Identifier_Names"><a class="anchor" href="#sec:Reserved_Keywords_vs__Identifier_Names"></a><a class="link" href="#sec:Reserved_Keywords_vs__Identifier_Names">5.5.1. Reserved Keywords vs. Identifier Names</a></h4>
+<div class="paragraph">
+<p>Keywords and identifiers have to be distinguished by the lexer. Therefore, there is no means to decide upfront whether a certain keyword is actually used as a keyword or whether it is used as an identifier in a given context. This limitation is idiomatically overcome by a data type rule for valid identifiers. This data type rule enumerates all keywords which may be used as identifiers and the pure IDENTIFIER terminal rule as seen in <a href="#lst:keywords_as_identifier">Keywords as Identifier listing</a>.</p>
+</div>
+<div id="lst:keywords_as_identifier" class="listingblock">
+<div class="title">Keywords as Identifier</div>
+<div class="content">
+<pre class="highlight"><code class="language-ebnf" data-lang="ebnf">N4JSIdentifier: IDENTIFIER
+    | 'get'
+    | 'set'
+    ...
+;</code></pre>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Operators_and_Generics"><a class="anchor" href="#sec:Operators_and_Generics"></a><a class="link" href="#sec:Operators_and_Generics">5.5.2. Operators and Generics</a></h4>
+<div class="paragraph">
+<p>The ambiguity between shift operators and nested generics arises also from the fact, that Antlr lexer upfront without any contextual information. When implemented naively, the grammar will be broken, since a token sequence <code>a&gt;&gt;b</code> can either be part of <code>List&lt;List&lt;a&gt;&gt; b</code> or it can be part of a binary operation <code>int c = a &gt;&gt; b</code>. Therefore the shift operator may not be defined with a single token but has to be composed from individual characters (see <a href="#lst:shift_operator">Shift Operator listing</a>).</p>
+</div>
+<div id="lst:shift_operator" class="listingblock">
+<div class="title">Shift Operator listing</div>
+<div class="content">
+<pre class="highlight"><code class="language-ebnf" data-lang="ebnf">ShiftOperator:
+      '&gt;' '&gt;' '&gt;'?
+    | '&lt;' '&lt;'
+    ;</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:Content_Assist_Parser"><a class="anchor" href="#sec:Content_Assist_Parser"></a><a class="link" href="#sec:Content_Assist_Parser">5.6. Content-Assist Parser</a></h3>
+<div class="admonitionblock warning">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-warning" title=""></i>
+</td>
+<td class="content">
+This section may be outdated!
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>The <a href="#AC">CA</a> parser also needs adjustments for supporting automatic semicolon insertion and regular expressions. Instead of modifying the <a href="#AC">CA</a> parser generator similar to the normal parser, the former reuses parts of the latter as far as possible. That is, the token sequence that is produced during production parsing is used as is for the content assist parser. Semicolons have already been inserted where appropriate and regular expression are successfully distinguished from divide operators.</p>
+</div>
+<div class="paragraph">
+<p>Since the n4js grammar uses syntactic predicates, the content assist parser is compiled with backtracking enabled. This is always the case for Xtext’s CA parsers that rely on backtracking or predicates (local backtracking) in the production parser. This approach is both good (CA works in general) and bad (unpredictable decisions in case of error at locations prior to the cursor). Since parsing with backtracking enabled makes for a fundamental difference in how the prediction and parsing works and how the parser decides which decision paths to take, the customization patterns from the production parser are not applied 1:1 to the CA parser, but adapted instead. The content assist parser doesn’t use a freshly lexed token stream with unicode support, ASI or regular expression literals, but instead uses a synthesized token sequence which is rebuilt from the existing node model.</p>
+</div>
+<div class="paragraph">
+<p>The token stream that is consumed by the content assist parser is therefore not created by a lexer but by the <code>org.eclipse.n4js.ui.contentassist.NodeModelTokenSource</code>.
+It traverses the existing node model that is contained in the resource and was produced by the production parser. This approach has the significant advantage that any decision that was made by that parser is also immediately applicable to the content assist infrastructure. For that purpose, the leaf nodes of the node model are mapped to ANTLR token types.
+This is achieved by the <code>org.eclipse.n4js.ui.contentassist.ContentAssistTokenTypeMapper</code> which is capable to provide the untyped ANTLR token type (primitive int) for a given grammar element.</p>
+</div>
+<div class="paragraph">
+<p>Special considerations have been made for the last token in the produced source. If it overlaps with an existing leaf node but does not fully cover it, the plain Antlr lexer is used to consume the prefix that is overlapping. Since the terminals will never overlap with each other the longest match always wins without backtracking in the lexer, it is save to assume that only one token is produced from the prefix. The very last token in the <code>org.eclipse.n4js.ui.contentassist.NodeModelTokenSource</code> is always the EOF token (<code>org.antlr.runtime.Token.EOF_TOKEN</code>).</p>
+</div>
+<div class="paragraph">
+<p>Given that the token source is equal to the prefix in the production token source, some more thought has to be put into the synthesized end of file. The production parser used the complete file to decide where to automatically insert a semicolon and where not to. This would potentially change if there was another token next to the artificial EOF. Therefore, two cases have to considered. The first one describes CA request next to an automatically inserted semicolon and the second one describes CA requests at a position where a semicolon could have been inserted if the token to the right was another one. The <code>org.eclipse.n4js.ui.contentassist.CustomN4JSParser</code> reflects these cases. Heuristics are applied to the end of the token sequence to decide whether a second pass has to be performed to collect yet more following elements. Based on the concrete sequence, the last automatically inserted semicolon is removed from the sequence prior to the second pass or such is a token is explicitly synthesized and appended. Besides the second pass, another special treatment is made for postfix expressions. Those may not be interrupted by a hidden semicolon so those are filtered from the resulting follow set if appropriate.</p>
+</div>
+<div class="paragraph">
+<p>The parser is used by the <code>org.eclipse.n4js.ui.contentassist.ContentAssistContextFactory</code> where all relevant entry points from the super class are specialized to pass the node model in the the parser facade (<code>org.eclipse.n4js.ui.contentassist.CustomN4JSParser</code>). In that sense, the ContentAssistContextFactory serves as a drop-in replacement binding the default <code>ParserBasedContentAssistContextFactory.StatefulFactory</code>.</p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_type-system"><a class="anchor" href="#_type-system"></a><a class="link" href="#_type-system">6. Type System</a></h2>
+<div class="sectionbody">
+<div class="sect2 language-n4js">
+<h3 id="sec:Type_Model_and_Grammar"><a class="anchor" href="#sec:Type_Model_and_Grammar"></a><a class="link" href="#sec:Type_Model_and_Grammar">6.1. Type Model and Grammar</a></h3>
+<div class="paragraph">
+<p>The type model is used to define actual types and their relations (meta-model is defined by means of Xcore in file <code>Types.xcore</code>)
+and also references to types (meta-model in <code>TypeRefs.xcore</code>). The type model is built via the <code>N4JSTypesBuilder</code> when a resource
+is loaded and processed, and most type related tasks work only on the type model. Some types that are (internally) available
+in N4JS are not defined in N4JS, but instead in a special, internal type language not available to N4JS developers, called N4TS
+and defined in file <code>Types.xtext</code>.</p>
+</div>
+<div class="paragraph">
+<p>The types are referenced by AST elements; vice versa the AST elements can be referenced from the types (see <code>SyntaxRelatedTElement</code>).
+This backward reference is a simple reference to an EObject.</p>
+</div>
+<div class="sect3">
+<h4 id="sec:Type_Model_Overview"><a class="anchor" href="#sec:Type_Model_Overview"></a><a class="link" href="#sec:Type_Model_Overview">6.1.1. Type Model Overview</a></h4>
+<div class="paragraph">
+<p>The following figure, <a href="#fig:cd_typeAndTypeRefHierarchy">Types and Type References</a>, shows the classes of the type model and their inheritance relations, both the actual type definitions as defined in <code>Types.xcore</code> and the type references defined in <code>TypeRefs.xcore</code>. The most important type reference is the <code>ParameterizedTypeRef</code>; it is used for most user-defined references, for both parameterized and non-parameterized references. In the latter case, the list of type arguments is empty.</p>
+</div>
+<div id="fig:cd_typeAndTypeRefHierarchy" class="imageblock">
+<div class="content">
+<img src="chapters/06_typesystem/images/cd_typeModelHierarchy_allInOne.png" alt="cd typeModelHierarchy allInOne">
+</div>
+<div class="title">Figure 8. Type Model Overview: Types in the upper half and Type References in the lower half.</div>
+</div>
+<div class="paragraph">
+<p>Most types are self-explanatory. <code>TypeDefs</code> is the container element used in N4TS. Note that not all types and properties of types are available in N4JS – some can only be used in the N4TS language or be inferred by the type system for internal purposes. Some types need some explanation:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>TObjectPrototype</code>: Metatype for defining built-in object types such as <code>Object</code> or <code>Date</code>, only available in N4TS.</p>
+</li>
+<li>
+<p><code>VirtualBaseType</code>: This type is not available in N4JS. It is used to define common properties provided by all types of a certain metatype. E.g., it is used for defining some properties shared by all enumerations (this was the reason for introducing this type).</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>We distinguish four kinds of types as summarized in <a href="#tab:KindOfTypes">Kind Of Types</a>. Role is an internal construct for different kind of users who can define the special kind of type. The language column refers to the language used to specify the type; which is either N4JS or N4TS.</p>
+</div>
+<table id="tab:KindOfTypes" class="tableblock frame-all grid-all spread">
+<caption class="title">Table 1. Kind of Types</caption>
+<colgroup>
+<col style="width: 10%;">
+<col style="width: 10%;">
+<col style="width: 10%;">
+<col style="width: 70%;">
+</colgroup>
+<thead>
+<tr>
+<th class="tableblock halign-left valign-top">Kind</th>
+<th class="tableblock halign-left valign-top">Language</th>
+<th class="tableblock halign-left valign-top">Role</th>
+<th class="tableblock halign-left valign-top">Remark</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<th class="tableblock halign-left valign-top"><p class="tableblock">user</p></th>
+<th class="tableblock halign-left valign-top"><p class="tableblock">N4JS</p></th>
+<th class="tableblock halign-left valign-top"><p class="tableblock">developer</p></th>
+<td class="tableblock halign-left valign-top"><p class="tableblock">User defined types, such as declared classes or functions. These types are to be explicitly defined or imported in the code.</p></td>
+</tr>
+<tr>
+<th class="tableblock halign-left valign-top"><p class="tableblock">library</p></th>
+<th class="tableblock halign-left valign-top"><p class="tableblock">N4JSD</p></th>
+<th class="tableblock halign-left valign-top"><p class="tableblock">developer</p></th>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Type declarations only, comparable to C header files, without implementation. Used for defining the API of 3rd party libraries. These type definitions are to be explicitly defined or imported in the code.</p></td>
+</tr>
+<tr>
+<th class="tableblock halign-left valign-top"><p class="tableblock">builtin</p></th>
+<th class="tableblock halign-left valign-top"><p class="tableblock">N4TS</p></th>
+<th class="tableblock halign-left valign-top"><p class="tableblock">smith</p></th>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Built-in ECMAScript objects interpreted as types. E.g., <code>String</code>, <code>Date</code>, <code>Math</code>. These types are provided by N4JS and are always available.</p></td>
+</tr>
+<tr>
+<th class="tableblock halign-left valign-top"><p class="tableblock">primitive</p></th>
+<th class="tableblock halign-left valign-top"><p class="tableblock">N4TS</p></th>
+<th class="tableblock halign-left valign-top"><p class="tableblock">smith</p></th>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Primitive ECMAScript (and N4JS ties), such as <code>string</code>, <code>number</code>, <code>pathselector&lt;T&gt;</code>, <code>i18n</code>, and also <code>any</code>, <code>undefined</code> and <code>void</code>. These types are provided by N4JS and are always available. Primitive types are described in detail in the spec (see chapter "Primitive ECMAScript Types").</p></td>
+</tr>
+</tbody>
+</table>
+</div>
+<div class="sect3">
+<h4 id="sec:Built_in_Types"><a class="anchor" href="#sec:Built_in_Types"></a><a class="link" href="#sec:Built_in_Types">6.1.2. Built-in and Primitive Types</a></h4>
+<div class="paragraph">
+<p>The built-in and primitive types are not defined by the user, i.e. N4JS programmer. Instead, they are defined in special
+internal files using the internal N4TS language: <code>builtin_js.n4ts</code>, <code>builtin_n4.n4ts</code>, <code>primitives_js.n4ts</code>, <code>primitives_n4.n4ts</code>.</p>
+</div>
+</div>
+<div class="sect3 language-n4js">
+<h4 id="sec:Type_Model_DSL"><a class="anchor" href="#sec:Type_Model_DSL"></a><a class="link" href="#sec:Type_Model_DSL">6.1.3. Type Model DSL</a></h4>
+<div class="paragraph">
+<p>For defining built-in types and for tests, a special DSL called N4TS is provided by means of an Xtext grammar and generated
+tools. The syntax is similar to n4js, but of course without method or function bodies, i.e. without any statements of expressions.
+The grammar file is found in <code>Types.xtext</code>.</p>
+</div>
+<div class="paragraph">
+<p>The following list documents some differences to N4JS:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>access modifiers directly support <code>Internal</code>, so no annotations are needed (nor supported) here.</p>
+</li>
+<li>
+<p>besides N4 classifiers such as classes, the following classifiers can be defined:</p>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p><code>object</code> define classes derived from object (predefined object types) Special features:</p>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+indexed
+</td>
+<td class="hdlist2">
+<p>defined what type is returned in case of index access</p>
+</td>
+</tr>
+</table>
+</div>
+</li>
+<li>
+<p><code>virtualBase</code> virtual base types for argument</p>
+</li>
+</ol>
+</div>
+</li>
+<li>
+<p><code>primitive</code> primitive types (number, string etc.) Special features:</p>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+indexed
+</td>
+<td class="hdlist2">
+<p>defined what type is returned in case of index access</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+autoboxedType
+</td>
+<td class="hdlist2">
+<p>defines to which type the primitive can be auto boxed</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+assignmnentCompatible
+</td>
+<td class="hdlist2">
+<p>defines to which type the primitive is assignment compatible</p>
+</td>
+</tr>
+</table>
+</div>
+</li>
+<li>
+<p>types <code>any</code>, <code>null</code>, <code>void</code>, <code>undefined</code> – special types.</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>Annotations are not supported in the types DSL.</p>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:Type_System_Implementation"><a class="anchor" href="#sec:Type_System_Implementation"></a><a class="link" href="#sec:Type_System_Implementation">6.2. Type System Implementation</a></h3>
+<div class="paragraph">
+<p>The bulk of the type system&#8217;s functionality is implemented in packages <code>org.eclipse.n4js.typesystem[.constraints|.utils]</code>.
+Client code, e.g. in validations, should only access the type system through the facade class <code>N4JSTypeSystem</code>.
+Each of the main type system functions, called "judgments", are implemented in one of the concrete subclasses of
+base class <code>AbstractJudgment</code>. Internally, the type system is using a constraint solver for various purposes;
+entry point for this functionality is class <code>InferenceContext</code>. All these classes are a good entry point into
+the code base, for investigating further details.</p>
+</div>
+<div class="paragraph">
+<p>Some type information is cached (e.g., the type of an expression in the AST) and the above facade will take care
+to read from the cache instead of re-computing the information every time, as far as possible. This type cache is
+being filled in a dedicated phase during loading and processing of an N4JS resource;
+see <a href="#sec:Type_Inference_combined_with_AST_Traversal">Type Inference of AST</a> and <a href="#sec:N4JS_Resource_Load_States">N4JS Resource Load States</a> for details.</p>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:Type_Inference_combined_with_AST_Traversal"><a class="anchor" href="#sec:Type_Inference_combined_with_AST_Traversal"></a><a class="link" href="#sec:Type_Inference_combined_with_AST_Traversal">6.3. Type Inference of AST</a></h3>
+<div class="paragraph">
+<p>Most judgments provided by the facade <code>N4JSTypeSystem</code> and implemented by subclasses of <code>AbstractJudgment</code> are used
+ad-hoc whenever client code requires the information they provide. This is applied, in particular, to judgments</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>subtype</code></p>
+</li>
+<li>
+<p><code>substTypeVariables</code></p>
+</li>
+<li>
+<p><code>upperBound</code> / <code>lowerBound</code></p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>For judgment <code>type</code> footnote:<code class="Currently only for [language-n4js">type</code>, not for <code class="language-n4js">expectedType</code>,
+but this may be changed in a future, further refactoring.], however, the processing is very different: we make
+sure that the entire AST, i.e. all typable nodes of the AST, will be typed up-front in a single step, which
+takes place during the <em>post-processing step</em> of an N4JSResource (see <a href="#sec:N4JS_Resource_Load_States">N4JS Resource Load States</a>), which
+also has a couple other responsibilities. By triggering post-processing when client code invokes the type judgment
+for the first time for some random AST node (at the latest; usually it is triggered earlier), we make sure that
+this sequence is always followed.</p>
+</div>
+<div class="paragraph">
+<p>The remainder of this section will explain this single-step typing of the entire AST in detail.</p>
+</div>
+<div class="sect3">
+<h4 id="sec:Type_Inference_combined_with_AST_Traversal__Background"><a class="anchor" href="#sec:Type_Inference_combined_with_AST_Traversal__Background"></a><a class="link" href="#sec:Type_Inference_combined_with_AST_Traversal__Background">6.3.1. Background</a></h4>
+<div class="paragraph">
+<p>Originally, the N4JS type system could be called with any <code>EObject</code> at any given time, without any knowledge of the
+context. While this looked flexible in the beginning, it caused severe problems solving some inference cases, e.g.,
+the rule environment had to be prepared from the outside and recursion problems could occur, and it was also
+inefficient because some things had to be recalculated over and over again (although caching helped).</p>
+</div>
+<div class="paragraph">
+<p>It is better to do type inferencing (that is, computing the type of expressions in general) in a controlled manner.
+That is, instead of randomly computing the type of an expression in the AST, it is better to traverse the AST in a
+well-defined traversal order. That way, it is guaranteed that certain other nodes have been visited and, if not,
+either some special handling can kick in or an error can be reported. This could even work with XSemantics and the
+declarative style of the rules. The difference is that by traversing the AST in a controlled manner, the rules can
+make certain assumptions about the content of the rule-environment, such as that it always contains information
+about type variable bindings and that it always contains information about expected types etc.</p>
+</div>
+<div class="paragraph">
+<p>In that scenario, all AST nodes are visited and all types (and expected types) are calculated up-front. Validation
+and other parts then do not need to actually compute types (by calling the actual, Xsemantics-generated type system);
+instead, at that time all types have already been calculated and can simply be retrieved from the cache (this is
+taken care of by the type system facade <code>N4JSTypeSystem</code>).</p>
+</div>
+<div class="paragraph">
+<p>This also affects scoping, since all cross-references have to be resolved in this type computation step. However,
+even for scoping this has positive effects: E.g., the receiver type in property access expressions is always visited
+<em>before</em> visiting the selector. Thus it is not necessary to re-calculate the receiver type in order to perform scoping
+for the selector.</p>
+</div>
+<div class="paragraph">
+<p>The above refactoring was done in summer 2015. After this refactoring, we are still using Xsemantics to compute the
+types, i.e. the <code>type</code>     judgement in Xsemantics was largely kept as before. However, the type judgment is invoked
+in a controlled traversal order for each typable AST node in largely one step (controlled by <code>ASTProcessor</code> and <code>TypeProcessor</code>).</p>
+</div>
+<div class="paragraph">
+<p>The upshot of this one-step type inference is that once it is completed, the type for every typable AST node is known.
+Instead of storing this information in a separate model, this information will be stored and persisted in the type model
+directly, as well as in transient fields of the AST <sup class="footnote">[<a id="_footnoteref_1" class="footnote" href="#_footnote_1" title="View footnote.">1</a>]</sup>. Currently, this applies only to types, not expected types;
+the inference of expected types could / should be integrated into the one-step inference as part of a future, further
+refactoring.</p>
+</div>
+<table id="tab:typeInferenceBeforeAfter" class="tableblock frame-all grid-all spread">
+<caption class="title">Table 2. Comparison of inference of type of AST nodes before / after refactoring.</caption>
+<colgroup>
+<col style="width: 50%;">
+<col style="width: 50%;">
+</colgroup>
+<thead>
+<tr>
+<th class="tableblock halign-left valign-top">Before</th>
+<th class="tableblock halign-left valign-top">After</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">ad-hoc type inference (when client code needs the type information)</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">up-front type inference (once for entire AST;
+later only reading from cache)</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">started anywhere</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">starts with root, i.e. the <code>Script</code></p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Xsemantics rules traverse the AST at will, uncontrolled</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">well-defined, controlled traversal order</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">lazy, on-demand resolution of <code>ComputedTypeRef</code>s (they contain the resolution logic)</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">pro-active resolution of
+<code>DeferredTypeRef</code>s (they themselves are dumb)</p></td>
+</tr>
+</tbody>
+</table>
+</div>
+<div class="sect3">
+<h4 id="sec:Triggering_Type_Inference_of_AST"><a class="anchor" href="#sec:Triggering_Type_Inference_of_AST"></a><a class="link" href="#sec:Triggering_Type_Inference_of_AST">6.3.2. Triggering</a></h4>
+<div class="paragraph">
+<p>The up-front type inference of the entire AST is part of the post-processing of every N4JSResource and is thus
+triggered when post-processing is triggered. This happens when</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>someone directly calls <code>#performPostProcessing()</code> on an N4JSResource</p>
+</li>
+<li>
+<p>someone directly calls <code>#resolveAllLazyCrossReferences()</code> on an N4JSResource,</p>
+</li>
+<li>
+<p>EMF automatically resolves the first proxy, i.e. someone calls an EMF-generated getter for a value that is a proxy,</p>
+</li>
+<li>
+<p>someone asks for a type for the first time, i.e. calls <code>N4JSTypeSystem#type()</code>,</p>
+</li>
+<li>
+<p>&#8230;&#8203;</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>Usually this happens after the types builder was run with <code>preLinking==false</code> and before validation takes place.
+For details, see classes <code>PostProcessingAwareResource</code> and <code>N4JSPostProcessor</code>.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Traversal_Order_During_Type_Inference_of_AST"><a class="anchor" href="#sec:Traversal_Order_During_Type_Inference_of_AST"></a><a class="link" href="#sec:Traversal_Order_During_Type_Inference_of_AST">6.3.3. Traversal Order</a></h4>
+<div class="paragraph">
+<p>The traversal order during post-processing is a bit tricky, as some things need to be done in a top-down order (only
+few cases, for now <sup class="footnote">[<a id="_footnoteref_2" class="footnote" href="#_footnote_2" title="View footnote.">2</a>]</sup>), others in a bottom-up order (e.g. the main typing of AST nodes),
+and there is a third case in which several AST nodes are processed together (constraint-based type inference).</p>
+</div>
+<div class="paragraph">
+<p>Figure <a href="#fig:traversalOrder">Order in which AST nodes are being processed during post-processing.</a> provides an example of an AST and shows in which order the nodes are processed. Green
+numbers represent top-down processing, red numbers represent bottom-up processing and blue numbers represent the
+processing of the surrounding yellow nodes in a single step.</p>
+</div>
+<div id="fig:traversalOrder" class="imageblock">
+<div class="content">
+<img src="chapters/06_typesystem/images/traversalOrder.png" alt="traversalOrder">
+</div>
+<div class="title">Figure 9. Order in which AST nodes are being processed during post-processing.</div>
+</div>
+<div class="paragraph">
+<p>In the code, this is controlled by class <code>ASTProcessor</code>. The two main processing methods are</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>#processNode_preChildren()</code>, which will be invoked for all AST nodes in a top-down order (so top-down processing should be put here),</p>
+</li>
+<li>
+<p><code>#processNode_postChildren()</code>, which will be invoked for all AST nodes in a bottom-up order (so bottom-up processing should be put here).</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>The common processing of groups of adjacent yellow nodes (represented in the figure by the two yellow/brown
+triangles) is achieved by <code>PolyProcessor</code> telling the <code>TypeProcessor</code> to</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>ignore certain nodes (all yellow nodes) and</p>
+</li>
+<li>
+<p>invoke method <code>PolyProcessor#inferType()</code> for the root yellow node in each group (only the root!).
+.
+For details, see the two methods <code>#isResponsibleFor()</code> and <code>#isEntryPoint()</code> in <code>PolyProcessor</code>.</p>
+</li>
+</ol>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Cross_References_During_Type_Inference_of_AST"><a class="anchor" href="#sec:Cross_References_During_Type_Inference_of_AST"></a><a class="link" href="#sec:Cross_References_During_Type_Inference_of_AST">6.3.4. Cross-References</a></h4>
+<div class="paragraph">
+<p>While typing the entire AST, cross-references need special care. Three cases of cross-references need to be distinguished:</p>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+backward reference
+</td>
+<td class="hdlist2">
+<p>= cross-reference within the same file to an AST node that was already processed</p>
+<div class="ulist">
+<ul>
+<li>
+<p>always legal</p>
+</li>
+<li>
+<p>processing: simply read the type from the cache that is currently being filled</p>
+</li>
+</ul>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+forward reference
+</td>
+<td class="hdlist2">
+<p>= cross-reference within the same file to an AST node that was not yet processed</p>
+<div class="ulist">
+<ul>
+<li>
+<p>usually illegal<br>
+exception: legal if reference points to an <em>identifiable subtree</em> (a subtree of an AST with an identifiable element at its root)</p>
+</li>
+<li>
+<p>processing: forward process the identifiable subtree and report back the type of its root</p>
+</li>
+</ul>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+references to other files
+</td>
+<td class="hdlist2">
+<div class="ulist">
+<ul>
+<li>
+<p>always legal, because they can, by nature, only point to an identifiable subtree in the other file&#8217;s AST</p>
+</li>
+<li>
+<p>processing: either &#8230;&#8203;</p>
+<div class="ulist">
+<ul>
+<li>
+<p>read type from TModule obtained from index (if available), or</p>
+</li>
+<li>
+<p>load other file from source, trigger its post-processing (if not in progress or completed already), forward process the identifiable subtree (if not processed already) and report back the type of its root.</p>
+</li>
+</ul>
+</div>
+</li>
+</ul>
+</div>
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>Note that for references to an ancestor (upward references) or successor (downward references) within an AST, the
+classification as a forward or backward reference depends on whether we are in top-down or bottom-up processing.
+Figure <a href="#fig:upwardDownward">Upward Downward</a> illustrates this: the left and right side show the same AST but on the
+left side we assume a top down processing whereas on the right we assume a bottom up processing. On both sides,
+backward references are shown in green ink (because they are unproblematic and always legal) and forward references
+are shown in red ink. Now, looking at the two arrows pointing from a node to its parent, we see that it is classified
+as a backward reference on the left side (i.e. top down case) but as a forward reference on the right side (i.e. bottom
+down case). Conversely, an arrow from a node to its child is classified as a forward reference on the left side and as
+a backward reference on the right side. Arrows across subtrees, however, are classified in the same way on the left and
+right side (see the horizontal arrows at the bottom).</p>
+</div>
+<div id="fig:upwardDownward" class="imageblock">
+<div class="content">
+<img src="chapters/06_typesystem/images/upwardDownward.png" alt="upwardDownward">
+</div>
+<div class="title">Figure 10. Backward and forward references in top-down and bottom-up processing.</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Function_Accessor_Bodies_During_Type_Inference_of_AST"><a class="anchor" href="#sec:Function_Accessor_Bodies_During_Type_Inference_of_AST"></a><a class="link" href="#sec:Function_Accessor_Bodies_During_Type_Inference_of_AST">6.3.5. Function/Accessor Bodies</a></h4>
+<div class="paragraph">
+<p>An important exception to the basic traversal order shown in Figure <a href="#fig:traversalOrder">Order in which AST nodes are being processed during post-processing.</a> is that the body of all
+functions (including methods) and field accessors is postponed until the end of processing. This is used to avoid
+unnecessary cycles during type inference due to a function&#8217;s body making use of the function itself or some other
+declarations on the same level as the containing function. For example, the following code relies on this:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">let x = f();
+function f(): X {
+	if(x) {
+		// XPECT noerrors --&gt; "any is not a subtype of X." at "x"
+		return x;
+	}
+	return new X();
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Similar situation using fields and methods:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">class C {
+	d = new D();
+	mc() {
+		// XPECT noerrors --&gt; "any is not a subtype of D." at "this.d"
+		let tmp: D = this.d;
+	}
+}
+class D {
+	md() {
+		new C().mc();
+	}
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>For details of this special handling of function bodies, see method <code>ASTProcessor#isPostponedNode(EObject)</code> and field
+<code>ASTMetaInfoCache#postponedSubTrees</code> and the code using it. For further investigation, change <code>isPostponedNode()</code> to always
+return false and debug with the two examples above (which will then show the incorrect errors mentioned in the XPECT
+comments) or run tests to find more cases that require this handling.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Poly_Expressions_During_Type_Inference_of_AST"><a class="anchor" href="#sec:Poly_Expressions_During_Type_Inference_of_AST"></a><a class="link" href="#sec:Poly_Expressions_During_Type_Inference_of_AST">6.3.6. Poly Expressions</a></h4>
+<div class="paragraph">
+<p>Polymorphic expressions, or <em>poly expressions</em> for short, are expressions for which the actual type depends on the
+expected type and/or the expected type depends on the actual type. They require constraint-based type inference
+because the dependency between the actual and expected type can introduce dependency cycles between the types of
+several AST nodes which are best broken up by using a constraint-based approach. This is particularly true when
+several poly expressions are nested. Therefore, poly expressions are inferred neither in top-down nor in bottom-up
+order, but all together by solving a single constraint system.</p>
+</div>
+<div class="paragraph">
+<p>Only a few types of expressions can be polymorphic; they are called <em>poly candidates</em>: array literals, object literals,
+call expressions, and function expressions. The following rules tell whether a poly candidate is actually poly:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>ArrayLiteral</code> — always poly (because their type cannot be declared explicitly).</p>
+</li>
+<li>
+<p><code>ObjectLiteral</code> — if one or more properties do not have a declared type.</p>
+</li>
+<li>
+<p><code>CallExpression</code> — if generic &amp; not parameterized.</p>
+</li>
+<li>
+<p><code>FunctionExpression</code> — if return type or type of one or more formal parameters is undeclared.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>This is a simplified overview of these rules, for details see method <code>#isPoly(Expression)</code> in <code>AbstractPolyProcessor</code>.</p>
+</div>
+<div class="paragraph">
+<p>The main logic for inferring the type of poly expressions is found in method <code>#inferType()</code> in class <code>PolyProcessor</code>.
+It is important to note that this method will only be called for root poly expressions (see above). In short, the basic
+approach is to create a new, empty <code>InferenceContext</code>, i.e. constraint system, add inference variables and constraints for
+the root poly expression and all its nested poly expressions, solve the constraint system and use the types in the solution
+as the types of the root and nested poly expressions. For more details see method <code>#inferType()</code> in class <code>PolyProcessor</code>.</p>
+</div>
+<div class="paragraph">
+<p>So, this means that nested poly expressions do not introduce a new constraint system but instead simply extend their parent
+poly’s constraint system by adding additional inference variables and constraints. <strong>But not every nested expression that is
+poly is a nested poly expression in that sense!</strong> Sometimes, a new constraint system has to be introduced. For example:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>child poly expressions that appear as argument to a call expression are nested poly expressions (i.e. inferred in same constraint system as the parent call expression),</p>
+</li>
+<li>
+<p>child poly expressions that appear as target of a call expression are <strong>not</strong> nested poly expressions and a new constraint system has to be introduced for them.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>For details see method <code>#isRootPoly()</code> in <code>AbstractPolyProcessor</code> and its clients.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Constraint_Solver_used_During_Type_Inference_of_AST"><a class="anchor" href="#sec:Constraint_Solver_used_During_Type_Inference_of_AST"></a><a class="link" href="#sec:Constraint_Solver_used_During_Type_Inference_of_AST">6.3.7. Constraint Solver</a></h4>
+<div class="paragraph">
+<p>The simple constraint solver used by the N4JS type system, mainly for the inference of poly expressions, is implemented
+by class <code>InferenceContext</code> and the other classes in package <code>org.eclipse.n4js.typesystem.constraints</code>.</p>
+</div>
+<div class="paragraph">
+<p>The constraint solving algorithm used here is largely modeled after the one defined in <code>The Java Language Specification 8</code>,
+Chapter 18, but was adjusted in a number of ways, esp. by removing functionality not required for N4JS (e.g. primitive types,
+method overloading) and adding support for specific N4JS language features (e.g. union types, structural typing).</p>
+</div>
+<div class="paragraph">
+<p>For details see the API documentation of class <code>InferenceContext</code>.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Type_Guards_During_Type_Inference_of_AST"><a class="anchor" href="#sec:Type_Guards_During_Type_Inference_of_AST"></a><a class="link" href="#sec:Type_Guards_During_Type_Inference_of_AST">6.3.8. Type Guards</a></h4>
+<div class="paragraph">
+<p>During AST post-processing, the control and data flow analyses are performed.
+This means, that first a flow graph is created and then traversed.
+During the traversal, a type guard analysis is performed which saves information by evaluating <code>instanceof</code> expressions.
+As a result, the analysis provides a reliable set of RHS expressions of <code>instanceof</code> expressions for each AST element of type <code>IdentifierRef</code>.</p>
+</div>
+<div class="paragraph">
+<p>This set is evaluated in the <code>TypeJudgments.java</code> when typing <code>IdentifierRef</code> elements.
+In case the set is not empty, the types of all elements is calculated.
+The type of the <code>IdentifierRef</code> will then become the intersection of its original type and all types previously calculated.</p>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="sec:Structural_Typing"><a class="anchor" href="#sec:Structural_Typing"></a><a class="link" href="#sec:Structural_Typing">6.4. Structural Typing</a></h3>
+<div class="paragraph">
+<p>Structural typing as an optional subtyping mode in N4JS is implemented in <code>StructuralTypingComputer</code>, activated depending on
+the value of property <code>typingStrategy</code> in <code>ParameterizedTypeRef</code> and its subclasses.</p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_type-index"><a class="anchor" href="#_type-index"></a><a class="link" href="#_type-index">7. Type Index</a></h2>
+<div class="sectionbody">
+<div class="sect2 language-n4js">
+<h3 id="sec:Type_Index_Design_Rationale"><a class="anchor" href="#sec:Type_Index_Design_Rationale"></a><a class="link" href="#sec:Type_Index_Design_Rationale">7.1. Design Rationale</a></h3>
+<div class="paragraph">
+<p>We use a separate types model to represent types, see <a href="#sec:Type_Model_and_Grammar">Type Model and Grammar</a>. Declared elements (e.g., classes)
+in N4JS are parsed and a new types model instance is derived from them. All type references (of the N4JS <a href="#AC">AST</a>)
+are then bound to these type instances and not to the N4JS declaration. However, there exists a relation between a type
+and its declaration. The type instances (which are EObjects) are added to the resource of the N4JS file as part of
+the public interface of the resource. This public interface is represented by a <code>TModule</code>. While the actual source code
+is the first element of a resource (index 0), the module is stored at index 1. It contains the derived type information,
+the information about exported variables and functions as well as information about the project and vendor. The Xtext
+serializer ignores the additional element. Besides, the complete type instances are stored in the user data section of
+the <code>IEObjectDescription</code> of the <code>TModule</code>. Since the user data only allows strings to be stored, the EObjects are serialized
+(within a virtual resource). When a reference is then bound to a type, the type can be directly recreated (deserialized)
+from the user data. The deserialized EObject is then added to the appropriate resource. It is not necessary to load the
+complete file just to refer to a type from that file.</p>
+</div>
+<div class="paragraph">
+<p>The design relies on two key features of Xtext:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Besides the parsed text (i.e., the AST), other elements can be stored in a resource, which are then ignored by
+the Xtext serializer, while still being properly contained in an EMF resource.</p>
+</li>
+<li>
+<p>The <code>DerivedStateAwareResource</code> allows some kind of post processing steps when reading a resource. This enables a custom
+class, here <code>N4JSDerivedStateComputer</code>, to create the types models (TClass, TRole and so on) from the parsed <code>N4ClassDeclaration</code>,
+<code>N4RoleDeclaration</code> and so on.</p>
+</li>
+</ol>
+</div>
+<div class="sect3">
+<h4 id="sec:Getting_the_Xtext_Index_Content_IResourceDescriptions"><a class="anchor" href="#sec:Getting_the_Xtext_Index_Content_IResourceDescriptions"></a><a class="link" href="#sec:Getting_the_Xtext_Index_Content_IResourceDescriptions">7.1.1. Getting the Xtext Index (<code>IResourceDescriptions</code>) Content</a></h4>
+<div class="paragraph">
+<p>An instance of the <code>IResourceDescriptions</code> can be acquired from the resource description provider. Just like all services
+in Xtext, this can be injected into the client code as well. The resource descriptions accepts a non-null resource set.
+The resource set argument is mandatory to provide the index with the proper state. We are differentiating between three
+different state. The first one is the persisted one, basically the builder state is a resource description as well, and
+it provides a content that is based on the persisted state of the files (in our case the modules and package.json file)
+on the file system. The second one is the live scoped index, this is modification and dirty state aware. Namely when using
+this resource descriptions then an object description will be searched in the resource set itself first, then in the dirty
+editor’s index, finally among the persisted ones. The third index is the named builder scoped one. This index should not be
+used by common client code, since it is designed and implemented for the Xtex builder itself.</p>
+</div>
+<div class="paragraph">
+<p>A resource set and hence the index can be acquired from the N4JS core, in such cases an optional N4JS project can be specified.
+The N4JS project argument is used to retrieve the underlying Eclipse resource project (if present) and get the resource set from
+the resource set provider. This is completely ignored when the application is running in headless mode and Eclipse resource
+projects are not available. It is also important to note that the resource set is always configured to load only the persisted
+states.</p>
+</div>
+<div class="paragraph">
+<p>When the Eclipse platform is running, the workspace is available and the all N4JS projects are backed by an Eclipse resource
+project. With the Eclipse resource project the resource sets can be initialized properly via the resource set initializer
+implementations. This mechanism is used to get the global objects (such as console) and the built-in types (such as string,
+number) into the resource set via the corresponding resource set adapters. In the headless case a special resource set
+implementation is used; <code>ResourceSetWithBuiltInScheme</code>. This implementation is responsible to initialize the globals and the
+built-in types into itself.</p>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:Design_Overview"><a class="anchor" href="#sec:Design_Overview"></a><a class="link" href="#sec:Design_Overview">7.2. Design Overview</a></h3>
+<div class="paragraph">
+<p><a href="#fig:cd_TypeModelWithXtextIndex">Type Model With Xtext Index</a> shows a simplified UML class diagram with the involved
+classes. In the figure, a class (defined as N4ClassExpression in the <a href="#AC">AST</a> and its type TClass) is used as a sample,
+declared type—roles or enums are handled similarly.</p>
+</div>
+<div class="paragraph">
+<p>In the Eclipse project build the <code>N4JSResourceDescriptionManager</code> (resp. by the logic of its super class) is called by the
+<code>N4JSGenerateImmediatelyBuilderState</code> to get the resource description for a resource. The resource description manager loads
+the resource to create / update the resource descriptions. Loading an Xtext resource means that it is reparsed again.
+All cross references are handled here only by the lazy linker so that the node model will contain an unresolved proxy
+for all cross references.</p>
+</div>
+<div class="paragraph">
+<p>After the resource is loaded there is a derived state installed to the resource. For this the <code>N4JSDerivedStateComputer</code> will
+be called. It will take the parse result (= EObject tree in first slot of the resource) and navigate through these objects
+to create type trees for each encountered exportable object that are stored in exported <code>TModule</code> of the resource.
+<a href="#fig:cd_CreateTypeFromAST">Create Type From AST</a>, a snippet of <a href="#fig:cd_TypeModelWithXtextIndex">Type Model with Xtext Index</a>,
+shows only the classes involved when creating the types from the resource.</p>
+</div>
+<div id="fig:cd_CreateTypeFromAST" class="imageblock center">
+<div class="content">
+<img src="chapters/07_typeindex/images/cd_CreateTypeFromAST.png" alt="cd CreateTypeFromAST">
+</div>
+<div class="title">Figure 11. Type From AST</div>
+</div>
+<div id="fig:cd_TypeModelWithXtextIndex" class="imageblock center">
+<div class="content">
+<img src="chapters/07_typeindex/images/cd_CreateTypeFromIndex.png" alt="cd CreateTypeFromIndex">
+</div>
+<div class="title">Figure 12. Create Type From Index</div>
+</div>
+<div id="fig:cd_SerializeToIndex" class="imageblock center">
+<div class="content">
+<img src="chapters/07_typeindex/images/cd_SerializeToIndex.png" alt="cd SerializeToIndex">
+</div>
+<div class="title">Figure 13. Serialize To Index</div>
+</div>
+<div class="paragraph language-javascript">
+<p>For these elements types have to be derived as they are exportable: <code>N4ClassDeclaration</code>, <code>N4RoleDeclaration</code>, <code>N4InterfaceDeclaration</code>,
+<code>N4EnumDeclaration</code>, <code>ExportedVariableDeclaration</code> and <code>FunctionDeclaration</code>.</p>
+</div>
+<div class="paragraph">
+<p>After loading and initializing the resources now all cross references in the resources are resolved. For this the
+<code>ErrorAwareLinkingService</code> is used. This class will in turn call the <code>N4JSScopeProvider</code> to first try to do scoping locally
+but eventually also delegate to the global scope provider to find linked elements outside the current resource. This
+will be done e.g. for every import statement inside the N4JS resource.</p>
+</div>
+<div class="paragraph">
+<p>For determine the global scope all visible containers for this resource are calculated. For this the project description
+(= loaded package.json file) is used to determine which folders of the current project should be included for looking for
+N4JS resources. Also all referenced projects and their resources are added to the visible containers. For these containers
+<code>N4JSGlobalScopeProvider</code> builds up a container scope. This container scope will be a <code>N4JSTypesScope</code> instance.</p>
+</div>
+<div class="paragraph">
+<p>For the actual linked element in the resource to be resolved, its fully qualified name is used. This name is calculated by
+using the <code>IQualifiedNameConverter</code>. We bound a custom class named <code>N4JSQualifiedNameConverter</code> who converts the <code>/</code> inside the
+qualified name to a dot, so e.g. <code>my/module/MyFileName</code> is converted to <code>my.module.MyFileName</code>. Btw. the initial qualified name
+was derived from the node model.</p>
+</div>
+<div class="paragraph">
+<p>With this qualified name <code>N4JSTypeScope.getSingleElement</code> is called. This method does the actual resolving of the cross reference.
+For this the URI of the cross reference is used to determine the linked resource.</p>
+</div>
+<div class="paragraph">
+<p>There are now three cases:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>If the resource which contains the linked EObject is already loaded the EObject description found for the URI is returned</p>
+</li>
+<li>
+<p>If the resource is not loaded but the first slot of the resource is empty the referenced type is tried to be rebuild from
+an existing resource description for the linked resource inside the Xtext index.</p>
+</li>
+<li>
+<p>If the resource is not loaded and the first slot is set, the linked EObject will be resolved with the fragment of the
+given URI.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>While calculating the resource description for a <code>N4JSResource</code>, the EObject descriptions of their exported objects have to be
+calculated as well. For this the <code>N4JSResourceDescriptionStrategy</code> is used. For computing the exported objects of a resource only
+the root <code>TModule</code> and its contained types and variables are taken in consideration.</p>
+</div>
+<div class="paragraph">
+<p>The EObjectDescriptions for a n4js resource include:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>An exported representation of the derived <code>TModule</code>. This carries these properties:</p>
+<div class="ulist">
+<ul>
+<li>
+<p>a qualified name (e.g. <code>my.module.MyFileName</code> when the resource is stored under <code>src/my/module/MyFileName.js</code> in the project and
+the project description has marked src has src folder). The calculation of the qualified name is delegated to the <code>N4JSNamingUtil</code>.</p>
+</li>
+<li>
+<p>the user data which is the serialized string of the exported <code>TModule</code> itself. It includes the types determined for this
+resource, so for every element found in this resource, that is contained in an <code>ExportStatement</code>, an EObject has been created
+before in <code>N4JSDerivedStateComputer</code>. In most cases this an EObject extending <code>Type</code> from the types model, e.g. <code>TClass</code> for
+<code>N4ClassDeclaration</code>. There is an exception for <code>ExportedVariableDeclaration</code> where <code>TVariable</code> is used as representative (and this
+EObject is not contained in the types model only in the N4JS model). For usability reasons (quicker quick fix etc.), also
+top level types not exported yet are stored in the <code>TModel</code>.</p>
+</li>
+<li>
+<p>the information on project and vendor id are part of the module descriptor.</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>Descriptions for all top level types that are defined in the resource. These descriptions do not have any special properties,
+so they just have a name.</p>
+</li>
+<li>
+<p>All exported variables are also described in the resource description. They don’t carry any special information either.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>The EObjectDescription for an EObject contained in an <code>ExportStatement</code>:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>the qualified name of the module export (e.g. for a <code>N4ClassDeclaration</code> the qualified name <code>my.module.MyFileName.MyClassName</code> would
+be produced, when the resource is stored under <code>src/my/module/MyFileName.js</code> in the project, the project description has marked
+src has src folder and the N4 class uses the name MyClassName]). The calculation of the qualified name is delegated to the
+<code>N4JSNamingUtil</code>.</p>
+</li>
+<li>
+<p>the EObject represented by the EObject description, here this is not the actual EObject from N4JS but the type EObject from
+the TypeSystem, that has been inferenced by using <code>N4JSTypeInferencer</code></p>
+</li>
+<li>
+<p>the user data is only an empty map for this EObjectDescription</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>With this the resource description for a resource should be fully created / updated. <a href="#fig:cd_SerializeToIndex">Serialize to Index</a>
+shows the classes involved creating the resource and EObjectDescriptions, along with the serialized type information.</p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="sec:N4JS_Resource_Load_States"><a class="anchor" href="#sec:N4JS_Resource_Load_States"></a><a class="link" href="#sec:N4JS_Resource_Load_States">7.3. N4JS Resource Load States</a></h3>
+<div class="paragraph">
+<p>Below state diagram depicts the state transitions when loading and resolving an N4JS resource.</p>
+</div>
+<div class="imageblock center">
+<div class="content">
+<img src="chapters/07_typeindex/images/resource_set_load_states.png" alt="resource set load states">
+</div>
+<div class="title">Figure 14. N4JS Resource resolution states</div>
+</div>
+<div class="paragraph">
+<p>Additionally, the following table relates the values of the resource&#8217;s flags to the states.</p>
+</div>
+<table class="tableblock frame-all grid-all spread">
+<colgroup>
+<col style="width: 11.1111%;">
+<col style="width: 11.1111%;">
+<col style="width: 11.1111%;">
+<col style="width: 11.1111%;">
+<col style="width: 11.1111%;">
+<col style="width: 11.1111%;">
+<col style="width: 11.1111%;">
+<col style="width: 11.1111%;">
+<col style="width: 11.1112%;">
+</colgroup>
+<thead>
+<tr>
+<th class="tableblock halign-left valign-top">State</th>
+<th class="tableblock halign-left valign-top">Parse Result</th>
+<th class="tableblock halign-left valign-top">AST</th>
+<th class="tableblock halign-left valign-top">TModule</th>
+<th class="tableblock halign-left valign-top">ASTMetaInfoCache</th>
+<th class="tableblock halign-left valign-top">loaded</th>
+<th class="tableblock halign-left valign-top">fullyInitialized</th>
+<th class="tableblock halign-left valign-top">fullyProcessed</th>
+<th class="tableblock halign-left valign-top">reconciled</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Created</p></th>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>null</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>null</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>null</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>null</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
+</tr>
+<tr>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Created'</p></th>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>null</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>null</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>null</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>null</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
+</tr>
+<tr>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Loaded</p></th>
+<td class="tableblock halign-left valign-top"><p class="tableblock">available</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">with lazy linking proxies</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>null</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>null</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
+</tr>
+<tr>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Pre-linked</p></th>
+<td class="tableblock halign-left valign-top"><p class="tableblock">available</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">with lazy linking proxies</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">with stubs</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>null</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
+</tr>
+<tr>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Fully Initialized</p></th>
+<td class="tableblock halign-left valign-top"><p class="tableblock">available</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">with lazy linking proxies</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">with DeferredTypeRefs</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>null</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
+</tr>
+<tr>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Fully Processed</p></th>
+<td class="tableblock halign-left valign-top"><p class="tableblock">available</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">available</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">available</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">available</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
+</tr>
+<tr>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Loaded from Description</p></th>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>null</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">proxy</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">available</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>null</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">indeterminate</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
+</tr>
+<tr>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Loaded from Description'</p></th>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>null</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">proxy</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">with DeferredTypeRefs</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>null</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">indeterminate</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
+</tr>
+<tr>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Fully Initialized ®</p></th>
+<td class="tableblock halign-left valign-top"><p class="tableblock">available</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">with lazy linking proxies</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">available</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>null</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">indeterminate</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
+</tr>
+<tr>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Fully Processed ®</p></th>
+<td class="tableblock halign-left valign-top"><p class="tableblock">available</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">available</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">available</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">available</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">indeterminate</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
+</tr>
+</tbody>
+</table>
+<div class="paragraph">
+<p>Remarks:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>oddities are shown in red ink, in the above figure.</p>
+</li>
+<li>
+<p>in the above figure:</p>
+<div class="ulist">
+<ul>
+<li>
+<p>"AST (proxy)" means the AST consists of only a single node of type <code>Script</code> and that is a proxy,</p>
+</li>
+<li>
+<p>"AST (lazy)" means the AST is completely created, but cross-references are represented by unresolved
+Xtext lazy-linking proxies,</p>
+</li>
+<li>
+<p>"TModule (stubs)" means the TModule has been created with incomplete information, e.g. return types of
+all TMethods/TFunctions will be <code>null</code> (only used internally by the incremental builder),</p>
+</li>
+<li>
+<p>"TModule (some deferred)" means the TModule has been created, does not contain stub, but some
+`TypeRef`s are `DeferredTypeRef`s that are supposed to be replaced by proper `TypeRef`s during post-processing.</p>
+</li>
+<li>
+<p>"AST" and "TModule" means the AST/TModule is available without any qualifications.</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>state <strong>Created'</strong>: only required because Xtext does not clear flag <code>fullyInitialized</code> upon unload; that is done lazily
+when <code>#load()</code> is invoked at a later time.. Thus, we do not reach state <strong>Created</strong> when unloading from state
+<strong>Fully Initialized</strong> but instead get to state <strong>Created'</strong>. To reach state <strong>Created</strong> from <strong>Fully Initialized</strong> we have to
+explicitly invoke <code>#discardDerivedState()</code> before(!) unloading.</p>
+</li>
+<li>
+<p>state <strong>Loaded from Description'</strong>: transition <code>#unloadAST()</code> from state <strong>Fully Initialized</strong> leaks a non-post-processed
+TModule into state <strong>Loaded from Description</strong>, which is inconsistent with actually loading a TModule from the index,
+because those are always fully processed. Hence, the addition of state <strong>Loaded from Description'</strong>.</p>
+</li>
+<li>
+<p>states <strong>Fully Initialized ®</strong> and <strong>Fully Processed ®</strong>: these states are reached via reconciliation of a pre-existing
+TModule with a newly loaded AST. These states differ in an unspecified way from their corresponding non-reconciled
+states. For example, in state <strong>Fully Initialized ®</strong> the TModule does not contain any DeferredTypeRefs while, at the
+same time, the TModule isn&#8217;t fully processed, because proxy resolution, typing, etc. have not taken place, yet.</p>
+</li>
+<li>
+<p>TODO old text (clarify this; I could not reproduce this behavior): when <code>unloadAST</code> is called, <code>fullyInitialized</code> remains
+unchanged. This is why the value of <code>fullyInitialized</code> should be indeterminate in row <strong>Loaded from Description</strong>; it
+depends on the previous value if the state <strong>Loaded from Description</strong> was reached by calling <code>unloadAST</code>.</p>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:Type_Builder"><a class="anchor" href="#sec:Type_Builder"></a><a class="link" href="#sec:Type_Builder">7.4. Types Builder</a></h3>
+<div class="paragraph">
+<p>When a resource is loaded, it is parsed, linked, post-processed, validated and eventually compiled. For linking and validation
+type information is needed, and as described above the type information is created automatically when loading a resource using
+the types builder. <a href="#fig:ad_resourceLoading">Resource Loading</a> shows an activity model with the different actions performed when
+a resource is loaded.</p>
+</div>
+<div id="fig:ad_resourceLoading" class="imageblock center">
+<div class="content">
+<img src="chapters/07_typeindex/images/ad_resourceLoading.png" alt="ad resourceLoading">
+</div>
+<div class="title">Figure 15. Activity Diagram, Resource Loading</div>
+</div>
+<div class="paragraph">
+<p>The blue colored steps are standard Xtext workflow. Handling the TModule and storing that in the index are N4 specific (red background).</p>
+</div>
+<div class="sect3">
+<h4 id="sec:Type_Inference_not_allowed_in_Type_Builder"><a class="anchor" href="#sec:Type_Inference_not_allowed_in_Type_Builder"></a><a class="link" href="#sec:Type_Inference_not_allowed_in_Type_Builder">7.4.1. Type Inference not allowed in Types Builder</a></h4>
+<div class="paragraph">
+<p>A crucial point in the workflow described above is the combination of types model building and type inference. In some cases,
+the type of a given element is not directly stated in the AST but has to be inferred from an expression and other types. For
+example, when a variable declaration does not declare the variable’s type explicitly but provides an initializer expression,
+the actual type of the variable is inferred to be the type of the expression.</p>
+</div>
+<div class="paragraph">
+<p>However, the types builder cannot be allowed to use type inference, mainly for two reasons:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>type inference through Xsemantics could lead to resolution of cross-references (i.e. EMF proxies generated by the lazy
+linker) and because the types builder is triggered when getContents() is called on the containing <code>N4JSResource</code> this would
+break a basic contract of EMF resources.</p>
+</li>
+<li>
+<p>type inference could cause other resources to be loaded which would lead to problems (infinite loops or strange results)
+in case of circular dependencies. This is illustrated in <a href="#fig:sd_typesBuilder_problem">Types Builder Problem</a> and
+<a href="#fig:sd_typesBuilder_proxies">Types Builder Proxies</a>.</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>Therefore, whenever the type of a particular element has to be inferred, the types builder will use a special type reference
+called <code>DeferredTypeRef</code> <sup class="footnote">[<a id="_footnoteref_3" class="footnote" href="#_footnote_3" title="View footnote.">3</a>]</sup>,
+in order to defer the actual type inference to a later stage, i.e. the post-processing stage.</p>
+</div>
+<div id="fig:sd_typesBuilder_problem" class="imageblock center">
+<div class="content">
+<img src="chapters/07_typeindex/images/sd_typesBuilder_problem.png" alt="sd typesBuilder problem">
+</div>
+<div class="title">Figure 16. Sequence Diagram, Types Builder Problem</div>
+</div>
+<div id="fig:sd_typesBuilder_proxies" class="imageblock center">
+<div class="content">
+<img src="chapters/07_typeindex/images/sd_typesBuilder_proxies.png" alt="sd typesBuilder proxies">
+</div>
+<div class="title">Figure 17. Sequence Diagram, Types Builder with Proxies</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:ComputedTypeReferences"><a class="anchor" href="#sec:ComputedTypeReferences"></a><a class="link" href="#sec:ComputedTypeReferences">7.4.2. Deferred Type References</a></h4>
+<div class="paragraph">
+<p>Whenever type inference would be required to obtain the actual type of an element, the types builder will insert a stub to defer
+actual type inference (see previous section). A dedicated subclass of <code>TypeRef</code>, called <code>DeferredTypeRef</code>, is used that contains neither
+the actual type information nor any information necessary to perform the type inference at a later point in time. Later, this
+<code>DeferredTypeRef</code> will be replaced during post-processing, see <code>TypeDeferredProcessor</code>.</p>
+</div>
+<div class="paragraph">
+<p>All <code>DeferredTypeRef</code>s will be replaced by the actual types during post-processing. One important reason for resolving
+all <code>DeferredTypeRef</code>s as early as possible is that they are not suited for serialization and therefore have to be removed
+from the types model before populating the Xtext index, which includes serializing the TModule into the user data of the
+root element. This is always assured by the logic that manages the triggering of the post-processing phase.</p>
+</div>
+<div class="paragraph">
+<p>To manually trigger resolution of all <code>DeferredTypeRef</code>s in a given types model, simply call method <code>performPostProcessing(CancelIndicator)</code>
+of the containing <code>N4JSResource</code> (should never be required by client code such as validations).</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Use_cases_of_ComputedTypeRef"><a class="anchor" href="#sec:Use_cases_of_ComputedTypeRef"></a><a class="link" href="#sec:Use_cases_of_ComputedTypeRef">7.4.3. Use cases of DeferredTypeRef</a></h4>
+<div class="paragraph">
+<p>Currently, <code>DeferredTypeRef</code>s are created by the types builder only in these cases:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>actual type of an exported TVariable if no declared type but an initialization expression are given.</p>
+</li>
+<li>
+<p>actual type of a TField if no declared type but an initialization expression are given.</p>
+</li>
+<li>
+<p>actual type of properties of ObjectLiterals if not declared explicitly.</p>
+</li>
+<li>
+<p>actual type of formal parameters and return value of function expressions if not declared explicitly.</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>Note that this overview might easily get out-dated; see references to class <code>DeferredTypeRef</code> in the code.</p>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:Incremental_Builder_Overview"><a class="anchor" href="#sec:Incremental_Builder_Overview"></a><a class="link" href="#sec:Incremental_Builder_Overview">7.5. Incremental Builder (Overview)</a></h3>
+<div class="paragraph">
+<p>This section provides a brief overview of how the incremental builder works.</p>
+</div>
+<div class="paragraph">
+<p>General remarks:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>The N4JS incremental builder is a combination of Eclipse builder infrastructure, Xtext-specific builder functionality and
+several adjustments for N4JS and N4MF.</p>
+</li>
+<li>
+<p>The <code>IBuilderState</code> implementation is identical to the persisted Xtext index. No matter how many Xtext languages are supported
+by the application, only a single <code>IBuilderState</code> instance is available in the application. Since we have one single <code>IBuilderState</code>,
+we have one single persisted Xtext index throughout the application.</p>
+</li>
+<li>
+<p>For simplicity, the below description assumes we have only N4JS projects in the workspace and no other Xtext languages are
+installed.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Major components:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>XtextBuilder</code> (inherits from Eclipse’s <code>IncrementalProjectBuilder</code>):</p>
+<div class="ulist">
+<ul>
+<li>
+<p>the actual incremental builder</p>
+</li>
+<li>
+<p>note: Eclipse will create one instance of <code>XtextBuilder</code> per project at startup.</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p><code>IBuilderState</code> (Xtext specific; no Eclipse pendant):<br>
+identical to the <code>Xtext index</code>, i.e. the globally shared, persisted instance of<br>
+<code>IResourceDescriptions</code>.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Main workflow:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>for each project  that contains at least one resource that requires rebuilding, Eclipse will call the
+project’s <code>XtextBuilder</code>.</p>
+</li>
+<li>
+<p>each <code>XtextBuilder</code> will perform some preparations and will then delegate to <code>IBuilderState</code> which will iterate over
+all resources in the builder’s project that require rebuilding.</p>
+</li>
+</ol>
+</div>
+<div class="sect3">
+<h4 id="sec:Incremental_Builder_Overview__XtextBuilder"><a class="anchor" href="#sec:Incremental_Builder_Overview__XtextBuilder"></a><a class="link" href="#sec:Incremental_Builder_Overview__XtextBuilder">7.5.1. XtextBuilder</a></h4>
+<div class="paragraph">
+<p>Whenever a change in the workspace happens &#8230;&#8203;</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p><a id="itm:start"></a> Eclipse will collect all projects that contain changed resources and compute a project-level build
+order (using the <code>build order</code> of the workspace, see <code>Workspace#getBuildOrder()</code>, which is based on project dependencies)</p>
+</li>
+<li>
+<p>for the first <sup class="footnote">[<a id="_footnoteref_4" class="footnote" href="#_footnote_4" title="View footnote.">4</a>]</sup> project with changed resources, Eclipse will invoke
+   method <code>IncrementalProjectBuilder#build(int,Map,IProgressMonitor)</code> of the project’s <code>XtextBuilder</code><br>
+(NOTE: from this point on, we are in the context of a <code>current project</code>)</p>
+</li>
+<li>
+<p>in <code>XtextBuilder#build(int,Map,IProgressMonitor)</code>:<br>
+the builder creates an empty instance of <code>ToBeBuilt</code> (Xtext specific)</p>
+</li>
+<li>
+<p>in <code>XtextBuilder#incrementalBuild(IResourceDelta,IProgressMonitor)</code>:</p>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p>The builder will iterate over all files in the project and for each will notify a <code>ToBeBuiltComputer</code> about the
+change (added, updated, or deleted) which can then decide how to update the <code>ToBeBuilt</code> instance,</p>
+</li>
+<li>
+<p>then forwards to <code>#doBuild()</code> .</p>
+<div class="paragraph">
+<p>Note: if user changes 1..* files in a single project  but later more files in other, dependant projects
+ need to be built, the above step will happen for all projects, but will have an effect only for the first project  that contains the actual file changes (i.e. in the standard case of saving a single file <code>ToBeBuilt</code> will always be non-empty for the <code>first</code> project, and always empty for the other, dependant projects; if a <code>Save All</code> is done, <code>ToBeBuilt</code> could be non-empty for later projects as well).</p>
+</div>
+</li>
+</ol>
+</div>
+</li>
+<li>
+<p>in <code>XtextBuilder#doBuild(ToBeBuilt,IProgressMonitor,BuildType)</code>:</p>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p>first check if <code>ToBeBuilt</code> is empty AND global build queue does not contain URIs for current project &#8594; then abort (nothing to do here)</p>
+</li>
+<li>
+<p>creates instance of BuildData with:</p>
+<div class="olist lowerroman">
+<ol class="lowerroman" type="i">
+<li>
+<p>name of current project (as string)</p>
+</li>
+<li>
+<p>newly created, fresh <code>ResourceSet</code></p>
+</li>
+<li>
+<p>the <code>ToBeBuilt</code> (containing URIs of actually changed resources within current project, possibly filtered by <code>ToBeBuiltComputer</code>)</p>
+</li>
+<li>
+<p>the <code>QueuedBuildData</code> (an injected singleton)</p>
+</li>
+<li>
+<p>mode flag <code>indexingOnly</code> (only true during crash recovery)</p>
+</li>
+</ol>
+</div>
+</li>
+<li>
+<p>invoke <code>IBuilderState</code> passing the <code>BuildData</code><br>
+&#8594; updates itself (it is the global Xtext index) to reflect all changes in <code>current project</code>; validates and updates markers; runs transpiler (see below for details)</p>
+</li>
+<li>
+<p>invoke all registered <code>IXtextBuilderParticipants</code> (Xtext specific) for the <code>current project</code></p>
+<div class="ulist">
+<ul>
+<li>
+<p>this is where normally we would do validation and run the transpiler; however, for performance reasons (do not load resource again) we already do this in the <code>IBuilderState</code> (this is the idea of the <code>GenerateImmediatelyBuilderState</code>)</p>
+</li>
+<li>
+<p>in our implementation, almost nothing is done here, except trivial stuff such as deleting files during clean build</p>
+<div class="paragraph">
+<p>At this point: returning from all methods.</p>
+</div>
+</li>
+</ul>
+</div>
+</li>
+</ol>
+</div>
+</li>
+<li>
+<p>back in <code>XtextBuilder#build(int,Map,IProgressMonitor)</code>:<br>
+&#8594; return with an array of IProjects; in our case: we return all other N4JSProjects referenced in the package.json of the project</p>
+<div class="ulist">
+<ul>
+<li>
+<p>important: these are <strong>not</strong> the projects that will be processed next: we need to continue with projects that depend on the current project, not with projects the current project depends on!</p>
+</li>
+<li>
+<p>Eclipse calls the returned projects <code>interestingProjects</code> and uses that as a hint for further processing; details not discussed here.</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>continue with step <a href="#itm:start">one</a>:<br>
+Eclipse will invoke <code>XtextBuilder#build(int,Map,IProgressMonitor)</code> again for all other projects that have a dependency to the <code>current project</code> of the previous iteration, plus all remaining projects with changed resources.</p>
+</li>
+</ol>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Incremental_Builder_Overview__IBuilderState"><a class="anchor" href="#sec:Incremental_Builder_Overview__IBuilderState"></a><a class="link" href="#sec:Incremental_Builder_Overview__IBuilderState">7.5.2. IBuilderState</a></h4>
+<div class="paragraph">
+<p>Invoked: once for each project containing a changed resource and dependant projects.<br>
+Input: one instance of <code>BuildData</code>, as created by <code>XtextBuilder</code>, containing:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>name of current project (as string)</p>
+</li>
+<li>
+<p>newly created, fresh <code>ResourceSet</code></p>
+</li>
+<li>
+<p>the <code>ToBeBuilt</code></p>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p>set of to-be-deleted URIs</p>
+</li>
+<li>
+<p>set of to-be-updated URIs</p>
+</li>
+</ol>
+</div>
+</li>
+<li>
+<p>the <code>QueuedBuildData</code>, an injected singleton maintaining the following values <sup class="footnote">[<a id="_footnoteref_5" class="footnote" href="#_footnote_5" title="View footnote.">5</a>]</sup>:</p>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p>a queue of URIs per project (below called the <code>global queue</code>)<br>
+(actually stored in <code>QueuedBuildData#projectNameToChangedResource</code>)</p>
+</li>
+<li>
+<p>a collection of <code>all remaining URIs</code><br>
+(derived value: queued URIs of all projects + queues URIs not associated to a project (does not happen in N4JS))</p>
+</li>
+<li>
+<p>a collection of <code>pending deltas</code> (always empty in N4JS; probably only used for interaction with Java resources)</p>
+</li>
+</ol>
+</div>
+</li>
+<li>
+<p>mode flag <code>indexingOnly</code> (only true during crash recovery)</p>
+</li>
+</ol>
+</div>
+<div class="sect4">
+<h5 id="copy-and-update-xtext-index"><a class="anchor" href="#copy-and-update-xtext-index"></a><a class="link" href="#copy-and-update-xtext-index">7.5.2.1. Copy and Update Xtext Index</a></h5>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>in <code>IBuilderState#update(BuildData,IProgressMonitor)</code>:<br>
+creates a copy of its <code>ResourceDescriptionsData</code> called <code>newData</code> <sup class="footnote">[<a id="_footnoteref_6" class="footnote" href="#_footnote_6" title="View footnote.">6</a>]</sup></p>
+</li>
+<li>
+<p>in <code>AbstractBuilderState#doUpdate(&#8230;&#8203;)</code>:<br>
+updates <code>newData</code> by writing new resource descriptions into it.</p>
+<div class="ulist">
+<ul>
+<li>
+<p>Creates a new load operation (<code>LoadOperation</code>) instance from the <code>BuildData#getToBeUpdated()</code> and loads all entries. While iterating and loading the resource descriptions, it updates <code>newData</code> by registering new resource descriptions that are being created on the fly from the most recent version of the corresponding resources.</p>
+</li>
+<li>
+<p>Adds these resources to the current project’s build queue. (<code>BuildData#queueURI(URI uri)</code>)</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>for all to-be-deleted URIs given in <code>ToBeBuilt</code> in the <code>BuildData</code>, removes the corresponding <code>IResourceDescription</code> from <code>newData</code></p>
+<div class="ulist">
+<ul>
+<li>
+<p><code>ToBeBuilt#getAndRemoveToBeDeleted()</code> returns all URIs that have been marked for deletion but not marked for update and will clear the set of to-be-deleted URIs in <code>ToBeBuilt</code>.</p>
+</li>
+</ul>
+</div>
+</li>
+</ol>
+</div>
+</div>
+<div class="sect4">
+<h5 id="build-state-setup-phase"><a class="anchor" href="#build-state-setup-phase"></a><a class="link" href="#build-state-setup-phase">7.5.2.2. Build State Setup Phase</a></h5>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Calculates a set <code>allRemainingURIs</code> <sup class="footnote">[<a id="_footnoteref_7" class="footnote" href="#_footnote_7" title="View footnote.">7</a>]</sup> as follows:</p>
+<div class="ulist">
+<ul>
+<li>
+<p>Initially contains all resource URIs from <code>newData</code>.</p>
+</li>
+<li>
+<p>All URIs will be removed from it that are marked for update (<code>BuildData#getToBeUpdated()</code>).</p>
+</li>
+<li>
+<p>Finally, all URIs will be removed from it that are already queued for build/rebuild. (<code>BuildData#getAllRemainingURIs()</code>).</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>Creates an empty set <code>allDeltas</code> of resource description deltas<br>
+(c.f. <code>IResourceDescription.Delta</code>). <sup class="footnote">[<a id="_footnoteref_8" class="footnote" href="#_footnote_8" title="View footnote.">8</a>]</sup></p>
+</li>
+<li>
+<p><a id="itm:processDeleted"></a> <strong>Process Deleted:</strong> for all to-be-deleted URIs, creates a delta where the old state is the current state of the resource and the new state is <code>null</code> and adds it to <code>allDeltas</code>.</p>
+</li>
+<li>
+<p>Adds all <code>pending deltas</code> from <code>QueuedBuildData</code> to <code>allDeltas</code> (does not apply to N4JS).</p>
+</li>
+<li>
+<p><strong><a id="itm:enqueueAffectedResources"></a>Enqueue affected resources, part 1:</strong> adds to the <code>global queue</code> the URIs of all resources affected by the changes in <code>allDeltas</code>.</p>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title=""></i>
+</td>
+<td class="content">
+For N4JS, <code>allDeltas</code> always seems to be empty at this point, so this does nothing at all.
+</td>
+</tr>
+</table>
+</div>
+</li>
+<li>
+<p>Creates an empty set <code>changedDeltas</code> for storing deltas that were modified by the build phase and represent an actual change. Unlike <code>allDeltas</code>, this set contains only those URIs that were processed by the builder - the underlying user data information contains the differences between the old and the new state.</p>
+</li>
+<li>
+<p>Creates a new <code>current queue</code> and adds all URIs from the <code>global queue</code> that belong to the <code>current project</code>.</p>
+</li>
+</ol>
+</div>
+</div>
+<div class="sect4">
+<h5 id="process-queued-uris"><a class="anchor" href="#process-queued-uris"></a><a class="link" href="#process-queued-uris">7.5.2.3. Process Queued URIs</a></h5>
+<div class="paragraph">
+<p>Processes all elements from the queue until it contains no more elements.</p>
+</div>
+<div id="itm:loadRes" class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Load the resource for the first/next URI on the current queue</p>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title=""></i>
+</td>
+<td class="content">
+In case of a move, the loaded resource could have a different URI!
+</td>
+</tr>
+</table>
+</div>
+</li>
+<li>
+<p>Once the resource has been loaded, it removes its URI from the current queue to ensure it will not be processed again.</p>
+</li>
+<li>
+<p>If the loaded resource is already marked for deletion, stop processing this resource and continue with next URI from the current queue (go to step <a href="#itm:loadRes">Load Res</a>)
+<sup class="footnote">[<a id="_footnoteref_9" class="footnote" href="#_footnote_9" title="View footnote.">9</a>]</sup></p>
+</li>
+<li>
+<p>Resolves all lazy cross references in the loaded resource. This will trigger post-processing, including all type inference (c.f. <code>ASTProcessor#processAST(&#8230;&#8203;)</code>).</p>
+</li>
+<li>
+<p>Creates a delta for the loaded resource, including</p>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p>a resource description based on the new state of the resource, wrapped into the <code>EObject</code>-based resource description (as with the Xtext index persistence in <code>EMFBasedPersister#saveToResource()</code>).</p>
+</li>
+<li>
+<p>a resource description for the same resource with the state before the build process.</p>
+</li>
+</ol>
+</div>
+</li>
+<li>
+<p>Adds this new delta to <code>allDeltas</code> and, if the delta represents a change (according to <code>DefaultResourceDescriptionDelta#internalHasChanges()</code>), also adds it to <code>changedDeltas</code>.</p>
+</li>
+<li>
+<p>Adds the resource description representing the new state, stored in the delta, to <code>newData</code>, i.e. the copied <code>ResourceDescriptionsData</code>, replacing the old resource description of the loaded resource <sup class="footnote">[<a id="_footnoteref_10" class="footnote" href="#_footnote_10" title="View footnote.">10</a>]</sup>.</p>
+</li>
+<li>
+<p>If the current queue is non-empty, go to step <a href="#itm:loadRes">Load Res</a> and continue with the next URI in the current queue.</p>
+</li>
+</ol>
+</div>
+</div>
+<div class="sect4">
+<h5 id="queueing-affected-resources"><a class="anchor" href="#queueing-affected-resources"></a><a class="link" href="#queueing-affected-resources">7.5.2.4. Queueing Affected Resources</a></h5>
+<div class="paragraph">
+<p>When the current queue contains no more URIs (all have been processed) &#8230;&#8203;</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p><a id="itm:updateGlobalQueue"></a> <strong>Enqueue affected resources, part 2:</strong> add to the global queue URIs for all resources affected by the changes in <code>changedDeltas</code> <sup class="footnote">[<a id="_footnoteref_11" class="footnote" href="#_footnote_11" title="View footnote.">11</a>]</sup>.</p>
+</li>
+<li>
+<p>Returns from <code>#doUpdate()</code>, returning <code>allDeltas</code> (only used for event notification).</p>
+</li>
+<li>
+<p>back in <code>IBuilderState#update(BuildData,IProgressMonitor)</code>:<br>
+makes the <code>newData</code> the publicly visible, persistent state of the IBuilderState (i.e. the <code>official</code> Xtext index all other code will see).</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>We now provide some more details on how the global queue is being updated, i.e. steps <a href="#itm:enqueueAffectedResources">Enqueue Affected Resources</a> and <a href="#itm:updateGlobalQueue">Update Global Queue</a>.
+Due to the language specific customizations for N4JS, this second resource-enqueuing phase is the trickiest part of the incremental building process and has the largest impact on how other resources will be processed and enqueued at forthcoming builder state phases.</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>If <code>allDeltas</code> is empty, nothing to do.</p>
+</li>
+<li>
+<p>If <code>allDeltas</code> contains at least one element, we have to check other affected resources by going through the set of all resource URIs (<code>allRemainingURIs</code>) calculated in in the beginning of the build process.</p>
+</li>
+<li>
+<p>Assume we have at least one element in the <code>allDeltas</code> set, the latter case is true and we must check all elements whether they are affected or not. We simply iterate through the <code>allRemainingURIs</code> set and retrieve the old state of the resource description using the resource URI.</p>
+</li>
+<li>
+<p>Once the resource description with the old state is retrieved, we check if it is affected through the corresponding resource description manager. Since we currently support two languages, we have two different ways for checking whether a resource has changed or not. One for package.json files and the other for the N4JS language related resources.</p>
+</li>
+<li>
+<p>The package.json method is the following: get all project IDs referenced from the <code>candidate</code> package.json and compare it with the container-project name of the package.json files from the <code>deltas</code>. The referenced IDs are the followings:</p>
+<div class="ulist">
+<ul>
+<li>
+<p>tested project IDs,</p>
+</li>
+<li>
+<p>implemented project IDs,</p>
+</li>
+<li>
+<p>dependency project IDs,</p>
+</li>
+<li>
+<p>provided runtime library IDs,</p>
+</li>
+<li>
+<p>required runtime library IDs and</p>
+</li>
+<li>
+<p>extended runtime environment ID.</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>The N4JS method is the following:</p>
+<div class="ulist">
+<ul>
+<li>
+<p>We consider only those changed deltas which represent an actual change (<code>IResourceDescription.Delta#haveEObjectDescriptionsChanged()</code>) and have a valid file extension (<code>.n4js</code>, <code>.n4jsd</code> or <code>.js</code>).</p>
+</li>
+<li>
+<p>For each <code>candidate</code>, we calculate the imported FQNs. The imported FQNs includes indirectly imported names besides the directly imported ones. Indirectly imported FQNs are, for instance, the FQNs of all transitively extended super class names of a direct reference.</p>
+</li>
+<li>
+<p>We state that a <code>candidate</code> is affected if there is a dependency (for example name imported by a <code>candidate</code>) to any name exported by the description from a delta. That is, it computes if a candidate (with given <code>importedNames</code>) is affected by a change represented by the description from the delta.</p>
+</li>
+<li>
+<p>If a <code>candidate</code> is affected we have to do an additional dependency check due to the lack of distinct unique FQNs. If a project containing the delta equals with the project contained by the candidate, or if the project containing the candidate has a direct dependency to the project containing the delta, we mark a candidate as affected.</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>If a candidate was marked as affected, it will be removed from the <code>allRemainingURIs</code> and will be added to the build queue.</p>
+</li>
+<li>
+<p>If a candidate has been removed from the <code>allRemainingURIs</code> and queued for the build, we assume its <code>TModule</code> information stored in the user data is obsolete. To invalidate the obsolete information, we wrap the delta in the custom resource description delta so whenever the <code>TModule</code> information is asked for, it will be missing. We then register this wrapped delta into the copied Xtext index, end the builder state for the actual project then invoke the Xtext builder with the next dependent project.</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Incremental_Builder_Overview__Example"><a class="anchor" href="#sec:Incremental_Builder_Overview__Example"></a><a class="link" href="#sec:Incremental_Builder_Overview__Example">7.5.3. Example</a></h4>
+<div class="paragraph">
+<p>To conclude this section, we briefly describe the state of the above five phases through a simple example. Assume a
+workspace with four N4JS projects: <em>P1</em>, <em>P2</em>, <em>P3</em> and <em>PX</em>. Each project has one single module with one single
+publicly visible class. Also let’s assume project <em>P2</em> depends on <em>P1</em> and <em>P3</em> depends on <em>P2</em>. Project <em>PX</em> have
+no dependencies to other projects. Project <em>P1</em> has a module <em>A.n4js</em> with a class <code>A</code>, project <em>P2</em> has one single
+module <em>B.n4js</em>. This module has a public exported class <code>B</code> which extends class <code>A</code>. Furthermore, project <em>P3</em> has
+one single module: <em>C.n4js</em>. This module contains one exported public class <code>C</code> which extends <code>B</code>. Finally, project
+<em>PX</em> has a module <em>X.n4js</em> containing a class <code>X</code> that has no dependencies to any other classes. The figure below
+picture depicts the dependencies between the projects, the modules and the classes as described above.</p>
+</div>
+<div class="imageblock center">
+<div class="content">
+<img src="chapters/07_typeindex/images/builderStateExample.png" alt="builderStateExample">
+</div>
+<div class="title">Figure 18. Builder State Example</div>
+</div>
+<div class="paragraph">
+<p>For the sake of simplification, the table below describes a symbol table for all resources:</p>
+</div>
+<table class="tableblock frame-all grid-all spread">
+<caption class="title">Table 3. Resource Symbol Table</caption>
+<colgroup>
+<col style="width: 50%;">
+<col style="width: 50%;">
+</colgroup>
+<tbody>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">P1/src/A.n4js</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">A</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">P2/src/B.n4js</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">B</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">P3/src/C.n4js</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">C</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">PX/src/X.n4js</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">X</p></td>
+</tr>
+</tbody>
+</table>
+<div class="paragraph">
+<p>Let assume auto-build is enabled and the workspace contains no errors and/or warnings. We make one simple modification
+and expect one single validation error in class <code>C</code> after the incremental builder finished its processing; we delete the
+method <code>foo()</code> from class <code>A</code>.</p>
+</div>
+<div class="paragraph">
+<p>After deleting the method in the editor and saving the editor content, a workspace modification operation will run and
+that will trigger an auto-build job. The auto-build job will try to build the container project <em>P1</em> of module <em>A</em>. Since
+the project is configured with the Xtext builder command, a builder state update will be performed through the Xtext builder.
+Initially, due to an Eclipse resource change event (we literally modify the resource from the editor and save it), the
+<code>ToBeBuilt</code> instance wrapped into the <code>BuildData</code> will contain the URI of the module <em>A</em> marked for an update. When updating
+the copied index content, module <em>A</em> will be queued for a build. While processing the queued elements for project <em>P1</em>,
+module <em>A</em> will be processed and will be added to the <code>allDeltas</code> set. Besides that, it will be added to the <code>changedDeltas</code>
+set as well. That is correct, because its <code>TModule</code> information has been changed after deleting the public <code>foo()</code> method.
+When queuing affected resources, iterating through the set of <code>allRemainingURIs</code>, we recognize that module <em>B</em> is affected.
+That is indeed true; module <em>B</em> imports the qualified name of class <code>A</code> from module <em>A</em> and project <em>P2</em> has a direct
+dependency to <em>P1</em>. In this builder state phase, when building project <em>P1</em>, module <em>C</em> is not considered as affected.
+Although class <code>C</code> from module <em>C</em> also imports the qualified name of class <code>A</code> from module <em>A</em>, project <em>P3</em> does not
+have a direct dependency to project <em>P1</em>. When module <em>B</em> becomes enqueued for a forthcoming build phase, we assume its
+<code>TModule</code> information is obsolete. We invalidate this <code>TModule</code> related user data information on the resource description
+by wrapping the resource description into a custom implementation (<code>ResourceDescriptionWithoutModuleUserData</code>). Due to this
+wrapping the resource description for module <em>B</em> will be marked as changed (<code>IResourceDescription.Delta#haveEObjectDescriptionsChanged()</code>)
+whenever the old and current states are being compared.</p>
+</div>
+<div class="paragraph">
+<p>The Eclipse builder will recognize (via <code>IProjectDescription#getDynamicReferences()</code>) that project <em>P2</em> depends on project <em>P1</em>
+so the Xtext builder will run for project <em>P2</em> as well. At the previous phase we have enqueued module <em>B</em> for the build.
+We will therefore run into a builder state update again. We do not have any resource changes this time, so <code>ToBeBuilt</code> will
+be empty. Since <code>ToBeBuilt</code> is empty, we do not have to update the copied Xtext index state before the builder state setup
+phase. As the result of the previous builder state, phase module <em>B</em> is already enqueued for a build. When processing <em>B</em>
+we register it into the <code>allDeltas</code> set. That happens for each resource being processed by the builder state. But it will be
+registered into the <code>changedDeltas</code> because we have previously wrapped module <em>B</em> into a customized resource description delta
+to hide its obsolete <code>TModule</code> related user data information. Based on the builder state rules and logic described above,
+module <em>C</em> will be marked as an affected resource, will be queued for build and will be wrapped into a customized resource
+description delta to hide its <code>TModule</code> related user data information.</p>
+</div>
+<div class="paragraph">
+<p>In the next builder state phase, when building project <em>P3</em>, we apply the same logic as we applied for project <em>P2</em>. The
+builder state will process module <em>C</em> and will update the Xtext index state. No additional resources will be found as
+affected ones, nothing will be queued for build. The build will terminate, since there were no changed <code>IResource</code> instances
+and the build queue is empty.</p>
+</div>
+<div class="paragraph">
+<p>The outcome of the incremental build will be a workspace that contains exactly one validation error. The error will be
+associated with module <em>C</em> which was exactly our expectation, however, we have to clarify that transitive <em>C</em> dependency
+was built due to wrong reasons. Module <em>C</em> was build because we wrapped module <em>B</em> to hide its user data information and
+not because it imports and uses class <code>A</code> from module <em>A</em> which should be the logical and correct reason.</p>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="dirty-state-handling"><a class="anchor" href="#dirty-state-handling"></a><a class="link" href="#dirty-state-handling">7.6. Dirty state handling</a></h3>
+<div class="paragraph">
+<p>When two or more (N4)JS files are opened in editors and one of them is changed but without persisting this change the other
+open editors should be notified and if this change breaks (or heals) references in one of the other open resources their editors
+should updated so that warn and error markers are removed or added accordingly.</p>
+</div>
+<div class="paragraph">
+<p>When there are changes in the currently open editor these changes are propagated to all other open editors. Each Xtext editor has
+got its own resource set. The <code>N4JSUpdateEditorStateJob</code> runs for each open editor different from the editor where the changes have
+been made. In those editors the affected resources are unloaded and removed from the resource set. Then the Xtext resource of
+these editors is reparsed. After reparsing scoping and linking is invoked again, but now the references resources are rebuild
+as <code>EObjectDescription</code>s. The <code>N4JSResource</code> holds its own content that only contains 1..n slots when proxified.
+<code>N4JSTypeScope.getSingleElement</code> (called when resolving cross references and the linked element should be returned) will return the
+<code>EObjectDescription</code> created from the <code>ModuleAwareContentsList</code> in <code>N4JSResource</code>, that contains the first slot as proxy and the other
+slots as types. <a href="#fig:dirty_state_handling1">Sequence Diagram: Dirty State, Trigger <code>N4JSUpdateEditorStateJob</code></a> shows the flow to trigger the <code>N4JSUpdateEditorStateJob</code> and <a href="#fig:dirty_state_handling2">Sequence Diagram: Dirty State, <code>N4JSUpdateEditorStateJob</code> in Detail</a>
+shows the sequence logic of the <code>N4JSUpdateEditorStateJob</code> in detail.</p>
+</div>
+<div id="fig:dirty_state_handling1" class="imageblock center">
+<div class="content">
+<img src="chapters/07_typeindex/images/dirty_state_handling1.png" alt="dirty state handling1">
+</div>
+<div class="title">Figure 19. Sequence Diagram: Dirty State, Trigger <code>N4JSUpdateEditorStateJob</code></div>
+</div>
+<div id="fig:dirty_state_handling2" class="imageblock center">
+<div class="content">
+<img src="chapters/07_typeindex/images/dirty_state_handling2.png" alt="dirty state handling2">
+</div>
+<div class="title">Figure 20. Sequence Diagram: Dirty State, <code>N4JSUpdateEditorStateJob</code> in Detail</div>
+</div>
+<div class="paragraph">
+<p>A concrete example should illustrate the behaviour of the dirty state handling in conjunction with fully and partial loading
+of resources:</p>
+</div>
+<div class="paragraph">
+<p>Let A.js as above, and B.js as follows:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">import A from "A.js"
+export class B {}</code></pre>
+</div>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>assume  is opened and loaded:  is created with</p>
+<div class="ulist">
+<ul>
+<li>
+<p>is filled with a special proxy to resolve the <a href="#AC">AST</a> of A only if needed.</p>
+</li>
+<li>
+<p>will be set to type A, loaded from <code>EObjectDescription</code> of A.js/A</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p><a href="#AC">AST</a> of A.js is to be accessed, e.g., for displaying JSDoc. A.js is not opened in an editor!  is modified as follows:</p>
+<div class="ulist">
+<ul>
+<li>
+<p>is filled with <a href="#AC">AST</a>, i.e. proxy in 0 is resolved</p>
+</li>
+<li>
+<p>is updated with parsed type: 1) proxify , 2) unload  (remove from content), 3) reload with parsed types again</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>Assume now that A.js is opened and edited by the user.</p>
+<div class="ulist">
+<ul>
+<li>
+<p>Reconceiler replaces  with modified <a href="#AC">AST</a></p>
+</li>
+<li>
+<p>LazyLinker updates </p>
+</li>
+<li>
+<p>is proxified</p>
+</li>
+<li>
+<p>B <code>searches</code> for A and finds updated </p>
+</li>
+</ul>
+</div>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p><em>Each opened Xtext editor has got its own resource set!</em> Such a resource set contains the resource for the currently edited
+file in the first place. When starting editing the file, the resource is reparsed , reloaded and linking (resolving the cross
+references) is done. By resolving the cross references <code>N4JSTypeScope</code> is used and now the URIs of the linked elements are belonging
+to resources not contained in the resource set of the editor so these resources a create in the resource set and their contents
+is loaded from the resource descriptions via
+<code>N4JSResource.loadFromDescription</code> .</p>
+</div>
+<div class="paragraph">
+<p>When the resource content is loaded from the existing resource description available from Xtext index the first slot is set to be
+a proxy with name <code>#:astProxy</code>.
+After that for all exported EObject descriptions of that resource description the user data is fetched and deserialized to types
+and these types are added to the slots of the resource in order they were exported. But the order is not that important anymore.</p>
+</div>
+<div class="paragraph">
+<p>As the resource set for the editor is configured to use the DirtyStateManager ( <code>ExternalContentSupport.configureResourceSet(resourceSet, dirtyStateManager)</code> ),
+all other open editors will be notified by changes in the current editor. This is done by <code>N4JSDirtyStateEditorSupport</code> that schedules
+a <code>N4JSUpdateEditorStateJob</code> that create a new resource description change event.</p>
+</div>
+<div class="paragraph">
+<p>Via <code>isAffected</code> and <code>ResourceDescription.getImportedNames</code> it is determine if a change in another resource affects this resource.</p>
+</div>
+<div class="paragraph">
+<p>Before loading the resource always <code>N4JSDerivedStateComputer.installDerivedState</code> is execute that, as we learned earlier, is responsible
+for creating the types in the resource.</p>
+</div>
+<div class="paragraph">
+<p>On every change to a N4JS file that requires a reparse the <code>N4JSDerivedStateComputer.discardDerivedState</code> is executed. This method do an
+unload on every root element at the positions 1 to n. In the <code>N4JSUnloader</code> all contents of the this root elements are proxified (i.e.
+there is a proxy URI set to each of them) and the references to the <a href="#AC">AST</a> are set to null (to avoid notifications causing
+concurrent model changes). The proxification indicates for all callers of these elements, that they have to reload them. Afterwards
+it discards the complete content of the resource. The content is build up again with the reparse of the N4JS file content.</p>
+</div>
+<div class="paragraph">
+<p>As each editor has its own resource set, only the resource belonging to the current editor is fully loaded. All other referenced
+resources are only partially loaded, i.e. only the slot 1 of these resources are loaded (i.e. the types model elements) in this
+resource set. Linking is done only against these types model elements. Synchronization between the resource sets of multiple open
+editors is done via update job as described above.</p>
+</div>
+<div class="sect3">
+<h4 id="use-case-restoring-types-from-user-data"><a class="anchor" href="#use-case-restoring-types-from-user-data"></a><a class="link" href="#use-case-restoring-types-from-user-data">7.6.1. Use case: Restoring types from user data</a></h4>
+<div class="ulist">
+<ul>
+<li>
+<p>Use case: referencing resources in editor: This has been described already in context of dirty state handling</p>
+</li>
+<li>
+<p>Use case: referencing resources from JAR: This is still to be implemented.% taskIDE-37</p>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect3">
+<h4 id="use-case-updating-the-xtext-index"><a class="anchor" href="#use-case-updating-the-xtext-index"></a><a class="link" href="#use-case-updating-the-xtext-index">7.6.2. Use case: Updating the Xtext index</a></h4>
+<div class="paragraph">
+<p>When a N4JS file is changed in way that requires reparsing the file, the underlying resource is completely unloaded and loaded again.
+By this the also the elements at the Xtext index are recreated again, belonging to this resource (i.e. new entries for new elements
+in the resource, update index elements of changed elements, delete index entries for deleted elements).</p>
+</div>
+<div class="paragraph">
+<p>When Eclipse is closed the Xtext index is serialized in a file.</p>
+</div>
+<div class="imageblock center">
+<div class="content">
+<img src="chapters/07_typeindex/images/index_serialization.png" alt="index serialization">
+</div>
+</div>
+<div class="paragraph">
+<p>When starting Eclipse again, the Xtext index is restored from this file:</p>
+</div>
+<div class="imageblock center">
+<div class="content">
+<img src="chapters/07_typeindex/images/loading_existing_index.png" alt="loading existing index">
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_project-model"><a class="anchor" href="#_project-model"></a><a class="link" href="#_project-model">8. Project Model</a></h2>
+<div class="sectionbody">
+<div class="sect2">
+<h3 id="sec:Package_json"><a class="anchor" href="#sec:Package_json"></a><a class="link" href="#sec:Package_json">8.1. Package.json File</a></h3>
+<div class="paragraph">
+<p>See [<a href="#N4JSSpec">N4JSSpec</a>] for the format specification of N4JS-specific package.json files.
+Based on the JSON-model-based AST that can be parsed from the package.json file, we transform the information that can be extracted into an instance of the N4JS-specific ProjectDescription model.
+This model is defined by means of EMF, the Xcore file is found in the N4JS model bundle.</p>
+</div>
+<div id="fig:projectDescriptionModel" class="imageblock">
+<div class="content">
+<img src="chapters/08_projectModel/images/cd_projectDescription.svg" alt="Project Description Model">
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_accessing-project-information"><a class="anchor" href="#_accessing-project-information"></a><a class="link" href="#_accessing-project-information">8.2. Accessing Project Information</a></h3>
+<div class="paragraph">
+<p>The information in the package.json files is parsed into memory at runtime, e.g. within Eclipse or in headless mode. It is made available via the <code>IN4JSCore</code> facade that provides a high-level abstraction when working with the project structure. This facade has two implementations:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>One implementation is backed by the file system, e.g. <code>java.io.File</code> and used in a headless environment</p>
+</li>
+<li>
+<p>Another implementation uses the Eclipse resource model (<code>IProject</code>, <code>IFolder</code>, <code>IFile</code>) to describe the contents of an <code>IN4JSProject</code>. This implementation is automatically kept in sync whenever the contents of a package.json file is edited by a user. It is also maintained as dynamic project information to make the Eclipse workspace aware of the declared dependencies. That is, Eclipse projects know about the project references in the package.json file.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>The project model is mimicing the handle based services of Eclipse’s <code>JavaCore</code>, the handles are often represented as EMF <code>URIs</code> though. Therefore the API allows to retrieve a source folder for a given N4JS resource, all the libraries that are configured for a project or simply the project’s name or the information if it exists. Subsequent components in the processing chain like the scope provider can leverage the API to deduce the container configuration and visiblity constraints. Project references are resolved transparently.</p>
+</div>
+<div class="paragraph">
+<p>The Xtext index participation is implemented by means of the <code>N4JSToBeBuiltComputer</code> and the <code>N4JSAllContainersState</code>. These classes provide access to the container configuration.</p>
+</div>
+<div class="paragraph">
+<p>The precedence for the dependency resolution follows this lookup chain:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>An accessible <code>IN4JSProject</code> with the given name is located in the workspace.</p>
+</li>
+<li>
+<p>The library manager provides access to the requested project.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Accordingly, the type lookup follows the same chain due to the container configuration that is deduced from the package.json configuration. Of course is prefers locally defined type that can be found in the current project over types that are located in referenced projects.</p>
+</div>
+<div class="sect3">
+<h4 id="sec:IN4JSCore"><a class="anchor" href="#sec:IN4JSCore"></a><a class="link" href="#sec:IN4JSCore">8.2.1. IN4JSCore</a></h4>
+<div class="paragraph">
+<p>Facade analogous to org.eclipse.jdt.core.JavaCore.
+It is used look up the project or source container where a resource URI belongs to.
+It also provides some helper methods to retrieve information from the package.json file.
+N4JSRuntimeCore uses the file system and thus uses java.io to access files and folders.
+N4JSEclipseCore uses the Eclipse workspace and thus uses org.eclipse.resources API.
+Both Core implementations act as wrapper for N4JSModel resp. EclipseN4JSModel.
+Instances of the <code>IN4JSCore</code> are obtained as usually via dependency injection, e.g. <code>@Inject IN4JSCore n4jsCore</code>.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:N4JSModel"><a class="anchor" href="#sec:N4JSModel"></a><a class="link" href="#sec:N4JSModel">8.2.2. N4JSModel</a></h4>
+<div class="paragraph">
+<p>N4JSModel uses FileBasedWorkspace to load and access the project description from the package.json file and create wrappers for projects (N4JSProject) and source containers (N4JSSourceContainer).</p>
+</div>
+<div class="paragraph">
+<p>A source container is a wrapper for a file system that has been marked as source folder in the package.json file.
+For determination of the current project a given EMF URI pointing to the project path is used.
+In N4JSModel this location is directly wrapped in N4JSProject.
+In N4JSModel a given EMF URI is resolved to a source container by using the specified relative source paths from the package.json file and file system based project location.
+If the EMF URI converted to a file URI starts with the absolute source folder path a N4JSProjectSourceContainer is created and returned for that EMF URI.</p>
+</div>
+<div class="paragraph">
+<p>In EclipseN4JSModel (that extends N4JSModel) the last segment of the URI is assumed to be the project name and via the EclipseBasedN4JSWorkspace that wraps the Eclipse workspace a project with that name is tried to be resolved.
+This IProject is than wrapped in N4JSEclipseProject.
+In EclipseN4JSModel a given EMF URI is resolved to an org.eclipse.core.resources.IResource belonging to the IWorkspaceRoot.
+That resource is wrapped in EclipseSourceContainer.</p>
+</div>
+<div class="paragraph">
+<p>N4JSModel is also used to retrieve project dependencies wrapped as N4JSProject.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:N4JSWorkspace"><a class="anchor" href="#sec:N4JSWorkspace"></a><a class="link" href="#sec:N4JSWorkspace">8.2.3. N4JSWorkspace</a></h4>
+<div class="paragraph">
+<p>The FileBasedWorkspace and EclipseBasedN4JSWorkspace should only be accessed by N4JSModel resp. EclipseN4JSModel as they know the contract for the URI scheme.
+The FileBasedWorkspace creates AbstractTreeIterator for the direct contents of a source container, so that their children can be navigated by this as well.
+It then filters out all directories and returns an iterator of all files as EMF URIs.</p>
+</div>
+<div class="paragraph">
+<p>The EclipseBasedN4JSWorkspace wraps the IWorkspaceRoot.</p>
+</div>
+<div class="paragraph">
+<p>Fetching the project description read out from the package.json file is cached in both workspace implementations.
+In FileBasedWorkspace the LazyProjectDescriptionHandle is used as proxy and in EclipseBasedN4JSWorkspace the ProjectDescriptionLoadListener is used to invalidate the cache when the package.json file has been changed.
+ProjectDescriptionLoadListener also ensures that dependent projects are considered by the Eclipse builder by setting dynamic dependencies in the project meta data.
+It also updates these project dependencies if it is required and recalculates all source containers.</p>
+</div>
+<div class="paragraph">
+<p>In the tests another implementation, MockWorkspace, is used, that provides a dummy project description.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:N4JSProject"><a class="anchor" href="#sec:N4JSProject"></a><a class="link" href="#sec:N4JSProject">8.2.4. N4JSProject</a></h4>
+<div class="paragraph">
+<p>A N4JSProject represents a configured project as defined in the package.json file.
+So in principles it wraps access to N4JSModel (and so to containing source containers, libraries and so on)
+and to some information from the package.json file directly (like defined module filters, vendorId and others).
+It is also used to compare depending projects.</p>
+</div>
+<div class="paragraph">
+<p>N4JSProject is the runtime representation while N4JSEclipseProject represents a project in the Eclipse workspace.
+N4JSProject is identified by its EMF location URI while N4JSEclipseProject wraps the underlying org.eclipse.core.resources.IProject.</p>
+</div>
+<div class="paragraph">
+<p>In tests MockProject is used.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:SourceContainer"><a class="anchor" href="#sec:SourceContainer"></a><a class="link" href="#sec:SourceContainer">8.2.5. SourceContainer</a></h4>
+<div class="paragraph">
+<p>A source container contains either source files for production, tests or external declarations.
+By default all these files resp. their containing types will be exported to the Xtext index.
+A source container belongs exactly to one project it is identified by its project relative location.</p>
+</div>
+<div class="paragraph">
+<p>A N4JSProjectSourceContainer is a container that contains unpacked n4js, js and n4jsd files that can be modified.
+By default all these files are syntactically and semantically validated (this can be configured by the use of module filters).
+Except for n4jsd files, all files are compiled by the configured compilers.</p>
+</div>
+<div class="paragraph">
+<p>EclipseSourceContainer specializes N4JSProjectSourceContainer to work on top of the Eclipse resources API.
+Thus besides the location it also wraps the IFolder.</p>
+</div>
+<div class="paragraph">
+<p>The IFile was chosen instead of using the java.io.File because changes to an IFile (and IResource in general) trigger a workspace change event so that the Xtext builder is triggered properly.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:N4JSProjectsStateHelper"><a class="anchor" href="#sec:N4JSProjectsStateHelper"></a><a class="link" href="#sec:N4JSProjectsStateHelper">8.2.6. N4JSProjectsStateHelper</a></h4>
+<div class="paragraph">
+<p>Calculates the visible containers for a given container, where containers are source containers within the project as well as source containers of other depending projects in workspace.
+The calculated handles are cached and invalidated if the project description file has changed or the project has been closed or reopened.</p>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="sec:Caching"><a class="anchor" href="#sec:Caching"></a><a class="link" href="#sec:Caching">8.3. Caching</a></h3>
+<div class="paragraph">
+<p>Caching is heavily used in the ExternalLibraryWorkspace and the N4JSProjectsStateHelper.
+The ExternalLibraryWorkspace relies on caching to provide data about all installed npms, their locations, names, shadowing, dependencies and so on.
+The caching of the ExternalLibraryWorkspace is implemented in the ExternalProjectMappings which inspects all external locations and builds all necessary mappings.
+The set of mappings start from a simple list of all npms, include mappings that map from location or name to a N4JSExternalProject, or give reduced set of projects.</p>
+</div>
+<div class="sect3">
+<h4 id="_caching-of-externallibraryworkspace"><a class="anchor" href="#_caching-of-externallibraryworkspace"></a><a class="link" href="#_caching-of-externallibraryworkspace">8.3.1. Caching of ExternalLibraryWorkspace</a></h4>
+<div class="paragraph">
+<p>A reduced set of projects is used since not all npms are actually necessary projects for the N4JS IDE.
+Most transitively installed plain-JS npms are of no interest since they are completely invisible to the user.
+The reduced set of projects always consists of all user workspace projects and all shipped libraries.
+From the set of all installed npms, only those are necessary that are dependencies of a non-plain-JS projects.
+Shadowed projects are also not included in the reduced set of npms.</p>
+</div>
+<div class="paragraph">
+<p>To access projects that are not included in the reduced set of npms, the ExternalProjectMappings provides some collections that contain complete set of npms.
+Additionally, some mappings also provide information about not necessary npms.
+Note that mappings that use the project name as a key naturally cannot provide information about shadowed projects.</p>
+</div>
+<div class="paragraph">
+<p>The mapping cache is updated every time a refresh is triggered (e.g. at startup or by hitting F5).
+Also, every action of the library manager (such as installing or registering npms) triggers a refresh.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_caching-of-n4jsprojectsstatehelper"><a class="anchor" href="#_caching-of-n4jsprojectsstatehelper"></a><a class="link" href="#_caching-of-n4jsprojectsstatehelper">8.3.2. Caching of N4JSProjectsStateHelper</a></h4>
+<div class="paragraph">
+<p>The N4JSProjectsStateHelper uses the MultiCleartriggerCache for caching information about projects of the user workspace.
+The EclipseBasedN4JSWorkspace does not caching at all, but provides information about project descriptions which is expensive to compute on the fly.
+Hence this information is cached in the MultiCleartriggerCache and updated every time a project description changes, is added or removed.</p>
+</div>
+<div class="paragraph">
+<p>Sometimes, a project description is rendered invalid as a side effect of a change on another project description.
+In this case, the cache of both of project descriptions has to be updated.
+The implementation to cope with these side effects uses the MultiCleartriggerCache which allows to set multiple triggers that will clear a cached object.</p>
+</div>
+<div class="paragraph">
+<p>However, it seems reasonable to align the caching of the user workspace to the caching of the external workspace.
+The reason is that caching of user workspace information such as N4JSProjects would increase build performance significantly.
+This is since as of now, projects (and information about all their source containers) is computed on the fly, that causes thousands of expensive calls to the file system.</p>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="sec:WildcardPathFilter"><a class="anchor" href="#sec:WildcardPathFilter"></a><a class="link" href="#sec:WildcardPathFilter">8.4. WildcardPathFilter</a></h3>
+<div class="paragraph">
+<p>This class encapsulates the logic to resolve (wildcard containing) paths against the file system.
+With the method matchPath it is also possible to resolve a path without using the file system.
+This class is also able to resolve relative navigation in paths.</p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="sec:ProjectUtils"><a class="anchor" href="#sec:ProjectUtils"></a><a class="link" href="#sec:ProjectUtils">8.5. ProjectUtils</a></h3>
+<div class="paragraph">
+<p>ProjectUtils provides additional methods for providing information only required in compilation, e.g. like file and module descriptor.
+It uses IN4JSCore to retrieve the information of output path and whether module wrapping is required for a given file.</p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_binding"><a class="anchor" href="#_binding"></a><a class="link" href="#_binding">9. Binding</a></h2>
+<div class="sectionbody">
+<div class="admonitionblock warning">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-warning" title=""></i>
+</td>
+<td class="content">
+This section may be outdated!
+</td>
+</tr>
+</table>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:Binding_Design_Rationale"><a class="anchor" href="#sec:Binding_Design_Rationale"></a><a class="link" href="#sec:Binding_Design_Rationale">9.1. Design Rationale</a></h3>
+<div class="paragraph">
+<p>Binding references to declarations follows the Xtext mechanism based on local <code>N4JSScopeProvider</code> and a global <code>N4JSGlobalScopeProvider</code> scope providers. The basic question is: to which elements are references bound to. This in particular interesting for all kind of type declarations, including functions as they are interpreted as types. These declarations are Janus-faced: On the one side, they are targets of type references as <code>Type</code>, and on the other side they can also be target of identifier references bound to some so called <code>IdentifiableElement</code>. As explained in <a href="#_type_index">[_type_index]</a>, special type objects (<code>TClass</code> etc.) are created from the original declarations. These type objects are used as targets for both kind of references. The following table summarizes the reference-target relations relevant for N4JS (not the standalone type grammar).</p>
+</div>
+<table class="tableblock frame-all grid-all spread">
+<caption class="title">Table 4. N4JS Cross References</caption>
+<colgroup>
+<col style="width: 50%;">
+<col style="width: 50%;">
+</colgroup>
+<thead>
+<tr>
+<th class="tableblock halign-left valign-top">Reference</th>
+<th class="tableblock halign-left valign-top">Target Type</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<th class="tableblock halign-left valign-top" colspan="2"><p class="tableblock">N4JS</p></th>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">ImportDeclaration.importedModule</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">TModule</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">NamedImportSpecifier.importedElement</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">types.IdentifiableElement</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">IdentifierRef.id</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">types.IdentifiableElement</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">ParameterizedPropertyAccessExpression.property</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">types.TMethod</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">PropertyAccessExpression.property</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">types.TMember</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">N4Getter/N4SetterDeclaration.field</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">N4FieldDeclaration</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Continue/Break-Statement.label</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">LabelledStatement</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top" colspan="2"><p class="tableblock">Type Expressions</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">ParameterizedTypeRef.declaredType</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Type</p></td>
+</tr>
+</tbody>
+</table>
+<div class="paragraph">
+<p><a href="#fig:cd_scoping">Overview Scoping Package</a> gives an overview over the most important classes in the scoping package, with the <code>N4JSScopeProvider</code> and the used customized scopes created by the scope providers.</p>
+</div>
+<div id="fig:cd_scoping" class="imageblock center">
+<div class="content">
+<img src="chapters/09_binding/images/cd_scoping.svg" alt="cd scoping">
+</div>
+<div class="title">Figure 21. Overview Scoping Package</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:Binding_to_Members"><a class="anchor" href="#sec:Binding_to_Members"></a><a class="link" href="#sec:Binding_to_Members">9.2. Binding to Members</a></h3>
+<div class="paragraph">
+<p>Members of different types, such as classes and also record types or enumerations, are bound using the <code>MemberScopeProvider</code>. This often returns a <code>MemberScope</code>, which directly works on the members. Most types with members are implemented by subclasses of <code>ContainerType</code>, using <code>CollectMembersHelper</code> to collect all members and <code>FindMemberHelper</code> for retrieving a member by its name via <code>ContainerTypes</code>. Ensure that when types with members are added to override appropriate methods in all of these related classes (e.g., <code>CollectMembersHelper</code>, <code>AbstractHierachyTraverser</code> and <code>FindMemberHelper</code> uses polymorphic dispatch to handle different subtypes – so you won’t be able to find a member if you do not adjust these helpers).</p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="sec:Binding_Getter_Setter"><a class="anchor" href="#sec:Binding_Getter_Setter"></a><a class="link" href="#sec:Binding_Getter_Setter">9.3. Getter / Setter Binding</a></h3>
+<div class="paragraph">
+<p>For customized binding of getters / setters, see <a href="#sec:Field_Accessors">Accessors</a>.</p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="chap:Statics"><a class="anchor" href="#chap:Statics"></a><a class="link" href="#chap:Statics">9.4. Static Member Binding</a></h3>
+<div class="paragraph">
+<p>For customized binding of static members, see <a href="#sec:Static_Members">Static Members</a>.</p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="sec:Binding_Enumeration"><a class="anchor" href="#sec:Binding_Enumeration"></a><a class="link" href="#sec:Binding_Enumeration">9.5. Enumeration Literals Binding</a></h3>
+<div class="ulist">
+<ul>
+<li>
+<p>introduced new type ref EnumTypeRef: it behaves comparable to ClassifierTypeRef, but with the difference that the MemberScopeProvider filters for a given EnumTypeRef filters all literals of the contained TEnum (in comparison the MemberScopeProvider filters for a given ClassifierTypeRef all static members of the contained classifier)</p>
+</li>
+<li>
+<p>it isn’t possible to access literals on a enumeration literal itself, although this literal is typed as TEnum (that contains TEnumLiterals)</p>
+</li>
+<li>
+<p>as there are currently no additional fields and operations for enumeration literals defined (in Java there is name and value()), the scope for literals is currently empty</p>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:Accessibility_of_types_and_members"><a class="anchor" href="#sec:Accessibility_of_types_and_members"></a><a class="link" href="#sec:Accessibility_of_types_and_members">9.6. Accessibility of types and members</a></h3>
+<div class="paragraph">
+<p>Member access and type access has to be constrained and validated against the accessibility rules of N4JS. Therefore, the scoping annotates certain elements as erroneous to detect invalid references.</p>
+</div>
+<div class="paragraph">
+<p>Basically two different approaches are used to implement that behavior:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>The <code>VisibilityAwareTypeScope</code> and <code>VisibilityAwareMemberScope</code> decorate an existing scope to validate the result on access. This allows to lazily check the visibility of the returned element. If it is not accessible, it is wrapped in a <code>AbstractDescriptionWithError</code> which will be indentified as such by the <code>ErrorAwareLinkingService</code>. Before the binding is resolved and the EMF proxy is replaced, the error message is used to create an EMF diagnostic.</p>
+</li>
+<li>
+<p>For other cases, the scopes are produced differently, e.g. if all elements are easily enumerable and have to be collected before the scope is created (e.g. for imported elements), the scoped elements are validated eagerly to put them into the correct layer of scopes. That is, the valid descriptions may shadow the invalid description. Since there are more error conditions for these cases, e.g. duplicate imports and similar cases, the accessibility is checked before the concrete member is accessed. All the instances <code>AbstractDescriptionWithError</code> are put into the <code>MapBasedScope</code> immediately.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>In that sense, accessibility checks are basically implemented as decorators for the scoping itself. Bindings are established but flagged as errors.</p>
+</div>
+<div class="paragraph">
+<p>Default visibility of members is calculated in <code>Types.xcore</code> (in <code>getTypeAccessModifier</code> and <code>getMemberAccessModifier</code> etc.). Visibility is checked in <code>org.eclipse.n4js.scoping.accessModifiers.MemberVisibilityChecker</code> and validators.</p>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:Member_Scope_Example"><a class="anchor" href="#sec:Member_Scope_Example"></a><a class="link" href="#sec:Member_Scope_Example">9.7. Member Scope Example</a></h3>
+<div class="paragraph">
+<p>In this section, we are going to have a look at the creation process of <code>MemberScope</code>.</p>
+</div>
+<div class="listingblock">
+<div class="title">C.n4js</div>
+<div class="content">
+<pre class="highlight"><code>export public class C {
+	 private m1: int;
+	 public m2: int;
+}</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="title">Test.n4js</div>
+<div class="content">
+<pre class="highlight"><code>import { C } from "C";
+
+let c: C = new C();
+c.m1;  // Error -&gt; The field m1 is not visible
+c.m2;  // OK    -&gt; m2 is visible at this context</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Assume that we need to figure out to which element the <code>ParameterizedPropertyAccessExpression c.m1</code> in the <code>ExpressionStatement c.m1</code> binds to. To answer this question, <code>N4JSScopeProvider.getScope(context, reference)</code> is triggered whereby <code>context</code> is the <code>ParameterizedPropertyAccessExpression</code> and <code>reference</code> is <code>EReference property</code> (<code>property</code> is the cross-reference element defined in <code>ParameterizedPropertyAccessExpression</code> 's grammar).</p>
+</div>
+<div class="paragraph">
+<p><code>N4JSScopeProvider.getScope(context, reference)</code> does not implement the scoping but delegates to corresponding methods based on the type of <code>context</code>. In our example, since <code>context</code> is a <code>ParameterizedPropertyAccessExpression</code>, the scoping logic is delegated to the method that creates a <strong>MemberScope</strong> for the context <code>ParameterizedPropertyAccessExpression c.m1</code> based on the receiver type of <code>c</code> which is class <code>C</code>.
+The resulting scope instance returned by <code>N4JSScopeProvider.getScope()</code> in our example is of type <code>TypingStrategyAwareMemberScope</code> as shown in <a href="#fig:memberscope-example">Member scope hierarchy</a> .</p>
+</div>
+<div id="fig:memberscope-example" class="imageblock" style="text-align: center">
+<div class="content">
+<img src="chapters/09_binding/images/memberscope_example.svg" alt="memberscope example">
+</div>
+<div class="title">Figure 22. Member scope hierarchy</div>
+</div>
+<div class="paragraph">
+<p>In the hierarchy, the top-level scope is the NULL scope. Directly below the NULL scope is a MemberScope which contains all members of <code>N4Object</code> since the class <code>C</code> implicitly inherits <code>N4Object</code>. The other <code>MemberScope</code> instance beneath contains all members of the class <code>C</code> <strong>regardless of their visibility</strong>. These members are <code>m1</code> and <code>m2</code>. While <code>m2</code> is can be accessed by <code>c.m2</code>, <code>m1</code> it not visible at <code>c.m1</code>. The <code>VisibilityAwareMemberScope</code> implements precisely this behavior. In particular, it returns all members of <code>C</code> that are visible at the current <code>context</code> (here the element <code>m2</code>),  while wrapping non-visible members (here the element <code>m</code>) in <code>InvisibleMemberDescription</code> instances. These <code>InvisibleMemberDescription</code> instances of type <code>IEObjectDescriptionWithError</code> contain issue code and error message related to accessibility problems and are recognized during the error-aware linking phase done by <code>ErrorAwareLinkingService</code>. It is worth to emphasize the motivation behind use of <code>IEObjectDescriptionWithError</code> is to provide more informative error messages to the user other than <em>Cannot reference element&#8230;&#8203;</em> Another example of <code>IEObjectDescriptionWithError</code> is <code>WrongWriteAccessDescription</code> that is used when we, try to write to a getter and no corresponding setter exists.</p>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:Scoping_for_Members_of_Composed_Type_Explained"><a class="anchor" href="#sec:Scoping_for_Members_of_Composed_Type_Explained"></a><a class="link" href="#sec:Scoping_for_Members_of_Composed_Type_Explained">9.8. Scoping for Members of Composed Type (Union/Intersection) Example</a></h3>
+<div class="paragraph">
+<p>In this section, we will have a look at how scoping is implemented for composed type, i.e. union or intersection type with an example of union type. Intersection is done similarly. Before reading this, it is strongly recommended to read <a href="#sec:Member_Scope_Example">Member Scope Example</a> first.</p>
+</div>
+<div class="listingblock">
+<div class="title">Defs.n4js</div>
+<div class="content">
+<pre class="highlight"><code>export public class C {
+	 private m1: int;
+	 public m2: int;
+}
+
+export public class D {
+	 private m1: int;
+	 get m2(): int { return 42; };
+}</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="title">Test.n4js</div>
+<div class="content">
+<pre class="highlight"><code>import { C, D } from "Defs";
+
+let cud : C|D;
+
+cud.m2 = 10;</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Assume that we need to find out to what element the <code>ParameterizedPropertyAccessExpression cud.m2</code> in the <code>ExpressionStatement cud.m2</code> binds to.
+This is a question for scoping. Since the receiver type of <code>cud</code> is a union type <code>C|D</code>, a <code>UnionMemberScope</code> is created that contains two subscopes, each of which corresponds to an individual type in the union. The resulting scope hierarchy is graphically depicted in <a href="#fig:unionmemberscope-example">Union member scope hierarchy</a>.</p>
+</div>
+<div id="fig:unionmemberscope-example" class="imageblock" style="text-align: center">
+<div class="content">
+<img src="chapters/09_binding/images/unionmemberscope_example.svg" alt="unionmemberscope example">
+</div>
+<div class="title">Figure 23. Union member scope hierarchy</div>
+</div>
+<div class="paragraph">
+<p>The two subscopes are of type <code>TypingStrategyAwareMemberScope</code> and created exactly the same way as described in <a href="#sec:Member_Scope_Example">Member Scope Example</a>.
+The <code>UnionMemberScope</code> instance contains a list of subscopes for all types involved in the union and is responsible for constructing an <code>IEObjectDescription</code> instance for <code>m2</code> by merging all members of the name <code>m2</code> found in all subscopes.
+Merging members requires considering a variety of combinations (fields, setters getters, optional/variadic parameters etc.) and thus can become very complicated. To reduce the complexity, the recently refactored implementation splits the proccess into three separate steps.</p>
+</div>
+<div class="paragraph">
+<p>Step 1: Collect information</p>
+</div>
+<div class="paragraph">
+<p>During this phase, members with the name <code>m2</code> are looked up in each subscope and collected into an <code>ComposedMemberInfo</code> instance by <code>ComposedMemberInfoBuilder</code>.
+The first subscope (left branch in the <a href="#fig:unionmemberscope-example">Union member scope hierarchy</a>) returns an <code>EObjectDescription</code> wrapping the <code>TField m2</code> of class <code>C</code> and hence <code>TField m2</code> is added to the <code>ComposedMemberInfo</code> instance. The second subscope (right branch in the <a href="#fig:unionmemberscope-example">Union member scope hierarchy</a>) returns a <code>WrongWriteAccessDescription</code> wrapping the <code>TGetter m2</code> of class <code>D</code> and hence <code>TGetter m2</code> is added to <code>ComposedMemberInfo</code> instance. The reason for <code>WrongWriteAccessDescription</code> because <code>cud.m2</code> is trying to write to the getter of the same name in <code>D</code>.</p>
+</div>
+<div class="paragraph">
+<p>At the end of this step, two members <code>public TField m2: int</code> and <code>project TGetter m2(): int</code> are added to <code>ComposedMemberInfo</code>.</p>
+</div>
+<div class="paragraph">
+<p>Step 2: Merge members</p>
+</div>
+<div class="paragraph">
+<p>This phase merges members of the same name into a composed member based on the information about these members collected in Step 1. Note that merge rules can become quite complicated as many situations must be considered. Sometimes, it is not possible to merge at all. If the merge is possible, we need to consider the following properties, among others,</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Member kind: what kind of member is the merge result. For instance, what do we get when we merge a field with a setter?</p>
+</li>
+<li>
+<p>Type of merge member: What is the return/parameter type of the merge result?</p>
+</li>
+<li>
+<p>Accessibility: what is the accessibility of the merge result?</p>
+</li>
+<li>
+<p>Optionality/Variadic: Should a parameter of the merge be optional or variadic?</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>The actual merge rules are implemented in the class <code>UnionMemberFactory</code> which delegates to either of the classes <code>UnionMethodFactory</code>, <code>UnionFieldFactory</code>, <code>UnionGetterFactory</code> and <code>UnionSetterFactory</code>.</p>
+</div>
+<div class="paragraph">
+<p>In our example,
+The merge result of <code>public TField m2: int</code> and <code>project TGetter m2(): int</code> are merged into a <code>project TGetter m2: int</code> .</p>
+</div>
+<div class="paragraph">
+<p>Step 3: Construct the scope entry</p>
+</div>
+<div class="paragraph">
+<p>In this final step, the actual IEObjectDescription for <code>m2</code> is constructed. In our example, since there exists one subscope exposing an <code>EObjectDescriptionWithError</code> (here <code>WrongWriteAccessDescription</code>), the final result is an instance of <code>UnionMemberDescriptionWithError</code>. This error instance is recognized during the linking phase and the error message of the subscope regarding <code>WrongWriteAccessDescription</code> is displayed: <em>Union combines fields and getters with name m2 and therefore property m2 is read-only.</em></p>
+</div>
+<div class="paragraph">
+<p>More details can be found in the API documentation in the code. A good starting point is the class <code>ComposedMemberScope</code>.</p>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:Binding_of_Structurally_References_Types"><a class="anchor" href="#sec:Binding_of_Structurally_References_Types"></a><a class="link" href="#sec:Binding_of_Structurally_References_Types">9.9. Structurally References Types</a></h3>
+<div class="paragraph">
+<p>Scoping of structurally referenced types is similar to binding of members. The structural typing modifier basically filters the members of a type. That is, the structural modifier filters out all non-public members, and the field-only modifier only accept fields. Thus, similar to accessibility aware scoping (<a href="#sec:Accessibility_of_types_and_members">Accessibility of types and members</a>), the <code>TypingStrategyAwareMemberScope</code> encapsulates an original scope and applies these additional filters.</p>
+</div>
+<div class="paragraph">
+<p>Bindings to additional members of a structurally referenced type is implemented in <code>MemberScopeProvider.members(ParameterizedTypeRefStructural ..)</code>. Note that the current implementation does not necessarily bind to the type model (TModule) instance, as these members are part of a type reference. That is, usually these bindings refer to the <a href="#AC">AST</a> elements. Thus, it is not possible to compare these members directly, instead, a structural comparison has to be applied.</p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="sec:Building"><a class="anchor" href="#sec:Building"></a><a class="link" href="#sec:Building">9.10. Building</a></h3>
+<div class="sect3">
+<h4 id="sec:Build_Phases"><a class="anchor" href="#sec:Build_Phases"></a><a class="link" href="#sec:Build_Phases">9.10.1. Build Phases</a></h4>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Phase 0
+</td>
+<td class="hdlist2">
+<p>Loading Resources</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Phase 1: prelinking
+</td>
+<td class="hdlist2">
+<p>Create symbols for all resources, includes creation of temporary pre-linked type models</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Phase 2: linking
+</td>
+<td class="hdlist2">
+<p>Resolve all links, includes fully-resolved typed models<br>
+includes compilation</p>
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>That is, not each resource is loaded, pre-linked and linked separately. Instead, all resources are first loaded, then all resources are pre -inked, and only then all resources are linked.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Build_Scenarios"><a class="anchor" href="#sec:Build_Scenarios"></a><a class="link" href="#sec:Build_Scenarios">9.10.2. Build Scenarios</a></h4>
+<div class="paragraph">
+<p>Consequences:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>do not try to set any types in types builder, only create symbols there (probably not even members of types)</p>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Lazy_linking_problem"><a class="anchor" href="#sec:Lazy_linking_problem"></a><a class="link" href="#sec:Lazy_linking_problem">9.10.3. Lazy linking problem</a></h4>
+<div class="paragraph">
+<p>Lazy linking proxies in the indes may trigger reloading of AST (which leads to invalid disconnected type models):</p>
+</div>
+<div class="paragraph">
+<p>Lazy links (ending with |x in which x is an index entry of a temporary list used to resolve the link) must not be written into index.</p>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:Proxies_and_Proxy_Resolution"><a class="anchor" href="#sec:Proxies_and_Proxy_Resolution"></a><a class="link" href="#sec:Proxies_and_Proxy_Resolution">9.11. Proxies and Proxy Resolution (Overview)</a></h3>
+<div class="paragraph">
+<p>Here we give a brief overview of the different kinds of proxies and when / how they are created and resolved.</p>
+</div>
+<div class="sect3">
+<h4 id="xtexts-lazy-linking-proxies"><a class="anchor" href="#xtexts-lazy-linking-proxies"></a><a class="link" href="#xtexts-lazy-linking-proxies">9.11.1. Xtext’s Lazy Linking Proxies</a></h4>
+<div class="ulist">
+<ul>
+<li>
+<p>URI fragment is <code>|</code> <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>n</mi></math> (where <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>n</mi></math> is a non-negative integer).<br>
+<code>platform:/resource/Project/src/A.n4js#|3</code></p>
+</li>
+<li>
+<p>created by Xtext’s <code>LazyLinkingResource</code> in the AST after parsing (they are only ever created in the AST, but the types builder may copy them to the TModule, so they may appear there as well.</p>
+</li>
+<li>
+<p>used to represent cross-references defined in the source code (i.e. name of an identifiable element used in source code to refer to that element).<br></p>
+<div class="paragraph">
+<p>Since the types builder sometimes copies proxies from AST to TModule (e.g. type of an element that was provided with an explicit type declaration in the source code), these proxies may also appear in the TModule, but only between the types builder phase and the end of the post-processing phase (or later, in case they are unresolvable).</p>
+</div>
+</li>
+<li>
+<p>resolution is handled by <code>#getEObject(String)</code> in <code>LazyLinkingResource</code>, which recognizes lazy linking URI fragments and then forwards them to <code>#getEObject(String,Triple)</code>, which in turn relies on the Xtext infrastructure.</p>
+</li>
+<li>
+<p>latest time of resolution: post processing. After post processing has completed, they should all be gone (unless they are unresolvable, e.g. typo in source code).</p>
+</li>
+<li>
+<p>fun facts:</p>
+<div class="ulist">
+<ul>
+<li>
+<p>the number after the pipe character is the index of a <code>Triple</code> stored in field <code>proxyInformation</code> in each <code>LazyLinkingResource</code>.</p>
+</li>
+<li>
+<p>the resource given before the fragment (e.g. <code>A.n4js</code> in the above example) is not the resource the proxy is pointing to (i.e. the resource containing the target EObject), but the resource from where the link originates.</p>
+</li>
+</ul>
+</div>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect3">
+<h4 id="standard-emf-proxies"><a class="anchor" href="#standard-emf-proxies"></a><a class="link" href="#standard-emf-proxies">9.11.2. Standard EMF Proxies</a></h4>
+<div class="ulist">
+<ul>
+<li>
+<p>URI fragment contains a path to an EObject, using reference names and indices:<br>
+<code>platform:/resource/Project/src/A.n4js#/1/@topLevelTypes.1/@ownedMembers.0</code></p>
+</li>
+<li>
+<p>created automatically by EMF</p>
+<div class="ulist">
+<ul>
+<li>
+<p>during deserialization of a TModule <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>M</mi></math> from the Xtext index for all references to a different TModule <math xmlns="http://www.w3.org/1998/Math/MathML"><msup><mi>M</mi><mi>'</mi></msup></math> (see <code>UserdataMapper</code>).</p>
+</li>
+<li>
+<p>when unloading a resource.</p>
+</li>
+<li>
+<p>&#8230;&#8203;</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>used to represent</p>
+<div class="ulist">
+<ul>
+<li>
+<p>cross-references from one TModule to another TModule.</p>
+</li>
+<li>
+<p><code>astElement</code> links from TModule to AST whenever the AST is not present (e.g. resource was loaded from Xtext index).</p>
+</li>
+<li>
+<p><code>definedType</code> links from AST to TModule after deleting the TModule (this happens in the incremental builder after the pre-linking phase).</p>
+</li>
+<li>
+<p>all kinds of links after demand-loading an AST by resolving an <code>astElement</code> link (pathological case).</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>resolution is handled in two ways:</p>
+<div class="ulist">
+<ul>
+<li>
+<p>if the context <code>EObject</code> of the proxy, i.e. the one where the proxified cross-reference originates, is contained in an N4JSResource <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>R</mi></math>, then resolution is handled by <code>N4JSResource#doResolveProxy()</code> (see also <code>ProxyResolvingResource</code> for details).</p>
+<div class="paragraph">
+<p>In this case, special handling is performed to make sure that (a) the target resource is loaded from the index, if possible, and (b) post-processing of the target resource is initiated iff the target resource was loaded from AST (instead from the Xtext index) AND post-processing of resource <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>R</mi></math> is currently in progress or has already been completed.</p>
+</div>
+</li>
+<li>
+<p>otherwise, resolution is handled by standard EMF functionality.</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>latest time of resolution: none. In fact, some of those proxies (those representing <code>astElement</code> links from TModule to AST) must not be resolved at all, because this is not yet properly handled.</p>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_how-is-proxy-resolution-triggered"><a class="anchor" href="#_how-is-proxy-resolution-triggered"></a><a class="link" href="#_how-is-proxy-resolution-triggered">9.11.3. How is Proxy Resolution Triggered?</a></h4>
+<div class="paragraph">
+<p>Resolution of proxies throughout the N4JS implementation is triggered as usually when using EMF, which means: whenever the getter of a EMF cross-reference is invoked and the value is still a proxy, the EMF-generated code of the getter will automatically trigger resolution of this proxy. For details look at the EMF-generated code of the getter of any cross-reference (<code>IdentifierRefImpl#getId()</code> would be a good example).</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_when-is-proxy-resolution-allowed"><a class="anchor" href="#_when-is-proxy-resolution-allowed"></a><a class="link" href="#_when-is-proxy-resolution-allowed">9.11.4. When is Proxy Resolution Allowed?</a></h4>
+<div class="paragraph">
+<p>So, at what time is it legal to trigger such a proxy resolution? Or, more concretely, during which resource load states (<a href="#sec:N4JS_Resource_Load_States">N4JS Resource Load States</a>) is it legal to trigger proxy resolution? In fact, asking the question in this way is incorrect or at least not very helpful, because the answer would be (almost) always. The better question is: which components of the system / which parts of the code base are allowed to trigger proxy resolution?</p>
+</div>
+<div class="paragraph">
+<p>For example, triggering resolution is disallowed in the <code>ASTStructureValidator</code> and <code>N4JSTypesBuilder</code>, but for the outside client code such as a JUnit test it is allowed to trigger proxy resolution as early as right after parsing. For an example of the latter see test <code>#testStateFullyProcessed_triggeredOnlyThroughProxyResolution()</code> in <code>N4JSResourceLoadStatesTest</code>.</p>
+</div>
+<div class="paragraph">
+<p>In summary, we can state the rule that the <strong>internal N4JS implementation</strong> must not trigger any proxy resolution until installation of the derived state has completed, i.e. not before resource load state "Fully Initialized", but <strong>client code</strong> may trigger proxy resolution as early as right after parsing, i.e. already in resource load state "Loaded".</p>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_validation"><a class="anchor" href="#_validation"></a><a class="link" href="#_validation">10. Validation</a></h2>
+<div class="sectionbody">
+<div class="admonitionblock warning">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-warning" title=""></i>
+</td>
+<td class="content">
+This chapter may be outdated.
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>In this chapter the concept for the validation infrastructure of the N4JS IDE is described.</p>
+</div>
+<div class="paragraph">
+<p>Requirements:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>like in old IDE centralize issue codes and messages</p>
+</li>
+<li>
+<p>instead of the DLTK API, the Xtext Validation API should be used</p>
+</li>
+<li>
+<p>there should be an unified approach / call to produce validation messages (as in old IDE with the call of reportProblem)</p>
+</li>
+</ul>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:validation_overview"><a class="anchor" href="#sec:validation_overview"></a><a class="link" href="#sec:validation_overview">10.1. Validation overview</a></h3>
+<div class="ulist">
+<ul>
+<li>
+<p>in Xtext in most cases validation should triggered after all Xtext resources are linked (so everything is resolved), so most validations are defined in N4JSValidator and there in composed validators</p>
+</li>
+<li>
+<p>in Xtext there are resource diagnostics and validation diagnostics</p>
+<div class="ulist">
+<ul>
+<li>
+<p>resource diagnostics are produced for issues related to found syntax errors and linking errors</p>
+</li>
+<li>
+<p>validation diagnostics are produced for issues found during semantic validation (model invariants)</p>
+</li>
+<li>
+<p>Note, that you can only produce diagnostics only for the resource currenlty validated - e.g. it isn’t possible to create a marker for a duplicate issue in the other resource that contains the first element while producing the issue for the second - you have to create the diagnostic when validating the other resource</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>validation message sources</p>
+<div class="ulist">
+<ul>
+<li>
+<p>parser, e.g. ANTLR parser: messages are contained and produced internally by the parser but can be adapted by a customized SyntaxErrorMessageProvider (see link section below)</p>
+</li>
+<li>
+<p>lazy linking - N4JSLinker (extension of lazy linker): custom handling exceptions from value converters, that produces own issues as XtextLinkingDiagnostic (this is a resource diagnostic)</p>
+</li>
+<li>
+<p>lazy linking - ASTStructureValidator: traverses AST and produces custom DiagnosticMessage (triggered during N4JSLinker.doLinkModel), creates XtextLinkingDiagnostic (this is a resource diagnostic). The ASTStructureValidator checks for things like allowed occurence of continue, break, return as well as allowed labels</p>
+</li>
+<li>
+<p>linking - default: uses the ILinkingDiagnosticMessageProvider to create error messages for typical error cases (referenced not resolved, unique constraint violation, bounds contraints violation, etc.)</p>
+</li>
+<li>
+<p>linking - ErrorAwareLinkingService: In N4JS we have introduced a custom IEObjectDescription AbstractDescriptionWithError that holds issue code and error message and ErrorAwareLinkingService as extension of DefaultLinkingService to produce for every AbstractDescriptionWithError a XtextLinkingDiagnostic (this is a resource diagnostic) - the usual Xtext behavior would be to produce a linking error with linking disabled, with our customization linking still works but the error message/marker is produced as well. Currently there are these custom AbstractDescriptionWithError implementations, that are produced during scoping</p>
+<div class="ulist">
+<ul>
+<li>
+<p>AmbiguousImportDescription: indicate an ambiguous wildcard import</p>
+</li>
+<li>
+<p>PlainAccessOfAliasedImportDescription: indicate accessing type directly instead of using the alias it has been imported with</p>
+</li>
+<li>
+<p>InvisibleMemberDescription: indicate accessing a member, that is not visible to the caller due to access modifier restrictions</p>
+</li>
+<li>
+<p>InvisibleTypeOrVariableDescription: indicate accessing a type / variable or function, that is not visible to the caller due to access modifier restrictions</p>
+</li>
+<li>
+<p>WrongFieldAccessorDescription: setter/getter access used in wrong context</p>
+</li>
+<li>
+<p>WrongStaticAccessorDescription: static/non-static access used in wrong context</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>N4JSTypeSystem:</p>
+<div class="ulist">
+<ul>
+<li>
+<p>error: cannot type given expression</p>
+</li>
+<li>
+<p>error: element is not a subtype of another type</p>
+</li>
+<li>
+<p>RuleFailedException is thrown in type system, then handled as result where out of the contained information the AbstractDeclarativeValidator API is used to create issues via calls to error(..) or warning(..) methods</p>
+</li>
+<li>
+<p>RuleFailedExceptionWithoutStacktrace - sub class of RuleFailedException</p>
+</li>
+<li>
+<p>N4JSTypeValidator.createError &#8594; delegates to AbstractDeclarativeValidator, or directly calls AbstractDeclarativeValidator.error</p>
+</li>
+<li>
+<p>XsemanticsValidatorErrorGenerator (currently not used)</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>N4JSValidation: composed validators, declarative checks, i.e. using annotation @Check at methods, issues mostly created by using combination of message, context object, EFeature and index passed to AbstractDeclarativeValidator methods like error(..), warning(..)</p>
+<div class="ulist">
+<ul>
+<li>
+<p>N4JSClassValidator - checks related to classes, like duplicate member check</p>
+</li>
+<li>
+<p>N4JSFunctionValidator - checks for function expressions in expression statements and creates an error, but this validation is already done by the ASTStructureValidator</p>
+</li>
+<li>
+<p>N4JSImportValidator - checks invalid, duplicated and invalid imports</p>
+</li>
+<li>
+<p>N4JSInterfaceValidator - currently checks only for static members</p>
+</li>
+<li>
+<p>N4JSRoleValidator - currently checks only for static members</p>
+</li>
+<li>
+<p>N4JSStrictValidator - checks for function expressions in expression statements and creates an error, but this validation is already done by the ASTStructureValidator, thus this composite test is commented out</p>
+</li>
+<li>
+<p>N4JSTypeValidator - this is type system, see above</p>
+</li>
+</ul>
+</div>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>Check types and check modes</p>
+<div class="ulist">
+<ul>
+<li>
+<p>Check types are used in <code>@Check</code> annotation to influence, when a validation is triggered</p>
+<div class="ulist">
+<ul>
+<li>
+<p><code>FAST</code> - Check is declared as fast</p>
+</li>
+<li>
+<p><code>NORMAL</code> - the common checks</p>
+</li>
+<li>
+<p><code>EXPENSIVE</code> - long running checks</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>Check modes decide using check types when to run which types of checks</p>
+<div class="ulist">
+<ul>
+<li>
+<p><code>FAST_ONLY</code> - used by Xtext editor to execute FAST checks on every key stroke and in embedded Xtext editors</p>
+</li>
+<li>
+<p><code>NORMAL_ONLY</code> - not used in Xtext framework itself</p>
+</li>
+<li>
+<p><code>EXPENSIVE_ONLY</code> - not used in Xtext framework itself</p>
+</li>
+<li>
+<p><code>NORMAL_AND_FAST</code> - used by Xtext editor to execute FAST and NORMAL checks on file save as well as on marker update for changed resources (delta calculated by Xtext builder)</p>
+</li>
+<li>
+<p>ALL - executes all types of checks when invoking explicitley the Validate action in the context menu of the Xtext editor</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>So by default check types and modes aren’t configurable at runtime</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>Severity</p>
+<div class="ulist">
+<ul>
+<li>
+<p>types</p>
+<div class="ulist">
+<ul>
+<li>
+<p><code>ERROR</code> - indicates a serious issue, that later will prevent things like builder, compiler and so on, to run</p>
+</li>
+<li>
+<p><code>WARNING</code> - indicates a possible semantic problem, where the user have to decide how to handle it. Issues with such severity won’t stop any post processing</p>
+</li>
+<li>
+<p><code>INFO</code> - only an information hint for the user. Note, it is not allowed to create a diagnostic with severity INFO.</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>can be statically provided by calling the AbstractDeclarativeValidator methods error(..), warning(..), info(..) or directly pass the severity to a sub class of AbstractValidationDiagnostic (e.g. FeatureBasedDiagnostic, RangeBasedDiagnostic)</p>
+</li>
+<li>
+<p>can also determined dynamically at runtime with using the IssueSeveritiesProvider and a implementation of IPreferenceValuesProvider (e.g. the EclipsePreferencesProvider that uses the Eclipse preference store and preference page)</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>Issue codes</p>
+<div class="ulist">
+<ul>
+<li>
+<p>used to identify an issue elsewhere, e.g. when applying an quickfix for a validation issue but also for configuring validation handling (e.g. in a Eclipse preference page).</p>
+</li>
+<li>
+<p>We can use this issue code to also externalize the issue messages at a central place</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>Issue data: String array to store additional data to be used in other places (e.g. hints for quickfixes)</p>
+</li>
+<li>
+<p>message: The message shown as text for the marker created at the resource in Eclipse and shown in the Xtext editor but also available by the methods getWarnings and getErrors at the XtextResource itself and so usable when logging messages to console in headless mode</p>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:validation_control_flow"><a class="anchor" href="#sec:validation_control_flow"></a><a class="link" href="#sec:validation_control_flow">10.2. Validation control flow</a></h3>
+<div class="paragraph">
+<p><a href="#fig:cd_validation">Validation control flow</a> gives an overview over the common control flow that triggers validation.</p>
+</div>
+<div id="fig:cd_validation" class="imageblock center">
+<div class="content">
+<img src="chapters/10_validation/images/cd_validation.svg" alt="cd validation">
+</div>
+<div class="title">Figure 24. Validation control flow</div>
+</div>
+<div class="paragraph">
+<p>Validation is either triggered by dirty state handling (editing an Xtext document without saving starts a validation job) or by the automated build (invoked directly or started by resource changes in the project e.g. after saving a file).</p>
+</div>
+<div class="paragraph">
+<p>While in dirty state handling the current resource is already parsed and resolved the builder have to load the resource.</p>
+</div>
+<div class="paragraph">
+<p>All issues collected during load (i.e. during parsing, linking and scoping) the resource are added to the resource.</p>
+</div>
+<div class="paragraph">
+<p>In the automated build process there is step <code>updateMarkers</code> that triggers the validation.</p>
+</div>
+<div class="paragraph">
+<p>The <code>SourceContainerAwareResourceValidator</code> is a customization by us to handle only files that are contained in folders declared as source container by the package.json file.</p>
+</div>
+<div class="paragraph">
+<p>The <code>CancelableDiagnostican</code>, called by the resource validator, iterates over all elements contained in the resource. For each element the bound validator is called, in our case <code>N4JSValidator</code>, as it is registered as validator for the N4JS EPackage (in <code>AbstractN4JSValidator</code>).</p>
+</div>
+<div class="paragraph">
+<p>As this validator extends <code>AbstractDeclarativeValidator</code> in the first step all methods that are annotated with @Check and that have exactly one parameter are collected keyed by the type of their input parameter. The result of this collection process is cached. There is a defined order how the methods are collected:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>all local methods</p>
+</li>
+<li>
+<p>all methods recursively found in the super classes of the current class</p>
+</li>
+<li>
+<p>all methods found for the in the composed check annotation defined validators (by applying this algorithm as well)</p>
+</li>
+<li>
+<p>all methods recursively found in the composed checks in the super classes of the current class (by applying this algorithm as well)</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>The <code>N4JSValidator</code> filters all methods that uses the type of the currently traversed element from the before collected check methods and invokes them with the element from the resource.</p>
+</div>
+<div class="paragraph">
+<p>The Xsemantics type system validator is used as one of the composed validators in <code>N4JSValidator</code>. So although <code>N4JSValidator</code> extends <code>N4JSTypeSystemValidator</code>, <code>N4JSTypeSystemValidator</code> just re-uses the validation infrastructure but not its call hierarchy.</p>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:validation_issue_ids"><a class="anchor" href="#sec:validation_issue_ids"></a><a class="link" href="#sec:validation_issue_ids">10.3. Issue IDs and Messages</a></h3>
+<div class="paragraph">
+<p>For now the NLS validation message bundle resides in<br>
+<code>/org.eclipse.n4js/src/org/eclipse/n4js/validation/messages.properties</code><br>
+The entries in the messages.properties follows the pattern as described in <code>NLSProcessor</code>, the NLS class is <code>IssueCodes</code></p>
+</div>
+<div class="admonitionblock tip">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-tip" title=""></i>
+</td>
+<td class="content">
+We use the same pattern for semver and json.
+</td>
+</tr>
+</table>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>IDs shouldn’t be to long, as there might be a lot of markers and the issue codes are stored in memory</p>
+</li>
+<li>
+<p>the ID should encode where the issue has been created, therefore there should be common used prefixes like</p>
+<div class="ulist">
+<ul>
+<li>
+<p>PRS for parser (not used yet)</p>
+</li>
+<li>
+<p>VCO for value converter</p>
+</li>
+<li>
+<p>AST for issues found during AST traversal</p>
+</li>
+<li>
+<p>LIN for issues found during scoping/linking (not used yet)</p>
+</li>
+<li>
+<p>TYS for type system</p>
+</li>
+<li>
+<p>VAL for semantic validation (not used yet)</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>besides the source also the domain of the issue should be encoded (the following list may reduced or extended over time, when it gets obvious which sorts of domain specific validations are required in which frequency)</p>
+<div class="ulist">
+<ul>
+<li>
+<p>CLF for issues common to all classifiers</p>
+</li>
+<li>
+<p>CLA for classes (not used yet)</p>
+</li>
+<li>
+<p>ROL for roles</p>
+</li>
+<li>
+<p>FUN for function</p>
+</li>
+<li>
+<p>IMP for imports</p>
+</li>
+<li>
+<p>VAR for variables (not used yet)</p>
+</li>
+<li>
+<p>MEM for classifier members in general</p>
+</li>
+<li>
+<p>OLI for object literals (not used yet)</p>
+</li>
+<li>
+<p>ENU for enumerations (not used yet)</p>
+</li>
+<li>
+<p>ARR for array literals (not used yet)</p>
+</li>
+<li>
+<p>ANN for annotation related issues (not used yet)</p>
+</li>
+<li>
+<p>EXP for expression related issues (assignment expression, binary expression, etc.) (not used yet)</p>
+</li>
+<li>
+<p>STMT for statement related issues, such as if-else (conditional) , loops, switch etc.</p>
+</li>
+<li>
+<p>PRP for property access related issues (not used yet)</p>
+</li>
+<li>
+<p>EXC for exception handling related issues (not used yet)</p>
+</li>
+<li>
+<p>LBL for labels related issues (not used yet)</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>also technical validation aspects can be encoded</p>
+<div class="ulist">
+<ul>
+<li>
+<p>DUP for duplicate checks</p>
+</li>
+<li>
+<p>VIS for visibility checks (public, private, export, etc.)</p>
+</li>
+<li>
+<p>STR for issues related only applied in strict mode</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>examples</p>
+<div class="ulist">
+<ul>
+<li>
+<p><code>IMP_AMBIGUOUS</code></p>
+</li>
+<li>
+<p><code>VIS_ILLEGAL_MEMBER_ACCESS</code></p>
+</li>
+<li>
+<p><code>CLF_ABSTRACT_FINAL</code></p>
+</li>
+<li>
+<p><code>AST_RESERVED_IDENTIFIER</code></p>
+</li>
+<li>
+<p><code>VCO_HEXINT_CONVERT_EMPTY_STR</code></p>
+</li>
+<li>
+<p><code>TYS_NO_SUBTYPE</code></p>
+</li>
+</ul>
+</div>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:validation_usage_patterns"><a class="anchor" href="#sec:validation_usage_patterns"></a><a class="link" href="#sec:validation_usage_patterns">10.4. Usage Pattern</a></h3>
+<div class="paragraph">
+<p>Due to the different places and circumstances a real unification of the API wasn’t possible yet (and wouldn’t have made sense), so there are these different usage patterns</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>in a custom error aware EObjectDescription like WrongFieldAccessorDescription you just return the issue code in getIssueCode and the message created using the issue code as well as the replacements for the wildcards in getMessage</p>
+</li>
+<li>
+<p>in a validator extending AbstractDeclarativeValidator you just call <code>addIssue(message, context, EFeature, issueCode)</code>. The message you have to create before by calling the corresponding <code>getMessageFor[ISSUE_ID]</code> method passing the required wildcard replacement</p>
+</li>
+<li>
+<p>in the ASTStructureValidator you have to call <code>producer.addDiagnostic(new DiagnosticMessage(IssueCodes.messageFor[ISSUE_ID](wildcard1, wildcard2, ..), IssueCodes.getDefaultSeverity(IssueCodes.[ISSUE_ID]), IssueCodes.[ISSUE_ID]))</code></p>
+</li>
+<li>
+<p>in the custom value converters you have to pass the information to an exception, so the call is: <code>new N4JSValueConverterException(IssueCodes.getMessageFor[ISSUE_ID](wildcard1, wildcard2, ..), IssueCodes.[ISSUE_ID], node, null)</code>. Beside this exception also N4JSValueConverterWithValueException is used in some places. In N4JSLinker then these exceptions are catched and a DiagnosticMessage is created out of the informations contained in these exceptions.</p>
+</li>
+<li>
+<p>As Xsemantics uses hard wired error or warning in its grammar you cannot adapt these places, but there are currently only three messages produced by Xsemantic (cannot type, not a sub type, null object passed to system). They are all handled in N4JSTypeValidator.createError where the message from Xsemantic is split up in its parts and then passed as wild card replacements to e.g. <code>IssueCodes.getMessageForTYS_NO_SUBTYPE</code>.</p>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect2">
+<h3 id="sec:validation_links"><a class="anchor" href="#sec:validation_links"></a><a class="link" href="#sec:validation_links">10.5. Links</a></h3>
+<div class="ulist">
+<ul>
+<li>
+<p><a href="http://www.eclipse.org/Xtext/documentation.html#validation">Xtext Runtime Concepts: Validation</a></p>
+</li>
+<li>
+<p><a href="http://blog.dietmar-stoll.de/2013/04/multiple-validators-in-xtext.html">Multiple validators in Xtext</a></p>
+</li>
+<li>
+<p>Customize error messages</p>
+<div class="ulist">
+<ul>
+<li>
+<p><a href="http://zarnekow.blogspot.de/2010/06/customizing-error-messages-in-xtext-10.html">Customizing error messages in Xtext</a></p>
+</li>
+<li>
+<p><a href="http://blog.dietmar-stoll.de/2012/07/custom-syntax-error-messages-with-quick.html">Custom syntax error messages with quickfix</a></p>
+</li>
+<li>
+<p><a href="http://stackoverflow.com/questions/14526524/xtext-customizing-error-msg-by-unordered-groups">Xtext: customizing error messages by unordered groups</a></p>
+</li>
+</ul>
+</div>
+</li>
+</ul>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_references"><a class="anchor" href="#_references"></a><a class="link" href="#_references">11. References</a></h2>
+<div class="sectionbody">
+<div class="admonitionblock warning">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-warning" title=""></i>
+</td>
+<td class="content">
+This chapter maybe outdated.
+</td>
+</tr>
+</table>
+</div>
+<div class="sect2">
+<h3 id="sec:usecases"><a class="anchor" href="#sec:usecases"></a><a class="link" href="#sec:usecases">11.1. Use cases</a></h3>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Compilation
+</td>
+<td class="hdlist2">
+<p>for deciding in incremental builder which resources requires a recompilation</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Editing
+</td>
+<td class="hdlist2">
+<p>Dirty state calculation: for deciding which resources needs to be reparsed as references have changed</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+UI
+</td>
+<td class="hdlist2">
+<p>Such as <kbd>Find references</kbd>, find all places in the workspaces that points to the selected element</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Tools
+</td>
+<td class="hdlist2">
+<p>requiring references, such as refactorings, e.g., rename refactoring: apply the renaming of the element also to all references to it (like find by references)</p>
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:calculation_algorithm"><a class="anchor" href="#sec:calculation_algorithm"></a><a class="link" href="#sec:calculation_algorithm">11.2. Calculation algorithm</a></h3>
+<div class="sect3">
+<h4 id="sec:Xtext_default_implementation"><a class="anchor" href="#sec:Xtext_default_implementation"></a><a class="link" href="#sec:Xtext_default_implementation">11.2.1. Xtext default implementation</a></h4>
+<div class="paragraph">
+<p>Using Reference Descriptions:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>default implementation contained in method <code>createReferenceDescriptions</code> of <code>o.e.x.resource.impl.DefaultResourceDescriptionStrategy</code></p>
+</li>
+<li>
+<p>iterates over all EReferences of the EClass of the current element</p>
+</li>
+<li>
+<p>navigates all references and resolves them (already done before in DefaultResourceDescription.computeReferenceDescriptions)</p>
+</li>
+<li>
+<p>create reference description objects for all these references</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>In case of N4JS and the types, reference descriptions are also created for references to types model elements (definedType) and for references from Types element to AST.</p>
+</div>
+<div class="paragraph">
+<p>We do not use this default implementation for two reasons:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>expensive</p>
+</li>
+<li>
+<p>Default implementation of reference descriptions only calculates the direct dependencies but not the transitive ones + the calculation of the URIs is very expensive.</p>
+</li>
+</ol>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:N4_implementation"><a class="anchor" href="#sec:N4_implementation"></a><a class="link" href="#sec:N4_implementation">11.2.2. N4JS implementation</a></h4>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>the Xtext default implementation is disabled by let <code>N4JSResourceDescription.computeReferenceDescriptions</code> return an empty list. Also the bound <code>N4JSDescriptionUtils</code> returns an empty list for collectOutgoingReferences</p>
+</li>
+<li>
+<p>Calculating <em>direct references</em> are only done inside <code>N4JSResourceDescription.getImportedNames</code> (that uses newly introduced <code>N4JSCrossReferenceComputer.computeCrossRefs</code> for collecting all direct dependencies) - here only (parameterized) type refs, types and identifiable elements are collected</p>
+</li>
+<li>
+<p>collect all <em>transitive dependencies</em>, i.e. all super classes, consumed roles and implemented interfaces in the type hierarchy and add their resources as dependency (this is done in <code>N4JSResourceDescription.getImportedNames</code> (after calculating all direct dependencies with <code>N4JSResourceDescriptionStrategy</code>)</p>
+</li>
+<li>
+<p>bind <code>N4JSReferenceQueryExecutor</code> as a custom implementation to calculate the target URIs for an given target element and bind <code>N4JSReferenceFinder</code> as a custom implementation to calculate reference descriptions to be used by the default Xtext found references UI (use case UI)</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p><code>ClusteringBuilderState.doUpdate</code> calculates if a dependent resource has changed (in the context of calculating the <code>DefaultResourceDescriptionDelta</code> out of the old and new resource descriptions). Each resource description consists of <code>EObjectDescriptions</code>. The <code>EObjectDescription</code> for <code>Script</code> also contains the types model (<code>TModule</code>) for the resource. The references between resources are implemented via the type model. If it has changed (compared with the user data of the old <code>EObjectDescription</code>) then all other resource descriptions registered as been dependent on the resource (the qualified names of the resource descriptions are serialized as imported names within the resource description) will be notified that a reparse is needed.</p>
+</div>
+<div class="paragraph">
+<p>For <em>dirty state</em> the same behavior is achieved via the dirty state editor support using the resource set of the editor (instead the file system resources).</p>
+</div>
+<div class="paragraph">
+<p>As the primitive and built-in types are fixed they are ignored when calculating the dirty state. When calculating dependending resources and dirty state the reference of an AST element to its defining type is ignored as is the reference from the type to its AST element</p>
+</div>
+<div class="paragraph">
+<p><a href="#fig:cd_classes">Classes</a> shows the different entry points (user actions) and classes involved in the process.</p>
+</div>
+<div id="fig:cd_classes" class="imageblock center">
+<div class="content">
+<img src="chapters/11_references/images/cd_classes.svg" alt="title-"Reference handling"">
+</div>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:PerformanceOfDependencyCalculation"><a class="anchor" href="#sec:PerformanceOfDependencyCalculation"></a><a class="link" href="#sec:PerformanceOfDependencyCalculation">11.3. Performance Of Dependency Calculation</a></h3>
+<div class="paragraph">
+<p>Concerning frequency and contexts it is clear, that triggering <code>Find references</code> and rename refactoring is not as frequent as editing (n4)js files that leads to dirty state (very often as happens when editing) and to trigger compilation (at file save, also often). Calculating if a resource is affected by a change (dirty state calculation) may not be too expensive. But running compilation for too many files (or the wrong set of files) due to incorrect dirty state calculation is expensive.</p>
+</div>
+<div class="paragraph">
+<p><code>N4JSResourceDescription.getImportedNames</code> is invoked on every edit of a file in the editor, so on every edit the complete content has to be retraversed for possible new references (expensive but not avoidable). For the types of all found references the super types have to recalculated. Traversing the type hierarchy shouldn’t be too expensive.</p>
+</div>
+<div class="paragraph">
+<p>Possible optimization could be:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>caching of traversing referenced types whose resources had not changed since last edit</p>
+</li>
+<li>
+<p>not traversing types that are imported but non of their features are used within the current resource</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p><em>Those optimization should be done only if there are real performance issues are discovered.</em></p>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:kinds_of_references"><a class="anchor" href="#sec:kinds_of_references"></a><a class="link" href="#sec:kinds_of_references">11.4. Kinds of references</a></h3>
+<div class="sect3">
+<h4 id="sec:Cross_References_to_be_ignored"><a class="anchor" href="#sec:Cross_References_to_be_ignored"></a><a class="link" href="#sec:Cross_References_to_be_ignored">11.4.1. Cross References to be ignored</a></h4>
+<table class="tableblock frame-all grid-all spread">
+<colgroup>
+<col style="width: 33.3333%;">
+<col style="width: 33.3333%;">
+<col style="width: 33.3334%;">
+</colgroup>
+<thead>
+<tr>
+<th class="tableblock halign-left valign-top">Element</th>
+<th class="tableblock halign-left valign-top">Reference</th>
+<th class="tableblock halign-left valign-top">Explanation</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">TypeDefiningElement</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">definedType: Type</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">always inner resource change (e.g., Functions, Classifier)</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">types::Type</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">astElement</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">as always inner resource change</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">ImportDeclaration</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">importedModule: TModule</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">only affected if the resource name changes (and such a change cannot be performed dirty)</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">ContinueStatement</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">label: LabelledStatement</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">always inner resource changes</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">BreakStatement</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">label: LabelledStatement</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">always inner resource changes</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">types::PrimitiveType</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">autocoercedObject: TClassifier</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">fixed (immutable) and internal</p></td>
+</tr>
+</tbody>
+</table>
+</div>
+<div class="sect3 language-n4js">
+<h4 id="sec:Cross_References_to_be_handled"><a class="anchor" href="#sec:Cross_References_to_be_handled"></a><a class="link" href="#sec:Cross_References_to_be_handled">11.4.2. Cross References to be handled</a></h4>
+<div class="paragraph">
+<p>Cross References</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>types::ParameterizedTypeRef &#8594; declaredType : Type</p>
+</li>
+<li>
+<p>* &#8594; N4GetterDeclaration: N4FieldDeclaration type, but references to getter can be done also done from outside</p>
+</li>
+<li>
+<p>* &#8594; N4SetterDeclaration: undef, references to setter can be done also done from outside</p>
+</li>
+<li>
+<p>types::PrototypeTypeRef &#8594; type : Type</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>Contained <code>ParameterizedTypeRef</code> and <code>TypeVariables</code> (that internally references to <code>Type</code>):</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>references to declared super types of a type (Class, Role, Interface), i.e. superType, consumedRoles, implementedInterfaces</p>
+</li>
+<li>
+<p>TypeVariable &#8594; declaredUpperBounds</p>
+</li>
+<li>
+<p>References in type arguments:</p>
+<div class="ulist">
+<ul>
+<li>
+<p>Wildcards &#8594; upper and lower bounds, e.g. <code>var List&lt;? super A&gt; l1;</code></p>
+</li>
+<li>
+<p>direct type references, e.g. <code>var List&lt;A&gt; l;</code></p>
+</li>
+</ul>
+</div>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>Cross References to IdentifiableElement (types):</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>IdentifierRef &#8594; id : IdentifiableElement</p>
+</li>
+<li>
+<p>NamedImportSpecifier &#8594; importedElement : IdentifiableElement</p>
+</li>
+<li>
+<p>ParameterizedPropertyAccessExpression &#8594; property : IdentifiableElement</p>
+</li>
+<li>
+<p>PropertyAccessExpression &#8594; property : IdentifiableElement</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>Contained IdentifierRef (that internally references to IdentifiableElement):</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>ParameterizedCallExpression &#8594; target</p>
+</li>
+<li>
+<p>as PrimaryExpression in MemberExpression</p>
+</li>
+</ol>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="sec:transitive_dependencies"><a class="anchor" href="#sec:transitive_dependencies"></a><a class="link" href="#sec:transitive_dependencies">11.5. Transitive dependencies</a></h3>
+<div class="paragraph">
+<p>Besides the direct dependencies we also need the transitive dependencies, as demonstrated in the following example.</p>
+</div>
+<div id="ex:transdepex" class="listingblock">
+<div class="title">Transitive Dependency</div>
+<div class="content">
+<pre class="highlight"><code class="language-java" data-lang="java">export class A {
+    public myMethod()
+}</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="title">Transitive Dependency pt.2</div>
+<div class="content">
+<pre class="highlight"><code class="language-java" data-lang="java">export class B extends my/test/A {
+}</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="title">Transitive Dependency pt.3</div>
+<div class="content">
+<pre class="highlight"><code class="language-java" data-lang="java">export class C extends my/test/B {
+    myMethodC() {
+        this.myMethod()
+    }
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>If the name of <code>myMethod</code> in A changes, C should get dirty. This can get more complicated, if, e.g., a method in a consumed role is renamed, which then leads to binding references to super types.</p>
+</div>
+<div class="paragraph">
+<p>Therefore all direct and indirect super types are calculated (including super classes, consumed roles and implemented interfaces) for all found directly referenced types. The qualified names of their resources are added to the list of imported names. <sup class="footnote">[<a id="_footnoteref_12" class="footnote" href="#_footnote_12" title="View footnote.">12</a>]</sup></p>
+</div>
+<div class="paragraph">
+<p>Other transitive dependencies:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>call of member mixed by a consumed role</p>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p>role is consumed by role consumed by this class</p>
+</li>
+<li>
+<p>role is consumed by class inherited by this class</p>
+</li>
+</ol>
+</div>
+</li>
+<li>
+<p>call of member available by implemented interface</p>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p>interface is implemented by role consumed by this class</p>
+</li>
+<li>
+<p>interface is implemented by class inherited by this class</p>
+</li>
+</ol>
+</div>
+</li>
+<li>
+<p>call of member available by extended class</p>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p>class is extended by class inherited by this class</p>
+</li>
+</ol>
+</div>
+</li>
+<li>
+<p>chained method calls</p>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p>method is of type that itself has members which are directly called, so the type is not directly imported or referenced by name in the caller but indirectly required</p>
+</li>
+<li>
+<p>method is of type that itself inherits members which are directly called, so the type (and its super types) is not directly imported or referenced by name in the caller but indirectly required</p>
+</li>
+</ol>
+</div>
+</li>
+</ol>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="paragraph">
+<p>Each type is defined in its own file.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-java" data-lang="java">export class MyClassOne  {
+    myMethodOne() {
+        var MyClassTwo instance;
+        instance.getElement().myMethodThree()
+    }
+}</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-java" data-lang="java">export class MyClassTwo  {
+    MyClassThree getElement() {
+        return new MyClassThree;
+    }
+}</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-java" data-lang="java">export class MyClassThree  {
+    void myMethodThree() {}
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>If <code>myMethodThree</code> is renamed this should affect MyClassOne.</p>
+</div>
+<div class="paragraph">
+<p>Note that the method call in <code>MyClassOne</code> directly binds to the method in <code>MyClassThree</code>. However, the dependencies are only managed by means of types. So, from that perspective, the dependency between <code>MyClassOne</code> and <code>MyClassThree</code> is indirect.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-java" data-lang="java">export class MyClassOne  {
+    void myMethodOne() {
+        var MyClassTwo instance;
+        instance.myMethodTwo().getElement().myMethodFour()
+    }
+}</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-java" data-lang="java">export class MyClassTwo {
+    MyClassThree&lt;MyClassFour&gt; myMethodTwo() {
+        return null;
+    }
+}</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-java" data-lang="java">export class MyClassThree&lt;T extends MyClassFour&gt;  {
+    T element;
+
+    T getElement() {
+        return this.element;
+    }
+}</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-java" data-lang="java">export class MyClassFour  {
+    void myMethodFour() {
+    }
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>If <code>myMethodFour</code> is renamed this should affect <code>MyClassOne</code>.</p>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>More examples are found in the tests (cf. <code>..ide.n4js.dirtystate.BuilderParticipantPluginTest</code> and <code>&#8230;&#8203;BuilderParticipantPluginUITest</code>)</p>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:find-references"><a class="anchor" href="#sec:find-references"></a><a class="link" href="#sec:find-references">11.6. Find references</a></h3>
+<div class="paragraph">
+<p>Find references is perceived as a feature in Eclipse IDE, but its implementation can also be useful in a headless scenario, e.g. in the compiler to drop dead code.
+Therefore, as opposed to the Xtext default implementations, the code was refactored to split the parts that depend on the UI from the non-UI dependent logic (see <code>org.eclipse.n4js.findReferences</code> vs. <code>org.eclipse.n4js.ui.search</code>).</p>
+</div>
+<div class="sect3">
+<h4 id="_background"><a class="anchor" href="#_background"></a><a class="link" href="#_background">11.6.1. Background</a></h4>
+<div class="paragraph">
+<p>Since no reference descriptions are stored in the index for N4JS resources, the cross references have to be found by other means.
+That is, the list of imported names is used as an indicator to find resources that have a potential dependency to the searched element.
+These resources have to be checked thoroughly.
+That is, their clear text representation is checked at a first step against the clear text representation of the found element before the resource is fully loaded and cross references are resolved.</p>
+</div>
+<div class="paragraph">
+<p>The decision to drop reference descriptions from the index was deliberate since they would only report bogus information in the context of inheritance, e.g. a method <code>getA</code> of type <code>B</code> my be overridden by <code>getA</code> in type <code>C</code>.
+Concrete bindings against <code>C.getA</code> should also be reported as references to <code>B.getA</code> since they identify the same public API of the type hiearchy around <code>B</code>.
+Therefore reference descriptions could not be used to find dependencies between source snippets.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_how-find-references-work"><a class="anchor" href="#_how-find-references-work"></a><a class="link" href="#_how-find-references-work">11.6.2. How Find References Work</a></h4>
+<div class="paragraph">
+<p>Methods for finding references are provided Xtext&#8217;s interface <code>IReferenceFinder</code> and can be used both by the UI or headlessly.
+The N4JS implementation of this interface for the N4JS language is the class <code>ConcreteSyntaxAwareReferenceFinder</code>.
+One of the key methods defined by the <code>IReferenceFinder</code> is <code>void findAllReferences(TargetURIs, IResourceAccess, IResourceDescriptions, Acceptor, IProgressMonitor)</code> that finds all places in all resources of the index whereby those places cross-reference one of the URIs contained in <code>TargetURIs</code> .</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>TargetURIs</code> contains the set of URIs to be searched. The caller of <code>IReferenceFinder</code> is responsible for collecting the <code>Target URIs</code> to be searched.</p>
+</li>
+<li>
+<p><code>IResourceAccess</code> is used to search local references. This is needed because local references are usually not index.</p>
+</li>
+<li>
+<p><code>IResourceDescriptions</code> is the indexed.</p>
+</li>
+<li>
+<p><code>Acceptor</code> is called when a reference is found.</p>
+</li>
+<li>
+<p><code>IProgressMonitor</code> is used for showing progress bar (can be null).</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>In the following, we will have a look at the workflow to find references when triggered in the UI.
+After understanding the UI case, the workflow of find references in the headless case should be self-explanatory.</p>
+</div>
+<div class="paragraph">
+<p><a href="#fig:findreference_workflow">Find reference workflow</a> shows the workflow of find references when triggered in the UI.</p>
+</div>
+<div id="fig:findreference_workflow" class="imageblock center">
+<div class="content">
+<img src="chapters/11_references/images/findreference_workflow.svg" alt="title-"Find reference workflow"">
+</div>
+</div>
+<div class="paragraph">
+<p>The following example will be used for explanation.</p>
+</div>
+<div class="listingblock">
+<div class="title">A.n4js</div>
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">import {B} from "B";
+let b = new B(); // B here is an IdentifierRef referring to TClass B in B.n4js</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="title">B.n4js</div>
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">export public class B {}</code></pre>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_step-1-convert-cursor-position-to-declared-element"><a class="anchor" href="#_step-1-convert-cursor-position-to-declared-element"></a><a class="link" href="#_step-1-convert-cursor-position-to-declared-element">11.6.2.1. Step 1: Convert Cursor Position to Declared Element</a></h5>
+<div class="paragraph">
+<p>This step is represented by the purple color in <a href="#fig:findreference_workflow">Find reference workflow</a> diagram.</p>
+</div>
+<div class="paragraph">
+<p>In the IDE, for the sake of convenience, we allow the user to find references of an arbitrary element at the current cursor.
+For instance, while the cursor is currently at <code>IdentifierRef B</code> in the <code>NewExpression</code> in <code>A.n4js</code>, the user may want to find all references to <code>B</code>.
+In those cases, we first need to find declaration element of <code>IdentifierRef B</code> which is <code>TClass B</code>. The Target URIs then contains a single URI to <code>TClass B</code>.
+In diagram <a href="#fig:findreference_workflow">Find reference workflow</a>, the classe <code>EObjectAtOffsetHelper</code> can convert the current cursor position into a declared element.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_step-2-convert-declared-element-to-target-uris"><a class="anchor" href="#_step-2-convert-declared-element-to-target-uris"></a><a class="link" href="#_step-2-convert-declared-element-to-target-uris">11.6.2.2. Step 2: Convert Declared Element to Target URIs</a></h5>
+<div class="paragraph">
+<p>This step is represented by the yellow color in <a href="#fig:findreference_workflow">Find reference workflow</a> diagram.</p>
+</div>
+<div class="paragraph">
+<p>The Target URIs contains the URIs whose references are to be searched.
+The caller guarantees that <em>Target URIs contain only URIs to declared elements, i.e. definitions</em>.
+For example, if we want to find references for <code>N4ClassDeclaration B</code> in <code>B.n4js</code>, the target URIs contains a URI to the AST node <code>N4ClassDeclaration B</code> and a URI to the TModule node <code>TClass B</code>.
+Note that, in addition to the URI to the AST node <code>N4ClassDeclaration B</code>, the URI to the derived TModule node <code>TClass B</code> is also needed because <code>N4ClassDeclaration</code> can never be a target of a cross reference.
+In the diagram <a href="#fig:findreference_workflow">Find reference workflow</a> , the classes depicted in yellow color are responsible for converting declared elements to <code>Target URIs</code> taking care of the derived <code>TModule</code> nodes.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_step-3-filter-potential-resources"><a class="anchor" href="#_step-3-filter-potential-resources"></a><a class="link" href="#_step-3-filter-potential-resources">11.6.2.3. Step 3: Filter Potential Resources</a></h5>
+<div class="paragraph">
+<p>This step is represented by the green color in <a href="#fig:findreference_workflow">Find reference workflow</a> diagram.</p>
+</div>
+<div class="paragraph">
+<p>The general algorithm for finding references is to traverse the AST of each resource in the index and check each AST node if it has a cross reference to one of the URI in the <code>Target URIs</code>.
+However, this is too expensive because potentially all resources in the index have to be loaded.
+We need some way to quickly decide for a resource description if the corresponding resource may potentially contain the references before actually loading it for a more thorough search.
+This is done using two pieces of information:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>typesOrModulesToFind</code>: the set containing the fully qualified names of the <code>type</code> and <code>module</code> of the declaration to be searched. This set is calculated in the class <code>TargetURIKey</code>.</p>
+</li>
+<li>
+<p><code>imported names</code>: the set exposed by <code>ResourceDescription</code> that contains the types needed by the underlying resource. The implementation for calculating imported names can be found in the class <code>N4JSResourceDescription</code>.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>In our example, supposed that we are finding references for <code>class B</code>. The <code>typesOrModulesToFind</code> contains fully qualified names to <code>N4ClassDeclaration B</code> and <code>module B</code>, i.e. <code>B.B</code> and <code>B</code>.
+The <code>imported names</code> of the resource description of <code>A.n4js</code> contains fully qualified names to <code>module B</code>, <code>class B</code>, i.e. <code>B</code> and <code>B.B</code>.
+Since the set of imported names of <code>A.n4js</code> contains elements in <code>typesOrModulesToFind</code>, this resource is searched thoroughly for references.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_step-4-search-references-in-resource"><a class="anchor" href="#_step-4-search-references-in-resource"></a><a class="link" href="#_step-4-search-references-in-resource">11.6.2.4. Step 4: Search References in Resource</a></h5>
+<div class="paragraph">
+<p>If a resource is considered as a candidate for a more thorough search in Step 3, it is loaded.
+Its AST is traversed and at each AST node we check if there is a cross reference to one of the Target URIs (Step 1).
+If yes, the AST node is collected in the set of found references.
+See class <code>ConcreteSyntaxAwareReferenceFinder</code> for implementation details.</p>
+</div>
+<div class="paragraph">
+<p>The UI dependent logic may apply additional filters to drop references that are not relevant to the user, e.g. the reference from an AST element to its inferred type and vice versa (see <code>N4JSReferenceQueryExecutor.isToBeIgnored(EReference)</code>).</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_limitations-and-possible-enhancements"><a class="anchor" href="#_limitations-and-possible-enhancements"></a><a class="link" href="#_limitations-and-possible-enhancements">11.6.2.5. Limitations and Possible Enhancements</a></h5>
+<div class="paragraph">
+<p>Other noteworthy limitations and potential enhancements of the current implementations are:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Semantics: Only references that are available in the model as real references are reported. Even though <code>getB()</code> in <code>myA.getB().getC()</code> may return an instance of type <code>B</code>, there is no reference reported to B in that expression, though a reference to a member of B would be reported for <code>getC</code>.</p>
+</li>
+<li>
+<p>Visibility constraints are not applied and thus do not reduce the search scope to allow the report of invalidly established references in a later validation.</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_compilation"><a class="anchor" href="#_compilation"></a><a class="link" href="#_compilation">12. Compilation</a></h2>
+<div class="sectionbody">
+<div class="admonitionblock warning">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-warning" title=""></i>
+</td>
+<td class="content">
+This chapter may be outdated.
+</td>
+</tr>
+</table>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="chap:compilation"><a class="anchor" href="#chap:compilation"></a><a class="link" href="#chap:compilation">12.1. Introduction</a></h3>
+<div class="paragraph">
+<p>Compilation is the process of transforming some source code written by means of a human readable text into a machine readable target file, i.e. bytecode or assembler. However, in the context of N4JS, the target output is not machine code but another high-level programming language. This kind of compiler transforming from one programming language to another is called <em>transpiler</em>, as a combination of <code>transformation</code> and <code>compiler</code>. The design of the transpiler takes this special setup into account.</p>
+</div>
+<div class="sect3">
+<h4 id="sec:general_design_rationals"><a class="anchor" href="#sec:general_design_rationals"></a><a class="link" href="#sec:general_design_rationals">12.1.1. General design rationals</a></h4>
+<div class="sect4">
+<h5 id="sec:logging_and_error_reporting"><a class="anchor" href="#sec:logging_and_error_reporting"></a><a class="link" href="#sec:logging_and_error_reporting">12.1.1.1. Logging and error reporting</a></h5>
+<div class="paragraph">
+<p>The generator always expects to get a valid model as an input. So all syntactic and semantic errors (not warnings) in the N4JS code as well as regarding the project configuration, e.g. in the package.json file, should be already discovered in the validation step. So any error marker on the resource will prevent the compiler to run.</p>
+</div>
+<div class="paragraph">
+<p>In case of other errors arising in the generator, the error handling is done as follows:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>either throw an <code>GeneratorException</code> or better call <code>ExceptionHandler.handleError(message)</code> (that then will throw this exception)</p>
+</li>
+<li>
+<p>beside the message also the file and the current line can be passed to <code>GeneratorException</code></p>
+</li>
+<li>
+<p><code>GeneratorException</code> (as extending RuntimeException) will be handled by the generator caller</p>
+<div class="ulist">
+<ul>
+<li>
+<p>in UI: <code>BuildInstruction</code> will create an error log entry</p>
+</li>
+<li>
+<p>headless: lets the <code>GeneratorException</code> fail</p>
+</li>
+</ul>
+</div>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:progress_monitor"><a class="anchor" href="#sec:progress_monitor"></a><a class="link" href="#sec:progress_monitor">12.1.1.2. Progress monitor</a></h5>
+<div class="paragraph">
+<p>The compiler works on a single file and we do not expect that to take much time. Processors working on many files, such as linkers (in the JavaScript context, that is minification and concatenation), are different components.</p>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Xtext_Integration"><a class="anchor" href="#sec:Xtext_Integration"></a><a class="link" href="#sec:Xtext_Integration">12.1.2. Xtext Integration</a></h4>
+<div class="sect4">
+<h5 id="sec:xtext_default_behaviour"><a class="anchor" href="#sec:xtext_default_behaviour"></a><a class="link" href="#sec:xtext_default_behaviour">12.1.2.1. Xtext default behaviour</a></h5>
+<div class="paragraph">
+<p>The Xtext builder participant calculates the delta for every change in the project and triggers dirty state handling as well as code generation. By default the builder participant expects exactly one implementation bound to the IGenerator interface and thus only one output configuration provider belonging to this generator.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:n4js_requirements"><a class="anchor" href="#sec:n4js_requirements"></a><a class="link" href="#sec:n4js_requirements">12.1.2.2. N4JS requirements</a></h5>
+<div class="paragraph">
+<p>In constrast to the default Xtext behaviour in the N4JS IDE allows</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>the registration / discovery of multiple generators (including compilers and transpilers) but even no compiler at all, so that it is possible to ship the IDE also without any generators</p>
+</li>
+<li>
+<p>to configure these generators separately (output paths and so on) workspace globally but also project specific (currently it is only required to enable / disable a compiler)</p>
+</li>
+<li>
+<p>to enable / disable generators, but it is allowed to enable more than one compiler at one</p>
+</li>
+<li>
+<p>to start compilers headless, i.e. e.g in automated build / JUnit tests but with the possibility to configure them there as well</p>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:compiler_discovery_in_ui"><a class="anchor" href="#sec:compiler_discovery_in_ui"></a><a class="link" href="#sec:compiler_discovery_in_ui">12.1.2.3. Compiler discovery in UI</a></h5>
+<div class="ulist">
+<ul>
+<li>
+<p>There is a singleton <code>ICompositeGenerator</code>. The <code>ICompositeGenerator</code> instance itself doesn’t contain generator logic but knows subgenerators (that implement <code>ISubGenerator</code>) to which it delegates the input file (so instead of registering a new builder participant (that then would have to recalculate the delta) only the generator call is extracted)</p>
+</li>
+<li>
+<p>In the UI case, the actual execution of the registered generator is done in <code>BuildInstruction</code> where every N4JS resource contained in the delta calculated by the builder participant is an <code>ICompositeGenerator</code> implementation.</p>
+</li>
+<li>
+<p><a href="#fig:cd_GeneratorAndBuilderParticipant">Builder (UI) and Generator (Core)</a> summarizes the implementation of this compiler infrastructure in the UI case.</p>
+</li>
+</ul>
+</div>
+<div id="fig:cd_GeneratorAndBuilderParticipant" class="imageblock center">
+<div class="content">
+<img src="chapters/13_compilation/images/cd_GeneratorAndBuilderParticipant.svg" alt="cd GeneratorAndBuilderParticipant">
+</div>
+<div class="title">Figure 25. Builder (UI) and Generator (Core)</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:compiler_discovery_in_headless"><a class="anchor" href="#sec:compiler_discovery_in_headless"></a><a class="link" href="#sec:compiler_discovery_in_headless">12.1.2.4. Compiler discovery in headless</a></h5>
+<div class="ulist">
+<ul>
+<li>
+<p><code>N4JSHeadlessStandaloneSetup</code> is used to combine <code>N4JSRuntimeModule</code> and <code>N4JSHeadlessGeneratorModule</code> so there is <code>PropertiesFileBasedValuesProvider</code> is bind as implementation for <code>IPreferenceValuesProvider</code></p>
+</li>
+<li>
+<p>via <code>N4JSHeadlessStandaloneSetup</code> the injector is created which is used to create an instance of <code>ICompositeGenerator</code></p>
+</li>
+<li>
+<p>in the headless mode the subgenerators of are manually registered via an extension point in the class <code>HeadlessExtensionRegistrationHelper</code>.</p>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:general_generator_implementation"><a class="anchor" href="#sec:general_generator_implementation"></a><a class="link" href="#sec:general_generator_implementation">12.1.2.5. General generator implementation</a></h5>
+<div class="exampleblock">
+<div class="title">Example 1. Simple IGenerator</div>
+<div class="content">
+<div class="paragraph">
+<p>The following snippet shows a minimal generator example.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">public class Generator implements IGenerator {
+    @Override public void doGenerate(Resource resource, IFileSystemAccess fsa) {
+        final String filename = computeTargetFileName(resource.getURI());
+
+        Script script = IterableExtensions.&lt;Script&gt; head(
+            Iterables.&lt;Script&gt; filter(resource.getContents(), Script.class));
+
+        fsa.generateFile(filename, doCompileToString(script));
+    }
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Generation is triggered for each Xtext resource. <code>IFileSystemAccess</code> is an abstraction of where to write the generated artefacts. This enables using the generator in the IDE (with a workspace) and headless (directly operating on files). In tests you can use <code>InMemoryFileAccess</code>, in standalone mode you should use <code>JavaFileSystemAccess</code> and in Eclipse mode <code>EclipseFileSystemAccess2</code></p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:general_generator_activation"><a class="anchor" href="#sec:general_generator_activation"></a><a class="link" href="#sec:general_generator_activation">12.1.2.6. General generator activation</a></h5>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Programmatically
+</td>
+<td class="hdlist2">
+<p>Invoke the <code>IComposedGenerator.doGenerate</code> with a loaded N4JS resource and a configured <code>IFileSystemAccess</code> implementation.</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Xtext Builder
+</td>
+<td class="hdlist2">
+<p>This is available by default when using the bound <code>IGenerator</code>, it runs on every change of your N4JS resource when automatic build is enabled in the workspace.</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Context Menu
+</td>
+<td class="hdlist2">
+<p>see <a href="christiandietrich.wordpress.com/2011/10/15/xtext-calling-the-generator-from-a-context-menu/">Christian Dietrich’s Blog 2011/10/15</a></p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+MWE2 Workflow
+</td>
+<td class="hdlist2">
+<p>via <code>org.eclipse.xtext.generator.GeneratorComponent</code> that is configured with the standalone setup of the N4JS language. Such an MWE2 workflow also requires the <code>org.eclipse.xtext.mwe.Reader</code> component to first load the N4JS resources to transform in a model slot that is then consumed by the GeneratorComponent</p>
+</td>
+</tr>
+</table>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Overview_of_Input_Models"><a class="anchor" href="#sec:Overview_of_Input_Models"></a><a class="link" href="#sec:Overview_of_Input_Models">12.1.3. Overview of the Input Models</a></h4>
+<div class="paragraph">
+<p>The input is a simple instance of <code>Script</code>, which is the root model element for all N4JS files. Actually, it is the root of the AST. For the AST elements, other elements stemming from other models are accessible as well. The following models may be important for the compiler:</p>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+N4JS AST
+</td>
+<td class="hdlist2">
+<p>The abstract syntax tree is an EMF model, it is defined in a single Xcore file <code>N4JS.xcore</code></p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Parser or Node Model
+</td>
+<td class="hdlist2">
+<p>The parser tree, also called node model, is defined by Xtext. It contains offset information, holding whitespaces, line breaks, comments as well as other hidden tokens. It can be accessed via <code>NodelModelUtils</code>, that is a node can be retrieved for a given AST element and vice versa. There are three different kind of nodes: root, composite and leaf node.<br>
+<strong>As of Dec 2015, the transpiler does no longer make use of the parse tree!</strong></p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Type Model
+</td>
+<td class="hdlist2">
+<p>The type model is an abstract view on the N4JS AST. It is defined in a single Xcore file <code>Types.xcore</code>. Not all AST elements are related to type model information. This is only true for subtypes of <code>TypeDefiningElement</code>, with references to <code>Type</code> or containing a <code>TypeRef</code>.</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+N4 Project
+</td>
+<td class="hdlist2">
+<p>via <code>OutputPathHelper</code> located in <code>org.eclipse.n4js.generator</code> wraps the calculation of compiled file path.</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Grammar Model
+</td>
+<td class="hdlist2">
+<p>Grammar Model created from <code>N4JS.xtext</code>, the rules can be access in the Java code via <code>N4JSGrammarAccess</code>. The grammar elements can be retrieved from the parser model vial <code>node.getGrammarElement()</code>. <code>org.eclipse.xtext.GrammarUtil</code> also contains some useful helper methods.<br>
+<strong>As of Dec 2015, the transpiler does no longer make use of the grammar model!</strong></p>
+</td>
+</tr>
+</table>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:Core_Generator"><a class="anchor" href="#sec:Core_Generator"></a><a class="link" href="#sec:Core_Generator">12.2. Generators</a></h3>
+<div class="paragraph">
+<p>Generators are an abstraction above that of transpilers. N4JS transpilers are implemented as specific generators, but there might be other generators that are not transpilers (e.g. generator that produces HTML documentation from the jsdoc in the N4JS source files).</p>
+</div>
+<div class="sect3">
+<h4 id="sec:Compiler_Components"><a class="anchor" href="#sec:Compiler_Components"></a><a class="link" href="#sec:Compiler_Components">12.2.1. Generator Components</a></h4>
+<div class="paragraph">
+<p><a href="#fig:comp_compilers">Compiler Components</a> gives an overview over the compiler related components. Some of these components are described in detail in the following sections.
+As of Dec 2017, the generator architecture has been refactored and simplified.</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>There is only a single <code>ICompositeGenerator</code> instance. Since the single instance should simply delegate to subgenerators, composite generators can no longer be registered via extension point.</p>
+</li>
+<li>
+<p>Most of generator related code is moved into <code>org.eclipse.n4js</code> bundle. This is needed because we need to bind <code>ICompositeGenerator</code> to a concrete implementation in the <code>org.eclipse.n4js</code> bundle and the extension point for <code>ICompositeGenerator</code> has been removed.</p>
+</li>
+<li>
+<p>An extension point <code>org.eclipse.n4js.generator.subgenerator</code> is introduced in the <code>org.eclipse.n4js</code> bundle. This makes it possible to register a new subgenerator via extension point.</p>
+</li>
+</ul>
+</div>
+<div id="fig:comp_compilers" class="imageblock center">
+<div class="content">
+<img src="chapters/13_compilation/images/comp_compilers.svg" alt="comp compilers">
+</div>
+<div class="title">Figure 26. Compiler Components</div>
+</div>
+<div class="paragraph">
+<p><a href="#fig:od_generatorInjection">Discovering generators and provide them with Guice bindings.</a> shows how composite generator and subgenerators interact with other components both in the UI and in the headless case.</p>
+</div>
+<div id="fig:od_generatorInjection" class="imageblock center">
+<div class="content">
+<img src="chapters/13_compilation/images/od_generatorInjection.svg" alt="od generatorInjection">
+</div>
+<div class="title">Figure 27. Discovering generators and provide them with Guice bindings.</div>
+</div>
+<div class="paragraph">
+<p>As we can see in the diagram above. In the UI case, <code>N4JSBuilderParticipant</code> creates <code>BuildInstruction</code> which in turn delegates the generation logics to an instance of <code>ICompositeGenerator</code>. The <code>ICompositeGenerator</code> simply delegates the generation logics to subgenerators .</p>
+</div>
+<div class="paragraph">
+<p>In the headless mode, <code>n4jscBase.doMain</code> creates an instance of <code>N4JSStandaloneSetup</code> and obtains the injector from there. This injector is then used to create an instance of <code>ICompositeGenerator</code> in <code>N4HeadlessCompiler</code>.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Generator_architecture"><a class="anchor" href="#sec:Generator_architecture"></a><a class="link" href="#sec:Generator_architecture">12.2.2. Generator architecture</a></h4>
+<div class="paragraph">
+<p>The compiler has to create different compilation targets, e.g., for web applications running in a browser (Chrome), or for applications running on iOS using the JavaScriptCore framework <sup class="footnote">[<a id="_footnoteref_13" class="footnote" href="#_footnote_13" title="View footnote.">13</a>]</sup>. Other scenarios may include code created for debugging purposes vs. optimized code, although this may be implementable via configuration switches as well.</p>
+</div>
+<div class="paragraph">
+<p><a href="#fig:cd_SubGenerators">Generator and sub-generators</a> shows the main generator classes, including two sub generators for EcmaScript code and EcmaScript on iOS.</p>
+</div>
+<div id="fig:cd_SubGenerators" class="imageblock center">
+<div class="content">
+<img src="chapters/13_compilation/images/cd_SubGenerators.svg" alt="cd SubGenerators">
+</div>
+<div class="title">Figure 28. Generator and sub-generators</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Unified_Compiler_Configuration"><a class="anchor" href="#sec:Unified_Compiler_Configuration"></a><a class="link" href="#sec:Unified_Compiler_Configuration">12.2.3. Unified Compiler Configuration</a></h4>
+<div class="paragraph">
+<p>Since the compiler is to be used in both UI and headless (or CLI) mode, the configuration has to abstract from Eclipse <code>IPreferenceStore</code> concept or CLI utility classes. This is done with the combination of <code>CompilerDescriptor</code> and <code>CompilerProperties</code>, used by all <code>ISubGenerator</code> implementations (see <a href="#fig:cd_SubGenerators">Fig. Sub Generators</a>).</p>
+</div>
+<div class="paragraph">
+<p>Each compiler provides</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>a unique name (that have to match with the name of the output configuration)</p>
+</li>
+<li>
+<p>a default compiler descriptor that contains the preference values to be applied when nothing else been configured in the provided preference values</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>A <code>CompilerDescriptor</code> has</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>an identifier (this is the unique name of the compiler as mentioned before)</p>
+</li>
+<li>
+<p>a name (a readable name to used in Eclipse preference page)</p>
+</li>
+<li>
+<p>a description (not used yet, but maybe later also shown in the preference page)</p>
+</li>
+<li>
+<p>a flag, that indicates, if this generator should run by default</p>
+</li>
+<li>
+<p>the file extension to be used for the compiled file</p>
+</li>
+<li>
+<p>the <code>OutputConfiguration</code> object from Xtext that contains output related preferences like the output folder</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>The <code>CompilerProperties</code> is an enumeration that makes it easier to iterate over the preferences and getting / setting the preference values in a generic way. So this enumeration contains all configurable properties as literals.</p>
+</div>
+<div class="paragraph">
+<p>The keys for preferences have to follow a fixed pattern as it also used internally by the builder participant when applying the configurations from the <code>OutputConfiguration</code>. So the key consists of</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>’outlet’</p>
+</li>
+<li>
+<p>unique name of the compiler = unique name of the output configuration</p>
+</li>
+<li>
+<p>the name of the property</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Example: outlet.es5.compiledFileExtension</p>
+</div>
+<div class="paragraph">
+<p><code>N4JSPreferenceAccess</code> encapsulates the access to the injected <code>IPreferenceValuesProvider</code>. This values provider is bound in UI to <code>EclipsePreferencesProvider</code> that creates an overlay over the default configuration and makes it so possible to have workspace global as well as project specific preferences and always as fall back the default values.</p>
+</div>
+<div class="paragraph">
+<p>In headless mode the <code>PropertiesFileBasedValuesProvider</code> is bound as implementation of <code>IPreferenceValuesProvider</code>. With this implementation it is possible to load the preferences from a provided properties file.</p>
+</div>
+<div class="paragraph">
+<p><code>N4JSPreferenceAccess</code> is used in <code>AbstractSubGenerator</code> which provided the most common used preferences as extra methods.</p>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:Transpilers"><a class="anchor" href="#sec:Transpilers"></a><a class="link" href="#sec:Transpilers">12.3. Transpilers</a></h3>
+<div class="paragraph">
+<p>Transpilers are a special case of generators, used for transforming N4JS source code into some target code in some other, high-level programming language. In this section we describe the general transpiler infrastructure without considering any particular transpiler. Currently, there is only a single such concrete transpiler for ECMAScript target code, explained later in <a href="#sec:N4JS_to_EcmaScript_Transpiler">N4JS-to-EcmaScript Transpiler</a>.</p>
+</div>
+<div class="paragraph">
+<p>All code of the general transpiler infrastructure is found in bundle <code>org.eclipse.n4js.transpiler</code>.</p>
+</div>
+<div class="sect3">
+<h4 id="sec:Phases"><a class="anchor" href="#sec:Phases"></a><a class="link" href="#sec:Phases">12.3.1. Overview</a></h4>
+<div class="paragraph">
+<p><a href="#fig:ad_PipelineOverview">Overview of the compilation pipeline</a> shows an overview of the steps during transpilation of a single resource:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>an initial conversion from the original AST to an <strong>intermediate model (IM)</strong>, called <strong>preparation step</strong>.</p>
+</li>
+<li>
+<p>one or more <strong>transformation</strong> phases, each taking as input the IM and performing a number of in-place modification on it.</p>
+</li>
+<li>
+<p>a final <strong>pretty printing step</strong> that transform the final version of the IM into the textual output, i.e. the target code.</p>
+</li>
+</ol>
+</div>
+<div id="fig:ad_PipelineOverview" class="imageblock center">
+<div class="content">
+<img src="chapters/13_compilation/images/ad_PipelineOverview.svg" alt="ad PipelineOverview">
+</div>
+<div class="title">Figure 29. Overview of the compilation pipeline</div>
+</div>
+<div class="paragraph">
+<p>The IM is the most important data structure in the transpiler. It starts out as a 1-to-1 copy of the original AST and is then gradually transformed by the AST transformation steps into, ultimately, a representation of the output code. Only the IM undergoes updates, while the original AST remains unchanged. Nodes in the IM that are identical on N4JS source code and target code side can simply be left unchanged. Traceability links allow navigating back to an original AST node from a given IM node, but due to the gradual modification of the IM this might not be possible for all IM nodes (the tracer will return <code>null</code> in those cases.</p>
+</div>
+<div class="paragraph">
+<p>Ideally, each transformation executed during the transformation step should be self-contained and coupling should be reduced to a minimum. Of course, this is not possible in all cases, in practice. Therefore, a simple mechanism is provided for statically specifying dependencies between transformations by way of Java annotations (see Java class <code>TransformationDependency</code> for more details). The ECMAScript transpiler, for example, has 18 individual transformations (at time of writing).</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="relation-between-ast-and-im"><a class="anchor" href="#relation-between-ast-and-im"></a><a class="link" href="#relation-between-ast-and-im">12.3.2. Relation between AST and IM</a></h4>
+<div class="paragraph">
+<p>The relation between the original AST and the IM is maintained by the tracer, see class <code>Tracer</code>, which is available via the transpiler state. The tracer allows to obtain a  IM elements for a given original AST node and, conversely,  original AST nodes for a given IM element (i.e. a 1:N association between original AST node and IM element).</p>
+</div>
+<div class="paragraph">
+<p>The main purpose of this tracing information is to compute source maps for the target code.</p>
+</div>
+<div class="paragraph">
+<p>At the beginning of the transformation step, there is a 1-to-1 correspondence between AST and IM, but over the course of the transformations this correspondence will become more and more blurred. Therefore, whenever using the tracer to get to the original AST from a given IM element , we have to consider the case that there is not original AST node defined for  (because  was created programmatically by an earlier transformation) OR that the original AST node is of a different kind than  (because, maybe, an original N4JS class declaration was replaced by a function declaration by an earlier transformation).</p>
+</div>
+<div class="paragraph">
+<p>Whenever a transformation changes the IM, it is responsible to update the tracer, accordingly.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="implementation-overview"><a class="anchor" href="#implementation-overview"></a><a class="link" href="#implementation-overview">12.3.3. Implementation Overview</a></h4>
+<div class="paragraph">
+<p><a href="#fig:transpilerClassDgr">Transpiler Class Diagram</a> shows a class diagram of the main constituents of the transpiler infrastructure.</p>
+</div>
+<div id="fig:transpilerClassDgr" class="imageblock center">
+<div class="content">
+<img src="chapters/13_compilation/images/TranspilerClassDgr.svg" alt="TranspilerClassDgr">
+</div>
+<div class="title">Figure 30. Class diagram for the transpiler infrastructure.</div>
+</div>
+<div class="paragraph">
+<p>The <code>AbstractTranspiler</code> controls the overall workflow shown earlier in . Concrete subclasses of <code>Transformation</code> perform the actual transformations (the preparation and pretty-printing steps are not shown in the above class diagram). Concrete transformations are created via injection within concrete sub classes of <code>AbstractTranspiler</code> (see class <code>EcmaScriptTranspiler</code> for an example). All information required during transpilation is kept in a simple data class called <code>TranspilerState</code>; a single instance of this class is created during the preparation step and is passed along until transpilation of the resource to transpile is completed.</p>
+</div>
+<div class="paragraph">
+<p>Class <code>Transformation</code> has a super class <code>TranspilerComponent</code> that has two important responsibilities:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>it contains many utility methods that are easily accessible from within concrete transformations through inheritance.</p>
+</li>
+<li>
+<p>it obtains the transpiler state via injection (using the scoping feature of Google Guice, for more details see <code>org.eclipse.n4js.utils.di.scopes.ScopeManager</code> and <code>TransformationScoped</code>). This injection is done in super class <code>TranspilerComponent</code>, so when implementing a new transformation, the programmer does not have to deal with these details and can simply obtain the transpiler state via the inherited method <code>TranspilerComponent#getState()</code>.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Code shared across concrete transformations should be placed in sub classes of <code>TransformationAssistant</code>. Those assistants are similar to the helpers used elsewhere, but by sharing the <code>TranspilerComponent</code> super class they get all the utility methods provided by that class and they automatically get the transpiler state.</p>
+</div>
+<div class="paragraph">
+<p>For more implementation details see the code and javadoc; a good starting point for investigating the overall workflow are classes <code>AbstractTranspiler</code> and <code>Transformation</code>.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Guidelines_for_Implementing_Transformations"><a class="anchor" href="#sec:Guidelines_for_Implementing_Transformations"></a><a class="link" href="#sec:Guidelines_for_Implementing_Transformations">12.3.4. Guidelines for Implementing Transformations</a></h4>
+<div class="paragraph">
+<p>Some hints:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>if you need to create an entirely new transformation:</p>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>create new sub class of <code>Transformation</code> (use Xtend).</p>
+</li>
+<li>
+<p>in the main class of the transpiler you are working with (probably <code>EcmaScriptTranspiler</code>), change method
+<code>#computeTransformationsToBeExecuted()</code> to return an instance of your new transformation. The instance should be created using a Guice provider (see <code>EcmaScriptTranspiler</code> for an example). Note that this method also defines the order of transformations!</p>
+</li>
+<li>
+<p>implement the <code>#transform()</code> method of your newly created transformation.</p>
+</li>
+<li>
+<p>consider adding pre and post conditions via methods <code>#assertPreConditions()</code> and <code>#assertPostConditions()</code> (throw an AssertionError if failed).</p>
+</li>
+<li>
+<p>consider declaring dependencies to other transformations using the annotations defined in class <code>TransformationDependency</code>.</p>
+</li>
+</ol>
+</div>
+</li>
+<li>
+<p>code shared across transformations should be placed in a new or existing sub class of <code>TransformationAssistant</code> and then this assistant should be injected into the transformations that require this code’s functionality.</p>
+</li>
+<li>
+<p>inside a transformation or transformation assistant:</p>
+<div class="ulist">
+<ul>
+<li>
+<p>to modify the IM, use the utility methods inherited from <code>TranspilerComponent</code> (e.g. <code>#replace()</code>, <code>#insertBefore()</code>); try to avoid direct manipulation of the IM as far as possible (but sometimes it’s necessary).</p>
+</li>
+<li>
+<p>to create new IM elements, use the convenience methods in <code>TranspilerBuilderBlocks</code>; use static import.</p>
+</li>
+<li>
+<p>to create a new symbol table entry or to obtain an existing symbol table entry for a given original target or element in the IM, use the inherited utility methods <code>TranspilerComponent#getSymbolTableEntry*()</code>.<br>
+<strong>Never search or modify the symbol table directly!</strong></p>
+</li>
+<li>
+<p>to access the transpiler state <sup class="footnote">[<a id="_footnoteref_14" class="footnote" href="#_footnote_14" title="View footnote.">14</a>]</sup>, use inherited method <code>TranspilerComponent#getState()</code> (by convention, in Xtend you should just write <code>state</code> as if it were a field).</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>for local testing, activate additional consistency checks between transformations and assertion of pre/post conditions via these boolean flags:<br>
+<code>AbstractTranspiler#DEBUG_PERFORM_VALIDATIONS</code>,<br>
+<code>AbstractTranspiler#DEBUG_PERFORM_ASSERTIONS</code>.</p>
+</li>
+<li>
+<p>never add one of the following replaced EMF entities to the IM:<br>
+<code>Script</code>,<br>
+<code>IdentifierRef</code>,<br>
+<code>ParameterizedTypeRef</code>,<br>
+<code>ParameterizedTypeRefStructural</code>,<br>
+<code>ParameterizedPropertyAccessExpression</code>.<br>
+Instead, use the replacement entities from <code>IM.xcore</code> that have the <code>_IM</code> suffix (e.g. <code>IdentifierRef_IM</code>). If you always use <code>TranspilerBuilderBlocks</code> as described above, you won’t run into this issue.</p>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect3">
+<h4 id="symbol-table-in-the-im"><a class="anchor" href="#symbol-table-in-the-im"></a><a class="link" href="#symbol-table-in-the-im">12.3.5. Symbol Table in the IM</a></h4>
+<div class="paragraph">
+<p>During the preparation step, the IM is created as an exact copy of the original AST in most cases. However, to make sure the IM is self-contained and does not have any cross-references to the original AST or the original TModule and to simplify certain computations within the transformations, some AST entities are modified. For this purpose, there is a small EMF model called <code>IM.xcore</code>. It extends the AST model <code>n4js.xcore</code> and adds some elements.</p>
+</div>
+<div class="paragraph">
+<p>Most importantly, a symbol table is created and all references of the original AST pointing to an IdentifiableElement (either in the original AST or in the TModule) are rewired to a reference to an entry in the symbol table. Those entries are of type <code>SymbolTableEntry</code> and occur in three special forms (there is a dedicated sub class for each case). Detailed information is provided in the javadoc of <code>SymbolTableEntry</code> and its sub classes and is not repeated here to avoid duplication.</p>
+</div>
+<div class="paragraph">
+<p>The following entity replacements are done while creating the IM from the original AST and the entities without <code>_IM</code> must <strong>never</strong> appear in the IM:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>Script</code>  <code>Script_IM</code></p>
+</li>
+<li>
+<p><code>IdentifierRef</code>  <code>IdentifierRef_IM</code></p>
+</li>
+<li>
+<p><code>ParameterizedTypeRef</code>  <code>ParameterizedTypeRef_IM</code></p>
+</li>
+<li>
+<p><code>ParameterizedTypeRefStructural</code>  <code>ParameterizedTypeRefStructural_IM</code></p>
+</li>
+<li>
+<p><code>ParameterizedPropertyAccessExpression</code>  <code>ParameterizedPropertyAccessExpression_IM</code></p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>For example, when having in the original AST an <code>IdentifierRef</code> pointing to identifiable element , then the IM will contain an <code>IdentifierRef_IM</code> pointing to a <code>SymbolTableEntryOriginal</code> with a property <code>originalTarget</code> pointing to .</p>
+</div>
+<div class="paragraph">
+<p>Figures <a href="#fig:rewire_var">Rewire Var</a>, <a href="#fig:rewire_class">Rewire Class</a>, and <a href="#fig:rewire_import">Rewire Import</a> show a comparison between an original AST with its original TModule and the self-contained intermediate model for a number of concrete examples.</p>
+</div>
+<div class="exampleblock">
+<div class="title">Example 2. Intermediate Models for References to Variables</div>
+<div class="content">
+<div class="paragraph">
+<p>Original AST + TModule</p>
+</div>
+<div id="fig:rewire_var" class="imageblock center">
+<div class="content">
+<img src="chapters/13_compilation/images/Rewire_var_pre.png" alt="Rewire var pre">
+</div>
+<div class="title">Figure 31. Intermediate Model for References to Variables</div>
+</div>
+<div class="paragraph">
+<p>Intermediate model (IM)</p>
+</div>
+<div id="fig:rewire_var-post" class="imageblock center">
+<div class="content">
+<img src="chapters/13_compilation/images/Rewire_var_post.png" alt="Rewire var post">
+</div>
+<div class="title">Figure 32. Intermediate Model for References to Variables (post)</div>
+</div>
+</div>
+</div>
+<div class="exampleblock">
+<div class="title">Example 3. Intermediate Model for References to Classes</div>
+<div class="content">
+<div class="paragraph">
+<p>original AST + TModule</p>
+</div>
+<div id="fig:rewire_class" class="imageblock center">
+<div class="content">
+<img src="chapters/13_compilation/images/Rewire_class_pre.png" alt="Rewire class pre">
+</div>
+<div class="title">Figure 33. Intermediate Model for References to Classes</div>
+</div>
+<div class="paragraph">
+<p>Intermediate model (IM)</p>
+</div>
+<div id="fig:rewire_class-post" class="imageblock center">
+<div class="content">
+<img src="chapters/13_compilation/images/Rewire_class_post.png" alt="Rewire class post">
+</div>
+<div class="title">Figure 34. Intermediate Model for References to Classes (post)</div>
+</div>
+</div>
+</div>
+<div class="exampleblock">
+<div class="title">Example 4. Intermediate Model for References to Imported Classes</div>
+<div class="content">
+<div class="paragraph">
+<p>Original AST + TModule</p>
+</div>
+<div id="fig:rewire_import" class="imageblock center">
+<div class="content">
+<img src="chapters/13_compilation/images/Rewire_import_pre.png" alt="Rewire import pre">
+</div>
+<div class="title">Figure 35. Intermediate Model for References to Imported Classes</div>
+</div>
+<div class="paragraph">
+<p>Intermediate model (IM)</p>
+</div>
+<div id="fig:rewire_import-post" class="imageblock center">
+<div class="content">
+<img src="chapters/13_compilation/images/Rewire_import_post.png" alt="Rewire import post">
+</div>
+<div class="title">Figure 36. Intermediate Model for References to Imported Classes (post)</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:N4JS_to_EcmaScript_Transpiler"><a class="anchor" href="#sec:N4JS_to_EcmaScript_Transpiler"></a><a class="link" href="#sec:N4JS_to_EcmaScript_Transpiler">12.4. N4JS-to-EcmaScript Transpiler</a></h3>
+<div class="sect3">
+<h4 id="sec:Overview_of_Transformations"><a class="anchor" href="#sec:Overview_of_Transformations"></a><a class="link" href="#sec:Overview_of_Transformations">12.4.1. Overview of Transformations</a></h4>
+<div class="paragraph">
+<p>The following overview will soon be outdated. Therefore:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>to find out which transformations are actually being executed and in what precise order, it is best to directly look into method:<br>
+<code>EcmaScriptTranspiler#computeTransformationsToBeExecuted()</code>.</p>
+</li>
+<li>
+<p>to learn about dependencies between transformations, check the annotations of the transformation class to see if one of the dependency annotations defined in <code>TransformationDependency</code> are given there (though probably not all dependencies will be specified in that form).</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>The following table lists all transformation by class name in the order they are executed by the <code>EcmaScriptTranspiler</code>.</p>
+</div>
+<table class="tableblock frame-all grid-all spread">
+<colgroup>
+<col style="width: 50%;">
+<col style="width: 50%;">
+</colgroup>
+<tbody>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">StaticPolyfillTransformation</p></td>
+<td class="tableblock halign-left valign-top"></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">MemberPatchingTransformation</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">see <a href="#sec:Transpiling_members">Transpiling Members</a></p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">ApiImplStubGenerationTransformation</p></td>
+<td class="tableblock halign-left valign-top"></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">DestructuringTransformation</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">turn destructuring patterns into ES5 code</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">SuperLiteralTransformation</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">super call + super access</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">ExpressionTransformation</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">casts, <code>instanceof</code>, <code>@Promisify</code>, &#8230;&#8203;</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">DependencyInjectionTransformation</p></td>
+<td class="tableblock halign-left valign-top"></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">ClassDeclarationTransformation</p></td>
+<td class="tableblock halign-left valign-top"></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">InterfaceDeclarationTransformation</p></td>
+<td class="tableblock halign-left valign-top"></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">EnumDeclarationTransformation</p></td>
+<td class="tableblock halign-left valign-top"></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">FunctionDeclarationTransformation</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">turn declared function into variable declaration + function expression</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">ArrowFunction_Part1_Transformation</p></td>
+<td class="tableblock halign-left valign-top"></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">BlockTransformation</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">local arguments variable, <code>await</code></p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">FormalParameterTransformation</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">variadic arguments</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">ArrowFunction_Part2_Transformation</p></td>
+<td class="tableblock halign-left valign-top"></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">TrimTransformation</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">remove TypeRefs and TypeVariables</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">SanitizeImportsTransformation</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">remove unused imports + add missing imports</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">ModuleWrappingTransformation</p></td>
+<td class="tableblock halign-left valign-top"></td>
+</tr>
+</tbody>
+</table>
+<div class="paragraph">
+<p>The main complexity lies in the three transformations for N4JS type declarations (classes, interfaces, enums) and the related three transformations for member handling at the beginning (static polyfills, member patching, API/Impl stub generation) and the module wrapping. Up to the double horizontal line, the IM is still rather close to N4JS (e.g. still contains <code>N4ClassDeclaration</code>s with <code>N4MemberDeclaration</code>s), but after that it rapidly departs from the structure of the original AST (e.g. class declarations are broken up into a function declaration and a $<code>makeClass</code> call, field accessors and methods become function expressions in the properties of an object literal, fields are handled differently).</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Transpiling_members"><a class="anchor" href="#sec:Transpiling_members"></a><a class="link" href="#sec:Transpiling_members">12.4.2. Transpiling members</a></h4>
+<div class="paragraph">
+<p>When processing the members of a container type, in the standard case, the transpiler simply has to generate target code for each owned member. For inherited members no output code has to be generated, because the ordinary semantics of the Javascript prototype chain is used in the generated code.</p>
+</div>
+<div class="paragraph">
+<p>There are, however, special cases when output code has to be generated for a non-owned or non-existant member of a container type:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>partial shadowing caused by lone field accessors, [sec:Transpiling_members__Partial_shadowing_of_getter_setter_pairs]<br>
+( <strong>delegation</strong>)</p>
+</li>
+<li>
+<p>consumption of members of an interface within an implementing class, [sec:Transpiling_members__Consuming_or_inheriting_members_of_an_interface]<br>
+( <strong>delegation</strong>, for data fields: <strong>copying</strong>)</p>
+</li>
+<li>
+<p>inheritance of members of an interface within an extending interface, [sec:Transpiling_members__Consuming_or_inheriting_members_of_an_interface]<br>
+( <strong>delegation</strong>, for data fields: <strong>copying</strong>)</p>
+</li>
+<li>
+<p>mixing in members into a container type via static polyfill, [sec:Transpiling_members__Static_polyfill]<br>
+( <strong>copying</strong>)</p>
+</li>
+<li>
+<p>adding an API / implementation stub, [sec:Transpiling_members__API_implementation_stubs]<br>
+( <strong>creation</strong>)</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>The above overview also states what technique is used in each special case of member handling: <strong>delegation</strong>, <strong>copying</strong> or <strong>creation</strong>. Delegation is the most tricky one and means that not a new function is generated in the output code for the special member, but the existing member function of an existing member is obtained from somewhere in the prototype chain and used directly as the member function of the special member. <strong>Copying</strong> means that an existing member is copied to another location where the special handling is required as if it were defined in that place. Lastly, <strong>creation</strong> means that an entirely new member is created for which no existing member serves as a template and this member gets a body with some <code>default</code> behavior. These three techniques of special member handling are explained in more detail in <a href="#sec:Transpiling_members__Delegating_members">Techniques for special member handling</a>.</p>
+</div>
+<div class="sect4">
+<h5 id="sec:Transpiling_members__Delegating_members"><a class="anchor" href="#sec:Transpiling_members__Delegating_members"></a><a class="link" href="#sec:Transpiling_members__Delegating_members">12.4.2.1. Techniques for special member handling</a></h5>
+<div class="paragraph">
+<p>If output code has to be generated for a non-owned member  of a classifier  we distinguish the following two cases:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>either some other member  owned by classifier  serves as a template for ,</p>
+</li>
+<li>
+<p>or no such template exists.</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>In the first case, we can either <strong>copy</strong>  in the sense that we will generate output code for  within the output code for  as if  had been defined in . Or we can use <strong>delegation</strong>, i.e. generate output code for  that reuses the existing member function of  in . In case no template exists, we always have to <strong>create</strong>  from scratch, i.e. generate output code as if  had been defined with some behavior pre-defined by the N4JS language (this applies only to API / implementation stubs where this pre-defined behaviour is to throw an <code>unimplemented member</code> error).</p>
+</div>
+<div class="paragraph">
+<p>Creation and copying is straightforward; for more details on member delegation see class <code>DelegationAssistant</code> and entity <code>DelegatingMember</code> in <code>IM.xcore</code>. The basic approach is to allow one transformation to create a <code>DelegatingMember</code> and insert it into the IM and let the transformations for class and interface declarations turn this member into low-level Javascript constructs that perform the actual delegation.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Transpiling_members__Partial_shadowing_of_getter_setter_pairs"><a class="anchor" href="#sec:Transpiling_members__Partial_shadowing_of_getter_setter_pairs"></a><a class="link" href="#sec:Transpiling_members__Partial_shadowing_of_getter_setter_pairs">12.4.2.2. Partial shadowing</a></h5>
+<div class="paragraph">
+<p>In Javascript, if an object  has a setter of name , then a read access <code>obj.prop</code> will return undefined, even if the prototype of  has a getter or field of name . Conversely, if  has a getter , then a write access <code>obj.prop = 42</code> will produce a runtime error, even if the prototype of  has a setter or field .</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>var proto = {
+  get prop1() { return "this won't show up" },
+  set prop2(value) { console.log("this won't be reached") }
+}
+var obj = {
+  set prop1(value) {},
+  get prop2() {}
+}
+obj.__proto__ = proto;
+
+console.log(typeof obj.prop1);  // will print "undefined"
+obj.prop2 = 42;  // error: "setting a property that has only a getter"</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Note, in plain N4JS a validation enforces a redefinition of accessors or overriding of a field always by getter/setter pairs. However, in special situations of incomplete API implementations stubs for missing accessors are created in order to provide meaningful test-reporting. This leads to situations where on the implementation side a single getter or or a single setter is defined in a subclass - unaware of possibly injected stubs in superclasses. The aforementioned validation can not enforce the user to author an accessor pair. To keep a meaningful test-response the transpiler treats this situation as follows:</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Transpiling_members__Consuming_or_inheriting_members_of_an_interface"><a class="anchor" href="#sec:Transpiling_members__Consuming_or_inheriting_members_of_an_interface"></a><a class="link" href="#sec:Transpiling_members__Consuming_or_inheriting_members_of_an_interface">12.4.2.3. Consuming or inheriting members of an interface</a></h5>
+<div class="paragraph">
+<p>When an N4JS class  consumes the member of an interface implemented by , then this cannot be handled by the native prototype chain mechanism of Javascript. Instead, the transpiler has to generate a member of corresponding type that delegates to the consumed member. In case of data fields, such a delegation is not possible and thus the transpiler generates output code for the consumed data field as if the field had been defined in .</p>
+</div>
+<div class="paragraph">
+<p>Of particular importance in this context is the diamond problem when consuming members from an interface. For example, if interface  defined method  with a default implementation, interface  extends  and overrides  with a different implementation, class  implements  and class  extending  implements , then  will not consume  because it has already inherited  from its super class  (which in turn has consumed it from ). So, in  the default implementation of  given in  will be active, not that given in .</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Transpiling_members__Static_polyfill"><a class="anchor" href="#sec:Transpiling_members__Static_polyfill"></a><a class="link" href="#sec:Transpiling_members__Static_polyfill">12.4.2.4. Static polyfill</a></h5>
+<div class="paragraph">
+<p>See class <code>StaticPolyfillTransformation</code> for details.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Transpiling_members__API_implementation_stubs"><a class="anchor" href="#sec:Transpiling_members__API_implementation_stubs"></a><a class="link" href="#sec:Transpiling_members__API_implementation_stubs">12.4.2.5. API / implementation stubs</a></h5>
+<div class="paragraph">
+<p>See <a href="#sec:Support_for_incomplete_API_implementation_testing_in_the_N4JS_to_EcmaScript_5_Transpiler">Support for incomplete API implementation testing</a>.</p>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Support_for_incomplete_API_implementation_testing_in_the_N4JS_to_EcmaScript_5_Transpiler"><a class="anchor" href="#sec:Support_for_incomplete_API_implementation_testing_in_the_N4JS_to_EcmaScript_5_Transpiler"></a><a class="link" href="#sec:Support_for_incomplete_API_implementation_testing_in_the_N4JS_to_EcmaScript_5_Transpiler">12.4.3. Support for incomplete API implementation testing</a></h4>
+<div class="paragraph">
+<p>As part of the introduction of API projects with executable test cases the need to verify the state of implementations came into focus. No formal dependency is allowed between an API project and its dedicated implementation projects, hence an inconsistency can not directly be detected. However at runtime (c.f. <a href="#_execution">Execution</a>) the API is always replaced by an appropriate implementation.</p>
+</div>
+<div class="paragraph">
+<p>In cases where such an implementation is incomplete this would result in failures due to missing concepts, e.g. calls to methods that are not in place or usage of fields which are not defined. In order to support the author of an implementation the IDE provides a mean to compare the current state of implementation to the developer in a tabular way (c.f. [<a href="#N4JSSpec">N4JSSpec</a>]).</p>
+</div>
+<div class="paragraph">
+<p>The key idea for automated test-support is to incorporate those comparison-results into the transpiled output in way, that a test-framework can easily distinguish wrong implementations from incomplete implementations. Of course this is not always possible, but the majority of cases can be handled.</p>
+</div>
+<div class="paragraph">
+<p>As there is only one transpilation mode the resulting modifications are always part of the generated code.</p>
+</div>
+<div class="paragraph">
+<p>In order to distinguish the different project-types we distinguish between different project types:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>an API-project (API)</p>
+</li>
+<li>
+<p>an API-implementation project (Impl)</p>
+</li>
+<li>
+<p>a client project (Client)</p>
+</li>
+<li>
+<p>a test project (Test)</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>The API-project defines the requirements to it’s implementors in form of definition-files (n4jsd). The API is defined together with an test-project which validates the implementation. Client code is written with a formal dependency to the API and uses the elements declared therein. In that sense an API-testing project is just a normal client project with a test-nature.</p>
+</div>
+<div class="paragraph">
+<p>Additional code to support API implementation testing is only inserted into the Impl-projects. API, Client and Test are not affected.</p>
+</div>
+<div class="paragraph">
+<p>One major goal in transpiling Impl projects is to provide the ability to load all modules used in Client/Test projects in non-disruptive way. Even if the implementation is missing elements the runtime should still be able to successfully load the module. Errors should only be signalled when the client code actually uses the missing concepts.</p>
+</div>
+<div class="sect4">
+<h5 id="sec:Modifications_in_Impl_projects"><a class="anchor" href="#sec:Modifications_in_Impl_projects"></a><a class="link" href="#sec:Modifications_in_Impl_projects">12.4.3.1. Modifications in Impl projects</a></h5>
+<div class="paragraph">
+<p>The generator is module driven. In case of missing modules nothing will be done but the runtime will detect this and act accordingly.</p>
+</div>
+<div class="paragraph">
+<p>In general only missing elements will be inserted:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Missing class - a stub will be generated</p>
+</li>
+<li>
+<p>Missing function - a stub will be generated</p>
+</li>
+<li>
+<p>Missing enumeration - a stub will be generated</p>
+</li>
+<li>
+<p>Missing interface - a stub will be generated</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Missing members of classes are inserted as stubs. Missing fields will be replaced by getter/setter-pairs throwing an error upon read and write access.</p>
+</div>
+<div class="paragraph">
+<p>A more sophisticated approach needs to be taken for interfaces with default implementations (marked with @ProvidesDefaultImplementation or @ProvidesInitializer).</p>
+</div>
+<div class="paragraph">
+<p>Currently missing field initialisers in interfaces are not detected for two reasons: Field-initialising is carried out on loading. Throwing an error in the initialiser will prevent the module from being loaded. Installing a getter/setter pair on the Impl-interface is not an option since the inheritance chain used in client project has no knowledge about this and therefore these accessors cannot be reached from client code.</p>
+</div>
+<div class="paragraph">
+<p>Missing default implementations will be inserted as stubs. For normal class compilation the inheritance chain needs to be scanned. In case of an missing default implementation in an implemented interface a forwarding call to the stub needs to be inserted on the class.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Implementation_of_stub_generation"><a class="anchor" href="#sec:Implementation_of_stub_generation"></a><a class="link" href="#sec:Implementation_of_stub_generation">12.4.3.2. Implementation of stub-generation</a></h5>
+<div class="paragraph">
+<p>The implementation is mainly organised in <code>ApiImplStubGenerationTransformation</code>, which makes use of <code>MissingApiMembersForTranspiler</code> and <code>ScriptApiTracker</code>.</p>
+</div>
+<div class="paragraph">
+<p>When a Module is transpiled the type of the project is checked. Only if the project is an implementation project the comparison between the current module and it’s API module is computed and attached as an Adapter to the <code>Script</code> during the life-cycle of the <code>ScriptTranspilerPolicy</code>. The <code>ProjectComparisonAdapter</code> serves as a shared information pool among the different transpiler-policies and caches different compare-results. After transpilation of the script the adapter will be removed.</p>
+</div>
+<div class="paragraph">
+<p>In order to reuse all existing code as far as possible, missing elements are modelled as subclasses of the requested element but with no AST-information. These subclasses are member-classes of the <code>ScriptApiTracker</code> class. All class-names are prefixed with <code>VirtualApi</code> and hold a reference to the type-information computed by the module-comparison.</p>
+</div>
+<div class="paragraph">
+<p>It is important to not access the AST-elements of type-information obtained from the project-comparison, since this would trigger the AST-loading and invalidate (proxifying) existing <code>EObjects</code>.</p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:n4jsc_Headless_Compiler_Interface"><a class="anchor" href="#sec:n4jsc_Headless_Compiler_Interface"></a><a class="link" href="#sec:n4jsc_Headless_Compiler_Interface">12.5. n4jsc Headless Compiler Interface</a></h3>
+<div class="paragraph">
+<p>The headless compiler interface consists of a runnable class capable of reading command line options packaged together with all required dependencies into one executable <code>.jar</code> archive.</p>
+</div>
+<div class="paragraph">
+<p>The sources of the command line interface are located in in the <code>tools/</code> subfolder of the main git repository. They comprise of the package <code>org.eclipse.n4js.hlc</code> and corresponding test package <code>org.eclipse.n4js.hlc.tests</code>. (c.f. <a href="#sec:tools">Tools</a>).</p>
+</div>
+<div class="paragraph">
+<p>A description of how to use the headless compiler can be found in the N4IDE document.</p>
+</div>
+<div class="sect3">
+<h4 id="sec:building_the_headless_compiler"><a class="anchor" href="#sec:building_the_headless_compiler"></a><a class="link" href="#sec:building_the_headless_compiler">12.5.1. building the headless compiler</a></h4>
+<div class="paragraph">
+<p>The maven-modules related to the headless compiler build are organised in the <code>tools</code> folder in the project-root. In order to build the headless compiler as part of the common build-chain, the maven-profile <code>buildTools</code> needs to be activated (off by default), e.g. <code>mvn -PbuildTools</code> .</p>
+</div>
+<div class="paragraph">
+<p>To build the headless compiler separately, the project-pom can be set to <code>tools/pom.xml</code>, however then the tycho-generated artefacts must be accessible by this build. This can be achieved in three different ways:</p>
+</div>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p>the build takes place on a workspace formerly building the n4js-project without cleaning it (interesting for local experiments),</p>
+</li>
+<li>
+<p>a former n4js-build installed the artefacts into the currently configured local-.m2-repository of maven or</p>
+</li>
+<li>
+<p>a former n4js-build deployed the artefacts to the configured nexus-server.</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>Note however, on our build-server option a) is not feasible, option b) requires you to setup a build-chain and ensuring the same build-node to be building on
+and c) is difficult up to nearly impossible without a proper versioning-scheme.</p>
+</div>
+<div class="paragraph">
+<p>Parameters for the headless-compiler-build are defined in the parent-pom located at <code>releng/org.eclipse.n4js.parent/pom.xml</code> with properties prefixed by <code>hlc.</code>.</p>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_execution"><a class="anchor" href="#_execution"></a><a class="link" href="#_execution">13. Execution</a></h2>
+<div class="sectionbody">
+<div class="admonitionblock warning">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-warning" title=""></i>
+</td>
+<td class="content">
+This chapter may be outdated.
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>There are many different use cases for executing N4JS code:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>running project locally</p>
+</li>
+<li>
+<p>running tests in CI</p>
+</li>
+<li>
+<p>running application in the client</p>
+</li>
+<li>
+<p>running processor on the server</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>All those use cases may differ in their details, but can be divided into general phases:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>execution environment preparation</p>
+</li>
+<li>
+<p>bootstrapping</p>
+</li>
+<li>
+<p>call to given n4js entry point</p>
+</li>
+<li>
+<p>shutdown (optional)</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>When N4JS execution is triggered, proper <em>Runner</em> (see <a href="#sec:Runners-introduction">Runners</a>) is selected. In some cases it is done automatically, in others user needs to make a choice. Runner is responsible for perform all required preparations, according to <a href="#sec:N4JS_Project_Execution_And_Linking_Model">N4JS Project Execution And Linking Model</a>. Then JS execution environment (e.g. NodeJS, IOJS, Chrome, JavaScriptCore) performs bootstrapping according to <a href="#sec:N4JS_Execution_And_Linking_File">N4JS Execution And Linking File</a>. As last step of bootstrap phase defend n4js entry point will be called which starts proper n4js execution phase. In some cases there may be shutdown phase, but that is highly dependent on use case and proceeding execution phases.</p>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:N4JS_Project_Execution_And_Linking_Model"><a class="anchor" href="#sec:N4JS_Project_Execution_And_Linking_Model"></a><a class="link" href="#sec:N4JS_Project_Execution_And_Linking_Model">13.1. N4JS Project Execution And Linking Model</a></h3>
+<div class="paragraph">
+<p>N4JS project is compiled to JavaScript language, that in turn can be executed in some JS execution environment, Those environments (e.g. NodeJS, IOJS, Chrome, JavaScriptCore) will differ between each other in terms of JS APIs they expose and way JS code has to be provided to them, or the way it is triggered. We introduced systematic way of describing those features in terms of N4JS projects (see Components and Projects <a href="#sec:N4_Components_and_IDE_Support">Components and IDE Support</a>). N4JS project will be of different <em>PojectType</em> that determines project purpose (see Package.json section <a href="#sec:Package_json">Package.json File</a>. When we want to execute some N4JS project, we can divide its dependency graph into 4 general areas</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>User Space, e.g. user code</p>
+</li>
+<li>
+<p>System Space, e.g N4 Platform APIs</p>
+</li>
+<li>
+<p>Runtime Space, e.g. EcmaScript APIs</p>
+</li>
+<li>
+<p>Environment Space, e.g. execution environment APIs</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>Example of that kind of graph can bee seen on <a href="#fig:od_sampleProjectDependencyGraph">Sample Project Dependency Graph</a></p>
+</div>
+<div id="fig:od_sampleProjectDependencyGraph" class="imageblock center">
+<div class="content">
+<img src="chapters/14_execution/images/od_sampleProjectDependencyGraph.svg" alt="od sampleProjectDependencyGraph">
+</div>
+<div class="title">Figure 37. Sample Project Dependency Graph</div>
+</div>
+<div class="paragraph">
+<p>All dependencies are compile time dependency (as they are checked by the compiler), but <em>tend</em> to weaken, the lower in the dependency graph we are. <em>User Space</em> objects will have strong load time and run time dependency to each other and to the <em>System Space</em>. <em>System Space</em> have strong load time and run time dependency to each other and, only runtime dependency to <em>Runtime Space</em>. <em>Runtime Space</em> objects should not have any load time dependencies between each other. In some cases they may have weak runtime dependency to each other. In many cases those components are just api definitions that describe execution environment native apis, but may contain polyfills code. <em>Environment Space</em> has no dependency to other components, except the fact different <em>RuntimeEnvironemnt</em>s can extend each other (see <a href="#sec:N4_Components_and_IDE_Support">[sec:N4_Components_and_IDE_Support]</a>).</p>
+</div>
+<div class="paragraph">
+<p>Runner must configure JS execution environment in the way that all above areas of the dependency graph must be either</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>provided by execution environment itself (runtime libraries APIs - <em>n4jsd</em> files)</p>
+</li>
+<li>
+<p>loaded by defined runtime environment (self initialisation code)</p>
+</li>
+<li>
+<p>available to load by environment explicitly (runtime libraries polyfills, system libraries)</p>
+</li>
+<li>
+<p>available to load by other implicitly (system libraries, user libraries and projects)</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Testers, the same way as runners, must be able to execute n4js code. Main difference is that dependency graph for test case will be usually slightly bigger (dependencies to test libraries), and code that has to be triggered shifts a bit from given project to test library used in test code of tested project. Extending previously used example with test elements is shown in figure <a href="#fig:od_sampleTestProjectDependencyGraph2">Sample Test Project Dependency Graph</a>.</p>
+</div>
+<div id="fig:od_sampleTestProjectDependencyGraph2" class="imageblock center">
+<div class="content">
+<img src="chapters/14_execution/images/od_sampleTestProjectDependencyGraph.svg" alt="od sampleTestProjectDependencyGraph">
+</div>
+<div class="title">Figure 38. Sample Test Project Dependency Graph</div>
+</div>
+<div id="fig:runners-testers" class="imageblock center">
+<div class="content">
+<img src="chapters/14_execution/images/runners-testers.svg" alt="runners testers">
+</div>
+<div class="title">Figure 39. Runners and Testers</div>
+</div>
+<div class="sect3 language-n4js">
+<h4 id="subsec:N4JS_Execution_With_NodeJS"><a class="anchor" href="#subsec:N4JS_Execution_With_NodeJS"></a><a class="link" href="#subsec:N4JS_Execution_With_NodeJS">13.1.1. N4JS Execution With NodeJS</a></h4>
+<div class="paragraph">
+<p>This example shows in-depth details of N4JS code execution with NodeJS runner.</p>
+</div>
+<div class="paragraph">
+<p>In the workspace we have <code>Client</code> with <code>foo.n4js</code> that imports <code>bar.n4js</code> from <code>UserLib</code> that is also in the workspace.
+Those N4JS files use some ES5 APIs , e.g. <code>Math.random()</code> and <code>setTimeout()</code>. Those APIs are <code>Global</code> so there is
+no impicit import, still they make user projects depend on runtime library <code>n4js-runtime-es2015</code>.
+Assuming user selects <code>foo.n4js</code> file for execution, the NodeRunner in the IDE will:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>create working directory in temp folder, e.g. <code>/var/temp/N4JSNodeRun123/</code></p>
+</li>
+<li>
+<p>create <code>node_modules</code> folder inside working directory, to which projects will be linked</p>
+</li>
+<li>
+<p>generate script, e.g. <code>n4jsELF.js</code> that will be responsible for booting execution (see <a href="#sec:N4JS_Execution_And_Linking_File">N4JS Execution And Linking File</a>)</p>
+</li>
+<li>
+<p>runner will put <code>/var/temp/N4JSNodeRun123/node_modules</code> into <code>NODE_PATH</code></p>
+</li>
+<li>
+<p>execute <code>/var/temp/N4JSNodeRun123/n4jsELF.js</code> with NodeJS</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>For example with NodeJS environment if all projects from dependency graph are accessible in local file system, their
+paths would need to be put in NodeJS <em>NODE_PATH</em> environment variable. In addition to configuring execution environment
+<em>Runner</em> generates N4JS Elf file that is used by environment to bootstrap n4js execution
+(see <a href="#sec:N4JS_Execution_And_Linking_File">N4JS Execution And Linking File</a>).
+[[fig:od_sampleNodeProjectExecution]</p>
+</div>
+<div class="imageblock center">
+<div class="content">
+<img src="chapters/14_execution/images/od_sampleNodeProjectExecution.svg" alt="od sampleNodeProjectExecution">
+</div>
+<div class="title">Figure 40. Sample NodeJS Project Execution</div>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:N4JS_Execution_And_Linking_File"><a class="anchor" href="#sec:N4JS_Execution_And_Linking_File"></a><a class="link" href="#sec:N4JS_Execution_And_Linking_File">13.2. N4JS Execution And Linking File</a></h3>
+<div class="paragraph">
+<p>JS execution environment not only needs to know from where it needs to obtain code to execute, but also <em>what is the entry point to the code that is supposed to be executed</em> and <em>what code needs to be loaded before entry point is called</em>.</p>
+</div>
+<div class="paragraph">
+<p>All this information is generated by the runner based on the executed project dependency graph. The way this information
+is presented depends on concrete JS execution environment used, and on its configuration (e.g. user provided options, or
+configuration derived in other ways). But in either case file is generated with that information. Figure <a href="#fig:n4js_elf">N4JS ELF examples</a>
+shows examples how this information would look like for both testers and runners for both NodeJS or Chrome.</p>
+</div>
+<div id="fig:n4js_elf" class="imageblock center">
+<div class="content">
+<img src="chapters/14_execution/images/n4js_elf.svg" alt="n4js elf">
+</div>
+<div class="title">Figure 41. N4JS ELF examples</div>
+</div>
+<div class="paragraph">
+<p>First segment of the n4js elf is responsible for loading <em>RuntimeEnvironment</em> bootstrap code. Since <em>RuntimeEnvironment</em>s can extend each other, generated information would follow those dependencies. It is possible that <em>RuntimeEnvironment</em>s need to do some special work in regards of of provided <em>RuntimeLibraries</em>s, e.g. initiate initiate polyfills. That code can be either directly in <em>RuntimeEnvironment</em> init code, or its init code can call modules from provided runtime libraries.</p>
+</div>
+<div class="paragraph">
+<p>Second segment of the n4js elf is responsible for loading <em>RuntimeEnvironment</em> exec module. This is special module defined in package.json of the environment, that is used to call into user projects entry point directly, or (as in test case) call into runners of the test library.</p>
+</div>
+<div class="paragraph">
+<p>Last segment of the n4js elf is responsible for passing run/test data (generated by IDE/CLI) into initialised previously exec module.</p>
+</div>
+<div class="paragraph">
+<p>While first two segments are resolved from project dependencies and can be covered by generic approach on IDE/CLI side, last segment requires strong relation between given runner/tester and <em>RuntimeEnvironment</em> / <em>TestEnvironment</em>. While some generic approaches can be used, for the moment we don’t specify concrete convention there.</p>
+</div>
+<div class="sect3 language-n4js">
+<h4 id="subsec:NodeJS_Specific_ELF"><a class="anchor" href="#subsec:NodeJS_Specific_ELF"></a><a class="link" href="#subsec:NodeJS_Specific_ELF">13.2.1. NodeJS Specific ELF</a></h4>
+<div class="paragraph">
+<p>Concrete environments may need specific setup that is not common for other environemtns. For example for NodeJS runner
+needs to configure the node lookup paths for the module resolution. This is achieved by creating at runtime symlinks
+from <code>node_modules</code> pointing to concrete dependencies required during execution.</p>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:Runners-execution"><a class="anchor" href="#sec:Runners-execution"></a><a class="link" href="#sec:Runners-execution">13.3. Runners</a></h3>
+<div class="paragraph">
+<p>It is specified above, that <em>Runner</em> prepares concrete JS execution environment for executing given code and triggers execution process. What is not clear so far is how appropriate runner is selected for given project. In <a href="#_n4components">N4 Components</a> it was specified that N4JS projects do not depend directly on specific runners or JS execution environments. Instead, N4JS tooling should be able to select appropriate runner based on given project transitive dependencies. In this section we specify overall design of runners for both N4JS IDE and CLI tooling and how runners are selected for projects.</p>
+</div>
+<div class="paragraph">
+<p>INFO: In general any n4js code execution is governed by <em>runners</em> and <em>testers</em> depending on the use case.
+In this chapter <em>runners</em> are described in detail.
+Information from this chapter applies to <em>Testers</em>, unless stated otherwise in chapter dedicated to testing N4JS code (<a href="#_tests">Tests</a>), were we specify
+testing specific use cases.</p>
+</div>
+<div class="sect3">
+<h4 id="subsec:N4_Runtime_Environments_Convention"><a class="anchor" href="#subsec:N4_Runtime_Environments_Convention"></a><a class="link" href="#subsec:N4_Runtime_Environments_Convention">13.3.1. N4 Runtime Environments Convention</a></h4>
+<div class="paragraph">
+<p>Dependency between <em>Runner</em> and <em>Runtime Environment</em> crosses technical boundary between N4JS Projects (N4JS code) and N4JS tooling (IDE and CLI tools implemented with e.g. Java). We introduce convention to implement this dependency, yet letting N4JS projects and N4JS tools internals to be relatively independent.</p>
+</div>
+<div id="fig:cd_EnvironmentConvention" class="imageblock center">
+<div class="content">
+<img src="chapters/14_execution/images/cd_EnvironmentConvention.svg" alt="cd EnvironmentConvention">
+</div>
+<div class="title">Figure 42. Runtime Environments Convention</div>
+</div>
+<div class="paragraph">
+<p><a href="#fig:cd_EnvironmentConvention">Runtime Environments Convention</a> convention that is used to communicate run time configuration of the N4JS projects (grey colour) and N4JSIDE (pink colour). JS projects declare dependencies on provided list of <em>Runtime Libraries</em>. Each combination of those corresponds to one predefined <em>Runtime Environment</em> N4JS component. On N4JSIDE side there is separate list of <em>runtime environment</em>s maintained. Both lists correspond one to one to each other.</p>
+</div>
+</div>
+<div class="sect3 language-n4js">
+<h4 id="subsec:Passing_Information_from_IDE_to_Execution_Code_in_Runtime_Environment"><a class="anchor" href="#subsec:Passing_Information_from_IDE_to_Execution_Code_in_Runtime_Environment"></a><a class="link" href="#subsec:Passing_Information_from_IDE_to_Execution_Code_in_Runtime_Environment">13.3.2. Passing Information from IDE to Execution Code in Runtime Environment</a></h4>
+<div class="paragraph">
+<p>When launching an N4JS file, the IDE will compute some information on the containing N4JS project and its direct and indirect dependencies as well as the runtime environment in use. This information will be passed on to the execution module defined in the runtime environment, i.e. the code specified via property in the runtime environment’s package.json file. The information will be passed via a global variable <code>$executionData</code>. The value will be a Javascript object with the following properties:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>userSelection</code>: the module the user had selected when initiating the launch. This will usually be the <code>module to run</code>  , but in case of testing it will be the project, folder, or file the user had selected.</p>
+</li>
+<li>
+<p><code>projectNameMapping</code>: an object in which every key is the name of an API project among the direct or indirect dependencies of the project being run, and every value is the name of the corresponding implementation project being used. When running N4JS projects that do not make use of the API / implementation project technique, then this property will either hold an empty object or be undefined.</p>
+</li>
+<li>
+<p><code>testTree</code> (only when running tests): the test tree as defined in <a href="#_tests">Tests</a> containing information on the tests to be run, i.e. test classes, test methods, etc. The test tree will be encoded as JSON, so the value of this property will be of type string and should be passed to <code>JSON.parse()</code>.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>All calculations described above are based on the workspace available. This includes library manager functionality, see <a href="../20_externalLibraries/externalLibraries.html#:External_Library_Workspace">External Library Workspace</a>.
+In specific setups, where workspace is not available runners provide helper utility <code>org.eclipse.n4js.runner.RunnerFileBasedShippedCodeConfigurationHelper.configureFromFileSystem()</code> that allows to configure given <code>RunConfiguration</code> using
+plain file system to the external libraries. Note that in order to do this in a way that allows to re-use all computation logic based on <a href="../12_n4components/n4components.html#:N4MFContainerManagement">N4Containers</a>,
+runners infrastructure provides its own subclasses of the few component types. Those specialized types are used only in scope of <code>RunnerFileBasedShippedCodeConfigurationHelper</code> and are not exposed to the rest of the system.</p>
+</div>
+<div class="paragraph">
+<p>Specific runners, e.g. the NodeJS or Chrome runner, may choose to provide more information via the execution data object.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="subsec:Runners_Design"><a class="anchor" href="#subsec:Runners_Design"></a><a class="link" href="#subsec:Runners_Design">13.3.3. Runners Design</a></h4>
+<div class="paragraph">
+<p>As specified in section before N4JS projects will need to be executed on various JS execution environments, for which dedicated runners will be needed. While they will differ how they interact with concrete JS environment, they will have common parts when it comes to interaction with N4JS IDE or CLI. Those parts are provided in form of abstract <em>IDERunner</em> <em>CLIRunner</em> and <em>Runner</em> <em>components</em> (or bundles) that specific runners should use to interact with N4JS IDE or CLI.</p>
+</div>
+<div class="paragraph">
+<p>Runner by design consists of three parts:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><em>core</em> part (green colour) - contains most logic, resources (e.g. JS execution environment binary)</p>
+</li>
+<li>
+<p><em>IDE</em> part (blue colour) - responsible for working with N4JS IDE (enabling runner in ui, providing views)</p>
+</li>
+<li>
+<p><em>CLI</em> part (yellow colour) - responsible for working with N4JS CLI (get command line parameters, provide console output)</p>
+</li>
+</ul>
+</div>
+<div id="cd_RunnersIdeCli" class="imageblock center">
+<div class="content">
+<img src="chapters/14_execution/images/cd_RunnersIdeCli.svg" alt="cd RunnersIdeCli">
+</div>
+<div class="title">Figure 43. Runner for N4JS IDE and CLI tooling</div>
+</div>
+<div class="paragraph">
+<p>Specific runner is connected to running N4JS IDE or CLI via extension points. This is done either by using them directly, or by using types exposed by abstract runner component.</p>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:Legacy_Execution_Engine"><a class="anchor" href="#sec:Legacy_Execution_Engine"></a><a class="link" href="#sec:Legacy_Execution_Engine">13.4. Legacy Execution Engine</a></h3>
+<div class="paragraph">
+<p>Compilation of N4JS may target many platforms. For the moment it is hard to discuss what they will be exactly or if N4JSIDE will provide some integration or hooks to those platforms. On the other hand we want to have some execution environment for internal use to validate behaviour of compiled code. Since we know that V8 based platforms (e.g. Chrome, NodeJS) will be in our target platforms set we want to be able to execute compiled code on similar environment. As standalone V8 integration is quite challenging, we have decided to integrate in N4JSIDE NodeJS as execution environment. This is considered internal feature used for testing compilation of N4JS and N4JSIDE.</p>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:Design"><a class="anchor" href="#sec:Design"></a><a class="link" href="#sec:Design">13.5. Design</a></h3>
+<div class="paragraph">
+<p>We provide NodeJS binaries for various OSes. Direct access to binaries is not exposed. Selection and institutionalization of the binary is done internally and is not configurable. Instead bundle containing binaries provides classes required to run code (in form of <code>String</code> or <code>File</code> with the code). Clients That want to do this may either use provided <code>Engine</code> class or can implement their own engine based on provided infrastructure. Main class that used in engine implementation is <code>EngineCommandBuilder</code>. This class is responsible for building proper command line commands that engine implementation must execute to run code with NodeJS.</p>
+</div>
+<div class="paragraph">
+<p><a href="#fig:cd_executionengine">NodeJS execution integration</a> shows the most important classes of the NodeJS integration.</p>
+</div>
+<div id="fig:cd_executionengine" class="imageblock center">
+<div class="content">
+<img src="chapters/14_execution/images/cd_executionengine.svg" alt="cd executionengine">
+</div>
+<div class="title">Figure 44. NodeJS execution integration</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Usage_Outside_N4JSIDE"><a class="anchor" href="#sec:Usage_Outside_N4JSIDE"></a><a class="link" href="#sec:Usage_Outside_N4JSIDE">13.5.1. Usage Outside N4JSIDE</a></h4>
+<div class="paragraph">
+<p>In this use case we use provdied <code>Engine</code> class that allows to execute js code in form of <code>String</code> or <code>File</code> with the code. In return user receives <code>EngineOutput</code> object with two lists of strings containing standard output and error output of the node process, that were captured during execution.</p>
+</div>
+<div class="paragraph">
+<p>In this usage scenario execution api assumes valid JS code. User needs to ensure compilation of code prior to execution, if needed.</p>
+</div>
+<div class="paragraph">
+<p>That functionality is used in internal jUnit tests and in xpect tests of the compiler.</p>
+</div>
+<div class="sect4">
+<h5 id="sec:Use_Node_with_Maven"><a class="anchor" href="#sec:Use_Node_with_Maven"></a><a class="link" href="#sec:Use_Node_with_Maven">13.5.1.1. Use Node with Maven</a></h5>
+<div class="paragraph">
+<p>Note on maven usage. For maven based builds we need to ensure that binary resources are available and are unpacked. To do this in pom of the project that will be calling engine we must include following listing:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xml" data-lang="xml">            &lt;plugin&gt;
+                &lt;groupId&gt;org.apache.maven.plugins&lt;/groupId&gt;
+                &lt;artifactId&gt;maven-dependency-plugin&lt;/artifactId&gt;
+                &lt;executions&gt;
+                    &lt;execution&gt;
+                        &lt;id&gt;unpack&lt;/id&gt;
+                        &lt;phase&gt;process-test-classes&lt;/phase&gt;
+                        &lt;goals&gt;
+                            &lt;goal&gt;unpack&lt;/goal&gt;
+                        &lt;/goals&gt;
+                        &lt;configuration&gt;
+                            &lt;artifactItems&gt;
+                                &lt;artifactItem&gt;
+                                    &lt;groupId&gt;org.eclipse.n4js&lt;/groupId&gt;
+                                    &lt;artifactId&gt;org.eclipse.n4js.js.engine&lt;/artifactId&gt;
+                                    &lt;version&gt;0.0.1-SNAPSHOT&lt;/version&gt;
+                                    &lt;overWrite&gt;true&lt;/overWrite&gt;
+                                    &lt;outputDirectory&gt;
+                                        ${project.build.directory}/classes
+                                    &lt;/outputDirectory&gt;
+                                &lt;/artifactItem&gt;
+                            &lt;/artifactItems&gt;
+                        &lt;/configuration&gt;
+                    &lt;/execution&gt;
+                &lt;/executions&gt;
+            &lt;/plugin&gt;</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Usage_Inside_N4JSIDE"><a class="anchor" href="#sec:Usage_Inside_N4JSIDE"></a><a class="link" href="#sec:Usage_Inside_N4JSIDE">13.5.2. Usage Inside N4JSIDE</a></h4>
+<div class="paragraph">
+<p>In Eclipse platfrom based environment we use custom implementation of the engine, <code>PlatformEngine</code>. This implementation unlike default <code>Platform</code> is non blocking implementation that forwards output to platform console and allows platform to control lifecycle of the running engine. Additionally this version uses its own implementation of the <code>ResourceUrlResolver</code>. It is required to properly resolve urls that point inside platform bundles.</p>
+</div>
+<div class="paragraph">
+<p>This scenario we assume that user will run N4JS files or JS files. We have created proper UI hooks that allow user to do this either from editor or as selection menu. Based on name of the file that user commands to execute we find proper compiled file (compiled with our ES5 compiler - it is not configurable). When found we execute this file in our execution engine. If it is not found, execution engine will write appropriate error to N4JSIDE console.</p>
+</div>
+</div>
+</div>
+<div class="sect2 langauge-n4js">
+<h3 id="sec:Runtime_Injection"><a class="anchor" href="#sec:Runtime_Injection"></a><a class="link" href="#sec:Runtime_Injection">13.6. Runtime Injection</a></h3>
+<div class="paragraph">
+<p>There is need to inject into runtime environment some special code, for example when compiling N4JS to ES5 (see N4JavaScriptSpecification,chapter N4 JS Compilation). To achieve this wee need to inject desired code when calling engine to run desired compiled code. Injection mechanism depends a lot on way we run engine. In this section injection of runtime is discussed based on NodeJs that is used as runtime environment.</p>
+</div>
+<div class="sect3">
+<h4 id="sec:Running_String_Code"><a class="anchor" href="#sec:Running_String_Code"></a><a class="link" href="#sec:Running_String_Code">13.6.1. Running String Code</a></h4>
+<div class="paragraph">
+<p>We allow code execution where code is provided in form of <code>String</code>. In this case we are calling nodejs with parameters . To enrich execution environment in this case we are appending special runtime code at the end of file. It is important to append it at the end, to avoid changing line numbers of original code and decrease other potential side effects. So actual invocation of nodejs looks like</p>
+</div>
+<div class="paragraph">
+<p>This mechanism assumes:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>injected code starts with new line - this makes ASI mechanism to finish user last statement if it was not properly finished by user, otherwise just creates</p>
+</li>
+<li>
+<p>injected code does not have to be initiated manually - all exposed api is in named function declarations</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p><em>Explanation</em></p>
+</div>
+<div class="paragraph">
+<p>In first assumption we make workaround for user code that does not contain new line or semicolon at the end of last statement. This kind of code is incorrect and would result in last statement of user code and first statement of injected code to be interpreted as one JS statement. In most cases that would be invalid code. By having new line as first character of injected code, we are taking advantage of JS AutomaticSemicolonInjection mechanism. If user code AST is not finished properly this mechanism will finish close user AST. If user AST is finished properly, ASI will just insert empty statement between user code and injection code. In both cases we end up with proper AST.</p>
+</div>
+<div class="paragraph">
+<p>Second assumption avoids need for further user code modifications, as injected does not have to be manually called. Instead we take advantage of variable and function hoisting mechanism of JS. This assures that even though user code is first in AST, JS environment will first initiate named functions therefore when user code calls injected code it is already defined in scope in which user code executes.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Running_File_Code"><a class="anchor" href="#sec:Running_File_Code"></a><a class="link" href="#sec:Running_File_Code">13.6.2. Running File Code</a></h4>
+<div class="paragraph">
+<p>Second method of code execution is to execute provided file with user code. Normal way of doing that with NodeJS is to make call. But since we need to inject special code without rewriting files, we use different mechanism. Basically we are executing injected code and in the same scope using node api. Additionally we are attaching injected code to global scope in node, ensuring this way that required file is executed in scope which contains injected code. Putting this all together we are making following call:</p>
+</div>
+<div class="paragraph">
+<p>This mechanism assumes that injected code attaches all exposed API to global scope .</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Injection_Code_Example"><a class="anchor" href="#sec:Injection_Code_Example"></a><a class="link" href="#sec:Injection_Code_Example">13.6.3. Injection Code Example</a></h4>
+<div class="paragraph">
+<p>Following is simple example of properly formed injection code.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">;
+function foo(){}
+function bar(){}
+function baz(){}
+
+(function(){
+ GLOBAL.foo = foo;
+ GLOBAL.bar = bar;
+ GLOBAL.baz = baz;
+})();
+;</code></pre>
+</div>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>first line is empty line to trigger ASI</p>
+</li>
+<li>
+<p>second line (optional) enters</p>
+</li>
+<li>
+<p>lines 3-5 are defining runtime api in current scope (in which user code provided as a string is executed)</p>
+</li>
+<li>
+<p>lines 6 (optional) is just a visual sugar</p>
+</li>
+<li>
+<p>lines 7-11 are adding runtime api to global scope (to expose it when runnig user file with code)</p>
+</li>
+<li>
+<p>lines 12-13 (optional) are there to separate injected code and invokation of user file (if running user provided file with code)</p>
+</li>
+</ol>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_tests"><a class="anchor" href="#_tests"></a><a class="link" href="#_tests">14. Tests</a></h2>
+<div class="sectionbody">
+<div class="admonitionblock warning">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-warning" title=""></i>
+</td>
+<td class="content">
+This chapter may be outdated.
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>In order to run all tests from command line, use maven:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre>mvn clean verify</pre>
+</div>
+</div>
+<div class="paragraph">
+<p>You may have to increase the memory for maven via <code>export MAVEN_OPTS="-Xmx2048m"</code> (Unix) or <code>set MAVEN_OPTS="-Xmx2048m"</code> (Windows).</p>
+</div>
+<div class="paragraph">
+<p>Do not run the tests via <code>mvn clean test</code> as this may lead to some failures.</p>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:Performance_Tests"><a class="anchor" href="#sec:Performance_Tests"></a><a class="link" href="#sec:Performance_Tests">14.1. Performance Tests</a></h3>
+<div class="paragraph">
+<p>There are two kind of performance tests:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Synthetic Tests: an arbitrary number of test classes is generated, and then some modifications are performed on these classes.</p>
+</li>
+<li>
+<p>Real World Tests: tests are based on a snapshot version of our platform libraries</p>
+</li>
+</ol>
+</div>
+<div class="sect3">
+<h4 id="sec:Synthetic_Performance_Tests"><a class="anchor" href="#sec:Synthetic_Performance_Tests"></a><a class="link" href="#sec:Synthetic_Performance_Tests">14.1.1. Synthetic Performance Tests</a></h4>
+<div class="paragraph">
+<p>The idea of the synthetic performance tests is to test the performance of specific functionality with a defined number classes, specially designed for the functionality under test.</p>
+</div>
+<div class="paragraph">
+<p>The overall structure of the synthetic performance test is</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>generate test classes</p>
+</li>
+<li>
+<p>compile these classes</p>
+</li>
+<li>
+<p>modify the test classes</p>
+</li>
+<li>
+<p>measure incremental build time</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>Step 3) and 4) can be done in a loop. Also, step 2) can be looped (with clean build).</p>
+</div>
+<div class="paragraph">
+<p>The test classes are spread over clusters and projects. The following categories are used:</p>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Cluster
+</td>
+<td class="hdlist2">
+<p>A cluster is a set of projects, each project of a cluster may depend on another project of the cluster. There are no dependencies between projects of different clusters</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Project
+</td>
+<td class="hdlist2">
+<p>A project simply is a N4JS project, containing packages. A project may depend on other projects.</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Package
+</td>
+<td class="hdlist2">
+<p>A package is a folder in a source folder of a project. A package contains classes.</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Class
+</td>
+<td class="hdlist2">
+<p>A class is defined in a file, usually one class per file. The file, and with it the class, is contained in a package. The class contains members.</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Member
+</td>
+<td class="hdlist2">
+<p>A member is either a field or method of a class. A method may has a body, which may contain variables with references to other classes.</p>
+</td>
+</tr>
+</table>
+</div>
+<div class="sect4 language-n4js">
+<h5 id="sec:Design_of_Generator"><a class="anchor" href="#sec:Design_of_Generator"></a><a class="link" href="#sec:Design_of_Generator">14.1.1.1. Design of Generator</a></h5>
+<div class="paragraph">
+<p><a href="#fig:cd_performancetest_generator">Performance Generator</a> shows the classes of the performance test generator.</p>
+</div>
+<div id="fig:cd_performancetest_generator" class="imageblock">
+<div class="content">
+<img src="chapters/15_tests/images/cd_performancetest_generator.svg" alt="cd performancetest generator">
+</div>
+</div>
+<div class="paragraph">
+<p>The package is designed as follows:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p><code>N4ProjectGenerator</code> main control class for generation</p>
+</li>
+<li>
+<p><code>TestDescriptor</code> and subclasses: In order to <em>keep memory consumption of the test class generator low</em>, there is no graph structure created for the test elements. Instead, each element is uniquely named by a number, this number (actually a tuple of numbers) is stored in <code>TestDescriptors</code> and sub classes. There is a descriptor for each element of the tests.</p>
+</li>
+<li>
+<p><code>AbstractModifier</code> and subclasses generarate the tests. The idea is as follows:</p>
+<div class="ulist">
+<ul>
+<li>
+<p><code>Modifier</code> generates all files, with complete references and no issues (complete)</p>
+</li>
+<li>
+<p>sub classes of <code>Modifier</code> skip certain generations or add modifications, leading to issues or solving them</p>
+</li>
+</ul>
+</div>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>In order to compute the name of a class from its descriptor, as well as retrieving a class based on an absolute number, the modifiers use utility methods provided by <code>PerformanceTestConfiguration</code>. Note that computing the names and numbers depends on a configuration!</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Design_of_Performance_Test_Execution"><a class="anchor" href="#sec:Design_of_Performance_Test_Execution"></a><a class="link" href="#sec:Design_of_Performance_Test_Execution">14.1.1.2. Design of Performance Test Configuration and Execution</a></h5>
+<div class="paragraph">
+<p><a href="#fig:cd_performancetest_configAnRun">Class Diagram of Performance Test Configuration and Execution</a> shows the classes of the performance test configuration and execution.</p>
+</div>
+<div id="fig:cd_performancetest_configAnRun" class="imageblock">
+<div class="content">
+<img src="chapters/15_tests/images/cd_performancetest_configAnRun.svg" alt="cd performancetest configAnRun">
+</div>
+<div class="title">Figure 45. Class Diagram of Performance Test Configuration and Execution</div>
+</div>
+<div class="paragraph">
+<p>The package is designed as follows:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p><code>PerformanceTestConfiguration</code> stores the test configuration. The configuration stores how many clusters, packages etc. are to be generated. It also provides methods for generating names from the descriptors mentioned above.</p>
+</li>
+<li>
+<p><code>PerformanceMeter</code> executes the test, listening to the (build) job to be finished etc.</p>
+</li>
+<li>
+<p><code>AbstractGeneratingPerformanceTest</code> Base test class contains setup, teardown and utility methods.</p>
+</li>
+<li>
+<p><code>PerformanceTest</code> Test class containing tests.</p>
+</li>
+</ol>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:JUnit_Configuration"><a class="anchor" href="#sec:JUnit_Configuration"></a><a class="link" href="#sec:JUnit_Configuration">14.1.1.3. JUnit Configuration</a></h5>
+<div class="paragraph">
+<p>We are using JUnitBenchamrks (<a href="http://labs.carrotsearch.com/junit-benchmarks.html/" class="bare">http://labs.carrotsearch.com/junit-benchmarks.html/</a>) to extend adjust plain JUnit behavior specifically to the performance tests needs.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:JUnitBenchmark_Test_Configuration"><a class="anchor" href="#sec:JUnitBenchmark_Test_Configuration"></a><a class="link" href="#sec:JUnitBenchmark_Test_Configuration">14.1.1.4. JUnitBenchmark Test Configuration</a></h5>
+<div class="paragraph">
+<p>JUnitBenchmark test configuration performed by annotating test method with <code>@BenchmarkOptions</code>. Parameters for that annotation include:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p><code>warmupRounds</code> how many times test will be executed without taking measurement</p>
+</li>
+<li>
+<p><code>benchmarkRounds</code> how many times test will be executed, measurements taken will be used in results report</p>
+</li>
+<li>
+<p><code>callgc</code> Call <code>System.gc()</code> before each test. This may slow down the tests in a significant way.</p>
+</li>
+<li>
+<p><code>concurrency</code> specifies how many threads to use for tests.</p>
+</li>
+<li>
+<p><code>clock</code> specifies which clock to use.</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>Typical configuration for our performance tests might look like:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>    @BenchmarkOptions(benchmarkRounds = 5, warmupRounds = 2)
+    @Test
+    public void test() throws Exception {
+        //test...
+    }</code></pre>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:JUnitBenchmark_Report_Configuration"><a class="anchor" href="#sec:JUnitBenchmark_Report_Configuration"></a><a class="link" href="#sec:JUnitBenchmark_Report_Configuration">14.1.1.5. JUnitBenchmark Report Configuration</a></h5>
+<div class="paragraph">
+<p>By annotating TestClass in proper way, JUnitBenchamrks will generate html reports with performance results. There are two reports that can be generated:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p><code>@BenchmarkMethodChart</code> report will contain results for every method from one test run (but all <code>benchmarkRounds</code> defined)</p>
+<div class="ulist">
+<ul>
+<li>
+<p><code>filePrefix</code> defines report file name</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p><code>@BenchmarkHistoryChart</code> report will contain trend of results from multiple test runs (it is aggregation of multiple instances of <code>@BenchmarkMethodChart</code> report)</p>
+<div class="ulist">
+<ul>
+<li>
+<p><code>filePrefix</code> defines report file name</p>
+</li>
+<li>
+<p><code>labelWith</code> defines label that will mark separate runs</p>
+</li>
+</ul>
+</div>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p><em>labelWith</em> property can have value propagated from run configuration/command line. example configuration might be <code>@BenchmarkHistoryChart(filePrefix = benchmark-history, labelWith = LabelType.CUSTOM_KEY)</code></p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:JUnitBenchmark_Run_Configuration"><a class="anchor" href="#sec:JUnitBenchmark_Run_Configuration"></a><a class="link" href="#sec:JUnitBenchmark_Run_Configuration">14.1.1.6. JUnitBenchmark Run Configuration</a></h5>
+<div class="paragraph">
+<p>It is possible to specify additional options for performance test run</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p><code>-Djub.consumers=CONSOLE,H2</code> specifies where results will be written, <em>H2</em> indicates H2 database to be used</p>
+</li>
+<li>
+<p><code>-Djub.db.file=.benchmarks</code> specifies name of the H2 database file</p>
+</li>
+<li>
+<p><code>-Djub.customkey=</code> value of that property scan be used as label in <code>@BenchmarkHistoryChart</code></p>
+</li>
+</ol>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:JUnitBenchmark_Example"><a class="anchor" href="#sec:JUnitBenchmark_Example"></a><a class="link" href="#sec:JUnitBenchmark_Example">14.1.1.7. JUnitBenchmark Example</a></h5>
+<div class="paragraph">
+<p>configuration example:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>@BenchmarkMethodChart(filePrefix = "benchmark-method")
+@BenchmarkHistoryChart(filePrefix = "benchmark-history", labelWith = LabelType.CUSTOM_KEY)
+public class PerformanceTest extends AbstractGeneratingPerformanceTest {
+
+    public PerformanceTest() {
+        super("PerfTest");
+    }
+
+    @Rule
+    public TestRule benchmarkRun = new BenchmarkRule();
+
+    @Test
+    @BenchmarkOptions(benchmarkRounds = 5, warmupRounds = 2)
+    public void Test1() throws Exception {
+
+        //Test...
+    }
+
+    @Test
+    @BenchmarkOptions(benchmarkRounds = 5, warmupRounds = 2)
+    public void Test2() throws Exception {
+
+        //Test...
+    }
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>executing this code in Eclipse with configuration:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-bash" data-lang="bash">-Xms512m -Xmx1024m -XX:MaxPermSize=512m $-$Djub.consumers=CONSOLE,H2 $-$Djub.db.file=.benchmarks $-$Djub.customkey=${current_date}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>will cause :</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>both tests to be executed 2 times for the warmup</p>
+</li>
+<li>
+<p>both of tests being executed 5 times with measurement taken</p>
+</li>
+<li>
+<p>results written to console</p>
+</li>
+<li>
+<p>results stored in local H2 db file (created if doesn’t exist)</p>
+</li>
+<li>
+<p>generated <em>benchmark-method.html</em> with performance results of every test in that execution</p>
+</li>
+<li>
+<p>generated <em>benchmark-history.html</em> with performance results of every execution</p>
+</li>
+<li>
+<p>separate test executions will be labeled in <em>benchmark-history.html</em> with their start time</p>
+</li>
+</ol>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Note_on_Jenkins_Job"><a class="anchor" href="#sec:Note_on_Jenkins_Job"></a><a class="link" href="#sec:Note_on_Jenkins_Job">14.1.1.8. Note on Jenkins Job</a></h5>
+<div class="paragraph">
+<p>For performance tests it is important not to get pass/fail result in terms of being below given threshold, but also to examine trend of those results. We achieve this by tooling described above. In order to keep this data independent of the build machine or build system storage, we are using separate repository to store performance artifacts. Jenkins in copying previous test results into workspace, runs performance tests, then commits and pushes combined results (adds current results to previous results) to repository.</p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:ECMA_Tests"><a class="anchor" href="#sec:ECMA_Tests"></a><a class="link" href="#sec:ECMA_Tests">14.2. ECMA Tests</a></h3>
+<div class="paragraph">
+<p>ECMAScript Language test262 is a test suite intended to check agreement between JavaScript implementations and ECMA-262, the ECMAScript Language Specification (currently 5.1 Edition).The test suite contains thousands of individual tests, each of which tests some specific requirements of the ECMAScript Language Specification. For more info refer to <a href="http://test262.ecmascript.org/" class="bare">http://test262.ecmascript.org/</a></p>
+</div>
+<div class="paragraph">
+<p>Uses of this suite may include:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>grammar tests</p>
+</li>
+<li>
+<p>validation tests</p>
+</li>
+<li>
+<p>run-time tests</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>ECMA test262 suite source code can be found here: <a href="http://hg.ecmascript.org/tests/test262" class="bare">http://hg.ecmascript.org/tests/test262</a></p>
+</div>
+<div class="sect3">
+<h4 id="sec:Grammar_Tests"><a class="anchor" href="#sec:Grammar_Tests"></a><a class="link" href="#sec:Grammar_Tests">14.2.1. Grammar Tests</a></h4>
+<div class="paragraph">
+<p>Based on the JS files included in test262 suite we are generating tests that feed provided JS code into the parser. This operation will result in</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>parser throwing exceptions</p>
+</li>
+<li>
+<p>parsed output will contain standard output</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>First case indicates that parsing provided JS code was not possible. This is considered to be Test Error.</p>
+</div>
+<div class="paragraph">
+<p>Second case case indicates that parsing of the provided code was successful, and will result either</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>output with no errors - code adhered parser grammar</p>
+</li>
+<li>
+<p>output with errors - code violated parser grammar</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Given test must interpret those results to provide proper test output.</p>
+</div>
+<div class="sect4">
+<h5 id="sec:Negative_Tests"><a class="anchor" href="#sec:Negative_Tests"></a><a class="link" href="#sec:Negative_Tests">14.2.1.1. Negative Tests</a></h5>
+<div class="paragraph">
+<p>It is important to note that some of the tests are positive and some are negative. Negative test cases are marked by the authors with <em>@negative</em> JSDoc like marker therefore parser tests must be aware of that to avoid both false positives and false negatives results.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Test_Exclusion"><a class="anchor" href="#sec:Test_Exclusion"></a><a class="link" href="#sec:Test_Exclusion">14.2.1.2. Test Exclusion</a></h5>
+<div class="paragraph">
+<p>To exclude validation tests or run-time related test, implementation is blacklist approach to exclude some of the ECMA test262 tests from execution.</p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:Integration_Tests"><a class="anchor" href="#sec:Integration_Tests"></a><a class="link" href="#sec:Integration_Tests">14.3. Integration Tests</a></h3>
+<div class="paragraph">
+<p>Integration tests based on the stdlib and online-presence code bases can be found in bundle <code>org.eclipse.n4js.hlc.tests</code>
+in package <code>org.eclipse.n4js.hlc.tests.integration</code> (headless case) and in bundle <code>org.eclipse.n4js.ui.tests</code> in
+package <code>org.eclipse.n4js.ui.tests.integration</code> (plugin-UI tests running inside Eclipse). The headless
+tests also execute mangelhaft tests, the UI tests only perform compilation of the test code.</p>
+</div>
+<div class="paragraph">
+<p>More information can be found in the API documentation of classes <code>AbstractIntegrationTest</code> and <code>AbstractIntegrationPluginUITest</code>.</p>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:Test_Helpers"><a class="anchor" href="#sec:Test_Helpers"></a><a class="link" href="#sec:Test_Helpers">14.4. Test Helpers</a></h3>
+<div class="paragraph">
+<p>Test helpers contain utility classes that are reused between different test plug-ins.</p>
+</div>
+<div class="sect3">
+<h4 id="sec:Parameterized_N4JS_Tests"><a class="anchor" href="#sec:Parameterized_N4JS_Tests"></a><a class="link" href="#sec:Parameterized_N4JS_Tests">14.4.1. Parameterized N4JS tests</a></h4>
+<div class="paragraph">
+<p>Xtext JUnit test runer injects test a ParserHelper that allows to run N4JS parser on given input and obtain information abut parsing results. In some cases we want to run this kind of tests on large input data. To address this we provide two utilities ParameterizedXtextRunner and TestCodeProvider. They allow write data driven parser tests.</p>
+</div>
+<div class="sect4">
+<h5 id="sec:ParameterizedXtextRunner"><a class="anchor" href="#sec:ParameterizedXtextRunner"></a><a class="link" href="#sec:ParameterizedXtextRunner">14.4.1.1. ParameterizedXtextRunner</a></h5>
+<div class="paragraph">
+<p>This This junit runner serves two purposes:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>injecting ParserHelper</p>
+</li>
+<li>
+<p>creating multiple test instances for each input data provided</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>This class is based on @link org.eclipse.xtext.testing.XtextRunner and @link org.junit.runners.Parameterized</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:TestCodeProvider"><a class="anchor" href="#sec:TestCodeProvider"></a><a class="link" href="#sec:TestCodeProvider">14.4.1.2. TestCodeProvider</a></h5>
+<div class="paragraph">
+<p>This class is repsonsible for extracting ZipEntry from provided ZipFile. Additinally it can filter out entries that match strings in provided black list file. Filtering out ZipEntries assumes that blacklist file contians Path of ZipEntry in ZipFile as string in one line. Lines starting with <em>#</em> in black list file are ignored by TestCodeProvider.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Example_Of_Parameterized_Parser_Test"><a class="anchor" href="#sec:Example_Of_Parameterized_Parser_Test"></a><a class="link" href="#sec:Example_Of_Parameterized_Parser_Test">14.4.1.3. Example of parameterized parser test</a></h5>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">@RunWith(XtextParameterizedRunner.class)
+@InjectWith(N4JSInjectorProvider.class)
+public class DataDrivenParserTestSuite {
+
+    /**
+     * Zip archives containing test files.
+     */
+    public static final Collection&lt;String&gt; TEST_DATA_RESOURCES = Arrays.asList("foo.zip", "bar.zip");
+
+    /**
+     * Blacklist of files requiring an execution engine.
+     */
+    public static final String BLACKLIST_FILENAME = "blacklist.txt";
+
+    /**
+     * Every generated test will use different ZipEntry as test data
+     */
+    final ZipEntry entry;
+
+    /**
+     * Name of resource containing corresponding ZipEntry
+     */
+    final String resourceName;
+
+    @Inject
+    protected ParseHelper&lt;Script&gt; parserN4JS;
+
+    Collection&lt;String&gt; blackList;
+
+    static final Logger logger = Logger.getLogger("someLogger");
+
+    public CopyOfLibraryParsingTestSuite(ZipEntry entry, String resourceName, Collection&lt;String&gt; blackList) {
+        this.entry = entry;
+        this.resourceName = resourceName;
+        this.blackList = blackList;
+    }
+
+    @Rule
+    public TestRule blackListHandler = new TestRule() {
+        @Override
+        public Statement apply(final Statement base, Description description) {
+            final String entryName = entry.getName();
+            if (blackList.contains(entryName)) {
+                return new Statement() {
+                    @Override
+                    public void evaluate() throws Throwable {
+                        try {
+                            base.evaluate();
+                        } catch (AssertionError e) {
+                            // expected
+                            return;
+                        }
+                    }
+                };
+            } else {
+                return base;
+            }
+        }
+    };
+
+    /**
+     * Generates collection of ZipEntry instances that will be used as data
+     * provided parameter is mapped to name of the test (takes advantage of fact
+     * that ZipEntry.toString() is the same as entry.getName())
+     *
+     * @return
+     * @throws URISyntaxException
+     * @throws ZipException
+     * @throws IOException
+     */
+    @Parameters(name = "{0}")
+    public static Collection&lt;Object[]&gt; data() throws URISyntaxException, ZipException, IOException {
+        return TestCodeProvider.getDataFromZippedRoots(TEST_DATA_RESOURCES, BLACKLIST_FILENAME);
+    }
+
+    /**
+     * generated instances of the tests will use this base implementation
+     *
+     * @throws Exception
+     */
+    @Test
+    public void test() throws Exception {
+        assertNotNull(this.entry);
+        assertNotNull(this.resourceName);
+        assertNotNull(this.parserN4JS);
+
+        //actual test code
+
+    }
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:Issue_Suppression"><a class="anchor" href="#sec:Issue_Suppression"></a><a class="link" href="#sec:Issue_Suppression">14.5. Issue Suppression</a></h3>
+<div class="paragraph">
+<p>It can be useful to suppress certain issues before tests are ran, so that test expectations don’t have to consider inessential warnings. This means that the validator still returns a full list of issues, but before passing them to the testing logic, the issues are filtered.</p>
+</div>
+<div class="paragraph">
+<p>When working with JUnit tests, the custom InjectorProvider <code>N4JSInjectorProviderWithIssueSuppression</code> can be used to configure them to suppress issues.</p>
+</div>
+<div class="paragraph">
+<p>The codes that are suppressed are globally specified by the<br>
+<code>DEFAULT_SUPPRESSED_ISSUE_CODES_FOR_TESTS</code> constant in <code>N4JSLanguageConstants</code>.</p>
+</div>
+<div class="paragraph">
+<p>When working with Xpect tests, the XpectSetupFactory <code>SuppressIssuesSetup</code> can be used. See <a href="#sec:Xpect_Issue_Suppression">Xpext Issue Suppression</a> for more details on Xpect issue suppression.</p>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:Xpect_Tests"><a class="anchor" href="#sec:Xpect_Tests"></a><a class="link" href="#sec:Xpect_Tests">14.6. Xpect Tests</a></h3>
+<div class="paragraph">
+<p>For many tests, Xpect [<a href="#Xpect">Xpect</a>] is used. Xpect allows for defining tests inside the language which is the language under test. That is, it is possible to refer to a JUnit test method in a special annotated comment, along with arguments passed to that method (typically expectations and the concrete location). Xpect comes with a couple of predefined methods which could be used there, e.g., tests for checking whether some expected error messages actually are produced. We have defined (and will probably define more) N4JS specific test methods.</p>
+</div>
+<div class="paragraph">
+<p>In the following, we describe the most common Xpect test methods we use. Note that we do not use all types of tests shipped with Xpect. For example, AST tests (comparing the actual AST with an expected AST, using string dumps) is too hard to maintain.</p>
+</div>
+<div class="paragraph">
+<p>Xpect test can be ignored by inserting a <code>!</code> between <code>XPECT</code> and the test name, e.g.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>// XPECT ! errors --&gt; '~$message$~' at "~$location$~"</code></pre>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Xpect_Test_Setup"><a class="anchor" href="#sec:Xpect_Test_Setup"></a><a class="link" href="#sec:Xpect_Test_Setup">14.6.1. Xpect Test Setup</a></h4>
+<div class="paragraph">
+<p>The setup is either defined in the file itself, e.g.,</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>/* XPECT_SETUP org.eclipse.n4js.spec.tests.N4JSSpecTest END_SETUP */</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>or bundle-wide for a specific language in the plugin.xml (or fragment.xml), e.g.,</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>&lt;extension point="org.xpect.testSuite"&gt;
+    &lt;testSuite class="org.eclipse.n4js.spec.tests.N4JSSpecTest" fileExtension="n4js" /&gt;
+&lt;/extension&gt;</code></pre>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Xpect_Issue_Suppression"><a class="anchor" href="#sec:Xpect_Issue_Suppression"></a><a class="link" href="#sec:Xpect_Issue_Suppression">14.6.2. Xpect Issue Suppression</a></h4>
+<div class="paragraph">
+<p>To configure an Xpect test class to suppress issues, you have to use the <code>@XpectImport</code> annotation to import the XpectSetupFactory <code>org.eclipse.n4js.xpect.validation.suppression.SuppressIssuesSetup</code>. Any Xpect test that is executed by this runner will work on the filtered list of issues.</p>
+</div>
+<div class="paragraph">
+<p>Similar to issue suppressing JUnit tests, the suppressed issue codes are specified by<br>
+<code>DEFAULT_SUPPRESSED_ISSUE_CODES_FOR_TESTS</code> constant in <code>N4JSLanguageConstants</code>.</p>
+</div>
+<div class="paragraph">
+<p>For further per-file configuration a custom <code>XPECT_SETUP</code> parameter can be used. This overrides the suppression configuration of an Xpect runner class for the current file.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>/* XPECT_SETUP org.eclipse.n4js.tests.N4JSXpectTest
+
+IssueConfiguration {
+    IssueCode "AST_LOCAL_VAR_UNUSED" {enabled=true}
+}
+
+END_SETUP
+*/</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>In this example the issue code <code>AST_LOCAL_VAR_UNUSED</code> is explicitly enabled which means that no issue with this issue code will be suppressed.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Xpect_Provided_Test_Methods"><a class="anchor" href="#sec:Xpect_Provided_Test_Methods"></a><a class="link" href="#sec:Xpect_Provided_Test_Methods">14.6.3. Xpect Provided Test Methods</a></h4>
+<div class="sect4">
+<h5 id="errors"><a class="anchor" href="#errors"></a><a class="link" href="#errors">14.6.3.1. errors</a></h5>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Definition
+</td>
+<td class="hdlist2">
+<p>Single line:</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>// XPECT errors --&gt; '~$message$~' at "~$location$~"</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Multi line:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>/* XPECT errors ---
+'~$message_1$~' at "~$location_1$~"
+~$\dots$~
+'~$message_n$~' at "~$location_n$~"
+--- */</code></pre>
+</div>
+</div>
+</td>
+</tr>
+</table>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Description
+</td>
+<td class="hdlist2">
+<p>Checks that one or more errors are issued at given location and compares the actual messages at a given location with the expected messages specified in the test.</p>
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>Also see <code>no errors</code> below.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="warnings"><a class="anchor" href="#warnings"></a><a class="link" href="#warnings">14.6.3.2. warnings</a></h5>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Definition
+</td>
+<td class="hdlist2">
+<p>Single line:<br></p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>// XPECT warnings --&gt; '~$Message$~' at "~$Location$~"</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Multi line:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>/* XPECT warnings ---
+'~$message_1$~' at "~$location_1$~"
+~$\dots$~
+'~$message_n$~' at "~$location_n$~"
+--- */</code></pre>
+</div>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Description
+</td>
+<td class="hdlist2">
+<p>Checks that one or more warnings are issued at given location and compares the actual messages at a given location with the expected messages specified in the test.</p>
+</td>
+</tr>
+</table>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:N4JS_Specific_Xpect_Test_Methods"><a class="anchor" href="#sec:N4JS_Specific_Xpect_Test_Methods"></a><a class="link" href="#sec:N4JS_Specific_Xpect_Test_Methods">14.6.4. N4JS Specific Xpect Test Methods</a></h4>
+<div class="paragraph">
+<p>There are a lot of N4 specific Xpect tests methods available. To get all of these methods, search for references to annotation <code>org.xpect.runner.Xpect</code> in the N4 test plugins.</p>
+</div>
+<div class="sect4">
+<h5 id="sec:XPECT_noerrors"><a class="anchor" href="#sec:XPECT_noerrors"></a><a class="link" href="#sec:XPECT_noerrors">14.6.4.1. noerrors and nowarnings</a></h5>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Definition
+</td>
+<td class="hdlist2">
+<p>Single line:</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>// XPECT noerrors --&gt; '~$messageOrComment$~' at "~$location$~"</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Multi line:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>/* XPECT noerrors ---
+'~$messageOrComment_1$~' at "~$location_1$~"
+~$\dots$~
+'~$messageOrComment_n$~' at "~$location_n$~"
+--- */</code></pre>
+</div>
+</div>
+</td>
+</tr>
+</table>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Provided by
+</td>
+<td class="hdlist2">
+<p><code>NoerrorsValidationTest</code></p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Description
+</td>
+<td class="hdlist2">
+<p>Checks that at the given location <em>no</em> error (or warning) is issued. This tests is roughly speaker the opposite of <code>errors</code>. The idea behind this test is to replace comments in the code, stating that an expression is assumed to be valid, with an explicit test. This is in particular useful when you start working on a task, in which there are (wrong) errors at a given position, or for bug report.</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Example
+</td>
+<td class="hdlist2">
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>function foo(any o): number {
+    if (o instanceof string) {
+        // XPECT noerrors --&gt; "effect systems knows that o is a string" at "o"
+        return o.length;
+    }
+    return 0;
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>is clearer and more explicit than</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>function foo(any o): number {
+    if (o instanceof string) {
+        // here should be no error:
+        return o.length;
+    }
+    return 0;
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Also, the <code>noerrors</code> version will fail with a correct description, while the second one would fail with a general error and no location. Once the feature is implemented, regressions are detected much easier with the explicit version.</p>
+</div>
+</div>
+</div>
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:XPECT_scope"><a class="anchor" href="#sec:XPECT_scope"></a><a class="link" href="#sec:XPECT_scope">14.6.4.2. scope</a></h5>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Definition
+</td>
+<td class="hdlist2">
+<p>Single line:</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>// XPECT scope at $location$ --&gt; ~$[$~!~$]$~~$name_1$~, ~$\dots$~, ~$[$~!~$]$~~$name_n$~ ~$[$ ~, ...~$]$~</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Multi line:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>/* XPECT scope $location$ ---
+~$[$~!~$]$~~$name_1$~, ~$\dots$~,
+~$[$~!~$]$~~$name_n$~~$[$ ~, ...~$]$~
+--- */</code></pre>
+</div>
+</div>
+</td>
+</tr>
+</table>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Provided by
+</td>
+<td class="hdlist2">
+<p><code>PositionAwareScopingXpectTest</code></p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Description
+</td>
+<td class="hdlist2">
+<p>Checks that the expected elements are actually found in the scope (or explicitly not found, when <code>!</code>   is used). This is a modified version of the Xpect built-in scope test, ensuring that also elements only put into the scope when they are explicitly requested are found.</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Example
+</td>
+<td class="hdlist2">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>// XPECT scope at 'this.|$data_property_b' --&gt; a, b, $data_property_b, !newB, ...
+return this.$data_property_b + "_getter";</code></pre>
+</div>
+</div>
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:XPECT_scopeWithPosition"><a class="anchor" href="#sec:XPECT_scopeWithPosition"></a><a class="link" href="#sec:XPECT_scopeWithPosition">14.6.4.3. scopeWithPosition</a></h5>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Definition
+</td>
+<td class="hdlist2">
+<p>Single line:</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">// XPECT scopeWithPosition at $location$ --&gt; ~$[$~!~$]$~~$name_1$~ - ~$pos_1$~, ~$\dots$~, ~$[$~!~$]$~~$name_n$~ - ~$pos_n$~ ~$[$ ~, ...~$]$~</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Multi line:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">/* XPECT scopeWithPosition $location$ ---
+~$[$~!~$]$~~$name_1$~ - ~$pos_1$~, ~$\dots$~,
+~$[$~!~$]$~~$name_n$~ - ~$pos_n$~ ~$[$ ~, ...~$]$~
+--- */</code></pre>
+</div>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Provided by
+</td>
+<td class="hdlist2">
+<p><code>PositionAwareScopingXpectTest</code></p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Description
+</td>
+<td class="hdlist2">
+<p>Checks that the expected elements are actually found in the scope (or explicitly not found, when <code>!</code>   is used). The concrete syntax of the position, which is usually the line number, or the line number prefix with <code>T</code>   if a type element is referenced, is described in <code>EObjectDescriptionToNameWithPositionMapper</code>.</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Example
+</td>
+<td class="hdlist2">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>/* XPECT scopeWithPosition at foo2 ---
+    b - 9,
+    c - 25,
+    foo - T3,
+    foo2 - T9,
+    ...
+---*/
+foo2()</code></pre>
+</div>
+</div>
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:XPECT_scopeWithResource"><a class="anchor" href="#sec:XPECT_scopeWithResource"></a><a class="link" href="#sec:XPECT_scopeWithResource">14.6.4.4. scopeWithResource</a></h5>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Definition
+</td>
+<td class="hdlist2">
+<p>Single line:</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>//</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Multi line:</p>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Provided by
+</td>
+<td class="hdlist2">
+<p><code>N4JSXpectTest</code></p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Description
+</td>
+<td class="hdlist2">
+<p>Compares scope including resource name but not line number.</p>
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:XPECT_binding"><a class="anchor" href="#sec:XPECT_binding"></a><a class="link" href="#sec:XPECT_binding">14.6.4.5. binding</a></h5>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Definition
+</td>
+<td class="hdlist2">
+<p>Single line:</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>//</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Multi line:</p>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Provided by
+</td>
+<td class="hdlist2">
+<p><code>N4JSXpectTest</code></p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Description
+</td>
+<td class="hdlist2">
+<p>Checks that a given element is bound to something identified by (simple) qualified name. The check is designed as simple as possible. That is, simply the next following expression is tested, and within that we expect a property access or a direct identifiable element. The compared name is the simple qualified name, that is container (type) followed by elements name, without URIs of modules etc.</p>
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:XPECT_linkedPathname"><a class="anchor" href="#sec:XPECT_linkedPathname"></a><a class="link" href="#sec:XPECT_linkedPathname">14.6.4.6. linkedPathname</a></h5>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Definition
+</td>
+<td class="hdlist2">
+<p>Single line:</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>// XPECT linkedPathname at '$location$' --&gt; ~$pathname$~</code></pre>
+</div>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Provided by
+</td>
+<td class="hdlist2">
+<p><code>LinkingXpectMethod</code></p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Description
+</td>
+<td class="hdlist2">
+<p>Checks that an identifier is linked to a given element identified by its path name. The path name is the qualified name in which the segments are separated by ’/’. This test does not use the qualified name provider, as the provider may return null for non-globally available elements. It rather computes the name again by using reflection, joining all <code>name</code>   properties of the target and its containers.</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Example
+</td>
+<td class="hdlist2">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>// XPECT linkedPathname at 'foo()' --&gt; C/foo
+new C().foo();</code></pre>
+</div>
+</div>
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:XPECT_type_of"><a class="anchor" href="#sec:XPECT_type_of"></a><a class="link" href="#sec:XPECT_type_of">14.6.4.7. type of</a></h5>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Definition
+</td>
+<td class="hdlist2">
+<p>Single line:</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>// XPECT type of '$location$' --&gt; ~$type$~</code></pre>
+</div>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Provided by
+</td>
+<td class="hdlist2">
+<p><code>N4JSXpectTest</code></p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Description
+</td>
+<td class="hdlist2">
+<p>Checks that the type inferred at location is similar to expected type.</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Example
+</td>
+<td class="hdlist2">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>// XPECT type of 'x' --&gt; string
+var x = 'hello';
+// XPECT type of 'foo()' --&gt; union{A,number}
+var any y = foo();</code></pre>
+</div>
+</div>
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:XPECT_expectedType"><a class="anchor" href="#sec:XPECT_expectedType"></a><a class="link" href="#sec:XPECT_expectedType">14.6.4.8. expectedType</a></h5>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Definition
+</td>
+<td class="hdlist2">
+<p>-</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Single line
+</td>
+<td class="hdlist2">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>// XPECT expectedType at 'location' --&amp;gt; Type</code></pre>
+</div>
+</div>
+<div class="literalblock">
+<div class="content">
+<pre>The location (at) is optional.</pre>
+</div>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Provided by
+</td>
+<td class="hdlist2">
+<p><code>N4JSXpectTest</code></p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Description
+</td>
+<td class="hdlist2">
+<p>Checks that an element/expression has a certain expected type (i.e. Xsemantics judgment expectedTypeIn).</p>
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:XPECT_elementKeyword"><a class="anchor" href="#sec:XPECT_elementKeyword"></a><a class="link" href="#sec:XPECT_elementKeyword">14.6.4.9. elementKeyword</a></h5>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Definition
+</td>
+<td class="hdlist2">
+<p>Single line:</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>// XPECT elementKeyword at 'myFunction' -&gt; function</code></pre>
+</div>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Example
+</td>
+<td class="hdlist2">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>interface I {
+  fld: int;
+  get g(): string;
+  set s(p:string);
+}
+
+//XPECT elementKeyword at 'string' --&gt; primitive
+var v1: string;
+
+//XPECT elementKeyword at 'I' --&gt; interface
+var i: I;
+
+//XPECT elementKeyword at 'fld' --&gt; field
+i.fld;</code></pre>
+</div>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Provided by
+</td>
+<td class="hdlist2">
+<p><code>ElementKeywordXpectMethod</code></p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Description
+</td>
+<td class="hdlist2">
+<p>Checks that an element/expression has a certain element keyword. The expected element keyword is identical
+to the element keyword shown when hovering the mouse over that element/expression in the N4JS IDE. This method is particuarly useful for testing merged elements of union/intersection.</p>
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:XPECT_accessModifier"><a class="anchor" href="#sec:XPECT_accessModifier"></a><a class="link" href="#sec:XPECT_accessModifier">14.6.4.10. accessModifier</a></h5>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Definition
+</td>
+<td class="hdlist2">
+<p>Single line:</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>// XPECT accessModifier at 'myFunction' -&gt; function</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>or</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>// XPECT accessModifier -&gt; function</code></pre>
+</div>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Example
+</td>
+<td class="hdlist2">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>// XPECT accessModifier --&gt; publicInternal
+export @Internal public abstract class MyClass2 {
+
+// XPECT accessModifier --&gt; project
+abstract m1(): string;
+
+// XPECT accessModifier at 'm2' --&gt; project
+m2(): string {
+    return "";
+  }
+}</code></pre>
+</div>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Provided by
+</td>
+<td class="hdlist2">
+<p><code>AccessModifierXpectMethod</code></p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Description
+</td>
+<td class="hdlist2">
+<p>Checks that an element/expression has a certain accessibility.</p>
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:XPECT_compileResult"><a class="anchor" href="#sec:XPECT_compileResult"></a><a class="link" href="#sec:XPECT_compileResult">14.6.4.11. compileResult</a></h5>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Definition
+</td>
+<td class="hdlist2">
+<p>Single line:</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>//</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Multi line:</p>
+</div>
+</td>
+</tr>
+</table>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Provided by
+</td>
+<td class="hdlist2">
+<p>-</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Description
+</td>
+<td class="hdlist2">
+<p><em>This test should only be used during development of compiler and not used in the long run, because this kind of test is extremely difficult to maintain.</em></p>
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:XPECT_output"><a class="anchor" href="#sec:XPECT_output"></a><a class="link" href="#sec:XPECT_output">14.6.4.12. output</a></h5>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Definition
+</td>
+<td class="hdlist2">
+<p>Single line:</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>//</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Multi line:</p>
+</div>
+</td>
+</tr>
+</table>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Provided by
+</td>
+<td class="hdlist2">
+<p>-</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Description
+</td>
+<td class="hdlist2">
+<p>The most important test for compiler/transpiler, but also for ensuring that N4JS internal validations and assumptions are true at runtime.</p>
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:XPECT_outputRegEx"><a class="anchor" href="#sec:XPECT_outputRegEx"></a><a class="link" href="#sec:XPECT_outputRegEx">14.6.4.13. outputRegEx</a></h5>
+
+</div>
+<div class="sect4">
+<h5 id="sec:XPECT_calculatedAccessModifier"><a class="anchor" href="#sec:XPECT_calculatedAccessModifier"></a><a class="link" href="#sec:XPECT_calculatedAccessModifier">14.6.4.14. calculatedAccessModifier</a></h5>
+
+</div>
+<div class="sect4">
+<h5 id="sec:XPECT_spec"><a class="anchor" href="#sec:XPECT_spec"></a><a class="link" href="#sec:XPECT_spec">14.6.4.15. spec</a></h5>
+
+</div>
+<div class="sect4">
+<h5 id="sec:XPECT_deadCode"><a class="anchor" href="#sec:XPECT_deadCode"></a><a class="link" href="#sec:XPECT_deadCode">14.6.4.16. deadCode</a></h5>
+
+</div>
+<div class="sect4">
+<h5 id="sec:XPECT_returnOrThrows"><a class="anchor" href="#sec:XPECT_returnOrThrows"></a><a class="link" href="#sec:XPECT_returnOrThrows">14.6.4.17. returnOrThrows</a></h5>
+
+</div>
+<div class="sect4">
+<h5 id="sec:XPECT_lint"><a class="anchor" href="#sec:XPECT_lint"></a><a class="link" href="#sec:XPECT_lint">14.6.4.18. lint</a></h5>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Definition
+</td>
+<td class="hdlist2">
+<p>Single line:</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>/* XPECT lint */</code></pre>
+</div>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Provided by
+</td>
+<td class="hdlist2">
+<p><code>CompileAndLintTest</code></p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Description
+</td>
+<td class="hdlist2">
+<p>Passes the generated code through the JSHint JavaScript linter. This test includes for instance checking for missing semicolons and undefined variables. The whole test exclusively refers to the generated javascript code.</p>
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:XPECT_lintFails"><a class="anchor" href="#sec:XPECT_lintFails"></a><a class="link" href="#sec:XPECT_lintFails">14.6.4.19. lintFails</a></h5>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Definition
+</td>
+<td class="hdlist2">
+<p>Single line:</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>/* XPECT lintFails */</code></pre>
+</div>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Provided By
+</td>
+<td class="hdlist2">
+<p><code>CompileAndLintTest</code></p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Description
+</td>
+<td class="hdlist2">
+<p>Negation of lint. Fails on linting success. Expects linting errors.</p>
+</td>
+</tr>
+</table>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:FIXME_Xpect_modifier"><a class="anchor" href="#sec:FIXME_Xpect_modifier"></a><a class="link" href="#sec:FIXME_Xpect_modifier">14.6.5. FIXME Xpect modifier</a></h4>
+<div class="paragraph">
+<p>A modification of the official Xpect framework allows us to use the FIXME modifier on each test. <sup class="footnote">[<a id="_footnoteref_15" class="footnote" href="#_footnote_15" title="View footnote.">15</a>]</sup></p>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Syntax
+</td>
+<td class="hdlist2">
+<p>FIXME can be applied on any test just after the XPECT keyword:</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>// XPECT FIXME  xpectmethod ... --&gt; ...</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Tests will still be ignored if an exclamation mark (!) is put between XPECT and FIXME.</p>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Description
+</td>
+<td class="hdlist2">
+<p>Using FIXME on a test negates the result of the underlying JUnit test framework. Thus a failure will be reported as a <code>true assertion</code>   and an assertion that holds will be reported as <code>failure</code>  . This enables to author valuable tests of behaviour, which is still not functional.</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Example
+</td>
+<td class="hdlist2">
+<p>For instance, if we encounter an error-message at a certain code position, but the code is perfectly right, then we have an issue. We can annotate the situation with a ’fix me’ ’noerrors’ expectation:</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>// Perfectly right behaviour XPECT FIXME noerrors --&gt;
+console.log("fine example code with wrong error marker here.");</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>This turns the script into an Xpect test. We can integrate the test right away into our test framework and it will not break our build (even though the bug is not fixed).</p>
+</div>
+<div class="paragraph">
+<p>When the issue will be worked on, the developer starts with removing ’FIXME’ turning this into useful unit-test.</p>
+</div>
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>It is crucial to understand that FIXME negates the whole assertion. Example: If one expects an error marker at a certain position using the ’errors’ directive, one must give the exact wording of the expected error-message to actually get the FIXME behaviour working. To avoid strange behaviour it is useful to describe the expected error a comment in front of the expectation and leave the message-section empty.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Expectmatrix_Xpect_Test_Methods"><a class="anchor" href="#sec:Expectmatrix_Xpect_Test_Methods"></a><a class="link" href="#sec:Expectmatrix_Xpect_Test_Methods">14.6.6. Expectmatrix Xpect tests</a></h4>
+<div class="paragraph">
+<p>Applying test-driven development begins with authoring acceptance and functional tests for the work in the current sprint. By this the overall code quality is ensured for the current tasks to solve. Rerunning all collected tests with each build ensures the quality of tasks solved in the past. Currently there is no real support for tasks, which are not in progress but are known to be processed in the near or far future. Capturing non-trivial bug reports and turning them into reproducable failing test-cases is one example.</p>
+</div>
+<div class="paragraph">
+<p>Usually people deactivate those future-task-tests in the test code by hand. This approach doesn’t allow to calculate any metrics about the code. One such metric would be: Is there any reported bug solved just by working on an (seemingly unrelated) scheduled task?</p>
+</div>
+<div class="paragraph">
+<p>To achieve measurements about known problems, a special build-scenario is set up. As a naming convention all classes with names matching <code>*  Pending</code> are assumed to be Junit tests. In bundle <code>org.eclipse.n4js.expectmatrix.tests</code> two different Xpect-Runners are provided, each working on its own subfolder. Usual Xpect-tests are organised in folder xpect-test while in folder xpect-pending all future-tests are placed. A normal maven-build processes only the standard junit and xpect tests. Starting a build with profile <code>execute-expectmatrix-pending-tests</code> will additionally execute Xpect tests from folder xpect-pending and for all bundles inheriting from <code>/tests/pom.xml</code> all unit tests ending in <code>*  Pending</code>. This profile is deactivated by default.</p>
+</div>
+<div class="paragraph">
+<p>A special jenkins-job - N4JS-IDE_nightly_bugreports_pending - is configured to run the pending tests and render an overview und history to compare issues over time. Due to internal Jenkins structures this build always marked failed, even though the maven-build succeeds successfully.</p>
+</div>
+<div class="paragraph">
+<p>Relevant additional information can be found in</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Jenkins job for pending cases: <a href="http://build-master:8080/view/N4JS/job/N4JS-IDE_nightly_bugreports_pending/" class="bare">http://build-master:8080/view/N4JS/job/N4JS-IDE_nightly_bugreports_pending/</a></p>
+</li>
+<li>
+<p>Testmatrix <a href="https://docs.google.com/a/numberfour.eu/spreadsheets/d/1Blo58cRwIWemaiBNSnOtsQ8U7b3FoodX3yEs7oJKIg0/" class="bare">https://docs.google.com/a/numberfour.eu/spreadsheets/d/1Blo58cRwIWemaiBNSnOtsQ8U7b3FoodX3yEs7oJKIg0/</a></p>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect3">
+<h4 id="xpect-lint-tests"><a class="anchor" href="#xpect-lint-tests"></a><a class="link" href="#xpect-lint-tests">14.6.7. Xpect Lint Tests</a></h4>
+<div id="sec:XPECT_Lint_Tests" class="imageblock">
+<div class="content">
+<img src="chapters/15_tests/images/diag_XpectLint.svg" alt="diag XpectLint">
+</div>
+<div class="title">Figure 46. Xpect Lint</div>
+</div>
+<div class="paragraph">
+<p>The test transpiles the provided n4js resource and checks the generated code. This is achieved using the Javascript linter JSHint.</p>
+</div>
+<div class="paragraph">
+<p>After transpiling the provided n4js resource the LintXpectMethod combines the generated code with the jshint code into a script. It calls the JSHint validation function and returns the linting result as a json object. The error results are displayed in the console. The script is executed using the <code>Engine</code> class. (<a href="#sec:Design">Design</a>)</p>
+</div>
+<div class="paragraph">
+<p>For the linting process an adapted configuration for JSHint is used. For the needs of N4JS the linter is configured to recognise N4JS specific globals. Details about the error codes can be found at the <a href="https://github.com/jshint/jshint/blob/2444a0463e1a99d46e4afa50ed934c317265529d/src/messages.js">jshint repository</a>.</p>
+</div>
+<div class="paragraph">
+<p>The following warnings are explicitly enabled/disabled:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><strong>W069</strong>: [’a’] is better written in dot notation <strong>DISABLED</strong></p>
+</li>
+<li>
+<p><strong>W033</strong>: Missing semicolon <strong>ENABLED</strong></p>
+</li>
+<li>
+<p><strong>W014</strong>: Bad line breaking before ’a’. <strong>DISABLED</strong></p>
+</li>
+<li>
+<p><strong>W032</strong>: Uneccesarry semicolon <strong>ENABLED</strong></p>
+</li>
+<li>
+<p><strong>W080</strong>: It’s not necessary to initialize ’a’ to ’undefined’. <strong>ENABLED</strong></p>
+</li>
+<li>
+<p><strong>W078</strong>: Setter is defined without getter. <strong>DISABLED</strong></p>
+</li>
+<li>
+<p>ES6 related warnings are <strong>disabled</strong> using the ’esnext’ option: <strong>W117</strong>: Symbol is not defined. <strong>DISABLED</strong> <strong>W104</strong>: ’yield’ is only available in ES6 <strong>DISABLED</strong> <strong>W117</strong>: Promise is not defined <strong>DISABLED</strong> <strong>W119</strong>: function* is only available in ES6 <strong>DISABLED</strong></p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>The xpect lint test only applies if the provided resource passes the n4js compiler.</p>
+</div>
+<div class="paragraph">
+<p>The xpect method lintFails can be used to create negative tests. All linting issues discovered during the development of the xpect plugin have there own negative test to keep track of their existence.</p>
+</div>
+<div class="paragraph">
+<p>Additional information:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>JSHint: <a href="http://jshint.com/docs/" class="bare">http://jshint.com/docs/</a></p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="xpect-proposal-tests"><a class="anchor" href="#xpect-proposal-tests"></a><a class="link" href="#xpect-proposal-tests">14.7. Xpect Proposal Tests</a></h3>
+<div class="paragraph">
+<p>Proposal tests are all tests which verify the existence and application of completion proposals, created by content assist, quick fixes etc.</p>
+</div>
+<div class="paragraph">
+<p>The key attributes of a proposal (cf <code>ConfigurableCompletionProposal</code>) are:</p>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+displayString
+</td>
+<td class="hdlist2">
+<p>the string displayed in the proposal list</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+replacementString
+</td>
+<td class="hdlist2">
+<p>simple variant of which is to be added to document, not necessarily the whole replacement (as this may affect several locations and even user interaction)</p>
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>In the tests, a <em>proposal is identified by a string contained in the displayString</em>. If several proposal match, test will fail (have to rewrite test setup or proposal identifier to be longer). Proposal identifier should be as short as possible (to make test robust), but not too short (to make test readable).</p>
+</div>
+<div class="paragraph">
+<p>The following proposal tests are defined:</p>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+contentAssist <math xmlns="http://www.w3.org/1998/Math/MathML"><mrow><mo>[</mo></mrow></math> List <math xmlns="http://www.w3.org/1998/Math/MathML"><mrow><mo>]</mo></mrow></math>
+</td>
+<td class="hdlist2">
+<p>verifies proposals created by content assist</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+quickFix <math xmlns="http://www.w3.org/1998/Math/MathML"><mrow><mo>[</mo></mrow></math> List <math xmlns="http://www.w3.org/1998/Math/MathML"><mrow><mo>]</mo></mrow></math>
+</td>
+<td class="hdlist2">
+<p>verifies proposals created by quick fixes. Cursor position is relevant, that’s handled by the framework. We only create tests with cursor position – fixes applied via the problem view should work similarly, but without final cursor position.</p>
+<div class="paragraph">
+<p>If no error is found at given position, test will fail (with appropriate error message!). In call cases of apply, the issue must be resolved. Usually, fixing an issue may leave the file invalid as other issues still exists, or because by fixing one issue others may be introduced (which may happen often as we try to avoid consequential errors in validation). For some special cases, quickFix tests support special features, see below.</p>
+</div>
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>Not tested in this context: Verify proposal description, as these tests would be rather hard to maintain and the descriptions are often computed asynchronously.</p>
+</div>
+<div class="sect3">
+<h4 id="sec:Validation_vs__Non_Validation"><a class="anchor" href="#sec:Validation_vs__Non_Validation"></a><a class="link" href="#sec:Validation_vs__Non_Validation">14.7.1. Validation vs. Non-Validation</a></h4>
+<div class="paragraph">
+<p>We expect proposal tests to be applied on non-valid test files, and usually file is also broken after a proposal has been applied. Thus, the test-suite must not fail if the file is not valid.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:General_Proposal_Test_Features"><a class="anchor" href="#sec:General_Proposal_Test_Features"></a><a class="link" href="#sec:General_Proposal_Test_Features">14.7.2. General Proposal Test Features</a></h4>
+<div class="sect4">
+<h5 id="sec:Test_Variables"><a class="anchor" href="#sec:Test_Variables"></a><a class="link" href="#sec:Test_Variables">14.7.2.1. Test Variables</a></h5>
+<div class="paragraph">
+<p>Often, list of proposals are similar for different tests (which define different scenarios in which the proposals should be generated). For that reason, variables can be defined in the test set up:</p>
+</div>
+<div class="paragraph">
+<p>In the Xpect-Setup there is now a special <code>Config</code> component where specific switches are accessible. For instance the timeout switch for content assist can be modified:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>/* XPECT_SETUP org.eclipse.n4js.tests.N4JSNotValidatingXpectPluginUITest
+    ...
+    Config {
+        content_assist_timeout = 1000
+        ...
+    }
+    ...
+*/</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Note: There should only be one <code>Config</code> component per Xpect-Setup.</p>
+</div>
+<div class="paragraph">
+<p>Variables are introduced via the <code>VarDef</code> component. It takes a string argument as the variable name on construction. Inside the body one add <code>MemberLists</code> and <code>StringLists</code> arguments. Variable definitions may appear in <code>Config</code> bodies or in the Xpect-Setup.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>VarDef "objectProposals" {
+    ...
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Define variables with expression: A simple selector is given with the <code>MemberList</code> component. These components take three <code>String</code> arguments in the constructor. The first one is a typename. The second one is the feature selector, e.g. <code>methods</code>  , <code>fields</code>  , …and the third one defines the visibility.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>/* XPECT_SETUP
+VarDef "stringProposals" { MemberList  "String" "methods" "public" {}}
+END_SETUP */</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>We have to define a filter later in Xtend/Java, e.g., <code>getClassWithName( <em>className</em> ).filterType(<em>methods</em>).filterVisibility(<em>accessodifier</em>)&#8230;&#8203;</code></p>
+</div>
+<div class="paragraph">
+<p>A variable is later referenced as follows:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>&lt;$variable&gt;</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Usage example:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>// XPECT contentAssistList at 'a.&lt;|&gt;methodA' proposals --&gt; &lt;$stringProposals&gt;, methodA2
+a.methodA</code></pre>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Location_and_Selection"><a class="anchor" href="#sec:Location_and_Selection"></a><a class="link" href="#sec:Location_and_Selection">14.7.2.2. at – Location and Selection</a></h5>
+<div class="paragraph">
+<p>Tokens in expectation/setup:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>&lt;|&gt;</code> cursor position</p>
+</li>
+<li>
+<p><code>&lt;[&gt;</code> selection start → also defines cursor position</p>
+</li>
+<li>
+<p><code>&lt;]&gt;</code> selection end</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>All proposal tests have to specify a location via <code>at</code>, the location must contain the cursor position and may contain a selection. E.g.:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>// XPECT contentAssistList at 'a.&lt;|&gt;methodA' apply 'methodA2' --&gt; a.methodA2()&lt;|&gt;methodA
+// XPECT contentAssistList at 'a.&lt;|&gt;&lt;[&gt;methodA&lt;]&gt;' apply 'methodA2' override --&gt; a.methodA2()&lt;|&gt;
+a.methodA</code></pre>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Multi_Line_Expectations_in_Proposal_Tests"><a class="anchor" href="#sec:Multi_Line_Expectations_in_Proposal_Tests"></a><a class="link" href="#sec:Multi_Line_Expectations_in_Proposal_Tests">14.7.2.3. Multi Line Expectations in Proposal Tests</a></h5>
+<div class="paragraph">
+<p>In multiline expectations, ignored lines can be marked with <code>&lt;&#8230;&#8203;&gt;</code>. This means that 0 to n lines may occur but are ignored for comparison.</p>
+</div>
+<div class="paragraph">
+<p>All multiline expectations are compared line-wise, with exact match except line delimiters (which are ignored as well)</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Timeout"><a class="anchor" href="#sec:Timeout"></a><a class="link" href="#sec:Timeout">14.7.2.4. Timeout and Performance</a></h5>
+<div class="paragraph">
+<p>We define a default timeout for content assist tests. In set up, this timeout may be changed:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">/* XPECT SETUP
+...
+content_assist_timeout = 2000ms
+...
+END_SETUP */</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Performance is measured by measuring the runtime of tests, we should later setup performance measurements similar to the performance tests.</p>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="proposals-verify-existence-of-proposals"><a class="anchor" href="#proposals-verify-existence-of-proposals"></a><a class="link" href="#proposals-verify-existence-of-proposals">14.7.3. proposals – Verify Existence of Proposals</a></h4>
+<div class="paragraph">
+<p>In general, one could verify if certain proposals are present or not present, and in which order they are present. This is verified by the <code>proposals</code> argument.</p>
+</div>
+<div class="paragraph">
+<p>E.g.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>// XPECT contentAssistList at 'a.&lt;|&gt;methodA' proposals --&gt; &lt;$stringProposals&gt;, methodA2
+a.methodA</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Additional flags:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Order modifier:</p>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+unordered
+</td>
+<td class="hdlist2">
+<p>by default</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+ordered
+</td>
+<td class="hdlist2">
+<p>the given expectations have to have that order, between these expectations other proposals may be present (in case of contains)</p>
+</td>
+</tr>
+</table>
+</div>
+</li>
+<li>
+<p>Subset modifier:</p>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+exactly
+</td>
+<td class="hdlist2">
+<p>(default, maybe changed later) no other expectations as the given ones (usually <code>contains</code>   is recommended).</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+contains
+</td>
+<td class="hdlist2">
+<p>at least the given expectations must be present, but others may be there as well.</p>
+<div class="paragraph">
+<p>Using <em>contains</em> must be used with care since we match items by searching for a proposal which contains one of the expected strings as a substring. So if the only available proposal were ’methodA2’ and we would test if proposals contain ’methodA’, ’methodA2’ we would obtain a passing test.</p>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+not
+</td>
+<td class="hdlist2">
+<p>any of the given proposals must be NOT be proposed</p>
+</td>
+</tr>
+</table>
+</div>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Verify_displayed_string"><a class="anchor" href="#sec:Verify_displayed_string"></a><a class="link" href="#sec:Verify_displayed_string">14.7.4. display – Verify displayed string</a></h4>
+<div class="paragraph">
+<p>We do not verify the text style. We only verify text:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>// XPECT contentAssistList at 'a.&lt;|&gt;methodA' display 'methodA2' --&gt; 'methodA2(): any - A'
+a.methodA</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>This kind of test should be only applied for few scenarios, because the long display tests are rather hard to maintain.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Apply_Proposal"><a class="anchor" href="#sec:Apply_Proposal"></a><a class="link" href="#sec:Apply_Proposal">14.7.5. apply – Apply Proposal</a></h4>
+<div class="paragraph">
+<p>Execution of proposal, the expectation describes the expected text result. The tests follow the naming convention of Ending in …Application.</p>
+</div>
+<div class="paragraph">
+<p>Additional flags:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>insertion mode</p>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+insert
+</td>
+<td class="hdlist2">
+<p>(default) Ctrl not pressed, proposal is inserted at given location</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+override
+</td>
+<td class="hdlist2">
+<p>Ctrl is pressed, proposal overrides selection.</p>
+</td>
+</tr>
+</table>
+</div>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Single line assumes change at line of initial cursor position:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>// XPECT contentAssist at 'a.&lt;|&gt;methodA' apply 'methodA2' --&gt; a.methodA2()methodA
+// XPECT contentAssist at 'a.&lt;|&gt;methodA' apply 'methodA2' insert --&gt; a.methodA2()methodA
+// XPECT contentAssist at 'a.&lt;|&gt;methodA' apply 'methodA2' override --&gt; a.methodA2()
+a.methodA</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>or</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>// XPECT quickFix at 'a.&lt;|&gt;method' apply 'methodA2' --&gt; a.methodA2();
+a.methodTypo();</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Multiline expectations describe changes to the whole. In order to match the expectation context information around the relevant places must be given. The format is similar to a unified diff with a special rule for inline-changes. The comparison works in a line-based mode. Each line in the expectation is prefixed with one character of ’+’, ’|’, ’-’ or ’ ’. Inserted lines are marked with + and removed lines with -. Lines marked with | denote changes in the line. Difference is placed inline inside of a pair of square brackets with a | separating the removal on the left and the addition on the right.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>/* XPECT contentAssistList at 'a.me&lt;|&gt;thodA' apply 'methodA2' ---
+&lt;...&gt;
+import A from "a/b/c"
+&lt;...&gt;
+a.methodA2()&lt;|&gt;methodA
+&lt;...&gt;
+--- */
+a.methodA</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>/* XPECT contentAssistList at 'a.me&lt;|&gt;thodA' apply 'methodA2' ---
+ import B from "p/b"
++import A from "a/b/c"
+
+ ...
+ foo() {
+|a.[me|thodA2()]
+ }
+ ...
+--- */
+a.methodA</code></pre>
+</div>
+</div>
+<div class="sect4">
+<h5 id="resource-application-in-other-files"><a class="anchor" href="#resource-application-in-other-files"></a><a class="link" href="#resource-application-in-other-files">14.7.5.1. resource – application in other files</a></h5>
+<div class="paragraph">
+<p>The resource parameter is available for the quickfix xpect method. It specifies the target resource of the quickfix. (e.g. change declaration of type in another file to quickfix an issue).</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>/* XPECT quickFix at 'sameVendor.protected&lt;|&gt;Method()' apply 'Declare member as public, @Internal' resource='../../otherProject/src/other_file.n4js' ---
+diff here
+---
+*/</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>The syntax is similar to a normal multiline quickfix xpect test besides the addition of the resource parameter. The relative path points to a file in the same workspace as the test file. Note that the path refers to the folder structure specified in the XPECT SETUP header. It is relative to the folder the test file is contained in.<br>
+<br>
+The diff is between the specified resource before and after the application of the quickfix<br>
+<br>
+Note that the fileValid (<a href="#fileValidVerify-validation-status">Verify Validation Status</a>) parameter is not applicable to an extern resource.</p>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Content_Assist_Cycling"><a class="anchor" href="#sec:Content_Assist_Cycling"></a><a class="link" href="#sec:Content_Assist_Cycling">14.7.6. kind – Content Assist Cycling</a></h4>
+<div class="paragraph">
+<p>We assume the default kind to be ’n4js’. It is possible to select a proposal kind in the test set up or via the argument <code>kind</code> in the test.</p>
+</div>
+<div class="paragraph">
+<p>Select kind in test setup:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>/* XPECT_SETUP
+content_assist_kind = 'recommenders'
+END_SETUP */</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Select kind in test:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>// XPECT contentAssistList kind 'smart' at 'a.&lt;|&gt;methodA' display 'methodA2' --&gt; 'methodA2(): any - A'
+a.methodA</code></pre>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="fileValidVerify-validation-status"><a class="anchor" href="#fileValidVerify-validation-status"></a><a class="link" href="#fileValidVerify-validation-status">14.7.7. fileValid – Verify validation status</a></h4>
+<div class="paragraph">
+<p>In some cases, in particular in case of quick fix tests, the file should be valid after the proposal has been applied. This is added by an additional argument <code>fileValid</code>.</p>
+</div>
+<div class="paragraph">
+<p>E.g.,</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>// XPECT quickFix at 'a.&lt;|&gt;method' apply 'methodA2' fileValid --&gt; a.&lt;|&gt;methodA2();
+a.methodTypo();</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:Apply_Proposal_And_Execute_Tests"><a class="anchor" href="#sec:Apply_Proposal_And_Execute_Tests"></a><a class="link" href="#sec:Apply_Proposal_And_Execute_Tests">14.8. Apply Proposal And Execute Tests</a></h3>
+<div class="paragraph">
+<p>If a proposal fixes all issues in a test file, the file could be executed. This is an important type of test, as this is what the user expects in the end. Besides, this type of test is very robust, as it does not depend on the concrete way how an issue is fixed. For quick fixes, these kind of tests are to be implemented!</p>
+</div>
+<div class="paragraph">
+<p>The following combined proposal and execute tests are provided:</p>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+quickFixAndRun
+</td>
+<td class="hdlist2">
+<p>applies a quick fix, verifies that all issues are solved, and executes the file.</p>
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>These tests are basically execution tests, that is the expectation describes the expected output of the script.</p>
+</div>
+<div class="paragraph">
+<p>E.g.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>// XPECT quickFixAndRun at 'a.&lt;|&gt;method' apply 'methodHelloWorld' --&gt; Hello World
+a.methodTypo();</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>with <code>methodHelloWorld</code> printing <code>’Hello World’</code> to the console. The expected output can be multiline:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>/* XPECT quickFixAndRun at 'a.&lt;|&gt;method' apply 'methodHelloWorld' ---
+Hello World
+--- */
+a.methodTypo();</code></pre>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:Organize_Imports_Test"><a class="anchor" href="#sec:Organize_Imports_Test"></a><a class="link" href="#sec:Organize_Imports_Test">14.9. Organize Imports Test</a></h3>
+<div class="paragraph">
+<p>For testing organise imports a Plugin-UI test method is available. It operates in two modes. Either a successful application of organise imports is tested or the expected abortion is checked.</p>
+</div>
+<div class="sect3">
+<h4 id="organizeimports"><a class="anchor" href="#organizeimports"></a><a class="link" href="#organizeimports">14.9.1. organizeImports</a></h4>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Definition
+</td>
+<td class="hdlist2">
+<p>Multi line:</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>/* XPECT organizeImports ---
+~Failure given by line-syntax starting with two characters:~
++ additional line
+| line with inplace[removed part|added part]
++ removed line
+  unchanged line
+--- */
+// XPECT warnings --&gt; "The import of A is unused." at "A"
+import A from "a/a1/A"
+...
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Single line:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>// XPECT organizeImports ambiguous '~Failure String of Exception~'--&gt;
+}</code></pre>
+</div>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Provided by
+</td>
+<td class="hdlist2">
+<p><code>OrganizeImportXpectMethod</code></p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Description
+</td>
+<td class="hdlist2">
+<p>Checks that the resulting source-file differs in the described way. The Multiline variant checks the result of a successful application of organise import to the file. All errors and warnings prior to organising imports must be marked as the appropriate XPECT-error or warning.</p>
+<div class="paragraph">
+<p>The single-line notation checks the failure of an fully automatic reorganisation of the imports due to some reason. The reason is verified to be the given string after the <code>ambiguous</code> keyword. The expectation side (right of <code>-&#8594;</code>) is empty.</p>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Example
+</td>
+<td class="hdlist2">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>/* XPECT_SETUP org.eclipse.n4js.tests.N4JSXpectPluginUITest
+   Workspace {
+     Project "P1" {
+        Folder "src" {
+            Folder "a" {  Folder "a1" { File "A.n4js" { from="../../a/a1/A.n4js" } }
+                            Folder "c"  { ThisFile {} }  }  }
+        File "package.json" { from="package_p1.json" }  }  }
+   END_SETUP
+*/
+
+/* XPECT organizeImports ---
+
+ | import [A from "a/a1/A"|]
+ | [import|] AR from "a/a1/A"
+   export public role BRole with AR {
+   }
+--- */
+// XPECT warnings --&gt; "The import of A is unused." at "A"
+import A from "a/a1/A"
+import AR from "a/a1/A"
+
+// XPECT noerrors --&gt; "Couldn't resolve reference to Type 'AR'."
+export public role BRole with AR {
+}</code></pre>
+</div>
+</div>
+</td>
+</tr>
+</table>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:Access_Control_Test"><a class="anchor" href="#sec:Access_Control_Test"></a><a class="link" href="#sec:Access_Control_Test">14.10. Access Control Test</a></h3>
+<div class="paragraph">
+<p>Access control refers to the decision whether or not a member or a top level element is accessible for a client. In this context, access refers to reading, writing, and calling a member or a top level function, and to overriding inherited members in classes and interfaces. In N4JS, access is controlled via modifiers at the type and at the member level. Due to the large number of such modifiers and the large number of different scenarios for access control, manually written tests can only cover a small number of actual scenarios. An automatic test generator helps to increase the test coverage for access control.</p>
+</div>
+<div class="paragraph">
+<p>The test generator loads test scenarios from a CSV table that also contains the expected results of each test case and then generates N4JS projects and code for each test case, compiles them using the headless compiler, and compares the compilation results to the expectations from the CSV table. Note that the test generator does not generate test cases that check access control for top level functions and variables.</p>
+</div>
+<div class="sect3">
+<h4 id="test-scenarios"><a class="anchor" href="#test-scenarios"></a><a class="link" href="#test-scenarios">14.10.1. Test Scenarios</a></h4>
+<div class="paragraph">
+<p>Each test scenario consists of a scenario specifier (one of <code>Extends</code>  , <code>Implements</code>  , <code>References</code>  ), a supplier and a client (each of which can be a class, and abstract class, an interface, or an interface with default implementations of its getters, setters, and methods). Thereby, the client attempts to access a member of the supplier either by reading, writing, or calling it or by overriding it in the case of an <code>Extends</code>   or <code>Implements</code>   scenario. Furthermore, each test cases specifies the location of the client in relation to the location of the supplier, e.g., whether the client is in the same module, or whether it is in the same project (but not the same module), and so forth. Finally, a test case must specify the access control modifiers of the supplier type and the member that is being accessed by the client, whether that member is static or not, and, lastly, the type of access that is being attempted.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="n4js-code-generator"><a class="anchor" href="#n4js-code-generator"></a><a class="link" href="#n4js-code-generator">14.10.2. N4JS Code Generator</a></h4>
+<div class="paragraph">
+<p>The test generator needs to generate N4JS projects and modules that implement a particular test case. For this purpose, it uses a simple code generator, available in the package <code>org.eclipse.n4js.tests.codegen</code>. The classes in that package allow specifying N4JS projects, modules, classes, and members in Java code and to generate the required artifacts as files at a given location.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="xtext-issue-matcher"><a class="anchor" href="#xtext-issue-matcher"></a><a class="link" href="#xtext-issue-matcher">14.10.3. Xtext Issue Matcher</a></h4>
+<div class="paragraph">
+<p>To match the test expectations from the CSV file against the issues generated by the compiler, the test generator uses a small library of issue matchers, available in the package <code>org.eclipse.n4js.tests.issues</code>. The classes in that package make it easy to specify expectations against Xtext issues programmatically and to evaluate these expectations against a specific set of Xtext issues. Mismatches, that is, unexpected issues as well as unmatched expectations, are explained textually. These explanations are then shown in the failure notifications of the test case generator.</p>
+</div>
+<div class="paragraph">
+<p>The test expectations allow for FIXME annotations in the CSV table to express cases where an access control error has been found, but hasn’t been fixed yet. Such expectations lead to inverted expectations against the generated issues: For example, if a test expects an attempted access to fail with an error, but the validation rules allow the access regardless, then a FIXME annotation at the test will invert the actual expectation: Where previously an error was expected, there must now be no error at all. Then, once the validation rules have been adjusted and the error occurs as expected, the FIXME test case will fail until the FIXME annotation has been removed. Therefore, the issue expectation matchers can be inverted and adjust their behavior accordingly.</p>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:Smoke_Tests"><a class="anchor" href="#sec:Smoke_Tests"></a><a class="link" href="#sec:Smoke_Tests">14.11. Smoke Tests</a></h3>
+<div class="paragraph">
+<p>Smoke tests are useful to ensure the robustness of the IDE. They aim at revealing potential exceptions that may surface to the end user in the IDE or in a headless compile run. Therefore, different permutations of a given input document are fed into processing components such as the validator or the type system. No exceptions may be thrown from these components.</p>
+</div>
+<div class="paragraph">
+<p>Since smoke tests are longrunning, it is not desired to execute them with each Maven run. That’s why the naming convention <code>*  Smoketest</code> was choosen. It will not be matched by the naming pattern for normal JUnit tests during a maven run.</p>
+</div>
+<div class="paragraph">
+<p>The smoke tests are generally created by using the (valid or invalid) input of existing test cases. Therefore, the a command line argument <code>-DSmokeTestWriter=true</code> may be passed to the VM that executes a test. All input documents that are processed by a <code>ParseHelper&lt;Script&gt;</code> will be written to a new test method on the console. The result can be merged manually into the <code>GeneraredSmoketest</code>.</p>
+</div>
+<div class="sect3">
+<h4 id="how-to-handle-smoke-test-errors"><a class="anchor" href="#how-to-handle-smoke-test-errors"></a><a class="link" href="#how-to-handle-smoke-test-errors">14.11.1. How to handle smoke test errors?</a></h4>
+<div class="paragraph">
+<p>If a smoke test fails, the concrete input should be extracted into a dedicated error test case. The existing classes like <code>scoping.ErrorTest</code> should be used to add the broken input document and create fast running cases for them. For that purpose, the <code>ExceptionAnalyzer</code> can be used. Such a test case will usually look like this:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>@Test
+def void testNoNPE_03() {
+    val script = ``  '
+        var target = {
+            s: "hello",
+            set x
+    ``  '.parse
+    analyser.analyse(script, "script", "script")
+}</code></pre>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="smoketester-and-exceptionanalyzer"><a class="anchor" href="#smoketester-and-exceptionanalyzer"></a><a class="link" href="#smoketester-and-exceptionanalyzer">14.11.2. SmokeTester and ExceptionAnalyzer</a></h4>
+<div class="paragraph">
+<p>The components that are used to implemement the smoke tests are the <code>SmokeTester</code> and the <code>ExceptionAnalyzer</code>. The smoke tester performs the permutation of the characters from the input model whereas the analyzer does the heavy lifting of passing the parsed model to various components such as the type system or the validation. Both utilities can be used to add either new smoke test documents or to check for the robustness of an implementation. It’s espeically useful to use the ExceptionAnalyzer in conjunction with existing test suites like the <code>LibraryParsingTestSuite</code> since it can be used instead of the other utilities like the <code>PositiveAnalyzer</code> or the <code>NegativeAnalyzer</code>.</p>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:UI_Tests_with_SWTBot"><a class="anchor" href="#sec:UI_Tests_with_SWTBot"></a><a class="link" href="#sec:UI_Tests_with_SWTBot">14.12. UI Tests with SWTBot</a></h3>
+<div class="paragraph">
+<p>For testing functionality from the end-user perspective we use UI tests based on SWTBot <a href="http://eclipse.org/swtbot/" class="bare">http://eclipse.org/swtbot/</a>.</p>
+</div>
+<div class="paragraph">
+<p>Since UI tests are usually rather fragile, it was decided to keep the number of these tests as low as possible. The main purpose of these tests is to ensure that the most fundamental IDE functionality is working properly, e.g. creating an N4JS project, creating a new N4JS file, running N4JS code in node.js.</p>
+</div>
+<div class="paragraph">
+<p>The tests have a number of SWTBot dependencies. For details, please refer to the latest target platform definition file.</p>
+</div>
+<div class="sect3">
+<h4 id="writing-swtbot-tests"><a class="anchor" href="#writing-swtbot-tests"></a><a class="link" href="#writing-swtbot-tests">14.12.1. Writing SWTBot Tests</a></h4>
+<div class="paragraph">
+<p>The implementation is contained in bundle <code>org.eclipse.swtbot.tests</code>. Writing SWTBot tests is straightforward; see source code of <code>AbstractSwtBotTest</code> for usage and examples.</p>
+</div>
+<div class="paragraph">
+<p>Some hints:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Many methods of the SWTBot framework already include assertions. For example, the method <code>#  menu(String)</code> to find a particular menu or menu item will assert that the item was found and otherwise throw an exception. Therefore, it is safe to write code like:</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>bot.menu("File").menu("New").menu("Project...").click();</code></pre>
+</div>
+</div>
+</li>
+<li>
+<p>It is usually considered bad practice to use sleep delays in UI tests. Instead, wait for the element to appear using methods such as <a href="http://download.eclipse.org/technology/swtbot/helios/dev-build/apidocs/org/eclipse/swtbot/swt/finder/SWTBot.html#waitUntil" class="bare">http://download.eclipse.org/technology/swtbot/helios/dev-build/apidocs/org/eclipse/swtbot/swt/finder/SWTBot.html#waitUntil</a> or <a href="http://download.eclipse.org/technology/swtbot/helios/dev-build/apidocs/org/eclipse/swtbot/swt/finder/SWTBot.html#waitWhile" class="bare">http://download.eclipse.org/technology/swtbot/helios/dev-build/apidocs/org/eclipse/swtbot/swt/finder/SWTBot.html#waitWhile</a>.</p>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect3">
+<h4 id="running-swtbot-tests"><a class="anchor" href="#running-swtbot-tests"></a><a class="link" href="#running-swtbot-tests">14.12.2. Running SWTBot Tests</a></h4>
+<div class="paragraph">
+<p>To run the tests locally in Eclipse just right-click the bundle and select <code>Run As &gt; SWTBot Test</code>  . To run them locally via maven simply start a normal maven build, no additional command line arguments, etc. required.</p>
+</div>
+<div class="paragraph">
+<p>To run remotely in a Jenkins build: on Windows the build must be executed with a logged-in user; on Linux Xvfb and a window manager are required. The recommended window manager is metacity. More information can be found here: <a href="http://wiki.eclipse.org/SWTBot/Automate_test_execution" class="bare">http://wiki.eclipse.org/SWTBot/Automate_test_execution</a>.</p>
+</div>
+<div class="paragraph">
+<p>To use metacity, add the following pre-build shell command to the Jenkins build configuration:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-bash" data-lang="bash">sleep 5; metacity --replace --sm-disable &amp;</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>The sleep is required because metacity depends on Xvfb to be fully initialized, which might take a moment on slower build nodes. The following Jenkins console log shows the expected output when starting Xvfb and metacitiy:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-bash" data-lang="bash">Xvfb starting$ Xvfb :1 -screen 0 1024x768x24 -fbdir /var/lib/build/2014-09-05_10-36-343337290231975947044xvfb
+[N4JS-IDE_Oliver] $ /bin/sh -xe /tmp/hudson4475531813520593700.sh
++ sleep 5
++ metacity --replace --sm-disable
+Xlib:  extension "RANDR" missing on display ":1.0".
+Window manager warning: 0 stored in GConf key /desktop/gnome/peripherals/mouse/cursor_size is out of range 1 to 128
+Process leaked file descriptors. See http://wiki.jenkins-ci.org/display/JENKINS/Spawning+processes+from+build for more information
+Parsing POMs
+...</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>The warnings and error messages in the above log are expected and are considered unharmful (cf. discussion with Jörg Baldzer).</p>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="sec:Debugging_UI_Tests"><a class="anchor" href="#sec:Debugging_UI_Tests"></a><a class="link" href="#sec:Debugging_UI_Tests">14.13. Debugging UI Tests</a></h3>
+<div class="paragraph">
+<p>In rare cases UI Tests behave differently depending on the underlying OS und the power of the test machine. Missing user interaction on the build-server often results in waiting processes which in turn get a timeout request from the driving unit-testing-framework. To investigate the UI state on the build node a X11 connection needs to established.</p>
+</div>
+<div class="sect3">
+<h4 id="sec:Connecting_to_the_X_server_on_the_build_node"><a class="anchor" href="#sec:Connecting_to_the_X_server_on_the_build_node"></a><a class="link" href="#sec:Connecting_to_the_X_server_on_the_build_node">14.13.1. Connecting to the X-server on the build-node</a></h4>
+<div class="paragraph">
+<p>First a vnc server needs to be started on the build-node. This is done via <code>x11vnc -display :1 -shared &gt;  /x11vnc.log 2&gt;&amp;1 &amp;</code> as a pre-build shellscript-step in Jenkins.</p>
+</div>
+<div class="paragraph">
+<p>You can narrow down the build to run on a specific node in Jenkins if a repeatable environment is required otherwise the current build-node is listed in the overview page. For security reasons the connection needs to be tunneld through an ssh login:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-bash" data-lang="bash">ssh -l viewer -L 5900:localhost:5900 build-linux-25 ’x11vnc -localhost -display :1</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Here we are using the mating <code>build-linux-25</code> with the generic user/password ’viewer’ to start the program <code>x11vnc</code>. For the actual display number – <code>:1</code> in this case – you can refer to the console output. The command above tunnels the default vnc port 5900. You can now connect on <code>localhost</code> with a vnc client. If the user is not available, the <code>x11vnc</code> program not installed or in case of other issues, ask the build-and-release team.</p>
+</div>
+<div class="paragraph">
+<p>To display the screen you can use any arbitrary vnc-client (on mac there is screen sharing, in theory just opened from the command line by hitting <code>open vnc://viewer:viewer@localhost:5900</code>). One working client is ’chicken of the vnc’ <a href="http://sourceforge.net/projects/cotvnc/" class="bare">http://sourceforge.net/projects/cotvnc/</a></p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Tools_to_investigate_the_java_stack"><a class="anchor" href="#sec:Tools_to_investigate_the_java_stack"></a><a class="link" href="#sec:Tools_to_investigate_the_java_stack">14.13.2. Tools to investigate the java-stack</a></h4>
+<div class="paragraph">
+<p>Unix and Java come with some useful programs for investigations. The following tools may need some advanced rights to see processes from other users.</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>htop</code> enhanced top to see all currently running processes</p>
+</li>
+<li>
+<p><code>jps</code> list running java processes</p>
+</li>
+<li>
+<p><code>jstack</code> investigate running java process</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_ui-concepts"><a class="anchor" href="#_ui-concepts"></a><a class="link" href="#_ui-concepts">15. UI Concepts</a></h2>
+<div class="sectionbody">
+<div class="admonitionblock warning">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-warning" title=""></i>
+</td>
+<td class="content">
+Parts of this chapter may be outdated.
+</td>
+</tr>
+</table>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:User_Interface_Concepts"><a class="anchor" href="#sec:User_Interface_Concepts"></a><a class="link" href="#sec:User_Interface_Concepts">15.1. User Interface Concepts</a></h3>
+<div class="sect3">
+<h4 id="sec:Eclipse_UI_Concepts"><a class="anchor" href="#sec:Eclipse_UI_Concepts"></a><a class="link" href="#sec:Eclipse_UI_Concepts">15.1.1. Eclipse UI Concepts</a></h4>
+<div class="paragraph">
+<p>The following list gives an overview of Eclipse specific UI concepts and which classes are used for implementation.</p>
+</div>
+<div class="sect4">
+<h5 id="sec:Label_Provider"><a class="anchor" href="#sec:Label_Provider"></a><a class="link" href="#sec:Label_Provider">15.1.1.1. Label Provider</a></h5>
+<div class="paragraph">
+<p>Also provides decorations for icons and text labels.</p>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Example
+</td>
+<td class="hdlist2">
+<p>The representation of objects in the outline view or in search results.</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Eclipse API
+</td>
+<td class="hdlist2">
+<div class="ulist">
+<ul>
+<li>
+<p><code>o.e.jface.viewers.ILabelProvider</code> → without styes</p>
+</li>
+<li>
+<p><code>o.e.jface.viewers.DelegatingStyledCellLabelProvider.IStyledLabelProvider</code> → with styles Drawback: Depends on Image rather than ImageDescriptor (see below)</p>
+</li>
+</ul>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Xtext Specifics
+</td>
+<td class="hdlist2">
+<div class="ulist">
+<ul>
+<li>
+<p><code>Declarative API</code>  via reflective, polymorphic dispatching. <code>org.eclipse.xtext.ui.label.AbstractLabelProvider</code></p>
+</li>
+<li>
+<p>Allows to work with ImageDescriptors (non-ui-thread, can be composed), but cumbersome</p>
+</li>
+<li>
+<p>DefaultLabelProvider will be used everywhere (outline etc.), returns the <code>name</code>  (via reflection). You could bind specific label providers.</p>
+</li>
+<li>
+<p>DescriptionLabelProvider provides labels for objects from the Xtext index used by <code>open model element</code> , <code>find references</code>  – the later is already customized)</p>
+</li>
+</ul>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Best Practices
+</td>
+<td class="hdlist2">
+<p>Labels are often use-case specific, so a single label provider is not always useful Therefore, in Xtext are different label providers for different use cases. Use cases are defined and enumerated (see <code>DefaultUiModule.configure*Label*</code>).
++
+Often labels could be easier created where they are needed instead of using a label provider (even for things like OutlineView). (LabelProvider are maybe over-engineered). (Note: default label provider has dependencies to SWT, because it uses images, which are often not needed; also they are only called with an object and no further configuration).
++
+Images:
++</p>
+<div class="ulist">
+<ul>
+<li>
+<p>DeclarativeLabelProvider: text and image (String: path relative to icons folder; or: ImageDescriptor, or Image), put it into folder (needs to be called <code>icons</code> , otherwise bind another name)</p>
+</li>
+<li>
+<p>better use AbstractLabelProvider and use EMF concepts (easier to debug and handle)</p>
+</li>
+<li>
+<p>image format and size: sub-folders with 32, 12, 16, 24, etc. (look which sizes are needed); in about view maybe bigger; png (supports transparency)</p>
+</li>
+</ul>
+</div>
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Markers"><a class="anchor" href="#sec:Markers"></a><a class="link" href="#sec:Markers">15.1.1.2. Markers</a></h5>
+<div class="quoteblock">
+<blockquote>
+<div class="paragraph">
+<p>Markers are objects that may be associated with Workbench resources. There are many uses of markers in the Workbench&#8230;&#8203;
+Markers are shown in a marker view (Tasks, Problems or Bookmark view) or on the marker bar in the editor area.</p>
+</div>
+</blockquote>
+<div class="attribution">
+&#8212; Eclispe Help
+</div>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Examples
+</td>
+<td class="hdlist2">
+<p>Tasks, Problems, Bookmarks, Breakpoints, Trace information</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Eclipse API
+</td>
+<td class="hdlist2">
+<p><code>org.eclipse.core.resources.IMarker</code> and <code>IResource.findMarkers</code>
++</p>
+<div class="ulist">
+<ul>
+<li>
+<p>Marker types registered via extension point (basically String). A marker is more or less a Map of String &#8594; String with some meta information, e.g. the resource location in WS, line numbers, type</p>
+</li>
+<li>
+<p>Markers are very efficient (e.g., find markers of a certain type), cf Xtext Specifics</p>
+</li>
+<li>
+<p>For validation, some new marker types are already registered.</p>
+</li>
+</ul>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Xtext
+</td>
+<td class="hdlist2">
+<p>(2.6)
++</p>
+<div class="ulist">
+<ul>
+<li>
+<p>Todo-Markers are created during build, task list is populated by these markers.</p>
+</li>
+<li>
+<p><code>org.eclipse.xtext.tasks.ITaskFinder</code> (and default implementation is bound by default, can be replaced with custom implementation)</p>
+</li>
+</ul>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Best Practices
+</td>
+<td class="hdlist2">
+<p>In Xtend, markers are used to trace from original file to generated file. They are hidden (and not displayed), so in general markers can be used for non-UI-problems as well (but only available in Eclipse of course) clean up markers: no general solution, often managed by some (single) life-cycle aware class (e.g., Builder)</p>
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Commands__Toolbar_and_Menus"><a class="anchor" href="#sec:Commands__Toolbar_and_Menus"></a><a class="link" href="#sec:Commands__Toolbar_and_Menus">15.1.1.3. Commands, Toolbar and Menus</a></h5>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Examples
+</td>
+<td class="hdlist2">
+<p>Organize Imports,</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Eclipse API
+</td>
+<td class="hdlist2">
+<p>use Commands + Handlers instead of Actions (or ActionDelegates etc.)</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Xtext Specifics
+</td>
+<td class="hdlist2">
+<p>uses commands and handlers</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Best Practice
+</td>
+<td class="hdlist2">
+<p><strong>Use commands and handlers</strong> -
+handler usually only delegates to real thing (that is, retrieve parameters from context and call the real thing)<br>
+<strong>Register in pluginxml</strong> via ExecutableExtensionFactory to be able to use injection (also pre-generatd, e.g.:</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xml" data-lang="xml">            &lt;handler class="org.eclipse.n4js.ui.N4JSExecutableExtensionFactory:org.eclipse.xtext.ui.editor.handler.ValidateActionHandler"
+                          commandId="org.eclipse.n4js.N4JS.validate"&gt;</code></pre>
+</div>
+</div>
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p><strong>Undo</strong>: use TextEdit and MultiTextEdit (composed)<br>
+otherwise very low level</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Content_Assist"><a class="anchor" href="#sec:Content_Assist"></a><a class="link" href="#sec:Content_Assist">15.1.1.4. Content Assist</a></h5>
+<div class="quoteblock">
+<blockquote>
+<div class="paragraph">
+<p>Content assist allows you to provide context sensitive content completion upon user request. Popup windows (infopops) are used to propose possible text choices to complete a phrase. The user can select these choices for insertion in the text. Content assist also supports contextual infopops for providing the user with information that is related to the current position in the document.</p>
+</div>
+</blockquote>
+<div class="attribution">
+&#8212; Eclipse Help
+</div>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Risk
+</td>
+<td class="hdlist2">
+<p>Always needs longer than anticipated.</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Examples
+</td>
+<td class="hdlist2">
+<p>complete name of function in function call, complete keywords</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Eclipse API
+</td>
+<td class="hdlist2">
+<div class="ulist">
+<ul>
+<li>
+<p>IContentAssistant wraps the widget,</p>
+</li>
+<li>
+<p>IContentProposalProvider computes the (array of) CompletionProposal (quite cumbersome!).</p>
+</li>
+<li>
+<p>Many extension interfaces that provide valuable UI features.</p>
+</li>
+</ul>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Xtext Specifics
+</td>
+<td class="hdlist2">
+<div class="ulist">
+<ul>
+<li>
+<p>ConfigurableCompletionProposal implements the currently defined extension interfaces, provides getters to modify the proposal after the fact.</p>
+</li>
+<li>
+<p>Context: The ContentAssistContext is provided by the framework according to the current cursor position in the document (cf. <code>ContentAssisParser</code>), semantic context (semantic element) computed with best match strategy (worst case you get the root element). Multiple contexts may be valid at the very same cursor position since the replace region may be different for different proposals.</p>
+</li>
+<li>
+<p>Various abstracts above the JFace stuff are available in Xtext, some of the <code>over the top</code> , others quite handy.</p>
+</li>
+</ul>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Best Practices
+</td>
+<td class="hdlist2">
+<div class="ulist">
+<ul>
+<li>
+<p>List of follow elements can be supposed to be complete, no need to figure out them with regular expressions etc.</p>
+</li>
+<li>
+<p>in rare cases it is necessary to <code>manually</code>  scan the text context, e.g. to get the variable name based on the variable type. → we will provider a utility class for that using regex. NEVER search on the text with simple string methods.</p>
+</li>
+<li>
+<p>In N4JSProposalProvider, override pre-generated methods (see <code>AbstractN4JSProposalProvider</code>) – do not overload (with concrete semantic element)</p>
+</li>
+<li>
+<p>how to implement complete-methods:</p>
+<div class="ulist">
+<ul>
+<li>
+<p>inspect context, examine current semantic element provide elements from scope or hard coded proposal: see <a href="#sec:Proposals">Proposals</a></p>
+</li>
+</ul>
+</div>
+</li>
+</ul>
+</div>
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Quick_Fixes"><a class="anchor" href="#sec:Quick_Fixes"></a><a class="link" href="#sec:Quick_Fixes">15.1.1.5. Quick Fixes</a></h5>
+<div class="quoteblock">
+<blockquote>
+Users can select a problem marker and choose a Quick Fix from a popup containing the list of supplied fixes contributed for the marker.
+</blockquote>
+<div class="attribution">
+&#8212; Eclipse Help
+</div>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Examples
+</td>
+<td class="hdlist2">
+<p>Add Import, Add Override Annotation</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Eclipse API
+</td>
+<td class="hdlist2">
+<p>Based on ICompletionProposal (powerful)
++</p>
+<div class="ulist">
+<ul>
+<li>
+<p>QuickFixes are registered to marker (marker attribute: is fixable or not – this attribute is a guess only, there does not need to be a quick fix)</p>
+</li>
+<li>
+<p>MarkerResolutionGenerator (can also be used to fix several markers at once)</p>
+</li>
+</ul>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Xtext Specifics
+</td>
+<td class="hdlist2">
+<p>Based on ISematicModification (seemingly powerful but in fact weak) and IModification (less weak, but still very weak compared to ICompletionProposal) – only creates DocumentChanges.
++
+Declarativ API that links to issue codes via annotations on 'fix' methods in AbstractDeclarativeQuickfixProvider.</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Best Practices
+</td>
+<td class="hdlist2">
+<p>ICompletionProposal vs. DocumentChanges, ICompletionProposal is much more powerful. IModifications can also provide semantic changes, but not really recommended
++</p>
+<div class="ulist">
+<ul>
+<li>
+<p>Associated to isses via IssueCodes, @Fix similar to @Check API – only less powerful Xtext abstraction (no ICompletionProposal)</p>
+</li>
+<li>
+<p>use issue data to provide hints for fix labels (which should be fast!) or solution strategies (but only strings) → do not compute the label for the fix from the model!</p>
+</li>
+<li>
+<p>share code between checks and fixes → no built-in pattern, come up with utility methods (maybe define conventions)</p>
+</li>
+<li>
+<p>maybe Sebastian can add a solution that more information is available via @Fix-approach</p>
+</li>
+<li>
+<p>no order of quickfixes (sorted by name and priority, latter is not provided by default)</p>
+</li>
+<li>
+<p>there can be several @Fix for a single issue code, or pass arbitrary number of resolution to the acceptor</p>
+</li>
+<li>
+<p>for most cases simple Xtext quick fix api is good enough (e.g. all Xtend quick fixes use that)
++
+→ Xtext feature request: solve multiple markers at a time (possible to do that right now: bind custom <code>XtextQuickAssistProcessor</code>, override <code>MarkerResolutionGenerator.getAdaptedResolutions(List&lt;IssueResolution&gt;</code>) – return a WorkbenchMarkerResolution)</p>
+</li>
+</ul>
+</div>
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Quick_Assist"><a class="anchor" href="#sec:Quick_Assist"></a><a class="link" href="#sec:Quick_Assist">15.1.1.6. Quick Assist</a></h5>
+<div class="quoteblock">
+<blockquote>
+"Quick assists perform local code transformations. They are invoked on a selection or a single cursor in the Java editor and use the same shortcut as quick fixes (Ctrl+1), but quick assist are usually hidden when an error is around. To show them even with errors present on the same line, press Ctrl+1 a second time."  (Eclipse Help)
+</blockquote>
+</div>
+<div class="paragraph">
+<p><code>like a quickfix without a problem</code></p>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Examples
+</td>
+<td class="hdlist2">
+<p>Add/remove inferred types</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Eclipse API
+</td>
+<td class="hdlist2">
+<p>Takes cursor position</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Xtext
+</td>
+<td class="hdlist2">
+<p>no Xtext support, e.g. no default implementation (XtextQuickAssistProcessor is a quick fix provider, has nothing to do with QuickAssist) but: XtextQuickAssistProcessor, override canAssist, override computeQuickAssistProposals</p>
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Clean_Up_Actions"><a class="anchor" href="#sec:Clean_Up_Actions"></a><a class="link" href="#sec:Clean_Up_Actions">15.1.1.7. Clean Up Actions</a></h5>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Examples
+</td>
+<td class="hdlist2">
+<p>Remove unused local vars, sort members</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Eclipse API
+</td>
+<td class="hdlist2">
+<p>None, JDT specific (see ICleanUp)</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Xtext Specifics
+</td>
+<td class="hdlist2">
+<p>None</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Best Practice
+</td>
+<td class="hdlist2">
+<p>Monkey sees - Monkey does (look at JDT), In the end a it’s a CompositeRefactoring, which is a CompletionProposal</p>
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Save_Actions"><a class="anchor" href="#sec:Save_Actions"></a><a class="link" href="#sec:Save_Actions">15.1.1.8. Save Actions</a></h5>
+<div class="paragraph">
+<p>Similar to clean up actions but performed on save</p>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Examples
+</td>
+<td class="hdlist2">
+<p>Format on save, Organize imports on save</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Eclipse API
+</td>
+<td class="hdlist2">
+<p>None, JDT specific (see IPostSaveListener)</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Xtext Specifics
+</td>
+<td class="hdlist2">
+<p>None</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Best Practice
+</td>
+<td class="hdlist2">
+<p>XtextDocumentProvider.doSaveDocument (maybe better solutions in the future ;-) )</p>
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Auto_Edit"><a class="anchor" href="#sec:Auto_Edit"></a><a class="link" href="#sec:Auto_Edit">15.1.1.9. Auto Edit</a></h5>
+<div class="paragraph">
+<p>Auto edit is about closing braces that just have been typed, adding indentation after a line break the code snippet <code>if (true)</code> so basically it should be unobtrusive typing aids.</p>
+</div>
+<div class="paragraph">
+<p>By default, restore model structure when editing (guide the user to proper text formatting, help the parser). Should not be used for other purposes in order to not hinder the user’s flow of editing.</p>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Examples
+</td>
+<td class="hdlist2">
+<p>( &#8594; ( &lt;cursor&gt; )</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Eclipse API
+</td>
+<td class="hdlist2">
+<p>org.eclipse.jface.text.IAutoEditStrategy</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Xtext Specifics
+</td>
+<td class="hdlist2">
+<p>org.eclipse.xtext.ui.editor.autoedit.AbstractEditStrategy, some utility methods + implements VerifyKeyListener. May use the ISourceViewer via implements ISourceViewerAware</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Best Practices
+</td>
+<td class="hdlist2">
+<p>Keep it as it is.</p>
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>Fun example but not useful in practice cf. <a href="https://code.google.com/a/eclipselabs.org/p/xtext-forms-integration/source/browse/trunk/plugins/org.eclipse.xtext.example.domainmodel.ui/src/org/eclipse/xtext/example/ui/autoedit/FantasticAutoEditStrategy.java?r=19">FantasticAutoEditStrategy</a></p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Template_Proposals"><a class="anchor" href="#sec:Template_Proposals"></a><a class="link" href="#sec:Template_Proposals">15.1.1.10. Template Proposals</a></h5>
+<div class="paragraph">
+<p>More sophisticated edit utils that are invoked by means of content assist.</p>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Examples
+</td>
+<td class="hdlist2">
+<p>sysout &#8594; System.out.println(<code>&lt;cursor&gt;</code> );</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Eclipse API
+</td>
+<td class="hdlist2">
+<p>Part of the completion proposal API, e.g. ICompletionProposal</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Xtext Specifics
+</td>
+<td class="hdlist2">
+<p>org.eclipse.xtext.ui.editor.contentassist.ITemplateProposalProvider, template contexts along the grammar rules by default, need to be stripped down to become usable.</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Best Practice
+</td>
+<td class="hdlist2">
+<p>ship some: create them manually in workbench, export them as XML, fix XML file (add IDs, in Xtext documentation), put XML file in folder <code>templates</code>  in UI plugin where propose a certain proposal: customize XtextTemplateContextTypeRegistry (bind subclass, override register context types) – by default too many context types are registered placeholders inside templates specific to Xtext – RTFM</p>
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Outline_View___Quick_Outline"><a class="anchor" href="#sec:Outline_View___Quick_Outline"></a><a class="link" href="#sec:Outline_View___Quick_Outline">15.1.1.11. Outline View / Quick Outline</a></h5>
+<div class="paragraph">
+<p>Structural represenation of the file contents (usually with different filter and sorting strategies).</p>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Examples
+</td>
+<td class="hdlist2">
+<p>Outline View (but not Navigator nor package explorer), Quick Outline (in Xtext: same provider)</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Eclipse API
+</td>
+<td class="hdlist2">
+<p>org.eclipse.ui.views.contentoutline.IContentOutlinePage</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Xtext Specifics
+</td>
+<td class="hdlist2">
+<p>Lazy tree creation, syncing via EObject ranges, thread save access to the EObject from nodes. Declarative API to create the tree contents. org.eclipse.xtext.ui.editor.outline.impl.DefaultOutlineTreeProvider
++
+allow actions on outline nodes (e.g., goto referenced file in <code>import</code>  of outline)</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Best Practice
+</td>
+<td class="hdlist2">
+<div class="ulist">
+<ul>
+<li>
+<p>Produced from semantic model, tree structure of outline nodes</p>
+<div class="ulist">
+<ul>
+<li>
+<p>show tree based on TypeModel, maybe filter out elements w/o SyntaxElements (with type model, this should be rather cheap!)</p>
+</li>
+<li>
+<p>use icons and styled labels (first user impression!)</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>May run in the background (BackgroundOutlineTreeProvider)</p>
+</li>
+<li>
+<p>done lazily</p>
+</li>
+<li>
+<p>workflow: reconceiler: outline is a model listener</p>
+</li>
+</ul>
+</div>
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>Helpful tools for icons in outline view:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><a href="http://marketplace.eclipse.org/content/eclipse-icon-archive-tool">Eclipse view</a> to show available Eclipse icons (that are of course licenced under EPL) with possibility to export them (<a href="http://bwgz-org.googlecode.com/files/EclipseIconArchiveTool-1.pdf">documentation</a>)</p>
+</li>
+<li>
+<p>overview of Eclipse icons: <a href="http://eclipse-icons.i24.cc/" class="bare">http://eclipse-icons.i24.cc/</a></p>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Navigator__Package_Explorer__Project_Explorer"><a class="anchor" href="#sec:Navigator__Package_Explorer__Project_Explorer"></a><a class="link" href="#sec:Navigator__Package_Explorer__Project_Explorer">15.1.1.12. Navigator, Package Explorer, Project Explorer</a></h5>
+<div class="paragraph">
+<p>three <code>explorers</code> , Navigator <code>latest</code>  and most extensible one</p>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Best Practices
+</td>
+<td class="hdlist2">
+<p>use Navigator only! (RTFM, nothing specific to Xtext yet)</p>
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>cf. <a href="http://projects.eclipse.org/projects/technology.handly" class="bare">http://projects.eclipse.org/projects/technology.handly</a> <code>read index and show it in the navigator</code></p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Hyperlinking_and_Navigation"><a class="anchor" href="#sec:Hyperlinking_and_Navigation"></a><a class="link" href="#sec:Hyperlinking_and_Navigation">15.1.1.13. Hyperlinking and Navigation</a></h5>
+<div class="paragraph">
+<p>Linking (propose multiple linking targets, e.g. goto declaration or goto implementation when CTRL (or other modifier) + Left Mouse Click on method when receiver type is interface - show all available implementations)</p>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Examples
+</td>
+<td class="hdlist2">
+<p>Go to declaration, Go to implementation, Go to super</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Eclipse API
+</td>
+<td class="hdlist2">
+<p>org.eclipse.jface.text.hyperlink.IHyperlinkDetector</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Xtext Specifics
+</td>
+<td class="hdlist2">
+<p>org.eclipse.xtext.ui.editor.hyperlinking.DefaultHyperlinkDetector, navigation to EObject URI most interesting: SIGNIFICANT cf. org.eclipse.xtext.resource.ILocationInFileProviderExtension.RegionDescription</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Best Practice
+</td>
+<td class="hdlist2">
+<div class="ulist">
+<ul>
+<li>
+<p>subclass and bind IHyperlinkHelper (returns an array of possible links, first one is the default)</p>
+</li>
+<li>
+<p>also see ILocationInFileProviderExtension (cf. navigation to syntax elements instead of types)</p>
+</li>
+</ul>
+</div>
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Syntax_and_Semantic_Coloring"><a class="anchor" href="#sec:Syntax_and_Semantic_Coloring"></a><a class="link" href="#sec:Syntax_and_Semantic_Coloring">15.1.1.14. Syntax and Semantic Coloring</a></h5>
+<div class="paragraph">
+<p>Coloring based on the lexical tokens or based on the semantic tokens (the parsed model). The parser may treat certain lexical keywords as valid identifiers in some contexts. Some of those should not appear as keywords. Semantic coloring is usually more expensive to compute thus run in the background and with some delay</p>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Examples
+</td>
+<td class="hdlist2">
+<p>Numbers, String literals (lexical) Escape sequences in Strings, method calls, property read / write access (semantic)</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Eclipse API
+</td>
+<td class="hdlist2">
+<p><code>org.eclipse.jface.text.presentation.IPresentationDamager</code> <code>org.eclipse.jface.text.presentation.IPresentationRepairer</code> <code>org.eclipse.jface.text.rules.ITokenScanner</code>
++
+Scan for tokens and associate text attributes with tokens. Compute the region of the document that has to be recolored after a text change. Tokens may not overlap.
++
+Also Eclipse provides Themes that are styled via CSS. Coloring can be adjusted to themes where the logical names are mapped to different default values.</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Xtext Specifics
+</td>
+<td class="hdlist2">
+<div class="ulist">
+<ul>
+<li>
+<p><code>o.e.x.ui.editor.syntaxcoloring.ITextAttributeProvider</code> - associate Antlr token names with coloring styles (logical names of text coloring)</p>
+</li>
+<li>
+<p><code>o.e.x.ui.editor.syntaxcoloring.AbstractAntlrTokenToAttributeIdMapper</code>- convert the antlr tokens to JFace ITokens with proper text applied</p>
+</li>
+<li>
+<p><code>o.e.x.ui.editor.syntaxcoloring.IHighlightingConfiguration</code> - register logical text colorings with default values, yields a preference page and the proper configuration for the text attribute provider</p>
+</li>
+<li>
+<p><code>o.e.x.ui.editor.syntaxcoloring.ISemanticHighlightingCalculator</code> - traverse the AST and associate arbitrary ranges of the text with.</p>
+</li>
+<li>
+<p>logical coloring names (this is a key to a style stored in the preference store), if multiple styles are returned, styles will be merged if they overlap (and if possible); JFace constraints are implicitly fulfilled</p>
+</li>
+</ul>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Best Practice
+</td>
+<td class="hdlist2">
+<div class="ulist">
+<ul>
+<li>
+<p>subclass DefaultSemanticHighlightingCalculator and bind ISemanticHighlightingCalculator</p>
+<div class="ulist">
+<ul>
+<li>
+<p>traverse resource from left to right (usually order of semantic elements – small performance improvement)</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>provide new logical style: subclass DefaultHighlightingConfiguration and bind IHighlightingConfiguration; override configure (see overridden)</p>
+</li>
+<li>
+<p>semantic coloring always wins</p>
+</li>
+<li>
+<p>only a few decisions can me made in lexical coloring, override lexical:</p>
+<div class="ulist">
+<ul>
+<li>
+<p>subclass <code>DefaultAntlrTokenToAttributeIdMapper</code> bind <code>TokenTypeToStringMapper</code></p>
+</li>
+<li>
+<p>e.g., color jsdoc comments differently to multiline, regex</p>
+</li>
+<li>
+<p>e.g. color tags inside jsdocs or regex inside, use semantic coloring</p>
+</li>
+<li>
+<p>lexical: different kind of keywords (e.g., N4JS keywords vs. JS keywords)</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>change coloring (via toggle button), possible approach:</p>
+<div class="ulist">
+<ul>
+<li>
+<p>(inject singleton into highlighter, state of singleton is changed by toggle button, listen to that object in the editor, calculator cannot be triggered from outside due to UI-thread issues)</p>
+</li>
+<li>
+<p>prefered: store state in preference store and get the information then from there in the hightligher, inject PreferencestoreAccess in Calculator</p>
+</li>
+</ul>
+</div>
+</li>
+</ul>
+</div>
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Code_Formatter"><a class="anchor" href="#sec:Code_Formatter"></a><a class="link" href="#sec:Code_Formatter">15.1.1.15. Code Formatter</a></h5>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Examples
+</td>
+<td class="hdlist2">
+<p>Auto-Format Source Code, Auto-Format code inserted by code-rewrite</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Eclipse API
+</td>
+<td class="hdlist2">
+<p><code>org.eclipse.jface.text.formatter.IContentFormatter</code> - here is the document and some range - modify at will</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Xtext Specifics
+</td>
+<td class="hdlist2">
+<p>Declarative Formatting API (to be deprecated) - associate formatting rules with grammar elements New formatting API (mixture of declarative and imperative) - here is the model, do what you want (space before, linebreak after, indentation increase / decrease), the engine will merge your advices and apply them to the document</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Best Practice
+</td>
+<td class="hdlist2">
+<p>wait for 2.8 (maybe in 2.7.x)</p>
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Wizards"><a class="anchor" href="#sec:Wizards"></a><a class="link" href="#sec:Wizards">15.1.1.16. Wizards</a></h5>
+<div class="quoteblock">
+<blockquote>
+Wizards are used to guide the user through a sequenced set of tasks. Your plug-in can contribute wizards at predefined extension points in the workbench. It can also create and launch its own wizards.
+</blockquote>
+<div class="attribution">
+&#8212; Eclipse Help
+</div>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Examples
+</td>
+<td class="hdlist2">
+<p>New N4JS Class</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Eclipse API
+<br>
+Xtext Specifics
+</td>
+<td class="hdlist2">
+<div class="ulist">
+<ul>
+<li>
+<p>Xtend based Wizards</p>
+</li>
+<li>
+<p>also see Formular Editor for Embedded Xtext editor</p>
+</li>
+</ul>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Best Practices
+</td>
+<td class="hdlist2">
+<div class="ulist">
+<ul>
+<li>
+<p>use preferences (could be hidden, so use them even if not made configurable to the user)</p>
+</li>
+<li>
+<p>use standard JFace wizard API, use Xtend template expressions for file templates</p>
+</li>
+</ul>
+</div>
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Cheat_Sheets"><a class="anchor" href="#sec:Cheat_Sheets"></a><a class="link" href="#sec:Cheat_Sheets">15.1.1.17. Cheat Sheets</a></h5>
+<div class="quoteblock">
+<blockquote>
+<div class="paragraph">
+<p>Composite cheat sheets provide guidance through complex problems by breaking the problem into a set of smaller tasks. Composite cheat sheets are registered using the the <code>org.eclipse.ui.cheatsheets.cheatSheetContent</code> extension point.</p>
+</div>
+</blockquote>
+<div class="attribution">
+&#8212; Eclipse Help
+</div>
+</div>
+<div class="paragraph">
+<p>(In Scala IDE: Work Sheets), often combined with Code Snippets</p>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Examples
+</td>
+<td class="hdlist2">
+<p>Create Hello World Application</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Eclipse API
+<br>
+Xtext Specifics
+</td>
+<td class="hdlist2">
+<p>None, probably the embedded editor could be used in a REPL (Read-Evaluate-Print-Loop)</p>
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Context_sensitive_Help"><a class="anchor" href="#sec:Context_sensitive_Help"></a><a class="link" href="#sec:Context_sensitive_Help">15.1.1.18. Context-sensitive Help</a></h5>
+<div class="quoteblock">
+<blockquote>
+<div class="paragraph">
+<p>A focused set of help topics that is related to the current context can be shown to users on demand using context-sensitive help. This form of user assistance is delivered to users when a platform-specific trigger is activated (e.g. F1 key on Windows, Ctrl+F1 on GTK, Help key on Carbon). Until Eclipse 3.1, context-sensitive help was presented in infopop windows. Since 3.1, a new Help view is the preferred way to deliver context-sensitive information to the user.</p>
+</div>
+</blockquote>
+<div class="attribution">
+&#8212; Eclipse Help
+</div>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Examples
+</td>
+<td class="hdlist2">
+<p>Help in Formular Editor, Help about syntax construct, API-Help</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Eclipse API
+<br>
+Xtext Specifics
+</td>
+<td class="hdlist2">
+<p>None</p>
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Hovers"><a class="anchor" href="#sec:Hovers"></a><a class="link" href="#sec:Hovers">15.1.1.19. Hovers</a></h5>
+<div class="paragraph">
+<p>Hover allow to display additional information as soon as the cursor stays on a certain text region. Some hovers can be requested by shortcuts (e.g. F2) similar to sort of an online help.</p>
+</div>
+<div class="paragraph">
+<p>Different kind of hovers may appear depending on the context, e.g. the error hover will have higher prio than the documentation hover. Different modifier keys may be assigned to request different hover kinds while hovering a region with the mouse. (didn’t a proper code pointer, though)</p>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Examples
+</td>
+<td class="hdlist2">
+<p>Hover over method shows JSDoc, Signatures or inferred types, error / problem details</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Eclipse API
+</td>
+<td class="hdlist2">
+<p><code>org.eclipse.jface.text.ITextHover</code> + <code>ITextHoverExtension*</code> - compute hover based on the region that is hovered. Various indirections with <code>IInformationControl</code> and <code>IInformationControlCreator</code> with many extension interfaces</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Xtext Specifics
+</td>
+<td class="hdlist2">
+<p><code>org.eclipse.xtext.ui.editor.hover.IEObjectHover</code> - compute hover based on <code>EObjects</code></p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Best Practice
+</td>
+<td class="hdlist2">
+<p>see XBase hover stuff</p>
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Folding"><a class="anchor" href="#sec:Folding"></a><a class="link" href="#sec:Folding">15.1.1.20. Folding</a></h5>
+<div class="paragraph">
+<p>Code folding allows to skip parts of the code that are mandatory semantically but usually do not provide added value for the reader, e.g. import sections</p>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Examples
+</td>
+<td class="hdlist2">
+<p>Import section folding, folding of arbitrary methods or comments</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Eclipse API
+</td>
+<td class="hdlist2">
+<p>Not much there, most of that stuff is implemented specific to JDT or ODE. Projections usually only work per line, that is, a subsection of a line cannot be folded, e.g. it’s not possible to show</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>var x = new Map&lt;String, List&lt;Pair&lt;String, Number&gt;&gt;&gt;()</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>as</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>var x = new Map&lt;...&gt;()</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Line only limitation in SWT (a guess, didn’t work for Sebastian otherwise)</p>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Xtext Specifics
+</td>
+<td class="hdlist2">
+<div class="ulist">
+<ul>
+<li>
+<p><code>org.eclipse.xtext.ui.editor.folding.DefaultFoldingRegionProvider</code> - here is the resource, compute the folding</p>
+</li>
+<li>
+<p><code>org.eclipse.xtext.ui.editor.folding.DefaultFoldingStructureProvider</code> - bridge between editor and custom computation, preferences etc would be read from here</p>
+</li>
+<li>
+<p>no preference page for folding provided by Xtext</p>
+</li>
+</ul>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Best Practice
+</td>
+<td class="hdlist2">
+<div class="ulist">
+<ul>
+<li>
+<p>maybe limit to blocks (subclass default, bind to interface)</p>
+</li>
+<li>
+<p>probably provide your own folding preference page</p>
+</li>
+</ul>
+</div>
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Customizable_validation___severity"><a class="anchor" href="#sec:Customizable_validation___severity"></a><a class="link" href="#sec:Customizable_validation___severity">15.1.1.21. Customizable validation / severity</a></h5>
+<div class="paragraph">
+<p>Some problems are more important to the user than others so they want to change the severity.</p>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Examples
+</td>
+<td class="hdlist2">
+<p>Deprecation could be an error, warning or ignored (e.g. in test projects)</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Eclipse API
+</td>
+<td class="hdlist2">
+<p>None</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Xtext Specifics
+</td>
+<td class="hdlist2">
+<p>IssueSeverityProvider (since 2.6), Monkey sees monkey does: see subclasses of IssueSeverityProvider (we already do that)</p>
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Proposals"><a class="anchor" href="#sec:Proposals"></a><a class="link" href="#sec:Proposals">15.1.1.22. Proposals</a></h5>
+<div class="paragraph">
+<p>Created by Content Assist, Quick Fixes, Quick Assist.</p>
+</div>
+<div class="paragraph">
+<p>Basics</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>simplest case: proposals are strings to be inserted</p>
+</li>
+<li>
+<p>or displayed string is different from inserted one (e.g. FQN vs. simple)</p>
+</li>
+<li>
+<p>ConfigurableCompletionProposal created via factory methods in AbstractN4JSProposalProvider (*create*Pro)</p>
+</li>
+<li>
+<p>PrefixMatcher (by default CamelCase aware) – for filtering, it usually is not necessary to use it when computing the proposal (only if it expensive to compute proposals) – that is, prefix can be ignored when computing a proposal because the prefix matcher will filter out invalid proposals anyway</p>
+</li>
+<li>
+<p>pass a filter (Guava preodicate) to filter out (semantically invalid) proposals, cf. lookupCrossReference(..) – for the things where there are proposals created by default</p>
+</li>
+<li>
+<p>priority defined by an int – for sorting. Cf. ContentProposalPriorities → define default priorities (constant values) in N4JS, do not add some random integers!</p>
+</li>
+<li>
+<p>modes: bind RepeatedContentAssistProcessor and enable modeaware in ProposalProvider (e.g. for private members which require a quickfix)</p>
+</li>
+<li>
+<p>what could be done in the background: hover, lazy (not prepared) proposals (cf. JDT), Xtext 2.7.; different situations are processed in parallel</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Several changes (e.g. automatic import):</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>ConfigurableCompletionProposal.setTextApplier</code></p>
+</li>
+<li>
+<p>TextApplier: can open dialogs etc., TextApplier is the callback</p>
+</li>
+<li>
+<p>usual case: add text at cursor position and somewhere else:</p>
+<div class="ulist">
+<ul>
+<li>
+<p>get document in TextApplier</p>
+</li>
+<li>
+<p>for performance, but also: do not use semantic changes in content assist, because model is broken (you will get funny things) – use model (AST) to get offset, but then insert line breaks etc. → maybe create utility class for retrieving current formattings which are then used in the text edit → maybe provide tools for retrieving certain locations (e.g. import section, field section, etc.)</p>
+</li>
+<li>
+<p>do not create model (AST) fragments (which are then serialized), instead directly provide text</p>
+</li>
+<li>
+<p>use TextEdit and MultiTextEdit</p>
+</li>
+<li>
+<p>set TextViewer redraw to false and to true after the text edits were applied</p>
+</li>
+<li>
+<p>have proper TESTS to ensure that file is not broken after the changes</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p><strong>LinkedEditing</strong>:</p>
+<div class="ulist">
+<ul>
+<li>
+<p>Linked-Editing mode in ConfigurableCompletionProposal with one editing group only (basically: move the cursor somewhere after editing it, see setSimpleLinkedMode)</p>
+</li>
+<li>
+<p>do it manually: cf. LinkedPositionGroup (see call hierarchy of constructor) – used for quick fixes or refactorings rather for content assist</p>
+</li>
+</ul>
+</div>
+</li>
+</ul>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Non_Eclipse_UI_Concepts"><a class="anchor" href="#sec:Non_Eclipse_UI_Concepts"></a><a class="link" href="#sec:Non_Eclipse_UI_Concepts">15.1.2. Non-Eclipse UI Concepts</a></h4>
+<div class="paragraph">
+<p>The following entries are not necessarily implemented yet.</p>
+</div>
+<div class="sect4">
+<h5 id="sec:Overlays"><a class="anchor" href="#sec:Overlays"></a><a class="link" href="#sec:Overlays">15.1.2.1. Overlays</a></h5>
+<div class="paragraph">
+<p>An overlay is a small annotation similar to an hover, attached to a specific location in the editor and is moved with that location.</p>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Examples
+</td>
+<td class="hdlist2">
+<p>Show inferred types</p>
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Goto__Inferred__Type"><a class="anchor" href="#sec:Goto__Inferred__Type"></a><a class="link" href="#sec:Goto__Inferred__Type">15.1.2.2. Goto (Inferred) Type</a></h5>
+<div class="paragraph">
+<p>Navigate to an inferred type (or other <code>invisible</code>  information)</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Postfix_Completion"><a class="anchor" href="#sec:Postfix_Completion"></a><a class="link" href="#sec:Postfix_Completion">15.1.2.3. Postfix Completion</a></h5>
+<div class="paragraph">
+<p>(IntelliJ) Replace code <em>AFTER</em> an expression</p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_user-interface-resources"><a class="anchor" href="#_user-interface-resources"></a><a class="link" href="#_user-interface-resources">15.2. User Interface Resources</a></h3>
+<div class="sect3">
+<h4 id="_icons"><a class="anchor" href="#_icons"></a><a class="link" href="#_icons">15.2.1. Icons</a></h4>
+<div class="paragraph">
+<p>In parts, the N4JS IDE re-uses some of the icons that come with the Eclipse Platform as well as the Eclipse JDT development environment. However, in some cases we also provide our own icons to illustrate N4JS-specific concepts.</p>
+</div>
+<div class="sect4">
+<h5 id="_eclipse-platform-icons"><a class="anchor" href="#_eclipse-platform-icons"></a><a class="link" href="#_eclipse-platform-icons">15.2.1.1. Eclipse Platform Icons</a></h5>
+<div class="paragraph">
+<p>When re-using the Eclipse Platform Icons, the icons are usually copied over to the <code>icons/</code> folder of the <code>org.eclipse.n4js.ui</code> bundle. In this folder, the <code>README.adoc</code> file keeps book on the origin of all the collected icons (e.g. different Eclipse Projects).</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_n4js-specific-icons"><a class="anchor" href="#_n4js-specific-icons"></a><a class="link" href="#_n4js-specific-icons">15.2.1.2. N4JS Specific Icons</a></h5>
+<div class="paragraph">
+<p>In some cases, the icons the Eclipse eco-system provides do not suffice to sensibly express N4JS concepts. In these cases we provide our own icons. When designing those we try to imitate the general Eclipse artstyle in order for our icons to integrate well with the overall appearance of Eclipse.</p>
+</div>
+<div class="paragraph">
+<p>For the creation of new icons, the <code>eclipse-svg-icons</code> repository (see <a href="https://github.com/Seung-Yoon/eclipse-svg-icons" class="bare">https://github.com/Seung-Yoon/eclipse-svg-icons</a>) has proven helpful. The repository contains raw SVG files which can be used to reproduce the bitmap icons that are contained in, for instance, the <code>org.eclipse.platform.ui</code> or <code>org.eclipse.jdt.ui</code> bundle. Based on that, common vector-graphics editing software may be used to further adapt color, form and style of existing icons (e.g. Inkscape <a href="https://inkscape.org/en/" class="bare">https://inkscape.org/en/</a>).</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_high-resolution-icons"><a class="anchor" href="#_high-resolution-icons"></a><a class="link" href="#_high-resolution-icons">15.2.1.3. High Resolution Icons</a></h5>
+<div class="paragraph">
+<p>With the Neon release, Eclipse SWT introduced explicit support for high-DPI monitors (see <a href="https://www.eclipse.org/eclipse/news/4.6/platform.php#swt-autoscale" class="bare">https://www.eclipse.org/eclipse/news/4.6/platform.php#swt-autoscale</a>). In order to provide a good user experience, we want to provide high-DPI support for as many of our icons as possible. For that, it suffices to simply provide an alternative resource with higher resolution by appending the prefix @2x to its name (e.g. <code>class.png</code> and <code>class@2x.png</code>). Code-wise, no adjustments are required. In case of copied Eclipse Platform Icons, most of the time a corresponding 2x-version can be obtained from the original source. In case of N4JS Specific Icons, we export all icons in the resolutions 16x16 and 32x32. For that, it is of particular importance to make sure that the scaling is done in accordance with the native resolution (cf. pixel perfect scaling, also see <a href="https://en.wikipedia.org/wiki/Native_resolution" class="bare">https://en.wikipedia.org/wiki/Native_resolution</a>).</p>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_formatting"><a class="anchor" href="#_formatting"></a><a class="link" href="#_formatting">16. Formatting</a></h2>
+<div class="sectionbody">
+<div class="admonitionblock warning">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-warning" title=""></i>
+</td>
+<td class="content">
+This chapter may be outdated.
+</td>
+</tr>
+</table>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:FmtObjective"><a class="anchor" href="#sec:FmtObjective"></a><a class="link" href="#sec:FmtObjective">16.1. Objective</a></h3>
+<div class="paragraph">
+<p>Writing textual code has many degrees of freedom. The resulting layout differs between authors. Carefully placing whitespace and newlines can increase the readability. Some handling of whitespace can be automated. This chapter describes the techniques used to automate the formatting to some degree.</p>
+</div>
+<div class="paragraph">
+<p>Formatting N4js source code ensures a consistent style. It takes care of:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>surrounding language constructs with white space to improve readability</p>
+</li>
+<li>
+<p>indenting logically grouped elements</p>
+</li>
+<li>
+<p>wrapping long lines of code and comments</p>
+</li>
+<li>
+<p>inserting semicolons, which would otherwise be automatically inserted (ASI)</p>
+</li>
+<li>
+<p>formatting documentation</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Formatting will never alter the semantics of the code and it will not reorganize it.</p>
+</div>
+<div class="sect3">
+<h4 id="sec:FmtFormatting_Comments"><a class="anchor" href="#sec:FmtFormatting_Comments"></a><a class="link" href="#sec:FmtFormatting_Comments">16.1.1. Formatting Comments</a></h4>
+<div class="paragraph">
+<p>N4js distinguishes five different types of comments <em>single line comments</em>, <em>not-indented single line comments</em>, <em>multiline comments</em>, <em>fixed multiline comments</em> and <em>Jsdoc style multiline comments.</em></p>
+</div>
+<div class="paragraph">
+<p>Single line comments start with <code>//</code>  and include all characters until the end of line. They usually will be indented and wrapped if they exceed the maximum line length unless they start immediately at the first column. Single line comments starting at position 0 are called <em>not-indented single line comments</em>.</p>
+</div>
+<div class="paragraph">
+<p>Multiline comments start with <code>/*</code>  and span all character including line breaks up the the end given by <code>*/</code> . The three variants are distinguished by the third and fourth character:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Comments starting with <code>/*-</code>  are always fixed multiline comments.</p>
+</li>
+<li>
+<p>Comments starting with <code>/**</code>  and following any other character but <code>*</code>  are Jsdoc style multiline comments. (E.g. <code>/**+</code>  start Jsdoc but <code>/***</code>  does not.)</p>
+</li>
+<li>
+<p>All others starting with <code>/*</code>  are ordinary multiline comments.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p><em>Not-indented single line comments</em> and <em>fixed multiline comments</em> will always remain as they are. Usually they are used to comment out code sections.</p>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:FmtArchitecture"><a class="anchor" href="#sec:FmtArchitecture"></a><a class="link" href="#sec:FmtArchitecture">16.2. Architecture</a></h3>
+<div class="paragraph">
+<p>Formatting mainly takes place in polymorphic dispatch methods <code>format</code> in class <code>N4JSFormatter</code>. Some language features are formatted with an entry-point using a super-class. This is mainly the case for structures that are sufficiently similar. E.g. <code>format( FunctionOrFieldAccessor )</code> is responsible for getter, setter, methods, functions, ….</p>
+</div>
+<div class="paragraph">
+<p>Some common source-code formattings are grouped by <code>configureXY()</code> methods. They get called from the <code>format</code> methods for similar code structures, c.f. <code>configureAnnotations</code></p>
+</div>
+<div class="paragraph">
+<p>Since we do not support formatting of the TypeExpression-language stand-alone, this class provides only one format-method throwing an <code>UnsupportedOperationException</code> type expressions formatting is defined in class <code>N4JSFormatter</code> at the end of the file.</p>
+</div>
+<div id="fig:formatter_overview" class="imageblock center">
+<div class="content">
+<img src="chapters/17_formatting/images/FormatterArchitecture.svg" alt="FormatterArchitecture">
+</div>
+<div class="title">Figure 47. Overview of classes used for formatting</div>
+</div>
+<div class="paragraph">
+<p>The first entry-point for a script is <code>N4JSFormatter.format(Script, IFormattableDocument)</code>. Within this method an instance of <code>N4JSGenericFormatter</code> is created and used to configure general aspects of automatic-semicolon insertion (put a ’<code>;</code>’ where ASI took place in the parser) and handling of colons (’<code>:</code>’).</p>
+</div>
+<div class="sect3">
+<h4 id="sec:Implementation_example"><a class="anchor" href="#sec:Implementation_example"></a><a class="link" href="#sec:Implementation_example">16.2.1. Implementation example</a></h4>
+<div class="paragraph">
+<p>Considering the following N4js-snippet where the return value of a function call will be casted to some type.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>functionCall("a","b") as MyType&lt;string&gt;</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>The whole line is a CastExpression comprising of an expression (<code>functionCall(a,b)</code>) and a type reference (<code>MyType&lt;string&gt;</code>).</p>
+</div>
+<div class="paragraph">
+<p>The <code>format</code>-dispatch method written in Xtend would look like:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>    def dispatch void format(CastExpression expr, extension IFormattableDocument document) {
+        expr.regionFor.keyword("as").prepend[newLines = 0; oneSpace].append[newLines = 0; oneSpace];
+        expr.expression.format;
+        expr.targetTypeRef.format;
+    }</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>In line 2 the format around the keyword <code>as</code> is specified where in line 3 and 4 the formatting of the containing elements will be dispatched.</p>
+</div>
+<div class="paragraph">
+<p>Note that <code>regionFor</code> in line 2 is a method declared in <code>IFormattableDocument</code> and used via the extension-parameter <code>document</code>. It returns an object of type <code>ISemanticRegionFinder</code>. Invoking the <code>keyword</code> method on this object returns an instance of <code>ISemanticRegion</code> which will be passed to the extension methods <code>prepend</code> and <code>append</code> following the builder pattern. Both <code>prepend</code> and <code>append</code> take a lambda expression operating on a single parameter of type <code>IHiddenRegionFormatter</code>. Inside the lambda-expression this parameter is implicitly used to invoke the methods <code>setNewLines(0)</code> and <code>oneSpace()</code>. These calls simply disallow line-breaks around as and force the whitespace to be just a single character.</p>
+</div>
+<div class="paragraph">
+<p>Possible other formatting instructions can be found in <code>IHiddenRegionFormatter</code>.</p>
+</div>
+<div class="paragraph">
+<p>Due to some bugs in auto-wrapping<sup class="footnote">[<a id="_footnoteref_16" class="footnote" href="#_footnote_16" title="View footnote.">16</a>]</sup> unsuccessful attempts to wrap a line can insert unexpected new-lines in regions several lines in front of the currently treated source-line.</p>
+</div>
+<div class="paragraph">
+<p>Debugging the formatter can be cumbersome as, due to GH-12<sup class="footnote">[<a id="_footnoteref_17" class="footnote" href="#_footnote_17" title="View footnote.">17</a>]</sup>, the <code>toString()</code> methods if internal data-structures throw exceptions.</p>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="sec:FmtFormatter_Implementation_Guidelines"><a class="anchor" href="#sec:FmtFormatter_Implementation_Guidelines"></a><a class="link" href="#sec:FmtFormatter_Implementation_Guidelines">16.3. Formatter Implementation Guidelines</a></h3>
+<div class="ulist">
+<ul>
+<li>
+<p>Each formatted element should only format it’s inner content. This avoids conflicting situations.</p>
+</li>
+<li>
+<p>For each region possibly containing whitespace must be formatted.</p>
+</li>
+<li>
+<p>Use priorities for conflict-resolutions sparse. For contradicting informations in the same region, the higher priority wins. If both information have the same priority, then an Exception will be thrown, showing two stack-traces to indicate the two code-regions being responsible for the situation.</p>
+</li>
+<li>
+<p>For auto-wrapping a callback can be registered. In case of wrapping you can then conditionally change the format. Registering a callback implicitly sets the auto-wrap flag for the region.</p>
+</li>
+<li>
+<p>Cover formatting with at least two different unit-tests. One having as little white-space as possible (all in one line) and the other as much white-space as possible in order to identify unformatted regions.</p>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect2">
+<h3 id="sec:FmtConfiguration"><a class="anchor" href="#sec:FmtConfiguration"></a><a class="link" href="#sec:FmtConfiguration">16.4. Configuration</a></h3>
+<div class="paragraph">
+<p>Some formattings can be customised through preference key-value pairs. Class <code>N4JSFormatterPreferenceKeys</code> acts as the entry-point to define such key-(default-)value pairs. Some preferences are inherited and are based on values stored in the default preference store (Line length, default tab width, …).</p>
+</div>
+<div class="paragraph">
+<p>Currently the preferences are not yet accessible by the end-user.</p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="sec:FmtUI_Integration"><a class="anchor" href="#sec:FmtUI_Integration"></a><a class="link" href="#sec:FmtUI_Integration">16.5. UI Integration</a></h3>
+<div class="paragraph">
+<p>Code formatting is invoked with standard key-strokes ( <kbd>CMD</kbd>+<kbd>Shift</kbd>+<kbd>F</kbd> on Mac, <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>F</kbd> on Windows)</p>
+</div>
+<div class="paragraph">
+<p>There is no UI for preferences values yet.</p>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:FmtUnit_Testing_with_Xpect"><a class="anchor" href="#sec:FmtUnit_Testing_with_Xpect"></a><a class="link" href="#sec:FmtUnit_Testing_with_Xpect">16.6. Unit Testing with Xpect</a></h3>
+<div class="paragraph">
+<p>With Xpect Method <code>formattedLines</code> implemented in class <code>org.eclipse.n4js.xpect.FormatterXpectMethod</code> in bundle <code>org.eclipse.n4js.tests.helper</code> the formatting can be tested. The test method requires the number of lines which should be formatted. The desired test is given as a standard multiline expectation.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>/* XPECT formattedLines 1 ---
+var a, b, c, d, e;
+--- */
+var a,b,c,d,e;</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Preferences can be configured in the Xpect setup section by providing string values. Numbers and booleans are converted automatically by the preferences framework.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>/* XPECT_SETUP org.eclipse.n4js.tests.N4JSXpectTest
+    ResourceSet {
+        ThisFile {}
+        File "wishesImported.n4js" {  }
+    }
+    Preference "indentation" "    " {}
+    Preference "line.width.max" "100" {}
+    Preference "format.auto_wrap_in_front_of_logical_operator" "false" {}
+
+   END_SETUP
+ */</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Tip: Full coverage of the formatting can be tested via authoring the input using spaces as indentation characters if the formatter would use tabs or vice versa. That way untouched lines are distinguishable during the test-runs</p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_external-libraries"><a class="anchor" href="#_external-libraries"></a><a class="link" href="#_external-libraries">17. External Libraries</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p></p>
+</div>
+<div class="sidebarblock">
+<div class="content">
+<a href="https://github.com/eclipse/n4js/issues/1018" class="gray" title="GitHub Issues"><span class="image"><img src="images/issue.svg" alt=""></span> #1018</a>
+<a href="https://github.com/eclipse/n4js/issues/397" class="gray" title="GitHub Issues"><span class="image"><img src="images/issue.svg" alt=""></span> #397</a>
+<a href="https://github.com/eclipse/n4js/issues/809" class="gray" title="GitHub Issues"><span class="image"><img src="images/issue.svg" alt=""></span> #809</a>
+<a href="https://github.com/eclipse/n4js/issues/714" class="gray" title="GitHub Issues"><span class="image"><img src="images/issue.svg" alt=""></span> #714</a>
+<a href="https://github.com/eclipse/n4js/issues/653" class="gray" title="GitHub Issues"><span class="image"><img src="images/issue.svg" alt=""></span> #653</a>
+<a href="https://github.com/eclipse/n4js/issues/862" class="gray" title="GitHub Issues"><span class="image"><img src="images/issue.svg" alt=""></span> #862</a>
+<a href="https://github.com/eclipse/n4js/issues/1133" class="gray" title="GitHub Issues"><span class="image"><img src="images/issue.svg" alt=""></span> #1133</a>
+</div>
+</div>
+<div class="paragraph">
+<p><strong>External libraries</strong> are N4JS projects that are provided by the N4JS IDE:
+the <em>built-in</em>/<em>shipped</em> libraries, and all <em>3rd-party libraries</em> that were installed by the <em>N4JS library manager</em>.
+Each external library consist of a valid package.json file located in the project root and an arbitrary number of files supported by N4JS projects, e.g. <em>.n4js</em>, <em>.njsd</em> and <em>.js</em> files.
+The purpose of the external libraries is to share and to provide core and third party functionality for N4JS developers both in compile and runtime without rebuilding them.</p>
+</div>
+<div class="paragraph">
+<p><a href="#sec:Built-in_External_Libraries">[sec:Built-in_External_Libraries]</a> are external libraries that provide some basic functionality for N4JS programmers, such as the class <code>N4Injector</code>.</p>
+</div>
+<div class="paragraph">
+<p><strong>3rd-party libraries</strong> are external libraries that are not built-in/shipped with the N4JS IDE.
+Instead, they can be installed later by the user from third party providers.
+Currently, only <em>npm packages</em> are supported.</p>
+</div>
+<div class="paragraph">
+<p>The <strong>N4JS index</strong> is populated when the external libraries are compiled.
+However, this compilation is only triggered through the library manager, but not when building workspace projects. (Self-evidently, the index is also populated when compiling workspace projects.)</p>
+</div>
+<div class="paragraph">
+<p><strong>Name clashes</strong> of projects can happen and they are solved in the following order:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>User workspace projects always shadow external libraries.</p>
+</li>
+<li>
+<p>In case of a name clash between a shipped and a 3rd-party library, the 3rd-party library shadows the shipped project.</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>The <strong>N4JS library manager</strong> is a tool in the N4JS IDE to view and manage external libraries.
+In particular, the user can (un-)install new 3rd-party libraries, or can trigger the build of all external libraries to re-populate the N4JS index.
+The library manager also supports other maintenance actions such as deleting all 3rd-party libraries.</p>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:Major_Components"><a class="anchor" href="#sec:Major_Components"></a><a class="link" href="#sec:Major_Components">17.1. Major Components</a></h3>
+<div class="paragraph">
+<p>External libraries are supported based on different components all over the application.</p>
+</div>
+<div class="paragraph">
+<p>The followings are the most important ones:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><strong>External Resources</strong> (<code>IExternalResource</code>)</p>
+<div class="ulist">
+<ul>
+<li>
+<p>These are customized <code>IResource</code> implementations for external projects, folders and files.</p>
+</li>
+<li>
+<p>With this approach the <code>IProject</code>, <code>IFolder</code> and <code>IFile</code> interfaces have been implemented. Each implementation is backed by a pure <code>java.io.File</code> based resource.</p>
+</li>
+<li>
+<p>When accessing such external resources for example visiting purposes, getting the members of the resource or simply deleting the resource, internally each requests will be directly performed on the wrapped <code>java.io.File</code> without accessing the <code>org.eclipse.core.resources.IWorkspace</code> instance.</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p><strong>External Library Workspace</strong></p>
+<div class="ulist">
+<ul>
+<li>
+<p>This is a kind of dedicated workspace for external libraries and their dependencies.</p>
+</li>
+<li>
+<p>Any query requests to retrieve a particular project or any dependencies of a particular project via the <code>IN4JSCore</code> singleton service will delegated to its wrapped <code>N4JSModel</code> singleton. Internally the <code>N4JSModel</code> has a reference to a workspace for all the ordinary workspace projects and another reference to the workspace for external libraries. Each query requests will be forwarded to the workspace for the ordinary projects first, and then to the external library workspace. If ordinary project workspace can provide any meaningful response for a request, then the external library workspace will not be accessed at all. Otherwise the query will be executed against the external library workspace. This fallback mechanism provides a pragmatic solution to the project shadowing feature. The project shadowing will be described in details later in this section.</p>
+</li>
+<li>
+<p>The <strong>External Library Workspace</strong> is only supported and available in the IDE case, in the headless case there are no external libraries available from this dedicated workspace. Since the Xtext index creation and the entire build infrastructure is different, it is supported via target platform file. This is described in more details in a later section (<a href="#sec:Headless_External_Library_Support">Headless External Library Support</a>]).</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p><strong>External Library Preference Store</strong></p>
+<div class="ulist">
+<ul>
+<li>
+<p>This preference store is being used to register and un-register external library root folders into its underlying ordered list. A folder is called as an external library root folder if it is neither equal with the Eclipse workspace root nor being nested in the workspace root and contains zero to any external libraries.</p>
+</li>
+<li>
+<p>Whenever any modifications are being saved in this preference store the <em>External Library Workspace</em> will be updated as well, new libraries will be registered into the workspace and removed libraries will be cleaned up from the workspace.</p>
+</li>
+<li>
+<p>When the N4JS IDE application is started in production mode, the initial state of the preference store is being pre-populated with default values. This is necessary to provide built-in libraries to end users. These default values and additional advanced configurations will be mentioned in more details later in this section.</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p><strong>Library Manager</strong></p>
+<div class="ulist">
+<ul>
+<li>
+<p>This service is responsible for downloading and installing third party <em>npm</em> packages into the <code>node_modules</code> folder of the N4JS IDE. After downloading, the newly-installed and/or updated packages are registered as external libraries into the system.</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p><strong>External Library Builder</strong></p>
+<div class="ulist">
+<ul>
+<li>
+<p>This service is responsible for updating the persistent Xtext index with the currently available external libraries.</p>
+</li>
+<li>
+<p>Unlike in case of any other ordinary projects, this builder does not triggers a build via the <code>org.eclipse.core.internal.events.BuildManager</code> but modifies the persisted Xtext index (<code>IBuilderState</code>) directly.</p>
+</li>
+<li>
+<p>Considers shadowed external libraries when updating the persisted Xtext index.</p>
+</li>
+<li>
+<p>Makes sure that the external library related Xtext index is persistent and will be available on the next application startup.</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p><strong>External Library Xtext Index Persister</strong></p>
+<div class="ulist">
+<ul>
+<li>
+<p>This class is responsible for recovering the consistent external library Xtext index state at application startup.</p>
+</li>
+<li>
+<p>Scheduled on the very first application startup to prepare the Xtext index for the available external libraries.</p>
+</li>
+<li>
+<p>Recovers the Xtext index state after a force quit and/or application crash.</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p><strong>External Library Preference Page</strong></p>
+<div class="ulist">
+<ul>
+<li>
+<p>Preference page to configure and update the state of the <em>External Library Preference Store</em>.</p>
+</li>
+<li>
+<p>Provides a way to install <em>npm</em> dependencies as external libraries into the application.</p>
+</li>
+<li>
+<p>Reloads the external libraries. Gets the most recent state of N4JS type definition files and updates the Xtext index content based on the current state of the external libraries.</p>
+</li>
+<li>
+<p>Exports the current npm dependency configuration as a target platform file. This will be discussed in another section ([sec:Headless_External_Library_Support]).</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p><strong>Miscellaneous UI Features</strong></p>
+<div class="ulist">
+<ul>
+<li>
+<p>Searching for types provided by external libraries.</p>
+</li>
+<li>
+<p>Opening external modules in read-only editor.</p>
+</li>
+<li>
+<p>Navigation between external types.</p>
+</li>
+<li>
+<p><em>Project Explorer</em> contribution for showing external dependencies for ordinary workspace projects.</p>
+</li>
+<li>
+<p>Editor-navigator linking support for external modules.</p>
+</li>
+<li>
+<p>Installing third party npm dependencies directly from package.json editor via a quick fix.</p>
+</li>
+</ul>
+</div>
+</li>
+</ul>
+</div>
+<div class="sect3">
+<h4 id="subsec:External_Resources"><a class="anchor" href="#subsec:External_Resources"></a><a class="link" href="#subsec:External_Resources">17.1.1. External Resources</a></h4>
+<div class="paragraph">
+<p>This approach provides a very pragmatic and simple solution to support external libraries in both in the <code>IN4JSCore</code> and in the <code>IBuilderState</code>. While <code>IN4JSCore</code> supports a completely transparent way of external libraries via the <code>IN4JSProject</code> interface all over in the application, the <code>IBuilderState</code> is responsible for keeping the Xtext index content up to date with the external libraries. Below picture depicts the hierarchy between the ordinary <code>IResource</code> and the <code>IExternalResource</code> instances. As described above each external resource is backed by a <code>java.io.File</code> resource and each access and operation being invoked on the <code>IResource</code> interface will be delegated to this backing resource.</p>
+</div>
+<div id="fig:External_Resources_Hierarchy" class="imageblock center">
+<div class="content">
+<img src="chapters/20_externalLibraries/images/externalResources.svg" alt="externalResources">
+</div>
+<div class="title">Figure 48. External Resources Hierarchy</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="subsec:External_Library_Workspace"><a class="anchor" href="#subsec:External_Library_Workspace"></a><a class="link" href="#subsec:External_Library_Workspace">17.1.2. External Library Workspace</a></h4>
+<div class="paragraph">
+<p>External library workspace is an extension of the <code>InternalN4JSWorkspace</code>. This workspace is used for storing and managing external libraries all over the application. External libraries can be registered into the workspace by providing one to many external library root folder locations. The provided root folder locations will be visited in an ordered fashion and the contained external libraries (N4JS projects) will be registered into the application. If an external library from a root folder has been registered, then a forthcoming occurrence of an external library with the same artefact identifier (and same folder name) will be ignored at all. For instance let assume two external library root locations are available <code>ER1</code> and <code>ER2</code>, also <code>ER1</code> contains <code>P1</code> and <code>P2</code> external libraries, while <code>ER2</code> contains <code>P2</code> and <code>P3</code>. After registering the two roots into the workspace <code>ER1</code> will be processed first, and <code>P1</code> and <code>P2</code> will be registered to the workspace, when processing the forthcoming <code>ER2</code> root, <code>P2</code> will be ignored at all as an external with the same name exists. Finally <code>P3</code> will be registered to the workspace. External libraries cannot be registered directly into the workspace it is done automatically by the <em>External Library Preference Store</em> and by the <em>npm Manager</em>.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="subsec:External_Library_Preference_Store"><a class="anchor" href="#subsec:External_Library_Preference_Store"></a><a class="link" href="#subsec:External_Library_Preference_Store">17.1.3. External Library Preference Store</a></h4>
+<div class="paragraph">
+<p>This persistent cache is used for storing an ordered enumeration of registered external library root folder locations. Whenever its internal state is being persisted after a modification, all registered modification listeners will be synchronously notified about this change. All listeners will receive the store itself with the updated state. There are a couple of registered listeners all over the application listening to store update events but the most important one is the <em>External Library Workspace</em> itself. After receiving an external library preference store update event, the external library workspace will calculate the changes from its own state: creates a sort of difference by identifying added, removed and modified external libraries. Also tracks external library root location order changes. Once the workspace has calculated the changes<sup class="footnote">[<a id="_footnoteref_18" class="footnote" href="#_footnote_18" title="View footnote.">18</a>]</sup> it will interact with the <em>External Library Builder Helper</em> which will eventually update the persisted Xtext index directly through the <code>IBuilderState</code>. After the Xtext index content update all ordinary workspace projects that directly depend either on a built or a cleaned external library will be automatically rebuilt by the external library workspace.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="subsec:npm_Manager"><a class="anchor" href="#subsec:npm_Manager"></a><a class="link" href="#subsec:npm_Manager">17.1.4. Library Manager</a></h4>
+<div class="paragraph">
+<p>This service is responsible for downloading, installing third party npm dependencies into the local file system. This is done directly by <code>npm</code> from <code>Node.js</code>. Once an npm package has been downloaded and installed it will be registered into the external library workspace. As part of the registration, the Xtext index content will be updated and all dependent ordinary workspace projects will be rebuilt automatically. An npm package cannot be installed via the <em>Library Manager</em> if it already installed previously.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="subsec:External_Library_Builder_Helper"><a class="anchor" href="#subsec:External_Library_Builder_Helper"></a><a class="link" href="#subsec:External_Library_Builder_Helper">17.1.5. External Library Builder</a></h4>
+<div class="paragraph">
+<p>This builder is responsible for updating the persisted Xtext index state with external library content directly through the <code>IBuilderState</code>. When providing a subset of external libraries to either build or clean, internally it orders the provided external libraries based on the project dependencies. Also, it might skip building all those external libraries that have are being shadowed by a workspace counterpart. An external library is being shadowed by an ordinary workspace project, if the workspace project is accessible and has exactly the same project name as the external library.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="subsec:External_Library_Xtext_Index_Persister"><a class="anchor" href="#subsec:External_Library_Xtext_Index_Persister"></a><a class="link" href="#subsec:External_Library_Xtext_Index_Persister">17.1.6. External Library Xtext Index Persister</a></h4>
+<div class="paragraph">
+<p>By default Xtext provides a way to fix corrupted index or to recreate it from scratch in case of its absence. Such inconsistent index states could occur due to application crashes or due to non-graceful application shutdowns. Although this default recovery mechanism provided by Xtext works properly, it is provided only for projects that are available in the Eclipse based workspace (<code>org.eclipse.core.resources.IWorkspace</code>) but non of the external libraries are not available from the Eclipse based workspace, so inconsistent external library index content cannot be recovered by this default mechanism. N4JS IDE contributes its own logic to recover index state of external N4JS libraries. When the default Xtext index recovery runs, then it will trigger a external reload as well. This external reload is guaranteed to run always after the default recovery mechanism.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="subsec:External_Library_Preference_Page"><a class="anchor" href="#subsec:External_Library_Preference_Page"></a><a class="link" href="#subsec:External_Library_Preference_Page">17.1.7. External Library Preference Page</a></h4>
+<div class="paragraph">
+<p>This preference page provides a way to configure the external libraries by adding and removing external library root folders, also allows the user to reorder the configured external library root locations. Besides that, npm packages can be installed into the application as external libraries. Neither removing nor reordering built-in external libraries are supported, hence these operations are disabled for built-ins on the preference page. No modifications will take effect unless the changes are persisted with the <code>Apply</code> button. One can reset the configurations to the default state by clicking on the <code>Restore Defaults</code> button then on the <code>Apply</code> button. The <code>Reload</code> button will check whether new type definition files are available for npm dependencies, then reloads the persistent Xtext index content based on the available external libraries. Once the external library reloading has been successfully finished, all dependent workspace projects will be rebuilt as well. From the preference page one can export the installed and used third party npm packages as a target platform. This exported target platform file can be used with the headless compiler. After setting up the headless compiler with this exported target platform file, the headless tool will collect and download all required third party npm dependencies.</p>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:Headless_External_Library_Support"><a class="anchor" href="#sec:Headless_External_Library_Support"></a><a class="link" href="#sec:Headless_External_Library_Support">17.2. Headless External Library Support</a></h3>
+<div class="paragraph">
+<p>The headless compiler is not capable of supporting built-in libraries. The whole build and Xtext index creation infrastructure is different in the IDE and in the headless case. Also, due to its archive nature (<code>n4jsc.jar</code>) of the headless tool, neither the runtime nor the <code>Mangelhaft</code> libraries can be loaded into the headless compiler.</p>
+</div>
+<div class="paragraph">
+<p>The headless compiler supports downloading, installing and using third party <code>npm</code> packages. To enable this feature one has to configure the target platform via the <code>–targetPlatformFile</code> (or simply <code>-tp</code>) and the <code>–targetPlatformInstallLocation</code> (or simply <code>-tl</code>) arguments.</p>
+</div>
+<div class="paragraph">
+<p>If the target platform file argument is configured, then all third party dependencies declared in the target platform file will be downloaded, installed and made available for all the N4JS projects before the compile (and run) phase. If the target platform file is given but the target platform install location is not specified (via the <code>–targetPlatformInstallLocation</code> argument), then a the compilation phase will be aborted and the execution will be interrupted.</p>
+</div>
+<div class="paragraph">
+<p>For more convenient continuous integration and testing purposes there are a couple of additional exception cases with respect to the the target platform file and location that users of the headless compiler have to keep in mind. These are the followings:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>–targetPlatformSkipInstall</code>. Usually dependencies defined in the target platform file will be installed into the folder defined by option <code>–targetPlatformInstallLocation</code>. If this flag is provided, this installation will be skipped, assuming the given folder already contains the required files and everything is up-to-date. Users have to use this flag with care, because no checks will be performed whether the location actually contains all required dependencies.</p>
+</li>
+<li>
+<p>If <code>–targetPlatformSkipInstall</code> is provided the <code>–targetPlatformInstallLocation</code> parameter is completely ignored.</p>
+</li>
+<li>
+<p>If <code>–targetPlatformSkipInstall</code> is provided the <code>–targetPlatformFile</code> parameter is completely ignored.</p>
+</li>
+<li>
+<p>If neither <code>–targetPlatformInstallLocation</code> not <code>–targetPlatformFile</code> parameters are specified the headless tool will treat this case as an implicit <code>–targetPlatformSkipInstall</code> configuration.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>If the target platform install location is configured, and the target platform file is given as well, then all third party dependencies specified in the target platform file will be downloaded to that given location. If the target platform file is given, but the target platform install location is not specified, then a the compilation phase will be aborted and the execution will be interrupted.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-bash" data-lang="bash">java -jar n4jsc.jar -projectlocations /path/to/the/workspace/root -t allprojects -tp /absolute/path/to/the/file -tl /path/to/the/target/platform/install/location -rw nodejs -r moduleToRun</code></pre>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_custom-npm-settings"><a class="anchor" href="#_custom-npm-settings"></a><a class="link" href="#_custom-npm-settings">17.2.1. Custom npm settings</a></h4>
+<div class="paragraph">
+<p>In some cases there is a need for custom npm settings, e.g. custom npm registry. Those kind of configurations are
+supported via <code>.npmrc</code> file (see <a href="https://docs.npmjs.com/files/npmrc" class="bare">https://docs.npmjs.com/files/npmrc</a>).</p>
+</div>
+<div class="paragraph">
+<p>In N4JSIDE user can specify path to his custom configuration file in the preference page.</p>
+</div>
+<div class="paragraph">
+<p>For the commandline N4JSC.jar provides special option <code>-npmrcRootLocation</code> that allows headless compiler to
+use custom settings.</p>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="sec:lmFutureWork"><a class="anchor" href="#sec:lmFutureWork"></a><a class="link" href="#sec:lmFutureWork">17.3. Future Work</a></h3>
+<div class="paragraph">
+<p>Some aspects not covered in current design, but worth consideration in the future</p>
+</div>
+<div class="sect3">
+<h4 id="subsec:lmMultipleDependencyScope"><a class="anchor" href="#subsec:lmMultipleDependencyScope"></a><a class="link" href="#subsec:lmMultipleDependencyScope">17.3.1. Multiple Dependency Scope</a></h4>
+<div class="paragraph">
+<p>npm scope dependencies</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><strong>DEPENDENCY_DEVELOPMENT</strong> </dt>
+<dd>
+<p><a href="https://docs.npmjs.com/files/package.json#devdependencies" class="bare">https://docs.npmjs.com/files/package.json#devdependencies</a></p>
+</dd>
+<dt class="hdlist1"><strong>DEPENDENCY_PEER</strong> </dt>
+<dd>
+<p><a href="https://docs.npmjs.com/files/package.json#peerdependencies" class="bare">https://docs.npmjs.com/files/package.json#peerdependencies</a></p>
+</dd>
+<dt class="hdlist1"><strong>DEPENDENCY_BUNDLE</strong> </dt>
+<dd>
+<p><a href="https://docs.npmjs.com/files/package.json#bundleddependencies" class="bare">https://docs.npmjs.com/files/package.json#bundleddependencies</a></p>
+</dd>
+<dt class="hdlist1"><strong>DEPENDENCY_OPTIONAL</strong> </dt>
+<dd>
+<p><a href="https://docs.npmjs.com/files/package.json#optionaldependencies" class="bare">https://docs.npmjs.com/files/package.json#optionaldependencies</a></p>
+</dd>
+<dt class="hdlist1"><strong>DEPENDENCY_PROVIDES</strong> </dt>
+<dd>
+<p><a href="http://www.rpm.org/wiki/PackagerDocs/Dependencies#Provides" class="bare">http://www.rpm.org/wiki/PackagerDocs/Dependencies#Provides</a></p>
+</dd>
+<dt class="hdlist1"><strong>DEPENDENCY_WEAK</strong> </dt>
+<dd>
+<p><a href="http://www.rpm.org/wiki/PackagerDocs/Dependencies#Weakdependencies" class="bare">http://www.rpm.org/wiki/PackagerDocs/Dependencies#Weakdependencies</a></p>
+</dd>
+</dl>
+</div>
+</div>
+<div class="sect3">
+<h4 id="subsec:lmRunTestsFromLibrary"><a class="anchor" href="#subsec:lmRunTestsFromLibrary"></a><a class="link" href="#subsec:lmRunTestsFromLibrary">17.3.2. Run Tests from TestLibrary</a></h4>
+<div class="paragraph">
+<p>Imagine we are implementing some API, and we want to run tests for that API. Tests are delivered to us as separate package, and there is not direct association between implementation and test projects (tests are not depending on implementation). Still we want to run provided tests to see if our implementation complies with API tests, e.g. AcceptanceTest suite for Application written against application sdk.</p>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="sec:JSON_Support"><a class="anchor" href="#sec:JSON_Support"></a><a class="link" href="#sec:JSON_Support">18. JSON Support</a></h2>
+<div class="sectionbody">
+<div class="admonitionblock warning">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-warning" title=""></i>
+</td>
+<td class="content">
+This chapter may be outdated.
+</td>
+</tr>
+</table>
+</div>
+<div class="sect2">
+<h3 id="sec:JSON_Parser"><a class="anchor" href="#sec:JSON_Parser"></a><a class="link" href="#sec:JSON_Parser">18.1. JSON Parser</a></h3>
+<div class="paragraph">
+<p>For the JavaScript Object Notation format, a multitude of specifications exist (e.g. [<a href="#RFC8259">RFC8259</a>], [<a href="#ECMA404">ECMA404</a>], [<a href="#RFC7158">RFC7158</a>]). While all specifications agree on the basic structure of JSON, many special cases exist, which remain un-addressed by the specifications. Therefore, in practice many parsers exhibit implementation-specific behavior. See [<a href="#Ser18">Ser18</a>] for a discussion of many of these cases.</p>
+</div>
+<div class="paragraph">
+<p>The initial grammar of the N4JS JSON parser is mostly based on [<a href="#ECMA404">ECMA404</a>] while further adaptions have been made to accommodate for special cases such as escaping unicode control characters in string literals. This section discusses the different aspect in which our parser exhibits special behavior in order to parse a maximum of real-world JSON text. If applicable, we will also discuss differences between JSON and the N4JS syntax for object literals.</p>
+</div>
+<div class="sect3">
+<h4 id="sec:JSON_Parser_Unicode_Escaping"><a class="anchor" href="#sec:JSON_Parser_Unicode_Escaping"></a><a class="link" href="#sec:JSON_Parser_Unicode_Escaping">18.1.1. Escaping Unicode Control Characters in String Literals</a></h4>
+<div class="paragraph">
+<p>In comparison to ECMAScript (and thus N4JS), JSON only requires the escaping of unicode control characters in the range from <code>U+0000</code> to <code>U+001F</code> when used in a string literal. This includes the line termination characters <code>U+000A</code> or <code>\n</code> and <code>U+000D</code> or <code>\r</code>. However, different from ECMAScript, JSON allows the unescaped use of the unicode characters <code>U+2028</code> and <code>U+2029</code> within string literals. Therefore, the JSON parser differs from the behavior of the N4JS parser.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:JSON_Parser_Empty_Text"><a class="anchor" href="#sec:JSON_Parser_Empty_Text"></a><a class="link" href="#sec:JSON_Parser_Empty_Text">18.1.2. Empty Text</a></h4>
+<div class="paragraph">
+<p>While the abovementioned JSON specifications do not allow for empty JSON text (e.g. no data, only whitespace data), our parser is tolerant towards such inputs. The reason behind this decision is that it allows users of the N4JS IDE, to create new empty JSON files without experiencing any parser errors.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:JSON_Parser_Nested_Structures"><a class="anchor" href="#sec:JSON_Parser_Nested_Structures"></a><a class="link" href="#sec:JSON_Parser_Nested_Structures">18.1.3. Nested Structures</a></h4>
+<div class="paragraph">
+<p>Since the N4JS JSON parser is implemented in terms of a recursive decent parser, the parsable inputs are limited in terms of nesting. This results in a stack overflow exception for highly nested input data.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:JSON_Parser_Whitespace"><a class="anchor" href="#sec:JSON_Parser_Whitespace"></a><a class="link" href="#sec:JSON_Parser_Whitespace">18.1.4. Whitespace</a></h4>
+<div class="paragraph">
+<p>[<a href="#RFC7158">RFC7158</a>] and [<a href="#ECMA404">ECMA404</a>] both define whitespace characters of JSON to be exclusively <code>U+0009</code>, <code>U+000A</code>, <code>U+000D</code> and <code>U+0020</code>. However, for now we adopt the whitespace strategy of the N4JS parser, which allows for additional whitespace characters (also see [<a href="#ECMA15a">ECMA15a</a>] section 7.2 White Space). This only applies to JSON text outside of string literals.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:JSON_Parser_Comments"><a class="anchor" href="#sec:JSON_Parser_Comments"></a><a class="link" href="#sec:JSON_Parser_Comments">18.1.5. Comments</a></h4>
+<div class="paragraph">
+<p>Although JSON as a standard does not specify any notion of source code comments, we allow them on a parser level. (single line comments introduced by <code>//</code> and multi-line comments using <code>/*</code> and <code>*/</code>). After parsing, we issue corresponding validation messages that indicate to the user, that such comments will possibly not be parsable in a different context (e.g. by npm in case of package.json files).</p>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="sec:JSON_Language_Extensions"><a class="anchor" href="#sec:JSON_Language_Extensions"></a><a class="link" href="#sec:JSON_Language_Extensions">18.2. JSON Language Extensions</a></h3>
+<div class="paragraph">
+<p>Generally, our JSON support was implemented with generic JSON support in mind. However, for some types of JSON files (e.g. <code>package.json</code> files) we provide custom behavior to better assist the user. This includes custom JSON validators and resource description strategies that only apply to certain types of JSON files. In order to keep our JSON implementation independent from N4JS-specific code, these concerns are separated using an Eclipse Extension Point. In the headless case, extension also need to be registered manually via the <code>JSONExtensionRegistry</code>. In the following we present the different aspect in which the JSON language can be extended.</p>
+</div>
+<div class="sect3">
+<h4 id="sec:JSON_Validator_Extensions"><a class="anchor" href="#sec:JSON_Validator_Extensions"></a><a class="link" href="#sec:JSON_Validator_Extensions">18.2.1. JSON Validator Extensions</a></h4>
+<div class="paragraph">
+<p>Via the JSON validator extensions (cf. <code>IJSONValidatorExtension</code>), other bundles can register JSON validator extensions that introduce domain-specific validation for specific types of JSON files.</p>
+</div>
+<div class="sect4">
+<h5 id="sec:File_Specitic_Validator_Extensions"><a class="anchor" href="#sec:File_Specitic_Validator_Extensions"></a><a class="link" href="#sec:File_Specitic_Validator_Extensions">18.2.1.1. File-Specific Validator Extensions</a></h5>
+<div class="paragraph">
+<p>For every JSON resource that is validated, all registered JSON validator extensions are executed. For a validator extension to be specific to a certain type of file, one may override the Xtext method <code>isResponsible</code> which checks whether a validator applies on a per resource basis.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:JSON_Declarative_JSON_Validator_Extensions"><a class="anchor" href="#sec:JSON_Declarative_JSON_Validator_Extensions"></a><a class="link" href="#sec:JSON_Declarative_JSON_Validator_Extensions">18.2.1.2. Declarative JSON Validator Extensions</a></h5>
+<div class="paragraph">
+<p>In addition to Xtext&#8217;s <code>@Check</code> methods, we provide an annotation <code>@CheckProperty</code> that allows to declare JSON-specific check methods that only apply to certain property paths of a JSON document. The <code>@CheckProperty</code> annotation can only be used when inheriting from the <code>AbstractJSONValidatorExtension</code> class. The following example outlines its usage:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-java" data-lang="java">(...)
+@CheckProperty(propertyPath = "prop1")
+public void checkProperty(JSONValue propertyValue) {
+	// validate JSONValue for top-level property 'prop1'
+}
+
+@CheckProperty(propertyPath = "nested.prop2")
+public void checkNestedProperty(JSONValue propertyValue) {
+	// validate JSONValue for the nested property 'nested.prop2'
+}
+(...)</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>The examples illustrates how property-check-method can be declared. In a JSON document the first check method will only be invoked for the JSON value that is set for top-level property <code>prop1</code>. The second check method is invoked for the nested property <code>prop2</code> of the object that is set for the top-level property <code>prop2</code>.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-json" data-lang="json">{
+	"prop1": 1, // checkProperty applies
+	"nested": {
+		"prop2": 2 // checkNestedProperty applies
+	}
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>When inheriting from the <code>AbstractJSONValidatorExtension</code>, the usual <code>addIssue</code> methods may be used in order to issue validation messages. Furthermore, the issue codes that are  being used for the messages may originate from the bundle that hosts the validator extension.</p>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_json-resource-description-strategy"><a class="anchor" href="#_json-resource-description-strategy"></a><a class="link" href="#_json-resource-description-strategy">18.2.2. JSON Resource Description Strategy</a></h4>
+<div class="paragraph">
+<p>Via JSON resource description extensions (cf. <code>IJSONResourceDescriptionExtension</code>), other bundles can define a custom resource description strategy for specific types of JSON files. As a consequence, these extensions define what information on the contents of a JSON file is stored in the Xtext index (cf. <code>IResourceDescriptions</code>).</p>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_jsdoc"><a class="anchor" href="#_jsdoc"></a><a class="link" href="#_jsdoc">19. JSDoc</a></h2>
+<div class="sectionbody">
+<div class="admonitionblock warning">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-warning" title=""></i>
+</td>
+<td class="content">
+This chapter may be outdated.
+</td>
+</tr>
+</table>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:Design_Rationale"><a class="anchor" href="#sec:Design_Rationale"></a><a class="link" href="#sec:Design_Rationale">19.1. Design Rationale</a></h3>
+<div class="paragraph">
+<p>JSDoc parser provides general API for parsing and obtaining information embedded in comments. This may have low significance for N4JS itself but is essential when working with JS dialects (e.g. vanilla JS) that use JSDoc comments for enrich given dialect with semantic information. Anticipated uses may include: - type information extraction when importing external code - validation of links between commented fragments - supporting markup for documentation</p>
+</div>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title=""></i>
+</td>
+<td class="content">
+Although current focus is on migration process we want to provide general solution that can be customized for given use cases
+</td>
+</tr>
+</table>
+</div>
+<div class="sect3">
+<h4 id="_general-design"><a class="anchor" href="#_general-design"></a><a class="link" href="#_general-design">19.1.1. General Design</a></h4>
+<div class="paragraph">
+<p>When using the API client has to create instance of DocletParser and configure it with <em>LienTag</em>s and <em>InLineTag</em>s that are to be used.</p>
+</div>
+<div class="paragraph">
+<p>LineTags can depend on InlineTags (e.g. InlineTg in description of parameters of the LineTag). API provides support for that but client has to configure this.</p>
+</div>
+<div id="fig:cd_JSDocParserAPI" class="imageblock center">
+<div class="content">
+<img src="chapters/23_jsdoc/images/cd_JSDocParserAPI.svg" alt="cd JSDocParserAPI">
+</div>
+<div class="title">Figure 49. JSDoc Parser API (without model)</div>
+</div>
+<div class="paragraph">
+<p>Initiated DocletParser can be used to parse <em>String</em> containing given JSDoc comment.Based on provided <em>ITagDefinition</em>s parser will parse input string and return JSDoc DOM AST (see fig. XX with ecore diagram). By querying tree structure client can obtain information extracted form parsed input String.</p>
+</div>
+<div id="fig:cd_JSDocModel" class="imageblock center">
+<div class="content">
+<img src="chapters/23_jsdoc/images/cd_JSDocModel.svg" alt="cd JSDocModel">
+</div>
+<div class="title">Figure 50. JSDoc AST/DOM Model</div>
+</div>
+<div class="paragraph">
+<p>The root of the this AST is the Doclet. The doclet itself contains some content (as it is a Composite containing ContentNodes), usually Description and an arbitrary number of LineTags. LineTags are created by custom ITagDefinition implementations that extend AbstractLineTagDefinition. They contain the title and an arbitrary number of values, stored in a map. These values are Composite nodes as well, containing tag specific content. E.g., the parameter tag will create the values for the parameter type, the parameter name, and the description. Description (in LineTags as well as in doclet itself) is free text with optional InlineTags. InlineTags are created by custom ITagDefinition that extends AbstractInlineTagDefinition. In general tag values are designed as a comprise between a very general tree (basically containing only text nodes) and a structured typed tree (containing type expressions etc.). Although it should be possible to model a tag value by only using Text nodes, some special typed nodes are provided for sake of simplicity (and probably performance). E.g., TypeReferences are modeled using a typed node, in order to simplify external handling of these references (for type analysis, and refactorings such as renaming a type). New typed nodes will probably be introduced (see below). Markers can be attached to nodes for internal purposes. E.g., a marker can be used to distinguish different syntax versions of defining an array (<code>String[]</code> vs. <code>Array&lt;String&gt;</code>).Literals can be used to simplify rewriting. That is, they can contain information on line breaks, JSDoc line prefixes etc., which are not needed for the semantics of a tag, but only for the syntax (not used yet). Also, each node contains a position for simplifying rewriting.</p>
+</div>
+<div id="fig:cd_JSDocParserAndModel" class="imageblock center">
+<div class="content">
+<img src="chapters/23_jsdoc/images/cd_JSDocParserAndModel.svg" alt="cd JSDocParserAndModel">
+</div>
+<div class="title">Figure 51. JSDoc Parser and Model</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Type_Expressions"><a class="anchor" href="#sec:Type_Expressions"></a><a class="link" href="#sec:Type_Expressions">19.1.2. Type Expressions</a></h4>
+<div class="paragraph">
+<p>Type expressions are are not handled by JSDoc Parser by itself as instances of the grammars are use case specific, e.g. for migration purposes grammar for type expressions used in migration process is specific to the in question therefore specific type expressions parser will be provided separately.DocLetParser by default can only extract String representing given type expression, parsing and interpreting it stays in responsibility of given tag implementation provided by the client.</p>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_docexporter"><a class="anchor" href="#_docexporter"></a><a class="link" href="#_docexporter">20. DocExporter</a></h2>
+<div class="sectionbody">
+<div class="admonitionblock warning">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-warning" title=""></i>
+</td>
+<td class="content">
+This chapter may be outdated.
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>The DocExporter exports JavaDoc from source files to adoc files.
+In particular it combines information about methods with tests in order to create specification documents.</p>
+</div>
+<div class="sect2">
+<h3 id="sec:Specification_Exporter"><a class="anchor" href="#sec:Specification_Exporter"></a><a class="link" href="#sec:Specification_Exporter">20.1. Specification Exporter</a></h3>
+<div class="paragraph">
+<p>The specification exporter creates and merges artifacts.
+<a href="#fig:api_test_spec">Fig. API Test Spec</a> sketches the relation between API (i.e., n4jsd files with classifiers),
+tests (i.e., N4JS test classes and methods), and specification (Documentation with JSDOC markers).</p>
+</div>
+<div id="fig:api_test_spec" class="imageblock center">
+<div class="content">
+<img src="chapters/24_docexporter/images/api_test_spec.svg" alt="api test spec">
+</div>
+<div class="title">Figure 52. Component/Class pseudo diagram: Relation API, Tests and Specification</div>
+</div>
+<div class="paragraph">
+<p><a href="#fig:cd_jsdocreader">Fig. Exporter</a> shows the classes that read and analyze Java source documentation.</p>
+</div>
+<div id="fig:cd_jsdocreader" class="imageblock center">
+<div class="content">
+<img src="chapters/24_docexporter/images/cd_jsdocreader.svg" alt="cd jsdocreader">
+</div>
+<div class="title">Figure 53. Java reader classes</div>
+</div>
+<div class="paragraph">
+<p><a href="#fig:cd_adocexporter">Fig. Exporter</a> shows the content classes of the exporter that contain the generated documentation contents.</p>
+</div>
+<div id="fig:cd_adocexporter" class="imageblock center">
+<div class="content">
+<img src="chapters/24_docexporter/images/cd_adocexporter.svg" alt="cd adocexporter">
+</div>
+<div class="title">Figure 54. Exporter content classes</div>
+</div>
+<div class="paragraph">
+<p><a href="#fig:cd_docexporter_model">Fig. DocExporter Model</a> shows the model, which may be used for other doc exporters as well.</p>
+</div>
+<div id="fig:cd_docexporter_model" class="imageblock center">
+<div class="content">
+<img src="chapters/24_docexporter/images/cd_docexporter_model.svg" alt="cd docexporter model">
+</div>
+<div class="title">Figure 55. Exporter model classes</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_rename-refactoring"><a class="anchor" href="#_rename-refactoring"></a><a class="link" href="#_rename-refactoring">21. Rename Refactoring</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>The rename refactoring operation is implemented based on current Xtext&#8217;s rename refactoring implementation. However, lots of customization have been done in order to make Rename Refactoring work for N4JS. In order to understand N4JS customization, it is imperative to understand how Xtext implements rename refactoring. In this chapter, we will focus on Xtext&#8217;s architecture for rename refactoring. Additionally, we will point to the components that have been customized for N4JS.</p>
+</div>
+<div class="sect2">
+<h3 id="_rename-refactoring-ui-interaction"><a class="anchor" href="#_rename-refactoring-ui-interaction"></a><a class="link" href="#_rename-refactoring-ui-interaction">21.1. Rename Refactoring UI interaction</a></h3>
+<div class="paragraph">
+<p>Xtext&#8217;s implementation allows rename refactoring be in either one of two modes (1) Direct refactoring mode (3) Refactoring with dialog mode. Diagram <a href="#fig:rename_refactoring_communication_diagram_part1">Direct Rename Refactoring UI interaction</a> shows the UI interaction in <em>direct refactoring mode</em>.</p>
+</div>
+<div id="fig:rename_refactoring_communication_diagram_part1" class="imageblock center">
+<div class="content">
+<img src="chapters/25_renameRefactoring/images/rename_refactoring_communication_diagram_part1.svg" alt="title-"Direct Rename Refactoring UI interaction"">
+</div>
+</div>
+<div class="paragraph">
+<p>In this diagram, the classes in yellow are customized by N4JS implementation to handle N4JS-specific characteristics.</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>DefaultRenameElementHandler</code>: Our custom N4JS implementation converts the selected element to be renamed into its corresponding TModule element.</p>
+</li>
+<li>
+<p><code>ILinkedPositionGroupCalculator</code>: This class is responsible for calculating locations of names to be changed during linked edit mode. We need to provide a custom N4JS implementation to handle composed elements.</p>
+</li>
+<li>
+<p><code>RenameElementProcessor</code>: We need to provide a custom N4JS implementation to add N4JS-specific validation of conditions, e.g. checking name conflicts etc.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>The key class for creating updates of a declaration and its associated references is <code>RenameElementProcessor</code>. In the following section, we will see how this class interacts with other classes to achieve this.</p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_renameelementprocessor-interaction"><a class="anchor" href="#_renameelementprocessor-interaction"></a><a class="link" href="#_renameelementprocessor-interaction">21.2. RenameElementProcessor interaction</a></h3>
+<div class="paragraph">
+<p>Diagram <a href="#fig:rename_refactoring_communication_diagram_part2">RenameElementProcessor interaction</a> shows the interaction of <code>RenameElementProcessor</code> and other classes to create changes for both declaration and references during rename refactoring.</p>
+</div>
+<div id="fig:rename_refactoring_communication_diagram_part2" class="imageblock center">
+<div class="content">
+<img src="chapters/25_renameRefactoring/images/rename_refactoring_communication_diagram_part2.svg" alt="title-"RenameElementProcessor interaction"">
+</div>
+</div>
+<div class="paragraph">
+<p>As seen in the diagram, there are two stages of creating updates:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Creating updates for declaration is done by <code>IRenameStrategy</code> and</p>
+</li>
+<li>
+<p>Creating updates for references is done by <code>ReferenceUpdateDispatcher</code>. <code>ReferenceUpdateDispatcher</code> in turn delegates the finding of references to <code>IReferenceFinder</code>.</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>The text edits for changing the definition and the references are accumulated by an <code>IRefactoringUpdateAcceptor</code>.</p>
+</div>
+<div class="paragraph">
+<p>The classes in yellow are customized by N4JS implementation.</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>IRenameStrategy</code>: the custom N4JS implementation creates updates for constituent members of composed elements.</p>
+</li>
+<li>
+<p><code>IReferenceFinder</code>: the custom N4JS implementation used for finding references of a declaration.</p>
+</li>
+<li>
+<p><code>RefactoringCrossReferenceSerializer</code>: custom N4JS implementation to retrieve the updated name for cross references. For some unknown reason, the default implementation does not work correctly.</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="chap:flowgraphs"><a class="anchor" href="#chap:flowgraphs"></a><a class="link" href="#chap:flowgraphs">22. Flow Graphs</a></h2>
+<div class="sectionbody">
+<div class="sect2 language-n4js">
+<h3 id="sec:flowgraphs_overview"><a class="anchor" href="#sec:flowgraphs_overview"></a><a class="link" href="#sec:flowgraphs_overview">22.1. Flow graphs overview</a></h3>
+<div class="paragraph">
+<p>In this chapter, the control and data flow analyses are introduced.
+Since not all AST elements are relevant for the control or data flow analyses, a new marker class is introduced called <code>ControlFlowElement</code>.
+All AST elements which are part of the control flow graph implement this class.
+The term control flow is abbreviated as <em>CF</em> and hence <code>ControlFlowElement</code>s are abbreviated as <em>CF elements</em>.</p>
+</div>
+<div class="paragraph">
+<p></p>
+</div>
+<div class="sidebarblock">
+<div class="content">
+<a href="https://github.com/eclipse/n4js/issues/120" class="gray" title="GitHub Issues"><span class="image"><img src="images/issue.svg" alt=""></span> #120</a>
+</div>
+</div>
+<div class="paragraph">
+<p>The following picture shows the control flow graph of the function <code>f</code>.</p>
+</div>
+<div class="imageblock">
+<div class="content">
+<img src="chapters/30_flowgraphs/images/cfg_for_loop.png" alt="cfg for loop">
+</div>
+<div class="title">Figure 56. Control flow graph of a simple function</div>
+</div>
+<div class="sect3">
+<h4 id="_internal-graph"><a class="anchor" href="#_internal-graph"></a><a class="link" href="#_internal-graph">22.1.1. Internal graph</a></h4>
+<div class="paragraph">
+<p>Every <em>internal graph</em> refers to a single <em>control flow container</em>.
+The graph consists of <em>nodes</em> and <em>edges</em>, where the edges are instances of <code>ControlFlowEdge</code>, and nodes are instances of <code>Node</code>.
+Additionally, a so called <em>complex node</em> is used to group nodes that belong to the same CF element.</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Internal graph</dt>
+<dd>
+<p>Control flow graphs are created based on the AST elements.
+Nevertheless, a fine-grained abstraction is used that is called <em>internal graph</em>.
+The internal graph reflects all control flows and data effects that happen implicitly and are part of the language&#8217;s semantics.
+For instance, the for-of statement on iterable objects forks the control flow after invoking the <code>next()</code> method.
+This is done implicitly and not part of the written source code.
+Moreover, this invocation could cause side effects.
+These control flows and effects are reflected using the internal graph.
+To implement analyses that refer to AST elements, an API for flow analyses is provided which hides the internal graph and works with AST elements only.
+In the following, the term <em>control flow graph</em> refers to the internal graph.</p>
+</dd>
+<dt class="hdlist1">Control flow container</dt>
+<dd>
+<p>At several places in the AST, an execution of statements or elements can happen.
+Obviously, statements can be executed in bodies of methods or function expressions.
+In addition, execution can also happen in field initializers or the <code>Script</code> itself.
+Since all these AST elements can contain executable control flow elements (CF elements), they thus contain a control flow graph.
+In the following, these AST elements are called <em>control flow containers</em> or CF containers.</p>
+</dd>
+<dt class="hdlist1">Nodes</dt>
+<dd>
+<p>Nodes represent complete CF elements or parts of them.
+For instance, simple CF elements like a <code>break</code> statement are represented using only one node.
+Regarding more complex CF elements that introduce a more complex control flow, due to e.g. nested expressions, several nodes represent one CF element.
+All nodes of a single CF element are grouped within a complex node.</p>
+</dd>
+<dt class="hdlist1">Edges</dt>
+<dd>
+<p>Edges reference a start and an end node which reflects a forward control flow direction, which is in the following called forward traverse direction.
+Traversing from end to start of an edge is thus called backward traverse direction.
+The so called <em>next node</em> is either the end node in context of forward, or the start node in context of backward traverse direction.
+Edges also reflect the reason of the control flow using a control flow type.
+The default control flow type is called <code>Successor</code> and such edges connect two ordinary subsequent nodes.
+Other types like <code>Return</code> or <code>Break</code> indicate control flow that happens due to return or break statements.
+A special control flow type is <code>Repeat</code> that indicates the entry of a loop body.
+This edge is treated specially when traversing the control flow graph to avoid infinitive traversals of loops.</p>
+</dd>
+<dt class="hdlist1">Complex node</dt>
+<dd>
+<p>The complex node always has a single entry and exit node, no matter the control flow it causes.
+For instance, although the for-statement can contain various control flows among its nested CF elements, its complex node still has a single entry and exit node.
+This simplifies concatenating subsequent complex nodes, since only their exit nodes have to be connected to the following entry node.
+Aside from exit and entry node, a complex node usually contains additionally nodes to represent the CF element.
+These nodes are connected by control flow edge so that their control flow lies within complex node.
+However, regarding nested CF elements, the control flow leaves and re-enters a complex node.
+To specify which CF element is nested, a delegating node (<code>DelegatingNode</code>) is created that points to the nested CF element.</p>
+</dd>
+</dl>
+</div>
+<div class="paragraph">
+<p>Consider that source code elements can be nested like expressions that have sub-expressions as in <code>1 + 2 * 3</code>.
+Also statements can contain other statements like in <code>if (true) return;</code>.
+The design of the control flow graph deals with this nesting by mapping CF elements to several nodes.
+All nodes of one CF element are aggregated into the <em>complex node</em>.</p>
+</div>
+<div id="img:internalGraph" class="imageblock">
+<div class="content">
+<img src="chapters/30_flowgraphs/images/internalGraph.png" alt="internalGraph">
+</div>
+<div class="title">Figure 57. The source code of <code>1+2</code> creates an internal graph of three complex nodes to deal with nested integer literals</div>
+</div>
+<div class="paragraph">
+<p>The example in the <a href="#img:internalGraph">figure above</a> shows the internal graph produced by the source code <code>1+2</code>.
+Additionally, a simpler version of the internal graph is shown (called <em>User Graph View</em>), with which client analyses deal.
+The user graph view is only a view on the internal graph, but does not exist as an own instance.
+In the figure, the nesting of the integer literals becomes obvious:
+The control flow edges of delegating nodes targets entry nodes of different CF elements.
+Also, there are CF edges from the exit nodes of these nested CF elements to return the control flow.</p>
+</div>
+<div id="img:cn_for_stmt" class="imageblock">
+<div class="content">
+<img src="chapters/30_flowgraphs/images/cn_for_stmt.png" alt="cn for stmt">
+</div>
+<div class="title">Figure 58. Complex Node of for statement</div>
+</div>
+<div class="paragraph">
+<p>In the <a href="#img:cn_for_stmt">above figure</a>, the complex node of the for statement is shown.
+The details of the complex nodes of the nested CF elements (such as the initializer or the body statement) are omitted.
+The figure displays the control flow fork after the condition and also shows the <em>Repeat</em> edge that targets the for body.
+The node called <em>Catch Node</em> is used in situations when there are jumping control flows introduced for instance by a continue statement.
+The catch will will then be the target of an control flow edge that starts at the continue statement.</p>
+</div>
+<div class="paragraph">
+<p>The graph of nodes and edges is constructed in the following order.</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>First, for every CF element a complex node and all its nodes are created.
+Also, the nodes within the complex node are connected according to their control flow behavior.</p>
+</li>
+<li>
+<p>Second, all subsequent complex nodes are connected by connecting their exit and entry nodes.
+Moreover, nested complex nodes are connected by interpreting the delegating nodes.</p>
+</li>
+<li>
+<p>Third, jumping control due to <code>return</code>, <code>throw</code>, <code>break</code> or <code>continue</code> statements is computed.
+This is done by first deleting the successor edge of the jumping statement and introducing a new control flow edge that ends at the jump target.</p>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_optimizations"><a class="anchor" href="#_optimizations"></a><a class="link" href="#_optimizations">22.1.2. Optimizations</a></h4>
+<div class="paragraph">
+<p>The internal graph contains many nodes to simplify the graph construction.
+However, these nodes carry no relevant information when traversing the graph.
+Consequently, in an optimization step, they are removed from the graph for performance reasons.</p>
+</div>
+<div class="paragraph">
+<p>A node removal for a node <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>n</mi><mn>2</mn></msub></math> is done by replacing the path <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>n</mi><mn>1</mn></msub><mo>-</mo><mo>&gt;</mo><msub><mi>n</mi><mn>2</mn></msub><mo>-</mo><mo>&gt;</mo><msub><mi>n</mi><mn>3</mn></msub></math> by the new path <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>n</mi><mn>1</mn></msub><mo>-</mo><mo>&gt;</mo><msub><mi>n</mi><mn>3</mn></msub></math>.
+These removals are done for delegating nodes that only have one incoming and one outgoing edge.</p>
+</div>
+<div class="paragraph">
+<p>A second kind but similar optimization reduces the number of helper nodes that are used as entry nodes.
+In case a complex nodes consists only of exactly one entry and one exit node, both of these nodes are collapsed into one node.
+This remaining node then is the representing node of the AST element.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_api-for-client-analyses"><a class="anchor" href="#_api-for-client-analyses"></a><a class="link" href="#_api-for-client-analyses">22.1.3. API for client analyses</a></h4>
+<div class="paragraph">
+<p>To implement client analyses based on the control flow graph, the three classes <code>GraphVisitor</code>, <code>GraphExplorer</code> and <code>BranchWalker</code> are provided.
+They provide the means to visit CF elements in a control flow graph and also to traverse single control flow paths.
+The method <code>N4JSFlowAnalyses#analyze</code> can execute several client analyses in one run to maintain scalability.</p>
+</div>
+<div class="sect4">
+<h5 id="_mapping-from-internal-to-ast-elements"><a class="anchor" href="#_mapping-from-internal-to-ast-elements"></a><a class="link" href="#_mapping-from-internal-to-ast-elements">22.1.3.1. Mapping from internal to AST elements</a></h5>
+<div class="paragraph">
+<p>The API classes work with AST elements such as <code>ControlFlowElement</code> instead of the internally used graph classes <code>ComplexNode</code>, <code>Node</code> or <code>ControlFlowEdge</code>.
+The mapping from internal classes to AST elements is done in the <code>GraphVisitor</code> class.</p>
+</div>
+<div class="paragraph">
+<p>Note that the control flow graph has the following properties:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>ExpressionStatement</code>s are not represented.
+Instead, only their expressions are represented.
+Nevertheless, the API can deal with calls that refer to expression statements, e.g. when requesting their successors.</p>
+</li>
+<li>
+<p>Control statements are also not represented in the graph, but can also be used in calls to the API.
+The reason is, that it is unclear when a control statement (e.g. a for loop) is visited exactly.</p>
+</li>
+<li>
+<p>Since a <code>FlowEdge</code> which connects two <code>ControlFlowElement</code>s can represent multiple internal edges, it can have multiple <code>ControlFlowType</code>s.</p>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_graph-visitor"><a class="anchor" href="#_graph-visitor"></a><a class="link" href="#_graph-visitor">22.1.3.2. Graph visitor</a></h5>
+<div class="paragraph">
+<p>Graph visitors traverse the control flow graphs of every CF container of a script instance in the following two traverse directions:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><em>Forward</em>: from the container&#8217;s start to all reachable CF graph elements.</p>
+</li>
+<li>
+<p><em>Backward</em>: from the container&#8217;s end to all reachable CF graph elements.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>In each traverse direction, the graph visitor visits every reachable CF element and edge.
+Note that neither empty statements nor control statements are part of the control flow graph.
+The order of visited CF elements is related to either a breadth or a depth search on the CF graph.
+However, no specific order assumptions are guaranteed.</p>
+</div>
+<div class="imageblock">
+<div class="content">
+<img src="chapters/30_flowgraphs/images/deadcode.png" alt="deadcode">
+</div>
+<div class="title">Figure 59. The CF elements <code>"loop"</code> and <code>"end"</code> are dead code and displayed in grey.</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_graph-explorer"><a class="anchor" href="#_graph-explorer"></a><a class="link" href="#_graph-explorer">22.1.3.3. Graph explorer</a></h5>
+<div class="paragraph">
+<p>Graph visitors can request a <em>graph explorer</em> to be activated under specific conditions related to the client analysis.
+A graph explorer is the start point to analyze control flow branches.
+The first control flow branches is started directly at the graph explorer&#8217;s creation site, but of course this first branches might fork eventually.
+The graph explorer keeps track of all forked branches that originate at its activation site.
+It also provides the means to join previously forked branches again.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_branch-walker"><a class="anchor" href="#_branch-walker"></a><a class="link" href="#_branch-walker">22.1.3.4. Branch walker</a></h5>
+<div class="paragraph">
+<p>With every graph explorer, a branch walker is created that traverses the control flow graph beginning from the activation site of the graph explorer.
+On every such branch, the two visit methods of CF elements and edges respectively, are called in the order of the traverse direction.
+Every time the branch forks, the fork method of the branch walker is invoked and creates another branch walker which will continue the traversal on the forked branch.
+The fork method can be used to copy some path data or state to the newly forked branch walker.
+Note that every edge is always followed by the branch walker except for repeat edges which are followed exactly twice.
+The reason to follow them twice is that first, following them only once would hide those control flows that re-visit the same CF elements due to the loop.
+Second, following them more than twice does not reveal more insights, but only increases the number of branches.
+When control flow branches merge again, for instance at the end of an <code>if</code>-statement, two or more branch walkers are merged into a new succeeding one.
+The graph explorer provides the means to do this.
+In case a CF element has no next elements, the branch walker terminates.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_example-1-compute-string-for-each-path"><a class="anchor" href="#_example-1-compute-string-for-each-path"></a><a class="link" href="#_example-1-compute-string-for-each-path">22.1.3.5. Example 1: Compute string for each path</a></h5>
+<div class="paragraph">
+<p>Let&#8217;s assume that we want to compute all control flow branches of a function and use the client API for that.
+The function <code>f()</code> in the following code snippet has four control flow branches: <code>1 &#8594; 2</code>, <code>&#8594; 3 &#8594;</code>, <code>&#8594; 4 &#8594;</code> and <code>5</code>.</p>
+</div>
+<div class="listingblock">
+<div class="title">Function <code>f()</code> has four control flow branches.</div>
+<div class="content">
+<pre class="highlight"><code>function f() {
+	1;
+	if (2)
+		3;
+	else
+		4;
+	5;
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>To compute these control flow branches, the class <code>AllBranchPrintVisitor</code> extends the <code>GraphVisitor</code>.
+Already in the method <code>initializeMode()</code> a graph explorer is activated.
+Note that the method <code>requestActivation()</code> can be understood as a <code>addListener</code> method for a listener that listens to visit events on nodes and edges.
+Immediately after the activation request, the first branch walker is created in the method <code>firstBranchWalker()</code>.</p>
+</div>
+<div class="paragraph">
+<p>The first visited CF element of the branch walker will then be the expression <code>1</code>.
+It is formed into a string and added to the variable <code>curString</code>.
+After expression <code>1</code>, the flow edge from <code>1</code> to <code>2</code> is visited.
+This will concatenate the string <code>&#8594;</code> to the path string.
+Variable <code>curString</code> will eventually hold the branch string like <code>1 &#8594; 2</code>.
+Since the control flow forks after <code>2</code>, the method <code>forkPath()</code> is called and creates two new instances of a branch walker.
+These new instances succeed the the first branch walker instance and each traverses one of the branches of the <code>if</code>-statement.
+When the <code>if</code>-statement is passed, these two branches are merged into a new succeeding branch walker.
+After all branch walkers are terminated, the graph explorer and graph visitor are also terminated.
+The method <code>getBranchStrings()</code> collects all four computed strings from the variable <code>curString</code> of all branch walkers.</p>
+</div>
+<div class="listingblock">
+<div class="title">Implementation of a graph visitor that computes all control flow paths</div>
+<div class="content">
+<pre class="highlight"><code>class AllBranchPrintVisitor extends GraphVisitor {
+	protected void initializeMode(Mode curDirection, ControlFlowElement curContainer) {
+		super.requestActivation(new AllBranchPrintExplorer());
+	}
+
+	class AllBranchPrintExplorer extends GraphExplorer {
+		class AllBranchPrintWalker extends BranchWalker {
+			String curString = "";
+
+			protected void visit(ControlFlowElement cfe) {
+				curString += cfe.toString();
+			}
+
+			protected void visit(FlowEdge edge) {
+				curString += " -&gt; ";
+			}
+
+			protected AllBranchPrintWalker forkPath() {
+				return new AllBranchPrintWalker();
+			}
+		}
+
+		protected BranchWalker joinBranches(List&lt;BranchWalker&gt; branchWalkers) {
+			// TODO Auto-generated method stub
+			return null;
+		}
+
+		protected BranchWalkerInternal firstBranchWalker() {
+			return new AllBranchPrintWalker();
+		}
+	}
+
+	List&lt;String&gt; getBranchStrings() {
+		List&lt;String&gt; branchStrings = new LinkedList&lt;&gt;();
+		for (GraphExplorerInternal app : getActivatedExplorers()) {
+			for (BranchWalkerInternal ap : app.getAllBranches()) {
+				AllBranchPrintWalker printPath = (AllBranchPrintWalker) ap;
+				branchStrings.add(printPath.curString);
+			}
+		}
+		return branchStrings;
+	}
+}</code></pre>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_path-quantor"><a class="anchor" href="#_path-quantor"></a><a class="link" href="#_path-quantor">22.1.3.6. Path quantor</a></h5>
+<div class="paragraph">
+<p>Graph explorers are typically used to reason on all branch walkers that start at a specific location.
+For instance, such a reasoning might determine whether some source element is reachable or whether a variable is used or not.
+To simplify this, quantors are provided.
+Since branch walkers originating from a single activation point can fork, the reasoning has to include all these forked branch walkers.
+Hence, graph explorers are instantiated using a quantor which can be either <em>For All</em>, <em>At Least One</em> OR <em>None</em> that refers to all branches.
+After all branch walkers of an explorer are terminated, the explorer is regarded as either passed or failed.
+Paths also can be aborted manually using the methods <code>pass()</code> or <code>fail()</code>.
+When <em>pass</em> or <em>fail</em> are used, the graph explorer might be terminated in the following cases:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>If the quantor of the graph explorer is <em>For All</em>, and <code>fail()</code> is called on a branch walker.</p>
+</li>
+<li>
+<p>If the quantor of the graph explorer is <em>At Least One</em>, and <code>pass()</code> is called on a branch walker.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Additionally, a graph explorer can be aborted manually by canceling all its branches.</p>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_control-flow-analyses"><a class="anchor" href="#_control-flow-analyses"></a><a class="link" href="#_control-flow-analyses">22.1.4. Control flow analyses</a></h4>
+<div class="sect4">
+<h5 id="_dead-code-analysis"><a class="anchor" href="#_dead-code-analysis"></a><a class="link" href="#_dead-code-analysis">22.1.4.1. Dead code analysis</a></h5>
+<div class="paragraph">
+<p>The dead code analysis uses the graph visitor in all four modes and collects all visited CF elements.
+The collected CF elements are saved separately for every mode.
+After the graph visitor is terminated, the unreachable CF elements are computed like follows:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>CF elements, that are collected during forward and catch block mode are reachable.</p>
+</li>
+<li>
+<p>CF elements, that are collected during islands mode are unreachable.</p>
+</li>
+<li>
+<p>CF elements, that are <em>only</em> collected during backward mode, are also unreachable.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>In a later step, the unreachable elements are merged into unreachable text regions that are used for error markers.</p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:dataflow"><a class="anchor" href="#sec:dataflow"></a><a class="link" href="#sec:dataflow">22.2. Dataflow</a></h3>
+<div class="paragraph">
+<p></p>
+</div>
+<div class="sidebarblock">
+<div class="content">
+<a href="https://github.com/eclipse/n4js/issues/331" class="gray" title="GitHub Issues"><span class="image"><img src="images/issue.svg" alt=""></span> #331</a>
+<a href="https://github.com/eclipse/n4js/issues/464" class="gray" title="GitHub Issues"><span class="image"><img src="images/issue.svg" alt=""></span> #464</a>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_dataflow-graph"><a class="anchor" href="#_dataflow-graph"></a><a class="link" href="#_dataflow-graph">22.2.1. Dataflow graph</a></h4>
+<div class="paragraph">
+<p>The data flow graph provides means to reason about <em>symbols</em>, <em>effects</em>, <em>data flow</em>, <em>aliases</em> and <em>guards</em> in the control flow graph.
+The main classes of the data flow API are <code>DataflowVisitor</code> and <code>Assumption</code>.</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Symbol</dt>
+<dd>
+<p>Symbols represent a program variable in the sence that it represents all AST elements, that bind to the same variable declaration (according to scoping).
+The terms <em>symbol</em> and <em>variable</em> are used synonymously.</p>
+</dd>
+<dt class="hdlist1">Effect</dt>
+<dd>
+<p>Effects are reads, writes and declarations of symbols.
+For instance, a typical CF element with a write effect is an assignment such as <code>a = null;</code>.
+Every effect refers to a single symbol and graph node.
+The following effects are provided:</p>
+<div class="ulist">
+<ul>
+<li>
+<p><em>Declaration</em>: is the declaration of a variable.</p>
+</li>
+<li>
+<p><em>Write</em>: is the definition of a variable&#8217;s value, which is typically done with an assignment.</p>
+</li>
+<li>
+<p><em>Read</em>: is the read of a variable&#8217;s value, which could happen when passing a variable as an argument to a method call.</p>
+</li>
+<li>
+<p><em>MethodCall</em>: is the call of a property method of a variable.</p>
+</li>
+</ul>
+</div>
+</dd>
+</dl>
+</div>
+<div class="paragraph">
+<p>Note that the term <em>value use</em> means either write or method call of a variable.
+The term <em>value definition</em> means that a variable is written.</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Data flow</dt>
+<dd>
+<p>The term data flow is used for assignments of all kind.
+For instance, the assigments <code>a = b</code>, <code>a = 1</code>, <code>a = null</code> or even <code>for (let [a] of [[0],[undefined]]);</code> are data flows.
+The data is always flowing from the right hand side to the left hand side.</p>
+</dd>
+<dt class="hdlist1">Alias</dt>
+<dd>
+<p>Due to data flow, other symbols can get important for an analysis.
+For instance, the data flow <code>a = b</code> makes <code>b</code> important when reasoning about <code>a</code> since the value of <code>b</code> is assigned to <code>a</code>.
+In the API is <code>b</code> therefore called an alias of <code>a</code>.</p>
+</dd>
+<dt class="hdlist1">Guard</dt>
+<dd>
+<p>Guards are conditions that appear in e.g. <code>it</code>-statements.
+For instance, a typical guard is the null-check in the following statement: <code>if (a == null) foo();</code>.
+For every CF element, guards can hold either <em>always</em>, <em>never</em> or <em>sometimes</em>.
+Note that the null-check-guard always holds at the method invocation <code>foo();</code>.</p>
+</dd>
+<dt class="hdlist1"><code>DataflowVisitor</code></dt>
+<dd>
+<p>The class <code>DataflowVisitor</code> provides means to visit all code locations where either effects happen or guards are declared.
+For instance, when a variable is written, the callback method <code>DataflowVisitor#visitEffect(EffectInfo effect, ControlFlowElement cfe)</code> gets called.
+In case a guard is declared, the callback method <code>visitGuard(Guard guard)</code> gets called.</p>
+</dd>
+<dt class="hdlist1"><code>Assumption</code></dt>
+<dd>
+<p>The class <code>Assumption</code> provides means to track the data flow of a specific symbol from a specific code location.
+For instance, assumptions are used to detect whether the symbol <code>s</code> in the property access <code>s.prop</code> is or may be undefined.
+In this example, the assumption symbol is <code>s</code> and its start location is the property access.
+From there, the data flow of <code>s</code> is tracked in backwards traverse direction.
+Also, (transitive) aliases of <code>s</code> are tracked.
+In case a data flow that happens on <code>s</code> or its aliases, the callback method <code>holdsOnDataflow(Symbol lhs, Symbol rSymbol, Expression rValue)</code> is called.
+For every effect that affects <code>s</code> or one of its aliases, the callback method <code>holdsOnEffect(EffectInfo effect, ControlFlowElement container)</code> is called.
+And finally, for all guards that hold always/never at the start location regarding symbol <code>s</code>, the callback method <code>holdsOnGuards(Multimap&lt;GuardType, Guard&gt; neverHolding, Multimap&lt;GuardType, Guard&gt; alwaysHolding)</code> is called.</p>
+</dd>
+</dl>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_dataflow-analyses"><a class="anchor" href="#_dataflow-analyses"></a><a class="link" href="#_dataflow-analyses">22.2.2. Dataflow analyses</a></h4>
+<div class="sect4">
+<h5 id="_def-def-def-nothing-analysis"><a class="anchor" href="#_def-def-def-nothing-analysis"></a><a class="link" href="#_def-def-def-nothing-analysis">22.2.2.1. Def&#8594;Def / Def&#8594;Nothing analysis</a></h5>
+<div class="paragraph">
+<p>A Def&#8594;Def analysis finds all defintions of a variable that are always a predecessor of another definition.
+Its result is a set of all obsolete definition sites.</p>
+</div>
+<div class="paragraph">
+<p>A Def&#8594;!Use analysis finds all definitions of a variable that are not followed by either a read or a method call.
+These definition are therefore obsolete and can be removed.</p>
+</div>
+<div class="paragraph">
+<p>Both of these analyses are performed in traverse direction <em>Forward</em>.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_def-use-decl-analysis"><a class="anchor" href="#_def-use-decl-analysis"></a><a class="link" href="#_def-use-decl-analysis">22.2.2.2. Def|Use&#8592;Decl analysis</a></h5>
+<div class="paragraph">
+<p>A Def|Use&#8592;Decl analysis finds all preceding <em>def</em> or <em>use</em> sites of a declarations of a specific variable.
+The paths might contain other <em>defs</em> or <em>uses</em> of the same variable.
+In case such paths exists, the variable is used before it is declared.
+This analysis is done in traverse direction <em>Backward</em>.</p>
+</div>
+<div id="img:usedBeforeDeclaredAnalysis" class="imageblock">
+<div class="content">
+<img src="chapters/30_flowgraphs/images/usedBeforeDeclaredAnalysis.png" alt="usedBeforeDeclaredAnalysis">
+</div>
+<div class="title">Figure 60. Finding use or def sites can be done using the graph visitor in traverse direction <em>Backward</em>.</div>
+</div>
+<div class="paragraph">
+<p>In the <a href="#img:usedBeforeDeclaredAnalysis">above figure</a> a graph visitor would visit all CF elements.
+When it visits the declaration in line 8 (<code>let w</code>), it will activate a graph explorer (star 1 in the figure) for variable <code>w</code>.
+Now, the first branch walker <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>b</mi><mn>1</mn></msub></math> is created and walks the control in backward traverse direction.
+When <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>b</mi><mn>1</mn></msub></math> encounters the exit node of the <code>if</code>-statement, it will create two forked branches <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>b</mi><mn>2</mn></msub></math> and <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>b</mi><mn>3</mn></msub></math>.
+Now, <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>b</mi><mn>2</mn></msub></math> enters then the branch of the <code>if</code>-statement (star 2), while <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>b</mi><mn>3</mn></msub></math> traverses directly to the condition of the <code>if</code>-statement.
+Next, <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>b</mi><mn>2</mn></msub></math> visits the def site of variable <code>w</code> (star 3).
+This means, that there exist a def site of <code>w</code> before <code>w</code> was declared and hence, an error should be shown.
+Since there could exist more cases like this, neither the branch walker nor the graph explorer are terminated.
+When reaching star 4, the two branch walkers <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>b</mi><mn>2</mn></msub></math> and <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>b</mi><mn>3</mn></msub></math> are joined and the follow-up branch walker <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>b</mi><mn>4</mn></msub></math> is created.
+At star 5, the end the CF container is reached and the <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>b</mi><mn>4</mn></msub></math> will be terminated.
+After all branch walkers are terminated, the graph explorer for the declaration site of variable <code>w</code> is evaluated:
+All use or def sites, that were reachable should be marked with an error saying that the declaration has to be located before the use of a variable.</p>
+</div>
+<div class="paragraph">
+<p>Note this analysis is currently implemented as a control flow analysis since it does not rely on guards, aliases.
+Also, it only relies on local variables and hence does not need the symbols that are provided by the data flow API.</p>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="sec:publish-npms-to-public"><a class="anchor" href="#sec:publish-npms-to-public"></a><a class="link" href="#sec:publish-npms-to-public">23. Publish npms</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>We publish npms located in the folder <code>n4js-libs</code> to the <a href="registry.npmjs.org">public npm registry</a>. Specifically, the following npms are published:</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Command line tools</dt>
+<dd>
+<div class="ulist">
+<ul>
+<li>
+<p>n4js-cli</p>
+</li>
+<li>
+<p>n4js-mangelhaft-cli</p>
+</li>
+</ul>
+</div>
+</dd>
+<dt class="hdlist1">Runtime definition files</dt>
+<dd>
+<div class="ulist">
+<ul>
+<li>
+<p>n4js-runtime-ecma402</p>
+</li>
+<li>
+<p>n4js-runtime-es2015</p>
+</li>
+<li>
+<p>n4js-runtime-esnext</p>
+</li>
+<li>
+<p>n4js-runtime-fetch</p>
+</li>
+<li>
+<p>n4js-runtime-html5</p>
+</li>
+<li>
+<p>n4js-runtime-node</p>
+</li>
+<li>
+<p>n4js-runtime-v8</p>
+</li>
+</ul>
+</div>
+</dd>
+<dt class="hdlist1">Mangelhaft</dt>
+<dd>
+<div class="ulist">
+<ul>
+<li>
+<p>org.eclipse.n4js.mangelhaft</p>
+</li>
+<li>
+<p>org.eclipse.n4js.mangelhaft.assert</p>
+</li>
+<li>
+<p>org.eclipse.n4js.mangelhaft.reporter.console</p>
+</li>
+<li>
+<p>org.eclipse.n4js.mangelhaft.reporter.ide</p>
+</li>
+<li>
+<p>org.eclipse.n4js.mangelhaft.reporter.xunit</p>
+</li>
+<li>
+<p>org.eclipse.n4js.mangelhaft.runner.ide</p>
+</li>
+</ul>
+</div>
+</dd>
+</dl>
+</div>
+<div class="paragraph">
+<p>In order to make sure that the npms work correctly with the <code>n4js</code> product, we need to integration test the interplay between the n4js products and the npms. Right now, we only focus on the interplay between the <code>n4js</code> headless compiler and npms. For integration tests, we publish the npms to a local npm registry which is provided by <a href="https://www.verdaccio.org/docs/en/docker.html">verdaccio docker image</a> before executing the tests. When all integration tests are executed, we stop the local npm registry.</p>
+</div>
+<div class="sect2">
+<h3 id="sec:publish-npms-n4js-maven"><a class="anchor" href="#sec:publish-npms-n4js-maven"></a><a class="link" href="#sec:publish-npms-n4js-maven">23.1. Publish n4js-libs to during  maven build</a></h3>
+<div class="admonitionblock warning">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-warning" title=""></i>
+</td>
+<td class="content">
+The NPMs are currently published using NumberFour&#8217;s internal build infrastructure in combination with extended integration tests. This needs to be changed in the future!
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>This section describes how integration tests can use local npm registry during the test.
+All integration tests that require a local npm registry should be placed in the bundle <code>org.eclipse.n4js.hlc.integrationtests</code></p>
+</div>
+<div class="imageblock center">
+<div class="content">
+<img src="chapters/40_publish_npms/images/publish_npm_in_mvn_workflow.svg" alt="publish npm in mvn workflow">
+</div>
+<div class="title">Figure 61. Maven phases</div>
+</div>
+<div class="paragraph">
+<p>During the maven build, three projects <code>org.eclipse.n4js.external.libraries.update</code>, <code>org.eclipse.n4js.product.build</code> and <code>org.eclipse.n4js.hlc.integrations</code> are built by maven in that order.</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>During the phase <em>process-classes</em> of the <code>org.eclipse.n4js.external.libraries.update</code> build, the UpdateShippedCode MWE2 workflow is triggerd to compile n4js code of npms in n4js-lib. The phase <em>process-classes</em> was chosen because it must happen after the <code>org.eclipse.n4js.external.libraries.update</code> bundle has been compiled.</p>
+</li>
+<li>
+<p>During the <em>verify</em> phase of the <code>org.eclipse.n4js.product.build</code> build, the Maven <code>exec-maven</code> plugin calls the script <code>n4js/releng/utils/scripts/publish-n4js-libs.sh</code> to publish the npms in the n4js-lib to the <em>staging npm registry</em>. The URL of this staging npm registry must be configured before triggering maven build via the environment variable <code>NPM_STAGING_REGISTRY</code>. Note that the staging npm registry lives beyond the life of <code>n4js-inhouse</code> 's maven build and holds npms that are needed by the integration tests in the n4js-extended&#8217;s build.</p>
+</li>
+<li>
+<p>During the <em>pre-integration-test</em> phase of the <code>org.eclipse.n4js.hlc.integrationtests</code> bundle, the Maven <code>antrun</code> plugin starts a <em>verdaccio</em> docker container local npm registry at <code><a href="http://localhost:4873" class="bare">http://localhost:4873</a></code> via docker. Also in the very same phase, the Maven plugin <code>exec-maven</code> calls the script <code>n4js/releng/utils/scripts/publish-n4js-libs.sh</code> to publish the npms in the n4js-lib folder to the local registry <code><a href="http://localhost:4873" class="bare">http://localhost:4873</a></code>. The list of published npms is identical to that list above. Note that the npms are published with the <code>dist-tag</code> <em>test</em>.</p>
+</li>
+<li>
+<p>During the <em>integration-test</em> phase of <code>org.eclipse.n4js.hlc.integrationtests</code>, the Maven <code>failsafe</code> plugin executes the integration tests. Here, the integration tests can pull the required npms from the local registry populated during the <em>pre-integration-test</em> above.</p>
+</li>
+<li>
+<p>In the <em>pre-integration-test</em> phase of <code>org.eclipse.n4js.hlc.integrationtests</code>, the Maven <code>antrun</code> plugins removes the  <em>verdaccio</em> docker container.</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="sec:Hints"><a class="anchor" href="#sec:Hints"></a><a class="link" href="#sec:Hints">Appendix A: Hints</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>In this chapter, some tips and tricks regarding Eclipse, Xtend and Maven should be collected.</p>
+</div>
+<div class="sect2">
+<h3 id="sec:XtextInjection"><a class="anchor" href="#sec:XtextInjection"></a><a class="link" href="#sec:XtextInjection">A.1. Xtext Injection</a></h3>
+<div class="paragraph">
+<p><a href="#fig:cd_XtextInjectors">[fig:cd_XtextInjectors]</a> shows different injectors used by Xtext
+and their relation to the injector of a custom language created with Xtext
+(in this example N4JS).</p>
+</div>
+<div id="fig:XtextInjectors" class="imageblock center">
+<div class="content">
+<img src="chapters/a02_hints/images/cd_XtextInjectors.svg" alt="cd XtextInjectors">
+</div>
+<div class="title">Figure 62. Xtext injectors and custom DSL injector</div>
+</div>
+<div class="paragraph">
+<p><strong>Injectors creation:</strong></p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>create 'SharedInjector'</p>
+<div class="ulist">
+<ul>
+<li>
+<p>create shared singletons</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>create (lazily) custom language injector</p>
+<div class="ulist">
+<ul>
+<li>
+<p>take singletons from shared injector</p>
+</li>
+<li>
+<p>add bindings from 'SharedModule'</p>
+</li>
+<li>
+<p>create own singletons</p>
+</li>
+</ul>
+</div>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Normally one injector is bound to one language.
+'ContributingModule' allows custom languages to contribute bindings to the
+shared state, effectively cross project boundaries.</p>
+</div>
+<div class="paragraph">
+<p>It must be noted that in case of N4JS tools there are multiple languages
+contributing / extending Xtext injector, which can be seen in figure
+<a href="#fig:cd_customInjectors">Xtext injectors and custom DSL injector</a></p>
+</div>
+<div id="fig:cd_customInjectors" class="imageblock center">
+<div class="content">
+<img src="chapters/a02_hints/images/cd_customInjectors.svg" alt="cd customInjectors">
+</div>
+<div class="title">Figure 63. Xtext injectors and custom DSL injector</div>
+</div>
+<div class="sect3">
+<h4 id="sec:DI_MultipleInjectors_Singletons"><a class="anchor" href="#sec:DI_MultipleInjectors_Singletons"></a><a class="link" href="#sec:DI_MultipleInjectors_Singletons">A.1.1. Multiple Injectors and Singletons</a></h4>
+<div class="paragraph">
+<p>Every injector creates its 'ObjectGraph'. Having multiple Injectors in
+the system leads to multiple (disconnected) object graphs. For normal instances
+that is not an issue, but for scoped instances this causes problems.
+Most common issue happens with '@Singleton' instances that carry state.</p>
+</div>
+<div id="fig:cd_SingletonDuplicate" class="imageblock center">
+<div class="content">
+<img src="chapters/a02_hints/images/cd_SingletonDuplicate.svg" alt="cd SingletonDuplicate">
+</div>
+<div class="title">Figure 64. Xtext injectors and custom DSL injector</div>
+</div>
+<div class="paragraph">
+<p><a href="#fig:cd_customInjectors">Xtext injectors and custom DSL injector</a> shows situation in which both 'ChildInjector'
+and 'N4JSInjector' have their bindings for 'N4JSEclipseCore'. As a result those
+injectors will create their instance of core that is expected to be
+'@Singleton'. Additionally, this will be true for all its transitive
+dependencies.</p>
+</div>
+<div class="sect4">
+<h5 id="sec:DI_avoid_duplicate_singletons"><a class="anchor" href="#sec:DI_avoid_duplicate_singletons"></a><a class="link" href="#sec:DI_avoid_duplicate_singletons">A.1.1.1. Avoiding duplicate singletons</a></h5>
+<div class="paragraph">
+<p>To avoid issue with duplicate singletons two distinct injectors should not
+have their bindings for singletons. Developer needs to decide where to
+define <strong>the only</strong> binding, and let one 'ObjectGraph' delegate to another.</p>
+</div>
+<div class="sect5">
+<h6 id="sec:DI_binding_in_shared"><a class="anchor" href="#sec:DI_binding_in_shared"></a><a class="link" href="#sec:DI_binding_in_shared">A.1.1.1.1. Defining binding in the shared injector</a></h6>
+<div class="paragraph">
+<p>One approach is to define binding in the shared injector. Then in the injector
+of the custom language to delegate to the shared contribution.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>/** Binds {@link IN4JSCore} */
+public class ContributingModule implements Module {
+    @Override
+    public void configure(Binder binder) {
+        binder.bind(IN4JSCore.class).to(IN4JSEclipseCore.class);
+        binder.bind(IN4JSEclipseCore.class).to(N4JSEclipseCore.class).in(SINGLETON);
+    }
+}
+
+/** Delegates binding for {@link IN4JSCore} to the shared provider. */
+public class ContributingModule implements Module {
+    public Provider&lt;? extends IN4JSCore&gt; bindIN4JSCore() {
+        return Access.contributedProvider(N4JSEclipseCore.class);
+    }
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Downside of this approach is in the shared injector itself.
+It does not allow for implicit bindings. This forces developer to declare
+bindings for <strong>all transitive</strong> dependencies of the main binding explicitly.
+Additionally, every custom language has to do it. These make shared injector
+the <em>GodInjector</em> that contains configuration for all custom languages,
+it is responsible for creating most objects in the system, and potentially
+exposes types from one language to another language where it might not be
+desired.</p>
+</div>
+</div>
+<div class="sect5">
+<h6 id="sec:DI_binding_in_custom"><a class="anchor" href="#sec:DI_binding_in_custom"></a><a class="link" href="#sec:DI_binding_in_custom">A.1.1.1.2. Defining binding in the custom injector</a></h6>
+<div class="paragraph">
+<p>Other approach is to define binding in the injector for a custom
+language. Then let instances in the shared injector object graph to obtain
+singleton instances via custom language injector (which is stored on the
+custom language activator).</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>/** Does not bind {@link IN4JSCore} */
+public class ContributingModule implements Module {
+    @Override
+    public void configure(Binder binder) {
+        // no core binding
+    }
+}
+
+/** Binds {@link IN4JSCore}. */
+public class ContributingModule implements Module {
+    public Class&lt;? extends IN4JSCore&gt; bindIN4JSCore() {
+        return IN4JSEclipseCore.class;
+    }
+}
+
+/** Some type used in shared injector object graph */
+public SomeSharedType{
+
+    /** Obtain {@link IN4JSCore} form {@code N4JSInjector}. */
+    private IN4JSCore getIN4JSCore() {
+        return N4JSActivator
+                .getInstance()
+                .getInjector(ORG_ECLIPSE_N4JS_N4JS)
+                .getInstance(IN4JSCore.class);
+    }
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>This approach also has downsides. In the 'SomeSharedType' that exists in the
+shared injector object graph we cannot inject 'IN4JSCore' as it is not
+known to the shared injector. Instead, we have to get the instance form the
+'N4JSInjector' manually. This requires developer to know whole (singleton)
+types structure
+defined in every custom language.</p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3 language-n4js">
+<h4 id="sec:DI_Hints"><a class="anchor" href="#sec:DI_Hints"></a><a class="link" href="#sec:DI_Hints">A.1.2. Dependency Injection Hints</a></h4>
+<div class="sect4">
+<h5 id="sec:DI_custom_bundle"><a class="anchor" href="#sec:DI_custom_bundle"></a><a class="link" href="#sec:DI_custom_bundle">A.1.2.1. Use DI in custom bundle, use DI with extensions</a></h5>
+<div class="sect5">
+<h6 id="sec:DI_custom_bundle_problem"><a class="anchor" href="#sec:DI_custom_bundle_problem"></a><a class="link" href="#sec:DI_custom_bundle_problem">A.1.2.1.1. Problem</a></h6>
+<div class="paragraph">
+<p>DI should be used in a custom bundle, i.e. a bundle not generated by Xtext.
+E.g., a new handler should be provided in its plugin, and this handler requires
+an injected instance. Example</p>
+</div>
+<div class="paragraph">
+<p>my.dsl.bundle.ui xtext generated</p>
+</div>
+<div class="paragraph">
+<p>my.dsl.bundle.sub.ui
+The following class is contained in my custom plugin:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>class my.dsl.bundle.sub.ui.Handler {
+    @Inject SomeDSLOrXtextSpecificType obj;
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>The question is, how can obj of type be injected at this location?</p>
+</div>
+</div>
+<div class="sect5">
+<h6 id="sec:DI_custom_bundle_solution"><a class="anchor" href="#sec:DI_custom_bundle_solution"></a><a class="link" href="#sec:DI_custom_bundle_solution">A.1.2.1.2. Solution</a></h6>
+<div class="paragraph">
+<p>First of all, to use DI in a type, the type instance itself must have been
+created via DI. This requires an injector which uses the same class loader as
+the type using the injector. This means that a new bundle needs its injector,
+created by an IExecutableExtensionFactory using the bundles' activator (plugin)
+singleton.</p>
+</div>
+<div class="paragraph">
+<p>This activator can extend the generated activator of a Xtext bundle. The
+following code can be used as a template, as long as no custom non-default
+bindings are to be added (in this case, have a look at the generated activator
+and override the methods configuring the injector):</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>public class my.dsl.bundle.sub.ui.Activator extends my.dsl.bundle.ui.MyDSLActivator {
+    private static my.dsl.bundle.sub.ui.Activator INSTANCE;
+
+    @Override
+    public void start(BundleContext context) throws Exception {
+        super.start(context);
+        INSTANCE = this;
+    }
+
+    @Override
+    public void stop(BundleContext context) throws Exception {
+        INSTANCE = null;
+        super.stop(context);
+    }
+
+    public static TypePopupActivator getInstance() {
+        return INSTANCE;
+    }
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Additionally, a custom 'AbstractGuiceAwareExecutableExtensionFactory' has to be
+implemented. This class then uses the new activator instance (this is required
+as bundles have their classloaders!)</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>public class my.dsl.bundle.sub.ui.SubExecutableExtensionFactory extends AbstractGuiceAwareExecutableExtensionFactory {
+    @Override
+    protected Bundle getBundle() {
+        return my.dsl.bundle.sub.ui.Activator.getInstance().getBundle();
+    }
+
+    @Override
+    protected Injector getInjector() {
+    return my.dsl.bundle.sub.ui.Activator.getInstance().getInjector(MyDSLActivator.MY_LANGUAGE_GRAMMAR);
+    }
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Now, we can use this extension factory in the plugin.xml of the sub bundle to
+let the handler be created via DI. E.g.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>"org.eclipse.ui.handlers"&amp;gt;
+&lt;handler
+class="my.dsl.bundle.sub.ui.SubExecutableExtensionFactory:my.dsl.bundle.sub.ui.Handler"
+commandId="..."&amp;gt;
+handler&amp;gt;
+extension&amp;gt;</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Access_Other_DSL_Injector"><a class="anchor" href="#sec:Access_Other_DSL_Injector"></a><a class="link" href="#sec:Access_Other_DSL_Injector">A.1.2.2. How do I get the Guice Injector of my language?</a></h5>
+<div class="paragraph">
+<p>We have the use case to load a N4MF file inside the N4JS infrastructure to read
+out the project description and configure the qualified names and container
+visibility. I.e. we have to load another DSL in our current DSL infrastructure,
+in the use case to have a Xtext resource set available to load the N4MF file.
+Injecting the Xtext resource of the current DSL wouldn’t work as it has not the
+N4MF injection context. So in the following the ways how to access this
+injection context is described as extracted from
+<a href="http://koehnlein.blogspot.de/2012/11/xtext-tip-how-do-i-get-guice-injector.html">this blog post</a>.</p>
+</div>
+<div class="sect5">
+<h6 id="sec:DSL_Injector_UI_context"><a class="anchor" href="#sec:DSL_Injector_UI_context"></a><a class="link" href="#sec:DSL_Injector_UI_context">A.1.2.2.1. UI context</a></h6>
+<div class="paragraph">
+<p>To access another DSL injector in a UI DSL project just add a dependency to the
+UI project of the other DSL and then</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>MyClass myClass =
+TheOtherDSLActivator.getInstance().getInjector().get(MyClass.class)</code></pre>
+</div>
+</div>
+</div>
+<div class="sect5">
+<h6 id="sec:DSL_Injector_Non_UI_context"><a class="anchor" href="#sec:DSL_Injector_Non_UI_context"></a><a class="link" href="#sec:DSL_Injector_Non_UI_context">A.1.2.2.2. Non UI context but with injection context</a></h6>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>@Inject IResourceServiceProvider.Registry serviceProviderRegistry;
+...
+MyClass myClass
+=
+serviceProviderRegistry.getResourceServiceProvider(URI.createFileURI(n4mfFileAbsolutePath)).get(MyClass.class)</code></pre>
+</div>
+</div>
+</div>
+<div class="sect5">
+<h6 id="sec:DSL_Injector_Non_UI_non_injection_context"><a class="anchor" href="#sec:DSL_Injector_Non_UI_non_injection_context"></a><a class="link" href="#sec:DSL_Injector_Non_UI_non_injection_context">A.1.2.2.3. Non UI context without injection context</a></h6>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>@Inject IResourceServiceProvider.Registry serviceProviderRegistry;
+...
+MyClass
+myClass
+=
+IResourceServiceProvider.Registry.INSTANCE.getResourceServiceProvider(uri).get(MyClass.class);</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Cancel_Indicator"><a class="anchor" href="#sec:Cancel_Indicator"></a><a class="link" href="#sec:Cancel_Indicator">A.1.2.3. How do I get cancel indicators in different contexts?</a></h5>
+<div class="paragraph">
+<p>Several factors contribute to responsiveness in the IDE, but here we focus in
+running jobs in the background and reacting to cancellation requests.</p>
+</div>
+<div class="paragraph">
+<p>The Eclipse Jobs API is recommended for potentially long-running tasks (other
+than incremental building, which has dedicated support). For example, the
+outline view is populated by a background job, running validations on the
+resource (and honoring cancellation requests initiated as for any job).</p>
+</div>
+<div class="paragraph">
+<p>Cancel indicators are a Xtext abstraction while Eclipse favors progress
+monitors, the latter including not only cancellation capability but also a
+callback mechanism to give feedback in the UI about intermediate progress.
+Cancel indicator can wrap a progress monitor.</p>
+</div>
+<div class="paragraph">
+<p>Cancel indicators come in two variants, depending on the source of cancellation
+events:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>a resource becoming stale (usually as a result of editing sources) triggers
+cancellation. These cancel indicators can be obtained via
+'OutdatedStateManager', which itself is available via injection.</p>
+</li>
+<li>
+<p>cancel indicators associated to the UI, for example associated to an Eclipse
+job. Examples:</p>
+<div class="ulist">
+<ul>
+<li>
+<p>for an outline view running in the background, an override of method
+'createRoot()' from 'DefaultOutlineTreeProvider' receives a UI-aware cancel
+indicator;</p>
+</li>
+<li>
+<p>for the transpiler, instances that carry cancel indicator are
+'IFileSystemAccess' and (in the future) 'IGenerator2'. To track the latter, see
+Eclipse bug 477068.</p>
+</li>
+</ul>
+</div>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>In general, whenever a resource is validated cancel indicator should be checked
+periodically. These checks are performed automatically via
+'MethodWrapperCancelable' before the (reflective) invocation of each validation
+method and therefore require no manual intervention, see
+'AbstractMessageAdjustingN4JSValidator'. However, that doesn’t help in case a
+single validation method ''takes too long''. To simplify those checks, utility
+'isCanceled()' of 'AbstractMessageAdjustingN4JSValidator' can be invoked.</p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="sec:Eclipse"><a class="anchor" href="#sec:Eclipse"></a><a class="link" href="#sec:Eclipse">A.2. Eclipse</a></h3>
+<div class="sect3">
+<h4 id="sec:Show_Xtext_Index"><a class="anchor" href="#sec:Show_Xtext_Index"></a><a class="link" href="#sec:Show_Xtext_Index">A.2.1. Show the current Xtext index</a></h4>
+<div class="paragraph">
+<p>Press the following keyboard shortcut in the running UI: <kbd>CTRL</kbd><br>
+<kbd>SHIFT</kbd> + <kbd>F3</kbd> (likely under Mac <kbd>CMD</kbd> + <kbd>SHIFT</kbd> + <kbd>F3</kbd>).</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Plugin_spy"><a class="anchor" href="#sec:Plugin_spy"></a><a class="link" href="#sec:Plugin_spy">A.2.2. Plug-in spy</a></h4>
+<div class="paragraph">
+<p>Not special for Xtext but very helpful do identify which class implements a UI
+concept, for example, if you want to know which class implements the Open Model
+Element dialog just press <kbd>CTRL</kbd> + <kbd>SHIFT</kbd> + <kbd>F3</kbd> to open that
+dialog and afterwards press <kbd>SHIFT</kbd> + <kbd>ALT</kbd> + <kbd>F1</kbd> to show that
+'XtextEObjectSearchDialog' is used as implementation. Additionally, use
+<kbd>SHIFT</kbd> + <kbd>ALT</kbd> + <kbd>F2</kbd> to spy buttons in the toolbar and
+<kbd>SHIFT</kbd> + <kbd>ALT</kbd> + <kbd>F3</kbd> to spy the extension point name of the
+currently active view or window.</p>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="sec:Maven-hints"><a class="anchor" href="#sec:Maven-hints"></a><a class="link" href="#sec:Maven-hints">A.3. Maven</a></h3>
+<div class="sect3">
+<h4 id="how-to-check-for-maven-mojo-updates"><a class="anchor" href="#how-to-check-for-maven-mojo-updates"></a><a class="link" href="#how-to-check-for-maven-mojo-updates">A.3.1. How to check for Maven MOJO updates</a></h4>
+<div class="paragraph">
+<p><strong>cd</strong> to the root directory and call</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-bash" data-lang="bash">mvn versions:display-plugin-updates</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_module-loading"><a class="anchor" href="#_module-loading"></a><a class="link" href="#_module-loading">Appendix B: Module Loading</a></h2>
+<div class="sectionbody">
+<div class="admonitionblock warning">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-warning" title=""></i>
+</td>
+<td class="content">
+This chapter is outdated and basically kept for historical reasons.
+</td>
+</tr>
+</table>
+</div>
+<div class="sect2">
+<h3 id="sec:Dependency_Management"><a class="anchor" href="#sec:Dependency_Management"></a><a class="link" href="#sec:Dependency_Management">B.1. Dependency Management</a></h3>
+<div class="paragraph">
+<p>There exist several types of dependencies between modules, distinguishable by the time when the dependency is relevant. We first define these dependencies lazily to give an impression of the problem, at more rigorously later on.</p>
+</div>
+<div class="paragraph">
+<p>Dependency needed at compile time. These type of dependency is removed by the compiler. These are basically type references used in variable or function declarations.</p>
+</div>
+<div class="paragraph">
+<p>Runtime dependencies are to be handled at runtime in general. We distinguish two special types of runtime dependencies:</p>
+</div>
+<div class="paragraph">
+<p>A loadtime dependency is a special runtime dependency that needs to be resolved before a module is initialized, that is, when all top-level statements of a module, containing class declarations, are executed. This usually is a types super type (e.g., super class), or a call to a function (defined in a different module) in a static initializer or module top level statement.</p>
+</div>
+<div class="paragraph">
+<p>An execution time dependency is a non-initialization runtime dependency. That is, when a method is called (from another module), this is execution time.</p>
+</div>
+<div class="paragraph">
+<p>Of course, before a module can be loaded, it needs to be fetched (i.e., the actual code has to be retrieved by the browser).</p>
+</div>
+<div class="paragraph">
+<p>We can define sets containing modules which a given module depends on. Note that these sets contain each other, as shown in <a href="#fig:euler_dependencies">Euler Dependencies</a>. However, we define disjoint sets in which a dependency to another type is only contained in one of the sets.</p>
+</div>
+<div id="fig:euler_dependencies" class="imageblock center">
+<div class="content">
+<img src="chapters/a10_moduleLoading/images/euler_dependencies.svg" alt="euler dependencies">
+</div>
+<div class="title">Figure 65. Euler diagram of dependency sets</div>
+</div>
+<div class="paragraph">
+<p>Given a code sequence , we define the set of accessed modules in it as .</p>
+</div>
+<div class="literalblock">
+<div class="content">
+<pre>describes all function calls happening in code block , i.e. . In case  calls on functions , we define a function’s body code sequence as .</pre>
+</div>
+</div>
+<div class="paragraph">
+<p>The complete set of accessed modules for a particular code sequence  is then defined as
+]</p>
+</div>
+<div class="paragraph">
+<p>We explicitly allow a function to be excluded from being incorporated in the above algorithm by annotating it.</p>
+</div>
+<div class="paragraph">
+<p>The set of load-time-dependencies for a module  with initializer code  is then defined as math:[\[\begin{aligned}
+load-time-deps := AccessdModules( SuperClass(M) ) + AccessdModules( IC(M) ) \end{aligned}\]]</p>
+</div>
+</div>
+<div class="sect2 language-javascript">
+<h3 id="ecmascript-modules"><a class="anchor" href="#ecmascript-modules"></a><a class="link" href="#ecmascript-modules">B.2. ECMAScript Modules</a></h3>
+<div class="sect3">
+<h4 id="sec:ES5_Modules_Systems"><a class="anchor" href="#sec:ES5_Modules_Systems"></a><a class="link" href="#sec:ES5_Modules_Systems">B.2.1. ES5 Modules Systems</a></h4>
+<div class="paragraph">
+<p>Before ES6, Javascript had no built in support for modules. To overcome this hurdle, the two widely accepted formats have been :</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p><code>CommonJS</code> : Primarily aimed at synchronous module loading. The main implementation of this format is seen in <code>Node.js</code></p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-javascript" data-lang="javascript">var value = 100;
+function inc() {
+    value++;
+}
+
+module.exports = {
+    value : value,
+    inc : inc
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Import via require.</p>
+</div>
+</li>
+<li>
+<p><code>AMD</code> : Primarily aimed at asynchronous module loading in browsers. The main implementation of this format is seen in <code>RequireJS</code>.</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>define('myModule', ['mod1', 'mod2'], function (mod1, mod2) {
+        return {
+            myFunc: function(x, y) {
+                ..
+            }
+        };
+    };
+});</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p><code>passive</code> format</p>
+</div>
+</li>
+</ol>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:ES6_Modules"><a class="anchor" href="#sec:ES6_Modules"></a><a class="link" href="#sec:ES6_Modules">B.2.2. ES6 Modules</a></h4>
+<div class="paragraph">
+<p>The ES6 spec introduces <a href="http://www.ecma-international.org/ecma-262/6.0/#sec-modules">modules</a>. ES6 modules resemble <code>CommonJS</code> syntax with <code>AMD</code> like asynchronous loading support.</p>
+</div>
+<div class="paragraph">
+<p>Apart from the syntactic details, the highlights of ES6 modules are :</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>ES6 modules support (multiple) named exports.</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>export const VERSION = "1.0.1";
+export function inc(x) {
+    return x + 1;
+}</code></pre>
+</div>
+</div>
+</li>
+<li>
+<p>ES6 modules support default exports.</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>export default function (x) {
+    return x+1;
+}</code></pre>
+</div>
+</div>
+</li>
+<li>
+<p>As specified <a href="http://www.ecma-international.org/ecma-262/6.0/#sec-createimportbinding">here</a>, ES6 modules export live immutable bindings (instead of values).</p>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title=""></i>
+</td>
+<td class="content">
+This behaviour is different from that of <code>CommonJS</code> and <code>AMD</code> modules where a snapshot of the value is exported.
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>An example demonstrating the behavioural difference :</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>//-------------src.js------------
+var value = 100;
+function inc() {
+    value++;
+}
+
+module.exports = {
+    value : value,
+    inc : inc
+}
+//-------------main.js------------
+var src = require("./src"); //import src
+
+console.log(src.value); //prints 100
+src.inc();
+
+console.log(src.value); //prints 100 &lt;--- The value does not update.
+
+src.value = 65;
+console.log(src.value); //prints 65 &lt;--- The imported value is mutable.</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>The same example with ES6 modules :</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>//-------------src.js------------
+export var value = 100; // &lt;--- ES6 syntax
+export function inc() { // &lt;--- ES6 syntax
+    value++;
+}
+
+//-------------main.js------------
+import {value, inc} from "src" // &lt;--- ES6 syntax
+
+console.log(value); //prints 100
+inc();
+
+console.log(value); //prints 101 &lt;--- The value is a live binding.
+
+value = 65; // &lt;--- throws an Error implying the binding is immutable.</code></pre>
+</div>
+</div>
+</li>
+<li>
+<p>ES6 modules impose a static module structure i.e. the imports and exports can be determined at compile time (statically).</p>
+</li>
+</ol>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:ECMAScript_Module_Loaders"><a class="anchor" href="#sec:ECMAScript_Module_Loaders"></a><a class="link" href="#sec:ECMAScript_Module_Loaders">B.3. ECMAScript Module Loaders</a></h3>
+<div class="paragraph">
+<p>For resolving module dependencies and loading modules, the JS landscape provides a few different module loaders.</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p><code>RequireJS</code> is the loader of choice for in browser, <code>AMD</code> style modules. We currently transpile our code into an AMD-style format to allow it running in both Browser and Node.js environments.</p>
+</li>
+<li>
+<p><code>Node.js</code> provides a native loader implementation for <code>CommonJS</code> style modules.</p>
+</li>
+<li>
+<p>For browsers (primarily), tools like <a href="http://webpack.github.io/"><code>Webpack</code></a> and <a href="http://browserify.org/"><code>Browserify</code></a> exist. These tools analyse the dependency graph of the entire project and then bundle up all the dependencies in a single file. <code>Browserify</code> only supports <code>CommonJS</code> modules where as <code>Webpack</code> works with both <code>CommonJS</code> &amp; <code>AMD</code> style modules.</p>
+</li>
+<li>
+<p>At the time of writing this document (August 2015), there does not exist any native implementation for ES6 modules by any Javascript host environments i.e. ES6 modules are not natively supported by browsers or <code>Node.js</code>, as of now.</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>[fig:moduelLoader] shows an overview.</p>
+</div>
+<div id="fig:moduleLoader" class="imageblock center">
+<div class="content">
+<img src="chapters/a10_moduleLoading/images/moduleLoader.svg" alt="moduleLoader">
+</div>
+<div class="title">Figure 66. Module Loader and Transpilers, Overview</div>
+</div>
+<div class="sect3">
+<h4 id="sec:ES6_Module_Loaders"><a class="anchor" href="#sec:ES6_Module_Loaders"></a><a class="link" href="#sec:ES6_Module_Loaders">B.3.1. ES6 Module Loaders</a></h4>
+<div class="paragraph">
+<p>The ES6 spec started out with ES6 Module Loader details as part of the spec. However the Working Group later decided to not proceed with it. The specification for ES6 Module Loader is now a separate specification [<a href="#WhatWGLoader">WhatWGLoader</a>].</p>
+</div>
+<div class="paragraph">
+<p>The aim of this specification is:</p>
+</div>
+<div class="quoteblock">
+<blockquote>
+<div class="paragraph">
+<p>This specification describes the behavior of loading JavaScript modules from a JavaScript host environment. It also provides APIs for intercepting the module loading process and customizing loading behavior.</p>
+</div>
+</blockquote>
+</div>
+<div class="paragraph">
+<p>The <a href="https://github.com/whatwg/loader#implementation-status">Implementation status</a> of the spec states :</p>
+</div>
+<div class="quoteblock">
+<blockquote>
+<div class="paragraph">
+<p>It is too early to know about the Loader, first we need ES2015 modules implemented by the various engines.</p>
+</div>
+</blockquote>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Polyfills_for_ES6_Module_Loaders"><a class="anchor" href="#sec:Polyfills_for_ES6_Module_Loaders"></a><a class="link" href="#sec:Polyfills_for_ES6_Module_Loaders">B.3.2. Polyfills for ES6 Module Loaders</a></h4>
+<div class="paragraph">
+<p>Although there is no native support for ES6 module loading, there are a few attempts to polyfill this gap.</p>
+</div>
+<div class="sect4">
+<h5 id="sec:es6_module_loader"><a class="anchor" href="#sec:es6_module_loader"></a><a class="link" href="#sec:es6_module_loader">B.3.2.1. es6-module-loader</a></h5>
+<div class="paragraph">
+<p>The <a href="https://github.com/ModuleLoader/es6-module-loader"><code>es6-module-loader</code></a> project provides a polyfill for the ES6 Module Loader implementation. It dynamically loads ES6 modules in browsers and <code>Node.js</code> with support for loading existing and custom module formats through loader hooks.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:SystemJS"><a class="anchor" href="#sec:SystemJS"></a><a class="link" href="#sec:SystemJS">B.3.2.2. SystemJS</a></h5>
+<div class="paragraph">
+<p>Building upon <code>es6-module-loader</code>, <a href="https://github.com/systemjs/systemjs"><code>SystemJS</code></a> supports loading ES6 modules along with <code>AMD</code>, <code>CommonJS</code> and global scripts in the browser and <code>Node.js</code>.</p>
+</div>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title=""></i>
+</td>
+<td class="content">
+In order to use ES6 modules (written in ES6 syntax) the code first needs to be transpiled to ES5. For this purpose, <code>SystemJS</code> provides an option to use <a href="https://github.com/google/traceur-compiler"><code>Traceur</code></a> compiler or <a href="https://babeljs.io/"><code>Babel</code></a>.
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Demo"><a class="anchor" href="#sec:Demo"></a><a class="link" href="#sec:Demo">B.3.2.3. Demo</a></h5>
+<div class="paragraph">
+<p>A demonstration of how to how to use ES6 modules with <code>Babel</code> and <code>SystemJS</code> in <code>Node.js</code> as of today (August 2015).</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Create an ES6 module as shown:</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>export var value = 100; // &lt;--- named export of a variable
+export function inc() { // &lt;--- named export of a function
+    value++;
+}</code></pre>
+</div>
+</div>
+</li>
+<li>
+<p>Import the bindings from the module as shown:</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import {value, inc} from "src"
+
+var importedValue = value; // &lt;--- using the imported value
+inc(); // &lt;--- using the imported function</code></pre>
+</div>
+</div>
+</li>
+<li>
+<p>Transpile these two files using <code>Babel</code> to ES5 with the target module format as <code>system</code>, as shown:</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>$ babel &lt;inputdir&gt; --out-dir &lt;outputdir&gt; --modules system</code></pre>
+</div>
+</div>
+</li>
+<li>
+<p>The transpiled output should be resemble the following:</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>System.register([], function (_export) {
+    "use strict";
+
+    var value;
+
+    _export("inc", inc);
+
+    function inc() {
+        _export("value", value += 1);
+    }
+
+    return {
+        setters: [],
+        execute: function () {
+            value = 100;
+
+            _export("value", value);
+        }
+    };
+});</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>System.register(["src"], function (_export) {
+  "use strict";
+
+  var value, inc, importedValue;
+  return {
+    setters: [function (_src) {
+      value = _src.value;
+      inc = _src.inc;
+    }],
+    execute: function () {
+      importedValue = value;
+      inc();
+    }
+  };
+});</code></pre>
+</div>
+</div>
+</li>
+<li>
+<p>Finally run the above transpiled files, as shown:</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>var System = require('systemjs'); // &lt;--- Require SystemJS
+System.transpiler = 'babel'; // &lt;--- Configure SystemJS
+
+System.import('main'); // &lt;--- Import the transpiled "main" module.</code></pre>
+</div>
+</div>
+</li>
+</ol>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2 language-typescript">
+<h3 id="case-study-typescript"><a class="anchor" href="#case-study-typescript"></a><a class="link" href="#case-study-typescript">B.4. Case Study : TypeScript</a></h3>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title=""></i>
+</td>
+<td class="content">
+<a id="sec:Case_Study___TypeScript"></a> This section is NOT an exhaustive introduction to Microsoft’s <code>TypeScript</code>, but a narrowed down analysis of certain aspects of <code>TypeScript</code>.
+</td>
+</tr>
+</table>
+</div>
+<div class="sect3">
+<h4 id="sec:ES6_Modules_Support"><a class="anchor" href="#sec:ES6_Modules_Support"></a><a class="link" href="#sec:ES6_Modules_Support">B.4.1. ES6 Modules Support</a></h4>
+<div class="paragraph">
+<p><code>TypeScript</code> language has recently added support for ES6 modules. From the <a href="https://github.com/Microsoft/TypeScript/wiki/What%27s-new-in-TypeScript#es6-modules">wiki</a> :</p>
+</div>
+<div class="quoteblock">
+<blockquote>
+<div class="paragraph">
+<p><code>TypeScript</code> 1.5 supports <code>ECMAScript 6</code> (ES6) modules. ES6 modules are effectively <code>TypeScript</code> external modules with a new syntax: ES6 modules are separately loaded source files that possibly import other modules and provide a number of externally accessible exports. ES6 modules feature several new export and import declarations.</p>
+</div>
+</blockquote>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:TypeScript_and_Module_Loading"><a class="anchor" href="#sec:TypeScript_and_Module_Loading"></a><a class="link" href="#sec:TypeScript_and_Module_Loading">B.4.2. TypeScript and Module Loading</a></h4>
+<div class="paragraph">
+<p><code>TypeScript</code> does not concern itself with providing a module loader. It is the responsibility of the host environment. However <code>TypeScript</code>’s compiler provides options to transpile the modules to different formats like <code>AMD</code>, <code>CommonJS</code>, <code>ES6</code> etc. It is the developer’s responsibility to choose an appropriate format and then use the modules with a correct module loader.</p>
+</div>
+<div class="paragraph">
+<p>From the <a href="https://github.com/Microsoft/TypeScript/issues/2242">wiki</a> again :</p>
+</div>
+<div class="quoteblock">
+<blockquote>
+<div class="paragraph">
+<p>TypeScript supports down-level compilation of external modules using the new ES6 syntax. When compiling with <code>-t ES3</code> or <code>-t ES5</code> a module format must be chosen using <code>-m CommonJS</code> or <code>-m AMD</code>. When compiling with <code>-t ES6</code> the module format is implicitly assumed to be <code>ECMAScript 6</code> and the compiler simply emits the original code with type annotations removed. When compiling down-level for <code>CommonJS</code> or <code>AMD</code>, named exports are emitted as properties on the loader supplied exports instance. This includes default exports which are emitted as assignments to exports.default.</p>
+</div>
+</blockquote>
+</div>
+<div class="paragraph">
+<p>Consider the following module <code>src.ts</code> :</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>export var value = 100; //&lt;--- ES6 syntax
+
+export function inc() {  //&lt;--- ES6 syntax
+    value++;
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Compiling it to <code>SystemJS</code> format produces :</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>System.register([], function(exports_1) {
+    var value;
+    function inc() {
+        (exports_1("value", ++value) - 1);
+    }
+    exports_1("inc", inc);
+    return {
+        setters:[],
+        execute: function() {
+            exports_1("value", value = 100); //&lt;--- ES6 syntax
+        }
+    }
+});</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Compiling it to <code>CommonJS</code> format produces :</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>exports.value = 100; //&lt;--- ES6 syntax
+function inc() {
+    exports.value++;
+}
+exports.inc = inc;</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Compiling it to <code>AMD</code> format produces :</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>define(["require", "exports"], function (require, exports) {
+    exports.value = 100; //&lt;--- ES6 syntax
+    function inc() {
+        exports.value++;
+    }
+    exports.inc = inc;
+});</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Compiling it to <code>UMD</code> format produces :</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>(function (deps, factory) {
+    if (typeof module === 'object' &amp;&amp; typeof module.exports === 'object') {
+        var v = factory(require, exports); if (v !== undefined) module.exports = v;
+    }
+    else if (typeof define === 'function' &amp;&amp; define.amd) {
+        define(deps, factory);
+    }
+})(["require", "exports"], function (require, exports) {
+    exports.value = 100; //&lt;--- ES6 syntax
+    function inc() {
+        exports.value++;
+    }
+    exports.inc = inc;
+});</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>NOTE :</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Visual Studio 2015 does not <a href="http://visualstudio.uservoice.com/forums/121579-visual-studio/suggestions/7017377-support-for-es6-modules">support</a> ES6 modules at this time.</p>
+</li>
+<li>
+<p><code>SystemJS</code> supports <code>TypeScript</code> as a compiler. This implies <code>TypeScript</code> modules can be transpiled to be used with <code>SystemJS</code> as the module loader.</p>
+</li>
+</ol>
+</div>
+</div>
+</div>
+<div class="sect2 language-js">
+<h3 id="sec:Cyclic_Dependencies"><a class="anchor" href="#sec:Cyclic_Dependencies"></a><a class="link" href="#sec:Cyclic_Dependencies">B.5. Cyclic Dependencies</a></h3>
+<div class="paragraph">
+<p>To better analyse and evaluate <code>SystemJS</code> module loader and different module formats, let’s look at a cyclic dependency example from a (extremely simplified) stdlib task <code>FixedPoint6</code>. The outline for the example is :</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Prepare 2 ES6 modules with a circular dependency.</p>
+</li>
+<li>
+<p>Then transpile these modules to different module formats (e.g. <code>AMD</code>, &amp; <code>SystemJS</code>).</p>
+</li>
+<li>
+<p>With <code>SystemJS</code> as the module loader, execute the test for every transpiled module format.</p>
+</li>
+</ol>
+</div>
+<div class="sect3">
+<h4 id="sec:Setup"><a class="anchor" href="#sec:Setup"></a><a class="link" href="#sec:Setup">B.5.1. Setup</a></h4>
+<div class="paragraph">
+<p>Consider the following ES6 listings:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>RoundingMode</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>export default {
+    FLOOR : "FLOOR",
+    CEILING : "CEILING"
+}</code></pre>
+</div>
+</div>
+</li>
+<li>
+<p>MathContext</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import { default as FixedPoint6 } from "FixedPoint6";
+import { default as RoundingMode } from "RoundingMode";
+
+let MathContext = class {
+    constructor(mode) {
+        this.mode = mode;
+    }
+
+    divide(fp1, fp2) {
+        var quotient = FixedPoint6.getQuotient(fp1, fp2);
+
+        if(this.mode === RoundingMode.CEILING) {
+            return new FixedPoint6(Math.ceil(quotient));
+        } else if(this.mode === RoundingMode.FLOOR) {
+            return new FixedPoint6(Math.floor(quotient));
+        } else {
+            throw new Error("Incorrect RoundingMode");
+        }
+    }
+}
+
+MathContext.FLOOR = new MathContext(RoundingMode.FLOOR);
+MathContext.CEILING = new MathContext(RoundingMode.CEILING);
+
+export default MathContext;</code></pre>
+</div>
+</div>
+</li>
+<li>
+<p>FixedPoint6</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import { default as MathContext } from "MathContext";
+
+export default class FixedPoint6 {
+    constructor(number) {
+        this.value = number;
+    }
+
+    static getQuotient(fp1, fp2) {
+        return fp1.value/fp2.value;
+    }
+
+    divide(fp) {
+        return FixedPoint6.defaultContext.divide(this, fp);
+    }
+}
+
+FixedPoint6.defaultContext = MathContext.FLOOR;</code></pre>
+</div>
+</div>
+</li>
+<li>
+<p>Test</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import { default as FixedPoint6 } from "FixedPoint6";
+import { default as MathContext } from "MathContext";
+import { default as RoundingMode } from 'RoundingMode';
+
+var fp1 = new FixedPoint6(20.5);
+var fp2 = new FixedPoint6(10);
+
+var fp3 = fp1.divide(fp2);
+console.log(fp1, fp2, fp3);</code></pre>
+</div>
+</div>
+</li>
+<li>
+<p>Runner : This is the runner file to execute the test (after transpilation).</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>var System = require('systemjs');
+System.transpiler = 'babel';
+
+System.config({
+    baseURL: './build',
+    "paths": {
+        "*": "*.js"
+    }
+});
+
+System.import('test').catch(function(e) {
+    console.log(e);
+})</code></pre>
+</div>
+</div>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>Clearly <code>MathContext</code> &amp; <code>FixedPoint6</code> have a circular dependency upon each other.</p>
+</div>
+</div>
+<div class="sect3 language-js">
+<h4 id="sec:Transpile_and_Execute"><a class="anchor" href="#sec:Transpile_and_Execute"></a><a class="link" href="#sec:Transpile_and_Execute">B.5.2. Transpile and Execute</a></h4>
+<div class="paragraph">
+<p>Transpile the above setup to different formats and execute the code using <code>SystemJS</code> module loader :</p>
+</div>
+<div class="sect4">
+<h5 id="sec:Module_Format___AMD"><a class="anchor" href="#sec:Module_Format___AMD"></a><a class="link" href="#sec:Module_Format___AMD">B.5.2.1. Module Format = AMD</a></h5>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Compile the previous set up using <code>babel</code> as the transpiler with <code>AMD</code> modules :</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>babel src -w --out-dir build --modules amd</code></pre>
+</div>
+</div>
+</li>
+<li>
+<p>Run the transpiled <code>test.js</code> with :</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>node runner.js</code></pre>
+</div>
+</div>
+</li>
+<li>
+<p>The execution would fail with an error like the following :</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>Error: _FixedPoint62.default.getQuotient is not a function</code></pre>
+</div>
+</div>
+</li>
+</ol>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Module_Format___CommonJS"><a class="anchor" href="#sec:Module_Format___CommonJS"></a><a class="link" href="#sec:Module_Format___CommonJS">B.5.2.2. Module Format = CommonJS</a></h5>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Compile the previous set up using <code>babel</code> as the transpiler with <code>CommonJS</code> modules :</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>babel src -w --out-dir build --modules common</code></pre>
+</div>
+</div>
+</li>
+<li>
+<p>Run the transpiled <code>test.js</code> with :</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>node runner.js</code></pre>
+</div>
+</div>
+</li>
+<li>
+<p>The execution is successful and logs the following results :</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>{ value: 20.5 } { value: 10 } { value: 2 }</code></pre>
+</div>
+</div>
+</li>
+</ol>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Module_Format___SystemJS"><a class="anchor" href="#sec:Module_Format___SystemJS"></a><a class="link" href="#sec:Module_Format___SystemJS">B.5.2.3. Module Format = SystemJS</a></h5>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Compile the previous set up using <code>babel</code> as the transpiler with <code>SystemJS</code> modules :</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>babel src -w --out-dir build --modules system</code></pre>
+</div>
+</div>
+</li>
+<li>
+<p>Run the transpiled <code>test.js</code> with :</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>node runner.js</code></pre>
+</div>
+</div>
+</li>
+<li>
+<p>The execution is successful and logs the following results :</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>{ value: 20.5 } { value: 10 } { value: 2 }</code></pre>
+</div>
+</div>
+</li>
+</ol>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Conclusion"><a class="anchor" href="#sec:Conclusion"></a><a class="link" href="#sec:Conclusion">B.5.3. Conclusion</a></h4>
+<div class="paragraph">
+<p>As observed, the test is executed successfully with <code>CommonJS</code> &amp; <code>SystemJS</code> module formats. It however fails with <code>AMD</code> format (due to the circular dependency).</p>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="system.register-as-transpilation-target"><a class="anchor" href="#system.register-as-transpilation-target"></a><a class="link" href="#system.register-as-transpilation-target">B.6. System.register as transpilation target</a></h3>
+<div class="paragraph">
+<p>In order to integrate <code>SystemJS</code> as the module loader, the recommended module format is <code>System.register</code>. This section serves as a guide (&amp; implementation hint) to transpile N4JS modules with <code>System.register</code> as the module format.</p>
+</div>
+<div class="sect3">
+<h4 id="sec:Introduction"><a class="anchor" href="#sec:Introduction"></a><a class="link" href="#sec:Introduction">B.6.1. Introduction</a></h4>
+<div class="paragraph">
+<p>This format is best explained from its <a href="https://github.com/ModuleLoader/es6-module-loader/blob/master/docs/system-register.md">documentation</a> :</p>
+</div>
+<div class="quoteblock">
+<blockquote>
+<div class="paragraph">
+<p>System.register can be considered as a new module format designed to support the exact semantics of ES6 modules within ES5. It is a format that was developed out of collaboration and is supported as a module output in Traceur (as instantiate), Babel and TypeScript (as system). All dynamic binding and circular reference behaviors supported by ES6 modules are supported by this format. In this way it acts as a safe and comprehensive target format for the polyfill path into ES6 modules.</p>
+</div>
+<div class="paragraph">
+<p>To run the format, a suitable loader implementation needs to be used that understands how to execute it. Currently these include SystemJS, SystemJS Self-Executing Bundles and ES6 Micro Loader. The ES6 Module Loader polyfill also uses this format internally when transpiling and executing ES6.</p>
+</div>
+</blockquote>
+</div>
+<div class="paragraph">
+<p>The <code>System.register</code> format is not very well documented. However, this format is supported by all major transpilers out there i.e. <code>BabelJS</code>, <code>Traceur</code> &amp; <code>TypeScript</code> transpilers. In fact, the primary resource of this documentation has been the outputs generated by these transpilers.</p>
+</div>
+<div class="sect4">
+<h5 id="sec:External_Transpilers"><a class="anchor" href="#sec:External_Transpilers"></a><a class="link" href="#sec:External_Transpilers">B.6.1.1. External Transpilers</a></h5>
+<div class="paragraph">
+<p>In order to follow along, it will be best to try out different ES6 syntax being transpiled to <code>System.register</code> format by these transpilers.</p>
+</div>
+<div class="paragraph">
+<p>The following instructions will be useful :</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Transpile with Traceur</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-bash" data-lang="bash">traceur --dir &lt;SOURCE_DIR&gt; &lt;OUTPUT_DIR&gt; --experimental --modules=instantiate</code></pre>
+</div>
+</div>
+</li>
+<li>
+<p>Transpile with Babel</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-bash" data-lang="bash">babel &lt;SOURCE_DIR&gt; --out-dir &lt;OUTPUT_DIR&gt; --modules system</code></pre>
+</div>
+</div>
+</li>
+<li>
+<p>Transpile with TypeScript</p>
+<div class="paragraph">
+<p>Create a file by the name of <code>tsconfig.json</code> in the project folder, with the following contents :</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-json" data-lang="json">{
+    "compilerOptions": {
+        "module": "system",
+        "target": "ES5",
+        "outDir": &lt;OUTPUT_DIR&gt;,
+        "rootDir": &lt;SOURCE_DIR&gt;
+    }
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Then transpile with :</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-javascript" data-lang="javascript">tsc</code></pre>
+</div>
+</div>
+</li>
+</ol>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Example_of_a_System_register_module"><a class="anchor" href="#sec:Example_of_a_System_register_module"></a><a class="link" href="#sec:Example_of_a_System_register_module">B.6.1.2. Example of a System.register module</a></h5>
+<div class="paragraph">
+<p>For the following ES6 code :</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-javascript" data-lang="javascript">import { p as q } from './dep';
+
+var s = 'local';
+
+export function func() {
+    return q;
+}
+
+export class C {}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>The <code>Babel</code> transpiler generates the following code (w/ <code>System.register</code> format):</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-javascript" data-lang="javascript">System.register(['./dep'], function (_export) {
+    'use strict';
+
+    var q, s, C;
+
+    _export('func', func);
+
+    function _classCallCheck(instance, Constructor) { .. }
+
+    function func() {
+        return q;
+    }
+
+    return {
+        setters: [function (_dep) {
+            q = _dep.p;
+        }],
+        execute: function () {
+            s = 'local';
+
+            C = function C() {
+                _classCallCheck(this, C);
+            };
+
+            _export('C', C);
+        }
+    };
+});</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Structure_of_a_System_register_module"><a class="anchor" href="#sec:Structure_of_a_System_register_module"></a><a class="link" href="#sec:Structure_of_a_System_register_module">B.6.2. Structure of a System.register module</a></h4>
+<div class="paragraph">
+<p>Broadly speaking, a <code>System.register</code> module has the following structure :</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-javascript" data-lang="javascript">System.register(&lt;&lt;DEPENDENCIES ARRAY&gt;&gt;, function(&lt;&lt;exportFn&gt;&gt;) {
+    &lt;&lt;DECLARATION SCOPE&gt;&gt;
+
+    return {
+        setters: &lt;&lt;SETTERS ARRAY&gt;&gt;,
+        execute: function() {
+            &lt;&lt;EXECUTABLES&gt;&gt;
+        }
+    };
+});</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Highlights :</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>System.register(&#8230;&#8203;)</code> is called with 2 arguments :</p>
+<div class="ulist">
+<ul>
+<li>
+<p><code>&lt;&lt;DEPENDENCIES ARRAY&gt;&gt;</code> : an array of dependencies (similar to <code>AMD</code>) extracted from the <code>ES6 import</code> statements.</p>
+</li>
+<li>
+<p>a function (<code>FN</code>) :</p>
+<div class="ulist">
+<ul>
+<li>
+<p>accepts a parameter called <code>&lt;&lt;exportFn&gt;&gt;</code>. This <code>&lt;&lt;exportFn&gt;&gt;</code> (provided by <code>SystemJS</code>) keeps a track of all the exports of this module &amp; will inform all the importing modules of any changes.</p>
+</li>
+<li>
+<p>contains a <code>&lt;&lt;DECLARATION SCOPE&gt;&gt;</code> where all the functions and variables (from the source code) get hoisted to.</p>
+</li>
+<li>
+<p>returns an object with 2 properties :</p>
+<div class="ulist">
+<ul>
+<li>
+<p><code>setters</code> : The <code>&lt;&lt;SETTERS ARRAY&gt;&gt;</code> is simply an array of functions. Each of these functions represents the imported-bindings from the <code>&lt;&lt;DEPENDENCIES ARRAY&gt;&gt;</code>. The <code>&lt;&lt;SETTERS ARRAY&gt;&gt;</code> and <code>&lt;&lt;DEPENDENCIES ARRAY&gt;&gt;</code> follow the same order.</p>
+</li>
+<li>
+<p><code>execute</code> : <code>&lt;&lt;EXECUTABLES&gt;&gt;</code> is the rest of the body of the source code.</p>
+</li>
+</ul>
+</div>
+</li>
+</ul>
+</div>
+</li>
+</ul>
+</div>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_transpilation-hints"><a class="anchor" href="#_transpilation-hints"></a><a class="link" href="#_transpilation-hints">B.6.3. Transpilation Hints</a></h4>
+<div class="paragraph">
+<p>By observing the existing transpilers’ output, this sub-section provides insights into the process of transpiling to this format :</p>
+</div>
+<div class="sect4">
+<h5 id="sec:Handling_Imports"><a class="anchor" href="#sec:Handling_Imports"></a><a class="link" href="#sec:Handling_Imports">B.6.3.1. Handling Imports</a></h5>
+<div class="paragraph">
+<p>The following are ES6 code snippets with some <code>import</code> statements :</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Simple Import Statement</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-javascript" data-lang="javascript">import {b1} from 'B';</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>A valid <code>System.register</code> output for this snippet would look like :</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>System.register(['B'], function (&lt;&lt;exportFn&gt;&gt;) { //(1.)
+
+  var b1;  //(2.)
+
+  return {
+
+    //(3.)
+    setters: [function (_B) {
+      b1 = _B.b1; //(4.)
+    }],
+
+    execute: function () {}
+  };
+});</code></pre>
+</div>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+highlights
+</td>
+<td class="hdlist2">
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>The <code>&lt;&lt;DEPENDENCIES ARRAY&gt;&gt;</code> is just <code>[’B’]</code>.</p>
+</li>
+<li>
+<p>The <code>&lt;&lt;DECLARATION SCOPE&gt;&gt;</code> simply declares the imported binding <code>v1</code> as a variable.</p>
+</li>
+<li>
+<p>The <code>&lt;&lt;SETTERS ARRAY&gt;&gt;</code> has 1 function. This function corresponds to the single dependency (<code>’B’</code>) from (1.)</p>
+</li>
+<li>
+<p>The setter function accepts one argument (the exported object from <code>’B’</code> as <code>_B</code> . It then sets the local binding (i.e. local variable <code>v1</code>) to <code>_B.b1</code>.</p>
+</li>
+</ol>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Takeaway
+</td>
+<td class="hdlist2">
+<div class="ulist">
+<ul>
+<li>
+<p>An <code>import</code> statement is broken down into <code>&lt;&lt;DEPENDENCIES ARRAY&gt;&gt;</code> &amp; <code>&lt;&lt;SETTERS ARRAY&gt;&gt;</code>.</p>
+</li>
+<li>
+<p>Whenever the value of <code>b1</code> inside <code>B</code> is changed, <code>SystemJS</code> will execute the corresponding <code>setter function</code> in this module i.e. the 1st function in this case.</p>
+</li>
+</ul>
+</div>
+</td>
+</tr>
+</table>
+</div>
+</li>
+<li>
+<p>Multiple Import Statements</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import { a1 as a0 } from 'A';
+import {b1} from 'B';
+import { c1 as c0 } from 'C';
+import {b2, b3} from 'B';
+import {default} from 'C';
+import {a2} from 'A';</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>A valid <code>System.register</code> output for this snippet would look like :</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>System.register(['A', 'B', 'C'], function (&lt;&lt;exportFn&gt;&gt;) { //(1.)
+
+  var a0, a2, b1, b2, b3, c0, default;  //(2.)
+
+  return {
+
+    //(3.)
+    setters: [function (_A) {
+      a0 = _A.a1;         //(4.1.)
+      a2 = _A.a2;         //(4.2.)
+    }, function (_B) {
+      b1 = _B.b1;
+      b2 = _B.b2;
+      b3 = _B.b3;
+    }, function (_C) {
+      c0 = _C.c1;
+      default = _C['default'];
+    }],
+
+
+    execute: function () {}
+  };
+});</code></pre>
+</div>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+highlights
+</td>
+<td class="hdlist2">
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>The <code>&lt;&lt;DEPENDENCIES ARRAY&gt;&gt;</code> is now a unique array <code>[’A’, ’B’, ’C’]</code>. Note that there are no duplicates.</p>
+</li>
+<li>
+<p>The <code>&lt;&lt;DECLARATION SCOPE&gt;&gt;</code> simply declares all the imported bindings as variables.</p>
+</li>
+<li>
+<p>The <code>&lt;&lt;SETTERS ARRAY&gt;&gt;</code> now has 3 functions. These 3 functions match the ordering of the <code>&lt;&lt;DEPENDENCIES ARRAY&gt;&gt;</code>.</p>
+</li>
+<li>
+<p>The setter function accepts one argument (the exported object from the dependency) It then sets the local bindings (i.e. local variables) from the exported value of the dependency.</p>
+</li>
+</ol>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Takeaway
+</td>
+<td class="hdlist2">
+<div class="ulist">
+<ul>
+<li>
+<p>Whenever an exported value from <code>A</code> is changed, <code>SystemJS</code> will execute the first <code>setter function</code> in this module.</p>
+</li>
+<li>
+<p>Whenever an exported value from <code>B</code> is changed, <code>SystemJS</code> will execute the second <code>setter function</code> in this module.</p>
+</li>
+<li>
+<p>Whenever an exported value from <code>C</code> is changed, <code>SystemJS</code> will execute the third <code>setter function</code> in this module.</p>
+</li>
+</ul>
+</div>
+</td>
+</tr>
+</table>
+</div>
+</li>
+</ol>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:__exportFn__"><a class="anchor" href="#sec:__exportFn__"></a><a class="link" href="#sec:__exportFn__">B.6.3.2. &lt;&lt;exportFn&gt;&gt;</a></h5>
+<div class="paragraph">
+<p>Before moving on to handling exports, let’s focus on the SystemJS provided <code>&lt;&lt;exportFn&gt;&gt;</code>.</p>
+</div>
+<div class="paragraph">
+<p>This function looks similar to the following :</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>function (name, value) {     //(1.)
+      module.locked = true;
+
+      if (typeof name == 'object') {
+        for (var p in name)
+          exports[p] = name[p];      //(2.1.)
+      }
+      else {
+        exports[name] = value;      //(2.2.)
+      }
+
+      for (var i = 0, l = module.importers.length; i &lt; l; i++) {
+        var importerModule = module.importers[i];
+        if (!importerModule.locked) {
+          var importerIndex = indexOf.call(importerModule.dependencies, module);
+          importerModule.setters[importerIndex](exports);     //(3.)
+        }
+      }
+
+      module.locked = false;
+      return value; //(4.)
+}</code></pre>
+</div>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+highlights
+</td>
+<td class="hdlist2">
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>The <code>&lt;&lt;exportFn&gt;&gt;</code> takes 2 arguments : <code>name</code> &amp; <code>value</code>.</p>
+</li>
+<li>
+<p>It maintains an <code>exports</code> object with <code>name</code> &amp; <code>value</code>.</p>
+</li>
+<li>
+<p>For every module which imports the current module, it executes the corresponding <code>setter function</code>.</p>
+</li>
+<li>
+<p>It returns the <code>value</code>.</p>
+</li>
+</ol>
+</div>
+</td>
+</tr>
+</table>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Takeaway
+</td>
+<td class="hdlist2">
+<p>This <code>&lt;&lt;exportFn&gt;&gt;</code> is responsible for pushing the changes from a module to every importing module thereby implementing the live binding.</p>
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Handling_Exports"><a class="anchor" href="#sec:Handling_Exports"></a><a class="link" href="#sec:Handling_Exports">B.6.3.3. Handling Exports</a></h5>
+<div class="paragraph">
+<p>Now let’s focus on handling <code>export</code> statements.</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Simple Exports Statement</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>export var v =1;
+export function f(){}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>A valid <code>System.register</code> output for this snippet would look like :</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>System.register([], function (_export) {  //(1.)
+
+   //(2.)
+  var v;
+  function f() {}
+
+  _export("f", f); //(4.1)
+
+  return {
+    setters: [],
+
+    //(3.)
+    execute: function () {
+      v = 1;  //(3.1.)
+
+      _export("v", v); //(4.2.)
+    }
+  };
+});</code></pre>
+</div>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+highlights
+</td>
+<td class="hdlist2">
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>The <code>&lt;&lt;exportFn&gt;&gt;</code> is named to as <code>_export</code>. (This is an implementation decision by Babel.) The name should be unique to not conflict with any user-defined variable/function names.</p>
+</li>
+<li>
+<p>The <code>&lt;&lt;DECLARATION SCOPE&gt;&gt;</code> hoists the exported variable <code>v</code> and the function <code>f</code>.</p>
+</li>
+<li>
+<p>The <code>&lt;&lt;EXECUTABLES&gt;&gt;</code> zone now contains the executable code from the source module.</p>
+</li>
+<li>
+<p>Initialise the variable <code>v1</code> with the value extracted from the source. This essentially is the executable part of the module.</p>
+</li>
+<li>
+<p>The <code>export</code> function expression results in a call to the <code>_exports</code> function as: <code>_export(f, f)</code></p>
+</li>
+<li>
+<p>The <code>export</code> statement results in a call to the <code>_export</code> function as: <code>_export(v, v)</code></p>
+</li>
+</ol>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Takeaway
+</td>
+<td class="hdlist2">
+<div class="ulist">
+<ul>
+<li>
+<p>The module’s exports statements are separated from the hoistable and executable statements.</p>
+</li>
+<li>
+<p>All the exported bindings are tracked by wrapping them inside the <code>&lt;&lt;exportFn&gt;&gt;</code>.</p>
+</li>
+</ul>
+</div>
+</td>
+</tr>
+</table>
+</div>
+</li>
+<li>
+<p>Tracking Exported Bindings</p>
+<div class="paragraph">
+<p>To maintain live bindings, <code>SystemJS</code> needs to track any changes to exported bindings in order to call the <code>setter</code> functions of importing modules. Let’s look at an example for that :</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>export var v1 = 1;
+export var v2 = 2;
+export var v3 = 3;
+export function f() {}
+
+v1++; //(1.)
+++v2; //(2.)
+v3 += 5; //(3.)
+f = null; //(4.)</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p><code>Babel</code> output for this snippet looks like :</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>System.register([], function (_export) {
+
+  var v1, v2, v3;
+
+  _export("f", f);
+
+  function f() {}
+
+  return {
+    setters: [],
+
+    execute: function () {
+      v1 = 1;
+
+      _export("v1", v1);
+
+      v2 = 2;
+
+      _export("v2", v2);
+
+      v3 = 3;
+
+      _export("v3", v3);
+
+      _export("v1", v1 += 1); //(1.)
+      _export("v2", v2 += 1); //(2.)
+      _export("v3", v3 += 5); //(3.)
+      _export("f", f = null); //(4.)
+    }
+  };
+});</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p><code>Traceur</code> output for this snippet looks like :</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>System.register([], function($__export) {
+
+  var v1, v2, v3;
+  function f() {}
+
+  $__export("f", f);
+
+  return {
+    setters: [],
+
+    execute: function() {
+      v1 = 1;
+      $__export("v1", v1);
+      v2 = 2;
+      $__export("v2", v2);
+      v3 = 3;
+      $__export("v3", v3);
+
+      ($__export("v1", v1 + 1), v1++); //(1.)
+      $__export("v2", ++v2); //(2.)
+      $__export("v3", v3 += 5); //(3.)
+      $__export("f", f = null); //(4.)
+    }
+  };
+});</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p><code>TypeScript</code> output for this snippet looks like :</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>System.register([], function(exports_1) {
+    var v1, v2, v3;
+    function f() { }
+
+    exports_1("f", f);
+
+    return {
+        setters:[],
+
+        execute: function() {
+            exports_1("v1", v1 = 1);
+            exports_1("v2", v2 = 2);
+            exports_1("v3", v3 = 3);
+
+            (exports_1("v1", ++v1) - 1); //(1.)
+            exports_1("v2", ++v2); //(2.)
+            exports_1("v3", v3 += 5); //(3.)
+            f = null; //(4.)
+        }
+    }
+});</code></pre>
+</div>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+highlights
+</td>
+<td class="hdlist2">
+<div class="ulist">
+<ul>
+<li>
+<p>The re-assignment of <code>v1, v2, v3 and f</code> is wrapped inside a call to the <code>&lt;&lt;exportFn&gt;&gt;</code> with the updated value.</p>
+</li>
+</ul>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Takeaway
+</td>
+<td class="hdlist2">
+<div class="ulist">
+<ul>
+<li>
+<p>While transpiling we need to detect if any exported binding is reassigned. In that case invoke the <code>&lt;&lt;exportFn&gt;&gt;</code> immediately with the new value.</p>
+</li>
+<li>
+<p>Different transpilers perform different optimization tricks, which may be worth looking at.</p>
+</li>
+</ul>
+</div>
+</td>
+</tr>
+</table>
+</div>
+</li>
+<li>
+<p>Exporting a Class extending an imported Class.</p>
+<div class="paragraph">
+<p>Let’s look at the following class declaration :</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import {A} from "A"; //&lt;-- import class A
+
+export class C extends A {}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p><code>Babel</code> output for this snippet looks like :</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>System.register(["A"], function (_export) {
+
+  var A, C;
+
+  var _get = function get(_x, _x2, _x3) { ... };
+
+  function _classCallCheck(instance, Constructor) { ... }
+
+  function _inherits(subClass, superClass) { ... }
+
+  return {
+    setters: [function (_A2) {
+      A = _A2.A;
+    }],
+
+    execute: function () { //(1.)
+      C = (function (_A) {
+        _inherits(C, _A);
+
+        function C() {
+          _classCallCheck(this, C);
+
+          _get(Object.getPrototypeOf(C.prototype), "constructor", this).apply(this, arguments);
+        }
+
+        return C;
+      })(A);
+
+      _export("C", C);
+    }
+  };
+});</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p><code>Traceur</code> output for this snippet looks like :</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>System.register(["A"], function($__export) {
+  var A, C;
+
+  return {
+    setters: [function($__m) {
+      A = $__m.A;
+    }],
+
+    execute: function() { //(1.)
+      C = $traceurRuntime.initTailRecursiveFunction(function($__super) {
+        return $traceurRuntime.call(function($__super) {
+          function C() {
+            $traceurRuntime.superConstructor(C).apply(this, arguments);
+          }
+          return $traceurRuntime.continuation($traceurRuntime.createClass, $traceurRuntime, [C, {}, {}, $__super]);
+        }, this, arguments);
+      })(A);
+      $__export("C", C);
+    }
+  };
+});</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p><code>TypeScript</code> output for this snippet looks like :</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>System.register(["A"], function(exports_1) {
+    var __extends = function(){ ... }
+    var A_1;
+    var C;
+
+    return {
+        setters:[
+            function (A_1_1) {
+                A_1 = A_1_1;
+            }],
+
+        execute: function() { //(1.)
+            C = (function (_super) {
+                __extends(C, _super);
+                function C() {
+                    _super.apply(this, arguments);
+                }
+                return C;
+            })(A_1.A);
+            exports_1("C", C);
+        }
+    }
+});</code></pre>
+</div>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+highlights
+</td>
+<td class="hdlist2">
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Notice how the construction of class <code>C</code> has now been deferred to the <code>&lt;&lt;EXECUTABLES&gt;&gt;</code> zone. It is because <code>C</code> depends on <code>A</code> being imported first.</p>
+</li>
+</ol>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Takeaway
+</td>
+<td class="hdlist2">
+<div class="ulist">
+<ul>
+<li>
+<p>The <code>&lt;&lt;DECLARATION SCOPE&gt;&gt;</code> is for hoisting only independent entities i.e. the ones that do not depend upon any imports. Everything else is moved to the <code>&lt;&lt;EXECUTABLES&gt;&gt;</code> region.</p>
+</li>
+</ul>
+</div>
+</td>
+</tr>
+</table>
+</div>
+</li>
+</ol>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Examples_w__Circular_Dependencies"><a class="anchor" href="#sec:Examples_w__Circular_Dependencies"></a><a class="link" href="#sec:Examples_w__Circular_Dependencies">B.6.4. Examples w/ Circular Dependencies</a></h4>
+<div class="paragraph">
+<p>This section focuses on circular dependencies. The goal is to see how the transpiled output looks like and if the execution is possible.</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="paragraph">
+<p>Source files:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import B from "B";
+
+export default class A {}
+A.b = new B(); //&lt;---</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import A from "A";
+
+export default class B {}
+B.a = new A(); //&lt;---</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Transpiled Outputs (w/ Babel):<br></p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>System.register(["B"], function (_export) {
+  "use strict";
+
+  var B, A;
+
+  function _classCallCheck(instance, Constructor) {...}
+
+  return {
+    setters: [function (_B) {
+      B = _B["default"];
+    }],
+    execute: function () {
+      A = function A() {
+        _classCallCheck(this, A);
+      };
+
+      _export("default", A);
+
+      A.b = new B();
+    }
+  };
+});</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>System.register(["A"], function (_export) {
+  "use strict";
+
+  var A, B;
+
+  function _classCallCheck(instance, Constructor) {...}
+
+  return {
+    setters: [function (_A) {
+      A = _A["default"];
+    }],
+    execute: function () {
+      B = function B() {
+        _classCallCheck(this, B);
+      };
+
+      _export("default", B);
+
+      B.a = new A();
+    }
+  };
+});</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Execution Result<br></p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>var System = require('systemjs');
+
+System.import('A', 'B').then(function(resp) {
+    var a = new A();
+    var b = new B();
+}).catch(function(e) {
+    console.log(e);
+});</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>Babel : [Error: undefined is not a function]</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="paragraph">
+<p>Source files:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import {B} from "B";
+
+export class A extends B{}</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import {A} from "A";
+
+export class B{}
+class C extends A{}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Transpiled Outputs (w/ Babel) :<br></p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>System.register(["B"], function (_export) {
+  "use strict";
+
+  var B, A;
+
+  var _get = function get(_x, _x2, _x3) { ... };
+
+  function _classCallCheck(instance, Constructor) { ... }
+
+  function _inherits(subClass, superClass) {...}
+
+  return {
+    setters: [function (_B2) {
+      B = _B2.B;
+    }],
+    execute: function () {
+      A = (function (_B) {
+        _inherits(A, _B);
+
+        function A() {
+          _classCallCheck(this, A);
+
+          _get(Object.getPrototypeOf(A.prototype), "constructor", this).apply(this, arguments);
+        }
+
+        return A;
+      })(B);
+
+      _export("A", A);
+    }
+  };
+});</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>System.register(["A"], function (_export) {
+  "use strict";
+
+  var A, B, C;
+
+  var _get = function get(_x, _x2, _x3) { ... };
+
+  function _inherits(subClass, superClass) { ... }
+
+  function _classCallCheck(instance, Constructor) { ... }
+
+  return {
+    setters: [function (_A2) {
+      A = _A2.A;
+    }],
+    execute: function () {
+      B = function B() {
+        _classCallCheck(this, B);
+      };
+
+      _export("B", B);
+
+      C = (function (_A) {
+        _inherits(C, _A);
+
+        function C() {
+          _classCallCheck(this, C);
+
+          _get(Object.getPrototypeOf(C.prototype), "constructor", this).apply(this, arguments);
+        }
+
+        return C;
+      })(A);
+    }
+  };
+});</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Execution Result<br></p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>var System = require('systemjs');
+
+System.import('A','B').then(function(resp) {
+    var a = new A();
+}).catch(function(e) {
+    console.log(e);
+});</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>TypeScript : [Error: Cannot read property 'prototype' of undefined]
+Babel : [Error: Super expression must either be null or a function, not undefined]</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="paragraph">
+<p>Source files:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import B from "B";
+
+class A extends B {}
+export default class X {}</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import X from "A";
+
+export default class B {}
+class Y extends X {}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Transpiled Outputs (w/ Babel):<br></p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>System.register(["B"], function (_export) {
+  "use strict";
+
+  var B, A, X;
+
+  var _get = function get(_x, _x2, _x3) { ... };
+
+  function _classCallCheck(instance, Constructor) { ... }
+
+  function _inherits(subClass, superClass) { ... }
+
+  return {
+    setters: [function (_B2) {
+      B = _B2["default"];
+    }],
+    execute: function () {
+      A = (function (_B) {
+        _inherits(A, _B);
+
+        function A() {
+          _classCallCheck(this, A);
+
+          _get(Object.getPrototypeOf(A.prototype), "constructor", this).apply(this, arguments);
+        }
+
+        return A;
+      })(B);
+
+      X = function X() {
+        _classCallCheck(this, X);
+      };
+
+      _export("default", X);
+    }
+  };
+});</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>System.register(["A"], function (_export) {
+  "use strict";
+
+  var X, B, Y;
+
+  var _get = function get(_x, _x2, _x3) { ... };
+
+  function _inherits(subClass, superClass) { ... }
+
+  function _classCallCheck(instance, Constructor) { ... }
+
+  return {
+    setters: [function (_A) {
+      X = _A["default"];
+    }],
+    execute: function () {
+      B = function B() {
+        _classCallCheck(this, B);
+      };
+
+      _export("default", B);
+
+      Y = (function (_X) {
+        _inherits(Y, _X);
+
+        function Y() {
+          _classCallCheck(this, Y);
+
+          _get(Object.getPrototypeOf(Y.prototype), "constructor", this).apply(this, arguments);
+        }
+
+        return Y;
+      })(X);
+    }
+  };
+});</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Execution Result<br></p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>var System = require('systemjs');
+
+System.import('A').then(function(resp) {
+    var a = new A();
+}).catch(function(e) {
+    console.log(e);
+});</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>TypeScript : [Error: Cannot read property 'prototype' of undefined]
+Babel : [[Error: Super expression must either be null or a function, not undefined]]</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:N4JS_Examples_w__Circular_Dependencies"><a class="anchor" href="#sec:N4JS_Examples_w__Circular_Dependencies"></a><a class="link" href="#sec:N4JS_Examples_w__Circular_Dependencies">B.6.5. N4JS Examples w/ Circular Dependencies</a></h4>
+<div class="paragraph">
+<p>In order to improve our precision in conversing and discussing about different kinds of circular dependencies, this section provides the most basic examples of different kinds.</p>
+</div>
+<div class="sect4">
+<h5 id="sec:Unresolved_Cyclic_Dependencies"><a class="anchor" href="#sec:Unresolved_Cyclic_Dependencies"></a><a class="link" href="#sec:Unresolved_Cyclic_Dependencies">B.6.5.1. Unresolved Cyclic Dependencies</a></h5>
+<div class="paragraph">
+<p>Below examples demonstrate cases when cyclic dependency cannot be resolved at all and will cause runtime errors.</p>
+</div>
+<div class="exampleblock">
+<div class="title">Example 5. Circular dependency resolution 1</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import b from "B"
+
+export public var number a = 1;
+export public var number a2 = b + 1;</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import a from "A"
+
+export public var number b = a + 1;</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import a2 from "A"
+console.log(a2); //&lt;-- should be 3. not NaN.</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="exampleblock">
+<div class="title">Example 6. Circular dependency resolution 2</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import B from "B"
+
+export public class A {
+    static a = B.b + 1;
+}</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import A from "A"
+export public class B {
+    static b = 1;
+}
+export public class B2 {
+    static b2 = A.a;
+}</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import B2 from "B"
+console.log(B2.b2); //should log 2</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="exampleblock">
+<div class="title">Example 7. Circular dependency resolution 3</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import B from "B"
+export public class A {
+    B b = new B();
+}</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import A from "A"
+export public class B {
+    A a = new A();
+}</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import A from "A"
+new A(); // should not cause a runtime error.</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Variables___Functions"><a class="anchor" href="#sec:Variables___Functions"></a><a class="link" href="#sec:Variables___Functions">B.6.5.2. Examples with Variables &amp; Functions</a></h5>
+<div class="exampleblock">
+<div class="title">Example 8. Circular dependency resolution 4</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import b_fun from "B"
+
+export public var a2 = b_fun();
+export public var a = 1;</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import a from "A"
+
+export public function b_fun() {
+    return a + 1;
+}</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import a2 from "A"
+console.log(a2); //&lt;-- should be 2. not NaN.</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Classes"><a class="anchor" href="#sec:Classes"></a><a class="link" href="#sec:Classes">B.6.5.3. Examples with Classes</a></h5>
+<div class="exampleblock">
+<div class="title">Example 9. Circular dependency resolution 5</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import B from "B"
+export public class A {
+    static a1 = 1;
+    static a2 = B.b1;
+}</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import A from "A"
+export public class B {
+    static b1 = A.a1;
+}</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import A from "A"
+console.log(A.a1); //should log 1. not an error.</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="exampleblock">
+<div class="title">Example 10. Circular dependency resolution 6</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import B from "B"
+export public class A {
+    static a1 = 1;
+    static a2 = B.b1;
+}</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import A from "A"
+export public class B {
+    static b1 = -1;
+    static b2 = A.a1;
+}</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import A from "A"
+console.log(A.a1);//should log 1. not an error.</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="exampleblock">
+<div class="title">Example 11. Circular dependency resolution 7</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import B from "B"
+export public class A {
+    static a = new B();
+}</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import A from "A"
+export public class B {
+    static b = new A();
+}</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import A from "A"
+new A(); //should succeed.</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Examples_with_SubClassing"><a class="anchor" href="#sec:Examples_with_SubClassing"></a><a class="link" href="#sec:Examples_with_SubClassing">B.6.5.4. Examples with SubClassing</a></h5>
+<div class="exampleblock">
+<div class="title">Example 12. Circular dependency resolution 8</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import B from "B"
+export public class A {}
+export public class C extends B {}</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import A from "A"
+export public class B extends A{}</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import C from "A"
+new C();//should succeed.</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="exampleblock">
+<div class="title">Example 13. Circular dependency resolution 9</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import B from "B"
+export public class A {}
+export public class C {
+    c = new B();
+}</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import A from "A"
+export public class B extends A{}</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import C from "A"
+new C(); //should succeed.</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Miscellaneous"><a class="anchor" href="#sec:Miscellaneous"></a><a class="link" href="#sec:Miscellaneous">B.6.5.5. Miscellaneous</a></h5>
+<div class="exampleblock">
+<div class="title">Example 14. Circular dependency resolution 10</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import B from "B"
+export public class A {}
+new B();</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import A from "A"
+export public class B {}
+new A();</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import A from "A"
+new A() //should succeed.</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="exampleblock">
+<div class="title">Example 15. Circular dependency resolution 11</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import B from "B"
+export public class A {}
+B.b1;</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import A from "A"
+export public class B {
+    static b1;
+}
+new A();</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import A from "A"
+new A() //should succeed.</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_resources"><a class="anchor" href="#_resources"></a><a class="link" href="#_resources">B.6.6. Resources</a></h4>
+<div class="paragraph">
+<p><a href="https://github.com/ModuleLoader/es6-module-loader/blob/master/docs/system-register.md">Wiki</a></p>
+</div>
+</div>
+</div>
+<div class="sect2 language-js">
+<h3 id="sec:CommonJS_as_transpilation_target"><a class="anchor" href="#sec:CommonJS_as_transpilation_target"></a><a class="link" href="#sec:CommonJS_as_transpilation_target">B.7. CommonJS as transpilation target</a></h3>
+<div class="paragraph">
+<p>To provide better compatibility with <code>npm</code> eco-system, we want to transpile <code>N4JS</code> code to <code>CommonJS</code> module format.</p>
+</div>
+<div class="sect3">
+<h4 id="_introduction-2"><a class="anchor" href="#_introduction-2"></a><a class="link" href="#_introduction-2">B.7.1. Introduction</a></h4>
+<div class="paragraph">
+<p>A sample <code>CommonJS</code> module :</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>var lib1 = require("/lib1"); //&lt;-- require
+var lib2 = require("/lib2"); //&lt;-- require
+
+function fn() {
+    //...something using 'lib1' &amp; 'lib2'
+}
+
+exports.usefulFn = fn; //&lt;--exports
+exports.uselessValue = 42; //&lt;--exports</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>The <a href="http://www.commonjs.org/specs/modules/1.0/">CommonJS spec</a> describes the salient features of module format as (quoted verbatim) :</p>
+</div>
+<div class="quoteblock">
+<blockquote>
+<div class="paragraph">
+<p>Module Context</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>In a module, there is a free variable "require", that is a
+function.</p>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p>The "require" function accepts a module identifier.</p>
+</li>
+<li>
+<p>"require" returns the exported API of the foreign module.</p>
+</li>
+<li>
+<p>If there is a dependency cycle, the foreign module may
+not have finished executing at the time it is required by one
+of its transitive dependencies; in this case, the object
+returned by "require" must contain at least the exports
+that the foreign module has prepared before the call to
+require that led to the current module&#8217;s execution.</p>
+</li>
+<li>
+<p>If the requested module cannot be returned, "require"
+must throw an error.</p>
+</li>
+</ol>
+</div>
+</li>
+<li>
+<p>In a module, there is a free variable called "exports",
+that is an object that the module may add its API to as it
+executes.</p>
+</li>
+<li>
+<p>modules must use the "exports" object as the only means
+of exporting.</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>Module Identifiers</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>A module identifier is a String of "terms" delimited by forward
+slashes.</p>
+</li>
+<li>
+<p>A term must be a camelCase identifier, ".", or "..".</p>
+</li>
+<li>
+<p>Module identifiers may not have file-name extensions like ".js".</p>
+</li>
+<li>
+<p>Module identifiers may be "relative" or "top-level". A module
+identifier is "relative" if the first term is "." or "..".</p>
+</li>
+<li>
+<p>Top-level identifiers are resolved off the conceptual module
+name space root.</p>
+</li>
+<li>
+<p>Relative identifiers are resolved relative to the identifier of
+the module in which "require" is written and called.</p>
+</li>
+</ol>
+</div>
+</blockquote>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Transpilation_Hints"><a class="anchor" href="#sec:Transpilation_Hints"></a><a class="link" href="#sec:Transpilation_Hints">B.7.2. Transpilation Hints</a></h4>
+<div class="paragraph">
+<p>This section examines how <code>Babel</code> transpiles <code>ES6</code> modules to <code>CommonJS</code> format. By observing the transpiled output from <code>Babel</code>, we can gather insights for transpiling <code>N4JS</code> modules to <code>CommonJS</code> format.</p>
+</div>
+<div class="sect4">
+<h5 id="sec:Import_Statements"><a class="anchor" href="#sec:Import_Statements"></a><a class="link" href="#sec:Import_Statements">B.7.2.1. Import Statements</a></h5>
+<div class="exampleblock">
+<div class="title">Example 16. Import an entire module (for side effects only)</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import "B";
+console.log(B);</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>"use strict";
+
+require("B");
+console.log(B);</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="exampleblock">
+<div class="title">Example 17. Import single member of a module</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import {b1} from "B";
+b1;</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>"use strict";
+
+var _B = require("B");
+_B.b1;</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="exampleblock">
+<div class="title">Example 18. Import multiple members of a module</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import {b1, b2} from "B";
+b1;
+b2;</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>"use strict";
+
+var _B = require("B");
+
+_B.b1;
+_B.b2;</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="exampleblock">
+<div class="title">Example 19. Import a single member of a module w/ an alias</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import {b3 as b4} from "B";
+b4 + 1;</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>"use strict";
+
+var _B = require("B");
+
+_B.b3 + 1;</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="exampleblock">
+<div class="title">Example 20. Import multiple members of a module w/ aliases</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import {b3 as b4, b5 as b6} from "B";
+b4 + 1;
+b6 + 1;</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>"use strict";
+
+var _B = require("B");
+
+_B.b3 + 1;
+_B.b5 + 1;</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="exampleblock">
+<div class="title">Example 21. Import ALL the bindings of a module</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import * as B from "B";
+console.log(B);</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>"use strict";
+
+function _interopRequireWildcard(obj) {
+    //Babel internally tracks ES6 modules using a flag "__esModule".
+    if (obj &amp;&amp; obj.__esModule) {
+        return obj;
+    } else {
+        //Copy over all the exported members.
+        var newObj = {};
+        if (obj != null) {
+            for (var key in obj) {
+                if (Object.prototype.hasOwnProperty.call(obj, key)) newObj[key] = obj[key];
+            }
+        }
+
+        //Set the "default" as the obj itself (ES6 default export)
+        newObj["default"] = obj;
+        return newObj;
+    }
+}
+
+var _B = require("B");
+
+var B = _interopRequireWildcard(_B);
+
+console.log(B);</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="exampleblock">
+<div class="title">Example 22. Import the default export of a module</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import B from "B";
+console.log(B);</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>"use strict";
+
+//For importing a default export,
+//Babel checks if the obj is an ES6 module or not.
+function _interopRequireDefault(obj) {
+    return obj &amp;&amp; obj.__esModule ? obj : { "default": obj };
+}
+
+var _B = require("B");
+
+var _B2 = _interopRequireDefault(_B);
+
+console.log(_B2["default"]);</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Export_Statements"><a class="anchor" href="#sec:Export_Statements"></a><a class="link" href="#sec:Export_Statements">B.7.2.2. Export Statements</a></h5>
+<div class="exampleblock">
+<div class="title">Example 23. Export a member</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>let a = 1;
+export {a};</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>"use strict";
+
+//Babel makes a note that this is as an ES6 module.
+//This information is later used when this module is imported.
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+var a = 1;
+
+exports.a = a;</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="exampleblock">
+<div class="title">Example 24. Export multiple members</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>let a = 1;
+let b = true;
+
+export {a, b};</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+var a = 1;
+var b = true;
+
+exports.a = a;
+exports.b = b;</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="exampleblock">
+<div class="title">Example 25. Export using alias</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>let a =1;
+export {a as b};</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+var a = 1;
+exports.b = a;</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="exampleblock">
+<div class="title">Example 26. Multiple exports using alias</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>let a = 1, b = 2;
+export {a as A, b as B};</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+var a = 1,
+    b = 2;
+exports.A = a;
+exports.B = b;</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="exampleblock">
+<div class="title">Example 27. Simple default export</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>export default 42;</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = 42; //&lt;-- default export is treated as a special named export
+module.exports = exports["default"]; //&lt;-- IMPORTANT</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="exampleblock">
+<div class="title">Example 28. Default export using an alias</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>let x =10;
+export {x as default};</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+var x = 10;
+exports["default"] = x;
+module.exports = exports["default"];</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="exampleblock">
+<div class="title">Example 29. Default export w/ named export</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>let a = 1;
+export {a};
+export default 42;</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+var a = 1;
+exports.a = a;
+exports["default"] = 42;</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="exampleblock">
+<div class="title">Example 30. Default export a class</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>export default class A  {}</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+
+function _classCallCheck(...) { ... }
+
+var A = function A() {
+  _classCallCheck(this, A);
+};
+
+exports["default"] = A;
+module.exports = exports["default"];</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="exampleblock">
+<div class="title">Example 31. Wildcard re-export</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>export * from "A"</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+
+function _interopExportWildcard(obj, defaults) {
+    var newObj = defaults({}, obj);
+    delete newObj["default"]; //&lt;-- A module's default export can not be re-exported.
+    return newObj;
+}
+
+function _defaults(obj, defaults) {
+    var keys = Object.getOwnPropertyNames(defaults);
+    for (var i = 0; i &lt; keys.length; i++) {
+        var key = keys[i];
+        var value = Object.getOwnPropertyDescriptor(defaults, key);
+        if (value &amp;&amp; value.configurable &amp;&amp; obj[key] === undefined) {
+            Object.defineProperty(obj, key, value);
+        }
+    }
+    return obj;
+}
+
+var _A = require("A");
+
+_defaults(exports, _interopExportWildcard(_A, _defaults));</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="exampleblock">
+<div class="title">Example 32. Specific member re-export</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>export {a1, a2} from "A";</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+
+var _A = require("A");
+
+Object.defineProperty(exports, "a1", {
+  enumerable: true,
+  get: function get() {
+    return _A.a1;
+  }
+});
+Object.defineProperty(exports, "a2", {
+  enumerable: true,
+  get: function get() {
+    return _A.a2;
+  }
+});</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="exampleblock">
+<div class="title">Example 33. Specific member re-export using alias</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>export {a1 as A1, a2 as A2} from "A";</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+
+var _A = require("A");
+
+Object.defineProperty(exports, "A1", {
+  enumerable: true,
+  get: function get() {
+    return _A.a1;
+  }
+});
+Object.defineProperty(exports, "A2", {
+  enumerable: true,
+  get: function get() {
+    return _A.a2;
+  }
+});</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Tracking_Live_Bindings"><a class="anchor" href="#sec:Tracking_Live_Bindings"></a><a class="link" href="#sec:Tracking_Live_Bindings">B.7.2.3. Tracking Live Bindings</a></h5>
+<div class="paragraph">
+<p>As specified in the section about <code>ES6 Modules</code> (<a href="#sec:ES6_Modules">ES6 Modules</a>), <code>ES6 Modules</code> export live immutable bindings. The following listings demonstrate how <code>Babel</code> achieves this.</p>
+</div>
+<div class="exampleblock">
+<div class="title">Example 34. Tracking Live Binding</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>export var a = 1;
+a++;</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+var a = 1;
+exports.a = a;
+exports.a = a += 1; //&lt;-- Exported value is tracked.</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:A_complete_example"><a class="anchor" href="#sec:A_complete_example"></a><a class="link" href="#sec:A_complete_example">B.7.2.4. A complete example</a></h5>
+<div class="paragraph">
+<p>The following listings present a simple but complete example of ES6 export, import and live-binding concepts. It uses 3 simple <code>ES6 modules</code> called <code>A.js, B.js and Main.js</code>. The modules are listed alongside their <code>CommonJS</code> versions generated by <code>Babel</code>.</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>export var a = 1; //&lt;-- exports a number
+
+export function incA() { //&lt;-- exports a function
+    a++;
+}</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+
+exports.incA = incA;
+var a = 1;
+
+exports.a = a;
+
+function incA() {
+    exports.a = a += 1;
+}</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import {incA} from "./A"; //&lt;-- Imports the function from A.js
+
+export function incB() { //&lt;-- Exports a function that calls the imported function from A.js
+    incA();
+}</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+exports.incB = incB;
+
+var _A = require("./A");
+
+function incB() {
+    _A.incA();
+}</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import {a} from "./A"; //&lt;-- Imports the exported number from A.js
+import {incB} from "./B"; //&lt;-- Imports the exported function from B.js
+
+console.log(a); //&lt;-- Prints "1"
+incB(); //&lt;-- This will call the "incA" function of A.js
+console.log(a); //&lt;--Prints "2". The imported value "a" is updated.</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>"use strict";
+
+var _A = require("./A");
+
+var _B = require("./B");
+
+console.log(_A.a);
+_B.incB();
+console.log(_A.a);</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_resources-2"><a class="anchor" href="#_resources-2"></a><a class="link" href="#_resources-2">B.7.3. Resources</a></h4>
+<div class="paragraph">
+<p><a href="http://exploringjs.com/es6/ch_modules.html">Exploring ES6 by Dr. Axel Rauschmayer</a></p>
+</div>
+<div class="paragraph">
+<p><a href="http://www.commonjs.org/specs/modules/1.0/">CommonJS spec</a></p>
+</div>
+<div class="paragraph">
+<p><a href="http://benjamn.github.io/empirenode-2015/">The Importance of import and export</a></p>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="sec:License"><a class="anchor" href="#sec:License"></a><a class="link" href="#sec:License">Appendix C: License</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>This specification and the accompanying materials is made available
+under the terms of the Eclipse Public License v1.0 which accompanies
+this distribution, and is available at <a href="http://www.eclipse.org/legal/epl-v10.html" class="bare">http://www.eclipse.org/legal/epl-v10.html</a></p>
+</div>
+<h3 id="_eclipse-public-license-v-1-0" class="discrete">Eclipse Public License - v 1.0</h3>
+<div class="paragraph">
+<p>THE ACCOMPANYING PROGRAM IS PROVIDED UNDER THE TERMS OF THIS ECLIPSE
+PUBLIC LICENSE (<code>AGREEMENT</code>). ANY USE, REPRODUCTION OR DISTRIBUTION OF
+THE PROGRAM CONSTITUTES RECIPIENT’S ACCEPTANCE OF THIS AGREEMENT.</p>
+</div>
+<h4 id="_1-definitions" class="discrete">1. DEFINITIONS</h4>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><code>Contribution</code> means: </dt>
+<dd>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>in the case of the initial Contributor, the initial code and
+documentation distributed under this Agreement, and</p>
+</li>
+<li>
+<p>in the case of each subsequent Contributor:</p>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p>changes to the Program, and</p>
+</li>
+<li>
+<p>additions to the Program;</p>
+<div class="paragraph">
+<p>where such changes and/or additions to the Program originate from and
+are distributed by that particular Contributor. A Contribution
+’originates’ from a Contributor if it was added to the Program by such
+Contributor itself or anyone acting on such Contributor’s behalf.
+Contributions do not include additions to the Program which:</p>
+</div>
+<div class="olist lowerroman">
+<ol class="lowerroman" type="i">
+<li>
+<p>are separate modules of software distributed in conjunction with the Program
+under their own license agreement, and</p>
+</li>
+<li>
+<p>are not derivative works of the Program.</p>
+</li>
+</ol>
+</div>
+</li>
+</ol>
+</div>
+</li>
+</ol>
+</div>
+</dd>
+<dt class="hdlist1"><code>Contributor</code></dt>
+<dd>
+<p>means any person or entity that distributes the Program.</p>
+</dd>
+<dt class="hdlist1"><code>Licensed Patents</code> </dt>
+<dd>
+<p>mean patent claims licensable by a Contributor
+which are necessarily infringed by the use or sale of its Contribution
+alone or when combined with the Program.</p>
+</dd>
+<dt class="hdlist1"><code>Program</code> </dt>
+<dd>
+<p>means the Contributions distributed in accordance with this
+Agreement.</p>
+</dd>
+<dt class="hdlist1"><code>Recipient</code> </dt>
+<dd>
+<p>means anyone who receives the Program under this
+Agreement, including all Contributors.</p>
+</dd>
+</dl>
+</div>
+<h4 id="_2-grant-of-rights" class="discrete">2. GRANT OF RIGHTS</h4>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Subject to the terms of this Agreement, each Contributor hereby
+grants Recipient a non-exclusive, worldwide, royalty-free copyright
+license to reproduce, prepare derivative works of, publicly display,
+publicly perform, distribute and sublicense the Contribution of such
+Contributor, if any, and such derivative works, in source code and
+object code form.</p>
+</li>
+<li>
+<p>Subject to the terms of this Agreement, each Contributor hereby
+grants Recipient a non-exclusive, worldwide, royalty-free patent license
+under Licensed Patents to make, use, sell, offer to sell, import and
+otherwise transfer the Contribution of such Contributor, if any, in
+source code and object code form. This patent license shall apply to the
+combination of the Contribution and the Program if, at the time the
+Contribution is added by the Contributor, such addition of the
+Contribution causes such combination to be covered by the Licensed
+Patents. The patent license shall not apply to any other combinations
+which include the Contribution. No hardware per se is licensed
+hereunder.</p>
+</li>
+<li>
+<p>Recipient understands that although each Contributor grants the
+licenses to its Contributions set forth herein, no assurances are
+provided by any Contributor that the Program does not infringe the
+patent or other intellectual property rights of any other entity. Each
+Contributor disclaims any liability to Recipient for claims brought by
+any other entity based on infringement of intellectual property rights
+or otherwise. As a condition to exercising the rights and licenses
+granted hereunder, each Recipient hereby assumes sole responsibility to
+secure any other intellectual property rights needed, if any. For
+example, if a third party patent license is required to allow Recipient
+to distribute the Program, it is Recipient’s responsibility to acquire
+that license before distributing the Program.</p>
+</li>
+<li>
+<p>Each Contributor represents that to its knowledge it has sufficient
+copyright rights in its Contribution, if any, to grant the copyright
+license set forth in this Agreement.</p>
+</li>
+</ol>
+</div>
+<h4 id="_3-requirements" class="discrete">3. REQUIREMENTS</h4>
+<div class="paragraph">
+<p>A Contributor may choose to distribute the Program in object code form
+under its own license agreement, provided that:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>it complies with the terms and conditions of this Agreement; and</p>
+</li>
+<li>
+<p>its license agreement:</p>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p>effectively disclaims on behalf of all Contributors all warranties
+and conditions, express and implied, including warranties or conditions
+of title and non-infringement, and implied warranties or conditions of
+merchantability and fitness for a particular purpose;</p>
+</li>
+<li>
+<p>effectively excludes on behalf of all Contributors all liability for
+damages, including direct, indirect, special, incidental and
+consequential damages, such as lost profits;</p>
+</li>
+<li>
+<p>states that any provisions which differ from this Agreement are
+offered by that Contributor alone and not by any other party; and</p>
+</li>
+<li>
+<p>states that source code for the Program is available from such
+Contributor, and informs licensees how to obtain it in a reasonable
+manner on or through a medium customarily used for software exchange.</p>
+</li>
+</ol>
+</div>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>When the Program is made available in source code form:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>it must be made available under this Agreement; and</p>
+</li>
+<li>
+<p>a copy of this Agreement must be included with each copy of the
+Program.</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>Contributors may not remove or alter any copyright notices contained
+within the Program.</p>
+</div>
+<div class="paragraph">
+<p>Each Contributor must identify itself as the originator of its
+Contribution, if any, in a manner that reasonably allows subsequent
+Recipients to identify the originator of the Contribution.</p>
+</div>
+<h4 id="_4-commercial-distribution" class="discrete">4. COMMERCIAL DISTRIBUTION</h4>
+<div class="paragraph">
+<p>Commercial distributors of software may accept certain responsibilities
+with respect to end users, business partners and the like. While this
+license is intended to facilitate the commercial use of the Program, the
+Contributor who includes the Program in a commercial product offering
+should do so in a manner which does not create potential liability for
+other Contributors. Therefore, if a Contributor includes the Program in
+a commercial product offering, such Contributor (<code>Commercial
+Contributor</code>) hereby agrees to defend and indemnify every other
+Contributor (<code>Indemnified Contributor</code>) against any losses, damages
+and costs (collectively <code>Losses</code>) arising from claims, lawsuits and
+other legal actions brought by a third party against the Indemnified
+Contributor to the extent caused by the acts or omissions of such
+Commercial Contributor in connection with its distribution of the
+Program in a commercial product offering. The obligations in this
+section do not apply to any claims or Losses relating to any actual or
+alleged intellectual property infringement. In order to qualify, an
+Indemnified Contributor must: a) promptly notify the Commercial
+Contributor in writing of such claim, and b) allow the Commercial
+Contributor to control, and cooperate with the Commercial Contributor
+in, the defense and any related settlement negotiations. The Indemnified
+Contributor may participate in any such claim at its own expense.</p>
+</div>
+<div class="paragraph">
+<p>For example, a Contributor might include the Program in a commercial
+product offering, Product X. That Contributor is then a Commercial
+Contributor. If that Commercial Contributor then makes performance
+claims, or offers warranties related to Product X, those performance
+claims and warranties are such Commercial Contributor’s responsibility
+alone. Under this section, the Commercial Contributor would have to
+defend claims against the other Contributors related to those
+performance claims and warranties, and if a court requires any other
+Contributor to pay any damages as a result, the Commercial Contributor
+must pay those damages.</p>
+</div>
+<h4 id="_5-no-warranty" class="discrete">5. NO WARRANTY</h4>
+<div class="paragraph">
+<p>EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, THE PROGRAM IS PROVIDED
+ON AN <code>AS IS</code> BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,
+EITHER EXPRESS OR IMPLIED INCLUDING, WITHOUT LIMITATION, ANY WARRANTIES
+OR CONDITIONS OF TITLE, NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR
+A PARTICULAR PURPOSE. Each Recipient is solely responsible for
+determining the appropriateness of using and distributing the Program
+and assumes all risks associated with its exercise of rights under this
+Agreement , including but not limited to the risks and costs of program
+errors, compliance with applicable laws, damage to or loss of data,
+programs or equipment, and unavailability or interruption of operations.</p>
+</div>
+<h4 id="_6-disclaimer-of-liability" class="discrete">6. DISCLAIMER OF LIABILITY</h4>
+<div class="paragraph">
+<p>EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, NEITHER RECIPIENT NOR
+ANY CONTRIBUTORS SHALL HAVE ANY LIABILITY FOR ANY DIRECT, INDIRECT,
+INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING
+WITHOUT LIMITATION LOST PROFITS), HOWEVER CAUSED AND ON ANY THEORY OF
+LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OR
+DISTRIBUTION OF THE PROGRAM OR THE EXERCISE OF ANY RIGHTS GRANTED
+HEREUNDER, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.</p>
+</div>
+<h4 id="_7-general" class="discrete">7. GENERAL</h4>
+<div class="paragraph">
+<p>If any provision of this Agreement is invalid or unenforceable under
+applicable law, it shall not affect the validity or enforceability of
+the remainder of the terms of this Agreement, and without further action
+by the parties hereto, such provision shall be reformed to the minimum
+extent necessary to make such provision valid and enforceable.</p>
+</div>
+<div class="paragraph">
+<p>If Recipient institutes patent litigation against any entity (including
+a cross-claim or counterclaim in a lawsuit) alleging that the Program
+itself (excluding combinations of the Program with other software or
+hardware) infringes such Recipient’s patent(s), then such Recipient’s
+rights granted under Section 2(b) shall terminate as of the date such
+litigation is filed.</p>
+</div>
+<div class="paragraph">
+<p>All Recipient’s rights under this Agreement shall terminate if it fails
+to comply with any of the material terms or conditions of this Agreement
+and does not cure such failure in a reasonable period of time after
+becoming aware of such noncompliance. If all Recipient’s rights under
+this Agreement terminate, Recipient agrees to cease use and distribution
+of the Program as soon as reasonably practicable. However, Recipient’s
+obligations under this Agreement and any licenses granted by Recipient
+relating to the Program shall continue and survive.</p>
+</div>
+<div class="paragraph">
+<p>Everyone is permitted to copy and distribute copies of this Agreement,
+but in order to avoid inconsistency the Agreement is copyrighted and may
+only be modified in the following manner. The Agreement Steward reserves
+the right to publish new versions (including revisions) of this
+Agreement from time to time. No one other than the Agreement Steward has
+the right to modify this Agreement. The Eclipse Foundation is the
+initial Agreement Steward. The Eclipse Foundation may assign the
+responsibility to serve as the Agreement Steward to a suitable separate
+entity. Each new version of the Agreement will be given a distinguishing
+version number. The Program (including Contributions) may always be
+distributed subject to the version of the Agreement under which it was
+received. In addition, after a new version of the Agreement is
+published, Contributor may elect to distribute the Program (including
+its Contributions) under the new version. Except as expressly stated in
+Sections 2(a) and 2(b) above, Recipient receives no rights or licenses
+to the intellectual property of any Contributor under this Agreement,
+whether expressly, by implication, estoppel or otherwise. All rights in
+the Program not expressly granted under this Agreement are reserved.</p>
+</div>
+<div class="paragraph">
+<p>This Agreement is governed by the laws of the State of New York and the
+intellectual property laws of the United States of America. No party to
+this Agreement will bring a legal action under this Agreement more than
+one year after the cause of action arose. Each party waives its rights
+to a jury trial in any resulting litigation.</p>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="sec:Acronyms"><a class="anchor" href="#sec:Acronyms"></a><a class="link" href="#sec:Acronyms">Appendix D: Acronyms</a></h2>
+<div class="sectionbody">
+<table id="AC" class="tableblock frame-all grid-all spread language-bash">
+<colgroup>
+<col style="width: 12.5%;">
+<col style="width: 37.5%;">
+<col style="width: 12.5%;">
+<col style="width: 37.5%;">
+</colgroup>
+<tbody>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>CDep</code></p></td>
+<th class="tableblock halign-center valign-top"><p class="tableblock">Compile-Time Dependency</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>RDep</code></p></td>
+<th class="tableblock halign-center valign-top"><p class="tableblock">Run-Time Dependency</p></th>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>LDep</code></p></td>
+<th class="tableblock halign-center valign-top"><p class="tableblock">Load-Time Dependency</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>IDep</code></p></td>
+<th class="tableblock halign-center valign-top"><p class="tableblock">Initialization-Time Dependency</p></th>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>EDep</code></p></td>
+<th class="tableblock halign-center valign-top"><p class="tableblock">Execution-Time Dependency</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>AC</code></p></td>
+<th class="tableblock halign-center valign-top"><p class="tableblock">Acceptance Criteria</p></th>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>ANTLR</code></p></td>
+<th class="tableblock halign-center valign-top"><p class="tableblock">ANother Tool for Language Recognition</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>API</code></p></td>
+<th class="tableblock halign-center valign-top"><p class="tableblock">Application Programming Interface</p></th>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>AST</code></p></td>
+<th class="tableblock halign-center valign-top"><p class="tableblock">Abstract Syntax Tree</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>ASI</code></p></td>
+<th class="tableblock halign-center valign-top"><p class="tableblock">Automatic Semicolon Insertion</p></th>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>AST</code></p></td>
+<th class="tableblock halign-center valign-top"><p class="tableblock">Abstract Syntax Tree</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>BNF</code></p></td>
+<th class="tableblock halign-center valign-top"><p class="tableblock">Backus-Naur Form</p></th>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>CA</code></p></td>
+<th class="tableblock halign-center valign-top"><p class="tableblock">Content-Assist</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>CSP</code></p></td>
+<th class="tableblock halign-center valign-top"><p class="tableblock">Constraint Satisfaction Problem</p></th>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>CLI</code></p></td>
+<th class="tableblock halign-center valign-top"><p class="tableblock">Command Line Interface</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>DOM</code></p></td>
+<th class="tableblock halign-center valign-top"><p class="tableblock">Document Object Model</p></th>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>DSL</code></p></td>
+<th class="tableblock halign-center valign-top"><p class="tableblock">Domain Specific Language</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>EBNF</code></p></td>
+<th class="tableblock halign-center valign-top"><p class="tableblock">Extended Backus-Naur Form</p></th>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>EMF</code></p></td>
+<th class="tableblock halign-center valign-top"><p class="tableblock">Eclipse Modeling Framework</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>EPL</code></p></td>
+<th class="tableblock halign-center valign-top"><p class="tableblock">Eclipse Public License</p></th>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>FQN</code></p></td>
+<th class="tableblock halign-center valign-top"><p class="tableblock">Fully Qualified Name</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>GLB</code></p></td>
+<th class="tableblock halign-center valign-top"><p class="tableblock">Greatest Lower Bound, also known as <strong>infimum</strong></p></th>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>GPL</code></p></td>
+<th class="tableblock halign-center valign-top"><p class="tableblock">GNU General Public License</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>IDE</code></p></td>
+<th class="tableblock halign-center valign-top"><p class="tableblock">Integrated Development Environment</p></th>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>IDL</code></p></td>
+<th class="tableblock halign-center valign-top"><p class="tableblock">Interface Definition Language</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>LSP</code></p></td>
+<th class="tableblock halign-center valign-top"><p class="tableblock">Liskov Substitution Principle</p></th>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>LUB</code></p></td>
+<th class="tableblock halign-center valign-top"><p class="tableblock">Least Upper Bound, also known as <strong>supremum</strong></p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>N4JS</code></p></td>
+<th class="tableblock halign-center valign-top"><p class="tableblock">NumberFour JavaScript</p></th>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>UI</code></p></td>
+<th class="tableblock halign-center valign-top"><p class="tableblock">User Interface</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>UML</code></p></td>
+<th class="tableblock halign-center valign-top"><p class="tableblock">Unified Modeling Language</p></th>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>VM</code></p></td>
+<th class="tableblock halign-center valign-top"><p class="tableblock">Virtual Machine</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>XML</code></p></td>
+<th class="tableblock halign-center valign-top"><p class="tableblock">Extensible Markup Language</p></th>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>XSLT</code></p></td>
+<th class="tableblock halign-center valign-top"><p class="tableblock"><a href="#XSL">XSL</a> Transformations</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>XSL <a id="XSL"></a></code></p></td>
+<th class="tableblock halign-center valign-top"><p class="tableblock">Extensible Stylesheet Language</p></th>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>WYSIWYG</code></p></td>
+<th class="tableblock halign-center valign-top"><p class="tableblock">What You See Is What You Get</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>WLOG</code></p></td>
+<th class="tableblock halign-center valign-top"><p class="tableblock">without loss of generality</p></th>
+</tr>
+</tbody>
+</table>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_bibliography-and-footnotes"><a class="anchor" href="#_bibliography-and-footnotes"></a><a class="link" href="#_bibliography-and-footnotes">Appendix E: Bibliography and Footnotes</a></h2>
+<div class="sectionbody">
+<div class="openblock bibliography">
+<div class="content">
+<div class="paragraph">
+<p><a id="N4JSSpec"></a>N4JS Project. (2018). <em>N4JS Language Specification</em>. Retrieved from <a href="https://www.eclipse.org/n4js/spec/N4JSSpec.html" class="bare">https://www.eclipse.org/n4js/spec/N4JSSpec.html</a></p>
+</div>
+<div class="paragraph">
+<p><a id="Xpect"></a><em>Xpect, Project Website</em>. Retrieved from <a href="https://projects.eclipse.org/projects/modeling.xpect" class="bare">https://projects.eclipse.org/projects/modeling.xpect</a></p>
+</div>
+<div class="paragraph">
+<p><a id="RFC8259"></a>Bray, Tim. (2017). <em>RFC 8259: The javascript object notation (json) data interchange format</em>. </p>
+</div>
+<div class="paragraph">
+<p><a id="ECMA404"></a>International, ECMA. (2017). <em>Standard ECMA-404, The JSON Data Interchange Syntax</em>. </p>
+</div>
+<div class="paragraph">
+<p><a id="RFC7158"></a>Bray, Tim. (2014). <em>RFC 7158: The JavaScript Object Notation ({JSON}) Data Interchange Format</em>. </p>
+</div>
+<div class="paragraph">
+<p><a id="Ser18"></a>Seriot, Nicolas. (2018). <em>Parsing JSON is a Minefield</em>. Retrieved from <a href="http://seriot.ch/parsing_json.php" class="bare">http://seriot.ch/parsing_json.php</a></p>
+</div>
+<div class="paragraph">
+<p><a id="ECMA15a"></a>ECMA. (2015). <em>ECMAScript 2015 Language Specification</em>. Retrieved from <a href="http://www.ecma-international.org/publications/files/ECMA-ST/Ecma-262.pdf" class="bare">http://www.ecma-international.org/publications/files/ECMA-ST/Ecma-262.pdf</a></p>
+</div>
+<div class="paragraph">
+<p><a id="WhatWGLoader"></a>WhatWG. <em>Loader: A Collection of Interesting Ideas</em>. Retrieved from <a href="http://whatwg.github.io/loader/" class="bare">http://whatwg.github.io/loader/</a></p>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div id="footnotes">
+<hr>
+<div class="footnote" id="_footnote_1">
+<a href="#_footnoteref_1">1</a>. This is not yet implemented as of September 2015; types are still stored in a separate cache, the <code>ASTMetaInfoCache</code>.
+</div>
+<div class="footnote" id="_footnote_2">
+<a href="#_footnoteref_2">2</a>. In the future, the top-down order could become more important if inference of <em>expected</em> types is also integrated into post-processing.
+</div>
+<div class="footnote" id="_footnote_3">
+<a href="#_footnoteref_3">3</a>. The <code class="language-n4js">DeferredTypeRef</code> has replaced the old <code class="language-n4js">ComputedTypeRef</code> that had been used until Summer 2015; those were resolved lazily when the type was actually needed (triggered on demand). For a discussion of this change see <a href="#sec:Type_Inference_combined_with_AST_Traversal__Background">Background</a> and in particular <a href="#tab:typeInferenceBeforeAfter">Comparison of inference of type of AST nodes before / after refactoring.</a>.
+</div>
+<div class="footnote" id="_footnote_4">
+<a href="#_footnoteref_4">4</a>. First, according to the build order.
+</div>
+<div class="footnote" id="_footnote_5">
+<a href="#_footnoteref_5">5</a>. These are not really input values but rather values changed during the following invocation of the IBuilderState that need to be carried over from one invocation to the next.
+</div>
+<div class="footnote" id="_footnote_6">
+<a href="#_footnoteref_6">6</a>. Once the build phase has ended, this copied and modified Xtext index will replace the actual state of the builder state and will be persisted on graceful application shutdown.
+</div>
+<div class="footnote" id="_footnote_7">
+<a href="#_footnoteref_7">7</a>. This set of URIs will contain the URIs of all resources that are available in the copied Xtext index but not yet directly processed by the builder in the current build phase. These URIs will later be used as candidates for all resources that might be marked as affected ones and queued by the builder for forthcoming build phases.
+</div>
+<div class="footnote" id="_footnote_8">
+<a href="#_footnoteref_8">8</a>. This set eventually represents all changes that were made during the current build phase. Note that <code>allChanges</code> might contain resource description deltas that do not represent an actual change, it is processed by the builder but the underlying information stored in the user data is still unchanged.
+</div>
+<div class="footnote" id="_footnote_9">
+<a href="#_footnoteref_9">9</a>. Note that deltas for to-be-deleted resources were already added to <code>allDeltas</code> upfront in step <a href="#itm:processDeleted">Process Deleted</a>.
+</div>
+<div class="footnote" id="_footnote_10">
+<a href="#_footnoteref_10">10</a>. This happens through a call to <code class="language-n4js">CurrentDescriptions#register(Delta)</code>
+</div>
+<div class="footnote" id="_footnote_11">
+<a href="#_footnoteref_11">11</a>. Unlike in step <a href="#itm:enqueueAffectedResources">Enqueue Affected Resources</a>, we now use <code>changedDeltas</code> instead of <code>allDeltas</code> as a basis.
+</div>
+<div class="footnote" id="_footnote_12">
+<a href="#_footnoteref_12">12</a>. One could think of an optimization to only register those types that are not just imported or declared, but whose features are really in use. E.g., in one file another type be imported (and even used as type of variable), but non of its member is used. So changes to these members wouldn’t affect the current resources. However this might miss certain cases. E.g., when a method in the super class is removed and now the method with same signature of a consumed role would be used. The method of the role has no been used before, yet must not be ignored. Thus, currently all super classes, roles and interfaces and referenced classes are added as dependency regardless if their members are called.
+</div>
+<div class="footnote" id="_footnote_13">
+<a href="#_footnoteref_13">13</a>. <a href="https://developer.apple.com/library/mac/documentation/Carbon/Reference/WebKit_JavaScriptCore_Ref/_index.html" class="bare">https://developer.apple.com/library/mac/documentation/Carbon/Reference/WebKit_JavaScriptCore_Ref/_index.html</a>
+</div>
+<div class="footnote" id="_footnote_14">
+<a href="#_footnoteref_14">14</a>. but note that most utility methods obtain the transpiler state automatically; so, most of the time, you won’t need to obtain the state yourself.
+</div>
+<div class="footnote" id="_footnote_15">
+<a href="#_footnoteref_15">15</a>. Currently we use our own fork of Xpect <a href="https://github.com/NumberFour/Xpect" class="bare">https://github.com/NumberFour/Xpect</a> and the respective p2-repository <a href="https://numberfour.github.io/Xpect/updatesite/nightly/" class="bare">https://numberfour.github.io/Xpect/updatesite/nightly/</a>
+</div>
+<div class="footnote" id="_footnote_16">
+<a href="#_footnoteref_16">16</a>. version at the time of writing is Xtext 2.12
+</div>
+<div class="footnote" id="_footnote_17">
+<a href="#_footnoteref_17">17</a>. <a href="https://github.com/eclipse/xtext-core/issues/12" class="bare">https://github.com/eclipse/xtext-core/issues/12</a>
+</div>
+<div class="footnote" id="_footnote_18">
+<a href="#_footnoteref_18">18</a>. Calculates a list of external library projects that have to be build and another list of projects that have to be cleaned.
+</div>
+</div>
+<div id="footer">
+<div id="footer-text">
+Version 0.9<br>
+Last updated 2019-08-07 15:02:40 CEST
+</div>
+</div>
+<!-- ************* docinfo-footer *************************************************************** -->
+<div class="Grid social" style="color:#d5dfea">
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <h2>Quick Links</h2>
+    <ul>
+      <li><a href="../downloads.html">Download</a></li>
+      <li><a href="../userguides/index.html">Documentation</a></li>
+      <li><a href="https://github.com/eclipse/n4js/">Source</a></li>
+      <li><a href="https://github.com/eclipse/n4js/issues">Issues</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="https://www.eclipse.org/forums/index.php/f/365/">Forum</a></li>
+      <li><a href="http://n4js.blogspot.de/">Blog</a></li>
+      <li><a href="https://dev.eclipse.org/mailman/listinfo/n4js-dev">Mailing List</a></li>
+      <li><a href="https://projects.eclipse.org/projects/technology.n4js">Eclipse Project Page</a></li>
+      <li><a href="https://twitter.com/n4jsdev">Tweets by n4jsdev</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="http://www.eclipse.org/">Eclipse Home</a></li>
+      <li><a href="http://www.eclipse.org/legal/privacy.php">Privacy Policy</a></li>
+      <li><a href="http://www.eclipse.org/legal/termsofuse.php">Terms of Use</a></li>
+      <li><a href="http://www.eclipse.org/legal/copyright.php">Copyright Agent</a></li>
+      <li><a href="http://www.eclipse.org/legal/">Legal</a></li>
+    </ul>
+  </div>
+  <div style="clear: both; height: 0; overflow: hidden;"></div>
+</div>
+
+<!-- ************* UI Scripts ************* -->
+<script type="text/javascript" src="scripts/back-to-top.js"></script>
+
+<script type="text/javascript" src="scripts/treeview.js"></script>
+<script type="text/javascript" src="scripts/toc.js"></script>
+
+<!-- ************* Prism.js Syntax Highlighting ************* -->
+<script src="scripts/prism.js"></script>
+
+<script type="text/javascript">
+	// Add the 'toclist' id for search function
+	$(".toc2 > ul").attr('id', 'toclist');
+	// Generate a Search input form
+	$("#toclist > li:first-of-type").before('<input type="text" id="pagesearch" onkeyup="search()" placeholder="Search for section...">');
+	$("#toclist > li:first-of-type").before('<i id="clear" class="fa fa-times-circle-o"></i>');
+	$("#clear").click(function(){
+	    $("#pagesearch").val('');
+	    search();
+	    $('.toc2 > ul').treeView('collapseAll');
+	});
+	// intialize Treeview.js
+	$(".toc2 > ul").treeView();
+	// Initialize Scrollspy
+</script>
+<!-- ************* docinfo-footer *************************************************************** -->
+</body>
+</html>
\ No newline at end of file
diff --git a/design/N4JSDesign.xml b/design/N4JSDesign.xml
new file mode 100644
index 0000000..a0c7824
--- /dev/null
+++ b/design/N4JSDesign.xml
@@ -0,0 +1,12752 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<?asciidoc-toc maxdepth="5"?>
+<?asciidoc-numbered maxdepth="5"?>
+<book xmlns="http://docbook.org/ns/docbook" xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en">
+<info>
+<title>N4JS Design Specification</title>
+<date>2019-08-07</date>
+<author>
+<personname>
+<firstname>2019-08-07 15:02:40 CEST</firstname>
+</personname>
+</author>
+<authorinitials>{</authorinitials>
+<style>
+      .admonitionblock td.icon .icon-todo:before{content:"\f249";color:#f4ee42}
+    </style>
+</info>
+<preface>
+<title></title>
+<simpara role="center"><emphasis role="strong">Last Updated: 2019-08-07</emphasis></simpara>
+<simpara role="center"><emphasis role="strong">Authors:</emphasis><?asciidoc-br?>
+Jens von Pilgrim, Jakub Siberski, Mark-Oliver Reiser, Torsten Krämer, Ákos Kitta, Sebastian Zarnekow, Lorenzo Bettini, Jörg Reichert, Kristian Duske, Marcus Mews, Minh Quang Tran, Luca Beurer-Kellner</simpara>
+<simpara><?asciidoc-pagebreak?></simpara>
+<simpara>This document contains the N4JS Design and Implementation documentation.</simpara>
+<simpara><?asciidoc-pagebreak?></simpara>
+</preface>
+<chapter xml:id="_introduction">
+<title>Introduction</title>
+<simpara>This document describes design aspects of the N4JS compiler and IDE. It relies on the following N4JS related specifications:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>N4JS Language Specification [<link linkend="N4JSSpec">N4JSSpec</link>]</simpara>
+</listitem>
+</itemizedlist>
+<section xml:id="notation">
+<title>Notation</title>
+<simpara>We reuse the notation specified in [<link linkend="N4JSSpec">N4JSSpec</link>].</simpara>
+</section>
+<section xml:id="sec:IDE_Overview">
+<title>IDE Components</title>
+<simpara>The N4JS and N4JSIDE components are organized via features. The following features with included plugins are defined
+(the common prefix "org.eclipse.n4js" is omitted at the plugin name):</simpara>
+<informaltable frame="all" rowsep="1" colsep="1">
+<tgroup cols="3">
+<colspec colname="col_1" colwidth="5.8823*"/>
+<colspec colname="col_2" colwidth="11.7647*"/>
+<colspec colname="col_3" colwidth="82.353*"/>
+<thead>
+<row>
+<entry align="left" valign="top">Feature</entry>
+<entry align="left" valign="top">Plugin</entry>
+<entry align="left" valign="top">Description</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry align="left" valign="top" namest="col_1" nameend="col_2"><simpara><emphasis role="strong">org.eclipse.n4js.lang.sdk</emphasis></simpara></entry>
+<entry align="left" valign="top"><simpara>N4JS core language with parser, validation etc.</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>org.eclipse.n4js</simpara></entry>
+<entry align="left" valign="top"><simpara>Xtext grammar with generator and custom code for N4JS, scoping (and binding) implementation, basic validation (and Xsemantics type system).</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>doc</simpara></entry>
+<entry align="left" valign="top"><simpara>(in doc folder) General documentation (including web page) written in AsciiDoc</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>external.libraries</simpara></entry>
+<entry align="left" valign="top"><simpara>Support for N4JS libraries shipped with the IDE, i.e. core N4JS library and mangelhaft.</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>ui</simpara></entry>
+<entry align="left" valign="top"><simpara>UI components for N4JS, e.g., proposal provider, labels, outline, quickfixes.</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>jsdoc</simpara></entry>
+<entry align="left" valign="top"><simpara>Parser and model for JSDoc</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>external.libraries.update</simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">Not included in feature</emphasis>. Updates the external library plugin</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top" namest="col_1" nameend="col_2"><simpara><emphasis role="strong">org.eclipse.n4js.ts.sdk</emphasis></simpara></entry>
+<entry align="left" valign="top"><simpara>Type System</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>ts</simpara></entry>
+<entry align="left" valign="top"><simpara>Xtext grammar with generator and custom code for type expressions and standalone type definitions.</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>ts.model</simpara></entry>
+<entry align="left" valign="top"><simpara>Xcore based types model with helper classes etc.</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>ts.ui</simpara></entry>
+<entry align="left" valign="top"><simpara>Xtext generated UI for type system, not really used as this TS files are not editable by users.</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top" namest="col_1" nameend="col_2"><simpara><emphasis role="strong">org.eclipse.n4js.unicode.sdk</emphasis></simpara></entry>
+<entry align="left" valign="top"></entry>
+</row>
+<row>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>common.unicode</simpara></entry>
+<entry align="left" valign="top"><simpara>Xtext grammar with generator and custom code used by all other grammars for proper unicode support.</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top" namest="col_1" nameend="col_2"><simpara><emphasis role="strong">org.eclipse.n4js.regex.sdk</emphasis></simpara></entry>
+<entry align="left" valign="top"><simpara>Regular expression grammar and UI, used by N4JS grammar and UI</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>regex</simpara></entry>
+<entry align="left" valign="top"><simpara>Xtext grammar with generator and custom code used by N4JS grammars for regular expressions.</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>regex.ui</simpara></entry>
+<entry align="left" valign="top"><simpara>UI components for regular expressions, e.g., proposal provider, labels, outline, quickfixes.</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top" namest="col_1" nameend="col_2"><simpara><emphasis role="strong">org.eclipse.n4js.sdk</emphasis></simpara></entry>
+<entry align="left" valign="top"><simpara>This feature defines the N4JSIDE. It contains core UI plugins and all includes (almost all) other features!</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>environments</simpara></entry>
+<entry align="left" valign="top"><simpara>Utility plugin, registers n4scheme for EMF proxy resolution.</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>model</simpara></entry>
+<entry align="left" valign="top"><simpara>Xcore based N4JS model with helper classes etc.</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>product</simpara></entry>
+<entry align="left" valign="top"><simpara>N4JSIDE main application.</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>releng.utils</simpara></entry>
+<entry align="left" valign="top"><simpara>(in releng folder) Contains utility classes only used for building the system, e.g., tools for generating antlr based parser with extended features.</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>utils</simpara></entry>
+<entry align="left" valign="top"><simpara>general utilities</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>utils.ui</simpara></entry>
+<entry align="left" valign="top"><simpara>general UI utilities</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top" namest="col_1" nameend="col_2"><simpara><emphasis role="strong">org.eclipse.n4js.compiler.sdk</emphasis></simpara></entry>
+<entry align="left" valign="top"><simpara>Compilers and Transpilers</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>generator.common</simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">Not included in feature, logically associated.</emphasis></simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>generator.headless</simpara></entry>
+<entry align="left" valign="top"><simpara>N4JS headless generator (i.e. command line compiler).</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>transpiler</simpara></entry>
+<entry align="left" valign="top"><simpara>Generic transpiler infrastructure</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>transpiler.es</simpara></entry>
+<entry align="left" valign="top"><simpara>Transpiler to compile to EcmaScript</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top" namest="col_1" nameend="col_2"><simpara><emphasis role="strong">org.eclipse.n4js.json.sdk</emphasis></simpara></entry>
+<entry align="left" valign="top"><simpara>N4JS JSON</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>json</simpara></entry>
+<entry align="left" valign="top"><simpara>Xtext grammar with generator and custom code for a extensible JSON language support. Used in N4JS for the project description in terms of a <literal>package.json</literal> file.</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>json.ui</simpara></entry>
+<entry align="left" valign="top"><simpara>UI components for extensible JSON language support, e.g., proposal provider, labels, outline.</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>json.model</simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">Not included in feature, logically associated.</emphasis> Xcore based model for the JSON language.</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top" namest="col_1" nameend="col_2"><simpara><emphasis role="strong">org.eclipse.n4js.semver.sdk</emphasis></simpara></entry>
+<entry align="left" valign="top"><simpara>Semantic version string support.</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>semver</simpara></entry>
+<entry align="left" valign="top"><simpara>Parser and tools for semantic version strings.</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>semver.ui</simpara></entry>
+<entry align="left" valign="top"><simpara>UI tools for semantic version strings.</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>semver.model</simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">Not included in feature, logically associated.</emphasis> Xcore model of semantic version strings.</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top" namest="col_1" nameend="col_2"><simpara><emphasis role="strong">org.eclipse.n4js.runner.sdk</emphasis></simpara></entry>
+<entry align="left" valign="top"><simpara>Runners for executing N4JS or JavaScript code</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>runner</simpara></entry>
+<entry align="left" valign="top"><simpara>Generic interfaces and helper for runners, i.e. JavaScript engines executing N4JS or JavaScript code.</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>runner.chrome</simpara></entry>
+<entry align="left" valign="top"><simpara>Runner for executing N4JS or JavaScript with Chrome.</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>runner.chrome.ui</simpara></entry>
+<entry align="left" valign="top"><simpara>UI classes for launching the Chrome runner via the org.eclipse.debug.ui</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>runner.nodejs</simpara></entry>
+<entry align="left" valign="top"><simpara>Runner for executing N4JS or JavaScript with node.js.</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>runner.nodejs.ui</simpara></entry>
+<entry align="left" valign="top"><simpara>UI classes for launching the node.js runner via the org.eclipse.debug.ui</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>runner.ui</simpara></entry>
+<entry align="left" valign="top"><simpara>Generic interfaces for configuring N4JS runner via the debug ui.</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top" namest="col_1" nameend="col_2"><simpara><emphasis role="strong">org.eclipse.n4js.tester.sdk</emphasis></simpara></entry>
+<entry align="left" valign="top"><simpara>Runners and UI for tests (via mangelhaft).</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>tester</simpara></entry>
+<entry align="left" valign="top"><simpara>Generic interfaces and helper for testers, i.e. JavaScript engines executing N4JS tests (using mangelhaft).</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>tester.nodejs</simpara></entry>
+<entry align="left" valign="top"><simpara>Tester based on the nodejs runner for executing mangelhaft tests with node.js</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>tester.nodejs.ui</simpara></entry>
+<entry align="left" valign="top"><simpara>UI for showing test results.</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>tester.ui</simpara></entry>
+<entry align="left" valign="top"><simpara>Configuration of tests via the debug UI.</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top" namest="col_1" nameend="col_2"><simpara><emphasis role="strong">org.eclipse.n4js.jsdoc2spec.sdk</emphasis></simpara></entry>
+<entry align="left" valign="top"><simpara>JSDoc 2 Specification</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>jsdoc2spec</simpara></entry>
+<entry align="left" valign="top"><simpara>Exporter to generate API documentation with specification tests awareness</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>jsdoc2spec.ui</simpara></entry>
+<entry align="left" valign="top"><simpara>UI for API doc exporter</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top" namest="col_1" nameend="col_2"><simpara><emphasis role="strong">org.eclipse.n4js.xpect.sdk</emphasis></simpara></entry>
+<entry align="left" valign="top"></entry>
+</row>
+<row>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>xpect</simpara></entry>
+<entry align="left" valign="top"><simpara>Xpect test methods.</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>xpect.ui</simpara></entry>
+<entry align="left" valign="top"><simpara>UI for running Xpext tests methods from the N4JSIDE (for creating bug reports).</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top" namest="col_1" nameend="col_2"><simpara><emphasis role="strong">org.eclipse.n4js.smith.sdk</emphasis></simpara></entry>
+<entry align="left" valign="top"><simpara>Feature for internal N4JS IDE plugins only intended for development (for example, the AST Graph view).</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>smith</simpara></entry>
+<entry align="left" valign="top"><simpara>Non-UI classes for tools for smiths, that is, tools for developers of the N4JS IDE such as AST views etc.</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>smith.ui</simpara></entry>
+<entry align="left" valign="top"><simpara>UI classes for tools for smiths, that is, tools for developers of the N4JS IDE such as AST views etc.</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top" namest="col_1" nameend="col_2"><simpara><emphasis role="strong">org.eclipse.n4js.tests.helper.sdk</emphasis></simpara></entry>
+<entry align="left" valign="top"><simpara>Test helpers.</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top" namest="col_1" nameend="col_2"><simpara><emphasis role="strong">org.eclipse.n4js.dependencies.sdk</emphasis></simpara></entry>
+<entry align="left" valign="top"><simpara>Collection of all external non-ui dependencies, used for local mirroring of update sites.</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top" namest="col_1" nameend="col_2"><simpara><emphasis role="strong">org.eclipse.n4js.dependencies.ui.sdk</emphasis></simpara></entry>
+<entry align="left" valign="top"><simpara>Collection of all external ui dependencies, used for local mirroring of update sites.</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top" namest="col_1" nameend="col_3"><simpara><emphasis role="strong">uncategorized plugins</emphasis></simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>flowgraphs</simpara></entry>
+<entry align="left" valign="top"><simpara>Control and data flow graph model and computer.</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top" namest="col_1" nameend="col_2"><simpara><emphasis role="strong">Fragments</emphasis></simpara></entry>
+<entry align="left" valign="top"><simpara>not associated to features, only listed here for completeness</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>utils.logging</simpara></entry>
+<entry align="left" valign="top"><simpara>Fragment only, configuration for loggers, in particular for the product and for the tests</simpara></entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+<section xml:id="sec:Naming_Conventions">
+<title>Naming Conventions</title>
+<simpara>In the above sections, tests were omitted. We use the following naming conventions (by example) for test and tests helper:</simpara>
+<informaltable tabstyle="horizontal" frame="none" colsep="0" rowsep="0">
+<tgroup cols="2">
+<colspec colwidth="15*"/>
+<colspec colwidth="85*"/>
+<tbody valign="top">
+<row>
+<entry>
+<simpara>project</simpara>
+</entry>
+<entry>
+<simpara>-</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>project.tests</simpara>
+</entry>
+<entry>
+<simpara>tests for project, is a fragment</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>project.tests.helper</simpara>
+</entry>
+<entry>
+<simpara>helper classes used ONLY by tests</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>project.tests.performance</simpara>
+</entry>
+<entry>
+<simpara>performance tests</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>project.tests.integration</simpara>
+</entry>
+<entry>
+<simpara>integration tests</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>project.ui</simpara>
+</entry>
+<entry>
+<simpara>-</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>project.ui.tests</simpara>
+</entry>
+<entry>
+<simpara>tests for ui project, fragment of project.ui</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>project.ui.tests.helper</simpara>
+</entry>
+<entry>
+<simpara>helper classes used ONLY by tests</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>project.ui.tests.performance</simpara>
+</entry>
+<entry>
+<simpara>-</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>tests.helper</simpara>
+</entry>
+<entry>
+<simpara>general test helper</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>ui.tests.helper</simpara>
+</entry>
+<entry>
+<simpara>general ui test helper</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>project.xpect.tests</simpara>
+</entry>
+<entry>
+<simpara>xpect tests for the project, despite dependnecies to UI the can be executed as plain JUnit tests</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>project.xpect.ui.tests</simpara>
+</entry>
+<entry>
+<simpara>xpect tests for the project, need to be executed as eclipse plugin tests</simpara>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+<simpara>Due to Maven, tests are in subfolder tests (incl. helpers), implementation bundles in plugins, and release engineering related bundles in releng.</simpara>
+</section>
+</section>
+</chapter>
+<chapter xml:id="_eclipse-setup">
+<title>Eclipse Setup</title>
+<section xml:id="_system-requirements">
+<title>System Requirements</title>
+<simpara>In all cases, <link xl:href="https://adoptopenjdk.net/">Java 11</link> is required to be installed on your system. <link xl:href="https://nodejs.org/en/download/">Node.js</link> version 10+ is also required, and for some tests you need <link xl:href="https://yarnpkg.com">Yarn</link> to be globally installed.</simpara>
+</section>
+<section xml:id="_contribute">
+<title>Contribute</title>
+<simpara>Eclipse developers who want to develop N4JS itself should use the <link xl:href="https://www.eclipse.org/downloads/">Oomph Eclipse installer</link>. The N4JS project is listed under "Eclipse Projects/N4JS"
+This setup installs the correct Eclipse version, creates a new workspace and clones all projects into it (for details see below).</simpara>
+<section xml:id="_eclipse-installer">
+<title>Eclipse Installer</title>
+<simpara>The recommended way to install the Eclipse IDE and set up the workspace is to use the Eclipse Installer.
+This installer is to be downloaded from <link xl:href="https://wiki.eclipse.org/Eclipse_Installer">https://wiki.eclipse.org/Eclipse_Installer</link></simpara>
+<simpara>Run the installer and apply the following steps:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>change to "Advance Mode" via the menu (upper-right corner) (no need to move the installer)</simpara>
+</listitem>
+<listitem>
+<simpara>select a product, e.g. "Eclipse IDE for Eclipse Committers" with product version "latest"</simpara>
+</listitem>
+<listitem>
+<simpara>double-click the entry <emphasis role="strong">Eclipse Projects/N4JS</emphasis> so that it is shown in the catalog view below</simpara>
+</listitem>
+<listitem>
+<simpara>on the next page, configure paths accordingly. You only have to configure the installation and workspace folder. You may want to use git with https instead of ssh.</simpara>
+</listitem>
+<listitem>
+<simpara>start installation</simpara>
+</listitem>
+</orderedlist>
+<simpara>The installer will then guide you through the rest of the installation. All plug-ins are downloaded and configured automatically, so is the workspace including downloading the git repository and setting up the workspace.</simpara>
+<simpara>The workspace is configured automatically. This includes fetching the necessary git repository. If you have selected git with SSH you may run into problems. In this case you can re-run the scripts and select HTTPS instead, this should work in any case.</simpara>
+<simpara>Eventually the installer scripts are done, that means the git repository has been cloned and the workspace has been configured (including the project set setup).
+Now the automatic build kicks in as you can see in the status bar. Screenshot 6</simpara>
+<simpara>The build will show a lot of errors while still working. Eventually the whole project should have been compiled without any errors. Unfortunately, due to a <link xl:href="https://github.com/eclipse/n4js/issues/1373">known issue</link>, two problems exists. Please have a look at the linked issue on how to fix that (it is quite easy).</simpara>
+<section xml:id="_changing-the-setup-script">
+<title>Changing the Setup Script</title>
+<simpara>The setup scripts is stored at</simpara>
+<simpara><literal>n4js/releng/org.eclipse.n4js.targetplatform/N4JS.setup</literal></simpara>
+<simpara>Details about Oomph-Setup scripts can be found at</simpara>
+<simpara><link xl:href="https://wiki.eclipse.org/Eclipse_Installer">https://wiki.eclipse.org/Eclipse_Installer</link></simpara>
+</section>
+</section>
+<section xml:id="_manual-ide-configuration">
+<title>Manual IDE Configuration</title>
+<warning>
+<simpara>Manual IDE configuration is not recommended!</simpara>
+</warning>
+<simpara>For a manual install, clone the code and import all top-level projects from the docs, features, plugins, releng, testhelpers, and tests folders. Activate the targetplatform contained in the <literal>releng/org.eclipse.n4js.targetplatform/</literal> project.</simpara>
+<simpara>The N4JS IDE is developed with Eclipse 2019-06 or better since the system is based on Eclipse anyway.
+It is almost impossible to use another IDE to develop Eclipse plugins. The list of required plugins includes:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>Xtext/Xtend 2.18.0</simpara>
+</listitem>
+<listitem>
+<simpara>Xcore 1.9.0</simpara>
+</listitem>
+<listitem>
+<simpara>Xpect 0.2.0.201906240918 from <link xl:href="https://ci.eclipse.org/xpect/job/Xpect-Integration-Release/20/artifact/org.eclipse.xpect.releng/p2-repository/target/repository/">https://ci.eclipse.org/xpect/job/Xpect-Integration-Release/20/artifact/org.eclipse.xpect.releng/p2-repository/target/repository/</link></simpara>
+</listitem>
+</itemizedlist>
+<simpara>It is important to use the latest version of Xtext and the corresponding service release of Xcore. You will find the latest version numbers and plugins used in the target platform definition at
+<link xl:href="https://github.com/eclipse/n4js/blob/master/releng/org.eclipse.n4js.targetplatform/org.eclipse.n4js.targetplatform.target">https://github.com/eclipse/n4js/blob/master/releng/org.eclipse.n4js.targetplatform/org.eclipse.n4js.targetplatform.target</link></simpara>
+<simpara>You may need to adjust some settings in Eclipse, most importantly</simpara>
+<itemizedlist>
+<listitem>
+<simpara><emphasis role="strong">Text file encoding</emphasis> to <literal>Other: UTF-8</literal> and</simpara>
+</listitem>
+<listitem>
+<simpara><emphasis role="strong">New text file line delimiter</emphasis> to <literal>Unix</literal> .</simpara>
+</listitem>
+</itemizedlist>
+</section>
+</section>
+</chapter>
+<chapter xml:id="_release-engineering">
+<title>Release Engineering</title>
+<section xml:id="_nightly-build-on-eclipse-infrastructure">
+<title>Nightly build on Eclipse infrastructure</title>
+<simpara>The N4JS IDE, headless n4jsc.jar, and the N4JS update site is being built on the Eclipse Common Build
+Infrastructure (CBI). For this purpose the N4JS project is using a dedicated Jenkins instance, referred
+to as a "Jenkins Instance Per Project" (JIPP) in Eclipse CBI documentation. At this time, the N4JS
+project&#8217;s JIPP is running on the "old" infrastructure, not yet using docker. This will be migrated
+at a later point in time.</simpara>
+<simpara>The N4JS JIPP is available at: <link xl:href="https://ci.eclipse.org/n4js/">https://ci.eclipse.org/n4js/</link></simpara>
+<simpara>The nightly build performs the following main steps:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>compile the N4JS implementation,</simpara>
+</listitem>
+<listitem>
+<simpara>build the n4jsc.jar, the IDE products for MacOS, Windows, Linux, and the update site,</simpara>
+</listitem>
+<listitem>
+<simpara>run tests,</simpara>
+</listitem>
+<listitem>
+<simpara>sign the IDE product for macOS and package it in a .dmg file,</simpara>
+</listitem>
+<listitem>
+<simpara>deploy to n4jsc.jar, IDE products and update sites to Eclipse download server (i.e. download.eclipse.org),</simpara>
+</listitem>
+<listitem>
+<simpara>move all artifacts older than 7 days from download.eclipse.org to archive.eclipse.org.</simpara>
+</listitem>
+</orderedlist>
+<simpara>Details about all the above steps can be found in the Jenkinsfile <literal>eclipse-nightly.jenkinsfile</literal>, located in
+the root folder of the N4JS source repository on GitHub.</simpara>
+<simpara>The most accurate documentation for our JIPP can be found at <link xl:href="https://wiki.eclipse.org/IT_Infrastructure_Doc">https://wiki.eclipse.org/IT_Infrastructure_Doc</link>.
+Note that many other documents do not apply to our JIPP, at the moment, as they refer to the new
+infrastructure, e.g. <link xl:href="https://wiki.eclipse.org/CBI">https://wiki.eclipse.org/CBI</link> and <link xl:href="https://wiki.eclipse.org/Jenkins">https://wiki.eclipse.org/Jenkins</link>.</simpara>
+</section>
+<section xml:id="_build-the-n4js-ide-from-command-line">
+<title>Build the N4JS IDE from command line</title>
+<simpara>Ensure you have</simpara>
+<itemizedlist>
+<listitem>
+<simpara>Java 11</simpara>
+</listitem>
+<listitem>
+<simpara>Maven 3.2.x and</simpara>
+</listitem>
+<listitem>
+<simpara>Node.js 8</simpara>
+</listitem>
+</itemizedlist>
+<simpara>installed on your system.</simpara>
+<simpara>Clone the repository</simpara>
+<screen>git clone https://github.com/Eclipse/n4js.git</screen>
+<simpara>Change to the n4js folder:</simpara>
+<screen>cd n4js</screen>
+<simpara>Run the Maven build:</simpara>
+<screen>mvn clean verify</screen>
+<simpara>You may have to increase the memory for maven via <literal>export MAVEN_OPTS="-Xmx2048m"</literal> (Unix) or <literal>set MAVEN_OPTS="-Xmx2048m"</literal> (Windows).</simpara>
+<simpara>Available optional maven profiles are:</simpara>
+<informaltable tabstyle="horizontal" frame="none" colsep="0" rowsep="0">
+<tgroup cols="2">
+<colspec colwidth="15*"/>
+<colspec colwidth="85*"/>
+<tbody valign="top">
+<row>
+<entry>
+<simpara>buildProduct</simpara>
+</entry>
+<entry>
+<simpara>create IDE products (Windows, macOS, Linux) and a jar for headless compilation</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>execute-plugin-tests</simpara>
+</entry>
+<entry>
+<simpara>run OSGi tests (without UI)</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>execute-plugin-ui-tests</simpara>
+</entry>
+<entry>
+<simpara>run UI-based OSGi tests</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>execute-ecmas-tests</simpara>
+</entry>
+<entry>
+<simpara>run ECMA test suite</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>execute-smoke-tests</simpara>
+</entry>
+<entry>
+<simpara>run generated tests using corrupted source code as input</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>execute-accesscontrol-tests</simpara>
+</entry>
+<entry>
+<simpara>run generated tests for checking accessibility of class/interface members</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>execute-hlc-integration-tests</simpara>
+</entry>
+<entry>
+<simpara>run integration tests using the headless jar (requires docker!)</simpara>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+<simpara>Available system properties:</simpara>
+<informaltable tabstyle="horizontal" frame="none" colsep="0" rowsep="0">
+<tgroup cols="2">
+<colspec colwidth="15*"/>
+<colspec colwidth="85*"/>
+<tbody valign="top">
+<row>
+<entry>
+<simpara>noTests</simpara>
+</entry>
+<entry>
+<simpara>suppress execution of all tests</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>startAndKeepVerdaccio</simpara>
+</entry>
+<entry>
+<simpara>enforce starting and suppress stopping of the test verdaccio (see <xref linkend="sec:test-verdaccio"/>)</simpara>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+<section xml:id="_publish-maven-tooling-literal-org-eclipse-n4js-releng-util-literal">
+<title>Publish maven-tooling <literal>org.eclipse.n4js.releng.util</literal></title>
+<note>
+<simpara>For extending the N4JS-language in a different project, the <literal>org.eclipse.n4js.releng.util</literal> module needs to be published as a maven-plugin. You can deploy this SNAPSHOT-artifact to a local folder by providing the <literal>local-snapshot-deploy-folder</literal>-property pointing to an absolute path in the local file system:</simpara>
+</note>
+<screen>mvn clean deploy -Dlocal-snapshot-deploy-folder=/var/lib/my/folder/local-mvn-deploy-repository</screen>
+<simpara>The existence of <literal>local-snapshot-deploy-folder</literal> will trigger a profile enabling the deploy-goal for the project <literal>org.eclipse.n4js.releng.util</literal></simpara>
+</section>
+<section xml:id="sec:test-verdaccio">
+<title>Test Verdaccio containing n4js-libs</title>
+<simpara>If profile <literal>execute-hlc-integration-tests</literal> is active, a local verdaccio instance is started and populated with
+freshly-compiled n4js-libs (the libraries located under top-level folder <literal>/n4js-libs</literal>) and is stopped before the
+end of the build. The verdaccio instance is started as a docker container called <literal>n4js-test-verdaccio</literal>.</simpara>
+<simpara>When giving <literal>-DstartAndKeepVerdaccio</literal> on the command line, such a test verdaccio will always be started/populated but
+never stopped, regardless of whether profile <literal>execute-hlc-integration-tests</literal> is active or not. This is useful to enforce
+starting of the test verdaccio (even without running integration tests) and then reusing it in subsequent builds.</simpara>
+</section>
+<section xml:id="_generation-of-eclipse-help-for-spec-and-design-document">
+<title>Generation of Eclipse help for spec and design document</title>
+<simpara>The HTML pages for N4JSSpec and N4JSDesign documents are generated from the Asciidoc sources in the project <literal>org.eclipse.n4js.spec</literal> <literal>org.eclipse.n4js.design</literal> by Asciispec. </simpara>
+<figure xml:id="img:eclipse-help-doc-process">
+<title>The process of creating Eclipse help for N4JSSpec</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/03_releng/images/eclipse-help-process.svg"/>
+</imageobject>
+<textobject><phrase>Creating Eclipse help for N4JSSpec</phrase></textobject>
+</mediaobject>
+</figure>
+<simpara>Figure <xref linkend="img:eclipse-help-doc-process"/> shows the generation process for N4JSSpec document. The process for N4JSDesign (and other adoc documents) is the same. The following explains the diagram.</simpara>
+<itemizedlist>
+<listitem>
+<simpara><literal>Asciispec</literal> is used to compile the source N4JSSpec Asciidoc into a single large <literal>N4JSSpec.html</literal> file which contains all the chapters. The use of the custom parameter <literal>-a eclipse-help-mode</literal> indicates that a special header and footer styles as well as CSS style should be used (i.e. no table of content menu, no download links etc.). Here, we are using the possibility provided by Asciidoctor to configure header/footer as well as CSS style via parameter <literal>:docinfodir:</literal> and <literal>:stylesheet:</literal>.</simpara>
+</listitem>
+<listitem>
+<simpara>Our custom tool <literal>Chunker</literal> splits <literal>N4JSSpec.html</literal> (and other documents) into multiple chunked HTML files, each of which corresponds to either the <literal>index</literal> file or a chapter. It automatically re-writes internal links.</simpara>
+</listitem>
+<listitem>
+<simpara>Another custom tool <literal>EclipseHelpTOCGenerator</literal> takes to Docbook file <literal>N4JSSpec.xml</literal> and generates an XML file describing the table of content (TOC) in the Eclipse format. This TOC file references the chunked HTML files above.</simpara>
+</listitem>
+<listitem>
+<simpara>Another custom tool <literal>IndexTocGenerator</literal> takes to Docbook file <literal>N4JSSpec.xml</literal> similar to <literal>EclipseHelpTOCGenerator</literal>, but it generates an HTML fragment which can be embedded into the <literal>index.html</literal> page generated by the <literal>Chunker</literal> (Thus it has to run before the Chunker in that case).</simpara>
+</listitem>
+</itemizedlist>
+</section>
+</section>
+<section xml:id="_updating-frameworks-and-dependencies">
+<title>Updating frameworks and dependencies</title>
+<section xml:id="_update-of-eclipse-emf-xtext-etc">
+<title>Update of Eclipse, EMF, Xtext, etc.</title>
+<simpara>For updating the N4JS IDE to a new version of Eclipse, EMF, Xtext, etc. follow these steps:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>Create a new branch.</simpara>
+</listitem>
+<listitem>
+<simpara>Bump versions of all dependencies mentioned in file <literal>N4JS.setup</literal>:</simpara>
+<orderedlist numeration="loweralpha">
+<listitem>
+<simpara>Update all labels that refer to the version of the Ooomph setup (search for "label!" to find them).</simpara>
+</listitem>
+<listitem>
+<simpara>Choose a new Eclipse version and define this in <literal>N4JS.setup</literal>.</simpara>
+</listitem>
+<listitem>
+<simpara>For those other dependencies <emphasis>that come with Eclipse</emphasis> (e.g. EMF, Xtext) find out which version matches the chosen Eclipse version
+and define that version in <literal>N4JS.setup</literal>.<?asciidoc-br?>
+Tip: use the contents list of the SimRel you are targeting, e.g. <link xl:href="https://projects.eclipse.org/releases/2019-03">https://projects.eclipse.org/releases/2019-03</link></simpara>
+</listitem>
+<listitem>
+<simpara>For those other dependencies <emphasis>that are available via the Eclipse Orbit</emphasis>, find out which version is the latest version available in
+the Orbit and define that version in <literal>N4JS.setup</literal>.<?asciidoc-br?>
+Tip: contents of the Eclipse Orbit can be found at <link xl:href="https://download.eclipse.org/tools/orbit/downloads/">https://download.eclipse.org/tools/orbit/downloads/</link><?asciidoc-br?>
+(choose the correct link for the chosen Eclipse version!)</simpara>
+</listitem>
+<listitem>
+<simpara>For all remaining dependencies (i.e. unrelated to Eclipse and not in Orbit), choose a version to use and define it in <literal>N4JS.setup</literal>.</simpara>
+</listitem>
+</orderedlist>
+</listitem>
+<listitem>
+<simpara>Check <literal>Require-Bundle</literal> sections of MANIFEST.MF files by searching for related bundle names or for <literal>;bundle-version="</literal>:</simpara>
+<orderedlist numeration="loweralpha">
+<listitem>
+<simpara>There should be at most one version constraint for a specific bundle<?asciidoc-br?>
+NOTE: the version constraints in the MANIFEST.MF files are just lower bounds and - at this time - we do not bump them to the latest version, in most cases.</simpara>
+</listitem>
+<listitem>
+<simpara>There should be no version constraints to our bundles (i.e. <literal>org.eclipse.n4js&#8230;&#8203;</literal>)</simpara>
+</listitem>
+</orderedlist>
+</listitem>
+<listitem>
+<simpara>Review parent pom.xml files, i.e. <literal>releng/org.eclipse.n4js.parent/pom.xml</literal>:</simpara>
+<orderedlist numeration="loweralpha">
+<listitem>
+<simpara>Update property <literal>xtext-version</literal>.</simpara>
+</listitem>
+<listitem>
+<simpara>Check all other <literal>*-version</literal> properties and update them where needed.</simpara>
+</listitem>
+</orderedlist>
+</listitem>
+<listitem>
+<simpara>Update target platform file <literal>org.eclipse.n4js.targetplatform.target</literal> using Ooomph&#8217;s auto-generation:</simpara>
+<orderedlist numeration="loweralpha">
+<listitem>
+<simpara>Start the Eclipse Installer.</simpara>
+</listitem>
+<listitem>
+<simpara>Update the Eclipse Installer (using the button with the turning arrows).</simpara>
+</listitem>
+<listitem>
+<simpara>On the second page, add the <literal>N4JS.setup</literal> file from your branch to the Eclipse Installer, using a GitHub raw(!) URL:<?asciidoc-br?>
+<literal><link xl:href="https://raw.githubusercontent.com/eclipse/n4js/BRANCH_NAME/releng/org.eclipse.n4js.targetplatform/N4JS.setup">https://raw.githubusercontent.com/eclipse/n4js/BRANCH_NAME/releng/org.eclipse.n4js.targetplatform/N4JS.setup</link></literal></simpara>
+</listitem>
+<listitem>
+<simpara>Ooomph a new development environment with this setup.</simpara>
+</listitem>
+<listitem>
+<simpara>In the new Eclipse workspace created by Ooomph, the target platform file should have uncommitted changes:</simpara>
+<orderedlist numeration="lowerroman">
+<listitem>
+<simpara>carefully review these changes, to be sure they make sense, and then</simpara>
+</listitem>
+<listitem>
+<simpara>commit &amp; push those changes to your branch.</simpara>
+</listitem>
+</orderedlist>
+</listitem>
+</orderedlist>
+</listitem>
+<listitem>
+<simpara>Thoroughly test the new versions, including some manual(!) tests:</simpara>
+<orderedlist numeration="loweralpha">
+<listitem>
+<simpara>Run Jenkins builds.</simpara>
+</listitem>
+<listitem>
+<simpara>Ooomph another N4JS development environment with Eclipse Installer.
+This time, after Ooomphing is completed, the target platform file should no longer have any uncommitted changes.</simpara>
+</listitem>
+<listitem>
+<simpara>Ensure the following types of tests can be executed locally in the newly installed Eclipse:</simpara>
+<orderedlist numeration="lowerroman">
+<listitem>
+<simpara>plain JUnit tests (e.g. <literal>org.eclipse.n4js.lang.tests</literal>).</simpara>
+</listitem>
+<listitem>
+<simpara>Plugin tests.</simpara>
+</listitem>
+<listitem>
+<simpara>Plugin UI tests.</simpara>
+</listitem>
+<listitem>
+<simpara>SWTBot tests.</simpara>
+</listitem>
+<listitem>
+<simpara>Xpect tests (individual files and entire bundles; e.g. <literal>org.eclipse.n4js.spec.tests</literal>).</simpara>
+</listitem>
+<listitem>
+<simpara>Xpect UI tests.</simpara>
+</listitem>
+</orderedlist>
+</listitem>
+<listitem>
+<simpara>Ensure an N4JS IDE product can be launched from within the newly installed Eclipse using the launch configuration
+provided in the n4js repository.</simpara>
+</listitem>
+<listitem>
+<simpara>After launching the N4JS IDE product, refresh the workspace and review/commit any changes in file <literal>N4JS__IDE.launch</literal>.</simpara>
+</listitem>
+<listitem>
+<simpara>Download a product created in a Jenkins CI build and test it manually.</simpara>
+</listitem>
+<listitem>
+<simpara>After merging to master: download a product created in a nightly build and test it manually.
+Ensure signing and JRE bundling are still working properly.</simpara>
+</listitem>
+</orderedlist>
+</listitem>
+</orderedlist>
+<simpara>All the above steps need to be performed in the <literal>n4js-n4</literal> repository, accordingly (e.g. file <literal>N4JS-N4.setup</literal>).</simpara>
+</section>
+<section xml:id="_update-of-the-embedded-jre">
+<title>Update of the embedded JRE</title>
+<simpara>For updating the embedded JRE inside the N4JS IDE follow these steps:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>Given a new JRE download location for Linux, MacOS and Windows with a common new version</simpara>
+</listitem>
+<listitem>
+<simpara>Update the location related properties in the pom.xml files of</simpara>
+<orderedlist numeration="loweralpha">
+<listitem>
+<simpara>n4js/builds/pom.xml</simpara>
+</listitem>
+<listitem>
+<simpara>n4js/builds/org.eclipse.n4js.jre.linux.gtk.x86_64/pom.xml</simpara>
+</listitem>
+<listitem>
+<simpara>n4js/builds/org.eclipse.n4js.jre.macosx.cocoa.x86_64/pom.xml</simpara>
+</listitem>
+<listitem>
+<simpara>n4js/builds/org.eclipse.n4js.jre.win32.win32.x86_64/pom.xml</simpara>
+</listitem>
+</orderedlist>
+</listitem>
+<listitem>
+<simpara>Update the versions at all following locations:</simpara>
+<orderedlist numeration="loweralpha">
+<listitem>
+<simpara>n4js/builds/org.eclipse.n4js.jre.linux.gtk.x86_64/META-INF/MANIFEST.MF</simpara>
+</listitem>
+<listitem>
+<simpara>n4js/builds/org.eclipse.n4js.jre.linux.gtk.x86_64/META-INF/p2.inf</simpara>
+</listitem>
+<listitem>
+<simpara>n4js/builds/org.eclipse.n4js.jre.macosx.cocoa.x86_64/META-INF/MANIFEST.MF</simpara>
+</listitem>
+<listitem>
+<simpara>n4js/builds/org.eclipse.n4js.jre.macosx.cocoa.x86_64/META-INF/p2.inf</simpara>
+</listitem>
+<listitem>
+<simpara>n4js/builds/org.eclipse.n4js.jre.win32.win32.x86_64/META-INF/MANIFEST.MF</simpara>
+</listitem>
+<listitem>
+<simpara>n4js/builds/org.eclipse.n4js.jre.win32.win32.x86_64/META-INF/p2.inf</simpara>
+</listitem>
+</orderedlist>
+</listitem>
+<listitem>
+<simpara>Update the openjdk docker image used as base image in the "FROM" line at the top of all docker files:</simpara>
+<orderedlist numeration="loweralpha">
+<listitem>
+<simpara>n4js-n4/jenkins/docker-build/Dockerfile</simpara>
+</listitem>
+</orderedlist>
+</listitem>
+</orderedlist>
+</section>
+</section>
+</chapter>
+<chapter xml:id="_tips-and-tricks">
+<title>Tips and Tricks</title>
+<simpara>In this chapter we collect some coding hints and guidelines on how to properly use the APIs of Eclipse, EMF, Xtext and
+other dependencies we are using, as well as our own utilities and helpers.</simpara>
+<simpara>This chapter is only about coding; add information on things like Eclipse setup or Maven/Jenkins to one of the preceding
+chapters. Similarly, this chapter is intended to provide just a quick overview, check-list and reminder; add detailed
+information and diagrams to one of the succeeding chapters.</simpara>
+<section xml:id="_naming">
+<title>Naming</title>
+<itemizedlist>
+<listitem>
+<simpara>The internal handling of N4JS project names is non-trivial (due to the support for npm scopes), see
+API documentation of <literal>ProjectDescriptionUtils#isProjectNameWithScope(String)</literal> for a detailed overview.
+In short:</simpara>
+<itemizedlist>
+<listitem>
+<simpara><literal>IN4JSProject#getProjectName()</literal> and <literal>IProject#getName()</literal> return different values!</simpara>
+</listitem>
+<listitem>
+<simpara>Avoid using the Eclipse project name, i.e. the return value of <literal>IProject#getName()</literal>, as far as possible
+(only use it in UI code when actually dealing with what is shown in the Eclipse UI).</simpara>
+</listitem>
+<listitem>
+<simpara>The last segment of an URI or path pointing to an N4JS project is <emphasis role="strong">not</emphasis> always the project name; use
+utilities in <literal>ProjectDescriptionUtils</literal> instead, e.g. <literal>#deriveN4JSProjectNameFromURI()</literal>!
+(However, given an URI or path pointing to a file inside an N4JS project, you can use its last segment
+to obtain the file name.)</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+</itemizedlist>
+</section>
+<section xml:id="_logging">
+<title>Logging</title>
+<simpara>In many situations developer needs to use some kind of logging. When in need, follow these rules:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>Use <literal>org.apache.log4j.Logger;</literal> for logging. Other logging utilities (like java built in logger) are not configured.</simpara>
+</listitem>
+<listitem>
+<simpara>do not use <literal>System.out</literal> nor <literal>Sysetem.err</literal> for logging. It is ok to use it for debugging purposes, but those calls
+should never be merged to master. <emphasis>(with exception of headless compiler, which uses them explicitly)</emphasis></simpara>
+</listitem>
+<listitem>
+<simpara>There is central logger configuration in <literal>org.eclipse.n4js.utils.logging</literal> (and <literal>org.eclipse.n4js.utils.logging</literal>) that should
+be used</simpara>
+<orderedlist numeration="loweralpha">
+<listitem>
+<simpara><literal>log4j.xml</literal> used for production</simpara>
+</listitem>
+<listitem>
+<simpara><literal>log4j_tests.xml</literal> used when running tests</simpara>
+</listitem>
+</orderedlist>
+</listitem>
+<listitem>
+<simpara>in Eclipse run configurations logger has to be set properly, e.g.
+<literal>log4j.configuration=file:${workspace_loc:org.eclipse.n4js.utils.logging/log4j_tests.xml}</literal></simpara>
+</listitem>
+<listitem>
+<simpara>in maven configurations logger has to be set separately, e.g.
+<literal>-Dlog4j.configuration="file:${basedir}/../../plugins/org.eclipse.n4js.utils.logging/log4j_tests.xml</literal></simpara>
+</listitem>
+</orderedlist>
+</section>
+<section xml:id="_cancellation-handling">
+<title>Cancellation Handling</title>
+<simpara>At various occasions, Xtext provides an instance of class <literal>CancelIndicator</literal> to allow our code to handle cancellation of
+long-running task.</simpara>
+<simpara>Some things to keep in mind:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>whenever a <literal>CancelIndicator</literal> is available any code that might not return immediately should implement proper
+cancellation handling (as explained in the next items).</simpara>
+</listitem>
+<listitem>
+<simpara>most importantly: reacting to a cancellation by returning early from a method is an anti-pattern that leads to
+problems (client code might continue work on a canceled and thus invalid state); instead: throw an
+<literal>OperationCanceledException</literal>!</simpara>
+</listitem>
+<listitem>
+<simpara>don&#8217;t use <literal>CancelIndicator#isCanceled()</literal> for cancellation handling, except in certain special cases. A valid exception
+case might be during logging to show a message like "operation was canceled".</simpara>
+</listitem>
+<listitem>
+<simpara>instead, inject the Xtext service called <literal>OperationCanceledManager</literal> and invoke its method <literal>#checkCanceled()</literal>, passing-in
+the cancel indicator (this method is null-safe; it will throw an <literal>OperationCanceledException</literal> in case a cancellation has
+occurred). Don&#8217;t directly create and throw an <literal>OperationCanceledException</literal> yourself.</simpara>
+</listitem>
+<listitem>
+<simpara>use the other methods provided by <literal>OperationCanceledManager</literal> when appropriate (see code of that class for details).</simpara>
+</listitem>
+<listitem>
+<simpara>in try/catch blocks, when catching exceptions of a super type of <literal>OperationCanceledException</literal>, be sure to <emphasis role="strong">not suppress</emphasis>
+cancellation exceptions. For example:</simpara>
+<programlisting language="java" linenumbering="unnumbered">// Java code
+@Inject private OperationCanceledManager operationCanceledManager;
+/** Returns true on success, false otherwise. */
+public boolean doSomething(CancelIndicator ci) {
+  try {
+    // do something that might be canceled
+    return true;
+  } catch(Exception e) {
+    operationCanceledManager.propagateIfCancelException(e); // &lt;- IMPORTANT!
+    return false;
+  }
+}</programlisting>
+<simpara>Try/finally blocks, on the other hand, do not need any special handling.</simpara>
+</listitem>
+<listitem>
+<simpara>a cancel indicator can also be stored in the rule environment (see <literal>RuleEnvironmentExtensions#addCancelIndicator()</literal>). This
+means:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>if you create a rule environment completely from scratch and you have a cancel indicator at hand, add it to the rule
+environment via <literal>RuleEnvironmentExtensions#addCancelIndicator()</literal> (not required when using <literal>RuleEnvironmentExtensions#wrap()</literal> for
+deriving a rule environment from an existing one).</simpara>
+</listitem>
+<listitem>
+<simpara>if you have a rule environment available, be sure to use its cancel indicator in long-running operations, i.e. with
+code like:</simpara>
+<programlisting language="java" linenumbering="unnumbered">// Xtend code
+import static extension org.eclipse.n4js.typesystem.utils.RuleEnvironmentExtensions.*
+class C {
+  @Inject private OperationCanceledManager operationCanceledManager;
+  def void doSomething() {
+    for(a : aLotOfStuff) {
+      operationCanceledManager.checkCanceled(G.cancelIndicator);
+      // main work ...
+    }
+  }</programlisting>
+</listitem>
+</itemizedlist>
+</listitem>
+</itemizedlist>
+</section>
+<section xml:id="_caching">
+<title>Caching</title>
+<itemizedlist>
+<listitem>
+<simpara>Caching of external libraries (implemented in ExternalProjectMappings)</simpara>
+<itemizedlist>
+<listitem>
+<simpara>update <emphasis>only</emphasis> using <literal>EclipseExternalLibraryWorkspace#updateState()</literal></simpara>
+</listitem>
+<listitem>
+<simpara>always mind that the diff of current state and cached state is a necessary information for cleaning dependencies of removed npms</simpara>
+<itemizedlist>
+<listitem>
+<simpara>see <literal>EclipseExternalIndexSynchronizer#synchronizeNpms()</literal> for implementation</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+<listitem>
+<simpara>updating also happens when external root locations change (see ExternalIndexUpdater)</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+<listitem>
+<simpara>Caching of user workspace projects (implemented in MuliCleartriggerCache)</simpara>
+<itemizedlist>
+<listitem>
+<simpara>caches only some project information and should be refactored along with Core, Model and EclipseBasedN4JSWorkspace</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+</itemizedlist>
+</section>
+<section xml:id="_dependency-injection">
+<title>Dependency Injection</title>
+<simpara>There are some things to keep in mind when using dependency injection in the context of Xtext. This is a longer topic and it is discussed in the appendix
+<xref linkend="sec:XtextInjection"/>.</simpara>
+</section>
+<section xml:id="_miscellaneous">
+<title>Miscellaneous</title>
+<itemizedlist>
+<listitem>
+<simpara>Resource load states: when an N4JS/N4JSD file is loaded, a certain sequence of processing is triggered (parsing,
+linking, validation, etc.) and thus an <literal>N4JSResource</literal> transitions through a sequence of "load states". For details,
+see <xref linkend="sec:N4JS_Resource_Load_States"/>.</simpara>
+</listitem>
+</itemizedlist>
+</section>
+</chapter>
+<chapter xml:id="_parser">
+<title>Parser</title>
+<simpara>Some of the concepts described here were presented at
+<link xl:href="https://www.youtube.com/watch?v=Xm-7aE1UMGY&amp;feature=youtu.be">EclipseCon 2013</link> and
+<link xl:href="https://vimeo.com/channels/xtextcon/98446435">XtextCon 2014</link>. Note that the material presented at the linked videos may be outdated.</simpara>
+<section xml:id="sec:Parser_Overview">
+<title>Overview</title>
+<simpara>The parser is created from an Xtext grammar. Actually, there are several grammars used as shown in <link linkend="fig:cd_grammars">Figure CD Grammars</link>. These grammars and the parsers generated from them are described more closely in the following sections.</simpara>
+<figure xml:id="fig:cd_grammars" role="center">
+<title>N4 Grammars</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/05_parser/images/cd_grammars.svg"/>
+</imageobject>
+<textobject><phrase>cd grammars</phrase></textobject>
+</mediaobject>
+</figure>
+</section>
+<section xml:id="sec:N4JS_Parser">
+<title>N4JS Parser</title>
+<simpara>One of the most tricky parts of JavaScript is the parsing because there is a conceptual mismatch between the <link linkend="AC">ANTLR</link> runtime and the specified grammar. Another challenge is the disambiguation of regular expressions and binary operations. Both features require significant customizing of the generated parser (see figure below).</simpara>
+<figure xml:id="fig:cd_ASIParser" role="center">
+<title>Overview custom parser implementation (runtime only)</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/05_parser/images/cd_ASIParser.svg"/>
+</imageobject>
+<textobject><phrase>cd ASIParser</phrase></textobject>
+</mediaobject>
+</figure>
+</section>
+<section xml:id="sec:Parser_Generation_Post_Processing" role="language-bash">
+<title>Parser Generation Post-Processing</title>
+<simpara>The ANTLR grammar that is generated by Xtext is post-processed to inject custom code into the grammar file before it is passed to the ANTLR tool. This is required in particular due to <link linkend="AC">ASI</link> (Automated Semicolon Insertion), but for some other reasons as well.</simpara>
+<simpara>Actually, there are several injections:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>Due to Xtext restrictions, the generated ANTLR grammar file (<emphasis role="strong">*.g</emphasis>) is modified. This means that some some additional actions are added and some rules are rewritten.</simpara>
+</listitem>
+<listitem>
+<simpara>Due to ANTLR restrictions, the generated ANTLR Java parser (<emphasis role="strong">*.java</emphasis>) os modified. This means that some generated rules are slightly modified to match certain requirements.</simpara>
+</listitem>
+<listitem>
+<simpara>Due to Java restrictions, the generated Java parser needs to be preprocessed in order to reduce the size of certain methods since they must not exceed 64k characters. This is implemented by means of an MWE fragment, activated after the other post processing steps are done.</simpara>
+</listitem>
+</orderedlist>
+<simpara>The first two steps are handled by <literal>AntlrGeneratorWithCustomKeywordLogic</literal>, which is configured with additional helpers in <literal>GenerateN4JS.mwe2</literal>. shows the customized classes which modify the code generation. These classes are all part of the <literal>releng.utils</literal> bundle.</simpara>
+<figure role="center">
+<title>Class Diagram Parser Generation</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/05_parser/images/cd_parsergeneration.svg"/>
+</imageobject>
+<textobject><phrase>cd parsergeneration</phrase></textobject>
+</mediaobject>
+</figure>
+<section xml:id="sec:Automatic_Semicolon_Insertion">
+<title>Automatic Semicolon Insertion</title>
+<simpara>The EcmaScript specification mandates that valid implementations automatically insert a semicolon as a statement delimiter if it is missing and the input file would become invalid due to the missing semicolon. This is known as <link linkend="AC">ASI</link>. It implies that not only valid implementations have to perform this, but a valid parser has to mimic this behavior in order to parse executable code. The <link linkend="AC">ASI</link> is implemented by two different means.</simpara>
+<simpara>The parser’s error recovery strategy is customized so it attempts to insert a semicolon if it was expected. Both strategies have to work hand in hand in order to consume all sorts of legal JavaScript code.</simpara>
+<section xml:id="sec:Injected_code_in_the_Antlr_grammar_file">
+<title>Injected code in the Antlr grammar file</title>
+<simpara>Under certain circumstances, the parser has to actively promote a token to become a semicolon even though it may be a syntactically a closing brace or line break. This has to happen before that token is consumed thus the rules for return statements, continue statements and break statements are enhanced to actively promote these tokens to semicolons.</simpara>
+<simpara>The same rule is applied to promote line breaks between an expression and a possible postfix operator <literal>++</literal> or <literal>–</literal>. At this location the line break is always treated as a semicolon even though the operator may be validly consumed and produce a postfix expression.</simpara>
+<simpara>In both cases, the method <literal>promoteEOL()</literal> is used to move a token that may serve as an automatically injected semicolon from the so called hidden token channel to the semantic channel. The hidden tokens are usually not handled by the parser explicitly thus they are semantically invisible (therefore the term hidden token). Nevertheless, they can be put on the semantic channel explicitly to make them recognizable. That’s implemented in the EOL promotion. The offending tokens include the hidden line terminators and multi-line comments that include line breaks. Furthermore, closing braces (right curly brackets) are included in the set of offending tokens as well as explicit semicolons.</simpara>
+</section>
+<section xml:id="sec:Customized_error_recovery">
+<title>Customized error recovery</title>
+<simpara>Since the EOL promotion does not work well with Antlr prediction mode, another customization complements that feature. As soon as an invalid token sequence is attempted to be parsed and missing semicolon would make that sequence valid, an offending token is sought and moved to the semantic channel. This is implemented in the custom recovery strategy.</simpara>
+</section>
+</section>
+<section xml:id="sec:_No_line_terminator_allowed_here__handling">
+<title>Async and <literal>No line terminator allowed here</literal> Handling</title>
+<simpara>There is no way of directly defining <literal>No line terminator allowed here</literal>. This is required not only for <link linkend="AC">ASI</link>, but also for <literal>async</literal>. This requires not only a special rule (using some rules from <link linkend="sec:Automatic_Semicolon_Insertion">ASI</link>), but also a special error recovery since the token ’async’ may be rejected (by the manually enriched rule) which is of course unexpected behavior from the generated source code.</simpara>
+</section>
+<section xml:id="sec:Regular_Expression">
+<title>Regular Expression</title>
+<simpara>The ANTLR parsing process can basically be divided into three steps. First of all, the file contents has to be read from disk. This includes the proper encoding of bytes to characters. The second step is the lexing or tokenizing of the character stream. A token is a basically a typed region in the stream, that is a triplet of token-id, offset and length. The last step is the parsing of these tokens. The result is a semantic model that is associated with a node tree. All necessary information to validate the model can be deduced from these two interlinked representations.</simpara>
+<figure role="center">
+<title>Simplified visualization of the parsing</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/05_parser/images/ad_parsing_simplified.svg"/>
+</imageobject>
+<textobject><phrase>ad parsing simplified</phrase></textobject>
+</mediaobject>
+</figure>
+<simpara>Since the default semantics and control flow of Antlr generated parsers do not really fit the requirements of a fully working JavaScript parser, some customizations are necessary. <emphasis role="strong">Regular expression literals in JavaScript cannot be syntactically disambiguated from div operations without contextual information.</emphasis> Nevertheless, the spec clearly describes, where a regular expression may appear and where it is prohibited. Unfortunately, it is not possible to implement these rules in the lexer alone, since it does not have enough contextual information. Therefore, the parser has been enhanced to establish a communication channel with the lexer. It announces when it expects a regular expression rather than a binary operation.</simpara>
+<simpara>This required a reworking of the Antlr internals. Instead of a completely pre-populated <literal>TokenStream</literal>, the parser works on a lazy implementation that only reads as many characters as possible without a disambiguation between regular expression literals and divide operators.</simpara>
+<simpara>Only after the parser has read this buffered tokens and potentially announced that it expects a regular expression, another batch of characters is processed by the lexer until the next ambiguous situation occurs. This is fundamentally different from the default behavior of Antlr.</simpara>
+<figure role="center">
+<title>Abstract control and object flow during parsing</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/05_parser/images/sd_parsing_sequence.svg"/>
+</imageobject>
+<textobject><phrase>sd parsing sequence</phrase></textobject>
+</mediaobject>
+</figure>
+<simpara>shows the involved classes which allow for this lexer-parser communication.</simpara>
+<figure role="center">
+<title>Class Diagram Parser-Lexer Communication</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/05_parser/images/cd_parserlexercommunication.svg"/>
+</imageobject>
+<textobject><phrase>cd parserlexercommunication</phrase></textobject>
+</mediaobject>
+</figure>
+</section>
+<section xml:id="sec:Unicode">
+<title>Unicode</title>
+<simpara>Unicode support in JavaScript includes the possibility to use unicode escape sequences in identifiers, string literals and regular expression literals. Another issue in this field is the specification of valid identifiers in JavaScript. They are described by means of unicode character classes. These have to be enumerated in the terminal rules in order to fully accept or reject valid or invalid JS identifiers.</simpara>
+<simpara>For that purpose, a small code generator is used to define the terminal fragments for certain unicode categories. The <literal>UnicodeGrammarGenerator</literal> basically iterates all characters from <literal>Character.MIN_VALUE</literal> to <literal>Character.MAX_VALUE</literal> and adds them as alternatives to the respective terminal fragments, e.g. <literal>UNICODE_DIGIT_FRAGMENT</literal>.</simpara>
+<simpara>The real terminal rules are defined as a composition of these generated fragments. Besides that, each character in an identifier, in a string literal or in a regular expression literal may be represented by its unicode escape value, e.g. ` u0060`. These escape sequences are handled and validated by the <literal>IValueConverter</literal> for the corresponding terminal rules.</simpara>
+<simpara>The second piece of the puzzle are the unicode escaped sequences that may be used in keywords. This issue is covered by the <literal>UnicodeKeywordHelper</literal> which replaces the default terminal representation in the generated Antlr grammar by more elaborated alternatives. The keyword <literal>if</literal> is not only lexed as <literal>’if’</literal> but as seen in snippet
+<link linkend="lst:terminal_if">Terminal if listing</link>.</simpara>
+<formalpara xml:id="lst:terminal_if">
+<title>Terminal if</title>
+<para>
+<screen>If :
+    ( 'i' | '\\' 'u' '0``   0``   6``   9' )
+    ( 'f' | '\\' 'u' '0``   0``   6``   6' );</screen>
+</para>
+</formalpara>
+</section>
+<section xml:id="sec:Literals">
+<title>Literals</title>
+<simpara>Template literals are also to be handled specially, see <literal>TemplateLiteralDisambiguationInjector</literal> for details.</simpara>
+</section>
+</section>
+<section xml:id="sec:Modifiers" role="language-n4js">
+<title>Modifiers</title>
+<simpara>On the AST side, all modifiers are included in a single enumeration <literal>N4Modifier</literal>. In the types model however, the individual modifiers are mapped to two different enumerations of <emphasis>access</emphasis> modifiers (namely <literal>TypeAccessModifier</literal> and <literal>MemberAccessModifier</literal>) and a number of boolean properties (in case of non-access modifiers such as <literal>abstract</literal> or <literal>static</literal>). This mapping is done by the types builder, mostly by calling methods in class <literal>ModifierUtils</literal>.</simpara>
+<simpara>The grammar allows the use of certain modifiers in many places that are actually invalid. Rules where a certain modifier may appear in the AST are implemented in method isValid(EClass,N4Modifier) in class <literal>ModifierUtils</literal> and checked via several validations in <literal>N4JSSyntaxValidator</literal>. Those validations also check for a particular order of modifiers that is not enforced by the grammar.</simpara>
+<simpara>See API documentation of enumeration <literal>N4Modifier</literal> in file <literal>N4JS.xcore</literal> and the utility class <literal>ModifierUtils</literal> for more details.</simpara>
+</section>
+<section xml:id="sec:Conflict_Resolutions" role="language-n4js">
+<title>Conflict Resolutions</title>
+<section xml:id="sec:Reserved_Keywords_vs__Identifier_Names">
+<title>Reserved Keywords vs. Identifier Names</title>
+<simpara>Keywords and identifiers have to be distinguished by the lexer. Therefore, there is no means to decide upfront whether a certain keyword is actually used as a keyword or whether it is used as an identifier in a given context. This limitation is idiomatically overcome by a data type rule for valid identifiers. This data type rule enumerates all keywords which may be used as identifiers and the pure IDENTIFIER terminal rule as seen in <link linkend="lst:keywords_as_identifier">Keywords as Identifier listing</link>.</simpara>
+<formalpara xml:id="lst:keywords_as_identifier">
+<title>Keywords as Identifier</title>
+<para>
+<programlisting language="ebnf" linenumbering="unnumbered">N4JSIdentifier: IDENTIFIER
+    | 'get'
+    | 'set'
+    ...
+;</programlisting>
+</para>
+</formalpara>
+</section>
+<section xml:id="sec:Operators_and_Generics">
+<title>Operators and Generics</title>
+<simpara>The ambiguity between shift operators and nested generics arises also from the fact, that Antlr lexer upfront without any contextual information. When implemented naively, the grammar will be broken, since a token sequence <literal>a&gt;&gt;b</literal> can either be part of <literal>List&lt;List&lt;a&gt;&gt; b</literal> or it can be part of a binary operation <literal>int c = a &gt;&gt; b</literal>. Therefore the shift operator may not be defined with a single token but has to be composed from individual characters (see <link linkend="lst:shift_operator">Shift Operator listing</link>).</simpara>
+<formalpara xml:id="lst:shift_operator">
+<title>Shift Operator listing</title>
+<para>
+<programlisting language="ebnf" linenumbering="unnumbered">ShiftOperator:
+      '&gt;' '&gt;' '&gt;'?
+    | '&lt;' '&lt;'
+    ;</programlisting>
+</para>
+</formalpara>
+</section>
+</section>
+<section xml:id="sec:Content_Assist_Parser" role="language-n4js">
+<title>Content-Assist Parser</title>
+<warning>
+<simpara>This section may be outdated!</simpara>
+</warning>
+<simpara>The <link linkend="AC">CA</link> parser also needs adjustments for supporting automatic semicolon insertion and regular expressions. Instead of modifying the <link linkend="AC">CA</link> parser generator similar to the normal parser, the former reuses parts of the latter as far as possible. That is, the token sequence that is produced during production parsing is used as is for the content assist parser. Semicolons have already been inserted where appropriate and regular expression are successfully distinguished from divide operators.</simpara>
+<simpara>Since the n4js grammar uses syntactic predicates, the content assist parser is compiled with backtracking enabled. This is always the case for Xtext’s CA parsers that rely on backtracking or predicates (local backtracking) in the production parser. This approach is both good (CA works in general) and bad (unpredictable decisions in case of error at locations prior to the cursor). Since parsing with backtracking enabled makes for a fundamental difference in how the prediction and parsing works and how the parser decides which decision paths to take, the customization patterns from the production parser are not applied 1:1 to the CA parser, but adapted instead. The content assist parser doesn’t use a freshly lexed token stream with unicode support, ASI or regular expression literals, but instead uses a synthesized token sequence which is rebuilt from the existing node model.</simpara>
+<simpara>The token stream that is consumed by the content assist parser is therefore not created by a lexer but by the <literal>org.eclipse.n4js.ui.contentassist.NodeModelTokenSource</literal>.
+It traverses the existing node model that is contained in the resource and was produced by the production parser. This approach has the significant advantage that any decision that was made by that parser is also immediately applicable to the content assist infrastructure. For that purpose, the leaf nodes of the node model are mapped to ANTLR token types.
+This is achieved by the <literal>org.eclipse.n4js.ui.contentassist.ContentAssistTokenTypeMapper</literal> which is capable to provide the untyped ANTLR token type (primitive int) for a given grammar element.</simpara>
+<simpara>Special considerations have been made for the last token in the produced source. If it overlaps with an existing leaf node but does not fully cover it, the plain Antlr lexer is used to consume the prefix that is overlapping. Since the terminals will never overlap with each other the longest match always wins without backtracking in the lexer, it is save to assume that only one token is produced from the prefix. The very last token in the <literal>org.eclipse.n4js.ui.contentassist.NodeModelTokenSource</literal> is always the EOF token (<literal>org.antlr.runtime.Token.EOF_TOKEN</literal>).</simpara>
+<simpara>Given that the token source is equal to the prefix in the production token source, some more thought has to be put into the synthesized end of file. The production parser used the complete file to decide where to automatically insert a semicolon and where not to. This would potentially change if there was another token next to the artificial EOF. Therefore, two cases have to considered. The first one describes CA request next to an automatically inserted semicolon and the second one describes CA requests at a position where a semicolon could have been inserted if the token to the right was another one. The <literal>org.eclipse.n4js.ui.contentassist.CustomN4JSParser</literal> reflects these cases. Heuristics are applied to the end of the token sequence to decide whether a second pass has to be performed to collect yet more following elements. Based on the concrete sequence, the last automatically inserted semicolon is removed from the sequence prior to the second pass or such is a token is explicitly synthesized and appended. Besides the second pass, another special treatment is made for postfix expressions. Those may not be interrupted by a hidden semicolon so those are filtered from the resulting follow set if appropriate.</simpara>
+<simpara>The parser is used by the <literal>org.eclipse.n4js.ui.contentassist.ContentAssistContextFactory</literal> where all relevant entry points from the super class are specialized to pass the node model in the the parser facade (<literal>org.eclipse.n4js.ui.contentassist.CustomN4JSParser</literal>). In that sense, the ContentAssistContextFactory serves as a drop-in replacement binding the default <literal>ParserBasedContentAssistContextFactory.StatefulFactory</literal>.</simpara>
+</section>
+</chapter>
+<chapter xml:id="_type-system">
+<title>Type System</title>
+<section xml:id="sec:Type_Model_and_Grammar" role="language-n4js">
+<title>Type Model and Grammar</title>
+<simpara>The type model is used to define actual types and their relations (meta-model is defined by means of Xcore in file <literal>Types.xcore</literal>)
+and also references to types (meta-model in <literal>TypeRefs.xcore</literal>). The type model is built via the <literal>N4JSTypesBuilder</literal> when a resource
+is loaded and processed, and most type related tasks work only on the type model. Some types that are (internally) available
+in N4JS are not defined in N4JS, but instead in a special, internal type language not available to N4JS developers, called N4TS
+and defined in file <literal>Types.xtext</literal>.</simpara>
+<simpara>The types are referenced by AST elements; vice versa the AST elements can be referenced from the types (see <literal>SyntaxRelatedTElement</literal>).
+This backward reference is a simple reference to an EObject.</simpara>
+<section xml:id="sec:Type_Model_Overview">
+<title>Type Model Overview</title>
+<simpara>The following figure, <link linkend="fig:cd_typeAndTypeRefHierarchy">Types and Type References</link>, shows the classes of the type model and their inheritance relations, both the actual type definitions as defined in <literal>Types.xcore</literal> and the type references defined in <literal>TypeRefs.xcore</literal>. The most important type reference is the <literal>ParameterizedTypeRef</literal>; it is used for most user-defined references, for both parameterized and non-parameterized references. In the latter case, the list of type arguments is empty.</simpara>
+<figure xml:id="fig:cd_typeAndTypeRefHierarchy">
+<title>Type Model Overview: Types in the upper half and Type References in the lower half.</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/06_typesystem/images/cd_typeModelHierarchy_allInOne.png"/>
+</imageobject>
+<textobject><phrase>cd typeModelHierarchy allInOne</phrase></textobject>
+</mediaobject>
+</figure>
+<simpara>Most types are self-explanatory. <literal>TypeDefs</literal> is the container element used in N4TS. Note that not all types and properties of types are available in N4JS – some can only be used in the N4TS language or be inferred by the type system for internal purposes. Some types need some explanation:</simpara>
+<itemizedlist>
+<listitem>
+<simpara><literal>TObjectPrototype</literal>: Metatype for defining built-in object types such as <literal>Object</literal> or <literal>Date</literal>, only available in N4TS.</simpara>
+</listitem>
+<listitem>
+<simpara><literal>VirtualBaseType</literal>: This type is not available in N4JS. It is used to define common properties provided by all types of a certain metatype. E.g., it is used for defining some properties shared by all enumerations (this was the reason for introducing this type).</simpara>
+</listitem>
+</itemizedlist>
+<simpara>We distinguish four kinds of types as summarized in <link linkend="tab:KindOfTypes">Kind Of Types</link>. Role is an internal construct for different kind of users who can define the special kind of type. The language column refers to the language used to specify the type; which is either N4JS or N4TS.</simpara>
+<table xml:id="tab:KindOfTypes" frame="all" rowsep="1" colsep="1">
+<title>Kind of Types</title>
+<tgroup cols="4">
+<colspec colname="col_1" colwidth="10*"/>
+<colspec colname="col_2" colwidth="10*"/>
+<colspec colname="col_3" colwidth="10*"/>
+<colspec colname="col_4" colwidth="70*"/>
+<thead>
+<row>
+<entry align="left" valign="top">Kind</entry>
+<entry align="left" valign="top">Language</entry>
+<entry align="left" valign="top">Role</entry>
+<entry align="left" valign="top">Remark</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry align="left" valign="top"><simpara><emphasis role="strong">user</emphasis></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">N4JS</emphasis></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">developer</emphasis></simpara></entry>
+<entry align="left" valign="top"><simpara>User defined types, such as declared classes or functions. These types are to be explicitly defined or imported in the code.</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><emphasis role="strong">library</emphasis></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">N4JSD</emphasis></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">developer</emphasis></simpara></entry>
+<entry align="left" valign="top"><simpara>Type declarations only, comparable to C header files, without implementation. Used for defining the API of 3rd party libraries. These type definitions are to be explicitly defined or imported in the code.</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><emphasis role="strong">builtin</emphasis></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">N4TS</emphasis></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">smith</emphasis></simpara></entry>
+<entry align="left" valign="top"><simpara>Built-in ECMAScript objects interpreted as types. E.g., <literal>String</literal>, <literal>Date</literal>, <literal>Math</literal>. These types are provided by N4JS and are always available.</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><emphasis role="strong">primitive</emphasis></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">N4TS</emphasis></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">smith</emphasis></simpara></entry>
+<entry align="left" valign="top"><simpara>Primitive ECMAScript (and N4JS ties), such as <literal>string</literal>, <literal>number</literal>, <literal>pathselector&lt;T&gt;</literal>, <literal>i18n</literal>, and also <literal>any</literal>, <literal>undefined</literal> and <literal>void</literal>. These types are provided by N4JS and are always available. Primitive types are described in detail in the spec (see chapter "Primitive ECMAScript Types").</simpara></entry>
+</row>
+</tbody>
+</tgroup>
+</table>
+</section>
+<section xml:id="sec:Built_in_Types">
+<title>Built-in and Primitive Types</title>
+<simpara>The built-in and primitive types are not defined by the user, i.e. N4JS programmer. Instead, they are defined in special
+internal files using the internal N4TS language: <literal>builtin_js.n4ts</literal>, <literal>builtin_n4.n4ts</literal>, <literal>primitives_js.n4ts</literal>, <literal>primitives_n4.n4ts</literal>.</simpara>
+</section>
+<section xml:id="sec:Type_Model_DSL" role="language-n4js">
+<title>Type Model DSL</title>
+<simpara>For defining built-in types and for tests, a special DSL called N4TS is provided by means of an Xtext grammar and generated
+tools. The syntax is similar to n4js, but of course without method or function bodies, i.e. without any statements of expressions.
+The grammar file is found in <literal>Types.xtext</literal>.</simpara>
+<simpara>The following list documents some differences to N4JS:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>access modifiers directly support <literal>Internal</literal>, so no annotations are needed (nor supported) here.</simpara>
+</listitem>
+<listitem>
+<simpara>besides N4 classifiers such as classes, the following classifiers can be defined:</simpara>
+<orderedlist numeration="loweralpha">
+<listitem>
+<simpara><literal>object</literal> define classes derived from object (predefined object types) Special features:</simpara>
+<informaltable tabstyle="horizontal" frame="none" colsep="0" rowsep="0">
+<tgroup cols="2">
+<colspec colwidth="15*"/>
+<colspec colwidth="85*"/>
+<tbody valign="top">
+<row>
+<entry>
+<simpara>indexed</simpara>
+</entry>
+<entry>
+<simpara>defined what type is returned in case of index access</simpara>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+</listitem>
+<listitem>
+<simpara><literal>virtualBase</literal> virtual base types for argument</simpara>
+</listitem>
+</orderedlist>
+</listitem>
+<listitem>
+<simpara><literal>primitive</literal> primitive types (number, string etc.) Special features:</simpara>
+<informaltable tabstyle="horizontal" frame="none" colsep="0" rowsep="0">
+<tgroup cols="2">
+<colspec colwidth="15*"/>
+<colspec colwidth="85*"/>
+<tbody valign="top">
+<row>
+<entry>
+<simpara>indexed</simpara>
+</entry>
+<entry>
+<simpara>defined what type is returned in case of index access</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>autoboxedType</simpara>
+</entry>
+<entry>
+<simpara>defines to which type the primitive can be auto boxed</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>assignmnentCompatible</simpara>
+</entry>
+<entry>
+<simpara>defines to which type the primitive is assignment compatible</simpara>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+</listitem>
+<listitem>
+<simpara>types <literal>any</literal>, <literal>null</literal>, <literal>void</literal>, <literal>undefined</literal> – special types.</simpara>
+</listitem>
+</orderedlist>
+<simpara>Annotations are not supported in the types DSL.</simpara>
+</section>
+</section>
+<section xml:id="sec:Type_System_Implementation" role="language-n4js">
+<title>Type System Implementation</title>
+<simpara>The bulk of the type system&#8217;s functionality is implemented in packages <literal>org.eclipse.n4js.typesystem[.constraints|.utils]</literal>.
+Client code, e.g. in validations, should only access the type system through the facade class <literal>N4JSTypeSystem</literal>.
+Each of the main type system functions, called "judgments", are implemented in one of the concrete subclasses of
+base class <literal>AbstractJudgment</literal>. Internally, the type system is using a constraint solver for various purposes;
+entry point for this functionality is class <literal>InferenceContext</literal>. All these classes are a good entry point into
+the code base, for investigating further details.</simpara>
+<simpara>Some type information is cached (e.g., the type of an expression in the AST) and the above facade will take care
+to read from the cache instead of re-computing the information every time, as far as possible. This type cache is
+being filled in a dedicated phase during loading and processing of an N4JS resource;
+see <xref linkend="sec:Type_Inference_combined_with_AST_Traversal"/> and <xref linkend="sec:N4JS_Resource_Load_States"/> for details.</simpara>
+</section>
+<section xml:id="sec:Type_Inference_combined_with_AST_Traversal" role="language-n4js">
+<title>Type Inference of AST</title>
+<simpara>Most judgments provided by the facade <literal>N4JSTypeSystem</literal> and implemented by subclasses of <literal>AbstractJudgment</literal> are used
+ad-hoc whenever client code requires the information they provide. This is applied, in particular, to judgments</simpara>
+<itemizedlist>
+<listitem>
+<simpara><literal>subtype</literal></simpara>
+</listitem>
+<listitem>
+<simpara><literal>substTypeVariables</literal></simpara>
+</listitem>
+<listitem>
+<simpara><literal>upperBound</literal> / <literal>lowerBound</literal></simpara>
+</listitem>
+</itemizedlist>
+<simpara>For judgment <literal>type</literal> footnote:<literal role="Currently only for [language-n4js">type</literal>, not for <literal role="language-n4js">expectedType</literal>,
+but this may be changed in a future, further refactoring.], however, the processing is very different: we make
+sure that the entire AST, i.e. all typable nodes of the AST, will be typed up-front in a single step, which
+takes place during the <emphasis>post-processing step</emphasis> of an N4JSResource (see <xref linkend="sec:N4JS_Resource_Load_States"/>), which
+also has a couple other responsibilities. By triggering post-processing when client code invokes the type judgment
+for the first time for some random AST node (at the latest; usually it is triggered earlier), we make sure that
+this sequence is always followed.</simpara>
+<simpara>The remainder of this section will explain this single-step typing of the entire AST in detail.</simpara>
+<section xml:id="sec:Type_Inference_combined_with_AST_Traversal__Background">
+<title>Background</title>
+<simpara>Originally, the N4JS type system could be called with any <literal>EObject</literal> at any given time, without any knowledge of the
+context. While this looked flexible in the beginning, it caused severe problems solving some inference cases, e.g.,
+the rule environment had to be prepared from the outside and recursion problems could occur, and it was also
+inefficient because some things had to be recalculated over and over again (although caching helped).</simpara>
+<simpara>It is better to do type inferencing (that is, computing the type of expressions in general) in a controlled manner.
+That is, instead of randomly computing the type of an expression in the AST, it is better to traverse the AST in a
+well-defined traversal order. That way, it is guaranteed that certain other nodes have been visited and, if not,
+either some special handling can kick in or an error can be reported. This could even work with XSemantics and the
+declarative style of the rules. The difference is that by traversing the AST in a controlled manner, the rules can
+make certain assumptions about the content of the rule-environment, such as that it always contains information
+about type variable bindings and that it always contains information about expected types etc.</simpara>
+<simpara>In that scenario, all AST nodes are visited and all types (and expected types) are calculated up-front. Validation
+and other parts then do not need to actually compute types (by calling the actual, Xsemantics-generated type system);
+instead, at that time all types have already been calculated and can simply be retrieved from the cache (this is
+taken care of by the type system facade <literal>N4JSTypeSystem</literal>).</simpara>
+<simpara>This also affects scoping, since all cross-references have to be resolved in this type computation step. However,
+even for scoping this has positive effects: E.g., the receiver type in property access expressions is always visited
+<emphasis>before</emphasis> visiting the selector. Thus it is not necessary to re-calculate the receiver type in order to perform scoping
+for the selector.</simpara>
+<simpara>The above refactoring was done in summer 2015. After this refactoring, we are still using Xsemantics to compute the
+types, i.e. the <literal>type</literal>     judgement in Xsemantics was largely kept as before. However, the type judgment is invoked
+in a controlled traversal order for each typable AST node in largely one step (controlled by <literal>ASTProcessor</literal> and <literal>TypeProcessor</literal>).</simpara>
+<simpara>The upshot of this one-step type inference is that once it is completed, the type for every typable AST node is known.
+Instead of storing this information in a separate model, this information will be stored and persisted in the type model
+directly, as well as in transient fields of the AST <footnote><simpara>This is not yet implemented as of September 2015; types are still stored in a separate cache, the <literal>ASTMetaInfoCache</literal>.</simpara></footnote>. Currently, this applies only to types, not expected types;
+the inference of expected types could / should be integrated into the one-step inference as part of a future, further
+refactoring.</simpara>
+<table xml:id="tab:typeInferenceBeforeAfter" frame="all" rowsep="1" colsep="1">
+<title>Comparison of inference of type of AST nodes before / after refactoring.</title>
+<tgroup cols="2">
+<colspec colname="col_1" colwidth="50*"/>
+<colspec colname="col_2" colwidth="50*"/>
+<thead>
+<row>
+<entry align="left" valign="top">Before</entry>
+<entry align="left" valign="top">After</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry align="left" valign="top"><simpara>ad-hoc type inference (when client code needs the type information)</simpara></entry>
+<entry align="left" valign="top"><simpara>up-front type inference (once for entire AST;
+later only reading from cache)</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara>started anywhere</simpara></entry>
+<entry align="left" valign="top"><simpara>starts with root, i.e. the <literal>Script</literal></simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara>Xsemantics rules traverse the AST at will, uncontrolled</simpara></entry>
+<entry align="left" valign="top"><simpara>well-defined, controlled traversal order</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara>lazy, on-demand resolution of <literal>ComputedTypeRef</literal>s (they contain the resolution logic)</simpara></entry>
+<entry align="left" valign="top"><simpara>pro-active resolution of
+<literal>DeferredTypeRef</literal>s (they themselves are dumb)</simpara></entry>
+</row>
+</tbody>
+</tgroup>
+</table>
+</section>
+<section xml:id="sec:Triggering_Type_Inference_of_AST">
+<title>Triggering</title>
+<simpara>The up-front type inference of the entire AST is part of the post-processing of every N4JSResource and is thus
+triggered when post-processing is triggered. This happens when</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>someone directly calls <literal>#performPostProcessing()</literal> on an N4JSResource</simpara>
+</listitem>
+<listitem>
+<simpara>someone directly calls <literal>#resolveAllLazyCrossReferences()</literal> on an N4JSResource,</simpara>
+</listitem>
+<listitem>
+<simpara>EMF automatically resolves the first proxy, i.e. someone calls an EMF-generated getter for a value that is a proxy,</simpara>
+</listitem>
+<listitem>
+<simpara>someone asks for a type for the first time, i.e. calls <literal>N4JSTypeSystem#type()</literal>,</simpara>
+</listitem>
+<listitem>
+<simpara>&#8230;&#8203;</simpara>
+</listitem>
+</orderedlist>
+<simpara>Usually this happens after the types builder was run with <literal>preLinking==false</literal> and before validation takes place.
+For details, see classes <literal>PostProcessingAwareResource</literal> and <literal>N4JSPostProcessor</literal>.</simpara>
+</section>
+<section xml:id="sec:Traversal_Order_During_Type_Inference_of_AST">
+<title>Traversal Order</title>
+<simpara>The traversal order during post-processing is a bit tricky, as some things need to be done in a top-down order (only
+few cases, for now <footnote><simpara>In the future, the top-down order could become more important if inference of <emphasis>expected</emphasis> types is also integrated into post-processing.</simpara></footnote>), others in a bottom-up order (e.g. the main typing of AST nodes),
+and there is a third case in which several AST nodes are processed together (constraint-based type inference).</simpara>
+<simpara>Figure <xref linkend="fig:traversalOrder"/> provides an example of an AST and shows in which order the nodes are processed. Green
+numbers represent top-down processing, red numbers represent bottom-up processing and blue numbers represent the
+processing of the surrounding yellow nodes in a single step.</simpara>
+<figure xml:id="fig:traversalOrder">
+<title>Order in which AST nodes are being processed during post-processing.</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/06_typesystem/images/traversalOrder.png"/>
+</imageobject>
+<textobject><phrase>traversalOrder</phrase></textobject>
+</mediaobject>
+</figure>
+<simpara>In the code, this is controlled by class <literal>ASTProcessor</literal>. The two main processing methods are</simpara>
+<itemizedlist>
+<listitem>
+<simpara><literal>#processNode_preChildren()</literal>, which will be invoked for all AST nodes in a top-down order (so top-down processing should be put here),</simpara>
+</listitem>
+<listitem>
+<simpara><literal>#processNode_postChildren()</literal>, which will be invoked for all AST nodes in a bottom-up order (so bottom-up processing should be put here).</simpara>
+</listitem>
+</itemizedlist>
+<simpara>The common processing of groups of adjacent yellow nodes (represented in the figure by the two yellow/brown
+triangles) is achieved by <literal>PolyProcessor</literal> telling the <literal>TypeProcessor</literal> to</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>ignore certain nodes (all yellow nodes) and</simpara>
+</listitem>
+<listitem>
+<simpara>invoke method <literal>PolyProcessor#inferType()</literal> for the root yellow node in each group (only the root!).
+.
+For details, see the two methods <literal>#isResponsibleFor()</literal> and <literal>#isEntryPoint()</literal> in <literal>PolyProcessor</literal>.</simpara>
+</listitem>
+</orderedlist>
+</section>
+<section xml:id="sec:Cross_References_During_Type_Inference_of_AST">
+<title>Cross-References</title>
+<simpara>While typing the entire AST, cross-references need special care. Three cases of cross-references need to be distinguished:</simpara>
+<informaltable tabstyle="horizontal" frame="none" colsep="0" rowsep="0">
+<tgroup cols="2">
+<colspec colwidth="15*"/>
+<colspec colwidth="85*"/>
+<tbody valign="top">
+<row>
+<entry>
+<simpara>backward reference</simpara>
+</entry>
+<entry>
+<simpara>= cross-reference within the same file to an AST node that was already processed</simpara>
+<itemizedlist>
+<listitem>
+<simpara>always legal</simpara>
+</listitem>
+<listitem>
+<simpara>processing: simply read the type from the cache that is currently being filled</simpara>
+</listitem>
+</itemizedlist>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>forward reference</simpara>
+</entry>
+<entry>
+<simpara>= cross-reference within the same file to an AST node that was not yet processed</simpara>
+<itemizedlist>
+<listitem>
+<simpara>usually illegal<?asciidoc-br?>
+exception: legal if reference points to an <emphasis>identifiable subtree</emphasis> (a subtree of an AST with an identifiable element at its root)</simpara>
+</listitem>
+<listitem>
+<simpara>processing: forward process the identifiable subtree and report back the type of its root</simpara>
+</listitem>
+</itemizedlist>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>references to other files</simpara>
+</entry>
+<entry>
+<itemizedlist>
+<listitem>
+<simpara>always legal, because they can, by nature, only point to an identifiable subtree in the other file&#8217;s AST</simpara>
+</listitem>
+<listitem>
+<simpara>processing: either &#8230;&#8203;</simpara>
+<itemizedlist>
+<listitem>
+<simpara>read type from TModule obtained from index (if available), or</simpara>
+</listitem>
+<listitem>
+<simpara>load other file from source, trigger its post-processing (if not in progress or completed already), forward process the identifiable subtree (if not processed already) and report back the type of its root.</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+</itemizedlist>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+<simpara>Note that for references to an ancestor (upward references) or successor (downward references) within an AST, the
+classification as a forward or backward reference depends on whether we are in top-down or bottom-up processing.
+Figure <link linkend="fig:upwardDownward">Upward Downward</link> illustrates this: the left and right side show the same AST but on the
+left side we assume a top down processing whereas on the right we assume a bottom up processing. On both sides,
+backward references are shown in green ink (because they are unproblematic and always legal) and forward references
+are shown in red ink. Now, looking at the two arrows pointing from a node to its parent, we see that it is classified
+as a backward reference on the left side (i.e. top down case) but as a forward reference on the right side (i.e. bottom
+down case). Conversely, an arrow from a node to its child is classified as a forward reference on the left side and as
+a backward reference on the right side. Arrows across subtrees, however, are classified in the same way on the left and
+right side (see the horizontal arrows at the bottom).</simpara>
+<figure xml:id="fig:upwardDownward">
+<title>Backward and forward references in top-down and bottom-up processing.</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/06_typesystem/images/upwardDownward.png"/>
+</imageobject>
+<textobject><phrase>upwardDownward</phrase></textobject>
+</mediaobject>
+</figure>
+</section>
+<section xml:id="sec:Function_Accessor_Bodies_During_Type_Inference_of_AST">
+<title>Function/Accessor Bodies</title>
+<simpara>An important exception to the basic traversal order shown in Figure <xref linkend="fig:traversalOrder"/> is that the body of all
+functions (including methods) and field accessors is postponed until the end of processing. This is used to avoid
+unnecessary cycles during type inference due to a function&#8217;s body making use of the function itself or some other
+declarations on the same level as the containing function. For example, the following code relies on this:</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">let x = f();
+function f(): X {
+	if(x) {
+		// XPECT noerrors --&gt; "any is not a subtype of X." at "x"
+		return x;
+	}
+	return new X();
+}</programlisting>
+<simpara>Similar situation using fields and methods:</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">class C {
+	d = new D();
+	mc() {
+		// XPECT noerrors --&gt; "any is not a subtype of D." at "this.d"
+		let tmp: D = this.d;
+	}
+}
+class D {
+	md() {
+		new C().mc();
+	}
+}</programlisting>
+<simpara>For details of this special handling of function bodies, see method <literal>ASTProcessor#isPostponedNode(EObject)</literal> and field
+<literal>ASTMetaInfoCache#postponedSubTrees</literal> and the code using it. For further investigation, change <literal>isPostponedNode()</literal> to always
+return false and debug with the two examples above (which will then show the incorrect errors mentioned in the XPECT
+comments) or run tests to find more cases that require this handling.</simpara>
+</section>
+<section xml:id="sec:Poly_Expressions_During_Type_Inference_of_AST">
+<title>Poly Expressions</title>
+<simpara>Polymorphic expressions, or <emphasis>poly expressions</emphasis> for short, are expressions for which the actual type depends on the
+expected type and/or the expected type depends on the actual type. They require constraint-based type inference
+because the dependency between the actual and expected type can introduce dependency cycles between the types of
+several AST nodes which are best broken up by using a constraint-based approach. This is particularly true when
+several poly expressions are nested. Therefore, poly expressions are inferred neither in top-down nor in bottom-up
+order, but all together by solving a single constraint system.</simpara>
+<simpara>Only a few types of expressions can be polymorphic; they are called <emphasis>poly candidates</emphasis>: array literals, object literals,
+call expressions, and function expressions. The following rules tell whether a poly candidate is actually poly:</simpara>
+<itemizedlist>
+<listitem>
+<simpara><literal>ArrayLiteral</literal> — always poly (because their type cannot be declared explicitly).</simpara>
+</listitem>
+<listitem>
+<simpara><literal>ObjectLiteral</literal> — if one or more properties do not have a declared type.</simpara>
+</listitem>
+<listitem>
+<simpara><literal>CallExpression</literal> — if generic &amp; not parameterized.</simpara>
+</listitem>
+<listitem>
+<simpara><literal>FunctionExpression</literal> — if return type or type of one or more formal parameters is undeclared.</simpara>
+</listitem>
+</itemizedlist>
+<simpara>This is a simplified overview of these rules, for details see method <literal>#isPoly(Expression)</literal> in <literal>AbstractPolyProcessor</literal>.</simpara>
+<simpara>The main logic for inferring the type of poly expressions is found in method <literal>#inferType()</literal> in class <literal>PolyProcessor</literal>.
+It is important to note that this method will only be called for root poly expressions (see above). In short, the basic
+approach is to create a new, empty <literal>InferenceContext</literal>, i.e. constraint system, add inference variables and constraints for
+the root poly expression and all its nested poly expressions, solve the constraint system and use the types in the solution
+as the types of the root and nested poly expressions. For more details see method <literal>#inferType()</literal> in class <literal>PolyProcessor</literal>.</simpara>
+<simpara>So, this means that nested poly expressions do not introduce a new constraint system but instead simply extend their parent
+poly’s constraint system by adding additional inference variables and constraints. <emphasis role="strong">But not every nested expression that is
+poly is a nested poly expression in that sense!</emphasis> Sometimes, a new constraint system has to be introduced. For example:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>child poly expressions that appear as argument to a call expression are nested poly expressions (i.e. inferred in same constraint system as the parent call expression),</simpara>
+</listitem>
+<listitem>
+<simpara>child poly expressions that appear as target of a call expression are <emphasis role="strong">not</emphasis> nested poly expressions and a new constraint system has to be introduced for them.</simpara>
+</listitem>
+</itemizedlist>
+<simpara>For details see method <literal>#isRootPoly()</literal> in <literal>AbstractPolyProcessor</literal> and its clients.</simpara>
+</section>
+<section xml:id="sec:Constraint_Solver_used_During_Type_Inference_of_AST">
+<title>Constraint Solver</title>
+<simpara>The simple constraint solver used by the N4JS type system, mainly for the inference of poly expressions, is implemented
+by class <literal>InferenceContext</literal> and the other classes in package <literal>org.eclipse.n4js.typesystem.constraints</literal>.</simpara>
+<simpara>The constraint solving algorithm used here is largely modeled after the one defined in <literal>The Java Language Specification 8</literal>,
+Chapter 18, but was adjusted in a number of ways, esp. by removing functionality not required for N4JS (e.g. primitive types,
+method overloading) and adding support for specific N4JS language features (e.g. union types, structural typing).</simpara>
+<simpara>For details see the API documentation of class <literal>InferenceContext</literal>.</simpara>
+</section>
+<section xml:id="sec:Type_Guards_During_Type_Inference_of_AST">
+<title>Type Guards</title>
+<simpara>During AST post-processing, the control and data flow analyses are performed.
+This means, that first a flow graph is created and then traversed.
+During the traversal, a type guard analysis is performed which saves information by evaluating <literal>instanceof</literal> expressions.
+As a result, the analysis provides a reliable set of RHS expressions of <literal>instanceof</literal> expressions for each AST element of type <literal>IdentifierRef</literal>.</simpara>
+<simpara>This set is evaluated in the <literal>TypeJudgments.java</literal> when typing <literal>IdentifierRef</literal> elements.
+In case the set is not empty, the types of all elements is calculated.
+The type of the <literal>IdentifierRef</literal> will then become the intersection of its original type and all types previously calculated.</simpara>
+</section>
+</section>
+<section xml:id="sec:Structural_Typing">
+<title>Structural Typing</title>
+<simpara>Structural typing as an optional subtyping mode in N4JS is implemented in <literal>StructuralTypingComputer</literal>, activated depending on
+the value of property <literal>typingStrategy</literal> in <literal>ParameterizedTypeRef</literal> and its subclasses.</simpara>
+</section>
+</chapter>
+<chapter xml:id="_type-index">
+<title>Type Index</title>
+<section xml:id="sec:Type_Index_Design_Rationale" role="language-n4js">
+<title>Design Rationale</title>
+<simpara>We use a separate types model to represent types, see <xref linkend="sec:Type_Model_and_Grammar"/>. Declared elements (e.g., classes)
+in N4JS are parsed and a new types model instance is derived from them. All type references (of the N4JS <link linkend="AC">AST</link>)
+are then bound to these type instances and not to the N4JS declaration. However, there exists a relation between a type
+and its declaration. The type instances (which are EObjects) are added to the resource of the N4JS file as part of
+the public interface of the resource. This public interface is represented by a <literal>TModule</literal>. While the actual source code
+is the first element of a resource (index 0), the module is stored at index 1. It contains the derived type information,
+the information about exported variables and functions as well as information about the project and vendor. The Xtext
+serializer ignores the additional element. Besides, the complete type instances are stored in the user data section of
+the <literal>IEObjectDescription</literal> of the <literal>TModule</literal>. Since the user data only allows strings to be stored, the EObjects are serialized
+(within a virtual resource). When a reference is then bound to a type, the type can be directly recreated (deserialized)
+from the user data. The deserialized EObject is then added to the appropriate resource. It is not necessary to load the
+complete file just to refer to a type from that file.</simpara>
+<simpara>The design relies on two key features of Xtext:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>Besides the parsed text (i.e., the AST), other elements can be stored in a resource, which are then ignored by
+the Xtext serializer, while still being properly contained in an EMF resource.</simpara>
+</listitem>
+<listitem>
+<simpara>The <literal>DerivedStateAwareResource</literal> allows some kind of post processing steps when reading a resource. This enables a custom
+class, here <literal>N4JSDerivedStateComputer</literal>, to create the types models (TClass, TRole and so on) from the parsed <literal>N4ClassDeclaration</literal>,
+<literal>N4RoleDeclaration</literal> and so on.</simpara>
+</listitem>
+</orderedlist>
+<section xml:id="sec:Getting_the_Xtext_Index_Content_IResourceDescriptions">
+<title>Getting the Xtext Index (<literal>IResourceDescriptions</literal>) Content</title>
+<simpara>An instance of the <literal>IResourceDescriptions</literal> can be acquired from the resource description provider. Just like all services
+in Xtext, this can be injected into the client code as well. The resource descriptions accepts a non-null resource set.
+The resource set argument is mandatory to provide the index with the proper state. We are differentiating between three
+different state. The first one is the persisted one, basically the builder state is a resource description as well, and
+it provides a content that is based on the persisted state of the files (in our case the modules and package.json file)
+on the file system. The second one is the live scoped index, this is modification and dirty state aware. Namely when using
+this resource descriptions then an object description will be searched in the resource set itself first, then in the dirty
+editor’s index, finally among the persisted ones. The third index is the named builder scoped one. This index should not be
+used by common client code, since it is designed and implemented for the Xtex builder itself.</simpara>
+<simpara>A resource set and hence the index can be acquired from the N4JS core, in such cases an optional N4JS project can be specified.
+The N4JS project argument is used to retrieve the underlying Eclipse resource project (if present) and get the resource set from
+the resource set provider. This is completely ignored when the application is running in headless mode and Eclipse resource
+projects are not available. It is also important to note that the resource set is always configured to load only the persisted
+states.</simpara>
+<simpara>When the Eclipse platform is running, the workspace is available and the all N4JS projects are backed by an Eclipse resource
+project. With the Eclipse resource project the resource sets can be initialized properly via the resource set initializer
+implementations. This mechanism is used to get the global objects (such as console) and the built-in types (such as string,
+number) into the resource set via the corresponding resource set adapters. In the headless case a special resource set
+implementation is used; <literal>ResourceSetWithBuiltInScheme</literal>. This implementation is responsible to initialize the globals and the
+built-in types into itself.</simpara>
+</section>
+</section>
+<section xml:id="sec:Design_Overview" role="language-n4js">
+<title>Design Overview</title>
+<simpara><link linkend="fig:cd_TypeModelWithXtextIndex">Type Model With Xtext Index</link> shows a simplified UML class diagram with the involved
+classes. In the figure, a class (defined as N4ClassExpression in the <link linkend="AC">AST</link> and its type TClass) is used as a sample,
+declared type—roles or enums are handled similarly.</simpara>
+<simpara>In the Eclipse project build the <literal>N4JSResourceDescriptionManager</literal> (resp. by the logic of its super class) is called by the
+<literal>N4JSGenerateImmediatelyBuilderState</literal> to get the resource description for a resource. The resource description manager loads
+the resource to create / update the resource descriptions. Loading an Xtext resource means that it is reparsed again.
+All cross references are handled here only by the lazy linker so that the node model will contain an unresolved proxy
+for all cross references.</simpara>
+<simpara>After the resource is loaded there is a derived state installed to the resource. For this the <literal>N4JSDerivedStateComputer</literal> will
+be called. It will take the parse result (= EObject tree in first slot of the resource) and navigate through these objects
+to create type trees for each encountered exportable object that are stored in exported <literal>TModule</literal> of the resource.
+<link linkend="fig:cd_CreateTypeFromAST">Create Type From AST</link>, a snippet of <link linkend="fig:cd_TypeModelWithXtextIndex">Type Model with Xtext Index</link>,
+shows only the classes involved when creating the types from the resource.</simpara>
+<figure xml:id="fig:cd_CreateTypeFromAST" role="center">
+<title>Type From AST</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/07_typeindex/images/cd_CreateTypeFromAST.png"/>
+</imageobject>
+<textobject><phrase>cd CreateTypeFromAST</phrase></textobject>
+</mediaobject>
+</figure>
+<figure xml:id="fig:cd_TypeModelWithXtextIndex" role="center">
+<title>Create Type From Index</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/07_typeindex/images/cd_CreateTypeFromIndex.png"/>
+</imageobject>
+<textobject><phrase>cd CreateTypeFromIndex</phrase></textobject>
+</mediaobject>
+</figure>
+<figure xml:id="fig:cd_SerializeToIndex" role="center">
+<title>Serialize To Index</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/07_typeindex/images/cd_SerializeToIndex.png"/>
+</imageobject>
+<textobject><phrase>cd SerializeToIndex</phrase></textobject>
+</mediaobject>
+</figure>
+<simpara role="language-javascript">For these elements types have to be derived as they are exportable: <literal>N4ClassDeclaration</literal>, <literal>N4RoleDeclaration</literal>, <literal>N4InterfaceDeclaration</literal>,
+<literal>N4EnumDeclaration</literal>, <literal>ExportedVariableDeclaration</literal> and <literal>FunctionDeclaration</literal>.</simpara>
+<simpara>After loading and initializing the resources now all cross references in the resources are resolved. For this the
+<literal>ErrorAwareLinkingService</literal> is used. This class will in turn call the <literal>N4JSScopeProvider</literal> to first try to do scoping locally
+but eventually also delegate to the global scope provider to find linked elements outside the current resource. This
+will be done e.g. for every import statement inside the N4JS resource.</simpara>
+<simpara>For determine the global scope all visible containers for this resource are calculated. For this the project description
+(= loaded package.json file) is used to determine which folders of the current project should be included for looking for
+N4JS resources. Also all referenced projects and their resources are added to the visible containers. For these containers
+<literal>N4JSGlobalScopeProvider</literal> builds up a container scope. This container scope will be a <literal>N4JSTypesScope</literal> instance.</simpara>
+<simpara>For the actual linked element in the resource to be resolved, its fully qualified name is used. This name is calculated by
+using the <literal>IQualifiedNameConverter</literal>. We bound a custom class named <literal>N4JSQualifiedNameConverter</literal> who converts the <literal>/</literal> inside the
+qualified name to a dot, so e.g. <literal>my/module/MyFileName</literal> is converted to <literal>my.module.MyFileName</literal>. Btw. the initial qualified name
+was derived from the node model.</simpara>
+<simpara>With this qualified name <literal>N4JSTypeScope.getSingleElement</literal> is called. This method does the actual resolving of the cross reference.
+For this the URI of the cross reference is used to determine the linked resource.</simpara>
+<simpara>There are now three cases:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>If the resource which contains the linked EObject is already loaded the EObject description found for the URI is returned</simpara>
+</listitem>
+<listitem>
+<simpara>If the resource is not loaded but the first slot of the resource is empty the referenced type is tried to be rebuild from
+an existing resource description for the linked resource inside the Xtext index.</simpara>
+</listitem>
+<listitem>
+<simpara>If the resource is not loaded and the first slot is set, the linked EObject will be resolved with the fragment of the
+given URI.</simpara>
+</listitem>
+</itemizedlist>
+<simpara>While calculating the resource description for a <literal>N4JSResource</literal>, the EObject descriptions of their exported objects have to be
+calculated as well. For this the <literal>N4JSResourceDescriptionStrategy</literal> is used. For computing the exported objects of a resource only
+the root <literal>TModule</literal> and its contained types and variables are taken in consideration.</simpara>
+<simpara>The EObjectDescriptions for a n4js resource include:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>An exported representation of the derived <literal>TModule</literal>. This carries these properties:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>a qualified name (e.g. <literal>my.module.MyFileName</literal> when the resource is stored under <literal>src/my/module/MyFileName.js</literal> in the project and
+the project description has marked src has src folder). The calculation of the qualified name is delegated to the <literal>N4JSNamingUtil</literal>.</simpara>
+</listitem>
+<listitem>
+<simpara>the user data which is the serialized string of the exported <literal>TModule</literal> itself. It includes the types determined for this
+resource, so for every element found in this resource, that is contained in an <literal>ExportStatement</literal>, an EObject has been created
+before in <literal>N4JSDerivedStateComputer</literal>. In most cases this an EObject extending <literal>Type</literal> from the types model, e.g. <literal>TClass</literal> for
+<literal>N4ClassDeclaration</literal>. There is an exception for <literal>ExportedVariableDeclaration</literal> where <literal>TVariable</literal> is used as representative (and this
+EObject is not contained in the types model only in the N4JS model). For usability reasons (quicker quick fix etc.), also
+top level types not exported yet are stored in the <literal>TModel</literal>.</simpara>
+</listitem>
+<listitem>
+<simpara>the information on project and vendor id are part of the module descriptor.</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+<listitem>
+<simpara>Descriptions for all top level types that are defined in the resource. These descriptions do not have any special properties,
+so they just have a name.</simpara>
+</listitem>
+<listitem>
+<simpara>All exported variables are also described in the resource description. They don’t carry any special information either.</simpara>
+</listitem>
+</itemizedlist>
+<simpara>The EObjectDescription for an EObject contained in an <literal>ExportStatement</literal>:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>the qualified name of the module export (e.g. for a <literal>N4ClassDeclaration</literal> the qualified name <literal>my.module.MyFileName.MyClassName</literal> would
+be produced, when the resource is stored under <literal>src/my/module/MyFileName.js</literal> in the project, the project description has marked
+src has src folder and the N4 class uses the name MyClassName]). The calculation of the qualified name is delegated to the
+<literal>N4JSNamingUtil</literal>.</simpara>
+</listitem>
+<listitem>
+<simpara>the EObject represented by the EObject description, here this is not the actual EObject from N4JS but the type EObject from
+the TypeSystem, that has been inferenced by using <literal>N4JSTypeInferencer</literal></simpara>
+</listitem>
+<listitem>
+<simpara>the user data is only an empty map for this EObjectDescription</simpara>
+</listitem>
+</itemizedlist>
+<simpara>With this the resource description for a resource should be fully created / updated. <link linkend="fig:cd_SerializeToIndex">Serialize to Index</link>
+shows the classes involved creating the resource and EObjectDescriptions, along with the serialized type information.</simpara>
+</section>
+<section xml:id="sec:N4JS_Resource_Load_States">
+<title>N4JS Resource Load States</title>
+<simpara>Below state diagram depicts the state transitions when loading and resolving an N4JS resource.</simpara>
+<figure role="center">
+<title>N4JS Resource resolution states</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/07_typeindex/images/resource_set_load_states.png"/>
+</imageobject>
+<textobject><phrase>resource set load states</phrase></textobject>
+</mediaobject>
+</figure>
+<simpara>Additionally, the following table relates the values of the resource&#8217;s flags to the states.</simpara>
+<informaltable frame="all" rowsep="1" colsep="1">
+<tgroup cols="9">
+<colspec colname="col_1" colwidth="11.1111*"/>
+<colspec colname="col_2" colwidth="11.1111*"/>
+<colspec colname="col_3" colwidth="11.1111*"/>
+<colspec colname="col_4" colwidth="11.1111*"/>
+<colspec colname="col_5" colwidth="11.1111*"/>
+<colspec colname="col_6" colwidth="11.1111*"/>
+<colspec colname="col_7" colwidth="11.1111*"/>
+<colspec colname="col_8" colwidth="11.1111*"/>
+<colspec colname="col_9" colwidth="11.1112*"/>
+<thead>
+<row>
+<entry align="left" valign="top">State</entry>
+<entry align="left" valign="top">Parse Result</entry>
+<entry align="left" valign="top">AST</entry>
+<entry align="left" valign="top">TModule</entry>
+<entry align="left" valign="top">ASTMetaInfoCache</entry>
+<entry align="left" valign="top">loaded</entry>
+<entry align="left" valign="top">fullyInitialized</entry>
+<entry align="left" valign="top">fullyProcessed</entry>
+<entry align="left" valign="top">reconciled</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry align="left" valign="top"><simpara><emphasis role="strong">Created</emphasis></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>null</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>null</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>null</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>null</literal></simpara></entry>
+<entry align="left" valign="top"><simpara>false</simpara></entry>
+<entry align="left" valign="top"><simpara>false</simpara></entry>
+<entry align="left" valign="top"><simpara>false</simpara></entry>
+<entry align="left" valign="top"><simpara>false</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><emphasis role="strong">Created'</emphasis></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>null</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>null</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>null</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>null</literal></simpara></entry>
+<entry align="left" valign="top"><simpara>false</simpara></entry>
+<entry align="left" valign="top"><simpara>true</simpara></entry>
+<entry align="left" valign="top"><simpara>false</simpara></entry>
+<entry align="left" valign="top"><simpara>false</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><emphasis role="strong">Loaded</emphasis></simpara></entry>
+<entry align="left" valign="top"><simpara>available</simpara></entry>
+<entry align="left" valign="top"><simpara>with lazy linking proxies</simpara></entry>
+<entry align="left" valign="top"><simpara><literal>null</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>null</literal></simpara></entry>
+<entry align="left" valign="top"><simpara>true</simpara></entry>
+<entry align="left" valign="top"><simpara>false</simpara></entry>
+<entry align="left" valign="top"><simpara>false</simpara></entry>
+<entry align="left" valign="top"><simpara>false</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><emphasis role="strong">Pre-linked</emphasis></simpara></entry>
+<entry align="left" valign="top"><simpara>available</simpara></entry>
+<entry align="left" valign="top"><simpara>with lazy linking proxies</simpara></entry>
+<entry align="left" valign="top"><simpara>with stubs</simpara></entry>
+<entry align="left" valign="top"><simpara><literal>null</literal></simpara></entry>
+<entry align="left" valign="top"><simpara>true</simpara></entry>
+<entry align="left" valign="top"><simpara>true</simpara></entry>
+<entry align="left" valign="top"><simpara>false</simpara></entry>
+<entry align="left" valign="top"><simpara>false</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><emphasis role="strong">Fully Initialized</emphasis></simpara></entry>
+<entry align="left" valign="top"><simpara>available</simpara></entry>
+<entry align="left" valign="top"><simpara>with lazy linking proxies</simpara></entry>
+<entry align="left" valign="top"><simpara>with DeferredTypeRefs</simpara></entry>
+<entry align="left" valign="top"><simpara><literal>null</literal></simpara></entry>
+<entry align="left" valign="top"><simpara>true</simpara></entry>
+<entry align="left" valign="top"><simpara>true</simpara></entry>
+<entry align="left" valign="top"><simpara>false</simpara></entry>
+<entry align="left" valign="top"><simpara>false</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><emphasis role="strong">Fully Processed</emphasis></simpara></entry>
+<entry align="left" valign="top"><simpara>available</simpara></entry>
+<entry align="left" valign="top"><simpara>available</simpara></entry>
+<entry align="left" valign="top"><simpara>available</simpara></entry>
+<entry align="left" valign="top"><simpara>available</simpara></entry>
+<entry align="left" valign="top"><simpara>true</simpara></entry>
+<entry align="left" valign="top"><simpara>true</simpara></entry>
+<entry align="left" valign="top"><simpara>true</simpara></entry>
+<entry align="left" valign="top"><simpara>false</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><emphasis role="strong">Loaded from Description</emphasis></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>null</literal></simpara></entry>
+<entry align="left" valign="top"><simpara>proxy</simpara></entry>
+<entry align="left" valign="top"><simpara>available</simpara></entry>
+<entry align="left" valign="top"><simpara><literal>null</literal></simpara></entry>
+<entry align="left" valign="top"><simpara>indeterminate</simpara></entry>
+<entry align="left" valign="top"><simpara>true</simpara></entry>
+<entry align="left" valign="top"><simpara>true</simpara></entry>
+<entry align="left" valign="top"><simpara>false</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><emphasis role="strong">Loaded from Description'</emphasis></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>null</literal></simpara></entry>
+<entry align="left" valign="top"><simpara>proxy</simpara></entry>
+<entry align="left" valign="top"><simpara>with DeferredTypeRefs</simpara></entry>
+<entry align="left" valign="top"><simpara><literal>null</literal></simpara></entry>
+<entry align="left" valign="top"><simpara>indeterminate</simpara></entry>
+<entry align="left" valign="top"><simpara>true</simpara></entry>
+<entry align="left" valign="top"><simpara>true</simpara></entry>
+<entry align="left" valign="top"><simpara>false</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><emphasis role="strong">Fully Initialized ®</emphasis></simpara></entry>
+<entry align="left" valign="top"><simpara>available</simpara></entry>
+<entry align="left" valign="top"><simpara>with lazy linking proxies</simpara></entry>
+<entry align="left" valign="top"><simpara>available</simpara></entry>
+<entry align="left" valign="top"><simpara><literal>null</literal></simpara></entry>
+<entry align="left" valign="top"><simpara>indeterminate</simpara></entry>
+<entry align="left" valign="top"><simpara>true</simpara></entry>
+<entry align="left" valign="top"><simpara>false</simpara></entry>
+<entry align="left" valign="top"><simpara>true</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><emphasis role="strong">Fully Processed ®</emphasis></simpara></entry>
+<entry align="left" valign="top"><simpara>available</simpara></entry>
+<entry align="left" valign="top"><simpara>available</simpara></entry>
+<entry align="left" valign="top"><simpara>available</simpara></entry>
+<entry align="left" valign="top"><simpara>available</simpara></entry>
+<entry align="left" valign="top"><simpara>indeterminate</simpara></entry>
+<entry align="left" valign="top"><simpara>true</simpara></entry>
+<entry align="left" valign="top"><simpara>true</simpara></entry>
+<entry align="left" valign="top"><simpara>true</simpara></entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+<simpara>Remarks:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>oddities are shown in red ink, in the above figure.</simpara>
+</listitem>
+<listitem>
+<simpara>in the above figure:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>"AST (proxy)" means the AST consists of only a single node of type <literal>Script</literal> and that is a proxy,</simpara>
+</listitem>
+<listitem>
+<simpara>"AST (lazy)" means the AST is completely created, but cross-references are represented by unresolved
+Xtext lazy-linking proxies,</simpara>
+</listitem>
+<listitem>
+<simpara>"TModule (stubs)" means the TModule has been created with incomplete information, e.g. return types of
+all TMethods/TFunctions will be <literal>null</literal> (only used internally by the incremental builder),</simpara>
+</listitem>
+<listitem>
+<simpara>"TModule (some deferred)" means the TModule has been created, does not contain stub, but some
+`TypeRef`s are `DeferredTypeRef`s that are supposed to be replaced by proper `TypeRef`s during post-processing.</simpara>
+</listitem>
+<listitem>
+<simpara>"AST" and "TModule" means the AST/TModule is available without any qualifications.</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+<listitem>
+<simpara>state <emphasis role="strong">Created'</emphasis>: only required because Xtext does not clear flag <literal>fullyInitialized</literal> upon unload; that is done lazily
+when <literal>#load()</literal> is invoked at a later time.. Thus, we do not reach state <emphasis role="strong">Created</emphasis> when unloading from state
+<emphasis role="strong">Fully Initialized</emphasis> but instead get to state <emphasis role="strong">Created'</emphasis>. To reach state <emphasis role="strong">Created</emphasis> from <emphasis role="strong">Fully Initialized</emphasis> we have to
+explicitly invoke <literal>#discardDerivedState()</literal> before(!) unloading.</simpara>
+</listitem>
+<listitem>
+<simpara>state <emphasis role="strong">Loaded from Description'</emphasis>: transition <literal>#unloadAST()</literal> from state <emphasis role="strong">Fully Initialized</emphasis> leaks a non-post-processed
+TModule into state <emphasis role="strong">Loaded from Description</emphasis>, which is inconsistent with actually loading a TModule from the index,
+because those are always fully processed. Hence, the addition of state <emphasis role="strong">Loaded from Description'</emphasis>.</simpara>
+</listitem>
+<listitem>
+<simpara>states <emphasis role="strong">Fully Initialized ®</emphasis> and <emphasis role="strong">Fully Processed ®</emphasis>: these states are reached via reconciliation of a pre-existing
+TModule with a newly loaded AST. These states differ in an unspecified way from their corresponding non-reconciled
+states. For example, in state <emphasis role="strong">Fully Initialized ®</emphasis> the TModule does not contain any DeferredTypeRefs while, at the
+same time, the TModule isn&#8217;t fully processed, because proxy resolution, typing, etc. have not taken place, yet.</simpara>
+</listitem>
+<listitem>
+<simpara>TODO old text (clarify this; I could not reproduce this behavior): when <literal>unloadAST</literal> is called, <literal>fullyInitialized</literal> remains
+unchanged. This is why the value of <literal>fullyInitialized</literal> should be indeterminate in row <emphasis role="strong">Loaded from Description</emphasis>; it
+depends on the previous value if the state <emphasis role="strong">Loaded from Description</emphasis> was reached by calling <literal>unloadAST</literal>.</simpara>
+</listitem>
+</itemizedlist>
+</section>
+<section xml:id="sec:Type_Builder" role="language-n4js">
+<title>Types Builder</title>
+<simpara>When a resource is loaded, it is parsed, linked, post-processed, validated and eventually compiled. For linking and validation
+type information is needed, and as described above the type information is created automatically when loading a resource using
+the types builder. <link linkend="fig:ad_resourceLoading">Resource Loading</link> shows an activity model with the different actions performed when
+a resource is loaded.</simpara>
+<figure xml:id="fig:ad_resourceLoading" role="center">
+<title>Activity Diagram, Resource Loading</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/07_typeindex/images/ad_resourceLoading.png"/>
+</imageobject>
+<textobject><phrase>ad resourceLoading</phrase></textobject>
+</mediaobject>
+</figure>
+<simpara>The blue colored steps are standard Xtext workflow. Handling the TModule and storing that in the index are N4 specific (red background).</simpara>
+<section xml:id="sec:Type_Inference_not_allowed_in_Type_Builder">
+<title>Type Inference not allowed in Types Builder</title>
+<simpara>A crucial point in the workflow described above is the combination of types model building and type inference. In some cases,
+the type of a given element is not directly stated in the AST but has to be inferred from an expression and other types. For
+example, when a variable declaration does not declare the variable’s type explicitly but provides an initializer expression,
+the actual type of the variable is inferred to be the type of the expression.</simpara>
+<simpara>However, the types builder cannot be allowed to use type inference, mainly for two reasons:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>type inference through Xsemantics could lead to resolution of cross-references (i.e. EMF proxies generated by the lazy
+linker) and because the types builder is triggered when getContents() is called on the containing <literal>N4JSResource</literal> this would
+break a basic contract of EMF resources.</simpara>
+</listitem>
+<listitem>
+<simpara>type inference could cause other resources to be loaded which would lead to problems (infinite loops or strange results)
+in case of circular dependencies. This is illustrated in <link linkend="fig:sd_typesBuilder_problem">Types Builder Problem</link> and
+<link linkend="fig:sd_typesBuilder_proxies">Types Builder Proxies</link>.</simpara>
+</listitem>
+</orderedlist>
+<simpara>Therefore, whenever the type of a particular element has to be inferred, the types builder will use a special type reference
+called <literal>DeferredTypeRef</literal> <footnote><simpara>The <literal role="language-n4js">DeferredTypeRef</literal> has replaced the old <literal role="language-n4js">ComputedTypeRef</literal> that had been used until Summer 2015; those were resolved lazily when the type was actually needed (triggered on demand). For a discussion of this change see <xref linkend="sec:Type_Inference_combined_with_AST_Traversal__Background"/> and in particular <xref linkend="tab:typeInferenceBeforeAfter"/>.</simpara></footnote>,
+in order to defer the actual type inference to a later stage, i.e. the post-processing stage.</simpara>
+<figure xml:id="fig:sd_typesBuilder_problem" role="center">
+<title>Sequence Diagram, Types Builder Problem</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/07_typeindex/images/sd_typesBuilder_problem.png"/>
+</imageobject>
+<textobject><phrase>sd typesBuilder problem</phrase></textobject>
+</mediaobject>
+</figure>
+<figure xml:id="fig:sd_typesBuilder_proxies" role="center">
+<title>Sequence Diagram, Types Builder with Proxies</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/07_typeindex/images/sd_typesBuilder_proxies.png"/>
+</imageobject>
+<textobject><phrase>sd typesBuilder proxies</phrase></textobject>
+</mediaobject>
+</figure>
+</section>
+<section xml:id="sec:ComputedTypeReferences">
+<title>Deferred Type References</title>
+<simpara>Whenever type inference would be required to obtain the actual type of an element, the types builder will insert a stub to defer
+actual type inference (see previous section). A dedicated subclass of <literal>TypeRef</literal>, called <literal>DeferredTypeRef</literal>, is used that contains neither
+the actual type information nor any information necessary to perform the type inference at a later point in time. Later, this
+<literal>DeferredTypeRef</literal> will be replaced during post-processing, see <literal>TypeDeferredProcessor</literal>.</simpara>
+<simpara>All <literal>DeferredTypeRef</literal>s will be replaced by the actual types during post-processing. One important reason for resolving
+all <literal>DeferredTypeRef</literal>s as early as possible is that they are not suited for serialization and therefore have to be removed
+from the types model before populating the Xtext index, which includes serializing the TModule into the user data of the
+root element. This is always assured by the logic that manages the triggering of the post-processing phase.</simpara>
+<simpara>To manually trigger resolution of all <literal>DeferredTypeRef</literal>s in a given types model, simply call method <literal>performPostProcessing(CancelIndicator)</literal>
+of the containing <literal>N4JSResource</literal> (should never be required by client code such as validations).</simpara>
+</section>
+<section xml:id="sec:Use_cases_of_ComputedTypeRef">
+<title>Use cases of DeferredTypeRef</title>
+<simpara>Currently, <literal>DeferredTypeRef</literal>s are created by the types builder only in these cases:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>actual type of an exported TVariable if no declared type but an initialization expression are given.</simpara>
+</listitem>
+<listitem>
+<simpara>actual type of a TField if no declared type but an initialization expression are given.</simpara>
+</listitem>
+<listitem>
+<simpara>actual type of properties of ObjectLiterals if not declared explicitly.</simpara>
+</listitem>
+<listitem>
+<simpara>actual type of formal parameters and return value of function expressions if not declared explicitly.</simpara>
+</listitem>
+</orderedlist>
+<simpara>Note that this overview might easily get out-dated; see references to class <literal>DeferredTypeRef</literal> in the code.</simpara>
+</section>
+</section>
+<section xml:id="sec:Incremental_Builder_Overview" role="language-n4js">
+<title>Incremental Builder (Overview)</title>
+<simpara>This section provides a brief overview of how the incremental builder works.</simpara>
+<simpara>General remarks:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>The N4JS incremental builder is a combination of Eclipse builder infrastructure, Xtext-specific builder functionality and
+several adjustments for N4JS and N4MF.</simpara>
+</listitem>
+<listitem>
+<simpara>The <literal>IBuilderState</literal> implementation is identical to the persisted Xtext index. No matter how many Xtext languages are supported
+by the application, only a single <literal>IBuilderState</literal> instance is available in the application. Since we have one single <literal>IBuilderState</literal>,
+we have one single persisted Xtext index throughout the application.</simpara>
+</listitem>
+<listitem>
+<simpara>For simplicity, the below description assumes we have only N4JS projects in the workspace and no other Xtext languages are
+installed.</simpara>
+</listitem>
+</itemizedlist>
+<simpara>Major components:</simpara>
+<itemizedlist>
+<listitem>
+<simpara><literal>XtextBuilder</literal> (inherits from Eclipse’s <literal>IncrementalProjectBuilder</literal>):</simpara>
+<itemizedlist>
+<listitem>
+<simpara>the actual incremental builder</simpara>
+</listitem>
+<listitem>
+<simpara>note: Eclipse will create one instance of <literal>XtextBuilder</literal> per project at startup.</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+<listitem>
+<simpara><literal>IBuilderState</literal> (Xtext specific; no Eclipse pendant):<?asciidoc-br?>
+identical to the <literal>Xtext index</literal>, i.e. the globally shared, persisted instance of<?asciidoc-br?>
+<literal>IResourceDescriptions</literal>.</simpara>
+</listitem>
+</itemizedlist>
+<simpara>Main workflow:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>for each project  that contains at least one resource that requires rebuilding, Eclipse will call the
+project’s <literal>XtextBuilder</literal>.</simpara>
+</listitem>
+<listitem>
+<simpara>each <literal>XtextBuilder</literal> will perform some preparations and will then delegate to <literal>IBuilderState</literal> which will iterate over
+all resources in the builder’s project that require rebuilding.</simpara>
+</listitem>
+</orderedlist>
+<section xml:id="sec:Incremental_Builder_Overview__XtextBuilder">
+<title>XtextBuilder</title>
+<simpara>Whenever a change in the workspace happens &#8230;&#8203;</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara><anchor xml:id="itm:start" xreflabel="[itm:start]"/> Eclipse will collect all projects that contain changed resources and compute a project-level build
+order (using the <literal>build order</literal> of the workspace, see <literal>Workspace#getBuildOrder()</literal>, which is based on project dependencies)</simpara>
+</listitem>
+<listitem>
+<simpara>for the first <footnote><simpara>First, according to the build order.</simpara></footnote> project with changed resources, Eclipse will invoke
+   method <literal>IncrementalProjectBuilder#build(int,Map,IProgressMonitor)</literal> of the project’s <literal>XtextBuilder</literal><?asciidoc-br?>
+(NOTE: from this point on, we are in the context of a <literal>current project</literal>)</simpara>
+</listitem>
+<listitem>
+<simpara>in <literal>XtextBuilder#build(int,Map,IProgressMonitor)</literal>:<?asciidoc-br?>
+the builder creates an empty instance of <literal>ToBeBuilt</literal> (Xtext specific)</simpara>
+</listitem>
+<listitem>
+<simpara>in <literal>XtextBuilder#incrementalBuild(IResourceDelta,IProgressMonitor)</literal>:</simpara>
+<orderedlist numeration="loweralpha">
+<listitem>
+<simpara>The builder will iterate over all files in the project and for each will notify a <literal>ToBeBuiltComputer</literal> about the
+change (added, updated, or deleted) which can then decide how to update the <literal>ToBeBuilt</literal> instance,</simpara>
+</listitem>
+<listitem>
+<simpara>then forwards to <literal>#doBuild()</literal> .</simpara>
+<simpara>Note: if user changes 1..* files in a single project  but later more files in other, dependant projects
+ need to be built, the above step will happen for all projects, but will have an effect only for the first project  that contains the actual file changes (i.e. in the standard case of saving a single file <literal>ToBeBuilt</literal> will always be non-empty for the <literal>first</literal> project, and always empty for the other, dependant projects; if a <literal>Save All</literal> is done, <literal>ToBeBuilt</literal> could be non-empty for later projects as well).</simpara>
+</listitem>
+</orderedlist>
+</listitem>
+<listitem>
+<simpara>in <literal>XtextBuilder#doBuild(ToBeBuilt,IProgressMonitor,BuildType)</literal>:</simpara>
+<orderedlist numeration="loweralpha">
+<listitem>
+<simpara>first check if <literal>ToBeBuilt</literal> is empty AND global build queue does not contain URIs for current project &#8594; then abort (nothing to do here)</simpara>
+</listitem>
+<listitem>
+<simpara>creates instance of BuildData with:</simpara>
+<orderedlist numeration="lowerroman">
+<listitem>
+<simpara>name of current project (as string)</simpara>
+</listitem>
+<listitem>
+<simpara>newly created, fresh <literal>ResourceSet</literal></simpara>
+</listitem>
+<listitem>
+<simpara>the <literal>ToBeBuilt</literal> (containing URIs of actually changed resources within current project, possibly filtered by <literal>ToBeBuiltComputer</literal>)</simpara>
+</listitem>
+<listitem>
+<simpara>the <literal>QueuedBuildData</literal> (an injected singleton)</simpara>
+</listitem>
+<listitem>
+<simpara>mode flag <literal>indexingOnly</literal> (only true during crash recovery)</simpara>
+</listitem>
+</orderedlist>
+</listitem>
+<listitem>
+<simpara>invoke <literal>IBuilderState</literal> passing the <literal>BuildData</literal><?asciidoc-br?>
+&#8594; updates itself (it is the global Xtext index) to reflect all changes in <literal>current project</literal>; validates and updates markers; runs transpiler (see below for details)</simpara>
+</listitem>
+<listitem>
+<simpara>invoke all registered <literal>IXtextBuilderParticipants</literal> (Xtext specific) for the <literal>current project</literal></simpara>
+<itemizedlist>
+<listitem>
+<simpara>this is where normally we would do validation and run the transpiler; however, for performance reasons (do not load resource again) we already do this in the <literal>IBuilderState</literal> (this is the idea of the <literal>GenerateImmediatelyBuilderState</literal>)</simpara>
+</listitem>
+<listitem>
+<simpara>in our implementation, almost nothing is done here, except trivial stuff such as deleting files during clean build</simpara>
+<simpara>At this point: returning from all methods.</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+</orderedlist>
+</listitem>
+<listitem>
+<simpara>back in <literal>XtextBuilder#build(int,Map,IProgressMonitor)</literal>:<?asciidoc-br?>
+&#8594; return with an array of IProjects; in our case: we return all other N4JSProjects referenced in the package.json of the project</simpara>
+<itemizedlist>
+<listitem>
+<simpara>important: these are <emphasis role="strong">not</emphasis> the projects that will be processed next: we need to continue with projects that depend on the current project, not with projects the current project depends on!</simpara>
+</listitem>
+<listitem>
+<simpara>Eclipse calls the returned projects <literal>interestingProjects</literal> and uses that as a hint for further processing; details not discussed here.</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+<listitem>
+<simpara>continue with step <link linkend="itm:start">one</link>:<?asciidoc-br?>
+Eclipse will invoke <literal>XtextBuilder#build(int,Map,IProgressMonitor)</literal> again for all other projects that have a dependency to the <literal>current project</literal> of the previous iteration, plus all remaining projects with changed resources.</simpara>
+</listitem>
+</orderedlist>
+</section>
+<section xml:id="sec:Incremental_Builder_Overview__IBuilderState">
+<title>IBuilderState</title>
+<simpara>Invoked: once for each project containing a changed resource and dependant projects.<?asciidoc-br?>
+Input: one instance of <literal>BuildData</literal>, as created by <literal>XtextBuilder</literal>, containing:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>name of current project (as string)</simpara>
+</listitem>
+<listitem>
+<simpara>newly created, fresh <literal>ResourceSet</literal></simpara>
+</listitem>
+<listitem>
+<simpara>the <literal>ToBeBuilt</literal></simpara>
+<orderedlist numeration="loweralpha">
+<listitem>
+<simpara>set of to-be-deleted URIs</simpara>
+</listitem>
+<listitem>
+<simpara>set of to-be-updated URIs</simpara>
+</listitem>
+</orderedlist>
+</listitem>
+<listitem>
+<simpara>the <literal>QueuedBuildData</literal>, an injected singleton maintaining the following values <footnote><simpara>These are not really input values but rather values changed during the following invocation of the IBuilderState that need to be carried over from one invocation to the next.</simpara></footnote>:</simpara>
+<orderedlist numeration="loweralpha">
+<listitem>
+<simpara>a queue of URIs per project (below called the <literal>global queue</literal>)<?asciidoc-br?>
+(actually stored in <literal>QueuedBuildData#projectNameToChangedResource</literal>)</simpara>
+</listitem>
+<listitem>
+<simpara>a collection of <literal>all remaining URIs</literal><?asciidoc-br?>
+(derived value: queued URIs of all projects + queues URIs not associated to a project (does not happen in N4JS))</simpara>
+</listitem>
+<listitem>
+<simpara>a collection of <literal>pending deltas</literal> (always empty in N4JS; probably only used for interaction with Java resources)</simpara>
+</listitem>
+</orderedlist>
+</listitem>
+<listitem>
+<simpara>mode flag <literal>indexingOnly</literal> (only true during crash recovery)</simpara>
+</listitem>
+</orderedlist>
+<section xml:id="copy-and-update-xtext-index">
+<title>Copy and Update Xtext Index</title>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>in <literal>IBuilderState#update(BuildData,IProgressMonitor)</literal>:<?asciidoc-br?>
+creates a copy of its <literal>ResourceDescriptionsData</literal> called <literal>newData</literal> <footnote><simpara>Once the build phase has ended, this copied and modified Xtext index will replace the actual state of the builder state and will be persisted on graceful application shutdown.</simpara></footnote></simpara>
+</listitem>
+<listitem>
+<simpara>in <literal>AbstractBuilderState#doUpdate(&#8230;&#8203;)</literal>:<?asciidoc-br?>
+updates <literal>newData</literal> by writing new resource descriptions into it.</simpara>
+<itemizedlist>
+<listitem>
+<simpara>Creates a new load operation (<literal>LoadOperation</literal>) instance from the <literal>BuildData#getToBeUpdated()</literal> and loads all entries. While iterating and loading the resource descriptions, it updates <literal>newData</literal> by registering new resource descriptions that are being created on the fly from the most recent version of the corresponding resources.</simpara>
+</listitem>
+<listitem>
+<simpara>Adds these resources to the current project’s build queue. (<literal>BuildData#queueURI(URI uri)</literal>)</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+<listitem>
+<simpara>for all to-be-deleted URIs given in <literal>ToBeBuilt</literal> in the <literal>BuildData</literal>, removes the corresponding <literal>IResourceDescription</literal> from <literal>newData</literal></simpara>
+<itemizedlist>
+<listitem>
+<simpara><literal>ToBeBuilt#getAndRemoveToBeDeleted()</literal> returns all URIs that have been marked for deletion but not marked for update and will clear the set of to-be-deleted URIs in <literal>ToBeBuilt</literal>.</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+</orderedlist>
+</section>
+<section xml:id="build-state-setup-phase">
+<title>Build State Setup Phase</title>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>Calculates a set <literal>allRemainingURIs</literal> <footnote><simpara>This set of URIs will contain the URIs of all resources that are available in the copied Xtext index but not yet directly processed by the builder in the current build phase. These URIs will later be used as candidates for all resources that might be marked as affected ones and queued by the builder for forthcoming build phases.</simpara></footnote> as follows:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>Initially contains all resource URIs from <literal>newData</literal>.</simpara>
+</listitem>
+<listitem>
+<simpara>All URIs will be removed from it that are marked for update (<literal>BuildData#getToBeUpdated()</literal>).</simpara>
+</listitem>
+<listitem>
+<simpara>Finally, all URIs will be removed from it that are already queued for build/rebuild. (<literal>BuildData#getAllRemainingURIs()</literal>).</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+<listitem>
+<simpara>Creates an empty set <literal>allDeltas</literal> of resource description deltas<?asciidoc-br?>
+(c.f. <literal>IResourceDescription.Delta</literal>). <footnote><simpara>This set eventually represents all changes that were made during the current build phase. Note that <literal>allChanges</literal> might contain resource description deltas that do not represent an actual change, it is processed by the builder but the underlying information stored in the user data is still unchanged.</simpara></footnote></simpara>
+</listitem>
+<listitem>
+<simpara><anchor xml:id="itm:processDeleted" xreflabel="[itm:processDeleted]"/> <emphasis role="strong">Process Deleted:</emphasis> for all to-be-deleted URIs, creates a delta where the old state is the current state of the resource and the new state is <literal>null</literal> and adds it to <literal>allDeltas</literal>.</simpara>
+</listitem>
+<listitem>
+<simpara>Adds all <literal>pending deltas</literal> from <literal>QueuedBuildData</literal> to <literal>allDeltas</literal> (does not apply to N4JS).</simpara>
+</listitem>
+<listitem>
+<simpara><emphasis role="strong"><anchor xml:id="itm:enqueueAffectedResources" xreflabel="[itm:enqueueAffectedResources]"/>Enqueue affected resources, part 1:</emphasis> adds to the <literal>global queue</literal> the URIs of all resources affected by the changes in <literal>allDeltas</literal>.</simpara>
+<note>
+<simpara>For N4JS, <literal>allDeltas</literal> always seems to be empty at this point, so this does nothing at all.</simpara>
+</note>
+</listitem>
+<listitem>
+<simpara>Creates an empty set <literal>changedDeltas</literal> for storing deltas that were modified by the build phase and represent an actual change. Unlike <literal>allDeltas</literal>, this set contains only those URIs that were processed by the builder - the underlying user data information contains the differences between the old and the new state.</simpara>
+</listitem>
+<listitem>
+<simpara>Creates a new <literal>current queue</literal> and adds all URIs from the <literal>global queue</literal> that belong to the <literal>current project</literal>.</simpara>
+</listitem>
+</orderedlist>
+</section>
+<section xml:id="process-queued-uris">
+<title>Process Queued URIs</title>
+<simpara>Processes all elements from the queue until it contains no more elements.</simpara>
+<orderedlist xml:id="itm:loadRes" numeration="arabic">
+<listitem>
+<simpara>Load the resource for the first/next URI on the current queue</simpara>
+<note>
+<simpara>In case of a move, the loaded resource could have a different URI!</simpara>
+</note>
+</listitem>
+<listitem>
+<simpara>Once the resource has been loaded, it removes its URI from the current queue to ensure it will not be processed again.</simpara>
+</listitem>
+<listitem>
+<simpara>If the loaded resource is already marked for deletion, stop processing this resource and continue with next URI from the current queue (go to step <link linkend="itm:loadRes">Load Res</link>)
+<footnote><simpara>Note that deltas for to-be-deleted resources were already added to <literal>allDeltas</literal> upfront in step <link linkend="itm:processDeleted">Process Deleted</link>.</simpara></footnote></simpara>
+</listitem>
+<listitem>
+<simpara>Resolves all lazy cross references in the loaded resource. This will trigger post-processing, including all type inference (c.f. <literal>ASTProcessor#processAST(&#8230;&#8203;)</literal>).</simpara>
+</listitem>
+<listitem>
+<simpara>Creates a delta for the loaded resource, including</simpara>
+<orderedlist numeration="loweralpha">
+<listitem>
+<simpara>a resource description based on the new state of the resource, wrapped into the <literal>EObject</literal>-based resource description (as with the Xtext index persistence in <literal>EMFBasedPersister#saveToResource()</literal>).</simpara>
+</listitem>
+<listitem>
+<simpara>a resource description for the same resource with the state before the build process.</simpara>
+</listitem>
+</orderedlist>
+</listitem>
+<listitem>
+<simpara>Adds this new delta to <literal>allDeltas</literal> and, if the delta represents a change (according to <literal>DefaultResourceDescriptionDelta#internalHasChanges()</literal>), also adds it to <literal>changedDeltas</literal>.</simpara>
+</listitem>
+<listitem>
+<simpara>Adds the resource description representing the new state, stored in the delta, to <literal>newData</literal>, i.e. the copied <literal>ResourceDescriptionsData</literal>, replacing the old resource description of the loaded resource <footnote><simpara>This happens through a call to <literal role="language-n4js">CurrentDescriptions#register(Delta)</literal></simpara></footnote>.</simpara>
+</listitem>
+<listitem>
+<simpara>If the current queue is non-empty, go to step <link linkend="itm:loadRes">Load Res</link> and continue with the next URI in the current queue.</simpara>
+</listitem>
+</orderedlist>
+</section>
+<section xml:id="queueing-affected-resources">
+<title>Queueing Affected Resources</title>
+<simpara>When the current queue contains no more URIs (all have been processed) &#8230;&#8203;</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara><anchor xml:id="itm:updateGlobalQueue" xreflabel="[itm:updateGlobalQueue]"/> <emphasis role="strong">Enqueue affected resources, part 2:</emphasis> add to the global queue URIs for all resources affected by the changes in <literal>changedDeltas</literal> <footnote><simpara>Unlike in step <link linkend="itm:enqueueAffectedResources">Enqueue Affected Resources</link>, we now use <literal>changedDeltas</literal> instead of <literal>allDeltas</literal> as a basis.</simpara></footnote>.</simpara>
+</listitem>
+<listitem>
+<simpara>Returns from <literal>#doUpdate()</literal>, returning <literal>allDeltas</literal> (only used for event notification).</simpara>
+</listitem>
+<listitem>
+<simpara>back in <literal>IBuilderState#update(BuildData,IProgressMonitor)</literal>:<?asciidoc-br?>
+makes the <literal>newData</literal> the publicly visible, persistent state of the IBuilderState (i.e. the <literal>official</literal> Xtext index all other code will see).</simpara>
+</listitem>
+</orderedlist>
+<simpara>We now provide some more details on how the global queue is being updated, i.e. steps <link linkend="itm:enqueueAffectedResources">Enqueue Affected Resources</link> and <link linkend="itm:updateGlobalQueue">Update Global Queue</link>.
+Due to the language specific customizations for N4JS, this second resource-enqueuing phase is the trickiest part of the incremental building process and has the largest impact on how other resources will be processed and enqueued at forthcoming builder state phases.</simpara>
+<itemizedlist>
+<listitem>
+<simpara>If <literal>allDeltas</literal> is empty, nothing to do.</simpara>
+</listitem>
+<listitem>
+<simpara>If <literal>allDeltas</literal> contains at least one element, we have to check other affected resources by going through the set of all resource URIs (<literal>allRemainingURIs</literal>) calculated in in the beginning of the build process.</simpara>
+</listitem>
+<listitem>
+<simpara>Assume we have at least one element in the <literal>allDeltas</literal> set, the latter case is true and we must check all elements whether they are affected or not. We simply iterate through the <literal>allRemainingURIs</literal> set and retrieve the old state of the resource description using the resource URI.</simpara>
+</listitem>
+<listitem>
+<simpara>Once the resource description with the old state is retrieved, we check if it is affected through the corresponding resource description manager. Since we currently support two languages, we have two different ways for checking whether a resource has changed or not. One for package.json files and the other for the N4JS language related resources.</simpara>
+</listitem>
+<listitem>
+<simpara>The package.json method is the following: get all project IDs referenced from the <literal>candidate</literal> package.json and compare it with the container-project name of the package.json files from the <literal>deltas</literal>. The referenced IDs are the followings:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>tested project IDs,</simpara>
+</listitem>
+<listitem>
+<simpara>implemented project IDs,</simpara>
+</listitem>
+<listitem>
+<simpara>dependency project IDs,</simpara>
+</listitem>
+<listitem>
+<simpara>provided runtime library IDs,</simpara>
+</listitem>
+<listitem>
+<simpara>required runtime library IDs and</simpara>
+</listitem>
+<listitem>
+<simpara>extended runtime environment ID.</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+<listitem>
+<simpara>The N4JS method is the following:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>We consider only those changed deltas which represent an actual change (<literal>IResourceDescription.Delta#haveEObjectDescriptionsChanged()</literal>) and have a valid file extension (<literal>.n4js</literal>, <literal>.n4jsd</literal> or <literal>.js</literal>).</simpara>
+</listitem>
+<listitem>
+<simpara>For each <literal>candidate</literal>, we calculate the imported FQNs. The imported FQNs includes indirectly imported names besides the directly imported ones. Indirectly imported FQNs are, for instance, the FQNs of all transitively extended super class names of a direct reference.</simpara>
+</listitem>
+<listitem>
+<simpara>We state that a <literal>candidate</literal> is affected if there is a dependency (for example name imported by a <literal>candidate</literal>) to any name exported by the description from a delta. That is, it computes if a candidate (with given <literal>importedNames</literal>) is affected by a change represented by the description from the delta.</simpara>
+</listitem>
+<listitem>
+<simpara>If a <literal>candidate</literal> is affected we have to do an additional dependency check due to the lack of distinct unique FQNs. If a project containing the delta equals with the project contained by the candidate, or if the project containing the candidate has a direct dependency to the project containing the delta, we mark a candidate as affected.</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+<listitem>
+<simpara>If a candidate was marked as affected, it will be removed from the <literal>allRemainingURIs</literal> and will be added to the build queue.</simpara>
+</listitem>
+<listitem>
+<simpara>If a candidate has been removed from the <literal>allRemainingURIs</literal> and queued for the build, we assume its <literal>TModule</literal> information stored in the user data is obsolete. To invalidate the obsolete information, we wrap the delta in the custom resource description delta so whenever the <literal>TModule</literal> information is asked for, it will be missing. We then register this wrapped delta into the copied Xtext index, end the builder state for the actual project then invoke the Xtext builder with the next dependent project.</simpara>
+</listitem>
+</itemizedlist>
+</section>
+</section>
+<section xml:id="sec:Incremental_Builder_Overview__Example">
+<title>Example</title>
+<simpara>To conclude this section, we briefly describe the state of the above five phases through a simple example. Assume a
+workspace with four N4JS projects: <emphasis>P1</emphasis>, <emphasis>P2</emphasis>, <emphasis>P3</emphasis> and <emphasis>PX</emphasis>. Each project has one single module with one single
+publicly visible class. Also let’s assume project <emphasis>P2</emphasis> depends on <emphasis>P1</emphasis> and <emphasis>P3</emphasis> depends on <emphasis>P2</emphasis>. Project <emphasis>PX</emphasis> have
+no dependencies to other projects. Project <emphasis>P1</emphasis> has a module <emphasis>A.n4js</emphasis> with a class <literal>A</literal>, project <emphasis>P2</emphasis> has one single
+module <emphasis>B.n4js</emphasis>. This module has a public exported class <literal>B</literal> which extends class <literal>A</literal>. Furthermore, project <emphasis>P3</emphasis> has
+one single module: <emphasis>C.n4js</emphasis>. This module contains one exported public class <literal>C</literal> which extends <literal>B</literal>. Finally, project
+<emphasis>PX</emphasis> has a module <emphasis>X.n4js</emphasis> containing a class <literal>X</literal> that has no dependencies to any other classes. The figure below
+picture depicts the dependencies between the projects, the modules and the classes as described above.</simpara>
+<figure role="center">
+<title>Builder State Example</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/07_typeindex/images/builderStateExample.png"/>
+</imageobject>
+<textobject><phrase>builderStateExample</phrase></textobject>
+</mediaobject>
+</figure>
+<simpara>For the sake of simplification, the table below describes a symbol table for all resources:</simpara>
+<table frame="all" rowsep="1" colsep="1">
+<title>Resource Symbol Table</title>
+<tgroup cols="2">
+<colspec colname="col_1" colwidth="50*"/>
+<colspec colname="col_2" colwidth="50*"/>
+<tbody>
+<row>
+<entry align="left" valign="top"><simpara>P1/src/A.n4js</simpara></entry>
+<entry align="left" valign="top"><simpara>A</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara>P2/src/B.n4js</simpara></entry>
+<entry align="left" valign="top"><simpara>B</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara>P3/src/C.n4js</simpara></entry>
+<entry align="left" valign="top"><simpara>C</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara>PX/src/X.n4js</simpara></entry>
+<entry align="left" valign="top"><simpara>X</simpara></entry>
+</row>
+</tbody>
+</tgroup>
+</table>
+<simpara>Let assume auto-build is enabled and the workspace contains no errors and/or warnings. We make one simple modification
+and expect one single validation error in class <literal>C</literal> after the incremental builder finished its processing; we delete the
+method <literal>foo()</literal> from class <literal>A</literal>.</simpara>
+<simpara>After deleting the method in the editor and saving the editor content, a workspace modification operation will run and
+that will trigger an auto-build job. The auto-build job will try to build the container project <emphasis>P1</emphasis> of module <emphasis>A</emphasis>. Since
+the project is configured with the Xtext builder command, a builder state update will be performed through the Xtext builder.
+Initially, due to an Eclipse resource change event (we literally modify the resource from the editor and save it), the
+<literal>ToBeBuilt</literal> instance wrapped into the <literal>BuildData</literal> will contain the URI of the module <emphasis>A</emphasis> marked for an update. When updating
+the copied index content, module <emphasis>A</emphasis> will be queued for a build. While processing the queued elements for project <emphasis>P1</emphasis>,
+module <emphasis>A</emphasis> will be processed and will be added to the <literal>allDeltas</literal> set. Besides that, it will be added to the <literal>changedDeltas</literal>
+set as well. That is correct, because its <literal>TModule</literal> information has been changed after deleting the public <literal>foo()</literal> method.
+When queuing affected resources, iterating through the set of <literal>allRemainingURIs</literal>, we recognize that module <emphasis>B</emphasis> is affected.
+That is indeed true; module <emphasis>B</emphasis> imports the qualified name of class <literal>A</literal> from module <emphasis>A</emphasis> and project <emphasis>P2</emphasis> has a direct
+dependency to <emphasis>P1</emphasis>. In this builder state phase, when building project <emphasis>P1</emphasis>, module <emphasis>C</emphasis> is not considered as affected.
+Although class <literal>C</literal> from module <emphasis>C</emphasis> also imports the qualified name of class <literal>A</literal> from module <emphasis>A</emphasis>, project <emphasis>P3</emphasis> does not
+have a direct dependency to project <emphasis>P1</emphasis>. When module <emphasis>B</emphasis> becomes enqueued for a forthcoming build phase, we assume its
+<literal>TModule</literal> information is obsolete. We invalidate this <literal>TModule</literal> related user data information on the resource description
+by wrapping the resource description into a custom implementation (<literal>ResourceDescriptionWithoutModuleUserData</literal>). Due to this
+wrapping the resource description for module <emphasis>B</emphasis> will be marked as changed (<literal>IResourceDescription.Delta#haveEObjectDescriptionsChanged()</literal>)
+whenever the old and current states are being compared.</simpara>
+<simpara>The Eclipse builder will recognize (via <literal>IProjectDescription#getDynamicReferences()</literal>) that project <emphasis>P2</emphasis> depends on project <emphasis>P1</emphasis>
+so the Xtext builder will run for project <emphasis>P2</emphasis> as well. At the previous phase we have enqueued module <emphasis>B</emphasis> for the build.
+We will therefore run into a builder state update again. We do not have any resource changes this time, so <literal>ToBeBuilt</literal> will
+be empty. Since <literal>ToBeBuilt</literal> is empty, we do not have to update the copied Xtext index state before the builder state setup
+phase. As the result of the previous builder state, phase module <emphasis>B</emphasis> is already enqueued for a build. When processing <emphasis>B</emphasis>
+we register it into the <literal>allDeltas</literal> set. That happens for each resource being processed by the builder state. But it will be
+registered into the <literal>changedDeltas</literal> because we have previously wrapped module <emphasis>B</emphasis> into a customized resource description delta
+to hide its obsolete <literal>TModule</literal> related user data information. Based on the builder state rules and logic described above,
+module <emphasis>C</emphasis> will be marked as an affected resource, will be queued for build and will be wrapped into a customized resource
+description delta to hide its <literal>TModule</literal> related user data information.</simpara>
+<simpara>In the next builder state phase, when building project <emphasis>P3</emphasis>, we apply the same logic as we applied for project <emphasis>P2</emphasis>. The
+builder state will process module <emphasis>C</emphasis> and will update the Xtext index state. No additional resources will be found as
+affected ones, nothing will be queued for build. The build will terminate, since there were no changed <literal>IResource</literal> instances
+and the build queue is empty.</simpara>
+<simpara>The outcome of the incremental build will be a workspace that contains exactly one validation error. The error will be
+associated with module <emphasis>C</emphasis> which was exactly our expectation, however, we have to clarify that transitive <emphasis>C</emphasis> dependency
+was built due to wrong reasons. Module <emphasis>C</emphasis> was build because we wrapped module <emphasis>B</emphasis> to hide its user data information and
+not because it imports and uses class <literal>A</literal> from module <emphasis>A</emphasis> which should be the logical and correct reason.</simpara>
+</section>
+</section>
+<section xml:id="dirty-state-handling" role="language-n4js">
+<title>Dirty state handling</title>
+<simpara>When two or more (N4)JS files are opened in editors and one of them is changed but without persisting this change the other
+open editors should be notified and if this change breaks (or heals) references in one of the other open resources their editors
+should updated so that warn and error markers are removed or added accordingly.</simpara>
+<simpara>When there are changes in the currently open editor these changes are propagated to all other open editors. Each Xtext editor has
+got its own resource set. The <literal>N4JSUpdateEditorStateJob</literal> runs for each open editor different from the editor where the changes have
+been made. In those editors the affected resources are unloaded and removed from the resource set. Then the Xtext resource of
+these editors is reparsed. After reparsing scoping and linking is invoked again, but now the references resources are rebuild
+as <literal>EObjectDescription</literal>s. The <literal>N4JSResource</literal> holds its own content that only contains 1..n slots when proxified.
+<literal>N4JSTypeScope.getSingleElement</literal> (called when resolving cross references and the linked element should be returned) will return the
+<literal>EObjectDescription</literal> created from the <literal>ModuleAwareContentsList</literal> in <literal>N4JSResource</literal>, that contains the first slot as proxy and the other
+slots as types. <xref linkend="fig:dirty_state_handling1"/> shows the flow to trigger the <literal>N4JSUpdateEditorStateJob</literal> and <xref linkend="fig:dirty_state_handling2"/>
+shows the sequence logic of the <literal>N4JSUpdateEditorStateJob</literal> in detail.</simpara>
+<figure xml:id="fig:dirty_state_handling1" role="center">
+<title>Sequence Diagram: Dirty State, Trigger <literal>N4JSUpdateEditorStateJob</literal></title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/07_typeindex/images/dirty_state_handling1.png"/>
+</imageobject>
+<textobject><phrase>dirty state handling1</phrase></textobject>
+</mediaobject>
+</figure>
+<figure xml:id="fig:dirty_state_handling2" role="center">
+<title>Sequence Diagram: Dirty State, <literal>N4JSUpdateEditorStateJob</literal> in Detail</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/07_typeindex/images/dirty_state_handling2.png"/>
+</imageobject>
+<textobject><phrase>dirty state handling2</phrase></textobject>
+</mediaobject>
+</figure>
+<simpara>A concrete example should illustrate the behaviour of the dirty state handling in conjunction with fully and partial loading
+of resources:</simpara>
+<simpara>Let A.js as above, and B.js as follows:</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">import A from "A.js"
+export class B {}</programlisting>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>assume  is opened and loaded:  is created with</simpara>
+<itemizedlist>
+<listitem>
+<simpara>is filled with a special proxy to resolve the <link linkend="AC">AST</link> of A only if needed.</simpara>
+</listitem>
+<listitem>
+<simpara>will be set to type A, loaded from <literal>EObjectDescription</literal> of A.js/A</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+<listitem>
+<simpara><link linkend="AC">AST</link> of A.js is to be accessed, e.g., for displaying JSDoc. A.js is not opened in an editor!  is modified as follows:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>is filled with <link linkend="AC">AST</link>, i.e. proxy in 0 is resolved</simpara>
+</listitem>
+<listitem>
+<simpara>is updated with parsed type: 1) proxify , 2) unload  (remove from content), 3) reload with parsed types again</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+<listitem>
+<simpara>Assume now that A.js is opened and edited by the user.</simpara>
+<itemizedlist>
+<listitem>
+<simpara>Reconceiler replaces  with modified <link linkend="AC">AST</link></simpara>
+</listitem>
+<listitem>
+<simpara>LazyLinker updates </simpara>
+</listitem>
+<listitem>
+<simpara>is proxified</simpara>
+</listitem>
+<listitem>
+<simpara>B <literal>searches</literal> for A and finds updated </simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+</orderedlist>
+<simpara><emphasis>Each opened Xtext editor has got its own resource set!</emphasis> Such a resource set contains the resource for the currently edited
+file in the first place. When starting editing the file, the resource is reparsed , reloaded and linking (resolving the cross
+references) is done. By resolving the cross references <literal>N4JSTypeScope</literal> is used and now the URIs of the linked elements are belonging
+to resources not contained in the resource set of the editor so these resources a create in the resource set and their contents
+is loaded from the resource descriptions via
+<literal>N4JSResource.loadFromDescription</literal> .</simpara>
+<simpara>When the resource content is loaded from the existing resource description available from Xtext index the first slot is set to be
+a proxy with name <literal>#:astProxy</literal>.
+After that for all exported EObject descriptions of that resource description the user data is fetched and deserialized to types
+and these types are added to the slots of the resource in order they were exported. But the order is not that important anymore.</simpara>
+<simpara>As the resource set for the editor is configured to use the DirtyStateManager ( <literal>ExternalContentSupport.configureResourceSet(resourceSet, dirtyStateManager)</literal> ),
+all other open editors will be notified by changes in the current editor. This is done by <literal>N4JSDirtyStateEditorSupport</literal> that schedules
+a <literal>N4JSUpdateEditorStateJob</literal> that create a new resource description change event.</simpara>
+<simpara>Via <literal>isAffected</literal> and <literal>ResourceDescription.getImportedNames</literal> it is determine if a change in another resource affects this resource.</simpara>
+<simpara>Before loading the resource always <literal>N4JSDerivedStateComputer.installDerivedState</literal> is execute that, as we learned earlier, is responsible
+for creating the types in the resource.</simpara>
+<simpara>On every change to a N4JS file that requires a reparse the <literal>N4JSDerivedStateComputer.discardDerivedState</literal> is executed. This method do an
+unload on every root element at the positions 1 to n. In the <literal>N4JSUnloader</literal> all contents of the this root elements are proxified (i.e.
+there is a proxy URI set to each of them) and the references to the <link linkend="AC">AST</link> are set to null (to avoid notifications causing
+concurrent model changes). The proxification indicates for all callers of these elements, that they have to reload them. Afterwards
+it discards the complete content of the resource. The content is build up again with the reparse of the N4JS file content.</simpara>
+<simpara>As each editor has its own resource set, only the resource belonging to the current editor is fully loaded. All other referenced
+resources are only partially loaded, i.e. only the slot 1 of these resources are loaded (i.e. the types model elements) in this
+resource set. Linking is done only against these types model elements. Synchronization between the resource sets of multiple open
+editors is done via update job as described above.</simpara>
+<section xml:id="use-case-restoring-types-from-user-data">
+<title>Use case: Restoring types from user data</title>
+<itemizedlist>
+<listitem>
+<simpara>Use case: referencing resources in editor: This has been described already in context of dirty state handling</simpara>
+</listitem>
+<listitem>
+<simpara>Use case: referencing resources from JAR: This is still to be implemented.% taskIDE-37</simpara>
+</listitem>
+</itemizedlist>
+</section>
+<section xml:id="use-case-updating-the-xtext-index">
+<title>Use case: Updating the Xtext index</title>
+<simpara>When a N4JS file is changed in way that requires reparsing the file, the underlying resource is completely unloaded and loaded again.
+By this the also the elements at the Xtext index are recreated again, belonging to this resource (i.e. new entries for new elements
+in the resource, update index elements of changed elements, delete index entries for deleted elements).</simpara>
+<simpara>When Eclipse is closed the Xtext index is serialized in a file.</simpara>
+<informalfigure role="center">
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/07_typeindex/images/index_serialization.png"/>
+</imageobject>
+<textobject><phrase>index serialization</phrase></textobject>
+</mediaobject>
+</informalfigure>
+<simpara>When starting Eclipse again, the Xtext index is restored from this file:</simpara>
+<informalfigure role="center">
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/07_typeindex/images/loading_existing_index.png"/>
+</imageobject>
+<textobject><phrase>loading existing index</phrase></textobject>
+</mediaobject>
+</informalfigure>
+</section>
+</section>
+</chapter>
+<chapter xml:id="_project-model">
+<title>Project Model</title>
+<section xml:id="sec:Package_json">
+<title>Package.json File</title>
+<simpara>See [<link linkend="N4JSSpec">N4JSSpec</link>] for the format specification of N4JS-specific package.json files.
+Based on the JSON-model-based AST that can be parsed from the package.json file, we transform the information that can be extracted into an instance of the N4JS-specific ProjectDescription model.
+This model is defined by means of EMF, the Xcore file is found in the N4JS model bundle.</simpara>
+<informalfigure xml:id="fig:projectDescriptionModel">
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/08_projectModel/images/cd_projectDescription.svg"/>
+</imageobject>
+<textobject><phrase>Project Description Model</phrase></textobject>
+</mediaobject>
+</informalfigure>
+</section>
+<section xml:id="_accessing-project-information">
+<title>Accessing Project Information</title>
+<simpara>The information in the package.json files is parsed into memory at runtime, e.g. within Eclipse or in headless mode. It is made available via the <literal>IN4JSCore</literal> facade that provides a high-level abstraction when working with the project structure. This facade has two implementations:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>One implementation is backed by the file system, e.g. <literal>java.io.File</literal> and used in a headless environment</simpara>
+</listitem>
+<listitem>
+<simpara>Another implementation uses the Eclipse resource model (<literal>IProject</literal>, <literal>IFolder</literal>, <literal>IFile</literal>) to describe the contents of an <literal>IN4JSProject</literal>. This implementation is automatically kept in sync whenever the contents of a package.json file is edited by a user. It is also maintained as dynamic project information to make the Eclipse workspace aware of the declared dependencies. That is, Eclipse projects know about the project references in the package.json file.</simpara>
+</listitem>
+</itemizedlist>
+<simpara>The project model is mimicing the handle based services of Eclipse’s <literal>JavaCore</literal>, the handles are often represented as EMF <literal>URIs</literal> though. Therefore the API allows to retrieve a source folder for a given N4JS resource, all the libraries that are configured for a project or simply the project’s name or the information if it exists. Subsequent components in the processing chain like the scope provider can leverage the API to deduce the container configuration and visiblity constraints. Project references are resolved transparently.</simpara>
+<simpara>The Xtext index participation is implemented by means of the <literal>N4JSToBeBuiltComputer</literal> and the <literal>N4JSAllContainersState</literal>. These classes provide access to the container configuration.</simpara>
+<simpara>The precedence for the dependency resolution follows this lookup chain:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>An accessible <literal>IN4JSProject</literal> with the given name is located in the workspace.</simpara>
+</listitem>
+<listitem>
+<simpara>The library manager provides access to the requested project.</simpara>
+</listitem>
+</itemizedlist>
+<simpara>Accordingly, the type lookup follows the same chain due to the container configuration that is deduced from the package.json configuration. Of course is prefers locally defined type that can be found in the current project over types that are located in referenced projects.</simpara>
+<section xml:id="sec:IN4JSCore">
+<title>IN4JSCore</title>
+<simpara>Facade analogous to org.eclipse.jdt.core.JavaCore.
+It is used look up the project or source container where a resource URI belongs to.
+It also provides some helper methods to retrieve information from the package.json file.
+N4JSRuntimeCore uses the file system and thus uses java.io to access files and folders.
+N4JSEclipseCore uses the Eclipse workspace and thus uses org.eclipse.resources API.
+Both Core implementations act as wrapper for N4JSModel resp. EclipseN4JSModel.
+Instances of the <literal>IN4JSCore</literal> are obtained as usually via dependency injection, e.g. <literal>@Inject IN4JSCore n4jsCore</literal>.</simpara>
+</section>
+<section xml:id="sec:N4JSModel">
+<title>N4JSModel</title>
+<simpara>N4JSModel uses FileBasedWorkspace to load and access the project description from the package.json file and create wrappers for projects (N4JSProject) and source containers (N4JSSourceContainer).</simpara>
+<simpara>A source container is a wrapper for a file system that has been marked as source folder in the package.json file.
+For determination of the current project a given EMF URI pointing to the project path is used.
+In N4JSModel this location is directly wrapped in N4JSProject.
+In N4JSModel a given EMF URI is resolved to a source container by using the specified relative source paths from the package.json file and file system based project location.
+If the EMF URI converted to a file URI starts with the absolute source folder path a N4JSProjectSourceContainer is created and returned for that EMF URI.</simpara>
+<simpara>In EclipseN4JSModel (that extends N4JSModel) the last segment of the URI is assumed to be the project name and via the EclipseBasedN4JSWorkspace that wraps the Eclipse workspace a project with that name is tried to be resolved.
+This IProject is than wrapped in N4JSEclipseProject.
+In EclipseN4JSModel a given EMF URI is resolved to an org.eclipse.core.resources.IResource belonging to the IWorkspaceRoot.
+That resource is wrapped in EclipseSourceContainer.</simpara>
+<simpara>N4JSModel is also used to retrieve project dependencies wrapped as N4JSProject.</simpara>
+</section>
+<section xml:id="sec:N4JSWorkspace">
+<title>N4JSWorkspace</title>
+<simpara>The FileBasedWorkspace and EclipseBasedN4JSWorkspace should only be accessed by N4JSModel resp. EclipseN4JSModel as they know the contract for the URI scheme.
+The FileBasedWorkspace creates AbstractTreeIterator for the direct contents of a source container, so that their children can be navigated by this as well.
+It then filters out all directories and returns an iterator of all files as EMF URIs.</simpara>
+<simpara>The EclipseBasedN4JSWorkspace wraps the IWorkspaceRoot.</simpara>
+<simpara>Fetching the project description read out from the package.json file is cached in both workspace implementations.
+In FileBasedWorkspace the LazyProjectDescriptionHandle is used as proxy and in EclipseBasedN4JSWorkspace the ProjectDescriptionLoadListener is used to invalidate the cache when the package.json file has been changed.
+ProjectDescriptionLoadListener also ensures that dependent projects are considered by the Eclipse builder by setting dynamic dependencies in the project meta data.
+It also updates these project dependencies if it is required and recalculates all source containers.</simpara>
+<simpara>In the tests another implementation, MockWorkspace, is used, that provides a dummy project description.</simpara>
+</section>
+<section xml:id="sec:N4JSProject">
+<title>N4JSProject</title>
+<simpara>A N4JSProject represents a configured project as defined in the package.json file.
+So in principles it wraps access to N4JSModel (and so to containing source containers, libraries and so on)
+and to some information from the package.json file directly (like defined module filters, vendorId and others).
+It is also used to compare depending projects.</simpara>
+<simpara>N4JSProject is the runtime representation while N4JSEclipseProject represents a project in the Eclipse workspace.
+N4JSProject is identified by its EMF location URI while N4JSEclipseProject wraps the underlying org.eclipse.core.resources.IProject.</simpara>
+<simpara>In tests MockProject is used.</simpara>
+</section>
+<section xml:id="sec:SourceContainer">
+<title>SourceContainer</title>
+<simpara>A source container contains either source files for production, tests or external declarations.
+By default all these files resp. their containing types will be exported to the Xtext index.
+A source container belongs exactly to one project it is identified by its project relative location.</simpara>
+<simpara>A N4JSProjectSourceContainer is a container that contains unpacked n4js, js and n4jsd files that can be modified.
+By default all these files are syntactically and semantically validated (this can be configured by the use of module filters).
+Except for n4jsd files, all files are compiled by the configured compilers.</simpara>
+<simpara>EclipseSourceContainer specializes N4JSProjectSourceContainer to work on top of the Eclipse resources API.
+Thus besides the location it also wraps the IFolder.</simpara>
+<simpara>The IFile was chosen instead of using the java.io.File because changes to an IFile (and IResource in general) trigger a workspace change event so that the Xtext builder is triggered properly.</simpara>
+</section>
+<section xml:id="sec:N4JSProjectsStateHelper">
+<title>N4JSProjectsStateHelper</title>
+<simpara>Calculates the visible containers for a given container, where containers are source containers within the project as well as source containers of other depending projects in workspace.
+The calculated handles are cached and invalidated if the project description file has changed or the project has been closed or reopened.</simpara>
+</section>
+</section>
+<section xml:id="sec:Caching">
+<title>Caching</title>
+<simpara>Caching is heavily used in the ExternalLibraryWorkspace and the N4JSProjectsStateHelper.
+The ExternalLibraryWorkspace relies on caching to provide data about all installed npms, their locations, names, shadowing, dependencies and so on.
+The caching of the ExternalLibraryWorkspace is implemented in the ExternalProjectMappings which inspects all external locations and builds all necessary mappings.
+The set of mappings start from a simple list of all npms, include mappings that map from location or name to a N4JSExternalProject, or give reduced set of projects.</simpara>
+<section xml:id="_caching-of-externallibraryworkspace">
+<title>Caching of ExternalLibraryWorkspace</title>
+<simpara>A reduced set of projects is used since not all npms are actually necessary projects for the N4JS IDE.
+Most transitively installed plain-JS npms are of no interest since they are completely invisible to the user.
+The reduced set of projects always consists of all user workspace projects and all shipped libraries.
+From the set of all installed npms, only those are necessary that are dependencies of a non-plain-JS projects.
+Shadowed projects are also not included in the reduced set of npms.</simpara>
+<simpara>To access projects that are not included in the reduced set of npms, the ExternalProjectMappings provides some collections that contain complete set of npms.
+Additionally, some mappings also provide information about not necessary npms.
+Note that mappings that use the project name as a key naturally cannot provide information about shadowed projects.</simpara>
+<simpara>The mapping cache is updated every time a refresh is triggered (e.g. at startup or by hitting F5).
+Also, every action of the library manager (such as installing or registering npms) triggers a refresh.</simpara>
+</section>
+<section xml:id="_caching-of-n4jsprojectsstatehelper">
+<title>Caching of N4JSProjectsStateHelper</title>
+<simpara>The N4JSProjectsStateHelper uses the MultiCleartriggerCache for caching information about projects of the user workspace.
+The EclipseBasedN4JSWorkspace does not caching at all, but provides information about project descriptions which is expensive to compute on the fly.
+Hence this information is cached in the MultiCleartriggerCache and updated every time a project description changes, is added or removed.</simpara>
+<simpara>Sometimes, a project description is rendered invalid as a side effect of a change on another project description.
+In this case, the cache of both of project descriptions has to be updated.
+The implementation to cope with these side effects uses the MultiCleartriggerCache which allows to set multiple triggers that will clear a cached object.</simpara>
+<simpara>However, it seems reasonable to align the caching of the user workspace to the caching of the external workspace.
+The reason is that caching of user workspace information such as N4JSProjects would increase build performance significantly.
+This is since as of now, projects (and information about all their source containers) is computed on the fly, that causes thousands of expensive calls to the file system.</simpara>
+</section>
+</section>
+<section xml:id="sec:WildcardPathFilter">
+<title>WildcardPathFilter</title>
+<simpara>This class encapsulates the logic to resolve (wildcard containing) paths against the file system.
+With the method matchPath it is also possible to resolve a path without using the file system.
+This class is also able to resolve relative navigation in paths.</simpara>
+</section>
+<section xml:id="sec:ProjectUtils">
+<title>ProjectUtils</title>
+<simpara>ProjectUtils provides additional methods for providing information only required in compilation, e.g. like file and module descriptor.
+It uses IN4JSCore to retrieve the information of output path and whether module wrapping is required for a given file.</simpara>
+</section>
+</chapter>
+<chapter xml:id="_binding">
+<title>Binding</title>
+<warning>
+<simpara>This section may be outdated!</simpara>
+</warning>
+<section xml:id="sec:Binding_Design_Rationale" role="language-n4js">
+<title>Design Rationale</title>
+<simpara>Binding references to declarations follows the Xtext mechanism based on local <literal>N4JSScopeProvider</literal> and a global <literal>N4JSGlobalScopeProvider</literal> scope providers. The basic question is: to which elements are references bound to. This in particular interesting for all kind of type declarations, including functions as they are interpreted as types. These declarations are Janus-faced: On the one side, they are targets of type references as <literal>Type</literal>, and on the other side they can also be target of identifier references bound to some so called <literal>IdentifiableElement</literal>. As explained in <xref linkend="_type_index"/>, special type objects (<literal>TClass</literal> etc.) are created from the original declarations. These type objects are used as targets for both kind of references. The following table summarizes the reference-target relations relevant for N4JS (not the standalone type grammar).</simpara>
+<table frame="all" rowsep="1" colsep="1">
+<title>N4JS Cross References</title>
+<tgroup cols="2">
+<colspec colname="col_1" colwidth="50*"/>
+<colspec colname="col_2" colwidth="50*"/>
+<thead>
+<row>
+<entry align="left" valign="top">Reference</entry>
+<entry align="left" valign="top">Target Type</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry align="left" valign="top" namest="col_1" nameend="col_2"><simpara><emphasis role="strong">N4JS</emphasis></simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara>ImportDeclaration.importedModule</simpara></entry>
+<entry align="left" valign="top"><simpara>TModule</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara>NamedImportSpecifier.importedElement</simpara></entry>
+<entry align="left" valign="top"><simpara>types.IdentifiableElement</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara>IdentifierRef.id</simpara></entry>
+<entry align="left" valign="top"><simpara>types.IdentifiableElement</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara>ParameterizedPropertyAccessExpression.property</simpara></entry>
+<entry align="left" valign="top"><simpara>types.TMethod</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara>PropertyAccessExpression.property</simpara></entry>
+<entry align="left" valign="top"><simpara>types.TMember</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara>N4Getter/N4SetterDeclaration.field</simpara></entry>
+<entry align="left" valign="top"><simpara>N4FieldDeclaration</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara>Continue/Break-Statement.label</simpara></entry>
+<entry align="left" valign="top"><simpara>LabelledStatement</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top" namest="col_1" nameend="col_2"><simpara>Type Expressions</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara>ParameterizedTypeRef.declaredType</simpara></entry>
+<entry align="left" valign="top"><simpara>Type</simpara></entry>
+</row>
+</tbody>
+</tgroup>
+</table>
+<simpara><xref linkend="fig:cd_scoping"/> gives an overview over the most important classes in the scoping package, with the <literal>N4JSScopeProvider</literal> and the used customized scopes created by the scope providers.</simpara>
+<figure xml:id="fig:cd_scoping" role="center">
+<title>Overview Scoping Package</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/09_binding/images/cd_scoping.svg"/>
+</imageobject>
+<textobject><phrase>cd scoping</phrase></textobject>
+</mediaobject>
+</figure>
+</section>
+<section xml:id="sec:Binding_to_Members" role="language-n4js">
+<title>Binding to Members</title>
+<simpara>Members of different types, such as classes and also record types or enumerations, are bound using the <literal>MemberScopeProvider</literal>. This often returns a <literal>MemberScope</literal>, which directly works on the members. Most types with members are implemented by subclasses of <literal>ContainerType</literal>, using <literal>CollectMembersHelper</literal> to collect all members and <literal>FindMemberHelper</literal> for retrieving a member by its name via <literal>ContainerTypes</literal>. Ensure that when types with members are added to override appropriate methods in all of these related classes (e.g., <literal>CollectMembersHelper</literal>, <literal>AbstractHierachyTraverser</literal> and <literal>FindMemberHelper</literal> uses polymorphic dispatch to handle different subtypes – so you won’t be able to find a member if you do not adjust these helpers).</simpara>
+</section>
+<section xml:id="sec:Binding_Getter_Setter">
+<title>Getter / Setter Binding</title>
+<simpara>For customized binding of getters / setters, see <link linkend="sec:Field_Accessors">Accessors</link>.</simpara>
+</section>
+<section xml:id="chap:Statics">
+<title>Static Member Binding</title>
+<simpara>For customized binding of static members, see <link linkend="sec:Static_Members">Static Members</link>.</simpara>
+</section>
+<section xml:id="sec:Binding_Enumeration">
+<title>Enumeration Literals Binding</title>
+<itemizedlist>
+<listitem>
+<simpara>introduced new type ref EnumTypeRef: it behaves comparable to ClassifierTypeRef, but with the difference that the MemberScopeProvider filters for a given EnumTypeRef filters all literals of the contained TEnum (in comparison the MemberScopeProvider filters for a given ClassifierTypeRef all static members of the contained classifier)</simpara>
+</listitem>
+<listitem>
+<simpara>it isn’t possible to access literals on a enumeration literal itself, although this literal is typed as TEnum (that contains TEnumLiterals)</simpara>
+</listitem>
+<listitem>
+<simpara>as there are currently no additional fields and operations for enumeration literals defined (in Java there is name and value()), the scope for literals is currently empty</simpara>
+</listitem>
+</itemizedlist>
+</section>
+<section xml:id="sec:Accessibility_of_types_and_members" role="language-n4js">
+<title>Accessibility of types and members</title>
+<simpara>Member access and type access has to be constrained and validated against the accessibility rules of N4JS. Therefore, the scoping annotates certain elements as erroneous to detect invalid references.</simpara>
+<simpara>Basically two different approaches are used to implement that behavior:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>The <literal>VisibilityAwareTypeScope</literal> and <literal>VisibilityAwareMemberScope</literal> decorate an existing scope to validate the result on access. This allows to lazily check the visibility of the returned element. If it is not accessible, it is wrapped in a <literal>AbstractDescriptionWithError</literal> which will be indentified as such by the <literal>ErrorAwareLinkingService</literal>. Before the binding is resolved and the EMF proxy is replaced, the error message is used to create an EMF diagnostic.</simpara>
+</listitem>
+<listitem>
+<simpara>For other cases, the scopes are produced differently, e.g. if all elements are easily enumerable and have to be collected before the scope is created (e.g. for imported elements), the scoped elements are validated eagerly to put them into the correct layer of scopes. That is, the valid descriptions may shadow the invalid description. Since there are more error conditions for these cases, e.g. duplicate imports and similar cases, the accessibility is checked before the concrete member is accessed. All the instances <literal>AbstractDescriptionWithError</literal> are put into the <literal>MapBasedScope</literal> immediately.</simpara>
+</listitem>
+</itemizedlist>
+<simpara>In that sense, accessibility checks are basically implemented as decorators for the scoping itself. Bindings are established but flagged as errors.</simpara>
+<simpara>Default visibility of members is calculated in <literal>Types.xcore</literal> (in <literal>getTypeAccessModifier</literal> and <literal>getMemberAccessModifier</literal> etc.). Visibility is checked in <literal>org.eclipse.n4js.scoping.accessModifiers.MemberVisibilityChecker</literal> and validators.</simpara>
+</section>
+<section xml:id="sec:Member_Scope_Example" role="language-n4js">
+<title>Member Scope Example</title>
+<simpara>In this section, we are going to have a look at the creation process of <literal>MemberScope</literal>.</simpara>
+<formalpara>
+<title>C.n4js</title>
+<para>
+<screen>export public class C {
+	 private m1: int;
+	 public m2: int;
+}</screen>
+</para>
+</formalpara>
+<formalpara>
+<title>Test.n4js</title>
+<para>
+<screen>import { C } from "C";
+
+let c: C = new C();
+c.m1;  // Error -&gt; The field m1 is not visible
+c.m2;  // OK    -&gt; m2 is visible at this context</screen>
+</para>
+</formalpara>
+<simpara>Assume that we need to figure out to which element the <literal>ParameterizedPropertyAccessExpression c.m1</literal> in the <literal>ExpressionStatement c.m1</literal> binds to. To answer this question, <literal>N4JSScopeProvider.getScope(context, reference)</literal> is triggered whereby <literal>context</literal> is the <literal>ParameterizedPropertyAccessExpression</literal> and <literal>reference</literal> is <literal>EReference property</literal> (<literal>property</literal> is the cross-reference element defined in <literal>ParameterizedPropertyAccessExpression</literal> 's grammar).</simpara>
+<simpara><literal>N4JSScopeProvider.getScope(context, reference)</literal> does not implement the scoping but delegates to corresponding methods based on the type of <literal>context</literal>. In our example, since <literal>context</literal> is a <literal>ParameterizedPropertyAccessExpression</literal>, the scoping logic is delegated to the method that creates a <emphasis role="strong">MemberScope</emphasis> for the context <literal>ParameterizedPropertyAccessExpression c.m1</literal> based on the receiver type of <literal>c</literal> which is class <literal>C</literal>.
+The resulting scope instance returned by <literal>N4JSScopeProvider.getScope()</literal> in our example is of type <literal>TypingStrategyAwareMemberScope</literal> as shown in <xref linkend="fig:memberscope-example"/> .</simpara>
+<figure xml:id="fig:memberscope-example">
+<title>Member scope hierarchy</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/09_binding/images/memberscope_example.svg" align="center"/>
+</imageobject>
+<textobject><phrase>memberscope example</phrase></textobject>
+</mediaobject>
+</figure>
+<simpara>In the hierarchy, the top-level scope is the NULL scope. Directly below the NULL scope is a MemberScope which contains all members of <literal>N4Object</literal> since the class <literal>C</literal> implicitly inherits <literal>N4Object</literal>. The other <literal>MemberScope</literal> instance beneath contains all members of the class <literal>C</literal> <emphasis role="strong">regardless of their visibility</emphasis>. These members are <literal>m1</literal> and <literal>m2</literal>. While <literal>m2</literal> is can be accessed by <literal>c.m2</literal>, <literal>m1</literal> it not visible at <literal>c.m1</literal>. The <literal>VisibilityAwareMemberScope</literal> implements precisely this behavior. In particular, it returns all members of <literal>C</literal> that are visible at the current <literal>context</literal> (here the element <literal>m2</literal>),  while wrapping non-visible members (here the element <literal>m</literal>) in <literal>InvisibleMemberDescription</literal> instances. These <literal>InvisibleMemberDescription</literal> instances of type <literal>IEObjectDescriptionWithError</literal> contain issue code and error message related to accessibility problems and are recognized during the error-aware linking phase done by <literal>ErrorAwareLinkingService</literal>. It is worth to emphasize the motivation behind use of <literal>IEObjectDescriptionWithError</literal> is to provide more informative error messages to the user other than <emphasis>Cannot reference element&#8230;&#8203;</emphasis> Another example of <literal>IEObjectDescriptionWithError</literal> is <literal>WrongWriteAccessDescription</literal> that is used when we, try to write to a getter and no corresponding setter exists.</simpara>
+</section>
+<section xml:id="sec:Scoping_for_Members_of_Composed_Type_Explained" role="language-n4js">
+<title>Scoping for Members of Composed Type (Union/Intersection) Example</title>
+<simpara>In this section, we will have a look at how scoping is implemented for composed type, i.e. union or intersection type with an example of union type. Intersection is done similarly. Before reading this, it is strongly recommended to read <xref linkend="sec:Member_Scope_Example"/> first.</simpara>
+<formalpara>
+<title>Defs.n4js</title>
+<para>
+<screen>export public class C {
+	 private m1: int;
+	 public m2: int;
+}
+
+export public class D {
+	 private m1: int;
+	 get m2(): int { return 42; };
+}</screen>
+</para>
+</formalpara>
+<formalpara>
+<title>Test.n4js</title>
+<para>
+<screen>import { C, D } from "Defs";
+
+let cud : C|D;
+
+cud.m2 = 10;</screen>
+</para>
+</formalpara>
+<simpara>Assume that we need to find out to what element the <literal>ParameterizedPropertyAccessExpression cud.m2</literal> in the <literal>ExpressionStatement cud.m2</literal> binds to.
+This is a question for scoping. Since the receiver type of <literal>cud</literal> is a union type <literal>C|D</literal>, a <literal>UnionMemberScope</literal> is created that contains two subscopes, each of which corresponds to an individual type in the union. The resulting scope hierarchy is graphically depicted in <xref linkend="fig:unionmemberscope-example"/>.</simpara>
+<figure xml:id="fig:unionmemberscope-example">
+<title>Union member scope hierarchy</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/09_binding/images/unionmemberscope_example.svg" align="center"/>
+</imageobject>
+<textobject><phrase>unionmemberscope example</phrase></textobject>
+</mediaobject>
+</figure>
+<simpara>The two subscopes are of type <literal>TypingStrategyAwareMemberScope</literal> and created exactly the same way as described in <xref linkend="sec:Member_Scope_Example"/>.
+The <literal>UnionMemberScope</literal> instance contains a list of subscopes for all types involved in the union and is responsible for constructing an <literal>IEObjectDescription</literal> instance for <literal>m2</literal> by merging all members of the name <literal>m2</literal> found in all subscopes.
+Merging members requires considering a variety of combinations (fields, setters getters, optional/variadic parameters etc.) and thus can become very complicated. To reduce the complexity, the recently refactored implementation splits the proccess into three separate steps.</simpara>
+<simpara>Step 1: Collect information</simpara>
+<simpara>During this phase, members with the name <literal>m2</literal> are looked up in each subscope and collected into an <literal>ComposedMemberInfo</literal> instance by <literal>ComposedMemberInfoBuilder</literal>.
+The first subscope (left branch in the <xref linkend="fig:unionmemberscope-example"/>) returns an <literal>EObjectDescription</literal> wrapping the <literal>TField m2</literal> of class <literal>C</literal> and hence <literal>TField m2</literal> is added to the <literal>ComposedMemberInfo</literal> instance. The second subscope (right branch in the <xref linkend="fig:unionmemberscope-example"/>) returns a <literal>WrongWriteAccessDescription</literal> wrapping the <literal>TGetter m2</literal> of class <literal>D</literal> and hence <literal>TGetter m2</literal> is added to <literal>ComposedMemberInfo</literal> instance. The reason for <literal>WrongWriteAccessDescription</literal> because <literal>cud.m2</literal> is trying to write to the getter of the same name in <literal>D</literal>.</simpara>
+<simpara>At the end of this step, two members <literal>public TField m2: int</literal> and <literal>project TGetter m2(): int</literal> are added to <literal>ComposedMemberInfo</literal>.</simpara>
+<simpara>Step 2: Merge members</simpara>
+<simpara>This phase merges members of the same name into a composed member based on the information about these members collected in Step 1. Note that merge rules can become quite complicated as many situations must be considered. Sometimes, it is not possible to merge at all. If the merge is possible, we need to consider the following properties, among others,</simpara>
+<itemizedlist>
+<listitem>
+<simpara>Member kind: what kind of member is the merge result. For instance, what do we get when we merge a field with a setter?</simpara>
+</listitem>
+<listitem>
+<simpara>Type of merge member: What is the return/parameter type of the merge result?</simpara>
+</listitem>
+<listitem>
+<simpara>Accessibility: what is the accessibility of the merge result?</simpara>
+</listitem>
+<listitem>
+<simpara>Optionality/Variadic: Should a parameter of the merge be optional or variadic?</simpara>
+</listitem>
+</itemizedlist>
+<simpara>The actual merge rules are implemented in the class <literal>UnionMemberFactory</literal> which delegates to either of the classes <literal>UnionMethodFactory</literal>, <literal>UnionFieldFactory</literal>, <literal>UnionGetterFactory</literal> and <literal>UnionSetterFactory</literal>.</simpara>
+<simpara>In our example,
+The merge result of <literal>public TField m2: int</literal> and <literal>project TGetter m2(): int</literal> are merged into a <literal>project TGetter m2: int</literal> .</simpara>
+<simpara>Step 3: Construct the scope entry</simpara>
+<simpara>In this final step, the actual IEObjectDescription for <literal>m2</literal> is constructed. In our example, since there exists one subscope exposing an <literal>EObjectDescriptionWithError</literal> (here <literal>WrongWriteAccessDescription</literal>), the final result is an instance of <literal>UnionMemberDescriptionWithError</literal>. This error instance is recognized during the linking phase and the error message of the subscope regarding <literal>WrongWriteAccessDescription</literal> is displayed: <emphasis>Union combines fields and getters with name m2 and therefore property m2 is read-only.</emphasis></simpara>
+<simpara>More details can be found in the API documentation in the code. A good starting point is the class <literal>ComposedMemberScope</literal>.</simpara>
+</section>
+<section xml:id="sec:Binding_of_Structurally_References_Types" role="language-n4js">
+<title>Structurally References Types</title>
+<simpara>Scoping of structurally referenced types is similar to binding of members. The structural typing modifier basically filters the members of a type. That is, the structural modifier filters out all non-public members, and the field-only modifier only accept fields. Thus, similar to accessibility aware scoping (<xref linkend="sec:Accessibility_of_types_and_members"/>), the <literal>TypingStrategyAwareMemberScope</literal> encapsulates an original scope and applies these additional filters.</simpara>
+<simpara>Bindings to additional members of a structurally referenced type is implemented in <literal>MemberScopeProvider.members(ParameterizedTypeRefStructural ..)</literal>. Note that the current implementation does not necessarily bind to the type model (TModule) instance, as these members are part of a type reference. That is, usually these bindings refer to the <link linkend="AC">AST</link> elements. Thus, it is not possible to compare these members directly, instead, a structural comparison has to be applied.</simpara>
+</section>
+<section xml:id="sec:Building">
+<title>Building</title>
+<section xml:id="sec:Build_Phases">
+<title>Build Phases</title>
+<informaltable tabstyle="horizontal" frame="none" colsep="0" rowsep="0">
+<tgroup cols="2">
+<colspec colwidth="15*"/>
+<colspec colwidth="85*"/>
+<tbody valign="top">
+<row>
+<entry>
+<simpara>Phase 0</simpara>
+</entry>
+<entry>
+<simpara>Loading Resources</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Phase 1: prelinking</simpara>
+</entry>
+<entry>
+<simpara>Create symbols for all resources, includes creation of temporary pre-linked type models</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Phase 2: linking</simpara>
+</entry>
+<entry>
+<simpara>Resolve all links, includes fully-resolved typed models<?asciidoc-br?>
+includes compilation</simpara>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+<simpara>That is, not each resource is loaded, pre-linked and linked separately. Instead, all resources are first loaded, then all resources are pre -inked, and only then all resources are linked.</simpara>
+</section>
+<section xml:id="sec:Build_Scenarios">
+<title>Build Scenarios</title>
+<simpara>Consequences:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>do not try to set any types in types builder, only create symbols there (probably not even members of types)</simpara>
+</listitem>
+</itemizedlist>
+</section>
+<section xml:id="sec:Lazy_linking_problem">
+<title>Lazy linking problem</title>
+<simpara>Lazy linking proxies in the indes may trigger reloading of AST (which leads to invalid disconnected type models):</simpara>
+<simpara>Lazy links (ending with |x in which x is an index entry of a temporary list used to resolve the link) must not be written into index.</simpara>
+</section>
+</section>
+<section xml:id="sec:Proxies_and_Proxy_Resolution" role="language-n4js">
+<title>Proxies and Proxy Resolution (Overview)</title>
+<simpara>Here we give a brief overview of the different kinds of proxies and when / how they are created and resolved.</simpara>
+<section xml:id="xtexts-lazy-linking-proxies">
+<title>Xtext’s Lazy Linking Proxies</title>
+<itemizedlist>
+<listitem>
+<simpara>URI fragment is <literal>|</literal> <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>n</mi></math> (where <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>n</mi></math> is a non-negative integer).<?asciidoc-br?>
+<literal>platform:/resource/Project/src/A.n4js#|3</literal></simpara>
+</listitem>
+<listitem>
+<simpara>created by Xtext’s <literal>LazyLinkingResource</literal> in the AST after parsing (they are only ever created in the AST, but the types builder may copy them to the TModule, so they may appear there as well.</simpara>
+</listitem>
+<listitem>
+<simpara>used to represent cross-references defined in the source code (i.e. name of an identifiable element used in source code to refer to that element).<?asciidoc-br?></simpara>
+<simpara>Since the types builder sometimes copies proxies from AST to TModule (e.g. type of an element that was provided with an explicit type declaration in the source code), these proxies may also appear in the TModule, but only between the types builder phase and the end of the post-processing phase (or later, in case they are unresolvable).</simpara>
+</listitem>
+<listitem>
+<simpara>resolution is handled by <literal>#getEObject(String)</literal> in <literal>LazyLinkingResource</literal>, which recognizes lazy linking URI fragments and then forwards them to <literal>#getEObject(String,Triple)</literal>, which in turn relies on the Xtext infrastructure.</simpara>
+</listitem>
+<listitem>
+<simpara>latest time of resolution: post processing. After post processing has completed, they should all be gone (unless they are unresolvable, e.g. typo in source code).</simpara>
+</listitem>
+<listitem>
+<simpara>fun facts:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>the number after the pipe character is the index of a <literal>Triple</literal> stored in field <literal>proxyInformation</literal> in each <literal>LazyLinkingResource</literal>.</simpara>
+</listitem>
+<listitem>
+<simpara>the resource given before the fragment (e.g. <literal>A.n4js</literal> in the above example) is not the resource the proxy is pointing to (i.e. the resource containing the target EObject), but the resource from where the link originates.</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+</itemizedlist>
+</section>
+<section xml:id="standard-emf-proxies">
+<title>Standard EMF Proxies</title>
+<itemizedlist>
+<listitem>
+<simpara>URI fragment contains a path to an EObject, using reference names and indices:<?asciidoc-br?>
+<literal>platform:/resource/Project/src/A.n4js#/1/@topLevelTypes.1/@ownedMembers.0</literal></simpara>
+</listitem>
+<listitem>
+<simpara>created automatically by EMF</simpara>
+<itemizedlist>
+<listitem>
+<simpara>during deserialization of a TModule <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>M</mi></math> from the Xtext index for all references to a different TModule <math xmlns="http://www.w3.org/1998/Math/MathML"><msup><mi>M</mi><mi>'</mi></msup></math> (see <literal>UserdataMapper</literal>).</simpara>
+</listitem>
+<listitem>
+<simpara>when unloading a resource.</simpara>
+</listitem>
+<listitem>
+<simpara>&#8230;&#8203;</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+<listitem>
+<simpara>used to represent</simpara>
+<itemizedlist>
+<listitem>
+<simpara>cross-references from one TModule to another TModule.</simpara>
+</listitem>
+<listitem>
+<simpara><literal>astElement</literal> links from TModule to AST whenever the AST is not present (e.g. resource was loaded from Xtext index).</simpara>
+</listitem>
+<listitem>
+<simpara><literal>definedType</literal> links from AST to TModule after deleting the TModule (this happens in the incremental builder after the pre-linking phase).</simpara>
+</listitem>
+<listitem>
+<simpara>all kinds of links after demand-loading an AST by resolving an <literal>astElement</literal> link (pathological case).</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+<listitem>
+<simpara>resolution is handled in two ways:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>if the context <literal>EObject</literal> of the proxy, i.e. the one where the proxified cross-reference originates, is contained in an N4JSResource <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>R</mi></math>, then resolution is handled by <literal>N4JSResource#doResolveProxy()</literal> (see also <literal>ProxyResolvingResource</literal> for details).</simpara>
+<simpara>In this case, special handling is performed to make sure that (a) the target resource is loaded from the index, if possible, and (b) post-processing of the target resource is initiated iff the target resource was loaded from AST (instead from the Xtext index) AND post-processing of resource <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>R</mi></math> is currently in progress or has already been completed.</simpara>
+</listitem>
+<listitem>
+<simpara>otherwise, resolution is handled by standard EMF functionality.</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+<listitem>
+<simpara>latest time of resolution: none. In fact, some of those proxies (those representing <literal>astElement</literal> links from TModule to AST) must not be resolved at all, because this is not yet properly handled.</simpara>
+</listitem>
+</itemizedlist>
+</section>
+<section xml:id="_how-is-proxy-resolution-triggered">
+<title>How is Proxy Resolution Triggered?</title>
+<simpara>Resolution of proxies throughout the N4JS implementation is triggered as usually when using EMF, which means: whenever the getter of a EMF cross-reference is invoked and the value is still a proxy, the EMF-generated code of the getter will automatically trigger resolution of this proxy. For details look at the EMF-generated code of the getter of any cross-reference (<literal>IdentifierRefImpl#getId()</literal> would be a good example).</simpara>
+</section>
+<section xml:id="_when-is-proxy-resolution-allowed">
+<title>When is Proxy Resolution Allowed?</title>
+<simpara>So, at what time is it legal to trigger such a proxy resolution? Or, more concretely, during which resource load states (<xref linkend="sec:N4JS_Resource_Load_States"/>) is it legal to trigger proxy resolution? In fact, asking the question in this way is incorrect or at least not very helpful, because the answer would be (almost) always. The better question is: which components of the system / which parts of the code base are allowed to trigger proxy resolution?</simpara>
+<simpara>For example, triggering resolution is disallowed in the <literal>ASTStructureValidator</literal> and <literal>N4JSTypesBuilder</literal>, but for the outside client code such as a JUnit test it is allowed to trigger proxy resolution as early as right after parsing. For an example of the latter see test <literal>#testStateFullyProcessed_triggeredOnlyThroughProxyResolution()</literal> in <literal>N4JSResourceLoadStatesTest</literal>.</simpara>
+<simpara>In summary, we can state the rule that the <emphasis role="strong">internal N4JS implementation</emphasis> must not trigger any proxy resolution until installation of the derived state has completed, i.e. not before resource load state "Fully Initialized", but <emphasis role="strong">client code</emphasis> may trigger proxy resolution as early as right after parsing, i.e. already in resource load state "Loaded".</simpara>
+</section>
+</section>
+</chapter>
+<chapter xml:id="_validation">
+<title>Validation</title>
+<warning>
+<simpara>This chapter may be outdated.</simpara>
+</warning>
+<simpara>In this chapter the concept for the validation infrastructure of the N4JS IDE is described.</simpara>
+<simpara>Requirements:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>like in old IDE centralize issue codes and messages</simpara>
+</listitem>
+<listitem>
+<simpara>instead of the DLTK API, the Xtext Validation API should be used</simpara>
+</listitem>
+<listitem>
+<simpara>there should be an unified approach / call to produce validation messages (as in old IDE with the call of reportProblem)</simpara>
+</listitem>
+</itemizedlist>
+<section xml:id="sec:validation_overview" role="language-n4js">
+<title>Validation overview</title>
+<itemizedlist>
+<listitem>
+<simpara>in Xtext in most cases validation should triggered after all Xtext resources are linked (so everything is resolved), so most validations are defined in N4JSValidator and there in composed validators</simpara>
+</listitem>
+<listitem>
+<simpara>in Xtext there are resource diagnostics and validation diagnostics</simpara>
+<itemizedlist>
+<listitem>
+<simpara>resource diagnostics are produced for issues related to found syntax errors and linking errors</simpara>
+</listitem>
+<listitem>
+<simpara>validation diagnostics are produced for issues found during semantic validation (model invariants)</simpara>
+</listitem>
+<listitem>
+<simpara>Note, that you can only produce diagnostics only for the resource currenlty validated - e.g. it isn’t possible to create a marker for a duplicate issue in the other resource that contains the first element while producing the issue for the second - you have to create the diagnostic when validating the other resource</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+<listitem>
+<simpara>validation message sources</simpara>
+<itemizedlist>
+<listitem>
+<simpara>parser, e.g. ANTLR parser: messages are contained and produced internally by the parser but can be adapted by a customized SyntaxErrorMessageProvider (see link section below)</simpara>
+</listitem>
+<listitem>
+<simpara>lazy linking - N4JSLinker (extension of lazy linker): custom handling exceptions from value converters, that produces own issues as XtextLinkingDiagnostic (this is a resource diagnostic)</simpara>
+</listitem>
+<listitem>
+<simpara>lazy linking - ASTStructureValidator: traverses AST and produces custom DiagnosticMessage (triggered during N4JSLinker.doLinkModel), creates XtextLinkingDiagnostic (this is a resource diagnostic). The ASTStructureValidator checks for things like allowed occurence of continue, break, return as well as allowed labels</simpara>
+</listitem>
+<listitem>
+<simpara>linking - default: uses the ILinkingDiagnosticMessageProvider to create error messages for typical error cases (referenced not resolved, unique constraint violation, bounds contraints violation, etc.)</simpara>
+</listitem>
+<listitem>
+<simpara>linking - ErrorAwareLinkingService: In N4JS we have introduced a custom IEObjectDescription AbstractDescriptionWithError that holds issue code and error message and ErrorAwareLinkingService as extension of DefaultLinkingService to produce for every AbstractDescriptionWithError a XtextLinkingDiagnostic (this is a resource diagnostic) - the usual Xtext behavior would be to produce a linking error with linking disabled, with our customization linking still works but the error message/marker is produced as well. Currently there are these custom AbstractDescriptionWithError implementations, that are produced during scoping</simpara>
+<itemizedlist>
+<listitem>
+<simpara>AmbiguousImportDescription: indicate an ambiguous wildcard import</simpara>
+</listitem>
+<listitem>
+<simpara>PlainAccessOfAliasedImportDescription: indicate accessing type directly instead of using the alias it has been imported with</simpara>
+</listitem>
+<listitem>
+<simpara>InvisibleMemberDescription: indicate accessing a member, that is not visible to the caller due to access modifier restrictions</simpara>
+</listitem>
+<listitem>
+<simpara>InvisibleTypeOrVariableDescription: indicate accessing a type / variable or function, that is not visible to the caller due to access modifier restrictions</simpara>
+</listitem>
+<listitem>
+<simpara>WrongFieldAccessorDescription: setter/getter access used in wrong context</simpara>
+</listitem>
+<listitem>
+<simpara>WrongStaticAccessorDescription: static/non-static access used in wrong context</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+<listitem>
+<simpara>N4JSTypeSystem:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>error: cannot type given expression</simpara>
+</listitem>
+<listitem>
+<simpara>error: element is not a subtype of another type</simpara>
+</listitem>
+<listitem>
+<simpara>RuleFailedException is thrown in type system, then handled as result where out of the contained information the AbstractDeclarativeValidator API is used to create issues via calls to error(..) or warning(..) methods</simpara>
+</listitem>
+<listitem>
+<simpara>RuleFailedExceptionWithoutStacktrace - sub class of RuleFailedException</simpara>
+</listitem>
+<listitem>
+<simpara>N4JSTypeValidator.createError &#8594; delegates to AbstractDeclarativeValidator, or directly calls AbstractDeclarativeValidator.error</simpara>
+</listitem>
+<listitem>
+<simpara>XsemanticsValidatorErrorGenerator (currently not used)</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+<listitem>
+<simpara>N4JSValidation: composed validators, declarative checks, i.e. using annotation @Check at methods, issues mostly created by using combination of message, context object, EFeature and index passed to AbstractDeclarativeValidator methods like error(..), warning(..)</simpara>
+<itemizedlist>
+<listitem>
+<simpara>N4JSClassValidator - checks related to classes, like duplicate member check</simpara>
+</listitem>
+<listitem>
+<simpara>N4JSFunctionValidator - checks for function expressions in expression statements and creates an error, but this validation is already done by the ASTStructureValidator</simpara>
+</listitem>
+<listitem>
+<simpara>N4JSImportValidator - checks invalid, duplicated and invalid imports</simpara>
+</listitem>
+<listitem>
+<simpara>N4JSInterfaceValidator - currently checks only for static members</simpara>
+</listitem>
+<listitem>
+<simpara>N4JSRoleValidator - currently checks only for static members</simpara>
+</listitem>
+<listitem>
+<simpara>N4JSStrictValidator - checks for function expressions in expression statements and creates an error, but this validation is already done by the ASTStructureValidator, thus this composite test is commented out</simpara>
+</listitem>
+<listitem>
+<simpara>N4JSTypeValidator - this is type system, see above</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+</itemizedlist>
+</listitem>
+<listitem>
+<simpara>Check types and check modes</simpara>
+<itemizedlist>
+<listitem>
+<simpara>Check types are used in <literal>@Check</literal> annotation to influence, when a validation is triggered</simpara>
+<itemizedlist>
+<listitem>
+<simpara><literal>FAST</literal> - Check is declared as fast</simpara>
+</listitem>
+<listitem>
+<simpara><literal>NORMAL</literal> - the common checks</simpara>
+</listitem>
+<listitem>
+<simpara><literal>EXPENSIVE</literal> - long running checks</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+<listitem>
+<simpara>Check modes decide using check types when to run which types of checks</simpara>
+<itemizedlist>
+<listitem>
+<simpara><literal>FAST_ONLY</literal> - used by Xtext editor to execute FAST checks on every key stroke and in embedded Xtext editors</simpara>
+</listitem>
+<listitem>
+<simpara><literal>NORMAL_ONLY</literal> - not used in Xtext framework itself</simpara>
+</listitem>
+<listitem>
+<simpara><literal>EXPENSIVE_ONLY</literal> - not used in Xtext framework itself</simpara>
+</listitem>
+<listitem>
+<simpara><literal>NORMAL_AND_FAST</literal> - used by Xtext editor to execute FAST and NORMAL checks on file save as well as on marker update for changed resources (delta calculated by Xtext builder)</simpara>
+</listitem>
+<listitem>
+<simpara>ALL - executes all types of checks when invoking explicitley the Validate action in the context menu of the Xtext editor</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+<listitem>
+<simpara>So by default check types and modes aren’t configurable at runtime</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+<listitem>
+<simpara>Severity</simpara>
+<itemizedlist>
+<listitem>
+<simpara>types</simpara>
+<itemizedlist>
+<listitem>
+<simpara><literal>ERROR</literal> - indicates a serious issue, that later will prevent things like builder, compiler and so on, to run</simpara>
+</listitem>
+<listitem>
+<simpara><literal>WARNING</literal> - indicates a possible semantic problem, where the user have to decide how to handle it. Issues with such severity won’t stop any post processing</simpara>
+</listitem>
+<listitem>
+<simpara><literal>INFO</literal> - only an information hint for the user. Note, it is not allowed to create a diagnostic with severity INFO.</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+<listitem>
+<simpara>can be statically provided by calling the AbstractDeclarativeValidator methods error(..), warning(..), info(..) or directly pass the severity to a sub class of AbstractValidationDiagnostic (e.g. FeatureBasedDiagnostic, RangeBasedDiagnostic)</simpara>
+</listitem>
+<listitem>
+<simpara>can also determined dynamically at runtime with using the IssueSeveritiesProvider and a implementation of IPreferenceValuesProvider (e.g. the EclipsePreferencesProvider that uses the Eclipse preference store and preference page)</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+<listitem>
+<simpara>Issue codes</simpara>
+<itemizedlist>
+<listitem>
+<simpara>used to identify an issue elsewhere, e.g. when applying an quickfix for a validation issue but also for configuring validation handling (e.g. in a Eclipse preference page).</simpara>
+</listitem>
+<listitem>
+<simpara>We can use this issue code to also externalize the issue messages at a central place</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+<listitem>
+<simpara>Issue data: String array to store additional data to be used in other places (e.g. hints for quickfixes)</simpara>
+</listitem>
+<listitem>
+<simpara>message: The message shown as text for the marker created at the resource in Eclipse and shown in the Xtext editor but also available by the methods getWarnings and getErrors at the XtextResource itself and so usable when logging messages to console in headless mode</simpara>
+</listitem>
+</itemizedlist>
+</section>
+<section xml:id="sec:validation_control_flow" role="language-n4js">
+<title>Validation control flow</title>
+<simpara><xref linkend="fig:cd_validation"/> gives an overview over the common control flow that triggers validation.</simpara>
+<figure xml:id="fig:cd_validation" role="center">
+<title>Validation control flow</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/10_validation/images/cd_validation.svg"/>
+</imageobject>
+<textobject><phrase>cd validation</phrase></textobject>
+</mediaobject>
+</figure>
+<simpara>Validation is either triggered by dirty state handling (editing an Xtext document without saving starts a validation job) or by the automated build (invoked directly or started by resource changes in the project e.g. after saving a file).</simpara>
+<simpara>While in dirty state handling the current resource is already parsed and resolved the builder have to load the resource.</simpara>
+<simpara>All issues collected during load (i.e. during parsing, linking and scoping) the resource are added to the resource.</simpara>
+<simpara>In the automated build process there is step <literal>updateMarkers</literal> that triggers the validation.</simpara>
+<simpara>The <literal>SourceContainerAwareResourceValidator</literal> is a customization by us to handle only files that are contained in folders declared as source container by the package.json file.</simpara>
+<simpara>The <literal>CancelableDiagnostican</literal>, called by the resource validator, iterates over all elements contained in the resource. For each element the bound validator is called, in our case <literal>N4JSValidator</literal>, as it is registered as validator for the N4JS EPackage (in <literal>AbstractN4JSValidator</literal>).</simpara>
+<simpara>As this validator extends <literal>AbstractDeclarativeValidator</literal> in the first step all methods that are annotated with @Check and that have exactly one parameter are collected keyed by the type of their input parameter. The result of this collection process is cached. There is a defined order how the methods are collected:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>all local methods</simpara>
+</listitem>
+<listitem>
+<simpara>all methods recursively found in the super classes of the current class</simpara>
+</listitem>
+<listitem>
+<simpara>all methods found for the in the composed check annotation defined validators (by applying this algorithm as well)</simpara>
+</listitem>
+<listitem>
+<simpara>all methods recursively found in the composed checks in the super classes of the current class (by applying this algorithm as well)</simpara>
+</listitem>
+</itemizedlist>
+<simpara>The <literal>N4JSValidator</literal> filters all methods that uses the type of the currently traversed element from the before collected check methods and invokes them with the element from the resource.</simpara>
+<simpara>The Xsemantics type system validator is used as one of the composed validators in <literal>N4JSValidator</literal>. So although <literal>N4JSValidator</literal> extends <literal>N4JSTypeSystemValidator</literal>, <literal>N4JSTypeSystemValidator</literal> just re-uses the validation infrastructure but not its call hierarchy.</simpara>
+</section>
+<section xml:id="sec:validation_issue_ids" role="language-n4js">
+<title>Issue IDs and Messages</title>
+<simpara>For now the NLS validation message bundle resides in<?asciidoc-br?>
+<literal>/org.eclipse.n4js/src/org/eclipse/n4js/validation/messages.properties</literal><?asciidoc-br?>
+The entries in the messages.properties follows the pattern as described in <literal>NLSProcessor</literal>, the NLS class is <literal>IssueCodes</literal></simpara>
+<tip>
+<simpara>We use the same pattern for semver and json.</simpara>
+</tip>
+<itemizedlist>
+<listitem>
+<simpara>IDs shouldn’t be to long, as there might be a lot of markers and the issue codes are stored in memory</simpara>
+</listitem>
+<listitem>
+<simpara>the ID should encode where the issue has been created, therefore there should be common used prefixes like</simpara>
+<itemizedlist>
+<listitem>
+<simpara>PRS for parser (not used yet)</simpara>
+</listitem>
+<listitem>
+<simpara>VCO for value converter</simpara>
+</listitem>
+<listitem>
+<simpara>AST for issues found during AST traversal</simpara>
+</listitem>
+<listitem>
+<simpara>LIN for issues found during scoping/linking (not used yet)</simpara>
+</listitem>
+<listitem>
+<simpara>TYS for type system</simpara>
+</listitem>
+<listitem>
+<simpara>VAL for semantic validation (not used yet)</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+<listitem>
+<simpara>besides the source also the domain of the issue should be encoded (the following list may reduced or extended over time, when it gets obvious which sorts of domain specific validations are required in which frequency)</simpara>
+<itemizedlist>
+<listitem>
+<simpara>CLF for issues common to all classifiers</simpara>
+</listitem>
+<listitem>
+<simpara>CLA for classes (not used yet)</simpara>
+</listitem>
+<listitem>
+<simpara>ROL for roles</simpara>
+</listitem>
+<listitem>
+<simpara>FUN for function</simpara>
+</listitem>
+<listitem>
+<simpara>IMP for imports</simpara>
+</listitem>
+<listitem>
+<simpara>VAR for variables (not used yet)</simpara>
+</listitem>
+<listitem>
+<simpara>MEM for classifier members in general</simpara>
+</listitem>
+<listitem>
+<simpara>OLI for object literals (not used yet)</simpara>
+</listitem>
+<listitem>
+<simpara>ENU for enumerations (not used yet)</simpara>
+</listitem>
+<listitem>
+<simpara>ARR for array literals (not used yet)</simpara>
+</listitem>
+<listitem>
+<simpara>ANN for annotation related issues (not used yet)</simpara>
+</listitem>
+<listitem>
+<simpara>EXP for expression related issues (assignment expression, binary expression, etc.) (not used yet)</simpara>
+</listitem>
+<listitem>
+<simpara>STMT for statement related issues, such as if-else (conditional) , loops, switch etc.</simpara>
+</listitem>
+<listitem>
+<simpara>PRP for property access related issues (not used yet)</simpara>
+</listitem>
+<listitem>
+<simpara>EXC for exception handling related issues (not used yet)</simpara>
+</listitem>
+<listitem>
+<simpara>LBL for labels related issues (not used yet)</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+<listitem>
+<simpara>also technical validation aspects can be encoded</simpara>
+<itemizedlist>
+<listitem>
+<simpara>DUP for duplicate checks</simpara>
+</listitem>
+<listitem>
+<simpara>VIS for visibility checks (public, private, export, etc.)</simpara>
+</listitem>
+<listitem>
+<simpara>STR for issues related only applied in strict mode</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+<listitem>
+<simpara>examples</simpara>
+<itemizedlist>
+<listitem>
+<simpara><literal>IMP_AMBIGUOUS</literal></simpara>
+</listitem>
+<listitem>
+<simpara><literal>VIS_ILLEGAL_MEMBER_ACCESS</literal></simpara>
+</listitem>
+<listitem>
+<simpara><literal>CLF_ABSTRACT_FINAL</literal></simpara>
+</listitem>
+<listitem>
+<simpara><literal>AST_RESERVED_IDENTIFIER</literal></simpara>
+</listitem>
+<listitem>
+<simpara><literal>VCO_HEXINT_CONVERT_EMPTY_STR</literal></simpara>
+</listitem>
+<listitem>
+<simpara><literal>TYS_NO_SUBTYPE</literal></simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+</itemizedlist>
+</section>
+<section xml:id="sec:validation_usage_patterns" role="language-n4js">
+<title>Usage Pattern</title>
+<simpara>Due to the different places and circumstances a real unification of the API wasn’t possible yet (and wouldn’t have made sense), so there are these different usage patterns</simpara>
+<itemizedlist>
+<listitem>
+<simpara>in a custom error aware EObjectDescription like WrongFieldAccessorDescription you just return the issue code in getIssueCode and the message created using the issue code as well as the replacements for the wildcards in getMessage</simpara>
+</listitem>
+<listitem>
+<simpara>in a validator extending AbstractDeclarativeValidator you just call <literal>addIssue(message, context, EFeature, issueCode)</literal>. The message you have to create before by calling the corresponding <literal>getMessageFor[ISSUE_ID]</literal> method passing the required wildcard replacement</simpara>
+</listitem>
+<listitem>
+<simpara>in the ASTStructureValidator you have to call <literal>producer.addDiagnostic(new DiagnosticMessage(IssueCodes.messageFor[ISSUE_ID](wildcard1, wildcard2, ..), IssueCodes.getDefaultSeverity(IssueCodes.[ISSUE_ID]), IssueCodes.[ISSUE_ID]))</literal></simpara>
+</listitem>
+<listitem>
+<simpara>in the custom value converters you have to pass the information to an exception, so the call is: <literal>new N4JSValueConverterException(IssueCodes.getMessageFor[ISSUE_ID](wildcard1, wildcard2, ..), IssueCodes.[ISSUE_ID], node, null)</literal>. Beside this exception also N4JSValueConverterWithValueException is used in some places. In N4JSLinker then these exceptions are catched and a DiagnosticMessage is created out of the informations contained in these exceptions.</simpara>
+</listitem>
+<listitem>
+<simpara>As Xsemantics uses hard wired error or warning in its grammar you cannot adapt these places, but there are currently only three messages produced by Xsemantic (cannot type, not a sub type, null object passed to system). They are all handled in N4JSTypeValidator.createError where the message from Xsemantic is split up in its parts and then passed as wild card replacements to e.g. <literal>IssueCodes.getMessageForTYS_NO_SUBTYPE</literal>.</simpara>
+</listitem>
+</itemizedlist>
+</section>
+<section xml:id="sec:validation_links">
+<title>Links</title>
+<itemizedlist>
+<listitem>
+<simpara><link xl:href="http://www.eclipse.org/Xtext/documentation.html#validation">Xtext Runtime Concepts: Validation</link></simpara>
+</listitem>
+<listitem>
+<simpara><link xl:href="http://blog.dietmar-stoll.de/2013/04/multiple-validators-in-xtext.html">Multiple validators in Xtext</link></simpara>
+</listitem>
+<listitem>
+<simpara>Customize error messages</simpara>
+<itemizedlist>
+<listitem>
+<simpara><link xl:href="http://zarnekow.blogspot.de/2010/06/customizing-error-messages-in-xtext-10.html">Customizing error messages in Xtext</link></simpara>
+</listitem>
+<listitem>
+<simpara><link xl:href="http://blog.dietmar-stoll.de/2012/07/custom-syntax-error-messages-with-quick.html">Custom syntax error messages with quickfix</link></simpara>
+</listitem>
+<listitem>
+<simpara><link xl:href="http://stackoverflow.com/questions/14526524/xtext-customizing-error-msg-by-unordered-groups">Xtext: customizing error messages by unordered groups</link></simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+</itemizedlist>
+</section>
+</chapter>
+<chapter xml:id="_references">
+<title>References</title>
+<warning>
+<simpara>This chapter maybe outdated.</simpara>
+</warning>
+<section xml:id="sec:usecases">
+<title>Use cases</title>
+<informaltable tabstyle="horizontal" frame="none" colsep="0" rowsep="0">
+<tgroup cols="2">
+<colspec colwidth="15*"/>
+<colspec colwidth="85*"/>
+<tbody valign="top">
+<row>
+<entry>
+<simpara>Compilation</simpara>
+</entry>
+<entry>
+<simpara>for deciding in incremental builder which resources requires a recompilation</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Editing</simpara>
+</entry>
+<entry>
+<simpara>Dirty state calculation: for deciding which resources needs to be reparsed as references have changed</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>UI</simpara>
+</entry>
+<entry>
+<simpara>Such as <keycap>Find references</keycap>, find all places in the workspaces that points to the selected element</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Tools</simpara>
+</entry>
+<entry>
+<simpara>requiring references, such as refactorings, e.g., rename refactoring: apply the renaming of the element also to all references to it (like find by references)</simpara>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+</section>
+<section xml:id="sec:calculation_algorithm" role="language-n4js">
+<title>Calculation algorithm</title>
+<section xml:id="sec:Xtext_default_implementation">
+<title>Xtext default implementation</title>
+<simpara>Using Reference Descriptions:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>default implementation contained in method <literal>createReferenceDescriptions</literal> of <literal>o.e.x.resource.impl.DefaultResourceDescriptionStrategy</literal></simpara>
+</listitem>
+<listitem>
+<simpara>iterates over all EReferences of the EClass of the current element</simpara>
+</listitem>
+<listitem>
+<simpara>navigates all references and resolves them (already done before in DefaultResourceDescription.computeReferenceDescriptions)</simpara>
+</listitem>
+<listitem>
+<simpara>create reference description objects for all these references</simpara>
+</listitem>
+</itemizedlist>
+<simpara>In case of N4JS and the types, reference descriptions are also created for references to types model elements (definedType) and for references from Types element to AST.</simpara>
+<simpara>We do not use this default implementation for two reasons:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>expensive</simpara>
+</listitem>
+<listitem>
+<simpara>Default implementation of reference descriptions only calculates the direct dependencies but not the transitive ones + the calculation of the URIs is very expensive.</simpara>
+</listitem>
+</orderedlist>
+</section>
+<section xml:id="sec:N4_implementation">
+<title>N4JS implementation</title>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>the Xtext default implementation is disabled by let <literal>N4JSResourceDescription.computeReferenceDescriptions</literal> return an empty list. Also the bound <literal>N4JSDescriptionUtils</literal> returns an empty list for collectOutgoingReferences</simpara>
+</listitem>
+<listitem>
+<simpara>Calculating <emphasis>direct references</emphasis> are only done inside <literal>N4JSResourceDescription.getImportedNames</literal> (that uses newly introduced <literal>N4JSCrossReferenceComputer.computeCrossRefs</literal> for collecting all direct dependencies) - here only (parameterized) type refs, types and identifiable elements are collected</simpara>
+</listitem>
+<listitem>
+<simpara>collect all <emphasis>transitive dependencies</emphasis>, i.e. all super classes, consumed roles and implemented interfaces in the type hierarchy and add their resources as dependency (this is done in <literal>N4JSResourceDescription.getImportedNames</literal> (after calculating all direct dependencies with <literal>N4JSResourceDescriptionStrategy</literal>)</simpara>
+</listitem>
+<listitem>
+<simpara>bind <literal>N4JSReferenceQueryExecutor</literal> as a custom implementation to calculate the target URIs for an given target element and bind <literal>N4JSReferenceFinder</literal> as a custom implementation to calculate reference descriptions to be used by the default Xtext found references UI (use case UI)</simpara>
+</listitem>
+</orderedlist>
+<simpara><literal>ClusteringBuilderState.doUpdate</literal> calculates if a dependent resource has changed (in the context of calculating the <literal>DefaultResourceDescriptionDelta</literal> out of the old and new resource descriptions). Each resource description consists of <literal>EObjectDescriptions</literal>. The <literal>EObjectDescription</literal> for <literal>Script</literal> also contains the types model (<literal>TModule</literal>) for the resource. The references between resources are implemented via the type model. If it has changed (compared with the user data of the old <literal>EObjectDescription</literal>) then all other resource descriptions registered as been dependent on the resource (the qualified names of the resource descriptions are serialized as imported names within the resource description) will be notified that a reparse is needed.</simpara>
+<simpara>For <emphasis>dirty state</emphasis> the same behavior is achieved via the dirty state editor support using the resource set of the editor (instead the file system resources).</simpara>
+<simpara>As the primitive and built-in types are fixed they are ignored when calculating the dirty state. When calculating dependending resources and dirty state the reference of an AST element to its defining type is ignored as is the reference from the type to its AST element</simpara>
+<simpara><link linkend="fig:cd_classes">Classes</link> shows the different entry points (user actions) and classes involved in the process.</simpara>
+<informalfigure xml:id="fig:cd_classes" role="center">
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/11_references/images/cd_classes.svg"/>
+</imageobject>
+<textobject><phrase>title-"Reference handling"</phrase></textobject>
+</mediaobject>
+</informalfigure>
+</section>
+</section>
+<section xml:id="sec:PerformanceOfDependencyCalculation" role="language-n4js">
+<title>Performance Of Dependency Calculation</title>
+<simpara>Concerning frequency and contexts it is clear, that triggering <literal>Find references</literal> and rename refactoring is not as frequent as editing (n4)js files that leads to dirty state (very often as happens when editing) and to trigger compilation (at file save, also often). Calculating if a resource is affected by a change (dirty state calculation) may not be too expensive. But running compilation for too many files (or the wrong set of files) due to incorrect dirty state calculation is expensive.</simpara>
+<simpara><literal>N4JSResourceDescription.getImportedNames</literal> is invoked on every edit of a file in the editor, so on every edit the complete content has to be retraversed for possible new references (expensive but not avoidable). For the types of all found references the super types have to recalculated. Traversing the type hierarchy shouldn’t be too expensive.</simpara>
+<simpara>Possible optimization could be:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>caching of traversing referenced types whose resources had not changed since last edit</simpara>
+</listitem>
+<listitem>
+<simpara>not traversing types that are imported but non of their features are used within the current resource</simpara>
+</listitem>
+</orderedlist>
+<simpara><emphasis>Those optimization should be done only if there are real performance issues are discovered.</emphasis></simpara>
+</section>
+<section xml:id="sec:kinds_of_references" role="language-n4js">
+<title>Kinds of references</title>
+<section xml:id="sec:Cross_References_to_be_ignored">
+<title>Cross References to be ignored</title>
+<informaltable frame="all" rowsep="1" colsep="1">
+<tgroup cols="3">
+<colspec colname="col_1" colwidth="33.3333*"/>
+<colspec colname="col_2" colwidth="33.3333*"/>
+<colspec colname="col_3" colwidth="33.3334*"/>
+<thead>
+<row>
+<entry align="left" valign="top">Element</entry>
+<entry align="left" valign="top">Reference</entry>
+<entry align="left" valign="top">Explanation</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry align="left" valign="top"><simpara>TypeDefiningElement</simpara></entry>
+<entry align="left" valign="top"><simpara>definedType: Type</simpara></entry>
+<entry align="left" valign="top"><simpara>always inner resource change (e.g., Functions, Classifier)</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara>types::Type</simpara></entry>
+<entry align="left" valign="top"><simpara>astElement</simpara></entry>
+<entry align="left" valign="top"><simpara>as always inner resource change</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara>ImportDeclaration</simpara></entry>
+<entry align="left" valign="top"><simpara>importedModule: TModule</simpara></entry>
+<entry align="left" valign="top"><simpara>only affected if the resource name changes (and such a change cannot be performed dirty)</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara>ContinueStatement</simpara></entry>
+<entry align="left" valign="top"><simpara>label: LabelledStatement</simpara></entry>
+<entry align="left" valign="top"><simpara>always inner resource changes</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara>BreakStatement</simpara></entry>
+<entry align="left" valign="top"><simpara>label: LabelledStatement</simpara></entry>
+<entry align="left" valign="top"><simpara>always inner resource changes</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara>types::PrimitiveType</simpara></entry>
+<entry align="left" valign="top"><simpara>autocoercedObject: TClassifier</simpara></entry>
+<entry align="left" valign="top"><simpara>fixed (immutable) and internal</simpara></entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+</section>
+<section xml:id="sec:Cross_References_to_be_handled" role="language-n4js">
+<title>Cross References to be handled</title>
+<simpara>Cross References</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>types::ParameterizedTypeRef &#8594; declaredType : Type</simpara>
+</listitem>
+<listitem>
+<simpara>* &#8594; N4GetterDeclaration: N4FieldDeclaration type, but references to getter can be done also done from outside</simpara>
+</listitem>
+<listitem>
+<simpara>* &#8594; N4SetterDeclaration: undef, references to setter can be done also done from outside</simpara>
+</listitem>
+<listitem>
+<simpara>types::PrototypeTypeRef &#8594; type : Type</simpara>
+</listitem>
+</orderedlist>
+<simpara>Contained <literal>ParameterizedTypeRef</literal> and <literal>TypeVariables</literal> (that internally references to <literal>Type</literal>):</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>references to declared super types of a type (Class, Role, Interface), i.e. superType, consumedRoles, implementedInterfaces</simpara>
+</listitem>
+<listitem>
+<simpara>TypeVariable &#8594; declaredUpperBounds</simpara>
+</listitem>
+<listitem>
+<simpara>References in type arguments:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>Wildcards &#8594; upper and lower bounds, e.g. <literal>var List&lt;? super A&gt; l1;</literal></simpara>
+</listitem>
+<listitem>
+<simpara>direct type references, e.g. <literal>var List&lt;A&gt; l;</literal></simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+</orderedlist>
+<simpara>Cross References to IdentifiableElement (types):</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>IdentifierRef &#8594; id : IdentifiableElement</simpara>
+</listitem>
+<listitem>
+<simpara>NamedImportSpecifier &#8594; importedElement : IdentifiableElement</simpara>
+</listitem>
+<listitem>
+<simpara>ParameterizedPropertyAccessExpression &#8594; property : IdentifiableElement</simpara>
+</listitem>
+<listitem>
+<simpara>PropertyAccessExpression &#8594; property : IdentifiableElement</simpara>
+</listitem>
+</orderedlist>
+<simpara>Contained IdentifierRef (that internally references to IdentifiableElement):</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>ParameterizedCallExpression &#8594; target</simpara>
+</listitem>
+<listitem>
+<simpara>as PrimaryExpression in MemberExpression</simpara>
+</listitem>
+</orderedlist>
+</section>
+</section>
+<section xml:id="sec:transitive_dependencies">
+<title>Transitive dependencies</title>
+<simpara>Besides the direct dependencies we also need the transitive dependencies, as demonstrated in the following example.</simpara>
+<formalpara xml:id="ex:transdepex">
+<title>Transitive Dependency</title>
+<para>
+<programlisting language="java" linenumbering="unnumbered">export class A {
+    public myMethod()
+}</programlisting>
+</para>
+</formalpara>
+<formalpara>
+<title>Transitive Dependency pt.2</title>
+<para>
+<programlisting language="java" linenumbering="unnumbered">export class B extends my/test/A {
+}</programlisting>
+</para>
+</formalpara>
+<formalpara>
+<title>Transitive Dependency pt.3</title>
+<para>
+<programlisting language="java" linenumbering="unnumbered">export class C extends my/test/B {
+    myMethodC() {
+        this.myMethod()
+    }
+}</programlisting>
+</para>
+</formalpara>
+<simpara>If the name of <literal>myMethod</literal> in A changes, C should get dirty. This can get more complicated, if, e.g., a method in a consumed role is renamed, which then leads to binding references to super types.</simpara>
+<simpara>Therefore all direct and indirect super types are calculated (including super classes, consumed roles and implemented interfaces) for all found directly referenced types. The qualified names of their resources are added to the list of imported names. <footnote><simpara>One could think of an optimization to only register those types that are not just imported or declared, but whose features are really in use. E.g., in one file another type be imported (and even used as type of variable), but non of its member is used. So changes to these members wouldn’t affect the current resources. However this might miss certain cases. E.g., when a method in the super class is removed and now the method with same signature of a consumed role would be used. The method of the role has no been used before, yet must not be ignored. Thus, currently all super classes, roles and interfaces and referenced classes are added as dependency regardless if their members are called.</simpara></footnote></simpara>
+<simpara>Other transitive dependencies:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>call of member mixed by a consumed role</simpara>
+<orderedlist numeration="loweralpha">
+<listitem>
+<simpara>role is consumed by role consumed by this class</simpara>
+</listitem>
+<listitem>
+<simpara>role is consumed by class inherited by this class</simpara>
+</listitem>
+</orderedlist>
+</listitem>
+<listitem>
+<simpara>call of member available by implemented interface</simpara>
+<orderedlist numeration="loweralpha">
+<listitem>
+<simpara>interface is implemented by role consumed by this class</simpara>
+</listitem>
+<listitem>
+<simpara>interface is implemented by class inherited by this class</simpara>
+</listitem>
+</orderedlist>
+</listitem>
+<listitem>
+<simpara>call of member available by extended class</simpara>
+<orderedlist numeration="loweralpha">
+<listitem>
+<simpara>class is extended by class inherited by this class</simpara>
+</listitem>
+</orderedlist>
+</listitem>
+<listitem>
+<simpara>chained method calls</simpara>
+<orderedlist numeration="loweralpha">
+<listitem>
+<simpara>method is of type that itself has members which are directly called, so the type is not directly imported or referenced by name in the caller but indirectly required</simpara>
+</listitem>
+<listitem>
+<simpara>method is of type that itself inherits members which are directly called, so the type (and its super types) is not directly imported or referenced by name in the caller but indirectly required</simpara>
+</listitem>
+</orderedlist>
+</listitem>
+</orderedlist>
+<informalexample>
+<simpara>Each type is defined in its own file.</simpara>
+<programlisting language="java" linenumbering="unnumbered">export class MyClassOne  {
+    myMethodOne() {
+        var MyClassTwo instance;
+        instance.getElement().myMethodThree()
+    }
+}</programlisting>
+<programlisting language="java" linenumbering="unnumbered">export class MyClassTwo  {
+    MyClassThree getElement() {
+        return new MyClassThree;
+    }
+}</programlisting>
+<programlisting language="java" linenumbering="unnumbered">export class MyClassThree  {
+    void myMethodThree() {}
+}</programlisting>
+<simpara>If <literal>myMethodThree</literal> is renamed this should affect MyClassOne.</simpara>
+<simpara>Note that the method call in <literal>MyClassOne</literal> directly binds to the method in <literal>MyClassThree</literal>. However, the dependencies are only managed by means of types. So, from that perspective, the dependency between <literal>MyClassOne</literal> and <literal>MyClassThree</literal> is indirect.</simpara>
+<programlisting language="java" linenumbering="unnumbered">export class MyClassOne  {
+    void myMethodOne() {
+        var MyClassTwo instance;
+        instance.myMethodTwo().getElement().myMethodFour()
+    }
+}</programlisting>
+<programlisting language="java" linenumbering="unnumbered">export class MyClassTwo {
+    MyClassThree&lt;MyClassFour&gt; myMethodTwo() {
+        return null;
+    }
+}</programlisting>
+<programlisting language="java" linenumbering="unnumbered">export class MyClassThree&lt;T extends MyClassFour&gt;  {
+    T element;
+
+    T getElement() {
+        return this.element;
+    }
+}</programlisting>
+<programlisting language="java" linenumbering="unnumbered">export class MyClassFour  {
+    void myMethodFour() {
+    }
+}</programlisting>
+<simpara>If <literal>myMethodFour</literal> is renamed this should affect <literal>MyClassOne</literal>.</simpara>
+</informalexample>
+<simpara>More examples are found in the tests (cf. <literal>..ide.n4js.dirtystate.BuilderParticipantPluginTest</literal> and <literal>&#8230;&#8203;BuilderParticipantPluginUITest</literal>)</simpara>
+</section>
+<section xml:id="sec:find-references" role="language-n4js">
+<title>Find references</title>
+<simpara>Find references is perceived as a feature in Eclipse IDE, but its implementation can also be useful in a headless scenario, e.g. in the compiler to drop dead code.
+Therefore, as opposed to the Xtext default implementations, the code was refactored to split the parts that depend on the UI from the non-UI dependent logic (see <literal>org.eclipse.n4js.findReferences</literal> vs. <literal>org.eclipse.n4js.ui.search</literal>).</simpara>
+<section xml:id="_background">
+<title>Background</title>
+<simpara>Since no reference descriptions are stored in the index for N4JS resources, the cross references have to be found by other means.
+That is, the list of imported names is used as an indicator to find resources that have a potential dependency to the searched element.
+These resources have to be checked thoroughly.
+That is, their clear text representation is checked at a first step against the clear text representation of the found element before the resource is fully loaded and cross references are resolved.</simpara>
+<simpara>The decision to drop reference descriptions from the index was deliberate since they would only report bogus information in the context of inheritance, e.g. a method <literal>getA</literal> of type <literal>B</literal> my be overridden by <literal>getA</literal> in type <literal>C</literal>.
+Concrete bindings against <literal>C.getA</literal> should also be reported as references to <literal>B.getA</literal> since they identify the same public API of the type hiearchy around <literal>B</literal>.
+Therefore reference descriptions could not be used to find dependencies between source snippets.</simpara>
+</section>
+<section xml:id="_how-find-references-work">
+<title>How Find References Work</title>
+<simpara>Methods for finding references are provided Xtext&#8217;s interface <literal>IReferenceFinder</literal> and can be used both by the UI or headlessly.
+The N4JS implementation of this interface for the N4JS language is the class <literal>ConcreteSyntaxAwareReferenceFinder</literal>.
+One of the key methods defined by the <literal>IReferenceFinder</literal> is <literal>void findAllReferences(TargetURIs, IResourceAccess, IResourceDescriptions, Acceptor, IProgressMonitor)</literal> that finds all places in all resources of the index whereby those places cross-reference one of the URIs contained in <literal>TargetURIs</literal> .</simpara>
+<itemizedlist>
+<listitem>
+<simpara><literal>TargetURIs</literal> contains the set of URIs to be searched. The caller of <literal>IReferenceFinder</literal> is responsible for collecting the <literal>Target URIs</literal> to be searched.</simpara>
+</listitem>
+<listitem>
+<simpara><literal>IResourceAccess</literal> is used to search local references. This is needed because local references are usually not index.</simpara>
+</listitem>
+<listitem>
+<simpara><literal>IResourceDescriptions</literal> is the indexed.</simpara>
+</listitem>
+<listitem>
+<simpara><literal>Acceptor</literal> is called when a reference is found.</simpara>
+</listitem>
+<listitem>
+<simpara><literal>IProgressMonitor</literal> is used for showing progress bar (can be null).</simpara>
+</listitem>
+</itemizedlist>
+<simpara>In the following, we will have a look at the workflow to find references when triggered in the UI.
+After understanding the UI case, the workflow of find references in the headless case should be self-explanatory.</simpara>
+<simpara><link linkend="fig:findreference_workflow">Find reference workflow</link> shows the workflow of find references when triggered in the UI.</simpara>
+<informalfigure xml:id="fig:findreference_workflow" role="center">
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/11_references/images/findreference_workflow.svg"/>
+</imageobject>
+<textobject><phrase>title-"Find reference workflow"</phrase></textobject>
+</mediaobject>
+</informalfigure>
+<simpara>The following example will be used for explanation.</simpara>
+<formalpara>
+<title>A.n4js</title>
+<para>
+<programlisting language="n4js" linenumbering="unnumbered">import {B} from "B";
+let b = new B(); // B here is an IdentifierRef referring to TClass B in B.n4js</programlisting>
+</para>
+</formalpara>
+<formalpara>
+<title>B.n4js</title>
+<para>
+<programlisting language="n4js" linenumbering="unnumbered">export public class B {}</programlisting>
+</para>
+</formalpara>
+<section xml:id="_step-1-convert-cursor-position-to-declared-element">
+<title>Step 1: Convert Cursor Position to Declared Element</title>
+<simpara>This step is represented by the purple color in <link linkend="fig:findreference_workflow">Find reference workflow</link> diagram.</simpara>
+<simpara>In the IDE, for the sake of convenience, we allow the user to find references of an arbitrary element at the current cursor.
+For instance, while the cursor is currently at <literal>IdentifierRef B</literal> in the <literal>NewExpression</literal> in <literal>A.n4js</literal>, the user may want to find all references to <literal>B</literal>.
+In those cases, we first need to find declaration element of <literal>IdentifierRef B</literal> which is <literal>TClass B</literal>. The Target URIs then contains a single URI to <literal>TClass B</literal>.
+In diagram <link linkend="fig:findreference_workflow">Find reference workflow</link>, the classe <literal>EObjectAtOffsetHelper</literal> can convert the current cursor position into a declared element.</simpara>
+</section>
+<section xml:id="_step-2-convert-declared-element-to-target-uris">
+<title>Step 2: Convert Declared Element to Target URIs</title>
+<simpara>This step is represented by the yellow color in <link linkend="fig:findreference_workflow">Find reference workflow</link> diagram.</simpara>
+<simpara>The Target URIs contains the URIs whose references are to be searched.
+The caller guarantees that <emphasis>Target URIs contain only URIs to declared elements, i.e. definitions</emphasis>.
+For example, if we want to find references for <literal>N4ClassDeclaration B</literal> in <literal>B.n4js</literal>, the target URIs contains a URI to the AST node <literal>N4ClassDeclaration B</literal> and a URI to the TModule node <literal>TClass B</literal>.
+Note that, in addition to the URI to the AST node <literal>N4ClassDeclaration B</literal>, the URI to the derived TModule node <literal>TClass B</literal> is also needed because <literal>N4ClassDeclaration</literal> can never be a target of a cross reference.
+In the diagram <link linkend="fig:findreference_workflow">Find reference workflow</link> , the classes depicted in yellow color are responsible for converting declared elements to <literal>Target URIs</literal> taking care of the derived <literal>TModule</literal> nodes.</simpara>
+</section>
+<section xml:id="_step-3-filter-potential-resources">
+<title>Step 3: Filter Potential Resources</title>
+<simpara>This step is represented by the green color in <link linkend="fig:findreference_workflow">Find reference workflow</link> diagram.</simpara>
+<simpara>The general algorithm for finding references is to traverse the AST of each resource in the index and check each AST node if it has a cross reference to one of the URI in the <literal>Target URIs</literal>.
+However, this is too expensive because potentially all resources in the index have to be loaded.
+We need some way to quickly decide for a resource description if the corresponding resource may potentially contain the references before actually loading it for a more thorough search.
+This is done using two pieces of information:</simpara>
+<itemizedlist>
+<listitem>
+<simpara><literal>typesOrModulesToFind</literal>: the set containing the fully qualified names of the <literal>type</literal> and <literal>module</literal> of the declaration to be searched. This set is calculated in the class <literal>TargetURIKey</literal>.</simpara>
+</listitem>
+<listitem>
+<simpara><literal>imported names</literal>: the set exposed by <literal>ResourceDescription</literal> that contains the types needed by the underlying resource. The implementation for calculating imported names can be found in the class <literal>N4JSResourceDescription</literal>.</simpara>
+</listitem>
+</itemizedlist>
+<simpara>In our example, supposed that we are finding references for <literal>class B</literal>. The <literal>typesOrModulesToFind</literal> contains fully qualified names to <literal>N4ClassDeclaration B</literal> and <literal>module B</literal>, i.e. <literal>B.B</literal> and <literal>B</literal>.
+The <literal>imported names</literal> of the resource description of <literal>A.n4js</literal> contains fully qualified names to <literal>module B</literal>, <literal>class B</literal>, i.e. <literal>B</literal> and <literal>B.B</literal>.
+Since the set of imported names of <literal>A.n4js</literal> contains elements in <literal>typesOrModulesToFind</literal>, this resource is searched thoroughly for references.</simpara>
+</section>
+<section xml:id="_step-4-search-references-in-resource">
+<title>Step 4: Search References in Resource</title>
+<simpara>If a resource is considered as a candidate for a more thorough search in Step 3, it is loaded.
+Its AST is traversed and at each AST node we check if there is a cross reference to one of the Target URIs (Step 1).
+If yes, the AST node is collected in the set of found references.
+See class <literal>ConcreteSyntaxAwareReferenceFinder</literal> for implementation details.</simpara>
+<simpara>The UI dependent logic may apply additional filters to drop references that are not relevant to the user, e.g. the reference from an AST element to its inferred type and vice versa (see <literal>N4JSReferenceQueryExecutor.isToBeIgnored(EReference)</literal>).</simpara>
+</section>
+<section xml:id="_limitations-and-possible-enhancements">
+<title>Limitations and Possible Enhancements</title>
+<simpara>Other noteworthy limitations and potential enhancements of the current implementations are:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>Semantics: Only references that are available in the model as real references are reported. Even though <literal>getB()</literal> in <literal>myA.getB().getC()</literal> may return an instance of type <literal>B</literal>, there is no reference reported to B in that expression, though a reference to a member of B would be reported for <literal>getC</literal>.</simpara>
+</listitem>
+<listitem>
+<simpara>Visibility constraints are not applied and thus do not reduce the search scope to allow the report of invalidly established references in a later validation.</simpara>
+</listitem>
+</itemizedlist>
+</section>
+</section>
+</section>
+</chapter>
+<chapter xml:id="_compilation">
+<title>Compilation</title>
+<warning>
+<simpara>This chapter may be outdated.</simpara>
+</warning>
+<section xml:id="chap:compilation" role="language-n4js">
+<title>Introduction</title>
+<simpara>Compilation is the process of transforming some source code written by means of a human readable text into a machine readable target file, i.e. bytecode or assembler. However, in the context of N4JS, the target output is not machine code but another high-level programming language. This kind of compiler transforming from one programming language to another is called <emphasis>transpiler</emphasis>, as a combination of <literal>transformation</literal> and <literal>compiler</literal>. The design of the transpiler takes this special setup into account.</simpara>
+<section xml:id="sec:general_design_rationals">
+<title>General design rationals</title>
+<section xml:id="sec:logging_and_error_reporting">
+<title>Logging and error reporting</title>
+<simpara>The generator always expects to get a valid model as an input. So all syntactic and semantic errors (not warnings) in the N4JS code as well as regarding the project configuration, e.g. in the package.json file, should be already discovered in the validation step. So any error marker on the resource will prevent the compiler to run.</simpara>
+<simpara>In case of other errors arising in the generator, the error handling is done as follows:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>either throw an <literal>GeneratorException</literal> or better call <literal>ExceptionHandler.handleError(message)</literal> (that then will throw this exception)</simpara>
+</listitem>
+<listitem>
+<simpara>beside the message also the file and the current line can be passed to <literal>GeneratorException</literal></simpara>
+</listitem>
+<listitem>
+<simpara><literal>GeneratorException</literal> (as extending RuntimeException) will be handled by the generator caller</simpara>
+<itemizedlist>
+<listitem>
+<simpara>in UI: <literal>BuildInstruction</literal> will create an error log entry</simpara>
+</listitem>
+<listitem>
+<simpara>headless: lets the <literal>GeneratorException</literal> fail</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+</itemizedlist>
+</section>
+<section xml:id="sec:progress_monitor">
+<title>Progress monitor</title>
+<simpara>The compiler works on a single file and we do not expect that to take much time. Processors working on many files, such as linkers (in the JavaScript context, that is minification and concatenation), are different components.</simpara>
+</section>
+</section>
+<section xml:id="sec:Xtext_Integration">
+<title>Xtext Integration</title>
+<section xml:id="sec:xtext_default_behaviour">
+<title>Xtext default behaviour</title>
+<simpara>The Xtext builder participant calculates the delta for every change in the project and triggers dirty state handling as well as code generation. By default the builder participant expects exactly one implementation bound to the IGenerator interface and thus only one output configuration provider belonging to this generator.</simpara>
+</section>
+<section xml:id="sec:n4js_requirements">
+<title>N4JS requirements</title>
+<simpara>In constrast to the default Xtext behaviour in the N4JS IDE allows</simpara>
+<itemizedlist>
+<listitem>
+<simpara>the registration / discovery of multiple generators (including compilers and transpilers) but even no compiler at all, so that it is possible to ship the IDE also without any generators</simpara>
+</listitem>
+<listitem>
+<simpara>to configure these generators separately (output paths and so on) workspace globally but also project specific (currently it is only required to enable / disable a compiler)</simpara>
+</listitem>
+<listitem>
+<simpara>to enable / disable generators, but it is allowed to enable more than one compiler at one</simpara>
+</listitem>
+<listitem>
+<simpara>to start compilers headless, i.e. e.g in automated build / JUnit tests but with the possibility to configure them there as well</simpara>
+</listitem>
+</itemizedlist>
+</section>
+<section xml:id="sec:compiler_discovery_in_ui">
+<title>Compiler discovery in UI</title>
+<itemizedlist>
+<listitem>
+<simpara>There is a singleton <literal>ICompositeGenerator</literal>. The <literal>ICompositeGenerator</literal> instance itself doesn’t contain generator logic but knows subgenerators (that implement <literal>ISubGenerator</literal>) to which it delegates the input file (so instead of registering a new builder participant (that then would have to recalculate the delta) only the generator call is extracted)</simpara>
+</listitem>
+<listitem>
+<simpara>In the UI case, the actual execution of the registered generator is done in <literal>BuildInstruction</literal> where every N4JS resource contained in the delta calculated by the builder participant is an <literal>ICompositeGenerator</literal> implementation.</simpara>
+</listitem>
+<listitem>
+<simpara><xref linkend="fig:cd_GeneratorAndBuilderParticipant"/> summarizes the implementation of this compiler infrastructure in the UI case.</simpara>
+</listitem>
+</itemizedlist>
+<figure xml:id="fig:cd_GeneratorAndBuilderParticipant" role="center">
+<title>Builder (UI) and Generator (Core)</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/13_compilation/images/cd_GeneratorAndBuilderParticipant.svg"/>
+</imageobject>
+<textobject><phrase>cd GeneratorAndBuilderParticipant</phrase></textobject>
+</mediaobject>
+</figure>
+</section>
+<section xml:id="sec:compiler_discovery_in_headless">
+<title>Compiler discovery in headless</title>
+<itemizedlist>
+<listitem>
+<simpara><literal>N4JSHeadlessStandaloneSetup</literal> is used to combine <literal>N4JSRuntimeModule</literal> and <literal>N4JSHeadlessGeneratorModule</literal> so there is <literal>PropertiesFileBasedValuesProvider</literal> is bind as implementation for <literal>IPreferenceValuesProvider</literal></simpara>
+</listitem>
+<listitem>
+<simpara>via <literal>N4JSHeadlessStandaloneSetup</literal> the injector is created which is used to create an instance of <literal>ICompositeGenerator</literal></simpara>
+</listitem>
+<listitem>
+<simpara>in the headless mode the subgenerators of are manually registered via an extension point in the class <literal>HeadlessExtensionRegistrationHelper</literal>.</simpara>
+</listitem>
+</itemizedlist>
+</section>
+<section xml:id="sec:general_generator_implementation">
+<title>General generator implementation</title>
+<example>
+<title>Simple IGenerator</title>
+<simpara>The following snippet shows a minimal generator example.</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">public class Generator implements IGenerator {
+    @Override public void doGenerate(Resource resource, IFileSystemAccess fsa) {
+        final String filename = computeTargetFileName(resource.getURI());
+
+        Script script = IterableExtensions.&lt;Script&gt; head(
+            Iterables.&lt;Script&gt; filter(resource.getContents(), Script.class));
+
+        fsa.generateFile(filename, doCompileToString(script));
+    }
+}</programlisting>
+<simpara>Generation is triggered for each Xtext resource. <literal>IFileSystemAccess</literal> is an abstraction of where to write the generated artefacts. This enables using the generator in the IDE (with a workspace) and headless (directly operating on files). In tests you can use <literal>InMemoryFileAccess</literal>, in standalone mode you should use <literal>JavaFileSystemAccess</literal> and in Eclipse mode <literal>EclipseFileSystemAccess2</literal></simpara>
+</example>
+</section>
+<section xml:id="sec:general_generator_activation">
+<title>General generator activation</title>
+<informaltable tabstyle="horizontal" frame="none" colsep="0" rowsep="0">
+<tgroup cols="2">
+<colspec colwidth="15*"/>
+<colspec colwidth="85*"/>
+<tbody valign="top">
+<row>
+<entry>
+<simpara>Programmatically</simpara>
+</entry>
+<entry>
+<simpara>Invoke the <literal>IComposedGenerator.doGenerate</literal> with a loaded N4JS resource and a configured <literal>IFileSystemAccess</literal> implementation.</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Xtext Builder</simpara>
+</entry>
+<entry>
+<simpara>This is available by default when using the bound <literal>IGenerator</literal>, it runs on every change of your N4JS resource when automatic build is enabled in the workspace.</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Context Menu</simpara>
+</entry>
+<entry>
+<simpara>see <link xl:href="christiandietrich.wordpress.com/2011/10/15/xtext-calling-the-generator-from-a-context-menu/">Christian Dietrich’s Blog 2011/10/15</link></simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>MWE2 Workflow</simpara>
+</entry>
+<entry>
+<simpara>via <literal>org.eclipse.xtext.generator.GeneratorComponent</literal> that is configured with the standalone setup of the N4JS language. Such an MWE2 workflow also requires the <literal>org.eclipse.xtext.mwe.Reader</literal> component to first load the N4JS resources to transform in a model slot that is then consumed by the GeneratorComponent</simpara>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+</section>
+</section>
+<section xml:id="sec:Overview_of_Input_Models">
+<title>Overview of the Input Models</title>
+<simpara>The input is a simple instance of <literal>Script</literal>, which is the root model element for all N4JS files. Actually, it is the root of the AST. For the AST elements, other elements stemming from other models are accessible as well. The following models may be important for the compiler:</simpara>
+<informaltable tabstyle="horizontal" frame="none" colsep="0" rowsep="0">
+<tgroup cols="2">
+<colspec colwidth="15*"/>
+<colspec colwidth="85*"/>
+<tbody valign="top">
+<row>
+<entry>
+<simpara>N4JS AST</simpara>
+</entry>
+<entry>
+<simpara>The abstract syntax tree is an EMF model, it is defined in a single Xcore file <literal>N4JS.xcore</literal></simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Parser or Node Model</simpara>
+</entry>
+<entry>
+<simpara>The parser tree, also called node model, is defined by Xtext. It contains offset information, holding whitespaces, line breaks, comments as well as other hidden tokens. It can be accessed via <literal>NodelModelUtils</literal>, that is a node can be retrieved for a given AST element and vice versa. There are three different kind of nodes: root, composite and leaf node.<?asciidoc-br?>
+<emphasis role="strong">As of Dec 2015, the transpiler does no longer make use of the parse tree!</emphasis></simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Type Model</simpara>
+</entry>
+<entry>
+<simpara>The type model is an abstract view on the N4JS AST. It is defined in a single Xcore file <literal>Types.xcore</literal>. Not all AST elements are related to type model information. This is only true for subtypes of <literal>TypeDefiningElement</literal>, with references to <literal>Type</literal> or containing a <literal>TypeRef</literal>.</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>N4 Project</simpara>
+</entry>
+<entry>
+<simpara>via <literal>OutputPathHelper</literal> located in <literal>org.eclipse.n4js.generator</literal> wraps the calculation of compiled file path.</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Grammar Model</simpara>
+</entry>
+<entry>
+<simpara>Grammar Model created from <literal>N4JS.xtext</literal>, the rules can be access in the Java code via <literal>N4JSGrammarAccess</literal>. The grammar elements can be retrieved from the parser model vial <literal>node.getGrammarElement()</literal>. <literal>org.eclipse.xtext.GrammarUtil</literal> also contains some useful helper methods.<?asciidoc-br?>
+<emphasis role="strong">As of Dec 2015, the transpiler does no longer make use of the grammar model!</emphasis></simpara>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+</section>
+</section>
+<section xml:id="sec:Core_Generator" role="language-n4js">
+<title>Generators</title>
+<simpara>Generators are an abstraction above that of transpilers. N4JS transpilers are implemented as specific generators, but there might be other generators that are not transpilers (e.g. generator that produces HTML documentation from the jsdoc in the N4JS source files).</simpara>
+<section xml:id="sec:Compiler_Components">
+<title>Generator Components</title>
+<simpara><xref linkend="fig:comp_compilers"/> gives an overview over the compiler related components. Some of these components are described in detail in the following sections.
+As of Dec 2017, the generator architecture has been refactored and simplified.</simpara>
+<itemizedlist>
+<listitem>
+<simpara>There is only a single <literal>ICompositeGenerator</literal> instance. Since the single instance should simply delegate to subgenerators, composite generators can no longer be registered via extension point.</simpara>
+</listitem>
+<listitem>
+<simpara>Most of generator related code is moved into <literal>org.eclipse.n4js</literal> bundle. This is needed because we need to bind <literal>ICompositeGenerator</literal> to a concrete implementation in the <literal>org.eclipse.n4js</literal> bundle and the extension point for <literal>ICompositeGenerator</literal> has been removed.</simpara>
+</listitem>
+<listitem>
+<simpara>An extension point <literal>org.eclipse.n4js.generator.subgenerator</literal> is introduced in the <literal>org.eclipse.n4js</literal> bundle. This makes it possible to register a new subgenerator via extension point.</simpara>
+</listitem>
+</itemizedlist>
+<figure xml:id="fig:comp_compilers" role="center">
+<title>Compiler Components</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/13_compilation/images/comp_compilers.svg"/>
+</imageobject>
+<textobject><phrase>comp compilers</phrase></textobject>
+</mediaobject>
+</figure>
+<simpara><xref linkend="fig:od_generatorInjection"/> shows how composite generator and subgenerators interact with other components both in the UI and in the headless case.</simpara>
+<figure xml:id="fig:od_generatorInjection" role="center">
+<title>Discovering generators and provide them with Guice bindings.</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/13_compilation/images/od_generatorInjection.svg"/>
+</imageobject>
+<textobject><phrase>od generatorInjection</phrase></textobject>
+</mediaobject>
+</figure>
+<simpara>As we can see in the diagram above. In the UI case, <literal>N4JSBuilderParticipant</literal> creates <literal>BuildInstruction</literal> which in turn delegates the generation logics to an instance of <literal>ICompositeGenerator</literal>. The <literal>ICompositeGenerator</literal> simply delegates the generation logics to subgenerators .</simpara>
+<simpara>In the headless mode, <literal>n4jscBase.doMain</literal> creates an instance of <literal>N4JSStandaloneSetup</literal> and obtains the injector from there. This injector is then used to create an instance of <literal>ICompositeGenerator</literal> in <literal>N4HeadlessCompiler</literal>.</simpara>
+</section>
+<section xml:id="sec:Generator_architecture">
+<title>Generator architecture</title>
+<simpara>The compiler has to create different compilation targets, e.g., for web applications running in a browser (Chrome), or for applications running on iOS using the JavaScriptCore framework <footnote><simpara><link xl:href="https://developer.apple.com/library/mac/documentation/Carbon/Reference/WebKit_JavaScriptCore_Ref/_index.html">https://developer.apple.com/library/mac/documentation/Carbon/Reference/WebKit_JavaScriptCore_Ref/_index.html</link></simpara></footnote>. Other scenarios may include code created for debugging purposes vs. optimized code, although this may be implementable via configuration switches as well.</simpara>
+<simpara><xref linkend="fig:cd_SubGenerators"/> shows the main generator classes, including two sub generators for EcmaScript code and EcmaScript on iOS.</simpara>
+<figure xml:id="fig:cd_SubGenerators" role="center">
+<title>Generator and sub-generators</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/13_compilation/images/cd_SubGenerators.svg"/>
+</imageobject>
+<textobject><phrase>cd SubGenerators</phrase></textobject>
+</mediaobject>
+</figure>
+</section>
+<section xml:id="sec:Unified_Compiler_Configuration">
+<title>Unified Compiler Configuration</title>
+<simpara>Since the compiler is to be used in both UI and headless (or CLI) mode, the configuration has to abstract from Eclipse <literal>IPreferenceStore</literal> concept or CLI utility classes. This is done with the combination of <literal>CompilerDescriptor</literal> and <literal>CompilerProperties</literal>, used by all <literal>ISubGenerator</literal> implementations (see <link linkend="fig:cd_SubGenerators">Fig. Sub Generators</link>).</simpara>
+<simpara>Each compiler provides</simpara>
+<itemizedlist>
+<listitem>
+<simpara>a unique name (that have to match with the name of the output configuration)</simpara>
+</listitem>
+<listitem>
+<simpara>a default compiler descriptor that contains the preference values to be applied when nothing else been configured in the provided preference values</simpara>
+</listitem>
+</itemizedlist>
+<simpara>A <literal>CompilerDescriptor</literal> has</simpara>
+<itemizedlist>
+<listitem>
+<simpara>an identifier (this is the unique name of the compiler as mentioned before)</simpara>
+</listitem>
+<listitem>
+<simpara>a name (a readable name to used in Eclipse preference page)</simpara>
+</listitem>
+<listitem>
+<simpara>a description (not used yet, but maybe later also shown in the preference page)</simpara>
+</listitem>
+<listitem>
+<simpara>a flag, that indicates, if this generator should run by default</simpara>
+</listitem>
+<listitem>
+<simpara>the file extension to be used for the compiled file</simpara>
+</listitem>
+<listitem>
+<simpara>the <literal>OutputConfiguration</literal> object from Xtext that contains output related preferences like the output folder</simpara>
+</listitem>
+</itemizedlist>
+<simpara>The <literal>CompilerProperties</literal> is an enumeration that makes it easier to iterate over the preferences and getting / setting the preference values in a generic way. So this enumeration contains all configurable properties as literals.</simpara>
+<simpara>The keys for preferences have to follow a fixed pattern as it also used internally by the builder participant when applying the configurations from the <literal>OutputConfiguration</literal>. So the key consists of</simpara>
+<itemizedlist>
+<listitem>
+<simpara>’outlet’</simpara>
+</listitem>
+<listitem>
+<simpara>unique name of the compiler = unique name of the output configuration</simpara>
+</listitem>
+<listitem>
+<simpara>the name of the property</simpara>
+</listitem>
+</itemizedlist>
+<simpara>Example: outlet.es5.compiledFileExtension</simpara>
+<simpara><literal>N4JSPreferenceAccess</literal> encapsulates the access to the injected <literal>IPreferenceValuesProvider</literal>. This values provider is bound in UI to <literal>EclipsePreferencesProvider</literal> that creates an overlay over the default configuration and makes it so possible to have workspace global as well as project specific preferences and always as fall back the default values.</simpara>
+<simpara>In headless mode the <literal>PropertiesFileBasedValuesProvider</literal> is bound as implementation of <literal>IPreferenceValuesProvider</literal>. With this implementation it is possible to load the preferences from a provided properties file.</simpara>
+<simpara><literal>N4JSPreferenceAccess</literal> is used in <literal>AbstractSubGenerator</literal> which provided the most common used preferences as extra methods.</simpara>
+</section>
+</section>
+<section xml:id="sec:Transpilers" role="language-n4js">
+<title>Transpilers</title>
+<simpara>Transpilers are a special case of generators, used for transforming N4JS source code into some target code in some other, high-level programming language. In this section we describe the general transpiler infrastructure without considering any particular transpiler. Currently, there is only a single such concrete transpiler for ECMAScript target code, explained later in <xref linkend="sec:N4JS_to_EcmaScript_Transpiler"/>.</simpara>
+<simpara>All code of the general transpiler infrastructure is found in bundle <literal>org.eclipse.n4js.transpiler</literal>.</simpara>
+<section xml:id="sec:Phases">
+<title>Overview</title>
+<simpara><xref linkend="fig:ad_PipelineOverview"/> shows an overview of the steps during transpilation of a single resource:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>an initial conversion from the original AST to an <emphasis role="strong">intermediate model (IM)</emphasis>, called <emphasis role="strong">preparation step</emphasis>.</simpara>
+</listitem>
+<listitem>
+<simpara>one or more <emphasis role="strong">transformation</emphasis> phases, each taking as input the IM and performing a number of in-place modification on it.</simpara>
+</listitem>
+<listitem>
+<simpara>a final <emphasis role="strong">pretty printing step</emphasis> that transform the final version of the IM into the textual output, i.e. the target code.</simpara>
+</listitem>
+</orderedlist>
+<figure xml:id="fig:ad_PipelineOverview" role="center">
+<title>Overview of the compilation pipeline</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/13_compilation/images/ad_PipelineOverview.svg"/>
+</imageobject>
+<textobject><phrase>ad PipelineOverview</phrase></textobject>
+</mediaobject>
+</figure>
+<simpara>The IM is the most important data structure in the transpiler. It starts out as a 1-to-1 copy of the original AST and is then gradually transformed by the AST transformation steps into, ultimately, a representation of the output code. Only the IM undergoes updates, while the original AST remains unchanged. Nodes in the IM that are identical on N4JS source code and target code side can simply be left unchanged. Traceability links allow navigating back to an original AST node from a given IM node, but due to the gradual modification of the IM this might not be possible for all IM nodes (the tracer will return <literal>null</literal> in those cases.</simpara>
+<simpara>Ideally, each transformation executed during the transformation step should be self-contained and coupling should be reduced to a minimum. Of course, this is not possible in all cases, in practice. Therefore, a simple mechanism is provided for statically specifying dependencies between transformations by way of Java annotations (see Java class <literal>TransformationDependency</literal> for more details). The ECMAScript transpiler, for example, has 18 individual transformations (at time of writing).</simpara>
+</section>
+<section xml:id="relation-between-ast-and-im">
+<title>Relation between AST and IM</title>
+<simpara>The relation between the original AST and the IM is maintained by the tracer, see class <literal>Tracer</literal>, which is available via the transpiler state. The tracer allows to obtain a  IM elements for a given original AST node and, conversely,  original AST nodes for a given IM element (i.e. a 1:N association between original AST node and IM element).</simpara>
+<simpara>The main purpose of this tracing information is to compute source maps for the target code.</simpara>
+<simpara>At the beginning of the transformation step, there is a 1-to-1 correspondence between AST and IM, but over the course of the transformations this correspondence will become more and more blurred. Therefore, whenever using the tracer to get to the original AST from a given IM element , we have to consider the case that there is not original AST node defined for  (because  was created programmatically by an earlier transformation) OR that the original AST node is of a different kind than  (because, maybe, an original N4JS class declaration was replaced by a function declaration by an earlier transformation).</simpara>
+<simpara>Whenever a transformation changes the IM, it is responsible to update the tracer, accordingly.</simpara>
+</section>
+<section xml:id="implementation-overview">
+<title>Implementation Overview</title>
+<simpara><link linkend="fig:transpilerClassDgr">Transpiler Class Diagram</link> shows a class diagram of the main constituents of the transpiler infrastructure.</simpara>
+<figure xml:id="fig:transpilerClassDgr" role="center">
+<title>Class diagram for the transpiler infrastructure.</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/13_compilation/images/TranspilerClassDgr.svg"/>
+</imageobject>
+<textobject><phrase>TranspilerClassDgr</phrase></textobject>
+</mediaobject>
+</figure>
+<simpara>The <literal>AbstractTranspiler</literal> controls the overall workflow shown earlier in . Concrete subclasses of <literal>Transformation</literal> perform the actual transformations (the preparation and pretty-printing steps are not shown in the above class diagram). Concrete transformations are created via injection within concrete sub classes of <literal>AbstractTranspiler</literal> (see class <literal>EcmaScriptTranspiler</literal> for an example). All information required during transpilation is kept in a simple data class called <literal>TranspilerState</literal>; a single instance of this class is created during the preparation step and is passed along until transpilation of the resource to transpile is completed.</simpara>
+<simpara>Class <literal>Transformation</literal> has a super class <literal>TranspilerComponent</literal> that has two important responsibilities:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>it contains many utility methods that are easily accessible from within concrete transformations through inheritance.</simpara>
+</listitem>
+<listitem>
+<simpara>it obtains the transpiler state via injection (using the scoping feature of Google Guice, for more details see <literal>org.eclipse.n4js.utils.di.scopes.ScopeManager</literal> and <literal>TransformationScoped</literal>). This injection is done in super class <literal>TranspilerComponent</literal>, so when implementing a new transformation, the programmer does not have to deal with these details and can simply obtain the transpiler state via the inherited method <literal>TranspilerComponent#getState()</literal>.</simpara>
+</listitem>
+</itemizedlist>
+<simpara>Code shared across concrete transformations should be placed in sub classes of <literal>TransformationAssistant</literal>. Those assistants are similar to the helpers used elsewhere, but by sharing the <literal>TranspilerComponent</literal> super class they get all the utility methods provided by that class and they automatically get the transpiler state.</simpara>
+<simpara>For more implementation details see the code and javadoc; a good starting point for investigating the overall workflow are classes <literal>AbstractTranspiler</literal> and <literal>Transformation</literal>.</simpara>
+</section>
+<section xml:id="sec:Guidelines_for_Implementing_Transformations">
+<title>Guidelines for Implementing Transformations</title>
+<simpara>Some hints:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>if you need to create an entirely new transformation:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>create new sub class of <literal>Transformation</literal> (use Xtend).</simpara>
+</listitem>
+<listitem>
+<simpara>in the main class of the transpiler you are working with (probably <literal>EcmaScriptTranspiler</literal>), change method
+<literal>#computeTransformationsToBeExecuted()</literal> to return an instance of your new transformation. The instance should be created using a Guice provider (see <literal>EcmaScriptTranspiler</literal> for an example). Note that this method also defines the order of transformations!</simpara>
+</listitem>
+<listitem>
+<simpara>implement the <literal>#transform()</literal> method of your newly created transformation.</simpara>
+</listitem>
+<listitem>
+<simpara>consider adding pre and post conditions via methods <literal>#assertPreConditions()</literal> and <literal>#assertPostConditions()</literal> (throw an AssertionError if failed).</simpara>
+</listitem>
+<listitem>
+<simpara>consider declaring dependencies to other transformations using the annotations defined in class <literal>TransformationDependency</literal>.</simpara>
+</listitem>
+</orderedlist>
+</listitem>
+<listitem>
+<simpara>code shared across transformations should be placed in a new or existing sub class of <literal>TransformationAssistant</literal> and then this assistant should be injected into the transformations that require this code’s functionality.</simpara>
+</listitem>
+<listitem>
+<simpara>inside a transformation or transformation assistant:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>to modify the IM, use the utility methods inherited from <literal>TranspilerComponent</literal> (e.g. <literal>#replace()</literal>, <literal>#insertBefore()</literal>); try to avoid direct manipulation of the IM as far as possible (but sometimes it’s necessary).</simpara>
+</listitem>
+<listitem>
+<simpara>to create new IM elements, use the convenience methods in <literal>TranspilerBuilderBlocks</literal>; use static import.</simpara>
+</listitem>
+<listitem>
+<simpara>to create a new symbol table entry or to obtain an existing symbol table entry for a given original target or element in the IM, use the inherited utility methods <literal>TranspilerComponent#getSymbolTableEntry*()</literal>.<?asciidoc-br?>
+<emphasis role="strong">Never search or modify the symbol table directly!</emphasis></simpara>
+</listitem>
+<listitem>
+<simpara>to access the transpiler state <footnote><simpara>but note that most utility methods obtain the transpiler state automatically; so, most of the time, you won’t need to obtain the state yourself.</simpara></footnote>, use inherited method <literal>TranspilerComponent#getState()</literal> (by convention, in Xtend you should just write <literal>state</literal> as if it were a field).</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+<listitem>
+<simpara>for local testing, activate additional consistency checks between transformations and assertion of pre/post conditions via these boolean flags:<?asciidoc-br?>
+<literal>AbstractTranspiler#DEBUG_PERFORM_VALIDATIONS</literal>,<?asciidoc-br?>
+<literal>AbstractTranspiler#DEBUG_PERFORM_ASSERTIONS</literal>.</simpara>
+</listitem>
+<listitem>
+<simpara>never add one of the following replaced EMF entities to the IM:<?asciidoc-br?>
+<literal>Script</literal>,<?asciidoc-br?>
+<literal>IdentifierRef</literal>,<?asciidoc-br?>
+<literal>ParameterizedTypeRef</literal>,<?asciidoc-br?>
+<literal>ParameterizedTypeRefStructural</literal>,<?asciidoc-br?>
+<literal>ParameterizedPropertyAccessExpression</literal>.<?asciidoc-br?>
+Instead, use the replacement entities from <literal>IM.xcore</literal> that have the <literal>_IM</literal> suffix (e.g. <literal>IdentifierRef_IM</literal>). If you always use <literal>TranspilerBuilderBlocks</literal> as described above, you won’t run into this issue.</simpara>
+</listitem>
+</itemizedlist>
+</section>
+<section xml:id="symbol-table-in-the-im">
+<title>Symbol Table in the IM</title>
+<simpara>During the preparation step, the IM is created as an exact copy of the original AST in most cases. However, to make sure the IM is self-contained and does not have any cross-references to the original AST or the original TModule and to simplify certain computations within the transformations, some AST entities are modified. For this purpose, there is a small EMF model called <literal>IM.xcore</literal>. It extends the AST model <literal>n4js.xcore</literal> and adds some elements.</simpara>
+<simpara>Most importantly, a symbol table is created and all references of the original AST pointing to an IdentifiableElement (either in the original AST or in the TModule) are rewired to a reference to an entry in the symbol table. Those entries are of type <literal>SymbolTableEntry</literal> and occur in three special forms (there is a dedicated sub class for each case). Detailed information is provided in the javadoc of <literal>SymbolTableEntry</literal> and its sub classes and is not repeated here to avoid duplication.</simpara>
+<simpara>The following entity replacements are done while creating the IM from the original AST and the entities without <literal>_IM</literal> must <emphasis role="strong">never</emphasis> appear in the IM:</simpara>
+<itemizedlist>
+<listitem>
+<simpara><literal>Script</literal>  <literal>Script_IM</literal></simpara>
+</listitem>
+<listitem>
+<simpara><literal>IdentifierRef</literal>  <literal>IdentifierRef_IM</literal></simpara>
+</listitem>
+<listitem>
+<simpara><literal>ParameterizedTypeRef</literal>  <literal>ParameterizedTypeRef_IM</literal></simpara>
+</listitem>
+<listitem>
+<simpara><literal>ParameterizedTypeRefStructural</literal>  <literal>ParameterizedTypeRefStructural_IM</literal></simpara>
+</listitem>
+<listitem>
+<simpara><literal>ParameterizedPropertyAccessExpression</literal>  <literal>ParameterizedPropertyAccessExpression_IM</literal></simpara>
+</listitem>
+</itemizedlist>
+<simpara>For example, when having in the original AST an <literal>IdentifierRef</literal> pointing to identifiable element , then the IM will contain an <literal>IdentifierRef_IM</literal> pointing to a <literal>SymbolTableEntryOriginal</literal> with a property <literal>originalTarget</literal> pointing to .</simpara>
+<simpara>Figures <link linkend="fig:rewire_var">Rewire Var</link>, <link linkend="fig:rewire_class">Rewire Class</link>, and <link linkend="fig:rewire_import">Rewire Import</link> show a comparison between an original AST with its original TModule and the self-contained intermediate model for a number of concrete examples.</simpara>
+<example>
+<title>Intermediate Models for References to Variables</title>
+<simpara>Original AST + TModule</simpara>
+<figure xml:id="fig:rewire_var" role="center">
+<title>Intermediate Model for References to Variables</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/13_compilation/images/Rewire_var_pre.png"/>
+</imageobject>
+<textobject><phrase>Rewire var pre</phrase></textobject>
+</mediaobject>
+</figure>
+<simpara>Intermediate model (IM)</simpara>
+<figure xml:id="fig:rewire_var-post" role="center">
+<title>Intermediate Model for References to Variables (post)</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/13_compilation/images/Rewire_var_post.png"/>
+</imageobject>
+<textobject><phrase>Rewire var post</phrase></textobject>
+</mediaobject>
+</figure>
+</example>
+<example>
+<title>Intermediate Model for References to Classes</title>
+<simpara>original AST + TModule</simpara>
+<figure xml:id="fig:rewire_class" role="center">
+<title>Intermediate Model for References to Classes</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/13_compilation/images/Rewire_class_pre.png"/>
+</imageobject>
+<textobject><phrase>Rewire class pre</phrase></textobject>
+</mediaobject>
+</figure>
+<simpara>Intermediate model (IM)</simpara>
+<figure xml:id="fig:rewire_class-post" role="center">
+<title>Intermediate Model for References to Classes (post)</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/13_compilation/images/Rewire_class_post.png"/>
+</imageobject>
+<textobject><phrase>Rewire class post</phrase></textobject>
+</mediaobject>
+</figure>
+</example>
+<example>
+<title>Intermediate Model for References to Imported Classes</title>
+<simpara>Original AST + TModule</simpara>
+<figure xml:id="fig:rewire_import" role="center">
+<title>Intermediate Model for References to Imported Classes</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/13_compilation/images/Rewire_import_pre.png"/>
+</imageobject>
+<textobject><phrase>Rewire import pre</phrase></textobject>
+</mediaobject>
+</figure>
+<simpara>Intermediate model (IM)</simpara>
+<figure xml:id="fig:rewire_import-post" role="center">
+<title>Intermediate Model for References to Imported Classes (post)</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/13_compilation/images/Rewire_import_post.png"/>
+</imageobject>
+<textobject><phrase>Rewire import post</phrase></textobject>
+</mediaobject>
+</figure>
+</example>
+</section>
+</section>
+<section xml:id="sec:N4JS_to_EcmaScript_Transpiler" role="language-n4js">
+<title>N4JS-to-EcmaScript Transpiler</title>
+<section xml:id="sec:Overview_of_Transformations">
+<title>Overview of Transformations</title>
+<simpara>The following overview will soon be outdated. Therefore:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>to find out which transformations are actually being executed and in what precise order, it is best to directly look into method:<?asciidoc-br?>
+<literal>EcmaScriptTranspiler#computeTransformationsToBeExecuted()</literal>.</simpara>
+</listitem>
+<listitem>
+<simpara>to learn about dependencies between transformations, check the annotations of the transformation class to see if one of the dependency annotations defined in <literal>TransformationDependency</literal> are given there (though probably not all dependencies will be specified in that form).</simpara>
+</listitem>
+</itemizedlist>
+<simpara>The following table lists all transformation by class name in the order they are executed by the <literal>EcmaScriptTranspiler</literal>.</simpara>
+<informaltable frame="all" rowsep="1" colsep="1">
+<tgroup cols="2">
+<colspec colname="col_1" colwidth="50*"/>
+<colspec colname="col_2" colwidth="50*"/>
+<tbody>
+<row>
+<entry align="left" valign="top"><simpara>StaticPolyfillTransformation</simpara></entry>
+<entry align="left" valign="top"></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara>MemberPatchingTransformation</simpara></entry>
+<entry align="left" valign="top"><simpara>see <link linkend="sec:Transpiling_members">Transpiling Members</link></simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara>ApiImplStubGenerationTransformation</simpara></entry>
+<entry align="left" valign="top"></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara>DestructuringTransformation</simpara></entry>
+<entry align="left" valign="top"><simpara>turn destructuring patterns into ES5 code</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara>SuperLiteralTransformation</simpara></entry>
+<entry align="left" valign="top"><simpara>super call + super access</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara>ExpressionTransformation</simpara></entry>
+<entry align="left" valign="top"><simpara>casts, <literal>instanceof</literal>, <literal>@Promisify</literal>, &#8230;&#8203;</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara>DependencyInjectionTransformation</simpara></entry>
+<entry align="left" valign="top"></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara>ClassDeclarationTransformation</simpara></entry>
+<entry align="left" valign="top"></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara>InterfaceDeclarationTransformation</simpara></entry>
+<entry align="left" valign="top"></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara>EnumDeclarationTransformation</simpara></entry>
+<entry align="left" valign="top"></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara>FunctionDeclarationTransformation</simpara></entry>
+<entry align="left" valign="top"><simpara>turn declared function into variable declaration + function expression</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara>ArrowFunction_Part1_Transformation</simpara></entry>
+<entry align="left" valign="top"></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara>BlockTransformation</simpara></entry>
+<entry align="left" valign="top"><simpara>local arguments variable, <literal>await</literal></simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara>FormalParameterTransformation</simpara></entry>
+<entry align="left" valign="top"><simpara>variadic arguments</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara>ArrowFunction_Part2_Transformation</simpara></entry>
+<entry align="left" valign="top"></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara>TrimTransformation</simpara></entry>
+<entry align="left" valign="top"><simpara>remove TypeRefs and TypeVariables</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara>SanitizeImportsTransformation</simpara></entry>
+<entry align="left" valign="top"><simpara>remove unused imports + add missing imports</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara>ModuleWrappingTransformation</simpara></entry>
+<entry align="left" valign="top"></entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+<simpara>The main complexity lies in the three transformations for N4JS type declarations (classes, interfaces, enums) and the related three transformations for member handling at the beginning (static polyfills, member patching, API/Impl stub generation) and the module wrapping. Up to the double horizontal line, the IM is still rather close to N4JS (e.g. still contains <literal>N4ClassDeclaration</literal>s with <literal>N4MemberDeclaration</literal>s), but after that it rapidly departs from the structure of the original AST (e.g. class declarations are broken up into a function declaration and a $<literal>makeClass</literal> call, field accessors and methods become function expressions in the properties of an object literal, fields are handled differently).</simpara>
+</section>
+<section xml:id="sec:Transpiling_members">
+<title>Transpiling members</title>
+<simpara>When processing the members of a container type, in the standard case, the transpiler simply has to generate target code for each owned member. For inherited members no output code has to be generated, because the ordinary semantics of the Javascript prototype chain is used in the generated code.</simpara>
+<simpara>There are, however, special cases when output code has to be generated for a non-owned or non-existant member of a container type:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>partial shadowing caused by lone field accessors, [sec:Transpiling_members__Partial_shadowing_of_getter_setter_pairs]<?asciidoc-br?>
+( <emphasis role="strong">delegation</emphasis>)</simpara>
+</listitem>
+<listitem>
+<simpara>consumption of members of an interface within an implementing class, [sec:Transpiling_members__Consuming_or_inheriting_members_of_an_interface]<?asciidoc-br?>
+( <emphasis role="strong">delegation</emphasis>, for data fields: <emphasis role="strong">copying</emphasis>)</simpara>
+</listitem>
+<listitem>
+<simpara>inheritance of members of an interface within an extending interface, [sec:Transpiling_members__Consuming_or_inheriting_members_of_an_interface]<?asciidoc-br?>
+( <emphasis role="strong">delegation</emphasis>, for data fields: <emphasis role="strong">copying</emphasis>)</simpara>
+</listitem>
+<listitem>
+<simpara>mixing in members into a container type via static polyfill, [sec:Transpiling_members__Static_polyfill]<?asciidoc-br?>
+( <emphasis role="strong">copying</emphasis>)</simpara>
+</listitem>
+<listitem>
+<simpara>adding an API / implementation stub, [sec:Transpiling_members__API_implementation_stubs]<?asciidoc-br?>
+( <emphasis role="strong">creation</emphasis>)</simpara>
+</listitem>
+</itemizedlist>
+<simpara>The above overview also states what technique is used in each special case of member handling: <emphasis role="strong">delegation</emphasis>, <emphasis role="strong">copying</emphasis> or <emphasis role="strong">creation</emphasis>. Delegation is the most tricky one and means that not a new function is generated in the output code for the special member, but the existing member function of an existing member is obtained from somewhere in the prototype chain and used directly as the member function of the special member. <emphasis role="strong">Copying</emphasis> means that an existing member is copied to another location where the special handling is required as if it were defined in that place. Lastly, <emphasis role="strong">creation</emphasis> means that an entirely new member is created for which no existing member serves as a template and this member gets a body with some <literal>default</literal> behavior. These three techniques of special member handling are explained in more detail in <xref linkend="sec:Transpiling_members__Delegating_members"/>.</simpara>
+<section xml:id="sec:Transpiling_members__Delegating_members">
+<title>Techniques for special member handling</title>
+<simpara>If output code has to be generated for a non-owned member  of a classifier  we distinguish the following two cases:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>either some other member  owned by classifier  serves as a template for ,</simpara>
+</listitem>
+<listitem>
+<simpara>or no such template exists.</simpara>
+</listitem>
+</orderedlist>
+<simpara>In the first case, we can either <emphasis role="strong">copy</emphasis>  in the sense that we will generate output code for  within the output code for  as if  had been defined in . Or we can use <emphasis role="strong">delegation</emphasis>, i.e. generate output code for  that reuses the existing member function of  in . In case no template exists, we always have to <emphasis role="strong">create</emphasis>  from scratch, i.e. generate output code as if  had been defined with some behavior pre-defined by the N4JS language (this applies only to API / implementation stubs where this pre-defined behaviour is to throw an <literal>unimplemented member</literal> error).</simpara>
+<simpara>Creation and copying is straightforward; for more details on member delegation see class <literal>DelegationAssistant</literal> and entity <literal>DelegatingMember</literal> in <literal>IM.xcore</literal>. The basic approach is to allow one transformation to create a <literal>DelegatingMember</literal> and insert it into the IM and let the transformations for class and interface declarations turn this member into low-level Javascript constructs that perform the actual delegation.</simpara>
+</section>
+<section xml:id="sec:Transpiling_members__Partial_shadowing_of_getter_setter_pairs">
+<title>Partial shadowing</title>
+<simpara>In Javascript, if an object  has a setter of name , then a read access <literal>obj.prop</literal> will return undefined, even if the prototype of  has a getter or field of name . Conversely, if  has a getter , then a write access <literal>obj.prop = 42</literal> will produce a runtime error, even if the prototype of  has a setter or field .</simpara>
+<screen>var proto = {
+  get prop1() { return "this won't show up" },
+  set prop2(value) { console.log("this won't be reached") }
+}
+var obj = {
+  set prop1(value) {},
+  get prop2() {}
+}
+obj.__proto__ = proto;
+
+console.log(typeof obj.prop1);  // will print "undefined"
+obj.prop2 = 42;  // error: "setting a property that has only a getter"</screen>
+<simpara>Note, in plain N4JS a validation enforces a redefinition of accessors or overriding of a field always by getter/setter pairs. However, in special situations of incomplete API implementations stubs for missing accessors are created in order to provide meaningful test-reporting. This leads to situations where on the implementation side a single getter or or a single setter is defined in a subclass - unaware of possibly injected stubs in superclasses. The aforementioned validation can not enforce the user to author an accessor pair. To keep a meaningful test-response the transpiler treats this situation as follows:</simpara>
+</section>
+<section xml:id="sec:Transpiling_members__Consuming_or_inheriting_members_of_an_interface">
+<title>Consuming or inheriting members of an interface</title>
+<simpara>When an N4JS class  consumes the member of an interface implemented by , then this cannot be handled by the native prototype chain mechanism of Javascript. Instead, the transpiler has to generate a member of corresponding type that delegates to the consumed member. In case of data fields, such a delegation is not possible and thus the transpiler generates output code for the consumed data field as if the field had been defined in .</simpara>
+<simpara>Of particular importance in this context is the diamond problem when consuming members from an interface. For example, if interface  defined method  with a default implementation, interface  extends  and overrides  with a different implementation, class  implements  and class  extending  implements , then  will not consume  because it has already inherited  from its super class  (which in turn has consumed it from ). So, in  the default implementation of  given in  will be active, not that given in .</simpara>
+</section>
+<section xml:id="sec:Transpiling_members__Static_polyfill">
+<title>Static polyfill</title>
+<simpara>See class <literal>StaticPolyfillTransformation</literal> for details.</simpara>
+</section>
+<section xml:id="sec:Transpiling_members__API_implementation_stubs">
+<title>API / implementation stubs</title>
+<simpara>See <link linkend="sec:Support_for_incomplete_API_implementation_testing_in_the_N4JS_to_EcmaScript_5_Transpiler">Support for incomplete API implementation testing</link>.</simpara>
+</section>
+</section>
+<section xml:id="sec:Support_for_incomplete_API_implementation_testing_in_the_N4JS_to_EcmaScript_5_Transpiler">
+<title>Support for incomplete API implementation testing</title>
+<simpara>As part of the introduction of API projects with executable test cases the need to verify the state of implementations came into focus. No formal dependency is allowed between an API project and its dedicated implementation projects, hence an inconsistency can not directly be detected. However at runtime (c.f. <link linkend="_execution">Execution</link>) the API is always replaced by an appropriate implementation.</simpara>
+<simpara>In cases where such an implementation is incomplete this would result in failures due to missing concepts, e.g. calls to methods that are not in place or usage of fields which are not defined. In order to support the author of an implementation the IDE provides a mean to compare the current state of implementation to the developer in a tabular way (c.f. [<link linkend="N4JSSpec">N4JSSpec</link>]).</simpara>
+<simpara>The key idea for automated test-support is to incorporate those comparison-results into the transpiled output in way, that a test-framework can easily distinguish wrong implementations from incomplete implementations. Of course this is not always possible, but the majority of cases can be handled.</simpara>
+<simpara>As there is only one transpilation mode the resulting modifications are always part of the generated code.</simpara>
+<simpara>In order to distinguish the different project-types we distinguish between different project types:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>an API-project (API)</simpara>
+</listitem>
+<listitem>
+<simpara>an API-implementation project (Impl)</simpara>
+</listitem>
+<listitem>
+<simpara>a client project (Client)</simpara>
+</listitem>
+<listitem>
+<simpara>a test project (Test)</simpara>
+</listitem>
+</itemizedlist>
+<simpara>The API-project defines the requirements to it’s implementors in form of definition-files (n4jsd). The API is defined together with an test-project which validates the implementation. Client code is written with a formal dependency to the API and uses the elements declared therein. In that sense an API-testing project is just a normal client project with a test-nature.</simpara>
+<simpara>Additional code to support API implementation testing is only inserted into the Impl-projects. API, Client and Test are not affected.</simpara>
+<simpara>One major goal in transpiling Impl projects is to provide the ability to load all modules used in Client/Test projects in non-disruptive way. Even if the implementation is missing elements the runtime should still be able to successfully load the module. Errors should only be signalled when the client code actually uses the missing concepts.</simpara>
+<section xml:id="sec:Modifications_in_Impl_projects">
+<title>Modifications in Impl projects</title>
+<simpara>The generator is module driven. In case of missing modules nothing will be done but the runtime will detect this and act accordingly.</simpara>
+<simpara>In general only missing elements will be inserted:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>Missing class - a stub will be generated</simpara>
+</listitem>
+<listitem>
+<simpara>Missing function - a stub will be generated</simpara>
+</listitem>
+<listitem>
+<simpara>Missing enumeration - a stub will be generated</simpara>
+</listitem>
+<listitem>
+<simpara>Missing interface - a stub will be generated</simpara>
+</listitem>
+</itemizedlist>
+<simpara>Missing members of classes are inserted as stubs. Missing fields will be replaced by getter/setter-pairs throwing an error upon read and write access.</simpara>
+<simpara>A more sophisticated approach needs to be taken for interfaces with default implementations (marked with @ProvidesDefaultImplementation or @ProvidesInitializer).</simpara>
+<simpara>Currently missing field initialisers in interfaces are not detected for two reasons: Field-initialising is carried out on loading. Throwing an error in the initialiser will prevent the module from being loaded. Installing a getter/setter pair on the Impl-interface is not an option since the inheritance chain used in client project has no knowledge about this and therefore these accessors cannot be reached from client code.</simpara>
+<simpara>Missing default implementations will be inserted as stubs. For normal class compilation the inheritance chain needs to be scanned. In case of an missing default implementation in an implemented interface a forwarding call to the stub needs to be inserted on the class.</simpara>
+</section>
+<section xml:id="sec:Implementation_of_stub_generation">
+<title>Implementation of stub-generation</title>
+<simpara>The implementation is mainly organised in <literal>ApiImplStubGenerationTransformation</literal>, which makes use of <literal>MissingApiMembersForTranspiler</literal> and <literal>ScriptApiTracker</literal>.</simpara>
+<simpara>When a Module is transpiled the type of the project is checked. Only if the project is an implementation project the comparison between the current module and it’s API module is computed and attached as an Adapter to the <literal>Script</literal> during the life-cycle of the <literal>ScriptTranspilerPolicy</literal>. The <literal>ProjectComparisonAdapter</literal> serves as a shared information pool among the different transpiler-policies and caches different compare-results. After transpilation of the script the adapter will be removed.</simpara>
+<simpara>In order to reuse all existing code as far as possible, missing elements are modelled as subclasses of the requested element but with no AST-information. These subclasses are member-classes of the <literal>ScriptApiTracker</literal> class. All class-names are prefixed with <literal>VirtualApi</literal> and hold a reference to the type-information computed by the module-comparison.</simpara>
+<simpara>It is important to not access the AST-elements of type-information obtained from the project-comparison, since this would trigger the AST-loading and invalidate (proxifying) existing <literal>EObjects</literal>.</simpara>
+</section>
+</section>
+</section>
+<section xml:id="sec:n4jsc_Headless_Compiler_Interface" role="language-n4js">
+<title>n4jsc Headless Compiler Interface</title>
+<simpara>The headless compiler interface consists of a runnable class capable of reading command line options packaged together with all required dependencies into one executable <literal>.jar</literal> archive.</simpara>
+<simpara>The sources of the command line interface are located in in the <literal>tools/</literal> subfolder of the main git repository. They comprise of the package <literal>org.eclipse.n4js.hlc</literal> and corresponding test package <literal>org.eclipse.n4js.hlc.tests</literal>. (c.f. <link linkend="sec:tools">Tools</link>).</simpara>
+<simpara>A description of how to use the headless compiler can be found in the N4IDE document.</simpara>
+<section xml:id="sec:building_the_headless_compiler">
+<title>building the headless compiler</title>
+<simpara>The maven-modules related to the headless compiler build are organised in the <literal>tools</literal> folder in the project-root. In order to build the headless compiler as part of the common build-chain, the maven-profile <literal>buildTools</literal> needs to be activated (off by default), e.g. <literal>mvn -PbuildTools</literal> .</simpara>
+<simpara>To build the headless compiler separately, the project-pom can be set to <literal>tools/pom.xml</literal>, however then the tycho-generated artefacts must be accessible by this build. This can be achieved in three different ways:</simpara>
+<orderedlist numeration="loweralpha">
+<listitem>
+<simpara>the build takes place on a workspace formerly building the n4js-project without cleaning it (interesting for local experiments),</simpara>
+</listitem>
+<listitem>
+<simpara>a former n4js-build installed the artefacts into the currently configured local-.m2-repository of maven or</simpara>
+</listitem>
+<listitem>
+<simpara>a former n4js-build deployed the artefacts to the configured nexus-server.</simpara>
+</listitem>
+</orderedlist>
+<simpara>Note however, on our build-server option a) is not feasible, option b) requires you to setup a build-chain and ensuring the same build-node to be building on
+and c) is difficult up to nearly impossible without a proper versioning-scheme.</simpara>
+<simpara>Parameters for the headless-compiler-build are defined in the parent-pom located at <literal>releng/org.eclipse.n4js.parent/pom.xml</literal> with properties prefixed by <literal>hlc.</literal>.</simpara>
+</section>
+</section>
+</chapter>
+<chapter xml:id="_execution">
+<title>Execution</title>
+<warning>
+<simpara>This chapter may be outdated.</simpara>
+</warning>
+<simpara>There are many different use cases for executing N4JS code:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>running project locally</simpara>
+</listitem>
+<listitem>
+<simpara>running tests in CI</simpara>
+</listitem>
+<listitem>
+<simpara>running application in the client</simpara>
+</listitem>
+<listitem>
+<simpara>running processor on the server</simpara>
+</listitem>
+</itemizedlist>
+<simpara>All those use cases may differ in their details, but can be divided into general phases:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>execution environment preparation</simpara>
+</listitem>
+<listitem>
+<simpara>bootstrapping</simpara>
+</listitem>
+<listitem>
+<simpara>call to given n4js entry point</simpara>
+</listitem>
+<listitem>
+<simpara>shutdown (optional)</simpara>
+</listitem>
+</orderedlist>
+<simpara>When N4JS execution is triggered, proper <emphasis>Runner</emphasis> (see <link linkend="sec:Runners-introduction">Runners</link>) is selected. In some cases it is done automatically, in others user needs to make a choice. Runner is responsible for perform all required preparations, according to <link linkend="sec:N4JS_Project_Execution_And_Linking_Model">N4JS Project Execution And Linking Model</link>. Then JS execution environment (e.g. NodeJS, IOJS, Chrome, JavaScriptCore) performs bootstrapping according to <xref linkend="sec:N4JS_Execution_And_Linking_File"/>. As last step of bootstrap phase defend n4js entry point will be called which starts proper n4js execution phase. In some cases there may be shutdown phase, but that is highly dependent on use case and proceeding execution phases.</simpara>
+<section xml:id="sec:N4JS_Project_Execution_And_Linking_Model" role="language-n4js">
+<title>N4JS Project Execution And Linking Model</title>
+<simpara>N4JS project is compiled to JavaScript language, that in turn can be executed in some JS execution environment, Those environments (e.g. NodeJS, IOJS, Chrome, JavaScriptCore) will differ between each other in terms of JS APIs they expose and way JS code has to be provided to them, or the way it is triggered. We introduced systematic way of describing those features in terms of N4JS projects (see Components and Projects <link linkend="sec:N4_Components_and_IDE_Support">Components and IDE Support</link>). N4JS project will be of different <emphasis>PojectType</emphasis> that determines project purpose (see Package.json section <xref linkend="sec:Package_json"/>. When we want to execute some N4JS project, we can divide its dependency graph into 4 general areas</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>User Space, e.g. user code</simpara>
+</listitem>
+<listitem>
+<simpara>System Space, e.g N4 Platform APIs</simpara>
+</listitem>
+<listitem>
+<simpara>Runtime Space, e.g. EcmaScript APIs</simpara>
+</listitem>
+<listitem>
+<simpara>Environment Space, e.g. execution environment APIs</simpara>
+</listitem>
+</orderedlist>
+<simpara>Example of that kind of graph can bee seen on <xref linkend="fig:od_sampleProjectDependencyGraph"/></simpara>
+<figure xml:id="fig:od_sampleProjectDependencyGraph" role="center">
+<title>Sample Project Dependency Graph</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/14_execution/images/od_sampleProjectDependencyGraph.svg"/>
+</imageobject>
+<textobject><phrase>od sampleProjectDependencyGraph</phrase></textobject>
+</mediaobject>
+</figure>
+<simpara>All dependencies are compile time dependency (as they are checked by the compiler), but <emphasis>tend</emphasis> to weaken, the lower in the dependency graph we are. <emphasis>User Space</emphasis> objects will have strong load time and run time dependency to each other and to the <emphasis>System Space</emphasis>. <emphasis>System Space</emphasis> have strong load time and run time dependency to each other and, only runtime dependency to <emphasis>Runtime Space</emphasis>. <emphasis>Runtime Space</emphasis> objects should not have any load time dependencies between each other. In some cases they may have weak runtime dependency to each other. In many cases those components are just api definitions that describe execution environment native apis, but may contain polyfills code. <emphasis>Environment Space</emphasis> has no dependency to other components, except the fact different <emphasis>RuntimeEnvironemnt</emphasis>s can extend each other (see <xref linkend="sec:N4_Components_and_IDE_Support"/>).</simpara>
+<simpara>Runner must configure JS execution environment in the way that all above areas of the dependency graph must be either</simpara>
+<itemizedlist>
+<listitem>
+<simpara>provided by execution environment itself (runtime libraries APIs - <emphasis>n4jsd</emphasis> files)</simpara>
+</listitem>
+<listitem>
+<simpara>loaded by defined runtime environment (self initialisation code)</simpara>
+</listitem>
+<listitem>
+<simpara>available to load by environment explicitly (runtime libraries polyfills, system libraries)</simpara>
+</listitem>
+<listitem>
+<simpara>available to load by other implicitly (system libraries, user libraries and projects)</simpara>
+</listitem>
+</itemizedlist>
+<simpara>Testers, the same way as runners, must be able to execute n4js code. Main difference is that dependency graph for test case will be usually slightly bigger (dependencies to test libraries), and code that has to be triggered shifts a bit from given project to test library used in test code of tested project. Extending previously used example with test elements is shown in figure <xref linkend="fig:od_sampleTestProjectDependencyGraph2"/>.</simpara>
+<figure xml:id="fig:od_sampleTestProjectDependencyGraph2" role="center">
+<title>Sample Test Project Dependency Graph</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/14_execution/images/od_sampleTestProjectDependencyGraph.svg"/>
+</imageobject>
+<textobject><phrase>od sampleTestProjectDependencyGraph</phrase></textobject>
+</mediaobject>
+</figure>
+<figure xml:id="fig:runners-testers" role="center">
+<title>Runners and Testers</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/14_execution/images/runners-testers.svg"/>
+</imageobject>
+<textobject><phrase>runners testers</phrase></textobject>
+</mediaobject>
+</figure>
+<section xml:id="subsec:N4JS_Execution_With_NodeJS" role="language-n4js">
+<title>N4JS Execution With NodeJS</title>
+<simpara>This example shows in-depth details of N4JS code execution with NodeJS runner.</simpara>
+<simpara>In the workspace we have <literal>Client</literal> with <literal>foo.n4js</literal> that imports <literal>bar.n4js</literal> from <literal>UserLib</literal> that is also in the workspace.
+Those N4JS files use some ES5 APIs , e.g. <literal>Math.random()</literal> and <literal>setTimeout()</literal>. Those APIs are <literal>Global</literal> so there is
+no impicit import, still they make user projects depend on runtime library <literal>n4js-runtime-es2015</literal>.
+Assuming user selects <literal>foo.n4js</literal> file for execution, the NodeRunner in the IDE will:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>create working directory in temp folder, e.g. <literal>/var/temp/N4JSNodeRun123/</literal></simpara>
+</listitem>
+<listitem>
+<simpara>create <literal>node_modules</literal> folder inside working directory, to which projects will be linked</simpara>
+</listitem>
+<listitem>
+<simpara>generate script, e.g. <literal>n4jsELF.js</literal> that will be responsible for booting execution (see <xref linkend="sec:N4JS_Execution_And_Linking_File"/>)</simpara>
+</listitem>
+<listitem>
+<simpara>runner will put <literal>/var/temp/N4JSNodeRun123/node_modules</literal> into <literal>NODE_PATH</literal></simpara>
+</listitem>
+<listitem>
+<simpara>execute <literal>/var/temp/N4JSNodeRun123/n4jsELF.js</literal> with NodeJS</simpara>
+</listitem>
+</itemizedlist>
+<simpara>For example with NodeJS environment if all projects from dependency graph are accessible in local file system, their
+paths would need to be put in NodeJS <emphasis>NODE_PATH</emphasis> environment variable. In addition to configuring execution environment
+<emphasis>Runner</emphasis> generates N4JS Elf file that is used by environment to bootstrap n4js execution
+(see <xref linkend="sec:N4JS_Execution_And_Linking_File"/>).
+[[fig:od_sampleNodeProjectExecution]</simpara>
+<figure role="center">
+<title>Sample NodeJS Project Execution</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/14_execution/images/od_sampleNodeProjectExecution.svg"/>
+</imageobject>
+<textobject><phrase>od sampleNodeProjectExecution</phrase></textobject>
+</mediaobject>
+</figure>
+</section>
+</section>
+<section xml:id="sec:N4JS_Execution_And_Linking_File" role="language-n4js">
+<title>N4JS Execution And Linking File</title>
+<simpara>JS execution environment not only needs to know from where it needs to obtain code to execute, but also <emphasis>what is the entry point to the code that is supposed to be executed</emphasis> and <emphasis>what code needs to be loaded before entry point is called</emphasis>.</simpara>
+<simpara>All this information is generated by the runner based on the executed project dependency graph. The way this information
+is presented depends on concrete JS execution environment used, and on its configuration (e.g. user provided options, or
+configuration derived in other ways). But in either case file is generated with that information. Figure <xref linkend="fig:n4js_elf"/>
+shows examples how this information would look like for both testers and runners for both NodeJS or Chrome.</simpara>
+<figure xml:id="fig:n4js_elf" role="center">
+<title>N4JS ELF examples</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/14_execution/images/n4js_elf.svg"/>
+</imageobject>
+<textobject><phrase>n4js elf</phrase></textobject>
+</mediaobject>
+</figure>
+<simpara>First segment of the n4js elf is responsible for loading <emphasis>RuntimeEnvironment</emphasis> bootstrap code. Since <emphasis>RuntimeEnvironment</emphasis>s can extend each other, generated information would follow those dependencies. It is possible that <emphasis>RuntimeEnvironment</emphasis>s need to do some special work in regards of of provided <emphasis>RuntimeLibraries</emphasis>s, e.g. initiate initiate polyfills. That code can be either directly in <emphasis>RuntimeEnvironment</emphasis> init code, or its init code can call modules from provided runtime libraries.</simpara>
+<simpara>Second segment of the n4js elf is responsible for loading <emphasis>RuntimeEnvironment</emphasis> exec module. This is special module defined in package.json of the environment, that is used to call into user projects entry point directly, or (as in test case) call into runners of the test library.</simpara>
+<simpara>Last segment of the n4js elf is responsible for passing run/test data (generated by IDE/CLI) into initialised previously exec module.</simpara>
+<simpara>While first two segments are resolved from project dependencies and can be covered by generic approach on IDE/CLI side, last segment requires strong relation between given runner/tester and <emphasis>RuntimeEnvironment</emphasis> / <emphasis>TestEnvironment</emphasis>. While some generic approaches can be used, for the moment we don’t specify concrete convention there.</simpara>
+<section xml:id="subsec:NodeJS_Specific_ELF" role="language-n4js">
+<title>NodeJS Specific ELF</title>
+<simpara>Concrete environments may need specific setup that is not common for other environemtns. For example for NodeJS runner
+needs to configure the node lookup paths for the module resolution. This is achieved by creating at runtime symlinks
+from <literal>node_modules</literal> pointing to concrete dependencies required during execution.</simpara>
+</section>
+</section>
+<section xml:id="sec:Runners-execution" role="language-n4js">
+<title>Runners</title>
+<simpara>It is specified above, that <emphasis>Runner</emphasis> prepares concrete JS execution environment for executing given code and triggers execution process. What is not clear so far is how appropriate runner is selected for given project. In <link linkend="_n4components">N4 Components</link> it was specified that N4JS projects do not depend directly on specific runners or JS execution environments. Instead, N4JS tooling should be able to select appropriate runner based on given project transitive dependencies. In this section we specify overall design of runners for both N4JS IDE and CLI tooling and how runners are selected for projects.</simpara>
+<simpara>INFO: In general any n4js code execution is governed by <emphasis>runners</emphasis> and <emphasis>testers</emphasis> depending on the use case.
+In this chapter <emphasis>runners</emphasis> are described in detail.
+Information from this chapter applies to <emphasis>Testers</emphasis>, unless stated otherwise in chapter dedicated to testing N4JS code (<link linkend="_tests">Tests</link>), were we specify
+testing specific use cases.</simpara>
+<section xml:id="subsec:N4_Runtime_Environments_Convention">
+<title>N4 Runtime Environments Convention</title>
+<simpara>Dependency between <emphasis>Runner</emphasis> and <emphasis>Runtime Environment</emphasis> crosses technical boundary between N4JS Projects (N4JS code) and N4JS tooling (IDE and CLI tools implemented with e.g. Java). We introduce convention to implement this dependency, yet letting N4JS projects and N4JS tools internals to be relatively independent.</simpara>
+<figure xml:id="fig:cd_EnvironmentConvention" role="center">
+<title>Runtime Environments Convention</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/14_execution/images/cd_EnvironmentConvention.svg"/>
+</imageobject>
+<textobject><phrase>cd EnvironmentConvention</phrase></textobject>
+</mediaobject>
+</figure>
+<simpara><xref linkend="fig:cd_EnvironmentConvention"/> convention that is used to communicate run time configuration of the N4JS projects (grey colour) and N4JSIDE (pink colour). JS projects declare dependencies on provided list of <emphasis>Runtime Libraries</emphasis>. Each combination of those corresponds to one predefined <emphasis>Runtime Environment</emphasis> N4JS component. On N4JSIDE side there is separate list of <emphasis>runtime environment</emphasis>s maintained. Both lists correspond one to one to each other.</simpara>
+</section>
+<section xml:id="subsec:Passing_Information_from_IDE_to_Execution_Code_in_Runtime_Environment" role="language-n4js">
+<title>Passing Information from IDE to Execution Code in Runtime Environment</title>
+<simpara>When launching an N4JS file, the IDE will compute some information on the containing N4JS project and its direct and indirect dependencies as well as the runtime environment in use. This information will be passed on to the execution module defined in the runtime environment, i.e. the code specified via property in the runtime environment’s package.json file. The information will be passed via a global variable <literal>$executionData</literal>. The value will be a Javascript object with the following properties:</simpara>
+<itemizedlist>
+<listitem>
+<simpara><literal>userSelection</literal>: the module the user had selected when initiating the launch. This will usually be the <literal>module to run</literal>  , but in case of testing it will be the project, folder, or file the user had selected.</simpara>
+</listitem>
+<listitem>
+<simpara><literal>projectNameMapping</literal>: an object in which every key is the name of an API project among the direct or indirect dependencies of the project being run, and every value is the name of the corresponding implementation project being used. When running N4JS projects that do not make use of the API / implementation project technique, then this property will either hold an empty object or be undefined.</simpara>
+</listitem>
+<listitem>
+<simpara><literal>testTree</literal> (only when running tests): the test tree as defined in <link linkend="_tests">Tests</link> containing information on the tests to be run, i.e. test classes, test methods, etc. The test tree will be encoded as JSON, so the value of this property will be of type string and should be passed to <literal>JSON.parse()</literal>.</simpara>
+</listitem>
+</itemizedlist>
+<simpara>All calculations described above are based on the workspace available. This includes library manager functionality, see <link xl:href="../20_externalLibraries/externalLibraries.xml#:External_Library_Workspace">External Library Workspace</link>.
+In specific setups, where workspace is not available runners provide helper utility <literal>org.eclipse.n4js.runner.RunnerFileBasedShippedCodeConfigurationHelper.configureFromFileSystem()</literal> that allows to configure given <literal>RunConfiguration</literal> using
+plain file system to the external libraries. Note that in order to do this in a way that allows to re-use all computation logic based on <link xl:href="../12_n4components/n4components.xml#:N4MFContainerManagement">N4Containers</link>,
+runners infrastructure provides its own subclasses of the few component types. Those specialized types are used only in scope of <literal>RunnerFileBasedShippedCodeConfigurationHelper</literal> and are not exposed to the rest of the system.</simpara>
+<simpara>Specific runners, e.g. the NodeJS or Chrome runner, may choose to provide more information via the execution data object.</simpara>
+</section>
+<section xml:id="subsec:Runners_Design">
+<title>Runners Design</title>
+<simpara>As specified in section before N4JS projects will need to be executed on various JS execution environments, for which dedicated runners will be needed. While they will differ how they interact with concrete JS environment, they will have common parts when it comes to interaction with N4JS IDE or CLI. Those parts are provided in form of abstract <emphasis>IDERunner</emphasis> <emphasis>CLIRunner</emphasis> and <emphasis>Runner</emphasis> <emphasis>components</emphasis> (or bundles) that specific runners should use to interact with N4JS IDE or CLI.</simpara>
+<simpara>Runner by design consists of three parts:</simpara>
+<itemizedlist>
+<listitem>
+<simpara><emphasis>core</emphasis> part (green colour) - contains most logic, resources (e.g. JS execution environment binary)</simpara>
+</listitem>
+<listitem>
+<simpara><emphasis>IDE</emphasis> part (blue colour) - responsible for working with N4JS IDE (enabling runner in ui, providing views)</simpara>
+</listitem>
+<listitem>
+<simpara><emphasis>CLI</emphasis> part (yellow colour) - responsible for working with N4JS CLI (get command line parameters, provide console output)</simpara>
+</listitem>
+</itemizedlist>
+<figure xml:id="cd_RunnersIdeCli" role="center">
+<title>Runner for N4JS IDE and CLI tooling</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/14_execution/images/cd_RunnersIdeCli.svg"/>
+</imageobject>
+<textobject><phrase>cd RunnersIdeCli</phrase></textobject>
+</mediaobject>
+</figure>
+<simpara>Specific runner is connected to running N4JS IDE or CLI via extension points. This is done either by using them directly, or by using types exposed by abstract runner component.</simpara>
+</section>
+</section>
+<section xml:id="sec:Legacy_Execution_Engine" role="language-n4js">
+<title>Legacy Execution Engine</title>
+<simpara>Compilation of N4JS may target many platforms. For the moment it is hard to discuss what they will be exactly or if N4JSIDE will provide some integration or hooks to those platforms. On the other hand we want to have some execution environment for internal use to validate behaviour of compiled code. Since we know that V8 based platforms (e.g. Chrome, NodeJS) will be in our target platforms set we want to be able to execute compiled code on similar environment. As standalone V8 integration is quite challenging, we have decided to integrate in N4JSIDE NodeJS as execution environment. This is considered internal feature used for testing compilation of N4JS and N4JSIDE.</simpara>
+</section>
+<section xml:id="sec:Design" role="language-n4js">
+<title>Design</title>
+<simpara>We provide NodeJS binaries for various OSes. Direct access to binaries is not exposed. Selection and institutionalization of the binary is done internally and is not configurable. Instead bundle containing binaries provides classes required to run code (in form of <literal>String</literal> or <literal>File</literal> with the code). Clients That want to do this may either use provided <literal>Engine</literal> class or can implement their own engine based on provided infrastructure. Main class that used in engine implementation is <literal>EngineCommandBuilder</literal>. This class is responsible for building proper command line commands that engine implementation must execute to run code with NodeJS.</simpara>
+<simpara><xref linkend="fig:cd_executionengine"/> shows the most important classes of the NodeJS integration.</simpara>
+<figure xml:id="fig:cd_executionengine" role="center">
+<title>NodeJS execution integration</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/14_execution/images/cd_executionengine.svg"/>
+</imageobject>
+<textobject><phrase>cd executionengine</phrase></textobject>
+</mediaobject>
+</figure>
+<section xml:id="sec:Usage_Outside_N4JSIDE">
+<title>Usage Outside N4JSIDE</title>
+<simpara>In this use case we use provdied <literal>Engine</literal> class that allows to execute js code in form of <literal>String</literal> or <literal>File</literal> with the code. In return user receives <literal>EngineOutput</literal> object with two lists of strings containing standard output and error output of the node process, that were captured during execution.</simpara>
+<simpara>In this usage scenario execution api assumes valid JS code. User needs to ensure compilation of code prior to execution, if needed.</simpara>
+<simpara>That functionality is used in internal jUnit tests and in xpect tests of the compiler.</simpara>
+<section xml:id="sec:Use_Node_with_Maven">
+<title>Use Node with Maven</title>
+<simpara>Note on maven usage. For maven based builds we need to ensure that binary resources are available and are unpacked. To do this in pom of the project that will be calling engine we must include following listing:</simpara>
+<programlisting language="xml" linenumbering="unnumbered">            &lt;plugin&gt;
+                &lt;groupId&gt;org.apache.maven.plugins&lt;/groupId&gt;
+                &lt;artifactId&gt;maven-dependency-plugin&lt;/artifactId&gt;
+                &lt;executions&gt;
+                    &lt;execution&gt;
+                        &lt;id&gt;unpack&lt;/id&gt;
+                        &lt;phase&gt;process-test-classes&lt;/phase&gt;
+                        &lt;goals&gt;
+                            &lt;goal&gt;unpack&lt;/goal&gt;
+                        &lt;/goals&gt;
+                        &lt;configuration&gt;
+                            &lt;artifactItems&gt;
+                                &lt;artifactItem&gt;
+                                    &lt;groupId&gt;org.eclipse.n4js&lt;/groupId&gt;
+                                    &lt;artifactId&gt;org.eclipse.n4js.js.engine&lt;/artifactId&gt;
+                                    &lt;version&gt;0.0.1-SNAPSHOT&lt;/version&gt;
+                                    &lt;overWrite&gt;true&lt;/overWrite&gt;
+                                    &lt;outputDirectory&gt;
+                                        ${project.build.directory}/classes
+                                    &lt;/outputDirectory&gt;
+                                &lt;/artifactItem&gt;
+                            &lt;/artifactItems&gt;
+                        &lt;/configuration&gt;
+                    &lt;/execution&gt;
+                &lt;/executions&gt;
+            &lt;/plugin&gt;</programlisting>
+</section>
+</section>
+<section xml:id="sec:Usage_Inside_N4JSIDE">
+<title>Usage Inside N4JSIDE</title>
+<simpara>In Eclipse platfrom based environment we use custom implementation of the engine, <literal>PlatformEngine</literal>. This implementation unlike default <literal>Platform</literal> is non blocking implementation that forwards output to platform console and allows platform to control lifecycle of the running engine. Additionally this version uses its own implementation of the <literal>ResourceUrlResolver</literal>. It is required to properly resolve urls that point inside platform bundles.</simpara>
+<simpara>This scenario we assume that user will run N4JS files or JS files. We have created proper UI hooks that allow user to do this either from editor or as selection menu. Based on name of the file that user commands to execute we find proper compiled file (compiled with our ES5 compiler - it is not configurable). When found we execute this file in our execution engine. If it is not found, execution engine will write appropriate error to N4JSIDE console.</simpara>
+</section>
+</section>
+<section xml:id="sec:Runtime_Injection" role="langauge-n4js">
+<title>Runtime Injection</title>
+<simpara>There is need to inject into runtime environment some special code, for example when compiling N4JS to ES5 (see N4JavaScriptSpecification,chapter N4 JS Compilation). To achieve this wee need to inject desired code when calling engine to run desired compiled code. Injection mechanism depends a lot on way we run engine. In this section injection of runtime is discussed based on NodeJs that is used as runtime environment.</simpara>
+<section xml:id="sec:Running_String_Code">
+<title>Running String Code</title>
+<simpara>We allow code execution where code is provided in form of <literal>String</literal>. In this case we are calling nodejs with parameters . To enrich execution environment in this case we are appending special runtime code at the end of file. It is important to append it at the end, to avoid changing line numbers of original code and decrease other potential side effects. So actual invocation of nodejs looks like</simpara>
+<simpara>This mechanism assumes:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>injected code starts with new line - this makes ASI mechanism to finish user last statement if it was not properly finished by user, otherwise just creates</simpara>
+</listitem>
+<listitem>
+<simpara>injected code does not have to be initiated manually - all exposed api is in named function declarations</simpara>
+</listitem>
+</orderedlist>
+<simpara><emphasis>Explanation</emphasis></simpara>
+<simpara>In first assumption we make workaround for user code that does not contain new line or semicolon at the end of last statement. This kind of code is incorrect and would result in last statement of user code and first statement of injected code to be interpreted as one JS statement. In most cases that would be invalid code. By having new line as first character of injected code, we are taking advantage of JS AutomaticSemicolonInjection mechanism. If user code AST is not finished properly this mechanism will finish close user AST. If user AST is finished properly, ASI will just insert empty statement between user code and injection code. In both cases we end up with proper AST.</simpara>
+<simpara>Second assumption avoids need for further user code modifications, as injected does not have to be manually called. Instead we take advantage of variable and function hoisting mechanism of JS. This assures that even though user code is first in AST, JS environment will first initiate named functions therefore when user code calls injected code it is already defined in scope in which user code executes.</simpara>
+</section>
+<section xml:id="sec:Running_File_Code">
+<title>Running File Code</title>
+<simpara>Second method of code execution is to execute provided file with user code. Normal way of doing that with NodeJS is to make call. But since we need to inject special code without rewriting files, we use different mechanism. Basically we are executing injected code and in the same scope using node api. Additionally we are attaching injected code to global scope in node, ensuring this way that required file is executed in scope which contains injected code. Putting this all together we are making following call:</simpara>
+<simpara>This mechanism assumes that injected code attaches all exposed API to global scope .</simpara>
+</section>
+<section xml:id="sec:Injection_Code_Example">
+<title>Injection Code Example</title>
+<simpara>Following is simple example of properly formed injection code.</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">;
+function foo(){}
+function bar(){}
+function baz(){}
+
+(function(){
+ GLOBAL.foo = foo;
+ GLOBAL.bar = bar;
+ GLOBAL.baz = baz;
+})();
+;</programlisting>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>first line is empty line to trigger ASI</simpara>
+</listitem>
+<listitem>
+<simpara>second line (optional) enters</simpara>
+</listitem>
+<listitem>
+<simpara>lines 3-5 are defining runtime api in current scope (in which user code provided as a string is executed)</simpara>
+</listitem>
+<listitem>
+<simpara>lines 6 (optional) is just a visual sugar</simpara>
+</listitem>
+<listitem>
+<simpara>lines 7-11 are adding runtime api to global scope (to expose it when runnig user file with code)</simpara>
+</listitem>
+<listitem>
+<simpara>lines 12-13 (optional) are there to separate injected code and invokation of user file (if running user provided file with code)</simpara>
+</listitem>
+</orderedlist>
+</section>
+</section>
+</chapter>
+<chapter xml:id="_tests">
+<title>Tests</title>
+<warning>
+<simpara>This chapter may be outdated.</simpara>
+</warning>
+<simpara>In order to run all tests from command line, use maven:</simpara>
+<screen>mvn clean verify</screen>
+<simpara>You may have to increase the memory for maven via <literal>export MAVEN_OPTS="-Xmx2048m"</literal> (Unix) or <literal>set MAVEN_OPTS="-Xmx2048m"</literal> (Windows).</simpara>
+<simpara>Do not run the tests via <literal>mvn clean test</literal> as this may lead to some failures.</simpara>
+<section xml:id="sec:Performance_Tests" role="language-n4js">
+<title>Performance Tests</title>
+<simpara>There are two kind of performance tests:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>Synthetic Tests: an arbitrary number of test classes is generated, and then some modifications are performed on these classes.</simpara>
+</listitem>
+<listitem>
+<simpara>Real World Tests: tests are based on a snapshot version of our platform libraries</simpara>
+</listitem>
+</orderedlist>
+<section xml:id="sec:Synthetic_Performance_Tests">
+<title>Synthetic Performance Tests</title>
+<simpara>The idea of the synthetic performance tests is to test the performance of specific functionality with a defined number classes, specially designed for the functionality under test.</simpara>
+<simpara>The overall structure of the synthetic performance test is</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>generate test classes</simpara>
+</listitem>
+<listitem>
+<simpara>compile these classes</simpara>
+</listitem>
+<listitem>
+<simpara>modify the test classes</simpara>
+</listitem>
+<listitem>
+<simpara>measure incremental build time</simpara>
+</listitem>
+</orderedlist>
+<simpara>Step 3) and 4) can be done in a loop. Also, step 2) can be looped (with clean build).</simpara>
+<simpara>The test classes are spread over clusters and projects. The following categories are used:</simpara>
+<informaltable tabstyle="horizontal" frame="none" colsep="0" rowsep="0">
+<tgroup cols="2">
+<colspec colwidth="15*"/>
+<colspec colwidth="85*"/>
+<tbody valign="top">
+<row>
+<entry>
+<simpara>Cluster</simpara>
+</entry>
+<entry>
+<simpara>A cluster is a set of projects, each project of a cluster may depend on another project of the cluster. There are no dependencies between projects of different clusters</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Project</simpara>
+</entry>
+<entry>
+<simpara>A project simply is a N4JS project, containing packages. A project may depend on other projects.</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Package</simpara>
+</entry>
+<entry>
+<simpara>A package is a folder in a source folder of a project. A package contains classes.</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Class</simpara>
+</entry>
+<entry>
+<simpara>A class is defined in a file, usually one class per file. The file, and with it the class, is contained in a package. The class contains members.</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Member</simpara>
+</entry>
+<entry>
+<simpara>A member is either a field or method of a class. A method may has a body, which may contain variables with references to other classes.</simpara>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+<section xml:id="sec:Design_of_Generator" role="language-n4js">
+<title>Design of Generator</title>
+<simpara><link linkend="fig:cd_performancetest_generator">Performance Generator</link> shows the classes of the performance test generator.</simpara>
+<informalfigure xml:id="fig:cd_performancetest_generator">
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/15_tests/images/cd_performancetest_generator.svg"/>
+</imageobject>
+<textobject><phrase>cd performancetest generator</phrase></textobject>
+</mediaobject>
+</informalfigure>
+<simpara>The package is designed as follows:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara><literal>N4ProjectGenerator</literal> main control class for generation</simpara>
+</listitem>
+<listitem>
+<simpara><literal>TestDescriptor</literal> and subclasses: In order to <emphasis>keep memory consumption of the test class generator low</emphasis>, there is no graph structure created for the test elements. Instead, each element is uniquely named by a number, this number (actually a tuple of numbers) is stored in <literal>TestDescriptors</literal> and sub classes. There is a descriptor for each element of the tests.</simpara>
+</listitem>
+<listitem>
+<simpara><literal>AbstractModifier</literal> and subclasses generarate the tests. The idea is as follows:</simpara>
+<itemizedlist>
+<listitem>
+<simpara><literal>Modifier</literal> generates all files, with complete references and no issues (complete)</simpara>
+</listitem>
+<listitem>
+<simpara>sub classes of <literal>Modifier</literal> skip certain generations or add modifications, leading to issues or solving them</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+</orderedlist>
+<simpara>In order to compute the name of a class from its descriptor, as well as retrieving a class based on an absolute number, the modifiers use utility methods provided by <literal>PerformanceTestConfiguration</literal>. Note that computing the names and numbers depends on a configuration!</simpara>
+</section>
+<section xml:id="sec:Design_of_Performance_Test_Execution">
+<title>Design of Performance Test Configuration and Execution</title>
+<simpara><xref linkend="fig:cd_performancetest_configAnRun"/> shows the classes of the performance test configuration and execution.</simpara>
+<figure xml:id="fig:cd_performancetest_configAnRun">
+<title>Class Diagram of Performance Test Configuration and Execution</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/15_tests/images/cd_performancetest_configAnRun.svg"/>
+</imageobject>
+<textobject><phrase>cd performancetest configAnRun</phrase></textobject>
+</mediaobject>
+</figure>
+<simpara>The package is designed as follows:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara><literal>PerformanceTestConfiguration</literal> stores the test configuration. The configuration stores how many clusters, packages etc. are to be generated. It also provides methods for generating names from the descriptors mentioned above.</simpara>
+</listitem>
+<listitem>
+<simpara><literal>PerformanceMeter</literal> executes the test, listening to the (build) job to be finished etc.</simpara>
+</listitem>
+<listitem>
+<simpara><literal>AbstractGeneratingPerformanceTest</literal> Base test class contains setup, teardown and utility methods.</simpara>
+</listitem>
+<listitem>
+<simpara><literal>PerformanceTest</literal> Test class containing tests.</simpara>
+</listitem>
+</orderedlist>
+</section>
+<section xml:id="sec:JUnit_Configuration">
+<title>JUnit Configuration</title>
+<simpara>We are using JUnitBenchamrks (<link xl:href="http://labs.carrotsearch.com/junit-benchmarks.html/">http://labs.carrotsearch.com/junit-benchmarks.html/</link>) to extend adjust plain JUnit behavior specifically to the performance tests needs.</simpara>
+</section>
+<section xml:id="sec:JUnitBenchmark_Test_Configuration">
+<title>JUnitBenchmark Test Configuration</title>
+<simpara>JUnitBenchmark test configuration performed by annotating test method with <literal>@BenchmarkOptions</literal>. Parameters for that annotation include:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara><literal>warmupRounds</literal> how many times test will be executed without taking measurement</simpara>
+</listitem>
+<listitem>
+<simpara><literal>benchmarkRounds</literal> how many times test will be executed, measurements taken will be used in results report</simpara>
+</listitem>
+<listitem>
+<simpara><literal>callgc</literal> Call <literal>System.gc()</literal> before each test. This may slow down the tests in a significant way.</simpara>
+</listitem>
+<listitem>
+<simpara><literal>concurrency</literal> specifies how many threads to use for tests.</simpara>
+</listitem>
+<listitem>
+<simpara><literal>clock</literal> specifies which clock to use.</simpara>
+</listitem>
+</orderedlist>
+<simpara>Typical configuration for our performance tests might look like:</simpara>
+<screen>    @BenchmarkOptions(benchmarkRounds = 5, warmupRounds = 2)
+    @Test
+    public void test() throws Exception {
+        //test...
+    }</screen>
+</section>
+<section xml:id="sec:JUnitBenchmark_Report_Configuration">
+<title>JUnitBenchmark Report Configuration</title>
+<simpara>By annotating TestClass in proper way, JUnitBenchamrks will generate html reports with performance results. There are two reports that can be generated:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara><literal>@BenchmarkMethodChart</literal> report will contain results for every method from one test run (but all <literal>benchmarkRounds</literal> defined)</simpara>
+<itemizedlist>
+<listitem>
+<simpara><literal>filePrefix</literal> defines report file name</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+<listitem>
+<simpara><literal>@BenchmarkHistoryChart</literal> report will contain trend of results from multiple test runs (it is aggregation of multiple instances of <literal>@BenchmarkMethodChart</literal> report)</simpara>
+<itemizedlist>
+<listitem>
+<simpara><literal>filePrefix</literal> defines report file name</simpara>
+</listitem>
+<listitem>
+<simpara><literal>labelWith</literal> defines label that will mark separate runs</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+</orderedlist>
+<simpara><emphasis>labelWith</emphasis> property can have value propagated from run configuration/command line. example configuration might be <literal>@BenchmarkHistoryChart(filePrefix = benchmark-history, labelWith = LabelType.CUSTOM_KEY)</literal></simpara>
+</section>
+<section xml:id="sec:JUnitBenchmark_Run_Configuration">
+<title>JUnitBenchmark Run Configuration</title>
+<simpara>It is possible to specify additional options for performance test run</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara><literal>-Djub.consumers=CONSOLE,H2</literal> specifies where results will be written, <emphasis>H2</emphasis> indicates H2 database to be used</simpara>
+</listitem>
+<listitem>
+<simpara><literal>-Djub.db.file=.benchmarks</literal> specifies name of the H2 database file</simpara>
+</listitem>
+<listitem>
+<simpara><literal>-Djub.customkey=</literal> value of that property scan be used as label in <literal>@BenchmarkHistoryChart</literal></simpara>
+</listitem>
+</orderedlist>
+</section>
+<section xml:id="sec:JUnitBenchmark_Example">
+<title>JUnitBenchmark Example</title>
+<simpara>configuration example:</simpara>
+<screen>@BenchmarkMethodChart(filePrefix = "benchmark-method")
+@BenchmarkHistoryChart(filePrefix = "benchmark-history", labelWith = LabelType.CUSTOM_KEY)
+public class PerformanceTest extends AbstractGeneratingPerformanceTest {
+
+    public PerformanceTest() {
+        super("PerfTest");
+    }
+
+    @Rule
+    public TestRule benchmarkRun = new BenchmarkRule();
+
+    @Test
+    @BenchmarkOptions(benchmarkRounds = 5, warmupRounds = 2)
+    public void Test1() throws Exception {
+
+        //Test...
+    }
+
+    @Test
+    @BenchmarkOptions(benchmarkRounds = 5, warmupRounds = 2)
+    public void Test2() throws Exception {
+
+        //Test...
+    }
+}</screen>
+<simpara>executing this code in Eclipse with configuration:</simpara>
+<programlisting language="bash" linenumbering="unnumbered">-Xms512m -Xmx1024m -XX:MaxPermSize=512m $-$Djub.consumers=CONSOLE,H2 $-$Djub.db.file=.benchmarks $-$Djub.customkey=${current_date}</programlisting>
+<simpara>will cause :</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>both tests to be executed 2 times for the warmup</simpara>
+</listitem>
+<listitem>
+<simpara>both of tests being executed 5 times with measurement taken</simpara>
+</listitem>
+<listitem>
+<simpara>results written to console</simpara>
+</listitem>
+<listitem>
+<simpara>results stored in local H2 db file (created if doesn’t exist)</simpara>
+</listitem>
+<listitem>
+<simpara>generated <emphasis>benchmark-method.html</emphasis> with performance results of every test in that execution</simpara>
+</listitem>
+<listitem>
+<simpara>generated <emphasis>benchmark-history.html</emphasis> with performance results of every execution</simpara>
+</listitem>
+<listitem>
+<simpara>separate test executions will be labeled in <emphasis>benchmark-history.html</emphasis> with their start time</simpara>
+</listitem>
+</orderedlist>
+</section>
+<section xml:id="sec:Note_on_Jenkins_Job">
+<title>Note on Jenkins Job</title>
+<simpara>For performance tests it is important not to get pass/fail result in terms of being below given threshold, but also to examine trend of those results. We achieve this by tooling described above. In order to keep this data independent of the build machine or build system storage, we are using separate repository to store performance artifacts. Jenkins in copying previous test results into workspace, runs performance tests, then commits and pushes combined results (adds current results to previous results) to repository.</simpara>
+</section>
+</section>
+</section>
+<section xml:id="sec:ECMA_Tests" role="language-n4js">
+<title>ECMA Tests</title>
+<simpara>ECMAScript Language test262 is a test suite intended to check agreement between JavaScript implementations and ECMA-262, the ECMAScript Language Specification (currently 5.1 Edition).The test suite contains thousands of individual tests, each of which tests some specific requirements of the ECMAScript Language Specification. For more info refer to <link xl:href="http://test262.ecmascript.org/">http://test262.ecmascript.org/</link></simpara>
+<simpara>Uses of this suite may include:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>grammar tests</simpara>
+</listitem>
+<listitem>
+<simpara>validation tests</simpara>
+</listitem>
+<listitem>
+<simpara>run-time tests</simpara>
+</listitem>
+</orderedlist>
+<simpara>ECMA test262 suite source code can be found here: <link xl:href="http://hg.ecmascript.org/tests/test262">http://hg.ecmascript.org/tests/test262</link></simpara>
+<section xml:id="sec:Grammar_Tests">
+<title>Grammar Tests</title>
+<simpara>Based on the JS files included in test262 suite we are generating tests that feed provided JS code into the parser. This operation will result in</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>parser throwing exceptions</simpara>
+</listitem>
+<listitem>
+<simpara>parsed output will contain standard output</simpara>
+</listitem>
+</orderedlist>
+<simpara>First case indicates that parsing provided JS code was not possible. This is considered to be Test Error.</simpara>
+<simpara>Second case case indicates that parsing of the provided code was successful, and will result either</simpara>
+<itemizedlist>
+<listitem>
+<simpara>output with no errors - code adhered parser grammar</simpara>
+</listitem>
+<listitem>
+<simpara>output with errors - code violated parser grammar</simpara>
+</listitem>
+</itemizedlist>
+<simpara>Given test must interpret those results to provide proper test output.</simpara>
+<section xml:id="sec:Negative_Tests">
+<title>Negative Tests</title>
+<simpara>It is important to note that some of the tests are positive and some are negative. Negative test cases are marked by the authors with <emphasis>@negative</emphasis> JSDoc like marker therefore parser tests must be aware of that to avoid both false positives and false negatives results.</simpara>
+</section>
+<section xml:id="sec:Test_Exclusion">
+<title>Test Exclusion</title>
+<simpara>To exclude validation tests or run-time related test, implementation is blacklist approach to exclude some of the ECMA test262 tests from execution.</simpara>
+</section>
+</section>
+</section>
+<section xml:id="sec:Integration_Tests" role="language-n4js">
+<title>Integration Tests</title>
+<simpara>Integration tests based on the stdlib and online-presence code bases can be found in bundle <literal>org.eclipse.n4js.hlc.tests</literal>
+in package <literal>org.eclipse.n4js.hlc.tests.integration</literal> (headless case) and in bundle <literal>org.eclipse.n4js.ui.tests</literal> in
+package <literal>org.eclipse.n4js.ui.tests.integration</literal> (plugin-UI tests running inside Eclipse). The headless
+tests also execute mangelhaft tests, the UI tests only perform compilation of the test code.</simpara>
+<simpara>More information can be found in the API documentation of classes <literal>AbstractIntegrationTest</literal> and <literal>AbstractIntegrationPluginUITest</literal>.</simpara>
+</section>
+<section xml:id="sec:Test_Helpers" role="language-n4js">
+<title>Test Helpers</title>
+<simpara>Test helpers contain utility classes that are reused between different test plug-ins.</simpara>
+<section xml:id="sec:Parameterized_N4JS_Tests">
+<title>Parameterized N4JS tests</title>
+<simpara>Xtext JUnit test runer injects test a ParserHelper that allows to run N4JS parser on given input and obtain information abut parsing results. In some cases we want to run this kind of tests on large input data. To address this we provide two utilities ParameterizedXtextRunner and TestCodeProvider. They allow write data driven parser tests.</simpara>
+<section xml:id="sec:ParameterizedXtextRunner">
+<title>ParameterizedXtextRunner</title>
+<simpara>This This junit runner serves two purposes:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>injecting ParserHelper</simpara>
+</listitem>
+<listitem>
+<simpara>creating multiple test instances for each input data provided</simpara>
+</listitem>
+</itemizedlist>
+<simpara>This class is based on @link org.eclipse.xtext.testing.XtextRunner and @link org.junit.runners.Parameterized</simpara>
+</section>
+<section xml:id="sec:TestCodeProvider">
+<title>TestCodeProvider</title>
+<simpara>This class is repsonsible for extracting ZipEntry from provided ZipFile. Additinally it can filter out entries that match strings in provided black list file. Filtering out ZipEntries assumes that blacklist file contians Path of ZipEntry in ZipFile as string in one line. Lines starting with <emphasis>#</emphasis> in black list file are ignored by TestCodeProvider.</simpara>
+</section>
+<section xml:id="sec:Example_Of_Parameterized_Parser_Test">
+<title>Example of parameterized parser test</title>
+<programlisting language="n4js" linenumbering="unnumbered">@RunWith(XtextParameterizedRunner.class)
+@InjectWith(N4JSInjectorProvider.class)
+public class DataDrivenParserTestSuite {
+
+    /**
+     * Zip archives containing test files.
+     */
+    public static final Collection&lt;String&gt; TEST_DATA_RESOURCES = Arrays.asList("foo.zip", "bar.zip");
+
+    /**
+     * Blacklist of files requiring an execution engine.
+     */
+    public static final String BLACKLIST_FILENAME = "blacklist.txt";
+
+    /**
+     * Every generated test will use different ZipEntry as test data
+     */
+    final ZipEntry entry;
+
+    /**
+     * Name of resource containing corresponding ZipEntry
+     */
+    final String resourceName;
+
+    @Inject
+    protected ParseHelper&lt;Script&gt; parserN4JS;
+
+    Collection&lt;String&gt; blackList;
+
+    static final Logger logger = Logger.getLogger("someLogger");
+
+    public CopyOfLibraryParsingTestSuite(ZipEntry entry, String resourceName, Collection&lt;String&gt; blackList) {
+        this.entry = entry;
+        this.resourceName = resourceName;
+        this.blackList = blackList;
+    }
+
+    @Rule
+    public TestRule blackListHandler = new TestRule() {
+        @Override
+        public Statement apply(final Statement base, Description description) {
+            final String entryName = entry.getName();
+            if (blackList.contains(entryName)) {
+                return new Statement() {
+                    @Override
+                    public void evaluate() throws Throwable {
+                        try {
+                            base.evaluate();
+                        } catch (AssertionError e) {
+                            // expected
+                            return;
+                        }
+                    }
+                };
+            } else {
+                return base;
+            }
+        }
+    };
+
+    /**
+     * Generates collection of ZipEntry instances that will be used as data
+     * provided parameter is mapped to name of the test (takes advantage of fact
+     * that ZipEntry.toString() is the same as entry.getName())
+     *
+     * @return
+     * @throws URISyntaxException
+     * @throws ZipException
+     * @throws IOException
+     */
+    @Parameters(name = "{0}")
+    public static Collection&lt;Object[]&gt; data() throws URISyntaxException, ZipException, IOException {
+        return TestCodeProvider.getDataFromZippedRoots(TEST_DATA_RESOURCES, BLACKLIST_FILENAME);
+    }
+
+    /**
+     * generated instances of the tests will use this base implementation
+     *
+     * @throws Exception
+     */
+    @Test
+    public void test() throws Exception {
+        assertNotNull(this.entry);
+        assertNotNull(this.resourceName);
+        assertNotNull(this.parserN4JS);
+
+        //actual test code
+
+    }
+}</programlisting>
+</section>
+</section>
+</section>
+<section xml:id="sec:Issue_Suppression" role="language-n4js">
+<title>Issue Suppression</title>
+<simpara>It can be useful to suppress certain issues before tests are ran, so that test expectations don’t have to consider inessential warnings. This means that the validator still returns a full list of issues, but before passing them to the testing logic, the issues are filtered.</simpara>
+<simpara>When working with JUnit tests, the custom InjectorProvider <literal>N4JSInjectorProviderWithIssueSuppression</literal> can be used to configure them to suppress issues.</simpara>
+<simpara>The codes that are suppressed are globally specified by the<?asciidoc-br?>
+<literal>DEFAULT_SUPPRESSED_ISSUE_CODES_FOR_TESTS</literal> constant in <literal>N4JSLanguageConstants</literal>.</simpara>
+<simpara>When working with Xpect tests, the XpectSetupFactory <literal>SuppressIssuesSetup</literal> can be used. See <link linkend="sec:Xpect_Issue_Suppression">Xpext Issue Suppression</link> for more details on Xpect issue suppression.</simpara>
+</section>
+<section xml:id="sec:Xpect_Tests" role="language-n4js">
+<title>Xpect Tests</title>
+<simpara>For many tests, Xpect [<link linkend="Xpect">Xpect</link>] is used. Xpect allows for defining tests inside the language which is the language under test. That is, it is possible to refer to a JUnit test method in a special annotated comment, along with arguments passed to that method (typically expectations and the concrete location). Xpect comes with a couple of predefined methods which could be used there, e.g., tests for checking whether some expected error messages actually are produced. We have defined (and will probably define more) N4JS specific test methods.</simpara>
+<simpara>In the following, we describe the most common Xpect test methods we use. Note that we do not use all types of tests shipped with Xpect. For example, AST tests (comparing the actual AST with an expected AST, using string dumps) is too hard to maintain.</simpara>
+<simpara>Xpect test can be ignored by inserting a <literal>!</literal> between <literal>XPECT</literal> and the test name, e.g.</simpara>
+<screen>// XPECT ! errors --&gt; '~$message$~' at "~$location$~"</screen>
+<section xml:id="sec:Xpect_Test_Setup">
+<title>Xpect Test Setup</title>
+<simpara>The setup is either defined in the file itself, e.g.,</simpara>
+<screen>/* XPECT_SETUP org.eclipse.n4js.spec.tests.N4JSSpecTest END_SETUP */</screen>
+<simpara>or bundle-wide for a specific language in the plugin.xml (or fragment.xml), e.g.,</simpara>
+<screen>&lt;extension point="org.xpect.testSuite"&gt;
+    &lt;testSuite class="org.eclipse.n4js.spec.tests.N4JSSpecTest" fileExtension="n4js" /&gt;
+&lt;/extension&gt;</screen>
+</section>
+<section xml:id="sec:Xpect_Issue_Suppression">
+<title>Xpect Issue Suppression</title>
+<simpara>To configure an Xpect test class to suppress issues, you have to use the <literal>@XpectImport</literal> annotation to import the XpectSetupFactory <literal>org.eclipse.n4js.xpect.validation.suppression.SuppressIssuesSetup</literal>. Any Xpect test that is executed by this runner will work on the filtered list of issues.</simpara>
+<simpara>Similar to issue suppressing JUnit tests, the suppressed issue codes are specified by<?asciidoc-br?>
+<literal>DEFAULT_SUPPRESSED_ISSUE_CODES_FOR_TESTS</literal> constant in <literal>N4JSLanguageConstants</literal>.</simpara>
+<simpara>For further per-file configuration a custom <literal>XPECT_SETUP</literal> parameter can be used. This overrides the suppression configuration of an Xpect runner class for the current file.</simpara>
+<screen>/* XPECT_SETUP org.eclipse.n4js.tests.N4JSXpectTest
+
+IssueConfiguration {
+    IssueCode "AST_LOCAL_VAR_UNUSED" {enabled=true}
+}
+
+END_SETUP
+*/</screen>
+<simpara>In this example the issue code <literal>AST_LOCAL_VAR_UNUSED</literal> is explicitly enabled which means that no issue with this issue code will be suppressed.</simpara>
+</section>
+<section xml:id="sec:Xpect_Provided_Test_Methods">
+<title>Xpect Provided Test Methods</title>
+<section xml:id="errors">
+<title>errors</title>
+<informaltable tabstyle="horizontal" frame="none" colsep="0" rowsep="0">
+<tgroup cols="2">
+<colspec colwidth="15*"/>
+<colspec colwidth="85*"/>
+<tbody valign="top">
+<row>
+<entry>
+<simpara>Definition</simpara>
+</entry>
+<entry>
+<simpara>Single line:</simpara>
+<screen>// XPECT errors --&gt; '~$message$~' at "~$location$~"</screen>
+<simpara>Multi line:</simpara>
+<screen>/* XPECT errors ---
+'~$message_1$~' at "~$location_1$~"
+~$\dots$~
+'~$message_n$~' at "~$location_n$~"
+--- */</screen>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+<informaltable tabstyle="horizontal" frame="none" colsep="0" rowsep="0">
+<tgroup cols="2">
+<colspec colwidth="15*"/>
+<colspec colwidth="85*"/>
+<tbody valign="top">
+<row>
+<entry>
+<simpara>Description</simpara>
+</entry>
+<entry>
+<simpara>Checks that one or more errors are issued at given location and compares the actual messages at a given location with the expected messages specified in the test.</simpara>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+<simpara>Also see <literal>no errors</literal> below.</simpara>
+</section>
+<section xml:id="warnings">
+<title>warnings</title>
+<informaltable tabstyle="horizontal" frame="none" colsep="0" rowsep="0">
+<tgroup cols="2">
+<colspec colwidth="15*"/>
+<colspec colwidth="85*"/>
+<tbody valign="top">
+<row>
+<entry>
+<simpara>Definition</simpara>
+</entry>
+<entry>
+<simpara>Single line:<?asciidoc-br?></simpara>
+<screen>// XPECT warnings --&gt; '~$Message$~' at "~$Location$~"</screen>
+<simpara>Multi line:</simpara>
+<screen>/* XPECT warnings ---
+'~$message_1$~' at "~$location_1$~"
+~$\dots$~
+'~$message_n$~' at "~$location_n$~"
+--- */</screen>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Description</simpara>
+</entry>
+<entry>
+<simpara>Checks that one or more warnings are issued at given location and compares the actual messages at a given location with the expected messages specified in the test.</simpara>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+</section>
+</section>
+<section xml:id="sec:N4JS_Specific_Xpect_Test_Methods">
+<title>N4JS Specific Xpect Test Methods</title>
+<simpara>There are a lot of N4 specific Xpect tests methods available. To get all of these methods, search for references to annotation <literal>org.xpect.runner.Xpect</literal> in the N4 test plugins.</simpara>
+<section xml:id="sec:XPECT_noerrors">
+<title>noerrors and nowarnings</title>
+<informaltable tabstyle="horizontal" frame="none" colsep="0" rowsep="0">
+<tgroup cols="2">
+<colspec colwidth="15*"/>
+<colspec colwidth="85*"/>
+<tbody valign="top">
+<row>
+<entry>
+<simpara>Definition</simpara>
+</entry>
+<entry>
+<simpara>Single line:</simpara>
+<screen>// XPECT noerrors --&gt; '~$messageOrComment$~' at "~$location$~"</screen>
+<simpara>Multi line:</simpara>
+<screen>/* XPECT noerrors ---
+'~$messageOrComment_1$~' at "~$location_1$~"
+~$\dots$~
+'~$messageOrComment_n$~' at "~$location_n$~"
+--- */</screen>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+<informaltable tabstyle="horizontal" frame="none" colsep="0" rowsep="0">
+<tgroup cols="2">
+<colspec colwidth="15*"/>
+<colspec colwidth="85*"/>
+<tbody valign="top">
+<row>
+<entry>
+<simpara>Provided by</simpara>
+</entry>
+<entry>
+<simpara><literal>NoerrorsValidationTest</literal></simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Description</simpara>
+</entry>
+<entry>
+<simpara>Checks that at the given location <emphasis>no</emphasis> error (or warning) is issued. This tests is roughly speaker the opposite of <literal>errors</literal>. The idea behind this test is to replace comments in the code, stating that an expression is assumed to be valid, with an explicit test. This is in particular useful when you start working on a task, in which there are (wrong) errors at a given position, or for bug report.</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Example</simpara>
+</entry>
+<entry>
+<informalexample>
+<screen>function foo(any o): number {
+    if (o instanceof string) {
+        // XPECT noerrors --&gt; "effect systems knows that o is a string" at "o"
+        return o.length;
+    }
+    return 0;
+}</screen>
+<simpara>is clearer and more explicit than</simpara>
+<screen>function foo(any o): number {
+    if (o instanceof string) {
+        // here should be no error:
+        return o.length;
+    }
+    return 0;
+}</screen>
+<simpara>Also, the <literal>noerrors</literal> version will fail with a correct description, while the second one would fail with a general error and no location. Once the feature is implemented, regressions are detected much easier with the explicit version.</simpara>
+</informalexample>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+</section>
+<section xml:id="sec:XPECT_scope">
+<title>scope</title>
+<informaltable tabstyle="horizontal" frame="none" colsep="0" rowsep="0">
+<tgroup cols="2">
+<colspec colwidth="15*"/>
+<colspec colwidth="85*"/>
+<tbody valign="top">
+<row>
+<entry>
+<simpara>Definition</simpara>
+</entry>
+<entry>
+<simpara>Single line:</simpara>
+<screen>// XPECT scope at $location$ --&gt; ~$[$~!~$]$~~$name_1$~, ~$\dots$~, ~$[$~!~$]$~~$name_n$~ ~$[$ ~, ...~$]$~</screen>
+<simpara>Multi line:</simpara>
+<screen>/* XPECT scope $location$ ---
+~$[$~!~$]$~~$name_1$~, ~$\dots$~,
+~$[$~!~$]$~~$name_n$~~$[$ ~, ...~$]$~
+--- */</screen>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+<informaltable tabstyle="horizontal" frame="none" colsep="0" rowsep="0">
+<tgroup cols="2">
+<colspec colwidth="15*"/>
+<colspec colwidth="85*"/>
+<tbody valign="top">
+<row>
+<entry>
+<simpara>Provided by</simpara>
+</entry>
+<entry>
+<simpara><literal>PositionAwareScopingXpectTest</literal></simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Description</simpara>
+</entry>
+<entry>
+<simpara>Checks that the expected elements are actually found in the scope (or explicitly not found, when <literal>!</literal>   is used). This is a modified version of the Xpect built-in scope test, ensuring that also elements only put into the scope when they are explicitly requested are found.</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Example</simpara>
+</entry>
+<entry>
+<screen>// XPECT scope at 'this.|$data_property_b' --&gt; a, b, $data_property_b, !newB, ...
+return this.$data_property_b + "_getter";</screen>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+</section>
+<section xml:id="sec:XPECT_scopeWithPosition">
+<title>scopeWithPosition</title>
+<informaltable tabstyle="horizontal" frame="none" colsep="0" rowsep="0">
+<tgroup cols="2">
+<colspec colwidth="15*"/>
+<colspec colwidth="85*"/>
+<tbody valign="top">
+<row>
+<entry>
+<simpara>Definition</simpara>
+</entry>
+<entry>
+<simpara>Single line:</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">// XPECT scopeWithPosition at $location$ --&gt; ~$[$~!~$]$~~$name_1$~ - ~$pos_1$~, ~$\dots$~, ~$[$~!~$]$~~$name_n$~ - ~$pos_n$~ ~$[$ ~, ...~$]$~</programlisting>
+<simpara>Multi line:</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">/* XPECT scopeWithPosition $location$ ---
+~$[$~!~$]$~~$name_1$~ - ~$pos_1$~, ~$\dots$~,
+~$[$~!~$]$~~$name_n$~ - ~$pos_n$~ ~$[$ ~, ...~$]$~
+--- */</programlisting>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Provided by</simpara>
+</entry>
+<entry>
+<simpara><literal>PositionAwareScopingXpectTest</literal></simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Description</simpara>
+</entry>
+<entry>
+<simpara>Checks that the expected elements are actually found in the scope (or explicitly not found, when <literal>!</literal>   is used). The concrete syntax of the position, which is usually the line number, or the line number prefix with <literal>T</literal>   if a type element is referenced, is described in <literal>EObjectDescriptionToNameWithPositionMapper</literal>.</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Example</simpara>
+</entry>
+<entry>
+<screen>/* XPECT scopeWithPosition at foo2 ---
+    b - 9,
+    c - 25,
+    foo - T3,
+    foo2 - T9,
+    ...
+---*/
+foo2()</screen>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+</section>
+<section xml:id="sec:XPECT_scopeWithResource">
+<title>scopeWithResource</title>
+<informaltable tabstyle="horizontal" frame="none" colsep="0" rowsep="0">
+<tgroup cols="2">
+<colspec colwidth="15*"/>
+<colspec colwidth="85*"/>
+<tbody valign="top">
+<row>
+<entry>
+<simpara>Definition</simpara>
+</entry>
+<entry>
+<simpara>Single line:</simpara>
+<screen>//</screen>
+<simpara>Multi line:</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Provided by</simpara>
+</entry>
+<entry>
+<simpara><literal>N4JSXpectTest</literal></simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Description</simpara>
+</entry>
+<entry>
+<simpara>Compares scope including resource name but not line number.</simpara>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+</section>
+<section xml:id="sec:XPECT_binding">
+<title>binding</title>
+<informaltable tabstyle="horizontal" frame="none" colsep="0" rowsep="0">
+<tgroup cols="2">
+<colspec colwidth="15*"/>
+<colspec colwidth="85*"/>
+<tbody valign="top">
+<row>
+<entry>
+<simpara>Definition</simpara>
+</entry>
+<entry>
+<simpara>Single line:</simpara>
+<screen>//</screen>
+<simpara>Multi line:</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Provided by</simpara>
+</entry>
+<entry>
+<simpara><literal>N4JSXpectTest</literal></simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Description</simpara>
+</entry>
+<entry>
+<simpara>Checks that a given element is bound to something identified by (simple) qualified name. The check is designed as simple as possible. That is, simply the next following expression is tested, and within that we expect a property access or a direct identifiable element. The compared name is the simple qualified name, that is container (type) followed by elements name, without URIs of modules etc.</simpara>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+</section>
+<section xml:id="sec:XPECT_linkedPathname">
+<title>linkedPathname</title>
+<informaltable tabstyle="horizontal" frame="none" colsep="0" rowsep="0">
+<tgroup cols="2">
+<colspec colwidth="15*"/>
+<colspec colwidth="85*"/>
+<tbody valign="top">
+<row>
+<entry>
+<simpara>Definition</simpara>
+</entry>
+<entry>
+<simpara>Single line:</simpara>
+<screen>// XPECT linkedPathname at '$location$' --&gt; ~$pathname$~</screen>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Provided by</simpara>
+</entry>
+<entry>
+<simpara><literal>LinkingXpectMethod</literal></simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Description</simpara>
+</entry>
+<entry>
+<simpara>Checks that an identifier is linked to a given element identified by its path name. The path name is the qualified name in which the segments are separated by ’/’. This test does not use the qualified name provider, as the provider may return null for non-globally available elements. It rather computes the name again by using reflection, joining all <literal>name</literal>   properties of the target and its containers.</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Example</simpara>
+</entry>
+<entry>
+<screen>// XPECT linkedPathname at 'foo()' --&gt; C/foo
+new C().foo();</screen>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+</section>
+<section xml:id="sec:XPECT_type_of">
+<title>type of</title>
+<informaltable tabstyle="horizontal" frame="none" colsep="0" rowsep="0">
+<tgroup cols="2">
+<colspec colwidth="15*"/>
+<colspec colwidth="85*"/>
+<tbody valign="top">
+<row>
+<entry>
+<simpara>Definition</simpara>
+</entry>
+<entry>
+<simpara>Single line:</simpara>
+<screen>// XPECT type of '$location$' --&gt; ~$type$~</screen>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Provided by</simpara>
+</entry>
+<entry>
+<simpara><literal>N4JSXpectTest</literal></simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Description</simpara>
+</entry>
+<entry>
+<simpara>Checks that the type inferred at location is similar to expected type.</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Example</simpara>
+</entry>
+<entry>
+<screen>// XPECT type of 'x' --&gt; string
+var x = 'hello';
+// XPECT type of 'foo()' --&gt; union{A,number}
+var any y = foo();</screen>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+</section>
+<section xml:id="sec:XPECT_expectedType">
+<title>expectedType</title>
+<informaltable tabstyle="horizontal" frame="none" colsep="0" rowsep="0">
+<tgroup cols="2">
+<colspec colwidth="15*"/>
+<colspec colwidth="85*"/>
+<tbody valign="top">
+<row>
+<entry>
+<simpara>Definition</simpara>
+</entry>
+<entry>
+<simpara>-</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Single line</simpara>
+</entry>
+<entry>
+<screen>// XPECT expectedType at 'location' --&amp;gt; Type</screen>
+<literallayout class="monospaced">The location (at) is optional.</literallayout>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Provided by</simpara>
+</entry>
+<entry>
+<simpara><literal>N4JSXpectTest</literal></simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Description</simpara>
+</entry>
+<entry>
+<simpara>Checks that an element/expression has a certain expected type (i.e. Xsemantics judgment expectedTypeIn).</simpara>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+</section>
+<section xml:id="sec:XPECT_elementKeyword">
+<title>elementKeyword</title>
+<informaltable tabstyle="horizontal" frame="none" colsep="0" rowsep="0">
+<tgroup cols="2">
+<colspec colwidth="15*"/>
+<colspec colwidth="85*"/>
+<tbody valign="top">
+<row>
+<entry>
+<simpara>Definition</simpara>
+</entry>
+<entry>
+<simpara>Single line:</simpara>
+<screen>// XPECT elementKeyword at 'myFunction' -&gt; function</screen>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Example</simpara>
+</entry>
+<entry>
+<screen>interface I {
+  fld: int;
+  get g(): string;
+  set s(p:string);
+}
+
+//XPECT elementKeyword at 'string' --&gt; primitive
+var v1: string;
+
+//XPECT elementKeyword at 'I' --&gt; interface
+var i: I;
+
+//XPECT elementKeyword at 'fld' --&gt; field
+i.fld;</screen>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Provided by</simpara>
+</entry>
+<entry>
+<simpara><literal>ElementKeywordXpectMethod</literal></simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Description</simpara>
+</entry>
+<entry>
+<simpara>Checks that an element/expression has a certain element keyword. The expected element keyword is identical
+to the element keyword shown when hovering the mouse over that element/expression in the N4JS IDE. This method is particuarly useful for testing merged elements of union/intersection.</simpara>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+</section>
+<section xml:id="sec:XPECT_accessModifier">
+<title>accessModifier</title>
+<informaltable tabstyle="horizontal" frame="none" colsep="0" rowsep="0">
+<tgroup cols="2">
+<colspec colwidth="15*"/>
+<colspec colwidth="85*"/>
+<tbody valign="top">
+<row>
+<entry>
+<simpara>Definition</simpara>
+</entry>
+<entry>
+<simpara>Single line:</simpara>
+<screen>// XPECT accessModifier at 'myFunction' -&gt; function</screen>
+<simpara>or</simpara>
+<screen>// XPECT accessModifier -&gt; function</screen>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Example</simpara>
+</entry>
+<entry>
+<screen>// XPECT accessModifier --&gt; publicInternal
+export @Internal public abstract class MyClass2 {
+
+// XPECT accessModifier --&gt; project
+abstract m1(): string;
+
+// XPECT accessModifier at 'm2' --&gt; project
+m2(): string {
+    return "";
+  }
+}</screen>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Provided by</simpara>
+</entry>
+<entry>
+<simpara><literal>AccessModifierXpectMethod</literal></simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Description</simpara>
+</entry>
+<entry>
+<simpara>Checks that an element/expression has a certain accessibility.</simpara>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+</section>
+<section xml:id="sec:XPECT_compileResult">
+<title>compileResult</title>
+<informaltable tabstyle="horizontal" frame="none" colsep="0" rowsep="0">
+<tgroup cols="2">
+<colspec colwidth="15*"/>
+<colspec colwidth="85*"/>
+<tbody valign="top">
+<row>
+<entry>
+<simpara>Definition</simpara>
+</entry>
+<entry>
+<simpara>Single line:</simpara>
+<screen>//</screen>
+<simpara>Multi line:</simpara>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+<informaltable tabstyle="horizontal" frame="none" colsep="0" rowsep="0">
+<tgroup cols="2">
+<colspec colwidth="15*"/>
+<colspec colwidth="85*"/>
+<tbody valign="top">
+<row>
+<entry>
+<simpara>Provided by</simpara>
+</entry>
+<entry>
+<simpara>-</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Description</simpara>
+</entry>
+<entry>
+<simpara><emphasis>This test should only be used during development of compiler and not used in the long run, because this kind of test is extremely difficult to maintain.</emphasis></simpara>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+</section>
+<section xml:id="sec:XPECT_output">
+<title>output</title>
+<informaltable tabstyle="horizontal" frame="none" colsep="0" rowsep="0">
+<tgroup cols="2">
+<colspec colwidth="15*"/>
+<colspec colwidth="85*"/>
+<tbody valign="top">
+<row>
+<entry>
+<simpara>Definition</simpara>
+</entry>
+<entry>
+<simpara>Single line:</simpara>
+<screen>//</screen>
+<simpara>Multi line:</simpara>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+<informaltable tabstyle="horizontal" frame="none" colsep="0" rowsep="0">
+<tgroup cols="2">
+<colspec colwidth="15*"/>
+<colspec colwidth="85*"/>
+<tbody valign="top">
+<row>
+<entry>
+<simpara>Provided by</simpara>
+</entry>
+<entry>
+<simpara>-</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Description</simpara>
+</entry>
+<entry>
+<simpara>The most important test for compiler/transpiler, but also for ensuring that N4JS internal validations and assumptions are true at runtime.</simpara>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+</section>
+<section xml:id="sec:XPECT_outputRegEx">
+<title>outputRegEx</title>
+
+</section>
+<section xml:id="sec:XPECT_calculatedAccessModifier">
+<title>calculatedAccessModifier</title>
+
+</section>
+<section xml:id="sec:XPECT_spec">
+<title>spec</title>
+
+</section>
+<section xml:id="sec:XPECT_deadCode">
+<title>deadCode</title>
+
+</section>
+<section xml:id="sec:XPECT_returnOrThrows">
+<title>returnOrThrows</title>
+
+</section>
+<section xml:id="sec:XPECT_lint">
+<title>lint</title>
+<informaltable tabstyle="horizontal" frame="none" colsep="0" rowsep="0">
+<tgroup cols="2">
+<colspec colwidth="15*"/>
+<colspec colwidth="85*"/>
+<tbody valign="top">
+<row>
+<entry>
+<simpara>Definition</simpara>
+</entry>
+<entry>
+<simpara>Single line:</simpara>
+<screen>/* XPECT lint */</screen>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Provided by</simpara>
+</entry>
+<entry>
+<simpara><literal>CompileAndLintTest</literal></simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Description</simpara>
+</entry>
+<entry>
+<simpara>Passes the generated code through the JSHint JavaScript linter. This test includes for instance checking for missing semicolons and undefined variables. The whole test exclusively refers to the generated javascript code.</simpara>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+</section>
+<section xml:id="sec:XPECT_lintFails">
+<title>lintFails</title>
+<informaltable tabstyle="horizontal" frame="none" colsep="0" rowsep="0">
+<tgroup cols="2">
+<colspec colwidth="15*"/>
+<colspec colwidth="85*"/>
+<tbody valign="top">
+<row>
+<entry>
+<simpara>Definition</simpara>
+</entry>
+<entry>
+<simpara>Single line:</simpara>
+<screen>/* XPECT lintFails */</screen>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Provided By</simpara>
+</entry>
+<entry>
+<simpara><literal>CompileAndLintTest</literal></simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Description</simpara>
+</entry>
+<entry>
+<simpara>Negation of lint. Fails on linting success. Expects linting errors.</simpara>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+</section>
+</section>
+<section xml:id="sec:FIXME_Xpect_modifier">
+<title>FIXME Xpect modifier</title>
+<simpara>A modification of the official Xpect framework allows us to use the FIXME modifier on each test. <footnote><simpara>Currently we use our own fork of Xpect <link xl:href="https://github.com/NumberFour/Xpect">https://github.com/NumberFour/Xpect</link> and the respective p2-repository <link xl:href="https://numberfour.github.io/Xpect/updatesite/nightly/">https://numberfour.github.io/Xpect/updatesite/nightly/</link></simpara></footnote></simpara>
+<informaltable tabstyle="horizontal" frame="none" colsep="0" rowsep="0">
+<tgroup cols="2">
+<colspec colwidth="15*"/>
+<colspec colwidth="85*"/>
+<tbody valign="top">
+<row>
+<entry>
+<simpara>Syntax</simpara>
+</entry>
+<entry>
+<simpara>FIXME can be applied on any test just after the XPECT keyword:</simpara>
+<screen>// XPECT FIXME  xpectmethod ... --&gt; ...</screen>
+<simpara>Tests will still be ignored if an exclamation mark (!) is put between XPECT and FIXME.</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Description</simpara>
+</entry>
+<entry>
+<simpara>Using FIXME on a test negates the result of the underlying JUnit test framework. Thus a failure will be reported as a <literal>true assertion</literal>   and an assertion that holds will be reported as <literal>failure</literal>  . This enables to author valuable tests of behaviour, which is still not functional.</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Example</simpara>
+</entry>
+<entry>
+<simpara>For instance, if we encounter an error-message at a certain code position, but the code is perfectly right, then we have an issue. We can annotate the situation with a ’fix me’ ’noerrors’ expectation:</simpara>
+<screen>// Perfectly right behaviour XPECT FIXME noerrors --&gt;
+console.log("fine example code with wrong error marker here.");</screen>
+<simpara>This turns the script into an Xpect test. We can integrate the test right away into our test framework and it will not break our build (even though the bug is not fixed).</simpara>
+<simpara>When the issue will be worked on, the developer starts with removing ’FIXME’ turning this into useful unit-test.</simpara>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+<simpara>It is crucial to understand that FIXME negates the whole assertion. Example: If one expects an error marker at a certain position using the ’errors’ directive, one must give the exact wording of the expected error-message to actually get the FIXME behaviour working. To avoid strange behaviour it is useful to describe the expected error a comment in front of the expectation and leave the message-section empty.</simpara>
+</section>
+<section xml:id="sec:Expectmatrix_Xpect_Test_Methods">
+<title>Expectmatrix Xpect tests</title>
+<simpara>Applying test-driven development begins with authoring acceptance and functional tests for the work in the current sprint. By this the overall code quality is ensured for the current tasks to solve. Rerunning all collected tests with each build ensures the quality of tasks solved in the past. Currently there is no real support for tasks, which are not in progress but are known to be processed in the near or far future. Capturing non-trivial bug reports and turning them into reproducable failing test-cases is one example.</simpara>
+<simpara>Usually people deactivate those future-task-tests in the test code by hand. This approach doesn’t allow to calculate any metrics about the code. One such metric would be: Is there any reported bug solved just by working on an (seemingly unrelated) scheduled task?</simpara>
+<simpara>To achieve measurements about known problems, a special build-scenario is set up. As a naming convention all classes with names matching <literal>*  Pending</literal> are assumed to be Junit tests. In bundle <literal>org.eclipse.n4js.expectmatrix.tests</literal> two different Xpect-Runners are provided, each working on its own subfolder. Usual Xpect-tests are organised in folder xpect-test while in folder xpect-pending all future-tests are placed. A normal maven-build processes only the standard junit and xpect tests. Starting a build with profile <literal>execute-expectmatrix-pending-tests</literal> will additionally execute Xpect tests from folder xpect-pending and for all bundles inheriting from <literal>/tests/pom.xml</literal> all unit tests ending in <literal>*  Pending</literal>. This profile is deactivated by default.</simpara>
+<simpara>A special jenkins-job - N4JS-IDE_nightly_bugreports_pending - is configured to run the pending tests and render an overview und history to compare issues over time. Due to internal Jenkins structures this build always marked failed, even though the maven-build succeeds successfully.</simpara>
+<simpara>Relevant additional information can be found in</simpara>
+<itemizedlist>
+<listitem>
+<simpara>Jenkins job for pending cases: <link xl:href="http://build-master:8080/view/N4JS/job/N4JS-IDE_nightly_bugreports_pending/">http://build-master:8080/view/N4JS/job/N4JS-IDE_nightly_bugreports_pending/</link></simpara>
+</listitem>
+<listitem>
+<simpara>Testmatrix <link xl:href="https://docs.google.com/a/numberfour.eu/spreadsheets/d/1Blo58cRwIWemaiBNSnOtsQ8U7b3FoodX3yEs7oJKIg0/">https://docs.google.com/a/numberfour.eu/spreadsheets/d/1Blo58cRwIWemaiBNSnOtsQ8U7b3FoodX3yEs7oJKIg0/</link></simpara>
+</listitem>
+</itemizedlist>
+</section>
+<section xml:id="xpect-lint-tests">
+<title>Xpect Lint Tests</title>
+<figure xml:id="sec:XPECT_Lint_Tests">
+<title>Xpect Lint</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/15_tests/images/diag_XpectLint.svg"/>
+</imageobject>
+<textobject><phrase>diag XpectLint</phrase></textobject>
+</mediaobject>
+</figure>
+<simpara>The test transpiles the provided n4js resource and checks the generated code. This is achieved using the Javascript linter JSHint.</simpara>
+<simpara>After transpiling the provided n4js resource the LintXpectMethod combines the generated code with the jshint code into a script. It calls the JSHint validation function and returns the linting result as a json object. The error results are displayed in the console. The script is executed using the <literal>Engine</literal> class. (<link linkend="sec:Design">Design</link>)</simpara>
+<simpara>For the linting process an adapted configuration for JSHint is used. For the needs of N4JS the linter is configured to recognise N4JS specific globals. Details about the error codes can be found at the <link xl:href="https://github.com/jshint/jshint/blob/2444a0463e1a99d46e4afa50ed934c317265529d/src/messages.js">jshint repository</link>.</simpara>
+<simpara>The following warnings are explicitly enabled/disabled:</simpara>
+<itemizedlist>
+<listitem>
+<simpara><emphasis role="strong">W069</emphasis>: [’a’] is better written in dot notation <emphasis role="strong">DISABLED</emphasis></simpara>
+</listitem>
+<listitem>
+<simpara><emphasis role="strong">W033</emphasis>: Missing semicolon <emphasis role="strong">ENABLED</emphasis></simpara>
+</listitem>
+<listitem>
+<simpara><emphasis role="strong">W014</emphasis>: Bad line breaking before ’a’. <emphasis role="strong">DISABLED</emphasis></simpara>
+</listitem>
+<listitem>
+<simpara><emphasis role="strong">W032</emphasis>: Uneccesarry semicolon <emphasis role="strong">ENABLED</emphasis></simpara>
+</listitem>
+<listitem>
+<simpara><emphasis role="strong">W080</emphasis>: It’s not necessary to initialize ’a’ to ’undefined’. <emphasis role="strong">ENABLED</emphasis></simpara>
+</listitem>
+<listitem>
+<simpara><emphasis role="strong">W078</emphasis>: Setter is defined without getter. <emphasis role="strong">DISABLED</emphasis></simpara>
+</listitem>
+<listitem>
+<simpara>ES6 related warnings are <emphasis role="strong">disabled</emphasis> using the ’esnext’ option: <emphasis role="strong">W117</emphasis>: Symbol is not defined. <emphasis role="strong">DISABLED</emphasis> <emphasis role="strong">W104</emphasis>: ’yield’ is only available in ES6 <emphasis role="strong">DISABLED</emphasis> <emphasis role="strong">W117</emphasis>: Promise is not defined <emphasis role="strong">DISABLED</emphasis> <emphasis role="strong">W119</emphasis>: function* is only available in ES6 <emphasis role="strong">DISABLED</emphasis></simpara>
+</listitem>
+</itemizedlist>
+<simpara>The xpect lint test only applies if the provided resource passes the n4js compiler.</simpara>
+<simpara>The xpect method lintFails can be used to create negative tests. All linting issues discovered during the development of the xpect plugin have there own negative test to keep track of their existence.</simpara>
+<simpara>Additional information:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>JSHint: <link xl:href="http://jshint.com/docs/">http://jshint.com/docs/</link></simpara>
+</listitem>
+</itemizedlist>
+</section>
+</section>
+<section xml:id="xpect-proposal-tests" role="language-n4js">
+<title>Xpect Proposal Tests</title>
+<simpara>Proposal tests are all tests which verify the existence and application of completion proposals, created by content assist, quick fixes etc.</simpara>
+<simpara>The key attributes of a proposal (cf <literal>ConfigurableCompletionProposal</literal>) are:</simpara>
+<informaltable tabstyle="horizontal" frame="none" colsep="0" rowsep="0">
+<tgroup cols="2">
+<colspec colwidth="15*"/>
+<colspec colwidth="85*"/>
+<tbody valign="top">
+<row>
+<entry>
+<simpara>displayString</simpara>
+</entry>
+<entry>
+<simpara>the string displayed in the proposal list</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>replacementString</simpara>
+</entry>
+<entry>
+<simpara>simple variant of which is to be added to document, not necessarily the whole replacement (as this may affect several locations and even user interaction)</simpara>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+<simpara>In the tests, a <emphasis>proposal is identified by a string contained in the displayString</emphasis>. If several proposal match, test will fail (have to rewrite test setup or proposal identifier to be longer). Proposal identifier should be as short as possible (to make test robust), but not too short (to make test readable).</simpara>
+<simpara>The following proposal tests are defined:</simpara>
+<informaltable tabstyle="horizontal" frame="none" colsep="0" rowsep="0">
+<tgroup cols="2">
+<colspec colwidth="15*"/>
+<colspec colwidth="85*"/>
+<tbody valign="top">
+<row>
+<entry>
+<simpara>contentAssist <math xmlns="http://www.w3.org/1998/Math/MathML"><mrow><mo>[</mo></mrow></math> List <math xmlns="http://www.w3.org/1998/Math/MathML"><mrow><mo>]</mo></mrow></math></simpara>
+</entry>
+<entry>
+<simpara>verifies proposals created by content assist</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>quickFix <math xmlns="http://www.w3.org/1998/Math/MathML"><mrow><mo>[</mo></mrow></math> List <math xmlns="http://www.w3.org/1998/Math/MathML"><mrow><mo>]</mo></mrow></math></simpara>
+</entry>
+<entry>
+<simpara>verifies proposals created by quick fixes. Cursor position is relevant, that’s handled by the framework. We only create tests with cursor position – fixes applied via the problem view should work similarly, but without final cursor position.</simpara>
+<simpara>If no error is found at given position, test will fail (with appropriate error message!). In call cases of apply, the issue must be resolved. Usually, fixing an issue may leave the file invalid as other issues still exists, or because by fixing one issue others may be introduced (which may happen often as we try to avoid consequential errors in validation). For some special cases, quickFix tests support special features, see below.</simpara>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+<simpara>Not tested in this context: Verify proposal description, as these tests would be rather hard to maintain and the descriptions are often computed asynchronously.</simpara>
+<section xml:id="sec:Validation_vs__Non_Validation">
+<title>Validation vs. Non-Validation</title>
+<simpara>We expect proposal tests to be applied on non-valid test files, and usually file is also broken after a proposal has been applied. Thus, the test-suite must not fail if the file is not valid.</simpara>
+</section>
+<section xml:id="sec:General_Proposal_Test_Features">
+<title>General Proposal Test Features</title>
+<section xml:id="sec:Test_Variables">
+<title>Test Variables</title>
+<simpara>Often, list of proposals are similar for different tests (which define different scenarios in which the proposals should be generated). For that reason, variables can be defined in the test set up:</simpara>
+<simpara>In the Xpect-Setup there is now a special <literal>Config</literal> component where specific switches are accessible. For instance the timeout switch for content assist can be modified:</simpara>
+<screen>/* XPECT_SETUP org.eclipse.n4js.tests.N4JSNotValidatingXpectPluginUITest
+    ...
+    Config {
+        content_assist_timeout = 1000
+        ...
+    }
+    ...
+*/</screen>
+<simpara>Note: There should only be one <literal>Config</literal> component per Xpect-Setup.</simpara>
+<simpara>Variables are introduced via the <literal>VarDef</literal> component. It takes a string argument as the variable name on construction. Inside the body one add <literal>MemberLists</literal> and <literal>StringLists</literal> arguments. Variable definitions may appear in <literal>Config</literal> bodies or in the Xpect-Setup.</simpara>
+<screen>VarDef "objectProposals" {
+    ...
+}</screen>
+<simpara>Define variables with expression: A simple selector is given with the <literal>MemberList</literal> component. These components take three <literal>String</literal> arguments in the constructor. The first one is a typename. The second one is the feature selector, e.g. <literal>methods</literal>  , <literal>fields</literal>  , …and the third one defines the visibility.</simpara>
+<screen>/* XPECT_SETUP
+VarDef "stringProposals" { MemberList  "String" "methods" "public" {}}
+END_SETUP */</screen>
+<simpara>We have to define a filter later in Xtend/Java, e.g., <literal>getClassWithName( <emphasis>className</emphasis> ).filterType(<emphasis>methods</emphasis>).filterVisibility(<emphasis>accessodifier</emphasis>)&#8230;&#8203;</literal></simpara>
+<simpara>A variable is later referenced as follows:</simpara>
+<screen>&lt;$variable&gt;</screen>
+<simpara>Usage example:</simpara>
+<screen>// XPECT contentAssistList at 'a.&lt;|&gt;methodA' proposals --&gt; &lt;$stringProposals&gt;, methodA2
+a.methodA</screen>
+</section>
+<section xml:id="sec:Location_and_Selection">
+<title>at – Location and Selection</title>
+<simpara>Tokens in expectation/setup:</simpara>
+<itemizedlist>
+<listitem>
+<simpara><literal>&lt;|&gt;</literal> cursor position</simpara>
+</listitem>
+<listitem>
+<simpara><literal>&lt;[&gt;</literal> selection start → also defines cursor position</simpara>
+</listitem>
+<listitem>
+<simpara><literal>&lt;]&gt;</literal> selection end</simpara>
+</listitem>
+</itemizedlist>
+<simpara>All proposal tests have to specify a location via <literal>at</literal>, the location must contain the cursor position and may contain a selection. E.g.:</simpara>
+<screen>// XPECT contentAssistList at 'a.&lt;|&gt;methodA' apply 'methodA2' --&gt; a.methodA2()&lt;|&gt;methodA
+// XPECT contentAssistList at 'a.&lt;|&gt;&lt;[&gt;methodA&lt;]&gt;' apply 'methodA2' override --&gt; a.methodA2()&lt;|&gt;
+a.methodA</screen>
+</section>
+<section xml:id="sec:Multi_Line_Expectations_in_Proposal_Tests">
+<title>Multi Line Expectations in Proposal Tests</title>
+<simpara>In multiline expectations, ignored lines can be marked with <literal>&lt;&#8230;&#8203;&gt;</literal>. This means that 0 to n lines may occur but are ignored for comparison.</simpara>
+<simpara>All multiline expectations are compared line-wise, with exact match except line delimiters (which are ignored as well)</simpara>
+</section>
+<section xml:id="sec:Timeout">
+<title>Timeout and Performance</title>
+<simpara>We define a default timeout for content assist tests. In set up, this timeout may be changed:</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">/* XPECT SETUP
+...
+content_assist_timeout = 2000ms
+...
+END_SETUP */</programlisting>
+<simpara>Performance is measured by measuring the runtime of tests, we should later setup performance measurements similar to the performance tests.</simpara>
+</section>
+</section>
+<section xml:id="proposals-verify-existence-of-proposals">
+<title>proposals – Verify Existence of Proposals</title>
+<simpara>In general, one could verify if certain proposals are present or not present, and in which order they are present. This is verified by the <literal>proposals</literal> argument.</simpara>
+<simpara>E.g.</simpara>
+<screen>// XPECT contentAssistList at 'a.&lt;|&gt;methodA' proposals --&gt; &lt;$stringProposals&gt;, methodA2
+a.methodA</screen>
+<simpara>Additional flags:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>Order modifier:</simpara>
+<informaltable tabstyle="horizontal" frame="none" colsep="0" rowsep="0">
+<tgroup cols="2">
+<colspec colwidth="15*"/>
+<colspec colwidth="85*"/>
+<tbody valign="top">
+<row>
+<entry>
+<simpara>unordered</simpara>
+</entry>
+<entry>
+<simpara>by default</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>ordered</simpara>
+</entry>
+<entry>
+<simpara>the given expectations have to have that order, between these expectations other proposals may be present (in case of contains)</simpara>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+</listitem>
+<listitem>
+<simpara>Subset modifier:</simpara>
+<informaltable tabstyle="horizontal" frame="none" colsep="0" rowsep="0">
+<tgroup cols="2">
+<colspec colwidth="15*"/>
+<colspec colwidth="85*"/>
+<tbody valign="top">
+<row>
+<entry>
+<simpara>exactly</simpara>
+</entry>
+<entry>
+<simpara>(default, maybe changed later) no other expectations as the given ones (usually <literal>contains</literal>   is recommended).</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>contains</simpara>
+</entry>
+<entry>
+<simpara>at least the given expectations must be present, but others may be there as well.</simpara>
+<simpara>Using <emphasis>contains</emphasis> must be used with care since we match items by searching for a proposal which contains one of the expected strings as a substring. So if the only available proposal were ’methodA2’ and we would test if proposals contain ’methodA’, ’methodA2’ we would obtain a passing test.</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>not</simpara>
+</entry>
+<entry>
+<simpara>any of the given proposals must be NOT be proposed</simpara>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+</listitem>
+</itemizedlist>
+</section>
+<section xml:id="sec:Verify_displayed_string">
+<title>display – Verify displayed string</title>
+<simpara>We do not verify the text style. We only verify text:</simpara>
+<screen>// XPECT contentAssistList at 'a.&lt;|&gt;methodA' display 'methodA2' --&gt; 'methodA2(): any - A'
+a.methodA</screen>
+<simpara>This kind of test should be only applied for few scenarios, because the long display tests are rather hard to maintain.</simpara>
+</section>
+<section xml:id="sec:Apply_Proposal">
+<title>apply – Apply Proposal</title>
+<simpara>Execution of proposal, the expectation describes the expected text result. The tests follow the naming convention of Ending in …Application.</simpara>
+<simpara>Additional flags:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>insertion mode</simpara>
+<informaltable tabstyle="horizontal" frame="none" colsep="0" rowsep="0">
+<tgroup cols="2">
+<colspec colwidth="15*"/>
+<colspec colwidth="85*"/>
+<tbody valign="top">
+<row>
+<entry>
+<simpara>insert</simpara>
+</entry>
+<entry>
+<simpara>(default) Ctrl not pressed, proposal is inserted at given location</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>override</simpara>
+</entry>
+<entry>
+<simpara>Ctrl is pressed, proposal overrides selection.</simpara>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+</listitem>
+</itemizedlist>
+<simpara>Single line assumes change at line of initial cursor position:</simpara>
+<screen>// XPECT contentAssist at 'a.&lt;|&gt;methodA' apply 'methodA2' --&gt; a.methodA2()methodA
+// XPECT contentAssist at 'a.&lt;|&gt;methodA' apply 'methodA2' insert --&gt; a.methodA2()methodA
+// XPECT contentAssist at 'a.&lt;|&gt;methodA' apply 'methodA2' override --&gt; a.methodA2()
+a.methodA</screen>
+<simpara>or</simpara>
+<screen>// XPECT quickFix at 'a.&lt;|&gt;method' apply 'methodA2' --&gt; a.methodA2();
+a.methodTypo();</screen>
+<simpara>Multiline expectations describe changes to the whole. In order to match the expectation context information around the relevant places must be given. The format is similar to a unified diff with a special rule for inline-changes. The comparison works in a line-based mode. Each line in the expectation is prefixed with one character of ’+’, ’|’, ’-’ or ’ ’. Inserted lines are marked with + and removed lines with -. Lines marked with | denote changes in the line. Difference is placed inline inside of a pair of square brackets with a | separating the removal on the left and the addition on the right.</simpara>
+<screen>/* XPECT contentAssistList at 'a.me&lt;|&gt;thodA' apply 'methodA2' ---
+&lt;...&gt;
+import A from "a/b/c"
+&lt;...&gt;
+a.methodA2()&lt;|&gt;methodA
+&lt;...&gt;
+--- */
+a.methodA</screen>
+<screen>/* XPECT contentAssistList at 'a.me&lt;|&gt;thodA' apply 'methodA2' ---
+ import B from "p/b"
++import A from "a/b/c"
+
+ ...
+ foo() {
+|a.[me|thodA2()]
+ }
+ ...
+--- */
+a.methodA</screen>
+<section xml:id="resource-application-in-other-files">
+<title>resource – application in other files</title>
+<simpara>The resource parameter is available for the quickfix xpect method. It specifies the target resource of the quickfix. (e.g. change declaration of type in another file to quickfix an issue).</simpara>
+<screen>/* XPECT quickFix at 'sameVendor.protected&lt;|&gt;Method()' apply 'Declare member as public, @Internal' resource='../../otherProject/src/other_file.n4js' ---
+diff here
+---
+*/</screen>
+<simpara>The syntax is similar to a normal multiline quickfix xpect test besides the addition of the resource parameter. The relative path points to a file in the same workspace as the test file. Note that the path refers to the folder structure specified in the XPECT SETUP header. It is relative to the folder the test file is contained in.<?asciidoc-br?>
+<?asciidoc-br?>
+The diff is between the specified resource before and after the application of the quickfix<?asciidoc-br?>
+<?asciidoc-br?>
+Note that the fileValid (<link linkend="fileValidVerify-validation-status">Verify Validation Status</link>) parameter is not applicable to an extern resource.</simpara>
+</section>
+</section>
+<section xml:id="sec:Content_Assist_Cycling">
+<title>kind – Content Assist Cycling</title>
+<simpara>We assume the default kind to be ’n4js’. It is possible to select a proposal kind in the test set up or via the argument <literal>kind</literal> in the test.</simpara>
+<simpara>Select kind in test setup:</simpara>
+<screen>/* XPECT_SETUP
+content_assist_kind = 'recommenders'
+END_SETUP */</screen>
+<simpara>Select kind in test:</simpara>
+<screen>// XPECT contentAssistList kind 'smart' at 'a.&lt;|&gt;methodA' display 'methodA2' --&gt; 'methodA2(): any - A'
+a.methodA</screen>
+</section>
+<section xml:id="fileValidVerify-validation-status">
+<title>fileValid – Verify validation status</title>
+<simpara>In some cases, in particular in case of quick fix tests, the file should be valid after the proposal has been applied. This is added by an additional argument <literal>fileValid</literal>.</simpara>
+<simpara>E.g.,</simpara>
+<screen>// XPECT quickFix at 'a.&lt;|&gt;method' apply 'methodA2' fileValid --&gt; a.&lt;|&gt;methodA2();
+a.methodTypo();</screen>
+</section>
+</section>
+<section xml:id="sec:Apply_Proposal_And_Execute_Tests" role="language-n4js">
+<title>Apply Proposal And Execute Tests</title>
+<simpara>If a proposal fixes all issues in a test file, the file could be executed. This is an important type of test, as this is what the user expects in the end. Besides, this type of test is very robust, as it does not depend on the concrete way how an issue is fixed. For quick fixes, these kind of tests are to be implemented!</simpara>
+<simpara>The following combined proposal and execute tests are provided:</simpara>
+<informaltable tabstyle="horizontal" frame="none" colsep="0" rowsep="0">
+<tgroup cols="2">
+<colspec colwidth="15*"/>
+<colspec colwidth="85*"/>
+<tbody valign="top">
+<row>
+<entry>
+<simpara>quickFixAndRun</simpara>
+</entry>
+<entry>
+<simpara>applies a quick fix, verifies that all issues are solved, and executes the file.</simpara>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+<simpara>These tests are basically execution tests, that is the expectation describes the expected output of the script.</simpara>
+<simpara>E.g.</simpara>
+<screen>// XPECT quickFixAndRun at 'a.&lt;|&gt;method' apply 'methodHelloWorld' --&gt; Hello World
+a.methodTypo();</screen>
+<simpara>with <literal>methodHelloWorld</literal> printing <literal>’Hello World’</literal> to the console. The expected output can be multiline:</simpara>
+<screen>/* XPECT quickFixAndRun at 'a.&lt;|&gt;method' apply 'methodHelloWorld' ---
+Hello World
+--- */
+a.methodTypo();</screen>
+</section>
+<section xml:id="sec:Organize_Imports_Test" role="language-n4js">
+<title>Organize Imports Test</title>
+<simpara>For testing organise imports a Plugin-UI test method is available. It operates in two modes. Either a successful application of organise imports is tested or the expected abortion is checked.</simpara>
+<section xml:id="organizeimports">
+<title>organizeImports</title>
+<informaltable tabstyle="horizontal" frame="none" colsep="0" rowsep="0">
+<tgroup cols="2">
+<colspec colwidth="15*"/>
+<colspec colwidth="85*"/>
+<tbody valign="top">
+<row>
+<entry>
+<simpara>Definition</simpara>
+</entry>
+<entry>
+<simpara>Multi line:</simpara>
+<screen>/* XPECT organizeImports ---
+~Failure given by line-syntax starting with two characters:~
++ additional line
+| line with inplace[removed part|added part]
++ removed line
+  unchanged line
+--- */
+// XPECT warnings --&gt; "The import of A is unused." at "A"
+import A from "a/a1/A"
+...
+}</screen>
+<simpara>Single line:</simpara>
+<screen>// XPECT organizeImports ambiguous '~Failure String of Exception~'--&gt;
+}</screen>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Provided by</simpara>
+</entry>
+<entry>
+<simpara><literal>OrganizeImportXpectMethod</literal></simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Description</simpara>
+</entry>
+<entry>
+<simpara>Checks that the resulting source-file differs in the described way. The Multiline variant checks the result of a successful application of organise import to the file. All errors and warnings prior to organising imports must be marked as the appropriate XPECT-error or warning.</simpara>
+<simpara>The single-line notation checks the failure of an fully automatic reorganisation of the imports due to some reason. The reason is verified to be the given string after the <literal>ambiguous</literal> keyword. The expectation side (right of <literal>-&#8594;</literal>) is empty.</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Example</simpara>
+</entry>
+<entry>
+<screen>/* XPECT_SETUP org.eclipse.n4js.tests.N4JSXpectPluginUITest
+   Workspace {
+     Project "P1" {
+        Folder "src" {
+            Folder "a" {  Folder "a1" { File "A.n4js" { from="../../a/a1/A.n4js" } }
+                            Folder "c"  { ThisFile {} }  }  }
+        File "package.json" { from="package_p1.json" }  }  }
+   END_SETUP
+*/
+
+/* XPECT organizeImports ---
+
+ | import [A from "a/a1/A"|]
+ | [import|] AR from "a/a1/A"
+   export public role BRole with AR {
+   }
+--- */
+// XPECT warnings --&gt; "The import of A is unused." at "A"
+import A from "a/a1/A"
+import AR from "a/a1/A"
+
+// XPECT noerrors --&gt; "Couldn't resolve reference to Type 'AR'."
+export public role BRole with AR {
+}</screen>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+</section>
+</section>
+<section xml:id="sec:Access_Control_Test" role="language-n4js">
+<title>Access Control Test</title>
+<simpara>Access control refers to the decision whether or not a member or a top level element is accessible for a client. In this context, access refers to reading, writing, and calling a member or a top level function, and to overriding inherited members in classes and interfaces. In N4JS, access is controlled via modifiers at the type and at the member level. Due to the large number of such modifiers and the large number of different scenarios for access control, manually written tests can only cover a small number of actual scenarios. An automatic test generator helps to increase the test coverage for access control.</simpara>
+<simpara>The test generator loads test scenarios from a CSV table that also contains the expected results of each test case and then generates N4JS projects and code for each test case, compiles them using the headless compiler, and compares the compilation results to the expectations from the CSV table. Note that the test generator does not generate test cases that check access control for top level functions and variables.</simpara>
+<section xml:id="test-scenarios">
+<title>Test Scenarios</title>
+<simpara>Each test scenario consists of a scenario specifier (one of <literal>Extends</literal>  , <literal>Implements</literal>  , <literal>References</literal>  ), a supplier and a client (each of which can be a class, and abstract class, an interface, or an interface with default implementations of its getters, setters, and methods). Thereby, the client attempts to access a member of the supplier either by reading, writing, or calling it or by overriding it in the case of an <literal>Extends</literal>   or <literal>Implements</literal>   scenario. Furthermore, each test cases specifies the location of the client in relation to the location of the supplier, e.g., whether the client is in the same module, or whether it is in the same project (but not the same module), and so forth. Finally, a test case must specify the access control modifiers of the supplier type and the member that is being accessed by the client, whether that member is static or not, and, lastly, the type of access that is being attempted.</simpara>
+</section>
+<section xml:id="n4js-code-generator">
+<title>N4JS Code Generator</title>
+<simpara>The test generator needs to generate N4JS projects and modules that implement a particular test case. For this purpose, it uses a simple code generator, available in the package <literal>org.eclipse.n4js.tests.codegen</literal>. The classes in that package allow specifying N4JS projects, modules, classes, and members in Java code and to generate the required artifacts as files at a given location.</simpara>
+</section>
+<section xml:id="xtext-issue-matcher">
+<title>Xtext Issue Matcher</title>
+<simpara>To match the test expectations from the CSV file against the issues generated by the compiler, the test generator uses a small library of issue matchers, available in the package <literal>org.eclipse.n4js.tests.issues</literal>. The classes in that package make it easy to specify expectations against Xtext issues programmatically and to evaluate these expectations against a specific set of Xtext issues. Mismatches, that is, unexpected issues as well as unmatched expectations, are explained textually. These explanations are then shown in the failure notifications of the test case generator.</simpara>
+<simpara>The test expectations allow for FIXME annotations in the CSV table to express cases where an access control error has been found, but hasn’t been fixed yet. Such expectations lead to inverted expectations against the generated issues: For example, if a test expects an attempted access to fail with an error, but the validation rules allow the access regardless, then a FIXME annotation at the test will invert the actual expectation: Where previously an error was expected, there must now be no error at all. Then, once the validation rules have been adjusted and the error occurs as expected, the FIXME test case will fail until the FIXME annotation has been removed. Therefore, the issue expectation matchers can be inverted and adjust their behavior accordingly.</simpara>
+</section>
+</section>
+<section xml:id="sec:Smoke_Tests" role="language-n4js">
+<title>Smoke Tests</title>
+<simpara>Smoke tests are useful to ensure the robustness of the IDE. They aim at revealing potential exceptions that may surface to the end user in the IDE or in a headless compile run. Therefore, different permutations of a given input document are fed into processing components such as the validator or the type system. No exceptions may be thrown from these components.</simpara>
+<simpara>Since smoke tests are longrunning, it is not desired to execute them with each Maven run. That’s why the naming convention <literal>*  Smoketest</literal> was choosen. It will not be matched by the naming pattern for normal JUnit tests during a maven run.</simpara>
+<simpara>The smoke tests are generally created by using the (valid or invalid) input of existing test cases. Therefore, the a command line argument <literal>-DSmokeTestWriter=true</literal> may be passed to the VM that executes a test. All input documents that are processed by a <literal>ParseHelper&lt;Script&gt;</literal> will be written to a new test method on the console. The result can be merged manually into the <literal>GeneraredSmoketest</literal>.</simpara>
+<section xml:id="how-to-handle-smoke-test-errors">
+<title>How to handle smoke test errors?</title>
+<simpara>If a smoke test fails, the concrete input should be extracted into a dedicated error test case. The existing classes like <literal>scoping.ErrorTest</literal> should be used to add the broken input document and create fast running cases for them. For that purpose, the <literal>ExceptionAnalyzer</literal> can be used. Such a test case will usually look like this:</simpara>
+<screen>@Test
+def void testNoNPE_03() {
+    val script = ``  '
+        var target = {
+            s: "hello",
+            set x
+    ``  '.parse
+    analyser.analyse(script, "script", "script")
+}</screen>
+</section>
+<section xml:id="smoketester-and-exceptionanalyzer">
+<title>SmokeTester and ExceptionAnalyzer</title>
+<simpara>The components that are used to implemement the smoke tests are the <literal>SmokeTester</literal> and the <literal>ExceptionAnalyzer</literal>. The smoke tester performs the permutation of the characters from the input model whereas the analyzer does the heavy lifting of passing the parsed model to various components such as the type system or the validation. Both utilities can be used to add either new smoke test documents or to check for the robustness of an implementation. It’s espeically useful to use the ExceptionAnalyzer in conjunction with existing test suites like the <literal>LibraryParsingTestSuite</literal> since it can be used instead of the other utilities like the <literal>PositiveAnalyzer</literal> or the <literal>NegativeAnalyzer</literal>.</simpara>
+</section>
+</section>
+<section xml:id="sec:UI_Tests_with_SWTBot" role="language-n4js">
+<title>UI Tests with SWTBot</title>
+<simpara>For testing functionality from the end-user perspective we use UI tests based on SWTBot <link xl:href="http://eclipse.org/swtbot/">http://eclipse.org/swtbot/</link>.</simpara>
+<simpara>Since UI tests are usually rather fragile, it was decided to keep the number of these tests as low as possible. The main purpose of these tests is to ensure that the most fundamental IDE functionality is working properly, e.g. creating an N4JS project, creating a new N4JS file, running N4JS code in node.js.</simpara>
+<simpara>The tests have a number of SWTBot dependencies. For details, please refer to the latest target platform definition file.</simpara>
+<section xml:id="writing-swtbot-tests">
+<title>Writing SWTBot Tests</title>
+<simpara>The implementation is contained in bundle <literal>org.eclipse.swtbot.tests</literal>. Writing SWTBot tests is straightforward; see source code of <literal>AbstractSwtBotTest</literal> for usage and examples.</simpara>
+<simpara>Some hints:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>Many methods of the SWTBot framework already include assertions. For example, the method <literal>#  menu(String)</literal> to find a particular menu or menu item will assert that the item was found and otherwise throw an exception. Therefore, it is safe to write code like:</simpara>
+<screen>bot.menu("File").menu("New").menu("Project...").click();</screen>
+</listitem>
+<listitem>
+<simpara>It is usually considered bad practice to use sleep delays in UI tests. Instead, wait for the element to appear using methods such as <link xl:href="http://download.eclipse.org/technology/swtbot/helios/dev-build/apidocs/org/eclipse/swtbot/swt/finder/SWTBot.html#waitUntil">http://download.eclipse.org/technology/swtbot/helios/dev-build/apidocs/org/eclipse/swtbot/swt/finder/SWTBot.html#waitUntil</link> or <link xl:href="http://download.eclipse.org/technology/swtbot/helios/dev-build/apidocs/org/eclipse/swtbot/swt/finder/SWTBot.html#waitWhile">http://download.eclipse.org/technology/swtbot/helios/dev-build/apidocs/org/eclipse/swtbot/swt/finder/SWTBot.html#waitWhile</link>.</simpara>
+</listitem>
+</itemizedlist>
+</section>
+<section xml:id="running-swtbot-tests">
+<title>Running SWTBot Tests</title>
+<simpara>To run the tests locally in Eclipse just right-click the bundle and select <literal>Run As &gt; SWTBot Test</literal>  . To run them locally via maven simply start a normal maven build, no additional command line arguments, etc. required.</simpara>
+<simpara>To run remotely in a Jenkins build: on Windows the build must be executed with a logged-in user; on Linux Xvfb and a window manager are required. The recommended window manager is metacity. More information can be found here: <link xl:href="http://wiki.eclipse.org/SWTBot/Automate_test_execution">http://wiki.eclipse.org/SWTBot/Automate_test_execution</link>.</simpara>
+<simpara>To use metacity, add the following pre-build shell command to the Jenkins build configuration:</simpara>
+<programlisting language="bash" linenumbering="unnumbered">sleep 5; metacity --replace --sm-disable &amp;</programlisting>
+<simpara>The sleep is required because metacity depends on Xvfb to be fully initialized, which might take a moment on slower build nodes. The following Jenkins console log shows the expected output when starting Xvfb and metacitiy:</simpara>
+<programlisting language="bash" linenumbering="unnumbered">Xvfb starting$ Xvfb :1 -screen 0 1024x768x24 -fbdir /var/lib/build/2014-09-05_10-36-343337290231975947044xvfb
+[N4JS-IDE_Oliver] $ /bin/sh -xe /tmp/hudson4475531813520593700.sh
++ sleep 5
++ metacity --replace --sm-disable
+Xlib:  extension "RANDR" missing on display ":1.0".
+Window manager warning: 0 stored in GConf key /desktop/gnome/peripherals/mouse/cursor_size is out of range 1 to 128
+Process leaked file descriptors. See http://wiki.jenkins-ci.org/display/JENKINS/Spawning+processes+from+build for more information
+Parsing POMs
+...</programlisting>
+<simpara>The warnings and error messages in the above log are expected and are considered unharmful (cf. discussion with Jörg Baldzer).</simpara>
+</section>
+</section>
+<section xml:id="sec:Debugging_UI_Tests">
+<title>Debugging UI Tests</title>
+<simpara>In rare cases UI Tests behave differently depending on the underlying OS und the power of the test machine. Missing user interaction on the build-server often results in waiting processes which in turn get a timeout request from the driving unit-testing-framework. To investigate the UI state on the build node a X11 connection needs to established.</simpara>
+<section xml:id="sec:Connecting_to_the_X_server_on_the_build_node">
+<title>Connecting to the X-server on the build-node</title>
+<simpara>First a vnc server needs to be started on the build-node. This is done via <literal>x11vnc -display :1 -shared &gt;  /x11vnc.log 2&gt;&amp;1 &amp;</literal> as a pre-build shellscript-step in Jenkins.</simpara>
+<simpara>You can narrow down the build to run on a specific node in Jenkins if a repeatable environment is required otherwise the current build-node is listed in the overview page. For security reasons the connection needs to be tunneld through an ssh login:</simpara>
+<programlisting language="bash" linenumbering="unnumbered">ssh -l viewer -L 5900:localhost:5900 build-linux-25 ’x11vnc -localhost -display :1</programlisting>
+<simpara>Here we are using the mating <literal>build-linux-25</literal> with the generic user/password ’viewer’ to start the program <literal>x11vnc</literal>. For the actual display number – <literal>:1</literal> in this case – you can refer to the console output. The command above tunnels the default vnc port 5900. You can now connect on <literal>localhost</literal> with a vnc client. If the user is not available, the <literal>x11vnc</literal> program not installed or in case of other issues, ask the build-and-release team.</simpara>
+<simpara>To display the screen you can use any arbitrary vnc-client (on mac there is screen sharing, in theory just opened from the command line by hitting <literal>open vnc://viewer:viewer@localhost:5900</literal>). One working client is ’chicken of the vnc’ <link xl:href="http://sourceforge.net/projects/cotvnc/">http://sourceforge.net/projects/cotvnc/</link></simpara>
+</section>
+<section xml:id="sec:Tools_to_investigate_the_java_stack">
+<title>Tools to investigate the java-stack</title>
+<simpara>Unix and Java come with some useful programs for investigations. The following tools may need some advanced rights to see processes from other users.</simpara>
+<itemizedlist>
+<listitem>
+<simpara><literal>htop</literal> enhanced top to see all currently running processes</simpara>
+</listitem>
+<listitem>
+<simpara><literal>jps</literal> list running java processes</simpara>
+</listitem>
+<listitem>
+<simpara><literal>jstack</literal> investigate running java process</simpara>
+</listitem>
+</itemizedlist>
+</section>
+</section>
+</chapter>
+<chapter xml:id="_ui-concepts">
+<title>UI Concepts</title>
+<warning>
+<simpara>Parts of this chapter may be outdated.</simpara>
+</warning>
+<section xml:id="sec:User_Interface_Concepts" role="language-n4js">
+<title>User Interface Concepts</title>
+<section xml:id="sec:Eclipse_UI_Concepts">
+<title>Eclipse UI Concepts</title>
+<simpara>The following list gives an overview of Eclipse specific UI concepts and which classes are used for implementation.</simpara>
+<section xml:id="sec:Label_Provider">
+<title>Label Provider</title>
+<simpara>Also provides decorations for icons and text labels.</simpara>
+<informaltable tabstyle="horizontal" frame="none" colsep="0" rowsep="0">
+<tgroup cols="2">
+<colspec colwidth="15*"/>
+<colspec colwidth="85*"/>
+<tbody valign="top">
+<row>
+<entry>
+<simpara>Example</simpara>
+</entry>
+<entry>
+<simpara>The representation of objects in the outline view or in search results.</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Eclipse API</simpara>
+</entry>
+<entry>
+<itemizedlist>
+<listitem>
+<simpara><literal>o.e.jface.viewers.ILabelProvider</literal> → without styes</simpara>
+</listitem>
+<listitem>
+<simpara><literal>o.e.jface.viewers.DelegatingStyledCellLabelProvider.IStyledLabelProvider</literal> → with styles Drawback: Depends on Image rather than ImageDescriptor (see below)</simpara>
+</listitem>
+</itemizedlist>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Xtext Specifics</simpara>
+</entry>
+<entry>
+<itemizedlist>
+<listitem>
+<simpara><literal>Declarative API</literal>  via reflective, polymorphic dispatching. <literal>org.eclipse.xtext.ui.label.AbstractLabelProvider</literal></simpara>
+</listitem>
+<listitem>
+<simpara>Allows to work with ImageDescriptors (non-ui-thread, can be composed), but cumbersome</simpara>
+</listitem>
+<listitem>
+<simpara>DefaultLabelProvider will be used everywhere (outline etc.), returns the <literal>name</literal>  (via reflection). You could bind specific label providers.</simpara>
+</listitem>
+<listitem>
+<simpara>DescriptionLabelProvider provides labels for objects from the Xtext index used by <literal>open model element</literal> , <literal>find references</literal>  – the later is already customized)</simpara>
+</listitem>
+</itemizedlist>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Best Practices</simpara>
+</entry>
+<entry>
+<simpara>Labels are often use-case specific, so a single label provider is not always useful Therefore, in Xtext are different label providers for different use cases. Use cases are defined and enumerated (see <literal>DefaultUiModule.configure*Label*</literal>).
++
+Often labels could be easier created where they are needed instead of using a label provider (even for things like OutlineView). (LabelProvider are maybe over-engineered). (Note: default label provider has dependencies to SWT, because it uses images, which are often not needed; also they are only called with an object and no further configuration).
++
+Images:
++</simpara>
+<itemizedlist>
+<listitem>
+<simpara>DeclarativeLabelProvider: text and image (String: path relative to icons folder; or: ImageDescriptor, or Image), put it into folder (needs to be called <literal>icons</literal> , otherwise bind another name)</simpara>
+</listitem>
+<listitem>
+<simpara>better use AbstractLabelProvider and use EMF concepts (easier to debug and handle)</simpara>
+</listitem>
+<listitem>
+<simpara>image format and size: sub-folders with 32, 12, 16, 24, etc. (look which sizes are needed); in about view maybe bigger; png (supports transparency)</simpara>
+</listitem>
+</itemizedlist>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+</section>
+<section xml:id="sec:Markers">
+<title>Markers</title>
+<blockquote>
+<attribution>
+Eclispe Help
+</attribution>
+<simpara>Markers are objects that may be associated with Workbench resources. There are many uses of markers in the Workbench&#8230;&#8203;
+Markers are shown in a marker view (Tasks, Problems or Bookmark view) or on the marker bar in the editor area.</simpara>
+</blockquote>
+<informaltable tabstyle="horizontal" frame="none" colsep="0" rowsep="0">
+<tgroup cols="2">
+<colspec colwidth="15*"/>
+<colspec colwidth="85*"/>
+<tbody valign="top">
+<row>
+<entry>
+<simpara>Examples</simpara>
+</entry>
+<entry>
+<simpara>Tasks, Problems, Bookmarks, Breakpoints, Trace information</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Eclipse API</simpara>
+</entry>
+<entry>
+<simpara><literal>org.eclipse.core.resources.IMarker</literal> and <literal>IResource.findMarkers</literal>
++</simpara>
+<itemizedlist>
+<listitem>
+<simpara>Marker types registered via extension point (basically String). A marker is more or less a Map of String &#8594; String with some meta information, e.g. the resource location in WS, line numbers, type</simpara>
+</listitem>
+<listitem>
+<simpara>Markers are very efficient (e.g., find markers of a certain type), cf Xtext Specifics</simpara>
+</listitem>
+<listitem>
+<simpara>For validation, some new marker types are already registered.</simpara>
+</listitem>
+</itemizedlist>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Xtext</simpara>
+</entry>
+<entry>
+<simpara>(2.6)
++</simpara>
+<itemizedlist>
+<listitem>
+<simpara>Todo-Markers are created during build, task list is populated by these markers.</simpara>
+</listitem>
+<listitem>
+<simpara><literal>org.eclipse.xtext.tasks.ITaskFinder</literal> (and default implementation is bound by default, can be replaced with custom implementation)</simpara>
+</listitem>
+</itemizedlist>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Best Practices</simpara>
+</entry>
+<entry>
+<simpara>In Xtend, markers are used to trace from original file to generated file. They are hidden (and not displayed), so in general markers can be used for non-UI-problems as well (but only available in Eclipse of course) clean up markers: no general solution, often managed by some (single) life-cycle aware class (e.g., Builder)</simpara>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+</section>
+<section xml:id="sec:Commands__Toolbar_and_Menus">
+<title>Commands, Toolbar and Menus</title>
+<informaltable tabstyle="horizontal" frame="none" colsep="0" rowsep="0">
+<tgroup cols="2">
+<colspec colwidth="15*"/>
+<colspec colwidth="85*"/>
+<tbody valign="top">
+<row>
+<entry>
+<simpara>Examples</simpara>
+</entry>
+<entry>
+<simpara>Organize Imports,</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Eclipse API</simpara>
+</entry>
+<entry>
+<simpara>use Commands + Handlers instead of Actions (or ActionDelegates etc.)</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Xtext Specifics</simpara>
+</entry>
+<entry>
+<simpara>uses commands and handlers</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Best Practice</simpara>
+</entry>
+<entry>
+<simpara><emphasis role="strong">Use commands and handlers</emphasis> -
+handler usually only delegates to real thing (that is, retrieve parameters from context and call the real thing)<?asciidoc-br?>
+<emphasis role="strong">Register in pluginxml</emphasis> via ExecutableExtensionFactory to be able to use injection (also pre-generatd, e.g.:</simpara>
+<programlisting language="xml" linenumbering="unnumbered">            &lt;handler class="org.eclipse.n4js.ui.N4JSExecutableExtensionFactory:org.eclipse.xtext.ui.editor.handler.ValidateActionHandler"
+                          commandId="org.eclipse.n4js.N4JS.validate"&gt;</programlisting>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+<simpara><emphasis role="strong">Undo</emphasis>: use TextEdit and MultiTextEdit (composed)<?asciidoc-br?>
+otherwise very low level</simpara>
+</section>
+<section xml:id="sec:Content_Assist">
+<title>Content Assist</title>
+<blockquote>
+<attribution>
+Eclipse Help
+</attribution>
+<simpara>Content assist allows you to provide context sensitive content completion upon user request. Popup windows (infopops) are used to propose possible text choices to complete a phrase. The user can select these choices for insertion in the text. Content assist also supports contextual infopops for providing the user with information that is related to the current position in the document.</simpara>
+</blockquote>
+<informaltable tabstyle="horizontal" frame="none" colsep="0" rowsep="0">
+<tgroup cols="2">
+<colspec colwidth="15*"/>
+<colspec colwidth="85*"/>
+<tbody valign="top">
+<row>
+<entry>
+<simpara>Risk</simpara>
+</entry>
+<entry>
+<simpara>Always needs longer than anticipated.</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Examples</simpara>
+</entry>
+<entry>
+<simpara>complete name of function in function call, complete keywords</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Eclipse API</simpara>
+</entry>
+<entry>
+<itemizedlist>
+<listitem>
+<simpara>IContentAssistant wraps the widget,</simpara>
+</listitem>
+<listitem>
+<simpara>IContentProposalProvider computes the (array of) CompletionProposal (quite cumbersome!).</simpara>
+</listitem>
+<listitem>
+<simpara>Many extension interfaces that provide valuable UI features.</simpara>
+</listitem>
+</itemizedlist>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Xtext Specifics</simpara>
+</entry>
+<entry>
+<itemizedlist>
+<listitem>
+<simpara>ConfigurableCompletionProposal implements the currently defined extension interfaces, provides getters to modify the proposal after the fact.</simpara>
+</listitem>
+<listitem>
+<simpara>Context: The ContentAssistContext is provided by the framework according to the current cursor position in the document (cf. <literal>ContentAssisParser</literal>), semantic context (semantic element) computed with best match strategy (worst case you get the root element). Multiple contexts may be valid at the very same cursor position since the replace region may be different for different proposals.</simpara>
+</listitem>
+<listitem>
+<simpara>Various abstracts above the JFace stuff are available in Xtext, some of the <literal>over the top</literal> , others quite handy.</simpara>
+</listitem>
+</itemizedlist>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Best Practices</simpara>
+</entry>
+<entry>
+<itemizedlist>
+<listitem>
+<simpara>List of follow elements can be supposed to be complete, no need to figure out them with regular expressions etc.</simpara>
+</listitem>
+<listitem>
+<simpara>in rare cases it is necessary to <literal>manually</literal>  scan the text context, e.g. to get the variable name based on the variable type. → we will provider a utility class for that using regex. NEVER search on the text with simple string methods.</simpara>
+</listitem>
+<listitem>
+<simpara>In N4JSProposalProvider, override pre-generated methods (see <literal>AbstractN4JSProposalProvider</literal>) – do not overload (with concrete semantic element)</simpara>
+</listitem>
+<listitem>
+<simpara>how to implement complete-methods:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>inspect context, examine current semantic element provide elements from scope or hard coded proposal: see <xref linkend="sec:Proposals"/></simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+</itemizedlist>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+</section>
+<section xml:id="sec:Quick_Fixes">
+<title>Quick Fixes</title>
+<blockquote>
+<attribution>
+Eclipse Help
+</attribution>
+<simpara>Users can select a problem marker and choose a Quick Fix from a popup containing the list of supplied fixes contributed for the marker.</simpara>
+</blockquote>
+<informaltable tabstyle="horizontal" frame="none" colsep="0" rowsep="0">
+<tgroup cols="2">
+<colspec colwidth="15*"/>
+<colspec colwidth="85*"/>
+<tbody valign="top">
+<row>
+<entry>
+<simpara>Examples</simpara>
+</entry>
+<entry>
+<simpara>Add Import, Add Override Annotation</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Eclipse API</simpara>
+</entry>
+<entry>
+<simpara>Based on ICompletionProposal (powerful)
++</simpara>
+<itemizedlist>
+<listitem>
+<simpara>QuickFixes are registered to marker (marker attribute: is fixable or not – this attribute is a guess only, there does not need to be a quick fix)</simpara>
+</listitem>
+<listitem>
+<simpara>MarkerResolutionGenerator (can also be used to fix several markers at once)</simpara>
+</listitem>
+</itemizedlist>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Xtext Specifics</simpara>
+</entry>
+<entry>
+<simpara>Based on ISematicModification (seemingly powerful but in fact weak) and IModification (less weak, but still very weak compared to ICompletionProposal) – only creates DocumentChanges.
++
+Declarativ API that links to issue codes via annotations on 'fix' methods in AbstractDeclarativeQuickfixProvider.</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Best Practices</simpara>
+</entry>
+<entry>
+<simpara>ICompletionProposal vs. DocumentChanges, ICompletionProposal is much more powerful. IModifications can also provide semantic changes, but not really recommended
++</simpara>
+<itemizedlist>
+<listitem>
+<simpara>Associated to isses via IssueCodes, @Fix similar to @Check API – only less powerful Xtext abstraction (no ICompletionProposal)</simpara>
+</listitem>
+<listitem>
+<simpara>use issue data to provide hints for fix labels (which should be fast!) or solution strategies (but only strings) → do not compute the label for the fix from the model!</simpara>
+</listitem>
+<listitem>
+<simpara>share code between checks and fixes → no built-in pattern, come up with utility methods (maybe define conventions)</simpara>
+</listitem>
+<listitem>
+<simpara>maybe Sebastian can add a solution that more information is available via @Fix-approach</simpara>
+</listitem>
+<listitem>
+<simpara>no order of quickfixes (sorted by name and priority, latter is not provided by default)</simpara>
+</listitem>
+<listitem>
+<simpara>there can be several @Fix for a single issue code, or pass arbitrary number of resolution to the acceptor</simpara>
+</listitem>
+<listitem>
+<simpara>for most cases simple Xtext quick fix api is good enough (e.g. all Xtend quick fixes use that)
++
+→ Xtext feature request: solve multiple markers at a time (possible to do that right now: bind custom <literal>XtextQuickAssistProcessor</literal>, override <literal>MarkerResolutionGenerator.getAdaptedResolutions(List&lt;IssueResolution&gt;</literal>) – return a WorkbenchMarkerResolution)</simpara>
+</listitem>
+</itemizedlist>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+</section>
+<section xml:id="sec:Quick_Assist">
+<title>Quick Assist</title>
+<blockquote>
+<simpara>"Quick assists perform local code transformations. They are invoked on a selection or a single cursor in the Java editor and use the same shortcut as quick fixes (Ctrl+1), but quick assist are usually hidden when an error is around. To show them even with errors present on the same line, press Ctrl+1 a second time."  (Eclipse Help)</simpara>
+</blockquote>
+<simpara><literal>like a quickfix without a problem</literal></simpara>
+<informaltable tabstyle="horizontal" frame="none" colsep="0" rowsep="0">
+<tgroup cols="2">
+<colspec colwidth="15*"/>
+<colspec colwidth="85*"/>
+<tbody valign="top">
+<row>
+<entry>
+<simpara>Examples</simpara>
+</entry>
+<entry>
+<simpara>Add/remove inferred types</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Eclipse API</simpara>
+</entry>
+<entry>
+<simpara>Takes cursor position</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Xtext</simpara>
+</entry>
+<entry>
+<simpara>no Xtext support, e.g. no default implementation (XtextQuickAssistProcessor is a quick fix provider, has nothing to do with QuickAssist) but: XtextQuickAssistProcessor, override canAssist, override computeQuickAssistProposals</simpara>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+</section>
+<section xml:id="sec:Clean_Up_Actions">
+<title>Clean Up Actions</title>
+<informaltable tabstyle="horizontal" frame="none" colsep="0" rowsep="0">
+<tgroup cols="2">
+<colspec colwidth="15*"/>
+<colspec colwidth="85*"/>
+<tbody valign="top">
+<row>
+<entry>
+<simpara>Examples</simpara>
+</entry>
+<entry>
+<simpara>Remove unused local vars, sort members</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Eclipse API</simpara>
+</entry>
+<entry>
+<simpara>None, JDT specific (see ICleanUp)</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Xtext Specifics</simpara>
+</entry>
+<entry>
+<simpara>None</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Best Practice</simpara>
+</entry>
+<entry>
+<simpara>Monkey sees - Monkey does (look at JDT), In the end a it’s a CompositeRefactoring, which is a CompletionProposal</simpara>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+</section>
+<section xml:id="sec:Save_Actions">
+<title>Save Actions</title>
+<simpara>Similar to clean up actions but performed on save</simpara>
+<informaltable tabstyle="horizontal" frame="none" colsep="0" rowsep="0">
+<tgroup cols="2">
+<colspec colwidth="15*"/>
+<colspec colwidth="85*"/>
+<tbody valign="top">
+<row>
+<entry>
+<simpara>Examples</simpara>
+</entry>
+<entry>
+<simpara>Format on save, Organize imports on save</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Eclipse API</simpara>
+</entry>
+<entry>
+<simpara>None, JDT specific (see IPostSaveListener)</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Xtext Specifics</simpara>
+</entry>
+<entry>
+<simpara>None</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Best Practice</simpara>
+</entry>
+<entry>
+<simpara>XtextDocumentProvider.doSaveDocument (maybe better solutions in the future ;-) )</simpara>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+</section>
+<section xml:id="sec:Auto_Edit">
+<title>Auto Edit</title>
+<simpara>Auto edit is about closing braces that just have been typed, adding indentation after a line break the code snippet <literal>if (true)</literal> so basically it should be unobtrusive typing aids.</simpara>
+<simpara>By default, restore model structure when editing (guide the user to proper text formatting, help the parser). Should not be used for other purposes in order to not hinder the user’s flow of editing.</simpara>
+<informaltable tabstyle="horizontal" frame="none" colsep="0" rowsep="0">
+<tgroup cols="2">
+<colspec colwidth="15*"/>
+<colspec colwidth="85*"/>
+<tbody valign="top">
+<row>
+<entry>
+<simpara>Examples</simpara>
+</entry>
+<entry>
+<simpara>( &#8594; ( &lt;cursor&gt; )</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Eclipse API</simpara>
+</entry>
+<entry>
+<simpara>org.eclipse.jface.text.IAutoEditStrategy</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Xtext Specifics</simpara>
+</entry>
+<entry>
+<simpara>org.eclipse.xtext.ui.editor.autoedit.AbstractEditStrategy, some utility methods + implements VerifyKeyListener. May use the ISourceViewer via implements ISourceViewerAware</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Best Practices</simpara>
+</entry>
+<entry>
+<simpara>Keep it as it is.</simpara>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+<simpara>Fun example but not useful in practice cf. <link xl:href="https://code.google.com/a/eclipselabs.org/p/xtext-forms-integration/source/browse/trunk/plugins/org.eclipse.xtext.example.domainmodel.ui/src/org/eclipse/xtext/example/ui/autoedit/FantasticAutoEditStrategy.java?r=19">FantasticAutoEditStrategy</link></simpara>
+</section>
+<section xml:id="sec:Template_Proposals">
+<title>Template Proposals</title>
+<simpara>More sophisticated edit utils that are invoked by means of content assist.</simpara>
+<informaltable tabstyle="horizontal" frame="none" colsep="0" rowsep="0">
+<tgroup cols="2">
+<colspec colwidth="15*"/>
+<colspec colwidth="85*"/>
+<tbody valign="top">
+<row>
+<entry>
+<simpara>Examples</simpara>
+</entry>
+<entry>
+<simpara>sysout &#8594; System.out.println(<literal>&lt;cursor&gt;</literal> );</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Eclipse API</simpara>
+</entry>
+<entry>
+<simpara>Part of the completion proposal API, e.g. ICompletionProposal</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Xtext Specifics</simpara>
+</entry>
+<entry>
+<simpara>org.eclipse.xtext.ui.editor.contentassist.ITemplateProposalProvider, template contexts along the grammar rules by default, need to be stripped down to become usable.</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Best Practice</simpara>
+</entry>
+<entry>
+<simpara>ship some: create them manually in workbench, export them as XML, fix XML file (add IDs, in Xtext documentation), put XML file in folder <literal>templates</literal>  in UI plugin where propose a certain proposal: customize XtextTemplateContextTypeRegistry (bind subclass, override register context types) – by default too many context types are registered placeholders inside templates specific to Xtext – RTFM</simpara>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+</section>
+<section xml:id="sec:Outline_View___Quick_Outline">
+<title>Outline View / Quick Outline</title>
+<simpara>Structural represenation of the file contents (usually with different filter and sorting strategies).</simpara>
+<informaltable tabstyle="horizontal" frame="none" colsep="0" rowsep="0">
+<tgroup cols="2">
+<colspec colwidth="15*"/>
+<colspec colwidth="85*"/>
+<tbody valign="top">
+<row>
+<entry>
+<simpara>Examples</simpara>
+</entry>
+<entry>
+<simpara>Outline View (but not Navigator nor package explorer), Quick Outline (in Xtext: same provider)</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Eclipse API</simpara>
+</entry>
+<entry>
+<simpara>org.eclipse.ui.views.contentoutline.IContentOutlinePage</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Xtext Specifics</simpara>
+</entry>
+<entry>
+<simpara>Lazy tree creation, syncing via EObject ranges, thread save access to the EObject from nodes. Declarative API to create the tree contents. org.eclipse.xtext.ui.editor.outline.impl.DefaultOutlineTreeProvider
++
+allow actions on outline nodes (e.g., goto referenced file in <literal>import</literal>  of outline)</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Best Practice</simpara>
+</entry>
+<entry>
+<itemizedlist>
+<listitem>
+<simpara>Produced from semantic model, tree structure of outline nodes</simpara>
+<itemizedlist>
+<listitem>
+<simpara>show tree based on TypeModel, maybe filter out elements w/o SyntaxElements (with type model, this should be rather cheap!)</simpara>
+</listitem>
+<listitem>
+<simpara>use icons and styled labels (first user impression!)</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+<listitem>
+<simpara>May run in the background (BackgroundOutlineTreeProvider)</simpara>
+</listitem>
+<listitem>
+<simpara>done lazily</simpara>
+</listitem>
+<listitem>
+<simpara>workflow: reconceiler: outline is a model listener</simpara>
+</listitem>
+</itemizedlist>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+<simpara>Helpful tools for icons in outline view:</simpara>
+<itemizedlist>
+<listitem>
+<simpara><link xl:href="http://marketplace.eclipse.org/content/eclipse-icon-archive-tool">Eclipse view</link> to show available Eclipse icons (that are of course licenced under EPL) with possibility to export them (<link xl:href="http://bwgz-org.googlecode.com/files/EclipseIconArchiveTool-1.pdf">documentation</link>)</simpara>
+</listitem>
+<listitem>
+<simpara>overview of Eclipse icons: <link xl:href="http://eclipse-icons.i24.cc/">http://eclipse-icons.i24.cc/</link></simpara>
+</listitem>
+</itemizedlist>
+</section>
+<section xml:id="sec:Navigator__Package_Explorer__Project_Explorer">
+<title>Navigator, Package Explorer, Project Explorer</title>
+<simpara>three <literal>explorers</literal> , Navigator <literal>latest</literal>  and most extensible one</simpara>
+<informaltable tabstyle="horizontal" frame="none" colsep="0" rowsep="0">
+<tgroup cols="2">
+<colspec colwidth="15*"/>
+<colspec colwidth="85*"/>
+<tbody valign="top">
+<row>
+<entry>
+<simpara>Best Practices</simpara>
+</entry>
+<entry>
+<simpara>use Navigator only! (RTFM, nothing specific to Xtext yet)</simpara>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+<simpara>cf. <link xl:href="http://projects.eclipse.org/projects/technology.handly">http://projects.eclipse.org/projects/technology.handly</link> <literal>read index and show it in the navigator</literal></simpara>
+</section>
+<section xml:id="sec:Hyperlinking_and_Navigation">
+<title>Hyperlinking and Navigation</title>
+<simpara>Linking (propose multiple linking targets, e.g. goto declaration or goto implementation when CTRL (or other modifier) + Left Mouse Click on method when receiver type is interface - show all available implementations)</simpara>
+<informaltable tabstyle="horizontal" frame="none" colsep="0" rowsep="0">
+<tgroup cols="2">
+<colspec colwidth="15*"/>
+<colspec colwidth="85*"/>
+<tbody valign="top">
+<row>
+<entry>
+<simpara>Examples</simpara>
+</entry>
+<entry>
+<simpara>Go to declaration, Go to implementation, Go to super</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Eclipse API</simpara>
+</entry>
+<entry>
+<simpara>org.eclipse.jface.text.hyperlink.IHyperlinkDetector</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Xtext Specifics</simpara>
+</entry>
+<entry>
+<simpara>org.eclipse.xtext.ui.editor.hyperlinking.DefaultHyperlinkDetector, navigation to EObject URI most interesting: SIGNIFICANT cf. org.eclipse.xtext.resource.ILocationInFileProviderExtension.RegionDescription</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Best Practice</simpara>
+</entry>
+<entry>
+<itemizedlist>
+<listitem>
+<simpara>subclass and bind IHyperlinkHelper (returns an array of possible links, first one is the default)</simpara>
+</listitem>
+<listitem>
+<simpara>also see ILocationInFileProviderExtension (cf. navigation to syntax elements instead of types)</simpara>
+</listitem>
+</itemizedlist>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+</section>
+<section xml:id="sec:Syntax_and_Semantic_Coloring">
+<title>Syntax and Semantic Coloring</title>
+<simpara>Coloring based on the lexical tokens or based on the semantic tokens (the parsed model). The parser may treat certain lexical keywords as valid identifiers in some contexts. Some of those should not appear as keywords. Semantic coloring is usually more expensive to compute thus run in the background and with some delay</simpara>
+<informaltable tabstyle="horizontal" frame="none" colsep="0" rowsep="0">
+<tgroup cols="2">
+<colspec colwidth="15*"/>
+<colspec colwidth="85*"/>
+<tbody valign="top">
+<row>
+<entry>
+<simpara>Examples</simpara>
+</entry>
+<entry>
+<simpara>Numbers, String literals (lexical) Escape sequences in Strings, method calls, property read / write access (semantic)</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Eclipse API</simpara>
+</entry>
+<entry>
+<simpara><literal>org.eclipse.jface.text.presentation.IPresentationDamager</literal> <literal>org.eclipse.jface.text.presentation.IPresentationRepairer</literal> <literal>org.eclipse.jface.text.rules.ITokenScanner</literal>
++
+Scan for tokens and associate text attributes with tokens. Compute the region of the document that has to be recolored after a text change. Tokens may not overlap.
++
+Also Eclipse provides Themes that are styled via CSS. Coloring can be adjusted to themes where the logical names are mapped to different default values.</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Xtext Specifics</simpara>
+</entry>
+<entry>
+<itemizedlist>
+<listitem>
+<simpara><literal>o.e.x.ui.editor.syntaxcoloring.ITextAttributeProvider</literal> - associate Antlr token names with coloring styles (logical names of text coloring)</simpara>
+</listitem>
+<listitem>
+<simpara><literal>o.e.x.ui.editor.syntaxcoloring.AbstractAntlrTokenToAttributeIdMapper</literal>- convert the antlr tokens to JFace ITokens with proper text applied</simpara>
+</listitem>
+<listitem>
+<simpara><literal>o.e.x.ui.editor.syntaxcoloring.IHighlightingConfiguration</literal> - register logical text colorings with default values, yields a preference page and the proper configuration for the text attribute provider</simpara>
+</listitem>
+<listitem>
+<simpara><literal>o.e.x.ui.editor.syntaxcoloring.ISemanticHighlightingCalculator</literal> - traverse the AST and associate arbitrary ranges of the text with.</simpara>
+</listitem>
+<listitem>
+<simpara>logical coloring names (this is a key to a style stored in the preference store), if multiple styles are returned, styles will be merged if they overlap (and if possible); JFace constraints are implicitly fulfilled</simpara>
+</listitem>
+</itemizedlist>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Best Practice</simpara>
+</entry>
+<entry>
+<itemizedlist>
+<listitem>
+<simpara>subclass DefaultSemanticHighlightingCalculator and bind ISemanticHighlightingCalculator</simpara>
+<itemizedlist>
+<listitem>
+<simpara>traverse resource from left to right (usually order of semantic elements – small performance improvement)</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+<listitem>
+<simpara>provide new logical style: subclass DefaultHighlightingConfiguration and bind IHighlightingConfiguration; override configure (see overridden)</simpara>
+</listitem>
+<listitem>
+<simpara>semantic coloring always wins</simpara>
+</listitem>
+<listitem>
+<simpara>only a few decisions can me made in lexical coloring, override lexical:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>subclass <literal>DefaultAntlrTokenToAttributeIdMapper</literal> bind <literal>TokenTypeToStringMapper</literal></simpara>
+</listitem>
+<listitem>
+<simpara>e.g., color jsdoc comments differently to multiline, regex</simpara>
+</listitem>
+<listitem>
+<simpara>e.g. color tags inside jsdocs or regex inside, use semantic coloring</simpara>
+</listitem>
+<listitem>
+<simpara>lexical: different kind of keywords (e.g., N4JS keywords vs. JS keywords)</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+<listitem>
+<simpara>change coloring (via toggle button), possible approach:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>(inject singleton into highlighter, state of singleton is changed by toggle button, listen to that object in the editor, calculator cannot be triggered from outside due to UI-thread issues)</simpara>
+</listitem>
+<listitem>
+<simpara>prefered: store state in preference store and get the information then from there in the hightligher, inject PreferencestoreAccess in Calculator</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+</itemizedlist>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+</section>
+<section xml:id="sec:Code_Formatter">
+<title>Code Formatter</title>
+<informaltable tabstyle="horizontal" frame="none" colsep="0" rowsep="0">
+<tgroup cols="2">
+<colspec colwidth="15*"/>
+<colspec colwidth="85*"/>
+<tbody valign="top">
+<row>
+<entry>
+<simpara>Examples</simpara>
+</entry>
+<entry>
+<simpara>Auto-Format Source Code, Auto-Format code inserted by code-rewrite</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Eclipse API</simpara>
+</entry>
+<entry>
+<simpara><literal>org.eclipse.jface.text.formatter.IContentFormatter</literal> - here is the document and some range - modify at will</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Xtext Specifics</simpara>
+</entry>
+<entry>
+<simpara>Declarative Formatting API (to be deprecated) - associate formatting rules with grammar elements New formatting API (mixture of declarative and imperative) - here is the model, do what you want (space before, linebreak after, indentation increase / decrease), the engine will merge your advices and apply them to the document</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Best Practice</simpara>
+</entry>
+<entry>
+<simpara>wait for 2.8 (maybe in 2.7.x)</simpara>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+</section>
+<section xml:id="sec:Wizards">
+<title>Wizards</title>
+<blockquote>
+<attribution>
+Eclipse Help
+</attribution>
+<simpara>Wizards are used to guide the user through a sequenced set of tasks. Your plug-in can contribute wizards at predefined extension points in the workbench. It can also create and launch its own wizards.</simpara>
+</blockquote>
+<informaltable tabstyle="horizontal" frame="none" colsep="0" rowsep="0">
+<tgroup cols="2">
+<colspec colwidth="15*"/>
+<colspec colwidth="85*"/>
+<tbody valign="top">
+<row>
+<entry>
+<simpara>Examples</simpara>
+</entry>
+<entry>
+<simpara>New N4JS Class</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Eclipse API</simpara>
+<simpara>Xtext Specifics</simpara>
+</entry>
+<entry>
+<itemizedlist>
+<listitem>
+<simpara>Xtend based Wizards</simpara>
+</listitem>
+<listitem>
+<simpara>also see Formular Editor for Embedded Xtext editor</simpara>
+</listitem>
+</itemizedlist>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Best Practices</simpara>
+</entry>
+<entry>
+<itemizedlist>
+<listitem>
+<simpara>use preferences (could be hidden, so use them even if not made configurable to the user)</simpara>
+</listitem>
+<listitem>
+<simpara>use standard JFace wizard API, use Xtend template expressions for file templates</simpara>
+</listitem>
+</itemizedlist>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+</section>
+<section xml:id="sec:Cheat_Sheets">
+<title>Cheat Sheets</title>
+<blockquote>
+<attribution>
+Eclipse Help
+</attribution>
+<simpara>Composite cheat sheets provide guidance through complex problems by breaking the problem into a set of smaller tasks. Composite cheat sheets are registered using the the <literal>org.eclipse.ui.cheatsheets.cheatSheetContent</literal> extension point.</simpara>
+</blockquote>
+<simpara>(In Scala IDE: Work Sheets), often combined with Code Snippets</simpara>
+<informaltable tabstyle="horizontal" frame="none" colsep="0" rowsep="0">
+<tgroup cols="2">
+<colspec colwidth="15*"/>
+<colspec colwidth="85*"/>
+<tbody valign="top">
+<row>
+<entry>
+<simpara>Examples</simpara>
+</entry>
+<entry>
+<simpara>Create Hello World Application</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Eclipse API</simpara>
+<simpara>Xtext Specifics</simpara>
+</entry>
+<entry>
+<simpara>None, probably the embedded editor could be used in a REPL (Read-Evaluate-Print-Loop)</simpara>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+</section>
+<section xml:id="sec:Context_sensitive_Help">
+<title>Context-sensitive Help</title>
+<blockquote>
+<attribution>
+Eclipse Help
+</attribution>
+<simpara>A focused set of help topics that is related to the current context can be shown to users on demand using context-sensitive help. This form of user assistance is delivered to users when a platform-specific trigger is activated (e.g. F1 key on Windows, Ctrl+F1 on GTK, Help key on Carbon). Until Eclipse 3.1, context-sensitive help was presented in infopop windows. Since 3.1, a new Help view is the preferred way to deliver context-sensitive information to the user.</simpara>
+</blockquote>
+<informaltable tabstyle="horizontal" frame="none" colsep="0" rowsep="0">
+<tgroup cols="2">
+<colspec colwidth="15*"/>
+<colspec colwidth="85*"/>
+<tbody valign="top">
+<row>
+<entry>
+<simpara>Examples</simpara>
+</entry>
+<entry>
+<simpara>Help in Formular Editor, Help about syntax construct, API-Help</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Eclipse API</simpara>
+<simpara>Xtext Specifics</simpara>
+</entry>
+<entry>
+<simpara>None</simpara>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+</section>
+<section xml:id="sec:Hovers">
+<title>Hovers</title>
+<simpara>Hover allow to display additional information as soon as the cursor stays on a certain text region. Some hovers can be requested by shortcuts (e.g. F2) similar to sort of an online help.</simpara>
+<simpara>Different kind of hovers may appear depending on the context, e.g. the error hover will have higher prio than the documentation hover. Different modifier keys may be assigned to request different hover kinds while hovering a region with the mouse. (didn’t a proper code pointer, though)</simpara>
+<informaltable tabstyle="horizontal" frame="none" colsep="0" rowsep="0">
+<tgroup cols="2">
+<colspec colwidth="15*"/>
+<colspec colwidth="85*"/>
+<tbody valign="top">
+<row>
+<entry>
+<simpara>Examples</simpara>
+</entry>
+<entry>
+<simpara>Hover over method shows JSDoc, Signatures or inferred types, error / problem details</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Eclipse API</simpara>
+</entry>
+<entry>
+<simpara><literal>org.eclipse.jface.text.ITextHover</literal> + <literal>ITextHoverExtension*</literal> - compute hover based on the region that is hovered. Various indirections with <literal>IInformationControl</literal> and <literal>IInformationControlCreator</literal> with many extension interfaces</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Xtext Specifics</simpara>
+</entry>
+<entry>
+<simpara><literal>org.eclipse.xtext.ui.editor.hover.IEObjectHover</literal> - compute hover based on <literal>EObjects</literal></simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Best Practice</simpara>
+</entry>
+<entry>
+<simpara>see XBase hover stuff</simpara>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+</section>
+<section xml:id="sec:Folding">
+<title>Folding</title>
+<simpara>Code folding allows to skip parts of the code that are mandatory semantically but usually do not provide added value for the reader, e.g. import sections</simpara>
+<informaltable tabstyle="horizontal" frame="none" colsep="0" rowsep="0">
+<tgroup cols="2">
+<colspec colwidth="15*"/>
+<colspec colwidth="85*"/>
+<tbody valign="top">
+<row>
+<entry>
+<simpara>Examples</simpara>
+</entry>
+<entry>
+<simpara>Import section folding, folding of arbitrary methods or comments</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Eclipse API</simpara>
+</entry>
+<entry>
+<simpara>Not much there, most of that stuff is implemented specific to JDT or ODE. Projections usually only work per line, that is, a subsection of a line cannot be folded, e.g. it’s not possible to show</simpara>
+<screen>var x = new Map&lt;String, List&lt;Pair&lt;String, Number&gt;&gt;&gt;()</screen>
+<simpara>as</simpara>
+<screen>var x = new Map&lt;...&gt;()</screen>
+<simpara>Line only limitation in SWT (a guess, didn’t work for Sebastian otherwise)</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Xtext Specifics</simpara>
+</entry>
+<entry>
+<itemizedlist>
+<listitem>
+<simpara><literal>org.eclipse.xtext.ui.editor.folding.DefaultFoldingRegionProvider</literal> - here is the resource, compute the folding</simpara>
+</listitem>
+<listitem>
+<simpara><literal>org.eclipse.xtext.ui.editor.folding.DefaultFoldingStructureProvider</literal> - bridge between editor and custom computation, preferences etc would be read from here</simpara>
+</listitem>
+<listitem>
+<simpara>no preference page for folding provided by Xtext</simpara>
+</listitem>
+</itemizedlist>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Best Practice</simpara>
+</entry>
+<entry>
+<itemizedlist>
+<listitem>
+<simpara>maybe limit to blocks (subclass default, bind to interface)</simpara>
+</listitem>
+<listitem>
+<simpara>probably provide your own folding preference page</simpara>
+</listitem>
+</itemizedlist>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+</section>
+<section xml:id="sec:Customizable_validation___severity">
+<title>Customizable validation / severity</title>
+<simpara>Some problems are more important to the user than others so they want to change the severity.</simpara>
+<informaltable tabstyle="horizontal" frame="none" colsep="0" rowsep="0">
+<tgroup cols="2">
+<colspec colwidth="15*"/>
+<colspec colwidth="85*"/>
+<tbody valign="top">
+<row>
+<entry>
+<simpara>Examples</simpara>
+</entry>
+<entry>
+<simpara>Deprecation could be an error, warning or ignored (e.g. in test projects)</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Eclipse API</simpara>
+</entry>
+<entry>
+<simpara>None</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Xtext Specifics</simpara>
+</entry>
+<entry>
+<simpara>IssueSeverityProvider (since 2.6), Monkey sees monkey does: see subclasses of IssueSeverityProvider (we already do that)</simpara>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+</section>
+<section xml:id="sec:Proposals">
+<title>Proposals</title>
+<simpara>Created by Content Assist, Quick Fixes, Quick Assist.</simpara>
+<simpara>Basics</simpara>
+<itemizedlist>
+<listitem>
+<simpara>simplest case: proposals are strings to be inserted</simpara>
+</listitem>
+<listitem>
+<simpara>or displayed string is different from inserted one (e.g. FQN vs. simple)</simpara>
+</listitem>
+<listitem>
+<simpara>ConfigurableCompletionProposal created via factory methods in AbstractN4JSProposalProvider (*create*Pro)</simpara>
+</listitem>
+<listitem>
+<simpara>PrefixMatcher (by default CamelCase aware) – for filtering, it usually is not necessary to use it when computing the proposal (only if it expensive to compute proposals) – that is, prefix can be ignored when computing a proposal because the prefix matcher will filter out invalid proposals anyway</simpara>
+</listitem>
+<listitem>
+<simpara>pass a filter (Guava preodicate) to filter out (semantically invalid) proposals, cf. lookupCrossReference(..) – for the things where there are proposals created by default</simpara>
+</listitem>
+<listitem>
+<simpara>priority defined by an int – for sorting. Cf. ContentProposalPriorities → define default priorities (constant values) in N4JS, do not add some random integers!</simpara>
+</listitem>
+<listitem>
+<simpara>modes: bind RepeatedContentAssistProcessor and enable modeaware in ProposalProvider (e.g. for private members which require a quickfix)</simpara>
+</listitem>
+<listitem>
+<simpara>what could be done in the background: hover, lazy (not prepared) proposals (cf. JDT), Xtext 2.7.; different situations are processed in parallel</simpara>
+</listitem>
+</itemizedlist>
+<simpara>Several changes (e.g. automatic import):</simpara>
+<itemizedlist>
+<listitem>
+<simpara><literal>ConfigurableCompletionProposal.setTextApplier</literal></simpara>
+</listitem>
+<listitem>
+<simpara>TextApplier: can open dialogs etc., TextApplier is the callback</simpara>
+</listitem>
+<listitem>
+<simpara>usual case: add text at cursor position and somewhere else:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>get document in TextApplier</simpara>
+</listitem>
+<listitem>
+<simpara>for performance, but also: do not use semantic changes in content assist, because model is broken (you will get funny things) – use model (AST) to get offset, but then insert line breaks etc. → maybe create utility class for retrieving current formattings which are then used in the text edit → maybe provide tools for retrieving certain locations (e.g. import section, field section, etc.)</simpara>
+</listitem>
+<listitem>
+<simpara>do not create model (AST) fragments (which are then serialized), instead directly provide text</simpara>
+</listitem>
+<listitem>
+<simpara>use TextEdit and MultiTextEdit</simpara>
+</listitem>
+<listitem>
+<simpara>set TextViewer redraw to false and to true after the text edits were applied</simpara>
+</listitem>
+<listitem>
+<simpara>have proper TESTS to ensure that file is not broken after the changes</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+<listitem>
+<simpara><emphasis role="strong">LinkedEditing</emphasis>:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>Linked-Editing mode in ConfigurableCompletionProposal with one editing group only (basically: move the cursor somewhere after editing it, see setSimpleLinkedMode)</simpara>
+</listitem>
+<listitem>
+<simpara>do it manually: cf. LinkedPositionGroup (see call hierarchy of constructor) – used for quick fixes or refactorings rather for content assist</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+</itemizedlist>
+</section>
+</section>
+<section xml:id="sec:Non_Eclipse_UI_Concepts">
+<title>Non-Eclipse UI Concepts</title>
+<simpara>The following entries are not necessarily implemented yet.</simpara>
+<section xml:id="sec:Overlays">
+<title>Overlays</title>
+<simpara>An overlay is a small annotation similar to an hover, attached to a specific location in the editor and is moved with that location.</simpara>
+<informaltable tabstyle="horizontal" frame="none" colsep="0" rowsep="0">
+<tgroup cols="2">
+<colspec colwidth="15*"/>
+<colspec colwidth="85*"/>
+<tbody valign="top">
+<row>
+<entry>
+<simpara>Examples</simpara>
+</entry>
+<entry>
+<simpara>Show inferred types</simpara>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+</section>
+<section xml:id="sec:Goto__Inferred__Type">
+<title>Goto (Inferred) Type</title>
+<simpara>Navigate to an inferred type (or other <literal>invisible</literal>  information)</simpara>
+</section>
+<section xml:id="sec:Postfix_Completion">
+<title>Postfix Completion</title>
+<simpara>(IntelliJ) Replace code <emphasis>AFTER</emphasis> an expression</simpara>
+</section>
+</section>
+</section>
+<section xml:id="_user-interface-resources">
+<title>User Interface Resources</title>
+<section xml:id="_icons">
+<title>Icons</title>
+<simpara>In parts, the N4JS IDE re-uses some of the icons that come with the Eclipse Platform as well as the Eclipse JDT development environment. However, in some cases we also provide our own icons to illustrate N4JS-specific concepts.</simpara>
+<section xml:id="_eclipse-platform-icons">
+<title>Eclipse Platform Icons</title>
+<simpara>When re-using the Eclipse Platform Icons, the icons are usually copied over to the <literal>icons/</literal> folder of the <literal>org.eclipse.n4js.ui</literal> bundle. In this folder, the <literal>README.adoc</literal> file keeps book on the origin of all the collected icons (e.g. different Eclipse Projects).</simpara>
+</section>
+<section xml:id="_n4js-specific-icons">
+<title>N4JS Specific Icons</title>
+<simpara>In some cases, the icons the Eclipse eco-system provides do not suffice to sensibly express N4JS concepts. In these cases we provide our own icons. When designing those we try to imitate the general Eclipse artstyle in order for our icons to integrate well with the overall appearance of Eclipse.</simpara>
+<simpara>For the creation of new icons, the <literal>eclipse-svg-icons</literal> repository (see <link xl:href="https://github.com/Seung-Yoon/eclipse-svg-icons">https://github.com/Seung-Yoon/eclipse-svg-icons</link>) has proven helpful. The repository contains raw SVG files which can be used to reproduce the bitmap icons that are contained in, for instance, the <literal>org.eclipse.platform.ui</literal> or <literal>org.eclipse.jdt.ui</literal> bundle. Based on that, common vector-graphics editing software may be used to further adapt color, form and style of existing icons (e.g. Inkscape <link xl:href="https://inkscape.org/en/">https://inkscape.org/en/</link>).</simpara>
+</section>
+<section xml:id="_high-resolution-icons">
+<title>High Resolution Icons</title>
+<simpara>With the Neon release, Eclipse SWT introduced explicit support for high-DPI monitors (see <link xl:href="https://www.eclipse.org/eclipse/news/4.6/platform.php#swt-autoscale">https://www.eclipse.org/eclipse/news/4.6/platform.php#swt-autoscale</link>). In order to provide a good user experience, we want to provide high-DPI support for as many of our icons as possible. For that, it suffices to simply provide an alternative resource with higher resolution by appending the prefix @2x to its name (e.g. <literal>class.png</literal> and <literal>class@2x.png</literal>). Code-wise, no adjustments are required. In case of copied Eclipse Platform Icons, most of the time a corresponding 2x-version can be obtained from the original source. In case of N4JS Specific Icons, we export all icons in the resolutions 16x16 and 32x32. For that, it is of particular importance to make sure that the scaling is done in accordance with the native resolution (cf. pixel perfect scaling, also see <link xl:href="https://en.wikipedia.org/wiki/Native_resolution">https://en.wikipedia.org/wiki/Native_resolution</link>).</simpara>
+</section>
+</section>
+</section>
+</chapter>
+<chapter xml:id="_formatting">
+<title>Formatting</title>
+<warning>
+<simpara>This chapter may be outdated.</simpara>
+</warning>
+<section xml:id="sec:FmtObjective" role="language-n4js">
+<title>Objective</title>
+<simpara>Writing textual code has many degrees of freedom. The resulting layout differs between authors. Carefully placing whitespace and newlines can increase the readability. Some handling of whitespace can be automated. This chapter describes the techniques used to automate the formatting to some degree.</simpara>
+<simpara>Formatting N4js source code ensures a consistent style. It takes care of:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>surrounding language constructs with white space to improve readability</simpara>
+</listitem>
+<listitem>
+<simpara>indenting logically grouped elements</simpara>
+</listitem>
+<listitem>
+<simpara>wrapping long lines of code and comments</simpara>
+</listitem>
+<listitem>
+<simpara>inserting semicolons, which would otherwise be automatically inserted (ASI)</simpara>
+</listitem>
+<listitem>
+<simpara>formatting documentation</simpara>
+</listitem>
+</itemizedlist>
+<simpara>Formatting will never alter the semantics of the code and it will not reorganize it.</simpara>
+<section xml:id="sec:FmtFormatting_Comments">
+<title>Formatting Comments</title>
+<simpara>N4js distinguishes five different types of comments <emphasis>single line comments</emphasis>, <emphasis>not-indented single line comments</emphasis>, <emphasis>multiline comments</emphasis>, <emphasis>fixed multiline comments</emphasis> and <emphasis>Jsdoc style multiline comments.</emphasis></simpara>
+<simpara>Single line comments start with <literal>//</literal>  and include all characters until the end of line. They usually will be indented and wrapped if they exceed the maximum line length unless they start immediately at the first column. Single line comments starting at position 0 are called <emphasis>not-indented single line comments</emphasis>.</simpara>
+<simpara>Multiline comments start with <literal>/*</literal>  and span all character including line breaks up the the end given by <literal>*/</literal> . The three variants are distinguished by the third and fourth character:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>Comments starting with <literal>/*-</literal>  are always fixed multiline comments.</simpara>
+</listitem>
+<listitem>
+<simpara>Comments starting with <literal>/**</literal>  and following any other character but <literal>*</literal>  are Jsdoc style multiline comments. (E.g. <literal>/**+</literal>  start Jsdoc but <literal>/***</literal>  does not.)</simpara>
+</listitem>
+<listitem>
+<simpara>All others starting with <literal>/*</literal>  are ordinary multiline comments.</simpara>
+</listitem>
+</itemizedlist>
+<simpara><emphasis>Not-indented single line comments</emphasis> and <emphasis>fixed multiline comments</emphasis> will always remain as they are. Usually they are used to comment out code sections.</simpara>
+</section>
+</section>
+<section xml:id="sec:FmtArchitecture" role="language-n4js">
+<title>Architecture</title>
+<simpara>Formatting mainly takes place in polymorphic dispatch methods <literal>format</literal> in class <literal>N4JSFormatter</literal>. Some language features are formatted with an entry-point using a super-class. This is mainly the case for structures that are sufficiently similar. E.g. <literal>format( FunctionOrFieldAccessor )</literal> is responsible for getter, setter, methods, functions, ….</simpara>
+<simpara>Some common source-code formattings are grouped by <literal>configureXY()</literal> methods. They get called from the <literal>format</literal> methods for similar code structures, c.f. <literal>configureAnnotations</literal></simpara>
+<simpara>Since we do not support formatting of the TypeExpression-language stand-alone, this class provides only one format-method throwing an <literal>UnsupportedOperationException</literal> type expressions formatting is defined in class <literal>N4JSFormatter</literal> at the end of the file.</simpara>
+<figure xml:id="fig:formatter_overview" role="center">
+<title>Overview of classes used for formatting</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/17_formatting/images/FormatterArchitecture.svg"/>
+</imageobject>
+<textobject><phrase>FormatterArchitecture</phrase></textobject>
+</mediaobject>
+</figure>
+<simpara>The first entry-point for a script is <literal>N4JSFormatter.format(Script, IFormattableDocument)</literal>. Within this method an instance of <literal>N4JSGenericFormatter</literal> is created and used to configure general aspects of automatic-semicolon insertion (put a ’<literal>;</literal>’ where ASI took place in the parser) and handling of colons (’<literal>:</literal>’).</simpara>
+<section xml:id="sec:Implementation_example">
+<title>Implementation example</title>
+<simpara>Considering the following N4js-snippet where the return value of a function call will be casted to some type.</simpara>
+<screen>functionCall("a","b") as MyType&lt;string&gt;</screen>
+<simpara>The whole line is a CastExpression comprising of an expression (<literal>functionCall(a,b)</literal>) and a type reference (<literal>MyType&lt;string&gt;</literal>).</simpara>
+<simpara>The <literal>format</literal>-dispatch method written in Xtend would look like:</simpara>
+<screen>    def dispatch void format(CastExpression expr, extension IFormattableDocument document) {
+        expr.regionFor.keyword("as").prepend[newLines = 0; oneSpace].append[newLines = 0; oneSpace];
+        expr.expression.format;
+        expr.targetTypeRef.format;
+    }</screen>
+<simpara>In line 2 the format around the keyword <literal>as</literal> is specified where in line 3 and 4 the formatting of the containing elements will be dispatched.</simpara>
+<simpara>Note that <literal>regionFor</literal> in line 2 is a method declared in <literal>IFormattableDocument</literal> and used via the extension-parameter <literal>document</literal>. It returns an object of type <literal>ISemanticRegionFinder</literal>. Invoking the <literal>keyword</literal> method on this object returns an instance of <literal>ISemanticRegion</literal> which will be passed to the extension methods <literal>prepend</literal> and <literal>append</literal> following the builder pattern. Both <literal>prepend</literal> and <literal>append</literal> take a lambda expression operating on a single parameter of type <literal>IHiddenRegionFormatter</literal>. Inside the lambda-expression this parameter is implicitly used to invoke the methods <literal>setNewLines(0)</literal> and <literal>oneSpace()</literal>. These calls simply disallow line-breaks around as and force the whitespace to be just a single character.</simpara>
+<simpara>Possible other formatting instructions can be found in <literal>IHiddenRegionFormatter</literal>.</simpara>
+<simpara>Due to some bugs in auto-wrapping<footnote><simpara>version at the time of writing is Xtext 2.12</simpara></footnote> unsuccessful attempts to wrap a line can insert unexpected new-lines in regions several lines in front of the currently treated source-line.</simpara>
+<simpara>Debugging the formatter can be cumbersome as, due to GH-12<footnote><simpara><link xl:href="https://github.com/eclipse/xtext-core/issues/12">https://github.com/eclipse/xtext-core/issues/12</link></simpara></footnote>, the <literal>toString()</literal> methods if internal data-structures throw exceptions.</simpara>
+</section>
+</section>
+<section xml:id="sec:FmtFormatter_Implementation_Guidelines">
+<title>Formatter Implementation Guidelines</title>
+<itemizedlist>
+<listitem>
+<simpara>Each formatted element should only format it’s inner content. This avoids conflicting situations.</simpara>
+</listitem>
+<listitem>
+<simpara>For each region possibly containing whitespace must be formatted.</simpara>
+</listitem>
+<listitem>
+<simpara>Use priorities for conflict-resolutions sparse. For contradicting informations in the same region, the higher priority wins. If both information have the same priority, then an Exception will be thrown, showing two stack-traces to indicate the two code-regions being responsible for the situation.</simpara>
+</listitem>
+<listitem>
+<simpara>For auto-wrapping a callback can be registered. In case of wrapping you can then conditionally change the format. Registering a callback implicitly sets the auto-wrap flag for the region.</simpara>
+</listitem>
+<listitem>
+<simpara>Cover formatting with at least two different unit-tests. One having as little white-space as possible (all in one line) and the other as much white-space as possible in order to identify unformatted regions.</simpara>
+</listitem>
+</itemizedlist>
+</section>
+<section xml:id="sec:FmtConfiguration">
+<title>Configuration</title>
+<simpara>Some formattings can be customised through preference key-value pairs. Class <literal>N4JSFormatterPreferenceKeys</literal> acts as the entry-point to define such key-(default-)value pairs. Some preferences are inherited and are based on values stored in the default preference store (Line length, default tab width, …).</simpara>
+<simpara>Currently the preferences are not yet accessible by the end-user.</simpara>
+</section>
+<section xml:id="sec:FmtUI_Integration">
+<title>UI Integration</title>
+<simpara>Code formatting is invoked with standard key-strokes ( <keycap>CMD</keycap>+<keycap>Shift</keycap>+<keycap>F</keycap> on Mac, <keycap>Ctrl</keycap>+<keycap>Shift</keycap>+<keycap>F</keycap> on Windows)</simpara>
+<simpara>There is no UI for preferences values yet.</simpara>
+</section>
+<section xml:id="sec:FmtUnit_Testing_with_Xpect" role="language-n4js">
+<title>Unit Testing with Xpect</title>
+<simpara>With Xpect Method <literal>formattedLines</literal> implemented in class <literal>org.eclipse.n4js.xpect.FormatterXpectMethod</literal> in bundle <literal>org.eclipse.n4js.tests.helper</literal> the formatting can be tested. The test method requires the number of lines which should be formatted. The desired test is given as a standard multiline expectation.</simpara>
+<screen>/* XPECT formattedLines 1 ---
+var a, b, c, d, e;
+--- */
+var a,b,c,d,e;</screen>
+<simpara>Preferences can be configured in the Xpect setup section by providing string values. Numbers and booleans are converted automatically by the preferences framework.</simpara>
+<screen>/* XPECT_SETUP org.eclipse.n4js.tests.N4JSXpectTest
+    ResourceSet {
+        ThisFile {}
+        File "wishesImported.n4js" {  }
+    }
+    Preference "indentation" "    " {}
+    Preference "line.width.max" "100" {}
+    Preference "format.auto_wrap_in_front_of_logical_operator" "false" {}
+
+   END_SETUP
+ */</screen>
+<simpara>Tip: Full coverage of the formatting can be tested via authoring the input using spaces as indentation characters if the formatter would use tabs or vice versa. That way untouched lines are distinguishable during the test-runs</simpara>
+</section>
+</chapter>
+<chapter xml:id="_external-libraries">
+<title>External Libraries</title>
+<simpara></simpara>
+<sidebar>
+<simpara><link xl:href="https://github.com/eclipse/n4js/issues/1018"><inlinemediaobject>
+<imageobject>
+<imagedata fileref="images/issue.svg"/>
+</imageobject>
+<textobject><phrase></phrase></textobject>
+</inlinemediaobject> #1018</link>
+<link xl:href="https://github.com/eclipse/n4js/issues/397"><inlinemediaobject>
+<imageobject>
+<imagedata fileref="images/issue.svg"/>
+</imageobject>
+<textobject><phrase></phrase></textobject>
+</inlinemediaobject> #397</link>
+<link xl:href="https://github.com/eclipse/n4js/issues/809"><inlinemediaobject>
+<imageobject>
+<imagedata fileref="images/issue.svg"/>
+</imageobject>
+<textobject><phrase></phrase></textobject>
+</inlinemediaobject> #809</link>
+<link xl:href="https://github.com/eclipse/n4js/issues/714"><inlinemediaobject>
+<imageobject>
+<imagedata fileref="images/issue.svg"/>
+</imageobject>
+<textobject><phrase></phrase></textobject>
+</inlinemediaobject> #714</link>
+<link xl:href="https://github.com/eclipse/n4js/issues/653"><inlinemediaobject>
+<imageobject>
+<imagedata fileref="images/issue.svg"/>
+</imageobject>
+<textobject><phrase></phrase></textobject>
+</inlinemediaobject> #653</link>
+<link xl:href="https://github.com/eclipse/n4js/issues/862"><inlinemediaobject>
+<imageobject>
+<imagedata fileref="images/issue.svg"/>
+</imageobject>
+<textobject><phrase></phrase></textobject>
+</inlinemediaobject> #862</link>
+<link xl:href="https://github.com/eclipse/n4js/issues/1133"><inlinemediaobject>
+<imageobject>
+<imagedata fileref="images/issue.svg"/>
+</imageobject>
+<textobject><phrase></phrase></textobject>
+</inlinemediaobject> #1133</link></simpara>
+</sidebar>
+<simpara><emphasis role="strong">External libraries</emphasis> are N4JS projects that are provided by the N4JS IDE:
+the <emphasis>built-in</emphasis>/<emphasis>shipped</emphasis> libraries, and all <emphasis>3rd-party libraries</emphasis> that were installed by the <emphasis>N4JS library manager</emphasis>.
+Each external library consist of a valid package.json file located in the project root and an arbitrary number of files supported by N4JS projects, e.g. <emphasis>.n4js</emphasis>, <emphasis>.njsd</emphasis> and <emphasis>.js</emphasis> files.
+The purpose of the external libraries is to share and to provide core and third party functionality for N4JS developers both in compile and runtime without rebuilding them.</simpara>
+<simpara><xref linkend="sec:Built-in_External_Libraries"/> are external libraries that provide some basic functionality for N4JS programmers, such as the class <literal>N4Injector</literal>.</simpara>
+<simpara><emphasis role="strong">3rd-party libraries</emphasis> are external libraries that are not built-in/shipped with the N4JS IDE.
+Instead, they can be installed later by the user from third party providers.
+Currently, only <emphasis>npm packages</emphasis> are supported.</simpara>
+<simpara>The <emphasis role="strong">N4JS index</emphasis> is populated when the external libraries are compiled.
+However, this compilation is only triggered through the library manager, but not when building workspace projects. (Self-evidently, the index is also populated when compiling workspace projects.)</simpara>
+<simpara><emphasis role="strong">Name clashes</emphasis> of projects can happen and they are solved in the following order:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>User workspace projects always shadow external libraries.</simpara>
+</listitem>
+<listitem>
+<simpara>In case of a name clash between a shipped and a 3rd-party library, the 3rd-party library shadows the shipped project.</simpara>
+</listitem>
+</orderedlist>
+<simpara>The <emphasis role="strong">N4JS library manager</emphasis> is a tool in the N4JS IDE to view and manage external libraries.
+In particular, the user can (un-)install new 3rd-party libraries, or can trigger the build of all external libraries to re-populate the N4JS index.
+The library manager also supports other maintenance actions such as deleting all 3rd-party libraries.</simpara>
+<section xml:id="sec:Major_Components" role="language-n4js">
+<title>Major Components</title>
+<simpara>External libraries are supported based on different components all over the application.</simpara>
+<simpara>The followings are the most important ones:</simpara>
+<itemizedlist>
+<listitem>
+<simpara><emphasis role="strong">External Resources</emphasis> (<literal>IExternalResource</literal>)</simpara>
+<itemizedlist>
+<listitem>
+<simpara>These are customized <literal>IResource</literal> implementations for external projects, folders and files.</simpara>
+</listitem>
+<listitem>
+<simpara>With this approach the <literal>IProject</literal>, <literal>IFolder</literal> and <literal>IFile</literal> interfaces have been implemented. Each implementation is backed by a pure <literal>java.io.File</literal> based resource.</simpara>
+</listitem>
+<listitem>
+<simpara>When accessing such external resources for example visiting purposes, getting the members of the resource or simply deleting the resource, internally each requests will be directly performed on the wrapped <literal>java.io.File</literal> without accessing the <literal>org.eclipse.core.resources.IWorkspace</literal> instance.</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+<listitem>
+<simpara><emphasis role="strong">External Library Workspace</emphasis></simpara>
+<itemizedlist>
+<listitem>
+<simpara>This is a kind of dedicated workspace for external libraries and their dependencies.</simpara>
+</listitem>
+<listitem>
+<simpara>Any query requests to retrieve a particular project or any dependencies of a particular project via the <literal>IN4JSCore</literal> singleton service will delegated to its wrapped <literal>N4JSModel</literal> singleton. Internally the <literal>N4JSModel</literal> has a reference to a workspace for all the ordinary workspace projects and another reference to the workspace for external libraries. Each query requests will be forwarded to the workspace for the ordinary projects first, and then to the external library workspace. If ordinary project workspace can provide any meaningful response for a request, then the external library workspace will not be accessed at all. Otherwise the query will be executed against the external library workspace. This fallback mechanism provides a pragmatic solution to the project shadowing feature. The project shadowing will be described in details later in this section.</simpara>
+</listitem>
+<listitem>
+<simpara>The <emphasis role="strong">External Library Workspace</emphasis> is only supported and available in the IDE case, in the headless case there are no external libraries available from this dedicated workspace. Since the Xtext index creation and the entire build infrastructure is different, it is supported via target platform file. This is described in more details in a later section (<link linkend="sec:Headless_External_Library_Support">Headless External Library Support</link>]).</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+<listitem>
+<simpara><emphasis role="strong">External Library Preference Store</emphasis></simpara>
+<itemizedlist>
+<listitem>
+<simpara>This preference store is being used to register and un-register external library root folders into its underlying ordered list. A folder is called as an external library root folder if it is neither equal with the Eclipse workspace root nor being nested in the workspace root and contains zero to any external libraries.</simpara>
+</listitem>
+<listitem>
+<simpara>Whenever any modifications are being saved in this preference store the <emphasis>External Library Workspace</emphasis> will be updated as well, new libraries will be registered into the workspace and removed libraries will be cleaned up from the workspace.</simpara>
+</listitem>
+<listitem>
+<simpara>When the N4JS IDE application is started in production mode, the initial state of the preference store is being pre-populated with default values. This is necessary to provide built-in libraries to end users. These default values and additional advanced configurations will be mentioned in more details later in this section.</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+<listitem>
+<simpara><emphasis role="strong">Library Manager</emphasis></simpara>
+<itemizedlist>
+<listitem>
+<simpara>This service is responsible for downloading and installing third party <emphasis>npm</emphasis> packages into the <literal>node_modules</literal> folder of the N4JS IDE. After downloading, the newly-installed and/or updated packages are registered as external libraries into the system.</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+<listitem>
+<simpara><emphasis role="strong">External Library Builder</emphasis></simpara>
+<itemizedlist>
+<listitem>
+<simpara>This service is responsible for updating the persistent Xtext index with the currently available external libraries.</simpara>
+</listitem>
+<listitem>
+<simpara>Unlike in case of any other ordinary projects, this builder does not triggers a build via the <literal>org.eclipse.core.internal.events.BuildManager</literal> but modifies the persisted Xtext index (<literal>IBuilderState</literal>) directly.</simpara>
+</listitem>
+<listitem>
+<simpara>Considers shadowed external libraries when updating the persisted Xtext index.</simpara>
+</listitem>
+<listitem>
+<simpara>Makes sure that the external library related Xtext index is persistent and will be available on the next application startup.</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+<listitem>
+<simpara><emphasis role="strong">External Library Xtext Index Persister</emphasis></simpara>
+<itemizedlist>
+<listitem>
+<simpara>This class is responsible for recovering the consistent external library Xtext index state at application startup.</simpara>
+</listitem>
+<listitem>
+<simpara>Scheduled on the very first application startup to prepare the Xtext index for the available external libraries.</simpara>
+</listitem>
+<listitem>
+<simpara>Recovers the Xtext index state after a force quit and/or application crash.</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+<listitem>
+<simpara><emphasis role="strong">External Library Preference Page</emphasis></simpara>
+<itemizedlist>
+<listitem>
+<simpara>Preference page to configure and update the state of the <emphasis>External Library Preference Store</emphasis>.</simpara>
+</listitem>
+<listitem>
+<simpara>Provides a way to install <emphasis>npm</emphasis> dependencies as external libraries into the application.</simpara>
+</listitem>
+<listitem>
+<simpara>Reloads the external libraries. Gets the most recent state of N4JS type definition files and updates the Xtext index content based on the current state of the external libraries.</simpara>
+</listitem>
+<listitem>
+<simpara>Exports the current npm dependency configuration as a target platform file. This will be discussed in another section ([sec:Headless_External_Library_Support]).</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+<listitem>
+<simpara><emphasis role="strong">Miscellaneous UI Features</emphasis></simpara>
+<itemizedlist>
+<listitem>
+<simpara>Searching for types provided by external libraries.</simpara>
+</listitem>
+<listitem>
+<simpara>Opening external modules in read-only editor.</simpara>
+</listitem>
+<listitem>
+<simpara>Navigation between external types.</simpara>
+</listitem>
+<listitem>
+<simpara><emphasis>Project Explorer</emphasis> contribution for showing external dependencies for ordinary workspace projects.</simpara>
+</listitem>
+<listitem>
+<simpara>Editor-navigator linking support for external modules.</simpara>
+</listitem>
+<listitem>
+<simpara>Installing third party npm dependencies directly from package.json editor via a quick fix.</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+</itemizedlist>
+<section xml:id="subsec:External_Resources">
+<title>External Resources</title>
+<simpara>This approach provides a very pragmatic and simple solution to support external libraries in both in the <literal>IN4JSCore</literal> and in the <literal>IBuilderState</literal>. While <literal>IN4JSCore</literal> supports a completely transparent way of external libraries via the <literal>IN4JSProject</literal> interface all over in the application, the <literal>IBuilderState</literal> is responsible for keeping the Xtext index content up to date with the external libraries. Below picture depicts the hierarchy between the ordinary <literal>IResource</literal> and the <literal>IExternalResource</literal> instances. As described above each external resource is backed by a <literal>java.io.File</literal> resource and each access and operation being invoked on the <literal>IResource</literal> interface will be delegated to this backing resource.</simpara>
+<figure xml:id="fig:External_Resources_Hierarchy" role="center">
+<title>External Resources Hierarchy</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/20_externalLibraries/images/externalResources.svg"/>
+</imageobject>
+<textobject><phrase>externalResources</phrase></textobject>
+</mediaobject>
+</figure>
+</section>
+<section xml:id="subsec:External_Library_Workspace">
+<title>External Library Workspace</title>
+<simpara>External library workspace is an extension of the <literal>InternalN4JSWorkspace</literal>. This workspace is used for storing and managing external libraries all over the application. External libraries can be registered into the workspace by providing one to many external library root folder locations. The provided root folder locations will be visited in an ordered fashion and the contained external libraries (N4JS projects) will be registered into the application. If an external library from a root folder has been registered, then a forthcoming occurrence of an external library with the same artefact identifier (and same folder name) will be ignored at all. For instance let assume two external library root locations are available <literal>ER1</literal> and <literal>ER2</literal>, also <literal>ER1</literal> contains <literal>P1</literal> and <literal>P2</literal> external libraries, while <literal>ER2</literal> contains <literal>P2</literal> and <literal>P3</literal>. After registering the two roots into the workspace <literal>ER1</literal> will be processed first, and <literal>P1</literal> and <literal>P2</literal> will be registered to the workspace, when processing the forthcoming <literal>ER2</literal> root, <literal>P2</literal> will be ignored at all as an external with the same name exists. Finally <literal>P3</literal> will be registered to the workspace. External libraries cannot be registered directly into the workspace it is done automatically by the <emphasis>External Library Preference Store</emphasis> and by the <emphasis>npm Manager</emphasis>.</simpara>
+</section>
+<section xml:id="subsec:External_Library_Preference_Store">
+<title>External Library Preference Store</title>
+<simpara>This persistent cache is used for storing an ordered enumeration of registered external library root folder locations. Whenever its internal state is being persisted after a modification, all registered modification listeners will be synchronously notified about this change. All listeners will receive the store itself with the updated state. There are a couple of registered listeners all over the application listening to store update events but the most important one is the <emphasis>External Library Workspace</emphasis> itself. After receiving an external library preference store update event, the external library workspace will calculate the changes from its own state: creates a sort of difference by identifying added, removed and modified external libraries. Also tracks external library root location order changes. Once the workspace has calculated the changes<footnote><simpara>Calculates a list of external library projects that have to be build and another list of projects that have to be cleaned.</simpara></footnote> it will interact with the <emphasis>External Library Builder Helper</emphasis> which will eventually update the persisted Xtext index directly through the <literal>IBuilderState</literal>. After the Xtext index content update all ordinary workspace projects that directly depend either on a built or a cleaned external library will be automatically rebuilt by the external library workspace.</simpara>
+</section>
+<section xml:id="subsec:npm_Manager">
+<title>Library Manager</title>
+<simpara>This service is responsible for downloading, installing third party npm dependencies into the local file system. This is done directly by <literal>npm</literal> from <literal>Node.js</literal>. Once an npm package has been downloaded and installed it will be registered into the external library workspace. As part of the registration, the Xtext index content will be updated and all dependent ordinary workspace projects will be rebuilt automatically. An npm package cannot be installed via the <emphasis>Library Manager</emphasis> if it already installed previously.</simpara>
+</section>
+<section xml:id="subsec:External_Library_Builder_Helper">
+<title>External Library Builder</title>
+<simpara>This builder is responsible for updating the persisted Xtext index state with external library content directly through the <literal>IBuilderState</literal>. When providing a subset of external libraries to either build or clean, internally it orders the provided external libraries based on the project dependencies. Also, it might skip building all those external libraries that have are being shadowed by a workspace counterpart. An external library is being shadowed by an ordinary workspace project, if the workspace project is accessible and has exactly the same project name as the external library.</simpara>
+</section>
+<section xml:id="subsec:External_Library_Xtext_Index_Persister">
+<title>External Library Xtext Index Persister</title>
+<simpara>By default Xtext provides a way to fix corrupted index or to recreate it from scratch in case of its absence. Such inconsistent index states could occur due to application crashes or due to non-graceful application shutdowns. Although this default recovery mechanism provided by Xtext works properly, it is provided only for projects that are available in the Eclipse based workspace (<literal>org.eclipse.core.resources.IWorkspace</literal>) but non of the external libraries are not available from the Eclipse based workspace, so inconsistent external library index content cannot be recovered by this default mechanism. N4JS IDE contributes its own logic to recover index state of external N4JS libraries. When the default Xtext index recovery runs, then it will trigger a external reload as well. This external reload is guaranteed to run always after the default recovery mechanism.</simpara>
+</section>
+<section xml:id="subsec:External_Library_Preference_Page">
+<title>External Library Preference Page</title>
+<simpara>This preference page provides a way to configure the external libraries by adding and removing external library root folders, also allows the user to reorder the configured external library root locations. Besides that, npm packages can be installed into the application as external libraries. Neither removing nor reordering built-in external libraries are supported, hence these operations are disabled for built-ins on the preference page. No modifications will take effect unless the changes are persisted with the <literal>Apply</literal> button. One can reset the configurations to the default state by clicking on the <literal>Restore Defaults</literal> button then on the <literal>Apply</literal> button. The <literal>Reload</literal> button will check whether new type definition files are available for npm dependencies, then reloads the persistent Xtext index content based on the available external libraries. Once the external library reloading has been successfully finished, all dependent workspace projects will be rebuilt as well. From the preference page one can export the installed and used third party npm packages as a target platform. This exported target platform file can be used with the headless compiler. After setting up the headless compiler with this exported target platform file, the headless tool will collect and download all required third party npm dependencies.</simpara>
+</section>
+</section>
+<section xml:id="sec:Headless_External_Library_Support" role="language-n4js">
+<title>Headless External Library Support</title>
+<simpara>The headless compiler is not capable of supporting built-in libraries. The whole build and Xtext index creation infrastructure is different in the IDE and in the headless case. Also, due to its archive nature (<literal>n4jsc.jar</literal>) of the headless tool, neither the runtime nor the <literal>Mangelhaft</literal> libraries can be loaded into the headless compiler.</simpara>
+<simpara>The headless compiler supports downloading, installing and using third party <literal>npm</literal> packages. To enable this feature one has to configure the target platform via the <literal>–targetPlatformFile</literal> (or simply <literal>-tp</literal>) and the <literal>–targetPlatformInstallLocation</literal> (or simply <literal>-tl</literal>) arguments.</simpara>
+<simpara>If the target platform file argument is configured, then all third party dependencies declared in the target platform file will be downloaded, installed and made available for all the N4JS projects before the compile (and run) phase. If the target platform file is given but the target platform install location is not specified (via the <literal>–targetPlatformInstallLocation</literal> argument), then a the compilation phase will be aborted and the execution will be interrupted.</simpara>
+<simpara>For more convenient continuous integration and testing purposes there are a couple of additional exception cases with respect to the the target platform file and location that users of the headless compiler have to keep in mind. These are the followings:</simpara>
+<itemizedlist>
+<listitem>
+<simpara><literal>–targetPlatformSkipInstall</literal>. Usually dependencies defined in the target platform file will be installed into the folder defined by option <literal>–targetPlatformInstallLocation</literal>. If this flag is provided, this installation will be skipped, assuming the given folder already contains the required files and everything is up-to-date. Users have to use this flag with care, because no checks will be performed whether the location actually contains all required dependencies.</simpara>
+</listitem>
+<listitem>
+<simpara>If <literal>–targetPlatformSkipInstall</literal> is provided the <literal>–targetPlatformInstallLocation</literal> parameter is completely ignored.</simpara>
+</listitem>
+<listitem>
+<simpara>If <literal>–targetPlatformSkipInstall</literal> is provided the <literal>–targetPlatformFile</literal> parameter is completely ignored.</simpara>
+</listitem>
+<listitem>
+<simpara>If neither <literal>–targetPlatformInstallLocation</literal> not <literal>–targetPlatformFile</literal> parameters are specified the headless tool will treat this case as an implicit <literal>–targetPlatformSkipInstall</literal> configuration.</simpara>
+</listitem>
+</itemizedlist>
+<simpara>If the target platform install location is configured, and the target platform file is given as well, then all third party dependencies specified in the target platform file will be downloaded to that given location. If the target platform file is given, but the target platform install location is not specified, then a the compilation phase will be aborted and the execution will be interrupted.</simpara>
+<programlisting language="bash" linenumbering="unnumbered">java -jar n4jsc.jar -projectlocations /path/to/the/workspace/root -t allprojects -tp /absolute/path/to/the/file -tl /path/to/the/target/platform/install/location -rw nodejs -r moduleToRun</programlisting>
+<section xml:id="_custom-npm-settings">
+<title>Custom npm settings</title>
+<simpara>In some cases there is a need for custom npm settings, e.g. custom npm registry. Those kind of configurations are
+supported via <literal>.npmrc</literal> file (see <link xl:href="https://docs.npmjs.com/files/npmrc">https://docs.npmjs.com/files/npmrc</link>).</simpara>
+<simpara>In N4JSIDE user can specify path to his custom configuration file in the preference page.</simpara>
+<simpara>For the commandline N4JSC.jar provides special option <literal>-npmrcRootLocation</literal> that allows headless compiler to
+use custom settings.</simpara>
+</section>
+</section>
+<section xml:id="sec:lmFutureWork">
+<title>Future Work</title>
+<simpara>Some aspects not covered in current design, but worth consideration in the future</simpara>
+<section xml:id="subsec:lmMultipleDependencyScope">
+<title>Multiple Dependency Scope</title>
+<simpara>npm scope dependencies</simpara>
+<variablelist>
+<varlistentry>
+<term><emphasis role="strong">DEPENDENCY_DEVELOPMENT</emphasis> </term>
+<listitem>
+<simpara><link xl:href="https://docs.npmjs.com/files/package.json#devdependencies">https://docs.npmjs.com/files/package.json#devdependencies</link></simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><emphasis role="strong">DEPENDENCY_PEER</emphasis> </term>
+<listitem>
+<simpara><link xl:href="https://docs.npmjs.com/files/package.json#peerdependencies">https://docs.npmjs.com/files/package.json#peerdependencies</link></simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><emphasis role="strong">DEPENDENCY_BUNDLE</emphasis> </term>
+<listitem>
+<simpara><link xl:href="https://docs.npmjs.com/files/package.json#bundleddependencies">https://docs.npmjs.com/files/package.json#bundleddependencies</link></simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><emphasis role="strong">DEPENDENCY_OPTIONAL</emphasis> </term>
+<listitem>
+<simpara><link xl:href="https://docs.npmjs.com/files/package.json#optionaldependencies">https://docs.npmjs.com/files/package.json#optionaldependencies</link></simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><emphasis role="strong">DEPENDENCY_PROVIDES</emphasis> </term>
+<listitem>
+<simpara><link xl:href="http://www.rpm.org/wiki/PackagerDocs/Dependencies#Provides">http://www.rpm.org/wiki/PackagerDocs/Dependencies#Provides</link></simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><emphasis role="strong">DEPENDENCY_WEAK</emphasis> </term>
+<listitem>
+<simpara><link xl:href="http://www.rpm.org/wiki/PackagerDocs/Dependencies#Weakdependencies">http://www.rpm.org/wiki/PackagerDocs/Dependencies#Weakdependencies</link></simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+</section>
+<section xml:id="subsec:lmRunTestsFromLibrary">
+<title>Run Tests from TestLibrary</title>
+<simpara>Imagine we are implementing some API, and we want to run tests for that API. Tests are delivered to us as separate package, and there is not direct association between implementation and test projects (tests are not depending on implementation). Still we want to run provided tests to see if our implementation complies with API tests, e.g. AcceptanceTest suite for Application written against application sdk.</simpara>
+</section>
+</section>
+</chapter>
+<chapter xml:id="sec:JSON_Support">
+<title>JSON Support</title>
+<warning>
+<simpara>This chapter may be outdated.</simpara>
+</warning>
+<section xml:id="sec:JSON_Parser">
+<title>JSON Parser</title>
+<simpara>For the JavaScript Object Notation format, a multitude of specifications exist (e.g. [<link linkend="RFC8259">RFC8259</link>], [<link linkend="ECMA404">ECMA404</link>], [<link linkend="RFC7158">RFC7158</link>]). While all specifications agree on the basic structure of JSON, many special cases exist, which remain un-addressed by the specifications. Therefore, in practice many parsers exhibit implementation-specific behavior. See [<link linkend="Ser18">Ser18</link>] for a discussion of many of these cases.</simpara>
+<simpara>The initial grammar of the N4JS JSON parser is mostly based on [<link linkend="ECMA404">ECMA404</link>] while further adaptions have been made to accommodate for special cases such as escaping unicode control characters in string literals. This section discusses the different aspect in which our parser exhibits special behavior in order to parse a maximum of real-world JSON text. If applicable, we will also discuss differences between JSON and the N4JS syntax for object literals.</simpara>
+<section xml:id="sec:JSON_Parser_Unicode_Escaping">
+<title>Escaping Unicode Control Characters in String Literals</title>
+<simpara>In comparison to ECMAScript (and thus N4JS), JSON only requires the escaping of unicode control characters in the range from <literal>U+0000</literal> to <literal>U+001F</literal> when used in a string literal. This includes the line termination characters <literal>U+000A</literal> or <literal>\n</literal> and <literal>U+000D</literal> or <literal>\r</literal>. However, different from ECMAScript, JSON allows the unescaped use of the unicode characters <literal>U+2028</literal> and <literal>U+2029</literal> within string literals. Therefore, the JSON parser differs from the behavior of the N4JS parser.</simpara>
+</section>
+<section xml:id="sec:JSON_Parser_Empty_Text">
+<title>Empty Text</title>
+<simpara>While the abovementioned JSON specifications do not allow for empty JSON text (e.g. no data, only whitespace data), our parser is tolerant towards such inputs. The reason behind this decision is that it allows users of the N4JS IDE, to create new empty JSON files without experiencing any parser errors.</simpara>
+</section>
+<section xml:id="sec:JSON_Parser_Nested_Structures">
+<title>Nested Structures</title>
+<simpara>Since the N4JS JSON parser is implemented in terms of a recursive decent parser, the parsable inputs are limited in terms of nesting. This results in a stack overflow exception for highly nested input data.</simpara>
+</section>
+<section xml:id="sec:JSON_Parser_Whitespace">
+<title>Whitespace</title>
+<simpara>[<link linkend="RFC7158">RFC7158</link>] and [<link linkend="ECMA404">ECMA404</link>] both define whitespace characters of JSON to be exclusively <literal>U+0009</literal>, <literal>U+000A</literal>, <literal>U+000D</literal> and <literal>U+0020</literal>. However, for now we adopt the whitespace strategy of the N4JS parser, which allows for additional whitespace characters (also see [<link linkend="ECMA15a">ECMA15a</link>] section 7.2 White Space). This only applies to JSON text outside of string literals.</simpara>
+</section>
+<section xml:id="sec:JSON_Parser_Comments">
+<title>Comments</title>
+<simpara>Although JSON as a standard does not specify any notion of source code comments, we allow them on a parser level. (single line comments introduced by <literal>//</literal> and multi-line comments using <literal>/*</literal> and <literal>*/</literal>). After parsing, we issue corresponding validation messages that indicate to the user, that such comments will possibly not be parsable in a different context (e.g. by npm in case of package.json files).</simpara>
+</section>
+</section>
+<section xml:id="sec:JSON_Language_Extensions">
+<title>JSON Language Extensions</title>
+<simpara>Generally, our JSON support was implemented with generic JSON support in mind. However, for some types of JSON files (e.g. <literal>package.json</literal> files) we provide custom behavior to better assist the user. This includes custom JSON validators and resource description strategies that only apply to certain types of JSON files. In order to keep our JSON implementation independent from N4JS-specific code, these concerns are separated using an Eclipse Extension Point. In the headless case, extension also need to be registered manually via the <literal>JSONExtensionRegistry</literal>. In the following we present the different aspect in which the JSON language can be extended.</simpara>
+<section xml:id="sec:JSON_Validator_Extensions">
+<title>JSON Validator Extensions</title>
+<simpara>Via the JSON validator extensions (cf. <literal>IJSONValidatorExtension</literal>), other bundles can register JSON validator extensions that introduce domain-specific validation for specific types of JSON files.</simpara>
+<section xml:id="sec:File_Specitic_Validator_Extensions">
+<title>File-Specific Validator Extensions</title>
+<simpara>For every JSON resource that is validated, all registered JSON validator extensions are executed. For a validator extension to be specific to a certain type of file, one may override the Xtext method <literal>isResponsible</literal> which checks whether a validator applies on a per resource basis.</simpara>
+</section>
+<section xml:id="sec:JSON_Declarative_JSON_Validator_Extensions">
+<title>Declarative JSON Validator Extensions</title>
+<simpara>In addition to Xtext&#8217;s <literal>@Check</literal> methods, we provide an annotation <literal>@CheckProperty</literal> that allows to declare JSON-specific check methods that only apply to certain property paths of a JSON document. The <literal>@CheckProperty</literal> annotation can only be used when inheriting from the <literal>AbstractJSONValidatorExtension</literal> class. The following example outlines its usage:</simpara>
+<programlisting language="java" linenumbering="unnumbered">(...)
+@CheckProperty(propertyPath = "prop1")
+public void checkProperty(JSONValue propertyValue) {
+	// validate JSONValue for top-level property 'prop1'
+}
+
+@CheckProperty(propertyPath = "nested.prop2")
+public void checkNestedProperty(JSONValue propertyValue) {
+	// validate JSONValue for the nested property 'nested.prop2'
+}
+(...)</programlisting>
+<simpara>The examples illustrates how property-check-method can be declared. In a JSON document the first check method will only be invoked for the JSON value that is set for top-level property <literal>prop1</literal>. The second check method is invoked for the nested property <literal>prop2</literal> of the object that is set for the top-level property <literal>prop2</literal>.</simpara>
+<programlisting language="json" linenumbering="unnumbered">{
+	"prop1": 1, // checkProperty applies
+	"nested": {
+		"prop2": 2 // checkNestedProperty applies
+	}
+}</programlisting>
+<simpara>When inheriting from the <literal>AbstractJSONValidatorExtension</literal>, the usual <literal>addIssue</literal> methods may be used in order to issue validation messages. Furthermore, the issue codes that are  being used for the messages may originate from the bundle that hosts the validator extension.</simpara>
+</section>
+</section>
+<section xml:id="_json-resource-description-strategy">
+<title>JSON Resource Description Strategy</title>
+<simpara>Via JSON resource description extensions (cf. <literal>IJSONResourceDescriptionExtension</literal>), other bundles can define a custom resource description strategy for specific types of JSON files. As a consequence, these extensions define what information on the contents of a JSON file is stored in the Xtext index (cf. <literal>IResourceDescriptions</literal>).</simpara>
+</section>
+</section>
+</chapter>
+<chapter xml:id="_jsdoc">
+<title>JSDoc</title>
+<warning>
+<simpara>This chapter may be outdated.</simpara>
+</warning>
+<section xml:id="sec:Design_Rationale" role="language-n4js">
+<title>Design Rationale</title>
+<simpara>JSDoc parser provides general API for parsing and obtaining information embedded in comments. This may have low significance for N4JS itself but is essential when working with JS dialects (e.g. vanilla JS) that use JSDoc comments for enrich given dialect with semantic information. Anticipated uses may include: - type information extraction when importing external code - validation of links between commented fragments - supporting markup for documentation</simpara>
+<note>
+<simpara>Although current focus is on migration process we want to provide general solution that can be customized for given use cases</simpara>
+</note>
+<section xml:id="_general-design">
+<title>General Design</title>
+<simpara>When using the API client has to create instance of DocletParser and configure it with <emphasis>LienTag</emphasis>s and <emphasis>InLineTag</emphasis>s that are to be used.</simpara>
+<simpara>LineTags can depend on InlineTags (e.g. InlineTg in description of parameters of the LineTag). API provides support for that but client has to configure this.</simpara>
+<figure xml:id="fig:cd_JSDocParserAPI" role="center">
+<title>JSDoc Parser API (without model)</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/23_jsdoc/images/cd_JSDocParserAPI.svg"/>
+</imageobject>
+<textobject><phrase>cd JSDocParserAPI</phrase></textobject>
+</mediaobject>
+</figure>
+<simpara>Initiated DocletParser can be used to parse <emphasis>String</emphasis> containing given JSDoc comment.Based on provided <emphasis>ITagDefinition</emphasis>s parser will parse input string and return JSDoc DOM AST (see fig. XX with ecore diagram). By querying tree structure client can obtain information extracted form parsed input String.</simpara>
+<figure xml:id="fig:cd_JSDocModel" role="center">
+<title>JSDoc AST/DOM Model</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/23_jsdoc/images/cd_JSDocModel.svg"/>
+</imageobject>
+<textobject><phrase>cd JSDocModel</phrase></textobject>
+</mediaobject>
+</figure>
+<simpara>The root of the this AST is the Doclet. The doclet itself contains some content (as it is a Composite containing ContentNodes), usually Description and an arbitrary number of LineTags. LineTags are created by custom ITagDefinition implementations that extend AbstractLineTagDefinition. They contain the title and an arbitrary number of values, stored in a map. These values are Composite nodes as well, containing tag specific content. E.g., the parameter tag will create the values for the parameter type, the parameter name, and the description. Description (in LineTags as well as in doclet itself) is free text with optional InlineTags. InlineTags are created by custom ITagDefinition that extends AbstractInlineTagDefinition. In general tag values are designed as a comprise between a very general tree (basically containing only text nodes) and a structured typed tree (containing type expressions etc.). Although it should be possible to model a tag value by only using Text nodes, some special typed nodes are provided for sake of simplicity (and probably performance). E.g., TypeReferences are modeled using a typed node, in order to simplify external handling of these references (for type analysis, and refactorings such as renaming a type). New typed nodes will probably be introduced (see below). Markers can be attached to nodes for internal purposes. E.g., a marker can be used to distinguish different syntax versions of defining an array (<literal>String[]</literal> vs. <literal>Array&lt;String&gt;</literal>).Literals can be used to simplify rewriting. That is, they can contain information on line breaks, JSDoc line prefixes etc., which are not needed for the semantics of a tag, but only for the syntax (not used yet). Also, each node contains a position for simplifying rewriting.</simpara>
+<figure xml:id="fig:cd_JSDocParserAndModel" role="center">
+<title>JSDoc Parser and Model</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/23_jsdoc/images/cd_JSDocParserAndModel.svg"/>
+</imageobject>
+<textobject><phrase>cd JSDocParserAndModel</phrase></textobject>
+</mediaobject>
+</figure>
+</section>
+<section xml:id="sec:Type_Expressions">
+<title>Type Expressions</title>
+<simpara>Type expressions are are not handled by JSDoc Parser by itself as instances of the grammars are use case specific, e.g. for migration purposes grammar for type expressions used in migration process is specific to the in question therefore specific type expressions parser will be provided separately.DocLetParser by default can only extract String representing given type expression, parsing and interpreting it stays in responsibility of given tag implementation provided by the client.</simpara>
+</section>
+</section>
+</chapter>
+<chapter xml:id="_docexporter">
+<title>DocExporter</title>
+<warning>
+<simpara>This chapter may be outdated.</simpara>
+</warning>
+<simpara>The DocExporter exports JavaDoc from source files to adoc files.
+In particular it combines information about methods with tests in order to create specification documents.</simpara>
+<section xml:id="sec:Specification_Exporter">
+<title>Specification Exporter</title>
+<simpara>The specification exporter creates and merges artifacts.
+<link linkend="fig:api_test_spec">Fig. API Test Spec</link> sketches the relation between API (i.e., n4jsd files with classifiers),
+tests (i.e., N4JS test classes and methods), and specification (Documentation with JSDOC markers).</simpara>
+<figure xml:id="fig:api_test_spec" role="center">
+<title>Component/Class pseudo diagram: Relation API, Tests and Specification</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/24_docexporter/images/api_test_spec.svg"/>
+</imageobject>
+<textobject><phrase>api test spec</phrase></textobject>
+</mediaobject>
+</figure>
+<simpara><link linkend="fig:cd_jsdocreader">Fig. Exporter</link> shows the classes that read and analyze Java source documentation.</simpara>
+<figure xml:id="fig:cd_jsdocreader" role="center">
+<title>Java reader classes</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/24_docexporter/images/cd_jsdocreader.svg"/>
+</imageobject>
+<textobject><phrase>cd jsdocreader</phrase></textobject>
+</mediaobject>
+</figure>
+<simpara><link linkend="fig:cd_adocexporter">Fig. Exporter</link> shows the content classes of the exporter that contain the generated documentation contents.</simpara>
+<figure xml:id="fig:cd_adocexporter" role="center">
+<title>Exporter content classes</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/24_docexporter/images/cd_adocexporter.svg"/>
+</imageobject>
+<textobject><phrase>cd adocexporter</phrase></textobject>
+</mediaobject>
+</figure>
+<simpara><link linkend="fig:cd_docexporter_model">Fig. DocExporter Model</link> shows the model, which may be used for other doc exporters as well.</simpara>
+<figure xml:id="fig:cd_docexporter_model" role="center">
+<title>Exporter model classes</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/24_docexporter/images/cd_docexporter_model.svg"/>
+</imageobject>
+<textobject><phrase>cd docexporter model</phrase></textobject>
+</mediaobject>
+</figure>
+</section>
+</chapter>
+<chapter xml:id="_rename-refactoring">
+<title>Rename Refactoring</title>
+<simpara>The rename refactoring operation is implemented based on current Xtext&#8217;s rename refactoring implementation. However, lots of customization have been done in order to make Rename Refactoring work for N4JS. In order to understand N4JS customization, it is imperative to understand how Xtext implements rename refactoring. In this chapter, we will focus on Xtext&#8217;s architecture for rename refactoring. Additionally, we will point to the components that have been customized for N4JS.</simpara>
+<section xml:id="_rename-refactoring-ui-interaction">
+<title>Rename Refactoring UI interaction</title>
+<simpara>Xtext&#8217;s implementation allows rename refactoring be in either one of two modes (1) Direct refactoring mode (3) Refactoring with dialog mode. Diagram <link linkend="fig:rename_refactoring_communication_diagram_part1">Direct Rename Refactoring UI interaction</link> shows the UI interaction in <emphasis>direct refactoring mode</emphasis>.</simpara>
+<informalfigure xml:id="fig:rename_refactoring_communication_diagram_part1" role="center">
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/25_renameRefactoring/images/rename_refactoring_communication_diagram_part1.svg"/>
+</imageobject>
+<textobject><phrase>title-"Direct Rename Refactoring UI interaction"</phrase></textobject>
+</mediaobject>
+</informalfigure>
+<simpara>In this diagram, the classes in yellow are customized by N4JS implementation to handle N4JS-specific characteristics.</simpara>
+<itemizedlist>
+<listitem>
+<simpara><literal>DefaultRenameElementHandler</literal>: Our custom N4JS implementation converts the selected element to be renamed into its corresponding TModule element.</simpara>
+</listitem>
+<listitem>
+<simpara><literal>ILinkedPositionGroupCalculator</literal>: This class is responsible for calculating locations of names to be changed during linked edit mode. We need to provide a custom N4JS implementation to handle composed elements.</simpara>
+</listitem>
+<listitem>
+<simpara><literal>RenameElementProcessor</literal>: We need to provide a custom N4JS implementation to add N4JS-specific validation of conditions, e.g. checking name conflicts etc.</simpara>
+</listitem>
+</itemizedlist>
+<simpara>The key class for creating updates of a declaration and its associated references is <literal>RenameElementProcessor</literal>. In the following section, we will see how this class interacts with other classes to achieve this.</simpara>
+</section>
+<section xml:id="_renameelementprocessor-interaction">
+<title>RenameElementProcessor interaction</title>
+<simpara>Diagram <link linkend="fig:rename_refactoring_communication_diagram_part2">RenameElementProcessor interaction</link> shows the interaction of <literal>RenameElementProcessor</literal> and other classes to create changes for both declaration and references during rename refactoring.</simpara>
+<informalfigure xml:id="fig:rename_refactoring_communication_diagram_part2" role="center">
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/25_renameRefactoring/images/rename_refactoring_communication_diagram_part2.svg"/>
+</imageobject>
+<textobject><phrase>title-"RenameElementProcessor interaction"</phrase></textobject>
+</mediaobject>
+</informalfigure>
+<simpara>As seen in the diagram, there are two stages of creating updates:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>Creating updates for declaration is done by <literal>IRenameStrategy</literal> and</simpara>
+</listitem>
+<listitem>
+<simpara>Creating updates for references is done by <literal>ReferenceUpdateDispatcher</literal>. <literal>ReferenceUpdateDispatcher</literal> in turn delegates the finding of references to <literal>IReferenceFinder</literal>.</simpara>
+</listitem>
+</orderedlist>
+<simpara>The text edits for changing the definition and the references are accumulated by an <literal>IRefactoringUpdateAcceptor</literal>.</simpara>
+<simpara>The classes in yellow are customized by N4JS implementation.</simpara>
+<itemizedlist>
+<listitem>
+<simpara><literal>IRenameStrategy</literal>: the custom N4JS implementation creates updates for constituent members of composed elements.</simpara>
+</listitem>
+<listitem>
+<simpara><literal>IReferenceFinder</literal>: the custom N4JS implementation used for finding references of a declaration.</simpara>
+</listitem>
+<listitem>
+<simpara><literal>RefactoringCrossReferenceSerializer</literal>: custom N4JS implementation to retrieve the updated name for cross references. For some unknown reason, the default implementation does not work correctly.</simpara>
+</listitem>
+</itemizedlist>
+</section>
+</chapter>
+<chapter xml:id="chap:flowgraphs">
+<title>Flow Graphs</title>
+<section xml:id="sec:flowgraphs_overview" role="language-n4js">
+<title>Flow graphs overview</title>
+<simpara>In this chapter, the control and data flow analyses are introduced.
+Since not all AST elements are relevant for the control or data flow analyses, a new marker class is introduced called <literal>ControlFlowElement</literal>.
+All AST elements which are part of the control flow graph implement this class.
+The term control flow is abbreviated as <emphasis>CF</emphasis> and hence <literal>ControlFlowElement</literal>s are abbreviated as <emphasis>CF elements</emphasis>.</simpara>
+<simpara></simpara>
+<sidebar>
+<simpara><link xl:href="https://github.com/eclipse/n4js/issues/120"><inlinemediaobject>
+<imageobject>
+<imagedata fileref="images/issue.svg"/>
+</imageobject>
+<textobject><phrase></phrase></textobject>
+</inlinemediaobject> #120</link></simpara>
+</sidebar>
+<simpara>The following picture shows the control flow graph of the function <literal>f</literal>.</simpara>
+<figure>
+<title>Control flow graph of a simple function</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/30_flowgraphs/images/cfg_for_loop.png"/>
+</imageobject>
+<textobject><phrase>cfg for loop</phrase></textobject>
+</mediaobject>
+</figure>
+<section xml:id="_internal-graph">
+<title>Internal graph</title>
+<simpara>Every <emphasis>internal graph</emphasis> refers to a single <emphasis>control flow container</emphasis>.
+The graph consists of <emphasis>nodes</emphasis> and <emphasis>edges</emphasis>, where the edges are instances of <literal>ControlFlowEdge</literal>, and nodes are instances of <literal>Node</literal>.
+Additionally, a so called <emphasis>complex node</emphasis> is used to group nodes that belong to the same CF element.</simpara>
+<variablelist>
+<varlistentry>
+<term>Internal graph</term>
+<listitem>
+<simpara>Control flow graphs are created based on the AST elements.
+Nevertheless, a fine-grained abstraction is used that is called <emphasis>internal graph</emphasis>.
+The internal graph reflects all control flows and data effects that happen implicitly and are part of the language&#8217;s semantics.
+For instance, the for-of statement on iterable objects forks the control flow after invoking the <literal>next()</literal> method.
+This is done implicitly and not part of the written source code.
+Moreover, this invocation could cause side effects.
+These control flows and effects are reflected using the internal graph.
+To implement analyses that refer to AST elements, an API for flow analyses is provided which hides the internal graph and works with AST elements only.
+In the following, the term <emphasis>control flow graph</emphasis> refers to the internal graph.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>Control flow container</term>
+<listitem>
+<simpara>At several places in the AST, an execution of statements or elements can happen.
+Obviously, statements can be executed in bodies of methods or function expressions.
+In addition, execution can also happen in field initializers or the <literal>Script</literal> itself.
+Since all these AST elements can contain executable control flow elements (CF elements), they thus contain a control flow graph.
+In the following, these AST elements are called <emphasis>control flow containers</emphasis> or CF containers.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>Nodes</term>
+<listitem>
+<simpara>Nodes represent complete CF elements or parts of them.
+For instance, simple CF elements like a <literal>break</literal> statement are represented using only one node.
+Regarding more complex CF elements that introduce a more complex control flow, due to e.g. nested expressions, several nodes represent one CF element.
+All nodes of a single CF element are grouped within a complex node.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>Edges</term>
+<listitem>
+<simpara>Edges reference a start and an end node which reflects a forward control flow direction, which is in the following called forward traverse direction.
+Traversing from end to start of an edge is thus called backward traverse direction.
+The so called <emphasis>next node</emphasis> is either the end node in context of forward, or the start node in context of backward traverse direction.
+Edges also reflect the reason of the control flow using a control flow type.
+The default control flow type is called <literal>Successor</literal> and such edges connect two ordinary subsequent nodes.
+Other types like <literal>Return</literal> or <literal>Break</literal> indicate control flow that happens due to return or break statements.
+A special control flow type is <literal>Repeat</literal> that indicates the entry of a loop body.
+This edge is treated specially when traversing the control flow graph to avoid infinitive traversals of loops.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>Complex node</term>
+<listitem>
+<simpara>The complex node always has a single entry and exit node, no matter the control flow it causes.
+For instance, although the for-statement can contain various control flows among its nested CF elements, its complex node still has a single entry and exit node.
+This simplifies concatenating subsequent complex nodes, since only their exit nodes have to be connected to the following entry node.
+Aside from exit and entry node, a complex node usually contains additionally nodes to represent the CF element.
+These nodes are connected by control flow edge so that their control flow lies within complex node.
+However, regarding nested CF elements, the control flow leaves and re-enters a complex node.
+To specify which CF element is nested, a delegating node (<literal>DelegatingNode</literal>) is created that points to the nested CF element.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+<simpara>Consider that source code elements can be nested like expressions that have sub-expressions as in <literal>1 + 2 * 3</literal>.
+Also statements can contain other statements like in <literal>if (true) return;</literal>.
+The design of the control flow graph deals with this nesting by mapping CF elements to several nodes.
+All nodes of one CF element are aggregated into the <emphasis>complex node</emphasis>.</simpara>
+<figure xml:id="img:internalGraph">
+<title>The source code of <literal>1+2</literal> creates an internal graph of three complex nodes to deal with nested integer literals</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/30_flowgraphs/images/internalGraph.png"/>
+</imageobject>
+<textobject><phrase>internalGraph</phrase></textobject>
+</mediaobject>
+</figure>
+<simpara>The example in the <link linkend="img:internalGraph">figure above</link> shows the internal graph produced by the source code <literal>1+2</literal>.
+Additionally, a simpler version of the internal graph is shown (called <emphasis>User Graph View</emphasis>), with which client analyses deal.
+The user graph view is only a view on the internal graph, but does not exist as an own instance.
+In the figure, the nesting of the integer literals becomes obvious:
+The control flow edges of delegating nodes targets entry nodes of different CF elements.
+Also, there are CF edges from the exit nodes of these nested CF elements to return the control flow.</simpara>
+<figure xml:id="img:cn_for_stmt">
+<title>Complex Node of for statement</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/30_flowgraphs/images/cn_for_stmt.png"/>
+</imageobject>
+<textobject><phrase>cn for stmt</phrase></textobject>
+</mediaobject>
+</figure>
+<simpara>In the <link linkend="img:cn_for_stmt">above figure</link>, the complex node of the for statement is shown.
+The details of the complex nodes of the nested CF elements (such as the initializer or the body statement) are omitted.
+The figure displays the control flow fork after the condition and also shows the <emphasis>Repeat</emphasis> edge that targets the for body.
+The node called <emphasis>Catch Node</emphasis> is used in situations when there are jumping control flows introduced for instance by a continue statement.
+The catch will will then be the target of an control flow edge that starts at the continue statement.</simpara>
+<simpara>The graph of nodes and edges is constructed in the following order.</simpara>
+<itemizedlist>
+<listitem>
+<simpara>First, for every CF element a complex node and all its nodes are created.
+Also, the nodes within the complex node are connected according to their control flow behavior.</simpara>
+</listitem>
+<listitem>
+<simpara>Second, all subsequent complex nodes are connected by connecting their exit and entry nodes.
+Moreover, nested complex nodes are connected by interpreting the delegating nodes.</simpara>
+</listitem>
+<listitem>
+<simpara>Third, jumping control due to <literal>return</literal>, <literal>throw</literal>, <literal>break</literal> or <literal>continue</literal> statements is computed.
+This is done by first deleting the successor edge of the jumping statement and introducing a new control flow edge that ends at the jump target.</simpara>
+</listitem>
+</itemizedlist>
+</section>
+<section xml:id="_optimizations">
+<title>Optimizations</title>
+<simpara>The internal graph contains many nodes to simplify the graph construction.
+However, these nodes carry no relevant information when traversing the graph.
+Consequently, in an optimization step, they are removed from the graph for performance reasons.</simpara>
+<simpara>A node removal for a node <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>n</mi><mn>2</mn></msub></math> is done by replacing the path <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>n</mi><mn>1</mn></msub><mo>-</mo><mo>&gt;</mo><msub><mi>n</mi><mn>2</mn></msub><mo>-</mo><mo>&gt;</mo><msub><mi>n</mi><mn>3</mn></msub></math> by the new path <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>n</mi><mn>1</mn></msub><mo>-</mo><mo>&gt;</mo><msub><mi>n</mi><mn>3</mn></msub></math>.
+These removals are done for delegating nodes that only have one incoming and one outgoing edge.</simpara>
+<simpara>A second kind but similar optimization reduces the number of helper nodes that are used as entry nodes.
+In case a complex nodes consists only of exactly one entry and one exit node, both of these nodes are collapsed into one node.
+This remaining node then is the representing node of the AST element.</simpara>
+</section>
+<section xml:id="_api-for-client-analyses">
+<title>API for client analyses</title>
+<simpara>To implement client analyses based on the control flow graph, the three classes <literal>GraphVisitor</literal>, <literal>GraphExplorer</literal> and <literal>BranchWalker</literal> are provided.
+They provide the means to visit CF elements in a control flow graph and also to traverse single control flow paths.
+The method <literal>N4JSFlowAnalyses#analyze</literal> can execute several client analyses in one run to maintain scalability.</simpara>
+<section xml:id="_mapping-from-internal-to-ast-elements">
+<title>Mapping from internal to AST elements</title>
+<simpara>The API classes work with AST elements such as <literal>ControlFlowElement</literal> instead of the internally used graph classes <literal>ComplexNode</literal>, <literal>Node</literal> or <literal>ControlFlowEdge</literal>.
+The mapping from internal classes to AST elements is done in the <literal>GraphVisitor</literal> class.</simpara>
+<simpara>Note that the control flow graph has the following properties:</simpara>
+<itemizedlist>
+<listitem>
+<simpara><literal>ExpressionStatement</literal>s are not represented.
+Instead, only their expressions are represented.
+Nevertheless, the API can deal with calls that refer to expression statements, e.g. when requesting their successors.</simpara>
+</listitem>
+<listitem>
+<simpara>Control statements are also not represented in the graph, but can also be used in calls to the API.
+The reason is, that it is unclear when a control statement (e.g. a for loop) is visited exactly.</simpara>
+</listitem>
+<listitem>
+<simpara>Since a <literal>FlowEdge</literal> which connects two <literal>ControlFlowElement</literal>s can represent multiple internal edges, it can have multiple <literal>ControlFlowType</literal>s.</simpara>
+</listitem>
+</itemizedlist>
+</section>
+<section xml:id="_graph-visitor">
+<title>Graph visitor</title>
+<simpara>Graph visitors traverse the control flow graphs of every CF container of a script instance in the following two traverse directions:</simpara>
+<itemizedlist>
+<listitem>
+<simpara><emphasis>Forward</emphasis>: from the container&#8217;s start to all reachable CF graph elements.</simpara>
+</listitem>
+<listitem>
+<simpara><emphasis>Backward</emphasis>: from the container&#8217;s end to all reachable CF graph elements.</simpara>
+</listitem>
+</itemizedlist>
+<simpara>In each traverse direction, the graph visitor visits every reachable CF element and edge.
+Note that neither empty statements nor control statements are part of the control flow graph.
+The order of visited CF elements is related to either a breadth or a depth search on the CF graph.
+However, no specific order assumptions are guaranteed.</simpara>
+<figure>
+<title>The CF elements <literal>"loop"</literal> and <literal>"end"</literal> are dead code and displayed in grey.</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/30_flowgraphs/images/deadcode.png"/>
+</imageobject>
+<textobject><phrase>deadcode</phrase></textobject>
+</mediaobject>
+</figure>
+</section>
+<section xml:id="_graph-explorer">
+<title>Graph explorer</title>
+<simpara>Graph visitors can request a <emphasis>graph explorer</emphasis> to be activated under specific conditions related to the client analysis.
+A graph explorer is the start point to analyze control flow branches.
+The first control flow branches is started directly at the graph explorer&#8217;s creation site, but of course this first branches might fork eventually.
+The graph explorer keeps track of all forked branches that originate at its activation site.
+It also provides the means to join previously forked branches again.</simpara>
+</section>
+<section xml:id="_branch-walker">
+<title>Branch walker</title>
+<simpara>With every graph explorer, a branch walker is created that traverses the control flow graph beginning from the activation site of the graph explorer.
+On every such branch, the two visit methods of CF elements and edges respectively, are called in the order of the traverse direction.
+Every time the branch forks, the fork method of the branch walker is invoked and creates another branch walker which will continue the traversal on the forked branch.
+The fork method can be used to copy some path data or state to the newly forked branch walker.
+Note that every edge is always followed by the branch walker except for repeat edges which are followed exactly twice.
+The reason to follow them twice is that first, following them only once would hide those control flows that re-visit the same CF elements due to the loop.
+Second, following them more than twice does not reveal more insights, but only increases the number of branches.
+When control flow branches merge again, for instance at the end of an <literal>if</literal>-statement, two or more branch walkers are merged into a new succeeding one.
+The graph explorer provides the means to do this.
+In case a CF element has no next elements, the branch walker terminates.</simpara>
+</section>
+<section xml:id="_example-1-compute-string-for-each-path">
+<title>Example 1: Compute string for each path</title>
+<simpara>Let&#8217;s assume that we want to compute all control flow branches of a function and use the client API for that.
+The function <literal>f()</literal> in the following code snippet has four control flow branches: <literal>1 &#8594; 2</literal>, <literal>&#8594; 3 &#8594;</literal>, <literal>&#8594; 4 &#8594;</literal> and <literal>5</literal>.</simpara>
+<formalpara>
+<title>Function <literal>f()</literal> has four control flow branches.</title>
+<para>
+<screen>function f() {
+	1;
+	if (2)
+		3;
+	else
+		4;
+	5;
+}</screen>
+</para>
+</formalpara>
+<simpara>To compute these control flow branches, the class <literal>AllBranchPrintVisitor</literal> extends the <literal>GraphVisitor</literal>.
+Already in the method <literal>initializeMode()</literal> a graph explorer is activated.
+Note that the method <literal>requestActivation()</literal> can be understood as a <literal>addListener</literal> method for a listener that listens to visit events on nodes and edges.
+Immediately after the activation request, the first branch walker is created in the method <literal>firstBranchWalker()</literal>.</simpara>
+<simpara>The first visited CF element of the branch walker will then be the expression <literal>1</literal>.
+It is formed into a string and added to the variable <literal>curString</literal>.
+After expression <literal>1</literal>, the flow edge from <literal>1</literal> to <literal>2</literal> is visited.
+This will concatenate the string <literal>&#8594;</literal> to the path string.
+Variable <literal>curString</literal> will eventually hold the branch string like <literal>1 &#8594; 2</literal>.
+Since the control flow forks after <literal>2</literal>, the method <literal>forkPath()</literal> is called and creates two new instances of a branch walker.
+These new instances succeed the the first branch walker instance and each traverses one of the branches of the <literal>if</literal>-statement.
+When the <literal>if</literal>-statement is passed, these two branches are merged into a new succeeding branch walker.
+After all branch walkers are terminated, the graph explorer and graph visitor are also terminated.
+The method <literal>getBranchStrings()</literal> collects all four computed strings from the variable <literal>curString</literal> of all branch walkers.</simpara>
+<formalpara>
+<title>Implementation of a graph visitor that computes all control flow paths</title>
+<para>
+<screen>class AllBranchPrintVisitor extends GraphVisitor {
+	protected void initializeMode(Mode curDirection, ControlFlowElement curContainer) {
+		super.requestActivation(new AllBranchPrintExplorer());
+	}
+
+	class AllBranchPrintExplorer extends GraphExplorer {
+		class AllBranchPrintWalker extends BranchWalker {
+			String curString = "";
+
+			protected void visit(ControlFlowElement cfe) {
+				curString += cfe.toString();
+			}
+
+			protected void visit(FlowEdge edge) {
+				curString += " -&gt; ";
+			}
+
+			protected AllBranchPrintWalker forkPath() {
+				return new AllBranchPrintWalker();
+			}
+		}
+
+		protected BranchWalker joinBranches(List&lt;BranchWalker&gt; branchWalkers) {
+			// TODO Auto-generated method stub
+			return null;
+		}
+
+		protected BranchWalkerInternal firstBranchWalker() {
+			return new AllBranchPrintWalker();
+		}
+	}
+
+	List&lt;String&gt; getBranchStrings() {
+		List&lt;String&gt; branchStrings = new LinkedList&lt;&gt;();
+		for (GraphExplorerInternal app : getActivatedExplorers()) {
+			for (BranchWalkerInternal ap : app.getAllBranches()) {
+				AllBranchPrintWalker printPath = (AllBranchPrintWalker) ap;
+				branchStrings.add(printPath.curString);
+			}
+		}
+		return branchStrings;
+	}
+}</screen>
+</para>
+</formalpara>
+</section>
+<section xml:id="_path-quantor">
+<title>Path quantor</title>
+<simpara>Graph explorers are typically used to reason on all branch walkers that start at a specific location.
+For instance, such a reasoning might determine whether some source element is reachable or whether a variable is used or not.
+To simplify this, quantors are provided.
+Since branch walkers originating from a single activation point can fork, the reasoning has to include all these forked branch walkers.
+Hence, graph explorers are instantiated using a quantor which can be either <emphasis>For All</emphasis>, <emphasis>At Least One</emphasis> OR <emphasis>None</emphasis> that refers to all branches.
+After all branch walkers of an explorer are terminated, the explorer is regarded as either passed or failed.
+Paths also can be aborted manually using the methods <literal>pass()</literal> or <literal>fail()</literal>.
+When <emphasis>pass</emphasis> or <emphasis>fail</emphasis> are used, the graph explorer might be terminated in the following cases:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>If the quantor of the graph explorer is <emphasis>For All</emphasis>, and <literal>fail()</literal> is called on a branch walker.</simpara>
+</listitem>
+<listitem>
+<simpara>If the quantor of the graph explorer is <emphasis>At Least One</emphasis>, and <literal>pass()</literal> is called on a branch walker.</simpara>
+</listitem>
+</itemizedlist>
+<simpara>Additionally, a graph explorer can be aborted manually by canceling all its branches.</simpara>
+</section>
+</section>
+<section xml:id="_control-flow-analyses">
+<title>Control flow analyses</title>
+<section xml:id="_dead-code-analysis">
+<title>Dead code analysis</title>
+<simpara>The dead code analysis uses the graph visitor in all four modes and collects all visited CF elements.
+The collected CF elements are saved separately for every mode.
+After the graph visitor is terminated, the unreachable CF elements are computed like follows:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>CF elements, that are collected during forward and catch block mode are reachable.</simpara>
+</listitem>
+<listitem>
+<simpara>CF elements, that are collected during islands mode are unreachable.</simpara>
+</listitem>
+<listitem>
+<simpara>CF elements, that are <emphasis>only</emphasis> collected during backward mode, are also unreachable.</simpara>
+</listitem>
+</itemizedlist>
+<simpara>In a later step, the unreachable elements are merged into unreachable text regions that are used for error markers.</simpara>
+</section>
+</section>
+</section>
+<section xml:id="sec:dataflow" role="language-n4js">
+<title>Dataflow</title>
+<simpara></simpara>
+<sidebar>
+<simpara><link xl:href="https://github.com/eclipse/n4js/issues/331"><inlinemediaobject>
+<imageobject>
+<imagedata fileref="images/issue.svg"/>
+</imageobject>
+<textobject><phrase></phrase></textobject>
+</inlinemediaobject> #331</link>
+<link xl:href="https://github.com/eclipse/n4js/issues/464"><inlinemediaobject>
+<imageobject>
+<imagedata fileref="images/issue.svg"/>
+</imageobject>
+<textobject><phrase></phrase></textobject>
+</inlinemediaobject> #464</link></simpara>
+</sidebar>
+<section xml:id="_dataflow-graph">
+<title>Dataflow graph</title>
+<simpara>The data flow graph provides means to reason about <emphasis>symbols</emphasis>, <emphasis>effects</emphasis>, <emphasis>data flow</emphasis>, <emphasis>aliases</emphasis> and <emphasis>guards</emphasis> in the control flow graph.
+The main classes of the data flow API are <literal>DataflowVisitor</literal> and <literal>Assumption</literal>.</simpara>
+<variablelist>
+<varlistentry>
+<term>Symbol</term>
+<listitem>
+<simpara>Symbols represent a program variable in the sence that it represents all AST elements, that bind to the same variable declaration (according to scoping).
+The terms <emphasis>symbol</emphasis> and <emphasis>variable</emphasis> are used synonymously.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>Effect</term>
+<listitem>
+<simpara>Effects are reads, writes and declarations of symbols.
+For instance, a typical CF element with a write effect is an assignment such as <literal>a = null;</literal>.
+Every effect refers to a single symbol and graph node.
+The following effects are provided:</simpara>
+<itemizedlist>
+<listitem>
+<simpara><emphasis>Declaration</emphasis>: is the declaration of a variable.</simpara>
+</listitem>
+<listitem>
+<simpara><emphasis>Write</emphasis>: is the definition of a variable&#8217;s value, which is typically done with an assignment.</simpara>
+</listitem>
+<listitem>
+<simpara><emphasis>Read</emphasis>: is the read of a variable&#8217;s value, which could happen when passing a variable as an argument to a method call.</simpara>
+</listitem>
+<listitem>
+<simpara><emphasis>MethodCall</emphasis>: is the call of a property method of a variable.</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+</varlistentry>
+</variablelist>
+<simpara>Note that the term <emphasis>value use</emphasis> means either write or method call of a variable.
+The term <emphasis>value definition</emphasis> means that a variable is written.</simpara>
+<variablelist>
+<varlistentry>
+<term>Data flow</term>
+<listitem>
+<simpara>The term data flow is used for assignments of all kind.
+For instance, the assigments <literal>a = b</literal>, <literal>a = 1</literal>, <literal>a = null</literal> or even <literal>for (let [a] of [[0],[undefined]]);</literal> are data flows.
+The data is always flowing from the right hand side to the left hand side.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>Alias</term>
+<listitem>
+<simpara>Due to data flow, other symbols can get important for an analysis.
+For instance, the data flow <literal>a = b</literal> makes <literal>b</literal> important when reasoning about <literal>a</literal> since the value of <literal>b</literal> is assigned to <literal>a</literal>.
+In the API is <literal>b</literal> therefore called an alias of <literal>a</literal>.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>Guard</term>
+<listitem>
+<simpara>Guards are conditions that appear in e.g. <literal>it</literal>-statements.
+For instance, a typical guard is the null-check in the following statement: <literal>if (a == null) foo();</literal>.
+For every CF element, guards can hold either <emphasis>always</emphasis>, <emphasis>never</emphasis> or <emphasis>sometimes</emphasis>.
+Note that the null-check-guard always holds at the method invocation <literal>foo();</literal>.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>DataflowVisitor</literal></term>
+<listitem>
+<simpara>The class <literal>DataflowVisitor</literal> provides means to visit all code locations where either effects happen or guards are declared.
+For instance, when a variable is written, the callback method <literal>DataflowVisitor#visitEffect(EffectInfo effect, ControlFlowElement cfe)</literal> gets called.
+In case a guard is declared, the callback method <literal>visitGuard(Guard guard)</literal> gets called.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>Assumption</literal></term>
+<listitem>
+<simpara>The class <literal>Assumption</literal> provides means to track the data flow of a specific symbol from a specific code location.
+For instance, assumptions are used to detect whether the symbol <literal>s</literal> in the property access <literal>s.prop</literal> is or may be undefined.
+In this example, the assumption symbol is <literal>s</literal> and its start location is the property access.
+From there, the data flow of <literal>s</literal> is tracked in backwards traverse direction.
+Also, (transitive) aliases of <literal>s</literal> are tracked.
+In case a data flow that happens on <literal>s</literal> or its aliases, the callback method <literal>holdsOnDataflow(Symbol lhs, Symbol rSymbol, Expression rValue)</literal> is called.
+For every effect that affects <literal>s</literal> or one of its aliases, the callback method <literal>holdsOnEffect(EffectInfo effect, ControlFlowElement container)</literal> is called.
+And finally, for all guards that hold always/never at the start location regarding symbol <literal>s</literal>, the callback method <literal>holdsOnGuards(Multimap&lt;GuardType, Guard&gt; neverHolding, Multimap&lt;GuardType, Guard&gt; alwaysHolding)</literal> is called.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+</section>
+<section xml:id="_dataflow-analyses">
+<title>Dataflow analyses</title>
+<section xml:id="_def-def-def-nothing-analysis">
+<title>Def&#8594;Def / Def&#8594;Nothing analysis</title>
+<simpara>A Def&#8594;Def analysis finds all defintions of a variable that are always a predecessor of another definition.
+Its result is a set of all obsolete definition sites.</simpara>
+<simpara>A Def&#8594;!Use analysis finds all definitions of a variable that are not followed by either a read or a method call.
+These definition are therefore obsolete and can be removed.</simpara>
+<simpara>Both of these analyses are performed in traverse direction <emphasis>Forward</emphasis>.</simpara>
+</section>
+<section xml:id="_def-use-decl-analysis">
+<title>Def|Use&#8592;Decl analysis</title>
+<simpara>A Def|Use&#8592;Decl analysis finds all preceding <emphasis>def</emphasis> or <emphasis>use</emphasis> sites of a declarations of a specific variable.
+The paths might contain other <emphasis>defs</emphasis> or <emphasis>uses</emphasis> of the same variable.
+In case such paths exists, the variable is used before it is declared.
+This analysis is done in traverse direction <emphasis>Backward</emphasis>.</simpara>
+<figure xml:id="img:usedBeforeDeclaredAnalysis">
+<title>Finding use or def sites can be done using the graph visitor in traverse direction <emphasis>Backward</emphasis>.</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/30_flowgraphs/images/usedBeforeDeclaredAnalysis.png"/>
+</imageobject>
+<textobject><phrase>usedBeforeDeclaredAnalysis</phrase></textobject>
+</mediaobject>
+</figure>
+<simpara>In the <link linkend="img:usedBeforeDeclaredAnalysis">above figure</link> a graph visitor would visit all CF elements.
+When it visits the declaration in line 8 (<literal>let w</literal>), it will activate a graph explorer (star 1 in the figure) for variable <literal>w</literal>.
+Now, the first branch walker <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>b</mi><mn>1</mn></msub></math> is created and walks the control in backward traverse direction.
+When <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>b</mi><mn>1</mn></msub></math> encounters the exit node of the <literal>if</literal>-statement, it will create two forked branches <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>b</mi><mn>2</mn></msub></math> and <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>b</mi><mn>3</mn></msub></math>.
+Now, <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>b</mi><mn>2</mn></msub></math> enters then the branch of the <literal>if</literal>-statement (star 2), while <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>b</mi><mn>3</mn></msub></math> traverses directly to the condition of the <literal>if</literal>-statement.
+Next, <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>b</mi><mn>2</mn></msub></math> visits the def site of variable <literal>w</literal> (star 3).
+This means, that there exist a def site of <literal>w</literal> before <literal>w</literal> was declared and hence, an error should be shown.
+Since there could exist more cases like this, neither the branch walker nor the graph explorer are terminated.
+When reaching star 4, the two branch walkers <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>b</mi><mn>2</mn></msub></math> and <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>b</mi><mn>3</mn></msub></math> are joined and the follow-up branch walker <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>b</mi><mn>4</mn></msub></math> is created.
+At star 5, the end the CF container is reached and the <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>b</mi><mn>4</mn></msub></math> will be terminated.
+After all branch walkers are terminated, the graph explorer for the declaration site of variable <literal>w</literal> is evaluated:
+All use or def sites, that were reachable should be marked with an error saying that the declaration has to be located before the use of a variable.</simpara>
+<simpara>Note this analysis is currently implemented as a control flow analysis since it does not rely on guards, aliases.
+Also, it only relies on local variables and hence does not need the symbols that are provided by the data flow API.</simpara>
+</section>
+</section>
+</section>
+</chapter>
+<chapter xml:id="sec:publish-npms-to-public">
+<title>Publish npms</title>
+<simpara>We publish npms located in the folder <literal>n4js-libs</literal> to the <link xl:href="registry.npmjs.org">public npm registry</link>. Specifically, the following npms are published:</simpara>
+<variablelist>
+<varlistentry>
+<term>Command line tools</term>
+<listitem>
+<itemizedlist>
+<listitem>
+<simpara>n4js-cli</simpara>
+</listitem>
+<listitem>
+<simpara>n4js-mangelhaft-cli</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>Runtime definition files</term>
+<listitem>
+<itemizedlist>
+<listitem>
+<simpara>n4js-runtime-ecma402</simpara>
+</listitem>
+<listitem>
+<simpara>n4js-runtime-es2015</simpara>
+</listitem>
+<listitem>
+<simpara>n4js-runtime-esnext</simpara>
+</listitem>
+<listitem>
+<simpara>n4js-runtime-fetch</simpara>
+</listitem>
+<listitem>
+<simpara>n4js-runtime-html5</simpara>
+</listitem>
+<listitem>
+<simpara>n4js-runtime-node</simpara>
+</listitem>
+<listitem>
+<simpara>n4js-runtime-v8</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>Mangelhaft</term>
+<listitem>
+<itemizedlist>
+<listitem>
+<simpara>org.eclipse.n4js.mangelhaft</simpara>
+</listitem>
+<listitem>
+<simpara>org.eclipse.n4js.mangelhaft.assert</simpara>
+</listitem>
+<listitem>
+<simpara>org.eclipse.n4js.mangelhaft.reporter.console</simpara>
+</listitem>
+<listitem>
+<simpara>org.eclipse.n4js.mangelhaft.reporter.ide</simpara>
+</listitem>
+<listitem>
+<simpara>org.eclipse.n4js.mangelhaft.reporter.xunit</simpara>
+</listitem>
+<listitem>
+<simpara>org.eclipse.n4js.mangelhaft.runner.ide</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+</varlistentry>
+</variablelist>
+<simpara>In order to make sure that the npms work correctly with the <literal>n4js</literal> product, we need to integration test the interplay between the n4js products and the npms. Right now, we only focus on the interplay between the <literal>n4js</literal> headless compiler and npms. For integration tests, we publish the npms to a local npm registry which is provided by <link xl:href="https://www.verdaccio.org/docs/en/docker.html">verdaccio docker image</link> before executing the tests. When all integration tests are executed, we stop the local npm registry.</simpara>
+<section xml:id="sec:publish-npms-n4js-maven">
+<title>Publish n4js-libs to during  maven build</title>
+<warning>
+<simpara>The NPMs are currently published using NumberFour&#8217;s internal build infrastructure in combination with extended integration tests. This needs to be changed in the future!</simpara>
+</warning>
+<simpara>This section describes how integration tests can use local npm registry during the test.
+All integration tests that require a local npm registry should be placed in the bundle <literal>org.eclipse.n4js.hlc.integrationtests</literal></simpara>
+<figure role="center">
+<title>Maven phases</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/40_publish_npms/images/publish_npm_in_mvn_workflow.svg"/>
+</imageobject>
+<textobject><phrase>publish npm in mvn workflow</phrase></textobject>
+</mediaobject>
+</figure>
+<simpara>During the maven build, three projects <literal>org.eclipse.n4js.external.libraries.update</literal>, <literal>org.eclipse.n4js.product.build</literal> and <literal>org.eclipse.n4js.hlc.integrations</literal> are built by maven in that order.</simpara>
+<itemizedlist>
+<listitem>
+<simpara>During the phase <emphasis>process-classes</emphasis> of the <literal>org.eclipse.n4js.external.libraries.update</literal> build, the UpdateShippedCode MWE2 workflow is triggerd to compile n4js code of npms in n4js-lib. The phase <emphasis>process-classes</emphasis> was chosen because it must happen after the <literal>org.eclipse.n4js.external.libraries.update</literal> bundle has been compiled.</simpara>
+</listitem>
+<listitem>
+<simpara>During the <emphasis>verify</emphasis> phase of the <literal>org.eclipse.n4js.product.build</literal> build, the Maven <literal>exec-maven</literal> plugin calls the script <literal>n4js/releng/utils/scripts/publish-n4js-libs.sh</literal> to publish the npms in the n4js-lib to the <emphasis>staging npm registry</emphasis>. The URL of this staging npm registry must be configured before triggering maven build via the environment variable <literal>NPM_STAGING_REGISTRY</literal>. Note that the staging npm registry lives beyond the life of <literal>n4js-inhouse</literal> 's maven build and holds npms that are needed by the integration tests in the n4js-extended&#8217;s build.</simpara>
+</listitem>
+<listitem>
+<simpara>During the <emphasis>pre-integration-test</emphasis> phase of the <literal>org.eclipse.n4js.hlc.integrationtests</literal> bundle, the Maven <literal>antrun</literal> plugin starts a <emphasis>verdaccio</emphasis> docker container local npm registry at <literal><link xl:href="http://localhost:4873">http://localhost:4873</link></literal> via docker. Also in the very same phase, the Maven plugin <literal>exec-maven</literal> calls the script <literal>n4js/releng/utils/scripts/publish-n4js-libs.sh</literal> to publish the npms in the n4js-lib folder to the local registry <literal><link xl:href="http://localhost:4873">http://localhost:4873</link></literal>. The list of published npms is identical to that list above. Note that the npms are published with the <literal>dist-tag</literal> <emphasis>test</emphasis>.</simpara>
+</listitem>
+<listitem>
+<simpara>During the <emphasis>integration-test</emphasis> phase of <literal>org.eclipse.n4js.hlc.integrationtests</literal>, the Maven <literal>failsafe</literal> plugin executes the integration tests. Here, the integration tests can pull the required npms from the local registry populated during the <emphasis>pre-integration-test</emphasis> above.</simpara>
+</listitem>
+<listitem>
+<simpara>In the <emphasis>pre-integration-test</emphasis> phase of <literal>org.eclipse.n4js.hlc.integrationtests</literal>, the Maven <literal>antrun</literal> plugins removes the  <emphasis>verdaccio</emphasis> docker container.</simpara>
+</listitem>
+</itemizedlist>
+</section>
+</chapter>
+<appendix xml:id="sec:Hints">
+<title>Hints</title>
+<simpara>In this chapter, some tips and tricks regarding Eclipse, Xtend and Maven should be collected.</simpara>
+<section xml:id="sec:XtextInjection">
+<title>Xtext Injection</title>
+<simpara><xref linkend="fig:cd_XtextInjectors"/> shows different injectors used by Xtext
+and their relation to the injector of a custom language created with Xtext
+(in this example N4JS).</simpara>
+<figure xml:id="fig:XtextInjectors" role="center">
+<title>Xtext injectors and custom DSL injector</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/a02_hints/images/cd_XtextInjectors.svg"/>
+</imageobject>
+<textobject><phrase>cd XtextInjectors</phrase></textobject>
+</mediaobject>
+</figure>
+<simpara><emphasis role="strong">Injectors creation:</emphasis></simpara>
+<itemizedlist>
+<listitem>
+<simpara>create 'SharedInjector'</simpara>
+<itemizedlist>
+<listitem>
+<simpara>create shared singletons</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+<listitem>
+<simpara>create (lazily) custom language injector</simpara>
+<itemizedlist>
+<listitem>
+<simpara>take singletons from shared injector</simpara>
+</listitem>
+<listitem>
+<simpara>add bindings from 'SharedModule'</simpara>
+</listitem>
+<listitem>
+<simpara>create own singletons</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+</itemizedlist>
+<simpara>Normally one injector is bound to one language.
+'ContributingModule' allows custom languages to contribute bindings to the
+shared state, effectively cross project boundaries.</simpara>
+<simpara>It must be noted that in case of N4JS tools there are multiple languages
+contributing / extending Xtext injector, which can be seen in figure
+<xref linkend="fig:cd_customInjectors"/></simpara>
+<figure xml:id="fig:cd_customInjectors" role="center">
+<title>Xtext injectors and custom DSL injector</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/a02_hints/images/cd_customInjectors.svg"/>
+</imageobject>
+<textobject><phrase>cd customInjectors</phrase></textobject>
+</mediaobject>
+</figure>
+<section xml:id="sec:DI_MultipleInjectors_Singletons">
+<title>Multiple Injectors and Singletons</title>
+<simpara>Every injector creates its 'ObjectGraph'. Having multiple Injectors in
+the system leads to multiple (disconnected) object graphs. For normal instances
+that is not an issue, but for scoped instances this causes problems.
+Most common issue happens with '@Singleton' instances that carry state.</simpara>
+<figure xml:id="fig:cd_SingletonDuplicate" role="center">
+<title>Xtext injectors and custom DSL injector</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/a02_hints/images/cd_SingletonDuplicate.svg"/>
+</imageobject>
+<textobject><phrase>cd SingletonDuplicate</phrase></textobject>
+</mediaobject>
+</figure>
+<simpara><xref linkend="fig:cd_customInjectors"/> shows situation in which both 'ChildInjector'
+and 'N4JSInjector' have their bindings for 'N4JSEclipseCore'. As a result those
+injectors will create their instance of core that is expected to be
+'@Singleton'. Additionally, this will be true for all its transitive
+dependencies.</simpara>
+<section xml:id="sec:DI_avoid_duplicate_singletons">
+<title>Avoiding duplicate singletons</title>
+<simpara>To avoid issue with duplicate singletons two distinct injectors should not
+have their bindings for singletons. Developer needs to decide where to
+define <emphasis role="strong">the only</emphasis> binding, and let one 'ObjectGraph' delegate to another.</simpara>
+<section xml:id="sec:DI_binding_in_shared">
+<title>Defining binding in the shared injector</title>
+<simpara>One approach is to define binding in the shared injector. Then in the injector
+of the custom language to delegate to the shared contribution.</simpara>
+<screen>/** Binds {@link IN4JSCore} */
+public class ContributingModule implements Module {
+    @Override
+    public void configure(Binder binder) {
+        binder.bind(IN4JSCore.class).to(IN4JSEclipseCore.class);
+        binder.bind(IN4JSEclipseCore.class).to(N4JSEclipseCore.class).in(SINGLETON);
+    }
+}
+
+/** Delegates binding for {@link IN4JSCore} to the shared provider. */
+public class ContributingModule implements Module {
+    public Provider&lt;? extends IN4JSCore&gt; bindIN4JSCore() {
+        return Access.contributedProvider(N4JSEclipseCore.class);
+    }
+}</screen>
+<simpara>Downside of this approach is in the shared injector itself.
+It does not allow for implicit bindings. This forces developer to declare
+bindings for <emphasis role="strong">all transitive</emphasis> dependencies of the main binding explicitly.
+Additionally, every custom language has to do it. These make shared injector
+the <emphasis>GodInjector</emphasis> that contains configuration for all custom languages,
+it is responsible for creating most objects in the system, and potentially
+exposes types from one language to another language where it might not be
+desired.</simpara>
+</section>
+<section xml:id="sec:DI_binding_in_custom">
+<title>Defining binding in the custom injector</title>
+<simpara>Other approach is to define binding in the injector for a custom
+language. Then let instances in the shared injector object graph to obtain
+singleton instances via custom language injector (which is stored on the
+custom language activator).</simpara>
+<screen>/** Does not bind {@link IN4JSCore} */
+public class ContributingModule implements Module {
+    @Override
+    public void configure(Binder binder) {
+        // no core binding
+    }
+}
+
+/** Binds {@link IN4JSCore}. */
+public class ContributingModule implements Module {
+    public Class&lt;? extends IN4JSCore&gt; bindIN4JSCore() {
+        return IN4JSEclipseCore.class;
+    }
+}
+
+/** Some type used in shared injector object graph */
+public SomeSharedType{
+
+    /** Obtain {@link IN4JSCore} form {@code N4JSInjector}. */
+    private IN4JSCore getIN4JSCore() {
+        return N4JSActivator
+                .getInstance()
+                .getInjector(ORG_ECLIPSE_N4JS_N4JS)
+                .getInstance(IN4JSCore.class);
+    }
+}</screen>
+<simpara>This approach also has downsides. In the 'SomeSharedType' that exists in the
+shared injector object graph we cannot inject 'IN4JSCore' as it is not
+known to the shared injector. Instead, we have to get the instance form the
+'N4JSInjector' manually. This requires developer to know whole (singleton)
+types structure
+defined in every custom language.</simpara>
+</section>
+</section>
+</section>
+<section xml:id="sec:DI_Hints" role="language-n4js">
+<title>Dependency Injection Hints</title>
+<section xml:id="sec:DI_custom_bundle">
+<title>Use DI in custom bundle, use DI with extensions</title>
+<section xml:id="sec:DI_custom_bundle_problem">
+<title>Problem</title>
+<simpara>DI should be used in a custom bundle, i.e. a bundle not generated by Xtext.
+E.g., a new handler should be provided in its plugin, and this handler requires
+an injected instance. Example</simpara>
+<simpara>my.dsl.bundle.ui xtext generated</simpara>
+<simpara>my.dsl.bundle.sub.ui
+The following class is contained in my custom plugin:</simpara>
+<screen>class my.dsl.bundle.sub.ui.Handler {
+    @Inject SomeDSLOrXtextSpecificType obj;
+}</screen>
+<simpara>The question is, how can obj of type be injected at this location?</simpara>
+</section>
+<section xml:id="sec:DI_custom_bundle_solution">
+<title>Solution</title>
+<simpara>First of all, to use DI in a type, the type instance itself must have been
+created via DI. This requires an injector which uses the same class loader as
+the type using the injector. This means that a new bundle needs its injector,
+created by an IExecutableExtensionFactory using the bundles' activator (plugin)
+singleton.</simpara>
+<simpara>This activator can extend the generated activator of a Xtext bundle. The
+following code can be used as a template, as long as no custom non-default
+bindings are to be added (in this case, have a look at the generated activator
+and override the methods configuring the injector):</simpara>
+<screen>public class my.dsl.bundle.sub.ui.Activator extends my.dsl.bundle.ui.MyDSLActivator {
+    private static my.dsl.bundle.sub.ui.Activator INSTANCE;
+
+    @Override
+    public void start(BundleContext context) throws Exception {
+        super.start(context);
+        INSTANCE = this;
+    }
+
+    @Override
+    public void stop(BundleContext context) throws Exception {
+        INSTANCE = null;
+        super.stop(context);
+    }
+
+    public static TypePopupActivator getInstance() {
+        return INSTANCE;
+    }
+}</screen>
+<simpara>Additionally, a custom 'AbstractGuiceAwareExecutableExtensionFactory' has to be
+implemented. This class then uses the new activator instance (this is required
+as bundles have their classloaders!)</simpara>
+<screen>public class my.dsl.bundle.sub.ui.SubExecutableExtensionFactory extends AbstractGuiceAwareExecutableExtensionFactory {
+    @Override
+    protected Bundle getBundle() {
+        return my.dsl.bundle.sub.ui.Activator.getInstance().getBundle();
+    }
+
+    @Override
+    protected Injector getInjector() {
+    return my.dsl.bundle.sub.ui.Activator.getInstance().getInjector(MyDSLActivator.MY_LANGUAGE_GRAMMAR);
+    }
+}</screen>
+<simpara>Now, we can use this extension factory in the plugin.xml of the sub bundle to
+let the handler be created via DI. E.g.</simpara>
+<screen>"org.eclipse.ui.handlers"&amp;gt;
+&lt;handler
+class="my.dsl.bundle.sub.ui.SubExecutableExtensionFactory:my.dsl.bundle.sub.ui.Handler"
+commandId="..."&amp;gt;
+handler&amp;gt;
+extension&amp;gt;</screen>
+</section>
+</section>
+<section xml:id="sec:Access_Other_DSL_Injector">
+<title>How do I get the Guice Injector of my language?</title>
+<simpara>We have the use case to load a N4MF file inside the N4JS infrastructure to read
+out the project description and configure the qualified names and container
+visibility. I.e. we have to load another DSL in our current DSL infrastructure,
+in the use case to have a Xtext resource set available to load the N4MF file.
+Injecting the Xtext resource of the current DSL wouldn’t work as it has not the
+N4MF injection context. So in the following the ways how to access this
+injection context is described as extracted from
+<link xl:href="http://koehnlein.blogspot.de/2012/11/xtext-tip-how-do-i-get-guice-injector.html">this blog post</link>.</simpara>
+<section xml:id="sec:DSL_Injector_UI_context">
+<title>UI context</title>
+<simpara>To access another DSL injector in a UI DSL project just add a dependency to the
+UI project of the other DSL and then</simpara>
+<screen>MyClass myClass =
+TheOtherDSLActivator.getInstance().getInjector().get(MyClass.class)</screen>
+</section>
+<section xml:id="sec:DSL_Injector_Non_UI_context">
+<title>Non UI context but with injection context</title>
+<screen>@Inject IResourceServiceProvider.Registry serviceProviderRegistry;
+...
+MyClass myClass
+=
+serviceProviderRegistry.getResourceServiceProvider(URI.createFileURI(n4mfFileAbsolutePath)).get(MyClass.class)</screen>
+</section>
+<section xml:id="sec:DSL_Injector_Non_UI_non_injection_context">
+<title>Non UI context without injection context</title>
+<screen>@Inject IResourceServiceProvider.Registry serviceProviderRegistry;
+...
+MyClass
+myClass
+=
+IResourceServiceProvider.Registry.INSTANCE.getResourceServiceProvider(uri).get(MyClass.class);</screen>
+</section>
+</section>
+<section xml:id="sec:Cancel_Indicator">
+<title>How do I get cancel indicators in different contexts?</title>
+<simpara>Several factors contribute to responsiveness in the IDE, but here we focus in
+running jobs in the background and reacting to cancellation requests.</simpara>
+<simpara>The Eclipse Jobs API is recommended for potentially long-running tasks (other
+than incremental building, which has dedicated support). For example, the
+outline view is populated by a background job, running validations on the
+resource (and honoring cancellation requests initiated as for any job).</simpara>
+<simpara>Cancel indicators are a Xtext abstraction while Eclipse favors progress
+monitors, the latter including not only cancellation capability but also a
+callback mechanism to give feedback in the UI about intermediate progress.
+Cancel indicator can wrap a progress monitor.</simpara>
+<simpara>Cancel indicators come in two variants, depending on the source of cancellation
+events:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>a resource becoming stale (usually as a result of editing sources) triggers
+cancellation. These cancel indicators can be obtained via
+'OutdatedStateManager', which itself is available via injection.</simpara>
+</listitem>
+<listitem>
+<simpara>cancel indicators associated to the UI, for example associated to an Eclipse
+job. Examples:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>for an outline view running in the background, an override of method
+'createRoot()' from 'DefaultOutlineTreeProvider' receives a UI-aware cancel
+indicator;</simpara>
+</listitem>
+<listitem>
+<simpara>for the transpiler, instances that carry cancel indicator are
+'IFileSystemAccess' and (in the future) 'IGenerator2'. To track the latter, see
+Eclipse bug 477068.</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+</itemizedlist>
+<simpara>In general, whenever a resource is validated cancel indicator should be checked
+periodically. These checks are performed automatically via
+'MethodWrapperCancelable' before the (reflective) invocation of each validation
+method and therefore require no manual intervention, see
+'AbstractMessageAdjustingN4JSValidator'. However, that doesn’t help in case a
+single validation method ''takes too long''. To simplify those checks, utility
+'isCanceled()' of 'AbstractMessageAdjustingN4JSValidator' can be invoked.</simpara>
+</section>
+</section>
+</section>
+<section xml:id="sec:Eclipse">
+<title>Eclipse</title>
+<section xml:id="sec:Show_Xtext_Index">
+<title>Show the current Xtext index</title>
+<simpara>Press the following keyboard shortcut in the running UI: <keycap>CTRL</keycap><?asciidoc-br?>
+<keycap>SHIFT</keycap> + <keycap>F3</keycap> (likely under Mac <keycap>CMD</keycap> + <keycap>SHIFT</keycap> + <keycap>F3</keycap>).</simpara>
+</section>
+<section xml:id="sec:Plugin_spy">
+<title>Plug-in spy</title>
+<simpara>Not special for Xtext but very helpful do identify which class implements a UI
+concept, for example, if you want to know which class implements the Open Model
+Element dialog just press <keycap>CTRL</keycap> + <keycap>SHIFT</keycap> + <keycap>F3</keycap> to open that
+dialog and afterwards press <keycap>SHIFT</keycap> + <keycap>ALT</keycap> + <keycap>F1</keycap> to show that
+'XtextEObjectSearchDialog' is used as implementation. Additionally, use
+<keycap>SHIFT</keycap> + <keycap>ALT</keycap> + <keycap>F2</keycap> to spy buttons in the toolbar and
+<keycap>SHIFT</keycap> + <keycap>ALT</keycap> + <keycap>F3</keycap> to spy the extension point name of the
+currently active view or window.</simpara>
+</section>
+</section>
+<section xml:id="sec:Maven-hints">
+<title>Maven</title>
+<section xml:id="how-to-check-for-maven-mojo-updates">
+<title>How to check for Maven MOJO updates</title>
+<simpara><emphasis role="strong">cd</emphasis> to the root directory and call</simpara>
+<programlisting language="bash" linenumbering="unnumbered">mvn versions:display-plugin-updates</programlisting>
+</section>
+</section>
+</appendix>
+<appendix xml:id="_module-loading">
+<title>Module Loading</title>
+<warning>
+<simpara>This chapter is outdated and basically kept for historical reasons.</simpara>
+</warning>
+<section xml:id="sec:Dependency_Management">
+<title>Dependency Management</title>
+<simpara>There exist several types of dependencies between modules, distinguishable by the time when the dependency is relevant. We first define these dependencies lazily to give an impression of the problem, at more rigorously later on.</simpara>
+<simpara>Dependency needed at compile time. These type of dependency is removed by the compiler. These are basically type references used in variable or function declarations.</simpara>
+<simpara>Runtime dependencies are to be handled at runtime in general. We distinguish two special types of runtime dependencies:</simpara>
+<simpara>A loadtime dependency is a special runtime dependency that needs to be resolved before a module is initialized, that is, when all top-level statements of a module, containing class declarations, are executed. This usually is a types super type (e.g., super class), or a call to a function (defined in a different module) in a static initializer or module top level statement.</simpara>
+<simpara>An execution time dependency is a non-initialization runtime dependency. That is, when a method is called (from another module), this is execution time.</simpara>
+<simpara>Of course, before a module can be loaded, it needs to be fetched (i.e., the actual code has to be retrieved by the browser).</simpara>
+<simpara>We can define sets containing modules which a given module depends on. Note that these sets contain each other, as shown in <link linkend="fig:euler_dependencies">Euler Dependencies</link>. However, we define disjoint sets in which a dependency to another type is only contained in one of the sets.</simpara>
+<figure xml:id="fig:euler_dependencies" role="center">
+<title>Euler diagram of dependency sets</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/a10_moduleLoading/images/euler_dependencies.svg"/>
+</imageobject>
+<textobject><phrase>euler dependencies</phrase></textobject>
+</mediaobject>
+</figure>
+<simpara>Given a code sequence , we define the set of accessed modules in it as .</simpara>
+<literallayout class="monospaced">describes all function calls happening in code block , i.e. . In case  calls on functions , we define a function’s body code sequence as .</literallayout>
+<simpara>The complete set of accessed modules for a particular code sequence  is then defined as
+]</simpara>
+<simpara>We explicitly allow a function to be excluded from being incorporated in the above algorithm by annotating it.</simpara>
+<simpara>The set of load-time-dependencies for a module  with initializer code  is then defined as math:[\[\begin{aligned}
+load-time-deps := AccessdModules( SuperClass(M) ) + AccessdModules( IC(M) ) \end{aligned}\]]</simpara>
+</section>
+<section xml:id="ecmascript-modules" role="language-javascript">
+<title>ECMAScript Modules</title>
+<section xml:id="sec:ES5_Modules_Systems">
+<title>ES5 Modules Systems</title>
+<simpara>Before ES6, Javascript had no built in support for modules. To overcome this hurdle, the two widely accepted formats have been :</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara><literal>CommonJS</literal> : Primarily aimed at synchronous module loading. The main implementation of this format is seen in <literal>Node.js</literal></simpara>
+<programlisting language="javascript" linenumbering="unnumbered">var value = 100;
+function inc() {
+    value++;
+}
+
+module.exports = {
+    value : value,
+    inc : inc
+}</programlisting>
+<simpara>Import via require.</simpara>
+</listitem>
+<listitem>
+<simpara><literal>AMD</literal> : Primarily aimed at asynchronous module loading in browsers. The main implementation of this format is seen in <literal>RequireJS</literal>.</simpara>
+<screen>define('myModule', ['mod1', 'mod2'], function (mod1, mod2) {
+        return {
+            myFunc: function(x, y) {
+                ..
+            }
+        };
+    };
+});</screen>
+<simpara><literal>passive</literal> format</simpara>
+</listitem>
+</orderedlist>
+</section>
+<section xml:id="sec:ES6_Modules">
+<title>ES6 Modules</title>
+<simpara>The ES6 spec introduces <link xl:href="http://www.ecma-international.org/ecma-262/6.0/#sec-modules">modules</link>. ES6 modules resemble <literal>CommonJS</literal> syntax with <literal>AMD</literal> like asynchronous loading support.</simpara>
+<simpara>Apart from the syntactic details, the highlights of ES6 modules are :</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>ES6 modules support (multiple) named exports.</simpara>
+<screen>export const VERSION = "1.0.1";
+export function inc(x) {
+    return x + 1;
+}</screen>
+</listitem>
+<listitem>
+<simpara>ES6 modules support default exports.</simpara>
+<screen>export default function (x) {
+    return x+1;
+}</screen>
+</listitem>
+<listitem>
+<simpara>As specified <link xl:href="http://www.ecma-international.org/ecma-262/6.0/#sec-createimportbinding">here</link>, ES6 modules export live immutable bindings (instead of values).</simpara>
+<note>
+<simpara>This behaviour is different from that of <literal>CommonJS</literal> and <literal>AMD</literal> modules where a snapshot of the value is exported.</simpara>
+</note>
+<simpara>An example demonstrating the behavioural difference :</simpara>
+<screen>//-------------src.js------------
+var value = 100;
+function inc() {
+    value++;
+}
+
+module.exports = {
+    value : value,
+    inc : inc
+}
+//-------------main.js------------
+var src = require("./src"); //import src
+
+console.log(src.value); //prints 100
+src.inc();
+
+console.log(src.value); //prints 100 &lt;--- The value does not update.
+
+src.value = 65;
+console.log(src.value); //prints 65 &lt;--- The imported value is mutable.</screen>
+<simpara>The same example with ES6 modules :</simpara>
+<screen>//-------------src.js------------
+export var value = 100; // &lt;--- ES6 syntax
+export function inc() { // &lt;--- ES6 syntax
+    value++;
+}
+
+//-------------main.js------------
+import {value, inc} from "src" // &lt;--- ES6 syntax
+
+console.log(value); //prints 100
+inc();
+
+console.log(value); //prints 101 &lt;--- The value is a live binding.
+
+value = 65; // &lt;--- throws an Error implying the binding is immutable.</screen>
+</listitem>
+<listitem>
+<simpara>ES6 modules impose a static module structure i.e. the imports and exports can be determined at compile time (statically).</simpara>
+</listitem>
+</orderedlist>
+</section>
+</section>
+<section xml:id="sec:ECMAScript_Module_Loaders" role="language-n4js">
+<title>ECMAScript Module Loaders</title>
+<simpara>For resolving module dependencies and loading modules, the JS landscape provides a few different module loaders.</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara><literal>RequireJS</literal> is the loader of choice for in browser, <literal>AMD</literal> style modules. We currently transpile our code into an AMD-style format to allow it running in both Browser and Node.js environments.</simpara>
+</listitem>
+<listitem>
+<simpara><literal>Node.js</literal> provides a native loader implementation for <literal>CommonJS</literal> style modules.</simpara>
+</listitem>
+<listitem>
+<simpara>For browsers (primarily), tools like <link xl:href="http://webpack.github.io/"><literal>Webpack</literal></link> and <link xl:href="http://browserify.org/"><literal>Browserify</literal></link> exist. These tools analyse the dependency graph of the entire project and then bundle up all the dependencies in a single file. <literal>Browserify</literal> only supports <literal>CommonJS</literal> modules where as <literal>Webpack</literal> works with both <literal>CommonJS</literal> &amp; <literal>AMD</literal> style modules.</simpara>
+</listitem>
+<listitem>
+<simpara>At the time of writing this document (August 2015), there does not exist any native implementation for ES6 modules by any Javascript host environments i.e. ES6 modules are not natively supported by browsers or <literal>Node.js</literal>, as of now.</simpara>
+</listitem>
+</orderedlist>
+<simpara>[fig:moduelLoader] shows an overview.</simpara>
+<figure xml:id="fig:moduleLoader" role="center">
+<title>Module Loader and Transpilers, Overview</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/a10_moduleLoading/images/moduleLoader.svg"/>
+</imageobject>
+<textobject><phrase>moduleLoader</phrase></textobject>
+</mediaobject>
+</figure>
+<section xml:id="sec:ES6_Module_Loaders">
+<title>ES6 Module Loaders</title>
+<simpara>The ES6 spec started out with ES6 Module Loader details as part of the spec. However the Working Group later decided to not proceed with it. The specification for ES6 Module Loader is now a separate specification [<link linkend="WhatWGLoader">WhatWGLoader</link>].</simpara>
+<simpara>The aim of this specification is:</simpara>
+<blockquote>
+<simpara>This specification describes the behavior of loading JavaScript modules from a JavaScript host environment. It also provides APIs for intercepting the module loading process and customizing loading behavior.</simpara>
+</blockquote>
+<simpara>The <link xl:href="https://github.com/whatwg/loader#implementation-status">Implementation status</link> of the spec states :</simpara>
+<blockquote>
+<simpara>It is too early to know about the Loader, first we need ES2015 modules implemented by the various engines.</simpara>
+</blockquote>
+</section>
+<section xml:id="sec:Polyfills_for_ES6_Module_Loaders">
+<title>Polyfills for ES6 Module Loaders</title>
+<simpara>Although there is no native support for ES6 module loading, there are a few attempts to polyfill this gap.</simpara>
+<section xml:id="sec:es6_module_loader">
+<title>es6-module-loader</title>
+<simpara>The <link xl:href="https://github.com/ModuleLoader/es6-module-loader"><literal>es6-module-loader</literal></link> project provides a polyfill for the ES6 Module Loader implementation. It dynamically loads ES6 modules in browsers and <literal>Node.js</literal> with support for loading existing and custom module formats through loader hooks.</simpara>
+</section>
+<section xml:id="sec:SystemJS">
+<title>SystemJS</title>
+<simpara>Building upon <literal>es6-module-loader</literal>, <link xl:href="https://github.com/systemjs/systemjs"><literal>SystemJS</literal></link> supports loading ES6 modules along with <literal>AMD</literal>, <literal>CommonJS</literal> and global scripts in the browser and <literal>Node.js</literal>.</simpara>
+<note>
+<simpara>In order to use ES6 modules (written in ES6 syntax) the code first needs to be transpiled to ES5. For this purpose, <literal>SystemJS</literal> provides an option to use <link xl:href="https://github.com/google/traceur-compiler"><literal>Traceur</literal></link> compiler or <link xl:href="https://babeljs.io/"><literal>Babel</literal></link>.</simpara>
+</note>
+</section>
+<section xml:id="sec:Demo">
+<title>Demo</title>
+<simpara>A demonstration of how to how to use ES6 modules with <literal>Babel</literal> and <literal>SystemJS</literal> in <literal>Node.js</literal> as of today (August 2015).</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>Create an ES6 module as shown:</simpara>
+<screen>export var value = 100; // &lt;--- named export of a variable
+export function inc() { // &lt;--- named export of a function
+    value++;
+}</screen>
+</listitem>
+<listitem>
+<simpara>Import the bindings from the module as shown:</simpara>
+<screen>import {value, inc} from "src"
+
+var importedValue = value; // &lt;--- using the imported value
+inc(); // &lt;--- using the imported function</screen>
+</listitem>
+<listitem>
+<simpara>Transpile these two files using <literal>Babel</literal> to ES5 with the target module format as <literal>system</literal>, as shown:</simpara>
+<screen>$ babel &lt;inputdir&gt; --out-dir &lt;outputdir&gt; --modules system</screen>
+</listitem>
+<listitem>
+<simpara>The transpiled output should be resemble the following:</simpara>
+<screen>System.register([], function (_export) {
+    "use strict";
+
+    var value;
+
+    _export("inc", inc);
+
+    function inc() {
+        _export("value", value += 1);
+    }
+
+    return {
+        setters: [],
+        execute: function () {
+            value = 100;
+
+            _export("value", value);
+        }
+    };
+});</screen>
+<screen>System.register(["src"], function (_export) {
+  "use strict";
+
+  var value, inc, importedValue;
+  return {
+    setters: [function (_src) {
+      value = _src.value;
+      inc = _src.inc;
+    }],
+    execute: function () {
+      importedValue = value;
+      inc();
+    }
+  };
+});</screen>
+</listitem>
+<listitem>
+<simpara>Finally run the above transpiled files, as shown:</simpara>
+<screen>var System = require('systemjs'); // &lt;--- Require SystemJS
+System.transpiler = 'babel'; // &lt;--- Configure SystemJS
+
+System.import('main'); // &lt;--- Import the transpiled "main" module.</screen>
+</listitem>
+</orderedlist>
+</section>
+</section>
+</section>
+<section xml:id="case-study-typescript" role="language-typescript">
+<title>Case Study : TypeScript</title>
+<note>
+<simpara><anchor xml:id="sec:Case_Study___TypeScript" xreflabel="[sec:Case_Study___TypeScript]"/> This section is NOT an exhaustive introduction to Microsoft’s <literal>TypeScript</literal>, but a narrowed down analysis of certain aspects of <literal>TypeScript</literal>.</simpara>
+</note>
+<section xml:id="sec:ES6_Modules_Support">
+<title>ES6 Modules Support</title>
+<simpara><literal>TypeScript</literal> language has recently added support for ES6 modules. From the <link xl:href="https://github.com/Microsoft/TypeScript/wiki/What%27s-new-in-TypeScript#es6-modules">wiki</link> :</simpara>
+<blockquote>
+<simpara><literal>TypeScript</literal> 1.5 supports <literal>ECMAScript 6</literal> (ES6) modules. ES6 modules are effectively <literal>TypeScript</literal> external modules with a new syntax: ES6 modules are separately loaded source files that possibly import other modules and provide a number of externally accessible exports. ES6 modules feature several new export and import declarations.</simpara>
+</blockquote>
+</section>
+<section xml:id="sec:TypeScript_and_Module_Loading">
+<title>TypeScript and Module Loading</title>
+<simpara><literal>TypeScript</literal> does not concern itself with providing a module loader. It is the responsibility of the host environment. However <literal>TypeScript</literal>’s compiler provides options to transpile the modules to different formats like <literal>AMD</literal>, <literal>CommonJS</literal>, <literal>ES6</literal> etc. It is the developer’s responsibility to choose an appropriate format and then use the modules with a correct module loader.</simpara>
+<simpara>From the <link xl:href="https://github.com/Microsoft/TypeScript/issues/2242">wiki</link> again :</simpara>
+<blockquote>
+<simpara>TypeScript supports down-level compilation of external modules using the new ES6 syntax. When compiling with <literal>-t ES3</literal> or <literal>-t ES5</literal> a module format must be chosen using <literal>-m CommonJS</literal> or <literal>-m AMD</literal>. When compiling with <literal>-t ES6</literal> the module format is implicitly assumed to be <literal>ECMAScript 6</literal> and the compiler simply emits the original code with type annotations removed. When compiling down-level for <literal>CommonJS</literal> or <literal>AMD</literal>, named exports are emitted as properties on the loader supplied exports instance. This includes default exports which are emitted as assignments to exports.default.</simpara>
+</blockquote>
+<simpara>Consider the following module <literal>src.ts</literal> :</simpara>
+<screen>export var value = 100; //&lt;--- ES6 syntax
+
+export function inc() {  //&lt;--- ES6 syntax
+    value++;
+}</screen>
+<simpara>Compiling it to <literal>SystemJS</literal> format produces :</simpara>
+<screen>System.register([], function(exports_1) {
+    var value;
+    function inc() {
+        (exports_1("value", ++value) - 1);
+    }
+    exports_1("inc", inc);
+    return {
+        setters:[],
+        execute: function() {
+            exports_1("value", value = 100); //&lt;--- ES6 syntax
+        }
+    }
+});</screen>
+<simpara>Compiling it to <literal>CommonJS</literal> format produces :</simpara>
+<screen>exports.value = 100; //&lt;--- ES6 syntax
+function inc() {
+    exports.value++;
+}
+exports.inc = inc;</screen>
+<simpara>Compiling it to <literal>AMD</literal> format produces :</simpara>
+<screen>define(["require", "exports"], function (require, exports) {
+    exports.value = 100; //&lt;--- ES6 syntax
+    function inc() {
+        exports.value++;
+    }
+    exports.inc = inc;
+});</screen>
+<simpara>Compiling it to <literal>UMD</literal> format produces :</simpara>
+<screen>(function (deps, factory) {
+    if (typeof module === 'object' &amp;&amp; typeof module.exports === 'object') {
+        var v = factory(require, exports); if (v !== undefined) module.exports = v;
+    }
+    else if (typeof define === 'function' &amp;&amp; define.amd) {
+        define(deps, factory);
+    }
+})(["require", "exports"], function (require, exports) {
+    exports.value = 100; //&lt;--- ES6 syntax
+    function inc() {
+        exports.value++;
+    }
+    exports.inc = inc;
+});</screen>
+<simpara>NOTE :</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>Visual Studio 2015 does not <link xl:href="http://visualstudio.uservoice.com/forums/121579-visual-studio/suggestions/7017377-support-for-es6-modules">support</link> ES6 modules at this time.</simpara>
+</listitem>
+<listitem>
+<simpara><literal>SystemJS</literal> supports <literal>TypeScript</literal> as a compiler. This implies <literal>TypeScript</literal> modules can be transpiled to be used with <literal>SystemJS</literal> as the module loader.</simpara>
+</listitem>
+</orderedlist>
+</section>
+</section>
+<section xml:id="sec:Cyclic_Dependencies" role="language-js">
+<title>Cyclic Dependencies</title>
+<simpara>To better analyse and evaluate <literal>SystemJS</literal> module loader and different module formats, let’s look at a cyclic dependency example from a (extremely simplified) stdlib task <literal>FixedPoint6</literal>. The outline for the example is :</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>Prepare 2 ES6 modules with a circular dependency.</simpara>
+</listitem>
+<listitem>
+<simpara>Then transpile these modules to different module formats (e.g. <literal>AMD</literal>, &amp; <literal>SystemJS</literal>).</simpara>
+</listitem>
+<listitem>
+<simpara>With <literal>SystemJS</literal> as the module loader, execute the test for every transpiled module format.</simpara>
+</listitem>
+</orderedlist>
+<section xml:id="sec:Setup">
+<title>Setup</title>
+<simpara>Consider the following ES6 listings:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>RoundingMode</simpara>
+<screen>export default {
+    FLOOR : "FLOOR",
+    CEILING : "CEILING"
+}</screen>
+</listitem>
+<listitem>
+<simpara>MathContext</simpara>
+<screen>import { default as FixedPoint6 } from "FixedPoint6";
+import { default as RoundingMode } from "RoundingMode";
+
+let MathContext = class {
+    constructor(mode) {
+        this.mode = mode;
+    }
+
+    divide(fp1, fp2) {
+        var quotient = FixedPoint6.getQuotient(fp1, fp2);
+
+        if(this.mode === RoundingMode.CEILING) {
+            return new FixedPoint6(Math.ceil(quotient));
+        } else if(this.mode === RoundingMode.FLOOR) {
+            return new FixedPoint6(Math.floor(quotient));
+        } else {
+            throw new Error("Incorrect RoundingMode");
+        }
+    }
+}
+
+MathContext.FLOOR = new MathContext(RoundingMode.FLOOR);
+MathContext.CEILING = new MathContext(RoundingMode.CEILING);
+
+export default MathContext;</screen>
+</listitem>
+<listitem>
+<simpara>FixedPoint6</simpara>
+<screen>import { default as MathContext } from "MathContext";
+
+export default class FixedPoint6 {
+    constructor(number) {
+        this.value = number;
+    }
+
+    static getQuotient(fp1, fp2) {
+        return fp1.value/fp2.value;
+    }
+
+    divide(fp) {
+        return FixedPoint6.defaultContext.divide(this, fp);
+    }
+}
+
+FixedPoint6.defaultContext = MathContext.FLOOR;</screen>
+</listitem>
+<listitem>
+<simpara>Test</simpara>
+<screen>import { default as FixedPoint6 } from "FixedPoint6";
+import { default as MathContext } from "MathContext";
+import { default as RoundingMode } from 'RoundingMode';
+
+var fp1 = new FixedPoint6(20.5);
+var fp2 = new FixedPoint6(10);
+
+var fp3 = fp1.divide(fp2);
+console.log(fp1, fp2, fp3);</screen>
+</listitem>
+<listitem>
+<simpara>Runner : This is the runner file to execute the test (after transpilation).</simpara>
+<screen>var System = require('systemjs');
+System.transpiler = 'babel';
+
+System.config({
+    baseURL: './build',
+    "paths": {
+        "*": "*.js"
+    }
+});
+
+System.import('test').catch(function(e) {
+    console.log(e);
+})</screen>
+</listitem>
+</orderedlist>
+<simpara>Clearly <literal>MathContext</literal> &amp; <literal>FixedPoint6</literal> have a circular dependency upon each other.</simpara>
+</section>
+<section xml:id="sec:Transpile_and_Execute" role="language-js">
+<title>Transpile and Execute</title>
+<simpara>Transpile the above setup to different formats and execute the code using <literal>SystemJS</literal> module loader :</simpara>
+<section xml:id="sec:Module_Format___AMD">
+<title>Module Format = AMD</title>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>Compile the previous set up using <literal>babel</literal> as the transpiler with <literal>AMD</literal> modules :</simpara>
+<screen>babel src -w --out-dir build --modules amd</screen>
+</listitem>
+<listitem>
+<simpara>Run the transpiled <literal>test.js</literal> with :</simpara>
+<screen>node runner.js</screen>
+</listitem>
+<listitem>
+<simpara>The execution would fail with an error like the following :</simpara>
+<screen>Error: _FixedPoint62.default.getQuotient is not a function</screen>
+</listitem>
+</orderedlist>
+</section>
+<section xml:id="sec:Module_Format___CommonJS">
+<title>Module Format = CommonJS</title>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>Compile the previous set up using <literal>babel</literal> as the transpiler with <literal>CommonJS</literal> modules :</simpara>
+<screen>babel src -w --out-dir build --modules common</screen>
+</listitem>
+<listitem>
+<simpara>Run the transpiled <literal>test.js</literal> with :</simpara>
+<screen>node runner.js</screen>
+</listitem>
+<listitem>
+<simpara>The execution is successful and logs the following results :</simpara>
+<screen>{ value: 20.5 } { value: 10 } { value: 2 }</screen>
+</listitem>
+</orderedlist>
+</section>
+<section xml:id="sec:Module_Format___SystemJS">
+<title>Module Format = SystemJS</title>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>Compile the previous set up using <literal>babel</literal> as the transpiler with <literal>SystemJS</literal> modules :</simpara>
+<screen>babel src -w --out-dir build --modules system</screen>
+</listitem>
+<listitem>
+<simpara>Run the transpiled <literal>test.js</literal> with :</simpara>
+<screen>node runner.js</screen>
+</listitem>
+<listitem>
+<simpara>The execution is successful and logs the following results :</simpara>
+<screen>{ value: 20.5 } { value: 10 } { value: 2 }</screen>
+</listitem>
+</orderedlist>
+</section>
+</section>
+<section xml:id="sec:Conclusion">
+<title>Conclusion</title>
+<simpara>As observed, the test is executed successfully with <literal>CommonJS</literal> &amp; <literal>SystemJS</literal> module formats. It however fails with <literal>AMD</literal> format (due to the circular dependency).</simpara>
+</section>
+</section>
+<section xml:id="system.register-as-transpilation-target" role="language-n4js">
+<title>System.register as transpilation target</title>
+<simpara>In order to integrate <literal>SystemJS</literal> as the module loader, the recommended module format is <literal>System.register</literal>. This section serves as a guide (&amp; implementation hint) to transpile N4JS modules with <literal>System.register</literal> as the module format.</simpara>
+<section xml:id="sec:Introduction">
+<title>Introduction</title>
+<simpara>This format is best explained from its <link xl:href="https://github.com/ModuleLoader/es6-module-loader/blob/master/docs/system-register.md">documentation</link> :</simpara>
+<blockquote>
+<simpara>System.register can be considered as a new module format designed to support the exact semantics of ES6 modules within ES5. It is a format that was developed out of collaboration and is supported as a module output in Traceur (as instantiate), Babel and TypeScript (as system). All dynamic binding and circular reference behaviors supported by ES6 modules are supported by this format. In this way it acts as a safe and comprehensive target format for the polyfill path into ES6 modules.</simpara>
+<simpara>To run the format, a suitable loader implementation needs to be used that understands how to execute it. Currently these include SystemJS, SystemJS Self-Executing Bundles and ES6 Micro Loader. The ES6 Module Loader polyfill also uses this format internally when transpiling and executing ES6.</simpara>
+</blockquote>
+<simpara>The <literal>System.register</literal> format is not very well documented. However, this format is supported by all major transpilers out there i.e. <literal>BabelJS</literal>, <literal>Traceur</literal> &amp; <literal>TypeScript</literal> transpilers. In fact, the primary resource of this documentation has been the outputs generated by these transpilers.</simpara>
+<section xml:id="sec:External_Transpilers">
+<title>External Transpilers</title>
+<simpara>In order to follow along, it will be best to try out different ES6 syntax being transpiled to <literal>System.register</literal> format by these transpilers.</simpara>
+<simpara>The following instructions will be useful :</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>Transpile with Traceur</simpara>
+<programlisting language="bash" linenumbering="unnumbered">traceur --dir &lt;SOURCE_DIR&gt; &lt;OUTPUT_DIR&gt; --experimental --modules=instantiate</programlisting>
+</listitem>
+<listitem>
+<simpara>Transpile with Babel</simpara>
+<programlisting language="bash" linenumbering="unnumbered">babel &lt;SOURCE_DIR&gt; --out-dir &lt;OUTPUT_DIR&gt; --modules system</programlisting>
+</listitem>
+<listitem>
+<simpara>Transpile with TypeScript</simpara>
+<simpara>Create a file by the name of <literal>tsconfig.json</literal> in the project folder, with the following contents :</simpara>
+<programlisting language="json" linenumbering="unnumbered">{
+    "compilerOptions": {
+        "module": "system",
+        "target": "ES5",
+        "outDir": &lt;OUTPUT_DIR&gt;,
+        "rootDir": &lt;SOURCE_DIR&gt;
+    }
+}</programlisting>
+<simpara>Then transpile with :</simpara>
+<programlisting language="javascript" linenumbering="unnumbered">tsc</programlisting>
+</listitem>
+</orderedlist>
+</section>
+<section xml:id="sec:Example_of_a_System_register_module">
+<title>Example of a System.register module</title>
+<simpara>For the following ES6 code :</simpara>
+<programlisting language="javascript" linenumbering="unnumbered">import { p as q } from './dep';
+
+var s = 'local';
+
+export function func() {
+    return q;
+}
+
+export class C {}</programlisting>
+<simpara>The <literal>Babel</literal> transpiler generates the following code (w/ <literal>System.register</literal> format):</simpara>
+<programlisting language="javascript" linenumbering="unnumbered">System.register(['./dep'], function (_export) {
+    'use strict';
+
+    var q, s, C;
+
+    _export('func', func);
+
+    function _classCallCheck(instance, Constructor) { .. }
+
+    function func() {
+        return q;
+    }
+
+    return {
+        setters: [function (_dep) {
+            q = _dep.p;
+        }],
+        execute: function () {
+            s = 'local';
+
+            C = function C() {
+                _classCallCheck(this, C);
+            };
+
+            _export('C', C);
+        }
+    };
+});</programlisting>
+</section>
+</section>
+<section xml:id="sec:Structure_of_a_System_register_module">
+<title>Structure of a System.register module</title>
+<simpara>Broadly speaking, a <literal>System.register</literal> module has the following structure :</simpara>
+<programlisting language="javascript" linenumbering="unnumbered">System.register(&lt;&lt;DEPENDENCIES ARRAY&gt;&gt;, function(&lt;&lt;exportFn&gt;&gt;) {
+    &lt;&lt;DECLARATION SCOPE&gt;&gt;
+
+    return {
+        setters: &lt;&lt;SETTERS ARRAY&gt;&gt;,
+        execute: function() {
+            &lt;&lt;EXECUTABLES&gt;&gt;
+        }
+    };
+});</programlisting>
+<simpara>Highlights :</simpara>
+<itemizedlist>
+<listitem>
+<simpara><literal>System.register(&#8230;&#8203;)</literal> is called with 2 arguments :</simpara>
+<itemizedlist>
+<listitem>
+<simpara><literal>&lt;&lt;DEPENDENCIES ARRAY&gt;&gt;</literal> : an array of dependencies (similar to <literal>AMD</literal>) extracted from the <literal>ES6 import</literal> statements.</simpara>
+</listitem>
+<listitem>
+<simpara>a function (<literal>FN</literal>) :</simpara>
+<itemizedlist>
+<listitem>
+<simpara>accepts a parameter called <literal>&lt;&lt;exportFn&gt;&gt;</literal>. This <literal>&lt;&lt;exportFn&gt;&gt;</literal> (provided by <literal>SystemJS</literal>) keeps a track of all the exports of this module &amp; will inform all the importing modules of any changes.</simpara>
+</listitem>
+<listitem>
+<simpara>contains a <literal>&lt;&lt;DECLARATION SCOPE&gt;&gt;</literal> where all the functions and variables (from the source code) get hoisted to.</simpara>
+</listitem>
+<listitem>
+<simpara>returns an object with 2 properties :</simpara>
+<itemizedlist>
+<listitem>
+<simpara><literal>setters</literal> : The <literal>&lt;&lt;SETTERS ARRAY&gt;&gt;</literal> is simply an array of functions. Each of these functions represents the imported-bindings from the <literal>&lt;&lt;DEPENDENCIES ARRAY&gt;&gt;</literal>. The <literal>&lt;&lt;SETTERS ARRAY&gt;&gt;</literal> and <literal>&lt;&lt;DEPENDENCIES ARRAY&gt;&gt;</literal> follow the same order.</simpara>
+</listitem>
+<listitem>
+<simpara><literal>execute</literal> : <literal>&lt;&lt;EXECUTABLES&gt;&gt;</literal> is the rest of the body of the source code.</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+</itemizedlist>
+</listitem>
+</itemizedlist>
+</listitem>
+</itemizedlist>
+</section>
+<section xml:id="_transpilation-hints">
+<title>Transpilation Hints</title>
+<simpara>By observing the existing transpilers’ output, this sub-section provides insights into the process of transpiling to this format :</simpara>
+<section xml:id="sec:Handling_Imports">
+<title>Handling Imports</title>
+<simpara>The following are ES6 code snippets with some <literal>import</literal> statements :</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>Simple Import Statement</simpara>
+<programlisting language="javascript" linenumbering="unnumbered">import {b1} from 'B';</programlisting>
+<simpara>A valid <literal>System.register</literal> output for this snippet would look like :</simpara>
+<screen>System.register(['B'], function (&lt;&lt;exportFn&gt;&gt;) { //(1.)
+
+  var b1;  //(2.)
+
+  return {
+
+    //(3.)
+    setters: [function (_B) {
+      b1 = _B.b1; //(4.)
+    }],
+
+    execute: function () {}
+  };
+});</screen>
+<informaltable tabstyle="horizontal" frame="none" colsep="0" rowsep="0">
+<tgroup cols="2">
+<colspec colwidth="15*"/>
+<colspec colwidth="85*"/>
+<tbody valign="top">
+<row>
+<entry>
+<simpara>highlights</simpara>
+</entry>
+<entry>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>The <literal>&lt;&lt;DEPENDENCIES ARRAY&gt;&gt;</literal> is just <literal>[’B’]</literal>.</simpara>
+</listitem>
+<listitem>
+<simpara>The <literal>&lt;&lt;DECLARATION SCOPE&gt;&gt;</literal> simply declares the imported binding <literal>v1</literal> as a variable.</simpara>
+</listitem>
+<listitem>
+<simpara>The <literal>&lt;&lt;SETTERS ARRAY&gt;&gt;</literal> has 1 function. This function corresponds to the single dependency (<literal>’B’</literal>) from (1.)</simpara>
+</listitem>
+<listitem>
+<simpara>The setter function accepts one argument (the exported object from <literal>’B’</literal> as <literal>_B</literal> . It then sets the local binding (i.e. local variable <literal>v1</literal>) to <literal>_B.b1</literal>.</simpara>
+</listitem>
+</orderedlist>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Takeaway</simpara>
+</entry>
+<entry>
+<itemizedlist>
+<listitem>
+<simpara>An <literal>import</literal> statement is broken down into <literal>&lt;&lt;DEPENDENCIES ARRAY&gt;&gt;</literal> &amp; <literal>&lt;&lt;SETTERS ARRAY&gt;&gt;</literal>.</simpara>
+</listitem>
+<listitem>
+<simpara>Whenever the value of <literal>b1</literal> inside <literal>B</literal> is changed, <literal>SystemJS</literal> will execute the corresponding <literal>setter function</literal> in this module i.e. the 1st function in this case.</simpara>
+</listitem>
+</itemizedlist>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+</listitem>
+<listitem>
+<simpara>Multiple Import Statements</simpara>
+<screen>import { a1 as a0 } from 'A';
+import {b1} from 'B';
+import { c1 as c0 } from 'C';
+import {b2, b3} from 'B';
+import {default} from 'C';
+import {a2} from 'A';</screen>
+<simpara>A valid <literal>System.register</literal> output for this snippet would look like :</simpara>
+<screen>System.register(['A', 'B', 'C'], function (&lt;&lt;exportFn&gt;&gt;) { //(1.)
+
+  var a0, a2, b1, b2, b3, c0, default;  //(2.)
+
+  return {
+
+    //(3.)
+    setters: [function (_A) {
+      a0 = _A.a1;         //(4.1.)
+      a2 = _A.a2;         //(4.2.)
+    }, function (_B) {
+      b1 = _B.b1;
+      b2 = _B.b2;
+      b3 = _B.b3;
+    }, function (_C) {
+      c0 = _C.c1;
+      default = _C['default'];
+    }],
+
+
+    execute: function () {}
+  };
+});</screen>
+<informaltable tabstyle="horizontal" frame="none" colsep="0" rowsep="0">
+<tgroup cols="2">
+<colspec colwidth="15*"/>
+<colspec colwidth="85*"/>
+<tbody valign="top">
+<row>
+<entry>
+<simpara>highlights</simpara>
+</entry>
+<entry>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>The <literal>&lt;&lt;DEPENDENCIES ARRAY&gt;&gt;</literal> is now a unique array <literal>[’A’, ’B’, ’C’]</literal>. Note that there are no duplicates.</simpara>
+</listitem>
+<listitem>
+<simpara>The <literal>&lt;&lt;DECLARATION SCOPE&gt;&gt;</literal> simply declares all the imported bindings as variables.</simpara>
+</listitem>
+<listitem>
+<simpara>The <literal>&lt;&lt;SETTERS ARRAY&gt;&gt;</literal> now has 3 functions. These 3 functions match the ordering of the <literal>&lt;&lt;DEPENDENCIES ARRAY&gt;&gt;</literal>.</simpara>
+</listitem>
+<listitem>
+<simpara>The setter function accepts one argument (the exported object from the dependency) It then sets the local bindings (i.e. local variables) from the exported value of the dependency.</simpara>
+</listitem>
+</orderedlist>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Takeaway</simpara>
+</entry>
+<entry>
+<itemizedlist>
+<listitem>
+<simpara>Whenever an exported value from <literal>A</literal> is changed, <literal>SystemJS</literal> will execute the first <literal>setter function</literal> in this module.</simpara>
+</listitem>
+<listitem>
+<simpara>Whenever an exported value from <literal>B</literal> is changed, <literal>SystemJS</literal> will execute the second <literal>setter function</literal> in this module.</simpara>
+</listitem>
+<listitem>
+<simpara>Whenever an exported value from <literal>C</literal> is changed, <literal>SystemJS</literal> will execute the third <literal>setter function</literal> in this module.</simpara>
+</listitem>
+</itemizedlist>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+</listitem>
+</orderedlist>
+</section>
+<section xml:id="sec:__exportFn__">
+<title>&lt;&lt;exportFn&gt;&gt;</title>
+<simpara>Before moving on to handling exports, let’s focus on the SystemJS provided <literal>&lt;&lt;exportFn&gt;&gt;</literal>.</simpara>
+<simpara>This function looks similar to the following :</simpara>
+<screen>function (name, value) {     //(1.)
+      module.locked = true;
+
+      if (typeof name == 'object') {
+        for (var p in name)
+          exports[p] = name[p];      //(2.1.)
+      }
+      else {
+        exports[name] = value;      //(2.2.)
+      }
+
+      for (var i = 0, l = module.importers.length; i &lt; l; i++) {
+        var importerModule = module.importers[i];
+        if (!importerModule.locked) {
+          var importerIndex = indexOf.call(importerModule.dependencies, module);
+          importerModule.setters[importerIndex](exports);     //(3.)
+        }
+      }
+
+      module.locked = false;
+      return value; //(4.)
+}</screen>
+<informaltable tabstyle="horizontal" frame="none" colsep="0" rowsep="0">
+<tgroup cols="2">
+<colspec colwidth="15*"/>
+<colspec colwidth="85*"/>
+<tbody valign="top">
+<row>
+<entry>
+<simpara>highlights</simpara>
+</entry>
+<entry>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>The <literal>&lt;&lt;exportFn&gt;&gt;</literal> takes 2 arguments : <literal>name</literal> &amp; <literal>value</literal>.</simpara>
+</listitem>
+<listitem>
+<simpara>It maintains an <literal>exports</literal> object with <literal>name</literal> &amp; <literal>value</literal>.</simpara>
+</listitem>
+<listitem>
+<simpara>For every module which imports the current module, it executes the corresponding <literal>setter function</literal>.</simpara>
+</listitem>
+<listitem>
+<simpara>It returns the <literal>value</literal>.</simpara>
+</listitem>
+</orderedlist>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+<informaltable tabstyle="horizontal" frame="none" colsep="0" rowsep="0">
+<tgroup cols="2">
+<colspec colwidth="15*"/>
+<colspec colwidth="85*"/>
+<tbody valign="top">
+<row>
+<entry>
+<simpara>Takeaway</simpara>
+</entry>
+<entry>
+<simpara>This <literal>&lt;&lt;exportFn&gt;&gt;</literal> is responsible for pushing the changes from a module to every importing module thereby implementing the live binding.</simpara>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+</section>
+<section xml:id="sec:Handling_Exports">
+<title>Handling Exports</title>
+<simpara>Now let’s focus on handling <literal>export</literal> statements.</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>Simple Exports Statement</simpara>
+<screen>export var v =1;
+export function f(){}</screen>
+<simpara>A valid <literal>System.register</literal> output for this snippet would look like :</simpara>
+<screen>System.register([], function (_export) {  //(1.)
+
+   //(2.)
+  var v;
+  function f() {}
+
+  _export("f", f); //(4.1)
+
+  return {
+    setters: [],
+
+    //(3.)
+    execute: function () {
+      v = 1;  //(3.1.)
+
+      _export("v", v); //(4.2.)
+    }
+  };
+});</screen>
+<informaltable tabstyle="horizontal" frame="none" colsep="0" rowsep="0">
+<tgroup cols="2">
+<colspec colwidth="15*"/>
+<colspec colwidth="85*"/>
+<tbody valign="top">
+<row>
+<entry>
+<simpara>highlights</simpara>
+</entry>
+<entry>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>The <literal>&lt;&lt;exportFn&gt;&gt;</literal> is named to as <literal>_export</literal>. (This is an implementation decision by Babel.) The name should be unique to not conflict with any user-defined variable/function names.</simpara>
+</listitem>
+<listitem>
+<simpara>The <literal>&lt;&lt;DECLARATION SCOPE&gt;&gt;</literal> hoists the exported variable <literal>v</literal> and the function <literal>f</literal>.</simpara>
+</listitem>
+<listitem>
+<simpara>The <literal>&lt;&lt;EXECUTABLES&gt;&gt;</literal> zone now contains the executable code from the source module.</simpara>
+</listitem>
+<listitem>
+<simpara>Initialise the variable <literal>v1</literal> with the value extracted from the source. This essentially is the executable part of the module.</simpara>
+</listitem>
+<listitem>
+<simpara>The <literal>export</literal> function expression results in a call to the <literal>_exports</literal> function as: <literal>_export(f, f)</literal></simpara>
+</listitem>
+<listitem>
+<simpara>The <literal>export</literal> statement results in a call to the <literal>_export</literal> function as: <literal>_export(v, v)</literal></simpara>
+</listitem>
+</orderedlist>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Takeaway</simpara>
+</entry>
+<entry>
+<itemizedlist>
+<listitem>
+<simpara>The module’s exports statements are separated from the hoistable and executable statements.</simpara>
+</listitem>
+<listitem>
+<simpara>All the exported bindings are tracked by wrapping them inside the <literal>&lt;&lt;exportFn&gt;&gt;</literal>.</simpara>
+</listitem>
+</itemizedlist>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+</listitem>
+<listitem>
+<simpara>Tracking Exported Bindings</simpara>
+<simpara>To maintain live bindings, <literal>SystemJS</literal> needs to track any changes to exported bindings in order to call the <literal>setter</literal> functions of importing modules. Let’s look at an example for that :</simpara>
+<screen>export var v1 = 1;
+export var v2 = 2;
+export var v3 = 3;
+export function f() {}
+
+v1++; //(1.)
+++v2; //(2.)
+v3 += 5; //(3.)
+f = null; //(4.)</screen>
+<simpara><literal>Babel</literal> output for this snippet looks like :</simpara>
+<screen>System.register([], function (_export) {
+
+  var v1, v2, v3;
+
+  _export("f", f);
+
+  function f() {}
+
+  return {
+    setters: [],
+
+    execute: function () {
+      v1 = 1;
+
+      _export("v1", v1);
+
+      v2 = 2;
+
+      _export("v2", v2);
+
+      v3 = 3;
+
+      _export("v3", v3);
+
+      _export("v1", v1 += 1); //(1.)
+      _export("v2", v2 += 1); //(2.)
+      _export("v3", v3 += 5); //(3.)
+      _export("f", f = null); //(4.)
+    }
+  };
+});</screen>
+<simpara><literal>Traceur</literal> output for this snippet looks like :</simpara>
+<screen>System.register([], function($__export) {
+
+  var v1, v2, v3;
+  function f() {}
+
+  $__export("f", f);
+
+  return {
+    setters: [],
+
+    execute: function() {
+      v1 = 1;
+      $__export("v1", v1);
+      v2 = 2;
+      $__export("v2", v2);
+      v3 = 3;
+      $__export("v3", v3);
+
+      ($__export("v1", v1 + 1), v1++); //(1.)
+      $__export("v2", ++v2); //(2.)
+      $__export("v3", v3 += 5); //(3.)
+      $__export("f", f = null); //(4.)
+    }
+  };
+});</screen>
+<simpara><literal>TypeScript</literal> output for this snippet looks like :</simpara>
+<screen>System.register([], function(exports_1) {
+    var v1, v2, v3;
+    function f() { }
+
+    exports_1("f", f);
+
+    return {
+        setters:[],
+
+        execute: function() {
+            exports_1("v1", v1 = 1);
+            exports_1("v2", v2 = 2);
+            exports_1("v3", v3 = 3);
+
+            (exports_1("v1", ++v1) - 1); //(1.)
+            exports_1("v2", ++v2); //(2.)
+            exports_1("v3", v3 += 5); //(3.)
+            f = null; //(4.)
+        }
+    }
+});</screen>
+<informaltable tabstyle="horizontal" frame="none" colsep="0" rowsep="0">
+<tgroup cols="2">
+<colspec colwidth="15*"/>
+<colspec colwidth="85*"/>
+<tbody valign="top">
+<row>
+<entry>
+<simpara>highlights</simpara>
+</entry>
+<entry>
+<itemizedlist>
+<listitem>
+<simpara>The re-assignment of <literal>v1, v2, v3 and f</literal> is wrapped inside a call to the <literal>&lt;&lt;exportFn&gt;&gt;</literal> with the updated value.</simpara>
+</listitem>
+</itemizedlist>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Takeaway</simpara>
+</entry>
+<entry>
+<itemizedlist>
+<listitem>
+<simpara>While transpiling we need to detect if any exported binding is reassigned. In that case invoke the <literal>&lt;&lt;exportFn&gt;&gt;</literal> immediately with the new value.</simpara>
+</listitem>
+<listitem>
+<simpara>Different transpilers perform different optimization tricks, which may be worth looking at.</simpara>
+</listitem>
+</itemizedlist>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+</listitem>
+<listitem>
+<simpara>Exporting a Class extending an imported Class.</simpara>
+<simpara>Let’s look at the following class declaration :</simpara>
+<screen>import {A} from "A"; //&lt;-- import class A
+
+export class C extends A {}</screen>
+<simpara><literal>Babel</literal> output for this snippet looks like :</simpara>
+<screen>System.register(["A"], function (_export) {
+
+  var A, C;
+
+  var _get = function get(_x, _x2, _x3) { ... };
+
+  function _classCallCheck(instance, Constructor) { ... }
+
+  function _inherits(subClass, superClass) { ... }
+
+  return {
+    setters: [function (_A2) {
+      A = _A2.A;
+    }],
+
+    execute: function () { //(1.)
+      C = (function (_A) {
+        _inherits(C, _A);
+
+        function C() {
+          _classCallCheck(this, C);
+
+          _get(Object.getPrototypeOf(C.prototype), "constructor", this).apply(this, arguments);
+        }
+
+        return C;
+      })(A);
+
+      _export("C", C);
+    }
+  };
+});</screen>
+<simpara><literal>Traceur</literal> output for this snippet looks like :</simpara>
+<screen>System.register(["A"], function($__export) {
+  var A, C;
+
+  return {
+    setters: [function($__m) {
+      A = $__m.A;
+    }],
+
+    execute: function() { //(1.)
+      C = $traceurRuntime.initTailRecursiveFunction(function($__super) {
+        return $traceurRuntime.call(function($__super) {
+          function C() {
+            $traceurRuntime.superConstructor(C).apply(this, arguments);
+          }
+          return $traceurRuntime.continuation($traceurRuntime.createClass, $traceurRuntime, [C, {}, {}, $__super]);
+        }, this, arguments);
+      })(A);
+      $__export("C", C);
+    }
+  };
+});</screen>
+<simpara><literal>TypeScript</literal> output for this snippet looks like :</simpara>
+<screen>System.register(["A"], function(exports_1) {
+    var __extends = function(){ ... }
+    var A_1;
+    var C;
+
+    return {
+        setters:[
+            function (A_1_1) {
+                A_1 = A_1_1;
+            }],
+
+        execute: function() { //(1.)
+            C = (function (_super) {
+                __extends(C, _super);
+                function C() {
+                    _super.apply(this, arguments);
+                }
+                return C;
+            })(A_1.A);
+            exports_1("C", C);
+        }
+    }
+});</screen>
+<informaltable tabstyle="horizontal" frame="none" colsep="0" rowsep="0">
+<tgroup cols="2">
+<colspec colwidth="15*"/>
+<colspec colwidth="85*"/>
+<tbody valign="top">
+<row>
+<entry>
+<simpara>highlights</simpara>
+</entry>
+<entry>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>Notice how the construction of class <literal>C</literal> has now been deferred to the <literal>&lt;&lt;EXECUTABLES&gt;&gt;</literal> zone. It is because <literal>C</literal> depends on <literal>A</literal> being imported first.</simpara>
+</listitem>
+</orderedlist>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Takeaway</simpara>
+</entry>
+<entry>
+<itemizedlist>
+<listitem>
+<simpara>The <literal>&lt;&lt;DECLARATION SCOPE&gt;&gt;</literal> is for hoisting only independent entities i.e. the ones that do not depend upon any imports. Everything else is moved to the <literal>&lt;&lt;EXECUTABLES&gt;&gt;</literal> region.</simpara>
+</listitem>
+</itemizedlist>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+</listitem>
+</orderedlist>
+</section>
+</section>
+<section xml:id="sec:Examples_w__Circular_Dependencies">
+<title>Examples w/ Circular Dependencies</title>
+<simpara>This section focuses on circular dependencies. The goal is to see how the transpiled output looks like and if the execution is possible.</simpara>
+<informalexample>
+<simpara>Source files:</simpara>
+<screen>import B from "B";
+
+export default class A {}
+A.b = new B(); //&lt;---</screen>
+<screen>import A from "A";
+
+export default class B {}
+B.a = new A(); //&lt;---</screen>
+<simpara>Transpiled Outputs (w/ Babel):<?asciidoc-br?></simpara>
+<screen>System.register(["B"], function (_export) {
+  "use strict";
+
+  var B, A;
+
+  function _classCallCheck(instance, Constructor) {...}
+
+  return {
+    setters: [function (_B) {
+      B = _B["default"];
+    }],
+    execute: function () {
+      A = function A() {
+        _classCallCheck(this, A);
+      };
+
+      _export("default", A);
+
+      A.b = new B();
+    }
+  };
+});</screen>
+<screen>System.register(["A"], function (_export) {
+  "use strict";
+
+  var A, B;
+
+  function _classCallCheck(instance, Constructor) {...}
+
+  return {
+    setters: [function (_A) {
+      A = _A["default"];
+    }],
+    execute: function () {
+      B = function B() {
+        _classCallCheck(this, B);
+      };
+
+      _export("default", B);
+
+      B.a = new A();
+    }
+  };
+});</screen>
+<simpara>Execution Result<?asciidoc-br?></simpara>
+<screen>var System = require('systemjs');
+
+System.import('A', 'B').then(function(resp) {
+    var a = new A();
+    var b = new B();
+}).catch(function(e) {
+    console.log(e);
+});</screen>
+<screen>Babel : [Error: undefined is not a function]</screen>
+</informalexample>
+<informalexample>
+<simpara>Source files:</simpara>
+<screen>import {B} from "B";
+
+export class A extends B{}</screen>
+<screen>import {A} from "A";
+
+export class B{}
+class C extends A{}</screen>
+<simpara>Transpiled Outputs (w/ Babel) :<?asciidoc-br?></simpara>
+<screen>System.register(["B"], function (_export) {
+  "use strict";
+
+  var B, A;
+
+  var _get = function get(_x, _x2, _x3) { ... };
+
+  function _classCallCheck(instance, Constructor) { ... }
+
+  function _inherits(subClass, superClass) {...}
+
+  return {
+    setters: [function (_B2) {
+      B = _B2.B;
+    }],
+    execute: function () {
+      A = (function (_B) {
+        _inherits(A, _B);
+
+        function A() {
+          _classCallCheck(this, A);
+
+          _get(Object.getPrototypeOf(A.prototype), "constructor", this).apply(this, arguments);
+        }
+
+        return A;
+      })(B);
+
+      _export("A", A);
+    }
+  };
+});</screen>
+<screen>System.register(["A"], function (_export) {
+  "use strict";
+
+  var A, B, C;
+
+  var _get = function get(_x, _x2, _x3) { ... };
+
+  function _inherits(subClass, superClass) { ... }
+
+  function _classCallCheck(instance, Constructor) { ... }
+
+  return {
+    setters: [function (_A2) {
+      A = _A2.A;
+    }],
+    execute: function () {
+      B = function B() {
+        _classCallCheck(this, B);
+      };
+
+      _export("B", B);
+
+      C = (function (_A) {
+        _inherits(C, _A);
+
+        function C() {
+          _classCallCheck(this, C);
+
+          _get(Object.getPrototypeOf(C.prototype), "constructor", this).apply(this, arguments);
+        }
+
+        return C;
+      })(A);
+    }
+  };
+});</screen>
+<simpara>Execution Result<?asciidoc-br?></simpara>
+<screen>var System = require('systemjs');
+
+System.import('A','B').then(function(resp) {
+    var a = new A();
+}).catch(function(e) {
+    console.log(e);
+});</screen>
+<screen>TypeScript : [Error: Cannot read property 'prototype' of undefined]
+Babel : [Error: Super expression must either be null or a function, not undefined]</screen>
+</informalexample>
+<informalexample>
+<simpara>Source files:</simpara>
+<screen>import B from "B";
+
+class A extends B {}
+export default class X {}</screen>
+<screen>import X from "A";
+
+export default class B {}
+class Y extends X {}</screen>
+<simpara>Transpiled Outputs (w/ Babel):<?asciidoc-br?></simpara>
+<screen>System.register(["B"], function (_export) {
+  "use strict";
+
+  var B, A, X;
+
+  var _get = function get(_x, _x2, _x3) { ... };
+
+  function _classCallCheck(instance, Constructor) { ... }
+
+  function _inherits(subClass, superClass) { ... }
+
+  return {
+    setters: [function (_B2) {
+      B = _B2["default"];
+    }],
+    execute: function () {
+      A = (function (_B) {
+        _inherits(A, _B);
+
+        function A() {
+          _classCallCheck(this, A);
+
+          _get(Object.getPrototypeOf(A.prototype), "constructor", this).apply(this, arguments);
+        }
+
+        return A;
+      })(B);
+
+      X = function X() {
+        _classCallCheck(this, X);
+      };
+
+      _export("default", X);
+    }
+  };
+});</screen>
+<screen>System.register(["A"], function (_export) {
+  "use strict";
+
+  var X, B, Y;
+
+  var _get = function get(_x, _x2, _x3) { ... };
+
+  function _inherits(subClass, superClass) { ... }
+
+  function _classCallCheck(instance, Constructor) { ... }
+
+  return {
+    setters: [function (_A) {
+      X = _A["default"];
+    }],
+    execute: function () {
+      B = function B() {
+        _classCallCheck(this, B);
+      };
+
+      _export("default", B);
+
+      Y = (function (_X) {
+        _inherits(Y, _X);
+
+        function Y() {
+          _classCallCheck(this, Y);
+
+          _get(Object.getPrototypeOf(Y.prototype), "constructor", this).apply(this, arguments);
+        }
+
+        return Y;
+      })(X);
+    }
+  };
+});</screen>
+<simpara>Execution Result<?asciidoc-br?></simpara>
+<screen>var System = require('systemjs');
+
+System.import('A').then(function(resp) {
+    var a = new A();
+}).catch(function(e) {
+    console.log(e);
+});</screen>
+<screen>TypeScript : [Error: Cannot read property 'prototype' of undefined]
+Babel : [[Error: Super expression must either be null or a function, not undefined]]</screen>
+</informalexample>
+</section>
+<section xml:id="sec:N4JS_Examples_w__Circular_Dependencies">
+<title>N4JS Examples w/ Circular Dependencies</title>
+<simpara>In order to improve our precision in conversing and discussing about different kinds of circular dependencies, this section provides the most basic examples of different kinds.</simpara>
+<section xml:id="sec:Unresolved_Cyclic_Dependencies">
+<title>Unresolved Cyclic Dependencies</title>
+<simpara>Below examples demonstrate cases when cyclic dependency cannot be resolved at all and will cause runtime errors.</simpara>
+<example>
+<title>Circular dependency resolution 1</title>
+<screen>import b from "B"
+
+export public var number a = 1;
+export public var number a2 = b + 1;</screen>
+<screen>import a from "A"
+
+export public var number b = a + 1;</screen>
+<screen>import a2 from "A"
+console.log(a2); //&lt;-- should be 3. not NaN.</screen>
+</example>
+<example>
+<title>Circular dependency resolution 2</title>
+<screen>import B from "B"
+
+export public class A {
+    static a = B.b + 1;
+}</screen>
+<screen>import A from "A"
+export public class B {
+    static b = 1;
+}
+export public class B2 {
+    static b2 = A.a;
+}</screen>
+<screen>import B2 from "B"
+console.log(B2.b2); //should log 2</screen>
+</example>
+<example>
+<title>Circular dependency resolution 3</title>
+<screen>import B from "B"
+export public class A {
+    B b = new B();
+}</screen>
+<screen>import A from "A"
+export public class B {
+    A a = new A();
+}</screen>
+<screen>import A from "A"
+new A(); // should not cause a runtime error.</screen>
+</example>
+</section>
+<section xml:id="sec:Variables___Functions">
+<title>Examples with Variables &amp; Functions</title>
+<example>
+<title>Circular dependency resolution 4</title>
+<screen>import b_fun from "B"
+
+export public var a2 = b_fun();
+export public var a = 1;</screen>
+<screen>import a from "A"
+
+export public function b_fun() {
+    return a + 1;
+}</screen>
+<screen>import a2 from "A"
+console.log(a2); //&lt;-- should be 2. not NaN.</screen>
+</example>
+</section>
+<section xml:id="sec:Classes">
+<title>Examples with Classes</title>
+<example>
+<title>Circular dependency resolution 5</title>
+<screen>import B from "B"
+export public class A {
+    static a1 = 1;
+    static a2 = B.b1;
+}</screen>
+<screen>import A from "A"
+export public class B {
+    static b1 = A.a1;
+}</screen>
+<screen>import A from "A"
+console.log(A.a1); //should log 1. not an error.</screen>
+</example>
+<example>
+<title>Circular dependency resolution 6</title>
+<screen>import B from "B"
+export public class A {
+    static a1 = 1;
+    static a2 = B.b1;
+}</screen>
+<screen>import A from "A"
+export public class B {
+    static b1 = -1;
+    static b2 = A.a1;
+}</screen>
+<screen>import A from "A"
+console.log(A.a1);//should log 1. not an error.</screen>
+</example>
+<example>
+<title>Circular dependency resolution 7</title>
+<screen>import B from "B"
+export public class A {
+    static a = new B();
+}</screen>
+<screen>import A from "A"
+export public class B {
+    static b = new A();
+}</screen>
+<screen>import A from "A"
+new A(); //should succeed.</screen>
+</example>
+</section>
+<section xml:id="sec:Examples_with_SubClassing">
+<title>Examples with SubClassing</title>
+<example>
+<title>Circular dependency resolution 8</title>
+<screen>import B from "B"
+export public class A {}
+export public class C extends B {}</screen>
+<screen>import A from "A"
+export public class B extends A{}</screen>
+<screen>import C from "A"
+new C();//should succeed.</screen>
+</example>
+<example>
+<title>Circular dependency resolution 9</title>
+<screen>import B from "B"
+export public class A {}
+export public class C {
+    c = new B();
+}</screen>
+<screen>import A from "A"
+export public class B extends A{}</screen>
+<screen>import C from "A"
+new C(); //should succeed.</screen>
+</example>
+</section>
+<section xml:id="sec:Miscellaneous">
+<title>Miscellaneous</title>
+<example>
+<title>Circular dependency resolution 10</title>
+<screen>import B from "B"
+export public class A {}
+new B();</screen>
+<screen>import A from "A"
+export public class B {}
+new A();</screen>
+<screen>import A from "A"
+new A() //should succeed.</screen>
+</example>
+<example>
+<title>Circular dependency resolution 11</title>
+<screen>import B from "B"
+export public class A {}
+B.b1;</screen>
+<screen>import A from "A"
+export public class B {
+    static b1;
+}
+new A();</screen>
+<screen>import A from "A"
+new A() //should succeed.</screen>
+</example>
+</section>
+</section>
+<section xml:id="_resources">
+<title>Resources</title>
+<simpara><link xl:href="https://github.com/ModuleLoader/es6-module-loader/blob/master/docs/system-register.md">Wiki</link></simpara>
+</section>
+</section>
+<section xml:id="sec:CommonJS_as_transpilation_target" role="language-js">
+<title>CommonJS as transpilation target</title>
+<simpara>To provide better compatibility with <literal>npm</literal> eco-system, we want to transpile <literal>N4JS</literal> code to <literal>CommonJS</literal> module format.</simpara>
+<section xml:id="_introduction-2">
+<title>Introduction</title>
+<simpara>A sample <literal>CommonJS</literal> module :</simpara>
+<screen>var lib1 = require("/lib1"); //&lt;-- require
+var lib2 = require("/lib2"); //&lt;-- require
+
+function fn() {
+    //...something using 'lib1' &amp; 'lib2'
+}
+
+exports.usefulFn = fn; //&lt;--exports
+exports.uselessValue = 42; //&lt;--exports</screen>
+<simpara>The <link xl:href="http://www.commonjs.org/specs/modules/1.0/">CommonJS spec</link> describes the salient features of module format as (quoted verbatim) :</simpara>
+<blockquote>
+<simpara>Module Context</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>In a module, there is a free variable "require", that is a
+function.</simpara>
+<orderedlist numeration="loweralpha">
+<listitem>
+<simpara>The "require" function accepts a module identifier.</simpara>
+</listitem>
+<listitem>
+<simpara>"require" returns the exported API of the foreign module.</simpara>
+</listitem>
+<listitem>
+<simpara>If there is a dependency cycle, the foreign module may
+not have finished executing at the time it is required by one
+of its transitive dependencies; in this case, the object
+returned by "require" must contain at least the exports
+that the foreign module has prepared before the call to
+require that led to the current module&#8217;s execution.</simpara>
+</listitem>
+<listitem>
+<simpara>If the requested module cannot be returned, "require"
+must throw an error.</simpara>
+</listitem>
+</orderedlist>
+</listitem>
+<listitem>
+<simpara>In a module, there is a free variable called "exports",
+that is an object that the module may add its API to as it
+executes.</simpara>
+</listitem>
+<listitem>
+<simpara>modules must use the "exports" object as the only means
+of exporting.</simpara>
+</listitem>
+</orderedlist>
+<simpara>Module Identifiers</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>A module identifier is a String of "terms" delimited by forward
+slashes.</simpara>
+</listitem>
+<listitem>
+<simpara>A term must be a camelCase identifier, ".", or "..".</simpara>
+</listitem>
+<listitem>
+<simpara>Module identifiers may not have file-name extensions like ".js".</simpara>
+</listitem>
+<listitem>
+<simpara>Module identifiers may be "relative" or "top-level". A module
+identifier is "relative" if the first term is "." or "..".</simpara>
+</listitem>
+<listitem>
+<simpara>Top-level identifiers are resolved off the conceptual module
+name space root.</simpara>
+</listitem>
+<listitem>
+<simpara>Relative identifiers are resolved relative to the identifier of
+the module in which "require" is written and called.</simpara>
+</listitem>
+</orderedlist>
+</blockquote>
+</section>
+<section xml:id="sec:Transpilation_Hints">
+<title>Transpilation Hints</title>
+<simpara>This section examines how <literal>Babel</literal> transpiles <literal>ES6</literal> modules to <literal>CommonJS</literal> format. By observing the transpiled output from <literal>Babel</literal>, we can gather insights for transpiling <literal>N4JS</literal> modules to <literal>CommonJS</literal> format.</simpara>
+<section xml:id="sec:Import_Statements">
+<title>Import Statements</title>
+<example>
+<title>Import an entire module (for side effects only)</title>
+<screen>import "B";
+console.log(B);</screen>
+<screen>"use strict";
+
+require("B");
+console.log(B);</screen>
+</example>
+<example>
+<title>Import single member of a module</title>
+<screen>import {b1} from "B";
+b1;</screen>
+<screen>"use strict";
+
+var _B = require("B");
+_B.b1;</screen>
+</example>
+<example>
+<title>Import multiple members of a module</title>
+<screen>import {b1, b2} from "B";
+b1;
+b2;</screen>
+<screen>"use strict";
+
+var _B = require("B");
+
+_B.b1;
+_B.b2;</screen>
+</example>
+<example>
+<title>Import a single member of a module w/ an alias</title>
+<screen>import {b3 as b4} from "B";
+b4 + 1;</screen>
+<screen>"use strict";
+
+var _B = require("B");
+
+_B.b3 + 1;</screen>
+</example>
+<example>
+<title>Import multiple members of a module w/ aliases</title>
+<screen>import {b3 as b4, b5 as b6} from "B";
+b4 + 1;
+b6 + 1;</screen>
+<screen>"use strict";
+
+var _B = require("B");
+
+_B.b3 + 1;
+_B.b5 + 1;</screen>
+</example>
+<example>
+<title>Import ALL the bindings of a module</title>
+<screen>import * as B from "B";
+console.log(B);</screen>
+<screen>"use strict";
+
+function _interopRequireWildcard(obj) {
+    //Babel internally tracks ES6 modules using a flag "__esModule".
+    if (obj &amp;&amp; obj.__esModule) {
+        return obj;
+    } else {
+        //Copy over all the exported members.
+        var newObj = {};
+        if (obj != null) {
+            for (var key in obj) {
+                if (Object.prototype.hasOwnProperty.call(obj, key)) newObj[key] = obj[key];
+            }
+        }
+
+        //Set the "default" as the obj itself (ES6 default export)
+        newObj["default"] = obj;
+        return newObj;
+    }
+}
+
+var _B = require("B");
+
+var B = _interopRequireWildcard(_B);
+
+console.log(B);</screen>
+</example>
+<example>
+<title>Import the default export of a module</title>
+<screen>import B from "B";
+console.log(B);</screen>
+<screen>"use strict";
+
+//For importing a default export,
+//Babel checks if the obj is an ES6 module or not.
+function _interopRequireDefault(obj) {
+    return obj &amp;&amp; obj.__esModule ? obj : { "default": obj };
+}
+
+var _B = require("B");
+
+var _B2 = _interopRequireDefault(_B);
+
+console.log(_B2["default"]);</screen>
+</example>
+</section>
+<section xml:id="sec:Export_Statements">
+<title>Export Statements</title>
+<example>
+<title>Export a member</title>
+<screen>let a = 1;
+export {a};</screen>
+<screen>"use strict";
+
+//Babel makes a note that this is as an ES6 module.
+//This information is later used when this module is imported.
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+var a = 1;
+
+exports.a = a;</screen>
+</example>
+<example>
+<title>Export multiple members</title>
+<screen>let a = 1;
+let b = true;
+
+export {a, b};</screen>
+<screen>"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+var a = 1;
+var b = true;
+
+exports.a = a;
+exports.b = b;</screen>
+</example>
+<example>
+<title>Export using alias</title>
+<screen>let a =1;
+export {a as b};</screen>
+<screen>"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+var a = 1;
+exports.b = a;</screen>
+</example>
+<example>
+<title>Multiple exports using alias</title>
+<screen>let a = 1, b = 2;
+export {a as A, b as B};</screen>
+<screen>"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+var a = 1,
+    b = 2;
+exports.A = a;
+exports.B = b;</screen>
+</example>
+<example>
+<title>Simple default export</title>
+<screen>export default 42;</screen>
+<screen>"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = 42; //&lt;-- default export is treated as a special named export
+module.exports = exports["default"]; //&lt;-- IMPORTANT</screen>
+</example>
+<example>
+<title>Default export using an alias</title>
+<screen>let x =10;
+export {x as default};</screen>
+<screen>"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+var x = 10;
+exports["default"] = x;
+module.exports = exports["default"];</screen>
+</example>
+<example>
+<title>Default export w/ named export</title>
+<screen>let a = 1;
+export {a};
+export default 42;</screen>
+<screen>"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+var a = 1;
+exports.a = a;
+exports["default"] = 42;</screen>
+</example>
+<example>
+<title>Default export a class</title>
+<screen>export default class A  {}</screen>
+<screen>"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+
+function _classCallCheck(...) { ... }
+
+var A = function A() {
+  _classCallCheck(this, A);
+};
+
+exports["default"] = A;
+module.exports = exports["default"];</screen>
+</example>
+<example>
+<title>Wildcard re-export</title>
+<screen>export * from "A"</screen>
+<screen>"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+
+function _interopExportWildcard(obj, defaults) {
+    var newObj = defaults({}, obj);
+    delete newObj["default"]; //&lt;-- A module's default export can not be re-exported.
+    return newObj;
+}
+
+function _defaults(obj, defaults) {
+    var keys = Object.getOwnPropertyNames(defaults);
+    for (var i = 0; i &lt; keys.length; i++) {
+        var key = keys[i];
+        var value = Object.getOwnPropertyDescriptor(defaults, key);
+        if (value &amp;&amp; value.configurable &amp;&amp; obj[key] === undefined) {
+            Object.defineProperty(obj, key, value);
+        }
+    }
+    return obj;
+}
+
+var _A = require("A");
+
+_defaults(exports, _interopExportWildcard(_A, _defaults));</screen>
+</example>
+<example>
+<title>Specific member re-export</title>
+<screen>export {a1, a2} from "A";</screen>
+<screen>"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+
+var _A = require("A");
+
+Object.defineProperty(exports, "a1", {
+  enumerable: true,
+  get: function get() {
+    return _A.a1;
+  }
+});
+Object.defineProperty(exports, "a2", {
+  enumerable: true,
+  get: function get() {
+    return _A.a2;
+  }
+});</screen>
+</example>
+<example>
+<title>Specific member re-export using alias</title>
+<screen>export {a1 as A1, a2 as A2} from "A";</screen>
+<screen>"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+
+var _A = require("A");
+
+Object.defineProperty(exports, "A1", {
+  enumerable: true,
+  get: function get() {
+    return _A.a1;
+  }
+});
+Object.defineProperty(exports, "A2", {
+  enumerable: true,
+  get: function get() {
+    return _A.a2;
+  }
+});</screen>
+</example>
+</section>
+<section xml:id="sec:Tracking_Live_Bindings">
+<title>Tracking Live Bindings</title>
+<simpara>As specified in the section about <literal>ES6 Modules</literal> (<link linkend="sec:ES6_Modules">ES6 Modules</link>), <literal>ES6 Modules</literal> export live immutable bindings. The following listings demonstrate how <literal>Babel</literal> achieves this.</simpara>
+<example>
+<title>Tracking Live Binding</title>
+<screen>export var a = 1;
+a++;</screen>
+<screen>"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+var a = 1;
+exports.a = a;
+exports.a = a += 1; //&lt;-- Exported value is tracked.</screen>
+</example>
+</section>
+<section xml:id="sec:A_complete_example">
+<title>A complete example</title>
+<simpara>The following listings present a simple but complete example of ES6 export, import and live-binding concepts. It uses 3 simple <literal>ES6 modules</literal> called <literal>A.js, B.js and Main.js</literal>. The modules are listed alongside their <literal>CommonJS</literal> versions generated by <literal>Babel</literal>.</simpara>
+<informalexample>
+<screen>export var a = 1; //&lt;-- exports a number
+
+export function incA() { //&lt;-- exports a function
+    a++;
+}</screen>
+<screen>"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+
+exports.incA = incA;
+var a = 1;
+
+exports.a = a;
+
+function incA() {
+    exports.a = a += 1;
+}</screen>
+<screen>import {incA} from "./A"; //&lt;-- Imports the function from A.js
+
+export function incB() { //&lt;-- Exports a function that calls the imported function from A.js
+    incA();
+}</screen>
+<screen>"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+exports.incB = incB;
+
+var _A = require("./A");
+
+function incB() {
+    _A.incA();
+}</screen>
+<screen>import {a} from "./A"; //&lt;-- Imports the exported number from A.js
+import {incB} from "./B"; //&lt;-- Imports the exported function from B.js
+
+console.log(a); //&lt;-- Prints "1"
+incB(); //&lt;-- This will call the "incA" function of A.js
+console.log(a); //&lt;--Prints "2". The imported value "a" is updated.</screen>
+<screen>"use strict";
+
+var _A = require("./A");
+
+var _B = require("./B");
+
+console.log(_A.a);
+_B.incB();
+console.log(_A.a);</screen>
+</informalexample>
+</section>
+</section>
+<section xml:id="_resources-2">
+<title>Resources</title>
+<simpara><link xl:href="http://exploringjs.com/es6/ch_modules.html">Exploring ES6 by Dr. Axel Rauschmayer</link></simpara>
+<simpara><link xl:href="http://www.commonjs.org/specs/modules/1.0/">CommonJS spec</link></simpara>
+<simpara><link xl:href="http://benjamn.github.io/empirenode-2015/">The Importance of import and export</link></simpara>
+</section>
+</section>
+</appendix>
+<appendix xml:id="sec:License">
+<title>License</title>
+<simpara>This specification and the accompanying materials is made available
+under the terms of the Eclipse Public License v1.0 which accompanies
+this distribution, and is available at <link xl:href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</link></simpara>
+<bridgehead xml:id="_eclipse-public-license-v-1-0" renderas="sect2">Eclipse Public License - v 1.0</bridgehead>
+<simpara>THE ACCOMPANYING PROGRAM IS PROVIDED UNDER THE TERMS OF THIS ECLIPSE
+PUBLIC LICENSE (<literal>AGREEMENT</literal>). ANY USE, REPRODUCTION OR DISTRIBUTION OF
+THE PROGRAM CONSTITUTES RECIPIENT’S ACCEPTANCE OF THIS AGREEMENT.</simpara>
+<bridgehead xml:id="_1-definitions" renderas="sect3">1. DEFINITIONS</bridgehead>
+<variablelist>
+<varlistentry>
+<term><literal>Contribution</literal> means: </term>
+<listitem>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>in the case of the initial Contributor, the initial code and
+documentation distributed under this Agreement, and</simpara>
+</listitem>
+<listitem>
+<simpara>in the case of each subsequent Contributor:</simpara>
+<orderedlist numeration="loweralpha">
+<listitem>
+<simpara>changes to the Program, and</simpara>
+</listitem>
+<listitem>
+<simpara>additions to the Program;</simpara>
+<simpara>where such changes and/or additions to the Program originate from and
+are distributed by that particular Contributor. A Contribution
+’originates’ from a Contributor if it was added to the Program by such
+Contributor itself or anyone acting on such Contributor’s behalf.
+Contributions do not include additions to the Program which:</simpara>
+<orderedlist numeration="lowerroman">
+<listitem>
+<simpara>are separate modules of software distributed in conjunction with the Program
+under their own license agreement, and</simpara>
+</listitem>
+<listitem>
+<simpara>are not derivative works of the Program.</simpara>
+</listitem>
+</orderedlist>
+</listitem>
+</orderedlist>
+</listitem>
+</orderedlist>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>Contributor</literal></term>
+<listitem>
+<simpara>means any person or entity that distributes the Program.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>Licensed Patents</literal> </term>
+<listitem>
+<simpara>mean patent claims licensable by a Contributor
+which are necessarily infringed by the use or sale of its Contribution
+alone or when combined with the Program.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>Program</literal> </term>
+<listitem>
+<simpara>means the Contributions distributed in accordance with this
+Agreement.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>Recipient</literal> </term>
+<listitem>
+<simpara>means anyone who receives the Program under this
+Agreement, including all Contributors.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+<bridgehead xml:id="_2-grant-of-rights" renderas="sect3">2. GRANT OF RIGHTS</bridgehead>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>Subject to the terms of this Agreement, each Contributor hereby
+grants Recipient a non-exclusive, worldwide, royalty-free copyright
+license to reproduce, prepare derivative works of, publicly display,
+publicly perform, distribute and sublicense the Contribution of such
+Contributor, if any, and such derivative works, in source code and
+object code form.</simpara>
+</listitem>
+<listitem>
+<simpara>Subject to the terms of this Agreement, each Contributor hereby
+grants Recipient a non-exclusive, worldwide, royalty-free patent license
+under Licensed Patents to make, use, sell, offer to sell, import and
+otherwise transfer the Contribution of such Contributor, if any, in
+source code and object code form. This patent license shall apply to the
+combination of the Contribution and the Program if, at the time the
+Contribution is added by the Contributor, such addition of the
+Contribution causes such combination to be covered by the Licensed
+Patents. The patent license shall not apply to any other combinations
+which include the Contribution. No hardware per se is licensed
+hereunder.</simpara>
+</listitem>
+<listitem>
+<simpara>Recipient understands that although each Contributor grants the
+licenses to its Contributions set forth herein, no assurances are
+provided by any Contributor that the Program does not infringe the
+patent or other intellectual property rights of any other entity. Each
+Contributor disclaims any liability to Recipient for claims brought by
+any other entity based on infringement of intellectual property rights
+or otherwise. As a condition to exercising the rights and licenses
+granted hereunder, each Recipient hereby assumes sole responsibility to
+secure any other intellectual property rights needed, if any. For
+example, if a third party patent license is required to allow Recipient
+to distribute the Program, it is Recipient’s responsibility to acquire
+that license before distributing the Program.</simpara>
+</listitem>
+<listitem>
+<simpara>Each Contributor represents that to its knowledge it has sufficient
+copyright rights in its Contribution, if any, to grant the copyright
+license set forth in this Agreement.</simpara>
+</listitem>
+</orderedlist>
+<bridgehead xml:id="_3-requirements" renderas="sect3">3. REQUIREMENTS</bridgehead>
+<simpara>A Contributor may choose to distribute the Program in object code form
+under its own license agreement, provided that:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>it complies with the terms and conditions of this Agreement; and</simpara>
+</listitem>
+<listitem>
+<simpara>its license agreement:</simpara>
+<orderedlist numeration="loweralpha">
+<listitem>
+<simpara>effectively disclaims on behalf of all Contributors all warranties
+and conditions, express and implied, including warranties or conditions
+of title and non-infringement, and implied warranties or conditions of
+merchantability and fitness for a particular purpose;</simpara>
+</listitem>
+<listitem>
+<simpara>effectively excludes on behalf of all Contributors all liability for
+damages, including direct, indirect, special, incidental and
+consequential damages, such as lost profits;</simpara>
+</listitem>
+<listitem>
+<simpara>states that any provisions which differ from this Agreement are
+offered by that Contributor alone and not by any other party; and</simpara>
+</listitem>
+<listitem>
+<simpara>states that source code for the Program is available from such
+Contributor, and informs licensees how to obtain it in a reasonable
+manner on or through a medium customarily used for software exchange.</simpara>
+</listitem>
+</orderedlist>
+</listitem>
+</orderedlist>
+<simpara>When the Program is made available in source code form:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>it must be made available under this Agreement; and</simpara>
+</listitem>
+<listitem>
+<simpara>a copy of this Agreement must be included with each copy of the
+Program.</simpara>
+</listitem>
+</orderedlist>
+<simpara>Contributors may not remove or alter any copyright notices contained
+within the Program.</simpara>
+<simpara>Each Contributor must identify itself as the originator of its
+Contribution, if any, in a manner that reasonably allows subsequent
+Recipients to identify the originator of the Contribution.</simpara>
+<bridgehead xml:id="_4-commercial-distribution" renderas="sect3">4. COMMERCIAL DISTRIBUTION</bridgehead>
+<simpara>Commercial distributors of software may accept certain responsibilities
+with respect to end users, business partners and the like. While this
+license is intended to facilitate the commercial use of the Program, the
+Contributor who includes the Program in a commercial product offering
+should do so in a manner which does not create potential liability for
+other Contributors. Therefore, if a Contributor includes the Program in
+a commercial product offering, such Contributor (<literal>Commercial
+Contributor</literal>) hereby agrees to defend and indemnify every other
+Contributor (<literal>Indemnified Contributor</literal>) against any losses, damages
+and costs (collectively <literal>Losses</literal>) arising from claims, lawsuits and
+other legal actions brought by a third party against the Indemnified
+Contributor to the extent caused by the acts or omissions of such
+Commercial Contributor in connection with its distribution of the
+Program in a commercial product offering. The obligations in this
+section do not apply to any claims or Losses relating to any actual or
+alleged intellectual property infringement. In order to qualify, an
+Indemnified Contributor must: a) promptly notify the Commercial
+Contributor in writing of such claim, and b) allow the Commercial
+Contributor to control, and cooperate with the Commercial Contributor
+in, the defense and any related settlement negotiations. The Indemnified
+Contributor may participate in any such claim at its own expense.</simpara>
+<simpara>For example, a Contributor might include the Program in a commercial
+product offering, Product X. That Contributor is then a Commercial
+Contributor. If that Commercial Contributor then makes performance
+claims, or offers warranties related to Product X, those performance
+claims and warranties are such Commercial Contributor’s responsibility
+alone. Under this section, the Commercial Contributor would have to
+defend claims against the other Contributors related to those
+performance claims and warranties, and if a court requires any other
+Contributor to pay any damages as a result, the Commercial Contributor
+must pay those damages.</simpara>
+<bridgehead xml:id="_5-no-warranty" renderas="sect3">5. NO WARRANTY</bridgehead>
+<simpara>EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, THE PROGRAM IS PROVIDED
+ON AN <literal>AS IS</literal> BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,
+EITHER EXPRESS OR IMPLIED INCLUDING, WITHOUT LIMITATION, ANY WARRANTIES
+OR CONDITIONS OF TITLE, NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR
+A PARTICULAR PURPOSE. Each Recipient is solely responsible for
+determining the appropriateness of using and distributing the Program
+and assumes all risks associated with its exercise of rights under this
+Agreement , including but not limited to the risks and costs of program
+errors, compliance with applicable laws, damage to or loss of data,
+programs or equipment, and unavailability or interruption of operations.</simpara>
+<bridgehead xml:id="_6-disclaimer-of-liability" renderas="sect3">6. DISCLAIMER OF LIABILITY</bridgehead>
+<simpara>EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, NEITHER RECIPIENT NOR
+ANY CONTRIBUTORS SHALL HAVE ANY LIABILITY FOR ANY DIRECT, INDIRECT,
+INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING
+WITHOUT LIMITATION LOST PROFITS), HOWEVER CAUSED AND ON ANY THEORY OF
+LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OR
+DISTRIBUTION OF THE PROGRAM OR THE EXERCISE OF ANY RIGHTS GRANTED
+HEREUNDER, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.</simpara>
+<bridgehead xml:id="_7-general" renderas="sect3">7. GENERAL</bridgehead>
+<simpara>If any provision of this Agreement is invalid or unenforceable under
+applicable law, it shall not affect the validity or enforceability of
+the remainder of the terms of this Agreement, and without further action
+by the parties hereto, such provision shall be reformed to the minimum
+extent necessary to make such provision valid and enforceable.</simpara>
+<simpara>If Recipient institutes patent litigation against any entity (including
+a cross-claim or counterclaim in a lawsuit) alleging that the Program
+itself (excluding combinations of the Program with other software or
+hardware) infringes such Recipient’s patent(s), then such Recipient’s
+rights granted under Section 2(b) shall terminate as of the date such
+litigation is filed.</simpara>
+<simpara>All Recipient’s rights under this Agreement shall terminate if it fails
+to comply with any of the material terms or conditions of this Agreement
+and does not cure such failure in a reasonable period of time after
+becoming aware of such noncompliance. If all Recipient’s rights under
+this Agreement terminate, Recipient agrees to cease use and distribution
+of the Program as soon as reasonably practicable. However, Recipient’s
+obligations under this Agreement and any licenses granted by Recipient
+relating to the Program shall continue and survive.</simpara>
+<simpara>Everyone is permitted to copy and distribute copies of this Agreement,
+but in order to avoid inconsistency the Agreement is copyrighted and may
+only be modified in the following manner. The Agreement Steward reserves
+the right to publish new versions (including revisions) of this
+Agreement from time to time. No one other than the Agreement Steward has
+the right to modify this Agreement. The Eclipse Foundation is the
+initial Agreement Steward. The Eclipse Foundation may assign the
+responsibility to serve as the Agreement Steward to a suitable separate
+entity. Each new version of the Agreement will be given a distinguishing
+version number. The Program (including Contributions) may always be
+distributed subject to the version of the Agreement under which it was
+received. In addition, after a new version of the Agreement is
+published, Contributor may elect to distribute the Program (including
+its Contributions) under the new version. Except as expressly stated in
+Sections 2(a) and 2(b) above, Recipient receives no rights or licenses
+to the intellectual property of any Contributor under this Agreement,
+whether expressly, by implication, estoppel or otherwise. All rights in
+the Program not expressly granted under this Agreement are reserved.</simpara>
+<simpara>This Agreement is governed by the laws of the State of New York and the
+intellectual property laws of the United States of America. No party to
+this Agreement will bring a legal action under this Agreement more than
+one year after the cause of action arose. Each party waives its rights
+to a jury trial in any resulting litigation.</simpara>
+</appendix>
+<appendix xml:id="sec:Acronyms">
+<title>Acronyms</title>
+<informaltable xml:id="AC" role="language-bash" frame="all" rowsep="1" colsep="1">
+<tgroup cols="4">
+<colspec colname="col_1" colwidth="12.5*"/>
+<colspec colname="col_2" colwidth="37.5*"/>
+<colspec colname="col_3" colwidth="12.5*"/>
+<colspec colname="col_4" colwidth="37.5*"/>
+<tbody>
+<row>
+<entry align="center" valign="top"><simpara><literal>CDep</literal></simpara></entry>
+<entry align="center" valign="top"><simpara><emphasis role="strong">Compile-Time Dependency</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><literal>RDep</literal></simpara></entry>
+<entry align="center" valign="top"><simpara><emphasis role="strong">Run-Time Dependency</emphasis></simpara></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><literal>LDep</literal></simpara></entry>
+<entry align="center" valign="top"><simpara><emphasis role="strong">Load-Time Dependency</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><literal>IDep</literal></simpara></entry>
+<entry align="center" valign="top"><simpara><emphasis role="strong">Initialization-Time Dependency</emphasis></simpara></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><literal>EDep</literal></simpara></entry>
+<entry align="center" valign="top"><simpara><emphasis role="strong">Execution-Time Dependency</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><literal>AC</literal></simpara></entry>
+<entry align="center" valign="top"><simpara><emphasis role="strong">Acceptance Criteria</emphasis></simpara></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><literal>ANTLR</literal></simpara></entry>
+<entry align="center" valign="top"><simpara><emphasis role="strong">ANother Tool for Language Recognition</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><literal>API</literal></simpara></entry>
+<entry align="center" valign="top"><simpara><emphasis role="strong">Application Programming Interface</emphasis></simpara></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><literal>AST</literal></simpara></entry>
+<entry align="center" valign="top"><simpara><emphasis role="strong">Abstract Syntax Tree</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><literal>ASI</literal></simpara></entry>
+<entry align="center" valign="top"><simpara><emphasis role="strong">Automatic Semicolon Insertion</emphasis></simpara></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><literal>AST</literal></simpara></entry>
+<entry align="center" valign="top"><simpara><emphasis role="strong">Abstract Syntax Tree</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><literal>BNF</literal></simpara></entry>
+<entry align="center" valign="top"><simpara><emphasis role="strong">Backus-Naur Form</emphasis></simpara></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><literal>CA</literal></simpara></entry>
+<entry align="center" valign="top"><simpara><emphasis role="strong">Content-Assist</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><literal>CSP</literal></simpara></entry>
+<entry align="center" valign="top"><simpara><emphasis role="strong">Constraint Satisfaction Problem</emphasis></simpara></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><literal>CLI</literal></simpara></entry>
+<entry align="center" valign="top"><simpara><emphasis role="strong">Command Line Interface</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><literal>DOM</literal></simpara></entry>
+<entry align="center" valign="top"><simpara><emphasis role="strong">Document Object Model</emphasis></simpara></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><literal>DSL</literal></simpara></entry>
+<entry align="center" valign="top"><simpara><emphasis role="strong">Domain Specific Language</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><literal>EBNF</literal></simpara></entry>
+<entry align="center" valign="top"><simpara><emphasis role="strong">Extended Backus-Naur Form</emphasis></simpara></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><literal>EMF</literal></simpara></entry>
+<entry align="center" valign="top"><simpara><emphasis role="strong">Eclipse Modeling Framework</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><literal>EPL</literal></simpara></entry>
+<entry align="center" valign="top"><simpara><emphasis role="strong">Eclipse Public License</emphasis></simpara></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><literal>FQN</literal></simpara></entry>
+<entry align="center" valign="top"><simpara><emphasis role="strong">Fully Qualified Name</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><literal>GLB</literal></simpara></entry>
+<entry align="center" valign="top"><simpara><emphasis role="strong">Greatest Lower Bound, also known as <emphasis role="strong">infimum</emphasis></emphasis></simpara></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><literal>GPL</literal></simpara></entry>
+<entry align="center" valign="top"><simpara><emphasis role="strong">GNU General Public License</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><literal>IDE</literal></simpara></entry>
+<entry align="center" valign="top"><simpara><emphasis role="strong">Integrated Development Environment</emphasis></simpara></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><literal>IDL</literal></simpara></entry>
+<entry align="center" valign="top"><simpara><emphasis role="strong">Interface Definition Language</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><literal>LSP</literal></simpara></entry>
+<entry align="center" valign="top"><simpara><emphasis role="strong">Liskov Substitution Principle</emphasis></simpara></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><literal>LUB</literal></simpara></entry>
+<entry align="center" valign="top"><simpara><emphasis role="strong">Least Upper Bound, also known as <emphasis role="strong">supremum</emphasis></emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><literal>N4JS</literal></simpara></entry>
+<entry align="center" valign="top"><simpara><emphasis role="strong">NumberFour JavaScript</emphasis></simpara></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><literal>UI</literal></simpara></entry>
+<entry align="center" valign="top"><simpara><emphasis role="strong">User Interface</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><literal>UML</literal></simpara></entry>
+<entry align="center" valign="top"><simpara><emphasis role="strong">Unified Modeling Language</emphasis></simpara></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><literal>VM</literal></simpara></entry>
+<entry align="center" valign="top"><simpara><emphasis role="strong">Virtual Machine</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><literal>XML</literal></simpara></entry>
+<entry align="center" valign="top"><simpara><emphasis role="strong">Extensible Markup Language</emphasis></simpara></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><literal>XSLT</literal></simpara></entry>
+<entry align="center" valign="top"><simpara><emphasis role="strong"><link linkend="XSL">XSL</link> Transformations</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><literal>XSL <anchor xml:id="XSL" xreflabel="[XSL]"/></literal></simpara></entry>
+<entry align="center" valign="top"><simpara><emphasis role="strong">Extensible Stylesheet Language</emphasis></simpara></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><literal>WYSIWYG</literal></simpara></entry>
+<entry align="center" valign="top"><simpara><emphasis role="strong">What You See Is What You Get</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><literal>WLOG</literal></simpara></entry>
+<entry align="center" valign="top"><simpara><emphasis role="strong">without loss of generality</emphasis></simpara></entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+</appendix>
+<appendix xml:id="_bibliography-and-footnotes">
+<title>Bibliography and Footnotes</title>
+<simpara><anchor xml:id="N4JSSpec" xreflabel="[N4JSSpec]"/>N4JS Project. (2018). <emphasis>N4JS Language Specification</emphasis>. Retrieved from <link xl:href="https://www.eclipse.org/n4js/spec/N4JSSpec.html">https://www.eclipse.org/n4js/spec/N4JSSpec.html</link></simpara>
+<simpara><anchor xml:id="Xpect" xreflabel="[Xpect]"/><emphasis>Xpect, Project Website</emphasis>. Retrieved from <link xl:href="https://projects.eclipse.org/projects/modeling.xpect">https://projects.eclipse.org/projects/modeling.xpect</link></simpara>
+<simpara><anchor xml:id="RFC8259" xreflabel="[RFC8259]"/>Bray, Tim. (2017). <emphasis>RFC 8259: The javascript object notation (json) data interchange format</emphasis>. </simpara>
+<simpara><anchor xml:id="ECMA404" xreflabel="[ECMA404]"/>International, ECMA. (2017). <emphasis>Standard ECMA-404, The JSON Data Interchange Syntax</emphasis>. </simpara>
+<simpara><anchor xml:id="RFC7158" xreflabel="[RFC7158]"/>Bray, Tim. (2014). <emphasis>RFC 7158: The JavaScript Object Notation ({JSON}) Data Interchange Format</emphasis>. </simpara>
+<simpara><anchor xml:id="Ser18" xreflabel="[Ser18]"/>Seriot, Nicolas. (2018). <emphasis>Parsing JSON is a Minefield</emphasis>. Retrieved from <link xl:href="http://seriot.ch/parsing_json.php">http://seriot.ch/parsing_json.php</link></simpara>
+<simpara><anchor xml:id="ECMA15a" xreflabel="[ECMA15a]"/>ECMA. (2015). <emphasis>ECMAScript 2015 Language Specification</emphasis>. Retrieved from <link xl:href="http://www.ecma-international.org/publications/files/ECMA-ST/Ecma-262.pdf">http://www.ecma-international.org/publications/files/ECMA-ST/Ecma-262.pdf</link></simpara>
+<simpara><anchor xml:id="WhatWGLoader" xreflabel="[WhatWGLoader]"/>WhatWG. <emphasis>Loader: A Collection of Interesting Ideas</emphasis>. Retrieved from <link xl:href="http://whatwg.github.io/loader/">http://whatwg.github.io/loader/</link></simpara>
+</appendix>
+</book>
\ No newline at end of file
diff --git a/design/appendix_a_hints.html b/design/appendix_a_hints.html
new file mode 100644
index 0000000..fdcf51d
--- /dev/null
+++ b/design/appendix_a_hints.html
@@ -0,0 +1,1354 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="generator" content="Asciidoctor 1.5.5">
+<meta name="author" content="2019-08-07 15:02:40 CEST">
+<title>N4JS Design Specification</title>
+<link rel="stylesheet" href="styles/spec.min.css">
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.6.3/css/font-awesome.min.css">
+<!-- ************* docinfo ******************************************************************* -->
+
+
+<!-- ************* Favicon ************-->
+<link rel="icon" href="images/favicon.ico" />
+
+<!-- ************* Back-to-top JQuery ************* -->
+<script src="https://code.jquery.com/jquery-1.12.4.js"></script>
+<script src="https://code.jquery.com/ui/1.12.0/jquery-ui.js"></script>
+
+
+<link href="styles/prism.min.css" rel="stylesheet" />
+<script type="text/javascript" async
+  src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2/MathJax.js?config=TeX-MML-AM_CHTML">
+</script>
+
+<!-- ************* Styles ************* -->
+<link rel="stylesheet" type="text/css" href="styles/n4jsspec-adoc.css">
+
+
+<!-- ****************** NavBar ****************** -->
+<div id="menubar">
+	<div class="banner">
+        <a href="https://www.eclipse.org/n4js/#"><img id="logo" src="images/n4js-logo.png" alt="Eclipse N4JS"></a>
+    </div>
+<ul>
+  <li><a href="index.html">Index</a></li>
+</ul>
+</div>
+<!-- ************* docinfo ******************************************************************* -->
+<style>
+      .admonitionblock td.icon .icon-todo:before{content:"\f249";color:#f4ee42}
+    </style>
+</head>
+<body class="book toc2 toc-left">
+<div id="header">
+<h1>N4JS Design Specification</h1>
+<div class="details">
+<span id="author" class="author">2019-08-07 15:02:40 CEST</span><br>
+<span id="revnumber">version 0.9</span>
+</div>
+<div id="toc" class="toc2">
+<div id="toctitle">Table of Contents</div>
+<ul class="sectlevel1">
+<li><a href="introduction.html#_introduction">1. Introduction</a>
+<ul class="sectlevel2">
+<li><a href="introduction.html#notation">1.1. Notation</a></li>
+<li><a href="introduction.html#sec:IDE_Overview">1.2. IDE Components</a>
+<ul class="sectlevel3">
+<li><a href="introduction.html#sec:Naming_Conventions">1.2.1. Naming Conventions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="eclipse_setup.html#_eclipse-setup">2. Eclipse Setup</a>
+<ul class="sectlevel2">
+<li><a href="eclipse_setup.html#_system-requirements">2.1. System Requirements</a></li>
+<li><a href="eclipse_setup.html#_contribute">2.2. Contribute</a>
+<ul class="sectlevel3">
+<li><a href="eclipse_setup.html#_eclipse-installer">2.2.1. Eclipse Installer</a>
+<ul class="sectlevel4">
+<li><a href="eclipse_setup.html#_changing-the-setup-script">2.2.1.1. Changing the Setup Script</a></li>
+</ul>
+</li>
+<li><a href="eclipse_setup.html#_manual-ide-configuration">2.2.2. Manual IDE Configuration</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="release_engineering.html#_release-engineering">3. Release Engineering</a>
+<ul class="sectlevel2">
+<li><a href="release_engineering.html#_nightly-build-on-eclipse-infrastructure">3.1. Nightly build on Eclipse infrastructure</a></li>
+<li><a href="release_engineering.html#_build-the-n4js-ide-from-command-line">3.2. Build the N4JS IDE from command line</a>
+<ul class="sectlevel3">
+<li><a href="release_engineering.html#_publish-maven-tooling-code-org-eclipse-n4js-releng-util-code">3.2.1. Publish maven-tooling <code>org.eclipse.n4js.releng.util</code></a></li>
+<li><a href="release_engineering.html#sec:test-verdaccio">3.2.2. Test Verdaccio containing n4js-libs</a></li>
+<li><a href="release_engineering.html#_generation-of-eclipse-help-for-spec-and-design-document">3.2.3. Generation of Eclipse help for spec and design document</a></li>
+</ul>
+</li>
+<li><a href="release_engineering.html#_updating-frameworks-and-dependencies">3.3. Updating frameworks and dependencies</a>
+<ul class="sectlevel3">
+<li><a href="release_engineering.html#_update-of-eclipse-emf-xtext-etc">3.3.1. Update of Eclipse, EMF, Xtext, etc.</a></li>
+<li><a href="release_engineering.html#_update-of-the-embedded-jre">3.3.2. Update of the embedded JRE</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tips_and_tricks.html#_tips-and-tricks">4. Tips and Tricks</a>
+<ul class="sectlevel2">
+<li><a href="tips_and_tricks.html#_naming">4.1. Naming</a></li>
+<li><a href="tips_and_tricks.html#_logging">4.2. Logging</a></li>
+<li><a href="tips_and_tricks.html#_cancellation-handling">4.3. Cancellation Handling</a></li>
+<li><a href="tips_and_tricks.html#_caching">4.4. Caching</a></li>
+<li><a href="tips_and_tricks.html#_dependency-injection">4.5. Dependency Injection</a></li>
+<li><a href="tips_and_tricks.html#_miscellaneous">4.6. Miscellaneous</a></li>
+</ul>
+</li>
+<li><a href="parser.html#_parser">5. Parser</a>
+<ul class="sectlevel2">
+<li><a href="parser.html#sec:Parser_Overview">5.1. Overview</a></li>
+<li><a href="parser.html#sec:N4JS_Parser">5.2. N4JS Parser</a></li>
+<li><a href="parser.html#sec:Parser_Generation_Post_Processing">5.3. Parser Generation Post-Processing</a>
+<ul class="sectlevel3">
+<li><a href="parser.html#sec:Automatic_Semicolon_Insertion">5.3.1. Automatic Semicolon Insertion</a>
+<ul class="sectlevel4">
+<li><a href="parser.html#sec:Injected_code_in_the_Antlr_grammar_file">5.3.1.1. Injected code in the Antlr grammar file</a></li>
+<li><a href="parser.html#sec:Customized_error_recovery">5.3.1.2. Customized error recovery</a></li>
+</ul>
+</li>
+<li><a href="parser.html#sec:_No_line_terminator_allowed_here__handling">5.3.2. Async and <code>No line terminator allowed here</code> Handling</a></li>
+<li><a href="parser.html#sec:Regular_Expression">5.3.3. Regular Expression</a></li>
+<li><a href="parser.html#sec:Unicode">5.3.4. Unicode</a></li>
+<li><a href="parser.html#sec:Literals">5.3.5. Literals</a></li>
+</ul>
+</li>
+<li><a href="parser.html#sec:Modifiers">5.4. Modifiers</a></li>
+<li><a href="parser.html#sec:Conflict_Resolutions">5.5. Conflict Resolutions</a>
+<ul class="sectlevel3">
+<li><a href="parser.html#sec:Reserved_Keywords_vs__Identifier_Names">5.5.1. Reserved Keywords vs. Identifier Names</a></li>
+<li><a href="parser.html#sec:Operators_and_Generics">5.5.2. Operators and Generics</a></li>
+</ul>
+</li>
+<li><a href="parser.html#sec:Content_Assist_Parser">5.6. Content-Assist Parser</a></li>
+</ul>
+</li>
+<li><a href="type_system.html#_type-system">6. Type System</a>
+<ul class="sectlevel2">
+<li><a href="type_system.html#sec:Type_Model_and_Grammar">6.1. Type Model and Grammar</a>
+<ul class="sectlevel3">
+<li><a href="type_system.html#sec:Type_Model_Overview">6.1.1. Type Model Overview</a></li>
+<li><a href="type_system.html#sec:Built_in_Types">6.1.2. Built-in and Primitive Types</a></li>
+<li><a href="type_system.html#sec:Type_Model_DSL">6.1.3. Type Model DSL</a></li>
+</ul>
+</li>
+<li><a href="type_system.html#sec:Type_System_Implementation">6.2. Type System Implementation</a></li>
+<li><a href="type_system.html#sec:Type_Inference_combined_with_AST_Traversal">6.3. Type Inference of AST</a>
+<ul class="sectlevel3">
+<li><a href="type_system.html#sec:Type_Inference_combined_with_AST_Traversal__Background">6.3.1. Background</a></li>
+<li><a href="type_system.html#sec:Triggering_Type_Inference_of_AST">6.3.2. Triggering</a></li>
+<li><a href="type_system.html#sec:Traversal_Order_During_Type_Inference_of_AST">6.3.3. Traversal Order</a></li>
+<li><a href="type_system.html#sec:Cross_References_During_Type_Inference_of_AST">6.3.4. Cross-References</a></li>
+<li><a href="type_system.html#sec:Function_Accessor_Bodies_During_Type_Inference_of_AST">6.3.5. Function/Accessor Bodies</a></li>
+<li><a href="type_system.html#sec:Poly_Expressions_During_Type_Inference_of_AST">6.3.6. Poly Expressions</a></li>
+<li><a href="type_system.html#sec:Constraint_Solver_used_During_Type_Inference_of_AST">6.3.7. Constraint Solver</a></li>
+<li><a href="type_system.html#sec:Type_Guards_During_Type_Inference_of_AST">6.3.8. Type Guards</a></li>
+</ul>
+</li>
+<li><a href="type_system.html#sec:Structural_Typing">6.4. Structural Typing</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#_type-index">7. Type Index</a>
+<ul class="sectlevel2">
+<li><a href="type_index.html#sec:Type_Index_Design_Rationale">7.1. Design Rationale</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#sec:Getting_the_Xtext_Index_Content_IResourceDescriptions">7.1.1. Getting the Xtext Index (<code>IResourceDescriptions</code>) Content</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#sec:Design_Overview">7.2. Design Overview</a></li>
+<li><a href="type_index.html#sec:N4JS_Resource_Load_States">7.3. N4JS Resource Load States</a></li>
+<li><a href="type_index.html#sec:Type_Builder">7.4. Types Builder</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#sec:Type_Inference_not_allowed_in_Type_Builder">7.4.1. Type Inference not allowed in Types Builder</a></li>
+<li><a href="type_index.html#sec:ComputedTypeReferences">7.4.2. Deferred Type References</a></li>
+<li><a href="type_index.html#sec:Use_cases_of_ComputedTypeRef">7.4.3. Use cases of DeferredTypeRef</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#sec:Incremental_Builder_Overview">7.5. Incremental Builder (Overview)</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#sec:Incremental_Builder_Overview__XtextBuilder">7.5.1. XtextBuilder</a></li>
+<li><a href="type_index.html#sec:Incremental_Builder_Overview__IBuilderState">7.5.2. IBuilderState</a>
+<ul class="sectlevel4">
+<li><a href="type_index.html#copy-and-update-xtext-index">7.5.2.1. Copy and Update Xtext Index</a></li>
+<li><a href="type_index.html#build-state-setup-phase">7.5.2.2. Build State Setup Phase</a></li>
+<li><a href="type_index.html#process-queued-uris">7.5.2.3. Process Queued URIs</a></li>
+<li><a href="type_index.html#queueing-affected-resources">7.5.2.4. Queueing Affected Resources</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#sec:Incremental_Builder_Overview__Example">7.5.3. Example</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#dirty-state-handling">7.6. Dirty state handling</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#use-case-restoring-types-from-user-data">7.6.1. Use case: Restoring types from user data</a></li>
+<li><a href="type_index.html#use-case-updating-the-xtext-index">7.6.2. Use case: Updating the Xtext index</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="project_model.html#_project-model">8. Project Model</a>
+<ul class="sectlevel2">
+<li><a href="project_model.html#sec:Package_json">8.1. Package.json File</a></li>
+<li><a href="project_model.html#_accessing-project-information">8.2. Accessing Project Information</a>
+<ul class="sectlevel3">
+<li><a href="project_model.html#sec:IN4JSCore">8.2.1. IN4JSCore</a></li>
+<li><a href="project_model.html#sec:N4JSModel">8.2.2. N4JSModel</a></li>
+<li><a href="project_model.html#sec:N4JSWorkspace">8.2.3. N4JSWorkspace</a></li>
+<li><a href="project_model.html#sec:N4JSProject">8.2.4. N4JSProject</a></li>
+<li><a href="project_model.html#sec:SourceContainer">8.2.5. SourceContainer</a></li>
+<li><a href="project_model.html#sec:N4JSProjectsStateHelper">8.2.6. N4JSProjectsStateHelper</a></li>
+</ul>
+</li>
+<li><a href="project_model.html#sec:Caching">8.3. Caching</a>
+<ul class="sectlevel3">
+<li><a href="project_model.html#_caching-of-externallibraryworkspace">8.3.1. Caching of ExternalLibraryWorkspace</a></li>
+<li><a href="project_model.html#_caching-of-n4jsprojectsstatehelper">8.3.2. Caching of N4JSProjectsStateHelper</a></li>
+</ul>
+</li>
+<li><a href="project_model.html#sec:WildcardPathFilter">8.4. WildcardPathFilter</a></li>
+<li><a href="project_model.html#sec:ProjectUtils">8.5. ProjectUtils</a></li>
+</ul>
+</li>
+<li><a href="binding.html#_binding">9. Binding</a>
+<ul class="sectlevel2">
+<li><a href="binding.html#sec:Binding_Design_Rationale">9.1. Design Rationale</a></li>
+<li><a href="binding.html#sec:Binding_to_Members">9.2. Binding to Members</a></li>
+<li><a href="binding.html#sec:Binding_Getter_Setter">9.3. Getter / Setter Binding</a></li>
+<li><a href="binding.html#chap:Statics">9.4. Static Member Binding</a></li>
+<li><a href="binding.html#sec:Binding_Enumeration">9.5. Enumeration Literals Binding</a></li>
+<li><a href="binding.html#sec:Accessibility_of_types_and_members">9.6. Accessibility of types and members</a></li>
+<li><a href="binding.html#sec:Member_Scope_Example">9.7. Member Scope Example</a></li>
+<li><a href="binding.html#sec:Scoping_for_Members_of_Composed_Type_Explained">9.8. Scoping for Members of Composed Type (Union/Intersection) Example</a></li>
+<li><a href="binding.html#sec:Binding_of_Structurally_References_Types">9.9. Structurally References Types</a></li>
+<li><a href="binding.html#sec:Building">9.10. Building</a>
+<ul class="sectlevel3">
+<li><a href="binding.html#sec:Build_Phases">9.10.1. Build Phases</a></li>
+<li><a href="binding.html#sec:Build_Scenarios">9.10.2. Build Scenarios</a></li>
+<li><a href="binding.html#sec:Lazy_linking_problem">9.10.3. Lazy linking problem</a></li>
+</ul>
+</li>
+<li><a href="binding.html#sec:Proxies_and_Proxy_Resolution">9.11. Proxies and Proxy Resolution (Overview)</a>
+<ul class="sectlevel3">
+<li><a href="binding.html#xtexts-lazy-linking-proxies">9.11.1. Xtext’s Lazy Linking Proxies</a></li>
+<li><a href="binding.html#standard-emf-proxies">9.11.2. Standard EMF Proxies</a></li>
+<li><a href="binding.html#_how-is-proxy-resolution-triggered">9.11.3. How is Proxy Resolution Triggered?</a></li>
+<li><a href="binding.html#_when-is-proxy-resolution-allowed">9.11.4. When is Proxy Resolution Allowed?</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="validation.html#_validation">10. Validation</a>
+<ul class="sectlevel2">
+<li><a href="validation.html#sec:validation_overview">10.1. Validation overview</a></li>
+<li><a href="validation.html#sec:validation_control_flow">10.2. Validation control flow</a></li>
+<li><a href="validation.html#sec:validation_issue_ids">10.3. Issue IDs and Messages</a></li>
+<li><a href="validation.html#sec:validation_usage_patterns">10.4. Usage Pattern</a></li>
+<li><a href="validation.html#sec:validation_links">10.5. Links</a></li>
+</ul>
+</li>
+<li><a href="references.html#_references">11. References</a>
+<ul class="sectlevel2">
+<li><a href="references.html#sec:usecases">11.1. Use cases</a></li>
+<li><a href="references.html#sec:calculation_algorithm">11.2. Calculation algorithm</a>
+<ul class="sectlevel3">
+<li><a href="references.html#sec:Xtext_default_implementation">11.2.1. Xtext default implementation</a></li>
+<li><a href="references.html#sec:N4_implementation">11.2.2. N4JS implementation</a></li>
+</ul>
+</li>
+<li><a href="references.html#sec:PerformanceOfDependencyCalculation">11.3. Performance Of Dependency Calculation</a></li>
+<li><a href="references.html#sec:kinds_of_references">11.4. Kinds of references</a>
+<ul class="sectlevel3">
+<li><a href="references.html#sec:Cross_References_to_be_ignored">11.4.1. Cross References to be ignored</a></li>
+<li><a href="references.html#sec:Cross_References_to_be_handled">11.4.2. Cross References to be handled</a></li>
+</ul>
+</li>
+<li><a href="references.html#sec:transitive_dependencies">11.5. Transitive dependencies</a></li>
+<li><a href="references.html#sec:find-references">11.6. Find references</a>
+<ul class="sectlevel3">
+<li><a href="references.html#_background">11.6.1. Background</a></li>
+<li><a href="references.html#_how-find-references-work">11.6.2. How Find References Work</a>
+<ul class="sectlevel4">
+<li><a href="references.html#_step-1-convert-cursor-position-to-declared-element">11.6.2.1. Step 1: Convert Cursor Position to Declared Element</a></li>
+<li><a href="references.html#_step-2-convert-declared-element-to-target-uris">11.6.2.2. Step 2: Convert Declared Element to Target URIs</a></li>
+<li><a href="references.html#_step-3-filter-potential-resources">11.6.2.3. Step 3: Filter Potential Resources</a></li>
+<li><a href="references.html#_step-4-search-references-in-resource">11.6.2.4. Step 4: Search References in Resource</a></li>
+<li><a href="references.html#_limitations-and-possible-enhancements">11.6.2.5. Limitations and Possible Enhancements</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="compilation.html#_compilation">12. Compilation</a>
+<ul class="sectlevel2">
+<li><a href="compilation.html#chap:compilation">12.1. Introduction</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:general_design_rationals">12.1.1. General design rationals</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:logging_and_error_reporting">12.1.1.1. Logging and error reporting</a></li>
+<li><a href="compilation.html#sec:progress_monitor">12.1.1.2. Progress monitor</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Xtext_Integration">12.1.2. Xtext Integration</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:xtext_default_behaviour">12.1.2.1. Xtext default behaviour</a></li>
+<li><a href="compilation.html#sec:n4js_requirements">12.1.2.2. N4JS requirements</a></li>
+<li><a href="compilation.html#sec:compiler_discovery_in_ui">12.1.2.3. Compiler discovery in UI</a></li>
+<li><a href="compilation.html#sec:compiler_discovery_in_headless">12.1.2.4. Compiler discovery in headless</a></li>
+<li><a href="compilation.html#sec:general_generator_implementation">12.1.2.5. General generator implementation</a></li>
+<li><a href="compilation.html#sec:general_generator_activation">12.1.2.6. General generator activation</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Overview_of_Input_Models">12.1.3. Overview of the Input Models</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Core_Generator">12.2. Generators</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:Compiler_Components">12.2.1. Generator Components</a></li>
+<li><a href="compilation.html#sec:Generator_architecture">12.2.2. Generator architecture</a></li>
+<li><a href="compilation.html#sec:Unified_Compiler_Configuration">12.2.3. Unified Compiler Configuration</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Transpilers">12.3. Transpilers</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:Phases">12.3.1. Overview</a></li>
+<li><a href="compilation.html#relation-between-ast-and-im">12.3.2. Relation between AST and IM</a></li>
+<li><a href="compilation.html#implementation-overview">12.3.3. Implementation Overview</a></li>
+<li><a href="compilation.html#sec:Guidelines_for_Implementing_Transformations">12.3.4. Guidelines for Implementing Transformations</a></li>
+<li><a href="compilation.html#symbol-table-in-the-im">12.3.5. Symbol Table in the IM</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:N4JS_to_EcmaScript_Transpiler">12.4. N4JS-to-EcmaScript Transpiler</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:Overview_of_Transformations">12.4.1. Overview of Transformations</a></li>
+<li><a href="compilation.html#sec:Transpiling_members">12.4.2. Transpiling members</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:Transpiling_members__Delegating_members">12.4.2.1. Techniques for special member handling</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__Partial_shadowing_of_getter_setter_pairs">12.4.2.2. Partial shadowing</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__Consuming_or_inheriting_members_of_an_interface">12.4.2.3. Consuming or inheriting members of an interface</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__Static_polyfill">12.4.2.4. Static polyfill</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__API_implementation_stubs">12.4.2.5. API / implementation stubs</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Support_for_incomplete_API_implementation_testing_in_the_N4JS_to_EcmaScript_5_Transpiler">12.4.3. Support for incomplete API implementation testing</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:Modifications_in_Impl_projects">12.4.3.1. Modifications in Impl projects</a></li>
+<li><a href="compilation.html#sec:Implementation_of_stub_generation">12.4.3.2. Implementation of stub-generation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:n4jsc_Headless_Compiler_Interface">12.5. n4jsc Headless Compiler Interface</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:building_the_headless_compiler">12.5.1. building the headless compiler</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="execution.html#_execution">13. Execution</a>
+<ul class="sectlevel2">
+<li><a href="execution.html#sec:N4JS_Project_Execution_And_Linking_Model">13.1. N4JS Project Execution And Linking Model</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#subsec:N4JS_Execution_With_NodeJS">13.1.1. N4JS Execution With NodeJS</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:N4JS_Execution_And_Linking_File">13.2. N4JS Execution And Linking File</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#subsec:NodeJS_Specific_ELF">13.2.1. NodeJS Specific ELF</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Runners-execution">13.3. Runners</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#subsec:N4_Runtime_Environments_Convention">13.3.1. N4 Runtime Environments Convention</a></li>
+<li><a href="execution.html#subsec:Passing_Information_from_IDE_to_Execution_Code_in_Runtime_Environment">13.3.2. Passing Information from IDE to Execution Code in Runtime Environment</a></li>
+<li><a href="execution.html#subsec:Runners_Design">13.3.3. Runners Design</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Legacy_Execution_Engine">13.4. Legacy Execution Engine</a></li>
+<li><a href="execution.html#sec:Design">13.5. Design</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#sec:Usage_Outside_N4JSIDE">13.5.1. Usage Outside N4JSIDE</a>
+<ul class="sectlevel4">
+<li><a href="execution.html#sec:Use_Node_with_Maven">13.5.1.1. Use Node with Maven</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Usage_Inside_N4JSIDE">13.5.2. Usage Inside N4JSIDE</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Runtime_Injection">13.6. Runtime Injection</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#sec:Running_String_Code">13.6.1. Running String Code</a></li>
+<li><a href="execution.html#sec:Running_File_Code">13.6.2. Running File Code</a></li>
+<li><a href="execution.html#sec:Injection_Code_Example">13.6.3. Injection Code Example</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#_tests">14. Tests</a>
+<ul class="sectlevel2">
+<li><a href="tests.html#sec:Performance_Tests">14.1. Performance Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Synthetic_Performance_Tests">14.1.1. Synthetic Performance Tests</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:Design_of_Generator">14.1.1.1. Design of Generator</a></li>
+<li><a href="tests.html#sec:Design_of_Performance_Test_Execution">14.1.1.2. Design of Performance Test Configuration and Execution</a></li>
+<li><a href="tests.html#sec:JUnit_Configuration">14.1.1.3. JUnit Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Test_Configuration">14.1.1.4. JUnitBenchmark Test Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Report_Configuration">14.1.1.5. JUnitBenchmark Report Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Run_Configuration">14.1.1.6. JUnitBenchmark Run Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Example">14.1.1.7. JUnitBenchmark Example</a></li>
+<li><a href="tests.html#sec:Note_on_Jenkins_Job">14.1.1.8. Note on Jenkins Job</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#sec:ECMA_Tests">14.2. ECMA Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Grammar_Tests">14.2.1. Grammar Tests</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:Negative_Tests">14.2.1.1. Negative Tests</a></li>
+<li><a href="tests.html#sec:Test_Exclusion">14.2.1.2. Test Exclusion</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Integration_Tests">14.3. Integration Tests</a></li>
+<li><a href="tests.html#sec:Test_Helpers">14.4. Test Helpers</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Parameterized_N4JS_Tests">14.4.1. Parameterized N4JS tests</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:ParameterizedXtextRunner">14.4.1.1. ParameterizedXtextRunner</a></li>
+<li><a href="tests.html#sec:TestCodeProvider">14.4.1.2. TestCodeProvider</a></li>
+<li><a href="tests.html#sec:Example_Of_Parameterized_Parser_Test">14.4.1.3. Example of parameterized parser test</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Issue_Suppression">14.5. Issue Suppression</a></li>
+<li><a href="tests.html#sec:Xpect_Tests">14.6. Xpect Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Xpect_Test_Setup">14.6.1. Xpect Test Setup</a></li>
+<li><a href="tests.html#sec:Xpect_Issue_Suppression">14.6.2. Xpect Issue Suppression</a></li>
+<li><a href="tests.html#sec:Xpect_Provided_Test_Methods">14.6.3. Xpect Provided Test Methods</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#errors">14.6.3.1. errors</a></li>
+<li><a href="tests.html#warnings">14.6.3.2. warnings</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:N4JS_Specific_Xpect_Test_Methods">14.6.4. N4JS Specific Xpect Test Methods</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:XPECT_noerrors">14.6.4.1. noerrors and nowarnings</a></li>
+<li><a href="tests.html#sec:XPECT_scope">14.6.4.2. scope</a></li>
+<li><a href="tests.html#sec:XPECT_scopeWithPosition">14.6.4.3. scopeWithPosition</a></li>
+<li><a href="tests.html#sec:XPECT_scopeWithResource">14.6.4.4. scopeWithResource</a></li>
+<li><a href="tests.html#sec:XPECT_binding">14.6.4.5. binding</a></li>
+<li><a href="tests.html#sec:XPECT_linkedPathname">14.6.4.6. linkedPathname</a></li>
+<li><a href="tests.html#sec:XPECT_type_of">14.6.4.7. type of</a></li>
+<li><a href="tests.html#sec:XPECT_expectedType">14.6.4.8. expectedType</a></li>
+<li><a href="tests.html#sec:XPECT_elementKeyword">14.6.4.9. elementKeyword</a></li>
+<li><a href="tests.html#sec:XPECT_accessModifier">14.6.4.10. accessModifier</a></li>
+<li><a href="tests.html#sec:XPECT_compileResult">14.6.4.11. compileResult</a></li>
+<li><a href="tests.html#sec:XPECT_output">14.6.4.12. output</a></li>
+<li><a href="tests.html#sec:XPECT_outputRegEx">14.6.4.13. outputRegEx</a></li>
+<li><a href="tests.html#sec:XPECT_calculatedAccessModifier">14.6.4.14. calculatedAccessModifier</a></li>
+<li><a href="tests.html#sec:XPECT_spec">14.6.4.15. spec</a></li>
+<li><a href="tests.html#sec:XPECT_deadCode">14.6.4.16. deadCode</a></li>
+<li><a href="tests.html#sec:XPECT_returnOrThrows">14.6.4.17. returnOrThrows</a></li>
+<li><a href="tests.html#sec:XPECT_lint">14.6.4.18. lint</a></li>
+<li><a href="tests.html#sec:XPECT_lintFails">14.6.4.19. lintFails</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:FIXME_Xpect_modifier">14.6.5. FIXME Xpect modifier</a></li>
+<li><a href="tests.html#sec:Expectmatrix_Xpect_Test_Methods">14.6.6. Expectmatrix Xpect tests</a></li>
+<li><a href="tests.html#xpect-lint-tests">14.6.7. Xpect Lint Tests</a></li>
+</ul>
+</li>
+<li><a href="tests.html#xpect-proposal-tests">14.7. Xpect Proposal Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Validation_vs__Non_Validation">14.7.1. Validation vs. Non-Validation</a></li>
+<li><a href="tests.html#sec:General_Proposal_Test_Features">14.7.2. General Proposal Test Features</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:Test_Variables">14.7.2.1. Test Variables</a></li>
+<li><a href="tests.html#sec:Location_and_Selection">14.7.2.2. at – Location and Selection</a></li>
+<li><a href="tests.html#sec:Multi_Line_Expectations_in_Proposal_Tests">14.7.2.3. Multi Line Expectations in Proposal Tests</a></li>
+<li><a href="tests.html#sec:Timeout">14.7.2.4. Timeout and Performance</a></li>
+</ul>
+</li>
+<li><a href="tests.html#proposals-verify-existence-of-proposals">14.7.3. proposals – Verify Existence of Proposals</a></li>
+<li><a href="tests.html#sec:Verify_displayed_string">14.7.4. display – Verify displayed string</a></li>
+<li><a href="tests.html#sec:Apply_Proposal">14.7.5. apply – Apply Proposal</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#resource-application-in-other-files">14.7.5.1. resource – application in other files</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Content_Assist_Cycling">14.7.6. kind – Content Assist Cycling</a></li>
+<li><a href="tests.html#fileValidVerify-validation-status">14.7.7. fileValid – Verify validation status</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Apply_Proposal_And_Execute_Tests">14.8. Apply Proposal And Execute Tests</a></li>
+<li><a href="tests.html#sec:Organize_Imports_Test">14.9. Organize Imports Test</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#organizeimports">14.9.1. organizeImports</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Access_Control_Test">14.10. Access Control Test</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#test-scenarios">14.10.1. Test Scenarios</a></li>
+<li><a href="tests.html#n4js-code-generator">14.10.2. N4JS Code Generator</a></li>
+<li><a href="tests.html#xtext-issue-matcher">14.10.3. Xtext Issue Matcher</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Smoke_Tests">14.11. Smoke Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#how-to-handle-smoke-test-errors">14.11.1. How to handle smoke test errors?</a></li>
+<li><a href="tests.html#smoketester-and-exceptionanalyzer">14.11.2. SmokeTester and ExceptionAnalyzer</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:UI_Tests_with_SWTBot">14.12. UI Tests with SWTBot</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#writing-swtbot-tests">14.12.1. Writing SWTBot Tests</a></li>
+<li><a href="tests.html#running-swtbot-tests">14.12.2. Running SWTBot Tests</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Debugging_UI_Tests">14.13. Debugging UI Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Connecting_to_the_X_server_on_the_build_node">14.13.1. Connecting to the X-server on the build-node</a></li>
+<li><a href="tests.html#sec:Tools_to_investigate_the_java_stack">14.13.2. Tools to investigate the java-stack</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="ui_concepts.html#_ui-concepts">15. UI Concepts</a>
+<ul class="sectlevel2">
+<li><a href="ui_concepts.html#sec:User_Interface_Concepts">15.1. User Interface Concepts</a>
+<ul class="sectlevel3">
+<li><a href="ui_concepts.html#sec:Eclipse_UI_Concepts">15.1.1. Eclipse UI Concepts</a>
+<ul class="sectlevel4">
+<li><a href="ui_concepts.html#sec:Label_Provider">15.1.1.1. Label Provider</a></li>
+<li><a href="ui_concepts.html#sec:Markers">15.1.1.2. Markers</a></li>
+<li><a href="ui_concepts.html#sec:Commands__Toolbar_and_Menus">15.1.1.3. Commands, Toolbar and Menus</a></li>
+<li><a href="ui_concepts.html#sec:Content_Assist">15.1.1.4. Content Assist</a></li>
+<li><a href="ui_concepts.html#sec:Quick_Fixes">15.1.1.5. Quick Fixes</a></li>
+<li><a href="ui_concepts.html#sec:Quick_Assist">15.1.1.6. Quick Assist</a></li>
+<li><a href="ui_concepts.html#sec:Clean_Up_Actions">15.1.1.7. Clean Up Actions</a></li>
+<li><a href="ui_concepts.html#sec:Save_Actions">15.1.1.8. Save Actions</a></li>
+<li><a href="ui_concepts.html#sec:Auto_Edit">15.1.1.9. Auto Edit</a></li>
+<li><a href="ui_concepts.html#sec:Template_Proposals">15.1.1.10. Template Proposals</a></li>
+<li><a href="ui_concepts.html#sec:Outline_View___Quick_Outline">15.1.1.11. Outline View / Quick Outline</a></li>
+<li><a href="ui_concepts.html#sec:Navigator__Package_Explorer__Project_Explorer">15.1.1.12. Navigator, Package Explorer, Project Explorer</a></li>
+<li><a href="ui_concepts.html#sec:Hyperlinking_and_Navigation">15.1.1.13. Hyperlinking and Navigation</a></li>
+<li><a href="ui_concepts.html#sec:Syntax_and_Semantic_Coloring">15.1.1.14. Syntax and Semantic Coloring</a></li>
+<li><a href="ui_concepts.html#sec:Code_Formatter">15.1.1.15. Code Formatter</a></li>
+<li><a href="ui_concepts.html#sec:Wizards">15.1.1.16. Wizards</a></li>
+<li><a href="ui_concepts.html#sec:Cheat_Sheets">15.1.1.17. Cheat Sheets</a></li>
+<li><a href="ui_concepts.html#sec:Context_sensitive_Help">15.1.1.18. Context-sensitive Help</a></li>
+<li><a href="ui_concepts.html#sec:Hovers">15.1.1.19. Hovers</a></li>
+<li><a href="ui_concepts.html#sec:Folding">15.1.1.20. Folding</a></li>
+<li><a href="ui_concepts.html#sec:Customizable_validation___severity">15.1.1.21. Customizable validation / severity</a></li>
+<li><a href="ui_concepts.html#sec:Proposals">15.1.1.22. Proposals</a></li>
+</ul>
+</li>
+<li><a href="ui_concepts.html#sec:Non_Eclipse_UI_Concepts">15.1.2. Non-Eclipse UI Concepts</a>
+<ul class="sectlevel4">
+<li><a href="ui_concepts.html#sec:Overlays">15.1.2.1. Overlays</a></li>
+<li><a href="ui_concepts.html#sec:Goto__Inferred__Type">15.1.2.2. Goto (Inferred) Type</a></li>
+<li><a href="ui_concepts.html#sec:Postfix_Completion">15.1.2.3. Postfix Completion</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="ui_concepts.html#_user-interface-resources">15.2. User Interface Resources</a>
+<ul class="sectlevel3">
+<li><a href="ui_concepts.html#_icons">15.2.1. Icons</a>
+<ul class="sectlevel4">
+<li><a href="ui_concepts.html#_eclipse-platform-icons">15.2.1.1. Eclipse Platform Icons</a></li>
+<li><a href="ui_concepts.html#_n4js-specific-icons">15.2.1.2. N4JS Specific Icons</a></li>
+<li><a href="ui_concepts.html#_high-resolution-icons">15.2.1.3. High Resolution Icons</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="formatting.html#_formatting">16. Formatting</a>
+<ul class="sectlevel2">
+<li><a href="formatting.html#sec:FmtObjective">16.1. Objective</a>
+<ul class="sectlevel3">
+<li><a href="formatting.html#sec:FmtFormatting_Comments">16.1.1. Formatting Comments</a></li>
+</ul>
+</li>
+<li><a href="formatting.html#sec:FmtArchitecture">16.2. Architecture</a>
+<ul class="sectlevel3">
+<li><a href="formatting.html#sec:Implementation_example">16.2.1. Implementation example</a></li>
+</ul>
+</li>
+<li><a href="formatting.html#sec:FmtFormatter_Implementation_Guidelines">16.3. Formatter Implementation Guidelines</a></li>
+<li><a href="formatting.html#sec:FmtConfiguration">16.4. Configuration</a></li>
+<li><a href="formatting.html#sec:FmtUI_Integration">16.5. UI Integration</a></li>
+<li><a href="formatting.html#sec:FmtUnit_Testing_with_Xpect">16.6. Unit Testing with Xpect</a></li>
+</ul>
+</li>
+<li><a href="external_libraries.html#_external-libraries">17. External Libraries</a>
+<ul class="sectlevel2">
+<li><a href="external_libraries.html#sec:Major_Components">17.1. Major Components</a>
+<ul class="sectlevel3">
+<li><a href="external_libraries.html#subsec:External_Resources">17.1.1. External Resources</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Workspace">17.1.2. External Library Workspace</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Preference_Store">17.1.3. External Library Preference Store</a></li>
+<li><a href="external_libraries.html#subsec:npm_Manager">17.1.4. Library Manager</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Builder_Helper">17.1.5. External Library Builder</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Xtext_Index_Persister">17.1.6. External Library Xtext Index Persister</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Preference_Page">17.1.7. External Library Preference Page</a></li>
+</ul>
+</li>
+<li><a href="external_libraries.html#sec:Headless_External_Library_Support">17.2. Headless External Library Support</a>
+<ul class="sectlevel3">
+<li><a href="external_libraries.html#_custom-npm-settings">17.2.1. Custom npm settings</a></li>
+</ul>
+</li>
+<li><a href="external_libraries.html#sec:lmFutureWork">17.3. Future Work</a>
+<ul class="sectlevel3">
+<li><a href="external_libraries.html#subsec:lmMultipleDependencyScope">17.3.1. Multiple Dependency Scope</a></li>
+<li><a href="external_libraries.html#subsec:lmRunTestsFromLibrary">17.3.2. Run Tests from TestLibrary</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="json_support.html#sec:JSON_Support">18. JSON Support</a>
+<ul class="sectlevel2">
+<li><a href="json_support.html#sec:JSON_Parser">18.1. JSON Parser</a>
+<ul class="sectlevel3">
+<li><a href="json_support.html#sec:JSON_Parser_Unicode_Escaping">18.1.1. Escaping Unicode Control Characters in String Literals</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Empty_Text">18.1.2. Empty Text</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Nested_Structures">18.1.3. Nested Structures</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Whitespace">18.1.4. Whitespace</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Comments">18.1.5. Comments</a></li>
+</ul>
+</li>
+<li><a href="json_support.html#sec:JSON_Language_Extensions">18.2. JSON Language Extensions</a>
+<ul class="sectlevel3">
+<li><a href="json_support.html#sec:JSON_Validator_Extensions">18.2.1. JSON Validator Extensions</a>
+<ul class="sectlevel4">
+<li><a href="json_support.html#sec:File_Specitic_Validator_Extensions">18.2.1.1. File-Specific Validator Extensions</a></li>
+<li><a href="json_support.html#sec:JSON_Declarative_JSON_Validator_Extensions">18.2.1.2. Declarative JSON Validator Extensions</a></li>
+</ul>
+</li>
+<li><a href="json_support.html#_json-resource-description-strategy">18.2.2. JSON Resource Description Strategy</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_jsdoc">19. JSDoc</a>
+<ul class="sectlevel2">
+<li><a href="jsdoc.html#sec:Design_Rationale">19.1. Design Rationale</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#_general-design">19.1.1. General Design</a></li>
+<li><a href="jsdoc.html#sec:Type_Expressions">19.1.2. Type Expressions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="docexporter.html#_docexporter">20. DocExporter</a>
+<ul class="sectlevel2">
+<li><a href="docexporter.html#sec:Specification_Exporter">20.1. Specification Exporter</a></li>
+</ul>
+</li>
+<li><a href="rename_refactoring.html#_rename-refactoring">21. Rename Refactoring</a>
+<ul class="sectlevel2">
+<li><a href="rename_refactoring.html#_rename-refactoring-ui-interaction">21.1. Rename Refactoring UI interaction</a></li>
+<li><a href="rename_refactoring.html#_renameelementprocessor-interaction">21.2. RenameElementProcessor interaction</a></li>
+</ul>
+</li>
+<li><a href="flow_graphs.html#chap:flowgraphs">22. Flow Graphs</a>
+<ul class="sectlevel2">
+<li><a href="flow_graphs.html#sec:flowgraphs_overview">22.1. Flow graphs overview</a>
+<ul class="sectlevel3">
+<li><a href="flow_graphs.html#_internal-graph">22.1.1. Internal graph</a></li>
+<li><a href="flow_graphs.html#_optimizations">22.1.2. Optimizations</a></li>
+<li><a href="flow_graphs.html#_api-for-client-analyses">22.1.3. API for client analyses</a>
+<ul class="sectlevel4">
+<li><a href="flow_graphs.html#_mapping-from-internal-to-ast-elements">22.1.3.1. Mapping from internal to AST elements</a></li>
+<li><a href="flow_graphs.html#_graph-visitor">22.1.3.2. Graph visitor</a></li>
+<li><a href="flow_graphs.html#_graph-explorer">22.1.3.3. Graph explorer</a></li>
+<li><a href="flow_graphs.html#_branch-walker">22.1.3.4. Branch walker</a></li>
+<li><a href="flow_graphs.html#_example-1-compute-string-for-each-path">22.1.3.5. Example 1: Compute string for each path</a></li>
+<li><a href="flow_graphs.html#_path-quantor">22.1.3.6. Path quantor</a></li>
+</ul>
+</li>
+<li><a href="flow_graphs.html#_control-flow-analyses">22.1.4. Control flow analyses</a>
+<ul class="sectlevel4">
+<li><a href="flow_graphs.html#_dead-code-analysis">22.1.4.1. Dead code analysis</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="flow_graphs.html#sec:dataflow">22.2. Dataflow</a>
+<ul class="sectlevel3">
+<li><a href="flow_graphs.html#_dataflow-graph">22.2.1. Dataflow graph</a></li>
+<li><a href="flow_graphs.html#_dataflow-analyses">22.2.2. Dataflow analyses</a>
+<ul class="sectlevel4">
+<li><a href="flow_graphs.html#_def-def-def-nothing-analysis">22.2.2.1. Def&#8594;Def / Def&#8594;Nothing analysis</a></li>
+<li><a href="flow_graphs.html#_def-use-decl-analysis">22.2.2.2. Def|Use&#8592;Decl analysis</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="publish_npms.html#sec:publish-npms-to-public">23. Publish npms</a>
+<ul class="sectlevel2">
+<li><a href="publish_npms.html#sec:publish-npms-n4js-maven">23.1. Publish n4js-libs to during  maven build</a></li>
+</ul>
+</li>
+<li><a href="#sec:Hints">Appendix A: Hints</a>
+<ul class="sectlevel2">
+<li><a href="#sec:XtextInjection">A.1. Xtext Injection</a>
+<ul class="sectlevel3">
+<li><a href="#sec:DI_MultipleInjectors_Singletons">A.1.1. Multiple Injectors and Singletons</a>
+<ul class="sectlevel4">
+<li><a href="#sec:DI_avoid_duplicate_singletons">A.1.1.1. Avoiding duplicate singletons</a>
+<ul class="sectlevel5">
+<li><a href="#sec:DI_binding_in_shared">A.1.1.1.1. Defining binding in the shared injector</a></li>
+<li><a href="#sec:DI_binding_in_custom">A.1.1.1.2. Defining binding in the custom injector</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#sec:DI_Hints">A.1.2. Dependency Injection Hints</a>
+<ul class="sectlevel4">
+<li><a href="#sec:DI_custom_bundle">A.1.2.1. Use DI in custom bundle, use DI with extensions</a>
+<ul class="sectlevel5">
+<li><a href="#sec:DI_custom_bundle_problem">A.1.2.1.1. Problem</a></li>
+<li><a href="#sec:DI_custom_bundle_solution">A.1.2.1.2. Solution</a></li>
+</ul>
+</li>
+<li><a href="#sec:Access_Other_DSL_Injector">A.1.2.2. How do I get the Guice Injector of my language?</a>
+<ul class="sectlevel5">
+<li><a href="#sec:DSL_Injector_UI_context">A.1.2.2.1. UI context</a></li>
+<li><a href="#sec:DSL_Injector_Non_UI_context">A.1.2.2.2. Non UI context but with injection context</a></li>
+<li><a href="#sec:DSL_Injector_Non_UI_non_injection_context">A.1.2.2.3. Non UI context without injection context</a></li>
+</ul>
+</li>
+<li><a href="#sec:Cancel_Indicator">A.1.2.3. How do I get cancel indicators in different contexts?</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#sec:Eclipse">A.2. Eclipse</a>
+<ul class="sectlevel3">
+<li><a href="#sec:Show_Xtext_Index">A.2.1. Show the current Xtext index</a></li>
+<li><a href="#sec:Plugin_spy">A.2.2. Plug-in spy</a></li>
+</ul>
+</li>
+<li><a href="#sec:Maven-hints">A.3. Maven</a>
+<ul class="sectlevel3">
+<li><a href="#how-to-check-for-maven-mojo-updates">A.3.1. How to check for Maven MOJO updates</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#_module-loading">Appendix B: Module Loading</a>
+<ul class="sectlevel2">
+<li><a href="appendix_b_module_loading.html#sec:Dependency_Management">B.1. Dependency Management</a></li>
+<li><a href="appendix_b_module_loading.html#ecmascript-modules">B.2. ECMAScript Modules</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:ES5_Modules_Systems">B.2.1. ES5 Modules Systems</a></li>
+<li><a href="appendix_b_module_loading.html#sec:ES6_Modules">B.2.2. ES6 Modules</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:ECMAScript_Module_Loaders">B.3. ECMAScript Module Loaders</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:ES6_Module_Loaders">B.3.1. ES6 Module Loaders</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Polyfills_for_ES6_Module_Loaders">B.3.2. Polyfills for ES6 Module Loaders</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:es6_module_loader">B.3.2.1. es6-module-loader</a></li>
+<li><a href="appendix_b_module_loading.html#sec:SystemJS">B.3.2.2. SystemJS</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Demo">B.3.2.3. Demo</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#case-study-typescript">B.4. Case Study : TypeScript</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:ES6_Modules_Support">B.4.1. ES6 Modules Support</a></li>
+<li><a href="appendix_b_module_loading.html#sec:TypeScript_and_Module_Loading">B.4.2. TypeScript and Module Loading</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Cyclic_Dependencies">B.5. Cyclic Dependencies</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:Setup">B.5.1. Setup</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Transpile_and_Execute">B.5.2. Transpile and Execute</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Module_Format___AMD">B.5.2.1. Module Format = AMD</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Module_Format___CommonJS">B.5.2.2. Module Format = CommonJS</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Module_Format___SystemJS">B.5.2.3. Module Format = SystemJS</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Conclusion">B.5.3. Conclusion</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#system.register-as-transpilation-target">B.6. System.register as transpilation target</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:Introduction">B.6.1. Introduction</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:External_Transpilers">B.6.1.1. External Transpilers</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Example_of_a_System_register_module">B.6.1.2. Example of a System.register module</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Structure_of_a_System_register_module">B.6.2. Structure of a System.register module</a></li>
+<li><a href="appendix_b_module_loading.html#_transpilation-hints">B.6.3. Transpilation Hints</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Handling_Imports">B.6.3.1. Handling Imports</a></li>
+<li><a href="appendix_b_module_loading.html#sec:__exportFn__">B.6.3.2. &lt;&lt;exportFn&gt;&gt;</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Handling_Exports">B.6.3.3. Handling Exports</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Examples_w__Circular_Dependencies">B.6.4. Examples w/ Circular Dependencies</a></li>
+<li><a href="appendix_b_module_loading.html#sec:N4JS_Examples_w__Circular_Dependencies">B.6.5. N4JS Examples w/ Circular Dependencies</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Unresolved_Cyclic_Dependencies">B.6.5.1. Unresolved Cyclic Dependencies</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Variables___Functions">B.6.5.2. Examples with Variables &amp; Functions</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Classes">B.6.5.3. Examples with Classes</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Examples_with_SubClassing">B.6.5.4. Examples with SubClassing</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Miscellaneous">B.6.5.5. Miscellaneous</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#_resources">B.6.6. Resources</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:CommonJS_as_transpilation_target">B.7. CommonJS as transpilation target</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#_introduction-2">B.7.1. Introduction</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Transpilation_Hints">B.7.2. Transpilation Hints</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Import_Statements">B.7.2.1. Import Statements</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Export_Statements">B.7.2.2. Export Statements</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Tracking_Live_Bindings">B.7.2.3. Tracking Live Bindings</a></li>
+<li><a href="appendix_b_module_loading.html#sec:A_complete_example">B.7.2.4. A complete example</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#_resources-2">B.7.3. Resources</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_c_license.html#sec:License">Appendix C: License</a></li>
+<li><a href="appendix_d_acronyms.html#sec:Acronyms">Appendix D: Acronyms</a></li>
+<li><a href="appendix_e_bibliography_and_footnotes.html#_bibliography-and-footnotes">Appendix E: Bibliography and Footnotes</a></li>
+</ul>
+</div>
+</div>
+<div id="content"><div class="sect1">
+<h2 id="sec:Hints"><a class="anchor" href="#sec:Hints"></a><a class="link" href="#sec:Hints">Appendix A: Hints</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>In this chapter, some tips and tricks regarding Eclipse, Xtend and Maven should be collected.</p>
+</div>
+<div class="sect2">
+<h3 id="sec:XtextInjection"><a class="anchor" href="#sec:XtextInjection"></a><a class="link" href="#sec:XtextInjection">A.1. Xtext Injection</a></h3>
+<div class="paragraph">
+<p><a href="#fig:cd_XtextInjectors">[fig:cd_XtextInjectors]</a> shows different injectors used by Xtext
+and their relation to the injector of a custom language created with Xtext
+(in this example N4JS).</p>
+</div>
+<div id="fig:XtextInjectors" class="imageblock center">
+<div class="content">
+<img src="chapters/a02_hints/images/cd_XtextInjectors.svg" alt="cd XtextInjectors">
+</div>
+<div class="title">Figure 62. Xtext injectors and custom DSL injector</div>
+</div>
+<div class="paragraph">
+<p><strong>Injectors creation:</strong></p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>create 'SharedInjector'</p>
+<div class="ulist">
+<ul>
+<li>
+<p>create shared singletons</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>create (lazily) custom language injector</p>
+<div class="ulist">
+<ul>
+<li>
+<p>take singletons from shared injector</p>
+</li>
+<li>
+<p>add bindings from 'SharedModule'</p>
+</li>
+<li>
+<p>create own singletons</p>
+</li>
+</ul>
+</div>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Normally one injector is bound to one language.
+'ContributingModule' allows custom languages to contribute bindings to the
+shared state, effectively cross project boundaries.</p>
+</div>
+<div class="paragraph">
+<p>It must be noted that in case of N4JS tools there are multiple languages
+contributing / extending Xtext injector, which can be seen in figure
+<a href="#fig:cd_customInjectors">Xtext injectors and custom DSL injector</a></p>
+</div>
+<div id="fig:cd_customInjectors" class="imageblock center">
+<div class="content">
+<img src="chapters/a02_hints/images/cd_customInjectors.svg" alt="cd customInjectors">
+</div>
+<div class="title">Figure 63. Xtext injectors and custom DSL injector</div>
+</div>
+<div class="sect3">
+<h4 id="sec:DI_MultipleInjectors_Singletons"><a class="anchor" href="#sec:DI_MultipleInjectors_Singletons"></a><a class="link" href="#sec:DI_MultipleInjectors_Singletons">A.1.1. Multiple Injectors and Singletons</a></h4>
+<div class="paragraph">
+<p>Every injector creates its 'ObjectGraph'. Having multiple Injectors in
+the system leads to multiple (disconnected) object graphs. For normal instances
+that is not an issue, but for scoped instances this causes problems.
+Most common issue happens with '@Singleton' instances that carry state.</p>
+</div>
+<div id="fig:cd_SingletonDuplicate" class="imageblock center">
+<div class="content">
+<img src="chapters/a02_hints/images/cd_SingletonDuplicate.svg" alt="cd SingletonDuplicate">
+</div>
+<div class="title">Figure 64. Xtext injectors and custom DSL injector</div>
+</div>
+<div class="paragraph">
+<p><a href="#fig:cd_customInjectors">Xtext injectors and custom DSL injector</a> shows situation in which both 'ChildInjector'
+and 'N4JSInjector' have their bindings for 'N4JSEclipseCore'. As a result those
+injectors will create their instance of core that is expected to be
+'@Singleton'. Additionally, this will be true for all its transitive
+dependencies.</p>
+</div>
+<div class="sect4">
+<h5 id="sec:DI_avoid_duplicate_singletons"><a class="anchor" href="#sec:DI_avoid_duplicate_singletons"></a><a class="link" href="#sec:DI_avoid_duplicate_singletons">A.1.1.1. Avoiding duplicate singletons</a></h5>
+<div class="paragraph">
+<p>To avoid issue with duplicate singletons two distinct injectors should not
+have their bindings for singletons. Developer needs to decide where to
+define <strong>the only</strong> binding, and let one 'ObjectGraph' delegate to another.</p>
+</div>
+<div class="sect5">
+<h6 id="sec:DI_binding_in_shared"><a class="anchor" href="#sec:DI_binding_in_shared"></a><a class="link" href="#sec:DI_binding_in_shared">A.1.1.1.1. Defining binding in the shared injector</a></h6>
+<div class="paragraph">
+<p>One approach is to define binding in the shared injector. Then in the injector
+of the custom language to delegate to the shared contribution.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>/** Binds {@link IN4JSCore} */
+public class ContributingModule implements Module {
+    @Override
+    public void configure(Binder binder) {
+        binder.bind(IN4JSCore.class).to(IN4JSEclipseCore.class);
+        binder.bind(IN4JSEclipseCore.class).to(N4JSEclipseCore.class).in(SINGLETON);
+    }
+}
+
+/** Delegates binding for {@link IN4JSCore} to the shared provider. */
+public class ContributingModule implements Module {
+    public Provider&lt;? extends IN4JSCore&gt; bindIN4JSCore() {
+        return Access.contributedProvider(N4JSEclipseCore.class);
+    }
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Downside of this approach is in the shared injector itself.
+It does not allow for implicit bindings. This forces developer to declare
+bindings for <strong>all transitive</strong> dependencies of the main binding explicitly.
+Additionally, every custom language has to do it. These make shared injector
+the <em>GodInjector</em> that contains configuration for all custom languages,
+it is responsible for creating most objects in the system, and potentially
+exposes types from one language to another language where it might not be
+desired.</p>
+</div>
+</div>
+<div class="sect5">
+<h6 id="sec:DI_binding_in_custom"><a class="anchor" href="#sec:DI_binding_in_custom"></a><a class="link" href="#sec:DI_binding_in_custom">A.1.1.1.2. Defining binding in the custom injector</a></h6>
+<div class="paragraph">
+<p>Other approach is to define binding in the injector for a custom
+language. Then let instances in the shared injector object graph to obtain
+singleton instances via custom language injector (which is stored on the
+custom language activator).</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>/** Does not bind {@link IN4JSCore} */
+public class ContributingModule implements Module {
+    @Override
+    public void configure(Binder binder) {
+        // no core binding
+    }
+}
+
+/** Binds {@link IN4JSCore}. */
+public class ContributingModule implements Module {
+    public Class&lt;? extends IN4JSCore&gt; bindIN4JSCore() {
+        return IN4JSEclipseCore.class;
+    }
+}
+
+/** Some type used in shared injector object graph */
+public SomeSharedType{
+
+    /** Obtain {@link IN4JSCore} form {@code N4JSInjector}. */
+    private IN4JSCore getIN4JSCore() {
+        return N4JSActivator
+                .getInstance()
+                .getInjector(ORG_ECLIPSE_N4JS_N4JS)
+                .getInstance(IN4JSCore.class);
+    }
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>This approach also has downsides. In the 'SomeSharedType' that exists in the
+shared injector object graph we cannot inject 'IN4JSCore' as it is not
+known to the shared injector. Instead, we have to get the instance form the
+'N4JSInjector' manually. This requires developer to know whole (singleton)
+types structure
+defined in every custom language.</p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3 language-n4js">
+<h4 id="sec:DI_Hints"><a class="anchor" href="#sec:DI_Hints"></a><a class="link" href="#sec:DI_Hints">A.1.2. Dependency Injection Hints</a></h4>
+<div class="sect4">
+<h5 id="sec:DI_custom_bundle"><a class="anchor" href="#sec:DI_custom_bundle"></a><a class="link" href="#sec:DI_custom_bundle">A.1.2.1. Use DI in custom bundle, use DI with extensions</a></h5>
+<div class="sect5">
+<h6 id="sec:DI_custom_bundle_problem"><a class="anchor" href="#sec:DI_custom_bundle_problem"></a><a class="link" href="#sec:DI_custom_bundle_problem">A.1.2.1.1. Problem</a></h6>
+<div class="paragraph">
+<p>DI should be used in a custom bundle, i.e. a bundle not generated by Xtext.
+E.g., a new handler should be provided in its plugin, and this handler requires
+an injected instance. Example</p>
+</div>
+<div class="paragraph">
+<p>my.dsl.bundle.ui xtext generated</p>
+</div>
+<div class="paragraph">
+<p>my.dsl.bundle.sub.ui
+The following class is contained in my custom plugin:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>class my.dsl.bundle.sub.ui.Handler {
+    @Inject SomeDSLOrXtextSpecificType obj;
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>The question is, how can obj of type be injected at this location?</p>
+</div>
+</div>
+<div class="sect5">
+<h6 id="sec:DI_custom_bundle_solution"><a class="anchor" href="#sec:DI_custom_bundle_solution"></a><a class="link" href="#sec:DI_custom_bundle_solution">A.1.2.1.2. Solution</a></h6>
+<div class="paragraph">
+<p>First of all, to use DI in a type, the type instance itself must have been
+created via DI. This requires an injector which uses the same class loader as
+the type using the injector. This means that a new bundle needs its injector,
+created by an IExecutableExtensionFactory using the bundles' activator (plugin)
+singleton.</p>
+</div>
+<div class="paragraph">
+<p>This activator can extend the generated activator of a Xtext bundle. The
+following code can be used as a template, as long as no custom non-default
+bindings are to be added (in this case, have a look at the generated activator
+and override the methods configuring the injector):</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>public class my.dsl.bundle.sub.ui.Activator extends my.dsl.bundle.ui.MyDSLActivator {
+    private static my.dsl.bundle.sub.ui.Activator INSTANCE;
+
+    @Override
+    public void start(BundleContext context) throws Exception {
+        super.start(context);
+        INSTANCE = this;
+    }
+
+    @Override
+    public void stop(BundleContext context) throws Exception {
+        INSTANCE = null;
+        super.stop(context);
+    }
+
+    public static TypePopupActivator getInstance() {
+        return INSTANCE;
+    }
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Additionally, a custom 'AbstractGuiceAwareExecutableExtensionFactory' has to be
+implemented. This class then uses the new activator instance (this is required
+as bundles have their classloaders!)</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>public class my.dsl.bundle.sub.ui.SubExecutableExtensionFactory extends AbstractGuiceAwareExecutableExtensionFactory {
+    @Override
+    protected Bundle getBundle() {
+        return my.dsl.bundle.sub.ui.Activator.getInstance().getBundle();
+    }
+
+    @Override
+    protected Injector getInjector() {
+    return my.dsl.bundle.sub.ui.Activator.getInstance().getInjector(MyDSLActivator.MY_LANGUAGE_GRAMMAR);
+    }
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Now, we can use this extension factory in the plugin.xml of the sub bundle to
+let the handler be created via DI. E.g.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>"org.eclipse.ui.handlers"&amp;gt;
+&lt;handler
+class="my.dsl.bundle.sub.ui.SubExecutableExtensionFactory:my.dsl.bundle.sub.ui.Handler"
+commandId="..."&amp;gt;
+handler&amp;gt;
+extension&amp;gt;</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Access_Other_DSL_Injector"><a class="anchor" href="#sec:Access_Other_DSL_Injector"></a><a class="link" href="#sec:Access_Other_DSL_Injector">A.1.2.2. How do I get the Guice Injector of my language?</a></h5>
+<div class="paragraph">
+<p>We have the use case to load a N4MF file inside the N4JS infrastructure to read
+out the project description and configure the qualified names and container
+visibility. I.e. we have to load another DSL in our current DSL infrastructure,
+in the use case to have a Xtext resource set available to load the N4MF file.
+Injecting the Xtext resource of the current DSL wouldn’t work as it has not the
+N4MF injection context. So in the following the ways how to access this
+injection context is described as extracted from
+<a href="http://koehnlein.blogspot.de/2012/11/xtext-tip-how-do-i-get-guice-injector.html">this blog post</a>.</p>
+</div>
+<div class="sect5">
+<h6 id="sec:DSL_Injector_UI_context"><a class="anchor" href="#sec:DSL_Injector_UI_context"></a><a class="link" href="#sec:DSL_Injector_UI_context">A.1.2.2.1. UI context</a></h6>
+<div class="paragraph">
+<p>To access another DSL injector in a UI DSL project just add a dependency to the
+UI project of the other DSL and then</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>MyClass myClass =
+TheOtherDSLActivator.getInstance().getInjector().get(MyClass.class)</code></pre>
+</div>
+</div>
+</div>
+<div class="sect5">
+<h6 id="sec:DSL_Injector_Non_UI_context"><a class="anchor" href="#sec:DSL_Injector_Non_UI_context"></a><a class="link" href="#sec:DSL_Injector_Non_UI_context">A.1.2.2.2. Non UI context but with injection context</a></h6>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>@Inject IResourceServiceProvider.Registry serviceProviderRegistry;
+...
+MyClass myClass
+=
+serviceProviderRegistry.getResourceServiceProvider(URI.createFileURI(n4mfFileAbsolutePath)).get(MyClass.class)</code></pre>
+</div>
+</div>
+</div>
+<div class="sect5">
+<h6 id="sec:DSL_Injector_Non_UI_non_injection_context"><a class="anchor" href="#sec:DSL_Injector_Non_UI_non_injection_context"></a><a class="link" href="#sec:DSL_Injector_Non_UI_non_injection_context">A.1.2.2.3. Non UI context without injection context</a></h6>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>@Inject IResourceServiceProvider.Registry serviceProviderRegistry;
+...
+MyClass
+myClass
+=
+IResourceServiceProvider.Registry.INSTANCE.getResourceServiceProvider(uri).get(MyClass.class);</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Cancel_Indicator"><a class="anchor" href="#sec:Cancel_Indicator"></a><a class="link" href="#sec:Cancel_Indicator">A.1.2.3. How do I get cancel indicators in different contexts?</a></h5>
+<div class="paragraph">
+<p>Several factors contribute to responsiveness in the IDE, but here we focus in
+running jobs in the background and reacting to cancellation requests.</p>
+</div>
+<div class="paragraph">
+<p>The Eclipse Jobs API is recommended for potentially long-running tasks (other
+than incremental building, which has dedicated support). For example, the
+outline view is populated by a background job, running validations on the
+resource (and honoring cancellation requests initiated as for any job).</p>
+</div>
+<div class="paragraph">
+<p>Cancel indicators are a Xtext abstraction while Eclipse favors progress
+monitors, the latter including not only cancellation capability but also a
+callback mechanism to give feedback in the UI about intermediate progress.
+Cancel indicator can wrap a progress monitor.</p>
+</div>
+<div class="paragraph">
+<p>Cancel indicators come in two variants, depending on the source of cancellation
+events:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>a resource becoming stale (usually as a result of editing sources) triggers
+cancellation. These cancel indicators can be obtained via
+'OutdatedStateManager', which itself is available via injection.</p>
+</li>
+<li>
+<p>cancel indicators associated to the UI, for example associated to an Eclipse
+job. Examples:</p>
+<div class="ulist">
+<ul>
+<li>
+<p>for an outline view running in the background, an override of method
+'createRoot()' from 'DefaultOutlineTreeProvider' receives a UI-aware cancel
+indicator;</p>
+</li>
+<li>
+<p>for the transpiler, instances that carry cancel indicator are
+'IFileSystemAccess' and (in the future) 'IGenerator2'. To track the latter, see
+Eclipse bug 477068.</p>
+</li>
+</ul>
+</div>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>In general, whenever a resource is validated cancel indicator should be checked
+periodically. These checks are performed automatically via
+'MethodWrapperCancelable' before the (reflective) invocation of each validation
+method and therefore require no manual intervention, see
+'AbstractMessageAdjustingN4JSValidator'. However, that doesn’t help in case a
+single validation method ''takes too long''. To simplify those checks, utility
+'isCanceled()' of 'AbstractMessageAdjustingN4JSValidator' can be invoked.</p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="sec:Eclipse"><a class="anchor" href="#sec:Eclipse"></a><a class="link" href="#sec:Eclipse">A.2. Eclipse</a></h3>
+<div class="sect3">
+<h4 id="sec:Show_Xtext_Index"><a class="anchor" href="#sec:Show_Xtext_Index"></a><a class="link" href="#sec:Show_Xtext_Index">A.2.1. Show the current Xtext index</a></h4>
+<div class="paragraph">
+<p>Press the following keyboard shortcut in the running UI: <kbd>CTRL</kbd><br>
+<kbd>SHIFT</kbd> + <kbd>F3</kbd> (likely under Mac <kbd>CMD</kbd> + <kbd>SHIFT</kbd> + <kbd>F3</kbd>).</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Plugin_spy"><a class="anchor" href="#sec:Plugin_spy"></a><a class="link" href="#sec:Plugin_spy">A.2.2. Plug-in spy</a></h4>
+<div class="paragraph">
+<p>Not special for Xtext but very helpful do identify which class implements a UI
+concept, for example, if you want to know which class implements the Open Model
+Element dialog just press <kbd>CTRL</kbd> + <kbd>SHIFT</kbd> + <kbd>F3</kbd> to open that
+dialog and afterwards press <kbd>SHIFT</kbd> + <kbd>ALT</kbd> + <kbd>F1</kbd> to show that
+'XtextEObjectSearchDialog' is used as implementation. Additionally, use
+<kbd>SHIFT</kbd> + <kbd>ALT</kbd> + <kbd>F2</kbd> to spy buttons in the toolbar and
+<kbd>SHIFT</kbd> + <kbd>ALT</kbd> + <kbd>F3</kbd> to spy the extension point name of the
+currently active view or window.</p>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="sec:Maven-hints"><a class="anchor" href="#sec:Maven-hints"></a><a class="link" href="#sec:Maven-hints">A.3. Maven</a></h3>
+<div class="sect3">
+<h4 id="how-to-check-for-maven-mojo-updates"><a class="anchor" href="#how-to-check-for-maven-mojo-updates"></a><a class="link" href="#how-to-check-for-maven-mojo-updates">A.3.1. How to check for Maven MOJO updates</a></h4>
+<div class="paragraph">
+<p><strong>cd</strong> to the root directory and call</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-bash" data-lang="bash">mvn versions:display-plugin-updates</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div id="footer">
+<div id="footer-text">
+Version 0.9<br>
+Last updated 2019-08-07 15:02:40 CEST
+</div>
+</div>
+<!-- ************* docinfo-footer *************************************************************** -->
+<div class="Grid social" style="color:#d5dfea">
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <h2>Quick Links</h2>
+    <ul>
+      <li><a href="../downloads.html">Download</a></li>
+      <li><a href="../userguides/index.html">Documentation</a></li>
+      <li><a href="https://github.com/eclipse/n4js/">Source</a></li>
+      <li><a href="https://github.com/eclipse/n4js/issues">Issues</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="https://www.eclipse.org/forums/index.php/f/365/">Forum</a></li>
+      <li><a href="http://n4js.blogspot.de/">Blog</a></li>
+      <li><a href="https://dev.eclipse.org/mailman/listinfo/n4js-dev">Mailing List</a></li>
+      <li><a href="https://projects.eclipse.org/projects/technology.n4js">Eclipse Project Page</a></li>
+      <li><a href="https://twitter.com/n4jsdev">Tweets by n4jsdev</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="http://www.eclipse.org/">Eclipse Home</a></li>
+      <li><a href="http://www.eclipse.org/legal/privacy.php">Privacy Policy</a></li>
+      <li><a href="http://www.eclipse.org/legal/termsofuse.php">Terms of Use</a></li>
+      <li><a href="http://www.eclipse.org/legal/copyright.php">Copyright Agent</a></li>
+      <li><a href="http://www.eclipse.org/legal/">Legal</a></li>
+    </ul>
+  </div>
+  <div style="clear: both; height: 0; overflow: hidden;"></div>
+</div>
+
+<!-- ************* UI Scripts ************* -->
+<script type="text/javascript" src="scripts/back-to-top.js"></script>
+
+<script type="text/javascript" src="scripts/treeview.js"></script>
+<script type="text/javascript" src="scripts/toc.js"></script>
+
+<!-- ************* Prism.js Syntax Highlighting ************* -->
+<script src="scripts/prism.js"></script>
+
+<script type="text/javascript">
+	// Add the 'toclist' id for search function
+	$(".toc2 > ul").attr('id', 'toclist');
+	// Generate a Search input form
+	$("#toclist > li:first-of-type").before('<input type="text" id="pagesearch" onkeyup="search()" placeholder="Search for section...">');
+	$("#toclist > li:first-of-type").before('<i id="clear" class="fa fa-times-circle-o"></i>');
+	$("#clear").click(function(){
+	    $("#pagesearch").val('');
+	    search();
+	    $('.toc2 > ul').treeView('collapseAll');
+	});
+	// intialize Treeview.js
+	$(".toc2 > ul").treeView();
+	// Initialize Scrollspy
+</script>
+<!-- ************* docinfo-footer *************************************************************** -->
+</body>
+</html>
\ No newline at end of file
diff --git a/design/appendix_b_module_loading.html b/design/appendix_b_module_loading.html
new file mode 100644
index 0000000..c1b6a6e
--- /dev/null
+++ b/design/appendix_b_module_loading.html
@@ -0,0 +1,3929 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="generator" content="Asciidoctor 1.5.5">
+<meta name="author" content="2019-08-07 15:02:40 CEST">
+<title>N4JS Design Specification</title>
+<link rel="stylesheet" href="styles/spec.min.css">
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.6.3/css/font-awesome.min.css">
+<!-- ************* docinfo ******************************************************************* -->
+
+
+<!-- ************* Favicon ************-->
+<link rel="icon" href="images/favicon.ico" />
+
+<!-- ************* Back-to-top JQuery ************* -->
+<script src="https://code.jquery.com/jquery-1.12.4.js"></script>
+<script src="https://code.jquery.com/ui/1.12.0/jquery-ui.js"></script>
+
+
+<link href="styles/prism.min.css" rel="stylesheet" />
+<script type="text/javascript" async
+  src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2/MathJax.js?config=TeX-MML-AM_CHTML">
+</script>
+
+<!-- ************* Styles ************* -->
+<link rel="stylesheet" type="text/css" href="styles/n4jsspec-adoc.css">
+
+
+<!-- ****************** NavBar ****************** -->
+<div id="menubar">
+	<div class="banner">
+        <a href="https://www.eclipse.org/n4js/#"><img id="logo" src="images/n4js-logo.png" alt="Eclipse N4JS"></a>
+    </div>
+<ul>
+  <li><a href="index.html">Index</a></li>
+</ul>
+</div>
+<!-- ************* docinfo ******************************************************************* -->
+<style>
+      .admonitionblock td.icon .icon-todo:before{content:"\f249";color:#f4ee42}
+    </style>
+</head>
+<body class="book toc2 toc-left">
+<div id="header">
+<h1>N4JS Design Specification</h1>
+<div class="details">
+<span id="author" class="author">2019-08-07 15:02:40 CEST</span><br>
+<span id="revnumber">version 0.9</span>
+</div>
+<div id="toc" class="toc2">
+<div id="toctitle">Table of Contents</div>
+<ul class="sectlevel1">
+<li><a href="introduction.html#_introduction">1. Introduction</a>
+<ul class="sectlevel2">
+<li><a href="introduction.html#notation">1.1. Notation</a></li>
+<li><a href="introduction.html#sec:IDE_Overview">1.2. IDE Components</a>
+<ul class="sectlevel3">
+<li><a href="introduction.html#sec:Naming_Conventions">1.2.1. Naming Conventions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="eclipse_setup.html#_eclipse-setup">2. Eclipse Setup</a>
+<ul class="sectlevel2">
+<li><a href="eclipse_setup.html#_system-requirements">2.1. System Requirements</a></li>
+<li><a href="eclipse_setup.html#_contribute">2.2. Contribute</a>
+<ul class="sectlevel3">
+<li><a href="eclipse_setup.html#_eclipse-installer">2.2.1. Eclipse Installer</a>
+<ul class="sectlevel4">
+<li><a href="eclipse_setup.html#_changing-the-setup-script">2.2.1.1. Changing the Setup Script</a></li>
+</ul>
+</li>
+<li><a href="eclipse_setup.html#_manual-ide-configuration">2.2.2. Manual IDE Configuration</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="release_engineering.html#_release-engineering">3. Release Engineering</a>
+<ul class="sectlevel2">
+<li><a href="release_engineering.html#_nightly-build-on-eclipse-infrastructure">3.1. Nightly build on Eclipse infrastructure</a></li>
+<li><a href="release_engineering.html#_build-the-n4js-ide-from-command-line">3.2. Build the N4JS IDE from command line</a>
+<ul class="sectlevel3">
+<li><a href="release_engineering.html#_publish-maven-tooling-code-org-eclipse-n4js-releng-util-code">3.2.1. Publish maven-tooling <code>org.eclipse.n4js.releng.util</code></a></li>
+<li><a href="release_engineering.html#sec:test-verdaccio">3.2.2. Test Verdaccio containing n4js-libs</a></li>
+<li><a href="release_engineering.html#_generation-of-eclipse-help-for-spec-and-design-document">3.2.3. Generation of Eclipse help for spec and design document</a></li>
+</ul>
+</li>
+<li><a href="release_engineering.html#_updating-frameworks-and-dependencies">3.3. Updating frameworks and dependencies</a>
+<ul class="sectlevel3">
+<li><a href="release_engineering.html#_update-of-eclipse-emf-xtext-etc">3.3.1. Update of Eclipse, EMF, Xtext, etc.</a></li>
+<li><a href="release_engineering.html#_update-of-the-embedded-jre">3.3.2. Update of the embedded JRE</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tips_and_tricks.html#_tips-and-tricks">4. Tips and Tricks</a>
+<ul class="sectlevel2">
+<li><a href="tips_and_tricks.html#_naming">4.1. Naming</a></li>
+<li><a href="tips_and_tricks.html#_logging">4.2. Logging</a></li>
+<li><a href="tips_and_tricks.html#_cancellation-handling">4.3. Cancellation Handling</a></li>
+<li><a href="tips_and_tricks.html#_caching">4.4. Caching</a></li>
+<li><a href="tips_and_tricks.html#_dependency-injection">4.5. Dependency Injection</a></li>
+<li><a href="tips_and_tricks.html#_miscellaneous">4.6. Miscellaneous</a></li>
+</ul>
+</li>
+<li><a href="parser.html#_parser">5. Parser</a>
+<ul class="sectlevel2">
+<li><a href="parser.html#sec:Parser_Overview">5.1. Overview</a></li>
+<li><a href="parser.html#sec:N4JS_Parser">5.2. N4JS Parser</a></li>
+<li><a href="parser.html#sec:Parser_Generation_Post_Processing">5.3. Parser Generation Post-Processing</a>
+<ul class="sectlevel3">
+<li><a href="parser.html#sec:Automatic_Semicolon_Insertion">5.3.1. Automatic Semicolon Insertion</a>
+<ul class="sectlevel4">
+<li><a href="parser.html#sec:Injected_code_in_the_Antlr_grammar_file">5.3.1.1. Injected code in the Antlr grammar file</a></li>
+<li><a href="parser.html#sec:Customized_error_recovery">5.3.1.2. Customized error recovery</a></li>
+</ul>
+</li>
+<li><a href="parser.html#sec:_No_line_terminator_allowed_here__handling">5.3.2. Async and <code>No line terminator allowed here</code> Handling</a></li>
+<li><a href="parser.html#sec:Regular_Expression">5.3.3. Regular Expression</a></li>
+<li><a href="parser.html#sec:Unicode">5.3.4. Unicode</a></li>
+<li><a href="parser.html#sec:Literals">5.3.5. Literals</a></li>
+</ul>
+</li>
+<li><a href="parser.html#sec:Modifiers">5.4. Modifiers</a></li>
+<li><a href="parser.html#sec:Conflict_Resolutions">5.5. Conflict Resolutions</a>
+<ul class="sectlevel3">
+<li><a href="parser.html#sec:Reserved_Keywords_vs__Identifier_Names">5.5.1. Reserved Keywords vs. Identifier Names</a></li>
+<li><a href="parser.html#sec:Operators_and_Generics">5.5.2. Operators and Generics</a></li>
+</ul>
+</li>
+<li><a href="parser.html#sec:Content_Assist_Parser">5.6. Content-Assist Parser</a></li>
+</ul>
+</li>
+<li><a href="type_system.html#_type-system">6. Type System</a>
+<ul class="sectlevel2">
+<li><a href="type_system.html#sec:Type_Model_and_Grammar">6.1. Type Model and Grammar</a>
+<ul class="sectlevel3">
+<li><a href="type_system.html#sec:Type_Model_Overview">6.1.1. Type Model Overview</a></li>
+<li><a href="type_system.html#sec:Built_in_Types">6.1.2. Built-in and Primitive Types</a></li>
+<li><a href="type_system.html#sec:Type_Model_DSL">6.1.3. Type Model DSL</a></li>
+</ul>
+</li>
+<li><a href="type_system.html#sec:Type_System_Implementation">6.2. Type System Implementation</a></li>
+<li><a href="type_system.html#sec:Type_Inference_combined_with_AST_Traversal">6.3. Type Inference of AST</a>
+<ul class="sectlevel3">
+<li><a href="type_system.html#sec:Type_Inference_combined_with_AST_Traversal__Background">6.3.1. Background</a></li>
+<li><a href="type_system.html#sec:Triggering_Type_Inference_of_AST">6.3.2. Triggering</a></li>
+<li><a href="type_system.html#sec:Traversal_Order_During_Type_Inference_of_AST">6.3.3. Traversal Order</a></li>
+<li><a href="type_system.html#sec:Cross_References_During_Type_Inference_of_AST">6.3.4. Cross-References</a></li>
+<li><a href="type_system.html#sec:Function_Accessor_Bodies_During_Type_Inference_of_AST">6.3.5. Function/Accessor Bodies</a></li>
+<li><a href="type_system.html#sec:Poly_Expressions_During_Type_Inference_of_AST">6.3.6. Poly Expressions</a></li>
+<li><a href="type_system.html#sec:Constraint_Solver_used_During_Type_Inference_of_AST">6.3.7. Constraint Solver</a></li>
+<li><a href="type_system.html#sec:Type_Guards_During_Type_Inference_of_AST">6.3.8. Type Guards</a></li>
+</ul>
+</li>
+<li><a href="type_system.html#sec:Structural_Typing">6.4. Structural Typing</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#_type-index">7. Type Index</a>
+<ul class="sectlevel2">
+<li><a href="type_index.html#sec:Type_Index_Design_Rationale">7.1. Design Rationale</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#sec:Getting_the_Xtext_Index_Content_IResourceDescriptions">7.1.1. Getting the Xtext Index (<code>IResourceDescriptions</code>) Content</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#sec:Design_Overview">7.2. Design Overview</a></li>
+<li><a href="type_index.html#sec:N4JS_Resource_Load_States">7.3. N4JS Resource Load States</a></li>
+<li><a href="type_index.html#sec:Type_Builder">7.4. Types Builder</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#sec:Type_Inference_not_allowed_in_Type_Builder">7.4.1. Type Inference not allowed in Types Builder</a></li>
+<li><a href="type_index.html#sec:ComputedTypeReferences">7.4.2. Deferred Type References</a></li>
+<li><a href="type_index.html#sec:Use_cases_of_ComputedTypeRef">7.4.3. Use cases of DeferredTypeRef</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#sec:Incremental_Builder_Overview">7.5. Incremental Builder (Overview)</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#sec:Incremental_Builder_Overview__XtextBuilder">7.5.1. XtextBuilder</a></li>
+<li><a href="type_index.html#sec:Incremental_Builder_Overview__IBuilderState">7.5.2. IBuilderState</a>
+<ul class="sectlevel4">
+<li><a href="type_index.html#copy-and-update-xtext-index">7.5.2.1. Copy and Update Xtext Index</a></li>
+<li><a href="type_index.html#build-state-setup-phase">7.5.2.2. Build State Setup Phase</a></li>
+<li><a href="type_index.html#process-queued-uris">7.5.2.3. Process Queued URIs</a></li>
+<li><a href="type_index.html#queueing-affected-resources">7.5.2.4. Queueing Affected Resources</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#sec:Incremental_Builder_Overview__Example">7.5.3. Example</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#dirty-state-handling">7.6. Dirty state handling</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#use-case-restoring-types-from-user-data">7.6.1. Use case: Restoring types from user data</a></li>
+<li><a href="type_index.html#use-case-updating-the-xtext-index">7.6.2. Use case: Updating the Xtext index</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="project_model.html#_project-model">8. Project Model</a>
+<ul class="sectlevel2">
+<li><a href="project_model.html#sec:Package_json">8.1. Package.json File</a></li>
+<li><a href="project_model.html#_accessing-project-information">8.2. Accessing Project Information</a>
+<ul class="sectlevel3">
+<li><a href="project_model.html#sec:IN4JSCore">8.2.1. IN4JSCore</a></li>
+<li><a href="project_model.html#sec:N4JSModel">8.2.2. N4JSModel</a></li>
+<li><a href="project_model.html#sec:N4JSWorkspace">8.2.3. N4JSWorkspace</a></li>
+<li><a href="project_model.html#sec:N4JSProject">8.2.4. N4JSProject</a></li>
+<li><a href="project_model.html#sec:SourceContainer">8.2.5. SourceContainer</a></li>
+<li><a href="project_model.html#sec:N4JSProjectsStateHelper">8.2.6. N4JSProjectsStateHelper</a></li>
+</ul>
+</li>
+<li><a href="project_model.html#sec:Caching">8.3. Caching</a>
+<ul class="sectlevel3">
+<li><a href="project_model.html#_caching-of-externallibraryworkspace">8.3.1. Caching of ExternalLibraryWorkspace</a></li>
+<li><a href="project_model.html#_caching-of-n4jsprojectsstatehelper">8.3.2. Caching of N4JSProjectsStateHelper</a></li>
+</ul>
+</li>
+<li><a href="project_model.html#sec:WildcardPathFilter">8.4. WildcardPathFilter</a></li>
+<li><a href="project_model.html#sec:ProjectUtils">8.5. ProjectUtils</a></li>
+</ul>
+</li>
+<li><a href="binding.html#_binding">9. Binding</a>
+<ul class="sectlevel2">
+<li><a href="binding.html#sec:Binding_Design_Rationale">9.1. Design Rationale</a></li>
+<li><a href="binding.html#sec:Binding_to_Members">9.2. Binding to Members</a></li>
+<li><a href="binding.html#sec:Binding_Getter_Setter">9.3. Getter / Setter Binding</a></li>
+<li><a href="binding.html#chap:Statics">9.4. Static Member Binding</a></li>
+<li><a href="binding.html#sec:Binding_Enumeration">9.5. Enumeration Literals Binding</a></li>
+<li><a href="binding.html#sec:Accessibility_of_types_and_members">9.6. Accessibility of types and members</a></li>
+<li><a href="binding.html#sec:Member_Scope_Example">9.7. Member Scope Example</a></li>
+<li><a href="binding.html#sec:Scoping_for_Members_of_Composed_Type_Explained">9.8. Scoping for Members of Composed Type (Union/Intersection) Example</a></li>
+<li><a href="binding.html#sec:Binding_of_Structurally_References_Types">9.9. Structurally References Types</a></li>
+<li><a href="binding.html#sec:Building">9.10. Building</a>
+<ul class="sectlevel3">
+<li><a href="binding.html#sec:Build_Phases">9.10.1. Build Phases</a></li>
+<li><a href="binding.html#sec:Build_Scenarios">9.10.2. Build Scenarios</a></li>
+<li><a href="binding.html#sec:Lazy_linking_problem">9.10.3. Lazy linking problem</a></li>
+</ul>
+</li>
+<li><a href="binding.html#sec:Proxies_and_Proxy_Resolution">9.11. Proxies and Proxy Resolution (Overview)</a>
+<ul class="sectlevel3">
+<li><a href="binding.html#xtexts-lazy-linking-proxies">9.11.1. Xtext’s Lazy Linking Proxies</a></li>
+<li><a href="binding.html#standard-emf-proxies">9.11.2. Standard EMF Proxies</a></li>
+<li><a href="binding.html#_how-is-proxy-resolution-triggered">9.11.3. How is Proxy Resolution Triggered?</a></li>
+<li><a href="binding.html#_when-is-proxy-resolution-allowed">9.11.4. When is Proxy Resolution Allowed?</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="validation.html#_validation">10. Validation</a>
+<ul class="sectlevel2">
+<li><a href="validation.html#sec:validation_overview">10.1. Validation overview</a></li>
+<li><a href="validation.html#sec:validation_control_flow">10.2. Validation control flow</a></li>
+<li><a href="validation.html#sec:validation_issue_ids">10.3. Issue IDs and Messages</a></li>
+<li><a href="validation.html#sec:validation_usage_patterns">10.4. Usage Pattern</a></li>
+<li><a href="validation.html#sec:validation_links">10.5. Links</a></li>
+</ul>
+</li>
+<li><a href="references.html#_references">11. References</a>
+<ul class="sectlevel2">
+<li><a href="references.html#sec:usecases">11.1. Use cases</a></li>
+<li><a href="references.html#sec:calculation_algorithm">11.2. Calculation algorithm</a>
+<ul class="sectlevel3">
+<li><a href="references.html#sec:Xtext_default_implementation">11.2.1. Xtext default implementation</a></li>
+<li><a href="references.html#sec:N4_implementation">11.2.2. N4JS implementation</a></li>
+</ul>
+</li>
+<li><a href="references.html#sec:PerformanceOfDependencyCalculation">11.3. Performance Of Dependency Calculation</a></li>
+<li><a href="references.html#sec:kinds_of_references">11.4. Kinds of references</a>
+<ul class="sectlevel3">
+<li><a href="references.html#sec:Cross_References_to_be_ignored">11.4.1. Cross References to be ignored</a></li>
+<li><a href="references.html#sec:Cross_References_to_be_handled">11.4.2. Cross References to be handled</a></li>
+</ul>
+</li>
+<li><a href="references.html#sec:transitive_dependencies">11.5. Transitive dependencies</a></li>
+<li><a href="references.html#sec:find-references">11.6. Find references</a>
+<ul class="sectlevel3">
+<li><a href="references.html#_background">11.6.1. Background</a></li>
+<li><a href="references.html#_how-find-references-work">11.6.2. How Find References Work</a>
+<ul class="sectlevel4">
+<li><a href="references.html#_step-1-convert-cursor-position-to-declared-element">11.6.2.1. Step 1: Convert Cursor Position to Declared Element</a></li>
+<li><a href="references.html#_step-2-convert-declared-element-to-target-uris">11.6.2.2. Step 2: Convert Declared Element to Target URIs</a></li>
+<li><a href="references.html#_step-3-filter-potential-resources">11.6.2.3. Step 3: Filter Potential Resources</a></li>
+<li><a href="references.html#_step-4-search-references-in-resource">11.6.2.4. Step 4: Search References in Resource</a></li>
+<li><a href="references.html#_limitations-and-possible-enhancements">11.6.2.5. Limitations and Possible Enhancements</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="compilation.html#_compilation">12. Compilation</a>
+<ul class="sectlevel2">
+<li><a href="compilation.html#chap:compilation">12.1. Introduction</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:general_design_rationals">12.1.1. General design rationals</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:logging_and_error_reporting">12.1.1.1. Logging and error reporting</a></li>
+<li><a href="compilation.html#sec:progress_monitor">12.1.1.2. Progress monitor</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Xtext_Integration">12.1.2. Xtext Integration</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:xtext_default_behaviour">12.1.2.1. Xtext default behaviour</a></li>
+<li><a href="compilation.html#sec:n4js_requirements">12.1.2.2. N4JS requirements</a></li>
+<li><a href="compilation.html#sec:compiler_discovery_in_ui">12.1.2.3. Compiler discovery in UI</a></li>
+<li><a href="compilation.html#sec:compiler_discovery_in_headless">12.1.2.4. Compiler discovery in headless</a></li>
+<li><a href="compilation.html#sec:general_generator_implementation">12.1.2.5. General generator implementation</a></li>
+<li><a href="compilation.html#sec:general_generator_activation">12.1.2.6. General generator activation</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Overview_of_Input_Models">12.1.3. Overview of the Input Models</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Core_Generator">12.2. Generators</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:Compiler_Components">12.2.1. Generator Components</a></li>
+<li><a href="compilation.html#sec:Generator_architecture">12.2.2. Generator architecture</a></li>
+<li><a href="compilation.html#sec:Unified_Compiler_Configuration">12.2.3. Unified Compiler Configuration</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Transpilers">12.3. Transpilers</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:Phases">12.3.1. Overview</a></li>
+<li><a href="compilation.html#relation-between-ast-and-im">12.3.2. Relation between AST and IM</a></li>
+<li><a href="compilation.html#implementation-overview">12.3.3. Implementation Overview</a></li>
+<li><a href="compilation.html#sec:Guidelines_for_Implementing_Transformations">12.3.4. Guidelines for Implementing Transformations</a></li>
+<li><a href="compilation.html#symbol-table-in-the-im">12.3.5. Symbol Table in the IM</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:N4JS_to_EcmaScript_Transpiler">12.4. N4JS-to-EcmaScript Transpiler</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:Overview_of_Transformations">12.4.1. Overview of Transformations</a></li>
+<li><a href="compilation.html#sec:Transpiling_members">12.4.2. Transpiling members</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:Transpiling_members__Delegating_members">12.4.2.1. Techniques for special member handling</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__Partial_shadowing_of_getter_setter_pairs">12.4.2.2. Partial shadowing</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__Consuming_or_inheriting_members_of_an_interface">12.4.2.3. Consuming or inheriting members of an interface</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__Static_polyfill">12.4.2.4. Static polyfill</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__API_implementation_stubs">12.4.2.5. API / implementation stubs</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Support_for_incomplete_API_implementation_testing_in_the_N4JS_to_EcmaScript_5_Transpiler">12.4.3. Support for incomplete API implementation testing</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:Modifications_in_Impl_projects">12.4.3.1. Modifications in Impl projects</a></li>
+<li><a href="compilation.html#sec:Implementation_of_stub_generation">12.4.3.2. Implementation of stub-generation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:n4jsc_Headless_Compiler_Interface">12.5. n4jsc Headless Compiler Interface</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:building_the_headless_compiler">12.5.1. building the headless compiler</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="execution.html#_execution">13. Execution</a>
+<ul class="sectlevel2">
+<li><a href="execution.html#sec:N4JS_Project_Execution_And_Linking_Model">13.1. N4JS Project Execution And Linking Model</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#subsec:N4JS_Execution_With_NodeJS">13.1.1. N4JS Execution With NodeJS</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:N4JS_Execution_And_Linking_File">13.2. N4JS Execution And Linking File</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#subsec:NodeJS_Specific_ELF">13.2.1. NodeJS Specific ELF</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Runners-execution">13.3. Runners</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#subsec:N4_Runtime_Environments_Convention">13.3.1. N4 Runtime Environments Convention</a></li>
+<li><a href="execution.html#subsec:Passing_Information_from_IDE_to_Execution_Code_in_Runtime_Environment">13.3.2. Passing Information from IDE to Execution Code in Runtime Environment</a></li>
+<li><a href="execution.html#subsec:Runners_Design">13.3.3. Runners Design</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Legacy_Execution_Engine">13.4. Legacy Execution Engine</a></li>
+<li><a href="execution.html#sec:Design">13.5. Design</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#sec:Usage_Outside_N4JSIDE">13.5.1. Usage Outside N4JSIDE</a>
+<ul class="sectlevel4">
+<li><a href="execution.html#sec:Use_Node_with_Maven">13.5.1.1. Use Node with Maven</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Usage_Inside_N4JSIDE">13.5.2. Usage Inside N4JSIDE</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Runtime_Injection">13.6. Runtime Injection</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#sec:Running_String_Code">13.6.1. Running String Code</a></li>
+<li><a href="execution.html#sec:Running_File_Code">13.6.2. Running File Code</a></li>
+<li><a href="execution.html#sec:Injection_Code_Example">13.6.3. Injection Code Example</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#_tests">14. Tests</a>
+<ul class="sectlevel2">
+<li><a href="tests.html#sec:Performance_Tests">14.1. Performance Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Synthetic_Performance_Tests">14.1.1. Synthetic Performance Tests</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:Design_of_Generator">14.1.1.1. Design of Generator</a></li>
+<li><a href="tests.html#sec:Design_of_Performance_Test_Execution">14.1.1.2. Design of Performance Test Configuration and Execution</a></li>
+<li><a href="tests.html#sec:JUnit_Configuration">14.1.1.3. JUnit Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Test_Configuration">14.1.1.4. JUnitBenchmark Test Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Report_Configuration">14.1.1.5. JUnitBenchmark Report Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Run_Configuration">14.1.1.6. JUnitBenchmark Run Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Example">14.1.1.7. JUnitBenchmark Example</a></li>
+<li><a href="tests.html#sec:Note_on_Jenkins_Job">14.1.1.8. Note on Jenkins Job</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#sec:ECMA_Tests">14.2. ECMA Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Grammar_Tests">14.2.1. Grammar Tests</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:Negative_Tests">14.2.1.1. Negative Tests</a></li>
+<li><a href="tests.html#sec:Test_Exclusion">14.2.1.2. Test Exclusion</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Integration_Tests">14.3. Integration Tests</a></li>
+<li><a href="tests.html#sec:Test_Helpers">14.4. Test Helpers</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Parameterized_N4JS_Tests">14.4.1. Parameterized N4JS tests</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:ParameterizedXtextRunner">14.4.1.1. ParameterizedXtextRunner</a></li>
+<li><a href="tests.html#sec:TestCodeProvider">14.4.1.2. TestCodeProvider</a></li>
+<li><a href="tests.html#sec:Example_Of_Parameterized_Parser_Test">14.4.1.3. Example of parameterized parser test</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Issue_Suppression">14.5. Issue Suppression</a></li>
+<li><a href="tests.html#sec:Xpect_Tests">14.6. Xpect Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Xpect_Test_Setup">14.6.1. Xpect Test Setup</a></li>
+<li><a href="tests.html#sec:Xpect_Issue_Suppression">14.6.2. Xpect Issue Suppression</a></li>
+<li><a href="tests.html#sec:Xpect_Provided_Test_Methods">14.6.3. Xpect Provided Test Methods</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#errors">14.6.3.1. errors</a></li>
+<li><a href="tests.html#warnings">14.6.3.2. warnings</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:N4JS_Specific_Xpect_Test_Methods">14.6.4. N4JS Specific Xpect Test Methods</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:XPECT_noerrors">14.6.4.1. noerrors and nowarnings</a></li>
+<li><a href="tests.html#sec:XPECT_scope">14.6.4.2. scope</a></li>
+<li><a href="tests.html#sec:XPECT_scopeWithPosition">14.6.4.3. scopeWithPosition</a></li>
+<li><a href="tests.html#sec:XPECT_scopeWithResource">14.6.4.4. scopeWithResource</a></li>
+<li><a href="tests.html#sec:XPECT_binding">14.6.4.5. binding</a></li>
+<li><a href="tests.html#sec:XPECT_linkedPathname">14.6.4.6. linkedPathname</a></li>
+<li><a href="tests.html#sec:XPECT_type_of">14.6.4.7. type of</a></li>
+<li><a href="tests.html#sec:XPECT_expectedType">14.6.4.8. expectedType</a></li>
+<li><a href="tests.html#sec:XPECT_elementKeyword">14.6.4.9. elementKeyword</a></li>
+<li><a href="tests.html#sec:XPECT_accessModifier">14.6.4.10. accessModifier</a></li>
+<li><a href="tests.html#sec:XPECT_compileResult">14.6.4.11. compileResult</a></li>
+<li><a href="tests.html#sec:XPECT_output">14.6.4.12. output</a></li>
+<li><a href="tests.html#sec:XPECT_outputRegEx">14.6.4.13. outputRegEx</a></li>
+<li><a href="tests.html#sec:XPECT_calculatedAccessModifier">14.6.4.14. calculatedAccessModifier</a></li>
+<li><a href="tests.html#sec:XPECT_spec">14.6.4.15. spec</a></li>
+<li><a href="tests.html#sec:XPECT_deadCode">14.6.4.16. deadCode</a></li>
+<li><a href="tests.html#sec:XPECT_returnOrThrows">14.6.4.17. returnOrThrows</a></li>
+<li><a href="tests.html#sec:XPECT_lint">14.6.4.18. lint</a></li>
+<li><a href="tests.html#sec:XPECT_lintFails">14.6.4.19. lintFails</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:FIXME_Xpect_modifier">14.6.5. FIXME Xpect modifier</a></li>
+<li><a href="tests.html#sec:Expectmatrix_Xpect_Test_Methods">14.6.6. Expectmatrix Xpect tests</a></li>
+<li><a href="tests.html#xpect-lint-tests">14.6.7. Xpect Lint Tests</a></li>
+</ul>
+</li>
+<li><a href="tests.html#xpect-proposal-tests">14.7. Xpect Proposal Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Validation_vs__Non_Validation">14.7.1. Validation vs. Non-Validation</a></li>
+<li><a href="tests.html#sec:General_Proposal_Test_Features">14.7.2. General Proposal Test Features</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:Test_Variables">14.7.2.1. Test Variables</a></li>
+<li><a href="tests.html#sec:Location_and_Selection">14.7.2.2. at – Location and Selection</a></li>
+<li><a href="tests.html#sec:Multi_Line_Expectations_in_Proposal_Tests">14.7.2.3. Multi Line Expectations in Proposal Tests</a></li>
+<li><a href="tests.html#sec:Timeout">14.7.2.4. Timeout and Performance</a></li>
+</ul>
+</li>
+<li><a href="tests.html#proposals-verify-existence-of-proposals">14.7.3. proposals – Verify Existence of Proposals</a></li>
+<li><a href="tests.html#sec:Verify_displayed_string">14.7.4. display – Verify displayed string</a></li>
+<li><a href="tests.html#sec:Apply_Proposal">14.7.5. apply – Apply Proposal</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#resource-application-in-other-files">14.7.5.1. resource – application in other files</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Content_Assist_Cycling">14.7.6. kind – Content Assist Cycling</a></li>
+<li><a href="tests.html#fileValidVerify-validation-status">14.7.7. fileValid – Verify validation status</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Apply_Proposal_And_Execute_Tests">14.8. Apply Proposal And Execute Tests</a></li>
+<li><a href="tests.html#sec:Organize_Imports_Test">14.9. Organize Imports Test</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#organizeimports">14.9.1. organizeImports</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Access_Control_Test">14.10. Access Control Test</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#test-scenarios">14.10.1. Test Scenarios</a></li>
+<li><a href="tests.html#n4js-code-generator">14.10.2. N4JS Code Generator</a></li>
+<li><a href="tests.html#xtext-issue-matcher">14.10.3. Xtext Issue Matcher</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Smoke_Tests">14.11. Smoke Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#how-to-handle-smoke-test-errors">14.11.1. How to handle smoke test errors?</a></li>
+<li><a href="tests.html#smoketester-and-exceptionanalyzer">14.11.2. SmokeTester and ExceptionAnalyzer</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:UI_Tests_with_SWTBot">14.12. UI Tests with SWTBot</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#writing-swtbot-tests">14.12.1. Writing SWTBot Tests</a></li>
+<li><a href="tests.html#running-swtbot-tests">14.12.2. Running SWTBot Tests</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Debugging_UI_Tests">14.13. Debugging UI Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Connecting_to_the_X_server_on_the_build_node">14.13.1. Connecting to the X-server on the build-node</a></li>
+<li><a href="tests.html#sec:Tools_to_investigate_the_java_stack">14.13.2. Tools to investigate the java-stack</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="ui_concepts.html#_ui-concepts">15. UI Concepts</a>
+<ul class="sectlevel2">
+<li><a href="ui_concepts.html#sec:User_Interface_Concepts">15.1. User Interface Concepts</a>
+<ul class="sectlevel3">
+<li><a href="ui_concepts.html#sec:Eclipse_UI_Concepts">15.1.1. Eclipse UI Concepts</a>
+<ul class="sectlevel4">
+<li><a href="ui_concepts.html#sec:Label_Provider">15.1.1.1. Label Provider</a></li>
+<li><a href="ui_concepts.html#sec:Markers">15.1.1.2. Markers</a></li>
+<li><a href="ui_concepts.html#sec:Commands__Toolbar_and_Menus">15.1.1.3. Commands, Toolbar and Menus</a></li>
+<li><a href="ui_concepts.html#sec:Content_Assist">15.1.1.4. Content Assist</a></li>
+<li><a href="ui_concepts.html#sec:Quick_Fixes">15.1.1.5. Quick Fixes</a></li>
+<li><a href="ui_concepts.html#sec:Quick_Assist">15.1.1.6. Quick Assist</a></li>
+<li><a href="ui_concepts.html#sec:Clean_Up_Actions">15.1.1.7. Clean Up Actions</a></li>
+<li><a href="ui_concepts.html#sec:Save_Actions">15.1.1.8. Save Actions</a></li>
+<li><a href="ui_concepts.html#sec:Auto_Edit">15.1.1.9. Auto Edit</a></li>
+<li><a href="ui_concepts.html#sec:Template_Proposals">15.1.1.10. Template Proposals</a></li>
+<li><a href="ui_concepts.html#sec:Outline_View___Quick_Outline">15.1.1.11. Outline View / Quick Outline</a></li>
+<li><a href="ui_concepts.html#sec:Navigator__Package_Explorer__Project_Explorer">15.1.1.12. Navigator, Package Explorer, Project Explorer</a></li>
+<li><a href="ui_concepts.html#sec:Hyperlinking_and_Navigation">15.1.1.13. Hyperlinking and Navigation</a></li>
+<li><a href="ui_concepts.html#sec:Syntax_and_Semantic_Coloring">15.1.1.14. Syntax and Semantic Coloring</a></li>
+<li><a href="ui_concepts.html#sec:Code_Formatter">15.1.1.15. Code Formatter</a></li>
+<li><a href="ui_concepts.html#sec:Wizards">15.1.1.16. Wizards</a></li>
+<li><a href="ui_concepts.html#sec:Cheat_Sheets">15.1.1.17. Cheat Sheets</a></li>
+<li><a href="ui_concepts.html#sec:Context_sensitive_Help">15.1.1.18. Context-sensitive Help</a></li>
+<li><a href="ui_concepts.html#sec:Hovers">15.1.1.19. Hovers</a></li>
+<li><a href="ui_concepts.html#sec:Folding">15.1.1.20. Folding</a></li>
+<li><a href="ui_concepts.html#sec:Customizable_validation___severity">15.1.1.21. Customizable validation / severity</a></li>
+<li><a href="ui_concepts.html#sec:Proposals">15.1.1.22. Proposals</a></li>
+</ul>
+</li>
+<li><a href="ui_concepts.html#sec:Non_Eclipse_UI_Concepts">15.1.2. Non-Eclipse UI Concepts</a>
+<ul class="sectlevel4">
+<li><a href="ui_concepts.html#sec:Overlays">15.1.2.1. Overlays</a></li>
+<li><a href="ui_concepts.html#sec:Goto__Inferred__Type">15.1.2.2. Goto (Inferred) Type</a></li>
+<li><a href="ui_concepts.html#sec:Postfix_Completion">15.1.2.3. Postfix Completion</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="ui_concepts.html#_user-interface-resources">15.2. User Interface Resources</a>
+<ul class="sectlevel3">
+<li><a href="ui_concepts.html#_icons">15.2.1. Icons</a>
+<ul class="sectlevel4">
+<li><a href="ui_concepts.html#_eclipse-platform-icons">15.2.1.1. Eclipse Platform Icons</a></li>
+<li><a href="ui_concepts.html#_n4js-specific-icons">15.2.1.2. N4JS Specific Icons</a></li>
+<li><a href="ui_concepts.html#_high-resolution-icons">15.2.1.3. High Resolution Icons</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="formatting.html#_formatting">16. Formatting</a>
+<ul class="sectlevel2">
+<li><a href="formatting.html#sec:FmtObjective">16.1. Objective</a>
+<ul class="sectlevel3">
+<li><a href="formatting.html#sec:FmtFormatting_Comments">16.1.1. Formatting Comments</a></li>
+</ul>
+</li>
+<li><a href="formatting.html#sec:FmtArchitecture">16.2. Architecture</a>
+<ul class="sectlevel3">
+<li><a href="formatting.html#sec:Implementation_example">16.2.1. Implementation example</a></li>
+</ul>
+</li>
+<li><a href="formatting.html#sec:FmtFormatter_Implementation_Guidelines">16.3. Formatter Implementation Guidelines</a></li>
+<li><a href="formatting.html#sec:FmtConfiguration">16.4. Configuration</a></li>
+<li><a href="formatting.html#sec:FmtUI_Integration">16.5. UI Integration</a></li>
+<li><a href="formatting.html#sec:FmtUnit_Testing_with_Xpect">16.6. Unit Testing with Xpect</a></li>
+</ul>
+</li>
+<li><a href="external_libraries.html#_external-libraries">17. External Libraries</a>
+<ul class="sectlevel2">
+<li><a href="external_libraries.html#sec:Major_Components">17.1. Major Components</a>
+<ul class="sectlevel3">
+<li><a href="external_libraries.html#subsec:External_Resources">17.1.1. External Resources</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Workspace">17.1.2. External Library Workspace</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Preference_Store">17.1.3. External Library Preference Store</a></li>
+<li><a href="external_libraries.html#subsec:npm_Manager">17.1.4. Library Manager</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Builder_Helper">17.1.5. External Library Builder</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Xtext_Index_Persister">17.1.6. External Library Xtext Index Persister</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Preference_Page">17.1.7. External Library Preference Page</a></li>
+</ul>
+</li>
+<li><a href="external_libraries.html#sec:Headless_External_Library_Support">17.2. Headless External Library Support</a>
+<ul class="sectlevel3">
+<li><a href="external_libraries.html#_custom-npm-settings">17.2.1. Custom npm settings</a></li>
+</ul>
+</li>
+<li><a href="external_libraries.html#sec:lmFutureWork">17.3. Future Work</a>
+<ul class="sectlevel3">
+<li><a href="external_libraries.html#subsec:lmMultipleDependencyScope">17.3.1. Multiple Dependency Scope</a></li>
+<li><a href="external_libraries.html#subsec:lmRunTestsFromLibrary">17.3.2. Run Tests from TestLibrary</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="json_support.html#sec:JSON_Support">18. JSON Support</a>
+<ul class="sectlevel2">
+<li><a href="json_support.html#sec:JSON_Parser">18.1. JSON Parser</a>
+<ul class="sectlevel3">
+<li><a href="json_support.html#sec:JSON_Parser_Unicode_Escaping">18.1.1. Escaping Unicode Control Characters in String Literals</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Empty_Text">18.1.2. Empty Text</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Nested_Structures">18.1.3. Nested Structures</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Whitespace">18.1.4. Whitespace</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Comments">18.1.5. Comments</a></li>
+</ul>
+</li>
+<li><a href="json_support.html#sec:JSON_Language_Extensions">18.2. JSON Language Extensions</a>
+<ul class="sectlevel3">
+<li><a href="json_support.html#sec:JSON_Validator_Extensions">18.2.1. JSON Validator Extensions</a>
+<ul class="sectlevel4">
+<li><a href="json_support.html#sec:File_Specitic_Validator_Extensions">18.2.1.1. File-Specific Validator Extensions</a></li>
+<li><a href="json_support.html#sec:JSON_Declarative_JSON_Validator_Extensions">18.2.1.2. Declarative JSON Validator Extensions</a></li>
+</ul>
+</li>
+<li><a href="json_support.html#_json-resource-description-strategy">18.2.2. JSON Resource Description Strategy</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_jsdoc">19. JSDoc</a>
+<ul class="sectlevel2">
+<li><a href="jsdoc.html#sec:Design_Rationale">19.1. Design Rationale</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#_general-design">19.1.1. General Design</a></li>
+<li><a href="jsdoc.html#sec:Type_Expressions">19.1.2. Type Expressions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="docexporter.html#_docexporter">20. DocExporter</a>
+<ul class="sectlevel2">
+<li><a href="docexporter.html#sec:Specification_Exporter">20.1. Specification Exporter</a></li>
+</ul>
+</li>
+<li><a href="rename_refactoring.html#_rename-refactoring">21. Rename Refactoring</a>
+<ul class="sectlevel2">
+<li><a href="rename_refactoring.html#_rename-refactoring-ui-interaction">21.1. Rename Refactoring UI interaction</a></li>
+<li><a href="rename_refactoring.html#_renameelementprocessor-interaction">21.2. RenameElementProcessor interaction</a></li>
+</ul>
+</li>
+<li><a href="flow_graphs.html#chap:flowgraphs">22. Flow Graphs</a>
+<ul class="sectlevel2">
+<li><a href="flow_graphs.html#sec:flowgraphs_overview">22.1. Flow graphs overview</a>
+<ul class="sectlevel3">
+<li><a href="flow_graphs.html#_internal-graph">22.1.1. Internal graph</a></li>
+<li><a href="flow_graphs.html#_optimizations">22.1.2. Optimizations</a></li>
+<li><a href="flow_graphs.html#_api-for-client-analyses">22.1.3. API for client analyses</a>
+<ul class="sectlevel4">
+<li><a href="flow_graphs.html#_mapping-from-internal-to-ast-elements">22.1.3.1. Mapping from internal to AST elements</a></li>
+<li><a href="flow_graphs.html#_graph-visitor">22.1.3.2. Graph visitor</a></li>
+<li><a href="flow_graphs.html#_graph-explorer">22.1.3.3. Graph explorer</a></li>
+<li><a href="flow_graphs.html#_branch-walker">22.1.3.4. Branch walker</a></li>
+<li><a href="flow_graphs.html#_example-1-compute-string-for-each-path">22.1.3.5. Example 1: Compute string for each path</a></li>
+<li><a href="flow_graphs.html#_path-quantor">22.1.3.6. Path quantor</a></li>
+</ul>
+</li>
+<li><a href="flow_graphs.html#_control-flow-analyses">22.1.4. Control flow analyses</a>
+<ul class="sectlevel4">
+<li><a href="flow_graphs.html#_dead-code-analysis">22.1.4.1. Dead code analysis</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="flow_graphs.html#sec:dataflow">22.2. Dataflow</a>
+<ul class="sectlevel3">
+<li><a href="flow_graphs.html#_dataflow-graph">22.2.1. Dataflow graph</a></li>
+<li><a href="flow_graphs.html#_dataflow-analyses">22.2.2. Dataflow analyses</a>
+<ul class="sectlevel4">
+<li><a href="flow_graphs.html#_def-def-def-nothing-analysis">22.2.2.1. Def&#8594;Def / Def&#8594;Nothing analysis</a></li>
+<li><a href="flow_graphs.html#_def-use-decl-analysis">22.2.2.2. Def|Use&#8592;Decl analysis</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="publish_npms.html#sec:publish-npms-to-public">23. Publish npms</a>
+<ul class="sectlevel2">
+<li><a href="publish_npms.html#sec:publish-npms-n4js-maven">23.1. Publish n4js-libs to during  maven build</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Hints">Appendix A: Hints</a>
+<ul class="sectlevel2">
+<li><a href="appendix_a_hints.html#sec:XtextInjection">A.1. Xtext Injection</a>
+<ul class="sectlevel3">
+<li><a href="appendix_a_hints.html#sec:DI_MultipleInjectors_Singletons">A.1.1. Multiple Injectors and Singletons</a>
+<ul class="sectlevel4">
+<li><a href="appendix_a_hints.html#sec:DI_avoid_duplicate_singletons">A.1.1.1. Avoiding duplicate singletons</a>
+<ul class="sectlevel5">
+<li><a href="appendix_a_hints.html#sec:DI_binding_in_shared">A.1.1.1.1. Defining binding in the shared injector</a></li>
+<li><a href="appendix_a_hints.html#sec:DI_binding_in_custom">A.1.1.1.2. Defining binding in the custom injector</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:DI_Hints">A.1.2. Dependency Injection Hints</a>
+<ul class="sectlevel4">
+<li><a href="appendix_a_hints.html#sec:DI_custom_bundle">A.1.2.1. Use DI in custom bundle, use DI with extensions</a>
+<ul class="sectlevel5">
+<li><a href="appendix_a_hints.html#sec:DI_custom_bundle_problem">A.1.2.1.1. Problem</a></li>
+<li><a href="appendix_a_hints.html#sec:DI_custom_bundle_solution">A.1.2.1.2. Solution</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Access_Other_DSL_Injector">A.1.2.2. How do I get the Guice Injector of my language?</a>
+<ul class="sectlevel5">
+<li><a href="appendix_a_hints.html#sec:DSL_Injector_UI_context">A.1.2.2.1. UI context</a></li>
+<li><a href="appendix_a_hints.html#sec:DSL_Injector_Non_UI_context">A.1.2.2.2. Non UI context but with injection context</a></li>
+<li><a href="appendix_a_hints.html#sec:DSL_Injector_Non_UI_non_injection_context">A.1.2.2.3. Non UI context without injection context</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Cancel_Indicator">A.1.2.3. How do I get cancel indicators in different contexts?</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Eclipse">A.2. Eclipse</a>
+<ul class="sectlevel3">
+<li><a href="appendix_a_hints.html#sec:Show_Xtext_Index">A.2.1. Show the current Xtext index</a></li>
+<li><a href="appendix_a_hints.html#sec:Plugin_spy">A.2.2. Plug-in spy</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Maven-hints">A.3. Maven</a>
+<ul class="sectlevel3">
+<li><a href="appendix_a_hints.html#how-to-check-for-maven-mojo-updates">A.3.1. How to check for Maven MOJO updates</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#_module-loading">Appendix B: Module Loading</a>
+<ul class="sectlevel2">
+<li><a href="#sec:Dependency_Management">B.1. Dependency Management</a></li>
+<li><a href="#ecmascript-modules">B.2. ECMAScript Modules</a>
+<ul class="sectlevel3">
+<li><a href="#sec:ES5_Modules_Systems">B.2.1. ES5 Modules Systems</a></li>
+<li><a href="#sec:ES6_Modules">B.2.2. ES6 Modules</a></li>
+</ul>
+</li>
+<li><a href="#sec:ECMAScript_Module_Loaders">B.3. ECMAScript Module Loaders</a>
+<ul class="sectlevel3">
+<li><a href="#sec:ES6_Module_Loaders">B.3.1. ES6 Module Loaders</a></li>
+<li><a href="#sec:Polyfills_for_ES6_Module_Loaders">B.3.2. Polyfills for ES6 Module Loaders</a>
+<ul class="sectlevel4">
+<li><a href="#sec:es6_module_loader">B.3.2.1. es6-module-loader</a></li>
+<li><a href="#sec:SystemJS">B.3.2.2. SystemJS</a></li>
+<li><a href="#sec:Demo">B.3.2.3. Demo</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#case-study-typescript">B.4. Case Study : TypeScript</a>
+<ul class="sectlevel3">
+<li><a href="#sec:ES6_Modules_Support">B.4.1. ES6 Modules Support</a></li>
+<li><a href="#sec:TypeScript_and_Module_Loading">B.4.2. TypeScript and Module Loading</a></li>
+</ul>
+</li>
+<li><a href="#sec:Cyclic_Dependencies">B.5. Cyclic Dependencies</a>
+<ul class="sectlevel3">
+<li><a href="#sec:Setup">B.5.1. Setup</a></li>
+<li><a href="#sec:Transpile_and_Execute">B.5.2. Transpile and Execute</a>
+<ul class="sectlevel4">
+<li><a href="#sec:Module_Format___AMD">B.5.2.1. Module Format = AMD</a></li>
+<li><a href="#sec:Module_Format___CommonJS">B.5.2.2. Module Format = CommonJS</a></li>
+<li><a href="#sec:Module_Format___SystemJS">B.5.2.3. Module Format = SystemJS</a></li>
+</ul>
+</li>
+<li><a href="#sec:Conclusion">B.5.3. Conclusion</a></li>
+</ul>
+</li>
+<li><a href="#system.register-as-transpilation-target">B.6. System.register as transpilation target</a>
+<ul class="sectlevel3">
+<li><a href="#sec:Introduction">B.6.1. Introduction</a>
+<ul class="sectlevel4">
+<li><a href="#sec:External_Transpilers">B.6.1.1. External Transpilers</a></li>
+<li><a href="#sec:Example_of_a_System_register_module">B.6.1.2. Example of a System.register module</a></li>
+</ul>
+</li>
+<li><a href="#sec:Structure_of_a_System_register_module">B.6.2. Structure of a System.register module</a></li>
+<li><a href="#_transpilation-hints">B.6.3. Transpilation Hints</a>
+<ul class="sectlevel4">
+<li><a href="#sec:Handling_Imports">B.6.3.1. Handling Imports</a></li>
+<li><a href="#sec:__exportFn__">B.6.3.2. &lt;&lt;exportFn&gt;&gt;</a></li>
+<li><a href="#sec:Handling_Exports">B.6.3.3. Handling Exports</a></li>
+</ul>
+</li>
+<li><a href="#sec:Examples_w__Circular_Dependencies">B.6.4. Examples w/ Circular Dependencies</a></li>
+<li><a href="#sec:N4JS_Examples_w__Circular_Dependencies">B.6.5. N4JS Examples w/ Circular Dependencies</a>
+<ul class="sectlevel4">
+<li><a href="#sec:Unresolved_Cyclic_Dependencies">B.6.5.1. Unresolved Cyclic Dependencies</a></li>
+<li><a href="#sec:Variables___Functions">B.6.5.2. Examples with Variables &amp; Functions</a></li>
+<li><a href="#sec:Classes">B.6.5.3. Examples with Classes</a></li>
+<li><a href="#sec:Examples_with_SubClassing">B.6.5.4. Examples with SubClassing</a></li>
+<li><a href="#sec:Miscellaneous">B.6.5.5. Miscellaneous</a></li>
+</ul>
+</li>
+<li><a href="#_resources">B.6.6. Resources</a></li>
+</ul>
+</li>
+<li><a href="#sec:CommonJS_as_transpilation_target">B.7. CommonJS as transpilation target</a>
+<ul class="sectlevel3">
+<li><a href="#_introduction-2">B.7.1. Introduction</a></li>
+<li><a href="#sec:Transpilation_Hints">B.7.2. Transpilation Hints</a>
+<ul class="sectlevel4">
+<li><a href="#sec:Import_Statements">B.7.2.1. Import Statements</a></li>
+<li><a href="#sec:Export_Statements">B.7.2.2. Export Statements</a></li>
+<li><a href="#sec:Tracking_Live_Bindings">B.7.2.3. Tracking Live Bindings</a></li>
+<li><a href="#sec:A_complete_example">B.7.2.4. A complete example</a></li>
+</ul>
+</li>
+<li><a href="#_resources-2">B.7.3. Resources</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_c_license.html#sec:License">Appendix C: License</a></li>
+<li><a href="appendix_d_acronyms.html#sec:Acronyms">Appendix D: Acronyms</a></li>
+<li><a href="appendix_e_bibliography_and_footnotes.html#_bibliography-and-footnotes">Appendix E: Bibliography and Footnotes</a></li>
+</ul>
+</div>
+</div>
+<div id="content"><div class="sect1">
+<h2 id="_module-loading"><a class="anchor" href="#_module-loading"></a><a class="link" href="#_module-loading">Appendix B: Module Loading</a></h2>
+<div class="sectionbody">
+<div class="admonitionblock warning">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-warning" title=""></i>
+</td>
+<td class="content">
+This chapter is outdated and basically kept for historical reasons.
+</td>
+</tr>
+</table>
+</div>
+<div class="sect2">
+<h3 id="sec:Dependency_Management"><a class="anchor" href="#sec:Dependency_Management"></a><a class="link" href="#sec:Dependency_Management">B.1. Dependency Management</a></h3>
+<div class="paragraph">
+<p>There exist several types of dependencies between modules, distinguishable by the time when the dependency is relevant. We first define these dependencies lazily to give an impression of the problem, at more rigorously later on.</p>
+</div>
+<div class="paragraph">
+<p>Dependency needed at compile time. These type of dependency is removed by the compiler. These are basically type references used in variable or function declarations.</p>
+</div>
+<div class="paragraph">
+<p>Runtime dependencies are to be handled at runtime in general. We distinguish two special types of runtime dependencies:</p>
+</div>
+<div class="paragraph">
+<p>A loadtime dependency is a special runtime dependency that needs to be resolved before a module is initialized, that is, when all top-level statements of a module, containing class declarations, are executed. This usually is a types super type (e.g., super class), or a call to a function (defined in a different module) in a static initializer or module top level statement.</p>
+</div>
+<div class="paragraph">
+<p>An execution time dependency is a non-initialization runtime dependency. That is, when a method is called (from another module), this is execution time.</p>
+</div>
+<div class="paragraph">
+<p>Of course, before a module can be loaded, it needs to be fetched (i.e., the actual code has to be retrieved by the browser).</p>
+</div>
+<div class="paragraph">
+<p>We can define sets containing modules which a given module depends on. Note that these sets contain each other, as shown in <a href="#fig:euler_dependencies">Euler Dependencies</a>. However, we define disjoint sets in which a dependency to another type is only contained in one of the sets.</p>
+</div>
+<div id="fig:euler_dependencies" class="imageblock center">
+<div class="content">
+<img src="chapters/a10_moduleLoading/images/euler_dependencies.svg" alt="euler dependencies">
+</div>
+<div class="title">Figure 65. Euler diagram of dependency sets</div>
+</div>
+<div class="paragraph">
+<p>Given a code sequence , we define the set of accessed modules in it as .</p>
+</div>
+<div class="literalblock">
+<div class="content">
+<pre>describes all function calls happening in code block , i.e. . In case  calls on functions , we define a function’s body code sequence as .</pre>
+</div>
+</div>
+<div class="paragraph">
+<p>The complete set of accessed modules for a particular code sequence  is then defined as
+]</p>
+</div>
+<div class="paragraph">
+<p>We explicitly allow a function to be excluded from being incorporated in the above algorithm by annotating it.</p>
+</div>
+<div class="paragraph">
+<p>The set of load-time-dependencies for a module  with initializer code  is then defined as math:[\[\begin{aligned}
+load-time-deps := AccessdModules( SuperClass(M) ) + AccessdModules( IC(M) ) \end{aligned}\]]</p>
+</div>
+</div>
+<div class="sect2 language-javascript">
+<h3 id="ecmascript-modules"><a class="anchor" href="#ecmascript-modules"></a><a class="link" href="#ecmascript-modules">B.2. ECMAScript Modules</a></h3>
+<div class="sect3">
+<h4 id="sec:ES5_Modules_Systems"><a class="anchor" href="#sec:ES5_Modules_Systems"></a><a class="link" href="#sec:ES5_Modules_Systems">B.2.1. ES5 Modules Systems</a></h4>
+<div class="paragraph">
+<p>Before ES6, Javascript had no built in support for modules. To overcome this hurdle, the two widely accepted formats have been :</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p><code>CommonJS</code> : Primarily aimed at synchronous module loading. The main implementation of this format is seen in <code>Node.js</code></p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-javascript" data-lang="javascript">var value = 100;
+function inc() {
+    value++;
+}
+
+module.exports = {
+    value : value,
+    inc : inc
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Import via require.</p>
+</div>
+</li>
+<li>
+<p><code>AMD</code> : Primarily aimed at asynchronous module loading in browsers. The main implementation of this format is seen in <code>RequireJS</code>.</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>define('myModule', ['mod1', 'mod2'], function (mod1, mod2) {
+        return {
+            myFunc: function(x, y) {
+                ..
+            }
+        };
+    };
+});</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p><code>passive</code> format</p>
+</div>
+</li>
+</ol>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:ES6_Modules"><a class="anchor" href="#sec:ES6_Modules"></a><a class="link" href="#sec:ES6_Modules">B.2.2. ES6 Modules</a></h4>
+<div class="paragraph">
+<p>The ES6 spec introduces <a href="http://www.ecma-international.org/ecma-262/6.0/#sec-modules">modules</a>. ES6 modules resemble <code>CommonJS</code> syntax with <code>AMD</code> like asynchronous loading support.</p>
+</div>
+<div class="paragraph">
+<p>Apart from the syntactic details, the highlights of ES6 modules are :</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>ES6 modules support (multiple) named exports.</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>export const VERSION = "1.0.1";
+export function inc(x) {
+    return x + 1;
+}</code></pre>
+</div>
+</div>
+</li>
+<li>
+<p>ES6 modules support default exports.</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>export default function (x) {
+    return x+1;
+}</code></pre>
+</div>
+</div>
+</li>
+<li>
+<p>As specified <a href="http://www.ecma-international.org/ecma-262/6.0/#sec-createimportbinding">here</a>, ES6 modules export live immutable bindings (instead of values).</p>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title=""></i>
+</td>
+<td class="content">
+This behaviour is different from that of <code>CommonJS</code> and <code>AMD</code> modules where a snapshot of the value is exported.
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>An example demonstrating the behavioural difference :</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>//-------------src.js------------
+var value = 100;
+function inc() {
+    value++;
+}
+
+module.exports = {
+    value : value,
+    inc : inc
+}
+//-------------main.js------------
+var src = require("./src"); //import src
+
+console.log(src.value); //prints 100
+src.inc();
+
+console.log(src.value); //prints 100 &lt;--- The value does not update.
+
+src.value = 65;
+console.log(src.value); //prints 65 &lt;--- The imported value is mutable.</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>The same example with ES6 modules :</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>//-------------src.js------------
+export var value = 100; // &lt;--- ES6 syntax
+export function inc() { // &lt;--- ES6 syntax
+    value++;
+}
+
+//-------------main.js------------
+import {value, inc} from "src" // &lt;--- ES6 syntax
+
+console.log(value); //prints 100
+inc();
+
+console.log(value); //prints 101 &lt;--- The value is a live binding.
+
+value = 65; // &lt;--- throws an Error implying the binding is immutable.</code></pre>
+</div>
+</div>
+</li>
+<li>
+<p>ES6 modules impose a static module structure i.e. the imports and exports can be determined at compile time (statically).</p>
+</li>
+</ol>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:ECMAScript_Module_Loaders"><a class="anchor" href="#sec:ECMAScript_Module_Loaders"></a><a class="link" href="#sec:ECMAScript_Module_Loaders">B.3. ECMAScript Module Loaders</a></h3>
+<div class="paragraph">
+<p>For resolving module dependencies and loading modules, the JS landscape provides a few different module loaders.</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p><code>RequireJS</code> is the loader of choice for in browser, <code>AMD</code> style modules. We currently transpile our code into an AMD-style format to allow it running in both Browser and Node.js environments.</p>
+</li>
+<li>
+<p><code>Node.js</code> provides a native loader implementation for <code>CommonJS</code> style modules.</p>
+</li>
+<li>
+<p>For browsers (primarily), tools like <a href="http://webpack.github.io/"><code>Webpack</code></a> and <a href="http://browserify.org/"><code>Browserify</code></a> exist. These tools analyse the dependency graph of the entire project and then bundle up all the dependencies in a single file. <code>Browserify</code> only supports <code>CommonJS</code> modules where as <code>Webpack</code> works with both <code>CommonJS</code> &amp; <code>AMD</code> style modules.</p>
+</li>
+<li>
+<p>At the time of writing this document (August 2015), there does not exist any native implementation for ES6 modules by any Javascript host environments i.e. ES6 modules are not natively supported by browsers or <code>Node.js</code>, as of now.</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>[fig:moduelLoader] shows an overview.</p>
+</div>
+<div id="fig:moduleLoader" class="imageblock center">
+<div class="content">
+<img src="chapters/a10_moduleLoading/images/moduleLoader.svg" alt="moduleLoader">
+</div>
+<div class="title">Figure 66. Module Loader and Transpilers, Overview</div>
+</div>
+<div class="sect3">
+<h4 id="sec:ES6_Module_Loaders"><a class="anchor" href="#sec:ES6_Module_Loaders"></a><a class="link" href="#sec:ES6_Module_Loaders">B.3.1. ES6 Module Loaders</a></h4>
+<div class="paragraph">
+<p>The ES6 spec started out with ES6 Module Loader details as part of the spec. However the Working Group later decided to not proceed with it. The specification for ES6 Module Loader is now a separate specification [<a href="appendix_e_bibliography_and_footnotes.html#WhatWGLoader">WhatWGLoader</a>].</p>
+</div>
+<div class="paragraph">
+<p>The aim of this specification is:</p>
+</div>
+<div class="quoteblock">
+<blockquote>
+<div class="paragraph">
+<p>This specification describes the behavior of loading JavaScript modules from a JavaScript host environment. It also provides APIs for intercepting the module loading process and customizing loading behavior.</p>
+</div>
+</blockquote>
+</div>
+<div class="paragraph">
+<p>The <a href="https://github.com/whatwg/loader#implementation-status">Implementation status</a> of the spec states :</p>
+</div>
+<div class="quoteblock">
+<blockquote>
+<div class="paragraph">
+<p>It is too early to know about the Loader, first we need ES2015 modules implemented by the various engines.</p>
+</div>
+</blockquote>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Polyfills_for_ES6_Module_Loaders"><a class="anchor" href="#sec:Polyfills_for_ES6_Module_Loaders"></a><a class="link" href="#sec:Polyfills_for_ES6_Module_Loaders">B.3.2. Polyfills for ES6 Module Loaders</a></h4>
+<div class="paragraph">
+<p>Although there is no native support for ES6 module loading, there are a few attempts to polyfill this gap.</p>
+</div>
+<div class="sect4">
+<h5 id="sec:es6_module_loader"><a class="anchor" href="#sec:es6_module_loader"></a><a class="link" href="#sec:es6_module_loader">B.3.2.1. es6-module-loader</a></h5>
+<div class="paragraph">
+<p>The <a href="https://github.com/ModuleLoader/es6-module-loader"><code>es6-module-loader</code></a> project provides a polyfill for the ES6 Module Loader implementation. It dynamically loads ES6 modules in browsers and <code>Node.js</code> with support for loading existing and custom module formats through loader hooks.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:SystemJS"><a class="anchor" href="#sec:SystemJS"></a><a class="link" href="#sec:SystemJS">B.3.2.2. SystemJS</a></h5>
+<div class="paragraph">
+<p>Building upon <code>es6-module-loader</code>, <a href="https://github.com/systemjs/systemjs"><code>SystemJS</code></a> supports loading ES6 modules along with <code>AMD</code>, <code>CommonJS</code> and global scripts in the browser and <code>Node.js</code>.</p>
+</div>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title=""></i>
+</td>
+<td class="content">
+In order to use ES6 modules (written in ES6 syntax) the code first needs to be transpiled to ES5. For this purpose, <code>SystemJS</code> provides an option to use <a href="https://github.com/google/traceur-compiler"><code>Traceur</code></a> compiler or <a href="https://babeljs.io/"><code>Babel</code></a>.
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Demo"><a class="anchor" href="#sec:Demo"></a><a class="link" href="#sec:Demo">B.3.2.3. Demo</a></h5>
+<div class="paragraph">
+<p>A demonstration of how to how to use ES6 modules with <code>Babel</code> and <code>SystemJS</code> in <code>Node.js</code> as of today (August 2015).</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Create an ES6 module as shown:</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>export var value = 100; // &lt;--- named export of a variable
+export function inc() { // &lt;--- named export of a function
+    value++;
+}</code></pre>
+</div>
+</div>
+</li>
+<li>
+<p>Import the bindings from the module as shown:</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import {value, inc} from "src"
+
+var importedValue = value; // &lt;--- using the imported value
+inc(); // &lt;--- using the imported function</code></pre>
+</div>
+</div>
+</li>
+<li>
+<p>Transpile these two files using <code>Babel</code> to ES5 with the target module format as <code>system</code>, as shown:</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>$ babel &lt;inputdir&gt; --out-dir &lt;outputdir&gt; --modules system</code></pre>
+</div>
+</div>
+</li>
+<li>
+<p>The transpiled output should be resemble the following:</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>System.register([], function (_export) {
+    "use strict";
+
+    var value;
+
+    _export("inc", inc);
+
+    function inc() {
+        _export("value", value += 1);
+    }
+
+    return {
+        setters: [],
+        execute: function () {
+            value = 100;
+
+            _export("value", value);
+        }
+    };
+});</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>System.register(["src"], function (_export) {
+  "use strict";
+
+  var value, inc, importedValue;
+  return {
+    setters: [function (_src) {
+      value = _src.value;
+      inc = _src.inc;
+    }],
+    execute: function () {
+      importedValue = value;
+      inc();
+    }
+  };
+});</code></pre>
+</div>
+</div>
+</li>
+<li>
+<p>Finally run the above transpiled files, as shown:</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>var System = require('systemjs'); // &lt;--- Require SystemJS
+System.transpiler = 'babel'; // &lt;--- Configure SystemJS
+
+System.import('main'); // &lt;--- Import the transpiled "main" module.</code></pre>
+</div>
+</div>
+</li>
+</ol>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2 language-typescript">
+<h3 id="case-study-typescript"><a class="anchor" href="#case-study-typescript"></a><a class="link" href="#case-study-typescript">B.4. Case Study : TypeScript</a></h3>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title=""></i>
+</td>
+<td class="content">
+<a id="sec:Case_Study___TypeScript"></a> This section is NOT an exhaustive introduction to Microsoft’s <code>TypeScript</code>, but a narrowed down analysis of certain aspects of <code>TypeScript</code>.
+</td>
+</tr>
+</table>
+</div>
+<div class="sect3">
+<h4 id="sec:ES6_Modules_Support"><a class="anchor" href="#sec:ES6_Modules_Support"></a><a class="link" href="#sec:ES6_Modules_Support">B.4.1. ES6 Modules Support</a></h4>
+<div class="paragraph">
+<p><code>TypeScript</code> language has recently added support for ES6 modules. From the <a href="https://github.com/Microsoft/TypeScript/wiki/What%27s-new-in-TypeScript#es6-modules">wiki</a> :</p>
+</div>
+<div class="quoteblock">
+<blockquote>
+<div class="paragraph">
+<p><code>TypeScript</code> 1.5 supports <code>ECMAScript 6</code> (ES6) modules. ES6 modules are effectively <code>TypeScript</code> external modules with a new syntax: ES6 modules are separately loaded source files that possibly import other modules and provide a number of externally accessible exports. ES6 modules feature several new export and import declarations.</p>
+</div>
+</blockquote>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:TypeScript_and_Module_Loading"><a class="anchor" href="#sec:TypeScript_and_Module_Loading"></a><a class="link" href="#sec:TypeScript_and_Module_Loading">B.4.2. TypeScript and Module Loading</a></h4>
+<div class="paragraph">
+<p><code>TypeScript</code> does not concern itself with providing a module loader. It is the responsibility of the host environment. However <code>TypeScript</code>’s compiler provides options to transpile the modules to different formats like <code>AMD</code>, <code>CommonJS</code>, <code>ES6</code> etc. It is the developer’s responsibility to choose an appropriate format and then use the modules with a correct module loader.</p>
+</div>
+<div class="paragraph">
+<p>From the <a href="https://github.com/Microsoft/TypeScript/issues/2242">wiki</a> again :</p>
+</div>
+<div class="quoteblock">
+<blockquote>
+<div class="paragraph">
+<p>TypeScript supports down-level compilation of external modules using the new ES6 syntax. When compiling with <code>-t ES3</code> or <code>-t ES5</code> a module format must be chosen using <code>-m CommonJS</code> or <code>-m AMD</code>. When compiling with <code>-t ES6</code> the module format is implicitly assumed to be <code>ECMAScript 6</code> and the compiler simply emits the original code with type annotations removed. When compiling down-level for <code>CommonJS</code> or <code>AMD</code>, named exports are emitted as properties on the loader supplied exports instance. This includes default exports which are emitted as assignments to exports.default.</p>
+</div>
+</blockquote>
+</div>
+<div class="paragraph">
+<p>Consider the following module <code>src.ts</code> :</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>export var value = 100; //&lt;--- ES6 syntax
+
+export function inc() {  //&lt;--- ES6 syntax
+    value++;
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Compiling it to <code>SystemJS</code> format produces :</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>System.register([], function(exports_1) {
+    var value;
+    function inc() {
+        (exports_1("value", ++value) - 1);
+    }
+    exports_1("inc", inc);
+    return {
+        setters:[],
+        execute: function() {
+            exports_1("value", value = 100); //&lt;--- ES6 syntax
+        }
+    }
+});</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Compiling it to <code>CommonJS</code> format produces :</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>exports.value = 100; //&lt;--- ES6 syntax
+function inc() {
+    exports.value++;
+}
+exports.inc = inc;</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Compiling it to <code>AMD</code> format produces :</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>define(["require", "exports"], function (require, exports) {
+    exports.value = 100; //&lt;--- ES6 syntax
+    function inc() {
+        exports.value++;
+    }
+    exports.inc = inc;
+});</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Compiling it to <code>UMD</code> format produces :</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>(function (deps, factory) {
+    if (typeof module === 'object' &amp;&amp; typeof module.exports === 'object') {
+        var v = factory(require, exports); if (v !== undefined) module.exports = v;
+    }
+    else if (typeof define === 'function' &amp;&amp; define.amd) {
+        define(deps, factory);
+    }
+})(["require", "exports"], function (require, exports) {
+    exports.value = 100; //&lt;--- ES6 syntax
+    function inc() {
+        exports.value++;
+    }
+    exports.inc = inc;
+});</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>NOTE :</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Visual Studio 2015 does not <a href="http://visualstudio.uservoice.com/forums/121579-visual-studio/suggestions/7017377-support-for-es6-modules">support</a> ES6 modules at this time.</p>
+</li>
+<li>
+<p><code>SystemJS</code> supports <code>TypeScript</code> as a compiler. This implies <code>TypeScript</code> modules can be transpiled to be used with <code>SystemJS</code> as the module loader.</p>
+</li>
+</ol>
+</div>
+</div>
+</div>
+<div class="sect2 language-js">
+<h3 id="sec:Cyclic_Dependencies"><a class="anchor" href="#sec:Cyclic_Dependencies"></a><a class="link" href="#sec:Cyclic_Dependencies">B.5. Cyclic Dependencies</a></h3>
+<div class="paragraph">
+<p>To better analyse and evaluate <code>SystemJS</code> module loader and different module formats, let’s look at a cyclic dependency example from a (extremely simplified) stdlib task <code>FixedPoint6</code>. The outline for the example is :</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Prepare 2 ES6 modules with a circular dependency.</p>
+</li>
+<li>
+<p>Then transpile these modules to different module formats (e.g. <code>AMD</code>, &amp; <code>SystemJS</code>).</p>
+</li>
+<li>
+<p>With <code>SystemJS</code> as the module loader, execute the test for every transpiled module format.</p>
+</li>
+</ol>
+</div>
+<div class="sect3">
+<h4 id="sec:Setup"><a class="anchor" href="#sec:Setup"></a><a class="link" href="#sec:Setup">B.5.1. Setup</a></h4>
+<div class="paragraph">
+<p>Consider the following ES6 listings:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>RoundingMode</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>export default {
+    FLOOR : "FLOOR",
+    CEILING : "CEILING"
+}</code></pre>
+</div>
+</div>
+</li>
+<li>
+<p>MathContext</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import { default as FixedPoint6 } from "FixedPoint6";
+import { default as RoundingMode } from "RoundingMode";
+
+let MathContext = class {
+    constructor(mode) {
+        this.mode = mode;
+    }
+
+    divide(fp1, fp2) {
+        var quotient = FixedPoint6.getQuotient(fp1, fp2);
+
+        if(this.mode === RoundingMode.CEILING) {
+            return new FixedPoint6(Math.ceil(quotient));
+        } else if(this.mode === RoundingMode.FLOOR) {
+            return new FixedPoint6(Math.floor(quotient));
+        } else {
+            throw new Error("Incorrect RoundingMode");
+        }
+    }
+}
+
+MathContext.FLOOR = new MathContext(RoundingMode.FLOOR);
+MathContext.CEILING = new MathContext(RoundingMode.CEILING);
+
+export default MathContext;</code></pre>
+</div>
+</div>
+</li>
+<li>
+<p>FixedPoint6</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import { default as MathContext } from "MathContext";
+
+export default class FixedPoint6 {
+    constructor(number) {
+        this.value = number;
+    }
+
+    static getQuotient(fp1, fp2) {
+        return fp1.value/fp2.value;
+    }
+
+    divide(fp) {
+        return FixedPoint6.defaultContext.divide(this, fp);
+    }
+}
+
+FixedPoint6.defaultContext = MathContext.FLOOR;</code></pre>
+</div>
+</div>
+</li>
+<li>
+<p>Test</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import { default as FixedPoint6 } from "FixedPoint6";
+import { default as MathContext } from "MathContext";
+import { default as RoundingMode } from 'RoundingMode';
+
+var fp1 = new FixedPoint6(20.5);
+var fp2 = new FixedPoint6(10);
+
+var fp3 = fp1.divide(fp2);
+console.log(fp1, fp2, fp3);</code></pre>
+</div>
+</div>
+</li>
+<li>
+<p>Runner : This is the runner file to execute the test (after transpilation).</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>var System = require('systemjs');
+System.transpiler = 'babel';
+
+System.config({
+    baseURL: './build',
+    "paths": {
+        "*": "*.js"
+    }
+});
+
+System.import('test').catch(function(e) {
+    console.log(e);
+})</code></pre>
+</div>
+</div>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>Clearly <code>MathContext</code> &amp; <code>FixedPoint6</code> have a circular dependency upon each other.</p>
+</div>
+</div>
+<div class="sect3 language-js">
+<h4 id="sec:Transpile_and_Execute"><a class="anchor" href="#sec:Transpile_and_Execute"></a><a class="link" href="#sec:Transpile_and_Execute">B.5.2. Transpile and Execute</a></h4>
+<div class="paragraph">
+<p>Transpile the above setup to different formats and execute the code using <code>SystemJS</code> module loader :</p>
+</div>
+<div class="sect4">
+<h5 id="sec:Module_Format___AMD"><a class="anchor" href="#sec:Module_Format___AMD"></a><a class="link" href="#sec:Module_Format___AMD">B.5.2.1. Module Format = AMD</a></h5>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Compile the previous set up using <code>babel</code> as the transpiler with <code>AMD</code> modules :</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>babel src -w --out-dir build --modules amd</code></pre>
+</div>
+</div>
+</li>
+<li>
+<p>Run the transpiled <code>test.js</code> with :</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>node runner.js</code></pre>
+</div>
+</div>
+</li>
+<li>
+<p>The execution would fail with an error like the following :</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>Error: _FixedPoint62.default.getQuotient is not a function</code></pre>
+</div>
+</div>
+</li>
+</ol>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Module_Format___CommonJS"><a class="anchor" href="#sec:Module_Format___CommonJS"></a><a class="link" href="#sec:Module_Format___CommonJS">B.5.2.2. Module Format = CommonJS</a></h5>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Compile the previous set up using <code>babel</code> as the transpiler with <code>CommonJS</code> modules :</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>babel src -w --out-dir build --modules common</code></pre>
+</div>
+</div>
+</li>
+<li>
+<p>Run the transpiled <code>test.js</code> with :</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>node runner.js</code></pre>
+</div>
+</div>
+</li>
+<li>
+<p>The execution is successful and logs the following results :</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>{ value: 20.5 } { value: 10 } { value: 2 }</code></pre>
+</div>
+</div>
+</li>
+</ol>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Module_Format___SystemJS"><a class="anchor" href="#sec:Module_Format___SystemJS"></a><a class="link" href="#sec:Module_Format___SystemJS">B.5.2.3. Module Format = SystemJS</a></h5>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Compile the previous set up using <code>babel</code> as the transpiler with <code>SystemJS</code> modules :</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>babel src -w --out-dir build --modules system</code></pre>
+</div>
+</div>
+</li>
+<li>
+<p>Run the transpiled <code>test.js</code> with :</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>node runner.js</code></pre>
+</div>
+</div>
+</li>
+<li>
+<p>The execution is successful and logs the following results :</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>{ value: 20.5 } { value: 10 } { value: 2 }</code></pre>
+</div>
+</div>
+</li>
+</ol>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Conclusion"><a class="anchor" href="#sec:Conclusion"></a><a class="link" href="#sec:Conclusion">B.5.3. Conclusion</a></h4>
+<div class="paragraph">
+<p>As observed, the test is executed successfully with <code>CommonJS</code> &amp; <code>SystemJS</code> module formats. It however fails with <code>AMD</code> format (due to the circular dependency).</p>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="system.register-as-transpilation-target"><a class="anchor" href="#system.register-as-transpilation-target"></a><a class="link" href="#system.register-as-transpilation-target">B.6. System.register as transpilation target</a></h3>
+<div class="paragraph">
+<p>In order to integrate <code>SystemJS</code> as the module loader, the recommended module format is <code>System.register</code>. This section serves as a guide (&amp; implementation hint) to transpile N4JS modules with <code>System.register</code> as the module format.</p>
+</div>
+<div class="sect3">
+<h4 id="sec:Introduction"><a class="anchor" href="#sec:Introduction"></a><a class="link" href="#sec:Introduction">B.6.1. Introduction</a></h4>
+<div class="paragraph">
+<p>This format is best explained from its <a href="https://github.com/ModuleLoader/es6-module-loader/blob/master/docs/system-register.md">documentation</a> :</p>
+</div>
+<div class="quoteblock">
+<blockquote>
+<div class="paragraph">
+<p>System.register can be considered as a new module format designed to support the exact semantics of ES6 modules within ES5. It is a format that was developed out of collaboration and is supported as a module output in Traceur (as instantiate), Babel and TypeScript (as system). All dynamic binding and circular reference behaviors supported by ES6 modules are supported by this format. In this way it acts as a safe and comprehensive target format for the polyfill path into ES6 modules.</p>
+</div>
+<div class="paragraph">
+<p>To run the format, a suitable loader implementation needs to be used that understands how to execute it. Currently these include SystemJS, SystemJS Self-Executing Bundles and ES6 Micro Loader. The ES6 Module Loader polyfill also uses this format internally when transpiling and executing ES6.</p>
+</div>
+</blockquote>
+</div>
+<div class="paragraph">
+<p>The <code>System.register</code> format is not very well documented. However, this format is supported by all major transpilers out there i.e. <code>BabelJS</code>, <code>Traceur</code> &amp; <code>TypeScript</code> transpilers. In fact, the primary resource of this documentation has been the outputs generated by these transpilers.</p>
+</div>
+<div class="sect4">
+<h5 id="sec:External_Transpilers"><a class="anchor" href="#sec:External_Transpilers"></a><a class="link" href="#sec:External_Transpilers">B.6.1.1. External Transpilers</a></h5>
+<div class="paragraph">
+<p>In order to follow along, it will be best to try out different ES6 syntax being transpiled to <code>System.register</code> format by these transpilers.</p>
+</div>
+<div class="paragraph">
+<p>The following instructions will be useful :</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Transpile with Traceur</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-bash" data-lang="bash">traceur --dir &lt;SOURCE_DIR&gt; &lt;OUTPUT_DIR&gt; --experimental --modules=instantiate</code></pre>
+</div>
+</div>
+</li>
+<li>
+<p>Transpile with Babel</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-bash" data-lang="bash">babel &lt;SOURCE_DIR&gt; --out-dir &lt;OUTPUT_DIR&gt; --modules system</code></pre>
+</div>
+</div>
+</li>
+<li>
+<p>Transpile with TypeScript</p>
+<div class="paragraph">
+<p>Create a file by the name of <code>tsconfig.json</code> in the project folder, with the following contents :</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-json" data-lang="json">{
+    "compilerOptions": {
+        "module": "system",
+        "target": "ES5",
+        "outDir": &lt;OUTPUT_DIR&gt;,
+        "rootDir": &lt;SOURCE_DIR&gt;
+    }
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Then transpile with :</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-javascript" data-lang="javascript">tsc</code></pre>
+</div>
+</div>
+</li>
+</ol>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Example_of_a_System_register_module"><a class="anchor" href="#sec:Example_of_a_System_register_module"></a><a class="link" href="#sec:Example_of_a_System_register_module">B.6.1.2. Example of a System.register module</a></h5>
+<div class="paragraph">
+<p>For the following ES6 code :</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-javascript" data-lang="javascript">import { p as q } from './dep';
+
+var s = 'local';
+
+export function func() {
+    return q;
+}
+
+export class C {}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>The <code>Babel</code> transpiler generates the following code (w/ <code>System.register</code> format):</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-javascript" data-lang="javascript">System.register(['./dep'], function (_export) {
+    'use strict';
+
+    var q, s, C;
+
+    _export('func', func);
+
+    function _classCallCheck(instance, Constructor) { .. }
+
+    function func() {
+        return q;
+    }
+
+    return {
+        setters: [function (_dep) {
+            q = _dep.p;
+        }],
+        execute: function () {
+            s = 'local';
+
+            C = function C() {
+                _classCallCheck(this, C);
+            };
+
+            _export('C', C);
+        }
+    };
+});</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Structure_of_a_System_register_module"><a class="anchor" href="#sec:Structure_of_a_System_register_module"></a><a class="link" href="#sec:Structure_of_a_System_register_module">B.6.2. Structure of a System.register module</a></h4>
+<div class="paragraph">
+<p>Broadly speaking, a <code>System.register</code> module has the following structure :</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-javascript" data-lang="javascript">System.register(&lt;&lt;DEPENDENCIES ARRAY&gt;&gt;, function(&lt;&lt;exportFn&gt;&gt;) {
+    &lt;&lt;DECLARATION SCOPE&gt;&gt;
+
+    return {
+        setters: &lt;&lt;SETTERS ARRAY&gt;&gt;,
+        execute: function() {
+            &lt;&lt;EXECUTABLES&gt;&gt;
+        }
+    };
+});</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Highlights :</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>System.register(&#8230;&#8203;)</code> is called with 2 arguments :</p>
+<div class="ulist">
+<ul>
+<li>
+<p><code>&lt;&lt;DEPENDENCIES ARRAY&gt;&gt;</code> : an array of dependencies (similar to <code>AMD</code>) extracted from the <code>ES6 import</code> statements.</p>
+</li>
+<li>
+<p>a function (<code>FN</code>) :</p>
+<div class="ulist">
+<ul>
+<li>
+<p>accepts a parameter called <code>&lt;&lt;exportFn&gt;&gt;</code>. This <code>&lt;&lt;exportFn&gt;&gt;</code> (provided by <code>SystemJS</code>) keeps a track of all the exports of this module &amp; will inform all the importing modules of any changes.</p>
+</li>
+<li>
+<p>contains a <code>&lt;&lt;DECLARATION SCOPE&gt;&gt;</code> where all the functions and variables (from the source code) get hoisted to.</p>
+</li>
+<li>
+<p>returns an object with 2 properties :</p>
+<div class="ulist">
+<ul>
+<li>
+<p><code>setters</code> : The <code>&lt;&lt;SETTERS ARRAY&gt;&gt;</code> is simply an array of functions. Each of these functions represents the imported-bindings from the <code>&lt;&lt;DEPENDENCIES ARRAY&gt;&gt;</code>. The <code>&lt;&lt;SETTERS ARRAY&gt;&gt;</code> and <code>&lt;&lt;DEPENDENCIES ARRAY&gt;&gt;</code> follow the same order.</p>
+</li>
+<li>
+<p><code>execute</code> : <code>&lt;&lt;EXECUTABLES&gt;&gt;</code> is the rest of the body of the source code.</p>
+</li>
+</ul>
+</div>
+</li>
+</ul>
+</div>
+</li>
+</ul>
+</div>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_transpilation-hints"><a class="anchor" href="#_transpilation-hints"></a><a class="link" href="#_transpilation-hints">B.6.3. Transpilation Hints</a></h4>
+<div class="paragraph">
+<p>By observing the existing transpilers’ output, this sub-section provides insights into the process of transpiling to this format :</p>
+</div>
+<div class="sect4">
+<h5 id="sec:Handling_Imports"><a class="anchor" href="#sec:Handling_Imports"></a><a class="link" href="#sec:Handling_Imports">B.6.3.1. Handling Imports</a></h5>
+<div class="paragraph">
+<p>The following are ES6 code snippets with some <code>import</code> statements :</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Simple Import Statement</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-javascript" data-lang="javascript">import {b1} from 'B';</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>A valid <code>System.register</code> output for this snippet would look like :</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>System.register(['B'], function (&lt;&lt;exportFn&gt;&gt;) { //(1.)
+
+  var b1;  //(2.)
+
+  return {
+
+    //(3.)
+    setters: [function (_B) {
+      b1 = _B.b1; //(4.)
+    }],
+
+    execute: function () {}
+  };
+});</code></pre>
+</div>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+highlights
+</td>
+<td class="hdlist2">
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>The <code>&lt;&lt;DEPENDENCIES ARRAY&gt;&gt;</code> is just <code>[’B’]</code>.</p>
+</li>
+<li>
+<p>The <code>&lt;&lt;DECLARATION SCOPE&gt;&gt;</code> simply declares the imported binding <code>v1</code> as a variable.</p>
+</li>
+<li>
+<p>The <code>&lt;&lt;SETTERS ARRAY&gt;&gt;</code> has 1 function. This function corresponds to the single dependency (<code>’B’</code>) from (1.)</p>
+</li>
+<li>
+<p>The setter function accepts one argument (the exported object from <code>’B’</code> as <code>_B</code> . It then sets the local binding (i.e. local variable <code>v1</code>) to <code>_B.b1</code>.</p>
+</li>
+</ol>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Takeaway
+</td>
+<td class="hdlist2">
+<div class="ulist">
+<ul>
+<li>
+<p>An <code>import</code> statement is broken down into <code>&lt;&lt;DEPENDENCIES ARRAY&gt;&gt;</code> &amp; <code>&lt;&lt;SETTERS ARRAY&gt;&gt;</code>.</p>
+</li>
+<li>
+<p>Whenever the value of <code>b1</code> inside <code>B</code> is changed, <code>SystemJS</code> will execute the corresponding <code>setter function</code> in this module i.e. the 1st function in this case.</p>
+</li>
+</ul>
+</div>
+</td>
+</tr>
+</table>
+</div>
+</li>
+<li>
+<p>Multiple Import Statements</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import { a1 as a0 } from 'A';
+import {b1} from 'B';
+import { c1 as c0 } from 'C';
+import {b2, b3} from 'B';
+import {default} from 'C';
+import {a2} from 'A';</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>A valid <code>System.register</code> output for this snippet would look like :</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>System.register(['A', 'B', 'C'], function (&lt;&lt;exportFn&gt;&gt;) { //(1.)
+
+  var a0, a2, b1, b2, b3, c0, default;  //(2.)
+
+  return {
+
+    //(3.)
+    setters: [function (_A) {
+      a0 = _A.a1;         //(4.1.)
+      a2 = _A.a2;         //(4.2.)
+    }, function (_B) {
+      b1 = _B.b1;
+      b2 = _B.b2;
+      b3 = _B.b3;
+    }, function (_C) {
+      c0 = _C.c1;
+      default = _C['default'];
+    }],
+
+
+    execute: function () {}
+  };
+});</code></pre>
+</div>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+highlights
+</td>
+<td class="hdlist2">
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>The <code>&lt;&lt;DEPENDENCIES ARRAY&gt;&gt;</code> is now a unique array <code>[’A’, ’B’, ’C’]</code>. Note that there are no duplicates.</p>
+</li>
+<li>
+<p>The <code>&lt;&lt;DECLARATION SCOPE&gt;&gt;</code> simply declares all the imported bindings as variables.</p>
+</li>
+<li>
+<p>The <code>&lt;&lt;SETTERS ARRAY&gt;&gt;</code> now has 3 functions. These 3 functions match the ordering of the <code>&lt;&lt;DEPENDENCIES ARRAY&gt;&gt;</code>.</p>
+</li>
+<li>
+<p>The setter function accepts one argument (the exported object from the dependency) It then sets the local bindings (i.e. local variables) from the exported value of the dependency.</p>
+</li>
+</ol>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Takeaway
+</td>
+<td class="hdlist2">
+<div class="ulist">
+<ul>
+<li>
+<p>Whenever an exported value from <code>A</code> is changed, <code>SystemJS</code> will execute the first <code>setter function</code> in this module.</p>
+</li>
+<li>
+<p>Whenever an exported value from <code>B</code> is changed, <code>SystemJS</code> will execute the second <code>setter function</code> in this module.</p>
+</li>
+<li>
+<p>Whenever an exported value from <code>C</code> is changed, <code>SystemJS</code> will execute the third <code>setter function</code> in this module.</p>
+</li>
+</ul>
+</div>
+</td>
+</tr>
+</table>
+</div>
+</li>
+</ol>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:__exportFn__"><a class="anchor" href="#sec:__exportFn__"></a><a class="link" href="#sec:__exportFn__">B.6.3.2. &lt;&lt;exportFn&gt;&gt;</a></h5>
+<div class="paragraph">
+<p>Before moving on to handling exports, let’s focus on the SystemJS provided <code>&lt;&lt;exportFn&gt;&gt;</code>.</p>
+</div>
+<div class="paragraph">
+<p>This function looks similar to the following :</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>function (name, value) {     //(1.)
+      module.locked = true;
+
+      if (typeof name == 'object') {
+        for (var p in name)
+          exports[p] = name[p];      //(2.1.)
+      }
+      else {
+        exports[name] = value;      //(2.2.)
+      }
+
+      for (var i = 0, l = module.importers.length; i &lt; l; i++) {
+        var importerModule = module.importers[i];
+        if (!importerModule.locked) {
+          var importerIndex = indexOf.call(importerModule.dependencies, module);
+          importerModule.setters[importerIndex](exports);     //(3.)
+        }
+      }
+
+      module.locked = false;
+      return value; //(4.)
+}</code></pre>
+</div>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+highlights
+</td>
+<td class="hdlist2">
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>The <code>&lt;&lt;exportFn&gt;&gt;</code> takes 2 arguments : <code>name</code> &amp; <code>value</code>.</p>
+</li>
+<li>
+<p>It maintains an <code>exports</code> object with <code>name</code> &amp; <code>value</code>.</p>
+</li>
+<li>
+<p>For every module which imports the current module, it executes the corresponding <code>setter function</code>.</p>
+</li>
+<li>
+<p>It returns the <code>value</code>.</p>
+</li>
+</ol>
+</div>
+</td>
+</tr>
+</table>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Takeaway
+</td>
+<td class="hdlist2">
+<p>This <code>&lt;&lt;exportFn&gt;&gt;</code> is responsible for pushing the changes from a module to every importing module thereby implementing the live binding.</p>
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Handling_Exports"><a class="anchor" href="#sec:Handling_Exports"></a><a class="link" href="#sec:Handling_Exports">B.6.3.3. Handling Exports</a></h5>
+<div class="paragraph">
+<p>Now let’s focus on handling <code>export</code> statements.</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Simple Exports Statement</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>export var v =1;
+export function f(){}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>A valid <code>System.register</code> output for this snippet would look like :</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>System.register([], function (_export) {  //(1.)
+
+   //(2.)
+  var v;
+  function f() {}
+
+  _export("f", f); //(4.1)
+
+  return {
+    setters: [],
+
+    //(3.)
+    execute: function () {
+      v = 1;  //(3.1.)
+
+      _export("v", v); //(4.2.)
+    }
+  };
+});</code></pre>
+</div>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+highlights
+</td>
+<td class="hdlist2">
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>The <code>&lt;&lt;exportFn&gt;&gt;</code> is named to as <code>_export</code>. (This is an implementation decision by Babel.) The name should be unique to not conflict with any user-defined variable/function names.</p>
+</li>
+<li>
+<p>The <code>&lt;&lt;DECLARATION SCOPE&gt;&gt;</code> hoists the exported variable <code>v</code> and the function <code>f</code>.</p>
+</li>
+<li>
+<p>The <code>&lt;&lt;EXECUTABLES&gt;&gt;</code> zone now contains the executable code from the source module.</p>
+</li>
+<li>
+<p>Initialise the variable <code>v1</code> with the value extracted from the source. This essentially is the executable part of the module.</p>
+</li>
+<li>
+<p>The <code>export</code> function expression results in a call to the <code>_exports</code> function as: <code>_export(f, f)</code></p>
+</li>
+<li>
+<p>The <code>export</code> statement results in a call to the <code>_export</code> function as: <code>_export(v, v)</code></p>
+</li>
+</ol>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Takeaway
+</td>
+<td class="hdlist2">
+<div class="ulist">
+<ul>
+<li>
+<p>The module’s exports statements are separated from the hoistable and executable statements.</p>
+</li>
+<li>
+<p>All the exported bindings are tracked by wrapping them inside the <code>&lt;&lt;exportFn&gt;&gt;</code>.</p>
+</li>
+</ul>
+</div>
+</td>
+</tr>
+</table>
+</div>
+</li>
+<li>
+<p>Tracking Exported Bindings</p>
+<div class="paragraph">
+<p>To maintain live bindings, <code>SystemJS</code> needs to track any changes to exported bindings in order to call the <code>setter</code> functions of importing modules. Let’s look at an example for that :</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>export var v1 = 1;
+export var v2 = 2;
+export var v3 = 3;
+export function f() {}
+
+v1++; //(1.)
+++v2; //(2.)
+v3 += 5; //(3.)
+f = null; //(4.)</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p><code>Babel</code> output for this snippet looks like :</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>System.register([], function (_export) {
+
+  var v1, v2, v3;
+
+  _export("f", f);
+
+  function f() {}
+
+  return {
+    setters: [],
+
+    execute: function () {
+      v1 = 1;
+
+      _export("v1", v1);
+
+      v2 = 2;
+
+      _export("v2", v2);
+
+      v3 = 3;
+
+      _export("v3", v3);
+
+      _export("v1", v1 += 1); //(1.)
+      _export("v2", v2 += 1); //(2.)
+      _export("v3", v3 += 5); //(3.)
+      _export("f", f = null); //(4.)
+    }
+  };
+});</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p><code>Traceur</code> output for this snippet looks like :</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>System.register([], function($__export) {
+
+  var v1, v2, v3;
+  function f() {}
+
+  $__export("f", f);
+
+  return {
+    setters: [],
+
+    execute: function() {
+      v1 = 1;
+      $__export("v1", v1);
+      v2 = 2;
+      $__export("v2", v2);
+      v3 = 3;
+      $__export("v3", v3);
+
+      ($__export("v1", v1 + 1), v1++); //(1.)
+      $__export("v2", ++v2); //(2.)
+      $__export("v3", v3 += 5); //(3.)
+      $__export("f", f = null); //(4.)
+    }
+  };
+});</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p><code>TypeScript</code> output for this snippet looks like :</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>System.register([], function(exports_1) {
+    var v1, v2, v3;
+    function f() { }
+
+    exports_1("f", f);
+
+    return {
+        setters:[],
+
+        execute: function() {
+            exports_1("v1", v1 = 1);
+            exports_1("v2", v2 = 2);
+            exports_1("v3", v3 = 3);
+
+            (exports_1("v1", ++v1) - 1); //(1.)
+            exports_1("v2", ++v2); //(2.)
+            exports_1("v3", v3 += 5); //(3.)
+            f = null; //(4.)
+        }
+    }
+});</code></pre>
+</div>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+highlights
+</td>
+<td class="hdlist2">
+<div class="ulist">
+<ul>
+<li>
+<p>The re-assignment of <code>v1, v2, v3 and f</code> is wrapped inside a call to the <code>&lt;&lt;exportFn&gt;&gt;</code> with the updated value.</p>
+</li>
+</ul>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Takeaway
+</td>
+<td class="hdlist2">
+<div class="ulist">
+<ul>
+<li>
+<p>While transpiling we need to detect if any exported binding is reassigned. In that case invoke the <code>&lt;&lt;exportFn&gt;&gt;</code> immediately with the new value.</p>
+</li>
+<li>
+<p>Different transpilers perform different optimization tricks, which may be worth looking at.</p>
+</li>
+</ul>
+</div>
+</td>
+</tr>
+</table>
+</div>
+</li>
+<li>
+<p>Exporting a Class extending an imported Class.</p>
+<div class="paragraph">
+<p>Let’s look at the following class declaration :</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import {A} from "A"; //&lt;-- import class A
+
+export class C extends A {}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p><code>Babel</code> output for this snippet looks like :</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>System.register(["A"], function (_export) {
+
+  var A, C;
+
+  var _get = function get(_x, _x2, _x3) { ... };
+
+  function _classCallCheck(instance, Constructor) { ... }
+
+  function _inherits(subClass, superClass) { ... }
+
+  return {
+    setters: [function (_A2) {
+      A = _A2.A;
+    }],
+
+    execute: function () { //(1.)
+      C = (function (_A) {
+        _inherits(C, _A);
+
+        function C() {
+          _classCallCheck(this, C);
+
+          _get(Object.getPrototypeOf(C.prototype), "constructor", this).apply(this, arguments);
+        }
+
+        return C;
+      })(A);
+
+      _export("C", C);
+    }
+  };
+});</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p><code>Traceur</code> output for this snippet looks like :</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>System.register(["A"], function($__export) {
+  var A, C;
+
+  return {
+    setters: [function($__m) {
+      A = $__m.A;
+    }],
+
+    execute: function() { //(1.)
+      C = $traceurRuntime.initTailRecursiveFunction(function($__super) {
+        return $traceurRuntime.call(function($__super) {
+          function C() {
+            $traceurRuntime.superConstructor(C).apply(this, arguments);
+          }
+          return $traceurRuntime.continuation($traceurRuntime.createClass, $traceurRuntime, [C, {}, {}, $__super]);
+        }, this, arguments);
+      })(A);
+      $__export("C", C);
+    }
+  };
+});</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p><code>TypeScript</code> output for this snippet looks like :</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>System.register(["A"], function(exports_1) {
+    var __extends = function(){ ... }
+    var A_1;
+    var C;
+
+    return {
+        setters:[
+            function (A_1_1) {
+                A_1 = A_1_1;
+            }],
+
+        execute: function() { //(1.)
+            C = (function (_super) {
+                __extends(C, _super);
+                function C() {
+                    _super.apply(this, arguments);
+                }
+                return C;
+            })(A_1.A);
+            exports_1("C", C);
+        }
+    }
+});</code></pre>
+</div>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+highlights
+</td>
+<td class="hdlist2">
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Notice how the construction of class <code>C</code> has now been deferred to the <code>&lt;&lt;EXECUTABLES&gt;&gt;</code> zone. It is because <code>C</code> depends on <code>A</code> being imported first.</p>
+</li>
+</ol>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Takeaway
+</td>
+<td class="hdlist2">
+<div class="ulist">
+<ul>
+<li>
+<p>The <code>&lt;&lt;DECLARATION SCOPE&gt;&gt;</code> is for hoisting only independent entities i.e. the ones that do not depend upon any imports. Everything else is moved to the <code>&lt;&lt;EXECUTABLES&gt;&gt;</code> region.</p>
+</li>
+</ul>
+</div>
+</td>
+</tr>
+</table>
+</div>
+</li>
+</ol>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Examples_w__Circular_Dependencies"><a class="anchor" href="#sec:Examples_w__Circular_Dependencies"></a><a class="link" href="#sec:Examples_w__Circular_Dependencies">B.6.4. Examples w/ Circular Dependencies</a></h4>
+<div class="paragraph">
+<p>This section focuses on circular dependencies. The goal is to see how the transpiled output looks like and if the execution is possible.</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="paragraph">
+<p>Source files:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import B from "B";
+
+export default class A {}
+A.b = new B(); //&lt;---</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import A from "A";
+
+export default class B {}
+B.a = new A(); //&lt;---</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Transpiled Outputs (w/ Babel):<br></p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>System.register(["B"], function (_export) {
+  "use strict";
+
+  var B, A;
+
+  function _classCallCheck(instance, Constructor) {...}
+
+  return {
+    setters: [function (_B) {
+      B = _B["default"];
+    }],
+    execute: function () {
+      A = function A() {
+        _classCallCheck(this, A);
+      };
+
+      _export("default", A);
+
+      A.b = new B();
+    }
+  };
+});</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>System.register(["A"], function (_export) {
+  "use strict";
+
+  var A, B;
+
+  function _classCallCheck(instance, Constructor) {...}
+
+  return {
+    setters: [function (_A) {
+      A = _A["default"];
+    }],
+    execute: function () {
+      B = function B() {
+        _classCallCheck(this, B);
+      };
+
+      _export("default", B);
+
+      B.a = new A();
+    }
+  };
+});</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Execution Result<br></p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>var System = require('systemjs');
+
+System.import('A', 'B').then(function(resp) {
+    var a = new A();
+    var b = new B();
+}).catch(function(e) {
+    console.log(e);
+});</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>Babel : [Error: undefined is not a function]</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="paragraph">
+<p>Source files:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import {B} from "B";
+
+export class A extends B{}</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import {A} from "A";
+
+export class B{}
+class C extends A{}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Transpiled Outputs (w/ Babel) :<br></p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>System.register(["B"], function (_export) {
+  "use strict";
+
+  var B, A;
+
+  var _get = function get(_x, _x2, _x3) { ... };
+
+  function _classCallCheck(instance, Constructor) { ... }
+
+  function _inherits(subClass, superClass) {...}
+
+  return {
+    setters: [function (_B2) {
+      B = _B2.B;
+    }],
+    execute: function () {
+      A = (function (_B) {
+        _inherits(A, _B);
+
+        function A() {
+          _classCallCheck(this, A);
+
+          _get(Object.getPrototypeOf(A.prototype), "constructor", this).apply(this, arguments);
+        }
+
+        return A;
+      })(B);
+
+      _export("A", A);
+    }
+  };
+});</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>System.register(["A"], function (_export) {
+  "use strict";
+
+  var A, B, C;
+
+  var _get = function get(_x, _x2, _x3) { ... };
+
+  function _inherits(subClass, superClass) { ... }
+
+  function _classCallCheck(instance, Constructor) { ... }
+
+  return {
+    setters: [function (_A2) {
+      A = _A2.A;
+    }],
+    execute: function () {
+      B = function B() {
+        _classCallCheck(this, B);
+      };
+
+      _export("B", B);
+
+      C = (function (_A) {
+        _inherits(C, _A);
+
+        function C() {
+          _classCallCheck(this, C);
+
+          _get(Object.getPrototypeOf(C.prototype), "constructor", this).apply(this, arguments);
+        }
+
+        return C;
+      })(A);
+    }
+  };
+});</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Execution Result<br></p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>var System = require('systemjs');
+
+System.import('A','B').then(function(resp) {
+    var a = new A();
+}).catch(function(e) {
+    console.log(e);
+});</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>TypeScript : [Error: Cannot read property 'prototype' of undefined]
+Babel : [Error: Super expression must either be null or a function, not undefined]</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="paragraph">
+<p>Source files:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import B from "B";
+
+class A extends B {}
+export default class X {}</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import X from "A";
+
+export default class B {}
+class Y extends X {}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Transpiled Outputs (w/ Babel):<br></p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>System.register(["B"], function (_export) {
+  "use strict";
+
+  var B, A, X;
+
+  var _get = function get(_x, _x2, _x3) { ... };
+
+  function _classCallCheck(instance, Constructor) { ... }
+
+  function _inherits(subClass, superClass) { ... }
+
+  return {
+    setters: [function (_B2) {
+      B = _B2["default"];
+    }],
+    execute: function () {
+      A = (function (_B) {
+        _inherits(A, _B);
+
+        function A() {
+          _classCallCheck(this, A);
+
+          _get(Object.getPrototypeOf(A.prototype), "constructor", this).apply(this, arguments);
+        }
+
+        return A;
+      })(B);
+
+      X = function X() {
+        _classCallCheck(this, X);
+      };
+
+      _export("default", X);
+    }
+  };
+});</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>System.register(["A"], function (_export) {
+  "use strict";
+
+  var X, B, Y;
+
+  var _get = function get(_x, _x2, _x3) { ... };
+
+  function _inherits(subClass, superClass) { ... }
+
+  function _classCallCheck(instance, Constructor) { ... }
+
+  return {
+    setters: [function (_A) {
+      X = _A["default"];
+    }],
+    execute: function () {
+      B = function B() {
+        _classCallCheck(this, B);
+      };
+
+      _export("default", B);
+
+      Y = (function (_X) {
+        _inherits(Y, _X);
+
+        function Y() {
+          _classCallCheck(this, Y);
+
+          _get(Object.getPrototypeOf(Y.prototype), "constructor", this).apply(this, arguments);
+        }
+
+        return Y;
+      })(X);
+    }
+  };
+});</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Execution Result<br></p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>var System = require('systemjs');
+
+System.import('A').then(function(resp) {
+    var a = new A();
+}).catch(function(e) {
+    console.log(e);
+});</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>TypeScript : [Error: Cannot read property 'prototype' of undefined]
+Babel : [[Error: Super expression must either be null or a function, not undefined]]</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:N4JS_Examples_w__Circular_Dependencies"><a class="anchor" href="#sec:N4JS_Examples_w__Circular_Dependencies"></a><a class="link" href="#sec:N4JS_Examples_w__Circular_Dependencies">B.6.5. N4JS Examples w/ Circular Dependencies</a></h4>
+<div class="paragraph">
+<p>In order to improve our precision in conversing and discussing about different kinds of circular dependencies, this section provides the most basic examples of different kinds.</p>
+</div>
+<div class="sect4">
+<h5 id="sec:Unresolved_Cyclic_Dependencies"><a class="anchor" href="#sec:Unresolved_Cyclic_Dependencies"></a><a class="link" href="#sec:Unresolved_Cyclic_Dependencies">B.6.5.1. Unresolved Cyclic Dependencies</a></h5>
+<div class="paragraph">
+<p>Below examples demonstrate cases when cyclic dependency cannot be resolved at all and will cause runtime errors.</p>
+</div>
+<div class="exampleblock">
+<div class="title">Example 5. Circular dependency resolution 1</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import b from "B"
+
+export public var number a = 1;
+export public var number a2 = b + 1;</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import a from "A"
+
+export public var number b = a + 1;</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import a2 from "A"
+console.log(a2); //&lt;-- should be 3. not NaN.</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="exampleblock">
+<div class="title">Example 6. Circular dependency resolution 2</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import B from "B"
+
+export public class A {
+    static a = B.b + 1;
+}</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import A from "A"
+export public class B {
+    static b = 1;
+}
+export public class B2 {
+    static b2 = A.a;
+}</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import B2 from "B"
+console.log(B2.b2); //should log 2</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="exampleblock">
+<div class="title">Example 7. Circular dependency resolution 3</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import B from "B"
+export public class A {
+    B b = new B();
+}</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import A from "A"
+export public class B {
+    A a = new A();
+}</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import A from "A"
+new A(); // should not cause a runtime error.</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Variables___Functions"><a class="anchor" href="#sec:Variables___Functions"></a><a class="link" href="#sec:Variables___Functions">B.6.5.2. Examples with Variables &amp; Functions</a></h5>
+<div class="exampleblock">
+<div class="title">Example 8. Circular dependency resolution 4</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import b_fun from "B"
+
+export public var a2 = b_fun();
+export public var a = 1;</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import a from "A"
+
+export public function b_fun() {
+    return a + 1;
+}</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import a2 from "A"
+console.log(a2); //&lt;-- should be 2. not NaN.</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Classes"><a class="anchor" href="#sec:Classes"></a><a class="link" href="#sec:Classes">B.6.5.3. Examples with Classes</a></h5>
+<div class="exampleblock">
+<div class="title">Example 9. Circular dependency resolution 5</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import B from "B"
+export public class A {
+    static a1 = 1;
+    static a2 = B.b1;
+}</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import A from "A"
+export public class B {
+    static b1 = A.a1;
+}</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import A from "A"
+console.log(A.a1); //should log 1. not an error.</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="exampleblock">
+<div class="title">Example 10. Circular dependency resolution 6</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import B from "B"
+export public class A {
+    static a1 = 1;
+    static a2 = B.b1;
+}</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import A from "A"
+export public class B {
+    static b1 = -1;
+    static b2 = A.a1;
+}</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import A from "A"
+console.log(A.a1);//should log 1. not an error.</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="exampleblock">
+<div class="title">Example 11. Circular dependency resolution 7</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import B from "B"
+export public class A {
+    static a = new B();
+}</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import A from "A"
+export public class B {
+    static b = new A();
+}</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import A from "A"
+new A(); //should succeed.</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Examples_with_SubClassing"><a class="anchor" href="#sec:Examples_with_SubClassing"></a><a class="link" href="#sec:Examples_with_SubClassing">B.6.5.4. Examples with SubClassing</a></h5>
+<div class="exampleblock">
+<div class="title">Example 12. Circular dependency resolution 8</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import B from "B"
+export public class A {}
+export public class C extends B {}</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import A from "A"
+export public class B extends A{}</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import C from "A"
+new C();//should succeed.</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="exampleblock">
+<div class="title">Example 13. Circular dependency resolution 9</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import B from "B"
+export public class A {}
+export public class C {
+    c = new B();
+}</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import A from "A"
+export public class B extends A{}</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import C from "A"
+new C(); //should succeed.</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Miscellaneous"><a class="anchor" href="#sec:Miscellaneous"></a><a class="link" href="#sec:Miscellaneous">B.6.5.5. Miscellaneous</a></h5>
+<div class="exampleblock">
+<div class="title">Example 14. Circular dependency resolution 10</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import B from "B"
+export public class A {}
+new B();</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import A from "A"
+export public class B {}
+new A();</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import A from "A"
+new A() //should succeed.</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="exampleblock">
+<div class="title">Example 15. Circular dependency resolution 11</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import B from "B"
+export public class A {}
+B.b1;</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import A from "A"
+export public class B {
+    static b1;
+}
+new A();</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import A from "A"
+new A() //should succeed.</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_resources"><a class="anchor" href="#_resources"></a><a class="link" href="#_resources">B.6.6. Resources</a></h4>
+<div class="paragraph">
+<p><a href="https://github.com/ModuleLoader/es6-module-loader/blob/master/docs/system-register.md">Wiki</a></p>
+</div>
+</div>
+</div>
+<div class="sect2 language-js">
+<h3 id="sec:CommonJS_as_transpilation_target"><a class="anchor" href="#sec:CommonJS_as_transpilation_target"></a><a class="link" href="#sec:CommonJS_as_transpilation_target">B.7. CommonJS as transpilation target</a></h3>
+<div class="paragraph">
+<p>To provide better compatibility with <code>npm</code> eco-system, we want to transpile <code>N4JS</code> code to <code>CommonJS</code> module format.</p>
+</div>
+<div class="sect3">
+<h4 id="_introduction-2"><a class="anchor" href="#_introduction-2"></a><a class="link" href="#_introduction-2">B.7.1. Introduction</a></h4>
+<div class="paragraph">
+<p>A sample <code>CommonJS</code> module :</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>var lib1 = require("/lib1"); //&lt;-- require
+var lib2 = require("/lib2"); //&lt;-- require
+
+function fn() {
+    //...something using 'lib1' &amp; 'lib2'
+}
+
+exports.usefulFn = fn; //&lt;--exports
+exports.uselessValue = 42; //&lt;--exports</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>The <a href="http://www.commonjs.org/specs/modules/1.0/">CommonJS spec</a> describes the salient features of module format as (quoted verbatim) :</p>
+</div>
+<div class="quoteblock">
+<blockquote>
+<div class="paragraph">
+<p>Module Context</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>In a module, there is a free variable "require", that is a
+function.</p>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p>The "require" function accepts a module identifier.</p>
+</li>
+<li>
+<p>"require" returns the exported API of the foreign module.</p>
+</li>
+<li>
+<p>If there is a dependency cycle, the foreign module may
+not have finished executing at the time it is required by one
+of its transitive dependencies; in this case, the object
+returned by "require" must contain at least the exports
+that the foreign module has prepared before the call to
+require that led to the current module&#8217;s execution.</p>
+</li>
+<li>
+<p>If the requested module cannot be returned, "require"
+must throw an error.</p>
+</li>
+</ol>
+</div>
+</li>
+<li>
+<p>In a module, there is a free variable called "exports",
+that is an object that the module may add its API to as it
+executes.</p>
+</li>
+<li>
+<p>modules must use the "exports" object as the only means
+of exporting.</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>Module Identifiers</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>A module identifier is a String of "terms" delimited by forward
+slashes.</p>
+</li>
+<li>
+<p>A term must be a camelCase identifier, ".", or "..".</p>
+</li>
+<li>
+<p>Module identifiers may not have file-name extensions like ".js".</p>
+</li>
+<li>
+<p>Module identifiers may be "relative" or "top-level". A module
+identifier is "relative" if the first term is "." or "..".</p>
+</li>
+<li>
+<p>Top-level identifiers are resolved off the conceptual module
+name space root.</p>
+</li>
+<li>
+<p>Relative identifiers are resolved relative to the identifier of
+the module in which "require" is written and called.</p>
+</li>
+</ol>
+</div>
+</blockquote>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Transpilation_Hints"><a class="anchor" href="#sec:Transpilation_Hints"></a><a class="link" href="#sec:Transpilation_Hints">B.7.2. Transpilation Hints</a></h4>
+<div class="paragraph">
+<p>This section examines how <code>Babel</code> transpiles <code>ES6</code> modules to <code>CommonJS</code> format. By observing the transpiled output from <code>Babel</code>, we can gather insights for transpiling <code>N4JS</code> modules to <code>CommonJS</code> format.</p>
+</div>
+<div class="sect4">
+<h5 id="sec:Import_Statements"><a class="anchor" href="#sec:Import_Statements"></a><a class="link" href="#sec:Import_Statements">B.7.2.1. Import Statements</a></h5>
+<div class="exampleblock">
+<div class="title">Example 16. Import an entire module (for side effects only)</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import "B";
+console.log(B);</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>"use strict";
+
+require("B");
+console.log(B);</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="exampleblock">
+<div class="title">Example 17. Import single member of a module</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import {b1} from "B";
+b1;</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>"use strict";
+
+var _B = require("B");
+_B.b1;</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="exampleblock">
+<div class="title">Example 18. Import multiple members of a module</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import {b1, b2} from "B";
+b1;
+b2;</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>"use strict";
+
+var _B = require("B");
+
+_B.b1;
+_B.b2;</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="exampleblock">
+<div class="title">Example 19. Import a single member of a module w/ an alias</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import {b3 as b4} from "B";
+b4 + 1;</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>"use strict";
+
+var _B = require("B");
+
+_B.b3 + 1;</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="exampleblock">
+<div class="title">Example 20. Import multiple members of a module w/ aliases</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import {b3 as b4, b5 as b6} from "B";
+b4 + 1;
+b6 + 1;</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>"use strict";
+
+var _B = require("B");
+
+_B.b3 + 1;
+_B.b5 + 1;</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="exampleblock">
+<div class="title">Example 21. Import ALL the bindings of a module</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import * as B from "B";
+console.log(B);</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>"use strict";
+
+function _interopRequireWildcard(obj) {
+    //Babel internally tracks ES6 modules using a flag "__esModule".
+    if (obj &amp;&amp; obj.__esModule) {
+        return obj;
+    } else {
+        //Copy over all the exported members.
+        var newObj = {};
+        if (obj != null) {
+            for (var key in obj) {
+                if (Object.prototype.hasOwnProperty.call(obj, key)) newObj[key] = obj[key];
+            }
+        }
+
+        //Set the "default" as the obj itself (ES6 default export)
+        newObj["default"] = obj;
+        return newObj;
+    }
+}
+
+var _B = require("B");
+
+var B = _interopRequireWildcard(_B);
+
+console.log(B);</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="exampleblock">
+<div class="title">Example 22. Import the default export of a module</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import B from "B";
+console.log(B);</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>"use strict";
+
+//For importing a default export,
+//Babel checks if the obj is an ES6 module or not.
+function _interopRequireDefault(obj) {
+    return obj &amp;&amp; obj.__esModule ? obj : { "default": obj };
+}
+
+var _B = require("B");
+
+var _B2 = _interopRequireDefault(_B);
+
+console.log(_B2["default"]);</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Export_Statements"><a class="anchor" href="#sec:Export_Statements"></a><a class="link" href="#sec:Export_Statements">B.7.2.2. Export Statements</a></h5>
+<div class="exampleblock">
+<div class="title">Example 23. Export a member</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>let a = 1;
+export {a};</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>"use strict";
+
+//Babel makes a note that this is as an ES6 module.
+//This information is later used when this module is imported.
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+var a = 1;
+
+exports.a = a;</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="exampleblock">
+<div class="title">Example 24. Export multiple members</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>let a = 1;
+let b = true;
+
+export {a, b};</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+var a = 1;
+var b = true;
+
+exports.a = a;
+exports.b = b;</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="exampleblock">
+<div class="title">Example 25. Export using alias</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>let a =1;
+export {a as b};</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+var a = 1;
+exports.b = a;</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="exampleblock">
+<div class="title">Example 26. Multiple exports using alias</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>let a = 1, b = 2;
+export {a as A, b as B};</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+var a = 1,
+    b = 2;
+exports.A = a;
+exports.B = b;</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="exampleblock">
+<div class="title">Example 27. Simple default export</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>export default 42;</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = 42; //&lt;-- default export is treated as a special named export
+module.exports = exports["default"]; //&lt;-- IMPORTANT</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="exampleblock">
+<div class="title">Example 28. Default export using an alias</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>let x =10;
+export {x as default};</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+var x = 10;
+exports["default"] = x;
+module.exports = exports["default"];</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="exampleblock">
+<div class="title">Example 29. Default export w/ named export</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>let a = 1;
+export {a};
+export default 42;</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+var a = 1;
+exports.a = a;
+exports["default"] = 42;</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="exampleblock">
+<div class="title">Example 30. Default export a class</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>export default class A  {}</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+
+function _classCallCheck(...) { ... }
+
+var A = function A() {
+  _classCallCheck(this, A);
+};
+
+exports["default"] = A;
+module.exports = exports["default"];</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="exampleblock">
+<div class="title">Example 31. Wildcard re-export</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>export * from "A"</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+
+function _interopExportWildcard(obj, defaults) {
+    var newObj = defaults({}, obj);
+    delete newObj["default"]; //&lt;-- A module's default export can not be re-exported.
+    return newObj;
+}
+
+function _defaults(obj, defaults) {
+    var keys = Object.getOwnPropertyNames(defaults);
+    for (var i = 0; i &lt; keys.length; i++) {
+        var key = keys[i];
+        var value = Object.getOwnPropertyDescriptor(defaults, key);
+        if (value &amp;&amp; value.configurable &amp;&amp; obj[key] === undefined) {
+            Object.defineProperty(obj, key, value);
+        }
+    }
+    return obj;
+}
+
+var _A = require("A");
+
+_defaults(exports, _interopExportWildcard(_A, _defaults));</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="exampleblock">
+<div class="title">Example 32. Specific member re-export</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>export {a1, a2} from "A";</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+
+var _A = require("A");
+
+Object.defineProperty(exports, "a1", {
+  enumerable: true,
+  get: function get() {
+    return _A.a1;
+  }
+});
+Object.defineProperty(exports, "a2", {
+  enumerable: true,
+  get: function get() {
+    return _A.a2;
+  }
+});</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="exampleblock">
+<div class="title">Example 33. Specific member re-export using alias</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>export {a1 as A1, a2 as A2} from "A";</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+
+var _A = require("A");
+
+Object.defineProperty(exports, "A1", {
+  enumerable: true,
+  get: function get() {
+    return _A.a1;
+  }
+});
+Object.defineProperty(exports, "A2", {
+  enumerable: true,
+  get: function get() {
+    return _A.a2;
+  }
+});</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Tracking_Live_Bindings"><a class="anchor" href="#sec:Tracking_Live_Bindings"></a><a class="link" href="#sec:Tracking_Live_Bindings">B.7.2.3. Tracking Live Bindings</a></h5>
+<div class="paragraph">
+<p>As specified in the section about <code>ES6 Modules</code> (<a href="#sec:ES6_Modules">ES6 Modules</a>), <code>ES6 Modules</code> export live immutable bindings. The following listings demonstrate how <code>Babel</code> achieves this.</p>
+</div>
+<div class="exampleblock">
+<div class="title">Example 34. Tracking Live Binding</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>export var a = 1;
+a++;</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+var a = 1;
+exports.a = a;
+exports.a = a += 1; //&lt;-- Exported value is tracked.</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:A_complete_example"><a class="anchor" href="#sec:A_complete_example"></a><a class="link" href="#sec:A_complete_example">B.7.2.4. A complete example</a></h5>
+<div class="paragraph">
+<p>The following listings present a simple but complete example of ES6 export, import and live-binding concepts. It uses 3 simple <code>ES6 modules</code> called <code>A.js, B.js and Main.js</code>. The modules are listed alongside their <code>CommonJS</code> versions generated by <code>Babel</code>.</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>export var a = 1; //&lt;-- exports a number
+
+export function incA() { //&lt;-- exports a function
+    a++;
+}</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+
+exports.incA = incA;
+var a = 1;
+
+exports.a = a;
+
+function incA() {
+    exports.a = a += 1;
+}</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import {incA} from "./A"; //&lt;-- Imports the function from A.js
+
+export function incB() { //&lt;-- Exports a function that calls the imported function from A.js
+    incA();
+}</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+exports.incB = incB;
+
+var _A = require("./A");
+
+function incB() {
+    _A.incA();
+}</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>import {a} from "./A"; //&lt;-- Imports the exported number from A.js
+import {incB} from "./B"; //&lt;-- Imports the exported function from B.js
+
+console.log(a); //&lt;-- Prints "1"
+incB(); //&lt;-- This will call the "incA" function of A.js
+console.log(a); //&lt;--Prints "2". The imported value "a" is updated.</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>"use strict";
+
+var _A = require("./A");
+
+var _B = require("./B");
+
+console.log(_A.a);
+_B.incB();
+console.log(_A.a);</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_resources-2"><a class="anchor" href="#_resources-2"></a><a class="link" href="#_resources-2">B.7.3. Resources</a></h4>
+<div class="paragraph">
+<p><a href="http://exploringjs.com/es6/ch_modules.html">Exploring ES6 by Dr. Axel Rauschmayer</a></p>
+</div>
+<div class="paragraph">
+<p><a href="http://www.commonjs.org/specs/modules/1.0/">CommonJS spec</a></p>
+</div>
+<div class="paragraph">
+<p><a href="http://benjamn.github.io/empirenode-2015/">The Importance of import and export</a></p>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div id="footer">
+<div id="footer-text">
+Version 0.9<br>
+Last updated 2019-08-07 15:02:40 CEST
+</div>
+</div>
+<!-- ************* docinfo-footer *************************************************************** -->
+<div class="Grid social" style="color:#d5dfea">
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <h2>Quick Links</h2>
+    <ul>
+      <li><a href="../downloads.html">Download</a></li>
+      <li><a href="../userguides/index.html">Documentation</a></li>
+      <li><a href="https://github.com/eclipse/n4js/">Source</a></li>
+      <li><a href="https://github.com/eclipse/n4js/issues">Issues</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="https://www.eclipse.org/forums/index.php/f/365/">Forum</a></li>
+      <li><a href="http://n4js.blogspot.de/">Blog</a></li>
+      <li><a href="https://dev.eclipse.org/mailman/listinfo/n4js-dev">Mailing List</a></li>
+      <li><a href="https://projects.eclipse.org/projects/technology.n4js">Eclipse Project Page</a></li>
+      <li><a href="https://twitter.com/n4jsdev">Tweets by n4jsdev</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="http://www.eclipse.org/">Eclipse Home</a></li>
+      <li><a href="http://www.eclipse.org/legal/privacy.php">Privacy Policy</a></li>
+      <li><a href="http://www.eclipse.org/legal/termsofuse.php">Terms of Use</a></li>
+      <li><a href="http://www.eclipse.org/legal/copyright.php">Copyright Agent</a></li>
+      <li><a href="http://www.eclipse.org/legal/">Legal</a></li>
+    </ul>
+  </div>
+  <div style="clear: both; height: 0; overflow: hidden;"></div>
+</div>
+
+<!-- ************* UI Scripts ************* -->
+<script type="text/javascript" src="scripts/back-to-top.js"></script>
+
+<script type="text/javascript" src="scripts/treeview.js"></script>
+<script type="text/javascript" src="scripts/toc.js"></script>
+
+<!-- ************* Prism.js Syntax Highlighting ************* -->
+<script src="scripts/prism.js"></script>
+
+<script type="text/javascript">
+	// Add the 'toclist' id for search function
+	$(".toc2 > ul").attr('id', 'toclist');
+	// Generate a Search input form
+	$("#toclist > li:first-of-type").before('<input type="text" id="pagesearch" onkeyup="search()" placeholder="Search for section...">');
+	$("#toclist > li:first-of-type").before('<i id="clear" class="fa fa-times-circle-o"></i>');
+	$("#clear").click(function(){
+	    $("#pagesearch").val('');
+	    search();
+	    $('.toc2 > ul').treeView('collapseAll');
+	});
+	// intialize Treeview.js
+	$(".toc2 > ul").treeView();
+	// Initialize Scrollspy
+</script>
+<!-- ************* docinfo-footer *************************************************************** -->
+</body>
+</html>
\ No newline at end of file
diff --git a/design/appendix_c_license.html b/design/appendix_c_license.html
new file mode 100644
index 0000000..abd7567
--- /dev/null
+++ b/design/appendix_c_license.html
@@ -0,0 +1,1222 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="generator" content="Asciidoctor 1.5.5">
+<meta name="author" content="2019-08-07 15:02:40 CEST">
+<title>N4JS Design Specification</title>
+<link rel="stylesheet" href="styles/spec.min.css">
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.6.3/css/font-awesome.min.css">
+<!-- ************* docinfo ******************************************************************* -->
+
+
+<!-- ************* Favicon ************-->
+<link rel="icon" href="images/favicon.ico" />
+
+<!-- ************* Back-to-top JQuery ************* -->
+<script src="https://code.jquery.com/jquery-1.12.4.js"></script>
+<script src="https://code.jquery.com/ui/1.12.0/jquery-ui.js"></script>
+
+
+<link href="styles/prism.min.css" rel="stylesheet" />
+<script type="text/javascript" async
+  src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2/MathJax.js?config=TeX-MML-AM_CHTML">
+</script>
+
+<!-- ************* Styles ************* -->
+<link rel="stylesheet" type="text/css" href="styles/n4jsspec-adoc.css">
+
+
+<!-- ****************** NavBar ****************** -->
+<div id="menubar">
+	<div class="banner">
+        <a href="https://www.eclipse.org/n4js/#"><img id="logo" src="images/n4js-logo.png" alt="Eclipse N4JS"></a>
+    </div>
+<ul>
+  <li><a href="index.html">Index</a></li>
+</ul>
+</div>
+<!-- ************* docinfo ******************************************************************* -->
+<style>
+      .admonitionblock td.icon .icon-todo:before{content:"\f249";color:#f4ee42}
+    </style>
+</head>
+<body class="book toc2 toc-left">
+<div id="header">
+<h1>N4JS Design Specification</h1>
+<div class="details">
+<span id="author" class="author">2019-08-07 15:02:40 CEST</span><br>
+<span id="revnumber">version 0.9</span>
+</div>
+<div id="toc" class="toc2">
+<div id="toctitle">Table of Contents</div>
+<ul class="sectlevel1">
+<li><a href="introduction.html#_introduction">1. Introduction</a>
+<ul class="sectlevel2">
+<li><a href="introduction.html#notation">1.1. Notation</a></li>
+<li><a href="introduction.html#sec:IDE_Overview">1.2. IDE Components</a>
+<ul class="sectlevel3">
+<li><a href="introduction.html#sec:Naming_Conventions">1.2.1. Naming Conventions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="eclipse_setup.html#_eclipse-setup">2. Eclipse Setup</a>
+<ul class="sectlevel2">
+<li><a href="eclipse_setup.html#_system-requirements">2.1. System Requirements</a></li>
+<li><a href="eclipse_setup.html#_contribute">2.2. Contribute</a>
+<ul class="sectlevel3">
+<li><a href="eclipse_setup.html#_eclipse-installer">2.2.1. Eclipse Installer</a>
+<ul class="sectlevel4">
+<li><a href="eclipse_setup.html#_changing-the-setup-script">2.2.1.1. Changing the Setup Script</a></li>
+</ul>
+</li>
+<li><a href="eclipse_setup.html#_manual-ide-configuration">2.2.2. Manual IDE Configuration</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="release_engineering.html#_release-engineering">3. Release Engineering</a>
+<ul class="sectlevel2">
+<li><a href="release_engineering.html#_nightly-build-on-eclipse-infrastructure">3.1. Nightly build on Eclipse infrastructure</a></li>
+<li><a href="release_engineering.html#_build-the-n4js-ide-from-command-line">3.2. Build the N4JS IDE from command line</a>
+<ul class="sectlevel3">
+<li><a href="release_engineering.html#_publish-maven-tooling-code-org-eclipse-n4js-releng-util-code">3.2.1. Publish maven-tooling <code>org.eclipse.n4js.releng.util</code></a></li>
+<li><a href="release_engineering.html#sec:test-verdaccio">3.2.2. Test Verdaccio containing n4js-libs</a></li>
+<li><a href="release_engineering.html#_generation-of-eclipse-help-for-spec-and-design-document">3.2.3. Generation of Eclipse help for spec and design document</a></li>
+</ul>
+</li>
+<li><a href="release_engineering.html#_updating-frameworks-and-dependencies">3.3. Updating frameworks and dependencies</a>
+<ul class="sectlevel3">
+<li><a href="release_engineering.html#_update-of-eclipse-emf-xtext-etc">3.3.1. Update of Eclipse, EMF, Xtext, etc.</a></li>
+<li><a href="release_engineering.html#_update-of-the-embedded-jre">3.3.2. Update of the embedded JRE</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tips_and_tricks.html#_tips-and-tricks">4. Tips and Tricks</a>
+<ul class="sectlevel2">
+<li><a href="tips_and_tricks.html#_naming">4.1. Naming</a></li>
+<li><a href="tips_and_tricks.html#_logging">4.2. Logging</a></li>
+<li><a href="tips_and_tricks.html#_cancellation-handling">4.3. Cancellation Handling</a></li>
+<li><a href="tips_and_tricks.html#_caching">4.4. Caching</a></li>
+<li><a href="tips_and_tricks.html#_dependency-injection">4.5. Dependency Injection</a></li>
+<li><a href="tips_and_tricks.html#_miscellaneous">4.6. Miscellaneous</a></li>
+</ul>
+</li>
+<li><a href="parser.html#_parser">5. Parser</a>
+<ul class="sectlevel2">
+<li><a href="parser.html#sec:Parser_Overview">5.1. Overview</a></li>
+<li><a href="parser.html#sec:N4JS_Parser">5.2. N4JS Parser</a></li>
+<li><a href="parser.html#sec:Parser_Generation_Post_Processing">5.3. Parser Generation Post-Processing</a>
+<ul class="sectlevel3">
+<li><a href="parser.html#sec:Automatic_Semicolon_Insertion">5.3.1. Automatic Semicolon Insertion</a>
+<ul class="sectlevel4">
+<li><a href="parser.html#sec:Injected_code_in_the_Antlr_grammar_file">5.3.1.1. Injected code in the Antlr grammar file</a></li>
+<li><a href="parser.html#sec:Customized_error_recovery">5.3.1.2. Customized error recovery</a></li>
+</ul>
+</li>
+<li><a href="parser.html#sec:_No_line_terminator_allowed_here__handling">5.3.2. Async and <code>No line terminator allowed here</code> Handling</a></li>
+<li><a href="parser.html#sec:Regular_Expression">5.3.3. Regular Expression</a></li>
+<li><a href="parser.html#sec:Unicode">5.3.4. Unicode</a></li>
+<li><a href="parser.html#sec:Literals">5.3.5. Literals</a></li>
+</ul>
+</li>
+<li><a href="parser.html#sec:Modifiers">5.4. Modifiers</a></li>
+<li><a href="parser.html#sec:Conflict_Resolutions">5.5. Conflict Resolutions</a>
+<ul class="sectlevel3">
+<li><a href="parser.html#sec:Reserved_Keywords_vs__Identifier_Names">5.5.1. Reserved Keywords vs. Identifier Names</a></li>
+<li><a href="parser.html#sec:Operators_and_Generics">5.5.2. Operators and Generics</a></li>
+</ul>
+</li>
+<li><a href="parser.html#sec:Content_Assist_Parser">5.6. Content-Assist Parser</a></li>
+</ul>
+</li>
+<li><a href="type_system.html#_type-system">6. Type System</a>
+<ul class="sectlevel2">
+<li><a href="type_system.html#sec:Type_Model_and_Grammar">6.1. Type Model and Grammar</a>
+<ul class="sectlevel3">
+<li><a href="type_system.html#sec:Type_Model_Overview">6.1.1. Type Model Overview</a></li>
+<li><a href="type_system.html#sec:Built_in_Types">6.1.2. Built-in and Primitive Types</a></li>
+<li><a href="type_system.html#sec:Type_Model_DSL">6.1.3. Type Model DSL</a></li>
+</ul>
+</li>
+<li><a href="type_system.html#sec:Type_System_Implementation">6.2. Type System Implementation</a></li>
+<li><a href="type_system.html#sec:Type_Inference_combined_with_AST_Traversal">6.3. Type Inference of AST</a>
+<ul class="sectlevel3">
+<li><a href="type_system.html#sec:Type_Inference_combined_with_AST_Traversal__Background">6.3.1. Background</a></li>
+<li><a href="type_system.html#sec:Triggering_Type_Inference_of_AST">6.3.2. Triggering</a></li>
+<li><a href="type_system.html#sec:Traversal_Order_During_Type_Inference_of_AST">6.3.3. Traversal Order</a></li>
+<li><a href="type_system.html#sec:Cross_References_During_Type_Inference_of_AST">6.3.4. Cross-References</a></li>
+<li><a href="type_system.html#sec:Function_Accessor_Bodies_During_Type_Inference_of_AST">6.3.5. Function/Accessor Bodies</a></li>
+<li><a href="type_system.html#sec:Poly_Expressions_During_Type_Inference_of_AST">6.3.6. Poly Expressions</a></li>
+<li><a href="type_system.html#sec:Constraint_Solver_used_During_Type_Inference_of_AST">6.3.7. Constraint Solver</a></li>
+<li><a href="type_system.html#sec:Type_Guards_During_Type_Inference_of_AST">6.3.8. Type Guards</a></li>
+</ul>
+</li>
+<li><a href="type_system.html#sec:Structural_Typing">6.4. Structural Typing</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#_type-index">7. Type Index</a>
+<ul class="sectlevel2">
+<li><a href="type_index.html#sec:Type_Index_Design_Rationale">7.1. Design Rationale</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#sec:Getting_the_Xtext_Index_Content_IResourceDescriptions">7.1.1. Getting the Xtext Index (<code>IResourceDescriptions</code>) Content</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#sec:Design_Overview">7.2. Design Overview</a></li>
+<li><a href="type_index.html#sec:N4JS_Resource_Load_States">7.3. N4JS Resource Load States</a></li>
+<li><a href="type_index.html#sec:Type_Builder">7.4. Types Builder</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#sec:Type_Inference_not_allowed_in_Type_Builder">7.4.1. Type Inference not allowed in Types Builder</a></li>
+<li><a href="type_index.html#sec:ComputedTypeReferences">7.4.2. Deferred Type References</a></li>
+<li><a href="type_index.html#sec:Use_cases_of_ComputedTypeRef">7.4.3. Use cases of DeferredTypeRef</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#sec:Incremental_Builder_Overview">7.5. Incremental Builder (Overview)</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#sec:Incremental_Builder_Overview__XtextBuilder">7.5.1. XtextBuilder</a></li>
+<li><a href="type_index.html#sec:Incremental_Builder_Overview__IBuilderState">7.5.2. IBuilderState</a>
+<ul class="sectlevel4">
+<li><a href="type_index.html#copy-and-update-xtext-index">7.5.2.1. Copy and Update Xtext Index</a></li>
+<li><a href="type_index.html#build-state-setup-phase">7.5.2.2. Build State Setup Phase</a></li>
+<li><a href="type_index.html#process-queued-uris">7.5.2.3. Process Queued URIs</a></li>
+<li><a href="type_index.html#queueing-affected-resources">7.5.2.4. Queueing Affected Resources</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#sec:Incremental_Builder_Overview__Example">7.5.3. Example</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#dirty-state-handling">7.6. Dirty state handling</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#use-case-restoring-types-from-user-data">7.6.1. Use case: Restoring types from user data</a></li>
+<li><a href="type_index.html#use-case-updating-the-xtext-index">7.6.2. Use case: Updating the Xtext index</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="project_model.html#_project-model">8. Project Model</a>
+<ul class="sectlevel2">
+<li><a href="project_model.html#sec:Package_json">8.1. Package.json File</a></li>
+<li><a href="project_model.html#_accessing-project-information">8.2. Accessing Project Information</a>
+<ul class="sectlevel3">
+<li><a href="project_model.html#sec:IN4JSCore">8.2.1. IN4JSCore</a></li>
+<li><a href="project_model.html#sec:N4JSModel">8.2.2. N4JSModel</a></li>
+<li><a href="project_model.html#sec:N4JSWorkspace">8.2.3. N4JSWorkspace</a></li>
+<li><a href="project_model.html#sec:N4JSProject">8.2.4. N4JSProject</a></li>
+<li><a href="project_model.html#sec:SourceContainer">8.2.5. SourceContainer</a></li>
+<li><a href="project_model.html#sec:N4JSProjectsStateHelper">8.2.6. N4JSProjectsStateHelper</a></li>
+</ul>
+</li>
+<li><a href="project_model.html#sec:Caching">8.3. Caching</a>
+<ul class="sectlevel3">
+<li><a href="project_model.html#_caching-of-externallibraryworkspace">8.3.1. Caching of ExternalLibraryWorkspace</a></li>
+<li><a href="project_model.html#_caching-of-n4jsprojectsstatehelper">8.3.2. Caching of N4JSProjectsStateHelper</a></li>
+</ul>
+</li>
+<li><a href="project_model.html#sec:WildcardPathFilter">8.4. WildcardPathFilter</a></li>
+<li><a href="project_model.html#sec:ProjectUtils">8.5. ProjectUtils</a></li>
+</ul>
+</li>
+<li><a href="binding.html#_binding">9. Binding</a>
+<ul class="sectlevel2">
+<li><a href="binding.html#sec:Binding_Design_Rationale">9.1. Design Rationale</a></li>
+<li><a href="binding.html#sec:Binding_to_Members">9.2. Binding to Members</a></li>
+<li><a href="binding.html#sec:Binding_Getter_Setter">9.3. Getter / Setter Binding</a></li>
+<li><a href="binding.html#chap:Statics">9.4. Static Member Binding</a></li>
+<li><a href="binding.html#sec:Binding_Enumeration">9.5. Enumeration Literals Binding</a></li>
+<li><a href="binding.html#sec:Accessibility_of_types_and_members">9.6. Accessibility of types and members</a></li>
+<li><a href="binding.html#sec:Member_Scope_Example">9.7. Member Scope Example</a></li>
+<li><a href="binding.html#sec:Scoping_for_Members_of_Composed_Type_Explained">9.8. Scoping for Members of Composed Type (Union/Intersection) Example</a></li>
+<li><a href="binding.html#sec:Binding_of_Structurally_References_Types">9.9. Structurally References Types</a></li>
+<li><a href="binding.html#sec:Building">9.10. Building</a>
+<ul class="sectlevel3">
+<li><a href="binding.html#sec:Build_Phases">9.10.1. Build Phases</a></li>
+<li><a href="binding.html#sec:Build_Scenarios">9.10.2. Build Scenarios</a></li>
+<li><a href="binding.html#sec:Lazy_linking_problem">9.10.3. Lazy linking problem</a></li>
+</ul>
+</li>
+<li><a href="binding.html#sec:Proxies_and_Proxy_Resolution">9.11. Proxies and Proxy Resolution (Overview)</a>
+<ul class="sectlevel3">
+<li><a href="binding.html#xtexts-lazy-linking-proxies">9.11.1. Xtext’s Lazy Linking Proxies</a></li>
+<li><a href="binding.html#standard-emf-proxies">9.11.2. Standard EMF Proxies</a></li>
+<li><a href="binding.html#_how-is-proxy-resolution-triggered">9.11.3. How is Proxy Resolution Triggered?</a></li>
+<li><a href="binding.html#_when-is-proxy-resolution-allowed">9.11.4. When is Proxy Resolution Allowed?</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="validation.html#_validation">10. Validation</a>
+<ul class="sectlevel2">
+<li><a href="validation.html#sec:validation_overview">10.1. Validation overview</a></li>
+<li><a href="validation.html#sec:validation_control_flow">10.2. Validation control flow</a></li>
+<li><a href="validation.html#sec:validation_issue_ids">10.3. Issue IDs and Messages</a></li>
+<li><a href="validation.html#sec:validation_usage_patterns">10.4. Usage Pattern</a></li>
+<li><a href="validation.html#sec:validation_links">10.5. Links</a></li>
+</ul>
+</li>
+<li><a href="references.html#_references">11. References</a>
+<ul class="sectlevel2">
+<li><a href="references.html#sec:usecases">11.1. Use cases</a></li>
+<li><a href="references.html#sec:calculation_algorithm">11.2. Calculation algorithm</a>
+<ul class="sectlevel3">
+<li><a href="references.html#sec:Xtext_default_implementation">11.2.1. Xtext default implementation</a></li>
+<li><a href="references.html#sec:N4_implementation">11.2.2. N4JS implementation</a></li>
+</ul>
+</li>
+<li><a href="references.html#sec:PerformanceOfDependencyCalculation">11.3. Performance Of Dependency Calculation</a></li>
+<li><a href="references.html#sec:kinds_of_references">11.4. Kinds of references</a>
+<ul class="sectlevel3">
+<li><a href="references.html#sec:Cross_References_to_be_ignored">11.4.1. Cross References to be ignored</a></li>
+<li><a href="references.html#sec:Cross_References_to_be_handled">11.4.2. Cross References to be handled</a></li>
+</ul>
+</li>
+<li><a href="references.html#sec:transitive_dependencies">11.5. Transitive dependencies</a></li>
+<li><a href="references.html#sec:find-references">11.6. Find references</a>
+<ul class="sectlevel3">
+<li><a href="references.html#_background">11.6.1. Background</a></li>
+<li><a href="references.html#_how-find-references-work">11.6.2. How Find References Work</a>
+<ul class="sectlevel4">
+<li><a href="references.html#_step-1-convert-cursor-position-to-declared-element">11.6.2.1. Step 1: Convert Cursor Position to Declared Element</a></li>
+<li><a href="references.html#_step-2-convert-declared-element-to-target-uris">11.6.2.2. Step 2: Convert Declared Element to Target URIs</a></li>
+<li><a href="references.html#_step-3-filter-potential-resources">11.6.2.3. Step 3: Filter Potential Resources</a></li>
+<li><a href="references.html#_step-4-search-references-in-resource">11.6.2.4. Step 4: Search References in Resource</a></li>
+<li><a href="references.html#_limitations-and-possible-enhancements">11.6.2.5. Limitations and Possible Enhancements</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="compilation.html#_compilation">12. Compilation</a>
+<ul class="sectlevel2">
+<li><a href="compilation.html#chap:compilation">12.1. Introduction</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:general_design_rationals">12.1.1. General design rationals</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:logging_and_error_reporting">12.1.1.1. Logging and error reporting</a></li>
+<li><a href="compilation.html#sec:progress_monitor">12.1.1.2. Progress monitor</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Xtext_Integration">12.1.2. Xtext Integration</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:xtext_default_behaviour">12.1.2.1. Xtext default behaviour</a></li>
+<li><a href="compilation.html#sec:n4js_requirements">12.1.2.2. N4JS requirements</a></li>
+<li><a href="compilation.html#sec:compiler_discovery_in_ui">12.1.2.3. Compiler discovery in UI</a></li>
+<li><a href="compilation.html#sec:compiler_discovery_in_headless">12.1.2.4. Compiler discovery in headless</a></li>
+<li><a href="compilation.html#sec:general_generator_implementation">12.1.2.5. General generator implementation</a></li>
+<li><a href="compilation.html#sec:general_generator_activation">12.1.2.6. General generator activation</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Overview_of_Input_Models">12.1.3. Overview of the Input Models</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Core_Generator">12.2. Generators</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:Compiler_Components">12.2.1. Generator Components</a></li>
+<li><a href="compilation.html#sec:Generator_architecture">12.2.2. Generator architecture</a></li>
+<li><a href="compilation.html#sec:Unified_Compiler_Configuration">12.2.3. Unified Compiler Configuration</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Transpilers">12.3. Transpilers</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:Phases">12.3.1. Overview</a></li>
+<li><a href="compilation.html#relation-between-ast-and-im">12.3.2. Relation between AST and IM</a></li>
+<li><a href="compilation.html#implementation-overview">12.3.3. Implementation Overview</a></li>
+<li><a href="compilation.html#sec:Guidelines_for_Implementing_Transformations">12.3.4. Guidelines for Implementing Transformations</a></li>
+<li><a href="compilation.html#symbol-table-in-the-im">12.3.5. Symbol Table in the IM</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:N4JS_to_EcmaScript_Transpiler">12.4. N4JS-to-EcmaScript Transpiler</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:Overview_of_Transformations">12.4.1. Overview of Transformations</a></li>
+<li><a href="compilation.html#sec:Transpiling_members">12.4.2. Transpiling members</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:Transpiling_members__Delegating_members">12.4.2.1. Techniques for special member handling</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__Partial_shadowing_of_getter_setter_pairs">12.4.2.2. Partial shadowing</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__Consuming_or_inheriting_members_of_an_interface">12.4.2.3. Consuming or inheriting members of an interface</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__Static_polyfill">12.4.2.4. Static polyfill</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__API_implementation_stubs">12.4.2.5. API / implementation stubs</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Support_for_incomplete_API_implementation_testing_in_the_N4JS_to_EcmaScript_5_Transpiler">12.4.3. Support for incomplete API implementation testing</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:Modifications_in_Impl_projects">12.4.3.1. Modifications in Impl projects</a></li>
+<li><a href="compilation.html#sec:Implementation_of_stub_generation">12.4.3.2. Implementation of stub-generation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:n4jsc_Headless_Compiler_Interface">12.5. n4jsc Headless Compiler Interface</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:building_the_headless_compiler">12.5.1. building the headless compiler</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="execution.html#_execution">13. Execution</a>
+<ul class="sectlevel2">
+<li><a href="execution.html#sec:N4JS_Project_Execution_And_Linking_Model">13.1. N4JS Project Execution And Linking Model</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#subsec:N4JS_Execution_With_NodeJS">13.1.1. N4JS Execution With NodeJS</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:N4JS_Execution_And_Linking_File">13.2. N4JS Execution And Linking File</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#subsec:NodeJS_Specific_ELF">13.2.1. NodeJS Specific ELF</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Runners-execution">13.3. Runners</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#subsec:N4_Runtime_Environments_Convention">13.3.1. N4 Runtime Environments Convention</a></li>
+<li><a href="execution.html#subsec:Passing_Information_from_IDE_to_Execution_Code_in_Runtime_Environment">13.3.2. Passing Information from IDE to Execution Code in Runtime Environment</a></li>
+<li><a href="execution.html#subsec:Runners_Design">13.3.3. Runners Design</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Legacy_Execution_Engine">13.4. Legacy Execution Engine</a></li>
+<li><a href="execution.html#sec:Design">13.5. Design</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#sec:Usage_Outside_N4JSIDE">13.5.1. Usage Outside N4JSIDE</a>
+<ul class="sectlevel4">
+<li><a href="execution.html#sec:Use_Node_with_Maven">13.5.1.1. Use Node with Maven</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Usage_Inside_N4JSIDE">13.5.2. Usage Inside N4JSIDE</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Runtime_Injection">13.6. Runtime Injection</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#sec:Running_String_Code">13.6.1. Running String Code</a></li>
+<li><a href="execution.html#sec:Running_File_Code">13.6.2. Running File Code</a></li>
+<li><a href="execution.html#sec:Injection_Code_Example">13.6.3. Injection Code Example</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#_tests">14. Tests</a>
+<ul class="sectlevel2">
+<li><a href="tests.html#sec:Performance_Tests">14.1. Performance Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Synthetic_Performance_Tests">14.1.1. Synthetic Performance Tests</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:Design_of_Generator">14.1.1.1. Design of Generator</a></li>
+<li><a href="tests.html#sec:Design_of_Performance_Test_Execution">14.1.1.2. Design of Performance Test Configuration and Execution</a></li>
+<li><a href="tests.html#sec:JUnit_Configuration">14.1.1.3. JUnit Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Test_Configuration">14.1.1.4. JUnitBenchmark Test Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Report_Configuration">14.1.1.5. JUnitBenchmark Report Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Run_Configuration">14.1.1.6. JUnitBenchmark Run Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Example">14.1.1.7. JUnitBenchmark Example</a></li>
+<li><a href="tests.html#sec:Note_on_Jenkins_Job">14.1.1.8. Note on Jenkins Job</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#sec:ECMA_Tests">14.2. ECMA Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Grammar_Tests">14.2.1. Grammar Tests</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:Negative_Tests">14.2.1.1. Negative Tests</a></li>
+<li><a href="tests.html#sec:Test_Exclusion">14.2.1.2. Test Exclusion</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Integration_Tests">14.3. Integration Tests</a></li>
+<li><a href="tests.html#sec:Test_Helpers">14.4. Test Helpers</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Parameterized_N4JS_Tests">14.4.1. Parameterized N4JS tests</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:ParameterizedXtextRunner">14.4.1.1. ParameterizedXtextRunner</a></li>
+<li><a href="tests.html#sec:TestCodeProvider">14.4.1.2. TestCodeProvider</a></li>
+<li><a href="tests.html#sec:Example_Of_Parameterized_Parser_Test">14.4.1.3. Example of parameterized parser test</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Issue_Suppression">14.5. Issue Suppression</a></li>
+<li><a href="tests.html#sec:Xpect_Tests">14.6. Xpect Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Xpect_Test_Setup">14.6.1. Xpect Test Setup</a></li>
+<li><a href="tests.html#sec:Xpect_Issue_Suppression">14.6.2. Xpect Issue Suppression</a></li>
+<li><a href="tests.html#sec:Xpect_Provided_Test_Methods">14.6.3. Xpect Provided Test Methods</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#errors">14.6.3.1. errors</a></li>
+<li><a href="tests.html#warnings">14.6.3.2. warnings</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:N4JS_Specific_Xpect_Test_Methods">14.6.4. N4JS Specific Xpect Test Methods</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:XPECT_noerrors">14.6.4.1. noerrors and nowarnings</a></li>
+<li><a href="tests.html#sec:XPECT_scope">14.6.4.2. scope</a></li>
+<li><a href="tests.html#sec:XPECT_scopeWithPosition">14.6.4.3. scopeWithPosition</a></li>
+<li><a href="tests.html#sec:XPECT_scopeWithResource">14.6.4.4. scopeWithResource</a></li>
+<li><a href="tests.html#sec:XPECT_binding">14.6.4.5. binding</a></li>
+<li><a href="tests.html#sec:XPECT_linkedPathname">14.6.4.6. linkedPathname</a></li>
+<li><a href="tests.html#sec:XPECT_type_of">14.6.4.7. type of</a></li>
+<li><a href="tests.html#sec:XPECT_expectedType">14.6.4.8. expectedType</a></li>
+<li><a href="tests.html#sec:XPECT_elementKeyword">14.6.4.9. elementKeyword</a></li>
+<li><a href="tests.html#sec:XPECT_accessModifier">14.6.4.10. accessModifier</a></li>
+<li><a href="tests.html#sec:XPECT_compileResult">14.6.4.11. compileResult</a></li>
+<li><a href="tests.html#sec:XPECT_output">14.6.4.12. output</a></li>
+<li><a href="tests.html#sec:XPECT_outputRegEx">14.6.4.13. outputRegEx</a></li>
+<li><a href="tests.html#sec:XPECT_calculatedAccessModifier">14.6.4.14. calculatedAccessModifier</a></li>
+<li><a href="tests.html#sec:XPECT_spec">14.6.4.15. spec</a></li>
+<li><a href="tests.html#sec:XPECT_deadCode">14.6.4.16. deadCode</a></li>
+<li><a href="tests.html#sec:XPECT_returnOrThrows">14.6.4.17. returnOrThrows</a></li>
+<li><a href="tests.html#sec:XPECT_lint">14.6.4.18. lint</a></li>
+<li><a href="tests.html#sec:XPECT_lintFails">14.6.4.19. lintFails</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:FIXME_Xpect_modifier">14.6.5. FIXME Xpect modifier</a></li>
+<li><a href="tests.html#sec:Expectmatrix_Xpect_Test_Methods">14.6.6. Expectmatrix Xpect tests</a></li>
+<li><a href="tests.html#xpect-lint-tests">14.6.7. Xpect Lint Tests</a></li>
+</ul>
+</li>
+<li><a href="tests.html#xpect-proposal-tests">14.7. Xpect Proposal Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Validation_vs__Non_Validation">14.7.1. Validation vs. Non-Validation</a></li>
+<li><a href="tests.html#sec:General_Proposal_Test_Features">14.7.2. General Proposal Test Features</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:Test_Variables">14.7.2.1. Test Variables</a></li>
+<li><a href="tests.html#sec:Location_and_Selection">14.7.2.2. at – Location and Selection</a></li>
+<li><a href="tests.html#sec:Multi_Line_Expectations_in_Proposal_Tests">14.7.2.3. Multi Line Expectations in Proposal Tests</a></li>
+<li><a href="tests.html#sec:Timeout">14.7.2.4. Timeout and Performance</a></li>
+</ul>
+</li>
+<li><a href="tests.html#proposals-verify-existence-of-proposals">14.7.3. proposals – Verify Existence of Proposals</a></li>
+<li><a href="tests.html#sec:Verify_displayed_string">14.7.4. display – Verify displayed string</a></li>
+<li><a href="tests.html#sec:Apply_Proposal">14.7.5. apply – Apply Proposal</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#resource-application-in-other-files">14.7.5.1. resource – application in other files</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Content_Assist_Cycling">14.7.6. kind – Content Assist Cycling</a></li>
+<li><a href="tests.html#fileValidVerify-validation-status">14.7.7. fileValid – Verify validation status</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Apply_Proposal_And_Execute_Tests">14.8. Apply Proposal And Execute Tests</a></li>
+<li><a href="tests.html#sec:Organize_Imports_Test">14.9. Organize Imports Test</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#organizeimports">14.9.1. organizeImports</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Access_Control_Test">14.10. Access Control Test</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#test-scenarios">14.10.1. Test Scenarios</a></li>
+<li><a href="tests.html#n4js-code-generator">14.10.2. N4JS Code Generator</a></li>
+<li><a href="tests.html#xtext-issue-matcher">14.10.3. Xtext Issue Matcher</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Smoke_Tests">14.11. Smoke Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#how-to-handle-smoke-test-errors">14.11.1. How to handle smoke test errors?</a></li>
+<li><a href="tests.html#smoketester-and-exceptionanalyzer">14.11.2. SmokeTester and ExceptionAnalyzer</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:UI_Tests_with_SWTBot">14.12. UI Tests with SWTBot</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#writing-swtbot-tests">14.12.1. Writing SWTBot Tests</a></li>
+<li><a href="tests.html#running-swtbot-tests">14.12.2. Running SWTBot Tests</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Debugging_UI_Tests">14.13. Debugging UI Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Connecting_to_the_X_server_on_the_build_node">14.13.1. Connecting to the X-server on the build-node</a></li>
+<li><a href="tests.html#sec:Tools_to_investigate_the_java_stack">14.13.2. Tools to investigate the java-stack</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="ui_concepts.html#_ui-concepts">15. UI Concepts</a>
+<ul class="sectlevel2">
+<li><a href="ui_concepts.html#sec:User_Interface_Concepts">15.1. User Interface Concepts</a>
+<ul class="sectlevel3">
+<li><a href="ui_concepts.html#sec:Eclipse_UI_Concepts">15.1.1. Eclipse UI Concepts</a>
+<ul class="sectlevel4">
+<li><a href="ui_concepts.html#sec:Label_Provider">15.1.1.1. Label Provider</a></li>
+<li><a href="ui_concepts.html#sec:Markers">15.1.1.2. Markers</a></li>
+<li><a href="ui_concepts.html#sec:Commands__Toolbar_and_Menus">15.1.1.3. Commands, Toolbar and Menus</a></li>
+<li><a href="ui_concepts.html#sec:Content_Assist">15.1.1.4. Content Assist</a></li>
+<li><a href="ui_concepts.html#sec:Quick_Fixes">15.1.1.5. Quick Fixes</a></li>
+<li><a href="ui_concepts.html#sec:Quick_Assist">15.1.1.6. Quick Assist</a></li>
+<li><a href="ui_concepts.html#sec:Clean_Up_Actions">15.1.1.7. Clean Up Actions</a></li>
+<li><a href="ui_concepts.html#sec:Save_Actions">15.1.1.8. Save Actions</a></li>
+<li><a href="ui_concepts.html#sec:Auto_Edit">15.1.1.9. Auto Edit</a></li>
+<li><a href="ui_concepts.html#sec:Template_Proposals">15.1.1.10. Template Proposals</a></li>
+<li><a href="ui_concepts.html#sec:Outline_View___Quick_Outline">15.1.1.11. Outline View / Quick Outline</a></li>
+<li><a href="ui_concepts.html#sec:Navigator__Package_Explorer__Project_Explorer">15.1.1.12. Navigator, Package Explorer, Project Explorer</a></li>
+<li><a href="ui_concepts.html#sec:Hyperlinking_and_Navigation">15.1.1.13. Hyperlinking and Navigation</a></li>
+<li><a href="ui_concepts.html#sec:Syntax_and_Semantic_Coloring">15.1.1.14. Syntax and Semantic Coloring</a></li>
+<li><a href="ui_concepts.html#sec:Code_Formatter">15.1.1.15. Code Formatter</a></li>
+<li><a href="ui_concepts.html#sec:Wizards">15.1.1.16. Wizards</a></li>
+<li><a href="ui_concepts.html#sec:Cheat_Sheets">15.1.1.17. Cheat Sheets</a></li>
+<li><a href="ui_concepts.html#sec:Context_sensitive_Help">15.1.1.18. Context-sensitive Help</a></li>
+<li><a href="ui_concepts.html#sec:Hovers">15.1.1.19. Hovers</a></li>
+<li><a href="ui_concepts.html#sec:Folding">15.1.1.20. Folding</a></li>
+<li><a href="ui_concepts.html#sec:Customizable_validation___severity">15.1.1.21. Customizable validation / severity</a></li>
+<li><a href="ui_concepts.html#sec:Proposals">15.1.1.22. Proposals</a></li>
+</ul>
+</li>
+<li><a href="ui_concepts.html#sec:Non_Eclipse_UI_Concepts">15.1.2. Non-Eclipse UI Concepts</a>
+<ul class="sectlevel4">
+<li><a href="ui_concepts.html#sec:Overlays">15.1.2.1. Overlays</a></li>
+<li><a href="ui_concepts.html#sec:Goto__Inferred__Type">15.1.2.2. Goto (Inferred) Type</a></li>
+<li><a href="ui_concepts.html#sec:Postfix_Completion">15.1.2.3. Postfix Completion</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="ui_concepts.html#_user-interface-resources">15.2. User Interface Resources</a>
+<ul class="sectlevel3">
+<li><a href="ui_concepts.html#_icons">15.2.1. Icons</a>
+<ul class="sectlevel4">
+<li><a href="ui_concepts.html#_eclipse-platform-icons">15.2.1.1. Eclipse Platform Icons</a></li>
+<li><a href="ui_concepts.html#_n4js-specific-icons">15.2.1.2. N4JS Specific Icons</a></li>
+<li><a href="ui_concepts.html#_high-resolution-icons">15.2.1.3. High Resolution Icons</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="formatting.html#_formatting">16. Formatting</a>
+<ul class="sectlevel2">
+<li><a href="formatting.html#sec:FmtObjective">16.1. Objective</a>
+<ul class="sectlevel3">
+<li><a href="formatting.html#sec:FmtFormatting_Comments">16.1.1. Formatting Comments</a></li>
+</ul>
+</li>
+<li><a href="formatting.html#sec:FmtArchitecture">16.2. Architecture</a>
+<ul class="sectlevel3">
+<li><a href="formatting.html#sec:Implementation_example">16.2.1. Implementation example</a></li>
+</ul>
+</li>
+<li><a href="formatting.html#sec:FmtFormatter_Implementation_Guidelines">16.3. Formatter Implementation Guidelines</a></li>
+<li><a href="formatting.html#sec:FmtConfiguration">16.4. Configuration</a></li>
+<li><a href="formatting.html#sec:FmtUI_Integration">16.5. UI Integration</a></li>
+<li><a href="formatting.html#sec:FmtUnit_Testing_with_Xpect">16.6. Unit Testing with Xpect</a></li>
+</ul>
+</li>
+<li><a href="external_libraries.html#_external-libraries">17. External Libraries</a>
+<ul class="sectlevel2">
+<li><a href="external_libraries.html#sec:Major_Components">17.1. Major Components</a>
+<ul class="sectlevel3">
+<li><a href="external_libraries.html#subsec:External_Resources">17.1.1. External Resources</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Workspace">17.1.2. External Library Workspace</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Preference_Store">17.1.3. External Library Preference Store</a></li>
+<li><a href="external_libraries.html#subsec:npm_Manager">17.1.4. Library Manager</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Builder_Helper">17.1.5. External Library Builder</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Xtext_Index_Persister">17.1.6. External Library Xtext Index Persister</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Preference_Page">17.1.7. External Library Preference Page</a></li>
+</ul>
+</li>
+<li><a href="external_libraries.html#sec:Headless_External_Library_Support">17.2. Headless External Library Support</a>
+<ul class="sectlevel3">
+<li><a href="external_libraries.html#_custom-npm-settings">17.2.1. Custom npm settings</a></li>
+</ul>
+</li>
+<li><a href="external_libraries.html#sec:lmFutureWork">17.3. Future Work</a>
+<ul class="sectlevel3">
+<li><a href="external_libraries.html#subsec:lmMultipleDependencyScope">17.3.1. Multiple Dependency Scope</a></li>
+<li><a href="external_libraries.html#subsec:lmRunTestsFromLibrary">17.3.2. Run Tests from TestLibrary</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="json_support.html#sec:JSON_Support">18. JSON Support</a>
+<ul class="sectlevel2">
+<li><a href="json_support.html#sec:JSON_Parser">18.1. JSON Parser</a>
+<ul class="sectlevel3">
+<li><a href="json_support.html#sec:JSON_Parser_Unicode_Escaping">18.1.1. Escaping Unicode Control Characters in String Literals</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Empty_Text">18.1.2. Empty Text</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Nested_Structures">18.1.3. Nested Structures</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Whitespace">18.1.4. Whitespace</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Comments">18.1.5. Comments</a></li>
+</ul>
+</li>
+<li><a href="json_support.html#sec:JSON_Language_Extensions">18.2. JSON Language Extensions</a>
+<ul class="sectlevel3">
+<li><a href="json_support.html#sec:JSON_Validator_Extensions">18.2.1. JSON Validator Extensions</a>
+<ul class="sectlevel4">
+<li><a href="json_support.html#sec:File_Specitic_Validator_Extensions">18.2.1.1. File-Specific Validator Extensions</a></li>
+<li><a href="json_support.html#sec:JSON_Declarative_JSON_Validator_Extensions">18.2.1.2. Declarative JSON Validator Extensions</a></li>
+</ul>
+</li>
+<li><a href="json_support.html#_json-resource-description-strategy">18.2.2. JSON Resource Description Strategy</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_jsdoc">19. JSDoc</a>
+<ul class="sectlevel2">
+<li><a href="jsdoc.html#sec:Design_Rationale">19.1. Design Rationale</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#_general-design">19.1.1. General Design</a></li>
+<li><a href="jsdoc.html#sec:Type_Expressions">19.1.2. Type Expressions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="docexporter.html#_docexporter">20. DocExporter</a>
+<ul class="sectlevel2">
+<li><a href="docexporter.html#sec:Specification_Exporter">20.1. Specification Exporter</a></li>
+</ul>
+</li>
+<li><a href="rename_refactoring.html#_rename-refactoring">21. Rename Refactoring</a>
+<ul class="sectlevel2">
+<li><a href="rename_refactoring.html#_rename-refactoring-ui-interaction">21.1. Rename Refactoring UI interaction</a></li>
+<li><a href="rename_refactoring.html#_renameelementprocessor-interaction">21.2. RenameElementProcessor interaction</a></li>
+</ul>
+</li>
+<li><a href="flow_graphs.html#chap:flowgraphs">22. Flow Graphs</a>
+<ul class="sectlevel2">
+<li><a href="flow_graphs.html#sec:flowgraphs_overview">22.1. Flow graphs overview</a>
+<ul class="sectlevel3">
+<li><a href="flow_graphs.html#_internal-graph">22.1.1. Internal graph</a></li>
+<li><a href="flow_graphs.html#_optimizations">22.1.2. Optimizations</a></li>
+<li><a href="flow_graphs.html#_api-for-client-analyses">22.1.3. API for client analyses</a>
+<ul class="sectlevel4">
+<li><a href="flow_graphs.html#_mapping-from-internal-to-ast-elements">22.1.3.1. Mapping from internal to AST elements</a></li>
+<li><a href="flow_graphs.html#_graph-visitor">22.1.3.2. Graph visitor</a></li>
+<li><a href="flow_graphs.html#_graph-explorer">22.1.3.3. Graph explorer</a></li>
+<li><a href="flow_graphs.html#_branch-walker">22.1.3.4. Branch walker</a></li>
+<li><a href="flow_graphs.html#_example-1-compute-string-for-each-path">22.1.3.5. Example 1: Compute string for each path</a></li>
+<li><a href="flow_graphs.html#_path-quantor">22.1.3.6. Path quantor</a></li>
+</ul>
+</li>
+<li><a href="flow_graphs.html#_control-flow-analyses">22.1.4. Control flow analyses</a>
+<ul class="sectlevel4">
+<li><a href="flow_graphs.html#_dead-code-analysis">22.1.4.1. Dead code analysis</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="flow_graphs.html#sec:dataflow">22.2. Dataflow</a>
+<ul class="sectlevel3">
+<li><a href="flow_graphs.html#_dataflow-graph">22.2.1. Dataflow graph</a></li>
+<li><a href="flow_graphs.html#_dataflow-analyses">22.2.2. Dataflow analyses</a>
+<ul class="sectlevel4">
+<li><a href="flow_graphs.html#_def-def-def-nothing-analysis">22.2.2.1. Def&#8594;Def / Def&#8594;Nothing analysis</a></li>
+<li><a href="flow_graphs.html#_def-use-decl-analysis">22.2.2.2. Def|Use&#8592;Decl analysis</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="publish_npms.html#sec:publish-npms-to-public">23. Publish npms</a>
+<ul class="sectlevel2">
+<li><a href="publish_npms.html#sec:publish-npms-n4js-maven">23.1. Publish n4js-libs to during  maven build</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Hints">Appendix A: Hints</a>
+<ul class="sectlevel2">
+<li><a href="appendix_a_hints.html#sec:XtextInjection">A.1. Xtext Injection</a>
+<ul class="sectlevel3">
+<li><a href="appendix_a_hints.html#sec:DI_MultipleInjectors_Singletons">A.1.1. Multiple Injectors and Singletons</a>
+<ul class="sectlevel4">
+<li><a href="appendix_a_hints.html#sec:DI_avoid_duplicate_singletons">A.1.1.1. Avoiding duplicate singletons</a>
+<ul class="sectlevel5">
+<li><a href="appendix_a_hints.html#sec:DI_binding_in_shared">A.1.1.1.1. Defining binding in the shared injector</a></li>
+<li><a href="appendix_a_hints.html#sec:DI_binding_in_custom">A.1.1.1.2. Defining binding in the custom injector</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:DI_Hints">A.1.2. Dependency Injection Hints</a>
+<ul class="sectlevel4">
+<li><a href="appendix_a_hints.html#sec:DI_custom_bundle">A.1.2.1. Use DI in custom bundle, use DI with extensions</a>
+<ul class="sectlevel5">
+<li><a href="appendix_a_hints.html#sec:DI_custom_bundle_problem">A.1.2.1.1. Problem</a></li>
+<li><a href="appendix_a_hints.html#sec:DI_custom_bundle_solution">A.1.2.1.2. Solution</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Access_Other_DSL_Injector">A.1.2.2. How do I get the Guice Injector of my language?</a>
+<ul class="sectlevel5">
+<li><a href="appendix_a_hints.html#sec:DSL_Injector_UI_context">A.1.2.2.1. UI context</a></li>
+<li><a href="appendix_a_hints.html#sec:DSL_Injector_Non_UI_context">A.1.2.2.2. Non UI context but with injection context</a></li>
+<li><a href="appendix_a_hints.html#sec:DSL_Injector_Non_UI_non_injection_context">A.1.2.2.3. Non UI context without injection context</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Cancel_Indicator">A.1.2.3. How do I get cancel indicators in different contexts?</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Eclipse">A.2. Eclipse</a>
+<ul class="sectlevel3">
+<li><a href="appendix_a_hints.html#sec:Show_Xtext_Index">A.2.1. Show the current Xtext index</a></li>
+<li><a href="appendix_a_hints.html#sec:Plugin_spy">A.2.2. Plug-in spy</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Maven-hints">A.3. Maven</a>
+<ul class="sectlevel3">
+<li><a href="appendix_a_hints.html#how-to-check-for-maven-mojo-updates">A.3.1. How to check for Maven MOJO updates</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#_module-loading">Appendix B: Module Loading</a>
+<ul class="sectlevel2">
+<li><a href="appendix_b_module_loading.html#sec:Dependency_Management">B.1. Dependency Management</a></li>
+<li><a href="appendix_b_module_loading.html#ecmascript-modules">B.2. ECMAScript Modules</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:ES5_Modules_Systems">B.2.1. ES5 Modules Systems</a></li>
+<li><a href="appendix_b_module_loading.html#sec:ES6_Modules">B.2.2. ES6 Modules</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:ECMAScript_Module_Loaders">B.3. ECMAScript Module Loaders</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:ES6_Module_Loaders">B.3.1. ES6 Module Loaders</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Polyfills_for_ES6_Module_Loaders">B.3.2. Polyfills for ES6 Module Loaders</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:es6_module_loader">B.3.2.1. es6-module-loader</a></li>
+<li><a href="appendix_b_module_loading.html#sec:SystemJS">B.3.2.2. SystemJS</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Demo">B.3.2.3. Demo</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#case-study-typescript">B.4. Case Study : TypeScript</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:ES6_Modules_Support">B.4.1. ES6 Modules Support</a></li>
+<li><a href="appendix_b_module_loading.html#sec:TypeScript_and_Module_Loading">B.4.2. TypeScript and Module Loading</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Cyclic_Dependencies">B.5. Cyclic Dependencies</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:Setup">B.5.1. Setup</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Transpile_and_Execute">B.5.2. Transpile and Execute</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Module_Format___AMD">B.5.2.1. Module Format = AMD</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Module_Format___CommonJS">B.5.2.2. Module Format = CommonJS</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Module_Format___SystemJS">B.5.2.3. Module Format = SystemJS</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Conclusion">B.5.3. Conclusion</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#system.register-as-transpilation-target">B.6. System.register as transpilation target</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:Introduction">B.6.1. Introduction</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:External_Transpilers">B.6.1.1. External Transpilers</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Example_of_a_System_register_module">B.6.1.2. Example of a System.register module</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Structure_of_a_System_register_module">B.6.2. Structure of a System.register module</a></li>
+<li><a href="appendix_b_module_loading.html#_transpilation-hints">B.6.3. Transpilation Hints</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Handling_Imports">B.6.3.1. Handling Imports</a></li>
+<li><a href="appendix_b_module_loading.html#sec:__exportFn__">B.6.3.2. &lt;&lt;exportFn&gt;&gt;</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Handling_Exports">B.6.3.3. Handling Exports</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Examples_w__Circular_Dependencies">B.6.4. Examples w/ Circular Dependencies</a></li>
+<li><a href="appendix_b_module_loading.html#sec:N4JS_Examples_w__Circular_Dependencies">B.6.5. N4JS Examples w/ Circular Dependencies</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Unresolved_Cyclic_Dependencies">B.6.5.1. Unresolved Cyclic Dependencies</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Variables___Functions">B.6.5.2. Examples with Variables &amp; Functions</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Classes">B.6.5.3. Examples with Classes</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Examples_with_SubClassing">B.6.5.4. Examples with SubClassing</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Miscellaneous">B.6.5.5. Miscellaneous</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#_resources">B.6.6. Resources</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:CommonJS_as_transpilation_target">B.7. CommonJS as transpilation target</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#_introduction-2">B.7.1. Introduction</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Transpilation_Hints">B.7.2. Transpilation Hints</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Import_Statements">B.7.2.1. Import Statements</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Export_Statements">B.7.2.2. Export Statements</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Tracking_Live_Bindings">B.7.2.3. Tracking Live Bindings</a></li>
+<li><a href="appendix_b_module_loading.html#sec:A_complete_example">B.7.2.4. A complete example</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#_resources-2">B.7.3. Resources</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#sec:License">Appendix C: License</a></li>
+<li><a href="appendix_d_acronyms.html#sec:Acronyms">Appendix D: Acronyms</a></li>
+<li><a href="appendix_e_bibliography_and_footnotes.html#_bibliography-and-footnotes">Appendix E: Bibliography and Footnotes</a></li>
+</ul>
+</div>
+</div>
+<div id="content"><div class="sect1">
+<h2 id="sec:License"><a class="anchor" href="#sec:License"></a><a class="link" href="#sec:License">Appendix C: License</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>This specification and the accompanying materials is made available
+under the terms of the Eclipse Public License v1.0 which accompanies
+this distribution, and is available at <a href="http://www.eclipse.org/legal/epl-v10.html" class="bare">http://www.eclipse.org/legal/epl-v10.html</a></p>
+</div>
+<h3 id="_eclipse-public-license-v-1-0" class="discrete">Eclipse Public License - v 1.0</h3>
+<div class="paragraph">
+<p>THE ACCOMPANYING PROGRAM IS PROVIDED UNDER THE TERMS OF THIS ECLIPSE
+PUBLIC LICENSE (<code>AGREEMENT</code>). ANY USE, REPRODUCTION OR DISTRIBUTION OF
+THE PROGRAM CONSTITUTES RECIPIENT’S ACCEPTANCE OF THIS AGREEMENT.</p>
+</div>
+<h4 id="_1-definitions" class="discrete">1. DEFINITIONS</h4>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><code>Contribution</code> means: </dt>
+<dd>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>in the case of the initial Contributor, the initial code and
+documentation distributed under this Agreement, and</p>
+</li>
+<li>
+<p>in the case of each subsequent Contributor:</p>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p>changes to the Program, and</p>
+</li>
+<li>
+<p>additions to the Program;</p>
+<div class="paragraph">
+<p>where such changes and/or additions to the Program originate from and
+are distributed by that particular Contributor. A Contribution
+’originates’ from a Contributor if it was added to the Program by such
+Contributor itself or anyone acting on such Contributor’s behalf.
+Contributions do not include additions to the Program which:</p>
+</div>
+<div class="olist lowerroman">
+<ol class="lowerroman" type="i">
+<li>
+<p>are separate modules of software distributed in conjunction with the Program
+under their own license agreement, and</p>
+</li>
+<li>
+<p>are not derivative works of the Program.</p>
+</li>
+</ol>
+</div>
+</li>
+</ol>
+</div>
+</li>
+</ol>
+</div>
+</dd>
+<dt class="hdlist1"><code>Contributor</code></dt>
+<dd>
+<p>means any person or entity that distributes the Program.</p>
+</dd>
+<dt class="hdlist1"><code>Licensed Patents</code> </dt>
+<dd>
+<p>mean patent claims licensable by a Contributor
+which are necessarily infringed by the use or sale of its Contribution
+alone or when combined with the Program.</p>
+</dd>
+<dt class="hdlist1"><code>Program</code> </dt>
+<dd>
+<p>means the Contributions distributed in accordance with this
+Agreement.</p>
+</dd>
+<dt class="hdlist1"><code>Recipient</code> </dt>
+<dd>
+<p>means anyone who receives the Program under this
+Agreement, including all Contributors.</p>
+</dd>
+</dl>
+</div>
+<h4 id="_2-grant-of-rights" class="discrete">2. GRANT OF RIGHTS</h4>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Subject to the terms of this Agreement, each Contributor hereby
+grants Recipient a non-exclusive, worldwide, royalty-free copyright
+license to reproduce, prepare derivative works of, publicly display,
+publicly perform, distribute and sublicense the Contribution of such
+Contributor, if any, and such derivative works, in source code and
+object code form.</p>
+</li>
+<li>
+<p>Subject to the terms of this Agreement, each Contributor hereby
+grants Recipient a non-exclusive, worldwide, royalty-free patent license
+under Licensed Patents to make, use, sell, offer to sell, import and
+otherwise transfer the Contribution of such Contributor, if any, in
+source code and object code form. This patent license shall apply to the
+combination of the Contribution and the Program if, at the time the
+Contribution is added by the Contributor, such addition of the
+Contribution causes such combination to be covered by the Licensed
+Patents. The patent license shall not apply to any other combinations
+which include the Contribution. No hardware per se is licensed
+hereunder.</p>
+</li>
+<li>
+<p>Recipient understands that although each Contributor grants the
+licenses to its Contributions set forth herein, no assurances are
+provided by any Contributor that the Program does not infringe the
+patent or other intellectual property rights of any other entity. Each
+Contributor disclaims any liability to Recipient for claims brought by
+any other entity based on infringement of intellectual property rights
+or otherwise. As a condition to exercising the rights and licenses
+granted hereunder, each Recipient hereby assumes sole responsibility to
+secure any other intellectual property rights needed, if any. For
+example, if a third party patent license is required to allow Recipient
+to distribute the Program, it is Recipient’s responsibility to acquire
+that license before distributing the Program.</p>
+</li>
+<li>
+<p>Each Contributor represents that to its knowledge it has sufficient
+copyright rights in its Contribution, if any, to grant the copyright
+license set forth in this Agreement.</p>
+</li>
+</ol>
+</div>
+<h4 id="_3-requirements" class="discrete">3. REQUIREMENTS</h4>
+<div class="paragraph">
+<p>A Contributor may choose to distribute the Program in object code form
+under its own license agreement, provided that:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>it complies with the terms and conditions of this Agreement; and</p>
+</li>
+<li>
+<p>its license agreement:</p>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p>effectively disclaims on behalf of all Contributors all warranties
+and conditions, express and implied, including warranties or conditions
+of title and non-infringement, and implied warranties or conditions of
+merchantability and fitness for a particular purpose;</p>
+</li>
+<li>
+<p>effectively excludes on behalf of all Contributors all liability for
+damages, including direct, indirect, special, incidental and
+consequential damages, such as lost profits;</p>
+</li>
+<li>
+<p>states that any provisions which differ from this Agreement are
+offered by that Contributor alone and not by any other party; and</p>
+</li>
+<li>
+<p>states that source code for the Program is available from such
+Contributor, and informs licensees how to obtain it in a reasonable
+manner on or through a medium customarily used for software exchange.</p>
+</li>
+</ol>
+</div>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>When the Program is made available in source code form:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>it must be made available under this Agreement; and</p>
+</li>
+<li>
+<p>a copy of this Agreement must be included with each copy of the
+Program.</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>Contributors may not remove or alter any copyright notices contained
+within the Program.</p>
+</div>
+<div class="paragraph">
+<p>Each Contributor must identify itself as the originator of its
+Contribution, if any, in a manner that reasonably allows subsequent
+Recipients to identify the originator of the Contribution.</p>
+</div>
+<h4 id="_4-commercial-distribution" class="discrete">4. COMMERCIAL DISTRIBUTION</h4>
+<div class="paragraph">
+<p>Commercial distributors of software may accept certain responsibilities
+with respect to end users, business partners and the like. While this
+license is intended to facilitate the commercial use of the Program, the
+Contributor who includes the Program in a commercial product offering
+should do so in a manner which does not create potential liability for
+other Contributors. Therefore, if a Contributor includes the Program in
+a commercial product offering, such Contributor (<code>Commercial
+Contributor</code>) hereby agrees to defend and indemnify every other
+Contributor (<code>Indemnified Contributor</code>) against any losses, damages
+and costs (collectively <code>Losses</code>) arising from claims, lawsuits and
+other legal actions brought by a third party against the Indemnified
+Contributor to the extent caused by the acts or omissions of such
+Commercial Contributor in connection with its distribution of the
+Program in a commercial product offering. The obligations in this
+section do not apply to any claims or Losses relating to any actual or
+alleged intellectual property infringement. In order to qualify, an
+Indemnified Contributor must: a) promptly notify the Commercial
+Contributor in writing of such claim, and b) allow the Commercial
+Contributor to control, and cooperate with the Commercial Contributor
+in, the defense and any related settlement negotiations. The Indemnified
+Contributor may participate in any such claim at its own expense.</p>
+</div>
+<div class="paragraph">
+<p>For example, a Contributor might include the Program in a commercial
+product offering, Product X. That Contributor is then a Commercial
+Contributor. If that Commercial Contributor then makes performance
+claims, or offers warranties related to Product X, those performance
+claims and warranties are such Commercial Contributor’s responsibility
+alone. Under this section, the Commercial Contributor would have to
+defend claims against the other Contributors related to those
+performance claims and warranties, and if a court requires any other
+Contributor to pay any damages as a result, the Commercial Contributor
+must pay those damages.</p>
+</div>
+<h4 id="_5-no-warranty" class="discrete">5. NO WARRANTY</h4>
+<div class="paragraph">
+<p>EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, THE PROGRAM IS PROVIDED
+ON AN <code>AS IS</code> BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,
+EITHER EXPRESS OR IMPLIED INCLUDING, WITHOUT LIMITATION, ANY WARRANTIES
+OR CONDITIONS OF TITLE, NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR
+A PARTICULAR PURPOSE. Each Recipient is solely responsible for
+determining the appropriateness of using and distributing the Program
+and assumes all risks associated with its exercise of rights under this
+Agreement , including but not limited to the risks and costs of program
+errors, compliance with applicable laws, damage to or loss of data,
+programs or equipment, and unavailability or interruption of operations.</p>
+</div>
+<h4 id="_6-disclaimer-of-liability" class="discrete">6. DISCLAIMER OF LIABILITY</h4>
+<div class="paragraph">
+<p>EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, NEITHER RECIPIENT NOR
+ANY CONTRIBUTORS SHALL HAVE ANY LIABILITY FOR ANY DIRECT, INDIRECT,
+INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING
+WITHOUT LIMITATION LOST PROFITS), HOWEVER CAUSED AND ON ANY THEORY OF
+LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OR
+DISTRIBUTION OF THE PROGRAM OR THE EXERCISE OF ANY RIGHTS GRANTED
+HEREUNDER, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.</p>
+</div>
+<h4 id="_7-general" class="discrete">7. GENERAL</h4>
+<div class="paragraph">
+<p>If any provision of this Agreement is invalid or unenforceable under
+applicable law, it shall not affect the validity or enforceability of
+the remainder of the terms of this Agreement, and without further action
+by the parties hereto, such provision shall be reformed to the minimum
+extent necessary to make such provision valid and enforceable.</p>
+</div>
+<div class="paragraph">
+<p>If Recipient institutes patent litigation against any entity (including
+a cross-claim or counterclaim in a lawsuit) alleging that the Program
+itself (excluding combinations of the Program with other software or
+hardware) infringes such Recipient’s patent(s), then such Recipient’s
+rights granted under Section 2(b) shall terminate as of the date such
+litigation is filed.</p>
+</div>
+<div class="paragraph">
+<p>All Recipient’s rights under this Agreement shall terminate if it fails
+to comply with any of the material terms or conditions of this Agreement
+and does not cure such failure in a reasonable period of time after
+becoming aware of such noncompliance. If all Recipient’s rights under
+this Agreement terminate, Recipient agrees to cease use and distribution
+of the Program as soon as reasonably practicable. However, Recipient’s
+obligations under this Agreement and any licenses granted by Recipient
+relating to the Program shall continue and survive.</p>
+</div>
+<div class="paragraph">
+<p>Everyone is permitted to copy and distribute copies of this Agreement,
+but in order to avoid inconsistency the Agreement is copyrighted and may
+only be modified in the following manner. The Agreement Steward reserves
+the right to publish new versions (including revisions) of this
+Agreement from time to time. No one other than the Agreement Steward has
+the right to modify this Agreement. The Eclipse Foundation is the
+initial Agreement Steward. The Eclipse Foundation may assign the
+responsibility to serve as the Agreement Steward to a suitable separate
+entity. Each new version of the Agreement will be given a distinguishing
+version number. The Program (including Contributions) may always be
+distributed subject to the version of the Agreement under which it was
+received. In addition, after a new version of the Agreement is
+published, Contributor may elect to distribute the Program (including
+its Contributions) under the new version. Except as expressly stated in
+Sections 2(a) and 2(b) above, Recipient receives no rights or licenses
+to the intellectual property of any Contributor under this Agreement,
+whether expressly, by implication, estoppel or otherwise. All rights in
+the Program not expressly granted under this Agreement are reserved.</p>
+</div>
+<div class="paragraph">
+<p>This Agreement is governed by the laws of the State of New York and the
+intellectual property laws of the United States of America. No party to
+this Agreement will bring a legal action under this Agreement more than
+one year after the cause of action arose. Each party waives its rights
+to a jury trial in any resulting litigation.</p>
+</div>
+</div>
+</div>
+</div>
+<div id="footer">
+<div id="footer-text">
+Version 0.9<br>
+Last updated 2019-08-07 15:02:40 CEST
+</div>
+</div>
+<!-- ************* docinfo-footer *************************************************************** -->
+<div class="Grid social" style="color:#d5dfea">
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <h2>Quick Links</h2>
+    <ul>
+      <li><a href="../downloads.html">Download</a></li>
+      <li><a href="../userguides/index.html">Documentation</a></li>
+      <li><a href="https://github.com/eclipse/n4js/">Source</a></li>
+      <li><a href="https://github.com/eclipse/n4js/issues">Issues</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="https://www.eclipse.org/forums/index.php/f/365/">Forum</a></li>
+      <li><a href="http://n4js.blogspot.de/">Blog</a></li>
+      <li><a href="https://dev.eclipse.org/mailman/listinfo/n4js-dev">Mailing List</a></li>
+      <li><a href="https://projects.eclipse.org/projects/technology.n4js">Eclipse Project Page</a></li>
+      <li><a href="https://twitter.com/n4jsdev">Tweets by n4jsdev</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="http://www.eclipse.org/">Eclipse Home</a></li>
+      <li><a href="http://www.eclipse.org/legal/privacy.php">Privacy Policy</a></li>
+      <li><a href="http://www.eclipse.org/legal/termsofuse.php">Terms of Use</a></li>
+      <li><a href="http://www.eclipse.org/legal/copyright.php">Copyright Agent</a></li>
+      <li><a href="http://www.eclipse.org/legal/">Legal</a></li>
+    </ul>
+  </div>
+  <div style="clear: both; height: 0; overflow: hidden;"></div>
+</div>
+
+<!-- ************* UI Scripts ************* -->
+<script type="text/javascript" src="scripts/back-to-top.js"></script>
+
+<script type="text/javascript" src="scripts/treeview.js"></script>
+<script type="text/javascript" src="scripts/toc.js"></script>
+
+<!-- ************* Prism.js Syntax Highlighting ************* -->
+<script src="scripts/prism.js"></script>
+
+<script type="text/javascript">
+	// Add the 'toclist' id for search function
+	$(".toc2 > ul").attr('id', 'toclist');
+	// Generate a Search input form
+	$("#toclist > li:first-of-type").before('<input type="text" id="pagesearch" onkeyup="search()" placeholder="Search for section...">');
+	$("#toclist > li:first-of-type").before('<i id="clear" class="fa fa-times-circle-o"></i>');
+	$("#clear").click(function(){
+	    $("#pagesearch").val('');
+	    search();
+	    $('.toc2 > ul').treeView('collapseAll');
+	});
+	// intialize Treeview.js
+	$(".toc2 > ul").treeView();
+	// Initialize Scrollspy
+</script>
+<!-- ************* docinfo-footer *************************************************************** -->
+</body>
+</html>
\ No newline at end of file
diff --git a/design/appendix_d_acronyms.html b/design/appendix_d_acronyms.html
new file mode 100644
index 0000000..768b3d9
--- /dev/null
+++ b/design/appendix_d_acronyms.html
@@ -0,0 +1,1042 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="generator" content="Asciidoctor 1.5.5">
+<meta name="author" content="2019-08-07 15:02:40 CEST">
+<title>N4JS Design Specification</title>
+<link rel="stylesheet" href="styles/spec.min.css">
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.6.3/css/font-awesome.min.css">
+<!-- ************* docinfo ******************************************************************* -->
+
+
+<!-- ************* Favicon ************-->
+<link rel="icon" href="images/favicon.ico" />
+
+<!-- ************* Back-to-top JQuery ************* -->
+<script src="https://code.jquery.com/jquery-1.12.4.js"></script>
+<script src="https://code.jquery.com/ui/1.12.0/jquery-ui.js"></script>
+
+
+<link href="styles/prism.min.css" rel="stylesheet" />
+<script type="text/javascript" async
+  src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2/MathJax.js?config=TeX-MML-AM_CHTML">
+</script>
+
+<!-- ************* Styles ************* -->
+<link rel="stylesheet" type="text/css" href="styles/n4jsspec-adoc.css">
+
+
+<!-- ****************** NavBar ****************** -->
+<div id="menubar">
+	<div class="banner">
+        <a href="https://www.eclipse.org/n4js/#"><img id="logo" src="images/n4js-logo.png" alt="Eclipse N4JS"></a>
+    </div>
+<ul>
+  <li><a href="index.html">Index</a></li>
+</ul>
+</div>
+<!-- ************* docinfo ******************************************************************* -->
+<style>
+      .admonitionblock td.icon .icon-todo:before{content:"\f249";color:#f4ee42}
+    </style>
+</head>
+<body class="book toc2 toc-left">
+<div id="header">
+<h1>N4JS Design Specification</h1>
+<div class="details">
+<span id="author" class="author">2019-08-07 15:02:40 CEST</span><br>
+<span id="revnumber">version 0.9</span>
+</div>
+<div id="toc" class="toc2">
+<div id="toctitle">Table of Contents</div>
+<ul class="sectlevel1">
+<li><a href="introduction.html#_introduction">1. Introduction</a>
+<ul class="sectlevel2">
+<li><a href="introduction.html#notation">1.1. Notation</a></li>
+<li><a href="introduction.html#sec:IDE_Overview">1.2. IDE Components</a>
+<ul class="sectlevel3">
+<li><a href="introduction.html#sec:Naming_Conventions">1.2.1. Naming Conventions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="eclipse_setup.html#_eclipse-setup">2. Eclipse Setup</a>
+<ul class="sectlevel2">
+<li><a href="eclipse_setup.html#_system-requirements">2.1. System Requirements</a></li>
+<li><a href="eclipse_setup.html#_contribute">2.2. Contribute</a>
+<ul class="sectlevel3">
+<li><a href="eclipse_setup.html#_eclipse-installer">2.2.1. Eclipse Installer</a>
+<ul class="sectlevel4">
+<li><a href="eclipse_setup.html#_changing-the-setup-script">2.2.1.1. Changing the Setup Script</a></li>
+</ul>
+</li>
+<li><a href="eclipse_setup.html#_manual-ide-configuration">2.2.2. Manual IDE Configuration</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="release_engineering.html#_release-engineering">3. Release Engineering</a>
+<ul class="sectlevel2">
+<li><a href="release_engineering.html#_nightly-build-on-eclipse-infrastructure">3.1. Nightly build on Eclipse infrastructure</a></li>
+<li><a href="release_engineering.html#_build-the-n4js-ide-from-command-line">3.2. Build the N4JS IDE from command line</a>
+<ul class="sectlevel3">
+<li><a href="release_engineering.html#_publish-maven-tooling-code-org-eclipse-n4js-releng-util-code">3.2.1. Publish maven-tooling <code>org.eclipse.n4js.releng.util</code></a></li>
+<li><a href="release_engineering.html#sec:test-verdaccio">3.2.2. Test Verdaccio containing n4js-libs</a></li>
+<li><a href="release_engineering.html#_generation-of-eclipse-help-for-spec-and-design-document">3.2.3. Generation of Eclipse help for spec and design document</a></li>
+</ul>
+</li>
+<li><a href="release_engineering.html#_updating-frameworks-and-dependencies">3.3. Updating frameworks and dependencies</a>
+<ul class="sectlevel3">
+<li><a href="release_engineering.html#_update-of-eclipse-emf-xtext-etc">3.3.1. Update of Eclipse, EMF, Xtext, etc.</a></li>
+<li><a href="release_engineering.html#_update-of-the-embedded-jre">3.3.2. Update of the embedded JRE</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tips_and_tricks.html#_tips-and-tricks">4. Tips and Tricks</a>
+<ul class="sectlevel2">
+<li><a href="tips_and_tricks.html#_naming">4.1. Naming</a></li>
+<li><a href="tips_and_tricks.html#_logging">4.2. Logging</a></li>
+<li><a href="tips_and_tricks.html#_cancellation-handling">4.3. Cancellation Handling</a></li>
+<li><a href="tips_and_tricks.html#_caching">4.4. Caching</a></li>
+<li><a href="tips_and_tricks.html#_dependency-injection">4.5. Dependency Injection</a></li>
+<li><a href="tips_and_tricks.html#_miscellaneous">4.6. Miscellaneous</a></li>
+</ul>
+</li>
+<li><a href="parser.html#_parser">5. Parser</a>
+<ul class="sectlevel2">
+<li><a href="parser.html#sec:Parser_Overview">5.1. Overview</a></li>
+<li><a href="parser.html#sec:N4JS_Parser">5.2. N4JS Parser</a></li>
+<li><a href="parser.html#sec:Parser_Generation_Post_Processing">5.3. Parser Generation Post-Processing</a>
+<ul class="sectlevel3">
+<li><a href="parser.html#sec:Automatic_Semicolon_Insertion">5.3.1. Automatic Semicolon Insertion</a>
+<ul class="sectlevel4">
+<li><a href="parser.html#sec:Injected_code_in_the_Antlr_grammar_file">5.3.1.1. Injected code in the Antlr grammar file</a></li>
+<li><a href="parser.html#sec:Customized_error_recovery">5.3.1.2. Customized error recovery</a></li>
+</ul>
+</li>
+<li><a href="parser.html#sec:_No_line_terminator_allowed_here__handling">5.3.2. Async and <code>No line terminator allowed here</code> Handling</a></li>
+<li><a href="parser.html#sec:Regular_Expression">5.3.3. Regular Expression</a></li>
+<li><a href="parser.html#sec:Unicode">5.3.4. Unicode</a></li>
+<li><a href="parser.html#sec:Literals">5.3.5. Literals</a></li>
+</ul>
+</li>
+<li><a href="parser.html#sec:Modifiers">5.4. Modifiers</a></li>
+<li><a href="parser.html#sec:Conflict_Resolutions">5.5. Conflict Resolutions</a>
+<ul class="sectlevel3">
+<li><a href="parser.html#sec:Reserved_Keywords_vs__Identifier_Names">5.5.1. Reserved Keywords vs. Identifier Names</a></li>
+<li><a href="parser.html#sec:Operators_and_Generics">5.5.2. Operators and Generics</a></li>
+</ul>
+</li>
+<li><a href="parser.html#sec:Content_Assist_Parser">5.6. Content-Assist Parser</a></li>
+</ul>
+</li>
+<li><a href="type_system.html#_type-system">6. Type System</a>
+<ul class="sectlevel2">
+<li><a href="type_system.html#sec:Type_Model_and_Grammar">6.1. Type Model and Grammar</a>
+<ul class="sectlevel3">
+<li><a href="type_system.html#sec:Type_Model_Overview">6.1.1. Type Model Overview</a></li>
+<li><a href="type_system.html#sec:Built_in_Types">6.1.2. Built-in and Primitive Types</a></li>
+<li><a href="type_system.html#sec:Type_Model_DSL">6.1.3. Type Model DSL</a></li>
+</ul>
+</li>
+<li><a href="type_system.html#sec:Type_System_Implementation">6.2. Type System Implementation</a></li>
+<li><a href="type_system.html#sec:Type_Inference_combined_with_AST_Traversal">6.3. Type Inference of AST</a>
+<ul class="sectlevel3">
+<li><a href="type_system.html#sec:Type_Inference_combined_with_AST_Traversal__Background">6.3.1. Background</a></li>
+<li><a href="type_system.html#sec:Triggering_Type_Inference_of_AST">6.3.2. Triggering</a></li>
+<li><a href="type_system.html#sec:Traversal_Order_During_Type_Inference_of_AST">6.3.3. Traversal Order</a></li>
+<li><a href="type_system.html#sec:Cross_References_During_Type_Inference_of_AST">6.3.4. Cross-References</a></li>
+<li><a href="type_system.html#sec:Function_Accessor_Bodies_During_Type_Inference_of_AST">6.3.5. Function/Accessor Bodies</a></li>
+<li><a href="type_system.html#sec:Poly_Expressions_During_Type_Inference_of_AST">6.3.6. Poly Expressions</a></li>
+<li><a href="type_system.html#sec:Constraint_Solver_used_During_Type_Inference_of_AST">6.3.7. Constraint Solver</a></li>
+<li><a href="type_system.html#sec:Type_Guards_During_Type_Inference_of_AST">6.3.8. Type Guards</a></li>
+</ul>
+</li>
+<li><a href="type_system.html#sec:Structural_Typing">6.4. Structural Typing</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#_type-index">7. Type Index</a>
+<ul class="sectlevel2">
+<li><a href="type_index.html#sec:Type_Index_Design_Rationale">7.1. Design Rationale</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#sec:Getting_the_Xtext_Index_Content_IResourceDescriptions">7.1.1. Getting the Xtext Index (<code>IResourceDescriptions</code>) Content</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#sec:Design_Overview">7.2. Design Overview</a></li>
+<li><a href="type_index.html#sec:N4JS_Resource_Load_States">7.3. N4JS Resource Load States</a></li>
+<li><a href="type_index.html#sec:Type_Builder">7.4. Types Builder</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#sec:Type_Inference_not_allowed_in_Type_Builder">7.4.1. Type Inference not allowed in Types Builder</a></li>
+<li><a href="type_index.html#sec:ComputedTypeReferences">7.4.2. Deferred Type References</a></li>
+<li><a href="type_index.html#sec:Use_cases_of_ComputedTypeRef">7.4.3. Use cases of DeferredTypeRef</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#sec:Incremental_Builder_Overview">7.5. Incremental Builder (Overview)</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#sec:Incremental_Builder_Overview__XtextBuilder">7.5.1. XtextBuilder</a></li>
+<li><a href="type_index.html#sec:Incremental_Builder_Overview__IBuilderState">7.5.2. IBuilderState</a>
+<ul class="sectlevel4">
+<li><a href="type_index.html#copy-and-update-xtext-index">7.5.2.1. Copy and Update Xtext Index</a></li>
+<li><a href="type_index.html#build-state-setup-phase">7.5.2.2. Build State Setup Phase</a></li>
+<li><a href="type_index.html#process-queued-uris">7.5.2.3. Process Queued URIs</a></li>
+<li><a href="type_index.html#queueing-affected-resources">7.5.2.4. Queueing Affected Resources</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#sec:Incremental_Builder_Overview__Example">7.5.3. Example</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#dirty-state-handling">7.6. Dirty state handling</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#use-case-restoring-types-from-user-data">7.6.1. Use case: Restoring types from user data</a></li>
+<li><a href="type_index.html#use-case-updating-the-xtext-index">7.6.2. Use case: Updating the Xtext index</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="project_model.html#_project-model">8. Project Model</a>
+<ul class="sectlevel2">
+<li><a href="project_model.html#sec:Package_json">8.1. Package.json File</a></li>
+<li><a href="project_model.html#_accessing-project-information">8.2. Accessing Project Information</a>
+<ul class="sectlevel3">
+<li><a href="project_model.html#sec:IN4JSCore">8.2.1. IN4JSCore</a></li>
+<li><a href="project_model.html#sec:N4JSModel">8.2.2. N4JSModel</a></li>
+<li><a href="project_model.html#sec:N4JSWorkspace">8.2.3. N4JSWorkspace</a></li>
+<li><a href="project_model.html#sec:N4JSProject">8.2.4. N4JSProject</a></li>
+<li><a href="project_model.html#sec:SourceContainer">8.2.5. SourceContainer</a></li>
+<li><a href="project_model.html#sec:N4JSProjectsStateHelper">8.2.6. N4JSProjectsStateHelper</a></li>
+</ul>
+</li>
+<li><a href="project_model.html#sec:Caching">8.3. Caching</a>
+<ul class="sectlevel3">
+<li><a href="project_model.html#_caching-of-externallibraryworkspace">8.3.1. Caching of ExternalLibraryWorkspace</a></li>
+<li><a href="project_model.html#_caching-of-n4jsprojectsstatehelper">8.3.2. Caching of N4JSProjectsStateHelper</a></li>
+</ul>
+</li>
+<li><a href="project_model.html#sec:WildcardPathFilter">8.4. WildcardPathFilter</a></li>
+<li><a href="project_model.html#sec:ProjectUtils">8.5. ProjectUtils</a></li>
+</ul>
+</li>
+<li><a href="binding.html#_binding">9. Binding</a>
+<ul class="sectlevel2">
+<li><a href="binding.html#sec:Binding_Design_Rationale">9.1. Design Rationale</a></li>
+<li><a href="binding.html#sec:Binding_to_Members">9.2. Binding to Members</a></li>
+<li><a href="binding.html#sec:Binding_Getter_Setter">9.3. Getter / Setter Binding</a></li>
+<li><a href="binding.html#chap:Statics">9.4. Static Member Binding</a></li>
+<li><a href="binding.html#sec:Binding_Enumeration">9.5. Enumeration Literals Binding</a></li>
+<li><a href="binding.html#sec:Accessibility_of_types_and_members">9.6. Accessibility of types and members</a></li>
+<li><a href="binding.html#sec:Member_Scope_Example">9.7. Member Scope Example</a></li>
+<li><a href="binding.html#sec:Scoping_for_Members_of_Composed_Type_Explained">9.8. Scoping for Members of Composed Type (Union/Intersection) Example</a></li>
+<li><a href="binding.html#sec:Binding_of_Structurally_References_Types">9.9. Structurally References Types</a></li>
+<li><a href="binding.html#sec:Building">9.10. Building</a>
+<ul class="sectlevel3">
+<li><a href="binding.html#sec:Build_Phases">9.10.1. Build Phases</a></li>
+<li><a href="binding.html#sec:Build_Scenarios">9.10.2. Build Scenarios</a></li>
+<li><a href="binding.html#sec:Lazy_linking_problem">9.10.3. Lazy linking problem</a></li>
+</ul>
+</li>
+<li><a href="binding.html#sec:Proxies_and_Proxy_Resolution">9.11. Proxies and Proxy Resolution (Overview)</a>
+<ul class="sectlevel3">
+<li><a href="binding.html#xtexts-lazy-linking-proxies">9.11.1. Xtext’s Lazy Linking Proxies</a></li>
+<li><a href="binding.html#standard-emf-proxies">9.11.2. Standard EMF Proxies</a></li>
+<li><a href="binding.html#_how-is-proxy-resolution-triggered">9.11.3. How is Proxy Resolution Triggered?</a></li>
+<li><a href="binding.html#_when-is-proxy-resolution-allowed">9.11.4. When is Proxy Resolution Allowed?</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="validation.html#_validation">10. Validation</a>
+<ul class="sectlevel2">
+<li><a href="validation.html#sec:validation_overview">10.1. Validation overview</a></li>
+<li><a href="validation.html#sec:validation_control_flow">10.2. Validation control flow</a></li>
+<li><a href="validation.html#sec:validation_issue_ids">10.3. Issue IDs and Messages</a></li>
+<li><a href="validation.html#sec:validation_usage_patterns">10.4. Usage Pattern</a></li>
+<li><a href="validation.html#sec:validation_links">10.5. Links</a></li>
+</ul>
+</li>
+<li><a href="references.html#_references">11. References</a>
+<ul class="sectlevel2">
+<li><a href="references.html#sec:usecases">11.1. Use cases</a></li>
+<li><a href="references.html#sec:calculation_algorithm">11.2. Calculation algorithm</a>
+<ul class="sectlevel3">
+<li><a href="references.html#sec:Xtext_default_implementation">11.2.1. Xtext default implementation</a></li>
+<li><a href="references.html#sec:N4_implementation">11.2.2. N4JS implementation</a></li>
+</ul>
+</li>
+<li><a href="references.html#sec:PerformanceOfDependencyCalculation">11.3. Performance Of Dependency Calculation</a></li>
+<li><a href="references.html#sec:kinds_of_references">11.4. Kinds of references</a>
+<ul class="sectlevel3">
+<li><a href="references.html#sec:Cross_References_to_be_ignored">11.4.1. Cross References to be ignored</a></li>
+<li><a href="references.html#sec:Cross_References_to_be_handled">11.4.2. Cross References to be handled</a></li>
+</ul>
+</li>
+<li><a href="references.html#sec:transitive_dependencies">11.5. Transitive dependencies</a></li>
+<li><a href="references.html#sec:find-references">11.6. Find references</a>
+<ul class="sectlevel3">
+<li><a href="references.html#_background">11.6.1. Background</a></li>
+<li><a href="references.html#_how-find-references-work">11.6.2. How Find References Work</a>
+<ul class="sectlevel4">
+<li><a href="references.html#_step-1-convert-cursor-position-to-declared-element">11.6.2.1. Step 1: Convert Cursor Position to Declared Element</a></li>
+<li><a href="references.html#_step-2-convert-declared-element-to-target-uris">11.6.2.2. Step 2: Convert Declared Element to Target URIs</a></li>
+<li><a href="references.html#_step-3-filter-potential-resources">11.6.2.3. Step 3: Filter Potential Resources</a></li>
+<li><a href="references.html#_step-4-search-references-in-resource">11.6.2.4. Step 4: Search References in Resource</a></li>
+<li><a href="references.html#_limitations-and-possible-enhancements">11.6.2.5. Limitations and Possible Enhancements</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="compilation.html#_compilation">12. Compilation</a>
+<ul class="sectlevel2">
+<li><a href="compilation.html#chap:compilation">12.1. Introduction</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:general_design_rationals">12.1.1. General design rationals</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:logging_and_error_reporting">12.1.1.1. Logging and error reporting</a></li>
+<li><a href="compilation.html#sec:progress_monitor">12.1.1.2. Progress monitor</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Xtext_Integration">12.1.2. Xtext Integration</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:xtext_default_behaviour">12.1.2.1. Xtext default behaviour</a></li>
+<li><a href="compilation.html#sec:n4js_requirements">12.1.2.2. N4JS requirements</a></li>
+<li><a href="compilation.html#sec:compiler_discovery_in_ui">12.1.2.3. Compiler discovery in UI</a></li>
+<li><a href="compilation.html#sec:compiler_discovery_in_headless">12.1.2.4. Compiler discovery in headless</a></li>
+<li><a href="compilation.html#sec:general_generator_implementation">12.1.2.5. General generator implementation</a></li>
+<li><a href="compilation.html#sec:general_generator_activation">12.1.2.6. General generator activation</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Overview_of_Input_Models">12.1.3. Overview of the Input Models</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Core_Generator">12.2. Generators</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:Compiler_Components">12.2.1. Generator Components</a></li>
+<li><a href="compilation.html#sec:Generator_architecture">12.2.2. Generator architecture</a></li>
+<li><a href="compilation.html#sec:Unified_Compiler_Configuration">12.2.3. Unified Compiler Configuration</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Transpilers">12.3. Transpilers</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:Phases">12.3.1. Overview</a></li>
+<li><a href="compilation.html#relation-between-ast-and-im">12.3.2. Relation between AST and IM</a></li>
+<li><a href="compilation.html#implementation-overview">12.3.3. Implementation Overview</a></li>
+<li><a href="compilation.html#sec:Guidelines_for_Implementing_Transformations">12.3.4. Guidelines for Implementing Transformations</a></li>
+<li><a href="compilation.html#symbol-table-in-the-im">12.3.5. Symbol Table in the IM</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:N4JS_to_EcmaScript_Transpiler">12.4. N4JS-to-EcmaScript Transpiler</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:Overview_of_Transformations">12.4.1. Overview of Transformations</a></li>
+<li><a href="compilation.html#sec:Transpiling_members">12.4.2. Transpiling members</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:Transpiling_members__Delegating_members">12.4.2.1. Techniques for special member handling</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__Partial_shadowing_of_getter_setter_pairs">12.4.2.2. Partial shadowing</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__Consuming_or_inheriting_members_of_an_interface">12.4.2.3. Consuming or inheriting members of an interface</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__Static_polyfill">12.4.2.4. Static polyfill</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__API_implementation_stubs">12.4.2.5. API / implementation stubs</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Support_for_incomplete_API_implementation_testing_in_the_N4JS_to_EcmaScript_5_Transpiler">12.4.3. Support for incomplete API implementation testing</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:Modifications_in_Impl_projects">12.4.3.1. Modifications in Impl projects</a></li>
+<li><a href="compilation.html#sec:Implementation_of_stub_generation">12.4.3.2. Implementation of stub-generation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:n4jsc_Headless_Compiler_Interface">12.5. n4jsc Headless Compiler Interface</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:building_the_headless_compiler">12.5.1. building the headless compiler</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="execution.html#_execution">13. Execution</a>
+<ul class="sectlevel2">
+<li><a href="execution.html#sec:N4JS_Project_Execution_And_Linking_Model">13.1. N4JS Project Execution And Linking Model</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#subsec:N4JS_Execution_With_NodeJS">13.1.1. N4JS Execution With NodeJS</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:N4JS_Execution_And_Linking_File">13.2. N4JS Execution And Linking File</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#subsec:NodeJS_Specific_ELF">13.2.1. NodeJS Specific ELF</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Runners-execution">13.3. Runners</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#subsec:N4_Runtime_Environments_Convention">13.3.1. N4 Runtime Environments Convention</a></li>
+<li><a href="execution.html#subsec:Passing_Information_from_IDE_to_Execution_Code_in_Runtime_Environment">13.3.2. Passing Information from IDE to Execution Code in Runtime Environment</a></li>
+<li><a href="execution.html#subsec:Runners_Design">13.3.3. Runners Design</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Legacy_Execution_Engine">13.4. Legacy Execution Engine</a></li>
+<li><a href="execution.html#sec:Design">13.5. Design</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#sec:Usage_Outside_N4JSIDE">13.5.1. Usage Outside N4JSIDE</a>
+<ul class="sectlevel4">
+<li><a href="execution.html#sec:Use_Node_with_Maven">13.5.1.1. Use Node with Maven</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Usage_Inside_N4JSIDE">13.5.2. Usage Inside N4JSIDE</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Runtime_Injection">13.6. Runtime Injection</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#sec:Running_String_Code">13.6.1. Running String Code</a></li>
+<li><a href="execution.html#sec:Running_File_Code">13.6.2. Running File Code</a></li>
+<li><a href="execution.html#sec:Injection_Code_Example">13.6.3. Injection Code Example</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#_tests">14. Tests</a>
+<ul class="sectlevel2">
+<li><a href="tests.html#sec:Performance_Tests">14.1. Performance Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Synthetic_Performance_Tests">14.1.1. Synthetic Performance Tests</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:Design_of_Generator">14.1.1.1. Design of Generator</a></li>
+<li><a href="tests.html#sec:Design_of_Performance_Test_Execution">14.1.1.2. Design of Performance Test Configuration and Execution</a></li>
+<li><a href="tests.html#sec:JUnit_Configuration">14.1.1.3. JUnit Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Test_Configuration">14.1.1.4. JUnitBenchmark Test Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Report_Configuration">14.1.1.5. JUnitBenchmark Report Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Run_Configuration">14.1.1.6. JUnitBenchmark Run Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Example">14.1.1.7. JUnitBenchmark Example</a></li>
+<li><a href="tests.html#sec:Note_on_Jenkins_Job">14.1.1.8. Note on Jenkins Job</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#sec:ECMA_Tests">14.2. ECMA Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Grammar_Tests">14.2.1. Grammar Tests</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:Negative_Tests">14.2.1.1. Negative Tests</a></li>
+<li><a href="tests.html#sec:Test_Exclusion">14.2.1.2. Test Exclusion</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Integration_Tests">14.3. Integration Tests</a></li>
+<li><a href="tests.html#sec:Test_Helpers">14.4. Test Helpers</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Parameterized_N4JS_Tests">14.4.1. Parameterized N4JS tests</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:ParameterizedXtextRunner">14.4.1.1. ParameterizedXtextRunner</a></li>
+<li><a href="tests.html#sec:TestCodeProvider">14.4.1.2. TestCodeProvider</a></li>
+<li><a href="tests.html#sec:Example_Of_Parameterized_Parser_Test">14.4.1.3. Example of parameterized parser test</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Issue_Suppression">14.5. Issue Suppression</a></li>
+<li><a href="tests.html#sec:Xpect_Tests">14.6. Xpect Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Xpect_Test_Setup">14.6.1. Xpect Test Setup</a></li>
+<li><a href="tests.html#sec:Xpect_Issue_Suppression">14.6.2. Xpect Issue Suppression</a></li>
+<li><a href="tests.html#sec:Xpect_Provided_Test_Methods">14.6.3. Xpect Provided Test Methods</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#errors">14.6.3.1. errors</a></li>
+<li><a href="tests.html#warnings">14.6.3.2. warnings</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:N4JS_Specific_Xpect_Test_Methods">14.6.4. N4JS Specific Xpect Test Methods</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:XPECT_noerrors">14.6.4.1. noerrors and nowarnings</a></li>
+<li><a href="tests.html#sec:XPECT_scope">14.6.4.2. scope</a></li>
+<li><a href="tests.html#sec:XPECT_scopeWithPosition">14.6.4.3. scopeWithPosition</a></li>
+<li><a href="tests.html#sec:XPECT_scopeWithResource">14.6.4.4. scopeWithResource</a></li>
+<li><a href="tests.html#sec:XPECT_binding">14.6.4.5. binding</a></li>
+<li><a href="tests.html#sec:XPECT_linkedPathname">14.6.4.6. linkedPathname</a></li>
+<li><a href="tests.html#sec:XPECT_type_of">14.6.4.7. type of</a></li>
+<li><a href="tests.html#sec:XPECT_expectedType">14.6.4.8. expectedType</a></li>
+<li><a href="tests.html#sec:XPECT_elementKeyword">14.6.4.9. elementKeyword</a></li>
+<li><a href="tests.html#sec:XPECT_accessModifier">14.6.4.10. accessModifier</a></li>
+<li><a href="tests.html#sec:XPECT_compileResult">14.6.4.11. compileResult</a></li>
+<li><a href="tests.html#sec:XPECT_output">14.6.4.12. output</a></li>
+<li><a href="tests.html#sec:XPECT_outputRegEx">14.6.4.13. outputRegEx</a></li>
+<li><a href="tests.html#sec:XPECT_calculatedAccessModifier">14.6.4.14. calculatedAccessModifier</a></li>
+<li><a href="tests.html#sec:XPECT_spec">14.6.4.15. spec</a></li>
+<li><a href="tests.html#sec:XPECT_deadCode">14.6.4.16. deadCode</a></li>
+<li><a href="tests.html#sec:XPECT_returnOrThrows">14.6.4.17. returnOrThrows</a></li>
+<li><a href="tests.html#sec:XPECT_lint">14.6.4.18. lint</a></li>
+<li><a href="tests.html#sec:XPECT_lintFails">14.6.4.19. lintFails</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:FIXME_Xpect_modifier">14.6.5. FIXME Xpect modifier</a></li>
+<li><a href="tests.html#sec:Expectmatrix_Xpect_Test_Methods">14.6.6. Expectmatrix Xpect tests</a></li>
+<li><a href="tests.html#xpect-lint-tests">14.6.7. Xpect Lint Tests</a></li>
+</ul>
+</li>
+<li><a href="tests.html#xpect-proposal-tests">14.7. Xpect Proposal Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Validation_vs__Non_Validation">14.7.1. Validation vs. Non-Validation</a></li>
+<li><a href="tests.html#sec:General_Proposal_Test_Features">14.7.2. General Proposal Test Features</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:Test_Variables">14.7.2.1. Test Variables</a></li>
+<li><a href="tests.html#sec:Location_and_Selection">14.7.2.2. at – Location and Selection</a></li>
+<li><a href="tests.html#sec:Multi_Line_Expectations_in_Proposal_Tests">14.7.2.3. Multi Line Expectations in Proposal Tests</a></li>
+<li><a href="tests.html#sec:Timeout">14.7.2.4. Timeout and Performance</a></li>
+</ul>
+</li>
+<li><a href="tests.html#proposals-verify-existence-of-proposals">14.7.3. proposals – Verify Existence of Proposals</a></li>
+<li><a href="tests.html#sec:Verify_displayed_string">14.7.4. display – Verify displayed string</a></li>
+<li><a href="tests.html#sec:Apply_Proposal">14.7.5. apply – Apply Proposal</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#resource-application-in-other-files">14.7.5.1. resource – application in other files</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Content_Assist_Cycling">14.7.6. kind – Content Assist Cycling</a></li>
+<li><a href="tests.html#fileValidVerify-validation-status">14.7.7. fileValid – Verify validation status</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Apply_Proposal_And_Execute_Tests">14.8. Apply Proposal And Execute Tests</a></li>
+<li><a href="tests.html#sec:Organize_Imports_Test">14.9. Organize Imports Test</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#organizeimports">14.9.1. organizeImports</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Access_Control_Test">14.10. Access Control Test</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#test-scenarios">14.10.1. Test Scenarios</a></li>
+<li><a href="tests.html#n4js-code-generator">14.10.2. N4JS Code Generator</a></li>
+<li><a href="tests.html#xtext-issue-matcher">14.10.3. Xtext Issue Matcher</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Smoke_Tests">14.11. Smoke Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#how-to-handle-smoke-test-errors">14.11.1. How to handle smoke test errors?</a></li>
+<li><a href="tests.html#smoketester-and-exceptionanalyzer">14.11.2. SmokeTester and ExceptionAnalyzer</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:UI_Tests_with_SWTBot">14.12. UI Tests with SWTBot</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#writing-swtbot-tests">14.12.1. Writing SWTBot Tests</a></li>
+<li><a href="tests.html#running-swtbot-tests">14.12.2. Running SWTBot Tests</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Debugging_UI_Tests">14.13. Debugging UI Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Connecting_to_the_X_server_on_the_build_node">14.13.1. Connecting to the X-server on the build-node</a></li>
+<li><a href="tests.html#sec:Tools_to_investigate_the_java_stack">14.13.2. Tools to investigate the java-stack</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="ui_concepts.html#_ui-concepts">15. UI Concepts</a>
+<ul class="sectlevel2">
+<li><a href="ui_concepts.html#sec:User_Interface_Concepts">15.1. User Interface Concepts</a>
+<ul class="sectlevel3">
+<li><a href="ui_concepts.html#sec:Eclipse_UI_Concepts">15.1.1. Eclipse UI Concepts</a>
+<ul class="sectlevel4">
+<li><a href="ui_concepts.html#sec:Label_Provider">15.1.1.1. Label Provider</a></li>
+<li><a href="ui_concepts.html#sec:Markers">15.1.1.2. Markers</a></li>
+<li><a href="ui_concepts.html#sec:Commands__Toolbar_and_Menus">15.1.1.3. Commands, Toolbar and Menus</a></li>
+<li><a href="ui_concepts.html#sec:Content_Assist">15.1.1.4. Content Assist</a></li>
+<li><a href="ui_concepts.html#sec:Quick_Fixes">15.1.1.5. Quick Fixes</a></li>
+<li><a href="ui_concepts.html#sec:Quick_Assist">15.1.1.6. Quick Assist</a></li>
+<li><a href="ui_concepts.html#sec:Clean_Up_Actions">15.1.1.7. Clean Up Actions</a></li>
+<li><a href="ui_concepts.html#sec:Save_Actions">15.1.1.8. Save Actions</a></li>
+<li><a href="ui_concepts.html#sec:Auto_Edit">15.1.1.9. Auto Edit</a></li>
+<li><a href="ui_concepts.html#sec:Template_Proposals">15.1.1.10. Template Proposals</a></li>
+<li><a href="ui_concepts.html#sec:Outline_View___Quick_Outline">15.1.1.11. Outline View / Quick Outline</a></li>
+<li><a href="ui_concepts.html#sec:Navigator__Package_Explorer__Project_Explorer">15.1.1.12. Navigator, Package Explorer, Project Explorer</a></li>
+<li><a href="ui_concepts.html#sec:Hyperlinking_and_Navigation">15.1.1.13. Hyperlinking and Navigation</a></li>
+<li><a href="ui_concepts.html#sec:Syntax_and_Semantic_Coloring">15.1.1.14. Syntax and Semantic Coloring</a></li>
+<li><a href="ui_concepts.html#sec:Code_Formatter">15.1.1.15. Code Formatter</a></li>
+<li><a href="ui_concepts.html#sec:Wizards">15.1.1.16. Wizards</a></li>
+<li><a href="ui_concepts.html#sec:Cheat_Sheets">15.1.1.17. Cheat Sheets</a></li>
+<li><a href="ui_concepts.html#sec:Context_sensitive_Help">15.1.1.18. Context-sensitive Help</a></li>
+<li><a href="ui_concepts.html#sec:Hovers">15.1.1.19. Hovers</a></li>
+<li><a href="ui_concepts.html#sec:Folding">15.1.1.20. Folding</a></li>
+<li><a href="ui_concepts.html#sec:Customizable_validation___severity">15.1.1.21. Customizable validation / severity</a></li>
+<li><a href="ui_concepts.html#sec:Proposals">15.1.1.22. Proposals</a></li>
+</ul>
+</li>
+<li><a href="ui_concepts.html#sec:Non_Eclipse_UI_Concepts">15.1.2. Non-Eclipse UI Concepts</a>
+<ul class="sectlevel4">
+<li><a href="ui_concepts.html#sec:Overlays">15.1.2.1. Overlays</a></li>
+<li><a href="ui_concepts.html#sec:Goto__Inferred__Type">15.1.2.2. Goto (Inferred) Type</a></li>
+<li><a href="ui_concepts.html#sec:Postfix_Completion">15.1.2.3. Postfix Completion</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="ui_concepts.html#_user-interface-resources">15.2. User Interface Resources</a>
+<ul class="sectlevel3">
+<li><a href="ui_concepts.html#_icons">15.2.1. Icons</a>
+<ul class="sectlevel4">
+<li><a href="ui_concepts.html#_eclipse-platform-icons">15.2.1.1. Eclipse Platform Icons</a></li>
+<li><a href="ui_concepts.html#_n4js-specific-icons">15.2.1.2. N4JS Specific Icons</a></li>
+<li><a href="ui_concepts.html#_high-resolution-icons">15.2.1.3. High Resolution Icons</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="formatting.html#_formatting">16. Formatting</a>
+<ul class="sectlevel2">
+<li><a href="formatting.html#sec:FmtObjective">16.1. Objective</a>
+<ul class="sectlevel3">
+<li><a href="formatting.html#sec:FmtFormatting_Comments">16.1.1. Formatting Comments</a></li>
+</ul>
+</li>
+<li><a href="formatting.html#sec:FmtArchitecture">16.2. Architecture</a>
+<ul class="sectlevel3">
+<li><a href="formatting.html#sec:Implementation_example">16.2.1. Implementation example</a></li>
+</ul>
+</li>
+<li><a href="formatting.html#sec:FmtFormatter_Implementation_Guidelines">16.3. Formatter Implementation Guidelines</a></li>
+<li><a href="formatting.html#sec:FmtConfiguration">16.4. Configuration</a></li>
+<li><a href="formatting.html#sec:FmtUI_Integration">16.5. UI Integration</a></li>
+<li><a href="formatting.html#sec:FmtUnit_Testing_with_Xpect">16.6. Unit Testing with Xpect</a></li>
+</ul>
+</li>
+<li><a href="external_libraries.html#_external-libraries">17. External Libraries</a>
+<ul class="sectlevel2">
+<li><a href="external_libraries.html#sec:Major_Components">17.1. Major Components</a>
+<ul class="sectlevel3">
+<li><a href="external_libraries.html#subsec:External_Resources">17.1.1. External Resources</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Workspace">17.1.2. External Library Workspace</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Preference_Store">17.1.3. External Library Preference Store</a></li>
+<li><a href="external_libraries.html#subsec:npm_Manager">17.1.4. Library Manager</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Builder_Helper">17.1.5. External Library Builder</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Xtext_Index_Persister">17.1.6. External Library Xtext Index Persister</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Preference_Page">17.1.7. External Library Preference Page</a></li>
+</ul>
+</li>
+<li><a href="external_libraries.html#sec:Headless_External_Library_Support">17.2. Headless External Library Support</a>
+<ul class="sectlevel3">
+<li><a href="external_libraries.html#_custom-npm-settings">17.2.1. Custom npm settings</a></li>
+</ul>
+</li>
+<li><a href="external_libraries.html#sec:lmFutureWork">17.3. Future Work</a>
+<ul class="sectlevel3">
+<li><a href="external_libraries.html#subsec:lmMultipleDependencyScope">17.3.1. Multiple Dependency Scope</a></li>
+<li><a href="external_libraries.html#subsec:lmRunTestsFromLibrary">17.3.2. Run Tests from TestLibrary</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="json_support.html#sec:JSON_Support">18. JSON Support</a>
+<ul class="sectlevel2">
+<li><a href="json_support.html#sec:JSON_Parser">18.1. JSON Parser</a>
+<ul class="sectlevel3">
+<li><a href="json_support.html#sec:JSON_Parser_Unicode_Escaping">18.1.1. Escaping Unicode Control Characters in String Literals</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Empty_Text">18.1.2. Empty Text</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Nested_Structures">18.1.3. Nested Structures</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Whitespace">18.1.4. Whitespace</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Comments">18.1.5. Comments</a></li>
+</ul>
+</li>
+<li><a href="json_support.html#sec:JSON_Language_Extensions">18.2. JSON Language Extensions</a>
+<ul class="sectlevel3">
+<li><a href="json_support.html#sec:JSON_Validator_Extensions">18.2.1. JSON Validator Extensions</a>
+<ul class="sectlevel4">
+<li><a href="json_support.html#sec:File_Specitic_Validator_Extensions">18.2.1.1. File-Specific Validator Extensions</a></li>
+<li><a href="json_support.html#sec:JSON_Declarative_JSON_Validator_Extensions">18.2.1.2. Declarative JSON Validator Extensions</a></li>
+</ul>
+</li>
+<li><a href="json_support.html#_json-resource-description-strategy">18.2.2. JSON Resource Description Strategy</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_jsdoc">19. JSDoc</a>
+<ul class="sectlevel2">
+<li><a href="jsdoc.html#sec:Design_Rationale">19.1. Design Rationale</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#_general-design">19.1.1. General Design</a></li>
+<li><a href="jsdoc.html#sec:Type_Expressions">19.1.2. Type Expressions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="docexporter.html#_docexporter">20. DocExporter</a>
+<ul class="sectlevel2">
+<li><a href="docexporter.html#sec:Specification_Exporter">20.1. Specification Exporter</a></li>
+</ul>
+</li>
+<li><a href="rename_refactoring.html#_rename-refactoring">21. Rename Refactoring</a>
+<ul class="sectlevel2">
+<li><a href="rename_refactoring.html#_rename-refactoring-ui-interaction">21.1. Rename Refactoring UI interaction</a></li>
+<li><a href="rename_refactoring.html#_renameelementprocessor-interaction">21.2. RenameElementProcessor interaction</a></li>
+</ul>
+</li>
+<li><a href="flow_graphs.html#chap:flowgraphs">22. Flow Graphs</a>
+<ul class="sectlevel2">
+<li><a href="flow_graphs.html#sec:flowgraphs_overview">22.1. Flow graphs overview</a>
+<ul class="sectlevel3">
+<li><a href="flow_graphs.html#_internal-graph">22.1.1. Internal graph</a></li>
+<li><a href="flow_graphs.html#_optimizations">22.1.2. Optimizations</a></li>
+<li><a href="flow_graphs.html#_api-for-client-analyses">22.1.3. API for client analyses</a>
+<ul class="sectlevel4">
+<li><a href="flow_graphs.html#_mapping-from-internal-to-ast-elements">22.1.3.1. Mapping from internal to AST elements</a></li>
+<li><a href="flow_graphs.html#_graph-visitor">22.1.3.2. Graph visitor</a></li>
+<li><a href="flow_graphs.html#_graph-explorer">22.1.3.3. Graph explorer</a></li>
+<li><a href="flow_graphs.html#_branch-walker">22.1.3.4. Branch walker</a></li>
+<li><a href="flow_graphs.html#_example-1-compute-string-for-each-path">22.1.3.5. Example 1: Compute string for each path</a></li>
+<li><a href="flow_graphs.html#_path-quantor">22.1.3.6. Path quantor</a></li>
+</ul>
+</li>
+<li><a href="flow_graphs.html#_control-flow-analyses">22.1.4. Control flow analyses</a>
+<ul class="sectlevel4">
+<li><a href="flow_graphs.html#_dead-code-analysis">22.1.4.1. Dead code analysis</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="flow_graphs.html#sec:dataflow">22.2. Dataflow</a>
+<ul class="sectlevel3">
+<li><a href="flow_graphs.html#_dataflow-graph">22.2.1. Dataflow graph</a></li>
+<li><a href="flow_graphs.html#_dataflow-analyses">22.2.2. Dataflow analyses</a>
+<ul class="sectlevel4">
+<li><a href="flow_graphs.html#_def-def-def-nothing-analysis">22.2.2.1. Def&#8594;Def / Def&#8594;Nothing analysis</a></li>
+<li><a href="flow_graphs.html#_def-use-decl-analysis">22.2.2.2. Def|Use&#8592;Decl analysis</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="publish_npms.html#sec:publish-npms-to-public">23. Publish npms</a>
+<ul class="sectlevel2">
+<li><a href="publish_npms.html#sec:publish-npms-n4js-maven">23.1. Publish n4js-libs to during  maven build</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Hints">Appendix A: Hints</a>
+<ul class="sectlevel2">
+<li><a href="appendix_a_hints.html#sec:XtextInjection">A.1. Xtext Injection</a>
+<ul class="sectlevel3">
+<li><a href="appendix_a_hints.html#sec:DI_MultipleInjectors_Singletons">A.1.1. Multiple Injectors and Singletons</a>
+<ul class="sectlevel4">
+<li><a href="appendix_a_hints.html#sec:DI_avoid_duplicate_singletons">A.1.1.1. Avoiding duplicate singletons</a>
+<ul class="sectlevel5">
+<li><a href="appendix_a_hints.html#sec:DI_binding_in_shared">A.1.1.1.1. Defining binding in the shared injector</a></li>
+<li><a href="appendix_a_hints.html#sec:DI_binding_in_custom">A.1.1.1.2. Defining binding in the custom injector</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:DI_Hints">A.1.2. Dependency Injection Hints</a>
+<ul class="sectlevel4">
+<li><a href="appendix_a_hints.html#sec:DI_custom_bundle">A.1.2.1. Use DI in custom bundle, use DI with extensions</a>
+<ul class="sectlevel5">
+<li><a href="appendix_a_hints.html#sec:DI_custom_bundle_problem">A.1.2.1.1. Problem</a></li>
+<li><a href="appendix_a_hints.html#sec:DI_custom_bundle_solution">A.1.2.1.2. Solution</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Access_Other_DSL_Injector">A.1.2.2. How do I get the Guice Injector of my language?</a>
+<ul class="sectlevel5">
+<li><a href="appendix_a_hints.html#sec:DSL_Injector_UI_context">A.1.2.2.1. UI context</a></li>
+<li><a href="appendix_a_hints.html#sec:DSL_Injector_Non_UI_context">A.1.2.2.2. Non UI context but with injection context</a></li>
+<li><a href="appendix_a_hints.html#sec:DSL_Injector_Non_UI_non_injection_context">A.1.2.2.3. Non UI context without injection context</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Cancel_Indicator">A.1.2.3. How do I get cancel indicators in different contexts?</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Eclipse">A.2. Eclipse</a>
+<ul class="sectlevel3">
+<li><a href="appendix_a_hints.html#sec:Show_Xtext_Index">A.2.1. Show the current Xtext index</a></li>
+<li><a href="appendix_a_hints.html#sec:Plugin_spy">A.2.2. Plug-in spy</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Maven-hints">A.3. Maven</a>
+<ul class="sectlevel3">
+<li><a href="appendix_a_hints.html#how-to-check-for-maven-mojo-updates">A.3.1. How to check for Maven MOJO updates</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#_module-loading">Appendix B: Module Loading</a>
+<ul class="sectlevel2">
+<li><a href="appendix_b_module_loading.html#sec:Dependency_Management">B.1. Dependency Management</a></li>
+<li><a href="appendix_b_module_loading.html#ecmascript-modules">B.2. ECMAScript Modules</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:ES5_Modules_Systems">B.2.1. ES5 Modules Systems</a></li>
+<li><a href="appendix_b_module_loading.html#sec:ES6_Modules">B.2.2. ES6 Modules</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:ECMAScript_Module_Loaders">B.3. ECMAScript Module Loaders</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:ES6_Module_Loaders">B.3.1. ES6 Module Loaders</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Polyfills_for_ES6_Module_Loaders">B.3.2. Polyfills for ES6 Module Loaders</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:es6_module_loader">B.3.2.1. es6-module-loader</a></li>
+<li><a href="appendix_b_module_loading.html#sec:SystemJS">B.3.2.2. SystemJS</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Demo">B.3.2.3. Demo</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#case-study-typescript">B.4. Case Study : TypeScript</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:ES6_Modules_Support">B.4.1. ES6 Modules Support</a></li>
+<li><a href="appendix_b_module_loading.html#sec:TypeScript_and_Module_Loading">B.4.2. TypeScript and Module Loading</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Cyclic_Dependencies">B.5. Cyclic Dependencies</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:Setup">B.5.1. Setup</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Transpile_and_Execute">B.5.2. Transpile and Execute</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Module_Format___AMD">B.5.2.1. Module Format = AMD</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Module_Format___CommonJS">B.5.2.2. Module Format = CommonJS</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Module_Format___SystemJS">B.5.2.3. Module Format = SystemJS</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Conclusion">B.5.3. Conclusion</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#system.register-as-transpilation-target">B.6. System.register as transpilation target</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:Introduction">B.6.1. Introduction</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:External_Transpilers">B.6.1.1. External Transpilers</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Example_of_a_System_register_module">B.6.1.2. Example of a System.register module</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Structure_of_a_System_register_module">B.6.2. Structure of a System.register module</a></li>
+<li><a href="appendix_b_module_loading.html#_transpilation-hints">B.6.3. Transpilation Hints</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Handling_Imports">B.6.3.1. Handling Imports</a></li>
+<li><a href="appendix_b_module_loading.html#sec:__exportFn__">B.6.3.2. &lt;&lt;exportFn&gt;&gt;</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Handling_Exports">B.6.3.3. Handling Exports</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Examples_w__Circular_Dependencies">B.6.4. Examples w/ Circular Dependencies</a></li>
+<li><a href="appendix_b_module_loading.html#sec:N4JS_Examples_w__Circular_Dependencies">B.6.5. N4JS Examples w/ Circular Dependencies</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Unresolved_Cyclic_Dependencies">B.6.5.1. Unresolved Cyclic Dependencies</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Variables___Functions">B.6.5.2. Examples with Variables &amp; Functions</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Classes">B.6.5.3. Examples with Classes</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Examples_with_SubClassing">B.6.5.4. Examples with SubClassing</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Miscellaneous">B.6.5.5. Miscellaneous</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#_resources">B.6.6. Resources</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:CommonJS_as_transpilation_target">B.7. CommonJS as transpilation target</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#_introduction-2">B.7.1. Introduction</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Transpilation_Hints">B.7.2. Transpilation Hints</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Import_Statements">B.7.2.1. Import Statements</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Export_Statements">B.7.2.2. Export Statements</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Tracking_Live_Bindings">B.7.2.3. Tracking Live Bindings</a></li>
+<li><a href="appendix_b_module_loading.html#sec:A_complete_example">B.7.2.4. A complete example</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#_resources-2">B.7.3. Resources</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_c_license.html#sec:License">Appendix C: License</a></li>
+<li><a href="#sec:Acronyms">Appendix D: Acronyms</a></li>
+<li><a href="appendix_e_bibliography_and_footnotes.html#_bibliography-and-footnotes">Appendix E: Bibliography and Footnotes</a></li>
+</ul>
+</div>
+</div>
+<div id="content"><div class="sect1">
+<h2 id="sec:Acronyms"><a class="anchor" href="#sec:Acronyms"></a><a class="link" href="#sec:Acronyms">Appendix D: Acronyms</a></h2>
+<div class="sectionbody">
+<table id="AC" class="tableblock frame-all grid-all spread language-bash">
+<colgroup>
+<col style="width: 12.5%;">
+<col style="width: 37.5%;">
+<col style="width: 12.5%;">
+<col style="width: 37.5%;">
+</colgroup>
+<tbody>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>CDep</code></p></td>
+<th class="tableblock halign-center valign-top"><p class="tableblock">Compile-Time Dependency</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>RDep</code></p></td>
+<th class="tableblock halign-center valign-top"><p class="tableblock">Run-Time Dependency</p></th>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>LDep</code></p></td>
+<th class="tableblock halign-center valign-top"><p class="tableblock">Load-Time Dependency</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>IDep</code></p></td>
+<th class="tableblock halign-center valign-top"><p class="tableblock">Initialization-Time Dependency</p></th>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>EDep</code></p></td>
+<th class="tableblock halign-center valign-top"><p class="tableblock">Execution-Time Dependency</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>AC</code></p></td>
+<th class="tableblock halign-center valign-top"><p class="tableblock">Acceptance Criteria</p></th>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>ANTLR</code></p></td>
+<th class="tableblock halign-center valign-top"><p class="tableblock">ANother Tool for Language Recognition</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>API</code></p></td>
+<th class="tableblock halign-center valign-top"><p class="tableblock">Application Programming Interface</p></th>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>AST</code></p></td>
+<th class="tableblock halign-center valign-top"><p class="tableblock">Abstract Syntax Tree</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>ASI</code></p></td>
+<th class="tableblock halign-center valign-top"><p class="tableblock">Automatic Semicolon Insertion</p></th>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>AST</code></p></td>
+<th class="tableblock halign-center valign-top"><p class="tableblock">Abstract Syntax Tree</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>BNF</code></p></td>
+<th class="tableblock halign-center valign-top"><p class="tableblock">Backus-Naur Form</p></th>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>CA</code></p></td>
+<th class="tableblock halign-center valign-top"><p class="tableblock">Content-Assist</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>CSP</code></p></td>
+<th class="tableblock halign-center valign-top"><p class="tableblock">Constraint Satisfaction Problem</p></th>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>CLI</code></p></td>
+<th class="tableblock halign-center valign-top"><p class="tableblock">Command Line Interface</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>DOM</code></p></td>
+<th class="tableblock halign-center valign-top"><p class="tableblock">Document Object Model</p></th>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>DSL</code></p></td>
+<th class="tableblock halign-center valign-top"><p class="tableblock">Domain Specific Language</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>EBNF</code></p></td>
+<th class="tableblock halign-center valign-top"><p class="tableblock">Extended Backus-Naur Form</p></th>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>EMF</code></p></td>
+<th class="tableblock halign-center valign-top"><p class="tableblock">Eclipse Modeling Framework</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>EPL</code></p></td>
+<th class="tableblock halign-center valign-top"><p class="tableblock">Eclipse Public License</p></th>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>FQN</code></p></td>
+<th class="tableblock halign-center valign-top"><p class="tableblock">Fully Qualified Name</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>GLB</code></p></td>
+<th class="tableblock halign-center valign-top"><p class="tableblock">Greatest Lower Bound, also known as <strong>infimum</strong></p></th>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>GPL</code></p></td>
+<th class="tableblock halign-center valign-top"><p class="tableblock">GNU General Public License</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>IDE</code></p></td>
+<th class="tableblock halign-center valign-top"><p class="tableblock">Integrated Development Environment</p></th>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>IDL</code></p></td>
+<th class="tableblock halign-center valign-top"><p class="tableblock">Interface Definition Language</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>LSP</code></p></td>
+<th class="tableblock halign-center valign-top"><p class="tableblock">Liskov Substitution Principle</p></th>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>LUB</code></p></td>
+<th class="tableblock halign-center valign-top"><p class="tableblock">Least Upper Bound, also known as <strong>supremum</strong></p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>N4JS</code></p></td>
+<th class="tableblock halign-center valign-top"><p class="tableblock">NumberFour JavaScript</p></th>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>UI</code></p></td>
+<th class="tableblock halign-center valign-top"><p class="tableblock">User Interface</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>UML</code></p></td>
+<th class="tableblock halign-center valign-top"><p class="tableblock">Unified Modeling Language</p></th>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>VM</code></p></td>
+<th class="tableblock halign-center valign-top"><p class="tableblock">Virtual Machine</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>XML</code></p></td>
+<th class="tableblock halign-center valign-top"><p class="tableblock">Extensible Markup Language</p></th>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>XSLT</code></p></td>
+<th class="tableblock halign-center valign-top"><p class="tableblock"><a href="#XSL">XSL</a> Transformations</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>XSL <a id="XSL"></a></code></p></td>
+<th class="tableblock halign-center valign-top"><p class="tableblock">Extensible Stylesheet Language</p></th>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>WYSIWYG</code></p></td>
+<th class="tableblock halign-center valign-top"><p class="tableblock">What You See Is What You Get</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>WLOG</code></p></td>
+<th class="tableblock halign-center valign-top"><p class="tableblock">without loss of generality</p></th>
+</tr>
+</tbody>
+</table>
+</div>
+</div>
+</div>
+<div id="footer">
+<div id="footer-text">
+Version 0.9<br>
+Last updated 2019-08-07 15:02:40 CEST
+</div>
+</div>
+<!-- ************* docinfo-footer *************************************************************** -->
+<div class="Grid social" style="color:#d5dfea">
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <h2>Quick Links</h2>
+    <ul>
+      <li><a href="../downloads.html">Download</a></li>
+      <li><a href="../userguides/index.html">Documentation</a></li>
+      <li><a href="https://github.com/eclipse/n4js/">Source</a></li>
+      <li><a href="https://github.com/eclipse/n4js/issues">Issues</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="https://www.eclipse.org/forums/index.php/f/365/">Forum</a></li>
+      <li><a href="http://n4js.blogspot.de/">Blog</a></li>
+      <li><a href="https://dev.eclipse.org/mailman/listinfo/n4js-dev">Mailing List</a></li>
+      <li><a href="https://projects.eclipse.org/projects/technology.n4js">Eclipse Project Page</a></li>
+      <li><a href="https://twitter.com/n4jsdev">Tweets by n4jsdev</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="http://www.eclipse.org/">Eclipse Home</a></li>
+      <li><a href="http://www.eclipse.org/legal/privacy.php">Privacy Policy</a></li>
+      <li><a href="http://www.eclipse.org/legal/termsofuse.php">Terms of Use</a></li>
+      <li><a href="http://www.eclipse.org/legal/copyright.php">Copyright Agent</a></li>
+      <li><a href="http://www.eclipse.org/legal/">Legal</a></li>
+    </ul>
+  </div>
+  <div style="clear: both; height: 0; overflow: hidden;"></div>
+</div>
+
+<!-- ************* UI Scripts ************* -->
+<script type="text/javascript" src="scripts/back-to-top.js"></script>
+
+<script type="text/javascript" src="scripts/treeview.js"></script>
+<script type="text/javascript" src="scripts/toc.js"></script>
+
+<!-- ************* Prism.js Syntax Highlighting ************* -->
+<script src="scripts/prism.js"></script>
+
+<script type="text/javascript">
+	// Add the 'toclist' id for search function
+	$(".toc2 > ul").attr('id', 'toclist');
+	// Generate a Search input form
+	$("#toclist > li:first-of-type").before('<input type="text" id="pagesearch" onkeyup="search()" placeholder="Search for section...">');
+	$("#toclist > li:first-of-type").before('<i id="clear" class="fa fa-times-circle-o"></i>');
+	$("#clear").click(function(){
+	    $("#pagesearch").val('');
+	    search();
+	    $('.toc2 > ul').treeView('collapseAll');
+	});
+	// intialize Treeview.js
+	$(".toc2 > ul").treeView();
+	// Initialize Scrollspy
+</script>
+<!-- ************* docinfo-footer *************************************************************** -->
+</body>
+</html>
\ No newline at end of file
diff --git a/design/appendix_e_bibliography_and_footnotes.html b/design/appendix_e_bibliography_and_footnotes.html
new file mode 100644
index 0000000..40b3f2f
--- /dev/null
+++ b/design/appendix_e_bibliography_and_footnotes.html
@@ -0,0 +1,1009 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="generator" content="Asciidoctor 1.5.5">
+<meta name="author" content="2019-08-07 15:02:40 CEST">
+<title>N4JS Design Specification</title>
+<link rel="stylesheet" href="styles/spec.min.css">
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.6.3/css/font-awesome.min.css">
+<!-- ************* docinfo ******************************************************************* -->
+
+
+<!-- ************* Favicon ************-->
+<link rel="icon" href="images/favicon.ico" />
+
+<!-- ************* Back-to-top JQuery ************* -->
+<script src="https://code.jquery.com/jquery-1.12.4.js"></script>
+<script src="https://code.jquery.com/ui/1.12.0/jquery-ui.js"></script>
+
+
+<link href="styles/prism.min.css" rel="stylesheet" />
+<script type="text/javascript" async
+  src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2/MathJax.js?config=TeX-MML-AM_CHTML">
+</script>
+
+<!-- ************* Styles ************* -->
+<link rel="stylesheet" type="text/css" href="styles/n4jsspec-adoc.css">
+
+
+<!-- ****************** NavBar ****************** -->
+<div id="menubar">
+	<div class="banner">
+        <a href="https://www.eclipse.org/n4js/#"><img id="logo" src="images/n4js-logo.png" alt="Eclipse N4JS"></a>
+    </div>
+<ul>
+  <li><a href="index.html">Index</a></li>
+</ul>
+</div>
+<!-- ************* docinfo ******************************************************************* -->
+<style>
+      .admonitionblock td.icon .icon-todo:before{content:"\f249";color:#f4ee42}
+    </style>
+</head>
+<body class="book toc2 toc-left">
+<div id="header">
+<h1>N4JS Design Specification</h1>
+<div class="details">
+<span id="author" class="author">2019-08-07 15:02:40 CEST</span><br>
+<span id="revnumber">version 0.9</span>
+</div>
+<div id="toc" class="toc2">
+<div id="toctitle">Table of Contents</div>
+<ul class="sectlevel1">
+<li><a href="introduction.html#_introduction">1. Introduction</a>
+<ul class="sectlevel2">
+<li><a href="introduction.html#notation">1.1. Notation</a></li>
+<li><a href="introduction.html#sec:IDE_Overview">1.2. IDE Components</a>
+<ul class="sectlevel3">
+<li><a href="introduction.html#sec:Naming_Conventions">1.2.1. Naming Conventions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="eclipse_setup.html#_eclipse-setup">2. Eclipse Setup</a>
+<ul class="sectlevel2">
+<li><a href="eclipse_setup.html#_system-requirements">2.1. System Requirements</a></li>
+<li><a href="eclipse_setup.html#_contribute">2.2. Contribute</a>
+<ul class="sectlevel3">
+<li><a href="eclipse_setup.html#_eclipse-installer">2.2.1. Eclipse Installer</a>
+<ul class="sectlevel4">
+<li><a href="eclipse_setup.html#_changing-the-setup-script">2.2.1.1. Changing the Setup Script</a></li>
+</ul>
+</li>
+<li><a href="eclipse_setup.html#_manual-ide-configuration">2.2.2. Manual IDE Configuration</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="release_engineering.html#_release-engineering">3. Release Engineering</a>
+<ul class="sectlevel2">
+<li><a href="release_engineering.html#_nightly-build-on-eclipse-infrastructure">3.1. Nightly build on Eclipse infrastructure</a></li>
+<li><a href="release_engineering.html#_build-the-n4js-ide-from-command-line">3.2. Build the N4JS IDE from command line</a>
+<ul class="sectlevel3">
+<li><a href="release_engineering.html#_publish-maven-tooling-code-org-eclipse-n4js-releng-util-code">3.2.1. Publish maven-tooling <code>org.eclipse.n4js.releng.util</code></a></li>
+<li><a href="release_engineering.html#sec:test-verdaccio">3.2.2. Test Verdaccio containing n4js-libs</a></li>
+<li><a href="release_engineering.html#_generation-of-eclipse-help-for-spec-and-design-document">3.2.3. Generation of Eclipse help for spec and design document</a></li>
+</ul>
+</li>
+<li><a href="release_engineering.html#_updating-frameworks-and-dependencies">3.3. Updating frameworks and dependencies</a>
+<ul class="sectlevel3">
+<li><a href="release_engineering.html#_update-of-eclipse-emf-xtext-etc">3.3.1. Update of Eclipse, EMF, Xtext, etc.</a></li>
+<li><a href="release_engineering.html#_update-of-the-embedded-jre">3.3.2. Update of the embedded JRE</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tips_and_tricks.html#_tips-and-tricks">4. Tips and Tricks</a>
+<ul class="sectlevel2">
+<li><a href="tips_and_tricks.html#_naming">4.1. Naming</a></li>
+<li><a href="tips_and_tricks.html#_logging">4.2. Logging</a></li>
+<li><a href="tips_and_tricks.html#_cancellation-handling">4.3. Cancellation Handling</a></li>
+<li><a href="tips_and_tricks.html#_caching">4.4. Caching</a></li>
+<li><a href="tips_and_tricks.html#_dependency-injection">4.5. Dependency Injection</a></li>
+<li><a href="tips_and_tricks.html#_miscellaneous">4.6. Miscellaneous</a></li>
+</ul>
+</li>
+<li><a href="parser.html#_parser">5. Parser</a>
+<ul class="sectlevel2">
+<li><a href="parser.html#sec:Parser_Overview">5.1. Overview</a></li>
+<li><a href="parser.html#sec:N4JS_Parser">5.2. N4JS Parser</a></li>
+<li><a href="parser.html#sec:Parser_Generation_Post_Processing">5.3. Parser Generation Post-Processing</a>
+<ul class="sectlevel3">
+<li><a href="parser.html#sec:Automatic_Semicolon_Insertion">5.3.1. Automatic Semicolon Insertion</a>
+<ul class="sectlevel4">
+<li><a href="parser.html#sec:Injected_code_in_the_Antlr_grammar_file">5.3.1.1. Injected code in the Antlr grammar file</a></li>
+<li><a href="parser.html#sec:Customized_error_recovery">5.3.1.2. Customized error recovery</a></li>
+</ul>
+</li>
+<li><a href="parser.html#sec:_No_line_terminator_allowed_here__handling">5.3.2. Async and <code>No line terminator allowed here</code> Handling</a></li>
+<li><a href="parser.html#sec:Regular_Expression">5.3.3. Regular Expression</a></li>
+<li><a href="parser.html#sec:Unicode">5.3.4. Unicode</a></li>
+<li><a href="parser.html#sec:Literals">5.3.5. Literals</a></li>
+</ul>
+</li>
+<li><a href="parser.html#sec:Modifiers">5.4. Modifiers</a></li>
+<li><a href="parser.html#sec:Conflict_Resolutions">5.5. Conflict Resolutions</a>
+<ul class="sectlevel3">
+<li><a href="parser.html#sec:Reserved_Keywords_vs__Identifier_Names">5.5.1. Reserved Keywords vs. Identifier Names</a></li>
+<li><a href="parser.html#sec:Operators_and_Generics">5.5.2. Operators and Generics</a></li>
+</ul>
+</li>
+<li><a href="parser.html#sec:Content_Assist_Parser">5.6. Content-Assist Parser</a></li>
+</ul>
+</li>
+<li><a href="type_system.html#_type-system">6. Type System</a>
+<ul class="sectlevel2">
+<li><a href="type_system.html#sec:Type_Model_and_Grammar">6.1. Type Model and Grammar</a>
+<ul class="sectlevel3">
+<li><a href="type_system.html#sec:Type_Model_Overview">6.1.1. Type Model Overview</a></li>
+<li><a href="type_system.html#sec:Built_in_Types">6.1.2. Built-in and Primitive Types</a></li>
+<li><a href="type_system.html#sec:Type_Model_DSL">6.1.3. Type Model DSL</a></li>
+</ul>
+</li>
+<li><a href="type_system.html#sec:Type_System_Implementation">6.2. Type System Implementation</a></li>
+<li><a href="type_system.html#sec:Type_Inference_combined_with_AST_Traversal">6.3. Type Inference of AST</a>
+<ul class="sectlevel3">
+<li><a href="type_system.html#sec:Type_Inference_combined_with_AST_Traversal__Background">6.3.1. Background</a></li>
+<li><a href="type_system.html#sec:Triggering_Type_Inference_of_AST">6.3.2. Triggering</a></li>
+<li><a href="type_system.html#sec:Traversal_Order_During_Type_Inference_of_AST">6.3.3. Traversal Order</a></li>
+<li><a href="type_system.html#sec:Cross_References_During_Type_Inference_of_AST">6.3.4. Cross-References</a></li>
+<li><a href="type_system.html#sec:Function_Accessor_Bodies_During_Type_Inference_of_AST">6.3.5. Function/Accessor Bodies</a></li>
+<li><a href="type_system.html#sec:Poly_Expressions_During_Type_Inference_of_AST">6.3.6. Poly Expressions</a></li>
+<li><a href="type_system.html#sec:Constraint_Solver_used_During_Type_Inference_of_AST">6.3.7. Constraint Solver</a></li>
+<li><a href="type_system.html#sec:Type_Guards_During_Type_Inference_of_AST">6.3.8. Type Guards</a></li>
+</ul>
+</li>
+<li><a href="type_system.html#sec:Structural_Typing">6.4. Structural Typing</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#_type-index">7. Type Index</a>
+<ul class="sectlevel2">
+<li><a href="type_index.html#sec:Type_Index_Design_Rationale">7.1. Design Rationale</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#sec:Getting_the_Xtext_Index_Content_IResourceDescriptions">7.1.1. Getting the Xtext Index (<code>IResourceDescriptions</code>) Content</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#sec:Design_Overview">7.2. Design Overview</a></li>
+<li><a href="type_index.html#sec:N4JS_Resource_Load_States">7.3. N4JS Resource Load States</a></li>
+<li><a href="type_index.html#sec:Type_Builder">7.4. Types Builder</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#sec:Type_Inference_not_allowed_in_Type_Builder">7.4.1. Type Inference not allowed in Types Builder</a></li>
+<li><a href="type_index.html#sec:ComputedTypeReferences">7.4.2. Deferred Type References</a></li>
+<li><a href="type_index.html#sec:Use_cases_of_ComputedTypeRef">7.4.3. Use cases of DeferredTypeRef</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#sec:Incremental_Builder_Overview">7.5. Incremental Builder (Overview)</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#sec:Incremental_Builder_Overview__XtextBuilder">7.5.1. XtextBuilder</a></li>
+<li><a href="type_index.html#sec:Incremental_Builder_Overview__IBuilderState">7.5.2. IBuilderState</a>
+<ul class="sectlevel4">
+<li><a href="type_index.html#copy-and-update-xtext-index">7.5.2.1. Copy and Update Xtext Index</a></li>
+<li><a href="type_index.html#build-state-setup-phase">7.5.2.2. Build State Setup Phase</a></li>
+<li><a href="type_index.html#process-queued-uris">7.5.2.3. Process Queued URIs</a></li>
+<li><a href="type_index.html#queueing-affected-resources">7.5.2.4. Queueing Affected Resources</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#sec:Incremental_Builder_Overview__Example">7.5.3. Example</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#dirty-state-handling">7.6. Dirty state handling</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#use-case-restoring-types-from-user-data">7.6.1. Use case: Restoring types from user data</a></li>
+<li><a href="type_index.html#use-case-updating-the-xtext-index">7.6.2. Use case: Updating the Xtext index</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="project_model.html#_project-model">8. Project Model</a>
+<ul class="sectlevel2">
+<li><a href="project_model.html#sec:Package_json">8.1. Package.json File</a></li>
+<li><a href="project_model.html#_accessing-project-information">8.2. Accessing Project Information</a>
+<ul class="sectlevel3">
+<li><a href="project_model.html#sec:IN4JSCore">8.2.1. IN4JSCore</a></li>
+<li><a href="project_model.html#sec:N4JSModel">8.2.2. N4JSModel</a></li>
+<li><a href="project_model.html#sec:N4JSWorkspace">8.2.3. N4JSWorkspace</a></li>
+<li><a href="project_model.html#sec:N4JSProject">8.2.4. N4JSProject</a></li>
+<li><a href="project_model.html#sec:SourceContainer">8.2.5. SourceContainer</a></li>
+<li><a href="project_model.html#sec:N4JSProjectsStateHelper">8.2.6. N4JSProjectsStateHelper</a></li>
+</ul>
+</li>
+<li><a href="project_model.html#sec:Caching">8.3. Caching</a>
+<ul class="sectlevel3">
+<li><a href="project_model.html#_caching-of-externallibraryworkspace">8.3.1. Caching of ExternalLibraryWorkspace</a></li>
+<li><a href="project_model.html#_caching-of-n4jsprojectsstatehelper">8.3.2. Caching of N4JSProjectsStateHelper</a></li>
+</ul>
+</li>
+<li><a href="project_model.html#sec:WildcardPathFilter">8.4. WildcardPathFilter</a></li>
+<li><a href="project_model.html#sec:ProjectUtils">8.5. ProjectUtils</a></li>
+</ul>
+</li>
+<li><a href="binding.html#_binding">9. Binding</a>
+<ul class="sectlevel2">
+<li><a href="binding.html#sec:Binding_Design_Rationale">9.1. Design Rationale</a></li>
+<li><a href="binding.html#sec:Binding_to_Members">9.2. Binding to Members</a></li>
+<li><a href="binding.html#sec:Binding_Getter_Setter">9.3. Getter / Setter Binding</a></li>
+<li><a href="binding.html#chap:Statics">9.4. Static Member Binding</a></li>
+<li><a href="binding.html#sec:Binding_Enumeration">9.5. Enumeration Literals Binding</a></li>
+<li><a href="binding.html#sec:Accessibility_of_types_and_members">9.6. Accessibility of types and members</a></li>
+<li><a href="binding.html#sec:Member_Scope_Example">9.7. Member Scope Example</a></li>
+<li><a href="binding.html#sec:Scoping_for_Members_of_Composed_Type_Explained">9.8. Scoping for Members of Composed Type (Union/Intersection) Example</a></li>
+<li><a href="binding.html#sec:Binding_of_Structurally_References_Types">9.9. Structurally References Types</a></li>
+<li><a href="binding.html#sec:Building">9.10. Building</a>
+<ul class="sectlevel3">
+<li><a href="binding.html#sec:Build_Phases">9.10.1. Build Phases</a></li>
+<li><a href="binding.html#sec:Build_Scenarios">9.10.2. Build Scenarios</a></li>
+<li><a href="binding.html#sec:Lazy_linking_problem">9.10.3. Lazy linking problem</a></li>
+</ul>
+</li>
+<li><a href="binding.html#sec:Proxies_and_Proxy_Resolution">9.11. Proxies and Proxy Resolution (Overview)</a>
+<ul class="sectlevel3">
+<li><a href="binding.html#xtexts-lazy-linking-proxies">9.11.1. Xtext’s Lazy Linking Proxies</a></li>
+<li><a href="binding.html#standard-emf-proxies">9.11.2. Standard EMF Proxies</a></li>
+<li><a href="binding.html#_how-is-proxy-resolution-triggered">9.11.3. How is Proxy Resolution Triggered?</a></li>
+<li><a href="binding.html#_when-is-proxy-resolution-allowed">9.11.4. When is Proxy Resolution Allowed?</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="validation.html#_validation">10. Validation</a>
+<ul class="sectlevel2">
+<li><a href="validation.html#sec:validation_overview">10.1. Validation overview</a></li>
+<li><a href="validation.html#sec:validation_control_flow">10.2. Validation control flow</a></li>
+<li><a href="validation.html#sec:validation_issue_ids">10.3. Issue IDs and Messages</a></li>
+<li><a href="validation.html#sec:validation_usage_patterns">10.4. Usage Pattern</a></li>
+<li><a href="validation.html#sec:validation_links">10.5. Links</a></li>
+</ul>
+</li>
+<li><a href="references.html#_references">11. References</a>
+<ul class="sectlevel2">
+<li><a href="references.html#sec:usecases">11.1. Use cases</a></li>
+<li><a href="references.html#sec:calculation_algorithm">11.2. Calculation algorithm</a>
+<ul class="sectlevel3">
+<li><a href="references.html#sec:Xtext_default_implementation">11.2.1. Xtext default implementation</a></li>
+<li><a href="references.html#sec:N4_implementation">11.2.2. N4JS implementation</a></li>
+</ul>
+</li>
+<li><a href="references.html#sec:PerformanceOfDependencyCalculation">11.3. Performance Of Dependency Calculation</a></li>
+<li><a href="references.html#sec:kinds_of_references">11.4. Kinds of references</a>
+<ul class="sectlevel3">
+<li><a href="references.html#sec:Cross_References_to_be_ignored">11.4.1. Cross References to be ignored</a></li>
+<li><a href="references.html#sec:Cross_References_to_be_handled">11.4.2. Cross References to be handled</a></li>
+</ul>
+</li>
+<li><a href="references.html#sec:transitive_dependencies">11.5. Transitive dependencies</a></li>
+<li><a href="references.html#sec:find-references">11.6. Find references</a>
+<ul class="sectlevel3">
+<li><a href="references.html#_background">11.6.1. Background</a></li>
+<li><a href="references.html#_how-find-references-work">11.6.2. How Find References Work</a>
+<ul class="sectlevel4">
+<li><a href="references.html#_step-1-convert-cursor-position-to-declared-element">11.6.2.1. Step 1: Convert Cursor Position to Declared Element</a></li>
+<li><a href="references.html#_step-2-convert-declared-element-to-target-uris">11.6.2.2. Step 2: Convert Declared Element to Target URIs</a></li>
+<li><a href="references.html#_step-3-filter-potential-resources">11.6.2.3. Step 3: Filter Potential Resources</a></li>
+<li><a href="references.html#_step-4-search-references-in-resource">11.6.2.4. Step 4: Search References in Resource</a></li>
+<li><a href="references.html#_limitations-and-possible-enhancements">11.6.2.5. Limitations and Possible Enhancements</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="compilation.html#_compilation">12. Compilation</a>
+<ul class="sectlevel2">
+<li><a href="compilation.html#chap:compilation">12.1. Introduction</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:general_design_rationals">12.1.1. General design rationals</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:logging_and_error_reporting">12.1.1.1. Logging and error reporting</a></li>
+<li><a href="compilation.html#sec:progress_monitor">12.1.1.2. Progress monitor</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Xtext_Integration">12.1.2. Xtext Integration</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:xtext_default_behaviour">12.1.2.1. Xtext default behaviour</a></li>
+<li><a href="compilation.html#sec:n4js_requirements">12.1.2.2. N4JS requirements</a></li>
+<li><a href="compilation.html#sec:compiler_discovery_in_ui">12.1.2.3. Compiler discovery in UI</a></li>
+<li><a href="compilation.html#sec:compiler_discovery_in_headless">12.1.2.4. Compiler discovery in headless</a></li>
+<li><a href="compilation.html#sec:general_generator_implementation">12.1.2.5. General generator implementation</a></li>
+<li><a href="compilation.html#sec:general_generator_activation">12.1.2.6. General generator activation</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Overview_of_Input_Models">12.1.3. Overview of the Input Models</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Core_Generator">12.2. Generators</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:Compiler_Components">12.2.1. Generator Components</a></li>
+<li><a href="compilation.html#sec:Generator_architecture">12.2.2. Generator architecture</a></li>
+<li><a href="compilation.html#sec:Unified_Compiler_Configuration">12.2.3. Unified Compiler Configuration</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Transpilers">12.3. Transpilers</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:Phases">12.3.1. Overview</a></li>
+<li><a href="compilation.html#relation-between-ast-and-im">12.3.2. Relation between AST and IM</a></li>
+<li><a href="compilation.html#implementation-overview">12.3.3. Implementation Overview</a></li>
+<li><a href="compilation.html#sec:Guidelines_for_Implementing_Transformations">12.3.4. Guidelines for Implementing Transformations</a></li>
+<li><a href="compilation.html#symbol-table-in-the-im">12.3.5. Symbol Table in the IM</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:N4JS_to_EcmaScript_Transpiler">12.4. N4JS-to-EcmaScript Transpiler</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:Overview_of_Transformations">12.4.1. Overview of Transformations</a></li>
+<li><a href="compilation.html#sec:Transpiling_members">12.4.2. Transpiling members</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:Transpiling_members__Delegating_members">12.4.2.1. Techniques for special member handling</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__Partial_shadowing_of_getter_setter_pairs">12.4.2.2. Partial shadowing</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__Consuming_or_inheriting_members_of_an_interface">12.4.2.3. Consuming or inheriting members of an interface</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__Static_polyfill">12.4.2.4. Static polyfill</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__API_implementation_stubs">12.4.2.5. API / implementation stubs</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Support_for_incomplete_API_implementation_testing_in_the_N4JS_to_EcmaScript_5_Transpiler">12.4.3. Support for incomplete API implementation testing</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:Modifications_in_Impl_projects">12.4.3.1. Modifications in Impl projects</a></li>
+<li><a href="compilation.html#sec:Implementation_of_stub_generation">12.4.3.2. Implementation of stub-generation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:n4jsc_Headless_Compiler_Interface">12.5. n4jsc Headless Compiler Interface</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:building_the_headless_compiler">12.5.1. building the headless compiler</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="execution.html#_execution">13. Execution</a>
+<ul class="sectlevel2">
+<li><a href="execution.html#sec:N4JS_Project_Execution_And_Linking_Model">13.1. N4JS Project Execution And Linking Model</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#subsec:N4JS_Execution_With_NodeJS">13.1.1. N4JS Execution With NodeJS</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:N4JS_Execution_And_Linking_File">13.2. N4JS Execution And Linking File</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#subsec:NodeJS_Specific_ELF">13.2.1. NodeJS Specific ELF</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Runners-execution">13.3. Runners</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#subsec:N4_Runtime_Environments_Convention">13.3.1. N4 Runtime Environments Convention</a></li>
+<li><a href="execution.html#subsec:Passing_Information_from_IDE_to_Execution_Code_in_Runtime_Environment">13.3.2. Passing Information from IDE to Execution Code in Runtime Environment</a></li>
+<li><a href="execution.html#subsec:Runners_Design">13.3.3. Runners Design</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Legacy_Execution_Engine">13.4. Legacy Execution Engine</a></li>
+<li><a href="execution.html#sec:Design">13.5. Design</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#sec:Usage_Outside_N4JSIDE">13.5.1. Usage Outside N4JSIDE</a>
+<ul class="sectlevel4">
+<li><a href="execution.html#sec:Use_Node_with_Maven">13.5.1.1. Use Node with Maven</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Usage_Inside_N4JSIDE">13.5.2. Usage Inside N4JSIDE</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Runtime_Injection">13.6. Runtime Injection</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#sec:Running_String_Code">13.6.1. Running String Code</a></li>
+<li><a href="execution.html#sec:Running_File_Code">13.6.2. Running File Code</a></li>
+<li><a href="execution.html#sec:Injection_Code_Example">13.6.3. Injection Code Example</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#_tests">14. Tests</a>
+<ul class="sectlevel2">
+<li><a href="tests.html#sec:Performance_Tests">14.1. Performance Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Synthetic_Performance_Tests">14.1.1. Synthetic Performance Tests</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:Design_of_Generator">14.1.1.1. Design of Generator</a></li>
+<li><a href="tests.html#sec:Design_of_Performance_Test_Execution">14.1.1.2. Design of Performance Test Configuration and Execution</a></li>
+<li><a href="tests.html#sec:JUnit_Configuration">14.1.1.3. JUnit Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Test_Configuration">14.1.1.4. JUnitBenchmark Test Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Report_Configuration">14.1.1.5. JUnitBenchmark Report Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Run_Configuration">14.1.1.6. JUnitBenchmark Run Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Example">14.1.1.7. JUnitBenchmark Example</a></li>
+<li><a href="tests.html#sec:Note_on_Jenkins_Job">14.1.1.8. Note on Jenkins Job</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#sec:ECMA_Tests">14.2. ECMA Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Grammar_Tests">14.2.1. Grammar Tests</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:Negative_Tests">14.2.1.1. Negative Tests</a></li>
+<li><a href="tests.html#sec:Test_Exclusion">14.2.1.2. Test Exclusion</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Integration_Tests">14.3. Integration Tests</a></li>
+<li><a href="tests.html#sec:Test_Helpers">14.4. Test Helpers</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Parameterized_N4JS_Tests">14.4.1. Parameterized N4JS tests</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:ParameterizedXtextRunner">14.4.1.1. ParameterizedXtextRunner</a></li>
+<li><a href="tests.html#sec:TestCodeProvider">14.4.1.2. TestCodeProvider</a></li>
+<li><a href="tests.html#sec:Example_Of_Parameterized_Parser_Test">14.4.1.3. Example of parameterized parser test</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Issue_Suppression">14.5. Issue Suppression</a></li>
+<li><a href="tests.html#sec:Xpect_Tests">14.6. Xpect Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Xpect_Test_Setup">14.6.1. Xpect Test Setup</a></li>
+<li><a href="tests.html#sec:Xpect_Issue_Suppression">14.6.2. Xpect Issue Suppression</a></li>
+<li><a href="tests.html#sec:Xpect_Provided_Test_Methods">14.6.3. Xpect Provided Test Methods</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#errors">14.6.3.1. errors</a></li>
+<li><a href="tests.html#warnings">14.6.3.2. warnings</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:N4JS_Specific_Xpect_Test_Methods">14.6.4. N4JS Specific Xpect Test Methods</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:XPECT_noerrors">14.6.4.1. noerrors and nowarnings</a></li>
+<li><a href="tests.html#sec:XPECT_scope">14.6.4.2. scope</a></li>
+<li><a href="tests.html#sec:XPECT_scopeWithPosition">14.6.4.3. scopeWithPosition</a></li>
+<li><a href="tests.html#sec:XPECT_scopeWithResource">14.6.4.4. scopeWithResource</a></li>
+<li><a href="tests.html#sec:XPECT_binding">14.6.4.5. binding</a></li>
+<li><a href="tests.html#sec:XPECT_linkedPathname">14.6.4.6. linkedPathname</a></li>
+<li><a href="tests.html#sec:XPECT_type_of">14.6.4.7. type of</a></li>
+<li><a href="tests.html#sec:XPECT_expectedType">14.6.4.8. expectedType</a></li>
+<li><a href="tests.html#sec:XPECT_elementKeyword">14.6.4.9. elementKeyword</a></li>
+<li><a href="tests.html#sec:XPECT_accessModifier">14.6.4.10. accessModifier</a></li>
+<li><a href="tests.html#sec:XPECT_compileResult">14.6.4.11. compileResult</a></li>
+<li><a href="tests.html#sec:XPECT_output">14.6.4.12. output</a></li>
+<li><a href="tests.html#sec:XPECT_outputRegEx">14.6.4.13. outputRegEx</a></li>
+<li><a href="tests.html#sec:XPECT_calculatedAccessModifier">14.6.4.14. calculatedAccessModifier</a></li>
+<li><a href="tests.html#sec:XPECT_spec">14.6.4.15. spec</a></li>
+<li><a href="tests.html#sec:XPECT_deadCode">14.6.4.16. deadCode</a></li>
+<li><a href="tests.html#sec:XPECT_returnOrThrows">14.6.4.17. returnOrThrows</a></li>
+<li><a href="tests.html#sec:XPECT_lint">14.6.4.18. lint</a></li>
+<li><a href="tests.html#sec:XPECT_lintFails">14.6.4.19. lintFails</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:FIXME_Xpect_modifier">14.6.5. FIXME Xpect modifier</a></li>
+<li><a href="tests.html#sec:Expectmatrix_Xpect_Test_Methods">14.6.6. Expectmatrix Xpect tests</a></li>
+<li><a href="tests.html#xpect-lint-tests">14.6.7. Xpect Lint Tests</a></li>
+</ul>
+</li>
+<li><a href="tests.html#xpect-proposal-tests">14.7. Xpect Proposal Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Validation_vs__Non_Validation">14.7.1. Validation vs. Non-Validation</a></li>
+<li><a href="tests.html#sec:General_Proposal_Test_Features">14.7.2. General Proposal Test Features</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:Test_Variables">14.7.2.1. Test Variables</a></li>
+<li><a href="tests.html#sec:Location_and_Selection">14.7.2.2. at – Location and Selection</a></li>
+<li><a href="tests.html#sec:Multi_Line_Expectations_in_Proposal_Tests">14.7.2.3. Multi Line Expectations in Proposal Tests</a></li>
+<li><a href="tests.html#sec:Timeout">14.7.2.4. Timeout and Performance</a></li>
+</ul>
+</li>
+<li><a href="tests.html#proposals-verify-existence-of-proposals">14.7.3. proposals – Verify Existence of Proposals</a></li>
+<li><a href="tests.html#sec:Verify_displayed_string">14.7.4. display – Verify displayed string</a></li>
+<li><a href="tests.html#sec:Apply_Proposal">14.7.5. apply – Apply Proposal</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#resource-application-in-other-files">14.7.5.1. resource – application in other files</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Content_Assist_Cycling">14.7.6. kind – Content Assist Cycling</a></li>
+<li><a href="tests.html#fileValidVerify-validation-status">14.7.7. fileValid – Verify validation status</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Apply_Proposal_And_Execute_Tests">14.8. Apply Proposal And Execute Tests</a></li>
+<li><a href="tests.html#sec:Organize_Imports_Test">14.9. Organize Imports Test</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#organizeimports">14.9.1. organizeImports</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Access_Control_Test">14.10. Access Control Test</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#test-scenarios">14.10.1. Test Scenarios</a></li>
+<li><a href="tests.html#n4js-code-generator">14.10.2. N4JS Code Generator</a></li>
+<li><a href="tests.html#xtext-issue-matcher">14.10.3. Xtext Issue Matcher</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Smoke_Tests">14.11. Smoke Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#how-to-handle-smoke-test-errors">14.11.1. How to handle smoke test errors?</a></li>
+<li><a href="tests.html#smoketester-and-exceptionanalyzer">14.11.2. SmokeTester and ExceptionAnalyzer</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:UI_Tests_with_SWTBot">14.12. UI Tests with SWTBot</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#writing-swtbot-tests">14.12.1. Writing SWTBot Tests</a></li>
+<li><a href="tests.html#running-swtbot-tests">14.12.2. Running SWTBot Tests</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Debugging_UI_Tests">14.13. Debugging UI Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Connecting_to_the_X_server_on_the_build_node">14.13.1. Connecting to the X-server on the build-node</a></li>
+<li><a href="tests.html#sec:Tools_to_investigate_the_java_stack">14.13.2. Tools to investigate the java-stack</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="ui_concepts.html#_ui-concepts">15. UI Concepts</a>
+<ul class="sectlevel2">
+<li><a href="ui_concepts.html#sec:User_Interface_Concepts">15.1. User Interface Concepts</a>
+<ul class="sectlevel3">
+<li><a href="ui_concepts.html#sec:Eclipse_UI_Concepts">15.1.1. Eclipse UI Concepts</a>
+<ul class="sectlevel4">
+<li><a href="ui_concepts.html#sec:Label_Provider">15.1.1.1. Label Provider</a></li>
+<li><a href="ui_concepts.html#sec:Markers">15.1.1.2. Markers</a></li>
+<li><a href="ui_concepts.html#sec:Commands__Toolbar_and_Menus">15.1.1.3. Commands, Toolbar and Menus</a></li>
+<li><a href="ui_concepts.html#sec:Content_Assist">15.1.1.4. Content Assist</a></li>
+<li><a href="ui_concepts.html#sec:Quick_Fixes">15.1.1.5. Quick Fixes</a></li>
+<li><a href="ui_concepts.html#sec:Quick_Assist">15.1.1.6. Quick Assist</a></li>
+<li><a href="ui_concepts.html#sec:Clean_Up_Actions">15.1.1.7. Clean Up Actions</a></li>
+<li><a href="ui_concepts.html#sec:Save_Actions">15.1.1.8. Save Actions</a></li>
+<li><a href="ui_concepts.html#sec:Auto_Edit">15.1.1.9. Auto Edit</a></li>
+<li><a href="ui_concepts.html#sec:Template_Proposals">15.1.1.10. Template Proposals</a></li>
+<li><a href="ui_concepts.html#sec:Outline_View___Quick_Outline">15.1.1.11. Outline View / Quick Outline</a></li>
+<li><a href="ui_concepts.html#sec:Navigator__Package_Explorer__Project_Explorer">15.1.1.12. Navigator, Package Explorer, Project Explorer</a></li>
+<li><a href="ui_concepts.html#sec:Hyperlinking_and_Navigation">15.1.1.13. Hyperlinking and Navigation</a></li>
+<li><a href="ui_concepts.html#sec:Syntax_and_Semantic_Coloring">15.1.1.14. Syntax and Semantic Coloring</a></li>
+<li><a href="ui_concepts.html#sec:Code_Formatter">15.1.1.15. Code Formatter</a></li>
+<li><a href="ui_concepts.html#sec:Wizards">15.1.1.16. Wizards</a></li>
+<li><a href="ui_concepts.html#sec:Cheat_Sheets">15.1.1.17. Cheat Sheets</a></li>
+<li><a href="ui_concepts.html#sec:Context_sensitive_Help">15.1.1.18. Context-sensitive Help</a></li>
+<li><a href="ui_concepts.html#sec:Hovers">15.1.1.19. Hovers</a></li>
+<li><a href="ui_concepts.html#sec:Folding">15.1.1.20. Folding</a></li>
+<li><a href="ui_concepts.html#sec:Customizable_validation___severity">15.1.1.21. Customizable validation / severity</a></li>
+<li><a href="ui_concepts.html#sec:Proposals">15.1.1.22. Proposals</a></li>
+</ul>
+</li>
+<li><a href="ui_concepts.html#sec:Non_Eclipse_UI_Concepts">15.1.2. Non-Eclipse UI Concepts</a>
+<ul class="sectlevel4">
+<li><a href="ui_concepts.html#sec:Overlays">15.1.2.1. Overlays</a></li>
+<li><a href="ui_concepts.html#sec:Goto__Inferred__Type">15.1.2.2. Goto (Inferred) Type</a></li>
+<li><a href="ui_concepts.html#sec:Postfix_Completion">15.1.2.3. Postfix Completion</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="ui_concepts.html#_user-interface-resources">15.2. User Interface Resources</a>
+<ul class="sectlevel3">
+<li><a href="ui_concepts.html#_icons">15.2.1. Icons</a>
+<ul class="sectlevel4">
+<li><a href="ui_concepts.html#_eclipse-platform-icons">15.2.1.1. Eclipse Platform Icons</a></li>
+<li><a href="ui_concepts.html#_n4js-specific-icons">15.2.1.2. N4JS Specific Icons</a></li>
+<li><a href="ui_concepts.html#_high-resolution-icons">15.2.1.3. High Resolution Icons</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="formatting.html#_formatting">16. Formatting</a>
+<ul class="sectlevel2">
+<li><a href="formatting.html#sec:FmtObjective">16.1. Objective</a>
+<ul class="sectlevel3">
+<li><a href="formatting.html#sec:FmtFormatting_Comments">16.1.1. Formatting Comments</a></li>
+</ul>
+</li>
+<li><a href="formatting.html#sec:FmtArchitecture">16.2. Architecture</a>
+<ul class="sectlevel3">
+<li><a href="formatting.html#sec:Implementation_example">16.2.1. Implementation example</a></li>
+</ul>
+</li>
+<li><a href="formatting.html#sec:FmtFormatter_Implementation_Guidelines">16.3. Formatter Implementation Guidelines</a></li>
+<li><a href="formatting.html#sec:FmtConfiguration">16.4. Configuration</a></li>
+<li><a href="formatting.html#sec:FmtUI_Integration">16.5. UI Integration</a></li>
+<li><a href="formatting.html#sec:FmtUnit_Testing_with_Xpect">16.6. Unit Testing with Xpect</a></li>
+</ul>
+</li>
+<li><a href="external_libraries.html#_external-libraries">17. External Libraries</a>
+<ul class="sectlevel2">
+<li><a href="external_libraries.html#sec:Major_Components">17.1. Major Components</a>
+<ul class="sectlevel3">
+<li><a href="external_libraries.html#subsec:External_Resources">17.1.1. External Resources</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Workspace">17.1.2. External Library Workspace</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Preference_Store">17.1.3. External Library Preference Store</a></li>
+<li><a href="external_libraries.html#subsec:npm_Manager">17.1.4. Library Manager</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Builder_Helper">17.1.5. External Library Builder</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Xtext_Index_Persister">17.1.6. External Library Xtext Index Persister</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Preference_Page">17.1.7. External Library Preference Page</a></li>
+</ul>
+</li>
+<li><a href="external_libraries.html#sec:Headless_External_Library_Support">17.2. Headless External Library Support</a>
+<ul class="sectlevel3">
+<li><a href="external_libraries.html#_custom-npm-settings">17.2.1. Custom npm settings</a></li>
+</ul>
+</li>
+<li><a href="external_libraries.html#sec:lmFutureWork">17.3. Future Work</a>
+<ul class="sectlevel3">
+<li><a href="external_libraries.html#subsec:lmMultipleDependencyScope">17.3.1. Multiple Dependency Scope</a></li>
+<li><a href="external_libraries.html#subsec:lmRunTestsFromLibrary">17.3.2. Run Tests from TestLibrary</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="json_support.html#sec:JSON_Support">18. JSON Support</a>
+<ul class="sectlevel2">
+<li><a href="json_support.html#sec:JSON_Parser">18.1. JSON Parser</a>
+<ul class="sectlevel3">
+<li><a href="json_support.html#sec:JSON_Parser_Unicode_Escaping">18.1.1. Escaping Unicode Control Characters in String Literals</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Empty_Text">18.1.2. Empty Text</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Nested_Structures">18.1.3. Nested Structures</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Whitespace">18.1.4. Whitespace</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Comments">18.1.5. Comments</a></li>
+</ul>
+</li>
+<li><a href="json_support.html#sec:JSON_Language_Extensions">18.2. JSON Language Extensions</a>
+<ul class="sectlevel3">
+<li><a href="json_support.html#sec:JSON_Validator_Extensions">18.2.1. JSON Validator Extensions</a>
+<ul class="sectlevel4">
+<li><a href="json_support.html#sec:File_Specitic_Validator_Extensions">18.2.1.1. File-Specific Validator Extensions</a></li>
+<li><a href="json_support.html#sec:JSON_Declarative_JSON_Validator_Extensions">18.2.1.2. Declarative JSON Validator Extensions</a></li>
+</ul>
+</li>
+<li><a href="json_support.html#_json-resource-description-strategy">18.2.2. JSON Resource Description Strategy</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_jsdoc">19. JSDoc</a>
+<ul class="sectlevel2">
+<li><a href="jsdoc.html#sec:Design_Rationale">19.1. Design Rationale</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#_general-design">19.1.1. General Design</a></li>
+<li><a href="jsdoc.html#sec:Type_Expressions">19.1.2. Type Expressions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="docexporter.html#_docexporter">20. DocExporter</a>
+<ul class="sectlevel2">
+<li><a href="docexporter.html#sec:Specification_Exporter">20.1. Specification Exporter</a></li>
+</ul>
+</li>
+<li><a href="rename_refactoring.html#_rename-refactoring">21. Rename Refactoring</a>
+<ul class="sectlevel2">
+<li><a href="rename_refactoring.html#_rename-refactoring-ui-interaction">21.1. Rename Refactoring UI interaction</a></li>
+<li><a href="rename_refactoring.html#_renameelementprocessor-interaction">21.2. RenameElementProcessor interaction</a></li>
+</ul>
+</li>
+<li><a href="flow_graphs.html#chap:flowgraphs">22. Flow Graphs</a>
+<ul class="sectlevel2">
+<li><a href="flow_graphs.html#sec:flowgraphs_overview">22.1. Flow graphs overview</a>
+<ul class="sectlevel3">
+<li><a href="flow_graphs.html#_internal-graph">22.1.1. Internal graph</a></li>
+<li><a href="flow_graphs.html#_optimizations">22.1.2. Optimizations</a></li>
+<li><a href="flow_graphs.html#_api-for-client-analyses">22.1.3. API for client analyses</a>
+<ul class="sectlevel4">
+<li><a href="flow_graphs.html#_mapping-from-internal-to-ast-elements">22.1.3.1. Mapping from internal to AST elements</a></li>
+<li><a href="flow_graphs.html#_graph-visitor">22.1.3.2. Graph visitor</a></li>
+<li><a href="flow_graphs.html#_graph-explorer">22.1.3.3. Graph explorer</a></li>
+<li><a href="flow_graphs.html#_branch-walker">22.1.3.4. Branch walker</a></li>
+<li><a href="flow_graphs.html#_example-1-compute-string-for-each-path">22.1.3.5. Example 1: Compute string for each path</a></li>
+<li><a href="flow_graphs.html#_path-quantor">22.1.3.6. Path quantor</a></li>
+</ul>
+</li>
+<li><a href="flow_graphs.html#_control-flow-analyses">22.1.4. Control flow analyses</a>
+<ul class="sectlevel4">
+<li><a href="flow_graphs.html#_dead-code-analysis">22.1.4.1. Dead code analysis</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="flow_graphs.html#sec:dataflow">22.2. Dataflow</a>
+<ul class="sectlevel3">
+<li><a href="flow_graphs.html#_dataflow-graph">22.2.1. Dataflow graph</a></li>
+<li><a href="flow_graphs.html#_dataflow-analyses">22.2.2. Dataflow analyses</a>
+<ul class="sectlevel4">
+<li><a href="flow_graphs.html#_def-def-def-nothing-analysis">22.2.2.1. Def&#8594;Def / Def&#8594;Nothing analysis</a></li>
+<li><a href="flow_graphs.html#_def-use-decl-analysis">22.2.2.2. Def|Use&#8592;Decl analysis</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="publish_npms.html#sec:publish-npms-to-public">23. Publish npms</a>
+<ul class="sectlevel2">
+<li><a href="publish_npms.html#sec:publish-npms-n4js-maven">23.1. Publish n4js-libs to during  maven build</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Hints">Appendix A: Hints</a>
+<ul class="sectlevel2">
+<li><a href="appendix_a_hints.html#sec:XtextInjection">A.1. Xtext Injection</a>
+<ul class="sectlevel3">
+<li><a href="appendix_a_hints.html#sec:DI_MultipleInjectors_Singletons">A.1.1. Multiple Injectors and Singletons</a>
+<ul class="sectlevel4">
+<li><a href="appendix_a_hints.html#sec:DI_avoid_duplicate_singletons">A.1.1.1. Avoiding duplicate singletons</a>
+<ul class="sectlevel5">
+<li><a href="appendix_a_hints.html#sec:DI_binding_in_shared">A.1.1.1.1. Defining binding in the shared injector</a></li>
+<li><a href="appendix_a_hints.html#sec:DI_binding_in_custom">A.1.1.1.2. Defining binding in the custom injector</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:DI_Hints">A.1.2. Dependency Injection Hints</a>
+<ul class="sectlevel4">
+<li><a href="appendix_a_hints.html#sec:DI_custom_bundle">A.1.2.1. Use DI in custom bundle, use DI with extensions</a>
+<ul class="sectlevel5">
+<li><a href="appendix_a_hints.html#sec:DI_custom_bundle_problem">A.1.2.1.1. Problem</a></li>
+<li><a href="appendix_a_hints.html#sec:DI_custom_bundle_solution">A.1.2.1.2. Solution</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Access_Other_DSL_Injector">A.1.2.2. How do I get the Guice Injector of my language?</a>
+<ul class="sectlevel5">
+<li><a href="appendix_a_hints.html#sec:DSL_Injector_UI_context">A.1.2.2.1. UI context</a></li>
+<li><a href="appendix_a_hints.html#sec:DSL_Injector_Non_UI_context">A.1.2.2.2. Non UI context but with injection context</a></li>
+<li><a href="appendix_a_hints.html#sec:DSL_Injector_Non_UI_non_injection_context">A.1.2.2.3. Non UI context without injection context</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Cancel_Indicator">A.1.2.3. How do I get cancel indicators in different contexts?</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Eclipse">A.2. Eclipse</a>
+<ul class="sectlevel3">
+<li><a href="appendix_a_hints.html#sec:Show_Xtext_Index">A.2.1. Show the current Xtext index</a></li>
+<li><a href="appendix_a_hints.html#sec:Plugin_spy">A.2.2. Plug-in spy</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Maven-hints">A.3. Maven</a>
+<ul class="sectlevel3">
+<li><a href="appendix_a_hints.html#how-to-check-for-maven-mojo-updates">A.3.1. How to check for Maven MOJO updates</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#_module-loading">Appendix B: Module Loading</a>
+<ul class="sectlevel2">
+<li><a href="appendix_b_module_loading.html#sec:Dependency_Management">B.1. Dependency Management</a></li>
+<li><a href="appendix_b_module_loading.html#ecmascript-modules">B.2. ECMAScript Modules</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:ES5_Modules_Systems">B.2.1. ES5 Modules Systems</a></li>
+<li><a href="appendix_b_module_loading.html#sec:ES6_Modules">B.2.2. ES6 Modules</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:ECMAScript_Module_Loaders">B.3. ECMAScript Module Loaders</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:ES6_Module_Loaders">B.3.1. ES6 Module Loaders</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Polyfills_for_ES6_Module_Loaders">B.3.2. Polyfills for ES6 Module Loaders</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:es6_module_loader">B.3.2.1. es6-module-loader</a></li>
+<li><a href="appendix_b_module_loading.html#sec:SystemJS">B.3.2.2. SystemJS</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Demo">B.3.2.3. Demo</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#case-study-typescript">B.4. Case Study : TypeScript</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:ES6_Modules_Support">B.4.1. ES6 Modules Support</a></li>
+<li><a href="appendix_b_module_loading.html#sec:TypeScript_and_Module_Loading">B.4.2. TypeScript and Module Loading</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Cyclic_Dependencies">B.5. Cyclic Dependencies</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:Setup">B.5.1. Setup</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Transpile_and_Execute">B.5.2. Transpile and Execute</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Module_Format___AMD">B.5.2.1. Module Format = AMD</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Module_Format___CommonJS">B.5.2.2. Module Format = CommonJS</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Module_Format___SystemJS">B.5.2.3. Module Format = SystemJS</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Conclusion">B.5.3. Conclusion</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#system.register-as-transpilation-target">B.6. System.register as transpilation target</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:Introduction">B.6.1. Introduction</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:External_Transpilers">B.6.1.1. External Transpilers</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Example_of_a_System_register_module">B.6.1.2. Example of a System.register module</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Structure_of_a_System_register_module">B.6.2. Structure of a System.register module</a></li>
+<li><a href="appendix_b_module_loading.html#_transpilation-hints">B.6.3. Transpilation Hints</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Handling_Imports">B.6.3.1. Handling Imports</a></li>
+<li><a href="appendix_b_module_loading.html#sec:__exportFn__">B.6.3.2. &lt;&lt;exportFn&gt;&gt;</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Handling_Exports">B.6.3.3. Handling Exports</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Examples_w__Circular_Dependencies">B.6.4. Examples w/ Circular Dependencies</a></li>
+<li><a href="appendix_b_module_loading.html#sec:N4JS_Examples_w__Circular_Dependencies">B.6.5. N4JS Examples w/ Circular Dependencies</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Unresolved_Cyclic_Dependencies">B.6.5.1. Unresolved Cyclic Dependencies</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Variables___Functions">B.6.5.2. Examples with Variables &amp; Functions</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Classes">B.6.5.3. Examples with Classes</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Examples_with_SubClassing">B.6.5.4. Examples with SubClassing</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Miscellaneous">B.6.5.5. Miscellaneous</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#_resources">B.6.6. Resources</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:CommonJS_as_transpilation_target">B.7. CommonJS as transpilation target</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#_introduction-2">B.7.1. Introduction</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Transpilation_Hints">B.7.2. Transpilation Hints</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Import_Statements">B.7.2.1. Import Statements</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Export_Statements">B.7.2.2. Export Statements</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Tracking_Live_Bindings">B.7.2.3. Tracking Live Bindings</a></li>
+<li><a href="appendix_b_module_loading.html#sec:A_complete_example">B.7.2.4. A complete example</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#_resources-2">B.7.3. Resources</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_c_license.html#sec:License">Appendix C: License</a></li>
+<li><a href="appendix_d_acronyms.html#sec:Acronyms">Appendix D: Acronyms</a></li>
+<li><a href="#_bibliography-and-footnotes">Appendix E: Bibliography and Footnotes</a></li>
+</ul>
+</div>
+</div>
+<div id="content"><div class="sect1">
+<h2 id="_bibliography-and-footnotes"><a class="anchor" href="#_bibliography-and-footnotes"></a><a class="link" href="#_bibliography-and-footnotes">Appendix E: Bibliography and Footnotes</a></h2>
+<div class="sectionbody">
+<div class="openblock bibliography">
+<div class="content">
+<div class="paragraph">
+<p><a id="N4JSSpec"></a>N4JS Project. (2018). <em>N4JS Language Specification</em>. Retrieved from <a href="https://www.eclipse.org/n4js/spec/N4JSSpec.html" class="bare">https://www.eclipse.org/n4js/spec/N4JSSpec.html</a></p>
+</div>
+<div class="paragraph">
+<p><a id="Xpect"></a><em>Xpect, Project Website</em>. Retrieved from <a href="https://projects.eclipse.org/projects/modeling.xpect" class="bare">https://projects.eclipse.org/projects/modeling.xpect</a></p>
+</div>
+<div class="paragraph">
+<p><a id="RFC8259"></a>Bray, Tim. (2017). <em>RFC 8259: The javascript object notation (json) data interchange format</em>. </p>
+</div>
+<div class="paragraph">
+<p><a id="ECMA404"></a>International, ECMA. (2017). <em>Standard ECMA-404, The JSON Data Interchange Syntax</em>. </p>
+</div>
+<div class="paragraph">
+<p><a id="RFC7158"></a>Bray, Tim. (2014). <em>RFC 7158: The JavaScript Object Notation ({JSON}) Data Interchange Format</em>. </p>
+</div>
+<div class="paragraph">
+<p><a id="Ser18"></a>Seriot, Nicolas. (2018). <em>Parsing JSON is a Minefield</em>. Retrieved from <a href="http://seriot.ch/parsing_json.php" class="bare">http://seriot.ch/parsing_json.php</a></p>
+</div>
+<div class="paragraph">
+<p><a id="ECMA15a"></a>ECMA. (2015). <em>ECMAScript 2015 Language Specification</em>. Retrieved from <a href="http://www.ecma-international.org/publications/files/ECMA-ST/Ecma-262.pdf" class="bare">http://www.ecma-international.org/publications/files/ECMA-ST/Ecma-262.pdf</a></p>
+</div>
+<div class="paragraph">
+<p><a id="WhatWGLoader"></a>WhatWG. <em>Loader: A Collection of Interesting Ideas</em>. Retrieved from <a href="http://whatwg.github.io/loader/" class="bare">http://whatwg.github.io/loader/</a></p>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div id="footnotes">
+<hr>
+<div class="footnote" id="_footnote_1">
+<a href="type_system.html#_footnoteref_1">1</a>. This is not yet implemented as of September 2015; types are still stored in a separate cache, the <code>ASTMetaInfoCache</code>.
+</div>
+<div class="footnote" id="_footnote_2">
+<a href="type_system.html#_footnoteref_2">2</a>. In the future, the top-down order could become more important if inference of <em>expected</em> types is also integrated into post-processing.
+</div>
+<div class="footnote" id="_footnote_3">
+<a href="type_index.html#_footnoteref_3">3</a>. The <code class="language-n4js">DeferredTypeRef</code> has replaced the old <code class="language-n4js">ComputedTypeRef</code> that had been used until Summer 2015; those were resolved lazily when the type was actually needed (triggered on demand). For a discussion of this change see <a href="type_system.html#sec:Type_Inference_combined_with_AST_Traversal__Background">Background</a> and in particular <a href="type_system.html#tab:typeInferenceBeforeAfter">Comparison of inference of type of AST nodes before / after refactoring.</a>.
+</div>
+<div class="footnote" id="_footnote_4">
+<a href="type_index.html#_footnoteref_4">4</a>. First, according to the build order.
+</div>
+<div class="footnote" id="_footnote_5">
+<a href="type_index.html#_footnoteref_5">5</a>. These are not really input values but rather values changed during the following invocation of the IBuilderState that need to be carried over from one invocation to the next.
+</div>
+<div class="footnote" id="_footnote_6">
+<a href="type_index.html#_footnoteref_6">6</a>. Once the build phase has ended, this copied and modified Xtext index will replace the actual state of the builder state and will be persisted on graceful application shutdown.
+</div>
+<div class="footnote" id="_footnote_7">
+<a href="type_index.html#_footnoteref_7">7</a>. This set of URIs will contain the URIs of all resources that are available in the copied Xtext index but not yet directly processed by the builder in the current build phase. These URIs will later be used as candidates for all resources that might be marked as affected ones and queued by the builder for forthcoming build phases.
+</div>
+<div class="footnote" id="_footnote_8">
+<a href="type_index.html#_footnoteref_8">8</a>. This set eventually represents all changes that were made during the current build phase. Note that <code>allChanges</code> might contain resource description deltas that do not represent an actual change, it is processed by the builder but the underlying information stored in the user data is still unchanged.
+</div>
+<div class="footnote" id="_footnote_9">
+<a href="type_index.html#_footnoteref_9">9</a>. Note that deltas for to-be-deleted resources were already added to <code>allDeltas</code> upfront in step <a href="type_index.html#itm:processDeleted">Process Deleted</a>.
+</div>
+<div class="footnote" id="_footnote_10">
+<a href="type_index.html#_footnoteref_10">10</a>. This happens through a call to <code class="language-n4js">CurrentDescriptions#register(Delta)</code>
+</div>
+<div class="footnote" id="_footnote_11">
+<a href="type_index.html#_footnoteref_11">11</a>. Unlike in step <a href="type_index.html#itm:enqueueAffectedResources">Enqueue Affected Resources</a>, we now use <code>changedDeltas</code> instead of <code>allDeltas</code> as a basis.
+</div>
+<div class="footnote" id="_footnote_12">
+<a href="references.html#_footnoteref_12">12</a>. One could think of an optimization to only register those types that are not just imported or declared, but whose features are really in use. E.g., in one file another type be imported (and even used as type of variable), but non of its member is used. So changes to these members wouldn’t affect the current resources. However this might miss certain cases. E.g., when a method in the super class is removed and now the method with same signature of a consumed role would be used. The method of the role has no been used before, yet must not be ignored. Thus, currently all super classes, roles and interfaces and referenced classes are added as dependency regardless if their members are called.
+</div>
+<div class="footnote" id="_footnote_13">
+<a href="compilation.html#_footnoteref_13">13</a>. <a href="https://developer.apple.com/library/mac/documentation/Carbon/Reference/WebKit_JavaScriptCore_Ref/_index.html" class="bare">https://developer.apple.com/library/mac/documentation/Carbon/Reference/WebKit_JavaScriptCore_Ref/_index.html</a>
+</div>
+<div class="footnote" id="_footnote_14">
+<a href="compilation.html#_footnoteref_14">14</a>. but note that most utility methods obtain the transpiler state automatically; so, most of the time, you won’t need to obtain the state yourself.
+</div>
+<div class="footnote" id="_footnote_15">
+<a href="tests.html#_footnoteref_15">15</a>. Currently we use our own fork of Xpect <a href="https://github.com/NumberFour/Xpect" class="bare">https://github.com/NumberFour/Xpect</a> and the respective p2-repository <a href="https://numberfour.github.io/Xpect/updatesite/nightly/" class="bare">https://numberfour.github.io/Xpect/updatesite/nightly/</a>
+</div>
+<div class="footnote" id="_footnote_16">
+<a href="formatting.html#_footnoteref_16">16</a>. version at the time of writing is Xtext 2.12
+</div>
+<div class="footnote" id="_footnote_17">
+<a href="formatting.html#_footnoteref_17">17</a>. <a href="https://github.com/eclipse/xtext-core/issues/12" class="bare">https://github.com/eclipse/xtext-core/issues/12</a>
+</div>
+<div class="footnote" id="_footnote_18">
+<a href="external_libraries.html#_footnoteref_18">18</a>. Calculates a list of external library projects that have to be build and another list of projects that have to be cleaned.
+</div>
+</div>
+<div id="footer">
+<div id="footer-text">
+Version 0.9<br>
+Last updated 2019-08-07 15:02:40 CEST
+</div>
+</div>
+<!-- ************* docinfo-footer *************************************************************** -->
+<div class="Grid social" style="color:#d5dfea">
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <h2>Quick Links</h2>
+    <ul>
+      <li><a href="../downloads.html">Download</a></li>
+      <li><a href="../userguides/index.html">Documentation</a></li>
+      <li><a href="https://github.com/eclipse/n4js/">Source</a></li>
+      <li><a href="https://github.com/eclipse/n4js/issues">Issues</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="https://www.eclipse.org/forums/index.php/f/365/">Forum</a></li>
+      <li><a href="http://n4js.blogspot.de/">Blog</a></li>
+      <li><a href="https://dev.eclipse.org/mailman/listinfo/n4js-dev">Mailing List</a></li>
+      <li><a href="https://projects.eclipse.org/projects/technology.n4js">Eclipse Project Page</a></li>
+      <li><a href="https://twitter.com/n4jsdev">Tweets by n4jsdev</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="http://www.eclipse.org/">Eclipse Home</a></li>
+      <li><a href="http://www.eclipse.org/legal/privacy.php">Privacy Policy</a></li>
+      <li><a href="http://www.eclipse.org/legal/termsofuse.php">Terms of Use</a></li>
+      <li><a href="http://www.eclipse.org/legal/copyright.php">Copyright Agent</a></li>
+      <li><a href="http://www.eclipse.org/legal/">Legal</a></li>
+    </ul>
+  </div>
+  <div style="clear: both; height: 0; overflow: hidden;"></div>
+</div>
+
+<!-- ************* UI Scripts ************* -->
+<script type="text/javascript" src="scripts/back-to-top.js"></script>
+
+<script type="text/javascript" src="scripts/treeview.js"></script>
+<script type="text/javascript" src="scripts/toc.js"></script>
+
+<!-- ************* Prism.js Syntax Highlighting ************* -->
+<script src="scripts/prism.js"></script>
+
+<script type="text/javascript">
+	// Add the 'toclist' id for search function
+	$(".toc2 > ul").attr('id', 'toclist');
+	// Generate a Search input form
+	$("#toclist > li:first-of-type").before('<input type="text" id="pagesearch" onkeyup="search()" placeholder="Search for section...">');
+	$("#toclist > li:first-of-type").before('<i id="clear" class="fa fa-times-circle-o"></i>');
+	$("#clear").click(function(){
+	    $("#pagesearch").val('');
+	    search();
+	    $('.toc2 > ul').treeView('collapseAll');
+	});
+	// intialize Treeview.js
+	$(".toc2 > ul").treeView();
+	// Initialize Scrollspy
+</script>
+<!-- ************* docinfo-footer *************************************************************** -->
+</body>
+</html>
\ No newline at end of file
diff --git a/design/binding.html b/design/binding.html
new file mode 100644
index 0000000..c549025
--- /dev/null
+++ b/design/binding.html
@@ -0,0 +1,1394 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="generator" content="Asciidoctor 1.5.5">
+<meta name="author" content="2019-08-07 15:02:40 CEST">
+<title>N4JS Design Specification</title>
+<link rel="stylesheet" href="styles/spec.min.css">
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.6.3/css/font-awesome.min.css">
+<!-- ************* docinfo ******************************************************************* -->
+
+
+<!-- ************* Favicon ************-->
+<link rel="icon" href="images/favicon.ico" />
+
+<!-- ************* Back-to-top JQuery ************* -->
+<script src="https://code.jquery.com/jquery-1.12.4.js"></script>
+<script src="https://code.jquery.com/ui/1.12.0/jquery-ui.js"></script>
+
+
+<link href="styles/prism.min.css" rel="stylesheet" />
+<script type="text/javascript" async
+  src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2/MathJax.js?config=TeX-MML-AM_CHTML">
+</script>
+
+<!-- ************* Styles ************* -->
+<link rel="stylesheet" type="text/css" href="styles/n4jsspec-adoc.css">
+
+
+<!-- ****************** NavBar ****************** -->
+<div id="menubar">
+	<div class="banner">
+        <a href="https://www.eclipse.org/n4js/#"><img id="logo" src="images/n4js-logo.png" alt="Eclipse N4JS"></a>
+    </div>
+<ul>
+  <li><a href="index.html">Index</a></li>
+</ul>
+</div>
+<!-- ************* docinfo ******************************************************************* -->
+<style>
+      .admonitionblock td.icon .icon-todo:before{content:"\f249";color:#f4ee42}
+    </style>
+</head>
+<body class="book toc2 toc-left">
+<div id="header">
+<h1>N4JS Design Specification</h1>
+<div class="details">
+<span id="author" class="author">2019-08-07 15:02:40 CEST</span><br>
+<span id="revnumber">version 0.9</span>
+</div>
+<div id="toc" class="toc2">
+<div id="toctitle">Table of Contents</div>
+<ul class="sectlevel1">
+<li><a href="introduction.html#_introduction">1. Introduction</a>
+<ul class="sectlevel2">
+<li><a href="introduction.html#notation">1.1. Notation</a></li>
+<li><a href="introduction.html#sec:IDE_Overview">1.2. IDE Components</a>
+<ul class="sectlevel3">
+<li><a href="introduction.html#sec:Naming_Conventions">1.2.1. Naming Conventions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="eclipse_setup.html#_eclipse-setup">2. Eclipse Setup</a>
+<ul class="sectlevel2">
+<li><a href="eclipse_setup.html#_system-requirements">2.1. System Requirements</a></li>
+<li><a href="eclipse_setup.html#_contribute">2.2. Contribute</a>
+<ul class="sectlevel3">
+<li><a href="eclipse_setup.html#_eclipse-installer">2.2.1. Eclipse Installer</a>
+<ul class="sectlevel4">
+<li><a href="eclipse_setup.html#_changing-the-setup-script">2.2.1.1. Changing the Setup Script</a></li>
+</ul>
+</li>
+<li><a href="eclipse_setup.html#_manual-ide-configuration">2.2.2. Manual IDE Configuration</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="release_engineering.html#_release-engineering">3. Release Engineering</a>
+<ul class="sectlevel2">
+<li><a href="release_engineering.html#_nightly-build-on-eclipse-infrastructure">3.1. Nightly build on Eclipse infrastructure</a></li>
+<li><a href="release_engineering.html#_build-the-n4js-ide-from-command-line">3.2. Build the N4JS IDE from command line</a>
+<ul class="sectlevel3">
+<li><a href="release_engineering.html#_publish-maven-tooling-code-org-eclipse-n4js-releng-util-code">3.2.1. Publish maven-tooling <code>org.eclipse.n4js.releng.util</code></a></li>
+<li><a href="release_engineering.html#sec:test-verdaccio">3.2.2. Test Verdaccio containing n4js-libs</a></li>
+<li><a href="release_engineering.html#_generation-of-eclipse-help-for-spec-and-design-document">3.2.3. Generation of Eclipse help for spec and design document</a></li>
+</ul>
+</li>
+<li><a href="release_engineering.html#_updating-frameworks-and-dependencies">3.3. Updating frameworks and dependencies</a>
+<ul class="sectlevel3">
+<li><a href="release_engineering.html#_update-of-eclipse-emf-xtext-etc">3.3.1. Update of Eclipse, EMF, Xtext, etc.</a></li>
+<li><a href="release_engineering.html#_update-of-the-embedded-jre">3.3.2. Update of the embedded JRE</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tips_and_tricks.html#_tips-and-tricks">4. Tips and Tricks</a>
+<ul class="sectlevel2">
+<li><a href="tips_and_tricks.html#_naming">4.1. Naming</a></li>
+<li><a href="tips_and_tricks.html#_logging">4.2. Logging</a></li>
+<li><a href="tips_and_tricks.html#_cancellation-handling">4.3. Cancellation Handling</a></li>
+<li><a href="tips_and_tricks.html#_caching">4.4. Caching</a></li>
+<li><a href="tips_and_tricks.html#_dependency-injection">4.5. Dependency Injection</a></li>
+<li><a href="tips_and_tricks.html#_miscellaneous">4.6. Miscellaneous</a></li>
+</ul>
+</li>
+<li><a href="parser.html#_parser">5. Parser</a>
+<ul class="sectlevel2">
+<li><a href="parser.html#sec:Parser_Overview">5.1. Overview</a></li>
+<li><a href="parser.html#sec:N4JS_Parser">5.2. N4JS Parser</a></li>
+<li><a href="parser.html#sec:Parser_Generation_Post_Processing">5.3. Parser Generation Post-Processing</a>
+<ul class="sectlevel3">
+<li><a href="parser.html#sec:Automatic_Semicolon_Insertion">5.3.1. Automatic Semicolon Insertion</a>
+<ul class="sectlevel4">
+<li><a href="parser.html#sec:Injected_code_in_the_Antlr_grammar_file">5.3.1.1. Injected code in the Antlr grammar file</a></li>
+<li><a href="parser.html#sec:Customized_error_recovery">5.3.1.2. Customized error recovery</a></li>
+</ul>
+</li>
+<li><a href="parser.html#sec:_No_line_terminator_allowed_here__handling">5.3.2. Async and <code>No line terminator allowed here</code> Handling</a></li>
+<li><a href="parser.html#sec:Regular_Expression">5.3.3. Regular Expression</a></li>
+<li><a href="parser.html#sec:Unicode">5.3.4. Unicode</a></li>
+<li><a href="parser.html#sec:Literals">5.3.5. Literals</a></li>
+</ul>
+</li>
+<li><a href="parser.html#sec:Modifiers">5.4. Modifiers</a></li>
+<li><a href="parser.html#sec:Conflict_Resolutions">5.5. Conflict Resolutions</a>
+<ul class="sectlevel3">
+<li><a href="parser.html#sec:Reserved_Keywords_vs__Identifier_Names">5.5.1. Reserved Keywords vs. Identifier Names</a></li>
+<li><a href="parser.html#sec:Operators_and_Generics">5.5.2. Operators and Generics</a></li>
+</ul>
+</li>
+<li><a href="parser.html#sec:Content_Assist_Parser">5.6. Content-Assist Parser</a></li>
+</ul>
+</li>
+<li><a href="type_system.html#_type-system">6. Type System</a>
+<ul class="sectlevel2">
+<li><a href="type_system.html#sec:Type_Model_and_Grammar">6.1. Type Model and Grammar</a>
+<ul class="sectlevel3">
+<li><a href="type_system.html#sec:Type_Model_Overview">6.1.1. Type Model Overview</a></li>
+<li><a href="type_system.html#sec:Built_in_Types">6.1.2. Built-in and Primitive Types</a></li>
+<li><a href="type_system.html#sec:Type_Model_DSL">6.1.3. Type Model DSL</a></li>
+</ul>
+</li>
+<li><a href="type_system.html#sec:Type_System_Implementation">6.2. Type System Implementation</a></li>
+<li><a href="type_system.html#sec:Type_Inference_combined_with_AST_Traversal">6.3. Type Inference of AST</a>
+<ul class="sectlevel3">
+<li><a href="type_system.html#sec:Type_Inference_combined_with_AST_Traversal__Background">6.3.1. Background</a></li>
+<li><a href="type_system.html#sec:Triggering_Type_Inference_of_AST">6.3.2. Triggering</a></li>
+<li><a href="type_system.html#sec:Traversal_Order_During_Type_Inference_of_AST">6.3.3. Traversal Order</a></li>
+<li><a href="type_system.html#sec:Cross_References_During_Type_Inference_of_AST">6.3.4. Cross-References</a></li>
+<li><a href="type_system.html#sec:Function_Accessor_Bodies_During_Type_Inference_of_AST">6.3.5. Function/Accessor Bodies</a></li>
+<li><a href="type_system.html#sec:Poly_Expressions_During_Type_Inference_of_AST">6.3.6. Poly Expressions</a></li>
+<li><a href="type_system.html#sec:Constraint_Solver_used_During_Type_Inference_of_AST">6.3.7. Constraint Solver</a></li>
+<li><a href="type_system.html#sec:Type_Guards_During_Type_Inference_of_AST">6.3.8. Type Guards</a></li>
+</ul>
+</li>
+<li><a href="type_system.html#sec:Structural_Typing">6.4. Structural Typing</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#_type-index">7. Type Index</a>
+<ul class="sectlevel2">
+<li><a href="type_index.html#sec:Type_Index_Design_Rationale">7.1. Design Rationale</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#sec:Getting_the_Xtext_Index_Content_IResourceDescriptions">7.1.1. Getting the Xtext Index (<code>IResourceDescriptions</code>) Content</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#sec:Design_Overview">7.2. Design Overview</a></li>
+<li><a href="type_index.html#sec:N4JS_Resource_Load_States">7.3. N4JS Resource Load States</a></li>
+<li><a href="type_index.html#sec:Type_Builder">7.4. Types Builder</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#sec:Type_Inference_not_allowed_in_Type_Builder">7.4.1. Type Inference not allowed in Types Builder</a></li>
+<li><a href="type_index.html#sec:ComputedTypeReferences">7.4.2. Deferred Type References</a></li>
+<li><a href="type_index.html#sec:Use_cases_of_ComputedTypeRef">7.4.3. Use cases of DeferredTypeRef</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#sec:Incremental_Builder_Overview">7.5. Incremental Builder (Overview)</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#sec:Incremental_Builder_Overview__XtextBuilder">7.5.1. XtextBuilder</a></li>
+<li><a href="type_index.html#sec:Incremental_Builder_Overview__IBuilderState">7.5.2. IBuilderState</a>
+<ul class="sectlevel4">
+<li><a href="type_index.html#copy-and-update-xtext-index">7.5.2.1. Copy and Update Xtext Index</a></li>
+<li><a href="type_index.html#build-state-setup-phase">7.5.2.2. Build State Setup Phase</a></li>
+<li><a href="type_index.html#process-queued-uris">7.5.2.3. Process Queued URIs</a></li>
+<li><a href="type_index.html#queueing-affected-resources">7.5.2.4. Queueing Affected Resources</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#sec:Incremental_Builder_Overview__Example">7.5.3. Example</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#dirty-state-handling">7.6. Dirty state handling</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#use-case-restoring-types-from-user-data">7.6.1. Use case: Restoring types from user data</a></li>
+<li><a href="type_index.html#use-case-updating-the-xtext-index">7.6.2. Use case: Updating the Xtext index</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="project_model.html#_project-model">8. Project Model</a>
+<ul class="sectlevel2">
+<li><a href="project_model.html#sec:Package_json">8.1. Package.json File</a></li>
+<li><a href="project_model.html#_accessing-project-information">8.2. Accessing Project Information</a>
+<ul class="sectlevel3">
+<li><a href="project_model.html#sec:IN4JSCore">8.2.1. IN4JSCore</a></li>
+<li><a href="project_model.html#sec:N4JSModel">8.2.2. N4JSModel</a></li>
+<li><a href="project_model.html#sec:N4JSWorkspace">8.2.3. N4JSWorkspace</a></li>
+<li><a href="project_model.html#sec:N4JSProject">8.2.4. N4JSProject</a></li>
+<li><a href="project_model.html#sec:SourceContainer">8.2.5. SourceContainer</a></li>
+<li><a href="project_model.html#sec:N4JSProjectsStateHelper">8.2.6. N4JSProjectsStateHelper</a></li>
+</ul>
+</li>
+<li><a href="project_model.html#sec:Caching">8.3. Caching</a>
+<ul class="sectlevel3">
+<li><a href="project_model.html#_caching-of-externallibraryworkspace">8.3.1. Caching of ExternalLibraryWorkspace</a></li>
+<li><a href="project_model.html#_caching-of-n4jsprojectsstatehelper">8.3.2. Caching of N4JSProjectsStateHelper</a></li>
+</ul>
+</li>
+<li><a href="project_model.html#sec:WildcardPathFilter">8.4. WildcardPathFilter</a></li>
+<li><a href="project_model.html#sec:ProjectUtils">8.5. ProjectUtils</a></li>
+</ul>
+</li>
+<li><a href="#_binding">9. Binding</a>
+<ul class="sectlevel2">
+<li><a href="#sec:Binding_Design_Rationale">9.1. Design Rationale</a></li>
+<li><a href="#sec:Binding_to_Members">9.2. Binding to Members</a></li>
+<li><a href="#sec:Binding_Getter_Setter">9.3. Getter / Setter Binding</a></li>
+<li><a href="#chap:Statics">9.4. Static Member Binding</a></li>
+<li><a href="#sec:Binding_Enumeration">9.5. Enumeration Literals Binding</a></li>
+<li><a href="#sec:Accessibility_of_types_and_members">9.6. Accessibility of types and members</a></li>
+<li><a href="#sec:Member_Scope_Example">9.7. Member Scope Example</a></li>
+<li><a href="#sec:Scoping_for_Members_of_Composed_Type_Explained">9.8. Scoping for Members of Composed Type (Union/Intersection) Example</a></li>
+<li><a href="#sec:Binding_of_Structurally_References_Types">9.9. Structurally References Types</a></li>
+<li><a href="#sec:Building">9.10. Building</a>
+<ul class="sectlevel3">
+<li><a href="#sec:Build_Phases">9.10.1. Build Phases</a></li>
+<li><a href="#sec:Build_Scenarios">9.10.2. Build Scenarios</a></li>
+<li><a href="#sec:Lazy_linking_problem">9.10.3. Lazy linking problem</a></li>
+</ul>
+</li>
+<li><a href="#sec:Proxies_and_Proxy_Resolution">9.11. Proxies and Proxy Resolution (Overview)</a>
+<ul class="sectlevel3">
+<li><a href="#xtexts-lazy-linking-proxies">9.11.1. Xtext’s Lazy Linking Proxies</a></li>
+<li><a href="#standard-emf-proxies">9.11.2. Standard EMF Proxies</a></li>
+<li><a href="#_how-is-proxy-resolution-triggered">9.11.3. How is Proxy Resolution Triggered?</a></li>
+<li><a href="#_when-is-proxy-resolution-allowed">9.11.4. When is Proxy Resolution Allowed?</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="validation.html#_validation">10. Validation</a>
+<ul class="sectlevel2">
+<li><a href="validation.html#sec:validation_overview">10.1. Validation overview</a></li>
+<li><a href="validation.html#sec:validation_control_flow">10.2. Validation control flow</a></li>
+<li><a href="validation.html#sec:validation_issue_ids">10.3. Issue IDs and Messages</a></li>
+<li><a href="validation.html#sec:validation_usage_patterns">10.4. Usage Pattern</a></li>
+<li><a href="validation.html#sec:validation_links">10.5. Links</a></li>
+</ul>
+</li>
+<li><a href="references.html#_references">11. References</a>
+<ul class="sectlevel2">
+<li><a href="references.html#sec:usecases">11.1. Use cases</a></li>
+<li><a href="references.html#sec:calculation_algorithm">11.2. Calculation algorithm</a>
+<ul class="sectlevel3">
+<li><a href="references.html#sec:Xtext_default_implementation">11.2.1. Xtext default implementation</a></li>
+<li><a href="references.html#sec:N4_implementation">11.2.2. N4JS implementation</a></li>
+</ul>
+</li>
+<li><a href="references.html#sec:PerformanceOfDependencyCalculation">11.3. Performance Of Dependency Calculation</a></li>
+<li><a href="references.html#sec:kinds_of_references">11.4. Kinds of references</a>
+<ul class="sectlevel3">
+<li><a href="references.html#sec:Cross_References_to_be_ignored">11.4.1. Cross References to be ignored</a></li>
+<li><a href="references.html#sec:Cross_References_to_be_handled">11.4.2. Cross References to be handled</a></li>
+</ul>
+</li>
+<li><a href="references.html#sec:transitive_dependencies">11.5. Transitive dependencies</a></li>
+<li><a href="references.html#sec:find-references">11.6. Find references</a>
+<ul class="sectlevel3">
+<li><a href="references.html#_background">11.6.1. Background</a></li>
+<li><a href="references.html#_how-find-references-work">11.6.2. How Find References Work</a>
+<ul class="sectlevel4">
+<li><a href="references.html#_step-1-convert-cursor-position-to-declared-element">11.6.2.1. Step 1: Convert Cursor Position to Declared Element</a></li>
+<li><a href="references.html#_step-2-convert-declared-element-to-target-uris">11.6.2.2. Step 2: Convert Declared Element to Target URIs</a></li>
+<li><a href="references.html#_step-3-filter-potential-resources">11.6.2.3. Step 3: Filter Potential Resources</a></li>
+<li><a href="references.html#_step-4-search-references-in-resource">11.6.2.4. Step 4: Search References in Resource</a></li>
+<li><a href="references.html#_limitations-and-possible-enhancements">11.6.2.5. Limitations and Possible Enhancements</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="compilation.html#_compilation">12. Compilation</a>
+<ul class="sectlevel2">
+<li><a href="compilation.html#chap:compilation">12.1. Introduction</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:general_design_rationals">12.1.1. General design rationals</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:logging_and_error_reporting">12.1.1.1. Logging and error reporting</a></li>
+<li><a href="compilation.html#sec:progress_monitor">12.1.1.2. Progress monitor</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Xtext_Integration">12.1.2. Xtext Integration</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:xtext_default_behaviour">12.1.2.1. Xtext default behaviour</a></li>
+<li><a href="compilation.html#sec:n4js_requirements">12.1.2.2. N4JS requirements</a></li>
+<li><a href="compilation.html#sec:compiler_discovery_in_ui">12.1.2.3. Compiler discovery in UI</a></li>
+<li><a href="compilation.html#sec:compiler_discovery_in_headless">12.1.2.4. Compiler discovery in headless</a></li>
+<li><a href="compilation.html#sec:general_generator_implementation">12.1.2.5. General generator implementation</a></li>
+<li><a href="compilation.html#sec:general_generator_activation">12.1.2.6. General generator activation</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Overview_of_Input_Models">12.1.3. Overview of the Input Models</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Core_Generator">12.2. Generators</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:Compiler_Components">12.2.1. Generator Components</a></li>
+<li><a href="compilation.html#sec:Generator_architecture">12.2.2. Generator architecture</a></li>
+<li><a href="compilation.html#sec:Unified_Compiler_Configuration">12.2.3. Unified Compiler Configuration</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Transpilers">12.3. Transpilers</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:Phases">12.3.1. Overview</a></li>
+<li><a href="compilation.html#relation-between-ast-and-im">12.3.2. Relation between AST and IM</a></li>
+<li><a href="compilation.html#implementation-overview">12.3.3. Implementation Overview</a></li>
+<li><a href="compilation.html#sec:Guidelines_for_Implementing_Transformations">12.3.4. Guidelines for Implementing Transformations</a></li>
+<li><a href="compilation.html#symbol-table-in-the-im">12.3.5. Symbol Table in the IM</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:N4JS_to_EcmaScript_Transpiler">12.4. N4JS-to-EcmaScript Transpiler</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:Overview_of_Transformations">12.4.1. Overview of Transformations</a></li>
+<li><a href="compilation.html#sec:Transpiling_members">12.4.2. Transpiling members</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:Transpiling_members__Delegating_members">12.4.2.1. Techniques for special member handling</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__Partial_shadowing_of_getter_setter_pairs">12.4.2.2. Partial shadowing</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__Consuming_or_inheriting_members_of_an_interface">12.4.2.3. Consuming or inheriting members of an interface</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__Static_polyfill">12.4.2.4. Static polyfill</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__API_implementation_stubs">12.4.2.5. API / implementation stubs</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Support_for_incomplete_API_implementation_testing_in_the_N4JS_to_EcmaScript_5_Transpiler">12.4.3. Support for incomplete API implementation testing</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:Modifications_in_Impl_projects">12.4.3.1. Modifications in Impl projects</a></li>
+<li><a href="compilation.html#sec:Implementation_of_stub_generation">12.4.3.2. Implementation of stub-generation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:n4jsc_Headless_Compiler_Interface">12.5. n4jsc Headless Compiler Interface</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:building_the_headless_compiler">12.5.1. building the headless compiler</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="execution.html#_execution">13. Execution</a>
+<ul class="sectlevel2">
+<li><a href="execution.html#sec:N4JS_Project_Execution_And_Linking_Model">13.1. N4JS Project Execution And Linking Model</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#subsec:N4JS_Execution_With_NodeJS">13.1.1. N4JS Execution With NodeJS</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:N4JS_Execution_And_Linking_File">13.2. N4JS Execution And Linking File</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#subsec:NodeJS_Specific_ELF">13.2.1. NodeJS Specific ELF</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Runners-execution">13.3. Runners</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#subsec:N4_Runtime_Environments_Convention">13.3.1. N4 Runtime Environments Convention</a></li>
+<li><a href="execution.html#subsec:Passing_Information_from_IDE_to_Execution_Code_in_Runtime_Environment">13.3.2. Passing Information from IDE to Execution Code in Runtime Environment</a></li>
+<li><a href="execution.html#subsec:Runners_Design">13.3.3. Runners Design</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Legacy_Execution_Engine">13.4. Legacy Execution Engine</a></li>
+<li><a href="execution.html#sec:Design">13.5. Design</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#sec:Usage_Outside_N4JSIDE">13.5.1. Usage Outside N4JSIDE</a>
+<ul class="sectlevel4">
+<li><a href="execution.html#sec:Use_Node_with_Maven">13.5.1.1. Use Node with Maven</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Usage_Inside_N4JSIDE">13.5.2. Usage Inside N4JSIDE</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Runtime_Injection">13.6. Runtime Injection</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#sec:Running_String_Code">13.6.1. Running String Code</a></li>
+<li><a href="execution.html#sec:Running_File_Code">13.6.2. Running File Code</a></li>
+<li><a href="execution.html#sec:Injection_Code_Example">13.6.3. Injection Code Example</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#_tests">14. Tests</a>
+<ul class="sectlevel2">
+<li><a href="tests.html#sec:Performance_Tests">14.1. Performance Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Synthetic_Performance_Tests">14.1.1. Synthetic Performance Tests</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:Design_of_Generator">14.1.1.1. Design of Generator</a></li>
+<li><a href="tests.html#sec:Design_of_Performance_Test_Execution">14.1.1.2. Design of Performance Test Configuration and Execution</a></li>
+<li><a href="tests.html#sec:JUnit_Configuration">14.1.1.3. JUnit Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Test_Configuration">14.1.1.4. JUnitBenchmark Test Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Report_Configuration">14.1.1.5. JUnitBenchmark Report Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Run_Configuration">14.1.1.6. JUnitBenchmark Run Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Example">14.1.1.7. JUnitBenchmark Example</a></li>
+<li><a href="tests.html#sec:Note_on_Jenkins_Job">14.1.1.8. Note on Jenkins Job</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#sec:ECMA_Tests">14.2. ECMA Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Grammar_Tests">14.2.1. Grammar Tests</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:Negative_Tests">14.2.1.1. Negative Tests</a></li>
+<li><a href="tests.html#sec:Test_Exclusion">14.2.1.2. Test Exclusion</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Integration_Tests">14.3. Integration Tests</a></li>
+<li><a href="tests.html#sec:Test_Helpers">14.4. Test Helpers</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Parameterized_N4JS_Tests">14.4.1. Parameterized N4JS tests</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:ParameterizedXtextRunner">14.4.1.1. ParameterizedXtextRunner</a></li>
+<li><a href="tests.html#sec:TestCodeProvider">14.4.1.2. TestCodeProvider</a></li>
+<li><a href="tests.html#sec:Example_Of_Parameterized_Parser_Test">14.4.1.3. Example of parameterized parser test</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Issue_Suppression">14.5. Issue Suppression</a></li>
+<li><a href="tests.html#sec:Xpect_Tests">14.6. Xpect Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Xpect_Test_Setup">14.6.1. Xpect Test Setup</a></li>
+<li><a href="tests.html#sec:Xpect_Issue_Suppression">14.6.2. Xpect Issue Suppression</a></li>
+<li><a href="tests.html#sec:Xpect_Provided_Test_Methods">14.6.3. Xpect Provided Test Methods</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#errors">14.6.3.1. errors</a></li>
+<li><a href="tests.html#warnings">14.6.3.2. warnings</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:N4JS_Specific_Xpect_Test_Methods">14.6.4. N4JS Specific Xpect Test Methods</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:XPECT_noerrors">14.6.4.1. noerrors and nowarnings</a></li>
+<li><a href="tests.html#sec:XPECT_scope">14.6.4.2. scope</a></li>
+<li><a href="tests.html#sec:XPECT_scopeWithPosition">14.6.4.3. scopeWithPosition</a></li>
+<li><a href="tests.html#sec:XPECT_scopeWithResource">14.6.4.4. scopeWithResource</a></li>
+<li><a href="tests.html#sec:XPECT_binding">14.6.4.5. binding</a></li>
+<li><a href="tests.html#sec:XPECT_linkedPathname">14.6.4.6. linkedPathname</a></li>
+<li><a href="tests.html#sec:XPECT_type_of">14.6.4.7. type of</a></li>
+<li><a href="tests.html#sec:XPECT_expectedType">14.6.4.8. expectedType</a></li>
+<li><a href="tests.html#sec:XPECT_elementKeyword">14.6.4.9. elementKeyword</a></li>
+<li><a href="tests.html#sec:XPECT_accessModifier">14.6.4.10. accessModifier</a></li>
+<li><a href="tests.html#sec:XPECT_compileResult">14.6.4.11. compileResult</a></li>
+<li><a href="tests.html#sec:XPECT_output">14.6.4.12. output</a></li>
+<li><a href="tests.html#sec:XPECT_outputRegEx">14.6.4.13. outputRegEx</a></li>
+<li><a href="tests.html#sec:XPECT_calculatedAccessModifier">14.6.4.14. calculatedAccessModifier</a></li>
+<li><a href="tests.html#sec:XPECT_spec">14.6.4.15. spec</a></li>
+<li><a href="tests.html#sec:XPECT_deadCode">14.6.4.16. deadCode</a></li>
+<li><a href="tests.html#sec:XPECT_returnOrThrows">14.6.4.17. returnOrThrows</a></li>
+<li><a href="tests.html#sec:XPECT_lint">14.6.4.18. lint</a></li>
+<li><a href="tests.html#sec:XPECT_lintFails">14.6.4.19. lintFails</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:FIXME_Xpect_modifier">14.6.5. FIXME Xpect modifier</a></li>
+<li><a href="tests.html#sec:Expectmatrix_Xpect_Test_Methods">14.6.6. Expectmatrix Xpect tests</a></li>
+<li><a href="tests.html#xpect-lint-tests">14.6.7. Xpect Lint Tests</a></li>
+</ul>
+</li>
+<li><a href="tests.html#xpect-proposal-tests">14.7. Xpect Proposal Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Validation_vs__Non_Validation">14.7.1. Validation vs. Non-Validation</a></li>
+<li><a href="tests.html#sec:General_Proposal_Test_Features">14.7.2. General Proposal Test Features</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:Test_Variables">14.7.2.1. Test Variables</a></li>
+<li><a href="tests.html#sec:Location_and_Selection">14.7.2.2. at – Location and Selection</a></li>
+<li><a href="tests.html#sec:Multi_Line_Expectations_in_Proposal_Tests">14.7.2.3. Multi Line Expectations in Proposal Tests</a></li>
+<li><a href="tests.html#sec:Timeout">14.7.2.4. Timeout and Performance</a></li>
+</ul>
+</li>
+<li><a href="tests.html#proposals-verify-existence-of-proposals">14.7.3. proposals – Verify Existence of Proposals</a></li>
+<li><a href="tests.html#sec:Verify_displayed_string">14.7.4. display – Verify displayed string</a></li>
+<li><a href="tests.html#sec:Apply_Proposal">14.7.5. apply – Apply Proposal</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#resource-application-in-other-files">14.7.5.1. resource – application in other files</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Content_Assist_Cycling">14.7.6. kind – Content Assist Cycling</a></li>
+<li><a href="tests.html#fileValidVerify-validation-status">14.7.7. fileValid – Verify validation status</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Apply_Proposal_And_Execute_Tests">14.8. Apply Proposal And Execute Tests</a></li>
+<li><a href="tests.html#sec:Organize_Imports_Test">14.9. Organize Imports Test</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#organizeimports">14.9.1. organizeImports</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Access_Control_Test">14.10. Access Control Test</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#test-scenarios">14.10.1. Test Scenarios</a></li>
+<li><a href="tests.html#n4js-code-generator">14.10.2. N4JS Code Generator</a></li>
+<li><a href="tests.html#xtext-issue-matcher">14.10.3. Xtext Issue Matcher</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Smoke_Tests">14.11. Smoke Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#how-to-handle-smoke-test-errors">14.11.1. How to handle smoke test errors?</a></li>
+<li><a href="tests.html#smoketester-and-exceptionanalyzer">14.11.2. SmokeTester and ExceptionAnalyzer</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:UI_Tests_with_SWTBot">14.12. UI Tests with SWTBot</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#writing-swtbot-tests">14.12.1. Writing SWTBot Tests</a></li>
+<li><a href="tests.html#running-swtbot-tests">14.12.2. Running SWTBot Tests</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Debugging_UI_Tests">14.13. Debugging UI Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Connecting_to_the_X_server_on_the_build_node">14.13.1. Connecting to the X-server on the build-node</a></li>
+<li><a href="tests.html#sec:Tools_to_investigate_the_java_stack">14.13.2. Tools to investigate the java-stack</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="ui_concepts.html#_ui-concepts">15. UI Concepts</a>
+<ul class="sectlevel2">
+<li><a href="ui_concepts.html#sec:User_Interface_Concepts">15.1. User Interface Concepts</a>
+<ul class="sectlevel3">
+<li><a href="ui_concepts.html#sec:Eclipse_UI_Concepts">15.1.1. Eclipse UI Concepts</a>
+<ul class="sectlevel4">
+<li><a href="ui_concepts.html#sec:Label_Provider">15.1.1.1. Label Provider</a></li>
+<li><a href="ui_concepts.html#sec:Markers">15.1.1.2. Markers</a></li>
+<li><a href="ui_concepts.html#sec:Commands__Toolbar_and_Menus">15.1.1.3. Commands, Toolbar and Menus</a></li>
+<li><a href="ui_concepts.html#sec:Content_Assist">15.1.1.4. Content Assist</a></li>
+<li><a href="ui_concepts.html#sec:Quick_Fixes">15.1.1.5. Quick Fixes</a></li>
+<li><a href="ui_concepts.html#sec:Quick_Assist">15.1.1.6. Quick Assist</a></li>
+<li><a href="ui_concepts.html#sec:Clean_Up_Actions">15.1.1.7. Clean Up Actions</a></li>
+<li><a href="ui_concepts.html#sec:Save_Actions">15.1.1.8. Save Actions</a></li>
+<li><a href="ui_concepts.html#sec:Auto_Edit">15.1.1.9. Auto Edit</a></li>
+<li><a href="ui_concepts.html#sec:Template_Proposals">15.1.1.10. Template Proposals</a></li>
+<li><a href="ui_concepts.html#sec:Outline_View___Quick_Outline">15.1.1.11. Outline View / Quick Outline</a></li>
+<li><a href="ui_concepts.html#sec:Navigator__Package_Explorer__Project_Explorer">15.1.1.12. Navigator, Package Explorer, Project Explorer</a></li>
+<li><a href="ui_concepts.html#sec:Hyperlinking_and_Navigation">15.1.1.13. Hyperlinking and Navigation</a></li>
+<li><a href="ui_concepts.html#sec:Syntax_and_Semantic_Coloring">15.1.1.14. Syntax and Semantic Coloring</a></li>
+<li><a href="ui_concepts.html#sec:Code_Formatter">15.1.1.15. Code Formatter</a></li>
+<li><a href="ui_concepts.html#sec:Wizards">15.1.1.16. Wizards</a></li>
+<li><a href="ui_concepts.html#sec:Cheat_Sheets">15.1.1.17. Cheat Sheets</a></li>
+<li><a href="ui_concepts.html#sec:Context_sensitive_Help">15.1.1.18. Context-sensitive Help</a></li>
+<li><a href="ui_concepts.html#sec:Hovers">15.1.1.19. Hovers</a></li>
+<li><a href="ui_concepts.html#sec:Folding">15.1.1.20. Folding</a></li>
+<li><a href="ui_concepts.html#sec:Customizable_validation___severity">15.1.1.21. Customizable validation / severity</a></li>
+<li><a href="ui_concepts.html#sec:Proposals">15.1.1.22. Proposals</a></li>
+</ul>
+</li>
+<li><a href="ui_concepts.html#sec:Non_Eclipse_UI_Concepts">15.1.2. Non-Eclipse UI Concepts</a>
+<ul class="sectlevel4">
+<li><a href="ui_concepts.html#sec:Overlays">15.1.2.1. Overlays</a></li>
+<li><a href="ui_concepts.html#sec:Goto__Inferred__Type">15.1.2.2. Goto (Inferred) Type</a></li>
+<li><a href="ui_concepts.html#sec:Postfix_Completion">15.1.2.3. Postfix Completion</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="ui_concepts.html#_user-interface-resources">15.2. User Interface Resources</a>
+<ul class="sectlevel3">
+<li><a href="ui_concepts.html#_icons">15.2.1. Icons</a>
+<ul class="sectlevel4">
+<li><a href="ui_concepts.html#_eclipse-platform-icons">15.2.1.1. Eclipse Platform Icons</a></li>
+<li><a href="ui_concepts.html#_n4js-specific-icons">15.2.1.2. N4JS Specific Icons</a></li>
+<li><a href="ui_concepts.html#_high-resolution-icons">15.2.1.3. High Resolution Icons</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="formatting.html#_formatting">16. Formatting</a>
+<ul class="sectlevel2">
+<li><a href="formatting.html#sec:FmtObjective">16.1. Objective</a>
+<ul class="sectlevel3">
+<li><a href="formatting.html#sec:FmtFormatting_Comments">16.1.1. Formatting Comments</a></li>
+</ul>
+</li>
+<li><a href="formatting.html#sec:FmtArchitecture">16.2. Architecture</a>
+<ul class="sectlevel3">
+<li><a href="formatting.html#sec:Implementation_example">16.2.1. Implementation example</a></li>
+</ul>
+</li>
+<li><a href="formatting.html#sec:FmtFormatter_Implementation_Guidelines">16.3. Formatter Implementation Guidelines</a></li>
+<li><a href="formatting.html#sec:FmtConfiguration">16.4. Configuration</a></li>
+<li><a href="formatting.html#sec:FmtUI_Integration">16.5. UI Integration</a></li>
+<li><a href="formatting.html#sec:FmtUnit_Testing_with_Xpect">16.6. Unit Testing with Xpect</a></li>
+</ul>
+</li>
+<li><a href="external_libraries.html#_external-libraries">17. External Libraries</a>
+<ul class="sectlevel2">
+<li><a href="external_libraries.html#sec:Major_Components">17.1. Major Components</a>
+<ul class="sectlevel3">
+<li><a href="external_libraries.html#subsec:External_Resources">17.1.1. External Resources</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Workspace">17.1.2. External Library Workspace</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Preference_Store">17.1.3. External Library Preference Store</a></li>
+<li><a href="external_libraries.html#subsec:npm_Manager">17.1.4. Library Manager</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Builder_Helper">17.1.5. External Library Builder</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Xtext_Index_Persister">17.1.6. External Library Xtext Index Persister</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Preference_Page">17.1.7. External Library Preference Page</a></li>
+</ul>
+</li>
+<li><a href="external_libraries.html#sec:Headless_External_Library_Support">17.2. Headless External Library Support</a>
+<ul class="sectlevel3">
+<li><a href="external_libraries.html#_custom-npm-settings">17.2.1. Custom npm settings</a></li>
+</ul>
+</li>
+<li><a href="external_libraries.html#sec:lmFutureWork">17.3. Future Work</a>
+<ul class="sectlevel3">
+<li><a href="external_libraries.html#subsec:lmMultipleDependencyScope">17.3.1. Multiple Dependency Scope</a></li>
+<li><a href="external_libraries.html#subsec:lmRunTestsFromLibrary">17.3.2. Run Tests from TestLibrary</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="json_support.html#sec:JSON_Support">18. JSON Support</a>
+<ul class="sectlevel2">
+<li><a href="json_support.html#sec:JSON_Parser">18.1. JSON Parser</a>
+<ul class="sectlevel3">
+<li><a href="json_support.html#sec:JSON_Parser_Unicode_Escaping">18.1.1. Escaping Unicode Control Characters in String Literals</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Empty_Text">18.1.2. Empty Text</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Nested_Structures">18.1.3. Nested Structures</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Whitespace">18.1.4. Whitespace</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Comments">18.1.5. Comments</a></li>
+</ul>
+</li>
+<li><a href="json_support.html#sec:JSON_Language_Extensions">18.2. JSON Language Extensions</a>
+<ul class="sectlevel3">
+<li><a href="json_support.html#sec:JSON_Validator_Extensions">18.2.1. JSON Validator Extensions</a>
+<ul class="sectlevel4">
+<li><a href="json_support.html#sec:File_Specitic_Validator_Extensions">18.2.1.1. File-Specific Validator Extensions</a></li>
+<li><a href="json_support.html#sec:JSON_Declarative_JSON_Validator_Extensions">18.2.1.2. Declarative JSON Validator Extensions</a></li>
+</ul>
+</li>
+<li><a href="json_support.html#_json-resource-description-strategy">18.2.2. JSON Resource Description Strategy</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_jsdoc">19. JSDoc</a>
+<ul class="sectlevel2">
+<li><a href="jsdoc.html#sec:Design_Rationale">19.1. Design Rationale</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#_general-design">19.1.1. General Design</a></li>
+<li><a href="jsdoc.html#sec:Type_Expressions">19.1.2. Type Expressions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="docexporter.html#_docexporter">20. DocExporter</a>
+<ul class="sectlevel2">
+<li><a href="docexporter.html#sec:Specification_Exporter">20.1. Specification Exporter</a></li>
+</ul>
+</li>
+<li><a href="rename_refactoring.html#_rename-refactoring">21. Rename Refactoring</a>
+<ul class="sectlevel2">
+<li><a href="rename_refactoring.html#_rename-refactoring-ui-interaction">21.1. Rename Refactoring UI interaction</a></li>
+<li><a href="rename_refactoring.html#_renameelementprocessor-interaction">21.2. RenameElementProcessor interaction</a></li>
+</ul>
+</li>
+<li><a href="flow_graphs.html#chap:flowgraphs">22. Flow Graphs</a>
+<ul class="sectlevel2">
+<li><a href="flow_graphs.html#sec:flowgraphs_overview">22.1. Flow graphs overview</a>
+<ul class="sectlevel3">
+<li><a href="flow_graphs.html#_internal-graph">22.1.1. Internal graph</a></li>
+<li><a href="flow_graphs.html#_optimizations">22.1.2. Optimizations</a></li>
+<li><a href="flow_graphs.html#_api-for-client-analyses">22.1.3. API for client analyses</a>
+<ul class="sectlevel4">
+<li><a href="flow_graphs.html#_mapping-from-internal-to-ast-elements">22.1.3.1. Mapping from internal to AST elements</a></li>
+<li><a href="flow_graphs.html#_graph-visitor">22.1.3.2. Graph visitor</a></li>
+<li><a href="flow_graphs.html#_graph-explorer">22.1.3.3. Graph explorer</a></li>
+<li><a href="flow_graphs.html#_branch-walker">22.1.3.4. Branch walker</a></li>
+<li><a href="flow_graphs.html#_example-1-compute-string-for-each-path">22.1.3.5. Example 1: Compute string for each path</a></li>
+<li><a href="flow_graphs.html#_path-quantor">22.1.3.6. Path quantor</a></li>
+</ul>
+</li>
+<li><a href="flow_graphs.html#_control-flow-analyses">22.1.4. Control flow analyses</a>
+<ul class="sectlevel4">
+<li><a href="flow_graphs.html#_dead-code-analysis">22.1.4.1. Dead code analysis</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="flow_graphs.html#sec:dataflow">22.2. Dataflow</a>
+<ul class="sectlevel3">
+<li><a href="flow_graphs.html#_dataflow-graph">22.2.1. Dataflow graph</a></li>
+<li><a href="flow_graphs.html#_dataflow-analyses">22.2.2. Dataflow analyses</a>
+<ul class="sectlevel4">
+<li><a href="flow_graphs.html#_def-def-def-nothing-analysis">22.2.2.1. Def&#8594;Def / Def&#8594;Nothing analysis</a></li>
+<li><a href="flow_graphs.html#_def-use-decl-analysis">22.2.2.2. Def|Use&#8592;Decl analysis</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="publish_npms.html#sec:publish-npms-to-public">23. Publish npms</a>
+<ul class="sectlevel2">
+<li><a href="publish_npms.html#sec:publish-npms-n4js-maven">23.1. Publish n4js-libs to during  maven build</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Hints">Appendix A: Hints</a>
+<ul class="sectlevel2">
+<li><a href="appendix_a_hints.html#sec:XtextInjection">A.1. Xtext Injection</a>
+<ul class="sectlevel3">
+<li><a href="appendix_a_hints.html#sec:DI_MultipleInjectors_Singletons">A.1.1. Multiple Injectors and Singletons</a>
+<ul class="sectlevel4">
+<li><a href="appendix_a_hints.html#sec:DI_avoid_duplicate_singletons">A.1.1.1. Avoiding duplicate singletons</a>
+<ul class="sectlevel5">
+<li><a href="appendix_a_hints.html#sec:DI_binding_in_shared">A.1.1.1.1. Defining binding in the shared injector</a></li>
+<li><a href="appendix_a_hints.html#sec:DI_binding_in_custom">A.1.1.1.2. Defining binding in the custom injector</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:DI_Hints">A.1.2. Dependency Injection Hints</a>
+<ul class="sectlevel4">
+<li><a href="appendix_a_hints.html#sec:DI_custom_bundle">A.1.2.1. Use DI in custom bundle, use DI with extensions</a>
+<ul class="sectlevel5">
+<li><a href="appendix_a_hints.html#sec:DI_custom_bundle_problem">A.1.2.1.1. Problem</a></li>
+<li><a href="appendix_a_hints.html#sec:DI_custom_bundle_solution">A.1.2.1.2. Solution</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Access_Other_DSL_Injector">A.1.2.2. How do I get the Guice Injector of my language?</a>
+<ul class="sectlevel5">
+<li><a href="appendix_a_hints.html#sec:DSL_Injector_UI_context">A.1.2.2.1. UI context</a></li>
+<li><a href="appendix_a_hints.html#sec:DSL_Injector_Non_UI_context">A.1.2.2.2. Non UI context but with injection context</a></li>
+<li><a href="appendix_a_hints.html#sec:DSL_Injector_Non_UI_non_injection_context">A.1.2.2.3. Non UI context without injection context</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Cancel_Indicator">A.1.2.3. How do I get cancel indicators in different contexts?</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Eclipse">A.2. Eclipse</a>
+<ul class="sectlevel3">
+<li><a href="appendix_a_hints.html#sec:Show_Xtext_Index">A.2.1. Show the current Xtext index</a></li>
+<li><a href="appendix_a_hints.html#sec:Plugin_spy">A.2.2. Plug-in spy</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Maven-hints">A.3. Maven</a>
+<ul class="sectlevel3">
+<li><a href="appendix_a_hints.html#how-to-check-for-maven-mojo-updates">A.3.1. How to check for Maven MOJO updates</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#_module-loading">Appendix B: Module Loading</a>
+<ul class="sectlevel2">
+<li><a href="appendix_b_module_loading.html#sec:Dependency_Management">B.1. Dependency Management</a></li>
+<li><a href="appendix_b_module_loading.html#ecmascript-modules">B.2. ECMAScript Modules</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:ES5_Modules_Systems">B.2.1. ES5 Modules Systems</a></li>
+<li><a href="appendix_b_module_loading.html#sec:ES6_Modules">B.2.2. ES6 Modules</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:ECMAScript_Module_Loaders">B.3. ECMAScript Module Loaders</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:ES6_Module_Loaders">B.3.1. ES6 Module Loaders</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Polyfills_for_ES6_Module_Loaders">B.3.2. Polyfills for ES6 Module Loaders</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:es6_module_loader">B.3.2.1. es6-module-loader</a></li>
+<li><a href="appendix_b_module_loading.html#sec:SystemJS">B.3.2.2. SystemJS</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Demo">B.3.2.3. Demo</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#case-study-typescript">B.4. Case Study : TypeScript</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:ES6_Modules_Support">B.4.1. ES6 Modules Support</a></li>
+<li><a href="appendix_b_module_loading.html#sec:TypeScript_and_Module_Loading">B.4.2. TypeScript and Module Loading</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Cyclic_Dependencies">B.5. Cyclic Dependencies</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:Setup">B.5.1. Setup</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Transpile_and_Execute">B.5.2. Transpile and Execute</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Module_Format___AMD">B.5.2.1. Module Format = AMD</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Module_Format___CommonJS">B.5.2.2. Module Format = CommonJS</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Module_Format___SystemJS">B.5.2.3. Module Format = SystemJS</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Conclusion">B.5.3. Conclusion</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#system.register-as-transpilation-target">B.6. System.register as transpilation target</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:Introduction">B.6.1. Introduction</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:External_Transpilers">B.6.1.1. External Transpilers</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Example_of_a_System_register_module">B.6.1.2. Example of a System.register module</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Structure_of_a_System_register_module">B.6.2. Structure of a System.register module</a></li>
+<li><a href="appendix_b_module_loading.html#_transpilation-hints">B.6.3. Transpilation Hints</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Handling_Imports">B.6.3.1. Handling Imports</a></li>
+<li><a href="appendix_b_module_loading.html#sec:__exportFn__">B.6.3.2. &lt;&lt;exportFn&gt;&gt;</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Handling_Exports">B.6.3.3. Handling Exports</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Examples_w__Circular_Dependencies">B.6.4. Examples w/ Circular Dependencies</a></li>
+<li><a href="appendix_b_module_loading.html#sec:N4JS_Examples_w__Circular_Dependencies">B.6.5. N4JS Examples w/ Circular Dependencies</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Unresolved_Cyclic_Dependencies">B.6.5.1. Unresolved Cyclic Dependencies</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Variables___Functions">B.6.5.2. Examples with Variables &amp; Functions</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Classes">B.6.5.3. Examples with Classes</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Examples_with_SubClassing">B.6.5.4. Examples with SubClassing</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Miscellaneous">B.6.5.5. Miscellaneous</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#_resources">B.6.6. Resources</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:CommonJS_as_transpilation_target">B.7. CommonJS as transpilation target</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#_introduction-2">B.7.1. Introduction</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Transpilation_Hints">B.7.2. Transpilation Hints</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Import_Statements">B.7.2.1. Import Statements</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Export_Statements">B.7.2.2. Export Statements</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Tracking_Live_Bindings">B.7.2.3. Tracking Live Bindings</a></li>
+<li><a href="appendix_b_module_loading.html#sec:A_complete_example">B.7.2.4. A complete example</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#_resources-2">B.7.3. Resources</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_c_license.html#sec:License">Appendix C: License</a></li>
+<li><a href="appendix_d_acronyms.html#sec:Acronyms">Appendix D: Acronyms</a></li>
+<li><a href="appendix_e_bibliography_and_footnotes.html#_bibliography-and-footnotes">Appendix E: Bibliography and Footnotes</a></li>
+</ul>
+</div>
+</div>
+<div id="content"><div class="sect1">
+<h2 id="_binding"><a class="anchor" href="#_binding"></a><a class="link" href="#_binding">9. Binding</a></h2>
+<div class="sectionbody">
+<div class="admonitionblock warning">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-warning" title=""></i>
+</td>
+<td class="content">
+This section may be outdated!
+</td>
+</tr>
+</table>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:Binding_Design_Rationale"><a class="anchor" href="#sec:Binding_Design_Rationale"></a><a class="link" href="#sec:Binding_Design_Rationale">9.1. Design Rationale</a></h3>
+<div class="paragraph">
+<p>Binding references to declarations follows the Xtext mechanism based on local <code>N4JSScopeProvider</code> and a global <code>N4JSGlobalScopeProvider</code> scope providers. The basic question is: to which elements are references bound to. This in particular interesting for all kind of type declarations, including functions as they are interpreted as types. These declarations are Janus-faced: On the one side, they are targets of type references as <code>Type</code>, and on the other side they can also be target of identifier references bound to some so called <code>IdentifiableElement</code>. As explained in <a href="#_type_index">[_type_index]</a>, special type objects (<code>TClass</code> etc.) are created from the original declarations. These type objects are used as targets for both kind of references. The following table summarizes the reference-target relations relevant for N4JS (not the standalone type grammar).</p>
+</div>
+<table class="tableblock frame-all grid-all spread">
+<caption class="title">Table 4. N4JS Cross References</caption>
+<colgroup>
+<col style="width: 50%;">
+<col style="width: 50%;">
+</colgroup>
+<thead>
+<tr>
+<th class="tableblock halign-left valign-top">Reference</th>
+<th class="tableblock halign-left valign-top">Target Type</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<th class="tableblock halign-left valign-top" colspan="2"><p class="tableblock">N4JS</p></th>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">ImportDeclaration.importedModule</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">TModule</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">NamedImportSpecifier.importedElement</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">types.IdentifiableElement</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">IdentifierRef.id</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">types.IdentifiableElement</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">ParameterizedPropertyAccessExpression.property</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">types.TMethod</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">PropertyAccessExpression.property</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">types.TMember</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">N4Getter/N4SetterDeclaration.field</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">N4FieldDeclaration</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Continue/Break-Statement.label</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">LabelledStatement</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top" colspan="2"><p class="tableblock">Type Expressions</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">ParameterizedTypeRef.declaredType</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Type</p></td>
+</tr>
+</tbody>
+</table>
+<div class="paragraph">
+<p><a href="#fig:cd_scoping">Overview Scoping Package</a> gives an overview over the most important classes in the scoping package, with the <code>N4JSScopeProvider</code> and the used customized scopes created by the scope providers.</p>
+</div>
+<div id="fig:cd_scoping" class="imageblock center">
+<div class="content">
+<img src="chapters/09_binding/images/cd_scoping.svg" alt="cd scoping">
+</div>
+<div class="title">Figure 21. Overview Scoping Package</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:Binding_to_Members"><a class="anchor" href="#sec:Binding_to_Members"></a><a class="link" href="#sec:Binding_to_Members">9.2. Binding to Members</a></h3>
+<div class="paragraph">
+<p>Members of different types, such as classes and also record types or enumerations, are bound using the <code>MemberScopeProvider</code>. This often returns a <code>MemberScope</code>, which directly works on the members. Most types with members are implemented by subclasses of <code>ContainerType</code>, using <code>CollectMembersHelper</code> to collect all members and <code>FindMemberHelper</code> for retrieving a member by its name via <code>ContainerTypes</code>. Ensure that when types with members are added to override appropriate methods in all of these related classes (e.g., <code>CollectMembersHelper</code>, <code>AbstractHierachyTraverser</code> and <code>FindMemberHelper</code> uses polymorphic dispatch to handle different subtypes – so you won’t be able to find a member if you do not adjust these helpers).</p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="sec:Binding_Getter_Setter"><a class="anchor" href="#sec:Binding_Getter_Setter"></a><a class="link" href="#sec:Binding_Getter_Setter">9.3. Getter / Setter Binding</a></h3>
+<div class="paragraph">
+<p>For customized binding of getters / setters, see <a href="#sec:Field_Accessors">Accessors</a>.</p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="chap:Statics"><a class="anchor" href="#chap:Statics"></a><a class="link" href="#chap:Statics">9.4. Static Member Binding</a></h3>
+<div class="paragraph">
+<p>For customized binding of static members, see <a href="#sec:Static_Members">Static Members</a>.</p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="sec:Binding_Enumeration"><a class="anchor" href="#sec:Binding_Enumeration"></a><a class="link" href="#sec:Binding_Enumeration">9.5. Enumeration Literals Binding</a></h3>
+<div class="ulist">
+<ul>
+<li>
+<p>introduced new type ref EnumTypeRef: it behaves comparable to ClassifierTypeRef, but with the difference that the MemberScopeProvider filters for a given EnumTypeRef filters all literals of the contained TEnum (in comparison the MemberScopeProvider filters for a given ClassifierTypeRef all static members of the contained classifier)</p>
+</li>
+<li>
+<p>it isn’t possible to access literals on a enumeration literal itself, although this literal is typed as TEnum (that contains TEnumLiterals)</p>
+</li>
+<li>
+<p>as there are currently no additional fields and operations for enumeration literals defined (in Java there is name and value()), the scope for literals is currently empty</p>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:Accessibility_of_types_and_members"><a class="anchor" href="#sec:Accessibility_of_types_and_members"></a><a class="link" href="#sec:Accessibility_of_types_and_members">9.6. Accessibility of types and members</a></h3>
+<div class="paragraph">
+<p>Member access and type access has to be constrained and validated against the accessibility rules of N4JS. Therefore, the scoping annotates certain elements as erroneous to detect invalid references.</p>
+</div>
+<div class="paragraph">
+<p>Basically two different approaches are used to implement that behavior:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>The <code>VisibilityAwareTypeScope</code> and <code>VisibilityAwareMemberScope</code> decorate an existing scope to validate the result on access. This allows to lazily check the visibility of the returned element. If it is not accessible, it is wrapped in a <code>AbstractDescriptionWithError</code> which will be indentified as such by the <code>ErrorAwareLinkingService</code>. Before the binding is resolved and the EMF proxy is replaced, the error message is used to create an EMF diagnostic.</p>
+</li>
+<li>
+<p>For other cases, the scopes are produced differently, e.g. if all elements are easily enumerable and have to be collected before the scope is created (e.g. for imported elements), the scoped elements are validated eagerly to put them into the correct layer of scopes. That is, the valid descriptions may shadow the invalid description. Since there are more error conditions for these cases, e.g. duplicate imports and similar cases, the accessibility is checked before the concrete member is accessed. All the instances <code>AbstractDescriptionWithError</code> are put into the <code>MapBasedScope</code> immediately.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>In that sense, accessibility checks are basically implemented as decorators for the scoping itself. Bindings are established but flagged as errors.</p>
+</div>
+<div class="paragraph">
+<p>Default visibility of members is calculated in <code>Types.xcore</code> (in <code>getTypeAccessModifier</code> and <code>getMemberAccessModifier</code> etc.). Visibility is checked in <code>org.eclipse.n4js.scoping.accessModifiers.MemberVisibilityChecker</code> and validators.</p>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:Member_Scope_Example"><a class="anchor" href="#sec:Member_Scope_Example"></a><a class="link" href="#sec:Member_Scope_Example">9.7. Member Scope Example</a></h3>
+<div class="paragraph">
+<p>In this section, we are going to have a look at the creation process of <code>MemberScope</code>.</p>
+</div>
+<div class="listingblock">
+<div class="title">C.n4js</div>
+<div class="content">
+<pre class="highlight"><code>export public class C {
+	 private m1: int;
+	 public m2: int;
+}</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="title">Test.n4js</div>
+<div class="content">
+<pre class="highlight"><code>import { C } from "C";
+
+let c: C = new C();
+c.m1;  // Error -&gt; The field m1 is not visible
+c.m2;  // OK    -&gt; m2 is visible at this context</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Assume that we need to figure out to which element the <code>ParameterizedPropertyAccessExpression c.m1</code> in the <code>ExpressionStatement c.m1</code> binds to. To answer this question, <code>N4JSScopeProvider.getScope(context, reference)</code> is triggered whereby <code>context</code> is the <code>ParameterizedPropertyAccessExpression</code> and <code>reference</code> is <code>EReference property</code> (<code>property</code> is the cross-reference element defined in <code>ParameterizedPropertyAccessExpression</code> 's grammar).</p>
+</div>
+<div class="paragraph">
+<p><code>N4JSScopeProvider.getScope(context, reference)</code> does not implement the scoping but delegates to corresponding methods based on the type of <code>context</code>. In our example, since <code>context</code> is a <code>ParameterizedPropertyAccessExpression</code>, the scoping logic is delegated to the method that creates a <strong>MemberScope</strong> for the context <code>ParameterizedPropertyAccessExpression c.m1</code> based on the receiver type of <code>c</code> which is class <code>C</code>.
+The resulting scope instance returned by <code>N4JSScopeProvider.getScope()</code> in our example is of type <code>TypingStrategyAwareMemberScope</code> as shown in <a href="#fig:memberscope-example">Member scope hierarchy</a> .</p>
+</div>
+<div id="fig:memberscope-example" class="imageblock" style="text-align: center">
+<div class="content">
+<img src="chapters/09_binding/images/memberscope_example.svg" alt="memberscope example">
+</div>
+<div class="title">Figure 22. Member scope hierarchy</div>
+</div>
+<div class="paragraph">
+<p>In the hierarchy, the top-level scope is the NULL scope. Directly below the NULL scope is a MemberScope which contains all members of <code>N4Object</code> since the class <code>C</code> implicitly inherits <code>N4Object</code>. The other <code>MemberScope</code> instance beneath contains all members of the class <code>C</code> <strong>regardless of their visibility</strong>. These members are <code>m1</code> and <code>m2</code>. While <code>m2</code> is can be accessed by <code>c.m2</code>, <code>m1</code> it not visible at <code>c.m1</code>. The <code>VisibilityAwareMemberScope</code> implements precisely this behavior. In particular, it returns all members of <code>C</code> that are visible at the current <code>context</code> (here the element <code>m2</code>),  while wrapping non-visible members (here the element <code>m</code>) in <code>InvisibleMemberDescription</code> instances. These <code>InvisibleMemberDescription</code> instances of type <code>IEObjectDescriptionWithError</code> contain issue code and error message related to accessibility problems and are recognized during the error-aware linking phase done by <code>ErrorAwareLinkingService</code>. It is worth to emphasize the motivation behind use of <code>IEObjectDescriptionWithError</code> is to provide more informative error messages to the user other than <em>Cannot reference element&#8230;&#8203;</em> Another example of <code>IEObjectDescriptionWithError</code> is <code>WrongWriteAccessDescription</code> that is used when we, try to write to a getter and no corresponding setter exists.</p>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:Scoping_for_Members_of_Composed_Type_Explained"><a class="anchor" href="#sec:Scoping_for_Members_of_Composed_Type_Explained"></a><a class="link" href="#sec:Scoping_for_Members_of_Composed_Type_Explained">9.8. Scoping for Members of Composed Type (Union/Intersection) Example</a></h3>
+<div class="paragraph">
+<p>In this section, we will have a look at how scoping is implemented for composed type, i.e. union or intersection type with an example of union type. Intersection is done similarly. Before reading this, it is strongly recommended to read <a href="#sec:Member_Scope_Example">Member Scope Example</a> first.</p>
+</div>
+<div class="listingblock">
+<div class="title">Defs.n4js</div>
+<div class="content">
+<pre class="highlight"><code>export public class C {
+	 private m1: int;
+	 public m2: int;
+}
+
+export public class D {
+	 private m1: int;
+	 get m2(): int { return 42; };
+}</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="title">Test.n4js</div>
+<div class="content">
+<pre class="highlight"><code>import { C, D } from "Defs";
+
+let cud : C|D;
+
+cud.m2 = 10;</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Assume that we need to find out to what element the <code>ParameterizedPropertyAccessExpression cud.m2</code> in the <code>ExpressionStatement cud.m2</code> binds to.
+This is a question for scoping. Since the receiver type of <code>cud</code> is a union type <code>C|D</code>, a <code>UnionMemberScope</code> is created that contains two subscopes, each of which corresponds to an individual type in the union. The resulting scope hierarchy is graphically depicted in <a href="#fig:unionmemberscope-example">Union member scope hierarchy</a>.</p>
+</div>
+<div id="fig:unionmemberscope-example" class="imageblock" style="text-align: center">
+<div class="content">
+<img src="chapters/09_binding/images/unionmemberscope_example.svg" alt="unionmemberscope example">
+</div>
+<div class="title">Figure 23. Union member scope hierarchy</div>
+</div>
+<div class="paragraph">
+<p>The two subscopes are of type <code>TypingStrategyAwareMemberScope</code> and created exactly the same way as described in <a href="#sec:Member_Scope_Example">Member Scope Example</a>.
+The <code>UnionMemberScope</code> instance contains a list of subscopes for all types involved in the union and is responsible for constructing an <code>IEObjectDescription</code> instance for <code>m2</code> by merging all members of the name <code>m2</code> found in all subscopes.
+Merging members requires considering a variety of combinations (fields, setters getters, optional/variadic parameters etc.) and thus can become very complicated. To reduce the complexity, the recently refactored implementation splits the proccess into three separate steps.</p>
+</div>
+<div class="paragraph">
+<p>Step 1: Collect information</p>
+</div>
+<div class="paragraph">
+<p>During this phase, members with the name <code>m2</code> are looked up in each subscope and collected into an <code>ComposedMemberInfo</code> instance by <code>ComposedMemberInfoBuilder</code>.
+The first subscope (left branch in the <a href="#fig:unionmemberscope-example">Union member scope hierarchy</a>) returns an <code>EObjectDescription</code> wrapping the <code>TField m2</code> of class <code>C</code> and hence <code>TField m2</code> is added to the <code>ComposedMemberInfo</code> instance. The second subscope (right branch in the <a href="#fig:unionmemberscope-example">Union member scope hierarchy</a>) returns a <code>WrongWriteAccessDescription</code> wrapping the <code>TGetter m2</code> of class <code>D</code> and hence <code>TGetter m2</code> is added to <code>ComposedMemberInfo</code> instance. The reason for <code>WrongWriteAccessDescription</code> because <code>cud.m2</code> is trying to write to the getter of the same name in <code>D</code>.</p>
+</div>
+<div class="paragraph">
+<p>At the end of this step, two members <code>public TField m2: int</code> and <code>project TGetter m2(): int</code> are added to <code>ComposedMemberInfo</code>.</p>
+</div>
+<div class="paragraph">
+<p>Step 2: Merge members</p>
+</div>
+<div class="paragraph">
+<p>This phase merges members of the same name into a composed member based on the information about these members collected in Step 1. Note that merge rules can become quite complicated as many situations must be considered. Sometimes, it is not possible to merge at all. If the merge is possible, we need to consider the following properties, among others,</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Member kind: what kind of member is the merge result. For instance, what do we get when we merge a field with a setter?</p>
+</li>
+<li>
+<p>Type of merge member: What is the return/parameter type of the merge result?</p>
+</li>
+<li>
+<p>Accessibility: what is the accessibility of the merge result?</p>
+</li>
+<li>
+<p>Optionality/Variadic: Should a parameter of the merge be optional or variadic?</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>The actual merge rules are implemented in the class <code>UnionMemberFactory</code> which delegates to either of the classes <code>UnionMethodFactory</code>, <code>UnionFieldFactory</code>, <code>UnionGetterFactory</code> and <code>UnionSetterFactory</code>.</p>
+</div>
+<div class="paragraph">
+<p>In our example,
+The merge result of <code>public TField m2: int</code> and <code>project TGetter m2(): int</code> are merged into a <code>project TGetter m2: int</code> .</p>
+</div>
+<div class="paragraph">
+<p>Step 3: Construct the scope entry</p>
+</div>
+<div class="paragraph">
+<p>In this final step, the actual IEObjectDescription for <code>m2</code> is constructed. In our example, since there exists one subscope exposing an <code>EObjectDescriptionWithError</code> (here <code>WrongWriteAccessDescription</code>), the final result is an instance of <code>UnionMemberDescriptionWithError</code>. This error instance is recognized during the linking phase and the error message of the subscope regarding <code>WrongWriteAccessDescription</code> is displayed: <em>Union combines fields and getters with name m2 and therefore property m2 is read-only.</em></p>
+</div>
+<div class="paragraph">
+<p>More details can be found in the API documentation in the code. A good starting point is the class <code>ComposedMemberScope</code>.</p>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:Binding_of_Structurally_References_Types"><a class="anchor" href="#sec:Binding_of_Structurally_References_Types"></a><a class="link" href="#sec:Binding_of_Structurally_References_Types">9.9. Structurally References Types</a></h3>
+<div class="paragraph">
+<p>Scoping of structurally referenced types is similar to binding of members. The structural typing modifier basically filters the members of a type. That is, the structural modifier filters out all non-public members, and the field-only modifier only accept fields. Thus, similar to accessibility aware scoping (<a href="#sec:Accessibility_of_types_and_members">Accessibility of types and members</a>), the <code>TypingStrategyAwareMemberScope</code> encapsulates an original scope and applies these additional filters.</p>
+</div>
+<div class="paragraph">
+<p>Bindings to additional members of a structurally referenced type is implemented in <code>MemberScopeProvider.members(ParameterizedTypeRefStructural ..)</code>. Note that the current implementation does not necessarily bind to the type model (TModule) instance, as these members are part of a type reference. That is, usually these bindings refer to the <a href="appendix_d_acronyms.html#AC">AST</a> elements. Thus, it is not possible to compare these members directly, instead, a structural comparison has to be applied.</p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="sec:Building"><a class="anchor" href="#sec:Building"></a><a class="link" href="#sec:Building">9.10. Building</a></h3>
+<div class="sect3">
+<h4 id="sec:Build_Phases"><a class="anchor" href="#sec:Build_Phases"></a><a class="link" href="#sec:Build_Phases">9.10.1. Build Phases</a></h4>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Phase 0
+</td>
+<td class="hdlist2">
+<p>Loading Resources</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Phase 1: prelinking
+</td>
+<td class="hdlist2">
+<p>Create symbols for all resources, includes creation of temporary pre-linked type models</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Phase 2: linking
+</td>
+<td class="hdlist2">
+<p>Resolve all links, includes fully-resolved typed models<br>
+includes compilation</p>
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>That is, not each resource is loaded, pre-linked and linked separately. Instead, all resources are first loaded, then all resources are pre -inked, and only then all resources are linked.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Build_Scenarios"><a class="anchor" href="#sec:Build_Scenarios"></a><a class="link" href="#sec:Build_Scenarios">9.10.2. Build Scenarios</a></h4>
+<div class="paragraph">
+<p>Consequences:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>do not try to set any types in types builder, only create symbols there (probably not even members of types)</p>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Lazy_linking_problem"><a class="anchor" href="#sec:Lazy_linking_problem"></a><a class="link" href="#sec:Lazy_linking_problem">9.10.3. Lazy linking problem</a></h4>
+<div class="paragraph">
+<p>Lazy linking proxies in the indes may trigger reloading of AST (which leads to invalid disconnected type models):</p>
+</div>
+<div class="paragraph">
+<p>Lazy links (ending with |x in which x is an index entry of a temporary list used to resolve the link) must not be written into index.</p>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:Proxies_and_Proxy_Resolution"><a class="anchor" href="#sec:Proxies_and_Proxy_Resolution"></a><a class="link" href="#sec:Proxies_and_Proxy_Resolution">9.11. Proxies and Proxy Resolution (Overview)</a></h3>
+<div class="paragraph">
+<p>Here we give a brief overview of the different kinds of proxies and when / how they are created and resolved.</p>
+</div>
+<div class="sect3">
+<h4 id="xtexts-lazy-linking-proxies"><a class="anchor" href="#xtexts-lazy-linking-proxies"></a><a class="link" href="#xtexts-lazy-linking-proxies">9.11.1. Xtext’s Lazy Linking Proxies</a></h4>
+<div class="ulist">
+<ul>
+<li>
+<p>URI fragment is <code>|</code> <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>n</mi></math> (where <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>n</mi></math> is a non-negative integer).<br>
+<code>platform:/resource/Project/src/A.n4js#|3</code></p>
+</li>
+<li>
+<p>created by Xtext’s <code>LazyLinkingResource</code> in the AST after parsing (they are only ever created in the AST, but the types builder may copy them to the TModule, so they may appear there as well.</p>
+</li>
+<li>
+<p>used to represent cross-references defined in the source code (i.e. name of an identifiable element used in source code to refer to that element).<br></p>
+<div class="paragraph">
+<p>Since the types builder sometimes copies proxies from AST to TModule (e.g. type of an element that was provided with an explicit type declaration in the source code), these proxies may also appear in the TModule, but only between the types builder phase and the end of the post-processing phase (or later, in case they are unresolvable).</p>
+</div>
+</li>
+<li>
+<p>resolution is handled by <code>#getEObject(String)</code> in <code>LazyLinkingResource</code>, which recognizes lazy linking URI fragments and then forwards them to <code>#getEObject(String,Triple)</code>, which in turn relies on the Xtext infrastructure.</p>
+</li>
+<li>
+<p>latest time of resolution: post processing. After post processing has completed, they should all be gone (unless they are unresolvable, e.g. typo in source code).</p>
+</li>
+<li>
+<p>fun facts:</p>
+<div class="ulist">
+<ul>
+<li>
+<p>the number after the pipe character is the index of a <code>Triple</code> stored in field <code>proxyInformation</code> in each <code>LazyLinkingResource</code>.</p>
+</li>
+<li>
+<p>the resource given before the fragment (e.g. <code>A.n4js</code> in the above example) is not the resource the proxy is pointing to (i.e. the resource containing the target EObject), but the resource from where the link originates.</p>
+</li>
+</ul>
+</div>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect3">
+<h4 id="standard-emf-proxies"><a class="anchor" href="#standard-emf-proxies"></a><a class="link" href="#standard-emf-proxies">9.11.2. Standard EMF Proxies</a></h4>
+<div class="ulist">
+<ul>
+<li>
+<p>URI fragment contains a path to an EObject, using reference names and indices:<br>
+<code>platform:/resource/Project/src/A.n4js#/1/@topLevelTypes.1/@ownedMembers.0</code></p>
+</li>
+<li>
+<p>created automatically by EMF</p>
+<div class="ulist">
+<ul>
+<li>
+<p>during deserialization of a TModule <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>M</mi></math> from the Xtext index for all references to a different TModule <math xmlns="http://www.w3.org/1998/Math/MathML"><msup><mi>M</mi><mi>'</mi></msup></math> (see <code>UserdataMapper</code>).</p>
+</li>
+<li>
+<p>when unloading a resource.</p>
+</li>
+<li>
+<p>&#8230;&#8203;</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>used to represent</p>
+<div class="ulist">
+<ul>
+<li>
+<p>cross-references from one TModule to another TModule.</p>
+</li>
+<li>
+<p><code>astElement</code> links from TModule to AST whenever the AST is not present (e.g. resource was loaded from Xtext index).</p>
+</li>
+<li>
+<p><code>definedType</code> links from AST to TModule after deleting the TModule (this happens in the incremental builder after the pre-linking phase).</p>
+</li>
+<li>
+<p>all kinds of links after demand-loading an AST by resolving an <code>astElement</code> link (pathological case).</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>resolution is handled in two ways:</p>
+<div class="ulist">
+<ul>
+<li>
+<p>if the context <code>EObject</code> of the proxy, i.e. the one where the proxified cross-reference originates, is contained in an N4JSResource <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>R</mi></math>, then resolution is handled by <code>N4JSResource#doResolveProxy()</code> (see also <code>ProxyResolvingResource</code> for details).</p>
+<div class="paragraph">
+<p>In this case, special handling is performed to make sure that (a) the target resource is loaded from the index, if possible, and (b) post-processing of the target resource is initiated iff the target resource was loaded from AST (instead from the Xtext index) AND post-processing of resource <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>R</mi></math> is currently in progress or has already been completed.</p>
+</div>
+</li>
+<li>
+<p>otherwise, resolution is handled by standard EMF functionality.</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>latest time of resolution: none. In fact, some of those proxies (those representing <code>astElement</code> links from TModule to AST) must not be resolved at all, because this is not yet properly handled.</p>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_how-is-proxy-resolution-triggered"><a class="anchor" href="#_how-is-proxy-resolution-triggered"></a><a class="link" href="#_how-is-proxy-resolution-triggered">9.11.3. How is Proxy Resolution Triggered?</a></h4>
+<div class="paragraph">
+<p>Resolution of proxies throughout the N4JS implementation is triggered as usually when using EMF, which means: whenever the getter of a EMF cross-reference is invoked and the value is still a proxy, the EMF-generated code of the getter will automatically trigger resolution of this proxy. For details look at the EMF-generated code of the getter of any cross-reference (<code>IdentifierRefImpl#getId()</code> would be a good example).</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_when-is-proxy-resolution-allowed"><a class="anchor" href="#_when-is-proxy-resolution-allowed"></a><a class="link" href="#_when-is-proxy-resolution-allowed">9.11.4. When is Proxy Resolution Allowed?</a></h4>
+<div class="paragraph">
+<p>So, at what time is it legal to trigger such a proxy resolution? Or, more concretely, during which resource load states (<a href="type_index.html#sec:N4JS_Resource_Load_States">N4JS Resource Load States</a>) is it legal to trigger proxy resolution? In fact, asking the question in this way is incorrect or at least not very helpful, because the answer would be (almost) always. The better question is: which components of the system / which parts of the code base are allowed to trigger proxy resolution?</p>
+</div>
+<div class="paragraph">
+<p>For example, triggering resolution is disallowed in the <code>ASTStructureValidator</code> and <code>N4JSTypesBuilder</code>, but for the outside client code such as a JUnit test it is allowed to trigger proxy resolution as early as right after parsing. For an example of the latter see test <code>#testStateFullyProcessed_triggeredOnlyThroughProxyResolution()</code> in <code>N4JSResourceLoadStatesTest</code>.</p>
+</div>
+<div class="paragraph">
+<p>In summary, we can state the rule that the <strong>internal N4JS implementation</strong> must not trigger any proxy resolution until installation of the derived state has completed, i.e. not before resource load state "Fully Initialized", but <strong>client code</strong> may trigger proxy resolution as early as right after parsing, i.e. already in resource load state "Loaded".</p>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div id="footer">
+<div id="footer-text">
+Version 0.9<br>
+Last updated 2019-08-07 15:02:40 CEST
+</div>
+</div>
+<!-- ************* docinfo-footer *************************************************************** -->
+<div class="Grid social" style="color:#d5dfea">
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <h2>Quick Links</h2>
+    <ul>
+      <li><a href="../downloads.html">Download</a></li>
+      <li><a href="../userguides/index.html">Documentation</a></li>
+      <li><a href="https://github.com/eclipse/n4js/">Source</a></li>
+      <li><a href="https://github.com/eclipse/n4js/issues">Issues</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="https://www.eclipse.org/forums/index.php/f/365/">Forum</a></li>
+      <li><a href="http://n4js.blogspot.de/">Blog</a></li>
+      <li><a href="https://dev.eclipse.org/mailman/listinfo/n4js-dev">Mailing List</a></li>
+      <li><a href="https://projects.eclipse.org/projects/technology.n4js">Eclipse Project Page</a></li>
+      <li><a href="https://twitter.com/n4jsdev">Tweets by n4jsdev</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="http://www.eclipse.org/">Eclipse Home</a></li>
+      <li><a href="http://www.eclipse.org/legal/privacy.php">Privacy Policy</a></li>
+      <li><a href="http://www.eclipse.org/legal/termsofuse.php">Terms of Use</a></li>
+      <li><a href="http://www.eclipse.org/legal/copyright.php">Copyright Agent</a></li>
+      <li><a href="http://www.eclipse.org/legal/">Legal</a></li>
+    </ul>
+  </div>
+  <div style="clear: both; height: 0; overflow: hidden;"></div>
+</div>
+
+<!-- ************* UI Scripts ************* -->
+<script type="text/javascript" src="scripts/back-to-top.js"></script>
+
+<script type="text/javascript" src="scripts/treeview.js"></script>
+<script type="text/javascript" src="scripts/toc.js"></script>
+
+<!-- ************* Prism.js Syntax Highlighting ************* -->
+<script src="scripts/prism.js"></script>
+
+<script type="text/javascript">
+	// Add the 'toclist' id for search function
+	$(".toc2 > ul").attr('id', 'toclist');
+	// Generate a Search input form
+	$("#toclist > li:first-of-type").before('<input type="text" id="pagesearch" onkeyup="search()" placeholder="Search for section...">');
+	$("#toclist > li:first-of-type").before('<i id="clear" class="fa fa-times-circle-o"></i>');
+	$("#clear").click(function(){
+	    $("#pagesearch").val('');
+	    search();
+	    $('.toc2 > ul').treeView('collapseAll');
+	});
+	// intialize Treeview.js
+	$(".toc2 > ul").treeView();
+	// Initialize Scrollspy
+</script>
+<!-- ************* docinfo-footer *************************************************************** -->
+</body>
+</html>
\ No newline at end of file
diff --git a/design/chapters/03_releng/images/eclipse-help-process.svg b/design/chapters/03_releng/images/eclipse-help-process.svg
new file mode 100644
index 0000000..60a5cff
--- /dev/null
+++ b/design/chapters/03_releng/images/eclipse-help-process.svg
@@ -0,0 +1,312 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xl="http://www.w3.org/1999/xlink" xmlns:dc="http://purl.org/dc/elements/1.1/" viewBox="3 -15 1216 274" width="1216" height="274">
+  <defs>
+    <font-face font-family="Helvetica" font-size="12" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="12" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="532.22656" cap-height="719.7266" ascent="770.0195" descent="-229.98047" font-weight="700">
+      <font-face-src>
+        <font-face-name name="Helvetica-Bold"/>
+      </font-face-src>
+    </font-face>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="StickArrow_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -4 10 8" markerWidth="10" markerHeight="8" color="black">
+      <g>
+        <path d="M 8 0 L 0 0 M 0 -3 L 8 0 L 0 3" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <font-face font-family="Helvetica" font-size="9" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+  </defs>
+  <metadata> Produced by OmniGraffle 7.11 
+    <dc:date>2019-08-06 11:44:23 +0000</dc:date>
+  </metadata>
+  <g id="Canvas_1" stroke="none" stroke-opacity="1" stroke-dasharray="none" fill="none" fill-opacity="1">
+    <title>Canvas 1</title>
+    <rect fill="white" x="3" y="-15" width="1216" height="274"/>
+    <g id="Canvas_1: Layer 1">
+      <title>Layer 1</title>
+      <g id="Graphic_57">
+        <circle cx="12.6875" cy="43.5" r="9.00001438111707" fill="black"/>
+        <circle cx="12.6875" cy="43.5" r="9.00001438111707" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_58">
+        <path d="M 197.3125 22.5 L 315.3125 22.5 C 318.07392 22.5 320.3125 24.738576 320.3125 27.5 L 320.3125 59.5 C 320.3125 62.261424 318.07392 64.5 315.3125 64.5 L 197.3125 64.5 C 194.55108 64.5 192.3125 62.261424 192.3125 59.5 L 192.3125 27.5 C 192.3125 24.738576 194.55108 22.5 197.3125 22.5 Z" fill="white"/>
+        <path d="M 197.3125 22.5 L 315.3125 22.5 C 318.07392 22.5 320.3125 24.738576 320.3125 27.5 L 320.3125 59.5 C 320.3125 62.261424 318.07392 64.5 315.3125 64.5 L 197.3125 64.5 C 194.55108 64.5 192.3125 62.261424 192.3125 59.5 L 192.3125 27.5 C 192.3125 24.738576 194.55108 22.5 197.3125 22.5 Z" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(197.3125 29.5)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="33.658203" y="11">Asciispec</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="2.9726562" y="25">-a eclipse-help-mode</tspan>
+        </text>
+      </g>
+      <g id="Graphic_59">
+        <rect x="353.5" y="-8" width="99" height="30" fill="white"/>
+        <rect x="353.5" y="-8" width="99" height="30" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(358.5 0)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x=".8183594" y="11">N4JSSpec.html</tspan>
+        </text>
+      </g>
+      <g id="Graphic_60">
+        <rect x="54.875" y="28.5" width="104.25" height="30" fill="white"/>
+        <rect x="54.875" y="28.5" width="104.25" height="30" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(59.875 36.5)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="2.1044922" y="11">N4JSSpec.adoc</tspan>
+        </text>
+      </g>
+      <g id="Graphic_62">
+        <rect x="353.5" y="63.5" width="99" height="30" fill="white"/>
+        <rect x="353.5" y="63.5" width="99" height="30" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(358.5 71.5)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="3.1445312" y="11">N4JSSpec.xml</tspan>
+        </text>
+      </g>
+      <g id="Graphic_63">
+        <path d="M 490.6875 -14 L 608.6875 -14 C 611.4489 -14 613.6875 -11.761424 613.6875 -9 L 613.6875 23 C 613.6875 25.761424 611.4489 28 608.6875 28 L 490.6875 28 C 487.9261 28 485.6875 25.761424 485.6875 23 L 485.6875 -9 C 485.6875 -11.761424 487.9261 -14 490.6875 -14 Z" fill="white"/>
+        <path d="M 490.6875 -14 L 608.6875 -14 C 611.4489 -14 613.6875 -11.761424 613.6875 -9 L 613.6875 23 C 613.6875 25.761424 611.4489 28 608.6875 28 L 490.6875 28 C 487.9261 28 485.6875 25.761424 485.6875 23 L 485.6875 -9 C 485.6875 -11.761424 487.9261 -14 490.6875 -14 Z" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(490.6875 0)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="36.32129" y="11">Chunker</tspan>
+        </text>
+      </g>
+      <g id="Group_67">
+        <g id="Graphic_64">
+          <rect x="652.5" y="5.3703926" width="99" height="30" fill="white"/>
+          <rect x="652.5" y="5.3703926" width="99" height="30" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(657.5 13.370393)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="8.822266" y="11">chapter.html</tspan>
+          </text>
+        </g>
+        <g id="Graphic_65">
+          <rect x="660.5" y="-1.694411" width="99" height="30" fill="white"/>
+          <rect x="660.5" y="-1.694411" width="99" height="30" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(665.5 6.305589)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="8.822266" y="11">chapter.html</tspan>
+          </text>
+        </g>
+        <g id="Graphic_66">
+          <rect x="667.25" y="-8" width="99" height="30" fill="white"/>
+          <rect x="667.25" y="-8" width="99" height="30" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(672.25 0)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="8.822266" y="11">chapter.html</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Graphic_68">
+        <path d="M 490.6875 57.5 L 608.6875 57.5 C 611.4489 57.5 613.6875 59.738576 613.6875 62.5 L 613.6875 94.5 C 613.6875 97.26142 611.4489 99.5 608.6875 99.5 L 490.6875 99.5 C 487.9261 99.5 485.6875 97.26142 485.6875 94.5 L 485.6875 62.5 C 485.6875 59.738576 487.9261 57.5 490.6875 57.5 Z" fill="white"/>
+        <path d="M 490.6875 57.5 L 608.6875 57.5 C 611.4489 57.5 613.6875 59.738576 613.6875 62.5 L 613.6875 94.5 C 613.6875 97.26142 611.4489 99.5 608.6875 99.5 L 490.6875 99.5 C 487.9261 99.5 485.6875 97.26142 485.6875 94.5 L 485.6875 62.5 C 485.6875 59.738576 487.9261 57.5 490.6875 57.5 Z" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(490.6875 64.5)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="27.31836" y="11">EclipseHelp</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="19.425781" y="25">TOCGenerator</tspan>
+        </text>
+      </g>
+      <g id="Graphic_69">
+        <rect x="646.875" y="63.5" width="135.8334" height="30" fill="white"/>
+        <rect x="646.875" y="63.5" width="135.8334" height="30" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(651.875 64.5)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="33.56709" y="11">N4JSSpec</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="17.33955" y="25">EclipseTOC.xml</tspan>
+        </text>
+      </g>
+      <g id="Line_70">
+        <line x1="714.7917" y1="63.5" x2="716.2834" y2="31.888996" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_71">
+        <rect x="695.47546" y="37.03551" width="54.532227" height="13" fill="white" fill-opacity=".491747"/>
+        <text transform="translate(696.47546 38.03551)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="0" y="9">«references»</tspan>
+        </text>
+      </g>
+      <g id="Group_72">
+        <g id="Graphic_74">
+          <circle cx="852.854" cy="43.5" r="9.00001438111708" fill="white"/>
+          <circle cx="852.854" cy="43.5" r="9.00001438111708" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_73">
+          <circle cx="852.854" cy="43.5" r="6.30001006678193" fill="black"/>
+          <circle cx="852.854" cy="43.5" r="6.30001006678193" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+      </g>
+      <g id="Line_75">
+        <line x1="21.687505" y1="43.5" x2="44.975" y2="43.5" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_76">
+        <line x1="159.125" y1="43.5" x2="182.4125" y2="43.5" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_77">
+        <line x1="320.3125" y1="33" x2="345.7068" y2="13.105408" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_78">
+        <line x1="320.3125" y1="54" x2="345.53523" y2="72.62017" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_79">
+        <line x1="452.5" y1="7" x2="475.7875" y2="7" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_80">
+        <line x1="613.6875" y1="7" x2="657.35" y2="7" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_81">
+        <line x1="452.5" y1="78.5" x2="475.7875" y2="78.5" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_82">
+        <line x1="613.6875" y1="78.5" x2="636.975" y2="78.5" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_83">
+        <line x1="782.7084" y1="78.5" x2="834.9955" y2="52.41072" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_84">
+        <line x1="766.25" y1="7" x2="834.7311" y2="35.86196" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_86">
+        <circle cx="12.6875" cy="201.7669" r="9.00001438111707" fill="black"/>
+        <circle cx="12.6875" cy="201.7669" r="9.00001438111707" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_87">
+        <path d="M 197.3125 180.7669 L 315.3125 180.7669 C 318.07392 180.7669 320.3125 183.00547 320.3125 185.7669 L 320.3125 217.7669 C 320.3125 220.52832 318.07392 222.7669 315.3125 222.7669 L 197.3125 222.7669 C 194.55108 222.7669 192.3125 220.52832 192.3125 217.7669 L 192.3125 185.7669 C 192.3125 183.00547 194.55108 180.7669 197.3125 180.7669 Z" fill="white"/>
+        <path d="M 197.3125 180.7669 L 315.3125 180.7669 C 318.07392 180.7669 320.3125 183.00547 320.3125 185.7669 L 320.3125 217.7669 C 320.3125 220.52832 318.07392 222.7669 315.3125 222.7669 L 197.3125 222.7669 C 194.55108 222.7669 192.3125 220.52832 192.3125 217.7669 L 192.3125 185.7669 C 192.3125 183.00547 194.55108 180.7669 197.3125 180.7669 Z" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(197.3125 194.7669)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x=".3125" y="11">Asciispec (web mode)</tspan>
+        </text>
+      </g>
+      <g id="Graphic_88">
+        <rect x="356.65625" y="215" width="99" height="30" fill="white"/>
+        <rect x="356.65625" y="215" width="99" height="30" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(361.65625 223)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x=".8183594" y="11">N4JSSpec.html</tspan>
+        </text>
+      </g>
+      <g id="Graphic_89">
+        <rect x="54.875" y="186.7669" width="104.25" height="30" fill="white"/>
+        <rect x="54.875" y="186.7669" width="104.25" height="30" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(59.875 194.7669)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="2.1044922" y="11">N4JSSpec.adoc</tspan>
+        </text>
+      </g>
+      <g id="Graphic_90">
+        <rect x="353.5" y="157.5" width="99" height="30" fill="white"/>
+        <rect x="353.5" y="157.5" width="99" height="30" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(358.5 165.5)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="3.1445312" y="11">N4JSSpec.xml</tspan>
+        </text>
+      </g>
+      <g id="Graphic_91">
+        <path d="M 842.5 180.7669 L 960.5 180.7669 C 963.2614 180.7669 965.5 183.00547 965.5 185.7669 L 965.5 217.7669 C 965.5 220.52832 963.2614 222.7669 960.5 222.7669 L 842.5 222.7669 C 839.7386 222.7669 837.5 220.52832 837.5 217.7669 L 837.5 185.7669 C 837.5 183.00547 839.7386 180.7669 842.5 180.7669 Z" fill="white"/>
+        <path d="M 842.5 180.7669 L 960.5 180.7669 C 963.2614 180.7669 965.5 183.00547 965.5 185.7669 L 965.5 217.7669 C 965.5 220.52832 963.2614 222.7669 960.5 222.7669 L 842.5 222.7669 C 839.7386 222.7669 837.5 220.52832 837.5 217.7669 L 837.5 185.7669 C 837.5 183.00547 839.7386 180.7669 842.5 180.7669 Z" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(842.5 194.7669)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="36.32129" y="11">Chunker</tspan>
+        </text>
+      </g>
+      <g id="Group_92">
+        <g id="Graphic_95">
+          <rect x="1019.7167" y="228.3704" width="99" height="30" fill="white"/>
+          <rect x="1019.7167" y="228.3704" width="99" height="30" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(1024.7167 236.3704)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="8.822266" y="11">chapter.html</tspan>
+          </text>
+        </g>
+        <g id="Graphic_94">
+          <rect x="1027.7167" y="221.3056" width="99" height="30" fill="white"/>
+          <rect x="1027.7167" y="221.3056" width="99" height="30" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(1032.7167 229.3056)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="8.822266" y="11">chapter.html</tspan>
+          </text>
+        </g>
+        <g id="Graphic_93">
+          <rect x="1034.4667" y="215" width="99" height="30" fill="white"/>
+          <rect x="1034.4667" y="215" width="99" height="30" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(1039.4667 223)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="8.822266" y="11">chapter.html</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Graphic_96">
+        <path d="M 499.14575 151.5 L 617.14575 151.5 C 619.9072 151.5 622.14575 153.73858 622.14575 156.5 L 622.14575 188.5 C 622.14575 191.26142 619.9072 193.5 617.14575 193.5 L 499.14575 193.5 C 496.3843 193.5 494.14575 191.26142 494.14575 188.5 L 494.14575 156.5 C 494.14575 153.73858 496.3843 151.5 499.14575 151.5 Z" fill="white"/>
+        <path d="M 499.14575 151.5 L 617.14575 151.5 C 619.9072 151.5 622.14575 153.73858 622.14575 156.5 L 622.14575 188.5 C 622.14575 191.26142 619.9072 193.5 617.14575 193.5 L 499.14575 193.5 C 496.3843 193.5 494.14575 191.26142 494.14575 188.5 L 494.14575 156.5 C 494.14575 153.73858 496.3843 151.5 499.14575 151.5 Z" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(499.14575 158.5)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="44.322266" y="11">Index</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="19.425781" y="25">TOCGenerator</tspan>
+        </text>
+      </g>
+      <g id="Graphic_97">
+        <rect x="654.8249" y="157.5" width="135.8334" height="30" fill="white"/>
+        <rect x="654.8249" y="157.5" width="135.8334" height="30" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(659.8249 165.5)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="39.584667" y="11">toc.html</tspan>
+        </text>
+      </g>
+      <g id="Line_98">
+        <path d="M 1051.8417 157.5 C 1016.1752 143.00145 994.0168 114 944.8314 114 C 898.1365 114 827.0557 140.13884 766.3238 155.1917" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_99">
+        <rect x="894.8727" y="116.91431" width="45.03125" height="13" fill="white" fill-opacity=".491747"/>
+        <text transform="translate(895.8727 117.91431)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="0" y="9">«includes»</tspan>
+        </text>
+      </g>
+      <g id="Group_100">
+        <g id="Graphic_102">
+          <circle cx="1209.2841" cy="195.7669" r="9.00001438111714" fill="white"/>
+          <circle cx="1209.2841" cy="195.7669" r="9.00001438111714" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_101">
+          <circle cx="1209.2841" cy="195.7669" r="6.30001006678191" fill="black"/>
+          <circle cx="1209.2841" cy="195.7669" r="6.30001006678191" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+      </g>
+      <g id="Line_103">
+        <line x1="21.687505" y1="201.7669" x2="44.975" y2="201.7669" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_104">
+        <line x1="159.125" y1="201.7669" x2="182.4125" y2="201.7669" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_105">
+        <line x1="320.3125" y1="212.2669" x2="347.75887" y2="225.65873" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_106">
+        <line x1="320.3125" y1="191.2669" x2="344.8824" y2="177.37309" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_107">
+        <line x1="455.65625" y1="230" x2="827.627" y2="202.4969" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_108">
+        <line x1="965.5" y1="212.2669" x2="1024.674" y2="221.04697" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_109">
+        <line x1="452.5" y1="172.5" x2="484.24575" y2="172.5" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_110">
+        <line x1="622.14575" y1="172.5" x2="644.9249" y2="172.5" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_111">
+        <line x1="790.6583" y1="172.5" x2="828.3101" y2="187.58502" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_112">
+        <line x1="1133.4667" y1="230" x2="1191.2612" y2="203.9046" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_116">
+        <rect x="1027.0917" y="157.5" width="99" height="30" fill="white"/>
+        <rect x="1027.0917" y="157.5" width="99" height="30" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(1032.0917 165.5)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="14.49707" y="11">index.html</tspan>
+        </text>
+      </g>
+      <g id="Line_117">
+        <path d="M 790.6583 165 C 823.9606 159.0006 845.82 138.6675 890.5753 147 C 932.9267 154.88495 995.8046 188.44337 1050.0658 211.2306" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_118">
+        <rect x="890.2991" y="155.19397" width="54.532227" height="13" fill="white" fill-opacity=".491747"/>
+        <text transform="translate(891.2991 156.19397)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="0" y="9">«references»</tspan>
+        </text>
+      </g>
+      <g id="Line_119">
+        <line x1="965.5" y1="191.2669" x2="1017.3533" y2="181.78143" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_120">
+        <line x1="1126.0917" y1="180" x2="1190.5573" y2="192.21772" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+    </g>
+  </g>
+</svg>
diff --git a/design/chapters/05_parser/images/ad_parsing_simplified.svg b/design/chapters/05_parser/images/ad_parsing_simplified.svg
new file mode 100644
index 0000000..d6bbac1
--- /dev/null
+++ b/design/chapters/05_parser/images/ad_parsing_simplified.svg
@@ -0,0 +1,105 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xl="http://www.w3.org/1999/xlink" xmlns:dc="http://purl.org/dc/elements/1.1/" viewBox="-26.5 -67 777.8766 36.49946" width="777.8766" height="36.49946">
+  <defs>
+    <font-face font-family="Helvetica" font-size="12" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="StickArrow_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -4 10 8" markerWidth="10" markerHeight="8" color="black">
+      <g>
+        <path d="M 8 0 L 0 0 M 0 -3 L 8 0 L 0 3" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+  </defs>
+  <metadata> Produced by OmniGraffle 7.11 
+    <dc:date>2019-08-02 08:32:58 +0000</dc:date>
+  </metadata>
+  <g id="Canvas_1" stroke="none" stroke-opacity="1" stroke-dasharray="none" fill="none" fill-opacity="1">
+    <title>Canvas 1</title>
+    <rect fill="white" x="-26.5" y="-67" width="777.8766" height="36.49946"/>
+    <g id="Canvas_1: Layer 1">
+      <title>Layer 1</title>
+      <g id="Graphic_10">
+        <rect x="138.55175" y="-66.5" width="87.21061" height="33.12542" fill="#d2e6f1"/>
+        <rect x="138.55175" y="-66.5" width="87.21061" height="33.12542" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(143.55175 -56.93729)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="6.261555" y="11">CharStream</tspan>
+        </text>
+      </g>
+      <g id="Graphic_9">
+        <rect x="372.3141" y="-66.5" width="87.21061" height="35.499462" fill="#d2e6f1"/>
+        <rect x="372.3141" y="-66.5" width="87.21061" height="35.499462" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(377.3141 -55.75027)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="3.2556953" y="11">TokenStream</tspan>
+        </text>
+      </g>
+      <g id="Graphic_8">
+        <rect x="606.0765" y="-66.5" width="103.02425" height="33.12542" fill="#d2e6f1"/>
+        <rect x="606.0765" y="-66.5" width="103.02425" height="33.12542" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(611.0765 -56.93729)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="3.492592" y="11">Semantic Model</tspan>
+        </text>
+      </g>
+      <g id="Line_7">
+        <line x1="115.27588" y1="-49.93729" x2="128.15175" y2="-49.93729" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_6">
+        <line x1="226.26236" y1="-49.93729" x2="239.13824" y2="-49.93729" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_5">
+        <line x1="460.02465" y1="-49.52725" x2="473.40213" y2="-49.762914" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_16">
+        <circle cx="-17" cy="-49.93729" r="9.00001438111706" fill="black"/>
+        <circle cx="-17" cy="-49.93729" r="9.00001438111706" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_18">
+        <path d="M 20.775876 -63.43729 L 109.77588 -63.43729 C 112.5373 -63.43729 114.77588 -61.198714 114.77588 -58.43729 L 114.77588 -41.43729 C 114.77588 -38.675866 112.5373 -36.43729 109.77588 -36.43729 L 20.775876 -36.43729 C 18.014452 -36.43729 15.775876 -38.675866 15.775876 -41.43729 L 15.775876 -58.43729 C 15.775876 -61.198714 18.014452 -63.43729 20.775876 -63.43729 Z" fill="white"/>
+        <path d="M 20.775876 -63.43729 L 109.77588 -63.43729 C 112.5373 -63.43729 114.77588 -61.198714 114.77588 -58.43729 L 114.77588 -41.43729 C 114.77588 -38.675866 112.5373 -36.43729 109.77588 -36.43729 L 20.775876 -36.43729 C 18.014452 -36.43729 15.775876 -38.675866 15.775876 -41.43729 L 15.775876 -58.43729 C 15.775876 -61.198714 18.014452 -63.43729 20.775876 -63.43729 Z" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(20.775876 -56.93729)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="23.154297" y="11">read file</tspan>
+        </text>
+      </g>
+      <g id="Graphic_19">
+        <path d="M 254.53824 -63.43729 L 343.53824 -63.43729 C 346.29966 -63.43729 348.53824 -61.198714 348.53824 -58.43729 L 348.53824 -41.43729 C 348.53824 -38.675866 346.29966 -36.43729 343.53824 -36.43729 L 254.53824 -36.43729 C 251.7768 -36.43729 249.53824 -38.675866 249.53824 -41.43729 L 249.53824 -58.43729 C 249.53824 -61.198714 251.7768 -63.43729 254.53824 -63.43729 Z" fill="white"/>
+        <path d="M 254.53824 -63.43729 L 343.53824 -63.43729 C 346.29966 -63.43729 348.53824 -61.198714 348.53824 -58.43729 L 348.53824 -41.43729 C 348.53824 -38.675866 346.29966 -36.43729 343.53824 -36.43729 L 254.53824 -36.43729 C 251.7768 -36.43729 249.53824 -38.675866 249.53824 -41.43729 L 249.53824 -58.43729 C 249.53824 -61.198714 251.7768 -63.43729 254.53824 -63.43729 Z" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(254.53824 -63.93729)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="22.152344" y="11">tokenize</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="25.495117" y="25">(Lexer)</tspan>
+        </text>
+      </g>
+      <g id="Graphic_20">
+        <path d="M 488.3006 -63.43729 L 577.3006 -63.43729 C 580.062 -63.43729 582.3006 -61.198714 582.3006 -58.43729 L 582.3006 -41.43729 C 582.3006 -38.675866 580.062 -36.43729 577.3006 -36.43729 L 488.3006 -36.43729 C 485.5392 -36.43729 483.3006 -38.675866 483.3006 -41.43729 L 483.3006 -58.43729 C 483.3006 -61.198714 485.5392 -63.43729 488.3006 -63.43729 Z" fill="white"/>
+        <path d="M 488.3006 -63.43729 L 577.3006 -63.43729 C 580.062 -63.43729 582.3006 -61.198714 582.3006 -58.43729 L 582.3006 -41.43729 C 582.3006 -38.675866 580.062 -36.43729 577.3006 -36.43729 L 488.3006 -36.43729 C 485.5392 -36.43729 483.3006 -38.675866 483.3006 -41.43729 L 483.3006 -58.43729 C 483.3006 -61.198714 485.5392 -63.43729 488.3006 -63.43729 Z" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(488.3006 -63.93729)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="29.49121" y="11">parse</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="22.83203" y="25">(Parser)</tspan>
+        </text>
+      </g>
+      <g id="Line_21">
+        <line x1="348.53824" y1="-49.93729" x2="361.91573" y2="-49.701625" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_22">
+        <line x1="582.8006" y1="-49.93729" x2="595.6765" y2="-49.93729" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Group_23">
+        <g id="Graphic_25">
+          <circle cx="741.8766" cy="-49.93729" r="9.00001438111708" fill="white"/>
+          <circle cx="741.8766" cy="-49.93729" r="9.00001438111708" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_24">
+          <circle cx="741.8766" cy="-49.93729" r="6.30001006678197" fill="black"/>
+          <circle cx="741.8766" cy="-49.93729" r="6.30001006678197" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+      </g>
+      <g id="Line_26">
+        <line x1="709.6007" y1="-49.93729" x2="722.9766" y2="-49.93729" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_27">
+        <line x1="-7.4999955" y1="-49.93729" x2="5.875876" y2="-49.93729" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+    </g>
+  </g>
+</svg>
diff --git a/design/chapters/05_parser/images/cd_ASIParser.svg b/design/chapters/05_parser/images/cd_ASIParser.svg
new file mode 100644
index 0000000..100aeb4
--- /dev/null
+++ b/design/chapters/05_parser/images/cd_ASIParser.svg
@@ -0,0 +1,417 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xl="http://www.w3.org/1999/xlink" xmlns:dc="http://purl.org/dc/elements/1.1/" viewBox="6.5 109.5 1141.5 615" width="1141.5" height="615">
+  <defs>
+    <font-face font-family="Helvetica" font-size="12" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="9" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="10" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="532.22656" cap-height="719.7266" ascent="770.0195" descent="-229.98047" font-weight="700">
+      <font-face-src>
+        <font-face-name name="Helvetica-Bold"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="7" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="StickArrow_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -4 10 8" markerWidth="10" markerHeight="8" color="black">
+      <g>
+        <path d="M 8 0 L 0 0 M 0 -3 L 8 0 L 0 3" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <font-face font-family="Helvetica" font-size="11" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="12" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="532.22656" cap-height="719.7266" ascent="770.0195" descent="-229.98047" font-weight="700">
+      <font-face-src>
+        <font-face-name name="Helvetica-Bold"/>
+      </font-face-src>
+    </font-face>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="UMLInheritance_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -8 14 16" markerWidth="14" markerHeight="16" color="black">
+      <g>
+        <path d="M 12 0 L 0 -7 L 0 7 Z" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="StickArrow_Marker_2" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -4 10 8" markerWidth="10" markerHeight="8" color="#3d61c2">
+      <g>
+        <path d="M 8 0 L 0 0 M 0 -3 L 8 0 L 0 3" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <font-face font-family="Helvetica" font-size="10" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+  </defs>
+  <metadata> Produced by OmniGraffle 7.11 
+    <dc:date>2013-10-14 16:13:30 +0000</dc:date>
+  </metadata>
+  <g id="Canvas_1" stroke="none" stroke-opacity="1" stroke-dasharray="none" fill="none" fill-opacity="1">
+    <title>Canvas 1</title>
+    <rect fill="white" x="6.5" y="109.5" width="1141.5" height="615"/>
+    <g id="Canvas_1: Layer 1">
+      <title>Layer 1</title>
+      <g id="Graphic_163">
+        <rect x="7" y="110" width="627" height="200" fill="white"/>
+        <rect x="7" y="110" width="627" height="200" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(12 291)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="364.20312" y="11">parser/lexer communication because of reg exp </tspan>
+        </text>
+      </g>
+      <g id="Graphic_257">
+        <path d="M 543 568.8663 C 543 563.4667 541.0442 562.79865 526.7576 557.4549 L 526.6067 557.3996 C 512.24466 552 512.0953 552 497.35594 552 C 477.7302 552 389 552 389 552 L 389 609 L 543 609 L 543 568.8663 Z" fill="white"/>
+        <path d="M 543 568.8663 C 543 563.4667 541.0442 562.79865 526.7576 557.4549 L 526.6067 557.3996 C 512.24466 552 512.0953 552 497.35594 552 C 477.7302 552 389 552 389 552 L 389 609 L 543 609 L 543 568.8663 Z M 543 568.58814 C 543 563.4667 542.8491 563.4667 512.0953 563.4667 L 512.0953 563.4667 C 512.0953 552.05586 512.0953 552 498.2584 552" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(394 557)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="0" y="9">package</tspan>
+          <tspan font-family="Helvetica" font-size="10" font-weight="700" fill="black" x="0" y="21">org.eclipse.n4js.parser</tspan>
+          <tspan font-family="Helvetica" font-size="7" font-weight="400" fill="black" x="0" y="29">Scopes shown: protected, public, </tspan>
+          <tspan font-family="Helvetica" font-size="7" font-weight="400" fill="black" x="0" y="37">Omitted methods: getter and setter, </tspan>
+          <tspan font-family="Helvetica" font-size="7" font-weight="400" fill="black" x="0" y="45">created on Oct 14, 2013</tspan>
+        </text>
+      </g>
+      <g id="Line_256">
+        <line x1="394.2891" y1="322.5" x2="435.8766" y2="291.20295" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_255">
+        <line x1="332.5" y1="322.5" x2="332.5" y2="243.9" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_254">
+        <line x1="238.5" y1="366.07556" x2="217.8952" y2="365.4345" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_253">
+        <line x1="107.5" y1="329" x2="107.5" y2="257.9" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_252">
+        <line x1="148.63573" y1="329" x2="268.77778" y2="232.61938" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_251">
+        <line x1="388.5" y1="174.29208" x2="433.681" y2="168.4767" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Group_247">
+        <g id="Graphic_250">
+          <rect x="238.5" y="374.5" width="188" height="41" fill="white"/>
+          <rect x="238.5" y="374.5" width="188" height="41" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(243.5 375.5)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">#createParser(..)</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="23">+doParse(..)</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="36">#createTokenStream(..)</tspan>
+          </text>
+        </g>
+        <g id="Graphic_249">
+          <rect x="238.5" y="360.5" width="188" height="14" fill="white"/>
+          <rect x="238.5" y="360.5" width="188" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_248">
+          <rect x="238.5" y="322.5" width="188" height="38" fill="white"/>
+          <rect x="238.5" y="322.5" width="188" height="38" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(243.80078 327.5)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="49.01367" y="11">«bindIParser»</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="0" y="25">N4JSSemicolonInjectingParser</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_240">
+        <g id="Graphic_243">
+          <rect x="21" y="696" width="202" height="28" fill="white"/>
+          <rect x="21" y="696" width="202" height="28" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(26 697)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">#isActionNode(..)</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="23">#isInvalidRootNode(..)</tspan>
+          </text>
+        </g>
+        <g id="Graphic_242">
+          <rect x="21" y="682" width="202" height="14" fill="white"/>
+          <rect x="21" y="682" width="202" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_241">
+          <rect x="21" y="644" width="202" height="38" fill="white"/>
+          <rect x="21" y="644" width="202" height="38" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(26.407227 649)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="18.890625" y="11">«bindIPartialParserHelper»</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="0" y="25">ActionAwarePartialParsingHelper</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_233">
+        <g id="Graphic_236">
+          <rect x="7" y="367" width="201" height="28" fill="white"/>
+          <rect x="7" y="367" width="201" height="28" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(12 368)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">#setInRegularExpression()</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="23">+recover(..)</tspan>
+          </text>
+        </g>
+        <g id="Graphic_235">
+          <rect x="7" y="353" width="201" height="14" fill="white"/>
+          <rect x="7" y="353" width="201" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_234">
+          <rect x="7" y="329" width="201" height="24" fill="white"/>
+          <rect x="7" y="329" width="201" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(12.138672 334)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="0" y="11">InternalSemicolonInjectingParser</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_226">
+        <g id="Graphic_229">
+          <rect x="443.5" y="167" width="81" height="28" fill="white"/>
+          <rect x="443.5" y="167" width="81" height="28" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(448.5 168)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">+add(..)</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="23">+clear()</tspan>
+          </text>
+        </g>
+        <g id="Graphic_228">
+          <rect x="443.5" y="153" width="81" height="14" fill="white"/>
+          <rect x="443.5" y="153" width="81" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_227">
+          <rect x="443.5" y="129" width="81" height="24" fill="white"/>
+          <rect x="443.5" y="129" width="81" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(448.7676 134)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="0" y="11">JSTokenList</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_219">
+        <g id="Graphic_222">
+          <rect x="402" y="270.25" width="154" height="15" fill="white"/>
+          <rect x="402" y="270.25" width="154" height="15" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(407 271.25)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">+toString()</tspan>
+          </text>
+        </g>
+        <g id="Graphic_221">
+          <rect x="402" y="256.25" width="154" height="14" fill="white"/>
+          <rect x="402" y="256.25" width="154" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_220">
+          <rect x="402" y="232.25" width="154" height="24" fill="white"/>
+          <rect x="402" y="232.25" width="154" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(407.49805 237.25)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="0" y="11">AntlrStreamWithToString</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_212">
+        <g id="Graphic_215">
+          <rect x="21" y="594" width="254" height="15" fill="white"/>
+          <rect x="21" y="594" width="254" height="15" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(26 595)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">+set(..)</tspan>
+          </text>
+        </g>
+        <g id="Graphic_214">
+          <rect x="21" y="580" width="254" height="14" fill="white"/>
+          <rect x="21" y="580" width="254" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_213">
+          <rect x="21" y="542" width="254" height="38" fill="white"/>
+          <rect x="21" y="542" width="254" height="38" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(26.069336 547)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="69.58594" y="11">«bindIAstFactory»</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="0" y="25">PropertyAssignmentAwareElementFactory</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_205">
+        <g id="Graphic_208">
+          <rect x="908.5" y="451.5" width="239" height="15" fill="white"/>
+          <rect x="908.5" y="451.5" width="239" height="15" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(913.5 452.5)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">+getSyntaxErrorMessage(..)</tspan>
+          </text>
+        </g>
+        <g id="Graphic_207">
+          <rect x="908.5" y="437.5" width="239" height="14" fill="white"/>
+          <rect x="908.5" y="437.5" width="239" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_206">
+          <rect x="908.5" y="413.5" width="239" height="24" fill="white"/>
+          <rect x="908.5" y="413.5" width="239" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(913.7217 418.5)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="0" y="11">BadEscapementAwareMessageProvider</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_198">
+        <g id="Graphic_201">
+          <rect x="276.5" y="167" width="112" height="67" fill="white"/>
+          <rect x="276.5" y="167" width="112" height="67" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(281.5 168)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">+toString()</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="23">#fillBuffer()</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="36">#fillBuffer(..)</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="49">+LT(..)</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="62">+toString(..)</tspan>
+          </text>
+        </g>
+        <g id="Graphic_200">
+          <rect x="276.5" y="153" width="112" height="14" fill="white"/>
+          <rect x="276.5" y="153" width="112" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_199">
+          <rect x="276.5" y="129" width="112" height="24" fill="white"/>
+          <rect x="276.5" y="129" width="112" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(281.59082 134)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="0" y="11">LazyTokenStream</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_191">
+        <g id="Graphic_194">
+          <rect x="21" y="181" width="173" height="67" fill="white"/>
+          <rect x="21" y="181" width="173" height="67" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(26 182)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">+reset()</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="23">#setInRegularExpression()</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="36">+setCharStream(..)</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="49">+nextToken()</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="62">+toString()</tspan>
+          </text>
+        </g>
+        <g id="Graphic_193">
+          <rect x="21" y="167" width="173" height="14" fill="white"/>
+          <rect x="21" y="167" width="173" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_192">
+          <rect x="21" y="129" width="173" height="38" fill="white"/>
+          <rect x="21" y="129" width="173" height="38" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(26.464844 134)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="0" y="11">«provideInternalN4JSLexer»</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="10.441406" y="25">RegExLiteralAwareLexer</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_76">
+        <g id="Graphic_79">
+          <rect x="295" y="485" width="78" height="14" fill="white"/>
+          <rect x="295" y="485" width="78" height="14" stroke="#3d61c2" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_78">
+          <rect x="295" y="471" width="78" height="14" fill="white"/>
+          <rect x="295" y="471" width="78" height="14" stroke="#3d61c2" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_77">
+          <rect x="295" y="447" width="78" height="24" fill="white"/>
+          <rect x="295" y="447" width="78" height="24" stroke="#3d61c2" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(300.3086 452)" fill="#3e61c3">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="#3e61c3" x="0" y="11">N4JSParser</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_20">
+        <g id="Graphic_23">
+          <rect x="908.5" y="419.5" width="239" height="15" fill="white"/>
+          <rect x="908.5" y="419.5" width="239" height="15" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(913.5 420.5)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">+getSyntaxErrorMessage(..)</tspan>
+          </text>
+        </g>
+        <g id="Graphic_22">
+          <rect x="908.5" y="405.5" width="239" height="14" fill="white"/>
+          <rect x="908.5" y="405.5" width="239" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_21">
+          <rect x="908.5" y="381.5" width="239" height="24" fill="white"/>
+          <rect x="908.5" y="381.5" width="239" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(913.7217 386.5)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="0" y="11">BadEscapementAwareMessageProvider</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Line_165">
+        <path d="M 333.17067 415.5 L 333.17067 431 L 333.625 431.5 L 333.625 433.5" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Group_166">
+        <g id="Graphic_169">
+          <rect x="46.5" y="485" width="122" height="14" fill="white"/>
+          <rect x="46.5" y="485" width="122" height="14" stroke="#3d61c2" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_168">
+          <rect x="46.5" y="471" width="122" height="14" fill="white"/>
+          <rect x="46.5" y="471" width="122" height="14" stroke="#3d61c2" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_167">
+          <rect x="46.5" y="447" width="122" height="24" fill="white"/>
+          <rect x="46.5" y="447" width="122" height="24" stroke="#3d61c2" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(51.5 452)" fill="#3e61c3">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="#3e61c3" x=".6376953" y="11">InternalN4JSParser</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Line_170">
+        <path d="M 107.32115 395 L 107.32115 410.5 L 107.03932 431.5 L 107.03932 433.5" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_171">
+        <line x1="295" y1="473" x2="178.4" y2="473" marker-end="url(#StickArrow_Marker_2)" stroke="#3d61c2" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_258">
+        <path d="M 276.5 181.23206 L 228 181 L 203.88088 182.5012" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_259">
+        <text transform="translate(213.26386 168.56468)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="0" y="9">get next token</tspan>
+        </text>
+      </g>
+      <g id="Graphic_260">
+        <text transform="translate(313.042 275)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«create»</tspan>
+        </text>
+      </g>
+      <g id="Graphic_261">
+        <rect x="206.536" y="354.84334" width="49" height="22" fill="white"/>
+        <text transform="translate(211.57798 359.84334)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«create»</tspan>
+        </text>
+      </g>
+      <g id="Graphic_262">
+        <rect x="378.2232" y="305.15285" width="49" height="22" fill="white"/>
+        <text transform="translate(383.2652 310.15285)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«create»</tspan>
+        </text>
+      </g>
+      <g id="Graphic_284">
+        <ellipse cx="590.7535" cy="406.4449" rx="50.7535810991138" ry="15.0000239685284" fill="white"/>
+        <path d="M 626.6416 395.8383 C 646.4622 401.69616 646.4622 411.1936 626.6416 417.0515 C 606.82114 422.90937 574.68586 422.90937 554.8654 417.0515 C 535.04483 411.1936 535.04483 401.69616 554.8654 395.8383 C 574.68586 389.9804 606.82114 389.9804 626.6416 395.8383" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+        <text transform="translate(555.1507 399.4449)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="12.259048" y="11">mediator</tspan>
+        </text>
+      </g>
+      <g id="Line_188">
+        <line x1="426.5" y1="382.6293" x2="544.6808" y2="399.7647" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_285">
+        <line x1="274.536" y1="322.5" x2="189.3912" y2="254.19494" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_286">
+        <text transform="translate(190.69278 281.56497)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«create (indirect)»</tspan>
+        </text>
+      </g>
+      <g id="Graphic_148">
+        <path d="M 335.5 675.1552 C 335.5 670.94366 334.56655 670.4226 327.74796 666.25465 L 327.67592 666.2115 C 320.8213 662 320.75002 662 313.71534 662 C 304.3485 662 262 662 262 662 L 262 706.4582 L 335.5 706.4582 L 335.5 675.1552 Z" fill="white"/>
+        <path d="M 335.5 675.1552 C 335.5 670.94366 334.56655 670.4226 327.74796 666.25465 L 327.67592 666.2115 C 320.8213 662 320.75002 662 313.71534 662 C 304.3485 662 262 662 262 662 L 262 706.4582 L 335.5 706.4582 L 335.5 675.1552 Z M 335.5 674.9382 C 335.5 670.94366 335.42797 670.94366 320.75002 670.94366 L 320.75002 670.94366 C 320.75002 662.0436 320.75002 662 314.14604 662" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(267 663.2291)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="18.405273" y="11">to be </tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="7.0703125" y="25">moved to </tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="19.079102" y="39">xtext</tspan>
+        </text>
+      </g>
+      <g id="Line_287">
+        <line x1="261.5" y1="684.1808" x2="223" y2="684.1309" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+    </g>
+  </g>
+</svg>
diff --git a/design/chapters/05_parser/images/cd_grammars.svg b/design/chapters/05_parser/images/cd_grammars.svg
new file mode 100644
index 0000000..bda33de
--- /dev/null
+++ b/design/chapters/05_parser/images/cd_grammars.svg
@@ -0,0 +1,123 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xl="http://www.w3.org/1999/xlink" xmlns:dc="http://purl.org/dc/elements/1.1/" viewBox="82.75 45.625 319.8385 202.00217" width="319.8385" height="202.00217">
+  <defs>
+    <font-face font-family="Helvetica" font-size="12" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="532.22656" cap-height="719.7266" ascent="770.0195" descent="-229.98047" font-weight="700">
+      <font-face-src>
+        <font-face-name name="Helvetica-Bold"/>
+      </font-face-src>
+    </font-face>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="StickArrow_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -4 10 8" markerWidth="10" markerHeight="8" color="black">
+      <g>
+        <path d="M 8 0 L 0 0 M 0 -3 L 8 0 L 0 3" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <font-face font-family="Helvetica" font-size="10" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="9" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+  </defs>
+  <metadata> Produced by OmniGraffle 7.11 
+    <dc:date>2018-11-07 10:21:52 +0000</dc:date>
+  </metadata>
+  <g id="Canvas_1" stroke="none" stroke-opacity="1" stroke-dasharray="none" fill="none" fill-opacity="1">
+    <title>Canvas 1</title>
+    <rect fill="white" x="82.75" y="45.625" width="319.8385" height="202.00217"/>
+    <g id="Canvas_1: Layer 1">
+      <title>Layer 1</title>
+      <g id="Graphic_237">
+        <rect x="229.5" y="46.125" width="99" height="36" fill="white"/>
+        <rect x="229.5" y="46.125" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(234.5 57.125)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="20.831055" y="11">Unicode</tspan>
+        </text>
+      </g>
+      <g id="Graphic_236">
+        <rect x="302.53387" y="128.62608" width="99" height="36" fill="white"/>
+        <rect x="302.53387" y="128.62608" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(307.53387 132.62608)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="22.161133" y="11">Regular </tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="8.816406" y="25">Expressions</tspan>
+        </text>
+      </g>
+      <g id="Graphic_235">
+        <rect x="158.5" y="128.62608" width="99" height="36" fill="white"/>
+        <rect x="158.5" y="128.62608" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(163.5 132.62608)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="30.938477" y="11">Type </tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="8.816406" y="25">Expressions</tspan>
+        </text>
+      </g>
+      <g id="Graphic_234">
+        <rect x="88.5" y="211.12714" width="99" height="36" fill="white"/>
+        <rect x="88.5" y="211.12714" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(93.5 222.12714)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="27.601562" y="11">Types</tspan>
+        </text>
+      </g>
+      <g id="Graphic_233">
+        <rect x="229.5" y="211.12717" width="99" height="36" fill="white"/>
+        <rect x="229.5" y="211.12717" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(234.5 222.12717)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="29.49121" y="11">N4JS</tspan>
+        </text>
+      </g>
+      <g id="Line_232">
+        <line x1="232.75" y1="128.62608" x2="250.09527" y2="91.111" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_231">
+        <text transform="translate(244.05435 102.55784)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«with»</tspan>
+        </text>
+      </g>
+      <g id="Line_230">
+        <line x1="162.75" y1="211.12714" x2="179.25643" y2="173.68486" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_229">
+        <text transform="translate(176.61658 182.92478)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«with»</tspan>
+        </text>
+      </g>
+      <g id="Line_228">
+        <line x1="254.25" y1="211.12717" x2="236.90472" y2="173.61209" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_227">
+        <text transform="translate(250.81524 179.0201)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«with»</tspan>
+        </text>
+      </g>
+      <g id="Line_226">
+        <line x1="327.28387" y1="128.62608" x2="308.2204" y2="90.9582" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_225">
+        <text transform="translate(323.195 101.12106)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«with»</tspan>
+        </text>
+      </g>
+      <g id="Line_224">
+        <line x1="303.75" y1="211.12717" x2="322.81345" y2="173.45928" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_223">
+        <text transform="translate(317.5885 182.8997)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«value converter»</tspan>
+        </text>
+      </g>
+      <g id="Graphic_222">
+        <path d="M 144.25 180.5299 C 144.25 178.44583 143.4753 178.188 137.81633 176.1255 L 137.75655 176.10415 C 132.06769 174.0201 132.00852 174.0201 126.17021 174.0201 C 118.39637 174.0201 83.25 174.0201 83.25 174.0201 L 83.25 196.0201 L 144.25 196.0201 L 144.25 180.5299 Z" fill="white"/>
+        <path d="M 144.25 180.5299 C 144.25 178.44583 143.4753 178.188 137.81633 176.1255 L 137.75655 176.10415 C 132.06769 174.0201 132.00852 174.0201 126.17021 174.0201 C 118.39637 174.0201 83.25 174.0201 83.25 174.0201 L 83.25 196.0201 L 144.25 196.0201 L 144.25 180.5299 Z M 144.25 180.42253 C 144.25 178.44583 144.19022 178.44583 132.00852 178.44583 L 132.00852 178.44583 C 132.00852 174.04165 132.00852 174.0201 126.52767 174.0201" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(88.25 179.5201)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x=".2380371" y="9">built-in types</tspan>
+        </text>
+      </g>
+      <g id="Line_221">
+        <line x1="113.54384" y1="210.62715" x2="113.65742" y2="196.52008" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+    </g>
+  </g>
+</svg>
diff --git a/design/chapters/05_parser/images/cd_parsergeneration.svg b/design/chapters/05_parser/images/cd_parsergeneration.svg
new file mode 100644
index 0000000..9e84c50
--- /dev/null
+++ b/design/chapters/05_parser/images/cd_parsergeneration.svg
@@ -0,0 +1,382 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xl="http://www.w3.org/1999/xlink" xmlns:dc="http://purl.org/dc/elements/1.1/" viewBox="3.5 23.5 550 524.2381" width="550" height="524.2381">
+  <defs>
+    <font-face font-family="Helvetica" font-size="12" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="532.22656" cap-height="719.7266" ascent="770.0195" descent="-229.98047" font-weight="700">
+      <font-face-src>
+        <font-face-name name="Helvetica-Bold"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="10" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="13" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="532.22656" cap-height="719.7266" ascent="770.0195" descent="-229.98047" font-weight="700">
+      <font-face-src>
+        <font-face-name name="Helvetica-Bold"/>
+      </font-face-src>
+    </font-face>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="StickArrow_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -4 10 8" markerWidth="10" markerHeight="8" color="#295492">
+      <g>
+        <path d="M 8 0 L 0 0 M 0 -3 L 8 0 L 0 3" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <font-face font-family="Helvetica" font-size="11" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="12" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="UMLInheritance_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -8 14 16" markerWidth="14" markerHeight="16" color="black">
+      <g>
+        <path d="M 12 0 L 0 -7 L 0 7 Z" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="StickArrow_Marker_2" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -4 10 8" markerWidth="10" markerHeight="8" color="black">
+      <g>
+        <path d="M 8 0 L 0 0 M 0 -3 L 8 0 L 0 3" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <font-face font-family="Helvetica" font-size="9" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="11" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="532.22656" cap-height="719.7266" ascent="770.0195" descent="-229.98047" font-weight="700">
+      <font-face-src>
+        <font-face-name name="Helvetica-Bold"/>
+      </font-face-src>
+    </font-face>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="FilledDiamond_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-9 -4 10 8" markerWidth="10" markerHeight="8" color="black">
+      <g>
+        <path d="M -8 0 L -4 3 L 0 0 L -4 -3 Z" fill="currentColor" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+  </defs>
+  <metadata> Produced by OmniGraffle 7.11 
+    <dc:date>2013-10-25 08:48:37 +0000</dc:date>
+  </metadata>
+  <g id="Canvas_1" stroke="none" stroke-opacity="1" stroke-dasharray="none" fill="none" fill-opacity="1">
+    <title>Canvas 1</title>
+    <rect fill="white" x="3.5" y="23.5" width="550" height="524.2381"/>
+    <g id="Canvas_1: Layer 1">
+      <title>Layer 1</title>
+      <g id="Group_719">
+        <g id="Graphic_723">
+          <rect x="15" y="24" width="538" height="128.79794" fill="white"/>
+          <rect x="15" y="24" width="538" height="128.79794" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(17 136.79794)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="496.63477" y="11">Parser</tspan>
+          </text>
+        </g>
+        <g id="Group_720">
+          <g id="Graphic_722">
+            <rect x="4" y="31" width="21.959" height="7.78378" fill="white"/>
+            <rect x="4" y="31" width="21.959" height="7.78378" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Graphic_721">
+            <rect x="4" y="47.2162" width="21.959" height="7.78378" fill="white"/>
+            <rect x="4" y="47.2162" width="21.959" height="7.78378" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+        </g>
+      </g>
+      <g id="Group_708">
+        <g id="Group_715">
+          <g id="Graphic_718">
+            <rect x="392.02454" y="106.62478" width="78" height="14" fill="white"/>
+            <rect x="392.02454" y="106.62478" width="78" height="14" stroke="#295492" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Graphic_717">
+            <rect x="392.02454" y="92.62478" width="78" height="14" fill="white"/>
+            <rect x="392.02454" y="92.62478" width="78" height="14" stroke="#3d61c2" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Graphic_716">
+            <rect x="392.02454" y="56.62478" width="78" height="36" fill="white"/>
+            <rect x="392.02454" y="56.62478" width="78" height="36" stroke="#295492" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+            <text transform="translate(397.02454 61.62478)" fill="#3e61c3">
+              <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="#3e61c3" x="5.918945" y="10">«generated»</tspan>
+              <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="#3e61c3" x=".30859375" y="23">N4JSParser</tspan>
+            </text>
+          </g>
+        </g>
+        <g id="Group_711">
+          <g id="Graphic_714">
+            <rect x="64.524536" y="80.39899" width="173" height="66" fill="white"/>
+            <rect x="64.524536" y="80.39899" width="173" height="66" stroke="#3d61c2" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+            <text transform="translate(69.52454 81.39899)" fill="#295492">
+              <tspan font-family="Helvetica" font-size="13" font-weight="700" fill="#295492" x="0" y="13">setInRegularExpression()</tspan>
+              <tspan font-family="Helvetica" font-size="13" font-weight="700" fill="#295492" x="0" y="29">ruleREGEX_LITERAL()</tspan>
+              <tspan font-family="Helvetica" font-size="13" font-weight="700" fill="#295492" x="0" y="45">promoteEOL()</tspan>
+              <tspan font-family="Helvetica" font-size="13" font-weight="700" fill="#295492" x="0" y="61">ruleSemi()</tspan>
+            </text>
+          </g>
+          <g id="Graphic_713">
+            <rect x="64.524536" y="66.39899" width="173" height="14" fill="white"/>
+            <rect x="64.524536" y="66.39899" width="173" height="14" stroke="#3d61c2" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Graphic_712">
+            <rect x="64.524536" y="30.39899" width="173" height="36" fill="white"/>
+            <rect x="64.524536" y="30.39899" width="173" height="36" stroke="#3d61c2" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+            <text transform="translate(69.52454 35.39899)" fill="#295492">
+              <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="#295492" x="53.418945" y="10">«generated»</tspan>
+              <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="#295492" x="26.137695" y="23">InternalN4JSParser</tspan>
+            </text>
+          </g>
+        </g>
+        <g id="Line_710">
+          <line x1="392.02454" y1="88.59333" x2="247.42453" y2="88.47673" marker-end="url(#StickArrow_Marker)" stroke="#295492" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+        </g>
+        <g id="Graphic_709">
+          <text transform="translate(301.09115 76.03726)" fill="#295492">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="#295492" x="0" y="10">«create»</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_606">
+        <g id="Graphic_610">
+          <rect x="15" y="310.44015" width="538" height="236.79794" fill="white"/>
+          <rect x="15" y="310.44015" width="538" height="236.79794" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(17 531.2381)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="429.32227" y="11">Generator</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" y="11"> (MWE2)</tspan>
+          </text>
+        </g>
+        <g id="Group_607">
+          <g id="Graphic_609">
+            <rect x="4" y="317.44015" width="21.959" height="7.78378" fill="white"/>
+            <rect x="4" y="317.44015" width="21.959" height="7.78378" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Graphic_608">
+            <rect x="4" y="333.65635" width="21.959" height="7.78378" fill="white"/>
+            <rect x="4" y="333.65635" width="21.959" height="7.78378" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+        </g>
+      </g>
+      <g id="Group_604">
+        <g id="Graphic_605">
+          <rect x="41.12732" y="430.70586" width="106" height="24" fill="white"/>
+          <rect x="41.12732" y="430.70586" width="106" height="24" stroke="#f63007" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(46.12732 435.70586)" fill="#f63008">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="#f63008" x="1.1044922" y="11">AntlrToolFacade</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Line_603">
+        <line x1="94.12732" y1="396.9954" x2="94.12732" y2="417.20586" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_602">
+        <line x1="347.9894" y1="390.99537" x2="422.89996" y2="391.59017" marker-end="url(#StickArrow_Marker_2)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Group_595">
+        <g id="Graphic_596">
+          <rect x="34.99469" y="358.9954" width="118.26526" height="38" fill="white"/>
+          <rect x="34.99469" y="358.9954" width="118.26526" height="38" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(39.99469 363.9954)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="7.237122" y="11">AntlrToolFacade</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="3.519348" y="25">WithInjectedCode</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_593">
+        <g id="Graphic_594">
+          <rect x="432.79965" y="373.0618" width="99" height="38" fill="white"/>
+          <rect x="432.79965" y="373.0618" width="99" height="38" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(437.79965 378.0618)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="22.166992" y="11">Custom</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x=".4873047" y="25">KeywordHelper</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_591">
+        <g id="Graphic_592">
+          <rect x="316.70257" y="413.8149" width="95" height="47" fill="white"/>
+          <rect x="316.70257" y="413.8149" width="95" height="47" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(321.70257 418.8149)" fill="black">
+            <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="8.974121" y="9">«Xtend1 advice»</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="700" fill="black" x="4.39209" y="21">UnicodeAware</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="700" fill="black" x="16.213867" y="34">Keywords</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Line_589">
+        <line x1="214.73938" y1="377.99536" x2="163.15995" y2="377.9954" marker-end="url(#StickArrow_Marker_2)" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_588">
+        <text transform="translate(170.40814 353.99538)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="0" y="9">«MWE2»</tspan>
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="1.4963379" y="20">antlrTool</tspan>
+        </text>
+      </g>
+      <g id="Graphic_587">
+        <path d="M 546.3295 329.20467 C 546.3295 324.691 545.1992 324.13256 536.94264 319.66557 L 536.8554 319.61935 C 528.5553 315.10566 528.46895 315.10566 519.95076 315.10566 C 508.6086 315.10566 457.32947 315.10566 457.32947 315.10566 L 457.32947 362.75356 L 546.3295 362.75356 L 546.3295 329.20467 Z" fill="white"/>
+        <path d="M 546.3295 329.20467 C 546.3295 324.691 545.1992 324.13256 536.94264 319.66557 L 536.8554 319.61935 C 528.5553 315.10566 528.46895 315.10566 519.95076 315.10566 C 508.6086 315.10566 457.32947 315.10566 457.32947 315.10566 L 457.32947 362.75356 L 546.3295 362.75356 L 546.3295 329.20467 Z M 546.3295 328.97215 C 546.3295 324.691 546.24225 324.691 528.46895 324.691 L 528.46895 324.691 C 528.46895 315.15236 528.46895 315.10566 520.4723 315.10566" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(462.32947 320.9296)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="12.605469" y="10">&quot;Semicolon&quot; </tspan>
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="17.817871" y="22">instead of </tspan>
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="1.7729492" y="34">&quot;KEYWORD_42&quot;</tspan>
+        </text>
+      </g>
+      <g id="Group_585">
+        <g id="Graphic_586">
+          <rect x="223.98938" y="351.99537" width="124" height="52" fill="white"/>
+          <rect x="223.98938" y="351.99537" width="124" height="52" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(228.98938 356.99537)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="1.3857422" y="11">AntlrGeneratorWith</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="34.666992" y="25">Custom</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="15.66211" y="39">KeywordLogic</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_581">
+        <g id="Graphic_584">
+          <rect x="245.4289" y="517.8067" width="159.26123" height="22" fill="white"/>
+          <rect x="245.4289" y="517.8067" width="159.26123" height="22" stroke="#f63007" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(250.4289 522.8067)" fill="#f63008">
+            <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="#f63008" x="0" y="10">registerExtensionAdvices(String)</tspan>
+          </text>
+        </g>
+        <g id="Graphic_583">
+          <rect x="245.4289" y="505.8067" width="159.26123" height="12" fill="white"/>
+          <rect x="245.4289" y="505.8067" width="159.26123" height="12" stroke="#f63007" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_582">
+          <rect x="245.4289" y="481.8067" width="159.26123" height="24" fill="white"/>
+          <rect x="245.4289" y="481.8067" width="159.26123" height="24" stroke="#f63007" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(250.4289 486.8067)" fill="#f63008">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="#f63008" x="11.290771" y="11">ExecutionContextImpl</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Line_580">
+        <line x1="285.98938" y1="403.99537" x2="285.339" y2="471.9071" marker-end="url(#StickArrow_Marker_2)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_579">
+        <line x1="285.68073" y1="436.2249" x2="306.80353" y2="436.5181" marker-end="url(#StickArrow_Marker_2)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_578">
+        <text transform="translate(240.00744 451.8094)" fill="black">
+          <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">«register</tspan>
+          <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="1.831543" y="23">Advice»</tspan>
+        </text>
+      </g>
+      <g id="Group_576">
+        <g id="Graphic_577">
+          <rect x="116.1581" y="488.41636" width="101.14153" height="38" fill="white"/>
+          <rect x="116.1581" y="488.41636" width="101.14153" height="38" stroke="#f63007" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(121.1581 493.41636)" fill="#f63008">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="#f63008" x="2.8969345" y="11">AntlrGenerator</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="#f63008" x="18.233849" y="25">Fragment</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Line_575">
+        <path d="M 254.98937 403.99537 L 254.98937 426.67236 L 166.72886 426.67236 L 166.72886 474.91636" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Group_573">
+        <g id="Graphic_574">
+          <rect x="432.81937" y="490.80665" width="99" height="24" fill="white"/>
+          <rect x="432.81937" y="490.80665" width="99" height="24" stroke="#f63007" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(437.81937 495.80665)" fill="#f63008">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="#f63008" x=".4873047" y="11">KeywordHelper</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Line_572">
+        <path d="M 482.29965 411.0618 L 482.29965 426.5618 L 482.3194 475.30665 L 482.3194 477.30665" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_188">
+        <line x1="399.47924" y1="361.1676" x2="456.84087" y2="348.70443" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_551">
+        <text transform="translate(108.40131 328.68337)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="0" y="9">«replaceCode»</tspan>
+        </text>
+      </g>
+      <g id="Line_559">
+        <line x1="151.74018" y1="146.39899" x2="152.14438" y2="179.15702" marker-end="url(#StickArrow_Marker_2)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_560">
+        <text transform="translate(152.53653 161.75556)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«generated from»</tspan>
+        </text>
+      </g>
+      <g id="Group_454">
+        <g id="Graphic_458">
+          <rect x="285.03723" y="192.55625" width="74.8741" height="79" fill="white"/>
+          <rect x="285.03723" y="192.55625" width="74.8741" height="79" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(290.03723 211.05625)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="10.766151" y="11">Internal</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x=".07865143" y="25">N4JSLexer.</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="13.098183" y="39">tokens</tspan>
+          </text>
+        </g>
+        <g id="Group_455">
+          <g id="Line_457">
+            <path d="M 353.50223 196.23625 L 349.41823 196.23625 L 349.41823 207.27625 L 356.22523 207.27625 L 356.22523 199.91625 L 353.50223 196.23625" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Line_456">
+            <path d="M 353.50223 196.23625 L 353.50223 199.91625 L 356.22523 199.91625 L 356.22523 199.91625" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+        </g>
+      </g>
+      <g id="Line_371">
+        <line x1="285.98938" y1="351.99537" x2="301.62062" y2="281.22327" marker-end="url(#StickArrow_Marker_2)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_372">
+        <text transform="translate(301.0776 286.2781)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«generates»</tspan>
+        </text>
+      </g>
+      <g id="Line_612">
+        <line x1="432.79965" y1="373.597" x2="302.03204" y2="324.81716" marker-end="url(#StickArrow_Marker_2)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Group_541">
+        <g id="Graphic_545">
+          <rect x="114.82947" y="189.05627" width="74.8741" height="86" fill="white"/>
+          <rect x="114.82947" y="189.05627" width="74.8741" height="86" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(119.82947 206.05627)" fill="black">
+            <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="19.375526" y="10">«Antlr </tspan>
+            <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="8.545448" y="22">Grammar»</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="3.0962296" y="35">InternalN4</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="1.4116592" y="49">JSParser.g</tspan>
+          </text>
+        </g>
+        <g id="Group_542">
+          <g id="Line_544">
+            <path d="M 185.29447 192.41627 L 181.21047 192.41627 L 181.21047 202.49627 L 188.01747 202.49627 L 188.01747 195.77627 L 185.29447 192.41627" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Line_543">
+            <path d="M 185.29447 192.41627 L 185.29447 195.77627 L 188.01747 195.77627 L 188.01747 195.77627" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+        </g>
+      </g>
+      <g id="Line_548">
+        <line x1="223.98938" y1="364.99537" x2="176.0115" y2="283.5853" marker-end="url(#StickArrow_Marker_2)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_549">
+        <text transform="translate(198.33066 295.66378)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«generates»</tspan>
+        </text>
+      </g>
+      <g id="Line_550">
+        <line x1="94.12732" y1="358.9954" x2="129.3396" y2="284.01726" marker-end="url(#StickArrow_Marker_2)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_569">
+        <line x1="189.70357" y1="232.05628" x2="275.13723" y2="232.05626" marker-end="url(#StickArrow_Marker_2)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_570">
+        <text transform="translate(222.4127 213.05627)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«uses»</tspan>
+        </text>
+      </g>
+      <g id="Line_611">
+        <path d="M 501.99565 314.60567 L 502.82947 192.55625 L 164.21303 124.67236" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+    </g>
+  </g>
+</svg>
diff --git a/design/chapters/05_parser/images/cd_parserlexercommunication.png b/design/chapters/05_parser/images/cd_parserlexercommunication.png
new file mode 100644
index 0000000..5616b02
--- /dev/null
+++ b/design/chapters/05_parser/images/cd_parserlexercommunication.png
Binary files differ
diff --git a/design/chapters/05_parser/images/cd_parserlexercommunication.svg b/design/chapters/05_parser/images/cd_parserlexercommunication.svg
new file mode 100644
index 0000000..554abdb
--- /dev/null
+++ b/design/chapters/05_parser/images/cd_parserlexercommunication.svg
@@ -0,0 +1,408 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xl="http://www.w3.org/1999/xlink" xmlns:dc="http://purl.org/dc/elements/1.1/" viewBox="30.5 7.499998 661 419" width="661" height="419">
+  <defs>
+    <font-face font-family="Helvetica" font-size="12" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="532.22656" cap-height="719.7266" ascent="770.0195" descent="-229.98047" font-weight="700">
+      <font-face-src>
+        <font-face-name name="Helvetica-Bold"/>
+      </font-face-src>
+    </font-face>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="StickArrow_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -4 10 8" markerWidth="10" markerHeight="8" color="black">
+      <g>
+        <path d="M 8 0 L 0 0 M 0 -3 L 8 0 L 0 3" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="FilledDiamond_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-9 -4 10 8" markerWidth="10" markerHeight="8" color="black">
+      <g>
+        <path d="M -8 0 L -4 3 L 0 0 L -4 -3 Z" fill="currentColor" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <font-face font-family="Helvetica" font-size="11" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="9" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="10" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="UMLInheritance_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -8 14 16" markerWidth="14" markerHeight="16" color="black">
+      <g>
+        <path d="M 12 0 L 0 -7 L 0 7 Z" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="StickArrow_Marker_2" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -4 10 8" markerWidth="10" markerHeight="8" color="#295492">
+      <g>
+        <path d="M 8 0 L 0 0 M 0 -3 L 8 0 L 0 3" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <font-face font-family="Helvetica" font-size="11" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="532.22656" cap-height="719.7266" ascent="770.0195" descent="-229.98047" font-weight="700">
+      <font-face-src>
+        <font-face-name name="Helvetica-Bold"/>
+      </font-face-src>
+    </font-face>
+  </defs>
+  <metadata> Produced by OmniGraffle 7.11 
+    <dc:date>2013-10-25 08:43:10 +0000</dc:date>
+  </metadata>
+  <g id="Canvas_1" stroke="none" stroke-opacity="1" stroke-dasharray="none" fill="none" fill-opacity="1">
+    <title>Canvas 1</title>
+    <rect fill="white" x="30.5" y="7.499998" width="661" height="419"/>
+    <g id="Canvas_1: Layer 1">
+      <title>Layer 1</title>
+      <g id="Group_448">
+        <g id="Graphic_452">
+          <rect x="152.85184" y="235.20206" width="538" height="190.79794" fill="white"/>
+          <rect x="152.85184" y="235.20206" width="538" height="190.79794" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(154.85184 410)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="496.63477" y="11">Parser</tspan>
+          </text>
+        </g>
+        <g id="Group_449">
+          <g id="Graphic_451">
+            <rect x="141.85184" y="242.20206" width="21.959" height="7.78378" fill="white"/>
+            <rect x="141.85184" y="242.20206" width="21.959" height="7.78378" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Graphic_450">
+            <rect x="141.85184" y="258.41826" width="21.959" height="7.78378" fill="white"/>
+            <rect x="141.85184" y="258.41826" width="21.959" height="7.78378" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+        </g>
+      </g>
+      <g id="Group_434">
+        <g id="Graphic_438">
+          <rect x="153" y="7.999998" width="538" height="183.02942" fill="white"/>
+          <rect x="153" y="7.999998" width="538" height="183.02942" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(155 175.02942)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="501.9785" y="11">Lexer</tspan>
+          </text>
+        </g>
+        <g id="Group_435">
+          <g id="Graphic_437">
+            <rect x="142" y="82.52942" width="21.959" height="7.78378" fill="white"/>
+            <rect x="142" y="82.52942" width="21.959" height="7.78378" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Graphic_436">
+            <rect x="142" y="98.74562" width="21.959" height="7.78378" fill="white"/>
+            <rect x="142" y="98.74562" width="21.959" height="7.78378" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+        </g>
+      </g>
+      <g id="Line_255">
+        <line x1="556.364" y1="250.926" x2="521.9946" y2="167.68018" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_253">
+        <line x1="289.1932" y1="253.676" x2="287.01482" y2="181.92486" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_251">
+        <line x1="572.5256" y1="132.02942" x2="580.6" y2="132.02942" marker-end="url(#StickArrow_Marker)" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Group_226">
+        <g id="Graphic_227">
+          <rect x="590.5" y="120.02942" width="81" height="24" fill="white"/>
+          <rect x="590.5" y="120.02942" width="81" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(595.5 125.02942)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x=".26757812" y="11">JSTokenList</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_719">
+        <g id="Group_726">
+          <g id="Graphic_729">
+            <rect x="451.27557" y="143.52942" width="112" height="15" fill="white"/>
+            <rect x="451.27557" y="143.52942" width="112" height="15" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+            <text transform="translate(456.27557 144.52942)" fill="black">
+              <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">fillBuffer(..)</tspan>
+            </text>
+          </g>
+          <g id="Graphic_728">
+            <rect x="451.27557" y="129.52942" width="112" height="14" fill="white"/>
+            <rect x="451.27557" y="129.52942" width="112" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Graphic_727">
+            <rect x="451.27557" y="105.52942" width="112" height="24" fill="white"/>
+            <rect x="451.27557" y="105.52942" width="112" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+            <text transform="translate(456.27557 110.52942)" fill="black">
+              <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x=".09082031" y="11">LazyTokenStream</tspan>
+            </text>
+          </g>
+        </g>
+        <g id="Group_722">
+          <g id="Graphic_725">
+            <rect x="199" y="144.02942" width="173" height="28" fill="white"/>
+            <rect x="199" y="144.02942" width="173" height="28" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+            <text transform="translate(204 145.02942)" fill="black">
+              <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">setInRegularExpression()</tspan>
+              <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="23">nextToken()</tspan>
+            </text>
+          </g>
+          <g id="Graphic_724">
+            <rect x="199" y="130.02942" width="173" height="14" fill="white"/>
+            <rect x="199" y="130.02942" width="173" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Graphic_723">
+            <rect x="199" y="92.02942" width="173" height="38" fill="white"/>
+            <rect x="199" y="92.02942" width="173" height="38" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+            <text transform="translate(204 97.02942)" fill="black">
+              <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x=".46484375" y="11">«provideInternalN4JSLexer»</tspan>
+              <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="10.90625" y="25">RegExLiteralAwareLexer</tspan>
+            </text>
+          </g>
+        </g>
+        <g id="Line_721">
+          <line x1="451.27557" y1="132.02942" x2="381.9" y2="132.02942" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+        </g>
+        <g id="Graphic_720">
+          <text transform="translate(392.1515 119.52942)" fill="black">
+            <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="0" y="9">«nextToken»</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Graphic_260">
+        <text transform="translate(538.97105 192.27882)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«create»</tspan>
+        </text>
+      </g>
+      <g id="Line_285">
+        <line x1="507.61306" y1="250.926" x2="368.95295" y2="176.70158" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_286">
+        <text transform="translate(433.74367 200.86598)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«create (indirect)»</tspan>
+        </text>
+      </g>
+      <g id="Group_624">
+        <g id="Graphic_628">
+          <rect x="31" y="7.999998" width="74.8741" height="42" fill="white"/>
+          <rect x="31" y="7.999998" width="74.8741" height="42" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(36 21.999998)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="22.101112" y="11">File</tspan>
+          </text>
+        </g>
+        <g id="Group_625">
+          <g id="Line_627">
+            <path d="M 99.465 11.359998 L 95.381 11.359998 L 95.381 21.439998 L 102.188 21.439998 L 102.188 14.719998 L 99.465 11.359998" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Line_626">
+            <path d="M 99.465 11.359998 L 99.465 14.719998 L 102.188 14.719998 L 102.188 14.719998" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+        </g>
+      </g>
+      <g id="Group_619">
+        <g id="Graphic_623">
+          <rect x="31" y="193.21348" width="74.8741" height="42" fill="white"/>
+          <rect x="31" y="193.21348" width="74.8741" height="42" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(36 207.21348)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="11.873573" y="11">Tokens</tspan>
+          </text>
+        </g>
+        <g id="Group_620">
+          <g id="Line_622">
+            <path d="M 99.465 196.57348 L 95.381 196.57348 L 95.381 206.65348 L 102.188 206.65348 L 102.188 199.93348 L 99.465 196.57348" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Line_621">
+            <path d="M 99.465 196.57348 L 99.465 199.93348 L 102.188 199.93348 L 102.188 199.93348" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+        </g>
+      </g>
+      <g id="Group_614">
+        <g id="Graphic_618">
+          <rect x="31" y="384" width="74.8741" height="42" fill="white"/>
+          <rect x="31" y="384" width="74.8741" height="42" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(36 398)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="20.43705" y="11">AST</tspan>
+          </text>
+        </g>
+        <g id="Group_615">
+          <g id="Line_617">
+            <path d="M 99.465 387.36 L 95.381 387.36 L 95.381 397.44 L 102.188 397.44 L 102.188 390.72 L 99.465 387.36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Line_616">
+            <path d="M 99.465 387.36 L 99.465 390.72 L 102.188 390.72" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+        </g>
+      </g>
+      <g id="Line_683">
+        <line x1="570.1951" y1="317.926" x2="570.1951" y2="338.5032" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_678">
+        <line x1="290.19507" y1="319.676" x2="290.19507" y2="346.39034" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Group_697">
+        <g id="Line_707">
+          <line x1="476.19507" y1="285.18137" x2="400.59475" y2="285.78887" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+        </g>
+        <g id="Group_703">
+          <g id="Graphic_706">
+            <rect x="476.19507" y="302.926" width="188" height="15" fill="white"/>
+            <rect x="476.19507" y="302.926" width="188" height="15" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+            <text transform="translate(481.19507 303.926)" fill="black">
+              <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">doParse(..)</tspan>
+            </text>
+          </g>
+          <g id="Graphic_705">
+            <rect x="476.19507" y="288.926" width="188" height="14" fill="white"/>
+            <rect x="476.19507" y="288.926" width="188" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Graphic_704">
+            <rect x="476.19507" y="250.926" width="188" height="38" fill="white"/>
+            <rect x="476.19507" y="250.926" width="188" height="38" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+            <text transform="translate(481.19507 255.926)" fill="black">
+              <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="49.314453" y="11">«bindIParser»</tspan>
+              <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x=".30078125" y="25">N4JSSemicolonInjectingParser</tspan>
+            </text>
+          </g>
+        </g>
+        <g id="Group_699">
+          <g id="Graphic_702">
+            <rect x="189.69507" y="291.676" width="201" height="28" fill="white"/>
+            <rect x="189.69507" y="291.676" width="201" height="28" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+            <text transform="translate(194.69507 292.676)" fill="black">
+              <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">setInRegularExpression()</tspan>
+              <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="23">recover(..)</tspan>
+            </text>
+          </g>
+          <g id="Graphic_701">
+            <rect x="189.69507" y="277.676" width="201" height="14" fill="white"/>
+            <rect x="189.69507" y="277.676" width="201" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Graphic_700">
+            <rect x="189.69507" y="253.676" width="201" height="24" fill="white"/>
+            <rect x="189.69507" y="253.676" width="201" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+            <text transform="translate(194.69507 258.676)" fill="black">
+              <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x=".13867188" y="11">InternalSemicolonInjectingParser</tspan>
+            </text>
+          </g>
+        </g>
+        <g id="Graphic_698">
+          <text transform="translate(413.75776 272.5265)" fill="black">
+            <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«create»</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_708">
+        <g id="Group_715">
+          <g id="Graphic_718">
+            <rect x="531.1951" y="402.0032" width="78" height="14" fill="white"/>
+            <rect x="531.1951" y="402.0032" width="78" height="14" stroke="#295492" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Graphic_717">
+            <rect x="531.1951" y="388.0032" width="78" height="14" fill="white"/>
+            <rect x="531.1951" y="388.0032" width="78" height="14" stroke="#3d61c2" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Graphic_716">
+            <rect x="531.1951" y="352.0032" width="78" height="36" fill="white"/>
+            <rect x="531.1951" y="352.0032" width="78" height="36" stroke="#295492" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+            <text transform="translate(536.1951 357.0032)" fill="#3e61c3">
+              <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="#3e61c3" x="5.918945" y="10">«generated»</tspan>
+              <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="#3e61c3" x=".30859375" y="23">N4JSParser</tspan>
+            </text>
+          </g>
+        </g>
+        <g id="Group_711">
+          <g id="Graphic_713">
+            <rect x="203.69507" y="395.89034" width="173" height="14" fill="white"/>
+            <rect x="203.69507" y="395.89034" width="173" height="14" stroke="#3d61c2" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Graphic_712">
+            <rect x="203.69507" y="359.89034" width="173" height="36" fill="white"/>
+            <rect x="203.69507" y="359.89034" width="173" height="36" stroke="#3d61c2" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+            <text transform="translate(208.69507 364.89034)" fill="#295492">
+              <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="#295492" x="53.418945" y="10">«generated»</tspan>
+              <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="#295492" x="26.137695" y="23">InternalN4JSParser</tspan>
+            </text>
+          </g>
+        </g>
+        <g id="Line_710">
+          <line x1="531.1951" y1="384.1268" x2="386.595" y2="384.5849" marker-end="url(#StickArrow_Marker_2)" stroke="#295492" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+        </g>
+        <g id="Graphic_709">
+          <text transform="translate(440.23784 371.8471)" fill="#295492">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="#295492" x="0" y="10">«create»</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Line_439">
+        <line x1="142" y1="53.75735" x2="114.04047" y2="34.59647" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_440">
+        <text transform="translate(114.90496 24.599578)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«reads»</tspan>
+        </text>
+      </g>
+      <g id="Line_441">
+        <line x1="142" y1="99.51466" x2="74.55053" y2="185.4266" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_442">
+        <text transform="translate(63.04878 126.78695)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«produces»</tspan>
+        </text>
+      </g>
+      <g id="Line_443">
+        <line x1="141.85184" y1="282.90154" x2="76.73927" y2="240.60636" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_444">
+        <text transform="translate(68.72612 270.4729)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«consumes»</tspan>
+        </text>
+      </g>
+      <g id="Line_446">
+        <line x1="141.85184" y1="330.601" x2="76.4432" y2="378.17664" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_447">
+        <text transform="translate(73.11511 332.65845)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«creates»</tspan>
+        </text>
+      </g>
+      <g id="Graphic_453">
+        <text transform="translate(217.37934 203.3363)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«RegExp State</tspan>
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="11.115723" y="22">Handling»</tspan>
+        </text>
+      </g>
+      <g id="Group_730">
+        <g id="Graphic_731">
+          <rect x="222.99268" y="12.129532" width="126.00488" height="35" fill="white"/>
+          <rect x="222.99268" y="12.129532" width="126.00488" height="35" stroke="#295492" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(227.99268 17.129532)" fill="#295492">
+            <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="#295492" x="32.729492" y="9">«generated»</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="#295492" x="5.312012" y="22">InternalN4JSLexer</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Line_732">
+        <path d="M 285.69264 92.02942 L 285.69264 76.52942 L 285.9089 62.62953 L 285.9089 60.62953" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Group_733">
+        <g id="Graphic_734">
+          <rect x="448" y="17.629532" width="119.30487" height="24" fill="white"/>
+          <rect x="448" y="17.629532" width="119.30487" height="24" stroke="#f63007" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(453 22.629532)" fill="#f63008">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="#f63008" x="2.4102478" y="11">XtextTokenStream</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Line_735">
+        <path d="M 507.327 105.52942 L 507.327 90.02942 L 507.451 57.12953 L 507.451 55.12953" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Group_736">
+        <g id="Graphic_737">
+          <rect x="579.4994" y="17.629532" width="103.00122" height="23" fill="white"/>
+          <rect x="579.4994" y="17.629532" width="103.00122" height="23" stroke="#b0b0b0" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(584.4994 22.629532)" fill="#b0b0b0">
+            <tspan font-family="Helvetica" font-size="11" font-weight="700" fill="#b0b0b0" x=".1373291" y="10">ArrayList&lt;Token&gt;</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Line_738">
+        <path d="M 631.0022 120.02942 L 631.0022 104.52942 L 631.0169 56.12953 L 631.0169 54.12953" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+    </g>
+  </g>
+</svg>
diff --git a/design/chapters/05_parser/images/sd_parsing_sequence.svg b/design/chapters/05_parser/images/sd_parsing_sequence.svg
new file mode 100644
index 0000000..a2bf7bb
--- /dev/null
+++ b/design/chapters/05_parser/images/sd_parsing_sequence.svg
@@ -0,0 +1,268 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xl="http://www.w3.org/1999/xlink" xmlns:dc="http://purl.org/dc/elements/1.1/" viewBox="4.5 18.836 548 382.664" width="548" height="382.664">
+  <defs>
+    <font-face font-family="Helvetica" font-size="10" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="StickArrow_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -4 10 8" markerWidth="10" markerHeight="8" color="black">
+      <g>
+        <path d="M 8 0 L 0 0 M 0 -3 L 8 0 L 0 3" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <font-face font-family="Helvetica" font-size="9" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="StickArrow_Marker_2" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -6 14 12" markerWidth="14" markerHeight="12" color="black">
+      <g>
+        <path d="M 11.428568 0 L 0 0 M 0 -4.285713 L 11.428568 0 L 0 4.285713" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <font-face font-family="Helvetica" font-size="12" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="532.22656" cap-height="719.7266" ascent="770.0195" descent="-229.98047" font-weight="700">
+      <font-face-src>
+        <font-face-name name="Helvetica-Bold"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="12" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="FilledArrow_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -4 10 8" markerWidth="10" markerHeight="8" color="black">
+      <g>
+        <path d="M 8 0 L 0 -3 L 0 3 Z" fill="currentColor" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="StickArrow_Marker_3" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-9 -4 10 8" markerWidth="10" markerHeight="8" color="black">
+      <g>
+        <path d="M -8 0 L 0 0 M 0 3 L -8 0 L 0 -3" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+  </defs>
+  <metadata> Produced by OmniGraffle 7.11 
+    <dc:date>2019-08-02 08:26:12 +0000</dc:date>
+  </metadata>
+  <g id="Canvas_1" stroke="none" stroke-opacity="1" stroke-dasharray="none" fill="none" fill-opacity="1">
+    <title>Canvas 1</title>
+    <rect fill="white" x="4.5" y="18.836" width="548" height="382.664"/>
+    <g id="Canvas_1: Layer 1">
+      <title>Layer 1</title>
+      <g id="Group_53">
+        <g id="Graphic_55">
+          <rect x="7.7665405" y="19.336" width="163.23346" height="24" fill="white"/>
+          <rect x="7.7665405" y="19.336" width="163.23346" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(12.76654 19.336)" fill="black">
+            <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="61.055206" y="10">parser:</tspan>
+            <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="7.695831" y="22">N4JSSemicolonInjectingParser</tspan>
+          </text>
+        </g>
+        <g id="Line_54">
+          <line x1="89.38327" y1="43.836" x2="89.38327" y2="401" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+        </g>
+      </g>
+      <g id="Graphic_52">
+        <rect x="79.38326" y="53.376" width="18" height="320.624" fill="white"/>
+        <rect x="79.38326" y="53.376" width="18" height="320.624" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_51">
+        <line x1="97" y1="63.57" x2="144.1" y2="63.57" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_50">
+        <text transform="translate(120.64393 64.11651)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="0" y="9">init</tspan>
+        </text>
+      </g>
+      <g id="Graphic_49">
+        <text transform="translate(122.37348 98.11651)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="0" y="9">init</tspan>
+        </text>
+      </g>
+      <g id="Graphic_48">
+        <text transform="translate(121.904 131.11651)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="0" y="9">init</tspan>
+        </text>
+      </g>
+      <g id="Graphic_47">
+        <text transform="translate(122.2726 162.54651)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="0" y="9">parse</tspan>
+        </text>
+      </g>
+      <g id="Group_24">
+        <g id="Group_44">
+          <g id="Graphic_46">
+            <rect x="157.59149" y="53.376" width="124.172" height="24" fill="white"/>
+            <rect x="157.59149" y="53.376" width="124.172" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+            <text transform="translate(162.59149 53.376)" fill="black">
+              <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="44.859436" y="10">lexer:</tspan>
+              <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="1.8687134" y="22">RegExLiteralAwareLexer</tspan>
+            </text>
+          </g>
+          <g id="Line_45">
+            <line x1="219.6775" y1="77.876" x2="219.6775" y2="401" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+          </g>
+        </g>
+        <g id="Group_41">
+          <g id="Graphic_43">
+            <rect x="296.8802" y="85.752" width="107.88327" height="24" fill="white"/>
+            <rect x="296.8802" y="85.752" width="107.88327" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+            <text transform="translate(301.8802 85.752)" fill="black">
+              <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="32.82103" y="10">tokens: </tspan>
+              <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="8.922104" y="22">LazyTokenStream</tspan>
+            </text>
+          </g>
+          <g id="Line_42">
+            <line x1="350.82185" y1="110.252" x2="350.82185" y2="401" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+          </g>
+        </g>
+        <g id="Group_38">
+          <g id="Graphic_40">
+            <rect x="419.8802" y="116.36001" width="124.172" height="24" fill="white"/>
+            <rect x="419.8802" y="116.36001" width="124.172" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+            <text transform="translate(424.8802 116.36001)" fill="black">
+              <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="24.57135" y="10">internalParser:</tspan>
+              <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="13.455627" y="22">InternalN4JSParser</tspan>
+            </text>
+          </g>
+          <g id="Line_39">
+            <line x1="481.9662" y1="140.86001" x2="481.9662" y2="401" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+          </g>
+        </g>
+        <g id="Group_34">
+          <g id="Graphic_37">
+            <rect x="342" y="117" width="18" height="257" fill="white"/>
+            <rect x="342" y="117" width="18" height="257" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Graphic_36">
+            <rect x="351.5" y="213.686" width="18" height="92.314" fill="white"/>
+            <rect x="351.5" y="213.686" width="18" height="92.314" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Line_35">
+            <path d="M 360 206.949 L 387 206.949 L 387 225 L 382.82857 225" marker-end="url(#StickArrow_Marker_2)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+        </g>
+        <g id="Graphic_33">
+          <rect x="211" y="81" width="18" height="293" fill="white"/>
+          <rect x="211" y="81" width="18" height="293" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Group_25">
+          <g id="Group_29">
+            <g id="Graphic_32">
+              <rect x="472.9662" y="144.53424" width="18" height="228.2915" fill="white"/>
+              <rect x="472.9662" y="144.53424" width="18" height="228.2915" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+            </g>
+            <g id="Graphic_31">
+              <rect x="482.4662" y="167.82574" width="18" height="179" fill="white"/>
+              <rect x="482.4662" y="167.82574" width="18" height="179" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+            </g>
+            <g id="Line_30">
+              <path d="M 495.9662 161.82574 L 517.9662 161.82574 L 517.9662 188.82574 L 515.7118 188.82574" marker-end="url(#StickArrow_Marker_2)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+            </g>
+          </g>
+          <g id="Group_26">
+            <g id="Graphic_28">
+              <rect x="166.59148" y="176.37215" width="385.4085" height="162.4536" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+            </g>
+            <g id="Graphic_27">
+              <path d="M 166.59148 176.37215 L 312 176.37215 L 312 185.3721 L 299.88267 194.37205 L 166.59148 194.37194 Z" fill="white"/>
+              <path d="M 166.59148 176.37215 L 312 176.37215 L 312 185.3721 L 299.88267 194.37205 L 166.59148 194.37194 Z" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+              <text transform="translate(171.59148 178.3721)" fill="black">
+                <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="0" y="11">loop </tspan>
+                <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" y="11">tokenType != EOF</tspan>
+              </text>
+            </g>
+          </g>
+        </g>
+      </g>
+      <g id="Line_23">
+        <line x1="481" y1="198" x2="369.9" y2="198" marker-end="url(#FilledArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_22">
+        <text transform="translate(395.8594 198.5465)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="0" y="9">lookAhead</tspan>
+        </text>
+      </g>
+      <g id="Graphic_21">
+        <text transform="translate(396 213)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="0" y="9">fillBuffer if empty</tspan>
+        </text>
+      </g>
+      <g id="Group_18">
+        <g id="Graphic_20">
+          <rect x="179" y="233" width="208" height="65" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_19">
+          <path d="M 179 233 L 314 233 L 314 240.49996 L 302.75004 247.99992 L 179 247.99983 Z" fill="white"/>
+          <path d="M 179 233 L 314 233 L 314 240.49996 L 302.75004 247.99992 L 179 247.99983 Z" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(184 233.49996)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="0" y="11">loop </tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" y="11">div char seen</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Line_17">
+        <line x1="351" y1="258" x2="243.9" y2="258" marker-end="url(#FilledArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_16">
+        <text transform="translate(268.46322 258.5465)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="0" y="9">nextToken</tspan>
+        </text>
+      </g>
+      <g id="Line_15">
+        <line x1="341.1" y1="279" x2="234" y2="279" marker-start="url(#StickArrow_Marker_3)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_14">
+        <text transform="translate(277.65194 279.5465)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="0" y="9">Token</tspan>
+        </text>
+      </g>
+      <g id="Line_13">
+        <line x1="472.1" y1="326" x2="361" y2="326" marker-start="url(#StickArrow_Marker_3)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_12">
+        <text transform="translate(398.07167 326.5465)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="0" y="9">tokenType</tspan>
+        </text>
+      </g>
+      <g id="Line_11">
+        <line x1="108.93379" y1="353" x2="475" y2="353" marker-start="url(#StickArrow_Marker_3)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_10">
+        <text transform="translate(124.56212 353.5465)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="0" y="9">AST</tspan>
+        </text>
+      </g>
+      <g id="Line_9">
+        <line x1="5" y1="62" x2="63.1" y2="62" marker-end="url(#FilledArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_8">
+        <line x1="25.9" y1="364" x2="77" y2="364" marker-start="url(#StickArrow_Marker_3)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_7">
+        <text transform="translate(524 162)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="0" y="9">parse</tspan>
+        </text>
+      </g>
+      <g id="Line_6">
+        <line x1="98" y1="130.57" x2="407.1" y2="130.57" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_5">
+        <line x1="97" y1="97.57" x2="283.1" y2="97.57" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_4">
+        <line x1="97" y1="162" x2="463.0662" y2="162" marker-end="url(#FilledArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_3">
+        <line x1="481" y1="182" x2="369.9" y2="182" marker-end="url(#FilledArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_2">
+        <text transform="translate(393.8594 182.5465)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="0" y="9">setInRegEx</tspan>
+        </text>
+      </g>
+    </g>
+  </g>
+</svg>
diff --git a/design/chapters/06_typesystem/images/cd_typeModelHierarchy_References.png b/design/chapters/06_typesystem/images/cd_typeModelHierarchy_References.png
new file mode 100644
index 0000000..daec88a
--- /dev/null
+++ b/design/chapters/06_typesystem/images/cd_typeModelHierarchy_References.png
Binary files differ
diff --git a/design/chapters/06_typesystem/images/cd_typeModelHierarchy_Types.png b/design/chapters/06_typesystem/images/cd_typeModelHierarchy_Types.png
new file mode 100644
index 0000000..385dbe5
--- /dev/null
+++ b/design/chapters/06_typesystem/images/cd_typeModelHierarchy_Types.png
Binary files differ
diff --git a/design/chapters/06_typesystem/images/cd_typeModelHierarchy_allInOne.png b/design/chapters/06_typesystem/images/cd_typeModelHierarchy_allInOne.png
new file mode 100644
index 0000000..4c1567a
--- /dev/null
+++ b/design/chapters/06_typesystem/images/cd_typeModelHierarchy_allInOne.png
Binary files differ
diff --git a/design/chapters/06_typesystem/images/figSources.key/Data/110809_FamilyChineseOahu_EN_00317_2040x1360-small-12.jpg b/design/chapters/06_typesystem/images/figSources.key/Data/110809_FamilyChineseOahu_EN_00317_2040x1360-small-12.jpg
new file mode 100644
index 0000000..9fa010e
--- /dev/null
+++ b/design/chapters/06_typesystem/images/figSources.key/Data/110809_FamilyChineseOahu_EN_00317_2040x1360-small-12.jpg
Binary files differ
diff --git a/design/chapters/06_typesystem/images/figSources.key/Data/110809_FamilyChineseOahu_EN_02016_981x654-small-14.jpg b/design/chapters/06_typesystem/images/figSources.key/Data/110809_FamilyChineseOahu_EN_02016_981x654-small-14.jpg
new file mode 100644
index 0000000..50e18ee
--- /dev/null
+++ b/design/chapters/06_typesystem/images/figSources.key/Data/110809_FamilyChineseOahu_EN_02016_981x654-small-14.jpg
Binary files differ
diff --git a/design/chapters/06_typesystem/images/figSources.key/Data/110809_FamilyChineseOahu_EN_02390_2880x1921-small-10.jpg b/design/chapters/06_typesystem/images/figSources.key/Data/110809_FamilyChineseOahu_EN_02390_2880x1921-small-10.jpg
new file mode 100644
index 0000000..a1b06ae
--- /dev/null
+++ b/design/chapters/06_typesystem/images/figSources.key/Data/110809_FamilyChineseOahu_EN_02390_2880x1921-small-10.jpg
Binary files differ
diff --git a/design/chapters/06_typesystem/images/figSources.key/Data/mt0@2x-159.jpg b/design/chapters/06_typesystem/images/figSources.key/Data/mt0@2x-159.jpg
new file mode 100644
index 0000000..a43b627
--- /dev/null
+++ b/design/chapters/06_typesystem/images/figSources.key/Data/mt0@2x-159.jpg
Binary files differ
diff --git a/design/chapters/06_typesystem/images/figSources.key/Data/mt10@2x-87.jpg b/design/chapters/06_typesystem/images/figSources.key/Data/mt10@2x-87.jpg
new file mode 100644
index 0000000..d10ff91
--- /dev/null
+++ b/design/chapters/06_typesystem/images/figSources.key/Data/mt10@2x-87.jpg
Binary files differ
diff --git a/design/chapters/06_typesystem/images/figSources.key/Data/mt1@2x-160.jpg b/design/chapters/06_typesystem/images/figSources.key/Data/mt1@2x-160.jpg
new file mode 100644
index 0000000..adec280
--- /dev/null
+++ b/design/chapters/06_typesystem/images/figSources.key/Data/mt1@2x-160.jpg
Binary files differ
diff --git a/design/chapters/06_typesystem/images/figSources.key/Data/mt2@2x-161.jpg b/design/chapters/06_typesystem/images/figSources.key/Data/mt2@2x-161.jpg
new file mode 100644
index 0000000..a0a45d1
--- /dev/null
+++ b/design/chapters/06_typesystem/images/figSources.key/Data/mt2@2x-161.jpg
Binary files differ
diff --git a/design/chapters/06_typesystem/images/figSources.key/Data/mt3@2x-80.jpg b/design/chapters/06_typesystem/images/figSources.key/Data/mt3@2x-80.jpg
new file mode 100644
index 0000000..349fcbb
--- /dev/null
+++ b/design/chapters/06_typesystem/images/figSources.key/Data/mt3@2x-80.jpg
Binary files differ
diff --git a/design/chapters/06_typesystem/images/figSources.key/Data/mt4@2x-164.jpg b/design/chapters/06_typesystem/images/figSources.key/Data/mt4@2x-164.jpg
new file mode 100644
index 0000000..bc15eee
--- /dev/null
+++ b/design/chapters/06_typesystem/images/figSources.key/Data/mt4@2x-164.jpg
Binary files differ
diff --git a/design/chapters/06_typesystem/images/figSources.key/Data/mt5@2x-309.jpg b/design/chapters/06_typesystem/images/figSources.key/Data/mt5@2x-309.jpg
new file mode 100644
index 0000000..1e4b1c7
--- /dev/null
+++ b/design/chapters/06_typesystem/images/figSources.key/Data/mt5@2x-309.jpg
Binary files differ
diff --git a/design/chapters/06_typesystem/images/figSources.key/Data/mt6@2x-262.jpg b/design/chapters/06_typesystem/images/figSources.key/Data/mt6@2x-262.jpg
new file mode 100644
index 0000000..28552dd
--- /dev/null
+++ b/design/chapters/06_typesystem/images/figSources.key/Data/mt6@2x-262.jpg
Binary files differ
diff --git a/design/chapters/06_typesystem/images/figSources.key/Data/mt7@2x-269.jpg b/design/chapters/06_typesystem/images/figSources.key/Data/mt7@2x-269.jpg
new file mode 100644
index 0000000..f87436c
--- /dev/null
+++ b/design/chapters/06_typesystem/images/figSources.key/Data/mt7@2x-269.jpg
Binary files differ
diff --git a/design/chapters/06_typesystem/images/figSources.key/Data/mt8@2x-85.jpg b/design/chapters/06_typesystem/images/figSources.key/Data/mt8@2x-85.jpg
new file mode 100644
index 0000000..003b0f9
--- /dev/null
+++ b/design/chapters/06_typesystem/images/figSources.key/Data/mt8@2x-85.jpg
Binary files differ
diff --git a/design/chapters/06_typesystem/images/figSources.key/Data/mt9@2x-86.jpg b/design/chapters/06_typesystem/images/figSources.key/Data/mt9@2x-86.jpg
new file mode 100644
index 0000000..b87a496
--- /dev/null
+++ b/design/chapters/06_typesystem/images/figSources.key/Data/mt9@2x-86.jpg
Binary files differ
diff --git a/design/chapters/06_typesystem/images/figSources.key/Data/st0-3354.jpg b/design/chapters/06_typesystem/images/figSources.key/Data/st0-3354.jpg
new file mode 100644
index 0000000..cd13114
--- /dev/null
+++ b/design/chapters/06_typesystem/images/figSources.key/Data/st0-3354.jpg
Binary files differ
diff --git a/design/chapters/06_typesystem/images/figSources.key/Data/st1-3357.jpg b/design/chapters/06_typesystem/images/figSources.key/Data/st1-3357.jpg
new file mode 100644
index 0000000..b61462a
--- /dev/null
+++ b/design/chapters/06_typesystem/images/figSources.key/Data/st1-3357.jpg
Binary files differ
diff --git a/design/chapters/06_typesystem/images/figSources.key/Data/st22-2766.jpg b/design/chapters/06_typesystem/images/figSources.key/Data/st22-2766.jpg
new file mode 100644
index 0000000..8bf6bb5
--- /dev/null
+++ b/design/chapters/06_typesystem/images/figSources.key/Data/st22-2766.jpg
Binary files differ
diff --git a/design/chapters/06_typesystem/images/figSources.key/Index.zip b/design/chapters/06_typesystem/images/figSources.key/Index.zip
new file mode 100644
index 0000000..e457954
--- /dev/null
+++ b/design/chapters/06_typesystem/images/figSources.key/Index.zip
Binary files differ
diff --git a/design/chapters/06_typesystem/images/figSources.key/Metadata/BuildVersionHistory.plist b/design/chapters/06_typesystem/images/figSources.key/Metadata/BuildVersionHistory.plist
new file mode 100644
index 0000000..39dd4fe
--- /dev/null
+++ b/design/chapters/06_typesystem/images/figSources.key/Metadata/BuildVersionHistory.plist
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<array>
+	<string>Template: White (2014-02-28 09:41)</string>
+	<string>M6.2.2-1878-1</string>
+</array>
+</plist>
diff --git a/design/chapters/06_typesystem/images/figSources.key/Metadata/DocumentIdentifier b/design/chapters/06_typesystem/images/figSources.key/Metadata/DocumentIdentifier
new file mode 100644
index 0000000..212cbc2
--- /dev/null
+++ b/design/chapters/06_typesystem/images/figSources.key/Metadata/DocumentIdentifier
@@ -0,0 +1 @@
+E84973F2-5DEF-4323-B100-B624FAD19340
\ No newline at end of file
diff --git a/design/chapters/06_typesystem/images/figSources.key/Metadata/Properties.plist b/design/chapters/06_typesystem/images/figSources.key/Metadata/Properties.plist
new file mode 100644
index 0000000..bc05328
--- /dev/null
+++ b/design/chapters/06_typesystem/images/figSources.key/Metadata/Properties.plist
Binary files differ
diff --git a/design/chapters/06_typesystem/images/figSources.key/preview-micro.jpg b/design/chapters/06_typesystem/images/figSources.key/preview-micro.jpg
new file mode 100644
index 0000000..8f2c99e
--- /dev/null
+++ b/design/chapters/06_typesystem/images/figSources.key/preview-micro.jpg
Binary files differ
diff --git a/design/chapters/06_typesystem/images/figSources.key/preview-web.jpg b/design/chapters/06_typesystem/images/figSources.key/preview-web.jpg
new file mode 100644
index 0000000..e2dec4d
--- /dev/null
+++ b/design/chapters/06_typesystem/images/figSources.key/preview-web.jpg
Binary files differ
diff --git a/design/chapters/06_typesystem/images/figSources.key/preview.jpg b/design/chapters/06_typesystem/images/figSources.key/preview.jpg
new file mode 100644
index 0000000..ed932db
--- /dev/null
+++ b/design/chapters/06_typesystem/images/figSources.key/preview.jpg
Binary files differ
diff --git a/design/chapters/06_typesystem/images/traversalOrder.png b/design/chapters/06_typesystem/images/traversalOrder.png
new file mode 100644
index 0000000..53adc20
--- /dev/null
+++ b/design/chapters/06_typesystem/images/traversalOrder.png
Binary files differ
diff --git a/design/chapters/06_typesystem/images/upwardDownward.png b/design/chapters/06_typesystem/images/upwardDownward.png
new file mode 100644
index 0000000..00d7e1f
--- /dev/null
+++ b/design/chapters/06_typesystem/images/upwardDownward.png
Binary files differ
diff --git a/design/chapters/07_typeindex/images/BrotherJS.png b/design/chapters/07_typeindex/images/BrotherJS.png
new file mode 100644
index 0000000..3663784
--- /dev/null
+++ b/design/chapters/07_typeindex/images/BrotherJS.png
Binary files differ
diff --git a/design/chapters/07_typeindex/images/BrotherXMI.png b/design/chapters/07_typeindex/images/BrotherXMI.png
new file mode 100644
index 0000000..2119369
--- /dev/null
+++ b/design/chapters/07_typeindex/images/BrotherXMI.png
Binary files differ
diff --git a/design/chapters/07_typeindex/images/ChildJS.png b/design/chapters/07_typeindex/images/ChildJS.png
new file mode 100644
index 0000000..a6c52c7
--- /dev/null
+++ b/design/chapters/07_typeindex/images/ChildJS.png
Binary files differ
diff --git a/design/chapters/07_typeindex/images/ChildXMI.png b/design/chapters/07_typeindex/images/ChildXMI.png
new file mode 100644
index 0000000..d5caeb3
--- /dev/null
+++ b/design/chapters/07_typeindex/images/ChildXMI.png
Binary files differ
diff --git a/design/chapters/07_typeindex/images/SisterJS.png b/design/chapters/07_typeindex/images/SisterJS.png
new file mode 100644
index 0000000..da717db
--- /dev/null
+++ b/design/chapters/07_typeindex/images/SisterJS.png
Binary files differ
diff --git a/design/chapters/07_typeindex/images/SisterXMI.png b/design/chapters/07_typeindex/images/SisterXMI.png
new file mode 100644
index 0000000..ed98cab
--- /dev/null
+++ b/design/chapters/07_typeindex/images/SisterXMI.png
Binary files differ
diff --git a/design/chapters/07_typeindex/images/XMI1.png b/design/chapters/07_typeindex/images/XMI1.png
new file mode 100644
index 0000000..aed74f7
--- /dev/null
+++ b/design/chapters/07_typeindex/images/XMI1.png
Binary files differ
diff --git a/design/chapters/07_typeindex/images/XMI2.png b/design/chapters/07_typeindex/images/XMI2.png
new file mode 100644
index 0000000..a220610
--- /dev/null
+++ b/design/chapters/07_typeindex/images/XMI2.png
Binary files differ
diff --git a/design/chapters/07_typeindex/images/XMI3.png b/design/chapters/07_typeindex/images/XMI3.png
new file mode 100644
index 0000000..d4016af
--- /dev/null
+++ b/design/chapters/07_typeindex/images/XMI3.png
Binary files differ
diff --git a/design/chapters/07_typeindex/images/XtextIndex.png b/design/chapters/07_typeindex/images/XtextIndex.png
new file mode 100644
index 0000000..caf26ca
--- /dev/null
+++ b/design/chapters/07_typeindex/images/XtextIndex.png
Binary files differ
diff --git a/design/chapters/07_typeindex/images/ad_resourceLoading.png b/design/chapters/07_typeindex/images/ad_resourceLoading.png
new file mode 100644
index 0000000..63dea1b
--- /dev/null
+++ b/design/chapters/07_typeindex/images/ad_resourceLoading.png
Binary files differ
diff --git a/design/chapters/07_typeindex/images/builderStateExample.png b/design/chapters/07_typeindex/images/builderStateExample.png
new file mode 100644
index 0000000..63c778e
--- /dev/null
+++ b/design/chapters/07_typeindex/images/builderStateExample.png
Binary files differ
diff --git a/design/chapters/07_typeindex/images/cd_CreateTypeFromAST.png b/design/chapters/07_typeindex/images/cd_CreateTypeFromAST.png
new file mode 100644
index 0000000..04f4177
--- /dev/null
+++ b/design/chapters/07_typeindex/images/cd_CreateTypeFromAST.png
Binary files differ
diff --git a/design/chapters/07_typeindex/images/cd_CreateTypeFromIndex.png b/design/chapters/07_typeindex/images/cd_CreateTypeFromIndex.png
new file mode 100644
index 0000000..16c474c
--- /dev/null
+++ b/design/chapters/07_typeindex/images/cd_CreateTypeFromIndex.png
Binary files differ
diff --git a/design/chapters/07_typeindex/images/cd_SerializeToIndex.png b/design/chapters/07_typeindex/images/cd_SerializeToIndex.png
new file mode 100644
index 0000000..dc82bb5
--- /dev/null
+++ b/design/chapters/07_typeindex/images/cd_SerializeToIndex.png
Binary files differ
diff --git a/design/chapters/07_typeindex/images/cd_TypeModelWithXtextIndex.png b/design/chapters/07_typeindex/images/cd_TypeModelWithXtextIndex.png
new file mode 100644
index 0000000..914a776
--- /dev/null
+++ b/design/chapters/07_typeindex/images/cd_TypeModelWithXtextIndex.png
Binary files differ
diff --git a/design/chapters/07_typeindex/images/cd_UI.png b/design/chapters/07_typeindex/images/cd_UI.png
new file mode 100644
index 0000000..7a88e5a
--- /dev/null
+++ b/design/chapters/07_typeindex/images/cd_UI.png
Binary files differ
diff --git a/design/chapters/07_typeindex/images/cd_resources.png b/design/chapters/07_typeindex/images/cd_resources.png
new file mode 100644
index 0000000..e11c89b
--- /dev/null
+++ b/design/chapters/07_typeindex/images/cd_resources.png
Binary files differ
diff --git a/design/chapters/07_typeindex/images/clean_build.png b/design/chapters/07_typeindex/images/clean_build.png
new file mode 100644
index 0000000..aa4f721
--- /dev/null
+++ b/design/chapters/07_typeindex/images/clean_build.png
Binary files differ
diff --git a/design/chapters/07_typeindex/images/dirty_state_handling1.png b/design/chapters/07_typeindex/images/dirty_state_handling1.png
new file mode 100644
index 0000000..a0b7cd7
--- /dev/null
+++ b/design/chapters/07_typeindex/images/dirty_state_handling1.png
Binary files differ
diff --git a/design/chapters/07_typeindex/images/dirty_state_handling2.png b/design/chapters/07_typeindex/images/dirty_state_handling2.png
new file mode 100644
index 0000000..3c0e8d2
--- /dev/null
+++ b/design/chapters/07_typeindex/images/dirty_state_handling2.png
Binary files differ
diff --git a/design/chapters/07_typeindex/images/index_dialog.png b/design/chapters/07_typeindex/images/index_dialog.png
new file mode 100644
index 0000000..77ee336
--- /dev/null
+++ b/design/chapters/07_typeindex/images/index_dialog.png
Binary files differ
diff --git a/design/chapters/07_typeindex/images/index_serialization.png b/design/chapters/07_typeindex/images/index_serialization.png
new file mode 100644
index 0000000..09181f4
--- /dev/null
+++ b/design/chapters/07_typeindex/images/index_serialization.png
Binary files differ
diff --git a/design/chapters/07_typeindex/images/loading_existing_index.png b/design/chapters/07_typeindex/images/loading_existing_index.png
new file mode 100644
index 0000000..58f4157
--- /dev/null
+++ b/design/chapters/07_typeindex/images/loading_existing_index.png
Binary files differ
diff --git a/design/chapters/07_typeindex/images/overview.png b/design/chapters/07_typeindex/images/overview.png
new file mode 100644
index 0000000..03d2346
--- /dev/null
+++ b/design/chapters/07_typeindex/images/overview.png
Binary files differ
diff --git a/design/chapters/07_typeindex/images/plantuml/clean_build.txt b/design/chapters/07_typeindex/images/plantuml/clean_build.txt
new file mode 100644
index 0000000..2facbf5
--- /dev/null
+++ b/design/chapters/07_typeindex/images/plantuml/clean_build.txt
@@ -0,0 +1,21 @@
+@startuml
+
+Event -> BuilderManager: build
+activate BuilderManager
+   BuilderManager -> XtextBuilder: clean
+   activate XtextBuilder
+      XtextBuilder -> ToBeBuiltComputer: removeProject
+      activate ToBeBuiltComputer
+         ToBeBuiltComputer -> GenerateImmediatelyBuilderState: getAllResourceDescriptions
+         activate GenerateImmediatelyBuilderState
+            GenerateImmediatelyBuilderState -> GenerateImmediatelyBuilderState: getAllResourceDescriptions
+         deactivate GenerateImmediatelyBuilderState
+         ToBeBuiltComputer -> ToBeBuiltComputer: collect all resource descriptions for the current \nproject and added as to be deleted in ToBeBuilt object
+      deactivate ToBeBuiltComputer
+      XtextBuilder -> GenerateImmediatelyBuilderState: calculate delta list for ToBeBuilt
+      XtextBuilder -> GenerateImmediatelyBuilderState: removeDescription
+      XtextBuilder -> GenerateImmediatelyBuilderState: build
+      GenerateImmediatelyBuilderState -> N4JSBuilderParticipant: build
+   deactivate XtextBuilder
+deactivate BuilderManager
+@enduml
\ No newline at end of file
diff --git a/design/chapters/07_typeindex/images/plantuml/creating_types.txt b/design/chapters/07_typeindex/images/plantuml/creating_types.txt
new file mode 100644
index 0000000..7cec788
--- /dev/null
+++ b/design/chapters/07_typeindex/images/plantuml/creating_types.txt
@@ -0,0 +1 @@
+where triggered, how often triggered, who is collaborating
\ No newline at end of file
diff --git a/design/chapters/07_typeindex/images/plantuml/dirty_state_handling1.txt b/design/chapters/07_typeindex/images/plantuml/dirty_state_handling1.txt
new file mode 100644
index 0000000..b6a7568
--- /dev/null
+++ b/design/chapters/07_typeindex/images/plantuml/dirty_state_handling1.txt
@@ -0,0 +1,19 @@
+ @startuml
+	  Event -> GenerateImmediatelyBuilderState: update
+	  activate GenerateImmediatelyBuilderState
+		  GenerateImmediatelyBuilderState -> StateChangeEventBroker: notifyListeners
+	      activate StateChangeEventBroker
+		      	StateChangeEventBroker -> N4JSDirtyStateEditorSupport: notifyListeners
+	      		activate N4JSDirtyStateEditorSupport
+	      			loop for each open Xtext editor
+		      			create N4JSUpdateEditorStateJob
+		      			N4JSDirtyStateEditorSupport -> N4JSUpdateEditorStateJob: create
+		      			N4JSDirtyStateEditorSupport -> N4JSUpdateEditorStateJob: schedule
+		      		end loop
+	      		deactivate N4JSDirtyStateEditorSupport
+	      deactivate StateChangeEventBroker
+      deactivate GenerateImmediatelyBuilderState
+  @enduml
+
+
+ 
\ No newline at end of file
diff --git a/design/chapters/07_typeindex/images/plantuml/dirty_state_handling2.txt b/design/chapters/07_typeindex/images/plantuml/dirty_state_handling2.txt
new file mode 100644
index 0000000..b946569
--- /dev/null
+++ b/design/chapters/07_typeindex/images/plantuml/dirty_state_handling2.txt
@@ -0,0 +1,18 @@
+ @startuml
+	N4JSDirtyStateEditorSupport -> N4JSUpdateEditorStateJob: schedule
+	activate N4JSUpdateEditorStateJob
+		N4JSUpdateEditorStateJob -> N4JSUpdateEditorStateJob: run
+		activate N4JSUpdateEditorStateJob
+			N4JSUpdateEditorStateJob -> N4JSUpdateEditorStateJob: collect affected resources
+			loop affected resources
+				N4JSUpdateEditorStateJob -> N4JSUpdateEditorStateJob: unload affected resource
+				note right: by this the references of the resource of the \ncurrent editor to the affected resources will by proxified
+				N4JSUpdateEditorStateJob -> N4JSUpdateEditorStateJob: remove affected resource from editor's resource resource set
+			end loop
+			N4JSUpdateEditorStateJob -> N4JSUpdateEditorStateJob: reparse editor's document
+		deactivate N4JSUpdateEditorStateJob
+	deactivate N4JSUpdateEditorStateJo
+@enduml
+
+
+ 
\ No newline at end of file
diff --git a/design/chapters/07_typeindex/images/plantuml/generation.txt b/design/chapters/07_typeindex/images/plantuml/generation.txt
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/design/chapters/07_typeindex/images/plantuml/generation.txt
diff --git a/design/chapters/07_typeindex/images/plantuml/index_serialization.txt b/design/chapters/07_typeindex/images/plantuml/index_serialization.txt
new file mode 100644
index 0000000..10b363f
--- /dev/null
+++ b/design/chapters/07_typeindex/images/plantuml/index_serialization.txt
@@ -0,0 +1,7 @@
+@startuml
+
+Event -> SaveManager: diverse calls
+note left: Eclipse Workspace Close
+SaveManager -> EMFBasedPersister: write Xtext index to file \n.metadata/.plugins/org.eclipse.xtext.builder/builder.state \nin workspace
+
+@enduml
\ No newline at end of file
diff --git a/design/chapters/07_typeindex/images/plantuml/loading_existing_index.txt b/design/chapters/07_typeindex/images/plantuml/loading_existing_index.txt
new file mode 100644
index 0000000..0110926
--- /dev/null
+++ b/design/chapters/07_typeindex/images/plantuml/loading_existing_index.txt
@@ -0,0 +1,19 @@
+@startuml
+left header
+	<font size=16>Before each clean build or update build it is checked, that the Index has been loaded and if not so it is done
+
+
+endheader
+
+Event -> BuilderState: clean or update
+activate BuilderState
+	BuilderState -> BuilderState: ensureLoaded
+	alt is not loaded yet
+		BuilderState -> EMFBasedPersister: load
+		BuilderState <-- EMFBasedPersister: resource descriptions
+		create ResourceDescriptionsData
+		BuilderState -> ResourceDescriptionsData: init with just loaded resource descriptions
+		BuilderState -> Storage2UriMapper: initializeCache
+	end
+deactivate BuilderState
+@enduml
\ No newline at end of file
diff --git a/design/chapters/07_typeindex/images/plantuml/overview.txt b/design/chapters/07_typeindex/images/plantuml/overview.txt
new file mode 100644
index 0000000..19b1681
--- /dev/null
+++ b/design/chapters/07_typeindex/images/plantuml/overview.txt
@@ -0,0 +1,74 @@
+@startuml
+left header
+
+<font size=16>IDE2
+<font size=20>Type model and Xtext index
+<font size=16>Overview and principles of design
+
+
+endheader
+
+hide members
+
+class VariableDeclaration #Moccasin
+class ClassExpression #Moccasin
+class Module #Moccasin
+class TypeRef #SkyBlue
+class ParameterizedTypeRef #SkyBlue
+class DelegatingTypeRef #SkyBlue
+class Type #SkyBlue
+class TClass #SkyBlue
+class N4JSGlobalScopeProvider #yellow
+class N4JSTypeScope #yellow
+class N4JSGlobalScopeProvider #yellow
+class N4JSScopeProvider #yellow
+class N4JSDerivedStateComputer #yellow
+class N4JSResource #yellow
+class N4JSResourceDescriptionStrategy #yellow
+
+
+TypeRef "transient type ref" --* VariableDeclaration
+TypeRef *-- "typeArgs" ParameterizedTypeRef
+TypeRef <|- ParameterizedTypeRef 
+DelegatingTypeRef -|> TypeRef 
+DelegatingTypeRef --> "delegate" TypeRef
+ParameterizedTypeRef --> "raw type" Type
+Type <|-- TClass
+ClassExpression -> "defined type" TClass
+ClassExpression "definition" <-  TClass
+ClassExpression --* Module
+N4JSScopeProvider ..> "use" N4JSTypeScope
+TClass "create or reads" <.. N4JSTypeScope
+N4JSGlobalScopeProvider ..> XtextIndex.N4JSResourceDescription
+N4JSTypeScope "creates" <.. N4JSGlobalScopeProvider
+N4JSDerivedStateComputer "creates" ..> TClass
+ClassExpression "uses" <.. N4JSDerivedStateComputer
+XtextIndex.N4JSResourceDescription ..> N4JSResource
+N4JSDerivedStateComputer "uses" ..> N4JSResource
+Module --* "contents[0]" N4JSResource
+TClass --* "contents[1..n]"  N4JSResource
+N4JSScopeProvider -> "delegates" N4JSGlobalScopeProvider
+N4JSResourceDescriptionStrategy -> "creates" XtextIndex.EObjectDescription
+
+namespace XtextIndex {
+	class TClass<<Serialized>> #yellow
+	class EObjectDescription<<Serialized>> #white
+	class N4JSResourceDescription<<Serialized>> #yellow
+
+	TClass "user data" <--* EObjectDescription
+	EObjectDescription <--* N4JSResourceDescription
+	TClass <..> .TClass
+}
+
+(TypeRef, VariableDeclaration) "sets" <.. N4JSScopeProvider
+
+
+left footer
+
+<font size=12>- orange colored elements are from N4JS AST
+<font size=12>- blue colored elements are from types
+<font size=12>- white colored elements are from Xtext Framework
+<font size=12>- yellow colored elements are adapted elements
+end footer
+
+@enduml
\ No newline at end of file
diff --git a/design/chapters/07_typeindex/images/plantuml/writing_userdata.txt b/design/chapters/07_typeindex/images/plantuml/writing_userdata.txt
new file mode 100644
index 0000000..ec6d0d6
--- /dev/null
+++ b/design/chapters/07_typeindex/images/plantuml/writing_userdata.txt
@@ -0,0 +1 @@
+when is user data is produced and written?
\ No newline at end of file
diff --git a/design/chapters/07_typeindex/images/resource_set_load_states.png b/design/chapters/07_typeindex/images/resource_set_load_states.png
new file mode 100644
index 0000000..b2d0ffd
--- /dev/null
+++ b/design/chapters/07_typeindex/images/resource_set_load_states.png
Binary files differ
diff --git a/design/chapters/07_typeindex/images/sd_typesBuilder.png b/design/chapters/07_typeindex/images/sd_typesBuilder.png
new file mode 100644
index 0000000..c4a6610
--- /dev/null
+++ b/design/chapters/07_typeindex/images/sd_typesBuilder.png
Binary files differ
diff --git a/design/chapters/07_typeindex/images/sd_typesBuilder_problem.png b/design/chapters/07_typeindex/images/sd_typesBuilder_problem.png
new file mode 100644
index 0000000..bdba68b
--- /dev/null
+++ b/design/chapters/07_typeindex/images/sd_typesBuilder_problem.png
Binary files differ
diff --git a/design/chapters/07_typeindex/images/sd_typesBuilder_proxies.png b/design/chapters/07_typeindex/images/sd_typesBuilder_proxies.png
new file mode 100644
index 0000000..3cef959
--- /dev/null
+++ b/design/chapters/07_typeindex/images/sd_typesBuilder_proxies.png
Binary files differ
diff --git a/design/chapters/08_projectModel/images/cd_projectDescription.svg b/design/chapters/08_projectModel/images/cd_projectDescription.svg
new file mode 100644
index 0000000..91b0e51
--- /dev/null
+++ b/design/chapters/08_projectModel/images/cd_projectDescription.svg
@@ -0,0 +1,393 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xl="http://www.w3.org/1999/xlink" xmlns:dc="http://purl.org/dc/elements/1.1/" viewBox="-13.255906 13.673228 860.2992 435.6752" width="860.2992" height="435.6752">
+  <defs>
+    <font-face font-family="Helvetica" font-size="8" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="StickArrow_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -4 10 8" markerWidth="10" markerHeight="8" color="black">
+      <g>
+        <path d="M 8 0 L 0 0 M 0 -3 L 8 0 L 0 3" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <font-face font-family="Helvetica" font-size="12" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="FilledDiamond_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-9 -4 10 8" markerWidth="10" markerHeight="8" color="black">
+      <g>
+        <path d="M -8 0 L -4 3 L 0 0 L -4 -3 Z" fill="currentColor" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="UMLInheritance_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -8 14 16" markerWidth="14" markerHeight="16" color="black">
+      <g>
+        <path d="M 12 0 L 0 -7 L 0 7 Z" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <font-face font-family="Helvetica" font-size="12" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="532.22656" cap-height="719.7266" ascent="770.0195" descent="-229.98047" font-weight="700">
+      <font-face-src>
+        <font-face-name name="Helvetica-Bold"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="11" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="7" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="10" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+  </defs>
+  <metadata> Produced by OmniGraffle 7.11 
+    <dc:date>2019-08-02 07:06:57 +0000</dc:date>
+  </metadata>
+  <g id="Canvas_1" stroke="none" stroke-opacity="1" stroke-dasharray="none" fill="none" fill-opacity="1">
+    <title>Canvas 1</title>
+    <rect fill="white" x="0" y="13.673228" width="847.0433" height="435.6752"/>
+    <g id="Canvas_1: UML Elements">
+      <title>UML Elements</title>
+      <g id="Graphic_1153">
+        <text transform="translate(46.81121 297.6928)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="0" y="8">sourceContainerType</tspan>
+        </text>
+      </g>
+      <g id="Line_1152">
+        <line x1="44.83465" y1="262.3189" x2="44.83465" y2="308.4071" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_1151">
+        <text transform="translate(579.4389 147.13988)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="11">*</tspan>
+        </text>
+      </g>
+      <g id="Graphic_1150">
+        <text transform="translate(603.11855 152.83385)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="0" y="8">moduleSpecifiers</tspan>
+        </text>
+      </g>
+      <g id="Line_1149">
+        <line x1="594.63044" y1="115.9192" x2="594.82724" y2="159.39905" marker-end="url(#StickArrow_Marker)" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_1148">
+        <text transform="translate(623.6272 81.18413)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="0" y="8">moduleFilterType</tspan>
+        </text>
+      </g>
+      <g id="Line_1147">
+        <line x1="619.3386" y1="94.6693" x2="678.9189" y2="94.69456" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_1146">
+        <text transform="translate(713.7943 395.94797)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="0" y="8">type</tspan>
+        </text>
+      </g>
+      <g id="Line_1145">
+        <line x1="679.2992" y1="409.5935" x2="725.6906" y2="409.43305" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_1144">
+        <text transform="translate(214.501 381.39835)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="11">*</tspan>
+        </text>
+      </g>
+      <g id="Graphic_1143">
+        <text transform="translate(234.14942 380.41965) rotate(-90)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="0" y="8">testedProjects</tspan>
+        </text>
+      </g>
+      <g id="Line_1142">
+        <line x1="229.83595" y1="258.87848" x2="229.83595" y2="380.71612" marker-end="url(#StickArrow_Marker)" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_1141">
+        <text transform="translate(487.96243 96.19878)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="11">*</tspan>
+        </text>
+      </g>
+      <g id="Graphic_1140">
+        <text transform="translate(466.47735 81.19859)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="0" y="8">moduleFilters</tspan>
+        </text>
+      </g>
+      <g id="Line_1139">
+        <line x1="442.9508" y1="94.74527" x2="510.4386" y2="94.679" marker-end="url(#StickArrow_Marker)" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_1138">
+        <text transform="translate(110.36706 224.64593)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="1.7344499" y="11">*</tspan>
+        </text>
+      </g>
+      <g id="Graphic_1137">
+        <text transform="translate(106.43963 205.14835)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="0" y="8">sourceContainers</tspan>
+        </text>
+      </g>
+      <g id="Line_1136">
+        <line x1="179.81299" y1="218.6527" x2="112.3252" y2="218.6457" marker-end="url(#StickArrow_Marker)" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_1135">
+        <text transform="translate(255.27396 379.749)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="11">*</tspan>
+        </text>
+      </g>
+      <g id="Graphic_1134">
+        <text transform="translate(274.9224 382.0134) rotate(-90)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="0" y="8">implementedProjects</tspan>
+        </text>
+      </g>
+      <g id="Line_1133">
+        <line x1="270.60892" y1="258.87848" x2="270.60892" y2="380.71612" marker-end="url(#StickArrow_Marker)" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_1132">
+        <text transform="translate(512.0301 355.77896)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="11">*</tspan>
+        </text>
+      </g>
+      <g id="Graphic_1131">
+        <text transform="translate(528.9215 337.81197)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="0" y="8">projectDependencies</tspan>
+        </text>
+      </g>
+      <g id="Line_1130">
+        <line x1="439.01293" y1="226.22622" x2="535.12364" y2="363.2339" marker-end="url(#StickArrow_Marker)" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_1129">
+        <text transform="translate(296.04693 382.76234)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="11">*</tspan>
+        </text>
+      </g>
+      <g id="Graphic_1128">
+        <text transform="translate(315.69536 385.2966) rotate(-90)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="0" y="8">requiredRuntimeLibraries</tspan>
+        </text>
+      </g>
+      <g id="Line_1127">
+        <line x1="311.3819" y1="258.87848" x2="311.3819" y2="380.71612" marker-end="url(#StickArrow_Marker)" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_1126">
+        <text transform="translate(338.4789 382.0326)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="11">*</tspan>
+        </text>
+      </g>
+      <g id="Graphic_1125">
+        <text transform="translate(356.46833 384.9216) rotate(-90)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="0" y="8">providedRuntimeLibraries</tspan>
+        </text>
+      </g>
+      <g id="Line_1124">
+        <line x1="352.15486" y1="258.87848" x2="352.15486" y2="380.71612" marker-end="url(#StickArrow_Marker)" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_1123">
+        <text transform="translate(397.2413 383.96457) rotate(-90)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="0" y="8">extendedRuntimeEnvironment</tspan>
+        </text>
+      </g>
+      <g id="Line_1122">
+        <line x1="392.92782" y1="258.87848" x2="392.92782" y2="380.71612" marker-end="url(#StickArrow_Marker)" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_1121">
+        <text transform="translate(145.20178 81.21251)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="0" y="8">projectType</tspan>
+        </text>
+      </g>
+      <g id="Line_1120">
+        <line x1="189.06299" y1="94.75435" x2="151.80944" y2="94.68715" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_1119">
+        <path d="M 494.6457 409.5935 L 479.1457 409.5935 L 449.2008 410.0269 L 447.2008 410.0269" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Group_1116">
+        <g id="Graphic_1118">
+          <rect x="-12.755906" y="204.08662" width="115.1811" height="35.225534" fill="white"/>
+          <rect x="-12.755906" y="204.08662" width="115.1811" height="35.225534" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(-7.755906 209.08662)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="6.582737" y="11">SourceContaine</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="19.58469" y="25">Description</tspan>
+          </text>
+        </g>
+        <g id="Graphic_1117">
+          <rect x="-12.755906" y="239.31215" width="115.1811" height="23.006748" fill="white"/>
+          <rect x="-12.755906" y="239.31215" width="115.1811" height="23.006748" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(-7.755906 244.31215)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">+paths: String[*]</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_1111">
+        <g id="Graphic_1112">
+          <rect x="520.3386" y="82.66929" width="99" height="24" fill="white"/>
+          <rect x="520.3386" y="82.66929" width="99" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(525.3386 87.66929)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="8.833984" y="11">ModuleFilter</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_1108">
+        <g id="Graphic_1110">
+          <rect x="543.83465" y="195.17847" width="204.1496" height="38.819277" fill="white"/>
+          <rect x="543.83465" y="195.17847" width="204.1496" height="38.819277" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(548.83465 200.17847)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">+moduleSpecifierWithWildcard: String</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="23">+sourcePath: String</tspan>
+          </text>
+        </g>
+        <g id="Graphic_1109">
+          <rect x="543.83465" y="169.29895" width="204.1496" height="25.879518" fill="white"/>
+          <rect x="543.83465" y="169.29895" width="204.1496" height="25.879518" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(548.83465 174.29895)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="36.064064" y="11">ModuleFilterSpecifier</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_1105">
+        <g id="Graphic_1107">
+          <rect x="189.06299" y="422.8201" width="244.6378" height="26.02831" fill="white"/>
+          <rect x="189.06299" y="422.8201" width="244.6378" height="26.02831" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(194.06299 427.8201)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">+projectName: String</tspan>
+          </text>
+        </g>
+        <g id="Graphic_1106">
+          <rect x="189.06299" y="390.61612" width="244.6378" height="32.20397" fill="white"/>
+          <rect x="189.06299" y="390.61612" width="244.6378" height="32.20397" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(194.06299 395.61612)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="67.962456" y="11">ProjectReference</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_1102">
+        <g id="Graphic_1104">
+          <rect x="494.6457" y="371.3386" width="184.65355" height="30.60393" fill="white"/>
+          <rect x="494.6457" y="371.3386" width="184.65355" height="30.60393" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(499.6457 376.3386)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="31.30822" y="11">ProjectDependency</tspan>
+          </text>
+        </g>
+        <g id="Graphic_1103">
+          <rect x="494.6457" y="401.9425" width="184.65355" height="45.905893" fill="white"/>
+          <rect x="494.6457" y="401.9425" width="184.65355" height="45.905893" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(499.6457 406.9425)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">+versionRequirementString: String</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="23">+versionRequirement: </tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="36">NPMVersionRequirement</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_1099">
+        <g id="Graphic_1101">
+          <rect x="-10.641736" y="318.3071" width="110.95276" height="40.12048" fill="white"/>
+          <rect x="-10.641736" y="318.3071" width="110.95276" height="40.12048" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(-5.641736 323.3071)" fill="black">
+            <tspan font-family="Helvetica" font-size="7" font-weight="400" fill="black" x="37.82819" y="6">«enum»</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="2.1336098" y="19">SourceContainer</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="36.91486" y="33">Type</tspan>
+          </text>
+        </g>
+        <g id="Graphic_1100">
+          <rect x="-10.641736" y="358.42757" width="110.95276" height="49" fill="white"/>
+          <rect x="-10.641736" y="358.42757" width="110.95276" height="49" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(-5.641736 363.42757)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">SOURCE</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="23">TEST </tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="36">EXTERNAL</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_1096">
+        <g id="Graphic_1098">
+          <rect x="189.06299" y="87.25519" width="244.6378" height="162.3733" fill="white"/>
+          <rect x="189.06299" y="87.25519" width="244.6378" height="162.3733" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(194.06299 92.25519)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">+projectName: String</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="23">+vendorId: String</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="36">+vendorName: String</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="49">+projectVersion: VersionNumber</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="62">+mainModule: String</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="75">+implementationId: String</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="88">+outputPath: String</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="101">+definesPackage: String</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="114">+hasNestedNodeModulesFolder: boolean</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="127">+hasN4JSNature: boolean</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="140">+yarnWorkspaceRoot: boolean</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="153">+workspaces: String[*]</tspan>
+          </text>
+        </g>
+        <g id="Graphic_1097">
+          <rect x="189.06299" y="63.77953" width="244.6378" height="23.475657" fill="white"/>
+          <rect x="189.06299" y="63.77953" width="244.6378" height="23.475657" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(194.06299 68.77953)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="63.97222" y="11">ProjectDescription</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_1090">
+        <g id="Graphic_1092">
+          <rect x="735.5906" y="411.45907" width="110.95276" height="36" fill="white"/>
+          <rect x="735.5906" y="411.45907" width="110.95276" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(740.5906 416.45907)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">RUNTIME</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="23">DEVELOPMENT</tspan>
+          </text>
+        </g>
+        <g id="Graphic_1091">
+          <rect x="735.5906" y="371.3386" width="110.95276" height="40.12048" fill="white"/>
+          <rect x="735.5906" y="371.3386" width="110.95276" height="40.12048" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(740.5906 376.3386)" fill="black">
+            <tspan font-family="Helvetica" font-size="7" font-weight="400" fill="black" x="37.82819" y="6">«enum»</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="1.2371254" y="19">DependencyType</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_1218">
+        <g id="Graphic_1220">
+          <rect x="688.8189" y="63.13854" width="115.1811" height="40.12048" fill="white"/>
+          <rect x="688.8189" y="63.13854" width="115.1811" height="40.12048" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(693.8189 68.13854)" fill="black">
+            <tspan font-family="Helvetica" font-size="7" font-weight="400" fill="black" x="39.942356" y="6">«enum»</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="3.3630104" y="19">ModuleFilterType</tspan>
+          </text>
+        </g>
+        <g id="Graphic_1219">
+          <rect x="688.8189" y="103.25902" width="115.1811" height="23" fill="white"/>
+          <rect x="688.8189" y="103.25902" width="115.1811" height="23" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(693.8189 108.25902)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">NO_VALIDATE</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_1222">
+        <g id="Graphic_1224">
+          <rect x="-12.259843" y="41.54189" width="154.1693" height="133.62347" fill="white"/>
+          <rect x="-12.259843" y="41.54189" width="154.1693" height="133.62347" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(-7.259843 46.54189)" fill="black">
+            <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">PLAINJS</tspan>
+            <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="22">VALIDATION</tspan>
+            <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="34">DEFINITION</tspan>
+            <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="46">APPLICATION</tspan>
+            <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="58">PROCESSOR</tspan>
+            <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="70">LIBRARY</tspan>
+            <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="82">API</tspan>
+            <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="94">RUNTIME_ENVIRONMENT</tspan>
+            <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="106">RUNTIME_LIBRARY</tspan>
+            <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="118">TEST</tspan>
+          </text>
+        </g>
+        <g id="Graphic_1223">
+          <rect x="-12.259843" y="14.173228" width="154.1693" height="27.368662" fill="white"/>
+          <rect x="-12.259843" y="14.173228" width="154.1693" height="27.368662" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(-7.259843 19.173228)" fill="black">
+            <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="57.62957" y="8">«enum»</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="38.182304" y="21">ProjectType</tspan>
+          </text>
+        </g>
+      </g>
+    </g>
+  </g>
+</svg>
diff --git a/design/chapters/09_binding/images/cd_scoping.svg b/design/chapters/09_binding/images/cd_scoping.svg
new file mode 100644
index 0000000..da6bd66
--- /dev/null
+++ b/design/chapters/09_binding/images/cd_scoping.svg
@@ -0,0 +1,418 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xl="http://www.w3.org/1999/xlink" xmlns:dc="http://purl.org/dc/elements/1.1/" viewBox="16.5 36.5 1040 557" width="1040" height="557">
+  <defs>
+    <font-face font-family="Helvetica" font-size="9" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="StickArrow_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -4 10 8" markerWidth="10" markerHeight="8" color="black">
+      <g>
+        <path d="M 8 0 L 0 0 M 0 -3 L 8 0 L 0 3" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <font-face font-family="Helvetica" font-size="12" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="UMLInheritance_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -8 14 16" markerWidth="14" markerHeight="16" color="black">
+      <g>
+        <path d="M 12 0 L 0 -7 L 0 7 Z" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <font-face font-family="Helvetica" font-size="11" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="12" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="532.22656" cap-height="719.7266" ascent="770.0195" descent="-229.98047" font-weight="700">
+      <font-face-src>
+        <font-face-name name="Helvetica-Bold"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="12" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="-1e3" x-height="539.5508" cap-height="719.7266" ascent="770.0195" descent="-229.98047" font-style="italic" font-weight="700">
+      <font-face-src>
+        <font-face-name name="Helvetica-BoldOblique"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="10" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+  </defs>
+  <metadata> Produced by OmniGraffle 7.11 
+    <dc:date>2019-07-31 10:43:09 +0000</dc:date>
+  </metadata>
+  <g id="Canvas_1" stroke="none" stroke-opacity="1" stroke-dasharray="none" fill="none" fill-opacity="1">
+    <title>Canvas 1</title>
+    <rect fill="white" x="16.5" y="36.5" width="1040" height="557"/>
+    <g id="Canvas_1: scoping">
+      <title>scoping</title>
+      <g id="Graphic_576">
+        <path d="M 1056 82.9688 C 1056 79.93744 1054.9586 79.5624 1047.3515 76.5624 L 1047.2711 76.53136 C 1039.6238 73.5 1039.5442 73.5 1031.696 73.5 C 1021.246 73.5 974 73.5 974 73.5 L 974 105.5 L 1056 105.5 L 1056 82.9688 Z" fill="white"/>
+        <path d="M 1056 82.9688 C 1056 79.93744 1054.9586 79.5624 1047.3515 76.5624 L 1047.2711 76.53136 C 1039.6238 73.5 1039.5442 73.5 1031.696 73.5 C 1021.246 73.5 974 73.5 974 73.5 L 974 105.5 L 1056 105.5 L 1056 82.9688 Z M 1056 82.81264 C 1056 79.93744 1055.9196 79.93744 1039.5442 79.93744 L 1039.5442 79.93744 C 1039.5442 73.53136 1039.5442 73.5 1032.1765 73.5" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(979 78.5)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="0" y="9">Scoping, </tspan>
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="0" y="20">Overview</tspan>
+        </text>
+      </g>
+      <g id="Line_575">
+        <line x1="734" y1="492.99643" x2="835.3756" y2="492.99643" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_574">
+        <line x1="655.9393" y1="420.9964" x2="689.83705" y2="365.45066" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_573">
+        <line x1="586.9926" y1="420.9964" x2="554.4675" y2="327.35197" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_572">
+        <line x1="534.6281" y1="420.9964" x2="431.1945" y2="324.74424" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_571">
+        <line x1="709.4416" y1="420.9964" x2="896.3578" y2="282.8833" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_570">
+        <line x1="133.83758" y1="412.9974" x2="179.14296" y2="326.76406" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_569">
+        <line x1="402.1013" y1="239" x2="416.8206" y2="210.77786" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_568">
+        <line x1="504.9806" y1="239" x2="480.81174" y2="209.64306" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_567">
+        <path d="M 353 540.46 L 452 520 L 452 399 L 409.6093 326.54497" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_566">
+        <line x1="734" y1="455.40127" x2="858.5439" y2="417.0222" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_565">
+        <text transform="translate(733.2793 420.10876)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="11">-_n4JSTypesScopeFilter</tspan>
+        </text>
+      </g>
+      <g id="Graphic_564"/>
+      <g id="Line_562">
+        <path d="M 116.5 478.9974 L 116.5 509.4974 L 227 509.4974 L 227 526.5" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_561">
+        <path d="M 316.3427 466.49643 L 316.3427 481.99643 L 316.3427 502.9964 L 250.72404 502.9964 L 250.72404 524.5 L 250.72404 526.5" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Group_556">
+        <g id="Graphic_559">
+          <rect x="845.2756" y="504.4964" width="180" height="15" fill="white"/>
+          <rect x="845.2756" y="504.4964" width="180" height="15" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(850.2756 505.4964)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">+getTypes()</tspan>
+          </text>
+        </g>
+        <g id="Graphic_558">
+          <rect x="845.2756" y="490.49643" width="180" height="14" fill="white"/>
+          <rect x="845.2756" y="490.49643" width="180" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_557">
+          <rect x="845.2756" y="466.49643" width="180" height="24" fill="white"/>
+          <rect x="845.2756" y="466.49643" width="180" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(850.6076 471.49643)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="0" y="11">AmbiguousImportDescription</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_549">
+        <g id="Graphic_552">
+          <rect x="490" y="458.9964" width="244" height="106" fill="white"/>
+          <rect x="490" y="458.9964" width="244" height="106" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(495 459.9964)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">#delegateGetScope(..)</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="23">+getScope(..)</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="36">+scope_LabelledStatement(..)</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="49">+scope_ImportedModule(..)</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="62">+scope_ImportedElement(..)</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="75">+scope_IdentifierRef_id(..)</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="88">+scope_PropertyAccessExpression_property(..)</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="101">...</tspan>
+          </text>
+        </g>
+        <g id="Graphic_551">
+          <rect x="490" y="444.9964" width="244" height="14" fill="white"/>
+          <rect x="490" y="444.9964" width="244" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_550">
+          <rect x="490" y="420.9964" width="244" height="24" fill="white"/>
+          <rect x="490" y="420.9964" width="244" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(495 425.9964)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="59.64258" y="11">N4JSScopeProvider</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_535">
+        <g id="Graphic_538">
+          <rect x="137" y="277" width="135" height="41" fill="white"/>
+          <rect x="137" y="277" width="135" height="41" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(142 278)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">+createScope(..)</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="23">+createScope(..)</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="36">+getSingleElement(..)</tspan>
+          </text>
+        </g>
+        <g id="Graphic_537">
+          <rect x="137" y="263" width="135" height="14" fill="white"/>
+          <rect x="137" y="263" width="135" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_536">
+          <rect x="137" y="239" width="135" height="24" fill="white"/>
+          <rect x="137" y="239" width="135" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(142.24414 244)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="0" y="11">UserDataAwareScope</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_528">
+        <g id="Graphic_531">
+          <rect x="17" y="450.9974" width="199" height="28" fill="white"/>
+          <rect x="17" y="450.9974" width="199" height="28" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(22 451.9974)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">#createContainerScope(..)</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="23">#createContainerScopeWithContext(..)</tspan>
+          </text>
+        </g>
+        <g id="Graphic_530">
+          <rect x="17" y="436.9974" width="199" height="14" fill="white"/>
+          <rect x="17" y="436.9974" width="199" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_529">
+          <rect x="17" y="412.9974" width="199" height="24" fill="white"/>
+          <rect x="17" y="412.9974" width="199" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(22 417.9974)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="18.47461" y="11">N4JSGlobalScopeProvider</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_521">
+        <g id="Graphic_524">
+          <rect x="864" y="399.1067" width="180" height="15" fill="white"/>
+          <rect x="864" y="399.1067" width="180" height="15" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(869 400.1067)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">#getTypeReferenceFilterCriteria(..)</tspan>
+          </text>
+        </g>
+        <g id="Graphic_523">
+          <rect x="864" y="385.1067" width="180" height="14" fill="white"/>
+          <rect x="864" y="385.1067" width="180" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_522">
+          <rect x="864" y="361.1067" width="180" height="24" fill="white"/>
+          <rect x="864" y="361.1067" width="180" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(869 366.1067)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="20.417969" y="11">N4JSTypesScopeFilter</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_514">
+        <g id="Graphic_517">
+          <rect x="321" y="277" width="121" height="41" fill="white"/>
+          <rect x="321" y="277" width="121" height="41" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(326 278)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">#createDescriptions(..)</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="23">+getAny()</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="36"> and other types</tspan>
+          </text>
+        </g>
+        <g id="Graphic_516">
+          <rect x="321" y="263" width="121" height="14" fill="white"/>
+          <rect x="321" y="263" width="121" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_515">
+          <rect x="321" y="239" width="121" height="24" fill="white"/>
+          <rect x="321" y="239" width="121" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(326 244)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="5.270508" y="11">BuiltInTypeScope</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_507">
+        <g id="Graphic_510">
+          <rect x="238" y="451.49643" width="204" height="15" fill="white"/>
+          <rect x="238" y="451.49643" width="204" height="15" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(243 452.49643)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">#getScope(..)</tspan>
+          </text>
+        </g>
+        <g id="Graphic_509">
+          <rect x="238" y="437.49643" width="204" height="14" fill="white"/>
+          <rect x="238" y="437.49643" width="204" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_508">
+          <rect x="238" y="413.49643" width="204" height="24" fill="white"/>
+          <rect x="238" y="413.49643" width="204" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(243.42285 418.49643)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="0" y="11">BuiltInTypesGlobalScopeProvider</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_493">
+        <g id="Graphic_496">
+          <rect x="477" y="277" width="121" height="41" fill="white"/>
+          <rect x="477" y="277" width="121" height="41" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(482 278)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">#createDescriptions(..)</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="23">+accept(..)</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="36">+getGlobalObject()</tspan>
+          </text>
+        </g>
+        <g id="Graphic_495">
+          <rect x="477" y="263" width="121" height="14" fill="white"/>
+          <rect x="477" y="263" width="121" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_494">
+          <rect x="477" y="239" width="121" height="24" fill="white"/>
+          <rect x="477" y="239" width="121" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(482.1553 244)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="0" y="11">GlobalObjectScope</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_486">
+        <g id="Graphic_489">
+          <rect x="355.5" y="161" width="173" height="41" fill="white"/>
+          <rect x="355.5" y="161" width="173" height="41" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(360.5 162)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">#delegate()</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="23">#loadScopeContent()</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="36">#createDescriptions(..)</tspan>
+          </text>
+        </g>
+        <g id="Graphic_488">
+          <rect x="355.5" y="147" width="173" height="14" fill="white"/>
+          <rect x="355.5" y="147" width="173" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_487">
+          <rect x="355.5" y="123" width="173" height="24" fill="white"/>
+          <rect x="355.5" y="123" width="173" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(360.98242 128)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-style="italic" font-weight="700" fill="black" x="0" y="11">LazyEObjectDescriptionMap</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_479">
+        <g id="Graphic_482">
+          <rect x="101" y="578" width="252" height="15" fill="white"/>
+          <rect x="101" y="578" width="252" height="15" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(106 579)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">#getScope(..)</tspan>
+          </text>
+        </g>
+        <g id="Graphic_481">
+          <rect x="101" y="564" width="252" height="14" fill="white"/>
+          <rect x="101" y="564" width="252" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_480">
+          <rect x="101" y="540" width="252" height="24" fill="white"/>
+          <rect x="101" y="540" width="252" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(106.08301 545)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-style="italic" font-weight="700" fill="black" x="0" y="11">AbstractBuiltInTypesGlobalScopeProvider</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_472">
+        <g id="Graphic_475">
+          <rect x="591" y="75" width="310" height="67" fill="white"/>
+          <rect x="591" y="75" width="310" height="67" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(596 76)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">#internalGetAllDescriptions(..)</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="23">+iterator()</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="36">#getImplicitImports(..)</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="49">#getImportedNamespaceResolvers(..)</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="62">#getLocalElementsScope(..)</tspan>
+          </text>
+        </g>
+        <g id="Graphic_474">
+          <rect x="591" y="61" width="310" height="14" fill="white"/>
+          <rect x="591" y="61" width="310" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_473">
+          <rect x="591" y="37" width="310" height="24" fill="white"/>
+          <rect x="591" y="37" width="310" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(596.0469 42)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="0" y="11">N4JSImportedNamespaceAwareLocalScopeProvider</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_465">
+        <g id="Graphic_468">
+          <rect x="638.5" y="277" width="185" height="80" fill="white"/>
+          <rect x="638.5" y="277" width="185" height="80" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(643.5 278)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">+create(..)</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="23">+create(..)</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="36">#getAllLocalElements()</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="49">#getLocalElementsByEObject(..)</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="62">#getLocalElementsByName(..)</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="75">#getSingleLocalElementByName(..)</tspan>
+          </text>
+        </g>
+        <g id="Graphic_467">
+          <rect x="638.5" y="263" width="185" height="14" fill="white"/>
+          <rect x="638.5" y="263" width="185" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_466">
+          <rect x="638.5" y="239" width="185" height="24" fill="white"/>
+          <rect x="638.5" y="239" width="185" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(643.5 244)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="46.487305" y="11">MemberScope</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_458">
+        <g id="Graphic_460">
+          <rect x="868.0338" y="263" width="124" height="14" fill="white"/>
+          <rect x="868.0338" y="263" width="124" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_459">
+          <rect x="868.0338" y="239" width="124" height="24" fill="white"/>
+          <rect x="868.0338" y="239" width="124" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(873.3531 244)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="0" y="11">N4JSFilteringScope</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Graphic_577">
+        <rect x="464.24855" y="364.5106" width="43" height="22" fill="white"/>
+        <text transform="translate(469.6255 369.5106)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«uses»</tspan>
+        </text>
+      </g>
+      <g id="Graphic_578">
+        <rect x="649.0254" y="381.1793" width="49" height="22" fill="white"/>
+        <text transform="translate(654.0674 386.1793)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«create»</tspan>
+        </text>
+      </g>
+      <g id="Graphic_579">
+        <rect x="546.272" y="354.6576" width="43" height="22" fill="white"/>
+        <text transform="translate(551.649 359.6576)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«uses»</tspan>
+        </text>
+      </g>
+      <g id="Graphic_580">
+        <rect x="845.3349" y="287.75102" width="49" height="22" fill="white"/>
+        <text transform="translate(850.3769 292.75102)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«create»</tspan>
+        </text>
+      </g>
+      <g id="Graphic_581">
+        <rect x="134.42292" y="354.2505" width="49" height="22" fill="white"/>
+        <text transform="translate(139.46491 359.2505)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«create»</tspan>
+        </text>
+      </g>
+      <g id="Graphic_582">
+        <rect x="409.41497" y="360.6348" width="59" height="32" fill="white"/>
+        <text transform="translate(414.41497 365.6348)" fill="black"/>
+      </g>
+    </g>
+  </g>
+</svg>
diff --git a/design/chapters/09_binding/images/memberscope_example.svg b/design/chapters/09_binding/images/memberscope_example.svg
new file mode 100644
index 0000000..7af2104
--- /dev/null
+++ b/design/chapters/09_binding/images/memberscope_example.svg
@@ -0,0 +1,164 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xl="http://www.w3.org/1999/xlink" xmlns:dc="http://purl.org/dc/elements/1.1/" viewBox="11 46.5 493.5 443.5" width="493.5" height="443.5">
+  <defs>
+    <font-face font-family="Helvetica Neue" font-size="16" panose-1="2 0 5 3 0 0 0 2 0 4" units-per-em="1000" underline-position="-100" underline-thickness="50" slope="0" x-height="517" cap-height="714" ascent="951.9958" descent="-212.99744" font-weight="400">
+      <font-face-src>
+        <font-face-name name="HelveticaNeue"/>
+      </font-face-src>
+    </font-face>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="FilledArrow_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -4 10 8" markerWidth="10" markerHeight="8" color="black">
+      <g>
+        <path d="M 8 0 L 0 -3 L 0 3 Z" fill="currentColor" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <clipPath id="inner_stroke_clip_path">
+      <path d="M 11 137.5 L 246 137.5 L 246 192.5 L 11 192.5 Z"/>
+    </clipPath>
+    <font-face font-family="Monaco" font-size="11" units-per-em="1000" underline-position="-37.597656" underline-thickness="75.68359" slope="0" x-height="545.41016" cap-height="757.8125" ascent="1e3" descent="-250" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Monaco"/>
+      </font-face-src>
+    </font-face>
+    <clipPath id="inner_stroke_clip_path_2">
+      <path d="M 50.5 237.25 L 226.5 237.25 L 226.5 277.25 L 50.5 277.25 Z"/>
+    </clipPath>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="Arrow_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -4 10 8" markerWidth="10" markerHeight="8" color="black">
+      <g>
+        <path d="M 8 0 L 0 -3 L 0 3 Z" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <clipPath id="inner_stroke_clip_path_3">
+      <path d="M 14.5 332.75 L 242.5 332.75 L 242.5 372.75 L 14.5 372.75 Z"/>
+    </clipPath>
+    <clipPath id="inner_stroke_clip_path_4">
+      <path d="M 13.5 440.75 L 241.5 440.75 L 241.5 480.75 L 13.5 480.75 Z"/>
+    </clipPath>
+  </defs>
+  <metadata> Produced by OmniGraffle 7.11 
+    <dc:date>2017-02-27 13:38:36 +0000</dc:date>
+  </metadata>
+  <g id="Canvas_1" stroke="none" stroke-opacity="1" stroke-dasharray="none" fill="none" fill-opacity="1">
+    <title>Canvas 1</title>
+    <rect fill="white" x="11" y="46.5" width="493.5" height="443.5"/>
+    <g id="Canvas_1: Layer 1">
+      <title>Layer 1</title>
+      <g id="Graphic_6">
+        <rect x="365.5" y="47" width="110" height="48.5" fill="white"/>
+        <rect x="365.5" y="47" width="110" height="48.5" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(370.5 62.026)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="400" fill="black" x="5.4" y="15">NULL scope</tspan>
+        </text>
+      </g>
+      <g id="Graphic_7">
+        <rect x="359.5" y="137.5" width="122" height="48.5" fill="white"/>
+        <rect x="359.5" y="137.5" width="122" height="48.5" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(364.5 143.302)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="400" fill="black" x="3.096" y="15">MemberScope</tspan>
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="400" fill="black" x="22.064" y="33.448">N4Object</tspan>
+        </text>
+      </g>
+      <g id="Line_8">
+        <path d="M 421.04325 137.5 C 421.11486 131.9096 421.16406 125.52947 421.16406 118.55078 C 421.16406 114.00821 421.1432 109.5905 421.1089 105.39599" marker-end="url(#FilledArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_9">
+        <rect x="359.5" y="233" width="122" height="48.5" fill="white"/>
+        <rect x="359.5" y="233" width="122" height="48.5" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(364.5 238.802)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="400" fill="black" x="3.096" y="15">MemberScope</tspan>
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="400" fill="black" x="50.224" y="33.448">C</tspan>
+        </text>
+      </g>
+      <g id="Line_10">
+        <line x1="420.5" y1="233" x2="420.5" y2="195.9" marker-end="url(#FilledArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_15">
+        <rect x="359.5" y="328.5" width="122" height="48.5" fill="white"/>
+        <rect x="359.5" y="328.5" width="122" height="48.5" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(364.5 334.302)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="400" fill="black" x="4.896" y="15">VisibilityAware</tspan>
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="400" fill="black" x="3.096" y="33.448">MemberScope</tspan>
+        </text>
+      </g>
+      <g id="Line_16">
+        <line x1="420.5" y1="328.5" x2="420.5" y2="291.4" marker-end="url(#FilledArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_17">
+        <rect x="337" y="432" width="167" height="57.5" fill="white"/>
+        <rect x="337" y="432" width="167" height="57.5" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(342 442.302)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="400" fill="black" x="2.948" y="15">TypingStrategyAware</tspan>
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="400" fill="black" x="25.596" y="33.448">MemberScope</tspan>
+        </text>
+      </g>
+      <g id="Line_18">
+        <line x1="420.5" y1="432" x2="420.5" y2="386.9" marker-end="url(#FilledArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_19">
+        <rect x="11" y="137.5" width="235" height="55" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="2" clip-path="url(#inner_stroke_clip_path)"/>
+        <text transform="translate(16 142.5)" fill="black">
+          <tspan font-family="Monaco" font-size="11" font-weight="400" fill="black" x="0" y="11">constructor -&gt; EObjectDescription </tspan>
+          <tspan font-family="Monaco" font-size="11" font-weight="400" fill="black" x="0" y="25.918457">toString    -&gt; EObjectDescription </tspan>
+          <tspan font-family="Monaco" font-size="11" font-weight="400" fill="black" x="0" y="40.836914">…</tspan>
+        </text>
+      </g>
+      <g id="Graphic_33">
+        <rect x="50.5" y="237.25" width="176" height="40" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="2" clip-path="url(#inner_stroke_clip_path_2)"/>
+        <text transform="translate(55.5 242.25)" fill="black">
+          <tspan font-family="Monaco" font-size="11" font-weight="400" fill="black" x="0" y="11">m1 -&gt; EObjectDescription </tspan>
+          <tspan font-family="Monaco" font-size="11" font-weight="400" fill="black" x="0" y="25.918457">m2 -&gt; EObjectDescription</tspan>
+        </text>
+      </g>
+      <g id="Line_39">
+        <line x1="358.5" y1="164" x2="255.8999" y2="164.44609" marker-end="url(#Arrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_49">
+        <text transform="translate(260.5 137.5)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="400" fill="black" x="3.428" y="15">exposes</tspan>
+        </text>
+      </g>
+      <g id="Line_53">
+        <line x1="359.5" y1="257.25" x2="236.4" y2="257.25" marker-end="url(#Arrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_54">
+        <text transform="translate(260.5 232)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="400" fill="black" x="3.428" y="15">exposes</tspan>
+        </text>
+      </g>
+      <g id="Graphic_55">
+        <rect x="14.5" y="332.75" width="228" height="40" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="2" clip-path="url(#inner_stroke_clip_path_3)"/>
+        <text transform="translate(19.5 337.75)" fill="black">
+          <tspan font-family="Monaco" font-size="11" font-weight="400" fill="black" x="0" y="11">m1 -&gt; </tspan>
+          <tspan font-family="Monaco" font-size="11" font-weight="400" fill="black" y="11">InvisibleMemberDescription</tspan>
+          <tspan font-family="Monaco" font-size="11" font-weight="400" fill="black" y="11"> </tspan>
+          <tspan font-family="Monaco" font-size="11" font-weight="400" fill="black" x="0" y="25.918457">m2 -&gt; EObjectDescription</tspan>
+        </text>
+      </g>
+      <g id="Line_59">
+        <line x1="359.5" y1="352.75" x2="252.4" y2="352.75" marker-end="url(#Arrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_60">
+        <text transform="translate(260.5 437)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="400" fill="black" x="3.428" y="15">exposes</tspan>
+        </text>
+      </g>
+      <g id="Graphic_61">
+        <rect x="13.5" y="440.75" width="228" height="40" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="2" clip-path="url(#inner_stroke_clip_path_4)"/>
+        <text transform="translate(18.5 445.75)" fill="black">
+          <tspan font-family="Monaco" font-size="11" font-weight="400" fill="black" x="0" y="11">m1 -&gt; </tspan>
+          <tspan font-family="Monaco" font-size="11" font-weight="400" fill="black" y="11">InvisibleMemberDescription</tspan>
+          <tspan font-family="Monaco" font-size="11" font-weight="400" fill="black" y="11"> </tspan>
+          <tspan font-family="Monaco" font-size="11" font-weight="400" fill="black" x="0" y="25.918457">m2 -&gt; EObjectDescription</tspan>
+        </text>
+      </g>
+      <g id="Line_62">
+        <line x1="337" y1="460.75" x2="251.4" y2="460.75" marker-end="url(#Arrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_63">
+        <text transform="translate(260.5 326.5)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="400" fill="black" x="3.428" y="15">exposes</tspan>
+        </text>
+      </g>
+    </g>
+  </g>
+</svg>
diff --git a/design/chapters/09_binding/images/scope_hierarchies.svg b/design/chapters/09_binding/images/scope_hierarchies.svg
new file mode 100644
index 0000000..a401357
--- /dev/null
+++ b/design/chapters/09_binding/images/scope_hierarchies.svg
@@ -0,0 +1,169 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xl="http://www.w3.org/1999/xlink" xmlns:dc="http://purl.org/dc/elements/1.1/" viewBox="52.5 41.5 454 469" width="454" height="469">
+  <defs>
+    <font-face font-family="Helvetica" font-size="12" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="12" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="532.22656" cap-height="719.7266" ascent="770.0195" descent="-229.98047" font-weight="700">
+      <font-face-src>
+        <font-face-name name="Helvetica-Bold"/>
+      </font-face-src>
+    </font-face>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="UMLInheritance_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -8 14 16" markerWidth="14" markerHeight="16" color="black">
+      <g>
+        <path d="M 12 0 L 0 -7 L 0 7 Z" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="StickArrow_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -4 10 8" markerWidth="10" markerHeight="8" color="black">
+      <g>
+        <path d="M 8 0 L 0 0 M 0 -3 L 8 0 L 0 3" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <font-face font-family="Helvetica" font-size="10" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="8" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+  </defs>
+  <metadata> Produced by OmniGraffle 7.11 
+    <dc:date>2013-10-15 10:32:03 +0000</dc:date>
+  </metadata>
+  <g id="Canvas_1" stroke="none" stroke-opacity="1" stroke-dasharray="none" fill="none" fill-opacity="1">
+    <title>Canvas 1</title>
+    <rect fill="white" x="52.5" y="41.5" width="454" height="469"/>
+    <g id="Canvas_1: Layer 1">
+      <title>Layer 1</title>
+      <g id="Group_149">
+        <g id="Graphic_151">
+          <rect x="53" y="42" width="133.23508" height="22.135802" fill="white"/>
+          <rect x="53" y="42" width="133.23508" height="22.135802" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(58 46.0679)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="25.5941" y="11">Global Scope</tspan>
+          </text>
+        </g>
+        <g id="Graphic_150">
+          <rect x="53" y="62.12346" width="453" height="305.87654" fill="white"/>
+          <rect x="53" y="62.12346" width="453" height="305.87654" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+      </g>
+      <g id="Graphic_163">
+        <rect x="209" y="73" width="99" height="48" fill="white"/>
+        <rect x="209" y="73" width="99" height="48" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(214 76)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="5.4941406" y="11">Global Object </tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="15.15918" y="25">properties </tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="27.15918" y="39">scope</tspan>
+        </text>
+      </g>
+      <g id="Graphic_164">
+        <rect x="209" y="162" width="99" height="36" fill="white"/>
+        <rect x="209" y="162" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(214 166)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="6.4990234" y="11">Built-in types </tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="27.15918" y="25">scope</tspan>
+        </text>
+      </g>
+      <g id="Graphic_165">
+        <rect x="209" y="241" width="99" height="36" fill="white"/>
+        <rect x="209" y="241" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(214 245)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="16.498047" y="11">Container </tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="27.15918" y="25">scope</tspan>
+        </text>
+      </g>
+      <g id="Graphic_166">
+        <rect x="53" y="380.5" width="99" height="48" fill="white"/>
+        <rect x="53" y="380.5" width="99" height="48" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(58 383.5)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="21.481445" y="11">Variable </tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="7.829102" y="25">Environment</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="23.822266" y="39">scopes</tspan>
+        </text>
+      </g>
+      <g id="Graphic_167">
+        <rect x="395" y="241" width="99" height="36" fill="white"/>
+        <rect x="395" y="241" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(400 252)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="28.8291" y="11">Index</tspan>
+        </text>
+      </g>
+      <g id="Line_168">
+        <line x1="258.5" y1="162" x2="258.5" y2="134.5" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_169">
+        <line x1="258.5" y1="241" x2="258.5" y2="211.5" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_170">
+        <line x1="152" y1="404.5" x2="195.50002" y2="404.5" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_457">
+        <line x1="308" y1="259" x2="385.1" y2="259" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_272">
+        <text transform="translate(333.9927 246)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«filters»</tspan>
+        </text>
+      </g>
+      <g id="Graphic_458">
+        <rect x="407" y="386.5" width="99" height="36" fill="white"/>
+        <rect x="407" y="386.5" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(412 397.5)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="7.928711" y="11">Types Scope</tspan>
+        </text>
+      </g>
+      <g id="Graphic_152">
+        <rect x="209.00002" y="382" width="99" height="45" fill="white"/>
+        <rect x="209.00002" y="382" width="99" height="45" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(214.00002 392.5)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="25.822266" y="8">«abstract»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="9.15625" y="21">Local Scope</tspan>
+        </text>
+      </g>
+      <g id="Graphic_459">
+        <rect x="209.00002" y="314.5" width="99" height="36" fill="white"/>
+        <rect x="209.00002" y="314.5" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(214.00002 325.5)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="6.1621094" y="11">Import Scope</tspan>
+        </text>
+      </g>
+      <g id="Line_460">
+        <line x1="407" y1="404.5" x2="321.5" y2="404.5" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_461">
+        <line x1="258.5" y1="382" x2="258.5" y2="364" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_462">
+        <line x1="258.5" y1="314.5" x2="258.5" y2="290.5" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_464">
+        <rect x="407" y="474" width="99" height="36" fill="white"/>
+        <rect x="407" y="474" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(412 478)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="16.158203" y="11">Validating</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="27.15918" y="25">scope</tspan>
+        </text>
+      </g>
+      <g id="Line_466">
+        <line x1="456.5" y1="474" x2="456.5" y2="436" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_467">
+        <rect x="209.00002" y="474" width="99" height="36" fill="white"/>
+        <rect x="209.00002" y="474" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(214.00002 485)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="2.4853516" y="11">Member scope</tspan>
+        </text>
+      </g>
+      <g id="Line_468">
+        <line x1="258.5" y1="474" x2="258.5" y2="440.5" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+    </g>
+  </g>
+</svg>
diff --git a/design/chapters/09_binding/images/unionmemberscope_example.svg b/design/chapters/09_binding/images/unionmemberscope_example.svg
new file mode 100644
index 0000000..62fbd37
--- /dev/null
+++ b/design/chapters/09_binding/images/unionmemberscope_example.svg
@@ -0,0 +1,282 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xl="http://www.w3.org/1999/xlink" xmlns:dc="http://purl.org/dc/elements/1.1/" viewBox="20.5 46.5 1082.5 569" width="1082.5" height="569">
+  <defs>
+    <font-face font-family="Helvetica Neue" font-size="16" panose-1="2 0 5 3 0 0 0 2 0 4" units-per-em="1000" underline-position="-100" underline-thickness="50" slope="0" x-height="517" cap-height="714" ascent="951.9958" descent="-212.99744" font-weight="400">
+      <font-face-src>
+        <font-face-name name="HelveticaNeue"/>
+      </font-face-src>
+    </font-face>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="FilledArrow_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -4 10 8" markerWidth="10" markerHeight="8" color="black">
+      <g>
+        <path d="M 8 0 L 0 -3 L 0 3 Z" fill="currentColor" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <clipPath id="inner_stroke_clip_path">
+      <path d="M 41 237.25 L 210 237.25 L 210 277.25 L 41 277.25 Z"/>
+    </clipPath>
+    <font-face font-family="Monaco" font-size="11" units-per-em="1000" underline-position="-37.597656" underline-thickness="75.68359" slope="0" x-height="545.41016" cap-height="757.8125" ascent="1e3" descent="-250" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Monaco"/>
+      </font-face-src>
+    </font-face>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="Arrow_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -4 10 8" markerWidth="10" markerHeight="8" color="black">
+      <g>
+        <path d="M 8 0 L 0 -3 L 0 3 Z" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <clipPath id="inner_stroke_clip_path_2">
+      <path d="M 20.5 332.75 L 242.5 332.75 L 242.5 372.75 L 20.5 372.75 Z"/>
+    </clipPath>
+    <clipPath id="inner_stroke_clip_path_3">
+      <path d="M 873.5 332.75 L 1101.5 332.75 L 1101.5 372.75 L 873.5 372.75 Z"/>
+    </clipPath>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="FilledDiamond_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -4 10 8" markerWidth="10" markerHeight="8" color="black">
+      <g>
+        <path d="M 8 0 L 4 -3 L 0 0 L 4 3 Z" fill="currentColor" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <clipPath id="inner_stroke_clip_path_4">
+      <path d="M 875 237.25 L 1103 237.25 L 1103 277.25 L 875 277.25 Z"/>
+    </clipPath>
+    <clipPath id="inner_stroke_clip_path_5">
+      <path d="M 20.5 440.75 L 242.5 440.75 L 242.5 480.75 L 20.5 480.75 Z"/>
+    </clipPath>
+    <clipPath id="inner_stroke_clip_path_6">
+      <path d="M 873.5 440.75 L 1101.5 440.75 L 1101.5 480.75 L 873.5 480.75 Z"/>
+    </clipPath>
+    <clipPath id="inner_stroke_clip_path_7">
+      <path d="M 754 567.5 L 1009 567.5 L 1009 607.5 L 754 607.5 Z"/>
+    </clipPath>
+  </defs>
+  <metadata> Produced by OmniGraffle 7.11 
+    <dc:date>2017-03-01 14:37:38 +0000</dc:date>
+  </metadata>
+  <g id="Canvas_1" stroke="none" stroke-opacity="1" stroke-dasharray="none" fill="none" fill-opacity="1">
+    <title>Canvas 1</title>
+    <rect fill="white" x="20.5" y="46.5" width="1082.5" height="569"/>
+    <g id="Canvas_1: Layer 1">
+      <title>Layer 1</title>
+      <g id="Graphic_6">
+        <rect x="365.5" y="47" width="110" height="48.5" fill="white"/>
+        <rect x="365.5" y="47" width="110" height="48.5" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(370.5 62.026)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="400" fill="black" x="5.4" y="15">NULL scope</tspan>
+        </text>
+      </g>
+      <g id="Graphic_7">
+        <rect x="359.5" y="137.5" width="122" height="48.5" fill="white"/>
+        <rect x="359.5" y="137.5" width="122" height="48.5" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(364.5 143.302)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="400" fill="black" x="3.096" y="15">MemberScope</tspan>
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="400" fill="black" x="22.064" y="33.448">N4Object</tspan>
+        </text>
+      </g>
+      <g id="Line_8">
+        <path d="M 421.04325 137.5 C 421.11486 131.9096 421.16406 125.52947 421.16406 118.55078 C 421.16406 114.00821 421.1432 109.5905 421.1089 105.39599" marker-end="url(#FilledArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_9">
+        <rect x="359.5" y="233" width="122" height="48.5" fill="white"/>
+        <rect x="359.5" y="233" width="122" height="48.5" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(364.5 238.802)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="400" fill="black" x="3.096" y="15">MemberScope</tspan>
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="400" fill="black" x="50.224" y="33.448">C</tspan>
+        </text>
+      </g>
+      <g id="Line_10">
+        <line x1="420.5" y1="233" x2="420.5" y2="195.9" marker-end="url(#FilledArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_15">
+        <rect x="359.5" y="328.5" width="122" height="48.5" fill="white"/>
+        <rect x="359.5" y="328.5" width="122" height="48.5" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(364.5 334.302)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="400" fill="black" x="4.896" y="15">VisibilityAware</tspan>
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="400" fill="black" x="3.096" y="33.448">MemberScope</tspan>
+        </text>
+      </g>
+      <g id="Line_16">
+        <line x1="420.5" y1="328.5" x2="420.5" y2="291.4" marker-end="url(#FilledArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_17">
+        <rect x="337" y="432" width="167" height="57.5" fill="white"/>
+        <rect x="337" y="432" width="167" height="57.5" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(342 442.302)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="400" fill="black" x="2.948" y="15">TypingStrategyAware</tspan>
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="400" fill="black" x="25.596" y="33.448">MemberScope</tspan>
+        </text>
+      </g>
+      <g id="Line_18">
+        <line x1="420.5" y1="432" x2="420.5" y2="386.9" marker-end="url(#FilledArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_33">
+        <rect x="41" y="237.25" width="169" height="40" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="2" clip-path="url(#inner_stroke_clip_path)"/>
+        <text transform="translate(46 242.25)" fill="black">
+          <tspan font-family="Monaco" font-size="11" font-weight="400" fill="black" x="0" y="11">m1 -&gt; EObjectDescription</tspan>
+          <tspan font-family="Monaco" font-size="11" font-weight="400" fill="black" x="0" y="25.918457">m2 -&gt; EObjectDescription</tspan>
+        </text>
+      </g>
+      <g id="Line_53">
+        <line x1="359.5" y1="257.25" x2="219.9" y2="257.25" marker-end="url(#Arrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_54">
+        <text transform="translate(262 232)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="400" fill="black" x="3.428" y="15">exposes</tspan>
+        </text>
+      </g>
+      <g id="Graphic_55">
+        <rect x="20.5" y="332.75" width="222" height="40" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="2" clip-path="url(#inner_stroke_clip_path_2)"/>
+        <text transform="translate(25.5 337.75)" fill="black">
+          <tspan font-family="Monaco" font-size="11" font-weight="400" fill="black" x="0" y="11">m1 -&gt; InvisibleMemberDescription</tspan>
+          <tspan font-family="Monaco" font-size="11" font-weight="400" fill="black" x="0" y="25.918457">m2 -&gt; EObjectDescription</tspan>
+        </text>
+      </g>
+      <g id="Line_59">
+        <line x1="359.5" y1="352.75" x2="252.4" y2="352.75" marker-end="url(#Arrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_60">
+        <text transform="translate(262 326.5)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="400" fill="black" x="3.428" y="15">exposes</tspan>
+        </text>
+      </g>
+      <g id="Graphic_61">
+        <rect x="613" y="47" width="110" height="48.5" fill="white"/>
+        <rect x="613" y="47" width="110" height="48.5" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(618 62.026)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="400" fill="black" x="5.4" y="15">NULL scope</tspan>
+        </text>
+      </g>
+      <g id="Graphic_62">
+        <rect x="607" y="137.5" width="122" height="48.5" fill="white"/>
+        <rect x="607" y="137.5" width="122" height="48.5" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(612 143.302)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="400" fill="black" x="3.096" y="15">MemberScope</tspan>
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="400" fill="black" x="22.064" y="33.448">N4Object</tspan>
+        </text>
+      </g>
+      <g id="Line_63">
+        <path d="M 668.54325 137.5 C 668.6149 131.9096 668.6641 125.52947 668.6641 118.55078 C 668.6641 114.00821 668.6432 109.5905 668.6089 105.39599" marker-end="url(#FilledArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_64">
+        <rect x="607" y="233" width="122" height="48.5" fill="white"/>
+        <rect x="607" y="233" width="122" height="48.5" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(612 238.802)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="400" fill="black" x="3.096" y="15">MemberScope</tspan>
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="400" fill="black" x="50.368" y="33.448">D</tspan>
+        </text>
+      </g>
+      <g id="Line_65">
+        <line x1="668" y1="233" x2="668" y2="195.9" marker-end="url(#FilledArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_66">
+        <rect x="607" y="328.5" width="122" height="48.5" fill="white"/>
+        <rect x="607" y="328.5" width="122" height="48.5" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(612 334.302)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="400" fill="black" x="4.896" y="15">VisibilityAware</tspan>
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="400" fill="black" x="3.096" y="33.448">MemberScope</tspan>
+        </text>
+      </g>
+      <g id="Line_67">
+        <line x1="668" y1="328.5" x2="668" y2="291.4" marker-end="url(#FilledArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_68">
+        <rect x="584.5" y="432" width="167" height="57.5" fill="white"/>
+        <rect x="584.5" y="432" width="167" height="57.5" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(589.5 442.302)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="400" fill="black" x="2.948" y="15">TypingStrategyAware</tspan>
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="400" fill="black" x="25.596" y="33.448">MemberScope</tspan>
+        </text>
+      </g>
+      <g id="Line_69">
+        <line x1="668" y1="432" x2="668" y2="386.9" marker-end="url(#FilledArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_76">
+        <rect x="873.5" y="332.75" width="228" height="40" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="2" clip-path="url(#inner_stroke_clip_path_3)"/>
+        <text transform="translate(878.5 337.75)" fill="black">
+          <tspan font-family="Monaco" font-size="11" font-weight="400" fill="black" x="0" y="11">m1 -&gt; InvisibleMemberDescription</tspan>
+          <tspan font-family="Monaco" font-size="11" font-weight="400" fill="black" x="0" y="25.918457">m2 -&gt; WrongWriteAccessDescription</tspan>
+        </text>
+      </g>
+      <g id="Graphic_78">
+        <text transform="translate(771.75 232)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="400" fill="black" x="3.428" y="15">exposes</tspan>
+        </text>
+      </g>
+      <g id="Graphic_79">
+        <rect x="462" y="557.5" width="167" height="57.5" fill="white"/>
+        <rect x="462" y="557.5" width="167" height="57.5" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(467 577.026)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="400" fill="black" x="4.556" y="15">UnionMemberScope</tspan>
+        </text>
+      </g>
+      <g id="Line_81">
+        <line x1="449.13546" y1="489.5" x2="510.3369" y2="550.9462" marker-end="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_82">
+        <line x1="639.93725" y1="489.5" x2="580.0239" y2="550.8806" marker-end="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_83">
+        <rect x="875" y="237.25" width="228" height="40" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="2" clip-path="url(#inner_stroke_clip_path_4)"/>
+        <text transform="translate(880 242.25)" fill="black">
+          <tspan font-family="Monaco" font-size="11" font-weight="400" fill="black" x="0" y="11">m1 -&gt; EObjectDescription</tspan>
+          <tspan font-family="Monaco" font-size="11" font-weight="400" fill="black" x="0" y="25.918457">m2 -&gt; WrongWriteAccessDescription</tspan>
+        </text>
+      </g>
+      <g id="Line_84">
+        <line x1="729" y1="257.25" x2="865.1" y2="257.25" marker-end="url(#Arrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_87">
+        <text transform="translate(771.75 326.5)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="400" fill="black" x="3.428" y="15">exposes</tspan>
+        </text>
+      </g>
+      <g id="Line_86">
+        <line x1="729" y1="352.75" x2="863.6" y2="352.75" marker-end="url(#Arrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_88">
+        <rect x="20.5" y="440.75" width="222" height="40" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="2" clip-path="url(#inner_stroke_clip_path_5)"/>
+        <text transform="translate(25.5 445.75)" fill="black">
+          <tspan font-family="Monaco" font-size="11" font-weight="400" fill="black" x="0" y="11">m1 -&gt; InvisibleMemberDescription</tspan>
+          <tspan font-family="Monaco" font-size="11" font-weight="400" fill="black" x="0" y="25.918457">m2 -&gt; EObjectDescription</tspan>
+        </text>
+      </g>
+      <g id="Line_89">
+        <line x1="337" y1="460.75" x2="252.4" y2="460.75" marker-end="url(#Arrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_90">
+        <text transform="translate(256.25 437)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="400" fill="black" x="3.428" y="15">exposes</tspan>
+        </text>
+      </g>
+      <g id="Graphic_91">
+        <rect x="873.5" y="440.75" width="228" height="40" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="2" clip-path="url(#inner_stroke_clip_path_6)"/>
+        <text transform="translate(878.5 445.75)" fill="black">
+          <tspan font-family="Monaco" font-size="11" font-weight="400" fill="black" x="0" y="11">m1 -&gt; InvisibleMemberDescription</tspan>
+          <tspan font-family="Monaco" font-size="11" font-weight="400" fill="black" x="0" y="25.918457">m2 -&gt; WrongWriteAccessDescription</tspan>
+        </text>
+      </g>
+      <g id="Graphic_92">
+        <text transform="translate(775.75 437)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="400" fill="black" x="3.428" y="15">exposes</tspan>
+        </text>
+      </g>
+      <g id="Line_93">
+        <line x1="751.5" y1="460.75" x2="863.6" y2="460.75" marker-end="url(#Arrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_94">
+        <rect x="754" y="567.5" width="255" height="40" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="2" clip-path="url(#inner_stroke_clip_path_7)"/>
+        <text transform="translate(759 572.5)" fill="black">
+          <tspan font-family="Monaco" font-size="11" font-weight="400" fill="black" x="0" y="11">m1 -&gt; UnionMemberDescriptionWithError</tspan>
+          <tspan font-family="Monaco" font-size="11" font-weight="400" fill="black" x="0" y="25.918457">m2 -&gt; UnionMemberDescriptionWithError</tspan>
+        </text>
+      </g>
+      <g id="Graphic_95">
+        <text transform="translate(651 557)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="400" fill="black" x="3.428" y="15">exposes</tspan>
+        </text>
+      </g>
+      <g id="Line_96">
+        <line x1="629" y1="586.56064" x2="744.1001" y2="586.98884" marker-end="url(#Arrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+    </g>
+  </g>
+</svg>
diff --git a/design/chapters/10_validation/images/cd_validation.svg b/design/chapters/10_validation/images/cd_validation.svg
new file mode 100644
index 0000000..8d3e313
--- /dev/null
+++ b/design/chapters/10_validation/images/cd_validation.svg
@@ -0,0 +1,354 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xl="http://www.w3.org/1999/xlink" xmlns:dc="http://purl.org/dc/elements/1.1/" viewBox="24.48144 40.036005 514.01856 726.464" width="514.01856" height="726.464">
+  <defs>
+    <font-face font-family="Helvetica" font-size="12" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="532.22656" cap-height="719.7266" ascent="770.0195" descent="-229.98047" font-weight="700">
+      <font-face-src>
+        <font-face-name name="Helvetica-Bold"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="12" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="UMLInheritance_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -8 14 16" markerWidth="14" markerHeight="16" color="black">
+      <g>
+        <path d="M 12 0 L 0 -7 L 0 7 Z" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="StickArrow_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -4 10 8" markerWidth="10" markerHeight="8" color="black">
+      <g>
+        <path d="M 8 0 L 0 0 M 0 -3 L 8 0 L 0 3" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <font-face font-family="Helvetica" font-size="10" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+  </defs>
+  <metadata> Produced by OmniGraffle 7.11 
+    <dc:date>2001-01-11 18:07:48 +0000</dc:date>
+  </metadata>
+  <g id="Canvas_1" stroke="none" stroke-opacity="1" stroke-dasharray="none" fill="none" fill-opacity="1">
+    <title>Canvas 1</title>
+    <rect fill="white" x="24.48144" y="40.036005" width="514.01856" height="726.464"/>
+    <g id="Canvas_1: Layer 1">
+      <title>Layer 1</title>
+      <g id="Graphic_163">
+        <rect x="171.803" y="160.518" width="99" height="36" fill="white"/>
+        <rect x="171.803" y="160.518" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(176.803 171.518)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="23.831055" y="11">Builder</tspan>
+        </text>
+      </g>
+      <g id="Graphic_164">
+        <rect x="366" y="275" width="99" height="36" fill="white"/>
+        <rect x="366" y="275" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(371 286)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="17.154297" y="11">Resource</tspan>
+        </text>
+      </g>
+      <g id="Graphic_165">
+        <rect x="101" y="275" width="122" height="36" fill="white"/>
+        <rect x="101" y="275" width="122" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(106 279)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="13.759766" y="11">ManifestAware</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="3.3095703" y="25">ResourceValidator</tspan>
+        </text>
+      </g>
+      <g id="Graphic_166">
+        <rect x="112.5" y="549" width="99" height="36" fill="white"/>
+        <rect x="112.5" y="549" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(117.5 560)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="4.1464844" y="11">N4JSValidator</tspan>
+        </text>
+      </g>
+      <g id="Graphic_167">
+        <rect x="366" y="373.5" width="99" height="36" fill="white"/>
+        <rect x="366" y="373.5" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(371 384.5)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="11.485352" y="11">N4JSLinker</tspan>
+        </text>
+      </g>
+      <g id="Graphic_168">
+        <rect x="366" y="462" width="99" height="36" fill="white"/>
+        <rect x="366" y="462" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(371 466)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="5.828125" y="11">ASTStructure</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="19.155273" y="25">Validator</tspan>
+        </text>
+      </g>
+      <g id="Graphic_169">
+        <rect x="112.5" y="373.5" width="99" height="36" fill="white"/>
+        <rect x="112.5" y="373.5" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(117.5 377.5)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="12.81836" y="11">Cancelable</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="6.8271484" y="25">Diagnostican</tspan>
+        </text>
+      </g>
+      <g id="Graphic_170">
+        <rect x="28" y="160.518" width="99" height="36" fill="white"/>
+        <rect x="28" y="160.518" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(33 171.518)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="5.491211" y="11">ValidationJob</tspan>
+        </text>
+      </g>
+      <g id="Group_412">
+        <g id="Graphic_419">
+          <text transform="translate(179.61354 82.03601)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="11">On Save / Build</tspan>
+          </text>
+        </g>
+        <g id="Group_413">
+          <g id="Graphic_418">
+            <circle cx="221.3027" cy="49.787705" r="6.75071078695634" fill="white"/>
+            <circle cx="221.3027" cy="49.787705" r="6.75071078695634" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Line_417">
+            <line x1="221.303" y1="56.537005" x2="221.303" y2="66.652005" stroke="black" stroke-linecap="butt" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Line_416">
+            <line x1="221.303" y1="66.652005" x2="213.803" y2="80.15301" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Line_415">
+            <line x1="221.303" y1="66.652005" x2="228.803" y2="80.15301" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Line_414">
+            <line x1="228.803" y1="62.037005" x2="213.803" y2="61.912005" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+        </g>
+      </g>
+      <g id="Group_518">
+        <g id="Graphic_525">
+          <text transform="translate(24.48144 82.03601)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="11">On Edit / Dirty State</tspan>
+          </text>
+        </g>
+        <g id="Group_519">
+          <g id="Graphic_524">
+            <circle cx="77.49969" cy="49.787705" r="6.75071078695633" fill="white"/>
+            <circle cx="77.49969" cy="49.787705" r="6.75071078695633" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Line_523">
+            <line x1="77.49999" y1="56.537005" x2="77.49999" y2="66.652005" stroke="black" stroke-linecap="butt" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Line_522">
+            <line x1="77.49999" y1="66.652005" x2="69.999994" y2="80.15301" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Line_521">
+            <line x1="77.49999" y1="66.652005" x2="84.99999" y2="80.15301" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Line_520">
+            <line x1="84.99999" y1="62.037005" x2="69.999994" y2="61.912005" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+        </g>
+      </g>
+      <g id="Line_145">
+        <line x1="221.303" y1="101.036" x2="221.303" y2="147.018" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_526">
+        <path d="M 77.5 101.036 L 77.5 116.536 L 77.5 144.518 L 77.5 146.518" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_457">
+        <path d="M 221.303 196.518 L 219 234 L 170.03686 269.2191" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_528">
+        <path d="M 77.523425 197.01745 L 79 228.5 L 153.36308 270.16124" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_529">
+        <path d="M 270.803 178.518 L 308 260 L 357.39528 288.1042" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_272">
+        <text transform="translate(95.71426 115.844)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«01. triggers»</tspan>
+        </text>
+      </g>
+      <g id="Graphic_531">
+        <text transform="translate(236.62326 115.84401)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«01. triggers»</tspan>
+        </text>
+      </g>
+      <g id="Graphic_532">
+        <text transform="translate(292.1455 187)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«03. load»</tspan>
+        </text>
+      </g>
+      <g id="Graphic_533">
+        <rect x="375" y="168" width="99" height="36" fill="white"/>
+        <rect x="375" y="168" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(380 179)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="25.817383" y="11">Parser</tspan>
+        </text>
+      </g>
+      <g id="Line_534">
+        <path d="M 415.5 275 L 427 239 L 425.20535 213.87484" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_535">
+        <text transform="translate(436.0913 233.5)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«04. parse»</tspan>
+        </text>
+      </g>
+      <g id="Graphic_536">
+        <text transform="translate(321.7046 240)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«ParseResult»</tspan>
+        </text>
+      </g>
+      <g id="Line_537">
+        <path d="M 380.57547 204.47869 L 392.5 244 L 409.6011 267.04933" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_538">
+        <path d="M 415.5 311 L 417 311 L 415.73753 363.60283" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_539">
+        <text transform="translate(419.86476 334)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«05. doLink»</tspan>
+        </text>
+      </g>
+      <g id="Line_540">
+        <line x1="415.5" y1="409.5" x2="415.5" y2="452.1" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_541">
+        <text transform="translate(419.86475 429.75)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«06. validate»</tspan>
+        </text>
+      </g>
+      <g id="Graphic_542">
+        <text transform="translate(98.57666 217)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«02. validate Resource»</tspan>
+        </text>
+      </g>
+      <g id="Line_543">
+        <path d="M 162 311 L 164.212 309 L 162.33932 363.6058" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_544">
+        <text transform="translate(80.36475 334)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«07. validate»</tspan>
+        </text>
+      </g>
+      <g id="Graphic_545">
+        <rect x="110.5" y="467.964" width="99" height="36" fill="white"/>
+        <rect x="110.5" y="467.964" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(115.5 471.964)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="13.498047" y="11">Composite</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="15.15332" y="25">EValidator</tspan>
+        </text>
+      </g>
+      <g id="Line_546">
+        <path d="M 162 409.5 L 164.212 410 L 160.7175 458.09" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_547">
+        <path d="M 211.5 391.5 L 251 391 L 251 446.75 L 201 446.75 L 176.3328 417.10956" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_548">
+        <text transform="translate(231.8247 374.5)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«08. doValidateContents»</tspan>
+        </text>
+      </g>
+      <g id="Graphic_549">
+        <text transform="translate(80.36475 434.75)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«09. validate»</tspan>
+        </text>
+      </g>
+      <g id="Graphic_550">
+        <text transform="translate(80.36475 520.482)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«10. validate»</tspan>
+        </text>
+      </g>
+      <g id="Line_551">
+        <line x1="160" y1="503.964" x2="161.56079" y2="539.10975" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_552">
+        <rect x="316.5" y="549" width="137" height="36" fill="white"/>
+        <rect x="316.5" y="549" width="137" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(321.5 553)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="39.160156" y="11">Abstract</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="6.133789" y="25">DeclarativeValidator</tspan>
+        </text>
+      </g>
+      <g id="Line_553">
+        <line x1="211.5" y1="567" x2="303" y2="567" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_554">
+        <path d="M 198.99953 548.6496 L 219 529 L 339 530 L 375.8498 545.2206" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_555">
+        <text transform="translate(239.86816 509)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«11. internalValidate»</tspan>
+        </text>
+      </g>
+      <g id="Line_558">
+        <path d="M 453.5 567 L 495.5 565 L 495.5 620.75 L 445.5 620.75 L 393.52317 590.0364" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_559">
+        <text transform="translate(415.249 636)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«12. collectMethods»</tspan>
+        </text>
+      </g>
+      <g id="Graphic_148">
+        <path d="M 538 696.64615 C 538 687.31525 535.4346 686.1608 516.69506 676.92645 L 516.4971 676.8309 C 497.6586 667.5 497.46264 667.5 478.1292 667.5 C 452.38634 667.5 336 667.5 336 667.5 L 336 766 L 538 766 L 538 696.64615 Z" fill="white"/>
+        <path d="M 538 696.64615 C 538 687.31525 535.4346 686.1608 516.69506 676.92645 L 516.4971 676.8309 C 497.6586 667.5 497.46264 667.5 478.1292 667.5 C 452.38634 667.5 336 667.5 336 667.5 L 336 766 L 538 766 L 538 696.64615 Z M 538 696.1655 C 538 687.31525 537.80204 687.31525 497.46264 687.31525 L 497.46264 687.31525 C 497.46264 667.5965 497.46264 667.5 479.31294 667.5" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(341 674.75)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="5.293945" y="11">1. collect methods of current class </tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="27.624023" y="25">and then of super classes</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="16.625977" y="39">2. recursively handle validator </tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="19.96582" y="53">classes in composed checks </tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="4.274414" y="67">annotation in the current class and </tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="32.63086" y="81">the of the super classes</tspan>
+        </text>
+      </g>
+      <g id="Line_24">
+        <line x1="458.7475" y1="653" x2="453.96244" y2="667.0268" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_560">
+        <path d="M 162 585 L 209.5 614 L 316.5 614 L 375.88334 588.8596" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_561">
+        <text transform="translate(236.3425 597)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«13. invoke»</tspan>
+        </text>
+      </g>
+      <g id="Graphic_562">
+        <rect x="90.288" y="724.5" width="99" height="36" fill="white"/>
+        <rect x="90.288" y="724.5" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(95.288 728.5)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="13.480469" y="11">N4JSClass</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="19.155273" y="25">Validator</tspan>
+        </text>
+      </g>
+      <g id="Line_563">
+        <line x1="223" y1="293" x2="356.1" y2="293" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_564">
+        <text transform="translate(236.21457 300.42202)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="1.3891602" y="10">«03-06.. resolve proxies and </tspan>
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="24.18213" y="22">create diagnostics </tspan>
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="19.46289" y="34">for resource issues»</tspan>
+        </text>
+      </g>
+      <g id="Line_565">
+        <path d="M 379.4539 587.348 L 375 634 L 197.83604 737.5059" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_566">
+        <text transform="translate(217.1677 730.5)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="1.3891602" y="10">«14. invokes concrete </tspan>
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="16.120605" y="22">check method»</tspan>
+        </text>
+      </g>
+      <g id="Graphic_567">
+        <path d="M 233 647.672 C 233 640.0936 230.4346 639.156 211.69506 631.656 L 211.4971 631.5784 C 192.65858 624 192.46264 624 173.12922 624 C 147.38634 624 31 624 31 624 L 31 704 L 233 704 L 233 647.672 Z" fill="white"/>
+        <path d="M 233 647.672 C 233 640.0936 230.4346 639.156 211.69506 631.656 L 211.4971 631.5784 C 192.65858 624 192.46264 624 173.12922 624 C 147.38634 624 31 624 31 624 L 31 704 L 233 704 L 233 647.672 Z M 233 647.2816 C 233 640.0936 232.80204 640.0936 192.46264 640.0936 L 192.46264 640.0936 C 192.46264 624.0784 192.46264 624 174.31294 624" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(36 636)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="17.625" y="11">finds all methods for the type, </tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="21.28418" y="25">the CancelableDiagnostican </tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="13.617188" y="39">currently handles, in the before</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="30.298828" y="53">collected check methods   </tspan>
+        </text>
+      </g>
+      <g id="Line_568">
+        <line x1="155.01194" y1="624" x2="209.5" y2="614" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+    </g>
+  </g>
+</svg>
diff --git a/design/chapters/11_references/images/cd_classes.svg b/design/chapters/11_references/images/cd_classes.svg
new file mode 100644
index 0000000..39794a2
--- /dev/null
+++ b/design/chapters/11_references/images/cd_classes.svg
@@ -0,0 +1,269 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xl="http://www.w3.org/1999/xlink" xmlns:dc="http://purl.org/dc/elements/1.1/" viewBox="47 161.625 456.75 532.5" width="456.75" height="532.5">
+  <defs>
+    <font-face font-family="Helvetica" font-size="12" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="532.22656" cap-height="719.7266" ascent="770.0195" descent="-229.98047" font-weight="700">
+      <font-face-src>
+        <font-face-name name="Helvetica-Bold"/>
+      </font-face-src>
+    </font-face>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="StickArrow_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -4 10 8" markerWidth="10" markerHeight="8" color="black">
+      <g>
+        <path d="M 8 0 L 0 0 M 0 -3 L 8 0 L 0 3" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <font-face font-family="Helvetica" font-size="10" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="12" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+  </defs>
+  <metadata> Produced by OmniGraffle 7.11 
+    <dc:date>2019-07-31 11:09:55 +0000</dc:date>
+  </metadata>
+  <g id="Canvas_1" stroke="none" stroke-opacity="1" stroke-dasharray="none" fill="none" fill-opacity="1">
+    <title>Canvas 1</title>
+    <rect fill="white" x="47" y="161.625" width="456.75" height="532.5"/>
+    <g id="Canvas_1: Layer 1">
+      <title>Layer 1</title>
+      <g id="Graphic_163">
+        <rect x="47.5" y="416.5" width="99" height="36" fill="white"/>
+        <rect x="47.5" y="416.5" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(52.5 420.5)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="2.1455078" y="11">N4JSResource</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="11.49414" y="25">Description</tspan>
+        </text>
+      </g>
+      <g id="Graphic_164">
+        <rect x="59.25" y="495.375" width="75" height="51" fill="white"/>
+        <rect x="59.25" y="495.375" width="75" height="51" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(64.25 499.875)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x=".484375" y="11">N4JSCross</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="3.484375" y="25">Reference</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="4.166992" y="39">Computer</tspan>
+        </text>
+      </g>
+      <g id="Graphic_165">
+        <rect x="50.75" y="629.375" width="92" height="51" fill="white"/>
+        <rect x="50.75" y="629.375" width="92" height="51" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(55.75 633.875)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="2.3134766" y="11">N4JSExternal</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="11.984375" y="25">Reference</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="17.319336" y="39">Checker</tspan>
+        </text>
+      </g>
+      <g id="Graphic_166">
+        <rect x="383.75" y="488.125" width="99" height="46" fill="white"/>
+        <rect x="383.75" y="488.125" width="99" height="46" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(388.75 490.125)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="29.49121" y="11">N4JS</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="15.484375" y="25">Reference</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="26.166016" y="39">Finder</tspan>
+        </text>
+      </g>
+      <g id="Line_167">
+        <line x1="383.75" y1="511.125" x2="155.92084" y2="437.54266" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_212">
+        <text transform="translate(306.5 464.3125)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«findReferences»</tspan>
+        </text>
+      </g>
+      <g id="Graphic_463">
+        <rect x="47.5" y="334.875" width="99" height="46" fill="white"/>
+        <rect x="47.5" y="334.875" width="99" height="46" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(52.5 336.875)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="2.1455078" y="11">N4JSResource</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="11.49414" y="25">Description</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="19.826172" y="39">Manager</tspan>
+        </text>
+      </g>
+      <g id="Line_464">
+        <line x1="97" y1="380.875" x2="97" y2="406.6" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_465">
+        <text transform="translate(108 389.25)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«getImportedNames»</tspan>
+        </text>
+      </g>
+      <g id="Graphic_466">
+        <rect x="47.5" y="251.375" width="99" height="36" fill="white"/>
+        <rect x="47.5" y="251.375" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(52.5 255.375)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="1.149414" y="11">N4JSDirtyState</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="4.1728516" y="25">EditorSupport</tspan>
+        </text>
+      </g>
+      <g id="Graphic_467">
+        <rect x="187" y="246.375" width="99" height="46" fill="white"/>
+        <rect x="187" y="246.375" width="99" height="46" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(192 248.375)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="3.4785156" y="11">N4JSGenerate</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="9.818359" y="25">Immediately</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="9.15918" y="39">BuilderState</tspan>
+        </text>
+      </g>
+      <g id="Line_468">
+        <line x1="97" y1="287.375" x2="97" y2="324.975" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_469">
+        <text transform="translate(113 299.6875)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«isAffected»</tspan>
+        </text>
+      </g>
+      <g id="Line_470">
+        <line x1="97" y1="210.125" x2="97" y2="241.475" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_471">
+        <text transform="translate(113 222.25)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«isReparseRequired»</tspan>
+        </text>
+      </g>
+      <g id="Line_472">
+        <line x1="236.5" y1="292.375" x2="154.50456" y2="352.04946" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_473">
+        <text transform="translate(204.125 324.625)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«isAffected»</tspan>
+        </text>
+      </g>
+      <g id="Graphic_476">
+        <rect x="47.5" y="174.125" width="99" height="36" fill="white"/>
+        <rect x="47.5" y="174.125" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(52.5 178.125)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="9.15625" y="11">N4JSUpdate</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="1.8291016" y="25">EditorStateJob</tspan>
+        </text>
+      </g>
+      <g id="Graphic_477">
+        <rect x="376" y="416.5" width="99" height="36" fill="white"/>
+        <rect x="376" y="416.5" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(381 427.5)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="12.264648" y="11">TypeHelper</tspan>
+        </text>
+      </g>
+      <g id="Line_478">
+        <line x1="97" y1="452.5" x2="96.80772" y2="485.4752" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_479">
+        <text transform="translate(101.75 473)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«computeCrossRefs»</tspan>
+        </text>
+      </g>
+      <g id="Line_480">
+        <line x1="96.75" y1="546.375" x2="96.75" y2="619.475" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_481">
+        <text transform="translate(107.75 556.75)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«isResolvedAndExternal»</tspan>
+        </text>
+      </g>
+      <g id="Line_482">
+        <line x1="146.5" y1="434.5" x2="366.1" y2="434.5" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_483">
+        <text transform="translate(214 414.625)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«collectAllDeclaredSuperTypes»</tspan>
+        </text>
+      </g>
+      <g id="Line_484">
+        <line x1="383.75" y1="511.125" x2="151.25238" y2="649.8036" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_485">
+        <text transform="translate(165.75 658.875)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«isResolvedAndExternal»</tspan>
+        </text>
+      </g>
+      <g id="Graphic_486">
+        <rect x="383.75" y="577.125" width="99" height="36" fill="white"/>
+        <rect x="383.75" y="577.125" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(388.75 581.125)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x=".47558594" y="11">N4JSReference</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="1.8115234" y="25">QueryExecuter</tspan>
+        </text>
+      </g>
+      <g id="Group_412">
+        <g id="Graphic_419"/>
+        <g id="Group_413">
+          <g id="Graphic_418">
+            <circle cx="317.2497" cy="642.8767" r="6.75071078695634" fill="white"/>
+            <circle cx="317.2497" cy="642.8767" r="6.75071078695634" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Line_417">
+            <line x1="317.25" y1="649.626" x2="317.25" y2="659.741" stroke="black" stroke-linecap="butt" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Line_416">
+            <line x1="317.25" y1="659.741" x2="309.75" y2="673.242" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Line_415">
+            <line x1="317.25" y1="659.741" x2="324.75" y2="673.242" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Line_414">
+            <line x1="324.75" y1="655.126" x2="309.75" y2="655.001" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+        </g>
+      </g>
+      <g id="Group_487">
+        <g id="Graphic_494"/>
+        <g id="Group_488">
+          <g id="Graphic_493">
+            <circle cx="433.4997" cy="171.3767" r="6.7507107869563" fill="white"/>
+            <circle cx="433.4997" cy="171.3767" r="6.7507107869563" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Line_492">
+            <line x1="433.5" y1="178.126" x2="433.5" y2="188.241" stroke="black" stroke-linecap="butt" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Line_491">
+            <line x1="433.5" y1="188.241" x2="426" y2="201.742" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Line_490">
+            <line x1="433.5" y1="188.241" x2="441" y2="201.742" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Line_489">
+            <line x1="441" y1="183.626" x2="426" y2="183.501" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+        </g>
+      </g>
+      <g id="Line_495">
+        <line x1="411" y1="192.125" x2="156.4" y2="192.125" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_496">
+        <text transform="translate(277 172.125)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«typing in N4JS editor»</tspan>
+        </text>
+      </g>
+      <g id="Graphic_559">
+        <path d="M 454.2749 663.6249 C 454.2749 663.625 474.75 645.625 474.75 645.625 L 393.75 645.625 L 393.75 681.6249 C 393.75 681.6249 474.75 681.625 474.74984 681.625 Z" fill="white"/>
+        <path d="M 454.2749 663.6249 C 454.2749 663.625 474.75 645.625 474.75 645.625 L 393.75 645.625 L 393.75 681.6249 C 393.75 681.6249 474.75 681.625 474.74984 681.625 Z" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(395.75 649.625)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="11">Find by </tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="25">references</tspan>
+        </text>
+      </g>
+      <g id="Line_560">
+        <line x1="339.75" y1="663.625" x2="383.35" y2="663.625" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_561">
+        <line x1="433.88366" y1="645.1251" x2="433.446" y2="623.02306" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_562">
+        <text transform="translate(442.75 626.125)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«creates»</tspan>
+        </text>
+      </g>
+      <g id="Line_563">
+        <line x1="433.25" y1="577.125" x2="433.25" y2="544.025" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_564">
+        <text transform="translate(446.75 566)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«executes»</tspan>
+        </text>
+      </g>
+    </g>
+  </g>
+</svg>
diff --git a/design/chapters/11_references/images/findreference_workflow.svg b/design/chapters/11_references/images/findreference_workflow.svg
new file mode 100644
index 0000000..c8035a4
--- /dev/null
+++ b/design/chapters/11_references/images/findreference_workflow.svg
@@ -0,0 +1,239 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xl="http://www.w3.org/1999/xlink" xmlns:dc="http://purl.org/dc/elements/1.1/" viewBox="354.4462 -940.7537 1031.0538 821.8392" width="1031.0538" height="821.8392">
+  <defs>
+    <font-face font-family="Helvetica Neue" font-size="16" panose-1="2 0 5 3 0 0 0 2 0 4" units-per-em="1000" underline-position="-100" underline-thickness="50" slope="0" x-height="517" cap-height="714" ascent="951.9958" descent="-212.99744" font-weight="400">
+      <font-face-src>
+        <font-face-name name="HelveticaNeue"/>
+      </font-face-src>
+    </font-face>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="StickArrow_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -4 10 8" markerWidth="10" markerHeight="8" color="black">
+      <g>
+        <path d="M 8 0 L 0 0 M 0 -3 L 8 0 L 0 3" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <font-face font-family="Helvetica Neue" font-size="16" panose-1="2 0 5 3 0 0 0 9 0 4" units-per-em="1000" underline-position="-100" underline-thickness="50" slope="-750" x-height="517" cap-height="714" ascent="957.0007" descent="-212.99744" font-style="italic" font-weight="400">
+      <font-face-src>
+        <font-face-name name="HelveticaNeue-Italic"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica Neue" font-size="16" panose-1="2 0 8 3 0 0 0 9 0 4" units-per-em="1000" underline-position="-100" underline-thickness="50" slope="0" x-height="517" cap-height="714" ascent="975.0061" descent="-216.99524" font-weight="700">
+      <font-face-src>
+        <font-face-name name="HelveticaNeue-Bold"/>
+      </font-face-src>
+    </font-face>
+  </defs>
+  <metadata> Produced by OmniGraffle 7.11 
+    <dc:date>2019-07-31 11:11:27 +0000</dc:date>
+  </metadata>
+  <g id="Canvas_1" stroke="none" stroke-opacity="1" stroke-dasharray="none" fill="none" fill-opacity="1">
+    <title>Canvas 1</title>
+    <rect fill="white" x="354.4462" y="-940.7537" width="1031.0538" height="821.8392"/>
+    <g id="Canvas_1: Layer 1">
+      <title>Layer 1</title>
+      <g id="Graphic_10">
+        <rect x="372.1962" y="-845.2908" width="183.5" height="78.5" fill="white"/>
+        <rect x="372.1962" y="-845.2908" width="183.5" height="78.5" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(377.1962 -815.2648)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="400" fill="black" x="2.894" y="15">FindReferencesHandler</tspan>
+        </text>
+      </g>
+      <g id="Graphic_12">
+        <rect x="376.5" y="-654.5834" width="171.5" height="72.5" fill="white"/>
+        <rect x="376.5" y="-654.5834" width="171.5" height="72.5" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(381.5 -636.7814)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="400" fill="black" x="3.406" y="15">N4JSReferenceQuery</tspan>
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="400" fill="black" x="48.902" y="33.448">Executor</tspan>
+        </text>
+      </g>
+      <g id="Graphic_16">
+        <rect x="772.5122" y="-652.1746" width="183.5" height="78.5" fill="yellow"/>
+        <rect x="772.5122" y="-652.1746" width="183.5" height="78.5" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(777.5122 -631.3726)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="400" fill="black" x="4.446" y="15">InferredElementsTarget</tspan>
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="400" fill="black" x="41.134" y="33.448">URICollector</tspan>
+        </text>
+      </g>
+      <g id="Line_71">
+        <line x1="464.2988" y1="-766.7908" x2="465.218" y2="-664.483" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_72">
+        <rect x="424.24214" y="-732.4463" width="81" height="30" fill="white"/>
+        <text transform="translate(429.62214 -727.4463)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="400" fill="black" x="7958079e-19" y="15">2. creates</tspan>
+        </text>
+      </g>
+      <g id="Line_48">
+        <line x1="772.5122" y1="-614.15904" x2="557.8991" y2="-617.0465" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_49">
+        <rect x="601.5333" y="-630.5311" width="138" height="30" fill="yellow"/>
+        <text transform="translate(606.6053 -625.5311)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="400" fill="black" x="0" y="15">2.1 getTargetURIs</tspan>
+        </text>
+      </g>
+      <g id="Graphic_26">
+        <rect x="372.1962" y="-428.16676" width="175.5" height="78.5" fill="white"/>
+        <rect x="372.1962" y="-428.16676" width="175.5" height="78.5" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(377.1962 -407.36476)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="400" fill="black" x="3.198" y="15">ConcreteSyntaxAware</tspan>
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="400" fill="black" x="23.934" y="33.448">ReferenceFinder</tspan>
+        </text>
+      </g>
+      <g id="Graphic_27">
+        <rect x="1201.5" y="-652.1746" width="183.5" height="78.5" fill="yellow"/>
+        <rect x="1201.5" y="-652.1746" width="183.5" height="78.5" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(1206.5 -622.1486)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="400" fill="black" x="26.294" y="15">InferredElements</tspan>
+        </text>
+      </g>
+      <g id="Line_28">
+        <line x1="1201.5" y1="-612.9246" x2="965.9122" y2="-612.9246" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_29">
+        <rect x="980.6696" y="-627.9246" width="205" height="30" fill="yellow"/>
+        <text transform="translate(985.8176 -622.9246)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="400" fill="black" x="781597e-18" y="15">2.2 collectInferredElements</tspan>
+        </text>
+      </g>
+      <g id="Graphic_30">
+        <rect x="761.9181" y="-845.2908" width="190" height="78.5" fill="#c0c0ff"/>
+        <rect x="761.9181" y="-845.2908" width="190" height="78.5" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(766.9181 -815.2648)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="400" fill="black" x="8.632" y="15">EObjectAtOffsetHelper</tspan>
+        </text>
+      </g>
+      <g id="Line_31">
+        <line x1="761.9181" y1="-806.0408" x2="565.5962" y2="-806.0408" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_32">
+        <rect x="585.42384" y="-821.0408" width="153" height="30" fill="#c0c0ff"/>
+        <text transform="translate(590.79584 -816.0408)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="400" fill="black" x="61106675e-20" y="15">1. resolveElementAt</tspan>
+        </text>
+      </g>
+      <g id="Graphic_33">
+        <path d="M 796.4238 -910.1208 C 796.4238 -917.5571 793.7441 -918.4771 774.1697 -925.8365 L 773.9629 -925.9127 C 754.285 -933.349 754.0804 -933.349 733.88555 -933.349 C 706.9957 -933.349 585.42384 -933.349 585.42384 -933.349 L 585.42384 -854.849 L 796.4238 -854.849 L 796.4238 -910.1208 Z" fill="#c0c0ff"/>
+        <path d="M 796.4238 -910.1208 C 796.4238 -917.5571 793.7441 -918.4771 774.1697 -925.8365 L 773.9629 -925.9127 C 754.285 -933.349 754.0804 -933.349 733.88555 -933.349 C 706.9957 -933.349 585.42384 -933.349 585.42384 -933.349 L 585.42384 -854.849 L 796.4238 -854.849 L 796.4238 -910.1208 Z M 796.4238 -910.5039 C 796.4238 -917.5571 796.2171 -917.5571 754.0804 -917.5571 L 754.0804 -917.5571 C 754.0804 -933.272 754.0804 -933.349 735.122 -933.349" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(590.42384 -912.547)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="16" font-style="italic" font-weight="400" fill="black" x="7.764" y="15">Convert cursor position to </tspan>
+          <tspan font-family="Helvetica Neue" font-size="16" font-style="italic" font-weight="400" fill="black" x="8.188" y="33.448">declared element EObject</tspan>
+        </text>
+      </g>
+      <g id="Line_34">
+        <line x1="461.41643" y1="-582.0834" x2="460.3203" y2="-438.06647" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_35">
+        <path d="M 779.0333 -724.82076 C 779.0333 -733.6524 776.2774 -734.7451 756.1463 -743.4853 L 755.9336 -743.5758 C 735.6962 -752.4074 735.4857 -752.4074 714.71665 -752.4074 C 687.0622 -752.4074 562.0333 -752.4074 562.0333 -752.4074 L 562.0333 -659.1777 L 779.0333 -659.1777 L 779.0333 -724.82076 Z" fill="yellow"/>
+        <path d="M 779.0333 -724.82076 C 779.0333 -733.6524 776.2774 -734.7451 756.1463 -743.4853 L 755.9336 -743.5758 C 735.6962 -752.4074 735.4857 -752.4074 714.71665 -752.4074 C 687.0622 -752.4074 562.0333 -752.4074 562.0333 -752.4074 L 562.0333 -659.1777 L 779.0333 -659.1777 L 779.0333 -724.82076 Z M 779.0333 -725.2757 C 779.0333 -733.6524 778.8206 -733.6524 735.4857 -733.6524 L 735.4857 -733.6524 C 735.4857 -752.3161 735.4857 -752.4074 715.9883 -752.4074" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(567.0333 -724.7486)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="16" font-style="italic" font-weight="400" fill="black" x="11.636" y="15">Convert declared element </tspan>
+          <tspan font-family="Helvetica Neue" font-size="16" font-style="italic" font-weight="400" fill="black" x="18.988" y="34.448">EObject to </tspan>
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="700" fill="black" y="34.448">Target URIs</tspan>
+        </text>
+      </g>
+      <g id="Graphic_36">
+        <rect x="414.3248" y="-519.35413" width="93" height="30" fill="white"/>
+        <text transform="translate(419.6328 -514.35413)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="400" fill="black" x="0" y="15">3. executes</tspan>
+        </text>
+      </g>
+      <g id="Graphic_37">
+        <rect x="753.2788" y="-197.91452" width="217" height="78.5" fill="#c0ffc0"/>
+        <rect x="753.2788" y="-197.91452" width="217" height="78.5" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(758.2788 -167.88852)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="400" fill="black" x="9.268" y="15">N4JSResourceDescription</tspan>
+        </text>
+      </g>
+      <g id="Graphic_38">
+        <rect x="768.2788" y="-217.41452" width="217" height="78.5" fill="#c0ffc0"/>
+        <rect x="768.2788" y="-217.41452" width="217" height="78.5" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(773.2788 -187.38852)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="400" fill="black" x="9.268" y="15">N4JSResourceDescription</tspan>
+        </text>
+      </g>
+      <g id="Graphic_39">
+        <rect x="782.7788" y="-242.91452" width="217" height="78.5" fill="#c0ffc0"/>
+        <rect x="782.7788" y="-242.91452" width="217" height="78.5" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(787.7788 -212.88852)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="400" fill="black" x="9.268" y="15">N4JSResourceDescription</tspan>
+        </text>
+      </g>
+      <g id="Line_40">
+        <line x1="799.1488" y1="-217.41452" x2="546.41105" y2="-345.1998" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_41">
+        <rect x="573.0407" y="-300.47295" width="183" height="30" fill="#c0ffc0"/>
+        <text transform="translate(578.3407 -295.47295)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="400" fill="black" x="7247536e-19" y="16">3.2 get</tspan>
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="700" fill="black" y="16">ImportedNames</tspan>
+        </text>
+      </g>
+      <g id="Graphic_42">
+        <rect x="847.5" y="-537.4101" width="175.5" height="78.5" fill="#c0ffc0"/>
+        <rect x="847.5" y="-537.4101" width="175.5" height="78.5" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(852.5 -507.3841)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="400" fill="black" x="33.942" y="15">TargetURIKey</tspan>
+        </text>
+      </g>
+      <g id="Line_43">
+        <line x1="847.5" y1="-477.9917" x2="557.3446" y2="-411.3027" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_45">
+        <rect x="579.3606" y="-459.05844" width="241" height="30" fill="#c0ffc0"/>
+        <text transform="translate(584.7486 -454.05844)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="400" fill="black" x="0" y="16">3.1 get </tspan>
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="700" fill="black" y="16">typesOrModulesToFind</tspan>
+        </text>
+      </g>
+      <g id="Graphic_50">
+        <rect x="358.3212" y="-235.08338" width="203.25" height="78.5" fill="white"/>
+        <rect x="358.3212" y="-235.08338" width="203.25" height="78.5" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(363.3212 -205.05738)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="400" fill="black" x="5.657" y="15">LabellingReferenceFinder</tspan>
+        </text>
+      </g>
+      <g id="Line_51">
+        <line x1="459.9462" y1="-349.66676" x2="459.9462" y2="-244.98338" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_52">
+        <rect x="354.4462" y="-313.7561" width="211" height="30" fill="white"/>
+        <text transform="translate(359.7702 -308.7561)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="400" fill="black" x="0" y="15">3.3 accept found references</tspan>
+        </text>
+      </g>
+      <g id="Graphic_56">
+        <path d="M 849.5 -379.56294 C 849.5 -386.43087 846.2424 -387.28057 822.4469 -394.07744 L 822.1956 -394.14777 C 798.2744 -401.0157 798.0256 -401.0157 773.476 -401.0157 C 740.7876 -401.0157 593 -401.0157 593 -401.0157 L 593 -328.5157 L 849.5 -328.5157 L 849.5 -379.56294 Z" fill="#c0ffc0"/>
+        <path d="M 849.5 -379.56294 C 849.5 -386.43087 846.2424 -387.28057 822.4469 -394.07744 L 822.1956 -394.14777 C 798.2744 -401.0157 798.0256 -401.0157 773.476 -401.0157 C 740.7876 -401.0157 593 -401.0157 593 -401.0157 L 593 -328.5157 L 849.5 -328.5157 L 849.5 -379.56294 Z M 849.5 -379.91674 C 849.5 -386.43087 849.2486 -386.43087 798.0256 -386.43087 L 798.0256 -386.43087 C 798.0256 -400.94464 798.0256 -401.0157 774.9791 -401.0157" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(598 -373.9897)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="16" font-style="italic" font-weight="400" fill="black" x=".57" y="15">Filter potential resources to search</tspan>
+        </text>
+      </g>
+      <g id="Line_58">
+        <line x1="666.86375" y1="-821.0408" x2="674.901" y2="-845.4458" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="1.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_61">
+        <line x1="703.9069" y1="-429.05844" x2="708.8931" y2="-410.57404" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="1.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_62">
+        <line x1="675.2685" y1="-300.47295" x2="689.5653" y2="-320.46317" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="1.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_63">
+        <ellipse cx="462.33555" cy="-921.2403" rx="19.7500315585624" ry="19.0134657346942" fill="white"/>
+        <ellipse cx="462.33555" cy="-921.2403" rx="19.7500315585624" ry="19.0134657346942" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_70">
+        <rect x="397.38936" y="-892.7537" width="153" height="30" fill="white"/>
+        <text transform="translate(402.47336 -887.7537)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="400" fill="black" x="0" y="15">find references in UI</tspan>
+        </text>
+      </g>
+      <g id="Line_73">
+        <line x1="670.5333" y1="-630.5311" x2="670.5333" y2="-649.2777" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_74">
+        <path d="M 462.33555 -901.7269 L 462.33555 -873.8269 L 463.9462 -873.8269 L 463.9462 -855.6908" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+    </g>
+  </g>
+</svg>
diff --git a/design/chapters/13_compilation/images/Rewire_class_post.png b/design/chapters/13_compilation/images/Rewire_class_post.png
new file mode 100644
index 0000000..4c0deff
--- /dev/null
+++ b/design/chapters/13_compilation/images/Rewire_class_post.png
Binary files differ
diff --git a/design/chapters/13_compilation/images/Rewire_class_pre.png b/design/chapters/13_compilation/images/Rewire_class_pre.png
new file mode 100644
index 0000000..03b867b
--- /dev/null
+++ b/design/chapters/13_compilation/images/Rewire_class_pre.png
Binary files differ
diff --git a/design/chapters/13_compilation/images/Rewire_import_post.png b/design/chapters/13_compilation/images/Rewire_import_post.png
new file mode 100644
index 0000000..69b768e
--- /dev/null
+++ b/design/chapters/13_compilation/images/Rewire_import_post.png
Binary files differ
diff --git a/design/chapters/13_compilation/images/Rewire_import_pre.png b/design/chapters/13_compilation/images/Rewire_import_pre.png
new file mode 100644
index 0000000..463ccab
--- /dev/null
+++ b/design/chapters/13_compilation/images/Rewire_import_pre.png
Binary files differ
diff --git a/design/chapters/13_compilation/images/Rewire_var_post.png b/design/chapters/13_compilation/images/Rewire_var_post.png
new file mode 100644
index 0000000..209a44c
--- /dev/null
+++ b/design/chapters/13_compilation/images/Rewire_var_post.png
Binary files differ
diff --git a/design/chapters/13_compilation/images/Rewire_var_pre.png b/design/chapters/13_compilation/images/Rewire_var_pre.png
new file mode 100644
index 0000000..d03b441
--- /dev/null
+++ b/design/chapters/13_compilation/images/Rewire_var_pre.png
Binary files differ
diff --git a/design/chapters/13_compilation/images/TranspilerClassDgr.svg b/design/chapters/13_compilation/images/TranspilerClassDgr.svg
new file mode 100644
index 0000000..679ac41
--- /dev/null
+++ b/design/chapters/13_compilation/images/TranspilerClassDgr.svg
@@ -0,0 +1,351 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xl="http://www.w3.org/1999/xlink" xmlns:dc="http://purl.org/dc/elements/1.1/" viewBox="125.41084 195.70615 931.5892 522.29385" width="931.5892" height="522.29385">
+  <defs>
+    <font-face font-family="Helvetica" font-size="12" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="532.22656" cap-height="719.7266" ascent="770.0195" descent="-229.98047" font-weight="700">
+      <font-face-src>
+        <font-face-name name="Helvetica-Bold"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="12" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica Neue" font-size="12" panose-1="2 0 8 3 0 0 0 9 0 4" units-per-em="1000" underline-position="-100" underline-thickness="50" slope="1250" x-height="517" cap-height="714" ascent="975.0061" descent="-216.99524" font-style="italic" font-weight="700">
+      <font-face-src>
+        <font-face-name name="HelveticaNeue-BoldItalic"/>
+      </font-face-src>
+    </font-face>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="StickArrow_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -4 10 8" markerWidth="10" markerHeight="8" color="black">
+      <g>
+        <path d="M 8 0 L 0 0 M 0 -3 L 8 0 L 0 3" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="FilledDiamond_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-13 -6 14 12" markerWidth="14" markerHeight="12" color="black">
+      <g>
+        <path d="M -12 0 L -6 4.5 L 0 0 L -6 -4.5 Z" fill="currentColor" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <font-face font-family="Helvetica" font-size="9" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="UMLInheritance_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -8 14 16" markerWidth="14" markerHeight="16" color="black">
+      <g>
+        <path d="M 12 0 L 0 -7 L 0 7 Z" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <font-face font-family="Helvetica Neue" font-size="12" panose-1="2 0 5 3 0 0 0 9 0 4" units-per-em="1000" underline-position="-100" underline-thickness="50" slope="-1e3" x-height="517" cap-height="714" ascent="957.0007" descent="-212.99744" font-style="italic" font-weight="400">
+      <font-face-src>
+        <font-face-name name="HelveticaNeue-Italic"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica Neue" font-size="14" panose-1="2 0 5 3 0 0 0 9 0 4" units-per-em="1000" underline-position="-100" underline-thickness="50" slope="-857.1429" x-height="517" cap-height="714" ascent="957.0007" descent="-212.99744" font-style="italic" font-weight="400">
+      <font-face-src>
+        <font-face-name name="HelveticaNeue-Italic"/>
+      </font-face-src>
+    </font-face>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="StickArrow_Marker_2" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-9 -4 10 8" markerWidth="10" markerHeight="8" color="black">
+      <g>
+        <path d="M -8 0 L 0 0 M 0 3 L -8 0 L 0 -3" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+  </defs>
+  <metadata> Produced by OmniGraffle 7.11 
+    <dc:date>2019-07-31 11:27:35 +0000</dc:date>
+  </metadata>
+  <g id="Class_Dgr" stroke="none" stroke-opacity="1" stroke-dasharray="none" fill="none" fill-opacity="1">
+    <title>Class Dgr</title>
+    <rect fill="white" x="125.41084" y="195.70615" width="931.5892" height="522.29385"/>
+    <g id="Class_Dgr: Layer 1">
+      <title>Layer 1</title>
+      <g id="Graphic_600">
+        <rect x="419" y="385" width="319" height="241" fill="#ebebeb"/>
+      </g>
+      <g id="Graphic_597">
+        <rect x="130" y="487.72263" width="246" height="209.27737" fill="#ebebeb"/>
+      </g>
+      <g id="Graphic_163">
+        <rect x="442.779" y="398.89284" width="128" height="36" fill="white"/>
+        <rect x="442.779" y="398.89284" width="128" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(447.779 409.89284)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="15.646484" y="11">TranspilerState</tspan>
+        </text>
+      </g>
+      <g id="Group_525">
+        <g id="Graphic_528">
+          <rect x="759" y="436.69737" width="246" height="66" fill="white"/>
+          <rect x="759" y="436.69737" width="246" height="66" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(764 441.6974)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="11">analyze()</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="25">assertPreConditions()</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="39">transform()</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="53">assertPostConditions()</tspan>
+          </text>
+        </g>
+        <g id="Graphic_527">
+          <rect x="759" y="398.34746" width="246" height="36" fill="white"/>
+          <rect x="759" y="398.34746" width="246" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(764 403.34746)" fill="black">
+            <tspan font-family="Helvetica Neue" font-size="12" font-style="italic" font-weight="700" fill="black" x="74.44" y="12">Transformation</tspan>
+          </text>
+        </g>
+        <g id="Graphic_526">
+          <rect x="759" y="425.33907" width="246" height="15.553772" fill="white"/>
+          <rect x="759" y="425.33907" width="246" height="15.553772" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+      </g>
+      <g id="Graphic_529">
+        <rect x="147" y="428.89284" width="128" height="36" fill="white"/>
+        <rect x="147" y="428.89284" width="128" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(152 439.89284)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="22.317383" y="11">ResourceSet</tspan>
+        </text>
+      </g>
+      <g id="Line_389">
+        <line x1="211" y1="478.14284" x2="211" y2="492.99284" marker-end="url(#StickArrow_Marker)" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_390">
+        <text transform="translate(200.2347 490.72263)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="0" y="9">*</tspan>
+        </text>
+      </g>
+      <g id="Graphic_530">
+        <rect x="147" y="502.89284" width="128" height="36" fill="white"/>
+        <rect x="147" y="502.89284" width="128" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(152 513.89284)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="31.654297" y="11">Resource</tspan>
+        </text>
+      </g>
+      <g id="Graphic_531">
+        <rect x="276" y="572.89284" width="61.985916" height="36" fill="white"/>
+        <rect x="276" y="572.89284" width="61.985916" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(281 583.89284)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="8.989052" y="11">Script</tspan>
+        </text>
+      </g>
+      <g id="Line_532">
+        <path d="M 243 552.14284 L 243 590.89284 L 266.1 590.89284" marker-end="url(#StickArrow_Marker)" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_533">
+        <text transform="translate(259.32857 594.4069)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="0" y="9">*</tspan>
+        </text>
+      </g>
+      <g id="Graphic_534">
+        <rect x="276" y="642" width="80" height="36" fill="white"/>
+        <rect x="276" y="642" width="80" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(281 653)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="10.337891" y="11">TModule</tspan>
+        </text>
+      </g>
+      <g id="Line_535">
+        <path d="M 211 552.14284 L 211 660 L 266.1 660" marker-end="url(#StickArrow_Marker)" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_536">
+        <text transform="translate(260.9498 663.5141)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="0" y="9">*</tspan>
+        </text>
+      </g>
+      <g id="Line_391">
+        <line x1="474.89626" y1="448.1423" x2="475.91276" y2="562.9932" marker-end="url(#StickArrow_Marker)" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_392">
+        <text transform="translate(464.2631 542.517)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="0" y="9">1</tspan>
+        </text>
+      </g>
+      <g id="Graphic_537">
+        <text transform="translate(478.1221 551.40215)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="0" y="9">intermediateModel</tspan>
+        </text>
+      </g>
+      <g id="Graphic_538">
+        <rect x="428.00037" y="572.89284" width="96" height="36" fill="white"/>
+        <rect x="428.00037" y="572.89284" width="96" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(433.00037 583.89284)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="19.331055" y="11">ScriptIM</tspan>
+        </text>
+      </g>
+      <g id="Line_539">
+        <line x1="428.00037" y1="590.89284" x2="351.4859" y2="590.89284" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_540">
+        <line x1="442.779" y1="416.89284" x2="283.61487" y2="507.0149" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_541">
+        <text transform="translate(292.5568 505.3935)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="0" y="9">1</tspan>
+        </text>
+      </g>
+      <g id="Graphic_542">
+        <text transform="translate(304.41084 496.58324)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="0" y="9">resource</tspan>
+        </text>
+      </g>
+      <g id="Line_553">
+        <line x1="506.6013" y1="277.07886" x2="506.76455" y2="388.99285" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_554">
+        <text transform="translate(495.2301 371.37744)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="0" y="9">1</tspan>
+        </text>
+      </g>
+      <g id="Graphic_555">
+        <text transform="translate(480.50373 379.2227)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="0" y="9">state</tspan>
+        </text>
+      </g>
+      <g id="Graphic_563">
+        <rect x="568.0078" y="485.5701" width="155" height="36" fill="white"/>
+        <rect x="568.0078" y="485.5701" width="155" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(573.0078 496.5701)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="15.49414" y="11">InformationRegistry</tspan>
+        </text>
+      </g>
+      <g id="Line_564">
+        <path d="M 538.779 448.14284 L 538.779 460.14284 L 645.5078 460.14284 L 645.5078 475.6701" marker-end="url(#StickArrow_Marker)" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_565">
+        <text transform="translate(649.0129 462.2001)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="0" y="9">1</tspan>
+        </text>
+      </g>
+      <g id="Graphic_566">
+        <text transform="translate(619.62836 465.05107)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="0" y="9">info</tspan>
+        </text>
+      </g>
+      <g id="Graphic_571">
+        <rect x="568.0078" y="572.89284" width="155" height="36" fill="white"/>
+        <rect x="568.0078" y="572.89284" width="155" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(573.0078 583.89284)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="54.48242" y="11">Tracer</tspan>
+        </text>
+      </g>
+      <g id="Line_572">
+        <line x1="758.5" y1="416.5639" x2="580.679" y2="416.8755" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_573">
+        <text transform="translate(596.5062 402.6647)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="0" y="9">1</tspan>
+        </text>
+      </g>
+      <g id="Graphic_574">
+        <text transform="translate(590.22794 421.59583)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="0" y="9">state</tspan>
+        </text>
+      </g>
+      <g id="Line_575">
+        <path d="M 506.779 448.14284 L 506.779 539.14284 L 645.5078 539.14284 L 645.5078 562.99284" marker-end="url(#StickArrow_Marker)" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_576">
+        <text transform="translate(633.991 542.0277)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="0" y="9">1</tspan>
+        </text>
+      </g>
+      <g id="Graphic_577">
+        <text transform="translate(658.6631 550.2155)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="0" y="9">tracer</tspan>
+        </text>
+      </g>
+      <g id="Group_583">
+        <g id="Graphic_586">
+          <rect x="258.65922" y="221.27618" width="495.80206" height="55.30268" fill="white"/>
+          <rect x="258.65922" y="221.27618" width="495.80206" height="55.30268" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(263.65922 226.27618)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="0" y="11">transpile</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" y="11">(N4JSResource resource, Writer outCode)</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="25">abstract Transformation[] </tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" y="25">computeTransformationsToBeExecuted</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" y="25">(TranspilerState state)</tspan>
+          </text>
+        </g>
+        <g id="Graphic_585">
+          <rect x="258.65922" y="196.20615" width="495.80206" height="21.768381" fill="white"/>
+          <rect x="258.65922" y="196.20615" width="495.80206" height="21.768381" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(263.65922 201.20615)" fill="black">
+            <tspan font-family="Helvetica Neue" font-size="12" font-style="italic" font-weight="700" fill="black" x="190.23303" y="12">AbstractTranspiler</tspan>
+          </text>
+        </g>
+        <g id="Graphic_584">
+          <rect x="258.65922" y="217.39883" width="495.80206" height="5.528181" fill="white"/>
+          <rect x="258.65922" y="217.39883" width="495.80206" height="5.528181" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+      </g>
+      <g id="Group_587">
+        <g id="Graphic_592">
+          <rect x="531.6631" y="345.31353" width="280" height="24" fill="white"/>
+          <rect x="531.6631" y="345.31353" width="280" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(536.6631 350.31353)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="11">computeTransformationsToBeExecuted(state)</tspan>
+          </text>
+        </g>
+        <g id="Graphic_589">
+          <rect x="531.6631" y="317.75453" width="280" height="24" fill="white"/>
+          <rect x="531.6631" y="317.75453" width="280" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(536.6631 322.75453)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="73.30371" y="11">EcmaScriptTranspiler</tspan>
+          </text>
+        </g>
+        <g id="Graphic_588">
+          <rect x="531.6631" y="340.75553" width="280" height="4.55847" fill="white"/>
+          <rect x="531.6631" y="340.75553" width="280" height="4.55847" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+      </g>
+      <g id="Line_591">
+        <path d="M 671.6631 317.25453 L 671.6631 301.75453 L 671.8276 292.07886 L 671.8276 290.07886" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_164">
+        <path d="M 820.78125 317.75453 C 853.4569 317.95723 868.6631 347.21992 870.3987 388.0258" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_594">
+        <path d="M 820 311.14174 C 907.8005 310.67634 896.6222 204.48448 767.89565 199.82077" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_595">
+        <text transform="translate(870 292.63054)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="12" font-style="italic" font-weight="400" fill="black" x="0" y="11">concrete transpiler creates actual </tspan>
+          <tspan font-family="Helvetica Neue" font-size="12" font-style="italic" font-weight="400" fill="black" x="0" y="25.336">transformations and passes them </tspan>
+          <tspan font-family="Helvetica Neue" font-size="12" font-style="italic" font-weight="400" fill="black" x="0" y="39.671997">to AbstractTransformation via </tspan>
+          <tspan font-family="Helvetica Neue" font-size="12" font-style="italic" font-weight="400" fill="black" x="0" y="54.007996">abstract method</tspan>
+        </text>
+      </g>
+      <g id="Graphic_599">
+        <text transform="translate(130.41084 696)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="14" font-style="italic" font-weight="400" fill="black" x="0" y="13">original resource to transpile</tspan>
+        </text>
+      </g>
+      <g id="Graphic_601">
+        <text transform="translate(424 625.8676)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="14" font-style="italic" font-weight="400" fill="black" x="0" y="13">main internal data used by transpiler</tspan>
+        </text>
+      </g>
+      <g id="Graphic_602">
+        <rect x="809.7652" y="670.1176" width="160.5" height="36" fill="white"/>
+        <rect x="809.7652" y="670.1176" width="160.5" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(814.7652 681.1176)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="13.240234" y="11">TranspilerComponent</tspan>
+        </text>
+      </g>
+      <g id="Line_165">
+        <path d="M 890.0152 670.1176 L 890.0152 654.6176 L 890.0152 642.6176 L 943.5 642.6176 L 943.5 518.1974 L 943.5 516.1974" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_603">
+        <rect x="767.0152" y="562.6176" width="121" height="52.40693" fill="white"/>
+        <rect x="767.0152" y="562.6176" width="121" height="52.40693" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(772.0152 573.473)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="12" font-style="italic" font-weight="700" fill="black" x="11.94" y="12">Transformation</tspan>
+          <tspan font-family="Helvetica Neue" font-size="12" font-style="italic" font-weight="700" fill="black" x="28.944" y="27.348083">Assistant</tspan>
+        </text>
+      </g>
+      <g id="Line_604">
+        <path d="M 890.0152 670.1176 L 890.0152 642.6176 L 827.5152 642.6176 L 827.5152 628.52455" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_605">
+        <line x1="827.0152" y1="548.1277" x2="827.0152" y2="518.9448" marker-end="url(#StickArrow_Marker)" marker-start="url(#StickArrow_Marker_2)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+    </g>
+  </g>
+</svg>
diff --git a/design/chapters/13_compilation/images/ad_PipelineOverview.svg b/design/chapters/13_compilation/images/ad_PipelineOverview.svg
new file mode 100644
index 0000000..1d86191
--- /dev/null
+++ b/design/chapters/13_compilation/images/ad_PipelineOverview.svg
@@ -0,0 +1,125 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xl="http://www.w3.org/1999/xlink" xmlns:dc="http://purl.org/dc/elements/1.1/" viewBox="2.5 7.815436 438.5 216.68456" width="438.5" height="216.68456">
+  <defs>
+    <font-face font-family="Helvetica" font-size="12" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica Neue" font-size="14" panose-1="2 0 5 3 0 0 0 2 0 4" units-per-em="1000" underline-position="-100" underline-thickness="50" slope="0" x-height="517" cap-height="714" ascent="951.9958" descent="-212.99744" font-weight="400">
+      <font-face-src>
+        <font-face-name name="HelveticaNeue"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica Neue" font-size="16" panose-1="2 0 5 3 0 0 0 2 0 4" units-per-em="1000" underline-position="-100" underline-thickness="50" slope="0" x-height="517" cap-height="714" ascent="951.9958" descent="-212.99744" font-weight="400">
+      <font-face-src>
+        <font-face-name name="HelveticaNeue"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica Neue" font-size="10" panose-1="2 0 5 3 0 0 0 2 0 4" units-per-em="1000" underline-position="-100" underline-thickness="50" slope="0" x-height="517" cap-height="714" ascent="951.9958" descent="-212.99744" font-weight="400">
+      <font-face-src>
+        <font-face-name name="HelveticaNeue"/>
+      </font-face-src>
+    </font-face>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="StickArrow_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -4 10 8" markerWidth="10" markerHeight="8" color="black">
+      <g>
+        <path d="M 8 0 L 0 0 M 0 -3 L 8 0 L 0 3" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <font-face font-family="Helvetica Neue" font-size="10" panose-1="2 0 5 3 0 0 0 9 0 4" units-per-em="1000" underline-position="-100" underline-thickness="50" slope="-1200" x-height="517" cap-height="714" ascent="957.0007" descent="-212.99744" font-style="italic" font-weight="400">
+      <font-face-src>
+        <font-face-name name="HelveticaNeue-Italic"/>
+      </font-face-src>
+    </font-face>
+  </defs>
+  <metadata> Produced by OmniGraffle 7.11 
+    <dc:date>2016-01-19 09:36:25 +0000</dc:date>
+  </metadata>
+  <g id="Canvas_1" stroke="none" stroke-opacity="1" stroke-dasharray="none" fill="none" fill-opacity="1">
+    <title>Canvas 1</title>
+    <rect fill="white" x="2.5" y="7.815436" width="438.5" height="216.68456"/>
+    <g id="Canvas_1: Layer 1">
+      <title>Layer 1</title>
+      <g id="Graphic_274">
+        <path d="M 177.6 19.065436 L 266.6 19.065436 C 269.36142 19.065436 271.6 21.304012 271.6 24.065436 L 271.6 50.065436 C 271.6 52.82686 269.36142 55.065436 266.6 55.065436 L 177.6 55.065436 C 174.83858 55.065436 172.6 52.82686 172.6 50.065436 L 172.6 24.065436 C 172.6 21.304012 174.83858 19.065436 177.6 19.065436 Z" fill="white"/>
+        <path d="M 177.6 19.065436 L 266.6 19.065436 C 269.36142 19.065436 271.6 21.304012 271.6 24.065436 L 271.6 50.065436 C 271.6 52.82686 269.36142 55.065436 266.6 55.065436 L 177.6 55.065436 C 174.83858 55.065436 172.6 52.82686 172.6 50.065436 L 172.6 24.065436 C 172.6 21.304012 174.83858 19.065436 177.6 19.065436 Z" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(177.6 30.065436)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="1.1376953" y="11">PreparationStep</tspan>
+        </text>
+      </g>
+      <g id="Graphic_273">
+        <circle cx="10.7" cy="37.065436" r="7.7000123038446" fill="black"/>
+        <circle cx="10.7" cy="37.065436" r="7.7000123038446" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_272">
+        <rect x="65" y="8.315436" width="70" height="57.5" fill="white"/>
+        <rect x="65" y="8.315436" width="70" height="57.5" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(70 13.505439)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="14" font-weight="400" fill="black" x="6.018" y="13">Original</tspan>
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="400" fill="black" x="15.04" y="31.392">AST</tspan>
+          <tspan font-family="Helvetica Neue" font-size="10" font-weight="400" fill="black" x="4.445" y="44.839996">(n4js.xcore)</tspan>
+        </text>
+      </g>
+      <g id="Line_271">
+        <line x1="18.900004" y1="37.065436" x2="54.6" y2="37.065436" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_270">
+        <line x1="135.5" y1="37.065436" x2="162.2" y2="37.065436" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_269">
+        <rect x="193.6" y="89.81544" width="57" height="57.5" fill="white"/>
+        <rect x="193.6" y="89.81544" width="57" height="57.5" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(198.6 103.20144)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="400" fill="black" x="14.46" y="15">IM</tspan>
+          <tspan font-family="Helvetica Neue" font-size="10" font-weight="400" fill="black" x="1.465" y="28.447998">(IM.xcore)</tspan>
+        </text>
+      </g>
+      <g id="Graphic_268">
+        <path d="M 298 100.56544 L 387 100.56544 C 389.76142 100.56544 392 102.80401 392 105.56544 L 392 131.56544 C 392 134.32686 389.76142 136.56544 387 136.56544 L 298 136.56544 C 295.23858 136.56544 293 134.32686 293 131.56544 L 293 105.56544 C 293 102.80401 295.23858 100.56544 298 100.56544 Z" fill="white"/>
+        <path d="M 298 100.56544 L 387 100.56544 C 389.76142 100.56544 392 102.80401 392 105.56544 L 392 131.56544 C 392 134.32686 389.76142 136.56544 387 136.56544 L 298 136.56544 C 295.23858 136.56544 293 134.32686 293 131.56544 L 293 105.56544 C 293 102.80401 295.23858 100.56544 298 100.56544 Z" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(298 111.56544)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="1.3720703" y="11">Transformations</tspan>
+        </text>
+      </g>
+      <g id="Line_267">
+        <path d="M 251.0156 99.224 C 280.52094 98.92726 275.26175 77.18121 293 71.14094 C 308.84837 65.74422 335.18134 66.24073 341.24686 90.74449" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_265">
+        <line x1="222.1" y1="147.81544" x2="222.1" y2="177.6" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_264">
+        <path d="M 172.3 188 L 271.9 188 C 274.66142 188 276.9 190.23858 276.9 193 L 276.9 219 C 276.9 221.76142 274.66142 224 271.9 224 L 172.3 224 C 169.53858 224 167.3 221.76142 167.3 219 L 167.3 193 C 167.3 190.23858 169.53858 188 172.3 188 Z" fill="white"/>
+        <path d="M 172.3 188 L 271.9 188 C 274.66142 188 276.9 190.23858 276.9 193 L 276.9 219 C 276.9 221.76142 274.66142 224 271.9 224 L 172.3 224 C 169.53858 224 167.3 221.76142 167.3 219 L 167.3 193 C 167.3 190.23858 169.53858 188 172.3 188 Z" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(172.3 199)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="1.4425774" y="11">PrettyPrintingStep</tspan>
+        </text>
+      </g>
+      <g id="Line_263">
+        <line x1="222.1" y1="55.065436" x2="222.1" y2="79.41544" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Group_259">
+        <g id="Graphic_261">
+          <circle cx="334.4" cy="206" r="11.0000175769209" fill="white"/>
+          <circle cx="334.4" cy="206" r="11.0000175769209" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_260">
+          <circle cx="334.4" cy="206" r="7.7000123038446" fill="black"/>
+          <circle cx="334.4" cy="206" r="7.7000123038446" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+      </g>
+      <g id="Line_258">
+        <line x1="276.9" y1="206" x2="313" y2="206" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_275">
+        <path d="M 342.5 136.56544 C 343.62416 163.08725 320.80537 177.1812 302.01342 169.12752 C 285.37227 161.9956 283.47272 141.99531 260.89116 137.68734" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_276">
+        <text transform="translate(352 71.56544)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="10" font-style="italic" font-weight="400" fill="black" x="0" y="10">actual transpilation</tspan>
+          <tspan font-family="Helvetica Neue" font-size="10" font-style="italic" font-weight="400" fill="black" x="0" y="22.28">happens here:</tspan>
+        </text>
+      </g>
+    </g>
+  </g>
+</svg>
diff --git a/design/chapters/13_compilation/images/cd_GeneratorAndBuilderParticipant.svg b/design/chapters/13_compilation/images/cd_GeneratorAndBuilderParticipant.svg
new file mode 100644
index 0000000..75f1dba
--- /dev/null
+++ b/design/chapters/13_compilation/images/cd_GeneratorAndBuilderParticipant.svg
@@ -0,0 +1,224 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xl="http://www.w3.org/1999/xlink" xmlns:dc="http://purl.org/dc/elements/1.1/" viewBox="-.5000024 62.166665 476.1737 383.38932" width="476.1737" height="383.38932">
+  <defs>
+    <font-face font-family="Helvetica" font-size="10" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="12" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="532.22656" cap-height="719.7266" ascent="770.0195" descent="-229.98047" font-weight="700">
+      <font-face-src>
+        <font-face-name name="Helvetica-Bold"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="15" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="16" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="532.22656" cap-height="719.7266" ascent="770.0195" descent="-229.98047" font-weight="700">
+      <font-face-src>
+        <font-face-name name="Helvetica-Bold"/>
+      </font-face-src>
+    </font-face>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="UMLInheritance_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -8 14 16" markerWidth="14" markerHeight="16" color="black">
+      <g>
+        <path d="M 12 0 L 0 -7 L 0 7 Z" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="StickArrow_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -4 10 8" markerWidth="10" markerHeight="8" color="black">
+      <g>
+        <path d="M 8 0 L 0 0 M 0 -3 L 8 0 L 0 3" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="FilledDiamond_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-9 -4 10 8" markerWidth="10" markerHeight="8" color="black">
+      <g>
+        <path d="M -8 0 L -4 3 L 0 0 L -4 -3 Z" fill="currentColor" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="Diamond_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-9 -4 10 8" markerWidth="10" markerHeight="8" color="black">
+      <g>
+        <path d="M -8 0 L -4 3 L 0 0 L -4 -3 Z" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <font-face font-family="Helvetica" font-size="9" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="12" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+  </defs>
+  <metadata> Produced by OmniGraffle 7.11 
+    <dc:date>2017-12-06 08:23:42 +0000</dc:date>
+  </metadata>
+  <g id="Canvas_1" stroke="none" stroke-opacity="1" stroke-dasharray="none" fill="none" fill-opacity="1">
+    <title>Canvas 1</title>
+    <rect fill="white" x="0" y="62.166665" width="475.6737" height="383.38932"/>
+    <g id="Canvas_1: Layer 1">
+      <title>Layer 1</title>
+      <g id="Graphic_33">
+        <rect x="-23884544e-13" y="323.77676" width="139.82634" height="41.555556" fill="white"/>
+        <rect x="-23884544e-13" y="323.77676" width="139.82634" height="41.555556" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(4.9999976 331.55453)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="23.492271" y="10">o.e.n4js.generator.</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="5.2354355" y="23">CompositeGenerator</tspan>
+        </text>
+      </g>
+      <g id="Graphic_32">
+        <rect x="364.89966" y="72.66667" width="110.27402" height="41.555556" fill="white"/>
+        <rect x="364.89966" y="72.66667" width="110.27402" height="41.555556" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(369.89966 73.444444)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="13.723438" y="10">o.e.xtext.builder.</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="13.1292" y="23">IXtextBuilder</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="19.1292" y="37">Participant</tspan>
+        </text>
+      </g>
+      <g id="Graphic_31">
+        <rect x="364.89965" y="160.66667" width="110.27402" height="41.555556" fill="white"/>
+        <rect x="364.89965" y="160.66667" width="110.27402" height="41.555556" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(369.89965 161.44444)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="13.723438" y="10">o.e.xtext.builder.</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="29.468067" y="23">Builder</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="19.1292" y="37">Participant</tspan>
+        </text>
+      </g>
+      <g id="Graphic_30">
+        <rect x="364.89965" y="317.00043" width="110.27401" height="61.3329" fill="white"/>
+        <rect x="364.89965" y="317.00043" width="110.27401" height="61.3329" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(369.89965 324.1669)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="15">o.e.n4js</tspan>
+          <tspan font-family="Helvetica" font-size="15" font-weight="400" fill="black" y="15">.</tspan>
+          <tspan font-family="Helvetica" font-size="16" font-weight="700" fill="black" y="15">ui</tspan>
+          <tspan font-family="Helvetica" font-size="15" font-weight="400" fill="black" y="15">.</tspan>
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" y="15">building.</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="14.45927" y="30">N4JSBuilder</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="19.129192" y="44">Participant</tspan>
+        </text>
+      </g>
+      <g id="Line_29">
+        <line x1="420.03667" y1="160.16667" x2="420.03667" y2="127.72222" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_28">
+        <line x1="420.03665" y1="317.00043" x2="420.03665" y2="215.72222" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_27">
+        <line x1="355.6497" y1="181.41509" x2="128.94975" y2="180.6956" marker-end="url(#StickArrow_Marker)" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_26">
+        <text transform="translate(247.82337 169.14453)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«@Inject»</tspan>
+        </text>
+      </g>
+      <g id="Line_25">
+        <line x1="355.14967" y1="347.64636" x2="320.84067" y2="347.57415" marker-end="url(#StickArrow_Marker)" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_24">
+        <rect x="1.7465057" y="407.556" width="136.7465" height="36" fill="white"/>
+        <rect x="1.7465057" y="407.556" width="136.7465" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(6.746506 405.556)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x=".548542" y="10">o.e.n4js.generator.headless.</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="37.02364" y="23">Headless</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="37.369343" y="37">Compiler</tspan>
+        </text>
+      </g>
+      <g id="Line_23">
+        <line x1="70.07205" y1="397.8061" x2="69.961605" y2="375.2322" marker-end="url(#StickArrow_Marker)" marker-start="url(#Diamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_22">
+        <text transform="translate(58.43234 367.20025)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="0" y="9">1</tspan>
+        </text>
+      </g>
+      <g id="Line_21">
+        <path d="M 69.91317 234.05307 L 69.91317 218.60862 L 69.5498 218.60862 L 69.5498 216.66417" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_20">
+        <rect x="200.66667" y="326.77553" width="110.27402" height="41.555556" fill="white"/>
+        <rect x="200.66667" y="326.77553" width="110.27402" height="41.555556" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(205.66667 328.5533)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="7.329395" y="10">o.e.n4js.ui.building.</tspan>
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="24.848927" y="22">instructions</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="4.1409187" y="35">BuildInstruction</tspan>
+        </text>
+      </g>
+      <g id="Group_15">
+        <g id="Graphic_19">
+          <rect x="20.049802" y="158.16417" width="99" height="45" fill="white"/>
+          <rect x="20.049802" y="158.16417" width="99" height="45" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(25.049802 167.66417)" fill="black">
+            <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="1.6923828" y="10">o.e.xtext.generator.</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="14.157227" y="23">IGenerator</tspan>
+          </text>
+        </g>
+        <g id="Group_16">
+          <g id="Graphic_18">
+            <circle cx="109.2998" cy="167.91417" r="6.7500107858378" fill="white"/>
+            <circle cx="109.2998" cy="167.91417" r="6.7500107858378" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width=".5"/>
+          </g>
+          <g id="Line_17">
+            <line x1="109.2998" y1="174.91418" x2="109.2998" y2="179.16417" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+        </g>
+      </g>
+      <g id="Group_10">
+        <g id="Graphic_14">
+          <rect x="-7947287e-14" y="234.55307" width="139.82634" height="45" fill="white"/>
+          <rect x="-7947287e-14" y="234.55307" width="139.82634" height="45" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(5 244.05307)" fill="black">
+            <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="23.492271" y="10">o.e.n4js.generator.</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="3.5684433" y="23">ICompositeGenerator</tspan>
+          </text>
+        </g>
+        <g id="Group_11">
+          <g id="Graphic_13">
+            <ellipse cx="126.05556" cy="244.30307" rx="9.5336293057127" ry="6.75001078583782" fill="white"/>
+            <ellipse cx="126.05556" cy="244.30307" rx="9.5336293057127" ry="6.75001078583782" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width=".5"/>
+          </g>
+          <g id="Line_12">
+            <line x1="126.05556" y1="251.30307" x2="126.05556" y2="255.55307" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+        </g>
+      </g>
+      <g id="Line_9">
+        <line x1="69.91317" y1="323.77676" x2="69.91317" y2="293.05307" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_8">
+        <text transform="translate(322.83065 353.11134)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="0" y="9">1</tspan>
+        </text>
+      </g>
+      <g id="Graphic_7">
+        <text transform="translate(136.16398 190.33333)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="0" y="9">1</tspan>
+        </text>
+      </g>
+      <g id="Graphic_6">
+        <path d="M 316.7465 85.98108 C 316.7465 78.51716 314.5611 77.59372 298.59725 70.207015 L 298.4286 70.13059 C 282.38045 62.666665 282.21353 62.666665 265.74377 62.666665 C 243.8139 62.666665 144.66667 62.666665 144.66667 62.666665 L 144.66667 141.4582 L 316.7465 141.4582 L 316.7465 85.98108 Z" fill="white"/>
+        <path d="M 316.7465 85.98108 C 316.7465 78.51716 314.5611 77.59372 298.59725 70.207015 L 298.4286 70.13059 C 282.38045 62.666665 282.21353 62.666665 265.74377 62.666665 C 243.8139 62.666665 144.66667 62.666665 144.66667 62.666665 L 144.66667 141.4582 L 316.7465 141.4582 L 316.7465 85.98108 Z M 316.7465 85.59658 C 316.7465 78.51716 316.57787 78.51716 282.21353 78.51716 L 282.21353 78.51716 C 282.21353 62.74388 282.21353 62.666665 266.75216 62.666665" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(149.66667 67.06243)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="5.779175" y="11">We bypass Xtext IGenerator </tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="61.69226" y="25">used in </tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="18.67566" y="39">IXtextBuilderParticipant</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="4.654175" y="53">The actual generator binding </tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="12.66687" y="67">is done in BuildInstruction</tspan>
+        </text>
+      </g>
+      <g id="Line_5">
+        <line x1="232.20793" y1="141.95785" x2="233.67822" y2="181.02798" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_4">
+        <line x1="191.41705" y1="344.0843" x2="149.72593" y2="344.4643" marker-end="url(#StickArrow_Marker)" marker-start="url(#Diamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_3">
+        <text transform="translate(316.98268 328.77676)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«creates»</tspan>
+        </text>
+      </g>
+    </g>
+  </g>
+</svg>
diff --git a/design/chapters/13_compilation/images/cd_SubGenerators.svg b/design/chapters/13_compilation/images/cd_SubGenerators.svg
new file mode 100644
index 0000000..629be3c
--- /dev/null
+++ b/design/chapters/13_compilation/images/cd_SubGenerators.svg
@@ -0,0 +1,295 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xl="http://www.w3.org/1999/xlink" xmlns:dc="http://purl.org/dc/elements/1.1/" viewBox="5.75 45.5 538.75 491.72046" width="538.75" height="491.72046">
+  <defs>
+    <font-face font-family="Helvetica" font-size="10" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="9" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="12" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="532.22656" cap-height="719.7266" ascent="770.0195" descent="-229.98047" font-weight="700">
+      <font-face-src>
+        <font-face-name name="Helvetica-Bold"/>
+      </font-face-src>
+    </font-face>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="UMLInheritance_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -8 14 16" markerWidth="14" markerHeight="16" color="black">
+      <g>
+        <path d="M 12 0 L 0 -7 L 0 7 Z" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <font-face font-family="Helvetica" font-size="8" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="7" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="StickArrow_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -4 10 8" markerWidth="10" markerHeight="8" color="black">
+      <g>
+        <path d="M 8 0 L 0 0 M 0 -3 L 8 0 L 0 3" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="FilledDiamond_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-9 -4 10 8" markerWidth="10" markerHeight="8" color="black">
+      <g>
+        <path d="M -8 0 L -4 3 L 0 0 L -4 -3 Z" fill="currentColor" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+  </defs>
+  <metadata> Produced by OmniGraffle 7.11 
+    <dc:date>2019-08-02 08:19:11 +0000</dc:date>
+  </metadata>
+  <g id="Canvas_1" stroke="none" stroke-opacity="1" stroke-dasharray="none" fill="none" fill-opacity="1">
+    <title>Canvas 1</title>
+    <rect fill="white" x="5.75" y="45.5" width="538.75" height="491.72046"/>
+    <g id="Canvas_1: Layer 1">
+      <title>Layer 1</title>
+      <g id="Graphic_45">
+        <rect x="25" y="123.5" width="103.68" height="36" fill="white"/>
+        <rect x="25" y="123.5" width="103.68" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(30 123)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="22.101227" y="10">«interface»</tspan>
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="19.066559" y="21">o.e.generator.</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="16.497223" y="34">IGenerator</tspan>
+        </text>
+      </g>
+      <g id="Graphic_44">
+        <rect x="182" y="193.22046" width="99" height="36" fill="white"/>
+        <rect x="182" y="193.22046" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(187 192.72046)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="19.76123" y="10">«interface»</tspan>
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="16.726562" y="21">o.e.generator.</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="2.8251953" y="34">ISubGenerator</tspan>
+        </text>
+      </g>
+      <g id="Graphic_43">
+        <rect x="27" y="193.22046" width="99" height="36" fill="white"/>
+        <rect x="27" y="193.22046" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(32 197.22046)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="11.831055" y="11">IComposite</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="15.824219" y="25">Generator</tspan>
+        </text>
+      </g>
+      <g id="Line_42">
+        <path d="M 76.5 193.22046 L 76.5 177.72046 L 76.84 175 L 76.84 173" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_41">
+        <rect x="182" y="439.50617" width="99" height="39.857143" fill="white"/>
+        <rect x="182" y="439.50617" width="99" height="39.857143" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(187 439.93474)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="6.059326" y="9">o.e.n4js</tspan>
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" y="9">.transpiler.es</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="11.485352" y="22">EcmaScript</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="4.4921875" y="36">SubGenerator</tspan>
+        </text>
+      </g>
+      <g id="Graphic_40">
+        <rect x="100.5" y="378.2919" width="99" height="39.857143" fill="white"/>
+        <rect x="100.5" y="378.2919" width="99" height="39.857143" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(105.5 380.22046)" fill="black">
+          <tspan font-family="Helvetica" font-size="7" font-weight="400" fill="black" x="5.974365" y="6">o.e.n4js.generator.eciOS</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="25.829102" y="19">ECiOS</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="15.824219" y="33">Generator</tspan>
+        </text>
+      </g>
+      <g id="Line_39">
+        <line x1="231.5" y1="269.72046" x2="231.5" y2="242.72046" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_38">
+        <rect x="266.5" y="500.72046" width="125.5" height="36" fill="white"/>
+        <rect x="266.5" y="500.72046" width="125.5" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(271.5 506.22046)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="23.779297" y="9">o.e.</tspan>
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" y="9">n4js.generator.</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="1.7373047" y="22">CompilerDescriptor</tspan>
+        </text>
+      </g>
+      <g id="Graphic_37">
+        <rect x="375.5" y="276.9775" width="125.5" height="36" fill="white"/>
+        <rect x="375.5" y="276.9775" width="125.5" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(380.5 276.4775)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="24.393066" y="10">«enumeration»</tspan>
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="20.471191" y="21">o.e.n4js.generator.</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="2.0683594" y="34">CompilerProperties</tspan>
+        </text>
+      </g>
+      <g id="Graphic_36">
+        <rect x="157.75" y="269.72046" width="147.5" height="36" fill="white"/>
+        <rect x="157.75" y="269.72046" width="147.5" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(162.75 269.22046)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="45.40283" y="10">«abstract»</tspan>
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="40.976562" y="21">o.e.generator.</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="4.402344" y="34">AbstractSubGenerator</tspan>
+        </text>
+      </g>
+      <g id="Line_35">
+        <path d="M 199.5 398.22046 L 231.5 398.22046 L 231.5 319.22046" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_34">
+        <line x1="231.5" y1="439.00617" x2="231.5" y2="319.22046" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_33">
+        <path d="M 76.5 229.22046 L 77.5 459.72046 L 171.60004 459.4632" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_32">
+        <path d="M 101.25 229.22046 L 151 319.22046 L 150.16757 368.3933" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_31">
+        <rect x="364.5" y="209.73454" width="147.5" height="36" fill="white"/>
+        <rect x="364.5" y="209.73454" width="147.5" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(369.5 215.23454)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="31.47119" y="9">o.e.n4js.generator.</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="1.7041016" y="22">N4JSPreferenceAccess</tspan>
+        </text>
+      </g>
+      <g id="Line_30">
+        <line x1="305.25" y1="275.72046" x2="356.80665" y2="233.9653" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_29">
+        <rect x="364.5" y="344.22046" width="147.5" height="36" fill="white"/>
+        <rect x="364.5" y="344.22046" width="147.5" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(369.5 349.72046)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="31.47119" y="9">o.e.n4js.generator.</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="17.416016" y="22">OutputPathHelper</tspan>
+        </text>
+      </g>
+      <g id="Line_28">
+        <line x1="305.25" y1="299.72046" x2="357.68894" y2="355.0358" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_27">
+        <rect x="364.5" y="406.22046" width="147.5" height="36" fill="white"/>
+        <rect x="364.5" y="406.22046" width="147.5" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(369.5 411.72046)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="35.729492" y="9">o.e.n4js.naming.</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="32.073242" y="22">N4MFReader</tspan>
+        </text>
+      </g>
+      <g id="Line_26">
+        <line x1="438.25" y1="380.22046" x2="438.25" y2="396.32046" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_25">
+        <rect x="355.625" y="141.5" width="165.25" height="42.23453" fill="white"/>
+        <rect x="355.625" y="141.5" width="165.25" height="42.23453" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(360.625 144.11726)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="52.88623" y="10">«interface»</tspan>
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="34.35205" y="21">o.e.xtext.preferences.</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="1.5791016" y="34">IPreferenceValuesProvider</tspan>
+        </text>
+      </g>
+      <g id="Line_24">
+        <line x1="438.25" y1="209.73454" x2="438.25" y2="193.63453" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_23">
+        <line x1="258.4774" y1="314.65527" x2="305.77103" y2="491.1578" marker-end="url(#StickArrow_Marker)" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_22">
+        <line x1="283.7721" y1="314.4336" x2="346.843" y2="491.39505" marker-end="url(#StickArrow_Marker)" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_21">
+        <text transform="translate(347.32 478.04)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="0" y="8">«default»</tspan>
+        </text>
+      </g>
+      <g id="Graphic_20">
+        <text transform="translate(305.20312 478.04)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="0" y="8">«current»</tspan>
+        </text>
+      </g>
+      <g id="Line_19">
+        <line x1="438.25" y1="245.73454" x2="438.25" y2="267.0775" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_18">
+        <text transform="translate(446 253.85602)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«uses»</tspan>
+        </text>
+      </g>
+      <g id="Graphic_17">
+        <rect x="418.5" y="46" width="125.5" height="42.23453" fill="white"/>
+        <rect x="418.5" y="46" width="125.5" height="42.23453" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(423.5 47.617264)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="14.47705" y="9">o.e.xtext.preferences.</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="2.381836" y="22">EclipsePreferences</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="33.407227" y="36">Provider</tspan>
+        </text>
+      </g>
+      <g id="Line_16">
+        <path d="M 481.25 88.23453 L 481.25 114.73453 L 438.25 114.73453 L 438.25 128" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_15">
+        <rect x="265.5" y="46" width="142" height="42.23453" fill="white"/>
+        <rect x="265.5" y="46" width="142" height="42.23453" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(270.5 47.617264)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="9.457764" y="9">o.e.n4js.generator.headless.</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="7.977539" y="22">PropertiesFileBased</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="7.300781" y="36">PreferencesProvider</tspan>
+        </text>
+      </g>
+      <g id="Line_14">
+        <path d="M 336.5 88.23453 L 336.5 114.73453 L 438.25 114.73453 L 438.25 128" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_13">
+        <path d="M 27 211 L 6.25 211 L 11 521 L 256.60008 520.03875" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_12">
+        <text transform="translate(247.24878 509)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="0" y="9">*</tspan>
+        </text>
+      </g>
+      <g id="Graphic_11">
+        <text transform="translate(446 190.73454)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«uses»</tspan>
+        </text>
+      </g>
+      <g id="Graphic_10">
+        <text transform="translate(105.5 466.9409)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«doGenerate»</tspan>
+        </text>
+      </g>
+      <g id="Graphic_9">
+        <text transform="translate(86 346)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«doGenerate»</tspan>
+        </text>
+      </g>
+      <g id="Graphic_8">
+        <text transform="translate(26 504)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«collects sub generators default configuration»</tspan>
+        </text>
+      </g>
+      <g id="Graphic_7">
+        <text transform="translate(445 386.22045)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«path calculation»</tspan>
+        </text>
+      </g>
+      <g id="Graphic_6">
+        <rect x="160.5" y="122.7275" width="142" height="36" fill="white"/>
+        <rect x="160.5" y="122.7275" width="142" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(165.5 122.2275)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="40.42383" y="10">«singleton»</tspan>
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="38.226562" y="21">o.e.generator.</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="1.9833984" y="34">SubGeneratorRegistry</tspan>
+        </text>
+      </g>
+      <g id="Line_5">
+        <line x1="231.5" y1="167.9775" x2="231.5" y2="193.22046" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_4">
+        <text transform="translate(235 178.72046)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">0..*</tspan>
+        </text>
+      </g>
+      <g id="Graphic_3">
+        <text transform="translate(163 164.22046)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">registered via </tspan>
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="22">extension point</tspan>
+        </text>
+      </g>
+    </g>
+  </g>
+</svg>
diff --git a/design/chapters/13_compilation/images/cd_Transpilers.svg b/design/chapters/13_compilation/images/cd_Transpilers.svg
new file mode 100644
index 0000000..bae2087
--- /dev/null
+++ b/design/chapters/13_compilation/images/cd_Transpilers.svg
@@ -0,0 +1,265 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xl="http://www.w3.org/1999/xlink" xmlns:dc="http://purl.org/dc/elements/1.1/" viewBox="0 0 560 783" width="560" height="783">
+  <defs>
+    <font-face font-family="Helvetica" font-size="11" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="11" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="-1090.9091" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-style="italic" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica-Oblique"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="12" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="532.22656" cap-height="719.7266" ascent="770.0195" descent="-229.98047" font-weight="700">
+      <font-face-src>
+        <font-face-name name="Helvetica-Bold"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="12" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="FilledDiamond_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-9 -4 10 8" markerWidth="10" markerHeight="8" color="black">
+      <g>
+        <path d="M -8 0 L -4 3 L 0 0 L -4 -3 Z" fill="currentColor" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <font-face font-family="Helvetica" font-size="9" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="10" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="12" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="-1e3" x-height="539.5508" cap-height="719.7266" ascent="770.0195" descent="-229.98047" font-style="italic" font-weight="700">
+      <font-face-src>
+        <font-face-name name="Helvetica-BoldOblique"/>
+      </font-face-src>
+    </font-face>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="UMLInheritance_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -8 14 16" markerWidth="14" markerHeight="16" color="black">
+      <g>
+        <path d="M 12 0 L 0 -7 L 0 7 Z" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+  </defs>
+  <metadata> Produced by OmniGraffle 7.11 
+    <dc:date>2019-07-31 11:17:59 +0000</dc:date>
+  </metadata>
+  <g id="Canvas_1" stroke="none" stroke-opacity="1" stroke-dasharray="none" fill="none" fill-opacity="1">
+    <title>Canvas 1</title>
+    <rect fill="white" x="0" y="0" width="560" height="783"/>
+    <g id="Canvas_1: Layer 1">
+      <title>Layer 1</title>
+      <g id="Group_529">
+        <g id="Graphic_532">
+          <rect x="157.68" y="139.40359" width="166.6356" height="88" fill="white"/>
+          <rect x="157.68" y="139.40359" width="166.6356" height="88" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(162.68 144.40359)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10"># transformAST(EObject):T</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="23"># transformParserTree(Node):T</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-style="italic" font-weight="400" fill="black" x="0" y="36"># process(Node):T</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-style="italic" font-weight="400" fill="black" x="0" y="49"># process(String):T</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-style="italic" font-weight="400" fill="black" x="0" y="62"># getNewTranspilerResult():T</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-style="italic" font-weight="400" fill="black" x="0" y="75"># storeIssue(Issue)</tspan>
+          </text>
+        </g>
+        <g id="Graphic_531">
+          <rect x="157.68" y="90.85212" width="166.6356" height="52" fill="white"/>
+          <rect x="157.68" y="90.85212" width="166.6356" height="52" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(162.68 95.85212)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="35.289482" y="11">ASTParserTree</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="13.779716" y="25">Traverser&lt;R,T extends </tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="27.79534" y="39">TranspilerResult&gt;</tspan>
+          </text>
+        </g>
+        <g id="Graphic_530">
+          <rect x="157.68" y="139.40359" width="166.6356" height="3.4485276" fill="white"/>
+          <rect x="157.68" y="139.40359" width="166.6356" height="3.4485276" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+      </g>
+      <g id="Graphic_545">
+        <rect x="56.834534" y="307.74663" width="113.16547" height="84.55147" fill="white"/>
+        <rect x="56.834534" y="307.74663" width="113.16547" height="84.55147" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(61.834534 322.02236)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="20.58078" y="11">Composed</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="9.732147" y="25">Transpiler&lt;R,T </tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="28.906952" y="39">extends </tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="1.0602722" y="53">TranspilerResult&gt;</tspan>
+        </text>
+      </g>
+      <g id="Group_557">
+        <g id="Graphic_560">
+          <rect x="286.70926" y="352.6587" width="164.37716" height="23.704355" fill="white"/>
+          <rect x="286.70926" y="352.6587" width="164.37716" height="23.704355" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(291.70926 357.6587)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">+ processAST(EObject)</tspan>
+          </text>
+        </g>
+        <g id="Graphic_559">
+          <rect x="286.70926" y="323.22614" width="164.37716" height="53.59245" fill="white"/>
+          <rect x="286.70926" y="323.22614" width="164.37716" height="53.59245" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(291.70926 328.22614)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="17.663185" y="11">TranspilerPolicy&lt;R,T </tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="2.3233414" y="25">extends TranspilerResult&gt;</tspan>
+          </text>
+        </g>
+        <g id="Graphic_558">
+          <rect x="286.70926" y="360.8803" width="164.37716" height="7.445423" fill="white"/>
+          <rect x="286.70926" y="360.8803" width="164.37716" height="7.445423" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+      </g>
+      <g id="Graphic_148">
+        <path d="M 464.6 257.35368 C 464.6 251.7212 463.7745 251.02435 457.74444 245.45014 L 457.68074 245.39247 C 451.61884 239.76 451.5558 239.76 445.33464 239.76 C 437.05104 239.76 399.6 239.76 399.6 239.76 L 399.6 299.2182 L 464.6 299.2182 L 464.6 257.35368 Z" fill="white"/>
+        <path d="M 464.6 257.35368 C 464.6 251.7212 463.7745 251.02435 457.74444 245.45014 L 457.68074 245.39247 C 451.61884 239.76 451.5558 239.76 445.33464 239.76 C 437.05104 239.76 399.6 239.76 399.6 239.76 L 399.6 299.2182 L 464.6 299.2182 L 464.6 257.35368 Z M 464.6 257.06352 C 464.6 251.7212 464.5363 251.7212 451.5558 251.7212 L 451.5558 251.7212 C 451.5558 239.81826 451.5558 239.76 445.71554 239.76" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(404.6 252.2182)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="11">Delegates </tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="25">to host by </tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="39">default</tspan>
+        </text>
+      </g>
+      <g id="Line_188">
+        <line x1="399.21907" y1="297.4458" x2="368.89784" y2="323.22614" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_378">
+        <line x1="179.25" y1="350.02237" x2="286.70926" y2="350.02235" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_379">
+        <text transform="translate(269.4382 350.56887)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="0" y="9">*</tspan>
+        </text>
+      </g>
+      <g id="Graphic_380">
+        <text transform="translate(185.50034 336.4991)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="0" y="9">1</tspan>
+        </text>
+      </g>
+      <g id="Graphic_381">
+        <text transform="translate(190.53712 354.02237)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">host</tspan>
+        </text>
+      </g>
+      <g id="Graphic_555">
+        <text transform="translate(247.1707 338.02235)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">policies</tspan>
+        </text>
+      </g>
+      <g id="Graphic_284">
+        <ellipse cx="227.4359" cy="402.36" rx="50.7535810991139" ry="15.0000239685284" fill="white"/>
+        <path d="M 263.324 391.7534 C 283.14457 397.61126 283.14457 407.1087 263.324 412.9666 C 243.50355 418.82447 211.36826 418.82447 191.5478 412.9666 C 171.72724 407.1087 171.72724 397.61126 191.5478 391.7534 C 211.36826 385.8955 243.50355 385.8955 263.324 391.7534" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+        <text transform="translate(191.8331 395.36)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="20.262955" y="11">policy</tspan>
+        </text>
+      </g>
+      <g id="Line_24">
+        <line x1="266.38286" y1="392.44883" x2="327.80354" y2="376.8186" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_285">
+        <text transform="translate(279.6725 369.8697)" fill="black">
+          <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">policy</tspan>
+        </text>
+      </g>
+      <g id="Line_563">
+        <line x1="170" y1="371.16023" x2="202.73426" y2="388.9418" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_564">
+        <text transform="translate(179.5609 365.444)" fill="black">
+          <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">host</tspan>
+        </text>
+      </g>
+      <g id="Graphic_613">
+        <path d="M 119.32 199.75368 C 119.32 194.1212 118.3167 193.42435 110.98787 187.85015 L 110.91045 187.79247 C 103.54291 182.16 103.46628 182.16 95.90519 182.16 C 85.83743 182.16 40.32 182.16 40.32 182.16 L 40.32 241.6182 L 119.32 241.6182 L 119.32 199.75368 Z" fill="white"/>
+        <path d="M 119.32 199.75368 C 119.32 194.1212 118.3167 193.42435 110.98787 187.85015 L 110.91045 187.79247 C 103.54291 182.16 103.46628 182.16 95.90519 182.16 C 85.83743 182.16 40.32 182.16 40.32 182.16 L 40.32 241.6182 L 119.32 241.6182 L 119.32 199.75368 Z M 119.32 199.46352 C 119.32 194.1212 119.24258 194.1212 103.46628 194.1212 L 103.46628 194.1212 C 103.46628 182.21826 103.46628 182.16 96.36813 182.16" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(45.32 184.6182)" fill="black">
+          <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">holds state </tspan>
+          <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="23">(e.g., issues, </tspan>
+          <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="36">symbol </tspan>
+          <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="49">tables, etc.)</tspan>
+        </text>
+      </g>
+      <g id="Line_614">
+        <line x1="81.4932" y1="242.11743" x2="85.09827" y2="307.2474" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Group_615">
+        <g id="Graphic_618">
+          <rect x="358.1151" y="155.89404" width="169.06474" height="36" fill="white"/>
+          <rect x="358.1151" y="155.89404" width="169.06474" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(363.1151 160.89404)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="11">+ append(R) : void</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="25">+ getRawValue(): R</tspan>
+          </text>
+        </g>
+        <g id="Graphic_617">
+          <rect x="358.1151" y="126.36167" width="169.06474" height="23" fill="white"/>
+          <rect x="358.1151" y="126.36167" width="169.06474" height="23" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(363.1151 131.36167)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-style="italic" font-weight="700" fill="black" x="21.172997" y="11">TranspilerResult</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" y="11">&lt;R&gt;</tspan>
+          </text>
+        </g>
+        <g id="Graphic_616">
+          <rect x="358.1151" y="147.35272" width="169.06474" height="8.793121" fill="white"/>
+          <rect x="358.1151" y="147.35272" width="169.06474" height="8.793121" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+      </g>
+      <g id="Line_619">
+        <path d="M 113.41727 307.74663 L 113.41727 268.24663 L 240.9978 268.24663 L 240.9978 240.9036" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_620">
+        <path d="M 327.80355 323.22614 L 327.80355 267.72614 L 240.9978 267.72614 L 240.9978 240.9036" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Group_621">
+        <g id="Graphic_624">
+          <rect x="286.70926" y="513.3351" width="169.06474" height="21" fill="white"/>
+          <rect x="286.70926" y="513.3351" width="169.06474" height="21" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(291.70926 518.3351)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="11">+ getMessage():String</tspan>
+          </text>
+        </g>
+        <g id="Graphic_623">
+          <rect x="286.70926" y="488.88" width="169.06474" height="23.981527" fill="white"/>
+          <rect x="286.70926" y="488.88" width="169.06474" height="23.981527" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(291.70926 493.88)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="64.1896" y="11">Issue</tspan>
+          </text>
+        </g>
+        <g id="Graphic_622">
+          <rect x="286.70926" y="508.4014" width="169.06474" height="4.460119" fill="white"/>
+          <rect x="286.70926" y="508.4014" width="169.06474" height="4.460119" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+      </g>
+      <g id="Group_625">
+        <g id="Graphic_628">
+          <rect x="56.83454" y="476.5981" width="166.6356" height="88" fill="white"/>
+          <rect x="56.83454" y="476.5981" width="166.6356" height="88" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(61.83454 481.5981)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10"># transformAST(EObject):T</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="23"># transformParserTree(Node):T</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-style="italic" font-weight="400" fill="black" x="0" y="36"># process(Node):T</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-style="italic" font-weight="400" fill="black" x="0" y="49"># process(String):T</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-style="italic" font-weight="400" fill="black" x="0" y="62"># getNewTranspilerResult():T</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-style="italic" font-weight="400" fill="black" x="0" y="75"># storeIssue(Issue)</tspan>
+          </text>
+        </g>
+        <g id="Graphic_627">
+          <rect x="56.83454" y="428.04663" width="166.6356" height="52" fill="white"/>
+          <rect x="56.83454" y="428.04663" width="166.6356" height="52" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(61.83454 433.04663)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="35.289482" y="11">ASTParserTree</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="13.779716" y="25">Traverser&lt;R,T extends </tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="27.79534" y="39">TranspilerResult&gt;</tspan>
+          </text>
+        </g>
+        <g id="Graphic_626">
+          <rect x="56.834534" y="476.5981" width="166.6356" height="3.4485276" fill="white"/>
+          <rect x="56.834534" y="476.5981" width="166.6356" height="3.4485276" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+      </g>
+    </g>
+  </g>
+</svg>
diff --git a/design/chapters/13_compilation/images/comp_compilers.svg b/design/chapters/13_compilation/images/comp_compilers.svg
new file mode 100644
index 0000000..08ada2a
--- /dev/null
+++ b/design/chapters/13_compilation/images/comp_compilers.svg
@@ -0,0 +1,317 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xl="http://www.w3.org/1999/xlink" xmlns:dc="http://purl.org/dc/elements/1.1/" viewBox="71.49997 27.21808 648 396.8275" width="648" height="396.8275">
+  <defs>
+    <font-face font-family="Helvetica" font-size="12" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="532.22656" cap-height="719.7266" ascent="770.0195" descent="-229.98047" font-weight="700">
+      <font-face-src>
+        <font-face-name name="Helvetica-Bold"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="11" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="10" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="StickArrow_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -4 10 8" markerWidth="10" markerHeight="8" color="black">
+      <g>
+        <path d="M 8 0 L 0 0 M 0 -3 L 8 0 L 0 3" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <font-face font-family="Helvetica" font-size="8" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="-1500" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-style="italic" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica-Oblique"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="9" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="-1333.3333" x-height="539.5508" cap-height="719.7266" ascent="770.0195" descent="-229.98047" font-style="italic" font-weight="700">
+      <font-face-src>
+        <font-face-name name="Helvetica-BoldOblique"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="13" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="532.22656" cap-height="719.7266" ascent="770.0195" descent="-229.98047" font-weight="700">
+      <font-face-src>
+        <font-face-name name="Helvetica-Bold"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="8" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="9" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="532.22656" cap-height="719.7266" ascent="770.0195" descent="-229.98047" font-weight="700">
+      <font-face-src>
+        <font-face-name name="Helvetica-Bold"/>
+      </font-face-src>
+    </font-face>
+  </defs>
+  <metadata> Produced by OmniGraffle 7.11 
+    <dc:date>2019-07-31 11:18:23 +0000</dc:date>
+  </metadata>
+  <g id="Canvas_1" stroke="none" stroke-opacity="1" stroke-dasharray="none" fill="none" fill-opacity="1">
+    <title>Canvas 1</title>
+    <rect fill="white" x="71.49997" y="27.21808" width="648" height="396.8275"/>
+    <g id="Canvas_1: Layer 1">
+      <title>Layer 1</title>
+      <g id="Graphic_65">
+        <rect x="71.99997" y="73" width="647" height="242" fill="#c4dcfa" fill-opacity=".51"/>
+        <rect x="71.99997" y="73" width="647" height="242" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(76.99997 78)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="594.3379" y="11">plugins</tspan>
+        </text>
+      </g>
+      <g id="Graphic_64">
+        <rect x="71.99997" y="330.78192" width="647" height="92.76365" fill="#76f2a3" fill-opacity=".52"/>
+        <rect x="71.99997" y="330.78192" width="647" height="92.76365" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(76.99997 404.5456)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="608.9863" y="11">tests</tspan>
+        </text>
+      </g>
+      <g id="Group_57">
+        <g id="Graphic_63">
+          <rect x="515.4927" y="92.73011" width="87.56572" height="45.75" fill="white"/>
+          <rect x="515.4927" y="92.73011" width="87.56572" height="45.75" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(520.4927 102.10511)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="17.991356" y="10">o.e.n4js.</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="11.440086" y="24">transpiler</tspan>
+          </text>
+        </g>
+        <g id="Group_58">
+          <g id="Graphic_62">
+            <rect x="592.3737" y="95.80348" width="7.075933" height="9.290779" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Graphic_61">
+            <rect x="590.70834" y="97.28153" width="3.3267305" height="1.6435796" fill="white"/>
+            <rect x="590.70834" y="97.28153" width="3.3267305" height="1.6435796" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width=".5"/>
+          </g>
+          <g id="Graphic_60">
+            <rect x="590.70834" y="100.7057" width="3.3267305" height="1.6435796" fill="white"/>
+            <rect x="590.70834" y="100.7057" width="3.3267305" height="1.6435796" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width=".5"/>
+          </g>
+          <g id="Graphic_59"/>
+        </g>
+      </g>
+      <g id="Group_50">
+        <g id="Graphic_56">
+          <rect x="461" y="171.125" width="87.56572" height="45.75" fill="white"/>
+          <rect x="461" y="171.125" width="87.56572" height="45.75" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(466 180.5)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="17.991356" y="10">o.e.n4js.</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="3.427391" y="24">transpiler.es</tspan>
+          </text>
+        </g>
+        <g id="Group_51">
+          <g id="Graphic_55">
+            <rect x="537.881" y="174.19837" width="7.075933" height="9.290779" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Graphic_54">
+            <rect x="536.2156" y="175.67642" width="3.3267305" height="1.6435796" fill="white"/>
+            <rect x="536.2156" y="175.67642" width="3.3267305" height="1.6435796" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width=".5"/>
+          </g>
+          <g id="Graphic_53">
+            <rect x="536.2156" y="179.1006" width="3.3267305" height="1.6435796" fill="white"/>
+            <rect x="536.2156" y="179.1006" width="3.3267305" height="1.6435796" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width=".5"/>
+          </g>
+          <g id="Graphic_52"/>
+        </g>
+      </g>
+      <g id="Group_43">
+        <g id="Graphic_49">
+          <rect x="567" y="171.125" width="87.56572" height="45.75" fill="white"/>
+          <rect x="567" y="171.125" width="87.56572" height="45.75" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(572 173.5)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="17.991356" y="10">o.e.n4js.</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="10.101219" y="24">transpiler.</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="18.105125" y="38">sample</tspan>
+          </text>
+        </g>
+        <g id="Group_44">
+          <g id="Graphic_48">
+            <rect x="643.881" y="174.19838" width="7.075933" height="9.290779" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Graphic_47">
+            <rect x="642.2156" y="175.67643" width="3.3267305" height="1.6435796" fill="white"/>
+            <rect x="642.2156" y="175.67643" width="3.3267305" height="1.6435796" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width=".5"/>
+          </g>
+          <g id="Graphic_46">
+            <rect x="642.2156" y="179.1006" width="3.3267305" height="1.6435796" fill="white"/>
+            <rect x="642.2156" y="179.1006" width="3.3267305" height="1.6435796" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width=".5"/>
+          </g>
+          <g id="Graphic_45"/>
+        </g>
+      </g>
+      <g id="Graphic_42">
+        <path d="M 504.53805 85.86168 C 504.53805 82.74824 502.903 82.36305 490.9592 79.28182 L 490.833 79.24994 C 478.82614 76.13651 478.70125 76.13651 466.37895 76.13651 C 449.97153 76.13651 375.7918 76.13651 375.7918 76.13651 L 375.7918 109.00291 L 504.53805 109.00291 L 504.53805 85.86168 Z" fill="#fff6bb" fill-opacity=".54"/>
+        <path d="M 504.53805 85.86168 C 504.53805 82.74824 502.903 82.36305 490.9592 79.28182 L 490.833 79.24994 C 478.82614 76.13651 478.70125 76.13651 466.37895 76.13651 C 449.97153 76.13651 375.7918 76.13651 375.7918 76.13651 L 375.7918 109.00291 L 504.53805 109.00291 L 504.53805 85.86168 Z M 504.53805 85.70129 C 504.53805 82.74824 504.4119 82.74824 478.70125 82.74824 L 478.70125 82.74824 C 478.70125 76.16872 478.70125 76.13651 467.1334 76.13651" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(380.7918 80.00291)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">Contains</tspan>
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="22">- AST-Parser-Tree Walker</tspan>
+        </text>
+      </g>
+      <g id="Graphic_41">
+        <path d="M 664.3086 260.34045 C 664.3086 254.0802 662.949 253.30567 653.01785 247.11017 L 652.9129 247.04606 C 642.9293 240.7858 642.8255 240.7858 632.5796 240.7858 C 618.9369 240.7858 557.25706 240.7858 557.25706 240.7858 L 557.25706 306.87114 L 664.3086 306.87114 L 664.3086 260.34045 Z" fill="#fff6bb" fill-opacity=".54"/>
+        <path d="M 664.3086 260.34045 C 664.3086 254.0802 662.949 253.30567 653.01785 247.11017 L 652.9129 247.04606 C 642.9293 240.7858 642.8255 240.7858 632.5796 240.7858 C 618.9369 240.7858 557.25706 240.7858 557.25706 240.7858 L 557.25706 306.87114 L 664.3086 306.87114 L 664.3086 260.34045 Z M 664.3086 260.01796 C 664.3086 254.0802 664.2037 254.0802 642.8255 254.0802 L 642.8255 254.0802 C 642.8255 240.85056 642.8255 240.7858 633.2069 240.7858" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(562.25706 241.87114)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">only for test pur-</tspan>
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="22">poses, to be </tspan>
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="34">removed. Some </tspan>
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="46">dependencies </tspan>
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="58">omitted in diagram.</tspan>
+        </text>
+      </g>
+      <g id="Line_40">
+        <line x1="526.6743" y1="171.125" x2="534.2981" y2="147.88682" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_39">
+        <line x1="610.4469" y1="170.75469" x2="587.8189" y2="145.81236" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Group_32">
+        <g id="Graphic_38">
+          <rect x="461.5657" y="365.5" width="87.56572" height="45.75" fill="white"/>
+          <rect x="461.5657" y="365.5" width="87.56572" height="45.75" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(466.5657 367.875)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="17.991356" y="10">o.e.n4js.</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="1.7603989" y="24">transpiler.es.</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="24.776024" y="38">tests</tspan>
+          </text>
+        </g>
+        <g id="Group_33">
+          <g id="Graphic_37">
+            <rect x="538.4467" y="368.57337" width="7.075933" height="9.290779" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Graphic_36">
+            <rect x="536.7813" y="370.05142" width="3.3267305" height="1.6435796" fill="white"/>
+            <rect x="536.7813" y="370.05142" width="3.3267305" height="1.6435796" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width=".5"/>
+          </g>
+          <g id="Graphic_35">
+            <rect x="536.7813" y="373.4756" width="3.3267305" height="1.6435796" fill="white"/>
+            <rect x="536.7813" y="373.4756" width="3.3267305" height="1.6435796" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width=".5"/>
+          </g>
+          <g id="Graphic_34"/>
+        </g>
+      </g>
+      <g id="Line_31">
+        <line x1="505.34856" y1="365.5" x2="504.82054" y2="226.77493" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_30">
+        <line x1="515.4927" y1="104.16761" x2="505.0322" y2="102.55705" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_29">
+        <line x1="610.78284" y1="240.2858" x2="610.78284" y2="217.375" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Group_22">
+        <g id="Graphic_28">
+          <rect x="225.43385" y="198" width="72.26377" height="32.866405" fill="white"/>
+          <rect x="225.43385" y="198" width="72.26377" height="32.866405" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(230.43385 198.4332)" fill="black">
+            <tspan font-family="Helvetica" font-size="8" font-style="italic" font-weight="400" fill="black" x="16.010792" y="8">o.e.n4js.</tspan>
+            <tspan font-family="Helvetica" font-size="9" font-style="italic" font-weight="700" fill="black" x="9.372364" y="19">generator.</tspan>
+            <tspan font-family="Helvetica" font-size="9" font-style="italic" font-weight="700" fill="black" x="11.870655" y="30">headless</tspan>
+          </text>
+        </g>
+        <g id="Group_23">
+          <g id="Graphic_27">
+            <rect x="288.88003" y="200.20788" width="5.839427" height="6.674416" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Graphic_26">
+            <rect x="287.50567" y="201.2697" width="2.7453904" height="1.1807334" fill="white"/>
+            <rect x="287.50567" y="201.2697" width="2.7453904" height="1.1807334" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width=".5"/>
+          </g>
+          <g id="Graphic_25">
+            <rect x="287.50567" y="203.7296" width="2.7453904" height="1.1807334" fill="white"/>
+            <rect x="287.50567" y="203.7296" width="2.7453904" height="1.1807334" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width=".5"/>
+          </g>
+          <g id="Graphic_24"/>
+        </g>
+      </g>
+      <g id="Graphic_21">
+        <rect x="217.78287" y="109.44" width="87.56572" height="45.75" fill="white"/>
+        <rect x="217.78287" y="109.44" width="87.56572" height="45.75" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(222.78287 117.815)" fill="black">
+          <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="17.991356" y="10">o.e.n4js.</tspan>
+          <tspan font-family="Helvetica" font-size="13" font-weight="700" fill="black" x="25.776512" y="26">n4js</tspan>
+        </text>
+      </g>
+      <g id="Graphic_20">
+        <path d="M 200.91994 113.38194 C 200.91994 104.59443 199.44775 103.50724 188.69385 94.81065 L 188.58025 94.72067 C 177.76955 85.93317 177.65711 85.93317 166.5624 85.93317 C 151.78956 85.93317 84.99994 85.93317 84.99994 85.93317 L 84.99994 178.69682 L 200.91994 178.69682 L 200.91994 113.38194 Z" fill="#fff6bb" fill-opacity=".54"/>
+        <path d="M 200.91994 113.38194 C 200.91994 104.59443 199.44775 103.50724 188.69385 94.81065 L 188.58025 94.72067 C 177.76955 85.93317 177.65711 85.93317 166.5624 85.93317 C 151.78956 85.93317 84.99994 85.93317 84.99994 85.93317 L 84.99994 178.69682 L 200.91994 178.69682 L 200.91994 113.38194 Z M 200.91994 112.92925 C 200.91994 104.59443 200.80633 104.59443 177.65711 104.59443 L 177.65711 104.59443 C 177.65711 86.02408 177.65711 85.93317 167.2417 85.93317" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(89.99994 89.69682)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">Contains</tspan>
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="22">- language model</tspan>
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="34">- Generator Interfaces</tspan>
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="46">- Unified Configuration</tspan>
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="58">  (PreferenceStore/CLI)</tspan>
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="70">- Composite N4JS </tspan>
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="82">Generator</tspan>
+        </text>
+      </g>
+      <g id="Line_19">
+        <line x1="217.28287" y1="132.315" x2="201.41994" y2="132.315" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_18">
+        <path d="M 292.56573 285.0914 C 292.56573 283.27574 291.77833 283.0511 286.0266 281.25423 L 285.96583 281.23564 C 280.1837 279.41998 280.12357 279.41998 274.18955 279.41998 C 266.28827 279.41998 230.56573 279.41998 230.56573 279.41998 L 230.56573 298.58664 L 292.56573 298.58664 L 292.56573 285.0914 Z" fill="#fff6bb" fill-opacity=".54"/>
+        <path d="M 292.56573 285.0914 C 292.56573 283.27574 291.77833 283.0511 286.0266 281.25423 L 285.96583 281.23564 C 280.1837 279.41998 280.12357 279.41998 274.18955 279.41998 C 266.28827 279.41998 230.56573 279.41998 230.56573 279.41998 L 230.56573 298.58664 L 292.56573 298.58664 L 292.56573 285.0914 Z M 292.56573 284.99786 C 292.56573 283.27574 292.50497 283.27574 280.12357 283.27574 L 280.12357 283.27574 C 280.12357 279.43877 280.12357 279.41998 274.55287 279.41998" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(235.56573 281.58664)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">Application</tspan>
+        </text>
+      </g>
+      <g id="Group_10">
+        <g id="Graphic_16">
+          <rect x="324" y="204.84987" width="53" height="19.166655" fill="white"/>
+          <rect x="324" y="204.84987" width="53" height="19.166655" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(329 208.9332)" fill="black">
+            <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="2.2409668" y="9">o.e.n4js</tspan>
+            <tspan font-family="Helvetica" font-size="9" font-weight="700" fill="black" y="9">.ui</tspan>
+          </text>
+        </g>
+        <g id="Group_11">
+          <g id="Graphic_15">
+            <rect x="370.53297" y="206.13744" width="4.282777" height="3.8923095" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Graphic_14">
+            <rect x="369.525" y="206.75666" width="2.0135358" height=".6885666" fill="white"/>
+            <rect x="369.525" y="206.75666" width="2.0135358" height=".6885666" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width=".5"/>
+          </g>
+          <g id="Graphic_13">
+            <rect x="369.525" y="208.1912" width="2.0135358" height=".6885666" fill="white"/>
+            <rect x="369.525" y="208.1912" width="2.0135358" height=".6885666" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width=".5"/>
+          </g>
+          <g id="Graphic_12"/>
+        </g>
+      </g>
+      <g id="Graphic_9">
+        <rect x="342.72" y="365.5" width="87.56572" height="45.75" fill="white"/>
+        <rect x="342.72" y="365.5" width="87.56572" height="45.75" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(347.72 374.875)" fill="black">
+          <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="17.991356" y="10">o.e.n4js.</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="5.103172" y="24">tests.helper</tspan>
+        </text>
+      </g>
+      <g id="Line_8">
+        <line x1="342.72" y1="399.8125" x2="300.03407" y2="224.05354" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_7">
+        <line x1="430.2857" y1="388.375" x2="479.9882" y2="226.33975" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_6">
+        <line x1="261.56573" y1="198" x2="261.56573" y2="165.09" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_5"/>
+      <g id="Line_4">
+        <line x1="261.56573" y1="278.91998" x2="261.56573" y2="240.7664" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_3">
+        <line x1="350.5" y1="204.84987" x2="310.58033" y2="140.71969" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_66">
+        <line x1="461" y1="194" x2="318.0365" y2="141.20786" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_67">
+        <line x1="275.08414" y1="279.12503" x2="342.50667" y2="229.85748" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+    </g>
+  </g>
+</svg>
diff --git a/design/chapters/13_compilation/images/od_generatorInjection.svg b/design/chapters/13_compilation/images/od_generatorInjection.svg
new file mode 100644
index 0000000..753c287
--- /dev/null
+++ b/design/chapters/13_compilation/images/od_generatorInjection.svg
@@ -0,0 +1,384 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xl="http://www.w3.org/1999/xlink" xmlns:dc="http://purl.org/dc/elements/1.1/" viewBox="13.9 29.727304 519.65065 562.1063" width="519.65065" height="562.1063">
+  <defs>
+    <font-face font-family="Helvetica" font-size="11" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="12" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="532.22656" cap-height="719.7266" ascent="770.0195" descent="-229.98047" font-weight="700">
+      <font-face-src>
+        <font-face-name name="Helvetica-Bold"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="11" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="532.22656" cap-height="719.7266" ascent="770.0195" descent="-229.98047" font-weight="700">
+      <font-face-src>
+        <font-face-name name="Helvetica-Bold"/>
+      </font-face-src>
+    </font-face>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="StickArrow_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -4 10 8" markerWidth="10" markerHeight="8" color="black">
+      <g>
+        <path d="M 8 0 L 0 0 M 0 -3 L 8 0 L 0 3" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <font-face font-family="Helvetica" font-size="10" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="UMLInheritance_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -8 14 16" markerWidth="14" markerHeight="16" color="black">
+      <g>
+        <path d="M 12 0 L 0 -7 L 0 7 Z" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="FilledDiamond_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-9 -4 10 8" markerWidth="10" markerHeight="8" color="black">
+      <g>
+        <path d="M -8 0 L -4 3 L 0 0 L -4 -3 Z" fill="currentColor" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+  </defs>
+  <metadata> Produced by OmniGraffle 7.11 
+    <dc:date>2019-07-31 11:25:25 +0000</dc:date>
+  </metadata>
+  <g id="Canvas_1" stroke="none" stroke-opacity="1" stroke-dasharray="none" fill="none" fill-opacity="1">
+    <title>Canvas 1</title>
+    <rect fill="white" x="13.9" y="29.727304" width="519.65065" height="562.1063"/>
+    <g id="Canvas_1: Layer 1">
+      <title>Layer 1</title>
+      <g id="Group_68">
+        <g id="Graphic_74">
+          <rect x="190.6482" y="445.4614" width="202.74357" height="145.87222" fill="#e0ffe1"/>
+          <rect x="190.6482" y="445.4614" width="202.74357" height="145.87222" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(195.6482 450.4614)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="47.90645" y="11">o.e.n4js.</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" y="11">generator</tspan>
+          </text>
+        </g>
+        <g id="Group_69">
+          <g id="Graphic_73">
+            <rect x="382.70705" y="448.53475" width="7.075933" height="9.290779" fill="#e0ffe1"/>
+            <rect x="382.70705" y="448.53475" width="7.075933" height="9.290779" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Graphic_72">
+            <rect x="381.04167" y="450.0128" width="3.3267305" height="1.6435796" fill="#e0ffe1"/>
+            <rect x="381.04167" y="450.0128" width="3.3267305" height="1.6435796" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width=".5"/>
+          </g>
+          <g id="Graphic_71">
+            <rect x="381.04167" y="453.43697" width="3.3267305" height="1.6435796" fill="#e0ffe1"/>
+            <rect x="381.04167" y="453.43697" width="3.3267305" height="1.6435796" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width=".5"/>
+          </g>
+          <g id="Graphic_70">
+            <rect x="383.26607" y="450.224" width="6.516114" height="7.601537" fill="#e0ffe1"/>
+          </g>
+        </g>
+      </g>
+      <g id="Group_61">
+        <g id="Graphic_67">
+          <rect x="279.55638" y="30.227304" width="253.05065" height="134" fill="#d2e6f1"/>
+          <rect x="279.55638" y="30.227304" width="253.05065" height="134" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(284.55638 35.227304)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="100.34563" y="11">o.e.</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" y="11">n4js</tspan>
+          </text>
+        </g>
+        <g id="Group_62">
+          <g id="Graphic_66">
+            <rect x="524.35287" y="33.050542" width="5.466294" height="8.534623" fill="#d2e6f1"/>
+            <rect x="524.35287" y="33.050542" width="5.466294" height="8.534623" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Graphic_65">
+            <rect x="523.06633" y="34.4083" width="2.569963" height="1.5098123" fill="#d2e6f1"/>
+            <rect x="523.06633" y="34.4083" width="2.569963" height="1.5098123" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width=".5"/>
+          </g>
+          <g id="Graphic_64">
+            <rect x="523.06633" y="37.553782" width="2.569963" height="1.5098123" fill="#d2e6f1"/>
+            <rect x="523.06633" y="37.553782" width="2.569963" height="1.5098123" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width=".5"/>
+          </g>
+          <g id="Graphic_63">
+            <rect x="524.7847" y="34.60232" width="5.033823" height="6.982864" fill="#d2e6f1"/>
+          </g>
+        </g>
+      </g>
+      <g id="Graphic_60">
+        <rect x="294.5" y="105.94644" width="99" height="36" fill="white"/>
+        <rect x="294.5" y="105.94644" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(299.5 110.94644)" fill="black">
+          <tspan font-family="Helvetica" font-size="11" font-weight="700" fill="black" x="30.741943" y="10">N4JS</tspan>
+          <tspan font-family="Helvetica" font-size="11" font-weight="700" fill="black" x="3.2526855" y="23">RuntimeModule</tspan>
+        </text>
+      </g>
+      <g id="Graphic_59">
+        <rect x="380.9492" y="54.94644" width="141" height="36" fill="white"/>
+        <rect x="380.9492" y="54.94644" width="141" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(385.9492 65.94644)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="1.4863281" y="11">N4JSStandaloneSetup</tspan>
+        </text>
+      </g>
+      <g id="Line_58">
+        <line x1="380.9492" y1="72.94644" x2="344" y2="105.94644" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_57">
+        <rect x="60.22" y="535.1034" width="99" height="36" fill="white"/>
+        <rect x="60.22" y="535.1034" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(65.22 539.1034)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="11.485352" y="11">EcmaScript</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="4.4921875" y="25">SubGenerator</tspan>
+        </text>
+      </g>
+      <g id="Graphic_56">
+        <rect x="434.05065" y="535.1034" width="99" height="36" fill="white"/>
+        <rect x="434.05065" y="535.1034" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(439.05065 539.1034)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="26.825195" y="11">JSiOS</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="4.4921875" y="25">SubGenerator</tspan>
+        </text>
+      </g>
+      <g id="Group_49">
+        <g id="Graphic_55">
+          <rect x="14.4" y="30.227304" width="250.52532" height="400.3327" fill="#fffec8"/>
+          <rect x="14.4" y="30.227304" width="250.52532" height="400.3327" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(19.4 35.227304)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="94.13912" y="11">o.e.n4js.</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" y="11">ui</tspan>
+          </text>
+        </g>
+        <g id="Group_50">
+          <g id="Graphic_54">
+            <rect x="256.75353" y="33.413195" width="5.411743" height="9.63092" fill="#fffec8"/>
+            <rect x="256.75353" y="33.413195" width="5.411743" height="9.63092" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Graphic_53">
+            <rect x="255.47984" y="34.94536" width="2.544316" height="1.703752" fill="#fffec8"/>
+            <rect x="255.47984" y="34.94536" width="2.544316" height="1.703752" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width=".5"/>
+          </g>
+          <g id="Graphic_52">
+            <rect x="255.47984" y="38.49489" width="2.544316" height="1.703752" fill="#fffec8"/>
+            <rect x="255.47984" y="38.49489" width="2.544316" height="1.703752" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width=".5"/>
+          </g>
+          <g id="Graphic_51">
+            <rect x="257.18108" y="35.164304" width="4.983588" height="7.879834" fill="#fffec8"/>
+          </g>
+        </g>
+      </g>
+      <g id="Group_42">
+        <g id="Graphic_48">
+          <rect x="279.55637" y="179.1287" width="253.05065" height="251.4313" fill="#ffd7d5"/>
+          <rect x="279.55637" y="179.1287" width="253.05065" height="251.4313" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(284.55637 184.1287)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="46.03948" y="11">o.e.n4js.</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" y="11">generator.headless</tspan>
+          </text>
+        </g>
+        <g id="Group_43">
+          <g id="Graphic_47">
+            <rect x="524.35287" y="181.95193" width="5.466294" height="8.534623" fill="#ffd7d5"/>
+            <rect x="524.35287" y="181.95193" width="5.466294" height="8.534623" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Graphic_46">
+            <rect x="523.06633" y="183.30969" width="2.569963" height="1.5098123" fill="#ffd7d5"/>
+            <rect x="523.06633" y="183.30969" width="2.569963" height="1.5098123" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width=".5"/>
+          </g>
+          <g id="Graphic_45">
+            <rect x="523.06633" y="186.45517" width="2.569963" height="1.5098123" fill="#ffd7d5"/>
+            <rect x="523.06633" y="186.45517" width="2.569963" height="1.5098123" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width=".5"/>
+          </g>
+          <g id="Graphic_44">
+            <rect x="524.7847" y="183.5037" width="5.033823" height="6.982864" fill="#ffd7d5"/>
+          </g>
+        </g>
+      </g>
+      <g id="Graphic_41">
+        <rect x="222.96204" y="535.1034" width="90.55795" height="36" fill="white"/>
+        <rect x="222.96204" y="535.1034" width="90.55795" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(227.96204 540.1034)" fill="black">
+          <tspan font-family="Helvetica" font-size="11" font-weight="700" fill="black" x="3.6051483" y="10">SubGenerator</tspan>
+          <tspan font-family="Helvetica" font-size="11" font-weight="700" fill="black" x="18.27092" y="23">Registry</tspan>
+        </text>
+      </g>
+      <g id="Graphic_40">
+        <rect x="218.76233" y="471.3975" width="99" height="36" fill="white"/>
+        <rect x="218.76233" y="471.3975" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(223.76233 476.3975)" fill="black">
+          <tspan font-family="Helvetica" font-size="11" font-weight="700" fill="black" x="2.3234863" y="10">N4JSComposite</tspan>
+          <tspan font-family="Helvetica" font-size="11" font-weight="700" fill="black" x="18.213867" y="23">Generator</tspan>
+        </text>
+      </g>
+      <g id="Line_39">
+        <line x1="268.26233" y1="507.3975" x2="268.24863" y2="525.2034" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_38">
+        <text transform="translate(270.05954 512.3975)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«queries»</tspan>
+        </text>
+      </g>
+      <g id="Graphic_37">
+        <rect x="66.5" y="329.61047" width="124" height="36" fill="white"/>
+        <rect x="66.5" y="329.61047" width="124" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(71.5 341.11047)" fill="black">
+          <tspan font-family="Helvetica" font-size="11" font-weight="700" fill="black" x="14.836914" y="10">BuildInstruction</tspan>
+        </text>
+      </g>
+      <g id="Graphic_36">
+        <rect x="112.66052" y="235.69833" width="135.41974" height="36" fill="white"/>
+        <rect x="112.66052" y="235.69833" width="135.41974" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(117.66052 247.19833)" fill="black">
+          <tspan font-family="Helvetica" font-size="11" font-weight="700" fill="black" x="1.5814514" y="10">N4JSBuilderParticipant</tspan>
+        </text>
+      </g>
+      <g id="Graphic_35">
+        <rect x="22.449905" y="76.0769" width="99" height="36" fill="white"/>
+        <rect x="22.449905" y="76.0769" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(27.449905 87.5769)" fill="black">
+          <tspan font-family="Helvetica" font-size="11" font-weight="700" fill="black" x="6.902344" y="10">N4JSActivator</tspan>
+        </text>
+      </g>
+      <g id="Graphic_34">
+        <rect x="37.5" y="179.25235" width="99" height="36" fill="white"/>
+        <rect x="37.5" y="179.25235" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(42.5 190.75235)" fill="black">
+          <tspan font-family="Helvetica" font-size="11" font-weight="700" fill="black" x="5.994629" y="10">N4JSUiModule</tspan>
+        </text>
+      </g>
+      <g id="Graphic_33">
+        <rect x="158.5" y="139.73167" width="99" height="36" fill="white"/>
+        <rect x="158.5" y="139.73167" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(163.5 144.73167)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="26.990234" y="10">..guice..</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="22.829102" y="23">Injector</tspan>
+        </text>
+      </g>
+      <g id="Line_32">
+        <line x1="121.4499" y1="94.0769" x2="183.25" y2="139.73167" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_31">
+        <text transform="translate(141.74344 91.66278) rotate(36.455104)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">&gt; creates</tspan>
+        </text>
+      </g>
+      <g id="Graphic_30">
+        <text transform="translate(244.0417 122.39496) rotate(-14.339508)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">uses &lt;</tspan>
+        </text>
+      </g>
+      <g id="Line_29">
+        <line x1="294.5" y1="123.94644" x2="232.75" y2="139.73167" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_28">
+        <text transform="translate(156.6459 196.29204) rotate(41.22983)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">binds &gt;</tspan>
+        </text>
+      </g>
+      <g id="Line_27">
+        <line x1="136.5" y1="197.25235" x2="180.3704" y2="235.69833" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_26">
+        <text transform="translate(128.757 308.33976) rotate(-48.150024)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">creates &gt;</tspan>
+        </text>
+      </g>
+      <g id="Line_25">
+        <line x1="180.3704" y1="271.69833" x2="128.5" y2="329.61047" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_24">
+        <text transform="translate(166.10184 376.51337) rotate(37.122316)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">&gt; creates via injector</tspan>
+        </text>
+      </g>
+      <g id="Line_23">
+        <line x1="267.86366" y1="471.09573" x2="128.5" y2="365.61047" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_22">
+        <text transform="translate(106.45383 158.77656) rotate(-16.75122)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">uses &lt;</tspan>
+        </text>
+      </g>
+      <g id="Line_21">
+        <line x1="87" y1="179.25235" x2="158.5" y2="157.73166" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_20">
+        <rect x="425.3042" y="290.81023" width="99" height="36" fill="white"/>
+        <rect x="425.3042" y="290.81023" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(430.3042 302.31023)" fill="black">
+          <tspan font-family="Helvetica" font-size="11" font-weight="700" fill="black" x="31.971924" y="10">Main</tspan>
+        </text>
+      </g>
+      <g id="Graphic_19">
+        <rect x="339.17743" y="208.8603" width="124" height="36" fill="white"/>
+        <rect x="339.17743" y="208.8603" width="124" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(344.17743 212.8603)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="15.641602" y="11">N4JSHeadless</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="7.995117" y="25">StandaloneSetup</tspan>
+        </text>
+      </g>
+      <g id="Line_18">
+        <path d="M 401.17743 208.8603 L 401.17743 150.3603 L 451.4492 150.3603 L 451.4492 104.44644" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_17">
+        <rect x="294.5" y="290.81023" width="124" height="36" fill="white"/>
+        <rect x="294.5" y="290.81023" width="124" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(299.5 294.81023)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="15.641602" y="11">N4JSHeadless</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="7.3271484" y="25">GeneratorModule</tspan>
+        </text>
+      </g>
+      <g id="Graphic_16">
+        <text transform="translate(359.671 267.46598) rotate(-45.80444)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">uses &lt;</tspan>
+        </text>
+      </g>
+      <g id="Line_15">
+        <line x1="356.5" y1="290.81023" x2="401.17743" y2="244.8603" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_14">
+        <line x1="339.17743" y1="226.8603" x2="257.5" y2="157.73167" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_13">
+        <text transform="translate(294.58025 170.77375) rotate(40.24329)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">&lt; creates</tspan>
+        </text>
+      </g>
+      <g id="Line_12">
+        <line x1="474.8042" y1="290.81023" x2="463.17743" y2="226.8603" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_11">
+        <text transform="translate(479.48854 238.30963) rotate(79.69559)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">&lt; creates</tspan>
+        </text>
+      </g>
+      <g id="Line_10">
+        <line x1="474.8042" y1="384.9785" x2="317.76233" y2="489.3975" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_9">
+        <text transform="translate(356.00315 447.1584) rotate(-33.620406)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">&lt; creates via injector</tspan>
+        </text>
+      </g>
+      <g id="Line_8">
+        <line x1="213.71204" y1="553.1034" x2="159.22" y2="553.1034" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_7">
+        <line x1="322.77" y1="553.1034" x2="434.05065" y2="553.1034" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_6">
+        <rect x="435.3661" y="348.9785" width="78.87619" height="36" fill="white"/>
+        <rect x="435.3661" y="348.9785" width="78.87619" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(440.3661 353.9785)" fill="black">
+          <tspan font-family="Helvetica" font-size="11" font-weight="700" fill="black" x="3.2535248" y="10">N4Headless</tspan>
+          <tspan font-family="Helvetica" font-size="11" font-weight="700" fill="black" x="10.601181" y="23">Compiler</tspan>
+        </text>
+      </g>
+      <g id="Line_5">
+        <line x1="474.8042" y1="326.81023" x2="474.8042" y2="348.9785" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_4">
+        <path d="M 218.76233 489.3975 L 109.72 489.3975 L 109.72 535.1034" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_3">
+        <text transform="translate(113.31054 476.8317)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«doGenerate»</tspan>
+        </text>
+      </g>
+    </g>
+  </g>
+</svg>
diff --git a/design/chapters/14_execution/images/cd_EnvironmentConvention.svg b/design/chapters/14_execution/images/cd_EnvironmentConvention.svg
new file mode 100644
index 0000000..1f73b6f
--- /dev/null
+++ b/design/chapters/14_execution/images/cd_EnvironmentConvention.svg
@@ -0,0 +1,317 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xl="http://www.w3.org/1999/xlink" xmlns:dc="http://purl.org/dc/elements/1.1/" viewBox="461.0037 113.6 503.4963 556.2346" width="503.4963" height="556.2346">
+  <defs>
+    <font-face font-family="Helvetica" font-size="12" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="12" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="532.22656" cap-height="719.7266" ascent="770.0195" descent="-229.98047" font-weight="700">
+      <font-face-src>
+        <font-face-name name="Helvetica-Bold"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="11" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="8" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="12" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="-1e3" x-height="539.5508" cap-height="719.7266" ascent="770.0195" descent="-229.98047" font-style="italic" font-weight="700">
+      <font-face-src>
+        <font-face-name name="Helvetica-BoldOblique"/>
+      </font-face-src>
+    </font-face>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="StickArrow_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -4 10 8" markerWidth="10" markerHeight="8" color="black">
+      <g>
+        <path d="M 8 0 L 0 0 M 0 -3 L 8 0 L 0 3" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="UMLInheritance_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -8 14 16" markerWidth="14" markerHeight="16" color="black">
+      <g>
+        <path d="M 12 0 L 0 -7 L 0 7 Z" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <font-face font-family="Helvetica" font-size="18" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="Diamond_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-9 -4 10 8" markerWidth="10" markerHeight="8" color="black">
+      <g>
+        <path d="M -8 0 L -4 3 L 0 0 L -4 -3 Z" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <font-face font-family="Helvetica" font-size="10" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+  </defs>
+  <metadata> Produced by OmniGraffle 7.11 
+    <dc:date>2019-07-31 11:34:07 +0000</dc:date>
+  </metadata>
+  <g id="Canvas_1" stroke="none" stroke-opacity="1" stroke-dasharray="none" fill="none" fill-opacity="1">
+    <title>Canvas 1</title>
+    <rect fill="white" x="461.0037" y="113.6" width="503.4963" height="556.2346"/>
+    <g id="Canvas_1: Layer 1">
+      <title>Layer 1</title>
+      <g id="Group_348">
+        <g id="Group_358">
+          <g id="Graphic_360">
+            <rect x="609.5" y="281" width="133" height="24" fill="#dedede"/>
+            <rect x="609.5" y="281" width="133" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+            <text transform="translate(614.5 286)" fill="black">
+              <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="11">ID:String</tspan>
+            </text>
+          </g>
+          <g id="Graphic_359">
+            <rect x="609.5" y="257" width="133" height="24" fill="#dedede"/>
+            <rect x="609.5" y="257" width="133" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+            <text transform="translate(614.5 262)" fill="black">
+              <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x=".8291016" y="11">RuntimeEnvironment</tspan>
+            </text>
+          </g>
+        </g>
+        <g id="Group_355">
+          <g id="Graphic_357">
+            <rect x="626" y="304" width="133" height="24" fill="#dedede"/>
+            <rect x="626" y="304" width="133" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+            <text transform="translate(631 309)" fill="black">
+              <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="11">ID:String</tspan>
+            </text>
+          </g>
+          <g id="Graphic_356">
+            <rect x="626" y="280" width="133" height="24" fill="#dedede"/>
+            <rect x="626" y="280" width="133" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+            <text transform="translate(631 285)" fill="black">
+              <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x=".8291016" y="11">RuntimeEnvironment</tspan>
+            </text>
+          </g>
+        </g>
+        <g id="Group_352">
+          <g id="Graphic_354">
+            <rect x="644.5" y="329" width="133" height="24" fill="#dedede"/>
+            <rect x="644.5" y="329" width="133" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+            <text transform="translate(649.5 334)" fill="black">
+              <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="11">ID:String</tspan>
+            </text>
+          </g>
+          <g id="Graphic_353">
+            <rect x="644.5" y="305" width="133" height="24" fill="#dedede"/>
+            <rect x="644.5" y="305" width="133" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+            <text transform="translate(649.5 310)" fill="black">
+              <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x=".8291016" y="11">RuntimeEnvironment</tspan>
+            </text>
+          </g>
+        </g>
+        <g id="Group_349">
+          <g id="Graphic_351">
+            <rect x="662.5" y="352" width="133" height="24" fill="#dedede"/>
+            <rect x="662.5" y="352" width="133" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+            <text transform="translate(667.5 357)" fill="black">
+              <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="11">ID: ”ES5”</tspan>
+            </text>
+          </g>
+          <g id="Graphic_350">
+            <rect x="662.5" y="328" width="133" height="24" fill="#dedede"/>
+            <rect x="662.5" y="328" width="133" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+            <text transform="translate(667.5 333)" fill="black">
+              <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x=".8291016" y="11">RuntimeEnvironment</tspan>
+            </text>
+          </g>
+        </g>
+      </g>
+      <g id="Group_336">
+        <g id="Graphic_338">
+          <rect x="646" y="453.5701" width="113" height="36" fill="#ffd7e0"/>
+          <rect x="646" y="453.5701" width="113" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(651 458.5701)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">RE_ES5: “ES5”</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="23">….</tspan>
+          </text>
+        </g>
+        <g id="Graphic_337">
+          <rect x="646" y="419.5701" width="113" height="34" fill="#ffd7e0"/>
+          <rect x="646" y="419.5701" width="113" height="34" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(651 424.5701)" fill="black">
+            <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="24.814453" y="8">«enumeration»</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="1.8271484" y="21">RunnerCapability</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Graphic_458">
+        <rect x="474" y="519.8346" width="124" height="36" fill="#ffd7e0"/>
+        <rect x="474" y="519.8346" width="124" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(479 530.8346)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-style="italic" font-weight="700" fill="black" x="11.660156" y="11">AbstractRunner</tspan>
+        </text>
+      </g>
+      <g id="Graphic_459">
+        <rect x="816" y="522.8346" width="124" height="30" fill="#ffd7e0"/>
+        <rect x="816" y="522.8346" width="124" height="30" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(821 530.8346)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-style="italic" font-weight="700" fill="black" x="2.314453" y="11">..ide.n4js.transpiler</tspan>
+        </text>
+      </g>
+      <g id="Group_482">
+        <g id="Graphic_485">
+          <rect x="467" y="584.3346" width="99" height="36" fill="#ffd7e0"/>
+          <rect x="467" y="584.3346" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(472 595.3346)" fill="#aaa">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="#aaa" x=".49609375" y="11">ObjectCRunner</tspan>
+          </text>
+        </g>
+        <g id="Graphic_484">
+          <rect x="487" y="608.3346" width="99" height="36" fill="#ffd7e0"/>
+          <rect x="487" y="608.3346" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(492 619.3346)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x=".8300781" y="11">ChromeRunner</tspan>
+          </text>
+        </g>
+        <g id="Graphic_483">
+          <rect x="506" y="633.3346" width="99" height="36" fill="#ffd7e0"/>
+          <rect x="506" y="633.3346" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(511 644.3346)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="3.4960938" y="11">NodejsRunner</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_478">
+        <g id="Graphic_480">
+          <rect x="792" y="584.3346" width="151" height="36" fill="#ffd7e0"/>
+          <rect x="792" y="584.3346" width="151" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(797 595.3346)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="2.8125" y="11">…</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="#aaa" y="11">ide.n4js.tranpiler.objc</tspan>
+          </text>
+        </g>
+        <g id="Graphic_479">
+          <rect x="813" y="612.3346" width="151" height="36" fill="#ffd7e0"/>
+          <rect x="813" y="612.3346" width="151" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(818 623.3346)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="5.135742" y="11">…ide.n4js.tranpiler.es5</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Line_487">
+        <line x1="598" y1="537.8346" x2="806.1" y2="537.8346" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_148">
+        <path d="M 768 579.8132 C 768 574.6978 766.2474 574.0649 753.4451 569.0024 L 753.3099 568.95 C 740.44 563.8346 740.3062 563.8346 727.0982 563.8346 C 709.5115 563.8346 630 563.8346 630 563.8346 L 630 617.8346 L 768 617.8346 L 768 579.8132 Z" fill="white"/>
+        <path d="M 768 579.8132 C 768 574.6978 766.2474 574.0649 753.4451 569.0024 L 753.3099 568.95 C 740.44 563.8346 740.3062 563.8346 727.0982 563.8346 C 709.5115 563.8346 630 563.8346 630 563.8346 L 630 617.8346 L 768 617.8346 L 768 579.8132 Z M 768 579.5497 C 768 574.6978 767.8648 574.6978 740.3062 574.6978 L 740.3062 574.6978 C 740.3062 563.8875 740.3062 563.8346 727.9069 563.8346" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(635 569.8346)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="18.299805" y="11">Output subfolder, </tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="9.633789" y="25">wrapping, bootstrap, </tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="39.660156" y="39">polyfils…</tspan>
+        </text>
+      </g>
+      <g id="Line_188">
+        <line x1="704.78185" y1="563.3453" x2="710.14754" y2="537.8346" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_165">
+        <path d="M 536 584.3346 L 536 570.0846 L 536 569.3346" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_488">
+        <line x1="878" y1="584.3346" x2="878" y2="566.3346" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_489">
+        <line x1="577.3333" y1="519.8346" x2="637.5508" y2="483.06295" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_497">
+        <line x1="836.6667" y1="522.8346" x2="767.5693" y2="482.8609" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_499">
+        <path d="M 934.5 387.713 C 934.5 381.0819 933.0649 380.2615 922.5819 373.699 L 922.4712 373.6311 C 911.9328 367 911.8232 367 901.0079 367 C 886.6072 367 821.5 367 821.5 367 L 821.5 437 L 934.5 437 L 934.5 387.713 Z" fill="white"/>
+        <path d="M 934.5 387.713 C 934.5 381.0819 933.0649 380.2615 922.5819 373.699 L 922.4712 373.6311 C 911.9328 367 911.8232 367 901.0079 367 C 886.6072 367 821.5 367 821.5 367 L 821.5 437 L 934.5 437 L 934.5 387.713 Z M 934.5 387.3714 C 934.5 381.0819 934.3893 381.0819 911.8232 381.0819 L 911.8232 381.0819 C 911.8232 367.0686 911.8232 367 901.6701 367" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(826.5 367)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="27.157227" y="11">Match by </tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="9.136719" y="25">convention, e.g. </tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="17.480469" y="39">enum values </tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="8.474609" y="53">correspond to id </tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="34.15625" y="67">values</tspan>
+        </text>
+      </g>
+      <g id="Graphic_678">
+        <rect x="653.31284" y="126" width="99" height="36" fill="#dedede"/>
+        <rect x="653.31284" y="126" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(658.31284 137)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="7.483398" y="11">N4JS Project</tspan>
+        </text>
+      </g>
+      <g id="Graphic_679">
+        <rect x="653.31284" y="193" width="99" height="36" fill="#dedede"/>
+        <rect x="653.31284" y="193" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(658.31284 204)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x=".15917969" y="11">RuntimeLibrary</tspan>
+        </text>
+      </g>
+      <g id="Line_680">
+        <line x1="702.81284" y1="162" x2="702.81284" y2="183.1" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_681">
+        <line x1="702.5" y1="257" x2="702.7022" y2="238.89938" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_146">
+        <path d="M 752.3128 150 L 807.4 150 L 807.4 336.33333 L 805.4 336.33333" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_682">
+        <path d="M 474 537.8346 L 462.1 537.8346 L 462.1 114.1 L 702.81284 114.1 L 702.81284 116.1" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_392">
+        <text transform="translate(690.18585 239.0428)" fill="black">
+          <tspan font-family="Helvetica" font-size="18" font-weight="400" fill="black" x="0" y="18">*</tspan>
+        </text>
+      </g>
+      <g id="Graphic_684">
+        <text transform="translate(705.3915 177.22156)" fill="black">
+          <tspan font-family="Helvetica" font-size="18" font-weight="400" fill="black" x="0" y="18">*</tspan>
+        </text>
+      </g>
+      <g id="Line_618">
+        <path d="M 669.81284 171.25 L 669.81284 173.9 L 641.41284 173.9 L 641.41284 144 L 643.41284 144" marker-end="url(#StickArrow_Marker)" marker-start="url(#Diamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_685">
+        <path d="M 942.363 218.9786 C 942.363 213.86318 941.0288 213.2303 931.2833 208.1678 L 931.1804 208.11542 C 921.3834 203 921.2815 203 911.2272 203 C 897.8396 203 837.3128 203 837.3128 203 L 837.3128 257 L 942.363 257 L 942.363 218.9786 Z" fill="white"/>
+        <path d="M 942.363 218.9786 C 942.363 213.86318 941.0288 213.2303 931.2833 208.1678 L 931.1804 208.11542 C 921.3834 203 921.2815 203 911.2272 203 C 897.8396 203 837.3128 203 837.3128 203 L 837.3128 257 L 942.363 257 L 942.363 218.9786 Z M 942.363 218.71508 C 942.363 213.86318 942.26 213.86318 921.2815 213.86318 L 921.2815 213.86318 C 921.2815 203.05292 921.2815 203 911.8427 203" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(842.3128 209)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="27.849274" y="11">Indirect </tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="5.4928284" y="25">dependency via </tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="2.1734924" y="39">RuntimeLibraries</tspan>
+        </text>
+      </g>
+      <g id="Line_686">
+        <line x1="836.8135" y1="232.66793" x2="807.4" y2="234.55955" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_212">
+        <text transform="translate(466.0037 476.68765)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«runs»</tspan>
+        </text>
+      </g>
+      <g id="Line_708">
+        <path d="M 940 537.8346 L 951.9 537.8346 L 951.9 114.1 L 702.81284 114.1 L 702.81284 116.1" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_709">
+        <text transform="translate(898.4353 478.0123)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«compiles»</tspan>
+        </text>
+      </g>
+      <g id="Line_710">
+        <line x1="702.5" y1="419.5701" x2="702.5" y2="385.9" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_712">
+        <line x1="821.5" y1="402" x2="702.5" y2="398.757" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_713">
+        <text transform="translate(696.1587 523.64746)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«use»</tspan>
+        </text>
+      </g>
+    </g>
+  </g>
+</svg>
diff --git a/design/chapters/14_execution/images/cd_RunnersIdeCli.svg b/design/chapters/14_execution/images/cd_RunnersIdeCli.svg
new file mode 100644
index 0000000..a3a8edd
--- /dev/null
+++ b/design/chapters/14_execution/images/cd_RunnersIdeCli.svg
@@ -0,0 +1,399 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xl="http://www.w3.org/1999/xlink" xmlns:dc="http://purl.org/dc/elements/1.1/" viewBox="527.5 68 612 457.5" width="612" height="457.5">
+  <defs>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="StickArrow_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -4 10 8" markerWidth="10" markerHeight="8" color="black">
+      <g>
+        <path d="M 8 0 L 0 0 M 0 -3 L 8 0 L 0 3" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="FilledDiamond_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-9 -4 10 8" markerWidth="10" markerHeight="8" color="black">
+      <g>
+        <path d="M -8 0 L -4 3 L 0 0 L -4 -3 Z" fill="currentColor" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="UML2Socket_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -7 8 14" markerWidth="8" markerHeight="14" color="black">
+      <g>
+        <path d="M 6 -6 C -1 -6 -1 6 6 6" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="EmptyCenterBall_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -6 12 12" markerWidth="12" markerHeight="12" color="black">
+      <g>
+        <circle cx="4.799998" cy="0" r="4.79999555411813" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <font-face font-family="Helvetica" font-size="8" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="12" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="532.22656" cap-height="719.7266" ascent="770.0195" descent="-229.98047" font-weight="700">
+      <font-face-src>
+        <font-face-name name="Helvetica-Bold"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="12" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="-1e3" x-height="539.5508" cap-height="719.7266" ascent="770.0195" descent="-229.98047" font-style="italic" font-weight="700">
+      <font-face-src>
+        <font-face-name name="Helvetica-BoldOblique"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="12" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+  </defs>
+  <metadata> Produced by OmniGraffle 7.11 
+    <dc:date>2019-07-31 11:37:04 +0000</dc:date>
+  </metadata>
+  <g id="Canvas_1" stroke="none" stroke-opacity="1" stroke-dasharray="none" fill="none" fill-opacity="1">
+    <title>Canvas 1</title>
+    <rect fill="white" x="527.5" y="68" width="612" height="457.5"/>
+    <g id="Canvas_1: Layer 1">
+      <title>Layer 1</title>
+      <g id="Line_465">
+        <line x1="681.5" y1="185.5" x2="771.6" y2="185.5" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_466">
+        <line x1="984" y1="185.5" x2="894.4" y2="185.5" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_472">
+        <line x1="832.5" y1="358.75" x2="832.5" y2="385.6" marker-end="url(#StickArrow_Marker)" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_352">
+        <line x1="554.33333" y1="109" x2="554.84983" y2="138.23133" marker-end="url(#UML2Socket_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_354">
+        <line x1="554.33333" y1="304.5" x2="554.9797" y2="151.52996" marker-end="url(#EmptyCenterBall_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_496">
+        <line x1="686" y1="507" x2="773.1" y2="507" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_502">
+        <line x1="1112.6512" y1="109.49976" x2="1111.7627" y2="138.23408" marker-end="url(#UML2Socket_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_503">
+        <line x1="1112.6667" y1="304.5" x2="1111.5355" y2="151.52989" marker-end="url(#EmptyCenterBall_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_504">
+        <rect x="783" y="489" width="99" height="36" fill="#919191"/>
+        <path d="M 783 489 L 882 489 L 882 525 L 783 525 Z" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+        <text transform="translate(788 495)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="24.039062" y="8">«java.lang»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="20.5" y="21">Runtime</tspan>
+        </text>
+      </g>
+      <g id="Line_505">
+        <line x1="832.5" y1="489" x2="832.5" y2="437.4" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_506">
+        <line x1="981" y1="507" x2="891.9" y2="507" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_556">
+        <path d="M 833 163 L 833 151.1 L 833.5 125.4 L 833.5 123.4" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_559">
+        <line x1="981" y1="91" x2="894.9" y2="91" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_560">
+        <line x1="686" y1="91" x2="772.1" y2="91" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_561">
+        <line x1="633.3287" y1="109.49998" x2="633.0793" y2="136.23039" marker-end="url(#UML2Socket_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_562">
+        <line x1="634" y1="167.5" x2="633.2106" y2="149.5254" marker-end="url(#EmptyCenterBall_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_563">
+        <line x1="1033.6667" y1="109" x2="1033.6667" y2="134.27096" marker-end="url(#UML2Socket_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_564">
+        <line x1="1034" y1="167.5" x2="1034.4031" y2="147.52904" marker-end="url(#EmptyCenterBall_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_592">
+        <line x1="1060" y1="358.75" x2="1060" y2="479.1" marker-end="url(#StickArrow_Marker)" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_593">
+        <line x1="981" y1="327" x2="917.4" y2="327" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_594">
+        <line x1="607" y1="358.75" x2="607" y2="479.1" marker-end="url(#StickArrow_Marker)" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_595">
+        <line x1="686" y1="327" x2="747.6" y2="327" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Group_597">
+        <g id="Graphic_601">
+          <rect x="775" y="395.5" width="115" height="32" fill="#96e1a4"/>
+          <rect x="775" y="395.5" width="115" height="32" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(780 404.5)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="25.822266" y="11">Node.exe</tspan>
+          </text>
+        </g>
+        <g id="Group_598">
+          <g id="Line_600">
+            <path d="M 881.277 400.5 L 877.193 400.5 L 877.193 410.58 L 884 410.58 L 884 403.86 L 881.277 400.5" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Line_599">
+            <path d="M 881.277 400.5 L 881.277 403.86 L 884 403.86 L 884 403.86" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+        </g>
+      </g>
+      <g id="Group_619">
+        <g id="Graphic_623">
+          <rect x="782" y="68.5" width="103" height="45" fill="#c1c1c1"/>
+          <rect x="782" y="68.5" width="103" height="45" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(787 84)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="9.483398" y="11">N4JS Project</tspan>
+          </text>
+        </g>
+        <g id="Group_620">
+          <g id="Line_622">
+            <path d="M 875.084 73.5 L 871 73.5 L 871 83.58 L 877.807 83.58 L 877.807 76.86 L 875.084 73.5" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Line_621">
+            <path d="M 875.084 73.5 L 875.084 76.86 L 877.807 76.86 L 877.807 76.86" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+        </g>
+      </g>
+      <g id="Line_625">
+        <path d="M 832.5 304.5 L 832.5 292.6 L 833 219.9 L 833 217.9" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_626">
+        <path d="M 633.3333 304.5 L 633.3333 253.6 L 634 253.6 L 634 213.4" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_627">
+        <path d="M 1033.6667 304.5 L 1033.6667 292.6 L 1034 215.4 L 1034 213.4" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Group_628">
+        <g id="Graphic_634">
+          <rect x="981" y="73" width="158" height="36" fill="#f1fda4"/>
+          <rect x="981" y="73" width="158" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(986 84)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="47.65918" y="11">N4JS CLI</tspan>
+          </text>
+        </g>
+        <g id="Group_629">
+          <g id="Graphic_633">
+            <rect x="1127.924" y="78" width="6.05036" height="8.52924" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Graphic_632">
+            <rect x="1126.5" y="79.3569" width="2.84456" height="1.50886" fill="white"/>
+            <rect x="1126.5" y="79.3569" width="2.84456" height="1.50886" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width=".5"/>
+          </g>
+          <g id="Graphic_631">
+            <rect x="1126.5" y="82.5004" width="2.84456" height="1.50886" fill="white"/>
+            <rect x="1126.5" y="82.5004" width="2.84456" height="1.50886" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width=".5"/>
+          </g>
+          <g id="Graphic_630"/>
+        </g>
+      </g>
+      <g id="Group_635">
+        <g id="Graphic_641">
+          <rect x="528" y="73" width="158" height="36" fill="#b8f2ff"/>
+          <rect x="528" y="73" width="158" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(533 84)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="47.322266" y="11">N4JS IDE</tspan>
+          </text>
+        </g>
+        <g id="Group_636">
+          <g id="Graphic_640">
+            <rect x="673.424" y="78" width="6.05036" height="8.52924" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Graphic_639">
+            <rect x="672" y="79.3569" width="2.84456" height="1.50886" fill="white"/>
+            <rect x="672" y="79.3569" width="2.84456" height="1.50886" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width=".5"/>
+          </g>
+          <g id="Graphic_638">
+            <rect x="672" y="82.5004" width="2.84456" height="1.50886" fill="white"/>
+            <rect x="672" y="82.5004" width="2.84456" height="1.50886" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width=".5"/>
+          </g>
+          <g id="Graphic_637"/>
+        </g>
+      </g>
+      <g id="Group_642">
+        <g id="Graphic_648">
+          <rect x="586.5" y="167.5" width="95" height="36" fill="#b8f2ff"/>
+          <rect x="586.5" y="167.5" width="95" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(591.5 178.5)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-style="italic" font-weight="700" fill="black" x="11.498047" y="11">IDERunner</tspan>
+          </text>
+        </g>
+        <g id="Group_643">
+          <g id="Graphic_647">
+            <rect x="672.424" y="172" width="6.05036" height="8.52924" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Graphic_646">
+            <rect x="671" y="173.3569" width="2.84456" height="1.50886" fill="white"/>
+            <rect x="671" y="173.3569" width="2.84456" height="1.50886" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width=".5"/>
+          </g>
+          <g id="Graphic_645">
+            <rect x="671" y="176.5004" width="2.84456" height="1.50886" fill="white"/>
+            <rect x="671" y="176.5004" width="2.84456" height="1.50886" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width=".5"/>
+          </g>
+          <g id="Graphic_644"/>
+        </g>
+      </g>
+      <g id="Group_649">
+        <g id="Graphic_655">
+          <rect x="781.5" y="163" width="103" height="45" fill="#c3fdd2"/>
+          <rect x="781.5" y="163" width="103" height="45" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(786.5 178.5)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-style="italic" font-weight="700" fill="black" x="25.5" y="11">Runner</tspan>
+          </text>
+        </g>
+        <g id="Group_650">
+          <g id="Graphic_654">
+            <rect x="872.924" y="167.5" width="6.05036" height="8.52924" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Graphic_653">
+            <rect x="871.5" y="168.8569" width="2.84456" height="1.50886" fill="white"/>
+            <rect x="871.5" y="168.8569" width="2.84456" height="1.50886" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width=".5"/>
+          </g>
+          <g id="Graphic_652">
+            <rect x="871.5" y="172.0004" width="2.84456" height="1.50886" fill="white"/>
+            <rect x="871.5" y="172.0004" width="2.84456" height="1.50886" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width=".5"/>
+          </g>
+          <g id="Graphic_651"/>
+        </g>
+      </g>
+      <g id="Group_656">
+        <g id="Graphic_662">
+          <rect x="984.5" y="167.5" width="99" height="36" fill="#f1fda4"/>
+          <rect x="984.5" y="167.5" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(989.5 178.5)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-style="italic" font-weight="700" fill="black" x="13.834961" y="11">CLIRunner</tspan>
+          </text>
+        </g>
+        <g id="Group_657">
+          <g id="Graphic_661">
+            <rect x="1073.424" y="171.5" width="6.05036" height="8.52924" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Graphic_660">
+            <rect x="1072" y="172.8569" width="2.84456" height="1.50886" fill="white"/>
+            <rect x="1072" y="172.8569" width="2.84456" height="1.50886" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width=".5"/>
+          </g>
+          <g id="Graphic_659">
+            <rect x="1072" y="176.0004" width="2.84456" height="1.50886" fill="white"/>
+            <rect x="1072" y="176.0004" width="2.84456" height="1.50886" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width=".5"/>
+          </g>
+          <g id="Graphic_658"/>
+        </g>
+      </g>
+      <g id="Group_663">
+        <g id="Graphic_669">
+          <rect x="528" y="304.5" width="158" height="45" fill="#97d3e1"/>
+          <rect x="528" y="304.5" width="158" height="45" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(533 320)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="24.664062" y="11">IDE Node Runner</tspan>
+          </text>
+        </g>
+        <g id="Group_664">
+          <g id="Graphic_668">
+            <rect x="675.4496" y="309.5" width="6.05036" height="8.52924" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Graphic_667">
+            <rect x="674.0256" y="310.8569" width="2.84456" height="1.50886" fill="white"/>
+            <rect x="674.0256" y="310.8569" width="2.84456" height="1.50886" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width=".5"/>
+          </g>
+          <g id="Graphic_666">
+            <rect x="674.0256" y="314.0004" width="2.84456" height="1.50886" fill="white"/>
+            <rect x="674.0256" y="314.0004" width="2.84456" height="1.50886" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width=".5"/>
+          </g>
+          <g id="Graphic_665"/>
+        </g>
+      </g>
+      <g id="Group_670">
+        <g id="Graphic_676">
+          <rect x="757.5" y="304.5" width="150" height="45" fill="#96e1a4"/>
+          <rect x="757.5" y="304.5" width="150" height="45" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(762.5 320)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="34" y="11">NodeRunner</tspan>
+          </text>
+        </g>
+        <g id="Group_671">
+          <g id="Graphic_675">
+            <rect x="896.924" y="308.5" width="6.05036" height="8.52924" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Graphic_674">
+            <rect x="895.5" y="309.8569" width="2.84456" height="1.50886" fill="white"/>
+            <rect x="895.5" y="309.8569" width="2.84456" height="1.50886" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width=".5"/>
+          </g>
+          <g id="Graphic_673">
+            <rect x="895.5" y="313.0004" width="2.84456" height="1.50886" fill="white"/>
+            <rect x="895.5" y="313.0004" width="2.84456" height="1.50886" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width=".5"/>
+          </g>
+          <g id="Graphic_672"/>
+        </g>
+      </g>
+      <g id="Group_677">
+        <g id="Graphic_683">
+          <rect x="981" y="304.5" width="158" height="45" fill="#d9e493"/>
+          <rect x="981" y="304.5" width="158" height="45" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(986 320)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="25.000977" y="11">CLI Node Runner</tspan>
+          </text>
+        </g>
+        <g id="Group_678">
+          <g id="Graphic_682">
+            <rect x="1128.924" y="308.5" width="6.05036" height="8.52924" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Graphic_681">
+            <rect x="1127.5" y="309.8569" width="2.84456" height="1.50886" fill="white"/>
+            <rect x="1127.5" y="309.8569" width="2.84456" height="1.50886" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width=".5"/>
+          </g>
+          <g id="Graphic_680">
+            <rect x="1127.5" y="313.0004" width="2.84456" height="1.50886" fill="white"/>
+            <rect x="1127.5" y="313.0004" width="2.84456" height="1.50886" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width=".5"/>
+          </g>
+          <g id="Graphic_679"/>
+        </g>
+      </g>
+      <g id="Group_685">
+        <g id="Graphic_689">
+          <rect x="528" y="489" width="158" height="36" fill="#97d3e1"/>
+          <rect x="528" y="489" width="158" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(533 500)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="20.65332" y="11">IDE Node Delegate</tspan>
+          </text>
+        </g>
+        <g id="Group_686">
+          <g id="Line_688">
+            <path d="M 678.777 492 L 674.693 492 L 674.693 502.08 L 681.5 502.08 L 681.5 495.36 L 678.777 492" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Line_687">
+            <path d="M 678.777 492 L 678.777 495.36 L 681.5 495.36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+        </g>
+      </g>
+      <g id="Group_691">
+        <g id="Graphic_695">
+          <rect x="981" y="489" width="158" height="36" fill="#d9e493"/>
+          <rect x="981" y="489" width="158" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(986 500)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="20.990234" y="11">CLI Node Delegate</tspan>
+          </text>
+        </g>
+        <g id="Group_692">
+          <g id="Line_694">
+            <path d="M 1132.084 493 L 1128 493 L 1128 503.08 L 1134.807 503.08 L 1134.807 496.36 L 1132.084 493" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Line_693">
+            <path d="M 1132.084 493 L 1132.084 496.36 L 1134.807 496.36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+        </g>
+      </g>
+      <g id="Graphic_148">
+        <path d="M 955.5 133.1524 C 955.5 129.74212 954.4396 129.3202 946.6933 125.9452 L 946.6114 125.91028 C 938.8242 122.5 938.7432 122.5 930.7514 122.5 C 920.1102 122.5 872 122.5 872 122.5 L 872 158.5 L 955.5 158.5 L 955.5 133.1524 Z" fill="white"/>
+        <path d="M 955.5 133.1524 C 955.5 129.74212 954.4396 129.3202 946.6933 125.9452 L 946.6114 125.91028 C 938.8242 122.5 938.7432 122.5 930.7514 122.5 C 920.1102 122.5 872 122.5 872 122.5 L 872 158.5 L 955.5 158.5 L 955.5 133.1524 Z M 955.5 132.97672 C 955.5 129.74212 955.4182 129.74212 938.7432 129.74212 L 938.7432 129.74212 C 938.7432 122.53528 938.7432 122.5 931.2407 122.5" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(877 126.5)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="6.395508" y="11">Convention </tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="13.734375" y="25">Mapping</tspan>
+        </text>
+      </g>
+      <g id="Line_188">
+        <line x1="833.2059" y1="140.51696" x2="871.5" y2="140.5089" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+    </g>
+  </g>
+</svg>
diff --git a/design/chapters/14_execution/images/cd_executionengine.svg b/design/chapters/14_execution/images/cd_executionengine.svg
new file mode 100644
index 0000000..1087743
--- /dev/null
+++ b/design/chapters/14_execution/images/cd_executionengine.svg
@@ -0,0 +1,407 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xl="http://www.w3.org/1999/xlink" xmlns:dc="http://purl.org/dc/elements/1.1/" viewBox="5.816547 21.370504 904.7554 579.6095" width="904.7554" height="579.6095">
+  <defs>
+    <font-face font-family="Helvetica" font-size="12" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="12" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="532.22656" cap-height="719.7266" ascent="770.0195" descent="-229.98047" font-weight="700">
+      <font-face-src>
+        <font-face-name name="Helvetica-Bold"/>
+      </font-face-src>
+    </font-face>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="StickArrow_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -4 10 8" markerWidth="10" markerHeight="8" color="black">
+      <g>
+        <path d="M 8 0 L 0 0 M 0 -3 L 8 0 L 0 3" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="FilledDiamond_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-9 -4 10 8" markerWidth="10" markerHeight="8" color="black">
+      <g>
+        <path d="M -8 0 L -4 3 L 0 0 L -4 -3 Z" fill="currentColor" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="UML2Socket_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -7 8 14" markerWidth="8" markerHeight="14" color="black">
+      <g>
+        <path d="M 6 -6 C -1 -6 -1 6 6 6" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="EmptyCenterBall_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -6 12 12" markerWidth="12" markerHeight="12" color="black">
+      <g>
+        <circle cx="4.799998" cy="0" r="4.79999555411813" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+  </defs>
+  <metadata> Produced by OmniGraffle 7.11 
+    <dc:date>2019-07-31 11:35:59 +0000</dc:date>
+  </metadata>
+  <g id="Canvas_1" stroke="none" stroke-opacity="1" stroke-dasharray="none" fill="none" fill-opacity="1">
+    <title>Canvas 1</title>
+    <rect fill="white" x="5.816547" y="21.370504" width="904.7554" height="579.6095"/>
+    <g id="Canvas_1: packages">
+      <title>packages</title>
+      <g id="Group_590">
+        <g id="Graphic_592">
+          <rect x="559" y="182.30215" width="182.59997" height="31.016506" fill="#ffd978" fill-opacity=".51"/>
+          <rect x="559" y="182.30215" width="182.59997" height="31.016506" stroke="#b0b0b0" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(564 190.8104)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="10.948418" y="11">o.e.n4js.</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" y="11">js.engine.debug.ui</tspan>
+          </text>
+        </g>
+        <g id="Graphic_591">
+          <rect x="559" y="213.31865" width="341.71942" height="309.27128" fill="#ffd978" fill-opacity=".51"/>
+          <rect x="559" y="213.31865" width="341.71942" height="309.27128" stroke="#b0b0b0" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+      </g>
+      <g id="Group_149">
+        <g id="Graphic_151">
+          <rect x="6.316547" y="21.870504" width="112.552" height="22.280563" fill="#c4dcfa" fill-opacity=".51"/>
+          <rect x="6.316547" y="21.870504" width="112.552" height="22.280563" stroke="#b0b0b0" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(11.316547 26.010786)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="2.5875244" y="11">o.e.n4js.</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" y="11">js.engine</tspan>
+          </text>
+        </g>
+        <g id="Graphic_150">
+          <rect x="6.316547" y="44.151066" width="524.6187" height="397.1439" fill="#c4dcfa" fill-opacity=".51"/>
+          <rect x="6.316547" y="44.151066" width="524.6187" height="397.1439" stroke="#b0b0b0" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+      </g>
+      <g id="Group_624">
+        <g id="Graphic_626">
+          <rect x="9.381261" y="449.6403" width="103.88903" height="35.74505" fill="#ffd978" fill-opacity=".51"/>
+          <rect x="9.381261" y="449.6403" width="103.88903" height="35.74505" stroke="#b0b0b0" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(14.38126 453.5128)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="1.592949" y="11">o.e..</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" y="11">n4js.transpi</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="28.256035" y="25">ler.es5</tspan>
+          </text>
+        </g>
+        <g id="Graphic_625">
+          <rect x="9.381261" y="484.7906" width="321.57556" height="115.68938" fill="#ffd978" fill-opacity=".51"/>
+          <rect x="9.381261" y="484.7906" width="321.57556" height="115.68938" stroke="#b0b0b0" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+      </g>
+      <g id="Graphic_148">
+        <path d="M 485.1977 536.959 C 485.1977 528.4129 483.89115 527.35555 474.3472 518.8978 L 474.24636 518.8103 C 464.652 510.26416 464.5522 510.26416 454.70577 510.26416 C 441.59504 510.26416 382.32 510.26416 382.32 510.26416 L 382.32 600.48 L 485.1977 600.48 L 485.1977 536.959 Z" fill="white"/>
+        <path d="M 485.1977 536.959 C 485.1977 528.4129 483.89115 527.35555 474.3472 518.8978 L 474.24636 518.8103 C 464.652 510.26416 464.5522 510.26416 454.70577 510.26416 C 441.59504 510.26416 382.32 510.26416 382.32 510.26416 L 382.32 600.48 L 485.1977 600.48 L 485.1977 536.959 Z M 485.1977 536.5188 C 485.1977 528.4129 485.0969 528.4129 464.5522 528.4129 L 464.5522 528.4129 C 464.5522 510.3526 464.5522 510.26416 455.30863 510.26416" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(387.32 527.3721)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x=".7503738" y="11">Test clients using </tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="13.087288" y="25">non platform </tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="10.418343" y="39">version of the </tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="28.421272" y="53">engine</tspan>
+        </text>
+      </g>
+      <g id="Line_188">
+        <line x1="331.45624" y1="550.42876" x2="381.82057" y2="552.8624" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_654">
+        <path d="M 710.7914 56.36874 C 710.7914 46.936633 709.1833 45.76969 697.4369 36.43516 L 697.3128 36.33858 C 685.50435 26.90647 685.3815 26.90647 673.26285 26.90647 C 657.1266 26.90647 584.1727 26.90647 584.1727 26.90647 L 584.1727 126.47481 L 710.7914 126.47481 L 710.7914 56.36874 Z" fill="white"/>
+        <path d="M 710.7914 56.36874 C 710.7914 46.936633 709.1833 45.76969 697.4369 36.43516 L 697.3128 36.33858 C 685.50435 26.90647 685.3815 26.90647 673.26285 26.90647 C 657.1266 26.90647 584.1727 26.90647 584.1727 26.90647 L 584.1727 126.47481 L 710.7914 126.47481 L 710.7914 56.36874 Z M 710.7914 55.88285 C 710.7914 46.936633 710.6673 46.936633 685.3815 46.936633 L 685.3815 46.936633 C 685.3815 27.004046 685.3815 26.90647 674.0048 26.90647" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(589.1727 48.69064)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="23.952904" y="11">Basic engine </tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="21.629662" y="25">infrastructure, </tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="1.2771225" y="39">includes non platform </tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="2.604271" y="53">version of the engine</tspan>
+        </text>
+      </g>
+      <g id="Line_655">
+        <line x1="531.3932" y1="127.56617" x2="583.7147" y2="104.63644" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_657">
+        <path d="M 910.0719 94.93373 C 910.0719 87.7506 908.1532 86.8619 894.1376 79.75309 L 893.9896 79.67954 C 879.8999 72.49642 879.7534 72.49642 865.2936 72.49642 C 846.0401 72.49642 758.9928 72.49642 758.9928 72.49642 L 758.9928 148.32375 L 910.0719 148.32375 L 910.0719 94.93373 Z" fill="white"/>
+        <path d="M 910.0719 94.93373 C 910.0719 87.7506 908.1532 86.8619 894.1376 79.75309 L 893.9896 79.67954 C 879.8999 72.49642 879.7534 72.49642 865.2936 72.49642 C 846.0401 72.49642 758.9928 72.49642 758.9928 72.49642 L 758.9928 148.32375 L 910.0719 148.32375 L 910.0719 94.93373 Z M 910.0719 94.56369 C 910.0719 87.7506 909.9239 87.7506 879.7534 87.7506 L 879.7534 87.7506 C 879.7534 72.57073 879.7534 72.49642 866.1789 72.49642" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(763.9928 82.41009)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="30.85988" y="11">Platform client, </tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="19.521988" y="25">implements its own </tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="2.5034332" y="39">Engine, provides platform </tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="40.86476" y="53">url resolver</tspan>
+        </text>
+      </g>
+      <g id="Line_658">
+        <line x1="792.8959" y1="212.85545" x2="818.935" y2="148.78696" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+    </g>
+    <g id="Canvas_1: Layer 1">
+      <title>Layer 1</title>
+      <g id="Group_605">
+        <g id="Graphic_608">
+          <rect x="15.438846" y="172.03383" width="233" height="38" fill="white"/>
+          <rect x="15.438846" y="172.03383" width="233" height="38" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(20.438846 177.03383)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="11">execute(String code):EngineOutput</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="25">execute(File file):EngineOutput</tspan>
+          </text>
+        </g>
+        <g id="Graphic_607">
+          <rect x="15.438846" y="144.47483" width="233" height="24" fill="white"/>
+          <rect x="15.438846" y="144.47483" width="233" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(20.438846 149.47483)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="41.495117" y="11">EngineCommandBuilder</tspan>
+          </text>
+        </g>
+        <g id="Graphic_606">
+          <rect x="15.438846" y="167.47583" width="233" height="4.55847" fill="white"/>
+          <rect x="15.438846" y="167.47583" width="233" height="4.55847" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+      </g>
+      <g id="Group_609">
+        <g id="Graphic_612">
+          <rect x="229.74095" y="393.2615" width="129" height="42.6716" fill="white"/>
+          <rect x="229.74095" y="393.2615" width="129" height="42.6716" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(234.74095 398.2615)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="11">stdoutput:List&lt;String&gt;</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="25">erroutput:List&lt;String&gt;</tspan>
+          </text>
+        </g>
+        <g id="Graphic_611">
+          <rect x="229.74095" y="370.3741" width="129" height="19.931693" fill="white"/>
+          <rect x="229.74095" y="370.3741" width="129" height="19.931693" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(234.74095 375.3741)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="19.84082" y="11">EngineOutput</tspan>
+          </text>
+        </g>
+        <g id="Graphic_610">
+          <rect x="229.74095" y="389.47615" width="129" height="3.785751" fill="white"/>
+          <rect x="229.74095" y="389.47615" width="129" height="3.785751" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+      </g>
+      <g id="Graphic_548">
+        <rect x="682.7161" y="385.15363" width="145" height="36" fill="white"/>
+        <rect x="682.7161" y="385.15363" width="145" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(687.7161 396.15363)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="6.84082" y="11">LaunchConfiguration</tspan>
+        </text>
+      </g>
+      <g id="Graphic_549">
+        <rect x="135.5672" y="503.28" width="149" height="36" fill="white"/>
+        <rect x="135.5672" y="503.28" width="149" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(140.5672 514.28)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="17.269531" y="11">JunitCompilerTest</tspan>
+        </text>
+      </g>
+      <g id="Graphic_550">
+        <rect x="70.56" y="553.6397" width="124.82734" height="36" fill="white"/>
+        <rect x="70.56" y="553.6397" width="124.82734" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(75.56 564.6397)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="3.176365" y="11">XpectCompilerTest</tspan>
+        </text>
+      </g>
+      <g id="Graphic_551">
+        <rect x="612.0096" y="481.50686" width="112.552" height="36" fill="white"/>
+        <rect x="612.0096" y="481.50686" width="112.552" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(617.0096 492.50686)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="4.9312744" y="11">LaunchDelegate</tspan>
+        </text>
+      </g>
+      <g id="Graphic_552">
+        <rect x="758.9928" y="479.6272" width="112.552" height="36" fill="white"/>
+        <rect x="758.9928" y="479.6272" width="112.552" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(763.9928 490.6272)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="5.2769775" y="11">LaunchShortcut</tspan>
+        </text>
+      </g>
+      <g id="Line_164">
+        <line x1="248.43885" y1="349.6022" x2="285.22482" y2="366.28517" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_554">
+        <line x1="815.2688" y1="479.6272" x2="762.3091" y2="428.0601" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_613">
+        <line x1="668.2856" y1="481.50686" x2="747.0839" y2="426.7996" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_388">
+        <line x1="755.2161" y1="375.90363" x2="755.2161" y2="359.5022" marker-end="url(#StickArrow_Marker)" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_614">
+        <line x1="132.92422" y1="543.8898" x2="131.98905" y2="359.50205" marker-end="url(#StickArrow_Marker)" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_615">
+        <line x1="205.87522" y1="495.0344" x2="136.4254" y2="358.4272" marker-end="url(#StickArrow_Marker)" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_616">
+        <line x1="210.0672" y1="503.28" x2="226.96493" y2="445.43594" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_617">
+        <path d="M 195.38734 571.6397 L 293.8741 568.70504 L 294.2136 445.8331" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_618">
+        <rect x="82.43884" y="49.32375" width="99" height="36" fill="white"/>
+        <rect x="82.43884" y="49.32375" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(87.43884 60.32375)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="5.1572266" y="11">NodeProvider</tspan>
+        </text>
+      </g>
+      <g id="Line_619">
+        <line x1="248.43885" y1="144.47483" x2="284.612" y2="130.82004" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Group_366">
+        <g id="Graphic_370">
+          <rect x="264.7482" y="45.32374" width="89" height="42" fill="white"/>
+          <rect x="264.7482" y="45.32374" width="89" height="42" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(269.7482 59.32374)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="6.21875" y="11">WinNodeJS</tspan>
+          </text>
+        </g>
+        <g id="Group_367">
+          <g id="Line_369">
+            <path d="M 346.12995 48.68374 L 341.27545 48.68374 L 341.27545 58.76374 L 349.36668 58.76374 L 349.36668 52.04374 L 346.12995 48.68374" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Line_368">
+            <path d="M 346.12995 48.68374 L 346.12995 52.04374 L 349.36668 52.04374 L 349.36668 52.04374" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+        </g>
+      </g>
+      <g id="Line_457">
+        <line x1="131.93885" y1="144.47483" x2="131.93885" y2="95.22375" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_565">
+        <line x1="181.43884" y1="67.32375" x2="254.84892" y2="66.44257" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Group_566">
+        <g id="Graphic_570">
+          <rect x="278.4261" y="75.32374" width="89" height="42" fill="white"/>
+          <rect x="278.4261" y="75.32374" width="89" height="42" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(283.4261 89.32374)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="8.1640625" y="11">LinNodeJS</tspan>
+          </text>
+        </g>
+        <g id="Group_567">
+          <g id="Line_569">
+            <path d="M 359.80783 78.68374 L 354.95334 78.68374 L 354.95334 88.76374 L 363.04456 88.76374 L 363.04456 82.04374 L 359.80783 78.68374" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Line_568">
+            <path d="M 359.80783 78.68374 L 359.80783 82.04374 L 363.04456 82.04374 L 363.04456 82.04374" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+        </g>
+      </g>
+      <g id="Group_571">
+        <g id="Graphic_623">
+          <rect x="293.8741" y="106.32375" width="84.16106" height="42" fill="white"/>
+          <rect x="293.8741" y="106.32375" width="84.16106" height="42" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(298.8741 120.32375)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="3.4008408" y="11">OsxNodeJS</tspan>
+          </text>
+        </g>
+        <g id="Group_620">
+          <g id="Line_622">
+            <path d="M 370.8311 109.68375 L 366.24054 109.68375 L 366.24054 119.76375 L 373.89184 119.76375 L 373.89184 113.04375 L 370.8311 109.68375" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Line_621">
+            <path d="M 370.8311 109.68375 L 370.8311 113.04375 L 373.89184 113.04375" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+        </g>
+      </g>
+      <g id="Group_627">
+        <g id="Graphic_630">
+          <rect x="15.438845" y="311.60218" width="233" height="38" fill="white"/>
+          <rect x="15.438845" y="311.60218" width="233" height="38" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(20.438845 316.6022)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="11">execute(String code):EngineOutput</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="25">execute(File file):EngineOutput</tspan>
+          </text>
+        </g>
+        <g id="Graphic_629">
+          <rect x="15.438845" y="284.04318" width="233" height="24" fill="white"/>
+          <rect x="15.438845" y="284.04318" width="233" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(20.438845 289.04318)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="91.49902" y="11">Engine</tspan>
+          </text>
+        </g>
+        <g id="Graphic_628">
+          <rect x="15.438845" y="307.04418" width="233" height="4.55847" fill="white"/>
+          <rect x="15.438845" y="307.04418" width="233" height="4.55847" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+      </g>
+      <g id="Group_158">
+        <g id="Graphic_162">
+          <rect x="336.74754" y="188.35972" width="164.3741" height="45" fill="white"/>
+          <rect x="336.74754" y="188.35972" width="164.3741" height="45" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(341.74754 203.85972)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="16.15873" y="11">ResourceUrlResolver</tspan>
+          </text>
+        </g>
+        <g id="Group_159">
+          <g id="Graphic_161">
+            <ellipse cx="490.35775" cy="198.10972" rx="5.78287142687833" ry="6.75001078583783" fill="white"/>
+            <ellipse cx="490.35775" cy="198.10972" rx="5.78287142687833" ry="6.75001078583783" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width=".5"/>
+          </g>
+          <g id="Line_160">
+            <line x1="490.35775" y1="205.10973" x2="490.35775" y2="209.35972" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+        </g>
+      </g>
+      <g id="Group_636">
+        <g id="Line_638">
+          <line x1="501.12164" y1="210.85972" x2="535.21163" y2="222.31422" marker-end="url(#UML2Socket_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Line_637">
+          <line x1="573.64355" y1="235.7278" x2="547.796" y2="226.6172" marker-end="url(#EmptyCenterBall_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+      </g>
+      <g id="Graphic_639">
+        <rect x="574.1151" y="217.89402" width="140.56835" height="36" fill="white"/>
+        <rect x="574.1151" y="217.89402" width="140.56835" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(579.1151 228.89402)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="7.264641" y="11">PlatfromUrlResolver</tspan>
+        </text>
+      </g>
+      <g id="Line_640">
+        <path d="M 654.3202 316.82268 L 644.6043 316.83454 L 644.4332 264.29397" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_641">
+        <path d="M 755.2161 284.04318 L 754.6763 177.26619 L 258.33885 177.25456" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_646">
+        <rect x="336.74754" y="298.82665" width="164.3741" height="35.999985" fill="white"/>
+        <rect x="336.74754" y="298.82665" width="164.3741" height="35.999985" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(341.74754 309.82664)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="29.166542" y="11">PlainUrlResolver</tspan>
+        </text>
+      </g>
+      <g id="Group_647">
+        <g id="Line_649">
+          <line x1="418.93133" y1="233.8597" x2="418.71556" y2="266.971" marker-end="url(#UML2Socket_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Line_648">
+          <line x1="418.9346" y1="298.82665" x2="418.71656" y2="280.27048" marker-end="url(#EmptyCenterBall_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+      </g>
+      <g id="Line_650">
+        <line x1="248.43885" y1="316.8227" x2="326.84754" y2="316.8262" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_651">
+        <line x1="131.93885" y1="284.04318" x2="131.93885" y2="219.93383" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_652">
+        <line x1="248.43885" y1="210.03383" x2="326.84798" y2="210.76714" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_653">
+        <line x1="682.7161" y1="403.15363" x2="368.64095" y2="403.15363" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Group_659">
+        <g id="Graphic_662">
+          <rect x="654.3202" y="311.60218" width="201.79187" height="38" fill="white"/>
+          <rect x="654.3202" y="311.60218" width="201.79187" height="38" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(659.3202 316.60218)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="11">execute(String code):EngineOutput</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="25">execute(File file):EngineOutput</tspan>
+          </text>
+        </g>
+        <g id="Graphic_661">
+          <rect x="654.3202" y="284.04318" width="201.79187" height="24" fill="white"/>
+          <rect x="654.3202" y="284.04318" width="201.79187" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(659.3202 289.04318)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="75.89496" y="11">Engine</tspan>
+          </text>
+        </g>
+        <g id="Graphic_660">
+          <rect x="654.3202" y="307.04418" width="201.79187" height="4.55847" fill="white"/>
+          <rect x="654.3202" y="307.04418" width="201.79187" height="4.55847" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+      </g>
+    </g>
+  </g>
+</svg>
diff --git a/design/chapters/14_execution/images/n4js_elf.svg b/design/chapters/14_execution/images/n4js_elf.svg
new file mode 100644
index 0000000..61d130c
--- /dev/null
+++ b/design/chapters/14_execution/images/n4js_elf.svg
@@ -0,0 +1,396 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xl="http://www.w3.org/1999/xlink" xmlns:dc="http://purl.org/dc/elements/1.1/" viewBox="330.5 112.5 866.969 397.4085" width="866.969" height="397.4085">
+  <defs>
+    <font-face font-family="Helvetica" font-size="12" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="532.22656" cap-height="719.7266" ascent="770.0195" descent="-229.98047" font-weight="700">
+      <font-face-src>
+        <font-face-name name="Helvetica-Bold"/>
+      </font-face-src>
+    </font-face>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="StickArrow_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -4 10 8" markerWidth="10" markerHeight="8" color="black">
+      <g>
+        <path d="M 8 0 L 0 0 M 0 -3 L 8 0 L 0 3" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <font-face font-family="Helvetica" font-size="10" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="12" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+  </defs>
+  <metadata> Produced by OmniGraffle 7.11 
+    <dc:date>2015-04-22 09:39:00 +0000</dc:date>
+  </metadata>
+  <g id="Canvas_1" stroke="none" stroke-opacity="1" stroke-dasharray="none" fill="none" fill-opacity="1">
+    <title>Canvas 1</title>
+    <rect fill="white" x="330.5" y="112.5" width="866.969" height="397.4085"/>
+    <g id="Canvas_1: Layer 1">
+      <title>Layer 1</title>
+      <g id="Graphic_164">
+        <rect x="331" y="113" width="99" height="36" fill="white"/>
+        <rect x="331" y="113" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(336 124)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="8.5" y="11">NodeRunner</tspan>
+        </text>
+      </g>
+      <g id="Group_366">
+        <g id="Graphic_370">
+          <rect x="343.06295" y="249.65865" width="74.8741" height="42" fill="white"/>
+          <rect x="343.06295" y="249.65865" width="74.8741" height="42" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(348.06295 263.65865)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="6.427284" y="11">node.exe</tspan>
+          </text>
+        </g>
+        <g id="Group_367">
+          <g id="Line_369">
+            <path d="M 411.52795 253.01865 L 407.44395 253.01865 L 407.44395 263.09865 L 414.25095 263.09865 L 414.25095 256.37865 L 411.52795 253.01865" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Line_368">
+            <path d="M 411.52795 253.01865 L 411.52795 256.37865 L 414.25095 256.37865 L 414.25095 256.37865" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+        </g>
+      </g>
+      <g id="Line_494">
+        <line x1="430" y1="131" x2="477.86276" y2="153.45293" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_495">
+        <text transform="translate(421.76175 144.6187)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«generate»</tspan>
+        </text>
+      </g>
+      <g id="Line_496">
+        <line x1="417.93705" y1="270.65865" x2="477.40465" y2="251.454" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_497">
+        <text transform="translate(430.5525 261.29583)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«execute»</tspan>
+        </text>
+      </g>
+      <g id="Graphic_498">
+        <rect x="1097.969" y="113" width="99" height="36" fill="white"/>
+        <rect x="1097.969" y="113" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(1102.969 124)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x=".8300781" y="11">ChromeRunner</tspan>
+        </text>
+      </g>
+      <g id="Group_508">
+        <g id="Graphic_512">
+          <rect x="1107.938" y="249.65865" width="79.06205" height="42" fill="white"/>
+          <rect x="1107.938" y="249.65865" width="79.06205" height="42" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(1112.938 263.65865)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="1.1794624" y="11">chrome.exe</tspan>
+          </text>
+        </g>
+        <g id="Group_509">
+          <g id="Line_511">
+            <path d="M 1180.5909 253.01865 L 1176.5069 253.01865 L 1176.5069 263.09865 L 1183.3139 263.09865 L 1183.3139 256.37865 L 1180.5909 253.01865" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Line_510">
+            <path d="M 1180.5909 253.01865 L 1180.5909 256.37865 L 1183.3139 256.37865 L 1183.3139 256.37865" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+        </g>
+      </g>
+      <g id="Line_514">
+        <line x1="1127.816" y1="149.12678" x2="1022.0035" y2="176.86296" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_515">
+        <text transform="translate(1060.7537 164.14978)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«generate»</tspan>
+        </text>
+      </g>
+      <g id="Line_516">
+        <line x1="1107.938" y1="270.65865" x2="1021.9796" y2="247.2665" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_517">
+        <text transform="translate(1035.823 258.95896)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«execute»</tspan>
+        </text>
+      </g>
+      <g id="Line_518">
+        <line x1="380.5" y1="149" x2="380.5" y2="239.75865" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_519">
+        <text transform="translate(382.81013 189.65144)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«configure»</tspan>
+        </text>
+      </g>
+      <g id="Line_520">
+        <line x1="1147.469" y1="149" x2="1147.469" y2="239.75865" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_521">
+        <text transform="translate(1091.5513 189.65144)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«configure»</tspan>
+        </text>
+      </g>
+      <g id="Group_567">
+        <g id="Group_571">
+          <g id="Graphic_575">
+            <rect x="486.82556" y="249.4085" width="229.1615" height="24" fill="#efddf5"/>
+            <rect x="486.82556" y="249.4085" width="229.1615" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+            <text transform="translate(491.82556 254.4085)" fill="black">
+              <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="11">require(’ScriptCaller’);</tspan>
+            </text>
+          </g>
+          <g id="Graphic_574">
+            <rect x="486.82556" y="187.4085" width="229.1615" height="38" fill="#efddf5"/>
+            <rect x="486.82556" y="187.4085" width="229.1615" height="38" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+            <text transform="translate(491.82556 192.4085)" fill="black">
+              <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="11">require(’N4JSRuntime’);</tspan>
+              <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="25">require(’N4RequireAndDefine’);</tspan>
+            </text>
+          </g>
+          <g id="Graphic_573">
+            <rect x="486.82556" y="149.40851" width="229.1615" height="38" fill="white"/>
+            <rect x="486.82556" y="149.40851" width="229.1615" height="38" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+            <text transform="translate(491.82556 154.40851)" fill="black">
+              <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="0" y="25">noderunelf.js</tspan>
+            </text>
+          </g>
+          <g id="Graphic_627">
+            <rect x="486.82556" y="225.4085" width="229.1615" height="24" fill="#dedede"/>
+            <rect x="486.82556" y="225.4085" width="229.1615" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+            <text transform="translate(491.82556 230.4085)" fill="black">
+              <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="11">var executionData = data :’Main’};</tspan>
+            </text>
+          </g>
+        </g>
+        <g id="Group_568">
+          <g id="Line_570">
+            <path d="M 716.4254 151.40994 L 711.0641 151.40994 L 711.0641 160.46733 L 720 160.46733 L 720 154.42907 L 716.4254 151.40994" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Line_569">
+            <path d="M 716.4254 151.40994 L 716.4254 154.42907 L 720 154.42907 L 720 154.42907" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+        </g>
+      </g>
+      <g id="Group_576">
+        <g id="Group_580">
+          <g id="Graphic_584">
+            <rect x="768" y="249.4085" width="244.427" height="24" fill="#dedede"/>
+            <rect x="768" y="249.4085" width="244.427" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+            <text transform="translate(773 254.4085)" fill="black">
+              <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="11">&lt;script&gt;scriptCaller(’Main’);&lt;/script&gt;</tspan>
+            </text>
+          </g>
+          <g id="Graphic_583">
+            <rect x="768" y="187.4085" width="244.427" height="38" fill="#efddf5"/>
+            <rect x="768" y="187.4085" width="244.427" height="38" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+            <text transform="translate(773 192.4085)" fill="black">
+              <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="11">&lt;script src=’N4JSRuntime’&gt;&lt;/script&gt;</tspan>
+              <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="25">&lt;script src=’N4RequireAndDefine’&gt;&lt;/script&gt;</tspan>
+            </text>
+          </g>
+          <g id="Graphic_582">
+            <rect x="768" y="149.40851" width="244.427" height="38" fill="white"/>
+            <rect x="768" y="149.40851" width="244.427" height="38" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+            <text transform="translate(773 154.40851)" fill="black">
+              <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="0" y="25">chromerunelf.html</tspan>
+            </text>
+          </g>
+          <g id="Graphic_581">
+            <rect x="768" y="225.4085" width="244.427" height="24" fill="#efddf5"/>
+            <rect x="768" y="225.4085" width="244.427" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+            <text transform="translate(773 230.4085)" fill="black">
+              <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="11">&lt;script src=’ScriptCaller’&gt;&lt;/script&gt;</tspan>
+            </text>
+          </g>
+        </g>
+        <g id="Group_577">
+          <g id="Line_579">
+            <path d="M 1006.899 151.51995 L 1002.815 151.51995 L 1002.815 161.59995 L 1009.622 161.59995 L 1009.622 154.87995 L 1006.899 151.51995" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Line_578">
+            <path d="M 1006.899 151.51995 L 1006.899 154.87995 L 1009.622 154.87995 L 1009.622 154.87995" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+        </g>
+      </g>
+      <g id="Graphic_585">
+        <rect x="331" y="321" width="99" height="36" fill="white"/>
+        <rect x="331" y="321" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(336 332)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="11.933594" y="11">NodeTester</tspan>
+        </text>
+      </g>
+      <g id="Group_586">
+        <g id="Graphic_590">
+          <rect x="343.06295" y="457.65865" width="74.8741" height="42" fill="white"/>
+          <rect x="343.06295" y="457.65865" width="74.8741" height="42" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(348.06295 471.65865)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="6.427284" y="11">node.exe</tspan>
+          </text>
+        </g>
+        <g id="Group_587">
+          <g id="Line_589">
+            <path d="M 411.52795 461.01865 L 407.44395 461.01865 L 407.44395 471.09865 L 414.25095 471.09865 L 414.25095 464.37865 L 411.52795 461.01865" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Line_588">
+            <path d="M 411.52795 461.01865 L 411.52795 464.37865 L 414.25095 464.37865 L 414.25095 464.37865" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+        </g>
+      </g>
+      <g id="Line_591">
+        <line x1="430" y1="339" x2="478.1237" y2="365.10854" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_592">
+        <text transform="translate(421.2176 353.93634)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«generate»</tspan>
+        </text>
+      </g>
+      <g id="Line_593">
+        <line x1="418.4229" y1="478.5405" x2="477.2059" y2="464.2458" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_594">
+        <text transform="translate(430.23975 472.08116)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«execute»</tspan>
+        </text>
+      </g>
+      <g id="Line_595">
+        <line x1="380.5" y1="357.5" x2="380.5" y2="447.75865" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_596">
+        <text transform="translate(382.81013 397.9197)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«configure»</tspan>
+        </text>
+      </g>
+      <g id="Group_597">
+        <g id="Group_601">
+          <g id="Graphic_628">
+            <rect x="486.82556" y="485.4085" width="234.3797" height="24" fill="#efddf5"/>
+            <rect x="486.82556" y="485.4085" width="234.3797" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+            <text transform="translate(491.82556 490.4085)" fill="black">
+              <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="11">require(’TestLibCaller’);</tspan>
+            </text>
+          </g>
+          <g id="Graphic_604">
+            <rect x="486.82556" y="395.4085" width="234.3797" height="38" fill="#efddf5"/>
+            <rect x="486.82556" y="395.4085" width="234.3797" height="38" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+            <text transform="translate(491.82556 400.4085)" fill="black">
+              <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="11">require(’N4JSRuntime’);</tspan>
+              <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="25">require(’N4RequireAndDefine’);</tspan>
+            </text>
+          </g>
+          <g id="Graphic_603">
+            <rect x="486.82556" y="357.4085" width="234.3797" height="38" fill="white"/>
+            <rect x="486.82556" y="357.4085" width="234.3797" height="38" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+            <text transform="translate(491.82556 362.4085)" fill="black">
+              <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="0" y="25">nodetestelf.js</tspan>
+            </text>
+          </g>
+          <g id="Graphic_602">
+            <rect x="486.82556" y="433.4085" width="234.3797" height="52" fill="#dedede"/>
+            <rect x="486.82556" y="433.4085" width="234.3797" height="52" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+            <text transform="translate(491.82556 438.4085)" fill="black">
+              <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="11">var executionData = {data: [’testRunner’, </tspan>
+              <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="25">‘TestClient’, ‘TestClass1, TestClass2, </tspan>
+              <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="39">TestClass3’]};</tspan>
+            </text>
+          </g>
+        </g>
+        <g id="Group_598">
+          <g id="Line_600">
+            <path d="M 711.9848 359.44806 L 706.7272 359.44806 L 706.7272 368.67794 L 715.4903 368.67794 L 715.4903 362.5247 L 711.9848 359.44806" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Line_599">
+            <path d="M 711.9848 359.44806 L 711.9848 362.5247 L 715.4903 362.5247 L 715.4903 362.5247" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+        </g>
+      </g>
+      <g id="Graphic_606">
+        <rect x="1097.969" y="321" width="99" height="36" fill="white"/>
+        <rect x="1097.969" y="321" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(1102.969 332)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="4.263672" y="11">ChromeTester</tspan>
+        </text>
+      </g>
+      <g id="Group_607">
+        <g id="Graphic_611">
+          <rect x="1107.938" y="457.65865" width="79.06205" height="42" fill="white"/>
+          <rect x="1107.938" y="457.65865" width="79.06205" height="42" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(1112.938 471.65865)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="1.1794624" y="11">chrome.exe</tspan>
+          </text>
+        </g>
+        <g id="Group_608">
+          <g id="Line_610">
+            <path d="M 1180.5909 461.01865 L 1176.5069 461.01865 L 1176.5069 471.09865 L 1183.3139 471.09865 L 1183.3139 464.37865 L 1180.5909 461.01865" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Line_609">
+            <path d="M 1180.5909 461.01865 L 1180.5909 464.37865 L 1183.3139 464.37865 L 1183.3139 464.37865" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+        </g>
+      </g>
+      <g id="Line_612">
+        <line x1="1138.0049" y1="357.14707" x2="1021.889" y2="392.88343" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_613">
+        <text transform="translate(1067.451 375.26404)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«generate»</tspan>
+        </text>
+      </g>
+      <g id="Line_614">
+        <line x1="1107.938" y1="478.65865" x2="1022.1199" y2="460.8229" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_615">
+        <text transform="translate(1036.2525 470.06524)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«execute»</tspan>
+        </text>
+      </g>
+      <g id="Line_616">
+        <line x1="1147.469" y1="357.5" x2="1147.469" y2="447.75865" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_617">
+        <text transform="translate(1091.5513 397.9197)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«configure»</tspan>
+        </text>
+      </g>
+      <g id="Group_618">
+        <g id="Group_622">
+          <g id="Graphic_626">
+            <rect x="768" y="457.4085" width="244.427" height="52" fill="#dedede"/>
+            <rect x="768" y="457.4085" width="244.427" height="52" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+            <text transform="translate(773 462.4085)" fill="black">
+              <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="11">&lt;script&gt;testLibCaller(’testRunner’, </tspan>
+              <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="25">‘TestClient’, ‘TestClass1, TestClass2, </tspan>
+              <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="39">TestClass3’);&lt;/script&gt;</tspan>
+            </text>
+          </g>
+          <g id="Graphic_625">
+            <rect x="768" y="395.4085" width="244.427" height="38" fill="#efddf5"/>
+            <rect x="768" y="395.4085" width="244.427" height="38" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+            <text transform="translate(773 400.4085)" fill="black">
+              <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="11">&lt;script src=’N4JSRuntime’&gt;&lt;/script&gt;</tspan>
+              <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="25">&lt;script src=’N4RequireAndDefine’&gt;&lt;/script&gt;</tspan>
+            </text>
+          </g>
+          <g id="Graphic_624">
+            <rect x="768" y="357.4085" width="244.427" height="38" fill="white"/>
+            <rect x="768" y="357.4085" width="244.427" height="38" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+            <text transform="translate(773 362.4085)" fill="black">
+              <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="0" y="25">chrometestelf.html</tspan>
+            </text>
+          </g>
+          <g id="Graphic_623">
+            <rect x="768" y="433.4085" width="244.427" height="24" fill="#efddf5"/>
+            <rect x="768" y="433.4085" width="244.427" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+            <text transform="translate(773 438.4085)" fill="black">
+              <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="11">&lt;script src=’TestLibCaller’&gt;&lt;/script&gt;</tspan>
+            </text>
+          </g>
+        </g>
+        <g id="Group_619">
+          <g id="Line_621">
+            <path d="M 1006.899 359.51995 L 1002.815 359.51995 L 1002.815 369.59995 L 1009.622 369.59995 L 1009.622 362.87995 L 1006.899 359.51995" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Line_620">
+            <path d="M 1006.899 359.51995 L 1006.899 362.87995 L 1009.622 362.87995 L 1009.622 362.87995" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+        </g>
+      </g>
+    </g>
+  </g>
+</svg>
diff --git a/design/chapters/14_execution/images/od_sampleNodeProjectExecution.svg b/design/chapters/14_execution/images/od_sampleNodeProjectExecution.svg
new file mode 100644
index 0000000..01f8f61
--- /dev/null
+++ b/design/chapters/14_execution/images/od_sampleNodeProjectExecution.svg
@@ -0,0 +1,380 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xl="http://www.w3.org/1999/xlink" xmlns:dc="http://purl.org/dc/elements/1.1/" viewBox="4.5000006 2.25 407.25 582.96736" width="407.25" height="582.96736">
+  <defs>
+    <font-face font-family="Helvetica" font-size="9" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="12" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="532.22656" cap-height="719.7266" ascent="770.0195" descent="-229.98047" font-weight="700">
+      <font-face-src>
+        <font-face-name name="Helvetica-Bold"/>
+      </font-face-src>
+    </font-face>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="StickArrow_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -4 10 8" markerWidth="10" markerHeight="8" color="black">
+      <g>
+        <path d="M 8 0 L 0 0 M 0 -3 L 8 0 L 0 3" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <font-face font-family="Helvetica" font-size="10" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="8" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="UMLInheritance_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -8 14 16" markerWidth="14" markerHeight="16" color="black">
+      <g>
+        <path d="M 12 0 L 0 -7 L 0 7 Z" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="FilledDiamond_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-9 -4 10 8" markerWidth="10" markerHeight="8" color="black">
+      <g>
+        <path d="M -8 0 L -4 3 L 0 0 L -4 -3 Z" fill="currentColor" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+  </defs>
+  <metadata> Produced by OmniGraffle 7.11 
+    <dc:date>2018-01-08 15:34:14 +0000</dc:date>
+  </metadata>
+  <g id="Canvas_1" stroke="none" stroke-opacity="1" stroke-dasharray="none" fill="none" fill-opacity="1">
+    <title>Canvas 1</title>
+    <rect fill="white" x="4.5000006" y="2.25" width="407.25" height="582.96736"/>
+    <g id="Canvas_1: Layer 1">
+      <title>Layer 1</title>
+      <g id="Graphic_458">
+        <path d="M 9.500001 273.375 L 402.25 273.375 C 405.0114 273.375 407.25 275.61358 407.25 278.375 L 407.25 406.2319 C 407.25 408.9933 405.0114 411.2319 402.25 411.2319 L 9.500001 411.2319 C 6.738577 411.2319 4.5000006 408.9933 4.5000006 406.2319 L 4.5000006 278.375 C 4.5000006 275.61358 6.738577 273.375 9.500001 273.375 Z" fill="#eedcf5"/>
+        <text transform="translate(9.500001 278.375)" fill="black"/>
+      </g>
+      <g id="Graphic_457">
+        <path d="M 9.500001 180 L 402.25 180 C 405.0114 180 407.25 182.23858 407.25 185 L 407.25 262.75 C 407.25 265.51142 405.0114 267.75 402.25 267.75 L 9.500001 267.75 C 6.738577 267.75 4.5000006 265.51142 4.5000006 262.75 L 4.5000006 185 C 4.5000006 182.23858 6.738577 180 9.500001 180 Z" fill="#caeaf2"/>
+        <text transform="translate(9.500001 185)" fill="black"/>
+      </g>
+      <g id="Graphic_455">
+        <path d="M 9.500001 2.25 L 402.25 2.25 C 405.0114 2.25 407.25 4.488576 407.25 7.25 L 407.25 169.375 C 407.25 172.13642 405.0114 174.375 402.25 174.375 L 9.500001 174.375 C 6.738577 174.375 4.5000006 172.13642 4.5000006 169.375 L 4.5000006 7.25 C 4.5000006 4.488576 6.738577 2.25 9.500001 2.25 Z" fill="#efcfbb"/>
+        <text transform="translate(9.500001 7.25)" fill="black"/>
+      </g>
+      <g id="Graphic_182">
+        <rect x="95.15" y="302.79588" width="99" height="36" fill="white"/>
+        <rect x="95.15" y="302.79588" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(100.15 308.29588)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="14.98413" y="9">«RuntimeEnv»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="16.164062" y="22">n4js-node</tspan>
+        </text>
+      </g>
+      <g id="Graphic_215">
+        <rect x="95.15" y="24.75" width="99" height="36" fill="white"/>
+        <rect x="95.15" y="24.75" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(100.15 30.25)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="31.487793" y="9">«App»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="27.833008" y="22">Client</tspan>
+        </text>
+      </g>
+      <g id="Graphic_254">
+        <rect x="127.775" y="103.07521" width="99" height="36" fill="white"/>
+        <rect x="127.775" y="103.07521" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(132.775 108.57521)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="33.4895" y="9">«Lib»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="22.161133" y="22">UserLib</tspan>
+        </text>
+      </g>
+      <g id="Line_255">
+        <path d="M 177.65 60.75 L 177.65 72.65 L 177.275 91.17521 L 177.275 93.17521" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_256">
+        <text transform="translate(181.02788 64.663)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«depend»</tspan>
+        </text>
+      </g>
+      <g id="Graphic_148">
+        <path d="M 70 17.242081 C 70 13.883126 69.2253 13.467556 63.56633 10.14335 L 63.50655 10.108955 C 57.81769 6.75 57.75852 6.75 51.92021 6.75 C 44.14637 6.75 9 6.75 9 6.75 L 9 42.2082 L 70 42.2082 L 70 17.242081 Z" fill="#efcfbb"/>
+        <path d="M 70 17.242081 C 70 13.883126 69.2253 13.467556 63.56633 10.14335 L 63.50655 10.108955 C 57.81769 6.75 57.75852 6.75 51.92021 6.75 C 44.14637 6.75 9 6.75 9 6.75 L 9 42.2082 L 70 42.2082 L 70 17.242081 Z M 70 17.069045 C 70 13.883126 69.94022 13.883126 57.75852 13.883126 L 57.75852 13.883126 C 57.75852 6.784749 57.75852 6.75 52.27767 6.75" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(14 19.4791)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="4.6015625" y="8">User Space</tspan>
+        </text>
+      </g>
+      <g id="Graphic_519">
+        <path d="M 70 196.9005 C 70 193.54154 69.2253 193.12597 63.56633 189.80176 L 63.50655 189.76737 C 57.81769 186.40841 57.75852 186.40841 51.92021 186.40841 C 44.14637 186.40841 9 186.40841 9 186.40841 L 9 221.8666 L 70 221.8666 L 70 196.9005 Z" fill="#cbeaf3"/>
+        <path d="M 70 196.9005 C 70 193.54154 69.2253 193.12597 63.56633 189.80176 L 63.50655 189.76737 C 57.81769 186.40841 57.75852 186.40841 51.92021 186.40841 C 44.14637 186.40841 9 186.40841 9 186.40841 L 9 221.8666 L 70 221.8666 L 70 196.9005 Z M 70 196.72746 C 70 193.54154 69.94022 193.54154 57.75852 193.54154 L 57.75852 193.54154 C 57.75852 186.44316 57.75852 186.40841 52.27767 186.40841" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(14 194.13751)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="10.605469" y="8">Runtime </tspan>
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="14.158203" y="18">Space</tspan>
+        </text>
+      </g>
+      <g id="Graphic_520">
+        <path d="M 70 289.11067 C 70 285.7517 69.2253 285.33614 63.56633 282.01194 L 63.50655 281.97754 C 57.81769 278.6186 57.75852 278.6186 51.92021 278.6186 C 44.14637 278.6186 9.000001 278.6186 9.000001 278.6186 L 9.000001 314.0768 L 70 314.0768 L 70 289.11067 Z" fill="#efddf5"/>
+        <path d="M 70 289.11067 C 70 285.7517 69.2253 285.33614 63.56633 282.01194 L 63.50655 281.97754 C 57.81769 278.6186 57.75852 278.6186 51.92021 278.6186 C 44.14637 278.6186 9.000001 278.6186 9.000001 278.6186 L 9.000001 314.0768 L 70 314.0768 L 70 289.11067 Z M 70 288.93763 C 70 285.7517 69.94022 285.7517 57.75852 285.7517 L 57.75852 285.7517 C 57.75852 278.65334 57.75852 278.6186 52.27767 278.6186" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(14 286.3477)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="3.044922" y="8">Environment </tspan>
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="14.158203" y="18">Space</tspan>
+        </text>
+      </g>
+      <g id="Graphic_540">
+        <rect x="95.15" y="370.2959" width="99" height="36" fill="white"/>
+        <rect x="95.15" y="370.2959" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(100.15 375.7959)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="14.98413" y="9">«RuntimeEnv»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="20.485352" y="22">n4js-es5</tspan>
+        </text>
+      </g>
+      <g id="Line_165">
+        <line x1="144.65" y1="338.7959" x2="144.65" y2="356.7959" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_542">
+        <line x1="203.4" y1="320.7959" x2="235.775" y2="320.79588" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_545">
+        <line x1="203.4" y1="388.2959" x2="235.775" y2="388.2959" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_587">
+        <rect x="95.15" y="193.77542" width="134.30071" height="36" fill="white"/>
+        <rect x="95.15" y="193.77542" width="134.30071" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(100.15 199.27542)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="34.38351" y="9">«RuntimeLib»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="4.1249657" y="22">n4js-runtime-es2015</tspan>
+        </text>
+      </g>
+      <g id="Line_588">
+        <path d="M 144.65 302.79588 L 144.65 265.89588 L 139.9169 265.89588 L 139.9169 239.67542" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Group_577">
+        <g id="Graphic_581">
+          <rect x="235.775" y="302.79588" width="99" height="36" fill="white"/>
+          <rect x="235.775" y="302.79588" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(240.775 308.29588)" fill="black">
+            <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="14.731445" y="9">«ExecModule»</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="17.154297" y="22">n4js-cli.js</tspan>
+          </text>
+        </g>
+        <g id="Group_578">
+          <g id="Line_580">
+            <path d="M 328.75843 307.2676 L 324.67443 307.2676 L 324.67443 317.3476 L 331.48143 317.3476 L 331.48143 310.6276 L 328.75843 307.2676" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Line_579">
+            <path d="M 328.75843 307.2676 L 328.75843 310.6276 L 331.48143 310.6276 L 331.48143 310.6276" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+        </g>
+      </g>
+      <g id="Group_582">
+        <g id="Graphic_586">
+          <rect x="235.775" y="372.83086" width="99" height="30.930032" fill="white"/>
+          <rect x="235.775" y="372.83086" width="99" height="30.930032" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(240.775 375.7959)" fill="black">
+            <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="18.732666" y="9">«InitModule»</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="33.496094" y="22">rt.js</tspan>
+          </text>
+        </g>
+        <g id="Group_583">
+          <g id="Line_585">
+            <path d="M 328.78285 376.74616 L 324.69885 376.74616 L 324.69885 386.82616 L 331.50585 386.82616 L 331.50585 380.10616 L 328.78285 376.74616" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Line_584">
+            <path d="M 328.78285 376.74616 L 328.78285 380.10616 L 331.50585 380.10616 L 331.50585 380.10616" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+        </g>
+      </g>
+      <g id="Line_589">
+        <line x1="238.67277" y1="200.49386" x2="293.63117" y2="204.77542" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_590">
+        <line x1="238.5249" y1="225.5703" x2="293.63117" y2="236.4703" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Group_591">
+        <g id="Graphic_595">
+          <rect x="293.63117" y="193.77542" width="96.05071" height="22" fill="white"/>
+          <rect x="293.63117" y="193.77542" width="96.05071" height="22" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(298.63117 197.77542)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="11.689419" y="11">Math.n4jsd</tspan>
+          </text>
+        </g>
+        <g id="Group_592">
+          <g id="Line_594">
+            <path d="M 382.5159 197.1334 L 378.4319 197.1334 L 378.4319 207.2134 L 385.2389 207.2134 L 385.2389 200.4934 L 382.5159 197.1334" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Line_593">
+            <path d="M 382.5159 197.1334 L 382.5159 200.4934 L 385.2389 200.4934 L 385.2389 200.4934" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+        </g>
+      </g>
+      <g id="Group_596">
+        <g id="Graphic_600">
+          <rect x="293.63117" y="225.4703" width="96.05071" height="22" fill="white"/>
+          <rect x="293.63117" y="225.4703" width="96.05071" height="22" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(298.63117 229.4703)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="7.678677" y="11">timers.n4jsd</tspan>
+          </text>
+        </g>
+        <g id="Group_597">
+          <g id="Line_599">
+            <path d="M 383.6653 229.94203 L 379.5813 229.94203 L 379.5813 240.02203 L 386.3883 240.02203 L 386.3883 233.30203 L 383.6653 229.94203" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Line_598">
+            <path d="M 383.6653 229.94203 L 383.6653 233.30203 L 386.3883 233.30203 L 386.3883 233.30203" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+        </g>
+      </g>
+      <g id="Line_601">
+        <line x1="203.39959" y1="36.662533" x2="299.9" y2="35.75" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Group_602">
+        <g id="Graphic_606">
+          <rect x="299.9" y="24.75" width="83.51305" height="22" fill="white"/>
+          <rect x="299.9" y="24.75" width="83.51305" height="22" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(304.9 28.75)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="13.75555" y="11">foo.n4js</tspan>
+          </text>
+        </g>
+        <g id="Group_603">
+          <g id="Line_605">
+            <path d="M 376.24705 28.107988 L 372.16305 28.107988 L 372.16305 38.187988 L 378.97005 38.187988 L 378.97005 31.467988 L 376.24705 28.107988" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Line_604">
+            <path d="M 376.24705 28.107988 L 376.24705 31.467988 L 378.97005 31.467988 L 378.97005 31.467988" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+        </g>
+      </g>
+      <g id="Line_607">
+        <line x1="236.02107" y1="126.80558" x2="262.775" y2="126.02542" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Group_608">
+        <g id="Graphic_612">
+          <rect x="262.775" y="115.02542" width="83.51305" height="22" fill="white"/>
+          <rect x="262.775" y="115.02542" width="83.51305" height="22" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(267.775 119.02542)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="14.074886" y="11">bar.n4js</tspan>
+          </text>
+        </g>
+        <g id="Group_609">
+          <g id="Line_611">
+            <path d="M 339.12205 118.3834 L 335.03805 118.3834 L 335.03805 128.4634 L 341.84505 128.4634 L 341.84505 121.7434 L 339.12205 118.3834" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Line_610">
+            <path d="M 339.12205 118.3834 L 339.12205 121.7434 L 341.84505 121.7434 L 341.84505 121.7434" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+        </g>
+      </g>
+      <g id="Line_613">
+        <path d="M 341.65653 46.75 L 341.65653 80.65 L 304.53153 80.65 L 304.53153 105.12542" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_614">
+        <text transform="translate(312.74407 81.58462)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«import»</tspan>
+        </text>
+      </g>
+      <g id="Line_615">
+        <path d="M 304.53153 137.02542 L 304.53153 164.92542 L 341.65653 164.92542 L 341.65653 183.87542" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_617">
+        <path d="M 383.41305 35.75 L 395.31305 35.75 L 401.5819 35.75 L 401.5819 236.4703 L 399.5819 236.4703" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_618">
+        <path d="M 111.65 60.75 L 111.65 115.57521 C 106.15 115.57521 106.15 126.57521 111.65 126.57521 L 111.65 155.65 L 117.53345 155.65 L 117.53345 173.97542" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_619">
+        <path d="M 177.275 139.5752 L 177.275 157.4752 L 162.30035 157.4752 L 162.30035 183.87542" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_620">
+        <path d="M 14 447.3605 L 406.75 447.3605 C 409.5114 447.3605 411.75 449.59906 411.75 452.3605 L 411.75 580.21736 C 411.75 582.9788 409.5114 585.21736 406.75 585.21736 L 14 585.21736 C 11.238576 585.21736 9 582.9788 9 580.21736 L 9 452.3605 C 9 449.59906 11.238576 447.3605 14 447.3605 Z" fill="#e6e6e6"/>
+        <text transform="translate(14 452.3605)" fill="black"/>
+      </g>
+      <g id="Graphic_621">
+        <rect x="99.65" y="476.78136" width="99" height="36" fill="white"/>
+        <rect x="99.65" y="476.78136" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(104.65 487.78136)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="2.828125" y="11">N4JSNodeRun</tspan>
+        </text>
+      </g>
+      <g id="Graphic_622">
+        <path d="M 74.5 462.7421 C 74.5 459.3831 73.7253 458.96756 68.06633 455.64335 L 68.00655 455.60896 C 62.31769 452.25 62.25852 452.25 56.42021 452.25 C 48.64637 452.25 13.5 452.25 13.5 452.25 L 13.5 487.7082 L 74.5 487.7082 L 74.5 462.7421 Z" fill="#dedede"/>
+        <path d="M 74.5 462.7421 C 74.5 459.3831 73.7253 458.96756 68.06633 455.64335 L 68.00655 455.60896 C 62.31769 452.25 62.25852 452.25 56.42021 452.25 C 48.64637 452.25 13.5 452.25 13.5 452.25 L 13.5 487.7082 L 74.5 487.7082 L 74.5 462.7421 Z M 74.5 462.56905 C 74.5 459.3831 74.44022 459.3831 62.25852 459.3831 L 62.25852 459.3831 C 62.25852 452.28475 62.25852 452.25 56.77767 452.25" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(18.5 459.9791)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="15.71875" y="8">Temp</tspan>
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="14.158203" y="18">Space</tspan>
+        </text>
+      </g>
+      <g id="Group_633">
+        <g id="Graphic_637">
+          <rect x="231.275" y="483.78136" width="88.01305" height="22" fill="white"/>
+          <rect x="231.275" y="483.78136" width="88.01305" height="22" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(236.275 487.78136)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="9.662777" y="11">n4jsELF.js</tspan>
+          </text>
+        </g>
+        <g id="Group_634">
+          <g id="Line_636">
+            <path d="M 313.2959 487.69665 L 309.2119 487.69665 L 309.2119 497.77665 L 316.0189 497.77665 L 316.0189 491.05665 L 313.2959 487.69665" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Line_635">
+            <path d="M 313.2959 487.69665 L 313.2959 491.05665 L 316.0189 491.05665 L 316.0189 491.05665" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+        </g>
+      </g>
+      <g id="Line_638">
+        <line x1="207.9" y1="494.78137" x2="231.275" y2="494.78136" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Group_639">
+        <g id="Graphic_643">
+          <rect x="118.01847" y="534.6504" width="113.0094" height="22" fill="white"/>
+          <rect x="118.01847" y="534.6504" width="113.0094" height="22" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(123.01847 538.6504)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="9.164856" y="11">node_modules</tspan>
+          </text>
+        </g>
+        <g id="Group_640">
+          <g id="Line_642">
+            <path d="M 225.03573 538.5657 L 220.95173 538.5657 L 220.95173 548.6457 L 227.75873 548.6457 L 227.75873 541.9257 L 225.03573 538.5657" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Line_641">
+            <path d="M 225.03573 538.5657 L 225.03573 541.9257 L 227.75873 541.9257 L 227.75873 541.9257" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+        </g>
+      </g>
+      <g id="Line_644">
+        <line x1="174.16347" y1="522.0276" x2="174.52318" y2="534.6504" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_645">
+        <path d="M 275.28153 483.78136 L 275.28153 471.88136 L 275.28153 446.88136 L 83.25 446.88136 L 83.25 388.29587 L 85.25 388.29587" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_646">
+        <text transform="translate(150.64134 447.816)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«link file system»</tspan>
+        </text>
+      </g>
+      <g id="Line_647">
+        <path d="M 275.28153 483.78136 L 275.28153 420.88136 L 83.25 420.88136 L 83.25 320.79587 L 85.25 320.79587" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_649">
+        <path d="M 275.28153 483.78136 L 275.28153 420.88136 L 83.25 420.88136 L 83.25 211.77542 L 85.25 211.77542" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_650">
+        <path d="M 275.28153 483.78136 L 275.28153 420.88136 L 83.25 420.88136 L 83.25 42.75 L 85.25 42.75" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_651">
+        <path d="M 275.28153 483.78136 L 275.28153 421.09376 L 82.93751 421.09376 L 82.93751 121.07521 L 117.875 121.07521" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_652">
+        <path d="M 275.28153 505.78136 L 275.28153 545.6504 L 240.92788 545.6504" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_653">
+        <text transform="translate(235.05058 547.3663)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«link file system»</tspan>
+        </text>
+      </g>
+      <g id="Line_654">
+        <path d="M 319.28805 494.78136 L 331.18805 494.78136 L 346.675 494.78136 L 346.675 320.79588 L 344.675 320.79588" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_655">
+        <text transform="translate(356.51587 428.52773)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«call»</tspan>
+        </text>
+      </g>
+      <g id="Line_658">
+        <path d="M 319.28805 494.78136 L 331.18805 494.78136 L 346.675 494.78136 L 346.675 388.2959 L 344.675 388.2959" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+    </g>
+  </g>
+</svg>
diff --git a/design/chapters/14_execution/images/od_sampleProjectDependencyGraph.svg b/design/chapters/14_execution/images/od_sampleProjectDependencyGraph.svg
new file mode 100644
index 0000000..b838b79
--- /dev/null
+++ b/design/chapters/14_execution/images/od_sampleProjectDependencyGraph.svg
@@ -0,0 +1,379 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xl="http://www.w3.org/1999/xlink" xmlns:dc="http://purl.org/dc/elements/1.1/" viewBox="4.5 3.375 508.7646 643.6564" width="508.7646" height="643.6564">
+  <defs>
+    <font-face font-family="Helvetica" font-size="9" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="12" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="532.22656" cap-height="719.7266" ascent="770.0195" descent="-229.98047" font-weight="700">
+      <font-face-src>
+        <font-face-name name="Helvetica-Bold"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="11" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="532.22656" cap-height="719.7266" ascent="770.0195" descent="-229.98047" font-weight="700">
+      <font-face-src>
+        <font-face-name name="Helvetica-Bold"/>
+      </font-face-src>
+    </font-face>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="StickArrow_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -4 10 8" markerWidth="10" markerHeight="8" color="black">
+      <g>
+        <path d="M 8 0 L 0 0 M 0 -3 L 8 0 L 0 3" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <font-face font-family="Helvetica" font-size="10" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="FilledDiamond_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-9 -4 10 8" markerWidth="10" markerHeight="8" color="black">
+      <g>
+        <path d="M -8 0 L -4 3 L 0 0 L -4 -3 Z" fill="currentColor" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <font-face font-family="Helvetica" font-size="8" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="UMLInheritance_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -8 14 16" markerWidth="14" markerHeight="16" color="black">
+      <g>
+        <path d="M 12 0 L 0 -7 L 0 7 Z" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+  </defs>
+  <metadata> Produced by OmniGraffle 7.11 
+    <dc:date>2015-04-09 13:41:59 +0000</dc:date>
+  </metadata>
+  <g id="Canvas_1" stroke="none" stroke-opacity="1" stroke-dasharray="none" fill="none" fill-opacity="1">
+    <title>Canvas 1</title>
+    <rect fill="white" x="4.5" y="3.375" width="508.7646" height="643.6564"/>
+    <g id="Canvas_1: Layer 1">
+      <title>Layer 1</title>
+      <g id="Graphic_458">
+        <path d="M 9.5 509.1745 L 508.2646 509.1745 C 511.026 509.1745 513.2646 511.4131 513.2646 514.1745 L 513.2646 642.0314 C 513.2646 644.7928 511.026 647.0314 508.2646 647.0314 L 9.5 647.0314 C 6.738576 647.0314 4.5 644.7928 4.5 642.0314 L 4.5 514.1745 C 4.5 511.4131 6.738576 509.1745 9.5 509.1745 Z" fill="#eedcf5"/>
+        <text transform="translate(9.5 514.1745)" fill="black"/>
+      </g>
+      <g id="Graphic_457">
+        <path d="M 9.5 337.27183 L 508.2646 337.27183 C 511.026 337.27183 513.2646 339.5104 513.2646 342.27183 L 513.2646 496.5737 C 513.2646 499.3351 511.026 501.5737 508.2646 501.5737 L 9.5 501.5737 C 6.738576 501.5737 4.5 499.3351 4.5 496.5737 L 4.5 342.27183 C 4.5 339.5104 6.738576 337.27183 9.5 337.27183 Z" fill="#caeaf2"/>
+        <text transform="translate(9.5 342.27183)" fill="black"/>
+      </g>
+      <g id="Graphic_456">
+        <path d="M 9.5 124.39627 L 508.2646 124.39627 C 511.026 124.39627 513.2646 126.63484 513.2646 129.39627 L 513.2646 324.82738 C 513.2646 327.5888 511.026 329.82738 508.2646 329.82738 L 9.5 329.82738 C 6.738576 329.82738 4.5 327.5888 4.5 324.82738 L 4.5 129.39627 C 4.5 126.63484 6.738576 124.39627 9.5 124.39627 Z" fill="#def0c5"/>
+        <text transform="translate(9.5 129.39627)" fill="black"/>
+      </g>
+      <g id="Graphic_455">
+        <path d="M 9.5 3.375 L 508.2646 3.375 C 511.026 3.375 513.2646 5.613576 513.2646 8.375 L 513.2646 111.87186 C 513.2646 114.63328 511.026 116.87186 508.2646 116.87186 L 9.5 116.87186 C 6.738576 116.87186 4.5 114.63328 4.5 111.87186 L 4.5 8.375 C 4.5 5.613576 6.738576 3.375 9.5 3.375 Z" fill="#efcfbb"/>
+        <text transform="translate(9.5 8.375)" fill="black"/>
+      </g>
+      <g id="Graphic_182">
+        <rect x="153" y="537.195" width="99" height="36" fill="white"/>
+        <rect x="153" y="537.195" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(158 542.695)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="14.98413" y="9">«RuntimeEnv»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="22.826172" y="22">NodeJs</tspan>
+        </text>
+      </g>
+      <g id="Graphic_188">
+        <rect x="288" y="417.92707" width="99" height="36" fill="white"/>
+        <rect x="288" y="417.92707" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(293 423.42707)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="16.733154" y="9">«RuntimeLib»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="7.477539" y="22">ES7 Observe</tspan>
+        </text>
+      </g>
+      <g id="Graphic_189">
+        <rect x="389.9493" y="342.7834" width="99" height="36" fill="white"/>
+        <rect x="389.9493" y="342.7834" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(394.9493 348.2834)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="16.733154" y="9">«RuntimeLib»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="1.849121" y="22">ES6 </tspan>
+          <tspan font-family="Helvetica" font-size="11" font-weight="700" fill="black" y="22">Collections</tspan>
+        </text>
+      </g>
+      <g id="Graphic_190">
+        <rect x="281.25" y="174.51442" width="99" height="36" fill="white"/>
+        <rect x="281.25" y="174.51442" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(286.25 180.01442)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="24.73999" y="9">«SysAPI»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="28.500977" y="22">stdlib</tspan>
+        </text>
+      </g>
+      <g id="Graphic_192">
+        <rect x="281.25" y="261.11636" width="99" height="36" fill="white"/>
+        <rect x="281.25" y="261.11636" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(286.25 266.61636)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="25.988037" y="9">«SysLib»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="13.158203" y="22">stdlib_n4js</tspan>
+        </text>
+      </g>
+      <g id="Line_146">
+        <line x1="330.75" y1="261.11636" x2="330.75" y2="220.41442" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_212">
+        <text transform="translate(266.5997 229.75737)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«implements»</tspan>
+        </text>
+      </g>
+      <g id="Graphic_215">
+        <rect x="138.375" y="23.349583" width="99" height="36" fill="white"/>
+        <rect x="138.375" y="23.349583" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(143.375 28.849583)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="31.487793" y="9">«App»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="27.833008" y="22">Client</tspan>
+        </text>
+      </g>
+      <g id="Line_223">
+        <line x1="261.4701" y1="543.8755" x2="308.25" y2="532.4181" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_227">
+        <path d="M 202.5 537.195 L 202.5 489.29497 L 439.4493 489.29497 L 439.4493 388.6834" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_229">
+        <path d="M 202.5 537.195 L 202.5 489.29497 L 304.5 489.29497 L 304.5 463.8271" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_530">
+        <text transform="translate(152.7618 520.61403)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«provides»</tspan>
+        </text>
+      </g>
+      <g id="Line_240">
+        <line x1="169.77462" y1="192.51442" x2="271.35" y2="192.51442" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_241">
+        <text transform="translate(210.2886 192.51442)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«use»</tspan>
+        </text>
+      </g>
+      <g id="Line_242">
+        <path d="M 347.25 297.61636 L 347.25 309.51636 L 347.25 320.51636 L 337.5 320.51636 L 337.5 406.02707 L 337.5 408.02707" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_244">
+        <path d="M 347.25 297.61636 L 347.25 320.51636 L 406.4493 320.51636 L 406.4493 332.8834" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_245">
+        <text transform="translate(317.43405 299.65918)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«use»</tspan>
+        </text>
+      </g>
+      <g id="Graphic_254">
+        <rect x="261" y="74.12186" width="99" height="36" fill="white"/>
+        <rect x="261" y="74.12186" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(266 79.62186)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="33.4895" y="9">«Lib»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="22.161133" y="22">UserLib</tspan>
+        </text>
+      </g>
+      <g id="Line_255">
+        <path d="M 220.875 59.84958 L 220.875 92.12186 L 251.1 92.12186" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_256">
+        <text transform="translate(175.72163 69.46805)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«use»</tspan>
+        </text>
+      </g>
+      <g id="Line_257">
+        <path d="M 310.5 110.12186 L 310.5 142.02186 L 330.75 142.02186 L 330.75 164.61442" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_258">
+        <text transform="translate(301.69765 151.22431)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«use»</tspan>
+        </text>
+      </g>
+      <g id="Graphic_528">
+        <rect x="12.375" y="409.50486" width="108" height="36" fill="white"/>
+        <rect x="12.375" y="409.50486" width="108" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(17.375 415.00486)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="21.233154" y="9">«RuntimeLib»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="29.429688" y="22">Timers</tspan>
+        </text>
+      </g>
+      <g id="Line_529">
+        <path d="M 202.5 537.195 L 202.5 489.29497 L 84.375 489.29497 L 84.375 455.40486" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_264">
+        <rect x="70.77462" y="174.51442" width="99" height="36" fill="white"/>
+        <rect x="70.77462" y="174.51442" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(75.77462 180.01442)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="24.73999" y="9">«SysAPI»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="4.8115234" y="22">n4Processors</tspan>
+        </text>
+      </g>
+      <g id="Graphic_265">
+        <rect x="59.52462" y="261.11636" width="121.5" height="36" fill="white"/>
+        <rect x="59.52462" y="261.11636" width="121.5" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(64.52462 266.61636)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="37.238037" y="9">«SysLib»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x=".71875" y="22">n4Processors_n4js</tspan>
+        </text>
+      </g>
+      <g id="Line_269">
+        <line x1="120.27462" y1="261.11636" x2="120.27462" y2="220.41442" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_270">
+        <text transform="translate(123.60898 230.37087)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«implements»</tspan>
+        </text>
+      </g>
+      <g id="Line_531">
+        <path d="M 120.27462 297.61636 L 120.27462 353.51636 L 84.375 353.51636 L 84.375 399.60486" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_273">
+        <path d="M 154.875 59.34958 L 154.875 132.24958 L 120.27462 132.24958 L 120.27462 164.61442" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_301">
+        <line x1="246.625" y1="41.349583" x2="381.375" y2="41.349583" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_148">
+        <path d="M 70 17.242081 C 70 13.883126 69.2253 13.467556 63.56633 10.14335 L 63.50655 10.108955 C 57.81769 6.75 57.75852 6.75 51.92021 6.75 C 44.14637 6.75 9 6.75 9 6.75 L 9 42.2082 L 70 42.2082 L 70 17.242081 Z" fill="#efcfbb"/>
+        <path d="M 70 17.242081 C 70 13.883126 69.2253 13.467556 63.56633 10.14335 L 63.50655 10.108955 C 57.81769 6.75 57.75852 6.75 51.92021 6.75 C 44.14637 6.75 9 6.75 9 6.75 L 9 42.2082 L 70 42.2082 L 70 17.242081 Z M 70 17.069045 C 70 13.883126 69.94022 13.883126 57.75852 13.883126 L 57.75852 13.883126 C 57.75852 6.784749 57.75852 6.75 52.27767 6.75" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(14 19.4791)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="4.6015625" y="8">User Space</tspan>
+        </text>
+      </g>
+      <g id="Graphic_518">
+        <path d="M 70 140.28832 C 70 136.92937 69.2253 136.5138 63.56633 133.1896 L 63.50655 133.1552 C 57.81769 129.79624 57.75852 129.79624 51.92021 129.79624 C 44.14637 129.79624 9 129.79624 9 129.79624 L 9 165.25444 L 70 165.25444 L 70 140.28832 Z" fill="#def0c5"/>
+        <path d="M 70 140.28832 C 70 136.92937 69.2253 136.5138 63.56633 133.1896 L 63.50655 133.1552 C 57.81769 129.79624 57.75852 129.79624 51.92021 129.79624 C 44.14637 129.79624 9 129.79624 9 129.79624 L 9 165.25444 L 70 165.25444 L 70 140.28832 Z M 70 140.11529 C 70 136.92937 69.94022 136.92937 57.75852 136.92937 L 57.75852 136.92937 C 57.75852 129.83099 57.75852 129.79624 52.27767 129.79624" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(14 137.52534)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="12.164062" y="8">System </tspan>
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="14.158203" y="18">Space</tspan>
+        </text>
+      </g>
+      <g id="Graphic_519">
+        <path d="M 70 353.2755 C 70 349.91654 69.2253 349.50097 63.56633 346.17676 L 63.50655 346.14237 C 57.81769 342.7834 57.75852 342.7834 51.92021 342.7834 C 44.14637 342.7834 9 342.7834 9 342.7834 L 9 378.2416 L 70 378.2416 L 70 353.2755 Z" fill="#cbeaf3"/>
+        <path d="M 70 353.2755 C 70 349.91654 69.2253 349.50097 63.56633 346.17676 L 63.50655 346.14237 C 57.81769 342.7834 57.75852 342.7834 51.92021 342.7834 C 44.14637 342.7834 9 342.7834 9 342.7834 L 9 378.2416 L 70 378.2416 L 70 353.2755 Z M 70 353.10246 C 70 349.91654 69.94022 349.91654 57.75852 349.91654 L 57.75852 349.91654 C 57.75852 342.81816 57.75852 342.7834 52.27767 342.7834" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(14 350.5125)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="10.605469" y="8">Runtime </tspan>
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="14.158203" y="18">Space</tspan>
+        </text>
+      </g>
+      <g id="Graphic_520">
+        <path d="M 70 524.9102 C 70 521.5512 69.2253 521.13565 63.56633 517.81144 L 63.50655 517.77705 C 57.81769 514.4181 57.75852 514.4181 51.92021 514.4181 C 44.14637 514.4181 9 514.4181 9 514.4181 L 9 549.8763 L 70 549.8763 L 70 524.9102 Z" fill="#efddf5"/>
+        <path d="M 70 524.9102 C 70 521.5512 69.2253 521.13565 63.56633 517.81144 L 63.50655 517.77705 C 57.81769 514.4181 57.75852 514.4181 51.92021 514.4181 C 44.14637 514.4181 9 514.4181 9 514.4181 L 9 549.8763 L 70 549.8763 L 70 524.9102 Z M 70 524.73714 C 70 521.5512 69.94022 521.5512 57.75852 521.5512 L 57.75852 521.5512 C 57.75852 514.45284 57.75852 514.4181 52.27767 514.4181" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(14 522.1472)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="3.044922" y="8">Environment </tspan>
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="14.158203" y="18">Space</tspan>
+        </text>
+      </g>
+      <g id="Graphic_540">
+        <rect x="153" y="604.695" width="99" height="36" fill="white"/>
+        <rect x="153" y="604.695" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(158 610.195)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="14.98413" y="9">«RuntimeEnv»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="33.15918" y="22">ES5</tspan>
+        </text>
+      </g>
+      <g id="Line_165">
+        <line x1="202.5" y1="573.195" x2="202.5" y2="591.195" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_542">
+        <line x1="261.13383" y1="565.6564" x2="308.25" y2="573.195" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_543">
+        <path d="M 474.75 573.195 L 497.21856 573.195 L 497.21856 41.349583 L 490.275 41.349583" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_545">
+        <line x1="261.75" y1="622.695" x2="308.25" y2="622.695" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_546">
+        <text transform="translate(481.2646 572.10294)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«call»</tspan>
+        </text>
+      </g>
+      <g id="Graphic_547">
+        <rect x="164.9493" y="371.02497" width="99" height="36" fill="white"/>
+        <rect x="164.9493" y="371.02497" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(169.9493 376.52497)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="16.733154" y="9">«RuntimeLib»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="20.831055" y="22">Console</tspan>
+        </text>
+      </g>
+      <g id="Line_551">
+        <path d="M 202.5 537.195 L 202.5 525.29497 L 202.5 489.29497 L 181.4493 489.29497 L 181.4493 418.92497 L 181.4493 416.92497" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_552">
+        <path d="M 120.27462 297.11636 L 120.27462 353.01636 L 214.4493 353.01636 L 214.4493 361.12497" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_553">
+        <text transform="translate(90.45867 304.0694)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«use»</tspan>
+        </text>
+      </g>
+      <g id="Line_554">
+        <path d="M 314.25 297.61636 L 314.25 334.51636 L 214.4493 334.51636 L 214.4493 361.12497" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Group_567">
+        <g id="Graphic_571">
+          <rect x="381.375" y="23.349583" width="99" height="36" fill="white"/>
+          <rect x="381.375" y="23.349583" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(386.375 34.349583)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="17.160156" y="11">Main.n4js</tspan>
+          </text>
+        </g>
+        <g id="Group_568">
+          <g id="Line_570">
+            <path d="M 472.027 26.216573 L 467.943 26.216573 L 467.943 36.296573 L 474.75 36.296573 L 474.75 29.576573 L 472.027 26.216573" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Line_569">
+            <path d="M 472.027 26.216573 L 472.027 29.576573 L 474.75 29.576573" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+        </g>
+      </g>
+      <g id="Group_572">
+        <g id="Graphic_576">
+          <rect x="308.25" y="514.4181" width="166.5" height="36" fill="white"/>
+          <rect x="308.25" y="514.4181" width="166.5" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(313.25 519.9181)" fill="black">
+            <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="52.482666" y="9">«InitModule»</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="11.570312" y="22">N4RequireAndDefine.js</tspan>
+          </text>
+        </g>
+        <g id="Group_573">
+          <g id="Line_575">
+            <path d="M 467.584 517.7761 L 463.5 517.7761 L 463.5 527.8561 L 470.307 527.8561 L 470.307 521.1361 L 467.584 517.7761" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Line_574">
+            <path d="M 467.584 517.7761 L 467.584 521.1361 L 470.307 521.1361 L 470.307 521.1361" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+        </g>
+      </g>
+      <g id="Group_577">
+        <g id="Graphic_581">
+          <rect x="308.25" y="555.195" width="166.5" height="36" fill="white"/>
+          <rect x="308.25" y="555.195" width="166.5" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(313.25 560.695)" fill="black">
+            <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="48.481445" y="9">«ExecModule»</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="38.22754" y="22">ScriptCaller.js</tspan>
+          </text>
+        </g>
+        <g id="Group_578">
+          <g id="Line_580">
+            <path d="M 468.7334 559.6667 L 464.6494 559.6667 L 464.6494 569.7467 L 471.4564 569.7467 L 471.4564 563.0267 L 468.7334 559.6667" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Line_579">
+            <path d="M 468.7334 559.6667 L 468.7334 563.0267 L 471.4564 563.0267 L 471.4564 563.0267" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+        </g>
+      </g>
+      <g id="Group_582">
+        <g id="Graphic_586">
+          <rect x="308.25" y="604.695" width="166.5" height="36" fill="white"/>
+          <rect x="308.25" y="604.695" width="166.5" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(313.25 610.195)" fill="black">
+            <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="52.482666" y="9">«InitModule»</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="32.570312" y="22">N4JSRuntime.js</tspan>
+          </text>
+        </g>
+        <g id="Group_583">
+          <g id="Line_585">
+            <path d="M 468.75785 608.61026 L 464.67385 608.61026 L 464.67385 618.69026 L 471.48085 618.69026 L 471.48085 611.97026 L 468.75785 608.61026" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Line_584">
+            <path d="M 468.75785 608.61026 L 468.75785 611.97026 L 471.48085 611.97026 L 471.48085 611.97026" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+        </g>
+      </g>
+    </g>
+  </g>
+</svg>
diff --git a/design/chapters/14_execution/images/od_sampleTestProjectDependencyGraph.svg b/design/chapters/14_execution/images/od_sampleTestProjectDependencyGraph.svg
new file mode 100644
index 0000000..c195981
--- /dev/null
+++ b/design/chapters/14_execution/images/od_sampleTestProjectDependencyGraph.svg
@@ -0,0 +1,542 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xl="http://www.w3.org/1999/xlink" xmlns:dc="http://purl.org/dc/elements/1.1/" viewBox="4.5 5.625 509.24774 697.0299" width="509.24774" height="697.0299">
+  <defs>
+    <font-face font-family="Helvetica" font-size="9" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="12" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="532.22656" cap-height="719.7266" ascent="770.0195" descent="-229.98047" font-weight="700">
+      <font-face-src>
+        <font-face-name name="Helvetica-Bold"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="11" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="532.22656" cap-height="719.7266" ascent="770.0195" descent="-229.98047" font-weight="700">
+      <font-face-src>
+        <font-face-name name="Helvetica-Bold"/>
+      </font-face-src>
+    </font-face>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="StickArrow_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -4 10 8" markerWidth="10" markerHeight="8" color="black">
+      <g>
+        <path d="M 8 0 L 0 0 M 0 -3 L 8 0 L 0 3" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <font-face font-family="Helvetica" font-size="10" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="FilledDiamond_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-9 -4 10 8" markerWidth="10" markerHeight="8" color="black">
+      <g>
+        <path d="M -8 0 L -4 3 L 0 0 L -4 -3 Z" fill="currentColor" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <font-face font-family="Helvetica" font-size="8" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="UMLInheritance_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -8 14 16" markerWidth="14" markerHeight="16" color="black">
+      <g>
+        <path d="M 12 0 L 0 -7 L 0 7 Z" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+  </defs>
+  <metadata> Produced by OmniGraffle 7.11 
+    <dc:date>2015-04-08 16:17:50 +0000</dc:date>
+  </metadata>
+  <g id="Canvas_1" stroke="none" stroke-opacity="1" stroke-dasharray="none" fill="none" fill-opacity="1">
+    <title>Canvas 1</title>
+    <rect fill="white" x="4.5" y="5.625" width="509.24774" height="697.0299"/>
+    <g id="Canvas_1: Layer 1">
+      <title>Layer 1</title>
+      <g id="Graphic_458">
+        <path d="M 9.5 511.92306 L 508.2646 511.92306 C 511.026 511.92306 513.2646 514.16164 513.2646 516.92306 L 513.2646 697.6549 C 513.2646 700.4164 511.026 702.6549 508.2646 702.6549 L 9.5 702.6549 C 6.738576 702.6549 4.5 700.4164 4.5 697.6549 L 4.5 516.92306 C 4.5 514.16164 6.738576 511.92306 9.5 511.92306 Z" fill="#eedcf5"/>
+        <text transform="translate(9.5 516.92306)" fill="black"/>
+      </g>
+      <g id="Graphic_457">
+        <path d="M 9.983168 339.92926 L 508.74774 339.92926 C 511.50916 339.92926 513.74774 342.16784 513.74774 344.92926 L 513.74774 499.2311 C 513.74774 501.99253 511.50916 504.2311 508.74774 504.2311 L 9.983168 504.2311 C 7.221744 504.2311 4.9831677 501.99253 4.9831677 499.2311 L 4.9831677 344.92926 C 4.9831677 342.16784 7.221744 339.92926 9.983168 339.92926 Z" fill="#caeaf2"/>
+        <text transform="translate(9.983168 344.92926)" fill="black"/>
+      </g>
+      <g id="Graphic_456">
+        <path d="M 9.983168 126.8062 L 508.74774 126.8062 C 511.50916 126.8062 513.74774 129.04477 513.74774 131.8062 L 513.74774 327.2373 C 513.74774 329.99873 511.50916 332.2373 508.74774 332.2373 L 9.983168 332.2373 C 7.221744 332.2373 4.9831677 329.99873 4.9831677 327.2373 L 4.9831677 131.8062 C 4.9831677 129.04477 7.221744 126.8062 9.983168 126.8062 Z" fill="#def0c5"/>
+        <text transform="translate(9.983168 131.8062)" fill="black"/>
+      </g>
+      <g id="Graphic_455">
+        <path d="M 9.983168 5.625 L 508.74774 5.625 C 511.50916 5.625 513.74774 7.863576 513.74774 10.625 L 513.74774 114.12186 C 513.74774 116.88328 511.50916 119.12186 508.74774 119.12186 L 9.983168 119.12186 C 7.221744 119.12186 4.9831677 116.88328 4.9831677 114.12186 L 4.9831677 10.625 C 4.9831677 7.863576 7.221744 5.625 9.983168 5.625 Z" fill="#efcfbb"/>
+        <text transform="translate(9.983168 10.625)" fill="black"/>
+      </g>
+      <g id="Graphic_182">
+        <rect x="128.30746" y="595.2962" width="99" height="36" fill="white"/>
+        <rect x="128.30746" y="595.2962" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(133.30746 600.7962)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="14.98413" y="9">«RuntimeEnv»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="22.826172" y="22">NodeJs</tspan>
+        </text>
+      </g>
+      <g id="Graphic_188">
+        <rect x="145.125" y="425.25" width="99" height="36" fill="white"/>
+        <rect x="145.125" y="425.25" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(150.125 430.75)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="16.733154" y="9">«RuntimeLib»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="7.477539" y="22">ES7 Observe</tspan>
+        </text>
+      </g>
+      <g id="Graphic_189">
+        <rect x="215.83286" y="349.3421" width="99" height="36" fill="white"/>
+        <rect x="215.83286" y="349.3421" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(220.83286 354.8421)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="16.733154" y="9">«RuntimeLib»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="1.849121" y="22">ES6 </tspan>
+          <tspan font-family="Helvetica" font-size="11" font-weight="700" fill="black" y="22">Collections</tspan>
+        </text>
+      </g>
+      <g id="Graphic_190">
+        <rect x="261.48317" y="175.76442" width="99" height="36" fill="white"/>
+        <rect x="261.48317" y="175.76442" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(266.48317 181.26442)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="24.73999" y="9">«SysAPI»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="28.500977" y="22">stdlib</tspan>
+        </text>
+      </g>
+      <g id="Graphic_192">
+        <rect x="261.48317" y="263.24803" width="99" height="36" fill="white"/>
+        <rect x="261.48317" y="263.24803" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(266.48317 268.74803)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="25.988037" y="9">«SysLib»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="13.158203" y="22">stdlib_n4js</tspan>
+        </text>
+      </g>
+      <g id="Line_146">
+        <line x1="310.98317" y1="263.24803" x2="310.98317" y2="221.66442" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_212">
+        <text transform="translate(246.83286 231.4472)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«implements»</tspan>
+        </text>
+      </g>
+      <g id="Graphic_215">
+        <rect x="138.85817" y="25.599583" width="99" height="36" fill="white"/>
+        <rect x="138.85817" y="25.599583" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(143.85817 31.099583)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="31.487793" y="9">«App»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="27.833008" y="22">Client</tspan>
+        </text>
+      </g>
+      <g id="Line_223">
+        <line x1="236.266" y1="601.9925" x2="280.88175" y2="590.5193" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_227">
+        <path d="M 153.05746 595.2962 L 153.05746 491.3962 L 265.33286 491.3962 L 265.33286 395.2421" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_229">
+        <path d="M 153.05746 595.2962 L 153.05746 491.3962 L 194.625 491.3962 L 194.625 471.15" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_530">
+        <text transform="translate(101.68352 574.20104)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«provides»</tspan>
+        </text>
+      </g>
+      <g id="Line_240">
+        <path d="M 170.25779 194.76442 L 216.1578 194.76442 L 216.1578 193.76442 L 251.58317 193.76442" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_241">
+        <text transform="translate(201.35809 194.76442)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«use»</tspan>
+        </text>
+      </g>
+      <g id="Line_242">
+        <path d="M 327.48317 299.24803 L 327.48317 311.14803 L 327.48317 324.14803 L 211.125 324.14803 L 211.125 413.35 L 211.125 415.35" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_244">
+        <path d="M 327.48317 299.24803 L 327.48317 324.14803 L 281.83286 324.14803 L 281.83286 339.4421" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_245">
+        <text transform="translate(289.5049 300.6264)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«use»</tspan>
+        </text>
+      </g>
+      <g id="Graphic_254">
+        <rect x="261.48317" y="76.37186" width="99" height="36" fill="white"/>
+        <rect x="261.48317" y="76.37186" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(266.48317 81.87186)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="33.4895" y="9">«Lib»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="22.161133" y="22">UserLib</tspan>
+        </text>
+      </g>
+      <g id="Line_255">
+        <path d="M 221.35817 61.59958 L 221.35817 94.37186 L 251.58317 94.37186" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_256">
+        <text transform="translate(176.2048 71.32591)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«use»</tspan>
+        </text>
+      </g>
+      <g id="Line_257">
+        <line x1="310.98317" y1="112.37186" x2="310.98317" y2="165.86442" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_258">
+        <text transform="translate(281.7807 134.15593)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«use»</tspan>
+        </text>
+      </g>
+      <g id="Graphic_528">
+        <rect x="10.125" y="416.86303" width="108" height="36" fill="white"/>
+        <rect x="10.125" y="416.86303" width="108" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(15.125 422.36303)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="21.233154" y="9">«RuntimeLib»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="29.429688" y="22">Timers</tspan>
+        </text>
+      </g>
+      <g id="Line_529">
+        <path d="M 153.05746 595.2962 L 153.05746 491.3962 L 82.125 491.3962 L 82.125 462.76303" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_264">
+        <rect x="71.25779" y="176.76442" width="99" height="36" fill="white"/>
+        <rect x="71.25779" y="176.76442" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(76.25779 182.26442)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="24.73999" y="9">«SysAPI»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="4.8115234" y="22">n4Processors</tspan>
+        </text>
+      </g>
+      <g id="Graphic_265">
+        <rect x="60.00779" y="263.36636" width="121.5" height="36" fill="white"/>
+        <rect x="60.00779" y="263.36636" width="121.5" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(65.00779 268.86636)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="37.238037" y="9">«SysLib»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x=".71875" y="22">n4Processors_n4js</tspan>
+        </text>
+      </g>
+      <g id="Line_269">
+        <line x1="120.75779" y1="262.86636" x2="120.75779" y2="222.66442" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_270">
+        <text transform="translate(124.09214 232.36538)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«implements»</tspan>
+        </text>
+      </g>
+      <g id="Line_531">
+        <path d="M 120.75779 299.36636 L 120.75779 358.26636 L 82.125 358.26636 L 82.125 406.96303" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_273">
+        <path d="M 155.35817 61.59958 L 155.35817 134.49958 L 120.75779 134.49958 L 120.75779 166.86442" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_301">
+        <line x1="132.20403" y1="62.02492" x2="116.35817" y2="77.32591" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_148">
+        <path d="M 68.23317 20.617081 C 68.23317 17.258126 67.45847 16.842556 61.7995 13.51835 L 61.73972 13.483955 C 56.05086 10.125 55.99169 10.125 50.15338 10.125 C 42.37954 10.125 7.233168 10.125 7.233168 10.125 L 7.233168 45.5832 L 68.23317 45.5832 L 68.23317 20.617081 Z" fill="#efcfbb"/>
+        <path d="M 68.23317 20.617081 C 68.23317 17.258126 67.45847 16.842556 61.7995 13.51835 L 61.73972 13.483955 C 56.05086 10.125 55.99169 10.125 50.15338 10.125 C 42.37954 10.125 7.233168 10.125 7.233168 10.125 L 7.233168 45.5832 L 68.23317 45.5832 L 68.23317 20.617081 Z M 68.23317 20.444045 C 68.23317 17.258126 68.17339 17.258126 55.99169 17.258126 L 55.99169 17.258126 C 55.99169 10.159749 55.99169 10.125 50.51084 10.125" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(12.233168 22.8541)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="4.6015625" y="8">User Space</tspan>
+        </text>
+      </g>
+      <g id="Graphic_518">
+        <path d="M 68.23317 140.97702 C 68.23317 137.61806 67.45847 137.2025 61.7995 133.87829 L 61.73972 133.8439 C 56.05086 130.48494 55.99169 130.48494 50.15338 130.48494 C 42.37954 130.48494 7.233168 130.48494 7.233168 130.48494 L 7.233168 165.94314 L 68.23317 165.94314 L 68.23317 140.97702 Z" fill="#def0c5"/>
+        <path d="M 68.23317 140.97702 C 68.23317 137.61806 67.45847 137.2025 61.7995 133.87829 L 61.73972 133.8439 C 56.05086 130.48494 55.99169 130.48494 50.15338 130.48494 C 42.37954 130.48494 7.233168 130.48494 7.233168 130.48494 L 7.233168 165.94314 L 68.23317 165.94314 L 68.23317 140.97702 Z M 68.23317 140.80398 C 68.23317 137.61806 68.17339 137.61806 55.99169 137.61806 L 55.99169 137.61806 C 55.99169 130.51969 55.99169 130.48494 50.51084 130.48494" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(12.233168 138.21404)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="12.164062" y="8">System </tspan>
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="14.158203" y="18">Space</tspan>
+        </text>
+      </g>
+      <g id="Graphic_519">
+        <path d="M 68.23317 357.16373 C 68.23317 353.80477 67.45847 353.3892 61.7995 350.065 L 61.73972 350.0306 C 56.05086 346.67165 55.99169 346.67165 50.15338 346.67165 C 42.37954 346.67165 7.233168 346.67165 7.233168 346.67165 L 7.233168 382.12985 L 68.23317 382.12985 L 68.23317 357.16373 Z" fill="#cbeaf3"/>
+        <path d="M 68.23317 357.16373 C 68.23317 353.80477 67.45847 353.3892 61.7995 350.065 L 61.73972 350.0306 C 56.05086 346.67165 55.99169 346.67165 50.15338 346.67165 C 42.37954 346.67165 7.233168 346.67165 7.233168 346.67165 L 7.233168 382.12985 L 68.23317 382.12985 L 68.23317 357.16373 Z M 68.23317 356.9907 C 68.23317 353.80477 68.17339 353.80477 55.99169 353.80477 L 55.99169 353.80477 C 55.99169 346.7064 55.99169 346.67165 50.51084 346.67165" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(12.233168 354.40075)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="10.605469" y="8">Runtime </tspan>
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="14.158203" y="18">Space</tspan>
+        </text>
+      </g>
+      <g id="Graphic_520">
+        <path d="M 68.23317 525.91104 C 68.23317 522.5521 67.45847 522.1365 61.7995 518.8123 L 61.73972 518.7779 C 56.05086 515.41896 55.99169 515.41896 50.15338 515.41896 C 42.37954 515.41896 7.233168 515.41896 7.233168 515.41896 L 7.233168 550.87716 L 68.23317 550.87716 L 68.23317 525.91104 Z" fill="#efddf5"/>
+        <path d="M 68.23317 525.91104 C 68.23317 522.5521 67.45847 522.1365 61.7995 518.8123 L 61.73972 518.7779 C 56.05086 515.41896 55.99169 515.41896 50.15338 515.41896 C 42.37954 515.41896 7.233168 515.41896 7.233168 515.41896 L 7.233168 550.87716 L 68.23317 550.87716 L 68.23317 525.91104 Z M 68.23317 525.738 C 68.23317 522.5521 68.17339 522.5521 55.99169 522.5521 L 55.99169 522.5521 C 55.99169 515.4537 55.99169 515.41896 50.51084 515.41896" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(12.233168 523.14806)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="3.044922" y="8">Environment </tspan>
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="14.158203" y="18">Space</tspan>
+        </text>
+      </g>
+      <g id="Graphic_540">
+        <rect x="128.30746" y="662.7962" width="99" height="36" fill="white"/>
+        <rect x="128.30746" y="662.7962" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(133.30746 668.2962)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="14.98413" y="9">«RuntimeEnv»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="33.15918" y="22">ES5</tspan>
+        </text>
+      </g>
+      <g id="Line_165">
+        <line x1="177.80746" y1="631.2962" x2="177.80746" y2="649.2962" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_542">
+        <line x1="236.48702" y1="623.4356" x2="280.88175" y2="628.94594" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_543">
+        <path d="M 447.38175 540.9198 L 506.95746 540.9198 L 506.95746 383.25 L 504.95746 383.25" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_545">
+        <line x1="236.55746" y1="680.7962" x2="280.88175" y2="680.7962" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_546">
+        <text transform="translate(456.8759 527.14806)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«call»</tspan>
+        </text>
+      </g>
+      <g id="Graphic_547">
+        <rect x="109.125" y="378" width="99" height="36" fill="white"/>
+        <rect x="109.125" y="378" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(114.125 383.5)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="16.733154" y="9">«RuntimeLib»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="20.831055" y="22">Console</tspan>
+        </text>
+      </g>
+      <g id="Line_551">
+        <path d="M 153.05746 595.2962 L 153.05746 491.3962 L 125.625 491.3962 L 125.625 423.9" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_552">
+        <path d="M 120.75779 299.36636 L 120.75779 358.26636 L 158.625 358.26636 L 158.625 368.1" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_553">
+        <text transform="translate(90.94184 302.3443)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«use»</tspan>
+        </text>
+      </g>
+      <g id="Line_554">
+        <path d="M 277.98317 299.24803 L 277.98317 318.14803 L 158.625 318.14803 L 158.625 368.1" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_556">
+        <rect x="159.38175" y="522.9198" width="99" height="36" fill="white"/>
+        <rect x="159.38175" y="522.9198" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(164.38175 528.4198)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="23.48755" y="9">«TestEnv»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="10.93164" y="22">NodeJsTest</tspan>
+        </text>
+      </g>
+      <g id="Line_558">
+        <path d="M 208.88175 559.4198 L 208.88175 574.9198 L 202.55746 574.9198 L 202.55746 581.7962" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_559">
+        <line x1="267.63175" y1="540.9198" x2="280.88175" y2="540.9198" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_560">
+        <rect x="372.375" y="263.24803" width="99" height="36" fill="white"/>
+        <rect x="372.375" y="263.24803" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(377.375 268.74803)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="23.988525" y="9">«TestAPI»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="12.496094" y="22">mangelhaft</tspan>
+        </text>
+      </g>
+      <g id="Line_561">
+        <path d="M 422.6983 61.937515 L 422.6983 123.22097 L 367.0412 123.22097 L 367.0412 230.76442 L 405.375 230.76442 L 405.375 253.34803" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_562">
+        <text transform="translate(423.8406 69.081906)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«depends»</tspan>
+        </text>
+      </g>
+      <g id="Line_566">
+        <path d="M 454.875 253.99803 L 454.875 251.99803 L 454.55746 209.12913 L 454.55746 197.87913" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_567">
+        <rect x="361.22994" y="25.937515" width="92.20252" height="36" fill="white"/>
+        <rect x="361.22994" y="25.937515" width="92.20252" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(366.22994 31.437515)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="28.089054" y="9">«App»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="12.539738" y="22">TestClient</tspan>
+        </text>
+      </g>
+      <g id="Line_568">
+        <path d="M 361.22994 43.937515 L 349.32994 43.937515 L 249.75817 43.599583 L 247.75817 43.599583" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_569">
+        <text transform="translate(286.878 43.77311)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«use»</tspan>
+        </text>
+      </g>
+      <g id="Graphic_570">
+        <rect x="373.55746" y="458.0016" width="121.5" height="36" fill="white"/>
+        <rect x="373.55746" y="458.0016" width="121.5" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(378.55746 463.5016)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="35.238525" y="9">«TestAPI»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="2.7460938" y="22">mangelhaftRunner</tspan>
+        </text>
+      </g>
+      <g id="Line_572">
+        <line x1="434.30746" y1="448.7516" x2="434.30746" y2="389.25" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_573">
+        <path d="M 233.63175 522.9198 L 233.63175 507.0198 L 393.80746 507.0198 L 393.80746 503.9016" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_574">
+        <path d="M 495.05746 359.25 L 506.95746 359.25 L 506.95746 190.96178 L 504.95746 190.96178" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_575">
+        <text transform="translate(477.42125 337.35044)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«call»</tspan>
+        </text>
+      </g>
+      <g id="Line_576">
+        <path d="M 495.05746 170.20971 L 506.95746 170.20971 L 506.95746 43.937515 L 463.33246 43.937515" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_577">
+        <text transform="translate(476.92125 140.56701)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«test»</tspan>
+        </text>
+      </g>
+      <g id="Group_580">
+        <g id="Graphic_584">
+          <rect x="17.358168" y="59.325914" width="99" height="36" fill="white"/>
+          <rect x="17.358168" y="59.325914" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(22.358168 70.325914)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="17.160156" y="11">Main.n4js</tspan>
+          </text>
+        </g>
+        <g id="Group_581">
+          <g id="Line_583">
+            <path d="M 108.99312 63.62594 L 104.90912 63.62594 L 104.90912 73.70594 L 111.71612 73.70594 L 111.71612 66.98594 L 108.99312 63.62594" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Line_582">
+            <path d="M 108.99312 63.62594 L 108.99312 66.98594 L 111.71612 66.98594" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+        </g>
+      </g>
+      <g id="Group_587">
+        <g id="Graphic_591">
+          <rect x="373.55746" y="156.375" width="121.5" height="41.504133" fill="white"/>
+          <rect x="373.55746" y="156.375" width="121.5" height="41.504133" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(378.55746 170.12707)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="1.84375" y="11">TestController.n4js</tspan>
+          </text>
+        </g>
+        <g id="Group_588">
+          <g id="Line_590">
+            <path d="M 488.87884 161.36329 L 484.79484 161.36329 L 484.79484 171.44329 L 491.60184 171.44329 L 491.60184 164.72329 L 488.87884 161.36329" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Line_589">
+            <path d="M 488.87884 161.36329 L 488.87884 164.72329 L 491.60184 164.72329" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+        </g>
+      </g>
+      <g id="Group_593">
+        <g id="Graphic_597">
+          <rect x="373.55746" y="353.25" width="121.5" height="36" fill="white"/>
+          <rect x="373.55746" y="353.25" width="121.5" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(378.55746 364.25)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="10.735352" y="11">testRunner.n4js</tspan>
+          </text>
+        </g>
+        <g id="Group_594">
+          <g id="Line_596">
+            <path d="M 487.8326 357.6652 L 483.7486 357.6652 L 483.7486 367.7452 L 490.5556 367.7452 L 490.5556 361.0252 L 487.8326 357.6652" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Line_595">
+            <path d="M 487.8326 357.6652 L 487.8326 361.0252 L 490.5556 361.0252" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+        </g>
+      </g>
+      <g id="Group_599">
+        <g id="Graphic_603">
+          <rect x="280.88175" y="522.9198" width="166.5" height="36" fill="white"/>
+          <rect x="280.88175" y="522.9198" width="166.5" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(285.88175 528.4198)" fill="black">
+            <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="48.481445" y="9">«ExecModule»</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="34.339844" y="22">TestLibCaller.js</tspan>
+          </text>
+        </g>
+        <g id="Group_600">
+          <g id="Line_602">
+            <path d="M 439.48234 527.0969 L 435.39834 527.0969 L 435.39834 537.1769 L 442.20534 537.1769 L 442.20534 530.4569 L 439.48234 527.0969" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Line_601">
+            <path d="M 439.48234 527.0969 L 439.48234 530.4569 L 442.20534 530.4569 L 442.20534 530.4569" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+        </g>
+      </g>
+      <g id="Group_605">
+        <g id="Graphic_609">
+          <rect x="280.88175" y="572.5193" width="166.5" height="36" fill="white"/>
+          <rect x="280.88175" y="572.5193" width="166.5" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(285.88175 578.0193)" fill="black">
+            <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="52.482666" y="9">«InitModule»</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="11.570312" y="22">N4RequireAndDefine.js</tspan>
+          </text>
+        </g>
+        <g id="Group_606">
+          <g id="Line_608">
+            <path d="M 439.48234 576.4849 L 435.39834 576.4849 L 435.39834 586.5649 L 442.20534 586.5649 L 442.20534 579.8449 L 439.48234 576.4849" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Line_607">
+            <path d="M 439.48234 576.4849 L 439.48234 579.8449 L 442.20534 579.8449 L 442.20534 579.8449" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+        </g>
+      </g>
+      <g id="Group_611">
+        <g id="Graphic_615">
+          <rect x="280.88175" y="610.94594" width="166.5" height="36" fill="white"/>
+          <rect x="280.88175" y="610.94594" width="166.5" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(285.88175 616.44594)" fill="black">
+            <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="48.481445" y="9">«ExecModule»</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="38.22754" y="22">ScriptCaller.js</tspan>
+          </text>
+        </g>
+        <g id="Group_612">
+          <g id="Line_614">
+            <path d="M 439.48234 615.781 L 435.39834 615.781 L 435.39834 625.861 L 442.20534 625.861 L 442.20534 619.141 L 439.48234 615.781" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Line_613">
+            <path d="M 439.48234 615.781 L 439.48234 619.141 L 442.20534 619.141 L 442.20534 619.141" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+        </g>
+      </g>
+      <g id="Group_617">
+        <g id="Graphic_621">
+          <rect x="280.88175" y="662.7962" width="166.5" height="36" fill="white"/>
+          <rect x="280.88175" y="662.7962" width="166.5" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(285.88175 668.2962)" fill="black">
+            <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="52.482666" y="9">«InitModule»</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="32.570312" y="22">N4JSRuntime.js</tspan>
+          </text>
+        </g>
+        <g id="Group_618">
+          <g id="Line_620">
+            <path d="M 439.459 669.3778 L 435.375 669.3778 L 435.375 679.4578 L 442.182 679.4578 L 442.182 672.7378 L 439.459 669.3778" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Line_619">
+            <path d="M 439.459 669.3778 L 439.459 672.7378 L 442.182 672.7378" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+        </g>
+      </g>
+      <g id="Graphic_622">
+        <rect x="285.75" y="405.6258" width="99" height="36" fill="white"/>
+        <rect x="285.75" y="405.6258" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(290.75 411.1258)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="16.733154" y="9">«RuntimeLib»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="2.8339844" y="22">HTMLReporter</tspan>
+        </text>
+      </g>
+      <g id="Line_623">
+        <path d="M 233.63175 522.4198 L 233.63175 506.5198 L 335.25 506.5198 L 335.25 451.5258" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_624">
+        <path d="M 421.875 299.24803 L 421.875 336.14803 L 351.75 336.14803 L 351.75 395.7258" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_625">
+        <text transform="translate(394.3836 306.84992)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«use»</tspan>
+        </text>
+      </g>
+      <g id="Graphic_626">
+        <text transform="translate(184.03812 510.01736)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«provides»</tspan>
+        </text>
+      </g>
+      <g id="Line_627">
+        <path d="M 414.05746 457.5016 L 414.05746 423.6258 L 394.65 423.6258" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_629">
+        <text transform="translate(375.45633 444.0721)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«create»</tspan>
+        </text>
+      </g>
+    </g>
+  </g>
+</svg>
diff --git a/design/chapters/14_execution/images/runners-testers.svg b/design/chapters/14_execution/images/runners-testers.svg
new file mode 100644
index 0000000..304f56d
--- /dev/null
+++ b/design/chapters/14_execution/images/runners-testers.svg
@@ -0,0 +1,467 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xl="http://www.w3.org/1999/xlink" xmlns:dc="http://purl.org/dc/elements/1.1/" viewBox="0 0 1013 904" width="1013" height="904">
+  <defs>
+    <font-face font-family="Helvetica" font-size="8" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="12" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="532.22656" cap-height="719.7266" ascent="770.0195" descent="-229.98047" font-weight="700">
+      <font-face-src>
+        <font-face-name name="Helvetica-Bold"/>
+      </font-face-src>
+    </font-face>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="StickArrow_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -4 10 8" markerWidth="10" markerHeight="8" color="black">
+      <g>
+        <path d="M 8 0 L 0 0 M 0 -3 L 8 0 L 0 3" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="FilledDiamond_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-9 -4 10 8" markerWidth="10" markerHeight="8" color="black">
+      <g>
+        <path d="M -8 0 L -4 3 L 0 0 L -4 -3 Z" fill="currentColor" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="UMLInheritance_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -8 14 16" markerWidth="14" markerHeight="16" color="black">
+      <g>
+        <path d="M 12 0 L 0 -7 L 0 7 Z" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="StickArrow_Marker_2" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-9 -4 10 8" markerWidth="10" markerHeight="8" color="black">
+      <g>
+        <path d="M -8 0 L 0 0 M 0 3 L -8 0 L 0 -3" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <font-face font-family="Helvetica" font-size="10" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="12" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+  </defs>
+  <metadata> Produced by OmniGraffle 7.11 
+    <dc:date>2015-04-22 12:11:44 +0000</dc:date>
+  </metadata>
+  <g id="Canvas_1" stroke="none" stroke-opacity="1" stroke-dasharray="none" fill="none" fill-opacity="1">
+    <title>Canvas 1</title>
+    <rect fill="white" x="0" y="0" width="1013" height="904"/>
+    <g id="Canvas_1: Layer 1">
+      <title>Layer 1</title>
+      <g id="Graphic_164">
+        <rect x="458" y="239.02973" width="119" height="45" fill="#c3fdd2"/>
+        <rect x="458" y="239.02973" width="119" height="45" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(463 249.52973)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="21.15625" y="8">«SystemmLibrary»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="22.833008" y="21">Mangelhaft</tspan>
+        </text>
+      </g>
+      <g id="Graphic_166">
+        <rect x="458.5" y="319.7984" width="119" height="45" fill="#c3fdd2"/>
+        <rect x="458.5" y="319.7984" width="119" height="45" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(463.5 330.2984)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="22.929688" y="8">«RuntimeLibrary»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="1.8330078" y="21">MangelhaftRunner</tspan>
+        </text>
+      </g>
+      <g id="Graphic_163">
+        <rect x="468" y="110.23767" width="99" height="36" fill="#b8f2ff"/>
+        <rect x="468" y="110.23767" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(473 121.23767)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="24.15918" y="11">Project</tspan>
+        </text>
+      </g>
+      <g id="Graphic_168">
+        <rect x="458.5" y="451.7984" width="118" height="45" fill="#c3fdd2"/>
+        <rect x="458.5" y="451.7984" width="118" height="45" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(463.5 462.2984)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="22.429688" y="8">«RuntimeLibrary»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="1.9892578" y="21">Console_Reporter</tspan>
+        </text>
+      </g>
+      <g id="Graphic_169">
+        <rect x="585.5" y="417.7984" width="102" height="45" fill="#c3fdd2"/>
+        <rect x="585.5" y="417.7984" width="102" height="45" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(590.5 428.2984)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="14.429688" y="8">«RuntimeLibrary»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="1.993164" y="21">HTTP_Reporter</tspan>
+        </text>
+      </g>
+      <g id="Graphic_170">
+        <rect x="347.5" y="417.7984" width="102" height="45" fill="#c3fdd2"/>
+        <rect x="347.5" y="417.7984" width="102" height="45" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(352.5 428.2984)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="14.429688" y="8">«RuntimeLibrary»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x=".9970703" y="21">HTML_Reporter</tspan>
+        </text>
+      </g>
+      <g id="Graphic_171">
+        <rect x="266.5" y="650.6217" width="156" height="45" fill="#c3fdd2"/>
+        <rect x="266.5" y="650.6217" width="156" height="45" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(271.5 661.1217)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="31.201172" y="8">«RuntimeEnvironemnt»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="25.436523" y="21">Web_Mangelhaft</tspan>
+        </text>
+      </g>
+      <g id="Graphic_172">
+        <rect x="613.5" y="650.6217" width="156" height="45" fill="#c3fdd2"/>
+        <rect x="613.5" y="650.6217" width="156" height="45" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(618.5 661.1217)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="31.201172" y="8">«RuntimeEnvironemnt»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="15.657227" y="21">NodeJS_Mangelhaft</tspan>
+        </text>
+      </g>
+      <g id="Graphic_376">
+        <rect x="440.9314" y="854.1617" width="156" height="45" fill="white"/>
+        <rect x="440.9314" y="854.1617" width="156" height="45" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(445.9314 864.6617)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="31.201172" y="8">«RuntimeEnvironemnt»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="61.65918" y="21">ES5</tspan>
+        </text>
+      </g>
+      <g id="Line_621">
+        <line x1="517.5" y1="206.40263" x2="517.5" y2="229.12973" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_623">
+        <line x1="517.5" y1="284.02973" x2="517.8616" y2="309.89937" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_626">
+        <path d="M 557.66667 364.7984 L 557.66667 391.6984 L 636.5 391.6984 L 636.5 407.8984" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_628">
+        <path d="M 478.33333 364.7984 L 478.33333 391.6984 L 398.5 391.6984 L 398.5 407.8984" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_629">
+        <path d="M 518 364.7984 L 518 376.6984 L 517.5 439.8984 L 517.5 441.8984" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_668">
+        <path d="M 691.5 650.1217 L 691.5 349.7984 L 587.4 349.7984" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_683">
+        <path d="M 344.5 650.1217 L 344.5 349.7984 L 448.6 349.7984" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_633">
+        <rect x="852" y="319.7984" width="156" height="45" fill="#b8f2ff"/>
+        <rect x="852" y="319.7984" width="156" height="45" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(857 330.2984)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="31.201172" y="8">«RuntimeEnvironemnt»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="21.99121" y="21">N4JSNodeRunner</tspan>
+        </text>
+      </g>
+      <g id="Line_639">
+        <path d="M 930 319.7984 L 930 18.637563 L 518 18.637563 L 518 20.637563" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_641">
+        <rect x="755" y="800.8717" width="156" height="45" fill="white"/>
+        <rect x="755" y="800.8717" width="156" height="45" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(760 811.3717)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="31.201172" y="8">«RuntimeEnvironemnt»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="50.66113" y="21">NodeJS</tspan>
+        </text>
+      </g>
+      <g id="Line_642">
+        <line x1="833" y1="791.6217" x2="833" y2="773.7717" marker-end="url(#StickArrow_Marker)" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_643">
+        <path d="M 691.5 695.6217 L 691.5 823.3717 L 741.5 823.3717" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_644">
+        <path d="M 930 364.7984 L 930 823.3717 L 924.5 823.3717" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_645">
+        <path d="M 833 845.8717 L 833 876.6617 L 610.4314 876.6617" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_646">
+        <path d="M 570.9314 844.9117 L 570.9314 832.2617 L 605.52894 832.2617 L 605.52894 821.0617" marker-end="url(#StickArrow_Marker)" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_647">
+        <path d="M 466.9314 844.9117 L 466.9314 832.2617 L 430.47106 832.2617 L 430.47106 821.0617" marker-end="url(#StickArrow_Marker)" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_648">
+        <rect x="6" y="319.7984" width="156" height="45" fill="#b8f2ff"/>
+        <rect x="6" y="319.7984" width="156" height="45" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(11 330.2984)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="31.201172" y="8">«RuntimeEnvironemnt»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="24.43164" y="21">N4JSWebRunner</tspan>
+        </text>
+      </g>
+      <g id="Graphic_649">
+        <rect x="104" y="800.8717" width="156" height="45" fill="white"/>
+        <rect x="104" y="800.8717" width="156" height="45" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(109 811.3717)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="31.201172" y="8">«RuntimeEnvironemnt»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="60.44043" y="21">Web</tspan>
+        </text>
+      </g>
+      <g id="Line_650">
+        <path d="M 84 364.7984 L 84 823.3717 L 90.5 823.3717" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_651">
+        <path d="M 344.5 695.6217 L 344.5 823.3717 L 273.5 823.3717" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_657">
+        <path d="M 84 319.7984 L 84 18.637563 L 518 18.637563 L 518 20.637563" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_658">
+        <path d="M 518 85.43756 L 518 87.43756 L 517.5 98.33767 L 517.5 110.23767" marker-start="url(#StickArrow_Marker_2)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_659">
+        <line x1="182" y1="791.6217" x2="182" y2="773.7717" marker-end="url(#StickArrow_Marker)" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_660">
+        <path d="M 182 845.8717 L 182 876.6617 L 427.4314 876.6617" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_146">
+        <line x1="691.5" y1="650.6217" x2="524.9172" y2="503.3555" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_212">
+        <text transform="translate(624.16066 638.3266)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«provide»</tspan>
+        </text>
+      </g>
+      <g id="Line_669">
+        <line x1="691.5" y1="650.6217" x2="639.2822" y2="472.2994" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_674">
+        <line x1="344.5" y1="650.6217" x2="510.1016" y2="503.3767" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_675">
+        <text transform="translate(365.2897 637.4551)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«provide»</tspan>
+        </text>
+      </g>
+      <g id="Line_676">
+        <line x1="344.5" y1="650.6217" x2="628.17375" y2="468.1541" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_677">
+        <line x1="344.5" y1="650.6217" x2="395.7645" y2="472.313" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_678">
+        <rect x="468" y="169.90263" width="99" height="36" fill="#c3fdd2"/>
+        <rect x="468" y="169.90263" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(473 180.90263)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="12.264648" y="11">TestProject</tspan>
+        </text>
+      </g>
+      <g id="Line_679">
+        <line x1="517.5" y1="169.90263" x2="517.5" y2="156.13767" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_684">
+        <text transform="translate(464.8077 155.38804)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«depends»</tspan>
+        </text>
+      </g>
+      <g id="Graphic_685">
+        <text transform="translate(463.26923 214.57366)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«depends»</tspan>
+        </text>
+      </g>
+      <g id="Graphic_686">
+        <text transform="translate(461.39867 293.01803)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«requires»</tspan>
+        </text>
+      </g>
+      <g id="Group_696">
+        <g id="Graphic_700">
+          <rect x="536.77894" y="766.1617" width="137.5" height="45" fill="white"/>
+          <rect x="536.77894" y="766.1617" width="137.5" height="45" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(541.77894 776.6617)" fill="black">
+            <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="41.06836" y="8">«initModule»</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="17.739258" y="21">N4JS_bootstrap</tspan>
+          </text>
+        </g>
+        <g id="Group_697">
+          <g id="Line_699">
+            <path d="M 667.36294 770.6617 L 663.27894 770.6617 L 663.27894 780.7417 L 670.08594 780.7417 L 670.08594 774.0217 L 667.36294 770.6617" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Line_698">
+            <path d="M 667.36294 770.6617 L 667.36294 774.0217 L 670.08594 774.0217 L 670.08594 774.0217" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+        </g>
+      </g>
+      <g id="Group_701">
+        <g id="Graphic_705">
+          <rect x="361.72106" y="766.1617" width="137.5" height="45" fill="white"/>
+          <rect x="361.72106" y="766.1617" width="137.5" height="45" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(366.72106 776.6617)" fill="black">
+            <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="41.06836" y="8">«initModule»</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="1.3886719" y="21">N4JS_builtIn_Classes</tspan>
+          </text>
+        </g>
+        <g id="Group_702">
+          <g id="Line_704">
+            <path d="M 491.80506 770.1617 L 487.72106 770.1617 L 487.72106 780.2417 L 494.52806 780.2417 L 494.52806 773.5217 L 491.80506 770.1617" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Line_703">
+            <path d="M 491.80506 770.1617 L 491.80506 773.5217 L 494.52806 773.5217 L 494.52806 773.5217" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+        </g>
+      </g>
+      <g id="Group_706">
+        <g id="Graphic_710">
+          <rect x="758.5" y="718.8717" width="149" height="45" fill="white"/>
+          <rect x="758.5" y="718.8717" width="149" height="45" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(763.5 729.3717)" fill="black">
+            <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="46.81836" y="8">«initModule»</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="13.824219" y="21">NodeRequireDefine</tspan>
+          </text>
+        </g>
+        <g id="Group_707">
+          <g id="Line_709">
+            <path d="M 900.084 722.6217 L 896 722.6217 L 896 732.7017 L 902.807 732.7017 L 902.807 725.9817 L 900.084 722.6217" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Line_708">
+            <path d="M 900.084 722.6217 L 900.084 725.9817 L 902.807 725.9817 L 902.807 725.9817" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+        </g>
+      </g>
+      <g id="Group_711">
+        <g id="Graphic_715">
+          <rect x="107.5" y="718.8717" width="149" height="45" fill="white"/>
+          <rect x="107.5" y="718.8717" width="149" height="45" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(112.5 729.3717)" fill="black">
+            <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="46.81836" y="8">«initModule»</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="16.264648" y="21">WebRequireDefine</tspan>
+          </text>
+        </g>
+        <g id="Group_712">
+          <g id="Line_714">
+            <path d="M 250.084 722.3717 L 246 722.3717 L 246 732.4517 L 252.807 732.4517 L 252.807 725.7317 L 250.084 722.3717" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Line_713">
+            <path d="M 250.084 722.3717 L 250.084 725.7317 L 252.807 725.7317 L 252.807 725.7317" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+        </g>
+      </g>
+      <g id="Graphic_731">
+        <rect x="459" y="30.537563" width="118" height="45" fill="#b8f2ff"/>
+        <path d="M 459 30.537563 L 577 30.537563 L 577 75.53756 L 459 75.53756 Z" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="8.0,5.0" stroke-width="1"/>
+        <text transform="translate(464 41.037563)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="22.429688" y="8">«RuntimeLibrary»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="19.655273" y="21">n4js_runner</tspan>
+        </text>
+      </g>
+      <g id="Graphic_737">
+        <text transform="translate(479.89535 370.60976)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«create»</tspan>
+        </text>
+      </g>
+      <g id="Graphic_738">
+        <text transform="translate(517.10465 370.58166)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«create»</tspan>
+        </text>
+      </g>
+      <g id="Graphic_739">
+        <text transform="translate(465.9651 87.16232)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«depends»</tspan>
+        </text>
+      </g>
+      <g id="Graphic_148">
+        <path d="M 840.5 109.62447 C 840.5 104.69851 838.14415 104.08907 820.9353 99.21407 L 820.7535 99.16363 C 803.4538 94.23767 803.2739 94.23767 785.5197 94.23767 C 761.8795 94.23767 655 94.23767 655 94.23767 L 655 146.23767 L 840.5 146.23767 L 840.5 109.62447 Z" fill="white"/>
+        <path d="M 840.5 109.62447 C 840.5 104.69851 838.14415 104.08907 820.9353 99.21407 L 820.7535 99.16363 C 803.4538 94.23767 803.2739 94.23767 785.5197 94.23767 C 761.8795 94.23767 655 94.23767 655 94.23767 L 655 146.23767 L 840.5 146.23767 L 840.5 109.62447 Z M 840.5 109.37071 C 840.5 104.69851 840.3182 104.69851 803.2739 104.69851 L 803.2739 104.69851 C 803.2739 94.28863 803.2739 94.23767 786.6067 94.23767" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(660 106.23767)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="5.698242" y="11">at the moment part of the node </tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="70.40625" y="25">runner</tspan>
+        </text>
+      </g>
+      <g id="Line_188">
+        <line x1="577" y1="68.03756" x2="662.2241" y2="94.09149" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_740">
+        <path d="M 557.66667 319.7984 L 557.66667 300.8984 L 588.9 300.8984 L 588.9 261.52973 L 586.9 261.52973" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_741">
+        <text transform="translate(590.5 279)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«create»</tspan>
+        </text>
+      </g>
+      <g id="Group_747">
+        <g id="Graphic_751">
+          <rect x="709" y="251" width="149" height="45" fill="#b8f2ff"/>
+          <rect x="709" y="251" width="149" height="45" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(714 261.5)" fill="black">
+            <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="43.48242" y="8">«execModule»</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="17.486328" y="21">n4js_node_runner</tspan>
+          </text>
+        </g>
+        <g id="Group_748">
+          <g id="Line_750">
+            <path d="M 850.584 254.75 L 846.5 254.75 L 846.5 264.83 L 853.307 264.83 L 853.307 258.11 L 850.584 254.75" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Line_749">
+            <path d="M 850.584 254.75 L 850.584 258.11 L 853.307 258.11 L 853.307 258.11" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+        </g>
+      </g>
+      <g id="Group_752">
+        <g id="Graphic_756">
+          <rect x="177" y="251" width="149" height="45" fill="#b8f2ff"/>
+          <rect x="177" y="251" width="149" height="45" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(182 261.5)" fill="black">
+            <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="43.48242" y="8">«execModule»</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="20.149414" y="21">n4js_web_runner</tspan>
+          </text>
+        </g>
+        <g id="Group_753">
+          <g id="Line_755">
+            <path d="M 318.584 254.75 L 314.5 254.75 L 314.5 264.83 L 321.307 264.83 L 321.307 258.11 L 318.584 254.75" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Line_754">
+            <path d="M 318.584 254.75 L 318.584 258.11 L 321.307 258.11 L 321.307 258.11" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+        </g>
+      </g>
+      <g id="Line_757">
+        <line x1="170.21581" y1="338.04835" x2="242.70686" y2="300.5487" marker-end="url(#StickArrow_Marker)" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_758">
+        <line x1="844.3363" y1="337.1186" x2="791.7022" y2="301.5438" marker-end="url(#StickArrow_Marker)" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Group_759">
+        <g id="Graphic_763">
+          <rect x="733" y="551" width="168" height="45" fill="#c3fdd2"/>
+          <rect x="733" y="551" width="168" height="45" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(738 561.5)" fill="black">
+            <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="52.98242" y="8">«execModule»</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="6.988281" y="21">mangelhaft_node_runner</tspan>
+          </text>
+        </g>
+        <g id="Group_760">
+          <g id="Line_762">
+            <path d="M 892.6383 554.75 L 888.0336 554.75 L 888.0336 564.83 L 895.7086 564.83 L 895.7086 558.11 L 892.6383 554.75" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Line_761">
+            <path d="M 892.6383 554.75 L 892.6383 558.11 L 895.7086 558.11 L 895.7086 558.11" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+        </g>
+      </g>
+      <g id="Line_764">
+        <line x1="774.3509" y1="665.2457" x2="811.8082" y2="604.42944" marker-end="url(#StickArrow_Marker)" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Group_765">
+        <g id="Graphic_769">
+          <rect x="132" y="551" width="149" height="45" fill="#c3fdd2"/>
+          <rect x="132" y="551" width="149" height="45" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(137 561.5)" fill="black">
+            <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="43.48242" y="8">«execModule»</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x=".15136719" y="21">mangelhaft_web_runner</tspan>
+          </text>
+        </g>
+        <g id="Group_766">
+          <g id="Line_768">
+            <path d="M 273.584 554.75 L 269.5 554.75 L 269.5 564.83 L 276.307 564.83 L 276.307 558.11 L 273.584 554.75" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Line_767">
+            <path d="M 273.584 554.75 L 273.584 558.11 L 276.307 558.11 L 276.307 558.11" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+        </g>
+      </g>
+      <g id="Line_770">
+        <line x1="260.82008" y1="665.821" x2="212.57905" y2="603.8138" marker-end="url(#StickArrow_Marker)" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+    </g>
+  </g>
+</svg>
diff --git a/design/chapters/15_tests/images/cd_performancetest_configAnRun.svg b/design/chapters/15_tests/images/cd_performancetest_configAnRun.svg
new file mode 100644
index 0000000..82ec43b
--- /dev/null
+++ b/design/chapters/15_tests/images/cd_performancetest_configAnRun.svg
@@ -0,0 +1,435 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xl="http://www.w3.org/1999/xlink" xmlns:dc="http://purl.org/dc/elements/1.1/" viewBox="23 24.131424 882.5 459.3686" width="882.5" height="459.3686">
+  <defs>
+    <font-face font-family="Arial" font-size="12" panose-1="2 11 6 4 2 2 2 2 2 4" units-per-em="1000" underline-position="-105.95703" underline-thickness="73.24219" slope="0" x-height="518.5547" cap-height="716.3086" ascent="905.2734" descent="-211.91406" font-weight="400">
+      <font-face-src>
+        <font-face-name name="ArialMT"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Arial" font-size="13" panose-1="2 11 7 4 2 2 2 2 2 4" units-per-em="1000" underline-position="-105.95703" underline-thickness="104.98047" slope="0" x-height="518.5547" cap-height="715.8203" ascent="905.2734" descent="-211.91406" font-weight="700">
+      <font-face-src>
+        <font-face-name name="Arial-BoldMT"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Arial" font-size="10" panose-1="2 11 6 4 2 2 2 2 2 4" units-per-em="1000" underline-position="-105.95703" underline-thickness="73.24219" slope="0" x-height="518.5547" cap-height="716.3086" ascent="905.2734" descent="-211.91406" font-weight="400">
+      <font-face-src>
+        <font-face-name name="ArialMT"/>
+      </font-face-src>
+    </font-face>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="StickArrow_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -4 10 8" markerWidth="10" markerHeight="8" color="black">
+      <g>
+        <path d="M 8 0 L 0 0 M 0 -3 L 8 0 L 0 3" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <font-face font-family="Arial" font-size="9" panose-1="2 11 6 4 2 2 2 2 2 4" units-per-em="1000" underline-position="-105.95703" underline-thickness="73.24219" slope="0" x-height="518.5547" cap-height="716.3086" ascent="905.2734" descent="-211.91406" font-weight="400">
+      <font-face-src>
+        <font-face-name name="ArialMT"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Arial" font-size="8" panose-1="2 11 6 4 2 2 2 2 2 4" units-per-em="1000" underline-position="-105.95703" underline-thickness="73.24219" slope="0" x-height="518.5547" cap-height="716.3086" ascent="905.2734" descent="-211.91406" font-weight="400">
+      <font-face-src>
+        <font-face-name name="ArialMT"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Arial" font-size="12" panose-1="2 11 7 4 2 2 2 2 2 4" units-per-em="1000" underline-position="-105.95703" underline-thickness="104.98047" slope="0" x-height="518.5547" cap-height="715.8203" ascent="905.2734" descent="-211.91406" font-weight="700">
+      <font-face-src>
+        <font-face-name name="Arial-BoldMT"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Arial" font-size="11" panose-1="2 11 6 4 2 2 2 2 2 4" units-per-em="1000" underline-position="-105.95703" underline-thickness="73.24219" slope="0" x-height="518.5547" cap-height="716.3086" ascent="905.2734" descent="-211.91406" font-weight="400">
+      <font-face-src>
+        <font-face-name name="ArialMT"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Arial" font-size="12" panose-1="2 11 7 4 2 2 2 9 2 4" units-per-em="1000" underline-position="-105.95703" underline-thickness="104.98047" slope="-1e3" x-height="518.5547" cap-height="715.332" ascent="905.2734" descent="-211.91406" font-style="italic" font-weight="700">
+      <font-face-src>
+        <font-face-name name="Arial-BoldItalicMT"/>
+      </font-face-src>
+    </font-face>
+  </defs>
+  <metadata> Produced by OmniGraffle 7.11 
+    <dc:date>2013-08-06 09:17:29 +0000</dc:date>
+  </metadata>
+  <g id="Canvas_1" stroke="none" stroke-opacity="1" stroke-dasharray="none" fill="none" fill-opacity="1">
+    <title>Canvas 1</title>
+    <rect fill="white" x="23" y="24.131424" width="882.5" height="459.3686"/>
+    <g id="Canvas_1: Layer 1">
+      <title>Layer 1</title>
+      <g id="Graphic_213">
+        <path d="M 224.61456 421.0392 C 224.61456 412.70296 222.0604 411.6716 203.403 403.4216 L 203.20592 403.33624 C 184.44998 395 184.2549 395 165.00622 395 C 139.37618 395 23.5 395 23.5 395 L 23.5 483 L 224.61456 483 L 224.61456 421.0392 Z" fill="white"/>
+        <path d="M 224.61456 421.0392 C 224.61456 412.70296 222.0604 411.6716 203.403 403.4216 L 203.20592 403.33624 C 184.44998 395 184.2549 395 165.00622 395 C 139.37618 395 23.5 395 23.5 395 L 23.5 483 L 224.61456 483 L 224.61456 421.0392 Z M 224.61456 420.60976 C 224.61456 412.70296 224.41747 412.70296 184.2549 412.70296 L 184.2549 412.70296 C 184.2549 395.08624 184.2549 395 166.18475 395" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(28.5 400)" fill="black">
+          <tspan font-family="Arial" font-size="12" font-weight="400" fill="black" x="0" y="11">package</tspan>
+          <tspan font-family="Arial" font-size="13" font-weight="700" fill="black" x="0" y="26.392578">n4js.performance</tspan>
+          <tspan font-family="Arial" font-size="10" font-weight="400" fill="black" x="0" y="38.81787">Scopes shown: package, protected, public, </tspan>
+          <tspan font-family="Arial" font-size="10" font-weight="400" fill="black" x="0" y="50.14502">Omitted methods: getter and setter, </tspan>
+          <tspan font-family="Arial" font-size="10" font-weight="400" fill="black" x="0" y="61.47217">overriding methods, </tspan>
+          <tspan font-family="Arial" font-size="10" font-weight="400" fill="black" x="0" y="72.79932">created on Aug 6, 2013</tspan>
+        </text>
+      </g>
+      <g id="Line_203">
+        <path d="M 663 391.3166 L 711 363.4529 L 761 223.45288 L 791.1833 219.51293" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_191">
+        <line x1="696" y1="245.9722" x2="820.4962" y2="332.7725" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_190">
+        <line x1="696" y1="210.1969" x2="791.5507" y2="240.05955" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_189">
+        <line x1="696" y1="228.08454" x2="810.4906" y2="285.88766" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_188">
+        <line x1="696" y1="192.4076" x2="791.172" y2="203.94713" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_187">
+        <line x1="696" y1="174.6183" x2="791.1242" y2="167.95643" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_186">
+        <line x1="696" y1="139.03972" x2="806.4199" y2="89.06378" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_185">
+        <line x1="696" y1="156.82902" x2="791.4216" y2="131.8938" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_177">
+        <line x1="293.5" y1="124.32628" x2="147.97538" y2="80.27425" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_176">
+        <line x1="293.5" y1="156.80127" x2="179.18396" y2="186.20353" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_172">
+        <line x1="293.5" y1="134.08561" x2="148.31172" y2="114.56539" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_168">
+        <line x1="597.079" y1="378" x2="597.9955" y2="347.52695" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_167">
+        <text transform="translate(570.342 350.5752)" fill="black">
+          <tspan font-family="Arial" font-size="12" font-weight="400" fill="black" x="0" y="11">#config</tspan>
+        </text>
+      </g>
+      <g id="Graphic_166"/>
+      <g id="Line_165">
+        <line x1="281.2027" y1="305.64865" x2="281.2027" y2="363.00576" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_164">
+        <text transform="translate(246.18317 332.2772)" fill="black">
+          <tspan font-family="Arial" font-size="12" font-weight="400" fill="black" x="0" y="11">#measurements</tspan>
+        </text>
+      </g>
+      <g id="Graphic_163">
+        <text transform="translate(287.45148 360.68005)" fill="black">
+          <tspan font-family="Arial" font-size="9" font-weight="400" fill="black" x="0" y="8">*</tspan>
+        </text>
+      </g>
+      <g id="Line_162">
+        <line x1="293.5" y1="144.43976" x2="161.11513" y2="150.27426" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_161">
+        <text transform="translate(169.64197 132.58272)" fill="black">
+          <tspan font-family="Arial" font-size="12" font-weight="400" fill="black" x="0" y="11">-jobChangeListener</tspan>
+        </text>
+      </g>
+      <g id="Graphic_160"/>
+      <g id="Line_159">
+        <line x1="293.5" y1="177.00154" x2="193.46863" y2="237.56875" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_158">
+        <text transform="translate(196.74808 196.0056)" fill="black">
+          <tspan font-family="Arial" font-size="12" font-weight="400" fill="black" x="0" y="11">#buildStrategy</tspan>
+        </text>
+      </g>
+      <g id="Graphic_157"/>
+      <g id="Line_156">
+        <line x1="319.7825" y1="200.88358" x2="303.63065" y2="230.9288" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_155">
+        <text transform="translate(287.3076 209.4781)" fill="black">
+          <tspan font-family="Arial" font-size="12" font-weight="400" fill="black" x="0" y="11">#pmp</tspan>
+        </text>
+      </g>
+      <g id="Graphic_154"/>
+      <g id="Group_147">
+        <g id="Graphic_150">
+          <rect x="372" y="291.64865" width="121" height="14" fill="white"/>
+          <rect x="372" y="291.64865" width="121" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_149">
+          <rect x="372" y="277.64865" width="121" height="14" fill="white"/>
+          <rect x="372" y="277.64865" width="121" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_148">
+          <rect x="372" y="243.64865" width="121" height="34" fill="white"/>
+          <rect x="372" y="243.64865" width="121" height="34" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(377.36133 248.64865)" fill="black">
+            <tspan font-family="Arial" font-size="8" font-weight="400" fill="black" x="0" y="7">PerformanceTestConfiguration.</tspan>
+            <tspan font-family="Arial" font-size="12" font-weight="700" fill="black" x="30.464844" y="20.261719">Property</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_139">
+        <g id="Graphic_140">
+          <rect x="23.5" y="38" width="115" height="44" fill="white"/>
+          <rect x="23.5" y="38" width="115" height="44" stroke="silver" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(28.753906 43)" fill="silver">
+            <tspan font-family="Arial" font-size="8" font-weight="400" fill="silver" x="32.45508" y="7">«interface»</tspan>
+            <tspan font-family="Arial" font-size="8" font-weight="400" fill="silver" x="0" y="16.261719">org.eclipse.core.runtime.jobs.</tspan>
+            <tspan font-family="Arial" font-size="12" font-weight="700" fill="silver" x="15.238281" y="29.523438">IJobManager</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_128">
+        <g id="Graphic_131">
+          <rect x="237.2027" y="420.90576" width="88" height="28" fill="white"/>
+          <rect x="237.2027" y="420.90576" width="88" height="28" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(242.2027 421.90576)" fill="black">
+            <tspan font-family="Arial" font-size="11" font-weight="400" fill="black" x="0" y="10">+diff(..)</tspan>
+            <tspan font-family="Arial" font-size="11" font-weight="400" fill="black" x="0" y="22.359863">+toCSV()</tspan>
+          </text>
+        </g>
+        <g id="Graphic_130">
+          <rect x="237.2027" y="406.90576" width="88" height="14" fill="white"/>
+          <rect x="237.2027" y="406.90576" width="88" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_129">
+          <rect x="237.2027" y="372.90576" width="88" height="34" fill="white"/>
+          <rect x="237.2027" y="372.90576" width="88" height="34" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(242.52203 377.90576)" fill="black">
+            <tspan font-family="Arial" font-size="8" font-weight="400" fill="black" x="6.8896484" y="7">PoorMansProfiler.</tspan>
+            <tspan font-family="Arial" font-size="12" font-weight="700" fill="black" x="0" y="20.261719">Measurement</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_108">
+        <g id="Graphic_109">
+          <rect x="801" y="50.98169" width="104" height="34" fill="white"/>
+          <rect x="801" y="50.98169" width="104" height="34" stroke="silver" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(806.3125 55.98169)" fill="silver">
+            <tspan font-family="Arial" font-size="8" font-weight="400" fill="silver" x="0" y="7">generators.TestDescriptor.</tspan>
+            <tspan font-family="Arial" font-size="12" font-weight="700" fill="silver" x="12.673828" y="20.261719">ClusterDscr</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_100">
+        <g id="Graphic_103">
+          <rect x="528" y="416" width="135" height="67" fill="white"/>
+          <rect x="528" y="416" width="135" height="67" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(533 417)" fill="black">
+            <tspan font-family="Arial" font-size="11" font-weight="400" fill="black" x="0" y="10">#getWorkspaceRoot()</tspan>
+            <tspan font-family="Arial" font-size="11" font-weight="400" fill="black" x="0" y="22.359863">+findAllProblems()</tspan>
+            <tspan font-family="Arial" font-size="11" font-weight="400" fill="black" x="0" y="34.719727">#findProblems(..)</tspan>
+            <tspan font-family="Arial" font-size="11" font-weight="400" fill="black" x="0" y="47.07959">+compare(..)</tspan>
+            <tspan font-family="Arial" font-size="11" font-weight="400" fill="black" x="0" y="59.43945">+createProblemReport(..)</tspan>
+          </text>
+        </g>
+        <g id="Graphic_102">
+          <rect x="528" y="402" width="135" height="14" fill="white"/>
+          <rect x="528" y="402" width="135" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_101">
+          <rect x="528" y="378" width="135" height="24" fill="white"/>
+          <rect x="528" y="378" width="135" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(533 383)" fill="black">
+            <tspan font-family="Arial" font-size="12" font-weight="700" fill="black" x="22.489258" y="11">ProblemMeter</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_93">
+        <g id="Graphic_96">
+          <rect x="510" y="62.631424" width="186" height="275" fill="white"/>
+          <rect x="510" y="62.631424" width="186" height="275" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(515 63.631424)" fill="black">
+            <tspan font-family="Arial" font-size="11" font-weight="400" fill="black" x="0" y="10">+getTotalNumberOfPackages()</tspan>
+            <tspan font-family="Arial" font-size="11" font-weight="400" fill="black" x="0" y="22.359863">+getTotalNumberOfClasses()</tspan>
+            <tspan font-family="Arial" font-size="11" font-weight="400" fill="black" x="0" y="34.719727">+getTotalNumberOfFields()</tspan>
+            <tspan font-family="Arial" font-size="11" font-weight="400" fill="black" x="0" y="47.07959">+getTotalNumberOfMethods()</tspan>
+            <tspan font-family="Arial" font-size="11" font-weight="400" fill="black" x="0" y="59.43945">+entrySet()</tspan>
+            <tspan font-family="Arial" font-size="11" font-weight="400" fill="black" x="0" y="71.79932">+get(..)</tspan>
+            <tspan font-family="Arial" font-size="11" font-weight="400" fill="black" x="0" y="84.15918">+set(..)</tspan>
+            <tspan font-family="Arial" font-size="11" font-weight="400" fill="black" x="0" y="96.51904">+getAbsolutePackageNo(..)</tspan>
+            <tspan font-family="Arial" font-size="11" font-weight="400" fill="black" x="0" y="108.8789">+getAbsoluteClassNo(..)</tspan>
+            <tspan font-family="Arial" font-size="11" font-weight="400" fill="black" x="0" y="121.23877">+getClassDescrFromAbsolute(..)</tspan>
+            <tspan font-family="Arial" font-size="11" font-weight="400" fill="black" x="0" y="133.59863">+getAbsoluteFieldNo(..)</tspan>
+            <tspan font-family="Arial" font-size="11" font-weight="400" fill="black" x="0" y="145.9585">+getAbsoluteMethodNo(..)</tspan>
+            <tspan font-family="Arial" font-size="11" font-weight="400" fill="black" x="0" y="158.31836">+projectName(..)</tspan>
+            <tspan font-family="Arial" font-size="11" font-weight="400" fill="black" x="0" y="170.67822">+packageName(..)</tspan>
+            <tspan font-family="Arial" font-size="11" font-weight="400" fill="black" x="0" y="183.03809">+className(..)</tspan>
+            <tspan font-family="Arial" font-size="11" font-weight="400" fill="black" x="0" y="195.39795">+classFQN(..)</tspan>
+            <tspan font-family="Arial" font-size="11" font-weight="400" fill="black" x="0" y="207.75781">+classFQNReqVar(..)</tspan>
+            <tspan font-family="Arial" font-size="11" font-weight="400" fill="black" x="0" y="220.11768">+fieldName(..)</tspan>
+            <tspan font-family="Arial" font-size="11" font-weight="400" fill="black" x="0" y="232.47754">+methodName(..)</tspan>
+            <tspan font-family="Arial" font-size="11" font-weight="400" fill="black" x="0" y="244.8374">+parseFQClassName(..)</tspan>
+            <tspan font-family="Arial" font-size="11" font-weight="400" fill="black" x="0" y="257.19727">+fromString(..)</tspan>
+          </text>
+        </g>
+        <g id="Graphic_95">
+          <rect x="510" y="48.631424" width="186" height="14" fill="white"/>
+          <rect x="510" y="48.631424" width="186" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_94">
+          <rect x="510" y="24.631424" width="186" height="24" fill="white"/>
+          <rect x="510" y="24.631424" width="186" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(515.1006 29.631424)" fill="black">
+            <tspan font-family="Arial" font-size="12" font-weight="700" fill="black" x="0" y="11">PerformanceTestConfiguration</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_85">
+        <g id="Graphic_86">
+          <rect x="801" y="146.62305" width="104" height="34" fill="white"/>
+          <rect x="801" y="146.62305" width="104" height="34" stroke="silver" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(806.3125 151.62305)" fill="silver">
+            <tspan font-family="Arial" font-size="8" font-weight="400" fill="silver" x="0" y="7">generators.TestDescriptor.</tspan>
+            <tspan font-family="Arial" font-size="12" font-weight="700" fill="silver" x="8.994141" y="20.261719">PackageDscr</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_76">
+        <g id="Graphic_77">
+          <rect x="801" y="290.3495" width="104" height="34" fill="white"/>
+          <rect x="801" y="290.3495" width="104" height="34" stroke="silver" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(806.3125 295.3495)" fill="silver">
+            <tspan font-family="Arial" font-size="8" font-weight="400" fill="silver" x="0" y="7">generators.TestDescriptor.</tspan>
+            <tspan font-family="Arial" font-size="12" font-weight="700" fill="silver" x="19.344727" y="20.261719">FieldDscr</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_65">
+        <g id="Graphic_68">
+          <rect x="225.7027" y="277.64865" width="111" height="28" fill="white"/>
+          <rect x="225.7027" y="277.64865" width="111" height="28" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(230.7027 278.64865)" fill="black">
+            <tspan font-family="Arial" font-size="11" font-weight="400" fill="black" x="0" y="10">+measure()</tspan>
+            <tspan font-family="Arial" font-size="11" font-weight="400" fill="black" x="0" y="22.359863">+measure(..)</tspan>
+          </text>
+        </g>
+        <g id="Graphic_67">
+          <rect x="225.7027" y="263.64865" width="111" height="14" fill="white"/>
+          <rect x="225.7027" y="263.64865" width="111" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_66">
+          <rect x="225.7027" y="239.64865" width="111" height="24" fill="white"/>
+          <rect x="225.7027" y="239.64865" width="111" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(231.19293 244.64865)" fill="black">
+            <tspan font-family="Arial" font-size="12" font-weight="700" fill="black" x="0" y="11">PoorMansProfiler</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_58">
+        <g id="Graphic_61">
+          <rect x="293.5" y="120.88358" width="116" height="80" fill="white"/>
+          <rect x="293.5" y="120.88358" width="116" height="80" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(298.5 121.88358)" fill="black">
+            <tspan font-family="Arial" font-size="11" font-weight="400" fill="black" x="0" y="10">+scheduled(..)</tspan>
+            <tspan font-family="Arial" font-size="11" font-weight="400" fill="black" x="0" y="22.359863">+done(..)</tspan>
+            <tspan font-family="Arial" font-size="11" font-weight="400" fill="black" x="0" y="34.719727">+aboutToRun(..)</tspan>
+            <tspan font-family="Arial" font-size="11" font-weight="400" fill="black" x="0" y="47.07959">#isPrinted(..)</tspan>
+            <tspan font-family="Arial" font-size="11" font-weight="400" fill="black" x="0" y="59.43945">+waitForIdle()</tspan>
+            <tspan font-family="Arial" font-size="11" font-weight="400" fill="black" x="0" y="71.79932">+measureBuild(..)</tspan>
+          </text>
+        </g>
+        <g id="Graphic_60">
+          <rect x="293.5" y="106.88358" width="116" height="14" fill="white"/>
+          <rect x="293.5" y="106.88358" width="116" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_59">
+          <rect x="293.5" y="82.88358" width="116" height="24" fill="white"/>
+          <rect x="293.5" y="82.88358" width="116" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(298.8125 87.88358)" fill="black">
+            <tspan font-family="Arial" font-size="12" font-weight="700" fill="black" x="0" y="11">PerformanceMeter</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_50">
+        <g id="Graphic_51">
+          <rect x="801" y="194.44373" width="104" height="34" fill="white"/>
+          <rect x="801" y="194.44373" width="104" height="34" stroke="silver" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(806.3125 199.44373)" fill="silver">
+            <tspan font-family="Arial" font-size="8" font-weight="400" fill="silver" x="0" y="7">generators.TestDescriptor.</tspan>
+            <tspan font-family="Arial" font-size="12" font-weight="700" fill="silver" x="17.33496" y="20.261719">ClassDscr</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_41">
+        <g id="Graphic_42">
+          <rect x="25.22473" y="131.4867" width="126" height="44" fill="white"/>
+          <rect x="25.22473" y="131.4867" width="126" height="44" stroke="silver" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(30.547974 136.4867)" fill="silver">
+            <tspan font-family="Arial" font-size="8" font-weight="400" fill="silver" x="37.88574" y="7">«interface»</tspan>
+            <tspan font-family="Arial" font-size="8" font-weight="400" fill="silver" x="5.430664" y="16.261719">org.eclipse.core.runtime.jobs.</tspan>
+            <tspan font-family="Arial" font-size="12" font-weight="700" fill="silver" x="0" y="29.523438">IJobChangeListener</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_38">
+        <g id="Graphic_39">
+          <rect x="23.5" y="88.51549" width="115" height="34" fill="white"/>
+          <rect x="23.5" y="88.51549" width="115" height="34" stroke="silver" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(28.753906 93.51549)" fill="silver">
+            <tspan font-family="Arial" font-size="8" font-weight="400" fill="silver" x="0" y="7">org.eclipse.core.runtime.jobs.</tspan>
+            <tspan font-family="Arial" font-size="12" font-style="italic" font-weight="700" fill="silver" x="41.5791" y="20.261719">Job</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_35">
+        <g id="Graphic_36">
+          <rect x="23.5" y="188.66957" width="160" height="34" fill="white"/>
+          <rect x="23.5" y="188.66957" width="160" height="34" stroke="silver" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(28.810547 193.66957)" fill="silver">
+            <tspan font-family="Arial" font-size="8" font-weight="400" fill="silver" x="26.66797" y="7">org.eclipse.core.resources.</tspan>
+            <tspan font-family="Arial" font-size="12" font-style="italic" font-weight="700" fill="silver" x="0" y="20.261719">IncrementalProjectBuilder</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_20">
+        <g id="Graphic_21">
+          <rect x="801" y="338.43457" width="104" height="34" fill="white"/>
+          <rect x="801" y="338.43457" width="104" height="34" stroke="silver" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(806.3125 343.43457)" fill="silver">
+            <tspan font-family="Arial" font-size="8" font-weight="400" fill="silver" x="0" y="7">generators.TestDescriptor.</tspan>
+            <tspan font-family="Arial" font-size="12" font-weight="700" fill="silver" x="12.017578" y="20.261719">MethodDscr</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_12">
+        <g id="Graphic_15">
+          <rect x="96" y="286.6403" width="89" height="14" fill="white"/>
+          <rect x="96" y="286.6403" width="89" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_14">
+          <rect x="96" y="272.6403" width="89" height="14" fill="white"/>
+          <rect x="96" y="272.6403" width="89" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_13">
+          <rect x="96" y="238.6403" width="89" height="34" fill="white"/>
+          <rect x="96" y="238.6403" width="89" height="34" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(101.49414 243.6403)" fill="black">
+            <tspan font-family="Arial" font-size="8" font-weight="400" fill="black" x="4.9921875" y="7">PerformanceMeter.</tspan>
+            <tspan font-family="Arial" font-size="12" font-weight="700" fill="black" x="0" y="20.261719">BuildStrategy</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_7">
+        <g id="Graphic_8">
+          <rect x="801" y="242.2644" width="104" height="34" fill="white"/>
+          <rect x="801" y="242.2644" width="104" height="34" stroke="silver" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(806.3125 247.2644)" fill="silver">
+            <tspan font-family="Arial" font-size="8" font-weight="400" fill="silver" x="0" y="7">generators.TestDescriptor.</tspan>
+            <tspan font-family="Arial" font-size="12" font-style="italic" font-weight="700" fill="silver" x="10.338867" y="20.261719">MemberDscr</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_4">
+        <g id="Graphic_5">
+          <rect x="801" y="98.80237" width="104" height="34" fill="white"/>
+          <rect x="801" y="98.80237" width="104" height="34" stroke="silver" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(806.3125 103.80237)" fill="silver">
+            <tspan font-family="Arial" font-size="8" font-weight="400" fill="silver" x="0" y="7">generators.TestDescriptor.</tspan>
+            <tspan font-family="Arial" font-size="12" font-weight="700" fill="silver" x="13.004883" y="20.261719">ProjectDscr</tspan>
+          </text>
+        </g>
+      </g>
+    </g>
+  </g>
+</svg>
diff --git a/design/chapters/15_tests/images/cd_performancetest_generator.svg b/design/chapters/15_tests/images/cd_performancetest_generator.svg
new file mode 100644
index 0000000..6b38bb0
--- /dev/null
+++ b/design/chapters/15_tests/images/cd_performancetest_generator.svg
@@ -0,0 +1,542 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xl="http://www.w3.org/1999/xlink" xmlns:dc="http://purl.org/dc/elements/1.1/" viewBox="0 0 1120 783" width="1120" height="783">
+  <defs>
+    <font-face font-family="Arial" font-size="12" panose-1="2 11 6 4 2 2 2 2 2 4" units-per-em="1000" underline-position="-105.95703" underline-thickness="73.24219" slope="0" x-height="518.5547" cap-height="716.3086" ascent="905.2734" descent="-211.91406" font-weight="400">
+      <font-face-src>
+        <font-face-name name="ArialMT"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Arial" font-size="13" panose-1="2 11 7 4 2 2 2 2 2 4" units-per-em="1000" underline-position="-105.95703" underline-thickness="104.98047" slope="0" x-height="518.5547" cap-height="715.8203" ascent="905.2734" descent="-211.91406" font-weight="700">
+      <font-face-src>
+        <font-face-name name="Arial-BoldMT"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Arial" font-size="10" panose-1="2 11 6 4 2 2 2 2 2 4" units-per-em="1000" underline-position="-105.95703" underline-thickness="73.24219" slope="0" x-height="518.5547" cap-height="716.3086" ascent="905.2734" descent="-211.91406" font-weight="400">
+      <font-face-src>
+        <font-face-name name="ArialMT"/>
+      </font-face-src>
+    </font-face>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="StickArrow_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -4 10 8" markerWidth="10" markerHeight="8" color="black">
+      <g>
+        <path d="M 8 0 L 0 0 M 0 -3 L 8 0 L 0 3" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="UMLInheritance_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -8 14 16" markerWidth="14" markerHeight="16" color="black">
+      <g>
+        <path d="M 12 0 L 0 -7 L 0 7 Z" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <font-face font-family="Arial" font-size="11" panose-1="2 11 6 4 2 2 2 2 2 4" units-per-em="1000" underline-position="-105.95703" underline-thickness="73.24219" slope="0" x-height="518.5547" cap-height="716.3086" ascent="905.2734" descent="-211.91406" font-weight="400">
+      <font-face-src>
+        <font-face-name name="ArialMT"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Arial" font-size="12" panose-1="2 11 7 4 2 2 2 2 2 4" units-per-em="1000" underline-position="-105.95703" underline-thickness="104.98047" slope="0" x-height="518.5547" cap-height="715.8203" ascent="905.2734" descent="-211.91406" font-weight="700">
+      <font-face-src>
+        <font-face-name name="Arial-BoldMT"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Arial" font-size="8" panose-1="2 11 6 4 2 2 2 2 2 4" units-per-em="1000" underline-position="-105.95703" underline-thickness="73.24219" slope="0" x-height="518.5547" cap-height="716.3086" ascent="905.2734" descent="-211.91406" font-weight="400">
+      <font-face-src>
+        <font-face-name name="ArialMT"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Arial" font-size="12" panose-1="2 11 7 4 2 2 2 9 2 4" units-per-em="1000" underline-position="-105.95703" underline-thickness="104.98047" slope="-1e3" x-height="518.5547" cap-height="715.332" ascent="905.2734" descent="-211.91406" font-style="italic" font-weight="700">
+      <font-face-src>
+        <font-face-name name="Arial-BoldItalicMT"/>
+      </font-face-src>
+    </font-face>
+  </defs>
+  <metadata> Produced by OmniGraffle 7.11 
+    <dc:date>2013-08-06 09:11:55 +0000</dc:date>
+  </metadata>
+  <g id="Canvas_1" stroke="none" stroke-opacity="1" stroke-dasharray="none" fill="none" fill-opacity="1">
+    <title>Canvas 1</title>
+    <rect fill="white" x="0" y="0" width="1120" height="783"/>
+    <g id="Canvas_1: Layer 1">
+      <title>Layer 1</title>
+      <g id="Graphic_264">
+        <path d="M 984 99.5392 C 984 91.20296 981.3457 90.1716 961.9568 81.9216 L 961.752 81.83624 C 942.2606 73.5 942.0579 73.5 922.0545 73.5 C 895.4195 73.5 775 73.5 775 73.5 L 775 161.5 L 984 161.5 L 984 99.5392 Z" fill="white"/>
+        <path d="M 984 99.5392 C 984 91.20296 981.3457 90.1716 961.9568 81.9216 L 961.752 81.83624 C 942.2606 73.5 942.0579 73.5 922.0545 73.5 C 895.4195 73.5 775 73.5 775 73.5 L 775 161.5 L 984 161.5 L 984 99.5392 Z M 984 99.10976 C 984 91.20296 983.7952 91.20296 942.0579 91.20296 L 942.0579 91.20296 C 942.0579 73.58624 942.0579 73.5 923.2792 73.5" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(780 78.5)" fill="black">
+          <tspan font-family="Arial" font-size="12" font-weight="400" fill="black" x="0" y="11">package</tspan>
+          <tspan font-family="Arial" font-size="13" font-weight="700" fill="black" x="0" y="26.392578">n4js.performance.generators</tspan>
+          <tspan font-family="Arial" font-size="10" font-weight="400" fill="black" x="0" y="38.81787">Scopes shown: package, public, </tspan>
+          <tspan font-family="Arial" font-size="10" font-weight="400" fill="black" x="0" y="50.14502">Omitted methods: getter and setter, removed </tspan>
+          <tspan font-family="Arial" font-size="10" font-weight="400" fill="black" x="0" y="61.47217">some dependencies</tspan>
+          <tspan font-family="Arial" font-size="10" font-weight="400" fill="black" x="0" y="72.79932">created on Aug 6, 2013</tspan>
+        </text>
+      </g>
+      <g id="Line_259">
+        <line x1="451.44806" y1="208.45718" x2="154.04955" y2="495.12936" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_258">
+        <line x1="451.44806" y1="192.9552" x2="158.55743" y2="402.05006" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_253">
+        <line x1="451.44806" y1="143.96994" x2="160.8714" y2="121.83268" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_252">
+        <line x1="451.44806" y1="159.2566" x2="153.25937" y2="210.06055" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_251">
+        <line x1="558.66154" y1="220.69334" x2="585.7978" y2="263.90635" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_246">
+        <line x1="451.44806" y1="176.40839" x2="152.53808" y2="310.02617" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_234">
+        <line x1="621.3573" y1="671" x2="862.2742" y2="476.2242" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_225">
+        <line x1="387.724" y1="503.99836" x2="157.3214" y2="621.3661" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_224">
+        <line x1="387.724" y1="514.38116" x2="113.09018" y2="708.08176" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_223">
+        <line x1="387.724" y1="526.76543" x2="198.21712" y2="704.7068" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_221">
+        <line x1="387.724" y1="487.0203" x2="157.22767" y2="530.5984" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_220">
+        <line x1="387.724" y1="470.8765" x2="160.33458" y2="444.6044" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_219">
+        <line x1="491.33316" y1="418" x2="580.71014" y2="313.8046" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_218">
+        <line x1="493.724" y1="474.17507" x2="788.114" y2="458.4839" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_217">
+        <line x1="387.724" y1="454.0644" x2="152.58574" y2="352.30897" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_216">
+        <line x1="453.79324" y1="418" x2="495.3581" y2="230.35905" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_205">
+        <line x1="387.15613" y1="356.4988" x2="160.00002" y2="423.10586" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_204">
+        <line x1="387.15613" y1="321.64332" x2="152.80159" y2="236.23782" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_203">
+        <line x1="387.15613" y1="339.4646" x2="153.39607" y2="332.8778" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_202">
+        <line x1="387.15613" y1="372.67014" x2="155.99539" y2="510.9832" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_200">
+        <line x1="493.1561" y1="324.01067" x2="539.1438" y2="309.3056" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_199">
+        <line x1="493.1561" y1="354.1294" x2="812.9862" y2="433.6123" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_194">
+        <line x1="477" y1="680.9374" x2="851.4507" y2="474.7748" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_185">
+        <path d="M 514.0876 220.69334 L 516 436 L 502.41806 443.39757" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_184">
+        <text transform="translate(498.47937 333.95805)" fill="black">
+          <tspan font-family="Arial" font-size="12" font-weight="400" fill="black" x="0" y="11">#modifier</tspan>
+        </text>
+      </g>
+      <g id="Graphic_183"/>
+      <g id="Line_179">
+        <line x1="575.44806" y1="198.6653" x2="862.2002" y2="429.78736" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_178">
+        <text transform="translate(708.3508 304.10398)" fill="black">
+          <tspan font-family="Arial" font-size="12" font-weight="400" fill="black" x="0" y="11">#config</tspan>
+        </text>
+      </g>
+      <g id="Graphic_177"/>
+      <g id="Line_176">
+        <line x1="452.73584" y1="307.95804" x2="482.47504" y2="229.944" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_175">
+        <text transform="translate(434.21073 254.4761)" fill="black">
+          <tspan font-family="Arial" font-size="12" font-weight="400" fill="black" x="0" y="11">-generator</tspan>
+        </text>
+      </g>
+      <g id="Graphic_174"/>
+      <g id="Line_173">
+        <line x1="104" y1="186.95312" x2="104" y2="157.5" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_172">
+        <path d="M 106.60982 407 L 106.60982 391.5 L 106.60982 385.5 L 105.3664 385.5 L 105.3664 378.5 L 105.3664 376.5" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_171">
+        <path d="M 841 710.5 L 667.5 710.5 L 667.5 477 L 507.224 477" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_170">
+        <path d="M 572.5 671 L 572.5 603.5 L 440.724 603.5 L 440.724 549.5" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_169">
+        <path d="M 158.5 711 L 158.5 691.5 L 107 691.5 L 107 684.5" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_168">
+        <path d="M 440.25397 418 L 440.25397 402.5 L 439.9031 389.45804 L 439.9031 387.45804" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_167">
+        <path d="M 107.51688 502 L 107.51688 486.5 L 107.53109 485.5 L 107.53109 483.5" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_166">
+        <path d="M 747 671 L 747 477 L 507.224 477" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_165">
+        <path d="M 78.69483 711 L 78.69483 695.5 L 78.69483 691.5 L 96.36557 691.5 L 96.36557 686.5 L 96.36557 684.5" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_164">
+        <path d="M 107.12718 623 L 107.12718 607.5 L 107.36563 593.5 L 107.36563 591.5" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_163">
+        <path d="M 417.1179 671 L 417.1179 655.5 L 417.1179 603.5 L 433.6053 603.5 L 433.6053 551.5 L 433.6053 549.5" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_162">
+        <path d="M 104.35986 300 L 104.35986 284.5 L 104.13722 265.45312 L 104.13722 263.45312" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Group_158">
+        <g id="Graphic_161">
+          <rect x="451.44806" y="114.69334" width="124" height="106" fill="white"/>
+          <rect x="451.44806" y="114.69334" width="124" height="106" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(456.44806 115.69334)" fill="black">
+            <tspan font-family="Arial" font-size="11" font-weight="400" fill="black" x="0" y="10">~baos()</tspan>
+            <tspan font-family="Arial" font-size="11" font-weight="400" fill="black" x="0" y="22.359863">+random(..)</tspan>
+            <tspan font-family="Arial" font-size="11" font-weight="400" fill="black" x="0" y="34.719727">+createProjects(..)</tspan>
+            <tspan font-family="Arial" font-size="11" font-weight="400" fill="black" x="0" y="47.07959">+run(..)</tspan>
+            <tspan font-family="Arial" font-size="11" font-weight="400" fill="black" x="0" y="59.43945">+modifyProjects(..)</tspan>
+            <tspan font-family="Arial" font-size="11" font-weight="400" fill="black" x="0" y="71.79932">+run(..)</tspan>
+            <tspan font-family="Arial" font-size="11" font-weight="400" fill="black" x="0" y="84.15918">~printBuildPath()</tspan>
+            <tspan font-family="Arial" font-size="11" font-weight="400" fill="black" x="0" y="96.51904">~printProjectFile(..)</tspan>
+          </text>
+        </g>
+        <g id="Graphic_160">
+          <rect x="451.44806" y="100.69334" width="124" height="14" fill="white"/>
+          <rect x="451.44806" y="100.69334" width="124" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_159">
+          <rect x="451.44806" y="76.69334" width="124" height="24" fill="white"/>
+          <rect x="451.44806" y="76.69334" width="124" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(456.76154 81.69334)" fill="black">
+            <tspan font-family="Arial" font-size="12" font-weight="700" fill="black" x="0" y="11">N4ProjectGenerator</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_147">
+        <g id="Graphic_148">
+          <rect x="541.23805" y="272.29034" width="121" height="34" fill="white"/>
+          <rect x="541.23805" y="272.29034" width="121" height="34" stroke="silver" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(546.5994 277.29034)" fill="silver">
+            <tspan font-family="Arial" font-size="8" font-weight="400" fill="silver" x="0" y="7">PerformanceTestConfiguration.</tspan>
+            <tspan font-family="Arial" font-size="12" font-weight="700" fill="silver" x="30.464844" y="20.261719">Property</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_142">
+        <g id="Graphic_145">
+          <rect x="57" y="129" width="94" height="15" fill="white"/>
+          <rect x="57" y="129" width="94" height="15" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(62 130)" fill="black">
+            <tspan font-family="Arial" font-size="11" font-weight="400" fill="black" x="0" y="10">+cluster(..)</tspan>
+          </text>
+        </g>
+        <g id="Graphic_144">
+          <rect x="57" y="115" width="94" height="14" fill="white"/>
+          <rect x="57" y="115" width="94" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_143">
+          <rect x="57" y="91" width="94" height="24" fill="white"/>
+          <rect x="57" y="91" width="94" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(62.09961 96)" fill="black">
+            <tspan font-family="Arial" font-size="12" font-weight="700" fill="black" x="0" y="11">TestDescriptor</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_117">
+        <g id="Graphic_120">
+          <rect x="64.5" y="234.95312" width="79" height="15" fill="white"/>
+          <rect x="64.5" y="234.95312" width="79" height="15" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(69.5 235.95312)" fill="black">
+            <tspan font-family="Arial" font-size="11" font-weight="400" fill="black" x="0" y="10">+project(..)</tspan>
+          </text>
+        </g>
+        <g id="Graphic_119">
+          <rect x="64.5" y="220.95312" width="79" height="14" fill="white"/>
+          <rect x="64.5" y="220.95312" width="79" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_118">
+          <rect x="64.5" y="186.95312" width="79" height="34" fill="white"/>
+          <rect x="64.5" y="186.95312" width="79" height="34" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(69.98633 191.95312)" fill="black">
+            <tspan font-family="Arial" font-size="8" font-weight="400" fill="black" x="7.560547" y="7">TestDescriptor.</tspan>
+            <tspan font-family="Arial" font-size="12" font-weight="700" fill="black" x="0" y="20.261719">ClusterDscr</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_112">
+        <g id="Graphic_113">
+          <rect x="798" y="436" width="186" height="34" fill="white"/>
+          <rect x="798" y="436" width="186" height="34" stroke="silver" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(803.1006 441)" fill="silver">
+            <tspan font-family="Arial" font-size="8" font-weight="400" fill="silver" x="55.88379" y="7">n4js.performance.</tspan>
+            <tspan font-family="Arial" font-size="12" font-weight="700" fill="silver" x="0" y="20.261719">PerformanceTestConfiguration</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_107">
+        <g id="Graphic_110">
+          <rect x="64.5" y="455" width="86" height="15" fill="white"/>
+          <rect x="64.5" y="455" width="86" height="15" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(69.5 456)" fill="black">
+            <tspan font-family="Arial" font-size="11" font-weight="400" fill="black" x="0" y="10">+class_(..)</tspan>
+          </text>
+        </g>
+        <g id="Graphic_109">
+          <rect x="64.5" y="441" width="86" height="14" fill="white"/>
+          <rect x="64.5" y="441" width="86" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_108">
+          <rect x="64.5" y="407" width="86" height="34" fill="white"/>
+          <rect x="64.5" y="407" width="86" height="34" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(69.80664 412)" fill="black">
+            <tspan font-family="Arial" font-size="8" font-weight="400" fill="black" x="11.240234" y="7">TestDescriptor.</tspan>
+            <tspan font-family="Arial" font-size="12" font-weight="700" fill="black" x="0" y="20.261719">PackageDscr</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_100">
+        <g id="Graphic_103">
+          <rect x="841" y="709" width="154" height="41" fill="white"/>
+          <rect x="841" y="709" width="154" height="41" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(846 710)" fill="black">
+            <tspan font-family="Arial" font-size="11" font-weight="400" fill="black" x="0" y="10">+apply(..)</tspan>
+            <tspan font-family="Arial" font-size="11" font-weight="400" fill="black" x="0" y="22.359863">+modifyManifest(..)</tspan>
+            <tspan font-family="Arial" font-size="11" font-weight="400" fill="black" x="0" y="34.719727">+modifyPackage(..)</tspan>
+          </text>
+        </g>
+        <g id="Graphic_102">
+          <rect x="841" y="695" width="154" height="14" fill="white"/>
+          <rect x="841" y="695" width="154" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_101">
+          <rect x="841" y="671" width="154" height="24" fill="white"/>
+          <rect x="841" y="671" width="154" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(846.3076 676)" fill="black">
+            <tspan font-family="Arial" font-size="12" font-weight="700" fill="black" x="0" y="11">RemoveAllDependencies</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_90">
+        <g id="Graphic_93">
+          <rect x="499.5" y="709" width="146" height="41" fill="white"/>
+          <rect x="499.5" y="709" width="146" height="41" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(504.5 710)" fill="black">
+            <tspan font-family="Arial" font-size="11" font-weight="400" fill="black" x="0" y="10">+apply(..)</tspan>
+            <tspan font-family="Arial" font-size="11" font-weight="400" fill="black" x="0" y="22.359863">+modifyManifest(..)</tspan>
+            <tspan font-family="Arial" font-size="11" font-weight="400" fill="black" x="0" y="34.719727">+modifyClass(..)</tspan>
+          </text>
+        </g>
+        <g id="Graphic_92">
+          <rect x="499.5" y="695" width="146" height="14" fill="white"/>
+          <rect x="499.5" y="695" width="146" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_91">
+          <rect x="499.5" y="671" width="146" height="24" fill="white"/>
+          <rect x="499.5" y="671" width="146" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(504.7949 676)" fill="black">
+            <tspan font-family="Arial" font-size="12" font-weight="700" fill="black" x="0" y="11">RecreateEveryNthClass</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_80">
+        <g id="Graphic_83">
+          <rect x="126" y="759" width="65" height="14" fill="white"/>
+          <rect x="126" y="759" width="65" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_82">
+          <rect x="126" y="745" width="65" height="14" fill="white"/>
+          <rect x="126" y="745" width="65" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_81">
+          <rect x="126" y="711" width="65" height="34" fill="white"/>
+          <rect x="126" y="711" width="65" height="34" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(131.15723 716)" fill="black">
+            <tspan font-family="Arial" font-size="8" font-weight="400" fill="black" x=".8896484" y="7">TestDescriptor.</tspan>
+            <tspan font-family="Arial" font-size="12" font-weight="700" fill="black" x="0" y="20.261719">FieldDscr</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_70">
+        <g id="Graphic_73">
+          <rect x="387.724" y="456" width="106" height="80" fill="white"/>
+          <rect x="387.724" y="456" width="106" height="80" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(392.724 457)" fill="black">
+            <tspan font-family="Arial" font-size="11" font-weight="400" fill="black" x="0" y="10">+modifyManifest(..)</tspan>
+            <tspan font-family="Arial" font-size="11" font-weight="400" fill="black" x="0" y="22.359863">+printManifest(..)</tspan>
+            <tspan font-family="Arial" font-size="11" font-weight="400" fill="black" x="0" y="34.719727">+modifyProject(..)</tspan>
+            <tspan font-family="Arial" font-size="11" font-weight="400" fill="black" x="0" y="47.07959">+modifyPackage(..)</tspan>
+            <tspan font-family="Arial" font-size="11" font-weight="400" fill="black" x="0" y="59.43945">+modifyClass(..)</tspan>
+            <tspan font-family="Arial" font-size="11" font-weight="400" fill="black" x="0" y="71.79932">+printClass(..)</tspan>
+          </text>
+        </g>
+        <g id="Graphic_72">
+          <rect x="387.724" y="442" width="106" height="14" fill="white"/>
+          <rect x="387.724" y="442" width="106" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_71">
+          <rect x="387.724" y="418" width="106" height="24" fill="white"/>
+          <rect x="387.724" y="418" width="106" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(392.724 423)" fill="black">
+            <tspan font-family="Arial" font-size="12" font-weight="700" fill="black" x="24.66797" y="11">Modifier</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_57">
+        <g id="Graphic_60">
+          <rect x="67.5" y="550" width="80" height="28" fill="white"/>
+          <rect x="67.5" y="550" width="80" height="28" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(72.5 551)" fill="black">
+            <tspan font-family="Arial" font-size="11" font-weight="400" fill="black" x="0" y="10">+field(..)</tspan>
+            <tspan font-family="Arial" font-size="11" font-weight="400" fill="black" x="0" y="22.359863">+method(..)</tspan>
+          </text>
+        </g>
+        <g id="Graphic_59">
+          <rect x="67.5" y="536" width="80" height="14" fill="white"/>
+          <rect x="67.5" y="536" width="80" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_58">
+          <rect x="67.5" y="502" width="80" height="34" fill="white"/>
+          <rect x="67.5" y="502" width="80" height="34" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(72.5 507)" fill="black">
+            <tspan font-family="Arial" font-size="8" font-weight="400" fill="black" x="8.546875" y="7">TestDescriptor.</tspan>
+            <tspan font-family="Arial" font-size="12" font-weight="700" fill="black" x="5.647461" y="20.261719">ClassDscr</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_50">
+        <g id="Graphic_53">
+          <rect x="668" y="709" width="158" height="41" fill="white"/>
+          <rect x="668" y="709" width="158" height="41" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(673 710)" fill="black">
+            <tspan font-family="Arial" font-size="11" font-weight="400" fill="black" x="0" y="10">+apply(..)</tspan>
+            <tspan font-family="Arial" font-size="11" font-weight="400" fill="black" x="0" y="22.359863">+modifyManifest(..)</tspan>
+            <tspan font-family="Arial" font-size="11" font-weight="400" fill="black" x="0" y="34.719727">+modifyPackage(..)</tspan>
+          </text>
+        </g>
+        <g id="Graphic_52">
+          <rect x="668" y="695" width="158" height="14" fill="white"/>
+          <rect x="668" y="695" width="158" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_51">
+          <rect x="668" y="671" width="158" height="24" fill="white"/>
+          <rect x="668" y="671" width="158" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(673.3008 676)" fill="black">
+            <tspan font-family="Arial" font-size="12" font-weight="700" fill="black" x="0" y="11">RecreateAllDependencies</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_43">
+        <g id="Graphic_46">
+          <rect x="387.15613" y="345.95804" width="106" height="28" fill="white"/>
+          <rect x="387.15613" y="345.95804" width="106" height="28" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(392.15613 346.95804)" fill="black">
+            <tspan font-family="Arial" font-size="11" font-weight="400" fill="black" x="0" y="10">+random(..)</tspan>
+            <tspan font-family="Arial" font-size="11" font-weight="400" fill="black" x="0" y="22.359863">+apply(..)</tspan>
+          </text>
+        </g>
+        <g id="Graphic_45">
+          <rect x="387.15613" y="331.95804" width="106" height="14" fill="white"/>
+          <rect x="387.15613" y="331.95804" width="106" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_44">
+          <rect x="387.15613" y="307.95804" width="106" height="24" fill="white"/>
+          <rect x="387.15613" y="307.95804" width="106" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(392.48425 312.95804)" fill="black">
+            <tspan font-family="Arial" font-size="12" font-style="italic" font-weight="700" fill="black" x="0" y="11">AbstractModifier</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_27">
+        <g id="Graphic_30">
+          <rect x="25" y="759" width="80" height="14" fill="white"/>
+          <rect x="25" y="759" width="80" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_29">
+          <rect x="25" y="745" width="80" height="14" fill="white"/>
+          <rect x="25" y="745" width="80" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_28">
+          <rect x="25" y="711" width="80" height="34" fill="white"/>
+          <rect x="25" y="711" width="80" height="34" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(30.330078 716)" fill="black">
+            <tspan font-family="Arial" font-size="8" font-weight="400" fill="black" x="8.216797" y="7">TestDescriptor.</tspan>
+            <tspan font-family="Arial" font-size="12" font-weight="700" fill="black" x="0" y="20.261719">MethodDscr</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_20">
+        <g id="Graphic_22">
+          <rect x="65.5" y="657" width="83" height="14" fill="white"/>
+          <rect x="65.5" y="657" width="83" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_21">
+          <rect x="65.5" y="623" width="83" height="34" fill="white"/>
+          <rect x="65.5" y="623" width="83" height="34" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(70.65137 628)" fill="black">
+            <tspan font-family="Arial" font-size="8" font-weight="400" fill="black" x="9.895508" y="7">TestDescriptor.</tspan>
+            <tspan font-family="Arial" font-size="12" font-style="italic" font-weight="700" fill="black" x="0" y="20.261719">MemberDscr</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_13">
+        <g id="Graphic_16">
+          <rect x="346" y="709" width="131" height="54" fill="white"/>
+          <rect x="346" y="709" width="131" height="54" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(351 710)" fill="black">
+            <tspan font-family="Arial" font-size="11" font-weight="400" fill="black" x="0" y="10">+apply(..)</tspan>
+            <tspan font-family="Arial" font-size="11" font-weight="400" fill="black" x="0" y="22.359863">+modifyManifest(..)</tspan>
+            <tspan font-family="Arial" font-size="11" font-weight="400" fill="black" x="0" y="34.719727">+modifyClass(..)</tspan>
+            <tspan font-family="Arial" font-size="11" font-weight="400" fill="black" x="0" y="47.07959">+printClass(..)</tspan>
+          </text>
+        </g>
+        <g id="Graphic_15">
+          <rect x="346" y="695" width="131" height="14" fill="white"/>
+          <rect x="346" y="695" width="131" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_14">
+          <rect x="346" y="671" width="131" height="24" fill="white"/>
+          <rect x="346" y="671" width="131" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(351.1367 676)" fill="black">
+            <tspan font-family="Arial" font-size="12" font-weight="700" fill="black" x="0" y="11">DeleteEveryNthClass</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_6">
+        <g id="Graphic_9">
+          <rect x="65.5" y="348" width="78" height="15" fill="white"/>
+          <rect x="65.5" y="348" width="78" height="15" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(70.5 349)" fill="black">
+            <tspan font-family="Arial" font-size="11" font-weight="400" fill="black" x="0" y="10">+package_(..)</tspan>
+          </text>
+        </g>
+        <g id="Graphic_8">
+          <rect x="65.5" y="334" width="78" height="14" fill="white"/>
+          <rect x="65.5" y="334" width="78" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_7">
+          <rect x="65.5" y="300" width="78" height="34" fill="white"/>
+          <rect x="65.5" y="300" width="78" height="34" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(70.81738 305)" fill="black">
+            <tspan font-family="Arial" font-size="8" font-weight="400" fill="black" x="7.229492" y="7">TestDescriptor.</tspan>
+            <tspan font-family="Arial" font-size="12" font-weight="700" fill="black" x="0" y="20.261719">ProjectDscr</tspan>
+          </text>
+        </g>
+      </g>
+    </g>
+  </g>
+</svg>
diff --git a/design/chapters/15_tests/images/diag_XpectLint.svg b/design/chapters/15_tests/images/diag_XpectLint.svg
new file mode 100644
index 0000000..860ecff
--- /dev/null
+++ b/design/chapters/15_tests/images/diag_XpectLint.svg
@@ -0,0 +1,165 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xl="http://www.w3.org/1999/xlink" xmlns:dc="http://purl.org/dc/elements/1.1/" viewBox="0 0 1024 379" width="1024" height="379">
+  <defs>
+    <font-face font-family="Helvetica" font-size="12" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="532.22656" cap-height="719.7266" ascent="770.0195" descent="-229.98047" font-weight="700">
+      <font-face-src>
+        <font-face-name name="Helvetica-Bold"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="10" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="StickArrow_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -4 10 8" markerWidth="10" markerHeight="8" color="black">
+      <g>
+        <path d="M 8 0 L 0 0 M 0 -3 L 8 0 L 0 3" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <font-face font-family="Helvetica" font-size="12" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+  </defs>
+  <metadata> Produced by OmniGraffle 7.11 
+    <dc:date>2015-07-03 14:46:59 +0000</dc:date>
+  </metadata>
+  <g id="Canvas_1" stroke="none" stroke-opacity="1" stroke-dasharray="none" fill="none" fill-opacity="1">
+    <title>Canvas 1</title>
+    <rect fill="white" x="0" y="0" width="1024" height="379"/>
+    <g id="Canvas_1: Layer 1">
+      <title>Layer 1</title>
+      <g id="Graphic_163">
+        <rect x="457" y="94" width="124" height="36" fill="white"/>
+        <rect x="457" y="94" width="124" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(462 105)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="8.337891" y="11">LintXpectMethod</tspan>
+        </text>
+      </g>
+      <g id="Graphic_165">
+        <rect x="255" y="326.334" width="99" height="36" fill="white"/>
+        <rect x="255" y="326.334" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(260 337.334)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="15.81836" y="11">Transpiler</tspan>
+        </text>
+      </g>
+      <g id="Group_507">
+        <g id="Graphic_509">
+          <rect x="545" y="326.334" width="99" height="36" fill="white"/>
+          <rect x="545" y="326.334" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(550 337.334)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="26.833984" y="11">Foo.js</tspan>
+          </text>
+        </g>
+        <g id="Graphic_508">
+          <rect x="590.0231" y="315" width="74.8741" height="18" fill="white"/>
+          <path d="M 590.0231 315 L 664.8972 315 L 664.8972 333 L 590.0231 333 Z" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+          <text transform="translate(593.0231 318)" fill="black">
+            <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="16.370644" y="10">JS code</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_510">
+        <g id="Graphic_512">
+          <rect x="255" y="158" width="99" height="36" fill="white"/>
+          <rect x="255" y="158" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(260 169)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="19.832031" y="11">Foo.n4js</tspan>
+          </text>
+        </g>
+        <g id="Graphic_511">
+          <rect x="300.0231" y="146.666" width="74.8741" height="18" fill="white"/>
+          <path d="M 300.0231 146.666 L 374.8972 146.666 L 374.8972 164.666 L 300.0231 164.666 Z" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+          <text transform="translate(303.0231 149.666)" fill="black">
+            <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x=".8115616" y="10">N4JSResource</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Graphic_517">
+        <rect x="771.3458" y="158" width="99" height="36" fill="white"/>
+        <rect x="771.3458" y="158" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(776.3458 169)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="24.499023" y="11">Engine</tspan>
+        </text>
+      </g>
+      <g id="Group_519">
+        <g id="Graphic_521">
+          <rect x="545" y="242.167" width="99" height="36" fill="white"/>
+          <rect x="545" y="242.167" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(550 253.167)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="27.833008" y="11">Linter</tspan>
+          </text>
+        </g>
+        <g id="Graphic_520">
+          <rect x="590.0231" y="230.833" width="74.8741" height="18" fill="white"/>
+          <path d="M 590.0231 230.833 L 664.8972 230.833 L 664.8972 248.833 L 590.0231 248.833 Z" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+          <text transform="translate(593.0231 233.833)" fill="black">
+            <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="16.370644" y="10">JS code</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_522">
+        <g id="Graphic_524">
+          <rect x="899" y="272" width="99" height="36" fill="white"/>
+          <rect x="899" y="272" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(904 283)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="15.167969" y="11">LintResult</tspan>
+          </text>
+        </g>
+        <g id="Graphic_523">
+          <rect x="944.0231" y="260.666" width="74.8741" height="18" fill="white"/>
+          <path d="M 944.0231 260.666 L 1018.8972 260.666 L 1018.8972 278.666 L 944.0231 278.666 Z" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+          <text transform="translate(947.0231 263.666)" fill="black">
+            <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="21.375526" y="10">String</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Line_164">
+        <path d="M 457 106 L 405.1 106 L 405.1 176 L 363.9 176" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_525">
+        <path d="M 457 124 L 433.1 124 L 433.1 344.334 L 363.9 344.334" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_526">
+        <line x1="304.5" y1="326.334" x2="304.5" y2="203.9" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_527">
+        <path d="M 304.5 362.334 L 304.5 374.234 L 594.5 374.234 L 594.5 372.234" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_528">
+        <path d="M 519 130 L 519 260.167 L 535.1 260.167" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_529">
+        <path d="M 498.33333 130 L 498.33333 344.334 L 535.1 344.334" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_530">
+        <path d="M 581 112 L 820.8458 112 L 820.8458 148.1" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_531">
+        <path d="M 820.8458 194 L 820.8458 290 L 889.1 290" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_532">
+        <path d="M 581 100 L 915.5 100 L 915.5 262.1" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_535">
+        <path d="M 771.3458 176 L 707.4458 176 L 707.4458 260.167 L 653.9 260.167" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_536">
+        <path d="M 771.3458 176 L 707.4458 176 L 707.4458 344.334 L 653.9 344.334" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_148">
+        <path d="M 842 326.0128 C 842 320.13954 840.7427 319.4129 831.5585 313.6004 L 831.46145 313.54026 C 822.2287 307.667 822.1327 307.667 812.6574 307.667 C 800.0408 307.667 743 307.667 743 307.667 L 743 369.667 L 842 369.667 L 842 326.0128 Z" fill="white"/>
+        <path d="M 842 326.0128 C 842 320.13954 840.7427 319.4129 831.5585 313.6004 L 831.46145 313.54026 C 822.2287 307.667 822.1327 307.667 812.6574 307.667 C 800.0408 307.667 743 307.667 743 307.667 L 743 369.667 L 842 369.667 L 842 326.0128 Z M 842 325.71024 C 842 320.13954 841.903 320.13954 822.1327 320.13954 L 822.1327 320.13954 C 822.1327 307.72776 822.1327 307.667 813.2375 307.667" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(748 324.667)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="5.810547" y="11">Combined into </tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="16.483398" y="25">one JS file</tspan>
+        </text>
+      </g>
+      <g id="Line_188">
+        <line x1="758.18225" y1="307.32984" x2="707.4458" y2="261" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+    </g>
+  </g>
+</svg>
diff --git a/design/chapters/17_formatting/images/FormatterArchitecture.svg b/design/chapters/17_formatting/images/FormatterArchitecture.svg
new file mode 100644
index 0000000..c874b0e
--- /dev/null
+++ b/design/chapters/17_formatting/images/FormatterArchitecture.svg
@@ -0,0 +1,512 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xl="http://www.w3.org/1999/xlink" xmlns:dc="http://purl.org/dc/elements/1.1/" viewBox="401.85433 263.12205 871.4016 732.3386" width="871.4016" height="732.3386">
+  <defs>
+    <filter id="Shadow" filterUnits="userSpaceOnUse" x="401.85433" y="263.12205">
+      <feGaussianBlur in="SourceAlpha" result="blur" stdDeviation="1.308"/>
+      <feOffset in="blur" result="offset" dx="0" dy="2"/>
+      <feFlood flood-color="black" flood-opacity=".5" result="flood"/>
+      <feComposite in="flood" in2="offset" operator="in"/>
+    </filter>
+    <font-face font-family="Helvetica" font-size="12" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="UMLInheritance_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -8 14 16" markerWidth="14" markerHeight="16" color="black">
+      <g>
+        <path d="M 12 0 L 0 -7 L 0 7 Z" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <font-face font-family="Helvetica Neue" font-size="14" panose-1="2 0 5 3 0 0 0 2 0 4" units-per-em="1000" underline-position="-100" underline-thickness="50" slope="0" x-height="517" cap-height="714" ascent="951.9958" descent="-212.99744" font-weight="400">
+      <font-face-src>
+        <font-face-name name="HelveticaNeue"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="12" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="532.22656" cap-height="719.7266" ascent="770.0195" descent="-229.98047" font-weight="700">
+      <font-face-src>
+        <font-face-name name="Helvetica-Bold"/>
+      </font-face-src>
+    </font-face>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="FilledArrow_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -4 10 8" markerWidth="10" markerHeight="8" color="black">
+      <g>
+        <path d="M 8 0 L 0 -3 L 0 3 Z" fill="currentColor" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <font-face font-family="Helvetica" font-size="14" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+  </defs>
+  <metadata> Produced by OmniGraffle 7.11 
+    <dc:date>2019-07-31 14:30:22 +0000</dc:date>
+  </metadata>
+  <g id="Canvas_1" stroke="none" stroke-opacity="1" stroke-dasharray="none" fill="none" fill-opacity="1">
+    <title>Canvas 1</title>
+    <rect fill="white" x="401.85433" y="263.12205" width="871.4016" height="732.3386"/>
+    <g id="Canvas_1: Layer 1">
+      <title>Layer 1</title>
+      <g id="Graphic_25_shadow" filter="url(#Shadow)">
+        <rect x="553.41005" y="311.81102" width="299.8183" height="62.362204" fill="white"/>
+        <rect x="553.41005" y="311.81102" width="299.8183" height="62.362204" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_36_shadow" filter="url(#Shadow)">
+        <rect x="1035.2998" y="311.17323" width="206.27498" height="63" fill="white"/>
+        <rect x="1035.2998" y="311.17323" width="206.27498" height="63" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_162_shadow" filter="url(#Shadow)">
+        <path d="M 702.9921 643.34834 C 702.9921 640.6631 701.4081 640.3309 689.8374 637.6734 L 689.7152 637.6459 C 678.0834 634.9606 677.9624 634.9606 666.02505 634.9606 C 650.1302 634.9606 578.2677 634.9606 578.2677 634.9606 L 578.2677 663.3071 L 702.9921 663.3071 L 702.9921 643.34834 Z" fill="white"/>
+        <path d="M 702.9921 643.34834 C 702.9921 640.6631 701.4081 640.3309 689.8374 637.6734 L 689.7152 637.6459 C 678.0834 634.9606 677.9624 634.9606 666.02505 634.9606 C 650.1302 634.9606 578.2677 634.9606 578.2677 634.9606 L 578.2677 663.3071 L 702.9921 663.3071 L 702.9921 643.34834 Z M 702.9921 643.21 C 702.9921 640.6631 702.8699 640.6631 677.9624 640.6631 L 677.9624 640.6631 C 677.9624 634.9884 677.9624 634.9606 666.7559 634.9606" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_163_shadow" filter="url(#Shadow)">
+        <path d="M 575.4331 899.0728 C 575.4331 890.7485 573.4531 889.7186 558.9897 881.4804 L 558.8369 881.3952 C 544.2972 873.0709 544.14595 873.0709 529.22423 873.0709 C 509.35563 873.0709 419.52756 873.0709 419.52756 873.0709 L 419.52756 960.9449 L 575.4331 960.9449 L 575.4331 899.0728 Z" fill="white"/>
+        <path d="M 575.4331 899.0728 C 575.4331 890.7485 573.4531 889.7186 558.9897 881.4804 L 558.8369 881.3952 C 544.2972 873.0709 544.14595 873.0709 529.22423 873.0709 C 509.35563 873.0709 419.52756 873.0709 419.52756 873.0709 L 419.52756 960.9449 L 575.4331 960.9449 L 575.4331 899.0728 Z M 575.4331 898.644 C 575.4331 890.7485 575.2803 890.7485 544.14595 890.7485 L 544.14595 890.7485 C 544.14595 873.157 544.14595 873.0709 530.13784 873.0709" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_195_shadow" filter="url(#Shadow)">
+        <path d="M 728.5039 753.2432 C 728.5039 747.0373 726.5959 746.2695 712.6585 740.1277 L 712.5113 740.0642 C 698.50026 733.8583 698.3545 733.8583 683.9754 733.8583 C 664.8293 733.8583 578.2677 733.8583 578.2677 733.8583 L 578.2677 799.3701 L 728.5039 799.3701 L 728.5039 753.2432 Z" fill="white"/>
+        <path d="M 728.5039 753.2432 C 728.5039 747.0373 726.5959 746.2695 712.6585 740.1277 L 712.5113 740.0642 C 698.50026 733.8583 698.3545 733.8583 683.9754 733.8583 C 664.8293 733.8583 578.2677 733.8583 578.2677 733.8583 L 578.2677 799.3701 L 728.5039 799.3701 L 728.5039 753.2432 Z M 728.5039 752.9235 C 728.5039 747.0373 728.3567 747.0373 698.3545 747.0373 L 698.3545 747.0373 C 698.3545 733.9225 698.3545 733.8583 684.8558 733.8583" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_205_shadow" filter="url(#Shadow)">
+        <rect x="405.73117" y="559.25197" width="555.2137" height="421.53543" fill="#d1fdd1"/>
+        <rect x="405.73117" y="559.25197" width="555.2137" height="421.53543" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_206_shadow" filter="url(#Shadow)">
+        <rect x="405.35433" y="527.2441" width="225.09456" height="32.007874" fill="#d1fdd1"/>
+        <rect x="405.35433" y="527.2441" width="225.09456" height="32.007874" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_242_shadow" filter="url(#Shadow)">
+        <rect x="995.1317" y="428.50015" width="252.11235" height="549.4526" fill="#d1fdd1"/>
+        <rect x="995.1317" y="428.50015" width="252.11235" height="549.4526" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_243_shadow" filter="url(#Shadow)">
+        <rect x="994.9606" y="391.1811" width="206.92913" height="37.319046" fill="#d1fdd1"/>
+        <rect x="994.9606" y="391.1811" width="206.92913" height="37.319046" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_1">
+        <rect x="977.9528" y="263.62205" width="294.80315" height="731.3386" fill="#e2e2e2"/>
+        <rect x="977.9528" y="263.62205" width="294.80315" height="731.3386" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Group_22">
+        <g id="Graphic_25">
+          <rect x="553.41005" y="311.81102" width="299.8183" height="62.362204" fill="white"/>
+          <rect x="553.41005" y="311.81102" width="299.8183" height="62.362204" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(558.41005 335.99212)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="73.52731" y="11">Plugin: eu.numberfour.n4js</tspan>
+          </text>
+        </g>
+        <g id="Graphic_24">
+          <rect x="498.89763" y="324.6794" width="90.85403" height="11.878515" fill="white"/>
+          <rect x="498.89763" y="324.6794" width="90.85403" height="11.878515" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_23">
+          <rect x="498.89763" y="349.4263" width="90.85403" height="11.878515" fill="white"/>
+          <rect x="498.89763" y="349.4263" width="90.85403" height="11.878515" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+      </g>
+      <g id="Group_33">
+        <g id="Graphic_36">
+          <rect x="1035.2998" y="311.17323" width="206.27498" height="63" fill="white"/>
+          <rect x="1035.2998" y="311.17323" width="206.27498" height="63" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(1040.2998 335.67323)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="54.783974" y="11">org.eclipse.xtext</tspan>
+          </text>
+        </g>
+        <g id="Graphic_35">
+          <rect x="997.7953" y="324.17323" width="62.50757" height="12" fill="white"/>
+          <rect x="997.7953" y="324.17323" width="62.50757" height="12" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_34">
+          <rect x="997.7953" y="349.17323" width="62.50757" height="12" fill="white"/>
+          <rect x="997.7953" y="349.17323" width="62.50757" height="12" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+      </g>
+      <g id="Group_159">
+        <g id="Line_208">
+          <line x1="590.1487" y1="722.8346" x2="594.56105" y2="725.8893" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Line_207">
+          <line x1="835.9711" y1="840.2047" x2="823.6567" y2="860.3957" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Group_204">
+          <g id="Graphic_206">
+            <rect x="405.35433" y="527.2441" width="225.09456" height="32.007874" fill="#d1fdd1"/>
+            <rect x="405.35433" y="527.2441" width="225.09456" height="32.007874" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+            <text transform="translate(410.35433 535.052)" fill="black">
+              <tspan font-family="Helvetica Neue" font-size="14" font-weight="400" fill="black" x="9.638279" y="13">eu.numberfour.n4js.formatting2</tspan>
+            </text>
+          </g>
+          <g id="Graphic_205">
+            <rect x="405.73117" y="559.25197" width="555.2137" height="421.53543" fill="#d1fdd1"/>
+            <rect x="405.73117" y="559.25197" width="555.2137" height="421.53543" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+        </g>
+        <g id="Group_200">
+          <g id="Graphic_203">
+            <rect x="419.52756" y="597.937" width="283.46457" height="12" fill="white"/>
+            <rect x="419.52756" y="597.937" width="283.46457" height="12" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Graphic_202">
+            <rect x="419.52756" y="583.937" width="283.46457" height="14" fill="white"/>
+            <rect x="419.52756" y="583.937" width="283.46457" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+            <text transform="translate(424.52756 583.937)" fill="black">
+              <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="59.482285" y="11">TypeExpressionsFormatter</tspan>
+            </text>
+          </g>
+          <g id="Graphic_201">
+            <rect x="419.52756" y="609.937" width="283.46457" height="14" fill="white"/>
+            <rect x="419.52756" y="609.937" width="283.46457" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+            <text transform="translate(424.52756 609.937)" fill="black">
+              <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="11">format(Object, IFormattableDocument)</tspan>
+            </text>
+          </g>
+        </g>
+        <g id="Group_196">
+          <g id="Graphic_199">
+            <rect x="419.52756" y="696.8346" width="283.46457" height="12" fill="white"/>
+            <rect x="419.52756" y="696.8346" width="283.46457" height="12" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Graphic_198">
+            <rect x="419.52756" y="682.83464" width="283.46457" height="14" fill="white"/>
+            <rect x="419.52756" y="682.83464" width="283.46457" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+            <text transform="translate(424.52756 682.83464)" fill="black">
+              <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="93.71861" y="11">N4JSFormatter</tspan>
+            </text>
+          </g>
+          <g id="Graphic_197">
+            <rect x="419.52756" y="708.8346" width="283.46457" height="14" fill="white"/>
+            <rect x="419.52756" y="708.8346" width="283.46457" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+            <text transform="translate(424.52756 708.8346)" fill="black">
+              <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="11">format( * poly-dispatch , IFormattableDocument)</tspan>
+            </text>
+          </g>
+        </g>
+        <g id="Graphic_195">
+          <path d="M 728.5039 753.2432 C 728.5039 747.0373 726.5959 746.2695 712.6585 740.1277 L 712.5113 740.0642 C 698.50026 733.8583 698.3545 733.8583 683.9754 733.8583 C 664.8293 733.8583 578.2677 733.8583 578.2677 733.8583 L 578.2677 799.3701 L 728.5039 799.3701 L 728.5039 753.2432 Z" fill="white"/>
+          <path d="M 728.5039 753.2432 C 728.5039 747.0373 726.5959 746.2695 712.6585 740.1277 L 712.5113 740.0642 C 698.50026 733.8583 698.3545 733.8583 683.9754 733.8583 C 664.8293 733.8583 578.2677 733.8583 578.2677 733.8583 L 578.2677 799.3701 L 728.5039 799.3701 L 728.5039 753.2432 Z M 728.5039 752.9235 C 728.5039 747.0373 728.3567 747.0373 698.3545 747.0373 L 698.3545 747.0373 C 698.3545 733.9225 698.3545 733.8583 684.8558 733.8583" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(583.2677 752.6142)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="6.420845" y="11">main implementation  of </tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="28.762642" y="25">formatting code</tspan>
+          </text>
+        </g>
+        <g id="Group_191">
+          <g id="Graphic_194">
+            <rect x="419.52756" y="831.9055" width="198.4252" height="12" fill="white"/>
+            <rect x="419.52756" y="831.9055" width="198.4252" height="12" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Graphic_193">
+            <rect x="419.52756" y="819.9055" width="198.4252" height="12" fill="white"/>
+            <rect x="419.52756" y="819.9055" width="198.4252" height="12" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Graphic_192">
+            <rect x="419.52756" y="805.9055" width="198.4252" height="14" fill="white"/>
+            <rect x="419.52756" y="805.9055" width="198.4252" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+            <text transform="translate(424.52756 805.9055)" fill="black">
+              <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="28.854202" y="11">N4JSGenericFormatter</tspan>
+            </text>
+          </g>
+        </g>
+        <g id="Line_190">
+          <line x1="561.25984" y1="682.83464" x2="561.25984" y2="637.437" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Group_186">
+          <g id="Graphic_189">
+            <rect x="748.34645" y="609.937" width="198.4252" height="12" fill="white"/>
+            <rect x="748.34645" y="609.937" width="198.4252" height="12" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Graphic_188">
+            <rect x="748.34645" y="597.937" width="198.4252" height="12" fill="white"/>
+            <rect x="748.34645" y="597.937" width="198.4252" height="12" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Graphic_187">
+            <rect x="748.34645" y="583.937" width="198.4252" height="14" fill="white"/>
+            <rect x="748.34645" y="583.937" width="198.4252" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+            <text transform="translate(753.34645 583.937)" fill="black">
+              <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="1.1950226" y="11">FixedMultilineCommentReplacer</tspan>
+            </text>
+          </g>
+        </g>
+        <g id="Group_182">
+          <g id="Graphic_185">
+            <rect x="748.34645" y="750.5197" width="198.4252" height="12" fill="white"/>
+            <rect x="748.34645" y="750.5197" width="198.4252" height="12" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Graphic_184">
+            <rect x="748.34645" y="738.5197" width="198.4252" height="12" fill="white"/>
+            <rect x="748.34645" y="738.5197" width="198.4252" height="12" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Graphic_183">
+            <rect x="748.34645" y="724.5197" width="198.4252" height="14" fill="white"/>
+            <rect x="748.34645" y="724.5197" width="198.4252" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+            <text transform="translate(753.34645 724.5197)" fill="black">
+              <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="9.195999" y="11">N4MultilineCommentReplacer</tspan>
+            </text>
+          </g>
+        </g>
+        <g id="Group_178">
+          <g id="Graphic_181">
+            <rect x="748.34645" y="677.9685" width="198.4252" height="12" fill="white"/>
+            <rect x="748.34645" y="677.9685" width="198.4252" height="12" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Graphic_180">
+            <rect x="748.34645" y="665.9685" width="198.4252" height="12" fill="white"/>
+            <rect x="748.34645" y="665.9685" width="198.4252" height="12" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Graphic_179">
+            <rect x="748.34645" y="651.9685" width="198.4252" height="14" fill="white"/>
+            <rect x="748.34645" y="651.9685" width="198.4252" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+            <text transform="translate(753.34645 651.9685)" fill="black">
+              <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="8.202835" y="11">OffMultilineCommentReplacer</tspan>
+            </text>
+          </g>
+        </g>
+        <g id="Group_174">
+          <g id="Graphic_177">
+            <rect x="748.34645" y="828.2047" width="198.4252" height="12" fill="white"/>
+            <rect x="748.34645" y="828.2047" width="198.4252" height="12" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Graphic_176">
+            <rect x="748.34645" y="816.2047" width="198.4252" height="12" fill="white"/>
+            <rect x="748.34645" y="816.2047" width="198.4252" height="12" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Graphic_175">
+            <rect x="748.34645" y="802.2047" width="198.4252" height="14" fill="white"/>
+            <rect x="748.34645" y="802.2047" width="198.4252" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+            <text transform="translate(753.34645 802.2047)" fill="black">
+              <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="27.85225" y="11">N4WhitespaceReplacer</tspan>
+            </text>
+          </g>
+        </g>
+        <g id="Group_170">
+          <g id="Graphic_173">
+            <rect x="660.4724" y="952.9291" width="289.13386" height="12" fill="white"/>
+            <rect x="660.4724" y="952.9291" width="289.13386" height="12" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Graphic_172">
+            <rect x="660.4724" y="940.9291" width="289.13386" height="12" fill="white"/>
+            <rect x="660.4724" y="940.9291" width="289.13386" height="12" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Graphic_171">
+            <rect x="660.4724" y="926.9291" width="289.13386" height="14" fill="white"/>
+            <rect x="660.4724" y="926.9291" width="289.13386" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+            <text transform="translate(665.4724 926.9291)" fill="black">
+              <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="51.18997" y="11">N4JSFormatterPreferenceKeys</tspan>
+            </text>
+          </g>
+        </g>
+        <g id="Line_169">
+          <line x1="554.29345" y1="722.8346" x2="528.6147" y2="796.5564" marker-end="url(#FilledArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Group_165">
+          <g id="Graphic_168">
+            <rect x="660.4724" y="897.9213" width="289.13386" height="12" fill="white"/>
+            <rect x="660.4724" y="897.9213" width="289.13386" height="12" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Graphic_167">
+            <rect x="660.4724" y="885.9213" width="289.13386" height="12" fill="white"/>
+            <rect x="660.4724" y="885.9213" width="289.13386" height="12" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Graphic_166">
+            <rect x="660.4724" y="871.9213" width="289.13386" height="14" fill="white"/>
+            <rect x="660.4724" y="871.9213" width="289.13386" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+            <text transform="translate(665.4724 871.9213)" fill="black">
+              <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="18.192902" y="11">N4JSSimpleFormattingPreferenceProvider</tspan>
+            </text>
+          </g>
+        </g>
+        <g id="Line_164">
+          <line x1="590.1487" y1="722.8346" x2="605.66064" y2="733.5737" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_163">
+          <path d="M 575.4331 899.0728 C 575.4331 890.7485 573.4531 889.7186 558.9897 881.4804 L 558.8369 881.3952 C 544.2972 873.0709 544.14595 873.0709 529.22423 873.0709 C 509.35563 873.0709 419.52756 873.0709 419.52756 873.0709 L 419.52756 960.9449 L 575.4331 960.9449 L 575.4331 899.0728 Z" fill="white"/>
+          <path d="M 575.4331 899.0728 C 575.4331 890.7485 573.4531 889.7186 558.9897 881.4804 L 558.8369 881.3952 C 544.2972 873.0709 544.14595 873.0709 529.22423 873.0709 C 509.35563 873.0709 419.52756 873.0709 419.52756 873.0709 L 419.52756 960.9449 L 575.4331 960.9449 L 575.4331 899.0728 Z M 575.4331 898.644 C 575.4331 890.7485 575.2803 890.7485 544.14595 890.7485 L 544.14595 890.7485 C 544.14595 873.157 544.14595 873.0709 530.13784 873.0709" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(424.52756 896.0079)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="10.576782" y="11">some general handling, </tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="6.586548" y="25">e.g. automatic semicolon </tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="50.27405" y="39">insertion</tspan>
+          </text>
+        </g>
+        <g id="Graphic_162">
+          <path d="M 702.9921 643.34834 C 702.9921 640.6631 701.4081 640.3309 689.8374 637.6734 L 689.7152 637.6459 C 678.0834 634.9606 677.9624 634.9606 666.02505 634.9606 C 650.1302 634.9606 578.2677 634.9606 578.2677 634.9606 L 578.2677 663.3071 L 702.9921 663.3071 L 702.9921 643.34834 Z" fill="white"/>
+          <path d="M 702.9921 643.34834 C 702.9921 640.6631 701.4081 640.3309 689.8374 637.6734 L 689.7152 637.6459 C 678.0834 634.9606 677.9624 634.9606 666.02505 634.9606 C 650.1302 634.9606 578.2677 634.9606 578.2677 634.9606 L 578.2677 663.3071 L 702.9921 663.3071 L 702.9921 643.34834 Z M 702.9921 643.21 C 702.9921 640.6631 702.8699 640.6631 677.9624 640.6631 L 677.9624 640.6631 C 677.9624 634.9884 677.9624 634.9606 666.7559 634.9606" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(583.2677 642.13385)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="22.334862" y="11">no code here</tspan>
+          </text>
+        </g>
+        <g id="Line_161">
+          <line x1="507.7347" y1="872.5837" x2="514.3544" y2="843.9055" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Line_160">
+          <line x1="596.3818" y1="623.937" x2="615.30585" y2="634.7132" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+      </g>
+      <g id="Group_209">
+        <g id="Group_241">
+          <g id="Graphic_243">
+            <rect x="994.9606" y="391.1811" width="206.92913" height="37.319046" fill="#d1fdd1"/>
+            <rect x="994.9606" y="391.1811" width="206.92913" height="37.319046" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+            <text transform="translate(999.9606 401.3406)" fill="black">
+              <tspan font-family="Helvetica" font-size="14" font-weight="400" fill="black" x="10.923553" y="14">org.eclipse.xtext.formatting2</tspan>
+            </text>
+          </g>
+          <g id="Graphic_242">
+            <rect x="995.1317" y="428.50015" width="252.11235" height="549.4526" fill="#d1fdd1"/>
+            <rect x="995.1317" y="428.50015" width="252.11235" height="549.4526" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+        </g>
+        <g id="Group_237">
+          <g id="Graphic_240">
+            <rect x="1017.0165" y="535.25984" width="218.889" height="12" fill="white"/>
+            <rect x="1017.0165" y="535.25984" width="218.889" height="12" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Graphic_239">
+            <rect x="1017.0165" y="521.25984" width="218.889" height="14" fill="white"/>
+            <rect x="1017.0165" y="521.25984" width="218.889" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+            <text transform="translate(1022.0165 521.25984)" fill="black">
+              <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="48.762863" y="11">AbstractFormatter2</tspan>
+            </text>
+          </g>
+          <g id="Graphic_238">
+            <rect x="1017.0165" y="547.25984" width="218.889" height="14" fill="white"/>
+            <rect x="1017.0165" y="547.25984" width="218.889" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+            <text transform="translate(1022.0165 547.25984)" fill="black">
+              <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="11">format(Object, IFormattableDocument)</tspan>
+            </text>
+          </g>
+        </g>
+        <g id="Group_232">
+          <g id="Graphic_235">
+            <rect x="1017.0165" y="955.7638" width="218.889" height="12" fill="white"/>
+            <rect x="1017.0165" y="955.7638" width="218.889" height="12" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Graphic_234">
+            <rect x="1017.0165" y="943.7638" width="218.889" height="12" fill="white"/>
+            <rect x="1017.0165" y="943.7638" width="218.889" height="12" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Graphic_233">
+            <rect x="1017.0165" y="929.7638" width="218.889" height="14" fill="white"/>
+            <rect x="1017.0165" y="929.7638" width="218.889" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+            <text transform="translate(1022.0165 929.7638)" fill="black">
+              <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="31.07634" y="11">FormatterPreferenceKeys</tspan>
+            </text>
+          </g>
+        </g>
+        <g id="Group_228">
+          <g id="Graphic_231">
+            <rect x="1051.8089" y="680.80315" width="173.96182" height="12" fill="white"/>
+            <rect x="1051.8089" y="680.80315" width="173.96182" height="12" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Graphic_230">
+            <rect x="1051.8089" y="668.80315" width="173.96182" height="12" fill="white"/>
+            <rect x="1051.8089" y="668.80315" width="173.96182" height="12" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Graphic_229">
+            <rect x="1051.8089" y="654.80315" width="173.96182" height="14" fill="white"/>
+            <rect x="1051.8089" y="654.80315" width="173.96182" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+            <text transform="translate(1056.8089 654.80315)" fill="black">
+              <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="28.965286" y="11">CommentReplacer</tspan>
+            </text>
+          </g>
+        </g>
+        <g id="Group_224">
+          <g id="Graphic_227">
+            <rect x="1051.8089" y="831.0394" width="173.96182" height="12" fill="white"/>
+            <rect x="1051.8089" y="831.0394" width="173.96182" height="12" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Graphic_226">
+            <rect x="1051.8089" y="819.0394" width="173.96182" height="12" fill="white"/>
+            <rect x="1051.8089" y="819.0394" width="173.96182" height="12" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Graphic_225">
+            <rect x="1051.8089" y="805.0394" width="173.96182" height="14" fill="white"/>
+            <rect x="1051.8089" y="805.0394" width="173.96182" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+            <text transform="translate(1056.8089 805.0394)" fill="black">
+              <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="23.290482" y="11">WhitespaceReplacer</tspan>
+            </text>
+          </g>
+        </g>
+        <g id="Group_220">
+          <g id="Graphic_223">
+            <rect x="1051.8089" y="753.3543" width="173.96182" height="12" fill="white"/>
+            <rect x="1051.8089" y="753.3543" width="173.96182" height="12" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Graphic_222">
+            <rect x="1051.8089" y="741.3543" width="173.96182" height="12" fill="white"/>
+            <rect x="1051.8089" y="741.3543" width="173.96182" height="12" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Graphic_221">
+            <rect x="1051.8089" y="727.3543" width="173.96182" height="14" fill="white"/>
+            <rect x="1051.8089" y="727.3543" width="173.96182" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+            <text transform="translate(1056.8089 727.3543)" fill="black">
+              <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="4.6342316" y="11">MultilineCommentReplacer</tspan>
+            </text>
+          </g>
+        </g>
+        <g id="Line_219">
+          <line x1="1138.7898" y1="727.3543" x2="1138.7898" y2="706.30315" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Group_215">
+          <g id="Graphic_218">
+            <rect x="1017.0165" y="900.7559" width="218.889" height="12" fill="white"/>
+            <rect x="1017.0165" y="900.7559" width="218.889" height="12" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Graphic_217">
+            <rect x="1017.0165" y="888.7559" width="218.889" height="12" fill="white"/>
+            <rect x="1017.0165" y="888.7559" width="218.889" height="12" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Graphic_216">
+            <rect x="1017.0165" y="874.7559" width="218.889" height="14" fill="white"/>
+            <rect x="1017.0165" y="874.7559" width="218.889" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+            <text transform="translate(1022.0165 874.7559)" fill="black">
+              <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="2.0607147" y="11">FormatterPreferenceValuesProvider</tspan>
+            </text>
+          </g>
+        </g>
+        <g id="Group_211">
+          <g id="Graphic_214">
+            <rect x="1017.0165" y="479.22834" width="218.889" height="14" fill="white"/>
+            <rect x="1017.0165" y="479.22834" width="218.889" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+            <text transform="translate(1022.0165 479.22834)" fill="black">
+              <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="11">format(FormatterRequest</tspan>
+            </text>
+          </g>
+          <g id="Graphic_213">
+            <rect x="1017.0165" y="467.22834" width="218.889" height="12" fill="white"/>
+            <rect x="1017.0165" y="467.22834" width="218.889" height="12" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Graphic_212">
+            <rect x="1017.0165" y="453.22834" width="218.889" height="14" fill="white"/>
+            <rect x="1017.0165" y="453.22834" width="218.889" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+            <text transform="translate(1022.0165 453.22834)" fill="black">
+              <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="71.435715" y="11">IFormatter2</tspan>
+            </text>
+          </g>
+        </g>
+        <g id="Line_210">
+          <line x1="1126.461" y1="521.25984" x2="1126.461" y2="506.72834" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+      </g>
+      <g id="Line_73">
+        <line x1="702.9921" y1="588.2198" x2="1003.5987" y2="554.8845" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_115">
+        <line x1="925.6412" y1="621.937" x2="1047.5903" y2="651.6113" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_116">
+        <line x1="946.7716" y1="671.9342" x2="1038.3095" y2="672.8251" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_122">
+        <line x1="946.7716" y1="744.48535" x2="1038.3095" y2="745.3763" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_123">
+        <line x1="946.7716" y1="822.1704" x2="1038.3095" y2="823.0614" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_138">
+        <line x1="949.6063" y1="892.1962" x2="1003.517" y2="892.6716" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_147">
+        <line x1="949.6063" y1="947.2041" x2="1003.517" y2="947.6795" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+    </g>
+  </g>
+</svg>
diff --git a/design/chapters/20_externalLibraries/images/externalResources.svg b/design/chapters/20_externalLibraries/images/externalResources.svg
new file mode 100644
index 0000000..bb77adf
--- /dev/null
+++ b/design/chapters/20_externalLibraries/images/externalResources.svg
@@ -0,0 +1,199 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:xl="http://www.w3.org/1999/xlink" version="1.1" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 494 392" width="494" height="392">
+  <defs>
+    <font-face font-family="Helvetica" font-size="8" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="12" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="532.22656" cap-height="719.7266" ascent="770.0195" descent="-229.98047" font-weight="700">
+      <font-face-src>
+        <font-face-name name="Helvetica-Bold"/>
+      </font-face-src>
+    </font-face>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="UMLInheritance_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -6 11 12" markerWidth="11" markerHeight="12" color="black">
+      <g>
+        <path d="M 8.4 0 L 0 -4.9 L 0 4.9 Z" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <font-face font-family="Helvetica" font-size="11" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="3" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+  </defs>
+  <metadata> Produced by OmniGraffle 7.8.2 
+    <dc:date>2018-12-07 10:41:41 +0000</dc:date>
+  </metadata>
+  <g id="Canvas_1" fill-opacity="1" stroke-dasharray="none" stroke="none" stroke-opacity="1" fill="none">
+    <title>Canvas 1</title>
+    <g id="Canvas_1: Layer 1">
+      <title>Layer 1</title>
+      <g id="Graphic_152">
+        <rect x="187.60853" y="12" width="119.16693" height="30.023437" fill="white"/>
+        <rect x="187.60853" y="12" width="119.16693" height="30.023437" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(192.60853 15.011718)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="34.79245" y="8">«interface»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="25.57077" y="21">IResource</tspan>
+        </text>
+      </g>
+      <g id="Graphic_831">
+        <rect x="19" y="138.85931" width="119.16693" height="30.023437" fill="white"/>
+        <rect x="19" y="138.85931" width="119.16693" height="30.023437" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(24 141.87103)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="34.79245" y="8">«interface»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="42.580536" y="21">IFile</tspan>
+        </text>
+      </g>
+      <g id="Graphic_832">
+        <rect x="12" y="75.42966" width="74.16693" height="30.023437" fill="white"/>
+        <rect x="12" y="75.42966" width="74.16693" height="30.023437" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(17 78.44138)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="12.29245" y="8">«interface»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="8.077606" y="21">IStorage</tspan>
+        </text>
+      </g>
+      <g id="Graphic_833">
+        <rect x="187.60853" y="75.42966" width="119.16693" height="30.023437" fill="white"/>
+        <rect x="187.60853" y="75.42966" width="119.16693" height="30.023437" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(192.60853 78.44138)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="34.79245" y="8">«interface»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="24.91452" y="21">IContainer</tspan>
+        </text>
+      </g>
+      <g id="Graphic_834">
+        <rect x="187.60853" y="138.85931" width="119.16693" height="30.023437" fill="white"/>
+        <rect x="187.60853" y="138.85931" width="119.16693" height="30.023437" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(192.60853 141.87103)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="34.79245" y="8">«interface»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="32.575653" y="21">IProject</tspan>
+        </text>
+      </g>
+      <g id="Graphic_835">
+        <rect x="356.21706" y="138.85931" width="119.16693" height="30.023437" fill="white"/>
+        <rect x="356.21706" y="138.85931" width="119.16693" height="30.023437" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(361.21706 141.87103)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="34.79245" y="8">«interface»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="34.58249" y="21">IFolder</tspan>
+        </text>
+      </g>
+      <g id="Graphic_836">
+        <rect x="19" y="192.5" width="119.16693" height="30.023437" fill="white"/>
+        <rect x="19" y="192.5" width="119.16693" height="30.023437" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(24 200.51172)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="44.24753" y="11">File</tspan>
+        </text>
+      </g>
+      <g id="Graphic_837">
+        <rect x="187.60853" y="192.5" width="119.16693" height="30.023437" fill="white"/>
+        <rect x="187.60853" y="192.5" width="119.16693" height="30.023437" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(192.60853 200.51172)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="34.242645" y="11">Project</tspan>
+        </text>
+      </g>
+      <g id="Graphic_838">
+        <rect x="356.21706" y="192.5" width="119.16693" height="30.023437" fill="white"/>
+        <rect x="356.21706" y="192.5" width="119.16693" height="30.023437" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(361.21706 200.51172)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="36.24948" y="11">Folder</tspan>
+        </text>
+      </g>
+      <g id="Graphic_839">
+        <rect x="187.60853" y="244.1407" width="119.16693" height="30.023437" fill="white"/>
+        <rect x="187.60853" y="244.1407" width="119.16693" height="30.023437" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(192.60853 252.1524)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="10.564911" y="11">ExternalProject</tspan>
+        </text>
+      </g>
+      <g id="Graphic_840">
+        <rect x="19" y="244.1407" width="119.16693" height="30.023437" fill="white"/>
+        <rect x="19" y="244.1407" width="119.16693" height="30.023437" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(24 252.1524)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="20.569794" y="11">ExternalFile</tspan>
+        </text>
+      </g>
+      <g id="Graphic_841">
+        <rect x="356.21706" y="244.1407" width="119.16693" height="30.023437" fill="white"/>
+        <rect x="356.21706" y="244.1407" width="119.16693" height="30.023437" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(361.21706 252.1524)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="12.571747" y="11">ExternalFolder</tspan>
+        </text>
+      </g>
+      <g id="Line_165">
+        <line x1="247.192" y1="75.42966" x2="247.192" y2="51.923437" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_842">
+        <path d="M 108.3752 138.85931 L 108.3752 56.959314 L 247.192 56.959314 L 247.192 51.923437" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_843">
+        <path d="M 48.79173 138.85931 L 48.79173 126.95931 L 49.083466 117.3531 L 49.083466 115.3531" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_844">
+        <line x1="247.192" y1="138.85931" x2="247.192" y2="115.3531" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_845">
+        <line x1="78.58347" y1="192.5" x2="78.58347" y2="178.78275" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_846">
+        <path d="M 415.80053 138.85931 L 415.80053 122.24833 L 247.192 122.24833 L 247.192 115.3531" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_847">
+        <line x1="247.192" y1="192.5" x2="247.192" y2="178.78275" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_848">
+        <line x1="415.80053" y1="192.5" x2="415.80053" y2="178.78275" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_849">
+        <path d="M 247.192 375 L 247.192 386.9 L 489 386.9 L 489 57 L 247.192 57 L 247.192 51.923437" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_850">
+        <line x1="78.58347" y1="244.1407" x2="78.58347" y2="232.42344" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_851">
+        <line x1="247.192" y1="244.1407" x2="247.192" y2="232.42344" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_852">
+        <line x1="415.80053" y1="244.1407" x2="415.80053" y2="232.42344" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_853">
+        <path d="M 415.80053 274.16412 L 415.80053 289.06412 L 247.192 289.06412 L 247.192 294.1" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_854">
+        <line x1="247.192" y1="274.66412" x2="247.192" y2="294.1" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_855">
+        <path d="M 78.58347 274.66412 L 78.58347 289.56412 L 247.192 289.56412 L 247.192 294.1" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Group_856">
+        <g id="Graphic_859">
+          <rect x="175.442" y="352" width="143.5" height="23" fill="white"/>
+          <rect x="175.442" y="352" width="143.5" height="23" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(180.442 357)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">getExternalResource()</tspan>
+          </text>
+        </g>
+        <g id="Graphic_858">
+          <rect x="175.442" y="338" width="143.5" height="14" fill="white"/>
+          <rect x="175.442" y="338" width="143.5" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(180.442 343)" fill="black">
+            <tspan font-family="Helvetica" font-size="3" font-weight="400" fill="black" x="0" y="3"> </tspan>
+          </text>
+        </g>
+        <g id="Graphic_857">
+          <rect x="175.442" y="304" width="143.5" height="34" fill="white"/>
+          <rect x="175.442" y="304" width="143.5" height="34" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(180.442 309)" fill="black">
+            <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="46.958984" y="8">«interface»</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="14.05957" y="21">IExternalResource</tspan>
+          </text>
+        </g>
+      </g>
+    </g>
+  </g>
+</svg>
diff --git a/design/chapters/23_jsdoc/images/cd_JSDocModel.svg b/design/chapters/23_jsdoc/images/cd_JSDocModel.svg
new file mode 100644
index 0000000..a31996c
--- /dev/null
+++ b/design/chapters/23_jsdoc/images/cd_JSDocModel.svg
@@ -0,0 +1,675 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xl="http://www.w3.org/1999/xlink" xmlns:dc="http://purl.org/dc/elements/1.1/" viewBox="-146.48425 43.43701 1089.9843 962.063" width="1089.9843" height="962.063">
+  <defs>
+    <font-face font-family="Helvetica" font-size="12" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="8" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="StickArrow_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -4 10 8" markerWidth="10" markerHeight="8" color="black">
+      <g>
+        <path d="M 8 0 L 0 0 M 0 -3 L 8 0 L 0 3" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="FilledDiamond_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-9 -4 10 8" markerWidth="10" markerHeight="8" color="black">
+      <g>
+        <path d="M -8 0 L -4 3 L 0 0 L -4 -3 Z" fill="currentColor" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="UMLInheritance_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -8 14 16" markerWidth="14" markerHeight="16" color="black">
+      <g>
+        <path d="M 12 0 L 0 -7 L 0 7 Z" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <font-face font-family="Helvetica" font-size="11" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="12" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="532.22656" cap-height="719.7266" ascent="770.0195" descent="-229.98047" font-weight="700">
+      <font-face-src>
+        <font-face-name name="Helvetica-Bold"/>
+      </font-face-src>
+    </font-face>
+  </defs>
+  <metadata> Produced by OmniGraffle 7.11 
+    <dc:date>2019-07-31 14:14:02 +0000</dc:date>
+  </metadata>
+  <g id="Canvas_1" stroke="none" stroke-opacity="1" stroke-dasharray="none" fill="none" fill-opacity="1">
+    <title>Canvas 1</title>
+    <rect fill="white" x="-146.48425" y="43.43701" width="1089.9843" height="962.063"/>
+    <g id="Canvas_1: UML Elements">
+      <title>UML Elements</title>
+      <g id="Graphic_1129">
+        <text transform="translate(130.36536 278.15748)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="11">*</tspan>
+        </text>
+      </g>
+      <g id="Graphic_1128">
+        <text transform="translate(110.98903 252.15748)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="0" y="8">markers</tspan>
+        </text>
+      </g>
+      <g id="Line_1127">
+        <line x1="173.58465" y1="265.65746" x2="115.98661" y2="265.6575" marker-end="url(#StickArrow_Marker)" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_1126">
+        <text transform="translate(646.31155 344.75363)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="0" y="8">tag</tspan>
+        </text>
+      </g>
+      <g id="Line_1125">
+        <line x1="557.71654" y1="421.85237" x2="684.7663" y2="339.4047" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_1124">
+        <text transform="translate(75.140005 405.19475)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="0" y="8">owner</tspan>
+        </text>
+      </g>
+      <g id="Line_1123">
+        <line x1="165.12694" y1="418.9685" x2="69.2149" y2="418.6366" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_1122">
+        <text transform="translate(125.85418 449.9065)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="11">*</tspan>
+        </text>
+      </g>
+      <g id="Graphic_1121">
+        <text transform="translate(123.57692 424.1005)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="0" y="8">contents</tspan>
+        </text>
+      </g>
+      <g id="Line_1120">
+        <line x1="68.56331" y1="436.2772" x2="155.22871" y2="437.91526" marker-end="url(#StickArrow_Marker)" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_1119">
+        <text transform="translate(112.3937 928.8307)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="0" y="8">doclet</tspan>
+        </text>
+      </g>
+      <g id="Line_1118">
+        <path d="M 846.7972 639.7638 L 846.7972 942.3307 L 112.31732 942.3307" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_1117">
+        <text transform="translate(824.6698 192.94596)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="0" y="8">tagDefinition</tspan>
+        </text>
+      </g>
+      <g id="Line_1116">
+        <line x1="858.7382" y1="262.01552" x2="860.1284" y2="180.52848" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_1115">
+        <text transform="translate(-96.98425 645.2638)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="11">*</tspan>
+        </text>
+      </g>
+      <g id="Graphic_1114">
+        <text transform="translate(-131.53494 651.7638)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="0" y="8">values</tspan>
+        </text>
+      </g>
+      <g id="Line_1113">
+        <path d="M 923.2106 334.0155 L 943 334.0155 L 943 1005 L -120.47244 1005 L -120.47244 652.9" marker-end="url(#StickArrow_Marker)" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_1112">
+        <text transform="translate(556.8098 360.951)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="0" y="8">title</tspan>
+        </text>
+      </g>
+      <g id="Line_1111">
+        <line x1="685.5011" y1="291.33158" x2="537.29466" y2="395.41274" marker-end="url(#StickArrow_Marker)" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_1110">
+        <text transform="translate(906.9623 646.72376)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="11">*</tspan>
+        </text>
+      </g>
+      <g id="Graphic_1109">
+        <text transform="translate(864.6215 656.2114)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="0" y="8">lineTags</tspan>
+        </text>
+      </g>
+      <g id="Line_1108">
+        <path d="M 111.66732 966.3307 L 896.2972 966.3307 L 896.2972 649.6638" marker-end="url(#StickArrow_Marker)" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_1107">
+        <path d="M 488.2677 570.1501 L 488.2677 523.6501 L 218.9852 523.6501 L 218.9852 489.8701" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_1106">
+        <line x1="488.2677" y1="694.4882" x2="488.2677" y2="672.72" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_1105">
+        <path d="M 114.54713 570.1501 L 114.54713 523.6501 L 192.05607 523.6501 L 192.05607 489.8701" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_1104">
+        <path d="M 83.21006 570.1501 L 83.21006 520.6501 L 34.56495 520.6501 L 34.56495 484.60237" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_1103">
+        <path d="M -96.48425 570.1501 L -96.48425 520.6501 L 9.81496 520.6501 L 9.81496 484.60237" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_1102">
+        <path d="M 397.55907 206.83858 L 397.55907 173.33858 L 532.2638 173.33858 L 532.2638 153.437" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_1101">
+        <path d="M 749.6575 570.1501 L 749.6575 463.6501 L 748.2933 463.6501 L 748.2933 371.5155" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_1100">
+        <path d="M 724.9075 570.1501 L 724.9075 523.6501 L 218.9852 523.6501 L 218.9852 489.8701" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_1099">
+        <path d="M 500.6693 401.10237 L 500.6693 362.60237 L 325.98425 362.60237 L 325.98425 337.97638" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_1098">
+        <path d="M 633.437 570.1501 L 633.437 523.6501 L 218.9852 523.6501 L 218.9852 489.8701" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_1097">
+        <path d="M 218.98521 399.83465 L 218.98521 362.33465 L 325.98425 362.33465 L 325.98425 337.97638" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_1096">
+        <path d="M 317.5069 570.7638 L 317.5069 523.2638 L 218.9852 523.2638 L 218.9852 489.8701" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_1095">
+        <path d="M 9.814962 401.10237 L 9.814962 362.60237 L 325.98425 362.60237 L 325.98425 337.97638" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_1094">
+        <path d="M 871.5473 569.7638 L 871.5473 464.2638 L 803.5158 464.2638 L 803.5158 371.5155" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_1093">
+        <path d="M 657.7844 694.4882 L 657.7844 678.9882 L 658.187 655.6501 L 658.187 653.6501" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_1092">
+        <line x1="488.2677" y1="825.7564" x2="488.2677" y2="803.9882" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_1091">
+        <path d="M 226.87796 569.7638 L 226.87796 523.2638 L 218.9852 523.2638 L 218.9852 489.8701" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_1090">
+        <path d="M 803.5158 262.01552 L 803.5158 200.51552 L 532.2638 200.51552 L 532.2638 153.437" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_1089">
+        <path d="M 9.68898 894.3307 L 9.68898 878.8307 L 9.81496 486.60237 L 9.81496 484.60237" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Group_1085">
+        <g id="Graphic_1088">
+          <rect x="419.52756" y="620.5873" width="137.48032" height="38.63272" fill="white"/>
+          <rect x="419.52756" y="620.5873" width="137.48032" height="38.63272" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(424.52756 625.5873)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">+typeNameSet(): boolean</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="23">+toString(): String</tspan>
+          </text>
+        </g>
+        <g id="Graphic_1087">
+          <rect x="419.52756" y="595.90525" width="137.48032" height="24.682016" fill="white"/>
+          <rect x="419.52756" y="595.90525" width="137.48032" height="24.682016" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(424.52756 600.90525)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">+typeName: String</tspan>
+          </text>
+        </g>
+        <g id="Graphic_1086">
+          <rect x="419.52756" y="570.1501" width="137.48032" height="25.755147" fill="white"/>
+          <rect x="419.52756" y="570.1501" width="137.48032" height="25.755147" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(424.52756 575.1501)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="1.490158" y="11">SimpleTypeReference</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_1081">
+        <g id="Graphic_1084">
+          <rect x="408.48426" y="741.4882" width="159.56693" height="49" fill="white"/>
+          <rect x="408.48426" y="741.4882" width="159.56693" height="49" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(413.48426 746.4882)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">+moduleNameSet(): boolean</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="23">+toString(): String</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="36">+fullTypeName(): String</tspan>
+          </text>
+        </g>
+        <g id="Graphic_1083">
+          <rect x="408.48426" y="718.4882" width="159.56693" height="23" fill="white"/>
+          <rect x="408.48426" y="718.4882" width="159.56693" height="23" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(413.48426 723.4882)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">+moduleName: String</tspan>
+          </text>
+        </g>
+        <g id="Graphic_1082">
+          <rect x="408.48426" y="694.4882" width="159.56693" height="24" fill="white"/>
+          <rect x="408.48426" y="694.4882" width="159.56693" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(413.48426 699.4882)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="21.542252" y="11">FullTypeReference</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_1077">
+        <g id="Graphic_1080">
+          <rect x="7.086614" y="284.15748" width="99" height="23" fill="white"/>
+          <rect x="7.086614" y="284.15748" width="99" height="23" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(12.086614 289.15748)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10"> </tspan>
+          </text>
+        </g>
+        <g id="Graphic_1079">
+          <rect x="7.086614" y="248.15748" width="99" height="36" fill="white"/>
+          <rect x="7.086614" y="248.15748" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(12.086614 253.15748)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">+key: String</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="23">+value: String</tspan>
+          </text>
+        </g>
+        <g id="Graphic_1078">
+          <rect x="7.086614" y="224.15748" width="99" height="24" fill="white"/>
+          <rect x="7.086614" y="224.15748" width="99" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(12.086614 229.15748)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="24.82129" y="11">Marker</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_1073">
+        <g id="Graphic_1076">
+          <rect x="20.53594" y="617.1501" width="125.34824" height="23" fill="white"/>
+          <rect x="20.53594" y="617.1501" width="125.34824" height="23" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(25.53594 622.1501)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10"> </tspan>
+          </text>
+        </g>
+        <g id="Graphic_1075">
+          <rect x="20.53594" y="594.1501" width="125.34824" height="23" fill="white"/>
+          <rect x="20.53594" y="594.1501" width="125.34824" height="23" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(25.53594 599.1501)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10"> </tspan>
+          </text>
+        </g>
+        <g id="Graphic_1074">
+          <rect x="20.53594" y="570.1501" width="125.34824" height="24" fill="white"/>
+          <rect x="20.53594" y="570.1501" width="125.34824" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(25.53594 575.1501)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="4.011036" y="11">ComposedContent</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_1069">
+        <g id="Graphic_1072">
+          <rect x="810.7972" y="147.62992" width="99" height="23" fill="white"/>
+          <rect x="810.7972" y="147.62992" width="99" height="23" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(815.7972 152.62992)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10"> </tspan>
+          </text>
+        </g>
+        <g id="Graphic_1071">
+          <rect x="810.7972" y="124.62992" width="99" height="23" fill="white"/>
+          <rect x="810.7972" y="124.62992" width="99" height="23" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(815.7972 129.62992)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10"> </tspan>
+          </text>
+        </g>
+        <g id="Graphic_1070">
+          <rect x="810.7972" y="100.62992" width="99" height="24" fill="white"/>
+          <rect x="810.7972" y="100.62992" width="99" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(815.7972 105.62992)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="6.613281" y="11">TagDefinition</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_1065">
+        <g id="Graphic_1068">
+          <rect x="-145.98425" y="617.1501" width="99" height="23" fill="white"/>
+          <rect x="-145.98425" y="617.1501" width="99" height="23" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(-140.98425 622.1501)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10"> </tspan>
+          </text>
+        </g>
+        <g id="Graphic_1067">
+          <rect x="-145.98425" y="594.1501" width="99" height="23" fill="white"/>
+          <rect x="-145.98425" y="594.1501" width="99" height="23" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(-140.98425 599.1501)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">+key: String</tspan>
+          </text>
+        </g>
+        <g id="Graphic_1066">
+          <rect x="-145.98425" y="570.1501" width="99" height="24" fill="white"/>
+          <rect x="-145.98425" y="570.1501" width="99" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(-140.98425 575.1501)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="18.595703" y="11">TagValue</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_1061">
+        <g id="Graphic_1064">
+          <rect x="182.83465" y="257.56314" width="286.2992" height="66.91324" fill="white"/>
+          <rect x="182.83465" y="257.56314" width="286.2992" height="66.91324" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(187.83465 262.56314)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">+getMarkerValue(theKey: String): String</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="23">+setMarker(theKey: String, value: String)</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="36">+isMarkedAs(theKey: String, theValue: String): boolean</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="49">+toString(): String</tspan>
+          </text>
+        </g>
+        <g id="Graphic_1063">
+          <rect x="182.83465" y="232.74048" width="286.2992" height="24.822654" fill="white"/>
+          <rect x="182.83465" y="232.74048" width="286.2992" height="24.822654" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(187.83465 237.74048)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10"> </tspan>
+          </text>
+        </g>
+        <g id="Graphic_1062">
+          <rect x="182.83465" y="206.83858" width="286.2992" height="25.9019" fill="white"/>
+          <rect x="182.83465" y="206.83858" width="286.2992" height="25.9019" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(187.83465 211.83858)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="104.47578" y="11">JSDocNode</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_1057">
+        <g id="Graphic_1060">
+          <rect x="449.1378" y="103.93701" width="166.25198" height="36" fill="white"/>
+          <rect x="449.1378" y="103.93701" width="166.25198" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(454.1378 108.93701)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">+setRange(begin: int, end: int)</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="23">+covers(offset: int): boolean</tspan>
+          </text>
+        </g>
+        <g id="Graphic_1059">
+          <rect x="449.1378" y="67.93701" width="166.25198" height="36" fill="white"/>
+          <rect x="449.1378" y="67.93701" width="166.25198" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(454.1378 72.93701)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">+begin: int</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="23">+end: int</tspan>
+          </text>
+        </g>
+        <g id="Graphic_1058">
+          <rect x="449.1378" y="43.93701" width="166.25198" height="24" fill="white"/>
+          <rect x="449.1378" y="43.93701" width="166.25198" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(454.1378 48.93701)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="36.448257" y="11">DocletElement</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_1053">
+        <g id="Graphic_1056">
+          <rect x="700.1575" y="617.1501" width="99" height="23" fill="white"/>
+          <rect x="700.1575" y="617.1501" width="99" height="23" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(705.1575 622.1501)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10"> </tspan>
+          </text>
+        </g>
+        <g id="Graphic_1055">
+          <rect x="700.1575" y="594.1501" width="99" height="23" fill="white"/>
+          <rect x="700.1575" y="594.1501" width="99" height="23" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(705.1575 599.1501)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10"> </tspan>
+          </text>
+        </g>
+        <g id="Graphic_1054">
+          <rect x="700.1575" y="570.1501" width="99" height="24" fill="white"/>
+          <rect x="700.1575" y="570.1501" width="99" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(705.1575 575.1501)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="18.607422" y="11">InlineTag</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_1049">
+        <g id="Graphic_1052">
+          <rect x="443.62205" y="461.10237" width="114.09449" height="23" fill="white"/>
+          <rect x="443.62205" y="461.10237" width="114.09449" height="23" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(448.62205 466.10237)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10"> </tspan>
+          </text>
+        </g>
+        <g id="Graphic_1051">
+          <rect x="443.62205" y="425.10237" width="114.09449" height="36" fill="white"/>
+          <rect x="443.62205" y="425.10237" width="114.09449" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(448.62205 430.10237)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">+title: String</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="23">+actualTitle: String</tspan>
+          </text>
+        </g>
+        <g id="Graphic_1050">
+          <rect x="443.62205" y="401.10237" width="114.09449" height="24" fill="white"/>
+          <rect x="443.62205" y="401.10237" width="114.09449" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(448.62205 406.10237)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="29.59412" y="11">TagTitle</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_1041">
+        <g id="Graphic_1044">
+          <rect x="583.937" y="617.1501" width="99" height="23" fill="white"/>
+          <rect x="583.937" y="617.1501" width="99" height="23" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(588.937 622.1501)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10"> </tspan>
+          </text>
+        </g>
+        <g id="Graphic_1043">
+          <rect x="583.937" y="594.1501" width="99" height="23" fill="white"/>
+          <rect x="583.937" y="594.1501" width="99" height="23" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(588.937 599.1501)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">+text: String</tspan>
+          </text>
+        </g>
+        <g id="Graphic_1042">
+          <rect x="583.937" y="570.1501" width="99" height="24" fill="white"/>
+          <rect x="583.937" y="570.1501" width="99" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(588.937 575.1501)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="32.60547" y="11">Text</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_1037">
+        <g id="Graphic_1040">
+          <rect x="165.12694" y="451.2227" width="107.71654" height="25.147357" fill="white"/>
+          <rect x="165.12694" y="451.2227" width="107.71654" height="25.147357" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(170.12694 456.2227)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10"> </tspan>
+          </text>
+        </g>
+        <g id="Graphic_1039">
+          <rect x="165.12694" y="426.07537" width="107.71654" height="25.147357" fill="white"/>
+          <rect x="165.12694" y="426.07537" width="107.71654" height="25.147357" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(170.12694 431.07537)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10"> </tspan>
+          </text>
+        </g>
+        <g id="Graphic_1038">
+          <rect x="165.12694" y="399.83465" width="107.71654" height="26.24072" fill="white"/>
+          <rect x="165.12694" y="399.83465" width="107.71654" height="26.24072" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(170.12694 404.83465)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="11.197136" y="11">ContentNode</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_1033">
+        <g id="Graphic_1036">
+          <rect x="287.06103" y="617.7638" width="121.78347" height="23" fill="white"/>
+          <rect x="287.06103" y="617.7638" width="121.78347" height="23" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(292.06103 622.7638)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10"> </tspan>
+          </text>
+        </g>
+        <g id="Graphic_1035">
+          <rect x="287.06103" y="594.7638" width="121.78347" height="23" fill="white"/>
+          <rect x="287.06103" y="594.7638" width="121.78347" height="23" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(292.06103 599.7638)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">+variableName: String</tspan>
+          </text>
+        </g>
+        <g id="Graphic_1034">
+          <rect x="287.06103" y="570.7638" width="121.78347" height="24" fill="white"/>
+          <rect x="287.06103" y="570.7638" width="121.78347" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(292.06103 575.7638)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="3.8575516" y="11">VariableReference</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_1029">
+        <g id="Graphic_1032">
+          <rect x="-39.68504" y="448.10237" width="99" height="23" fill="white"/>
+          <rect x="-39.68504" y="448.10237" width="99" height="23" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(-34.68504 453.10237)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10"> </tspan>
+          </text>
+        </g>
+        <g id="Graphic_1031">
+          <rect x="-39.68504" y="425.10237" width="99" height="23" fill="white"/>
+          <rect x="-39.68504" y="425.10237" width="99" height="23" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(-34.68504 430.10237)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10"> </tspan>
+          </text>
+        </g>
+        <g id="Graphic_1030">
+          <rect x="-39.68504" y="401.10237" width="99" height="24" fill="white"/>
+          <rect x="-39.68504" y="401.10237" width="99" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(-34.68504 406.10237)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="13.498047" y="11">Composite</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_1025">
+        <g id="Graphic_1028">
+          <rect x="822.0473" y="616.7638" width="99" height="23" fill="white"/>
+          <rect x="822.0473" y="616.7638" width="99" height="23" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(827.0473 621.7638)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10"> </tspan>
+          </text>
+        </g>
+        <g id="Graphic_1027">
+          <rect x="822.0473" y="593.7638" width="99" height="23" fill="white"/>
+          <rect x="822.0473" y="593.7638" width="99" height="23" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(827.0473 598.7638)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10"> </tspan>
+          </text>
+        </g>
+        <g id="Graphic_1026">
+          <rect x="822.0473" y="569.7638" width="99" height="24" fill="white"/>
+          <rect x="822.0473" y="569.7638" width="99" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(827.0473 574.7638)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="21.941406" y="11">LineTag</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_1021">
+        <g id="Graphic_1024">
+          <rect x="595.11024" y="741.4882" width="125.34824" height="23" fill="white"/>
+          <rect x="595.11024" y="741.4882" width="125.34824" height="23" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(600.11024 746.4882)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10"> </tspan>
+          </text>
+        </g>
+        <g id="Graphic_1023">
+          <rect x="595.11024" y="718.4882" width="125.34824" height="23" fill="white"/>
+          <rect x="595.11024" y="718.4882" width="125.34824" height="23" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(600.11024 723.4882)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">+rootElement: EObject</tspan>
+          </text>
+        </g>
+        <g id="Graphic_1022">
+          <rect x="595.11024" y="694.4882" width="125.34824" height="24" fill="white"/>
+          <rect x="595.11024" y="694.4882" width="125.34824" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(600.11024 699.4882)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="15.442677" y="11">StructuredText</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_1017">
+        <g id="Graphic_1020">
+          <rect x="408.48426" y="885.7564" width="159.56693" height="36" fill="white"/>
+          <rect x="408.48426" y="885.7564" width="159.56693" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(413.48426 890.7564)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">+memberNameSet(): boolean</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="23">+toString(): String</tspan>
+          </text>
+        </g>
+        <g id="Graphic_1019">
+          <rect x="408.48426" y="849.7564" width="159.56693" height="36" fill="white"/>
+          <rect x="408.48426" y="849.7564" width="159.56693" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(413.48426 854.7564)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">+memberName: String</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="23">+staticMember: boolean</tspan>
+          </text>
+        </g>
+        <g id="Graphic_1018">
+          <rect x="408.48426" y="825.7564" width="159.56693" height="24" fill="white"/>
+          <rect x="408.48426" y="825.7564" width="159.56693" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(413.48426 830.7564)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="12.096939" y="11">FullMemberReference</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_1013">
+        <g id="Graphic_1016">
+          <rect x="177.37796" y="629.7638" width="99" height="23" fill="white"/>
+          <rect x="177.37796" y="629.7638" width="99" height="23" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(182.37796 634.7638)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10"> </tspan>
+          </text>
+        </g>
+        <g id="Graphic_1015">
+          <rect x="177.37796" y="593.7638" width="99" height="36" fill="white"/>
+          <rect x="177.37796" y="593.7638" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(182.37796 598.7638)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">+value: String</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="23">+name: String</tspan>
+          </text>
+        </g>
+        <g id="Graphic_1014">
+          <rect x="177.37796" y="569.7638" width="99" height="24" fill="white"/>
+          <rect x="177.37796" y="569.7638" width="99" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(182.37796 574.7638)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="26.49414" y="11">Literal</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_1009">
+        <g id="Graphic_1012">
+          <rect x="693.0709" y="316.37696" width="220.88976" height="41.638554" fill="white"/>
+          <rect x="693.0709" y="316.37696" width="220.88976" height="41.638554" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(698.0709 321.37696)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">+getValueByKey(theKey: String): TagValue</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="23">+toString(): String</tspan>
+          </text>
+        </g>
+        <g id="Graphic_1011">
+          <rect x="693.0709" y="289.77456" width="220.88976" height="26.60241" fill="white"/>
+          <rect x="693.0709" y="289.77456" width="220.88976" height="26.60241" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(698.0709 294.77456)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10"> </tspan>
+          </text>
+        </g>
+        <g id="Graphic_1010">
+          <rect x="693.0709" y="262.01552" width="220.88976" height="27.759036" fill="white"/>
+          <rect x="693.0709" y="262.01552" width="220.88976" height="27.759036" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(698.0709 267.01552)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="95.22028" y="11">Tag</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_1005">
+        <g id="Graphic_1008">
+          <rect x="-83.03937" y="948.6922" width="185.4567" height="41.638554" fill="white"/>
+          <rect x="-83.03937" y="948.6922" width="185.4567" height="41.638554" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(-78.03937 953.6922)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">+hasLineTag(title: String): boolean</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="23">+lineTags(title: String): LineTag[*]</tspan>
+          </text>
+        </g>
+        <g id="Graphic_1007">
+          <rect x="-83.03937" y="922.0898" width="185.4567" height="26.60241" fill="white"/>
+          <rect x="-83.03937" y="922.0898" width="185.4567" height="26.60241" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(-78.03937 927.0898)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10"> </tspan>
+          </text>
+        </g>
+        <g id="Graphic_1006">
+          <rect x="-83.03937" y="894.3307" width="185.4567" height="27.759036" fill="white"/>
+          <rect x="-83.03937" y="894.3307" width="185.4567" height="27.759036" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(-78.03937 899.3307)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="69.39143" y="11">Doclet</tspan>
+          </text>
+        </g>
+      </g>
+    </g>
+  </g>
+</svg>
diff --git a/design/chapters/23_jsdoc/images/cd_JSDocParserAPI.svg b/design/chapters/23_jsdoc/images/cd_JSDocParserAPI.svg
new file mode 100644
index 0000000..4c3565d
--- /dev/null
+++ b/design/chapters/23_jsdoc/images/cd_JSDocParserAPI.svg
@@ -0,0 +1,573 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xl="http://www.w3.org/1999/xlink" xmlns:dc="http://purl.org/dc/elements/1.1/" viewBox="0 0 1120 783" width="1120" height="783">
+  <defs>
+    <filter id="Shadow" filterUnits="userSpaceOnUse" x="0" y="0">
+      <feGaussianBlur in="SourceAlpha" result="blur" stdDeviation="1.308"/>
+      <feOffset in="blur" result="offset" dx="0" dy="2"/>
+      <feFlood flood-color="black" flood-opacity=".5" result="flood"/>
+      <feComposite in="flood" in2="offset" operator="in"/>
+    </filter>
+    <font-face font-family="Helvetica" font-size="12" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="13" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="532.22656" cap-height="719.7266" ascent="770.0195" descent="-229.98047" font-weight="700">
+      <font-face-src>
+        <font-face-name name="Helvetica-Bold"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="10" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="StickArrow_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -4 10 8" markerWidth="10" markerHeight="8" color="black">
+      <g>
+        <path d="M 8 0 L 0 0 M 0 -3 L 8 0 L 0 3" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="StickArrow_Marker_2" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -4 10 8" markerWidth="10" markerHeight="8" color="#3d61c2">
+      <g>
+        <path d="M 8 0 L 0 0 M 0 -3 L 8 0 L 0 3" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="UMLInheritance_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -8 14 16" markerWidth="14" markerHeight="16" color="black">
+      <g>
+        <path d="M 12 0 L 0 -7 L 0 7 Z" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="UMLInheritance_Marker_2" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -8 14 16" markerWidth="14" markerHeight="16" color="#3d61c2">
+      <g>
+        <path d="M 12 0 L 0 -7 L 0 7 Z" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <font-face font-family="Helvetica" font-size="12" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="532.22656" cap-height="719.7266" ascent="770.0195" descent="-229.98047" font-weight="700">
+      <font-face-src>
+        <font-face-name name="Helvetica-Bold"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="8" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="11" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="12" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="-1e3" x-height="539.5508" cap-height="719.7266" ascent="770.0195" descent="-229.98047" font-style="italic" font-weight="700">
+      <font-face-src>
+        <font-face-name name="Helvetica-BoldOblique"/>
+      </font-face-src>
+    </font-face>
+  </defs>
+  <metadata> Produced by OmniGraffle 7.11 
+    <dc:date>2019-07-31 13:40:17 +0000</dc:date>
+  </metadata>
+  <g id="Canvas_1" stroke="none" stroke-opacity="1" stroke-dasharray="none" fill="none" fill-opacity="1">
+    <title>Canvas 1</title>
+    <rect fill="white" x="0" y="0" width="1120" height="783"/>
+    <g id="Canvas_1: Layer 1">
+      <title>Layer 1</title>
+      <g id="Graphic_324_shadow" filter="url(#Shadow)">
+        <rect x="779" y="135" width="80" height="76" fill="white"/>
+        <rect x="779" y="135" width="80" height="76" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_294">
+        <path d="M 859 54.75079 C 859 47.55131 855.8885 46.66059 833.15985 39.53559 L 832.91975 39.46187 C 810.07105 32.262392 809.8334 32.262392 786.38445 32.262392 C 755.16165 32.262392 614 32.262392 614 32.262392 L 614 108.26239 L 859 108.26239 L 859 54.75079 Z" fill="white"/>
+        <path d="M 859 54.75079 C 859 47.55131 855.8885 46.66059 833.15985 39.53559 L 832.91975 39.46187 C 810.07105 32.262392 809.8334 32.262392 786.38445 32.262392 C 755.16165 32.262392 614 32.262392 614 32.262392 L 614 108.26239 L 859 108.26239 L 859 54.75079 Z M 859 54.37991 C 859 47.55131 858.7599 47.55131 809.8334 47.55131 L 809.8334 47.55131 C 809.8334 32.336872 809.8334 32.262392 787.82015 32.262392" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(619 37.26239)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="11">package</tspan>
+          <tspan font-family="Helvetica" font-size="13" font-weight="700" fill="black" x="0" y="27">org.eclipse.n4js.jsdoc and others</tspan>
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="40">Scopes shown: public, </tspan>
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="52">Omitted methods: getter and setter, overriding </tspan>
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="64">methods,</tspan>
+        </text>
+      </g>
+      <g id="Line_293">
+        <line x1="145.91235" y1="205.7143" x2="184.8246" y2="236.41464" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_286">
+        <line x1="333.0846" y1="110.26239" x2="348.72543" y2="136.69423" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_276">
+        <line x1="333.94473" y1="214.21429" x2="308.4162" y2="236.1027" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_274">
+        <line x1="506.4658" y1="214.21429" x2="541.42043" y2="223.33058" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_271">
+        <line x1="240.36444" y1="179.7143" x2="214.35772" y2="179.7143" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_260">
+        <line x1="306.4805" y1="683" x2="275.76072" y2="713.9712" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_259">
+        <line x1="392" y1="272.75087" x2="541.1491" y2="257.84034" marker-end="url(#StickArrow_Marker_2)" stroke="#3d61c2" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_258">
+        <line x1="381.9278" y1="683" x2="414.166" y2="705.3581" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_251">
+        <path d="M 637 551.379 L 637 528.879 L 570 528.879 L 570 520.5467" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_250">
+        <path d="M 793.5 445.37903 L 793.5 419.87903 L 637 419.87903 L 637 406.90237" marker-end="url(#UMLInheritance_Marker_2)" stroke="#3d61c2" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_249">
+        <path d="M 675.5 445.37903 L 675.5 419.87903 L 637 419.87903 L 637 406.90237" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_248">
+        <path d="M 538.5158 551.379 L 538.5158 535.879 L 538.5158 528.879 L 570 528.879 L 570 522.5467 L 570 520.5467" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_247">
+        <path d="M 249.25388 368.37906 L 249.25388 352.87906 L 249.55553 347.04668 L 249.55553 345.04668" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_246">
+        <path d="M 570 445.0467 L 570 419.5467 L 637 419.5467 L 637 406.90237" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_245">
+        <path d="M 452.5 445.37903 L 452.5 419.87903 L 637 419.87903 L 637 406.90237" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_244">
+        <path d="M 337.23413 621 L 337.23413 605.5 L 337.2406 598.5 L 337.2406 596.5" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_243">
+        <line x1="637" y1="331.40237" x2="637" y2="293.25806" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Group_239">
+        <g id="Graphic_242">
+          <rect x="21.457718" y="191.7143" width="183" height="14" fill="#ffafaa" fill-opacity=".5"/>
+          <rect x="21.457718" y="191.7143" width="183" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_241">
+          <rect x="21.457718" y="177.7143" width="183" height="14" fill="#ffafaa" fill-opacity=".5"/>
+          <rect x="21.457718" y="177.7143" width="183" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_240">
+          <rect x="21.457718" y="153.7143" width="183" height="24" fill="#ffafaa" fill-opacity=".5"/>
+          <rect x="21.457718" y="153.7143" width="183" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(26.830765 158.7143)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="0" y="11">TagDictionary&lt;ITagDefinition&gt;</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_232">
+        <g id="Graphic_235">
+          <rect x="578.5" y="599.379" width="117" height="14" fill="#76f2a3" fill-opacity=".52"/>
+          <rect x="578.5" y="599.379" width="117" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_234">
+          <rect x="578.5" y="585.379" width="117" height="14" fill="#76f2a3" fill-opacity=".52"/>
+          <rect x="578.5" y="585.379" width="117" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_233">
+          <rect x="578.5" y="551.379" width="117" height="34" fill="#76f2a3" fill-opacity=".52"/>
+          <rect x="578.5" y="551.379" width="117" height="34" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(583.542 556.379)" fill="black">
+            <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="34.11621" y="8">tokenizers.</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="0" y="21">InlineTagTokenizer</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_225">
+        <g id="Graphic_228">
+          <rect x="186" y="759" width="114" height="14" fill="#76f2a3" fill-opacity=".52"/>
+          <rect x="186" y="759" width="114" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_227">
+          <rect x="186" y="745" width="114" height="14" fill="#76f2a3" fill-opacity=".52"/>
+          <rect x="186" y="745" width="114" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_226">
+          <rect x="186" y="721" width="114" height="24" fill="#76f2a3" fill-opacity=".52"/>
+          <rect x="186" y="721" width="114" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(191.31152 726)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="0" y="11">DescriptionParser</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_211">
+        <g id="Graphic_214">
+          <rect x="230.86444" y="56.26239" width="150" height="54" fill="#ffafaa" fill-opacity=".5"/>
+          <rect x="230.86444" y="56.26239" width="150" height="54" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(235.86444 57.26239)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">+isAdapterForType(Object)</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="23">+notifyChanged(Notification)</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="36">+getTarget()</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="49">+setTarget(Notifier)</tspan>
+          </text>
+        </g>
+        <g id="Graphic_213">
+          <rect x="230.86444" y="42.26239" width="150" height="14" fill="#ffafaa" fill-opacity=".5"/>
+          <rect x="230.86444" y="42.26239" width="150" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_212">
+          <rect x="230.86444" y="18.262392" width="150" height="24" fill="#ffafaa" fill-opacity=".5"/>
+          <rect x="230.86444" y="18.262392" width="150" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(235.86444 23.262392)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="28.993164" y="11">DocletAdapter</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_204">
+        <g id="Graphic_207">
+          <rect x="728" y="493.379" width="131" height="14" fill="#76f2a3" fill-opacity=".52"/>
+          <rect x="728" y="493.379" width="131" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_206">
+          <rect x="728" y="479.379" width="131" height="14" fill="#76f2a3" fill-opacity=".52"/>
+          <rect x="728" y="479.379" width="131" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_205">
+          <rect x="728" y="445.37903" width="131" height="34" fill="#76f2a3" fill-opacity=".52"/>
+          <rect x="728" y="445.37903" width="131" height="34" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(733.2598 450.37903)" fill="black">
+            <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="40.898438" y="8">tokenizers.</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="0" y="21">JSIdentifierTokenizer</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_197">
+        <g id="Graphic_200">
+          <rect x="551" y="264.75806" width="172" height="15" fill="#76f2a3" fill-opacity=".52"/>
+          <rect x="551" y="264.75806" width="172" height="15" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(556 265.75806)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">+nextToken(JSDocCharScanner)</tspan>
+          </text>
+        </g>
+        <g id="Graphic_199">
+          <rect x="551" y="250.75806" width="172" height="14" fill="#76f2a3" fill-opacity=".52"/>
+          <rect x="551" y="250.75806" width="172" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_198">
+          <rect x="551" y="216.75806" width="172" height="34" fill="#76f2a3" fill-opacity=".52"/>
+          <rect x="551" y="216.75806" width="172" height="34" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(556 221.75806)" fill="black">
+            <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="61.208984" y="8">«interface»</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="33.09375" y="21">IJSDocTokenizer</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_176">
+        <g id="Graphic_179">
+          <rect x="631" y="493.379" width="89" height="14" fill="#76f2a3" fill-opacity=".52"/>
+          <rect x="631" y="493.379" width="89" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_178">
+          <rect x="631" y="479.379" width="89" height="14" fill="#76f2a3" fill-opacity=".52"/>
+          <rect x="631" y="479.379" width="89" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_177">
+          <rect x="631" y="445.37903" width="89" height="34" fill="#76f2a3" fill-opacity=".52"/>
+          <rect x="631" y="445.37903" width="89" height="34" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(636.04004 450.37903)" fill="black">
+            <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="20.118164" y="8">tokenizers.</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="0" y="21">TextTokenizer</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_169">
+        <g id="Graphic_172">
+          <rect x="397" y="759" width="140" height="14" fill="#76f2a3" fill-opacity=".52"/>
+          <rect x="397" y="759" width="140" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_171">
+          <rect x="397" y="745" width="140" height="14" fill="#76f2a3" fill-opacity=".52"/>
+          <rect x="397" y="745" width="140" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_170">
+          <rect x="397" y="711" width="140" height="34" fill="#76f2a3" fill-opacity=".52"/>
+          <rect x="397" y="711" width="140" height="34" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(402.4092 716)" fill="black">
+            <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="36.575195" y="8">typeexpression.</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="0" y="21">TypeExpressionParser</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_162">
+        <g id="Graphic_165">
+          <rect x="240.36444" y="199.21429" width="267.63556" height="15" fill="#ffafaa" fill-opacity=".5"/>
+          <rect x="240.36444" y="199.21429" width="267.63556" height="15" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(245.36444 200.21429)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">+parse(String)</tspan>
+          </text>
+        </g>
+        <g id="Graphic_164">
+          <rect x="240.36444" y="169.21429" width="267.63556" height="30" fill="#ffafaa" fill-opacity=".5"/>
+          <rect x="240.36444" y="169.21429" width="267.63556" height="30" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(245.36444 170.21429)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="17.422272" y="11">TagDictionary&lt;AbstractLineTagDefinition&gt;</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="14.422272" y="25">TagDictionary&lt;AbstractInlineTagDefinition&gt;</tspan>
+          </text>
+        </g>
+        <g id="Graphic_163">
+          <rect x="240.36444" y="145.21429" width="267.63556" height="24" fill="#ffafaa" fill-opacity=".5"/>
+          <rect x="240.36444" y="145.21429" width="267.63556" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(245.36444 150.21429)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="91.79825" y="11">DocletParser</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_155">
+        <g id="Graphic_158">
+          <rect x="106" y="290.54668" width="286" height="41" fill="#ffafaa" fill-opacity=".5"/>
+          <rect x="106" y="290.54668" width="286" height="41" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(111 291.54668)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">+getTitles()</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="23">+parse(TagTitle, JSDocCharScanner, DescriptionParser)</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="36">+validate()</tspan>
+          </text>
+        </g>
+        <g id="Graphic_157">
+          <rect x="106" y="276.54668" width="286" height="14" fill="#ffafaa" fill-opacity=".5"/>
+          <rect x="106" y="276.54668" width="286" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_156">
+          <rect x="106" y="242.54668" width="286" height="34" fill="#ffafaa" fill-opacity=".5"/>
+          <rect x="106" y="242.54668" width="286" height="34" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(111 247.54668)" fill="black">
+            <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="118.20898" y="8">«interface»</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="98.44629" y="21">ITagDefinition</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_148">
+        <g id="Graphic_151">
+          <rect x="470" y="599.379" width="93" height="14" fill="#76f2a3" fill-opacity=".52"/>
+          <rect x="470" y="599.379" width="93" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_150">
+          <rect x="470" y="585.379" width="93" height="14" fill="#76f2a3" fill-opacity=".52"/>
+          <rect x="470" y="585.379" width="93" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_149">
+          <rect x="470" y="551.379" width="93" height="34" fill="#76f2a3" fill-opacity=".52"/>
+          <rect x="470" y="551.379" width="93" height="34" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(475.37305 556.379)" fill="black">
+            <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="21.785156" y="8">tokenizers.</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="0" y="21">TypeTokenizer</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_141">
+        <g id="Graphic_144">
+          <rect x="167" y="416.37906" width="164" height="14" fill="white"/>
+          <rect x="167" y="416.37906" width="164" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_143">
+          <rect x="167" y="402.37906" width="164" height="14" fill="white"/>
+          <rect x="167" y="402.37906" width="164" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_142">
+          <rect x="167" y="368.37906" width="164" height="34" fill="white"/>
+          <rect x="167" y="368.37906" width="164" height="34" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(172.4297 373.37906)" fill="black">
+            <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="67.89844" y="8">tags.</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-style="italic" font-weight="700" fill="black" x="0" y="21">AbstractBaseTagDefinition</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_134">
+        <g id="Graphic_137">
+          <rect x="517" y="493.0467" width="106" height="14" fill="#76f2a3" fill-opacity=".52"/>
+          <rect x="517" y="493.0467" width="106" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_136">
+          <rect x="517" y="479.0467" width="106" height="14" fill="#76f2a3" fill-opacity=".52"/>
+          <rect x="517" y="479.0467" width="106" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_135">
+          <rect x="517" y="445.0467" width="106" height="34" fill="#76f2a3" fill-opacity=".52"/>
+          <rect x="517" y="445.0467" width="106" height="34" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(522.10254 450.0467)" fill="black">
+            <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="28.555664" y="8">tokenizers.</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="0" y="21">RegionTokenizer</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_127">
+        <g id="Graphic_130">
+          <rect x="397" y="493.379" width="111" height="14" fill="#76f2a3" fill-opacity=".52"/>
+          <rect x="397" y="493.379" width="111" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_129">
+          <rect x="397" y="479.379" width="111" height="14" fill="#76f2a3" fill-opacity=".52"/>
+          <rect x="397" y="479.379" width="111" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_128">
+          <rect x="397" y="445.37903" width="111" height="34" fill="#76f2a3" fill-opacity=".52"/>
+          <rect x="397" y="445.37903" width="111" height="34" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(402.48145 450.37903)" fill="black">
+            <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="30.676758" y="8">tokenizers.</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="0" y="21">TagTitleTokenizer</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_113">
+        <g id="Graphic_116">
+          <rect x="414" y="56.26239" width="108" height="28" fill="white"/>
+          <rect x="414" y="56.26239" width="108" height="28" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(419 57.26239)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">+doSwitch(EObject)</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="23">...</tspan>
+          </text>
+        </g>
+        <g id="Graphic_115">
+          <rect x="414" y="42.26239" width="108" height="14" fill="white"/>
+          <rect x="414" y="42.26239" width="108" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_114">
+          <rect x="414" y="18.262392" width="108" height="24" fill="white"/>
+          <rect x="414" y="18.262392" width="108" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(419 23.262392)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="3.642578" y="11">JSDocSerializer</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_106">
+        <g id="Graphic_109">
+          <rect x="275.72885" y="669" width="123" height="14" fill="#c4dcfa" fill-opacity=".51"/>
+          <rect x="275.72885" y="669" width="123" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_108">
+          <rect x="275.72885" y="655" width="123" height="14" fill="#c4dcfa" fill-opacity=".51"/>
+          <rect x="275.72885" y="655" width="123" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_107">
+          <rect x="275.72885" y="621" width="123" height="34" fill="#c4dcfa" fill-opacity=".51"/>
+          <rect x="275.72885" y="621" width="123" height="34" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(280.99643 626)" fill="black">
+            <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="47.560547" y="8">tags.</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="0" y="21">ParamTagDefinition</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_99">
+        <g id="Graphic_102">
+          <rect x="561" y="379.40237" width="152" height="14" fill="white"/>
+          <rect x="561" y="379.40237" width="152" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_101">
+          <rect x="561" y="365.40237" width="152" height="14" fill="white"/>
+          <rect x="561" y="365.40237" width="152" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_100">
+          <rect x="561" y="331.40237" width="152" height="34" fill="white"/>
+          <rect x="561" y="331.40237" width="152" height="34" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(566.4209 336.40237)" fill="black">
+            <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="51.237305" y="8">tokenizers.</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-style="italic" font-weight="700" fill="black" x="0" y="21">AbstractJSDocTokenizer</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_316">
+        <g id="Graphic_324">
+          <rect x="779" y="135" width="80" height="76" fill="white"/>
+          <rect x="779" y="135" width="80" height="76" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_323">
+          <text transform="translate(806.5954 157.04958)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="11">core</tspan>
+          </text>
+        </g>
+        <g id="Graphic_322">
+          <text transform="translate(806.5954 172.20277)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="11">helper</tspan>
+          </text>
+        </g>
+        <g id="Graphic_321">
+          <text transform="translate(795.112 140)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="0" y="11">Legend</tspan>
+          </text>
+        </g>
+        <g id="Graphic_320">
+          <rect x="787" y="157.48783" width="13.1235" height="13.1235" fill="#ffafaa" fill-opacity=".5"/>
+          <rect x="787" y="157.48783" width="13.1235" height="13.1235" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_319">
+          <rect x="787" y="172.64103" width="13.1235" height="13.1235" fill="#76f2a3" fill-opacity=".52"/>
+          <rect x="787" y="172.64103" width="13.1235" height="13.1235" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_318">
+          <rect x="787" y="187.79422" width="13.1235" height="13.1235" fill="#c4dcfa" fill-opacity=".51"/>
+          <rect x="787" y="187.79422" width="13.1235" height="13.1235" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_317">
+          <text transform="translate(806.5954 187.35596)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="11">plugable</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_325">
+        <g id="Graphic_328">
+          <rect x="32.457716" y="567" width="172" height="14" fill="white"/>
+          <rect x="32.457716" y="567" width="172" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_327">
+          <rect x="32.457716" y="553" width="172" height="14" fill="white"/>
+          <rect x="32.457716" y="553" width="172" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_326">
+          <rect x="32.457716" y="519" width="172" height="34" fill="white"/>
+          <rect x="32.457716" y="519" width="172" height="34" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(37.457716 524)" fill="black">
+            <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="72.328125" y="8">tags.</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-style="italic" font-weight="700" fill="black" x="3.1054688" y="21">AbstractInlineTagDefinition</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_329">
+        <g id="Graphic_332">
+          <rect x="219.95772" y="569" width="234.5423" height="14" fill="white"/>
+          <rect x="219.95772" y="569" width="234.5423" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_331">
+          <rect x="219.95772" y="553" width="234.5423" height="16" fill="white"/>
+          <rect x="219.95772" y="553" width="234.5423" height="16" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(224.95772 554)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="1.8717346" y="11">List&lt;ITagDefinition&gt; descriptionInlineTags</tspan>
+          </text>
+        </g>
+        <g id="Graphic_330">
+          <rect x="219.95772" y="519" width="234.5423" height="34" fill="white"/>
+          <rect x="219.95772" y="519" width="234.5423" height="34" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(224.95772 524)" fill="black">
+            <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="103.59927" y="8">tags.</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-style="italic" font-weight="700" fill="black" x="37.7106" y="21">AbstractLineTagDefinition</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Line_333">
+        <path d="M 118.45772 519 L 118.45772 474.5 L 249 474.5 L 249 443.87906" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_334">
+        <path d="M 318.6103 519 L 318.6103 503.5 L 318.6103 474.5 L 267.04794 474.5 L 267.04794 445.87906 L 267.04794 443.87906" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Group_335">
+        <g id="Graphic_338">
+          <rect x="62.95772" y="667" width="111" height="14" fill="#c4dcfa" fill-opacity=".51"/>
+          <rect x="62.95772" y="667" width="111" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_337">
+          <rect x="62.95772" y="653" width="111" height="14" fill="#c4dcfa" fill-opacity=".51"/>
+          <rect x="62.95772" y="653" width="111" height="14" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_336">
+          <rect x="62.95772" y="619" width="111" height="34" fill="#c4dcfa" fill-opacity=".51"/>
+          <rect x="62.95772" y="619" width="111" height="34" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(68.237015 624)" fill="black">
+            <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="41.54883" y="8">tags.</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="0" y="21">LinkTagDefinition</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Line_339">
+        <path d="M 118.45602 619 L 118.45602 603.5 L 118.45394 596.5 L 118.45394 594.5" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+    </g>
+  </g>
+</svg>
diff --git a/design/chapters/23_jsdoc/images/cd_JSDocParserAndModel.svg b/design/chapters/23_jsdoc/images/cd_JSDocParserAndModel.svg
new file mode 100644
index 0000000..0d5de8d
--- /dev/null
+++ b/design/chapters/23_jsdoc/images/cd_JSDocParserAndModel.svg
@@ -0,0 +1,631 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xl="http://www.w3.org/1999/xlink" xmlns:dc="http://purl.org/dc/elements/1.1/" viewBox="9.674454 17.958201 1058.9128 589.4749" width="1058.9128" height="589.4749">
+  <defs>
+    <filter id="Shadow" filterUnits="userSpaceOnUse" x="9.674454" y="17.958201">
+      <feGaussianBlur in="SourceAlpha" result="blur" stdDeviation="1.308"/>
+      <feOffset in="blur" result="offset" dx="0" dy="2"/>
+      <feFlood flood-color="black" flood-opacity=".5" result="flood"/>
+      <feComposite in="flood" in2="offset" operator="in"/>
+    </filter>
+    <linearGradient x1="0" x2="1" id="Gradient" gradientUnits="userSpaceOnUse">
+      <stop offset="0" stop-color="#ff295a"/>
+      <stop offset="1" stop-color="#ffbcae"/>
+    </linearGradient>
+    <linearGradient id="Obj_Gradient" xl:href="#Gradient" gradientTransform="translate(190.14203 355.86284) rotate(91) scale(16.27682)"/>
+    <linearGradient x1="0" x2="1" id="Gradient_2" gradientUnits="userSpaceOnUse">
+      <stop offset="0" stop-color="#76d6ff"/>
+      <stop offset="1" stop-color="#0080ff"/>
+    </linearGradient>
+    <linearGradient id="Obj_Gradient_2" xl:href="#Gradient_2" gradientTransform="translate(210.51411 220.76132) rotate(90) scale(16.000019)"/>
+    <linearGradient id="Obj_Gradient_3" xl:href="#Gradient_2" gradientTransform="translate(174.57983 473.52605) rotate(90) scale(16.000019)"/>
+    <linearGradient x1="0" x2="1" id="Gradient_3" gradientUnits="userSpaceOnUse">
+      <stop offset="0" stop-color="#ff295a"/>
+      <stop offset="1" stop-color="#ffbcae"/>
+    </linearGradient>
+    <linearGradient id="Obj_Gradient_4" xl:href="#Gradient_3" gradientTransform="translate(381.79504 578.6721) rotate(90) scale(16.000019)"/>
+    <linearGradient id="Obj_Gradient_5" xl:href="#Gradient_2" gradientTransform="translate(381.54504 555) rotate(90) scale(16.000019)"/>
+    <font-face font-family="Helvetica" font-size="11" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="12" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="532.22656" cap-height="719.7266" ascent="770.0195" descent="-229.98047" font-weight="700">
+      <font-face-src>
+        <font-face-name name="Helvetica-Bold"/>
+      </font-face-src>
+    </font-face>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="UMLInheritance_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -8 14 16" markerWidth="14" markerHeight="16" color="black">
+      <g>
+        <path d="M 12 0 L 0 -7 L 0 7 Z" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="StickArrow_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -4 10 8" markerWidth="10" markerHeight="8" color="black">
+      <g>
+        <path d="M 8 0 L 0 0 M 0 -3 L 8 0 L 0 3" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <font-face font-family="Helvetica" font-size="10" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="9" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="FilledDiamond_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-9 -4 10 8" markerWidth="10" markerHeight="8" color="black">
+      <g>
+        <path d="M -8 0 L -4 3 L 0 0 L -4 -3 Z" fill="currentColor" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <font-face font-family="Helvetica" font-size="12" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <linearGradient id="Obj_Gradient_6" xl:href="#Gradient" gradientTransform="translate(190.14203 355.86284) rotate(91) scale(16.27682)"/>
+    <linearGradient id="Obj_Gradient_7" xl:href="#Gradient_2" gradientTransform="translate(210.51411 220.76132) rotate(90) scale(16.000019)"/>
+    <linearGradient id="Obj_Gradient_8" xl:href="#Gradient_2" gradientTransform="translate(174.57983 473.52605) rotate(90) scale(16.000019)"/>
+    <linearGradient id="Obj_Gradient_9" xl:href="#Gradient_2" gradientTransform="translate(381.54504 555) rotate(90) scale(16.000019)"/>
+    <linearGradient id="Obj_Gradient_10" xl:href="#Gradient_3" gradientTransform="translate(381.79504 578.6721) rotate(90) scale(16.000019)"/>
+  </defs>
+  <metadata> Produced by OmniGraffle 7.11 
+    <dc:date>2019-07-31 13:39:28 +0000</dc:date>
+  </metadata>
+  <g id="Canvas_1" stroke="none" stroke-opacity="1" stroke-dasharray="none" fill="none" fill-opacity="1">
+    <title>Canvas 1</title>
+    <rect fill="white" x="9.674454" y="17.958201" width="1058.9128" height="589.4749"/>
+    <g id="Canvas_1: Layer 1">
+      <title>Layer 1</title>
+      <g id="Graphic_3924_shadow" filter="url(#Shadow)">
+        <path d="M 186.21053 372 C 186.21053 371.35347 186.45718 370.70693 186.95046 370.21363 C 187.93706 369.22704 189.53663 369.22704 190.52322 370.21363 C 191.0165 370.70693 191.26316 371.35347 191.26316 372 L 193.60234 372 C 194.63586 372 195.47368 371.1622 195.47368 370.12867 L 195.47368 367.7895 C 196.12022 367.7895 196.76677 367.54283 197.26005 367.04955 C 198.24666 366.06296 198.24666 364.4634 197.26005 363.4768 C 196.76677 362.9835 196.12022 362.73685 195.4737 362.73685 L 195.47368 362.73685 L 195.47368 360.39767 C 195.47368 359.36415 194.63586 358.52632 193.60234 358.52632 L 191.26316 358.52632 L 191.26316 358.52632 C 191.26316 357.87978 191.0165 357.23323 190.52322 356.73995 C 189.53663 355.75334 187.93706 355.75334 186.95046 356.73995 C 186.45718 357.23323 186.21053 357.87978 186.21053 358.52632 L 183.87134 358.52632 C 182.83782 358.52632 182 359.36415 182 360.39767 L 182 362.73685 C 182.64654 362.73685 183.29309 362.9835 183.78638 363.4768 C 184.77296 364.4634 184.77296 366.06296 183.78638 367.04955 C 183.29309 367.54283 182.64654 367.7895 182 367.7895 L 182 367.7895 L 182 370.12867 C 182 371.1622 182.83782 372 183.87134 372 L 186.21053 372 Z" fill="url(#Obj_Gradient)"/>
+        <path d="M 186.21053 372 C 186.21053 371.35347 186.45718 370.70693 186.95046 370.21363 C 187.93706 369.22704 189.53663 369.22704 190.52322 370.21363 C 191.0165 370.70693 191.26316 371.35347 191.26316 372 L 193.60234 372 C 194.63586 372 195.47368 371.1622 195.47368 370.12867 L 195.47368 367.7895 C 196.12022 367.7895 196.76677 367.54283 197.26005 367.04955 C 198.24666 366.06296 198.24666 364.4634 197.26005 363.4768 C 196.76677 362.9835 196.12022 362.73685 195.4737 362.73685 L 195.47368 362.73685 L 195.47368 360.39767 C 195.47368 359.36415 194.63586 358.52632 193.60234 358.52632 L 191.26316 358.52632 L 191.26316 358.52632 C 191.26316 357.87978 191.0165 357.23323 190.52322 356.73995 C 189.53663 355.75334 187.93706 355.75334 186.95046 356.73995 C 186.45718 357.23323 186.21053 357.87978 186.21053 358.52632 L 183.87134 358.52632 C 182.83782 358.52632 182 359.36415 182 360.39767 L 182 362.73685 C 182.64654 362.73685 183.29309 362.9835 183.78638 363.4768 C 184.77296 364.4634 184.77296 366.06296 183.78638 367.04955 C 183.29309 367.54283 182.64654 367.7895 182 367.7895 L 182 367.7895 L 182 370.12867 C 182 371.1622 182.83782 372 183.87134 372 L 186.21053 372 Z" stroke="#f63007" stroke-linecap="round" stroke-linejoin="round" stroke-width="2"/>
+      </g>
+      <g id="Graphic_3929_shadow" filter="url(#Shadow)">
+        <path d="M 206.72464 236.76134 C 206.72464 236.1148 206.9713 235.46825 207.46458 234.97495 C 208.45117 233.98836 210.05074 233.98836 211.03733 234.97495 C 211.53062 235.46825 211.77727 236.1148 211.77727 236.76134 L 214.11645 236.76134 C 215.14997 236.76134 215.9878 235.92352 215.9878 234.89 L 215.9878 232.5508 C 216.63434 232.5508 217.28088 232.30415 217.77416 231.81087 C 218.76077 230.82428 218.76077 229.2247 217.77416 228.23812 C 217.28088 227.74482 216.63434 227.49817 215.9878 227.49817 L 215.9878 227.49817 L 215.9878 225.159 C 215.9878 224.12547 215.14997 223.28764 214.11645 223.28764 L 211.77727 223.28764 L 211.77727 223.28764 C 211.77727 222.6411 211.53062 221.99456 211.03733 221.50127 C 210.05074 220.51467 208.45117 220.51467 207.46458 221.50127 C 206.9713 221.99456 206.72464 222.6411 206.72464 223.28764 L 204.38546 223.28764 C 203.35194 223.28764 202.51411 224.12547 202.51411 225.159 L 202.51411 227.49817 C 203.16066 227.49817 203.8072 227.74482 204.3005 228.23812 C 205.28707 229.2247 205.28707 230.82428 204.3005 231.81087 C 203.8072 232.30415 203.16066 232.5508 202.51411 232.5508 L 202.51411 232.5508 L 202.51411 234.89 C 202.51411 235.92352 203.35194 236.76134 204.38546 236.76134 L 206.72464 236.76134 Z" fill="url(#Obj_Gradient_2)"/>
+        <path d="M 206.72464 236.76134 C 206.72464 236.1148 206.9713 235.46825 207.46458 234.97495 C 208.45117 233.98836 210.05074 233.98836 211.03733 234.97495 C 211.53062 235.46825 211.77727 236.1148 211.77727 236.76134 L 214.11645 236.76134 C 215.14997 236.76134 215.9878 235.92352 215.9878 234.89 L 215.9878 232.5508 C 216.63434 232.5508 217.28088 232.30415 217.77416 231.81087 C 218.76077 230.82428 218.76077 229.2247 217.77416 228.23812 C 217.28088 227.74482 216.63434 227.49817 215.9878 227.49817 L 215.9878 227.49817 L 215.9878 225.159 C 215.9878 224.12547 215.14997 223.28764 214.11645 223.28764 L 211.77727 223.28764 L 211.77727 223.28764 C 211.77727 222.6411 211.53062 221.99456 211.03733 221.50127 C 210.05074 220.51467 208.45117 220.51467 207.46458 221.50127 C 206.9713 221.99456 206.72464 222.6411 206.72464 223.28764 L 204.38546 223.28764 C 203.35194 223.28764 202.51411 224.12547 202.51411 225.159 L 202.51411 227.49817 C 203.16066 227.49817 203.8072 227.74482 204.3005 228.23812 C 205.28707 229.2247 205.28707 230.82428 204.3005 231.81087 C 203.8072 232.30415 203.16066 232.5508 202.51411 232.5508 L 202.51411 232.5508 L 202.51411 234.89 C 202.51411 235.92352 203.35194 236.76134 204.38546 236.76134 L 206.72464 236.76134 Z" stroke="#0052ff" stroke-linecap="round" stroke-linejoin="round" stroke-width="2"/>
+      </g>
+      <g id="Graphic_3921_shadow" filter="url(#Shadow)">
+        <path d="M 170.79036 489.52607 C 170.79036 488.8795 171.03702 488.233 171.5303 487.7397 C 172.5169 486.7531 174.11646 486.7531 175.10305 487.7397 C 175.59634 488.233 175.843 488.8795 175.843 489.52607 L 178.18217 489.52607 C 179.2157 489.52607 180.05351 488.68824 180.05351 487.6547 L 180.05351 485.31554 C 180.70006 485.31554 181.3466 485.0689 181.83988 484.5756 C 182.8265 483.589 182.8265 481.98943 181.83988 481.00285 C 181.3466 480.50955 180.70006 480.2629 180.05353 480.2629 L 180.05351 480.2629 L 180.05351 477.9237 C 180.05351 476.8902 179.2157 476.0524 178.18217 476.0524 L 175.843 476.0524 L 175.843 476.0524 C 175.843 475.40583 175.59634 474.7593 175.10305 474.266 C 174.11646 473.2794 172.5169 473.2794 171.5303 474.266 C 171.03702 474.7593 170.79036 475.40583 170.79036 476.0524 L 168.45118 476.0524 C 167.41766 476.0524 166.57983 476.8902 166.57983 477.9237 L 166.57983 480.2629 C 167.22638 480.2629 167.87292 480.50955 168.36622 481.00285 C 169.3528 481.98943 169.3528 483.589 168.36622 484.5756 C 167.87292 485.0689 167.22638 485.31554 166.57983 485.31554 L 166.57983 485.31554 L 166.57983 487.6547 C 166.57983 488.68824 167.41766 489.52607 168.45118 489.52607 L 170.79036 489.52607 Z" fill="url(#Obj_Gradient_3)"/>
+        <path d="M 170.79036 489.52607 C 170.79036 488.8795 171.03702 488.233 171.5303 487.7397 C 172.5169 486.7531 174.11646 486.7531 175.10305 487.7397 C 175.59634 488.233 175.843 488.8795 175.843 489.52607 L 178.18217 489.52607 C 179.2157 489.52607 180.05351 488.68824 180.05351 487.6547 L 180.05351 485.31554 C 180.70006 485.31554 181.3466 485.0689 181.83988 484.5756 C 182.8265 483.589 182.8265 481.98943 181.83988 481.00285 C 181.3466 480.50955 180.70006 480.2629 180.05353 480.2629 L 180.05351 480.2629 L 180.05351 477.9237 C 180.05351 476.8902 179.2157 476.0524 178.18217 476.0524 L 175.843 476.0524 L 175.843 476.0524 C 175.843 475.40583 175.59634 474.7593 175.10305 474.266 C 174.11646 473.2794 172.5169 473.2794 171.5303 474.266 C 171.03702 474.7593 170.79036 475.40583 170.79036 476.0524 L 168.45118 476.0524 C 167.41766 476.0524 166.57983 476.8902 166.57983 477.9237 L 166.57983 480.2629 C 167.22638 480.2629 167.87292 480.50955 168.36622 481.00285 C 169.3528 481.98943 169.3528 483.589 168.36622 484.5756 C 167.87292 485.0689 167.22638 485.31554 166.57983 485.31554 L 166.57983 485.31554 L 166.57983 487.6547 C 166.57983 488.68824 167.41766 489.52607 168.45118 489.52607 L 170.79036 489.52607 Z" stroke="#0052ff" stroke-linecap="round" stroke-linejoin="round" stroke-width="2"/>
+      </g>
+      <g id="Graphic_3939_shadow" filter="url(#Shadow)">
+        <path d="M 378.00557 594.67214 C 378.00557 594.0256 378.25223 593.37905 378.7455 592.88575 C 379.7321 591.89916 381.33167 591.89916 382.31826 592.88575 C 382.81155 593.37905 383.0582 594.0256 383.0582 594.67214 L 385.3974 594.67214 C 386.4309 594.67214 387.26872 593.8343 387.26872 592.8008 L 387.26872 590.4616 C 387.91527 590.4616 388.5618 590.21495 389.0551 589.7217 C 390.0417 588.7351 390.0417 587.1355 389.0551 586.1489 C 388.5618 585.6556 387.91527 585.409 387.26874 585.409 L 387.26872 585.409 L 387.26872 583.0698 C 387.26872 582.0363 386.4309 581.19844 385.3974 581.19844 L 383.0582 581.19844 L 383.0582 581.19844 C 383.0582 580.5519 382.81155 579.90535 382.31826 579.4121 C 381.33167 578.42546 379.7321 578.42546 378.7455 579.4121 C 378.25223 579.90535 378.00557 580.5519 378.00557 581.19844 L 375.6664 581.19844 C 374.63287 581.19844 373.79504 582.0363 373.79504 583.0698 L 373.79504 585.409 C 374.4416 585.409 375.08813 585.6556 375.58143 586.1489 C 376.568 587.1355 376.568 588.7351 375.58143 589.7217 C 375.08813 590.21495 374.4416 590.4616 373.79504 590.4616 L 373.79504 590.4616 L 373.79504 592.8008 C 373.79504 593.8343 374.63287 594.67214 375.6664 594.67214 L 378.00557 594.67214 Z" fill="url(#Obj_Gradient_4)"/>
+        <path d="M 378.00557 594.67214 C 378.00557 594.0256 378.25223 593.37905 378.7455 592.88575 C 379.7321 591.89916 381.33167 591.89916 382.31826 592.88575 C 382.81155 593.37905 383.0582 594.0256 383.0582 594.67214 L 385.3974 594.67214 C 386.4309 594.67214 387.26872 593.8343 387.26872 592.8008 L 387.26872 590.4616 C 387.91527 590.4616 388.5618 590.21495 389.0551 589.7217 C 390.0417 588.7351 390.0417 587.1355 389.0551 586.1489 C 388.5618 585.6556 387.91527 585.409 387.26874 585.409 L 387.26872 585.409 L 387.26872 583.0698 C 387.26872 582.0363 386.4309 581.19844 385.3974 581.19844 L 383.0582 581.19844 L 383.0582 581.19844 C 383.0582 580.5519 382.81155 579.90535 382.31826 579.4121 C 381.33167 578.42546 379.7321 578.42546 378.7455 579.4121 C 378.25223 579.90535 378.00557 580.5519 378.00557 581.19844 L 375.6664 581.19844 C 374.63287 581.19844 373.79504 582.0363 373.79504 583.0698 L 373.79504 585.409 C 374.4416 585.409 375.08813 585.6556 375.58143 586.1489 C 376.568 587.1355 376.568 588.7351 375.58143 589.7217 C 375.08813 590.21495 374.4416 590.4616 373.79504 590.4616 L 373.79504 590.4616 L 373.79504 592.8008 C 373.79504 593.8343 374.63287 594.67214 375.6664 594.67214 L 378.00557 594.67214 Z" stroke="#f63007" stroke-linecap="round" stroke-linejoin="round" stroke-width="2"/>
+      </g>
+      <g id="Graphic_3941_shadow" filter="url(#Shadow)">
+        <path d="M 377.75557 571 C 377.75557 570.3535 378.00223 569.7069 378.4955 569.2136 C 379.4821 568.22704 381.08167 568.22704 382.06826 569.2136 C 382.56155 569.7069 382.8082 570.3535 382.8082 571 L 385.1474 571 C 386.1809 571 387.01872 570.1622 387.01872 569.1287 L 387.01872 566.7895 C 387.66527 566.7895 388.3118 566.5428 388.8051 566.04955 C 389.7917 565.06296 389.7917 563.4634 388.8051 562.4768 C 388.3118 561.9835 387.66527 561.73685 387.01874 561.73685 L 387.01872 561.73685 L 387.01872 559.3977 C 387.01872 558.36415 386.1809 557.5263 385.1474 557.5263 L 382.8082 557.5263 L 382.8082 557.5263 C 382.8082 556.8798 382.56155 556.23323 382.06826 555.73995 C 381.08167 554.75334 379.4821 554.75334 378.4955 555.73995 C 378.00223 556.23323 377.75557 556.8798 377.75557 557.5263 L 375.4164 557.5263 C 374.38287 557.5263 373.54504 558.36415 373.54504 559.3977 L 373.54504 561.73685 C 374.1916 561.73685 374.83813 561.9835 375.33143 562.4768 C 376.318 563.4634 376.318 565.06296 375.33143 566.04955 C 374.83813 566.5428 374.1916 566.7895 373.54504 566.7895 L 373.54504 566.7895 L 373.54504 569.1287 C 373.54504 570.1622 374.38287 571 375.4164 571 L 377.75557 571 Z" fill="url(#Obj_Gradient_5)"/>
+        <path d="M 377.75557 571 C 377.75557 570.3535 378.00223 569.7069 378.4955 569.2136 C 379.4821 568.22704 381.08167 568.22704 382.06826 569.2136 C 382.56155 569.7069 382.8082 570.3535 382.8082 571 L 385.1474 571 C 386.1809 571 387.01872 570.1622 387.01872 569.1287 L 387.01872 566.7895 C 387.66527 566.7895 388.3118 566.5428 388.8051 566.04955 C 389.7917 565.06296 389.7917 563.4634 388.8051 562.4768 C 388.3118 561.9835 387.66527 561.73685 387.01874 561.73685 L 387.01872 561.73685 L 387.01872 559.3977 C 387.01872 558.36415 386.1809 557.5263 385.1474 557.5263 L 382.8082 557.5263 L 382.8082 557.5263 C 382.8082 556.8798 382.56155 556.23323 382.06826 555.73995 C 381.08167 554.75334 379.4821 554.75334 378.4955 555.73995 C 378.00223 556.23323 377.75557 556.8798 377.75557 557.5263 L 375.4164 557.5263 C 374.38287 557.5263 373.54504 558.36415 373.54504 559.3977 L 373.54504 561.73685 C 374.1916 561.73685 374.83813 561.9835 375.33143 562.4768 C 376.318 563.4634 376.318 565.06296 375.33143 566.04955 C 374.83813 566.5428 374.1916 566.7895 373.54504 566.7895 L 373.54504 566.7895 L 373.54504 569.1287 C 373.54504 570.1622 374.38287 571 375.4164 571 L 377.75557 571 Z" stroke="#0052ff" stroke-linecap="round" stroke-linejoin="round" stroke-width="2"/>
+      </g>
+      <g id="Group_221">
+        <g id="Graphic_223">
+          <rect x="588.7068" y="319.35566" width="91.12915" height="23" fill="white"/>
+          <rect x="588.7068" y="319.35566" width="91.12915" height="23" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(593.7068 324.35566)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">text: String</tspan>
+          </text>
+        </g>
+        <g id="Graphic_222">
+          <rect x="588.7068" y="295.35566" width="91.12915" height="24" fill="white"/>
+          <rect x="588.7068" y="295.35566" width="91.12915" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(593.7068 300.35566)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="28.670044" y="11">Text</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Line_3971">
+        <path d="M 634.2714 295.35566 L 634.2714 258.85566 L 441.68597 258.85566 L 441.68597 256.77322" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_3972">
+        <path d="M 497.4029 295.35567 L 497.4029 268.85567 L 466.43596 268.85567 L 466.43596 256.77322" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_3976">
+        <line x1="177.02104" y1="262.61493" x2="277.6001" y2="303.15466" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_3977">
+        <text transform="translate(206.45374 283.8146)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«creates»</tspan>
+        </text>
+      </g>
+      <g id="Graphic_3979">
+        <text transform="translate(450.8836 136.2551)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="0" y="9">0..1</tspan>
+        </text>
+      </g>
+      <g id="Graphic_3980">
+        <text transform="translate(496.2718 175.49997)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="0" y="9">*</tspan>
+        </text>
+      </g>
+      <g id="Line_3978">
+        <path d="M 500.43597 172.02322 L 502.43597 172.02322 L 502.43597 137.02322 L 466.43597 137.02322 L 466.43597 148.27322" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_3981">
+        <text transform="translate(506.53704 164.69418)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">/children</tspan>
+        </text>
+      </g>
+      <g id="Graphic_3982">
+        <text transform="translate(452.16124 124.02322)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">/parent</tspan>
+        </text>
+      </g>
+      <g id="Group_144">
+        <g id="Graphic_214">
+          <rect x="415.4029" y="319.35567" width="164" height="23" fill="white"/>
+          <rect x="415.4029" y="319.35567" width="164" height="23" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(420.4029 324.35567)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">title: String</tspan>
+          </text>
+        </g>
+        <g id="Graphic_213">
+          <rect x="415.4029" y="295.35567" width="164" height="24" fill="white"/>
+          <rect x="415.4029" y="295.35567" width="164" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(420.4029 300.35567)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="54.546875" y="11">TagTitle</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_277">
+        <g id="Graphic_279">
+          <rect x="235.39372" y="505.99043" width="159" height="22" fill="white"/>
+          <rect x="235.39372" y="505.99043" width="159" height="22" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(240.39372 510.99043)" fill="black">
+            <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">text: String[1..n] -- synonyms</tspan>
+          </text>
+        </g>
+        <g id="Graphic_278">
+          <rect x="235.39372" y="481.99043" width="159" height="24" fill="white"/>
+          <rect x="235.39372" y="481.99043" width="159" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(240.39372 486.99043)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="47.04883" y="11">TagToken</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Line_378">
+        <line x1="203.94942" y1="441.4596" x2="274.7287" y2="481.99043" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_379">
+        <text transform="translate(221.752 458.8517)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="0" y="9">[1..n]</tspan>
+        </text>
+      </g>
+      <g id="Graphic_380">
+        <text transform="translate(209.56296 431.3616)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="0" y="9">1</tspan>
+        </text>
+      </g>
+      <g id="Graphic_382">
+        <text transform="translate(258.4527 453.6444)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">tags</tspan>
+        </text>
+      </g>
+      <g id="Line_383">
+        <line x1="119.95806" y1="349.86298" x2="119.95806" y2="276.11493" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_414">
+        <rect x="26.545048" y="568.67213" width="66.97326" height="36" fill="white"/>
+        <rect x="26.545048" y="568.67213" width="66.97326" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(31.545048 579.6721)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="2.2512798" y="11">TagLexer</tspan>
+        </text>
+      </g>
+      <g id="Graphic_413">
+        <rect x="98.87628" y="568.67213" width="66.97326" height="36" fill="white"/>
+        <rect x="98.87628" y="568.67213" width="66.97326" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(103.87628 579.6721)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="6.475889" y="11">IDLexer</tspan>
+        </text>
+      </g>
+      <g id="Graphic_412">
+        <rect x="171.20752" y="568.67213" width="66.97326" height="36" fill="white"/>
+        <rect x="171.20752" y="568.67213" width="66.97326" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(176.20752 579.6721)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x=".58135796" y="11">TextLexer</tspan>
+        </text>
+      </g>
+      <g id="Line_411">
+        <path d="M 60.03168 568.67213 L 60.03168 543.17213 L 129.4564 543.17213 L 129.4564 529.17215" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_410">
+        <path d="M 132.36291 568.67213 L 132.36291 543.17213 L 129.4564 543.17213 L 129.4564 529.17215" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_409">
+        <rect x="243.53875" y="570.9331" width="99" height="36" fill="white"/>
+        <rect x="243.53875" y="570.9331" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(248.53875 581.9331)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="1.5888672" y="11">TypeExprLexer</tspan>
+        </text>
+      </g>
+      <g id="Line_408">
+        <path d="M 293.03875 570.9331 L 293.03875 543.4331 L 129.4564 543.4331 L 129.4564 529.17215" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_407">
+        <path d="M 204.69415 568.67213 L 204.69415 543.17213 L 129.4564 543.17213 L 129.4564 529.17215" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_393">
+        <line x1="118.04915" y1="138.61522" x2="119.52335" y2="216.61493" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_394">
+        <text transform="translate(111.50742 199.62705)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="0" y="9">*</tspan>
+        </text>
+      </g>
+      <g id="Graphic_396">
+        <text transform="translate(99.71163 182.8526)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">subParsers</tspan>
+        </text>
+      </g>
+      <g id="Line_397">
+        <line x1="125.37258" y1="436.863" x2="128.23356" y2="459.84796" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_398">
+        <text transform="translate(107.4156 447.6485)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«use»</tspan>
+        </text>
+      </g>
+      <g id="Group_3965">
+        <g id="Graphic_3984">
+          <rect x="392.18597" y="221.27322" width="99" height="22" fill="white"/>
+          <rect x="392.18597" y="221.27322" width="99" height="22" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(397.18597 226.27322)" fill="black">
+            <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">resolve()</tspan>
+          </text>
+        </g>
+        <g id="Graphic_3967">
+          <rect x="392.18597" y="172.27322" width="99" height="49" fill="white"/>
+          <rect x="392.18597" y="172.27322" width="99" height="49" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(397.18597 177.27322)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">start/end: int</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="23">virtual: boolean</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="36">/value: String</tspan>
+          </text>
+        </g>
+        <g id="Graphic_3966">
+          <rect x="392.18597" y="148.27322" width="99" height="24" fill="white"/>
+          <rect x="392.18597" y="148.27322" width="99" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(397.18597 153.27322)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="10.826172" y="11">JSDocNode</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_416">
+        <g id="Graphic_418">
+          <rect x="10.174454" y="107.36687" width="214.5304" height="22" fill="white"/>
+          <rect x="10.174454" y="107.36687" width="214.5304" height="22" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(15.174454 112.36687)" fill="black">
+            <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">parse(String: s): JSDocNode</tspan>
+          </text>
+        </g>
+        <g id="Graphic_417">
+          <rect x="10.174454" y="83.36687" width="214.5304" height="24" fill="white"/>
+          <rect x="10.174454" y="83.36687" width="214.5304" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(15.174454 88.36687)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="65.24567" y="11">DocletParser</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_419">
+        <g id="Graphic_420">
+          <rect x="269.32917" y="227" width="91.12915" height="24" fill="white"/>
+          <rect x="269.32917" y="227" width="91.12915" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(274.32917 232)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="22.22766" y="11">Doclet</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Line_3973">
+        <path d="M 360.4583 248.22327 L 375.9583 248.22327 L 408.9583 248.22327 L 408.9583 258.77322 L 441.68597 258.77322 L 441.68597 256.77322" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_148">
+        <path d="M 368.74854 32.0696 C 368.74854 27.71202 366.45093 27.1729 349.66754 22.8604 L 349.49024 22.81578 C 332.6182 18.458201 332.4427 18.458201 315.12744 18.458201 C 292.07177 18.458201 187.83456 18.458201 187.83456 18.458201 L 187.83456 64.4582 L 368.74854 64.4582 L 368.74854 32.0696 Z" fill="white"/>
+        <path d="M 368.74854 32.0696 C 368.74854 27.71202 366.45093 27.1729 349.66754 22.8604 L 349.49024 22.81578 C 332.6182 18.458201 332.4427 18.458201 315.12744 18.458201 C 292.07177 18.458201 187.83456 18.458201 187.83456 18.458201 L 187.83456 64.4582 L 368.74854 64.4582 L 368.74854 32.0696 Z M 368.74854 31.84512 C 368.74854 27.71202 368.57124 27.71202 332.4427 27.71202 L 332.4427 27.71202 C 332.4427 18.503281 332.4427 18.458201 316.1876 18.458201" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(192.83456 27.4582)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="8.414993" y="11">Phase 1: JSDocParser.parse</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="7.0819855" y="25">Phase 2: JSDocNode.resolve</tspan>
+        </text>
+      </g>
+      <g id="Line_188">
+        <line x1="174.43656" y1="83.36687" x2="220.83097" y2="64.64531" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_3983">
+        <line x1="392.18597" y1="172.02322" x2="298.68358" y2="64.83499" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Group_3923">
+        <g id="Group_3925">
+          <g id="Graphic_3927">
+            <rect x="35.190015" y="387.86298" width="169.53609" height="49" fill="white"/>
+            <rect x="35.190015" y="387.86298" width="169.53609" height="49" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+            <text transform="translate(40.190015 392.86298)" fill="black">
+              <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">format: String -- simplified EBNF</tspan>
+              <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="23">singleline: Bool</tspan>
+              <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="36">context: typeinfo.Element[0..n]</tspan>
+            </text>
+          </g>
+          <g id="Graphic_3926">
+            <rect x="35.190015" y="349.86298" width="169.53609" height="38" fill="white"/>
+            <rect x="35.190015" y="349.86298" width="169.53609" height="38" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+            <text transform="translate(40.190015 354.86298)" fill="black">
+              <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="47.74656" y="11">Declarative</tspan>
+              <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="41.881325" y="25">TagDefinition</tspan>
+            </text>
+          </g>
+        </g>
+        <g id="Graphic_3924">
+          <path d="M 186.21053 372 C 186.21053 371.35347 186.45718 370.70693 186.95046 370.21363 C 187.93706 369.22704 189.53663 369.22704 190.52322 370.21363 C 191.0165 370.70693 191.26316 371.35347 191.26316 372 L 193.60234 372 C 194.63586 372 195.47368 371.1622 195.47368 370.12867 L 195.47368 367.7895 C 196.12022 367.7895 196.76677 367.54283 197.26005 367.04955 C 198.24666 366.06296 198.24666 364.4634 197.26005 363.4768 C 196.76677 362.9835 196.12022 362.73685 195.4737 362.73685 L 195.47368 362.73685 L 195.47368 360.39767 C 195.47368 359.36415 194.63586 358.52632 193.60234 358.52632 L 191.26316 358.52632 L 191.26316 358.52632 C 191.26316 357.87978 191.0165 357.23323 190.52322 356.73995 C 189.53663 355.75334 187.93706 355.75334 186.95046 356.73995 C 186.45718 357.23323 186.21053 357.87978 186.21053 358.52632 L 183.87134 358.52632 C 182.83782 358.52632 182 359.36415 182 360.39767 L 182 362.73685 C 182.64654 362.73685 183.29309 362.9835 183.78638 363.4768 C 184.77296 364.4634 184.77296 366.06296 183.78638 367.04955 C 183.29309 367.54283 182.64654 367.7895 182 367.7895 L 182 367.7895 L 182 370.12867 C 182 371.1622 182.83782 372 183.87134 372 L 186.21053 372 Z" fill="url(#Obj_Gradient_6)"/>
+          <path d="M 186.21053 372 C 186.21053 371.35347 186.45718 370.70693 186.95046 370.21363 C 187.93706 369.22704 189.53663 369.22704 190.52322 370.21363 C 191.0165 370.70693 191.26316 371.35347 191.26316 372 L 193.60234 372 C 194.63586 372 195.47368 371.1622 195.47368 370.12867 L 195.47368 367.7895 C 196.12022 367.7895 196.76677 367.54283 197.26005 367.04955 C 198.24666 366.06296 198.24666 364.4634 197.26005 363.4768 C 196.76677 362.9835 196.12022 362.73685 195.4737 362.73685 L 195.47368 362.73685 L 195.47368 360.39767 C 195.47368 359.36415 194.63586 358.52632 193.60234 358.52632 L 191.26316 358.52632 L 191.26316 358.52632 C 191.26316 357.87978 191.0165 357.23323 190.52322 356.73995 C 189.53663 355.75334 187.93706 355.75334 186.95046 356.73995 C 186.45718 357.23323 186.21053 357.87978 186.21053 358.52632 L 183.87134 358.52632 C 182.83782 358.52632 182 359.36415 182 360.39767 L 182 362.73685 C 182.64654 362.73685 183.29309 362.9835 183.78638 363.4768 C 184.77296 364.4634 184.77296 366.06296 183.78638 367.04955 C 183.29309 367.54283 182.64654 367.7895 182 367.7895 L 182 367.7895 L 182 370.12867 C 182 371.1622 182.83782 372 183.87134 372 L 186.21053 372 Z" stroke="#f63007" stroke-linecap="round" stroke-linejoin="round" stroke-width="2"/>
+        </g>
+      </g>
+      <g id="Group_3928">
+        <g id="Group_3930">
+          <g id="Graphic_3932">
+            <rect x="20.147816" y="240.61493" width="199.62048" height="22" fill="white"/>
+            <rect x="20.147816" y="240.61493" width="199.62048" height="22" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+            <text transform="translate(25.147816 245.61493)" fill="black">
+              <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">parse(text: String, offset: int): JSDocNode</tspan>
+            </text>
+          </g>
+          <g id="Graphic_3931">
+            <rect x="20.147816" y="216.61493" width="199.62048" height="24" fill="white"/>
+            <rect x="20.147816" y="216.61493" width="199.62048" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+            <text transform="translate(25.147816 221.61493)" fill="black">
+              <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="56.92352" y="11">TagDefinition</tspan>
+            </text>
+          </g>
+        </g>
+        <g id="Graphic_3929">
+          <path d="M 206.72464 236.76134 C 206.72464 236.1148 206.9713 235.46825 207.46458 234.97495 C 208.45117 233.98836 210.05074 233.98836 211.03733 234.97495 C 211.53062 235.46825 211.77727 236.1148 211.77727 236.76134 L 214.11645 236.76134 C 215.14997 236.76134 215.9878 235.92352 215.9878 234.89 L 215.9878 232.5508 C 216.63434 232.5508 217.28088 232.30415 217.77416 231.81087 C 218.76077 230.82428 218.76077 229.2247 217.77416 228.23812 C 217.28088 227.74482 216.63434 227.49817 215.9878 227.49817 L 215.9878 227.49817 L 215.9878 225.159 C 215.9878 224.12547 215.14997 223.28764 214.11645 223.28764 L 211.77727 223.28764 L 211.77727 223.28764 C 211.77727 222.6411 211.53062 221.99456 211.03733 221.50127 C 210.05074 220.51467 208.45117 220.51467 207.46458 221.50127 C 206.9713 221.99456 206.72464 222.6411 206.72464 223.28764 L 204.38546 223.28764 C 203.35194 223.28764 202.51411 224.12547 202.51411 225.159 L 202.51411 227.49817 C 203.16066 227.49817 203.8072 227.74482 204.3005 228.23812 C 205.28707 229.2247 205.28707 230.82428 204.3005 231.81087 C 203.8072 232.30415 203.16066 232.5508 202.51411 232.5508 L 202.51411 232.5508 L 202.51411 234.89 C 202.51411 235.92352 203.35194 236.76134 204.38546 236.76134 L 206.72464 236.76134 Z" fill="url(#Obj_Gradient_7)"/>
+          <path d="M 206.72464 236.76134 C 206.72464 236.1148 206.9713 235.46825 207.46458 234.97495 C 208.45117 233.98836 210.05074 233.98836 211.03733 234.97495 C 211.53062 235.46825 211.77727 236.1148 211.77727 236.76134 L 214.11645 236.76134 C 215.14997 236.76134 215.9878 235.92352 215.9878 234.89 L 215.9878 232.5508 C 216.63434 232.5508 217.28088 232.30415 217.77416 231.81087 C 218.76077 230.82428 218.76077 229.2247 217.77416 228.23812 C 217.28088 227.74482 216.63434 227.49817 215.9878 227.49817 L 215.9878 227.49817 L 215.9878 225.159 C 215.9878 224.12547 215.14997 223.28764 214.11645 223.28764 L 211.77727 223.28764 L 211.77727 223.28764 C 211.77727 222.6411 211.53062 221.99456 211.03733 221.50127 C 210.05074 220.51467 208.45117 220.51467 207.46458 221.50127 C 206.9713 221.99456 206.72464 222.6411 206.72464 223.28764 L 204.38546 223.28764 C 203.35194 223.28764 202.51411 224.12547 202.51411 225.159 L 202.51411 227.49817 C 203.16066 227.49817 203.8072 227.74482 204.3005 228.23812 C 205.28707 229.2247 205.28707 230.82428 204.3005 231.81087 C 203.8072 232.30415 203.16066 232.5508 202.51411 232.5508 L 202.51411 232.5508 L 202.51411 234.89 C 202.51411 235.92352 203.35194 236.76134 204.38546 236.76134 L 206.72464 236.76134 Z" stroke="#0052ff" stroke-linecap="round" stroke-linejoin="round" stroke-width="2"/>
+        </g>
+      </g>
+      <g id="Group_3920">
+        <g id="Graphic_3922">
+          <rect x="70.91279" y="469.67215" width="117.0872" height="46" fill="white"/>
+          <rect x="70.91279" y="469.67215" width="117.0872" height="46" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(75.91279 485.67215)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="18.859032" y="11">JSDocLexer       </tspan>
+          </text>
+        </g>
+        <g id="Graphic_3921">
+          <path d="M 170.79036 489.52607 C 170.79036 488.8795 171.03702 488.233 171.5303 487.7397 C 172.5169 486.7531 174.11646 486.7531 175.10305 487.7397 C 175.59634 488.233 175.843 488.8795 175.843 489.52607 L 178.18217 489.52607 C 179.2157 489.52607 180.05351 488.68824 180.05351 487.6547 L 180.05351 485.31554 C 180.70006 485.31554 181.3466 485.0689 181.83988 484.5756 C 182.8265 483.589 182.8265 481.98943 181.83988 481.00285 C 181.3466 480.50955 180.70006 480.2629 180.05353 480.2629 L 180.05351 480.2629 L 180.05351 477.9237 C 180.05351 476.8902 179.2157 476.0524 178.18217 476.0524 L 175.843 476.0524 L 175.843 476.0524 C 175.843 475.40583 175.59634 474.7593 175.10305 474.266 C 174.11646 473.2794 172.5169 473.2794 171.5303 474.266 C 171.03702 474.7593 170.79036 475.40583 170.79036 476.0524 L 168.45118 476.0524 C 167.41766 476.0524 166.57983 476.8902 166.57983 477.9237 L 166.57983 480.2629 C 167.22638 480.2629 167.87292 480.50955 168.36622 481.00285 C 169.3528 481.98943 169.3528 483.589 168.36622 484.5756 C 167.87292 485.0689 167.22638 485.31554 166.57983 485.31554 L 166.57983 485.31554 L 166.57983 487.6547 C 166.57983 488.68824 167.41766 489.52607 168.45118 489.52607 L 170.79036 489.52607 Z" fill="url(#Obj_Gradient_8)"/>
+          <path d="M 170.79036 489.52607 C 170.79036 488.8795 171.03702 488.233 171.5303 487.7397 C 172.5169 486.7531 174.11646 486.7531 175.10305 487.7397 C 175.59634 488.233 175.843 488.8795 175.843 489.52607 L 178.18217 489.52607 C 179.2157 489.52607 180.05351 488.68824 180.05351 487.6547 L 180.05351 485.31554 C 180.70006 485.31554 181.3466 485.0689 181.83988 484.5756 C 182.8265 483.589 182.8265 481.98943 181.83988 481.00285 C 181.3466 480.50955 180.70006 480.2629 180.05353 480.2629 L 180.05351 480.2629 L 180.05351 477.9237 C 180.05351 476.8902 179.2157 476.0524 178.18217 476.0524 L 175.843 476.0524 L 175.843 476.0524 C 175.843 475.40583 175.59634 474.7593 175.10305 474.266 C 174.11646 473.2794 172.5169 473.2794 171.5303 474.266 C 171.03702 474.7593 170.79036 475.40583 170.79036 476.0524 L 168.45118 476.0524 C 167.41766 476.0524 166.57983 476.8902 166.57983 477.9237 L 166.57983 480.2629 C 167.22638 480.2629 167.87292 480.50955 168.36622 481.00285 C 169.3528 481.98943 169.3528 483.589 168.36622 484.5756 C 167.87292 485.0689 167.22638 485.31554 166.57983 485.31554 L 166.57983 485.31554 L 166.57983 487.6547 C 166.57983 488.68824 167.41766 489.52607 168.45118 489.52607 L 170.79036 489.52607 Z" stroke="#0052ff" stroke-linecap="round" stroke-linejoin="round" stroke-width="2"/>
+        </g>
+      </g>
+      <g id="Group_3937">
+        <g id="Graphic_3941">
+          <path d="M 377.75557 571 C 377.75557 570.3535 378.00223 569.7069 378.4955 569.2136 C 379.4821 568.22704 381.08167 568.22704 382.06826 569.2136 C 382.56155 569.7069 382.8082 570.3535 382.8082 571 L 385.1474 571 C 386.1809 571 387.01872 570.1622 387.01872 569.1287 L 387.01872 566.7895 C 387.66527 566.7895 388.3118 566.5428 388.8051 566.04955 C 389.7917 565.06296 389.7917 563.4634 388.8051 562.4768 C 388.3118 561.9835 387.66527 561.73685 387.01874 561.73685 L 387.01872 561.73685 L 387.01872 559.3977 C 387.01872 558.36415 386.1809 557.5263 385.1474 557.5263 L 382.8082 557.5263 L 382.8082 557.5263 C 382.8082 556.8798 382.56155 556.23323 382.06826 555.73995 C 381.08167 554.75334 379.4821 554.75334 378.4955 555.73995 C 378.00223 556.23323 377.75557 556.8798 377.75557 557.5263 L 375.4164 557.5263 C 374.38287 557.5263 373.54504 558.36415 373.54504 559.3977 L 373.54504 561.73685 C 374.1916 561.73685 374.83813 561.9835 375.33143 562.4768 C 376.318 563.4634 376.318 565.06296 375.33143 566.04955 C 374.83813 566.5428 374.1916 566.7895 373.54504 566.7895 L 373.54504 566.7895 L 373.54504 569.1287 C 373.54504 570.1622 374.38287 571 375.4164 571 L 377.75557 571 Z" fill="url(#Obj_Gradient_9)"/>
+          <path d="M 377.75557 571 C 377.75557 570.3535 378.00223 569.7069 378.4955 569.2136 C 379.4821 568.22704 381.08167 568.22704 382.06826 569.2136 C 382.56155 569.7069 382.8082 570.3535 382.8082 571 L 385.1474 571 C 386.1809 571 387.01872 570.1622 387.01872 569.1287 L 387.01872 566.7895 C 387.66527 566.7895 388.3118 566.5428 388.8051 566.04955 C 389.7917 565.06296 389.7917 563.4634 388.8051 562.4768 C 388.3118 561.9835 387.66527 561.73685 387.01874 561.73685 L 387.01872 561.73685 L 387.01872 559.3977 C 387.01872 558.36415 386.1809 557.5263 385.1474 557.5263 L 382.8082 557.5263 L 382.8082 557.5263 C 382.8082 556.8798 382.56155 556.23323 382.06826 555.73995 C 381.08167 554.75334 379.4821 554.75334 378.4955 555.73995 C 378.00223 556.23323 377.75557 556.8798 377.75557 557.5263 L 375.4164 557.5263 C 374.38287 557.5263 373.54504 558.36415 373.54504 559.3977 L 373.54504 561.73685 C 374.1916 561.73685 374.83813 561.9835 375.33143 562.4768 C 376.318 563.4634 376.318 565.06296 375.33143 566.04955 C 374.83813 566.5428 374.1916 566.7895 373.54504 566.7895 L 373.54504 566.7895 L 373.54504 569.1287 C 373.54504 570.1622 374.38287 571 375.4164 571 L 377.75557 571 Z" stroke="#0052ff" stroke-linecap="round" stroke-linejoin="round" stroke-width="2"/>
+        </g>
+        <g id="Graphic_3940">
+          <text transform="translate(397.19003 557)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="11">Provided by Extension</tspan>
+          </text>
+        </g>
+        <g id="Graphic_3939">
+          <path d="M 378.00557 594.67214 C 378.00557 594.0256 378.25223 593.37905 378.7455 592.88575 C 379.7321 591.89916 381.33167 591.89916 382.31826 592.88575 C 382.81155 593.37905 383.0582 594.0256 383.0582 594.67214 L 385.3974 594.67214 C 386.4309 594.67214 387.26872 593.8343 387.26872 592.8008 L 387.26872 590.4616 C 387.91527 590.4616 388.5618 590.21495 389.0551 589.7217 C 390.0417 588.7351 390.0417 587.1355 389.0551 586.1489 C 388.5618 585.6556 387.91527 585.409 387.26874 585.409 L 387.26872 585.409 L 387.26872 583.0698 C 387.26872 582.0363 386.4309 581.19844 385.3974 581.19844 L 383.0582 581.19844 L 383.0582 581.19844 C 383.0582 580.5519 382.81155 579.90535 382.31826 579.4121 C 381.33167 578.42546 379.7321 578.42546 378.7455 579.4121 C 378.25223 579.90535 378.00557 580.5519 378.00557 581.19844 L 375.6664 581.19844 C 374.63287 581.19844 373.79504 582.0363 373.79504 583.0698 L 373.79504 585.409 C 374.4416 585.409 375.08813 585.6556 375.58143 586.1489 C 376.568 587.1355 376.568 588.7351 375.58143 589.7217 C 375.08813 590.21495 374.4416 590.4616 373.79504 590.4616 L 373.79504 590.4616 L 373.79504 592.8008 C 373.79504 593.8343 374.63287 594.67214 375.6664 594.67214 L 378.00557 594.67214 Z" fill="url(#Obj_Gradient_10)"/>
+          <path d="M 378.00557 594.67214 C 378.00557 594.0256 378.25223 593.37905 378.7455 592.88575 C 379.7321 591.89916 381.33167 591.89916 382.31826 592.88575 C 382.81155 593.37905 383.0582 594.0256 383.0582 594.67214 L 385.3974 594.67214 C 386.4309 594.67214 387.26872 593.8343 387.26872 592.8008 L 387.26872 590.4616 C 387.91527 590.4616 388.5618 590.21495 389.0551 589.7217 C 390.0417 588.7351 390.0417 587.1355 389.0551 586.1489 C 388.5618 585.6556 387.91527 585.409 387.26874 585.409 L 387.26872 585.409 L 387.26872 583.0698 C 387.26872 582.0363 386.4309 581.19844 385.3974 581.19844 L 383.0582 581.19844 L 383.0582 581.19844 C 383.0582 580.5519 382.81155 579.90535 382.31826 579.4121 C 381.33167 578.42546 379.7321 578.42546 378.7455 579.4121 C 378.25223 579.90535 378.00557 580.5519 378.00557 581.19844 L 375.6664 581.19844 C 374.63287 581.19844 373.79504 582.0363 373.79504 583.0698 L 373.79504 585.409 C 374.4416 585.409 375.08813 585.6556 375.58143 586.1489 C 376.568 587.1355 376.568 588.7351 375.58143 589.7217 C 375.08813 590.21495 374.4416 590.4616 373.79504 590.4616 L 373.79504 590.4616 L 373.79504 592.8008 C 373.79504 593.8343 374.63287 594.67214 375.6664 594.67214 L 378.00557 594.67214 Z" stroke="#f63007" stroke-linecap="round" stroke-linejoin="round" stroke-width="2"/>
+        </g>
+        <g id="Graphic_3938">
+          <text transform="translate(396.92712 579.6721)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="11">Configured by Extension</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Graphic_3942">
+        <path d="M 540.1814 415.65997 C 540.1814 410.3697 537.01335 409.7152 513.8714 404.4797 L 513.62695 404.4255 C 490.3628 399.13525 490.1208 399.13525 466.2455 399.13525 C 434.45493 399.13525 290.72647 399.13525 290.72647 399.13525 L 290.72647 454.98085 L 540.1814 454.98085 L 540.1814 415.65997 Z" fill="white"/>
+        <path d="M 540.1814 415.65997 C 540.1814 410.3697 537.01335 409.7152 513.8714 404.4797 L 513.62695 404.4255 C 490.3628 399.13525 490.1208 399.13525 466.2455 399.13525 C 434.45493 399.13525 290.72647 399.13525 290.72647 399.13525 L 290.72647 454.98085 L 540.1814 454.98085 L 540.1814 415.65997 Z M 540.1814 415.38744 C 540.1814 410.3697 539.93696 410.3697 490.1208 410.3697 L 490.1208 410.3697 C 490.1208 399.19 490.1208 399.13525 467.7073 399.13525" stroke="#818181" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(295.72647 399.55805)" fill="#818181">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="#818181" x="0" y="9">name = param</tspan>
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="#818181" x="0" y="20">tag = param (=arg,=argument)</tspan>
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="#818181" x="0" y="31">format = &apos;{&apos; type=TYPEEXPR &apos;}&apos; name=ID description=TEXT</tspan>
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="#818181" x="0" y="42">singleline=true</tspan>
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="#818181" x="0" y="53">context=function</tspan>
+        </text>
+      </g>
+      <g id="Line_3943">
+        <line x1="290.2297" y1="412.77887" x2="204.7261" y2="403.029" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Group_3948">
+        <g id="Graphic_3949">
+          <rect x="396.1214" y="65.50311" width="91.12915" height="24" fill="white"/>
+          <rect x="396.1214" y="65.50311" width="91.12915" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(401.1214 70.50311)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="17.891724" y="11">EObject</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Line_3975">
+        <line x1="441.68597" y1="148.27322" x2="441.68597" y2="103.00311" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Group_3953">
+        <g id="Graphic_3955">
+          <rect x="235.39372" y="122.1859" width="115.44981" height="23.798354" fill="white"/>
+          <rect x="235.39372" y="122.1859" width="115.44981" height="23.798354" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(240.39372 127.1859)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">serialize(): String</tspan>
+          </text>
+        </g>
+        <g id="Graphic_3954">
+          <rect x="235.39372" y="82.86688" width="115.44981" height="39.31902" fill="white"/>
+          <rect x="235.39372" y="82.86688" width="115.44981" height="39.31902" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(240.39372 87.86688)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="7.704399" y="11">DocletSerializer</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_3986">
+        <g id="Graphic_3988">
+          <rect x="776" y="431.98087" width="145" height="23" fill="white"/>
+          <rect x="776" y="431.98087" width="145" height="23" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(781 436.98087)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10"> </tspan>
+          </text>
+        </g>
+        <g id="Graphic_3987">
+          <rect x="776" y="407.98087" width="145" height="24" fill="white"/>
+          <rect x="776" y="407.98087" width="145" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(781 412.98087)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="38.15625" y="11">NamePath</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Line_3989">
+        <line x1="848.5" y1="407.98087" x2="848.5" y2="361.85566" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_3990">
+        <path d="M 977.455 75.40559 C 977.455 62.77658 974.2869 61.21412 951.1449 48.71577 L 950.9005 48.58645 C 927.6363 35.957447 927.3943 35.957447 903.519 35.957447 C 871.7285 35.957447 728 35.957447 728 35.957447 L 728 169.27323 L 977.455 169.27323 L 977.455 75.40559 Z" fill="white"/>
+        <path d="M 977.455 75.40559 C 977.455 62.77658 974.2869 61.21412 951.1449 48.71577 L 950.9005 48.58645 C 927.6363 35.957447 927.3943 35.957447 903.519 35.957447 C 871.7285 35.957447 728 35.957447 728 35.957447 L 728 169.27323 L 977.455 169.27323 L 977.455 75.40559 Z M 977.455 74.75501 C 977.455 62.77658 977.2105 62.77658 927.3943 62.77658 L 927.3943 62.77658 C 927.3943 36.088097 927.3943 35.957447 904.9808 35.957447" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(733 39.615337)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="11">JSDocNode: </tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="25">every separately changeable item, such as </tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="39">type references, ids, text, etc., is modeled as </tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="53">a single node. Convenience methods may </tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="67">be provided.</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="81">As it is an EMF model (for change adapter </tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="95">etc.), extensions cannot provide subclasses </tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="109">of JSDocNode! I.e., all possible cases must </tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="123">be provided.</tspan>
+        </text>
+      </g>
+      <g id="Group_3995">
+        <g id="Graphic_3997">
+          <rect x="776" y="299.35566" width="145" height="49" fill="white"/>
+          <rect x="776" y="299.35566" width="145" height="49" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(781 304.35566)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">resolve()</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="23">getElement(): T</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="36">setElement(type: T)</tspan>
+          </text>
+        </g>
+        <g id="Graphic_3996">
+          <rect x="776" y="275.35566" width="145" height="24" fill="white"/>
+          <rect x="776" y="275.35566" width="145" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(781 280.35566)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="7.8046875" y="11">NamedReference&lt;T&gt;</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Line_3998">
+        <path d="M 848.5 275.35566 L 848.5 258.85566 L 441.68597 258.85566 L 441.68597 256.77322" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Group_4000">
+        <g id="Graphic_4002">
+          <rect x="951" y="431.98087" width="117.0872" height="23" fill="white"/>
+          <rect x="951" y="431.98087" width="117.0872" height="23" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(956 436.98087)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">resolve()</tspan>
+          </text>
+        </g>
+        <g id="Graphic_4001">
+          <rect x="951" y="407.98087" width="117.0872" height="24" fill="white"/>
+          <rect x="951" y="407.98087" width="117.0872" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(956 412.98087)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="2.5172348" y="11">RefereneResolver</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Line_4003">
+        <line x1="884.75" y1="348.35566" x2="1000.6108" y2="403.71288" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Group_4007">
+        <g id="Graphic_4008">
+          <rect x="264" y="306.85567" width="91.12915" height="24" fill="white"/>
+          <rect x="264" y="306.85567" width="91.12915" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(269 311.85567)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="30.339966" y="11">Tag</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Line_4009">
+        <path d="M 309.56458 306.85567 L 309.56458 275.35567 L 441.68597 275.35567 L 441.68597 256.77322" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_4010">
+        <line x1="155.0864" y1="129.36687" x2="306.44562" y2="221.83868" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_4011">
+        <text transform="translate(208.10773 176.23176)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«creates»</tspan>
+        </text>
+      </g>
+      <g id="Graphic_4012">
+        <text transform="translate(356.8283 321.40217)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="0" y="9">1</tspan>
+        </text>
+      </g>
+      <g id="Graphic_4013">
+        <text transform="translate(408.4928 322.3324)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="0" y="9">1</tspan>
+        </text>
+      </g>
+      <g id="Line_4014">
+        <line x1="406.1529" y1="318.85566" x2="355.12915" y2="318.85567" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_4015">
+        <text transform="translate(395.5132 305.85566)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">title</tspan>
+        </text>
+      </g>
+      <g id="Graphic_4016">
+        <text transform="translate(356.26332 305.85566)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">tag</tspan>
+        </text>
+      </g>
+      <g id="Graphic_4017">
+        <text transform="translate(341.52888 324.84005)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="0" y="9">1</tspan>
+        </text>
+      </g>
+      <g id="Graphic_4018">
+        <text transform="translate(415.45616 250.4138)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="0" y="9">*</tspan>
+        </text>
+      </g>
+      <g id="Line_4019">
+        <line x1="410.5099" y1="249.92667" x2="332.34685" y2="330.85567" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_4020">
+        <text transform="translate(382.9539 250.0055)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">value</tspan>
+        </text>
+      </g>
+      <g id="Graphic_4021">
+        <text transform="translate(331.70754 308.2448)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">tag</tspan>
+        </text>
+      </g>
+      <g id="Graphic_4022">
+        <text transform="translate(801.7008 398.32424)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="0" y="9">1</tspan>
+        </text>
+      </g>
+      <g id="Graphic_4023">
+        <text transform="translate(801.522 347.2157)" fill="black">
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="0" y="9">*</tspan>
+        </text>
+      </g>
+      <g id="Line_4024">
+        <line x1="812.25" y1="357.60566" x2="812.25" y2="407.98087" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_4025">
+        <text transform="translate(810.6343 354.3343)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">part</tspan>
+        </text>
+      </g>
+      <g id="Graphic_4026">
+        <text transform="translate(809.5185 393.983)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">path</tspan>
+        </text>
+      </g>
+      <g id="Line_4027">
+        <line x1="299.22298" y1="145.98425" x2="313.01365" y2="217.28016" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_4028">
+        <text transform="translate(284.49553 180.74224)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«uses»</tspan>
+        </text>
+      </g>
+    </g>
+  </g>
+</svg>
diff --git a/design/chapters/24_docexporter/images/api_test_spec.svg b/design/chapters/24_docexporter/images/api_test_spec.svg
new file mode 100644
index 0000000..849c36c
--- /dev/null
+++ b/design/chapters/24_docexporter/images/api_test_spec.svg
@@ -0,0 +1,285 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xl="http://www.w3.org/1999/xlink" xmlns:dc="http://purl.org/dc/elements/1.1/" viewBox="23.43705 192.2559 533.1496 319.5433" width="533.1496" height="319.5433">
+  <defs>
+    <font-face font-family="Helvetica" font-size="12" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="532.22656" cap-height="719.7266" ascent="770.0195" descent="-229.98047" font-weight="700">
+      <font-face-src>
+        <font-face-name name="Helvetica-Bold"/>
+      </font-face-src>
+    </font-face>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="FilledDiamond_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-9 -4 10 8" markerWidth="10" markerHeight="8" color="black">
+      <g>
+        <path d="M -8 0 L -4 3 L 0 0 L -4 -3 Z" fill="currentColor" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <font-face font-family="Helvetica" font-size="8" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="532.22656" cap-height="719.7266" ascent="770.0195" descent="-229.98047" font-weight="700">
+      <font-face-src>
+        <font-face-name name="Helvetica-Bold"/>
+      </font-face-src>
+    </font-face>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="StickArrow_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -4 10 8" markerWidth="10" markerHeight="8" color="black">
+      <g>
+        <path d="M 8 0 L 0 0 M 0 -3 L 8 0 L 0 3" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="UMLInheritance_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -8 14 16" markerWidth="14" markerHeight="16" color="black">
+      <g>
+        <path d="M 12 0 L 0 -7 L 0 7 Z" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <font-face font-family="Helvetica Neue" font-size="11" panose-1="2 0 5 3 0 0 0 2 0 4" units-per-em="1000" underline-position="-100" underline-thickness="50" slope="0" x-height="517" cap-height="714" ascent="951.9958" descent="-212.99744" font-weight="400">
+      <font-face-src>
+        <font-face-name name="HelveticaNeue"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica Neue" font-size="9" panose-1="2 0 5 3 0 0 0 2 0 4" units-per-em="1000" underline-position="-100" underline-thickness="50" slope="0" x-height="517" cap-height="714" ascent="951.9958" descent="-212.99744" font-weight="400">
+      <font-face-src>
+        <font-face-name name="HelveticaNeue"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="9" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="532.22656" cap-height="719.7266" ascent="770.0195" descent="-229.98047" font-weight="700">
+      <font-face-src>
+        <font-face-name name="Helvetica-Bold"/>
+      </font-face-src>
+    </font-face>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="FilledDiamond_Marker_2" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-9 -4 10 8" markerWidth="10" markerHeight="8" color="#b0b0b0">
+      <g>
+        <path d="M -8 0 L -4 3 L 0 0 L -4 -3 Z" fill="currentColor" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="StickArrow_Marker_2" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -4 10 8" markerWidth="10" markerHeight="8" color="#b0b0b0">
+      <g>
+        <path d="M 8 0 L 0 0 M 0 -3 L 8 0 L 0 3" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="StickArrow_Marker_3" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -4 10 8" markerWidth="10" markerHeight="8" color="#b0b0b0">
+      <g>
+        <path d="M 8 0 L 0 0 M 0 -3 L 8 0 L 0 3" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="FilledDiamond_Marker_3" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-9 -4 10 8" markerWidth="10" markerHeight="8" color="#b0b0b0">
+      <g>
+        <path d="M -8 0 L -4 3 L 0 0 L -4 -3 Z" fill="currentColor" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+  </defs>
+  <metadata> Produced by OmniGraffle 7.11 
+    <dc:date>2016-09-01 08:26:00 +0000</dc:date>
+  </metadata>
+  <g id="Canvas_1" stroke="none" stroke-opacity="1" stroke-dasharray="none" fill="none" fill-opacity="1">
+    <title>Canvas 1</title>
+    <g id="Canvas_1: Layer 1">
+      <title>Layer 1</title>
+      <g id="Group_46">
+        <g id="Graphic_50">
+          <rect x="23.93705" y="260.26772" width="86.93705" height="46.771654" fill="white"/>
+          <rect x="23.93705" y="260.26772" width="86.93705" height="46.771654" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(28.93705 269.65355)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="11.128681" y="11">API.n4jsd </tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="9.810322" y="25">(TModule)</tspan>
+          </text>
+        </g>
+        <g id="Group_47">
+          <g id="Line_49">
+            <path d="M 104.465 263.62772 L 100.381 263.62772 L 100.381 273.70772 L 107.188 273.70772 L 107.188 266.98772 L 104.465 263.62772" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Line_48">
+            <path d="M 104.465 263.62772 L 104.465 266.98772 L 107.188 266.98772" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+        </g>
+      </g>
+      <g id="Group_41">
+        <g id="Graphic_45">
+          <rect x="36" y="469.2992" width="74.8741" height="42" fill="white"/>
+          <rect x="36" y="469.2992" width="74.8741" height="42" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(41 483.2992)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="6.869667" y="11">Test.n4js</tspan>
+          </text>
+        </g>
+        <g id="Group_42">
+          <g id="Line_44">
+            <path d="M 104.465 472.6592 L 100.381 472.6592 L 100.381 482.7392 L 107.188 482.7392 L 107.188 476.0192 L 104.465 472.6592" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Line_43">
+            <path d="M 104.465 472.6592 L 104.465 476.0192 L 107.188 476.0192 L 107.188 476.0192" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+        </g>
+      </g>
+      <g id="Graphic_40">
+        <rect x="158.58272" y="262.65355" width="108.19689" height="42" fill="white"/>
+        <rect x="158.58272" y="262.65355" width="108.19689" height="42" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(163.58272 262.65355)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="35.536922" y="11">Type</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="15.081844" y="25">(TClassifier, </tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="18.108212" y="39">TFunction)</tspan>
+        </text>
+      </g>
+      <g id="Graphic_39">
+        <rect x="158.58272" y="367.0866" width="108.19689" height="36" fill="white"/>
+        <rect x="158.58272" y="367.0866" width="108.19689" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(163.58272 378.0866)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="22.42657" y="11">TMember</tspan>
+        </text>
+      </g>
+      <g id="Line_38">
+        <line x1="212.68117" y1="313.90355" x2="212.68117" y2="367.0866" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_37">
+        <line x1="120.1241" y1="283.65355" x2="158.58272" y2="283.65355" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_36">
+        <rect x="158.58272" y="469.2992" width="108.19689" height="42" fill="white"/>
+        <rect x="158.58272" y="469.2992" width="108.19689" height="42" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(163.58272 469.2992)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="3.0877037" y="11">Constraint/Case</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="20.440243" y="25">(TMethod, </tspan>
+          <tspan font-family="Helvetica" font-size="8" font-weight="700" fill="black" x="10.43243" y="39">naming convention</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" y="39">)</tspan>
+        </text>
+      </g>
+      <g id="Line_35">
+        <line x1="120.6241" y1="490.2992" x2="158.58272" y2="490.2992" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Group_30">
+        <g id="Graphic_34">
+          <rect x="458.51965" y="192.7559" width="86.93705" height="46.771654" fill="white"/>
+          <rect x="458.51965" y="192.7559" width="86.93705" height="46.771654" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(463.51965 209.14173)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="8.456806" y="11">Spec.adoc</tspan>
+          </text>
+        </g>
+        <g id="Group_31">
+          <g id="Line_33">
+            <path d="M 539.0476 196.1159 L 534.9636 196.1159 L 534.9636 206.1959 L 541.7706 206.1959 L 541.7706 199.4759 L 539.0476 196.1159" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Line_32">
+            <path d="M 539.0476 196.1159 L 539.0476 199.4759 L 541.7706 199.4759" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+        </g>
+      </g>
+      <g id="Graphic_29">
+        <rect x="447.8897" y="282.3307" width="108.19689" height="46.771654" fill="white"/>
+        <rect x="447.8897" y="282.3307" width="108.19689" height="46.771654" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(452.8897 298.71654)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="14.425594" y="11">SpecRegion</tspan>
+        </text>
+      </g>
+      <g id="Line_28">
+        <line x1="501.9882" y1="248.77756" x2="501.9882" y2="282.3307" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_27">
+        <line x1="447.3897" y1="305.71654" x2="422.6953" y2="305.71654" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_26">
+        <rect x="313.79528" y="287.71654" width="99" height="36" fill="white"/>
+        <rect x="313.79528" y="287.71654" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(318.79528 291.71654)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="12.830078" y="11">Identifiable</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="21.15918" y="25">Element</tspan>
+        </text>
+      </g>
+      <g id="Line_25">
+        <path d="M 266.7796 385.0866 L 290.2796 385.0866 L 290.2796 305.71654 L 300.29528 305.71654" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_24">
+        <path d="M 266.7796 283.65355 L 290.2796 283.65355 L 290.2796 305.71654 L 300.29528 305.71654" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_23">
+        <line x1="239.7304" y1="469.2992" x2="239.7304" y2="412.9866" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_22">
+        <text transform="translate(241.2549 433.01935)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="11" font-weight="400" fill="black" x="4689582e-19" y="10">@testee</tspan>
+        </text>
+      </g>
+      <g id="Line_21">
+        <line x1="212.68117" y1="469.2992" x2="212.68117" y2="412.9866" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_20">
+        <text transform="translate(173.92317 422.2462)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="9" font-weight="400" fill="black" x=".8235" y="9">@testee</tspan>
+          <tspan font-family="Helvetica Neue" font-size="9" font-weight="400" fill="black" x="0" y="20.252">Member</tspan>
+        </text>
+      </g>
+      <g id="Line_19">
+        <path d="M 185.23654 468.9932 L 144 437.07706 L 143 352 L 178.6729 312.38217" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_18">
+        <text transform="translate(107.6615 391.3231)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="9" font-weight="400" fill="black" x="0" y="9">@testee</tspan>
+          <tspan font-family="Helvetica Neue" font-size="9" font-weight="400" fill="black" x="6.516" y="20.252">Type</tspan>
+        </text>
+      </g>
+      <g id="Graphic_17">
+        <rect x="452.48817" y="461.2126" width="99" height="36" fill="white"/>
+        <rect x="452.48817" y="461.2126" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(457.48817 472.2126)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="7.826172" y="11">Requirement</tspan>
+        </text>
+      </g>
+      <g id="Line_16">
+        <line x1="266.7796" y1="479.7992" x2="442.5882" y2="479.2439" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_15">
+        <text transform="translate(331.903 483.53976)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="11" font-weight="400" fill="black" x="0" y="10">@reqId</tspan>
+        </text>
+      </g>
+      <g id="Line_14">
+        <line x1="501.9882" y1="329.10237" x2="501.9882" y2="451.3126" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_13">
+        <rect x="350.07874" y="405.35433" width="44" height="25.060773" fill="white"/>
+        <rect x="350.07874" y="405.35433" width="44" height="25.060773" stroke="#b4b4b4" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(355.07874 412.3847)" fill="#b0b0b0">
+          <tspan font-family="Helvetica" font-size="9" font-weight="700" fill="#b0b0b0" x="7.074951" y="9">Task</tspan>
+        </text>
+      </g>
+      <g id="Graphic_12">
+        <rect x="350.07874" y="358.5827" width="44" height="25.060773" fill="white"/>
+        <rect x="350.07874" y="358.5827" width="44" height="25.060773" stroke="#b4b4b4" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(355.07874 361.11307)" fill="#b0b0b0">
+          <tspan font-family="Helvetica" font-size="8" font-weight="700" fill="#b0b0b0" x="1.4394531" y="8">Jira/GH-</tspan>
+          <tspan font-family="Helvetica" font-size="8" font-weight="700" fill="#b0b0b0" x="4.546875" y="18">Issues</tspan>
+        </text>
+      </g>
+      <g id="Line_11">
+        <line x1="372.07874" y1="392.89345" x2="372.07874" y2="405.35433" marker-start="url(#FilledDiamond_Marker_2)" stroke="#b0b0b0" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_10">
+        <line x1="240.1836" y1="469.08805" x2="341.105" y2="422.06585" marker-end="url(#StickArrow_Marker_2)" stroke="#b0b0b0" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_9">
+        <text transform="translate(279.29484 445.88407)" fill="#b0b0b0">
+          <tspan font-family="Helvetica Neue" font-size="9" font-weight="400" fill="#b0b0b0" x="3339551e-19" y="9">@task</tspan>
+        </text>
+      </g>
+      <g id="Line_8">
+        <line x1="266.7796" y1="394.0866" x2="340.391" y2="409.58044" marker-end="url(#StickArrow_Marker_3)" stroke="#b0b0b0" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_7">
+        <text transform="translate(289.94807 403.6683)" fill="#b0b0b0">
+          <tspan font-family="Helvetica Neue" font-size="9" font-weight="400" fill="#b0b0b0" x="3339551e-19" y="9">@task</tspan>
+        </text>
+      </g>
+      <g id="Graphic_6">
+        <rect x="45.405575" y="209.76378" width="44" height="25.060773" fill="white"/>
+        <rect x="45.405575" y="209.76378" width="44" height="25.060773" stroke="#b4b4b4" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(50.405575 217.29417)" fill="#b0b0b0">
+          <tspan font-family="Helvetica" font-size="8" font-weight="700" fill="#b0b0b0" x="8.111328" y="8">SCM</tspan>
+        </text>
+      </g>
+      <g id="Line_5">
+        <line x1="67.405575" y1="244.57455" x2="67.405575" y2="260.26772" marker-start="url(#FilledDiamond_Marker_3)" stroke="#b0b0b0" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_4">
+        <path d="M 474.93895 282.3307 L 390 222 L 99.80557 222.284" marker-end="url(#StickArrow_Marker_3)" stroke="#b0b0b0" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_3">
+        <text transform="translate(300.99174 222.073)" fill="#b0b0b0">
+          <tspan font-family="Helvetica Neue" font-size="9" font-weight="400" fill="#b0b0b0" x="5790923e-19" y="9">srcLink</tspan>
+        </text>
+      </g>
+    </g>
+  </g>
+</svg>
diff --git a/design/chapters/24_docexporter/images/cd_adocexporter.svg b/design/chapters/24_docexporter/images/cd_adocexporter.svg
new file mode 100644
index 0000000..242646b
--- /dev/null
+++ b/design/chapters/24_docexporter/images/cd_adocexporter.svg
@@ -0,0 +1,493 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xl="http://www.w3.org/1999/xlink" xmlns:dc="http://purl.org/dc/elements/1.1/" viewBox="12.255906 12.255906 951.6098 865.0709" width="951.6098" height="865.0709">
+  <defs>
+    <font-face font-family="Helvetica" font-size="8" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="StickArrow_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -4 10 8" markerWidth="10" markerHeight="8" color="black">
+      <g>
+        <path d="M 8 0 L 0 0 M 0 -3 L 8 0 L 0 3" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <font-face font-family="Helvetica" font-size="12" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="UMLInheritance_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -8 14 16" markerWidth="14" markerHeight="16" color="black">
+      <g>
+        <path d="M 12 0 L 0 -7 L 0 7 Z" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <font-face font-family="Helvetica" font-size="11" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="7" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="532.22656" cap-height="719.7266" ascent="770.0195" descent="-229.98047" font-weight="700">
+      <font-face-src>
+        <font-face-name name="Helvetica-Bold"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="12" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="532.22656" cap-height="719.7266" ascent="770.0195" descent="-229.98047" font-weight="700">
+      <font-face-src>
+        <font-face-name name="Helvetica-Bold"/>
+      </font-face-src>
+    </font-face>
+  </defs>
+  <metadata> Produced by OmniGraffle 7.11 
+    <dc:date>2017-04-18 08:43:19 +0000</dc:date>
+  </metadata>
+  <g id="Canvas_1" stroke="none" stroke-opacity="1" stroke-dasharray="none" fill="none" fill-opacity="1">
+    <title>Canvas 1</title>
+    <rect fill="white" x="12.255906" y="12.255906" width="951.6098" height="865.0709"/>
+    <g id="Canvas_1: UML Elements">
+      <title>UML Elements</title>
+      <g id="Graphic_124">
+        <text transform="translate(111.98929 504.44136)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="0" y="8">sourceEntry</tspan>
+        </text>
+      </g>
+      <g id="Line_123">
+        <line x1="146.87205" y1="461.40945" x2="146.25897" y2="515.9274" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_120">
+        <text transform="translate(766.7201 302.3129)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="0" y="8">requirement</tspan>
+        </text>
+      </g>
+      <g id="Line_119">
+        <line x1="775.0638" y1="197.2559" x2="775.0638" y2="334.50945" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_118">
+        <text transform="translate(652.4795 742.3758)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="11">*</tspan>
+        </text>
+      </g>
+      <g id="Graphic_117">
+        <text transform="translate(636.08564 718.4309)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="0" y="8">relatedTypeTests</tspan>
+        </text>
+      </g>
+      <g id="Line_116">
+        <path d="M 582.115 741.8268 L 582.115 736.0255 L 686.6824 736.5291" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_104">
+        <text transform="translate(98.1053 264.0174)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="11">*</tspan>
+        </text>
+      </g>
+      <g id="Graphic_103">
+        <text transform="translate(57.85058 273.9251)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="0" y="8">functions</tspan>
+        </text>
+      </g>
+      <g id="Line_102">
+        <line x1="91.86121" y1="203.7559" x2="85.79027" y2="295.53104" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_101">
+        <text transform="translate(190.47994 264.2012)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="11">*</tspan>
+        </text>
+      </g>
+      <g id="Graphic_100">
+        <text transform="translate(203.49724 273.7413)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="0" y="8">variables</tspan>
+        </text>
+      </g>
+      <g id="Line_99">
+        <line x1="200.43404" y1="203.7559" x2="207.81387" y2="295.5413" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_98">
+        <text transform="translate(131.28622 263.25197)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="11">*</tspan>
+        </text>
+      </g>
+      <g id="Graphic_97">
+        <text transform="translate(140.34536 274.69054)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="0" y="8">allSections</tspan>
+        </text>
+      </g>
+      <g id="Line_96">
+        <line x1="146.14764" y1="203.7559" x2="146.8015" y2="295.5097" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_91">
+        <text transform="translate(814.5512 662.7215)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="11">*</tspan>
+        </text>
+      </g>
+      <g id="Graphic_90">
+        <text transform="translate(792.7664 649.3636)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="20.93575" y="8">testsForMember</tspan>
+        </text>
+      </g>
+      <g id="Line_89">
+        <path d="M 675.5515 564.5315 L 829.4268 564.4687 L 829.9308 679.9269" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_88">
+        <text transform="translate(747.5846 665.8615)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="11">*</tspan>
+        </text>
+      </g>
+      <g id="Graphic_87">
+        <text transform="translate(710.241 655.9241)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="42.312836" y="8">testsForType</tspan>
+        </text>
+      </g>
+      <g id="Line_86">
+        <path d="M 675.5515 608.0685 L 761.5638 608.0685 L 763.0706 679.92895" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_85">
+        <text transform="translate(486.519 726.5425)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="0" y="8">specInfo</tspan>
+        </text>
+      </g>
+      <g id="Line_84">
+        <line x1="488.6401" y1="701.0315" x2="488.6401" y2="731.9268" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_83">
+        <path d="M 488.6401 255.3937 L 488.6401 239.8937 L 488.6401 241.2559 L 488.6401 239.2559" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_82">
+        <path d="M 208.60727 461.40945 L 208.60727 496.2815 L 288.22868 496.2815" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_81">
+        <line x1="673.25475" y1="119.25587" x2="607.8389" y2="119.25591" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_80">
+        <path d="M 735.823 461.40945 L 735.823 496.2815 L 689.0515 496.2815" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_79">
+        <line x1="254.72048" y1="119.25592" x2="369.44128" y2="119.25586" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Group_72">
+        <g id="Graphic_75">
+          <rect x="373.46096" y="310.3937" width="230.35829" height="88" fill="white"/>
+          <rect x="373.46096" y="310.3937" width="230.35829" height="88" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(378.46096 315.3937)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">+getPackageDisplayName(): String</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="23">+add(specElem: SpecSection): void</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="36">+getNewContent(): String</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="49">+getOffsetStart(entry: SpecSection): int</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="62">+getOffsetEnd(entry: SpecSection): int</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="75">+getSpecSections(): Collection</tspan>
+          </text>
+        </g>
+        <g id="Graphic_74">
+          <rect x="373.46096" y="287.3937" width="230.35829" height="23" fill="white"/>
+          <rect x="373.46096" y="287.3937" width="230.35829" height="23" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(378.46096 292.3937)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10"> </tspan>
+          </text>
+        </g>
+        <g id="Graphic_73">
+          <rect x="373.46096" y="255.3937" width="230.35829" height="32" fill="white"/>
+          <rect x="373.46096" y="255.3937" width="230.35829" height="32" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(378.46096 260.3937)" fill="black">
+            <tspan font-family="Helvetica" font-size="7" font-weight="700" fill="black" x="100.06538" y="6">adoc..</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="69.83149" y="19">SpecIndexFile</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_68">
+        <g id="Graphic_71">
+          <rect x="382.9413" y="59.755906" width="211.39766" height="166" fill="white"/>
+          <rect x="382.9413" y="59.755906" width="211.39766" height="166" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(387.9413 64.755906)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">+getFile(): File</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="23">+getFileKey(): String</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="36">+getPackageDisplayName(): String</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="49">+getNewContent(): String</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="62">+add(specElem: SpecSection): void</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="75">+getSpecSections(): Collection</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="88">+getOffsetStart(entry: SpecSection): int</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="101">+getOffsetEnd(entry: SpecSection): int</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="114">+hashCode(): int</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="127">+equals(obj: Object): boolean</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="140">+compareTo(o: SpecFile): int</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="153">+toString(): String</tspan>
+          </text>
+        </g>
+        <g id="Graphic_70">
+          <rect x="382.9413" y="36.755906" width="211.39766" height="23" fill="white"/>
+          <rect x="382.9413" y="36.755906" width="211.39766" height="23" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(387.9413 41.755906)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10"> </tspan>
+          </text>
+        </g>
+        <g id="Graphic_69">
+          <rect x="382.9413" y="12.755906" width="211.39766" height="24" fill="white"/>
+          <rect x="382.9413" y="12.755906" width="211.39766" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(387.9413 17.755906)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="76.02207" y="11">SpecFile</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_45">
+        <g id="Graphic_48">
+          <rect x="23.401573" y="360.40945" width="246.94096" height="101" fill="white"/>
+          <rect x="23.401573" y="360.40945" width="246.94096" height="101" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(28.401573 365.40945)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">+getSpecModuleKey(): String</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="23">+getSpecKey(): String</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="36">+getFile(): File</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="49">+getIdentifiableElement(): IdentifiableElement</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="62">+getSourceEntry(): SourceEntry</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="75">+setDoclet(doclet: Doclet): void</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="88">+getDoclet(): Doclet</tspan>
+          </text>
+        </g>
+        <g id="Graphic_47">
+          <rect x="23.401573" y="337.40945" width="246.94096" height="23" fill="white"/>
+          <rect x="23.401573" y="337.40945" width="246.94096" height="23" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(28.401573 342.40945)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10"> </tspan>
+          </text>
+        </g>
+        <g id="Graphic_46">
+          <rect x="23.401573" y="305.40945" width="246.94096" height="32" fill="white"/>
+          <rect x="23.401573" y="305.40945" width="246.94096" height="32" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(28.401573 310.40945)" fill="black">
+            <tspan font-family="Helvetica" font-size="7" font-weight="700" fill="black" x="108.35671" y="6">adoc..</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="27.44802" y="19">SpecIdentifiableElementSection</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_41">
+        <g id="Graphic_44">
+          <rect x="673.25475" y="96.2559" width="203.6181" height="101" fill="white"/>
+          <rect x="673.25475" y="96.2559" width="203.6181" height="101" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(678.25475 101.2559)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">+getPackageDisplayName(): String</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="23">+getModuleName(): String</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="36">+add(specElem: SpecSection): void</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="49">+getSpecSections(): Collection</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="62">+getNewContent(): String</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="75">+getOffsetStart(entry: SpecSection): int</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="88">+getOffsetEnd(entry: SpecSection): int</tspan>
+          </text>
+        </g>
+        <g id="Graphic_43">
+          <rect x="673.25475" y="73.255906" width="203.6181" height="23" fill="white"/>
+          <rect x="673.25475" y="73.255906" width="203.6181" height="23" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(678.25475 78.25591)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">+USE_HEADER: boolean</tspan>
+          </text>
+        </g>
+        <g id="Graphic_42">
+          <rect x="673.25475" y="41.255906" width="203.6181" height="32" fill="white"/>
+          <rect x="673.25475" y="41.255906" width="203.6181" height="32" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(678.25475 46.255906)" fill="black">
+            <tspan font-family="Helvetica" font-size="7" font-weight="700" fill="black" x="86.69528" y="6">adoc..</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="35.458466" y="19">SpecRequirementFile</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_36">
+        <g id="Graphic_39">
+          <rect x="304.5279" y="788.8268" width="368.2244" height="88" fill="white"/>
+          <rect x="304.5279" y="788.8268" width="368.2244" height="88" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(309.5279 793.8268)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">+addTypeTestInfo(testInfo: SpecTestInfo): void</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="23">+addMemberTestInfo(member: TMember, testInfo: SpecTestInfo): void</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="36">+getTestsForType(): SortedSet</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="49">+getTestsForMember(member: TMember): SortedSet</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="62">+getTestsForInheritedMembers(): Map</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="75">+toString(): String</tspan>
+          </text>
+        </g>
+        <g id="Graphic_38">
+          <rect x="304.5279" y="765.8268" width="368.2244" height="23" fill="white"/>
+          <rect x="304.5279" y="765.8268" width="368.2244" height="23" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(309.5279 770.8268)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10"> </tspan>
+          </text>
+        </g>
+        <g id="Graphic_37">
+          <rect x="304.5279" y="741.8268" width="368.2244" height="24" fill="white"/>
+          <rect x="304.5279" y="741.8268" width="368.2244" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(309.5279 746.8268)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="153.77626" y="11">SpecInfo</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_26">
+        <g id="Graphic_29">
+          <rect x="696.5823" y="762.8268" width="266.78347" height="114" fill="white"/>
+          <rect x="696.5823" y="762.8268" width="266.78347" height="114" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(701.5823 767.8268)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">+humanReadable(camelcaseOrUnderscoredString: </tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="23">String): String</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="36">+compareTo(o: SpecTestInfo): int</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="49">+equals(obj: Object): boolean</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="62">+hashCode(): int</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="75">+testModuleSpec(): CharSequence</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="88">+testMethodTypeName(): String</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="101">+testMethodName(): String</tspan>
+          </text>
+        </g>
+        <g id="Graphic_28">
+          <rect x="696.5823" y="713.8268" width="266.78347" height="49" fill="white"/>
+          <rect x="696.5823" y="713.8268" width="266.78347" height="49" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(701.5823 718.8268)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">+testeeName: String</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="23">+testTitle: String</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="36">+testCase: String</tspan>
+          </text>
+        </g>
+        <g id="Graphic_27">
+          <rect x="696.5823" y="689.8268" width="266.78347" height="24" fill="white"/>
+          <rect x="696.5823" y="689.8268" width="266.78347" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(701.5823 694.8268)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="91.16127" y="11">SpecTestInfo</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_22">
+        <g id="Graphic_25">
+          <rect x="696.5823" y="399.40945" width="156.96306" height="62" fill="white"/>
+          <rect x="696.5823" y="399.40945" width="156.96306" height="62" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(701.5823 404.40945)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">+getSpecModuleKey(): String</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="23">+getSpecKey(): String</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="36">+getFile(): File</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="49">+getRequirementID(): String</tspan>
+          </text>
+        </g>
+        <g id="Graphic_24">
+          <rect x="696.5823" y="376.40945" width="156.96306" height="23" fill="white"/>
+          <rect x="696.5823" y="376.40945" width="156.96306" height="23" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(701.5823 381.40945)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10"> </tspan>
+          </text>
+        </g>
+        <g id="Graphic_23">
+          <rect x="696.5823" y="344.40945" width="156.96306" height="32" fill="white"/>
+          <rect x="696.5823" y="344.40945" width="156.96306" height="32" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(701.5823 349.40945)" fill="black">
+            <tspan font-family="Helvetica" font-size="7" font-weight="700" fill="black" x="63.36776" y="6">adoc..</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x=".7959824" y="19">SpecRequirementSection</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_13">
+        <g id="Graphic_16">
+          <rect x="37.574804" y="89.75591" width="217.14568" height="114" fill="white"/>
+          <rect x="37.574804" y="89.75591" width="217.14568" height="114" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(42.574804 94.7559)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">+getHeaderLength(): int</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="23">+getPackageDisplayName(): String</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="36">+getModuleName(): String</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="49">+add(specElem: SpecSection): void</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="62">+getSpecSections(): Collection</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="75">+getNewContent(): String</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="88">+getOffsetStart(entry: SpecSection): int</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="101">+getOffsetEnd(entry: SpecSection): int</tspan>
+          </text>
+        </g>
+        <g id="Graphic_15">
+          <rect x="37.574804" y="66.755906" width="217.14568" height="23" fill="white"/>
+          <rect x="37.574804" y="66.755906" width="217.14568" height="23" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(42.574804 71.755906)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10"> </tspan>
+          </text>
+        </g>
+        <g id="Graphic_14">
+          <rect x="37.574804" y="34.755906" width="217.14568" height="32" fill="white"/>
+          <rect x="37.574804" y="34.755906" width="217.14568" height="32" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(42.574804 39.755906)" fill="black">
+            <tspan font-family="Helvetica" font-size="7" font-weight="700" fill="black" x="93.45907" y="6">adoc..</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="57.89901" y="19">SpecModuleFile</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_7">
+        <g id="Graphic_10">
+          <rect x="301.72868" y="483.0315" width="373.82285" height="218" fill="white"/>
+          <rect x="301.72868" y="483.0315" width="373.82285" height="218" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(306.72868 488.0315)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">+getSpecModuleKey(): String</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="23">+getSpecKey(): String</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="36">+getFile(): File</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="49">+getSpecInfo(): SpecInfo</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="62">+generateADocText(adocFactory: ADocFactory, specsByKey: Map): String</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="75">+getGeneratedADocText(): String</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="88">+getGeneratedLineCount(): int</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="101">+setADocText(adocText: String): void</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="114">+getTestInfosForType(): SortedSet</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="127">+getTestInfosForInheritedMember(): Map</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="140">+setTestInfosForMember(testsForMember: SpecTestInfo[*]): void</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="153">+getTestInfosForMember(): SortedSet</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="166">+hashCode(): int</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="179">+compareTo(o: SpecSection): int</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="192">+equals(obj: Object): boolean</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="205">+toString(): String</tspan>
+          </text>
+        </g>
+        <g id="Graphic_9">
+          <rect x="301.72868" y="460.0315" width="373.82285" height="23" fill="white"/>
+          <rect x="301.72868" y="460.0315" width="373.82285" height="23" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(306.72868 465.0315)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10"> </tspan>
+          </text>
+        </g>
+        <g id="Graphic_8">
+          <rect x="301.72868" y="428.0315" width="373.82285" height="32" fill="white"/>
+          <rect x="301.72868" y="428.0315" width="373.82285" height="32" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(306.72868 433.0315)" fill="black">
+            <tspan font-family="Helvetica" font-size="7" font-weight="700" fill="black" x="171.79765" y="6">adoc..</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="145.8997" y="19">SpecSection</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_3">
+        <g id="Graphic_6">
+          <rect x="12.755906" y="775.8268" width="266.78347" height="101" fill="white"/>
+          <rect x="12.755906" y="775.8268" width="266.78347" height="101" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(17.755906 780.8268)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">+hasProperty(): boolean</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="23">+toPQN(): String</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="36">+getAdocCompatibleAnchorID(): String</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="49">+equals(o: Object): boolean</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="62">+hashCode(): int</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="75">+toString(): String</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="88">+getEscapedAdocAnchorString(str: String): String</tspan>
+          </text>
+        </g>
+        <g id="Graphic_5">
+          <rect x="12.755906" y="557.8268" width="266.78347" height="218" fill="white"/>
+          <rect x="12.755906" y="557.8268" width="266.78347" height="218" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(17.755906 562.8268)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">+property: String</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="23">+delimiter: String</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="36">+element: String</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="49">+module: String</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="62">+extension: String</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="75">+folder: String</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="88">+trueFolder: String</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="101">+project: String</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="114">+path: String</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="127">+repository: String</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="140">+sourceLine: int</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="153">+packageName: String</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="166">+moduleName: String</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="179">+modulePackageCount: int</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="192">+adocPathElems: String[n]</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="205">+adocPath: String</tspan>
+          </text>
+        </g>
+        <g id="Graphic_4">
+          <rect x="12.755906" y="525.8268" width="266.78347" height="32" fill="white"/>
+          <rect x="12.755906" y="525.8268" width="266.78347" height="32" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(17.755906 530.8268)" fill="black">
+            <tspan font-family="Helvetica" font-size="7" font-weight="700" fill="black" x="118.27797" y="6">adoc..</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="92.714" y="19">SourceEntry</tspan>
+          </text>
+        </g>
+      </g>
+    </g>
+  </g>
+</svg>
diff --git a/design/chapters/24_docexporter/images/cd_docexporter_model.svg b/design/chapters/24_docexporter/images/cd_docexporter_model.svg
new file mode 100644
index 0000000..9515752
--- /dev/null
+++ b/design/chapters/24_docexporter/images/cd_docexporter_model.svg
@@ -0,0 +1,430 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xl="http://www.w3.org/1999/xlink" xmlns:dc="http://purl.org/dc/elements/1.1/" viewBox="80.84196 25.940945 1075.513 549.6683" width="1075.513" height="549.6683">
+  <defs>
+    <font-face font-family="Helvetica" font-size="8" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="StickArrow_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -4 10 8" markerWidth="10" markerHeight="8" color="black">
+      <g>
+        <path d="M 8 0 L 0 0 M 0 -3 L 8 0 L 0 3" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="StickArrow_Marker_2" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -4 10 8" markerWidth="10" markerHeight="8" color="#b4b4b4">
+      <g>
+        <path d="M 8 0 L 0 0 M 0 -3 L 8 0 L 0 3" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <font-face font-family="Helvetica" font-size="12" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="11" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="12" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="532.22656" cap-height="719.7266" ascent="770.0195" descent="-229.98047" font-weight="700">
+      <font-face-src>
+        <font-face-name name="Helvetica-Bold"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="7" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="7" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="532.22656" cap-height="719.7266" ascent="770.0195" descent="-229.98047" font-weight="700">
+      <font-face-src>
+        <font-face-name name="Helvetica-Bold"/>
+      </font-face-src>
+    </font-face>
+  </defs>
+  <metadata> Produced by OmniGraffle 7.11 
+    <dc:date>2016-09-01 08:07:21 +0000</dc:date>
+  </metadata>
+  <g id="Canvas_1" stroke="none" stroke-opacity="1" stroke-dasharray="none" fill="none" fill-opacity="1">
+    <title>Canvas 1</title>
+    <rect fill="white" x="80.84196" y="25.940945" width="1075.513" height="549.6683"/>
+    <g id="Canvas_1: UML Elements">
+      <title>UML Elements</title>
+      <g id="Graphic_383">
+        <text transform="translate(532.9573 486.7304)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="0" y="8">rrp</tspan>
+        </text>
+      </g>
+      <g id="Line_382">
+        <line x1="524.84597" y1="460.9387" x2="524.84597" y2="492.20923" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_381">
+        <text transform="translate(358.19778 393.68194)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="0" y="8">doclet</tspan>
+        </text>
+      </g>
+      <g id="Line_380">
+        <line x1="426.56025" y1="411.43867" x2="359.3999" y2="411.722" marker-end="url(#StickArrow_Marker_2)" stroke="#b4b4b4" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_379">
+        <text transform="translate(508.01266 322.88505)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="0" y="8">methodName</tspan>
+        </text>
+      </g>
+      <g id="Line_378">
+        <line x1="524.846" y1="361.9387" x2="543.36893" y2="334.3088" marker-end="url(#StickArrow_Marker_2)" stroke="#b4b4b4" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_377">
+        <text transform="translate(135.56007 404.00665)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="0" y="8">pos</tspan>
+        </text>
+      </g>
+      <g id="Line_376">
+        <line x1="155.00929" y1="433.0615" x2="155.00929" y2="410.79855" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_365">
+        <text transform="translate(845.4496 77.44092)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="0" y="8">specType</tspan>
+        </text>
+      </g>
+      <g id="Line_364">
+        <line x1="772.83725" y1="95.44096" x2="882.9195" y2="95.44092" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_361">
+        <text transform="translate(959.344 179.0475)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="0" y="8">polyfill</tspan>
+        </text>
+      </g>
+      <g id="Line_360">
+        <line x1="920.3967" y1="197.78608" x2="977.6906" y2="196.94243" marker-end="url(#StickArrow_Marker_2)" stroke="#b4b4b4" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_359">
+        <text transform="translate(925.0493 223.16726)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="0" y="8">identifiableElement</tspan>
+        </text>
+      </g>
+      <g id="Line_358">
+        <line x1="920.3967" y1="240.78608" x2="987.9302" y2="241.4567" marker-end="url(#StickArrow_Marker_2)" stroke="#b4b4b4" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_347">
+        <text transform="translate(647.4179 417.64547)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="11">*</tspan>
+        </text>
+      </g>
+      <g id="Graphic_346">
+        <text transform="translate(630.4259 392.72926)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="0" y="8">relatedTypeTests</tspan>
+        </text>
+      </g>
+      <g id="Line_345">
+        <line x1="700.1919" y1="412.0361" x2="633.0314" y2="411.51545" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_344">
+        <text transform="translate(801.8974 280.91993)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="0" y="8">specElementRef</tspan>
+        </text>
+      </g>
+      <g id="Line_343">
+        <line x1="844.2451" y1="356.0361" x2="844.2451" y2="272.18608" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_342">
+        <text transform="translate(110.66751 246.6887)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="0" y="8">parent</tspan>
+        </text>
+      </g>
+      <g id="Line_341">
+        <path d="M 151.63588 220.43868 L 115 220.43868 L 115 264.6887 L 141.73588 264.6887" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_340">
+        <text transform="translate(162.9687 116.22066)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="11">*</tspan>
+        </text>
+      </g>
+      <g id="Graphic_339">
+        <text transform="translate(164.62745 92.22066)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="0" y="8">nestedSpecs</tspan>
+        </text>
+      </g>
+      <g id="Line_338">
+        <path d="M 151.63588 176.18872 L 114 176.18872 L 114 110.22066 L 225.81797 110.22066 L 225.81797 122.03872" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_337">
+        <text transform="translate(432.14774 348.08413)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="11">*</tspan>
+        </text>
+      </g>
+      <g id="Graphic_336">
+        <text transform="translate(431.6695 332.0536)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="0" y="8">specTestInfos</tspan>
+        </text>
+      </g>
+      <g id="Line_335">
+        <line x1="374.1821" y1="308.93872" x2="466.9271" y2="357.3571" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_334">
+        <text transform="translate(276.3262 365.88405)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="0" y="8">doclet</tspan>
+        </text>
+      </g>
+      <g id="Line_333">
+        <line x1="300.00006" y1="308.93872" x2="300" y2="381.8638" marker-end="url(#StickArrow_Marker_2)" stroke="#b4b4b4" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_332">
+        <text transform="translate(177.51002 317.1611)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="0" y="8">pos</tspan>
+        </text>
+      </g>
+      <g id="Line_331">
+        <line x1="225.81795" y1="308.93872" x2="187.89295" y2="335.25465" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_330">
+        <text transform="translate(517.0019 115.22066)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="0" y="8">specKey</tspan>
+        </text>
+      </g>
+      <g id="Line_329">
+        <line x1="448.36424" y1="176.18872" x2="559.46974" y2="121.3243" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_328">
+        <text transform="translate(658.0971 201.57673)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="0" y="8">specElementRef</tspan>
+        </text>
+      </g>
+      <g id="Line_327">
+        <line x1="448.36424" y1="220.43873" x2="758.1936" y2="219.32175" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Group_315">
+        <g id="Graphic_317">
+          <rect x="105.50929" y="364.89855" width="99" height="36" fill="white"/>
+          <rect x="105.50929" y="364.89855" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(110.50929 369.89855)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">+to(index: int): </tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="23">PosInText</tspan>
+          </text>
+        </g>
+        <g id="Graphic_316">
+          <rect x="105.50929" y="340.89855" width="99" height="24" fill="white"/>
+          <rect x="105.50929" y="340.89855" width="99" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(110.50929 345.89855)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="16.269531" y="11">PosInText</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Graphic_312">
+        <rect x="250.5" y="391.7638" width="99" height="40" fill="white"/>
+        <rect x="250.5" y="391.7638" width="99" height="40" stroke="#b4b4b4" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(255.5 396.7638)" fill="#b4b4b4">
+          <tspan font-family="Helvetica" font-size="7" font-weight="400" fill="#b4b4b4" x="27.18286" y="6">«interface»</tspan>
+          <tspan font-family="Helvetica" font-size="7" font-weight="700" fill="#b4b4b4" x="25.053467" y="14">jsdoc.dom..</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="#b4b4b4" x="26.163086" y="27">Doclet</tspan>
+        </text>
+      </g>
+      <g id="Group_309">
+        <g id="Graphic_311">
+          <rect x="351.9326" y="526.10923" width="345.82677" height="49" fill="white"/>
+          <rect x="351.9326" y="526.10923" width="345.82677" height="49" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(356.9326 531.10923)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">+withLine(testMember: SyntaxRelatedTElement): RepoRelativePath</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="23">+compareTo(rrp: RepoRelativePath): int</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="36">+equals(obj: Object): boolean</tspan>
+          </text>
+        </g>
+        <g id="Graphic_310">
+          <rect x="351.9326" y="502.10923" width="345.82677" height="24" fill="white"/>
+          <rect x="351.9326" y="502.10923" width="345.82677" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(356.9326 507.10923)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="116.89874" y="11">RepoRelativePath</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Graphic_307">
+        <rect x="524.1317" y="294.08566" width="99" height="32" fill="white"/>
+        <rect x="524.1317" y="294.08566" width="99" height="32" stroke="#b4b4b4" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(529.1317 299.08566)" fill="#b4b4b4">
+          <tspan font-family="Helvetica" font-size="7" font-weight="700" fill="#b4b4b4" x="1.515625" y="6">org.eclipse.xtext.naming..</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="#b4b4b4" x="2.4882812" y="19">QualifiedName</tspan>
+        </text>
+      </g>
+      <g id="Group_288">
+        <g id="Graphic_290">
+          <rect x="426.56025" y="385.9387" width="196.57143" height="75" fill="white"/>
+          <rect x="426.56025" y="385.9387" width="196.57143" height="75" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(431.56025 390.9387)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">+compareTo(o: SpecTestInfo): int</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="23">+equals(obj: Object): boolean</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="36">+testModuleSpec(): CharSequence</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="49">+testMethodTypeName(): String</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="62">+testMethodName(): String</tspan>
+          </text>
+        </g>
+        <g id="Graphic_289">
+          <rect x="426.56025" y="361.9387" width="196.57143" height="24" fill="white"/>
+          <rect x="426.56025" y="361.9387" width="196.57143" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(431.56025 366.9387)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="56.055244" y="11">SpecTestInfo</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_285">
+        <g id="Graphic_287">
+          <rect x="892.8195" y="50.440945" width="263.03545" height="114" fill="white"/>
+          <rect x="892.8195" y="50.440945" width="263.03545" height="114" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(897.8195 55.440945)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">+startMarker(): String</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="23">+endMarker(): String</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="36">+isCollectorMarker(): boolean</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="49">+hasEnd(): boolean</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="62">+hasName(): boolean</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="75">+isStart(text: String, offset: int): boolean</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="88">+getStartName(pos: PosInText): String</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="101">+findEndMarker(pos: PosInText, name: String): int</tspan>
+          </text>
+        </g>
+        <g id="Graphic_286">
+          <rect x="892.8195" y="26.440945" width="263.03545" height="24" fill="white"/>
+          <rect x="892.8195" y="26.440945" width="263.03545" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(897.8195 31.440945)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="98.61538" y="11">SpecType</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_281">
+        <g id="Graphic_283">
+          <rect x="951.3642" y="532.60923" width="204.49079" height="36" fill="white"/>
+          <rect x="951.3642" y="532.60923" width="204.49079" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(956.3642 537.60923)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">+equals(obj: Object): boolean</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="23">+compareTo(o: SpecChangeEntry): int</tspan>
+          </text>
+        </g>
+        <g id="Graphic_282">
+          <rect x="951.3642" y="508.60923" width="204.49079" height="24" fill="white"/>
+          <rect x="951.3642" y="508.60923" width="204.49079" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(956.3642 513.60923)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="45.565704" y="11">SpecChangeEntry</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_278">
+        <g id="Graphic_280">
+          <rect x="81.34196" y="457.0615" width="147.33465" height="23" fill="white"/>
+          <rect x="81.34196" y="457.0615" width="147.33465" height="23" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(86.34196 462.0615)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">+getMessage(): String</tspan>
+          </text>
+        </g>
+        <g id="Graphic_279">
+          <rect x="81.34196" y="433.0615" width="147.33465" height="24" fill="white"/>
+          <rect x="81.34196" y="433.0615" width="147.33465" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(86.34196 438.0615)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="19.319664" y="11">SpecFormatError</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_262">
+        <g id="Graphic_264">
+          <rect x="568.34646" y="76.440945" width="204.49079" height="62" fill="white"/>
+          <rect x="568.34646" y="76.440945" width="204.49079" height="62" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(573.34646 81.44095)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">+equals(obj: Object): boolean</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="23">+compareTo(specKey: SpecKey): int</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="36">+forType(type: SpecType): SpecKey</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="49">+isCodeElement(): boolean</tspan>
+          </text>
+        </g>
+        <g id="Graphic_263">
+          <rect x="568.34646" y="52.440945" width="204.49079" height="24" fill="white"/>
+          <rect x="568.34646" y="52.440945" width="204.49079" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(573.34646 57.440945)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="71.897736" y="11">SpecKey</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_248">
+        <g id="Graphic_250">
+          <rect x="768.0935" y="200.28608" width="152.30317" height="62" fill="white"/>
+          <rect x="768.0935" y="200.28608" width="152.30317" height="62" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(773.0935 205.28608)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">+getElementAsType(): Type</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="23">+getTypes(): List</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="36">+isCodeRef(): boolean</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="49">+isReqRef(): boolean</tspan>
+          </text>
+        </g>
+        <g id="Graphic_249">
+          <rect x="768.0935" y="176.28608" width="152.30317" height="24" fill="white"/>
+          <rect x="768.0935" y="176.28608" width="152.30317" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(773.0935 181.28608)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="23.801971" y="11">SpecElementRef</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Graphic_237">
+        <rect x="987.5896" y="176.79668" width="99" height="40" fill="white"/>
+        <rect x="987.5896" y="176.79668" width="99" height="40" stroke="#b4b4b4" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(992.5896 181.79668)" fill="#b4b4b4">
+          <tspan font-family="Helvetica" font-size="7" font-weight="400" fill="#b4b4b4" x="27.18286" y="6">«interface»</tspan>
+          <tspan font-family="Helvetica" font-size="7" font-weight="700" fill="#b4b4b4" x="29.327637" y="14">ts.types..</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="#b4b4b4" x="30.938477" y="27">Type</tspan>
+        </text>
+      </g>
+      <g id="Group_234">
+        <g id="Graphic_236">
+          <rect x="700.1919" y="380.0361" width="288.1063" height="88" fill="white"/>
+          <rect x="700.1919" y="380.0361" width="288.1063" height="88" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(705.1919 385.0361)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">+addTypeTestInfo(testInfo: SpecTestInfo): void</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="23">+addMemberTestInfo(member: TMember, testInfo: </tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="36">SpecTestInfo): void</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="49">+getTestsForType(): SortedSet</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="62">+getTestsForMember(member: TMember): SortedSet</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="75">+getTestsForInheritedMembers(): Map</tspan>
+          </text>
+        </g>
+        <g id="Graphic_235">
+          <rect x="700.1919" y="356.0361" width="288.1063" height="24" fill="white"/>
+          <rect x="700.1919" y="356.0361" width="288.1063" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(705.1919 361.0361)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="113.71722" y="11">SpecInfo</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Graphic_226">
+        <rect x="997.8297" y="231.555" width="129.29529" height="40" fill="white"/>
+        <rect x="997.8297" y="231.555" width="129.29529" height="40" stroke="#b4b4b4" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(1002.8297 236.555)" fill="#b4b4b4">
+          <tspan font-family="Helvetica" font-size="7" font-weight="400" fill="#b4b4b4" x="42.330505" y="6">«interface»</tspan>
+          <tspan font-family="Helvetica" font-size="7" font-weight="700" fill="#b4b4b4" x="44.47528" y="14">ts.types..</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="#b4b4b4" x="4.636902" y="27">IdentifiableElement</tspan>
+        </text>
+      </g>
+      <g id="Group_220">
+        <g id="Graphic_222">
+          <rect x="151.63588" y="155.93872" width="296.72836" height="153" fill="white"/>
+          <rect x="151.63588" y="155.93872" width="296.72836" height="153" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(156.63588 160.93872)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">+skip(source: String): int</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="23">+getKey(): SpecKey</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="36">+getTypeName(): String</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="49">+setElementRef(specElementRef: SpecElementRef): void</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="62">+hasElementRef(): boolean</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="75">+getElementRef(): SpecElementRef</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="88">+getFullStartMarker(): String</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="101">+getFullEndMarker(): String</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="114">+addNested(nested: SpecRegion): void</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="127">+getParent(): SpecRegion</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="140">+getNestedSpecs(): Collection</tspan>
+          </text>
+        </g>
+        <g id="Graphic_221">
+          <rect x="151.63588" y="131.93872" width="296.72836" height="24" fill="white"/>
+          <rect x="151.63588" y="131.93872" width="296.72836" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(156.63588 136.93872)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="108.69133" y="11">SpecRegion</tspan>
+          </text>
+        </g>
+      </g>
+    </g>
+  </g>
+</svg>
diff --git a/design/chapters/24_docexporter/images/cd_jsdocreader.svg b/design/chapters/24_docexporter/images/cd_jsdocreader.svg
new file mode 100644
index 0000000..3dd6d88
--- /dev/null
+++ b/design/chapters/24_docexporter/images/cd_jsdocreader.svg
@@ -0,0 +1,356 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xl="http://www.w3.org/1999/xlink" xmlns:dc="http://purl.org/dc/elements/1.1/" viewBox=".4759994 -3.7215002 1122.5437 450.879" width="1122.5437" height="450.879">
+  <defs>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="StickArrow_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -4 10 8" markerWidth="10" markerHeight="8" color="black">
+      <g>
+        <path d="M 8 0 L 0 0 M 0 -3 L 8 0 L 0 3" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <font-face font-family="Helvetica" font-size="8" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="StickArrow_Marker_2" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -4 10 8" markerWidth="10" markerHeight="8" color="#b4b4b4">
+      <g>
+        <path d="M 8 0 L 0 0 M 0 -3 L 8 0 L 0 3" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <font-face font-family="Helvetica" font-size="12" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="UMLInheritance_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -8 14 16" markerWidth="14" markerHeight="16" color="black">
+      <g>
+        <path d="M 12 0 L 0 -7 L 0 7 Z" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <font-face font-family="Helvetica" font-size="7" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="532.22656" cap-height="719.7266" ascent="770.0195" descent="-229.98047" font-weight="700">
+      <font-face-src>
+        <font-face-name name="Helvetica-Bold"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="12" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="532.22656" cap-height="719.7266" ascent="770.0195" descent="-229.98047" font-weight="700">
+      <font-face-src>
+        <font-face-name name="Helvetica-Bold"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="7" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="11" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+  </defs>
+  <metadata> Produced by OmniGraffle 7.11 
+    <dc:date>2017-04-18 09:41:01 +0000</dc:date>
+  </metadata>
+  <g id="Canvas_1" stroke="none" stroke-opacity="1" stroke-dasharray="none" fill="none" fill-opacity="1">
+    <title>Canvas 1</title>
+    <rect fill="white" x=".4759994" y="0" width="1122.5437" height="447.1575"/>
+    <g id="Canvas_1: UML Elements">
+      <title>UML Elements</title>
+      <g id="Line_131">
+        <path d="M 626.4567 339.4075" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_130">
+        <text transform="translate(799.65355 136.25501)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="48.478485" y="8">repoPathHolder</tspan>
+        </text>
+      </g>
+      <g id="Line_129">
+        <line x1="863.1496" y1="112.25984" x2="863.1496" y2="141.75354" marker-end="url(#StickArrow_Marker_2)" stroke="#b4b4b4" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_126">
+        <text transform="translate(1051.6887 284.17823)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="11">*</tspan>
+        </text>
+      </g>
+      <g id="Graphic_125">
+        <text transform="translate(988.4036 282.48552)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="23.612267" y="8">warnings</tspan>
+        </text>
+      </g>
+      <g id="Line_124">
+        <line x1="1041.0236" y1="316.6575" x2="1041.0236" y2="287.55262" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_123">
+        <text transform="translate(676.8751 273.75006)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="17.325249" y="8">issueAcceptor</tspan>
+        </text>
+      </g>
+      <g id="Line_122">
+        <line x1="595.2756" y1="122.50984" x2="696.9328" y2="295.12688" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_121">
+        <text transform="translate(59.53399 193.378)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="31.944717" y="8">containerTypesHelper</tspan>
+        </text>
+      </g>
+      <g id="Line_120">
+        <line x1="165.82674" y1="156.25984" x2="138.41785" y2="211.4406" marker-end="url(#StickArrow_Marker_2)" stroke="#b4b4b4" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_119">
+        <text transform="translate(281.36127 322.4456)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="19.766655" y="8">n4jsdReader</tspan>
+        </text>
+      </g>
+      <g id="Line_118">
+        <line x1="308.97638" y1="156.25984" x2="310.83893" y2="330.25805" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_113">
+        <text transform="translate(573.0421 357.15747)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="0" y="8">issueAcceptor</tspan>
+        </text>
+      </g>
+      <g id="Line_112">
+        <line x1="566.6142" y1="375.1575" x2="616.5567" y2="375.15746" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_111">
+        <text transform="translate(327.81347 270.50813)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="65.73786" y="8">globalScopeProvider</tspan>
+        </text>
+      </g>
+      <g id="Line_110">
+        <line x1="310.9449" y1="340.1575" x2="385.9362" y2="272.91618" marker-end="url(#StickArrow_Marker_2)" stroke="#b4b4b4" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_109">
+        <text transform="translate(225.03665 270.0896)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="39.11152" y="8">n4jsCore</tspan>
+        </text>
+      </g>
+      <g id="Line_108">
+        <line x1="310.9449" y1="340.1575" x2="261.44816" y2="271.34396" marker-end="url(#StickArrow_Marker_2)" stroke="#b4b4b4" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_238">
+        <text transform="translate(406.68126 270.50813)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="54.92691" y="8">n4jsDocHelper</tspan>
+        </text>
+      </g>
+      <g id="Line_237">
+        <line x1="438.77955" y1="340.1575" x2="509.1934" y2="273.13272" marker-end="url(#StickArrow_Marker_2)" stroke="#b4b4b4" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_105">
+        <text transform="translate(54.566657 272.72715)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="63.73786" y="8">containerTypesHelper</tspan>
+        </text>
+      </g>
+      <g id="Line_104">
+        <line x1="183.11024" y1="340.1575" x2="139.4947" y2="274.55142" marker-end="url(#StickArrow_Marker_2)" stroke="#b4b4b4" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_103">
+        <path d="M 646.2992 89.50983 L 620.7992 89.50983 L 620.7992 88.75985 L 608.7756 88.75985" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_102">
+        <path d="M 959.5276 375.15746 L 944.0276 375.15746 L 943.9564 375.1575 L 941.9564 375.1575" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_236">
+        <rect x="499.6142" y="220.30706" width="67" height="46" fill="white"/>
+        <rect x="499.6142" y="220.30706" width="67" height="46" stroke="#b4b4b4" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(504.6142 225.30706)" fill="#b4b4b4">
+          <tspan font-family="Helvetica" font-size="7" font-weight="700" fill="#b4b4b4" x="17.413818" y="6">jsdoc..</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="#b4b4b4" x="2.15625" y="19">N4JSDoc</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="#b4b4b4" x="9.826172" y="33">Helper</tspan>
+        </text>
+      </g>
+      <g id="Graphic_80">
+        <rect x="181.41732" y="223.30706" width="99" height="40" fill="white"/>
+        <rect x="181.41732" y="223.30706" width="99" height="40" stroke="#b4b4b4" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(186.41732 228.30706)" fill="#b4b4b4">
+          <tspan font-family="Helvetica" font-size="7" font-weight="400" fill="#b4b4b4" x="27.18286" y="6">«interface»</tspan>
+          <tspan font-family="Helvetica" font-size="7" font-weight="700" fill="#b4b4b4" x="20.77588" y="14">projectModel..</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="#b4b4b4" x="14.154297" y="27">IN4JSCore</tspan>
+        </text>
+      </g>
+      <g id="Group_76">
+        <g id="Graphic_79">
+          <rect x="626.4567" y="358.6575" width="301.99974" height="88" fill="white"/>
+          <rect x="626.4567" y="358.6575" width="301.99974" height="88" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(631.4567 363.6575)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">+addWarning(message: String, astElement: EObject): void</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="23">+warnings(): String</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="36">+reset(): void</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="49">+addWarning(message: String, astElement: EObject): void</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="62">+warnings(): String</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="75">+reset(): void</tspan>
+          </text>
+        </g>
+        <g id="Graphic_78">
+          <rect x="626.4567" y="335.6575" width="301.99974" height="23" fill="white"/>
+          <rect x="626.4567" y="335.6575" width="301.99974" height="23" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(631.4567 340.6575)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10"> </tspan>
+          </text>
+        </g>
+        <g id="Graphic_77">
+          <rect x="626.4567" y="303.6575" width="301.99974" height="32" fill="white"/>
+          <rect x="626.4567" y="303.6575" width="301.99974" height="32" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(631.4567 308.6575)" fill="black">
+            <tspan font-family="Helvetica" font-size="7" font-weight="400" fill="black" x="128.68272" y="6">«interface»</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="66.6317" y="19">IJSDoc2SpecIssueAcceptor</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_67">
+        <g id="Graphic_70">
+          <rect x="646.2992" y="76.25984" width="433.7008" height="36" fill="white"/>
+          <rect x="646.2992" y="76.25984" width="433.7008" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(651.2992 81.25984)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">+readSpec(newRootDir: File, monitor: SubMonitorMsg): Map</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="23">+computeUpdates(typesByName: Map, old: Map, monitor: SubMonitorMsg): Collection</tspan>
+          </text>
+        </g>
+        <g id="Graphic_69">
+          <rect x="646.2992" y="53.25984" width="433.7008" height="23" fill="white"/>
+          <rect x="646.2992" y="53.25984" width="433.7008" height="23" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(651.2992 58.25984)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10"> </tspan>
+          </text>
+        </g>
+        <g id="Graphic_68">
+          <rect x="646.2992" y="21.259843" width="433.7008" height="32" fill="white"/>
+          <rect x="646.2992" y="21.259843" width="433.7008" height="32" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(651.2992 26.259843)" fill="black">
+            <tspan font-family="Helvetica" font-size="7" font-weight="700" fill="black" x="201.73663" y="6">adoc..</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="130.48126" y="19">JSDoc2ADocSpecProcessor</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_63">
+        <g id="Graphic_66">
+          <rect x="959.5276" y="371.6575" width="162.99213" height="62" fill="white"/>
+          <rect x="959.5276" y="371.6575" width="162.99213" height="62" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(964.5276 376.6575)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">+reset(): void</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="23">+addWarning(message: String, </tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="36">astElement: EObject): void</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="49">+warnings(): String</tspan>
+          </text>
+        </g>
+        <g id="Graphic_65">
+          <rect x="959.5276" y="348.6575" width="162.99213" height="23" fill="white"/>
+          <rect x="959.5276" y="348.6575" width="162.99213" height="23" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(964.5276 353.6575)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10"> </tspan>
+          </text>
+        </g>
+        <g id="Graphic_64">
+          <rect x="959.5276" y="316.6575" width="162.99213" height="32" fill="white"/>
+          <rect x="959.5276" y="316.6575" width="162.99213" height="32" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(964.5276 321.6575)" fill="black">
+            <tspan font-family="Helvetica" font-size="7" font-weight="700" fill="black" x="66.5737" y="6">latex..</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="14.137665" y="19">JSDoc2SpecAcceptor</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Graphic_57">
+        <rect x="55.27559" y="220.30706" width="104.98425" height="46" fill="white"/>
+        <rect x="55.27559" y="220.30706" width="104.98425" height="46" stroke="#b4b4b4" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(60.27559 225.30706)" fill="#b4b4b4">
+          <tspan font-family="Helvetica" font-size="7" font-weight="700" fill="#b4b4b4" x="38.352474" y="6">utils..</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="#b4b4b4" x="2.591732" y="19">ContainerTypes</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="#b4b4b4" x="28.818295" y="33">Helper</tspan>
+        </text>
+      </g>
+      <g id="Graphic_56">
+        <rect x="813.6496" y="151.65354" width="99" height="46" fill="white"/>
+        <rect x="813.6496" y="151.65354" width="99" height="46" stroke="#b4b4b4" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(818.6496 156.65354)" fill="#b4b4b4">
+          <tspan font-family="Helvetica" font-size="7" font-weight="700" fill="#b4b4b4" x="34.38623" y="6">adoc..</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="#b4b4b4" x="2.4853516" y="19">RepoRelativeP</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="#b4b4b4" x="16.498047" y="33">athHolder</tspan>
+        </text>
+      </g>
+      <g id="Group_48">
+        <g id="Graphic_51">
+          <rect x="22.677166" y="68.25984" width="572.5984" height="88" fill="white"/>
+          <rect x="22.677166" y="68.25984" width="572.5984" height="88" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(27.677166 73.25984)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">+readSpec(latexRoot: File, monitor: SubMonitorMsg): Map</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="23">+computeUpdates(typesByName: Map, specsByKey: Map, monitor: SubMonitorMsg): Collection</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="36">+convert(docRoot: File, projects: IN4JSProject[*], resSetProvider: Function, monitor: SubMonitorMsg): Collection</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="49">+getWarnings(): String</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="62">+resetIssues(): void</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="75">+readN4JSDs(projects: IN4JSProject[*], resSetProvider: Function, monitor: SubMonitorMsg): Map</tspan>
+          </text>
+        </g>
+        <g id="Graphic_50">
+          <rect x="22.677166" y="45.259843" width="572.5984" height="23" fill="white"/>
+          <rect x="22.677166" y="45.259843" width="572.5984" height="23" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(27.677166 50.25984)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10"> </tspan>
+          </text>
+        </g>
+        <g id="Graphic_49">
+          <rect x="22.677166" y="21.259843" width="572.5984" height="24" fill="white"/>
+          <rect x="22.677166" y="21.259843" width="572.5984" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(27.677166 26.259843)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="215.59805" y="11">JSDoc2SpecProcessor</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Graphic_40">
+        <rect x="364.25197" y="220.30706" width="116.22047" height="46" fill="white"/>
+        <rect x="364.25197" y="220.30706" width="116.22047" height="46" stroke="#b4b4b4" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(369.25197 225.30706)" fill="#b4b4b4">
+          <tspan font-family="Helvetica" font-size="7" font-weight="700" fill="#b4b4b4" x="37.748177" y="6">scoping..</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="#b4b4b4" x="1.42762" y="19">N4JSGlobalScope</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="#b4b4b4" x="28.767464" y="33">Provider</tspan>
+        </text>
+      </g>
+      <g id="Group_21">
+        <g id="Graphic_24">
+          <rect x="55.27559" y="387.1575" width="511.3386" height="23" fill="white"/>
+          <rect x="55.27559" y="387.1575" width="511.3386" height="23" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(60.27559 392.1575)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">+readN4JSDs(projects: IN4JSProject[*], resSetProvider: Function, monitor: SubMonitorMsg): Map</tspan>
+          </text>
+        </g>
+        <g id="Graphic_23">
+          <rect x="55.27559" y="364.1575" width="511.3386" height="23" fill="white"/>
+          <rect x="55.27559" y="364.1575" width="511.3386" height="23" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(60.27559 369.1575)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10"> </tspan>
+          </text>
+        </g>
+        <g id="Graphic_22">
+          <rect x="55.27559" y="340.1575" width="511.3386" height="24" fill="white"/>
+          <rect x="55.27559" y="340.1575" width="511.3386" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(60.27559 345.1575)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="210.98375" y="11">N4JSDReader</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_12">
+        <g id="Graphic_15">
+          <rect x="988.5315" y="254.65262" width="104.98425" height="23" fill="white"/>
+          <rect x="988.5315" y="254.65262" width="104.98425" height="23" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(993.5315 259.65262)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">+toString(): String</tspan>
+          </text>
+        </g>
+        <g id="Graphic_14">
+          <rect x="988.5315" y="231.65262" width="104.98425" height="23" fill="white"/>
+          <rect x="988.5315" y="231.65262" width="104.98425" height="23" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(993.5315 236.65262)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10"> </tspan>
+          </text>
+        </g>
+        <g id="Graphic_13">
+          <rect x="988.5315" y="199.65262" width="104.98425" height="32" fill="white"/>
+          <rect x="988.5315" y="199.65262" width="104.98425" height="32" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(993.5315 204.65262)" fill="black">
+            <tspan font-family="Helvetica" font-size="7" font-weight="700" fill="black" x=".4130211" y="6">latex.JSDoc2SpecAcceptor..</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="32.14935" y="19">Issue</tspan>
+          </text>
+        </g>
+      </g>
+    </g>
+  </g>
+</svg>
diff --git a/design/chapters/24_docexporter/images/cd_latexexporter.svg b/design/chapters/24_docexporter/images/cd_latexexporter.svg
new file mode 100644
index 0000000..b1fbafa
--- /dev/null
+++ b/design/chapters/24_docexporter/images/cd_latexexporter.svg
@@ -0,0 +1,319 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xl="http://www.w3.org/1999/xlink" xmlns:dc="http://purl.org/dc/elements/1.1/" viewBox="0 0 1110 607" width="1110" height="607">
+  <defs>
+    <font-face font-family="Helvetica" font-size="8" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="StickArrow_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -4 10 8" markerWidth="10" markerHeight="8" color="black">
+      <g>
+        <path d="M 8 0 L 0 0 M 0 -3 L 8 0 L 0 3" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <font-face font-family="Helvetica" font-size="12" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="StickArrow_Marker_2" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -4 10 8" markerWidth="10" markerHeight="8" color="#b4b4b4">
+      <g>
+        <path d="M 8 0 L 0 0 M 0 -3 L 8 0 L 0 3" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="UMLInheritance_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -8 14 16" markerWidth="14" markerHeight="16" color="black">
+      <g>
+        <path d="M 12 0 L 0 -7 L 0 7 Z" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <font-face font-family="Helvetica" font-size="7" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="532.22656" cap-height="719.7266" ascent="770.0195" descent="-229.98047" font-weight="700">
+      <font-face-src>
+        <font-face-name name="Helvetica-Bold"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="12" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="532.22656" cap-height="719.7266" ascent="770.0195" descent="-229.98047" font-weight="700">
+      <font-face-src>
+        <font-face-name name="Helvetica-Bold"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="7" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="11" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+  </defs>
+  <metadata> Produced by OmniGraffle 7.11 
+    <dc:date>2016-09-01 08:30:22 +0000</dc:date>
+  </metadata>
+  <g id="Canvas_1" stroke="none" stroke-opacity="1" stroke-dasharray="none" fill="none" fill-opacity="1">
+    <title>Canvas 1</title>
+    <g id="Canvas_1: Layer 1">
+      <title>Layer 1</title>
+      <g id="Graphic_388">
+        <text transform="translate(574.76244 349.30992)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="0" y="8">issueAcceptor</tspan>
+        </text>
+      </g>
+      <g id="Line_387">
+        <line x1="658.0606" y1="278.4475" x2="600.2801" y2="379.8818" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_386">
+        <text transform="translate(918.0068 467.45275)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="11">*</tspan>
+        </text>
+      </g>
+      <g id="Graphic_385">
+        <text transform="translate(909.228 443.45275)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="0" y="8">warnings</tspan>
+        </text>
+      </g>
+      <g id="Line_384">
+        <line x1="886.5732" y1="461.45275" x2="928.3677" y2="461.45275" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_375">
+        <text transform="translate(507.4301 330.67465)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="0" y="8">issueAcceptor</tspan>
+        </text>
+      </g>
+      <g id="Line_374">
+        <line x1="519.55316" y1="179.00134" x2="519.55316" y2="378.58403" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_373">
+        <text transform="translate(185.42385 184.30956)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="0" y="8">containerTypesHelper</tspan>
+        </text>
+      </g>
+      <g id="Line_372">
+        <line x1="380.95765" y1="179.00134" x2="183.90895" y2="208.50821" marker-end="url(#StickArrow_Marker_2)" stroke="#b4b4b4" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_371">
+        <text transform="translate(371.34006 218.19038)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="0" y="8">n4jsdReader</tspan>
+        </text>
+      </g>
+      <g id="Line_370">
+        <line x1="380.95765" y1="179.00134" x2="381.02897" y2="228.21025" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_369">
+        <text transform="translate(609.282 203.47433)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="0" y="8">laTeXRegionReader</tspan>
+        </text>
+      </g>
+      <g id="Line_368">
+        <line x1="658.1486" y1="179.00134" x2="658.08266" y2="208.5475" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_367">
+        <text transform="translate(830.377 98.50133)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="0" y="8">specFactory</tspan>
+        </text>
+      </g>
+      <g id="Line_366">
+        <line x1="796.7441" y1="116.50136" x2="860.9418" y2="116.50133" marker-end="url(#StickArrow_Marker_2)" stroke="#b4b4b4" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_357">
+        <text transform="translate(429.26557 362.48755)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="0" y="8">issueAcceptor</tspan>
+        </text>
+      </g>
+      <g id="Line_356">
+        <line x1="434.7933" y1="311.11024" x2="442.59094" y2="378.64936" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_355">
+        <text transform="translate(151.15378 301.68827)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="0" y="8">globalScopeProvider</tspan>
+        </text>
+      </g>
+      <g id="Line_354">
+        <line x1="273.5433" y1="292.86023" x2="173.99961" y2="324.86645" marker-end="url(#StickArrow_Marker_2)" stroke="#b4b4b4" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_353">
+        <text transform="translate(182.32674 261.4993)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="0" y="8">n4jsCore</tspan>
+        </text>
+      </g>
+      <g id="Line_352">
+        <line x1="273.5433" y1="274.61022" x2="183.99702" y2="280.4644" marker-end="url(#StickArrow_Marker_2)" stroke="#b4b4b4" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_351">
+        <text transform="translate(287.9751 329.53103)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="0" y="8">n4jsDocHelper</tspan>
+        </text>
+      </g>
+      <g id="Line_350">
+        <line x1="327.2933" y1="311.11024" x2="327.2165" y2="332.5876" marker-end="url(#StickArrow_Marker_2)" stroke="#b4b4b4" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_349">
+        <text transform="translate(163.24704 221.21513)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="0" y="8">containerTypesHelper</tspan>
+        </text>
+      </g>
+      <g id="Line_348">
+        <line x1="273.5433" y1="256.36024" x2="183.75512" y2="235.24106" marker-end="url(#StickArrow_Marker_2)" stroke="#b4b4b4" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_326">
+        <path d="M 737.0079 461.45275 L 721.5079 461.45275 L 686.7067 461.48404 L 684.7067 461.48404" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_323">
+        <rect x="267.5433" y="342.48755" width="119.27559" height="32" fill="white"/>
+        <rect x="267.5433" y="342.48755" width="119.27559" height="32" stroke="#b4b4b4" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(272.5433 347.48755)" fill="#b4b4b4">
+          <tspan font-family="Helvetica" font-size="7" font-weight="700" fill="#b4b4b4" x="43.551613" y="6">jsdoc..</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="#b4b4b4" x="9.620216" y="19">N4JSDocHelper</tspan>
+        </text>
+      </g>
+      <g id="Graphic_304">
+        <rect x="75.11811" y="271.11024" width="99" height="40" fill="white"/>
+        <rect x="75.11811" y="271.11024" width="99" height="40" stroke="#b4b4b4" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(80.11811 276.11024)" fill="#b4b4b4">
+          <tspan font-family="Helvetica" font-size="7" font-weight="400" fill="#b4b4b4" x="27.18286" y="6">«interface»</tspan>
+          <tspan font-family="Helvetica" font-size="7" font-weight="700" fill="#b4b4b4" x="20.77588" y="14">projectModel..</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="#b4b4b4" x="14.154297" y="27">IN4JSCore</tspan>
+        </text>
+      </g>
+      <g id="Group_301">
+        <g id="Graphic_303">
+          <rect x="367.8996" y="420.48403" width="303.3071" height="114" fill="white"/>
+          <rect x="367.8996" y="420.48403" width="303.3071" height="114" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(372.8996 425.48403)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">+addWarning(message: String, pos: PosInText): void</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="23">+addWarning(message: String, astElement: EObject): void</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="36">+warnings(): String</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="49">+reset(): void</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="62">+addWarning(message: String, pos: PosInText): void</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="75">+addWarning(message: String, astElement: EObject): void</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="88">+warnings(): String</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="101">+reset(): void</tspan>
+          </text>
+        </g>
+        <g id="Graphic_302">
+          <rect x="367.8996" y="388.48403" width="303.3071" height="32" fill="white"/>
+          <rect x="367.8996" y="388.48403" width="303.3071" height="32" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(372.8996 393.48403)" fill="black">
+            <tspan font-family="Helvetica" font-size="7" font-weight="400" fill="black" x="129.33641" y="6">«interface»</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="67.285385" y="19">IJSDoc2SpecIssueAcceptor</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_297">
+        <g id="Graphic_299">
+          <rect x="569.3817" y="242.4475" width="177.35775" height="36" fill="white"/>
+          <rect x="569.3817" y="242.4475" width="177.35775" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(574.3817 247.4475)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">+readLatexSpec(latexRoot: File, </tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="23">monitor: IProgressMonitor): Map</tspan>
+          </text>
+        </g>
+        <g id="Graphic_298">
+          <rect x="569.3817" y="218.4475" width="177.35775" height="24" fill="white"/>
+          <rect x="569.3817" y="218.4475" width="177.35775" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(574.3817 223.4475)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="25.43962" y="11">LaTeXRegionReader</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_294">
+        <g id="Graphic_296">
+          <rect x="737.0079" y="461.95276" width="149.56534" height="23" fill="white"/>
+          <rect x="737.0079" y="461.95276" width="149.56534" height="23" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(742.0079 466.95276)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10"> </tspan>
+          </text>
+        </g>
+        <g id="Graphic_295">
+          <rect x="737.0079" y="437.95276" width="149.56534" height="24" fill="white"/>
+          <rect x="737.0079" y="437.95276" width="149.56534" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(742.0079 442.95276)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="7.424271" y="11">JSDoc2SpecAcceptor</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Graphic_273">
+        <rect x="75.11811" y="198.47433" width="99" height="46" fill="white"/>
+        <rect x="75.11811" y="198.47433" width="99" height="46" stroke="#b4b4b4" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(80.11811 203.47433)" fill="#b4b4b4">
+          <tspan font-family="Helvetica" font-size="7" font-weight="700" fill="#b4b4b4" x="35.36035" y="6">utils..</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="#b4b4b4" x="2.9365234" y="19">ContainerType</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="#b4b4b4" x="22.489258" y="33">sHelper</tspan>
+        </text>
+      </g>
+      <g id="Group_265">
+        <g id="Graphic_267">
+          <rect x="242.3622" y="78.00134" width="554.3819" height="101" fill="white"/>
+          <rect x="242.3622" y="78.00134" width="554.3819" height="101" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(247.3622 83.00134)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">+convert(latexRoot: File, projects: IN4JSProject[*], resSetProvider: Function, monitor: IProgressMonitor): Set</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="23">+getWarnings(): String</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="36">+resetIssues(): void</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="49">+readLatexSpec(latexRoot: File, monitor: IProgressMonitor): Map</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="62">+readN4JSDs(projects: IN4JSProject[*], resSetProvider: Function, monitor: IProgressMonitor): Map</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="75">+computeUpdates(typesByName: Map, specsByKey: Map, monitor: IProgressMonitor): Set</tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="88">+compare(o1: SpecRegion, o2: SpecRegion): int</tspan>
+          </text>
+        </g>
+        <g id="Graphic_266">
+          <rect x="242.3622" y="54.001336" width="554.3819" height="24" fill="white"/>
+          <rect x="242.3622" y="54.001336" width="554.3819" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(247.3622 59.001336)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="206.48978" y="11">JSDoc2SpecProcessor</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Graphic_252">
+        <rect x="75.11811" y="327.8968" width="119.27559" height="46" fill="white"/>
+        <rect x="75.11811" y="327.8968" width="119.27559" height="46" stroke="#b4b4b4" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(80.11811 332.8968)" fill="#b4b4b4">
+          <tspan font-family="Helvetica" font-size="7" font-weight="700" fill="#b4b4b4" x="39.275734" y="6">scoping..</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="#b4b4b4" x="2.9551773" y="19">N4JSGlobalScope</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="#b4b4b4" x="30.29502" y="33">Provider</tspan>
+        </text>
+      </g>
+      <g id="Graphic_245">
+        <rect x="870.8418" y="104.50134" width="99" height="24" fill="white"/>
+        <rect x="870.8418" y="104.50134" width="99" height="24" stroke="#b4b4b4" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(875.8418 109.50134)" fill="#b4b4b4">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="#b4b4b4" x="8.485352" y="11">SpecFactory</tspan>
+        </text>
+      </g>
+      <g id="Group_238">
+        <g id="Graphic_240">
+          <rect x="273.5433" y="262.11024" width="215" height="49" fill="white"/>
+          <rect x="273.5433" y="262.11024" width="215" height="49" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(278.5433 267.11024)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10">+readN4JSDs(projects: IN4JSProject[*], </tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="23">resSetProvider: Function, monitor: </tspan>
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="36">IProgressMonitor): Map</tspan>
+          </text>
+        </g>
+        <g id="Graphic_239">
+          <rect x="273.5433" y="238.11024" width="215" height="24" fill="white"/>
+          <rect x="273.5433" y="238.11024" width="215" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(278.5433 243.11024)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="62.81445" y="11">N4JSDReader</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_228">
+        <g id="Graphic_230">
+          <rect x="938.2677" y="461.95276" width="99" height="23" fill="white"/>
+          <rect x="938.2677" y="461.95276" width="99" height="23" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(943.2677 466.95276)" fill="black">
+            <tspan font-family="Helvetica" font-size="11" font-weight="400" fill="black" x="0" y="10"> </tspan>
+          </text>
+        </g>
+        <g id="Graphic_229">
+          <rect x="938.2677" y="437.95276" width="99" height="24" fill="white"/>
+          <rect x="938.2677" y="437.95276" width="99" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(943.2677 442.95276)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="29.157227" y="11">Issue</tspan>
+          </text>
+        </g>
+      </g>
+    </g>
+  </g>
+</svg>
diff --git a/design/chapters/25_renameRefactoring/images/rename_refactoring_communication_diagram_part1.svg b/design/chapters/25_renameRefactoring/images/rename_refactoring_communication_diagram_part1.svg
new file mode 100644
index 0000000..e5423b9
--- /dev/null
+++ b/design/chapters/25_renameRefactoring/images/rename_refactoring_communication_diagram_part1.svg
@@ -0,0 +1,290 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg xmlns:xl="http://www.w3.org/1999/xlink" xmlns="http://www.w3.org/2000/svg" xmlns:dc="http://purl.org/dc/elements/1.1/" version="1.1" viewBox="138 165 1065 543" width="1065" height="543">
+  <defs>
+    <font-face font-family="Helvetica" font-size="12" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="532.22656" cap-height="719.7266" ascent="770.0195" descent="-229.98047" font-weight="700">
+      <font-face-src>
+        <font-face-name name="Helvetica-Bold"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="12" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="StickArrow_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -4 10 8" markerWidth="10" markerHeight="8" color="black">
+      <g>
+        <path d="M 8 0 L 0 0 M 0 -3 L 8 0 L 0 3" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <font-face font-family="Helvetica Neue" font-size="12" panose-1="2 0 5 3 0 0 0 2 0 4" units-per-em="1000" underline-position="-100" underline-thickness="50" slope="0" x-height="517" cap-height="714" ascent="951.9958" descent="-212.99744" font-weight="400">
+      <font-face-src>
+        <font-face-name name="HelveticaNeue"/>
+      </font-face-src>
+    </font-face>
+  </defs>
+  <metadata> Produced by OmniGraffle 7.10.1 
+    <dc:date>2019-03-21 13:06:28 +0000</dc:date>
+  </metadata>
+  <g id="Canvas_1" fill-opacity="1" stroke="none" fill="none" stroke-opacity="1" stroke-dasharray="none">
+    <title>Canvas 1</title>
+    <rect fill="white" x="138" y="165" width="1065" height="543"/>
+    <g id="Canvas_1: Layer 1">
+      <title>Layer 1</title>
+      <g id="Group_5">
+        <g id="Graphic_7">
+          <rect x="139.407" y="166.25" width="1062.593" height="540.75" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_6">
+          <path d="M 139.407 166.25 L 489.5 166.25 L 489.5 192.99038 L 460.3257 219.73077 L 139.407 219.73045 Z" fill="white"/>
+          <path d="M 139.407 166.25 L 489.5 166.25 L 489.5 192.99038 L 460.3257 219.73077 L 139.407 219.73045 Z" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(144.407 185.99038)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="0" y="11">interaction</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" y="11"> Xtext’s Direct Rename Refactoring UI interaction</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_8">
+        <g id="Graphic_15">
+          <text transform="translate(169.99316 317.5)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="0" y="11">N4JS User</tspan>
+          </text>
+        </g>
+        <g id="Group_9">
+          <g id="Graphic_14">
+            <circle cx="198.9997" cy="285.2517" r="6.7507107869563" fill="white"/>
+            <circle cx="198.9997" cy="285.2517" r="6.7507107869563" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Line_13">
+            <line x1="199" y1="292.001" x2="199" y2="302.116" stroke="black" stroke-linecap="butt" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Line_12">
+            <line x1="199" y1="302.116" x2="191.5" y2="315.617" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Line_11">
+            <line x1="199" y1="302.116" x2="206.5" y2="315.617" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+          <g id="Line_10">
+            <line x1="206.5" y1="297.501" x2="191.5" y2="297.376" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          </g>
+        </g>
+      </g>
+      <g id="Group_17">
+        <g id="Graphic_18">
+          <rect x="310.75" y="287" width="154" height="38" fill="yellow"/>
+          <rect x="310.75" y="287" width="154" height="38" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(315.75 292)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="2.982422" y="11">:DefaultRenameElement</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="49.66113" y="25">Handler</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_21">
+        <g id="Graphic_22">
+          <rect x="600.5" y="287" width="134" height="38" fill="white"/>
+          <rect x="600.5" y="287" width="134" height="38" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(605.5 292)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="3.321289" y="11">:RenameRefactoring</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="33.333008" y="25">Controller</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Line_23">
+        <line x1="221.5" y1="306" x2="310.75" y2="306" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_24">
+        <line x1="464.75" y1="306" x2="600.5" y2="306" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_25">
+        <line x1="237" y1="294" x2="288.1" y2="294" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_26">
+        <text transform="translate(240.834 269.5)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="12" font-weight="400" fill="black" x="40856207e-20" y="11">1: execute()</tspan>
+        </text>
+      </g>
+      <g id="Graphic_27">
+        <text transform="translate(479.849 269.5)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="12" font-weight="400" fill="black" x="0" y="11">2: startRefactoring()</tspan>
+        </text>
+      </g>
+      <g id="Line_31">
+        <line x1="486.289" y1="294" x2="569.061" y2="294" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Group_32">
+        <g id="Graphic_33">
+          <rect x="912.5" y="294" width="113.625" height="24" fill="white"/>
+          <rect x="912.5" y="294" width="113.625" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(917.5 299)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="1.8085938" y="11">:IRenameSupport</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Line_34">
+        <line x1="734.5" y1="306" x2="912.5" y2="306" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_36">
+        <line x1="791" y1="294" x2="873.772" y2="294" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_37">
+        <text transform="translate(763.806 269.5)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="12" font-weight="400" fill="black" x="0" y="11">3.2: startDirectRefactoring()</tspan>
+        </text>
+      </g>
+      <g id="Group_38">
+        <g id="Graphic_39">
+          <rect x="327" y="391" width="129" height="38" fill="white"/>
+          <rect x="327" y="391" width="129" height="38" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(332 396)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x=".8212891" y="11">:RenameRefactoring</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="33.82422" y="25">Executor</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_40">
+        <g id="Graphic_41">
+          <rect x="579.282" y="398" width="180.764" height="24" fill="white"/>
+          <rect x="579.282" y="398" width="180.764" height="24" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(584.282 403)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="25.546062" y="11">:IWorkBenchWindow</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Line_42">
+        <line x1="456" y1="410" x2="579.282" y2="410" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_44">
+        <line x1="475.032" y1="400.5" x2="557.804" y2="400.5" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_47">
+        <text transform="translate(635.334 333.5)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="12" font-weight="400" fill="black" x="40856207e-20" y="11">4: execute()</tspan>
+        </text>
+      </g>
+      <g id="Group_48">
+        <g id="Graphic_49">
+          <rect x="842.402" y="391" width="180.764" height="38" fill="white"/>
+          <rect x="842.402" y="391" width="180.764" height="38" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(847.402 396)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="3.708172" y="11">:CheckConditionsAndCreate</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="36.046062" y="25">ChangeRunnable</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Line_51">
+        <line x1="765.1298" y1="400.5" x2="827.4182" y2="400.5" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_52">
+        <text transform="translate(782.774 380)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="12" font-weight="400" fill="black" x="7283063e-19" y="11">6: run()</tspan>
+        </text>
+      </g>
+      <g id="Line_55">
+        <path d="M 1026.125 306 L 1033.125 306 L 1033.125 358 L 320 358 L 320 410 L 327 410" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_56">
+        <path d="M 1023.166 410 L 1030.166 410 L 1030.166 464 L 313.875 464 L 313.875 519 L 320.875 519" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_57">
+        <text transform="translate(499.191 380)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="12" font-weight="400" fill="black" x="7283063e-19" y="11">5: run()</tspan>
+        </text>
+      </g>
+      <g id="Graphic_58">
+        <text transform="translate(611.658 434.5)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="12" font-weight="400" fill="black" x="0" y="11">7: checkAllConditions()</tspan>
+        </text>
+      </g>
+      <g id="Line_59">
+        <line x1="760.046" y1="410" x2="842.402" y2="410" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_60">
+        <line x1="698" y1="455.875" x2="646.9" y2="455.875" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_61">
+        <line x1="696.836" y1="350" x2="645.736" y2="350" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Group_53">
+        <g id="Graphic_54">
+          <rect x="320.875" y="500" width="113.625" height="38" fill="white"/>
+          <rect x="320.875" y="500" width="113.625" height="38" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(325.875 505)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="2.4560547" y="11">:ProcessorBased</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="18.475586" y="25">Refactoring</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_96">
+        <g id="Graphic_97">
+          <rect x="744.613" y="500" width="113.625" height="38" fill="yellow"/>
+          <rect x="744.613" y="500" width="113.625" height="38" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(749.613 505)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="3.1298828" y="11">:RenameElement</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="22.46289" y="25">Processor</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Line_98">
+        <line x1="553.283" y1="509.5" x2="636.055" y2="509.5" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_99">
+        <text transform="translate(517.341 491)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="12" font-weight="400" fill="black" x="42632564e-21" y="11">8.1: checkInitialConditions()</tspan>
+        </text>
+      </g>
+      <g id="Line_100">
+        <line x1="434.5" y1="519" x2="744.613" y2="519" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_101">
+        <line x1="549.089" y1="546.75" x2="631.861" y2="546.75" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_102">
+        <text transform="translate(517.341 525.5)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="12" font-weight="400" fill="black" x="0" y="11">8.2: checkFinalConditions()</tspan>
+        </text>
+      </g>
+      <g id="Group_138">
+        <g id="Graphic_139">
+          <rect x="758.806" y="604.25" width="84.836" height="38" fill="white"/>
+          <rect x="758.806" y="604.25" width="84.836" height="38" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(763.806 609.25)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="2.083039" y="11">:Refactoring</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="6.4101875" y="25">Participant</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Line_140">
+        <path d="M 452.9531 519.78906 L 452.9531 623.25 L 758.806 623.25" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_141">
+        <line x1="549.089" y1="651.75" x2="631.861" y2="651.75" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_142">
+        <text transform="translate(517.341 631.125)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="12" font-weight="400" fill="black" x="0" y="11">8.3 *: checkConditions()</tspan>
+        </text>
+      </g>
+      <g id="Group_145">
+        <g id="Graphic_146">
+          <rect x="944" y="214" width="142.29881" height="38" fill="yellow"/>
+          <rect x="944" y="214" width="142.29881" height="38" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(949 219)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="1.4853437" y="11">:ILinkedPositionGroup</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="36.808586" y="25">Calculator</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Line_147">
+        <path d="M 734.5 306 L 756.5 306 L 756.5 233 L 944 233" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_148">
+        <text transform="translate(763.806 195.75)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="12" font-weight="400" fill="black" x="0" y="11">3.1: getLinkedPositionGroup()</tspan>
+        </text>
+      </g>
+      <g id="Line_149">
+        <line x1="791" y1="220" x2="873.772" y2="220" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+    </g>
+  </g>
+</svg>
diff --git a/design/chapters/25_renameRefactoring/images/rename_refactoring_communication_diagram_part2.svg b/design/chapters/25_renameRefactoring/images/rename_refactoring_communication_diagram_part2.svg
new file mode 100644
index 0000000..b49f866
--- /dev/null
+++ b/design/chapters/25_renameRefactoring/images/rename_refactoring_communication_diagram_part2.svg
@@ -0,0 +1,205 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg xmlns:xl="http://www.w3.org/1999/xlink" xmlns="http://www.w3.org/2000/svg" xmlns:dc="http://purl.org/dc/elements/1.1/" version="1.1" viewBox="-492 -611 1220 538" width="1220" height="538">
+  <defs>
+    <font-face font-family="Helvetica" font-size="12" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="532.22656" cap-height="719.7266" ascent="770.0195" descent="-229.98047" font-weight="700">
+      <font-face-src>
+        <font-face-name name="Helvetica-Bold"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="12" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="StickArrow_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -4 10 8" markerWidth="10" markerHeight="8" color="black">
+      <g>
+        <path d="M 8 0 L 0 0 M 0 -3 L 8 0 L 0 3" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <font-face font-family="Helvetica Neue" font-size="12" panose-1="2 0 5 3 0 0 0 2 0 4" units-per-em="1000" underline-position="-100" underline-thickness="50" slope="0" x-height="517" cap-height="714" ascent="951.9958" descent="-212.99744" font-weight="400">
+      <font-face-src>
+        <font-face-name name="HelveticaNeue"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="8" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+  </defs>
+  <metadata> Produced by OmniGraffle 7.10.1 
+    <dc:date>2019-03-21 13:16:12 +0000</dc:date>
+  </metadata>
+  <g id="Canvas_1" fill-opacity="1" stroke="none" fill="none" stroke-opacity="1" stroke-dasharray="none">
+    <title>Canvas 1</title>
+    <rect fill="white" x="-492" y="-611" width="1220" height="538"/>
+    <g id="Canvas_1: Layer 1">
+      <title>Layer 1</title>
+      <g id="Group_88">
+        <g id="Graphic_90">
+          <rect x="-491" y="-610" width="1217.7966" height="536" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_89">
+          <path d="M -491 -610 L -54.471677 -610 L -54.471677 -591 L -90.84889 -572 L -491 -572.0002 Z" fill="white"/>
+          <path d="M -491 -610 L -54.471677 -610 L -54.471677 -591 L -90.84889 -572 L -491 -572.0002 Z" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(-486 -598)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="0" y="11">interaction</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" y="11"> RenameElementProcessor’s interaction with other classes</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Group_29">
+        <g id="Graphic_30">
+          <rect x="-346.58" y="-491.5" width="113.625" height="38" fill="yellow"/>
+          <rect x="-346.58" y="-491.5" width="113.625" height="38" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(-341.58 -486.5)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="3.1298828" y="11">:RenameElement</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="22.46289" y="25">Processor</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Line_28">
+        <line x1="-172.99688" y1="-483.65686" x2="-90.22488" y2="-483.65686" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_27">
+        <text transform="translate(195.21168 -505)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="12" font-weight="400" fill="black" x="8029133e-19" y="11">1.1: accept()</tspan>
+        </text>
+      </g>
+      <g id="Line_26">
+        <line x1="-232.955" y1="-473.5" x2="-27.588643" y2="-472.5" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Group_24">
+        <g id="Graphic_25">
+          <rect x="-27.588643" y="-374" width="122.454" height="38" fill="white"/>
+          <rect x="-27.588643" y="-374" width="122.454" height="38" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(-22.588643 -369)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="2.5434062" y="11">:ReferenceUpdater</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="25.216258" y="25">Dispatcher</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Line_23">
+        <line x1="-232.955" y1="-473.5" x2="-27.588643" y2="-355" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_22">
+        <line x1="-190.15608" y1="-408.1553" x2="-125.31679" y2="-375.95125" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_21">
+        <text transform="translate(-201.25795 -441.771) rotate(28)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="12" font-weight="400" fill="black" x="0" y="11">2: createReferenceUpdates</tspan>
+        </text>
+      </g>
+      <g id="Line_20">
+        <line x1="94.86536" y1="-355" x2="279.4592" y2="-353" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_19">
+        <line x1="147.51812" y1="-364.07843" x2="230.29012" y2="-364.07843" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_18">
+        <text transform="translate(127.39216 -391.07843)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="12" font-weight="400" fill="black" x="0" y="11">2.1: findAllReferences()</tspan>
+        </text>
+      </g>
+      <g id="Line_17">
+        <line x1="94.86536" y1="-355" x2="279.4592" y2="-264" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_16">
+        <text transform="translate(92.30417 -349.31634) rotate(28)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="12" font-weight="400" fill="black" x="30.776" y="11">2.2 *: createReferenceUpdates</tspan>
+        </text>
+      </g>
+      <g id="Line_15">
+        <line x1="149.5" y1="-293.80392" x2="202.47415" y2="-262.26103" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_14">
+        <rect x="-27.588643" y="-493.5" width="113.625" height="42" fill="yellow"/>
+        <rect x="-27.588643" y="-493.5" width="113.625" height="42" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(-22.588643 -484.5)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="32.021484" y="8">«interface»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x=".7949219" y="21">:IRenameStrategy</tspan>
+        </text>
+      </g>
+      <g id="Graphic_13">
+        <rect x="279.4592" y="-374" width="113.625" height="42" fill="yellow"/>
+        <rect x="279.4592" y="-374" width="113.625" height="42" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(284.4592 -365)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="32.021484" y="8">«interface»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x=".7978516" y="21">:IReferenceFinder</tspan>
+        </text>
+      </g>
+      <g id="Graphic_12">
+        <rect x="279.4592" y="-285" width="122.454" height="42" fill="white"/>
+        <rect x="279.4592" y="-285" width="122.454" height="42" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(284.4592 -276)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="36.435984" y="8">«interface»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x=".8764141" y="21">:IReferenceUpdater</tspan>
+        </text>
+      </g>
+      <g id="Group_10">
+        <g id="Graphic_11">
+          <rect x="537.42" y="-283" width="174.16" height="38" fill="yellow"/>
+          <rect x="537.42" y="-283" width="174.16" height="38" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(542.42 -278)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x=".7225781" y="11">:RefactoringCrossReference</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="55.396406" y="25">Serializer</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Graphic_9">
+        <text transform="translate(372.5 -297.189)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="12" font-weight="400" fill="black" x="48.788" y="11">2.2.1: getCrossRefText()</tspan>
+        </text>
+      </g>
+      <g id="Line_8">
+        <line x1="424.66447" y1="-273.05882" x2="507.4365" y2="-273.05882" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_7">
+        <line x1="401.9132" y1="-264" x2="537.42" y2="-264" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_92">
+        <line x1="-459.13965" y1="-485" x2="-376.36765" y2="-485" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_93">
+        <text transform="translate(-479.86275 -513)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="12" font-weight="400" fill="black" x="7105427e-19" y="11">0: checkFinalConditions()</tspan>
+        </text>
+      </g>
+      <g id="Line_94">
+        <line x1="-469.034" y1="-473" x2="-346.58" y2="-473" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_95">
+        <rect x="537.42" y="-491.5" width="133.12" height="42" fill="white"/>
+        <rect x="537.42" y="-491.5" width="133.12" height="42" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(542.42 -489.5)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="41.768984" y="8">«interface»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="4.223086" y="21">:IRefactoringUpdate</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="35.553164" y="35">Acceptor</tspan>
+        </text>
+      </g>
+      <g id="Line_96">
+        <line x1="86.03636" y1="-472.5" x2="537.42" y2="-470.5" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_98">
+        <text transform="translate(-205.3545 -509.6765)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="12" font-weight="400" fill="black" x="881073e-18" y="11">1: createDeclarationUpdates()</tspan>
+        </text>
+      </g>
+      <g id="Line_99">
+        <line x1="182.21156" y1="-478.9804" x2="264.98356" y2="-478.9804" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_100">
+        <path d="M 401.9132 -264 L 414.88793 -264 L 414.88793 -471.0429" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_101">
+        <line x1="432.3533" y1="-347.62745" x2="432.3533" y2="-391.0804" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_102">
+        <text transform="translate(438.8529 -311.4057) rotate(-91)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="12" font-weight="400" fill="black" x="23.436" y="11">2.2.2: accept()</tspan>
+        </text>
+      </g>
+    </g>
+  </g>
+</svg>
diff --git a/design/chapters/30_flowgraphs/images/cfg_for_loop.png b/design/chapters/30_flowgraphs/images/cfg_for_loop.png
new file mode 100644
index 0000000..4eb6f31
--- /dev/null
+++ b/design/chapters/30_flowgraphs/images/cfg_for_loop.png
Binary files differ
diff --git a/design/chapters/30_flowgraphs/images/cn_for_stmt.png b/design/chapters/30_flowgraphs/images/cn_for_stmt.png
new file mode 100644
index 0000000..becd1f4
--- /dev/null
+++ b/design/chapters/30_flowgraphs/images/cn_for_stmt.png
Binary files differ
diff --git a/design/chapters/30_flowgraphs/images/deadcode.png b/design/chapters/30_flowgraphs/images/deadcode.png
new file mode 100644
index 0000000..18c5880
--- /dev/null
+++ b/design/chapters/30_flowgraphs/images/deadcode.png
Binary files differ
diff --git a/design/chapters/30_flowgraphs/images/internalGraph.png b/design/chapters/30_flowgraphs/images/internalGraph.png
new file mode 100644
index 0000000..4e90bbc
--- /dev/null
+++ b/design/chapters/30_flowgraphs/images/internalGraph.png
Binary files differ
diff --git a/design/chapters/30_flowgraphs/images/usedBeforeDeclaredAnalysis.graffle/data.plist b/design/chapters/30_flowgraphs/images/usedBeforeDeclaredAnalysis.graffle/data.plist
new file mode 100644
index 0000000..9e829d6
--- /dev/null
+++ b/design/chapters/30_flowgraphs/images/usedBeforeDeclaredAnalysis.graffle/data.plist
Binary files differ
diff --git a/design/chapters/30_flowgraphs/images/usedBeforeDeclaredAnalysis.graffle/image3.png b/design/chapters/30_flowgraphs/images/usedBeforeDeclaredAnalysis.graffle/image3.png
new file mode 100644
index 0000000..196b617
--- /dev/null
+++ b/design/chapters/30_flowgraphs/images/usedBeforeDeclaredAnalysis.graffle/image3.png
Binary files differ
diff --git a/design/chapters/30_flowgraphs/images/usedBeforeDeclaredAnalysis.png b/design/chapters/30_flowgraphs/images/usedBeforeDeclaredAnalysis.png
new file mode 100644
index 0000000..13e1361
--- /dev/null
+++ b/design/chapters/30_flowgraphs/images/usedBeforeDeclaredAnalysis.png
Binary files differ
diff --git a/design/chapters/40_publish_npms/images/publish_npm_in_mvn_workflow.svg b/design/chapters/40_publish_npms/images/publish_npm_in_mvn_workflow.svg
new file mode 100644
index 0000000..31ace59
--- /dev/null
+++ b/design/chapters/40_publish_npms/images/publish_npm_in_mvn_workflow.svg
@@ -0,0 +1,353 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xl="http://www.w3.org/1999/xlink" xmlns:dc="http://purl.org/dc/elements/1.1/" viewBox="351 77 1119 731" width="1119" height="731">
+  <defs>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="FilledArrow_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -4 10 8" markerWidth="10" markerHeight="8" color="black">
+      <g>
+        <path d="M 8 0 L 0 -3 L 0 3 Z" fill="currentColor" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <font-face font-family="Helvetica Neue" font-size="14" panose-1="2 0 5 3 0 0 0 2 0 4" units-per-em="1000" underline-position="-100" underline-thickness="50" slope="0" x-height="517" cap-height="714" ascent="951.9958" descent="-212.99744" font-weight="400">
+      <font-face-src>
+        <font-face-name name="HelveticaNeue"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Courier" font-size="14" units-per-em="1000" underline-position="-178.22266" underline-thickness="57.61719" slope="0" x-height="456.54297" cap-height="586.91406" ascent="753.90625" descent="-246.09375" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Courier"/>
+      </font-face-src>
+    </font-face>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="StickArrow_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -4 10 8" markerWidth="10" markerHeight="8" color="black">
+      <g>
+        <path d="M 8 0 L 0 0 M 0 -3 L 8 0 L 0 3" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <font-face font-family="Helvetica Neue" font-size="16" panose-1="2 0 5 3 0 0 0 2 0 4" units-per-em="1000" underline-position="-100" underline-thickness="50" slope="0" x-height="517" cap-height="714" ascent="951.9958" descent="-212.99744" font-weight="400">
+      <font-face-src>
+        <font-face-name name="HelveticaNeue"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica Neue" font-size="16" panose-1="2 0 8 3 0 0 0 9 0 4" units-per-em="1000" underline-position="-100" underline-thickness="50" slope="0" x-height="517" cap-height="714" ascent="975.0061" descent="-216.99524" font-weight="700">
+      <font-face-src>
+        <font-face-name name="HelveticaNeue-Bold"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica Neue" font-size="20" panose-1="2 0 8 3 0 0 0 9 0 4" units-per-em="1000" underline-position="-100" underline-thickness="50" slope="0" x-height="517" cap-height="714" ascent="975.0061" descent="-216.99524" font-weight="700">
+      <font-face-src>
+        <font-face-name name="HelveticaNeue-Bold"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Monaco" font-size="14" units-per-em="1000" underline-position="-37.597656" underline-thickness="75.68359" slope="0" x-height="545.41016" cap-height="757.8125" ascent="1e3" descent="-250" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Monaco"/>
+      </font-face-src>
+    </font-face>
+  </defs>
+  <metadata> Produced by OmniGraffle 7.11 
+    <dc:date>2019-08-02 07:33:48 +0000</dc:date>
+  </metadata>
+  <g id="Canvas_1" stroke="none" stroke-opacity="1" stroke-dasharray="none" fill="none" fill-opacity="1">
+    <title>Canvas 1</title>
+    <rect fill="white" x="351" y="77" width="1119" height="731"/>
+    <g id="Canvas_1: Docker">
+      <title>Docker</title>
+      <g id="Graphic_55">
+        <path d="M 599 131.5 L 840.5318 131.5 C 843.2932 131.5 845.5318 133.73858 845.5318 136.5 L 845.5318 801.9404 C 845.5318 804.7018 843.2932 806.9404 840.5318 806.9404 L 599 806.9404 C 596.2386 806.9404 594 804.7018 594 801.9404 L 594 136.5 C 594 133.73858 596.2386 131.5 599 131.5 Z" fill="white"/>
+        <path d="M 599 131.5 L 840.5318 131.5 C 843.2932 131.5 845.5318 133.73858 845.5318 136.5 L 845.5318 801.9404 C 845.5318 804.7018 843.2932 806.9404 840.5318 806.9404 L 599 806.9404 C 596.2386 806.9404 594 804.7018 594 801.9404 L 594 136.5 C 594 133.73858 596.2386 131.5 599 131.5 Z" stroke="#ff2600" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_54">
+        <path d="M 356.5 131.5 L 540.5 131.5 C 543.2614 131.5 545.5 133.73858 545.5 136.5 L 545.5 802.5 C 545.5 805.2614 543.2614 807.5 540.5 807.5 L 356.5 807.5 C 353.73858 807.5 351.5 805.2614 351.5 802.5 L 351.5 136.5 C 351.5 133.73858 353.73858 131.5 356.5 131.5 Z" fill="white"/>
+        <path d="M 356.5 131.5 L 540.5 131.5 C 543.2614 131.5 545.5 133.73858 545.5 136.5 L 545.5 802.5 C 545.5 805.2614 543.2614 807.5 540.5 807.5 L 356.5 807.5 C 353.73858 807.5 351.5 805.2614 351.5 802.5 L 351.5 136.5 C 351.5 133.73858 353.73858 131.5 356.5 131.5 Z" stroke="#ff2600" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_53">
+        <path d="M 1195.0318 130.9404 L 1464.5 130.9404 C 1467.2614 130.9404 1469.5 133.17897 1469.5 135.9404 L 1469.5 801.9404 C 1469.5 804.7018 1467.2614 806.9404 1464.5 806.9404 L 1195.0318 806.9404 C 1192.2703 806.9404 1190.0318 804.7018 1190.0318 801.9404 L 1190.0318 135.9404 C 1190.0318 133.17897 1192.2703 130.9404 1195.0318 130.9404 Z" fill="white"/>
+        <path d="M 1195.0318 130.9404 L 1464.5 130.9404 C 1467.2614 130.9404 1469.5 133.17897 1469.5 135.9404 L 1469.5 801.9404 C 1469.5 804.7018 1467.2614 806.9404 1464.5 806.9404 L 1195.0318 806.9404 C 1192.2703 806.9404 1190.0318 804.7018 1190.0318 801.9404 L 1190.0318 135.9404 C 1190.0318 133.17897 1192.2703 130.9404 1195.0318 130.9404 Z" stroke="#ff2600" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_52">
+        <path d="M 899.0318 131.5 L 1136.5318 131.5 C 1139.2932 131.5 1141.5318 133.73858 1141.5318 136.5 L 1141.5318 801.9404 C 1141.5318 804.7018 1139.2932 806.9404 1136.5318 806.9404 L 899.0318 806.9404 C 896.2703 806.9404 894.0318 804.7018 894.0318 801.9404 L 894.0318 136.5 C 894.0318 133.73858 896.2703 131.5 899.0318 131.5 Z" fill="white"/>
+        <path d="M 899.0318 131.5 L 1136.5318 131.5 C 1139.2932 131.5 1141.5318 133.73858 1141.5318 136.5 L 1141.5318 801.9404 C 1141.5318 804.7018 1139.2932 806.9404 1136.5318 806.9404 L 899.0318 806.9404 C 896.2703 806.9404 894.0318 804.7018 894.0318 801.9404 L 894.0318 136.5 C 894.0318 133.73858 896.2703 131.5 899.0318 131.5 Z" stroke="#ff2600" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+    </g>
+    <g id="Canvas_1: Workflow">
+      <title>Workflow</title>
+      <g id="Line_51">
+        <line x1="446.9202" y1="375.9665" x2="446.9202" y2="386.0667" marker-end="url(#FilledArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_50">
+        <path d="M 613.40675 217.2161 L 621.40675 209.2161 L 822.15675 209.2161 L 830.15675 217.2161 L 830.15675 257.8775 L 822.15675 265.8775 L 621.40675 265.8775 L 613.40675 257.8775 Z" fill="lime"/>
+        <path d="M 613.40675 217.2161 L 621.40675 209.2161 L 822.15675 209.2161 L 830.15675 217.2161 L 830.15675 257.8775 L 822.15675 265.8775 L 621.40675 265.8775 L 613.40675 257.8775 Z" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(623.8255 211.4588)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="14" font-weight="400" fill="black" x="7.788726" y="14">Maven plugin </tspan>
+          <tspan font-family="Courier" font-size="14" font-weight="400" fill="black" y="14">exec-maven-</tspan>
+          <tspan font-family="Courier" font-size="14" font-weight="400" fill="black" x="40.29246" y="31.392">plugin </tspan>
+          <tspan font-family="Helvetica Neue" font-size="14" font-weight="400" fill="black" y="31.392">executes</tspan>
+          <tspan font-family="Courier" font-size="14" font-weight="400" fill="black" x="3.8506243" y="48.783997">UpdateShippedCode</tspan>
+          <tspan font-family="Helvetica Neue" font-size="14" font-weight="400" fill="black" y="48.783997"> MWE2</tspan>
+        </text>
+      </g>
+      <g id="Line_49">
+        <line x1="613.40675" y1="237.5468" x2="516.85277" y2="237.5468" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_48">
+        <text transform="translate(524.0741 211.5468)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="400" fill="black" x="0" y="15">bound to</tspan>
+        </text>
+      </g>
+      <g id="Graphic_47">
+        <text transform="translate(603.03175 82.03589)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="700" fill="black" x="56.614" y="16">org.eclipse.n4js.</tspan>
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="700" fill="black" x="26.046" y="35.46411">external.libraries.update</tspan>
+        </text>
+      </g>
+      <g id="Graphic_46">
+        <path d="M 1204.4682 433.3728 L 1212.4682 425.3728 L 1448 425.3728 L 1456 433.3728 L 1456 482.52263 L 1448 490.52263 L 1212.4682 490.52263 L 1204.4682 482.52263 Z" fill="lime"/>
+        <path d="M 1204.4682 433.3728 L 1212.4682 425.3728 L 1448 425.3728 L 1456 433.3728 L 1456 482.52263 L 1448 490.52263 L 1212.4682 490.52263 L 1204.4682 482.52263 Z" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(1215.7565 432.85973)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="14" font-weight="400" fill="black" x="26.256058" y="14">Maven </tspan>
+          <tspan font-family="Courier" font-size="14" font-weight="400" fill="black" y="14">exec-maven </tspan>
+          <tspan font-family="Helvetica Neue" font-size="14" font-weight="400" fill="black" y="14">plugin</tspan>
+          <tspan font-family="Courier" font-size="14" font-weight="400" fill="black" y="14"> </tspan>
+          <tspan font-family="Helvetica Neue" font-size="14" font-weight="400" fill="black" x="15.539577" y="30.392">publishes n4js-libs to local npm </tspan>
+          <tspan font-family="Helvetica Neue" font-size="14" font-weight="400" fill="black" x="91.40558" y="46.783997">registry</tspan>
+        </text>
+      </g>
+      <g id="Line_45">
+        <line x1="1204.4682" y1="457.9477" x2="518.1127" y2="477.27935" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_44">
+        <text transform="translate(1096.9331 435.0605)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="400" fill="black" x="0" y="15">bound to</tspan>
+        </text>
+      </g>
+      <g id="Graphic_43">
+        <path d="M 1204.4682 523.602 L 1212.4682 515.602 L 1448 515.602 L 1456 523.602 L 1456 572.7518 L 1448 580.7518 L 1212.4682 580.7518 L 1204.4682 572.7518 Z" fill="lime"/>
+        <path d="M 1204.4682 523.602 L 1212.4682 515.602 L 1448 515.602 L 1456 523.602 L 1456 572.7518 L 1448 580.7518 L 1212.4682 580.7518 L 1204.4682 572.7518 Z" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(1215.7565 522.2849)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="14" font-weight="400" fill="black" x="6.7071085" y="14">Maven </tspan>
+          <tspan font-family="Courier" font-size="14" font-weight="400" fill="black" y="14">failsafe</tspan>
+          <tspan font-family="Helvetica Neue" font-size="14" font-weight="400" fill="black" y="14"> plugin executes </tspan>
+          <tspan font-family="Courier" font-size="14" font-weight="400" fill="black" x="43.065956" y="31.392">org.eclipse.n4js.</tspan>
+          <tspan font-family="Courier" font-size="14" font-weight="400" fill="black" x="30.15164" y="48.392">hlc.integrations</tspan>
+          <tspan font-family="Helvetica Neue" font-size="14" font-weight="400" fill="black" y="48.392"> tests </tspan>
+        </text>
+      </g>
+      <g id="Line_42">
+        <line x1="1204.4682" y1="548.1769" x2="518.4318" y2="539.5895" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_41">
+        <text transform="translate(1098.4625 522.25326)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="400" fill="black" x="0" y="15">bound to</tspan>
+        </text>
+      </g>
+      <g id="Graphic_40">
+        <path d="M 1204.4682 613.83114 L 1212.4682 605.83114 L 1448 605.83114 L 1456 613.83114 L 1456 662.98096 L 1448 670.98096 L 1212.4682 670.98096 L 1204.4682 662.98096 Z" fill="lime"/>
+        <path d="M 1204.4682 613.83114 L 1212.4682 605.83114 L 1448 605.83114 L 1456 613.83114 L 1456 662.98096 L 1448 670.98096 L 1212.4682 670.98096 L 1204.4682 662.98096 Z" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(1215.7565 621.21005)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="14" font-weight="400" fill="black" x="25.993476" y="14">Maven </tspan>
+          <tspan font-family="Courier" font-size="14" font-weight="400" fill="black" y="14">antrun</tspan>
+          <tspan font-family="Helvetica Neue" font-size="14" font-weight="400" fill="black" y="14"> plugin stops </tspan>
+          <tspan font-family="Courier" font-size="14" font-weight="400" fill="black" x="76.671425" y="31.392">verdaccio</tspan>
+        </text>
+      </g>
+      <g id="Line_39">
+        <line x1="1204.4682" y1="638.40605" x2="518.42044" y2="604.4027" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_38">
+        <text transform="translate(1100.4749 609.8348)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="400" fill="black" x="0" y="15">bound to</tspan>
+        </text>
+      </g>
+      <g id="Graphic_37">
+        <rect x="384.35993" y="158.495" width="122.59283" height="39.36772" fill="white"/>
+        <rect x="384.35993" y="158.495" width="122.59283" height="39.36772" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(389.35993 168.95487)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="400" fill="black" x="27.992417" y="15">compile</tspan>
+        </text>
+      </g>
+      <g id="Graphic_36">
+        <rect x="384.35993" y="217.86294" width="122.59283" height="39.36772" fill="white"/>
+        <rect x="384.35993" y="217.86294" width="122.59283" height="39.36772" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(389.35993 219.0988)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="400" fill="black" x="24.736417" y="15">process-</tspan>
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="400" fill="black" x="29.632417" y="33.448">classes</tspan>
+        </text>
+      </g>
+      <g id="Line_35">
+        <line x1="445.65635" y1="197.86273" x2="445.65635" y2="207.96294" marker-end="url(#FilledArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_34">
+        <rect x="385.6238" y="457.8742" width="122.59283" height="39.36772" fill="white"/>
+        <rect x="385.6238" y="457.8742" width="122.59283" height="39.36772" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(390.6238 459.1101)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="400" fill="black" x=".58441724" y="15">pre-integration-</tspan>
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="400" fill="black" x="42.960417" y="33.448">test</tspan>
+        </text>
+      </g>
+      <g id="Graphic_33">
+        <rect x="385.93974" y="519.7817" width="122.59283" height="39.36772" fill="white"/>
+        <rect x="385.93974" y="519.7817" width="122.59283" height="39.36772" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(390.93974 530.2416)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="400" fill="black" x="1.9204172" y="15">integration-test</tspan>
+        </text>
+      </g>
+      <g id="Graphic_32">
+        <rect x="385.93974" y="638.5" width="122.59283" height="39.36772" fill="white"/>
+        <rect x="385.93974" y="638.5" width="122.59283" height="39.36772" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(390.93974 648.95986)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="400" fill="black" x="48.29642" y="15">…</tspan>
+        </text>
+      </g>
+      <g id="Line_31">
+        <line x1="445.65635" y1="137.12396" x2="445.65635" y2="148.595" marker-end="url(#FilledArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_30">
+        <rect x="385.6238" y="277.23087" width="122.59283" height="39.36772" fill="white"/>
+        <rect x="385.6238" y="277.23087" width="122.59283" height="39.36772" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(390.6238 287.69073)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="400" fill="black" x="48.29642" y="15">…</tspan>
+        </text>
+      </g>
+      <g id="Line_29">
+        <line x1="445.65635" y1="257.23066" x2="446.29584" y2="267.35057" marker-end="url(#FilledArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_28">
+        <line x1="446.9202" y1="316.5986" x2="446.9202" y2="326.6988" marker-end="url(#FilledArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_27">
+        <line x1="446.9202" y1="497.24194" x2="447.0974" y2="509.8827" marker-end="url(#FilledArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_26">
+        <rect x="385.93974" y="584.2288" width="122.59283" height="39.36772" fill="white"/>
+        <rect x="385.93974" y="584.2288" width="122.59283" height="39.36772" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(390.93974 585.46465)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="400" fill="black" x="37.328417" y="15">post-</tspan>
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="400" fill="black" x="1.9204172" y="33.448">integration-test</tspan>
+        </text>
+      </g>
+      <g id="Line_25">
+        <line x1="447.23616" y1="559.14944" x2="447.23616" y2="574.3288" marker-end="url(#FilledArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_24">
+        <line x1="447.23616" y1="623.5965" x2="447.23616" y2="628.6" marker-end="url(#FilledArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_23">
+        <rect x="385.6238" y="336.5988" width="122.59283" height="39.36772" fill="white"/>
+        <rect x="385.6238" y="336.5988" width="122.59283" height="39.36772" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(390.6238 347.05865)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="400" fill="black" x="42.960417" y="15">test</tspan>
+        </text>
+      </g>
+      <g id="Graphic_22">
+        <text transform="translate(373.5 89)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="20" font-weight="700" fill="black" x="12.4675" y="20">Maven phases </tspan>
+        </text>
+      </g>
+      <g id="Graphic_21">
+        <rect x="385.6238" y="395.9667" width="122.59283" height="39.36772" fill="white"/>
+        <rect x="385.6238" y="395.9667" width="122.59283" height="39.36772" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(390.6238 406.4266)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="400" fill="black" x="48.29642" y="15">…</tspan>
+        </text>
+      </g>
+      <g id="Graphic_20">
+        <text transform="translate(1235.2659 82.03589)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="700" fill="black" x="32.364" y="16">org.eclipse.n4js.</tspan>
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="700" fill="black" x="20.74" y="35.46411">hlc.integrationtests</tspan>
+        </text>
+      </g>
+      <g id="Graphic_19">
+        <path d="M 1204.4682 344.5988 L 1212.4682 336.5988 L 1448 336.5988 L 1456 344.5988 L 1456 393.7486 L 1448 401.7486 L 1212.4682 401.7486 L 1204.4682 393.7486 Z" fill="lime"/>
+        <path d="M 1204.4682 344.5988 L 1212.4682 336.5988 L 1448 336.5988 L 1456 344.5988 L 1456 393.7486 L 1448 401.7486 L 1212.4682 401.7486 L 1204.4682 393.7486 Z" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(1215.7565 343.5857)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="14" font-weight="400" fill="black" x="25.867476" y="14">Maven </tspan>
+          <tspan font-family="Courier" font-size="14" font-weight="400" fill="black" y="14">antrun</tspan>
+          <tspan font-family="Helvetica Neue" font-size="14" font-weight="400" fill="black" y="14"> plugin starts </tspan>
+          <tspan font-family="Courier" font-size="14" font-weight="400" fill="black" x="17.157425" y="31.392">verdaccio</tspan>
+          <tspan font-family="Helvetica Neue" font-size="14" font-weight="400" fill="black" y="31.392">, local npm registry </tspan>
+          <tspan font-family="Helvetica Neue" font-size="14" font-weight="400" fill="black" x="52.49258" y="47.783997">listens on port 4873</tspan>
+        </text>
+      </g>
+      <g id="Line_18">
+        <line x1="1204.4682" y1="369.1737" x2="518.0189" y2="466.3288" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_17">
+        <text transform="translate(1108.2748 357.5391) rotate(-8.055727)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="400" fill="black" x="0" y="15">bound to</tspan>
+        </text>
+      </g>
+      <g id="Line_16">
+        <line x1="1330.2341" y1="401.7486" x2="1330.2341" y2="415.4728" marker-end="url(#FilledArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_15">
+        <line x1="1330.2341" y1="490.52263" x2="1330.2341" y2="505.702" marker-end="url(#FilledArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_14">
+        <line x1="1330.2341" y1="580.7518" x2="1330.2341" y2="595.93114" marker-end="url(#FilledArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_13">
+        <path d="M 1117.5 110.25 L 1117.5 92.75 L 1216.4841 92.75 L 1216.4841 84 L 1227.4841 101.5 L 1216.4841 119 L 1216.4841 110.25 Z" fill="white"/>
+        <path d="M 1117.5 110.25 L 1117.5 92.75 L 1216.4841 92.75 L 1216.4841 84 L 1227.4841 101.5 L 1216.4841 119 L 1216.4841 110.25 Z" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(1122.5 92.276)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="400" fill="black" x="9.688062" y="15">built before</tspan>
+        </text>
+      </g>
+      <g id="Graphic_12">
+        <path d="M 920.7818 687.8802 L 928.7818 679.8802 L 1106.7818 679.8802 L 1114.7818 687.8802 L 1114.7818 737.03 L 1106.7818 745.03 L 928.7818 745.03 L 920.7818 737.03 Z" fill="lime"/>
+        <path d="M 920.7818 687.8802 L 928.7818 679.8802 L 1106.7818 679.8802 L 1114.7818 687.8802 L 1114.7818 737.03 L 1106.7818 745.03 L 928.7818 745.03 L 920.7818 737.03 Z" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(930.6318 685.9786)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="14" font-weight="400" fill="black" x="1.1831656" y="14">Maven </tspan>
+          <tspan font-family="Monaco" font-size="14" font-weight="400" fill="black" y="14">exec-maven</tspan>
+          <tspan font-family="Helvetica Neue" font-size="14" font-weight="400" fill="black" y="14"> plugin </tspan>
+          <tspan font-family="Helvetica Neue" font-size="14" font-weight="400" fill="black" x="9.275849" y="33.168945">publishes </tspan>
+          <tspan font-family="Courier" font-size="14" font-weight="400" fill="black" y="33.168945">n4js-libs</tspan>
+          <tspan font-family="Helvetica Neue" font-size="14" font-weight="400" fill="black" y="33.168945"> to </tspan>
+          <tspan font-family="Helvetica Neue" font-size="14" font-weight="400" fill="black" x="23.226002" y="49.560944">staging npm registry</tspan>
+        </text>
+      </g>
+      <g id="Graphic_11">
+        <text transform="translate(876.7708 82.03589)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="700" fill="black" x="80.75487" y="16">org.eclipse.n4js.</tspan>
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="700" fill="black" x="92.23487" y="35.46411">product.build</tspan>
+        </text>
+      </g>
+      <g id="Graphic_10">
+        <path d="M 825.5 110.25 L 825.5 92.75 L 931.2341 92.75 L 931.2341 84 L 942.2341 101.5 L 931.2341 119 L 931.2341 110.25 Z" fill="white"/>
+        <path d="M 825.5 110.25 L 825.5 92.75 L 931.2341 92.75 L 931.2341 84 L 942.2341 101.5 L 931.2341 119 L 931.2341 110.25 Z" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(830.5 92.276)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="400" fill="black" x="13.063062" y="15">built before</tspan>
+        </text>
+      </g>
+      <g id="Line_9">
+        <line x1="446.9202" y1="435.33444" x2="446.9202" y2="447.9742" marker-end="url(#FilledArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_8">
+        <rect x="385.6238" y="692.7712" width="122.59283" height="39.36772" fill="white"/>
+        <rect x="385.6238" y="692.7712" width="122.59283" height="39.36772" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(390.6238 703.2311)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="400" fill="black" x="37.192417" y="15">verify</tspan>
+        </text>
+      </g>
+      <g id="Line_7">
+        <line x1="446.2883" y1="677.8677" x2="446.2883" y2="682.8712" marker-end="url(#FilledArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_6">
+        <rect x="385.6238" y="752.6664" width="122.59283" height="39.36772" fill="white"/>
+        <rect x="385.6238" y="752.6664" width="122.59283" height="39.36772" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(390.6238 763.12625)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="400" fill="black" x="48.29642" y="15">…</tspan>
+        </text>
+      </g>
+      <g id="Line_5">
+        <line x1="446.9202" y1="732.1389" x2="446.9202" y2="742.7664" marker-end="url(#FilledArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_4">
+        <line x1="920.7818" y1="712.4551" x2="518.1166" y2="712.4551" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_3">
+        <text transform="translate(728.6176 694.4551)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="16" font-weight="400" fill="black" x="0" y="15">bound to</tspan>
+        </text>
+      </g>
+    </g>
+  </g>
+</svg>
diff --git a/design/chapters/a02_hints/images/cd_SingletonDuplicate.svg b/design/chapters/a02_hints/images/cd_SingletonDuplicate.svg
new file mode 100644
index 0000000..9f6f2ae
--- /dev/null
+++ b/design/chapters/a02_hints/images/cd_SingletonDuplicate.svg
@@ -0,0 +1,159 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xl="http://www.w3.org/1999/xlink" xmlns:dc="http://purl.org/dc/elements/1.1/" viewBox="16.507874 10.838583 683.937 329.8189" width="683.937" height="329.8189">
+  <defs>
+    <font-face font-family="Helvetica" font-size="8" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="12" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="532.22656" cap-height="719.7266" ascent="770.0195" descent="-229.98047" font-weight="700">
+      <font-face-src>
+        <font-face-name name="Helvetica-Bold"/>
+      </font-face-src>
+    </font-face>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="FilledDiamond_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-9 -4 10 8" markerWidth="10" markerHeight="8" color="black">
+      <g>
+        <path d="M -8 0 L -4 3 L 0 0 L -4 -3 Z" fill="currentColor" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="EmptyCenterBall_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -6 12 12" markerWidth="12" markerHeight="12" color="black">
+      <g>
+        <circle cx="4.799998" cy="0" r="4.79999555411813" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="UML2Socket_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -7 8 14" markerWidth="8" markerHeight="14" color="black">
+      <g>
+        <path d="M 6 -6 C -1 -6 -1 6 6 6" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="StickArrow_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -4 10 8" markerWidth="10" markerHeight="8" color="black">
+      <g>
+        <path d="M 8 0 L 0 0 M 0 -3 L 8 0 L 0 3" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <font-face font-family="Helvetica" font-size="10" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="12" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+  </defs>
+  <metadata> Produced by OmniGraffle 7.11 
+    <dc:date>2018-04-02 21:56:49 +0000</dc:date>
+  </metadata>
+  <g id="Canvas_1" stroke="none" stroke-opacity="1" stroke-dasharray="none" fill="none" fill-opacity="1">
+    <title>Canvas 1</title>
+    <rect fill="white" x="16.507874" y="10.838583" width="683.937" height="329.8189"/>
+    <g id="Canvas_1: Layer 1">
+      <title>Layer 1</title>
+      <g id="Graphic_22">
+        <rect x="580.88976" y="114.82828" width="119.05512" height="45" fill="#b8f2ff"/>
+        <rect x="580.88976" y="114.82828" width="119.05512" height="45" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(585.88976 125.32828)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="3.8302917" y="8">«org.eclipse.n4js.ui.internal»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="17.84787" y="21">N4JSInjector</tspan>
+        </text>
+      </g>
+      <g id="Graphic_21">
+        <rect x="441.9921" y="225.37946" width="147.40157" height="45.35433" fill="#b8f2ff"/>
+        <rect x="441.9921" y="225.37946" width="147.40157" height="45.35433" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(446.9921 236.05662)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="32.233994" y="8">«org.eclipse.n4js.ui»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="26.69493" y="21">N4JSUiModule</tspan>
+        </text>
+      </g>
+      <g id="Line_20">
+        <path d="M 640.4173 169.07828 L 640.4173 248.05662 L 589.3937 248.05662" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_19">
+        <rect x="320.31496" y="294.80315" width="147.40157" height="45.35433" fill="#b8f2ff"/>
+        <rect x="320.31496" y="294.80315" width="147.40157" height="45.35433" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(325.31496 305.4803)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="18.003525" y="8">«org.eclipse.n4js.ui.internal»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="11.715439" y="21">ContributingModule</tspan>
+        </text>
+      </g>
+      <g id="Graphic_18">
+        <rect x="17.007874" y="114.82828" width="144.35433" height="45" fill="#dedede"/>
+        <rect x="17.007874" y="114.82828" width="144.35433" height="45" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(22.007874 125.32828)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="2.0287247" y="8">«org.eclipse.xtext.ui.shared.internal»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="30.509193" y="21">ChildInjector</tspan>
+        </text>
+      </g>
+      <g id="Graphic_17">
+        <rect x="104.66929" y="216.87552" width="147.40157" height="45.35433" fill="#dedede"/>
+        <rect x="104.66929" y="216.87552" width="147.40157" height="45.35433" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(109.66929 227.5527)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="33.122665" y="8">«com.google.inject»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="17.363876" y="21">OverridingModule</tspan>
+        </text>
+      </g>
+      <g id="Line_16">
+        <path d="M 89.18504 169.07828 L 89.18504 188.07828 L 178.37008 188.07828 L 178.37008 216.87552" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_15">
+        <line x1="319.81497" y1="317.4839" x2="257.08334" y2="317.93406" marker-end="url(#EmptyCenterBall_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_14">
+        <path d="M 178.37008 262.22985 L 178.37008 317.9685 L 243.78346 317.9685" marker-end="url(#UML2Socket_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_13">
+        <rect x="328.6063" y="49.63143" width="130.1811" height="36" fill="#b8f2ff"/>
+        <rect x="328.6063" y="49.63143" width="130.1811" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(333.6063 60.63143)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="10.40012" y="11">N4JSEclipseCore</tspan>
+        </text>
+      </g>
+      <g id="Line_12">
+        <path d="M 394.01575 294.80315 L 394.01575 189.90315 L 350.30315 189.90315 L 350.30315 95.53143" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_11">
+        <text transform="translate(361.74267 157.06063)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«bind»</tspan>
+        </text>
+      </g>
+      <g id="Line_10">
+        <path d="M 515.6929 225.37946 L 515.6929 155.47946 L 437.09055 155.47946 L 437.09055 95.53143" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_9">
+        <text transform="translate(476.18504 162.15102)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«bind»</tspan>
+        </text>
+      </g>
+      <g id="Line_8">
+        <line x1="572.6886" y1="133.05" x2="467.56485" y2="78.21034" marker-end="url(#StickArrow_Marker)" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_7">
+        <path d="M 691.44094 30.21838 C 691.44094 24.174165 689.46094 23.426375 674.9976 17.444688 L 674.8448 17.382798 C 660.30505 11.338583 660.1538 11.338583 645.2321 11.338583 C 625.3635 11.338583 535.5354 11.338583 535.5354 11.338583 L 535.5354 75.14324 L 691.44094 75.14324 L 691.44094 30.21838 Z" fill="white"/>
+        <path d="M 691.44094 30.21838 C 691.44094 24.174165 689.46094 23.426375 674.9976 17.444688 L 674.8448 17.382798 C 660.30505 11.338583 660.1538 11.338583 645.2321 11.338583 C 625.3635 11.338583 535.5354 11.338583 535.5354 11.338583 L 535.5354 75.14324 L 691.44094 75.14324 L 691.44094 30.21838 Z M 691.44094 29.907014 C 691.44094 24.174165 691.28815 24.174165 660.1538 24.174165 L 660.1538 24.174165 C 660.1538 11.401111 660.1538 11.338583 646.1457 11.338583" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(540.5354 29.24091)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="51.94397" y="11">Creates </tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="2.5758057" y="25">N4JSEclipseCore_238294</tspan>
+        </text>
+      </g>
+      <g id="Line_6">
+        <line x1="562.42854" y1="75.40977" x2="517.02763" y2="104.01347" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_5">
+        <line x1="170.00648" y1="134.036" x2="319.3546" y2="77.15505" marker-end="url(#StickArrow_Marker)" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_4">
+        <path d="M 254.9055 30.21838 C 254.9055 24.174165 252.9255 23.426375 238.46216 17.444688 L 238.30937 17.382798 C 223.76962 11.338583 223.6184 11.338583 208.69668 11.338583 C 188.82808 11.338583 99 11.338583 99 11.338583 L 99 75.14324 L 254.9055 75.14324 L 254.9055 30.21838 Z" fill="white"/>
+        <path d="M 254.9055 30.21838 C 254.9055 24.174165 252.9255 23.426375 238.46216 17.444688 L 238.30937 17.382798 C 223.76962 11.338583 223.6184 11.338583 208.69668 11.338583 C 188.82808 11.338583 99 11.338583 99 11.338583 L 99 75.14324 L 254.9055 75.14324 L 254.9055 30.21838 Z M 254.9055 29.907014 C 254.9055 24.174165 254.75272 24.174165 223.6184 24.174165 L 223.6184 24.174165 C 223.6184 11.401111 223.6184 11.338583 209.61028 11.338583" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(104 29.24091)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="51.94397" y="11">Creates </tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="5.91272" y="25">N4JSEclipseCore_12391</tspan>
+        </text>
+      </g>
+      <g id="Line_3">
+        <line x1="215.0686" y1="75.46605" x2="248.83442" y2="104.01347" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+    </g>
+  </g>
+</svg>
diff --git a/design/chapters/a02_hints/images/cd_XtextInjectors.svg b/design/chapters/a02_hints/images/cd_XtextInjectors.svg
new file mode 100644
index 0000000..c355e6a
--- /dev/null
+++ b/design/chapters/a02_hints/images/cd_XtextInjectors.svg
@@ -0,0 +1,211 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xl="http://www.w3.org/1999/xlink" xmlns:dc="http://purl.org/dc/elements/1.1/" viewBox="30.681102 10.838583 967.4016 580.71017" width="967.4016" height="580.71017">
+  <defs>
+    <font-face font-family="Helvetica" font-size="8" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="12" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="532.22656" cap-height="719.7266" ascent="770.0195" descent="-229.98047" font-weight="700">
+      <font-face-src>
+        <font-face-name name="Helvetica-Bold"/>
+      </font-face-src>
+    </font-face>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="FilledDiamond_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-9 -4 10 8" markerWidth="10" markerHeight="8" color="black">
+      <g>
+        <path d="M -8 0 L -4 3 L 0 0 L -4 -3 Z" fill="currentColor" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <font-face font-family="Helvetica" font-size="12" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="EmptyCenterBall_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -6 12 12" markerWidth="12" markerHeight="12" color="black">
+      <g>
+        <circle cx="4.799998" cy="0" r="4.79999555411813" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="UML2Socket_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -7 8 14" markerWidth="8" markerHeight="14" color="black">
+      <g>
+        <path d="M 6 -6 C -1 -6 -1 6 6 6" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+  </defs>
+  <metadata> Produced by OmniGraffle 7.11 
+    <dc:date>2018-04-02 21:52:55 +0000</dc:date>
+  </metadata>
+  <g id="Canvas_1" stroke="none" stroke-opacity="1" stroke-dasharray="none" fill="none" fill-opacity="1">
+    <title>Canvas 1</title>
+    <rect fill="white" x="30.681102" y="10.838583" width="967.4016" height="580.71017"/>
+    <g id="Canvas_1: Layer 1">
+      <title>Layer 1</title>
+      <g id="Graphic_32">
+        <rect x="753.80315" y="64.15899" width="119.05512" height="45" fill="#b8f2ff"/>
+        <rect x="753.80315" y="64.15899" width="119.05512" height="45" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(758.80315 74.65899)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="3.8302917" y="8">«org.eclipse.n4js.ui.internal»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="17.84787" y="21">N4JSInjector</tspan>
+        </text>
+      </g>
+      <g id="Graphic_31">
+        <rect x="850.1811" y="301.9149" width="147.40157" height="45.35433" fill="#b8f2ff"/>
+        <rect x="850.1811" y="301.9149" width="147.40157" height="45.35433" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(855.1811 312.59206)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="36.458603" y="8">«org.eclipse.n4js»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="8.694931" y="21">N4JSRuntimeModule</tspan>
+        </text>
+      </g>
+      <g id="Graphic_30">
+        <rect x="850.1811" y="216.87552" width="147.40157" height="45.35433" fill="#b8f2ff"/>
+        <rect x="850.1811" y="216.87552" width="147.40157" height="45.35433" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(855.1811 227.5527)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="32.233994" y="8">«org.eclipse.n4js.ui»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="26.69493" y="21">N4JSUiModule</tspan>
+        </text>
+      </g>
+      <g id="Graphic_29">
+        <rect x="396.6378" y="143.17473" width="147.40157" height="45.35433" fill="#dedede"/>
+        <rect x="396.6378" y="143.17473" width="147.40157" height="45.35433" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(401.6378 153.8519)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="17.782822" y="8">«org.eclipse.xtext.ui.shared»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="12.691025" y="21">SharedStateModule</tspan>
+        </text>
+      </g>
+      <g id="Line_28">
+        <path d="M 813.3307 118.40899 L 813.3307 324.59206 L 850.1811 324.59206" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_27">
+        <path d="M 813.3307 118.40899 L 813.3307 239.5527 L 850.1811 239.5527" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_26">
+        <path d="M 813.3307 118.40899 L 813.3307 165.8519 L 544.03937 165.8519" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_25">
+        <rect x="181.20472" y="44.31647" width="144.35433" height="45" fill="#dedede"/>
+        <rect x="181.20472" y="44.31647" width="144.35433" height="45" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(186.20472 54.81647)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="2.0287247" y="8">«org.eclipse.xtext.ui.shared.internal»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="25.165443" y="21">SharedInjector</tspan>
+        </text>
+      </g>
+      <g id="Graphic_24">
+        <rect x="178.58268" y="255.1181" width="150.23622" height="45.35433" fill="#dedede"/>
+        <rect x="178.58268" y="255.1181" width="150.23622" height="45.35433" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(183.58268 265.79527)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="34.539986" y="8">«com.google.inject»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="18.781197" y="21">OverridingModule</tspan>
+        </text>
+      </g>
+      <g id="Graphic_23">
+        <rect x="547.0866" y="416.6929" width="147.40157" height="45.35433" fill="#b8f2ff"/>
+        <rect x="547.0866" y="416.6929" width="147.40157" height="45.35433" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(552.0866 427.3701)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="18.003525" y="8">«org.eclipse.n4js.ui.internal»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="11.715439" y="21">ContributingModule</tspan>
+        </text>
+      </g>
+      <g id="Line_22">
+        <path d="M 253.3819 98.56647 L 253.3819 165.8519 L 396.6378 165.8519" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_21">
+        <path d="M 253.3819 98.56647 L 253.3819 100.56647 L 253.7008 243.8681 L 253.7008 255.1181" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_20">
+        <path d="M 617.74015 35.25101 C 617.74015 27.59564 615.11215 26.648517 595.91534 19.072342 L 595.71255 18.993954 C 576.41434 11.338583 576.2136 11.338583 556.4084 11.338583 C 530.0374 11.338583 410.811 11.338583 410.811 11.338583 L 410.811 92.15111 L 617.74015 92.15111 L 617.74015 35.25101 Z" fill="white"/>
+        <path d="M 617.74015 35.25101 C 617.74015 27.59564 615.11215 26.648517 595.91534 19.072342 L 595.71255 18.993954 C 576.41434 11.338583 576.2136 11.338583 556.4084 11.338583 C 530.0374 11.338583 410.811 11.338583 410.811 11.338583 L 410.811 92.15111 L 617.74015 92.15111 L 617.74015 35.25101 Z M 617.74015 34.856645 C 617.74015 27.59564 617.5374 27.59564 576.2136 27.59564 L 576.2136 27.59564 C 576.2136 11.417779 576.2136 11.338583 557.62103 11.338583" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(415.811 23.744848)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="20.751678" y="11">Note that injectors don’t have </tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="3.085663" y="25">custom type, they are just instances </tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="10.412811" y="39">of a «com.google.inject.Injector», </tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="5.73996" y="53">that are stored on a given Activator</tspan>
+        </text>
+      </g>
+      <g id="Line_19">
+        <line x1="753.80315" y1="86.65899" x2="618.2349" y2="66.89822" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_18">
+        <line x1="325.55905" y1="66.81647" x2="410.3126" y2="60.04773" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_17">
+        <rect x="533.126" y="255.1181" width="229.3937" height="45" fill="#b8f2ff"/>
+        <rect x="533.126" y="255.1181" width="229.3937" height="45" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(538.126 265.6181)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="73.23006" y="8">«org.eclipse.n4js.ui»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="5.0249786" y="21">N4JSClusteringBuilderConfiguration</tspan>
+        </text>
+      </g>
+      <g id="Line_16">
+        <line x1="533.126" y1="277.6181" x2="441.1228" y2="277.7865" marker-end="url(#EmptyCenterBall_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_15">
+        <line x1="328.8189" y1="277.79527" x2="427.82283" y2="277.79527" marker-end="url(#UML2Socket_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_14">
+        <path d="M 569.5512 358.37536 C 569.5512 353.00484 567.1392 352.3404 549.5202 347.02544 L 549.33406 346.97045 C 531.622 341.59993 531.4378 341.59993 513.2604 341.59993 C 489.05685 341.59993 379.6299 341.59993 379.6299 341.59993 L 379.6299 398.29284 L 569.5512 398.29284 L 569.5512 358.37536 Z" fill="white"/>
+        <path d="M 569.5512 358.37536 C 569.5512 353.00484 567.1392 352.3404 549.5202 347.02544 L 549.33406 346.97045 C 531.622 341.59993 531.4378 341.59993 513.2604 341.59993 C 489.05685 341.59993 379.6299 341.59993 379.6299 341.59993 L 379.6299 398.29284 L 569.5512 398.29284 L 569.5512 358.37536 Z M 569.5512 358.0987 C 569.5512 353.00484 569.36506 353.00484 531.4378 353.00484 L 531.4378 353.00484 C 531.4378 341.6555 531.4378 341.59993 514.37336 341.59993" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(384.6299 348.9464)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="42.590515" y="11">&lt;extension point= </tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="18.127625" y="25">&quot;org.eclipse.xtext.ui.shared</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="20.960632" y="39">.overridingGuiceModule&quot;&gt;</tspan>
+        </text>
+      </g>
+      <g id="Line_13">
+        <line x1="436.32283" y1="277.79527" x2="462.6273" y2="341.13816" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_12">
+        <rect x="31.181102" y="324.9464" width="144.35433" height="45" fill="#dedede"/>
+        <rect x="31.181102" y="324.9464" width="144.35433" height="45" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(36.181102 335.4464)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="2.0287247" y="8">«org.eclipse.xtext.ui.shared.internal»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="30.509193" y="21">ChildInjector</tspan>
+        </text>
+      </g>
+      <g id="Line_11">
+        <path d="M 103.35827 315.6964 L 103.35827 66.81647 L 181.20472 66.81647" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_10">
+        <path d="M 274.74803 500.6281 C 274.74803 494.18346 271.79603 493.38613 250.23248 487.0082 L 250.0047 486.9422 C 228.32725 480.49757 228.10178 480.49757 205.85486 480.49757 C 176.23259 480.49757 42.307087 480.49757 42.307087 480.49757 L 42.307087 548.52906 L 274.74803 548.52906 L 274.74803 500.6281 Z" fill="white"/>
+        <path d="M 274.74803 500.6281 C 274.74803 494.18346 271.79603 493.38613 250.23248 487.0082 L 250.0047 486.9422 C 228.32725 480.49757 228.10178 480.49757 205.85486 480.49757 C 176.23259 480.49757 42.307087 480.49757 42.307087 480.49757 L 42.307087 548.52906 L 274.74803 548.52906 L 274.74803 500.6281 Z M 274.74803 500.2961 C 274.74803 494.18346 274.52024 494.18346 228.10178 494.18346 L 228.10178 494.18346 C 228.10178 480.56424 228.10178 480.49757 207.21696 480.49757" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(47.307087 493.5133)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="84.87086" y="11">created in </tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="2.4939117" y="25">«org.eclipse.xtext.ui.shared.internal.Shar</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="21.507584" y="39">edStateContributionRegistryImpl»</tspan>
+        </text>
+      </g>
+      <g id="Line_9">
+        <line x1="103.53654" y1="370.41353" x2="145.36828" y2="480.0304" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_8">
+        <rect x="198.4252" y="416.6929" width="147.40157" height="45.35433" fill="#dedede"/>
+        <rect x="198.4252" y="416.6929" width="147.40157" height="45.35433" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(203.4252 427.3701)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="33.122665" y="8">«com.google.inject»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="17.363876" y="21">OverridingModule</tspan>
+        </text>
+      </g>
+      <g id="Line_7">
+        <path d="M 185.28543 347.4464 L 272.12598 347.4464 L 272.12598 416.6929" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_6">
+        <line x1="547.0866" y1="439.3701" x2="452.4614" y2="439.3701" marker-end="url(#EmptyCenterBall_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_5">
+        <line x1="345.82677" y1="439.3701" x2="439.1614" y2="439.3701" marker-end="url(#UML2Socket_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_4">
+        <path d="M 569.5512 543.1478 C 569.5512 536.70315 567.0312 535.9058 548.6233 529.52787 L 548.4288 529.4619 C 529.9237 523.01725 529.7312 523.01725 510.73993 523.01725 C 485.4526 523.01725 371.126 523.01725 371.126 523.01725 L 371.126 591.04875 L 569.5512 591.04875 L 569.5512 543.1478 Z" fill="white"/>
+        <path d="M 569.5512 543.1478 C 569.5512 536.70315 567.0312 535.9058 548.6233 529.52787 L 548.4288 529.4619 C 529.9237 523.01725 529.7312 523.01725 510.73993 523.01725 C 485.4526 523.01725 371.126 523.01725 371.126 523.01725 L 371.126 591.04875 L 569.5512 591.04875 L 569.5512 543.1478 Z M 569.5512 542.8158 C 569.5512 536.70315 569.3567 536.70315 529.7312 536.70315 L 529.7312 536.70315 C 529.7312 523.0839 529.7312 523.01725 511.9027 523.01725" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(376.126 536.033)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="46.842484" y="11">&lt;extension point= </tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="22.379593" y="25">&quot;org.eclipse.xtext.ui.shared</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="2.5251007" y="39">.sharedStateContributingModule&quot;&gt;</tspan>
+        </text>
+      </g>
+      <g id="Line_3">
+        <line x1="447.6614" y1="439.3701" x2="463.6881" y2="522.5263" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+    </g>
+  </g>
+</svg>
diff --git a/design/chapters/a02_hints/images/cd_customInjectors.svg b/design/chapters/a02_hints/images/cd_customInjectors.svg
new file mode 100644
index 0000000..955bea6
--- /dev/null
+++ b/design/chapters/a02_hints/images/cd_customInjectors.svg
@@ -0,0 +1,320 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xl="http://www.w3.org/1999/xlink" xmlns:dc="http://purl.org/dc/elements/1.1/" viewBox="8.003937 10.838583 1012.7559 899.2283" width="1012.7559" height="899.2283">
+  <defs>
+    <font-face font-family="Helvetica" font-size="8" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="12" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="532.22656" cap-height="719.7266" ascent="770.0195" descent="-229.98047" font-weight="700">
+      <font-face-src>
+        <font-face-name name="Helvetica-Bold"/>
+      </font-face-src>
+    </font-face>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="FilledDiamond_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-9 -4 10 8" markerWidth="10" markerHeight="8" color="black">
+      <g>
+        <path d="M -8 0 L -4 3 L 0 0 L -4 -3 Z" fill="currentColor" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="EmptyCenterBall_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -6 12 12" markerWidth="12" markerHeight="12" color="black">
+      <g>
+        <circle cx="4.799998" cy="0" r="4.79999555411813" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="UML2Socket_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -7 8 14" markerWidth="8" markerHeight="14" color="black">
+      <g>
+        <path d="M 6 -6 C -1 -6 -1 6 6 6" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <font-face font-family="Helvetica" font-size="12" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+  </defs>
+  <metadata> Produced by OmniGraffle 7.11 
+    <dc:date>2018-04-02 21:55:48 +0000</dc:date>
+  </metadata>
+  <g id="Canvas_1" stroke="none" stroke-opacity="1" stroke-dasharray="none" fill="none" fill-opacity="1">
+    <title>Canvas 1</title>
+    <rect fill="white" x="8.003937" y="10.838583" width="1012.7559" height="899.2283"/>
+    <g id="Canvas_1: Layer 1">
+      <title>Layer 1</title>
+      <g id="Graphic_51">
+        <rect x="646.0866" y="67.677165" width="141.73228" height="45" fill="#b8f2ff"/>
+        <rect x="646.0866" y="67.677165" width="141.73228" height="45" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(651.0866 78.177165)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="15.168877" y="8">«org.eclipse.n4js.ui.internal»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="29.186455" y="21">N4JSInjector</tspan>
+        </text>
+      </g>
+      <g id="Graphic_50">
+        <rect x="858.685" y="96.02362" width="147.40157" height="45.35433" fill="#b8f2ff"/>
+        <rect x="858.685" y="96.02362" width="147.40157" height="45.35433" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(863.685 106.70079)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="36.458603" y="8">«org.eclipse.n4js»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="8.694931" y="21">N4JSRuntimeModule</tspan>
+        </text>
+      </g>
+      <g id="Graphic_49">
+        <rect x="858.685" y="42.165354" width="147.40157" height="45.35433" fill="#b8f2ff"/>
+        <rect x="858.685" y="42.165354" width="147.40157" height="45.35433" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(863.685 52.84252)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="32.233994" y="8">«org.eclipse.n4js.ui»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="26.69493" y="21">N4JSUiModule</tspan>
+        </text>
+      </g>
+      <g id="Line_48">
+        <path d="M 797.5689 90.17717 L 823.5689 90.17717 L 823.5689 118.70079 L 858.685 118.70079" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_47">
+        <path d="M 797.5689 90.17717 L 823.5689 90.17717 L 823.5689 64.84252 L 858.685 64.84252" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_46">
+        <path d="M 636.8366 90.17717 L 522.8366 90.17717 L 522.8366 288.77953 L 399.47244 288.77953" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_45">
+        <rect x="164.19685" y="11.338583" width="144.35433" height="45" fill="#dedede"/>
+        <rect x="164.19685" y="11.338583" width="144.35433" height="45" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(169.19685 21.838583)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="2.0287247" y="8">«org.eclipse.xtext.ui.shared.internal»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="25.165443" y="21">SharedInjector</tspan>
+        </text>
+      </g>
+      <g id="Graphic_44">
+        <rect x="252.07087" y="266.10236" width="147.40157" height="45.35433" fill="#dedede"/>
+        <rect x="252.07087" y="266.10236" width="147.40157" height="45.35433" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(257.07087 276.77953)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="3.552353" y="8">«org.eclipse.xtext.ui.shared.internal»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="27.3629" y="21">SharedModule</tspan>
+        </text>
+      </g>
+      <g id="Graphic_43">
+        <rect x="252.28346" y="615.1181" width="147.40157" height="45.35433" fill="#dedede"/>
+        <rect x="252.28346" y="615.1181" width="147.40157" height="45.35433" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(257.28346 625.7953)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="33.122665" y="8">«com.google.inject»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="17.363876" y="21">OverridingModule</tspan>
+        </text>
+      </g>
+      <g id="Graphic_42">
+        <rect x="530.07874" y="790.8661" width="147.40157" height="45.35433" fill="#e4c9ff"/>
+        <rect x="530.07874" y="790.8661" width="147.40157" height="45.35433" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(535.07874 801.5433)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="13.780869" y="8">«org.eclipse.n4js.ts.ui.internal»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="11.715439" y="21">ContributingModule</tspan>
+        </text>
+      </g>
+      <g id="Line_41">
+        <path d="M 236.37402 65.58858 L 236.37402 288.77953 L 252.07087 288.77953" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_40">
+        <path d="M 236.37402 65.58858 L 236.37402 637.7953 L 252.28346 637.7953" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_39">
+        <rect x="541.4173" y="615.1181" width="229.3937" height="45" fill="#b8f2ff"/>
+        <rect x="541.4173" y="615.1181" width="229.3937" height="45" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(546.4173 625.6181)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="73.23006" y="8">«org.eclipse.n4js.ui»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="5.0249786" y="21">N4JSClusteringBuilderConfiguration</tspan>
+        </text>
+      </g>
+      <g id="Line_38">
+        <line x1="541.4173" y1="637.6181" x2="474.3675" y2="637.7834" marker-end="url(#EmptyCenterBall_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_37">
+        <line x1="400.18504" y1="637.7953" x2="461.0675" y2="637.7953" marker-end="url(#UML2Socket_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_36">
+        <rect x="8.503937" y="700.1575" width="144.35433" height="45" fill="#dedede"/>
+        <rect x="8.503937" y="700.1575" width="144.35433" height="45" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(13.503937 710.6575)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="2.0287247" y="8">«org.eclipse.xtext.ui.shared.internal»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="30.509193" y="21">ChildInjector</tspan>
+        </text>
+      </g>
+      <g id="Line_35">
+        <path d="M 80.6811 690.9075 L 80.6811 33.838583 L 164.19685 33.838583" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_34">
+        <rect x="226.77165" y="790.8661" width="147.40157" height="45.35433" fill="#dedede"/>
+        <rect x="226.77165" y="790.8661" width="147.40157" height="45.35433" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(231.77165 801.5433)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="33.122665" y="8">«com.google.inject»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="17.363876" y="21">OverridingModule</tspan>
+        </text>
+      </g>
+      <g id="Line_33">
+        <path d="M 80.6811 754.4075 L 80.6811 813.5433 L 226.77165 813.5433" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_32">
+        <line x1="530.07874" y1="813.5433" x2="435.4535" y2="813.2061" marker-end="url(#EmptyCenterBall_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_31">
+        <line x1="374.17323" y1="813.5433" x2="422.1537" y2="813.2423" marker-end="url(#UML2Socket_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_30">
+        <rect x="646.0866" y="189.56693" width="141.73228" height="45" fill="#efcfbb"/>
+        <rect x="646.0866" y="189.56693" width="141.73228" height="45" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(651.0866 200.06693)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="5.1649704" y="8">«org.eclipse.n4js.n4mf.ui.internal»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="27.862236" y="21">N4MFInjector</tspan>
+        </text>
+      </g>
+      <g id="Graphic_29">
+        <rect x="858.685" y="217.91338" width="147.40157" height="45.35433" fill="#efcfbb"/>
+        <rect x="858.685" y="217.91338" width="147.40157" height="45.35433" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(863.685 228.59055)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="26.454697" y="8">«org.eclipse.n4js.n4mf»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="8.694931" y="21">N4JSRuntimeModule</tspan>
+        </text>
+      </g>
+      <g id="Graphic_28">
+        <rect x="858.685" y="161.22047" width="147.40157" height="45.35433" fill="#efcfbb"/>
+        <rect x="858.685" y="161.22047" width="147.40157" height="45.35433" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(863.685 171.89764)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="22.230087" y="8">«org.eclipse.n4js.n4mf.ui»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="26.69493" y="21">N4JSUiModule</tspan>
+        </text>
+      </g>
+      <g id="Line_27">
+        <path d="M 797.0689 212.06693 L 823.0689 212.06693 L 823.0689 240.59055 L 858.685 240.59055" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_26">
+        <path d="M 797.0689 212.06693 L 823.0689 212.06693 L 823.0689 183.89764 L 858.685 183.89764" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_25">
+        <path d="M 636.8366 212.06693 L 522.8366 212.06693 L 522.8366 288.77953 L 399.47244 288.77953" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_24">
+        <rect x="646.0866" y="490.03937" width="141.73228" height="45" fill="#e4c9ff"/>
+        <rect x="646.0866" y="490.03937" width="141.73228" height="45" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(651.0866 500.53937)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="10.94622" y="8">«org.eclipse.n4js.ts.ui.internal»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="27.296806" y="21">TypesInjector</tspan>
+        </text>
+      </g>
+      <g id="Graphic_23">
+        <rect x="858.8976" y="464.8819" width="147.40157" height="45.35433" fill="#e4c9ff"/>
+        <rect x="858.8976" y="464.8819" width="147.40157" height="45.35433" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(863.8976 475.55905)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="32.235947" y="8">«org.eclipse.n4js.ts»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="6.8052826" y="21">TypesRuntimeModule</tspan>
+        </text>
+      </g>
+      <g id="Graphic_22">
+        <rect x="858.685" y="409.25197" width="147.40157" height="45.35433" fill="#e4c9ff"/>
+        <rect x="858.685" y="409.25197" width="147.40157" height="45.35433" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(863.685 419.92913)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="28.011337" y="8">«org.eclipse.n4js.ts.ui»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="24.805283" y="21">TypesUiModule</tspan>
+        </text>
+      </g>
+      <g id="Line_21">
+        <path d="M 797.5689 512.53937 L 823.5689 512.53937 L 823.5689 487.55905 L 858.8976 487.55905" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_20">
+        <path d="M 797.0689 512.53937 L 823.0689 512.53937 L 823.0689 431.92913 L 858.685 431.92913" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_19">
+        <rect x="646.0866" y="317.126" width="141.73228" height="45" fill="#f1fda4"/>
+        <rect x="646.0866" y="317.126" width="141.73228" height="45" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(651.0866 327.626)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="4.051689" y="8">«org.eclipse.n4js.regex.ui.internal»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="26.186455" y="21">RegexInjector</tspan>
+        </text>
+      </g>
+      <g id="Graphic_18">
+        <rect x="858.8976" y="342.99212" width="147.40157" height="45.35433" fill="#f1fda4"/>
+        <rect x="858.8976" y="342.99212" width="147.40157" height="45.35433" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(863.8976 346.6693)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="25.341415" y="8">«org.eclipse.n4js.regex»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="14.015244" y="21">RegularExpression</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="23.70372" y="35">RuntimeModule</tspan>
+        </text>
+      </g>
+      <g id="Graphic_17">
+        <rect x="858.8976" y="289.13386" width="147.40157" height="45.35433" fill="#f1fda4"/>
+        <rect x="858.8976" y="289.13386" width="147.40157" height="45.35433" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(863.8976 292.81102)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="21.116806" y="8">«org.eclipse.n4js.regex.ui»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="14.015244" y="21">RegularExpression</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="41.70372" y="35">UiModule</tspan>
+        </text>
+      </g>
+      <g id="Line_16">
+        <path d="M 797.5689 339.626 L 823.5689 339.626 L 823.5689 365.6693 L 858.8976 365.6693" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_15">
+        <path d="M 797.0689 339.626 L 823.0689 339.626 L 823.0689 311.81102 L 858.8976 311.81102" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_14">
+        <path d="M 636.8366 512.53937 L 522.8366 512.53937 L 522.8366 288.77953 L 399.47244 288.77953" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_13">
+        <path d="M 636.8366 339.626 L 522.8366 339.626 L 522.8366 288.77953 L 399.47244 288.77953" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_12">
+        <rect x="858.8976" y="600.9449" width="147.40157" height="45.35433" fill="#e4c9ff"/>
+        <rect x="858.8976" y="600.9449" width="147.40157" height="45.35433" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(863.8976 604.62204)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="32.235947" y="8">«org.eclipse.n4js.ts»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="22.792587" y="21">TypeExpression</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="23.70372" y="35">RuntimeModule</tspan>
+        </text>
+      </g>
+      <g id="Graphic_11">
+        <rect x="858.8976" y="544.25197" width="147.40157" height="45.35433" fill="#e4c9ff"/>
+        <rect x="858.8976" y="544.25197" width="147.40157" height="45.35433" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(863.8976 547.9291)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="28.011337" y="8">«org.eclipse.n4js.ts.ui»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="22.792587" y="21">TypeExpression</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="41.70372" y="35">UiModule</tspan>
+        </text>
+      </g>
+      <g id="Line_10">
+        <path d="M 797.0689 512.53937 L 823.0689 512.53937 L 823.0689 623.62204 L 858.8976 623.62204" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_9">
+        <path d="M 797.0689 512.53937 L 823.0689 512.53937 L 823.0689 566.9291 L 858.8976 566.9291" marker-start="url(#FilledDiamond_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_8">
+        <rect x="529.86614" y="864.2126" width="147.40157" height="45.35433" fill="#ffd7df"/>
+        <rect x="529.86614" y="864.2126" width="147.40157" height="45.35433" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(534.86614 874.8898)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="11.335556" y="8">«org.eclipse.n4js.environments»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="11.715439" y="21">ContributingModule</tspan>
+        </text>
+      </g>
+      <g id="Line_7">
+        <line x1="529.86614" y1="886.8898" x2="434.5067" y2="816.0513" marker-end="url(#EmptyCenterBall_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_6">
+        <rect x="529.86614" y="719.6457" width="147.40157" height="45.35433" fill="#b8f2ff"/>
+        <rect x="529.86614" y="719.6457" width="147.40157" height="45.35433" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(534.86614 730.3228)" fill="black">
+          <tspan font-family="Helvetica" font-size="8" font-weight="400" fill="black" x="18.003525" y="8">«org.eclipse.n4js.ui.internal»</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="11.715439" y="21">ContributingModule</tspan>
+        </text>
+      </g>
+      <g id="Line_5">
+        <line x1="529.86614" y1="742.3228" x2="434.55946" y2="810.399" marker-end="url(#EmptyCenterBall_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_4">
+        <path d="M 1020.2598 767.8902 C 1020.2598 756.0751 1016.7678 754.6133 991.2597 742.9204 L 990.9903 742.7994 C 965.3475 730.98425 965.0807 730.98425 938.7643 730.98425 C 903.7233 730.98425 745.2992 730.98425 745.2992 730.98425 L 745.2992 855.7087 L 1020.2598 855.7087 L 1020.2598 767.8902 Z" fill="white"/>
+        <path d="M 1020.2598 767.8902 C 1020.2598 756.0751 1016.7678 754.6133 991.2597 742.9204 L 990.9903 742.7994 C 965.3475 730.98425 965.0807 730.98425 938.7643 730.98425 C 903.7233 730.98425 745.2992 730.98425 745.2992 730.98425 L 745.2992 855.7087 L 1020.2598 855.7087 L 1020.2598 767.8902 Z M 1020.2598 767.2815 C 1020.2598 756.0751 1019.9904 756.0751 965.0807 756.0751 L 965.0807 756.0751 C 965.0807 731.1065 965.0807 730.98425 940.3755 730.98425" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(750.2992 758.34645)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="2.4051208" y="11">Note that &lt;n4js.environments&gt; is a weird bundle. </tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="8.730316" y="25">It is not an UI bundle, but it depends on UI and </tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="21.755707" y="39">contributes to the UI (via extension point). </tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x=".3982849" y="53">Additionally it has no owned Activator, instead it is </tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="74.78012" y="67">loaded from &lt;n4js.ts&gt;</tspan>
+        </text>
+      </g>
+      <g id="Line_3">
+        <line x1="677.2677" y1="886.8898" x2="745.3166" y2="855.9158" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+    </g>
+  </g>
+</svg>
diff --git a/design/chapters/a10_moduleLoading/images/euler_dependencies.svg b/design/chapters/a10_moduleLoading/images/euler_dependencies.svg
new file mode 100644
index 0000000..1a18fad
--- /dev/null
+++ b/design/chapters/a10_moduleLoading/images/euler_dependencies.svg
@@ -0,0 +1,46 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xl="http://www.w3.org/1999/xlink" xmlns:dc="http://purl.org/dc/elements/1.1/" viewBox="42.5 60.5 422 140" width="422" height="140">
+  <defs>
+    <font-face font-family="Helvetica" font-size="12" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="532.22656" cap-height="719.7266" ascent="770.0195" descent="-229.98047" font-weight="700">
+      <font-face-src>
+        <font-face-name name="Helvetica-Bold"/>
+      </font-face-src>
+    </font-face>
+  </defs>
+  <metadata> Produced by OmniGraffle 7.11 
+    <dc:date>2019-08-02 09:54:33 +0000</dc:date>
+  </metadata>
+  <g id="Canvas_1" stroke="none" stroke-opacity="1" stroke-dasharray="none" fill="none" fill-opacity="1">
+    <title>Canvas 1</title>
+    <rect fill="white" x="42.5" y="60.5" width="422" height="140"/>
+    <g id="Canvas_1: overlapped">
+      <title>overlapped</title>
+      <g id="Graphic_166">
+        <path d="M 402.3458 106.10917 C 484.55154 127.58799 484.55154 162.41201 402.3458 183.89083 C 320.1405 205.36976 186.8595 205.36976 104.65419 183.89083 C 22.448464 162.41201 22.448464 127.58799 104.65419 106.10917 C 186.8595 84.63024 320.1405 84.63024 402.3458 106.10917" fill="#76f2a3" fill-opacity=".52"/>
+        <path d="M 402.3458 106.10917 C 484.55154 127.58799 484.55154 162.41201 402.3458 183.89083 C 320.1405 205.36976 186.8595 205.36976 104.65419 183.89083 C 22.448464 162.41201 22.448464 127.58799 104.65419 106.10917 C 186.8595 84.63024 320.1405 84.63024 402.3458 106.10917" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_167">
+        <ellipse cx="222.8701" cy="111.5" rx="170.870383733185" ry="50.5000806940457" fill="#ffafaa" fill-opacity=".5"/>
+        <ellipse cx="222.8701" cy="111.5" rx="170.870383733185" ry="50.5000806940457" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_170">
+        <ellipse cx="279.6378" cy="105.88221" rx="89.2335791707502" ry="26.3726395661133" fill="#85bfff" fill-opacity=".49"/>
+        <ellipse cx="279.6378" cy="105.88221" rx="89.2335791707502" ry="26.3726395661133" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(211.25104 98.88221)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="40.05081" y="11">Load time</tspan>
+        </text>
+      </g>
+      <g id="Graphic_197">
+        <text transform="translate(193 62)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="0" y="11">Runtime</tspan>
+        </text>
+      </g>
+      <g id="Graphic_198">
+        <text transform="translate(215.82715 177)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="0" y="11">Compile time</tspan>
+        </text>
+      </g>
+    </g>
+  </g>
+</svg>
diff --git a/design/chapters/a10_moduleLoading/images/moduleLoader.svg b/design/chapters/a10_moduleLoading/images/moduleLoader.svg
new file mode 100644
index 0000000..9e34ca6
--- /dev/null
+++ b/design/chapters/a10_moduleLoading/images/moduleLoader.svg
@@ -0,0 +1,223 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xl="http://www.w3.org/1999/xlink" xmlns:dc="http://purl.org/dc/elements/1.1/" viewBox="34.034308 64.69685 738.69404 463.6142" width="738.69404" height="463.6142">
+  <defs>
+    <font-face font-family="Helvetica" font-size="12" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="532.22656" cap-height="719.7266" ascent="770.0195" descent="-229.98047" font-weight="700">
+      <font-face-src>
+        <font-face-name name="Helvetica-Bold"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="12" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="StickArrow_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -4 10 8" markerWidth="10" markerHeight="8" color="black">
+      <g>
+        <path d="M 8 0 L 0 0 M 0 -3 L 8 0 L 0 3" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <font-face font-family="Helvetica" font-size="10" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="9" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+  </defs>
+  <metadata> Produced by OmniGraffle 7.11 
+    <dc:date>2015-09-02 08:48:51 +0000</dc:date>
+  </metadata>
+  <g id="Canvas_1" stroke="none" stroke-opacity="1" stroke-dasharray="none" fill="none" fill-opacity="1">
+    <title>Canvas 1</title>
+    <rect fill="white" x="34.034308" y="64.69685" width="738.69404" height="463.6142"/>
+    <g id="Canvas_1: Layer 1">
+      <title>Layer 1</title>
+      <g id="Graphic_163">
+        <rect x="286.2992" y="65.19685" width="99" height="36" fill="white"/>
+        <rect x="286.2992" y="65.19685" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(291.2992 76.19685)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="11.816406" y="11">ES6 Syntax</tspan>
+        </text>
+      </g>
+      <g id="Graphic_164">
+        <rect x="170.07874" y="293.38583" width="99" height="36" fill="white"/>
+        <rect x="170.07874" y="293.38583" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(175.07874 304.38583)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="11.163086" y="11">CommonJS</tspan>
+        </text>
+      </g>
+      <g id="Graphic_165">
+        <rect x="286.2992" y="293.38583" width="99" height="36" fill="white"/>
+        <rect x="286.2992" y="293.38583" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(291.2992 304.38583)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="30.835938" y="11">AMD</tspan>
+        </text>
+      </g>
+      <g id="Graphic_166">
+        <rect x="528.6614" y="293.38583" width="99" height="36" fill="white"/>
+        <rect x="528.6614" y="293.38583" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(533.6614 304.38583)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="16.483398" y="11">System.js</tspan>
+        </text>
+      </g>
+      <g id="Graphic_148">
+        <path d="M 236.93957 412.05736 C 236.93957 407.52946 235.68227 406.96927 226.49804 402.4882 L 226.40102 402.44185 C 217.16828 397.91395 217.07225 397.91395 207.59696 397.91395 C 194.9804 397.91395 137.93957 397.91395 137.93957 397.91395 L 137.93957 445.7119 L 236.93957 445.7119 L 236.93957 412.05736 Z" fill="white"/>
+        <path d="M 236.93957 412.05736 C 236.93957 407.52946 235.68227 406.96927 226.49804 402.4882 L 226.40102 402.44185 C 217.16828 397.91395 217.07225 397.91395 207.59696 397.91395 C 194.9804 397.91395 137.93957 397.91395 137.93957 397.91395 L 137.93957 445.7119 L 236.93957 445.7119 L 236.93957 412.05736 Z M 236.93957 411.8241 C 236.93957 407.52946 236.84255 407.52946 217.07225 407.52946 L 217.07225 407.52946 C 217.07225 397.9608 217.07225 397.91395 208.1771 397.91395" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(142.93957 400.8129)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="21.929688" y="11">Different </tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="6.481445" y="25">Semantics: no </tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="12.481445" y="39">live-binding!</tspan>
+        </text>
+      </g>
+      <g id="Line_188">
+        <line x1="311.0492" y1="329.38583" x2="218.6237" y2="398.4955" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_189">
+        <line x1="219.57874" y1="329.38583" x2="195.91405" y2="397.4417" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_190">
+        <rect x="673.22835" y="293.38583" width="99" height="36" fill="white"/>
+        <rect x="673.22835" y="293.38583" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(678.22835 304.38583)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="21.15332" y="11">&lt;script&gt;</tspan>
+        </text>
+      </g>
+      <g id="Line_213">
+        <line x1="310" y1="101.19685" x2="223.79335" y2="284.42775" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_214">
+        <text transform="translate(228.5829 145.62416)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«transpiler:</tspan>
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="22">Babel, Traceur, TypeScript»</tspan>
+        </text>
+      </g>
+      <g id="Line_215">
+        <line x1="345.6992" y1="101.19685" x2="336.3085" y2="283.49894" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_216">
+        <text transform="translate(285.34995 183.49028)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«transpiler:</tspan>
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="22">Babel, Traceur, TypeScript»</tspan>
+        </text>
+      </g>
+      <g id="Line_217">
+        <line x1="365.4992" y1="101.19685" x2="546.4903" y2="286.30715" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_218">
+        <text transform="translate(431.1023 227.7751)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«transpiler: </tspan>
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="22">Babel, Traceur, TypeScript»</tspan>
+        </text>
+      </g>
+      <g id="Graphic_221">
+        <rect x="337.32284" y="491.811" width="99" height="36" fill="white"/>
+        <rect x="337.32284" y="491.811" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(342.32284 495.811)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="16.483398" y="11">System.js </tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="1.8320312" y="25">Module Loader</tspan>
+        </text>
+      </g>
+      <g id="Line_146">
+        <line x1="416.52284" y1="491.811" x2="547.0315" y2="336.95594" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_212">
+        <text transform="translate(470.0524 410.24805)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«loads»</tspan>
+        </text>
+      </g>
+      <g id="Line_222">
+        <line x1="357.12284" y1="491.811" x2="249.97562" y2="337.5174" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_223">
+        <text transform="translate(277.79805 408.0215)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«loads»</tspan>
+        </text>
+      </g>
+      <g id="Line_224">
+        <line x1="376.92284" y1="491.811" x2="338.22908" y2="338.983" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_225">
+        <text transform="translate(332.996 407.85407)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«loads»</tspan>
+        </text>
+      </g>
+      <g id="Graphic_226">
+        <path d="M 622.83465 414.5759 C 622.83465 411.21694 621.69995 410.80137 613.4113 407.47717 L 613.3237 407.44277 C 604.9913 404.0838 604.9046 404.0838 596.35325 404.0838 C 584.96694 404.0838 533.4882 404.0838 533.4882 404.0838 L 533.4882 439.542 L 622.83465 439.542 L 622.83465 414.5759 Z" fill="white"/>
+        <path d="M 622.83465 414.5759 C 622.83465 411.21694 621.69995 410.80137 613.4113 407.47717 L 613.3237 407.44277 C 604.9913 404.0838 604.9046 404.0838 596.35325 404.0838 C 584.96694 404.0838 533.4882 404.0838 533.4882 404.0838 L 533.4882 439.542 L 622.83465 439.542 L 622.83465 414.5759 Z M 622.83465 414.40286 C 622.83465 411.21694 622.7471 411.21694 604.9046 411.21694 L 604.9046 411.21694 C 604.9046 404.11857 604.9046 404.0838 596.8768 404.0838" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(538.4882 407.8129)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="6.986706" y="11">ES6 Module </tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="5.6478386" y="25">Loader Spec</tspan>
+        </text>
+      </g>
+      <g id="Line_227">
+        <line x1="578.1614" y1="329.38583" x2="578.1614" y2="403.5838" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_228">
+        <rect x="37.43307" y="65.19685" width="99" height="36" fill="white"/>
+        <rect x="37.43307" y="65.19685" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(42.43307 69.19685)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="13.93457" y="11">TypeScript </tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="24.82422" y="25">Syntax</tspan>
+        </text>
+      </g>
+      <g id="Graphic_229">
+        <rect x="35.43307" y="297.6378" width="99" height="36" fill="white"/>
+        <rect x="35.43307" y="297.6378" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(40.43307 308.6378)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="13.495117" y="11">TS Internal</tspan>
+        </text>
+      </g>
+      <g id="Line_230">
+        <line x1="86.93307" y1="101.19685" x2="85.03386" y2="287.7383" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_231">
+        <text transform="translate(39.034308 232.61462)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«transpiler: TypeScript»</tspan>
+        </text>
+      </g>
+      <g id="Graphic_232">
+        <path d="M 586.8268 79.23073 C 586.8268 75.87178 585.6921 75.45621 577.4034 72.132 L 577.31585 72.09761 C 568.9834 68.73865 568.8967 68.73865 560.3454 68.73865 C 548.9591 68.73865 497.4803 68.73865 497.4803 68.73865 L 497.4803 104.19685 L 586.8268 104.19685 L 586.8268 79.23073 Z" fill="white"/>
+        <path d="M 586.8268 79.23073 C 586.8268 75.87178 585.6921 75.45621 577.4034 72.132 L 577.31585 72.09761 C 568.9834 68.73865 568.8967 68.73865 560.3454 68.73865 C 548.9591 68.73865 497.4803 68.73865 497.4803 68.73865 L 497.4803 104.19685 L 586.8268 104.19685 L 586.8268 79.23073 Z M 586.8268 79.0577 C 586.8268 75.87178 586.7392 75.87178 568.8967 75.87178 L 568.8967 75.87178 C 568.8967 68.7734 568.8967 68.73865 560.86895 68.73865" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(502.4803 72.46775)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="4.32362" y="11">read-only ref, </tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="9.321667" y="25">live-binding</tspan>
+        </text>
+      </g>
+      <g id="Line_233">
+        <line x1="385.2992" y1="86.79685" x2="496.9803" y2="86.56253" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_234">
+        <rect x="413.85827" y="294.23415" width="99" height="36" fill="white"/>
+        <rect x="413.85827" y="294.23415" width="99" height="36" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(418.85827 299.73415)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="30.835938" y="11">UMD </tspan>
+          <tspan font-family="Helvetica" font-size="9" font-weight="400" fill="black" x="5.3688965" y="23">(CommonJS+AMD)</tspan>
+        </text>
+      </g>
+      <g id="Line_235">
+        <line x1="345.6992" y1="101.19685" x2="434.3148" y2="285.3136" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_236">
+        <text transform="translate(324.22746 186.19857)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«transpiler:</tspan>
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="22">Babel, Traceur, TypeScript»</tspan>
+        </text>
+      </g>
+      <g id="Line_237">
+        <line x1="413.40133" y1="321.43713" x2="229.07144" y2="403.3194" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Line_238">
+        <line x1="396.72284" y1="491.811" x2="459.5838" y2="339.3864" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_239">
+        <text transform="translate(416.8559 409.0838)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«loads»</tspan>
+        </text>
+      </g>
+    </g>
+  </g>
+</svg>
diff --git a/design/compilation.html b/design/compilation.html
new file mode 100644
index 0000000..8318e90
--- /dev/null
+++ b/design/compilation.html
@@ -0,0 +1,1919 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="generator" content="Asciidoctor 1.5.5">
+<meta name="author" content="2019-08-07 15:02:40 CEST">
+<title>N4JS Design Specification</title>
+<link rel="stylesheet" href="styles/spec.min.css">
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.6.3/css/font-awesome.min.css">
+<!-- ************* docinfo ******************************************************************* -->
+
+
+<!-- ************* Favicon ************-->
+<link rel="icon" href="images/favicon.ico" />
+
+<!-- ************* Back-to-top JQuery ************* -->
+<script src="https://code.jquery.com/jquery-1.12.4.js"></script>
+<script src="https://code.jquery.com/ui/1.12.0/jquery-ui.js"></script>
+
+
+<link href="styles/prism.min.css" rel="stylesheet" />
+<script type="text/javascript" async
+  src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2/MathJax.js?config=TeX-MML-AM_CHTML">
+</script>
+
+<!-- ************* Styles ************* -->
+<link rel="stylesheet" type="text/css" href="styles/n4jsspec-adoc.css">
+
+
+<!-- ****************** NavBar ****************** -->
+<div id="menubar">
+	<div class="banner">
+        <a href="https://www.eclipse.org/n4js/#"><img id="logo" src="images/n4js-logo.png" alt="Eclipse N4JS"></a>
+    </div>
+<ul>
+  <li><a href="index.html">Index</a></li>
+</ul>
+</div>
+<!-- ************* docinfo ******************************************************************* -->
+<style>
+      .admonitionblock td.icon .icon-todo:before{content:"\f249";color:#f4ee42}
+    </style>
+</head>
+<body class="book toc2 toc-left">
+<div id="header">
+<h1>N4JS Design Specification</h1>
+<div class="details">
+<span id="author" class="author">2019-08-07 15:02:40 CEST</span><br>
+<span id="revnumber">version 0.9</span>
+</div>
+<div id="toc" class="toc2">
+<div id="toctitle">Table of Contents</div>
+<ul class="sectlevel1">
+<li><a href="introduction.html#_introduction">1. Introduction</a>
+<ul class="sectlevel2">
+<li><a href="introduction.html#notation">1.1. Notation</a></li>
+<li><a href="introduction.html#sec:IDE_Overview">1.2. IDE Components</a>
+<ul class="sectlevel3">
+<li><a href="introduction.html#sec:Naming_Conventions">1.2.1. Naming Conventions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="eclipse_setup.html#_eclipse-setup">2. Eclipse Setup</a>
+<ul class="sectlevel2">
+<li><a href="eclipse_setup.html#_system-requirements">2.1. System Requirements</a></li>
+<li><a href="eclipse_setup.html#_contribute">2.2. Contribute</a>
+<ul class="sectlevel3">
+<li><a href="eclipse_setup.html#_eclipse-installer">2.2.1. Eclipse Installer</a>
+<ul class="sectlevel4">
+<li><a href="eclipse_setup.html#_changing-the-setup-script">2.2.1.1. Changing the Setup Script</a></li>
+</ul>
+</li>
+<li><a href="eclipse_setup.html#_manual-ide-configuration">2.2.2. Manual IDE Configuration</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="release_engineering.html#_release-engineering">3. Release Engineering</a>
+<ul class="sectlevel2">
+<li><a href="release_engineering.html#_nightly-build-on-eclipse-infrastructure">3.1. Nightly build on Eclipse infrastructure</a></li>
+<li><a href="release_engineering.html#_build-the-n4js-ide-from-command-line">3.2. Build the N4JS IDE from command line</a>
+<ul class="sectlevel3">
+<li><a href="release_engineering.html#_publish-maven-tooling-code-org-eclipse-n4js-releng-util-code">3.2.1. Publish maven-tooling <code>org.eclipse.n4js.releng.util</code></a></li>
+<li><a href="release_engineering.html#sec:test-verdaccio">3.2.2. Test Verdaccio containing n4js-libs</a></li>
+<li><a href="release_engineering.html#_generation-of-eclipse-help-for-spec-and-design-document">3.2.3. Generation of Eclipse help for spec and design document</a></li>
+</ul>
+</li>
+<li><a href="release_engineering.html#_updating-frameworks-and-dependencies">3.3. Updating frameworks and dependencies</a>
+<ul class="sectlevel3">
+<li><a href="release_engineering.html#_update-of-eclipse-emf-xtext-etc">3.3.1. Update of Eclipse, EMF, Xtext, etc.</a></li>
+<li><a href="release_engineering.html#_update-of-the-embedded-jre">3.3.2. Update of the embedded JRE</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tips_and_tricks.html#_tips-and-tricks">4. Tips and Tricks</a>
+<ul class="sectlevel2">
+<li><a href="tips_and_tricks.html#_naming">4.1. Naming</a></li>
+<li><a href="tips_and_tricks.html#_logging">4.2. Logging</a></li>
+<li><a href="tips_and_tricks.html#_cancellation-handling">4.3. Cancellation Handling</a></li>
+<li><a href="tips_and_tricks.html#_caching">4.4. Caching</a></li>
+<li><a href="tips_and_tricks.html#_dependency-injection">4.5. Dependency Injection</a></li>
+<li><a href="tips_and_tricks.html#_miscellaneous">4.6. Miscellaneous</a></li>
+</ul>
+</li>
+<li><a href="parser.html#_parser">5. Parser</a>
+<ul class="sectlevel2">
+<li><a href="parser.html#sec:Parser_Overview">5.1. Overview</a></li>
+<li><a href="parser.html#sec:N4JS_Parser">5.2. N4JS Parser</a></li>
+<li><a href="parser.html#sec:Parser_Generation_Post_Processing">5.3. Parser Generation Post-Processing</a>
+<ul class="sectlevel3">
+<li><a href="parser.html#sec:Automatic_Semicolon_Insertion">5.3.1. Automatic Semicolon Insertion</a>
+<ul class="sectlevel4">
+<li><a href="parser.html#sec:Injected_code_in_the_Antlr_grammar_file">5.3.1.1. Injected code in the Antlr grammar file</a></li>
+<li><a href="parser.html#sec:Customized_error_recovery">5.3.1.2. Customized error recovery</a></li>
+</ul>
+</li>
+<li><a href="parser.html#sec:_No_line_terminator_allowed_here__handling">5.3.2. Async and <code>No line terminator allowed here</code> Handling</a></li>
+<li><a href="parser.html#sec:Regular_Expression">5.3.3. Regular Expression</a></li>
+<li><a href="parser.html#sec:Unicode">5.3.4. Unicode</a></li>
+<li><a href="parser.html#sec:Literals">5.3.5. Literals</a></li>
+</ul>
+</li>
+<li><a href="parser.html#sec:Modifiers">5.4. Modifiers</a></li>
+<li><a href="parser.html#sec:Conflict_Resolutions">5.5. Conflict Resolutions</a>
+<ul class="sectlevel3">
+<li><a href="parser.html#sec:Reserved_Keywords_vs__Identifier_Names">5.5.1. Reserved Keywords vs. Identifier Names</a></li>
+<li><a href="parser.html#sec:Operators_and_Generics">5.5.2. Operators and Generics</a></li>
+</ul>
+</li>
+<li><a href="parser.html#sec:Content_Assist_Parser">5.6. Content-Assist Parser</a></li>
+</ul>
+</li>
+<li><a href="type_system.html#_type-system">6. Type System</a>
+<ul class="sectlevel2">
+<li><a href="type_system.html#sec:Type_Model_and_Grammar">6.1. Type Model and Grammar</a>
+<ul class="sectlevel3">
+<li><a href="type_system.html#sec:Type_Model_Overview">6.1.1. Type Model Overview</a></li>
+<li><a href="type_system.html#sec:Built_in_Types">6.1.2. Built-in and Primitive Types</a></li>
+<li><a href="type_system.html#sec:Type_Model_DSL">6.1.3. Type Model DSL</a></li>
+</ul>
+</li>
+<li><a href="type_system.html#sec:Type_System_Implementation">6.2. Type System Implementation</a></li>
+<li><a href="type_system.html#sec:Type_Inference_combined_with_AST_Traversal">6.3. Type Inference of AST</a>
+<ul class="sectlevel3">
+<li><a href="type_system.html#sec:Type_Inference_combined_with_AST_Traversal__Background">6.3.1. Background</a></li>
+<li><a href="type_system.html#sec:Triggering_Type_Inference_of_AST">6.3.2. Triggering</a></li>
+<li><a href="type_system.html#sec:Traversal_Order_During_Type_Inference_of_AST">6.3.3. Traversal Order</a></li>
+<li><a href="type_system.html#sec:Cross_References_During_Type_Inference_of_AST">6.3.4. Cross-References</a></li>
+<li><a href="type_system.html#sec:Function_Accessor_Bodies_During_Type_Inference_of_AST">6.3.5. Function/Accessor Bodies</a></li>
+<li><a href="type_system.html#sec:Poly_Expressions_During_Type_Inference_of_AST">6.3.6. Poly Expressions</a></li>
+<li><a href="type_system.html#sec:Constraint_Solver_used_During_Type_Inference_of_AST">6.3.7. Constraint Solver</a></li>
+<li><a href="type_system.html#sec:Type_Guards_During_Type_Inference_of_AST">6.3.8. Type Guards</a></li>
+</ul>
+</li>
+<li><a href="type_system.html#sec:Structural_Typing">6.4. Structural Typing</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#_type-index">7. Type Index</a>
+<ul class="sectlevel2">
+<li><a href="type_index.html#sec:Type_Index_Design_Rationale">7.1. Design Rationale</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#sec:Getting_the_Xtext_Index_Content_IResourceDescriptions">7.1.1. Getting the Xtext Index (<code>IResourceDescriptions</code>) Content</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#sec:Design_Overview">7.2. Design Overview</a></li>
+<li><a href="type_index.html#sec:N4JS_Resource_Load_States">7.3. N4JS Resource Load States</a></li>
+<li><a href="type_index.html#sec:Type_Builder">7.4. Types Builder</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#sec:Type_Inference_not_allowed_in_Type_Builder">7.4.1. Type Inference not allowed in Types Builder</a></li>
+<li><a href="type_index.html#sec:ComputedTypeReferences">7.4.2. Deferred Type References</a></li>
+<li><a href="type_index.html#sec:Use_cases_of_ComputedTypeRef">7.4.3. Use cases of DeferredTypeRef</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#sec:Incremental_Builder_Overview">7.5. Incremental Builder (Overview)</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#sec:Incremental_Builder_Overview__XtextBuilder">7.5.1. XtextBuilder</a></li>
+<li><a href="type_index.html#sec:Incremental_Builder_Overview__IBuilderState">7.5.2. IBuilderState</a>
+<ul class="sectlevel4">
+<li><a href="type_index.html#copy-and-update-xtext-index">7.5.2.1. Copy and Update Xtext Index</a></li>
+<li><a href="type_index.html#build-state-setup-phase">7.5.2.2. Build State Setup Phase</a></li>
+<li><a href="type_index.html#process-queued-uris">7.5.2.3. Process Queued URIs</a></li>
+<li><a href="type_index.html#queueing-affected-resources">7.5.2.4. Queueing Affected Resources</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#sec:Incremental_Builder_Overview__Example">7.5.3. Example</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#dirty-state-handling">7.6. Dirty state handling</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#use-case-restoring-types-from-user-data">7.6.1. Use case: Restoring types from user data</a></li>
+<li><a href="type_index.html#use-case-updating-the-xtext-index">7.6.2. Use case: Updating the Xtext index</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="project_model.html#_project-model">8. Project Model</a>
+<ul class="sectlevel2">
+<li><a href="project_model.html#sec:Package_json">8.1. Package.json File</a></li>
+<li><a href="project_model.html#_accessing-project-information">8.2. Accessing Project Information</a>
+<ul class="sectlevel3">
+<li><a href="project_model.html#sec:IN4JSCore">8.2.1. IN4JSCore</a></li>
+<li><a href="project_model.html#sec:N4JSModel">8.2.2. N4JSModel</a></li>
+<li><a href="project_model.html#sec:N4JSWorkspace">8.2.3. N4JSWorkspace</a></li>
+<li><a href="project_model.html#sec:N4JSProject">8.2.4. N4JSProject</a></li>
+<li><a href="project_model.html#sec:SourceContainer">8.2.5. SourceContainer</a></li>
+<li><a href="project_model.html#sec:N4JSProjectsStateHelper">8.2.6. N4JSProjectsStateHelper</a></li>
+</ul>
+</li>
+<li><a href="project_model.html#sec:Caching">8.3. Caching</a>
+<ul class="sectlevel3">
+<li><a href="project_model.html#_caching-of-externallibraryworkspace">8.3.1. Caching of ExternalLibraryWorkspace</a></li>
+<li><a href="project_model.html#_caching-of-n4jsprojectsstatehelper">8.3.2. Caching of N4JSProjectsStateHelper</a></li>
+</ul>
+</li>
+<li><a href="project_model.html#sec:WildcardPathFilter">8.4. WildcardPathFilter</a></li>
+<li><a href="project_model.html#sec:ProjectUtils">8.5. ProjectUtils</a></li>
+</ul>
+</li>
+<li><a href="binding.html#_binding">9. Binding</a>
+<ul class="sectlevel2">
+<li><a href="binding.html#sec:Binding_Design_Rationale">9.1. Design Rationale</a></li>
+<li><a href="binding.html#sec:Binding_to_Members">9.2. Binding to Members</a></li>
+<li><a href="binding.html#sec:Binding_Getter_Setter">9.3. Getter / Setter Binding</a></li>
+<li><a href="binding.html#chap:Statics">9.4. Static Member Binding</a></li>
+<li><a href="binding.html#sec:Binding_Enumeration">9.5. Enumeration Literals Binding</a></li>
+<li><a href="binding.html#sec:Accessibility_of_types_and_members">9.6. Accessibility of types and members</a></li>
+<li><a href="binding.html#sec:Member_Scope_Example">9.7. Member Scope Example</a></li>
+<li><a href="binding.html#sec:Scoping_for_Members_of_Composed_Type_Explained">9.8. Scoping for Members of Composed Type (Union/Intersection) Example</a></li>
+<li><a href="binding.html#sec:Binding_of_Structurally_References_Types">9.9. Structurally References Types</a></li>
+<li><a href="binding.html#sec:Building">9.10. Building</a>
+<ul class="sectlevel3">
+<li><a href="binding.html#sec:Build_Phases">9.10.1. Build Phases</a></li>
+<li><a href="binding.html#sec:Build_Scenarios">9.10.2. Build Scenarios</a></li>
+<li><a href="binding.html#sec:Lazy_linking_problem">9.10.3. Lazy linking problem</a></li>
+</ul>
+</li>
+<li><a href="binding.html#sec:Proxies_and_Proxy_Resolution">9.11. Proxies and Proxy Resolution (Overview)</a>
+<ul class="sectlevel3">
+<li><a href="binding.html#xtexts-lazy-linking-proxies">9.11.1. Xtext’s Lazy Linking Proxies</a></li>
+<li><a href="binding.html#standard-emf-proxies">9.11.2. Standard EMF Proxies</a></li>
+<li><a href="binding.html#_how-is-proxy-resolution-triggered">9.11.3. How is Proxy Resolution Triggered?</a></li>
+<li><a href="binding.html#_when-is-proxy-resolution-allowed">9.11.4. When is Proxy Resolution Allowed?</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="validation.html#_validation">10. Validation</a>
+<ul class="sectlevel2">
+<li><a href="validation.html#sec:validation_overview">10.1. Validation overview</a></li>
+<li><a href="validation.html#sec:validation_control_flow">10.2. Validation control flow</a></li>
+<li><a href="validation.html#sec:validation_issue_ids">10.3. Issue IDs and Messages</a></li>
+<li><a href="validation.html#sec:validation_usage_patterns">10.4. Usage Pattern</a></li>
+<li><a href="validation.html#sec:validation_links">10.5. Links</a></li>
+</ul>
+</li>
+<li><a href="references.html#_references">11. References</a>
+<ul class="sectlevel2">
+<li><a href="references.html#sec:usecases">11.1. Use cases</a></li>
+<li><a href="references.html#sec:calculation_algorithm">11.2. Calculation algorithm</a>
+<ul class="sectlevel3">
+<li><a href="references.html#sec:Xtext_default_implementation">11.2.1. Xtext default implementation</a></li>
+<li><a href="references.html#sec:N4_implementation">11.2.2. N4JS implementation</a></li>
+</ul>
+</li>
+<li><a href="references.html#sec:PerformanceOfDependencyCalculation">11.3. Performance Of Dependency Calculation</a></li>
+<li><a href="references.html#sec:kinds_of_references">11.4. Kinds of references</a>
+<ul class="sectlevel3">
+<li><a href="references.html#sec:Cross_References_to_be_ignored">11.4.1. Cross References to be ignored</a></li>
+<li><a href="references.html#sec:Cross_References_to_be_handled">11.4.2. Cross References to be handled</a></li>
+</ul>
+</li>
+<li><a href="references.html#sec:transitive_dependencies">11.5. Transitive dependencies</a></li>
+<li><a href="references.html#sec:find-references">11.6. Find references</a>
+<ul class="sectlevel3">
+<li><a href="references.html#_background">11.6.1. Background</a></li>
+<li><a href="references.html#_how-find-references-work">11.6.2. How Find References Work</a>
+<ul class="sectlevel4">
+<li><a href="references.html#_step-1-convert-cursor-position-to-declared-element">11.6.2.1. Step 1: Convert Cursor Position to Declared Element</a></li>
+<li><a href="references.html#_step-2-convert-declared-element-to-target-uris">11.6.2.2. Step 2: Convert Declared Element to Target URIs</a></li>
+<li><a href="references.html#_step-3-filter-potential-resources">11.6.2.3. Step 3: Filter Potential Resources</a></li>
+<li><a href="references.html#_step-4-search-references-in-resource">11.6.2.4. Step 4: Search References in Resource</a></li>
+<li><a href="references.html#_limitations-and-possible-enhancements">11.6.2.5. Limitations and Possible Enhancements</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#_compilation">12. Compilation</a>
+<ul class="sectlevel2">
+<li><a href="#chap:compilation">12.1. Introduction</a>
+<ul class="sectlevel3">
+<li><a href="#sec:general_design_rationals">12.1.1. General design rationals</a>
+<ul class="sectlevel4">
+<li><a href="#sec:logging_and_error_reporting">12.1.1.1. Logging and error reporting</a></li>
+<li><a href="#sec:progress_monitor">12.1.1.2. Progress monitor</a></li>
+</ul>
+</li>
+<li><a href="#sec:Xtext_Integration">12.1.2. Xtext Integration</a>
+<ul class="sectlevel4">
+<li><a href="#sec:xtext_default_behaviour">12.1.2.1. Xtext default behaviour</a></li>
+<li><a href="#sec:n4js_requirements">12.1.2.2. N4JS requirements</a></li>
+<li><a href="#sec:compiler_discovery_in_ui">12.1.2.3. Compiler discovery in UI</a></li>
+<li><a href="#sec:compiler_discovery_in_headless">12.1.2.4. Compiler discovery in headless</a></li>
+<li><a href="#sec:general_generator_implementation">12.1.2.5. General generator implementation</a></li>
+<li><a href="#sec:general_generator_activation">12.1.2.6. General generator activation</a></li>
+</ul>
+</li>
+<li><a href="#sec:Overview_of_Input_Models">12.1.3. Overview of the Input Models</a></li>
+</ul>
+</li>
+<li><a href="#sec:Core_Generator">12.2. Generators</a>
+<ul class="sectlevel3">
+<li><a href="#sec:Compiler_Components">12.2.1. Generator Components</a></li>
+<li><a href="#sec:Generator_architecture">12.2.2. Generator architecture</a></li>
+<li><a href="#sec:Unified_Compiler_Configuration">12.2.3. Unified Compiler Configuration</a></li>
+</ul>
+</li>
+<li><a href="#sec:Transpilers">12.3. Transpilers</a>
+<ul class="sectlevel3">
+<li><a href="#sec:Phases">12.3.1. Overview</a></li>
+<li><a href="#relation-between-ast-and-im">12.3.2. Relation between AST and IM</a></li>
+<li><a href="#implementation-overview">12.3.3. Implementation Overview</a></li>
+<li><a href="#sec:Guidelines_for_Implementing_Transformations">12.3.4. Guidelines for Implementing Transformations</a></li>
+<li><a href="#symbol-table-in-the-im">12.3.5. Symbol Table in the IM</a></li>
+</ul>
+</li>
+<li><a href="#sec:N4JS_to_EcmaScript_Transpiler">12.4. N4JS-to-EcmaScript Transpiler</a>
+<ul class="sectlevel3">
+<li><a href="#sec:Overview_of_Transformations">12.4.1. Overview of Transformations</a></li>
+<li><a href="#sec:Transpiling_members">12.4.2. Transpiling members</a>
+<ul class="sectlevel4">
+<li><a href="#sec:Transpiling_members__Delegating_members">12.4.2.1. Techniques for special member handling</a></li>
+<li><a href="#sec:Transpiling_members__Partial_shadowing_of_getter_setter_pairs">12.4.2.2. Partial shadowing</a></li>
+<li><a href="#sec:Transpiling_members__Consuming_or_inheriting_members_of_an_interface">12.4.2.3. Consuming or inheriting members of an interface</a></li>
+<li><a href="#sec:Transpiling_members__Static_polyfill">12.4.2.4. Static polyfill</a></li>
+<li><a href="#sec:Transpiling_members__API_implementation_stubs">12.4.2.5. API / implementation stubs</a></li>
+</ul>
+</li>
+<li><a href="#sec:Support_for_incomplete_API_implementation_testing_in_the_N4JS_to_EcmaScript_5_Transpiler">12.4.3. Support for incomplete API implementation testing</a>
+<ul class="sectlevel4">
+<li><a href="#sec:Modifications_in_Impl_projects">12.4.3.1. Modifications in Impl projects</a></li>
+<li><a href="#sec:Implementation_of_stub_generation">12.4.3.2. Implementation of stub-generation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#sec:n4jsc_Headless_Compiler_Interface">12.5. n4jsc Headless Compiler Interface</a>
+<ul class="sectlevel3">
+<li><a href="#sec:building_the_headless_compiler">12.5.1. building the headless compiler</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="execution.html#_execution">13. Execution</a>
+<ul class="sectlevel2">
+<li><a href="execution.html#sec:N4JS_Project_Execution_And_Linking_Model">13.1. N4JS Project Execution And Linking Model</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#subsec:N4JS_Execution_With_NodeJS">13.1.1. N4JS Execution With NodeJS</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:N4JS_Execution_And_Linking_File">13.2. N4JS Execution And Linking File</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#subsec:NodeJS_Specific_ELF">13.2.1. NodeJS Specific ELF</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Runners-execution">13.3. Runners</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#subsec:N4_Runtime_Environments_Convention">13.3.1. N4 Runtime Environments Convention</a></li>
+<li><a href="execution.html#subsec:Passing_Information_from_IDE_to_Execution_Code_in_Runtime_Environment">13.3.2. Passing Information from IDE to Execution Code in Runtime Environment</a></li>
+<li><a href="execution.html#subsec:Runners_Design">13.3.3. Runners Design</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Legacy_Execution_Engine">13.4. Legacy Execution Engine</a></li>
+<li><a href="execution.html#sec:Design">13.5. Design</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#sec:Usage_Outside_N4JSIDE">13.5.1. Usage Outside N4JSIDE</a>
+<ul class="sectlevel4">
+<li><a href="execution.html#sec:Use_Node_with_Maven">13.5.1.1. Use Node with Maven</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Usage_Inside_N4JSIDE">13.5.2. Usage Inside N4JSIDE</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Runtime_Injection">13.6. Runtime Injection</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#sec:Running_String_Code">13.6.1. Running String Code</a></li>
+<li><a href="execution.html#sec:Running_File_Code">13.6.2. Running File Code</a></li>
+<li><a href="execution.html#sec:Injection_Code_Example">13.6.3. Injection Code Example</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#_tests">14. Tests</a>
+<ul class="sectlevel2">
+<li><a href="tests.html#sec:Performance_Tests">14.1. Performance Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Synthetic_Performance_Tests">14.1.1. Synthetic Performance Tests</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:Design_of_Generator">14.1.1.1. Design of Generator</a></li>
+<li><a href="tests.html#sec:Design_of_Performance_Test_Execution">14.1.1.2. Design of Performance Test Configuration and Execution</a></li>
+<li><a href="tests.html#sec:JUnit_Configuration">14.1.1.3. JUnit Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Test_Configuration">14.1.1.4. JUnitBenchmark Test Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Report_Configuration">14.1.1.5. JUnitBenchmark Report Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Run_Configuration">14.1.1.6. JUnitBenchmark Run Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Example">14.1.1.7. JUnitBenchmark Example</a></li>
+<li><a href="tests.html#sec:Note_on_Jenkins_Job">14.1.1.8. Note on Jenkins Job</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#sec:ECMA_Tests">14.2. ECMA Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Grammar_Tests">14.2.1. Grammar Tests</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:Negative_Tests">14.2.1.1. Negative Tests</a></li>
+<li><a href="tests.html#sec:Test_Exclusion">14.2.1.2. Test Exclusion</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Integration_Tests">14.3. Integration Tests</a></li>
+<li><a href="tests.html#sec:Test_Helpers">14.4. Test Helpers</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Parameterized_N4JS_Tests">14.4.1. Parameterized N4JS tests</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:ParameterizedXtextRunner">14.4.1.1. ParameterizedXtextRunner</a></li>
+<li><a href="tests.html#sec:TestCodeProvider">14.4.1.2. TestCodeProvider</a></li>
+<li><a href="tests.html#sec:Example_Of_Parameterized_Parser_Test">14.4.1.3. Example of parameterized parser test</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Issue_Suppression">14.5. Issue Suppression</a></li>
+<li><a href="tests.html#sec:Xpect_Tests">14.6. Xpect Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Xpect_Test_Setup">14.6.1. Xpect Test Setup</a></li>
+<li><a href="tests.html#sec:Xpect_Issue_Suppression">14.6.2. Xpect Issue Suppression</a></li>
+<li><a href="tests.html#sec:Xpect_Provided_Test_Methods">14.6.3. Xpect Provided Test Methods</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#errors">14.6.3.1. errors</a></li>
+<li><a href="tests.html#warnings">14.6.3.2. warnings</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:N4JS_Specific_Xpect_Test_Methods">14.6.4. N4JS Specific Xpect Test Methods</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:XPECT_noerrors">14.6.4.1. noerrors and nowarnings</a></li>
+<li><a href="tests.html#sec:XPECT_scope">14.6.4.2. scope</a></li>
+<li><a href="tests.html#sec:XPECT_scopeWithPosition">14.6.4.3. scopeWithPosition</a></li>
+<li><a href="tests.html#sec:XPECT_scopeWithResource">14.6.4.4. scopeWithResource</a></li>
+<li><a href="tests.html#sec:XPECT_binding">14.6.4.5. binding</a></li>
+<li><a href="tests.html#sec:XPECT_linkedPathname">14.6.4.6. linkedPathname</a></li>
+<li><a href="tests.html#sec:XPECT_type_of">14.6.4.7. type of</a></li>
+<li><a href="tests.html#sec:XPECT_expectedType">14.6.4.8. expectedType</a></li>
+<li><a href="tests.html#sec:XPECT_elementKeyword">14.6.4.9. elementKeyword</a></li>
+<li><a href="tests.html#sec:XPECT_accessModifier">14.6.4.10. accessModifier</a></li>
+<li><a href="tests.html#sec:XPECT_compileResult">14.6.4.11. compileResult</a></li>
+<li><a href="tests.html#sec:XPECT_output">14.6.4.12. output</a></li>
+<li><a href="tests.html#sec:XPECT_outputRegEx">14.6.4.13. outputRegEx</a></li>
+<li><a href="tests.html#sec:XPECT_calculatedAccessModifier">14.6.4.14. calculatedAccessModifier</a></li>
+<li><a href="tests.html#sec:XPECT_spec">14.6.4.15. spec</a></li>
+<li><a href="tests.html#sec:XPECT_deadCode">14.6.4.16. deadCode</a></li>
+<li><a href="tests.html#sec:XPECT_returnOrThrows">14.6.4.17. returnOrThrows</a></li>
+<li><a href="tests.html#sec:XPECT_lint">14.6.4.18. lint</a></li>
+<li><a href="tests.html#sec:XPECT_lintFails">14.6.4.19. lintFails</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:FIXME_Xpect_modifier">14.6.5. FIXME Xpect modifier</a></li>
+<li><a href="tests.html#sec:Expectmatrix_Xpect_Test_Methods">14.6.6. Expectmatrix Xpect tests</a></li>
+<li><a href="tests.html#xpect-lint-tests">14.6.7. Xpect Lint Tests</a></li>
+</ul>
+</li>
+<li><a href="tests.html#xpect-proposal-tests">14.7. Xpect Proposal Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Validation_vs__Non_Validation">14.7.1. Validation vs. Non-Validation</a></li>
+<li><a href="tests.html#sec:General_Proposal_Test_Features">14.7.2. General Proposal Test Features</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:Test_Variables">14.7.2.1. Test Variables</a></li>
+<li><a href="tests.html#sec:Location_and_Selection">14.7.2.2. at – Location and Selection</a></li>
+<li><a href="tests.html#sec:Multi_Line_Expectations_in_Proposal_Tests">14.7.2.3. Multi Line Expectations in Proposal Tests</a></li>
+<li><a href="tests.html#sec:Timeout">14.7.2.4. Timeout and Performance</a></li>
+</ul>
+</li>
+<li><a href="tests.html#proposals-verify-existence-of-proposals">14.7.3. proposals – Verify Existence of Proposals</a></li>
+<li><a href="tests.html#sec:Verify_displayed_string">14.7.4. display – Verify displayed string</a></li>
+<li><a href="tests.html#sec:Apply_Proposal">14.7.5. apply – Apply Proposal</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#resource-application-in-other-files">14.7.5.1. resource – application in other files</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Content_Assist_Cycling">14.7.6. kind – Content Assist Cycling</a></li>
+<li><a href="tests.html#fileValidVerify-validation-status">14.7.7. fileValid – Verify validation status</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Apply_Proposal_And_Execute_Tests">14.8. Apply Proposal And Execute Tests</a></li>
+<li><a href="tests.html#sec:Organize_Imports_Test">14.9. Organize Imports Test</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#organizeimports">14.9.1. organizeImports</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Access_Control_Test">14.10. Access Control Test</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#test-scenarios">14.10.1. Test Scenarios</a></li>
+<li><a href="tests.html#n4js-code-generator">14.10.2. N4JS Code Generator</a></li>
+<li><a href="tests.html#xtext-issue-matcher">14.10.3. Xtext Issue Matcher</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Smoke_Tests">14.11. Smoke Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#how-to-handle-smoke-test-errors">14.11.1. How to handle smoke test errors?</a></li>
+<li><a href="tests.html#smoketester-and-exceptionanalyzer">14.11.2. SmokeTester and ExceptionAnalyzer</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:UI_Tests_with_SWTBot">14.12. UI Tests with SWTBot</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#writing-swtbot-tests">14.12.1. Writing SWTBot Tests</a></li>
+<li><a href="tests.html#running-swtbot-tests">14.12.2. Running SWTBot Tests</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Debugging_UI_Tests">14.13. Debugging UI Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Connecting_to_the_X_server_on_the_build_node">14.13.1. Connecting to the X-server on the build-node</a></li>
+<li><a href="tests.html#sec:Tools_to_investigate_the_java_stack">14.13.2. Tools to investigate the java-stack</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="ui_concepts.html#_ui-concepts">15. UI Concepts</a>
+<ul class="sectlevel2">
+<li><a href="ui_concepts.html#sec:User_Interface_Concepts">15.1. User Interface Concepts</a>
+<ul class="sectlevel3">
+<li><a href="ui_concepts.html#sec:Eclipse_UI_Concepts">15.1.1. Eclipse UI Concepts</a>
+<ul class="sectlevel4">
+<li><a href="ui_concepts.html#sec:Label_Provider">15.1.1.1. Label Provider</a></li>
+<li><a href="ui_concepts.html#sec:Markers">15.1.1.2. Markers</a></li>
+<li><a href="ui_concepts.html#sec:Commands__Toolbar_and_Menus">15.1.1.3. Commands, Toolbar and Menus</a></li>
+<li><a href="ui_concepts.html#sec:Content_Assist">15.1.1.4. Content Assist</a></li>
+<li><a href="ui_concepts.html#sec:Quick_Fixes">15.1.1.5. Quick Fixes</a></li>
+<li><a href="ui_concepts.html#sec:Quick_Assist">15.1.1.6. Quick Assist</a></li>
+<li><a href="ui_concepts.html#sec:Clean_Up_Actions">15.1.1.7. Clean Up Actions</a></li>
+<li><a href="ui_concepts.html#sec:Save_Actions">15.1.1.8. Save Actions</a></li>
+<li><a href="ui_concepts.html#sec:Auto_Edit">15.1.1.9. Auto Edit</a></li>
+<li><a href="ui_concepts.html#sec:Template_Proposals">15.1.1.10. Template Proposals</a></li>
+<li><a href="ui_concepts.html#sec:Outline_View___Quick_Outline">15.1.1.11. Outline View / Quick Outline</a></li>
+<li><a href="ui_concepts.html#sec:Navigator__Package_Explorer__Project_Explorer">15.1.1.12. Navigator, Package Explorer, Project Explorer</a></li>
+<li><a href="ui_concepts.html#sec:Hyperlinking_and_Navigation">15.1.1.13. Hyperlinking and Navigation</a></li>
+<li><a href="ui_concepts.html#sec:Syntax_and_Semantic_Coloring">15.1.1.14. Syntax and Semantic Coloring</a></li>
+<li><a href="ui_concepts.html#sec:Code_Formatter">15.1.1.15. Code Formatter</a></li>
+<li><a href="ui_concepts.html#sec:Wizards">15.1.1.16. Wizards</a></li>
+<li><a href="ui_concepts.html#sec:Cheat_Sheets">15.1.1.17. Cheat Sheets</a></li>
+<li><a href="ui_concepts.html#sec:Context_sensitive_Help">15.1.1.18. Context-sensitive Help</a></li>
+<li><a href="ui_concepts.html#sec:Hovers">15.1.1.19. Hovers</a></li>
+<li><a href="ui_concepts.html#sec:Folding">15.1.1.20. Folding</a></li>
+<li><a href="ui_concepts.html#sec:Customizable_validation___severity">15.1.1.21. Customizable validation / severity</a></li>
+<li><a href="ui_concepts.html#sec:Proposals">15.1.1.22. Proposals</a></li>
+</ul>
+</li>
+<li><a href="ui_concepts.html#sec:Non_Eclipse_UI_Concepts">15.1.2. Non-Eclipse UI Concepts</a>
+<ul class="sectlevel4">
+<li><a href="ui_concepts.html#sec:Overlays">15.1.2.1. Overlays</a></li>
+<li><a href="ui_concepts.html#sec:Goto__Inferred__Type">15.1.2.2. Goto (Inferred) Type</a></li>
+<li><a href="ui_concepts.html#sec:Postfix_Completion">15.1.2.3. Postfix Completion</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="ui_concepts.html#_user-interface-resources">15.2. User Interface Resources</a>
+<ul class="sectlevel3">
+<li><a href="ui_concepts.html#_icons">15.2.1. Icons</a>
+<ul class="sectlevel4">
+<li><a href="ui_concepts.html#_eclipse-platform-icons">15.2.1.1. Eclipse Platform Icons</a></li>
+<li><a href="ui_concepts.html#_n4js-specific-icons">15.2.1.2. N4JS Specific Icons</a></li>
+<li><a href="ui_concepts.html#_high-resolution-icons">15.2.1.3. High Resolution Icons</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="formatting.html#_formatting">16. Formatting</a>
+<ul class="sectlevel2">
+<li><a href="formatting.html#sec:FmtObjective">16.1. Objective</a>
+<ul class="sectlevel3">
+<li><a href="formatting.html#sec:FmtFormatting_Comments">16.1.1. Formatting Comments</a></li>
+</ul>
+</li>
+<li><a href="formatting.html#sec:FmtArchitecture">16.2. Architecture</a>
+<ul class="sectlevel3">
+<li><a href="formatting.html#sec:Implementation_example">16.2.1. Implementation example</a></li>
+</ul>
+</li>
+<li><a href="formatting.html#sec:FmtFormatter_Implementation_Guidelines">16.3. Formatter Implementation Guidelines</a></li>
+<li><a href="formatting.html#sec:FmtConfiguration">16.4. Configuration</a></li>
+<li><a href="formatting.html#sec:FmtUI_Integration">16.5. UI Integration</a></li>
+<li><a href="formatting.html#sec:FmtUnit_Testing_with_Xpect">16.6. Unit Testing with Xpect</a></li>
+</ul>
+</li>
+<li><a href="external_libraries.html#_external-libraries">17. External Libraries</a>
+<ul class="sectlevel2">
+<li><a href="external_libraries.html#sec:Major_Components">17.1. Major Components</a>
+<ul class="sectlevel3">
+<li><a href="external_libraries.html#subsec:External_Resources">17.1.1. External Resources</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Workspace">17.1.2. External Library Workspace</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Preference_Store">17.1.3. External Library Preference Store</a></li>
+<li><a href="external_libraries.html#subsec:npm_Manager">17.1.4. Library Manager</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Builder_Helper">17.1.5. External Library Builder</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Xtext_Index_Persister">17.1.6. External Library Xtext Index Persister</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Preference_Page">17.1.7. External Library Preference Page</a></li>
+</ul>
+</li>
+<li><a href="external_libraries.html#sec:Headless_External_Library_Support">17.2. Headless External Library Support</a>
+<ul class="sectlevel3">
+<li><a href="external_libraries.html#_custom-npm-settings">17.2.1. Custom npm settings</a></li>
+</ul>
+</li>
+<li><a href="external_libraries.html#sec:lmFutureWork">17.3. Future Work</a>
+<ul class="sectlevel3">
+<li><a href="external_libraries.html#subsec:lmMultipleDependencyScope">17.3.1. Multiple Dependency Scope</a></li>
+<li><a href="external_libraries.html#subsec:lmRunTestsFromLibrary">17.3.2. Run Tests from TestLibrary</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="json_support.html#sec:JSON_Support">18. JSON Support</a>
+<ul class="sectlevel2">
+<li><a href="json_support.html#sec:JSON_Parser">18.1. JSON Parser</a>
+<ul class="sectlevel3">
+<li><a href="json_support.html#sec:JSON_Parser_Unicode_Escaping">18.1.1. Escaping Unicode Control Characters in String Literals</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Empty_Text">18.1.2. Empty Text</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Nested_Structures">18.1.3. Nested Structures</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Whitespace">18.1.4. Whitespace</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Comments">18.1.5. Comments</a></li>
+</ul>
+</li>
+<li><a href="json_support.html#sec:JSON_Language_Extensions">18.2. JSON Language Extensions</a>
+<ul class="sectlevel3">
+<li><a href="json_support.html#sec:JSON_Validator_Extensions">18.2.1. JSON Validator Extensions</a>
+<ul class="sectlevel4">
+<li><a href="json_support.html#sec:File_Specitic_Validator_Extensions">18.2.1.1. File-Specific Validator Extensions</a></li>
+<li><a href="json_support.html#sec:JSON_Declarative_JSON_Validator_Extensions">18.2.1.2. Declarative JSON Validator Extensions</a></li>
+</ul>
+</li>
+<li><a href="json_support.html#_json-resource-description-strategy">18.2.2. JSON Resource Description Strategy</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_jsdoc">19. JSDoc</a>
+<ul class="sectlevel2">
+<li><a href="jsdoc.html#sec:Design_Rationale">19.1. Design Rationale</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#_general-design">19.1.1. General Design</a></li>
+<li><a href="jsdoc.html#sec:Type_Expressions">19.1.2. Type Expressions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="docexporter.html#_docexporter">20. DocExporter</a>
+<ul class="sectlevel2">
+<li><a href="docexporter.html#sec:Specification_Exporter">20.1. Specification Exporter</a></li>
+</ul>
+</li>
+<li><a href="rename_refactoring.html#_rename-refactoring">21. Rename Refactoring</a>
+<ul class="sectlevel2">
+<li><a href="rename_refactoring.html#_rename-refactoring-ui-interaction">21.1. Rename Refactoring UI interaction</a></li>
+<li><a href="rename_refactoring.html#_renameelementprocessor-interaction">21.2. RenameElementProcessor interaction</a></li>
+</ul>
+</li>
+<li><a href="flow_graphs.html#chap:flowgraphs">22. Flow Graphs</a>
+<ul class="sectlevel2">
+<li><a href="flow_graphs.html#sec:flowgraphs_overview">22.1. Flow graphs overview</a>
+<ul class="sectlevel3">
+<li><a href="flow_graphs.html#_internal-graph">22.1.1. Internal graph</a></li>
+<li><a href="flow_graphs.html#_optimizations">22.1.2. Optimizations</a></li>
+<li><a href="flow_graphs.html#_api-for-client-analyses">22.1.3. API for client analyses</a>
+<ul class="sectlevel4">
+<li><a href="flow_graphs.html#_mapping-from-internal-to-ast-elements">22.1.3.1. Mapping from internal to AST elements</a></li>
+<li><a href="flow_graphs.html#_graph-visitor">22.1.3.2. Graph visitor</a></li>
+<li><a href="flow_graphs.html#_graph-explorer">22.1.3.3. Graph explorer</a></li>
+<li><a href="flow_graphs.html#_branch-walker">22.1.3.4. Branch walker</a></li>
+<li><a href="flow_graphs.html#_example-1-compute-string-for-each-path">22.1.3.5. Example 1: Compute string for each path</a></li>
+<li><a href="flow_graphs.html#_path-quantor">22.1.3.6. Path quantor</a></li>
+</ul>
+</li>
+<li><a href="flow_graphs.html#_control-flow-analyses">22.1.4. Control flow analyses</a>
+<ul class="sectlevel4">
+<li><a href="flow_graphs.html#_dead-code-analysis">22.1.4.1. Dead code analysis</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="flow_graphs.html#sec:dataflow">22.2. Dataflow</a>
+<ul class="sectlevel3">
+<li><a href="flow_graphs.html#_dataflow-graph">22.2.1. Dataflow graph</a></li>
+<li><a href="flow_graphs.html#_dataflow-analyses">22.2.2. Dataflow analyses</a>
+<ul class="sectlevel4">
+<li><a href="flow_graphs.html#_def-def-def-nothing-analysis">22.2.2.1. Def&#8594;Def / Def&#8594;Nothing analysis</a></li>
+<li><a href="flow_graphs.html#_def-use-decl-analysis">22.2.2.2. Def|Use&#8592;Decl analysis</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="publish_npms.html#sec:publish-npms-to-public">23. Publish npms</a>
+<ul class="sectlevel2">
+<li><a href="publish_npms.html#sec:publish-npms-n4js-maven">23.1. Publish n4js-libs to during  maven build</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Hints">Appendix A: Hints</a>
+<ul class="sectlevel2">
+<li><a href="appendix_a_hints.html#sec:XtextInjection">A.1. Xtext Injection</a>
+<ul class="sectlevel3">
+<li><a href="appendix_a_hints.html#sec:DI_MultipleInjectors_Singletons">A.1.1. Multiple Injectors and Singletons</a>
+<ul class="sectlevel4">
+<li><a href="appendix_a_hints.html#sec:DI_avoid_duplicate_singletons">A.1.1.1. Avoiding duplicate singletons</a>
+<ul class="sectlevel5">
+<li><a href="appendix_a_hints.html#sec:DI_binding_in_shared">A.1.1.1.1. Defining binding in the shared injector</a></li>
+<li><a href="appendix_a_hints.html#sec:DI_binding_in_custom">A.1.1.1.2. Defining binding in the custom injector</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:DI_Hints">A.1.2. Dependency Injection Hints</a>
+<ul class="sectlevel4">
+<li><a href="appendix_a_hints.html#sec:DI_custom_bundle">A.1.2.1. Use DI in custom bundle, use DI with extensions</a>
+<ul class="sectlevel5">
+<li><a href="appendix_a_hints.html#sec:DI_custom_bundle_problem">A.1.2.1.1. Problem</a></li>
+<li><a href="appendix_a_hints.html#sec:DI_custom_bundle_solution">A.1.2.1.2. Solution</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Access_Other_DSL_Injector">A.1.2.2. How do I get the Guice Injector of my language?</a>
+<ul class="sectlevel5">
+<li><a href="appendix_a_hints.html#sec:DSL_Injector_UI_context">A.1.2.2.1. UI context</a></li>
+<li><a href="appendix_a_hints.html#sec:DSL_Injector_Non_UI_context">A.1.2.2.2. Non UI context but with injection context</a></li>
+<li><a href="appendix_a_hints.html#sec:DSL_Injector_Non_UI_non_injection_context">A.1.2.2.3. Non UI context without injection context</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Cancel_Indicator">A.1.2.3. How do I get cancel indicators in different contexts?</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Eclipse">A.2. Eclipse</a>
+<ul class="sectlevel3">
+<li><a href="appendix_a_hints.html#sec:Show_Xtext_Index">A.2.1. Show the current Xtext index</a></li>
+<li><a href="appendix_a_hints.html#sec:Plugin_spy">A.2.2. Plug-in spy</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Maven-hints">A.3. Maven</a>
+<ul class="sectlevel3">
+<li><a href="appendix_a_hints.html#how-to-check-for-maven-mojo-updates">A.3.1. How to check for Maven MOJO updates</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#_module-loading">Appendix B: Module Loading</a>
+<ul class="sectlevel2">
+<li><a href="appendix_b_module_loading.html#sec:Dependency_Management">B.1. Dependency Management</a></li>
+<li><a href="appendix_b_module_loading.html#ecmascript-modules">B.2. ECMAScript Modules</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:ES5_Modules_Systems">B.2.1. ES5 Modules Systems</a></li>
+<li><a href="appendix_b_module_loading.html#sec:ES6_Modules">B.2.2. ES6 Modules</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:ECMAScript_Module_Loaders">B.3. ECMAScript Module Loaders</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:ES6_Module_Loaders">B.3.1. ES6 Module Loaders</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Polyfills_for_ES6_Module_Loaders">B.3.2. Polyfills for ES6 Module Loaders</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:es6_module_loader">B.3.2.1. es6-module-loader</a></li>
+<li><a href="appendix_b_module_loading.html#sec:SystemJS">B.3.2.2. SystemJS</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Demo">B.3.2.3. Demo</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#case-study-typescript">B.4. Case Study : TypeScript</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:ES6_Modules_Support">B.4.1. ES6 Modules Support</a></li>
+<li><a href="appendix_b_module_loading.html#sec:TypeScript_and_Module_Loading">B.4.2. TypeScript and Module Loading</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Cyclic_Dependencies">B.5. Cyclic Dependencies</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:Setup">B.5.1. Setup</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Transpile_and_Execute">B.5.2. Transpile and Execute</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Module_Format___AMD">B.5.2.1. Module Format = AMD</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Module_Format___CommonJS">B.5.2.2. Module Format = CommonJS</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Module_Format___SystemJS">B.5.2.3. Module Format = SystemJS</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Conclusion">B.5.3. Conclusion</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#system.register-as-transpilation-target">B.6. System.register as transpilation target</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:Introduction">B.6.1. Introduction</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:External_Transpilers">B.6.1.1. External Transpilers</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Example_of_a_System_register_module">B.6.1.2. Example of a System.register module</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Structure_of_a_System_register_module">B.6.2. Structure of a System.register module</a></li>
+<li><a href="appendix_b_module_loading.html#_transpilation-hints">B.6.3. Transpilation Hints</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Handling_Imports">B.6.3.1. Handling Imports</a></li>
+<li><a href="appendix_b_module_loading.html#sec:__exportFn__">B.6.3.2. &lt;&lt;exportFn&gt;&gt;</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Handling_Exports">B.6.3.3. Handling Exports</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Examples_w__Circular_Dependencies">B.6.4. Examples w/ Circular Dependencies</a></li>
+<li><a href="appendix_b_module_loading.html#sec:N4JS_Examples_w__Circular_Dependencies">B.6.5. N4JS Examples w/ Circular Dependencies</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Unresolved_Cyclic_Dependencies">B.6.5.1. Unresolved Cyclic Dependencies</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Variables___Functions">B.6.5.2. Examples with Variables &amp; Functions</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Classes">B.6.5.3. Examples with Classes</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Examples_with_SubClassing">B.6.5.4. Examples with SubClassing</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Miscellaneous">B.6.5.5. Miscellaneous</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#_resources">B.6.6. Resources</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:CommonJS_as_transpilation_target">B.7. CommonJS as transpilation target</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#_introduction-2">B.7.1. Introduction</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Transpilation_Hints">B.7.2. Transpilation Hints</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Import_Statements">B.7.2.1. Import Statements</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Export_Statements">B.7.2.2. Export Statements</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Tracking_Live_Bindings">B.7.2.3. Tracking Live Bindings</a></li>
+<li><a href="appendix_b_module_loading.html#sec:A_complete_example">B.7.2.4. A complete example</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#_resources-2">B.7.3. Resources</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_c_license.html#sec:License">Appendix C: License</a></li>
+<li><a href="appendix_d_acronyms.html#sec:Acronyms">Appendix D: Acronyms</a></li>
+<li><a href="appendix_e_bibliography_and_footnotes.html#_bibliography-and-footnotes">Appendix E: Bibliography and Footnotes</a></li>
+</ul>
+</div>
+</div>
+<div id="content"><div class="sect1">
+<h2 id="_compilation"><a class="anchor" href="#_compilation"></a><a class="link" href="#_compilation">12. Compilation</a></h2>
+<div class="sectionbody">
+<div class="admonitionblock warning">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-warning" title=""></i>
+</td>
+<td class="content">
+This chapter may be outdated.
+</td>
+</tr>
+</table>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="chap:compilation"><a class="anchor" href="#chap:compilation"></a><a class="link" href="#chap:compilation">12.1. Introduction</a></h3>
+<div class="paragraph">
+<p>Compilation is the process of transforming some source code written by means of a human readable text into a machine readable target file, i.e. bytecode or assembler. However, in the context of N4JS, the target output is not machine code but another high-level programming language. This kind of compiler transforming from one programming language to another is called <em>transpiler</em>, as a combination of <code>transformation</code> and <code>compiler</code>. The design of the transpiler takes this special setup into account.</p>
+</div>
+<div class="sect3">
+<h4 id="sec:general_design_rationals"><a class="anchor" href="#sec:general_design_rationals"></a><a class="link" href="#sec:general_design_rationals">12.1.1. General design rationals</a></h4>
+<div class="sect4">
+<h5 id="sec:logging_and_error_reporting"><a class="anchor" href="#sec:logging_and_error_reporting"></a><a class="link" href="#sec:logging_and_error_reporting">12.1.1.1. Logging and error reporting</a></h5>
+<div class="paragraph">
+<p>The generator always expects to get a valid model as an input. So all syntactic and semantic errors (not warnings) in the N4JS code as well as regarding the project configuration, e.g. in the package.json file, should be already discovered in the validation step. So any error marker on the resource will prevent the compiler to run.</p>
+</div>
+<div class="paragraph">
+<p>In case of other errors arising in the generator, the error handling is done as follows:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>either throw an <code>GeneratorException</code> or better call <code>ExceptionHandler.handleError(message)</code> (that then will throw this exception)</p>
+</li>
+<li>
+<p>beside the message also the file and the current line can be passed to <code>GeneratorException</code></p>
+</li>
+<li>
+<p><code>GeneratorException</code> (as extending RuntimeException) will be handled by the generator caller</p>
+<div class="ulist">
+<ul>
+<li>
+<p>in UI: <code>BuildInstruction</code> will create an error log entry</p>
+</li>
+<li>
+<p>headless: lets the <code>GeneratorException</code> fail</p>
+</li>
+</ul>
+</div>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:progress_monitor"><a class="anchor" href="#sec:progress_monitor"></a><a class="link" href="#sec:progress_monitor">12.1.1.2. Progress monitor</a></h5>
+<div class="paragraph">
+<p>The compiler works on a single file and we do not expect that to take much time. Processors working on many files, such as linkers (in the JavaScript context, that is minification and concatenation), are different components.</p>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Xtext_Integration"><a class="anchor" href="#sec:Xtext_Integration"></a><a class="link" href="#sec:Xtext_Integration">12.1.2. Xtext Integration</a></h4>
+<div class="sect4">
+<h5 id="sec:xtext_default_behaviour"><a class="anchor" href="#sec:xtext_default_behaviour"></a><a class="link" href="#sec:xtext_default_behaviour">12.1.2.1. Xtext default behaviour</a></h5>
+<div class="paragraph">
+<p>The Xtext builder participant calculates the delta for every change in the project and triggers dirty state handling as well as code generation. By default the builder participant expects exactly one implementation bound to the IGenerator interface and thus only one output configuration provider belonging to this generator.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:n4js_requirements"><a class="anchor" href="#sec:n4js_requirements"></a><a class="link" href="#sec:n4js_requirements">12.1.2.2. N4JS requirements</a></h5>
+<div class="paragraph">
+<p>In constrast to the default Xtext behaviour in the N4JS IDE allows</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>the registration / discovery of multiple generators (including compilers and transpilers) but even no compiler at all, so that it is possible to ship the IDE also without any generators</p>
+</li>
+<li>
+<p>to configure these generators separately (output paths and so on) workspace globally but also project specific (currently it is only required to enable / disable a compiler)</p>
+</li>
+<li>
+<p>to enable / disable generators, but it is allowed to enable more than one compiler at one</p>
+</li>
+<li>
+<p>to start compilers headless, i.e. e.g in automated build / JUnit tests but with the possibility to configure them there as well</p>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:compiler_discovery_in_ui"><a class="anchor" href="#sec:compiler_discovery_in_ui"></a><a class="link" href="#sec:compiler_discovery_in_ui">12.1.2.3. Compiler discovery in UI</a></h5>
+<div class="ulist">
+<ul>
+<li>
+<p>There is a singleton <code>ICompositeGenerator</code>. The <code>ICompositeGenerator</code> instance itself doesn’t contain generator logic but knows subgenerators (that implement <code>ISubGenerator</code>) to which it delegates the input file (so instead of registering a new builder participant (that then would have to recalculate the delta) only the generator call is extracted)</p>
+</li>
+<li>
+<p>In the UI case, the actual execution of the registered generator is done in <code>BuildInstruction</code> where every N4JS resource contained in the delta calculated by the builder participant is an <code>ICompositeGenerator</code> implementation.</p>
+</li>
+<li>
+<p><a href="#fig:cd_GeneratorAndBuilderParticipant">Builder (UI) and Generator (Core)</a> summarizes the implementation of this compiler infrastructure in the UI case.</p>
+</li>
+</ul>
+</div>
+<div id="fig:cd_GeneratorAndBuilderParticipant" class="imageblock center">
+<div class="content">
+<img src="chapters/13_compilation/images/cd_GeneratorAndBuilderParticipant.svg" alt="cd GeneratorAndBuilderParticipant">
+</div>
+<div class="title">Figure 25. Builder (UI) and Generator (Core)</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:compiler_discovery_in_headless"><a class="anchor" href="#sec:compiler_discovery_in_headless"></a><a class="link" href="#sec:compiler_discovery_in_headless">12.1.2.4. Compiler discovery in headless</a></h5>
+<div class="ulist">
+<ul>
+<li>
+<p><code>N4JSHeadlessStandaloneSetup</code> is used to combine <code>N4JSRuntimeModule</code> and <code>N4JSHeadlessGeneratorModule</code> so there is <code>PropertiesFileBasedValuesProvider</code> is bind as implementation for <code>IPreferenceValuesProvider</code></p>
+</li>
+<li>
+<p>via <code>N4JSHeadlessStandaloneSetup</code> the injector is created which is used to create an instance of <code>ICompositeGenerator</code></p>
+</li>
+<li>
+<p>in the headless mode the subgenerators of are manually registered via an extension point in the class <code>HeadlessExtensionRegistrationHelper</code>.</p>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:general_generator_implementation"><a class="anchor" href="#sec:general_generator_implementation"></a><a class="link" href="#sec:general_generator_implementation">12.1.2.5. General generator implementation</a></h5>
+<div class="exampleblock">
+<div class="title">Example 1. Simple IGenerator</div>
+<div class="content">
+<div class="paragraph">
+<p>The following snippet shows a minimal generator example.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">public class Generator implements IGenerator {
+    @Override public void doGenerate(Resource resource, IFileSystemAccess fsa) {
+        final String filename = computeTargetFileName(resource.getURI());
+
+        Script script = IterableExtensions.&lt;Script&gt; head(
+            Iterables.&lt;Script&gt; filter(resource.getContents(), Script.class));
+
+        fsa.generateFile(filename, doCompileToString(script));
+    }
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Generation is triggered for each Xtext resource. <code>IFileSystemAccess</code> is an abstraction of where to write the generated artefacts. This enables using the generator in the IDE (with a workspace) and headless (directly operating on files). In tests you can use <code>InMemoryFileAccess</code>, in standalone mode you should use <code>JavaFileSystemAccess</code> and in Eclipse mode <code>EclipseFileSystemAccess2</code></p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:general_generator_activation"><a class="anchor" href="#sec:general_generator_activation"></a><a class="link" href="#sec:general_generator_activation">12.1.2.6. General generator activation</a></h5>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Programmatically
+</td>
+<td class="hdlist2">
+<p>Invoke the <code>IComposedGenerator.doGenerate</code> with a loaded N4JS resource and a configured <code>IFileSystemAccess</code> implementation.</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Xtext Builder
+</td>
+<td class="hdlist2">
+<p>This is available by default when using the bound <code>IGenerator</code>, it runs on every change of your N4JS resource when automatic build is enabled in the workspace.</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Context Menu
+</td>
+<td class="hdlist2">
+<p>see <a href="christiandietrich.wordpress.com/2011/10/15/xtext-calling-the-generator-from-a-context-menu/">Christian Dietrich’s Blog 2011/10/15</a></p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+MWE2 Workflow
+</td>
+<td class="hdlist2">
+<p>via <code>org.eclipse.xtext.generator.GeneratorComponent</code> that is configured with the standalone setup of the N4JS language. Such an MWE2 workflow also requires the <code>org.eclipse.xtext.mwe.Reader</code> component to first load the N4JS resources to transform in a model slot that is then consumed by the GeneratorComponent</p>
+</td>
+</tr>
+</table>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Overview_of_Input_Models"><a class="anchor" href="#sec:Overview_of_Input_Models"></a><a class="link" href="#sec:Overview_of_Input_Models">12.1.3. Overview of the Input Models</a></h4>
+<div class="paragraph">
+<p>The input is a simple instance of <code>Script</code>, which is the root model element for all N4JS files. Actually, it is the root of the AST. For the AST elements, other elements stemming from other models are accessible as well. The following models may be important for the compiler:</p>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+N4JS AST
+</td>
+<td class="hdlist2">
+<p>The abstract syntax tree is an EMF model, it is defined in a single Xcore file <code>N4JS.xcore</code></p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Parser or Node Model
+</td>
+<td class="hdlist2">
+<p>The parser tree, also called node model, is defined by Xtext. It contains offset information, holding whitespaces, line breaks, comments as well as other hidden tokens. It can be accessed via <code>NodelModelUtils</code>, that is a node can be retrieved for a given AST element and vice versa. There are three different kind of nodes: root, composite and leaf node.<br>
+<strong>As of Dec 2015, the transpiler does no longer make use of the parse tree!</strong></p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Type Model
+</td>
+<td class="hdlist2">
+<p>The type model is an abstract view on the N4JS AST. It is defined in a single Xcore file <code>Types.xcore</code>. Not all AST elements are related to type model information. This is only true for subtypes of <code>TypeDefiningElement</code>, with references to <code>Type</code> or containing a <code>TypeRef</code>.</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+N4 Project
+</td>
+<td class="hdlist2">
+<p>via <code>OutputPathHelper</code> located in <code>org.eclipse.n4js.generator</code> wraps the calculation of compiled file path.</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Grammar Model
+</td>
+<td class="hdlist2">
+<p>Grammar Model created from <code>N4JS.xtext</code>, the rules can be access in the Java code via <code>N4JSGrammarAccess</code>. The grammar elements can be retrieved from the parser model vial <code>node.getGrammarElement()</code>. <code>org.eclipse.xtext.GrammarUtil</code> also contains some useful helper methods.<br>
+<strong>As of Dec 2015, the transpiler does no longer make use of the grammar model!</strong></p>
+</td>
+</tr>
+</table>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:Core_Generator"><a class="anchor" href="#sec:Core_Generator"></a><a class="link" href="#sec:Core_Generator">12.2. Generators</a></h3>
+<div class="paragraph">
+<p>Generators are an abstraction above that of transpilers. N4JS transpilers are implemented as specific generators, but there might be other generators that are not transpilers (e.g. generator that produces HTML documentation from the jsdoc in the N4JS source files).</p>
+</div>
+<div class="sect3">
+<h4 id="sec:Compiler_Components"><a class="anchor" href="#sec:Compiler_Components"></a><a class="link" href="#sec:Compiler_Components">12.2.1. Generator Components</a></h4>
+<div class="paragraph">
+<p><a href="#fig:comp_compilers">Compiler Components</a> gives an overview over the compiler related components. Some of these components are described in detail in the following sections.
+As of Dec 2017, the generator architecture has been refactored and simplified.</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>There is only a single <code>ICompositeGenerator</code> instance. Since the single instance should simply delegate to subgenerators, composite generators can no longer be registered via extension point.</p>
+</li>
+<li>
+<p>Most of generator related code is moved into <code>org.eclipse.n4js</code> bundle. This is needed because we need to bind <code>ICompositeGenerator</code> to a concrete implementation in the <code>org.eclipse.n4js</code> bundle and the extension point for <code>ICompositeGenerator</code> has been removed.</p>
+</li>
+<li>
+<p>An extension point <code>org.eclipse.n4js.generator.subgenerator</code> is introduced in the <code>org.eclipse.n4js</code> bundle. This makes it possible to register a new subgenerator via extension point.</p>
+</li>
+</ul>
+</div>
+<div id="fig:comp_compilers" class="imageblock center">
+<div class="content">
+<img src="chapters/13_compilation/images/comp_compilers.svg" alt="comp compilers">
+</div>
+<div class="title">Figure 26. Compiler Components</div>
+</div>
+<div class="paragraph">
+<p><a href="#fig:od_generatorInjection">Discovering generators and provide them with Guice bindings.</a> shows how composite generator and subgenerators interact with other components both in the UI and in the headless case.</p>
+</div>
+<div id="fig:od_generatorInjection" class="imageblock center">
+<div class="content">
+<img src="chapters/13_compilation/images/od_generatorInjection.svg" alt="od generatorInjection">
+</div>
+<div class="title">Figure 27. Discovering generators and provide them with Guice bindings.</div>
+</div>
+<div class="paragraph">
+<p>As we can see in the diagram above. In the UI case, <code>N4JSBuilderParticipant</code> creates <code>BuildInstruction</code> which in turn delegates the generation logics to an instance of <code>ICompositeGenerator</code>. The <code>ICompositeGenerator</code> simply delegates the generation logics to subgenerators .</p>
+</div>
+<div class="paragraph">
+<p>In the headless mode, <code>n4jscBase.doMain</code> creates an instance of <code>N4JSStandaloneSetup</code> and obtains the injector from there. This injector is then used to create an instance of <code>ICompositeGenerator</code> in <code>N4HeadlessCompiler</code>.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Generator_architecture"><a class="anchor" href="#sec:Generator_architecture"></a><a class="link" href="#sec:Generator_architecture">12.2.2. Generator architecture</a></h4>
+<div class="paragraph">
+<p>The compiler has to create different compilation targets, e.g., for web applications running in a browser (Chrome), or for applications running on iOS using the JavaScriptCore framework <sup class="footnote">[<a id="_footnoteref_13" class="footnote" href="appendix_e_bibliography_and_footnotes.html#_footnote_13" title="View footnote.">13</a>]</sup>. Other scenarios may include code created for debugging purposes vs. optimized code, although this may be implementable via configuration switches as well.</p>
+</div>
+<div class="paragraph">
+<p><a href="#fig:cd_SubGenerators">Generator and sub-generators</a> shows the main generator classes, including two sub generators for EcmaScript code and EcmaScript on iOS.</p>
+</div>
+<div id="fig:cd_SubGenerators" class="imageblock center">
+<div class="content">
+<img src="chapters/13_compilation/images/cd_SubGenerators.svg" alt="cd SubGenerators">
+</div>
+<div class="title">Figure 28. Generator and sub-generators</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Unified_Compiler_Configuration"><a class="anchor" href="#sec:Unified_Compiler_Configuration"></a><a class="link" href="#sec:Unified_Compiler_Configuration">12.2.3. Unified Compiler Configuration</a></h4>
+<div class="paragraph">
+<p>Since the compiler is to be used in both UI and headless (or CLI) mode, the configuration has to abstract from Eclipse <code>IPreferenceStore</code> concept or CLI utility classes. This is done with the combination of <code>CompilerDescriptor</code> and <code>CompilerProperties</code>, used by all <code>ISubGenerator</code> implementations (see <a href="#fig:cd_SubGenerators">Fig. Sub Generators</a>).</p>
+</div>
+<div class="paragraph">
+<p>Each compiler provides</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>a unique name (that have to match with the name of the output configuration)</p>
+</li>
+<li>
+<p>a default compiler descriptor that contains the preference values to be applied when nothing else been configured in the provided preference values</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>A <code>CompilerDescriptor</code> has</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>an identifier (this is the unique name of the compiler as mentioned before)</p>
+</li>
+<li>
+<p>a name (a readable name to used in Eclipse preference page)</p>
+</li>
+<li>
+<p>a description (not used yet, but maybe later also shown in the preference page)</p>
+</li>
+<li>
+<p>a flag, that indicates, if this generator should run by default</p>
+</li>
+<li>
+<p>the file extension to be used for the compiled file</p>
+</li>
+<li>
+<p>the <code>OutputConfiguration</code> object from Xtext that contains output related preferences like the output folder</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>The <code>CompilerProperties</code> is an enumeration that makes it easier to iterate over the preferences and getting / setting the preference values in a generic way. So this enumeration contains all configurable properties as literals.</p>
+</div>
+<div class="paragraph">
+<p>The keys for preferences have to follow a fixed pattern as it also used internally by the builder participant when applying the configurations from the <code>OutputConfiguration</code>. So the key consists of</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>’outlet’</p>
+</li>
+<li>
+<p>unique name of the compiler = unique name of the output configuration</p>
+</li>
+<li>
+<p>the name of the property</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Example: outlet.es5.compiledFileExtension</p>
+</div>
+<div class="paragraph">
+<p><code>N4JSPreferenceAccess</code> encapsulates the access to the injected <code>IPreferenceValuesProvider</code>. This values provider is bound in UI to <code>EclipsePreferencesProvider</code> that creates an overlay over the default configuration and makes it so possible to have workspace global as well as project specific preferences and always as fall back the default values.</p>
+</div>
+<div class="paragraph">
+<p>In headless mode the <code>PropertiesFileBasedValuesProvider</code> is bound as implementation of <code>IPreferenceValuesProvider</code>. With this implementation it is possible to load the preferences from a provided properties file.</p>
+</div>
+<div class="paragraph">
+<p><code>N4JSPreferenceAccess</code> is used in <code>AbstractSubGenerator</code> which provided the most common used preferences as extra methods.</p>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:Transpilers"><a class="anchor" href="#sec:Transpilers"></a><a class="link" href="#sec:Transpilers">12.3. Transpilers</a></h3>
+<div class="paragraph">
+<p>Transpilers are a special case of generators, used for transforming N4JS source code into some target code in some other, high-level programming language. In this section we describe the general transpiler infrastructure without considering any particular transpiler. Currently, there is only a single such concrete transpiler for ECMAScript target code, explained later in <a href="#sec:N4JS_to_EcmaScript_Transpiler">N4JS-to-EcmaScript Transpiler</a>.</p>
+</div>
+<div class="paragraph">
+<p>All code of the general transpiler infrastructure is found in bundle <code>org.eclipse.n4js.transpiler</code>.</p>
+</div>
+<div class="sect3">
+<h4 id="sec:Phases"><a class="anchor" href="#sec:Phases"></a><a class="link" href="#sec:Phases">12.3.1. Overview</a></h4>
+<div class="paragraph">
+<p><a href="#fig:ad_PipelineOverview">Overview of the compilation pipeline</a> shows an overview of the steps during transpilation of a single resource:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>an initial conversion from the original AST to an <strong>intermediate model (IM)</strong>, called <strong>preparation step</strong>.</p>
+</li>
+<li>
+<p>one or more <strong>transformation</strong> phases, each taking as input the IM and performing a number of in-place modification on it.</p>
+</li>
+<li>
+<p>a final <strong>pretty printing step</strong> that transform the final version of the IM into the textual output, i.e. the target code.</p>
+</li>
+</ol>
+</div>
+<div id="fig:ad_PipelineOverview" class="imageblock center">
+<div class="content">
+<img src="chapters/13_compilation/images/ad_PipelineOverview.svg" alt="ad PipelineOverview">
+</div>
+<div class="title">Figure 29. Overview of the compilation pipeline</div>
+</div>
+<div class="paragraph">
+<p>The IM is the most important data structure in the transpiler. It starts out as a 1-to-1 copy of the original AST and is then gradually transformed by the AST transformation steps into, ultimately, a representation of the output code. Only the IM undergoes updates, while the original AST remains unchanged. Nodes in the IM that are identical on N4JS source code and target code side can simply be left unchanged. Traceability links allow navigating back to an original AST node from a given IM node, but due to the gradual modification of the IM this might not be possible for all IM nodes (the tracer will return <code>null</code> in those cases.</p>
+</div>
+<div class="paragraph">
+<p>Ideally, each transformation executed during the transformation step should be self-contained and coupling should be reduced to a minimum. Of course, this is not possible in all cases, in practice. Therefore, a simple mechanism is provided for statically specifying dependencies between transformations by way of Java annotations (see Java class <code>TransformationDependency</code> for more details). The ECMAScript transpiler, for example, has 18 individual transformations (at time of writing).</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="relation-between-ast-and-im"><a class="anchor" href="#relation-between-ast-and-im"></a><a class="link" href="#relation-between-ast-and-im">12.3.2. Relation between AST and IM</a></h4>
+<div class="paragraph">
+<p>The relation between the original AST and the IM is maintained by the tracer, see class <code>Tracer</code>, which is available via the transpiler state. The tracer allows to obtain a  IM elements for a given original AST node and, conversely,  original AST nodes for a given IM element (i.e. a 1:N association between original AST node and IM element).</p>
+</div>
+<div class="paragraph">
+<p>The main purpose of this tracing information is to compute source maps for the target code.</p>
+</div>
+<div class="paragraph">
+<p>At the beginning of the transformation step, there is a 1-to-1 correspondence between AST and IM, but over the course of the transformations this correspondence will become more and more blurred. Therefore, whenever using the tracer to get to the original AST from a given IM element , we have to consider the case that there is not original AST node defined for  (because  was created programmatically by an earlier transformation) OR that the original AST node is of a different kind than  (because, maybe, an original N4JS class declaration was replaced by a function declaration by an earlier transformation).</p>
+</div>
+<div class="paragraph">
+<p>Whenever a transformation changes the IM, it is responsible to update the tracer, accordingly.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="implementation-overview"><a class="anchor" href="#implementation-overview"></a><a class="link" href="#implementation-overview">12.3.3. Implementation Overview</a></h4>
+<div class="paragraph">
+<p><a href="#fig:transpilerClassDgr">Transpiler Class Diagram</a> shows a class diagram of the main constituents of the transpiler infrastructure.</p>
+</div>
+<div id="fig:transpilerClassDgr" class="imageblock center">
+<div class="content">
+<img src="chapters/13_compilation/images/TranspilerClassDgr.svg" alt="TranspilerClassDgr">
+</div>
+<div class="title">Figure 30. Class diagram for the transpiler infrastructure.</div>
+</div>
+<div class="paragraph">
+<p>The <code>AbstractTranspiler</code> controls the overall workflow shown earlier in . Concrete subclasses of <code>Transformation</code> perform the actual transformations (the preparation and pretty-printing steps are not shown in the above class diagram). Concrete transformations are created via injection within concrete sub classes of <code>AbstractTranspiler</code> (see class <code>EcmaScriptTranspiler</code> for an example). All information required during transpilation is kept in a simple data class called <code>TranspilerState</code>; a single instance of this class is created during the preparation step and is passed along until transpilation of the resource to transpile is completed.</p>
+</div>
+<div class="paragraph">
+<p>Class <code>Transformation</code> has a super class <code>TranspilerComponent</code> that has two important responsibilities:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>it contains many utility methods that are easily accessible from within concrete transformations through inheritance.</p>
+</li>
+<li>
+<p>it obtains the transpiler state via injection (using the scoping feature of Google Guice, for more details see <code>org.eclipse.n4js.utils.di.scopes.ScopeManager</code> and <code>TransformationScoped</code>). This injection is done in super class <code>TranspilerComponent</code>, so when implementing a new transformation, the programmer does not have to deal with these details and can simply obtain the transpiler state via the inherited method <code>TranspilerComponent#getState()</code>.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Code shared across concrete transformations should be placed in sub classes of <code>TransformationAssistant</code>. Those assistants are similar to the helpers used elsewhere, but by sharing the <code>TranspilerComponent</code> super class they get all the utility methods provided by that class and they automatically get the transpiler state.</p>
+</div>
+<div class="paragraph">
+<p>For more implementation details see the code and javadoc; a good starting point for investigating the overall workflow are classes <code>AbstractTranspiler</code> and <code>Transformation</code>.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Guidelines_for_Implementing_Transformations"><a class="anchor" href="#sec:Guidelines_for_Implementing_Transformations"></a><a class="link" href="#sec:Guidelines_for_Implementing_Transformations">12.3.4. Guidelines for Implementing Transformations</a></h4>
+<div class="paragraph">
+<p>Some hints:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>if you need to create an entirely new transformation:</p>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>create new sub class of <code>Transformation</code> (use Xtend).</p>
+</li>
+<li>
+<p>in the main class of the transpiler you are working with (probably <code>EcmaScriptTranspiler</code>), change method
+<code>#computeTransformationsToBeExecuted()</code> to return an instance of your new transformation. The instance should be created using a Guice provider (see <code>EcmaScriptTranspiler</code> for an example). Note that this method also defines the order of transformations!</p>
+</li>
+<li>
+<p>implement the <code>#transform()</code> method of your newly created transformation.</p>
+</li>
+<li>
+<p>consider adding pre and post conditions via methods <code>#assertPreConditions()</code> and <code>#assertPostConditions()</code> (throw an AssertionError if failed).</p>
+</li>
+<li>
+<p>consider declaring dependencies to other transformations using the annotations defined in class <code>TransformationDependency</code>.</p>
+</li>
+</ol>
+</div>
+</li>
+<li>
+<p>code shared across transformations should be placed in a new or existing sub class of <code>TransformationAssistant</code> and then this assistant should be injected into the transformations that require this code’s functionality.</p>
+</li>
+<li>
+<p>inside a transformation or transformation assistant:</p>
+<div class="ulist">
+<ul>
+<li>
+<p>to modify the IM, use the utility methods inherited from <code>TranspilerComponent</code> (e.g. <code>#replace()</code>, <code>#insertBefore()</code>); try to avoid direct manipulation of the IM as far as possible (but sometimes it’s necessary).</p>
+</li>
+<li>
+<p>to create new IM elements, use the convenience methods in <code>TranspilerBuilderBlocks</code>; use static import.</p>
+</li>
+<li>
+<p>to create a new symbol table entry or to obtain an existing symbol table entry for a given original target or element in the IM, use the inherited utility methods <code>TranspilerComponent#getSymbolTableEntry*()</code>.<br>
+<strong>Never search or modify the symbol table directly!</strong></p>
+</li>
+<li>
+<p>to access the transpiler state <sup class="footnote">[<a id="_footnoteref_14" class="footnote" href="appendix_e_bibliography_and_footnotes.html#_footnote_14" title="View footnote.">14</a>]</sup>, use inherited method <code>TranspilerComponent#getState()</code> (by convention, in Xtend you should just write <code>state</code> as if it were a field).</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>for local testing, activate additional consistency checks between transformations and assertion of pre/post conditions via these boolean flags:<br>
+<code>AbstractTranspiler#DEBUG_PERFORM_VALIDATIONS</code>,<br>
+<code>AbstractTranspiler#DEBUG_PERFORM_ASSERTIONS</code>.</p>
+</li>
+<li>
+<p>never add one of the following replaced EMF entities to the IM:<br>
+<code>Script</code>,<br>
+<code>IdentifierRef</code>,<br>
+<code>ParameterizedTypeRef</code>,<br>
+<code>ParameterizedTypeRefStructural</code>,<br>
+<code>ParameterizedPropertyAccessExpression</code>.<br>
+Instead, use the replacement entities from <code>IM.xcore</code> that have the <code>_IM</code> suffix (e.g. <code>IdentifierRef_IM</code>). If you always use <code>TranspilerBuilderBlocks</code> as described above, you won’t run into this issue.</p>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect3">
+<h4 id="symbol-table-in-the-im"><a class="anchor" href="#symbol-table-in-the-im"></a><a class="link" href="#symbol-table-in-the-im">12.3.5. Symbol Table in the IM</a></h4>
+<div class="paragraph">
+<p>During the preparation step, the IM is created as an exact copy of the original AST in most cases. However, to make sure the IM is self-contained and does not have any cross-references to the original AST or the original TModule and to simplify certain computations within the transformations, some AST entities are modified. For this purpose, there is a small EMF model called <code>IM.xcore</code>. It extends the AST model <code>n4js.xcore</code> and adds some elements.</p>
+</div>
+<div class="paragraph">
+<p>Most importantly, a symbol table is created and all references of the original AST pointing to an IdentifiableElement (either in the original AST or in the TModule) are rewired to a reference to an entry in the symbol table. Those entries are of type <code>SymbolTableEntry</code> and occur in three special forms (there is a dedicated sub class for each case). Detailed information is provided in the javadoc of <code>SymbolTableEntry</code> and its sub classes and is not repeated here to avoid duplication.</p>
+</div>
+<div class="paragraph">
+<p>The following entity replacements are done while creating the IM from the original AST and the entities without <code>_IM</code> must <strong>never</strong> appear in the IM:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>Script</code>  <code>Script_IM</code></p>
+</li>
+<li>
+<p><code>IdentifierRef</code>  <code>IdentifierRef_IM</code></p>
+</li>
+<li>
+<p><code>ParameterizedTypeRef</code>  <code>ParameterizedTypeRef_IM</code></p>
+</li>
+<li>
+<p><code>ParameterizedTypeRefStructural</code>  <code>ParameterizedTypeRefStructural_IM</code></p>
+</li>
+<li>
+<p><code>ParameterizedPropertyAccessExpression</code>  <code>ParameterizedPropertyAccessExpression_IM</code></p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>For example, when having in the original AST an <code>IdentifierRef</code> pointing to identifiable element , then the IM will contain an <code>IdentifierRef_IM</code> pointing to a <code>SymbolTableEntryOriginal</code> with a property <code>originalTarget</code> pointing to .</p>
+</div>
+<div class="paragraph">
+<p>Figures <a href="#fig:rewire_var">Rewire Var</a>, <a href="#fig:rewire_class">Rewire Class</a>, and <a href="#fig:rewire_import">Rewire Import</a> show a comparison between an original AST with its original TModule and the self-contained intermediate model for a number of concrete examples.</p>
+</div>
+<div class="exampleblock">
+<div class="title">Example 2. Intermediate Models for References to Variables</div>
+<div class="content">
+<div class="paragraph">
+<p>Original AST + TModule</p>
+</div>
+<div id="fig:rewire_var" class="imageblock center">
+<div class="content">
+<img src="chapters/13_compilation/images/Rewire_var_pre.png" alt="Rewire var pre">
+</div>
+<div class="title">Figure 31. Intermediate Model for References to Variables</div>
+</div>
+<div class="paragraph">
+<p>Intermediate model (IM)</p>
+</div>
+<div id="fig:rewire_var-post" class="imageblock center">
+<div class="content">
+<img src="chapters/13_compilation/images/Rewire_var_post.png" alt="Rewire var post">
+</div>
+<div class="title">Figure 32. Intermediate Model for References to Variables (post)</div>
+</div>
+</div>
+</div>
+<div class="exampleblock">
+<div class="title">Example 3. Intermediate Model for References to Classes</div>
+<div class="content">
+<div class="paragraph">
+<p>original AST + TModule</p>
+</div>
+<div id="fig:rewire_class" class="imageblock center">
+<div class="content">
+<img src="chapters/13_compilation/images/Rewire_class_pre.png" alt="Rewire class pre">
+</div>
+<div class="title">Figure 33. Intermediate Model for References to Classes</div>
+</div>
+<div class="paragraph">
+<p>Intermediate model (IM)</p>
+</div>
+<div id="fig:rewire_class-post" class="imageblock center">
+<div class="content">
+<img src="chapters/13_compilation/images/Rewire_class_post.png" alt="Rewire class post">
+</div>
+<div class="title">Figure 34. Intermediate Model for References to Classes (post)</div>
+</div>
+</div>
+</div>
+<div class="exampleblock">
+<div class="title">Example 4. Intermediate Model for References to Imported Classes</div>
+<div class="content">
+<div class="paragraph">
+<p>Original AST + TModule</p>
+</div>
+<div id="fig:rewire_import" class="imageblock center">
+<div class="content">
+<img src="chapters/13_compilation/images/Rewire_import_pre.png" alt="Rewire import pre">
+</div>
+<div class="title">Figure 35. Intermediate Model for References to Imported Classes</div>
+</div>
+<div class="paragraph">
+<p>Intermediate model (IM)</p>
+</div>
+<div id="fig:rewire_import-post" class="imageblock center">
+<div class="content">
+<img src="chapters/13_compilation/images/Rewire_import_post.png" alt="Rewire import post">
+</div>
+<div class="title">Figure 36. Intermediate Model for References to Imported Classes (post)</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:N4JS_to_EcmaScript_Transpiler"><a class="anchor" href="#sec:N4JS_to_EcmaScript_Transpiler"></a><a class="link" href="#sec:N4JS_to_EcmaScript_Transpiler">12.4. N4JS-to-EcmaScript Transpiler</a></h3>
+<div class="sect3">
+<h4 id="sec:Overview_of_Transformations"><a class="anchor" href="#sec:Overview_of_Transformations"></a><a class="link" href="#sec:Overview_of_Transformations">12.4.1. Overview of Transformations</a></h4>
+<div class="paragraph">
+<p>The following overview will soon be outdated. Therefore:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>to find out which transformations are actually being executed and in what precise order, it is best to directly look into method:<br>
+<code>EcmaScriptTranspiler#computeTransformationsToBeExecuted()</code>.</p>
+</li>
+<li>
+<p>to learn about dependencies between transformations, check the annotations of the transformation class to see if one of the dependency annotations defined in <code>TransformationDependency</code> are given there (though probably not all dependencies will be specified in that form).</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>The following table lists all transformation by class name in the order they are executed by the <code>EcmaScriptTranspiler</code>.</p>
+</div>
+<table class="tableblock frame-all grid-all spread">
+<colgroup>
+<col style="width: 50%;">
+<col style="width: 50%;">
+</colgroup>
+<tbody>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">StaticPolyfillTransformation</p></td>
+<td class="tableblock halign-left valign-top"></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">MemberPatchingTransformation</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">see <a href="#sec:Transpiling_members">Transpiling Members</a></p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">ApiImplStubGenerationTransformation</p></td>
+<td class="tableblock halign-left valign-top"></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">DestructuringTransformation</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">turn destructuring patterns into ES5 code</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">SuperLiteralTransformation</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">super call + super access</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">ExpressionTransformation</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">casts, <code>instanceof</code>, <code>@Promisify</code>, &#8230;&#8203;</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">DependencyInjectionTransformation</p></td>
+<td class="tableblock halign-left valign-top"></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">ClassDeclarationTransformation</p></td>
+<td class="tableblock halign-left valign-top"></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">InterfaceDeclarationTransformation</p></td>
+<td class="tableblock halign-left valign-top"></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">EnumDeclarationTransformation</p></td>
+<td class="tableblock halign-left valign-top"></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">FunctionDeclarationTransformation</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">turn declared function into variable declaration + function expression</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">ArrowFunction_Part1_Transformation</p></td>
+<td class="tableblock halign-left valign-top"></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">BlockTransformation</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">local arguments variable, <code>await</code></p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">FormalParameterTransformation</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">variadic arguments</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">ArrowFunction_Part2_Transformation</p></td>
+<td class="tableblock halign-left valign-top"></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">TrimTransformation</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">remove TypeRefs and TypeVariables</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">SanitizeImportsTransformation</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">remove unused imports + add missing imports</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">ModuleWrappingTransformation</p></td>
+<td class="tableblock halign-left valign-top"></td>
+</tr>
+</tbody>
+</table>
+<div class="paragraph">
+<p>The main complexity lies in the three transformations for N4JS type declarations (classes, interfaces, enums) and the related three transformations for member handling at the beginning (static polyfills, member patching, API/Impl stub generation) and the module wrapping. Up to the double horizontal line, the IM is still rather close to N4JS (e.g. still contains <code>N4ClassDeclaration</code>s with <code>N4MemberDeclaration</code>s), but after that it rapidly departs from the structure of the original AST (e.g. class declarations are broken up into a function declaration and a $<code>makeClass</code> call, field accessors and methods become function expressions in the properties of an object literal, fields are handled differently).</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Transpiling_members"><a class="anchor" href="#sec:Transpiling_members"></a><a class="link" href="#sec:Transpiling_members">12.4.2. Transpiling members</a></h4>
+<div class="paragraph">
+<p>When processing the members of a container type, in the standard case, the transpiler simply has to generate target code for each owned member. For inherited members no output code has to be generated, because the ordinary semantics of the Javascript prototype chain is used in the generated code.</p>
+</div>
+<div class="paragraph">
+<p>There are, however, special cases when output code has to be generated for a non-owned or non-existant member of a container type:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>partial shadowing caused by lone field accessors, [sec:Transpiling_members__Partial_shadowing_of_getter_setter_pairs]<br>
+( <strong>delegation</strong>)</p>
+</li>
+<li>
+<p>consumption of members of an interface within an implementing class, [sec:Transpiling_members__Consuming_or_inheriting_members_of_an_interface]<br>
+( <strong>delegation</strong>, for data fields: <strong>copying</strong>)</p>
+</li>
+<li>
+<p>inheritance of members of an interface within an extending interface, [sec:Transpiling_members__Consuming_or_inheriting_members_of_an_interface]<br>
+( <strong>delegation</strong>, for data fields: <strong>copying</strong>)</p>
+</li>
+<li>
+<p>mixing in members into a container type via static polyfill, [sec:Transpiling_members__Static_polyfill]<br>
+( <strong>copying</strong>)</p>
+</li>
+<li>
+<p>adding an API / implementation stub, [sec:Transpiling_members__API_implementation_stubs]<br>
+( <strong>creation</strong>)</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>The above overview also states what technique is used in each special case of member handling: <strong>delegation</strong>, <strong>copying</strong> or <strong>creation</strong>. Delegation is the most tricky one and means that not a new function is generated in the output code for the special member, but the existing member function of an existing member is obtained from somewhere in the prototype chain and used directly as the member function of the special member. <strong>Copying</strong> means that an existing member is copied to another location where the special handling is required as if it were defined in that place. Lastly, <strong>creation</strong> means that an entirely new member is created for which no existing member serves as a template and this member gets a body with some <code>default</code> behavior. These three techniques of special member handling are explained in more detail in <a href="#sec:Transpiling_members__Delegating_members">Techniques for special member handling</a>.</p>
+</div>
+<div class="sect4">
+<h5 id="sec:Transpiling_members__Delegating_members"><a class="anchor" href="#sec:Transpiling_members__Delegating_members"></a><a class="link" href="#sec:Transpiling_members__Delegating_members">12.4.2.1. Techniques for special member handling</a></h5>
+<div class="paragraph">
+<p>If output code has to be generated for a non-owned member  of a classifier  we distinguish the following two cases:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>either some other member  owned by classifier  serves as a template for ,</p>
+</li>
+<li>
+<p>or no such template exists.</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>In the first case, we can either <strong>copy</strong>  in the sense that we will generate output code for  within the output code for  as if  had been defined in . Or we can use <strong>delegation</strong>, i.e. generate output code for  that reuses the existing member function of  in . In case no template exists, we always have to <strong>create</strong>  from scratch, i.e. generate output code as if  had been defined with some behavior pre-defined by the N4JS language (this applies only to API / implementation stubs where this pre-defined behaviour is to throw an <code>unimplemented member</code> error).</p>
+</div>
+<div class="paragraph">
+<p>Creation and copying is straightforward; for more details on member delegation see class <code>DelegationAssistant</code> and entity <code>DelegatingMember</code> in <code>IM.xcore</code>. The basic approach is to allow one transformation to create a <code>DelegatingMember</code> and insert it into the IM and let the transformations for class and interface declarations turn this member into low-level Javascript constructs that perform the actual delegation.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Transpiling_members__Partial_shadowing_of_getter_setter_pairs"><a class="anchor" href="#sec:Transpiling_members__Partial_shadowing_of_getter_setter_pairs"></a><a class="link" href="#sec:Transpiling_members__Partial_shadowing_of_getter_setter_pairs">12.4.2.2. Partial shadowing</a></h5>
+<div class="paragraph">
+<p>In Javascript, if an object  has a setter of name , then a read access <code>obj.prop</code> will return undefined, even if the prototype of  has a getter or field of name . Conversely, if  has a getter , then a write access <code>obj.prop = 42</code> will produce a runtime error, even if the prototype of  has a setter or field .</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>var proto = {
+  get prop1() { return "this won't show up" },
+  set prop2(value) { console.log("this won't be reached") }
+}
+var obj = {
+  set prop1(value) {},
+  get prop2() {}
+}
+obj.__proto__ = proto;
+
+console.log(typeof obj.prop1);  // will print "undefined"
+obj.prop2 = 42;  // error: "setting a property that has only a getter"</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Note, in plain N4JS a validation enforces a redefinition of accessors or overriding of a field always by getter/setter pairs. However, in special situations of incomplete API implementations stubs for missing accessors are created in order to provide meaningful test-reporting. This leads to situations where on the implementation side a single getter or or a single setter is defined in a subclass - unaware of possibly injected stubs in superclasses. The aforementioned validation can not enforce the user to author an accessor pair. To keep a meaningful test-response the transpiler treats this situation as follows:</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Transpiling_members__Consuming_or_inheriting_members_of_an_interface"><a class="anchor" href="#sec:Transpiling_members__Consuming_or_inheriting_members_of_an_interface"></a><a class="link" href="#sec:Transpiling_members__Consuming_or_inheriting_members_of_an_interface">12.4.2.3. Consuming or inheriting members of an interface</a></h5>
+<div class="paragraph">
+<p>When an N4JS class  consumes the member of an interface implemented by , then this cannot be handled by the native prototype chain mechanism of Javascript. Instead, the transpiler has to generate a member of corresponding type that delegates to the consumed member. In case of data fields, such a delegation is not possible and thus the transpiler generates output code for the consumed data field as if the field had been defined in .</p>
+</div>
+<div class="paragraph">
+<p>Of particular importance in this context is the diamond problem when consuming members from an interface. For example, if interface  defined method  with a default implementation, interface  extends  and overrides  with a different implementation, class  implements  and class  extending  implements , then  will not consume  because it has already inherited  from its super class  (which in turn has consumed it from ). So, in  the default implementation of  given in  will be active, not that given in .</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Transpiling_members__Static_polyfill"><a class="anchor" href="#sec:Transpiling_members__Static_polyfill"></a><a class="link" href="#sec:Transpiling_members__Static_polyfill">12.4.2.4. Static polyfill</a></h5>
+<div class="paragraph">
+<p>See class <code>StaticPolyfillTransformation</code> for details.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Transpiling_members__API_implementation_stubs"><a class="anchor" href="#sec:Transpiling_members__API_implementation_stubs"></a><a class="link" href="#sec:Transpiling_members__API_implementation_stubs">12.4.2.5. API / implementation stubs</a></h5>
+<div class="paragraph">
+<p>See <a href="#sec:Support_for_incomplete_API_implementation_testing_in_the_N4JS_to_EcmaScript_5_Transpiler">Support for incomplete API implementation testing</a>.</p>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Support_for_incomplete_API_implementation_testing_in_the_N4JS_to_EcmaScript_5_Transpiler"><a class="anchor" href="#sec:Support_for_incomplete_API_implementation_testing_in_the_N4JS_to_EcmaScript_5_Transpiler"></a><a class="link" href="#sec:Support_for_incomplete_API_implementation_testing_in_the_N4JS_to_EcmaScript_5_Transpiler">12.4.3. Support for incomplete API implementation testing</a></h4>
+<div class="paragraph">
+<p>As part of the introduction of API projects with executable test cases the need to verify the state of implementations came into focus. No formal dependency is allowed between an API project and its dedicated implementation projects, hence an inconsistency can not directly be detected. However at runtime (c.f. <a href="execution.html#_execution">Execution</a>) the API is always replaced by an appropriate implementation.</p>
+</div>
+<div class="paragraph">
+<p>In cases where such an implementation is incomplete this would result in failures due to missing concepts, e.g. calls to methods that are not in place or usage of fields which are not defined. In order to support the author of an implementation the IDE provides a mean to compare the current state of implementation to the developer in a tabular way (c.f. [<a href="appendix_e_bibliography_and_footnotes.html#N4JSSpec">N4JSSpec</a>]).</p>
+</div>
+<div class="paragraph">
+<p>The key idea for automated test-support is to incorporate those comparison-results into the transpiled output in way, that a test-framework can easily distinguish wrong implementations from incomplete implementations. Of course this is not always possible, but the majority of cases can be handled.</p>
+</div>
+<div class="paragraph">
+<p>As there is only one transpilation mode the resulting modifications are always part of the generated code.</p>
+</div>
+<div class="paragraph">
+<p>In order to distinguish the different project-types we distinguish between different project types:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>an API-project (API)</p>
+</li>
+<li>
+<p>an API-implementation project (Impl)</p>
+</li>
+<li>
+<p>a client project (Client)</p>
+</li>
+<li>
+<p>a test project (Test)</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>The API-project defines the requirements to it’s implementors in form of definition-files (n4jsd). The API is defined together with an test-project which validates the implementation. Client code is written with a formal dependency to the API and uses the elements declared therein. In that sense an API-testing project is just a normal client project with a test-nature.</p>
+</div>
+<div class="paragraph">
+<p>Additional code to support API implementation testing is only inserted into the Impl-projects. API, Client and Test are not affected.</p>
+</div>
+<div class="paragraph">
+<p>One major goal in transpiling Impl projects is to provide the ability to load all modules used in Client/Test projects in non-disruptive way. Even if the implementation is missing elements the runtime should still be able to successfully load the module. Errors should only be signalled when the client code actually uses the missing concepts.</p>
+</div>
+<div class="sect4">
+<h5 id="sec:Modifications_in_Impl_projects"><a class="anchor" href="#sec:Modifications_in_Impl_projects"></a><a class="link" href="#sec:Modifications_in_Impl_projects">12.4.3.1. Modifications in Impl projects</a></h5>
+<div class="paragraph">
+<p>The generator is module driven. In case of missing modules nothing will be done but the runtime will detect this and act accordingly.</p>
+</div>
+<div class="paragraph">
+<p>In general only missing elements will be inserted:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Missing class - a stub will be generated</p>
+</li>
+<li>
+<p>Missing function - a stub will be generated</p>
+</li>
+<li>
+<p>Missing enumeration - a stub will be generated</p>
+</li>
+<li>
+<p>Missing interface - a stub will be generated</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Missing members of classes are inserted as stubs. Missing fields will be replaced by getter/setter-pairs throwing an error upon read and write access.</p>
+</div>
+<div class="paragraph">
+<p>A more sophisticated approach needs to be taken for interfaces with default implementations (marked with @ProvidesDefaultImplementation or @ProvidesInitializer).</p>
+</div>
+<div class="paragraph">
+<p>Currently missing field initialisers in interfaces are not detected for two reasons: Field-initialising is carried out on loading. Throwing an error in the initialiser will prevent the module from being loaded. Installing a getter/setter pair on the Impl-interface is not an option since the inheritance chain used in client project has no knowledge about this and therefore these accessors cannot be reached from client code.</p>
+</div>
+<div class="paragraph">
+<p>Missing default implementations will be inserted as stubs. For normal class compilation the inheritance chain needs to be scanned. In case of an missing default implementation in an implemented interface a forwarding call to the stub needs to be inserted on the class.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Implementation_of_stub_generation"><a class="anchor" href="#sec:Implementation_of_stub_generation"></a><a class="link" href="#sec:Implementation_of_stub_generation">12.4.3.2. Implementation of stub-generation</a></h5>
+<div class="paragraph">
+<p>The implementation is mainly organised in <code>ApiImplStubGenerationTransformation</code>, which makes use of <code>MissingApiMembersForTranspiler</code> and <code>ScriptApiTracker</code>.</p>
+</div>
+<div class="paragraph">
+<p>When a Module is transpiled the type of the project is checked. Only if the project is an implementation project the comparison between the current module and it’s API module is computed and attached as an Adapter to the <code>Script</code> during the life-cycle of the <code>ScriptTranspilerPolicy</code>. The <code>ProjectComparisonAdapter</code> serves as a shared information pool among the different transpiler-policies and caches different compare-results. After transpilation of the script the adapter will be removed.</p>
+</div>
+<div class="paragraph">
+<p>In order to reuse all existing code as far as possible, missing elements are modelled as subclasses of the requested element but with no AST-information. These subclasses are member-classes of the <code>ScriptApiTracker</code> class. All class-names are prefixed with <code>VirtualApi</code> and hold a reference to the type-information computed by the module-comparison.</p>
+</div>
+<div class="paragraph">
+<p>It is important to not access the AST-elements of type-information obtained from the project-comparison, since this would trigger the AST-loading and invalidate (proxifying) existing <code>EObjects</code>.</p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:n4jsc_Headless_Compiler_Interface"><a class="anchor" href="#sec:n4jsc_Headless_Compiler_Interface"></a><a class="link" href="#sec:n4jsc_Headless_Compiler_Interface">12.5. n4jsc Headless Compiler Interface</a></h3>
+<div class="paragraph">
+<p>The headless compiler interface consists of a runnable class capable of reading command line options packaged together with all required dependencies into one executable <code>.jar</code> archive.</p>
+</div>
+<div class="paragraph">
+<p>The sources of the command line interface are located in in the <code>tools/</code> subfolder of the main git repository. They comprise of the package <code>org.eclipse.n4js.hlc</code> and corresponding test package <code>org.eclipse.n4js.hlc.tests</code>. (c.f. <a href="#sec:tools">Tools</a>).</p>
+</div>
+<div class="paragraph">
+<p>A description of how to use the headless compiler can be found in the N4IDE document.</p>
+</div>
+<div class="sect3">
+<h4 id="sec:building_the_headless_compiler"><a class="anchor" href="#sec:building_the_headless_compiler"></a><a class="link" href="#sec:building_the_headless_compiler">12.5.1. building the headless compiler</a></h4>
+<div class="paragraph">
+<p>The maven-modules related to the headless compiler build are organised in the <code>tools</code> folder in the project-root. In order to build the headless compiler as part of the common build-chain, the maven-profile <code>buildTools</code> needs to be activated (off by default), e.g. <code>mvn -PbuildTools</code> .</p>
+</div>
+<div class="paragraph">
+<p>To build the headless compiler separately, the project-pom can be set to <code>tools/pom.xml</code>, however then the tycho-generated artefacts must be accessible by this build. This can be achieved in three different ways:</p>
+</div>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p>the build takes place on a workspace formerly building the n4js-project without cleaning it (interesting for local experiments),</p>
+</li>
+<li>
+<p>a former n4js-build installed the artefacts into the currently configured local-.m2-repository of maven or</p>
+</li>
+<li>
+<p>a former n4js-build deployed the artefacts to the configured nexus-server.</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>Note however, on our build-server option a) is not feasible, option b) requires you to setup a build-chain and ensuring the same build-node to be building on
+and c) is difficult up to nearly impossible without a proper versioning-scheme.</p>
+</div>
+<div class="paragraph">
+<p>Parameters for the headless-compiler-build are defined in the parent-pom located at <code>releng/org.eclipse.n4js.parent/pom.xml</code> with properties prefixed by <code>hlc.</code>.</p>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div id="footer">
+<div id="footer-text">
+Version 0.9<br>
+Last updated 2019-08-07 15:02:40 CEST
+</div>
+</div>
+<!-- ************* docinfo-footer *************************************************************** -->
+<div class="Grid social" style="color:#d5dfea">
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <h2>Quick Links</h2>
+    <ul>
+      <li><a href="../downloads.html">Download</a></li>
+      <li><a href="../userguides/index.html">Documentation</a></li>
+      <li><a href="https://github.com/eclipse/n4js/">Source</a></li>
+      <li><a href="https://github.com/eclipse/n4js/issues">Issues</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="https://www.eclipse.org/forums/index.php/f/365/">Forum</a></li>
+      <li><a href="http://n4js.blogspot.de/">Blog</a></li>
+      <li><a href="https://dev.eclipse.org/mailman/listinfo/n4js-dev">Mailing List</a></li>
+      <li><a href="https://projects.eclipse.org/projects/technology.n4js">Eclipse Project Page</a></li>
+      <li><a href="https://twitter.com/n4jsdev">Tweets by n4jsdev</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="http://www.eclipse.org/">Eclipse Home</a></li>
+      <li><a href="http://www.eclipse.org/legal/privacy.php">Privacy Policy</a></li>
+      <li><a href="http://www.eclipse.org/legal/termsofuse.php">Terms of Use</a></li>
+      <li><a href="http://www.eclipse.org/legal/copyright.php">Copyright Agent</a></li>
+      <li><a href="http://www.eclipse.org/legal/">Legal</a></li>
+    </ul>
+  </div>
+  <div style="clear: both; height: 0; overflow: hidden;"></div>
+</div>
+
+<!-- ************* UI Scripts ************* -->
+<script type="text/javascript" src="scripts/back-to-top.js"></script>
+
+<script type="text/javascript" src="scripts/treeview.js"></script>
+<script type="text/javascript" src="scripts/toc.js"></script>
+
+<!-- ************* Prism.js Syntax Highlighting ************* -->
+<script src="scripts/prism.js"></script>
+
+<script type="text/javascript">
+	// Add the 'toclist' id for search function
+	$(".toc2 > ul").attr('id', 'toclist');
+	// Generate a Search input form
+	$("#toclist > li:first-of-type").before('<input type="text" id="pagesearch" onkeyup="search()" placeholder="Search for section...">');
+	$("#toclist > li:first-of-type").before('<i id="clear" class="fa fa-times-circle-o"></i>');
+	$("#clear").click(function(){
+	    $("#pagesearch").val('');
+	    search();
+	    $('.toc2 > ul').treeView('collapseAll');
+	});
+	// intialize Treeview.js
+	$(".toc2 > ul").treeView();
+	// Initialize Scrollspy
+</script>
+<!-- ************* docinfo-footer *************************************************************** -->
+</body>
+</html>
\ No newline at end of file
diff --git a/design/docexporter.html b/design/docexporter.html
new file mode 100644
index 0000000..faa00c7
--- /dev/null
+++ b/design/docexporter.html
@@ -0,0 +1,981 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="generator" content="Asciidoctor 1.5.5">
+<meta name="author" content="2019-08-07 15:02:40 CEST">
+<title>N4JS Design Specification</title>
+<link rel="stylesheet" href="styles/spec.min.css">
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.6.3/css/font-awesome.min.css">
+<!-- ************* docinfo ******************************************************************* -->
+
+
+<!-- ************* Favicon ************-->
+<link rel="icon" href="images/favicon.ico" />
+
+<!-- ************* Back-to-top JQuery ************* -->
+<script src="https://code.jquery.com/jquery-1.12.4.js"></script>
+<script src="https://code.jquery.com/ui/1.12.0/jquery-ui.js"></script>
+
+
+<link href="styles/prism.min.css" rel="stylesheet" />
+<script type="text/javascript" async
+  src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2/MathJax.js?config=TeX-MML-AM_CHTML">
+</script>
+
+<!-- ************* Styles ************* -->
+<link rel="stylesheet" type="text/css" href="styles/n4jsspec-adoc.css">
+
+
+<!-- ****************** NavBar ****************** -->
+<div id="menubar">
+	<div class="banner">
+        <a href="https://www.eclipse.org/n4js/#"><img id="logo" src="images/n4js-logo.png" alt="Eclipse N4JS"></a>
+    </div>
+<ul>
+  <li><a href="index.html">Index</a></li>
+</ul>
+</div>
+<!-- ************* docinfo ******************************************************************* -->
+<style>
+      .admonitionblock td.icon .icon-todo:before{content:"\f249";color:#f4ee42}
+    </style>
+</head>
+<body class="book toc2 toc-left">
+<div id="header">
+<h1>N4JS Design Specification</h1>
+<div class="details">
+<span id="author" class="author">2019-08-07 15:02:40 CEST</span><br>
+<span id="revnumber">version 0.9</span>
+</div>
+<div id="toc" class="toc2">
+<div id="toctitle">Table of Contents</div>
+<ul class="sectlevel1">
+<li><a href="introduction.html#_introduction">1. Introduction</a>
+<ul class="sectlevel2">
+<li><a href="introduction.html#notation">1.1. Notation</a></li>
+<li><a href="introduction.html#sec:IDE_Overview">1.2. IDE Components</a>
+<ul class="sectlevel3">
+<li><a href="introduction.html#sec:Naming_Conventions">1.2.1. Naming Conventions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="eclipse_setup.html#_eclipse-setup">2. Eclipse Setup</a>
+<ul class="sectlevel2">
+<li><a href="eclipse_setup.html#_system-requirements">2.1. System Requirements</a></li>
+<li><a href="eclipse_setup.html#_contribute">2.2. Contribute</a>
+<ul class="sectlevel3">
+<li><a href="eclipse_setup.html#_eclipse-installer">2.2.1. Eclipse Installer</a>
+<ul class="sectlevel4">
+<li><a href="eclipse_setup.html#_changing-the-setup-script">2.2.1.1. Changing the Setup Script</a></li>
+</ul>
+</li>
+<li><a href="eclipse_setup.html#_manual-ide-configuration">2.2.2. Manual IDE Configuration</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="release_engineering.html#_release-engineering">3. Release Engineering</a>
+<ul class="sectlevel2">
+<li><a href="release_engineering.html#_nightly-build-on-eclipse-infrastructure">3.1. Nightly build on Eclipse infrastructure</a></li>
+<li><a href="release_engineering.html#_build-the-n4js-ide-from-command-line">3.2. Build the N4JS IDE from command line</a>
+<ul class="sectlevel3">
+<li><a href="release_engineering.html#_publish-maven-tooling-code-org-eclipse-n4js-releng-util-code">3.2.1. Publish maven-tooling <code>org.eclipse.n4js.releng.util</code></a></li>
+<li><a href="release_engineering.html#sec:test-verdaccio">3.2.2. Test Verdaccio containing n4js-libs</a></li>
+<li><a href="release_engineering.html#_generation-of-eclipse-help-for-spec-and-design-document">3.2.3. Generation of Eclipse help for spec and design document</a></li>
+</ul>
+</li>
+<li><a href="release_engineering.html#_updating-frameworks-and-dependencies">3.3. Updating frameworks and dependencies</a>
+<ul class="sectlevel3">
+<li><a href="release_engineering.html#_update-of-eclipse-emf-xtext-etc">3.3.1. Update of Eclipse, EMF, Xtext, etc.</a></li>
+<li><a href="release_engineering.html#_update-of-the-embedded-jre">3.3.2. Update of the embedded JRE</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tips_and_tricks.html#_tips-and-tricks">4. Tips and Tricks</a>
+<ul class="sectlevel2">
+<li><a href="tips_and_tricks.html#_naming">4.1. Naming</a></li>
+<li><a href="tips_and_tricks.html#_logging">4.2. Logging</a></li>
+<li><a href="tips_and_tricks.html#_cancellation-handling">4.3. Cancellation Handling</a></li>
+<li><a href="tips_and_tricks.html#_caching">4.4. Caching</a></li>
+<li><a href="tips_and_tricks.html#_dependency-injection">4.5. Dependency Injection</a></li>
+<li><a href="tips_and_tricks.html#_miscellaneous">4.6. Miscellaneous</a></li>
+</ul>
+</li>
+<li><a href="parser.html#_parser">5. Parser</a>
+<ul class="sectlevel2">
+<li><a href="parser.html#sec:Parser_Overview">5.1. Overview</a></li>
+<li><a href="parser.html#sec:N4JS_Parser">5.2. N4JS Parser</a></li>
+<li><a href="parser.html#sec:Parser_Generation_Post_Processing">5.3. Parser Generation Post-Processing</a>
+<ul class="sectlevel3">
+<li><a href="parser.html#sec:Automatic_Semicolon_Insertion">5.3.1. Automatic Semicolon Insertion</a>
+<ul class="sectlevel4">
+<li><a href="parser.html#sec:Injected_code_in_the_Antlr_grammar_file">5.3.1.1. Injected code in the Antlr grammar file</a></li>
+<li><a href="parser.html#sec:Customized_error_recovery">5.3.1.2. Customized error recovery</a></li>
+</ul>
+</li>
+<li><a href="parser.html#sec:_No_line_terminator_allowed_here__handling">5.3.2. Async and <code>No line terminator allowed here</code> Handling</a></li>
+<li><a href="parser.html#sec:Regular_Expression">5.3.3. Regular Expression</a></li>
+<li><a href="parser.html#sec:Unicode">5.3.4. Unicode</a></li>
+<li><a href="parser.html#sec:Literals">5.3.5. Literals</a></li>
+</ul>
+</li>
+<li><a href="parser.html#sec:Modifiers">5.4. Modifiers</a></li>
+<li><a href="parser.html#sec:Conflict_Resolutions">5.5. Conflict Resolutions</a>
+<ul class="sectlevel3">
+<li><a href="parser.html#sec:Reserved_Keywords_vs__Identifier_Names">5.5.1. Reserved Keywords vs. Identifier Names</a></li>
+<li><a href="parser.html#sec:Operators_and_Generics">5.5.2. Operators and Generics</a></li>
+</ul>
+</li>
+<li><a href="parser.html#sec:Content_Assist_Parser">5.6. Content-Assist Parser</a></li>
+</ul>
+</li>
+<li><a href="type_system.html#_type-system">6. Type System</a>
+<ul class="sectlevel2">
+<li><a href="type_system.html#sec:Type_Model_and_Grammar">6.1. Type Model and Grammar</a>
+<ul class="sectlevel3">
+<li><a href="type_system.html#sec:Type_Model_Overview">6.1.1. Type Model Overview</a></li>
+<li><a href="type_system.html#sec:Built_in_Types">6.1.2. Built-in and Primitive Types</a></li>
+<li><a href="type_system.html#sec:Type_Model_DSL">6.1.3. Type Model DSL</a></li>
+</ul>
+</li>
+<li><a href="type_system.html#sec:Type_System_Implementation">6.2. Type System Implementation</a></li>
+<li><a href="type_system.html#sec:Type_Inference_combined_with_AST_Traversal">6.3. Type Inference of AST</a>
+<ul class="sectlevel3">
+<li><a href="type_system.html#sec:Type_Inference_combined_with_AST_Traversal__Background">6.3.1. Background</a></li>
+<li><a href="type_system.html#sec:Triggering_Type_Inference_of_AST">6.3.2. Triggering</a></li>
+<li><a href="type_system.html#sec:Traversal_Order_During_Type_Inference_of_AST">6.3.3. Traversal Order</a></li>
+<li><a href="type_system.html#sec:Cross_References_During_Type_Inference_of_AST">6.3.4. Cross-References</a></li>
+<li><a href="type_system.html#sec:Function_Accessor_Bodies_During_Type_Inference_of_AST">6.3.5. Function/Accessor Bodies</a></li>
+<li><a href="type_system.html#sec:Poly_Expressions_During_Type_Inference_of_AST">6.3.6. Poly Expressions</a></li>
+<li><a href="type_system.html#sec:Constraint_Solver_used_During_Type_Inference_of_AST">6.3.7. Constraint Solver</a></li>
+<li><a href="type_system.html#sec:Type_Guards_During_Type_Inference_of_AST">6.3.8. Type Guards</a></li>
+</ul>
+</li>
+<li><a href="type_system.html#sec:Structural_Typing">6.4. Structural Typing</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#_type-index">7. Type Index</a>
+<ul class="sectlevel2">
+<li><a href="type_index.html#sec:Type_Index_Design_Rationale">7.1. Design Rationale</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#sec:Getting_the_Xtext_Index_Content_IResourceDescriptions">7.1.1. Getting the Xtext Index (<code>IResourceDescriptions</code>) Content</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#sec:Design_Overview">7.2. Design Overview</a></li>
+<li><a href="type_index.html#sec:N4JS_Resource_Load_States">7.3. N4JS Resource Load States</a></li>
+<li><a href="type_index.html#sec:Type_Builder">7.4. Types Builder</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#sec:Type_Inference_not_allowed_in_Type_Builder">7.4.1. Type Inference not allowed in Types Builder</a></li>
+<li><a href="type_index.html#sec:ComputedTypeReferences">7.4.2. Deferred Type References</a></li>
+<li><a href="type_index.html#sec:Use_cases_of_ComputedTypeRef">7.4.3. Use cases of DeferredTypeRef</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#sec:Incremental_Builder_Overview">7.5. Incremental Builder (Overview)</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#sec:Incremental_Builder_Overview__XtextBuilder">7.5.1. XtextBuilder</a></li>
+<li><a href="type_index.html#sec:Incremental_Builder_Overview__IBuilderState">7.5.2. IBuilderState</a>
+<ul class="sectlevel4">
+<li><a href="type_index.html#copy-and-update-xtext-index">7.5.2.1. Copy and Update Xtext Index</a></li>
+<li><a href="type_index.html#build-state-setup-phase">7.5.2.2. Build State Setup Phase</a></li>
+<li><a href="type_index.html#process-queued-uris">7.5.2.3. Process Queued URIs</a></li>
+<li><a href="type_index.html#queueing-affected-resources">7.5.2.4. Queueing Affected Resources</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#sec:Incremental_Builder_Overview__Example">7.5.3. Example</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#dirty-state-handling">7.6. Dirty state handling</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#use-case-restoring-types-from-user-data">7.6.1. Use case: Restoring types from user data</a></li>
+<li><a href="type_index.html#use-case-updating-the-xtext-index">7.6.2. Use case: Updating the Xtext index</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="project_model.html#_project-model">8. Project Model</a>
+<ul class="sectlevel2">
+<li><a href="project_model.html#sec:Package_json">8.1. Package.json File</a></li>
+<li><a href="project_model.html#_accessing-project-information">8.2. Accessing Project Information</a>
+<ul class="sectlevel3">
+<li><a href="project_model.html#sec:IN4JSCore">8.2.1. IN4JSCore</a></li>
+<li><a href="project_model.html#sec:N4JSModel">8.2.2. N4JSModel</a></li>
+<li><a href="project_model.html#sec:N4JSWorkspace">8.2.3. N4JSWorkspace</a></li>
+<li><a href="project_model.html#sec:N4JSProject">8.2.4. N4JSProject</a></li>
+<li><a href="project_model.html#sec:SourceContainer">8.2.5. SourceContainer</a></li>
+<li><a href="project_model.html#sec:N4JSProjectsStateHelper">8.2.6. N4JSProjectsStateHelper</a></li>
+</ul>
+</li>
+<li><a href="project_model.html#sec:Caching">8.3. Caching</a>
+<ul class="sectlevel3">
+<li><a href="project_model.html#_caching-of-externallibraryworkspace">8.3.1. Caching of ExternalLibraryWorkspace</a></li>
+<li><a href="project_model.html#_caching-of-n4jsprojectsstatehelper">8.3.2. Caching of N4JSProjectsStateHelper</a></li>
+</ul>
+</li>
+<li><a href="project_model.html#sec:WildcardPathFilter">8.4. WildcardPathFilter</a></li>
+<li><a href="project_model.html#sec:ProjectUtils">8.5. ProjectUtils</a></li>
+</ul>
+</li>
+<li><a href="binding.html#_binding">9. Binding</a>
+<ul class="sectlevel2">
+<li><a href="binding.html#sec:Binding_Design_Rationale">9.1. Design Rationale</a></li>
+<li><a href="binding.html#sec:Binding_to_Members">9.2. Binding to Members</a></li>
+<li><a href="binding.html#sec:Binding_Getter_Setter">9.3. Getter / Setter Binding</a></li>
+<li><a href="binding.html#chap:Statics">9.4. Static Member Binding</a></li>
+<li><a href="binding.html#sec:Binding_Enumeration">9.5. Enumeration Literals Binding</a></li>
+<li><a href="binding.html#sec:Accessibility_of_types_and_members">9.6. Accessibility of types and members</a></li>
+<li><a href="binding.html#sec:Member_Scope_Example">9.7. Member Scope Example</a></li>
+<li><a href="binding.html#sec:Scoping_for_Members_of_Composed_Type_Explained">9.8. Scoping for Members of Composed Type (Union/Intersection) Example</a></li>
+<li><a href="binding.html#sec:Binding_of_Structurally_References_Types">9.9. Structurally References Types</a></li>
+<li><a href="binding.html#sec:Building">9.10. Building</a>
+<ul class="sectlevel3">
+<li><a href="binding.html#sec:Build_Phases">9.10.1. Build Phases</a></li>
+<li><a href="binding.html#sec:Build_Scenarios">9.10.2. Build Scenarios</a></li>
+<li><a href="binding.html#sec:Lazy_linking_problem">9.10.3. Lazy linking problem</a></li>
+</ul>
+</li>
+<li><a href="binding.html#sec:Proxies_and_Proxy_Resolution">9.11. Proxies and Proxy Resolution (Overview)</a>
+<ul class="sectlevel3">
+<li><a href="binding.html#xtexts-lazy-linking-proxies">9.11.1. Xtext’s Lazy Linking Proxies</a></li>
+<li><a href="binding.html#standard-emf-proxies">9.11.2. Standard EMF Proxies</a></li>
+<li><a href="binding.html#_how-is-proxy-resolution-triggered">9.11.3. How is Proxy Resolution Triggered?</a></li>
+<li><a href="binding.html#_when-is-proxy-resolution-allowed">9.11.4. When is Proxy Resolution Allowed?</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="validation.html#_validation">10. Validation</a>
+<ul class="sectlevel2">
+<li><a href="validation.html#sec:validation_overview">10.1. Validation overview</a></li>
+<li><a href="validation.html#sec:validation_control_flow">10.2. Validation control flow</a></li>
+<li><a href="validation.html#sec:validation_issue_ids">10.3. Issue IDs and Messages</a></li>
+<li><a href="validation.html#sec:validation_usage_patterns">10.4. Usage Pattern</a></li>
+<li><a href="validation.html#sec:validation_links">10.5. Links</a></li>
+</ul>
+</li>
+<li><a href="references.html#_references">11. References</a>
+<ul class="sectlevel2">
+<li><a href="references.html#sec:usecases">11.1. Use cases</a></li>
+<li><a href="references.html#sec:calculation_algorithm">11.2. Calculation algorithm</a>
+<ul class="sectlevel3">
+<li><a href="references.html#sec:Xtext_default_implementation">11.2.1. Xtext default implementation</a></li>
+<li><a href="references.html#sec:N4_implementation">11.2.2. N4JS implementation</a></li>
+</ul>
+</li>
+<li><a href="references.html#sec:PerformanceOfDependencyCalculation">11.3. Performance Of Dependency Calculation</a></li>
+<li><a href="references.html#sec:kinds_of_references">11.4. Kinds of references</a>
+<ul class="sectlevel3">
+<li><a href="references.html#sec:Cross_References_to_be_ignored">11.4.1. Cross References to be ignored</a></li>
+<li><a href="references.html#sec:Cross_References_to_be_handled">11.4.2. Cross References to be handled</a></li>
+</ul>
+</li>
+<li><a href="references.html#sec:transitive_dependencies">11.5. Transitive dependencies</a></li>
+<li><a href="references.html#sec:find-references">11.6. Find references</a>
+<ul class="sectlevel3">
+<li><a href="references.html#_background">11.6.1. Background</a></li>
+<li><a href="references.html#_how-find-references-work">11.6.2. How Find References Work</a>
+<ul class="sectlevel4">
+<li><a href="references.html#_step-1-convert-cursor-position-to-declared-element">11.6.2.1. Step 1: Convert Cursor Position to Declared Element</a></li>
+<li><a href="references.html#_step-2-convert-declared-element-to-target-uris">11.6.2.2. Step 2: Convert Declared Element to Target URIs</a></li>
+<li><a href="references.html#_step-3-filter-potential-resources">11.6.2.3. Step 3: Filter Potential Resources</a></li>
+<li><a href="references.html#_step-4-search-references-in-resource">11.6.2.4. Step 4: Search References in Resource</a></li>
+<li><a href="references.html#_limitations-and-possible-enhancements">11.6.2.5. Limitations and Possible Enhancements</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="compilation.html#_compilation">12. Compilation</a>
+<ul class="sectlevel2">
+<li><a href="compilation.html#chap:compilation">12.1. Introduction</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:general_design_rationals">12.1.1. General design rationals</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:logging_and_error_reporting">12.1.1.1. Logging and error reporting</a></li>
+<li><a href="compilation.html#sec:progress_monitor">12.1.1.2. Progress monitor</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Xtext_Integration">12.1.2. Xtext Integration</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:xtext_default_behaviour">12.1.2.1. Xtext default behaviour</a></li>
+<li><a href="compilation.html#sec:n4js_requirements">12.1.2.2. N4JS requirements</a></li>
+<li><a href="compilation.html#sec:compiler_discovery_in_ui">12.1.2.3. Compiler discovery in UI</a></li>
+<li><a href="compilation.html#sec:compiler_discovery_in_headless">12.1.2.4. Compiler discovery in headless</a></li>
+<li><a href="compilation.html#sec:general_generator_implementation">12.1.2.5. General generator implementation</a></li>
+<li><a href="compilation.html#sec:general_generator_activation">12.1.2.6. General generator activation</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Overview_of_Input_Models">12.1.3. Overview of the Input Models</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Core_Generator">12.2. Generators</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:Compiler_Components">12.2.1. Generator Components</a></li>
+<li><a href="compilation.html#sec:Generator_architecture">12.2.2. Generator architecture</a></li>
+<li><a href="compilation.html#sec:Unified_Compiler_Configuration">12.2.3. Unified Compiler Configuration</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Transpilers">12.3. Transpilers</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:Phases">12.3.1. Overview</a></li>
+<li><a href="compilation.html#relation-between-ast-and-im">12.3.2. Relation between AST and IM</a></li>
+<li><a href="compilation.html#implementation-overview">12.3.3. Implementation Overview</a></li>
+<li><a href="compilation.html#sec:Guidelines_for_Implementing_Transformations">12.3.4. Guidelines for Implementing Transformations</a></li>
+<li><a href="compilation.html#symbol-table-in-the-im">12.3.5. Symbol Table in the IM</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:N4JS_to_EcmaScript_Transpiler">12.4. N4JS-to-EcmaScript Transpiler</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:Overview_of_Transformations">12.4.1. Overview of Transformations</a></li>
+<li><a href="compilation.html#sec:Transpiling_members">12.4.2. Transpiling members</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:Transpiling_members__Delegating_members">12.4.2.1. Techniques for special member handling</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__Partial_shadowing_of_getter_setter_pairs">12.4.2.2. Partial shadowing</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__Consuming_or_inheriting_members_of_an_interface">12.4.2.3. Consuming or inheriting members of an interface</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__Static_polyfill">12.4.2.4. Static polyfill</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__API_implementation_stubs">12.4.2.5. API / implementation stubs</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Support_for_incomplete_API_implementation_testing_in_the_N4JS_to_EcmaScript_5_Transpiler">12.4.3. Support for incomplete API implementation testing</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:Modifications_in_Impl_projects">12.4.3.1. Modifications in Impl projects</a></li>
+<li><a href="compilation.html#sec:Implementation_of_stub_generation">12.4.3.2. Implementation of stub-generation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:n4jsc_Headless_Compiler_Interface">12.5. n4jsc Headless Compiler Interface</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:building_the_headless_compiler">12.5.1. building the headless compiler</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="execution.html#_execution">13. Execution</a>
+<ul class="sectlevel2">
+<li><a href="execution.html#sec:N4JS_Project_Execution_And_Linking_Model">13.1. N4JS Project Execution And Linking Model</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#subsec:N4JS_Execution_With_NodeJS">13.1.1. N4JS Execution With NodeJS</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:N4JS_Execution_And_Linking_File">13.2. N4JS Execution And Linking File</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#subsec:NodeJS_Specific_ELF">13.2.1. NodeJS Specific ELF</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Runners-execution">13.3. Runners</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#subsec:N4_Runtime_Environments_Convention">13.3.1. N4 Runtime Environments Convention</a></li>
+<li><a href="execution.html#subsec:Passing_Information_from_IDE_to_Execution_Code_in_Runtime_Environment">13.3.2. Passing Information from IDE to Execution Code in Runtime Environment</a></li>
+<li><a href="execution.html#subsec:Runners_Design">13.3.3. Runners Design</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Legacy_Execution_Engine">13.4. Legacy Execution Engine</a></li>
+<li><a href="execution.html#sec:Design">13.5. Design</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#sec:Usage_Outside_N4JSIDE">13.5.1. Usage Outside N4JSIDE</a>
+<ul class="sectlevel4">
+<li><a href="execution.html#sec:Use_Node_with_Maven">13.5.1.1. Use Node with Maven</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Usage_Inside_N4JSIDE">13.5.2. Usage Inside N4JSIDE</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Runtime_Injection">13.6. Runtime Injection</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#sec:Running_String_Code">13.6.1. Running String Code</a></li>
+<li><a href="execution.html#sec:Running_File_Code">13.6.2. Running File Code</a></li>
+<li><a href="execution.html#sec:Injection_Code_Example">13.6.3. Injection Code Example</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#_tests">14. Tests</a>
+<ul class="sectlevel2">
+<li><a href="tests.html#sec:Performance_Tests">14.1. Performance Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Synthetic_Performance_Tests">14.1.1. Synthetic Performance Tests</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:Design_of_Generator">14.1.1.1. Design of Generator</a></li>
+<li><a href="tests.html#sec:Design_of_Performance_Test_Execution">14.1.1.2. Design of Performance Test Configuration and Execution</a></li>
+<li><a href="tests.html#sec:JUnit_Configuration">14.1.1.3. JUnit Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Test_Configuration">14.1.1.4. JUnitBenchmark Test Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Report_Configuration">14.1.1.5. JUnitBenchmark Report Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Run_Configuration">14.1.1.6. JUnitBenchmark Run Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Example">14.1.1.7. JUnitBenchmark Example</a></li>
+<li><a href="tests.html#sec:Note_on_Jenkins_Job">14.1.1.8. Note on Jenkins Job</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#sec:ECMA_Tests">14.2. ECMA Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Grammar_Tests">14.2.1. Grammar Tests</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:Negative_Tests">14.2.1.1. Negative Tests</a></li>
+<li><a href="tests.html#sec:Test_Exclusion">14.2.1.2. Test Exclusion</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Integration_Tests">14.3. Integration Tests</a></li>
+<li><a href="tests.html#sec:Test_Helpers">14.4. Test Helpers</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Parameterized_N4JS_Tests">14.4.1. Parameterized N4JS tests</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:ParameterizedXtextRunner">14.4.1.1. ParameterizedXtextRunner</a></li>
+<li><a href="tests.html#sec:TestCodeProvider">14.4.1.2. TestCodeProvider</a></li>
+<li><a href="tests.html#sec:Example_Of_Parameterized_Parser_Test">14.4.1.3. Example of parameterized parser test</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Issue_Suppression">14.5. Issue Suppression</a></li>
+<li><a href="tests.html#sec:Xpect_Tests">14.6. Xpect Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Xpect_Test_Setup">14.6.1. Xpect Test Setup</a></li>
+<li><a href="tests.html#sec:Xpect_Issue_Suppression">14.6.2. Xpect Issue Suppression</a></li>
+<li><a href="tests.html#sec:Xpect_Provided_Test_Methods">14.6.3. Xpect Provided Test Methods</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#errors">14.6.3.1. errors</a></li>
+<li><a href="tests.html#warnings">14.6.3.2. warnings</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:N4JS_Specific_Xpect_Test_Methods">14.6.4. N4JS Specific Xpect Test Methods</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:XPECT_noerrors">14.6.4.1. noerrors and nowarnings</a></li>
+<li><a href="tests.html#sec:XPECT_scope">14.6.4.2. scope</a></li>
+<li><a href="tests.html#sec:XPECT_scopeWithPosition">14.6.4.3. scopeWithPosition</a></li>
+<li><a href="tests.html#sec:XPECT_scopeWithResource">14.6.4.4. scopeWithResource</a></li>
+<li><a href="tests.html#sec:XPECT_binding">14.6.4.5. binding</a></li>
+<li><a href="tests.html#sec:XPECT_linkedPathname">14.6.4.6. linkedPathname</a></li>
+<li><a href="tests.html#sec:XPECT_type_of">14.6.4.7. type of</a></li>
+<li><a href="tests.html#sec:XPECT_expectedType">14.6.4.8. expectedType</a></li>
+<li><a href="tests.html#sec:XPECT_elementKeyword">14.6.4.9. elementKeyword</a></li>
+<li><a href="tests.html#sec:XPECT_accessModifier">14.6.4.10. accessModifier</a></li>
+<li><a href="tests.html#sec:XPECT_compileResult">14.6.4.11. compileResult</a></li>
+<li><a href="tests.html#sec:XPECT_output">14.6.4.12. output</a></li>
+<li><a href="tests.html#sec:XPECT_outputRegEx">14.6.4.13. outputRegEx</a></li>
+<li><a href="tests.html#sec:XPECT_calculatedAccessModifier">14.6.4.14. calculatedAccessModifier</a></li>
+<li><a href="tests.html#sec:XPECT_spec">14.6.4.15. spec</a></li>
+<li><a href="tests.html#sec:XPECT_deadCode">14.6.4.16. deadCode</a></li>
+<li><a href="tests.html#sec:XPECT_returnOrThrows">14.6.4.17. returnOrThrows</a></li>
+<li><a href="tests.html#sec:XPECT_lint">14.6.4.18. lint</a></li>
+<li><a href="tests.html#sec:XPECT_lintFails">14.6.4.19. lintFails</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:FIXME_Xpect_modifier">14.6.5. FIXME Xpect modifier</a></li>
+<li><a href="tests.html#sec:Expectmatrix_Xpect_Test_Methods">14.6.6. Expectmatrix Xpect tests</a></li>
+<li><a href="tests.html#xpect-lint-tests">14.6.7. Xpect Lint Tests</a></li>
+</ul>
+</li>
+<li><a href="tests.html#xpect-proposal-tests">14.7. Xpect Proposal Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Validation_vs__Non_Validation">14.7.1. Validation vs. Non-Validation</a></li>
+<li><a href="tests.html#sec:General_Proposal_Test_Features">14.7.2. General Proposal Test Features</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:Test_Variables">14.7.2.1. Test Variables</a></li>
+<li><a href="tests.html#sec:Location_and_Selection">14.7.2.2. at – Location and Selection</a></li>
+<li><a href="tests.html#sec:Multi_Line_Expectations_in_Proposal_Tests">14.7.2.3. Multi Line Expectations in Proposal Tests</a></li>
+<li><a href="tests.html#sec:Timeout">14.7.2.4. Timeout and Performance</a></li>
+</ul>
+</li>
+<li><a href="tests.html#proposals-verify-existence-of-proposals">14.7.3. proposals – Verify Existence of Proposals</a></li>
+<li><a href="tests.html#sec:Verify_displayed_string">14.7.4. display – Verify displayed string</a></li>
+<li><a href="tests.html#sec:Apply_Proposal">14.7.5. apply – Apply Proposal</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#resource-application-in-other-files">14.7.5.1. resource – application in other files</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Content_Assist_Cycling">14.7.6. kind – Content Assist Cycling</a></li>
+<li><a href="tests.html#fileValidVerify-validation-status">14.7.7. fileValid – Verify validation status</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Apply_Proposal_And_Execute_Tests">14.8. Apply Proposal And Execute Tests</a></li>
+<li><a href="tests.html#sec:Organize_Imports_Test">14.9. Organize Imports Test</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#organizeimports">14.9.1. organizeImports</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Access_Control_Test">14.10. Access Control Test</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#test-scenarios">14.10.1. Test Scenarios</a></li>
+<li><a href="tests.html#n4js-code-generator">14.10.2. N4JS Code Generator</a></li>
+<li><a href="tests.html#xtext-issue-matcher">14.10.3. Xtext Issue Matcher</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Smoke_Tests">14.11. Smoke Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#how-to-handle-smoke-test-errors">14.11.1. How to handle smoke test errors?</a></li>
+<li><a href="tests.html#smoketester-and-exceptionanalyzer">14.11.2. SmokeTester and ExceptionAnalyzer</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:UI_Tests_with_SWTBot">14.12. UI Tests with SWTBot</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#writing-swtbot-tests">14.12.1. Writing SWTBot Tests</a></li>
+<li><a href="tests.html#running-swtbot-tests">14.12.2. Running SWTBot Tests</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Debugging_UI_Tests">14.13. Debugging UI Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Connecting_to_the_X_server_on_the_build_node">14.13.1. Connecting to the X-server on the build-node</a></li>
+<li><a href="tests.html#sec:Tools_to_investigate_the_java_stack">14.13.2. Tools to investigate the java-stack</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="ui_concepts.html#_ui-concepts">15. UI Concepts</a>
+<ul class="sectlevel2">
+<li><a href="ui_concepts.html#sec:User_Interface_Concepts">15.1. User Interface Concepts</a>
+<ul class="sectlevel3">
+<li><a href="ui_concepts.html#sec:Eclipse_UI_Concepts">15.1.1. Eclipse UI Concepts</a>
+<ul class="sectlevel4">
+<li><a href="ui_concepts.html#sec:Label_Provider">15.1.1.1. Label Provider</a></li>
+<li><a href="ui_concepts.html#sec:Markers">15.1.1.2. Markers</a></li>
+<li><a href="ui_concepts.html#sec:Commands__Toolbar_and_Menus">15.1.1.3. Commands, Toolbar and Menus</a></li>
+<li><a href="ui_concepts.html#sec:Content_Assist">15.1.1.4. Content Assist</a></li>
+<li><a href="ui_concepts.html#sec:Quick_Fixes">15.1.1.5. Quick Fixes</a></li>
+<li><a href="ui_concepts.html#sec:Quick_Assist">15.1.1.6. Quick Assist</a></li>
+<li><a href="ui_concepts.html#sec:Clean_Up_Actions">15.1.1.7. Clean Up Actions</a></li>
+<li><a href="ui_concepts.html#sec:Save_Actions">15.1.1.8. Save Actions</a></li>
+<li><a href="ui_concepts.html#sec:Auto_Edit">15.1.1.9. Auto Edit</a></li>
+<li><a href="ui_concepts.html#sec:Template_Proposals">15.1.1.10. Template Proposals</a></li>
+<li><a href="ui_concepts.html#sec:Outline_View___Quick_Outline">15.1.1.11. Outline View / Quick Outline</a></li>
+<li><a href="ui_concepts.html#sec:Navigator__Package_Explorer__Project_Explorer">15.1.1.12. Navigator, Package Explorer, Project Explorer</a></li>
+<li><a href="ui_concepts.html#sec:Hyperlinking_and_Navigation">15.1.1.13. Hyperlinking and Navigation</a></li>
+<li><a href="ui_concepts.html#sec:Syntax_and_Semantic_Coloring">15.1.1.14. Syntax and Semantic Coloring</a></li>
+<li><a href="ui_concepts.html#sec:Code_Formatter">15.1.1.15. Code Formatter</a></li>
+<li><a href="ui_concepts.html#sec:Wizards">15.1.1.16. Wizards</a></li>
+<li><a href="ui_concepts.html#sec:Cheat_Sheets">15.1.1.17. Cheat Sheets</a></li>
+<li><a href="ui_concepts.html#sec:Context_sensitive_Help">15.1.1.18. Context-sensitive Help</a></li>
+<li><a href="ui_concepts.html#sec:Hovers">15.1.1.19. Hovers</a></li>
+<li><a href="ui_concepts.html#sec:Folding">15.1.1.20. Folding</a></li>
+<li><a href="ui_concepts.html#sec:Customizable_validation___severity">15.1.1.21. Customizable validation / severity</a></li>
+<li><a href="ui_concepts.html#sec:Proposals">15.1.1.22. Proposals</a></li>
+</ul>
+</li>
+<li><a href="ui_concepts.html#sec:Non_Eclipse_UI_Concepts">15.1.2. Non-Eclipse UI Concepts</a>
+<ul class="sectlevel4">
+<li><a href="ui_concepts.html#sec:Overlays">15.1.2.1. Overlays</a></li>
+<li><a href="ui_concepts.html#sec:Goto__Inferred__Type">15.1.2.2. Goto (Inferred) Type</a></li>
+<li><a href="ui_concepts.html#sec:Postfix_Completion">15.1.2.3. Postfix Completion</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="ui_concepts.html#_user-interface-resources">15.2. User Interface Resources</a>
+<ul class="sectlevel3">
+<li><a href="ui_concepts.html#_icons">15.2.1. Icons</a>
+<ul class="sectlevel4">
+<li><a href="ui_concepts.html#_eclipse-platform-icons">15.2.1.1. Eclipse Platform Icons</a></li>
+<li><a href="ui_concepts.html#_n4js-specific-icons">15.2.1.2. N4JS Specific Icons</a></li>
+<li><a href="ui_concepts.html#_high-resolution-icons">15.2.1.3. High Resolution Icons</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="formatting.html#_formatting">16. Formatting</a>
+<ul class="sectlevel2">
+<li><a href="formatting.html#sec:FmtObjective">16.1. Objective</a>
+<ul class="sectlevel3">
+<li><a href="formatting.html#sec:FmtFormatting_Comments">16.1.1. Formatting Comments</a></li>
+</ul>
+</li>
+<li><a href="formatting.html#sec:FmtArchitecture">16.2. Architecture</a>
+<ul class="sectlevel3">
+<li><a href="formatting.html#sec:Implementation_example">16.2.1. Implementation example</a></li>
+</ul>
+</li>
+<li><a href="formatting.html#sec:FmtFormatter_Implementation_Guidelines">16.3. Formatter Implementation Guidelines</a></li>
+<li><a href="formatting.html#sec:FmtConfiguration">16.4. Configuration</a></li>
+<li><a href="formatting.html#sec:FmtUI_Integration">16.5. UI Integration</a></li>
+<li><a href="formatting.html#sec:FmtUnit_Testing_with_Xpect">16.6. Unit Testing with Xpect</a></li>
+</ul>
+</li>
+<li><a href="external_libraries.html#_external-libraries">17. External Libraries</a>
+<ul class="sectlevel2">
+<li><a href="external_libraries.html#sec:Major_Components">17.1. Major Components</a>
+<ul class="sectlevel3">
+<li><a href="external_libraries.html#subsec:External_Resources">17.1.1. External Resources</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Workspace">17.1.2. External Library Workspace</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Preference_Store">17.1.3. External Library Preference Store</a></li>
+<li><a href="external_libraries.html#subsec:npm_Manager">17.1.4. Library Manager</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Builder_Helper">17.1.5. External Library Builder</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Xtext_Index_Persister">17.1.6. External Library Xtext Index Persister</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Preference_Page">17.1.7. External Library Preference Page</a></li>
+</ul>
+</li>
+<li><a href="external_libraries.html#sec:Headless_External_Library_Support">17.2. Headless External Library Support</a>
+<ul class="sectlevel3">
+<li><a href="external_libraries.html#_custom-npm-settings">17.2.1. Custom npm settings</a></li>
+</ul>
+</li>
+<li><a href="external_libraries.html#sec:lmFutureWork">17.3. Future Work</a>
+<ul class="sectlevel3">
+<li><a href="external_libraries.html#subsec:lmMultipleDependencyScope">17.3.1. Multiple Dependency Scope</a></li>
+<li><a href="external_libraries.html#subsec:lmRunTestsFromLibrary">17.3.2. Run Tests from TestLibrary</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="json_support.html#sec:JSON_Support">18. JSON Support</a>
+<ul class="sectlevel2">
+<li><a href="json_support.html#sec:JSON_Parser">18.1. JSON Parser</a>
+<ul class="sectlevel3">
+<li><a href="json_support.html#sec:JSON_Parser_Unicode_Escaping">18.1.1. Escaping Unicode Control Characters in String Literals</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Empty_Text">18.1.2. Empty Text</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Nested_Structures">18.1.3. Nested Structures</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Whitespace">18.1.4. Whitespace</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Comments">18.1.5. Comments</a></li>
+</ul>
+</li>
+<li><a href="json_support.html#sec:JSON_Language_Extensions">18.2. JSON Language Extensions</a>
+<ul class="sectlevel3">
+<li><a href="json_support.html#sec:JSON_Validator_Extensions">18.2.1. JSON Validator Extensions</a>
+<ul class="sectlevel4">
+<li><a href="json_support.html#sec:File_Specitic_Validator_Extensions">18.2.1.1. File-Specific Validator Extensions</a></li>
+<li><a href="json_support.html#sec:JSON_Declarative_JSON_Validator_Extensions">18.2.1.2. Declarative JSON Validator Extensions</a></li>
+</ul>
+</li>
+<li><a href="json_support.html#_json-resource-description-strategy">18.2.2. JSON Resource Description Strategy</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_jsdoc">19. JSDoc</a>
+<ul class="sectlevel2">
+<li><a href="jsdoc.html#sec:Design_Rationale">19.1. Design Rationale</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#_general-design">19.1.1. General Design</a></li>
+<li><a href="jsdoc.html#sec:Type_Expressions">19.1.2. Type Expressions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#_docexporter">20. DocExporter</a>
+<ul class="sectlevel2">
+<li><a href="#sec:Specification_Exporter">20.1. Specification Exporter</a></li>
+</ul>
+</li>
+<li><a href="rename_refactoring.html#_rename-refactoring">21. Rename Refactoring</a>
+<ul class="sectlevel2">
+<li><a href="rename_refactoring.html#_rename-refactoring-ui-interaction">21.1. Rename Refactoring UI interaction</a></li>
+<li><a href="rename_refactoring.html#_renameelementprocessor-interaction">21.2. RenameElementProcessor interaction</a></li>
+</ul>
+</li>
+<li><a href="flow_graphs.html#chap:flowgraphs">22. Flow Graphs</a>
+<ul class="sectlevel2">
+<li><a href="flow_graphs.html#sec:flowgraphs_overview">22.1. Flow graphs overview</a>
+<ul class="sectlevel3">
+<li><a href="flow_graphs.html#_internal-graph">22.1.1. Internal graph</a></li>
+<li><a href="flow_graphs.html#_optimizations">22.1.2. Optimizations</a></li>
+<li><a href="flow_graphs.html#_api-for-client-analyses">22.1.3. API for client analyses</a>
+<ul class="sectlevel4">
+<li><a href="flow_graphs.html#_mapping-from-internal-to-ast-elements">22.1.3.1. Mapping from internal to AST elements</a></li>
+<li><a href="flow_graphs.html#_graph-visitor">22.1.3.2. Graph visitor</a></li>
+<li><a href="flow_graphs.html#_graph-explorer">22.1.3.3. Graph explorer</a></li>
+<li><a href="flow_graphs.html#_branch-walker">22.1.3.4. Branch walker</a></li>
+<li><a href="flow_graphs.html#_example-1-compute-string-for-each-path">22.1.3.5. Example 1: Compute string for each path</a></li>
+<li><a href="flow_graphs.html#_path-quantor">22.1.3.6. Path quantor</a></li>
+</ul>
+</li>
+<li><a href="flow_graphs.html#_control-flow-analyses">22.1.4. Control flow analyses</a>
+<ul class="sectlevel4">
+<li><a href="flow_graphs.html#_dead-code-analysis">22.1.4.1. Dead code analysis</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="flow_graphs.html#sec:dataflow">22.2. Dataflow</a>
+<ul class="sectlevel3">
+<li><a href="flow_graphs.html#_dataflow-graph">22.2.1. Dataflow graph</a></li>
+<li><a href="flow_graphs.html#_dataflow-analyses">22.2.2. Dataflow analyses</a>
+<ul class="sectlevel4">
+<li><a href="flow_graphs.html#_def-def-def-nothing-analysis">22.2.2.1. Def&#8594;Def / Def&#8594;Nothing analysis</a></li>
+<li><a href="flow_graphs.html#_def-use-decl-analysis">22.2.2.2. Def|Use&#8592;Decl analysis</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="publish_npms.html#sec:publish-npms-to-public">23. Publish npms</a>
+<ul class="sectlevel2">
+<li><a href="publish_npms.html#sec:publish-npms-n4js-maven">23.1. Publish n4js-libs to during  maven build</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Hints">Appendix A: Hints</a>
+<ul class="sectlevel2">
+<li><a href="appendix_a_hints.html#sec:XtextInjection">A.1. Xtext Injection</a>
+<ul class="sectlevel3">
+<li><a href="appendix_a_hints.html#sec:DI_MultipleInjectors_Singletons">A.1.1. Multiple Injectors and Singletons</a>
+<ul class="sectlevel4">
+<li><a href="appendix_a_hints.html#sec:DI_avoid_duplicate_singletons">A.1.1.1. Avoiding duplicate singletons</a>
+<ul class="sectlevel5">
+<li><a href="appendix_a_hints.html#sec:DI_binding_in_shared">A.1.1.1.1. Defining binding in the shared injector</a></li>
+<li><a href="appendix_a_hints.html#sec:DI_binding_in_custom">A.1.1.1.2. Defining binding in the custom injector</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:DI_Hints">A.1.2. Dependency Injection Hints</a>
+<ul class="sectlevel4">
+<li><a href="appendix_a_hints.html#sec:DI_custom_bundle">A.1.2.1. Use DI in custom bundle, use DI with extensions</a>
+<ul class="sectlevel5">
+<li><a href="appendix_a_hints.html#sec:DI_custom_bundle_problem">A.1.2.1.1. Problem</a></li>
+<li><a href="appendix_a_hints.html#sec:DI_custom_bundle_solution">A.1.2.1.2. Solution</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Access_Other_DSL_Injector">A.1.2.2. How do I get the Guice Injector of my language?</a>
+<ul class="sectlevel5">
+<li><a href="appendix_a_hints.html#sec:DSL_Injector_UI_context">A.1.2.2.1. UI context</a></li>
+<li><a href="appendix_a_hints.html#sec:DSL_Injector_Non_UI_context">A.1.2.2.2. Non UI context but with injection context</a></li>
+<li><a href="appendix_a_hints.html#sec:DSL_Injector_Non_UI_non_injection_context">A.1.2.2.3. Non UI context without injection context</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Cancel_Indicator">A.1.2.3. How do I get cancel indicators in different contexts?</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Eclipse">A.2. Eclipse</a>
+<ul class="sectlevel3">
+<li><a href="appendix_a_hints.html#sec:Show_Xtext_Index">A.2.1. Show the current Xtext index</a></li>
+<li><a href="appendix_a_hints.html#sec:Plugin_spy">A.2.2. Plug-in spy</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Maven-hints">A.3. Maven</a>
+<ul class="sectlevel3">
+<li><a href="appendix_a_hints.html#how-to-check-for-maven-mojo-updates">A.3.1. How to check for Maven MOJO updates</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#_module-loading">Appendix B: Module Loading</a>
+<ul class="sectlevel2">
+<li><a href="appendix_b_module_loading.html#sec:Dependency_Management">B.1. Dependency Management</a></li>
+<li><a href="appendix_b_module_loading.html#ecmascript-modules">B.2. ECMAScript Modules</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:ES5_Modules_Systems">B.2.1. ES5 Modules Systems</a></li>
+<li><a href="appendix_b_module_loading.html#sec:ES6_Modules">B.2.2. ES6 Modules</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:ECMAScript_Module_Loaders">B.3. ECMAScript Module Loaders</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:ES6_Module_Loaders">B.3.1. ES6 Module Loaders</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Polyfills_for_ES6_Module_Loaders">B.3.2. Polyfills for ES6 Module Loaders</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:es6_module_loader">B.3.2.1. es6-module-loader</a></li>
+<li><a href="appendix_b_module_loading.html#sec:SystemJS">B.3.2.2. SystemJS</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Demo">B.3.2.3. Demo</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#case-study-typescript">B.4. Case Study : TypeScript</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:ES6_Modules_Support">B.4.1. ES6 Modules Support</a></li>
+<li><a href="appendix_b_module_loading.html#sec:TypeScript_and_Module_Loading">B.4.2. TypeScript and Module Loading</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Cyclic_Dependencies">B.5. Cyclic Dependencies</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:Setup">B.5.1. Setup</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Transpile_and_Execute">B.5.2. Transpile and Execute</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Module_Format___AMD">B.5.2.1. Module Format = AMD</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Module_Format___CommonJS">B.5.2.2. Module Format = CommonJS</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Module_Format___SystemJS">B.5.2.3. Module Format = SystemJS</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Conclusion">B.5.3. Conclusion</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#system.register-as-transpilation-target">B.6. System.register as transpilation target</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:Introduction">B.6.1. Introduction</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:External_Transpilers">B.6.1.1. External Transpilers</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Example_of_a_System_register_module">B.6.1.2. Example of a System.register module</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Structure_of_a_System_register_module">B.6.2. Structure of a System.register module</a></li>
+<li><a href="appendix_b_module_loading.html#_transpilation-hints">B.6.3. Transpilation Hints</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Handling_Imports">B.6.3.1. Handling Imports</a></li>
+<li><a href="appendix_b_module_loading.html#sec:__exportFn__">B.6.3.2. &lt;&lt;exportFn&gt;&gt;</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Handling_Exports">B.6.3.3. Handling Exports</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Examples_w__Circular_Dependencies">B.6.4. Examples w/ Circular Dependencies</a></li>
+<li><a href="appendix_b_module_loading.html#sec:N4JS_Examples_w__Circular_Dependencies">B.6.5. N4JS Examples w/ Circular Dependencies</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Unresolved_Cyclic_Dependencies">B.6.5.1. Unresolved Cyclic Dependencies</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Variables___Functions">B.6.5.2. Examples with Variables &amp; Functions</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Classes">B.6.5.3. Examples with Classes</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Examples_with_SubClassing">B.6.5.4. Examples with SubClassing</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Miscellaneous">B.6.5.5. Miscellaneous</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#_resources">B.6.6. Resources</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:CommonJS_as_transpilation_target">B.7. CommonJS as transpilation target</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#_introduction-2">B.7.1. Introduction</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Transpilation_Hints">B.7.2. Transpilation Hints</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Import_Statements">B.7.2.1. Import Statements</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Export_Statements">B.7.2.2. Export Statements</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Tracking_Live_Bindings">B.7.2.3. Tracking Live Bindings</a></li>
+<li><a href="appendix_b_module_loading.html#sec:A_complete_example">B.7.2.4. A complete example</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#_resources-2">B.7.3. Resources</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_c_license.html#sec:License">Appendix C: License</a></li>
+<li><a href="appendix_d_acronyms.html#sec:Acronyms">Appendix D: Acronyms</a></li>
+<li><a href="appendix_e_bibliography_and_footnotes.html#_bibliography-and-footnotes">Appendix E: Bibliography and Footnotes</a></li>
+</ul>
+</div>
+</div>
+<div id="content"><div class="sect1">
+<h2 id="_docexporter"><a class="anchor" href="#_docexporter"></a><a class="link" href="#_docexporter">20. DocExporter</a></h2>
+<div class="sectionbody">
+<div class="admonitionblock warning">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-warning" title=""></i>
+</td>
+<td class="content">
+This chapter may be outdated.
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>The DocExporter exports JavaDoc from source files to adoc files.
+In particular it combines information about methods with tests in order to create specification documents.</p>
+</div>
+<div class="sect2">
+<h3 id="sec:Specification_Exporter"><a class="anchor" href="#sec:Specification_Exporter"></a><a class="link" href="#sec:Specification_Exporter">20.1. Specification Exporter</a></h3>
+<div class="paragraph">
+<p>The specification exporter creates and merges artifacts.
+<a href="#fig:api_test_spec">Fig. API Test Spec</a> sketches the relation between API (i.e., n4jsd files with classifiers),
+tests (i.e., N4JS test classes and methods), and specification (Documentation with JSDOC markers).</p>
+</div>
+<div id="fig:api_test_spec" class="imageblock center">
+<div class="content">
+<img src="chapters/24_docexporter/images/api_test_spec.svg" alt="api test spec">
+</div>
+<div class="title">Figure 52. Component/Class pseudo diagram: Relation API, Tests and Specification</div>
+</div>
+<div class="paragraph">
+<p><a href="#fig:cd_jsdocreader">Fig. Exporter</a> shows the classes that read and analyze Java source documentation.</p>
+</div>
+<div id="fig:cd_jsdocreader" class="imageblock center">
+<div class="content">
+<img src="chapters/24_docexporter/images/cd_jsdocreader.svg" alt="cd jsdocreader">
+</div>
+<div class="title">Figure 53. Java reader classes</div>
+</div>
+<div class="paragraph">
+<p><a href="#fig:cd_adocexporter">Fig. Exporter</a> shows the content classes of the exporter that contain the generated documentation contents.</p>
+</div>
+<div id="fig:cd_adocexporter" class="imageblock center">
+<div class="content">
+<img src="chapters/24_docexporter/images/cd_adocexporter.svg" alt="cd adocexporter">
+</div>
+<div class="title">Figure 54. Exporter content classes</div>
+</div>
+<div class="paragraph">
+<p><a href="#fig:cd_docexporter_model">Fig. DocExporter Model</a> shows the model, which may be used for other doc exporters as well.</p>
+</div>
+<div id="fig:cd_docexporter_model" class="imageblock center">
+<div class="content">
+<img src="chapters/24_docexporter/images/cd_docexporter_model.svg" alt="cd docexporter model">
+</div>
+<div class="title">Figure 55. Exporter model classes</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div id="footer">
+<div id="footer-text">
+Version 0.9<br>
+Last updated 2019-08-07 15:02:40 CEST
+</div>
+</div>
+<!-- ************* docinfo-footer *************************************************************** -->
+<div class="Grid social" style="color:#d5dfea">
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <h2>Quick Links</h2>
+    <ul>
+      <li><a href="../downloads.html">Download</a></li>
+      <li><a href="../userguides/index.html">Documentation</a></li>
+      <li><a href="https://github.com/eclipse/n4js/">Source</a></li>
+      <li><a href="https://github.com/eclipse/n4js/issues">Issues</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="https://www.eclipse.org/forums/index.php/f/365/">Forum</a></li>
+      <li><a href="http://n4js.blogspot.de/">Blog</a></li>
+      <li><a href="https://dev.eclipse.org/mailman/listinfo/n4js-dev">Mailing List</a></li>
+      <li><a href="https://projects.eclipse.org/projects/technology.n4js">Eclipse Project Page</a></li>
+      <li><a href="https://twitter.com/n4jsdev">Tweets by n4jsdev</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="http://www.eclipse.org/">Eclipse Home</a></li>
+      <li><a href="http://www.eclipse.org/legal/privacy.php">Privacy Policy</a></li>
+      <li><a href="http://www.eclipse.org/legal/termsofuse.php">Terms of Use</a></li>
+      <li><a href="http://www.eclipse.org/legal/copyright.php">Copyright Agent</a></li>
+      <li><a href="http://www.eclipse.org/legal/">Legal</a></li>
+    </ul>
+  </div>
+  <div style="clear: both; height: 0; overflow: hidden;"></div>
+</div>
+
+<!-- ************* UI Scripts ************* -->
+<script type="text/javascript" src="scripts/back-to-top.js"></script>
+
+<script type="text/javascript" src="scripts/treeview.js"></script>
+<script type="text/javascript" src="scripts/toc.js"></script>
+
+<!-- ************* Prism.js Syntax Highlighting ************* -->
+<script src="scripts/prism.js"></script>
+
+<script type="text/javascript">
+	// Add the 'toclist' id for search function
+	$(".toc2 > ul").attr('id', 'toclist');
+	// Generate a Search input form
+	$("#toclist > li:first-of-type").before('<input type="text" id="pagesearch" onkeyup="search()" placeholder="Search for section...">');
+	$("#toclist > li:first-of-type").before('<i id="clear" class="fa fa-times-circle-o"></i>');
+	$("#clear").click(function(){
+	    $("#pagesearch").val('');
+	    search();
+	    $('.toc2 > ul').treeView('collapseAll');
+	});
+	// intialize Treeview.js
+	$(".toc2 > ul").treeView();
+	// Initialize Scrollspy
+</script>
+<!-- ************* docinfo-footer *************************************************************** -->
+</body>
+</html>
\ No newline at end of file
diff --git a/design/eclipse_setup.html b/design/eclipse_setup.html
new file mode 100644
index 0000000..bac3e4f
--- /dev/null
+++ b/design/eclipse_setup.html
@@ -0,0 +1,1046 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="generator" content="Asciidoctor 1.5.5">
+<meta name="author" content="2019-08-07 15:02:40 CEST">
+<title>N4JS Design Specification</title>
+<link rel="stylesheet" href="styles/spec.min.css">
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.6.3/css/font-awesome.min.css">
+<!-- ************* docinfo ******************************************************************* -->
+
+
+<!-- ************* Favicon ************-->
+<link rel="icon" href="images/favicon.ico" />
+
+<!-- ************* Back-to-top JQuery ************* -->
+<script src="https://code.jquery.com/jquery-1.12.4.js"></script>
+<script src="https://code.jquery.com/ui/1.12.0/jquery-ui.js"></script>
+
+
+<link href="styles/prism.min.css" rel="stylesheet" />
+<script type="text/javascript" async
+  src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2/MathJax.js?config=TeX-MML-AM_CHTML">
+</script>
+
+<!-- ************* Styles ************* -->
+<link rel="stylesheet" type="text/css" href="styles/n4jsspec-adoc.css">
+
+
+<!-- ****************** NavBar ****************** -->
+<div id="menubar">
+	<div class="banner">
+        <a href="https://www.eclipse.org/n4js/#"><img id="logo" src="images/n4js-logo.png" alt="Eclipse N4JS"></a>
+    </div>
+<ul>
+  <li><a href="index.html">Index</a></li>
+</ul>
+</div>
+<!-- ************* docinfo ******************************************************************* -->
+<style>
+      .admonitionblock td.icon .icon-todo:before{content:"\f249";color:#f4ee42}
+    </style>
+</head>
+<body class="book toc2 toc-left">
+<div id="header">
+<h1>N4JS Design Specification</h1>
+<div class="details">
+<span id="author" class="author">2019-08-07 15:02:40 CEST</span><br>
+<span id="revnumber">version 0.9</span>
+</div>
+<div id="toc" class="toc2">
+<div id="toctitle">Table of Contents</div>
+<ul class="sectlevel1">
+<li><a href="introduction.html#_introduction">1. Introduction</a>
+<ul class="sectlevel2">
+<li><a href="introduction.html#notation">1.1. Notation</a></li>
+<li><a href="introduction.html#sec:IDE_Overview">1.2. IDE Components</a>
+<ul class="sectlevel3">
+<li><a href="introduction.html#sec:Naming_Conventions">1.2.1. Naming Conventions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#_eclipse-setup">2. Eclipse Setup</a>
+<ul class="sectlevel2">
+<li><a href="#_system-requirements">2.1. System Requirements</a></li>
+<li><a href="#_contribute">2.2. Contribute</a>
+<ul class="sectlevel3">
+<li><a href="#_eclipse-installer">2.2.1. Eclipse Installer</a>
+<ul class="sectlevel4">
+<li><a href="#_changing-the-setup-script">2.2.1.1. Changing the Setup Script</a></li>
+</ul>
+</li>
+<li><a href="#_manual-ide-configuration">2.2.2. Manual IDE Configuration</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="release_engineering.html#_release-engineering">3. Release Engineering</a>
+<ul class="sectlevel2">
+<li><a href="release_engineering.html#_nightly-build-on-eclipse-infrastructure">3.1. Nightly build on Eclipse infrastructure</a></li>
+<li><a href="release_engineering.html#_build-the-n4js-ide-from-command-line">3.2. Build the N4JS IDE from command line</a>
+<ul class="sectlevel3">
+<li><a href="release_engineering.html#_publish-maven-tooling-code-org-eclipse-n4js-releng-util-code">3.2.1. Publish maven-tooling <code>org.eclipse.n4js.releng.util</code></a></li>
+<li><a href="release_engineering.html#sec:test-verdaccio">3.2.2. Test Verdaccio containing n4js-libs</a></li>
+<li><a href="release_engineering.html#_generation-of-eclipse-help-for-spec-and-design-document">3.2.3. Generation of Eclipse help for spec and design document</a></li>
+</ul>
+</li>
+<li><a href="release_engineering.html#_updating-frameworks-and-dependencies">3.3. Updating frameworks and dependencies</a>
+<ul class="sectlevel3">
+<li><a href="release_engineering.html#_update-of-eclipse-emf-xtext-etc">3.3.1. Update of Eclipse, EMF, Xtext, etc.</a></li>
+<li><a href="release_engineering.html#_update-of-the-embedded-jre">3.3.2. Update of the embedded JRE</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tips_and_tricks.html#_tips-and-tricks">4. Tips and Tricks</a>
+<ul class="sectlevel2">
+<li><a href="tips_and_tricks.html#_naming">4.1. Naming</a></li>
+<li><a href="tips_and_tricks.html#_logging">4.2. Logging</a></li>
+<li><a href="tips_and_tricks.html#_cancellation-handling">4.3. Cancellation Handling</a></li>
+<li><a href="tips_and_tricks.html#_caching">4.4. Caching</a></li>
+<li><a href="tips_and_tricks.html#_dependency-injection">4.5. Dependency Injection</a></li>
+<li><a href="tips_and_tricks.html#_miscellaneous">4.6. Miscellaneous</a></li>
+</ul>
+</li>
+<li><a href="parser.html#_parser">5. Parser</a>
+<ul class="sectlevel2">
+<li><a href="parser.html#sec:Parser_Overview">5.1. Overview</a></li>
+<li><a href="parser.html#sec:N4JS_Parser">5.2. N4JS Parser</a></li>
+<li><a href="parser.html#sec:Parser_Generation_Post_Processing">5.3. Parser Generation Post-Processing</a>
+<ul class="sectlevel3">
+<li><a href="parser.html#sec:Automatic_Semicolon_Insertion">5.3.1. Automatic Semicolon Insertion</a>
+<ul class="sectlevel4">
+<li><a href="parser.html#sec:Injected_code_in_the_Antlr_grammar_file">5.3.1.1. Injected code in the Antlr grammar file</a></li>
+<li><a href="parser.html#sec:Customized_error_recovery">5.3.1.2. Customized error recovery</a></li>
+</ul>
+</li>
+<li><a href="parser.html#sec:_No_line_terminator_allowed_here__handling">5.3.2. Async and <code>No line terminator allowed here</code> Handling</a></li>
+<li><a href="parser.html#sec:Regular_Expression">5.3.3. Regular Expression</a></li>
+<li><a href="parser.html#sec:Unicode">5.3.4. Unicode</a></li>
+<li><a href="parser.html#sec:Literals">5.3.5. Literals</a></li>
+</ul>
+</li>
+<li><a href="parser.html#sec:Modifiers">5.4. Modifiers</a></li>
+<li><a href="parser.html#sec:Conflict_Resolutions">5.5. Conflict Resolutions</a>
+<ul class="sectlevel3">
+<li><a href="parser.html#sec:Reserved_Keywords_vs__Identifier_Names">5.5.1. Reserved Keywords vs. Identifier Names</a></li>
+<li><a href="parser.html#sec:Operators_and_Generics">5.5.2. Operators and Generics</a></li>
+</ul>
+</li>
+<li><a href="parser.html#sec:Content_Assist_Parser">5.6. Content-Assist Parser</a></li>
+</ul>
+</li>
+<li><a href="type_system.html#_type-system">6. Type System</a>
+<ul class="sectlevel2">
+<li><a href="type_system.html#sec:Type_Model_and_Grammar">6.1. Type Model and Grammar</a>
+<ul class="sectlevel3">
+<li><a href="type_system.html#sec:Type_Model_Overview">6.1.1. Type Model Overview</a></li>
+<li><a href="type_system.html#sec:Built_in_Types">6.1.2. Built-in and Primitive Types</a></li>
+<li><a href="type_system.html#sec:Type_Model_DSL">6.1.3. Type Model DSL</a></li>
+</ul>
+</li>
+<li><a href="type_system.html#sec:Type_System_Implementation">6.2. Type System Implementation</a></li>
+<li><a href="type_system.html#sec:Type_Inference_combined_with_AST_Traversal">6.3. Type Inference of AST</a>
+<ul class="sectlevel3">
+<li><a href="type_system.html#sec:Type_Inference_combined_with_AST_Traversal__Background">6.3.1. Background</a></li>
+<li><a href="type_system.html#sec:Triggering_Type_Inference_of_AST">6.3.2. Triggering</a></li>
+<li><a href="type_system.html#sec:Traversal_Order_During_Type_Inference_of_AST">6.3.3. Traversal Order</a></li>
+<li><a href="type_system.html#sec:Cross_References_During_Type_Inference_of_AST">6.3.4. Cross-References</a></li>
+<li><a href="type_system.html#sec:Function_Accessor_Bodies_During_Type_Inference_of_AST">6.3.5. Function/Accessor Bodies</a></li>
+<li><a href="type_system.html#sec:Poly_Expressions_During_Type_Inference_of_AST">6.3.6. Poly Expressions</a></li>
+<li><a href="type_system.html#sec:Constraint_Solver_used_During_Type_Inference_of_AST">6.3.7. Constraint Solver</a></li>
+<li><a href="type_system.html#sec:Type_Guards_During_Type_Inference_of_AST">6.3.8. Type Guards</a></li>
+</ul>
+</li>
+<li><a href="type_system.html#sec:Structural_Typing">6.4. Structural Typing</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#_type-index">7. Type Index</a>
+<ul class="sectlevel2">
+<li><a href="type_index.html#sec:Type_Index_Design_Rationale">7.1. Design Rationale</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#sec:Getting_the_Xtext_Index_Content_IResourceDescriptions">7.1.1. Getting the Xtext Index (<code>IResourceDescriptions</code>) Content</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#sec:Design_Overview">7.2. Design Overview</a></li>
+<li><a href="type_index.html#sec:N4JS_Resource_Load_States">7.3. N4JS Resource Load States</a></li>
+<li><a href="type_index.html#sec:Type_Builder">7.4. Types Builder</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#sec:Type_Inference_not_allowed_in_Type_Builder">7.4.1. Type Inference not allowed in Types Builder</a></li>
+<li><a href="type_index.html#sec:ComputedTypeReferences">7.4.2. Deferred Type References</a></li>
+<li><a href="type_index.html#sec:Use_cases_of_ComputedTypeRef">7.4.3. Use cases of DeferredTypeRef</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#sec:Incremental_Builder_Overview">7.5. Incremental Builder (Overview)</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#sec:Incremental_Builder_Overview__XtextBuilder">7.5.1. XtextBuilder</a></li>
+<li><a href="type_index.html#sec:Incremental_Builder_Overview__IBuilderState">7.5.2. IBuilderState</a>
+<ul class="sectlevel4">
+<li><a href="type_index.html#copy-and-update-xtext-index">7.5.2.1. Copy and Update Xtext Index</a></li>
+<li><a href="type_index.html#build-state-setup-phase">7.5.2.2. Build State Setup Phase</a></li>
+<li><a href="type_index.html#process-queued-uris">7.5.2.3. Process Queued URIs</a></li>
+<li><a href="type_index.html#queueing-affected-resources">7.5.2.4. Queueing Affected Resources</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#sec:Incremental_Builder_Overview__Example">7.5.3. Example</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#dirty-state-handling">7.6. Dirty state handling</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#use-case-restoring-types-from-user-data">7.6.1. Use case: Restoring types from user data</a></li>
+<li><a href="type_index.html#use-case-updating-the-xtext-index">7.6.2. Use case: Updating the Xtext index</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="project_model.html#_project-model">8. Project Model</a>
+<ul class="sectlevel2">
+<li><a href="project_model.html#sec:Package_json">8.1. Package.json File</a></li>
+<li><a href="project_model.html#_accessing-project-information">8.2. Accessing Project Information</a>
+<ul class="sectlevel3">
+<li><a href="project_model.html#sec:IN4JSCore">8.2.1. IN4JSCore</a></li>
+<li><a href="project_model.html#sec:N4JSModel">8.2.2. N4JSModel</a></li>
+<li><a href="project_model.html#sec:N4JSWorkspace">8.2.3. N4JSWorkspace</a></li>
+<li><a href="project_model.html#sec:N4JSProject">8.2.4. N4JSProject</a></li>
+<li><a href="project_model.html#sec:SourceContainer">8.2.5. SourceContainer</a></li>
+<li><a href="project_model.html#sec:N4JSProjectsStateHelper">8.2.6. N4JSProjectsStateHelper</a></li>
+</ul>
+</li>
+<li><a href="project_model.html#sec:Caching">8.3. Caching</a>
+<ul class="sectlevel3">
+<li><a href="project_model.html#_caching-of-externallibraryworkspace">8.3.1. Caching of ExternalLibraryWorkspace</a></li>
+<li><a href="project_model.html#_caching-of-n4jsprojectsstatehelper">8.3.2. Caching of N4JSProjectsStateHelper</a></li>
+</ul>
+</li>
+<li><a href="project_model.html#sec:WildcardPathFilter">8.4. WildcardPathFilter</a></li>
+<li><a href="project_model.html#sec:ProjectUtils">8.5. ProjectUtils</a></li>
+</ul>
+</li>
+<li><a href="binding.html#_binding">9. Binding</a>
+<ul class="sectlevel2">
+<li><a href="binding.html#sec:Binding_Design_Rationale">9.1. Design Rationale</a></li>
+<li><a href="binding.html#sec:Binding_to_Members">9.2. Binding to Members</a></li>
+<li><a href="binding.html#sec:Binding_Getter_Setter">9.3. Getter / Setter Binding</a></li>
+<li><a href="binding.html#chap:Statics">9.4. Static Member Binding</a></li>
+<li><a href="binding.html#sec:Binding_Enumeration">9.5. Enumeration Literals Binding</a></li>
+<li><a href="binding.html#sec:Accessibility_of_types_and_members">9.6. Accessibility of types and members</a></li>
+<li><a href="binding.html#sec:Member_Scope_Example">9.7. Member Scope Example</a></li>
+<li><a href="binding.html#sec:Scoping_for_Members_of_Composed_Type_Explained">9.8. Scoping for Members of Composed Type (Union/Intersection) Example</a></li>
+<li><a href="binding.html#sec:Binding_of_Structurally_References_Types">9.9. Structurally References Types</a></li>
+<li><a href="binding.html#sec:Building">9.10. Building</a>
+<ul class="sectlevel3">
+<li><a href="binding.html#sec:Build_Phases">9.10.1. Build Phases</a></li>
+<li><a href="binding.html#sec:Build_Scenarios">9.10.2. Build Scenarios</a></li>
+<li><a href="binding.html#sec:Lazy_linking_problem">9.10.3. Lazy linking problem</a></li>
+</ul>
+</li>
+<li><a href="binding.html#sec:Proxies_and_Proxy_Resolution">9.11. Proxies and Proxy Resolution (Overview)</a>
+<ul class="sectlevel3">
+<li><a href="binding.html#xtexts-lazy-linking-proxies">9.11.1. Xtext’s Lazy Linking Proxies</a></li>
+<li><a href="binding.html#standard-emf-proxies">9.11.2. Standard EMF Proxies</a></li>
+<li><a href="binding.html#_how-is-proxy-resolution-triggered">9.11.3. How is Proxy Resolution Triggered?</a></li>
+<li><a href="binding.html#_when-is-proxy-resolution-allowed">9.11.4. When is Proxy Resolution Allowed?</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="validation.html#_validation">10. Validation</a>
+<ul class="sectlevel2">
+<li><a href="validation.html#sec:validation_overview">10.1. Validation overview</a></li>
+<li><a href="validation.html#sec:validation_control_flow">10.2. Validation control flow</a></li>
+<li><a href="validation.html#sec:validation_issue_ids">10.3. Issue IDs and Messages</a></li>
+<li><a href="validation.html#sec:validation_usage_patterns">10.4. Usage Pattern</a></li>
+<li><a href="validation.html#sec:validation_links">10.5. Links</a></li>
+</ul>
+</li>
+<li><a href="references.html#_references">11. References</a>
+<ul class="sectlevel2">
+<li><a href="references.html#sec:usecases">11.1. Use cases</a></li>
+<li><a href="references.html#sec:calculation_algorithm">11.2. Calculation algorithm</a>
+<ul class="sectlevel3">
+<li><a href="references.html#sec:Xtext_default_implementation">11.2.1. Xtext default implementation</a></li>
+<li><a href="references.html#sec:N4_implementation">11.2.2. N4JS implementation</a></li>
+</ul>
+</li>
+<li><a href="references.html#sec:PerformanceOfDependencyCalculation">11.3. Performance Of Dependency Calculation</a></li>
+<li><a href="references.html#sec:kinds_of_references">11.4. Kinds of references</a>
+<ul class="sectlevel3">
+<li><a href="references.html#sec:Cross_References_to_be_ignored">11.4.1. Cross References to be ignored</a></li>
+<li><a href="references.html#sec:Cross_References_to_be_handled">11.4.2. Cross References to be handled</a></li>
+</ul>
+</li>
+<li><a href="references.html#sec:transitive_dependencies">11.5. Transitive dependencies</a></li>
+<li><a href="references.html#sec:find-references">11.6. Find references</a>
+<ul class="sectlevel3">
+<li><a href="references.html#_background">11.6.1. Background</a></li>
+<li><a href="references.html#_how-find-references-work">11.6.2. How Find References Work</a>
+<ul class="sectlevel4">
+<li><a href="references.html#_step-1-convert-cursor-position-to-declared-element">11.6.2.1. Step 1: Convert Cursor Position to Declared Element</a></li>
+<li><a href="references.html#_step-2-convert-declared-element-to-target-uris">11.6.2.2. Step 2: Convert Declared Element to Target URIs</a></li>
+<li><a href="references.html#_step-3-filter-potential-resources">11.6.2.3. Step 3: Filter Potential Resources</a></li>
+<li><a href="references.html#_step-4-search-references-in-resource">11.6.2.4. Step 4: Search References in Resource</a></li>
+<li><a href="references.html#_limitations-and-possible-enhancements">11.6.2.5. Limitations and Possible Enhancements</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="compilation.html#_compilation">12. Compilation</a>
+<ul class="sectlevel2">
+<li><a href="compilation.html#chap:compilation">12.1. Introduction</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:general_design_rationals">12.1.1. General design rationals</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:logging_and_error_reporting">12.1.1.1. Logging and error reporting</a></li>
+<li><a href="compilation.html#sec:progress_monitor">12.1.1.2. Progress monitor</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Xtext_Integration">12.1.2. Xtext Integration</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:xtext_default_behaviour">12.1.2.1. Xtext default behaviour</a></li>
+<li><a href="compilation.html#sec:n4js_requirements">12.1.2.2. N4JS requirements</a></li>
+<li><a href="compilation.html#sec:compiler_discovery_in_ui">12.1.2.3. Compiler discovery in UI</a></li>
+<li><a href="compilation.html#sec:compiler_discovery_in_headless">12.1.2.4. Compiler discovery in headless</a></li>
+<li><a href="compilation.html#sec:general_generator_implementation">12.1.2.5. General generator implementation</a></li>
+<li><a href="compilation.html#sec:general_generator_activation">12.1.2.6. General generator activation</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Overview_of_Input_Models">12.1.3. Overview of the Input Models</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Core_Generator">12.2. Generators</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:Compiler_Components">12.2.1. Generator Components</a></li>
+<li><a href="compilation.html#sec:Generator_architecture">12.2.2. Generator architecture</a></li>
+<li><a href="compilation.html#sec:Unified_Compiler_Configuration">12.2.3. Unified Compiler Configuration</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Transpilers">12.3. Transpilers</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:Phases">12.3.1. Overview</a></li>
+<li><a href="compilation.html#relation-between-ast-and-im">12.3.2. Relation between AST and IM</a></li>
+<li><a href="compilation.html#implementation-overview">12.3.3. Implementation Overview</a></li>
+<li><a href="compilation.html#sec:Guidelines_for_Implementing_Transformations">12.3.4. Guidelines for Implementing Transformations</a></li>
+<li><a href="compilation.html#symbol-table-in-the-im">12.3.5. Symbol Table in the IM</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:N4JS_to_EcmaScript_Transpiler">12.4. N4JS-to-EcmaScript Transpiler</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:Overview_of_Transformations">12.4.1. Overview of Transformations</a></li>
+<li><a href="compilation.html#sec:Transpiling_members">12.4.2. Transpiling members</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:Transpiling_members__Delegating_members">12.4.2.1. Techniques for special member handling</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__Partial_shadowing_of_getter_setter_pairs">12.4.2.2. Partial shadowing</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__Consuming_or_inheriting_members_of_an_interface">12.4.2.3. Consuming or inheriting members of an interface</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__Static_polyfill">12.4.2.4. Static polyfill</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__API_implementation_stubs">12.4.2.5. API / implementation stubs</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Support_for_incomplete_API_implementation_testing_in_the_N4JS_to_EcmaScript_5_Transpiler">12.4.3. Support for incomplete API implementation testing</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:Modifications_in_Impl_projects">12.4.3.1. Modifications in Impl projects</a></li>
+<li><a href="compilation.html#sec:Implementation_of_stub_generation">12.4.3.2. Implementation of stub-generation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:n4jsc_Headless_Compiler_Interface">12.5. n4jsc Headless Compiler Interface</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:building_the_headless_compiler">12.5.1. building the headless compiler</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="execution.html#_execution">13. Execution</a>
+<ul class="sectlevel2">
+<li><a href="execution.html#sec:N4JS_Project_Execution_And_Linking_Model">13.1. N4JS Project Execution And Linking Model</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#subsec:N4JS_Execution_With_NodeJS">13.1.1. N4JS Execution With NodeJS</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:N4JS_Execution_And_Linking_File">13.2. N4JS Execution And Linking File</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#subsec:NodeJS_Specific_ELF">13.2.1. NodeJS Specific ELF</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Runners-execution">13.3. Runners</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#subsec:N4_Runtime_Environments_Convention">13.3.1. N4 Runtime Environments Convention</a></li>
+<li><a href="execution.html#subsec:Passing_Information_from_IDE_to_Execution_Code_in_Runtime_Environment">13.3.2. Passing Information from IDE to Execution Code in Runtime Environment</a></li>
+<li><a href="execution.html#subsec:Runners_Design">13.3.3. Runners Design</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Legacy_Execution_Engine">13.4. Legacy Execution Engine</a></li>
+<li><a href="execution.html#sec:Design">13.5. Design</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#sec:Usage_Outside_N4JSIDE">13.5.1. Usage Outside N4JSIDE</a>
+<ul class="sectlevel4">
+<li><a href="execution.html#sec:Use_Node_with_Maven">13.5.1.1. Use Node with Maven</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Usage_Inside_N4JSIDE">13.5.2. Usage Inside N4JSIDE</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Runtime_Injection">13.6. Runtime Injection</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#sec:Running_String_Code">13.6.1. Running String Code</a></li>
+<li><a href="execution.html#sec:Running_File_Code">13.6.2. Running File Code</a></li>
+<li><a href="execution.html#sec:Injection_Code_Example">13.6.3. Injection Code Example</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#_tests">14. Tests</a>
+<ul class="sectlevel2">
+<li><a href="tests.html#sec:Performance_Tests">14.1. Performance Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Synthetic_Performance_Tests">14.1.1. Synthetic Performance Tests</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:Design_of_Generator">14.1.1.1. Design of Generator</a></li>
+<li><a href="tests.html#sec:Design_of_Performance_Test_Execution">14.1.1.2. Design of Performance Test Configuration and Execution</a></li>
+<li><a href="tests.html#sec:JUnit_Configuration">14.1.1.3. JUnit Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Test_Configuration">14.1.1.4. JUnitBenchmark Test Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Report_Configuration">14.1.1.5. JUnitBenchmark Report Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Run_Configuration">14.1.1.6. JUnitBenchmark Run Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Example">14.1.1.7. JUnitBenchmark Example</a></li>
+<li><a href="tests.html#sec:Note_on_Jenkins_Job">14.1.1.8. Note on Jenkins Job</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#sec:ECMA_Tests">14.2. ECMA Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Grammar_Tests">14.2.1. Grammar Tests</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:Negative_Tests">14.2.1.1. Negative Tests</a></li>
+<li><a href="tests.html#sec:Test_Exclusion">14.2.1.2. Test Exclusion</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Integration_Tests">14.3. Integration Tests</a></li>
+<li><a href="tests.html#sec:Test_Helpers">14.4. Test Helpers</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Parameterized_N4JS_Tests">14.4.1. Parameterized N4JS tests</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:ParameterizedXtextRunner">14.4.1.1. ParameterizedXtextRunner</a></li>
+<li><a href="tests.html#sec:TestCodeProvider">14.4.1.2. TestCodeProvider</a></li>
+<li><a href="tests.html#sec:Example_Of_Parameterized_Parser_Test">14.4.1.3. Example of parameterized parser test</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Issue_Suppression">14.5. Issue Suppression</a></li>
+<li><a href="tests.html#sec:Xpect_Tests">14.6. Xpect Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Xpect_Test_Setup">14.6.1. Xpect Test Setup</a></li>
+<li><a href="tests.html#sec:Xpect_Issue_Suppression">14.6.2. Xpect Issue Suppression</a></li>
+<li><a href="tests.html#sec:Xpect_Provided_Test_Methods">14.6.3. Xpect Provided Test Methods</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#errors">14.6.3.1. errors</a></li>
+<li><a href="tests.html#warnings">14.6.3.2. warnings</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:N4JS_Specific_Xpect_Test_Methods">14.6.4. N4JS Specific Xpect Test Methods</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:XPECT_noerrors">14.6.4.1. noerrors and nowarnings</a></li>
+<li><a href="tests.html#sec:XPECT_scope">14.6.4.2. scope</a></li>
+<li><a href="tests.html#sec:XPECT_scopeWithPosition">14.6.4.3. scopeWithPosition</a></li>
+<li><a href="tests.html#sec:XPECT_scopeWithResource">14.6.4.4. scopeWithResource</a></li>
+<li><a href="tests.html#sec:XPECT_binding">14.6.4.5. binding</a></li>
+<li><a href="tests.html#sec:XPECT_linkedPathname">14.6.4.6. linkedPathname</a></li>
+<li><a href="tests.html#sec:XPECT_type_of">14.6.4.7. type of</a></li>
+<li><a href="tests.html#sec:XPECT_expectedType">14.6.4.8. expectedType</a></li>
+<li><a href="tests.html#sec:XPECT_elementKeyword">14.6.4.9. elementKeyword</a></li>
+<li><a href="tests.html#sec:XPECT_accessModifier">14.6.4.10. accessModifier</a></li>
+<li><a href="tests.html#sec:XPECT_compileResult">14.6.4.11. compileResult</a></li>
+<li><a href="tests.html#sec:XPECT_output">14.6.4.12. output</a></li>
+<li><a href="tests.html#sec:XPECT_outputRegEx">14.6.4.13. outputRegEx</a></li>
+<li><a href="tests.html#sec:XPECT_calculatedAccessModifier">14.6.4.14. calculatedAccessModifier</a></li>
+<li><a href="tests.html#sec:XPECT_spec">14.6.4.15. spec</a></li>
+<li><a href="tests.html#sec:XPECT_deadCode">14.6.4.16. deadCode</a></li>
+<li><a href="tests.html#sec:XPECT_returnOrThrows">14.6.4.17. returnOrThrows</a></li>
+<li><a href="tests.html#sec:XPECT_lint">14.6.4.18. lint</a></li>
+<li><a href="tests.html#sec:XPECT_lintFails">14.6.4.19. lintFails</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:FIXME_Xpect_modifier">14.6.5. FIXME Xpect modifier</a></li>
+<li><a href="tests.html#sec:Expectmatrix_Xpect_Test_Methods">14.6.6. Expectmatrix Xpect tests</a></li>
+<li><a href="tests.html#xpect-lint-tests">14.6.7. Xpect Lint Tests</a></li>
+</ul>
+</li>
+<li><a href="tests.html#xpect-proposal-tests">14.7. Xpect Proposal Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Validation_vs__Non_Validation">14.7.1. Validation vs. Non-Validation</a></li>
+<li><a href="tests.html#sec:General_Proposal_Test_Features">14.7.2. General Proposal Test Features</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:Test_Variables">14.7.2.1. Test Variables</a></li>
+<li><a href="tests.html#sec:Location_and_Selection">14.7.2.2. at – Location and Selection</a></li>
+<li><a href="tests.html#sec:Multi_Line_Expectations_in_Proposal_Tests">14.7.2.3. Multi Line Expectations in Proposal Tests</a></li>
+<li><a href="tests.html#sec:Timeout">14.7.2.4. Timeout and Performance</a></li>
+</ul>
+</li>
+<li><a href="tests.html#proposals-verify-existence-of-proposals">14.7.3. proposals – Verify Existence of Proposals</a></li>
+<li><a href="tests.html#sec:Verify_displayed_string">14.7.4. display – Verify displayed string</a></li>
+<li><a href="tests.html#sec:Apply_Proposal">14.7.5. apply – Apply Proposal</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#resource-application-in-other-files">14.7.5.1. resource – application in other files</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Content_Assist_Cycling">14.7.6. kind – Content Assist Cycling</a></li>
+<li><a href="tests.html#fileValidVerify-validation-status">14.7.7. fileValid – Verify validation status</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Apply_Proposal_And_Execute_Tests">14.8. Apply Proposal And Execute Tests</a></li>
+<li><a href="tests.html#sec:Organize_Imports_Test">14.9. Organize Imports Test</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#organizeimports">14.9.1. organizeImports</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Access_Control_Test">14.10. Access Control Test</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#test-scenarios">14.10.1. Test Scenarios</a></li>
+<li><a href="tests.html#n4js-code-generator">14.10.2. N4JS Code Generator</a></li>
+<li><a href="tests.html#xtext-issue-matcher">14.10.3. Xtext Issue Matcher</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Smoke_Tests">14.11. Smoke Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#how-to-handle-smoke-test-errors">14.11.1. How to handle smoke test errors?</a></li>
+<li><a href="tests.html#smoketester-and-exceptionanalyzer">14.11.2. SmokeTester and ExceptionAnalyzer</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:UI_Tests_with_SWTBot">14.12. UI Tests with SWTBot</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#writing-swtbot-tests">14.12.1. Writing SWTBot Tests</a></li>
+<li><a href="tests.html#running-swtbot-tests">14.12.2. Running SWTBot Tests</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Debugging_UI_Tests">14.13. Debugging UI Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Connecting_to_the_X_server_on_the_build_node">14.13.1. Connecting to the X-server on the build-node</a></li>
+<li><a href="tests.html#sec:Tools_to_investigate_the_java_stack">14.13.2. Tools to investigate the java-stack</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="ui_concepts.html#_ui-concepts">15. UI Concepts</a>
+<ul class="sectlevel2">
+<li><a href="ui_concepts.html#sec:User_Interface_Concepts">15.1. User Interface Concepts</a>
+<ul class="sectlevel3">
+<li><a href="ui_concepts.html#sec:Eclipse_UI_Concepts">15.1.1. Eclipse UI Concepts</a>
+<ul class="sectlevel4">
+<li><a href="ui_concepts.html#sec:Label_Provider">15.1.1.1. Label Provider</a></li>
+<li><a href="ui_concepts.html#sec:Markers">15.1.1.2. Markers</a></li>
+<li><a href="ui_concepts.html#sec:Commands__Toolbar_and_Menus">15.1.1.3. Commands, Toolbar and Menus</a></li>
+<li><a href="ui_concepts.html#sec:Content_Assist">15.1.1.4. Content Assist</a></li>
+<li><a href="ui_concepts.html#sec:Quick_Fixes">15.1.1.5. Quick Fixes</a></li>
+<li><a href="ui_concepts.html#sec:Quick_Assist">15.1.1.6. Quick Assist</a></li>
+<li><a href="ui_concepts.html#sec:Clean_Up_Actions">15.1.1.7. Clean Up Actions</a></li>
+<li><a href="ui_concepts.html#sec:Save_Actions">15.1.1.8. Save Actions</a></li>
+<li><a href="ui_concepts.html#sec:Auto_Edit">15.1.1.9. Auto Edit</a></li>
+<li><a href="ui_concepts.html#sec:Template_Proposals">15.1.1.10. Template Proposals</a></li>
+<li><a href="ui_concepts.html#sec:Outline_View___Quick_Outline">15.1.1.11. Outline View / Quick Outline</a></li>
+<li><a href="ui_concepts.html#sec:Navigator__Package_Explorer__Project_Explorer">15.1.1.12. Navigator, Package Explorer, Project Explorer</a></li>
+<li><a href="ui_concepts.html#sec:Hyperlinking_and_Navigation">15.1.1.13. Hyperlinking and Navigation</a></li>
+<li><a href="ui_concepts.html#sec:Syntax_and_Semantic_Coloring">15.1.1.14. Syntax and Semantic Coloring</a></li>
+<li><a href="ui_concepts.html#sec:Code_Formatter">15.1.1.15. Code Formatter</a></li>
+<li><a href="ui_concepts.html#sec:Wizards">15.1.1.16. Wizards</a></li>
+<li><a href="ui_concepts.html#sec:Cheat_Sheets">15.1.1.17. Cheat Sheets</a></li>
+<li><a href="ui_concepts.html#sec:Context_sensitive_Help">15.1.1.18. Context-sensitive Help</a></li>
+<li><a href="ui_concepts.html#sec:Hovers">15.1.1.19. Hovers</a></li>
+<li><a href="ui_concepts.html#sec:Folding">15.1.1.20. Folding</a></li>
+<li><a href="ui_concepts.html#sec:Customizable_validation___severity">15.1.1.21. Customizable validation / severity</a></li>
+<li><a href="ui_concepts.html#sec:Proposals">15.1.1.22. Proposals</a></li>
+</ul>
+</li>
+<li><a href="ui_concepts.html#sec:Non_Eclipse_UI_Concepts">15.1.2. Non-Eclipse UI Concepts</a>
+<ul class="sectlevel4">
+<li><a href="ui_concepts.html#sec:Overlays">15.1.2.1. Overlays</a></li>
+<li><a href="ui_concepts.html#sec:Goto__Inferred__Type">15.1.2.2. Goto (Inferred) Type</a></li>
+<li><a href="ui_concepts.html#sec:Postfix_Completion">15.1.2.3. Postfix Completion</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="ui_concepts.html#_user-interface-resources">15.2. User Interface Resources</a>
+<ul class="sectlevel3">
+<li><a href="ui_concepts.html#_icons">15.2.1. Icons</a>
+<ul class="sectlevel4">
+<li><a href="ui_concepts.html#_eclipse-platform-icons">15.2.1.1. Eclipse Platform Icons</a></li>
+<li><a href="ui_concepts.html#_n4js-specific-icons">15.2.1.2. N4JS Specific Icons</a></li>
+<li><a href="ui_concepts.html#_high-resolution-icons">15.2.1.3. High Resolution Icons</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="formatting.html#_formatting">16. Formatting</a>
+<ul class="sectlevel2">
+<li><a href="formatting.html#sec:FmtObjective">16.1. Objective</a>
+<ul class="sectlevel3">
+<li><a href="formatting.html#sec:FmtFormatting_Comments">16.1.1. Formatting Comments</a></li>
+</ul>
+</li>
+<li><a href="formatting.html#sec:FmtArchitecture">16.2. Architecture</a>
+<ul class="sectlevel3">
+<li><a href="formatting.html#sec:Implementation_example">16.2.1. Implementation example</a></li>
+</ul>
+</li>
+<li><a href="formatting.html#sec:FmtFormatter_Implementation_Guidelines">16.3. Formatter Implementation Guidelines</a></li>
+<li><a href="formatting.html#sec:FmtConfiguration">16.4. Configuration</a></li>
+<li><a href="formatting.html#sec:FmtUI_Integration">16.5. UI Integration</a></li>
+<li><a href="formatting.html#sec:FmtUnit_Testing_with_Xpect">16.6. Unit Testing with Xpect</a></li>
+</ul>
+</li>
+<li><a href="external_libraries.html#_external-libraries">17. External Libraries</a>
+<ul class="sectlevel2">
+<li><a href="external_libraries.html#sec:Major_Components">17.1. Major Components</a>
+<ul class="sectlevel3">
+<li><a href="external_libraries.html#subsec:External_Resources">17.1.1. External Resources</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Workspace">17.1.2. External Library Workspace</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Preference_Store">17.1.3. External Library Preference Store</a></li>
+<li><a href="external_libraries.html#subsec:npm_Manager">17.1.4. Library Manager</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Builder_Helper">17.1.5. External Library Builder</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Xtext_Index_Persister">17.1.6. External Library Xtext Index Persister</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Preference_Page">17.1.7. External Library Preference Page</a></li>
+</ul>
+</li>
+<li><a href="external_libraries.html#sec:Headless_External_Library_Support">17.2. Headless External Library Support</a>
+<ul class="sectlevel3">
+<li><a href="external_libraries.html#_custom-npm-settings">17.2.1. Custom npm settings</a></li>
+</ul>
+</li>
+<li><a href="external_libraries.html#sec:lmFutureWork">17.3. Future Work</a>
+<ul class="sectlevel3">
+<li><a href="external_libraries.html#subsec:lmMultipleDependencyScope">17.3.1. Multiple Dependency Scope</a></li>
+<li><a href="external_libraries.html#subsec:lmRunTestsFromLibrary">17.3.2. Run Tests from TestLibrary</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="json_support.html#sec:JSON_Support">18. JSON Support</a>
+<ul class="sectlevel2">
+<li><a href="json_support.html#sec:JSON_Parser">18.1. JSON Parser</a>
+<ul class="sectlevel3">
+<li><a href="json_support.html#sec:JSON_Parser_Unicode_Escaping">18.1.1. Escaping Unicode Control Characters in String Literals</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Empty_Text">18.1.2. Empty Text</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Nested_Structures">18.1.3. Nested Structures</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Whitespace">18.1.4. Whitespace</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Comments">18.1.5. Comments</a></li>
+</ul>
+</li>
+<li><a href="json_support.html#sec:JSON_Language_Extensions">18.2. JSON Language Extensions</a>
+<ul class="sectlevel3">
+<li><a href="json_support.html#sec:JSON_Validator_Extensions">18.2.1. JSON Validator Extensions</a>
+<ul class="sectlevel4">
+<li><a href="json_support.html#sec:File_Specitic_Validator_Extensions">18.2.1.1. File-Specific Validator Extensions</a></li>
+<li><a href="json_support.html#sec:JSON_Declarative_JSON_Validator_Extensions">18.2.1.2. Declarative JSON Validator Extensions</a></li>
+</ul>
+</li>
+<li><a href="json_support.html#_json-resource-description-strategy">18.2.2. JSON Resource Description Strategy</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_jsdoc">19. JSDoc</a>
+<ul class="sectlevel2">
+<li><a href="jsdoc.html#sec:Design_Rationale">19.1. Design Rationale</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#_general-design">19.1.1. General Design</a></li>
+<li><a href="jsdoc.html#sec:Type_Expressions">19.1.2. Type Expressions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="docexporter.html#_docexporter">20. DocExporter</a>
+<ul class="sectlevel2">
+<li><a href="docexporter.html#sec:Specification_Exporter">20.1. Specification Exporter</a></li>
+</ul>
+</li>
+<li><a href="rename_refactoring.html#_rename-refactoring">21. Rename Refactoring</a>
+<ul class="sectlevel2">
+<li><a href="rename_refactoring.html#_rename-refactoring-ui-interaction">21.1. Rename Refactoring UI interaction</a></li>
+<li><a href="rename_refactoring.html#_renameelementprocessor-interaction">21.2. RenameElementProcessor interaction</a></li>
+</ul>
+</li>
+<li><a href="flow_graphs.html#chap:flowgraphs">22. Flow Graphs</a>
+<ul class="sectlevel2">
+<li><a href="flow_graphs.html#sec:flowgraphs_overview">22.1. Flow graphs overview</a>
+<ul class="sectlevel3">
+<li><a href="flow_graphs.html#_internal-graph">22.1.1. Internal graph</a></li>
+<li><a href="flow_graphs.html#_optimizations">22.1.2. Optimizations</a></li>
+<li><a href="flow_graphs.html#_api-for-client-analyses">22.1.3. API for client analyses</a>
+<ul class="sectlevel4">
+<li><a href="flow_graphs.html#_mapping-from-internal-to-ast-elements">22.1.3.1. Mapping from internal to AST elements</a></li>
+<li><a href="flow_graphs.html#_graph-visitor">22.1.3.2. Graph visitor</a></li>
+<li><a href="flow_graphs.html#_graph-explorer">22.1.3.3. Graph explorer</a></li>
+<li><a href="flow_graphs.html#_branch-walker">22.1.3.4. Branch walker</a></li>
+<li><a href="flow_graphs.html#_example-1-compute-string-for-each-path">22.1.3.5. Example 1: Compute string for each path</a></li>
+<li><a href="flow_graphs.html#_path-quantor">22.1.3.6. Path quantor</a></li>
+</ul>
+</li>
+<li><a href="flow_graphs.html#_control-flow-analyses">22.1.4. Control flow analyses</a>
+<ul class="sectlevel4">
+<li><a href="flow_graphs.html#_dead-code-analysis">22.1.4.1. Dead code analysis</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="flow_graphs.html#sec:dataflow">22.2. Dataflow</a>
+<ul class="sectlevel3">
+<li><a href="flow_graphs.html#_dataflow-graph">22.2.1. Dataflow graph</a></li>
+<li><a href="flow_graphs.html#_dataflow-analyses">22.2.2. Dataflow analyses</a>
+<ul class="sectlevel4">
+<li><a href="flow_graphs.html#_def-def-def-nothing-analysis">22.2.2.1. Def&#8594;Def / Def&#8594;Nothing analysis</a></li>
+<li><a href="flow_graphs.html#_def-use-decl-analysis">22.2.2.2. Def|Use&#8592;Decl analysis</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="publish_npms.html#sec:publish-npms-to-public">23. Publish npms</a>
+<ul class="sectlevel2">
+<li><a href="publish_npms.html#sec:publish-npms-n4js-maven">23.1. Publish n4js-libs to during  maven build</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Hints">Appendix A: Hints</a>
+<ul class="sectlevel2">
+<li><a href="appendix_a_hints.html#sec:XtextInjection">A.1. Xtext Injection</a>
+<ul class="sectlevel3">
+<li><a href="appendix_a_hints.html#sec:DI_MultipleInjectors_Singletons">A.1.1. Multiple Injectors and Singletons</a>
+<ul class="sectlevel4">
+<li><a href="appendix_a_hints.html#sec:DI_avoid_duplicate_singletons">A.1.1.1. Avoiding duplicate singletons</a>
+<ul class="sectlevel5">
+<li><a href="appendix_a_hints.html#sec:DI_binding_in_shared">A.1.1.1.1. Defining binding in the shared injector</a></li>
+<li><a href="appendix_a_hints.html#sec:DI_binding_in_custom">A.1.1.1.2. Defining binding in the custom injector</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:DI_Hints">A.1.2. Dependency Injection Hints</a>
+<ul class="sectlevel4">
+<li><a href="appendix_a_hints.html#sec:DI_custom_bundle">A.1.2.1. Use DI in custom bundle, use DI with extensions</a>
+<ul class="sectlevel5">
+<li><a href="appendix_a_hints.html#sec:DI_custom_bundle_problem">A.1.2.1.1. Problem</a></li>
+<li><a href="appendix_a_hints.html#sec:DI_custom_bundle_solution">A.1.2.1.2. Solution</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Access_Other_DSL_Injector">A.1.2.2. How do I get the Guice Injector of my language?</a>
+<ul class="sectlevel5">
+<li><a href="appendix_a_hints.html#sec:DSL_Injector_UI_context">A.1.2.2.1. UI context</a></li>
+<li><a href="appendix_a_hints.html#sec:DSL_Injector_Non_UI_context">A.1.2.2.2. Non UI context but with injection context</a></li>
+<li><a href="appendix_a_hints.html#sec:DSL_Injector_Non_UI_non_injection_context">A.1.2.2.3. Non UI context without injection context</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Cancel_Indicator">A.1.2.3. How do I get cancel indicators in different contexts?</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Eclipse">A.2. Eclipse</a>
+<ul class="sectlevel3">
+<li><a href="appendix_a_hints.html#sec:Show_Xtext_Index">A.2.1. Show the current Xtext index</a></li>
+<li><a href="appendix_a_hints.html#sec:Plugin_spy">A.2.2. Plug-in spy</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Maven-hints">A.3. Maven</a>
+<ul class="sectlevel3">
+<li><a href="appendix_a_hints.html#how-to-check-for-maven-mojo-updates">A.3.1. How to check for Maven MOJO updates</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#_module-loading">Appendix B: Module Loading</a>
+<ul class="sectlevel2">
+<li><a href="appendix_b_module_loading.html#sec:Dependency_Management">B.1. Dependency Management</a></li>
+<li><a href="appendix_b_module_loading.html#ecmascript-modules">B.2. ECMAScript Modules</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:ES5_Modules_Systems">B.2.1. ES5 Modules Systems</a></li>
+<li><a href="appendix_b_module_loading.html#sec:ES6_Modules">B.2.2. ES6 Modules</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:ECMAScript_Module_Loaders">B.3. ECMAScript Module Loaders</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:ES6_Module_Loaders">B.3.1. ES6 Module Loaders</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Polyfills_for_ES6_Module_Loaders">B.3.2. Polyfills for ES6 Module Loaders</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:es6_module_loader">B.3.2.1. es6-module-loader</a></li>
+<li><a href="appendix_b_module_loading.html#sec:SystemJS">B.3.2.2. SystemJS</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Demo">B.3.2.3. Demo</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#case-study-typescript">B.4. Case Study : TypeScript</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:ES6_Modules_Support">B.4.1. ES6 Modules Support</a></li>
+<li><a href="appendix_b_module_loading.html#sec:TypeScript_and_Module_Loading">B.4.2. TypeScript and Module Loading</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Cyclic_Dependencies">B.5. Cyclic Dependencies</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:Setup">B.5.1. Setup</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Transpile_and_Execute">B.5.2. Transpile and Execute</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Module_Format___AMD">B.5.2.1. Module Format = AMD</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Module_Format___CommonJS">B.5.2.2. Module Format = CommonJS</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Module_Format___SystemJS">B.5.2.3. Module Format = SystemJS</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Conclusion">B.5.3. Conclusion</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#system.register-as-transpilation-target">B.6. System.register as transpilation target</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:Introduction">B.6.1. Introduction</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:External_Transpilers">B.6.1.1. External Transpilers</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Example_of_a_System_register_module">B.6.1.2. Example of a System.register module</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Structure_of_a_System_register_module">B.6.2. Structure of a System.register module</a></li>
+<li><a href="appendix_b_module_loading.html#_transpilation-hints">B.6.3. Transpilation Hints</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Handling_Imports">B.6.3.1. Handling Imports</a></li>
+<li><a href="appendix_b_module_loading.html#sec:__exportFn__">B.6.3.2. &lt;&lt;exportFn&gt;&gt;</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Handling_Exports">B.6.3.3. Handling Exports</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Examples_w__Circular_Dependencies">B.6.4. Examples w/ Circular Dependencies</a></li>
+<li><a href="appendix_b_module_loading.html#sec:N4JS_Examples_w__Circular_Dependencies">B.6.5. N4JS Examples w/ Circular Dependencies</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Unresolved_Cyclic_Dependencies">B.6.5.1. Unresolved Cyclic Dependencies</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Variables___Functions">B.6.5.2. Examples with Variables &amp; Functions</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Classes">B.6.5.3. Examples with Classes</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Examples_with_SubClassing">B.6.5.4. Examples with SubClassing</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Miscellaneous">B.6.5.5. Miscellaneous</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#_resources">B.6.6. Resources</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:CommonJS_as_transpilation_target">B.7. CommonJS as transpilation target</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#_introduction-2">B.7.1. Introduction</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Transpilation_Hints">B.7.2. Transpilation Hints</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Import_Statements">B.7.2.1. Import Statements</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Export_Statements">B.7.2.2. Export Statements</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Tracking_Live_Bindings">B.7.2.3. Tracking Live Bindings</a></li>
+<li><a href="appendix_b_module_loading.html#sec:A_complete_example">B.7.2.4. A complete example</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#_resources-2">B.7.3. Resources</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_c_license.html#sec:License">Appendix C: License</a></li>
+<li><a href="appendix_d_acronyms.html#sec:Acronyms">Appendix D: Acronyms</a></li>
+<li><a href="appendix_e_bibliography_and_footnotes.html#_bibliography-and-footnotes">Appendix E: Bibliography and Footnotes</a></li>
+</ul>
+</div>
+</div>
+<div id="content"><div class="sect1">
+<h2 id="_eclipse-setup"><a class="anchor" href="#_eclipse-setup"></a><a class="link" href="#_eclipse-setup">2. Eclipse Setup</a></h2>
+<div class="sectionbody">
+<div class="sect2">
+<h3 id="_system-requirements"><a class="anchor" href="#_system-requirements"></a><a class="link" href="#_system-requirements">2.1. System Requirements</a></h3>
+<div class="paragraph">
+<p>In all cases, <a href="https://adoptopenjdk.net/">Java 11</a> is required to be installed on your system. <a href="https://nodejs.org/en/download/">Node.js</a> version 10+ is also required, and for some tests you need <a href="https://yarnpkg.com">Yarn</a> to be globally installed.</p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_contribute"><a class="anchor" href="#_contribute"></a><a class="link" href="#_contribute">2.2. Contribute</a></h3>
+<div class="paragraph">
+<p>Eclipse developers who want to develop N4JS itself should use the <a href="https://www.eclipse.org/downloads/">Oomph Eclipse installer</a>. The N4JS project is listed under "Eclipse Projects/N4JS"
+This setup installs the correct Eclipse version, creates a new workspace and clones all projects into it (for details see below).</p>
+</div>
+<div class="sect3">
+<h4 id="_eclipse-installer"><a class="anchor" href="#_eclipse-installer"></a><a class="link" href="#_eclipse-installer">2.2.1. Eclipse Installer</a></h4>
+<div class="paragraph">
+<p>The recommended way to install the Eclipse IDE and set up the workspace is to use the Eclipse Installer.
+This installer is to be downloaded from <a href="https://wiki.eclipse.org/Eclipse_Installer" class="bare">https://wiki.eclipse.org/Eclipse_Installer</a></p>
+</div>
+<div class="paragraph">
+<p>Run the installer and apply the following steps:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>change to "Advance Mode" via the menu (upper-right corner) (no need to move the installer)</p>
+</li>
+<li>
+<p>select a product, e.g. "Eclipse IDE for Eclipse Committers" with product version "latest"</p>
+</li>
+<li>
+<p>double-click the entry <strong>Eclipse Projects/N4JS</strong> so that it is shown in the catalog view below</p>
+</li>
+<li>
+<p>on the next page, configure paths accordingly. You only have to configure the installation and workspace folder. You may want to use git with https instead of ssh.</p>
+</li>
+<li>
+<p>start installation</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>The installer will then guide you through the rest of the installation. All plug-ins are downloaded and configured automatically, so is the workspace including downloading the git repository and setting up the workspace.</p>
+</div>
+<div class="paragraph">
+<p>The workspace is configured automatically. This includes fetching the necessary git repository. If you have selected git with SSH you may run into problems. In this case you can re-run the scripts and select HTTPS instead, this should work in any case.</p>
+</div>
+<div class="paragraph">
+<p>Eventually the installer scripts are done, that means the git repository has been cloned and the workspace has been configured (including the project set setup).
+Now the automatic build kicks in as you can see in the status bar. Screenshot 6</p>
+</div>
+<div class="paragraph">
+<p>The build will show a lot of errors while still working. Eventually the whole project should have been compiled without any errors. Unfortunately, due to a <a href="https://github.com/eclipse/n4js/issues/1373">known issue</a>, two problems exists. Please have a look at the linked issue on how to fix that (it is quite easy).</p>
+</div>
+<div class="sect4">
+<h5 id="_changing-the-setup-script"><a class="anchor" href="#_changing-the-setup-script"></a><a class="link" href="#_changing-the-setup-script">2.2.1.1. Changing the Setup Script</a></h5>
+<div class="paragraph">
+<p>The setup scripts is stored at</p>
+</div>
+<div class="paragraph">
+<p><code>n4js/releng/org.eclipse.n4js.targetplatform/N4JS.setup</code></p>
+</div>
+<div class="paragraph">
+<p>Details about Oomph-Setup scripts can be found at</p>
+</div>
+<div class="paragraph">
+<p><a href="https://wiki.eclipse.org/Eclipse_Installer" class="bare">https://wiki.eclipse.org/Eclipse_Installer</a></p>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_manual-ide-configuration"><a class="anchor" href="#_manual-ide-configuration"></a><a class="link" href="#_manual-ide-configuration">2.2.2. Manual IDE Configuration</a></h4>
+<div class="admonitionblock warning">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-warning" title=""></i>
+</td>
+<td class="content">
+Manual IDE configuration is not recommended!
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>For a manual install, clone the code and import all top-level projects from the docs, features, plugins, releng, testhelpers, and tests folders. Activate the targetplatform contained in the <code>releng/org.eclipse.n4js.targetplatform/</code> project.</p>
+</div>
+<div class="paragraph">
+<p>The N4JS IDE is developed with Eclipse 2019-06 or better since the system is based on Eclipse anyway.
+It is almost impossible to use another IDE to develop Eclipse plugins. The list of required plugins includes:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Xtext/Xtend 2.18.0</p>
+</li>
+<li>
+<p>Xcore 1.9.0</p>
+</li>
+<li>
+<p>Xpect 0.2.0.201906240918 from <a href="https://ci.eclipse.org/xpect/job/Xpect-Integration-Release/20/artifact/org.eclipse.xpect.releng/p2-repository/target/repository/" class="bare">https://ci.eclipse.org/xpect/job/Xpect-Integration-Release/20/artifact/org.eclipse.xpect.releng/p2-repository/target/repository/</a></p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>It is important to use the latest version of Xtext and the corresponding service release of Xcore. You will find the latest version numbers and plugins used in the target platform definition at
+<a href="https://github.com/eclipse/n4js/blob/master/releng/org.eclipse.n4js.targetplatform/org.eclipse.n4js.targetplatform.target" class="bare">https://github.com/eclipse/n4js/blob/master/releng/org.eclipse.n4js.targetplatform/org.eclipse.n4js.targetplatform.target</a></p>
+</div>
+<div class="paragraph">
+<p>You may need to adjust some settings in Eclipse, most importantly</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><strong>Text file encoding</strong> to <code>Other: UTF-8</code> and</p>
+</li>
+<li>
+<p><strong>New text file line delimiter</strong> to <code>Unix</code> .</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div id="footer">
+<div id="footer-text">
+Version 0.9<br>
+Last updated 2019-08-07 15:02:40 CEST
+</div>
+</div>
+<!-- ************* docinfo-footer *************************************************************** -->
+<div class="Grid social" style="color:#d5dfea">
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <h2>Quick Links</h2>
+    <ul>
+      <li><a href="../downloads.html">Download</a></li>
+      <li><a href="../userguides/index.html">Documentation</a></li>
+      <li><a href="https://github.com/eclipse/n4js/">Source</a></li>
+      <li><a href="https://github.com/eclipse/n4js/issues">Issues</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="https://www.eclipse.org/forums/index.php/f/365/">Forum</a></li>
+      <li><a href="http://n4js.blogspot.de/">Blog</a></li>
+      <li><a href="https://dev.eclipse.org/mailman/listinfo/n4js-dev">Mailing List</a></li>
+      <li><a href="https://projects.eclipse.org/projects/technology.n4js">Eclipse Project Page</a></li>
+      <li><a href="https://twitter.com/n4jsdev">Tweets by n4jsdev</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="http://www.eclipse.org/">Eclipse Home</a></li>
+      <li><a href="http://www.eclipse.org/legal/privacy.php">Privacy Policy</a></li>
+      <li><a href="http://www.eclipse.org/legal/termsofuse.php">Terms of Use</a></li>
+      <li><a href="http://www.eclipse.org/legal/copyright.php">Copyright Agent</a></li>
+      <li><a href="http://www.eclipse.org/legal/">Legal</a></li>
+    </ul>
+  </div>
+  <div style="clear: both; height: 0; overflow: hidden;"></div>
+</div>
+
+<!-- ************* UI Scripts ************* -->
+<script type="text/javascript" src="scripts/back-to-top.js"></script>
+
+<script type="text/javascript" src="scripts/treeview.js"></script>
+<script type="text/javascript" src="scripts/toc.js"></script>
+
+<!-- ************* Prism.js Syntax Highlighting ************* -->
+<script src="scripts/prism.js"></script>
+
+<script type="text/javascript">
+	// Add the 'toclist' id for search function
+	$(".toc2 > ul").attr('id', 'toclist');
+	// Generate a Search input form
+	$("#toclist > li:first-of-type").before('<input type="text" id="pagesearch" onkeyup="search()" placeholder="Search for section...">');
+	$("#toclist > li:first-of-type").before('<i id="clear" class="fa fa-times-circle-o"></i>');
+	$("#clear").click(function(){
+	    $("#pagesearch").val('');
+	    search();
+	    $('.toc2 > ul').treeView('collapseAll');
+	});
+	// intialize Treeview.js
+	$(".toc2 > ul").treeView();
+	// Initialize Scrollspy
+</script>
+<!-- ************* docinfo-footer *************************************************************** -->
+</body>
+</html>
\ No newline at end of file
diff --git a/design/execution.html b/design/execution.html
new file mode 100644
index 0000000..20ec1ae
--- /dev/null
+++ b/design/execution.html
@@ -0,0 +1,1377 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="generator" content="Asciidoctor 1.5.5">
+<meta name="author" content="2019-08-07 15:02:40 CEST">
+<title>N4JS Design Specification</title>
+<link rel="stylesheet" href="styles/spec.min.css">
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.6.3/css/font-awesome.min.css">
+<!-- ************* docinfo ******************************************************************* -->
+
+
+<!-- ************* Favicon ************-->
+<link rel="icon" href="images/favicon.ico" />
+
+<!-- ************* Back-to-top JQuery ************* -->
+<script src="https://code.jquery.com/jquery-1.12.4.js"></script>
+<script src="https://code.jquery.com/ui/1.12.0/jquery-ui.js"></script>
+
+
+<link href="styles/prism.min.css" rel="stylesheet" />
+<script type="text/javascript" async
+  src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2/MathJax.js?config=TeX-MML-AM_CHTML">
+</script>
+
+<!-- ************* Styles ************* -->
+<link rel="stylesheet" type="text/css" href="styles/n4jsspec-adoc.css">
+
+
+<!-- ****************** NavBar ****************** -->
+<div id="menubar">
+	<div class="banner">
+        <a href="https://www.eclipse.org/n4js/#"><img id="logo" src="images/n4js-logo.png" alt="Eclipse N4JS"></a>
+    </div>
+<ul>
+  <li><a href="index.html">Index</a></li>
+</ul>
+</div>
+<!-- ************* docinfo ******************************************************************* -->
+<style>
+      .admonitionblock td.icon .icon-todo:before{content:"\f249";color:#f4ee42}
+    </style>
+</head>
+<body class="book toc2 toc-left">
+<div id="header">
+<h1>N4JS Design Specification</h1>
+<div class="details">
+<span id="author" class="author">2019-08-07 15:02:40 CEST</span><br>
+<span id="revnumber">version 0.9</span>
+</div>
+<div id="toc" class="toc2">
+<div id="toctitle">Table of Contents</div>
+<ul class="sectlevel1">
+<li><a href="introduction.html#_introduction">1. Introduction</a>
+<ul class="sectlevel2">
+<li><a href="introduction.html#notation">1.1. Notation</a></li>
+<li><a href="introduction.html#sec:IDE_Overview">1.2. IDE Components</a>
+<ul class="sectlevel3">
+<li><a href="introduction.html#sec:Naming_Conventions">1.2.1. Naming Conventions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="eclipse_setup.html#_eclipse-setup">2. Eclipse Setup</a>
+<ul class="sectlevel2">
+<li><a href="eclipse_setup.html#_system-requirements">2.1. System Requirements</a></li>
+<li><a href="eclipse_setup.html#_contribute">2.2. Contribute</a>
+<ul class="sectlevel3">
+<li><a href="eclipse_setup.html#_eclipse-installer">2.2.1. Eclipse Installer</a>
+<ul class="sectlevel4">
+<li><a href="eclipse_setup.html#_changing-the-setup-script">2.2.1.1. Changing the Setup Script</a></li>
+</ul>
+</li>
+<li><a href="eclipse_setup.html#_manual-ide-configuration">2.2.2. Manual IDE Configuration</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="release_engineering.html#_release-engineering">3. Release Engineering</a>
+<ul class="sectlevel2">
+<li><a href="release_engineering.html#_nightly-build-on-eclipse-infrastructure">3.1. Nightly build on Eclipse infrastructure</a></li>
+<li><a href="release_engineering.html#_build-the-n4js-ide-from-command-line">3.2. Build the N4JS IDE from command line</a>
+<ul class="sectlevel3">
+<li><a href="release_engineering.html#_publish-maven-tooling-code-org-eclipse-n4js-releng-util-code">3.2.1. Publish maven-tooling <code>org.eclipse.n4js.releng.util</code></a></li>
+<li><a href="release_engineering.html#sec:test-verdaccio">3.2.2. Test Verdaccio containing n4js-libs</a></li>
+<li><a href="release_engineering.html#_generation-of-eclipse-help-for-spec-and-design-document">3.2.3. Generation of Eclipse help for spec and design document</a></li>
+</ul>
+</li>
+<li><a href="release_engineering.html#_updating-frameworks-and-dependencies">3.3. Updating frameworks and dependencies</a>
+<ul class="sectlevel3">
+<li><a href="release_engineering.html#_update-of-eclipse-emf-xtext-etc">3.3.1. Update of Eclipse, EMF, Xtext, etc.</a></li>
+<li><a href="release_engineering.html#_update-of-the-embedded-jre">3.3.2. Update of the embedded JRE</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tips_and_tricks.html#_tips-and-tricks">4. Tips and Tricks</a>
+<ul class="sectlevel2">
+<li><a href="tips_and_tricks.html#_naming">4.1. Naming</a></li>
+<li><a href="tips_and_tricks.html#_logging">4.2. Logging</a></li>
+<li><a href="tips_and_tricks.html#_cancellation-handling">4.3. Cancellation Handling</a></li>
+<li><a href="tips_and_tricks.html#_caching">4.4. Caching</a></li>
+<li><a href="tips_and_tricks.html#_dependency-injection">4.5. Dependency Injection</a></li>
+<li><a href="tips_and_tricks.html#_miscellaneous">4.6. Miscellaneous</a></li>
+</ul>
+</li>
+<li><a href="parser.html#_parser">5. Parser</a>
+<ul class="sectlevel2">
+<li><a href="parser.html#sec:Parser_Overview">5.1. Overview</a></li>
+<li><a href="parser.html#sec:N4JS_Parser">5.2. N4JS Parser</a></li>
+<li><a href="parser.html#sec:Parser_Generation_Post_Processing">5.3. Parser Generation Post-Processing</a>
+<ul class="sectlevel3">
+<li><a href="parser.html#sec:Automatic_Semicolon_Insertion">5.3.1. Automatic Semicolon Insertion</a>
+<ul class="sectlevel4">
+<li><a href="parser.html#sec:Injected_code_in_the_Antlr_grammar_file">5.3.1.1. Injected code in the Antlr grammar file</a></li>
+<li><a href="parser.html#sec:Customized_error_recovery">5.3.1.2. Customized error recovery</a></li>
+</ul>
+</li>
+<li><a href="parser.html#sec:_No_line_terminator_allowed_here__handling">5.3.2. Async and <code>No line terminator allowed here</code> Handling</a></li>
+<li><a href="parser.html#sec:Regular_Expression">5.3.3. Regular Expression</a></li>
+<li><a href="parser.html#sec:Unicode">5.3.4. Unicode</a></li>
+<li><a href="parser.html#sec:Literals">5.3.5. Literals</a></li>
+</ul>
+</li>
+<li><a href="parser.html#sec:Modifiers">5.4. Modifiers</a></li>
+<li><a href="parser.html#sec:Conflict_Resolutions">5.5. Conflict Resolutions</a>
+<ul class="sectlevel3">
+<li><a href="parser.html#sec:Reserved_Keywords_vs__Identifier_Names">5.5.1. Reserved Keywords vs. Identifier Names</a></li>
+<li><a href="parser.html#sec:Operators_and_Generics">5.5.2. Operators and Generics</a></li>
+</ul>
+</li>
+<li><a href="parser.html#sec:Content_Assist_Parser">5.6. Content-Assist Parser</a></li>
+</ul>
+</li>
+<li><a href="type_system.html#_type-system">6. Type System</a>
+<ul class="sectlevel2">
+<li><a href="type_system.html#sec:Type_Model_and_Grammar">6.1. Type Model and Grammar</a>
+<ul class="sectlevel3">
+<li><a href="type_system.html#sec:Type_Model_Overview">6.1.1. Type Model Overview</a></li>
+<li><a href="type_system.html#sec:Built_in_Types">6.1.2. Built-in and Primitive Types</a></li>
+<li><a href="type_system.html#sec:Type_Model_DSL">6.1.3. Type Model DSL</a></li>
+</ul>
+</li>
+<li><a href="type_system.html#sec:Type_System_Implementation">6.2. Type System Implementation</a></li>
+<li><a href="type_system.html#sec:Type_Inference_combined_with_AST_Traversal">6.3. Type Inference of AST</a>
+<ul class="sectlevel3">
+<li><a href="type_system.html#sec:Type_Inference_combined_with_AST_Traversal__Background">6.3.1. Background</a></li>
+<li><a href="type_system.html#sec:Triggering_Type_Inference_of_AST">6.3.2. Triggering</a></li>
+<li><a href="type_system.html#sec:Traversal_Order_During_Type_Inference_of_AST">6.3.3. Traversal Order</a></li>
+<li><a href="type_system.html#sec:Cross_References_During_Type_Inference_of_AST">6.3.4. Cross-References</a></li>
+<li><a href="type_system.html#sec:Function_Accessor_Bodies_During_Type_Inference_of_AST">6.3.5. Function/Accessor Bodies</a></li>
+<li><a href="type_system.html#sec:Poly_Expressions_During_Type_Inference_of_AST">6.3.6. Poly Expressions</a></li>
+<li><a href="type_system.html#sec:Constraint_Solver_used_During_Type_Inference_of_AST">6.3.7. Constraint Solver</a></li>
+<li><a href="type_system.html#sec:Type_Guards_During_Type_Inference_of_AST">6.3.8. Type Guards</a></li>
+</ul>
+</li>
+<li><a href="type_system.html#sec:Structural_Typing">6.4. Structural Typing</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#_type-index">7. Type Index</a>
+<ul class="sectlevel2">
+<li><a href="type_index.html#sec:Type_Index_Design_Rationale">7.1. Design Rationale</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#sec:Getting_the_Xtext_Index_Content_IResourceDescriptions">7.1.1. Getting the Xtext Index (<code>IResourceDescriptions</code>) Content</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#sec:Design_Overview">7.2. Design Overview</a></li>
+<li><a href="type_index.html#sec:N4JS_Resource_Load_States">7.3. N4JS Resource Load States</a></li>
+<li><a href="type_index.html#sec:Type_Builder">7.4. Types Builder</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#sec:Type_Inference_not_allowed_in_Type_Builder">7.4.1. Type Inference not allowed in Types Builder</a></li>
+<li><a href="type_index.html#sec:ComputedTypeReferences">7.4.2. Deferred Type References</a></li>
+<li><a href="type_index.html#sec:Use_cases_of_ComputedTypeRef">7.4.3. Use cases of DeferredTypeRef</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#sec:Incremental_Builder_Overview">7.5. Incremental Builder (Overview)</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#sec:Incremental_Builder_Overview__XtextBuilder">7.5.1. XtextBuilder</a></li>
+<li><a href="type_index.html#sec:Incremental_Builder_Overview__IBuilderState">7.5.2. IBuilderState</a>
+<ul class="sectlevel4">
+<li><a href="type_index.html#copy-and-update-xtext-index">7.5.2.1. Copy and Update Xtext Index</a></li>
+<li><a href="type_index.html#build-state-setup-phase">7.5.2.2. Build State Setup Phase</a></li>
+<li><a href="type_index.html#process-queued-uris">7.5.2.3. Process Queued URIs</a></li>
+<li><a href="type_index.html#queueing-affected-resources">7.5.2.4. Queueing Affected Resources</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#sec:Incremental_Builder_Overview__Example">7.5.3. Example</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#dirty-state-handling">7.6. Dirty state handling</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#use-case-restoring-types-from-user-data">7.6.1. Use case: Restoring types from user data</a></li>
+<li><a href="type_index.html#use-case-updating-the-xtext-index">7.6.2. Use case: Updating the Xtext index</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="project_model.html#_project-model">8. Project Model</a>
+<ul class="sectlevel2">
+<li><a href="project_model.html#sec:Package_json">8.1. Package.json File</a></li>
+<li><a href="project_model.html#_accessing-project-information">8.2. Accessing Project Information</a>
+<ul class="sectlevel3">
+<li><a href="project_model.html#sec:IN4JSCore">8.2.1. IN4JSCore</a></li>
+<li><a href="project_model.html#sec:N4JSModel">8.2.2. N4JSModel</a></li>
+<li><a href="project_model.html#sec:N4JSWorkspace">8.2.3. N4JSWorkspace</a></li>
+<li><a href="project_model.html#sec:N4JSProject">8.2.4. N4JSProject</a></li>
+<li><a href="project_model.html#sec:SourceContainer">8.2.5. SourceContainer</a></li>
+<li><a href="project_model.html#sec:N4JSProjectsStateHelper">8.2.6. N4JSProjectsStateHelper</a></li>
+</ul>
+</li>
+<li><a href="project_model.html#sec:Caching">8.3. Caching</a>
+<ul class="sectlevel3">
+<li><a href="project_model.html#_caching-of-externallibraryworkspace">8.3.1. Caching of ExternalLibraryWorkspace</a></li>
+<li><a href="project_model.html#_caching-of-n4jsprojectsstatehelper">8.3.2. Caching of N4JSProjectsStateHelper</a></li>
+</ul>
+</li>
+<li><a href="project_model.html#sec:WildcardPathFilter">8.4. WildcardPathFilter</a></li>
+<li><a href="project_model.html#sec:ProjectUtils">8.5. ProjectUtils</a></li>
+</ul>
+</li>
+<li><a href="binding.html#_binding">9. Binding</a>
+<ul class="sectlevel2">
+<li><a href="binding.html#sec:Binding_Design_Rationale">9.1. Design Rationale</a></li>
+<li><a href="binding.html#sec:Binding_to_Members">9.2. Binding to Members</a></li>
+<li><a href="binding.html#sec:Binding_Getter_Setter">9.3. Getter / Setter Binding</a></li>
+<li><a href="binding.html#chap:Statics">9.4. Static Member Binding</a></li>
+<li><a href="binding.html#sec:Binding_Enumeration">9.5. Enumeration Literals Binding</a></li>
+<li><a href="binding.html#sec:Accessibility_of_types_and_members">9.6. Accessibility of types and members</a></li>
+<li><a href="binding.html#sec:Member_Scope_Example">9.7. Member Scope Example</a></li>
+<li><a href="binding.html#sec:Scoping_for_Members_of_Composed_Type_Explained">9.8. Scoping for Members of Composed Type (Union/Intersection) Example</a></li>
+<li><a href="binding.html#sec:Binding_of_Structurally_References_Types">9.9. Structurally References Types</a></li>
+<li><a href="binding.html#sec:Building">9.10. Building</a>
+<ul class="sectlevel3">
+<li><a href="binding.html#sec:Build_Phases">9.10.1. Build Phases</a></li>
+<li><a href="binding.html#sec:Build_Scenarios">9.10.2. Build Scenarios</a></li>
+<li><a href="binding.html#sec:Lazy_linking_problem">9.10.3. Lazy linking problem</a></li>
+</ul>
+</li>
+<li><a href="binding.html#sec:Proxies_and_Proxy_Resolution">9.11. Proxies and Proxy Resolution (Overview)</a>
+<ul class="sectlevel3">
+<li><a href="binding.html#xtexts-lazy-linking-proxies">9.11.1. Xtext’s Lazy Linking Proxies</a></li>
+<li><a href="binding.html#standard-emf-proxies">9.11.2. Standard EMF Proxies</a></li>
+<li><a href="binding.html#_how-is-proxy-resolution-triggered">9.11.3. How is Proxy Resolution Triggered?</a></li>
+<li><a href="binding.html#_when-is-proxy-resolution-allowed">9.11.4. When is Proxy Resolution Allowed?</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="validation.html#_validation">10. Validation</a>
+<ul class="sectlevel2">
+<li><a href="validation.html#sec:validation_overview">10.1. Validation overview</a></li>
+<li><a href="validation.html#sec:validation_control_flow">10.2. Validation control flow</a></li>
+<li><a href="validation.html#sec:validation_issue_ids">10.3. Issue IDs and Messages</a></li>
+<li><a href="validation.html#sec:validation_usage_patterns">10.4. Usage Pattern</a></li>
+<li><a href="validation.html#sec:validation_links">10.5. Links</a></li>
+</ul>
+</li>
+<li><a href="references.html#_references">11. References</a>
+<ul class="sectlevel2">
+<li><a href="references.html#sec:usecases">11.1. Use cases</a></li>
+<li><a href="references.html#sec:calculation_algorithm">11.2. Calculation algorithm</a>
+<ul class="sectlevel3">
+<li><a href="references.html#sec:Xtext_default_implementation">11.2.1. Xtext default implementation</a></li>
+<li><a href="references.html#sec:N4_implementation">11.2.2. N4JS implementation</a></li>
+</ul>
+</li>
+<li><a href="references.html#sec:PerformanceOfDependencyCalculation">11.3. Performance Of Dependency Calculation</a></li>
+<li><a href="references.html#sec:kinds_of_references">11.4. Kinds of references</a>
+<ul class="sectlevel3">
+<li><a href="references.html#sec:Cross_References_to_be_ignored">11.4.1. Cross References to be ignored</a></li>
+<li><a href="references.html#sec:Cross_References_to_be_handled">11.4.2. Cross References to be handled</a></li>
+</ul>
+</li>
+<li><a href="references.html#sec:transitive_dependencies">11.5. Transitive dependencies</a></li>
+<li><a href="references.html#sec:find-references">11.6. Find references</a>
+<ul class="sectlevel3">
+<li><a href="references.html#_background">11.6.1. Background</a></li>
+<li><a href="references.html#_how-find-references-work">11.6.2. How Find References Work</a>
+<ul class="sectlevel4">
+<li><a href="references.html#_step-1-convert-cursor-position-to-declared-element">11.6.2.1. Step 1: Convert Cursor Position to Declared Element</a></li>
+<li><a href="references.html#_step-2-convert-declared-element-to-target-uris">11.6.2.2. Step 2: Convert Declared Element to Target URIs</a></li>
+<li><a href="references.html#_step-3-filter-potential-resources">11.6.2.3. Step 3: Filter Potential Resources</a></li>
+<li><a href="references.html#_step-4-search-references-in-resource">11.6.2.4. Step 4: Search References in Resource</a></li>
+<li><a href="references.html#_limitations-and-possible-enhancements">11.6.2.5. Limitations and Possible Enhancements</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="compilation.html#_compilation">12. Compilation</a>
+<ul class="sectlevel2">
+<li><a href="compilation.html#chap:compilation">12.1. Introduction</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:general_design_rationals">12.1.1. General design rationals</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:logging_and_error_reporting">12.1.1.1. Logging and error reporting</a></li>
+<li><a href="compilation.html#sec:progress_monitor">12.1.1.2. Progress monitor</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Xtext_Integration">12.1.2. Xtext Integration</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:xtext_default_behaviour">12.1.2.1. Xtext default behaviour</a></li>
+<li><a href="compilation.html#sec:n4js_requirements">12.1.2.2. N4JS requirements</a></li>
+<li><a href="compilation.html#sec:compiler_discovery_in_ui">12.1.2.3. Compiler discovery in UI</a></li>
+<li><a href="compilation.html#sec:compiler_discovery_in_headless">12.1.2.4. Compiler discovery in headless</a></li>
+<li><a href="compilation.html#sec:general_generator_implementation">12.1.2.5. General generator implementation</a></li>
+<li><a href="compilation.html#sec:general_generator_activation">12.1.2.6. General generator activation</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Overview_of_Input_Models">12.1.3. Overview of the Input Models</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Core_Generator">12.2. Generators</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:Compiler_Components">12.2.1. Generator Components</a></li>
+<li><a href="compilation.html#sec:Generator_architecture">12.2.2. Generator architecture</a></li>
+<li><a href="compilation.html#sec:Unified_Compiler_Configuration">12.2.3. Unified Compiler Configuration</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Transpilers">12.3. Transpilers</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:Phases">12.3.1. Overview</a></li>
+<li><a href="compilation.html#relation-between-ast-and-im">12.3.2. Relation between AST and IM</a></li>
+<li><a href="compilation.html#implementation-overview">12.3.3. Implementation Overview</a></li>
+<li><a href="compilation.html#sec:Guidelines_for_Implementing_Transformations">12.3.4. Guidelines for Implementing Transformations</a></li>
+<li><a href="compilation.html#symbol-table-in-the-im">12.3.5. Symbol Table in the IM</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:N4JS_to_EcmaScript_Transpiler">12.4. N4JS-to-EcmaScript Transpiler</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:Overview_of_Transformations">12.4.1. Overview of Transformations</a></li>
+<li><a href="compilation.html#sec:Transpiling_members">12.4.2. Transpiling members</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:Transpiling_members__Delegating_members">12.4.2.1. Techniques for special member handling</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__Partial_shadowing_of_getter_setter_pairs">12.4.2.2. Partial shadowing</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__Consuming_or_inheriting_members_of_an_interface">12.4.2.3. Consuming or inheriting members of an interface</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__Static_polyfill">12.4.2.4. Static polyfill</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__API_implementation_stubs">12.4.2.5. API / implementation stubs</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Support_for_incomplete_API_implementation_testing_in_the_N4JS_to_EcmaScript_5_Transpiler">12.4.3. Support for incomplete API implementation testing</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:Modifications_in_Impl_projects">12.4.3.1. Modifications in Impl projects</a></li>
+<li><a href="compilation.html#sec:Implementation_of_stub_generation">12.4.3.2. Implementation of stub-generation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:n4jsc_Headless_Compiler_Interface">12.5. n4jsc Headless Compiler Interface</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:building_the_headless_compiler">12.5.1. building the headless compiler</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#_execution">13. Execution</a>
+<ul class="sectlevel2">
+<li><a href="#sec:N4JS_Project_Execution_And_Linking_Model">13.1. N4JS Project Execution And Linking Model</a>
+<ul class="sectlevel3">
+<li><a href="#subsec:N4JS_Execution_With_NodeJS">13.1.1. N4JS Execution With NodeJS</a></li>
+</ul>
+</li>
+<li><a href="#sec:N4JS_Execution_And_Linking_File">13.2. N4JS Execution And Linking File</a>
+<ul class="sectlevel3">
+<li><a href="#subsec:NodeJS_Specific_ELF">13.2.1. NodeJS Specific ELF</a></li>
+</ul>
+</li>
+<li><a href="#sec:Runners-execution">13.3. Runners</a>
+<ul class="sectlevel3">
+<li><a href="#subsec:N4_Runtime_Environments_Convention">13.3.1. N4 Runtime Environments Convention</a></li>
+<li><a href="#subsec:Passing_Information_from_IDE_to_Execution_Code_in_Runtime_Environment">13.3.2. Passing Information from IDE to Execution Code in Runtime Environment</a></li>
+<li><a href="#subsec:Runners_Design">13.3.3. Runners Design</a></li>
+</ul>
+</li>
+<li><a href="#sec:Legacy_Execution_Engine">13.4. Legacy Execution Engine</a></li>
+<li><a href="#sec:Design">13.5. Design</a>
+<ul class="sectlevel3">
+<li><a href="#sec:Usage_Outside_N4JSIDE">13.5.1. Usage Outside N4JSIDE</a>
+<ul class="sectlevel4">
+<li><a href="#sec:Use_Node_with_Maven">13.5.1.1. Use Node with Maven</a></li>
+</ul>
+</li>
+<li><a href="#sec:Usage_Inside_N4JSIDE">13.5.2. Usage Inside N4JSIDE</a></li>
+</ul>
+</li>
+<li><a href="#sec:Runtime_Injection">13.6. Runtime Injection</a>
+<ul class="sectlevel3">
+<li><a href="#sec:Running_String_Code">13.6.1. Running String Code</a></li>
+<li><a href="#sec:Running_File_Code">13.6.2. Running File Code</a></li>
+<li><a href="#sec:Injection_Code_Example">13.6.3. Injection Code Example</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#_tests">14. Tests</a>
+<ul class="sectlevel2">
+<li><a href="tests.html#sec:Performance_Tests">14.1. Performance Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Synthetic_Performance_Tests">14.1.1. Synthetic Performance Tests</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:Design_of_Generator">14.1.1.1. Design of Generator</a></li>
+<li><a href="tests.html#sec:Design_of_Performance_Test_Execution">14.1.1.2. Design of Performance Test Configuration and Execution</a></li>
+<li><a href="tests.html#sec:JUnit_Configuration">14.1.1.3. JUnit Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Test_Configuration">14.1.1.4. JUnitBenchmark Test Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Report_Configuration">14.1.1.5. JUnitBenchmark Report Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Run_Configuration">14.1.1.6. JUnitBenchmark Run Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Example">14.1.1.7. JUnitBenchmark Example</a></li>
+<li><a href="tests.html#sec:Note_on_Jenkins_Job">14.1.1.8. Note on Jenkins Job</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#sec:ECMA_Tests">14.2. ECMA Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Grammar_Tests">14.2.1. Grammar Tests</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:Negative_Tests">14.2.1.1. Negative Tests</a></li>
+<li><a href="tests.html#sec:Test_Exclusion">14.2.1.2. Test Exclusion</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Integration_Tests">14.3. Integration Tests</a></li>
+<li><a href="tests.html#sec:Test_Helpers">14.4. Test Helpers</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Parameterized_N4JS_Tests">14.4.1. Parameterized N4JS tests</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:ParameterizedXtextRunner">14.4.1.1. ParameterizedXtextRunner</a></li>
+<li><a href="tests.html#sec:TestCodeProvider">14.4.1.2. TestCodeProvider</a></li>
+<li><a href="tests.html#sec:Example_Of_Parameterized_Parser_Test">14.4.1.3. Example of parameterized parser test</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Issue_Suppression">14.5. Issue Suppression</a></li>
+<li><a href="tests.html#sec:Xpect_Tests">14.6. Xpect Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Xpect_Test_Setup">14.6.1. Xpect Test Setup</a></li>
+<li><a href="tests.html#sec:Xpect_Issue_Suppression">14.6.2. Xpect Issue Suppression</a></li>
+<li><a href="tests.html#sec:Xpect_Provided_Test_Methods">14.6.3. Xpect Provided Test Methods</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#errors">14.6.3.1. errors</a></li>
+<li><a href="tests.html#warnings">14.6.3.2. warnings</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:N4JS_Specific_Xpect_Test_Methods">14.6.4. N4JS Specific Xpect Test Methods</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:XPECT_noerrors">14.6.4.1. noerrors and nowarnings</a></li>
+<li><a href="tests.html#sec:XPECT_scope">14.6.4.2. scope</a></li>
+<li><a href="tests.html#sec:XPECT_scopeWithPosition">14.6.4.3. scopeWithPosition</a></li>
+<li><a href="tests.html#sec:XPECT_scopeWithResource">14.6.4.4. scopeWithResource</a></li>
+<li><a href="tests.html#sec:XPECT_binding">14.6.4.5. binding</a></li>
+<li><a href="tests.html#sec:XPECT_linkedPathname">14.6.4.6. linkedPathname</a></li>
+<li><a href="tests.html#sec:XPECT_type_of">14.6.4.7. type of</a></li>
+<li><a href="tests.html#sec:XPECT_expectedType">14.6.4.8. expectedType</a></li>
+<li><a href="tests.html#sec:XPECT_elementKeyword">14.6.4.9. elementKeyword</a></li>
+<li><a href="tests.html#sec:XPECT_accessModifier">14.6.4.10. accessModifier</a></li>
+<li><a href="tests.html#sec:XPECT_compileResult">14.6.4.11. compileResult</a></li>
+<li><a href="tests.html#sec:XPECT_output">14.6.4.12. output</a></li>
+<li><a href="tests.html#sec:XPECT_outputRegEx">14.6.4.13. outputRegEx</a></li>
+<li><a href="tests.html#sec:XPECT_calculatedAccessModifier">14.6.4.14. calculatedAccessModifier</a></li>
+<li><a href="tests.html#sec:XPECT_spec">14.6.4.15. spec</a></li>
+<li><a href="tests.html#sec:XPECT_deadCode">14.6.4.16. deadCode</a></li>
+<li><a href="tests.html#sec:XPECT_returnOrThrows">14.6.4.17. returnOrThrows</a></li>
+<li><a href="tests.html#sec:XPECT_lint">14.6.4.18. lint</a></li>
+<li><a href="tests.html#sec:XPECT_lintFails">14.6.4.19. lintFails</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:FIXME_Xpect_modifier">14.6.5. FIXME Xpect modifier</a></li>
+<li><a href="tests.html#sec:Expectmatrix_Xpect_Test_Methods">14.6.6. Expectmatrix Xpect tests</a></li>
+<li><a href="tests.html#xpect-lint-tests">14.6.7. Xpect Lint Tests</a></li>
+</ul>
+</li>
+<li><a href="tests.html#xpect-proposal-tests">14.7. Xpect Proposal Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Validation_vs__Non_Validation">14.7.1. Validation vs. Non-Validation</a></li>
+<li><a href="tests.html#sec:General_Proposal_Test_Features">14.7.2. General Proposal Test Features</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:Test_Variables">14.7.2.1. Test Variables</a></li>
+<li><a href="tests.html#sec:Location_and_Selection">14.7.2.2. at – Location and Selection</a></li>
+<li><a href="tests.html#sec:Multi_Line_Expectations_in_Proposal_Tests">14.7.2.3. Multi Line Expectations in Proposal Tests</a></li>
+<li><a href="tests.html#sec:Timeout">14.7.2.4. Timeout and Performance</a></li>
+</ul>
+</li>
+<li><a href="tests.html#proposals-verify-existence-of-proposals">14.7.3. proposals – Verify Existence of Proposals</a></li>
+<li><a href="tests.html#sec:Verify_displayed_string">14.7.4. display – Verify displayed string</a></li>
+<li><a href="tests.html#sec:Apply_Proposal">14.7.5. apply – Apply Proposal</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#resource-application-in-other-files">14.7.5.1. resource – application in other files</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Content_Assist_Cycling">14.7.6. kind – Content Assist Cycling</a></li>
+<li><a href="tests.html#fileValidVerify-validation-status">14.7.7. fileValid – Verify validation status</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Apply_Proposal_And_Execute_Tests">14.8. Apply Proposal And Execute Tests</a></li>
+<li><a href="tests.html#sec:Organize_Imports_Test">14.9. Organize Imports Test</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#organizeimports">14.9.1. organizeImports</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Access_Control_Test">14.10. Access Control Test</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#test-scenarios">14.10.1. Test Scenarios</a></li>
+<li><a href="tests.html#n4js-code-generator">14.10.2. N4JS Code Generator</a></li>
+<li><a href="tests.html#xtext-issue-matcher">14.10.3. Xtext Issue Matcher</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Smoke_Tests">14.11. Smoke Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#how-to-handle-smoke-test-errors">14.11.1. How to handle smoke test errors?</a></li>
+<li><a href="tests.html#smoketester-and-exceptionanalyzer">14.11.2. SmokeTester and ExceptionAnalyzer</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:UI_Tests_with_SWTBot">14.12. UI Tests with SWTBot</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#writing-swtbot-tests">14.12.1. Writing SWTBot Tests</a></li>
+<li><a href="tests.html#running-swtbot-tests">14.12.2. Running SWTBot Tests</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Debugging_UI_Tests">14.13. Debugging UI Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Connecting_to_the_X_server_on_the_build_node">14.13.1. Connecting to the X-server on the build-node</a></li>
+<li><a href="tests.html#sec:Tools_to_investigate_the_java_stack">14.13.2. Tools to investigate the java-stack</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="ui_concepts.html#_ui-concepts">15. UI Concepts</a>
+<ul class="sectlevel2">
+<li><a href="ui_concepts.html#sec:User_Interface_Concepts">15.1. User Interface Concepts</a>
+<ul class="sectlevel3">
+<li><a href="ui_concepts.html#sec:Eclipse_UI_Concepts">15.1.1. Eclipse UI Concepts</a>
+<ul class="sectlevel4">
+<li><a href="ui_concepts.html#sec:Label_Provider">15.1.1.1. Label Provider</a></li>
+<li><a href="ui_concepts.html#sec:Markers">15.1.1.2. Markers</a></li>
+<li><a href="ui_concepts.html#sec:Commands__Toolbar_and_Menus">15.1.1.3. Commands, Toolbar and Menus</a></li>
+<li><a href="ui_concepts.html#sec:Content_Assist">15.1.1.4. Content Assist</a></li>
+<li><a href="ui_concepts.html#sec:Quick_Fixes">15.1.1.5. Quick Fixes</a></li>
+<li><a href="ui_concepts.html#sec:Quick_Assist">15.1.1.6. Quick Assist</a></li>
+<li><a href="ui_concepts.html#sec:Clean_Up_Actions">15.1.1.7. Clean Up Actions</a></li>
+<li><a href="ui_concepts.html#sec:Save_Actions">15.1.1.8. Save Actions</a></li>
+<li><a href="ui_concepts.html#sec:Auto_Edit">15.1.1.9. Auto Edit</a></li>
+<li><a href="ui_concepts.html#sec:Template_Proposals">15.1.1.10. Template Proposals</a></li>
+<li><a href="ui_concepts.html#sec:Outline_View___Quick_Outline">15.1.1.11. Outline View / Quick Outline</a></li>
+<li><a href="ui_concepts.html#sec:Navigator__Package_Explorer__Project_Explorer">15.1.1.12. Navigator, Package Explorer, Project Explorer</a></li>
+<li><a href="ui_concepts.html#sec:Hyperlinking_and_Navigation">15.1.1.13. Hyperlinking and Navigation</a></li>
+<li><a href="ui_concepts.html#sec:Syntax_and_Semantic_Coloring">15.1.1.14. Syntax and Semantic Coloring</a></li>
+<li><a href="ui_concepts.html#sec:Code_Formatter">15.1.1.15. Code Formatter</a></li>
+<li><a href="ui_concepts.html#sec:Wizards">15.1.1.16. Wizards</a></li>
+<li><a href="ui_concepts.html#sec:Cheat_Sheets">15.1.1.17. Cheat Sheets</a></li>
+<li><a href="ui_concepts.html#sec:Context_sensitive_Help">15.1.1.18. Context-sensitive Help</a></li>
+<li><a href="ui_concepts.html#sec:Hovers">15.1.1.19. Hovers</a></li>
+<li><a href="ui_concepts.html#sec:Folding">15.1.1.20. Folding</a></li>
+<li><a href="ui_concepts.html#sec:Customizable_validation___severity">15.1.1.21. Customizable validation / severity</a></li>
+<li><a href="ui_concepts.html#sec:Proposals">15.1.1.22. Proposals</a></li>
+</ul>
+</li>
+<li><a href="ui_concepts.html#sec:Non_Eclipse_UI_Concepts">15.1.2. Non-Eclipse UI Concepts</a>
+<ul class="sectlevel4">
+<li><a href="ui_concepts.html#sec:Overlays">15.1.2.1. Overlays</a></li>
+<li><a href="ui_concepts.html#sec:Goto__Inferred__Type">15.1.2.2. Goto (Inferred) Type</a></li>
+<li><a href="ui_concepts.html#sec:Postfix_Completion">15.1.2.3. Postfix Completion</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="ui_concepts.html#_user-interface-resources">15.2. User Interface Resources</a>
+<ul class="sectlevel3">
+<li><a href="ui_concepts.html#_icons">15.2.1. Icons</a>
+<ul class="sectlevel4">
+<li><a href="ui_concepts.html#_eclipse-platform-icons">15.2.1.1. Eclipse Platform Icons</a></li>
+<li><a href="ui_concepts.html#_n4js-specific-icons">15.2.1.2. N4JS Specific Icons</a></li>
+<li><a href="ui_concepts.html#_high-resolution-icons">15.2.1.3. High Resolution Icons</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="formatting.html#_formatting">16. Formatting</a>
+<ul class="sectlevel2">
+<li><a href="formatting.html#sec:FmtObjective">16.1. Objective</a>
+<ul class="sectlevel3">
+<li><a href="formatting.html#sec:FmtFormatting_Comments">16.1.1. Formatting Comments</a></li>
+</ul>
+</li>
+<li><a href="formatting.html#sec:FmtArchitecture">16.2. Architecture</a>
+<ul class="sectlevel3">
+<li><a href="formatting.html#sec:Implementation_example">16.2.1. Implementation example</a></li>
+</ul>
+</li>
+<li><a href="formatting.html#sec:FmtFormatter_Implementation_Guidelines">16.3. Formatter Implementation Guidelines</a></li>
+<li><a href="formatting.html#sec:FmtConfiguration">16.4. Configuration</a></li>
+<li><a href="formatting.html#sec:FmtUI_Integration">16.5. UI Integration</a></li>
+<li><a href="formatting.html#sec:FmtUnit_Testing_with_Xpect">16.6. Unit Testing with Xpect</a></li>
+</ul>
+</li>
+<li><a href="external_libraries.html#_external-libraries">17. External Libraries</a>
+<ul class="sectlevel2">
+<li><a href="external_libraries.html#sec:Major_Components">17.1. Major Components</a>
+<ul class="sectlevel3">
+<li><a href="external_libraries.html#subsec:External_Resources">17.1.1. External Resources</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Workspace">17.1.2. External Library Workspace</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Preference_Store">17.1.3. External Library Preference Store</a></li>
+<li><a href="external_libraries.html#subsec:npm_Manager">17.1.4. Library Manager</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Builder_Helper">17.1.5. External Library Builder</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Xtext_Index_Persister">17.1.6. External Library Xtext Index Persister</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Preference_Page">17.1.7. External Library Preference Page</a></li>
+</ul>
+</li>
+<li><a href="external_libraries.html#sec:Headless_External_Library_Support">17.2. Headless External Library Support</a>
+<ul class="sectlevel3">
+<li><a href="external_libraries.html#_custom-npm-settings">17.2.1. Custom npm settings</a></li>
+</ul>
+</li>
+<li><a href="external_libraries.html#sec:lmFutureWork">17.3. Future Work</a>
+<ul class="sectlevel3">
+<li><a href="external_libraries.html#subsec:lmMultipleDependencyScope">17.3.1. Multiple Dependency Scope</a></li>
+<li><a href="external_libraries.html#subsec:lmRunTestsFromLibrary">17.3.2. Run Tests from TestLibrary</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="json_support.html#sec:JSON_Support">18. JSON Support</a>
+<ul class="sectlevel2">
+<li><a href="json_support.html#sec:JSON_Parser">18.1. JSON Parser</a>
+<ul class="sectlevel3">
+<li><a href="json_support.html#sec:JSON_Parser_Unicode_Escaping">18.1.1. Escaping Unicode Control Characters in String Literals</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Empty_Text">18.1.2. Empty Text</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Nested_Structures">18.1.3. Nested Structures</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Whitespace">18.1.4. Whitespace</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Comments">18.1.5. Comments</a></li>
+</ul>
+</li>
+<li><a href="json_support.html#sec:JSON_Language_Extensions">18.2. JSON Language Extensions</a>
+<ul class="sectlevel3">
+<li><a href="json_support.html#sec:JSON_Validator_Extensions">18.2.1. JSON Validator Extensions</a>
+<ul class="sectlevel4">
+<li><a href="json_support.html#sec:File_Specitic_Validator_Extensions">18.2.1.1. File-Specific Validator Extensions</a></li>
+<li><a href="json_support.html#sec:JSON_Declarative_JSON_Validator_Extensions">18.2.1.2. Declarative JSON Validator Extensions</a></li>
+</ul>
+</li>
+<li><a href="json_support.html#_json-resource-description-strategy">18.2.2. JSON Resource Description Strategy</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_jsdoc">19. JSDoc</a>
+<ul class="sectlevel2">
+<li><a href="jsdoc.html#sec:Design_Rationale">19.1. Design Rationale</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#_general-design">19.1.1. General Design</a></li>
+<li><a href="jsdoc.html#sec:Type_Expressions">19.1.2. Type Expressions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="docexporter.html#_docexporter">20. DocExporter</a>
+<ul class="sectlevel2">
+<li><a href="docexporter.html#sec:Specification_Exporter">20.1. Specification Exporter</a></li>
+</ul>
+</li>
+<li><a href="rename_refactoring.html#_rename-refactoring">21. Rename Refactoring</a>
+<ul class="sectlevel2">
+<li><a href="rename_refactoring.html#_rename-refactoring-ui-interaction">21.1. Rename Refactoring UI interaction</a></li>
+<li><a href="rename_refactoring.html#_renameelementprocessor-interaction">21.2. RenameElementProcessor interaction</a></li>
+</ul>
+</li>
+<li><a href="flow_graphs.html#chap:flowgraphs">22. Flow Graphs</a>
+<ul class="sectlevel2">
+<li><a href="flow_graphs.html#sec:flowgraphs_overview">22.1. Flow graphs overview</a>
+<ul class="sectlevel3">
+<li><a href="flow_graphs.html#_internal-graph">22.1.1. Internal graph</a></li>
+<li><a href="flow_graphs.html#_optimizations">22.1.2. Optimizations</a></li>
+<li><a href="flow_graphs.html#_api-for-client-analyses">22.1.3. API for client analyses</a>
+<ul class="sectlevel4">
+<li><a href="flow_graphs.html#_mapping-from-internal-to-ast-elements">22.1.3.1. Mapping from internal to AST elements</a></li>
+<li><a href="flow_graphs.html#_graph-visitor">22.1.3.2. Graph visitor</a></li>
+<li><a href="flow_graphs.html#_graph-explorer">22.1.3.3. Graph explorer</a></li>
+<li><a href="flow_graphs.html#_branch-walker">22.1.3.4. Branch walker</a></li>
+<li><a href="flow_graphs.html#_example-1-compute-string-for-each-path">22.1.3.5. Example 1: Compute string for each path</a></li>
+<li><a href="flow_graphs.html#_path-quantor">22.1.3.6. Path quantor</a></li>
+</ul>
+</li>
+<li><a href="flow_graphs.html#_control-flow-analyses">22.1.4. Control flow analyses</a>
+<ul class="sectlevel4">
+<li><a href="flow_graphs.html#_dead-code-analysis">22.1.4.1. Dead code analysis</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="flow_graphs.html#sec:dataflow">22.2. Dataflow</a>
+<ul class="sectlevel3">
+<li><a href="flow_graphs.html#_dataflow-graph">22.2.1. Dataflow graph</a></li>
+<li><a href="flow_graphs.html#_dataflow-analyses">22.2.2. Dataflow analyses</a>
+<ul class="sectlevel4">
+<li><a href="flow_graphs.html#_def-def-def-nothing-analysis">22.2.2.1. Def&#8594;Def / Def&#8594;Nothing analysis</a></li>
+<li><a href="flow_graphs.html#_def-use-decl-analysis">22.2.2.2. Def|Use&#8592;Decl analysis</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="publish_npms.html#sec:publish-npms-to-public">23. Publish npms</a>
+<ul class="sectlevel2">
+<li><a href="publish_npms.html#sec:publish-npms-n4js-maven">23.1. Publish n4js-libs to during  maven build</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Hints">Appendix A: Hints</a>
+<ul class="sectlevel2">
+<li><a href="appendix_a_hints.html#sec:XtextInjection">A.1. Xtext Injection</a>
+<ul class="sectlevel3">
+<li><a href="appendix_a_hints.html#sec:DI_MultipleInjectors_Singletons">A.1.1. Multiple Injectors and Singletons</a>
+<ul class="sectlevel4">
+<li><a href="appendix_a_hints.html#sec:DI_avoid_duplicate_singletons">A.1.1.1. Avoiding duplicate singletons</a>
+<ul class="sectlevel5">
+<li><a href="appendix_a_hints.html#sec:DI_binding_in_shared">A.1.1.1.1. Defining binding in the shared injector</a></li>
+<li><a href="appendix_a_hints.html#sec:DI_binding_in_custom">A.1.1.1.2. Defining binding in the custom injector</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:DI_Hints">A.1.2. Dependency Injection Hints</a>
+<ul class="sectlevel4">
+<li><a href="appendix_a_hints.html#sec:DI_custom_bundle">A.1.2.1. Use DI in custom bundle, use DI with extensions</a>
+<ul class="sectlevel5">
+<li><a href="appendix_a_hints.html#sec:DI_custom_bundle_problem">A.1.2.1.1. Problem</a></li>
+<li><a href="appendix_a_hints.html#sec:DI_custom_bundle_solution">A.1.2.1.2. Solution</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Access_Other_DSL_Injector">A.1.2.2. How do I get the Guice Injector of my language?</a>
+<ul class="sectlevel5">
+<li><a href="appendix_a_hints.html#sec:DSL_Injector_UI_context">A.1.2.2.1. UI context</a></li>
+<li><a href="appendix_a_hints.html#sec:DSL_Injector_Non_UI_context">A.1.2.2.2. Non UI context but with injection context</a></li>
+<li><a href="appendix_a_hints.html#sec:DSL_Injector_Non_UI_non_injection_context">A.1.2.2.3. Non UI context without injection context</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Cancel_Indicator">A.1.2.3. How do I get cancel indicators in different contexts?</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Eclipse">A.2. Eclipse</a>
+<ul class="sectlevel3">
+<li><a href="appendix_a_hints.html#sec:Show_Xtext_Index">A.2.1. Show the current Xtext index</a></li>
+<li><a href="appendix_a_hints.html#sec:Plugin_spy">A.2.2. Plug-in spy</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Maven-hints">A.3. Maven</a>
+<ul class="sectlevel3">
+<li><a href="appendix_a_hints.html#how-to-check-for-maven-mojo-updates">A.3.1. How to check for Maven MOJO updates</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#_module-loading">Appendix B: Module Loading</a>
+<ul class="sectlevel2">
+<li><a href="appendix_b_module_loading.html#sec:Dependency_Management">B.1. Dependency Management</a></li>
+<li><a href="appendix_b_module_loading.html#ecmascript-modules">B.2. ECMAScript Modules</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:ES5_Modules_Systems">B.2.1. ES5 Modules Systems</a></li>
+<li><a href="appendix_b_module_loading.html#sec:ES6_Modules">B.2.2. ES6 Modules</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:ECMAScript_Module_Loaders">B.3. ECMAScript Module Loaders</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:ES6_Module_Loaders">B.3.1. ES6 Module Loaders</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Polyfills_for_ES6_Module_Loaders">B.3.2. Polyfills for ES6 Module Loaders</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:es6_module_loader">B.3.2.1. es6-module-loader</a></li>
+<li><a href="appendix_b_module_loading.html#sec:SystemJS">B.3.2.2. SystemJS</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Demo">B.3.2.3. Demo</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#case-study-typescript">B.4. Case Study : TypeScript</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:ES6_Modules_Support">B.4.1. ES6 Modules Support</a></li>
+<li><a href="appendix_b_module_loading.html#sec:TypeScript_and_Module_Loading">B.4.2. TypeScript and Module Loading</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Cyclic_Dependencies">B.5. Cyclic Dependencies</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:Setup">B.5.1. Setup</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Transpile_and_Execute">B.5.2. Transpile and Execute</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Module_Format___AMD">B.5.2.1. Module Format = AMD</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Module_Format___CommonJS">B.5.2.2. Module Format = CommonJS</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Module_Format___SystemJS">B.5.2.3. Module Format = SystemJS</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Conclusion">B.5.3. Conclusion</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#system.register-as-transpilation-target">B.6. System.register as transpilation target</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:Introduction">B.6.1. Introduction</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:External_Transpilers">B.6.1.1. External Transpilers</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Example_of_a_System_register_module">B.6.1.2. Example of a System.register module</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Structure_of_a_System_register_module">B.6.2. Structure of a System.register module</a></li>
+<li><a href="appendix_b_module_loading.html#_transpilation-hints">B.6.3. Transpilation Hints</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Handling_Imports">B.6.3.1. Handling Imports</a></li>
+<li><a href="appendix_b_module_loading.html#sec:__exportFn__">B.6.3.2. &lt;&lt;exportFn&gt;&gt;</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Handling_Exports">B.6.3.3. Handling Exports</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Examples_w__Circular_Dependencies">B.6.4. Examples w/ Circular Dependencies</a></li>
+<li><a href="appendix_b_module_loading.html#sec:N4JS_Examples_w__Circular_Dependencies">B.6.5. N4JS Examples w/ Circular Dependencies</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Unresolved_Cyclic_Dependencies">B.6.5.1. Unresolved Cyclic Dependencies</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Variables___Functions">B.6.5.2. Examples with Variables &amp; Functions</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Classes">B.6.5.3. Examples with Classes</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Examples_with_SubClassing">B.6.5.4. Examples with SubClassing</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Miscellaneous">B.6.5.5. Miscellaneous</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#_resources">B.6.6. Resources</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:CommonJS_as_transpilation_target">B.7. CommonJS as transpilation target</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#_introduction-2">B.7.1. Introduction</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Transpilation_Hints">B.7.2. Transpilation Hints</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Import_Statements">B.7.2.1. Import Statements</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Export_Statements">B.7.2.2. Export Statements</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Tracking_Live_Bindings">B.7.2.3. Tracking Live Bindings</a></li>
+<li><a href="appendix_b_module_loading.html#sec:A_complete_example">B.7.2.4. A complete example</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#_resources-2">B.7.3. Resources</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_c_license.html#sec:License">Appendix C: License</a></li>
+<li><a href="appendix_d_acronyms.html#sec:Acronyms">Appendix D: Acronyms</a></li>
+<li><a href="appendix_e_bibliography_and_footnotes.html#_bibliography-and-footnotes">Appendix E: Bibliography and Footnotes</a></li>
+</ul>
+</div>
+</div>
+<div id="content"><div class="sect1">
+<h2 id="_execution"><a class="anchor" href="#_execution"></a><a class="link" href="#_execution">13. Execution</a></h2>
+<div class="sectionbody">
+<div class="admonitionblock warning">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-warning" title=""></i>
+</td>
+<td class="content">
+This chapter may be outdated.
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>There are many different use cases for executing N4JS code:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>running project locally</p>
+</li>
+<li>
+<p>running tests in CI</p>
+</li>
+<li>
+<p>running application in the client</p>
+</li>
+<li>
+<p>running processor on the server</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>All those use cases may differ in their details, but can be divided into general phases:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>execution environment preparation</p>
+</li>
+<li>
+<p>bootstrapping</p>
+</li>
+<li>
+<p>call to given n4js entry point</p>
+</li>
+<li>
+<p>shutdown (optional)</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>When N4JS execution is triggered, proper <em>Runner</em> (see <a href="#sec:Runners-introduction">Runners</a>) is selected. In some cases it is done automatically, in others user needs to make a choice. Runner is responsible for perform all required preparations, according to <a href="#sec:N4JS_Project_Execution_And_Linking_Model">N4JS Project Execution And Linking Model</a>. Then JS execution environment (e.g. NodeJS, IOJS, Chrome, JavaScriptCore) performs bootstrapping according to <a href="#sec:N4JS_Execution_And_Linking_File">N4JS Execution And Linking File</a>. As last step of bootstrap phase defend n4js entry point will be called which starts proper n4js execution phase. In some cases there may be shutdown phase, but that is highly dependent on use case and proceeding execution phases.</p>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:N4JS_Project_Execution_And_Linking_Model"><a class="anchor" href="#sec:N4JS_Project_Execution_And_Linking_Model"></a><a class="link" href="#sec:N4JS_Project_Execution_And_Linking_Model">13.1. N4JS Project Execution And Linking Model</a></h3>
+<div class="paragraph">
+<p>N4JS project is compiled to JavaScript language, that in turn can be executed in some JS execution environment, Those environments (e.g. NodeJS, IOJS, Chrome, JavaScriptCore) will differ between each other in terms of JS APIs they expose and way JS code has to be provided to them, or the way it is triggered. We introduced systematic way of describing those features in terms of N4JS projects (see Components and Projects <a href="#sec:N4_Components_and_IDE_Support">Components and IDE Support</a>). N4JS project will be of different <em>PojectType</em> that determines project purpose (see Package.json section <a href="project_model.html#sec:Package_json">Package.json File</a>. When we want to execute some N4JS project, we can divide its dependency graph into 4 general areas</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>User Space, e.g. user code</p>
+</li>
+<li>
+<p>System Space, e.g N4 Platform APIs</p>
+</li>
+<li>
+<p>Runtime Space, e.g. EcmaScript APIs</p>
+</li>
+<li>
+<p>Environment Space, e.g. execution environment APIs</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>Example of that kind of graph can bee seen on <a href="#fig:od_sampleProjectDependencyGraph">Sample Project Dependency Graph</a></p>
+</div>
+<div id="fig:od_sampleProjectDependencyGraph" class="imageblock center">
+<div class="content">
+<img src="chapters/14_execution/images/od_sampleProjectDependencyGraph.svg" alt="od sampleProjectDependencyGraph">
+</div>
+<div class="title">Figure 37. Sample Project Dependency Graph</div>
+</div>
+<div class="paragraph">
+<p>All dependencies are compile time dependency (as they are checked by the compiler), but <em>tend</em> to weaken, the lower in the dependency graph we are. <em>User Space</em> objects will have strong load time and run time dependency to each other and to the <em>System Space</em>. <em>System Space</em> have strong load time and run time dependency to each other and, only runtime dependency to <em>Runtime Space</em>. <em>Runtime Space</em> objects should not have any load time dependencies between each other. In some cases they may have weak runtime dependency to each other. In many cases those components are just api definitions that describe execution environment native apis, but may contain polyfills code. <em>Environment Space</em> has no dependency to other components, except the fact different <em>RuntimeEnvironemnt</em>s can extend each other (see <a href="#sec:N4_Components_and_IDE_Support">[sec:N4_Components_and_IDE_Support]</a>).</p>
+</div>
+<div class="paragraph">
+<p>Runner must configure JS execution environment in the way that all above areas of the dependency graph must be either</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>provided by execution environment itself (runtime libraries APIs - <em>n4jsd</em> files)</p>
+</li>
+<li>
+<p>loaded by defined runtime environment (self initialisation code)</p>
+</li>
+<li>
+<p>available to load by environment explicitly (runtime libraries polyfills, system libraries)</p>
+</li>
+<li>
+<p>available to load by other implicitly (system libraries, user libraries and projects)</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Testers, the same way as runners, must be able to execute n4js code. Main difference is that dependency graph for test case will be usually slightly bigger (dependencies to test libraries), and code that has to be triggered shifts a bit from given project to test library used in test code of tested project. Extending previously used example with test elements is shown in figure <a href="#fig:od_sampleTestProjectDependencyGraph2">Sample Test Project Dependency Graph</a>.</p>
+</div>
+<div id="fig:od_sampleTestProjectDependencyGraph2" class="imageblock center">
+<div class="content">
+<img src="chapters/14_execution/images/od_sampleTestProjectDependencyGraph.svg" alt="od sampleTestProjectDependencyGraph">
+</div>
+<div class="title">Figure 38. Sample Test Project Dependency Graph</div>
+</div>
+<div id="fig:runners-testers" class="imageblock center">
+<div class="content">
+<img src="chapters/14_execution/images/runners-testers.svg" alt="runners testers">
+</div>
+<div class="title">Figure 39. Runners and Testers</div>
+</div>
+<div class="sect3 language-n4js">
+<h4 id="subsec:N4JS_Execution_With_NodeJS"><a class="anchor" href="#subsec:N4JS_Execution_With_NodeJS"></a><a class="link" href="#subsec:N4JS_Execution_With_NodeJS">13.1.1. N4JS Execution With NodeJS</a></h4>
+<div class="paragraph">
+<p>This example shows in-depth details of N4JS code execution with NodeJS runner.</p>
+</div>
+<div class="paragraph">
+<p>In the workspace we have <code>Client</code> with <code>foo.n4js</code> that imports <code>bar.n4js</code> from <code>UserLib</code> that is also in the workspace.
+Those N4JS files use some ES5 APIs , e.g. <code>Math.random()</code> and <code>setTimeout()</code>. Those APIs are <code>Global</code> so there is
+no impicit import, still they make user projects depend on runtime library <code>n4js-runtime-es2015</code>.
+Assuming user selects <code>foo.n4js</code> file for execution, the NodeRunner in the IDE will:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>create working directory in temp folder, e.g. <code>/var/temp/N4JSNodeRun123/</code></p>
+</li>
+<li>
+<p>create <code>node_modules</code> folder inside working directory, to which projects will be linked</p>
+</li>
+<li>
+<p>generate script, e.g. <code>n4jsELF.js</code> that will be responsible for booting execution (see <a href="#sec:N4JS_Execution_And_Linking_File">N4JS Execution And Linking File</a>)</p>
+</li>
+<li>
+<p>runner will put <code>/var/temp/N4JSNodeRun123/node_modules</code> into <code>NODE_PATH</code></p>
+</li>
+<li>
+<p>execute <code>/var/temp/N4JSNodeRun123/n4jsELF.js</code> with NodeJS</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>For example with NodeJS environment if all projects from dependency graph are accessible in local file system, their
+paths would need to be put in NodeJS <em>NODE_PATH</em> environment variable. In addition to configuring execution environment
+<em>Runner</em> generates N4JS Elf file that is used by environment to bootstrap n4js execution
+(see <a href="#sec:N4JS_Execution_And_Linking_File">N4JS Execution And Linking File</a>).
+[[fig:od_sampleNodeProjectExecution]</p>
+</div>
+<div class="imageblock center">
+<div class="content">
+<img src="chapters/14_execution/images/od_sampleNodeProjectExecution.svg" alt="od sampleNodeProjectExecution">
+</div>
+<div class="title">Figure 40. Sample NodeJS Project Execution</div>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:N4JS_Execution_And_Linking_File"><a class="anchor" href="#sec:N4JS_Execution_And_Linking_File"></a><a class="link" href="#sec:N4JS_Execution_And_Linking_File">13.2. N4JS Execution And Linking File</a></h3>
+<div class="paragraph">
+<p>JS execution environment not only needs to know from where it needs to obtain code to execute, but also <em>what is the entry point to the code that is supposed to be executed</em> and <em>what code needs to be loaded before entry point is called</em>.</p>
+</div>
+<div class="paragraph">
+<p>All this information is generated by the runner based on the executed project dependency graph. The way this information
+is presented depends on concrete JS execution environment used, and on its configuration (e.g. user provided options, or
+configuration derived in other ways). But in either case file is generated with that information. Figure <a href="#fig:n4js_elf">N4JS ELF examples</a>
+shows examples how this information would look like for both testers and runners for both NodeJS or Chrome.</p>
+</div>
+<div id="fig:n4js_elf" class="imageblock center">
+<div class="content">
+<img src="chapters/14_execution/images/n4js_elf.svg" alt="n4js elf">
+</div>
+<div class="title">Figure 41. N4JS ELF examples</div>
+</div>
+<div class="paragraph">
+<p>First segment of the n4js elf is responsible for loading <em>RuntimeEnvironment</em> bootstrap code. Since <em>RuntimeEnvironment</em>s can extend each other, generated information would follow those dependencies. It is possible that <em>RuntimeEnvironment</em>s need to do some special work in regards of of provided <em>RuntimeLibraries</em>s, e.g. initiate initiate polyfills. That code can be either directly in <em>RuntimeEnvironment</em> init code, or its init code can call modules from provided runtime libraries.</p>
+</div>
+<div class="paragraph">
+<p>Second segment of the n4js elf is responsible for loading <em>RuntimeEnvironment</em> exec module. This is special module defined in package.json of the environment, that is used to call into user projects entry point directly, or (as in test case) call into runners of the test library.</p>
+</div>
+<div class="paragraph">
+<p>Last segment of the n4js elf is responsible for passing run/test data (generated by IDE/CLI) into initialised previously exec module.</p>
+</div>
+<div class="paragraph">
+<p>While first two segments are resolved from project dependencies and can be covered by generic approach on IDE/CLI side, last segment requires strong relation between given runner/tester and <em>RuntimeEnvironment</em> / <em>TestEnvironment</em>. While some generic approaches can be used, for the moment we don’t specify concrete convention there.</p>
+</div>
+<div class="sect3 language-n4js">
+<h4 id="subsec:NodeJS_Specific_ELF"><a class="anchor" href="#subsec:NodeJS_Specific_ELF"></a><a class="link" href="#subsec:NodeJS_Specific_ELF">13.2.1. NodeJS Specific ELF</a></h4>
+<div class="paragraph">
+<p>Concrete environments may need specific setup that is not common for other environemtns. For example for NodeJS runner
+needs to configure the node lookup paths for the module resolution. This is achieved by creating at runtime symlinks
+from <code>node_modules</code> pointing to concrete dependencies required during execution.</p>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:Runners-execution"><a class="anchor" href="#sec:Runners-execution"></a><a class="link" href="#sec:Runners-execution">13.3. Runners</a></h3>
+<div class="paragraph">
+<p>It is specified above, that <em>Runner</em> prepares concrete JS execution environment for executing given code and triggers execution process. What is not clear so far is how appropriate runner is selected for given project. In <a href="#_n4components">N4 Components</a> it was specified that N4JS projects do not depend directly on specific runners or JS execution environments. Instead, N4JS tooling should be able to select appropriate runner based on given project transitive dependencies. In this section we specify overall design of runners for both N4JS IDE and CLI tooling and how runners are selected for projects.</p>
+</div>
+<div class="paragraph">
+<p>INFO: In general any n4js code execution is governed by <em>runners</em> and <em>testers</em> depending on the use case.
+In this chapter <em>runners</em> are described in detail.
+Information from this chapter applies to <em>Testers</em>, unless stated otherwise in chapter dedicated to testing N4JS code (<a href="tests.html#_tests">Tests</a>), were we specify
+testing specific use cases.</p>
+</div>
+<div class="sect3">
+<h4 id="subsec:N4_Runtime_Environments_Convention"><a class="anchor" href="#subsec:N4_Runtime_Environments_Convention"></a><a class="link" href="#subsec:N4_Runtime_Environments_Convention">13.3.1. N4 Runtime Environments Convention</a></h4>
+<div class="paragraph">
+<p>Dependency between <em>Runner</em> and <em>Runtime Environment</em> crosses technical boundary between N4JS Projects (N4JS code) and N4JS tooling (IDE and CLI tools implemented with e.g. Java). We introduce convention to implement this dependency, yet letting N4JS projects and N4JS tools internals to be relatively independent.</p>
+</div>
+<div id="fig:cd_EnvironmentConvention" class="imageblock center">
+<div class="content">
+<img src="chapters/14_execution/images/cd_EnvironmentConvention.svg" alt="cd EnvironmentConvention">
+</div>
+<div class="title">Figure 42. Runtime Environments Convention</div>
+</div>
+<div class="paragraph">
+<p><a href="#fig:cd_EnvironmentConvention">Runtime Environments Convention</a> convention that is used to communicate run time configuration of the N4JS projects (grey colour) and N4JSIDE (pink colour). JS projects declare dependencies on provided list of <em>Runtime Libraries</em>. Each combination of those corresponds to one predefined <em>Runtime Environment</em> N4JS component. On N4JSIDE side there is separate list of <em>runtime environment</em>s maintained. Both lists correspond one to one to each other.</p>
+</div>
+</div>
+<div class="sect3 language-n4js">
+<h4 id="subsec:Passing_Information_from_IDE_to_Execution_Code_in_Runtime_Environment"><a class="anchor" href="#subsec:Passing_Information_from_IDE_to_Execution_Code_in_Runtime_Environment"></a><a class="link" href="#subsec:Passing_Information_from_IDE_to_Execution_Code_in_Runtime_Environment">13.3.2. Passing Information from IDE to Execution Code in Runtime Environment</a></h4>
+<div class="paragraph">
+<p>When launching an N4JS file, the IDE will compute some information on the containing N4JS project and its direct and indirect dependencies as well as the runtime environment in use. This information will be passed on to the execution module defined in the runtime environment, i.e. the code specified via property in the runtime environment’s package.json file. The information will be passed via a global variable <code>$executionData</code>. The value will be a Javascript object with the following properties:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>userSelection</code>: the module the user had selected when initiating the launch. This will usually be the <code>module to run</code>  , but in case of testing it will be the project, folder, or file the user had selected.</p>
+</li>
+<li>
+<p><code>projectNameMapping</code>: an object in which every key is the name of an API project among the direct or indirect dependencies of the project being run, and every value is the name of the corresponding implementation project being used. When running N4JS projects that do not make use of the API / implementation project technique, then this property will either hold an empty object or be undefined.</p>
+</li>
+<li>
+<p><code>testTree</code> (only when running tests): the test tree as defined in <a href="tests.html#_tests">Tests</a> containing information on the tests to be run, i.e. test classes, test methods, etc. The test tree will be encoded as JSON, so the value of this property will be of type string and should be passed to <code>JSON.parse()</code>.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>All calculations described above are based on the workspace available. This includes library manager functionality, see <a href="../20_externalLibraries/externalLibraries.html#:External_Library_Workspace">External Library Workspace</a>.
+In specific setups, where workspace is not available runners provide helper utility <code>org.eclipse.n4js.runner.RunnerFileBasedShippedCodeConfigurationHelper.configureFromFileSystem()</code> that allows to configure given <code>RunConfiguration</code> using
+plain file system to the external libraries. Note that in order to do this in a way that allows to re-use all computation logic based on <a href="../12_n4components/n4components.html#:N4MFContainerManagement">N4Containers</a>,
+runners infrastructure provides its own subclasses of the few component types. Those specialized types are used only in scope of <code>RunnerFileBasedShippedCodeConfigurationHelper</code> and are not exposed to the rest of the system.</p>
+</div>
+<div class="paragraph">
+<p>Specific runners, e.g. the NodeJS or Chrome runner, may choose to provide more information via the execution data object.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="subsec:Runners_Design"><a class="anchor" href="#subsec:Runners_Design"></a><a class="link" href="#subsec:Runners_Design">13.3.3. Runners Design</a></h4>
+<div class="paragraph">
+<p>As specified in section before N4JS projects will need to be executed on various JS execution environments, for which dedicated runners will be needed. While they will differ how they interact with concrete JS environment, they will have common parts when it comes to interaction with N4JS IDE or CLI. Those parts are provided in form of abstract <em>IDERunner</em> <em>CLIRunner</em> and <em>Runner</em> <em>components</em> (or bundles) that specific runners should use to interact with N4JS IDE or CLI.</p>
+</div>
+<div class="paragraph">
+<p>Runner by design consists of three parts:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><em>core</em> part (green colour) - contains most logic, resources (e.g. JS execution environment binary)</p>
+</li>
+<li>
+<p><em>IDE</em> part (blue colour) - responsible for working with N4JS IDE (enabling runner in ui, providing views)</p>
+</li>
+<li>
+<p><em>CLI</em> part (yellow colour) - responsible for working with N4JS CLI (get command line parameters, provide console output)</p>
+</li>
+</ul>
+</div>
+<div id="cd_RunnersIdeCli" class="imageblock center">
+<div class="content">
+<img src="chapters/14_execution/images/cd_RunnersIdeCli.svg" alt="cd RunnersIdeCli">
+</div>
+<div class="title">Figure 43. Runner for N4JS IDE and CLI tooling</div>
+</div>
+<div class="paragraph">
+<p>Specific runner is connected to running N4JS IDE or CLI via extension points. This is done either by using them directly, or by using types exposed by abstract runner component.</p>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:Legacy_Execution_Engine"><a class="anchor" href="#sec:Legacy_Execution_Engine"></a><a class="link" href="#sec:Legacy_Execution_Engine">13.4. Legacy Execution Engine</a></h3>
+<div class="paragraph">
+<p>Compilation of N4JS may target many platforms. For the moment it is hard to discuss what they will be exactly or if N4JSIDE will provide some integration or hooks to those platforms. On the other hand we want to have some execution environment for internal use to validate behaviour of compiled code. Since we know that V8 based platforms (e.g. Chrome, NodeJS) will be in our target platforms set we want to be able to execute compiled code on similar environment. As standalone V8 integration is quite challenging, we have decided to integrate in N4JSIDE NodeJS as execution environment. This is considered internal feature used for testing compilation of N4JS and N4JSIDE.</p>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:Design"><a class="anchor" href="#sec:Design"></a><a class="link" href="#sec:Design">13.5. Design</a></h3>
+<div class="paragraph">
+<p>We provide NodeJS binaries for various OSes. Direct access to binaries is not exposed. Selection and institutionalization of the binary is done internally and is not configurable. Instead bundle containing binaries provides classes required to run code (in form of <code>String</code> or <code>File</code> with the code). Clients That want to do this may either use provided <code>Engine</code> class or can implement their own engine based on provided infrastructure. Main class that used in engine implementation is <code>EngineCommandBuilder</code>. This class is responsible for building proper command line commands that engine implementation must execute to run code with NodeJS.</p>
+</div>
+<div class="paragraph">
+<p><a href="#fig:cd_executionengine">NodeJS execution integration</a> shows the most important classes of the NodeJS integration.</p>
+</div>
+<div id="fig:cd_executionengine" class="imageblock center">
+<div class="content">
+<img src="chapters/14_execution/images/cd_executionengine.svg" alt="cd executionengine">
+</div>
+<div class="title">Figure 44. NodeJS execution integration</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Usage_Outside_N4JSIDE"><a class="anchor" href="#sec:Usage_Outside_N4JSIDE"></a><a class="link" href="#sec:Usage_Outside_N4JSIDE">13.5.1. Usage Outside N4JSIDE</a></h4>
+<div class="paragraph">
+<p>In this use case we use provdied <code>Engine</code> class that allows to execute js code in form of <code>String</code> or <code>File</code> with the code. In return user receives <code>EngineOutput</code> object with two lists of strings containing standard output and error output of the node process, that were captured during execution.</p>
+</div>
+<div class="paragraph">
+<p>In this usage scenario execution api assumes valid JS code. User needs to ensure compilation of code prior to execution, if needed.</p>
+</div>
+<div class="paragraph">
+<p>That functionality is used in internal jUnit tests and in xpect tests of the compiler.</p>
+</div>
+<div class="sect4">
+<h5 id="sec:Use_Node_with_Maven"><a class="anchor" href="#sec:Use_Node_with_Maven"></a><a class="link" href="#sec:Use_Node_with_Maven">13.5.1.1. Use Node with Maven</a></h5>
+<div class="paragraph">
+<p>Note on maven usage. For maven based builds we need to ensure that binary resources are available and are unpacked. To do this in pom of the project that will be calling engine we must include following listing:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xml" data-lang="xml">            &lt;plugin&gt;
+                &lt;groupId&gt;org.apache.maven.plugins&lt;/groupId&gt;
+                &lt;artifactId&gt;maven-dependency-plugin&lt;/artifactId&gt;
+                &lt;executions&gt;
+                    &lt;execution&gt;
+                        &lt;id&gt;unpack&lt;/id&gt;
+                        &lt;phase&gt;process-test-classes&lt;/phase&gt;
+                        &lt;goals&gt;
+                            &lt;goal&gt;unpack&lt;/goal&gt;
+                        &lt;/goals&gt;
+                        &lt;configuration&gt;
+                            &lt;artifactItems&gt;
+                                &lt;artifactItem&gt;
+                                    &lt;groupId&gt;org.eclipse.n4js&lt;/groupId&gt;
+                                    &lt;artifactId&gt;org.eclipse.n4js.js.engine&lt;/artifactId&gt;
+                                    &lt;version&gt;0.0.1-SNAPSHOT&lt;/version&gt;
+                                    &lt;overWrite&gt;true&lt;/overWrite&gt;
+                                    &lt;outputDirectory&gt;
+                                        ${project.build.directory}/classes
+                                    &lt;/outputDirectory&gt;
+                                &lt;/artifactItem&gt;
+                            &lt;/artifactItems&gt;
+                        &lt;/configuration&gt;
+                    &lt;/execution&gt;
+                &lt;/executions&gt;
+            &lt;/plugin&gt;</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Usage_Inside_N4JSIDE"><a class="anchor" href="#sec:Usage_Inside_N4JSIDE"></a><a class="link" href="#sec:Usage_Inside_N4JSIDE">13.5.2. Usage Inside N4JSIDE</a></h4>
+<div class="paragraph">
+<p>In Eclipse platfrom based environment we use custom implementation of the engine, <code>PlatformEngine</code>. This implementation unlike default <code>Platform</code> is non blocking implementation that forwards output to platform console and allows platform to control lifecycle of the running engine. Additionally this version uses its own implementation of the <code>ResourceUrlResolver</code>. It is required to properly resolve urls that point inside platform bundles.</p>
+</div>
+<div class="paragraph">
+<p>This scenario we assume that user will run N4JS files or JS files. We have created proper UI hooks that allow user to do this either from editor or as selection menu. Based on name of the file that user commands to execute we find proper compiled file (compiled with our ES5 compiler - it is not configurable). When found we execute this file in our execution engine. If it is not found, execution engine will write appropriate error to N4JSIDE console.</p>
+</div>
+</div>
+</div>
+<div class="sect2 langauge-n4js">
+<h3 id="sec:Runtime_Injection"><a class="anchor" href="#sec:Runtime_Injection"></a><a class="link" href="#sec:Runtime_Injection">13.6. Runtime Injection</a></h3>
+<div class="paragraph">
+<p>There is need to inject into runtime environment some special code, for example when compiling N4JS to ES5 (see N4JavaScriptSpecification,chapter N4 JS Compilation). To achieve this wee need to inject desired code when calling engine to run desired compiled code. Injection mechanism depends a lot on way we run engine. In this section injection of runtime is discussed based on NodeJs that is used as runtime environment.</p>
+</div>
+<div class="sect3">
+<h4 id="sec:Running_String_Code"><a class="anchor" href="#sec:Running_String_Code"></a><a class="link" href="#sec:Running_String_Code">13.6.1. Running String Code</a></h4>
+<div class="paragraph">
+<p>We allow code execution where code is provided in form of <code>String</code>. In this case we are calling nodejs with parameters . To enrich execution environment in this case we are appending special runtime code at the end of file. It is important to append it at the end, to avoid changing line numbers of original code and decrease other potential side effects. So actual invocation of nodejs looks like</p>
+</div>
+<div class="paragraph">
+<p>This mechanism assumes:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>injected code starts with new line - this makes ASI mechanism to finish user last statement if it was not properly finished by user, otherwise just creates</p>
+</li>
+<li>
+<p>injected code does not have to be initiated manually - all exposed api is in named function declarations</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p><em>Explanation</em></p>
+</div>
+<div class="paragraph">
+<p>In first assumption we make workaround for user code that does not contain new line or semicolon at the end of last statement. This kind of code is incorrect and would result in last statement of user code and first statement of injected code to be interpreted as one JS statement. In most cases that would be invalid code. By having new line as first character of injected code, we are taking advantage of JS AutomaticSemicolonInjection mechanism. If user code AST is not finished properly this mechanism will finish close user AST. If user AST is finished properly, ASI will just insert empty statement between user code and injection code. In both cases we end up with proper AST.</p>
+</div>
+<div class="paragraph">
+<p>Second assumption avoids need for further user code modifications, as injected does not have to be manually called. Instead we take advantage of variable and function hoisting mechanism of JS. This assures that even though user code is first in AST, JS environment will first initiate named functions therefore when user code calls injected code it is already defined in scope in which user code executes.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Running_File_Code"><a class="anchor" href="#sec:Running_File_Code"></a><a class="link" href="#sec:Running_File_Code">13.6.2. Running File Code</a></h4>
+<div class="paragraph">
+<p>Second method of code execution is to execute provided file with user code. Normal way of doing that with NodeJS is to make call. But since we need to inject special code without rewriting files, we use different mechanism. Basically we are executing injected code and in the same scope using node api. Additionally we are attaching injected code to global scope in node, ensuring this way that required file is executed in scope which contains injected code. Putting this all together we are making following call:</p>
+</div>
+<div class="paragraph">
+<p>This mechanism assumes that injected code attaches all exposed API to global scope .</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Injection_Code_Example"><a class="anchor" href="#sec:Injection_Code_Example"></a><a class="link" href="#sec:Injection_Code_Example">13.6.3. Injection Code Example</a></h4>
+<div class="paragraph">
+<p>Following is simple example of properly formed injection code.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">;
+function foo(){}
+function bar(){}
+function baz(){}
+
+(function(){
+ GLOBAL.foo = foo;
+ GLOBAL.bar = bar;
+ GLOBAL.baz = baz;
+})();
+;</code></pre>
+</div>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>first line is empty line to trigger ASI</p>
+</li>
+<li>
+<p>second line (optional) enters</p>
+</li>
+<li>
+<p>lines 3-5 are defining runtime api in current scope (in which user code provided as a string is executed)</p>
+</li>
+<li>
+<p>lines 6 (optional) is just a visual sugar</p>
+</li>
+<li>
+<p>lines 7-11 are adding runtime api to global scope (to expose it when runnig user file with code)</p>
+</li>
+<li>
+<p>lines 12-13 (optional) are there to separate injected code and invokation of user file (if running user provided file with code)</p>
+</li>
+</ol>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div id="footer">
+<div id="footer-text">
+Version 0.9<br>
+Last updated 2019-08-07 15:02:40 CEST
+</div>
+</div>
+<!-- ************* docinfo-footer *************************************************************** -->
+<div class="Grid social" style="color:#d5dfea">
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <h2>Quick Links</h2>
+    <ul>
+      <li><a href="../downloads.html">Download</a></li>
+      <li><a href="../userguides/index.html">Documentation</a></li>
+      <li><a href="https://github.com/eclipse/n4js/">Source</a></li>
+      <li><a href="https://github.com/eclipse/n4js/issues">Issues</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="https://www.eclipse.org/forums/index.php/f/365/">Forum</a></li>
+      <li><a href="http://n4js.blogspot.de/">Blog</a></li>
+      <li><a href="https://dev.eclipse.org/mailman/listinfo/n4js-dev">Mailing List</a></li>
+      <li><a href="https://projects.eclipse.org/projects/technology.n4js">Eclipse Project Page</a></li>
+      <li><a href="https://twitter.com/n4jsdev">Tweets by n4jsdev</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="http://www.eclipse.org/">Eclipse Home</a></li>
+      <li><a href="http://www.eclipse.org/legal/privacy.php">Privacy Policy</a></li>
+      <li><a href="http://www.eclipse.org/legal/termsofuse.php">Terms of Use</a></li>
+      <li><a href="http://www.eclipse.org/legal/copyright.php">Copyright Agent</a></li>
+      <li><a href="http://www.eclipse.org/legal/">Legal</a></li>
+    </ul>
+  </div>
+  <div style="clear: both; height: 0; overflow: hidden;"></div>
+</div>
+
+<!-- ************* UI Scripts ************* -->
+<script type="text/javascript" src="scripts/back-to-top.js"></script>
+
+<script type="text/javascript" src="scripts/treeview.js"></script>
+<script type="text/javascript" src="scripts/toc.js"></script>
+
+<!-- ************* Prism.js Syntax Highlighting ************* -->
+<script src="scripts/prism.js"></script>
+
+<script type="text/javascript">
+	// Add the 'toclist' id for search function
+	$(".toc2 > ul").attr('id', 'toclist');
+	// Generate a Search input form
+	$("#toclist > li:first-of-type").before('<input type="text" id="pagesearch" onkeyup="search()" placeholder="Search for section...">');
+	$("#toclist > li:first-of-type").before('<i id="clear" class="fa fa-times-circle-o"></i>');
+	$("#clear").click(function(){
+	    $("#pagesearch").val('');
+	    search();
+	    $('.toc2 > ul').treeView('collapseAll');
+	});
+	// intialize Treeview.js
+	$(".toc2 > ul").treeView();
+	// Initialize Scrollspy
+</script>
+<!-- ************* docinfo-footer *************************************************************** -->
+</body>
+</html>
\ No newline at end of file
diff --git a/design/external_libraries.html b/design/external_libraries.html
new file mode 100644
index 0000000..9634018
--- /dev/null
+++ b/design/external_libraries.html
@@ -0,0 +1,1271 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="generator" content="Asciidoctor 1.5.5">
+<meta name="author" content="2019-08-07 15:02:40 CEST">
+<title>N4JS Design Specification</title>
+<link rel="stylesheet" href="styles/spec.min.css">
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.6.3/css/font-awesome.min.css">
+<!-- ************* docinfo ******************************************************************* -->
+
+
+<!-- ************* Favicon ************-->
+<link rel="icon" href="images/favicon.ico" />
+
+<!-- ************* Back-to-top JQuery ************* -->
+<script src="https://code.jquery.com/jquery-1.12.4.js"></script>
+<script src="https://code.jquery.com/ui/1.12.0/jquery-ui.js"></script>
+
+
+<link href="styles/prism.min.css" rel="stylesheet" />
+<script type="text/javascript" async
+  src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2/MathJax.js?config=TeX-MML-AM_CHTML">
+</script>
+
+<!-- ************* Styles ************* -->
+<link rel="stylesheet" type="text/css" href="styles/n4jsspec-adoc.css">
+
+
+<!-- ****************** NavBar ****************** -->
+<div id="menubar">
+	<div class="banner">
+        <a href="https://www.eclipse.org/n4js/#"><img id="logo" src="images/n4js-logo.png" alt="Eclipse N4JS"></a>
+    </div>
+<ul>
+  <li><a href="index.html">Index</a></li>
+</ul>
+</div>
+<!-- ************* docinfo ******************************************************************* -->
+<style>
+      .admonitionblock td.icon .icon-todo:before{content:"\f249";color:#f4ee42}
+    </style>
+</head>
+<body class="book toc2 toc-left">
+<div id="header">
+<h1>N4JS Design Specification</h1>
+<div class="details">
+<span id="author" class="author">2019-08-07 15:02:40 CEST</span><br>
+<span id="revnumber">version 0.9</span>
+</div>
+<div id="toc" class="toc2">
+<div id="toctitle">Table of Contents</div>
+<ul class="sectlevel1">
+<li><a href="introduction.html#_introduction">1. Introduction</a>
+<ul class="sectlevel2">
+<li><a href="introduction.html#notation">1.1. Notation</a></li>
+<li><a href="introduction.html#sec:IDE_Overview">1.2. IDE Components</a>
+<ul class="sectlevel3">
+<li><a href="introduction.html#sec:Naming_Conventions">1.2.1. Naming Conventions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="eclipse_setup.html#_eclipse-setup">2. Eclipse Setup</a>
+<ul class="sectlevel2">
+<li><a href="eclipse_setup.html#_system-requirements">2.1. System Requirements</a></li>
+<li><a href="eclipse_setup.html#_contribute">2.2. Contribute</a>
+<ul class="sectlevel3">
+<li><a href="eclipse_setup.html#_eclipse-installer">2.2.1. Eclipse Installer</a>
+<ul class="sectlevel4">
+<li><a href="eclipse_setup.html#_changing-the-setup-script">2.2.1.1. Changing the Setup Script</a></li>
+</ul>
+</li>
+<li><a href="eclipse_setup.html#_manual-ide-configuration">2.2.2. Manual IDE Configuration</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="release_engineering.html#_release-engineering">3. Release Engineering</a>
+<ul class="sectlevel2">
+<li><a href="release_engineering.html#_nightly-build-on-eclipse-infrastructure">3.1. Nightly build on Eclipse infrastructure</a></li>
+<li><a href="release_engineering.html#_build-the-n4js-ide-from-command-line">3.2. Build the N4JS IDE from command line</a>
+<ul class="sectlevel3">
+<li><a href="release_engineering.html#_publish-maven-tooling-code-org-eclipse-n4js-releng-util-code">3.2.1. Publish maven-tooling <code>org.eclipse.n4js.releng.util</code></a></li>
+<li><a href="release_engineering.html#sec:test-verdaccio">3.2.2. Test Verdaccio containing n4js-libs</a></li>
+<li><a href="release_engineering.html#_generation-of-eclipse-help-for-spec-and-design-document">3.2.3. Generation of Eclipse help for spec and design document</a></li>
+</ul>
+</li>
+<li><a href="release_engineering.html#_updating-frameworks-and-dependencies">3.3. Updating frameworks and dependencies</a>
+<ul class="sectlevel3">
+<li><a href="release_engineering.html#_update-of-eclipse-emf-xtext-etc">3.3.1. Update of Eclipse, EMF, Xtext, etc.</a></li>
+<li><a href="release_engineering.html#_update-of-the-embedded-jre">3.3.2. Update of the embedded JRE</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tips_and_tricks.html#_tips-and-tricks">4. Tips and Tricks</a>
+<ul class="sectlevel2">
+<li><a href="tips_and_tricks.html#_naming">4.1. Naming</a></li>
+<li><a href="tips_and_tricks.html#_logging">4.2. Logging</a></li>
+<li><a href="tips_and_tricks.html#_cancellation-handling">4.3. Cancellation Handling</a></li>
+<li><a href="tips_and_tricks.html#_caching">4.4. Caching</a></li>
+<li><a href="tips_and_tricks.html#_dependency-injection">4.5. Dependency Injection</a></li>
+<li><a href="tips_and_tricks.html#_miscellaneous">4.6. Miscellaneous</a></li>
+</ul>
+</li>
+<li><a href="parser.html#_parser">5. Parser</a>
+<ul class="sectlevel2">
+<li><a href="parser.html#sec:Parser_Overview">5.1. Overview</a></li>
+<li><a href="parser.html#sec:N4JS_Parser">5.2. N4JS Parser</a></li>
+<li><a href="parser.html#sec:Parser_Generation_Post_Processing">5.3. Parser Generation Post-Processing</a>
+<ul class="sectlevel3">
+<li><a href="parser.html#sec:Automatic_Semicolon_Insertion">5.3.1. Automatic Semicolon Insertion</a>
+<ul class="sectlevel4">
+<li><a href="parser.html#sec:Injected_code_in_the_Antlr_grammar_file">5.3.1.1. Injected code in the Antlr grammar file</a></li>
+<li><a href="parser.html#sec:Customized_error_recovery">5.3.1.2. Customized error recovery</a></li>
+</ul>
+</li>
+<li><a href="parser.html#sec:_No_line_terminator_allowed_here__handling">5.3.2. Async and <code>No line terminator allowed here</code> Handling</a></li>
+<li><a href="parser.html#sec:Regular_Expression">5.3.3. Regular Expression</a></li>
+<li><a href="parser.html#sec:Unicode">5.3.4. Unicode</a></li>
+<li><a href="parser.html#sec:Literals">5.3.5. Literals</a></li>
+</ul>
+</li>
+<li><a href="parser.html#sec:Modifiers">5.4. Modifiers</a></li>
+<li><a href="parser.html#sec:Conflict_Resolutions">5.5. Conflict Resolutions</a>
+<ul class="sectlevel3">
+<li><a href="parser.html#sec:Reserved_Keywords_vs__Identifier_Names">5.5.1. Reserved Keywords vs. Identifier Names</a></li>
+<li><a href="parser.html#sec:Operators_and_Generics">5.5.2. Operators and Generics</a></li>
+</ul>
+</li>
+<li><a href="parser.html#sec:Content_Assist_Parser">5.6. Content-Assist Parser</a></li>
+</ul>
+</li>
+<li><a href="type_system.html#_type-system">6. Type System</a>
+<ul class="sectlevel2">
+<li><a href="type_system.html#sec:Type_Model_and_Grammar">6.1. Type Model and Grammar</a>
+<ul class="sectlevel3">
+<li><a href="type_system.html#sec:Type_Model_Overview">6.1.1. Type Model Overview</a></li>
+<li><a href="type_system.html#sec:Built_in_Types">6.1.2. Built-in and Primitive Types</a></li>
+<li><a href="type_system.html#sec:Type_Model_DSL">6.1.3. Type Model DSL</a></li>
+</ul>
+</li>
+<li><a href="type_system.html#sec:Type_System_Implementation">6.2. Type System Implementation</a></li>
+<li><a href="type_system.html#sec:Type_Inference_combined_with_AST_Traversal">6.3. Type Inference of AST</a>
+<ul class="sectlevel3">
+<li><a href="type_system.html#sec:Type_Inference_combined_with_AST_Traversal__Background">6.3.1. Background</a></li>
+<li><a href="type_system.html#sec:Triggering_Type_Inference_of_AST">6.3.2. Triggering</a></li>
+<li><a href="type_system.html#sec:Traversal_Order_During_Type_Inference_of_AST">6.3.3. Traversal Order</a></li>
+<li><a href="type_system.html#sec:Cross_References_During_Type_Inference_of_AST">6.3.4. Cross-References</a></li>
+<li><a href="type_system.html#sec:Function_Accessor_Bodies_During_Type_Inference_of_AST">6.3.5. Function/Accessor Bodies</a></li>
+<li><a href="type_system.html#sec:Poly_Expressions_During_Type_Inference_of_AST">6.3.6. Poly Expressions</a></li>
+<li><a href="type_system.html#sec:Constraint_Solver_used_During_Type_Inference_of_AST">6.3.7. Constraint Solver</a></li>
+<li><a href="type_system.html#sec:Type_Guards_During_Type_Inference_of_AST">6.3.8. Type Guards</a></li>
+</ul>
+</li>
+<li><a href="type_system.html#sec:Structural_Typing">6.4. Structural Typing</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#_type-index">7. Type Index</a>
+<ul class="sectlevel2">
+<li><a href="type_index.html#sec:Type_Index_Design_Rationale">7.1. Design Rationale</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#sec:Getting_the_Xtext_Index_Content_IResourceDescriptions">7.1.1. Getting the Xtext Index (<code>IResourceDescriptions</code>) Content</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#sec:Design_Overview">7.2. Design Overview</a></li>
+<li><a href="type_index.html#sec:N4JS_Resource_Load_States">7.3. N4JS Resource Load States</a></li>
+<li><a href="type_index.html#sec:Type_Builder">7.4. Types Builder</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#sec:Type_Inference_not_allowed_in_Type_Builder">7.4.1. Type Inference not allowed in Types Builder</a></li>
+<li><a href="type_index.html#sec:ComputedTypeReferences">7.4.2. Deferred Type References</a></li>
+<li><a href="type_index.html#sec:Use_cases_of_ComputedTypeRef">7.4.3. Use cases of DeferredTypeRef</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#sec:Incremental_Builder_Overview">7.5. Incremental Builder (Overview)</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#sec:Incremental_Builder_Overview__XtextBuilder">7.5.1. XtextBuilder</a></li>
+<li><a href="type_index.html#sec:Incremental_Builder_Overview__IBuilderState">7.5.2. IBuilderState</a>
+<ul class="sectlevel4">
+<li><a href="type_index.html#copy-and-update-xtext-index">7.5.2.1. Copy and Update Xtext Index</a></li>
+<li><a href="type_index.html#build-state-setup-phase">7.5.2.2. Build State Setup Phase</a></li>
+<li><a href="type_index.html#process-queued-uris">7.5.2.3. Process Queued URIs</a></li>
+<li><a href="type_index.html#queueing-affected-resources">7.5.2.4. Queueing Affected Resources</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#sec:Incremental_Builder_Overview__Example">7.5.3. Example</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#dirty-state-handling">7.6. Dirty state handling</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#use-case-restoring-types-from-user-data">7.6.1. Use case: Restoring types from user data</a></li>
+<li><a href="type_index.html#use-case-updating-the-xtext-index">7.6.2. Use case: Updating the Xtext index</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="project_model.html#_project-model">8. Project Model</a>
+<ul class="sectlevel2">
+<li><a href="project_model.html#sec:Package_json">8.1. Package.json File</a></li>
+<li><a href="project_model.html#_accessing-project-information">8.2. Accessing Project Information</a>
+<ul class="sectlevel3">
+<li><a href="project_model.html#sec:IN4JSCore">8.2.1. IN4JSCore</a></li>
+<li><a href="project_model.html#sec:N4JSModel">8.2.2. N4JSModel</a></li>
+<li><a href="project_model.html#sec:N4JSWorkspace">8.2.3. N4JSWorkspace</a></li>
+<li><a href="project_model.html#sec:N4JSProject">8.2.4. N4JSProject</a></li>
+<li><a href="project_model.html#sec:SourceContainer">8.2.5. SourceContainer</a></li>
+<li><a href="project_model.html#sec:N4JSProjectsStateHelper">8.2.6. N4JSProjectsStateHelper</a></li>
+</ul>
+</li>
+<li><a href="project_model.html#sec:Caching">8.3. Caching</a>
+<ul class="sectlevel3">
+<li><a href="project_model.html#_caching-of-externallibraryworkspace">8.3.1. Caching of ExternalLibraryWorkspace</a></li>
+<li><a href="project_model.html#_caching-of-n4jsprojectsstatehelper">8.3.2. Caching of N4JSProjectsStateHelper</a></li>
+</ul>
+</li>
+<li><a href="project_model.html#sec:WildcardPathFilter">8.4. WildcardPathFilter</a></li>
+<li><a href="project_model.html#sec:ProjectUtils">8.5. ProjectUtils</a></li>
+</ul>
+</li>
+<li><a href="binding.html#_binding">9. Binding</a>
+<ul class="sectlevel2">
+<li><a href="binding.html#sec:Binding_Design_Rationale">9.1. Design Rationale</a></li>
+<li><a href="binding.html#sec:Binding_to_Members">9.2. Binding to Members</a></li>
+<li><a href="binding.html#sec:Binding_Getter_Setter">9.3. Getter / Setter Binding</a></li>
+<li><a href="binding.html#chap:Statics">9.4. Static Member Binding</a></li>
+<li><a href="binding.html#sec:Binding_Enumeration">9.5. Enumeration Literals Binding</a></li>
+<li><a href="binding.html#sec:Accessibility_of_types_and_members">9.6. Accessibility of types and members</a></li>
+<li><a href="binding.html#sec:Member_Scope_Example">9.7. Member Scope Example</a></li>
+<li><a href="binding.html#sec:Scoping_for_Members_of_Composed_Type_Explained">9.8. Scoping for Members of Composed Type (Union/Intersection) Example</a></li>
+<li><a href="binding.html#sec:Binding_of_Structurally_References_Types">9.9. Structurally References Types</a></li>
+<li><a href="binding.html#sec:Building">9.10. Building</a>
+<ul class="sectlevel3">
+<li><a href="binding.html#sec:Build_Phases">9.10.1. Build Phases</a></li>
+<li><a href="binding.html#sec:Build_Scenarios">9.10.2. Build Scenarios</a></li>
+<li><a href="binding.html#sec:Lazy_linking_problem">9.10.3. Lazy linking problem</a></li>
+</ul>
+</li>
+<li><a href="binding.html#sec:Proxies_and_Proxy_Resolution">9.11. Proxies and Proxy Resolution (Overview)</a>
+<ul class="sectlevel3">
+<li><a href="binding.html#xtexts-lazy-linking-proxies">9.11.1. Xtext’s Lazy Linking Proxies</a></li>
+<li><a href="binding.html#standard-emf-proxies">9.11.2. Standard EMF Proxies</a></li>
+<li><a href="binding.html#_how-is-proxy-resolution-triggered">9.11.3. How is Proxy Resolution Triggered?</a></li>
+<li><a href="binding.html#_when-is-proxy-resolution-allowed">9.11.4. When is Proxy Resolution Allowed?</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="validation.html#_validation">10. Validation</a>
+<ul class="sectlevel2">
+<li><a href="validation.html#sec:validation_overview">10.1. Validation overview</a></li>
+<li><a href="validation.html#sec:validation_control_flow">10.2. Validation control flow</a></li>
+<li><a href="validation.html#sec:validation_issue_ids">10.3. Issue IDs and Messages</a></li>
+<li><a href="validation.html#sec:validation_usage_patterns">10.4. Usage Pattern</a></li>
+<li><a href="validation.html#sec:validation_links">10.5. Links</a></li>
+</ul>
+</li>
+<li><a href="references.html#_references">11. References</a>
+<ul class="sectlevel2">
+<li><a href="references.html#sec:usecases">11.1. Use cases</a></li>
+<li><a href="references.html#sec:calculation_algorithm">11.2. Calculation algorithm</a>
+<ul class="sectlevel3">
+<li><a href="references.html#sec:Xtext_default_implementation">11.2.1. Xtext default implementation</a></li>
+<li><a href="references.html#sec:N4_implementation">11.2.2. N4JS implementation</a></li>
+</ul>
+</li>
+<li><a href="references.html#sec:PerformanceOfDependencyCalculation">11.3. Performance Of Dependency Calculation</a></li>
+<li><a href="references.html#sec:kinds_of_references">11.4. Kinds of references</a>
+<ul class="sectlevel3">
+<li><a href="references.html#sec:Cross_References_to_be_ignored">11.4.1. Cross References to be ignored</a></li>
+<li><a href="references.html#sec:Cross_References_to_be_handled">11.4.2. Cross References to be handled</a></li>
+</ul>
+</li>
+<li><a href="references.html#sec:transitive_dependencies">11.5. Transitive dependencies</a></li>
+<li><a href="references.html#sec:find-references">11.6. Find references</a>
+<ul class="sectlevel3">
+<li><a href="references.html#_background">11.6.1. Background</a></li>
+<li><a href="references.html#_how-find-references-work">11.6.2. How Find References Work</a>
+<ul class="sectlevel4">
+<li><a href="references.html#_step-1-convert-cursor-position-to-declared-element">11.6.2.1. Step 1: Convert Cursor Position to Declared Element</a></li>
+<li><a href="references.html#_step-2-convert-declared-element-to-target-uris">11.6.2.2. Step 2: Convert Declared Element to Target URIs</a></li>
+<li><a href="references.html#_step-3-filter-potential-resources">11.6.2.3. Step 3: Filter Potential Resources</a></li>
+<li><a href="references.html#_step-4-search-references-in-resource">11.6.2.4. Step 4: Search References in Resource</a></li>
+<li><a href="references.html#_limitations-and-possible-enhancements">11.6.2.5. Limitations and Possible Enhancements</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="compilation.html#_compilation">12. Compilation</a>
+<ul class="sectlevel2">
+<li><a href="compilation.html#chap:compilation">12.1. Introduction</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:general_design_rationals">12.1.1. General design rationals</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:logging_and_error_reporting">12.1.1.1. Logging and error reporting</a></li>
+<li><a href="compilation.html#sec:progress_monitor">12.1.1.2. Progress monitor</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Xtext_Integration">12.1.2. Xtext Integration</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:xtext_default_behaviour">12.1.2.1. Xtext default behaviour</a></li>
+<li><a href="compilation.html#sec:n4js_requirements">12.1.2.2. N4JS requirements</a></li>
+<li><a href="compilation.html#sec:compiler_discovery_in_ui">12.1.2.3. Compiler discovery in UI</a></li>
+<li><a href="compilation.html#sec:compiler_discovery_in_headless">12.1.2.4. Compiler discovery in headless</a></li>
+<li><a href="compilation.html#sec:general_generator_implementation">12.1.2.5. General generator implementation</a></li>
+<li><a href="compilation.html#sec:general_generator_activation">12.1.2.6. General generator activation</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Overview_of_Input_Models">12.1.3. Overview of the Input Models</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Core_Generator">12.2. Generators</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:Compiler_Components">12.2.1. Generator Components</a></li>
+<li><a href="compilation.html#sec:Generator_architecture">12.2.2. Generator architecture</a></li>
+<li><a href="compilation.html#sec:Unified_Compiler_Configuration">12.2.3. Unified Compiler Configuration</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Transpilers">12.3. Transpilers</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:Phases">12.3.1. Overview</a></li>
+<li><a href="compilation.html#relation-between-ast-and-im">12.3.2. Relation between AST and IM</a></li>
+<li><a href="compilation.html#implementation-overview">12.3.3. Implementation Overview</a></li>
+<li><a href="compilation.html#sec:Guidelines_for_Implementing_Transformations">12.3.4. Guidelines for Implementing Transformations</a></li>
+<li><a href="compilation.html#symbol-table-in-the-im">12.3.5. Symbol Table in the IM</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:N4JS_to_EcmaScript_Transpiler">12.4. N4JS-to-EcmaScript Transpiler</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:Overview_of_Transformations">12.4.1. Overview of Transformations</a></li>
+<li><a href="compilation.html#sec:Transpiling_members">12.4.2. Transpiling members</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:Transpiling_members__Delegating_members">12.4.2.1. Techniques for special member handling</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__Partial_shadowing_of_getter_setter_pairs">12.4.2.2. Partial shadowing</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__Consuming_or_inheriting_members_of_an_interface">12.4.2.3. Consuming or inheriting members of an interface</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__Static_polyfill">12.4.2.4. Static polyfill</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__API_implementation_stubs">12.4.2.5. API / implementation stubs</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Support_for_incomplete_API_implementation_testing_in_the_N4JS_to_EcmaScript_5_Transpiler">12.4.3. Support for incomplete API implementation testing</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:Modifications_in_Impl_projects">12.4.3.1. Modifications in Impl projects</a></li>
+<li><a href="compilation.html#sec:Implementation_of_stub_generation">12.4.3.2. Implementation of stub-generation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:n4jsc_Headless_Compiler_Interface">12.5. n4jsc Headless Compiler Interface</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:building_the_headless_compiler">12.5.1. building the headless compiler</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="execution.html#_execution">13. Execution</a>
+<ul class="sectlevel2">
+<li><a href="execution.html#sec:N4JS_Project_Execution_And_Linking_Model">13.1. N4JS Project Execution And Linking Model</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#subsec:N4JS_Execution_With_NodeJS">13.1.1. N4JS Execution With NodeJS</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:N4JS_Execution_And_Linking_File">13.2. N4JS Execution And Linking File</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#subsec:NodeJS_Specific_ELF">13.2.1. NodeJS Specific ELF</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Runners-execution">13.3. Runners</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#subsec:N4_Runtime_Environments_Convention">13.3.1. N4 Runtime Environments Convention</a></li>
+<li><a href="execution.html#subsec:Passing_Information_from_IDE_to_Execution_Code_in_Runtime_Environment">13.3.2. Passing Information from IDE to Execution Code in Runtime Environment</a></li>
+<li><a href="execution.html#subsec:Runners_Design">13.3.3. Runners Design</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Legacy_Execution_Engine">13.4. Legacy Execution Engine</a></li>
+<li><a href="execution.html#sec:Design">13.5. Design</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#sec:Usage_Outside_N4JSIDE">13.5.1. Usage Outside N4JSIDE</a>
+<ul class="sectlevel4">
+<li><a href="execution.html#sec:Use_Node_with_Maven">13.5.1.1. Use Node with Maven</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Usage_Inside_N4JSIDE">13.5.2. Usage Inside N4JSIDE</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Runtime_Injection">13.6. Runtime Injection</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#sec:Running_String_Code">13.6.1. Running String Code</a></li>
+<li><a href="execution.html#sec:Running_File_Code">13.6.2. Running File Code</a></li>
+<li><a href="execution.html#sec:Injection_Code_Example">13.6.3. Injection Code Example</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#_tests">14. Tests</a>
+<ul class="sectlevel2">
+<li><a href="tests.html#sec:Performance_Tests">14.1. Performance Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Synthetic_Performance_Tests">14.1.1. Synthetic Performance Tests</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:Design_of_Generator">14.1.1.1. Design of Generator</a></li>
+<li><a href="tests.html#sec:Design_of_Performance_Test_Execution">14.1.1.2. Design of Performance Test Configuration and Execution</a></li>
+<li><a href="tests.html#sec:JUnit_Configuration">14.1.1.3. JUnit Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Test_Configuration">14.1.1.4. JUnitBenchmark Test Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Report_Configuration">14.1.1.5. JUnitBenchmark Report Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Run_Configuration">14.1.1.6. JUnitBenchmark Run Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Example">14.1.1.7. JUnitBenchmark Example</a></li>
+<li><a href="tests.html#sec:Note_on_Jenkins_Job">14.1.1.8. Note on Jenkins Job</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#sec:ECMA_Tests">14.2. ECMA Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Grammar_Tests">14.2.1. Grammar Tests</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:Negative_Tests">14.2.1.1. Negative Tests</a></li>
+<li><a href="tests.html#sec:Test_Exclusion">14.2.1.2. Test Exclusion</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Integration_Tests">14.3. Integration Tests</a></li>
+<li><a href="tests.html#sec:Test_Helpers">14.4. Test Helpers</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Parameterized_N4JS_Tests">14.4.1. Parameterized N4JS tests</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:ParameterizedXtextRunner">14.4.1.1. ParameterizedXtextRunner</a></li>
+<li><a href="tests.html#sec:TestCodeProvider">14.4.1.2. TestCodeProvider</a></li>
+<li><a href="tests.html#sec:Example_Of_Parameterized_Parser_Test">14.4.1.3. Example of parameterized parser test</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Issue_Suppression">14.5. Issue Suppression</a></li>
+<li><a href="tests.html#sec:Xpect_Tests">14.6. Xpect Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Xpect_Test_Setup">14.6.1. Xpect Test Setup</a></li>
+<li><a href="tests.html#sec:Xpect_Issue_Suppression">14.6.2. Xpect Issue Suppression</a></li>
+<li><a href="tests.html#sec:Xpect_Provided_Test_Methods">14.6.3. Xpect Provided Test Methods</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#errors">14.6.3.1. errors</a></li>
+<li><a href="tests.html#warnings">14.6.3.2. warnings</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:N4JS_Specific_Xpect_Test_Methods">14.6.4. N4JS Specific Xpect Test Methods</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:XPECT_noerrors">14.6.4.1. noerrors and nowarnings</a></li>
+<li><a href="tests.html#sec:XPECT_scope">14.6.4.2. scope</a></li>
+<li><a href="tests.html#sec:XPECT_scopeWithPosition">14.6.4.3. scopeWithPosition</a></li>
+<li><a href="tests.html#sec:XPECT_scopeWithResource">14.6.4.4. scopeWithResource</a></li>
+<li><a href="tests.html#sec:XPECT_binding">14.6.4.5. binding</a></li>
+<li><a href="tests.html#sec:XPECT_linkedPathname">14.6.4.6. linkedPathname</a></li>
+<li><a href="tests.html#sec:XPECT_type_of">14.6.4.7. type of</a></li>
+<li><a href="tests.html#sec:XPECT_expectedType">14.6.4.8. expectedType</a></li>
+<li><a href="tests.html#sec:XPECT_elementKeyword">14.6.4.9. elementKeyword</a></li>
+<li><a href="tests.html#sec:XPECT_accessModifier">14.6.4.10. accessModifier</a></li>
+<li><a href="tests.html#sec:XPECT_compileResult">14.6.4.11. compileResult</a></li>
+<li><a href="tests.html#sec:XPECT_output">14.6.4.12. output</a></li>
+<li><a href="tests.html#sec:XPECT_outputRegEx">14.6.4.13. outputRegEx</a></li>
+<li><a href="tests.html#sec:XPECT_calculatedAccessModifier">14.6.4.14. calculatedAccessModifier</a></li>
+<li><a href="tests.html#sec:XPECT_spec">14.6.4.15. spec</a></li>
+<li><a href="tests.html#sec:XPECT_deadCode">14.6.4.16. deadCode</a></li>
+<li><a href="tests.html#sec:XPECT_returnOrThrows">14.6.4.17. returnOrThrows</a></li>
+<li><a href="tests.html#sec:XPECT_lint">14.6.4.18. lint</a></li>
+<li><a href="tests.html#sec:XPECT_lintFails">14.6.4.19. lintFails</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:FIXME_Xpect_modifier">14.6.5. FIXME Xpect modifier</a></li>
+<li><a href="tests.html#sec:Expectmatrix_Xpect_Test_Methods">14.6.6. Expectmatrix Xpect tests</a></li>
+<li><a href="tests.html#xpect-lint-tests">14.6.7. Xpect Lint Tests</a></li>
+</ul>
+</li>
+<li><a href="tests.html#xpect-proposal-tests">14.7. Xpect Proposal Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Validation_vs__Non_Validation">14.7.1. Validation vs. Non-Validation</a></li>
+<li><a href="tests.html#sec:General_Proposal_Test_Features">14.7.2. General Proposal Test Features</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:Test_Variables">14.7.2.1. Test Variables</a></li>
+<li><a href="tests.html#sec:Location_and_Selection">14.7.2.2. at – Location and Selection</a></li>
+<li><a href="tests.html#sec:Multi_Line_Expectations_in_Proposal_Tests">14.7.2.3. Multi Line Expectations in Proposal Tests</a></li>
+<li><a href="tests.html#sec:Timeout">14.7.2.4. Timeout and Performance</a></li>
+</ul>
+</li>
+<li><a href="tests.html#proposals-verify-existence-of-proposals">14.7.3. proposals – Verify Existence of Proposals</a></li>
+<li><a href="tests.html#sec:Verify_displayed_string">14.7.4. display – Verify displayed string</a></li>
+<li><a href="tests.html#sec:Apply_Proposal">14.7.5. apply – Apply Proposal</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#resource-application-in-other-files">14.7.5.1. resource – application in other files</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Content_Assist_Cycling">14.7.6. kind – Content Assist Cycling</a></li>
+<li><a href="tests.html#fileValidVerify-validation-status">14.7.7. fileValid – Verify validation status</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Apply_Proposal_And_Execute_Tests">14.8. Apply Proposal And Execute Tests</a></li>
+<li><a href="tests.html#sec:Organize_Imports_Test">14.9. Organize Imports Test</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#organizeimports">14.9.1. organizeImports</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Access_Control_Test">14.10. Access Control Test</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#test-scenarios">14.10.1. Test Scenarios</a></li>
+<li><a href="tests.html#n4js-code-generator">14.10.2. N4JS Code Generator</a></li>
+<li><a href="tests.html#xtext-issue-matcher">14.10.3. Xtext Issue Matcher</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Smoke_Tests">14.11. Smoke Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#how-to-handle-smoke-test-errors">14.11.1. How to handle smoke test errors?</a></li>
+<li><a href="tests.html#smoketester-and-exceptionanalyzer">14.11.2. SmokeTester and ExceptionAnalyzer</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:UI_Tests_with_SWTBot">14.12. UI Tests with SWTBot</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#writing-swtbot-tests">14.12.1. Writing SWTBot Tests</a></li>
+<li><a href="tests.html#running-swtbot-tests">14.12.2. Running SWTBot Tests</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Debugging_UI_Tests">14.13. Debugging UI Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Connecting_to_the_X_server_on_the_build_node">14.13.1. Connecting to the X-server on the build-node</a></li>
+<li><a href="tests.html#sec:Tools_to_investigate_the_java_stack">14.13.2. Tools to investigate the java-stack</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="ui_concepts.html#_ui-concepts">15. UI Concepts</a>
+<ul class="sectlevel2">
+<li><a href="ui_concepts.html#sec:User_Interface_Concepts">15.1. User Interface Concepts</a>
+<ul class="sectlevel3">
+<li><a href="ui_concepts.html#sec:Eclipse_UI_Concepts">15.1.1. Eclipse UI Concepts</a>
+<ul class="sectlevel4">
+<li><a href="ui_concepts.html#sec:Label_Provider">15.1.1.1. Label Provider</a></li>
+<li><a href="ui_concepts.html#sec:Markers">15.1.1.2. Markers</a></li>
+<li><a href="ui_concepts.html#sec:Commands__Toolbar_and_Menus">15.1.1.3. Commands, Toolbar and Menus</a></li>
+<li><a href="ui_concepts.html#sec:Content_Assist">15.1.1.4. Content Assist</a></li>
+<li><a href="ui_concepts.html#sec:Quick_Fixes">15.1.1.5. Quick Fixes</a></li>
+<li><a href="ui_concepts.html#sec:Quick_Assist">15.1.1.6. Quick Assist</a></li>
+<li><a href="ui_concepts.html#sec:Clean_Up_Actions">15.1.1.7. Clean Up Actions</a></li>
+<li><a href="ui_concepts.html#sec:Save_Actions">15.1.1.8. Save Actions</a></li>
+<li><a href="ui_concepts.html#sec:Auto_Edit">15.1.1.9. Auto Edit</a></li>
+<li><a href="ui_concepts.html#sec:Template_Proposals">15.1.1.10. Template Proposals</a></li>
+<li><a href="ui_concepts.html#sec:Outline_View___Quick_Outline">15.1.1.11. Outline View / Quick Outline</a></li>
+<li><a href="ui_concepts.html#sec:Navigator__Package_Explorer__Project_Explorer">15.1.1.12. Navigator, Package Explorer, Project Explorer</a></li>
+<li><a href="ui_concepts.html#sec:Hyperlinking_and_Navigation">15.1.1.13. Hyperlinking and Navigation</a></li>
+<li><a href="ui_concepts.html#sec:Syntax_and_Semantic_Coloring">15.1.1.14. Syntax and Semantic Coloring</a></li>
+<li><a href="ui_concepts.html#sec:Code_Formatter">15.1.1.15. Code Formatter</a></li>
+<li><a href="ui_concepts.html#sec:Wizards">15.1.1.16. Wizards</a></li>
+<li><a href="ui_concepts.html#sec:Cheat_Sheets">15.1.1.17. Cheat Sheets</a></li>
+<li><a href="ui_concepts.html#sec:Context_sensitive_Help">15.1.1.18. Context-sensitive Help</a></li>
+<li><a href="ui_concepts.html#sec:Hovers">15.1.1.19. Hovers</a></li>
+<li><a href="ui_concepts.html#sec:Folding">15.1.1.20. Folding</a></li>
+<li><a href="ui_concepts.html#sec:Customizable_validation___severity">15.1.1.21. Customizable validation / severity</a></li>
+<li><a href="ui_concepts.html#sec:Proposals">15.1.1.22. Proposals</a></li>
+</ul>
+</li>
+<li><a href="ui_concepts.html#sec:Non_Eclipse_UI_Concepts">15.1.2. Non-Eclipse UI Concepts</a>
+<ul class="sectlevel4">
+<li><a href="ui_concepts.html#sec:Overlays">15.1.2.1. Overlays</a></li>
+<li><a href="ui_concepts.html#sec:Goto__Inferred__Type">15.1.2.2. Goto (Inferred) Type</a></li>
+<li><a href="ui_concepts.html#sec:Postfix_Completion">15.1.2.3. Postfix Completion</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="ui_concepts.html#_user-interface-resources">15.2. User Interface Resources</a>
+<ul class="sectlevel3">
+<li><a href="ui_concepts.html#_icons">15.2.1. Icons</a>
+<ul class="sectlevel4">
+<li><a href="ui_concepts.html#_eclipse-platform-icons">15.2.1.1. Eclipse Platform Icons</a></li>
+<li><a href="ui_concepts.html#_n4js-specific-icons">15.2.1.2. N4JS Specific Icons</a></li>
+<li><a href="ui_concepts.html#_high-resolution-icons">15.2.1.3. High Resolution Icons</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="formatting.html#_formatting">16. Formatting</a>
+<ul class="sectlevel2">
+<li><a href="formatting.html#sec:FmtObjective">16.1. Objective</a>
+<ul class="sectlevel3">
+<li><a href="formatting.html#sec:FmtFormatting_Comments">16.1.1. Formatting Comments</a></li>
+</ul>
+</li>
+<li><a href="formatting.html#sec:FmtArchitecture">16.2. Architecture</a>
+<ul class="sectlevel3">
+<li><a href="formatting.html#sec:Implementation_example">16.2.1. Implementation example</a></li>
+</ul>
+</li>
+<li><a href="formatting.html#sec:FmtFormatter_Implementation_Guidelines">16.3. Formatter Implementation Guidelines</a></li>
+<li><a href="formatting.html#sec:FmtConfiguration">16.4. Configuration</a></li>
+<li><a href="formatting.html#sec:FmtUI_Integration">16.5. UI Integration</a></li>
+<li><a href="formatting.html#sec:FmtUnit_Testing_with_Xpect">16.6. Unit Testing with Xpect</a></li>
+</ul>
+</li>
+<li><a href="#_external-libraries">17. External Libraries</a>
+<ul class="sectlevel2">
+<li><a href="#sec:Major_Components">17.1. Major Components</a>
+<ul class="sectlevel3">
+<li><a href="#subsec:External_Resources">17.1.1. External Resources</a></li>
+<li><a href="#subsec:External_Library_Workspace">17.1.2. External Library Workspace</a></li>
+<li><a href="#subsec:External_Library_Preference_Store">17.1.3. External Library Preference Store</a></li>
+<li><a href="#subsec:npm_Manager">17.1.4. Library Manager</a></li>
+<li><a href="#subsec:External_Library_Builder_Helper">17.1.5. External Library Builder</a></li>
+<li><a href="#subsec:External_Library_Xtext_Index_Persister">17.1.6. External Library Xtext Index Persister</a></li>
+<li><a href="#subsec:External_Library_Preference_Page">17.1.7. External Library Preference Page</a></li>
+</ul>
+</li>
+<li><a href="#sec:Headless_External_Library_Support">17.2. Headless External Library Support</a>
+<ul class="sectlevel3">
+<li><a href="#_custom-npm-settings">17.2.1. Custom npm settings</a></li>
+</ul>
+</li>
+<li><a href="#sec:lmFutureWork">17.3. Future Work</a>
+<ul class="sectlevel3">
+<li><a href="#subsec:lmMultipleDependencyScope">17.3.1. Multiple Dependency Scope</a></li>
+<li><a href="#subsec:lmRunTestsFromLibrary">17.3.2. Run Tests from TestLibrary</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="json_support.html#sec:JSON_Support">18. JSON Support</a>
+<ul class="sectlevel2">
+<li><a href="json_support.html#sec:JSON_Parser">18.1. JSON Parser</a>
+<ul class="sectlevel3">
+<li><a href="json_support.html#sec:JSON_Parser_Unicode_Escaping">18.1.1. Escaping Unicode Control Characters in String Literals</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Empty_Text">18.1.2. Empty Text</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Nested_Structures">18.1.3. Nested Structures</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Whitespace">18.1.4. Whitespace</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Comments">18.1.5. Comments</a></li>
+</ul>
+</li>
+<li><a href="json_support.html#sec:JSON_Language_Extensions">18.2. JSON Language Extensions</a>
+<ul class="sectlevel3">
+<li><a href="json_support.html#sec:JSON_Validator_Extensions">18.2.1. JSON Validator Extensions</a>
+<ul class="sectlevel4">
+<li><a href="json_support.html#sec:File_Specitic_Validator_Extensions">18.2.1.1. File-Specific Validator Extensions</a></li>
+<li><a href="json_support.html#sec:JSON_Declarative_JSON_Validator_Extensions">18.2.1.2. Declarative JSON Validator Extensions</a></li>
+</ul>
+</li>
+<li><a href="json_support.html#_json-resource-description-strategy">18.2.2. JSON Resource Description Strategy</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_jsdoc">19. JSDoc</a>
+<ul class="sectlevel2">
+<li><a href="jsdoc.html#sec:Design_Rationale">19.1. Design Rationale</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#_general-design">19.1.1. General Design</a></li>
+<li><a href="jsdoc.html#sec:Type_Expressions">19.1.2. Type Expressions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="docexporter.html#_docexporter">20. DocExporter</a>
+<ul class="sectlevel2">
+<li><a href="docexporter.html#sec:Specification_Exporter">20.1. Specification Exporter</a></li>
+</ul>
+</li>
+<li><a href="rename_refactoring.html#_rename-refactoring">21. Rename Refactoring</a>
+<ul class="sectlevel2">
+<li><a href="rename_refactoring.html#_rename-refactoring-ui-interaction">21.1. Rename Refactoring UI interaction</a></li>
+<li><a href="rename_refactoring.html#_renameelementprocessor-interaction">21.2. RenameElementProcessor interaction</a></li>
+</ul>
+</li>
+<li><a href="flow_graphs.html#chap:flowgraphs">22. Flow Graphs</a>
+<ul class="sectlevel2">
+<li><a href="flow_graphs.html#sec:flowgraphs_overview">22.1. Flow graphs overview</a>
+<ul class="sectlevel3">
+<li><a href="flow_graphs.html#_internal-graph">22.1.1. Internal graph</a></li>
+<li><a href="flow_graphs.html#_optimizations">22.1.2. Optimizations</a></li>
+<li><a href="flow_graphs.html#_api-for-client-analyses">22.1.3. API for client analyses</a>
+<ul class="sectlevel4">
+<li><a href="flow_graphs.html#_mapping-from-internal-to-ast-elements">22.1.3.1. Mapping from internal to AST elements</a></li>
+<li><a href="flow_graphs.html#_graph-visitor">22.1.3.2. Graph visitor</a></li>
+<li><a href="flow_graphs.html#_graph-explorer">22.1.3.3. Graph explorer</a></li>
+<li><a href="flow_graphs.html#_branch-walker">22.1.3.4. Branch walker</a></li>
+<li><a href="flow_graphs.html#_example-1-compute-string-for-each-path">22.1.3.5. Example 1: Compute string for each path</a></li>
+<li><a href="flow_graphs.html#_path-quantor">22.1.3.6. Path quantor</a></li>
+</ul>
+</li>
+<li><a href="flow_graphs.html#_control-flow-analyses">22.1.4. Control flow analyses</a>
+<ul class="sectlevel4">
+<li><a href="flow_graphs.html#_dead-code-analysis">22.1.4.1. Dead code analysis</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="flow_graphs.html#sec:dataflow">22.2. Dataflow</a>
+<ul class="sectlevel3">
+<li><a href="flow_graphs.html#_dataflow-graph">22.2.1. Dataflow graph</a></li>
+<li><a href="flow_graphs.html#_dataflow-analyses">22.2.2. Dataflow analyses</a>
+<ul class="sectlevel4">
+<li><a href="flow_graphs.html#_def-def-def-nothing-analysis">22.2.2.1. Def&#8594;Def / Def&#8594;Nothing analysis</a></li>
+<li><a href="flow_graphs.html#_def-use-decl-analysis">22.2.2.2. Def|Use&#8592;Decl analysis</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="publish_npms.html#sec:publish-npms-to-public">23. Publish npms</a>
+<ul class="sectlevel2">
+<li><a href="publish_npms.html#sec:publish-npms-n4js-maven">23.1. Publish n4js-libs to during  maven build</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Hints">Appendix A: Hints</a>
+<ul class="sectlevel2">
+<li><a href="appendix_a_hints.html#sec:XtextInjection">A.1. Xtext Injection</a>
+<ul class="sectlevel3">
+<li><a href="appendix_a_hints.html#sec:DI_MultipleInjectors_Singletons">A.1.1. Multiple Injectors and Singletons</a>
+<ul class="sectlevel4">
+<li><a href="appendix_a_hints.html#sec:DI_avoid_duplicate_singletons">A.1.1.1. Avoiding duplicate singletons</a>
+<ul class="sectlevel5">
+<li><a href="appendix_a_hints.html#sec:DI_binding_in_shared">A.1.1.1.1. Defining binding in the shared injector</a></li>
+<li><a href="appendix_a_hints.html#sec:DI_binding_in_custom">A.1.1.1.2. Defining binding in the custom injector</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:DI_Hints">A.1.2. Dependency Injection Hints</a>
+<ul class="sectlevel4">
+<li><a href="appendix_a_hints.html#sec:DI_custom_bundle">A.1.2.1. Use DI in custom bundle, use DI with extensions</a>
+<ul class="sectlevel5">
+<li><a href="appendix_a_hints.html#sec:DI_custom_bundle_problem">A.1.2.1.1. Problem</a></li>
+<li><a href="appendix_a_hints.html#sec:DI_custom_bundle_solution">A.1.2.1.2. Solution</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Access_Other_DSL_Injector">A.1.2.2. How do I get the Guice Injector of my language?</a>
+<ul class="sectlevel5">
+<li><a href="appendix_a_hints.html#sec:DSL_Injector_UI_context">A.1.2.2.1. UI context</a></li>
+<li><a href="appendix_a_hints.html#sec:DSL_Injector_Non_UI_context">A.1.2.2.2. Non UI context but with injection context</a></li>
+<li><a href="appendix_a_hints.html#sec:DSL_Injector_Non_UI_non_injection_context">A.1.2.2.3. Non UI context without injection context</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Cancel_Indicator">A.1.2.3. How do I get cancel indicators in different contexts?</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Eclipse">A.2. Eclipse</a>
+<ul class="sectlevel3">
+<li><a href="appendix_a_hints.html#sec:Show_Xtext_Index">A.2.1. Show the current Xtext index</a></li>
+<li><a href="appendix_a_hints.html#sec:Plugin_spy">A.2.2. Plug-in spy</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Maven-hints">A.3. Maven</a>
+<ul class="sectlevel3">
+<li><a href="appendix_a_hints.html#how-to-check-for-maven-mojo-updates">A.3.1. How to check for Maven MOJO updates</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#_module-loading">Appendix B: Module Loading</a>
+<ul class="sectlevel2">
+<li><a href="appendix_b_module_loading.html#sec:Dependency_Management">B.1. Dependency Management</a></li>
+<li><a href="appendix_b_module_loading.html#ecmascript-modules">B.2. ECMAScript Modules</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:ES5_Modules_Systems">B.2.1. ES5 Modules Systems</a></li>
+<li><a href="appendix_b_module_loading.html#sec:ES6_Modules">B.2.2. ES6 Modules</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:ECMAScript_Module_Loaders">B.3. ECMAScript Module Loaders</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:ES6_Module_Loaders">B.3.1. ES6 Module Loaders</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Polyfills_for_ES6_Module_Loaders">B.3.2. Polyfills for ES6 Module Loaders</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:es6_module_loader">B.3.2.1. es6-module-loader</a></li>
+<li><a href="appendix_b_module_loading.html#sec:SystemJS">B.3.2.2. SystemJS</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Demo">B.3.2.3. Demo</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#case-study-typescript">B.4. Case Study : TypeScript</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:ES6_Modules_Support">B.4.1. ES6 Modules Support</a></li>
+<li><a href="appendix_b_module_loading.html#sec:TypeScript_and_Module_Loading">B.4.2. TypeScript and Module Loading</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Cyclic_Dependencies">B.5. Cyclic Dependencies</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:Setup">B.5.1. Setup</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Transpile_and_Execute">B.5.2. Transpile and Execute</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Module_Format___AMD">B.5.2.1. Module Format = AMD</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Module_Format___CommonJS">B.5.2.2. Module Format = CommonJS</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Module_Format___SystemJS">B.5.2.3. Module Format = SystemJS</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Conclusion">B.5.3. Conclusion</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#system.register-as-transpilation-target">B.6. System.register as transpilation target</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:Introduction">B.6.1. Introduction</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:External_Transpilers">B.6.1.1. External Transpilers</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Example_of_a_System_register_module">B.6.1.2. Example of a System.register module</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Structure_of_a_System_register_module">B.6.2. Structure of a System.register module</a></li>
+<li><a href="appendix_b_module_loading.html#_transpilation-hints">B.6.3. Transpilation Hints</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Handling_Imports">B.6.3.1. Handling Imports</a></li>
+<li><a href="appendix_b_module_loading.html#sec:__exportFn__">B.6.3.2. &lt;&lt;exportFn&gt;&gt;</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Handling_Exports">B.6.3.3. Handling Exports</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Examples_w__Circular_Dependencies">B.6.4. Examples w/ Circular Dependencies</a></li>
+<li><a href="appendix_b_module_loading.html#sec:N4JS_Examples_w__Circular_Dependencies">B.6.5. N4JS Examples w/ Circular Dependencies</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Unresolved_Cyclic_Dependencies">B.6.5.1. Unresolved Cyclic Dependencies</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Variables___Functions">B.6.5.2. Examples with Variables &amp; Functions</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Classes">B.6.5.3. Examples with Classes</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Examples_with_SubClassing">B.6.5.4. Examples with SubClassing</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Miscellaneous">B.6.5.5. Miscellaneous</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#_resources">B.6.6. Resources</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:CommonJS_as_transpilation_target">B.7. CommonJS as transpilation target</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#_introduction-2">B.7.1. Introduction</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Transpilation_Hints">B.7.2. Transpilation Hints</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Import_Statements">B.7.2.1. Import Statements</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Export_Statements">B.7.2.2. Export Statements</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Tracking_Live_Bindings">B.7.2.3. Tracking Live Bindings</a></li>
+<li><a href="appendix_b_module_loading.html#sec:A_complete_example">B.7.2.4. A complete example</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#_resources-2">B.7.3. Resources</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_c_license.html#sec:License">Appendix C: License</a></li>
+<li><a href="appendix_d_acronyms.html#sec:Acronyms">Appendix D: Acronyms</a></li>
+<li><a href="appendix_e_bibliography_and_footnotes.html#_bibliography-and-footnotes">Appendix E: Bibliography and Footnotes</a></li>
+</ul>
+</div>
+</div>
+<div id="content"><div class="sect1">
+<h2 id="_external-libraries"><a class="anchor" href="#_external-libraries"></a><a class="link" href="#_external-libraries">17. External Libraries</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p></p>
+</div>
+<div class="sidebarblock">
+<div class="content">
+<a href="https://github.com/eclipse/n4js/issues/1018" class="gray" title="GitHub Issues"><span class="image"><img src="images/issue.svg" alt=""></span> #1018</a>
+<a href="https://github.com/eclipse/n4js/issues/397" class="gray" title="GitHub Issues"><span class="image"><img src="images/issue.svg" alt=""></span> #397</a>
+<a href="https://github.com/eclipse/n4js/issues/809" class="gray" title="GitHub Issues"><span class="image"><img src="images/issue.svg" alt=""></span> #809</a>
+<a href="https://github.com/eclipse/n4js/issues/714" class="gray" title="GitHub Issues"><span class="image"><img src="images/issue.svg" alt=""></span> #714</a>
+<a href="https://github.com/eclipse/n4js/issues/653" class="gray" title="GitHub Issues"><span class="image"><img src="images/issue.svg" alt=""></span> #653</a>
+<a href="https://github.com/eclipse/n4js/issues/862" class="gray" title="GitHub Issues"><span class="image"><img src="images/issue.svg" alt=""></span> #862</a>
+<a href="https://github.com/eclipse/n4js/issues/1133" class="gray" title="GitHub Issues"><span class="image"><img src="images/issue.svg" alt=""></span> #1133</a>
+</div>
+</div>
+<div class="paragraph">
+<p><strong>External libraries</strong> are N4JS projects that are provided by the N4JS IDE:
+the <em>built-in</em>/<em>shipped</em> libraries, and all <em>3rd-party libraries</em> that were installed by the <em>N4JS library manager</em>.
+Each external library consist of a valid package.json file located in the project root and an arbitrary number of files supported by N4JS projects, e.g. <em>.n4js</em>, <em>.njsd</em> and <em>.js</em> files.
+The purpose of the external libraries is to share and to provide core and third party functionality for N4JS developers both in compile and runtime without rebuilding them.</p>
+</div>
+<div class="paragraph">
+<p><a href="#sec:Built-in_External_Libraries">[sec:Built-in_External_Libraries]</a> are external libraries that provide some basic functionality for N4JS programmers, such as the class <code>N4Injector</code>.</p>
+</div>
+<div class="paragraph">
+<p><strong>3rd-party libraries</strong> are external libraries that are not built-in/shipped with the N4JS IDE.
+Instead, they can be installed later by the user from third party providers.
+Currently, only <em>npm packages</em> are supported.</p>
+</div>
+<div class="paragraph">
+<p>The <strong>N4JS index</strong> is populated when the external libraries are compiled.
+However, this compilation is only triggered through the library manager, but not when building workspace projects. (Self-evidently, the index is also populated when compiling workspace projects.)</p>
+</div>
+<div class="paragraph">
+<p><strong>Name clashes</strong> of projects can happen and they are solved in the following order:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>User workspace projects always shadow external libraries.</p>
+</li>
+<li>
+<p>In case of a name clash between a shipped and a 3rd-party library, the 3rd-party library shadows the shipped project.</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>The <strong>N4JS library manager</strong> is a tool in the N4JS IDE to view and manage external libraries.
+In particular, the user can (un-)install new 3rd-party libraries, or can trigger the build of all external libraries to re-populate the N4JS index.
+The library manager also supports other maintenance actions such as deleting all 3rd-party libraries.</p>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:Major_Components"><a class="anchor" href="#sec:Major_Components"></a><a class="link" href="#sec:Major_Components">17.1. Major Components</a></h3>
+<div class="paragraph">
+<p>External libraries are supported based on different components all over the application.</p>
+</div>
+<div class="paragraph">
+<p>The followings are the most important ones:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><strong>External Resources</strong> (<code>IExternalResource</code>)</p>
+<div class="ulist">
+<ul>
+<li>
+<p>These are customized <code>IResource</code> implementations for external projects, folders and files.</p>
+</li>
+<li>
+<p>With this approach the <code>IProject</code>, <code>IFolder</code> and <code>IFile</code> interfaces have been implemented. Each implementation is backed by a pure <code>java.io.File</code> based resource.</p>
+</li>
+<li>
+<p>When accessing such external resources for example visiting purposes, getting the members of the resource or simply deleting the resource, internally each requests will be directly performed on the wrapped <code>java.io.File</code> without accessing the <code>org.eclipse.core.resources.IWorkspace</code> instance.</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p><strong>External Library Workspace</strong></p>
+<div class="ulist">
+<ul>
+<li>
+<p>This is a kind of dedicated workspace for external libraries and their dependencies.</p>
+</li>
+<li>
+<p>Any query requests to retrieve a particular project or any dependencies of a particular project via the <code>IN4JSCore</code> singleton service will delegated to its wrapped <code>N4JSModel</code> singleton. Internally the <code>N4JSModel</code> has a reference to a workspace for all the ordinary workspace projects and another reference to the workspace for external libraries. Each query requests will be forwarded to the workspace for the ordinary projects first, and then to the external library workspace. If ordinary project workspace can provide any meaningful response for a request, then the external library workspace will not be accessed at all. Otherwise the query will be executed against the external library workspace. This fallback mechanism provides a pragmatic solution to the project shadowing feature. The project shadowing will be described in details later in this section.</p>
+</li>
+<li>
+<p>The <strong>External Library Workspace</strong> is only supported and available in the IDE case, in the headless case there are no external libraries available from this dedicated workspace. Since the Xtext index creation and the entire build infrastructure is different, it is supported via target platform file. This is described in more details in a later section (<a href="#sec:Headless_External_Library_Support">Headless External Library Support</a>]).</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p><strong>External Library Preference Store</strong></p>
+<div class="ulist">
+<ul>
+<li>
+<p>This preference store is being used to register and un-register external library root folders into its underlying ordered list. A folder is called as an external library root folder if it is neither equal with the Eclipse workspace root nor being nested in the workspace root and contains zero to any external libraries.</p>
+</li>
+<li>
+<p>Whenever any modifications are being saved in this preference store the <em>External Library Workspace</em> will be updated as well, new libraries will be registered into the workspace and removed libraries will be cleaned up from the workspace.</p>
+</li>
+<li>
+<p>When the N4JS IDE application is started in production mode, the initial state of the preference store is being pre-populated with default values. This is necessary to provide built-in libraries to end users. These default values and additional advanced configurations will be mentioned in more details later in this section.</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p><strong>Library Manager</strong></p>
+<div class="ulist">
+<ul>
+<li>
+<p>This service is responsible for downloading and installing third party <em>npm</em> packages into the <code>node_modules</code> folder of the N4JS IDE. After downloading, the newly-installed and/or updated packages are registered as external libraries into the system.</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p><strong>External Library Builder</strong></p>
+<div class="ulist">
+<ul>
+<li>
+<p>This service is responsible for updating the persistent Xtext index with the currently available external libraries.</p>
+</li>
+<li>
+<p>Unlike in case of any other ordinary projects, this builder does not triggers a build via the <code>org.eclipse.core.internal.events.BuildManager</code> but modifies the persisted Xtext index (<code>IBuilderState</code>) directly.</p>
+</li>
+<li>
+<p>Considers shadowed external libraries when updating the persisted Xtext index.</p>
+</li>
+<li>
+<p>Makes sure that the external library related Xtext index is persistent and will be available on the next application startup.</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p><strong>External Library Xtext Index Persister</strong></p>
+<div class="ulist">
+<ul>
+<li>
+<p>This class is responsible for recovering the consistent external library Xtext index state at application startup.</p>
+</li>
+<li>
+<p>Scheduled on the very first application startup to prepare the Xtext index for the available external libraries.</p>
+</li>
+<li>
+<p>Recovers the Xtext index state after a force quit and/or application crash.</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p><strong>External Library Preference Page</strong></p>
+<div class="ulist">
+<ul>
+<li>
+<p>Preference page to configure and update the state of the <em>External Library Preference Store</em>.</p>
+</li>
+<li>
+<p>Provides a way to install <em>npm</em> dependencies as external libraries into the application.</p>
+</li>
+<li>
+<p>Reloads the external libraries. Gets the most recent state of N4JS type definition files and updates the Xtext index content based on the current state of the external libraries.</p>
+</li>
+<li>
+<p>Exports the current npm dependency configuration as a target platform file. This will be discussed in another section ([sec:Headless_External_Library_Support]).</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p><strong>Miscellaneous UI Features</strong></p>
+<div class="ulist">
+<ul>
+<li>
+<p>Searching for types provided by external libraries.</p>
+</li>
+<li>
+<p>Opening external modules in read-only editor.</p>
+</li>
+<li>
+<p>Navigation between external types.</p>
+</li>
+<li>
+<p><em>Project Explorer</em> contribution for showing external dependencies for ordinary workspace projects.</p>
+</li>
+<li>
+<p>Editor-navigator linking support for external modules.</p>
+</li>
+<li>
+<p>Installing third party npm dependencies directly from package.json editor via a quick fix.</p>
+</li>
+</ul>
+</div>
+</li>
+</ul>
+</div>
+<div class="sect3">
+<h4 id="subsec:External_Resources"><a class="anchor" href="#subsec:External_Resources"></a><a class="link" href="#subsec:External_Resources">17.1.1. External Resources</a></h4>
+<div class="paragraph">
+<p>This approach provides a very pragmatic and simple solution to support external libraries in both in the <code>IN4JSCore</code> and in the <code>IBuilderState</code>. While <code>IN4JSCore</code> supports a completely transparent way of external libraries via the <code>IN4JSProject</code> interface all over in the application, the <code>IBuilderState</code> is responsible for keeping the Xtext index content up to date with the external libraries. Below picture depicts the hierarchy between the ordinary <code>IResource</code> and the <code>IExternalResource</code> instances. As described above each external resource is backed by a <code>java.io.File</code> resource and each access and operation being invoked on the <code>IResource</code> interface will be delegated to this backing resource.</p>
+</div>
+<div id="fig:External_Resources_Hierarchy" class="imageblock center">
+<div class="content">
+<img src="chapters/20_externalLibraries/images/externalResources.svg" alt="externalResources">
+</div>
+<div class="title">Figure 48. External Resources Hierarchy</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="subsec:External_Library_Workspace"><a class="anchor" href="#subsec:External_Library_Workspace"></a><a class="link" href="#subsec:External_Library_Workspace">17.1.2. External Library Workspace</a></h4>
+<div class="paragraph">
+<p>External library workspace is an extension of the <code>InternalN4JSWorkspace</code>. This workspace is used for storing and managing external libraries all over the application. External libraries can be registered into the workspace by providing one to many external library root folder locations. The provided root folder locations will be visited in an ordered fashion and the contained external libraries (N4JS projects) will be registered into the application. If an external library from a root folder has been registered, then a forthcoming occurrence of an external library with the same artefact identifier (and same folder name) will be ignored at all. For instance let assume two external library root locations are available <code>ER1</code> and <code>ER2</code>, also <code>ER1</code> contains <code>P1</code> and <code>P2</code> external libraries, while <code>ER2</code> contains <code>P2</code> and <code>P3</code>. After registering the two roots into the workspace <code>ER1</code> will be processed first, and <code>P1</code> and <code>P2</code> will be registered to the workspace, when processing the forthcoming <code>ER2</code> root, <code>P2</code> will be ignored at all as an external with the same name exists. Finally <code>P3</code> will be registered to the workspace. External libraries cannot be registered directly into the workspace it is done automatically by the <em>External Library Preference Store</em> and by the <em>npm Manager</em>.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="subsec:External_Library_Preference_Store"><a class="anchor" href="#subsec:External_Library_Preference_Store"></a><a class="link" href="#subsec:External_Library_Preference_Store">17.1.3. External Library Preference Store</a></h4>
+<div class="paragraph">
+<p>This persistent cache is used for storing an ordered enumeration of registered external library root folder locations. Whenever its internal state is being persisted after a modification, all registered modification listeners will be synchronously notified about this change. All listeners will receive the store itself with the updated state. There are a couple of registered listeners all over the application listening to store update events but the most important one is the <em>External Library Workspace</em> itself. After receiving an external library preference store update event, the external library workspace will calculate the changes from its own state: creates a sort of difference by identifying added, removed and modified external libraries. Also tracks external library root location order changes. Once the workspace has calculated the changes<sup class="footnote">[<a id="_footnoteref_18" class="footnote" href="appendix_e_bibliography_and_footnotes.html#_footnote_18" title="View footnote.">18</a>]</sup> it will interact with the <em>External Library Builder Helper</em> which will eventually update the persisted Xtext index directly through the <code>IBuilderState</code>. After the Xtext index content update all ordinary workspace projects that directly depend either on a built or a cleaned external library will be automatically rebuilt by the external library workspace.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="subsec:npm_Manager"><a class="anchor" href="#subsec:npm_Manager"></a><a class="link" href="#subsec:npm_Manager">17.1.4. Library Manager</a></h4>
+<div class="paragraph">
+<p>This service is responsible for downloading, installing third party npm dependencies into the local file system. This is done directly by <code>npm</code> from <code>Node.js</code>. Once an npm package has been downloaded and installed it will be registered into the external library workspace. As part of the registration, the Xtext index content will be updated and all dependent ordinary workspace projects will be rebuilt automatically. An npm package cannot be installed via the <em>Library Manager</em> if it already installed previously.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="subsec:External_Library_Builder_Helper"><a class="anchor" href="#subsec:External_Library_Builder_Helper"></a><a class="link" href="#subsec:External_Library_Builder_Helper">17.1.5. External Library Builder</a></h4>
+<div class="paragraph">
+<p>This builder is responsible for updating the persisted Xtext index state with external library content directly through the <code>IBuilderState</code>. When providing a subset of external libraries to either build or clean, internally it orders the provided external libraries based on the project dependencies. Also, it might skip building all those external libraries that have are being shadowed by a workspace counterpart. An external library is being shadowed by an ordinary workspace project, if the workspace project is accessible and has exactly the same project name as the external library.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="subsec:External_Library_Xtext_Index_Persister"><a class="anchor" href="#subsec:External_Library_Xtext_Index_Persister"></a><a class="link" href="#subsec:External_Library_Xtext_Index_Persister">17.1.6. External Library Xtext Index Persister</a></h4>
+<div class="paragraph">
+<p>By default Xtext provides a way to fix corrupted index or to recreate it from scratch in case of its absence. Such inconsistent index states could occur due to application crashes or due to non-graceful application shutdowns. Although this default recovery mechanism provided by Xtext works properly, it is provided only for projects that are available in the Eclipse based workspace (<code>org.eclipse.core.resources.IWorkspace</code>) but non of the external libraries are not available from the Eclipse based workspace, so inconsistent external library index content cannot be recovered by this default mechanism. N4JS IDE contributes its own logic to recover index state of external N4JS libraries. When the default Xtext index recovery runs, then it will trigger a external reload as well. This external reload is guaranteed to run always after the default recovery mechanism.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="subsec:External_Library_Preference_Page"><a class="anchor" href="#subsec:External_Library_Preference_Page"></a><a class="link" href="#subsec:External_Library_Preference_Page">17.1.7. External Library Preference Page</a></h4>
+<div class="paragraph">
+<p>This preference page provides a way to configure the external libraries by adding and removing external library root folders, also allows the user to reorder the configured external library root locations. Besides that, npm packages can be installed into the application as external libraries. Neither removing nor reordering built-in external libraries are supported, hence these operations are disabled for built-ins on the preference page. No modifications will take effect unless the changes are persisted with the <code>Apply</code> button. One can reset the configurations to the default state by clicking on the <code>Restore Defaults</code> button then on the <code>Apply</code> button. The <code>Reload</code> button will check whether new type definition files are available for npm dependencies, then reloads the persistent Xtext index content based on the available external libraries. Once the external library reloading has been successfully finished, all dependent workspace projects will be rebuilt as well. From the preference page one can export the installed and used third party npm packages as a target platform. This exported target platform file can be used with the headless compiler. After setting up the headless compiler with this exported target platform file, the headless tool will collect and download all required third party npm dependencies.</p>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:Headless_External_Library_Support"><a class="anchor" href="#sec:Headless_External_Library_Support"></a><a class="link" href="#sec:Headless_External_Library_Support">17.2. Headless External Library Support</a></h3>
+<div class="paragraph">
+<p>The headless compiler is not capable of supporting built-in libraries. The whole build and Xtext index creation infrastructure is different in the IDE and in the headless case. Also, due to its archive nature (<code>n4jsc.jar</code>) of the headless tool, neither the runtime nor the <code>Mangelhaft</code> libraries can be loaded into the headless compiler.</p>
+</div>
+<div class="paragraph">
+<p>The headless compiler supports downloading, installing and using third party <code>npm</code> packages. To enable this feature one has to configure the target platform via the <code>–targetPlatformFile</code> (or simply <code>-tp</code>) and the <code>–targetPlatformInstallLocation</code> (or simply <code>-tl</code>) arguments.</p>
+</div>
+<div class="paragraph">
+<p>If the target platform file argument is configured, then all third party dependencies declared in the target platform file will be downloaded, installed and made available for all the N4JS projects before the compile (and run) phase. If the target platform file is given but the target platform install location is not specified (via the <code>–targetPlatformInstallLocation</code> argument), then a the compilation phase will be aborted and the execution will be interrupted.</p>
+</div>
+<div class="paragraph">
+<p>For more convenient continuous integration and testing purposes there are a couple of additional exception cases with respect to the the target platform file and location that users of the headless compiler have to keep in mind. These are the followings:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>–targetPlatformSkipInstall</code>. Usually dependencies defined in the target platform file will be installed into the folder defined by option <code>–targetPlatformInstallLocation</code>. If this flag is provided, this installation will be skipped, assuming the given folder already contains the required files and everything is up-to-date. Users have to use this flag with care, because no checks will be performed whether the location actually contains all required dependencies.</p>
+</li>
+<li>
+<p>If <code>–targetPlatformSkipInstall</code> is provided the <code>–targetPlatformInstallLocation</code> parameter is completely ignored.</p>
+</li>
+<li>
+<p>If <code>–targetPlatformSkipInstall</code> is provided the <code>–targetPlatformFile</code> parameter is completely ignored.</p>
+</li>
+<li>
+<p>If neither <code>–targetPlatformInstallLocation</code> not <code>–targetPlatformFile</code> parameters are specified the headless tool will treat this case as an implicit <code>–targetPlatformSkipInstall</code> configuration.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>If the target platform install location is configured, and the target platform file is given as well, then all third party dependencies specified in the target platform file will be downloaded to that given location. If the target platform file is given, but the target platform install location is not specified, then a the compilation phase will be aborted and the execution will be interrupted.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-bash" data-lang="bash">java -jar n4jsc.jar -projectlocations /path/to/the/workspace/root -t allprojects -tp /absolute/path/to/the/file -tl /path/to/the/target/platform/install/location -rw nodejs -r moduleToRun</code></pre>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_custom-npm-settings"><a class="anchor" href="#_custom-npm-settings"></a><a class="link" href="#_custom-npm-settings">17.2.1. Custom npm settings</a></h4>
+<div class="paragraph">
+<p>In some cases there is a need for custom npm settings, e.g. custom npm registry. Those kind of configurations are
+supported via <code>.npmrc</code> file (see <a href="https://docs.npmjs.com/files/npmrc" class="bare">https://docs.npmjs.com/files/npmrc</a>).</p>
+</div>
+<div class="paragraph">
+<p>In N4JSIDE user can specify path to his custom configuration file in the preference page.</p>
+</div>
+<div class="paragraph">
+<p>For the commandline N4JSC.jar provides special option <code>-npmrcRootLocation</code> that allows headless compiler to
+use custom settings.</p>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="sec:lmFutureWork"><a class="anchor" href="#sec:lmFutureWork"></a><a class="link" href="#sec:lmFutureWork">17.3. Future Work</a></h3>
+<div class="paragraph">
+<p>Some aspects not covered in current design, but worth consideration in the future</p>
+</div>
+<div class="sect3">
+<h4 id="subsec:lmMultipleDependencyScope"><a class="anchor" href="#subsec:lmMultipleDependencyScope"></a><a class="link" href="#subsec:lmMultipleDependencyScope">17.3.1. Multiple Dependency Scope</a></h4>
+<div class="paragraph">
+<p>npm scope dependencies</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><strong>DEPENDENCY_DEVELOPMENT</strong> </dt>
+<dd>
+<p><a href="https://docs.npmjs.com/files/package.json#devdependencies" class="bare">https://docs.npmjs.com/files/package.json#devdependencies</a></p>
+</dd>
+<dt class="hdlist1"><strong>DEPENDENCY_PEER</strong> </dt>
+<dd>
+<p><a href="https://docs.npmjs.com/files/package.json#peerdependencies" class="bare">https://docs.npmjs.com/files/package.json#peerdependencies</a></p>
+</dd>
+<dt class="hdlist1"><strong>DEPENDENCY_BUNDLE</strong> </dt>
+<dd>
+<p><a href="https://docs.npmjs.com/files/package.json#bundleddependencies" class="bare">https://docs.npmjs.com/files/package.json#bundleddependencies</a></p>
+</dd>
+<dt class="hdlist1"><strong>DEPENDENCY_OPTIONAL</strong> </dt>
+<dd>
+<p><a href="https://docs.npmjs.com/files/package.json#optionaldependencies" class="bare">https://docs.npmjs.com/files/package.json#optionaldependencies</a></p>
+</dd>
+<dt class="hdlist1"><strong>DEPENDENCY_PROVIDES</strong> </dt>
+<dd>
+<p><a href="http://www.rpm.org/wiki/PackagerDocs/Dependencies#Provides" class="bare">http://www.rpm.org/wiki/PackagerDocs/Dependencies#Provides</a></p>
+</dd>
+<dt class="hdlist1"><strong>DEPENDENCY_WEAK</strong> </dt>
+<dd>
+<p><a href="http://www.rpm.org/wiki/PackagerDocs/Dependencies#Weakdependencies" class="bare">http://www.rpm.org/wiki/PackagerDocs/Dependencies#Weakdependencies</a></p>
+</dd>
+</dl>
+</div>
+</div>
+<div class="sect3">
+<h4 id="subsec:lmRunTestsFromLibrary"><a class="anchor" href="#subsec:lmRunTestsFromLibrary"></a><a class="link" href="#subsec:lmRunTestsFromLibrary">17.3.2. Run Tests from TestLibrary</a></h4>
+<div class="paragraph">
+<p>Imagine we are implementing some API, and we want to run tests for that API. Tests are delivered to us as separate package, and there is not direct association between implementation and test projects (tests are not depending on implementation). Still we want to run provided tests to see if our implementation complies with API tests, e.g. AcceptanceTest suite for Application written against application sdk.</p>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div id="footer">
+<div id="footer-text">
+Version 0.9<br>
+Last updated 2019-08-07 15:02:40 CEST
+</div>
+</div>
+<!-- ************* docinfo-footer *************************************************************** -->
+<div class="Grid social" style="color:#d5dfea">
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <h2>Quick Links</h2>
+    <ul>
+      <li><a href="../downloads.html">Download</a></li>
+      <li><a href="../userguides/index.html">Documentation</a></li>
+      <li><a href="https://github.com/eclipse/n4js/">Source</a></li>
+      <li><a href="https://github.com/eclipse/n4js/issues">Issues</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="https://www.eclipse.org/forums/index.php/f/365/">Forum</a></li>
+      <li><a href="http://n4js.blogspot.de/">Blog</a></li>
+      <li><a href="https://dev.eclipse.org/mailman/listinfo/n4js-dev">Mailing List</a></li>
+      <li><a href="https://projects.eclipse.org/projects/technology.n4js">Eclipse Project Page</a></li>
+      <li><a href="https://twitter.com/n4jsdev">Tweets by n4jsdev</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="http://www.eclipse.org/">Eclipse Home</a></li>
+      <li><a href="http://www.eclipse.org/legal/privacy.php">Privacy Policy</a></li>
+      <li><a href="http://www.eclipse.org/legal/termsofuse.php">Terms of Use</a></li>
+      <li><a href="http://www.eclipse.org/legal/copyright.php">Copyright Agent</a></li>
+      <li><a href="http://www.eclipse.org/legal/">Legal</a></li>
+    </ul>
+  </div>
+  <div style="clear: both; height: 0; overflow: hidden;"></div>
+</div>
+
+<!-- ************* UI Scripts ************* -->
+<script type="text/javascript" src="scripts/back-to-top.js"></script>
+
+<script type="text/javascript" src="scripts/treeview.js"></script>
+<script type="text/javascript" src="scripts/toc.js"></script>
+
+<!-- ************* Prism.js Syntax Highlighting ************* -->
+<script src="scripts/prism.js"></script>
+
+<script type="text/javascript">
+	// Add the 'toclist' id for search function
+	$(".toc2 > ul").attr('id', 'toclist');
+	// Generate a Search input form
+	$("#toclist > li:first-of-type").before('<input type="text" id="pagesearch" onkeyup="search()" placeholder="Search for section...">');
+	$("#toclist > li:first-of-type").before('<i id="clear" class="fa fa-times-circle-o"></i>');
+	$("#clear").click(function(){
+	    $("#pagesearch").val('');
+	    search();
+	    $('.toc2 > ul').treeView('collapseAll');
+	});
+	// intialize Treeview.js
+	$(".toc2 > ul").treeView();
+	// Initialize Scrollspy
+</script>
+<!-- ************* docinfo-footer *************************************************************** -->
+</body>
+</html>
\ No newline at end of file
diff --git a/design/flow_graphs.html b/design/flow_graphs.html
new file mode 100644
index 0000000..462102e
--- /dev/null
+++ b/design/flow_graphs.html
@@ -0,0 +1,1450 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="generator" content="Asciidoctor 1.5.5">
+<meta name="author" content="2019-08-07 15:02:40 CEST">
+<title>N4JS Design Specification</title>
+<link rel="stylesheet" href="styles/spec.min.css">
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.6.3/css/font-awesome.min.css">
+<!-- ************* docinfo ******************************************************************* -->
+
+
+<!-- ************* Favicon ************-->
+<link rel="icon" href="images/favicon.ico" />
+
+<!-- ************* Back-to-top JQuery ************* -->
+<script src="https://code.jquery.com/jquery-1.12.4.js"></script>
+<script src="https://code.jquery.com/ui/1.12.0/jquery-ui.js"></script>
+
+
+<link href="styles/prism.min.css" rel="stylesheet" />
+<script type="text/javascript" async
+  src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2/MathJax.js?config=TeX-MML-AM_CHTML">
+</script>
+
+<!-- ************* Styles ************* -->
+<link rel="stylesheet" type="text/css" href="styles/n4jsspec-adoc.css">
+
+
+<!-- ****************** NavBar ****************** -->
+<div id="menubar">
+	<div class="banner">
+        <a href="https://www.eclipse.org/n4js/#"><img id="logo" src="images/n4js-logo.png" alt="Eclipse N4JS"></a>
+    </div>
+<ul>
+  <li><a href="index.html">Index</a></li>
+</ul>
+</div>
+<!-- ************* docinfo ******************************************************************* -->
+<style>
+      .admonitionblock td.icon .icon-todo:before{content:"\f249";color:#f4ee42}
+    </style>
+</head>
+<body class="book toc2 toc-left">
+<div id="header">
+<h1>N4JS Design Specification</h1>
+<div class="details">
+<span id="author" class="author">2019-08-07 15:02:40 CEST</span><br>
+<span id="revnumber">version 0.9</span>
+</div>
+<div id="toc" class="toc2">
+<div id="toctitle">Table of Contents</div>
+<ul class="sectlevel1">
+<li><a href="introduction.html#_introduction">1. Introduction</a>
+<ul class="sectlevel2">
+<li><a href="introduction.html#notation">1.1. Notation</a></li>
+<li><a href="introduction.html#sec:IDE_Overview">1.2. IDE Components</a>
+<ul class="sectlevel3">
+<li><a href="introduction.html#sec:Naming_Conventions">1.2.1. Naming Conventions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="eclipse_setup.html#_eclipse-setup">2. Eclipse Setup</a>
+<ul class="sectlevel2">
+<li><a href="eclipse_setup.html#_system-requirements">2.1. System Requirements</a></li>
+<li><a href="eclipse_setup.html#_contribute">2.2. Contribute</a>
+<ul class="sectlevel3">
+<li><a href="eclipse_setup.html#_eclipse-installer">2.2.1. Eclipse Installer</a>
+<ul class="sectlevel4">
+<li><a href="eclipse_setup.html#_changing-the-setup-script">2.2.1.1. Changing the Setup Script</a></li>
+</ul>
+</li>
+<li><a href="eclipse_setup.html#_manual-ide-configuration">2.2.2. Manual IDE Configuration</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="release_engineering.html#_release-engineering">3. Release Engineering</a>
+<ul class="sectlevel2">
+<li><a href="release_engineering.html#_nightly-build-on-eclipse-infrastructure">3.1. Nightly build on Eclipse infrastructure</a></li>
+<li><a href="release_engineering.html#_build-the-n4js-ide-from-command-line">3.2. Build the N4JS IDE from command line</a>
+<ul class="sectlevel3">
+<li><a href="release_engineering.html#_publish-maven-tooling-code-org-eclipse-n4js-releng-util-code">3.2.1. Publish maven-tooling <code>org.eclipse.n4js.releng.util</code></a></li>
+<li><a href="release_engineering.html#sec:test-verdaccio">3.2.2. Test Verdaccio containing n4js-libs</a></li>
+<li><a href="release_engineering.html#_generation-of-eclipse-help-for-spec-and-design-document">3.2.3. Generation of Eclipse help for spec and design document</a></li>
+</ul>
+</li>
+<li><a href="release_engineering.html#_updating-frameworks-and-dependencies">3.3. Updating frameworks and dependencies</a>
+<ul class="sectlevel3">
+<li><a href="release_engineering.html#_update-of-eclipse-emf-xtext-etc">3.3.1. Update of Eclipse, EMF, Xtext, etc.</a></li>
+<li><a href="release_engineering.html#_update-of-the-embedded-jre">3.3.2. Update of the embedded JRE</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tips_and_tricks.html#_tips-and-tricks">4. Tips and Tricks</a>
+<ul class="sectlevel2">
+<li><a href="tips_and_tricks.html#_naming">4.1. Naming</a></li>
+<li><a href="tips_and_tricks.html#_logging">4.2. Logging</a></li>
+<li><a href="tips_and_tricks.html#_cancellation-handling">4.3. Cancellation Handling</a></li>
+<li><a href="tips_and_tricks.html#_caching">4.4. Caching</a></li>
+<li><a href="tips_and_tricks.html#_dependency-injection">4.5. Dependency Injection</a></li>
+<li><a href="tips_and_tricks.html#_miscellaneous">4.6. Miscellaneous</a></li>
+</ul>
+</li>
+<li><a href="parser.html#_parser">5. Parser</a>
+<ul class="sectlevel2">
+<li><a href="parser.html#sec:Parser_Overview">5.1. Overview</a></li>
+<li><a href="parser.html#sec:N4JS_Parser">5.2. N4JS Parser</a></li>
+<li><a href="parser.html#sec:Parser_Generation_Post_Processing">5.3. Parser Generation Post-Processing</a>
+<ul class="sectlevel3">
+<li><a href="parser.html#sec:Automatic_Semicolon_Insertion">5.3.1. Automatic Semicolon Insertion</a>
+<ul class="sectlevel4">
+<li><a href="parser.html#sec:Injected_code_in_the_Antlr_grammar_file">5.3.1.1. Injected code in the Antlr grammar file</a></li>
+<li><a href="parser.html#sec:Customized_error_recovery">5.3.1.2. Customized error recovery</a></li>
+</ul>
+</li>
+<li><a href="parser.html#sec:_No_line_terminator_allowed_here__handling">5.3.2. Async and <code>No line terminator allowed here</code> Handling</a></li>
+<li><a href="parser.html#sec:Regular_Expression">5.3.3. Regular Expression</a></li>
+<li><a href="parser.html#sec:Unicode">5.3.4. Unicode</a></li>
+<li><a href="parser.html#sec:Literals">5.3.5. Literals</a></li>
+</ul>
+</li>
+<li><a href="parser.html#sec:Modifiers">5.4. Modifiers</a></li>
+<li><a href="parser.html#sec:Conflict_Resolutions">5.5. Conflict Resolutions</a>
+<ul class="sectlevel3">
+<li><a href="parser.html#sec:Reserved_Keywords_vs__Identifier_Names">5.5.1. Reserved Keywords vs. Identifier Names</a></li>
+<li><a href="parser.html#sec:Operators_and_Generics">5.5.2. Operators and Generics</a></li>
+</ul>
+</li>
+<li><a href="parser.html#sec:Content_Assist_Parser">5.6. Content-Assist Parser</a></li>
+</ul>
+</li>
+<li><a href="type_system.html#_type-system">6. Type System</a>
+<ul class="sectlevel2">
+<li><a href="type_system.html#sec:Type_Model_and_Grammar">6.1. Type Model and Grammar</a>
+<ul class="sectlevel3">
+<li><a href="type_system.html#sec:Type_Model_Overview">6.1.1. Type Model Overview</a></li>
+<li><a href="type_system.html#sec:Built_in_Types">6.1.2. Built-in and Primitive Types</a></li>
+<li><a href="type_system.html#sec:Type_Model_DSL">6.1.3. Type Model DSL</a></li>
+</ul>
+</li>
+<li><a href="type_system.html#sec:Type_System_Implementation">6.2. Type System Implementation</a></li>
+<li><a href="type_system.html#sec:Type_Inference_combined_with_AST_Traversal">6.3. Type Inference of AST</a>
+<ul class="sectlevel3">
+<li><a href="type_system.html#sec:Type_Inference_combined_with_AST_Traversal__Background">6.3.1. Background</a></li>
+<li><a href="type_system.html#sec:Triggering_Type_Inference_of_AST">6.3.2. Triggering</a></li>
+<li><a href="type_system.html#sec:Traversal_Order_During_Type_Inference_of_AST">6.3.3. Traversal Order</a></li>
+<li><a href="type_system.html#sec:Cross_References_During_Type_Inference_of_AST">6.3.4. Cross-References</a></li>
+<li><a href="type_system.html#sec:Function_Accessor_Bodies_During_Type_Inference_of_AST">6.3.5. Function/Accessor Bodies</a></li>
+<li><a href="type_system.html#sec:Poly_Expressions_During_Type_Inference_of_AST">6.3.6. Poly Expressions</a></li>
+<li><a href="type_system.html#sec:Constraint_Solver_used_During_Type_Inference_of_AST">6.3.7. Constraint Solver</a></li>
+<li><a href="type_system.html#sec:Type_Guards_During_Type_Inference_of_AST">6.3.8. Type Guards</a></li>
+</ul>
+</li>
+<li><a href="type_system.html#sec:Structural_Typing">6.4. Structural Typing</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#_type-index">7. Type Index</a>
+<ul class="sectlevel2">
+<li><a href="type_index.html#sec:Type_Index_Design_Rationale">7.1. Design Rationale</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#sec:Getting_the_Xtext_Index_Content_IResourceDescriptions">7.1.1. Getting the Xtext Index (<code>IResourceDescriptions</code>) Content</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#sec:Design_Overview">7.2. Design Overview</a></li>
+<li><a href="type_index.html#sec:N4JS_Resource_Load_States">7.3. N4JS Resource Load States</a></li>
+<li><a href="type_index.html#sec:Type_Builder">7.4. Types Builder</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#sec:Type_Inference_not_allowed_in_Type_Builder">7.4.1. Type Inference not allowed in Types Builder</a></li>
+<li><a href="type_index.html#sec:ComputedTypeReferences">7.4.2. Deferred Type References</a></li>
+<li><a href="type_index.html#sec:Use_cases_of_ComputedTypeRef">7.4.3. Use cases of DeferredTypeRef</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#sec:Incremental_Builder_Overview">7.5. Incremental Builder (Overview)</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#sec:Incremental_Builder_Overview__XtextBuilder">7.5.1. XtextBuilder</a></li>
+<li><a href="type_index.html#sec:Incremental_Builder_Overview__IBuilderState">7.5.2. IBuilderState</a>
+<ul class="sectlevel4">
+<li><a href="type_index.html#copy-and-update-xtext-index">7.5.2.1. Copy and Update Xtext Index</a></li>
+<li><a href="type_index.html#build-state-setup-phase">7.5.2.2. Build State Setup Phase</a></li>
+<li><a href="type_index.html#process-queued-uris">7.5.2.3. Process Queued URIs</a></li>
+<li><a href="type_index.html#queueing-affected-resources">7.5.2.4. Queueing Affected Resources</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#sec:Incremental_Builder_Overview__Example">7.5.3. Example</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#dirty-state-handling">7.6. Dirty state handling</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#use-case-restoring-types-from-user-data">7.6.1. Use case: Restoring types from user data</a></li>
+<li><a href="type_index.html#use-case-updating-the-xtext-index">7.6.2. Use case: Updating the Xtext index</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="project_model.html#_project-model">8. Project Model</a>
+<ul class="sectlevel2">
+<li><a href="project_model.html#sec:Package_json">8.1. Package.json File</a></li>
+<li><a href="project_model.html#_accessing-project-information">8.2. Accessing Project Information</a>
+<ul class="sectlevel3">
+<li><a href="project_model.html#sec:IN4JSCore">8.2.1. IN4JSCore</a></li>
+<li><a href="project_model.html#sec:N4JSModel">8.2.2. N4JSModel</a></li>
+<li><a href="project_model.html#sec:N4JSWorkspace">8.2.3. N4JSWorkspace</a></li>
+<li><a href="project_model.html#sec:N4JSProject">8.2.4. N4JSProject</a></li>
+<li><a href="project_model.html#sec:SourceContainer">8.2.5. SourceContainer</a></li>
+<li><a href="project_model.html#sec:N4JSProjectsStateHelper">8.2.6. N4JSProjectsStateHelper</a></li>
+</ul>
+</li>
+<li><a href="project_model.html#sec:Caching">8.3. Caching</a>
+<ul class="sectlevel3">
+<li><a href="project_model.html#_caching-of-externallibraryworkspace">8.3.1. Caching of ExternalLibraryWorkspace</a></li>
+<li><a href="project_model.html#_caching-of-n4jsprojectsstatehelper">8.3.2. Caching of N4JSProjectsStateHelper</a></li>
+</ul>
+</li>
+<li><a href="project_model.html#sec:WildcardPathFilter">8.4. WildcardPathFilter</a></li>
+<li><a href="project_model.html#sec:ProjectUtils">8.5. ProjectUtils</a></li>
+</ul>
+</li>
+<li><a href="binding.html#_binding">9. Binding</a>
+<ul class="sectlevel2">
+<li><a href="binding.html#sec:Binding_Design_Rationale">9.1. Design Rationale</a></li>
+<li><a href="binding.html#sec:Binding_to_Members">9.2. Binding to Members</a></li>
+<li><a href="binding.html#sec:Binding_Getter_Setter">9.3. Getter / Setter Binding</a></li>
+<li><a href="binding.html#chap:Statics">9.4. Static Member Binding</a></li>
+<li><a href="binding.html#sec:Binding_Enumeration">9.5. Enumeration Literals Binding</a></li>
+<li><a href="binding.html#sec:Accessibility_of_types_and_members">9.6. Accessibility of types and members</a></li>
+<li><a href="binding.html#sec:Member_Scope_Example">9.7. Member Scope Example</a></li>
+<li><a href="binding.html#sec:Scoping_for_Members_of_Composed_Type_Explained">9.8. Scoping for Members of Composed Type (Union/Intersection) Example</a></li>
+<li><a href="binding.html#sec:Binding_of_Structurally_References_Types">9.9. Structurally References Types</a></li>
+<li><a href="binding.html#sec:Building">9.10. Building</a>
+<ul class="sectlevel3">
+<li><a href="binding.html#sec:Build_Phases">9.10.1. Build Phases</a></li>
+<li><a href="binding.html#sec:Build_Scenarios">9.10.2. Build Scenarios</a></li>
+<li><a href="binding.html#sec:Lazy_linking_problem">9.10.3. Lazy linking problem</a></li>
+</ul>
+</li>
+<li><a href="binding.html#sec:Proxies_and_Proxy_Resolution">9.11. Proxies and Proxy Resolution (Overview)</a>
+<ul class="sectlevel3">
+<li><a href="binding.html#xtexts-lazy-linking-proxies">9.11.1. Xtext’s Lazy Linking Proxies</a></li>
+<li><a href="binding.html#standard-emf-proxies">9.11.2. Standard EMF Proxies</a></li>
+<li><a href="binding.html#_how-is-proxy-resolution-triggered">9.11.3. How is Proxy Resolution Triggered?</a></li>
+<li><a href="binding.html#_when-is-proxy-resolution-allowed">9.11.4. When is Proxy Resolution Allowed?</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="validation.html#_validation">10. Validation</a>
+<ul class="sectlevel2">
+<li><a href="validation.html#sec:validation_overview">10.1. Validation overview</a></li>
+<li><a href="validation.html#sec:validation_control_flow">10.2. Validation control flow</a></li>
+<li><a href="validation.html#sec:validation_issue_ids">10.3. Issue IDs and Messages</a></li>
+<li><a href="validation.html#sec:validation_usage_patterns">10.4. Usage Pattern</a></li>
+<li><a href="validation.html#sec:validation_links">10.5. Links</a></li>
+</ul>
+</li>
+<li><a href="references.html#_references">11. References</a>
+<ul class="sectlevel2">
+<li><a href="references.html#sec:usecases">11.1. Use cases</a></li>
+<li><a href="references.html#sec:calculation_algorithm">11.2. Calculation algorithm</a>
+<ul class="sectlevel3">
+<li><a href="references.html#sec:Xtext_default_implementation">11.2.1. Xtext default implementation</a></li>
+<li><a href="references.html#sec:N4_implementation">11.2.2. N4JS implementation</a></li>
+</ul>
+</li>
+<li><a href="references.html#sec:PerformanceOfDependencyCalculation">11.3. Performance Of Dependency Calculation</a></li>
+<li><a href="references.html#sec:kinds_of_references">11.4. Kinds of references</a>
+<ul class="sectlevel3">
+<li><a href="references.html#sec:Cross_References_to_be_ignored">11.4.1. Cross References to be ignored</a></li>
+<li><a href="references.html#sec:Cross_References_to_be_handled">11.4.2. Cross References to be handled</a></li>
+</ul>
+</li>
+<li><a href="references.html#sec:transitive_dependencies">11.5. Transitive dependencies</a></li>
+<li><a href="references.html#sec:find-references">11.6. Find references</a>
+<ul class="sectlevel3">
+<li><a href="references.html#_background">11.6.1. Background</a></li>
+<li><a href="references.html#_how-find-references-work">11.6.2. How Find References Work</a>
+<ul class="sectlevel4">
+<li><a href="references.html#_step-1-convert-cursor-position-to-declared-element">11.6.2.1. Step 1: Convert Cursor Position to Declared Element</a></li>
+<li><a href="references.html#_step-2-convert-declared-element-to-target-uris">11.6.2.2. Step 2: Convert Declared Element to Target URIs</a></li>
+<li><a href="references.html#_step-3-filter-potential-resources">11.6.2.3. Step 3: Filter Potential Resources</a></li>
+<li><a href="references.html#_step-4-search-references-in-resource">11.6.2.4. Step 4: Search References in Resource</a></li>
+<li><a href="references.html#_limitations-and-possible-enhancements">11.6.2.5. Limitations and Possible Enhancements</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="compilation.html#_compilation">12. Compilation</a>
+<ul class="sectlevel2">
+<li><a href="compilation.html#chap:compilation">12.1. Introduction</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:general_design_rationals">12.1.1. General design rationals</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:logging_and_error_reporting">12.1.1.1. Logging and error reporting</a></li>
+<li><a href="compilation.html#sec:progress_monitor">12.1.1.2. Progress monitor</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Xtext_Integration">12.1.2. Xtext Integration</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:xtext_default_behaviour">12.1.2.1. Xtext default behaviour</a></li>
+<li><a href="compilation.html#sec:n4js_requirements">12.1.2.2. N4JS requirements</a></li>
+<li><a href="compilation.html#sec:compiler_discovery_in_ui">12.1.2.3. Compiler discovery in UI</a></li>
+<li><a href="compilation.html#sec:compiler_discovery_in_headless">12.1.2.4. Compiler discovery in headless</a></li>
+<li><a href="compilation.html#sec:general_generator_implementation">12.1.2.5. General generator implementation</a></li>
+<li><a href="compilation.html#sec:general_generator_activation">12.1.2.6. General generator activation</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Overview_of_Input_Models">12.1.3. Overview of the Input Models</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Core_Generator">12.2. Generators</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:Compiler_Components">12.2.1. Generator Components</a></li>
+<li><a href="compilation.html#sec:Generator_architecture">12.2.2. Generator architecture</a></li>
+<li><a href="compilation.html#sec:Unified_Compiler_Configuration">12.2.3. Unified Compiler Configuration</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Transpilers">12.3. Transpilers</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:Phases">12.3.1. Overview</a></li>
+<li><a href="compilation.html#relation-between-ast-and-im">12.3.2. Relation between AST and IM</a></li>
+<li><a href="compilation.html#implementation-overview">12.3.3. Implementation Overview</a></li>
+<li><a href="compilation.html#sec:Guidelines_for_Implementing_Transformations">12.3.4. Guidelines for Implementing Transformations</a></li>
+<li><a href="compilation.html#symbol-table-in-the-im">12.3.5. Symbol Table in the IM</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:N4JS_to_EcmaScript_Transpiler">12.4. N4JS-to-EcmaScript Transpiler</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:Overview_of_Transformations">12.4.1. Overview of Transformations</a></li>
+<li><a href="compilation.html#sec:Transpiling_members">12.4.2. Transpiling members</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:Transpiling_members__Delegating_members">12.4.2.1. Techniques for special member handling</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__Partial_shadowing_of_getter_setter_pairs">12.4.2.2. Partial shadowing</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__Consuming_or_inheriting_members_of_an_interface">12.4.2.3. Consuming or inheriting members of an interface</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__Static_polyfill">12.4.2.4. Static polyfill</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__API_implementation_stubs">12.4.2.5. API / implementation stubs</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Support_for_incomplete_API_implementation_testing_in_the_N4JS_to_EcmaScript_5_Transpiler">12.4.3. Support for incomplete API implementation testing</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:Modifications_in_Impl_projects">12.4.3.1. Modifications in Impl projects</a></li>
+<li><a href="compilation.html#sec:Implementation_of_stub_generation">12.4.3.2. Implementation of stub-generation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:n4jsc_Headless_Compiler_Interface">12.5. n4jsc Headless Compiler Interface</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:building_the_headless_compiler">12.5.1. building the headless compiler</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="execution.html#_execution">13. Execution</a>
+<ul class="sectlevel2">
+<li><a href="execution.html#sec:N4JS_Project_Execution_And_Linking_Model">13.1. N4JS Project Execution And Linking Model</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#subsec:N4JS_Execution_With_NodeJS">13.1.1. N4JS Execution With NodeJS</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:N4JS_Execution_And_Linking_File">13.2. N4JS Execution And Linking File</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#subsec:NodeJS_Specific_ELF">13.2.1. NodeJS Specific ELF</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Runners-execution">13.3. Runners</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#subsec:N4_Runtime_Environments_Convention">13.3.1. N4 Runtime Environments Convention</a></li>
+<li><a href="execution.html#subsec:Passing_Information_from_IDE_to_Execution_Code_in_Runtime_Environment">13.3.2. Passing Information from IDE to Execution Code in Runtime Environment</a></li>
+<li><a href="execution.html#subsec:Runners_Design">13.3.3. Runners Design</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Legacy_Execution_Engine">13.4. Legacy Execution Engine</a></li>
+<li><a href="execution.html#sec:Design">13.5. Design</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#sec:Usage_Outside_N4JSIDE">13.5.1. Usage Outside N4JSIDE</a>
+<ul class="sectlevel4">
+<li><a href="execution.html#sec:Use_Node_with_Maven">13.5.1.1. Use Node with Maven</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Usage_Inside_N4JSIDE">13.5.2. Usage Inside N4JSIDE</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Runtime_Injection">13.6. Runtime Injection</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#sec:Running_String_Code">13.6.1. Running String Code</a></li>
+<li><a href="execution.html#sec:Running_File_Code">13.6.2. Running File Code</a></li>
+<li><a href="execution.html#sec:Injection_Code_Example">13.6.3. Injection Code Example</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#_tests">14. Tests</a>
+<ul class="sectlevel2">
+<li><a href="tests.html#sec:Performance_Tests">14.1. Performance Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Synthetic_Performance_Tests">14.1.1. Synthetic Performance Tests</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:Design_of_Generator">14.1.1.1. Design of Generator</a></li>
+<li><a href="tests.html#sec:Design_of_Performance_Test_Execution">14.1.1.2. Design of Performance Test Configuration and Execution</a></li>
+<li><a href="tests.html#sec:JUnit_Configuration">14.1.1.3. JUnit Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Test_Configuration">14.1.1.4. JUnitBenchmark Test Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Report_Configuration">14.1.1.5. JUnitBenchmark Report Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Run_Configuration">14.1.1.6. JUnitBenchmark Run Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Example">14.1.1.7. JUnitBenchmark Example</a></li>
+<li><a href="tests.html#sec:Note_on_Jenkins_Job">14.1.1.8. Note on Jenkins Job</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#sec:ECMA_Tests">14.2. ECMA Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Grammar_Tests">14.2.1. Grammar Tests</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:Negative_Tests">14.2.1.1. Negative Tests</a></li>
+<li><a href="tests.html#sec:Test_Exclusion">14.2.1.2. Test Exclusion</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Integration_Tests">14.3. Integration Tests</a></li>
+<li><a href="tests.html#sec:Test_Helpers">14.4. Test Helpers</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Parameterized_N4JS_Tests">14.4.1. Parameterized N4JS tests</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:ParameterizedXtextRunner">14.4.1.1. ParameterizedXtextRunner</a></li>
+<li><a href="tests.html#sec:TestCodeProvider">14.4.1.2. TestCodeProvider</a></li>
+<li><a href="tests.html#sec:Example_Of_Parameterized_Parser_Test">14.4.1.3. Example of parameterized parser test</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Issue_Suppression">14.5. Issue Suppression</a></li>
+<li><a href="tests.html#sec:Xpect_Tests">14.6. Xpect Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Xpect_Test_Setup">14.6.1. Xpect Test Setup</a></li>
+<li><a href="tests.html#sec:Xpect_Issue_Suppression">14.6.2. Xpect Issue Suppression</a></li>
+<li><a href="tests.html#sec:Xpect_Provided_Test_Methods">14.6.3. Xpect Provided Test Methods</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#errors">14.6.3.1. errors</a></li>
+<li><a href="tests.html#warnings">14.6.3.2. warnings</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:N4JS_Specific_Xpect_Test_Methods">14.6.4. N4JS Specific Xpect Test Methods</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:XPECT_noerrors">14.6.4.1. noerrors and nowarnings</a></li>
+<li><a href="tests.html#sec:XPECT_scope">14.6.4.2. scope</a></li>
+<li><a href="tests.html#sec:XPECT_scopeWithPosition">14.6.4.3. scopeWithPosition</a></li>
+<li><a href="tests.html#sec:XPECT_scopeWithResource">14.6.4.4. scopeWithResource</a></li>
+<li><a href="tests.html#sec:XPECT_binding">14.6.4.5. binding</a></li>
+<li><a href="tests.html#sec:XPECT_linkedPathname">14.6.4.6. linkedPathname</a></li>
+<li><a href="tests.html#sec:XPECT_type_of">14.6.4.7. type of</a></li>
+<li><a href="tests.html#sec:XPECT_expectedType">14.6.4.8. expectedType</a></li>
+<li><a href="tests.html#sec:XPECT_elementKeyword">14.6.4.9. elementKeyword</a></li>
+<li><a href="tests.html#sec:XPECT_accessModifier">14.6.4.10. accessModifier</a></li>
+<li><a href="tests.html#sec:XPECT_compileResult">14.6.4.11. compileResult</a></li>
+<li><a href="tests.html#sec:XPECT_output">14.6.4.12. output</a></li>
+<li><a href="tests.html#sec:XPECT_outputRegEx">14.6.4.13. outputRegEx</a></li>
+<li><a href="tests.html#sec:XPECT_calculatedAccessModifier">14.6.4.14. calculatedAccessModifier</a></li>
+<li><a href="tests.html#sec:XPECT_spec">14.6.4.15. spec</a></li>
+<li><a href="tests.html#sec:XPECT_deadCode">14.6.4.16. deadCode</a></li>
+<li><a href="tests.html#sec:XPECT_returnOrThrows">14.6.4.17. returnOrThrows</a></li>
+<li><a href="tests.html#sec:XPECT_lint">14.6.4.18. lint</a></li>
+<li><a href="tests.html#sec:XPECT_lintFails">14.6.4.19. lintFails</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:FIXME_Xpect_modifier">14.6.5. FIXME Xpect modifier</a></li>
+<li><a href="tests.html#sec:Expectmatrix_Xpect_Test_Methods">14.6.6. Expectmatrix Xpect tests</a></li>
+<li><a href="tests.html#xpect-lint-tests">14.6.7. Xpect Lint Tests</a></li>
+</ul>
+</li>
+<li><a href="tests.html#xpect-proposal-tests">14.7. Xpect Proposal Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Validation_vs__Non_Validation">14.7.1. Validation vs. Non-Validation</a></li>
+<li><a href="tests.html#sec:General_Proposal_Test_Features">14.7.2. General Proposal Test Features</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:Test_Variables">14.7.2.1. Test Variables</a></li>
+<li><a href="tests.html#sec:Location_and_Selection">14.7.2.2. at – Location and Selection</a></li>
+<li><a href="tests.html#sec:Multi_Line_Expectations_in_Proposal_Tests">14.7.2.3. Multi Line Expectations in Proposal Tests</a></li>
+<li><a href="tests.html#sec:Timeout">14.7.2.4. Timeout and Performance</a></li>
+</ul>
+</li>
+<li><a href="tests.html#proposals-verify-existence-of-proposals">14.7.3. proposals – Verify Existence of Proposals</a></li>
+<li><a href="tests.html#sec:Verify_displayed_string">14.7.4. display – Verify displayed string</a></li>
+<li><a href="tests.html#sec:Apply_Proposal">14.7.5. apply – Apply Proposal</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#resource-application-in-other-files">14.7.5.1. resource – application in other files</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Content_Assist_Cycling">14.7.6. kind – Content Assist Cycling</a></li>
+<li><a href="tests.html#fileValidVerify-validation-status">14.7.7. fileValid – Verify validation status</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Apply_Proposal_And_Execute_Tests">14.8. Apply Proposal And Execute Tests</a></li>
+<li><a href="tests.html#sec:Organize_Imports_Test">14.9. Organize Imports Test</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#organizeimports">14.9.1. organizeImports</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Access_Control_Test">14.10. Access Control Test</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#test-scenarios">14.10.1. Test Scenarios</a></li>
+<li><a href="tests.html#n4js-code-generator">14.10.2. N4JS Code Generator</a></li>
+<li><a href="tests.html#xtext-issue-matcher">14.10.3. Xtext Issue Matcher</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Smoke_Tests">14.11. Smoke Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#how-to-handle-smoke-test-errors">14.11.1. How to handle smoke test errors?</a></li>
+<li><a href="tests.html#smoketester-and-exceptionanalyzer">14.11.2. SmokeTester and ExceptionAnalyzer</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:UI_Tests_with_SWTBot">14.12. UI Tests with SWTBot</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#writing-swtbot-tests">14.12.1. Writing SWTBot Tests</a></li>
+<li><a href="tests.html#running-swtbot-tests">14.12.2. Running SWTBot Tests</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Debugging_UI_Tests">14.13. Debugging UI Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Connecting_to_the_X_server_on_the_build_node">14.13.1. Connecting to the X-server on the build-node</a></li>
+<li><a href="tests.html#sec:Tools_to_investigate_the_java_stack">14.13.2. Tools to investigate the java-stack</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="ui_concepts.html#_ui-concepts">15. UI Concepts</a>
+<ul class="sectlevel2">
+<li><a href="ui_concepts.html#sec:User_Interface_Concepts">15.1. User Interface Concepts</a>
+<ul class="sectlevel3">
+<li><a href="ui_concepts.html#sec:Eclipse_UI_Concepts">15.1.1. Eclipse UI Concepts</a>
+<ul class="sectlevel4">
+<li><a href="ui_concepts.html#sec:Label_Provider">15.1.1.1. Label Provider</a></li>
+<li><a href="ui_concepts.html#sec:Markers">15.1.1.2. Markers</a></li>
+<li><a href="ui_concepts.html#sec:Commands__Toolbar_and_Menus">15.1.1.3. Commands, Toolbar and Menus</a></li>
+<li><a href="ui_concepts.html#sec:Content_Assist">15.1.1.4. Content Assist</a></li>
+<li><a href="ui_concepts.html#sec:Quick_Fixes">15.1.1.5. Quick Fixes</a></li>
+<li><a href="ui_concepts.html#sec:Quick_Assist">15.1.1.6. Quick Assist</a></li>
+<li><a href="ui_concepts.html#sec:Clean_Up_Actions">15.1.1.7. Clean Up Actions</a></li>
+<li><a href="ui_concepts.html#sec:Save_Actions">15.1.1.8. Save Actions</a></li>
+<li><a href="ui_concepts.html#sec:Auto_Edit">15.1.1.9. Auto Edit</a></li>
+<li><a href="ui_concepts.html#sec:Template_Proposals">15.1.1.10. Template Proposals</a></li>
+<li><a href="ui_concepts.html#sec:Outline_View___Quick_Outline">15.1.1.11. Outline View / Quick Outline</a></li>
+<li><a href="ui_concepts.html#sec:Navigator__Package_Explorer__Project_Explorer">15.1.1.12. Navigator, Package Explorer, Project Explorer</a></li>
+<li><a href="ui_concepts.html#sec:Hyperlinking_and_Navigation">15.1.1.13. Hyperlinking and Navigation</a></li>
+<li><a href="ui_concepts.html#sec:Syntax_and_Semantic_Coloring">15.1.1.14. Syntax and Semantic Coloring</a></li>
+<li><a href="ui_concepts.html#sec:Code_Formatter">15.1.1.15. Code Formatter</a></li>
+<li><a href="ui_concepts.html#sec:Wizards">15.1.1.16. Wizards</a></li>
+<li><a href="ui_concepts.html#sec:Cheat_Sheets">15.1.1.17. Cheat Sheets</a></li>
+<li><a href="ui_concepts.html#sec:Context_sensitive_Help">15.1.1.18. Context-sensitive Help</a></li>
+<li><a href="ui_concepts.html#sec:Hovers">15.1.1.19. Hovers</a></li>
+<li><a href="ui_concepts.html#sec:Folding">15.1.1.20. Folding</a></li>
+<li><a href="ui_concepts.html#sec:Customizable_validation___severity">15.1.1.21. Customizable validation / severity</a></li>
+<li><a href="ui_concepts.html#sec:Proposals">15.1.1.22. Proposals</a></li>
+</ul>
+</li>
+<li><a href="ui_concepts.html#sec:Non_Eclipse_UI_Concepts">15.1.2. Non-Eclipse UI Concepts</a>
+<ul class="sectlevel4">
+<li><a href="ui_concepts.html#sec:Overlays">15.1.2.1. Overlays</a></li>
+<li><a href="ui_concepts.html#sec:Goto__Inferred__Type">15.1.2.2. Goto (Inferred) Type</a></li>
+<li><a href="ui_concepts.html#sec:Postfix_Completion">15.1.2.3. Postfix Completion</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="ui_concepts.html#_user-interface-resources">15.2. User Interface Resources</a>
+<ul class="sectlevel3">
+<li><a href="ui_concepts.html#_icons">15.2.1. Icons</a>
+<ul class="sectlevel4">
+<li><a href="ui_concepts.html#_eclipse-platform-icons">15.2.1.1. Eclipse Platform Icons</a></li>
+<li><a href="ui_concepts.html#_n4js-specific-icons">15.2.1.2. N4JS Specific Icons</a></li>
+<li><a href="ui_concepts.html#_high-resolution-icons">15.2.1.3. High Resolution Icons</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="formatting.html#_formatting">16. Formatting</a>
+<ul class="sectlevel2">
+<li><a href="formatting.html#sec:FmtObjective">16.1. Objective</a>
+<ul class="sectlevel3">
+<li><a href="formatting.html#sec:FmtFormatting_Comments">16.1.1. Formatting Comments</a></li>
+</ul>
+</li>
+<li><a href="formatting.html#sec:FmtArchitecture">16.2. Architecture</a>
+<ul class="sectlevel3">
+<li><a href="formatting.html#sec:Implementation_example">16.2.1. Implementation example</a></li>
+</ul>
+</li>
+<li><a href="formatting.html#sec:FmtFormatter_Implementation_Guidelines">16.3. Formatter Implementation Guidelines</a></li>
+<li><a href="formatting.html#sec:FmtConfiguration">16.4. Configuration</a></li>
+<li><a href="formatting.html#sec:FmtUI_Integration">16.5. UI Integration</a></li>
+<li><a href="formatting.html#sec:FmtUnit_Testing_with_Xpect">16.6. Unit Testing with Xpect</a></li>
+</ul>
+</li>
+<li><a href="external_libraries.html#_external-libraries">17. External Libraries</a>
+<ul class="sectlevel2">
+<li><a href="external_libraries.html#sec:Major_Components">17.1. Major Components</a>
+<ul class="sectlevel3">
+<li><a href="external_libraries.html#subsec:External_Resources">17.1.1. External Resources</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Workspace">17.1.2. External Library Workspace</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Preference_Store">17.1.3. External Library Preference Store</a></li>
+<li><a href="external_libraries.html#subsec:npm_Manager">17.1.4. Library Manager</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Builder_Helper">17.1.5. External Library Builder</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Xtext_Index_Persister">17.1.6. External Library Xtext Index Persister</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Preference_Page">17.1.7. External Library Preference Page</a></li>
+</ul>
+</li>
+<li><a href="external_libraries.html#sec:Headless_External_Library_Support">17.2. Headless External Library Support</a>
+<ul class="sectlevel3">
+<li><a href="external_libraries.html#_custom-npm-settings">17.2.1. Custom npm settings</a></li>
+</ul>
+</li>
+<li><a href="external_libraries.html#sec:lmFutureWork">17.3. Future Work</a>
+<ul class="sectlevel3">
+<li><a href="external_libraries.html#subsec:lmMultipleDependencyScope">17.3.1. Multiple Dependency Scope</a></li>
+<li><a href="external_libraries.html#subsec:lmRunTestsFromLibrary">17.3.2. Run Tests from TestLibrary</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="json_support.html#sec:JSON_Support">18. JSON Support</a>
+<ul class="sectlevel2">
+<li><a href="json_support.html#sec:JSON_Parser">18.1. JSON Parser</a>
+<ul class="sectlevel3">
+<li><a href="json_support.html#sec:JSON_Parser_Unicode_Escaping">18.1.1. Escaping Unicode Control Characters in String Literals</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Empty_Text">18.1.2. Empty Text</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Nested_Structures">18.1.3. Nested Structures</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Whitespace">18.1.4. Whitespace</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Comments">18.1.5. Comments</a></li>
+</ul>
+</li>
+<li><a href="json_support.html#sec:JSON_Language_Extensions">18.2. JSON Language Extensions</a>
+<ul class="sectlevel3">
+<li><a href="json_support.html#sec:JSON_Validator_Extensions">18.2.1. JSON Validator Extensions</a>
+<ul class="sectlevel4">
+<li><a href="json_support.html#sec:File_Specitic_Validator_Extensions">18.2.1.1. File-Specific Validator Extensions</a></li>
+<li><a href="json_support.html#sec:JSON_Declarative_JSON_Validator_Extensions">18.2.1.2. Declarative JSON Validator Extensions</a></li>
+</ul>
+</li>
+<li><a href="json_support.html#_json-resource-description-strategy">18.2.2. JSON Resource Description Strategy</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_jsdoc">19. JSDoc</a>
+<ul class="sectlevel2">
+<li><a href="jsdoc.html#sec:Design_Rationale">19.1. Design Rationale</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#_general-design">19.1.1. General Design</a></li>
+<li><a href="jsdoc.html#sec:Type_Expressions">19.1.2. Type Expressions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="docexporter.html#_docexporter">20. DocExporter</a>
+<ul class="sectlevel2">
+<li><a href="docexporter.html#sec:Specification_Exporter">20.1. Specification Exporter</a></li>
+</ul>
+</li>
+<li><a href="rename_refactoring.html#_rename-refactoring">21. Rename Refactoring</a>
+<ul class="sectlevel2">
+<li><a href="rename_refactoring.html#_rename-refactoring-ui-interaction">21.1. Rename Refactoring UI interaction</a></li>
+<li><a href="rename_refactoring.html#_renameelementprocessor-interaction">21.2. RenameElementProcessor interaction</a></li>
+</ul>
+</li>
+<li><a href="#chap:flowgraphs">22. Flow Graphs</a>
+<ul class="sectlevel2">
+<li><a href="#sec:flowgraphs_overview">22.1. Flow graphs overview</a>
+<ul class="sectlevel3">
+<li><a href="#_internal-graph">22.1.1. Internal graph</a></li>
+<li><a href="#_optimizations">22.1.2. Optimizations</a></li>
+<li><a href="#_api-for-client-analyses">22.1.3. API for client analyses</a>
+<ul class="sectlevel4">
+<li><a href="#_mapping-from-internal-to-ast-elements">22.1.3.1. Mapping from internal to AST elements</a></li>
+<li><a href="#_graph-visitor">22.1.3.2. Graph visitor</a></li>
+<li><a href="#_graph-explorer">22.1.3.3. Graph explorer</a></li>
+<li><a href="#_branch-walker">22.1.3.4. Branch walker</a></li>
+<li><a href="#_example-1-compute-string-for-each-path">22.1.3.5. Example 1: Compute string for each path</a></li>
+<li><a href="#_path-quantor">22.1.3.6. Path quantor</a></li>
+</ul>
+</li>
+<li><a href="#_control-flow-analyses">22.1.4. Control flow analyses</a>
+<ul class="sectlevel4">
+<li><a href="#_dead-code-analysis">22.1.4.1. Dead code analysis</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#sec:dataflow">22.2. Dataflow</a>
+<ul class="sectlevel3">
+<li><a href="#_dataflow-graph">22.2.1. Dataflow graph</a></li>
+<li><a href="#_dataflow-analyses">22.2.2. Dataflow analyses</a>
+<ul class="sectlevel4">
+<li><a href="#_def-def-def-nothing-analysis">22.2.2.1. Def&#8594;Def / Def&#8594;Nothing analysis</a></li>
+<li><a href="#_def-use-decl-analysis">22.2.2.2. Def|Use&#8592;Decl analysis</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="publish_npms.html#sec:publish-npms-to-public">23. Publish npms</a>
+<ul class="sectlevel2">
+<li><a href="publish_npms.html#sec:publish-npms-n4js-maven">23.1. Publish n4js-libs to during  maven build</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Hints">Appendix A: Hints</a>
+<ul class="sectlevel2">
+<li><a href="appendix_a_hints.html#sec:XtextInjection">A.1. Xtext Injection</a>
+<ul class="sectlevel3">
+<li><a href="appendix_a_hints.html#sec:DI_MultipleInjectors_Singletons">A.1.1. Multiple Injectors and Singletons</a>
+<ul class="sectlevel4">
+<li><a href="appendix_a_hints.html#sec:DI_avoid_duplicate_singletons">A.1.1.1. Avoiding duplicate singletons</a>
+<ul class="sectlevel5">
+<li><a href="appendix_a_hints.html#sec:DI_binding_in_shared">A.1.1.1.1. Defining binding in the shared injector</a></li>
+<li><a href="appendix_a_hints.html#sec:DI_binding_in_custom">A.1.1.1.2. Defining binding in the custom injector</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:DI_Hints">A.1.2. Dependency Injection Hints</a>
+<ul class="sectlevel4">
+<li><a href="appendix_a_hints.html#sec:DI_custom_bundle">A.1.2.1. Use DI in custom bundle, use DI with extensions</a>
+<ul class="sectlevel5">
+<li><a href="appendix_a_hints.html#sec:DI_custom_bundle_problem">A.1.2.1.1. Problem</a></li>
+<li><a href="appendix_a_hints.html#sec:DI_custom_bundle_solution">A.1.2.1.2. Solution</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Access_Other_DSL_Injector">A.1.2.2. How do I get the Guice Injector of my language?</a>
+<ul class="sectlevel5">
+<li><a href="appendix_a_hints.html#sec:DSL_Injector_UI_context">A.1.2.2.1. UI context</a></li>
+<li><a href="appendix_a_hints.html#sec:DSL_Injector_Non_UI_context">A.1.2.2.2. Non UI context but with injection context</a></li>
+<li><a href="appendix_a_hints.html#sec:DSL_Injector_Non_UI_non_injection_context">A.1.2.2.3. Non UI context without injection context</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Cancel_Indicator">A.1.2.3. How do I get cancel indicators in different contexts?</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Eclipse">A.2. Eclipse</a>
+<ul class="sectlevel3">
+<li><a href="appendix_a_hints.html#sec:Show_Xtext_Index">A.2.1. Show the current Xtext index</a></li>
+<li><a href="appendix_a_hints.html#sec:Plugin_spy">A.2.2. Plug-in spy</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Maven-hints">A.3. Maven</a>
+<ul class="sectlevel3">
+<li><a href="appendix_a_hints.html#how-to-check-for-maven-mojo-updates">A.3.1. How to check for Maven MOJO updates</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#_module-loading">Appendix B: Module Loading</a>
+<ul class="sectlevel2">
+<li><a href="appendix_b_module_loading.html#sec:Dependency_Management">B.1. Dependency Management</a></li>
+<li><a href="appendix_b_module_loading.html#ecmascript-modules">B.2. ECMAScript Modules</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:ES5_Modules_Systems">B.2.1. ES5 Modules Systems</a></li>
+<li><a href="appendix_b_module_loading.html#sec:ES6_Modules">B.2.2. ES6 Modules</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:ECMAScript_Module_Loaders">B.3. ECMAScript Module Loaders</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:ES6_Module_Loaders">B.3.1. ES6 Module Loaders</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Polyfills_for_ES6_Module_Loaders">B.3.2. Polyfills for ES6 Module Loaders</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:es6_module_loader">B.3.2.1. es6-module-loader</a></li>
+<li><a href="appendix_b_module_loading.html#sec:SystemJS">B.3.2.2. SystemJS</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Demo">B.3.2.3. Demo</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#case-study-typescript">B.4. Case Study : TypeScript</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:ES6_Modules_Support">B.4.1. ES6 Modules Support</a></li>
+<li><a href="appendix_b_module_loading.html#sec:TypeScript_and_Module_Loading">B.4.2. TypeScript and Module Loading</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Cyclic_Dependencies">B.5. Cyclic Dependencies</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:Setup">B.5.1. Setup</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Transpile_and_Execute">B.5.2. Transpile and Execute</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Module_Format___AMD">B.5.2.1. Module Format = AMD</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Module_Format___CommonJS">B.5.2.2. Module Format = CommonJS</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Module_Format___SystemJS">B.5.2.3. Module Format = SystemJS</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Conclusion">B.5.3. Conclusion</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#system.register-as-transpilation-target">B.6. System.register as transpilation target</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:Introduction">B.6.1. Introduction</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:External_Transpilers">B.6.1.1. External Transpilers</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Example_of_a_System_register_module">B.6.1.2. Example of a System.register module</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Structure_of_a_System_register_module">B.6.2. Structure of a System.register module</a></li>
+<li><a href="appendix_b_module_loading.html#_transpilation-hints">B.6.3. Transpilation Hints</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Handling_Imports">B.6.3.1. Handling Imports</a></li>
+<li><a href="appendix_b_module_loading.html#sec:__exportFn__">B.6.3.2. &lt;&lt;exportFn&gt;&gt;</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Handling_Exports">B.6.3.3. Handling Exports</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Examples_w__Circular_Dependencies">B.6.4. Examples w/ Circular Dependencies</a></li>
+<li><a href="appendix_b_module_loading.html#sec:N4JS_Examples_w__Circular_Dependencies">B.6.5. N4JS Examples w/ Circular Dependencies</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Unresolved_Cyclic_Dependencies">B.6.5.1. Unresolved Cyclic Dependencies</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Variables___Functions">B.6.5.2. Examples with Variables &amp; Functions</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Classes">B.6.5.3. Examples with Classes</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Examples_with_SubClassing">B.6.5.4. Examples with SubClassing</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Miscellaneous">B.6.5.5. Miscellaneous</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#_resources">B.6.6. Resources</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:CommonJS_as_transpilation_target">B.7. CommonJS as transpilation target</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#_introduction-2">B.7.1. Introduction</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Transpilation_Hints">B.7.2. Transpilation Hints</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Import_Statements">B.7.2.1. Import Statements</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Export_Statements">B.7.2.2. Export Statements</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Tracking_Live_Bindings">B.7.2.3. Tracking Live Bindings</a></li>
+<li><a href="appendix_b_module_loading.html#sec:A_complete_example">B.7.2.4. A complete example</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#_resources-2">B.7.3. Resources</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_c_license.html#sec:License">Appendix C: License</a></li>
+<li><a href="appendix_d_acronyms.html#sec:Acronyms">Appendix D: Acronyms</a></li>
+<li><a href="appendix_e_bibliography_and_footnotes.html#_bibliography-and-footnotes">Appendix E: Bibliography and Footnotes</a></li>
+</ul>
+</div>
+</div>
+<div id="content"><div class="sect1">
+<h2 id="chap:flowgraphs"><a class="anchor" href="#chap:flowgraphs"></a><a class="link" href="#chap:flowgraphs">22. Flow Graphs</a></h2>
+<div class="sectionbody">
+<div class="sect2 language-n4js">
+<h3 id="sec:flowgraphs_overview"><a class="anchor" href="#sec:flowgraphs_overview"></a><a class="link" href="#sec:flowgraphs_overview">22.1. Flow graphs overview</a></h3>
+<div class="paragraph">
+<p>In this chapter, the control and data flow analyses are introduced.
+Since not all AST elements are relevant for the control or data flow analyses, a new marker class is introduced called <code>ControlFlowElement</code>.
+All AST elements which are part of the control flow graph implement this class.
+The term control flow is abbreviated as <em>CF</em> and hence <code>ControlFlowElement</code>s are abbreviated as <em>CF elements</em>.</p>
+</div>
+<div class="paragraph">
+<p></p>
+</div>
+<div class="sidebarblock">
+<div class="content">
+<a href="https://github.com/eclipse/n4js/issues/120" class="gray" title="GitHub Issues"><span class="image"><img src="images/issue.svg" alt=""></span> #120</a>
+</div>
+</div>
+<div class="paragraph">
+<p>The following picture shows the control flow graph of the function <code>f</code>.</p>
+</div>
+<div class="imageblock">
+<div class="content">
+<img src="chapters/30_flowgraphs/images/cfg_for_loop.png" alt="cfg for loop">
+</div>
+<div class="title">Figure 56. Control flow graph of a simple function</div>
+</div>
+<div class="sect3">
+<h4 id="_internal-graph"><a class="anchor" href="#_internal-graph"></a><a class="link" href="#_internal-graph">22.1.1. Internal graph</a></h4>
+<div class="paragraph">
+<p>Every <em>internal graph</em> refers to a single <em>control flow container</em>.
+The graph consists of <em>nodes</em> and <em>edges</em>, where the edges are instances of <code>ControlFlowEdge</code>, and nodes are instances of <code>Node</code>.
+Additionally, a so called <em>complex node</em> is used to group nodes that belong to the same CF element.</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Internal graph</dt>
+<dd>
+<p>Control flow graphs are created based on the AST elements.
+Nevertheless, a fine-grained abstraction is used that is called <em>internal graph</em>.
+The internal graph reflects all control flows and data effects that happen implicitly and are part of the language&#8217;s semantics.
+For instance, the for-of statement on iterable objects forks the control flow after invoking the <code>next()</code> method.
+This is done implicitly and not part of the written source code.
+Moreover, this invocation could cause side effects.
+These control flows and effects are reflected using the internal graph.
+To implement analyses that refer to AST elements, an API for flow analyses is provided which hides the internal graph and works with AST elements only.
+In the following, the term <em>control flow graph</em> refers to the internal graph.</p>
+</dd>
+<dt class="hdlist1">Control flow container</dt>
+<dd>
+<p>At several places in the AST, an execution of statements or elements can happen.
+Obviously, statements can be executed in bodies of methods or function expressions.
+In addition, execution can also happen in field initializers or the <code>Script</code> itself.
+Since all these AST elements can contain executable control flow elements (CF elements), they thus contain a control flow graph.
+In the following, these AST elements are called <em>control flow containers</em> or CF containers.</p>
+</dd>
+<dt class="hdlist1">Nodes</dt>
+<dd>
+<p>Nodes represent complete CF elements or parts of them.
+For instance, simple CF elements like a <code>break</code> statement are represented using only one node.
+Regarding more complex CF elements that introduce a more complex control flow, due to e.g. nested expressions, several nodes represent one CF element.
+All nodes of a single CF element are grouped within a complex node.</p>
+</dd>
+<dt class="hdlist1">Edges</dt>
+<dd>
+<p>Edges reference a start and an end node which reflects a forward control flow direction, which is in the following called forward traverse direction.
+Traversing from end to start of an edge is thus called backward traverse direction.
+The so called <em>next node</em> is either the end node in context of forward, or the start node in context of backward traverse direction.
+Edges also reflect the reason of the control flow using a control flow type.
+The default control flow type is called <code>Successor</code> and such edges connect two ordinary subsequent nodes.
+Other types like <code>Return</code> or <code>Break</code> indicate control flow that happens due to return or break statements.
+A special control flow type is <code>Repeat</code> that indicates the entry of a loop body.
+This edge is treated specially when traversing the control flow graph to avoid infinitive traversals of loops.</p>
+</dd>
+<dt class="hdlist1">Complex node</dt>
+<dd>
+<p>The complex node always has a single entry and exit node, no matter the control flow it causes.
+For instance, although the for-statement can contain various control flows among its nested CF elements, its complex node still has a single entry and exit node.
+This simplifies concatenating subsequent complex nodes, since only their exit nodes have to be connected to the following entry node.
+Aside from exit and entry node, a complex node usually contains additionally nodes to represent the CF element.
+These nodes are connected by control flow edge so that their control flow lies within complex node.
+However, regarding nested CF elements, the control flow leaves and re-enters a complex node.
+To specify which CF element is nested, a delegating node (<code>DelegatingNode</code>) is created that points to the nested CF element.</p>
+</dd>
+</dl>
+</div>
+<div class="paragraph">
+<p>Consider that source code elements can be nested like expressions that have sub-expressions as in <code>1 + 2 * 3</code>.
+Also statements can contain other statements like in <code>if (true) return;</code>.
+The design of the control flow graph deals with this nesting by mapping CF elements to several nodes.
+All nodes of one CF element are aggregated into the <em>complex node</em>.</p>
+</div>
+<div id="img:internalGraph" class="imageblock">
+<div class="content">
+<img src="chapters/30_flowgraphs/images/internalGraph.png" alt="internalGraph">
+</div>
+<div class="title">Figure 57. The source code of <code>1+2</code> creates an internal graph of three complex nodes to deal with nested integer literals</div>
+</div>
+<div class="paragraph">
+<p>The example in the <a href="#img:internalGraph">figure above</a> shows the internal graph produced by the source code <code>1+2</code>.
+Additionally, a simpler version of the internal graph is shown (called <em>User Graph View</em>), with which client analyses deal.
+The user graph view is only a view on the internal graph, but does not exist as an own instance.
+In the figure, the nesting of the integer literals becomes obvious:
+The control flow edges of delegating nodes targets entry nodes of different CF elements.
+Also, there are CF edges from the exit nodes of these nested CF elements to return the control flow.</p>
+</div>
+<div id="img:cn_for_stmt" class="imageblock">
+<div class="content">
+<img src="chapters/30_flowgraphs/images/cn_for_stmt.png" alt="cn for stmt">
+</div>
+<div class="title">Figure 58. Complex Node of for statement</div>
+</div>
+<div class="paragraph">
+<p>In the <a href="#img:cn_for_stmt">above figure</a>, the complex node of the for statement is shown.
+The details of the complex nodes of the nested CF elements (such as the initializer or the body statement) are omitted.
+The figure displays the control flow fork after the condition and also shows the <em>Repeat</em> edge that targets the for body.
+The node called <em>Catch Node</em> is used in situations when there are jumping control flows introduced for instance by a continue statement.
+The catch will will then be the target of an control flow edge that starts at the continue statement.</p>
+</div>
+<div class="paragraph">
+<p>The graph of nodes and edges is constructed in the following order.</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>First, for every CF element a complex node and all its nodes are created.
+Also, the nodes within the complex node are connected according to their control flow behavior.</p>
+</li>
+<li>
+<p>Second, all subsequent complex nodes are connected by connecting their exit and entry nodes.
+Moreover, nested complex nodes are connected by interpreting the delegating nodes.</p>
+</li>
+<li>
+<p>Third, jumping control due to <code>return</code>, <code>throw</code>, <code>break</code> or <code>continue</code> statements is computed.
+This is done by first deleting the successor edge of the jumping statement and introducing a new control flow edge that ends at the jump target.</p>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_optimizations"><a class="anchor" href="#_optimizations"></a><a class="link" href="#_optimizations">22.1.2. Optimizations</a></h4>
+<div class="paragraph">
+<p>The internal graph contains many nodes to simplify the graph construction.
+However, these nodes carry no relevant information when traversing the graph.
+Consequently, in an optimization step, they are removed from the graph for performance reasons.</p>
+</div>
+<div class="paragraph">
+<p>A node removal for a node <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>n</mi><mn>2</mn></msub></math> is done by replacing the path <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>n</mi><mn>1</mn></msub><mo>-</mo><mo>&gt;</mo><msub><mi>n</mi><mn>2</mn></msub><mo>-</mo><mo>&gt;</mo><msub><mi>n</mi><mn>3</mn></msub></math> by the new path <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>n</mi><mn>1</mn></msub><mo>-</mo><mo>&gt;</mo><msub><mi>n</mi><mn>3</mn></msub></math>.
+These removals are done for delegating nodes that only have one incoming and one outgoing edge.</p>
+</div>
+<div class="paragraph">
+<p>A second kind but similar optimization reduces the number of helper nodes that are used as entry nodes.
+In case a complex nodes consists only of exactly one entry and one exit node, both of these nodes are collapsed into one node.
+This remaining node then is the representing node of the AST element.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_api-for-client-analyses"><a class="anchor" href="#_api-for-client-analyses"></a><a class="link" href="#_api-for-client-analyses">22.1.3. API for client analyses</a></h4>
+<div class="paragraph">
+<p>To implement client analyses based on the control flow graph, the three classes <code>GraphVisitor</code>, <code>GraphExplorer</code> and <code>BranchWalker</code> are provided.
+They provide the means to visit CF elements in a control flow graph and also to traverse single control flow paths.
+The method <code>N4JSFlowAnalyses#analyze</code> can execute several client analyses in one run to maintain scalability.</p>
+</div>
+<div class="sect4">
+<h5 id="_mapping-from-internal-to-ast-elements"><a class="anchor" href="#_mapping-from-internal-to-ast-elements"></a><a class="link" href="#_mapping-from-internal-to-ast-elements">22.1.3.1. Mapping from internal to AST elements</a></h5>
+<div class="paragraph">
+<p>The API classes work with AST elements such as <code>ControlFlowElement</code> instead of the internally used graph classes <code>ComplexNode</code>, <code>Node</code> or <code>ControlFlowEdge</code>.
+The mapping from internal classes to AST elements is done in the <code>GraphVisitor</code> class.</p>
+</div>
+<div class="paragraph">
+<p>Note that the control flow graph has the following properties:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>ExpressionStatement</code>s are not represented.
+Instead, only their expressions are represented.
+Nevertheless, the API can deal with calls that refer to expression statements, e.g. when requesting their successors.</p>
+</li>
+<li>
+<p>Control statements are also not represented in the graph, but can also be used in calls to the API.
+The reason is, that it is unclear when a control statement (e.g. a for loop) is visited exactly.</p>
+</li>
+<li>
+<p>Since a <code>FlowEdge</code> which connects two <code>ControlFlowElement</code>s can represent multiple internal edges, it can have multiple <code>ControlFlowType</code>s.</p>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_graph-visitor"><a class="anchor" href="#_graph-visitor"></a><a class="link" href="#_graph-visitor">22.1.3.2. Graph visitor</a></h5>
+<div class="paragraph">
+<p>Graph visitors traverse the control flow graphs of every CF container of a script instance in the following two traverse directions:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><em>Forward</em>: from the container&#8217;s start to all reachable CF graph elements.</p>
+</li>
+<li>
+<p><em>Backward</em>: from the container&#8217;s end to all reachable CF graph elements.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>In each traverse direction, the graph visitor visits every reachable CF element and edge.
+Note that neither empty statements nor control statements are part of the control flow graph.
+The order of visited CF elements is related to either a breadth or a depth search on the CF graph.
+However, no specific order assumptions are guaranteed.</p>
+</div>
+<div class="imageblock">
+<div class="content">
+<img src="chapters/30_flowgraphs/images/deadcode.png" alt="deadcode">
+</div>
+<div class="title">Figure 59. The CF elements <code>"loop"</code> and <code>"end"</code> are dead code and displayed in grey.</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_graph-explorer"><a class="anchor" href="#_graph-explorer"></a><a class="link" href="#_graph-explorer">22.1.3.3. Graph explorer</a></h5>
+<div class="paragraph">
+<p>Graph visitors can request a <em>graph explorer</em> to be activated under specific conditions related to the client analysis.
+A graph explorer is the start point to analyze control flow branches.
+The first control flow branches is started directly at the graph explorer&#8217;s creation site, but of course this first branches might fork eventually.
+The graph explorer keeps track of all forked branches that originate at its activation site.
+It also provides the means to join previously forked branches again.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_branch-walker"><a class="anchor" href="#_branch-walker"></a><a class="link" href="#_branch-walker">22.1.3.4. Branch walker</a></h5>
+<div class="paragraph">
+<p>With every graph explorer, a branch walker is created that traverses the control flow graph beginning from the activation site of the graph explorer.
+On every such branch, the two visit methods of CF elements and edges respectively, are called in the order of the traverse direction.
+Every time the branch forks, the fork method of the branch walker is invoked and creates another branch walker which will continue the traversal on the forked branch.
+The fork method can be used to copy some path data or state to the newly forked branch walker.
+Note that every edge is always followed by the branch walker except for repeat edges which are followed exactly twice.
+The reason to follow them twice is that first, following them only once would hide those control flows that re-visit the same CF elements due to the loop.
+Second, following them more than twice does not reveal more insights, but only increases the number of branches.
+When control flow branches merge again, for instance at the end of an <code>if</code>-statement, two or more branch walkers are merged into a new succeeding one.
+The graph explorer provides the means to do this.
+In case a CF element has no next elements, the branch walker terminates.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_example-1-compute-string-for-each-path"><a class="anchor" href="#_example-1-compute-string-for-each-path"></a><a class="link" href="#_example-1-compute-string-for-each-path">22.1.3.5. Example 1: Compute string for each path</a></h5>
+<div class="paragraph">
+<p>Let&#8217;s assume that we want to compute all control flow branches of a function and use the client API for that.
+The function <code>f()</code> in the following code snippet has four control flow branches: <code>1 &#8594; 2</code>, <code>&#8594; 3 &#8594;</code>, <code>&#8594; 4 &#8594;</code> and <code>5</code>.</p>
+</div>
+<div class="listingblock">
+<div class="title">Function <code>f()</code> has four control flow branches.</div>
+<div class="content">
+<pre class="highlight"><code>function f() {
+	1;
+	if (2)
+		3;
+	else
+		4;
+	5;
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>To compute these control flow branches, the class <code>AllBranchPrintVisitor</code> extends the <code>GraphVisitor</code>.
+Already in the method <code>initializeMode()</code> a graph explorer is activated.
+Note that the method <code>requestActivation()</code> can be understood as a <code>addListener</code> method for a listener that listens to visit events on nodes and edges.
+Immediately after the activation request, the first branch walker is created in the method <code>firstBranchWalker()</code>.</p>
+</div>
+<div class="paragraph">
+<p>The first visited CF element of the branch walker will then be the expression <code>1</code>.
+It is formed into a string and added to the variable <code>curString</code>.
+After expression <code>1</code>, the flow edge from <code>1</code> to <code>2</code> is visited.
+This will concatenate the string <code>&#8594;</code> to the path string.
+Variable <code>curString</code> will eventually hold the branch string like <code>1 &#8594; 2</code>.
+Since the control flow forks after <code>2</code>, the method <code>forkPath()</code> is called and creates two new instances of a branch walker.
+These new instances succeed the the first branch walker instance and each traverses one of the branches of the <code>if</code>-statement.
+When the <code>if</code>-statement is passed, these two branches are merged into a new succeeding branch walker.
+After all branch walkers are terminated, the graph explorer and graph visitor are also terminated.
+The method <code>getBranchStrings()</code> collects all four computed strings from the variable <code>curString</code> of all branch walkers.</p>
+</div>
+<div class="listingblock">
+<div class="title">Implementation of a graph visitor that computes all control flow paths</div>
+<div class="content">
+<pre class="highlight"><code>class AllBranchPrintVisitor extends GraphVisitor {
+	protected void initializeMode(Mode curDirection, ControlFlowElement curContainer) {
+		super.requestActivation(new AllBranchPrintExplorer());
+	}
+
+	class AllBranchPrintExplorer extends GraphExplorer {
+		class AllBranchPrintWalker extends BranchWalker {
+			String curString = "";
+
+			protected void visit(ControlFlowElement cfe) {
+				curString += cfe.toString();
+			}
+
+			protected void visit(FlowEdge edge) {
+				curString += " -&gt; ";
+			}
+
+			protected AllBranchPrintWalker forkPath() {
+				return new AllBranchPrintWalker();
+			}
+		}
+
+		protected BranchWalker joinBranches(List&lt;BranchWalker&gt; branchWalkers) {
+			// TODO Auto-generated method stub
+			return null;
+		}
+
+		protected BranchWalkerInternal firstBranchWalker() {
+			return new AllBranchPrintWalker();
+		}
+	}
+
+	List&lt;String&gt; getBranchStrings() {
+		List&lt;String&gt; branchStrings = new LinkedList&lt;&gt;();
+		for (GraphExplorerInternal app : getActivatedExplorers()) {
+			for (BranchWalkerInternal ap : app.getAllBranches()) {
+				AllBranchPrintWalker printPath = (AllBranchPrintWalker) ap;
+				branchStrings.add(printPath.curString);
+			}
+		}
+		return branchStrings;
+	}
+}</code></pre>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_path-quantor"><a class="anchor" href="#_path-quantor"></a><a class="link" href="#_path-quantor">22.1.3.6. Path quantor</a></h5>
+<div class="paragraph">
+<p>Graph explorers are typically used to reason on all branch walkers that start at a specific location.
+For instance, such a reasoning might determine whether some source element is reachable or whether a variable is used or not.
+To simplify this, quantors are provided.
+Since branch walkers originating from a single activation point can fork, the reasoning has to include all these forked branch walkers.
+Hence, graph explorers are instantiated using a quantor which can be either <em>For All</em>, <em>At Least One</em> OR <em>None</em> that refers to all branches.
+After all branch walkers of an explorer are terminated, the explorer is regarded as either passed or failed.
+Paths also can be aborted manually using the methods <code>pass()</code> or <code>fail()</code>.
+When <em>pass</em> or <em>fail</em> are used, the graph explorer might be terminated in the following cases:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>If the quantor of the graph explorer is <em>For All</em>, and <code>fail()</code> is called on a branch walker.</p>
+</li>
+<li>
+<p>If the quantor of the graph explorer is <em>At Least One</em>, and <code>pass()</code> is called on a branch walker.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Additionally, a graph explorer can be aborted manually by canceling all its branches.</p>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_control-flow-analyses"><a class="anchor" href="#_control-flow-analyses"></a><a class="link" href="#_control-flow-analyses">22.1.4. Control flow analyses</a></h4>
+<div class="sect4">
+<h5 id="_dead-code-analysis"><a class="anchor" href="#_dead-code-analysis"></a><a class="link" href="#_dead-code-analysis">22.1.4.1. Dead code analysis</a></h5>
+<div class="paragraph">
+<p>The dead code analysis uses the graph visitor in all four modes and collects all visited CF elements.
+The collected CF elements are saved separately for every mode.
+After the graph visitor is terminated, the unreachable CF elements are computed like follows:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>CF elements, that are collected during forward and catch block mode are reachable.</p>
+</li>
+<li>
+<p>CF elements, that are collected during islands mode are unreachable.</p>
+</li>
+<li>
+<p>CF elements, that are <em>only</em> collected during backward mode, are also unreachable.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>In a later step, the unreachable elements are merged into unreachable text regions that are used for error markers.</p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:dataflow"><a class="anchor" href="#sec:dataflow"></a><a class="link" href="#sec:dataflow">22.2. Dataflow</a></h3>
+<div class="paragraph">
+<p></p>
+</div>
+<div class="sidebarblock">
+<div class="content">
+<a href="https://github.com/eclipse/n4js/issues/331" class="gray" title="GitHub Issues"><span class="image"><img src="images/issue.svg" alt=""></span> #331</a>
+<a href="https://github.com/eclipse/n4js/issues/464" class="gray" title="GitHub Issues"><span class="image"><img src="images/issue.svg" alt=""></span> #464</a>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_dataflow-graph"><a class="anchor" href="#_dataflow-graph"></a><a class="link" href="#_dataflow-graph">22.2.1. Dataflow graph</a></h4>
+<div class="paragraph">
+<p>The data flow graph provides means to reason about <em>symbols</em>, <em>effects</em>, <em>data flow</em>, <em>aliases</em> and <em>guards</em> in the control flow graph.
+The main classes of the data flow API are <code>DataflowVisitor</code> and <code>Assumption</code>.</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Symbol</dt>
+<dd>
+<p>Symbols represent a program variable in the sence that it represents all AST elements, that bind to the same variable declaration (according to scoping).
+The terms <em>symbol</em> and <em>variable</em> are used synonymously.</p>
+</dd>
+<dt class="hdlist1">Effect</dt>
+<dd>
+<p>Effects are reads, writes and declarations of symbols.
+For instance, a typical CF element with a write effect is an assignment such as <code>a = null;</code>.
+Every effect refers to a single symbol and graph node.
+The following effects are provided:</p>
+<div class="ulist">
+<ul>
+<li>
+<p><em>Declaration</em>: is the declaration of a variable.</p>
+</li>
+<li>
+<p><em>Write</em>: is the definition of a variable&#8217;s value, which is typically done with an assignment.</p>
+</li>
+<li>
+<p><em>Read</em>: is the read of a variable&#8217;s value, which could happen when passing a variable as an argument to a method call.</p>
+</li>
+<li>
+<p><em>MethodCall</em>: is the call of a property method of a variable.</p>
+</li>
+</ul>
+</div>
+</dd>
+</dl>
+</div>
+<div class="paragraph">
+<p>Note that the term <em>value use</em> means either write or method call of a variable.
+The term <em>value definition</em> means that a variable is written.</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Data flow</dt>
+<dd>
+<p>The term data flow is used for assignments of all kind.
+For instance, the assigments <code>a = b</code>, <code>a = 1</code>, <code>a = null</code> or even <code>for (let [a] of [[0],[undefined]]);</code> are data flows.
+The data is always flowing from the right hand side to the left hand side.</p>
+</dd>
+<dt class="hdlist1">Alias</dt>
+<dd>
+<p>Due to data flow, other symbols can get important for an analysis.
+For instance, the data flow <code>a = b</code> makes <code>b</code> important when reasoning about <code>a</code> since the value of <code>b</code> is assigned to <code>a</code>.
+In the API is <code>b</code> therefore called an alias of <code>a</code>.</p>
+</dd>
+<dt class="hdlist1">Guard</dt>
+<dd>
+<p>Guards are conditions that appear in e.g. <code>it</code>-statements.
+For instance, a typical guard is the null-check in the following statement: <code>if (a == null) foo();</code>.
+For every CF element, guards can hold either <em>always</em>, <em>never</em> or <em>sometimes</em>.
+Note that the null-check-guard always holds at the method invocation <code>foo();</code>.</p>
+</dd>
+<dt class="hdlist1"><code>DataflowVisitor</code></dt>
+<dd>
+<p>The class <code>DataflowVisitor</code> provides means to visit all code locations where either effects happen or guards are declared.
+For instance, when a variable is written, the callback method <code>DataflowVisitor#visitEffect(EffectInfo effect, ControlFlowElement cfe)</code> gets called.
+In case a guard is declared, the callback method <code>visitGuard(Guard guard)</code> gets called.</p>
+</dd>
+<dt class="hdlist1"><code>Assumption</code></dt>
+<dd>
+<p>The class <code>Assumption</code> provides means to track the data flow of a specific symbol from a specific code location.
+For instance, assumptions are used to detect whether the symbol <code>s</code> in the property access <code>s.prop</code> is or may be undefined.
+In this example, the assumption symbol is <code>s</code> and its start location is the property access.
+From there, the data flow of <code>s</code> is tracked in backwards traverse direction.
+Also, (transitive) aliases of <code>s</code> are tracked.
+In case a data flow that happens on <code>s</code> or its aliases, the callback method <code>holdsOnDataflow(Symbol lhs, Symbol rSymbol, Expression rValue)</code> is called.
+For every effect that affects <code>s</code> or one of its aliases, the callback method <code>holdsOnEffect(EffectInfo effect, ControlFlowElement container)</code> is called.
+And finally, for all guards that hold always/never at the start location regarding symbol <code>s</code>, the callback method <code>holdsOnGuards(Multimap&lt;GuardType, Guard&gt; neverHolding, Multimap&lt;GuardType, Guard&gt; alwaysHolding)</code> is called.</p>
+</dd>
+</dl>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_dataflow-analyses"><a class="anchor" href="#_dataflow-analyses"></a><a class="link" href="#_dataflow-analyses">22.2.2. Dataflow analyses</a></h4>
+<div class="sect4">
+<h5 id="_def-def-def-nothing-analysis"><a class="anchor" href="#_def-def-def-nothing-analysis"></a><a class="link" href="#_def-def-def-nothing-analysis">22.2.2.1. Def&#8594;Def / Def&#8594;Nothing analysis</a></h5>
+<div class="paragraph">
+<p>A Def&#8594;Def analysis finds all defintions of a variable that are always a predecessor of another definition.
+Its result is a set of all obsolete definition sites.</p>
+</div>
+<div class="paragraph">
+<p>A Def&#8594;!Use analysis finds all definitions of a variable that are not followed by either a read or a method call.
+These definition are therefore obsolete and can be removed.</p>
+</div>
+<div class="paragraph">
+<p>Both of these analyses are performed in traverse direction <em>Forward</em>.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_def-use-decl-analysis"><a class="anchor" href="#_def-use-decl-analysis"></a><a class="link" href="#_def-use-decl-analysis">22.2.2.2. Def|Use&#8592;Decl analysis</a></h5>
+<div class="paragraph">
+<p>A Def|Use&#8592;Decl analysis finds all preceding <em>def</em> or <em>use</em> sites of a declarations of a specific variable.
+The paths might contain other <em>defs</em> or <em>uses</em> of the same variable.
+In case such paths exists, the variable is used before it is declared.
+This analysis is done in traverse direction <em>Backward</em>.</p>
+</div>
+<div id="img:usedBeforeDeclaredAnalysis" class="imageblock">
+<div class="content">
+<img src="chapters/30_flowgraphs/images/usedBeforeDeclaredAnalysis.png" alt="usedBeforeDeclaredAnalysis">
+</div>
+<div class="title">Figure 60. Finding use or def sites can be done using the graph visitor in traverse direction <em>Backward</em>.</div>
+</div>
+<div class="paragraph">
+<p>In the <a href="#img:usedBeforeDeclaredAnalysis">above figure</a> a graph visitor would visit all CF elements.
+When it visits the declaration in line 8 (<code>let w</code>), it will activate a graph explorer (star 1 in the figure) for variable <code>w</code>.
+Now, the first branch walker <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>b</mi><mn>1</mn></msub></math> is created and walks the control in backward traverse direction.
+When <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>b</mi><mn>1</mn></msub></math> encounters the exit node of the <code>if</code>-statement, it will create two forked branches <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>b</mi><mn>2</mn></msub></math> and <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>b</mi><mn>3</mn></msub></math>.
+Now, <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>b</mi><mn>2</mn></msub></math> enters then the branch of the <code>if</code>-statement (star 2), while <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>b</mi><mn>3</mn></msub></math> traverses directly to the condition of the <code>if</code>-statement.
+Next, <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>b</mi><mn>2</mn></msub></math> visits the def site of variable <code>w</code> (star 3).
+This means, that there exist a def site of <code>w</code> before <code>w</code> was declared and hence, an error should be shown.
+Since there could exist more cases like this, neither the branch walker nor the graph explorer are terminated.
+When reaching star 4, the two branch walkers <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>b</mi><mn>2</mn></msub></math> and <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>b</mi><mn>3</mn></msub></math> are joined and the follow-up branch walker <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>b</mi><mn>4</mn></msub></math> is created.
+At star 5, the end the CF container is reached and the <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>b</mi><mn>4</mn></msub></math> will be terminated.
+After all branch walkers are terminated, the graph explorer for the declaration site of variable <code>w</code> is evaluated:
+All use or def sites, that were reachable should be marked with an error saying that the declaration has to be located before the use of a variable.</p>
+</div>
+<div class="paragraph">
+<p>Note this analysis is currently implemented as a control flow analysis since it does not rely on guards, aliases.
+Also, it only relies on local variables and hence does not need the symbols that are provided by the data flow API.</p>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div id="footer">
+<div id="footer-text">
+Version 0.9<br>
+Last updated 2019-08-07 15:02:40 CEST
+</div>
+</div>
+<!-- ************* docinfo-footer *************************************************************** -->
+<div class="Grid social" style="color:#d5dfea">
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <h2>Quick Links</h2>
+    <ul>
+      <li><a href="../downloads.html">Download</a></li>
+      <li><a href="../userguides/index.html">Documentation</a></li>
+      <li><a href="https://github.com/eclipse/n4js/">Source</a></li>
+      <li><a href="https://github.com/eclipse/n4js/issues">Issues</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="https://www.eclipse.org/forums/index.php/f/365/">Forum</a></li>
+      <li><a href="http://n4js.blogspot.de/">Blog</a></li>
+      <li><a href="https://dev.eclipse.org/mailman/listinfo/n4js-dev">Mailing List</a></li>
+      <li><a href="https://projects.eclipse.org/projects/technology.n4js">Eclipse Project Page</a></li>
+      <li><a href="https://twitter.com/n4jsdev">Tweets by n4jsdev</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="http://www.eclipse.org/">Eclipse Home</a></li>
+      <li><a href="http://www.eclipse.org/legal/privacy.php">Privacy Policy</a></li>
+      <li><a href="http://www.eclipse.org/legal/termsofuse.php">Terms of Use</a></li>
+      <li><a href="http://www.eclipse.org/legal/copyright.php">Copyright Agent</a></li>
+      <li><a href="http://www.eclipse.org/legal/">Legal</a></li>
+    </ul>
+  </div>
+  <div style="clear: both; height: 0; overflow: hidden;"></div>
+</div>
+
+<!-- ************* UI Scripts ************* -->
+<script type="text/javascript" src="scripts/back-to-top.js"></script>
+
+<script type="text/javascript" src="scripts/treeview.js"></script>
+<script type="text/javascript" src="scripts/toc.js"></script>
+
+<!-- ************* Prism.js Syntax Highlighting ************* -->
+<script src="scripts/prism.js"></script>
+
+<script type="text/javascript">
+	// Add the 'toclist' id for search function
+	$(".toc2 > ul").attr('id', 'toclist');
+	// Generate a Search input form
+	$("#toclist > li:first-of-type").before('<input type="text" id="pagesearch" onkeyup="search()" placeholder="Search for section...">');
+	$("#toclist > li:first-of-type").before('<i id="clear" class="fa fa-times-circle-o"></i>');
+	$("#clear").click(function(){
+	    $("#pagesearch").val('');
+	    search();
+	    $('.toc2 > ul').treeView('collapseAll');
+	});
+	// intialize Treeview.js
+	$(".toc2 > ul").treeView();
+	// Initialize Scrollspy
+</script>
+<!-- ************* docinfo-footer *************************************************************** -->
+</body>
+</html>
\ No newline at end of file
diff --git a/design/formatting.html b/design/formatting.html
new file mode 100644
index 0000000..1ca41ac
--- /dev/null
+++ b/design/formatting.html
@@ -0,0 +1,1132 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="generator" content="Asciidoctor 1.5.5">
+<meta name="author" content="2019-08-07 15:02:40 CEST">
+<title>N4JS Design Specification</title>
+<link rel="stylesheet" href="styles/spec.min.css">
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.6.3/css/font-awesome.min.css">
+<!-- ************* docinfo ******************************************************************* -->
+
+
+<!-- ************* Favicon ************-->
+<link rel="icon" href="images/favicon.ico" />
+
+<!-- ************* Back-to-top JQuery ************* -->
+<script src="https://code.jquery.com/jquery-1.12.4.js"></script>
+<script src="https://code.jquery.com/ui/1.12.0/jquery-ui.js"></script>
+
+
+<link href="styles/prism.min.css" rel="stylesheet" />
+<script type="text/javascript" async
+  src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2/MathJax.js?config=TeX-MML-AM_CHTML">
+</script>
+
+<!-- ************* Styles ************* -->
+<link rel="stylesheet" type="text/css" href="styles/n4jsspec-adoc.css">
+
+
+<!-- ****************** NavBar ****************** -->
+<div id="menubar">
+	<div class="banner">
+        <a href="https://www.eclipse.org/n4js/#"><img id="logo" src="images/n4js-logo.png" alt="Eclipse N4JS"></a>
+    </div>
+<ul>
+  <li><a href="index.html">Index</a></li>
+</ul>
+</div>
+<!-- ************* docinfo ******************************************************************* -->
+<style>
+      .admonitionblock td.icon .icon-todo:before{content:"\f249";color:#f4ee42}
+    </style>
+</head>
+<body class="book toc2 toc-left">
+<div id="header">
+<h1>N4JS Design Specification</h1>
+<div class="details">
+<span id="author" class="author">2019-08-07 15:02:40 CEST</span><br>
+<span id="revnumber">version 0.9</span>
+</div>
+<div id="toc" class="toc2">
+<div id="toctitle">Table of Contents</div>
+<ul class="sectlevel1">
+<li><a href="introduction.html#_introduction">1. Introduction</a>
+<ul class="sectlevel2">
+<li><a href="introduction.html#notation">1.1. Notation</a></li>
+<li><a href="introduction.html#sec:IDE_Overview">1.2. IDE Components</a>
+<ul class="sectlevel3">
+<li><a href="introduction.html#sec:Naming_Conventions">1.2.1. Naming Conventions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="eclipse_setup.html#_eclipse-setup">2. Eclipse Setup</a>
+<ul class="sectlevel2">
+<li><a href="eclipse_setup.html#_system-requirements">2.1. System Requirements</a></li>
+<li><a href="eclipse_setup.html#_contribute">2.2. Contribute</a>
+<ul class="sectlevel3">
+<li><a href="eclipse_setup.html#_eclipse-installer">2.2.1. Eclipse Installer</a>
+<ul class="sectlevel4">
+<li><a href="eclipse_setup.html#_changing-the-setup-script">2.2.1.1. Changing the Setup Script</a></li>
+</ul>
+</li>
+<li><a href="eclipse_setup.html#_manual-ide-configuration">2.2.2. Manual IDE Configuration</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="release_engineering.html#_release-engineering">3. Release Engineering</a>
+<ul class="sectlevel2">
+<li><a href="release_engineering.html#_nightly-build-on-eclipse-infrastructure">3.1. Nightly build on Eclipse infrastructure</a></li>
+<li><a href="release_engineering.html#_build-the-n4js-ide-from-command-line">3.2. Build the N4JS IDE from command line</a>
+<ul class="sectlevel3">
+<li><a href="release_engineering.html#_publish-maven-tooling-code-org-eclipse-n4js-releng-util-code">3.2.1. Publish maven-tooling <code>org.eclipse.n4js.releng.util</code></a></li>
+<li><a href="release_engineering.html#sec:test-verdaccio">3.2.2. Test Verdaccio containing n4js-libs</a></li>
+<li><a href="release_engineering.html#_generation-of-eclipse-help-for-spec-and-design-document">3.2.3. Generation of Eclipse help for spec and design document</a></li>
+</ul>
+</li>
+<li><a href="release_engineering.html#_updating-frameworks-and-dependencies">3.3. Updating frameworks and dependencies</a>
+<ul class="sectlevel3">
+<li><a href="release_engineering.html#_update-of-eclipse-emf-xtext-etc">3.3.1. Update of Eclipse, EMF, Xtext, etc.</a></li>
+<li><a href="release_engineering.html#_update-of-the-embedded-jre">3.3.2. Update of the embedded JRE</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tips_and_tricks.html#_tips-and-tricks">4. Tips and Tricks</a>
+<ul class="sectlevel2">
+<li><a href="tips_and_tricks.html#_naming">4.1. Naming</a></li>
+<li><a href="tips_and_tricks.html#_logging">4.2. Logging</a></li>
+<li><a href="tips_and_tricks.html#_cancellation-handling">4.3. Cancellation Handling</a></li>
+<li><a href="tips_and_tricks.html#_caching">4.4. Caching</a></li>
+<li><a href="tips_and_tricks.html#_dependency-injection">4.5. Dependency Injection</a></li>
+<li><a href="tips_and_tricks.html#_miscellaneous">4.6. Miscellaneous</a></li>
+</ul>
+</li>
+<li><a href="parser.html#_parser">5. Parser</a>
+<ul class="sectlevel2">
+<li><a href="parser.html#sec:Parser_Overview">5.1. Overview</a></li>
+<li><a href="parser.html#sec:N4JS_Parser">5.2. N4JS Parser</a></li>
+<li><a href="parser.html#sec:Parser_Generation_Post_Processing">5.3. Parser Generation Post-Processing</a>
+<ul class="sectlevel3">
+<li><a href="parser.html#sec:Automatic_Semicolon_Insertion">5.3.1. Automatic Semicolon Insertion</a>
+<ul class="sectlevel4">
+<li><a href="parser.html#sec:Injected_code_in_the_Antlr_grammar_file">5.3.1.1. Injected code in the Antlr grammar file</a></li>
+<li><a href="parser.html#sec:Customized_error_recovery">5.3.1.2. Customized error recovery</a></li>
+</ul>
+</li>
+<li><a href="parser.html#sec:_No_line_terminator_allowed_here__handling">5.3.2. Async and <code>No line terminator allowed here</code> Handling</a></li>
+<li><a href="parser.html#sec:Regular_Expression">5.3.3. Regular Expression</a></li>
+<li><a href="parser.html#sec:Unicode">5.3.4. Unicode</a></li>
+<li><a href="parser.html#sec:Literals">5.3.5. Literals</a></li>
+</ul>
+</li>
+<li><a href="parser.html#sec:Modifiers">5.4. Modifiers</a></li>
+<li><a href="parser.html#sec:Conflict_Resolutions">5.5. Conflict Resolutions</a>
+<ul class="sectlevel3">
+<li><a href="parser.html#sec:Reserved_Keywords_vs__Identifier_Names">5.5.1. Reserved Keywords vs. Identifier Names</a></li>
+<li><a href="parser.html#sec:Operators_and_Generics">5.5.2. Operators and Generics</a></li>
+</ul>
+</li>
+<li><a href="parser.html#sec:Content_Assist_Parser">5.6. Content-Assist Parser</a></li>
+</ul>
+</li>
+<li><a href="type_system.html#_type-system">6. Type System</a>
+<ul class="sectlevel2">
+<li><a href="type_system.html#sec:Type_Model_and_Grammar">6.1. Type Model and Grammar</a>
+<ul class="sectlevel3">
+<li><a href="type_system.html#sec:Type_Model_Overview">6.1.1. Type Model Overview</a></li>
+<li><a href="type_system.html#sec:Built_in_Types">6.1.2. Built-in and Primitive Types</a></li>
+<li><a href="type_system.html#sec:Type_Model_DSL">6.1.3. Type Model DSL</a></li>
+</ul>
+</li>
+<li><a href="type_system.html#sec:Type_System_Implementation">6.2. Type System Implementation</a></li>
+<li><a href="type_system.html#sec:Type_Inference_combined_with_AST_Traversal">6.3. Type Inference of AST</a>
+<ul class="sectlevel3">
+<li><a href="type_system.html#sec:Type_Inference_combined_with_AST_Traversal__Background">6.3.1. Background</a></li>
+<li><a href="type_system.html#sec:Triggering_Type_Inference_of_AST">6.3.2. Triggering</a></li>
+<li><a href="type_system.html#sec:Traversal_Order_During_Type_Inference_of_AST">6.3.3. Traversal Order</a></li>
+<li><a href="type_system.html#sec:Cross_References_During_Type_Inference_of_AST">6.3.4. Cross-References</a></li>
+<li><a href="type_system.html#sec:Function_Accessor_Bodies_During_Type_Inference_of_AST">6.3.5. Function/Accessor Bodies</a></li>
+<li><a href="type_system.html#sec:Poly_Expressions_During_Type_Inference_of_AST">6.3.6. Poly Expressions</a></li>
+<li><a href="type_system.html#sec:Constraint_Solver_used_During_Type_Inference_of_AST">6.3.7. Constraint Solver</a></li>
+<li><a href="type_system.html#sec:Type_Guards_During_Type_Inference_of_AST">6.3.8. Type Guards</a></li>
+</ul>
+</li>
+<li><a href="type_system.html#sec:Structural_Typing">6.4. Structural Typing</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#_type-index">7. Type Index</a>
+<ul class="sectlevel2">
+<li><a href="type_index.html#sec:Type_Index_Design_Rationale">7.1. Design Rationale</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#sec:Getting_the_Xtext_Index_Content_IResourceDescriptions">7.1.1. Getting the Xtext Index (<code>IResourceDescriptions</code>) Content</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#sec:Design_Overview">7.2. Design Overview</a></li>
+<li><a href="type_index.html#sec:N4JS_Resource_Load_States">7.3. N4JS Resource Load States</a></li>
+<li><a href="type_index.html#sec:Type_Builder">7.4. Types Builder</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#sec:Type_Inference_not_allowed_in_Type_Builder">7.4.1. Type Inference not allowed in Types Builder</a></li>
+<li><a href="type_index.html#sec:ComputedTypeReferences">7.4.2. Deferred Type References</a></li>
+<li><a href="type_index.html#sec:Use_cases_of_ComputedTypeRef">7.4.3. Use cases of DeferredTypeRef</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#sec:Incremental_Builder_Overview">7.5. Incremental Builder (Overview)</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#sec:Incremental_Builder_Overview__XtextBuilder">7.5.1. XtextBuilder</a></li>
+<li><a href="type_index.html#sec:Incremental_Builder_Overview__IBuilderState">7.5.2. IBuilderState</a>
+<ul class="sectlevel4">
+<li><a href="type_index.html#copy-and-update-xtext-index">7.5.2.1. Copy and Update Xtext Index</a></li>
+<li><a href="type_index.html#build-state-setup-phase">7.5.2.2. Build State Setup Phase</a></li>
+<li><a href="type_index.html#process-queued-uris">7.5.2.3. Process Queued URIs</a></li>
+<li><a href="type_index.html#queueing-affected-resources">7.5.2.4. Queueing Affected Resources</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#sec:Incremental_Builder_Overview__Example">7.5.3. Example</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#dirty-state-handling">7.6. Dirty state handling</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#use-case-restoring-types-from-user-data">7.6.1. Use case: Restoring types from user data</a></li>
+<li><a href="type_index.html#use-case-updating-the-xtext-index">7.6.2. Use case: Updating the Xtext index</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="project_model.html#_project-model">8. Project Model</a>
+<ul class="sectlevel2">
+<li><a href="project_model.html#sec:Package_json">8.1. Package.json File</a></li>
+<li><a href="project_model.html#_accessing-project-information">8.2. Accessing Project Information</a>
+<ul class="sectlevel3">
+<li><a href="project_model.html#sec:IN4JSCore">8.2.1. IN4JSCore</a></li>
+<li><a href="project_model.html#sec:N4JSModel">8.2.2. N4JSModel</a></li>
+<li><a href="project_model.html#sec:N4JSWorkspace">8.2.3. N4JSWorkspace</a></li>
+<li><a href="project_model.html#sec:N4JSProject">8.2.4. N4JSProject</a></li>
+<li><a href="project_model.html#sec:SourceContainer">8.2.5. SourceContainer</a></li>
+<li><a href="project_model.html#sec:N4JSProjectsStateHelper">8.2.6. N4JSProjectsStateHelper</a></li>
+</ul>
+</li>
+<li><a href="project_model.html#sec:Caching">8.3. Caching</a>
+<ul class="sectlevel3">
+<li><a href="project_model.html#_caching-of-externallibraryworkspace">8.3.1. Caching of ExternalLibraryWorkspace</a></li>
+<li><a href="project_model.html#_caching-of-n4jsprojectsstatehelper">8.3.2. Caching of N4JSProjectsStateHelper</a></li>
+</ul>
+</li>
+<li><a href="project_model.html#sec:WildcardPathFilter">8.4. WildcardPathFilter</a></li>
+<li><a href="project_model.html#sec:ProjectUtils">8.5. ProjectUtils</a></li>
+</ul>
+</li>
+<li><a href="binding.html#_binding">9. Binding</a>
+<ul class="sectlevel2">
+<li><a href="binding.html#sec:Binding_Design_Rationale">9.1. Design Rationale</a></li>
+<li><a href="binding.html#sec:Binding_to_Members">9.2. Binding to Members</a></li>
+<li><a href="binding.html#sec:Binding_Getter_Setter">9.3. Getter / Setter Binding</a></li>
+<li><a href="binding.html#chap:Statics">9.4. Static Member Binding</a></li>
+<li><a href="binding.html#sec:Binding_Enumeration">9.5. Enumeration Literals Binding</a></li>
+<li><a href="binding.html#sec:Accessibility_of_types_and_members">9.6. Accessibility of types and members</a></li>
+<li><a href="binding.html#sec:Member_Scope_Example">9.7. Member Scope Example</a></li>
+<li><a href="binding.html#sec:Scoping_for_Members_of_Composed_Type_Explained">9.8. Scoping for Members of Composed Type (Union/Intersection) Example</a></li>
+<li><a href="binding.html#sec:Binding_of_Structurally_References_Types">9.9. Structurally References Types</a></li>
+<li><a href="binding.html#sec:Building">9.10. Building</a>
+<ul class="sectlevel3">
+<li><a href="binding.html#sec:Build_Phases">9.10.1. Build Phases</a></li>
+<li><a href="binding.html#sec:Build_Scenarios">9.10.2. Build Scenarios</a></li>
+<li><a href="binding.html#sec:Lazy_linking_problem">9.10.3. Lazy linking problem</a></li>
+</ul>
+</li>
+<li><a href="binding.html#sec:Proxies_and_Proxy_Resolution">9.11. Proxies and Proxy Resolution (Overview)</a>
+<ul class="sectlevel3">
+<li><a href="binding.html#xtexts-lazy-linking-proxies">9.11.1. Xtext’s Lazy Linking Proxies</a></li>
+<li><a href="binding.html#standard-emf-proxies">9.11.2. Standard EMF Proxies</a></li>
+<li><a href="binding.html#_how-is-proxy-resolution-triggered">9.11.3. How is Proxy Resolution Triggered?</a></li>
+<li><a href="binding.html#_when-is-proxy-resolution-allowed">9.11.4. When is Proxy Resolution Allowed?</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="validation.html#_validation">10. Validation</a>
+<ul class="sectlevel2">
+<li><a href="validation.html#sec:validation_overview">10.1. Validation overview</a></li>
+<li><a href="validation.html#sec:validation_control_flow">10.2. Validation control flow</a></li>
+<li><a href="validation.html#sec:validation_issue_ids">10.3. Issue IDs and Messages</a></li>
+<li><a href="validation.html#sec:validation_usage_patterns">10.4. Usage Pattern</a></li>
+<li><a href="validation.html#sec:validation_links">10.5. Links</a></li>
+</ul>
+</li>
+<li><a href="references.html#_references">11. References</a>
+<ul class="sectlevel2">
+<li><a href="references.html#sec:usecases">11.1. Use cases</a></li>
+<li><a href="references.html#sec:calculation_algorithm">11.2. Calculation algorithm</a>
+<ul class="sectlevel3">
+<li><a href="references.html#sec:Xtext_default_implementation">11.2.1. Xtext default implementation</a></li>
+<li><a href="references.html#sec:N4_implementation">11.2.2. N4JS implementation</a></li>
+</ul>
+</li>
+<li><a href="references.html#sec:PerformanceOfDependencyCalculation">11.3. Performance Of Dependency Calculation</a></li>
+<li><a href="references.html#sec:kinds_of_references">11.4. Kinds of references</a>
+<ul class="sectlevel3">
+<li><a href="references.html#sec:Cross_References_to_be_ignored">11.4.1. Cross References to be ignored</a></li>
+<li><a href="references.html#sec:Cross_References_to_be_handled">11.4.2. Cross References to be handled</a></li>
+</ul>
+</li>
+<li><a href="references.html#sec:transitive_dependencies">11.5. Transitive dependencies</a></li>
+<li><a href="references.html#sec:find-references">11.6. Find references</a>
+<ul class="sectlevel3">
+<li><a href="references.html#_background">11.6.1. Background</a></li>
+<li><a href="references.html#_how-find-references-work">11.6.2. How Find References Work</a>
+<ul class="sectlevel4">
+<li><a href="references.html#_step-1-convert-cursor-position-to-declared-element">11.6.2.1. Step 1: Convert Cursor Position to Declared Element</a></li>
+<li><a href="references.html#_step-2-convert-declared-element-to-target-uris">11.6.2.2. Step 2: Convert Declared Element to Target URIs</a></li>
+<li><a href="references.html#_step-3-filter-potential-resources">11.6.2.3. Step 3: Filter Potential Resources</a></li>
+<li><a href="references.html#_step-4-search-references-in-resource">11.6.2.4. Step 4: Search References in Resource</a></li>
+<li><a href="references.html#_limitations-and-possible-enhancements">11.6.2.5. Limitations and Possible Enhancements</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="compilation.html#_compilation">12. Compilation</a>
+<ul class="sectlevel2">
+<li><a href="compilation.html#chap:compilation">12.1. Introduction</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:general_design_rationals">12.1.1. General design rationals</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:logging_and_error_reporting">12.1.1.1. Logging and error reporting</a></li>
+<li><a href="compilation.html#sec:progress_monitor">12.1.1.2. Progress monitor</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Xtext_Integration">12.1.2. Xtext Integration</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:xtext_default_behaviour">12.1.2.1. Xtext default behaviour</a></li>
+<li><a href="compilation.html#sec:n4js_requirements">12.1.2.2. N4JS requirements</a></li>
+<li><a href="compilation.html#sec:compiler_discovery_in_ui">12.1.2.3. Compiler discovery in UI</a></li>
+<li><a href="compilation.html#sec:compiler_discovery_in_headless">12.1.2.4. Compiler discovery in headless</a></li>
+<li><a href="compilation.html#sec:general_generator_implementation">12.1.2.5. General generator implementation</a></li>
+<li><a href="compilation.html#sec:general_generator_activation">12.1.2.6. General generator activation</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Overview_of_Input_Models">12.1.3. Overview of the Input Models</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Core_Generator">12.2. Generators</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:Compiler_Components">12.2.1. Generator Components</a></li>
+<li><a href="compilation.html#sec:Generator_architecture">12.2.2. Generator architecture</a></li>
+<li><a href="compilation.html#sec:Unified_Compiler_Configuration">12.2.3. Unified Compiler Configuration</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Transpilers">12.3. Transpilers</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:Phases">12.3.1. Overview</a></li>
+<li><a href="compilation.html#relation-between-ast-and-im">12.3.2. Relation between AST and IM</a></li>
+<li><a href="compilation.html#implementation-overview">12.3.3. Implementation Overview</a></li>
+<li><a href="compilation.html#sec:Guidelines_for_Implementing_Transformations">12.3.4. Guidelines for Implementing Transformations</a></li>
+<li><a href="compilation.html#symbol-table-in-the-im">12.3.5. Symbol Table in the IM</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:N4JS_to_EcmaScript_Transpiler">12.4. N4JS-to-EcmaScript Transpiler</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:Overview_of_Transformations">12.4.1. Overview of Transformations</a></li>
+<li><a href="compilation.html#sec:Transpiling_members">12.4.2. Transpiling members</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:Transpiling_members__Delegating_members">12.4.2.1. Techniques for special member handling</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__Partial_shadowing_of_getter_setter_pairs">12.4.2.2. Partial shadowing</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__Consuming_or_inheriting_members_of_an_interface">12.4.2.3. Consuming or inheriting members of an interface</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__Static_polyfill">12.4.2.4. Static polyfill</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__API_implementation_stubs">12.4.2.5. API / implementation stubs</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Support_for_incomplete_API_implementation_testing_in_the_N4JS_to_EcmaScript_5_Transpiler">12.4.3. Support for incomplete API implementation testing</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:Modifications_in_Impl_projects">12.4.3.1. Modifications in Impl projects</a></li>
+<li><a href="compilation.html#sec:Implementation_of_stub_generation">12.4.3.2. Implementation of stub-generation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:n4jsc_Headless_Compiler_Interface">12.5. n4jsc Headless Compiler Interface</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:building_the_headless_compiler">12.5.1. building the headless compiler</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="execution.html#_execution">13. Execution</a>
+<ul class="sectlevel2">
+<li><a href="execution.html#sec:N4JS_Project_Execution_And_Linking_Model">13.1. N4JS Project Execution And Linking Model</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#subsec:N4JS_Execution_With_NodeJS">13.1.1. N4JS Execution With NodeJS</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:N4JS_Execution_And_Linking_File">13.2. N4JS Execution And Linking File</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#subsec:NodeJS_Specific_ELF">13.2.1. NodeJS Specific ELF</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Runners-execution">13.3. Runners</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#subsec:N4_Runtime_Environments_Convention">13.3.1. N4 Runtime Environments Convention</a></li>
+<li><a href="execution.html#subsec:Passing_Information_from_IDE_to_Execution_Code_in_Runtime_Environment">13.3.2. Passing Information from IDE to Execution Code in Runtime Environment</a></li>
+<li><a href="execution.html#subsec:Runners_Design">13.3.3. Runners Design</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Legacy_Execution_Engine">13.4. Legacy Execution Engine</a></li>
+<li><a href="execution.html#sec:Design">13.5. Design</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#sec:Usage_Outside_N4JSIDE">13.5.1. Usage Outside N4JSIDE</a>
+<ul class="sectlevel4">
+<li><a href="execution.html#sec:Use_Node_with_Maven">13.5.1.1. Use Node with Maven</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Usage_Inside_N4JSIDE">13.5.2. Usage Inside N4JSIDE</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Runtime_Injection">13.6. Runtime Injection</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#sec:Running_String_Code">13.6.1. Running String Code</a></li>
+<li><a href="execution.html#sec:Running_File_Code">13.6.2. Running File Code</a></li>
+<li><a href="execution.html#sec:Injection_Code_Example">13.6.3. Injection Code Example</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#_tests">14. Tests</a>
+<ul class="sectlevel2">
+<li><a href="tests.html#sec:Performance_Tests">14.1. Performance Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Synthetic_Performance_Tests">14.1.1. Synthetic Performance Tests</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:Design_of_Generator">14.1.1.1. Design of Generator</a></li>
+<li><a href="tests.html#sec:Design_of_Performance_Test_Execution">14.1.1.2. Design of Performance Test Configuration and Execution</a></li>
+<li><a href="tests.html#sec:JUnit_Configuration">14.1.1.3. JUnit Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Test_Configuration">14.1.1.4. JUnitBenchmark Test Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Report_Configuration">14.1.1.5. JUnitBenchmark Report Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Run_Configuration">14.1.1.6. JUnitBenchmark Run Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Example">14.1.1.7. JUnitBenchmark Example</a></li>
+<li><a href="tests.html#sec:Note_on_Jenkins_Job">14.1.1.8. Note on Jenkins Job</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#sec:ECMA_Tests">14.2. ECMA Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Grammar_Tests">14.2.1. Grammar Tests</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:Negative_Tests">14.2.1.1. Negative Tests</a></li>
+<li><a href="tests.html#sec:Test_Exclusion">14.2.1.2. Test Exclusion</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Integration_Tests">14.3. Integration Tests</a></li>
+<li><a href="tests.html#sec:Test_Helpers">14.4. Test Helpers</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Parameterized_N4JS_Tests">14.4.1. Parameterized N4JS tests</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:ParameterizedXtextRunner">14.4.1.1. ParameterizedXtextRunner</a></li>
+<li><a href="tests.html#sec:TestCodeProvider">14.4.1.2. TestCodeProvider</a></li>
+<li><a href="tests.html#sec:Example_Of_Parameterized_Parser_Test">14.4.1.3. Example of parameterized parser test</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Issue_Suppression">14.5. Issue Suppression</a></li>
+<li><a href="tests.html#sec:Xpect_Tests">14.6. Xpect Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Xpect_Test_Setup">14.6.1. Xpect Test Setup</a></li>
+<li><a href="tests.html#sec:Xpect_Issue_Suppression">14.6.2. Xpect Issue Suppression</a></li>
+<li><a href="tests.html#sec:Xpect_Provided_Test_Methods">14.6.3. Xpect Provided Test Methods</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#errors">14.6.3.1. errors</a></li>
+<li><a href="tests.html#warnings">14.6.3.2. warnings</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:N4JS_Specific_Xpect_Test_Methods">14.6.4. N4JS Specific Xpect Test Methods</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:XPECT_noerrors">14.6.4.1. noerrors and nowarnings</a></li>
+<li><a href="tests.html#sec:XPECT_scope">14.6.4.2. scope</a></li>
+<li><a href="tests.html#sec:XPECT_scopeWithPosition">14.6.4.3. scopeWithPosition</a></li>
+<li><a href="tests.html#sec:XPECT_scopeWithResource">14.6.4.4. scopeWithResource</a></li>
+<li><a href="tests.html#sec:XPECT_binding">14.6.4.5. binding</a></li>
+<li><a href="tests.html#sec:XPECT_linkedPathname">14.6.4.6. linkedPathname</a></li>
+<li><a href="tests.html#sec:XPECT_type_of">14.6.4.7. type of</a></li>
+<li><a href="tests.html#sec:XPECT_expectedType">14.6.4.8. expectedType</a></li>
+<li><a href="tests.html#sec:XPECT_elementKeyword">14.6.4.9. elementKeyword</a></li>
+<li><a href="tests.html#sec:XPECT_accessModifier">14.6.4.10. accessModifier</a></li>
+<li><a href="tests.html#sec:XPECT_compileResult">14.6.4.11. compileResult</a></li>
+<li><a href="tests.html#sec:XPECT_output">14.6.4.12. output</a></li>
+<li><a href="tests.html#sec:XPECT_outputRegEx">14.6.4.13. outputRegEx</a></li>
+<li><a href="tests.html#sec:XPECT_calculatedAccessModifier">14.6.4.14. calculatedAccessModifier</a></li>
+<li><a href="tests.html#sec:XPECT_spec">14.6.4.15. spec</a></li>
+<li><a href="tests.html#sec:XPECT_deadCode">14.6.4.16. deadCode</a></li>
+<li><a href="tests.html#sec:XPECT_returnOrThrows">14.6.4.17. returnOrThrows</a></li>
+<li><a href="tests.html#sec:XPECT_lint">14.6.4.18. lint</a></li>
+<li><a href="tests.html#sec:XPECT_lintFails">14.6.4.19. lintFails</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:FIXME_Xpect_modifier">14.6.5. FIXME Xpect modifier</a></li>
+<li><a href="tests.html#sec:Expectmatrix_Xpect_Test_Methods">14.6.6. Expectmatrix Xpect tests</a></li>
+<li><a href="tests.html#xpect-lint-tests">14.6.7. Xpect Lint Tests</a></li>
+</ul>
+</li>
+<li><a href="tests.html#xpect-proposal-tests">14.7. Xpect Proposal Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Validation_vs__Non_Validation">14.7.1. Validation vs. Non-Validation</a></li>
+<li><a href="tests.html#sec:General_Proposal_Test_Features">14.7.2. General Proposal Test Features</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:Test_Variables">14.7.2.1. Test Variables</a></li>
+<li><a href="tests.html#sec:Location_and_Selection">14.7.2.2. at – Location and Selection</a></li>
+<li><a href="tests.html#sec:Multi_Line_Expectations_in_Proposal_Tests">14.7.2.3. Multi Line Expectations in Proposal Tests</a></li>
+<li><a href="tests.html#sec:Timeout">14.7.2.4. Timeout and Performance</a></li>
+</ul>
+</li>
+<li><a href="tests.html#proposals-verify-existence-of-proposals">14.7.3. proposals – Verify Existence of Proposals</a></li>
+<li><a href="tests.html#sec:Verify_displayed_string">14.7.4. display – Verify displayed string</a></li>
+<li><a href="tests.html#sec:Apply_Proposal">14.7.5. apply – Apply Proposal</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#resource-application-in-other-files">14.7.5.1. resource – application in other files</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Content_Assist_Cycling">14.7.6. kind – Content Assist Cycling</a></li>
+<li><a href="tests.html#fileValidVerify-validation-status">14.7.7. fileValid – Verify validation status</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Apply_Proposal_And_Execute_Tests">14.8. Apply Proposal And Execute Tests</a></li>
+<li><a href="tests.html#sec:Organize_Imports_Test">14.9. Organize Imports Test</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#organizeimports">14.9.1. organizeImports</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Access_Control_Test">14.10. Access Control Test</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#test-scenarios">14.10.1. Test Scenarios</a></li>
+<li><a href="tests.html#n4js-code-generator">14.10.2. N4JS Code Generator</a></li>
+<li><a href="tests.html#xtext-issue-matcher">14.10.3. Xtext Issue Matcher</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Smoke_Tests">14.11. Smoke Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#how-to-handle-smoke-test-errors">14.11.1. How to handle smoke test errors?</a></li>
+<li><a href="tests.html#smoketester-and-exceptionanalyzer">14.11.2. SmokeTester and ExceptionAnalyzer</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:UI_Tests_with_SWTBot">14.12. UI Tests with SWTBot</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#writing-swtbot-tests">14.12.1. Writing SWTBot Tests</a></li>
+<li><a href="tests.html#running-swtbot-tests">14.12.2. Running SWTBot Tests</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Debugging_UI_Tests">14.13. Debugging UI Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Connecting_to_the_X_server_on_the_build_node">14.13.1. Connecting to the X-server on the build-node</a></li>
+<li><a href="tests.html#sec:Tools_to_investigate_the_java_stack">14.13.2. Tools to investigate the java-stack</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="ui_concepts.html#_ui-concepts">15. UI Concepts</a>
+<ul class="sectlevel2">
+<li><a href="ui_concepts.html#sec:User_Interface_Concepts">15.1. User Interface Concepts</a>
+<ul class="sectlevel3">
+<li><a href="ui_concepts.html#sec:Eclipse_UI_Concepts">15.1.1. Eclipse UI Concepts</a>
+<ul class="sectlevel4">
+<li><a href="ui_concepts.html#sec:Label_Provider">15.1.1.1. Label Provider</a></li>
+<li><a href="ui_concepts.html#sec:Markers">15.1.1.2. Markers</a></li>
+<li><a href="ui_concepts.html#sec:Commands__Toolbar_and_Menus">15.1.1.3. Commands, Toolbar and Menus</a></li>
+<li><a href="ui_concepts.html#sec:Content_Assist">15.1.1.4. Content Assist</a></li>
+<li><a href="ui_concepts.html#sec:Quick_Fixes">15.1.1.5. Quick Fixes</a></li>
+<li><a href="ui_concepts.html#sec:Quick_Assist">15.1.1.6. Quick Assist</a></li>
+<li><a href="ui_concepts.html#sec:Clean_Up_Actions">15.1.1.7. Clean Up Actions</a></li>
+<li><a href="ui_concepts.html#sec:Save_Actions">15.1.1.8. Save Actions</a></li>
+<li><a href="ui_concepts.html#sec:Auto_Edit">15.1.1.9. Auto Edit</a></li>
+<li><a href="ui_concepts.html#sec:Template_Proposals">15.1.1.10. Template Proposals</a></li>
+<li><a href="ui_concepts.html#sec:Outline_View___Quick_Outline">15.1.1.11. Outline View / Quick Outline</a></li>
+<li><a href="ui_concepts.html#sec:Navigator__Package_Explorer__Project_Explorer">15.1.1.12. Navigator, Package Explorer, Project Explorer</a></li>
+<li><a href="ui_concepts.html#sec:Hyperlinking_and_Navigation">15.1.1.13. Hyperlinking and Navigation</a></li>
+<li><a href="ui_concepts.html#sec:Syntax_and_Semantic_Coloring">15.1.1.14. Syntax and Semantic Coloring</a></li>
+<li><a href="ui_concepts.html#sec:Code_Formatter">15.1.1.15. Code Formatter</a></li>
+<li><a href="ui_concepts.html#sec:Wizards">15.1.1.16. Wizards</a></li>
+<li><a href="ui_concepts.html#sec:Cheat_Sheets">15.1.1.17. Cheat Sheets</a></li>
+<li><a href="ui_concepts.html#sec:Context_sensitive_Help">15.1.1.18. Context-sensitive Help</a></li>
+<li><a href="ui_concepts.html#sec:Hovers">15.1.1.19. Hovers</a></li>
+<li><a href="ui_concepts.html#sec:Folding">15.1.1.20. Folding</a></li>
+<li><a href="ui_concepts.html#sec:Customizable_validation___severity">15.1.1.21. Customizable validation / severity</a></li>
+<li><a href="ui_concepts.html#sec:Proposals">15.1.1.22. Proposals</a></li>
+</ul>
+</li>
+<li><a href="ui_concepts.html#sec:Non_Eclipse_UI_Concepts">15.1.2. Non-Eclipse UI Concepts</a>
+<ul class="sectlevel4">
+<li><a href="ui_concepts.html#sec:Overlays">15.1.2.1. Overlays</a></li>
+<li><a href="ui_concepts.html#sec:Goto__Inferred__Type">15.1.2.2. Goto (Inferred) Type</a></li>
+<li><a href="ui_concepts.html#sec:Postfix_Completion">15.1.2.3. Postfix Completion</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="ui_concepts.html#_user-interface-resources">15.2. User Interface Resources</a>
+<ul class="sectlevel3">
+<li><a href="ui_concepts.html#_icons">15.2.1. Icons</a>
+<ul class="sectlevel4">
+<li><a href="ui_concepts.html#_eclipse-platform-icons">15.2.1.1. Eclipse Platform Icons</a></li>
+<li><a href="ui_concepts.html#_n4js-specific-icons">15.2.1.2. N4JS Specific Icons</a></li>
+<li><a href="ui_concepts.html#_high-resolution-icons">15.2.1.3. High Resolution Icons</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#_formatting">16. Formatting</a>
+<ul class="sectlevel2">
+<li><a href="#sec:FmtObjective">16.1. Objective</a>
+<ul class="sectlevel3">
+<li><a href="#sec:FmtFormatting_Comments">16.1.1. Formatting Comments</a></li>
+</ul>
+</li>
+<li><a href="#sec:FmtArchitecture">16.2. Architecture</a>
+<ul class="sectlevel3">
+<li><a href="#sec:Implementation_example">16.2.1. Implementation example</a></li>
+</ul>
+</li>
+<li><a href="#sec:FmtFormatter_Implementation_Guidelines">16.3. Formatter Implementation Guidelines</a></li>
+<li><a href="#sec:FmtConfiguration">16.4. Configuration</a></li>
+<li><a href="#sec:FmtUI_Integration">16.5. UI Integration</a></li>
+<li><a href="#sec:FmtUnit_Testing_with_Xpect">16.6. Unit Testing with Xpect</a></li>
+</ul>
+</li>
+<li><a href="external_libraries.html#_external-libraries">17. External Libraries</a>
+<ul class="sectlevel2">
+<li><a href="external_libraries.html#sec:Major_Components">17.1. Major Components</a>
+<ul class="sectlevel3">
+<li><a href="external_libraries.html#subsec:External_Resources">17.1.1. External Resources</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Workspace">17.1.2. External Library Workspace</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Preference_Store">17.1.3. External Library Preference Store</a></li>
+<li><a href="external_libraries.html#subsec:npm_Manager">17.1.4. Library Manager</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Builder_Helper">17.1.5. External Library Builder</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Xtext_Index_Persister">17.1.6. External Library Xtext Index Persister</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Preference_Page">17.1.7. External Library Preference Page</a></li>
+</ul>
+</li>
+<li><a href="external_libraries.html#sec:Headless_External_Library_Support">17.2. Headless External Library Support</a>
+<ul class="sectlevel3">
+<li><a href="external_libraries.html#_custom-npm-settings">17.2.1. Custom npm settings</a></li>
+</ul>
+</li>
+<li><a href="external_libraries.html#sec:lmFutureWork">17.3. Future Work</a>
+<ul class="sectlevel3">
+<li><a href="external_libraries.html#subsec:lmMultipleDependencyScope">17.3.1. Multiple Dependency Scope</a></li>
+<li><a href="external_libraries.html#subsec:lmRunTestsFromLibrary">17.3.2. Run Tests from TestLibrary</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="json_support.html#sec:JSON_Support">18. JSON Support</a>
+<ul class="sectlevel2">
+<li><a href="json_support.html#sec:JSON_Parser">18.1. JSON Parser</a>
+<ul class="sectlevel3">
+<li><a href="json_support.html#sec:JSON_Parser_Unicode_Escaping">18.1.1. Escaping Unicode Control Characters in String Literals</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Empty_Text">18.1.2. Empty Text</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Nested_Structures">18.1.3. Nested Structures</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Whitespace">18.1.4. Whitespace</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Comments">18.1.5. Comments</a></li>
+</ul>
+</li>
+<li><a href="json_support.html#sec:JSON_Language_Extensions">18.2. JSON Language Extensions</a>
+<ul class="sectlevel3">
+<li><a href="json_support.html#sec:JSON_Validator_Extensions">18.2.1. JSON Validator Extensions</a>
+<ul class="sectlevel4">
+<li><a href="json_support.html#sec:File_Specitic_Validator_Extensions">18.2.1.1. File-Specific Validator Extensions</a></li>
+<li><a href="json_support.html#sec:JSON_Declarative_JSON_Validator_Extensions">18.2.1.2. Declarative JSON Validator Extensions</a></li>
+</ul>
+</li>
+<li><a href="json_support.html#_json-resource-description-strategy">18.2.2. JSON Resource Description Strategy</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_jsdoc">19. JSDoc</a>
+<ul class="sectlevel2">
+<li><a href="jsdoc.html#sec:Design_Rationale">19.1. Design Rationale</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#_general-design">19.1.1. General Design</a></li>
+<li><a href="jsdoc.html#sec:Type_Expressions">19.1.2. Type Expressions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="docexporter.html#_docexporter">20. DocExporter</a>
+<ul class="sectlevel2">
+<li><a href="docexporter.html#sec:Specification_Exporter">20.1. Specification Exporter</a></li>
+</ul>
+</li>
+<li><a href="rename_refactoring.html#_rename-refactoring">21. Rename Refactoring</a>
+<ul class="sectlevel2">
+<li><a href="rename_refactoring.html#_rename-refactoring-ui-interaction">21.1. Rename Refactoring UI interaction</a></li>
+<li><a href="rename_refactoring.html#_renameelementprocessor-interaction">21.2. RenameElementProcessor interaction</a></li>
+</ul>
+</li>
+<li><a href="flow_graphs.html#chap:flowgraphs">22. Flow Graphs</a>
+<ul class="sectlevel2">
+<li><a href="flow_graphs.html#sec:flowgraphs_overview">22.1. Flow graphs overview</a>
+<ul class="sectlevel3">
+<li><a href="flow_graphs.html#_internal-graph">22.1.1. Internal graph</a></li>
+<li><a href="flow_graphs.html#_optimizations">22.1.2. Optimizations</a></li>
+<li><a href="flow_graphs.html#_api-for-client-analyses">22.1.3. API for client analyses</a>
+<ul class="sectlevel4">
+<li><a href="flow_graphs.html#_mapping-from-internal-to-ast-elements">22.1.3.1. Mapping from internal to AST elements</a></li>
+<li><a href="flow_graphs.html#_graph-visitor">22.1.3.2. Graph visitor</a></li>
+<li><a href="flow_graphs.html#_graph-explorer">22.1.3.3. Graph explorer</a></li>
+<li><a href="flow_graphs.html#_branch-walker">22.1.3.4. Branch walker</a></li>
+<li><a href="flow_graphs.html#_example-1-compute-string-for-each-path">22.1.3.5. Example 1: Compute string for each path</a></li>
+<li><a href="flow_graphs.html#_path-quantor">22.1.3.6. Path quantor</a></li>
+</ul>
+</li>
+<li><a href="flow_graphs.html#_control-flow-analyses">22.1.4. Control flow analyses</a>
+<ul class="sectlevel4">
+<li><a href="flow_graphs.html#_dead-code-analysis">22.1.4.1. Dead code analysis</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="flow_graphs.html#sec:dataflow">22.2. Dataflow</a>
+<ul class="sectlevel3">
+<li><a href="flow_graphs.html#_dataflow-graph">22.2.1. Dataflow graph</a></li>
+<li><a href="flow_graphs.html#_dataflow-analyses">22.2.2. Dataflow analyses</a>
+<ul class="sectlevel4">
+<li><a href="flow_graphs.html#_def-def-def-nothing-analysis">22.2.2.1. Def&#8594;Def / Def&#8594;Nothing analysis</a></li>
+<li><a href="flow_graphs.html#_def-use-decl-analysis">22.2.2.2. Def|Use&#8592;Decl analysis</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="publish_npms.html#sec:publish-npms-to-public">23. Publish npms</a>
+<ul class="sectlevel2">
+<li><a href="publish_npms.html#sec:publish-npms-n4js-maven">23.1. Publish n4js-libs to during  maven build</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Hints">Appendix A: Hints</a>
+<ul class="sectlevel2">
+<li><a href="appendix_a_hints.html#sec:XtextInjection">A.1. Xtext Injection</a>
+<ul class="sectlevel3">
+<li><a href="appendix_a_hints.html#sec:DI_MultipleInjectors_Singletons">A.1.1. Multiple Injectors and Singletons</a>
+<ul class="sectlevel4">
+<li><a href="appendix_a_hints.html#sec:DI_avoid_duplicate_singletons">A.1.1.1. Avoiding duplicate singletons</a>
+<ul class="sectlevel5">
+<li><a href="appendix_a_hints.html#sec:DI_binding_in_shared">A.1.1.1.1. Defining binding in the shared injector</a></li>
+<li><a href="appendix_a_hints.html#sec:DI_binding_in_custom">A.1.1.1.2. Defining binding in the custom injector</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:DI_Hints">A.1.2. Dependency Injection Hints</a>
+<ul class="sectlevel4">
+<li><a href="appendix_a_hints.html#sec:DI_custom_bundle">A.1.2.1. Use DI in custom bundle, use DI with extensions</a>
+<ul class="sectlevel5">
+<li><a href="appendix_a_hints.html#sec:DI_custom_bundle_problem">A.1.2.1.1. Problem</a></li>
+<li><a href="appendix_a_hints.html#sec:DI_custom_bundle_solution">A.1.2.1.2. Solution</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Access_Other_DSL_Injector">A.1.2.2. How do I get the Guice Injector of my language?</a>
+<ul class="sectlevel5">
+<li><a href="appendix_a_hints.html#sec:DSL_Injector_UI_context">A.1.2.2.1. UI context</a></li>
+<li><a href="appendix_a_hints.html#sec:DSL_Injector_Non_UI_context">A.1.2.2.2. Non UI context but with injection context</a></li>
+<li><a href="appendix_a_hints.html#sec:DSL_Injector_Non_UI_non_injection_context">A.1.2.2.3. Non UI context without injection context</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Cancel_Indicator">A.1.2.3. How do I get cancel indicators in different contexts?</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Eclipse">A.2. Eclipse</a>
+<ul class="sectlevel3">
+<li><a href="appendix_a_hints.html#sec:Show_Xtext_Index">A.2.1. Show the current Xtext index</a></li>
+<li><a href="appendix_a_hints.html#sec:Plugin_spy">A.2.2. Plug-in spy</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Maven-hints">A.3. Maven</a>
+<ul class="sectlevel3">
+<li><a href="appendix_a_hints.html#how-to-check-for-maven-mojo-updates">A.3.1. How to check for Maven MOJO updates</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#_module-loading">Appendix B: Module Loading</a>
+<ul class="sectlevel2">
+<li><a href="appendix_b_module_loading.html#sec:Dependency_Management">B.1. Dependency Management</a></li>
+<li><a href="appendix_b_module_loading.html#ecmascript-modules">B.2. ECMAScript Modules</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:ES5_Modules_Systems">B.2.1. ES5 Modules Systems</a></li>
+<li><a href="appendix_b_module_loading.html#sec:ES6_Modules">B.2.2. ES6 Modules</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:ECMAScript_Module_Loaders">B.3. ECMAScript Module Loaders</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:ES6_Module_Loaders">B.3.1. ES6 Module Loaders</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Polyfills_for_ES6_Module_Loaders">B.3.2. Polyfills for ES6 Module Loaders</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:es6_module_loader">B.3.2.1. es6-module-loader</a></li>
+<li><a href="appendix_b_module_loading.html#sec:SystemJS">B.3.2.2. SystemJS</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Demo">B.3.2.3. Demo</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#case-study-typescript">B.4. Case Study : TypeScript</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:ES6_Modules_Support">B.4.1. ES6 Modules Support</a></li>
+<li><a href="appendix_b_module_loading.html#sec:TypeScript_and_Module_Loading">B.4.2. TypeScript and Module Loading</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Cyclic_Dependencies">B.5. Cyclic Dependencies</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:Setup">B.5.1. Setup</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Transpile_and_Execute">B.5.2. Transpile and Execute</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Module_Format___AMD">B.5.2.1. Module Format = AMD</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Module_Format___CommonJS">B.5.2.2. Module Format = CommonJS</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Module_Format___SystemJS">B.5.2.3. Module Format = SystemJS</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Conclusion">B.5.3. Conclusion</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#system.register-as-transpilation-target">B.6. System.register as transpilation target</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:Introduction">B.6.1. Introduction</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:External_Transpilers">B.6.1.1. External Transpilers</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Example_of_a_System_register_module">B.6.1.2. Example of a System.register module</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Structure_of_a_System_register_module">B.6.2. Structure of a System.register module</a></li>
+<li><a href="appendix_b_module_loading.html#_transpilation-hints">B.6.3. Transpilation Hints</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Handling_Imports">B.6.3.1. Handling Imports</a></li>
+<li><a href="appendix_b_module_loading.html#sec:__exportFn__">B.6.3.2. &lt;&lt;exportFn&gt;&gt;</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Handling_Exports">B.6.3.3. Handling Exports</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Examples_w__Circular_Dependencies">B.6.4. Examples w/ Circular Dependencies</a></li>
+<li><a href="appendix_b_module_loading.html#sec:N4JS_Examples_w__Circular_Dependencies">B.6.5. N4JS Examples w/ Circular Dependencies</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Unresolved_Cyclic_Dependencies">B.6.5.1. Unresolved Cyclic Dependencies</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Variables___Functions">B.6.5.2. Examples with Variables &amp; Functions</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Classes">B.6.5.3. Examples with Classes</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Examples_with_SubClassing">B.6.5.4. Examples with SubClassing</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Miscellaneous">B.6.5.5. Miscellaneous</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#_resources">B.6.6. Resources</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:CommonJS_as_transpilation_target">B.7. CommonJS as transpilation target</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#_introduction-2">B.7.1. Introduction</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Transpilation_Hints">B.7.2. Transpilation Hints</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Import_Statements">B.7.2.1. Import Statements</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Export_Statements">B.7.2.2. Export Statements</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Tracking_Live_Bindings">B.7.2.3. Tracking Live Bindings</a></li>
+<li><a href="appendix_b_module_loading.html#sec:A_complete_example">B.7.2.4. A complete example</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#_resources-2">B.7.3. Resources</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_c_license.html#sec:License">Appendix C: License</a></li>
+<li><a href="appendix_d_acronyms.html#sec:Acronyms">Appendix D: Acronyms</a></li>
+<li><a href="appendix_e_bibliography_and_footnotes.html#_bibliography-and-footnotes">Appendix E: Bibliography and Footnotes</a></li>
+</ul>
+</div>
+</div>
+<div id="content"><div class="sect1">
+<h2 id="_formatting"><a class="anchor" href="#_formatting"></a><a class="link" href="#_formatting">16. Formatting</a></h2>
+<div class="sectionbody">
+<div class="admonitionblock warning">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-warning" title=""></i>
+</td>
+<td class="content">
+This chapter may be outdated.
+</td>
+</tr>
+</table>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:FmtObjective"><a class="anchor" href="#sec:FmtObjective"></a><a class="link" href="#sec:FmtObjective">16.1. Objective</a></h3>
+<div class="paragraph">
+<p>Writing textual code has many degrees of freedom. The resulting layout differs between authors. Carefully placing whitespace and newlines can increase the readability. Some handling of whitespace can be automated. This chapter describes the techniques used to automate the formatting to some degree.</p>
+</div>
+<div class="paragraph">
+<p>Formatting N4js source code ensures a consistent style. It takes care of:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>surrounding language constructs with white space to improve readability</p>
+</li>
+<li>
+<p>indenting logically grouped elements</p>
+</li>
+<li>
+<p>wrapping long lines of code and comments</p>
+</li>
+<li>
+<p>inserting semicolons, which would otherwise be automatically inserted (ASI)</p>
+</li>
+<li>
+<p>formatting documentation</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Formatting will never alter the semantics of the code and it will not reorganize it.</p>
+</div>
+<div class="sect3">
+<h4 id="sec:FmtFormatting_Comments"><a class="anchor" href="#sec:FmtFormatting_Comments"></a><a class="link" href="#sec:FmtFormatting_Comments">16.1.1. Formatting Comments</a></h4>
+<div class="paragraph">
+<p>N4js distinguishes five different types of comments <em>single line comments</em>, <em>not-indented single line comments</em>, <em>multiline comments</em>, <em>fixed multiline comments</em> and <em>Jsdoc style multiline comments.</em></p>
+</div>
+<div class="paragraph">
+<p>Single line comments start with <code>//</code>  and include all characters until the end of line. They usually will be indented and wrapped if they exceed the maximum line length unless they start immediately at the first column. Single line comments starting at position 0 are called <em>not-indented single line comments</em>.</p>
+</div>
+<div class="paragraph">
+<p>Multiline comments start with <code>/*</code>  and span all character including line breaks up the the end given by <code>*/</code> . The three variants are distinguished by the third and fourth character:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Comments starting with <code>/*-</code>  are always fixed multiline comments.</p>
+</li>
+<li>
+<p>Comments starting with <code>/**</code>  and following any other character but <code>*</code>  are Jsdoc style multiline comments. (E.g. <code>/**+</code>  start Jsdoc but <code>/***</code>  does not.)</p>
+</li>
+<li>
+<p>All others starting with <code>/*</code>  are ordinary multiline comments.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p><em>Not-indented single line comments</em> and <em>fixed multiline comments</em> will always remain as they are. Usually they are used to comment out code sections.</p>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:FmtArchitecture"><a class="anchor" href="#sec:FmtArchitecture"></a><a class="link" href="#sec:FmtArchitecture">16.2. Architecture</a></h3>
+<div class="paragraph">
+<p>Formatting mainly takes place in polymorphic dispatch methods <code>format</code> in class <code>N4JSFormatter</code>. Some language features are formatted with an entry-point using a super-class. This is mainly the case for structures that are sufficiently similar. E.g. <code>format( FunctionOrFieldAccessor )</code> is responsible for getter, setter, methods, functions, ….</p>
+</div>
+<div class="paragraph">
+<p>Some common source-code formattings are grouped by <code>configureXY()</code> methods. They get called from the <code>format</code> methods for similar code structures, c.f. <code>configureAnnotations</code></p>
+</div>
+<div class="paragraph">
+<p>Since we do not support formatting of the TypeExpression-language stand-alone, this class provides only one format-method throwing an <code>UnsupportedOperationException</code> type expressions formatting is defined in class <code>N4JSFormatter</code> at the end of the file.</p>
+</div>
+<div id="fig:formatter_overview" class="imageblock center">
+<div class="content">
+<img src="chapters/17_formatting/images/FormatterArchitecture.svg" alt="FormatterArchitecture">
+</div>
+<div class="title">Figure 47. Overview of classes used for formatting</div>
+</div>
+<div class="paragraph">
+<p>The first entry-point for a script is <code>N4JSFormatter.format(Script, IFormattableDocument)</code>. Within this method an instance of <code>N4JSGenericFormatter</code> is created and used to configure general aspects of automatic-semicolon insertion (put a ’<code>;</code>’ where ASI took place in the parser) and handling of colons (’<code>:</code>’).</p>
+</div>
+<div class="sect3">
+<h4 id="sec:Implementation_example"><a class="anchor" href="#sec:Implementation_example"></a><a class="link" href="#sec:Implementation_example">16.2.1. Implementation example</a></h4>
+<div class="paragraph">
+<p>Considering the following N4js-snippet where the return value of a function call will be casted to some type.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>functionCall("a","b") as MyType&lt;string&gt;</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>The whole line is a CastExpression comprising of an expression (<code>functionCall(a,b)</code>) and a type reference (<code>MyType&lt;string&gt;</code>).</p>
+</div>
+<div class="paragraph">
+<p>The <code>format</code>-dispatch method written in Xtend would look like:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>    def dispatch void format(CastExpression expr, extension IFormattableDocument document) {
+        expr.regionFor.keyword("as").prepend[newLines = 0; oneSpace].append[newLines = 0; oneSpace];
+        expr.expression.format;
+        expr.targetTypeRef.format;
+    }</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>In line 2 the format around the keyword <code>as</code> is specified where in line 3 and 4 the formatting of the containing elements will be dispatched.</p>
+</div>
+<div class="paragraph">
+<p>Note that <code>regionFor</code> in line 2 is a method declared in <code>IFormattableDocument</code> and used via the extension-parameter <code>document</code>. It returns an object of type <code>ISemanticRegionFinder</code>. Invoking the <code>keyword</code> method on this object returns an instance of <code>ISemanticRegion</code> which will be passed to the extension methods <code>prepend</code> and <code>append</code> following the builder pattern. Both <code>prepend</code> and <code>append</code> take a lambda expression operating on a single parameter of type <code>IHiddenRegionFormatter</code>. Inside the lambda-expression this parameter is implicitly used to invoke the methods <code>setNewLines(0)</code> and <code>oneSpace()</code>. These calls simply disallow line-breaks around as and force the whitespace to be just a single character.</p>
+</div>
+<div class="paragraph">
+<p>Possible other formatting instructions can be found in <code>IHiddenRegionFormatter</code>.</p>
+</div>
+<div class="paragraph">
+<p>Due to some bugs in auto-wrapping<sup class="footnote">[<a id="_footnoteref_16" class="footnote" href="appendix_e_bibliography_and_footnotes.html#_footnote_16" title="View footnote.">16</a>]</sup> unsuccessful attempts to wrap a line can insert unexpected new-lines in regions several lines in front of the currently treated source-line.</p>
+</div>
+<div class="paragraph">
+<p>Debugging the formatter can be cumbersome as, due to GH-12<sup class="footnote">[<a id="_footnoteref_17" class="footnote" href="appendix_e_bibliography_and_footnotes.html#_footnote_17" title="View footnote.">17</a>]</sup>, the <code>toString()</code> methods if internal data-structures throw exceptions.</p>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="sec:FmtFormatter_Implementation_Guidelines"><a class="anchor" href="#sec:FmtFormatter_Implementation_Guidelines"></a><a class="link" href="#sec:FmtFormatter_Implementation_Guidelines">16.3. Formatter Implementation Guidelines</a></h3>
+<div class="ulist">
+<ul>
+<li>
+<p>Each formatted element should only format it’s inner content. This avoids conflicting situations.</p>
+</li>
+<li>
+<p>For each region possibly containing whitespace must be formatted.</p>
+</li>
+<li>
+<p>Use priorities for conflict-resolutions sparse. For contradicting informations in the same region, the higher priority wins. If both information have the same priority, then an Exception will be thrown, showing two stack-traces to indicate the two code-regions being responsible for the situation.</p>
+</li>
+<li>
+<p>For auto-wrapping a callback can be registered. In case of wrapping you can then conditionally change the format. Registering a callback implicitly sets the auto-wrap flag for the region.</p>
+</li>
+<li>
+<p>Cover formatting with at least two different unit-tests. One having as little white-space as possible (all in one line) and the other as much white-space as possible in order to identify unformatted regions.</p>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect2">
+<h3 id="sec:FmtConfiguration"><a class="anchor" href="#sec:FmtConfiguration"></a><a class="link" href="#sec:FmtConfiguration">16.4. Configuration</a></h3>
+<div class="paragraph">
+<p>Some formattings can be customised through preference key-value pairs. Class <code>N4JSFormatterPreferenceKeys</code> acts as the entry-point to define such key-(default-)value pairs. Some preferences are inherited and are based on values stored in the default preference store (Line length, default tab width, …).</p>
+</div>
+<div class="paragraph">
+<p>Currently the preferences are not yet accessible by the end-user.</p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="sec:FmtUI_Integration"><a class="anchor" href="#sec:FmtUI_Integration"></a><a class="link" href="#sec:FmtUI_Integration">16.5. UI Integration</a></h3>
+<div class="paragraph">
+<p>Code formatting is invoked with standard key-strokes ( <kbd>CMD</kbd>+<kbd>Shift</kbd>+<kbd>F</kbd> on Mac, <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>F</kbd> on Windows)</p>
+</div>
+<div class="paragraph">
+<p>There is no UI for preferences values yet.</p>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:FmtUnit_Testing_with_Xpect"><a class="anchor" href="#sec:FmtUnit_Testing_with_Xpect"></a><a class="link" href="#sec:FmtUnit_Testing_with_Xpect">16.6. Unit Testing with Xpect</a></h3>
+<div class="paragraph">
+<p>With Xpect Method <code>formattedLines</code> implemented in class <code>org.eclipse.n4js.xpect.FormatterXpectMethod</code> in bundle <code>org.eclipse.n4js.tests.helper</code> the formatting can be tested. The test method requires the number of lines which should be formatted. The desired test is given as a standard multiline expectation.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>/* XPECT formattedLines 1 ---
+var a, b, c, d, e;
+--- */
+var a,b,c,d,e;</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Preferences can be configured in the Xpect setup section by providing string values. Numbers and booleans are converted automatically by the preferences framework.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>/* XPECT_SETUP org.eclipse.n4js.tests.N4JSXpectTest
+    ResourceSet {
+        ThisFile {}
+        File "wishesImported.n4js" {  }
+    }
+    Preference "indentation" "    " {}
+    Preference "line.width.max" "100" {}
+    Preference "format.auto_wrap_in_front_of_logical_operator" "false" {}
+
+   END_SETUP
+ */</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Tip: Full coverage of the formatting can be tested via authoring the input using spaces as indentation characters if the formatter would use tabs or vice versa. That way untouched lines are distinguishable during the test-runs</p>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div id="footer">
+<div id="footer-text">
+Version 0.9<br>
+Last updated 2019-08-07 15:02:40 CEST
+</div>
+</div>
+<!-- ************* docinfo-footer *************************************************************** -->
+<div class="Grid social" style="color:#d5dfea">
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <h2>Quick Links</h2>
+    <ul>
+      <li><a href="../downloads.html">Download</a></li>
+      <li><a href="../userguides/index.html">Documentation</a></li>
+      <li><a href="https://github.com/eclipse/n4js/">Source</a></li>
+      <li><a href="https://github.com/eclipse/n4js/issues">Issues</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="https://www.eclipse.org/forums/index.php/f/365/">Forum</a></li>
+      <li><a href="http://n4js.blogspot.de/">Blog</a></li>
+      <li><a href="https://dev.eclipse.org/mailman/listinfo/n4js-dev">Mailing List</a></li>
+      <li><a href="https://projects.eclipse.org/projects/technology.n4js">Eclipse Project Page</a></li>
+      <li><a href="https://twitter.com/n4jsdev">Tweets by n4jsdev</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="http://www.eclipse.org/">Eclipse Home</a></li>
+      <li><a href="http://www.eclipse.org/legal/privacy.php">Privacy Policy</a></li>
+      <li><a href="http://www.eclipse.org/legal/termsofuse.php">Terms of Use</a></li>
+      <li><a href="http://www.eclipse.org/legal/copyright.php">Copyright Agent</a></li>
+      <li><a href="http://www.eclipse.org/legal/">Legal</a></li>
+    </ul>
+  </div>
+  <div style="clear: both; height: 0; overflow: hidden;"></div>
+</div>
+
+<!-- ************* UI Scripts ************* -->
+<script type="text/javascript" src="scripts/back-to-top.js"></script>
+
+<script type="text/javascript" src="scripts/treeview.js"></script>
+<script type="text/javascript" src="scripts/toc.js"></script>
+
+<!-- ************* Prism.js Syntax Highlighting ************* -->
+<script src="scripts/prism.js"></script>
+
+<script type="text/javascript">
+	// Add the 'toclist' id for search function
+	$(".toc2 > ul").attr('id', 'toclist');
+	// Generate a Search input form
+	$("#toclist > li:first-of-type").before('<input type="text" id="pagesearch" onkeyup="search()" placeholder="Search for section...">');
+	$("#toclist > li:first-of-type").before('<i id="clear" class="fa fa-times-circle-o"></i>');
+	$("#clear").click(function(){
+	    $("#pagesearch").val('');
+	    search();
+	    $('.toc2 > ul').treeView('collapseAll');
+	});
+	// intialize Treeview.js
+	$(".toc2 > ul").treeView();
+	// Initialize Scrollspy
+</script>
+<!-- ************* docinfo-footer *************************************************************** -->
+</body>
+</html>
\ No newline at end of file
diff --git a/design/images/arrow-down.png b/design/images/arrow-down.png
new file mode 100644
index 0000000..bd60af3
--- /dev/null
+++ b/design/images/arrow-down.png
Binary files differ
diff --git a/design/images/arrow-right.png b/design/images/arrow-right.png
new file mode 100644
index 0000000..220a9b9
--- /dev/null
+++ b/design/images/arrow-right.png
Binary files differ
diff --git a/design/images/collapse.png b/design/images/collapse.png
new file mode 100644
index 0000000..fe71915
--- /dev/null
+++ b/design/images/collapse.png
Binary files differ
diff --git a/design/images/cover.png b/design/images/cover.png
new file mode 100644
index 0000000..3999673
--- /dev/null
+++ b/design/images/cover.png
Binary files differ
diff --git a/design/images/expand.png b/design/images/expand.png
new file mode 100644
index 0000000..169e56e
--- /dev/null
+++ b/design/images/expand.png
Binary files differ
diff --git a/design/images/favicon-16x16.png b/design/images/favicon-16x16.png
new file mode 100644
index 0000000..d0078b3
--- /dev/null
+++ b/design/images/favicon-16x16.png
Binary files differ
diff --git a/design/images/favicon-32x32.png b/design/images/favicon-32x32.png
new file mode 100644
index 0000000..1149301
--- /dev/null
+++ b/design/images/favicon-32x32.png
Binary files differ
diff --git a/design/images/favicon.ico b/design/images/favicon.ico
new file mode 100644
index 0000000..13e30de
--- /dev/null
+++ b/design/images/favicon.ico
Binary files differ
diff --git a/design/images/issue.svg b/design/images/issue.svg
new file mode 100644
index 0000000..f1651d2
--- /dev/null
+++ b/design/images/issue.svg
@@ -0,0 +1,29 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:xl="http://www.w3.org/1999/xlink" version="1.1" xmlns="http://www.w3.org/2000/svg" viewBox="342 217 26 27" width="26" height="27">
+  <defs>
+    <font-face font-family="Helvetica Neue" font-size="21" panose-1="2 0 8 3 0 0 0 9 0 4" units-per-em="1000" underline-position="-100" underline-thickness="50" slope="0" x-height="517" cap-height="714" ascent="975.0061" descent="-216.99524" font-weight="700">
+      <font-face-src>
+        <font-face-name name="HelveticaNeue-Bold"/>
+      </font-face-src>
+    </font-face>
+  </defs>
+  <metadata> Produced by OmniGraffle 7.8.2 
+    <dc:date>2018-11-22 16:16:36 +0000</dc:date>
+  </metadata>
+  <g id="Canvas_1" fill-opacity="1" stroke-dasharray="none" stroke="none" stroke-opacity="1" fill="none">
+    <title>Canvas 1</title>
+    <g id="Canvas_1: Layer 1">
+      <title>Layer 1</title>
+      <g id="Graphic_4">
+        <circle cx="354.8125" cy="230.25" r="11.2500179763964" fill="white"/>
+        <circle cx="354.8125" cy="230.25" r="11.2500179763964" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="2"/>
+      </g>
+      <g id="Graphic_2">
+        <text transform="translate(351.8125 217.44543)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="21" font-weight="700" fill="black" x=".081" y="20">!</tspan>
+        </text>
+      </g>
+    </g>
+  </g>
+</svg>
diff --git a/design/images/n4js-logo.png b/design/images/n4js-logo.png
new file mode 100644
index 0000000..e0b8340
--- /dev/null
+++ b/design/images/n4js-logo.png
Binary files differ
diff --git a/design/images/n4jslogo.png b/design/images/n4jslogo.png
new file mode 100644
index 0000000..a8e2982
--- /dev/null
+++ b/design/images/n4jslogo.png
Binary files differ
diff --git a/design/images/n4jslogo.svg b/design/images/n4jslogo.svg
new file mode 100644
index 0000000..9f6f27f
--- /dev/null
+++ b/design/images/n4jslogo.svg
@@ -0,0 +1,30 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN"
+"http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+
+
+<!-- Page 1 -->
+<svg x="0" y="0" width="1527" height="1459" viewBox="0 0 1527 1459" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink"
+style="display: block;margin-left: auto;margin-right: auto;">
+<defs>
+<clipPath id="c0_1"><path d="M848.7,1459c-31.1,0,-48.1,-19.3,-48.1,-54.6c0,-2.7,0.6,-3.5,2.4,-3.5l26.6,0c2.1,0,2.9,1.1,2.9,3.7l0,3.5c0,14.3,5.8,22,16.7,22c5.6,0,10.3,-2.4,12.2,-6.6c2.4,-4.3,2.6,-7.2,2.6,-19.9L864,1298l-36.8,0c-4.5,0,-5.4,-0.8,-5.4,-5.6l0,-14.3c0,-4.8,0.9,-5.6,5.4,-5.6l66.9,0c4.7,0,5.5,0.8,5.5,5.6l0,120.4c0,23.4,-3.4,35.9,-12.2,45.7c-8.7,9.8,-22,14.8,-38.7,14.8Zm-367.9,-4.5c-5.1,0,-5.6,-0.5,-5.6,-5.6l0,-14.3c0,-4.8,0.8,-5.6,5.6,-5.6l13.5,0l0,-131l-13.5,0c-4.8,0,-5.6,-0.8,-5.6,-5.6l0,-14.3c0,-4.8,0.5,-5.6,5.6,-5.6l40.9,0c3.7,0,4.2,0.3,6.1,3.7l44,82.3c5.9,10.9,13.3,28.1,16.5,38.4c-0.8,-19.6,-0.8,-25.2,-0.8,-34.5l0,-64.4l-13.5,0c-4.8,0,-5.6,-0.8,-5.6,-5.6l0,-14.3c0,-4.8,0.8,-5.6,5.6,-5.6l57.3,0c5,0,5.6,0.8,5.6,5.6l0,14.3c0,4.8,-0.8,5.6,-5.6,5.6l-13.5,0l0,150.9c0,4.8,-0.8,5.6,-5.6,5.6l-17.5,0c-3.7,0,-4.3,-0.2,-6.1,-3.7l-48.9,-90.7c-8,-14.9,-11.4,-22.1,-16.2,-36.1c1.1,21.2,1.1,21.2,1.1,34.2l0,70.8l13.5,0c4.8,0,5.6,0.8,5.6,5.6l0,14.3c0,4.8,-0.8,5.6,-5.6,5.6Zm242.9,1.5c-5,0,-5.6,-0.5,-5.6,-5.3l0,-34.5l-65,0c-5,0,-5.6,-0.5,-5.6,-5.3l0,-27.9l66.1,-110.3c1.6,-2.7,2.4,-3.5,3.5,-3.5c0.8,0,1.9,0.3,3.7,1.1l16,6.6c2.9,1.3,3.9,2.1,3.9,3.7c0,0.8,-0.5,2.1,-1.6,3.7l-61.8,105.1l41.4,0l3.4,-42.7c0.3,-4.5,1.1,-5.1,5.6,-5.1l18.1,0c5,0,5.6,0.6,5.6,5.6l0,43l15.1,0c5,0,5.6,0.5,5.6,6.4l0,14.3c0,4.5,-0.9,5.3,-5.6,5.3l-15.1,0l0,34.5c0,4.8,-0.6,5.3,-5.6,5.3Zm266,2.2c-16.7,0,-39.6,-4.7,-50.7,-10.6c-3.2,-1.6,-4,-3.2,-4,-6.6l0,-40.1c0,-3.7,0.8,-4.5,4.5,-4.5l19.7,0c3.7,0,4.5,0.8,4.5,4.5l0,22.3c10.3,3.7,17.2,5.3,24.9,5.3c15.4,0,24.2,-8.2,24.2,-22.5c0,-6.4,-2.1,-12,-5.9,-15.7c-4.7,-4.8,-6.6,-5.8,-30.8,-17.2c-15.9,-7.7,-24.1,-12.8,-29.4,-18.3c-7.5,-7.7,-11.4,-19.2,-11.4,-32.7c0,-32.9,22.3,-53.3,58.1,-53.3c15.4,0,32.9,4.2,43.8,10.3c3.2,1.9,4,3.2,4,6.4l0,36.1c0,3.7,-0.8,4.5,-4.5,4.5l-19.7,0c-3.7,0,-4.5,-0.8,-4.5,-4.5l0,-20.7c-7.7,-2.4,-11.9,-3.2,-17.8,-3.2c-15.6,0,-24.9,7.4,-24.9,19.9c0,9.8,4.5,14.3,23.6,23.9c25.5,12.7,32.1,17,39,24.4c9.6,10.6,14.4,22.8,14.4,37.1c0,32.7,-23.1,55.2,-57.1,55.2ZM494.4,821.7c-13.5,0,-24.5,-10.9,-24.5,-24.4c0,-13.5,11,-24.4,24.5,-24.4l508,0c13.5,0,24.5,10.9,24.5,24.4c0,13.5,-11,24.4,-24.5,24.4ZM362,837.7c-11.6,0,-22.8,-5.8,-29.3,-16.3c-10,-16.2,-4.9,-37.3,11.2,-47.3c5.6,-3.4,11.9,-5.1,18,-5.1c11.6,0,22.8,5.8,29.3,16.4c10,16.1,4.9,37.3,-11.2,47.2c-5.7,3.5,-11.9,5.1,-18,5.1ZM494.4,662.9c-13.5,0,-24.5,-11,-24.5,-24.5c0,-13.5,11,-24.4,24.5,-24.4l631.9,0c13.5,0,24.4,10.9,24.4,24.4c0,13.5,-10.9,24.5,-24.4,24.5ZM492.4,504C478.9,504,468,493.1,468,479.6c0,-13.5,10.9,-24.5,24.4,-24.5l598.4,0c13.5,0,24.4,11,24.4,24.5c0,13.5,-10.9,24.4,-24.4,24.4Zm2,-158.8c-13.5,0,-24.5,-11,-24.5,-24.5c0,-13.5,11,-24.4,24.5,-24.4l422.3,0c13.5,0,24.4,10.9,24.4,24.4c0,13.5,-10.9,24.5,-24.4,24.5Zm941.7,751.5c23.6,0,42.8,-19.1,42.8,-42.7l0,-962.4c0,-23.6,-19.2,-42.7,-42.8,-42.7L91.7,48.9C68.1,48.9,48.9,68,48.9,91.6l0,962.4c0,23.6,19.1,42.7,42.8,42.7ZM91.7,1145.6C41,1145.6,0,1104.6,0,1054L0,91.6C0,41,41.1,0,91.7,0L1436.1,0c50.6,0,91.7,41,91.7,91.6l0,962.4c0,50.6,-41.1,91.6,-91.7,91.6Z" /></clipPath>
+
+<style type="text/css"><![CDATA[
+
+.g1_1{
+}
+
+
+]]></style>
+
+</defs>
+<path d="M0,0
+L0,1459
+L1527,1459
+L1527,0 Z " 
+fill="#FFFFFF" stroke="none" />
+<g clip-path="url(#c0_1)">
+<path d="M-7,-7l1542,0l0,1473L-7,1466Z" class="g1_1" />
+</g>
+
+</svg>
diff --git a/design/images/searchicon.png b/design/images/searchicon.png
new file mode 100644
index 0000000..71f06af
--- /dev/null
+++ b/design/images/searchicon.png
Binary files differ
diff --git a/design/images/up-arrow.png b/design/images/up-arrow.png
new file mode 100644
index 0000000..1ff179f
--- /dev/null
+++ b/design/images/up-arrow.png
Binary files differ
diff --git a/design/index.html b/design/index.html
new file mode 100644
index 0000000..ddffdae
--- /dev/null
+++ b/design/index.html
@@ -0,0 +1,993 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="generator" content="Asciidoctor 1.5.5">
+<meta name="author" content="2019-08-07 15:02:40 CEST">
+<title>N4JS Design Specification</title>
+<link rel="stylesheet" href="styles/spec.min.css">
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.6.3/css/font-awesome.min.css">
+<!-- ************* docinfo ******************************************************************* -->
+
+
+<!-- ************* Favicon ************-->
+<link rel="icon" href="images/favicon.ico" />
+
+<!-- ************* Back-to-top JQuery ************* -->
+<script src="https://code.jquery.com/jquery-1.12.4.js"></script>
+<script src="https://code.jquery.com/ui/1.12.0/jquery-ui.js"></script>
+
+
+<link href="styles/prism.min.css" rel="stylesheet" />
+<script type="text/javascript" async
+  src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2/MathJax.js?config=TeX-MML-AM_CHTML">
+</script>
+
+<!-- ************* Styles ************* -->
+<link rel="stylesheet" type="text/css" href="styles/n4jsspec-adoc.css">
+
+
+<!-- ****************** NavBar ****************** -->
+<div id="menubar">
+	<div class="banner">
+        <a href="https://www.eclipse.org/n4js/#"><img id="logo" src="images/n4js-logo.png" alt="Eclipse N4JS"></a>
+    </div>
+<ul>
+  <li><a href="index.html">Index</a></li>
+</ul>
+</div>
+<!-- ************* docinfo ******************************************************************* -->
+<style>
+      .admonitionblock td.icon .icon-todo:before{content:"\f249";color:#f4ee42}
+    </style>
+</head>
+<body class="book toc2 toc-left">
+<div id="header">
+<h1>N4JS Design Specification</h1>
+<div class="details">
+<span id="author" class="author">2019-08-07 15:02:40 CEST</span><br>
+<span id="revnumber">version 0.9</span>
+</div>
+<div id="toc" class="toc2">
+<div id="toctitle">Table of Contents</div>
+<ul class="sectlevel1">
+<li><a href="introduction.html#_introduction">1. Introduction</a>
+<ul class="sectlevel2">
+<li><a href="introduction.html#notation">1.1. Notation</a></li>
+<li><a href="introduction.html#sec:IDE_Overview">1.2. IDE Components</a>
+<ul class="sectlevel3">
+<li><a href="introduction.html#sec:Naming_Conventions">1.2.1. Naming Conventions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="eclipse_setup.html#_eclipse-setup">2. Eclipse Setup</a>
+<ul class="sectlevel2">
+<li><a href="eclipse_setup.html#_system-requirements">2.1. System Requirements</a></li>
+<li><a href="eclipse_setup.html#_contribute">2.2. Contribute</a>
+<ul class="sectlevel3">
+<li><a href="eclipse_setup.html#_eclipse-installer">2.2.1. Eclipse Installer</a>
+<ul class="sectlevel4">
+<li><a href="eclipse_setup.html#_changing-the-setup-script">2.2.1.1. Changing the Setup Script</a></li>
+</ul>
+</li>
+<li><a href="eclipse_setup.html#_manual-ide-configuration">2.2.2. Manual IDE Configuration</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="release_engineering.html#_release-engineering">3. Release Engineering</a>
+<ul class="sectlevel2">
+<li><a href="release_engineering.html#_nightly-build-on-eclipse-infrastructure">3.1. Nightly build on Eclipse infrastructure</a></li>
+<li><a href="release_engineering.html#_build-the-n4js-ide-from-command-line">3.2. Build the N4JS IDE from command line</a>
+<ul class="sectlevel3">
+<li><a href="release_engineering.html#_publish-maven-tooling-code-org-eclipse-n4js-releng-util-code">3.2.1. Publish maven-tooling <code>org.eclipse.n4js.releng.util</code></a></li>
+<li><a href="release_engineering.html#sec:test-verdaccio">3.2.2. Test Verdaccio containing n4js-libs</a></li>
+<li><a href="release_engineering.html#_generation-of-eclipse-help-for-spec-and-design-document">3.2.3. Generation of Eclipse help for spec and design document</a></li>
+</ul>
+</li>
+<li><a href="release_engineering.html#_updating-frameworks-and-dependencies">3.3. Updating frameworks and dependencies</a>
+<ul class="sectlevel3">
+<li><a href="release_engineering.html#_update-of-eclipse-emf-xtext-etc">3.3.1. Update of Eclipse, EMF, Xtext, etc.</a></li>
+<li><a href="release_engineering.html#_update-of-the-embedded-jre">3.3.2. Update of the embedded JRE</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tips_and_tricks.html#_tips-and-tricks">4. Tips and Tricks</a>
+<ul class="sectlevel2">
+<li><a href="tips_and_tricks.html#_naming">4.1. Naming</a></li>
+<li><a href="tips_and_tricks.html#_logging">4.2. Logging</a></li>
+<li><a href="tips_and_tricks.html#_cancellation-handling">4.3. Cancellation Handling</a></li>
+<li><a href="tips_and_tricks.html#_caching">4.4. Caching</a></li>
+<li><a href="tips_and_tricks.html#_dependency-injection">4.5. Dependency Injection</a></li>
+<li><a href="tips_and_tricks.html#_miscellaneous">4.6. Miscellaneous</a></li>
+</ul>
+</li>
+<li><a href="parser.html#_parser">5. Parser</a>
+<ul class="sectlevel2">
+<li><a href="parser.html#sec:Parser_Overview">5.1. Overview</a></li>
+<li><a href="parser.html#sec:N4JS_Parser">5.2. N4JS Parser</a></li>
+<li><a href="parser.html#sec:Parser_Generation_Post_Processing">5.3. Parser Generation Post-Processing</a>
+<ul class="sectlevel3">
+<li><a href="parser.html#sec:Automatic_Semicolon_Insertion">5.3.1. Automatic Semicolon Insertion</a>
+<ul class="sectlevel4">
+<li><a href="parser.html#sec:Injected_code_in_the_Antlr_grammar_file">5.3.1.1. Injected code in the Antlr grammar file</a></li>
+<li><a href="parser.html#sec:Customized_error_recovery">5.3.1.2. Customized error recovery</a></li>
+</ul>
+</li>
+<li><a href="parser.html#sec:_No_line_terminator_allowed_here__handling">5.3.2. Async and <code>No line terminator allowed here</code> Handling</a></li>
+<li><a href="parser.html#sec:Regular_Expression">5.3.3. Regular Expression</a></li>
+<li><a href="parser.html#sec:Unicode">5.3.4. Unicode</a></li>
+<li><a href="parser.html#sec:Literals">5.3.5. Literals</a></li>
+</ul>
+</li>
+<li><a href="parser.html#sec:Modifiers">5.4. Modifiers</a></li>
+<li><a href="parser.html#sec:Conflict_Resolutions">5.5. Conflict Resolutions</a>
+<ul class="sectlevel3">
+<li><a href="parser.html#sec:Reserved_Keywords_vs__Identifier_Names">5.5.1. Reserved Keywords vs. Identifier Names</a></li>
+<li><a href="parser.html#sec:Operators_and_Generics">5.5.2. Operators and Generics</a></li>
+</ul>
+</li>
+<li><a href="parser.html#sec:Content_Assist_Parser">5.6. Content-Assist Parser</a></li>
+</ul>
+</li>
+<li><a href="type_system.html#_type-system">6. Type System</a>
+<ul class="sectlevel2">
+<li><a href="type_system.html#sec:Type_Model_and_Grammar">6.1. Type Model and Grammar</a>
+<ul class="sectlevel3">
+<li><a href="type_system.html#sec:Type_Model_Overview">6.1.1. Type Model Overview</a></li>
+<li><a href="type_system.html#sec:Built_in_Types">6.1.2. Built-in and Primitive Types</a></li>
+<li><a href="type_system.html#sec:Type_Model_DSL">6.1.3. Type Model DSL</a></li>
+</ul>
+</li>
+<li><a href="type_system.html#sec:Type_System_Implementation">6.2. Type System Implementation</a></li>
+<li><a href="type_system.html#sec:Type_Inference_combined_with_AST_Traversal">6.3. Type Inference of AST</a>
+<ul class="sectlevel3">
+<li><a href="type_system.html#sec:Type_Inference_combined_with_AST_Traversal__Background">6.3.1. Background</a></li>
+<li><a href="type_system.html#sec:Triggering_Type_Inference_of_AST">6.3.2. Triggering</a></li>
+<li><a href="type_system.html#sec:Traversal_Order_During_Type_Inference_of_AST">6.3.3. Traversal Order</a></li>
+<li><a href="type_system.html#sec:Cross_References_During_Type_Inference_of_AST">6.3.4. Cross-References</a></li>
+<li><a href="type_system.html#sec:Function_Accessor_Bodies_During_Type_Inference_of_AST">6.3.5. Function/Accessor Bodies</a></li>
+<li><a href="type_system.html#sec:Poly_Expressions_During_Type_Inference_of_AST">6.3.6. Poly Expressions</a></li>
+<li><a href="type_system.html#sec:Constraint_Solver_used_During_Type_Inference_of_AST">6.3.7. Constraint Solver</a></li>
+<li><a href="type_system.html#sec:Type_Guards_During_Type_Inference_of_AST">6.3.8. Type Guards</a></li>
+</ul>
+</li>
+<li><a href="type_system.html#sec:Structural_Typing">6.4. Structural Typing</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#_type-index">7. Type Index</a>
+<ul class="sectlevel2">
+<li><a href="type_index.html#sec:Type_Index_Design_Rationale">7.1. Design Rationale</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#sec:Getting_the_Xtext_Index_Content_IResourceDescriptions">7.1.1. Getting the Xtext Index (<code>IResourceDescriptions</code>) Content</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#sec:Design_Overview">7.2. Design Overview</a></li>
+<li><a href="type_index.html#sec:N4JS_Resource_Load_States">7.3. N4JS Resource Load States</a></li>
+<li><a href="type_index.html#sec:Type_Builder">7.4. Types Builder</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#sec:Type_Inference_not_allowed_in_Type_Builder">7.4.1. Type Inference not allowed in Types Builder</a></li>
+<li><a href="type_index.html#sec:ComputedTypeReferences">7.4.2. Deferred Type References</a></li>
+<li><a href="type_index.html#sec:Use_cases_of_ComputedTypeRef">7.4.3. Use cases of DeferredTypeRef</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#sec:Incremental_Builder_Overview">7.5. Incremental Builder (Overview)</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#sec:Incremental_Builder_Overview__XtextBuilder">7.5.1. XtextBuilder</a></li>
+<li><a href="type_index.html#sec:Incremental_Builder_Overview__IBuilderState">7.5.2. IBuilderState</a>
+<ul class="sectlevel4">
+<li><a href="type_index.html#copy-and-update-xtext-index">7.5.2.1. Copy and Update Xtext Index</a></li>
+<li><a href="type_index.html#build-state-setup-phase">7.5.2.2. Build State Setup Phase</a></li>
+<li><a href="type_index.html#process-queued-uris">7.5.2.3. Process Queued URIs</a></li>
+<li><a href="type_index.html#queueing-affected-resources">7.5.2.4. Queueing Affected Resources</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#sec:Incremental_Builder_Overview__Example">7.5.3. Example</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#dirty-state-handling">7.6. Dirty state handling</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#use-case-restoring-types-from-user-data">7.6.1. Use case: Restoring types from user data</a></li>
+<li><a href="type_index.html#use-case-updating-the-xtext-index">7.6.2. Use case: Updating the Xtext index</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="project_model.html#_project-model">8. Project Model</a>
+<ul class="sectlevel2">
+<li><a href="project_model.html#sec:Package_json">8.1. Package.json File</a></li>
+<li><a href="project_model.html#_accessing-project-information">8.2. Accessing Project Information</a>
+<ul class="sectlevel3">
+<li><a href="project_model.html#sec:IN4JSCore">8.2.1. IN4JSCore</a></li>
+<li><a href="project_model.html#sec:N4JSModel">8.2.2. N4JSModel</a></li>
+<li><a href="project_model.html#sec:N4JSWorkspace">8.2.3. N4JSWorkspace</a></li>
+<li><a href="project_model.html#sec:N4JSProject">8.2.4. N4JSProject</a></li>
+<li><a href="project_model.html#sec:SourceContainer">8.2.5. SourceContainer</a></li>
+<li><a href="project_model.html#sec:N4JSProjectsStateHelper">8.2.6. N4JSProjectsStateHelper</a></li>
+</ul>
+</li>
+<li><a href="project_model.html#sec:Caching">8.3. Caching</a>
+<ul class="sectlevel3">
+<li><a href="project_model.html#_caching-of-externallibraryworkspace">8.3.1. Caching of ExternalLibraryWorkspace</a></li>
+<li><a href="project_model.html#_caching-of-n4jsprojectsstatehelper">8.3.2. Caching of N4JSProjectsStateHelper</a></li>
+</ul>
+</li>
+<li><a href="project_model.html#sec:WildcardPathFilter">8.4. WildcardPathFilter</a></li>
+<li><a href="project_model.html#sec:ProjectUtils">8.5. ProjectUtils</a></li>
+</ul>
+</li>
+<li><a href="binding.html#_binding">9. Binding</a>
+<ul class="sectlevel2">
+<li><a href="binding.html#sec:Binding_Design_Rationale">9.1. Design Rationale</a></li>
+<li><a href="binding.html#sec:Binding_to_Members">9.2. Binding to Members</a></li>
+<li><a href="binding.html#sec:Binding_Getter_Setter">9.3. Getter / Setter Binding</a></li>
+<li><a href="binding.html#chap:Statics">9.4. Static Member Binding</a></li>
+<li><a href="binding.html#sec:Binding_Enumeration">9.5. Enumeration Literals Binding</a></li>
+<li><a href="binding.html#sec:Accessibility_of_types_and_members">9.6. Accessibility of types and members</a></li>
+<li><a href="binding.html#sec:Member_Scope_Example">9.7. Member Scope Example</a></li>
+<li><a href="binding.html#sec:Scoping_for_Members_of_Composed_Type_Explained">9.8. Scoping for Members of Composed Type (Union/Intersection) Example</a></li>
+<li><a href="binding.html#sec:Binding_of_Structurally_References_Types">9.9. Structurally References Types</a></li>
+<li><a href="binding.html#sec:Building">9.10. Building</a>
+<ul class="sectlevel3">
+<li><a href="binding.html#sec:Build_Phases">9.10.1. Build Phases</a></li>
+<li><a href="binding.html#sec:Build_Scenarios">9.10.2. Build Scenarios</a></li>
+<li><a href="binding.html#sec:Lazy_linking_problem">9.10.3. Lazy linking problem</a></li>
+</ul>
+</li>
+<li><a href="binding.html#sec:Proxies_and_Proxy_Resolution">9.11. Proxies and Proxy Resolution (Overview)</a>
+<ul class="sectlevel3">
+<li><a href="binding.html#xtexts-lazy-linking-proxies">9.11.1. Xtext’s Lazy Linking Proxies</a></li>
+<li><a href="binding.html#standard-emf-proxies">9.11.2. Standard EMF Proxies</a></li>
+<li><a href="binding.html#_how-is-proxy-resolution-triggered">9.11.3. How is Proxy Resolution Triggered?</a></li>
+<li><a href="binding.html#_when-is-proxy-resolution-allowed">9.11.4. When is Proxy Resolution Allowed?</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="validation.html#_validation">10. Validation</a>
+<ul class="sectlevel2">
+<li><a href="validation.html#sec:validation_overview">10.1. Validation overview</a></li>
+<li><a href="validation.html#sec:validation_control_flow">10.2. Validation control flow</a></li>
+<li><a href="validation.html#sec:validation_issue_ids">10.3. Issue IDs and Messages</a></li>
+<li><a href="validation.html#sec:validation_usage_patterns">10.4. Usage Pattern</a></li>
+<li><a href="validation.html#sec:validation_links">10.5. Links</a></li>
+</ul>
+</li>
+<li><a href="references.html#_references">11. References</a>
+<ul class="sectlevel2">
+<li><a href="references.html#sec:usecases">11.1. Use cases</a></li>
+<li><a href="references.html#sec:calculation_algorithm">11.2. Calculation algorithm</a>
+<ul class="sectlevel3">
+<li><a href="references.html#sec:Xtext_default_implementation">11.2.1. Xtext default implementation</a></li>
+<li><a href="references.html#sec:N4_implementation">11.2.2. N4JS implementation</a></li>
+</ul>
+</li>
+<li><a href="references.html#sec:PerformanceOfDependencyCalculation">11.3. Performance Of Dependency Calculation</a></li>
+<li><a href="references.html#sec:kinds_of_references">11.4. Kinds of references</a>
+<ul class="sectlevel3">
+<li><a href="references.html#sec:Cross_References_to_be_ignored">11.4.1. Cross References to be ignored</a></li>
+<li><a href="references.html#sec:Cross_References_to_be_handled">11.4.2. Cross References to be handled</a></li>
+</ul>
+</li>
+<li><a href="references.html#sec:transitive_dependencies">11.5. Transitive dependencies</a></li>
+<li><a href="references.html#sec:find-references">11.6. Find references</a>
+<ul class="sectlevel3">
+<li><a href="references.html#_background">11.6.1. Background</a></li>
+<li><a href="references.html#_how-find-references-work">11.6.2. How Find References Work</a>
+<ul class="sectlevel4">
+<li><a href="references.html#_step-1-convert-cursor-position-to-declared-element">11.6.2.1. Step 1: Convert Cursor Position to Declared Element</a></li>
+<li><a href="references.html#_step-2-convert-declared-element-to-target-uris">11.6.2.2. Step 2: Convert Declared Element to Target URIs</a></li>
+<li><a href="references.html#_step-3-filter-potential-resources">11.6.2.3. Step 3: Filter Potential Resources</a></li>
+<li><a href="references.html#_step-4-search-references-in-resource">11.6.2.4. Step 4: Search References in Resource</a></li>
+<li><a href="references.html#_limitations-and-possible-enhancements">11.6.2.5. Limitations and Possible Enhancements</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="compilation.html#_compilation">12. Compilation</a>
+<ul class="sectlevel2">
+<li><a href="compilation.html#chap:compilation">12.1. Introduction</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:general_design_rationals">12.1.1. General design rationals</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:logging_and_error_reporting">12.1.1.1. Logging and error reporting</a></li>
+<li><a href="compilation.html#sec:progress_monitor">12.1.1.2. Progress monitor</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Xtext_Integration">12.1.2. Xtext Integration</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:xtext_default_behaviour">12.1.2.1. Xtext default behaviour</a></li>
+<li><a href="compilation.html#sec:n4js_requirements">12.1.2.2. N4JS requirements</a></li>
+<li><a href="compilation.html#sec:compiler_discovery_in_ui">12.1.2.3. Compiler discovery in UI</a></li>
+<li><a href="compilation.html#sec:compiler_discovery_in_headless">12.1.2.4. Compiler discovery in headless</a></li>
+<li><a href="compilation.html#sec:general_generator_implementation">12.1.2.5. General generator implementation</a></li>
+<li><a href="compilation.html#sec:general_generator_activation">12.1.2.6. General generator activation</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Overview_of_Input_Models">12.1.3. Overview of the Input Models</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Core_Generator">12.2. Generators</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:Compiler_Components">12.2.1. Generator Components</a></li>
+<li><a href="compilation.html#sec:Generator_architecture">12.2.2. Generator architecture</a></li>
+<li><a href="compilation.html#sec:Unified_Compiler_Configuration">12.2.3. Unified Compiler Configuration</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Transpilers">12.3. Transpilers</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:Phases">12.3.1. Overview</a></li>
+<li><a href="compilation.html#relation-between-ast-and-im">12.3.2. Relation between AST and IM</a></li>
+<li><a href="compilation.html#implementation-overview">12.3.3. Implementation Overview</a></li>
+<li><a href="compilation.html#sec:Guidelines_for_Implementing_Transformations">12.3.4. Guidelines for Implementing Transformations</a></li>
+<li><a href="compilation.html#symbol-table-in-the-im">12.3.5. Symbol Table in the IM</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:N4JS_to_EcmaScript_Transpiler">12.4. N4JS-to-EcmaScript Transpiler</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:Overview_of_Transformations">12.4.1. Overview of Transformations</a></li>
+<li><a href="compilation.html#sec:Transpiling_members">12.4.2. Transpiling members</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:Transpiling_members__Delegating_members">12.4.2.1. Techniques for special member handling</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__Partial_shadowing_of_getter_setter_pairs">12.4.2.2. Partial shadowing</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__Consuming_or_inheriting_members_of_an_interface">12.4.2.3. Consuming or inheriting members of an interface</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__Static_polyfill">12.4.2.4. Static polyfill</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__API_implementation_stubs">12.4.2.5. API / implementation stubs</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Support_for_incomplete_API_implementation_testing_in_the_N4JS_to_EcmaScript_5_Transpiler">12.4.3. Support for incomplete API implementation testing</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:Modifications_in_Impl_projects">12.4.3.1. Modifications in Impl projects</a></li>
+<li><a href="compilation.html#sec:Implementation_of_stub_generation">12.4.3.2. Implementation of stub-generation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:n4jsc_Headless_Compiler_Interface">12.5. n4jsc Headless Compiler Interface</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:building_the_headless_compiler">12.5.1. building the headless compiler</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="execution.html#_execution">13. Execution</a>
+<ul class="sectlevel2">
+<li><a href="execution.html#sec:N4JS_Project_Execution_And_Linking_Model">13.1. N4JS Project Execution And Linking Model</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#subsec:N4JS_Execution_With_NodeJS">13.1.1. N4JS Execution With NodeJS</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:N4JS_Execution_And_Linking_File">13.2. N4JS Execution And Linking File</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#subsec:NodeJS_Specific_ELF">13.2.1. NodeJS Specific ELF</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Runners-execution">13.3. Runners</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#subsec:N4_Runtime_Environments_Convention">13.3.1. N4 Runtime Environments Convention</a></li>
+<li><a href="execution.html#subsec:Passing_Information_from_IDE_to_Execution_Code_in_Runtime_Environment">13.3.2. Passing Information from IDE to Execution Code in Runtime Environment</a></li>
+<li><a href="execution.html#subsec:Runners_Design">13.3.3. Runners Design</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Legacy_Execution_Engine">13.4. Legacy Execution Engine</a></li>
+<li><a href="execution.html#sec:Design">13.5. Design</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#sec:Usage_Outside_N4JSIDE">13.5.1. Usage Outside N4JSIDE</a>
+<ul class="sectlevel4">
+<li><a href="execution.html#sec:Use_Node_with_Maven">13.5.1.1. Use Node with Maven</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Usage_Inside_N4JSIDE">13.5.2. Usage Inside N4JSIDE</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Runtime_Injection">13.6. Runtime Injection</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#sec:Running_String_Code">13.6.1. Running String Code</a></li>
+<li><a href="execution.html#sec:Running_File_Code">13.6.2. Running File Code</a></li>
+<li><a href="execution.html#sec:Injection_Code_Example">13.6.3. Injection Code Example</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#_tests">14. Tests</a>
+<ul class="sectlevel2">
+<li><a href="tests.html#sec:Performance_Tests">14.1. Performance Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Synthetic_Performance_Tests">14.1.1. Synthetic Performance Tests</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:Design_of_Generator">14.1.1.1. Design of Generator</a></li>
+<li><a href="tests.html#sec:Design_of_Performance_Test_Execution">14.1.1.2. Design of Performance Test Configuration and Execution</a></li>
+<li><a href="tests.html#sec:JUnit_Configuration">14.1.1.3. JUnit Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Test_Configuration">14.1.1.4. JUnitBenchmark Test Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Report_Configuration">14.1.1.5. JUnitBenchmark Report Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Run_Configuration">14.1.1.6. JUnitBenchmark Run Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Example">14.1.1.7. JUnitBenchmark Example</a></li>
+<li><a href="tests.html#sec:Note_on_Jenkins_Job">14.1.1.8. Note on Jenkins Job</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#sec:ECMA_Tests">14.2. ECMA Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Grammar_Tests">14.2.1. Grammar Tests</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:Negative_Tests">14.2.1.1. Negative Tests</a></li>
+<li><a href="tests.html#sec:Test_Exclusion">14.2.1.2. Test Exclusion</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Integration_Tests">14.3. Integration Tests</a></li>
+<li><a href="tests.html#sec:Test_Helpers">14.4. Test Helpers</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Parameterized_N4JS_Tests">14.4.1. Parameterized N4JS tests</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:ParameterizedXtextRunner">14.4.1.1. ParameterizedXtextRunner</a></li>
+<li><a href="tests.html#sec:TestCodeProvider">14.4.1.2. TestCodeProvider</a></li>
+<li><a href="tests.html#sec:Example_Of_Parameterized_Parser_Test">14.4.1.3. Example of parameterized parser test</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Issue_Suppression">14.5. Issue Suppression</a></li>
+<li><a href="tests.html#sec:Xpect_Tests">14.6. Xpect Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Xpect_Test_Setup">14.6.1. Xpect Test Setup</a></li>
+<li><a href="tests.html#sec:Xpect_Issue_Suppression">14.6.2. Xpect Issue Suppression</a></li>
+<li><a href="tests.html#sec:Xpect_Provided_Test_Methods">14.6.3. Xpect Provided Test Methods</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#errors">14.6.3.1. errors</a></li>
+<li><a href="tests.html#warnings">14.6.3.2. warnings</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:N4JS_Specific_Xpect_Test_Methods">14.6.4. N4JS Specific Xpect Test Methods</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:XPECT_noerrors">14.6.4.1. noerrors and nowarnings</a></li>
+<li><a href="tests.html#sec:XPECT_scope">14.6.4.2. scope</a></li>
+<li><a href="tests.html#sec:XPECT_scopeWithPosition">14.6.4.3. scopeWithPosition</a></li>
+<li><a href="tests.html#sec:XPECT_scopeWithResource">14.6.4.4. scopeWithResource</a></li>
+<li><a href="tests.html#sec:XPECT_binding">14.6.4.5. binding</a></li>
+<li><a href="tests.html#sec:XPECT_linkedPathname">14.6.4.6. linkedPathname</a></li>
+<li><a href="tests.html#sec:XPECT_type_of">14.6.4.7. type of</a></li>
+<li><a href="tests.html#sec:XPECT_expectedType">14.6.4.8. expectedType</a></li>
+<li><a href="tests.html#sec:XPECT_elementKeyword">14.6.4.9. elementKeyword</a></li>
+<li><a href="tests.html#sec:XPECT_accessModifier">14.6.4.10. accessModifier</a></li>
+<li><a href="tests.html#sec:XPECT_compileResult">14.6.4.11. compileResult</a></li>
+<li><a href="tests.html#sec:XPECT_output">14.6.4.12. output</a></li>
+<li><a href="tests.html#sec:XPECT_outputRegEx">14.6.4.13. outputRegEx</a></li>
+<li><a href="tests.html#sec:XPECT_calculatedAccessModifier">14.6.4.14. calculatedAccessModifier</a></li>
+<li><a href="tests.html#sec:XPECT_spec">14.6.4.15. spec</a></li>
+<li><a href="tests.html#sec:XPECT_deadCode">14.6.4.16. deadCode</a></li>
+<li><a href="tests.html#sec:XPECT_returnOrThrows">14.6.4.17. returnOrThrows</a></li>
+<li><a href="tests.html#sec:XPECT_lint">14.6.4.18. lint</a></li>
+<li><a href="tests.html#sec:XPECT_lintFails">14.6.4.19. lintFails</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:FIXME_Xpect_modifier">14.6.5. FIXME Xpect modifier</a></li>
+<li><a href="tests.html#sec:Expectmatrix_Xpect_Test_Methods">14.6.6. Expectmatrix Xpect tests</a></li>
+<li><a href="tests.html#xpect-lint-tests">14.6.7. Xpect Lint Tests</a></li>
+</ul>
+</li>
+<li><a href="tests.html#xpect-proposal-tests">14.7. Xpect Proposal Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Validation_vs__Non_Validation">14.7.1. Validation vs. Non-Validation</a></li>
+<li><a href="tests.html#sec:General_Proposal_Test_Features">14.7.2. General Proposal Test Features</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:Test_Variables">14.7.2.1. Test Variables</a></li>
+<li><a href="tests.html#sec:Location_and_Selection">14.7.2.2. at – Location and Selection</a></li>
+<li><a href="tests.html#sec:Multi_Line_Expectations_in_Proposal_Tests">14.7.2.3. Multi Line Expectations in Proposal Tests</a></li>
+<li><a href="tests.html#sec:Timeout">14.7.2.4. Timeout and Performance</a></li>
+</ul>
+</li>
+<li><a href="tests.html#proposals-verify-existence-of-proposals">14.7.3. proposals – Verify Existence of Proposals</a></li>
+<li><a href="tests.html#sec:Verify_displayed_string">14.7.4. display – Verify displayed string</a></li>
+<li><a href="tests.html#sec:Apply_Proposal">14.7.5. apply – Apply Proposal</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#resource-application-in-other-files">14.7.5.1. resource – application in other files</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Content_Assist_Cycling">14.7.6. kind – Content Assist Cycling</a></li>
+<li><a href="tests.html#fileValidVerify-validation-status">14.7.7. fileValid – Verify validation status</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Apply_Proposal_And_Execute_Tests">14.8. Apply Proposal And Execute Tests</a></li>
+<li><a href="tests.html#sec:Organize_Imports_Test">14.9. Organize Imports Test</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#organizeimports">14.9.1. organizeImports</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Access_Control_Test">14.10. Access Control Test</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#test-scenarios">14.10.1. Test Scenarios</a></li>
+<li><a href="tests.html#n4js-code-generator">14.10.2. N4JS Code Generator</a></li>
+<li><a href="tests.html#xtext-issue-matcher">14.10.3. Xtext Issue Matcher</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Smoke_Tests">14.11. Smoke Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#how-to-handle-smoke-test-errors">14.11.1. How to handle smoke test errors?</a></li>
+<li><a href="tests.html#smoketester-and-exceptionanalyzer">14.11.2. SmokeTester and ExceptionAnalyzer</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:UI_Tests_with_SWTBot">14.12. UI Tests with SWTBot</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#writing-swtbot-tests">14.12.1. Writing SWTBot Tests</a></li>
+<li><a href="tests.html#running-swtbot-tests">14.12.2. Running SWTBot Tests</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Debugging_UI_Tests">14.13. Debugging UI Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Connecting_to_the_X_server_on_the_build_node">14.13.1. Connecting to the X-server on the build-node</a></li>
+<li><a href="tests.html#sec:Tools_to_investigate_the_java_stack">14.13.2. Tools to investigate the java-stack</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="ui_concepts.html#_ui-concepts">15. UI Concepts</a>
+<ul class="sectlevel2">
+<li><a href="ui_concepts.html#sec:User_Interface_Concepts">15.1. User Interface Concepts</a>
+<ul class="sectlevel3">
+<li><a href="ui_concepts.html#sec:Eclipse_UI_Concepts">15.1.1. Eclipse UI Concepts</a>
+<ul class="sectlevel4">
+<li><a href="ui_concepts.html#sec:Label_Provider">15.1.1.1. Label Provider</a></li>
+<li><a href="ui_concepts.html#sec:Markers">15.1.1.2. Markers</a></li>
+<li><a href="ui_concepts.html#sec:Commands__Toolbar_and_Menus">15.1.1.3. Commands, Toolbar and Menus</a></li>
+<li><a href="ui_concepts.html#sec:Content_Assist">15.1.1.4. Content Assist</a></li>
+<li><a href="ui_concepts.html#sec:Quick_Fixes">15.1.1.5. Quick Fixes</a></li>
+<li><a href="ui_concepts.html#sec:Quick_Assist">15.1.1.6. Quick Assist</a></li>
+<li><a href="ui_concepts.html#sec:Clean_Up_Actions">15.1.1.7. Clean Up Actions</a></li>
+<li><a href="ui_concepts.html#sec:Save_Actions">15.1.1.8. Save Actions</a></li>
+<li><a href="ui_concepts.html#sec:Auto_Edit">15.1.1.9. Auto Edit</a></li>
+<li><a href="ui_concepts.html#sec:Template_Proposals">15.1.1.10. Template Proposals</a></li>
+<li><a href="ui_concepts.html#sec:Outline_View___Quick_Outline">15.1.1.11. Outline View / Quick Outline</a></li>
+<li><a href="ui_concepts.html#sec:Navigator__Package_Explorer__Project_Explorer">15.1.1.12. Navigator, Package Explorer, Project Explorer</a></li>
+<li><a href="ui_concepts.html#sec:Hyperlinking_and_Navigation">15.1.1.13. Hyperlinking and Navigation</a></li>
+<li><a href="ui_concepts.html#sec:Syntax_and_Semantic_Coloring">15.1.1.14. Syntax and Semantic Coloring</a></li>
+<li><a href="ui_concepts.html#sec:Code_Formatter">15.1.1.15. Code Formatter</a></li>
+<li><a href="ui_concepts.html#sec:Wizards">15.1.1.16. Wizards</a></li>
+<li><a href="ui_concepts.html#sec:Cheat_Sheets">15.1.1.17. Cheat Sheets</a></li>
+<li><a href="ui_concepts.html#sec:Context_sensitive_Help">15.1.1.18. Context-sensitive Help</a></li>
+<li><a href="ui_concepts.html#sec:Hovers">15.1.1.19. Hovers</a></li>
+<li><a href="ui_concepts.html#sec:Folding">15.1.1.20. Folding</a></li>
+<li><a href="ui_concepts.html#sec:Customizable_validation___severity">15.1.1.21. Customizable validation / severity</a></li>
+<li><a href="ui_concepts.html#sec:Proposals">15.1.1.22. Proposals</a></li>
+</ul>
+</li>
+<li><a href="ui_concepts.html#sec:Non_Eclipse_UI_Concepts">15.1.2. Non-Eclipse UI Concepts</a>
+<ul class="sectlevel4">
+<li><a href="ui_concepts.html#sec:Overlays">15.1.2.1. Overlays</a></li>
+<li><a href="ui_concepts.html#sec:Goto__Inferred__Type">15.1.2.2. Goto (Inferred) Type</a></li>
+<li><a href="ui_concepts.html#sec:Postfix_Completion">15.1.2.3. Postfix Completion</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="ui_concepts.html#_user-interface-resources">15.2. User Interface Resources</a>
+<ul class="sectlevel3">
+<li><a href="ui_concepts.html#_icons">15.2.1. Icons</a>
+<ul class="sectlevel4">
+<li><a href="ui_concepts.html#_eclipse-platform-icons">15.2.1.1. Eclipse Platform Icons</a></li>
+<li><a href="ui_concepts.html#_n4js-specific-icons">15.2.1.2. N4JS Specific Icons</a></li>
+<li><a href="ui_concepts.html#_high-resolution-icons">15.2.1.3. High Resolution Icons</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="formatting.html#_formatting">16. Formatting</a>
+<ul class="sectlevel2">
+<li><a href="formatting.html#sec:FmtObjective">16.1. Objective</a>
+<ul class="sectlevel3">
+<li><a href="formatting.html#sec:FmtFormatting_Comments">16.1.1. Formatting Comments</a></li>
+</ul>
+</li>
+<li><a href="formatting.html#sec:FmtArchitecture">16.2. Architecture</a>
+<ul class="sectlevel3">
+<li><a href="formatting.html#sec:Implementation_example">16.2.1. Implementation example</a></li>
+</ul>
+</li>
+<li><a href="formatting.html#sec:FmtFormatter_Implementation_Guidelines">16.3. Formatter Implementation Guidelines</a></li>
+<li><a href="formatting.html#sec:FmtConfiguration">16.4. Configuration</a></li>
+<li><a href="formatting.html#sec:FmtUI_Integration">16.5. UI Integration</a></li>
+<li><a href="formatting.html#sec:FmtUnit_Testing_with_Xpect">16.6. Unit Testing with Xpect</a></li>
+</ul>
+</li>
+<li><a href="external_libraries.html#_external-libraries">17. External Libraries</a>
+<ul class="sectlevel2">
+<li><a href="external_libraries.html#sec:Major_Components">17.1. Major Components</a>
+<ul class="sectlevel3">
+<li><a href="external_libraries.html#subsec:External_Resources">17.1.1. External Resources</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Workspace">17.1.2. External Library Workspace</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Preference_Store">17.1.3. External Library Preference Store</a></li>
+<li><a href="external_libraries.html#subsec:npm_Manager">17.1.4. Library Manager</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Builder_Helper">17.1.5. External Library Builder</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Xtext_Index_Persister">17.1.6. External Library Xtext Index Persister</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Preference_Page">17.1.7. External Library Preference Page</a></li>
+</ul>
+</li>
+<li><a href="external_libraries.html#sec:Headless_External_Library_Support">17.2. Headless External Library Support</a>
+<ul class="sectlevel3">
+<li><a href="external_libraries.html#_custom-npm-settings">17.2.1. Custom npm settings</a></li>
+</ul>
+</li>
+<li><a href="external_libraries.html#sec:lmFutureWork">17.3. Future Work</a>
+<ul class="sectlevel3">
+<li><a href="external_libraries.html#subsec:lmMultipleDependencyScope">17.3.1. Multiple Dependency Scope</a></li>
+<li><a href="external_libraries.html#subsec:lmRunTestsFromLibrary">17.3.2. Run Tests from TestLibrary</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="json_support.html#sec:JSON_Support">18. JSON Support</a>
+<ul class="sectlevel2">
+<li><a href="json_support.html#sec:JSON_Parser">18.1. JSON Parser</a>
+<ul class="sectlevel3">
+<li><a href="json_support.html#sec:JSON_Parser_Unicode_Escaping">18.1.1. Escaping Unicode Control Characters in String Literals</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Empty_Text">18.1.2. Empty Text</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Nested_Structures">18.1.3. Nested Structures</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Whitespace">18.1.4. Whitespace</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Comments">18.1.5. Comments</a></li>
+</ul>
+</li>
+<li><a href="json_support.html#sec:JSON_Language_Extensions">18.2. JSON Language Extensions</a>
+<ul class="sectlevel3">
+<li><a href="json_support.html#sec:JSON_Validator_Extensions">18.2.1. JSON Validator Extensions</a>
+<ul class="sectlevel4">
+<li><a href="json_support.html#sec:File_Specitic_Validator_Extensions">18.2.1.1. File-Specific Validator Extensions</a></li>
+<li><a href="json_support.html#sec:JSON_Declarative_JSON_Validator_Extensions">18.2.1.2. Declarative JSON Validator Extensions</a></li>
+</ul>
+</li>
+<li><a href="json_support.html#_json-resource-description-strategy">18.2.2. JSON Resource Description Strategy</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_jsdoc">19. JSDoc</a>
+<ul class="sectlevel2">
+<li><a href="jsdoc.html#sec:Design_Rationale">19.1. Design Rationale</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#_general-design">19.1.1. General Design</a></li>
+<li><a href="jsdoc.html#sec:Type_Expressions">19.1.2. Type Expressions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="docexporter.html#_docexporter">20. DocExporter</a>
+<ul class="sectlevel2">
+<li><a href="docexporter.html#sec:Specification_Exporter">20.1. Specification Exporter</a></li>
+</ul>
+</li>
+<li><a href="rename_refactoring.html#_rename-refactoring">21. Rename Refactoring</a>
+<ul class="sectlevel2">
+<li><a href="rename_refactoring.html#_rename-refactoring-ui-interaction">21.1. Rename Refactoring UI interaction</a></li>
+<li><a href="rename_refactoring.html#_renameelementprocessor-interaction">21.2. RenameElementProcessor interaction</a></li>
+</ul>
+</li>
+<li><a href="flow_graphs.html#chap:flowgraphs">22. Flow Graphs</a>
+<ul class="sectlevel2">
+<li><a href="flow_graphs.html#sec:flowgraphs_overview">22.1. Flow graphs overview</a>
+<ul class="sectlevel3">
+<li><a href="flow_graphs.html#_internal-graph">22.1.1. Internal graph</a></li>
+<li><a href="flow_graphs.html#_optimizations">22.1.2. Optimizations</a></li>
+<li><a href="flow_graphs.html#_api-for-client-analyses">22.1.3. API for client analyses</a>
+<ul class="sectlevel4">
+<li><a href="flow_graphs.html#_mapping-from-internal-to-ast-elements">22.1.3.1. Mapping from internal to AST elements</a></li>
+<li><a href="flow_graphs.html#_graph-visitor">22.1.3.2. Graph visitor</a></li>
+<li><a href="flow_graphs.html#_graph-explorer">22.1.3.3. Graph explorer</a></li>
+<li><a href="flow_graphs.html#_branch-walker">22.1.3.4. Branch walker</a></li>
+<li><a href="flow_graphs.html#_example-1-compute-string-for-each-path">22.1.3.5. Example 1: Compute string for each path</a></li>
+<li><a href="flow_graphs.html#_path-quantor">22.1.3.6. Path quantor</a></li>
+</ul>
+</li>
+<li><a href="flow_graphs.html#_control-flow-analyses">22.1.4. Control flow analyses</a>
+<ul class="sectlevel4">
+<li><a href="flow_graphs.html#_dead-code-analysis">22.1.4.1. Dead code analysis</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="flow_graphs.html#sec:dataflow">22.2. Dataflow</a>
+<ul class="sectlevel3">
+<li><a href="flow_graphs.html#_dataflow-graph">22.2.1. Dataflow graph</a></li>
+<li><a href="flow_graphs.html#_dataflow-analyses">22.2.2. Dataflow analyses</a>
+<ul class="sectlevel4">
+<li><a href="flow_graphs.html#_def-def-def-nothing-analysis">22.2.2.1. Def&#8594;Def / Def&#8594;Nothing analysis</a></li>
+<li><a href="flow_graphs.html#_def-use-decl-analysis">22.2.2.2. Def|Use&#8592;Decl analysis</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="publish_npms.html#sec:publish-npms-to-public">23. Publish npms</a>
+<ul class="sectlevel2">
+<li><a href="publish_npms.html#sec:publish-npms-n4js-maven">23.1. Publish n4js-libs to during  maven build</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Hints">Appendix A: Hints</a>
+<ul class="sectlevel2">
+<li><a href="appendix_a_hints.html#sec:XtextInjection">A.1. Xtext Injection</a>
+<ul class="sectlevel3">
+<li><a href="appendix_a_hints.html#sec:DI_MultipleInjectors_Singletons">A.1.1. Multiple Injectors and Singletons</a>
+<ul class="sectlevel4">
+<li><a href="appendix_a_hints.html#sec:DI_avoid_duplicate_singletons">A.1.1.1. Avoiding duplicate singletons</a>
+<ul class="sectlevel5">
+<li><a href="appendix_a_hints.html#sec:DI_binding_in_shared">A.1.1.1.1. Defining binding in the shared injector</a></li>
+<li><a href="appendix_a_hints.html#sec:DI_binding_in_custom">A.1.1.1.2. Defining binding in the custom injector</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:DI_Hints">A.1.2. Dependency Injection Hints</a>
+<ul class="sectlevel4">
+<li><a href="appendix_a_hints.html#sec:DI_custom_bundle">A.1.2.1. Use DI in custom bundle, use DI with extensions</a>
+<ul class="sectlevel5">
+<li><a href="appendix_a_hints.html#sec:DI_custom_bundle_problem">A.1.2.1.1. Problem</a></li>
+<li><a href="appendix_a_hints.html#sec:DI_custom_bundle_solution">A.1.2.1.2. Solution</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Access_Other_DSL_Injector">A.1.2.2. How do I get the Guice Injector of my language?</a>
+<ul class="sectlevel5">
+<li><a href="appendix_a_hints.html#sec:DSL_Injector_UI_context">A.1.2.2.1. UI context</a></li>
+<li><a href="appendix_a_hints.html#sec:DSL_Injector_Non_UI_context">A.1.2.2.2. Non UI context but with injection context</a></li>
+<li><a href="appendix_a_hints.html#sec:DSL_Injector_Non_UI_non_injection_context">A.1.2.2.3. Non UI context without injection context</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Cancel_Indicator">A.1.2.3. How do I get cancel indicators in different contexts?</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Eclipse">A.2. Eclipse</a>
+<ul class="sectlevel3">
+<li><a href="appendix_a_hints.html#sec:Show_Xtext_Index">A.2.1. Show the current Xtext index</a></li>
+<li><a href="appendix_a_hints.html#sec:Plugin_spy">A.2.2. Plug-in spy</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Maven-hints">A.3. Maven</a>
+<ul class="sectlevel3">
+<li><a href="appendix_a_hints.html#how-to-check-for-maven-mojo-updates">A.3.1. How to check for Maven MOJO updates</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#_module-loading">Appendix B: Module Loading</a>
+<ul class="sectlevel2">
+<li><a href="appendix_b_module_loading.html#sec:Dependency_Management">B.1. Dependency Management</a></li>
+<li><a href="appendix_b_module_loading.html#ecmascript-modules">B.2. ECMAScript Modules</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:ES5_Modules_Systems">B.2.1. ES5 Modules Systems</a></li>
+<li><a href="appendix_b_module_loading.html#sec:ES6_Modules">B.2.2. ES6 Modules</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:ECMAScript_Module_Loaders">B.3. ECMAScript Module Loaders</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:ES6_Module_Loaders">B.3.1. ES6 Module Loaders</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Polyfills_for_ES6_Module_Loaders">B.3.2. Polyfills for ES6 Module Loaders</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:es6_module_loader">B.3.2.1. es6-module-loader</a></li>
+<li><a href="appendix_b_module_loading.html#sec:SystemJS">B.3.2.2. SystemJS</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Demo">B.3.2.3. Demo</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#case-study-typescript">B.4. Case Study : TypeScript</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:ES6_Modules_Support">B.4.1. ES6 Modules Support</a></li>
+<li><a href="appendix_b_module_loading.html#sec:TypeScript_and_Module_Loading">B.4.2. TypeScript and Module Loading</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Cyclic_Dependencies">B.5. Cyclic Dependencies</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:Setup">B.5.1. Setup</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Transpile_and_Execute">B.5.2. Transpile and Execute</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Module_Format___AMD">B.5.2.1. Module Format = AMD</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Module_Format___CommonJS">B.5.2.2. Module Format = CommonJS</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Module_Format___SystemJS">B.5.2.3. Module Format = SystemJS</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Conclusion">B.5.3. Conclusion</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#system.register-as-transpilation-target">B.6. System.register as transpilation target</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:Introduction">B.6.1. Introduction</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:External_Transpilers">B.6.1.1. External Transpilers</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Example_of_a_System_register_module">B.6.1.2. Example of a System.register module</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Structure_of_a_System_register_module">B.6.2. Structure of a System.register module</a></li>
+<li><a href="appendix_b_module_loading.html#_transpilation-hints">B.6.3. Transpilation Hints</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Handling_Imports">B.6.3.1. Handling Imports</a></li>
+<li><a href="appendix_b_module_loading.html#sec:__exportFn__">B.6.3.2. &lt;&lt;exportFn&gt;&gt;</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Handling_Exports">B.6.3.3. Handling Exports</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Examples_w__Circular_Dependencies">B.6.4. Examples w/ Circular Dependencies</a></li>
+<li><a href="appendix_b_module_loading.html#sec:N4JS_Examples_w__Circular_Dependencies">B.6.5. N4JS Examples w/ Circular Dependencies</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Unresolved_Cyclic_Dependencies">B.6.5.1. Unresolved Cyclic Dependencies</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Variables___Functions">B.6.5.2. Examples with Variables &amp; Functions</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Classes">B.6.5.3. Examples with Classes</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Examples_with_SubClassing">B.6.5.4. Examples with SubClassing</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Miscellaneous">B.6.5.5. Miscellaneous</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#_resources">B.6.6. Resources</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:CommonJS_as_transpilation_target">B.7. CommonJS as transpilation target</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#_introduction-2">B.7.1. Introduction</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Transpilation_Hints">B.7.2. Transpilation Hints</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Import_Statements">B.7.2.1. Import Statements</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Export_Statements">B.7.2.2. Export Statements</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Tracking_Live_Bindings">B.7.2.3. Tracking Live Bindings</a></li>
+<li><a href="appendix_b_module_loading.html#sec:A_complete_example">B.7.2.4. A complete example</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#_resources-2">B.7.3. Resources</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_c_license.html#sec:License">Appendix C: License</a></li>
+<li><a href="appendix_d_acronyms.html#sec:Acronyms">Appendix D: Acronyms</a></li>
+<li><a href="appendix_e_bibliography_and_footnotes.html#_bibliography-and-footnotes">Appendix E: Bibliography and Footnotes</a></li>
+</ul>
+</div>
+</div>
+<div id="content">
+<div id="preamble">
+<div class="sectionbody">
+<div class="paragraph center">
+<p><strong>Last Updated: 2019-08-07</strong></p>
+</div>
+<div class="paragraph center">
+<p><strong>Authors:</strong><br>
+Jens von Pilgrim, Jakub Siberski, Mark-Oliver Reiser, Torsten Krämer, Ákos Kitta, Sebastian Zarnekow, Lorenzo Bettini, Jörg Reichert, Kristian Duske, Marcus Mews, Minh Quang Tran, Luca Beurer-Kellner</p>
+</div>
+<div style="page-break-after: always;"></div>
+<div class="paragraph">
+<p>This document contains the N4JS Design and Implementation documentation.</p>
+</div>
+</div>
+</div>
+<ol>
+
+	<li><a href="./introduction.html#_introduction">Introduction</a>
+	</li>
+	<li><a href="./eclipse_setup.html#_eclipse-setup">Eclipse Setup</a>
+	</li>
+	<li><a href="./release_engineering.html#_release-engineering">Release Engineering</a>
+	</li>
+	<li><a href="./tips_and_tricks.html#_tips-and-tricks">Tips and Tricks</a>
+	</li>
+	<li><a href="./parser.html#_parser">Parser</a>
+	</li>
+	<li><a href="./type_system.html#_type-system">Type System</a>
+	</li>
+	<li><a href="./type_index.html#_type-index">Type Index</a>
+	</li>
+	<li><a href="./project_model.html#_project-model">Project Model</a>
+	</li>
+	<li><a href="./binding.html#_binding">Binding</a>
+	</li>
+	<li><a href="./validation.html#_validation">Validation</a>
+	</li>
+	<li><a href="./references.html#_references">References</a>
+	</li>
+	<li><a href="./compilation.html#_compilation">Compilation</a>
+	</li>
+	<li><a href="./execution.html#_execution">Execution</a>
+	</li>
+	<li><a href="./tests.html#_tests">Tests</a>
+	</li>
+	<li><a href="./ui_concepts.html#_ui-concepts">UI Concepts</a>
+	</li>
+	<li><a href="./formatting.html#_formatting">Formatting</a>
+	</li>
+	<li><a href="./external_libraries.html#_external-libraries">External Libraries</a>
+	</li>
+	<li><a href="./json_support.html#sec:JSON_Support">JSON Support</a>
+	</li>
+	<li><a href="./jsdoc.html#_jsdoc">JSDoc</a>
+	</li>
+	<li><a href="./docexporter.html#_docexporter">DocExporter</a>
+	</li>
+	<li><a href="./rename_refactoring.html#_rename-refactoring">Rename Refactoring</a>
+	</li>
+	<li><a href="./flow_graphs.html#chap:flowgraphs">Flow Graphs</a>
+	</li>
+	<li><a href="./publish_npms.html#sec:publish-npms-to-public">Publish npms</a>
+	</li><li>Appendix
+<ol>
+
+	<li><a href="./appendix_a_hints.html#sec:Hints">Hints</a>
+	</li>
+	<li><a href="./appendix_b_module_loading.html#_module-loading">Module Loading</a>
+	</li>
+	<li><a href="./appendix_c_license.html#sec:License">License</a></li>
+	<li><a href="./appendix_d_acronyms.html#sec:Acronyms">Acronyms</a></li>
+	<li><a href="./appendix_e_bibliography_and_footnotes.html#_bibliography-and-footnotes">Bibliography and Footnotes</a></li></ol></li>
+
+</ol></div>
+<div id="footer">
+<div id="footer-text">
+Version 0.9<br>
+Last updated 2019-08-07 15:02:40 CEST
+</div>
+</div>
+<!-- ************* docinfo-footer *************************************************************** -->
+<div class="Grid social" style="color:#d5dfea">
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <h2>Quick Links</h2>
+    <ul>
+      <li><a href="../downloads.html">Download</a></li>
+      <li><a href="../userguides/index.html">Documentation</a></li>
+      <li><a href="https://github.com/eclipse/n4js/">Source</a></li>
+      <li><a href="https://github.com/eclipse/n4js/issues">Issues</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="https://www.eclipse.org/forums/index.php/f/365/">Forum</a></li>
+      <li><a href="http://n4js.blogspot.de/">Blog</a></li>
+      <li><a href="https://dev.eclipse.org/mailman/listinfo/n4js-dev">Mailing List</a></li>
+      <li><a href="https://projects.eclipse.org/projects/technology.n4js">Eclipse Project Page</a></li>
+      <li><a href="https://twitter.com/n4jsdev">Tweets by n4jsdev</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="http://www.eclipse.org/">Eclipse Home</a></li>
+      <li><a href="http://www.eclipse.org/legal/privacy.php">Privacy Policy</a></li>
+      <li><a href="http://www.eclipse.org/legal/termsofuse.php">Terms of Use</a></li>
+      <li><a href="http://www.eclipse.org/legal/copyright.php">Copyright Agent</a></li>
+      <li><a href="http://www.eclipse.org/legal/">Legal</a></li>
+    </ul>
+  </div>
+  <div style="clear: both; height: 0; overflow: hidden;"></div>
+</div>
+
+<!-- ************* UI Scripts ************* -->
+<script type="text/javascript" src="scripts/back-to-top.js"></script>
+
+<script type="text/javascript" src="scripts/treeview.js"></script>
+<script type="text/javascript" src="scripts/toc.js"></script>
+
+<!-- ************* Prism.js Syntax Highlighting ************* -->
+<script src="scripts/prism.js"></script>
+
+<script type="text/javascript">
+	// Add the 'toclist' id for search function
+	$(".toc2 > ul").attr('id', 'toclist');
+	// Generate a Search input form
+	$("#toclist > li:first-of-type").before('<input type="text" id="pagesearch" onkeyup="search()" placeholder="Search for section...">');
+	$("#toclist > li:first-of-type").before('<i id="clear" class="fa fa-times-circle-o"></i>');
+	$("#clear").click(function(){
+	    $("#pagesearch").val('');
+	    search();
+	    $('.toc2 > ul').treeView('collapseAll');
+	});
+	// intialize Treeview.js
+	$(".toc2 > ul").treeView();
+	// Initialize Scrollspy
+</script>
+<!-- ************* docinfo-footer *************************************************************** -->
+</body>
+</html>
\ No newline at end of file
diff --git a/design/introduction.html b/design/introduction.html
new file mode 100644
index 0000000..b4446a2
--- /dev/null
+++ b/design/introduction.html
@@ -0,0 +1,1381 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="generator" content="Asciidoctor 1.5.5">
+<meta name="author" content="2019-08-07 15:02:40 CEST">
+<title>N4JS Design Specification</title>
+<link rel="stylesheet" href="styles/spec.min.css">
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.6.3/css/font-awesome.min.css">
+<!-- ************* docinfo ******************************************************************* -->
+
+
+<!-- ************* Favicon ************-->
+<link rel="icon" href="images/favicon.ico" />
+
+<!-- ************* Back-to-top JQuery ************* -->
+<script src="https://code.jquery.com/jquery-1.12.4.js"></script>
+<script src="https://code.jquery.com/ui/1.12.0/jquery-ui.js"></script>
+
+
+<link href="styles/prism.min.css" rel="stylesheet" />
+<script type="text/javascript" async
+  src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2/MathJax.js?config=TeX-MML-AM_CHTML">
+</script>
+
+<!-- ************* Styles ************* -->
+<link rel="stylesheet" type="text/css" href="styles/n4jsspec-adoc.css">
+
+
+<!-- ****************** NavBar ****************** -->
+<div id="menubar">
+	<div class="banner">
+        <a href="https://www.eclipse.org/n4js/#"><img id="logo" src="images/n4js-logo.png" alt="Eclipse N4JS"></a>
+    </div>
+<ul>
+  <li><a href="index.html">Index</a></li>
+</ul>
+</div>
+<!-- ************* docinfo ******************************************************************* -->
+<style>
+      .admonitionblock td.icon .icon-todo:before{content:"\f249";color:#f4ee42}
+    </style>
+</head>
+<body class="book toc2 toc-left">
+<div id="header">
+<h1>N4JS Design Specification</h1>
+<div class="details">
+<span id="author" class="author">2019-08-07 15:02:40 CEST</span><br>
+<span id="revnumber">version 0.9</span>
+</div>
+<div id="toc" class="toc2">
+<div id="toctitle">Table of Contents</div>
+<ul class="sectlevel1">
+<li><a href="#_introduction">1. Introduction</a>
+<ul class="sectlevel2">
+<li><a href="#notation">1.1. Notation</a></li>
+<li><a href="#sec:IDE_Overview">1.2. IDE Components</a>
+<ul class="sectlevel3">
+<li><a href="#sec:Naming_Conventions">1.2.1. Naming Conventions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="eclipse_setup.html#_eclipse-setup">2. Eclipse Setup</a>
+<ul class="sectlevel2">
+<li><a href="eclipse_setup.html#_system-requirements">2.1. System Requirements</a></li>
+<li><a href="eclipse_setup.html#_contribute">2.2. Contribute</a>
+<ul class="sectlevel3">
+<li><a href="eclipse_setup.html#_eclipse-installer">2.2.1. Eclipse Installer</a>
+<ul class="sectlevel4">
+<li><a href="eclipse_setup.html#_changing-the-setup-script">2.2.1.1. Changing the Setup Script</a></li>
+</ul>
+</li>
+<li><a href="eclipse_setup.html#_manual-ide-configuration">2.2.2. Manual IDE Configuration</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="release_engineering.html#_release-engineering">3. Release Engineering</a>
+<ul class="sectlevel2">
+<li><a href="release_engineering.html#_nightly-build-on-eclipse-infrastructure">3.1. Nightly build on Eclipse infrastructure</a></li>
+<li><a href="release_engineering.html#_build-the-n4js-ide-from-command-line">3.2. Build the N4JS IDE from command line</a>
+<ul class="sectlevel3">
+<li><a href="release_engineering.html#_publish-maven-tooling-code-org-eclipse-n4js-releng-util-code">3.2.1. Publish maven-tooling <code>org.eclipse.n4js.releng.util</code></a></li>
+<li><a href="release_engineering.html#sec:test-verdaccio">3.2.2. Test Verdaccio containing n4js-libs</a></li>
+<li><a href="release_engineering.html#_generation-of-eclipse-help-for-spec-and-design-document">3.2.3. Generation of Eclipse help for spec and design document</a></li>
+</ul>
+</li>
+<li><a href="release_engineering.html#_updating-frameworks-and-dependencies">3.3. Updating frameworks and dependencies</a>
+<ul class="sectlevel3">
+<li><a href="release_engineering.html#_update-of-eclipse-emf-xtext-etc">3.3.1. Update of Eclipse, EMF, Xtext, etc.</a></li>
+<li><a href="release_engineering.html#_update-of-the-embedded-jre">3.3.2. Update of the embedded JRE</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tips_and_tricks.html#_tips-and-tricks">4. Tips and Tricks</a>
+<ul class="sectlevel2">
+<li><a href="tips_and_tricks.html#_naming">4.1. Naming</a></li>
+<li><a href="tips_and_tricks.html#_logging">4.2. Logging</a></li>
+<li><a href="tips_and_tricks.html#_cancellation-handling">4.3. Cancellation Handling</a></li>
+<li><a href="tips_and_tricks.html#_caching">4.4. Caching</a></li>
+<li><a href="tips_and_tricks.html#_dependency-injection">4.5. Dependency Injection</a></li>
+<li><a href="tips_and_tricks.html#_miscellaneous">4.6. Miscellaneous</a></li>
+</ul>
+</li>
+<li><a href="parser.html#_parser">5. Parser</a>
+<ul class="sectlevel2">
+<li><a href="parser.html#sec:Parser_Overview">5.1. Overview</a></li>
+<li><a href="parser.html#sec:N4JS_Parser">5.2. N4JS Parser</a></li>
+<li><a href="parser.html#sec:Parser_Generation_Post_Processing">5.3. Parser Generation Post-Processing</a>
+<ul class="sectlevel3">
+<li><a href="parser.html#sec:Automatic_Semicolon_Insertion">5.3.1. Automatic Semicolon Insertion</a>
+<ul class="sectlevel4">
+<li><a href="parser.html#sec:Injected_code_in_the_Antlr_grammar_file">5.3.1.1. Injected code in the Antlr grammar file</a></li>
+<li><a href="parser.html#sec:Customized_error_recovery">5.3.1.2. Customized error recovery</a></li>
+</ul>
+</li>
+<li><a href="parser.html#sec:_No_line_terminator_allowed_here__handling">5.3.2. Async and <code>No line terminator allowed here</code> Handling</a></li>
+<li><a href="parser.html#sec:Regular_Expression">5.3.3. Regular Expression</a></li>
+<li><a href="parser.html#sec:Unicode">5.3.4. Unicode</a></li>
+<li><a href="parser.html#sec:Literals">5.3.5. Literals</a></li>
+</ul>
+</li>
+<li><a href="parser.html#sec:Modifiers">5.4. Modifiers</a></li>
+<li><a href="parser.html#sec:Conflict_Resolutions">5.5. Conflict Resolutions</a>
+<ul class="sectlevel3">
+<li><a href="parser.html#sec:Reserved_Keywords_vs__Identifier_Names">5.5.1. Reserved Keywords vs. Identifier Names</a></li>
+<li><a href="parser.html#sec:Operators_and_Generics">5.5.2. Operators and Generics</a></li>
+</ul>
+</li>
+<li><a href="parser.html#sec:Content_Assist_Parser">5.6. Content-Assist Parser</a></li>
+</ul>
+</li>
+<li><a href="type_system.html#_type-system">6. Type System</a>
+<ul class="sectlevel2">
+<li><a href="type_system.html#sec:Type_Model_and_Grammar">6.1. Type Model and Grammar</a>
+<ul class="sectlevel3">
+<li><a href="type_system.html#sec:Type_Model_Overview">6.1.1. Type Model Overview</a></li>
+<li><a href="type_system.html#sec:Built_in_Types">6.1.2. Built-in and Primitive Types</a></li>
+<li><a href="type_system.html#sec:Type_Model_DSL">6.1.3. Type Model DSL</a></li>
+</ul>
+</li>
+<li><a href="type_system.html#sec:Type_System_Implementation">6.2. Type System Implementation</a></li>
+<li><a href="type_system.html#sec:Type_Inference_combined_with_AST_Traversal">6.3. Type Inference of AST</a>
+<ul class="sectlevel3">
+<li><a href="type_system.html#sec:Type_Inference_combined_with_AST_Traversal__Background">6.3.1. Background</a></li>
+<li><a href="type_system.html#sec:Triggering_Type_Inference_of_AST">6.3.2. Triggering</a></li>
+<li><a href="type_system.html#sec:Traversal_Order_During_Type_Inference_of_AST">6.3.3. Traversal Order</a></li>
+<li><a href="type_system.html#sec:Cross_References_During_Type_Inference_of_AST">6.3.4. Cross-References</a></li>
+<li><a href="type_system.html#sec:Function_Accessor_Bodies_During_Type_Inference_of_AST">6.3.5. Function/Accessor Bodies</a></li>
+<li><a href="type_system.html#sec:Poly_Expressions_During_Type_Inference_of_AST">6.3.6. Poly Expressions</a></li>
+<li><a href="type_system.html#sec:Constraint_Solver_used_During_Type_Inference_of_AST">6.3.7. Constraint Solver</a></li>
+<li><a href="type_system.html#sec:Type_Guards_During_Type_Inference_of_AST">6.3.8. Type Guards</a></li>
+</ul>
+</li>
+<li><a href="type_system.html#sec:Structural_Typing">6.4. Structural Typing</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#_type-index">7. Type Index</a>
+<ul class="sectlevel2">
+<li><a href="type_index.html#sec:Type_Index_Design_Rationale">7.1. Design Rationale</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#sec:Getting_the_Xtext_Index_Content_IResourceDescriptions">7.1.1. Getting the Xtext Index (<code>IResourceDescriptions</code>) Content</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#sec:Design_Overview">7.2. Design Overview</a></li>
+<li><a href="type_index.html#sec:N4JS_Resource_Load_States">7.3. N4JS Resource Load States</a></li>
+<li><a href="type_index.html#sec:Type_Builder">7.4. Types Builder</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#sec:Type_Inference_not_allowed_in_Type_Builder">7.4.1. Type Inference not allowed in Types Builder</a></li>
+<li><a href="type_index.html#sec:ComputedTypeReferences">7.4.2. Deferred Type References</a></li>
+<li><a href="type_index.html#sec:Use_cases_of_ComputedTypeRef">7.4.3. Use cases of DeferredTypeRef</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#sec:Incremental_Builder_Overview">7.5. Incremental Builder (Overview)</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#sec:Incremental_Builder_Overview__XtextBuilder">7.5.1. XtextBuilder</a></li>
+<li><a href="type_index.html#sec:Incremental_Builder_Overview__IBuilderState">7.5.2. IBuilderState</a>
+<ul class="sectlevel4">
+<li><a href="type_index.html#copy-and-update-xtext-index">7.5.2.1. Copy and Update Xtext Index</a></li>
+<li><a href="type_index.html#build-state-setup-phase">7.5.2.2. Build State Setup Phase</a></li>
+<li><a href="type_index.html#process-queued-uris">7.5.2.3. Process Queued URIs</a></li>
+<li><a href="type_index.html#queueing-affected-resources">7.5.2.4. Queueing Affected Resources</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#sec:Incremental_Builder_Overview__Example">7.5.3. Example</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#dirty-state-handling">7.6. Dirty state handling</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#use-case-restoring-types-from-user-data">7.6.1. Use case: Restoring types from user data</a></li>
+<li><a href="type_index.html#use-case-updating-the-xtext-index">7.6.2. Use case: Updating the Xtext index</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="project_model.html#_project-model">8. Project Model</a>
+<ul class="sectlevel2">
+<li><a href="project_model.html#sec:Package_json">8.1. Package.json File</a></li>
+<li><a href="project_model.html#_accessing-project-information">8.2. Accessing Project Information</a>
+<ul class="sectlevel3">
+<li><a href="project_model.html#sec:IN4JSCore">8.2.1. IN4JSCore</a></li>
+<li><a href="project_model.html#sec:N4JSModel">8.2.2. N4JSModel</a></li>
+<li><a href="project_model.html#sec:N4JSWorkspace">8.2.3. N4JSWorkspace</a></li>
+<li><a href="project_model.html#sec:N4JSProject">8.2.4. N4JSProject</a></li>
+<li><a href="project_model.html#sec:SourceContainer">8.2.5. SourceContainer</a></li>
+<li><a href="project_model.html#sec:N4JSProjectsStateHelper">8.2.6. N4JSProjectsStateHelper</a></li>
+</ul>
+</li>
+<li><a href="project_model.html#sec:Caching">8.3. Caching</a>
+<ul class="sectlevel3">
+<li><a href="project_model.html#_caching-of-externallibraryworkspace">8.3.1. Caching of ExternalLibraryWorkspace</a></li>
+<li><a href="project_model.html#_caching-of-n4jsprojectsstatehelper">8.3.2. Caching of N4JSProjectsStateHelper</a></li>
+</ul>
+</li>
+<li><a href="project_model.html#sec:WildcardPathFilter">8.4. WildcardPathFilter</a></li>
+<li><a href="project_model.html#sec:ProjectUtils">8.5. ProjectUtils</a></li>
+</ul>
+</li>
+<li><a href="binding.html#_binding">9. Binding</a>
+<ul class="sectlevel2">
+<li><a href="binding.html#sec:Binding_Design_Rationale">9.1. Design Rationale</a></li>
+<li><a href="binding.html#sec:Binding_to_Members">9.2. Binding to Members</a></li>
+<li><a href="binding.html#sec:Binding_Getter_Setter">9.3. Getter / Setter Binding</a></li>
+<li><a href="binding.html#chap:Statics">9.4. Static Member Binding</a></li>
+<li><a href="binding.html#sec:Binding_Enumeration">9.5. Enumeration Literals Binding</a></li>
+<li><a href="binding.html#sec:Accessibility_of_types_and_members">9.6. Accessibility of types and members</a></li>
+<li><a href="binding.html#sec:Member_Scope_Example">9.7. Member Scope Example</a></li>
+<li><a href="binding.html#sec:Scoping_for_Members_of_Composed_Type_Explained">9.8. Scoping for Members of Composed Type (Union/Intersection) Example</a></li>
+<li><a href="binding.html#sec:Binding_of_Structurally_References_Types">9.9. Structurally References Types</a></li>
+<li><a href="binding.html#sec:Building">9.10. Building</a>
+<ul class="sectlevel3">
+<li><a href="binding.html#sec:Build_Phases">9.10.1. Build Phases</a></li>
+<li><a href="binding.html#sec:Build_Scenarios">9.10.2. Build Scenarios</a></li>
+<li><a href="binding.html#sec:Lazy_linking_problem">9.10.3. Lazy linking problem</a></li>
+</ul>
+</li>
+<li><a href="binding.html#sec:Proxies_and_Proxy_Resolution">9.11. Proxies and Proxy Resolution (Overview)</a>
+<ul class="sectlevel3">
+<li><a href="binding.html#xtexts-lazy-linking-proxies">9.11.1. Xtext’s Lazy Linking Proxies</a></li>
+<li><a href="binding.html#standard-emf-proxies">9.11.2. Standard EMF Proxies</a></li>
+<li><a href="binding.html#_how-is-proxy-resolution-triggered">9.11.3. How is Proxy Resolution Triggered?</a></li>
+<li><a href="binding.html#_when-is-proxy-resolution-allowed">9.11.4. When is Proxy Resolution Allowed?</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="validation.html#_validation">10. Validation</a>
+<ul class="sectlevel2">
+<li><a href="validation.html#sec:validation_overview">10.1. Validation overview</a></li>
+<li><a href="validation.html#sec:validation_control_flow">10.2. Validation control flow</a></li>
+<li><a href="validation.html#sec:validation_issue_ids">10.3. Issue IDs and Messages</a></li>
+<li><a href="validation.html#sec:validation_usage_patterns">10.4. Usage Pattern</a></li>
+<li><a href="validation.html#sec:validation_links">10.5. Links</a></li>
+</ul>
+</li>
+<li><a href="references.html#_references">11. References</a>
+<ul class="sectlevel2">
+<li><a href="references.html#sec:usecases">11.1. Use cases</a></li>
+<li><a href="references.html#sec:calculation_algorithm">11.2. Calculation algorithm</a>
+<ul class="sectlevel3">
+<li><a href="references.html#sec:Xtext_default_implementation">11.2.1. Xtext default implementation</a></li>
+<li><a href="references.html#sec:N4_implementation">11.2.2. N4JS implementation</a></li>
+</ul>
+</li>
+<li><a href="references.html#sec:PerformanceOfDependencyCalculation">11.3. Performance Of Dependency Calculation</a></li>
+<li><a href="references.html#sec:kinds_of_references">11.4. Kinds of references</a>
+<ul class="sectlevel3">
+<li><a href="references.html#sec:Cross_References_to_be_ignored">11.4.1. Cross References to be ignored</a></li>
+<li><a href="references.html#sec:Cross_References_to_be_handled">11.4.2. Cross References to be handled</a></li>
+</ul>
+</li>
+<li><a href="references.html#sec:transitive_dependencies">11.5. Transitive dependencies</a></li>
+<li><a href="references.html#sec:find-references">11.6. Find references</a>
+<ul class="sectlevel3">
+<li><a href="references.html#_background">11.6.1. Background</a></li>
+<li><a href="references.html#_how-find-references-work">11.6.2. How Find References Work</a>
+<ul class="sectlevel4">
+<li><a href="references.html#_step-1-convert-cursor-position-to-declared-element">11.6.2.1. Step 1: Convert Cursor Position to Declared Element</a></li>
+<li><a href="references.html#_step-2-convert-declared-element-to-target-uris">11.6.2.2. Step 2: Convert Declared Element to Target URIs</a></li>
+<li><a href="references.html#_step-3-filter-potential-resources">11.6.2.3. Step 3: Filter Potential Resources</a></li>
+<li><a href="references.html#_step-4-search-references-in-resource">11.6.2.4. Step 4: Search References in Resource</a></li>
+<li><a href="references.html#_limitations-and-possible-enhancements">11.6.2.5. Limitations and Possible Enhancements</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="compilation.html#_compilation">12. Compilation</a>
+<ul class="sectlevel2">
+<li><a href="compilation.html#chap:compilation">12.1. Introduction</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:general_design_rationals">12.1.1. General design rationals</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:logging_and_error_reporting">12.1.1.1. Logging and error reporting</a></li>
+<li><a href="compilation.html#sec:progress_monitor">12.1.1.2. Progress monitor</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Xtext_Integration">12.1.2. Xtext Integration</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:xtext_default_behaviour">12.1.2.1. Xtext default behaviour</a></li>
+<li><a href="compilation.html#sec:n4js_requirements">12.1.2.2. N4JS requirements</a></li>
+<li><a href="compilation.html#sec:compiler_discovery_in_ui">12.1.2.3. Compiler discovery in UI</a></li>
+<li><a href="compilation.html#sec:compiler_discovery_in_headless">12.1.2.4. Compiler discovery in headless</a></li>
+<li><a href="compilation.html#sec:general_generator_implementation">12.1.2.5. General generator implementation</a></li>
+<li><a href="compilation.html#sec:general_generator_activation">12.1.2.6. General generator activation</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Overview_of_Input_Models">12.1.3. Overview of the Input Models</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Core_Generator">12.2. Generators</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:Compiler_Components">12.2.1. Generator Components</a></li>
+<li><a href="compilation.html#sec:Generator_architecture">12.2.2. Generator architecture</a></li>
+<li><a href="compilation.html#sec:Unified_Compiler_Configuration">12.2.3. Unified Compiler Configuration</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Transpilers">12.3. Transpilers</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:Phases">12.3.1. Overview</a></li>
+<li><a href="compilation.html#relation-between-ast-and-im">12.3.2. Relation between AST and IM</a></li>
+<li><a href="compilation.html#implementation-overview">12.3.3. Implementation Overview</a></li>
+<li><a href="compilation.html#sec:Guidelines_for_Implementing_Transformations">12.3.4. Guidelines for Implementing Transformations</a></li>
+<li><a href="compilation.html#symbol-table-in-the-im">12.3.5. Symbol Table in the IM</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:N4JS_to_EcmaScript_Transpiler">12.4. N4JS-to-EcmaScript Transpiler</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:Overview_of_Transformations">12.4.1. Overview of Transformations</a></li>
+<li><a href="compilation.html#sec:Transpiling_members">12.4.2. Transpiling members</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:Transpiling_members__Delegating_members">12.4.2.1. Techniques for special member handling</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__Partial_shadowing_of_getter_setter_pairs">12.4.2.2. Partial shadowing</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__Consuming_or_inheriting_members_of_an_interface">12.4.2.3. Consuming or inheriting members of an interface</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__Static_polyfill">12.4.2.4. Static polyfill</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__API_implementation_stubs">12.4.2.5. API / implementation stubs</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Support_for_incomplete_API_implementation_testing_in_the_N4JS_to_EcmaScript_5_Transpiler">12.4.3. Support for incomplete API implementation testing</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:Modifications_in_Impl_projects">12.4.3.1. Modifications in Impl projects</a></li>
+<li><a href="compilation.html#sec:Implementation_of_stub_generation">12.4.3.2. Implementation of stub-generation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:n4jsc_Headless_Compiler_Interface">12.5. n4jsc Headless Compiler Interface</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:building_the_headless_compiler">12.5.1. building the headless compiler</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="execution.html#_execution">13. Execution</a>
+<ul class="sectlevel2">
+<li><a href="execution.html#sec:N4JS_Project_Execution_And_Linking_Model">13.1. N4JS Project Execution And Linking Model</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#subsec:N4JS_Execution_With_NodeJS">13.1.1. N4JS Execution With NodeJS</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:N4JS_Execution_And_Linking_File">13.2. N4JS Execution And Linking File</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#subsec:NodeJS_Specific_ELF">13.2.1. NodeJS Specific ELF</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Runners-execution">13.3. Runners</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#subsec:N4_Runtime_Environments_Convention">13.3.1. N4 Runtime Environments Convention</a></li>
+<li><a href="execution.html#subsec:Passing_Information_from_IDE_to_Execution_Code_in_Runtime_Environment">13.3.2. Passing Information from IDE to Execution Code in Runtime Environment</a></li>
+<li><a href="execution.html#subsec:Runners_Design">13.3.3. Runners Design</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Legacy_Execution_Engine">13.4. Legacy Execution Engine</a></li>
+<li><a href="execution.html#sec:Design">13.5. Design</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#sec:Usage_Outside_N4JSIDE">13.5.1. Usage Outside N4JSIDE</a>
+<ul class="sectlevel4">
+<li><a href="execution.html#sec:Use_Node_with_Maven">13.5.1.1. Use Node with Maven</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Usage_Inside_N4JSIDE">13.5.2. Usage Inside N4JSIDE</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Runtime_Injection">13.6. Runtime Injection</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#sec:Running_String_Code">13.6.1. Running String Code</a></li>
+<li><a href="execution.html#sec:Running_File_Code">13.6.2. Running File Code</a></li>
+<li><a href="execution.html#sec:Injection_Code_Example">13.6.3. Injection Code Example</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#_tests">14. Tests</a>
+<ul class="sectlevel2">
+<li><a href="tests.html#sec:Performance_Tests">14.1. Performance Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Synthetic_Performance_Tests">14.1.1. Synthetic Performance Tests</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:Design_of_Generator">14.1.1.1. Design of Generator</a></li>
+<li><a href="tests.html#sec:Design_of_Performance_Test_Execution">14.1.1.2. Design of Performance Test Configuration and Execution</a></li>
+<li><a href="tests.html#sec:JUnit_Configuration">14.1.1.3. JUnit Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Test_Configuration">14.1.1.4. JUnitBenchmark Test Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Report_Configuration">14.1.1.5. JUnitBenchmark Report Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Run_Configuration">14.1.1.6. JUnitBenchmark Run Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Example">14.1.1.7. JUnitBenchmark Example</a></li>
+<li><a href="tests.html#sec:Note_on_Jenkins_Job">14.1.1.8. Note on Jenkins Job</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#sec:ECMA_Tests">14.2. ECMA Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Grammar_Tests">14.2.1. Grammar Tests</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:Negative_Tests">14.2.1.1. Negative Tests</a></li>
+<li><a href="tests.html#sec:Test_Exclusion">14.2.1.2. Test Exclusion</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Integration_Tests">14.3. Integration Tests</a></li>
+<li><a href="tests.html#sec:Test_Helpers">14.4. Test Helpers</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Parameterized_N4JS_Tests">14.4.1. Parameterized N4JS tests</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:ParameterizedXtextRunner">14.4.1.1. ParameterizedXtextRunner</a></li>
+<li><a href="tests.html#sec:TestCodeProvider">14.4.1.2. TestCodeProvider</a></li>
+<li><a href="tests.html#sec:Example_Of_Parameterized_Parser_Test">14.4.1.3. Example of parameterized parser test</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Issue_Suppression">14.5. Issue Suppression</a></li>
+<li><a href="tests.html#sec:Xpect_Tests">14.6. Xpect Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Xpect_Test_Setup">14.6.1. Xpect Test Setup</a></li>
+<li><a href="tests.html#sec:Xpect_Issue_Suppression">14.6.2. Xpect Issue Suppression</a></li>
+<li><a href="tests.html#sec:Xpect_Provided_Test_Methods">14.6.3. Xpect Provided Test Methods</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#errors">14.6.3.1. errors</a></li>
+<li><a href="tests.html#warnings">14.6.3.2. warnings</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:N4JS_Specific_Xpect_Test_Methods">14.6.4. N4JS Specific Xpect Test Methods</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:XPECT_noerrors">14.6.4.1. noerrors and nowarnings</a></li>
+<li><a href="tests.html#sec:XPECT_scope">14.6.4.2. scope</a></li>
+<li><a href="tests.html#sec:XPECT_scopeWithPosition">14.6.4.3. scopeWithPosition</a></li>
+<li><a href="tests.html#sec:XPECT_scopeWithResource">14.6.4.4. scopeWithResource</a></li>
+<li><a href="tests.html#sec:XPECT_binding">14.6.4.5. binding</a></li>
+<li><a href="tests.html#sec:XPECT_linkedPathname">14.6.4.6. linkedPathname</a></li>
+<li><a href="tests.html#sec:XPECT_type_of">14.6.4.7. type of</a></li>
+<li><a href="tests.html#sec:XPECT_expectedType">14.6.4.8. expectedType</a></li>
+<li><a href="tests.html#sec:XPECT_elementKeyword">14.6.4.9. elementKeyword</a></li>
+<li><a href="tests.html#sec:XPECT_accessModifier">14.6.4.10. accessModifier</a></li>
+<li><a href="tests.html#sec:XPECT_compileResult">14.6.4.11. compileResult</a></li>
+<li><a href="tests.html#sec:XPECT_output">14.6.4.12. output</a></li>
+<li><a href="tests.html#sec:XPECT_outputRegEx">14.6.4.13. outputRegEx</a></li>
+<li><a href="tests.html#sec:XPECT_calculatedAccessModifier">14.6.4.14. calculatedAccessModifier</a></li>
+<li><a href="tests.html#sec:XPECT_spec">14.6.4.15. spec</a></li>
+<li><a href="tests.html#sec:XPECT_deadCode">14.6.4.16. deadCode</a></li>
+<li><a href="tests.html#sec:XPECT_returnOrThrows">14.6.4.17. returnOrThrows</a></li>
+<li><a href="tests.html#sec:XPECT_lint">14.6.4.18. lint</a></li>
+<li><a href="tests.html#sec:XPECT_lintFails">14.6.4.19. lintFails</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:FIXME_Xpect_modifier">14.6.5. FIXME Xpect modifier</a></li>
+<li><a href="tests.html#sec:Expectmatrix_Xpect_Test_Methods">14.6.6. Expectmatrix Xpect tests</a></li>
+<li><a href="tests.html#xpect-lint-tests">14.6.7. Xpect Lint Tests</a></li>
+</ul>
+</li>
+<li><a href="tests.html#xpect-proposal-tests">14.7. Xpect Proposal Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Validation_vs__Non_Validation">14.7.1. Validation vs. Non-Validation</a></li>
+<li><a href="tests.html#sec:General_Proposal_Test_Features">14.7.2. General Proposal Test Features</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:Test_Variables">14.7.2.1. Test Variables</a></li>
+<li><a href="tests.html#sec:Location_and_Selection">14.7.2.2. at – Location and Selection</a></li>
+<li><a href="tests.html#sec:Multi_Line_Expectations_in_Proposal_Tests">14.7.2.3. Multi Line Expectations in Proposal Tests</a></li>
+<li><a href="tests.html#sec:Timeout">14.7.2.4. Timeout and Performance</a></li>
+</ul>
+</li>
+<li><a href="tests.html#proposals-verify-existence-of-proposals">14.7.3. proposals – Verify Existence of Proposals</a></li>
+<li><a href="tests.html#sec:Verify_displayed_string">14.7.4. display – Verify displayed string</a></li>
+<li><a href="tests.html#sec:Apply_Proposal">14.7.5. apply – Apply Proposal</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#resource-application-in-other-files">14.7.5.1. resource – application in other files</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Content_Assist_Cycling">14.7.6. kind – Content Assist Cycling</a></li>
+<li><a href="tests.html#fileValidVerify-validation-status">14.7.7. fileValid – Verify validation status</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Apply_Proposal_And_Execute_Tests">14.8. Apply Proposal And Execute Tests</a></li>
+<li><a href="tests.html#sec:Organize_Imports_Test">14.9. Organize Imports Test</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#organizeimports">14.9.1. organizeImports</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Access_Control_Test">14.10. Access Control Test</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#test-scenarios">14.10.1. Test Scenarios</a></li>
+<li><a href="tests.html#n4js-code-generator">14.10.2. N4JS Code Generator</a></li>
+<li><a href="tests.html#xtext-issue-matcher">14.10.3. Xtext Issue Matcher</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Smoke_Tests">14.11. Smoke Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#how-to-handle-smoke-test-errors">14.11.1. How to handle smoke test errors?</a></li>
+<li><a href="tests.html#smoketester-and-exceptionanalyzer">14.11.2. SmokeTester and ExceptionAnalyzer</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:UI_Tests_with_SWTBot">14.12. UI Tests with SWTBot</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#writing-swtbot-tests">14.12.1. Writing SWTBot Tests</a></li>
+<li><a href="tests.html#running-swtbot-tests">14.12.2. Running SWTBot Tests</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Debugging_UI_Tests">14.13. Debugging UI Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Connecting_to_the_X_server_on_the_build_node">14.13.1. Connecting to the X-server on the build-node</a></li>
+<li><a href="tests.html#sec:Tools_to_investigate_the_java_stack">14.13.2. Tools to investigate the java-stack</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="ui_concepts.html#_ui-concepts">15. UI Concepts</a>
+<ul class="sectlevel2">
+<li><a href="ui_concepts.html#sec:User_Interface_Concepts">15.1. User Interface Concepts</a>
+<ul class="sectlevel3">
+<li><a href="ui_concepts.html#sec:Eclipse_UI_Concepts">15.1.1. Eclipse UI Concepts</a>
+<ul class="sectlevel4">
+<li><a href="ui_concepts.html#sec:Label_Provider">15.1.1.1. Label Provider</a></li>
+<li><a href="ui_concepts.html#sec:Markers">15.1.1.2. Markers</a></li>
+<li><a href="ui_concepts.html#sec:Commands__Toolbar_and_Menus">15.1.1.3. Commands, Toolbar and Menus</a></li>
+<li><a href="ui_concepts.html#sec:Content_Assist">15.1.1.4. Content Assist</a></li>
+<li><a href="ui_concepts.html#sec:Quick_Fixes">15.1.1.5. Quick Fixes</a></li>
+<li><a href="ui_concepts.html#sec:Quick_Assist">15.1.1.6. Quick Assist</a></li>
+<li><a href="ui_concepts.html#sec:Clean_Up_Actions">15.1.1.7. Clean Up Actions</a></li>
+<li><a href="ui_concepts.html#sec:Save_Actions">15.1.1.8. Save Actions</a></li>
+<li><a href="ui_concepts.html#sec:Auto_Edit">15.1.1.9. Auto Edit</a></li>
+<li><a href="ui_concepts.html#sec:Template_Proposals">15.1.1.10. Template Proposals</a></li>
+<li><a href="ui_concepts.html#sec:Outline_View___Quick_Outline">15.1.1.11. Outline View / Quick Outline</a></li>
+<li><a href="ui_concepts.html#sec:Navigator__Package_Explorer__Project_Explorer">15.1.1.12. Navigator, Package Explorer, Project Explorer</a></li>
+<li><a href="ui_concepts.html#sec:Hyperlinking_and_Navigation">15.1.1.13. Hyperlinking and Navigation</a></li>
+<li><a href="ui_concepts.html#sec:Syntax_and_Semantic_Coloring">15.1.1.14. Syntax and Semantic Coloring</a></li>
+<li><a href="ui_concepts.html#sec:Code_Formatter">15.1.1.15. Code Formatter</a></li>
+<li><a href="ui_concepts.html#sec:Wizards">15.1.1.16. Wizards</a></li>
+<li><a href="ui_concepts.html#sec:Cheat_Sheets">15.1.1.17. Cheat Sheets</a></li>
+<li><a href="ui_concepts.html#sec:Context_sensitive_Help">15.1.1.18. Context-sensitive Help</a></li>
+<li><a href="ui_concepts.html#sec:Hovers">15.1.1.19. Hovers</a></li>
+<li><a href="ui_concepts.html#sec:Folding">15.1.1.20. Folding</a></li>
+<li><a href="ui_concepts.html#sec:Customizable_validation___severity">15.1.1.21. Customizable validation / severity</a></li>
+<li><a href="ui_concepts.html#sec:Proposals">15.1.1.22. Proposals</a></li>
+</ul>
+</li>
+<li><a href="ui_concepts.html#sec:Non_Eclipse_UI_Concepts">15.1.2. Non-Eclipse UI Concepts</a>
+<ul class="sectlevel4">
+<li><a href="ui_concepts.html#sec:Overlays">15.1.2.1. Overlays</a></li>
+<li><a href="ui_concepts.html#sec:Goto__Inferred__Type">15.1.2.2. Goto (Inferred) Type</a></li>
+<li><a href="ui_concepts.html#sec:Postfix_Completion">15.1.2.3. Postfix Completion</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="ui_concepts.html#_user-interface-resources">15.2. User Interface Resources</a>
+<ul class="sectlevel3">
+<li><a href="ui_concepts.html#_icons">15.2.1. Icons</a>
+<ul class="sectlevel4">
+<li><a href="ui_concepts.html#_eclipse-platform-icons">15.2.1.1. Eclipse Platform Icons</a></li>
+<li><a href="ui_concepts.html#_n4js-specific-icons">15.2.1.2. N4JS Specific Icons</a></li>
+<li><a href="ui_concepts.html#_high-resolution-icons">15.2.1.3. High Resolution Icons</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="formatting.html#_formatting">16. Formatting</a>
+<ul class="sectlevel2">
+<li><a href="formatting.html#sec:FmtObjective">16.1. Objective</a>
+<ul class="sectlevel3">
+<li><a href="formatting.html#sec:FmtFormatting_Comments">16.1.1. Formatting Comments</a></li>
+</ul>
+</li>
+<li><a href="formatting.html#sec:FmtArchitecture">16.2. Architecture</a>
+<ul class="sectlevel3">
+<li><a href="formatting.html#sec:Implementation_example">16.2.1. Implementation example</a></li>
+</ul>
+</li>
+<li><a href="formatting.html#sec:FmtFormatter_Implementation_Guidelines">16.3. Formatter Implementation Guidelines</a></li>
+<li><a href="formatting.html#sec:FmtConfiguration">16.4. Configuration</a></li>
+<li><a href="formatting.html#sec:FmtUI_Integration">16.5. UI Integration</a></li>
+<li><a href="formatting.html#sec:FmtUnit_Testing_with_Xpect">16.6. Unit Testing with Xpect</a></li>
+</ul>
+</li>
+<li><a href="external_libraries.html#_external-libraries">17. External Libraries</a>
+<ul class="sectlevel2">
+<li><a href="external_libraries.html#sec:Major_Components">17.1. Major Components</a>
+<ul class="sectlevel3">
+<li><a href="external_libraries.html#subsec:External_Resources">17.1.1. External Resources</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Workspace">17.1.2. External Library Workspace</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Preference_Store">17.1.3. External Library Preference Store</a></li>
+<li><a href="external_libraries.html#subsec:npm_Manager">17.1.4. Library Manager</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Builder_Helper">17.1.5. External Library Builder</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Xtext_Index_Persister">17.1.6. External Library Xtext Index Persister</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Preference_Page">17.1.7. External Library Preference Page</a></li>
+</ul>
+</li>
+<li><a href="external_libraries.html#sec:Headless_External_Library_Support">17.2. Headless External Library Support</a>
+<ul class="sectlevel3">
+<li><a href="external_libraries.html#_custom-npm-settings">17.2.1. Custom npm settings</a></li>
+</ul>
+</li>
+<li><a href="external_libraries.html#sec:lmFutureWork">17.3. Future Work</a>
+<ul class="sectlevel3">
+<li><a href="external_libraries.html#subsec:lmMultipleDependencyScope">17.3.1. Multiple Dependency Scope</a></li>
+<li><a href="external_libraries.html#subsec:lmRunTestsFromLibrary">17.3.2. Run Tests from TestLibrary</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="json_support.html#sec:JSON_Support">18. JSON Support</a>
+<ul class="sectlevel2">
+<li><a href="json_support.html#sec:JSON_Parser">18.1. JSON Parser</a>
+<ul class="sectlevel3">
+<li><a href="json_support.html#sec:JSON_Parser_Unicode_Escaping">18.1.1. Escaping Unicode Control Characters in String Literals</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Empty_Text">18.1.2. Empty Text</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Nested_Structures">18.1.3. Nested Structures</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Whitespace">18.1.4. Whitespace</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Comments">18.1.5. Comments</a></li>
+</ul>
+</li>
+<li><a href="json_support.html#sec:JSON_Language_Extensions">18.2. JSON Language Extensions</a>
+<ul class="sectlevel3">
+<li><a href="json_support.html#sec:JSON_Validator_Extensions">18.2.1. JSON Validator Extensions</a>
+<ul class="sectlevel4">
+<li><a href="json_support.html#sec:File_Specitic_Validator_Extensions">18.2.1.1. File-Specific Validator Extensions</a></li>
+<li><a href="json_support.html#sec:JSON_Declarative_JSON_Validator_Extensions">18.2.1.2. Declarative JSON Validator Extensions</a></li>
+</ul>
+</li>
+<li><a href="json_support.html#_json-resource-description-strategy">18.2.2. JSON Resource Description Strategy</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_jsdoc">19. JSDoc</a>
+<ul class="sectlevel2">
+<li><a href="jsdoc.html#sec:Design_Rationale">19.1. Design Rationale</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#_general-design">19.1.1. General Design</a></li>
+<li><a href="jsdoc.html#sec:Type_Expressions">19.1.2. Type Expressions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="docexporter.html#_docexporter">20. DocExporter</a>
+<ul class="sectlevel2">
+<li><a href="docexporter.html#sec:Specification_Exporter">20.1. Specification Exporter</a></li>
+</ul>
+</li>
+<li><a href="rename_refactoring.html#_rename-refactoring">21. Rename Refactoring</a>
+<ul class="sectlevel2">
+<li><a href="rename_refactoring.html#_rename-refactoring-ui-interaction">21.1. Rename Refactoring UI interaction</a></li>
+<li><a href="rename_refactoring.html#_renameelementprocessor-interaction">21.2. RenameElementProcessor interaction</a></li>
+</ul>
+</li>
+<li><a href="flow_graphs.html#chap:flowgraphs">22. Flow Graphs</a>
+<ul class="sectlevel2">
+<li><a href="flow_graphs.html#sec:flowgraphs_overview">22.1. Flow graphs overview</a>
+<ul class="sectlevel3">
+<li><a href="flow_graphs.html#_internal-graph">22.1.1. Internal graph</a></li>
+<li><a href="flow_graphs.html#_optimizations">22.1.2. Optimizations</a></li>
+<li><a href="flow_graphs.html#_api-for-client-analyses">22.1.3. API for client analyses</a>
+<ul class="sectlevel4">
+<li><a href="flow_graphs.html#_mapping-from-internal-to-ast-elements">22.1.3.1. Mapping from internal to AST elements</a></li>
+<li><a href="flow_graphs.html#_graph-visitor">22.1.3.2. Graph visitor</a></li>
+<li><a href="flow_graphs.html#_graph-explorer">22.1.3.3. Graph explorer</a></li>
+<li><a href="flow_graphs.html#_branch-walker">22.1.3.4. Branch walker</a></li>
+<li><a href="flow_graphs.html#_example-1-compute-string-for-each-path">22.1.3.5. Example 1: Compute string for each path</a></li>
+<li><a href="flow_graphs.html#_path-quantor">22.1.3.6. Path quantor</a></li>
+</ul>
+</li>
+<li><a href="flow_graphs.html#_control-flow-analyses">22.1.4. Control flow analyses</a>
+<ul class="sectlevel4">
+<li><a href="flow_graphs.html#_dead-code-analysis">22.1.4.1. Dead code analysis</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="flow_graphs.html#sec:dataflow">22.2. Dataflow</a>
+<ul class="sectlevel3">
+<li><a href="flow_graphs.html#_dataflow-graph">22.2.1. Dataflow graph</a></li>
+<li><a href="flow_graphs.html#_dataflow-analyses">22.2.2. Dataflow analyses</a>
+<ul class="sectlevel4">
+<li><a href="flow_graphs.html#_def-def-def-nothing-analysis">22.2.2.1. Def&#8594;Def / Def&#8594;Nothing analysis</a></li>
+<li><a href="flow_graphs.html#_def-use-decl-analysis">22.2.2.2. Def|Use&#8592;Decl analysis</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="publish_npms.html#sec:publish-npms-to-public">23. Publish npms</a>
+<ul class="sectlevel2">
+<li><a href="publish_npms.html#sec:publish-npms-n4js-maven">23.1. Publish n4js-libs to during  maven build</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Hints">Appendix A: Hints</a>
+<ul class="sectlevel2">
+<li><a href="appendix_a_hints.html#sec:XtextInjection">A.1. Xtext Injection</a>
+<ul class="sectlevel3">
+<li><a href="appendix_a_hints.html#sec:DI_MultipleInjectors_Singletons">A.1.1. Multiple Injectors and Singletons</a>
+<ul class="sectlevel4">
+<li><a href="appendix_a_hints.html#sec:DI_avoid_duplicate_singletons">A.1.1.1. Avoiding duplicate singletons</a>
+<ul class="sectlevel5">
+<li><a href="appendix_a_hints.html#sec:DI_binding_in_shared">A.1.1.1.1. Defining binding in the shared injector</a></li>
+<li><a href="appendix_a_hints.html#sec:DI_binding_in_custom">A.1.1.1.2. Defining binding in the custom injector</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:DI_Hints">A.1.2. Dependency Injection Hints</a>
+<ul class="sectlevel4">
+<li><a href="appendix_a_hints.html#sec:DI_custom_bundle">A.1.2.1. Use DI in custom bundle, use DI with extensions</a>
+<ul class="sectlevel5">
+<li><a href="appendix_a_hints.html#sec:DI_custom_bundle_problem">A.1.2.1.1. Problem</a></li>
+<li><a href="appendix_a_hints.html#sec:DI_custom_bundle_solution">A.1.2.1.2. Solution</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Access_Other_DSL_Injector">A.1.2.2. How do I get the Guice Injector of my language?</a>
+<ul class="sectlevel5">
+<li><a href="appendix_a_hints.html#sec:DSL_Injector_UI_context">A.1.2.2.1. UI context</a></li>
+<li><a href="appendix_a_hints.html#sec:DSL_Injector_Non_UI_context">A.1.2.2.2. Non UI context but with injection context</a></li>
+<li><a href="appendix_a_hints.html#sec:DSL_Injector_Non_UI_non_injection_context">A.1.2.2.3. Non UI context without injection context</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Cancel_Indicator">A.1.2.3. How do I get cancel indicators in different contexts?</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Eclipse">A.2. Eclipse</a>
+<ul class="sectlevel3">
+<li><a href="appendix_a_hints.html#sec:Show_Xtext_Index">A.2.1. Show the current Xtext index</a></li>
+<li><a href="appendix_a_hints.html#sec:Plugin_spy">A.2.2. Plug-in spy</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Maven-hints">A.3. Maven</a>
+<ul class="sectlevel3">
+<li><a href="appendix_a_hints.html#how-to-check-for-maven-mojo-updates">A.3.1. How to check for Maven MOJO updates</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#_module-loading">Appendix B: Module Loading</a>
+<ul class="sectlevel2">
+<li><a href="appendix_b_module_loading.html#sec:Dependency_Management">B.1. Dependency Management</a></li>
+<li><a href="appendix_b_module_loading.html#ecmascript-modules">B.2. ECMAScript Modules</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:ES5_Modules_Systems">B.2.1. ES5 Modules Systems</a></li>
+<li><a href="appendix_b_module_loading.html#sec:ES6_Modules">B.2.2. ES6 Modules</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:ECMAScript_Module_Loaders">B.3. ECMAScript Module Loaders</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:ES6_Module_Loaders">B.3.1. ES6 Module Loaders</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Polyfills_for_ES6_Module_Loaders">B.3.2. Polyfills for ES6 Module Loaders</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:es6_module_loader">B.3.2.1. es6-module-loader</a></li>
+<li><a href="appendix_b_module_loading.html#sec:SystemJS">B.3.2.2. SystemJS</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Demo">B.3.2.3. Demo</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#case-study-typescript">B.4. Case Study : TypeScript</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:ES6_Modules_Support">B.4.1. ES6 Modules Support</a></li>
+<li><a href="appendix_b_module_loading.html#sec:TypeScript_and_Module_Loading">B.4.2. TypeScript and Module Loading</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Cyclic_Dependencies">B.5. Cyclic Dependencies</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:Setup">B.5.1. Setup</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Transpile_and_Execute">B.5.2. Transpile and Execute</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Module_Format___AMD">B.5.2.1. Module Format = AMD</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Module_Format___CommonJS">B.5.2.2. Module Format = CommonJS</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Module_Format___SystemJS">B.5.2.3. Module Format = SystemJS</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Conclusion">B.5.3. Conclusion</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#system.register-as-transpilation-target">B.6. System.register as transpilation target</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:Introduction">B.6.1. Introduction</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:External_Transpilers">B.6.1.1. External Transpilers</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Example_of_a_System_register_module">B.6.1.2. Example of a System.register module</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Structure_of_a_System_register_module">B.6.2. Structure of a System.register module</a></li>
+<li><a href="appendix_b_module_loading.html#_transpilation-hints">B.6.3. Transpilation Hints</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Handling_Imports">B.6.3.1. Handling Imports</a></li>
+<li><a href="appendix_b_module_loading.html#sec:__exportFn__">B.6.3.2. &lt;&lt;exportFn&gt;&gt;</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Handling_Exports">B.6.3.3. Handling Exports</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Examples_w__Circular_Dependencies">B.6.4. Examples w/ Circular Dependencies</a></li>
+<li><a href="appendix_b_module_loading.html#sec:N4JS_Examples_w__Circular_Dependencies">B.6.5. N4JS Examples w/ Circular Dependencies</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Unresolved_Cyclic_Dependencies">B.6.5.1. Unresolved Cyclic Dependencies</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Variables___Functions">B.6.5.2. Examples with Variables &amp; Functions</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Classes">B.6.5.3. Examples with Classes</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Examples_with_SubClassing">B.6.5.4. Examples with SubClassing</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Miscellaneous">B.6.5.5. Miscellaneous</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#_resources">B.6.6. Resources</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:CommonJS_as_transpilation_target">B.7. CommonJS as transpilation target</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#_introduction-2">B.7.1. Introduction</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Transpilation_Hints">B.7.2. Transpilation Hints</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Import_Statements">B.7.2.1. Import Statements</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Export_Statements">B.7.2.2. Export Statements</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Tracking_Live_Bindings">B.7.2.3. Tracking Live Bindings</a></li>
+<li><a href="appendix_b_module_loading.html#sec:A_complete_example">B.7.2.4. A complete example</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#_resources-2">B.7.3. Resources</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_c_license.html#sec:License">Appendix C: License</a></li>
+<li><a href="appendix_d_acronyms.html#sec:Acronyms">Appendix D: Acronyms</a></li>
+<li><a href="appendix_e_bibliography_and_footnotes.html#_bibliography-and-footnotes">Appendix E: Bibliography and Footnotes</a></li>
+</ul>
+</div>
+</div>
+<div id="content"><div class="sect1">
+<h2 id="_introduction"><a class="anchor" href="#_introduction"></a><a class="link" href="#_introduction">1. Introduction</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>This document describes design aspects of the N4JS compiler and IDE. It relies on the following N4JS related specifications:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>N4JS Language Specification [<a href="appendix_e_bibliography_and_footnotes.html#N4JSSpec">N4JSSpec</a>]</p>
+</li>
+</ul>
+</div>
+<div class="sect2">
+<h3 id="notation"><a class="anchor" href="#notation"></a><a class="link" href="#notation">1.1. Notation</a></h3>
+<div class="paragraph">
+<p>We reuse the notation specified in [<a href="appendix_e_bibliography_and_footnotes.html#N4JSSpec">N4JSSpec</a>].</p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="sec:IDE_Overview"><a class="anchor" href="#sec:IDE_Overview"></a><a class="link" href="#sec:IDE_Overview">1.2. IDE Components</a></h3>
+<div class="paragraph">
+<p>The N4JS and N4JSIDE components are organized via features. The following features with included plugins are defined
+(the common prefix "org.eclipse.n4js" is omitted at the plugin name):</p>
+</div>
+<table class="tableblock frame-all grid-all spread">
+<colgroup>
+<col style="width: 5.8823%;">
+<col style="width: 11.7647%;">
+<col style="width: 82.353%;">
+</colgroup>
+<thead>
+<tr>
+<th class="tableblock halign-left valign-top">Feature</th>
+<th class="tableblock halign-left valign-top">Plugin</th>
+<th class="tableblock halign-left valign-top">Description</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td class="tableblock halign-left valign-top" colspan="2"><p class="tableblock"><strong>org.eclipse.n4js.lang.sdk</strong></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">N4JS core language with parser, validation etc.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">org.eclipse.n4js</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Xtext grammar with generator and custom code for N4JS, scoping (and binding) implementation, basic validation (and Xsemantics type system).</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">doc</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">(in doc folder) General documentation (including web page) written in AsciiDoc</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">external.libraries</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Support for N4JS libraries shipped with the IDE, i.e. core N4JS library and mangelhaft.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">ui</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">UI components for N4JS, e.g., proposal provider, labels, outline, quickfixes.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">jsdoc</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Parser and model for JSDoc</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">external.libraries.update</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Not included in feature</strong>. Updates the external library plugin</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top" colspan="2"><p class="tableblock"><strong>org.eclipse.n4js.ts.sdk</strong></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Type System</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">ts</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Xtext grammar with generator and custom code for type expressions and standalone type definitions.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">ts.model</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Xcore based types model with helper classes etc.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">ts.ui</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Xtext generated UI for type system, not really used as this TS files are not editable by users.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top" colspan="2"><p class="tableblock"><strong>org.eclipse.n4js.unicode.sdk</strong></p></td>
+<td class="tableblock halign-left valign-top"></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">common.unicode</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Xtext grammar with generator and custom code used by all other grammars for proper unicode support.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top" colspan="2"><p class="tableblock"><strong>org.eclipse.n4js.regex.sdk</strong></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Regular expression grammar and UI, used by N4JS grammar and UI</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">regex</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Xtext grammar with generator and custom code used by N4JS grammars for regular expressions.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">regex.ui</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">UI components for regular expressions, e.g., proposal provider, labels, outline, quickfixes.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top" colspan="2"><p class="tableblock"><strong>org.eclipse.n4js.sdk</strong></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">This feature defines the N4JSIDE. It contains core UI plugins and all includes (almost all) other features!</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">environments</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Utility plugin, registers n4scheme for EMF proxy resolution.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">model</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Xcore based N4JS model with helper classes etc.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">product</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">N4JSIDE main application.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">releng.utils</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">(in releng folder) Contains utility classes only used for building the system, e.g., tools for generating antlr based parser with extended features.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">utils</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">general utilities</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">utils.ui</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">general UI utilities</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top" colspan="2"><p class="tableblock"><strong>org.eclipse.n4js.compiler.sdk</strong></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Compilers and Transpilers</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">generator.common</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Not included in feature, logically associated.</strong></p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">generator.headless</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">N4JS headless generator (i.e. command line compiler).</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">transpiler</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Generic transpiler infrastructure</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">transpiler.es</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Transpiler to compile to EcmaScript</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top" colspan="2"><p class="tableblock"><strong>org.eclipse.n4js.json.sdk</strong></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">N4JS JSON</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">json</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Xtext grammar with generator and custom code for a extensible JSON language support. Used in N4JS for the project description in terms of a <code>package.json</code> file.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">json.ui</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">UI components for extensible JSON language support, e.g., proposal provider, labels, outline.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">json.model</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Not included in feature, logically associated.</strong> Xcore based model for the JSON language.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top" colspan="2"><p class="tableblock"><strong>org.eclipse.n4js.semver.sdk</strong></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Semantic version string support.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">semver</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Parser and tools for semantic version strings.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">semver.ui</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">UI tools for semantic version strings.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">semver.model</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Not included in feature, logically associated.</strong> Xcore model of semantic version strings.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top" colspan="2"><p class="tableblock"><strong>org.eclipse.n4js.runner.sdk</strong></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Runners for executing N4JS or JavaScript code</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">runner</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Generic interfaces and helper for runners, i.e. JavaScript engines executing N4JS or JavaScript code.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">runner.chrome</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Runner for executing N4JS or JavaScript with Chrome.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">runner.chrome.ui</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">UI classes for launching the Chrome runner via the org.eclipse.debug.ui</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">runner.nodejs</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Runner for executing N4JS or JavaScript with node.js.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">runner.nodejs.ui</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">UI classes for launching the node.js runner via the org.eclipse.debug.ui</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">runner.ui</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Generic interfaces for configuring N4JS runner via the debug ui.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top" colspan="2"><p class="tableblock"><strong>org.eclipse.n4js.tester.sdk</strong></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Runners and UI for tests (via mangelhaft).</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">tester</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Generic interfaces and helper for testers, i.e. JavaScript engines executing N4JS tests (using mangelhaft).</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">tester.nodejs</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Tester based on the nodejs runner for executing mangelhaft tests with node.js</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">tester.nodejs.ui</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">UI for showing test results.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">tester.ui</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Configuration of tests via the debug UI.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top" colspan="2"><p class="tableblock"><strong>org.eclipse.n4js.jsdoc2spec.sdk</strong></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">JSDoc 2 Specification</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">jsdoc2spec</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Exporter to generate API documentation with specification tests awareness</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">jsdoc2spec.ui</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">UI for API doc exporter</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top" colspan="2"><p class="tableblock"><strong>org.eclipse.n4js.xpect.sdk</strong></p></td>
+<td class="tableblock halign-left valign-top"></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">xpect</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Xpect test methods.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">xpect.ui</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">UI for running Xpext tests methods from the N4JSIDE (for creating bug reports).</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top" colspan="2"><p class="tableblock"><strong>org.eclipse.n4js.smith.sdk</strong></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Feature for internal N4JS IDE plugins only intended for development (for example, the AST Graph view).</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">smith</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Non-UI classes for tools for smiths, that is, tools for developers of the N4JS IDE such as AST views etc.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">smith.ui</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">UI classes for tools for smiths, that is, tools for developers of the N4JS IDE such as AST views etc.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top" colspan="2"><p class="tableblock"><strong>org.eclipse.n4js.tests.helper.sdk</strong></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Test helpers.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top" colspan="2"><p class="tableblock"><strong>org.eclipse.n4js.dependencies.sdk</strong></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Collection of all external non-ui dependencies, used for local mirroring of update sites.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top" colspan="2"><p class="tableblock"><strong>org.eclipse.n4js.dependencies.ui.sdk</strong></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Collection of all external ui dependencies, used for local mirroring of update sites.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top" colspan="3"><p class="tableblock"><strong>uncategorized plugins</strong></p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">flowgraphs</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Control and data flow graph model and computer.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top" colspan="2"><p class="tableblock"><strong>Fragments</strong></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">not associated to features, only listed here for completeness</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">utils.logging</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Fragment only, configuration for loggers, in particular for the product and for the tests</p></td>
+</tr>
+</tbody>
+</table>
+<div class="sect3">
+<h4 id="sec:Naming_Conventions"><a class="anchor" href="#sec:Naming_Conventions"></a><a class="link" href="#sec:Naming_Conventions">1.2.1. Naming Conventions</a></h4>
+<div class="paragraph">
+<p>In the above sections, tests were omitted. We use the following naming conventions (by example) for test and tests helper:</p>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+project
+</td>
+<td class="hdlist2">
+<p>-</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+project.tests
+</td>
+<td class="hdlist2">
+<p>tests for project, is a fragment</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+project.tests.helper
+</td>
+<td class="hdlist2">
+<p>helper classes used ONLY by tests</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+project.tests.performance
+</td>
+<td class="hdlist2">
+<p>performance tests</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+project.tests.integration
+</td>
+<td class="hdlist2">
+<p>integration tests</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+project.ui
+</td>
+<td class="hdlist2">
+<p>-</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+project.ui.tests
+</td>
+<td class="hdlist2">
+<p>tests for ui project, fragment of project.ui</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+project.ui.tests.helper
+</td>
+<td class="hdlist2">
+<p>helper classes used ONLY by tests</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+project.ui.tests.performance
+</td>
+<td class="hdlist2">
+<p>-</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+tests.helper
+</td>
+<td class="hdlist2">
+<p>general test helper</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+ui.tests.helper
+</td>
+<td class="hdlist2">
+<p>general ui test helper</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+project.xpect.tests
+</td>
+<td class="hdlist2">
+<p>xpect tests for the project, despite dependnecies to UI the can be executed as plain JUnit tests</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+project.xpect.ui.tests
+</td>
+<td class="hdlist2">
+<p>xpect tests for the project, need to be executed as eclipse plugin tests</p>
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>Due to Maven, tests are in subfolder tests (incl. helpers), implementation bundles in plugins, and release engineering related bundles in releng.</p>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div id="footer">
+<div id="footer-text">
+Version 0.9<br>
+Last updated 2019-08-07 15:02:40 CEST
+</div>
+</div>
+<!-- ************* docinfo-footer *************************************************************** -->
+<div class="Grid social" style="color:#d5dfea">
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <h2>Quick Links</h2>
+    <ul>
+      <li><a href="../downloads.html">Download</a></li>
+      <li><a href="../userguides/index.html">Documentation</a></li>
+      <li><a href="https://github.com/eclipse/n4js/">Source</a></li>
+      <li><a href="https://github.com/eclipse/n4js/issues">Issues</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="https://www.eclipse.org/forums/index.php/f/365/">Forum</a></li>
+      <li><a href="http://n4js.blogspot.de/">Blog</a></li>
+      <li><a href="https://dev.eclipse.org/mailman/listinfo/n4js-dev">Mailing List</a></li>
+      <li><a href="https://projects.eclipse.org/projects/technology.n4js">Eclipse Project Page</a></li>
+      <li><a href="https://twitter.com/n4jsdev">Tweets by n4jsdev</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="http://www.eclipse.org/">Eclipse Home</a></li>
+      <li><a href="http://www.eclipse.org/legal/privacy.php">Privacy Policy</a></li>
+      <li><a href="http://www.eclipse.org/legal/termsofuse.php">Terms of Use</a></li>
+      <li><a href="http://www.eclipse.org/legal/copyright.php">Copyright Agent</a></li>
+      <li><a href="http://www.eclipse.org/legal/">Legal</a></li>
+    </ul>
+  </div>
+  <div style="clear: both; height: 0; overflow: hidden;"></div>
+</div>
+
+<!-- ************* UI Scripts ************* -->
+<script type="text/javascript" src="scripts/back-to-top.js"></script>
+
+<script type="text/javascript" src="scripts/treeview.js"></script>
+<script type="text/javascript" src="scripts/toc.js"></script>
+
+<!-- ************* Prism.js Syntax Highlighting ************* -->
+<script src="scripts/prism.js"></script>
+
+<script type="text/javascript">
+	// Add the 'toclist' id for search function
+	$(".toc2 > ul").attr('id', 'toclist');
+	// Generate a Search input form
+	$("#toclist > li:first-of-type").before('<input type="text" id="pagesearch" onkeyup="search()" placeholder="Search for section...">');
+	$("#toclist > li:first-of-type").before('<i id="clear" class="fa fa-times-circle-o"></i>');
+	$("#clear").click(function(){
+	    $("#pagesearch").val('');
+	    search();
+	    $('.toc2 > ul').treeView('collapseAll');
+	});
+	// intialize Treeview.js
+	$(".toc2 > ul").treeView();
+	// Initialize Scrollspy
+</script>
+<!-- ************* docinfo-footer *************************************************************** -->
+</body>
+</html>
\ No newline at end of file
diff --git a/design/jsdoc.html b/design/jsdoc.html
new file mode 100644
index 0000000..93baa07
--- /dev/null
+++ b/design/jsdoc.html
@@ -0,0 +1,993 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="generator" content="Asciidoctor 1.5.5">
+<meta name="author" content="2019-08-07 15:02:40 CEST">
+<title>N4JS Design Specification</title>
+<link rel="stylesheet" href="styles/spec.min.css">
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.6.3/css/font-awesome.min.css">
+<!-- ************* docinfo ******************************************************************* -->
+
+
+<!-- ************* Favicon ************-->
+<link rel="icon" href="images/favicon.ico" />
+
+<!-- ************* Back-to-top JQuery ************* -->
+<script src="https://code.jquery.com/jquery-1.12.4.js"></script>
+<script src="https://code.jquery.com/ui/1.12.0/jquery-ui.js"></script>
+
+
+<link href="styles/prism.min.css" rel="stylesheet" />
+<script type="text/javascript" async
+  src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2/MathJax.js?config=TeX-MML-AM_CHTML">
+</script>
+
+<!-- ************* Styles ************* -->
+<link rel="stylesheet" type="text/css" href="styles/n4jsspec-adoc.css">
+
+
+<!-- ****************** NavBar ****************** -->
+<div id="menubar">
+	<div class="banner">
+        <a href="https://www.eclipse.org/n4js/#"><img id="logo" src="images/n4js-logo.png" alt="Eclipse N4JS"></a>
+    </div>
+<ul>
+  <li><a href="index.html">Index</a></li>
+</ul>
+</div>
+<!-- ************* docinfo ******************************************************************* -->
+<style>
+      .admonitionblock td.icon .icon-todo:before{content:"\f249";color:#f4ee42}
+    </style>
+</head>
+<body class="book toc2 toc-left">
+<div id="header">
+<h1>N4JS Design Specification</h1>
+<div class="details">
+<span id="author" class="author">2019-08-07 15:02:40 CEST</span><br>
+<span id="revnumber">version 0.9</span>
+</div>
+<div id="toc" class="toc2">
+<div id="toctitle">Table of Contents</div>
+<ul class="sectlevel1">
+<li><a href="introduction.html#_introduction">1. Introduction</a>
+<ul class="sectlevel2">
+<li><a href="introduction.html#notation">1.1. Notation</a></li>
+<li><a href="introduction.html#sec:IDE_Overview">1.2. IDE Components</a>
+<ul class="sectlevel3">
+<li><a href="introduction.html#sec:Naming_Conventions">1.2.1. Naming Conventions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="eclipse_setup.html#_eclipse-setup">2. Eclipse Setup</a>
+<ul class="sectlevel2">
+<li><a href="eclipse_setup.html#_system-requirements">2.1. System Requirements</a></li>
+<li><a href="eclipse_setup.html#_contribute">2.2. Contribute</a>
+<ul class="sectlevel3">
+<li><a href="eclipse_setup.html#_eclipse-installer">2.2.1. Eclipse Installer</a>
+<ul class="sectlevel4">
+<li><a href="eclipse_setup.html#_changing-the-setup-script">2.2.1.1. Changing the Setup Script</a></li>
+</ul>
+</li>
+<li><a href="eclipse_setup.html#_manual-ide-configuration">2.2.2. Manual IDE Configuration</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="release_engineering.html#_release-engineering">3. Release Engineering</a>
+<ul class="sectlevel2">
+<li><a href="release_engineering.html#_nightly-build-on-eclipse-infrastructure">3.1. Nightly build on Eclipse infrastructure</a></li>
+<li><a href="release_engineering.html#_build-the-n4js-ide-from-command-line">3.2. Build the N4JS IDE from command line</a>
+<ul class="sectlevel3">
+<li><a href="release_engineering.html#_publish-maven-tooling-code-org-eclipse-n4js-releng-util-code">3.2.1. Publish maven-tooling <code>org.eclipse.n4js.releng.util</code></a></li>
+<li><a href="release_engineering.html#sec:test-verdaccio">3.2.2. Test Verdaccio containing n4js-libs</a></li>
+<li><a href="release_engineering.html#_generation-of-eclipse-help-for-spec-and-design-document">3.2.3. Generation of Eclipse help for spec and design document</a></li>
+</ul>
+</li>
+<li><a href="release_engineering.html#_updating-frameworks-and-dependencies">3.3. Updating frameworks and dependencies</a>
+<ul class="sectlevel3">
+<li><a href="release_engineering.html#_update-of-eclipse-emf-xtext-etc">3.3.1. Update of Eclipse, EMF, Xtext, etc.</a></li>
+<li><a href="release_engineering.html#_update-of-the-embedded-jre">3.3.2. Update of the embedded JRE</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tips_and_tricks.html#_tips-and-tricks">4. Tips and Tricks</a>
+<ul class="sectlevel2">
+<li><a href="tips_and_tricks.html#_naming">4.1. Naming</a></li>
+<li><a href="tips_and_tricks.html#_logging">4.2. Logging</a></li>
+<li><a href="tips_and_tricks.html#_cancellation-handling">4.3. Cancellation Handling</a></li>
+<li><a href="tips_and_tricks.html#_caching">4.4. Caching</a></li>
+<li><a href="tips_and_tricks.html#_dependency-injection">4.5. Dependency Injection</a></li>
+<li><a href="tips_and_tricks.html#_miscellaneous">4.6. Miscellaneous</a></li>
+</ul>
+</li>
+<li><a href="parser.html#_parser">5. Parser</a>
+<ul class="sectlevel2">
+<li><a href="parser.html#sec:Parser_Overview">5.1. Overview</a></li>
+<li><a href="parser.html#sec:N4JS_Parser">5.2. N4JS Parser</a></li>
+<li><a href="parser.html#sec:Parser_Generation_Post_Processing">5.3. Parser Generation Post-Processing</a>
+<ul class="sectlevel3">
+<li><a href="parser.html#sec:Automatic_Semicolon_Insertion">5.3.1. Automatic Semicolon Insertion</a>
+<ul class="sectlevel4">
+<li><a href="parser.html#sec:Injected_code_in_the_Antlr_grammar_file">5.3.1.1. Injected code in the Antlr grammar file</a></li>
+<li><a href="parser.html#sec:Customized_error_recovery">5.3.1.2. Customized error recovery</a></li>
+</ul>
+</li>
+<li><a href="parser.html#sec:_No_line_terminator_allowed_here__handling">5.3.2. Async and <code>No line terminator allowed here</code> Handling</a></li>
+<li><a href="parser.html#sec:Regular_Expression">5.3.3. Regular Expression</a></li>
+<li><a href="parser.html#sec:Unicode">5.3.4. Unicode</a></li>
+<li><a href="parser.html#sec:Literals">5.3.5. Literals</a></li>
+</ul>
+</li>
+<li><a href="parser.html#sec:Modifiers">5.4. Modifiers</a></li>
+<li><a href="parser.html#sec:Conflict_Resolutions">5.5. Conflict Resolutions</a>
+<ul class="sectlevel3">
+<li><a href="parser.html#sec:Reserved_Keywords_vs__Identifier_Names">5.5.1. Reserved Keywords vs. Identifier Names</a></li>
+<li><a href="parser.html#sec:Operators_and_Generics">5.5.2. Operators and Generics</a></li>
+</ul>
+</li>
+<li><a href="parser.html#sec:Content_Assist_Parser">5.6. Content-Assist Parser</a></li>
+</ul>
+</li>
+<li><a href="type_system.html#_type-system">6. Type System</a>
+<ul class="sectlevel2">
+<li><a href="type_system.html#sec:Type_Model_and_Grammar">6.1. Type Model and Grammar</a>
+<ul class="sectlevel3">
+<li><a href="type_system.html#sec:Type_Model_Overview">6.1.1. Type Model Overview</a></li>
+<li><a href="type_system.html#sec:Built_in_Types">6.1.2. Built-in and Primitive Types</a></li>
+<li><a href="type_system.html#sec:Type_Model_DSL">6.1.3. Type Model DSL</a></li>
+</ul>
+</li>
+<li><a href="type_system.html#sec:Type_System_Implementation">6.2. Type System Implementation</a></li>
+<li><a href="type_system.html#sec:Type_Inference_combined_with_AST_Traversal">6.3. Type Inference of AST</a>
+<ul class="sectlevel3">
+<li><a href="type_system.html#sec:Type_Inference_combined_with_AST_Traversal__Background">6.3.1. Background</a></li>
+<li><a href="type_system.html#sec:Triggering_Type_Inference_of_AST">6.3.2. Triggering</a></li>
+<li><a href="type_system.html#sec:Traversal_Order_During_Type_Inference_of_AST">6.3.3. Traversal Order</a></li>
+<li><a href="type_system.html#sec:Cross_References_During_Type_Inference_of_AST">6.3.4. Cross-References</a></li>
+<li><a href="type_system.html#sec:Function_Accessor_Bodies_During_Type_Inference_of_AST">6.3.5. Function/Accessor Bodies</a></li>
+<li><a href="type_system.html#sec:Poly_Expressions_During_Type_Inference_of_AST">6.3.6. Poly Expressions</a></li>
+<li><a href="type_system.html#sec:Constraint_Solver_used_During_Type_Inference_of_AST">6.3.7. Constraint Solver</a></li>
+<li><a href="type_system.html#sec:Type_Guards_During_Type_Inference_of_AST">6.3.8. Type Guards</a></li>
+</ul>
+</li>
+<li><a href="type_system.html#sec:Structural_Typing">6.4. Structural Typing</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#_type-index">7. Type Index</a>
+<ul class="sectlevel2">
+<li><a href="type_index.html#sec:Type_Index_Design_Rationale">7.1. Design Rationale</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#sec:Getting_the_Xtext_Index_Content_IResourceDescriptions">7.1.1. Getting the Xtext Index (<code>IResourceDescriptions</code>) Content</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#sec:Design_Overview">7.2. Design Overview</a></li>
+<li><a href="type_index.html#sec:N4JS_Resource_Load_States">7.3. N4JS Resource Load States</a></li>
+<li><a href="type_index.html#sec:Type_Builder">7.4. Types Builder</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#sec:Type_Inference_not_allowed_in_Type_Builder">7.4.1. Type Inference not allowed in Types Builder</a></li>
+<li><a href="type_index.html#sec:ComputedTypeReferences">7.4.2. Deferred Type References</a></li>
+<li><a href="type_index.html#sec:Use_cases_of_ComputedTypeRef">7.4.3. Use cases of DeferredTypeRef</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#sec:Incremental_Builder_Overview">7.5. Incremental Builder (Overview)</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#sec:Incremental_Builder_Overview__XtextBuilder">7.5.1. XtextBuilder</a></li>
+<li><a href="type_index.html#sec:Incremental_Builder_Overview__IBuilderState">7.5.2. IBuilderState</a>
+<ul class="sectlevel4">
+<li><a href="type_index.html#copy-and-update-xtext-index">7.5.2.1. Copy and Update Xtext Index</a></li>
+<li><a href="type_index.html#build-state-setup-phase">7.5.2.2. Build State Setup Phase</a></li>
+<li><a href="type_index.html#process-queued-uris">7.5.2.3. Process Queued URIs</a></li>
+<li><a href="type_index.html#queueing-affected-resources">7.5.2.4. Queueing Affected Resources</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#sec:Incremental_Builder_Overview__Example">7.5.3. Example</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#dirty-state-handling">7.6. Dirty state handling</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#use-case-restoring-types-from-user-data">7.6.1. Use case: Restoring types from user data</a></li>
+<li><a href="type_index.html#use-case-updating-the-xtext-index">7.6.2. Use case: Updating the Xtext index</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="project_model.html#_project-model">8. Project Model</a>
+<ul class="sectlevel2">
+<li><a href="project_model.html#sec:Package_json">8.1. Package.json File</a></li>
+<li><a href="project_model.html#_accessing-project-information">8.2. Accessing Project Information</a>
+<ul class="sectlevel3">
+<li><a href="project_model.html#sec:IN4JSCore">8.2.1. IN4JSCore</a></li>
+<li><a href="project_model.html#sec:N4JSModel">8.2.2. N4JSModel</a></li>
+<li><a href="project_model.html#sec:N4JSWorkspace">8.2.3. N4JSWorkspace</a></li>
+<li><a href="project_model.html#sec:N4JSProject">8.2.4. N4JSProject</a></li>
+<li><a href="project_model.html#sec:SourceContainer">8.2.5. SourceContainer</a></li>
+<li><a href="project_model.html#sec:N4JSProjectsStateHelper">8.2.6. N4JSProjectsStateHelper</a></li>
+</ul>
+</li>
+<li><a href="project_model.html#sec:Caching">8.3. Caching</a>
+<ul class="sectlevel3">
+<li><a href="project_model.html#_caching-of-externallibraryworkspace">8.3.1. Caching of ExternalLibraryWorkspace</a></li>
+<li><a href="project_model.html#_caching-of-n4jsprojectsstatehelper">8.3.2. Caching of N4JSProjectsStateHelper</a></li>
+</ul>
+</li>
+<li><a href="project_model.html#sec:WildcardPathFilter">8.4. WildcardPathFilter</a></li>
+<li><a href="project_model.html#sec:ProjectUtils">8.5. ProjectUtils</a></li>
+</ul>
+</li>
+<li><a href="binding.html#_binding">9. Binding</a>
+<ul class="sectlevel2">
+<li><a href="binding.html#sec:Binding_Design_Rationale">9.1. Design Rationale</a></li>
+<li><a href="binding.html#sec:Binding_to_Members">9.2. Binding to Members</a></li>
+<li><a href="binding.html#sec:Binding_Getter_Setter">9.3. Getter / Setter Binding</a></li>
+<li><a href="binding.html#chap:Statics">9.4. Static Member Binding</a></li>
+<li><a href="binding.html#sec:Binding_Enumeration">9.5. Enumeration Literals Binding</a></li>
+<li><a href="binding.html#sec:Accessibility_of_types_and_members">9.6. Accessibility of types and members</a></li>
+<li><a href="binding.html#sec:Member_Scope_Example">9.7. Member Scope Example</a></li>
+<li><a href="binding.html#sec:Scoping_for_Members_of_Composed_Type_Explained">9.8. Scoping for Members of Composed Type (Union/Intersection) Example</a></li>
+<li><a href="binding.html#sec:Binding_of_Structurally_References_Types">9.9. Structurally References Types</a></li>
+<li><a href="binding.html#sec:Building">9.10. Building</a>
+<ul class="sectlevel3">
+<li><a href="binding.html#sec:Build_Phases">9.10.1. Build Phases</a></li>
+<li><a href="binding.html#sec:Build_Scenarios">9.10.2. Build Scenarios</a></li>
+<li><a href="binding.html#sec:Lazy_linking_problem">9.10.3. Lazy linking problem</a></li>
+</ul>
+</li>
+<li><a href="binding.html#sec:Proxies_and_Proxy_Resolution">9.11. Proxies and Proxy Resolution (Overview)</a>
+<ul class="sectlevel3">
+<li><a href="binding.html#xtexts-lazy-linking-proxies">9.11.1. Xtext’s Lazy Linking Proxies</a></li>
+<li><a href="binding.html#standard-emf-proxies">9.11.2. Standard EMF Proxies</a></li>
+<li><a href="binding.html#_how-is-proxy-resolution-triggered">9.11.3. How is Proxy Resolution Triggered?</a></li>
+<li><a href="binding.html#_when-is-proxy-resolution-allowed">9.11.4. When is Proxy Resolution Allowed?</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="validation.html#_validation">10. Validation</a>
+<ul class="sectlevel2">
+<li><a href="validation.html#sec:validation_overview">10.1. Validation overview</a></li>
+<li><a href="validation.html#sec:validation_control_flow">10.2. Validation control flow</a></li>
+<li><a href="validation.html#sec:validation_issue_ids">10.3. Issue IDs and Messages</a></li>
+<li><a href="validation.html#sec:validation_usage_patterns">10.4. Usage Pattern</a></li>
+<li><a href="validation.html#sec:validation_links">10.5. Links</a></li>
+</ul>
+</li>
+<li><a href="references.html#_references">11. References</a>
+<ul class="sectlevel2">
+<li><a href="references.html#sec:usecases">11.1. Use cases</a></li>
+<li><a href="references.html#sec:calculation_algorithm">11.2. Calculation algorithm</a>
+<ul class="sectlevel3">
+<li><a href="references.html#sec:Xtext_default_implementation">11.2.1. Xtext default implementation</a></li>
+<li><a href="references.html#sec:N4_implementation">11.2.2. N4JS implementation</a></li>
+</ul>
+</li>
+<li><a href="references.html#sec:PerformanceOfDependencyCalculation">11.3. Performance Of Dependency Calculation</a></li>
+<li><a href="references.html#sec:kinds_of_references">11.4. Kinds of references</a>
+<ul class="sectlevel3">
+<li><a href="references.html#sec:Cross_References_to_be_ignored">11.4.1. Cross References to be ignored</a></li>
+<li><a href="references.html#sec:Cross_References_to_be_handled">11.4.2. Cross References to be handled</a></li>
+</ul>
+</li>
+<li><a href="references.html#sec:transitive_dependencies">11.5. Transitive dependencies</a></li>
+<li><a href="references.html#sec:find-references">11.6. Find references</a>
+<ul class="sectlevel3">
+<li><a href="references.html#_background">11.6.1. Background</a></li>
+<li><a href="references.html#_how-find-references-work">11.6.2. How Find References Work</a>
+<ul class="sectlevel4">
+<li><a href="references.html#_step-1-convert-cursor-position-to-declared-element">11.6.2.1. Step 1: Convert Cursor Position to Declared Element</a></li>
+<li><a href="references.html#_step-2-convert-declared-element-to-target-uris">11.6.2.2. Step 2: Convert Declared Element to Target URIs</a></li>
+<li><a href="references.html#_step-3-filter-potential-resources">11.6.2.3. Step 3: Filter Potential Resources</a></li>
+<li><a href="references.html#_step-4-search-references-in-resource">11.6.2.4. Step 4: Search References in Resource</a></li>
+<li><a href="references.html#_limitations-and-possible-enhancements">11.6.2.5. Limitations and Possible Enhancements</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="compilation.html#_compilation">12. Compilation</a>
+<ul class="sectlevel2">
+<li><a href="compilation.html#chap:compilation">12.1. Introduction</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:general_design_rationals">12.1.1. General design rationals</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:logging_and_error_reporting">12.1.1.1. Logging and error reporting</a></li>
+<li><a href="compilation.html#sec:progress_monitor">12.1.1.2. Progress monitor</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Xtext_Integration">12.1.2. Xtext Integration</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:xtext_default_behaviour">12.1.2.1. Xtext default behaviour</a></li>
+<li><a href="compilation.html#sec:n4js_requirements">12.1.2.2. N4JS requirements</a></li>
+<li><a href="compilation.html#sec:compiler_discovery_in_ui">12.1.2.3. Compiler discovery in UI</a></li>
+<li><a href="compilation.html#sec:compiler_discovery_in_headless">12.1.2.4. Compiler discovery in headless</a></li>
+<li><a href="compilation.html#sec:general_generator_implementation">12.1.2.5. General generator implementation</a></li>
+<li><a href="compilation.html#sec:general_generator_activation">12.1.2.6. General generator activation</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Overview_of_Input_Models">12.1.3. Overview of the Input Models</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Core_Generator">12.2. Generators</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:Compiler_Components">12.2.1. Generator Components</a></li>
+<li><a href="compilation.html#sec:Generator_architecture">12.2.2. Generator architecture</a></li>
+<li><a href="compilation.html#sec:Unified_Compiler_Configuration">12.2.3. Unified Compiler Configuration</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Transpilers">12.3. Transpilers</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:Phases">12.3.1. Overview</a></li>
+<li><a href="compilation.html#relation-between-ast-and-im">12.3.2. Relation between AST and IM</a></li>
+<li><a href="compilation.html#implementation-overview">12.3.3. Implementation Overview</a></li>
+<li><a href="compilation.html#sec:Guidelines_for_Implementing_Transformations">12.3.4. Guidelines for Implementing Transformations</a></li>
+<li><a href="compilation.html#symbol-table-in-the-im">12.3.5. Symbol Table in the IM</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:N4JS_to_EcmaScript_Transpiler">12.4. N4JS-to-EcmaScript Transpiler</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:Overview_of_Transformations">12.4.1. Overview of Transformations</a></li>
+<li><a href="compilation.html#sec:Transpiling_members">12.4.2. Transpiling members</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:Transpiling_members__Delegating_members">12.4.2.1. Techniques for special member handling</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__Partial_shadowing_of_getter_setter_pairs">12.4.2.2. Partial shadowing</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__Consuming_or_inheriting_members_of_an_interface">12.4.2.3. Consuming or inheriting members of an interface</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__Static_polyfill">12.4.2.4. Static polyfill</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__API_implementation_stubs">12.4.2.5. API / implementation stubs</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Support_for_incomplete_API_implementation_testing_in_the_N4JS_to_EcmaScript_5_Transpiler">12.4.3. Support for incomplete API implementation testing</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:Modifications_in_Impl_projects">12.4.3.1. Modifications in Impl projects</a></li>
+<li><a href="compilation.html#sec:Implementation_of_stub_generation">12.4.3.2. Implementation of stub-generation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:n4jsc_Headless_Compiler_Interface">12.5. n4jsc Headless Compiler Interface</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:building_the_headless_compiler">12.5.1. building the headless compiler</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="execution.html#_execution">13. Execution</a>
+<ul class="sectlevel2">
+<li><a href="execution.html#sec:N4JS_Project_Execution_And_Linking_Model">13.1. N4JS Project Execution And Linking Model</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#subsec:N4JS_Execution_With_NodeJS">13.1.1. N4JS Execution With NodeJS</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:N4JS_Execution_And_Linking_File">13.2. N4JS Execution And Linking File</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#subsec:NodeJS_Specific_ELF">13.2.1. NodeJS Specific ELF</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Runners-execution">13.3. Runners</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#subsec:N4_Runtime_Environments_Convention">13.3.1. N4 Runtime Environments Convention</a></li>
+<li><a href="execution.html#subsec:Passing_Information_from_IDE_to_Execution_Code_in_Runtime_Environment">13.3.2. Passing Information from IDE to Execution Code in Runtime Environment</a></li>
+<li><a href="execution.html#subsec:Runners_Design">13.3.3. Runners Design</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Legacy_Execution_Engine">13.4. Legacy Execution Engine</a></li>
+<li><a href="execution.html#sec:Design">13.5. Design</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#sec:Usage_Outside_N4JSIDE">13.5.1. Usage Outside N4JSIDE</a>
+<ul class="sectlevel4">
+<li><a href="execution.html#sec:Use_Node_with_Maven">13.5.1.1. Use Node with Maven</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Usage_Inside_N4JSIDE">13.5.2. Usage Inside N4JSIDE</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Runtime_Injection">13.6. Runtime Injection</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#sec:Running_String_Code">13.6.1. Running String Code</a></li>
+<li><a href="execution.html#sec:Running_File_Code">13.6.2. Running File Code</a></li>
+<li><a href="execution.html#sec:Injection_Code_Example">13.6.3. Injection Code Example</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#_tests">14. Tests</a>
+<ul class="sectlevel2">
+<li><a href="tests.html#sec:Performance_Tests">14.1. Performance Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Synthetic_Performance_Tests">14.1.1. Synthetic Performance Tests</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:Design_of_Generator">14.1.1.1. Design of Generator</a></li>
+<li><a href="tests.html#sec:Design_of_Performance_Test_Execution">14.1.1.2. Design of Performance Test Configuration and Execution</a></li>
+<li><a href="tests.html#sec:JUnit_Configuration">14.1.1.3. JUnit Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Test_Configuration">14.1.1.4. JUnitBenchmark Test Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Report_Configuration">14.1.1.5. JUnitBenchmark Report Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Run_Configuration">14.1.1.6. JUnitBenchmark Run Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Example">14.1.1.7. JUnitBenchmark Example</a></li>
+<li><a href="tests.html#sec:Note_on_Jenkins_Job">14.1.1.8. Note on Jenkins Job</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#sec:ECMA_Tests">14.2. ECMA Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Grammar_Tests">14.2.1. Grammar Tests</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:Negative_Tests">14.2.1.1. Negative Tests</a></li>
+<li><a href="tests.html#sec:Test_Exclusion">14.2.1.2. Test Exclusion</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Integration_Tests">14.3. Integration Tests</a></li>
+<li><a href="tests.html#sec:Test_Helpers">14.4. Test Helpers</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Parameterized_N4JS_Tests">14.4.1. Parameterized N4JS tests</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:ParameterizedXtextRunner">14.4.1.1. ParameterizedXtextRunner</a></li>
+<li><a href="tests.html#sec:TestCodeProvider">14.4.1.2. TestCodeProvider</a></li>
+<li><a href="tests.html#sec:Example_Of_Parameterized_Parser_Test">14.4.1.3. Example of parameterized parser test</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Issue_Suppression">14.5. Issue Suppression</a></li>
+<li><a href="tests.html#sec:Xpect_Tests">14.6. Xpect Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Xpect_Test_Setup">14.6.1. Xpect Test Setup</a></li>
+<li><a href="tests.html#sec:Xpect_Issue_Suppression">14.6.2. Xpect Issue Suppression</a></li>
+<li><a href="tests.html#sec:Xpect_Provided_Test_Methods">14.6.3. Xpect Provided Test Methods</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#errors">14.6.3.1. errors</a></li>
+<li><a href="tests.html#warnings">14.6.3.2. warnings</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:N4JS_Specific_Xpect_Test_Methods">14.6.4. N4JS Specific Xpect Test Methods</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:XPECT_noerrors">14.6.4.1. noerrors and nowarnings</a></li>
+<li><a href="tests.html#sec:XPECT_scope">14.6.4.2. scope</a></li>
+<li><a href="tests.html#sec:XPECT_scopeWithPosition">14.6.4.3. scopeWithPosition</a></li>
+<li><a href="tests.html#sec:XPECT_scopeWithResource">14.6.4.4. scopeWithResource</a></li>
+<li><a href="tests.html#sec:XPECT_binding">14.6.4.5. binding</a></li>
+<li><a href="tests.html#sec:XPECT_linkedPathname">14.6.4.6. linkedPathname</a></li>
+<li><a href="tests.html#sec:XPECT_type_of">14.6.4.7. type of</a></li>
+<li><a href="tests.html#sec:XPECT_expectedType">14.6.4.8. expectedType</a></li>
+<li><a href="tests.html#sec:XPECT_elementKeyword">14.6.4.9. elementKeyword</a></li>
+<li><a href="tests.html#sec:XPECT_accessModifier">14.6.4.10. accessModifier</a></li>
+<li><a href="tests.html#sec:XPECT_compileResult">14.6.4.11. compileResult</a></li>
+<li><a href="tests.html#sec:XPECT_output">14.6.4.12. output</a></li>
+<li><a href="tests.html#sec:XPECT_outputRegEx">14.6.4.13. outputRegEx</a></li>
+<li><a href="tests.html#sec:XPECT_calculatedAccessModifier">14.6.4.14. calculatedAccessModifier</a></li>
+<li><a href="tests.html#sec:XPECT_spec">14.6.4.15. spec</a></li>
+<li><a href="tests.html#sec:XPECT_deadCode">14.6.4.16. deadCode</a></li>
+<li><a href="tests.html#sec:XPECT_returnOrThrows">14.6.4.17. returnOrThrows</a></li>
+<li><a href="tests.html#sec:XPECT_lint">14.6.4.18. lint</a></li>
+<li><a href="tests.html#sec:XPECT_lintFails">14.6.4.19. lintFails</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:FIXME_Xpect_modifier">14.6.5. FIXME Xpect modifier</a></li>
+<li><a href="tests.html#sec:Expectmatrix_Xpect_Test_Methods">14.6.6. Expectmatrix Xpect tests</a></li>
+<li><a href="tests.html#xpect-lint-tests">14.6.7. Xpect Lint Tests</a></li>
+</ul>
+</li>
+<li><a href="tests.html#xpect-proposal-tests">14.7. Xpect Proposal Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Validation_vs__Non_Validation">14.7.1. Validation vs. Non-Validation</a></li>
+<li><a href="tests.html#sec:General_Proposal_Test_Features">14.7.2. General Proposal Test Features</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:Test_Variables">14.7.2.1. Test Variables</a></li>
+<li><a href="tests.html#sec:Location_and_Selection">14.7.2.2. at – Location and Selection</a></li>
+<li><a href="tests.html#sec:Multi_Line_Expectations_in_Proposal_Tests">14.7.2.3. Multi Line Expectations in Proposal Tests</a></li>
+<li><a href="tests.html#sec:Timeout">14.7.2.4. Timeout and Performance</a></li>
+</ul>
+</li>
+<li><a href="tests.html#proposals-verify-existence-of-proposals">14.7.3. proposals – Verify Existence of Proposals</a></li>
+<li><a href="tests.html#sec:Verify_displayed_string">14.7.4. display – Verify displayed string</a></li>
+<li><a href="tests.html#sec:Apply_Proposal">14.7.5. apply – Apply Proposal</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#resource-application-in-other-files">14.7.5.1. resource – application in other files</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Content_Assist_Cycling">14.7.6. kind – Content Assist Cycling</a></li>
+<li><a href="tests.html#fileValidVerify-validation-status">14.7.7. fileValid – Verify validation status</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Apply_Proposal_And_Execute_Tests">14.8. Apply Proposal And Execute Tests</a></li>
+<li><a href="tests.html#sec:Organize_Imports_Test">14.9. Organize Imports Test</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#organizeimports">14.9.1. organizeImports</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Access_Control_Test">14.10. Access Control Test</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#test-scenarios">14.10.1. Test Scenarios</a></li>
+<li><a href="tests.html#n4js-code-generator">14.10.2. N4JS Code Generator</a></li>
+<li><a href="tests.html#xtext-issue-matcher">14.10.3. Xtext Issue Matcher</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Smoke_Tests">14.11. Smoke Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#how-to-handle-smoke-test-errors">14.11.1. How to handle smoke test errors?</a></li>
+<li><a href="tests.html#smoketester-and-exceptionanalyzer">14.11.2. SmokeTester and ExceptionAnalyzer</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:UI_Tests_with_SWTBot">14.12. UI Tests with SWTBot</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#writing-swtbot-tests">14.12.1. Writing SWTBot Tests</a></li>
+<li><a href="tests.html#running-swtbot-tests">14.12.2. Running SWTBot Tests</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Debugging_UI_Tests">14.13. Debugging UI Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Connecting_to_the_X_server_on_the_build_node">14.13.1. Connecting to the X-server on the build-node</a></li>
+<li><a href="tests.html#sec:Tools_to_investigate_the_java_stack">14.13.2. Tools to investigate the java-stack</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="ui_concepts.html#_ui-concepts">15. UI Concepts</a>
+<ul class="sectlevel2">
+<li><a href="ui_concepts.html#sec:User_Interface_Concepts">15.1. User Interface Concepts</a>
+<ul class="sectlevel3">
+<li><a href="ui_concepts.html#sec:Eclipse_UI_Concepts">15.1.1. Eclipse UI Concepts</a>
+<ul class="sectlevel4">
+<li><a href="ui_concepts.html#sec:Label_Provider">15.1.1.1. Label Provider</a></li>
+<li><a href="ui_concepts.html#sec:Markers">15.1.1.2. Markers</a></li>
+<li><a href="ui_concepts.html#sec:Commands__Toolbar_and_Menus">15.1.1.3. Commands, Toolbar and Menus</a></li>
+<li><a href="ui_concepts.html#sec:Content_Assist">15.1.1.4. Content Assist</a></li>
+<li><a href="ui_concepts.html#sec:Quick_Fixes">15.1.1.5. Quick Fixes</a></li>
+<li><a href="ui_concepts.html#sec:Quick_Assist">15.1.1.6. Quick Assist</a></li>
+<li><a href="ui_concepts.html#sec:Clean_Up_Actions">15.1.1.7. Clean Up Actions</a></li>
+<li><a href="ui_concepts.html#sec:Save_Actions">15.1.1.8. Save Actions</a></li>
+<li><a href="ui_concepts.html#sec:Auto_Edit">15.1.1.9. Auto Edit</a></li>
+<li><a href="ui_concepts.html#sec:Template_Proposals">15.1.1.10. Template Proposals</a></li>
+<li><a href="ui_concepts.html#sec:Outline_View___Quick_Outline">15.1.1.11. Outline View / Quick Outline</a></li>
+<li><a href="ui_concepts.html#sec:Navigator__Package_Explorer__Project_Explorer">15.1.1.12. Navigator, Package Explorer, Project Explorer</a></li>
+<li><a href="ui_concepts.html#sec:Hyperlinking_and_Navigation">15.1.1.13. Hyperlinking and Navigation</a></li>
+<li><a href="ui_concepts.html#sec:Syntax_and_Semantic_Coloring">15.1.1.14. Syntax and Semantic Coloring</a></li>
+<li><a href="ui_concepts.html#sec:Code_Formatter">15.1.1.15. Code Formatter</a></li>
+<li><a href="ui_concepts.html#sec:Wizards">15.1.1.16. Wizards</a></li>
+<li><a href="ui_concepts.html#sec:Cheat_Sheets">15.1.1.17. Cheat Sheets</a></li>
+<li><a href="ui_concepts.html#sec:Context_sensitive_Help">15.1.1.18. Context-sensitive Help</a></li>
+<li><a href="ui_concepts.html#sec:Hovers">15.1.1.19. Hovers</a></li>
+<li><a href="ui_concepts.html#sec:Folding">15.1.1.20. Folding</a></li>
+<li><a href="ui_concepts.html#sec:Customizable_validation___severity">15.1.1.21. Customizable validation / severity</a></li>
+<li><a href="ui_concepts.html#sec:Proposals">15.1.1.22. Proposals</a></li>
+</ul>
+</li>
+<li><a href="ui_concepts.html#sec:Non_Eclipse_UI_Concepts">15.1.2. Non-Eclipse UI Concepts</a>
+<ul class="sectlevel4">
+<li><a href="ui_concepts.html#sec:Overlays">15.1.2.1. Overlays</a></li>
+<li><a href="ui_concepts.html#sec:Goto__Inferred__Type">15.1.2.2. Goto (Inferred) Type</a></li>
+<li><a href="ui_concepts.html#sec:Postfix_Completion">15.1.2.3. Postfix Completion</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="ui_concepts.html#_user-interface-resources">15.2. User Interface Resources</a>
+<ul class="sectlevel3">
+<li><a href="ui_concepts.html#_icons">15.2.1. Icons</a>
+<ul class="sectlevel4">
+<li><a href="ui_concepts.html#_eclipse-platform-icons">15.2.1.1. Eclipse Platform Icons</a></li>
+<li><a href="ui_concepts.html#_n4js-specific-icons">15.2.1.2. N4JS Specific Icons</a></li>
+<li><a href="ui_concepts.html#_high-resolution-icons">15.2.1.3. High Resolution Icons</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="formatting.html#_formatting">16. Formatting</a>
+<ul class="sectlevel2">
+<li><a href="formatting.html#sec:FmtObjective">16.1. Objective</a>
+<ul class="sectlevel3">
+<li><a href="formatting.html#sec:FmtFormatting_Comments">16.1.1. Formatting Comments</a></li>
+</ul>
+</li>
+<li><a href="formatting.html#sec:FmtArchitecture">16.2. Architecture</a>
+<ul class="sectlevel3">
+<li><a href="formatting.html#sec:Implementation_example">16.2.1. Implementation example</a></li>
+</ul>
+</li>
+<li><a href="formatting.html#sec:FmtFormatter_Implementation_Guidelines">16.3. Formatter Implementation Guidelines</a></li>
+<li><a href="formatting.html#sec:FmtConfiguration">16.4. Configuration</a></li>
+<li><a href="formatting.html#sec:FmtUI_Integration">16.5. UI Integration</a></li>
+<li><a href="formatting.html#sec:FmtUnit_Testing_with_Xpect">16.6. Unit Testing with Xpect</a></li>
+</ul>
+</li>
+<li><a href="external_libraries.html#_external-libraries">17. External Libraries</a>
+<ul class="sectlevel2">
+<li><a href="external_libraries.html#sec:Major_Components">17.1. Major Components</a>
+<ul class="sectlevel3">
+<li><a href="external_libraries.html#subsec:External_Resources">17.1.1. External Resources</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Workspace">17.1.2. External Library Workspace</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Preference_Store">17.1.3. External Library Preference Store</a></li>
+<li><a href="external_libraries.html#subsec:npm_Manager">17.1.4. Library Manager</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Builder_Helper">17.1.5. External Library Builder</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Xtext_Index_Persister">17.1.6. External Library Xtext Index Persister</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Preference_Page">17.1.7. External Library Preference Page</a></li>
+</ul>
+</li>
+<li><a href="external_libraries.html#sec:Headless_External_Library_Support">17.2. Headless External Library Support</a>
+<ul class="sectlevel3">
+<li><a href="external_libraries.html#_custom-npm-settings">17.2.1. Custom npm settings</a></li>
+</ul>
+</li>
+<li><a href="external_libraries.html#sec:lmFutureWork">17.3. Future Work</a>
+<ul class="sectlevel3">
+<li><a href="external_libraries.html#subsec:lmMultipleDependencyScope">17.3.1. Multiple Dependency Scope</a></li>
+<li><a href="external_libraries.html#subsec:lmRunTestsFromLibrary">17.3.2. Run Tests from TestLibrary</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="json_support.html#sec:JSON_Support">18. JSON Support</a>
+<ul class="sectlevel2">
+<li><a href="json_support.html#sec:JSON_Parser">18.1. JSON Parser</a>
+<ul class="sectlevel3">
+<li><a href="json_support.html#sec:JSON_Parser_Unicode_Escaping">18.1.1. Escaping Unicode Control Characters in String Literals</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Empty_Text">18.1.2. Empty Text</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Nested_Structures">18.1.3. Nested Structures</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Whitespace">18.1.4. Whitespace</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Comments">18.1.5. Comments</a></li>
+</ul>
+</li>
+<li><a href="json_support.html#sec:JSON_Language_Extensions">18.2. JSON Language Extensions</a>
+<ul class="sectlevel3">
+<li><a href="json_support.html#sec:JSON_Validator_Extensions">18.2.1. JSON Validator Extensions</a>
+<ul class="sectlevel4">
+<li><a href="json_support.html#sec:File_Specitic_Validator_Extensions">18.2.1.1. File-Specific Validator Extensions</a></li>
+<li><a href="json_support.html#sec:JSON_Declarative_JSON_Validator_Extensions">18.2.1.2. Declarative JSON Validator Extensions</a></li>
+</ul>
+</li>
+<li><a href="json_support.html#_json-resource-description-strategy">18.2.2. JSON Resource Description Strategy</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#_jsdoc">19. JSDoc</a>
+<ul class="sectlevel2">
+<li><a href="#sec:Design_Rationale">19.1. Design Rationale</a>
+<ul class="sectlevel3">
+<li><a href="#_general-design">19.1.1. General Design</a></li>
+<li><a href="#sec:Type_Expressions">19.1.2. Type Expressions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="docexporter.html#_docexporter">20. DocExporter</a>
+<ul class="sectlevel2">
+<li><a href="docexporter.html#sec:Specification_Exporter">20.1. Specification Exporter</a></li>
+</ul>
+</li>
+<li><a href="rename_refactoring.html#_rename-refactoring">21. Rename Refactoring</a>
+<ul class="sectlevel2">
+<li><a href="rename_refactoring.html#_rename-refactoring-ui-interaction">21.1. Rename Refactoring UI interaction</a></li>
+<li><a href="rename_refactoring.html#_renameelementprocessor-interaction">21.2. RenameElementProcessor interaction</a></li>
+</ul>
+</li>
+<li><a href="flow_graphs.html#chap:flowgraphs">22. Flow Graphs</a>
+<ul class="sectlevel2">
+<li><a href="flow_graphs.html#sec:flowgraphs_overview">22.1. Flow graphs overview</a>
+<ul class="sectlevel3">
+<li><a href="flow_graphs.html#_internal-graph">22.1.1. Internal graph</a></li>
+<li><a href="flow_graphs.html#_optimizations">22.1.2. Optimizations</a></li>
+<li><a href="flow_graphs.html#_api-for-client-analyses">22.1.3. API for client analyses</a>
+<ul class="sectlevel4">
+<li><a href="flow_graphs.html#_mapping-from-internal-to-ast-elements">22.1.3.1. Mapping from internal to AST elements</a></li>
+<li><a href="flow_graphs.html#_graph-visitor">22.1.3.2. Graph visitor</a></li>
+<li><a href="flow_graphs.html#_graph-explorer">22.1.3.3. Graph explorer</a></li>
+<li><a href="flow_graphs.html#_branch-walker">22.1.3.4. Branch walker</a></li>
+<li><a href="flow_graphs.html#_example-1-compute-string-for-each-path">22.1.3.5. Example 1: Compute string for each path</a></li>
+<li><a href="flow_graphs.html#_path-quantor">22.1.3.6. Path quantor</a></li>
+</ul>
+</li>
+<li><a href="flow_graphs.html#_control-flow-analyses">22.1.4. Control flow analyses</a>
+<ul class="sectlevel4">
+<li><a href="flow_graphs.html#_dead-code-analysis">22.1.4.1. Dead code analysis</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="flow_graphs.html#sec:dataflow">22.2. Dataflow</a>
+<ul class="sectlevel3">
+<li><a href="flow_graphs.html#_dataflow-graph">22.2.1. Dataflow graph</a></li>
+<li><a href="flow_graphs.html#_dataflow-analyses">22.2.2. Dataflow analyses</a>
+<ul class="sectlevel4">
+<li><a href="flow_graphs.html#_def-def-def-nothing-analysis">22.2.2.1. Def&#8594;Def / Def&#8594;Nothing analysis</a></li>
+<li><a href="flow_graphs.html#_def-use-decl-analysis">22.2.2.2. Def|Use&#8592;Decl analysis</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="publish_npms.html#sec:publish-npms-to-public">23. Publish npms</a>
+<ul class="sectlevel2">
+<li><a href="publish_npms.html#sec:publish-npms-n4js-maven">23.1. Publish n4js-libs to during  maven build</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Hints">Appendix A: Hints</a>
+<ul class="sectlevel2">
+<li><a href="appendix_a_hints.html#sec:XtextInjection">A.1. Xtext Injection</a>
+<ul class="sectlevel3">
+<li><a href="appendix_a_hints.html#sec:DI_MultipleInjectors_Singletons">A.1.1. Multiple Injectors and Singletons</a>
+<ul class="sectlevel4">
+<li><a href="appendix_a_hints.html#sec:DI_avoid_duplicate_singletons">A.1.1.1. Avoiding duplicate singletons</a>
+<ul class="sectlevel5">
+<li><a href="appendix_a_hints.html#sec:DI_binding_in_shared">A.1.1.1.1. Defining binding in the shared injector</a></li>
+<li><a href="appendix_a_hints.html#sec:DI_binding_in_custom">A.1.1.1.2. Defining binding in the custom injector</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:DI_Hints">A.1.2. Dependency Injection Hints</a>
+<ul class="sectlevel4">
+<li><a href="appendix_a_hints.html#sec:DI_custom_bundle">A.1.2.1. Use DI in custom bundle, use DI with extensions</a>
+<ul class="sectlevel5">
+<li><a href="appendix_a_hints.html#sec:DI_custom_bundle_problem">A.1.2.1.1. Problem</a></li>
+<li><a href="appendix_a_hints.html#sec:DI_custom_bundle_solution">A.1.2.1.2. Solution</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Access_Other_DSL_Injector">A.1.2.2. How do I get the Guice Injector of my language?</a>
+<ul class="sectlevel5">
+<li><a href="appendix_a_hints.html#sec:DSL_Injector_UI_context">A.1.2.2.1. UI context</a></li>
+<li><a href="appendix_a_hints.html#sec:DSL_Injector_Non_UI_context">A.1.2.2.2. Non UI context but with injection context</a></li>
+<li><a href="appendix_a_hints.html#sec:DSL_Injector_Non_UI_non_injection_context">A.1.2.2.3. Non UI context without injection context</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Cancel_Indicator">A.1.2.3. How do I get cancel indicators in different contexts?</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Eclipse">A.2. Eclipse</a>
+<ul class="sectlevel3">
+<li><a href="appendix_a_hints.html#sec:Show_Xtext_Index">A.2.1. Show the current Xtext index</a></li>
+<li><a href="appendix_a_hints.html#sec:Plugin_spy">A.2.2. Plug-in spy</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Maven-hints">A.3. Maven</a>
+<ul class="sectlevel3">
+<li><a href="appendix_a_hints.html#how-to-check-for-maven-mojo-updates">A.3.1. How to check for Maven MOJO updates</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#_module-loading">Appendix B: Module Loading</a>
+<ul class="sectlevel2">
+<li><a href="appendix_b_module_loading.html#sec:Dependency_Management">B.1. Dependency Management</a></li>
+<li><a href="appendix_b_module_loading.html#ecmascript-modules">B.2. ECMAScript Modules</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:ES5_Modules_Systems">B.2.1. ES5 Modules Systems</a></li>
+<li><a href="appendix_b_module_loading.html#sec:ES6_Modules">B.2.2. ES6 Modules</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:ECMAScript_Module_Loaders">B.3. ECMAScript Module Loaders</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:ES6_Module_Loaders">B.3.1. ES6 Module Loaders</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Polyfills_for_ES6_Module_Loaders">B.3.2. Polyfills for ES6 Module Loaders</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:es6_module_loader">B.3.2.1. es6-module-loader</a></li>
+<li><a href="appendix_b_module_loading.html#sec:SystemJS">B.3.2.2. SystemJS</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Demo">B.3.2.3. Demo</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#case-study-typescript">B.4. Case Study : TypeScript</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:ES6_Modules_Support">B.4.1. ES6 Modules Support</a></li>
+<li><a href="appendix_b_module_loading.html#sec:TypeScript_and_Module_Loading">B.4.2. TypeScript and Module Loading</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Cyclic_Dependencies">B.5. Cyclic Dependencies</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:Setup">B.5.1. Setup</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Transpile_and_Execute">B.5.2. Transpile and Execute</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Module_Format___AMD">B.5.2.1. Module Format = AMD</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Module_Format___CommonJS">B.5.2.2. Module Format = CommonJS</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Module_Format___SystemJS">B.5.2.3. Module Format = SystemJS</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Conclusion">B.5.3. Conclusion</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#system.register-as-transpilation-target">B.6. System.register as transpilation target</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:Introduction">B.6.1. Introduction</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:External_Transpilers">B.6.1.1. External Transpilers</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Example_of_a_System_register_module">B.6.1.2. Example of a System.register module</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Structure_of_a_System_register_module">B.6.2. Structure of a System.register module</a></li>
+<li><a href="appendix_b_module_loading.html#_transpilation-hints">B.6.3. Transpilation Hints</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Handling_Imports">B.6.3.1. Handling Imports</a></li>
+<li><a href="appendix_b_module_loading.html#sec:__exportFn__">B.6.3.2. &lt;&lt;exportFn&gt;&gt;</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Handling_Exports">B.6.3.3. Handling Exports</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Examples_w__Circular_Dependencies">B.6.4. Examples w/ Circular Dependencies</a></li>
+<li><a href="appendix_b_module_loading.html#sec:N4JS_Examples_w__Circular_Dependencies">B.6.5. N4JS Examples w/ Circular Dependencies</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Unresolved_Cyclic_Dependencies">B.6.5.1. Unresolved Cyclic Dependencies</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Variables___Functions">B.6.5.2. Examples with Variables &amp; Functions</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Classes">B.6.5.3. Examples with Classes</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Examples_with_SubClassing">B.6.5.4. Examples with SubClassing</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Miscellaneous">B.6.5.5. Miscellaneous</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#_resources">B.6.6. Resources</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:CommonJS_as_transpilation_target">B.7. CommonJS as transpilation target</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#_introduction-2">B.7.1. Introduction</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Transpilation_Hints">B.7.2. Transpilation Hints</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Import_Statements">B.7.2.1. Import Statements</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Export_Statements">B.7.2.2. Export Statements</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Tracking_Live_Bindings">B.7.2.3. Tracking Live Bindings</a></li>
+<li><a href="appendix_b_module_loading.html#sec:A_complete_example">B.7.2.4. A complete example</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#_resources-2">B.7.3. Resources</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_c_license.html#sec:License">Appendix C: License</a></li>
+<li><a href="appendix_d_acronyms.html#sec:Acronyms">Appendix D: Acronyms</a></li>
+<li><a href="appendix_e_bibliography_and_footnotes.html#_bibliography-and-footnotes">Appendix E: Bibliography and Footnotes</a></li>
+</ul>
+</div>
+</div>
+<div id="content"><div class="sect1">
+<h2 id="_jsdoc"><a class="anchor" href="#_jsdoc"></a><a class="link" href="#_jsdoc">19. JSDoc</a></h2>
+<div class="sectionbody">
+<div class="admonitionblock warning">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-warning" title=""></i>
+</td>
+<td class="content">
+This chapter may be outdated.
+</td>
+</tr>
+</table>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:Design_Rationale"><a class="anchor" href="#sec:Design_Rationale"></a><a class="link" href="#sec:Design_Rationale">19.1. Design Rationale</a></h3>
+<div class="paragraph">
+<p>JSDoc parser provides general API for parsing and obtaining information embedded in comments. This may have low significance for N4JS itself but is essential when working with JS dialects (e.g. vanilla JS) that use JSDoc comments for enrich given dialect with semantic information. Anticipated uses may include: - type information extraction when importing external code - validation of links between commented fragments - supporting markup for documentation</p>
+</div>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title=""></i>
+</td>
+<td class="content">
+Although current focus is on migration process we want to provide general solution that can be customized for given use cases
+</td>
+</tr>
+</table>
+</div>
+<div class="sect3">
+<h4 id="_general-design"><a class="anchor" href="#_general-design"></a><a class="link" href="#_general-design">19.1.1. General Design</a></h4>
+<div class="paragraph">
+<p>When using the API client has to create instance of DocletParser and configure it with <em>LienTag</em>s and <em>InLineTag</em>s that are to be used.</p>
+</div>
+<div class="paragraph">
+<p>LineTags can depend on InlineTags (e.g. InlineTg in description of parameters of the LineTag). API provides support for that but client has to configure this.</p>
+</div>
+<div id="fig:cd_JSDocParserAPI" class="imageblock center">
+<div class="content">
+<img src="chapters/23_jsdoc/images/cd_JSDocParserAPI.svg" alt="cd JSDocParserAPI">
+</div>
+<div class="title">Figure 49. JSDoc Parser API (without model)</div>
+</div>
+<div class="paragraph">
+<p>Initiated DocletParser can be used to parse <em>String</em> containing given JSDoc comment.Based on provided <em>ITagDefinition</em>s parser will parse input string and return JSDoc DOM AST (see fig. XX with ecore diagram). By querying tree structure client can obtain information extracted form parsed input String.</p>
+</div>
+<div id="fig:cd_JSDocModel" class="imageblock center">
+<div class="content">
+<img src="chapters/23_jsdoc/images/cd_JSDocModel.svg" alt="cd JSDocModel">
+</div>
+<div class="title">Figure 50. JSDoc AST/DOM Model</div>
+</div>
+<div class="paragraph">
+<p>The root of the this AST is the Doclet. The doclet itself contains some content (as it is a Composite containing ContentNodes), usually Description and an arbitrary number of LineTags. LineTags are created by custom ITagDefinition implementations that extend AbstractLineTagDefinition. They contain the title and an arbitrary number of values, stored in a map. These values are Composite nodes as well, containing tag specific content. E.g., the parameter tag will create the values for the parameter type, the parameter name, and the description. Description (in LineTags as well as in doclet itself) is free text with optional InlineTags. InlineTags are created by custom ITagDefinition that extends AbstractInlineTagDefinition. In general tag values are designed as a comprise between a very general tree (basically containing only text nodes) and a structured typed tree (containing type expressions etc.). Although it should be possible to model a tag value by only using Text nodes, some special typed nodes are provided for sake of simplicity (and probably performance). E.g., TypeReferences are modeled using a typed node, in order to simplify external handling of these references (for type analysis, and refactorings such as renaming a type). New typed nodes will probably be introduced (see below). Markers can be attached to nodes for internal purposes. E.g., a marker can be used to distinguish different syntax versions of defining an array (<code>String[]</code> vs. <code>Array&lt;String&gt;</code>).Literals can be used to simplify rewriting. That is, they can contain information on line breaks, JSDoc line prefixes etc., which are not needed for the semantics of a tag, but only for the syntax (not used yet). Also, each node contains a position for simplifying rewriting.</p>
+</div>
+<div id="fig:cd_JSDocParserAndModel" class="imageblock center">
+<div class="content">
+<img src="chapters/23_jsdoc/images/cd_JSDocParserAndModel.svg" alt="cd JSDocParserAndModel">
+</div>
+<div class="title">Figure 51. JSDoc Parser and Model</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Type_Expressions"><a class="anchor" href="#sec:Type_Expressions"></a><a class="link" href="#sec:Type_Expressions">19.1.2. Type Expressions</a></h4>
+<div class="paragraph">
+<p>Type expressions are are not handled by JSDoc Parser by itself as instances of the grammars are use case specific, e.g. for migration purposes grammar for type expressions used in migration process is specific to the in question therefore specific type expressions parser will be provided separately.DocLetParser by default can only extract String representing given type expression, parsing and interpreting it stays in responsibility of given tag implementation provided by the client.</p>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div id="footer">
+<div id="footer-text">
+Version 0.9<br>
+Last updated 2019-08-07 15:02:40 CEST
+</div>
+</div>
+<!-- ************* docinfo-footer *************************************************************** -->
+<div class="Grid social" style="color:#d5dfea">
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <h2>Quick Links</h2>
+    <ul>
+      <li><a href="../downloads.html">Download</a></li>
+      <li><a href="../userguides/index.html">Documentation</a></li>
+      <li><a href="https://github.com/eclipse/n4js/">Source</a></li>
+      <li><a href="https://github.com/eclipse/n4js/issues">Issues</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="https://www.eclipse.org/forums/index.php/f/365/">Forum</a></li>
+      <li><a href="http://n4js.blogspot.de/">Blog</a></li>
+      <li><a href="https://dev.eclipse.org/mailman/listinfo/n4js-dev">Mailing List</a></li>
+      <li><a href="https://projects.eclipse.org/projects/technology.n4js">Eclipse Project Page</a></li>
+      <li><a href="https://twitter.com/n4jsdev">Tweets by n4jsdev</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="http://www.eclipse.org/">Eclipse Home</a></li>
+      <li><a href="http://www.eclipse.org/legal/privacy.php">Privacy Policy</a></li>
+      <li><a href="http://www.eclipse.org/legal/termsofuse.php">Terms of Use</a></li>
+      <li><a href="http://www.eclipse.org/legal/copyright.php">Copyright Agent</a></li>
+      <li><a href="http://www.eclipse.org/legal/">Legal</a></li>
+    </ul>
+  </div>
+  <div style="clear: both; height: 0; overflow: hidden;"></div>
+</div>
+
+<!-- ************* UI Scripts ************* -->
+<script type="text/javascript" src="scripts/back-to-top.js"></script>
+
+<script type="text/javascript" src="scripts/treeview.js"></script>
+<script type="text/javascript" src="scripts/toc.js"></script>
+
+<!-- ************* Prism.js Syntax Highlighting ************* -->
+<script src="scripts/prism.js"></script>
+
+<script type="text/javascript">
+	// Add the 'toclist' id for search function
+	$(".toc2 > ul").attr('id', 'toclist');
+	// Generate a Search input form
+	$("#toclist > li:first-of-type").before('<input type="text" id="pagesearch" onkeyup="search()" placeholder="Search for section...">');
+	$("#toclist > li:first-of-type").before('<i id="clear" class="fa fa-times-circle-o"></i>');
+	$("#clear").click(function(){
+	    $("#pagesearch").val('');
+	    search();
+	    $('.toc2 > ul').treeView('collapseAll');
+	});
+	// intialize Treeview.js
+	$(".toc2 > ul").treeView();
+	// Initialize Scrollspy
+</script>
+<!-- ************* docinfo-footer *************************************************************** -->
+</body>
+</html>
\ No newline at end of file
diff --git a/design/json_support.html b/design/json_support.html
new file mode 100644
index 0000000..ec0d8ce
--- /dev/null
+++ b/design/json_support.html
@@ -0,0 +1,1036 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="generator" content="Asciidoctor 1.5.5">
+<meta name="author" content="2019-08-07 15:02:40 CEST">
+<title>N4JS Design Specification</title>
+<link rel="stylesheet" href="styles/spec.min.css">
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.6.3/css/font-awesome.min.css">
+<!-- ************* docinfo ******************************************************************* -->
+
+
+<!-- ************* Favicon ************-->
+<link rel="icon" href="images/favicon.ico" />
+
+<!-- ************* Back-to-top JQuery ************* -->
+<script src="https://code.jquery.com/jquery-1.12.4.js"></script>
+<script src="https://code.jquery.com/ui/1.12.0/jquery-ui.js"></script>
+
+
+<link href="styles/prism.min.css" rel="stylesheet" />
+<script type="text/javascript" async
+  src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2/MathJax.js?config=TeX-MML-AM_CHTML">
+</script>
+
+<!-- ************* Styles ************* -->
+<link rel="stylesheet" type="text/css" href="styles/n4jsspec-adoc.css">
+
+
+<!-- ****************** NavBar ****************** -->
+<div id="menubar">
+	<div class="banner">
+        <a href="https://www.eclipse.org/n4js/#"><img id="logo" src="images/n4js-logo.png" alt="Eclipse N4JS"></a>
+    </div>
+<ul>
+  <li><a href="index.html">Index</a></li>
+</ul>
+</div>
+<!-- ************* docinfo ******************************************************************* -->
+<style>
+      .admonitionblock td.icon .icon-todo:before{content:"\f249";color:#f4ee42}
+    </style>
+</head>
+<body class="book toc2 toc-left">
+<div id="header">
+<h1>N4JS Design Specification</h1>
+<div class="details">
+<span id="author" class="author">2019-08-07 15:02:40 CEST</span><br>
+<span id="revnumber">version 0.9</span>
+</div>
+<div id="toc" class="toc2">
+<div id="toctitle">Table of Contents</div>
+<ul class="sectlevel1">
+<li><a href="introduction.html#_introduction">1. Introduction</a>
+<ul class="sectlevel2">
+<li><a href="introduction.html#notation">1.1. Notation</a></li>
+<li><a href="introduction.html#sec:IDE_Overview">1.2. IDE Components</a>
+<ul class="sectlevel3">
+<li><a href="introduction.html#sec:Naming_Conventions">1.2.1. Naming Conventions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="eclipse_setup.html#_eclipse-setup">2. Eclipse Setup</a>
+<ul class="sectlevel2">
+<li><a href="eclipse_setup.html#_system-requirements">2.1. System Requirements</a></li>
+<li><a href="eclipse_setup.html#_contribute">2.2. Contribute</a>
+<ul class="sectlevel3">
+<li><a href="eclipse_setup.html#_eclipse-installer">2.2.1. Eclipse Installer</a>
+<ul class="sectlevel4">
+<li><a href="eclipse_setup.html#_changing-the-setup-script">2.2.1.1. Changing the Setup Script</a></li>
+</ul>
+</li>
+<li><a href="eclipse_setup.html#_manual-ide-configuration">2.2.2. Manual IDE Configuration</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="release_engineering.html#_release-engineering">3. Release Engineering</a>
+<ul class="sectlevel2">
+<li><a href="release_engineering.html#_nightly-build-on-eclipse-infrastructure">3.1. Nightly build on Eclipse infrastructure</a></li>
+<li><a href="release_engineering.html#_build-the-n4js-ide-from-command-line">3.2. Build the N4JS IDE from command line</a>
+<ul class="sectlevel3">
+<li><a href="release_engineering.html#_publish-maven-tooling-code-org-eclipse-n4js-releng-util-code">3.2.1. Publish maven-tooling <code>org.eclipse.n4js.releng.util</code></a></li>
+<li><a href="release_engineering.html#sec:test-verdaccio">3.2.2. Test Verdaccio containing n4js-libs</a></li>
+<li><a href="release_engineering.html#_generation-of-eclipse-help-for-spec-and-design-document">3.2.3. Generation of Eclipse help for spec and design document</a></li>
+</ul>
+</li>
+<li><a href="release_engineering.html#_updating-frameworks-and-dependencies">3.3. Updating frameworks and dependencies</a>
+<ul class="sectlevel3">
+<li><a href="release_engineering.html#_update-of-eclipse-emf-xtext-etc">3.3.1. Update of Eclipse, EMF, Xtext, etc.</a></li>
+<li><a href="release_engineering.html#_update-of-the-embedded-jre">3.3.2. Update of the embedded JRE</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tips_and_tricks.html#_tips-and-tricks">4. Tips and Tricks</a>
+<ul class="sectlevel2">
+<li><a href="tips_and_tricks.html#_naming">4.1. Naming</a></li>
+<li><a href="tips_and_tricks.html#_logging">4.2. Logging</a></li>
+<li><a href="tips_and_tricks.html#_cancellation-handling">4.3. Cancellation Handling</a></li>
+<li><a href="tips_and_tricks.html#_caching">4.4. Caching</a></li>
+<li><a href="tips_and_tricks.html#_dependency-injection">4.5. Dependency Injection</a></li>
+<li><a href="tips_and_tricks.html#_miscellaneous">4.6. Miscellaneous</a></li>
+</ul>
+</li>
+<li><a href="parser.html#_parser">5. Parser</a>
+<ul class="sectlevel2">
+<li><a href="parser.html#sec:Parser_Overview">5.1. Overview</a></li>
+<li><a href="parser.html#sec:N4JS_Parser">5.2. N4JS Parser</a></li>
+<li><a href="parser.html#sec:Parser_Generation_Post_Processing">5.3. Parser Generation Post-Processing</a>
+<ul class="sectlevel3">
+<li><a href="parser.html#sec:Automatic_Semicolon_Insertion">5.3.1. Automatic Semicolon Insertion</a>
+<ul class="sectlevel4">
+<li><a href="parser.html#sec:Injected_code_in_the_Antlr_grammar_file">5.3.1.1. Injected code in the Antlr grammar file</a></li>
+<li><a href="parser.html#sec:Customized_error_recovery">5.3.1.2. Customized error recovery</a></li>
+</ul>
+</li>
+<li><a href="parser.html#sec:_No_line_terminator_allowed_here__handling">5.3.2. Async and <code>No line terminator allowed here</code> Handling</a></li>
+<li><a href="parser.html#sec:Regular_Expression">5.3.3. Regular Expression</a></li>
+<li><a href="parser.html#sec:Unicode">5.3.4. Unicode</a></li>
+<li><a href="parser.html#sec:Literals">5.3.5. Literals</a></li>
+</ul>
+</li>
+<li><a href="parser.html#sec:Modifiers">5.4. Modifiers</a></li>
+<li><a href="parser.html#sec:Conflict_Resolutions">5.5. Conflict Resolutions</a>
+<ul class="sectlevel3">
+<li><a href="parser.html#sec:Reserved_Keywords_vs__Identifier_Names">5.5.1. Reserved Keywords vs. Identifier Names</a></li>
+<li><a href="parser.html#sec:Operators_and_Generics">5.5.2. Operators and Generics</a></li>
+</ul>
+</li>
+<li><a href="parser.html#sec:Content_Assist_Parser">5.6. Content-Assist Parser</a></li>
+</ul>
+</li>
+<li><a href="type_system.html#_type-system">6. Type System</a>
+<ul class="sectlevel2">
+<li><a href="type_system.html#sec:Type_Model_and_Grammar">6.1. Type Model and Grammar</a>
+<ul class="sectlevel3">
+<li><a href="type_system.html#sec:Type_Model_Overview">6.1.1. Type Model Overview</a></li>
+<li><a href="type_system.html#sec:Built_in_Types">6.1.2. Built-in and Primitive Types</a></li>
+<li><a href="type_system.html#sec:Type_Model_DSL">6.1.3. Type Model DSL</a></li>
+</ul>
+</li>
+<li><a href="type_system.html#sec:Type_System_Implementation">6.2. Type System Implementation</a></li>
+<li><a href="type_system.html#sec:Type_Inference_combined_with_AST_Traversal">6.3. Type Inference of AST</a>
+<ul class="sectlevel3">
+<li><a href="type_system.html#sec:Type_Inference_combined_with_AST_Traversal__Background">6.3.1. Background</a></li>
+<li><a href="type_system.html#sec:Triggering_Type_Inference_of_AST">6.3.2. Triggering</a></li>
+<li><a href="type_system.html#sec:Traversal_Order_During_Type_Inference_of_AST">6.3.3. Traversal Order</a></li>
+<li><a href="type_system.html#sec:Cross_References_During_Type_Inference_of_AST">6.3.4. Cross-References</a></li>
+<li><a href="type_system.html#sec:Function_Accessor_Bodies_During_Type_Inference_of_AST">6.3.5. Function/Accessor Bodies</a></li>
+<li><a href="type_system.html#sec:Poly_Expressions_During_Type_Inference_of_AST">6.3.6. Poly Expressions</a></li>
+<li><a href="type_system.html#sec:Constraint_Solver_used_During_Type_Inference_of_AST">6.3.7. Constraint Solver</a></li>
+<li><a href="type_system.html#sec:Type_Guards_During_Type_Inference_of_AST">6.3.8. Type Guards</a></li>
+</ul>
+</li>
+<li><a href="type_system.html#sec:Structural_Typing">6.4. Structural Typing</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#_type-index">7. Type Index</a>
+<ul class="sectlevel2">
+<li><a href="type_index.html#sec:Type_Index_Design_Rationale">7.1. Design Rationale</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#sec:Getting_the_Xtext_Index_Content_IResourceDescriptions">7.1.1. Getting the Xtext Index (<code>IResourceDescriptions</code>) Content</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#sec:Design_Overview">7.2. Design Overview</a></li>
+<li><a href="type_index.html#sec:N4JS_Resource_Load_States">7.3. N4JS Resource Load States</a></li>
+<li><a href="type_index.html#sec:Type_Builder">7.4. Types Builder</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#sec:Type_Inference_not_allowed_in_Type_Builder">7.4.1. Type Inference not allowed in Types Builder</a></li>
+<li><a href="type_index.html#sec:ComputedTypeReferences">7.4.2. Deferred Type References</a></li>
+<li><a href="type_index.html#sec:Use_cases_of_ComputedTypeRef">7.4.3. Use cases of DeferredTypeRef</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#sec:Incremental_Builder_Overview">7.5. Incremental Builder (Overview)</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#sec:Incremental_Builder_Overview__XtextBuilder">7.5.1. XtextBuilder</a></li>
+<li><a href="type_index.html#sec:Incremental_Builder_Overview__IBuilderState">7.5.2. IBuilderState</a>
+<ul class="sectlevel4">
+<li><a href="type_index.html#copy-and-update-xtext-index">7.5.2.1. Copy and Update Xtext Index</a></li>
+<li><a href="type_index.html#build-state-setup-phase">7.5.2.2. Build State Setup Phase</a></li>
+<li><a href="type_index.html#process-queued-uris">7.5.2.3. Process Queued URIs</a></li>
+<li><a href="type_index.html#queueing-affected-resources">7.5.2.4. Queueing Affected Resources</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#sec:Incremental_Builder_Overview__Example">7.5.3. Example</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#dirty-state-handling">7.6. Dirty state handling</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#use-case-restoring-types-from-user-data">7.6.1. Use case: Restoring types from user data</a></li>
+<li><a href="type_index.html#use-case-updating-the-xtext-index">7.6.2. Use case: Updating the Xtext index</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="project_model.html#_project-model">8. Project Model</a>
+<ul class="sectlevel2">
+<li><a href="project_model.html#sec:Package_json">8.1. Package.json File</a></li>
+<li><a href="project_model.html#_accessing-project-information">8.2. Accessing Project Information</a>
+<ul class="sectlevel3">
+<li><a href="project_model.html#sec:IN4JSCore">8.2.1. IN4JSCore</a></li>
+<li><a href="project_model.html#sec:N4JSModel">8.2.2. N4JSModel</a></li>
+<li><a href="project_model.html#sec:N4JSWorkspace">8.2.3. N4JSWorkspace</a></li>
+<li><a href="project_model.html#sec:N4JSProject">8.2.4. N4JSProject</a></li>
+<li><a href="project_model.html#sec:SourceContainer">8.2.5. SourceContainer</a></li>
+<li><a href="project_model.html#sec:N4JSProjectsStateHelper">8.2.6. N4JSProjectsStateHelper</a></li>
+</ul>
+</li>
+<li><a href="project_model.html#sec:Caching">8.3. Caching</a>
+<ul class="sectlevel3">
+<li><a href="project_model.html#_caching-of-externallibraryworkspace">8.3.1. Caching of ExternalLibraryWorkspace</a></li>
+<li><a href="project_model.html#_caching-of-n4jsprojectsstatehelper">8.3.2. Caching of N4JSProjectsStateHelper</a></li>
+</ul>
+</li>
+<li><a href="project_model.html#sec:WildcardPathFilter">8.4. WildcardPathFilter</a></li>
+<li><a href="project_model.html#sec:ProjectUtils">8.5. ProjectUtils</a></li>
+</ul>
+</li>
+<li><a href="binding.html#_binding">9. Binding</a>
+<ul class="sectlevel2">
+<li><a href="binding.html#sec:Binding_Design_Rationale">9.1. Design Rationale</a></li>
+<li><a href="binding.html#sec:Binding_to_Members">9.2. Binding to Members</a></li>
+<li><a href="binding.html#sec:Binding_Getter_Setter">9.3. Getter / Setter Binding</a></li>
+<li><a href="binding.html#chap:Statics">9.4. Static Member Binding</a></li>
+<li><a href="binding.html#sec:Binding_Enumeration">9.5. Enumeration Literals Binding</a></li>
+<li><a href="binding.html#sec:Accessibility_of_types_and_members">9.6. Accessibility of types and members</a></li>
+<li><a href="binding.html#sec:Member_Scope_Example">9.7. Member Scope Example</a></li>
+<li><a href="binding.html#sec:Scoping_for_Members_of_Composed_Type_Explained">9.8. Scoping for Members of Composed Type (Union/Intersection) Example</a></li>
+<li><a href="binding.html#sec:Binding_of_Structurally_References_Types">9.9. Structurally References Types</a></li>
+<li><a href="binding.html#sec:Building">9.10. Building</a>
+<ul class="sectlevel3">
+<li><a href="binding.html#sec:Build_Phases">9.10.1. Build Phases</a></li>
+<li><a href="binding.html#sec:Build_Scenarios">9.10.2. Build Scenarios</a></li>
+<li><a href="binding.html#sec:Lazy_linking_problem">9.10.3. Lazy linking problem</a></li>
+</ul>
+</li>
+<li><a href="binding.html#sec:Proxies_and_Proxy_Resolution">9.11. Proxies and Proxy Resolution (Overview)</a>
+<ul class="sectlevel3">
+<li><a href="binding.html#xtexts-lazy-linking-proxies">9.11.1. Xtext’s Lazy Linking Proxies</a></li>
+<li><a href="binding.html#standard-emf-proxies">9.11.2. Standard EMF Proxies</a></li>
+<li><a href="binding.html#_how-is-proxy-resolution-triggered">9.11.3. How is Proxy Resolution Triggered?</a></li>
+<li><a href="binding.html#_when-is-proxy-resolution-allowed">9.11.4. When is Proxy Resolution Allowed?</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="validation.html#_validation">10. Validation</a>
+<ul class="sectlevel2">
+<li><a href="validation.html#sec:validation_overview">10.1. Validation overview</a></li>
+<li><a href="validation.html#sec:validation_control_flow">10.2. Validation control flow</a></li>
+<li><a href="validation.html#sec:validation_issue_ids">10.3. Issue IDs and Messages</a></li>
+<li><a href="validation.html#sec:validation_usage_patterns">10.4. Usage Pattern</a></li>
+<li><a href="validation.html#sec:validation_links">10.5. Links</a></li>
+</ul>
+</li>
+<li><a href="references.html#_references">11. References</a>
+<ul class="sectlevel2">
+<li><a href="references.html#sec:usecases">11.1. Use cases</a></li>
+<li><a href="references.html#sec:calculation_algorithm">11.2. Calculation algorithm</a>
+<ul class="sectlevel3">
+<li><a href="references.html#sec:Xtext_default_implementation">11.2.1. Xtext default implementation</a></li>
+<li><a href="references.html#sec:N4_implementation">11.2.2. N4JS implementation</a></li>
+</ul>
+</li>
+<li><a href="references.html#sec:PerformanceOfDependencyCalculation">11.3. Performance Of Dependency Calculation</a></li>
+<li><a href="references.html#sec:kinds_of_references">11.4. Kinds of references</a>
+<ul class="sectlevel3">
+<li><a href="references.html#sec:Cross_References_to_be_ignored">11.4.1. Cross References to be ignored</a></li>
+<li><a href="references.html#sec:Cross_References_to_be_handled">11.4.2. Cross References to be handled</a></li>
+</ul>
+</li>
+<li><a href="references.html#sec:transitive_dependencies">11.5. Transitive dependencies</a></li>
+<li><a href="references.html#sec:find-references">11.6. Find references</a>
+<ul class="sectlevel3">
+<li><a href="references.html#_background">11.6.1. Background</a></li>
+<li><a href="references.html#_how-find-references-work">11.6.2. How Find References Work</a>
+<ul class="sectlevel4">
+<li><a href="references.html#_step-1-convert-cursor-position-to-declared-element">11.6.2.1. Step 1: Convert Cursor Position to Declared Element</a></li>
+<li><a href="references.html#_step-2-convert-declared-element-to-target-uris">11.6.2.2. Step 2: Convert Declared Element to Target URIs</a></li>
+<li><a href="references.html#_step-3-filter-potential-resources">11.6.2.3. Step 3: Filter Potential Resources</a></li>
+<li><a href="references.html#_step-4-search-references-in-resource">11.6.2.4. Step 4: Search References in Resource</a></li>
+<li><a href="references.html#_limitations-and-possible-enhancements">11.6.2.5. Limitations and Possible Enhancements</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="compilation.html#_compilation">12. Compilation</a>
+<ul class="sectlevel2">
+<li><a href="compilation.html#chap:compilation">12.1. Introduction</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:general_design_rationals">12.1.1. General design rationals</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:logging_and_error_reporting">12.1.1.1. Logging and error reporting</a></li>
+<li><a href="compilation.html#sec:progress_monitor">12.1.1.2. Progress monitor</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Xtext_Integration">12.1.2. Xtext Integration</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:xtext_default_behaviour">12.1.2.1. Xtext default behaviour</a></li>
+<li><a href="compilation.html#sec:n4js_requirements">12.1.2.2. N4JS requirements</a></li>
+<li><a href="compilation.html#sec:compiler_discovery_in_ui">12.1.2.3. Compiler discovery in UI</a></li>
+<li><a href="compilation.html#sec:compiler_discovery_in_headless">12.1.2.4. Compiler discovery in headless</a></li>
+<li><a href="compilation.html#sec:general_generator_implementation">12.1.2.5. General generator implementation</a></li>
+<li><a href="compilation.html#sec:general_generator_activation">12.1.2.6. General generator activation</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Overview_of_Input_Models">12.1.3. Overview of the Input Models</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Core_Generator">12.2. Generators</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:Compiler_Components">12.2.1. Generator Components</a></li>
+<li><a href="compilation.html#sec:Generator_architecture">12.2.2. Generator architecture</a></li>
+<li><a href="compilation.html#sec:Unified_Compiler_Configuration">12.2.3. Unified Compiler Configuration</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Transpilers">12.3. Transpilers</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:Phases">12.3.1. Overview</a></li>
+<li><a href="compilation.html#relation-between-ast-and-im">12.3.2. Relation between AST and IM</a></li>
+<li><a href="compilation.html#implementation-overview">12.3.3. Implementation Overview</a></li>
+<li><a href="compilation.html#sec:Guidelines_for_Implementing_Transformations">12.3.4. Guidelines for Implementing Transformations</a></li>
+<li><a href="compilation.html#symbol-table-in-the-im">12.3.5. Symbol Table in the IM</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:N4JS_to_EcmaScript_Transpiler">12.4. N4JS-to-EcmaScript Transpiler</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:Overview_of_Transformations">12.4.1. Overview of Transformations</a></li>
+<li><a href="compilation.html#sec:Transpiling_members">12.4.2. Transpiling members</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:Transpiling_members__Delegating_members">12.4.2.1. Techniques for special member handling</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__Partial_shadowing_of_getter_setter_pairs">12.4.2.2. Partial shadowing</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__Consuming_or_inheriting_members_of_an_interface">12.4.2.3. Consuming or inheriting members of an interface</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__Static_polyfill">12.4.2.4. Static polyfill</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__API_implementation_stubs">12.4.2.5. API / implementation stubs</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Support_for_incomplete_API_implementation_testing_in_the_N4JS_to_EcmaScript_5_Transpiler">12.4.3. Support for incomplete API implementation testing</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:Modifications_in_Impl_projects">12.4.3.1. Modifications in Impl projects</a></li>
+<li><a href="compilation.html#sec:Implementation_of_stub_generation">12.4.3.2. Implementation of stub-generation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:n4jsc_Headless_Compiler_Interface">12.5. n4jsc Headless Compiler Interface</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:building_the_headless_compiler">12.5.1. building the headless compiler</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="execution.html#_execution">13. Execution</a>
+<ul class="sectlevel2">
+<li><a href="execution.html#sec:N4JS_Project_Execution_And_Linking_Model">13.1. N4JS Project Execution And Linking Model</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#subsec:N4JS_Execution_With_NodeJS">13.1.1. N4JS Execution With NodeJS</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:N4JS_Execution_And_Linking_File">13.2. N4JS Execution And Linking File</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#subsec:NodeJS_Specific_ELF">13.2.1. NodeJS Specific ELF</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Runners-execution">13.3. Runners</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#subsec:N4_Runtime_Environments_Convention">13.3.1. N4 Runtime Environments Convention</a></li>
+<li><a href="execution.html#subsec:Passing_Information_from_IDE_to_Execution_Code_in_Runtime_Environment">13.3.2. Passing Information from IDE to Execution Code in Runtime Environment</a></li>
+<li><a href="execution.html#subsec:Runners_Design">13.3.3. Runners Design</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Legacy_Execution_Engine">13.4. Legacy Execution Engine</a></li>
+<li><a href="execution.html#sec:Design">13.5. Design</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#sec:Usage_Outside_N4JSIDE">13.5.1. Usage Outside N4JSIDE</a>
+<ul class="sectlevel4">
+<li><a href="execution.html#sec:Use_Node_with_Maven">13.5.1.1. Use Node with Maven</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Usage_Inside_N4JSIDE">13.5.2. Usage Inside N4JSIDE</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Runtime_Injection">13.6. Runtime Injection</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#sec:Running_String_Code">13.6.1. Running String Code</a></li>
+<li><a href="execution.html#sec:Running_File_Code">13.6.2. Running File Code</a></li>
+<li><a href="execution.html#sec:Injection_Code_Example">13.6.3. Injection Code Example</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#_tests">14. Tests</a>
+<ul class="sectlevel2">
+<li><a href="tests.html#sec:Performance_Tests">14.1. Performance Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Synthetic_Performance_Tests">14.1.1. Synthetic Performance Tests</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:Design_of_Generator">14.1.1.1. Design of Generator</a></li>
+<li><a href="tests.html#sec:Design_of_Performance_Test_Execution">14.1.1.2. Design of Performance Test Configuration and Execution</a></li>
+<li><a href="tests.html#sec:JUnit_Configuration">14.1.1.3. JUnit Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Test_Configuration">14.1.1.4. JUnitBenchmark Test Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Report_Configuration">14.1.1.5. JUnitBenchmark Report Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Run_Configuration">14.1.1.6. JUnitBenchmark Run Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Example">14.1.1.7. JUnitBenchmark Example</a></li>
+<li><a href="tests.html#sec:Note_on_Jenkins_Job">14.1.1.8. Note on Jenkins Job</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#sec:ECMA_Tests">14.2. ECMA Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Grammar_Tests">14.2.1. Grammar Tests</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:Negative_Tests">14.2.1.1. Negative Tests</a></li>
+<li><a href="tests.html#sec:Test_Exclusion">14.2.1.2. Test Exclusion</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Integration_Tests">14.3. Integration Tests</a></li>
+<li><a href="tests.html#sec:Test_Helpers">14.4. Test Helpers</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Parameterized_N4JS_Tests">14.4.1. Parameterized N4JS tests</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:ParameterizedXtextRunner">14.4.1.1. ParameterizedXtextRunner</a></li>
+<li><a href="tests.html#sec:TestCodeProvider">14.4.1.2. TestCodeProvider</a></li>
+<li><a href="tests.html#sec:Example_Of_Parameterized_Parser_Test">14.4.1.3. Example of parameterized parser test</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Issue_Suppression">14.5. Issue Suppression</a></li>
+<li><a href="tests.html#sec:Xpect_Tests">14.6. Xpect Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Xpect_Test_Setup">14.6.1. Xpect Test Setup</a></li>
+<li><a href="tests.html#sec:Xpect_Issue_Suppression">14.6.2. Xpect Issue Suppression</a></li>
+<li><a href="tests.html#sec:Xpect_Provided_Test_Methods">14.6.3. Xpect Provided Test Methods</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#errors">14.6.3.1. errors</a></li>
+<li><a href="tests.html#warnings">14.6.3.2. warnings</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:N4JS_Specific_Xpect_Test_Methods">14.6.4. N4JS Specific Xpect Test Methods</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:XPECT_noerrors">14.6.4.1. noerrors and nowarnings</a></li>
+<li><a href="tests.html#sec:XPECT_scope">14.6.4.2. scope</a></li>
+<li><a href="tests.html#sec:XPECT_scopeWithPosition">14.6.4.3. scopeWithPosition</a></li>
+<li><a href="tests.html#sec:XPECT_scopeWithResource">14.6.4.4. scopeWithResource</a></li>
+<li><a href="tests.html#sec:XPECT_binding">14.6.4.5. binding</a></li>
+<li><a href="tests.html#sec:XPECT_linkedPathname">14.6.4.6. linkedPathname</a></li>
+<li><a href="tests.html#sec:XPECT_type_of">14.6.4.7. type of</a></li>
+<li><a href="tests.html#sec:XPECT_expectedType">14.6.4.8. expectedType</a></li>
+<li><a href="tests.html#sec:XPECT_elementKeyword">14.6.4.9. elementKeyword</a></li>
+<li><a href="tests.html#sec:XPECT_accessModifier">14.6.4.10. accessModifier</a></li>
+<li><a href="tests.html#sec:XPECT_compileResult">14.6.4.11. compileResult</a></li>
+<li><a href="tests.html#sec:XPECT_output">14.6.4.12. output</a></li>
+<li><a href="tests.html#sec:XPECT_outputRegEx">14.6.4.13. outputRegEx</a></li>
+<li><a href="tests.html#sec:XPECT_calculatedAccessModifier">14.6.4.14. calculatedAccessModifier</a></li>
+<li><a href="tests.html#sec:XPECT_spec">14.6.4.15. spec</a></li>
+<li><a href="tests.html#sec:XPECT_deadCode">14.6.4.16. deadCode</a></li>
+<li><a href="tests.html#sec:XPECT_returnOrThrows">14.6.4.17. returnOrThrows</a></li>
+<li><a href="tests.html#sec:XPECT_lint">14.6.4.18. lint</a></li>
+<li><a href="tests.html#sec:XPECT_lintFails">14.6.4.19. lintFails</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:FIXME_Xpect_modifier">14.6.5. FIXME Xpect modifier</a></li>
+<li><a href="tests.html#sec:Expectmatrix_Xpect_Test_Methods">14.6.6. Expectmatrix Xpect tests</a></li>
+<li><a href="tests.html#xpect-lint-tests">14.6.7. Xpect Lint Tests</a></li>
+</ul>
+</li>
+<li><a href="tests.html#xpect-proposal-tests">14.7. Xpect Proposal Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Validation_vs__Non_Validation">14.7.1. Validation vs. Non-Validation</a></li>
+<li><a href="tests.html#sec:General_Proposal_Test_Features">14.7.2. General Proposal Test Features</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:Test_Variables">14.7.2.1. Test Variables</a></li>
+<li><a href="tests.html#sec:Location_and_Selection">14.7.2.2. at – Location and Selection</a></li>
+<li><a href="tests.html#sec:Multi_Line_Expectations_in_Proposal_Tests">14.7.2.3. Multi Line Expectations in Proposal Tests</a></li>
+<li><a href="tests.html#sec:Timeout">14.7.2.4. Timeout and Performance</a></li>
+</ul>
+</li>
+<li><a href="tests.html#proposals-verify-existence-of-proposals">14.7.3. proposals – Verify Existence of Proposals</a></li>
+<li><a href="tests.html#sec:Verify_displayed_string">14.7.4. display – Verify displayed string</a></li>
+<li><a href="tests.html#sec:Apply_Proposal">14.7.5. apply – Apply Proposal</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#resource-application-in-other-files">14.7.5.1. resource – application in other files</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Content_Assist_Cycling">14.7.6. kind – Content Assist Cycling</a></li>
+<li><a href="tests.html#fileValidVerify-validation-status">14.7.7. fileValid – Verify validation status</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Apply_Proposal_And_Execute_Tests">14.8. Apply Proposal And Execute Tests</a></li>
+<li><a href="tests.html#sec:Organize_Imports_Test">14.9. Organize Imports Test</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#organizeimports">14.9.1. organizeImports</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Access_Control_Test">14.10. Access Control Test</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#test-scenarios">14.10.1. Test Scenarios</a></li>
+<li><a href="tests.html#n4js-code-generator">14.10.2. N4JS Code Generator</a></li>
+<li><a href="tests.html#xtext-issue-matcher">14.10.3. Xtext Issue Matcher</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Smoke_Tests">14.11. Smoke Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#how-to-handle-smoke-test-errors">14.11.1. How to handle smoke test errors?</a></li>
+<li><a href="tests.html#smoketester-and-exceptionanalyzer">14.11.2. SmokeTester and ExceptionAnalyzer</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:UI_Tests_with_SWTBot">14.12. UI Tests with SWTBot</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#writing-swtbot-tests">14.12.1. Writing SWTBot Tests</a></li>
+<li><a href="tests.html#running-swtbot-tests">14.12.2. Running SWTBot Tests</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Debugging_UI_Tests">14.13. Debugging UI Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Connecting_to_the_X_server_on_the_build_node">14.13.1. Connecting to the X-server on the build-node</a></li>
+<li><a href="tests.html#sec:Tools_to_investigate_the_java_stack">14.13.2. Tools to investigate the java-stack</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="ui_concepts.html#_ui-concepts">15. UI Concepts</a>
+<ul class="sectlevel2">
+<li><a href="ui_concepts.html#sec:User_Interface_Concepts">15.1. User Interface Concepts</a>
+<ul class="sectlevel3">
+<li><a href="ui_concepts.html#sec:Eclipse_UI_Concepts">15.1.1. Eclipse UI Concepts</a>
+<ul class="sectlevel4">
+<li><a href="ui_concepts.html#sec:Label_Provider">15.1.1.1. Label Provider</a></li>
+<li><a href="ui_concepts.html#sec:Markers">15.1.1.2. Markers</a></li>
+<li><a href="ui_concepts.html#sec:Commands__Toolbar_and_Menus">15.1.1.3. Commands, Toolbar and Menus</a></li>
+<li><a href="ui_concepts.html#sec:Content_Assist">15.1.1.4. Content Assist</a></li>
+<li><a href="ui_concepts.html#sec:Quick_Fixes">15.1.1.5. Quick Fixes</a></li>
+<li><a href="ui_concepts.html#sec:Quick_Assist">15.1.1.6. Quick Assist</a></li>
+<li><a href="ui_concepts.html#sec:Clean_Up_Actions">15.1.1.7. Clean Up Actions</a></li>
+<li><a href="ui_concepts.html#sec:Save_Actions">15.1.1.8. Save Actions</a></li>
+<li><a href="ui_concepts.html#sec:Auto_Edit">15.1.1.9. Auto Edit</a></li>
+<li><a href="ui_concepts.html#sec:Template_Proposals">15.1.1.10. Template Proposals</a></li>
+<li><a href="ui_concepts.html#sec:Outline_View___Quick_Outline">15.1.1.11. Outline View / Quick Outline</a></li>
+<li><a href="ui_concepts.html#sec:Navigator__Package_Explorer__Project_Explorer">15.1.1.12. Navigator, Package Explorer, Project Explorer</a></li>
+<li><a href="ui_concepts.html#sec:Hyperlinking_and_Navigation">15.1.1.13. Hyperlinking and Navigation</a></li>
+<li><a href="ui_concepts.html#sec:Syntax_and_Semantic_Coloring">15.1.1.14. Syntax and Semantic Coloring</a></li>
+<li><a href="ui_concepts.html#sec:Code_Formatter">15.1.1.15. Code Formatter</a></li>
+<li><a href="ui_concepts.html#sec:Wizards">15.1.1.16. Wizards</a></li>
+<li><a href="ui_concepts.html#sec:Cheat_Sheets">15.1.1.17. Cheat Sheets</a></li>
+<li><a href="ui_concepts.html#sec:Context_sensitive_Help">15.1.1.18. Context-sensitive Help</a></li>
+<li><a href="ui_concepts.html#sec:Hovers">15.1.1.19. Hovers</a></li>
+<li><a href="ui_concepts.html#sec:Folding">15.1.1.20. Folding</a></li>
+<li><a href="ui_concepts.html#sec:Customizable_validation___severity">15.1.1.21. Customizable validation / severity</a></li>
+<li><a href="ui_concepts.html#sec:Proposals">15.1.1.22. Proposals</a></li>
+</ul>
+</li>
+<li><a href="ui_concepts.html#sec:Non_Eclipse_UI_Concepts">15.1.2. Non-Eclipse UI Concepts</a>
+<ul class="sectlevel4">
+<li><a href="ui_concepts.html#sec:Overlays">15.1.2.1. Overlays</a></li>
+<li><a href="ui_concepts.html#sec:Goto__Inferred__Type">15.1.2.2. Goto (Inferred) Type</a></li>
+<li><a href="ui_concepts.html#sec:Postfix_Completion">15.1.2.3. Postfix Completion</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="ui_concepts.html#_user-interface-resources">15.2. User Interface Resources</a>
+<ul class="sectlevel3">
+<li><a href="ui_concepts.html#_icons">15.2.1. Icons</a>
+<ul class="sectlevel4">
+<li><a href="ui_concepts.html#_eclipse-platform-icons">15.2.1.1. Eclipse Platform Icons</a></li>
+<li><a href="ui_concepts.html#_n4js-specific-icons">15.2.1.2. N4JS Specific Icons</a></li>
+<li><a href="ui_concepts.html#_high-resolution-icons">15.2.1.3. High Resolution Icons</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="formatting.html#_formatting">16. Formatting</a>
+<ul class="sectlevel2">
+<li><a href="formatting.html#sec:FmtObjective">16.1. Objective</a>
+<ul class="sectlevel3">
+<li><a href="formatting.html#sec:FmtFormatting_Comments">16.1.1. Formatting Comments</a></li>
+</ul>
+</li>
+<li><a href="formatting.html#sec:FmtArchitecture">16.2. Architecture</a>
+<ul class="sectlevel3">
+<li><a href="formatting.html#sec:Implementation_example">16.2.1. Implementation example</a></li>
+</ul>
+</li>
+<li><a href="formatting.html#sec:FmtFormatter_Implementation_Guidelines">16.3. Formatter Implementation Guidelines</a></li>
+<li><a href="formatting.html#sec:FmtConfiguration">16.4. Configuration</a></li>
+<li><a href="formatting.html#sec:FmtUI_Integration">16.5. UI Integration</a></li>
+<li><a href="formatting.html#sec:FmtUnit_Testing_with_Xpect">16.6. Unit Testing with Xpect</a></li>
+</ul>
+</li>
+<li><a href="external_libraries.html#_external-libraries">17. External Libraries</a>
+<ul class="sectlevel2">
+<li><a href="external_libraries.html#sec:Major_Components">17.1. Major Components</a>
+<ul class="sectlevel3">
+<li><a href="external_libraries.html#subsec:External_Resources">17.1.1. External Resources</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Workspace">17.1.2. External Library Workspace</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Preference_Store">17.1.3. External Library Preference Store</a></li>
+<li><a href="external_libraries.html#subsec:npm_Manager">17.1.4. Library Manager</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Builder_Helper">17.1.5. External Library Builder</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Xtext_Index_Persister">17.1.6. External Library Xtext Index Persister</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Preference_Page">17.1.7. External Library Preference Page</a></li>
+</ul>
+</li>
+<li><a href="external_libraries.html#sec:Headless_External_Library_Support">17.2. Headless External Library Support</a>
+<ul class="sectlevel3">
+<li><a href="external_libraries.html#_custom-npm-settings">17.2.1. Custom npm settings</a></li>
+</ul>
+</li>
+<li><a href="external_libraries.html#sec:lmFutureWork">17.3. Future Work</a>
+<ul class="sectlevel3">
+<li><a href="external_libraries.html#subsec:lmMultipleDependencyScope">17.3.1. Multiple Dependency Scope</a></li>
+<li><a href="external_libraries.html#subsec:lmRunTestsFromLibrary">17.3.2. Run Tests from TestLibrary</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#sec:JSON_Support">18. JSON Support</a>
+<ul class="sectlevel2">
+<li><a href="#sec:JSON_Parser">18.1. JSON Parser</a>
+<ul class="sectlevel3">
+<li><a href="#sec:JSON_Parser_Unicode_Escaping">18.1.1. Escaping Unicode Control Characters in String Literals</a></li>
+<li><a href="#sec:JSON_Parser_Empty_Text">18.1.2. Empty Text</a></li>
+<li><a href="#sec:JSON_Parser_Nested_Structures">18.1.3. Nested Structures</a></li>
+<li><a href="#sec:JSON_Parser_Whitespace">18.1.4. Whitespace</a></li>
+<li><a href="#sec:JSON_Parser_Comments">18.1.5. Comments</a></li>
+</ul>
+</li>
+<li><a href="#sec:JSON_Language_Extensions">18.2. JSON Language Extensions</a>
+<ul class="sectlevel3">
+<li><a href="#sec:JSON_Validator_Extensions">18.2.1. JSON Validator Extensions</a>
+<ul class="sectlevel4">
+<li><a href="#sec:File_Specitic_Validator_Extensions">18.2.1.1. File-Specific Validator Extensions</a></li>
+<li><a href="#sec:JSON_Declarative_JSON_Validator_Extensions">18.2.1.2. Declarative JSON Validator Extensions</a></li>
+</ul>
+</li>
+<li><a href="#_json-resource-description-strategy">18.2.2. JSON Resource Description Strategy</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_jsdoc">19. JSDoc</a>
+<ul class="sectlevel2">
+<li><a href="jsdoc.html#sec:Design_Rationale">19.1. Design Rationale</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#_general-design">19.1.1. General Design</a></li>
+<li><a href="jsdoc.html#sec:Type_Expressions">19.1.2. Type Expressions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="docexporter.html#_docexporter">20. DocExporter</a>
+<ul class="sectlevel2">
+<li><a href="docexporter.html#sec:Specification_Exporter">20.1. Specification Exporter</a></li>
+</ul>
+</li>
+<li><a href="rename_refactoring.html#_rename-refactoring">21. Rename Refactoring</a>
+<ul class="sectlevel2">
+<li><a href="rename_refactoring.html#_rename-refactoring-ui-interaction">21.1. Rename Refactoring UI interaction</a></li>
+<li><a href="rename_refactoring.html#_renameelementprocessor-interaction">21.2. RenameElementProcessor interaction</a></li>
+</ul>
+</li>
+<li><a href="flow_graphs.html#chap:flowgraphs">22. Flow Graphs</a>
+<ul class="sectlevel2">
+<li><a href="flow_graphs.html#sec:flowgraphs_overview">22.1. Flow graphs overview</a>
+<ul class="sectlevel3">
+<li><a href="flow_graphs.html#_internal-graph">22.1.1. Internal graph</a></li>
+<li><a href="flow_graphs.html#_optimizations">22.1.2. Optimizations</a></li>
+<li><a href="flow_graphs.html#_api-for-client-analyses">22.1.3. API for client analyses</a>
+<ul class="sectlevel4">
+<li><a href="flow_graphs.html#_mapping-from-internal-to-ast-elements">22.1.3.1. Mapping from internal to AST elements</a></li>
+<li><a href="flow_graphs.html#_graph-visitor">22.1.3.2. Graph visitor</a></li>
+<li><a href="flow_graphs.html#_graph-explorer">22.1.3.3. Graph explorer</a></li>
+<li><a href="flow_graphs.html#_branch-walker">22.1.3.4. Branch walker</a></li>
+<li><a href="flow_graphs.html#_example-1-compute-string-for-each-path">22.1.3.5. Example 1: Compute string for each path</a></li>
+<li><a href="flow_graphs.html#_path-quantor">22.1.3.6. Path quantor</a></li>
+</ul>
+</li>
+<li><a href="flow_graphs.html#_control-flow-analyses">22.1.4. Control flow analyses</a>
+<ul class="sectlevel4">
+<li><a href="flow_graphs.html#_dead-code-analysis">22.1.4.1. Dead code analysis</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="flow_graphs.html#sec:dataflow">22.2. Dataflow</a>
+<ul class="sectlevel3">
+<li><a href="flow_graphs.html#_dataflow-graph">22.2.1. Dataflow graph</a></li>
+<li><a href="flow_graphs.html#_dataflow-analyses">22.2.2. Dataflow analyses</a>
+<ul class="sectlevel4">
+<li><a href="flow_graphs.html#_def-def-def-nothing-analysis">22.2.2.1. Def&#8594;Def / Def&#8594;Nothing analysis</a></li>
+<li><a href="flow_graphs.html#_def-use-decl-analysis">22.2.2.2. Def|Use&#8592;Decl analysis</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="publish_npms.html#sec:publish-npms-to-public">23. Publish npms</a>
+<ul class="sectlevel2">
+<li><a href="publish_npms.html#sec:publish-npms-n4js-maven">23.1. Publish n4js-libs to during  maven build</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Hints">Appendix A: Hints</a>
+<ul class="sectlevel2">
+<li><a href="appendix_a_hints.html#sec:XtextInjection">A.1. Xtext Injection</a>
+<ul class="sectlevel3">
+<li><a href="appendix_a_hints.html#sec:DI_MultipleInjectors_Singletons">A.1.1. Multiple Injectors and Singletons</a>
+<ul class="sectlevel4">
+<li><a href="appendix_a_hints.html#sec:DI_avoid_duplicate_singletons">A.1.1.1. Avoiding duplicate singletons</a>
+<ul class="sectlevel5">
+<li><a href="appendix_a_hints.html#sec:DI_binding_in_shared">A.1.1.1.1. Defining binding in the shared injector</a></li>
+<li><a href="appendix_a_hints.html#sec:DI_binding_in_custom">A.1.1.1.2. Defining binding in the custom injector</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:DI_Hints">A.1.2. Dependency Injection Hints</a>
+<ul class="sectlevel4">
+<li><a href="appendix_a_hints.html#sec:DI_custom_bundle">A.1.2.1. Use DI in custom bundle, use DI with extensions</a>
+<ul class="sectlevel5">
+<li><a href="appendix_a_hints.html#sec:DI_custom_bundle_problem">A.1.2.1.1. Problem</a></li>
+<li><a href="appendix_a_hints.html#sec:DI_custom_bundle_solution">A.1.2.1.2. Solution</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Access_Other_DSL_Injector">A.1.2.2. How do I get the Guice Injector of my language?</a>
+<ul class="sectlevel5">
+<li><a href="appendix_a_hints.html#sec:DSL_Injector_UI_context">A.1.2.2.1. UI context</a></li>
+<li><a href="appendix_a_hints.html#sec:DSL_Injector_Non_UI_context">A.1.2.2.2. Non UI context but with injection context</a></li>
+<li><a href="appendix_a_hints.html#sec:DSL_Injector_Non_UI_non_injection_context">A.1.2.2.3. Non UI context without injection context</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Cancel_Indicator">A.1.2.3. How do I get cancel indicators in different contexts?</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Eclipse">A.2. Eclipse</a>
+<ul class="sectlevel3">
+<li><a href="appendix_a_hints.html#sec:Show_Xtext_Index">A.2.1. Show the current Xtext index</a></li>
+<li><a href="appendix_a_hints.html#sec:Plugin_spy">A.2.2. Plug-in spy</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Maven-hints">A.3. Maven</a>
+<ul class="sectlevel3">
+<li><a href="appendix_a_hints.html#how-to-check-for-maven-mojo-updates">A.3.1. How to check for Maven MOJO updates</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#_module-loading">Appendix B: Module Loading</a>
+<ul class="sectlevel2">
+<li><a href="appendix_b_module_loading.html#sec:Dependency_Management">B.1. Dependency Management</a></li>
+<li><a href="appendix_b_module_loading.html#ecmascript-modules">B.2. ECMAScript Modules</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:ES5_Modules_Systems">B.2.1. ES5 Modules Systems</a></li>
+<li><a href="appendix_b_module_loading.html#sec:ES6_Modules">B.2.2. ES6 Modules</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:ECMAScript_Module_Loaders">B.3. ECMAScript Module Loaders</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:ES6_Module_Loaders">B.3.1. ES6 Module Loaders</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Polyfills_for_ES6_Module_Loaders">B.3.2. Polyfills for ES6 Module Loaders</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:es6_module_loader">B.3.2.1. es6-module-loader</a></li>
+<li><a href="appendix_b_module_loading.html#sec:SystemJS">B.3.2.2. SystemJS</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Demo">B.3.2.3. Demo</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#case-study-typescript">B.4. Case Study : TypeScript</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:ES6_Modules_Support">B.4.1. ES6 Modules Support</a></li>
+<li><a href="appendix_b_module_loading.html#sec:TypeScript_and_Module_Loading">B.4.2. TypeScript and Module Loading</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Cyclic_Dependencies">B.5. Cyclic Dependencies</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:Setup">B.5.1. Setup</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Transpile_and_Execute">B.5.2. Transpile and Execute</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Module_Format___AMD">B.5.2.1. Module Format = AMD</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Module_Format___CommonJS">B.5.2.2. Module Format = CommonJS</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Module_Format___SystemJS">B.5.2.3. Module Format = SystemJS</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Conclusion">B.5.3. Conclusion</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#system.register-as-transpilation-target">B.6. System.register as transpilation target</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:Introduction">B.6.1. Introduction</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:External_Transpilers">B.6.1.1. External Transpilers</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Example_of_a_System_register_module">B.6.1.2. Example of a System.register module</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Structure_of_a_System_register_module">B.6.2. Structure of a System.register module</a></li>
+<li><a href="appendix_b_module_loading.html#_transpilation-hints">B.6.3. Transpilation Hints</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Handling_Imports">B.6.3.1. Handling Imports</a></li>
+<li><a href="appendix_b_module_loading.html#sec:__exportFn__">B.6.3.2. &lt;&lt;exportFn&gt;&gt;</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Handling_Exports">B.6.3.3. Handling Exports</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Examples_w__Circular_Dependencies">B.6.4. Examples w/ Circular Dependencies</a></li>
+<li><a href="appendix_b_module_loading.html#sec:N4JS_Examples_w__Circular_Dependencies">B.6.5. N4JS Examples w/ Circular Dependencies</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Unresolved_Cyclic_Dependencies">B.6.5.1. Unresolved Cyclic Dependencies</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Variables___Functions">B.6.5.2. Examples with Variables &amp; Functions</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Classes">B.6.5.3. Examples with Classes</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Examples_with_SubClassing">B.6.5.4. Examples with SubClassing</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Miscellaneous">B.6.5.5. Miscellaneous</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#_resources">B.6.6. Resources</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:CommonJS_as_transpilation_target">B.7. CommonJS as transpilation target</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#_introduction-2">B.7.1. Introduction</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Transpilation_Hints">B.7.2. Transpilation Hints</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Import_Statements">B.7.2.1. Import Statements</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Export_Statements">B.7.2.2. Export Statements</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Tracking_Live_Bindings">B.7.2.3. Tracking Live Bindings</a></li>
+<li><a href="appendix_b_module_loading.html#sec:A_complete_example">B.7.2.4. A complete example</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#_resources-2">B.7.3. Resources</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_c_license.html#sec:License">Appendix C: License</a></li>
+<li><a href="appendix_d_acronyms.html#sec:Acronyms">Appendix D: Acronyms</a></li>
+<li><a href="appendix_e_bibliography_and_footnotes.html#_bibliography-and-footnotes">Appendix E: Bibliography and Footnotes</a></li>
+</ul>
+</div>
+</div>
+<div id="content"><div class="sect1">
+<h2 id="sec:JSON_Support"><a class="anchor" href="#sec:JSON_Support"></a><a class="link" href="#sec:JSON_Support">18. JSON Support</a></h2>
+<div class="sectionbody">
+<div class="admonitionblock warning">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-warning" title=""></i>
+</td>
+<td class="content">
+This chapter may be outdated.
+</td>
+</tr>
+</table>
+</div>
+<div class="sect2">
+<h3 id="sec:JSON_Parser"><a class="anchor" href="#sec:JSON_Parser"></a><a class="link" href="#sec:JSON_Parser">18.1. JSON Parser</a></h3>
+<div class="paragraph">
+<p>For the JavaScript Object Notation format, a multitude of specifications exist (e.g. [<a href="appendix_e_bibliography_and_footnotes.html#RFC8259">RFC8259</a>], [<a href="appendix_e_bibliography_and_footnotes.html#ECMA404">ECMA404</a>], [<a href="appendix_e_bibliography_and_footnotes.html#RFC7158">RFC7158</a>]). While all specifications agree on the basic structure of JSON, many special cases exist, which remain un-addressed by the specifications. Therefore, in practice many parsers exhibit implementation-specific behavior. See [<a href="appendix_e_bibliography_and_footnotes.html#Ser18">Ser18</a>] for a discussion of many of these cases.</p>
+</div>
+<div class="paragraph">
+<p>The initial grammar of the N4JS JSON parser is mostly based on [<a href="appendix_e_bibliography_and_footnotes.html#ECMA404">ECMA404</a>] while further adaptions have been made to accommodate for special cases such as escaping unicode control characters in string literals. This section discusses the different aspect in which our parser exhibits special behavior in order to parse a maximum of real-world JSON text. If applicable, we will also discuss differences between JSON and the N4JS syntax for object literals.</p>
+</div>
+<div class="sect3">
+<h4 id="sec:JSON_Parser_Unicode_Escaping"><a class="anchor" href="#sec:JSON_Parser_Unicode_Escaping"></a><a class="link" href="#sec:JSON_Parser_Unicode_Escaping">18.1.1. Escaping Unicode Control Characters in String Literals</a></h4>
+<div class="paragraph">
+<p>In comparison to ECMAScript (and thus N4JS), JSON only requires the escaping of unicode control characters in the range from <code>U+0000</code> to <code>U+001F</code> when used in a string literal. This includes the line termination characters <code>U+000A</code> or <code>\n</code> and <code>U+000D</code> or <code>\r</code>. However, different from ECMAScript, JSON allows the unescaped use of the unicode characters <code>U+2028</code> and <code>U+2029</code> within string literals. Therefore, the JSON parser differs from the behavior of the N4JS parser.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:JSON_Parser_Empty_Text"><a class="anchor" href="#sec:JSON_Parser_Empty_Text"></a><a class="link" href="#sec:JSON_Parser_Empty_Text">18.1.2. Empty Text</a></h4>
+<div class="paragraph">
+<p>While the abovementioned JSON specifications do not allow for empty JSON text (e.g. no data, only whitespace data), our parser is tolerant towards such inputs. The reason behind this decision is that it allows users of the N4JS IDE, to create new empty JSON files without experiencing any parser errors.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:JSON_Parser_Nested_Structures"><a class="anchor" href="#sec:JSON_Parser_Nested_Structures"></a><a class="link" href="#sec:JSON_Parser_Nested_Structures">18.1.3. Nested Structures</a></h4>
+<div class="paragraph">
+<p>Since the N4JS JSON parser is implemented in terms of a recursive decent parser, the parsable inputs are limited in terms of nesting. This results in a stack overflow exception for highly nested input data.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:JSON_Parser_Whitespace"><a class="anchor" href="#sec:JSON_Parser_Whitespace"></a><a class="link" href="#sec:JSON_Parser_Whitespace">18.1.4. Whitespace</a></h4>
+<div class="paragraph">
+<p>[<a href="appendix_e_bibliography_and_footnotes.html#RFC7158">RFC7158</a>] and [<a href="appendix_e_bibliography_and_footnotes.html#ECMA404">ECMA404</a>] both define whitespace characters of JSON to be exclusively <code>U+0009</code>, <code>U+000A</code>, <code>U+000D</code> and <code>U+0020</code>. However, for now we adopt the whitespace strategy of the N4JS parser, which allows for additional whitespace characters (also see [<a href="appendix_e_bibliography_and_footnotes.html#ECMA15a">ECMA15a</a>] section 7.2 White Space). This only applies to JSON text outside of string literals.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:JSON_Parser_Comments"><a class="anchor" href="#sec:JSON_Parser_Comments"></a><a class="link" href="#sec:JSON_Parser_Comments">18.1.5. Comments</a></h4>
+<div class="paragraph">
+<p>Although JSON as a standard does not specify any notion of source code comments, we allow them on a parser level. (single line comments introduced by <code>//</code> and multi-line comments using <code>/*</code> and <code>*/</code>). After parsing, we issue corresponding validation messages that indicate to the user, that such comments will possibly not be parsable in a different context (e.g. by npm in case of package.json files).</p>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="sec:JSON_Language_Extensions"><a class="anchor" href="#sec:JSON_Language_Extensions"></a><a class="link" href="#sec:JSON_Language_Extensions">18.2. JSON Language Extensions</a></h3>
+<div class="paragraph">
+<p>Generally, our JSON support was implemented with generic JSON support in mind. However, for some types of JSON files (e.g. <code>package.json</code> files) we provide custom behavior to better assist the user. This includes custom JSON validators and resource description strategies that only apply to certain types of JSON files. In order to keep our JSON implementation independent from N4JS-specific code, these concerns are separated using an Eclipse Extension Point. In the headless case, extension also need to be registered manually via the <code>JSONExtensionRegistry</code>. In the following we present the different aspect in which the JSON language can be extended.</p>
+</div>
+<div class="sect3">
+<h4 id="sec:JSON_Validator_Extensions"><a class="anchor" href="#sec:JSON_Validator_Extensions"></a><a class="link" href="#sec:JSON_Validator_Extensions">18.2.1. JSON Validator Extensions</a></h4>
+<div class="paragraph">
+<p>Via the JSON validator extensions (cf. <code>IJSONValidatorExtension</code>), other bundles can register JSON validator extensions that introduce domain-specific validation for specific types of JSON files.</p>
+</div>
+<div class="sect4">
+<h5 id="sec:File_Specitic_Validator_Extensions"><a class="anchor" href="#sec:File_Specitic_Validator_Extensions"></a><a class="link" href="#sec:File_Specitic_Validator_Extensions">18.2.1.1. File-Specific Validator Extensions</a></h5>
+<div class="paragraph">
+<p>For every JSON resource that is validated, all registered JSON validator extensions are executed. For a validator extension to be specific to a certain type of file, one may override the Xtext method <code>isResponsible</code> which checks whether a validator applies on a per resource basis.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:JSON_Declarative_JSON_Validator_Extensions"><a class="anchor" href="#sec:JSON_Declarative_JSON_Validator_Extensions"></a><a class="link" href="#sec:JSON_Declarative_JSON_Validator_Extensions">18.2.1.2. Declarative JSON Validator Extensions</a></h5>
+<div class="paragraph">
+<p>In addition to Xtext&#8217;s <code>@Check</code> methods, we provide an annotation <code>@CheckProperty</code> that allows to declare JSON-specific check methods that only apply to certain property paths of a JSON document. The <code>@CheckProperty</code> annotation can only be used when inheriting from the <code>AbstractJSONValidatorExtension</code> class. The following example outlines its usage:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-java" data-lang="java">(...)
+@CheckProperty(propertyPath = "prop1")
+public void checkProperty(JSONValue propertyValue) {
+	// validate JSONValue for top-level property 'prop1'
+}
+
+@CheckProperty(propertyPath = "nested.prop2")
+public void checkNestedProperty(JSONValue propertyValue) {
+	// validate JSONValue for the nested property 'nested.prop2'
+}
+(...)</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>The examples illustrates how property-check-method can be declared. In a JSON document the first check method will only be invoked for the JSON value that is set for top-level property <code>prop1</code>. The second check method is invoked for the nested property <code>prop2</code> of the object that is set for the top-level property <code>prop2</code>.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-json" data-lang="json">{
+	"prop1": 1, // checkProperty applies
+	"nested": {
+		"prop2": 2 // checkNestedProperty applies
+	}
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>When inheriting from the <code>AbstractJSONValidatorExtension</code>, the usual <code>addIssue</code> methods may be used in order to issue validation messages. Furthermore, the issue codes that are  being used for the messages may originate from the bundle that hosts the validator extension.</p>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_json-resource-description-strategy"><a class="anchor" href="#_json-resource-description-strategy"></a><a class="link" href="#_json-resource-description-strategy">18.2.2. JSON Resource Description Strategy</a></h4>
+<div class="paragraph">
+<p>Via JSON resource description extensions (cf. <code>IJSONResourceDescriptionExtension</code>), other bundles can define a custom resource description strategy for specific types of JSON files. As a consequence, these extensions define what information on the contents of a JSON file is stored in the Xtext index (cf. <code>IResourceDescriptions</code>).</p>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div id="footer">
+<div id="footer-text">
+Version 0.9<br>
+Last updated 2019-08-07 15:02:40 CEST
+</div>
+</div>
+<!-- ************* docinfo-footer *************************************************************** -->
+<div class="Grid social" style="color:#d5dfea">
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <h2>Quick Links</h2>
+    <ul>
+      <li><a href="../downloads.html">Download</a></li>
+      <li><a href="../userguides/index.html">Documentation</a></li>
+      <li><a href="https://github.com/eclipse/n4js/">Source</a></li>
+      <li><a href="https://github.com/eclipse/n4js/issues">Issues</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="https://www.eclipse.org/forums/index.php/f/365/">Forum</a></li>
+      <li><a href="http://n4js.blogspot.de/">Blog</a></li>
+      <li><a href="https://dev.eclipse.org/mailman/listinfo/n4js-dev">Mailing List</a></li>
+      <li><a href="https://projects.eclipse.org/projects/technology.n4js">Eclipse Project Page</a></li>
+      <li><a href="https://twitter.com/n4jsdev">Tweets by n4jsdev</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="http://www.eclipse.org/">Eclipse Home</a></li>
+      <li><a href="http://www.eclipse.org/legal/privacy.php">Privacy Policy</a></li>
+      <li><a href="http://www.eclipse.org/legal/termsofuse.php">Terms of Use</a></li>
+      <li><a href="http://www.eclipse.org/legal/copyright.php">Copyright Agent</a></li>
+      <li><a href="http://www.eclipse.org/legal/">Legal</a></li>
+    </ul>
+  </div>
+  <div style="clear: both; height: 0; overflow: hidden;"></div>
+</div>
+
+<!-- ************* UI Scripts ************* -->
+<script type="text/javascript" src="scripts/back-to-top.js"></script>
+
+<script type="text/javascript" src="scripts/treeview.js"></script>
+<script type="text/javascript" src="scripts/toc.js"></script>
+
+<!-- ************* Prism.js Syntax Highlighting ************* -->
+<script src="scripts/prism.js"></script>
+
+<script type="text/javascript">
+	// Add the 'toclist' id for search function
+	$(".toc2 > ul").attr('id', 'toclist');
+	// Generate a Search input form
+	$("#toclist > li:first-of-type").before('<input type="text" id="pagesearch" onkeyup="search()" placeholder="Search for section...">');
+	$("#toclist > li:first-of-type").before('<i id="clear" class="fa fa-times-circle-o"></i>');
+	$("#clear").click(function(){
+	    $("#pagesearch").val('');
+	    search();
+	    $('.toc2 > ul').treeView('collapseAll');
+	});
+	// intialize Treeview.js
+	$(".toc2 > ul").treeView();
+	// Initialize Scrollspy
+</script>
+<!-- ************* docinfo-footer *************************************************************** -->
+</body>
+</html>
\ No newline at end of file
diff --git a/design/parser.html b/design/parser.html
new file mode 100644
index 0000000..fb7f308
--- /dev/null
+++ b/design/parser.html
@@ -0,0 +1,1164 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="generator" content="Asciidoctor 1.5.5">
+<meta name="author" content="2019-08-07 15:02:40 CEST">
+<title>N4JS Design Specification</title>
+<link rel="stylesheet" href="styles/spec.min.css">
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.6.3/css/font-awesome.min.css">
+<!-- ************* docinfo ******************************************************************* -->
+
+
+<!-- ************* Favicon ************-->
+<link rel="icon" href="images/favicon.ico" />
+
+<!-- ************* Back-to-top JQuery ************* -->
+<script src="https://code.jquery.com/jquery-1.12.4.js"></script>
+<script src="https://code.jquery.com/ui/1.12.0/jquery-ui.js"></script>
+
+
+<link href="styles/prism.min.css" rel="stylesheet" />
+<script type="text/javascript" async
+  src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2/MathJax.js?config=TeX-MML-AM_CHTML">
+</script>
+
+<!-- ************* Styles ************* -->
+<link rel="stylesheet" type="text/css" href="styles/n4jsspec-adoc.css">
+
+
+<!-- ****************** NavBar ****************** -->
+<div id="menubar">
+	<div class="banner">
+        <a href="https://www.eclipse.org/n4js/#"><img id="logo" src="images/n4js-logo.png" alt="Eclipse N4JS"></a>
+    </div>
+<ul>
+  <li><a href="index.html">Index</a></li>
+</ul>
+</div>
+<!-- ************* docinfo ******************************************************************* -->
+<style>
+      .admonitionblock td.icon .icon-todo:before{content:"\f249";color:#f4ee42}
+    </style>
+</head>
+<body class="book toc2 toc-left">
+<div id="header">
+<h1>N4JS Design Specification</h1>
+<div class="details">
+<span id="author" class="author">2019-08-07 15:02:40 CEST</span><br>
+<span id="revnumber">version 0.9</span>
+</div>
+<div id="toc" class="toc2">
+<div id="toctitle">Table of Contents</div>
+<ul class="sectlevel1">
+<li><a href="introduction.html#_introduction">1. Introduction</a>
+<ul class="sectlevel2">
+<li><a href="introduction.html#notation">1.1. Notation</a></li>
+<li><a href="introduction.html#sec:IDE_Overview">1.2. IDE Components</a>
+<ul class="sectlevel3">
+<li><a href="introduction.html#sec:Naming_Conventions">1.2.1. Naming Conventions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="eclipse_setup.html#_eclipse-setup">2. Eclipse Setup</a>
+<ul class="sectlevel2">
+<li><a href="eclipse_setup.html#_system-requirements">2.1. System Requirements</a></li>
+<li><a href="eclipse_setup.html#_contribute">2.2. Contribute</a>
+<ul class="sectlevel3">
+<li><a href="eclipse_setup.html#_eclipse-installer">2.2.1. Eclipse Installer</a>
+<ul class="sectlevel4">
+<li><a href="eclipse_setup.html#_changing-the-setup-script">2.2.1.1. Changing the Setup Script</a></li>
+</ul>
+</li>
+<li><a href="eclipse_setup.html#_manual-ide-configuration">2.2.2. Manual IDE Configuration</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="release_engineering.html#_release-engineering">3. Release Engineering</a>
+<ul class="sectlevel2">
+<li><a href="release_engineering.html#_nightly-build-on-eclipse-infrastructure">3.1. Nightly build on Eclipse infrastructure</a></li>
+<li><a href="release_engineering.html#_build-the-n4js-ide-from-command-line">3.2. Build the N4JS IDE from command line</a>
+<ul class="sectlevel3">
+<li><a href="release_engineering.html#_publish-maven-tooling-code-org-eclipse-n4js-releng-util-code">3.2.1. Publish maven-tooling <code>org.eclipse.n4js.releng.util</code></a></li>
+<li><a href="release_engineering.html#sec:test-verdaccio">3.2.2. Test Verdaccio containing n4js-libs</a></li>
+<li><a href="release_engineering.html#_generation-of-eclipse-help-for-spec-and-design-document">3.2.3. Generation of Eclipse help for spec and design document</a></li>
+</ul>
+</li>
+<li><a href="release_engineering.html#_updating-frameworks-and-dependencies">3.3. Updating frameworks and dependencies</a>
+<ul class="sectlevel3">
+<li><a href="release_engineering.html#_update-of-eclipse-emf-xtext-etc">3.3.1. Update of Eclipse, EMF, Xtext, etc.</a></li>
+<li><a href="release_engineering.html#_update-of-the-embedded-jre">3.3.2. Update of the embedded JRE</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tips_and_tricks.html#_tips-and-tricks">4. Tips and Tricks</a>
+<ul class="sectlevel2">
+<li><a href="tips_and_tricks.html#_naming">4.1. Naming</a></li>
+<li><a href="tips_and_tricks.html#_logging">4.2. Logging</a></li>
+<li><a href="tips_and_tricks.html#_cancellation-handling">4.3. Cancellation Handling</a></li>
+<li><a href="tips_and_tricks.html#_caching">4.4. Caching</a></li>
+<li><a href="tips_and_tricks.html#_dependency-injection">4.5. Dependency Injection</a></li>
+<li><a href="tips_and_tricks.html#_miscellaneous">4.6. Miscellaneous</a></li>
+</ul>
+</li>
+<li><a href="#_parser">5. Parser</a>
+<ul class="sectlevel2">
+<li><a href="#sec:Parser_Overview">5.1. Overview</a></li>
+<li><a href="#sec:N4JS_Parser">5.2. N4JS Parser</a></li>
+<li><a href="#sec:Parser_Generation_Post_Processing">5.3. Parser Generation Post-Processing</a>
+<ul class="sectlevel3">
+<li><a href="#sec:Automatic_Semicolon_Insertion">5.3.1. Automatic Semicolon Insertion</a>
+<ul class="sectlevel4">
+<li><a href="#sec:Injected_code_in_the_Antlr_grammar_file">5.3.1.1. Injected code in the Antlr grammar file</a></li>
+<li><a href="#sec:Customized_error_recovery">5.3.1.2. Customized error recovery</a></li>
+</ul>
+</li>
+<li><a href="#sec:_No_line_terminator_allowed_here__handling">5.3.2. Async and <code>No line terminator allowed here</code> Handling</a></li>
+<li><a href="#sec:Regular_Expression">5.3.3. Regular Expression</a></li>
+<li><a href="#sec:Unicode">5.3.4. Unicode</a></li>
+<li><a href="#sec:Literals">5.3.5. Literals</a></li>
+</ul>
+</li>
+<li><a href="#sec:Modifiers">5.4. Modifiers</a></li>
+<li><a href="#sec:Conflict_Resolutions">5.5. Conflict Resolutions</a>
+<ul class="sectlevel3">
+<li><a href="#sec:Reserved_Keywords_vs__Identifier_Names">5.5.1. Reserved Keywords vs. Identifier Names</a></li>
+<li><a href="#sec:Operators_and_Generics">5.5.2. Operators and Generics</a></li>
+</ul>
+</li>
+<li><a href="#sec:Content_Assist_Parser">5.6. Content-Assist Parser</a></li>
+</ul>
+</li>
+<li><a href="type_system.html#_type-system">6. Type System</a>
+<ul class="sectlevel2">
+<li><a href="type_system.html#sec:Type_Model_and_Grammar">6.1. Type Model and Grammar</a>
+<ul class="sectlevel3">
+<li><a href="type_system.html#sec:Type_Model_Overview">6.1.1. Type Model Overview</a></li>
+<li><a href="type_system.html#sec:Built_in_Types">6.1.2. Built-in and Primitive Types</a></li>
+<li><a href="type_system.html#sec:Type_Model_DSL">6.1.3. Type Model DSL</a></li>
+</ul>
+</li>
+<li><a href="type_system.html#sec:Type_System_Implementation">6.2. Type System Implementation</a></li>
+<li><a href="type_system.html#sec:Type_Inference_combined_with_AST_Traversal">6.3. Type Inference of AST</a>
+<ul class="sectlevel3">
+<li><a href="type_system.html#sec:Type_Inference_combined_with_AST_Traversal__Background">6.3.1. Background</a></li>
+<li><a href="type_system.html#sec:Triggering_Type_Inference_of_AST">6.3.2. Triggering</a></li>
+<li><a href="type_system.html#sec:Traversal_Order_During_Type_Inference_of_AST">6.3.3. Traversal Order</a></li>
+<li><a href="type_system.html#sec:Cross_References_During_Type_Inference_of_AST">6.3.4. Cross-References</a></li>
+<li><a href="type_system.html#sec:Function_Accessor_Bodies_During_Type_Inference_of_AST">6.3.5. Function/Accessor Bodies</a></li>
+<li><a href="type_system.html#sec:Poly_Expressions_During_Type_Inference_of_AST">6.3.6. Poly Expressions</a></li>
+<li><a href="type_system.html#sec:Constraint_Solver_used_During_Type_Inference_of_AST">6.3.7. Constraint Solver</a></li>
+<li><a href="type_system.html#sec:Type_Guards_During_Type_Inference_of_AST">6.3.8. Type Guards</a></li>
+</ul>
+</li>
+<li><a href="type_system.html#sec:Structural_Typing">6.4. Structural Typing</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#_type-index">7. Type Index</a>
+<ul class="sectlevel2">
+<li><a href="type_index.html#sec:Type_Index_Design_Rationale">7.1. Design Rationale</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#sec:Getting_the_Xtext_Index_Content_IResourceDescriptions">7.1.1. Getting the Xtext Index (<code>IResourceDescriptions</code>) Content</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#sec:Design_Overview">7.2. Design Overview</a></li>
+<li><a href="type_index.html#sec:N4JS_Resource_Load_States">7.3. N4JS Resource Load States</a></li>
+<li><a href="type_index.html#sec:Type_Builder">7.4. Types Builder</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#sec:Type_Inference_not_allowed_in_Type_Builder">7.4.1. Type Inference not allowed in Types Builder</a></li>
+<li><a href="type_index.html#sec:ComputedTypeReferences">7.4.2. Deferred Type References</a></li>
+<li><a href="type_index.html#sec:Use_cases_of_ComputedTypeRef">7.4.3. Use cases of DeferredTypeRef</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#sec:Incremental_Builder_Overview">7.5. Incremental Builder (Overview)</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#sec:Incremental_Builder_Overview__XtextBuilder">7.5.1. XtextBuilder</a></li>
+<li><a href="type_index.html#sec:Incremental_Builder_Overview__IBuilderState">7.5.2. IBuilderState</a>
+<ul class="sectlevel4">
+<li><a href="type_index.html#copy-and-update-xtext-index">7.5.2.1. Copy and Update Xtext Index</a></li>
+<li><a href="type_index.html#build-state-setup-phase">7.5.2.2. Build State Setup Phase</a></li>
+<li><a href="type_index.html#process-queued-uris">7.5.2.3. Process Queued URIs</a></li>
+<li><a href="type_index.html#queueing-affected-resources">7.5.2.4. Queueing Affected Resources</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#sec:Incremental_Builder_Overview__Example">7.5.3. Example</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#dirty-state-handling">7.6. Dirty state handling</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#use-case-restoring-types-from-user-data">7.6.1. Use case: Restoring types from user data</a></li>
+<li><a href="type_index.html#use-case-updating-the-xtext-index">7.6.2. Use case: Updating the Xtext index</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="project_model.html#_project-model">8. Project Model</a>
+<ul class="sectlevel2">
+<li><a href="project_model.html#sec:Package_json">8.1. Package.json File</a></li>
+<li><a href="project_model.html#_accessing-project-information">8.2. Accessing Project Information</a>
+<ul class="sectlevel3">
+<li><a href="project_model.html#sec:IN4JSCore">8.2.1. IN4JSCore</a></li>
+<li><a href="project_model.html#sec:N4JSModel">8.2.2. N4JSModel</a></li>
+<li><a href="project_model.html#sec:N4JSWorkspace">8.2.3. N4JSWorkspace</a></li>
+<li><a href="project_model.html#sec:N4JSProject">8.2.4. N4JSProject</a></li>
+<li><a href="project_model.html#sec:SourceContainer">8.2.5. SourceContainer</a></li>
+<li><a href="project_model.html#sec:N4JSProjectsStateHelper">8.2.6. N4JSProjectsStateHelper</a></li>
+</ul>
+</li>
+<li><a href="project_model.html#sec:Caching">8.3. Caching</a>
+<ul class="sectlevel3">
+<li><a href="project_model.html#_caching-of-externallibraryworkspace">8.3.1. Caching of ExternalLibraryWorkspace</a></li>
+<li><a href="project_model.html#_caching-of-n4jsprojectsstatehelper">8.3.2. Caching of N4JSProjectsStateHelper</a></li>
+</ul>
+</li>
+<li><a href="project_model.html#sec:WildcardPathFilter">8.4. WildcardPathFilter</a></li>
+<li><a href="project_model.html#sec:ProjectUtils">8.5. ProjectUtils</a></li>
+</ul>
+</li>
+<li><a href="binding.html#_binding">9. Binding</a>
+<ul class="sectlevel2">
+<li><a href="binding.html#sec:Binding_Design_Rationale">9.1. Design Rationale</a></li>
+<li><a href="binding.html#sec:Binding_to_Members">9.2. Binding to Members</a></li>
+<li><a href="binding.html#sec:Binding_Getter_Setter">9.3. Getter / Setter Binding</a></li>
+<li><a href="binding.html#chap:Statics">9.4. Static Member Binding</a></li>
+<li><a href="binding.html#sec:Binding_Enumeration">9.5. Enumeration Literals Binding</a></li>
+<li><a href="binding.html#sec:Accessibility_of_types_and_members">9.6. Accessibility of types and members</a></li>
+<li><a href="binding.html#sec:Member_Scope_Example">9.7. Member Scope Example</a></li>
+<li><a href="binding.html#sec:Scoping_for_Members_of_Composed_Type_Explained">9.8. Scoping for Members of Composed Type (Union/Intersection) Example</a></li>
+<li><a href="binding.html#sec:Binding_of_Structurally_References_Types">9.9. Structurally References Types</a></li>
+<li><a href="binding.html#sec:Building">9.10. Building</a>
+<ul class="sectlevel3">
+<li><a href="binding.html#sec:Build_Phases">9.10.1. Build Phases</a></li>
+<li><a href="binding.html#sec:Build_Scenarios">9.10.2. Build Scenarios</a></li>
+<li><a href="binding.html#sec:Lazy_linking_problem">9.10.3. Lazy linking problem</a></li>
+</ul>
+</li>
+<li><a href="binding.html#sec:Proxies_and_Proxy_Resolution">9.11. Proxies and Proxy Resolution (Overview)</a>
+<ul class="sectlevel3">
+<li><a href="binding.html#xtexts-lazy-linking-proxies">9.11.1. Xtext’s Lazy Linking Proxies</a></li>
+<li><a href="binding.html#standard-emf-proxies">9.11.2. Standard EMF Proxies</a></li>
+<li><a href="binding.html#_how-is-proxy-resolution-triggered">9.11.3. How is Proxy Resolution Triggered?</a></li>
+<li><a href="binding.html#_when-is-proxy-resolution-allowed">9.11.4. When is Proxy Resolution Allowed?</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="validation.html#_validation">10. Validation</a>
+<ul class="sectlevel2">
+<li><a href="validation.html#sec:validation_overview">10.1. Validation overview</a></li>
+<li><a href="validation.html#sec:validation_control_flow">10.2. Validation control flow</a></li>
+<li><a href="validation.html#sec:validation_issue_ids">10.3. Issue IDs and Messages</a></li>
+<li><a href="validation.html#sec:validation_usage_patterns">10.4. Usage Pattern</a></li>
+<li><a href="validation.html#sec:validation_links">10.5. Links</a></li>
+</ul>
+</li>
+<li><a href="references.html#_references">11. References</a>
+<ul class="sectlevel2">
+<li><a href="references.html#sec:usecases">11.1. Use cases</a></li>
+<li><a href="references.html#sec:calculation_algorithm">11.2. Calculation algorithm</a>
+<ul class="sectlevel3">
+<li><a href="references.html#sec:Xtext_default_implementation">11.2.1. Xtext default implementation</a></li>
+<li><a href="references.html#sec:N4_implementation">11.2.2. N4JS implementation</a></li>
+</ul>
+</li>
+<li><a href="references.html#sec:PerformanceOfDependencyCalculation">11.3. Performance Of Dependency Calculation</a></li>
+<li><a href="references.html#sec:kinds_of_references">11.4. Kinds of references</a>
+<ul class="sectlevel3">
+<li><a href="references.html#sec:Cross_References_to_be_ignored">11.4.1. Cross References to be ignored</a></li>
+<li><a href="references.html#sec:Cross_References_to_be_handled">11.4.2. Cross References to be handled</a></li>
+</ul>
+</li>
+<li><a href="references.html#sec:transitive_dependencies">11.5. Transitive dependencies</a></li>
+<li><a href="references.html#sec:find-references">11.6. Find references</a>
+<ul class="sectlevel3">
+<li><a href="references.html#_background">11.6.1. Background</a></li>
+<li><a href="references.html#_how-find-references-work">11.6.2. How Find References Work</a>
+<ul class="sectlevel4">
+<li><a href="references.html#_step-1-convert-cursor-position-to-declared-element">11.6.2.1. Step 1: Convert Cursor Position to Declared Element</a></li>
+<li><a href="references.html#_step-2-convert-declared-element-to-target-uris">11.6.2.2. Step 2: Convert Declared Element to Target URIs</a></li>
+<li><a href="references.html#_step-3-filter-potential-resources">11.6.2.3. Step 3: Filter Potential Resources</a></li>
+<li><a href="references.html#_step-4-search-references-in-resource">11.6.2.4. Step 4: Search References in Resource</a></li>
+<li><a href="references.html#_limitations-and-possible-enhancements">11.6.2.5. Limitations and Possible Enhancements</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="compilation.html#_compilation">12. Compilation</a>
+<ul class="sectlevel2">
+<li><a href="compilation.html#chap:compilation">12.1. Introduction</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:general_design_rationals">12.1.1. General design rationals</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:logging_and_error_reporting">12.1.1.1. Logging and error reporting</a></li>
+<li><a href="compilation.html#sec:progress_monitor">12.1.1.2. Progress monitor</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Xtext_Integration">12.1.2. Xtext Integration</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:xtext_default_behaviour">12.1.2.1. Xtext default behaviour</a></li>
+<li><a href="compilation.html#sec:n4js_requirements">12.1.2.2. N4JS requirements</a></li>
+<li><a href="compilation.html#sec:compiler_discovery_in_ui">12.1.2.3. Compiler discovery in UI</a></li>
+<li><a href="compilation.html#sec:compiler_discovery_in_headless">12.1.2.4. Compiler discovery in headless</a></li>
+<li><a href="compilation.html#sec:general_generator_implementation">12.1.2.5. General generator implementation</a></li>
+<li><a href="compilation.html#sec:general_generator_activation">12.1.2.6. General generator activation</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Overview_of_Input_Models">12.1.3. Overview of the Input Models</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Core_Generator">12.2. Generators</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:Compiler_Components">12.2.1. Generator Components</a></li>
+<li><a href="compilation.html#sec:Generator_architecture">12.2.2. Generator architecture</a></li>
+<li><a href="compilation.html#sec:Unified_Compiler_Configuration">12.2.3. Unified Compiler Configuration</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Transpilers">12.3. Transpilers</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:Phases">12.3.1. Overview</a></li>
+<li><a href="compilation.html#relation-between-ast-and-im">12.3.2. Relation between AST and IM</a></li>
+<li><a href="compilation.html#implementation-overview">12.3.3. Implementation Overview</a></li>
+<li><a href="compilation.html#sec:Guidelines_for_Implementing_Transformations">12.3.4. Guidelines for Implementing Transformations</a></li>
+<li><a href="compilation.html#symbol-table-in-the-im">12.3.5. Symbol Table in the IM</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:N4JS_to_EcmaScript_Transpiler">12.4. N4JS-to-EcmaScript Transpiler</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:Overview_of_Transformations">12.4.1. Overview of Transformations</a></li>
+<li><a href="compilation.html#sec:Transpiling_members">12.4.2. Transpiling members</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:Transpiling_members__Delegating_members">12.4.2.1. Techniques for special member handling</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__Partial_shadowing_of_getter_setter_pairs">12.4.2.2. Partial shadowing</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__Consuming_or_inheriting_members_of_an_interface">12.4.2.3. Consuming or inheriting members of an interface</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__Static_polyfill">12.4.2.4. Static polyfill</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__API_implementation_stubs">12.4.2.5. API / implementation stubs</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Support_for_incomplete_API_implementation_testing_in_the_N4JS_to_EcmaScript_5_Transpiler">12.4.3. Support for incomplete API implementation testing</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:Modifications_in_Impl_projects">12.4.3.1. Modifications in Impl projects</a></li>
+<li><a href="compilation.html#sec:Implementation_of_stub_generation">12.4.3.2. Implementation of stub-generation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:n4jsc_Headless_Compiler_Interface">12.5. n4jsc Headless Compiler Interface</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:building_the_headless_compiler">12.5.1. building the headless compiler</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="execution.html#_execution">13. Execution</a>
+<ul class="sectlevel2">
+<li><a href="execution.html#sec:N4JS_Project_Execution_And_Linking_Model">13.1. N4JS Project Execution And Linking Model</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#subsec:N4JS_Execution_With_NodeJS">13.1.1. N4JS Execution With NodeJS</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:N4JS_Execution_And_Linking_File">13.2. N4JS Execution And Linking File</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#subsec:NodeJS_Specific_ELF">13.2.1. NodeJS Specific ELF</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Runners-execution">13.3. Runners</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#subsec:N4_Runtime_Environments_Convention">13.3.1. N4 Runtime Environments Convention</a></li>
+<li><a href="execution.html#subsec:Passing_Information_from_IDE_to_Execution_Code_in_Runtime_Environment">13.3.2. Passing Information from IDE to Execution Code in Runtime Environment</a></li>
+<li><a href="execution.html#subsec:Runners_Design">13.3.3. Runners Design</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Legacy_Execution_Engine">13.4. Legacy Execution Engine</a></li>
+<li><a href="execution.html#sec:Design">13.5. Design</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#sec:Usage_Outside_N4JSIDE">13.5.1. Usage Outside N4JSIDE</a>
+<ul class="sectlevel4">
+<li><a href="execution.html#sec:Use_Node_with_Maven">13.5.1.1. Use Node with Maven</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Usage_Inside_N4JSIDE">13.5.2. Usage Inside N4JSIDE</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Runtime_Injection">13.6. Runtime Injection</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#sec:Running_String_Code">13.6.1. Running String Code</a></li>
+<li><a href="execution.html#sec:Running_File_Code">13.6.2. Running File Code</a></li>
+<li><a href="execution.html#sec:Injection_Code_Example">13.6.3. Injection Code Example</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#_tests">14. Tests</a>
+<ul class="sectlevel2">
+<li><a href="tests.html#sec:Performance_Tests">14.1. Performance Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Synthetic_Performance_Tests">14.1.1. Synthetic Performance Tests</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:Design_of_Generator">14.1.1.1. Design of Generator</a></li>
+<li><a href="tests.html#sec:Design_of_Performance_Test_Execution">14.1.1.2. Design of Performance Test Configuration and Execution</a></li>
+<li><a href="tests.html#sec:JUnit_Configuration">14.1.1.3. JUnit Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Test_Configuration">14.1.1.4. JUnitBenchmark Test Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Report_Configuration">14.1.1.5. JUnitBenchmark Report Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Run_Configuration">14.1.1.6. JUnitBenchmark Run Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Example">14.1.1.7. JUnitBenchmark Example</a></li>
+<li><a href="tests.html#sec:Note_on_Jenkins_Job">14.1.1.8. Note on Jenkins Job</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#sec:ECMA_Tests">14.2. ECMA Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Grammar_Tests">14.2.1. Grammar Tests</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:Negative_Tests">14.2.1.1. Negative Tests</a></li>
+<li><a href="tests.html#sec:Test_Exclusion">14.2.1.2. Test Exclusion</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Integration_Tests">14.3. Integration Tests</a></li>
+<li><a href="tests.html#sec:Test_Helpers">14.4. Test Helpers</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Parameterized_N4JS_Tests">14.4.1. Parameterized N4JS tests</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:ParameterizedXtextRunner">14.4.1.1. ParameterizedXtextRunner</a></li>
+<li><a href="tests.html#sec:TestCodeProvider">14.4.1.2. TestCodeProvider</a></li>
+<li><a href="tests.html#sec:Example_Of_Parameterized_Parser_Test">14.4.1.3. Example of parameterized parser test</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Issue_Suppression">14.5. Issue Suppression</a></li>
+<li><a href="tests.html#sec:Xpect_Tests">14.6. Xpect Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Xpect_Test_Setup">14.6.1. Xpect Test Setup</a></li>
+<li><a href="tests.html#sec:Xpect_Issue_Suppression">14.6.2. Xpect Issue Suppression</a></li>
+<li><a href="tests.html#sec:Xpect_Provided_Test_Methods">14.6.3. Xpect Provided Test Methods</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#errors">14.6.3.1. errors</a></li>
+<li><a href="tests.html#warnings">14.6.3.2. warnings</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:N4JS_Specific_Xpect_Test_Methods">14.6.4. N4JS Specific Xpect Test Methods</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:XPECT_noerrors">14.6.4.1. noerrors and nowarnings</a></li>
+<li><a href="tests.html#sec:XPECT_scope">14.6.4.2. scope</a></li>
+<li><a href="tests.html#sec:XPECT_scopeWithPosition">14.6.4.3. scopeWithPosition</a></li>
+<li><a href="tests.html#sec:XPECT_scopeWithResource">14.6.4.4. scopeWithResource</a></li>
+<li><a href="tests.html#sec:XPECT_binding">14.6.4.5. binding</a></li>
+<li><a href="tests.html#sec:XPECT_linkedPathname">14.6.4.6. linkedPathname</a></li>
+<li><a href="tests.html#sec:XPECT_type_of">14.6.4.7. type of</a></li>
+<li><a href="tests.html#sec:XPECT_expectedType">14.6.4.8. expectedType</a></li>
+<li><a href="tests.html#sec:XPECT_elementKeyword">14.6.4.9. elementKeyword</a></li>
+<li><a href="tests.html#sec:XPECT_accessModifier">14.6.4.10. accessModifier</a></li>
+<li><a href="tests.html#sec:XPECT_compileResult">14.6.4.11. compileResult</a></li>
+<li><a href="tests.html#sec:XPECT_output">14.6.4.12. output</a></li>
+<li><a href="tests.html#sec:XPECT_outputRegEx">14.6.4.13. outputRegEx</a></li>
+<li><a href="tests.html#sec:XPECT_calculatedAccessModifier">14.6.4.14. calculatedAccessModifier</a></li>
+<li><a href="tests.html#sec:XPECT_spec">14.6.4.15. spec</a></li>
+<li><a href="tests.html#sec:XPECT_deadCode">14.6.4.16. deadCode</a></li>
+<li><a href="tests.html#sec:XPECT_returnOrThrows">14.6.4.17. returnOrThrows</a></li>
+<li><a href="tests.html#sec:XPECT_lint">14.6.4.18. lint</a></li>
+<li><a href="tests.html#sec:XPECT_lintFails">14.6.4.19. lintFails</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:FIXME_Xpect_modifier">14.6.5. FIXME Xpect modifier</a></li>
+<li><a href="tests.html#sec:Expectmatrix_Xpect_Test_Methods">14.6.6. Expectmatrix Xpect tests</a></li>
+<li><a href="tests.html#xpect-lint-tests">14.6.7. Xpect Lint Tests</a></li>
+</ul>
+</li>
+<li><a href="tests.html#xpect-proposal-tests">14.7. Xpect Proposal Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Validation_vs__Non_Validation">14.7.1. Validation vs. Non-Validation</a></li>
+<li><a href="tests.html#sec:General_Proposal_Test_Features">14.7.2. General Proposal Test Features</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:Test_Variables">14.7.2.1. Test Variables</a></li>
+<li><a href="tests.html#sec:Location_and_Selection">14.7.2.2. at – Location and Selection</a></li>
+<li><a href="tests.html#sec:Multi_Line_Expectations_in_Proposal_Tests">14.7.2.3. Multi Line Expectations in Proposal Tests</a></li>
+<li><a href="tests.html#sec:Timeout">14.7.2.4. Timeout and Performance</a></li>
+</ul>
+</li>
+<li><a href="tests.html#proposals-verify-existence-of-proposals">14.7.3. proposals – Verify Existence of Proposals</a></li>
+<li><a href="tests.html#sec:Verify_displayed_string">14.7.4. display – Verify displayed string</a></li>
+<li><a href="tests.html#sec:Apply_Proposal">14.7.5. apply – Apply Proposal</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#resource-application-in-other-files">14.7.5.1. resource – application in other files</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Content_Assist_Cycling">14.7.6. kind – Content Assist Cycling</a></li>
+<li><a href="tests.html#fileValidVerify-validation-status">14.7.7. fileValid – Verify validation status</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Apply_Proposal_And_Execute_Tests">14.8. Apply Proposal And Execute Tests</a></li>
+<li><a href="tests.html#sec:Organize_Imports_Test">14.9. Organize Imports Test</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#organizeimports">14.9.1. organizeImports</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Access_Control_Test">14.10. Access Control Test</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#test-scenarios">14.10.1. Test Scenarios</a></li>
+<li><a href="tests.html#n4js-code-generator">14.10.2. N4JS Code Generator</a></li>
+<li><a href="tests.html#xtext-issue-matcher">14.10.3. Xtext Issue Matcher</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Smoke_Tests">14.11. Smoke Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#how-to-handle-smoke-test-errors">14.11.1. How to handle smoke test errors?</a></li>
+<li><a href="tests.html#smoketester-and-exceptionanalyzer">14.11.2. SmokeTester and ExceptionAnalyzer</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:UI_Tests_with_SWTBot">14.12. UI Tests with SWTBot</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#writing-swtbot-tests">14.12.1. Writing SWTBot Tests</a></li>
+<li><a href="tests.html#running-swtbot-tests">14.12.2. Running SWTBot Tests</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Debugging_UI_Tests">14.13. Debugging UI Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Connecting_to_the_X_server_on_the_build_node">14.13.1. Connecting to the X-server on the build-node</a></li>
+<li><a href="tests.html#sec:Tools_to_investigate_the_java_stack">14.13.2. Tools to investigate the java-stack</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="ui_concepts.html#_ui-concepts">15. UI Concepts</a>
+<ul class="sectlevel2">
+<li><a href="ui_concepts.html#sec:User_Interface_Concepts">15.1. User Interface Concepts</a>
+<ul class="sectlevel3">
+<li><a href="ui_concepts.html#sec:Eclipse_UI_Concepts">15.1.1. Eclipse UI Concepts</a>
+<ul class="sectlevel4">
+<li><a href="ui_concepts.html#sec:Label_Provider">15.1.1.1. Label Provider</a></li>
+<li><a href="ui_concepts.html#sec:Markers">15.1.1.2. Markers</a></li>
+<li><a href="ui_concepts.html#sec:Commands__Toolbar_and_Menus">15.1.1.3. Commands, Toolbar and Menus</a></li>
+<li><a href="ui_concepts.html#sec:Content_Assist">15.1.1.4. Content Assist</a></li>
+<li><a href="ui_concepts.html#sec:Quick_Fixes">15.1.1.5. Quick Fixes</a></li>
+<li><a href="ui_concepts.html#sec:Quick_Assist">15.1.1.6. Quick Assist</a></li>
+<li><a href="ui_concepts.html#sec:Clean_Up_Actions">15.1.1.7. Clean Up Actions</a></li>
+<li><a href="ui_concepts.html#sec:Save_Actions">15.1.1.8. Save Actions</a></li>
+<li><a href="ui_concepts.html#sec:Auto_Edit">15.1.1.9. Auto Edit</a></li>
+<li><a href="ui_concepts.html#sec:Template_Proposals">15.1.1.10. Template Proposals</a></li>
+<li><a href="ui_concepts.html#sec:Outline_View___Quick_Outline">15.1.1.11. Outline View / Quick Outline</a></li>
+<li><a href="ui_concepts.html#sec:Navigator__Package_Explorer__Project_Explorer">15.1.1.12. Navigator, Package Explorer, Project Explorer</a></li>
+<li><a href="ui_concepts.html#sec:Hyperlinking_and_Navigation">15.1.1.13. Hyperlinking and Navigation</a></li>
+<li><a href="ui_concepts.html#sec:Syntax_and_Semantic_Coloring">15.1.1.14. Syntax and Semantic Coloring</a></li>
+<li><a href="ui_concepts.html#sec:Code_Formatter">15.1.1.15. Code Formatter</a></li>
+<li><a href="ui_concepts.html#sec:Wizards">15.1.1.16. Wizards</a></li>
+<li><a href="ui_concepts.html#sec:Cheat_Sheets">15.1.1.17. Cheat Sheets</a></li>
+<li><a href="ui_concepts.html#sec:Context_sensitive_Help">15.1.1.18. Context-sensitive Help</a></li>
+<li><a href="ui_concepts.html#sec:Hovers">15.1.1.19. Hovers</a></li>
+<li><a href="ui_concepts.html#sec:Folding">15.1.1.20. Folding</a></li>
+<li><a href="ui_concepts.html#sec:Customizable_validation___severity">15.1.1.21. Customizable validation / severity</a></li>
+<li><a href="ui_concepts.html#sec:Proposals">15.1.1.22. Proposals</a></li>
+</ul>
+</li>
+<li><a href="ui_concepts.html#sec:Non_Eclipse_UI_Concepts">15.1.2. Non-Eclipse UI Concepts</a>
+<ul class="sectlevel4">
+<li><a href="ui_concepts.html#sec:Overlays">15.1.2.1. Overlays</a></li>
+<li><a href="ui_concepts.html#sec:Goto__Inferred__Type">15.1.2.2. Goto (Inferred) Type</a></li>
+<li><a href="ui_concepts.html#sec:Postfix_Completion">15.1.2.3. Postfix Completion</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="ui_concepts.html#_user-interface-resources">15.2. User Interface Resources</a>
+<ul class="sectlevel3">
+<li><a href="ui_concepts.html#_icons">15.2.1. Icons</a>
+<ul class="sectlevel4">
+<li><a href="ui_concepts.html#_eclipse-platform-icons">15.2.1.1. Eclipse Platform Icons</a></li>
+<li><a href="ui_concepts.html#_n4js-specific-icons">15.2.1.2. N4JS Specific Icons</a></li>
+<li><a href="ui_concepts.html#_high-resolution-icons">15.2.1.3. High Resolution Icons</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="formatting.html#_formatting">16. Formatting</a>
+<ul class="sectlevel2">
+<li><a href="formatting.html#sec:FmtObjective">16.1. Objective</a>
+<ul class="sectlevel3">
+<li><a href="formatting.html#sec:FmtFormatting_Comments">16.1.1. Formatting Comments</a></li>
+</ul>
+</li>
+<li><a href="formatting.html#sec:FmtArchitecture">16.2. Architecture</a>
+<ul class="sectlevel3">
+<li><a href="formatting.html#sec:Implementation_example">16.2.1. Implementation example</a></li>
+</ul>
+</li>
+<li><a href="formatting.html#sec:FmtFormatter_Implementation_Guidelines">16.3. Formatter Implementation Guidelines</a></li>
+<li><a href="formatting.html#sec:FmtConfiguration">16.4. Configuration</a></li>
+<li><a href="formatting.html#sec:FmtUI_Integration">16.5. UI Integration</a></li>
+<li><a href="formatting.html#sec:FmtUnit_Testing_with_Xpect">16.6. Unit Testing with Xpect</a></li>
+</ul>
+</li>
+<li><a href="external_libraries.html#_external-libraries">17. External Libraries</a>
+<ul class="sectlevel2">
+<li><a href="external_libraries.html#sec:Major_Components">17.1. Major Components</a>
+<ul class="sectlevel3">
+<li><a href="external_libraries.html#subsec:External_Resources">17.1.1. External Resources</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Workspace">17.1.2. External Library Workspace</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Preference_Store">17.1.3. External Library Preference Store</a></li>
+<li><a href="external_libraries.html#subsec:npm_Manager">17.1.4. Library Manager</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Builder_Helper">17.1.5. External Library Builder</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Xtext_Index_Persister">17.1.6. External Library Xtext Index Persister</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Preference_Page">17.1.7. External Library Preference Page</a></li>
+</ul>
+</li>
+<li><a href="external_libraries.html#sec:Headless_External_Library_Support">17.2. Headless External Library Support</a>
+<ul class="sectlevel3">
+<li><a href="external_libraries.html#_custom-npm-settings">17.2.1. Custom npm settings</a></li>
+</ul>
+</li>
+<li><a href="external_libraries.html#sec:lmFutureWork">17.3. Future Work</a>
+<ul class="sectlevel3">
+<li><a href="external_libraries.html#subsec:lmMultipleDependencyScope">17.3.1. Multiple Dependency Scope</a></li>
+<li><a href="external_libraries.html#subsec:lmRunTestsFromLibrary">17.3.2. Run Tests from TestLibrary</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="json_support.html#sec:JSON_Support">18. JSON Support</a>
+<ul class="sectlevel2">
+<li><a href="json_support.html#sec:JSON_Parser">18.1. JSON Parser</a>
+<ul class="sectlevel3">
+<li><a href="json_support.html#sec:JSON_Parser_Unicode_Escaping">18.1.1. Escaping Unicode Control Characters in String Literals</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Empty_Text">18.1.2. Empty Text</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Nested_Structures">18.1.3. Nested Structures</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Whitespace">18.1.4. Whitespace</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Comments">18.1.5. Comments</a></li>
+</ul>
+</li>
+<li><a href="json_support.html#sec:JSON_Language_Extensions">18.2. JSON Language Extensions</a>
+<ul class="sectlevel3">
+<li><a href="json_support.html#sec:JSON_Validator_Extensions">18.2.1. JSON Validator Extensions</a>
+<ul class="sectlevel4">
+<li><a href="json_support.html#sec:File_Specitic_Validator_Extensions">18.2.1.1. File-Specific Validator Extensions</a></li>
+<li><a href="json_support.html#sec:JSON_Declarative_JSON_Validator_Extensions">18.2.1.2. Declarative JSON Validator Extensions</a></li>
+</ul>
+</li>
+<li><a href="json_support.html#_json-resource-description-strategy">18.2.2. JSON Resource Description Strategy</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_jsdoc">19. JSDoc</a>
+<ul class="sectlevel2">
+<li><a href="jsdoc.html#sec:Design_Rationale">19.1. Design Rationale</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#_general-design">19.1.1. General Design</a></li>
+<li><a href="jsdoc.html#sec:Type_Expressions">19.1.2. Type Expressions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="docexporter.html#_docexporter">20. DocExporter</a>
+<ul class="sectlevel2">
+<li><a href="docexporter.html#sec:Specification_Exporter">20.1. Specification Exporter</a></li>
+</ul>
+</li>
+<li><a href="rename_refactoring.html#_rename-refactoring">21. Rename Refactoring</a>
+<ul class="sectlevel2">
+<li><a href="rename_refactoring.html#_rename-refactoring-ui-interaction">21.1. Rename Refactoring UI interaction</a></li>
+<li><a href="rename_refactoring.html#_renameelementprocessor-interaction">21.2. RenameElementProcessor interaction</a></li>
+</ul>
+</li>
+<li><a href="flow_graphs.html#chap:flowgraphs">22. Flow Graphs</a>
+<ul class="sectlevel2">
+<li><a href="flow_graphs.html#sec:flowgraphs_overview">22.1. Flow graphs overview</a>
+<ul class="sectlevel3">
+<li><a href="flow_graphs.html#_internal-graph">22.1.1. Internal graph</a></li>
+<li><a href="flow_graphs.html#_optimizations">22.1.2. Optimizations</a></li>
+<li><a href="flow_graphs.html#_api-for-client-analyses">22.1.3. API for client analyses</a>
+<ul class="sectlevel4">
+<li><a href="flow_graphs.html#_mapping-from-internal-to-ast-elements">22.1.3.1. Mapping from internal to AST elements</a></li>
+<li><a href="flow_graphs.html#_graph-visitor">22.1.3.2. Graph visitor</a></li>
+<li><a href="flow_graphs.html#_graph-explorer">22.1.3.3. Graph explorer</a></li>
+<li><a href="flow_graphs.html#_branch-walker">22.1.3.4. Branch walker</a></li>
+<li><a href="flow_graphs.html#_example-1-compute-string-for-each-path">22.1.3.5. Example 1: Compute string for each path</a></li>
+<li><a href="flow_graphs.html#_path-quantor">22.1.3.6. Path quantor</a></li>
+</ul>
+</li>
+<li><a href="flow_graphs.html#_control-flow-analyses">22.1.4. Control flow analyses</a>
+<ul class="sectlevel4">
+<li><a href="flow_graphs.html#_dead-code-analysis">22.1.4.1. Dead code analysis</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="flow_graphs.html#sec:dataflow">22.2. Dataflow</a>
+<ul class="sectlevel3">
+<li><a href="flow_graphs.html#_dataflow-graph">22.2.1. Dataflow graph</a></li>
+<li><a href="flow_graphs.html#_dataflow-analyses">22.2.2. Dataflow analyses</a>
+<ul class="sectlevel4">
+<li><a href="flow_graphs.html#_def-def-def-nothing-analysis">22.2.2.1. Def&#8594;Def / Def&#8594;Nothing analysis</a></li>
+<li><a href="flow_graphs.html#_def-use-decl-analysis">22.2.2.2. Def|Use&#8592;Decl analysis</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="publish_npms.html#sec:publish-npms-to-public">23. Publish npms</a>
+<ul class="sectlevel2">
+<li><a href="publish_npms.html#sec:publish-npms-n4js-maven">23.1. Publish n4js-libs to during  maven build</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Hints">Appendix A: Hints</a>
+<ul class="sectlevel2">
+<li><a href="appendix_a_hints.html#sec:XtextInjection">A.1. Xtext Injection</a>
+<ul class="sectlevel3">
+<li><a href="appendix_a_hints.html#sec:DI_MultipleInjectors_Singletons">A.1.1. Multiple Injectors and Singletons</a>
+<ul class="sectlevel4">
+<li><a href="appendix_a_hints.html#sec:DI_avoid_duplicate_singletons">A.1.1.1. Avoiding duplicate singletons</a>
+<ul class="sectlevel5">
+<li><a href="appendix_a_hints.html#sec:DI_binding_in_shared">A.1.1.1.1. Defining binding in the shared injector</a></li>
+<li><a href="appendix_a_hints.html#sec:DI_binding_in_custom">A.1.1.1.2. Defining binding in the custom injector</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:DI_Hints">A.1.2. Dependency Injection Hints</a>
+<ul class="sectlevel4">
+<li><a href="appendix_a_hints.html#sec:DI_custom_bundle">A.1.2.1. Use DI in custom bundle, use DI with extensions</a>
+<ul class="sectlevel5">
+<li><a href="appendix_a_hints.html#sec:DI_custom_bundle_problem">A.1.2.1.1. Problem</a></li>
+<li><a href="appendix_a_hints.html#sec:DI_custom_bundle_solution">A.1.2.1.2. Solution</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Access_Other_DSL_Injector">A.1.2.2. How do I get the Guice Injector of my language?</a>
+<ul class="sectlevel5">
+<li><a href="appendix_a_hints.html#sec:DSL_Injector_UI_context">A.1.2.2.1. UI context</a></li>
+<li><a href="appendix_a_hints.html#sec:DSL_Injector_Non_UI_context">A.1.2.2.2. Non UI context but with injection context</a></li>
+<li><a href="appendix_a_hints.html#sec:DSL_Injector_Non_UI_non_injection_context">A.1.2.2.3. Non UI context without injection context</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Cancel_Indicator">A.1.2.3. How do I get cancel indicators in different contexts?</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Eclipse">A.2. Eclipse</a>
+<ul class="sectlevel3">
+<li><a href="appendix_a_hints.html#sec:Show_Xtext_Index">A.2.1. Show the current Xtext index</a></li>
+<li><a href="appendix_a_hints.html#sec:Plugin_spy">A.2.2. Plug-in spy</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Maven-hints">A.3. Maven</a>
+<ul class="sectlevel3">
+<li><a href="appendix_a_hints.html#how-to-check-for-maven-mojo-updates">A.3.1. How to check for Maven MOJO updates</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#_module-loading">Appendix B: Module Loading</a>
+<ul class="sectlevel2">
+<li><a href="appendix_b_module_loading.html#sec:Dependency_Management">B.1. Dependency Management</a></li>
+<li><a href="appendix_b_module_loading.html#ecmascript-modules">B.2. ECMAScript Modules</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:ES5_Modules_Systems">B.2.1. ES5 Modules Systems</a></li>
+<li><a href="appendix_b_module_loading.html#sec:ES6_Modules">B.2.2. ES6 Modules</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:ECMAScript_Module_Loaders">B.3. ECMAScript Module Loaders</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:ES6_Module_Loaders">B.3.1. ES6 Module Loaders</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Polyfills_for_ES6_Module_Loaders">B.3.2. Polyfills for ES6 Module Loaders</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:es6_module_loader">B.3.2.1. es6-module-loader</a></li>
+<li><a href="appendix_b_module_loading.html#sec:SystemJS">B.3.2.2. SystemJS</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Demo">B.3.2.3. Demo</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#case-study-typescript">B.4. Case Study : TypeScript</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:ES6_Modules_Support">B.4.1. ES6 Modules Support</a></li>
+<li><a href="appendix_b_module_loading.html#sec:TypeScript_and_Module_Loading">B.4.2. TypeScript and Module Loading</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Cyclic_Dependencies">B.5. Cyclic Dependencies</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:Setup">B.5.1. Setup</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Transpile_and_Execute">B.5.2. Transpile and Execute</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Module_Format___AMD">B.5.2.1. Module Format = AMD</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Module_Format___CommonJS">B.5.2.2. Module Format = CommonJS</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Module_Format___SystemJS">B.5.2.3. Module Format = SystemJS</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Conclusion">B.5.3. Conclusion</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#system.register-as-transpilation-target">B.6. System.register as transpilation target</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:Introduction">B.6.1. Introduction</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:External_Transpilers">B.6.1.1. External Transpilers</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Example_of_a_System_register_module">B.6.1.2. Example of a System.register module</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Structure_of_a_System_register_module">B.6.2. Structure of a System.register module</a></li>
+<li><a href="appendix_b_module_loading.html#_transpilation-hints">B.6.3. Transpilation Hints</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Handling_Imports">B.6.3.1. Handling Imports</a></li>
+<li><a href="appendix_b_module_loading.html#sec:__exportFn__">B.6.3.2. &lt;&lt;exportFn&gt;&gt;</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Handling_Exports">B.6.3.3. Handling Exports</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Examples_w__Circular_Dependencies">B.6.4. Examples w/ Circular Dependencies</a></li>
+<li><a href="appendix_b_module_loading.html#sec:N4JS_Examples_w__Circular_Dependencies">B.6.5. N4JS Examples w/ Circular Dependencies</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Unresolved_Cyclic_Dependencies">B.6.5.1. Unresolved Cyclic Dependencies</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Variables___Functions">B.6.5.2. Examples with Variables &amp; Functions</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Classes">B.6.5.3. Examples with Classes</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Examples_with_SubClassing">B.6.5.4. Examples with SubClassing</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Miscellaneous">B.6.5.5. Miscellaneous</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#_resources">B.6.6. Resources</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:CommonJS_as_transpilation_target">B.7. CommonJS as transpilation target</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#_introduction-2">B.7.1. Introduction</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Transpilation_Hints">B.7.2. Transpilation Hints</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Import_Statements">B.7.2.1. Import Statements</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Export_Statements">B.7.2.2. Export Statements</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Tracking_Live_Bindings">B.7.2.3. Tracking Live Bindings</a></li>
+<li><a href="appendix_b_module_loading.html#sec:A_complete_example">B.7.2.4. A complete example</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#_resources-2">B.7.3. Resources</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_c_license.html#sec:License">Appendix C: License</a></li>
+<li><a href="appendix_d_acronyms.html#sec:Acronyms">Appendix D: Acronyms</a></li>
+<li><a href="appendix_e_bibliography_and_footnotes.html#_bibliography-and-footnotes">Appendix E: Bibliography and Footnotes</a></li>
+</ul>
+</div>
+</div>
+<div id="content"><div class="sect1">
+<h2 id="_parser"><a class="anchor" href="#_parser"></a><a class="link" href="#_parser">5. Parser</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>Some of the concepts described here were presented at
+<a href="https://www.youtube.com/watch?v=Xm-7aE1UMGY&amp;feature=youtu.be">EclipseCon 2013</a> and
+<a href="https://vimeo.com/channels/xtextcon/98446435">XtextCon 2014</a>. Note that the material presented at the linked videos may be outdated.</p>
+</div>
+<div class="sect2">
+<h3 id="sec:Parser_Overview"><a class="anchor" href="#sec:Parser_Overview"></a><a class="link" href="#sec:Parser_Overview">5.1. Overview</a></h3>
+<div class="paragraph">
+<p>The parser is created from an Xtext grammar. Actually, there are several grammars used as shown in <a href="#fig:cd_grammars">Figure CD Grammars</a>. These grammars and the parsers generated from them are described more closely in the following sections.</p>
+</div>
+<div id="fig:cd_grammars" class="imageblock center">
+<div class="content">
+<img src="chapters/05_parser/images/cd_grammars.svg" alt="cd grammars">
+</div>
+<div class="title">Figure 2. N4 Grammars</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="sec:N4JS_Parser"><a class="anchor" href="#sec:N4JS_Parser"></a><a class="link" href="#sec:N4JS_Parser">5.2. N4JS Parser</a></h3>
+<div class="paragraph">
+<p>One of the most tricky parts of JavaScript is the parsing because there is a conceptual mismatch between the <a href="appendix_d_acronyms.html#AC">ANTLR</a> runtime and the specified grammar. Another challenge is the disambiguation of regular expressions and binary operations. Both features require significant customizing of the generated parser (see figure below).</p>
+</div>
+<div id="fig:cd_ASIParser" class="imageblock center">
+<div class="content">
+<img src="chapters/05_parser/images/cd_ASIParser.svg" alt="cd ASIParser">
+</div>
+<div class="title">Figure 3. Overview custom parser implementation (runtime only)</div>
+</div>
+</div>
+<div class="sect2 language-bash">
+<h3 id="sec:Parser_Generation_Post_Processing"><a class="anchor" href="#sec:Parser_Generation_Post_Processing"></a><a class="link" href="#sec:Parser_Generation_Post_Processing">5.3. Parser Generation Post-Processing</a></h3>
+<div class="paragraph">
+<p>The ANTLR grammar that is generated by Xtext is post-processed to inject custom code into the grammar file before it is passed to the ANTLR tool. This is required in particular due to <a href="appendix_d_acronyms.html#AC">ASI</a> (Automated Semicolon Insertion), but for some other reasons as well.</p>
+</div>
+<div class="paragraph">
+<p>Actually, there are several injections:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Due to Xtext restrictions, the generated ANTLR grammar file (<strong>*.g</strong>) is modified. This means that some some additional actions are added and some rules are rewritten.</p>
+</li>
+<li>
+<p>Due to ANTLR restrictions, the generated ANTLR Java parser (<strong>*.java</strong>) os modified. This means that some generated rules are slightly modified to match certain requirements.</p>
+</li>
+<li>
+<p>Due to Java restrictions, the generated Java parser needs to be preprocessed in order to reduce the size of certain methods since they must not exceed 64k characters. This is implemented by means of an MWE fragment, activated after the other post processing steps are done.</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>The first two steps are handled by <code>AntlrGeneratorWithCustomKeywordLogic</code>, which is configured with additional helpers in <code>GenerateN4JS.mwe2</code>. shows the customized classes which modify the code generation. These classes are all part of the <code>releng.utils</code> bundle.</p>
+</div>
+<div class="imageblock center">
+<div class="content">
+<img src="chapters/05_parser/images/cd_parsergeneration.svg" alt="cd parsergeneration">
+</div>
+<div class="title">Figure 4. Class Diagram Parser Generation</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Automatic_Semicolon_Insertion"><a class="anchor" href="#sec:Automatic_Semicolon_Insertion"></a><a class="link" href="#sec:Automatic_Semicolon_Insertion">5.3.1. Automatic Semicolon Insertion</a></h4>
+<div class="paragraph">
+<p>The EcmaScript specification mandates that valid implementations automatically insert a semicolon as a statement delimiter if it is missing and the input file would become invalid due to the missing semicolon. This is known as <a href="appendix_d_acronyms.html#AC">ASI</a>. It implies that not only valid implementations have to perform this, but a valid parser has to mimic this behavior in order to parse executable code. The <a href="appendix_d_acronyms.html#AC">ASI</a> is implemented by two different means.</p>
+</div>
+<div class="paragraph">
+<p>The parser’s error recovery strategy is customized so it attempts to insert a semicolon if it was expected. Both strategies have to work hand in hand in order to consume all sorts of legal JavaScript code.</p>
+</div>
+<div class="sect4">
+<h5 id="sec:Injected_code_in_the_Antlr_grammar_file"><a class="anchor" href="#sec:Injected_code_in_the_Antlr_grammar_file"></a><a class="link" href="#sec:Injected_code_in_the_Antlr_grammar_file">5.3.1.1. Injected code in the Antlr grammar file</a></h5>
+<div class="paragraph">
+<p>Under certain circumstances, the parser has to actively promote a token to become a semicolon even though it may be a syntactically a closing brace or line break. This has to happen before that token is consumed thus the rules for return statements, continue statements and break statements are enhanced to actively promote these tokens to semicolons.</p>
+</div>
+<div class="paragraph">
+<p>The same rule is applied to promote line breaks between an expression and a possible postfix operator <code>++</code> or <code>–</code>. At this location the line break is always treated as a semicolon even though the operator may be validly consumed and produce a postfix expression.</p>
+</div>
+<div class="paragraph">
+<p>In both cases, the method <code>promoteEOL()</code> is used to move a token that may serve as an automatically injected semicolon from the so called hidden token channel to the semantic channel. The hidden tokens are usually not handled by the parser explicitly thus they are semantically invisible (therefore the term hidden token). Nevertheless, they can be put on the semantic channel explicitly to make them recognizable. That’s implemented in the EOL promotion. The offending tokens include the hidden line terminators and multi-line comments that include line breaks. Furthermore, closing braces (right curly brackets) are included in the set of offending tokens as well as explicit semicolons.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Customized_error_recovery"><a class="anchor" href="#sec:Customized_error_recovery"></a><a class="link" href="#sec:Customized_error_recovery">5.3.1.2. Customized error recovery</a></h5>
+<div class="paragraph">
+<p>Since the EOL promotion does not work well with Antlr prediction mode, another customization complements that feature. As soon as an invalid token sequence is attempted to be parsed and missing semicolon would make that sequence valid, an offending token is sought and moved to the semantic channel. This is implemented in the custom recovery strategy.</p>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:_No_line_terminator_allowed_here__handling"><a class="anchor" href="#sec:_No_line_terminator_allowed_here__handling"></a><a class="link" href="#sec:_No_line_terminator_allowed_here__handling">5.3.2. Async and <code>No line terminator allowed here</code> Handling</a></h4>
+<div class="paragraph">
+<p>There is no way of directly defining <code>No line terminator allowed here</code>. This is required not only for <a href="appendix_d_acronyms.html#AC">ASI</a>, but also for <code>async</code>. This requires not only a special rule (using some rules from <a href="#sec:Automatic_Semicolon_Insertion">ASI</a>), but also a special error recovery since the token ’async’ may be rejected (by the manually enriched rule) which is of course unexpected behavior from the generated source code.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Regular_Expression"><a class="anchor" href="#sec:Regular_Expression"></a><a class="link" href="#sec:Regular_Expression">5.3.3. Regular Expression</a></h4>
+<div class="paragraph">
+<p>The ANTLR parsing process can basically be divided into three steps. First of all, the file contents has to be read from disk. This includes the proper encoding of bytes to characters. The second step is the lexing or tokenizing of the character stream. A token is a basically a typed region in the stream, that is a triplet of token-id, offset and length. The last step is the parsing of these tokens. The result is a semantic model that is associated with a node tree. All necessary information to validate the model can be deduced from these two interlinked representations.</p>
+</div>
+<div class="imageblock center">
+<div class="content">
+<img src="chapters/05_parser/images/ad_parsing_simplified.svg" alt="ad parsing simplified">
+</div>
+<div class="title">Figure 5. Simplified visualization of the parsing</div>
+</div>
+<div class="paragraph">
+<p>Since the default semantics and control flow of Antlr generated parsers do not really fit the requirements of a fully working JavaScript parser, some customizations are necessary. <strong>Regular expression literals in JavaScript cannot be syntactically disambiguated from div operations without contextual information.</strong> Nevertheless, the spec clearly describes, where a regular expression may appear and where it is prohibited. Unfortunately, it is not possible to implement these rules in the lexer alone, since it does not have enough contextual information. Therefore, the parser has been enhanced to establish a communication channel with the lexer. It announces when it expects a regular expression rather than a binary operation.</p>
+</div>
+<div class="paragraph">
+<p>This required a reworking of the Antlr internals. Instead of a completely pre-populated <code>TokenStream</code>, the parser works on a lazy implementation that only reads as many characters as possible without a disambiguation between regular expression literals and divide operators.</p>
+</div>
+<div class="paragraph">
+<p>Only after the parser has read this buffered tokens and potentially announced that it expects a regular expression, another batch of characters is processed by the lexer until the next ambiguous situation occurs. This is fundamentally different from the default behavior of Antlr.</p>
+</div>
+<div class="imageblock center">
+<div class="content">
+<img src="chapters/05_parser/images/sd_parsing_sequence.svg" alt="sd parsing sequence">
+</div>
+<div class="title">Figure 6. Abstract control and object flow during parsing</div>
+</div>
+<div class="paragraph">
+<p>shows the involved classes which allow for this lexer-parser communication.</p>
+</div>
+<div class="imageblock center">
+<div class="content">
+<img src="chapters/05_parser/images/cd_parserlexercommunication.svg" alt="cd parserlexercommunication">
+</div>
+<div class="title">Figure 7. Class Diagram Parser-Lexer Communication</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Unicode"><a class="anchor" href="#sec:Unicode"></a><a class="link" href="#sec:Unicode">5.3.4. Unicode</a></h4>
+<div class="paragraph">
+<p>Unicode support in JavaScript includes the possibility to use unicode escape sequences in identifiers, string literals and regular expression literals. Another issue in this field is the specification of valid identifiers in JavaScript. They are described by means of unicode character classes. These have to be enumerated in the terminal rules in order to fully accept or reject valid or invalid JS identifiers.</p>
+</div>
+<div class="paragraph">
+<p>For that purpose, a small code generator is used to define the terminal fragments for certain unicode categories. The <code>UnicodeGrammarGenerator</code> basically iterates all characters from <code>Character.MIN_VALUE</code> to <code>Character.MAX_VALUE</code> and adds them as alternatives to the respective terminal fragments, e.g. <code>UNICODE_DIGIT_FRAGMENT</code>.</p>
+</div>
+<div class="paragraph">
+<p>The real terminal rules are defined as a composition of these generated fragments. Besides that, each character in an identifier, in a string literal or in a regular expression literal may be represented by its unicode escape value, e.g. ` u0060`. These escape sequences are handled and validated by the <code>IValueConverter</code> for the corresponding terminal rules.</p>
+</div>
+<div class="paragraph">
+<p>The second piece of the puzzle are the unicode escaped sequences that may be used in keywords. This issue is covered by the <code>UnicodeKeywordHelper</code> which replaces the default terminal representation in the generated Antlr grammar by more elaborated alternatives. The keyword <code>if</code> is not only lexed as <code>’if’</code> but as seen in snippet
+<a href="#lst:terminal_if">Terminal if listing</a>.</p>
+</div>
+<div id="lst:terminal_if" class="listingblock">
+<div class="title">Terminal if</div>
+<div class="content">
+<pre class="highlight"><code>If :
+    ( 'i' | '\\' 'u' '0``   0``   6``   9' )
+    ( 'f' | '\\' 'u' '0``   0``   6``   6' );</code></pre>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Literals"><a class="anchor" href="#sec:Literals"></a><a class="link" href="#sec:Literals">5.3.5. Literals</a></h4>
+<div class="paragraph">
+<p>Template literals are also to be handled specially, see <code>TemplateLiteralDisambiguationInjector</code> for details.</p>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:Modifiers"><a class="anchor" href="#sec:Modifiers"></a><a class="link" href="#sec:Modifiers">5.4. Modifiers</a></h3>
+<div class="paragraph">
+<p>On the AST side, all modifiers are included in a single enumeration <code>N4Modifier</code>. In the types model however, the individual modifiers are mapped to two different enumerations of <em>access</em> modifiers (namely <code>TypeAccessModifier</code> and <code>MemberAccessModifier</code>) and a number of boolean properties (in case of non-access modifiers such as <code>abstract</code> or <code>static</code>). This mapping is done by the types builder, mostly by calling methods in class <code>ModifierUtils</code>.</p>
+</div>
+<div class="paragraph">
+<p>The grammar allows the use of certain modifiers in many places that are actually invalid. Rules where a certain modifier may appear in the AST are implemented in method isValid(EClass,N4Modifier) in class <code>ModifierUtils</code> and checked via several validations in <code>N4JSSyntaxValidator</code>. Those validations also check for a particular order of modifiers that is not enforced by the grammar.</p>
+</div>
+<div class="paragraph">
+<p>See API documentation of enumeration <code>N4Modifier</code> in file <code>N4JS.xcore</code> and the utility class <code>ModifierUtils</code> for more details.</p>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:Conflict_Resolutions"><a class="anchor" href="#sec:Conflict_Resolutions"></a><a class="link" href="#sec:Conflict_Resolutions">5.5. Conflict Resolutions</a></h3>
+<div class="sect3">
+<h4 id="sec:Reserved_Keywords_vs__Identifier_Names"><a class="anchor" href="#sec:Reserved_Keywords_vs__Identifier_Names"></a><a class="link" href="#sec:Reserved_Keywords_vs__Identifier_Names">5.5.1. Reserved Keywords vs. Identifier Names</a></h4>
+<div class="paragraph">
+<p>Keywords and identifiers have to be distinguished by the lexer. Therefore, there is no means to decide upfront whether a certain keyword is actually used as a keyword or whether it is used as an identifier in a given context. This limitation is idiomatically overcome by a data type rule for valid identifiers. This data type rule enumerates all keywords which may be used as identifiers and the pure IDENTIFIER terminal rule as seen in <a href="#lst:keywords_as_identifier">Keywords as Identifier listing</a>.</p>
+</div>
+<div id="lst:keywords_as_identifier" class="listingblock">
+<div class="title">Keywords as Identifier</div>
+<div class="content">
+<pre class="highlight"><code class="language-ebnf" data-lang="ebnf">N4JSIdentifier: IDENTIFIER
+    | 'get'
+    | 'set'
+    ...
+;</code></pre>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Operators_and_Generics"><a class="anchor" href="#sec:Operators_and_Generics"></a><a class="link" href="#sec:Operators_and_Generics">5.5.2. Operators and Generics</a></h4>
+<div class="paragraph">
+<p>The ambiguity between shift operators and nested generics arises also from the fact, that Antlr lexer upfront without any contextual information. When implemented naively, the grammar will be broken, since a token sequence <code>a&gt;&gt;b</code> can either be part of <code>List&lt;List&lt;a&gt;&gt; b</code> or it can be part of a binary operation <code>int c = a &gt;&gt; b</code>. Therefore the shift operator may not be defined with a single token but has to be composed from individual characters (see <a href="#lst:shift_operator">Shift Operator listing</a>).</p>
+</div>
+<div id="lst:shift_operator" class="listingblock">
+<div class="title">Shift Operator listing</div>
+<div class="content">
+<pre class="highlight"><code class="language-ebnf" data-lang="ebnf">ShiftOperator:
+      '&gt;' '&gt;' '&gt;'?
+    | '&lt;' '&lt;'
+    ;</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:Content_Assist_Parser"><a class="anchor" href="#sec:Content_Assist_Parser"></a><a class="link" href="#sec:Content_Assist_Parser">5.6. Content-Assist Parser</a></h3>
+<div class="admonitionblock warning">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-warning" title=""></i>
+</td>
+<td class="content">
+This section may be outdated!
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>The <a href="appendix_d_acronyms.html#AC">CA</a> parser also needs adjustments for supporting automatic semicolon insertion and regular expressions. Instead of modifying the <a href="appendix_d_acronyms.html#AC">CA</a> parser generator similar to the normal parser, the former reuses parts of the latter as far as possible. That is, the token sequence that is produced during production parsing is used as is for the content assist parser. Semicolons have already been inserted where appropriate and regular expression are successfully distinguished from divide operators.</p>
+</div>
+<div class="paragraph">
+<p>Since the n4js grammar uses syntactic predicates, the content assist parser is compiled with backtracking enabled. This is always the case for Xtext’s CA parsers that rely on backtracking or predicates (local backtracking) in the production parser. This approach is both good (CA works in general) and bad (unpredictable decisions in case of error at locations prior to the cursor). Since parsing with backtracking enabled makes for a fundamental difference in how the prediction and parsing works and how the parser decides which decision paths to take, the customization patterns from the production parser are not applied 1:1 to the CA parser, but adapted instead. The content assist parser doesn’t use a freshly lexed token stream with unicode support, ASI or regular expression literals, but instead uses a synthesized token sequence which is rebuilt from the existing node model.</p>
+</div>
+<div class="paragraph">
+<p>The token stream that is consumed by the content assist parser is therefore not created by a lexer but by the <code>org.eclipse.n4js.ui.contentassist.NodeModelTokenSource</code>.
+It traverses the existing node model that is contained in the resource and was produced by the production parser. This approach has the significant advantage that any decision that was made by that parser is also immediately applicable to the content assist infrastructure. For that purpose, the leaf nodes of the node model are mapped to ANTLR token types.
+This is achieved by the <code>org.eclipse.n4js.ui.contentassist.ContentAssistTokenTypeMapper</code> which is capable to provide the untyped ANTLR token type (primitive int) for a given grammar element.</p>
+</div>
+<div class="paragraph">
+<p>Special considerations have been made for the last token in the produced source. If it overlaps with an existing leaf node but does not fully cover it, the plain Antlr lexer is used to consume the prefix that is overlapping. Since the terminals will never overlap with each other the longest match always wins without backtracking in the lexer, it is save to assume that only one token is produced from the prefix. The very last token in the <code>org.eclipse.n4js.ui.contentassist.NodeModelTokenSource</code> is always the EOF token (<code>org.antlr.runtime.Token.EOF_TOKEN</code>).</p>
+</div>
+<div class="paragraph">
+<p>Given that the token source is equal to the prefix in the production token source, some more thought has to be put into the synthesized end of file. The production parser used the complete file to decide where to automatically insert a semicolon and where not to. This would potentially change if there was another token next to the artificial EOF. Therefore, two cases have to considered. The first one describes CA request next to an automatically inserted semicolon and the second one describes CA requests at a position where a semicolon could have been inserted if the token to the right was another one. The <code>org.eclipse.n4js.ui.contentassist.CustomN4JSParser</code> reflects these cases. Heuristics are applied to the end of the token sequence to decide whether a second pass has to be performed to collect yet more following elements. Based on the concrete sequence, the last automatically inserted semicolon is removed from the sequence prior to the second pass or such is a token is explicitly synthesized and appended. Besides the second pass, another special treatment is made for postfix expressions. Those may not be interrupted by a hidden semicolon so those are filtered from the resulting follow set if appropriate.</p>
+</div>
+<div class="paragraph">
+<p>The parser is used by the <code>org.eclipse.n4js.ui.contentassist.ContentAssistContextFactory</code> where all relevant entry points from the super class are specialized to pass the node model in the the parser facade (<code>org.eclipse.n4js.ui.contentassist.CustomN4JSParser</code>). In that sense, the ContentAssistContextFactory serves as a drop-in replacement binding the default <code>ParserBasedContentAssistContextFactory.StatefulFactory</code>.</p>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div id="footer">
+<div id="footer-text">
+Version 0.9<br>
+Last updated 2019-08-07 15:02:40 CEST
+</div>
+</div>
+<!-- ************* docinfo-footer *************************************************************** -->
+<div class="Grid social" style="color:#d5dfea">
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <h2>Quick Links</h2>
+    <ul>
+      <li><a href="../downloads.html">Download</a></li>
+      <li><a href="../userguides/index.html">Documentation</a></li>
+      <li><a href="https://github.com/eclipse/n4js/">Source</a></li>
+      <li><a href="https://github.com/eclipse/n4js/issues">Issues</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="https://www.eclipse.org/forums/index.php/f/365/">Forum</a></li>
+      <li><a href="http://n4js.blogspot.de/">Blog</a></li>
+      <li><a href="https://dev.eclipse.org/mailman/listinfo/n4js-dev">Mailing List</a></li>
+      <li><a href="https://projects.eclipse.org/projects/technology.n4js">Eclipse Project Page</a></li>
+      <li><a href="https://twitter.com/n4jsdev">Tweets by n4jsdev</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="http://www.eclipse.org/">Eclipse Home</a></li>
+      <li><a href="http://www.eclipse.org/legal/privacy.php">Privacy Policy</a></li>
+      <li><a href="http://www.eclipse.org/legal/termsofuse.php">Terms of Use</a></li>
+      <li><a href="http://www.eclipse.org/legal/copyright.php">Copyright Agent</a></li>
+      <li><a href="http://www.eclipse.org/legal/">Legal</a></li>
+    </ul>
+  </div>
+  <div style="clear: both; height: 0; overflow: hidden;"></div>
+</div>
+
+<!-- ************* UI Scripts ************* -->
+<script type="text/javascript" src="scripts/back-to-top.js"></script>
+
+<script type="text/javascript" src="scripts/treeview.js"></script>
+<script type="text/javascript" src="scripts/toc.js"></script>
+
+<!-- ************* Prism.js Syntax Highlighting ************* -->
+<script src="scripts/prism.js"></script>
+
+<script type="text/javascript">
+	// Add the 'toclist' id for search function
+	$(".toc2 > ul").attr('id', 'toclist');
+	// Generate a Search input form
+	$("#toclist > li:first-of-type").before('<input type="text" id="pagesearch" onkeyup="search()" placeholder="Search for section...">');
+	$("#toclist > li:first-of-type").before('<i id="clear" class="fa fa-times-circle-o"></i>');
+	$("#clear").click(function(){
+	    $("#pagesearch").val('');
+	    search();
+	    $('.toc2 > ul').treeView('collapseAll');
+	});
+	// intialize Treeview.js
+	$(".toc2 > ul").treeView();
+	// Initialize Scrollspy
+</script>
+<!-- ************* docinfo-footer *************************************************************** -->
+</body>
+</html>
\ No newline at end of file
diff --git a/design/project_model.html b/design/project_model.html
new file mode 100644
index 0000000..053a621
--- /dev/null
+++ b/design/project_model.html
@@ -0,0 +1,1133 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="generator" content="Asciidoctor 1.5.5">
+<meta name="author" content="2019-08-07 15:02:40 CEST">
+<title>N4JS Design Specification</title>
+<link rel="stylesheet" href="styles/spec.min.css">
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.6.3/css/font-awesome.min.css">
+<!-- ************* docinfo ******************************************************************* -->
+
+
+<!-- ************* Favicon ************-->
+<link rel="icon" href="images/favicon.ico" />
+
+<!-- ************* Back-to-top JQuery ************* -->
+<script src="https://code.jquery.com/jquery-1.12.4.js"></script>
+<script src="https://code.jquery.com/ui/1.12.0/jquery-ui.js"></script>
+
+
+<link href="styles/prism.min.css" rel="stylesheet" />
+<script type="text/javascript" async
+  src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2/MathJax.js?config=TeX-MML-AM_CHTML">
+</script>
+
+<!-- ************* Styles ************* -->
+<link rel="stylesheet" type="text/css" href="styles/n4jsspec-adoc.css">
+
+
+<!-- ****************** NavBar ****************** -->
+<div id="menubar">
+	<div class="banner">
+        <a href="https://www.eclipse.org/n4js/#"><img id="logo" src="images/n4js-logo.png" alt="Eclipse N4JS"></a>
+    </div>
+<ul>
+  <li><a href="index.html">Index</a></li>
+</ul>
+</div>
+<!-- ************* docinfo ******************************************************************* -->
+<style>
+      .admonitionblock td.icon .icon-todo:before{content:"\f249";color:#f4ee42}
+    </style>
+</head>
+<body class="book toc2 toc-left">
+<div id="header">
+<h1>N4JS Design Specification</h1>
+<div class="details">
+<span id="author" class="author">2019-08-07 15:02:40 CEST</span><br>
+<span id="revnumber">version 0.9</span>
+</div>
+<div id="toc" class="toc2">
+<div id="toctitle">Table of Contents</div>
+<ul class="sectlevel1">
+<li><a href="introduction.html#_introduction">1. Introduction</a>
+<ul class="sectlevel2">
+<li><a href="introduction.html#notation">1.1. Notation</a></li>
+<li><a href="introduction.html#sec:IDE_Overview">1.2. IDE Components</a>
+<ul class="sectlevel3">
+<li><a href="introduction.html#sec:Naming_Conventions">1.2.1. Naming Conventions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="eclipse_setup.html#_eclipse-setup">2. Eclipse Setup</a>
+<ul class="sectlevel2">
+<li><a href="eclipse_setup.html#_system-requirements">2.1. System Requirements</a></li>
+<li><a href="eclipse_setup.html#_contribute">2.2. Contribute</a>
+<ul class="sectlevel3">
+<li><a href="eclipse_setup.html#_eclipse-installer">2.2.1. Eclipse Installer</a>
+<ul class="sectlevel4">
+<li><a href="eclipse_setup.html#_changing-the-setup-script">2.2.1.1. Changing the Setup Script</a></li>
+</ul>
+</li>
+<li><a href="eclipse_setup.html#_manual-ide-configuration">2.2.2. Manual IDE Configuration</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="release_engineering.html#_release-engineering">3. Release Engineering</a>
+<ul class="sectlevel2">
+<li><a href="release_engineering.html#_nightly-build-on-eclipse-infrastructure">3.1. Nightly build on Eclipse infrastructure</a></li>
+<li><a href="release_engineering.html#_build-the-n4js-ide-from-command-line">3.2. Build the N4JS IDE from command line</a>
+<ul class="sectlevel3">
+<li><a href="release_engineering.html#_publish-maven-tooling-code-org-eclipse-n4js-releng-util-code">3.2.1. Publish maven-tooling <code>org.eclipse.n4js.releng.util</code></a></li>
+<li><a href="release_engineering.html#sec:test-verdaccio">3.2.2. Test Verdaccio containing n4js-libs</a></li>
+<li><a href="release_engineering.html#_generation-of-eclipse-help-for-spec-and-design-document">3.2.3. Generation of Eclipse help for spec and design document</a></li>
+</ul>
+</li>
+<li><a href="release_engineering.html#_updating-frameworks-and-dependencies">3.3. Updating frameworks and dependencies</a>
+<ul class="sectlevel3">
+<li><a href="release_engineering.html#_update-of-eclipse-emf-xtext-etc">3.3.1. Update of Eclipse, EMF, Xtext, etc.</a></li>
+<li><a href="release_engineering.html#_update-of-the-embedded-jre">3.3.2. Update of the embedded JRE</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tips_and_tricks.html#_tips-and-tricks">4. Tips and Tricks</a>
+<ul class="sectlevel2">
+<li><a href="tips_and_tricks.html#_naming">4.1. Naming</a></li>
+<li><a href="tips_and_tricks.html#_logging">4.2. Logging</a></li>
+<li><a href="tips_and_tricks.html#_cancellation-handling">4.3. Cancellation Handling</a></li>
+<li><a href="tips_and_tricks.html#_caching">4.4. Caching</a></li>
+<li><a href="tips_and_tricks.html#_dependency-injection">4.5. Dependency Injection</a></li>
+<li><a href="tips_and_tricks.html#_miscellaneous">4.6. Miscellaneous</a></li>
+</ul>
+</li>
+<li><a href="parser.html#_parser">5. Parser</a>
+<ul class="sectlevel2">
+<li><a href="parser.html#sec:Parser_Overview">5.1. Overview</a></li>
+<li><a href="parser.html#sec:N4JS_Parser">5.2. N4JS Parser</a></li>
+<li><a href="parser.html#sec:Parser_Generation_Post_Processing">5.3. Parser Generation Post-Processing</a>
+<ul class="sectlevel3">
+<li><a href="parser.html#sec:Automatic_Semicolon_Insertion">5.3.1. Automatic Semicolon Insertion</a>
+<ul class="sectlevel4">
+<li><a href="parser.html#sec:Injected_code_in_the_Antlr_grammar_file">5.3.1.1. Injected code in the Antlr grammar file</a></li>
+<li><a href="parser.html#sec:Customized_error_recovery">5.3.1.2. Customized error recovery</a></li>
+</ul>
+</li>
+<li><a href="parser.html#sec:_No_line_terminator_allowed_here__handling">5.3.2. Async and <code>No line terminator allowed here</code> Handling</a></li>
+<li><a href="parser.html#sec:Regular_Expression">5.3.3. Regular Expression</a></li>
+<li><a href="parser.html#sec:Unicode">5.3.4. Unicode</a></li>
+<li><a href="parser.html#sec:Literals">5.3.5. Literals</a></li>
+</ul>
+</li>
+<li><a href="parser.html#sec:Modifiers">5.4. Modifiers</a></li>
+<li><a href="parser.html#sec:Conflict_Resolutions">5.5. Conflict Resolutions</a>
+<ul class="sectlevel3">
+<li><a href="parser.html#sec:Reserved_Keywords_vs__Identifier_Names">5.5.1. Reserved Keywords vs. Identifier Names</a></li>
+<li><a href="parser.html#sec:Operators_and_Generics">5.5.2. Operators and Generics</a></li>
+</ul>
+</li>
+<li><a href="parser.html#sec:Content_Assist_Parser">5.6. Content-Assist Parser</a></li>
+</ul>
+</li>
+<li><a href="type_system.html#_type-system">6. Type System</a>
+<ul class="sectlevel2">
+<li><a href="type_system.html#sec:Type_Model_and_Grammar">6.1. Type Model and Grammar</a>
+<ul class="sectlevel3">
+<li><a href="type_system.html#sec:Type_Model_Overview">6.1.1. Type Model Overview</a></li>
+<li><a href="type_system.html#sec:Built_in_Types">6.1.2. Built-in and Primitive Types</a></li>
+<li><a href="type_system.html#sec:Type_Model_DSL">6.1.3. Type Model DSL</a></li>
+</ul>
+</li>
+<li><a href="type_system.html#sec:Type_System_Implementation">6.2. Type System Implementation</a></li>
+<li><a href="type_system.html#sec:Type_Inference_combined_with_AST_Traversal">6.3. Type Inference of AST</a>
+<ul class="sectlevel3">
+<li><a href="type_system.html#sec:Type_Inference_combined_with_AST_Traversal__Background">6.3.1. Background</a></li>
+<li><a href="type_system.html#sec:Triggering_Type_Inference_of_AST">6.3.2. Triggering</a></li>
+<li><a href="type_system.html#sec:Traversal_Order_During_Type_Inference_of_AST">6.3.3. Traversal Order</a></li>
+<li><a href="type_system.html#sec:Cross_References_During_Type_Inference_of_AST">6.3.4. Cross-References</a></li>
+<li><a href="type_system.html#sec:Function_Accessor_Bodies_During_Type_Inference_of_AST">6.3.5. Function/Accessor Bodies</a></li>
+<li><a href="type_system.html#sec:Poly_Expressions_During_Type_Inference_of_AST">6.3.6. Poly Expressions</a></li>
+<li><a href="type_system.html#sec:Constraint_Solver_used_During_Type_Inference_of_AST">6.3.7. Constraint Solver</a></li>
+<li><a href="type_system.html#sec:Type_Guards_During_Type_Inference_of_AST">6.3.8. Type Guards</a></li>
+</ul>
+</li>
+<li><a href="type_system.html#sec:Structural_Typing">6.4. Structural Typing</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#_type-index">7. Type Index</a>
+<ul class="sectlevel2">
+<li><a href="type_index.html#sec:Type_Index_Design_Rationale">7.1. Design Rationale</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#sec:Getting_the_Xtext_Index_Content_IResourceDescriptions">7.1.1. Getting the Xtext Index (<code>IResourceDescriptions</code>) Content</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#sec:Design_Overview">7.2. Design Overview</a></li>
+<li><a href="type_index.html#sec:N4JS_Resource_Load_States">7.3. N4JS Resource Load States</a></li>
+<li><a href="type_index.html#sec:Type_Builder">7.4. Types Builder</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#sec:Type_Inference_not_allowed_in_Type_Builder">7.4.1. Type Inference not allowed in Types Builder</a></li>
+<li><a href="type_index.html#sec:ComputedTypeReferences">7.4.2. Deferred Type References</a></li>
+<li><a href="type_index.html#sec:Use_cases_of_ComputedTypeRef">7.4.3. Use cases of DeferredTypeRef</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#sec:Incremental_Builder_Overview">7.5. Incremental Builder (Overview)</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#sec:Incremental_Builder_Overview__XtextBuilder">7.5.1. XtextBuilder</a></li>
+<li><a href="type_index.html#sec:Incremental_Builder_Overview__IBuilderState">7.5.2. IBuilderState</a>
+<ul class="sectlevel4">
+<li><a href="type_index.html#copy-and-update-xtext-index">7.5.2.1. Copy and Update Xtext Index</a></li>
+<li><a href="type_index.html#build-state-setup-phase">7.5.2.2. Build State Setup Phase</a></li>
+<li><a href="type_index.html#process-queued-uris">7.5.2.3. Process Queued URIs</a></li>
+<li><a href="type_index.html#queueing-affected-resources">7.5.2.4. Queueing Affected Resources</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#sec:Incremental_Builder_Overview__Example">7.5.3. Example</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#dirty-state-handling">7.6. Dirty state handling</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#use-case-restoring-types-from-user-data">7.6.1. Use case: Restoring types from user data</a></li>
+<li><a href="type_index.html#use-case-updating-the-xtext-index">7.6.2. Use case: Updating the Xtext index</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#_project-model">8. Project Model</a>
+<ul class="sectlevel2">
+<li><a href="#sec:Package_json">8.1. Package.json File</a></li>
+<li><a href="#_accessing-project-information">8.2. Accessing Project Information</a>
+<ul class="sectlevel3">
+<li><a href="#sec:IN4JSCore">8.2.1. IN4JSCore</a></li>
+<li><a href="#sec:N4JSModel">8.2.2. N4JSModel</a></li>
+<li><a href="#sec:N4JSWorkspace">8.2.3. N4JSWorkspace</a></li>
+<li><a href="#sec:N4JSProject">8.2.4. N4JSProject</a></li>
+<li><a href="#sec:SourceContainer">8.2.5. SourceContainer</a></li>
+<li><a href="#sec:N4JSProjectsStateHelper">8.2.6. N4JSProjectsStateHelper</a></li>
+</ul>
+</li>
+<li><a href="#sec:Caching">8.3. Caching</a>
+<ul class="sectlevel3">
+<li><a href="#_caching-of-externallibraryworkspace">8.3.1. Caching of ExternalLibraryWorkspace</a></li>
+<li><a href="#_caching-of-n4jsprojectsstatehelper">8.3.2. Caching of N4JSProjectsStateHelper</a></li>
+</ul>
+</li>
+<li><a href="#sec:WildcardPathFilter">8.4. WildcardPathFilter</a></li>
+<li><a href="#sec:ProjectUtils">8.5. ProjectUtils</a></li>
+</ul>
+</li>
+<li><a href="binding.html#_binding">9. Binding</a>
+<ul class="sectlevel2">
+<li><a href="binding.html#sec:Binding_Design_Rationale">9.1. Design Rationale</a></li>
+<li><a href="binding.html#sec:Binding_to_Members">9.2. Binding to Members</a></li>
+<li><a href="binding.html#sec:Binding_Getter_Setter">9.3. Getter / Setter Binding</a></li>
+<li><a href="binding.html#chap:Statics">9.4. Static Member Binding</a></li>
+<li><a href="binding.html#sec:Binding_Enumeration">9.5. Enumeration Literals Binding</a></li>
+<li><a href="binding.html#sec:Accessibility_of_types_and_members">9.6. Accessibility of types and members</a></li>
+<li><a href="binding.html#sec:Member_Scope_Example">9.7. Member Scope Example</a></li>
+<li><a href="binding.html#sec:Scoping_for_Members_of_Composed_Type_Explained">9.8. Scoping for Members of Composed Type (Union/Intersection) Example</a></li>
+<li><a href="binding.html#sec:Binding_of_Structurally_References_Types">9.9. Structurally References Types</a></li>
+<li><a href="binding.html#sec:Building">9.10. Building</a>
+<ul class="sectlevel3">
+<li><a href="binding.html#sec:Build_Phases">9.10.1. Build Phases</a></li>
+<li><a href="binding.html#sec:Build_Scenarios">9.10.2. Build Scenarios</a></li>
+<li><a href="binding.html#sec:Lazy_linking_problem">9.10.3. Lazy linking problem</a></li>
+</ul>
+</li>
+<li><a href="binding.html#sec:Proxies_and_Proxy_Resolution">9.11. Proxies and Proxy Resolution (Overview)</a>
+<ul class="sectlevel3">
+<li><a href="binding.html#xtexts-lazy-linking-proxies">9.11.1. Xtext’s Lazy Linking Proxies</a></li>
+<li><a href="binding.html#standard-emf-proxies">9.11.2. Standard EMF Proxies</a></li>
+<li><a href="binding.html#_how-is-proxy-resolution-triggered">9.11.3. How is Proxy Resolution Triggered?</a></li>
+<li><a href="binding.html#_when-is-proxy-resolution-allowed">9.11.4. When is Proxy Resolution Allowed?</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="validation.html#_validation">10. Validation</a>
+<ul class="sectlevel2">
+<li><a href="validation.html#sec:validation_overview">10.1. Validation overview</a></li>
+<li><a href="validation.html#sec:validation_control_flow">10.2. Validation control flow</a></li>
+<li><a href="validation.html#sec:validation_issue_ids">10.3. Issue IDs and Messages</a></li>
+<li><a href="validation.html#sec:validation_usage_patterns">10.4. Usage Pattern</a></li>
+<li><a href="validation.html#sec:validation_links">10.5. Links</a></li>
+</ul>
+</li>
+<li><a href="references.html#_references">11. References</a>
+<ul class="sectlevel2">
+<li><a href="references.html#sec:usecases">11.1. Use cases</a></li>
+<li><a href="references.html#sec:calculation_algorithm">11.2. Calculation algorithm</a>
+<ul class="sectlevel3">
+<li><a href="references.html#sec:Xtext_default_implementation">11.2.1. Xtext default implementation</a></li>
+<li><a href="references.html#sec:N4_implementation">11.2.2. N4JS implementation</a></li>
+</ul>
+</li>
+<li><a href="references.html#sec:PerformanceOfDependencyCalculation">11.3. Performance Of Dependency Calculation</a></li>
+<li><a href="references.html#sec:kinds_of_references">11.4. Kinds of references</a>
+<ul class="sectlevel3">
+<li><a href="references.html#sec:Cross_References_to_be_ignored">11.4.1. Cross References to be ignored</a></li>
+<li><a href="references.html#sec:Cross_References_to_be_handled">11.4.2. Cross References to be handled</a></li>
+</ul>
+</li>
+<li><a href="references.html#sec:transitive_dependencies">11.5. Transitive dependencies</a></li>
+<li><a href="references.html#sec:find-references">11.6. Find references</a>
+<ul class="sectlevel3">
+<li><a href="references.html#_background">11.6.1. Background</a></li>
+<li><a href="references.html#_how-find-references-work">11.6.2. How Find References Work</a>
+<ul class="sectlevel4">
+<li><a href="references.html#_step-1-convert-cursor-position-to-declared-element">11.6.2.1. Step 1: Convert Cursor Position to Declared Element</a></li>
+<li><a href="references.html#_step-2-convert-declared-element-to-target-uris">11.6.2.2. Step 2: Convert Declared Element to Target URIs</a></li>
+<li><a href="references.html#_step-3-filter-potential-resources">11.6.2.3. Step 3: Filter Potential Resources</a></li>
+<li><a href="references.html#_step-4-search-references-in-resource">11.6.2.4. Step 4: Search References in Resource</a></li>
+<li><a href="references.html#_limitations-and-possible-enhancements">11.6.2.5. Limitations and Possible Enhancements</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="compilation.html#_compilation">12. Compilation</a>
+<ul class="sectlevel2">
+<li><a href="compilation.html#chap:compilation">12.1. Introduction</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:general_design_rationals">12.1.1. General design rationals</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:logging_and_error_reporting">12.1.1.1. Logging and error reporting</a></li>
+<li><a href="compilation.html#sec:progress_monitor">12.1.1.2. Progress monitor</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Xtext_Integration">12.1.2. Xtext Integration</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:xtext_default_behaviour">12.1.2.1. Xtext default behaviour</a></li>
+<li><a href="compilation.html#sec:n4js_requirements">12.1.2.2. N4JS requirements</a></li>
+<li><a href="compilation.html#sec:compiler_discovery_in_ui">12.1.2.3. Compiler discovery in UI</a></li>
+<li><a href="compilation.html#sec:compiler_discovery_in_headless">12.1.2.4. Compiler discovery in headless</a></li>
+<li><a href="compilation.html#sec:general_generator_implementation">12.1.2.5. General generator implementation</a></li>
+<li><a href="compilation.html#sec:general_generator_activation">12.1.2.6. General generator activation</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Overview_of_Input_Models">12.1.3. Overview of the Input Models</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Core_Generator">12.2. Generators</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:Compiler_Components">12.2.1. Generator Components</a></li>
+<li><a href="compilation.html#sec:Generator_architecture">12.2.2. Generator architecture</a></li>
+<li><a href="compilation.html#sec:Unified_Compiler_Configuration">12.2.3. Unified Compiler Configuration</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Transpilers">12.3. Transpilers</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:Phases">12.3.1. Overview</a></li>
+<li><a href="compilation.html#relation-between-ast-and-im">12.3.2. Relation between AST and IM</a></li>
+<li><a href="compilation.html#implementation-overview">12.3.3. Implementation Overview</a></li>
+<li><a href="compilation.html#sec:Guidelines_for_Implementing_Transformations">12.3.4. Guidelines for Implementing Transformations</a></li>
+<li><a href="compilation.html#symbol-table-in-the-im">12.3.5. Symbol Table in the IM</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:N4JS_to_EcmaScript_Transpiler">12.4. N4JS-to-EcmaScript Transpiler</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:Overview_of_Transformations">12.4.1. Overview of Transformations</a></li>
+<li><a href="compilation.html#sec:Transpiling_members">12.4.2. Transpiling members</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:Transpiling_members__Delegating_members">12.4.2.1. Techniques for special member handling</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__Partial_shadowing_of_getter_setter_pairs">12.4.2.2. Partial shadowing</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__Consuming_or_inheriting_members_of_an_interface">12.4.2.3. Consuming or inheriting members of an interface</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__Static_polyfill">12.4.2.4. Static polyfill</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__API_implementation_stubs">12.4.2.5. API / implementation stubs</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Support_for_incomplete_API_implementation_testing_in_the_N4JS_to_EcmaScript_5_Transpiler">12.4.3. Support for incomplete API implementation testing</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:Modifications_in_Impl_projects">12.4.3.1. Modifications in Impl projects</a></li>
+<li><a href="compilation.html#sec:Implementation_of_stub_generation">12.4.3.2. Implementation of stub-generation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:n4jsc_Headless_Compiler_Interface">12.5. n4jsc Headless Compiler Interface</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:building_the_headless_compiler">12.5.1. building the headless compiler</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="execution.html#_execution">13. Execution</a>
+<ul class="sectlevel2">
+<li><a href="execution.html#sec:N4JS_Project_Execution_And_Linking_Model">13.1. N4JS Project Execution And Linking Model</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#subsec:N4JS_Execution_With_NodeJS">13.1.1. N4JS Execution With NodeJS</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:N4JS_Execution_And_Linking_File">13.2. N4JS Execution And Linking File</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#subsec:NodeJS_Specific_ELF">13.2.1. NodeJS Specific ELF</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Runners-execution">13.3. Runners</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#subsec:N4_Runtime_Environments_Convention">13.3.1. N4 Runtime Environments Convention</a></li>
+<li><a href="execution.html#subsec:Passing_Information_from_IDE_to_Execution_Code_in_Runtime_Environment">13.3.2. Passing Information from IDE to Execution Code in Runtime Environment</a></li>
+<li><a href="execution.html#subsec:Runners_Design">13.3.3. Runners Design</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Legacy_Execution_Engine">13.4. Legacy Execution Engine</a></li>
+<li><a href="execution.html#sec:Design">13.5. Design</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#sec:Usage_Outside_N4JSIDE">13.5.1. Usage Outside N4JSIDE</a>
+<ul class="sectlevel4">
+<li><a href="execution.html#sec:Use_Node_with_Maven">13.5.1.1. Use Node with Maven</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Usage_Inside_N4JSIDE">13.5.2. Usage Inside N4JSIDE</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Runtime_Injection">13.6. Runtime Injection</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#sec:Running_String_Code">13.6.1. Running String Code</a></li>
+<li><a href="execution.html#sec:Running_File_Code">13.6.2. Running File Code</a></li>
+<li><a href="execution.html#sec:Injection_Code_Example">13.6.3. Injection Code Example</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#_tests">14. Tests</a>
+<ul class="sectlevel2">
+<li><a href="tests.html#sec:Performance_Tests">14.1. Performance Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Synthetic_Performance_Tests">14.1.1. Synthetic Performance Tests</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:Design_of_Generator">14.1.1.1. Design of Generator</a></li>
+<li><a href="tests.html#sec:Design_of_Performance_Test_Execution">14.1.1.2. Design of Performance Test Configuration and Execution</a></li>
+<li><a href="tests.html#sec:JUnit_Configuration">14.1.1.3. JUnit Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Test_Configuration">14.1.1.4. JUnitBenchmark Test Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Report_Configuration">14.1.1.5. JUnitBenchmark Report Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Run_Configuration">14.1.1.6. JUnitBenchmark Run Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Example">14.1.1.7. JUnitBenchmark Example</a></li>
+<li><a href="tests.html#sec:Note_on_Jenkins_Job">14.1.1.8. Note on Jenkins Job</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#sec:ECMA_Tests">14.2. ECMA Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Grammar_Tests">14.2.1. Grammar Tests</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:Negative_Tests">14.2.1.1. Negative Tests</a></li>
+<li><a href="tests.html#sec:Test_Exclusion">14.2.1.2. Test Exclusion</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Integration_Tests">14.3. Integration Tests</a></li>
+<li><a href="tests.html#sec:Test_Helpers">14.4. Test Helpers</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Parameterized_N4JS_Tests">14.4.1. Parameterized N4JS tests</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:ParameterizedXtextRunner">14.4.1.1. ParameterizedXtextRunner</a></li>
+<li><a href="tests.html#sec:TestCodeProvider">14.4.1.2. TestCodeProvider</a></li>
+<li><a href="tests.html#sec:Example_Of_Parameterized_Parser_Test">14.4.1.3. Example of parameterized parser test</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Issue_Suppression">14.5. Issue Suppression</a></li>
+<li><a href="tests.html#sec:Xpect_Tests">14.6. Xpect Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Xpect_Test_Setup">14.6.1. Xpect Test Setup</a></li>
+<li><a href="tests.html#sec:Xpect_Issue_Suppression">14.6.2. Xpect Issue Suppression</a></li>
+<li><a href="tests.html#sec:Xpect_Provided_Test_Methods">14.6.3. Xpect Provided Test Methods</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#errors">14.6.3.1. errors</a></li>
+<li><a href="tests.html#warnings">14.6.3.2. warnings</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:N4JS_Specific_Xpect_Test_Methods">14.6.4. N4JS Specific Xpect Test Methods</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:XPECT_noerrors">14.6.4.1. noerrors and nowarnings</a></li>
+<li><a href="tests.html#sec:XPECT_scope">14.6.4.2. scope</a></li>
+<li><a href="tests.html#sec:XPECT_scopeWithPosition">14.6.4.3. scopeWithPosition</a></li>
+<li><a href="tests.html#sec:XPECT_scopeWithResource">14.6.4.4. scopeWithResource</a></li>
+<li><a href="tests.html#sec:XPECT_binding">14.6.4.5. binding</a></li>
+<li><a href="tests.html#sec:XPECT_linkedPathname">14.6.4.6. linkedPathname</a></li>
+<li><a href="tests.html#sec:XPECT_type_of">14.6.4.7. type of</a></li>
+<li><a href="tests.html#sec:XPECT_expectedType">14.6.4.8. expectedType</a></li>
+<li><a href="tests.html#sec:XPECT_elementKeyword">14.6.4.9. elementKeyword</a></li>
+<li><a href="tests.html#sec:XPECT_accessModifier">14.6.4.10. accessModifier</a></li>
+<li><a href="tests.html#sec:XPECT_compileResult">14.6.4.11. compileResult</a></li>
+<li><a href="tests.html#sec:XPECT_output">14.6.4.12. output</a></li>
+<li><a href="tests.html#sec:XPECT_outputRegEx">14.6.4.13. outputRegEx</a></li>
+<li><a href="tests.html#sec:XPECT_calculatedAccessModifier">14.6.4.14. calculatedAccessModifier</a></li>
+<li><a href="tests.html#sec:XPECT_spec">14.6.4.15. spec</a></li>
+<li><a href="tests.html#sec:XPECT_deadCode">14.6.4.16. deadCode</a></li>
+<li><a href="tests.html#sec:XPECT_returnOrThrows">14.6.4.17. returnOrThrows</a></li>
+<li><a href="tests.html#sec:XPECT_lint">14.6.4.18. lint</a></li>
+<li><a href="tests.html#sec:XPECT_lintFails">14.6.4.19. lintFails</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:FIXME_Xpect_modifier">14.6.5. FIXME Xpect modifier</a></li>
+<li><a href="tests.html#sec:Expectmatrix_Xpect_Test_Methods">14.6.6. Expectmatrix Xpect tests</a></li>
+<li><a href="tests.html#xpect-lint-tests">14.6.7. Xpect Lint Tests</a></li>
+</ul>
+</li>
+<li><a href="tests.html#xpect-proposal-tests">14.7. Xpect Proposal Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Validation_vs__Non_Validation">14.7.1. Validation vs. Non-Validation</a></li>
+<li><a href="tests.html#sec:General_Proposal_Test_Features">14.7.2. General Proposal Test Features</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:Test_Variables">14.7.2.1. Test Variables</a></li>
+<li><a href="tests.html#sec:Location_and_Selection">14.7.2.2. at – Location and Selection</a></li>
+<li><a href="tests.html#sec:Multi_Line_Expectations_in_Proposal_Tests">14.7.2.3. Multi Line Expectations in Proposal Tests</a></li>
+<li><a href="tests.html#sec:Timeout">14.7.2.4. Timeout and Performance</a></li>
+</ul>
+</li>
+<li><a href="tests.html#proposals-verify-existence-of-proposals">14.7.3. proposals – Verify Existence of Proposals</a></li>
+<li><a href="tests.html#sec:Verify_displayed_string">14.7.4. display – Verify displayed string</a></li>
+<li><a href="tests.html#sec:Apply_Proposal">14.7.5. apply – Apply Proposal</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#resource-application-in-other-files">14.7.5.1. resource – application in other files</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Content_Assist_Cycling">14.7.6. kind – Content Assist Cycling</a></li>
+<li><a href="tests.html#fileValidVerify-validation-status">14.7.7. fileValid – Verify validation status</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Apply_Proposal_And_Execute_Tests">14.8. Apply Proposal And Execute Tests</a></li>
+<li><a href="tests.html#sec:Organize_Imports_Test">14.9. Organize Imports Test</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#organizeimports">14.9.1. organizeImports</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Access_Control_Test">14.10. Access Control Test</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#test-scenarios">14.10.1. Test Scenarios</a></li>
+<li><a href="tests.html#n4js-code-generator">14.10.2. N4JS Code Generator</a></li>
+<li><a href="tests.html#xtext-issue-matcher">14.10.3. Xtext Issue Matcher</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Smoke_Tests">14.11. Smoke Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#how-to-handle-smoke-test-errors">14.11.1. How to handle smoke test errors?</a></li>
+<li><a href="tests.html#smoketester-and-exceptionanalyzer">14.11.2. SmokeTester and ExceptionAnalyzer</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:UI_Tests_with_SWTBot">14.12. UI Tests with SWTBot</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#writing-swtbot-tests">14.12.1. Writing SWTBot Tests</a></li>
+<li><a href="tests.html#running-swtbot-tests">14.12.2. Running SWTBot Tests</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Debugging_UI_Tests">14.13. Debugging UI Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Connecting_to_the_X_server_on_the_build_node">14.13.1. Connecting to the X-server on the build-node</a></li>
+<li><a href="tests.html#sec:Tools_to_investigate_the_java_stack">14.13.2. Tools to investigate the java-stack</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="ui_concepts.html#_ui-concepts">15. UI Concepts</a>
+<ul class="sectlevel2">
+<li><a href="ui_concepts.html#sec:User_Interface_Concepts">15.1. User Interface Concepts</a>
+<ul class="sectlevel3">
+<li><a href="ui_concepts.html#sec:Eclipse_UI_Concepts">15.1.1. Eclipse UI Concepts</a>
+<ul class="sectlevel4">
+<li><a href="ui_concepts.html#sec:Label_Provider">15.1.1.1. Label Provider</a></li>
+<li><a href="ui_concepts.html#sec:Markers">15.1.1.2. Markers</a></li>
+<li><a href="ui_concepts.html#sec:Commands__Toolbar_and_Menus">15.1.1.3. Commands, Toolbar and Menus</a></li>
+<li><a href="ui_concepts.html#sec:Content_Assist">15.1.1.4. Content Assist</a></li>
+<li><a href="ui_concepts.html#sec:Quick_Fixes">15.1.1.5. Quick Fixes</a></li>
+<li><a href="ui_concepts.html#sec:Quick_Assist">15.1.1.6. Quick Assist</a></li>
+<li><a href="ui_concepts.html#sec:Clean_Up_Actions">15.1.1.7. Clean Up Actions</a></li>
+<li><a href="ui_concepts.html#sec:Save_Actions">15.1.1.8. Save Actions</a></li>
+<li><a href="ui_concepts.html#sec:Auto_Edit">15.1.1.9. Auto Edit</a></li>
+<li><a href="ui_concepts.html#sec:Template_Proposals">15.1.1.10. Template Proposals</a></li>
+<li><a href="ui_concepts.html#sec:Outline_View___Quick_Outline">15.1.1.11. Outline View / Quick Outline</a></li>
+<li><a href="ui_concepts.html#sec:Navigator__Package_Explorer__Project_Explorer">15.1.1.12. Navigator, Package Explorer, Project Explorer</a></li>
+<li><a href="ui_concepts.html#sec:Hyperlinking_and_Navigation">15.1.1.13. Hyperlinking and Navigation</a></li>
+<li><a href="ui_concepts.html#sec:Syntax_and_Semantic_Coloring">15.1.1.14. Syntax and Semantic Coloring</a></li>
+<li><a href="ui_concepts.html#sec:Code_Formatter">15.1.1.15. Code Formatter</a></li>
+<li><a href="ui_concepts.html#sec:Wizards">15.1.1.16. Wizards</a></li>
+<li><a href="ui_concepts.html#sec:Cheat_Sheets">15.1.1.17. Cheat Sheets</a></li>
+<li><a href="ui_concepts.html#sec:Context_sensitive_Help">15.1.1.18. Context-sensitive Help</a></li>
+<li><a href="ui_concepts.html#sec:Hovers">15.1.1.19. Hovers</a></li>
+<li><a href="ui_concepts.html#sec:Folding">15.1.1.20. Folding</a></li>
+<li><a href="ui_concepts.html#sec:Customizable_validation___severity">15.1.1.21. Customizable validation / severity</a></li>
+<li><a href="ui_concepts.html#sec:Proposals">15.1.1.22. Proposals</a></li>
+</ul>
+</li>
+<li><a href="ui_concepts.html#sec:Non_Eclipse_UI_Concepts">15.1.2. Non-Eclipse UI Concepts</a>
+<ul class="sectlevel4">
+<li><a href="ui_concepts.html#sec:Overlays">15.1.2.1. Overlays</a></li>
+<li><a href="ui_concepts.html#sec:Goto__Inferred__Type">15.1.2.2. Goto (Inferred) Type</a></li>
+<li><a href="ui_concepts.html#sec:Postfix_Completion">15.1.2.3. Postfix Completion</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="ui_concepts.html#_user-interface-resources">15.2. User Interface Resources</a>
+<ul class="sectlevel3">
+<li><a href="ui_concepts.html#_icons">15.2.1. Icons</a>
+<ul class="sectlevel4">
+<li><a href="ui_concepts.html#_eclipse-platform-icons">15.2.1.1. Eclipse Platform Icons</a></li>
+<li><a href="ui_concepts.html#_n4js-specific-icons">15.2.1.2. N4JS Specific Icons</a></li>
+<li><a href="ui_concepts.html#_high-resolution-icons">15.2.1.3. High Resolution Icons</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="formatting.html#_formatting">16. Formatting</a>
+<ul class="sectlevel2">
+<li><a href="formatting.html#sec:FmtObjective">16.1. Objective</a>
+<ul class="sectlevel3">
+<li><a href="formatting.html#sec:FmtFormatting_Comments">16.1.1. Formatting Comments</a></li>
+</ul>
+</li>
+<li><a href="formatting.html#sec:FmtArchitecture">16.2. Architecture</a>
+<ul class="sectlevel3">
+<li><a href="formatting.html#sec:Implementation_example">16.2.1. Implementation example</a></li>
+</ul>
+</li>
+<li><a href="formatting.html#sec:FmtFormatter_Implementation_Guidelines">16.3. Formatter Implementation Guidelines</a></li>
+<li><a href="formatting.html#sec:FmtConfiguration">16.4. Configuration</a></li>
+<li><a href="formatting.html#sec:FmtUI_Integration">16.5. UI Integration</a></li>
+<li><a href="formatting.html#sec:FmtUnit_Testing_with_Xpect">16.6. Unit Testing with Xpect</a></li>
+</ul>
+</li>
+<li><a href="external_libraries.html#_external-libraries">17. External Libraries</a>
+<ul class="sectlevel2">
+<li><a href="external_libraries.html#sec:Major_Components">17.1. Major Components</a>
+<ul class="sectlevel3">
+<li><a href="external_libraries.html#subsec:External_Resources">17.1.1. External Resources</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Workspace">17.1.2. External Library Workspace</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Preference_Store">17.1.3. External Library Preference Store</a></li>
+<li><a href="external_libraries.html#subsec:npm_Manager">17.1.4. Library Manager</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Builder_Helper">17.1.5. External Library Builder</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Xtext_Index_Persister">17.1.6. External Library Xtext Index Persister</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Preference_Page">17.1.7. External Library Preference Page</a></li>
+</ul>
+</li>
+<li><a href="external_libraries.html#sec:Headless_External_Library_Support">17.2. Headless External Library Support</a>
+<ul class="sectlevel3">
+<li><a href="external_libraries.html#_custom-npm-settings">17.2.1. Custom npm settings</a></li>
+</ul>
+</li>
+<li><a href="external_libraries.html#sec:lmFutureWork">17.3. Future Work</a>
+<ul class="sectlevel3">
+<li><a href="external_libraries.html#subsec:lmMultipleDependencyScope">17.3.1. Multiple Dependency Scope</a></li>
+<li><a href="external_libraries.html#subsec:lmRunTestsFromLibrary">17.3.2. Run Tests from TestLibrary</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="json_support.html#sec:JSON_Support">18. JSON Support</a>
+<ul class="sectlevel2">
+<li><a href="json_support.html#sec:JSON_Parser">18.1. JSON Parser</a>
+<ul class="sectlevel3">
+<li><a href="json_support.html#sec:JSON_Parser_Unicode_Escaping">18.1.1. Escaping Unicode Control Characters in String Literals</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Empty_Text">18.1.2. Empty Text</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Nested_Structures">18.1.3. Nested Structures</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Whitespace">18.1.4. Whitespace</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Comments">18.1.5. Comments</a></li>
+</ul>
+</li>
+<li><a href="json_support.html#sec:JSON_Language_Extensions">18.2. JSON Language Extensions</a>
+<ul class="sectlevel3">
+<li><a href="json_support.html#sec:JSON_Validator_Extensions">18.2.1. JSON Validator Extensions</a>
+<ul class="sectlevel4">
+<li><a href="json_support.html#sec:File_Specitic_Validator_Extensions">18.2.1.1. File-Specific Validator Extensions</a></li>
+<li><a href="json_support.html#sec:JSON_Declarative_JSON_Validator_Extensions">18.2.1.2. Declarative JSON Validator Extensions</a></li>
+</ul>
+</li>
+<li><a href="json_support.html#_json-resource-description-strategy">18.2.2. JSON Resource Description Strategy</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_jsdoc">19. JSDoc</a>
+<ul class="sectlevel2">
+<li><a href="jsdoc.html#sec:Design_Rationale">19.1. Design Rationale</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#_general-design">19.1.1. General Design</a></li>
+<li><a href="jsdoc.html#sec:Type_Expressions">19.1.2. Type Expressions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="docexporter.html#_docexporter">20. DocExporter</a>
+<ul class="sectlevel2">
+<li><a href="docexporter.html#sec:Specification_Exporter">20.1. Specification Exporter</a></li>
+</ul>
+</li>
+<li><a href="rename_refactoring.html#_rename-refactoring">21. Rename Refactoring</a>
+<ul class="sectlevel2">
+<li><a href="rename_refactoring.html#_rename-refactoring-ui-interaction">21.1. Rename Refactoring UI interaction</a></li>
+<li><a href="rename_refactoring.html#_renameelementprocessor-interaction">21.2. RenameElementProcessor interaction</a></li>
+</ul>
+</li>
+<li><a href="flow_graphs.html#chap:flowgraphs">22. Flow Graphs</a>
+<ul class="sectlevel2">
+<li><a href="flow_graphs.html#sec:flowgraphs_overview">22.1. Flow graphs overview</a>
+<ul class="sectlevel3">
+<li><a href="flow_graphs.html#_internal-graph">22.1.1. Internal graph</a></li>
+<li><a href="flow_graphs.html#_optimizations">22.1.2. Optimizations</a></li>
+<li><a href="flow_graphs.html#_api-for-client-analyses">22.1.3. API for client analyses</a>
+<ul class="sectlevel4">
+<li><a href="flow_graphs.html#_mapping-from-internal-to-ast-elements">22.1.3.1. Mapping from internal to AST elements</a></li>
+<li><a href="flow_graphs.html#_graph-visitor">22.1.3.2. Graph visitor</a></li>
+<li><a href="flow_graphs.html#_graph-explorer">22.1.3.3. Graph explorer</a></li>
+<li><a href="flow_graphs.html#_branch-walker">22.1.3.4. Branch walker</a></li>
+<li><a href="flow_graphs.html#_example-1-compute-string-for-each-path">22.1.3.5. Example 1: Compute string for each path</a></li>
+<li><a href="flow_graphs.html#_path-quantor">22.1.3.6. Path quantor</a></li>
+</ul>
+</li>
+<li><a href="flow_graphs.html#_control-flow-analyses">22.1.4. Control flow analyses</a>
+<ul class="sectlevel4">
+<li><a href="flow_graphs.html#_dead-code-analysis">22.1.4.1. Dead code analysis</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="flow_graphs.html#sec:dataflow">22.2. Dataflow</a>
+<ul class="sectlevel3">
+<li><a href="flow_graphs.html#_dataflow-graph">22.2.1. Dataflow graph</a></li>
+<li><a href="flow_graphs.html#_dataflow-analyses">22.2.2. Dataflow analyses</a>
+<ul class="sectlevel4">
+<li><a href="flow_graphs.html#_def-def-def-nothing-analysis">22.2.2.1. Def&#8594;Def / Def&#8594;Nothing analysis</a></li>
+<li><a href="flow_graphs.html#_def-use-decl-analysis">22.2.2.2. Def|Use&#8592;Decl analysis</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="publish_npms.html#sec:publish-npms-to-public">23. Publish npms</a>
+<ul class="sectlevel2">
+<li><a href="publish_npms.html#sec:publish-npms-n4js-maven">23.1. Publish n4js-libs to during  maven build</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Hints">Appendix A: Hints</a>
+<ul class="sectlevel2">
+<li><a href="appendix_a_hints.html#sec:XtextInjection">A.1. Xtext Injection</a>
+<ul class="sectlevel3">
+<li><a href="appendix_a_hints.html#sec:DI_MultipleInjectors_Singletons">A.1.1. Multiple Injectors and Singletons</a>
+<ul class="sectlevel4">
+<li><a href="appendix_a_hints.html#sec:DI_avoid_duplicate_singletons">A.1.1.1. Avoiding duplicate singletons</a>
+<ul class="sectlevel5">
+<li><a href="appendix_a_hints.html#sec:DI_binding_in_shared">A.1.1.1.1. Defining binding in the shared injector</a></li>
+<li><a href="appendix_a_hints.html#sec:DI_binding_in_custom">A.1.1.1.2. Defining binding in the custom injector</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:DI_Hints">A.1.2. Dependency Injection Hints</a>
+<ul class="sectlevel4">
+<li><a href="appendix_a_hints.html#sec:DI_custom_bundle">A.1.2.1. Use DI in custom bundle, use DI with extensions</a>
+<ul class="sectlevel5">
+<li><a href="appendix_a_hints.html#sec:DI_custom_bundle_problem">A.1.2.1.1. Problem</a></li>
+<li><a href="appendix_a_hints.html#sec:DI_custom_bundle_solution">A.1.2.1.2. Solution</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Access_Other_DSL_Injector">A.1.2.2. How do I get the Guice Injector of my language?</a>
+<ul class="sectlevel5">
+<li><a href="appendix_a_hints.html#sec:DSL_Injector_UI_context">A.1.2.2.1. UI context</a></li>
+<li><a href="appendix_a_hints.html#sec:DSL_Injector_Non_UI_context">A.1.2.2.2. Non UI context but with injection context</a></li>
+<li><a href="appendix_a_hints.html#sec:DSL_Injector_Non_UI_non_injection_context">A.1.2.2.3. Non UI context without injection context</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Cancel_Indicator">A.1.2.3. How do I get cancel indicators in different contexts?</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Eclipse">A.2. Eclipse</a>
+<ul class="sectlevel3">
+<li><a href="appendix_a_hints.html#sec:Show_Xtext_Index">A.2.1. Show the current Xtext index</a></li>
+<li><a href="appendix_a_hints.html#sec:Plugin_spy">A.2.2. Plug-in spy</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Maven-hints">A.3. Maven</a>
+<ul class="sectlevel3">
+<li><a href="appendix_a_hints.html#how-to-check-for-maven-mojo-updates">A.3.1. How to check for Maven MOJO updates</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#_module-loading">Appendix B: Module Loading</a>
+<ul class="sectlevel2">
+<li><a href="appendix_b_module_loading.html#sec:Dependency_Management">B.1. Dependency Management</a></li>
+<li><a href="appendix_b_module_loading.html#ecmascript-modules">B.2. ECMAScript Modules</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:ES5_Modules_Systems">B.2.1. ES5 Modules Systems</a></li>
+<li><a href="appendix_b_module_loading.html#sec:ES6_Modules">B.2.2. ES6 Modules</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:ECMAScript_Module_Loaders">B.3. ECMAScript Module Loaders</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:ES6_Module_Loaders">B.3.1. ES6 Module Loaders</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Polyfills_for_ES6_Module_Loaders">B.3.2. Polyfills for ES6 Module Loaders</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:es6_module_loader">B.3.2.1. es6-module-loader</a></li>
+<li><a href="appendix_b_module_loading.html#sec:SystemJS">B.3.2.2. SystemJS</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Demo">B.3.2.3. Demo</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#case-study-typescript">B.4. Case Study : TypeScript</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:ES6_Modules_Support">B.4.1. ES6 Modules Support</a></li>
+<li><a href="appendix_b_module_loading.html#sec:TypeScript_and_Module_Loading">B.4.2. TypeScript and Module Loading</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Cyclic_Dependencies">B.5. Cyclic Dependencies</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:Setup">B.5.1. Setup</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Transpile_and_Execute">B.5.2. Transpile and Execute</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Module_Format___AMD">B.5.2.1. Module Format = AMD</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Module_Format___CommonJS">B.5.2.2. Module Format = CommonJS</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Module_Format___SystemJS">B.5.2.3. Module Format = SystemJS</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Conclusion">B.5.3. Conclusion</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#system.register-as-transpilation-target">B.6. System.register as transpilation target</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:Introduction">B.6.1. Introduction</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:External_Transpilers">B.6.1.1. External Transpilers</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Example_of_a_System_register_module">B.6.1.2. Example of a System.register module</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Structure_of_a_System_register_module">B.6.2. Structure of a System.register module</a></li>
+<li><a href="appendix_b_module_loading.html#_transpilation-hints">B.6.3. Transpilation Hints</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Handling_Imports">B.6.3.1. Handling Imports</a></li>
+<li><a href="appendix_b_module_loading.html#sec:__exportFn__">B.6.3.2. &lt;&lt;exportFn&gt;&gt;</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Handling_Exports">B.6.3.3. Handling Exports</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Examples_w__Circular_Dependencies">B.6.4. Examples w/ Circular Dependencies</a></li>
+<li><a href="appendix_b_module_loading.html#sec:N4JS_Examples_w__Circular_Dependencies">B.6.5. N4JS Examples w/ Circular Dependencies</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Unresolved_Cyclic_Dependencies">B.6.5.1. Unresolved Cyclic Dependencies</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Variables___Functions">B.6.5.2. Examples with Variables &amp; Functions</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Classes">B.6.5.3. Examples with Classes</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Examples_with_SubClassing">B.6.5.4. Examples with SubClassing</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Miscellaneous">B.6.5.5. Miscellaneous</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#_resources">B.6.6. Resources</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:CommonJS_as_transpilation_target">B.7. CommonJS as transpilation target</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#_introduction-2">B.7.1. Introduction</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Transpilation_Hints">B.7.2. Transpilation Hints</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Import_Statements">B.7.2.1. Import Statements</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Export_Statements">B.7.2.2. Export Statements</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Tracking_Live_Bindings">B.7.2.3. Tracking Live Bindings</a></li>
+<li><a href="appendix_b_module_loading.html#sec:A_complete_example">B.7.2.4. A complete example</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#_resources-2">B.7.3. Resources</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_c_license.html#sec:License">Appendix C: License</a></li>
+<li><a href="appendix_d_acronyms.html#sec:Acronyms">Appendix D: Acronyms</a></li>
+<li><a href="appendix_e_bibliography_and_footnotes.html#_bibliography-and-footnotes">Appendix E: Bibliography and Footnotes</a></li>
+</ul>
+</div>
+</div>
+<div id="content"><div class="sect1">
+<h2 id="_project-model"><a class="anchor" href="#_project-model"></a><a class="link" href="#_project-model">8. Project Model</a></h2>
+<div class="sectionbody">
+<div class="sect2">
+<h3 id="sec:Package_json"><a class="anchor" href="#sec:Package_json"></a><a class="link" href="#sec:Package_json">8.1. Package.json File</a></h3>
+<div class="paragraph">
+<p>See [<a href="appendix_e_bibliography_and_footnotes.html#N4JSSpec">N4JSSpec</a>] for the format specification of N4JS-specific package.json files.
+Based on the JSON-model-based AST that can be parsed from the package.json file, we transform the information that can be extracted into an instance of the N4JS-specific ProjectDescription model.
+This model is defined by means of EMF, the Xcore file is found in the N4JS model bundle.</p>
+</div>
+<div id="fig:projectDescriptionModel" class="imageblock">
+<div class="content">
+<img src="chapters/08_projectModel/images/cd_projectDescription.svg" alt="Project Description Model">
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_accessing-project-information"><a class="anchor" href="#_accessing-project-information"></a><a class="link" href="#_accessing-project-information">8.2. Accessing Project Information</a></h3>
+<div class="paragraph">
+<p>The information in the package.json files is parsed into memory at runtime, e.g. within Eclipse or in headless mode. It is made available via the <code>IN4JSCore</code> facade that provides a high-level abstraction when working with the project structure. This facade has two implementations:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>One implementation is backed by the file system, e.g. <code>java.io.File</code> and used in a headless environment</p>
+</li>
+<li>
+<p>Another implementation uses the Eclipse resource model (<code>IProject</code>, <code>IFolder</code>, <code>IFile</code>) to describe the contents of an <code>IN4JSProject</code>. This implementation is automatically kept in sync whenever the contents of a package.json file is edited by a user. It is also maintained as dynamic project information to make the Eclipse workspace aware of the declared dependencies. That is, Eclipse projects know about the project references in the package.json file.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>The project model is mimicing the handle based services of Eclipse’s <code>JavaCore</code>, the handles are often represented as EMF <code>URIs</code> though. Therefore the API allows to retrieve a source folder for a given N4JS resource, all the libraries that are configured for a project or simply the project’s name or the information if it exists. Subsequent components in the processing chain like the scope provider can leverage the API to deduce the container configuration and visiblity constraints. Project references are resolved transparently.</p>
+</div>
+<div class="paragraph">
+<p>The Xtext index participation is implemented by means of the <code>N4JSToBeBuiltComputer</code> and the <code>N4JSAllContainersState</code>. These classes provide access to the container configuration.</p>
+</div>
+<div class="paragraph">
+<p>The precedence for the dependency resolution follows this lookup chain:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>An accessible <code>IN4JSProject</code> with the given name is located in the workspace.</p>
+</li>
+<li>
+<p>The library manager provides access to the requested project.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Accordingly, the type lookup follows the same chain due to the container configuration that is deduced from the package.json configuration. Of course is prefers locally defined type that can be found in the current project over types that are located in referenced projects.</p>
+</div>
+<div class="sect3">
+<h4 id="sec:IN4JSCore"><a class="anchor" href="#sec:IN4JSCore"></a><a class="link" href="#sec:IN4JSCore">8.2.1. IN4JSCore</a></h4>
+<div class="paragraph">
+<p>Facade analogous to org.eclipse.jdt.core.JavaCore.
+It is used look up the project or source container where a resource URI belongs to.
+It also provides some helper methods to retrieve information from the package.json file.
+N4JSRuntimeCore uses the file system and thus uses java.io to access files and folders.
+N4JSEclipseCore uses the Eclipse workspace and thus uses org.eclipse.resources API.
+Both Core implementations act as wrapper for N4JSModel resp. EclipseN4JSModel.
+Instances of the <code>IN4JSCore</code> are obtained as usually via dependency injection, e.g. <code>@Inject IN4JSCore n4jsCore</code>.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:N4JSModel"><a class="anchor" href="#sec:N4JSModel"></a><a class="link" href="#sec:N4JSModel">8.2.2. N4JSModel</a></h4>
+<div class="paragraph">
+<p>N4JSModel uses FileBasedWorkspace to load and access the project description from the package.json file and create wrappers for projects (N4JSProject) and source containers (N4JSSourceContainer).</p>
+</div>
+<div class="paragraph">
+<p>A source container is a wrapper for a file system that has been marked as source folder in the package.json file.
+For determination of the current project a given EMF URI pointing to the project path is used.
+In N4JSModel this location is directly wrapped in N4JSProject.
+In N4JSModel a given EMF URI is resolved to a source container by using the specified relative source paths from the package.json file and file system based project location.
+If the EMF URI converted to a file URI starts with the absolute source folder path a N4JSProjectSourceContainer is created and returned for that EMF URI.</p>
+</div>
+<div class="paragraph">
+<p>In EclipseN4JSModel (that extends N4JSModel) the last segment of the URI is assumed to be the project name and via the EclipseBasedN4JSWorkspace that wraps the Eclipse workspace a project with that name is tried to be resolved.
+This IProject is than wrapped in N4JSEclipseProject.
+In EclipseN4JSModel a given EMF URI is resolved to an org.eclipse.core.resources.IResource belonging to the IWorkspaceRoot.
+That resource is wrapped in EclipseSourceContainer.</p>
+</div>
+<div class="paragraph">
+<p>N4JSModel is also used to retrieve project dependencies wrapped as N4JSProject.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:N4JSWorkspace"><a class="anchor" href="#sec:N4JSWorkspace"></a><a class="link" href="#sec:N4JSWorkspace">8.2.3. N4JSWorkspace</a></h4>
+<div class="paragraph">
+<p>The FileBasedWorkspace and EclipseBasedN4JSWorkspace should only be accessed by N4JSModel resp. EclipseN4JSModel as they know the contract for the URI scheme.
+The FileBasedWorkspace creates AbstractTreeIterator for the direct contents of a source container, so that their children can be navigated by this as well.
+It then filters out all directories and returns an iterator of all files as EMF URIs.</p>
+</div>
+<div class="paragraph">
+<p>The EclipseBasedN4JSWorkspace wraps the IWorkspaceRoot.</p>
+</div>
+<div class="paragraph">
+<p>Fetching the project description read out from the package.json file is cached in both workspace implementations.
+In FileBasedWorkspace the LazyProjectDescriptionHandle is used as proxy and in EclipseBasedN4JSWorkspace the ProjectDescriptionLoadListener is used to invalidate the cache when the package.json file has been changed.
+ProjectDescriptionLoadListener also ensures that dependent projects are considered by the Eclipse builder by setting dynamic dependencies in the project meta data.
+It also updates these project dependencies if it is required and recalculates all source containers.</p>
+</div>
+<div class="paragraph">
+<p>In the tests another implementation, MockWorkspace, is used, that provides a dummy project description.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:N4JSProject"><a class="anchor" href="#sec:N4JSProject"></a><a class="link" href="#sec:N4JSProject">8.2.4. N4JSProject</a></h4>
+<div class="paragraph">
+<p>A N4JSProject represents a configured project as defined in the package.json file.
+So in principles it wraps access to N4JSModel (and so to containing source containers, libraries and so on)
+and to some information from the package.json file directly (like defined module filters, vendorId and others).
+It is also used to compare depending projects.</p>
+</div>
+<div class="paragraph">
+<p>N4JSProject is the runtime representation while N4JSEclipseProject represents a project in the Eclipse workspace.
+N4JSProject is identified by its EMF location URI while N4JSEclipseProject wraps the underlying org.eclipse.core.resources.IProject.</p>
+</div>
+<div class="paragraph">
+<p>In tests MockProject is used.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:SourceContainer"><a class="anchor" href="#sec:SourceContainer"></a><a class="link" href="#sec:SourceContainer">8.2.5. SourceContainer</a></h4>
+<div class="paragraph">
+<p>A source container contains either source files for production, tests or external declarations.
+By default all these files resp. their containing types will be exported to the Xtext index.
+A source container belongs exactly to one project it is identified by its project relative location.</p>
+</div>
+<div class="paragraph">
+<p>A N4JSProjectSourceContainer is a container that contains unpacked n4js, js and n4jsd files that can be modified.
+By default all these files are syntactically and semantically validated (this can be configured by the use of module filters).
+Except for n4jsd files, all files are compiled by the configured compilers.</p>
+</div>
+<div class="paragraph">
+<p>EclipseSourceContainer specializes N4JSProjectSourceContainer to work on top of the Eclipse resources API.
+Thus besides the location it also wraps the IFolder.</p>
+</div>
+<div class="paragraph">
+<p>The IFile was chosen instead of using the java.io.File because changes to an IFile (and IResource in general) trigger a workspace change event so that the Xtext builder is triggered properly.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:N4JSProjectsStateHelper"><a class="anchor" href="#sec:N4JSProjectsStateHelper"></a><a class="link" href="#sec:N4JSProjectsStateHelper">8.2.6. N4JSProjectsStateHelper</a></h4>
+<div class="paragraph">
+<p>Calculates the visible containers for a given container, where containers are source containers within the project as well as source containers of other depending projects in workspace.
+The calculated handles are cached and invalidated if the project description file has changed or the project has been closed or reopened.</p>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="sec:Caching"><a class="anchor" href="#sec:Caching"></a><a class="link" href="#sec:Caching">8.3. Caching</a></h3>
+<div class="paragraph">
+<p>Caching is heavily used in the ExternalLibraryWorkspace and the N4JSProjectsStateHelper.
+The ExternalLibraryWorkspace relies on caching to provide data about all installed npms, their locations, names, shadowing, dependencies and so on.
+The caching of the ExternalLibraryWorkspace is implemented in the ExternalProjectMappings which inspects all external locations and builds all necessary mappings.
+The set of mappings start from a simple list of all npms, include mappings that map from location or name to a N4JSExternalProject, or give reduced set of projects.</p>
+</div>
+<div class="sect3">
+<h4 id="_caching-of-externallibraryworkspace"><a class="anchor" href="#_caching-of-externallibraryworkspace"></a><a class="link" href="#_caching-of-externallibraryworkspace">8.3.1. Caching of ExternalLibraryWorkspace</a></h4>
+<div class="paragraph">
+<p>A reduced set of projects is used since not all npms are actually necessary projects for the N4JS IDE.
+Most transitively installed plain-JS npms are of no interest since they are completely invisible to the user.
+The reduced set of projects always consists of all user workspace projects and all shipped libraries.
+From the set of all installed npms, only those are necessary that are dependencies of a non-plain-JS projects.
+Shadowed projects are also not included in the reduced set of npms.</p>
+</div>
+<div class="paragraph">
+<p>To access projects that are not included in the reduced set of npms, the ExternalProjectMappings provides some collections that contain complete set of npms.
+Additionally, some mappings also provide information about not necessary npms.
+Note that mappings that use the project name as a key naturally cannot provide information about shadowed projects.</p>
+</div>
+<div class="paragraph">
+<p>The mapping cache is updated every time a refresh is triggered (e.g. at startup or by hitting F5).
+Also, every action of the library manager (such as installing or registering npms) triggers a refresh.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_caching-of-n4jsprojectsstatehelper"><a class="anchor" href="#_caching-of-n4jsprojectsstatehelper"></a><a class="link" href="#_caching-of-n4jsprojectsstatehelper">8.3.2. Caching of N4JSProjectsStateHelper</a></h4>
+<div class="paragraph">
+<p>The N4JSProjectsStateHelper uses the MultiCleartriggerCache for caching information about projects of the user workspace.
+The EclipseBasedN4JSWorkspace does not caching at all, but provides information about project descriptions which is expensive to compute on the fly.
+Hence this information is cached in the MultiCleartriggerCache and updated every time a project description changes, is added or removed.</p>
+</div>
+<div class="paragraph">
+<p>Sometimes, a project description is rendered invalid as a side effect of a change on another project description.
+In this case, the cache of both of project descriptions has to be updated.
+The implementation to cope with these side effects uses the MultiCleartriggerCache which allows to set multiple triggers that will clear a cached object.</p>
+</div>
+<div class="paragraph">
+<p>However, it seems reasonable to align the caching of the user workspace to the caching of the external workspace.
+The reason is that caching of user workspace information such as N4JSProjects would increase build performance significantly.
+This is since as of now, projects (and information about all their source containers) is computed on the fly, that causes thousands of expensive calls to the file system.</p>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="sec:WildcardPathFilter"><a class="anchor" href="#sec:WildcardPathFilter"></a><a class="link" href="#sec:WildcardPathFilter">8.4. WildcardPathFilter</a></h3>
+<div class="paragraph">
+<p>This class encapsulates the logic to resolve (wildcard containing) paths against the file system.
+With the method matchPath it is also possible to resolve a path without using the file system.
+This class is also able to resolve relative navigation in paths.</p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="sec:ProjectUtils"><a class="anchor" href="#sec:ProjectUtils"></a><a class="link" href="#sec:ProjectUtils">8.5. ProjectUtils</a></h3>
+<div class="paragraph">
+<p>ProjectUtils provides additional methods for providing information only required in compilation, e.g. like file and module descriptor.
+It uses IN4JSCore to retrieve the information of output path and whether module wrapping is required for a given file.</p>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div id="footer">
+<div id="footer-text">
+Version 0.9<br>
+Last updated 2019-08-07 15:02:40 CEST
+</div>
+</div>
+<!-- ************* docinfo-footer *************************************************************** -->
+<div class="Grid social" style="color:#d5dfea">
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <h2>Quick Links</h2>
+    <ul>
+      <li><a href="../downloads.html">Download</a></li>
+      <li><a href="../userguides/index.html">Documentation</a></li>
+      <li><a href="https://github.com/eclipse/n4js/">Source</a></li>
+      <li><a href="https://github.com/eclipse/n4js/issues">Issues</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="https://www.eclipse.org/forums/index.php/f/365/">Forum</a></li>
+      <li><a href="http://n4js.blogspot.de/">Blog</a></li>
+      <li><a href="https://dev.eclipse.org/mailman/listinfo/n4js-dev">Mailing List</a></li>
+      <li><a href="https://projects.eclipse.org/projects/technology.n4js">Eclipse Project Page</a></li>
+      <li><a href="https://twitter.com/n4jsdev">Tweets by n4jsdev</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="http://www.eclipse.org/">Eclipse Home</a></li>
+      <li><a href="http://www.eclipse.org/legal/privacy.php">Privacy Policy</a></li>
+      <li><a href="http://www.eclipse.org/legal/termsofuse.php">Terms of Use</a></li>
+      <li><a href="http://www.eclipse.org/legal/copyright.php">Copyright Agent</a></li>
+      <li><a href="http://www.eclipse.org/legal/">Legal</a></li>
+    </ul>
+  </div>
+  <div style="clear: both; height: 0; overflow: hidden;"></div>
+</div>
+
+<!-- ************* UI Scripts ************* -->
+<script type="text/javascript" src="scripts/back-to-top.js"></script>
+
+<script type="text/javascript" src="scripts/treeview.js"></script>
+<script type="text/javascript" src="scripts/toc.js"></script>
+
+<!-- ************* Prism.js Syntax Highlighting ************* -->
+<script src="scripts/prism.js"></script>
+
+<script type="text/javascript">
+	// Add the 'toclist' id for search function
+	$(".toc2 > ul").attr('id', 'toclist');
+	// Generate a Search input form
+	$("#toclist > li:first-of-type").before('<input type="text" id="pagesearch" onkeyup="search()" placeholder="Search for section...">');
+	$("#toclist > li:first-of-type").before('<i id="clear" class="fa fa-times-circle-o"></i>');
+	$("#clear").click(function(){
+	    $("#pagesearch").val('');
+	    search();
+	    $('.toc2 > ul').treeView('collapseAll');
+	});
+	// intialize Treeview.js
+	$(".toc2 > ul").treeView();
+	// Initialize Scrollspy
+</script>
+<!-- ************* docinfo-footer *************************************************************** -->
+</body>
+</html>
\ No newline at end of file
diff --git a/design/publish_npms.html b/design/publish_npms.html
new file mode 100644
index 0000000..5f425fc
--- /dev/null
+++ b/design/publish_npms.html
@@ -0,0 +1,1047 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="generator" content="Asciidoctor 1.5.5">
+<meta name="author" content="2019-08-07 15:02:40 CEST">
+<title>N4JS Design Specification</title>
+<link rel="stylesheet" href="styles/spec.min.css">
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.6.3/css/font-awesome.min.css">
+<!-- ************* docinfo ******************************************************************* -->
+
+
+<!-- ************* Favicon ************-->
+<link rel="icon" href="images/favicon.ico" />
+
+<!-- ************* Back-to-top JQuery ************* -->
+<script src="https://code.jquery.com/jquery-1.12.4.js"></script>
+<script src="https://code.jquery.com/ui/1.12.0/jquery-ui.js"></script>
+
+
+<link href="styles/prism.min.css" rel="stylesheet" />
+<script type="text/javascript" async
+  src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2/MathJax.js?config=TeX-MML-AM_CHTML">
+</script>
+
+<!-- ************* Styles ************* -->
+<link rel="stylesheet" type="text/css" href="styles/n4jsspec-adoc.css">
+
+
+<!-- ****************** NavBar ****************** -->
+<div id="menubar">
+	<div class="banner">
+        <a href="https://www.eclipse.org/n4js/#"><img id="logo" src="images/n4js-logo.png" alt="Eclipse N4JS"></a>
+    </div>
+<ul>
+  <li><a href="index.html">Index</a></li>
+</ul>
+</div>
+<!-- ************* docinfo ******************************************************************* -->
+<style>
+      .admonitionblock td.icon .icon-todo:before{content:"\f249";color:#f4ee42}
+    </style>
+</head>
+<body class="book toc2 toc-left">
+<div id="header">
+<h1>N4JS Design Specification</h1>
+<div class="details">
+<span id="author" class="author">2019-08-07 15:02:40 CEST</span><br>
+<span id="revnumber">version 0.9</span>
+</div>
+<div id="toc" class="toc2">
+<div id="toctitle">Table of Contents</div>
+<ul class="sectlevel1">
+<li><a href="introduction.html#_introduction">1. Introduction</a>
+<ul class="sectlevel2">
+<li><a href="introduction.html#notation">1.1. Notation</a></li>
+<li><a href="introduction.html#sec:IDE_Overview">1.2. IDE Components</a>
+<ul class="sectlevel3">
+<li><a href="introduction.html#sec:Naming_Conventions">1.2.1. Naming Conventions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="eclipse_setup.html#_eclipse-setup">2. Eclipse Setup</a>
+<ul class="sectlevel2">
+<li><a href="eclipse_setup.html#_system-requirements">2.1. System Requirements</a></li>
+<li><a href="eclipse_setup.html#_contribute">2.2. Contribute</a>
+<ul class="sectlevel3">
+<li><a href="eclipse_setup.html#_eclipse-installer">2.2.1. Eclipse Installer</a>
+<ul class="sectlevel4">
+<li><a href="eclipse_setup.html#_changing-the-setup-script">2.2.1.1. Changing the Setup Script</a></li>
+</ul>
+</li>
+<li><a href="eclipse_setup.html#_manual-ide-configuration">2.2.2. Manual IDE Configuration</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="release_engineering.html#_release-engineering">3. Release Engineering</a>
+<ul class="sectlevel2">
+<li><a href="release_engineering.html#_nightly-build-on-eclipse-infrastructure">3.1. Nightly build on Eclipse infrastructure</a></li>
+<li><a href="release_engineering.html#_build-the-n4js-ide-from-command-line">3.2. Build the N4JS IDE from command line</a>
+<ul class="sectlevel3">
+<li><a href="release_engineering.html#_publish-maven-tooling-code-org-eclipse-n4js-releng-util-code">3.2.1. Publish maven-tooling <code>org.eclipse.n4js.releng.util</code></a></li>
+<li><a href="release_engineering.html#sec:test-verdaccio">3.2.2. Test Verdaccio containing n4js-libs</a></li>
+<li><a href="release_engineering.html#_generation-of-eclipse-help-for-spec-and-design-document">3.2.3. Generation of Eclipse help for spec and design document</a></li>
+</ul>
+</li>
+<li><a href="release_engineering.html#_updating-frameworks-and-dependencies">3.3. Updating frameworks and dependencies</a>
+<ul class="sectlevel3">
+<li><a href="release_engineering.html#_update-of-eclipse-emf-xtext-etc">3.3.1. Update of Eclipse, EMF, Xtext, etc.</a></li>
+<li><a href="release_engineering.html#_update-of-the-embedded-jre">3.3.2. Update of the embedded JRE</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tips_and_tricks.html#_tips-and-tricks">4. Tips and Tricks</a>
+<ul class="sectlevel2">
+<li><a href="tips_and_tricks.html#_naming">4.1. Naming</a></li>
+<li><a href="tips_and_tricks.html#_logging">4.2. Logging</a></li>
+<li><a href="tips_and_tricks.html#_cancellation-handling">4.3. Cancellation Handling</a></li>
+<li><a href="tips_and_tricks.html#_caching">4.4. Caching</a></li>
+<li><a href="tips_and_tricks.html#_dependency-injection">4.5. Dependency Injection</a></li>
+<li><a href="tips_and_tricks.html#_miscellaneous">4.6. Miscellaneous</a></li>
+</ul>
+</li>
+<li><a href="parser.html#_parser">5. Parser</a>
+<ul class="sectlevel2">
+<li><a href="parser.html#sec:Parser_Overview">5.1. Overview</a></li>
+<li><a href="parser.html#sec:N4JS_Parser">5.2. N4JS Parser</a></li>
+<li><a href="parser.html#sec:Parser_Generation_Post_Processing">5.3. Parser Generation Post-Processing</a>
+<ul class="sectlevel3">
+<li><a href="parser.html#sec:Automatic_Semicolon_Insertion">5.3.1. Automatic Semicolon Insertion</a>
+<ul class="sectlevel4">
+<li><a href="parser.html#sec:Injected_code_in_the_Antlr_grammar_file">5.3.1.1. Injected code in the Antlr grammar file</a></li>
+<li><a href="parser.html#sec:Customized_error_recovery">5.3.1.2. Customized error recovery</a></li>
+</ul>
+</li>
+<li><a href="parser.html#sec:_No_line_terminator_allowed_here__handling">5.3.2. Async and <code>No line terminator allowed here</code> Handling</a></li>
+<li><a href="parser.html#sec:Regular_Expression">5.3.3. Regular Expression</a></li>
+<li><a href="parser.html#sec:Unicode">5.3.4. Unicode</a></li>
+<li><a href="parser.html#sec:Literals">5.3.5. Literals</a></li>
+</ul>
+</li>
+<li><a href="parser.html#sec:Modifiers">5.4. Modifiers</a></li>
+<li><a href="parser.html#sec:Conflict_Resolutions">5.5. Conflict Resolutions</a>
+<ul class="sectlevel3">
+<li><a href="parser.html#sec:Reserved_Keywords_vs__Identifier_Names">5.5.1. Reserved Keywords vs. Identifier Names</a></li>
+<li><a href="parser.html#sec:Operators_and_Generics">5.5.2. Operators and Generics</a></li>
+</ul>
+</li>
+<li><a href="parser.html#sec:Content_Assist_Parser">5.6. Content-Assist Parser</a></li>
+</ul>
+</li>
+<li><a href="type_system.html#_type-system">6. Type System</a>
+<ul class="sectlevel2">
+<li><a href="type_system.html#sec:Type_Model_and_Grammar">6.1. Type Model and Grammar</a>
+<ul class="sectlevel3">
+<li><a href="type_system.html#sec:Type_Model_Overview">6.1.1. Type Model Overview</a></li>
+<li><a href="type_system.html#sec:Built_in_Types">6.1.2. Built-in and Primitive Types</a></li>
+<li><a href="type_system.html#sec:Type_Model_DSL">6.1.3. Type Model DSL</a></li>
+</ul>
+</li>
+<li><a href="type_system.html#sec:Type_System_Implementation">6.2. Type System Implementation</a></li>
+<li><a href="type_system.html#sec:Type_Inference_combined_with_AST_Traversal">6.3. Type Inference of AST</a>
+<ul class="sectlevel3">
+<li><a href="type_system.html#sec:Type_Inference_combined_with_AST_Traversal__Background">6.3.1. Background</a></li>
+<li><a href="type_system.html#sec:Triggering_Type_Inference_of_AST">6.3.2. Triggering</a></li>
+<li><a href="type_system.html#sec:Traversal_Order_During_Type_Inference_of_AST">6.3.3. Traversal Order</a></li>
+<li><a href="type_system.html#sec:Cross_References_During_Type_Inference_of_AST">6.3.4. Cross-References</a></li>
+<li><a href="type_system.html#sec:Function_Accessor_Bodies_During_Type_Inference_of_AST">6.3.5. Function/Accessor Bodies</a></li>
+<li><a href="type_system.html#sec:Poly_Expressions_During_Type_Inference_of_AST">6.3.6. Poly Expressions</a></li>
+<li><a href="type_system.html#sec:Constraint_Solver_used_During_Type_Inference_of_AST">6.3.7. Constraint Solver</a></li>
+<li><a href="type_system.html#sec:Type_Guards_During_Type_Inference_of_AST">6.3.8. Type Guards</a></li>
+</ul>
+</li>
+<li><a href="type_system.html#sec:Structural_Typing">6.4. Structural Typing</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#_type-index">7. Type Index</a>
+<ul class="sectlevel2">
+<li><a href="type_index.html#sec:Type_Index_Design_Rationale">7.1. Design Rationale</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#sec:Getting_the_Xtext_Index_Content_IResourceDescriptions">7.1.1. Getting the Xtext Index (<code>IResourceDescriptions</code>) Content</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#sec:Design_Overview">7.2. Design Overview</a></li>
+<li><a href="type_index.html#sec:N4JS_Resource_Load_States">7.3. N4JS Resource Load States</a></li>
+<li><a href="type_index.html#sec:Type_Builder">7.4. Types Builder</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#sec:Type_Inference_not_allowed_in_Type_Builder">7.4.1. Type Inference not allowed in Types Builder</a></li>
+<li><a href="type_index.html#sec:ComputedTypeReferences">7.4.2. Deferred Type References</a></li>
+<li><a href="type_index.html#sec:Use_cases_of_ComputedTypeRef">7.4.3. Use cases of DeferredTypeRef</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#sec:Incremental_Builder_Overview">7.5. Incremental Builder (Overview)</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#sec:Incremental_Builder_Overview__XtextBuilder">7.5.1. XtextBuilder</a></li>
+<li><a href="type_index.html#sec:Incremental_Builder_Overview__IBuilderState">7.5.2. IBuilderState</a>
+<ul class="sectlevel4">
+<li><a href="type_index.html#copy-and-update-xtext-index">7.5.2.1. Copy and Update Xtext Index</a></li>
+<li><a href="type_index.html#build-state-setup-phase">7.5.2.2. Build State Setup Phase</a></li>
+<li><a href="type_index.html#process-queued-uris">7.5.2.3. Process Queued URIs</a></li>
+<li><a href="type_index.html#queueing-affected-resources">7.5.2.4. Queueing Affected Resources</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#sec:Incremental_Builder_Overview__Example">7.5.3. Example</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#dirty-state-handling">7.6. Dirty state handling</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#use-case-restoring-types-from-user-data">7.6.1. Use case: Restoring types from user data</a></li>
+<li><a href="type_index.html#use-case-updating-the-xtext-index">7.6.2. Use case: Updating the Xtext index</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="project_model.html#_project-model">8. Project Model</a>
+<ul class="sectlevel2">
+<li><a href="project_model.html#sec:Package_json">8.1. Package.json File</a></li>
+<li><a href="project_model.html#_accessing-project-information">8.2. Accessing Project Information</a>
+<ul class="sectlevel3">
+<li><a href="project_model.html#sec:IN4JSCore">8.2.1. IN4JSCore</a></li>
+<li><a href="project_model.html#sec:N4JSModel">8.2.2. N4JSModel</a></li>
+<li><a href="project_model.html#sec:N4JSWorkspace">8.2.3. N4JSWorkspace</a></li>
+<li><a href="project_model.html#sec:N4JSProject">8.2.4. N4JSProject</a></li>
+<li><a href="project_model.html#sec:SourceContainer">8.2.5. SourceContainer</a></li>
+<li><a href="project_model.html#sec:N4JSProjectsStateHelper">8.2.6. N4JSProjectsStateHelper</a></li>
+</ul>
+</li>
+<li><a href="project_model.html#sec:Caching">8.3. Caching</a>
+<ul class="sectlevel3">
+<li><a href="project_model.html#_caching-of-externallibraryworkspace">8.3.1. Caching of ExternalLibraryWorkspace</a></li>
+<li><a href="project_model.html#_caching-of-n4jsprojectsstatehelper">8.3.2. Caching of N4JSProjectsStateHelper</a></li>
+</ul>
+</li>
+<li><a href="project_model.html#sec:WildcardPathFilter">8.4. WildcardPathFilter</a></li>
+<li><a href="project_model.html#sec:ProjectUtils">8.5. ProjectUtils</a></li>
+</ul>
+</li>
+<li><a href="binding.html#_binding">9. Binding</a>
+<ul class="sectlevel2">
+<li><a href="binding.html#sec:Binding_Design_Rationale">9.1. Design Rationale</a></li>
+<li><a href="binding.html#sec:Binding_to_Members">9.2. Binding to Members</a></li>
+<li><a href="binding.html#sec:Binding_Getter_Setter">9.3. Getter / Setter Binding</a></li>
+<li><a href="binding.html#chap:Statics">9.4. Static Member Binding</a></li>
+<li><a href="binding.html#sec:Binding_Enumeration">9.5. Enumeration Literals Binding</a></li>
+<li><a href="binding.html#sec:Accessibility_of_types_and_members">9.6. Accessibility of types and members</a></li>
+<li><a href="binding.html#sec:Member_Scope_Example">9.7. Member Scope Example</a></li>
+<li><a href="binding.html#sec:Scoping_for_Members_of_Composed_Type_Explained">9.8. Scoping for Members of Composed Type (Union/Intersection) Example</a></li>
+<li><a href="binding.html#sec:Binding_of_Structurally_References_Types">9.9. Structurally References Types</a></li>
+<li><a href="binding.html#sec:Building">9.10. Building</a>
+<ul class="sectlevel3">
+<li><a href="binding.html#sec:Build_Phases">9.10.1. Build Phases</a></li>
+<li><a href="binding.html#sec:Build_Scenarios">9.10.2. Build Scenarios</a></li>
+<li><a href="binding.html#sec:Lazy_linking_problem">9.10.3. Lazy linking problem</a></li>
+</ul>
+</li>
+<li><a href="binding.html#sec:Proxies_and_Proxy_Resolution">9.11. Proxies and Proxy Resolution (Overview)</a>
+<ul class="sectlevel3">
+<li><a href="binding.html#xtexts-lazy-linking-proxies">9.11.1. Xtext’s Lazy Linking Proxies</a></li>
+<li><a href="binding.html#standard-emf-proxies">9.11.2. Standard EMF Proxies</a></li>
+<li><a href="binding.html#_how-is-proxy-resolution-triggered">9.11.3. How is Proxy Resolution Triggered?</a></li>
+<li><a href="binding.html#_when-is-proxy-resolution-allowed">9.11.4. When is Proxy Resolution Allowed?</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="validation.html#_validation">10. Validation</a>
+<ul class="sectlevel2">
+<li><a href="validation.html#sec:validation_overview">10.1. Validation overview</a></li>
+<li><a href="validation.html#sec:validation_control_flow">10.2. Validation control flow</a></li>
+<li><a href="validation.html#sec:validation_issue_ids">10.3. Issue IDs and Messages</a></li>
+<li><a href="validation.html#sec:validation_usage_patterns">10.4. Usage Pattern</a></li>
+<li><a href="validation.html#sec:validation_links">10.5. Links</a></li>
+</ul>
+</li>
+<li><a href="references.html#_references">11. References</a>
+<ul class="sectlevel2">
+<li><a href="references.html#sec:usecases">11.1. Use cases</a></li>
+<li><a href="references.html#sec:calculation_algorithm">11.2. Calculation algorithm</a>
+<ul class="sectlevel3">
+<li><a href="references.html#sec:Xtext_default_implementation">11.2.1. Xtext default implementation</a></li>
+<li><a href="references.html#sec:N4_implementation">11.2.2. N4JS implementation</a></li>
+</ul>
+</li>
+<li><a href="references.html#sec:PerformanceOfDependencyCalculation">11.3. Performance Of Dependency Calculation</a></li>
+<li><a href="references.html#sec:kinds_of_references">11.4. Kinds of references</a>
+<ul class="sectlevel3">
+<li><a href="references.html#sec:Cross_References_to_be_ignored">11.4.1. Cross References to be ignored</a></li>
+<li><a href="references.html#sec:Cross_References_to_be_handled">11.4.2. Cross References to be handled</a></li>
+</ul>
+</li>
+<li><a href="references.html#sec:transitive_dependencies">11.5. Transitive dependencies</a></li>
+<li><a href="references.html#sec:find-references">11.6. Find references</a>
+<ul class="sectlevel3">
+<li><a href="references.html#_background">11.6.1. Background</a></li>
+<li><a href="references.html#_how-find-references-work">11.6.2. How Find References Work</a>
+<ul class="sectlevel4">
+<li><a href="references.html#_step-1-convert-cursor-position-to-declared-element">11.6.2.1. Step 1: Convert Cursor Position to Declared Element</a></li>
+<li><a href="references.html#_step-2-convert-declared-element-to-target-uris">11.6.2.2. Step 2: Convert Declared Element to Target URIs</a></li>
+<li><a href="references.html#_step-3-filter-potential-resources">11.6.2.3. Step 3: Filter Potential Resources</a></li>
+<li><a href="references.html#_step-4-search-references-in-resource">11.6.2.4. Step 4: Search References in Resource</a></li>
+<li><a href="references.html#_limitations-and-possible-enhancements">11.6.2.5. Limitations and Possible Enhancements</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="compilation.html#_compilation">12. Compilation</a>
+<ul class="sectlevel2">
+<li><a href="compilation.html#chap:compilation">12.1. Introduction</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:general_design_rationals">12.1.1. General design rationals</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:logging_and_error_reporting">12.1.1.1. Logging and error reporting</a></li>
+<li><a href="compilation.html#sec:progress_monitor">12.1.1.2. Progress monitor</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Xtext_Integration">12.1.2. Xtext Integration</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:xtext_default_behaviour">12.1.2.1. Xtext default behaviour</a></li>
+<li><a href="compilation.html#sec:n4js_requirements">12.1.2.2. N4JS requirements</a></li>
+<li><a href="compilation.html#sec:compiler_discovery_in_ui">12.1.2.3. Compiler discovery in UI</a></li>
+<li><a href="compilation.html#sec:compiler_discovery_in_headless">12.1.2.4. Compiler discovery in headless</a></li>
+<li><a href="compilation.html#sec:general_generator_implementation">12.1.2.5. General generator implementation</a></li>
+<li><a href="compilation.html#sec:general_generator_activation">12.1.2.6. General generator activation</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Overview_of_Input_Models">12.1.3. Overview of the Input Models</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Core_Generator">12.2. Generators</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:Compiler_Components">12.2.1. Generator Components</a></li>
+<li><a href="compilation.html#sec:Generator_architecture">12.2.2. Generator architecture</a></li>
+<li><a href="compilation.html#sec:Unified_Compiler_Configuration">12.2.3. Unified Compiler Configuration</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Transpilers">12.3. Transpilers</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:Phases">12.3.1. Overview</a></li>
+<li><a href="compilation.html#relation-between-ast-and-im">12.3.2. Relation between AST and IM</a></li>
+<li><a href="compilation.html#implementation-overview">12.3.3. Implementation Overview</a></li>
+<li><a href="compilation.html#sec:Guidelines_for_Implementing_Transformations">12.3.4. Guidelines for Implementing Transformations</a></li>
+<li><a href="compilation.html#symbol-table-in-the-im">12.3.5. Symbol Table in the IM</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:N4JS_to_EcmaScript_Transpiler">12.4. N4JS-to-EcmaScript Transpiler</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:Overview_of_Transformations">12.4.1. Overview of Transformations</a></li>
+<li><a href="compilation.html#sec:Transpiling_members">12.4.2. Transpiling members</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:Transpiling_members__Delegating_members">12.4.2.1. Techniques for special member handling</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__Partial_shadowing_of_getter_setter_pairs">12.4.2.2. Partial shadowing</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__Consuming_or_inheriting_members_of_an_interface">12.4.2.3. Consuming or inheriting members of an interface</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__Static_polyfill">12.4.2.4. Static polyfill</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__API_implementation_stubs">12.4.2.5. API / implementation stubs</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Support_for_incomplete_API_implementation_testing_in_the_N4JS_to_EcmaScript_5_Transpiler">12.4.3. Support for incomplete API implementation testing</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:Modifications_in_Impl_projects">12.4.3.1. Modifications in Impl projects</a></li>
+<li><a href="compilation.html#sec:Implementation_of_stub_generation">12.4.3.2. Implementation of stub-generation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:n4jsc_Headless_Compiler_Interface">12.5. n4jsc Headless Compiler Interface</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:building_the_headless_compiler">12.5.1. building the headless compiler</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="execution.html#_execution">13. Execution</a>
+<ul class="sectlevel2">
+<li><a href="execution.html#sec:N4JS_Project_Execution_And_Linking_Model">13.1. N4JS Project Execution And Linking Model</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#subsec:N4JS_Execution_With_NodeJS">13.1.1. N4JS Execution With NodeJS</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:N4JS_Execution_And_Linking_File">13.2. N4JS Execution And Linking File</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#subsec:NodeJS_Specific_ELF">13.2.1. NodeJS Specific ELF</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Runners-execution">13.3. Runners</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#subsec:N4_Runtime_Environments_Convention">13.3.1. N4 Runtime Environments Convention</a></li>
+<li><a href="execution.html#subsec:Passing_Information_from_IDE_to_Execution_Code_in_Runtime_Environment">13.3.2. Passing Information from IDE to Execution Code in Runtime Environment</a></li>
+<li><a href="execution.html#subsec:Runners_Design">13.3.3. Runners Design</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Legacy_Execution_Engine">13.4. Legacy Execution Engine</a></li>
+<li><a href="execution.html#sec:Design">13.5. Design</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#sec:Usage_Outside_N4JSIDE">13.5.1. Usage Outside N4JSIDE</a>
+<ul class="sectlevel4">
+<li><a href="execution.html#sec:Use_Node_with_Maven">13.5.1.1. Use Node with Maven</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Usage_Inside_N4JSIDE">13.5.2. Usage Inside N4JSIDE</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Runtime_Injection">13.6. Runtime Injection</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#sec:Running_String_Code">13.6.1. Running String Code</a></li>
+<li><a href="execution.html#sec:Running_File_Code">13.6.2. Running File Code</a></li>
+<li><a href="execution.html#sec:Injection_Code_Example">13.6.3. Injection Code Example</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#_tests">14. Tests</a>
+<ul class="sectlevel2">
+<li><a href="tests.html#sec:Performance_Tests">14.1. Performance Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Synthetic_Performance_Tests">14.1.1. Synthetic Performance Tests</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:Design_of_Generator">14.1.1.1. Design of Generator</a></li>
+<li><a href="tests.html#sec:Design_of_Performance_Test_Execution">14.1.1.2. Design of Performance Test Configuration and Execution</a></li>
+<li><a href="tests.html#sec:JUnit_Configuration">14.1.1.3. JUnit Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Test_Configuration">14.1.1.4. JUnitBenchmark Test Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Report_Configuration">14.1.1.5. JUnitBenchmark Report Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Run_Configuration">14.1.1.6. JUnitBenchmark Run Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Example">14.1.1.7. JUnitBenchmark Example</a></li>
+<li><a href="tests.html#sec:Note_on_Jenkins_Job">14.1.1.8. Note on Jenkins Job</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#sec:ECMA_Tests">14.2. ECMA Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Grammar_Tests">14.2.1. Grammar Tests</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:Negative_Tests">14.2.1.1. Negative Tests</a></li>
+<li><a href="tests.html#sec:Test_Exclusion">14.2.1.2. Test Exclusion</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Integration_Tests">14.3. Integration Tests</a></li>
+<li><a href="tests.html#sec:Test_Helpers">14.4. Test Helpers</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Parameterized_N4JS_Tests">14.4.1. Parameterized N4JS tests</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:ParameterizedXtextRunner">14.4.1.1. ParameterizedXtextRunner</a></li>
+<li><a href="tests.html#sec:TestCodeProvider">14.4.1.2. TestCodeProvider</a></li>
+<li><a href="tests.html#sec:Example_Of_Parameterized_Parser_Test">14.4.1.3. Example of parameterized parser test</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Issue_Suppression">14.5. Issue Suppression</a></li>
+<li><a href="tests.html#sec:Xpect_Tests">14.6. Xpect Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Xpect_Test_Setup">14.6.1. Xpect Test Setup</a></li>
+<li><a href="tests.html#sec:Xpect_Issue_Suppression">14.6.2. Xpect Issue Suppression</a></li>
+<li><a href="tests.html#sec:Xpect_Provided_Test_Methods">14.6.3. Xpect Provided Test Methods</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#errors">14.6.3.1. errors</a></li>
+<li><a href="tests.html#warnings">14.6.3.2. warnings</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:N4JS_Specific_Xpect_Test_Methods">14.6.4. N4JS Specific Xpect Test Methods</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:XPECT_noerrors">14.6.4.1. noerrors and nowarnings</a></li>
+<li><a href="tests.html#sec:XPECT_scope">14.6.4.2. scope</a></li>
+<li><a href="tests.html#sec:XPECT_scopeWithPosition">14.6.4.3. scopeWithPosition</a></li>
+<li><a href="tests.html#sec:XPECT_scopeWithResource">14.6.4.4. scopeWithResource</a></li>
+<li><a href="tests.html#sec:XPECT_binding">14.6.4.5. binding</a></li>
+<li><a href="tests.html#sec:XPECT_linkedPathname">14.6.4.6. linkedPathname</a></li>
+<li><a href="tests.html#sec:XPECT_type_of">14.6.4.7. type of</a></li>
+<li><a href="tests.html#sec:XPECT_expectedType">14.6.4.8. expectedType</a></li>
+<li><a href="tests.html#sec:XPECT_elementKeyword">14.6.4.9. elementKeyword</a></li>
+<li><a href="tests.html#sec:XPECT_accessModifier">14.6.4.10. accessModifier</a></li>
+<li><a href="tests.html#sec:XPECT_compileResult">14.6.4.11. compileResult</a></li>
+<li><a href="tests.html#sec:XPECT_output">14.6.4.12. output</a></li>
+<li><a href="tests.html#sec:XPECT_outputRegEx">14.6.4.13. outputRegEx</a></li>
+<li><a href="tests.html#sec:XPECT_calculatedAccessModifier">14.6.4.14. calculatedAccessModifier</a></li>
+<li><a href="tests.html#sec:XPECT_spec">14.6.4.15. spec</a></li>
+<li><a href="tests.html#sec:XPECT_deadCode">14.6.4.16. deadCode</a></li>
+<li><a href="tests.html#sec:XPECT_returnOrThrows">14.6.4.17. returnOrThrows</a></li>
+<li><a href="tests.html#sec:XPECT_lint">14.6.4.18. lint</a></li>
+<li><a href="tests.html#sec:XPECT_lintFails">14.6.4.19. lintFails</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:FIXME_Xpect_modifier">14.6.5. FIXME Xpect modifier</a></li>
+<li><a href="tests.html#sec:Expectmatrix_Xpect_Test_Methods">14.6.6. Expectmatrix Xpect tests</a></li>
+<li><a href="tests.html#xpect-lint-tests">14.6.7. Xpect Lint Tests</a></li>
+</ul>
+</li>
+<li><a href="tests.html#xpect-proposal-tests">14.7. Xpect Proposal Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Validation_vs__Non_Validation">14.7.1. Validation vs. Non-Validation</a></li>
+<li><a href="tests.html#sec:General_Proposal_Test_Features">14.7.2. General Proposal Test Features</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:Test_Variables">14.7.2.1. Test Variables</a></li>
+<li><a href="tests.html#sec:Location_and_Selection">14.7.2.2. at – Location and Selection</a></li>
+<li><a href="tests.html#sec:Multi_Line_Expectations_in_Proposal_Tests">14.7.2.3. Multi Line Expectations in Proposal Tests</a></li>
+<li><a href="tests.html#sec:Timeout">14.7.2.4. Timeout and Performance</a></li>
+</ul>
+</li>
+<li><a href="tests.html#proposals-verify-existence-of-proposals">14.7.3. proposals – Verify Existence of Proposals</a></li>
+<li><a href="tests.html#sec:Verify_displayed_string">14.7.4. display – Verify displayed string</a></li>
+<li><a href="tests.html#sec:Apply_Proposal">14.7.5. apply – Apply Proposal</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#resource-application-in-other-files">14.7.5.1. resource – application in other files</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Content_Assist_Cycling">14.7.6. kind – Content Assist Cycling</a></li>
+<li><a href="tests.html#fileValidVerify-validation-status">14.7.7. fileValid – Verify validation status</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Apply_Proposal_And_Execute_Tests">14.8. Apply Proposal And Execute Tests</a></li>
+<li><a href="tests.html#sec:Organize_Imports_Test">14.9. Organize Imports Test</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#organizeimports">14.9.1. organizeImports</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Access_Control_Test">14.10. Access Control Test</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#test-scenarios">14.10.1. Test Scenarios</a></li>
+<li><a href="tests.html#n4js-code-generator">14.10.2. N4JS Code Generator</a></li>
+<li><a href="tests.html#xtext-issue-matcher">14.10.3. Xtext Issue Matcher</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Smoke_Tests">14.11. Smoke Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#how-to-handle-smoke-test-errors">14.11.1. How to handle smoke test errors?</a></li>
+<li><a href="tests.html#smoketester-and-exceptionanalyzer">14.11.2. SmokeTester and ExceptionAnalyzer</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:UI_Tests_with_SWTBot">14.12. UI Tests with SWTBot</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#writing-swtbot-tests">14.12.1. Writing SWTBot Tests</a></li>
+<li><a href="tests.html#running-swtbot-tests">14.12.2. Running SWTBot Tests</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Debugging_UI_Tests">14.13. Debugging UI Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Connecting_to_the_X_server_on_the_build_node">14.13.1. Connecting to the X-server on the build-node</a></li>
+<li><a href="tests.html#sec:Tools_to_investigate_the_java_stack">14.13.2. Tools to investigate the java-stack</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="ui_concepts.html#_ui-concepts">15. UI Concepts</a>
+<ul class="sectlevel2">
+<li><a href="ui_concepts.html#sec:User_Interface_Concepts">15.1. User Interface Concepts</a>
+<ul class="sectlevel3">
+<li><a href="ui_concepts.html#sec:Eclipse_UI_Concepts">15.1.1. Eclipse UI Concepts</a>
+<ul class="sectlevel4">
+<li><a href="ui_concepts.html#sec:Label_Provider">15.1.1.1. Label Provider</a></li>
+<li><a href="ui_concepts.html#sec:Markers">15.1.1.2. Markers</a></li>
+<li><a href="ui_concepts.html#sec:Commands__Toolbar_and_Menus">15.1.1.3. Commands, Toolbar and Menus</a></li>
+<li><a href="ui_concepts.html#sec:Content_Assist">15.1.1.4. Content Assist</a></li>
+<li><a href="ui_concepts.html#sec:Quick_Fixes">15.1.1.5. Quick Fixes</a></li>
+<li><a href="ui_concepts.html#sec:Quick_Assist">15.1.1.6. Quick Assist</a></li>
+<li><a href="ui_concepts.html#sec:Clean_Up_Actions">15.1.1.7. Clean Up Actions</a></li>
+<li><a href="ui_concepts.html#sec:Save_Actions">15.1.1.8. Save Actions</a></li>
+<li><a href="ui_concepts.html#sec:Auto_Edit">15.1.1.9. Auto Edit</a></li>
+<li><a href="ui_concepts.html#sec:Template_Proposals">15.1.1.10. Template Proposals</a></li>
+<li><a href="ui_concepts.html#sec:Outline_View___Quick_Outline">15.1.1.11. Outline View / Quick Outline</a></li>
+<li><a href="ui_concepts.html#sec:Navigator__Package_Explorer__Project_Explorer">15.1.1.12. Navigator, Package Explorer, Project Explorer</a></li>
+<li><a href="ui_concepts.html#sec:Hyperlinking_and_Navigation">15.1.1.13. Hyperlinking and Navigation</a></li>
+<li><a href="ui_concepts.html#sec:Syntax_and_Semantic_Coloring">15.1.1.14. Syntax and Semantic Coloring</a></li>
+<li><a href="ui_concepts.html#sec:Code_Formatter">15.1.1.15. Code Formatter</a></li>
+<li><a href="ui_concepts.html#sec:Wizards">15.1.1.16. Wizards</a></li>
+<li><a href="ui_concepts.html#sec:Cheat_Sheets">15.1.1.17. Cheat Sheets</a></li>
+<li><a href="ui_concepts.html#sec:Context_sensitive_Help">15.1.1.18. Context-sensitive Help</a></li>
+<li><a href="ui_concepts.html#sec:Hovers">15.1.1.19. Hovers</a></li>
+<li><a href="ui_concepts.html#sec:Folding">15.1.1.20. Folding</a></li>
+<li><a href="ui_concepts.html#sec:Customizable_validation___severity">15.1.1.21. Customizable validation / severity</a></li>
+<li><a href="ui_concepts.html#sec:Proposals">15.1.1.22. Proposals</a></li>
+</ul>
+</li>
+<li><a href="ui_concepts.html#sec:Non_Eclipse_UI_Concepts">15.1.2. Non-Eclipse UI Concepts</a>
+<ul class="sectlevel4">
+<li><a href="ui_concepts.html#sec:Overlays">15.1.2.1. Overlays</a></li>
+<li><a href="ui_concepts.html#sec:Goto__Inferred__Type">15.1.2.2. Goto (Inferred) Type</a></li>
+<li><a href="ui_concepts.html#sec:Postfix_Completion">15.1.2.3. Postfix Completion</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="ui_concepts.html#_user-interface-resources">15.2. User Interface Resources</a>
+<ul class="sectlevel3">
+<li><a href="ui_concepts.html#_icons">15.2.1. Icons</a>
+<ul class="sectlevel4">
+<li><a href="ui_concepts.html#_eclipse-platform-icons">15.2.1.1. Eclipse Platform Icons</a></li>
+<li><a href="ui_concepts.html#_n4js-specific-icons">15.2.1.2. N4JS Specific Icons</a></li>
+<li><a href="ui_concepts.html#_high-resolution-icons">15.2.1.3. High Resolution Icons</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="formatting.html#_formatting">16. Formatting</a>
+<ul class="sectlevel2">
+<li><a href="formatting.html#sec:FmtObjective">16.1. Objective</a>
+<ul class="sectlevel3">
+<li><a href="formatting.html#sec:FmtFormatting_Comments">16.1.1. Formatting Comments</a></li>
+</ul>
+</li>
+<li><a href="formatting.html#sec:FmtArchitecture">16.2. Architecture</a>
+<ul class="sectlevel3">
+<li><a href="formatting.html#sec:Implementation_example">16.2.1. Implementation example</a></li>
+</ul>
+</li>
+<li><a href="formatting.html#sec:FmtFormatter_Implementation_Guidelines">16.3. Formatter Implementation Guidelines</a></li>
+<li><a href="formatting.html#sec:FmtConfiguration">16.4. Configuration</a></li>
+<li><a href="formatting.html#sec:FmtUI_Integration">16.5. UI Integration</a></li>
+<li><a href="formatting.html#sec:FmtUnit_Testing_with_Xpect">16.6. Unit Testing with Xpect</a></li>
+</ul>
+</li>
+<li><a href="external_libraries.html#_external-libraries">17. External Libraries</a>
+<ul class="sectlevel2">
+<li><a href="external_libraries.html#sec:Major_Components">17.1. Major Components</a>
+<ul class="sectlevel3">
+<li><a href="external_libraries.html#subsec:External_Resources">17.1.1. External Resources</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Workspace">17.1.2. External Library Workspace</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Preference_Store">17.1.3. External Library Preference Store</a></li>
+<li><a href="external_libraries.html#subsec:npm_Manager">17.1.4. Library Manager</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Builder_Helper">17.1.5. External Library Builder</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Xtext_Index_Persister">17.1.6. External Library Xtext Index Persister</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Preference_Page">17.1.7. External Library Preference Page</a></li>
+</ul>
+</li>
+<li><a href="external_libraries.html#sec:Headless_External_Library_Support">17.2. Headless External Library Support</a>
+<ul class="sectlevel3">
+<li><a href="external_libraries.html#_custom-npm-settings">17.2.1. Custom npm settings</a></li>
+</ul>
+</li>
+<li><a href="external_libraries.html#sec:lmFutureWork">17.3. Future Work</a>
+<ul class="sectlevel3">
+<li><a href="external_libraries.html#subsec:lmMultipleDependencyScope">17.3.1. Multiple Dependency Scope</a></li>
+<li><a href="external_libraries.html#subsec:lmRunTestsFromLibrary">17.3.2. Run Tests from TestLibrary</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="json_support.html#sec:JSON_Support">18. JSON Support</a>
+<ul class="sectlevel2">
+<li><a href="json_support.html#sec:JSON_Parser">18.1. JSON Parser</a>
+<ul class="sectlevel3">
+<li><a href="json_support.html#sec:JSON_Parser_Unicode_Escaping">18.1.1. Escaping Unicode Control Characters in String Literals</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Empty_Text">18.1.2. Empty Text</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Nested_Structures">18.1.3. Nested Structures</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Whitespace">18.1.4. Whitespace</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Comments">18.1.5. Comments</a></li>
+</ul>
+</li>
+<li><a href="json_support.html#sec:JSON_Language_Extensions">18.2. JSON Language Extensions</a>
+<ul class="sectlevel3">
+<li><a href="json_support.html#sec:JSON_Validator_Extensions">18.2.1. JSON Validator Extensions</a>
+<ul class="sectlevel4">
+<li><a href="json_support.html#sec:File_Specitic_Validator_Extensions">18.2.1.1. File-Specific Validator Extensions</a></li>
+<li><a href="json_support.html#sec:JSON_Declarative_JSON_Validator_Extensions">18.2.1.2. Declarative JSON Validator Extensions</a></li>
+</ul>
+</li>
+<li><a href="json_support.html#_json-resource-description-strategy">18.2.2. JSON Resource Description Strategy</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_jsdoc">19. JSDoc</a>
+<ul class="sectlevel2">
+<li><a href="jsdoc.html#sec:Design_Rationale">19.1. Design Rationale</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#_general-design">19.1.1. General Design</a></li>
+<li><a href="jsdoc.html#sec:Type_Expressions">19.1.2. Type Expressions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="docexporter.html#_docexporter">20. DocExporter</a>
+<ul class="sectlevel2">
+<li><a href="docexporter.html#sec:Specification_Exporter">20.1. Specification Exporter</a></li>
+</ul>
+</li>
+<li><a href="rename_refactoring.html#_rename-refactoring">21. Rename Refactoring</a>
+<ul class="sectlevel2">
+<li><a href="rename_refactoring.html#_rename-refactoring-ui-interaction">21.1. Rename Refactoring UI interaction</a></li>
+<li><a href="rename_refactoring.html#_renameelementprocessor-interaction">21.2. RenameElementProcessor interaction</a></li>
+</ul>
+</li>
+<li><a href="flow_graphs.html#chap:flowgraphs">22. Flow Graphs</a>
+<ul class="sectlevel2">
+<li><a href="flow_graphs.html#sec:flowgraphs_overview">22.1. Flow graphs overview</a>
+<ul class="sectlevel3">
+<li><a href="flow_graphs.html#_internal-graph">22.1.1. Internal graph</a></li>
+<li><a href="flow_graphs.html#_optimizations">22.1.2. Optimizations</a></li>
+<li><a href="flow_graphs.html#_api-for-client-analyses">22.1.3. API for client analyses</a>
+<ul class="sectlevel4">
+<li><a href="flow_graphs.html#_mapping-from-internal-to-ast-elements">22.1.3.1. Mapping from internal to AST elements</a></li>
+<li><a href="flow_graphs.html#_graph-visitor">22.1.3.2. Graph visitor</a></li>
+<li><a href="flow_graphs.html#_graph-explorer">22.1.3.3. Graph explorer</a></li>
+<li><a href="flow_graphs.html#_branch-walker">22.1.3.4. Branch walker</a></li>
+<li><a href="flow_graphs.html#_example-1-compute-string-for-each-path">22.1.3.5. Example 1: Compute string for each path</a></li>
+<li><a href="flow_graphs.html#_path-quantor">22.1.3.6. Path quantor</a></li>
+</ul>
+</li>
+<li><a href="flow_graphs.html#_control-flow-analyses">22.1.4. Control flow analyses</a>
+<ul class="sectlevel4">
+<li><a href="flow_graphs.html#_dead-code-analysis">22.1.4.1. Dead code analysis</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="flow_graphs.html#sec:dataflow">22.2. Dataflow</a>
+<ul class="sectlevel3">
+<li><a href="flow_graphs.html#_dataflow-graph">22.2.1. Dataflow graph</a></li>
+<li><a href="flow_graphs.html#_dataflow-analyses">22.2.2. Dataflow analyses</a>
+<ul class="sectlevel4">
+<li><a href="flow_graphs.html#_def-def-def-nothing-analysis">22.2.2.1. Def&#8594;Def / Def&#8594;Nothing analysis</a></li>
+<li><a href="flow_graphs.html#_def-use-decl-analysis">22.2.2.2. Def|Use&#8592;Decl analysis</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#sec:publish-npms-to-public">23. Publish npms</a>
+<ul class="sectlevel2">
+<li><a href="#sec:publish-npms-n4js-maven">23.1. Publish n4js-libs to during  maven build</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Hints">Appendix A: Hints</a>
+<ul class="sectlevel2">
+<li><a href="appendix_a_hints.html#sec:XtextInjection">A.1. Xtext Injection</a>
+<ul class="sectlevel3">
+<li><a href="appendix_a_hints.html#sec:DI_MultipleInjectors_Singletons">A.1.1. Multiple Injectors and Singletons</a>
+<ul class="sectlevel4">
+<li><a href="appendix_a_hints.html#sec:DI_avoid_duplicate_singletons">A.1.1.1. Avoiding duplicate singletons</a>
+<ul class="sectlevel5">
+<li><a href="appendix_a_hints.html#sec:DI_binding_in_shared">A.1.1.1.1. Defining binding in the shared injector</a></li>
+<li><a href="appendix_a_hints.html#sec:DI_binding_in_custom">A.1.1.1.2. Defining binding in the custom injector</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:DI_Hints">A.1.2. Dependency Injection Hints</a>
+<ul class="sectlevel4">
+<li><a href="appendix_a_hints.html#sec:DI_custom_bundle">A.1.2.1. Use DI in custom bundle, use DI with extensions</a>
+<ul class="sectlevel5">
+<li><a href="appendix_a_hints.html#sec:DI_custom_bundle_problem">A.1.2.1.1. Problem</a></li>
+<li><a href="appendix_a_hints.html#sec:DI_custom_bundle_solution">A.1.2.1.2. Solution</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Access_Other_DSL_Injector">A.1.2.2. How do I get the Guice Injector of my language?</a>
+<ul class="sectlevel5">
+<li><a href="appendix_a_hints.html#sec:DSL_Injector_UI_context">A.1.2.2.1. UI context</a></li>
+<li><a href="appendix_a_hints.html#sec:DSL_Injector_Non_UI_context">A.1.2.2.2. Non UI context but with injection context</a></li>
+<li><a href="appendix_a_hints.html#sec:DSL_Injector_Non_UI_non_injection_context">A.1.2.2.3. Non UI context without injection context</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Cancel_Indicator">A.1.2.3. How do I get cancel indicators in different contexts?</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Eclipse">A.2. Eclipse</a>
+<ul class="sectlevel3">
+<li><a href="appendix_a_hints.html#sec:Show_Xtext_Index">A.2.1. Show the current Xtext index</a></li>
+<li><a href="appendix_a_hints.html#sec:Plugin_spy">A.2.2. Plug-in spy</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Maven-hints">A.3. Maven</a>
+<ul class="sectlevel3">
+<li><a href="appendix_a_hints.html#how-to-check-for-maven-mojo-updates">A.3.1. How to check for Maven MOJO updates</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#_module-loading">Appendix B: Module Loading</a>
+<ul class="sectlevel2">
+<li><a href="appendix_b_module_loading.html#sec:Dependency_Management">B.1. Dependency Management</a></li>
+<li><a href="appendix_b_module_loading.html#ecmascript-modules">B.2. ECMAScript Modules</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:ES5_Modules_Systems">B.2.1. ES5 Modules Systems</a></li>
+<li><a href="appendix_b_module_loading.html#sec:ES6_Modules">B.2.2. ES6 Modules</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:ECMAScript_Module_Loaders">B.3. ECMAScript Module Loaders</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:ES6_Module_Loaders">B.3.1. ES6 Module Loaders</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Polyfills_for_ES6_Module_Loaders">B.3.2. Polyfills for ES6 Module Loaders</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:es6_module_loader">B.3.2.1. es6-module-loader</a></li>
+<li><a href="appendix_b_module_loading.html#sec:SystemJS">B.3.2.2. SystemJS</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Demo">B.3.2.3. Demo</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#case-study-typescript">B.4. Case Study : TypeScript</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:ES6_Modules_Support">B.4.1. ES6 Modules Support</a></li>
+<li><a href="appendix_b_module_loading.html#sec:TypeScript_and_Module_Loading">B.4.2. TypeScript and Module Loading</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Cyclic_Dependencies">B.5. Cyclic Dependencies</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:Setup">B.5.1. Setup</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Transpile_and_Execute">B.5.2. Transpile and Execute</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Module_Format___AMD">B.5.2.1. Module Format = AMD</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Module_Format___CommonJS">B.5.2.2. Module Format = CommonJS</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Module_Format___SystemJS">B.5.2.3. Module Format = SystemJS</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Conclusion">B.5.3. Conclusion</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#system.register-as-transpilation-target">B.6. System.register as transpilation target</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:Introduction">B.6.1. Introduction</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:External_Transpilers">B.6.1.1. External Transpilers</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Example_of_a_System_register_module">B.6.1.2. Example of a System.register module</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Structure_of_a_System_register_module">B.6.2. Structure of a System.register module</a></li>
+<li><a href="appendix_b_module_loading.html#_transpilation-hints">B.6.3. Transpilation Hints</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Handling_Imports">B.6.3.1. Handling Imports</a></li>
+<li><a href="appendix_b_module_loading.html#sec:__exportFn__">B.6.3.2. &lt;&lt;exportFn&gt;&gt;</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Handling_Exports">B.6.3.3. Handling Exports</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Examples_w__Circular_Dependencies">B.6.4. Examples w/ Circular Dependencies</a></li>
+<li><a href="appendix_b_module_loading.html#sec:N4JS_Examples_w__Circular_Dependencies">B.6.5. N4JS Examples w/ Circular Dependencies</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Unresolved_Cyclic_Dependencies">B.6.5.1. Unresolved Cyclic Dependencies</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Variables___Functions">B.6.5.2. Examples with Variables &amp; Functions</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Classes">B.6.5.3. Examples with Classes</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Examples_with_SubClassing">B.6.5.4. Examples with SubClassing</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Miscellaneous">B.6.5.5. Miscellaneous</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#_resources">B.6.6. Resources</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:CommonJS_as_transpilation_target">B.7. CommonJS as transpilation target</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#_introduction-2">B.7.1. Introduction</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Transpilation_Hints">B.7.2. Transpilation Hints</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Import_Statements">B.7.2.1. Import Statements</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Export_Statements">B.7.2.2. Export Statements</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Tracking_Live_Bindings">B.7.2.3. Tracking Live Bindings</a></li>
+<li><a href="appendix_b_module_loading.html#sec:A_complete_example">B.7.2.4. A complete example</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#_resources-2">B.7.3. Resources</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_c_license.html#sec:License">Appendix C: License</a></li>
+<li><a href="appendix_d_acronyms.html#sec:Acronyms">Appendix D: Acronyms</a></li>
+<li><a href="appendix_e_bibliography_and_footnotes.html#_bibliography-and-footnotes">Appendix E: Bibliography and Footnotes</a></li>
+</ul>
+</div>
+</div>
+<div id="content"><div class="sect1">
+<h2 id="sec:publish-npms-to-public"><a class="anchor" href="#sec:publish-npms-to-public"></a><a class="link" href="#sec:publish-npms-to-public">23. Publish npms</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>We publish npms located in the folder <code>n4js-libs</code> to the <a href="registry.npmjs.org">public npm registry</a>. Specifically, the following npms are published:</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Command line tools</dt>
+<dd>
+<div class="ulist">
+<ul>
+<li>
+<p>n4js-cli</p>
+</li>
+<li>
+<p>n4js-mangelhaft-cli</p>
+</li>
+</ul>
+</div>
+</dd>
+<dt class="hdlist1">Runtime definition files</dt>
+<dd>
+<div class="ulist">
+<ul>
+<li>
+<p>n4js-runtime-ecma402</p>
+</li>
+<li>
+<p>n4js-runtime-es2015</p>
+</li>
+<li>
+<p>n4js-runtime-esnext</p>
+</li>
+<li>
+<p>n4js-runtime-fetch</p>
+</li>
+<li>
+<p>n4js-runtime-html5</p>
+</li>
+<li>
+<p>n4js-runtime-node</p>
+</li>
+<li>
+<p>n4js-runtime-v8</p>
+</li>
+</ul>
+</div>
+</dd>
+<dt class="hdlist1">Mangelhaft</dt>
+<dd>
+<div class="ulist">
+<ul>
+<li>
+<p>org.eclipse.n4js.mangelhaft</p>
+</li>
+<li>
+<p>org.eclipse.n4js.mangelhaft.assert</p>
+</li>
+<li>
+<p>org.eclipse.n4js.mangelhaft.reporter.console</p>
+</li>
+<li>
+<p>org.eclipse.n4js.mangelhaft.reporter.ide</p>
+</li>
+<li>
+<p>org.eclipse.n4js.mangelhaft.reporter.xunit</p>
+</li>
+<li>
+<p>org.eclipse.n4js.mangelhaft.runner.ide</p>
+</li>
+</ul>
+</div>
+</dd>
+</dl>
+</div>
+<div class="paragraph">
+<p>In order to make sure that the npms work correctly with the <code>n4js</code> product, we need to integration test the interplay between the n4js products and the npms. Right now, we only focus on the interplay between the <code>n4js</code> headless compiler and npms. For integration tests, we publish the npms to a local npm registry which is provided by <a href="https://www.verdaccio.org/docs/en/docker.html">verdaccio docker image</a> before executing the tests. When all integration tests are executed, we stop the local npm registry.</p>
+</div>
+<div class="sect2">
+<h3 id="sec:publish-npms-n4js-maven"><a class="anchor" href="#sec:publish-npms-n4js-maven"></a><a class="link" href="#sec:publish-npms-n4js-maven">23.1. Publish n4js-libs to during  maven build</a></h3>
+<div class="admonitionblock warning">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-warning" title=""></i>
+</td>
+<td class="content">
+The NPMs are currently published using NumberFour&#8217;s internal build infrastructure in combination with extended integration tests. This needs to be changed in the future!
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>This section describes how integration tests can use local npm registry during the test.
+All integration tests that require a local npm registry should be placed in the bundle <code>org.eclipse.n4js.hlc.integrationtests</code></p>
+</div>
+<div class="imageblock center">
+<div class="content">
+<img src="chapters/40_publish_npms/images/publish_npm_in_mvn_workflow.svg" alt="publish npm in mvn workflow">
+</div>
+<div class="title">Figure 61. Maven phases</div>
+</div>
+<div class="paragraph">
+<p>During the maven build, three projects <code>org.eclipse.n4js.external.libraries.update</code>, <code>org.eclipse.n4js.product.build</code> and <code>org.eclipse.n4js.hlc.integrations</code> are built by maven in that order.</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>During the phase <em>process-classes</em> of the <code>org.eclipse.n4js.external.libraries.update</code> build, the UpdateShippedCode MWE2 workflow is triggerd to compile n4js code of npms in n4js-lib. The phase <em>process-classes</em> was chosen because it must happen after the <code>org.eclipse.n4js.external.libraries.update</code> bundle has been compiled.</p>
+</li>
+<li>
+<p>During the <em>verify</em> phase of the <code>org.eclipse.n4js.product.build</code> build, the Maven <code>exec-maven</code> plugin calls the script <code>n4js/releng/utils/scripts/publish-n4js-libs.sh</code> to publish the npms in the n4js-lib to the <em>staging npm registry</em>. The URL of this staging npm registry must be configured before triggering maven build via the environment variable <code>NPM_STAGING_REGISTRY</code>. Note that the staging npm registry lives beyond the life of <code>n4js-inhouse</code> 's maven build and holds npms that are needed by the integration tests in the n4js-extended&#8217;s build.</p>
+</li>
+<li>
+<p>During the <em>pre-integration-test</em> phase of the <code>org.eclipse.n4js.hlc.integrationtests</code> bundle, the Maven <code>antrun</code> plugin starts a <em>verdaccio</em> docker container local npm registry at <code><a href="http://localhost:4873" class="bare">http://localhost:4873</a></code> via docker. Also in the very same phase, the Maven plugin <code>exec-maven</code> calls the script <code>n4js/releng/utils/scripts/publish-n4js-libs.sh</code> to publish the npms in the n4js-lib folder to the local registry <code><a href="http://localhost:4873" class="bare">http://localhost:4873</a></code>. The list of published npms is identical to that list above. Note that the npms are published with the <code>dist-tag</code> <em>test</em>.</p>
+</li>
+<li>
+<p>During the <em>integration-test</em> phase of <code>org.eclipse.n4js.hlc.integrationtests</code>, the Maven <code>failsafe</code> plugin executes the integration tests. Here, the integration tests can pull the required npms from the local registry populated during the <em>pre-integration-test</em> above.</p>
+</li>
+<li>
+<p>In the <em>pre-integration-test</em> phase of <code>org.eclipse.n4js.hlc.integrationtests</code>, the Maven <code>antrun</code> plugins removes the  <em>verdaccio</em> docker container.</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div id="footer">
+<div id="footer-text">
+Version 0.9<br>
+Last updated 2019-08-07 15:02:40 CEST
+</div>
+</div>
+<!-- ************* docinfo-footer *************************************************************** -->
+<div class="Grid social" style="color:#d5dfea">
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <h2>Quick Links</h2>
+    <ul>
+      <li><a href="../downloads.html">Download</a></li>
+      <li><a href="../userguides/index.html">Documentation</a></li>
+      <li><a href="https://github.com/eclipse/n4js/">Source</a></li>
+      <li><a href="https://github.com/eclipse/n4js/issues">Issues</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="https://www.eclipse.org/forums/index.php/f/365/">Forum</a></li>
+      <li><a href="http://n4js.blogspot.de/">Blog</a></li>
+      <li><a href="https://dev.eclipse.org/mailman/listinfo/n4js-dev">Mailing List</a></li>
+      <li><a href="https://projects.eclipse.org/projects/technology.n4js">Eclipse Project Page</a></li>
+      <li><a href="https://twitter.com/n4jsdev">Tweets by n4jsdev</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="http://www.eclipse.org/">Eclipse Home</a></li>
+      <li><a href="http://www.eclipse.org/legal/privacy.php">Privacy Policy</a></li>
+      <li><a href="http://www.eclipse.org/legal/termsofuse.php">Terms of Use</a></li>
+      <li><a href="http://www.eclipse.org/legal/copyright.php">Copyright Agent</a></li>
+      <li><a href="http://www.eclipse.org/legal/">Legal</a></li>
+    </ul>
+  </div>
+  <div style="clear: both; height: 0; overflow: hidden;"></div>
+</div>
+
+<!-- ************* UI Scripts ************* -->
+<script type="text/javascript" src="scripts/back-to-top.js"></script>
+
+<script type="text/javascript" src="scripts/treeview.js"></script>
+<script type="text/javascript" src="scripts/toc.js"></script>
+
+<!-- ************* Prism.js Syntax Highlighting ************* -->
+<script src="scripts/prism.js"></script>
+
+<script type="text/javascript">
+	// Add the 'toclist' id for search function
+	$(".toc2 > ul").attr('id', 'toclist');
+	// Generate a Search input form
+	$("#toclist > li:first-of-type").before('<input type="text" id="pagesearch" onkeyup="search()" placeholder="Search for section...">');
+	$("#toclist > li:first-of-type").before('<i id="clear" class="fa fa-times-circle-o"></i>');
+	$("#clear").click(function(){
+	    $("#pagesearch").val('');
+	    search();
+	    $('.toc2 > ul').treeView('collapseAll');
+	});
+	// intialize Treeview.js
+	$(".toc2 > ul").treeView();
+	// Initialize Scrollspy
+</script>
+<!-- ************* docinfo-footer *************************************************************** -->
+</body>
+</html>
\ No newline at end of file
diff --git a/design/references.html b/design/references.html
new file mode 100644
index 0000000..c55f583
--- /dev/null
+++ b/design/references.html
@@ -0,0 +1,1541 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="generator" content="Asciidoctor 1.5.5">
+<meta name="author" content="2019-08-07 15:02:40 CEST">
+<title>N4JS Design Specification</title>
+<link rel="stylesheet" href="styles/spec.min.css">
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.6.3/css/font-awesome.min.css">
+<!-- ************* docinfo ******************************************************************* -->
+
+
+<!-- ************* Favicon ************-->
+<link rel="icon" href="images/favicon.ico" />
+
+<!-- ************* Back-to-top JQuery ************* -->
+<script src="https://code.jquery.com/jquery-1.12.4.js"></script>
+<script src="https://code.jquery.com/ui/1.12.0/jquery-ui.js"></script>
+
+
+<link href="styles/prism.min.css" rel="stylesheet" />
+<script type="text/javascript" async
+  src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2/MathJax.js?config=TeX-MML-AM_CHTML">
+</script>
+
+<!-- ************* Styles ************* -->
+<link rel="stylesheet" type="text/css" href="styles/n4jsspec-adoc.css">
+
+
+<!-- ****************** NavBar ****************** -->
+<div id="menubar">
+	<div class="banner">
+        <a href="https://www.eclipse.org/n4js/#"><img id="logo" src="images/n4js-logo.png" alt="Eclipse N4JS"></a>
+    </div>
+<ul>
+  <li><a href="index.html">Index</a></li>
+</ul>
+</div>
+<!-- ************* docinfo ******************************************************************* -->
+<style>
+      .admonitionblock td.icon .icon-todo:before{content:"\f249";color:#f4ee42}
+    </style>
+</head>
+<body class="book toc2 toc-left">
+<div id="header">
+<h1>N4JS Design Specification</h1>
+<div class="details">
+<span id="author" class="author">2019-08-07 15:02:40 CEST</span><br>
+<span id="revnumber">version 0.9</span>
+</div>
+<div id="toc" class="toc2">
+<div id="toctitle">Table of Contents</div>
+<ul class="sectlevel1">
+<li><a href="introduction.html#_introduction">1. Introduction</a>
+<ul class="sectlevel2">
+<li><a href="introduction.html#notation">1.1. Notation</a></li>
+<li><a href="introduction.html#sec:IDE_Overview">1.2. IDE Components</a>
+<ul class="sectlevel3">
+<li><a href="introduction.html#sec:Naming_Conventions">1.2.1. Naming Conventions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="eclipse_setup.html#_eclipse-setup">2. Eclipse Setup</a>
+<ul class="sectlevel2">
+<li><a href="eclipse_setup.html#_system-requirements">2.1. System Requirements</a></li>
+<li><a href="eclipse_setup.html#_contribute">2.2. Contribute</a>
+<ul class="sectlevel3">
+<li><a href="eclipse_setup.html#_eclipse-installer">2.2.1. Eclipse Installer</a>
+<ul class="sectlevel4">
+<li><a href="eclipse_setup.html#_changing-the-setup-script">2.2.1.1. Changing the Setup Script</a></li>
+</ul>
+</li>
+<li><a href="eclipse_setup.html#_manual-ide-configuration">2.2.2. Manual IDE Configuration</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="release_engineering.html#_release-engineering">3. Release Engineering</a>
+<ul class="sectlevel2">
+<li><a href="release_engineering.html#_nightly-build-on-eclipse-infrastructure">3.1. Nightly build on Eclipse infrastructure</a></li>
+<li><a href="release_engineering.html#_build-the-n4js-ide-from-command-line">3.2. Build the N4JS IDE from command line</a>
+<ul class="sectlevel3">
+<li><a href="release_engineering.html#_publish-maven-tooling-code-org-eclipse-n4js-releng-util-code">3.2.1. Publish maven-tooling <code>org.eclipse.n4js.releng.util</code></a></li>
+<li><a href="release_engineering.html#sec:test-verdaccio">3.2.2. Test Verdaccio containing n4js-libs</a></li>
+<li><a href="release_engineering.html#_generation-of-eclipse-help-for-spec-and-design-document">3.2.3. Generation of Eclipse help for spec and design document</a></li>
+</ul>
+</li>
+<li><a href="release_engineering.html#_updating-frameworks-and-dependencies">3.3. Updating frameworks and dependencies</a>
+<ul class="sectlevel3">
+<li><a href="release_engineering.html#_update-of-eclipse-emf-xtext-etc">3.3.1. Update of Eclipse, EMF, Xtext, etc.</a></li>
+<li><a href="release_engineering.html#_update-of-the-embedded-jre">3.3.2. Update of the embedded JRE</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tips_and_tricks.html#_tips-and-tricks">4. Tips and Tricks</a>
+<ul class="sectlevel2">
+<li><a href="tips_and_tricks.html#_naming">4.1. Naming</a></li>
+<li><a href="tips_and_tricks.html#_logging">4.2. Logging</a></li>
+<li><a href="tips_and_tricks.html#_cancellation-handling">4.3. Cancellation Handling</a></li>
+<li><a href="tips_and_tricks.html#_caching">4.4. Caching</a></li>
+<li><a href="tips_and_tricks.html#_dependency-injection">4.5. Dependency Injection</a></li>
+<li><a href="tips_and_tricks.html#_miscellaneous">4.6. Miscellaneous</a></li>
+</ul>
+</li>
+<li><a href="parser.html#_parser">5. Parser</a>
+<ul class="sectlevel2">
+<li><a href="parser.html#sec:Parser_Overview">5.1. Overview</a></li>
+<li><a href="parser.html#sec:N4JS_Parser">5.2. N4JS Parser</a></li>
+<li><a href="parser.html#sec:Parser_Generation_Post_Processing">5.3. Parser Generation Post-Processing</a>
+<ul class="sectlevel3">
+<li><a href="parser.html#sec:Automatic_Semicolon_Insertion">5.3.1. Automatic Semicolon Insertion</a>
+<ul class="sectlevel4">
+<li><a href="parser.html#sec:Injected_code_in_the_Antlr_grammar_file">5.3.1.1. Injected code in the Antlr grammar file</a></li>
+<li><a href="parser.html#sec:Customized_error_recovery">5.3.1.2. Customized error recovery</a></li>
+</ul>
+</li>
+<li><a href="parser.html#sec:_No_line_terminator_allowed_here__handling">5.3.2. Async and <code>No line terminator allowed here</code> Handling</a></li>
+<li><a href="parser.html#sec:Regular_Expression">5.3.3. Regular Expression</a></li>
+<li><a href="parser.html#sec:Unicode">5.3.4. Unicode</a></li>
+<li><a href="parser.html#sec:Literals">5.3.5. Literals</a></li>
+</ul>
+</li>
+<li><a href="parser.html#sec:Modifiers">5.4. Modifiers</a></li>
+<li><a href="parser.html#sec:Conflict_Resolutions">5.5. Conflict Resolutions</a>
+<ul class="sectlevel3">
+<li><a href="parser.html#sec:Reserved_Keywords_vs__Identifier_Names">5.5.1. Reserved Keywords vs. Identifier Names</a></li>
+<li><a href="parser.html#sec:Operators_and_Generics">5.5.2. Operators and Generics</a></li>
+</ul>
+</li>
+<li><a href="parser.html#sec:Content_Assist_Parser">5.6. Content-Assist Parser</a></li>
+</ul>
+</li>
+<li><a href="type_system.html#_type-system">6. Type System</a>
+<ul class="sectlevel2">
+<li><a href="type_system.html#sec:Type_Model_and_Grammar">6.1. Type Model and Grammar</a>
+<ul class="sectlevel3">
+<li><a href="type_system.html#sec:Type_Model_Overview">6.1.1. Type Model Overview</a></li>
+<li><a href="type_system.html#sec:Built_in_Types">6.1.2. Built-in and Primitive Types</a></li>
+<li><a href="type_system.html#sec:Type_Model_DSL">6.1.3. Type Model DSL</a></li>
+</ul>
+</li>
+<li><a href="type_system.html#sec:Type_System_Implementation">6.2. Type System Implementation</a></li>
+<li><a href="type_system.html#sec:Type_Inference_combined_with_AST_Traversal">6.3. Type Inference of AST</a>
+<ul class="sectlevel3">
+<li><a href="type_system.html#sec:Type_Inference_combined_with_AST_Traversal__Background">6.3.1. Background</a></li>
+<li><a href="type_system.html#sec:Triggering_Type_Inference_of_AST">6.3.2. Triggering</a></li>
+<li><a href="type_system.html#sec:Traversal_Order_During_Type_Inference_of_AST">6.3.3. Traversal Order</a></li>
+<li><a href="type_system.html#sec:Cross_References_During_Type_Inference_of_AST">6.3.4. Cross-References</a></li>
+<li><a href="type_system.html#sec:Function_Accessor_Bodies_During_Type_Inference_of_AST">6.3.5. Function/Accessor Bodies</a></li>
+<li><a href="type_system.html#sec:Poly_Expressions_During_Type_Inference_of_AST">6.3.6. Poly Expressions</a></li>
+<li><a href="type_system.html#sec:Constraint_Solver_used_During_Type_Inference_of_AST">6.3.7. Constraint Solver</a></li>
+<li><a href="type_system.html#sec:Type_Guards_During_Type_Inference_of_AST">6.3.8. Type Guards</a></li>
+</ul>
+</li>
+<li><a href="type_system.html#sec:Structural_Typing">6.4. Structural Typing</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#_type-index">7. Type Index</a>
+<ul class="sectlevel2">
+<li><a href="type_index.html#sec:Type_Index_Design_Rationale">7.1. Design Rationale</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#sec:Getting_the_Xtext_Index_Content_IResourceDescriptions">7.1.1. Getting the Xtext Index (<code>IResourceDescriptions</code>) Content</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#sec:Design_Overview">7.2. Design Overview</a></li>
+<li><a href="type_index.html#sec:N4JS_Resource_Load_States">7.3. N4JS Resource Load States</a></li>
+<li><a href="type_index.html#sec:Type_Builder">7.4. Types Builder</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#sec:Type_Inference_not_allowed_in_Type_Builder">7.4.1. Type Inference not allowed in Types Builder</a></li>
+<li><a href="type_index.html#sec:ComputedTypeReferences">7.4.2. Deferred Type References</a></li>
+<li><a href="type_index.html#sec:Use_cases_of_ComputedTypeRef">7.4.3. Use cases of DeferredTypeRef</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#sec:Incremental_Builder_Overview">7.5. Incremental Builder (Overview)</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#sec:Incremental_Builder_Overview__XtextBuilder">7.5.1. XtextBuilder</a></li>
+<li><a href="type_index.html#sec:Incremental_Builder_Overview__IBuilderState">7.5.2. IBuilderState</a>
+<ul class="sectlevel4">
+<li><a href="type_index.html#copy-and-update-xtext-index">7.5.2.1. Copy and Update Xtext Index</a></li>
+<li><a href="type_index.html#build-state-setup-phase">7.5.2.2. Build State Setup Phase</a></li>
+<li><a href="type_index.html#process-queued-uris">7.5.2.3. Process Queued URIs</a></li>
+<li><a href="type_index.html#queueing-affected-resources">7.5.2.4. Queueing Affected Resources</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#sec:Incremental_Builder_Overview__Example">7.5.3. Example</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#dirty-state-handling">7.6. Dirty state handling</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#use-case-restoring-types-from-user-data">7.6.1. Use case: Restoring types from user data</a></li>
+<li><a href="type_index.html#use-case-updating-the-xtext-index">7.6.2. Use case: Updating the Xtext index</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="project_model.html#_project-model">8. Project Model</a>
+<ul class="sectlevel2">
+<li><a href="project_model.html#sec:Package_json">8.1. Package.json File</a></li>
+<li><a href="project_model.html#_accessing-project-information">8.2. Accessing Project Information</a>
+<ul class="sectlevel3">
+<li><a href="project_model.html#sec:IN4JSCore">8.2.1. IN4JSCore</a></li>
+<li><a href="project_model.html#sec:N4JSModel">8.2.2. N4JSModel</a></li>
+<li><a href="project_model.html#sec:N4JSWorkspace">8.2.3. N4JSWorkspace</a></li>
+<li><a href="project_model.html#sec:N4JSProject">8.2.4. N4JSProject</a></li>
+<li><a href="project_model.html#sec:SourceContainer">8.2.5. SourceContainer</a></li>
+<li><a href="project_model.html#sec:N4JSProjectsStateHelper">8.2.6. N4JSProjectsStateHelper</a></li>
+</ul>
+</li>
+<li><a href="project_model.html#sec:Caching">8.3. Caching</a>
+<ul class="sectlevel3">
+<li><a href="project_model.html#_caching-of-externallibraryworkspace">8.3.1. Caching of ExternalLibraryWorkspace</a></li>
+<li><a href="project_model.html#_caching-of-n4jsprojectsstatehelper">8.3.2. Caching of N4JSProjectsStateHelper</a></li>
+</ul>
+</li>
+<li><a href="project_model.html#sec:WildcardPathFilter">8.4. WildcardPathFilter</a></li>
+<li><a href="project_model.html#sec:ProjectUtils">8.5. ProjectUtils</a></li>
+</ul>
+</li>
+<li><a href="binding.html#_binding">9. Binding</a>
+<ul class="sectlevel2">
+<li><a href="binding.html#sec:Binding_Design_Rationale">9.1. Design Rationale</a></li>
+<li><a href="binding.html#sec:Binding_to_Members">9.2. Binding to Members</a></li>
+<li><a href="binding.html#sec:Binding_Getter_Setter">9.3. Getter / Setter Binding</a></li>
+<li><a href="binding.html#chap:Statics">9.4. Static Member Binding</a></li>
+<li><a href="binding.html#sec:Binding_Enumeration">9.5. Enumeration Literals Binding</a></li>
+<li><a href="binding.html#sec:Accessibility_of_types_and_members">9.6. Accessibility of types and members</a></li>
+<li><a href="binding.html#sec:Member_Scope_Example">9.7. Member Scope Example</a></li>
+<li><a href="binding.html#sec:Scoping_for_Members_of_Composed_Type_Explained">9.8. Scoping for Members of Composed Type (Union/Intersection) Example</a></li>
+<li><a href="binding.html#sec:Binding_of_Structurally_References_Types">9.9. Structurally References Types</a></li>
+<li><a href="binding.html#sec:Building">9.10. Building</a>
+<ul class="sectlevel3">
+<li><a href="binding.html#sec:Build_Phases">9.10.1. Build Phases</a></li>
+<li><a href="binding.html#sec:Build_Scenarios">9.10.2. Build Scenarios</a></li>
+<li><a href="binding.html#sec:Lazy_linking_problem">9.10.3. Lazy linking problem</a></li>
+</ul>
+</li>
+<li><a href="binding.html#sec:Proxies_and_Proxy_Resolution">9.11. Proxies and Proxy Resolution (Overview)</a>
+<ul class="sectlevel3">
+<li><a href="binding.html#xtexts-lazy-linking-proxies">9.11.1. Xtext’s Lazy Linking Proxies</a></li>
+<li><a href="binding.html#standard-emf-proxies">9.11.2. Standard EMF Proxies</a></li>
+<li><a href="binding.html#_how-is-proxy-resolution-triggered">9.11.3. How is Proxy Resolution Triggered?</a></li>
+<li><a href="binding.html#_when-is-proxy-resolution-allowed">9.11.4. When is Proxy Resolution Allowed?</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="validation.html#_validation">10. Validation</a>
+<ul class="sectlevel2">
+<li><a href="validation.html#sec:validation_overview">10.1. Validation overview</a></li>
+<li><a href="validation.html#sec:validation_control_flow">10.2. Validation control flow</a></li>
+<li><a href="validation.html#sec:validation_issue_ids">10.3. Issue IDs and Messages</a></li>
+<li><a href="validation.html#sec:validation_usage_patterns">10.4. Usage Pattern</a></li>
+<li><a href="validation.html#sec:validation_links">10.5. Links</a></li>
+</ul>
+</li>
+<li><a href="#_references">11. References</a>
+<ul class="sectlevel2">
+<li><a href="#sec:usecases">11.1. Use cases</a></li>
+<li><a href="#sec:calculation_algorithm">11.2. Calculation algorithm</a>
+<ul class="sectlevel3">
+<li><a href="#sec:Xtext_default_implementation">11.2.1. Xtext default implementation</a></li>
+<li><a href="#sec:N4_implementation">11.2.2. N4JS implementation</a></li>
+</ul>
+</li>
+<li><a href="#sec:PerformanceOfDependencyCalculation">11.3. Performance Of Dependency Calculation</a></li>
+<li><a href="#sec:kinds_of_references">11.4. Kinds of references</a>
+<ul class="sectlevel3">
+<li><a href="#sec:Cross_References_to_be_ignored">11.4.1. Cross References to be ignored</a></li>
+<li><a href="#sec:Cross_References_to_be_handled">11.4.2. Cross References to be handled</a></li>
+</ul>
+</li>
+<li><a href="#sec:transitive_dependencies">11.5. Transitive dependencies</a></li>
+<li><a href="#sec:find-references">11.6. Find references</a>
+<ul class="sectlevel3">
+<li><a href="#_background">11.6.1. Background</a></li>
+<li><a href="#_how-find-references-work">11.6.2. How Find References Work</a>
+<ul class="sectlevel4">
+<li><a href="#_step-1-convert-cursor-position-to-declared-element">11.6.2.1. Step 1: Convert Cursor Position to Declared Element</a></li>
+<li><a href="#_step-2-convert-declared-element-to-target-uris">11.6.2.2. Step 2: Convert Declared Element to Target URIs</a></li>
+<li><a href="#_step-3-filter-potential-resources">11.6.2.3. Step 3: Filter Potential Resources</a></li>
+<li><a href="#_step-4-search-references-in-resource">11.6.2.4. Step 4: Search References in Resource</a></li>
+<li><a href="#_limitations-and-possible-enhancements">11.6.2.5. Limitations and Possible Enhancements</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="compilation.html#_compilation">12. Compilation</a>
+<ul class="sectlevel2">
+<li><a href="compilation.html#chap:compilation">12.1. Introduction</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:general_design_rationals">12.1.1. General design rationals</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:logging_and_error_reporting">12.1.1.1. Logging and error reporting</a></li>
+<li><a href="compilation.html#sec:progress_monitor">12.1.1.2. Progress monitor</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Xtext_Integration">12.1.2. Xtext Integration</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:xtext_default_behaviour">12.1.2.1. Xtext default behaviour</a></li>
+<li><a href="compilation.html#sec:n4js_requirements">12.1.2.2. N4JS requirements</a></li>
+<li><a href="compilation.html#sec:compiler_discovery_in_ui">12.1.2.3. Compiler discovery in UI</a></li>
+<li><a href="compilation.html#sec:compiler_discovery_in_headless">12.1.2.4. Compiler discovery in headless</a></li>
+<li><a href="compilation.html#sec:general_generator_implementation">12.1.2.5. General generator implementation</a></li>
+<li><a href="compilation.html#sec:general_generator_activation">12.1.2.6. General generator activation</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Overview_of_Input_Models">12.1.3. Overview of the Input Models</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Core_Generator">12.2. Generators</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:Compiler_Components">12.2.1. Generator Components</a></li>
+<li><a href="compilation.html#sec:Generator_architecture">12.2.2. Generator architecture</a></li>
+<li><a href="compilation.html#sec:Unified_Compiler_Configuration">12.2.3. Unified Compiler Configuration</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Transpilers">12.3. Transpilers</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:Phases">12.3.1. Overview</a></li>
+<li><a href="compilation.html#relation-between-ast-and-im">12.3.2. Relation between AST and IM</a></li>
+<li><a href="compilation.html#implementation-overview">12.3.3. Implementation Overview</a></li>
+<li><a href="compilation.html#sec:Guidelines_for_Implementing_Transformations">12.3.4. Guidelines for Implementing Transformations</a></li>
+<li><a href="compilation.html#symbol-table-in-the-im">12.3.5. Symbol Table in the IM</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:N4JS_to_EcmaScript_Transpiler">12.4. N4JS-to-EcmaScript Transpiler</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:Overview_of_Transformations">12.4.1. Overview of Transformations</a></li>
+<li><a href="compilation.html#sec:Transpiling_members">12.4.2. Transpiling members</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:Transpiling_members__Delegating_members">12.4.2.1. Techniques for special member handling</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__Partial_shadowing_of_getter_setter_pairs">12.4.2.2. Partial shadowing</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__Consuming_or_inheriting_members_of_an_interface">12.4.2.3. Consuming or inheriting members of an interface</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__Static_polyfill">12.4.2.4. Static polyfill</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__API_implementation_stubs">12.4.2.5. API / implementation stubs</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Support_for_incomplete_API_implementation_testing_in_the_N4JS_to_EcmaScript_5_Transpiler">12.4.3. Support for incomplete API implementation testing</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:Modifications_in_Impl_projects">12.4.3.1. Modifications in Impl projects</a></li>
+<li><a href="compilation.html#sec:Implementation_of_stub_generation">12.4.3.2. Implementation of stub-generation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:n4jsc_Headless_Compiler_Interface">12.5. n4jsc Headless Compiler Interface</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:building_the_headless_compiler">12.5.1. building the headless compiler</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="execution.html#_execution">13. Execution</a>
+<ul class="sectlevel2">
+<li><a href="execution.html#sec:N4JS_Project_Execution_And_Linking_Model">13.1. N4JS Project Execution And Linking Model</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#subsec:N4JS_Execution_With_NodeJS">13.1.1. N4JS Execution With NodeJS</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:N4JS_Execution_And_Linking_File">13.2. N4JS Execution And Linking File</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#subsec:NodeJS_Specific_ELF">13.2.1. NodeJS Specific ELF</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Runners-execution">13.3. Runners</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#subsec:N4_Runtime_Environments_Convention">13.3.1. N4 Runtime Environments Convention</a></li>
+<li><a href="execution.html#subsec:Passing_Information_from_IDE_to_Execution_Code_in_Runtime_Environment">13.3.2. Passing Information from IDE to Execution Code in Runtime Environment</a></li>
+<li><a href="execution.html#subsec:Runners_Design">13.3.3. Runners Design</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Legacy_Execution_Engine">13.4. Legacy Execution Engine</a></li>
+<li><a href="execution.html#sec:Design">13.5. Design</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#sec:Usage_Outside_N4JSIDE">13.5.1. Usage Outside N4JSIDE</a>
+<ul class="sectlevel4">
+<li><a href="execution.html#sec:Use_Node_with_Maven">13.5.1.1. Use Node with Maven</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Usage_Inside_N4JSIDE">13.5.2. Usage Inside N4JSIDE</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Runtime_Injection">13.6. Runtime Injection</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#sec:Running_String_Code">13.6.1. Running String Code</a></li>
+<li><a href="execution.html#sec:Running_File_Code">13.6.2. Running File Code</a></li>
+<li><a href="execution.html#sec:Injection_Code_Example">13.6.3. Injection Code Example</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#_tests">14. Tests</a>
+<ul class="sectlevel2">
+<li><a href="tests.html#sec:Performance_Tests">14.1. Performance Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Synthetic_Performance_Tests">14.1.1. Synthetic Performance Tests</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:Design_of_Generator">14.1.1.1. Design of Generator</a></li>
+<li><a href="tests.html#sec:Design_of_Performance_Test_Execution">14.1.1.2. Design of Performance Test Configuration and Execution</a></li>
+<li><a href="tests.html#sec:JUnit_Configuration">14.1.1.3. JUnit Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Test_Configuration">14.1.1.4. JUnitBenchmark Test Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Report_Configuration">14.1.1.5. JUnitBenchmark Report Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Run_Configuration">14.1.1.6. JUnitBenchmark Run Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Example">14.1.1.7. JUnitBenchmark Example</a></li>
+<li><a href="tests.html#sec:Note_on_Jenkins_Job">14.1.1.8. Note on Jenkins Job</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#sec:ECMA_Tests">14.2. ECMA Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Grammar_Tests">14.2.1. Grammar Tests</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:Negative_Tests">14.2.1.1. Negative Tests</a></li>
+<li><a href="tests.html#sec:Test_Exclusion">14.2.1.2. Test Exclusion</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Integration_Tests">14.3. Integration Tests</a></li>
+<li><a href="tests.html#sec:Test_Helpers">14.4. Test Helpers</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Parameterized_N4JS_Tests">14.4.1. Parameterized N4JS tests</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:ParameterizedXtextRunner">14.4.1.1. ParameterizedXtextRunner</a></li>
+<li><a href="tests.html#sec:TestCodeProvider">14.4.1.2. TestCodeProvider</a></li>
+<li><a href="tests.html#sec:Example_Of_Parameterized_Parser_Test">14.4.1.3. Example of parameterized parser test</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Issue_Suppression">14.5. Issue Suppression</a></li>
+<li><a href="tests.html#sec:Xpect_Tests">14.6. Xpect Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Xpect_Test_Setup">14.6.1. Xpect Test Setup</a></li>
+<li><a href="tests.html#sec:Xpect_Issue_Suppression">14.6.2. Xpect Issue Suppression</a></li>
+<li><a href="tests.html#sec:Xpect_Provided_Test_Methods">14.6.3. Xpect Provided Test Methods</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#errors">14.6.3.1. errors</a></li>
+<li><a href="tests.html#warnings">14.6.3.2. warnings</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:N4JS_Specific_Xpect_Test_Methods">14.6.4. N4JS Specific Xpect Test Methods</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:XPECT_noerrors">14.6.4.1. noerrors and nowarnings</a></li>
+<li><a href="tests.html#sec:XPECT_scope">14.6.4.2. scope</a></li>
+<li><a href="tests.html#sec:XPECT_scopeWithPosition">14.6.4.3. scopeWithPosition</a></li>
+<li><a href="tests.html#sec:XPECT_scopeWithResource">14.6.4.4. scopeWithResource</a></li>
+<li><a href="tests.html#sec:XPECT_binding">14.6.4.5. binding</a></li>
+<li><a href="tests.html#sec:XPECT_linkedPathname">14.6.4.6. linkedPathname</a></li>
+<li><a href="tests.html#sec:XPECT_type_of">14.6.4.7. type of</a></li>
+<li><a href="tests.html#sec:XPECT_expectedType">14.6.4.8. expectedType</a></li>
+<li><a href="tests.html#sec:XPECT_elementKeyword">14.6.4.9. elementKeyword</a></li>
+<li><a href="tests.html#sec:XPECT_accessModifier">14.6.4.10. accessModifier</a></li>
+<li><a href="tests.html#sec:XPECT_compileResult">14.6.4.11. compileResult</a></li>
+<li><a href="tests.html#sec:XPECT_output">14.6.4.12. output</a></li>
+<li><a href="tests.html#sec:XPECT_outputRegEx">14.6.4.13. outputRegEx</a></li>
+<li><a href="tests.html#sec:XPECT_calculatedAccessModifier">14.6.4.14. calculatedAccessModifier</a></li>
+<li><a href="tests.html#sec:XPECT_spec">14.6.4.15. spec</a></li>
+<li><a href="tests.html#sec:XPECT_deadCode">14.6.4.16. deadCode</a></li>
+<li><a href="tests.html#sec:XPECT_returnOrThrows">14.6.4.17. returnOrThrows</a></li>
+<li><a href="tests.html#sec:XPECT_lint">14.6.4.18. lint</a></li>
+<li><a href="tests.html#sec:XPECT_lintFails">14.6.4.19. lintFails</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:FIXME_Xpect_modifier">14.6.5. FIXME Xpect modifier</a></li>
+<li><a href="tests.html#sec:Expectmatrix_Xpect_Test_Methods">14.6.6. Expectmatrix Xpect tests</a></li>
+<li><a href="tests.html#xpect-lint-tests">14.6.7. Xpect Lint Tests</a></li>
+</ul>
+</li>
+<li><a href="tests.html#xpect-proposal-tests">14.7. Xpect Proposal Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Validation_vs__Non_Validation">14.7.1. Validation vs. Non-Validation</a></li>
+<li><a href="tests.html#sec:General_Proposal_Test_Features">14.7.2. General Proposal Test Features</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:Test_Variables">14.7.2.1. Test Variables</a></li>
+<li><a href="tests.html#sec:Location_and_Selection">14.7.2.2. at – Location and Selection</a></li>
+<li><a href="tests.html#sec:Multi_Line_Expectations_in_Proposal_Tests">14.7.2.3. Multi Line Expectations in Proposal Tests</a></li>
+<li><a href="tests.html#sec:Timeout">14.7.2.4. Timeout and Performance</a></li>
+</ul>
+</li>
+<li><a href="tests.html#proposals-verify-existence-of-proposals">14.7.3. proposals – Verify Existence of Proposals</a></li>
+<li><a href="tests.html#sec:Verify_displayed_string">14.7.4. display – Verify displayed string</a></li>
+<li><a href="tests.html#sec:Apply_Proposal">14.7.5. apply – Apply Proposal</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#resource-application-in-other-files">14.7.5.1. resource – application in other files</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Content_Assist_Cycling">14.7.6. kind – Content Assist Cycling</a></li>
+<li><a href="tests.html#fileValidVerify-validation-status">14.7.7. fileValid – Verify validation status</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Apply_Proposal_And_Execute_Tests">14.8. Apply Proposal And Execute Tests</a></li>
+<li><a href="tests.html#sec:Organize_Imports_Test">14.9. Organize Imports Test</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#organizeimports">14.9.1. organizeImports</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Access_Control_Test">14.10. Access Control Test</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#test-scenarios">14.10.1. Test Scenarios</a></li>
+<li><a href="tests.html#n4js-code-generator">14.10.2. N4JS Code Generator</a></li>
+<li><a href="tests.html#xtext-issue-matcher">14.10.3. Xtext Issue Matcher</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Smoke_Tests">14.11. Smoke Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#how-to-handle-smoke-test-errors">14.11.1. How to handle smoke test errors?</a></li>
+<li><a href="tests.html#smoketester-and-exceptionanalyzer">14.11.2. SmokeTester and ExceptionAnalyzer</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:UI_Tests_with_SWTBot">14.12. UI Tests with SWTBot</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#writing-swtbot-tests">14.12.1. Writing SWTBot Tests</a></li>
+<li><a href="tests.html#running-swtbot-tests">14.12.2. Running SWTBot Tests</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Debugging_UI_Tests">14.13. Debugging UI Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Connecting_to_the_X_server_on_the_build_node">14.13.1. Connecting to the X-server on the build-node</a></li>
+<li><a href="tests.html#sec:Tools_to_investigate_the_java_stack">14.13.2. Tools to investigate the java-stack</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="ui_concepts.html#_ui-concepts">15. UI Concepts</a>
+<ul class="sectlevel2">
+<li><a href="ui_concepts.html#sec:User_Interface_Concepts">15.1. User Interface Concepts</a>
+<ul class="sectlevel3">
+<li><a href="ui_concepts.html#sec:Eclipse_UI_Concepts">15.1.1. Eclipse UI Concepts</a>
+<ul class="sectlevel4">
+<li><a href="ui_concepts.html#sec:Label_Provider">15.1.1.1. Label Provider</a></li>
+<li><a href="ui_concepts.html#sec:Markers">15.1.1.2. Markers</a></li>
+<li><a href="ui_concepts.html#sec:Commands__Toolbar_and_Menus">15.1.1.3. Commands, Toolbar and Menus</a></li>
+<li><a href="ui_concepts.html#sec:Content_Assist">15.1.1.4. Content Assist</a></li>
+<li><a href="ui_concepts.html#sec:Quick_Fixes">15.1.1.5. Quick Fixes</a></li>
+<li><a href="ui_concepts.html#sec:Quick_Assist">15.1.1.6. Quick Assist</a></li>
+<li><a href="ui_concepts.html#sec:Clean_Up_Actions">15.1.1.7. Clean Up Actions</a></li>
+<li><a href="ui_concepts.html#sec:Save_Actions">15.1.1.8. Save Actions</a></li>
+<li><a href="ui_concepts.html#sec:Auto_Edit">15.1.1.9. Auto Edit</a></li>
+<li><a href="ui_concepts.html#sec:Template_Proposals">15.1.1.10. Template Proposals</a></li>
+<li><a href="ui_concepts.html#sec:Outline_View___Quick_Outline">15.1.1.11. Outline View / Quick Outline</a></li>
+<li><a href="ui_concepts.html#sec:Navigator__Package_Explorer__Project_Explorer">15.1.1.12. Navigator, Package Explorer, Project Explorer</a></li>
+<li><a href="ui_concepts.html#sec:Hyperlinking_and_Navigation">15.1.1.13. Hyperlinking and Navigation</a></li>
+<li><a href="ui_concepts.html#sec:Syntax_and_Semantic_Coloring">15.1.1.14. Syntax and Semantic Coloring</a></li>
+<li><a href="ui_concepts.html#sec:Code_Formatter">15.1.1.15. Code Formatter</a></li>
+<li><a href="ui_concepts.html#sec:Wizards">15.1.1.16. Wizards</a></li>
+<li><a href="ui_concepts.html#sec:Cheat_Sheets">15.1.1.17. Cheat Sheets</a></li>
+<li><a href="ui_concepts.html#sec:Context_sensitive_Help">15.1.1.18. Context-sensitive Help</a></li>
+<li><a href="ui_concepts.html#sec:Hovers">15.1.1.19. Hovers</a></li>
+<li><a href="ui_concepts.html#sec:Folding">15.1.1.20. Folding</a></li>
+<li><a href="ui_concepts.html#sec:Customizable_validation___severity">15.1.1.21. Customizable validation / severity</a></li>
+<li><a href="ui_concepts.html#sec:Proposals">15.1.1.22. Proposals</a></li>
+</ul>
+</li>
+<li><a href="ui_concepts.html#sec:Non_Eclipse_UI_Concepts">15.1.2. Non-Eclipse UI Concepts</a>
+<ul class="sectlevel4">
+<li><a href="ui_concepts.html#sec:Overlays">15.1.2.1. Overlays</a></li>
+<li><a href="ui_concepts.html#sec:Goto__Inferred__Type">15.1.2.2. Goto (Inferred) Type</a></li>
+<li><a href="ui_concepts.html#sec:Postfix_Completion">15.1.2.3. Postfix Completion</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="ui_concepts.html#_user-interface-resources">15.2. User Interface Resources</a>
+<ul class="sectlevel3">
+<li><a href="ui_concepts.html#_icons">15.2.1. Icons</a>
+<ul class="sectlevel4">
+<li><a href="ui_concepts.html#_eclipse-platform-icons">15.2.1.1. Eclipse Platform Icons</a></li>
+<li><a href="ui_concepts.html#_n4js-specific-icons">15.2.1.2. N4JS Specific Icons</a></li>
+<li><a href="ui_concepts.html#_high-resolution-icons">15.2.1.3. High Resolution Icons</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="formatting.html#_formatting">16. Formatting</a>
+<ul class="sectlevel2">
+<li><a href="formatting.html#sec:FmtObjective">16.1. Objective</a>
+<ul class="sectlevel3">
+<li><a href="formatting.html#sec:FmtFormatting_Comments">16.1.1. Formatting Comments</a></li>
+</ul>
+</li>
+<li><a href="formatting.html#sec:FmtArchitecture">16.2. Architecture</a>
+<ul class="sectlevel3">
+<li><a href="formatting.html#sec:Implementation_example">16.2.1. Implementation example</a></li>
+</ul>
+</li>
+<li><a href="formatting.html#sec:FmtFormatter_Implementation_Guidelines">16.3. Formatter Implementation Guidelines</a></li>
+<li><a href="formatting.html#sec:FmtConfiguration">16.4. Configuration</a></li>
+<li><a href="formatting.html#sec:FmtUI_Integration">16.5. UI Integration</a></li>
+<li><a href="formatting.html#sec:FmtUnit_Testing_with_Xpect">16.6. Unit Testing with Xpect</a></li>
+</ul>
+</li>
+<li><a href="external_libraries.html#_external-libraries">17. External Libraries</a>
+<ul class="sectlevel2">
+<li><a href="external_libraries.html#sec:Major_Components">17.1. Major Components</a>
+<ul class="sectlevel3">
+<li><a href="external_libraries.html#subsec:External_Resources">17.1.1. External Resources</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Workspace">17.1.2. External Library Workspace</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Preference_Store">17.1.3. External Library Preference Store</a></li>
+<li><a href="external_libraries.html#subsec:npm_Manager">17.1.4. Library Manager</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Builder_Helper">17.1.5. External Library Builder</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Xtext_Index_Persister">17.1.6. External Library Xtext Index Persister</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Preference_Page">17.1.7. External Library Preference Page</a></li>
+</ul>
+</li>
+<li><a href="external_libraries.html#sec:Headless_External_Library_Support">17.2. Headless External Library Support</a>
+<ul class="sectlevel3">
+<li><a href="external_libraries.html#_custom-npm-settings">17.2.1. Custom npm settings</a></li>
+</ul>
+</li>
+<li><a href="external_libraries.html#sec:lmFutureWork">17.3. Future Work</a>
+<ul class="sectlevel3">
+<li><a href="external_libraries.html#subsec:lmMultipleDependencyScope">17.3.1. Multiple Dependency Scope</a></li>
+<li><a href="external_libraries.html#subsec:lmRunTestsFromLibrary">17.3.2. Run Tests from TestLibrary</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="json_support.html#sec:JSON_Support">18. JSON Support</a>
+<ul class="sectlevel2">
+<li><a href="json_support.html#sec:JSON_Parser">18.1. JSON Parser</a>
+<ul class="sectlevel3">
+<li><a href="json_support.html#sec:JSON_Parser_Unicode_Escaping">18.1.1. Escaping Unicode Control Characters in String Literals</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Empty_Text">18.1.2. Empty Text</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Nested_Structures">18.1.3. Nested Structures</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Whitespace">18.1.4. Whitespace</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Comments">18.1.5. Comments</a></li>
+</ul>
+</li>
+<li><a href="json_support.html#sec:JSON_Language_Extensions">18.2. JSON Language Extensions</a>
+<ul class="sectlevel3">
+<li><a href="json_support.html#sec:JSON_Validator_Extensions">18.2.1. JSON Validator Extensions</a>
+<ul class="sectlevel4">
+<li><a href="json_support.html#sec:File_Specitic_Validator_Extensions">18.2.1.1. File-Specific Validator Extensions</a></li>
+<li><a href="json_support.html#sec:JSON_Declarative_JSON_Validator_Extensions">18.2.1.2. Declarative JSON Validator Extensions</a></li>
+</ul>
+</li>
+<li><a href="json_support.html#_json-resource-description-strategy">18.2.2. JSON Resource Description Strategy</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_jsdoc">19. JSDoc</a>
+<ul class="sectlevel2">
+<li><a href="jsdoc.html#sec:Design_Rationale">19.1. Design Rationale</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#_general-design">19.1.1. General Design</a></li>
+<li><a href="jsdoc.html#sec:Type_Expressions">19.1.2. Type Expressions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="docexporter.html#_docexporter">20. DocExporter</a>
+<ul class="sectlevel2">
+<li><a href="docexporter.html#sec:Specification_Exporter">20.1. Specification Exporter</a></li>
+</ul>
+</li>
+<li><a href="rename_refactoring.html#_rename-refactoring">21. Rename Refactoring</a>
+<ul class="sectlevel2">
+<li><a href="rename_refactoring.html#_rename-refactoring-ui-interaction">21.1. Rename Refactoring UI interaction</a></li>
+<li><a href="rename_refactoring.html#_renameelementprocessor-interaction">21.2. RenameElementProcessor interaction</a></li>
+</ul>
+</li>
+<li><a href="flow_graphs.html#chap:flowgraphs">22. Flow Graphs</a>
+<ul class="sectlevel2">
+<li><a href="flow_graphs.html#sec:flowgraphs_overview">22.1. Flow graphs overview</a>
+<ul class="sectlevel3">
+<li><a href="flow_graphs.html#_internal-graph">22.1.1. Internal graph</a></li>
+<li><a href="flow_graphs.html#_optimizations">22.1.2. Optimizations</a></li>
+<li><a href="flow_graphs.html#_api-for-client-analyses">22.1.3. API for client analyses</a>
+<ul class="sectlevel4">
+<li><a href="flow_graphs.html#_mapping-from-internal-to-ast-elements">22.1.3.1. Mapping from internal to AST elements</a></li>
+<li><a href="flow_graphs.html#_graph-visitor">22.1.3.2. Graph visitor</a></li>
+<li><a href="flow_graphs.html#_graph-explorer">22.1.3.3. Graph explorer</a></li>
+<li><a href="flow_graphs.html#_branch-walker">22.1.3.4. Branch walker</a></li>
+<li><a href="flow_graphs.html#_example-1-compute-string-for-each-path">22.1.3.5. Example 1: Compute string for each path</a></li>
+<li><a href="flow_graphs.html#_path-quantor">22.1.3.6. Path quantor</a></li>
+</ul>
+</li>
+<li><a href="flow_graphs.html#_control-flow-analyses">22.1.4. Control flow analyses</a>
+<ul class="sectlevel4">
+<li><a href="flow_graphs.html#_dead-code-analysis">22.1.4.1. Dead code analysis</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="flow_graphs.html#sec:dataflow">22.2. Dataflow</a>
+<ul class="sectlevel3">
+<li><a href="flow_graphs.html#_dataflow-graph">22.2.1. Dataflow graph</a></li>
+<li><a href="flow_graphs.html#_dataflow-analyses">22.2.2. Dataflow analyses</a>
+<ul class="sectlevel4">
+<li><a href="flow_graphs.html#_def-def-def-nothing-analysis">22.2.2.1. Def&#8594;Def / Def&#8594;Nothing analysis</a></li>
+<li><a href="flow_graphs.html#_def-use-decl-analysis">22.2.2.2. Def|Use&#8592;Decl analysis</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="publish_npms.html#sec:publish-npms-to-public">23. Publish npms</a>
+<ul class="sectlevel2">
+<li><a href="publish_npms.html#sec:publish-npms-n4js-maven">23.1. Publish n4js-libs to during  maven build</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Hints">Appendix A: Hints</a>
+<ul class="sectlevel2">
+<li><a href="appendix_a_hints.html#sec:XtextInjection">A.1. Xtext Injection</a>
+<ul class="sectlevel3">
+<li><a href="appendix_a_hints.html#sec:DI_MultipleInjectors_Singletons">A.1.1. Multiple Injectors and Singletons</a>
+<ul class="sectlevel4">
+<li><a href="appendix_a_hints.html#sec:DI_avoid_duplicate_singletons">A.1.1.1. Avoiding duplicate singletons</a>
+<ul class="sectlevel5">
+<li><a href="appendix_a_hints.html#sec:DI_binding_in_shared">A.1.1.1.1. Defining binding in the shared injector</a></li>
+<li><a href="appendix_a_hints.html#sec:DI_binding_in_custom">A.1.1.1.2. Defining binding in the custom injector</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:DI_Hints">A.1.2. Dependency Injection Hints</a>
+<ul class="sectlevel4">
+<li><a href="appendix_a_hints.html#sec:DI_custom_bundle">A.1.2.1. Use DI in custom bundle, use DI with extensions</a>
+<ul class="sectlevel5">
+<li><a href="appendix_a_hints.html#sec:DI_custom_bundle_problem">A.1.2.1.1. Problem</a></li>
+<li><a href="appendix_a_hints.html#sec:DI_custom_bundle_solution">A.1.2.1.2. Solution</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Access_Other_DSL_Injector">A.1.2.2. How do I get the Guice Injector of my language?</a>
+<ul class="sectlevel5">
+<li><a href="appendix_a_hints.html#sec:DSL_Injector_UI_context">A.1.2.2.1. UI context</a></li>
+<li><a href="appendix_a_hints.html#sec:DSL_Injector_Non_UI_context">A.1.2.2.2. Non UI context but with injection context</a></li>
+<li><a href="appendix_a_hints.html#sec:DSL_Injector_Non_UI_non_injection_context">A.1.2.2.3. Non UI context without injection context</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Cancel_Indicator">A.1.2.3. How do I get cancel indicators in different contexts?</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Eclipse">A.2. Eclipse</a>
+<ul class="sectlevel3">
+<li><a href="appendix_a_hints.html#sec:Show_Xtext_Index">A.2.1. Show the current Xtext index</a></li>
+<li><a href="appendix_a_hints.html#sec:Plugin_spy">A.2.2. Plug-in spy</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Maven-hints">A.3. Maven</a>
+<ul class="sectlevel3">
+<li><a href="appendix_a_hints.html#how-to-check-for-maven-mojo-updates">A.3.1. How to check for Maven MOJO updates</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#_module-loading">Appendix B: Module Loading</a>
+<ul class="sectlevel2">
+<li><a href="appendix_b_module_loading.html#sec:Dependency_Management">B.1. Dependency Management</a></li>
+<li><a href="appendix_b_module_loading.html#ecmascript-modules">B.2. ECMAScript Modules</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:ES5_Modules_Systems">B.2.1. ES5 Modules Systems</a></li>
+<li><a href="appendix_b_module_loading.html#sec:ES6_Modules">B.2.2. ES6 Modules</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:ECMAScript_Module_Loaders">B.3. ECMAScript Module Loaders</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:ES6_Module_Loaders">B.3.1. ES6 Module Loaders</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Polyfills_for_ES6_Module_Loaders">B.3.2. Polyfills for ES6 Module Loaders</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:es6_module_loader">B.3.2.1. es6-module-loader</a></li>
+<li><a href="appendix_b_module_loading.html#sec:SystemJS">B.3.2.2. SystemJS</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Demo">B.3.2.3. Demo</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#case-study-typescript">B.4. Case Study : TypeScript</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:ES6_Modules_Support">B.4.1. ES6 Modules Support</a></li>
+<li><a href="appendix_b_module_loading.html#sec:TypeScript_and_Module_Loading">B.4.2. TypeScript and Module Loading</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Cyclic_Dependencies">B.5. Cyclic Dependencies</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:Setup">B.5.1. Setup</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Transpile_and_Execute">B.5.2. Transpile and Execute</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Module_Format___AMD">B.5.2.1. Module Format = AMD</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Module_Format___CommonJS">B.5.2.2. Module Format = CommonJS</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Module_Format___SystemJS">B.5.2.3. Module Format = SystemJS</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Conclusion">B.5.3. Conclusion</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#system.register-as-transpilation-target">B.6. System.register as transpilation target</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:Introduction">B.6.1. Introduction</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:External_Transpilers">B.6.1.1. External Transpilers</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Example_of_a_System_register_module">B.6.1.2. Example of a System.register module</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Structure_of_a_System_register_module">B.6.2. Structure of a System.register module</a></li>
+<li><a href="appendix_b_module_loading.html#_transpilation-hints">B.6.3. Transpilation Hints</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Handling_Imports">B.6.3.1. Handling Imports</a></li>
+<li><a href="appendix_b_module_loading.html#sec:__exportFn__">B.6.3.2. &lt;&lt;exportFn&gt;&gt;</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Handling_Exports">B.6.3.3. Handling Exports</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Examples_w__Circular_Dependencies">B.6.4. Examples w/ Circular Dependencies</a></li>
+<li><a href="appendix_b_module_loading.html#sec:N4JS_Examples_w__Circular_Dependencies">B.6.5. N4JS Examples w/ Circular Dependencies</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Unresolved_Cyclic_Dependencies">B.6.5.1. Unresolved Cyclic Dependencies</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Variables___Functions">B.6.5.2. Examples with Variables &amp; Functions</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Classes">B.6.5.3. Examples with Classes</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Examples_with_SubClassing">B.6.5.4. Examples with SubClassing</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Miscellaneous">B.6.5.5. Miscellaneous</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#_resources">B.6.6. Resources</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:CommonJS_as_transpilation_target">B.7. CommonJS as transpilation target</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#_introduction-2">B.7.1. Introduction</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Transpilation_Hints">B.7.2. Transpilation Hints</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Import_Statements">B.7.2.1. Import Statements</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Export_Statements">B.7.2.2. Export Statements</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Tracking_Live_Bindings">B.7.2.3. Tracking Live Bindings</a></li>
+<li><a href="appendix_b_module_loading.html#sec:A_complete_example">B.7.2.4. A complete example</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#_resources-2">B.7.3. Resources</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_c_license.html#sec:License">Appendix C: License</a></li>
+<li><a href="appendix_d_acronyms.html#sec:Acronyms">Appendix D: Acronyms</a></li>
+<li><a href="appendix_e_bibliography_and_footnotes.html#_bibliography-and-footnotes">Appendix E: Bibliography and Footnotes</a></li>
+</ul>
+</div>
+</div>
+<div id="content"><div class="sect1">
+<h2 id="_references"><a class="anchor" href="#_references"></a><a class="link" href="#_references">11. References</a></h2>
+<div class="sectionbody">
+<div class="admonitionblock warning">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-warning" title=""></i>
+</td>
+<td class="content">
+This chapter maybe outdated.
+</td>
+</tr>
+</table>
+</div>
+<div class="sect2">
+<h3 id="sec:usecases"><a class="anchor" href="#sec:usecases"></a><a class="link" href="#sec:usecases">11.1. Use cases</a></h3>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Compilation
+</td>
+<td class="hdlist2">
+<p>for deciding in incremental builder which resources requires a recompilation</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Editing
+</td>
+<td class="hdlist2">
+<p>Dirty state calculation: for deciding which resources needs to be reparsed as references have changed</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+UI
+</td>
+<td class="hdlist2">
+<p>Such as <kbd>Find references</kbd>, find all places in the workspaces that points to the selected element</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Tools
+</td>
+<td class="hdlist2">
+<p>requiring references, such as refactorings, e.g., rename refactoring: apply the renaming of the element also to all references to it (like find by references)</p>
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:calculation_algorithm"><a class="anchor" href="#sec:calculation_algorithm"></a><a class="link" href="#sec:calculation_algorithm">11.2. Calculation algorithm</a></h3>
+<div class="sect3">
+<h4 id="sec:Xtext_default_implementation"><a class="anchor" href="#sec:Xtext_default_implementation"></a><a class="link" href="#sec:Xtext_default_implementation">11.2.1. Xtext default implementation</a></h4>
+<div class="paragraph">
+<p>Using Reference Descriptions:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>default implementation contained in method <code>createReferenceDescriptions</code> of <code>o.e.x.resource.impl.DefaultResourceDescriptionStrategy</code></p>
+</li>
+<li>
+<p>iterates over all EReferences of the EClass of the current element</p>
+</li>
+<li>
+<p>navigates all references and resolves them (already done before in DefaultResourceDescription.computeReferenceDescriptions)</p>
+</li>
+<li>
+<p>create reference description objects for all these references</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>In case of N4JS and the types, reference descriptions are also created for references to types model elements (definedType) and for references from Types element to AST.</p>
+</div>
+<div class="paragraph">
+<p>We do not use this default implementation for two reasons:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>expensive</p>
+</li>
+<li>
+<p>Default implementation of reference descriptions only calculates the direct dependencies but not the transitive ones + the calculation of the URIs is very expensive.</p>
+</li>
+</ol>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:N4_implementation"><a class="anchor" href="#sec:N4_implementation"></a><a class="link" href="#sec:N4_implementation">11.2.2. N4JS implementation</a></h4>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>the Xtext default implementation is disabled by let <code>N4JSResourceDescription.computeReferenceDescriptions</code> return an empty list. Also the bound <code>N4JSDescriptionUtils</code> returns an empty list for collectOutgoingReferences</p>
+</li>
+<li>
+<p>Calculating <em>direct references</em> are only done inside <code>N4JSResourceDescription.getImportedNames</code> (that uses newly introduced <code>N4JSCrossReferenceComputer.computeCrossRefs</code> for collecting all direct dependencies) - here only (parameterized) type refs, types and identifiable elements are collected</p>
+</li>
+<li>
+<p>collect all <em>transitive dependencies</em>, i.e. all super classes, consumed roles and implemented interfaces in the type hierarchy and add their resources as dependency (this is done in <code>N4JSResourceDescription.getImportedNames</code> (after calculating all direct dependencies with <code>N4JSResourceDescriptionStrategy</code>)</p>
+</li>
+<li>
+<p>bind <code>N4JSReferenceQueryExecutor</code> as a custom implementation to calculate the target URIs for an given target element and bind <code>N4JSReferenceFinder</code> as a custom implementation to calculate reference descriptions to be used by the default Xtext found references UI (use case UI)</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p><code>ClusteringBuilderState.doUpdate</code> calculates if a dependent resource has changed (in the context of calculating the <code>DefaultResourceDescriptionDelta</code> out of the old and new resource descriptions). Each resource description consists of <code>EObjectDescriptions</code>. The <code>EObjectDescription</code> for <code>Script</code> also contains the types model (<code>TModule</code>) for the resource. The references between resources are implemented via the type model. If it has changed (compared with the user data of the old <code>EObjectDescription</code>) then all other resource descriptions registered as been dependent on the resource (the qualified names of the resource descriptions are serialized as imported names within the resource description) will be notified that a reparse is needed.</p>
+</div>
+<div class="paragraph">
+<p>For <em>dirty state</em> the same behavior is achieved via the dirty state editor support using the resource set of the editor (instead the file system resources).</p>
+</div>
+<div class="paragraph">
+<p>As the primitive and built-in types are fixed they are ignored when calculating the dirty state. When calculating dependending resources and dirty state the reference of an AST element to its defining type is ignored as is the reference from the type to its AST element</p>
+</div>
+<div class="paragraph">
+<p><a href="#fig:cd_classes">Classes</a> shows the different entry points (user actions) and classes involved in the process.</p>
+</div>
+<div id="fig:cd_classes" class="imageblock center">
+<div class="content">
+<img src="chapters/11_references/images/cd_classes.svg" alt="title-"Reference handling"">
+</div>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:PerformanceOfDependencyCalculation"><a class="anchor" href="#sec:PerformanceOfDependencyCalculation"></a><a class="link" href="#sec:PerformanceOfDependencyCalculation">11.3. Performance Of Dependency Calculation</a></h3>
+<div class="paragraph">
+<p>Concerning frequency and contexts it is clear, that triggering <code>Find references</code> and rename refactoring is not as frequent as editing (n4)js files that leads to dirty state (very often as happens when editing) and to trigger compilation (at file save, also often). Calculating if a resource is affected by a change (dirty state calculation) may not be too expensive. But running compilation for too many files (or the wrong set of files) due to incorrect dirty state calculation is expensive.</p>
+</div>
+<div class="paragraph">
+<p><code>N4JSResourceDescription.getImportedNames</code> is invoked on every edit of a file in the editor, so on every edit the complete content has to be retraversed for possible new references (expensive but not avoidable). For the types of all found references the super types have to recalculated. Traversing the type hierarchy shouldn’t be too expensive.</p>
+</div>
+<div class="paragraph">
+<p>Possible optimization could be:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>caching of traversing referenced types whose resources had not changed since last edit</p>
+</li>
+<li>
+<p>not traversing types that are imported but non of their features are used within the current resource</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p><em>Those optimization should be done only if there are real performance issues are discovered.</em></p>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:kinds_of_references"><a class="anchor" href="#sec:kinds_of_references"></a><a class="link" href="#sec:kinds_of_references">11.4. Kinds of references</a></h3>
+<div class="sect3">
+<h4 id="sec:Cross_References_to_be_ignored"><a class="anchor" href="#sec:Cross_References_to_be_ignored"></a><a class="link" href="#sec:Cross_References_to_be_ignored">11.4.1. Cross References to be ignored</a></h4>
+<table class="tableblock frame-all grid-all spread">
+<colgroup>
+<col style="width: 33.3333%;">
+<col style="width: 33.3333%;">
+<col style="width: 33.3334%;">
+</colgroup>
+<thead>
+<tr>
+<th class="tableblock halign-left valign-top">Element</th>
+<th class="tableblock halign-left valign-top">Reference</th>
+<th class="tableblock halign-left valign-top">Explanation</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">TypeDefiningElement</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">definedType: Type</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">always inner resource change (e.g., Functions, Classifier)</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">types::Type</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">astElement</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">as always inner resource change</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">ImportDeclaration</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">importedModule: TModule</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">only affected if the resource name changes (and such a change cannot be performed dirty)</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">ContinueStatement</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">label: LabelledStatement</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">always inner resource changes</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">BreakStatement</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">label: LabelledStatement</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">always inner resource changes</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">types::PrimitiveType</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">autocoercedObject: TClassifier</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">fixed (immutable) and internal</p></td>
+</tr>
+</tbody>
+</table>
+</div>
+<div class="sect3 language-n4js">
+<h4 id="sec:Cross_References_to_be_handled"><a class="anchor" href="#sec:Cross_References_to_be_handled"></a><a class="link" href="#sec:Cross_References_to_be_handled">11.4.2. Cross References to be handled</a></h4>
+<div class="paragraph">
+<p>Cross References</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>types::ParameterizedTypeRef &#8594; declaredType : Type</p>
+</li>
+<li>
+<p>* &#8594; N4GetterDeclaration: N4FieldDeclaration type, but references to getter can be done also done from outside</p>
+</li>
+<li>
+<p>* &#8594; N4SetterDeclaration: undef, references to setter can be done also done from outside</p>
+</li>
+<li>
+<p>types::PrototypeTypeRef &#8594; type : Type</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>Contained <code>ParameterizedTypeRef</code> and <code>TypeVariables</code> (that internally references to <code>Type</code>):</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>references to declared super types of a type (Class, Role, Interface), i.e. superType, consumedRoles, implementedInterfaces</p>
+</li>
+<li>
+<p>TypeVariable &#8594; declaredUpperBounds</p>
+</li>
+<li>
+<p>References in type arguments:</p>
+<div class="ulist">
+<ul>
+<li>
+<p>Wildcards &#8594; upper and lower bounds, e.g. <code>var List&lt;? super A&gt; l1;</code></p>
+</li>
+<li>
+<p>direct type references, e.g. <code>var List&lt;A&gt; l;</code></p>
+</li>
+</ul>
+</div>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>Cross References to IdentifiableElement (types):</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>IdentifierRef &#8594; id : IdentifiableElement</p>
+</li>
+<li>
+<p>NamedImportSpecifier &#8594; importedElement : IdentifiableElement</p>
+</li>
+<li>
+<p>ParameterizedPropertyAccessExpression &#8594; property : IdentifiableElement</p>
+</li>
+<li>
+<p>PropertyAccessExpression &#8594; property : IdentifiableElement</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>Contained IdentifierRef (that internally references to IdentifiableElement):</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>ParameterizedCallExpression &#8594; target</p>
+</li>
+<li>
+<p>as PrimaryExpression in MemberExpression</p>
+</li>
+</ol>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="sec:transitive_dependencies"><a class="anchor" href="#sec:transitive_dependencies"></a><a class="link" href="#sec:transitive_dependencies">11.5. Transitive dependencies</a></h3>
+<div class="paragraph">
+<p>Besides the direct dependencies we also need the transitive dependencies, as demonstrated in the following example.</p>
+</div>
+<div id="ex:transdepex" class="listingblock">
+<div class="title">Transitive Dependency</div>
+<div class="content">
+<pre class="highlight"><code class="language-java" data-lang="java">export class A {
+    public myMethod()
+}</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="title">Transitive Dependency pt.2</div>
+<div class="content">
+<pre class="highlight"><code class="language-java" data-lang="java">export class B extends my/test/A {
+}</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="title">Transitive Dependency pt.3</div>
+<div class="content">
+<pre class="highlight"><code class="language-java" data-lang="java">export class C extends my/test/B {
+    myMethodC() {
+        this.myMethod()
+    }
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>If the name of <code>myMethod</code> in A changes, C should get dirty. This can get more complicated, if, e.g., a method in a consumed role is renamed, which then leads to binding references to super types.</p>
+</div>
+<div class="paragraph">
+<p>Therefore all direct and indirect super types are calculated (including super classes, consumed roles and implemented interfaces) for all found directly referenced types. The qualified names of their resources are added to the list of imported names. <sup class="footnote">[<a id="_footnoteref_12" class="footnote" href="appendix_e_bibliography_and_footnotes.html#_footnote_12" title="View footnote.">12</a>]</sup></p>
+</div>
+<div class="paragraph">
+<p>Other transitive dependencies:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>call of member mixed by a consumed role</p>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p>role is consumed by role consumed by this class</p>
+</li>
+<li>
+<p>role is consumed by class inherited by this class</p>
+</li>
+</ol>
+</div>
+</li>
+<li>
+<p>call of member available by implemented interface</p>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p>interface is implemented by role consumed by this class</p>
+</li>
+<li>
+<p>interface is implemented by class inherited by this class</p>
+</li>
+</ol>
+</div>
+</li>
+<li>
+<p>call of member available by extended class</p>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p>class is extended by class inherited by this class</p>
+</li>
+</ol>
+</div>
+</li>
+<li>
+<p>chained method calls</p>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p>method is of type that itself has members which are directly called, so the type is not directly imported or referenced by name in the caller but indirectly required</p>
+</li>
+<li>
+<p>method is of type that itself inherits members which are directly called, so the type (and its super types) is not directly imported or referenced by name in the caller but indirectly required</p>
+</li>
+</ol>
+</div>
+</li>
+</ol>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="paragraph">
+<p>Each type is defined in its own file.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-java" data-lang="java">export class MyClassOne  {
+    myMethodOne() {
+        var MyClassTwo instance;
+        instance.getElement().myMethodThree()
+    }
+}</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-java" data-lang="java">export class MyClassTwo  {
+    MyClassThree getElement() {
+        return new MyClassThree;
+    }
+}</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-java" data-lang="java">export class MyClassThree  {
+    void myMethodThree() {}
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>If <code>myMethodThree</code> is renamed this should affect MyClassOne.</p>
+</div>
+<div class="paragraph">
+<p>Note that the method call in <code>MyClassOne</code> directly binds to the method in <code>MyClassThree</code>. However, the dependencies are only managed by means of types. So, from that perspective, the dependency between <code>MyClassOne</code> and <code>MyClassThree</code> is indirect.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-java" data-lang="java">export class MyClassOne  {
+    void myMethodOne() {
+        var MyClassTwo instance;
+        instance.myMethodTwo().getElement().myMethodFour()
+    }
+}</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-java" data-lang="java">export class MyClassTwo {
+    MyClassThree&lt;MyClassFour&gt; myMethodTwo() {
+        return null;
+    }
+}</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-java" data-lang="java">export class MyClassThree&lt;T extends MyClassFour&gt;  {
+    T element;
+
+    T getElement() {
+        return this.element;
+    }
+}</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-java" data-lang="java">export class MyClassFour  {
+    void myMethodFour() {
+    }
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>If <code>myMethodFour</code> is renamed this should affect <code>MyClassOne</code>.</p>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>More examples are found in the tests (cf. <code>..ide.n4js.dirtystate.BuilderParticipantPluginTest</code> and <code>&#8230;&#8203;BuilderParticipantPluginUITest</code>)</p>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:find-references"><a class="anchor" href="#sec:find-references"></a><a class="link" href="#sec:find-references">11.6. Find references</a></h3>
+<div class="paragraph">
+<p>Find references is perceived as a feature in Eclipse IDE, but its implementation can also be useful in a headless scenario, e.g. in the compiler to drop dead code.
+Therefore, as opposed to the Xtext default implementations, the code was refactored to split the parts that depend on the UI from the non-UI dependent logic (see <code>org.eclipse.n4js.findReferences</code> vs. <code>org.eclipse.n4js.ui.search</code>).</p>
+</div>
+<div class="sect3">
+<h4 id="_background"><a class="anchor" href="#_background"></a><a class="link" href="#_background">11.6.1. Background</a></h4>
+<div class="paragraph">
+<p>Since no reference descriptions are stored in the index for N4JS resources, the cross references have to be found by other means.
+That is, the list of imported names is used as an indicator to find resources that have a potential dependency to the searched element.
+These resources have to be checked thoroughly.
+That is, their clear text representation is checked at a first step against the clear text representation of the found element before the resource is fully loaded and cross references are resolved.</p>
+</div>
+<div class="paragraph">
+<p>The decision to drop reference descriptions from the index was deliberate since they would only report bogus information in the context of inheritance, e.g. a method <code>getA</code> of type <code>B</code> my be overridden by <code>getA</code> in type <code>C</code>.
+Concrete bindings against <code>C.getA</code> should also be reported as references to <code>B.getA</code> since they identify the same public API of the type hiearchy around <code>B</code>.
+Therefore reference descriptions could not be used to find dependencies between source snippets.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_how-find-references-work"><a class="anchor" href="#_how-find-references-work"></a><a class="link" href="#_how-find-references-work">11.6.2. How Find References Work</a></h4>
+<div class="paragraph">
+<p>Methods for finding references are provided Xtext&#8217;s interface <code>IReferenceFinder</code> and can be used both by the UI or headlessly.
+The N4JS implementation of this interface for the N4JS language is the class <code>ConcreteSyntaxAwareReferenceFinder</code>.
+One of the key methods defined by the <code>IReferenceFinder</code> is <code>void findAllReferences(TargetURIs, IResourceAccess, IResourceDescriptions, Acceptor, IProgressMonitor)</code> that finds all places in all resources of the index whereby those places cross-reference one of the URIs contained in <code>TargetURIs</code> .</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>TargetURIs</code> contains the set of URIs to be searched. The caller of <code>IReferenceFinder</code> is responsible for collecting the <code>Target URIs</code> to be searched.</p>
+</li>
+<li>
+<p><code>IResourceAccess</code> is used to search local references. This is needed because local references are usually not index.</p>
+</li>
+<li>
+<p><code>IResourceDescriptions</code> is the indexed.</p>
+</li>
+<li>
+<p><code>Acceptor</code> is called when a reference is found.</p>
+</li>
+<li>
+<p><code>IProgressMonitor</code> is used for showing progress bar (can be null).</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>In the following, we will have a look at the workflow to find references when triggered in the UI.
+After understanding the UI case, the workflow of find references in the headless case should be self-explanatory.</p>
+</div>
+<div class="paragraph">
+<p><a href="#fig:findreference_workflow">Find reference workflow</a> shows the workflow of find references when triggered in the UI.</p>
+</div>
+<div id="fig:findreference_workflow" class="imageblock center">
+<div class="content">
+<img src="chapters/11_references/images/findreference_workflow.svg" alt="title-"Find reference workflow"">
+</div>
+</div>
+<div class="paragraph">
+<p>The following example will be used for explanation.</p>
+</div>
+<div class="listingblock">
+<div class="title">A.n4js</div>
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">import {B} from "B";
+let b = new B(); // B here is an IdentifierRef referring to TClass B in B.n4js</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="title">B.n4js</div>
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">export public class B {}</code></pre>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_step-1-convert-cursor-position-to-declared-element"><a class="anchor" href="#_step-1-convert-cursor-position-to-declared-element"></a><a class="link" href="#_step-1-convert-cursor-position-to-declared-element">11.6.2.1. Step 1: Convert Cursor Position to Declared Element</a></h5>
+<div class="paragraph">
+<p>This step is represented by the purple color in <a href="#fig:findreference_workflow">Find reference workflow</a> diagram.</p>
+</div>
+<div class="paragraph">
+<p>In the IDE, for the sake of convenience, we allow the user to find references of an arbitrary element at the current cursor.
+For instance, while the cursor is currently at <code>IdentifierRef B</code> in the <code>NewExpression</code> in <code>A.n4js</code>, the user may want to find all references to <code>B</code>.
+In those cases, we first need to find declaration element of <code>IdentifierRef B</code> which is <code>TClass B</code>. The Target URIs then contains a single URI to <code>TClass B</code>.
+In diagram <a href="#fig:findreference_workflow">Find reference workflow</a>, the classe <code>EObjectAtOffsetHelper</code> can convert the current cursor position into a declared element.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_step-2-convert-declared-element-to-target-uris"><a class="anchor" href="#_step-2-convert-declared-element-to-target-uris"></a><a class="link" href="#_step-2-convert-declared-element-to-target-uris">11.6.2.2. Step 2: Convert Declared Element to Target URIs</a></h5>
+<div class="paragraph">
+<p>This step is represented by the yellow color in <a href="#fig:findreference_workflow">Find reference workflow</a> diagram.</p>
+</div>
+<div class="paragraph">
+<p>The Target URIs contains the URIs whose references are to be searched.
+The caller guarantees that <em>Target URIs contain only URIs to declared elements, i.e. definitions</em>.
+For example, if we want to find references for <code>N4ClassDeclaration B</code> in <code>B.n4js</code>, the target URIs contains a URI to the AST node <code>N4ClassDeclaration B</code> and a URI to the TModule node <code>TClass B</code>.
+Note that, in addition to the URI to the AST node <code>N4ClassDeclaration B</code>, the URI to the derived TModule node <code>TClass B</code> is also needed because <code>N4ClassDeclaration</code> can never be a target of a cross reference.
+In the diagram <a href="#fig:findreference_workflow">Find reference workflow</a> , the classes depicted in yellow color are responsible for converting declared elements to <code>Target URIs</code> taking care of the derived <code>TModule</code> nodes.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_step-3-filter-potential-resources"><a class="anchor" href="#_step-3-filter-potential-resources"></a><a class="link" href="#_step-3-filter-potential-resources">11.6.2.3. Step 3: Filter Potential Resources</a></h5>
+<div class="paragraph">
+<p>This step is represented by the green color in <a href="#fig:findreference_workflow">Find reference workflow</a> diagram.</p>
+</div>
+<div class="paragraph">
+<p>The general algorithm for finding references is to traverse the AST of each resource in the index and check each AST node if it has a cross reference to one of the URI in the <code>Target URIs</code>.
+However, this is too expensive because potentially all resources in the index have to be loaded.
+We need some way to quickly decide for a resource description if the corresponding resource may potentially contain the references before actually loading it for a more thorough search.
+This is done using two pieces of information:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>typesOrModulesToFind</code>: the set containing the fully qualified names of the <code>type</code> and <code>module</code> of the declaration to be searched. This set is calculated in the class <code>TargetURIKey</code>.</p>
+</li>
+<li>
+<p><code>imported names</code>: the set exposed by <code>ResourceDescription</code> that contains the types needed by the underlying resource. The implementation for calculating imported names can be found in the class <code>N4JSResourceDescription</code>.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>In our example, supposed that we are finding references for <code>class B</code>. The <code>typesOrModulesToFind</code> contains fully qualified names to <code>N4ClassDeclaration B</code> and <code>module B</code>, i.e. <code>B.B</code> and <code>B</code>.
+The <code>imported names</code> of the resource description of <code>A.n4js</code> contains fully qualified names to <code>module B</code>, <code>class B</code>, i.e. <code>B</code> and <code>B.B</code>.
+Since the set of imported names of <code>A.n4js</code> contains elements in <code>typesOrModulesToFind</code>, this resource is searched thoroughly for references.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_step-4-search-references-in-resource"><a class="anchor" href="#_step-4-search-references-in-resource"></a><a class="link" href="#_step-4-search-references-in-resource">11.6.2.4. Step 4: Search References in Resource</a></h5>
+<div class="paragraph">
+<p>If a resource is considered as a candidate for a more thorough search in Step 3, it is loaded.
+Its AST is traversed and at each AST node we check if there is a cross reference to one of the Target URIs (Step 1).
+If yes, the AST node is collected in the set of found references.
+See class <code>ConcreteSyntaxAwareReferenceFinder</code> for implementation details.</p>
+</div>
+<div class="paragraph">
+<p>The UI dependent logic may apply additional filters to drop references that are not relevant to the user, e.g. the reference from an AST element to its inferred type and vice versa (see <code>N4JSReferenceQueryExecutor.isToBeIgnored(EReference)</code>).</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_limitations-and-possible-enhancements"><a class="anchor" href="#_limitations-and-possible-enhancements"></a><a class="link" href="#_limitations-and-possible-enhancements">11.6.2.5. Limitations and Possible Enhancements</a></h5>
+<div class="paragraph">
+<p>Other noteworthy limitations and potential enhancements of the current implementations are:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Semantics: Only references that are available in the model as real references are reported. Even though <code>getB()</code> in <code>myA.getB().getC()</code> may return an instance of type <code>B</code>, there is no reference reported to B in that expression, though a reference to a member of B would be reported for <code>getC</code>.</p>
+</li>
+<li>
+<p>Visibility constraints are not applied and thus do not reduce the search scope to allow the report of invalidly established references in a later validation.</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div id="footer">
+<div id="footer-text">
+Version 0.9<br>
+Last updated 2019-08-07 15:02:40 CEST
+</div>
+</div>
+<!-- ************* docinfo-footer *************************************************************** -->
+<div class="Grid social" style="color:#d5dfea">
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <h2>Quick Links</h2>
+    <ul>
+      <li><a href="../downloads.html">Download</a></li>
+      <li><a href="../userguides/index.html">Documentation</a></li>
+      <li><a href="https://github.com/eclipse/n4js/">Source</a></li>
+      <li><a href="https://github.com/eclipse/n4js/issues">Issues</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="https://www.eclipse.org/forums/index.php/f/365/">Forum</a></li>
+      <li><a href="http://n4js.blogspot.de/">Blog</a></li>
+      <li><a href="https://dev.eclipse.org/mailman/listinfo/n4js-dev">Mailing List</a></li>
+      <li><a href="https://projects.eclipse.org/projects/technology.n4js">Eclipse Project Page</a></li>
+      <li><a href="https://twitter.com/n4jsdev">Tweets by n4jsdev</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="http://www.eclipse.org/">Eclipse Home</a></li>
+      <li><a href="http://www.eclipse.org/legal/privacy.php">Privacy Policy</a></li>
+      <li><a href="http://www.eclipse.org/legal/termsofuse.php">Terms of Use</a></li>
+      <li><a href="http://www.eclipse.org/legal/copyright.php">Copyright Agent</a></li>
+      <li><a href="http://www.eclipse.org/legal/">Legal</a></li>
+    </ul>
+  </div>
+  <div style="clear: both; height: 0; overflow: hidden;"></div>
+</div>
+
+<!-- ************* UI Scripts ************* -->
+<script type="text/javascript" src="scripts/back-to-top.js"></script>
+
+<script type="text/javascript" src="scripts/treeview.js"></script>
+<script type="text/javascript" src="scripts/toc.js"></script>
+
+<!-- ************* Prism.js Syntax Highlighting ************* -->
+<script src="scripts/prism.js"></script>
+
+<script type="text/javascript">
+	// Add the 'toclist' id for search function
+	$(".toc2 > ul").attr('id', 'toclist');
+	// Generate a Search input form
+	$("#toclist > li:first-of-type").before('<input type="text" id="pagesearch" onkeyup="search()" placeholder="Search for section...">');
+	$("#toclist > li:first-of-type").before('<i id="clear" class="fa fa-times-circle-o"></i>');
+	$("#clear").click(function(){
+	    $("#pagesearch").val('');
+	    search();
+	    $('.toc2 > ul').treeView('collapseAll');
+	});
+	// intialize Treeview.js
+	$(".toc2 > ul").treeView();
+	// Initialize Scrollspy
+</script>
+<!-- ************* docinfo-footer *************************************************************** -->
+</body>
+</html>
\ No newline at end of file
diff --git a/design/release_engineering.html b/design/release_engineering.html
new file mode 100644
index 0000000..8f98ae5
--- /dev/null
+++ b/design/release_engineering.html
@@ -0,0 +1,1399 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="generator" content="Asciidoctor 1.5.5">
+<meta name="author" content="2019-08-07 15:02:40 CEST">
+<title>N4JS Design Specification</title>
+<link rel="stylesheet" href="styles/spec.min.css">
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.6.3/css/font-awesome.min.css">
+<!-- ************* docinfo ******************************************************************* -->
+
+
+<!-- ************* Favicon ************-->
+<link rel="icon" href="images/favicon.ico" />
+
+<!-- ************* Back-to-top JQuery ************* -->
+<script src="https://code.jquery.com/jquery-1.12.4.js"></script>
+<script src="https://code.jquery.com/ui/1.12.0/jquery-ui.js"></script>
+
+
+<link href="styles/prism.min.css" rel="stylesheet" />
+<script type="text/javascript" async
+  src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2/MathJax.js?config=TeX-MML-AM_CHTML">
+</script>
+
+<!-- ************* Styles ************* -->
+<link rel="stylesheet" type="text/css" href="styles/n4jsspec-adoc.css">
+
+
+<!-- ****************** NavBar ****************** -->
+<div id="menubar">
+	<div class="banner">
+        <a href="https://www.eclipse.org/n4js/#"><img id="logo" src="images/n4js-logo.png" alt="Eclipse N4JS"></a>
+    </div>
+<ul>
+  <li><a href="index.html">Index</a></li>
+</ul>
+</div>
+<!-- ************* docinfo ******************************************************************* -->
+<style>
+      .admonitionblock td.icon .icon-todo:before{content:"\f249";color:#f4ee42}
+    </style>
+</head>
+<body class="book toc2 toc-left">
+<div id="header">
+<h1>N4JS Design Specification</h1>
+<div class="details">
+<span id="author" class="author">2019-08-07 15:02:40 CEST</span><br>
+<span id="revnumber">version 0.9</span>
+</div>
+<div id="toc" class="toc2">
+<div id="toctitle">Table of Contents</div>
+<ul class="sectlevel1">
+<li><a href="introduction.html#_introduction">1. Introduction</a>
+<ul class="sectlevel2">
+<li><a href="introduction.html#notation">1.1. Notation</a></li>
+<li><a href="introduction.html#sec:IDE_Overview">1.2. IDE Components</a>
+<ul class="sectlevel3">
+<li><a href="introduction.html#sec:Naming_Conventions">1.2.1. Naming Conventions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="eclipse_setup.html#_eclipse-setup">2. Eclipse Setup</a>
+<ul class="sectlevel2">
+<li><a href="eclipse_setup.html#_system-requirements">2.1. System Requirements</a></li>
+<li><a href="eclipse_setup.html#_contribute">2.2. Contribute</a>
+<ul class="sectlevel3">
+<li><a href="eclipse_setup.html#_eclipse-installer">2.2.1. Eclipse Installer</a>
+<ul class="sectlevel4">
+<li><a href="eclipse_setup.html#_changing-the-setup-script">2.2.1.1. Changing the Setup Script</a></li>
+</ul>
+</li>
+<li><a href="eclipse_setup.html#_manual-ide-configuration">2.2.2. Manual IDE Configuration</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#_release-engineering">3. Release Engineering</a>
+<ul class="sectlevel2">
+<li><a href="#_nightly-build-on-eclipse-infrastructure">3.1. Nightly build on Eclipse infrastructure</a></li>
+<li><a href="#_build-the-n4js-ide-from-command-line">3.2. Build the N4JS IDE from command line</a>
+<ul class="sectlevel3">
+<li><a href="#_publish-maven-tooling-code-org-eclipse-n4js-releng-util-code">3.2.1. Publish maven-tooling <code>org.eclipse.n4js.releng.util</code></a></li>
+<li><a href="#sec:test-verdaccio">3.2.2. Test Verdaccio containing n4js-libs</a></li>
+<li><a href="#_generation-of-eclipse-help-for-spec-and-design-document">3.2.3. Generation of Eclipse help for spec and design document</a></li>
+</ul>
+</li>
+<li><a href="#_updating-frameworks-and-dependencies">3.3. Updating frameworks and dependencies</a>
+<ul class="sectlevel3">
+<li><a href="#_update-of-eclipse-emf-xtext-etc">3.3.1. Update of Eclipse, EMF, Xtext, etc.</a></li>
+<li><a href="#_update-of-the-embedded-jre">3.3.2. Update of the embedded JRE</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tips_and_tricks.html#_tips-and-tricks">4. Tips and Tricks</a>
+<ul class="sectlevel2">
+<li><a href="tips_and_tricks.html#_naming">4.1. Naming</a></li>
+<li><a href="tips_and_tricks.html#_logging">4.2. Logging</a></li>
+<li><a href="tips_and_tricks.html#_cancellation-handling">4.3. Cancellation Handling</a></li>
+<li><a href="tips_and_tricks.html#_caching">4.4. Caching</a></li>
+<li><a href="tips_and_tricks.html#_dependency-injection">4.5. Dependency Injection</a></li>
+<li><a href="tips_and_tricks.html#_miscellaneous">4.6. Miscellaneous</a></li>
+</ul>
+</li>
+<li><a href="parser.html#_parser">5. Parser</a>
+<ul class="sectlevel2">
+<li><a href="parser.html#sec:Parser_Overview">5.1. Overview</a></li>
+<li><a href="parser.html#sec:N4JS_Parser">5.2. N4JS Parser</a></li>
+<li><a href="parser.html#sec:Parser_Generation_Post_Processing">5.3. Parser Generation Post-Processing</a>
+<ul class="sectlevel3">
+<li><a href="parser.html#sec:Automatic_Semicolon_Insertion">5.3.1. Automatic Semicolon Insertion</a>
+<ul class="sectlevel4">
+<li><a href="parser.html#sec:Injected_code_in_the_Antlr_grammar_file">5.3.1.1. Injected code in the Antlr grammar file</a></li>
+<li><a href="parser.html#sec:Customized_error_recovery">5.3.1.2. Customized error recovery</a></li>
+</ul>
+</li>
+<li><a href="parser.html#sec:_No_line_terminator_allowed_here__handling">5.3.2. Async and <code>No line terminator allowed here</code> Handling</a></li>
+<li><a href="parser.html#sec:Regular_Expression">5.3.3. Regular Expression</a></li>
+<li><a href="parser.html#sec:Unicode">5.3.4. Unicode</a></li>
+<li><a href="parser.html#sec:Literals">5.3.5. Literals</a></li>
+</ul>
+</li>
+<li><a href="parser.html#sec:Modifiers">5.4. Modifiers</a></li>
+<li><a href="parser.html#sec:Conflict_Resolutions">5.5. Conflict Resolutions</a>
+<ul class="sectlevel3">
+<li><a href="parser.html#sec:Reserved_Keywords_vs__Identifier_Names">5.5.1. Reserved Keywords vs. Identifier Names</a></li>
+<li><a href="parser.html#sec:Operators_and_Generics">5.5.2. Operators and Generics</a></li>
+</ul>
+</li>
+<li><a href="parser.html#sec:Content_Assist_Parser">5.6. Content-Assist Parser</a></li>
+</ul>
+</li>
+<li><a href="type_system.html#_type-system">6. Type System</a>
+<ul class="sectlevel2">
+<li><a href="type_system.html#sec:Type_Model_and_Grammar">6.1. Type Model and Grammar</a>
+<ul class="sectlevel3">
+<li><a href="type_system.html#sec:Type_Model_Overview">6.1.1. Type Model Overview</a></li>
+<li><a href="type_system.html#sec:Built_in_Types">6.1.2. Built-in and Primitive Types</a></li>
+<li><a href="type_system.html#sec:Type_Model_DSL">6.1.3. Type Model DSL</a></li>
+</ul>
+</li>
+<li><a href="type_system.html#sec:Type_System_Implementation">6.2. Type System Implementation</a></li>
+<li><a href="type_system.html#sec:Type_Inference_combined_with_AST_Traversal">6.3. Type Inference of AST</a>
+<ul class="sectlevel3">
+<li><a href="type_system.html#sec:Type_Inference_combined_with_AST_Traversal__Background">6.3.1. Background</a></li>
+<li><a href="type_system.html#sec:Triggering_Type_Inference_of_AST">6.3.2. Triggering</a></li>
+<li><a href="type_system.html#sec:Traversal_Order_During_Type_Inference_of_AST">6.3.3. Traversal Order</a></li>
+<li><a href="type_system.html#sec:Cross_References_During_Type_Inference_of_AST">6.3.4. Cross-References</a></li>
+<li><a href="type_system.html#sec:Function_Accessor_Bodies_During_Type_Inference_of_AST">6.3.5. Function/Accessor Bodies</a></li>
+<li><a href="type_system.html#sec:Poly_Expressions_During_Type_Inference_of_AST">6.3.6. Poly Expressions</a></li>
+<li><a href="type_system.html#sec:Constraint_Solver_used_During_Type_Inference_of_AST">6.3.7. Constraint Solver</a></li>
+<li><a href="type_system.html#sec:Type_Guards_During_Type_Inference_of_AST">6.3.8. Type Guards</a></li>
+</ul>
+</li>
+<li><a href="type_system.html#sec:Structural_Typing">6.4. Structural Typing</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#_type-index">7. Type Index</a>
+<ul class="sectlevel2">
+<li><a href="type_index.html#sec:Type_Index_Design_Rationale">7.1. Design Rationale</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#sec:Getting_the_Xtext_Index_Content_IResourceDescriptions">7.1.1. Getting the Xtext Index (<code>IResourceDescriptions</code>) Content</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#sec:Design_Overview">7.2. Design Overview</a></li>
+<li><a href="type_index.html#sec:N4JS_Resource_Load_States">7.3. N4JS Resource Load States</a></li>
+<li><a href="type_index.html#sec:Type_Builder">7.4. Types Builder</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#sec:Type_Inference_not_allowed_in_Type_Builder">7.4.1. Type Inference not allowed in Types Builder</a></li>
+<li><a href="type_index.html#sec:ComputedTypeReferences">7.4.2. Deferred Type References</a></li>
+<li><a href="type_index.html#sec:Use_cases_of_ComputedTypeRef">7.4.3. Use cases of DeferredTypeRef</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#sec:Incremental_Builder_Overview">7.5. Incremental Builder (Overview)</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#sec:Incremental_Builder_Overview__XtextBuilder">7.5.1. XtextBuilder</a></li>
+<li><a href="type_index.html#sec:Incremental_Builder_Overview__IBuilderState">7.5.2. IBuilderState</a>
+<ul class="sectlevel4">
+<li><a href="type_index.html#copy-and-update-xtext-index">7.5.2.1. Copy and Update Xtext Index</a></li>
+<li><a href="type_index.html#build-state-setup-phase">7.5.2.2. Build State Setup Phase</a></li>
+<li><a href="type_index.html#process-queued-uris">7.5.2.3. Process Queued URIs</a></li>
+<li><a href="type_index.html#queueing-affected-resources">7.5.2.4. Queueing Affected Resources</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#sec:Incremental_Builder_Overview__Example">7.5.3. Example</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#dirty-state-handling">7.6. Dirty state handling</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#use-case-restoring-types-from-user-data">7.6.1. Use case: Restoring types from user data</a></li>
+<li><a href="type_index.html#use-case-updating-the-xtext-index">7.6.2. Use case: Updating the Xtext index</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="project_model.html#_project-model">8. Project Model</a>
+<ul class="sectlevel2">
+<li><a href="project_model.html#sec:Package_json">8.1. Package.json File</a></li>
+<li><a href="project_model.html#_accessing-project-information">8.2. Accessing Project Information</a>
+<ul class="sectlevel3">
+<li><a href="project_model.html#sec:IN4JSCore">8.2.1. IN4JSCore</a></li>
+<li><a href="project_model.html#sec:N4JSModel">8.2.2. N4JSModel</a></li>
+<li><a href="project_model.html#sec:N4JSWorkspace">8.2.3. N4JSWorkspace</a></li>
+<li><a href="project_model.html#sec:N4JSProject">8.2.4. N4JSProject</a></li>
+<li><a href="project_model.html#sec:SourceContainer">8.2.5. SourceContainer</a></li>
+<li><a href="project_model.html#sec:N4JSProjectsStateHelper">8.2.6. N4JSProjectsStateHelper</a></li>
+</ul>
+</li>
+<li><a href="project_model.html#sec:Caching">8.3. Caching</a>
+<ul class="sectlevel3">
+<li><a href="project_model.html#_caching-of-externallibraryworkspace">8.3.1. Caching of ExternalLibraryWorkspace</a></li>
+<li><a href="project_model.html#_caching-of-n4jsprojectsstatehelper">8.3.2. Caching of N4JSProjectsStateHelper</a></li>
+</ul>
+</li>
+<li><a href="project_model.html#sec:WildcardPathFilter">8.4. WildcardPathFilter</a></li>
+<li><a href="project_model.html#sec:ProjectUtils">8.5. ProjectUtils</a></li>
+</ul>
+</li>
+<li><a href="binding.html#_binding">9. Binding</a>
+<ul class="sectlevel2">
+<li><a href="binding.html#sec:Binding_Design_Rationale">9.1. Design Rationale</a></li>
+<li><a href="binding.html#sec:Binding_to_Members">9.2. Binding to Members</a></li>
+<li><a href="binding.html#sec:Binding_Getter_Setter">9.3. Getter / Setter Binding</a></li>
+<li><a href="binding.html#chap:Statics">9.4. Static Member Binding</a></li>
+<li><a href="binding.html#sec:Binding_Enumeration">9.5. Enumeration Literals Binding</a></li>
+<li><a href="binding.html#sec:Accessibility_of_types_and_members">9.6. Accessibility of types and members</a></li>
+<li><a href="binding.html#sec:Member_Scope_Example">9.7. Member Scope Example</a></li>
+<li><a href="binding.html#sec:Scoping_for_Members_of_Composed_Type_Explained">9.8. Scoping for Members of Composed Type (Union/Intersection) Example</a></li>
+<li><a href="binding.html#sec:Binding_of_Structurally_References_Types">9.9. Structurally References Types</a></li>
+<li><a href="binding.html#sec:Building">9.10. Building</a>
+<ul class="sectlevel3">
+<li><a href="binding.html#sec:Build_Phases">9.10.1. Build Phases</a></li>
+<li><a href="binding.html#sec:Build_Scenarios">9.10.2. Build Scenarios</a></li>
+<li><a href="binding.html#sec:Lazy_linking_problem">9.10.3. Lazy linking problem</a></li>
+</ul>
+</li>
+<li><a href="binding.html#sec:Proxies_and_Proxy_Resolution">9.11. Proxies and Proxy Resolution (Overview)</a>
+<ul class="sectlevel3">
+<li><a href="binding.html#xtexts-lazy-linking-proxies">9.11.1. Xtext’s Lazy Linking Proxies</a></li>
+<li><a href="binding.html#standard-emf-proxies">9.11.2. Standard EMF Proxies</a></li>
+<li><a href="binding.html#_how-is-proxy-resolution-triggered">9.11.3. How is Proxy Resolution Triggered?</a></li>
+<li><a href="binding.html#_when-is-proxy-resolution-allowed">9.11.4. When is Proxy Resolution Allowed?</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="validation.html#_validation">10. Validation</a>
+<ul class="sectlevel2">
+<li><a href="validation.html#sec:validation_overview">10.1. Validation overview</a></li>
+<li><a href="validation.html#sec:validation_control_flow">10.2. Validation control flow</a></li>
+<li><a href="validation.html#sec:validation_issue_ids">10.3. Issue IDs and Messages</a></li>
+<li><a href="validation.html#sec:validation_usage_patterns">10.4. Usage Pattern</a></li>
+<li><a href="validation.html#sec:validation_links">10.5. Links</a></li>
+</ul>
+</li>
+<li><a href="references.html#_references">11. References</a>
+<ul class="sectlevel2">
+<li><a href="references.html#sec:usecases">11.1. Use cases</a></li>
+<li><a href="references.html#sec:calculation_algorithm">11.2. Calculation algorithm</a>
+<ul class="sectlevel3">
+<li><a href="references.html#sec:Xtext_default_implementation">11.2.1. Xtext default implementation</a></li>
+<li><a href="references.html#sec:N4_implementation">11.2.2. N4JS implementation</a></li>
+</ul>
+</li>
+<li><a href="references.html#sec:PerformanceOfDependencyCalculation">11.3. Performance Of Dependency Calculation</a></li>
+<li><a href="references.html#sec:kinds_of_references">11.4. Kinds of references</a>
+<ul class="sectlevel3">
+<li><a href="references.html#sec:Cross_References_to_be_ignored">11.4.1. Cross References to be ignored</a></li>
+<li><a href="references.html#sec:Cross_References_to_be_handled">11.4.2. Cross References to be handled</a></li>
+</ul>
+</li>
+<li><a href="references.html#sec:transitive_dependencies">11.5. Transitive dependencies</a></li>
+<li><a href="references.html#sec:find-references">11.6. Find references</a>
+<ul class="sectlevel3">
+<li><a href="references.html#_background">11.6.1. Background</a></li>
+<li><a href="references.html#_how-find-references-work">11.6.2. How Find References Work</a>
+<ul class="sectlevel4">
+<li><a href="references.html#_step-1-convert-cursor-position-to-declared-element">11.6.2.1. Step 1: Convert Cursor Position to Declared Element</a></li>
+<li><a href="references.html#_step-2-convert-declared-element-to-target-uris">11.6.2.2. Step 2: Convert Declared Element to Target URIs</a></li>
+<li><a href="references.html#_step-3-filter-potential-resources">11.6.2.3. Step 3: Filter Potential Resources</a></li>
+<li><a href="references.html#_step-4-search-references-in-resource">11.6.2.4. Step 4: Search References in Resource</a></li>
+<li><a href="references.html#_limitations-and-possible-enhancements">11.6.2.5. Limitations and Possible Enhancements</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="compilation.html#_compilation">12. Compilation</a>
+<ul class="sectlevel2">
+<li><a href="compilation.html#chap:compilation">12.1. Introduction</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:general_design_rationals">12.1.1. General design rationals</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:logging_and_error_reporting">12.1.1.1. Logging and error reporting</a></li>
+<li><a href="compilation.html#sec:progress_monitor">12.1.1.2. Progress monitor</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Xtext_Integration">12.1.2. Xtext Integration</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:xtext_default_behaviour">12.1.2.1. Xtext default behaviour</a></li>
+<li><a href="compilation.html#sec:n4js_requirements">12.1.2.2. N4JS requirements</a></li>
+<li><a href="compilation.html#sec:compiler_discovery_in_ui">12.1.2.3. Compiler discovery in UI</a></li>
+<li><a href="compilation.html#sec:compiler_discovery_in_headless">12.1.2.4. Compiler discovery in headless</a></li>
+<li><a href="compilation.html#sec:general_generator_implementation">12.1.2.5. General generator implementation</a></li>
+<li><a href="compilation.html#sec:general_generator_activation">12.1.2.6. General generator activation</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Overview_of_Input_Models">12.1.3. Overview of the Input Models</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Core_Generator">12.2. Generators</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:Compiler_Components">12.2.1. Generator Components</a></li>
+<li><a href="compilation.html#sec:Generator_architecture">12.2.2. Generator architecture</a></li>
+<li><a href="compilation.html#sec:Unified_Compiler_Configuration">12.2.3. Unified Compiler Configuration</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Transpilers">12.3. Transpilers</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:Phases">12.3.1. Overview</a></li>
+<li><a href="compilation.html#relation-between-ast-and-im">12.3.2. Relation between AST and IM</a></li>
+<li><a href="compilation.html#implementation-overview">12.3.3. Implementation Overview</a></li>
+<li><a href="compilation.html#sec:Guidelines_for_Implementing_Transformations">12.3.4. Guidelines for Implementing Transformations</a></li>
+<li><a href="compilation.html#symbol-table-in-the-im">12.3.5. Symbol Table in the IM</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:N4JS_to_EcmaScript_Transpiler">12.4. N4JS-to-EcmaScript Transpiler</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:Overview_of_Transformations">12.4.1. Overview of Transformations</a></li>
+<li><a href="compilation.html#sec:Transpiling_members">12.4.2. Transpiling members</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:Transpiling_members__Delegating_members">12.4.2.1. Techniques for special member handling</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__Partial_shadowing_of_getter_setter_pairs">12.4.2.2. Partial shadowing</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__Consuming_or_inheriting_members_of_an_interface">12.4.2.3. Consuming or inheriting members of an interface</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__Static_polyfill">12.4.2.4. Static polyfill</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__API_implementation_stubs">12.4.2.5. API / implementation stubs</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Support_for_incomplete_API_implementation_testing_in_the_N4JS_to_EcmaScript_5_Transpiler">12.4.3. Support for incomplete API implementation testing</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:Modifications_in_Impl_projects">12.4.3.1. Modifications in Impl projects</a></li>
+<li><a href="compilation.html#sec:Implementation_of_stub_generation">12.4.3.2. Implementation of stub-generation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:n4jsc_Headless_Compiler_Interface">12.5. n4jsc Headless Compiler Interface</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:building_the_headless_compiler">12.5.1. building the headless compiler</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="execution.html#_execution">13. Execution</a>
+<ul class="sectlevel2">
+<li><a href="execution.html#sec:N4JS_Project_Execution_And_Linking_Model">13.1. N4JS Project Execution And Linking Model</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#subsec:N4JS_Execution_With_NodeJS">13.1.1. N4JS Execution With NodeJS</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:N4JS_Execution_And_Linking_File">13.2. N4JS Execution And Linking File</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#subsec:NodeJS_Specific_ELF">13.2.1. NodeJS Specific ELF</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Runners-execution">13.3. Runners</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#subsec:N4_Runtime_Environments_Convention">13.3.1. N4 Runtime Environments Convention</a></li>
+<li><a href="execution.html#subsec:Passing_Information_from_IDE_to_Execution_Code_in_Runtime_Environment">13.3.2. Passing Information from IDE to Execution Code in Runtime Environment</a></li>
+<li><a href="execution.html#subsec:Runners_Design">13.3.3. Runners Design</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Legacy_Execution_Engine">13.4. Legacy Execution Engine</a></li>
+<li><a href="execution.html#sec:Design">13.5. Design</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#sec:Usage_Outside_N4JSIDE">13.5.1. Usage Outside N4JSIDE</a>
+<ul class="sectlevel4">
+<li><a href="execution.html#sec:Use_Node_with_Maven">13.5.1.1. Use Node with Maven</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Usage_Inside_N4JSIDE">13.5.2. Usage Inside N4JSIDE</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Runtime_Injection">13.6. Runtime Injection</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#sec:Running_String_Code">13.6.1. Running String Code</a></li>
+<li><a href="execution.html#sec:Running_File_Code">13.6.2. Running File Code</a></li>
+<li><a href="execution.html#sec:Injection_Code_Example">13.6.3. Injection Code Example</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#_tests">14. Tests</a>
+<ul class="sectlevel2">
+<li><a href="tests.html#sec:Performance_Tests">14.1. Performance Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Synthetic_Performance_Tests">14.1.1. Synthetic Performance Tests</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:Design_of_Generator">14.1.1.1. Design of Generator</a></li>
+<li><a href="tests.html#sec:Design_of_Performance_Test_Execution">14.1.1.2. Design of Performance Test Configuration and Execution</a></li>
+<li><a href="tests.html#sec:JUnit_Configuration">14.1.1.3. JUnit Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Test_Configuration">14.1.1.4. JUnitBenchmark Test Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Report_Configuration">14.1.1.5. JUnitBenchmark Report Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Run_Configuration">14.1.1.6. JUnitBenchmark Run Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Example">14.1.1.7. JUnitBenchmark Example</a></li>
+<li><a href="tests.html#sec:Note_on_Jenkins_Job">14.1.1.8. Note on Jenkins Job</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#sec:ECMA_Tests">14.2. ECMA Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Grammar_Tests">14.2.1. Grammar Tests</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:Negative_Tests">14.2.1.1. Negative Tests</a></li>
+<li><a href="tests.html#sec:Test_Exclusion">14.2.1.2. Test Exclusion</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Integration_Tests">14.3. Integration Tests</a></li>
+<li><a href="tests.html#sec:Test_Helpers">14.4. Test Helpers</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Parameterized_N4JS_Tests">14.4.1. Parameterized N4JS tests</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:ParameterizedXtextRunner">14.4.1.1. ParameterizedXtextRunner</a></li>
+<li><a href="tests.html#sec:TestCodeProvider">14.4.1.2. TestCodeProvider</a></li>
+<li><a href="tests.html#sec:Example_Of_Parameterized_Parser_Test">14.4.1.3. Example of parameterized parser test</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Issue_Suppression">14.5. Issue Suppression</a></li>
+<li><a href="tests.html#sec:Xpect_Tests">14.6. Xpect Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Xpect_Test_Setup">14.6.1. Xpect Test Setup</a></li>
+<li><a href="tests.html#sec:Xpect_Issue_Suppression">14.6.2. Xpect Issue Suppression</a></li>
+<li><a href="tests.html#sec:Xpect_Provided_Test_Methods">14.6.3. Xpect Provided Test Methods</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#errors">14.6.3.1. errors</a></li>
+<li><a href="tests.html#warnings">14.6.3.2. warnings</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:N4JS_Specific_Xpect_Test_Methods">14.6.4. N4JS Specific Xpect Test Methods</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:XPECT_noerrors">14.6.4.1. noerrors and nowarnings</a></li>
+<li><a href="tests.html#sec:XPECT_scope">14.6.4.2. scope</a></li>
+<li><a href="tests.html#sec:XPECT_scopeWithPosition">14.6.4.3. scopeWithPosition</a></li>
+<li><a href="tests.html#sec:XPECT_scopeWithResource">14.6.4.4. scopeWithResource</a></li>
+<li><a href="tests.html#sec:XPECT_binding">14.6.4.5. binding</a></li>
+<li><a href="tests.html#sec:XPECT_linkedPathname">14.6.4.6. linkedPathname</a></li>
+<li><a href="tests.html#sec:XPECT_type_of">14.6.4.7. type of</a></li>
+<li><a href="tests.html#sec:XPECT_expectedType">14.6.4.8. expectedType</a></li>
+<li><a href="tests.html#sec:XPECT_elementKeyword">14.6.4.9. elementKeyword</a></li>
+<li><a href="tests.html#sec:XPECT_accessModifier">14.6.4.10. accessModifier</a></li>
+<li><a href="tests.html#sec:XPECT_compileResult">14.6.4.11. compileResult</a></li>
+<li><a href="tests.html#sec:XPECT_output">14.6.4.12. output</a></li>
+<li><a href="tests.html#sec:XPECT_outputRegEx">14.6.4.13. outputRegEx</a></li>
+<li><a href="tests.html#sec:XPECT_calculatedAccessModifier">14.6.4.14. calculatedAccessModifier</a></li>
+<li><a href="tests.html#sec:XPECT_spec">14.6.4.15. spec</a></li>
+<li><a href="tests.html#sec:XPECT_deadCode">14.6.4.16. deadCode</a></li>
+<li><a href="tests.html#sec:XPECT_returnOrThrows">14.6.4.17. returnOrThrows</a></li>
+<li><a href="tests.html#sec:XPECT_lint">14.6.4.18. lint</a></li>
+<li><a href="tests.html#sec:XPECT_lintFails">14.6.4.19. lintFails</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:FIXME_Xpect_modifier">14.6.5. FIXME Xpect modifier</a></li>
+<li><a href="tests.html#sec:Expectmatrix_Xpect_Test_Methods">14.6.6. Expectmatrix Xpect tests</a></li>
+<li><a href="tests.html#xpect-lint-tests">14.6.7. Xpect Lint Tests</a></li>
+</ul>
+</li>
+<li><a href="tests.html#xpect-proposal-tests">14.7. Xpect Proposal Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Validation_vs__Non_Validation">14.7.1. Validation vs. Non-Validation</a></li>
+<li><a href="tests.html#sec:General_Proposal_Test_Features">14.7.2. General Proposal Test Features</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:Test_Variables">14.7.2.1. Test Variables</a></li>
+<li><a href="tests.html#sec:Location_and_Selection">14.7.2.2. at – Location and Selection</a></li>
+<li><a href="tests.html#sec:Multi_Line_Expectations_in_Proposal_Tests">14.7.2.3. Multi Line Expectations in Proposal Tests</a></li>
+<li><a href="tests.html#sec:Timeout">14.7.2.4. Timeout and Performance</a></li>
+</ul>
+</li>
+<li><a href="tests.html#proposals-verify-existence-of-proposals">14.7.3. proposals – Verify Existence of Proposals</a></li>
+<li><a href="tests.html#sec:Verify_displayed_string">14.7.4. display – Verify displayed string</a></li>
+<li><a href="tests.html#sec:Apply_Proposal">14.7.5. apply – Apply Proposal</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#resource-application-in-other-files">14.7.5.1. resource – application in other files</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Content_Assist_Cycling">14.7.6. kind – Content Assist Cycling</a></li>
+<li><a href="tests.html#fileValidVerify-validation-status">14.7.7. fileValid – Verify validation status</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Apply_Proposal_And_Execute_Tests">14.8. Apply Proposal And Execute Tests</a></li>
+<li><a href="tests.html#sec:Organize_Imports_Test">14.9. Organize Imports Test</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#organizeimports">14.9.1. organizeImports</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Access_Control_Test">14.10. Access Control Test</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#test-scenarios">14.10.1. Test Scenarios</a></li>
+<li><a href="tests.html#n4js-code-generator">14.10.2. N4JS Code Generator</a></li>
+<li><a href="tests.html#xtext-issue-matcher">14.10.3. Xtext Issue Matcher</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Smoke_Tests">14.11. Smoke Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#how-to-handle-smoke-test-errors">14.11.1. How to handle smoke test errors?</a></li>
+<li><a href="tests.html#smoketester-and-exceptionanalyzer">14.11.2. SmokeTester and ExceptionAnalyzer</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:UI_Tests_with_SWTBot">14.12. UI Tests with SWTBot</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#writing-swtbot-tests">14.12.1. Writing SWTBot Tests</a></li>
+<li><a href="tests.html#running-swtbot-tests">14.12.2. Running SWTBot Tests</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Debugging_UI_Tests">14.13. Debugging UI Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Connecting_to_the_X_server_on_the_build_node">14.13.1. Connecting to the X-server on the build-node</a></li>
+<li><a href="tests.html#sec:Tools_to_investigate_the_java_stack">14.13.2. Tools to investigate the java-stack</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="ui_concepts.html#_ui-concepts">15. UI Concepts</a>
+<ul class="sectlevel2">
+<li><a href="ui_concepts.html#sec:User_Interface_Concepts">15.1. User Interface Concepts</a>
+<ul class="sectlevel3">
+<li><a href="ui_concepts.html#sec:Eclipse_UI_Concepts">15.1.1. Eclipse UI Concepts</a>
+<ul class="sectlevel4">
+<li><a href="ui_concepts.html#sec:Label_Provider">15.1.1.1. Label Provider</a></li>
+<li><a href="ui_concepts.html#sec:Markers">15.1.1.2. Markers</a></li>
+<li><a href="ui_concepts.html#sec:Commands__Toolbar_and_Menus">15.1.1.3. Commands, Toolbar and Menus</a></li>
+<li><a href="ui_concepts.html#sec:Content_Assist">15.1.1.4. Content Assist</a></li>
+<li><a href="ui_concepts.html#sec:Quick_Fixes">15.1.1.5. Quick Fixes</a></li>
+<li><a href="ui_concepts.html#sec:Quick_Assist">15.1.1.6. Quick Assist</a></li>
+<li><a href="ui_concepts.html#sec:Clean_Up_Actions">15.1.1.7. Clean Up Actions</a></li>
+<li><a href="ui_concepts.html#sec:Save_Actions">15.1.1.8. Save Actions</a></li>
+<li><a href="ui_concepts.html#sec:Auto_Edit">15.1.1.9. Auto Edit</a></li>
+<li><a href="ui_concepts.html#sec:Template_Proposals">15.1.1.10. Template Proposals</a></li>
+<li><a href="ui_concepts.html#sec:Outline_View___Quick_Outline">15.1.1.11. Outline View / Quick Outline</a></li>
+<li><a href="ui_concepts.html#sec:Navigator__Package_Explorer__Project_Explorer">15.1.1.12. Navigator, Package Explorer, Project Explorer</a></li>
+<li><a href="ui_concepts.html#sec:Hyperlinking_and_Navigation">15.1.1.13. Hyperlinking and Navigation</a></li>
+<li><a href="ui_concepts.html#sec:Syntax_and_Semantic_Coloring">15.1.1.14. Syntax and Semantic Coloring</a></li>
+<li><a href="ui_concepts.html#sec:Code_Formatter">15.1.1.15. Code Formatter</a></li>
+<li><a href="ui_concepts.html#sec:Wizards">15.1.1.16. Wizards</a></li>
+<li><a href="ui_concepts.html#sec:Cheat_Sheets">15.1.1.17. Cheat Sheets</a></li>
+<li><a href="ui_concepts.html#sec:Context_sensitive_Help">15.1.1.18. Context-sensitive Help</a></li>
+<li><a href="ui_concepts.html#sec:Hovers">15.1.1.19. Hovers</a></li>
+<li><a href="ui_concepts.html#sec:Folding">15.1.1.20. Folding</a></li>
+<li><a href="ui_concepts.html#sec:Customizable_validation___severity">15.1.1.21. Customizable validation / severity</a></li>
+<li><a href="ui_concepts.html#sec:Proposals">15.1.1.22. Proposals</a></li>
+</ul>
+</li>
+<li><a href="ui_concepts.html#sec:Non_Eclipse_UI_Concepts">15.1.2. Non-Eclipse UI Concepts</a>
+<ul class="sectlevel4">
+<li><a href="ui_concepts.html#sec:Overlays">15.1.2.1. Overlays</a></li>
+<li><a href="ui_concepts.html#sec:Goto__Inferred__Type">15.1.2.2. Goto (Inferred) Type</a></li>
+<li><a href="ui_concepts.html#sec:Postfix_Completion">15.1.2.3. Postfix Completion</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="ui_concepts.html#_user-interface-resources">15.2. User Interface Resources</a>
+<ul class="sectlevel3">
+<li><a href="ui_concepts.html#_icons">15.2.1. Icons</a>
+<ul class="sectlevel4">
+<li><a href="ui_concepts.html#_eclipse-platform-icons">15.2.1.1. Eclipse Platform Icons</a></li>
+<li><a href="ui_concepts.html#_n4js-specific-icons">15.2.1.2. N4JS Specific Icons</a></li>
+<li><a href="ui_concepts.html#_high-resolution-icons">15.2.1.3. High Resolution Icons</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="formatting.html#_formatting">16. Formatting</a>
+<ul class="sectlevel2">
+<li><a href="formatting.html#sec:FmtObjective">16.1. Objective</a>
+<ul class="sectlevel3">
+<li><a href="formatting.html#sec:FmtFormatting_Comments">16.1.1. Formatting Comments</a></li>
+</ul>
+</li>
+<li><a href="formatting.html#sec:FmtArchitecture">16.2. Architecture</a>
+<ul class="sectlevel3">
+<li><a href="formatting.html#sec:Implementation_example">16.2.1. Implementation example</a></li>
+</ul>
+</li>
+<li><a href="formatting.html#sec:FmtFormatter_Implementation_Guidelines">16.3. Formatter Implementation Guidelines</a></li>
+<li><a href="formatting.html#sec:FmtConfiguration">16.4. Configuration</a></li>
+<li><a href="formatting.html#sec:FmtUI_Integration">16.5. UI Integration</a></li>
+<li><a href="formatting.html#sec:FmtUnit_Testing_with_Xpect">16.6. Unit Testing with Xpect</a></li>
+</ul>
+</li>
+<li><a href="external_libraries.html#_external-libraries">17. External Libraries</a>
+<ul class="sectlevel2">
+<li><a href="external_libraries.html#sec:Major_Components">17.1. Major Components</a>
+<ul class="sectlevel3">
+<li><a href="external_libraries.html#subsec:External_Resources">17.1.1. External Resources</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Workspace">17.1.2. External Library Workspace</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Preference_Store">17.1.3. External Library Preference Store</a></li>
+<li><a href="external_libraries.html#subsec:npm_Manager">17.1.4. Library Manager</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Builder_Helper">17.1.5. External Library Builder</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Xtext_Index_Persister">17.1.6. External Library Xtext Index Persister</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Preference_Page">17.1.7. External Library Preference Page</a></li>
+</ul>
+</li>
+<li><a href="external_libraries.html#sec:Headless_External_Library_Support">17.2. Headless External Library Support</a>
+<ul class="sectlevel3">
+<li><a href="external_libraries.html#_custom-npm-settings">17.2.1. Custom npm settings</a></li>
+</ul>
+</li>
+<li><a href="external_libraries.html#sec:lmFutureWork">17.3. Future Work</a>
+<ul class="sectlevel3">
+<li><a href="external_libraries.html#subsec:lmMultipleDependencyScope">17.3.1. Multiple Dependency Scope</a></li>
+<li><a href="external_libraries.html#subsec:lmRunTestsFromLibrary">17.3.2. Run Tests from TestLibrary</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="json_support.html#sec:JSON_Support">18. JSON Support</a>
+<ul class="sectlevel2">
+<li><a href="json_support.html#sec:JSON_Parser">18.1. JSON Parser</a>
+<ul class="sectlevel3">
+<li><a href="json_support.html#sec:JSON_Parser_Unicode_Escaping">18.1.1. Escaping Unicode Control Characters in String Literals</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Empty_Text">18.1.2. Empty Text</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Nested_Structures">18.1.3. Nested Structures</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Whitespace">18.1.4. Whitespace</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Comments">18.1.5. Comments</a></li>
+</ul>
+</li>
+<li><a href="json_support.html#sec:JSON_Language_Extensions">18.2. JSON Language Extensions</a>
+<ul class="sectlevel3">
+<li><a href="json_support.html#sec:JSON_Validator_Extensions">18.2.1. JSON Validator Extensions</a>
+<ul class="sectlevel4">
+<li><a href="json_support.html#sec:File_Specitic_Validator_Extensions">18.2.1.1. File-Specific Validator Extensions</a></li>
+<li><a href="json_support.html#sec:JSON_Declarative_JSON_Validator_Extensions">18.2.1.2. Declarative JSON Validator Extensions</a></li>
+</ul>
+</li>
+<li><a href="json_support.html#_json-resource-description-strategy">18.2.2. JSON Resource Description Strategy</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_jsdoc">19. JSDoc</a>
+<ul class="sectlevel2">
+<li><a href="jsdoc.html#sec:Design_Rationale">19.1. Design Rationale</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#_general-design">19.1.1. General Design</a></li>
+<li><a href="jsdoc.html#sec:Type_Expressions">19.1.2. Type Expressions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="docexporter.html#_docexporter">20. DocExporter</a>
+<ul class="sectlevel2">
+<li><a href="docexporter.html#sec:Specification_Exporter">20.1. Specification Exporter</a></li>
+</ul>
+</li>
+<li><a href="rename_refactoring.html#_rename-refactoring">21. Rename Refactoring</a>
+<ul class="sectlevel2">
+<li><a href="rename_refactoring.html#_rename-refactoring-ui-interaction">21.1. Rename Refactoring UI interaction</a></li>
+<li><a href="rename_refactoring.html#_renameelementprocessor-interaction">21.2. RenameElementProcessor interaction</a></li>
+</ul>
+</li>
+<li><a href="flow_graphs.html#chap:flowgraphs">22. Flow Graphs</a>
+<ul class="sectlevel2">
+<li><a href="flow_graphs.html#sec:flowgraphs_overview">22.1. Flow graphs overview</a>
+<ul class="sectlevel3">
+<li><a href="flow_graphs.html#_internal-graph">22.1.1. Internal graph</a></li>
+<li><a href="flow_graphs.html#_optimizations">22.1.2. Optimizations</a></li>
+<li><a href="flow_graphs.html#_api-for-client-analyses">22.1.3. API for client analyses</a>
+<ul class="sectlevel4">
+<li><a href="flow_graphs.html#_mapping-from-internal-to-ast-elements">22.1.3.1. Mapping from internal to AST elements</a></li>
+<li><a href="flow_graphs.html#_graph-visitor">22.1.3.2. Graph visitor</a></li>
+<li><a href="flow_graphs.html#_graph-explorer">22.1.3.3. Graph explorer</a></li>
+<li><a href="flow_graphs.html#_branch-walker">22.1.3.4. Branch walker</a></li>
+<li><a href="flow_graphs.html#_example-1-compute-string-for-each-path">22.1.3.5. Example 1: Compute string for each path</a></li>
+<li><a href="flow_graphs.html#_path-quantor">22.1.3.6. Path quantor</a></li>
+</ul>
+</li>
+<li><a href="flow_graphs.html#_control-flow-analyses">22.1.4. Control flow analyses</a>
+<ul class="sectlevel4">
+<li><a href="flow_graphs.html#_dead-code-analysis">22.1.4.1. Dead code analysis</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="flow_graphs.html#sec:dataflow">22.2. Dataflow</a>
+<ul class="sectlevel3">
+<li><a href="flow_graphs.html#_dataflow-graph">22.2.1. Dataflow graph</a></li>
+<li><a href="flow_graphs.html#_dataflow-analyses">22.2.2. Dataflow analyses</a>
+<ul class="sectlevel4">
+<li><a href="flow_graphs.html#_def-def-def-nothing-analysis">22.2.2.1. Def&#8594;Def / Def&#8594;Nothing analysis</a></li>
+<li><a href="flow_graphs.html#_def-use-decl-analysis">22.2.2.2. Def|Use&#8592;Decl analysis</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="publish_npms.html#sec:publish-npms-to-public">23. Publish npms</a>
+<ul class="sectlevel2">
+<li><a href="publish_npms.html#sec:publish-npms-n4js-maven">23.1. Publish n4js-libs to during  maven build</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Hints">Appendix A: Hints</a>
+<ul class="sectlevel2">
+<li><a href="appendix_a_hints.html#sec:XtextInjection">A.1. Xtext Injection</a>
+<ul class="sectlevel3">
+<li><a href="appendix_a_hints.html#sec:DI_MultipleInjectors_Singletons">A.1.1. Multiple Injectors and Singletons</a>
+<ul class="sectlevel4">
+<li><a href="appendix_a_hints.html#sec:DI_avoid_duplicate_singletons">A.1.1.1. Avoiding duplicate singletons</a>
+<ul class="sectlevel5">
+<li><a href="appendix_a_hints.html#sec:DI_binding_in_shared">A.1.1.1.1. Defining binding in the shared injector</a></li>
+<li><a href="appendix_a_hints.html#sec:DI_binding_in_custom">A.1.1.1.2. Defining binding in the custom injector</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:DI_Hints">A.1.2. Dependency Injection Hints</a>
+<ul class="sectlevel4">
+<li><a href="appendix_a_hints.html#sec:DI_custom_bundle">A.1.2.1. Use DI in custom bundle, use DI with extensions</a>
+<ul class="sectlevel5">
+<li><a href="appendix_a_hints.html#sec:DI_custom_bundle_problem">A.1.2.1.1. Problem</a></li>
+<li><a href="appendix_a_hints.html#sec:DI_custom_bundle_solution">A.1.2.1.2. Solution</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Access_Other_DSL_Injector">A.1.2.2. How do I get the Guice Injector of my language?</a>
+<ul class="sectlevel5">
+<li><a href="appendix_a_hints.html#sec:DSL_Injector_UI_context">A.1.2.2.1. UI context</a></li>
+<li><a href="appendix_a_hints.html#sec:DSL_Injector_Non_UI_context">A.1.2.2.2. Non UI context but with injection context</a></li>
+<li><a href="appendix_a_hints.html#sec:DSL_Injector_Non_UI_non_injection_context">A.1.2.2.3. Non UI context without injection context</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Cancel_Indicator">A.1.2.3. How do I get cancel indicators in different contexts?</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Eclipse">A.2. Eclipse</a>
+<ul class="sectlevel3">
+<li><a href="appendix_a_hints.html#sec:Show_Xtext_Index">A.2.1. Show the current Xtext index</a></li>
+<li><a href="appendix_a_hints.html#sec:Plugin_spy">A.2.2. Plug-in spy</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Maven-hints">A.3. Maven</a>
+<ul class="sectlevel3">
+<li><a href="appendix_a_hints.html#how-to-check-for-maven-mojo-updates">A.3.1. How to check for Maven MOJO updates</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#_module-loading">Appendix B: Module Loading</a>
+<ul class="sectlevel2">
+<li><a href="appendix_b_module_loading.html#sec:Dependency_Management">B.1. Dependency Management</a></li>
+<li><a href="appendix_b_module_loading.html#ecmascript-modules">B.2. ECMAScript Modules</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:ES5_Modules_Systems">B.2.1. ES5 Modules Systems</a></li>
+<li><a href="appendix_b_module_loading.html#sec:ES6_Modules">B.2.2. ES6 Modules</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:ECMAScript_Module_Loaders">B.3. ECMAScript Module Loaders</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:ES6_Module_Loaders">B.3.1. ES6 Module Loaders</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Polyfills_for_ES6_Module_Loaders">B.3.2. Polyfills for ES6 Module Loaders</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:es6_module_loader">B.3.2.1. es6-module-loader</a></li>
+<li><a href="appendix_b_module_loading.html#sec:SystemJS">B.3.2.2. SystemJS</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Demo">B.3.2.3. Demo</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#case-study-typescript">B.4. Case Study : TypeScript</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:ES6_Modules_Support">B.4.1. ES6 Modules Support</a></li>
+<li><a href="appendix_b_module_loading.html#sec:TypeScript_and_Module_Loading">B.4.2. TypeScript and Module Loading</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Cyclic_Dependencies">B.5. Cyclic Dependencies</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:Setup">B.5.1. Setup</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Transpile_and_Execute">B.5.2. Transpile and Execute</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Module_Format___AMD">B.5.2.1. Module Format = AMD</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Module_Format___CommonJS">B.5.2.2. Module Format = CommonJS</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Module_Format___SystemJS">B.5.2.3. Module Format = SystemJS</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Conclusion">B.5.3. Conclusion</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#system.register-as-transpilation-target">B.6. System.register as transpilation target</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:Introduction">B.6.1. Introduction</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:External_Transpilers">B.6.1.1. External Transpilers</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Example_of_a_System_register_module">B.6.1.2. Example of a System.register module</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Structure_of_a_System_register_module">B.6.2. Structure of a System.register module</a></li>
+<li><a href="appendix_b_module_loading.html#_transpilation-hints">B.6.3. Transpilation Hints</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Handling_Imports">B.6.3.1. Handling Imports</a></li>
+<li><a href="appendix_b_module_loading.html#sec:__exportFn__">B.6.3.2. &lt;&lt;exportFn&gt;&gt;</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Handling_Exports">B.6.3.3. Handling Exports</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Examples_w__Circular_Dependencies">B.6.4. Examples w/ Circular Dependencies</a></li>
+<li><a href="appendix_b_module_loading.html#sec:N4JS_Examples_w__Circular_Dependencies">B.6.5. N4JS Examples w/ Circular Dependencies</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Unresolved_Cyclic_Dependencies">B.6.5.1. Unresolved Cyclic Dependencies</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Variables___Functions">B.6.5.2. Examples with Variables &amp; Functions</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Classes">B.6.5.3. Examples with Classes</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Examples_with_SubClassing">B.6.5.4. Examples with SubClassing</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Miscellaneous">B.6.5.5. Miscellaneous</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#_resources">B.6.6. Resources</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:CommonJS_as_transpilation_target">B.7. CommonJS as transpilation target</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#_introduction-2">B.7.1. Introduction</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Transpilation_Hints">B.7.2. Transpilation Hints</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Import_Statements">B.7.2.1. Import Statements</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Export_Statements">B.7.2.2. Export Statements</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Tracking_Live_Bindings">B.7.2.3. Tracking Live Bindings</a></li>
+<li><a href="appendix_b_module_loading.html#sec:A_complete_example">B.7.2.4. A complete example</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#_resources-2">B.7.3. Resources</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_c_license.html#sec:License">Appendix C: License</a></li>
+<li><a href="appendix_d_acronyms.html#sec:Acronyms">Appendix D: Acronyms</a></li>
+<li><a href="appendix_e_bibliography_and_footnotes.html#_bibliography-and-footnotes">Appendix E: Bibliography and Footnotes</a></li>
+</ul>
+</div>
+</div>
+<div id="content"><div class="sect1">
+<h2 id="_release-engineering"><a class="anchor" href="#_release-engineering"></a><a class="link" href="#_release-engineering">3. Release Engineering</a></h2>
+<div class="sectionbody">
+<div class="sect2">
+<h3 id="_nightly-build-on-eclipse-infrastructure"><a class="anchor" href="#_nightly-build-on-eclipse-infrastructure"></a><a class="link" href="#_nightly-build-on-eclipse-infrastructure">3.1. Nightly build on Eclipse infrastructure</a></h3>
+<div class="paragraph">
+<p>The N4JS IDE, headless n4jsc.jar, and the N4JS update site is being built on the Eclipse Common Build
+Infrastructure (CBI). For this purpose the N4JS project is using a dedicated Jenkins instance, referred
+to as a "Jenkins Instance Per Project" (JIPP) in Eclipse CBI documentation. At this time, the N4JS
+project&#8217;s JIPP is running on the "old" infrastructure, not yet using docker. This will be migrated
+at a later point in time.</p>
+</div>
+<div class="paragraph">
+<p>The N4JS JIPP is available at: <a href="https://ci.eclipse.org/n4js/" class="bare">https://ci.eclipse.org/n4js/</a></p>
+</div>
+<div class="paragraph">
+<p>The nightly build performs the following main steps:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>compile the N4JS implementation,</p>
+</li>
+<li>
+<p>build the n4jsc.jar, the IDE products for MacOS, Windows, Linux, and the update site,</p>
+</li>
+<li>
+<p>run tests,</p>
+</li>
+<li>
+<p>sign the IDE product for macOS and package it in a .dmg file,</p>
+</li>
+<li>
+<p>deploy to n4jsc.jar, IDE products and update sites to Eclipse download server (i.e. download.eclipse.org),</p>
+</li>
+<li>
+<p>move all artifacts older than 7 days from download.eclipse.org to archive.eclipse.org.</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>Details about all the above steps can be found in the Jenkinsfile <code>eclipse-nightly.jenkinsfile</code>, located in
+the root folder of the N4JS source repository on GitHub.</p>
+</div>
+<div class="paragraph">
+<p>The most accurate documentation for our JIPP can be found at <a href="https://wiki.eclipse.org/IT_Infrastructure_Doc" class="bare">https://wiki.eclipse.org/IT_Infrastructure_Doc</a>.
+Note that many other documents do not apply to our JIPP, at the moment, as they refer to the new
+infrastructure, e.g. <a href="https://wiki.eclipse.org/CBI" class="bare">https://wiki.eclipse.org/CBI</a> and <a href="https://wiki.eclipse.org/Jenkins" class="bare">https://wiki.eclipse.org/Jenkins</a>.</p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_build-the-n4js-ide-from-command-line"><a class="anchor" href="#_build-the-n4js-ide-from-command-line"></a><a class="link" href="#_build-the-n4js-ide-from-command-line">3.2. Build the N4JS IDE from command line</a></h3>
+<div class="paragraph">
+<p>Ensure you have</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Java 11</p>
+</li>
+<li>
+<p>Maven 3.2.x and</p>
+</li>
+<li>
+<p>Node.js 8</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>installed on your system.</p>
+</div>
+<div class="paragraph">
+<p>Clone the repository</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre>git clone https://github.com/Eclipse/n4js.git</pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Change to the n4js folder:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre>cd n4js</pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Run the Maven build:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre>mvn clean verify</pre>
+</div>
+</div>
+<div class="paragraph">
+<p>You may have to increase the memory for maven via <code>export MAVEN_OPTS="-Xmx2048m"</code> (Unix) or <code>set MAVEN_OPTS="-Xmx2048m"</code> (Windows).</p>
+</div>
+<div class="paragraph">
+<p>Available optional maven profiles are:</p>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+buildProduct
+</td>
+<td class="hdlist2">
+<p>create IDE products (Windows, macOS, Linux) and a jar for headless compilation</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+execute-plugin-tests
+</td>
+<td class="hdlist2">
+<p>run OSGi tests (without UI)</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+execute-plugin-ui-tests
+</td>
+<td class="hdlist2">
+<p>run UI-based OSGi tests</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+execute-ecmas-tests
+</td>
+<td class="hdlist2">
+<p>run ECMA test suite</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+execute-smoke-tests
+</td>
+<td class="hdlist2">
+<p>run generated tests using corrupted source code as input</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+execute-accesscontrol-tests
+</td>
+<td class="hdlist2">
+<p>run generated tests for checking accessibility of class/interface members</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+execute-hlc-integration-tests
+</td>
+<td class="hdlist2">
+<p>run integration tests using the headless jar (requires docker!)</p>
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>Available system properties:</p>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+noTests
+</td>
+<td class="hdlist2">
+<p>suppress execution of all tests</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+startAndKeepVerdaccio
+</td>
+<td class="hdlist2">
+<p>enforce starting and suppress stopping of the test verdaccio (see <a href="#sec:test-verdaccio">Test Verdaccio containing n4js-libs</a>)</p>
+</td>
+</tr>
+</table>
+</div>
+<div class="sect3">
+<h4 id="_publish-maven-tooling-code-org-eclipse-n4js-releng-util-code"><a class="anchor" href="#_publish-maven-tooling-code-org-eclipse-n4js-releng-util-code"></a><a class="link" href="#_publish-maven-tooling-code-org-eclipse-n4js-releng-util-code">3.2.1. Publish maven-tooling <code>org.eclipse.n4js.releng.util</code></a></h4>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title=""></i>
+</td>
+<td class="content">
+For extending the N4JS-language in a different project, the <code>org.eclipse.n4js.releng.util</code> module needs to be published as a maven-plugin. You can deploy this SNAPSHOT-artifact to a local folder by providing the <code>local-snapshot-deploy-folder</code>-property pointing to an absolute path in the local file system:
+</td>
+</tr>
+</table>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre>mvn clean deploy -Dlocal-snapshot-deploy-folder=/var/lib/my/folder/local-mvn-deploy-repository</pre>
+</div>
+</div>
+<div class="paragraph">
+<p>The existence of <code>local-snapshot-deploy-folder</code> will trigger a profile enabling the deploy-goal for the project <code>org.eclipse.n4js.releng.util</code></p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:test-verdaccio"><a class="anchor" href="#sec:test-verdaccio"></a><a class="link" href="#sec:test-verdaccio">3.2.2. Test Verdaccio containing n4js-libs</a></h4>
+<div class="paragraph">
+<p>If profile <code>execute-hlc-integration-tests</code> is active, a local verdaccio instance is started and populated with
+freshly-compiled n4js-libs (the libraries located under top-level folder <code>/n4js-libs</code>) and is stopped before the
+end of the build. The verdaccio instance is started as a docker container called <code>n4js-test-verdaccio</code>.</p>
+</div>
+<div class="paragraph">
+<p>When giving <code>-DstartAndKeepVerdaccio</code> on the command line, such a test verdaccio will always be started/populated but
+never stopped, regardless of whether profile <code>execute-hlc-integration-tests</code> is active or not. This is useful to enforce
+starting of the test verdaccio (even without running integration tests) and then reusing it in subsequent builds.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_generation-of-eclipse-help-for-spec-and-design-document"><a class="anchor" href="#_generation-of-eclipse-help-for-spec-and-design-document"></a><a class="link" href="#_generation-of-eclipse-help-for-spec-and-design-document">3.2.3. Generation of Eclipse help for spec and design document</a></h4>
+<div class="paragraph">
+<p>The HTML pages for N4JSSpec and N4JSDesign documents are generated from the Asciidoc sources in the project <code>org.eclipse.n4js.spec</code> <code>org.eclipse.n4js.design</code> by Asciispec. </p>
+</div>
+<div id="img:eclipse-help-doc-process" class="imageblock">
+<div class="content">
+<img src="chapters/03_releng/images/eclipse-help-process.svg" alt="Creating Eclipse help for N4JSSpec">
+</div>
+<div class="title">Figure 1. The process of creating Eclipse help for N4JSSpec</div>
+</div>
+<div class="paragraph">
+<p>Figure <a href="#img:eclipse-help-doc-process">The process of creating Eclipse help for N4JSSpec</a> shows the generation process for N4JSSpec document. The process for N4JSDesign (and other adoc documents) is the same. The following explains the diagram.</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>Asciispec</code> is used to compile the source N4JSSpec Asciidoc into a single large <code>N4JSSpec.html</code> file which contains all the chapters. The use of the custom parameter <code>-a eclipse-help-mode</code> indicates that a special header and footer styles as well as CSS style should be used (i.e. no table of content menu, no download links etc.). Here, we are using the possibility provided by Asciidoctor to configure header/footer as well as CSS style via parameter <code>:docinfodir:</code> and <code>:stylesheet:</code>.</p>
+</li>
+<li>
+<p>Our custom tool <code>Chunker</code> splits <code>N4JSSpec.html</code> (and other documents) into multiple chunked HTML files, each of which corresponds to either the <code>index</code> file or a chapter. It automatically re-writes internal links.</p>
+</li>
+<li>
+<p>Another custom tool <code>EclipseHelpTOCGenerator</code> takes to Docbook file <code>N4JSSpec.xml</code> and generates an XML file describing the table of content (TOC) in the Eclipse format. This TOC file references the chunked HTML files above.</p>
+</li>
+<li>
+<p>Another custom tool <code>IndexTocGenerator</code> takes to Docbook file <code>N4JSSpec.xml</code> similar to <code>EclipseHelpTOCGenerator</code>, but it generates an HTML fragment which can be embedded into the <code>index.html</code> page generated by the <code>Chunker</code> (Thus it has to run before the Chunker in that case).</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_updating-frameworks-and-dependencies"><a class="anchor" href="#_updating-frameworks-and-dependencies"></a><a class="link" href="#_updating-frameworks-and-dependencies">3.3. Updating frameworks and dependencies</a></h3>
+<div class="sect3">
+<h4 id="_update-of-eclipse-emf-xtext-etc"><a class="anchor" href="#_update-of-eclipse-emf-xtext-etc"></a><a class="link" href="#_update-of-eclipse-emf-xtext-etc">3.3.1. Update of Eclipse, EMF, Xtext, etc.</a></h4>
+<div class="paragraph">
+<p>For updating the N4JS IDE to a new version of Eclipse, EMF, Xtext, etc. follow these steps:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Create a new branch.</p>
+</li>
+<li>
+<p>Bump versions of all dependencies mentioned in file <code>N4JS.setup</code>:</p>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p>Update all labels that refer to the version of the Ooomph setup (search for "label!" to find them).</p>
+</li>
+<li>
+<p>Choose a new Eclipse version and define this in <code>N4JS.setup</code>.</p>
+</li>
+<li>
+<p>For those other dependencies <em>that come with Eclipse</em> (e.g. EMF, Xtext) find out which version matches the chosen Eclipse version
+and define that version in <code>N4JS.setup</code>.<br>
+Tip: use the contents list of the SimRel you are targeting, e.g. <a href="https://projects.eclipse.org/releases/2019-03" class="bare">https://projects.eclipse.org/releases/2019-03</a></p>
+</li>
+<li>
+<p>For those other dependencies <em>that are available via the Eclipse Orbit</em>, find out which version is the latest version available in
+the Orbit and define that version in <code>N4JS.setup</code>.<br>
+Tip: contents of the Eclipse Orbit can be found at <a href="https://download.eclipse.org/tools/orbit/downloads/" class="bare">https://download.eclipse.org/tools/orbit/downloads/</a><br>
+(choose the correct link for the chosen Eclipse version!)</p>
+</li>
+<li>
+<p>For all remaining dependencies (i.e. unrelated to Eclipse and not in Orbit), choose a version to use and define it in <code>N4JS.setup</code>.</p>
+</li>
+</ol>
+</div>
+</li>
+<li>
+<p>Check <code>Require-Bundle</code> sections of MANIFEST.MF files by searching for related bundle names or for <code>;bundle-version="</code>:</p>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p>There should be at most one version constraint for a specific bundle<br>
+NOTE: the version constraints in the MANIFEST.MF files are just lower bounds and - at this time - we do not bump them to the latest version, in most cases.</p>
+</li>
+<li>
+<p>There should be no version constraints to our bundles (i.e. <code>org.eclipse.n4js&#8230;&#8203;</code>)</p>
+</li>
+</ol>
+</div>
+</li>
+<li>
+<p>Review parent pom.xml files, i.e. <code>releng/org.eclipse.n4js.parent/pom.xml</code>:</p>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p>Update property <code>xtext-version</code>.</p>
+</li>
+<li>
+<p>Check all other <code>*-version</code> properties and update them where needed.</p>
+</li>
+</ol>
+</div>
+</li>
+<li>
+<p>Update target platform file <code>org.eclipse.n4js.targetplatform.target</code> using Ooomph&#8217;s auto-generation:</p>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p>Start the Eclipse Installer.</p>
+</li>
+<li>
+<p>Update the Eclipse Installer (using the button with the turning arrows).</p>
+</li>
+<li>
+<p>On the second page, add the <code>N4JS.setup</code> file from your branch to the Eclipse Installer, using a GitHub raw(!) URL:<br>
+<code><a href="https://raw.githubusercontent.com/eclipse/n4js/BRANCH_NAME/releng/org.eclipse.n4js.targetplatform/N4JS.setup" class="bare">https://raw.githubusercontent.com/eclipse/n4js/BRANCH_NAME/releng/org.eclipse.n4js.targetplatform/N4JS.setup</a></code></p>
+</li>
+<li>
+<p>Ooomph a new development environment with this setup.</p>
+</li>
+<li>
+<p>In the new Eclipse workspace created by Ooomph, the target platform file should have uncommitted changes:</p>
+<div class="olist lowerroman">
+<ol class="lowerroman" type="i">
+<li>
+<p>carefully review these changes, to be sure they make sense, and then</p>
+</li>
+<li>
+<p>commit &amp; push those changes to your branch.</p>
+</li>
+</ol>
+</div>
+</li>
+</ol>
+</div>
+</li>
+<li>
+<p>Thoroughly test the new versions, including some manual(!) tests:</p>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p>Run Jenkins builds.</p>
+</li>
+<li>
+<p>Ooomph another N4JS development environment with Eclipse Installer.
+This time, after Ooomphing is completed, the target platform file should no longer have any uncommitted changes.</p>
+</li>
+<li>
+<p>Ensure the following types of tests can be executed locally in the newly installed Eclipse:</p>
+<div class="olist lowerroman">
+<ol class="lowerroman" type="i">
+<li>
+<p>plain JUnit tests (e.g. <code>org.eclipse.n4js.lang.tests</code>).</p>
+</li>
+<li>
+<p>Plugin tests.</p>
+</li>
+<li>
+<p>Plugin UI tests.</p>
+</li>
+<li>
+<p>SWTBot tests.</p>
+</li>
+<li>
+<p>Xpect tests (individual files and entire bundles; e.g. <code>org.eclipse.n4js.spec.tests</code>).</p>
+</li>
+<li>
+<p>Xpect UI tests.</p>
+</li>
+</ol>
+</div>
+</li>
+<li>
+<p>Ensure an N4JS IDE product can be launched from within the newly installed Eclipse using the launch configuration
+provided in the n4js repository.</p>
+</li>
+<li>
+<p>After launching the N4JS IDE product, refresh the workspace and review/commit any changes in file <code>N4JS__IDE.launch</code>.</p>
+</li>
+<li>
+<p>Download a product created in a Jenkins CI build and test it manually.</p>
+</li>
+<li>
+<p>After merging to master: download a product created in a nightly build and test it manually.
+Ensure signing and JRE bundling are still working properly.</p>
+</li>
+</ol>
+</div>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>All the above steps need to be performed in the <code>n4js-n4</code> repository, accordingly (e.g. file <code>N4JS-N4.setup</code>).</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_update-of-the-embedded-jre"><a class="anchor" href="#_update-of-the-embedded-jre"></a><a class="link" href="#_update-of-the-embedded-jre">3.3.2. Update of the embedded JRE</a></h4>
+<div class="paragraph">
+<p>For updating the embedded JRE inside the N4JS IDE follow these steps:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Given a new JRE download location for Linux, MacOS and Windows with a common new version</p>
+</li>
+<li>
+<p>Update the location related properties in the pom.xml files of</p>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p>n4js/builds/pom.xml</p>
+</li>
+<li>
+<p>n4js/builds/org.eclipse.n4js.jre.linux.gtk.x86_64/pom.xml</p>
+</li>
+<li>
+<p>n4js/builds/org.eclipse.n4js.jre.macosx.cocoa.x86_64/pom.xml</p>
+</li>
+<li>
+<p>n4js/builds/org.eclipse.n4js.jre.win32.win32.x86_64/pom.xml</p>
+</li>
+</ol>
+</div>
+</li>
+<li>
+<p>Update the versions at all following locations:</p>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p>n4js/builds/org.eclipse.n4js.jre.linux.gtk.x86_64/META-INF/MANIFEST.MF</p>
+</li>
+<li>
+<p>n4js/builds/org.eclipse.n4js.jre.linux.gtk.x86_64/META-INF/p2.inf</p>
+</li>
+<li>
+<p>n4js/builds/org.eclipse.n4js.jre.macosx.cocoa.x86_64/META-INF/MANIFEST.MF</p>
+</li>
+<li>
+<p>n4js/builds/org.eclipse.n4js.jre.macosx.cocoa.x86_64/META-INF/p2.inf</p>
+</li>
+<li>
+<p>n4js/builds/org.eclipse.n4js.jre.win32.win32.x86_64/META-INF/MANIFEST.MF</p>
+</li>
+<li>
+<p>n4js/builds/org.eclipse.n4js.jre.win32.win32.x86_64/META-INF/p2.inf</p>
+</li>
+</ol>
+</div>
+</li>
+<li>
+<p>Update the openjdk docker image used as base image in the "FROM" line at the top of all docker files:</p>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p>n4js-n4/jenkins/docker-build/Dockerfile</p>
+</li>
+</ol>
+</div>
+</li>
+</ol>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div id="footer">
+<div id="footer-text">
+Version 0.9<br>
+Last updated 2019-08-07 15:02:40 CEST
+</div>
+</div>
+<!-- ************* docinfo-footer *************************************************************** -->
+<div class="Grid social" style="color:#d5dfea">
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <h2>Quick Links</h2>
+    <ul>
+      <li><a href="../downloads.html">Download</a></li>
+      <li><a href="../userguides/index.html">Documentation</a></li>
+      <li><a href="https://github.com/eclipse/n4js/">Source</a></li>
+      <li><a href="https://github.com/eclipse/n4js/issues">Issues</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="https://www.eclipse.org/forums/index.php/f/365/">Forum</a></li>
+      <li><a href="http://n4js.blogspot.de/">Blog</a></li>
+      <li><a href="https://dev.eclipse.org/mailman/listinfo/n4js-dev">Mailing List</a></li>
+      <li><a href="https://projects.eclipse.org/projects/technology.n4js">Eclipse Project Page</a></li>
+      <li><a href="https://twitter.com/n4jsdev">Tweets by n4jsdev</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="http://www.eclipse.org/">Eclipse Home</a></li>
+      <li><a href="http://www.eclipse.org/legal/privacy.php">Privacy Policy</a></li>
+      <li><a href="http://www.eclipse.org/legal/termsofuse.php">Terms of Use</a></li>
+      <li><a href="http://www.eclipse.org/legal/copyright.php">Copyright Agent</a></li>
+      <li><a href="http://www.eclipse.org/legal/">Legal</a></li>
+    </ul>
+  </div>
+  <div style="clear: both; height: 0; overflow: hidden;"></div>
+</div>
+
+<!-- ************* UI Scripts ************* -->
+<script type="text/javascript" src="scripts/back-to-top.js"></script>
+
+<script type="text/javascript" src="scripts/treeview.js"></script>
+<script type="text/javascript" src="scripts/toc.js"></script>
+
+<!-- ************* Prism.js Syntax Highlighting ************* -->
+<script src="scripts/prism.js"></script>
+
+<script type="text/javascript">
+	// Add the 'toclist' id for search function
+	$(".toc2 > ul").attr('id', 'toclist');
+	// Generate a Search input form
+	$("#toclist > li:first-of-type").before('<input type="text" id="pagesearch" onkeyup="search()" placeholder="Search for section...">');
+	$("#toclist > li:first-of-type").before('<i id="clear" class="fa fa-times-circle-o"></i>');
+	$("#clear").click(function(){
+	    $("#pagesearch").val('');
+	    search();
+	    $('.toc2 > ul').treeView('collapseAll');
+	});
+	// intialize Treeview.js
+	$(".toc2 > ul").treeView();
+	// Initialize Scrollspy
+</script>
+<!-- ************* docinfo-footer *************************************************************** -->
+</body>
+</html>
\ No newline at end of file
diff --git a/design/rename_refactoring.html b/design/rename_refactoring.html
new file mode 100644
index 0000000..8b84478
--- /dev/null
+++ b/design/rename_refactoring.html
@@ -0,0 +1,1000 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="generator" content="Asciidoctor 1.5.5">
+<meta name="author" content="2019-08-07 15:02:40 CEST">
+<title>N4JS Design Specification</title>
+<link rel="stylesheet" href="styles/spec.min.css">
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.6.3/css/font-awesome.min.css">
+<!-- ************* docinfo ******************************************************************* -->
+
+
+<!-- ************* Favicon ************-->
+<link rel="icon" href="images/favicon.ico" />
+
+<!-- ************* Back-to-top JQuery ************* -->
+<script src="https://code.jquery.com/jquery-1.12.4.js"></script>
+<script src="https://code.jquery.com/ui/1.12.0/jquery-ui.js"></script>
+
+
+<link href="styles/prism.min.css" rel="stylesheet" />
+<script type="text/javascript" async
+  src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2/MathJax.js?config=TeX-MML-AM_CHTML">
+</script>
+
+<!-- ************* Styles ************* -->
+<link rel="stylesheet" type="text/css" href="styles/n4jsspec-adoc.css">
+
+
+<!-- ****************** NavBar ****************** -->
+<div id="menubar">
+	<div class="banner">
+        <a href="https://www.eclipse.org/n4js/#"><img id="logo" src="images/n4js-logo.png" alt="Eclipse N4JS"></a>
+    </div>
+<ul>
+  <li><a href="index.html">Index</a></li>
+</ul>
+</div>
+<!-- ************* docinfo ******************************************************************* -->
+<style>
+      .admonitionblock td.icon .icon-todo:before{content:"\f249";color:#f4ee42}
+    </style>
+</head>
+<body class="book toc2 toc-left">
+<div id="header">
+<h1>N4JS Design Specification</h1>
+<div class="details">
+<span id="author" class="author">2019-08-07 15:02:40 CEST</span><br>
+<span id="revnumber">version 0.9</span>
+</div>
+<div id="toc" class="toc2">
+<div id="toctitle">Table of Contents</div>
+<ul class="sectlevel1">
+<li><a href="introduction.html#_introduction">1. Introduction</a>
+<ul class="sectlevel2">
+<li><a href="introduction.html#notation">1.1. Notation</a></li>
+<li><a href="introduction.html#sec:IDE_Overview">1.2. IDE Components</a>
+<ul class="sectlevel3">
+<li><a href="introduction.html#sec:Naming_Conventions">1.2.1. Naming Conventions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="eclipse_setup.html#_eclipse-setup">2. Eclipse Setup</a>
+<ul class="sectlevel2">
+<li><a href="eclipse_setup.html#_system-requirements">2.1. System Requirements</a></li>
+<li><a href="eclipse_setup.html#_contribute">2.2. Contribute</a>
+<ul class="sectlevel3">
+<li><a href="eclipse_setup.html#_eclipse-installer">2.2.1. Eclipse Installer</a>
+<ul class="sectlevel4">
+<li><a href="eclipse_setup.html#_changing-the-setup-script">2.2.1.1. Changing the Setup Script</a></li>
+</ul>
+</li>
+<li><a href="eclipse_setup.html#_manual-ide-configuration">2.2.2. Manual IDE Configuration</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="release_engineering.html#_release-engineering">3. Release Engineering</a>
+<ul class="sectlevel2">
+<li><a href="release_engineering.html#_nightly-build-on-eclipse-infrastructure">3.1. Nightly build on Eclipse infrastructure</a></li>
+<li><a href="release_engineering.html#_build-the-n4js-ide-from-command-line">3.2. Build the N4JS IDE from command line</a>
+<ul class="sectlevel3">
+<li><a href="release_engineering.html#_publish-maven-tooling-code-org-eclipse-n4js-releng-util-code">3.2.1. Publish maven-tooling <code>org.eclipse.n4js.releng.util</code></a></li>
+<li><a href="release_engineering.html#sec:test-verdaccio">3.2.2. Test Verdaccio containing n4js-libs</a></li>
+<li><a href="release_engineering.html#_generation-of-eclipse-help-for-spec-and-design-document">3.2.3. Generation of Eclipse help for spec and design document</a></li>
+</ul>
+</li>
+<li><a href="release_engineering.html#_updating-frameworks-and-dependencies">3.3. Updating frameworks and dependencies</a>
+<ul class="sectlevel3">
+<li><a href="release_engineering.html#_update-of-eclipse-emf-xtext-etc">3.3.1. Update of Eclipse, EMF, Xtext, etc.</a></li>
+<li><a href="release_engineering.html#_update-of-the-embedded-jre">3.3.2. Update of the embedded JRE</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tips_and_tricks.html#_tips-and-tricks">4. Tips and Tricks</a>
+<ul class="sectlevel2">
+<li><a href="tips_and_tricks.html#_naming">4.1. Naming</a></li>
+<li><a href="tips_and_tricks.html#_logging">4.2. Logging</a></li>
+<li><a href="tips_and_tricks.html#_cancellation-handling">4.3. Cancellation Handling</a></li>
+<li><a href="tips_and_tricks.html#_caching">4.4. Caching</a></li>
+<li><a href="tips_and_tricks.html#_dependency-injection">4.5. Dependency Injection</a></li>
+<li><a href="tips_and_tricks.html#_miscellaneous">4.6. Miscellaneous</a></li>
+</ul>
+</li>
+<li><a href="parser.html#_parser">5. Parser</a>
+<ul class="sectlevel2">
+<li><a href="parser.html#sec:Parser_Overview">5.1. Overview</a></li>
+<li><a href="parser.html#sec:N4JS_Parser">5.2. N4JS Parser</a></li>
+<li><a href="parser.html#sec:Parser_Generation_Post_Processing">5.3. Parser Generation Post-Processing</a>
+<ul class="sectlevel3">
+<li><a href="parser.html#sec:Automatic_Semicolon_Insertion">5.3.1. Automatic Semicolon Insertion</a>
+<ul class="sectlevel4">
+<li><a href="parser.html#sec:Injected_code_in_the_Antlr_grammar_file">5.3.1.1. Injected code in the Antlr grammar file</a></li>
+<li><a href="parser.html#sec:Customized_error_recovery">5.3.1.2. Customized error recovery</a></li>
+</ul>
+</li>
+<li><a href="parser.html#sec:_No_line_terminator_allowed_here__handling">5.3.2. Async and <code>No line terminator allowed here</code> Handling</a></li>
+<li><a href="parser.html#sec:Regular_Expression">5.3.3. Regular Expression</a></li>
+<li><a href="parser.html#sec:Unicode">5.3.4. Unicode</a></li>
+<li><a href="parser.html#sec:Literals">5.3.5. Literals</a></li>
+</ul>
+</li>
+<li><a href="parser.html#sec:Modifiers">5.4. Modifiers</a></li>
+<li><a href="parser.html#sec:Conflict_Resolutions">5.5. Conflict Resolutions</a>
+<ul class="sectlevel3">
+<li><a href="parser.html#sec:Reserved_Keywords_vs__Identifier_Names">5.5.1. Reserved Keywords vs. Identifier Names</a></li>
+<li><a href="parser.html#sec:Operators_and_Generics">5.5.2. Operators and Generics</a></li>
+</ul>
+</li>
+<li><a href="parser.html#sec:Content_Assist_Parser">5.6. Content-Assist Parser</a></li>
+</ul>
+</li>
+<li><a href="type_system.html#_type-system">6. Type System</a>
+<ul class="sectlevel2">
+<li><a href="type_system.html#sec:Type_Model_and_Grammar">6.1. Type Model and Grammar</a>
+<ul class="sectlevel3">
+<li><a href="type_system.html#sec:Type_Model_Overview">6.1.1. Type Model Overview</a></li>
+<li><a href="type_system.html#sec:Built_in_Types">6.1.2. Built-in and Primitive Types</a></li>
+<li><a href="type_system.html#sec:Type_Model_DSL">6.1.3. Type Model DSL</a></li>
+</ul>
+</li>
+<li><a href="type_system.html#sec:Type_System_Implementation">6.2. Type System Implementation</a></li>
+<li><a href="type_system.html#sec:Type_Inference_combined_with_AST_Traversal">6.3. Type Inference of AST</a>
+<ul class="sectlevel3">
+<li><a href="type_system.html#sec:Type_Inference_combined_with_AST_Traversal__Background">6.3.1. Background</a></li>
+<li><a href="type_system.html#sec:Triggering_Type_Inference_of_AST">6.3.2. Triggering</a></li>
+<li><a href="type_system.html#sec:Traversal_Order_During_Type_Inference_of_AST">6.3.3. Traversal Order</a></li>
+<li><a href="type_system.html#sec:Cross_References_During_Type_Inference_of_AST">6.3.4. Cross-References</a></li>
+<li><a href="type_system.html#sec:Function_Accessor_Bodies_During_Type_Inference_of_AST">6.3.5. Function/Accessor Bodies</a></li>
+<li><a href="type_system.html#sec:Poly_Expressions_During_Type_Inference_of_AST">6.3.6. Poly Expressions</a></li>
+<li><a href="type_system.html#sec:Constraint_Solver_used_During_Type_Inference_of_AST">6.3.7. Constraint Solver</a></li>
+<li><a href="type_system.html#sec:Type_Guards_During_Type_Inference_of_AST">6.3.8. Type Guards</a></li>
+</ul>
+</li>
+<li><a href="type_system.html#sec:Structural_Typing">6.4. Structural Typing</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#_type-index">7. Type Index</a>
+<ul class="sectlevel2">
+<li><a href="type_index.html#sec:Type_Index_Design_Rationale">7.1. Design Rationale</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#sec:Getting_the_Xtext_Index_Content_IResourceDescriptions">7.1.1. Getting the Xtext Index (<code>IResourceDescriptions</code>) Content</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#sec:Design_Overview">7.2. Design Overview</a></li>
+<li><a href="type_index.html#sec:N4JS_Resource_Load_States">7.3. N4JS Resource Load States</a></li>
+<li><a href="type_index.html#sec:Type_Builder">7.4. Types Builder</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#sec:Type_Inference_not_allowed_in_Type_Builder">7.4.1. Type Inference not allowed in Types Builder</a></li>
+<li><a href="type_index.html#sec:ComputedTypeReferences">7.4.2. Deferred Type References</a></li>
+<li><a href="type_index.html#sec:Use_cases_of_ComputedTypeRef">7.4.3. Use cases of DeferredTypeRef</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#sec:Incremental_Builder_Overview">7.5. Incremental Builder (Overview)</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#sec:Incremental_Builder_Overview__XtextBuilder">7.5.1. XtextBuilder</a></li>
+<li><a href="type_index.html#sec:Incremental_Builder_Overview__IBuilderState">7.5.2. IBuilderState</a>
+<ul class="sectlevel4">
+<li><a href="type_index.html#copy-and-update-xtext-index">7.5.2.1. Copy and Update Xtext Index</a></li>
+<li><a href="type_index.html#build-state-setup-phase">7.5.2.2. Build State Setup Phase</a></li>
+<li><a href="type_index.html#process-queued-uris">7.5.2.3. Process Queued URIs</a></li>
+<li><a href="type_index.html#queueing-affected-resources">7.5.2.4. Queueing Affected Resources</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#sec:Incremental_Builder_Overview__Example">7.5.3. Example</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#dirty-state-handling">7.6. Dirty state handling</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#use-case-restoring-types-from-user-data">7.6.1. Use case: Restoring types from user data</a></li>
+<li><a href="type_index.html#use-case-updating-the-xtext-index">7.6.2. Use case: Updating the Xtext index</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="project_model.html#_project-model">8. Project Model</a>
+<ul class="sectlevel2">
+<li><a href="project_model.html#sec:Package_json">8.1. Package.json File</a></li>
+<li><a href="project_model.html#_accessing-project-information">8.2. Accessing Project Information</a>
+<ul class="sectlevel3">
+<li><a href="project_model.html#sec:IN4JSCore">8.2.1. IN4JSCore</a></li>
+<li><a href="project_model.html#sec:N4JSModel">8.2.2. N4JSModel</a></li>
+<li><a href="project_model.html#sec:N4JSWorkspace">8.2.3. N4JSWorkspace</a></li>
+<li><a href="project_model.html#sec:N4JSProject">8.2.4. N4JSProject</a></li>
+<li><a href="project_model.html#sec:SourceContainer">8.2.5. SourceContainer</a></li>
+<li><a href="project_model.html#sec:N4JSProjectsStateHelper">8.2.6. N4JSProjectsStateHelper</a></li>
+</ul>
+</li>
+<li><a href="project_model.html#sec:Caching">8.3. Caching</a>
+<ul class="sectlevel3">
+<li><a href="project_model.html#_caching-of-externallibraryworkspace">8.3.1. Caching of ExternalLibraryWorkspace</a></li>
+<li><a href="project_model.html#_caching-of-n4jsprojectsstatehelper">8.3.2. Caching of N4JSProjectsStateHelper</a></li>
+</ul>
+</li>
+<li><a href="project_model.html#sec:WildcardPathFilter">8.4. WildcardPathFilter</a></li>
+<li><a href="project_model.html#sec:ProjectUtils">8.5. ProjectUtils</a></li>
+</ul>
+</li>
+<li><a href="binding.html#_binding">9. Binding</a>
+<ul class="sectlevel2">
+<li><a href="binding.html#sec:Binding_Design_Rationale">9.1. Design Rationale</a></li>
+<li><a href="binding.html#sec:Binding_to_Members">9.2. Binding to Members</a></li>
+<li><a href="binding.html#sec:Binding_Getter_Setter">9.3. Getter / Setter Binding</a></li>
+<li><a href="binding.html#chap:Statics">9.4. Static Member Binding</a></li>
+<li><a href="binding.html#sec:Binding_Enumeration">9.5. Enumeration Literals Binding</a></li>
+<li><a href="binding.html#sec:Accessibility_of_types_and_members">9.6. Accessibility of types and members</a></li>
+<li><a href="binding.html#sec:Member_Scope_Example">9.7. Member Scope Example</a></li>
+<li><a href="binding.html#sec:Scoping_for_Members_of_Composed_Type_Explained">9.8. Scoping for Members of Composed Type (Union/Intersection) Example</a></li>
+<li><a href="binding.html#sec:Binding_of_Structurally_References_Types">9.9. Structurally References Types</a></li>
+<li><a href="binding.html#sec:Building">9.10. Building</a>
+<ul class="sectlevel3">
+<li><a href="binding.html#sec:Build_Phases">9.10.1. Build Phases</a></li>
+<li><a href="binding.html#sec:Build_Scenarios">9.10.2. Build Scenarios</a></li>
+<li><a href="binding.html#sec:Lazy_linking_problem">9.10.3. Lazy linking problem</a></li>
+</ul>
+</li>
+<li><a href="binding.html#sec:Proxies_and_Proxy_Resolution">9.11. Proxies and Proxy Resolution (Overview)</a>
+<ul class="sectlevel3">
+<li><a href="binding.html#xtexts-lazy-linking-proxies">9.11.1. Xtext’s Lazy Linking Proxies</a></li>
+<li><a href="binding.html#standard-emf-proxies">9.11.2. Standard EMF Proxies</a></li>
+<li><a href="binding.html#_how-is-proxy-resolution-triggered">9.11.3. How is Proxy Resolution Triggered?</a></li>
+<li><a href="binding.html#_when-is-proxy-resolution-allowed">9.11.4. When is Proxy Resolution Allowed?</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="validation.html#_validation">10. Validation</a>
+<ul class="sectlevel2">
+<li><a href="validation.html#sec:validation_overview">10.1. Validation overview</a></li>
+<li><a href="validation.html#sec:validation_control_flow">10.2. Validation control flow</a></li>
+<li><a href="validation.html#sec:validation_issue_ids">10.3. Issue IDs and Messages</a></li>
+<li><a href="validation.html#sec:validation_usage_patterns">10.4. Usage Pattern</a></li>
+<li><a href="validation.html#sec:validation_links">10.5. Links</a></li>
+</ul>
+</li>
+<li><a href="references.html#_references">11. References</a>
+<ul class="sectlevel2">
+<li><a href="references.html#sec:usecases">11.1. Use cases</a></li>
+<li><a href="references.html#sec:calculation_algorithm">11.2. Calculation algorithm</a>
+<ul class="sectlevel3">
+<li><a href="references.html#sec:Xtext_default_implementation">11.2.1. Xtext default implementation</a></li>
+<li><a href="references.html#sec:N4_implementation">11.2.2. N4JS implementation</a></li>
+</ul>
+</li>
+<li><a href="references.html#sec:PerformanceOfDependencyCalculation">11.3. Performance Of Dependency Calculation</a></li>
+<li><a href="references.html#sec:kinds_of_references">11.4. Kinds of references</a>
+<ul class="sectlevel3">
+<li><a href="references.html#sec:Cross_References_to_be_ignored">11.4.1. Cross References to be ignored</a></li>
+<li><a href="references.html#sec:Cross_References_to_be_handled">11.4.2. Cross References to be handled</a></li>
+</ul>
+</li>
+<li><a href="references.html#sec:transitive_dependencies">11.5. Transitive dependencies</a></li>
+<li><a href="references.html#sec:find-references">11.6. Find references</a>
+<ul class="sectlevel3">
+<li><a href="references.html#_background">11.6.1. Background</a></li>
+<li><a href="references.html#_how-find-references-work">11.6.2. How Find References Work</a>
+<ul class="sectlevel4">
+<li><a href="references.html#_step-1-convert-cursor-position-to-declared-element">11.6.2.1. Step 1: Convert Cursor Position to Declared Element</a></li>
+<li><a href="references.html#_step-2-convert-declared-element-to-target-uris">11.6.2.2. Step 2: Convert Declared Element to Target URIs</a></li>
+<li><a href="references.html#_step-3-filter-potential-resources">11.6.2.3. Step 3: Filter Potential Resources</a></li>
+<li><a href="references.html#_step-4-search-references-in-resource">11.6.2.4. Step 4: Search References in Resource</a></li>
+<li><a href="references.html#_limitations-and-possible-enhancements">11.6.2.5. Limitations and Possible Enhancements</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="compilation.html#_compilation">12. Compilation</a>
+<ul class="sectlevel2">
+<li><a href="compilation.html#chap:compilation">12.1. Introduction</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:general_design_rationals">12.1.1. General design rationals</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:logging_and_error_reporting">12.1.1.1. Logging and error reporting</a></li>
+<li><a href="compilation.html#sec:progress_monitor">12.1.1.2. Progress monitor</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Xtext_Integration">12.1.2. Xtext Integration</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:xtext_default_behaviour">12.1.2.1. Xtext default behaviour</a></li>
+<li><a href="compilation.html#sec:n4js_requirements">12.1.2.2. N4JS requirements</a></li>
+<li><a href="compilation.html#sec:compiler_discovery_in_ui">12.1.2.3. Compiler discovery in UI</a></li>
+<li><a href="compilation.html#sec:compiler_discovery_in_headless">12.1.2.4. Compiler discovery in headless</a></li>
+<li><a href="compilation.html#sec:general_generator_implementation">12.1.2.5. General generator implementation</a></li>
+<li><a href="compilation.html#sec:general_generator_activation">12.1.2.6. General generator activation</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Overview_of_Input_Models">12.1.3. Overview of the Input Models</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Core_Generator">12.2. Generators</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:Compiler_Components">12.2.1. Generator Components</a></li>
+<li><a href="compilation.html#sec:Generator_architecture">12.2.2. Generator architecture</a></li>
+<li><a href="compilation.html#sec:Unified_Compiler_Configuration">12.2.3. Unified Compiler Configuration</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Transpilers">12.3. Transpilers</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:Phases">12.3.1. Overview</a></li>
+<li><a href="compilation.html#relation-between-ast-and-im">12.3.2. Relation between AST and IM</a></li>
+<li><a href="compilation.html#implementation-overview">12.3.3. Implementation Overview</a></li>
+<li><a href="compilation.html#sec:Guidelines_for_Implementing_Transformations">12.3.4. Guidelines for Implementing Transformations</a></li>
+<li><a href="compilation.html#symbol-table-in-the-im">12.3.5. Symbol Table in the IM</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:N4JS_to_EcmaScript_Transpiler">12.4. N4JS-to-EcmaScript Transpiler</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:Overview_of_Transformations">12.4.1. Overview of Transformations</a></li>
+<li><a href="compilation.html#sec:Transpiling_members">12.4.2. Transpiling members</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:Transpiling_members__Delegating_members">12.4.2.1. Techniques for special member handling</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__Partial_shadowing_of_getter_setter_pairs">12.4.2.2. Partial shadowing</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__Consuming_or_inheriting_members_of_an_interface">12.4.2.3. Consuming or inheriting members of an interface</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__Static_polyfill">12.4.2.4. Static polyfill</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__API_implementation_stubs">12.4.2.5. API / implementation stubs</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Support_for_incomplete_API_implementation_testing_in_the_N4JS_to_EcmaScript_5_Transpiler">12.4.3. Support for incomplete API implementation testing</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:Modifications_in_Impl_projects">12.4.3.1. Modifications in Impl projects</a></li>
+<li><a href="compilation.html#sec:Implementation_of_stub_generation">12.4.3.2. Implementation of stub-generation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:n4jsc_Headless_Compiler_Interface">12.5. n4jsc Headless Compiler Interface</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:building_the_headless_compiler">12.5.1. building the headless compiler</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="execution.html#_execution">13. Execution</a>
+<ul class="sectlevel2">
+<li><a href="execution.html#sec:N4JS_Project_Execution_And_Linking_Model">13.1. N4JS Project Execution And Linking Model</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#subsec:N4JS_Execution_With_NodeJS">13.1.1. N4JS Execution With NodeJS</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:N4JS_Execution_And_Linking_File">13.2. N4JS Execution And Linking File</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#subsec:NodeJS_Specific_ELF">13.2.1. NodeJS Specific ELF</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Runners-execution">13.3. Runners</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#subsec:N4_Runtime_Environments_Convention">13.3.1. N4 Runtime Environments Convention</a></li>
+<li><a href="execution.html#subsec:Passing_Information_from_IDE_to_Execution_Code_in_Runtime_Environment">13.3.2. Passing Information from IDE to Execution Code in Runtime Environment</a></li>
+<li><a href="execution.html#subsec:Runners_Design">13.3.3. Runners Design</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Legacy_Execution_Engine">13.4. Legacy Execution Engine</a></li>
+<li><a href="execution.html#sec:Design">13.5. Design</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#sec:Usage_Outside_N4JSIDE">13.5.1. Usage Outside N4JSIDE</a>
+<ul class="sectlevel4">
+<li><a href="execution.html#sec:Use_Node_with_Maven">13.5.1.1. Use Node with Maven</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Usage_Inside_N4JSIDE">13.5.2. Usage Inside N4JSIDE</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Runtime_Injection">13.6. Runtime Injection</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#sec:Running_String_Code">13.6.1. Running String Code</a></li>
+<li><a href="execution.html#sec:Running_File_Code">13.6.2. Running File Code</a></li>
+<li><a href="execution.html#sec:Injection_Code_Example">13.6.3. Injection Code Example</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#_tests">14. Tests</a>
+<ul class="sectlevel2">
+<li><a href="tests.html#sec:Performance_Tests">14.1. Performance Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Synthetic_Performance_Tests">14.1.1. Synthetic Performance Tests</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:Design_of_Generator">14.1.1.1. Design of Generator</a></li>
+<li><a href="tests.html#sec:Design_of_Performance_Test_Execution">14.1.1.2. Design of Performance Test Configuration and Execution</a></li>
+<li><a href="tests.html#sec:JUnit_Configuration">14.1.1.3. JUnit Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Test_Configuration">14.1.1.4. JUnitBenchmark Test Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Report_Configuration">14.1.1.5. JUnitBenchmark Report Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Run_Configuration">14.1.1.6. JUnitBenchmark Run Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Example">14.1.1.7. JUnitBenchmark Example</a></li>
+<li><a href="tests.html#sec:Note_on_Jenkins_Job">14.1.1.8. Note on Jenkins Job</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#sec:ECMA_Tests">14.2. ECMA Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Grammar_Tests">14.2.1. Grammar Tests</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:Negative_Tests">14.2.1.1. Negative Tests</a></li>
+<li><a href="tests.html#sec:Test_Exclusion">14.2.1.2. Test Exclusion</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Integration_Tests">14.3. Integration Tests</a></li>
+<li><a href="tests.html#sec:Test_Helpers">14.4. Test Helpers</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Parameterized_N4JS_Tests">14.4.1. Parameterized N4JS tests</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:ParameterizedXtextRunner">14.4.1.1. ParameterizedXtextRunner</a></li>
+<li><a href="tests.html#sec:TestCodeProvider">14.4.1.2. TestCodeProvider</a></li>
+<li><a href="tests.html#sec:Example_Of_Parameterized_Parser_Test">14.4.1.3. Example of parameterized parser test</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Issue_Suppression">14.5. Issue Suppression</a></li>
+<li><a href="tests.html#sec:Xpect_Tests">14.6. Xpect Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Xpect_Test_Setup">14.6.1. Xpect Test Setup</a></li>
+<li><a href="tests.html#sec:Xpect_Issue_Suppression">14.6.2. Xpect Issue Suppression</a></li>
+<li><a href="tests.html#sec:Xpect_Provided_Test_Methods">14.6.3. Xpect Provided Test Methods</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#errors">14.6.3.1. errors</a></li>
+<li><a href="tests.html#warnings">14.6.3.2. warnings</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:N4JS_Specific_Xpect_Test_Methods">14.6.4. N4JS Specific Xpect Test Methods</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:XPECT_noerrors">14.6.4.1. noerrors and nowarnings</a></li>
+<li><a href="tests.html#sec:XPECT_scope">14.6.4.2. scope</a></li>
+<li><a href="tests.html#sec:XPECT_scopeWithPosition">14.6.4.3. scopeWithPosition</a></li>
+<li><a href="tests.html#sec:XPECT_scopeWithResource">14.6.4.4. scopeWithResource</a></li>
+<li><a href="tests.html#sec:XPECT_binding">14.6.4.5. binding</a></li>
+<li><a href="tests.html#sec:XPECT_linkedPathname">14.6.4.6. linkedPathname</a></li>
+<li><a href="tests.html#sec:XPECT_type_of">14.6.4.7. type of</a></li>
+<li><a href="tests.html#sec:XPECT_expectedType">14.6.4.8. expectedType</a></li>
+<li><a href="tests.html#sec:XPECT_elementKeyword">14.6.4.9. elementKeyword</a></li>
+<li><a href="tests.html#sec:XPECT_accessModifier">14.6.4.10. accessModifier</a></li>
+<li><a href="tests.html#sec:XPECT_compileResult">14.6.4.11. compileResult</a></li>
+<li><a href="tests.html#sec:XPECT_output">14.6.4.12. output</a></li>
+<li><a href="tests.html#sec:XPECT_outputRegEx">14.6.4.13. outputRegEx</a></li>
+<li><a href="tests.html#sec:XPECT_calculatedAccessModifier">14.6.4.14. calculatedAccessModifier</a></li>
+<li><a href="tests.html#sec:XPECT_spec">14.6.4.15. spec</a></li>
+<li><a href="tests.html#sec:XPECT_deadCode">14.6.4.16. deadCode</a></li>
+<li><a href="tests.html#sec:XPECT_returnOrThrows">14.6.4.17. returnOrThrows</a></li>
+<li><a href="tests.html#sec:XPECT_lint">14.6.4.18. lint</a></li>
+<li><a href="tests.html#sec:XPECT_lintFails">14.6.4.19. lintFails</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:FIXME_Xpect_modifier">14.6.5. FIXME Xpect modifier</a></li>
+<li><a href="tests.html#sec:Expectmatrix_Xpect_Test_Methods">14.6.6. Expectmatrix Xpect tests</a></li>
+<li><a href="tests.html#xpect-lint-tests">14.6.7. Xpect Lint Tests</a></li>
+</ul>
+</li>
+<li><a href="tests.html#xpect-proposal-tests">14.7. Xpect Proposal Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Validation_vs__Non_Validation">14.7.1. Validation vs. Non-Validation</a></li>
+<li><a href="tests.html#sec:General_Proposal_Test_Features">14.7.2. General Proposal Test Features</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:Test_Variables">14.7.2.1. Test Variables</a></li>
+<li><a href="tests.html#sec:Location_and_Selection">14.7.2.2. at – Location and Selection</a></li>
+<li><a href="tests.html#sec:Multi_Line_Expectations_in_Proposal_Tests">14.7.2.3. Multi Line Expectations in Proposal Tests</a></li>
+<li><a href="tests.html#sec:Timeout">14.7.2.4. Timeout and Performance</a></li>
+</ul>
+</li>
+<li><a href="tests.html#proposals-verify-existence-of-proposals">14.7.3. proposals – Verify Existence of Proposals</a></li>
+<li><a href="tests.html#sec:Verify_displayed_string">14.7.4. display – Verify displayed string</a></li>
+<li><a href="tests.html#sec:Apply_Proposal">14.7.5. apply – Apply Proposal</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#resource-application-in-other-files">14.7.5.1. resource – application in other files</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Content_Assist_Cycling">14.7.6. kind – Content Assist Cycling</a></li>
+<li><a href="tests.html#fileValidVerify-validation-status">14.7.7. fileValid – Verify validation status</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Apply_Proposal_And_Execute_Tests">14.8. Apply Proposal And Execute Tests</a></li>
+<li><a href="tests.html#sec:Organize_Imports_Test">14.9. Organize Imports Test</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#organizeimports">14.9.1. organizeImports</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Access_Control_Test">14.10. Access Control Test</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#test-scenarios">14.10.1. Test Scenarios</a></li>
+<li><a href="tests.html#n4js-code-generator">14.10.2. N4JS Code Generator</a></li>
+<li><a href="tests.html#xtext-issue-matcher">14.10.3. Xtext Issue Matcher</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Smoke_Tests">14.11. Smoke Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#how-to-handle-smoke-test-errors">14.11.1. How to handle smoke test errors?</a></li>
+<li><a href="tests.html#smoketester-and-exceptionanalyzer">14.11.2. SmokeTester and ExceptionAnalyzer</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:UI_Tests_with_SWTBot">14.12. UI Tests with SWTBot</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#writing-swtbot-tests">14.12.1. Writing SWTBot Tests</a></li>
+<li><a href="tests.html#running-swtbot-tests">14.12.2. Running SWTBot Tests</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Debugging_UI_Tests">14.13. Debugging UI Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Connecting_to_the_X_server_on_the_build_node">14.13.1. Connecting to the X-server on the build-node</a></li>
+<li><a href="tests.html#sec:Tools_to_investigate_the_java_stack">14.13.2. Tools to investigate the java-stack</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="ui_concepts.html#_ui-concepts">15. UI Concepts</a>
+<ul class="sectlevel2">
+<li><a href="ui_concepts.html#sec:User_Interface_Concepts">15.1. User Interface Concepts</a>
+<ul class="sectlevel3">
+<li><a href="ui_concepts.html#sec:Eclipse_UI_Concepts">15.1.1. Eclipse UI Concepts</a>
+<ul class="sectlevel4">
+<li><a href="ui_concepts.html#sec:Label_Provider">15.1.1.1. Label Provider</a></li>
+<li><a href="ui_concepts.html#sec:Markers">15.1.1.2. Markers</a></li>
+<li><a href="ui_concepts.html#sec:Commands__Toolbar_and_Menus">15.1.1.3. Commands, Toolbar and Menus</a></li>
+<li><a href="ui_concepts.html#sec:Content_Assist">15.1.1.4. Content Assist</a></li>
+<li><a href="ui_concepts.html#sec:Quick_Fixes">15.1.1.5. Quick Fixes</a></li>
+<li><a href="ui_concepts.html#sec:Quick_Assist">15.1.1.6. Quick Assist</a></li>
+<li><a href="ui_concepts.html#sec:Clean_Up_Actions">15.1.1.7. Clean Up Actions</a></li>
+<li><a href="ui_concepts.html#sec:Save_Actions">15.1.1.8. Save Actions</a></li>
+<li><a href="ui_concepts.html#sec:Auto_Edit">15.1.1.9. Auto Edit</a></li>
+<li><a href="ui_concepts.html#sec:Template_Proposals">15.1.1.10. Template Proposals</a></li>
+<li><a href="ui_concepts.html#sec:Outline_View___Quick_Outline">15.1.1.11. Outline View / Quick Outline</a></li>
+<li><a href="ui_concepts.html#sec:Navigator__Package_Explorer__Project_Explorer">15.1.1.12. Navigator, Package Explorer, Project Explorer</a></li>
+<li><a href="ui_concepts.html#sec:Hyperlinking_and_Navigation">15.1.1.13. Hyperlinking and Navigation</a></li>
+<li><a href="ui_concepts.html#sec:Syntax_and_Semantic_Coloring">15.1.1.14. Syntax and Semantic Coloring</a></li>
+<li><a href="ui_concepts.html#sec:Code_Formatter">15.1.1.15. Code Formatter</a></li>
+<li><a href="ui_concepts.html#sec:Wizards">15.1.1.16. Wizards</a></li>
+<li><a href="ui_concepts.html#sec:Cheat_Sheets">15.1.1.17. Cheat Sheets</a></li>
+<li><a href="ui_concepts.html#sec:Context_sensitive_Help">15.1.1.18. Context-sensitive Help</a></li>
+<li><a href="ui_concepts.html#sec:Hovers">15.1.1.19. Hovers</a></li>
+<li><a href="ui_concepts.html#sec:Folding">15.1.1.20. Folding</a></li>
+<li><a href="ui_concepts.html#sec:Customizable_validation___severity">15.1.1.21. Customizable validation / severity</a></li>
+<li><a href="ui_concepts.html#sec:Proposals">15.1.1.22. Proposals</a></li>
+</ul>
+</li>
+<li><a href="ui_concepts.html#sec:Non_Eclipse_UI_Concepts">15.1.2. Non-Eclipse UI Concepts</a>
+<ul class="sectlevel4">
+<li><a href="ui_concepts.html#sec:Overlays">15.1.2.1. Overlays</a></li>
+<li><a href="ui_concepts.html#sec:Goto__Inferred__Type">15.1.2.2. Goto (Inferred) Type</a></li>
+<li><a href="ui_concepts.html#sec:Postfix_Completion">15.1.2.3. Postfix Completion</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="ui_concepts.html#_user-interface-resources">15.2. User Interface Resources</a>
+<ul class="sectlevel3">
+<li><a href="ui_concepts.html#_icons">15.2.1. Icons</a>
+<ul class="sectlevel4">
+<li><a href="ui_concepts.html#_eclipse-platform-icons">15.2.1.1. Eclipse Platform Icons</a></li>
+<li><a href="ui_concepts.html#_n4js-specific-icons">15.2.1.2. N4JS Specific Icons</a></li>
+<li><a href="ui_concepts.html#_high-resolution-icons">15.2.1.3. High Resolution Icons</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="formatting.html#_formatting">16. Formatting</a>
+<ul class="sectlevel2">
+<li><a href="formatting.html#sec:FmtObjective">16.1. Objective</a>
+<ul class="sectlevel3">
+<li><a href="formatting.html#sec:FmtFormatting_Comments">16.1.1. Formatting Comments</a></li>
+</ul>
+</li>
+<li><a href="formatting.html#sec:FmtArchitecture">16.2. Architecture</a>
+<ul class="sectlevel3">
+<li><a href="formatting.html#sec:Implementation_example">16.2.1. Implementation example</a></li>
+</ul>
+</li>
+<li><a href="formatting.html#sec:FmtFormatter_Implementation_Guidelines">16.3. Formatter Implementation Guidelines</a></li>
+<li><a href="formatting.html#sec:FmtConfiguration">16.4. Configuration</a></li>
+<li><a href="formatting.html#sec:FmtUI_Integration">16.5. UI Integration</a></li>
+<li><a href="formatting.html#sec:FmtUnit_Testing_with_Xpect">16.6. Unit Testing with Xpect</a></li>
+</ul>
+</li>
+<li><a href="external_libraries.html#_external-libraries">17. External Libraries</a>
+<ul class="sectlevel2">
+<li><a href="external_libraries.html#sec:Major_Components">17.1. Major Components</a>
+<ul class="sectlevel3">
+<li><a href="external_libraries.html#subsec:External_Resources">17.1.1. External Resources</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Workspace">17.1.2. External Library Workspace</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Preference_Store">17.1.3. External Library Preference Store</a></li>
+<li><a href="external_libraries.html#subsec:npm_Manager">17.1.4. Library Manager</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Builder_Helper">17.1.5. External Library Builder</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Xtext_Index_Persister">17.1.6. External Library Xtext Index Persister</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Preference_Page">17.1.7. External Library Preference Page</a></li>
+</ul>
+</li>
+<li><a href="external_libraries.html#sec:Headless_External_Library_Support">17.2. Headless External Library Support</a>
+<ul class="sectlevel3">
+<li><a href="external_libraries.html#_custom-npm-settings">17.2.1. Custom npm settings</a></li>
+</ul>
+</li>
+<li><a href="external_libraries.html#sec:lmFutureWork">17.3. Future Work</a>
+<ul class="sectlevel3">
+<li><a href="external_libraries.html#subsec:lmMultipleDependencyScope">17.3.1. Multiple Dependency Scope</a></li>
+<li><a href="external_libraries.html#subsec:lmRunTestsFromLibrary">17.3.2. Run Tests from TestLibrary</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="json_support.html#sec:JSON_Support">18. JSON Support</a>
+<ul class="sectlevel2">
+<li><a href="json_support.html#sec:JSON_Parser">18.1. JSON Parser</a>
+<ul class="sectlevel3">
+<li><a href="json_support.html#sec:JSON_Parser_Unicode_Escaping">18.1.1. Escaping Unicode Control Characters in String Literals</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Empty_Text">18.1.2. Empty Text</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Nested_Structures">18.1.3. Nested Structures</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Whitespace">18.1.4. Whitespace</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Comments">18.1.5. Comments</a></li>
+</ul>
+</li>
+<li><a href="json_support.html#sec:JSON_Language_Extensions">18.2. JSON Language Extensions</a>
+<ul class="sectlevel3">
+<li><a href="json_support.html#sec:JSON_Validator_Extensions">18.2.1. JSON Validator Extensions</a>
+<ul class="sectlevel4">
+<li><a href="json_support.html#sec:File_Specitic_Validator_Extensions">18.2.1.1. File-Specific Validator Extensions</a></li>
+<li><a href="json_support.html#sec:JSON_Declarative_JSON_Validator_Extensions">18.2.1.2. Declarative JSON Validator Extensions</a></li>
+</ul>
+</li>
+<li><a href="json_support.html#_json-resource-description-strategy">18.2.2. JSON Resource Description Strategy</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_jsdoc">19. JSDoc</a>
+<ul class="sectlevel2">
+<li><a href="jsdoc.html#sec:Design_Rationale">19.1. Design Rationale</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#_general-design">19.1.1. General Design</a></li>
+<li><a href="jsdoc.html#sec:Type_Expressions">19.1.2. Type Expressions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="docexporter.html#_docexporter">20. DocExporter</a>
+<ul class="sectlevel2">
+<li><a href="docexporter.html#sec:Specification_Exporter">20.1. Specification Exporter</a></li>
+</ul>
+</li>
+<li><a href="#_rename-refactoring">21. Rename Refactoring</a>
+<ul class="sectlevel2">
+<li><a href="#_rename-refactoring-ui-interaction">21.1. Rename Refactoring UI interaction</a></li>
+<li><a href="#_renameelementprocessor-interaction">21.2. RenameElementProcessor interaction</a></li>
+</ul>
+</li>
+<li><a href="flow_graphs.html#chap:flowgraphs">22. Flow Graphs</a>
+<ul class="sectlevel2">
+<li><a href="flow_graphs.html#sec:flowgraphs_overview">22.1. Flow graphs overview</a>
+<ul class="sectlevel3">
+<li><a href="flow_graphs.html#_internal-graph">22.1.1. Internal graph</a></li>
+<li><a href="flow_graphs.html#_optimizations">22.1.2. Optimizations</a></li>
+<li><a href="flow_graphs.html#_api-for-client-analyses">22.1.3. API for client analyses</a>
+<ul class="sectlevel4">
+<li><a href="flow_graphs.html#_mapping-from-internal-to-ast-elements">22.1.3.1. Mapping from internal to AST elements</a></li>
+<li><a href="flow_graphs.html#_graph-visitor">22.1.3.2. Graph visitor</a></li>
+<li><a href="flow_graphs.html#_graph-explorer">22.1.3.3. Graph explorer</a></li>
+<li><a href="flow_graphs.html#_branch-walker">22.1.3.4. Branch walker</a></li>
+<li><a href="flow_graphs.html#_example-1-compute-string-for-each-path">22.1.3.5. Example 1: Compute string for each path</a></li>
+<li><a href="flow_graphs.html#_path-quantor">22.1.3.6. Path quantor</a></li>
+</ul>
+</li>
+<li><a href="flow_graphs.html#_control-flow-analyses">22.1.4. Control flow analyses</a>
+<ul class="sectlevel4">
+<li><a href="flow_graphs.html#_dead-code-analysis">22.1.4.1. Dead code analysis</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="flow_graphs.html#sec:dataflow">22.2. Dataflow</a>
+<ul class="sectlevel3">
+<li><a href="flow_graphs.html#_dataflow-graph">22.2.1. Dataflow graph</a></li>
+<li><a href="flow_graphs.html#_dataflow-analyses">22.2.2. Dataflow analyses</a>
+<ul class="sectlevel4">
+<li><a href="flow_graphs.html#_def-def-def-nothing-analysis">22.2.2.1. Def&#8594;Def / Def&#8594;Nothing analysis</a></li>
+<li><a href="flow_graphs.html#_def-use-decl-analysis">22.2.2.2. Def|Use&#8592;Decl analysis</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="publish_npms.html#sec:publish-npms-to-public">23. Publish npms</a>
+<ul class="sectlevel2">
+<li><a href="publish_npms.html#sec:publish-npms-n4js-maven">23.1. Publish n4js-libs to during  maven build</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Hints">Appendix A: Hints</a>
+<ul class="sectlevel2">
+<li><a href="appendix_a_hints.html#sec:XtextInjection">A.1. Xtext Injection</a>
+<ul class="sectlevel3">
+<li><a href="appendix_a_hints.html#sec:DI_MultipleInjectors_Singletons">A.1.1. Multiple Injectors and Singletons</a>
+<ul class="sectlevel4">
+<li><a href="appendix_a_hints.html#sec:DI_avoid_duplicate_singletons">A.1.1.1. Avoiding duplicate singletons</a>
+<ul class="sectlevel5">
+<li><a href="appendix_a_hints.html#sec:DI_binding_in_shared">A.1.1.1.1. Defining binding in the shared injector</a></li>
+<li><a href="appendix_a_hints.html#sec:DI_binding_in_custom">A.1.1.1.2. Defining binding in the custom injector</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:DI_Hints">A.1.2. Dependency Injection Hints</a>
+<ul class="sectlevel4">
+<li><a href="appendix_a_hints.html#sec:DI_custom_bundle">A.1.2.1. Use DI in custom bundle, use DI with extensions</a>
+<ul class="sectlevel5">
+<li><a href="appendix_a_hints.html#sec:DI_custom_bundle_problem">A.1.2.1.1. Problem</a></li>
+<li><a href="appendix_a_hints.html#sec:DI_custom_bundle_solution">A.1.2.1.2. Solution</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Access_Other_DSL_Injector">A.1.2.2. How do I get the Guice Injector of my language?</a>
+<ul class="sectlevel5">
+<li><a href="appendix_a_hints.html#sec:DSL_Injector_UI_context">A.1.2.2.1. UI context</a></li>
+<li><a href="appendix_a_hints.html#sec:DSL_Injector_Non_UI_context">A.1.2.2.2. Non UI context but with injection context</a></li>
+<li><a href="appendix_a_hints.html#sec:DSL_Injector_Non_UI_non_injection_context">A.1.2.2.3. Non UI context without injection context</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Cancel_Indicator">A.1.2.3. How do I get cancel indicators in different contexts?</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Eclipse">A.2. Eclipse</a>
+<ul class="sectlevel3">
+<li><a href="appendix_a_hints.html#sec:Show_Xtext_Index">A.2.1. Show the current Xtext index</a></li>
+<li><a href="appendix_a_hints.html#sec:Plugin_spy">A.2.2. Plug-in spy</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Maven-hints">A.3. Maven</a>
+<ul class="sectlevel3">
+<li><a href="appendix_a_hints.html#how-to-check-for-maven-mojo-updates">A.3.1. How to check for Maven MOJO updates</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#_module-loading">Appendix B: Module Loading</a>
+<ul class="sectlevel2">
+<li><a href="appendix_b_module_loading.html#sec:Dependency_Management">B.1. Dependency Management</a></li>
+<li><a href="appendix_b_module_loading.html#ecmascript-modules">B.2. ECMAScript Modules</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:ES5_Modules_Systems">B.2.1. ES5 Modules Systems</a></li>
+<li><a href="appendix_b_module_loading.html#sec:ES6_Modules">B.2.2. ES6 Modules</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:ECMAScript_Module_Loaders">B.3. ECMAScript Module Loaders</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:ES6_Module_Loaders">B.3.1. ES6 Module Loaders</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Polyfills_for_ES6_Module_Loaders">B.3.2. Polyfills for ES6 Module Loaders</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:es6_module_loader">B.3.2.1. es6-module-loader</a></li>
+<li><a href="appendix_b_module_loading.html#sec:SystemJS">B.3.2.2. SystemJS</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Demo">B.3.2.3. Demo</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#case-study-typescript">B.4. Case Study : TypeScript</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:ES6_Modules_Support">B.4.1. ES6 Modules Support</a></li>
+<li><a href="appendix_b_module_loading.html#sec:TypeScript_and_Module_Loading">B.4.2. TypeScript and Module Loading</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Cyclic_Dependencies">B.5. Cyclic Dependencies</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:Setup">B.5.1. Setup</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Transpile_and_Execute">B.5.2. Transpile and Execute</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Module_Format___AMD">B.5.2.1. Module Format = AMD</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Module_Format___CommonJS">B.5.2.2. Module Format = CommonJS</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Module_Format___SystemJS">B.5.2.3. Module Format = SystemJS</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Conclusion">B.5.3. Conclusion</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#system.register-as-transpilation-target">B.6. System.register as transpilation target</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:Introduction">B.6.1. Introduction</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:External_Transpilers">B.6.1.1. External Transpilers</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Example_of_a_System_register_module">B.6.1.2. Example of a System.register module</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Structure_of_a_System_register_module">B.6.2. Structure of a System.register module</a></li>
+<li><a href="appendix_b_module_loading.html#_transpilation-hints">B.6.3. Transpilation Hints</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Handling_Imports">B.6.3.1. Handling Imports</a></li>
+<li><a href="appendix_b_module_loading.html#sec:__exportFn__">B.6.3.2. &lt;&lt;exportFn&gt;&gt;</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Handling_Exports">B.6.3.3. Handling Exports</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Examples_w__Circular_Dependencies">B.6.4. Examples w/ Circular Dependencies</a></li>
+<li><a href="appendix_b_module_loading.html#sec:N4JS_Examples_w__Circular_Dependencies">B.6.5. N4JS Examples w/ Circular Dependencies</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Unresolved_Cyclic_Dependencies">B.6.5.1. Unresolved Cyclic Dependencies</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Variables___Functions">B.6.5.2. Examples with Variables &amp; Functions</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Classes">B.6.5.3. Examples with Classes</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Examples_with_SubClassing">B.6.5.4. Examples with SubClassing</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Miscellaneous">B.6.5.5. Miscellaneous</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#_resources">B.6.6. Resources</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:CommonJS_as_transpilation_target">B.7. CommonJS as transpilation target</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#_introduction-2">B.7.1. Introduction</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Transpilation_Hints">B.7.2. Transpilation Hints</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Import_Statements">B.7.2.1. Import Statements</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Export_Statements">B.7.2.2. Export Statements</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Tracking_Live_Bindings">B.7.2.3. Tracking Live Bindings</a></li>
+<li><a href="appendix_b_module_loading.html#sec:A_complete_example">B.7.2.4. A complete example</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#_resources-2">B.7.3. Resources</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_c_license.html#sec:License">Appendix C: License</a></li>
+<li><a href="appendix_d_acronyms.html#sec:Acronyms">Appendix D: Acronyms</a></li>
+<li><a href="appendix_e_bibliography_and_footnotes.html#_bibliography-and-footnotes">Appendix E: Bibliography and Footnotes</a></li>
+</ul>
+</div>
+</div>
+<div id="content"><div class="sect1">
+<h2 id="_rename-refactoring"><a class="anchor" href="#_rename-refactoring"></a><a class="link" href="#_rename-refactoring">21. Rename Refactoring</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>The rename refactoring operation is implemented based on current Xtext&#8217;s rename refactoring implementation. However, lots of customization have been done in order to make Rename Refactoring work for N4JS. In order to understand N4JS customization, it is imperative to understand how Xtext implements rename refactoring. In this chapter, we will focus on Xtext&#8217;s architecture for rename refactoring. Additionally, we will point to the components that have been customized for N4JS.</p>
+</div>
+<div class="sect2">
+<h3 id="_rename-refactoring-ui-interaction"><a class="anchor" href="#_rename-refactoring-ui-interaction"></a><a class="link" href="#_rename-refactoring-ui-interaction">21.1. Rename Refactoring UI interaction</a></h3>
+<div class="paragraph">
+<p>Xtext&#8217;s implementation allows rename refactoring be in either one of two modes (1) Direct refactoring mode (3) Refactoring with dialog mode. Diagram <a href="#fig:rename_refactoring_communication_diagram_part1">Direct Rename Refactoring UI interaction</a> shows the UI interaction in <em>direct refactoring mode</em>.</p>
+</div>
+<div id="fig:rename_refactoring_communication_diagram_part1" class="imageblock center">
+<div class="content">
+<img src="chapters/25_renameRefactoring/images/rename_refactoring_communication_diagram_part1.svg" alt="title-"Direct Rename Refactoring UI interaction"">
+</div>
+</div>
+<div class="paragraph">
+<p>In this diagram, the classes in yellow are customized by N4JS implementation to handle N4JS-specific characteristics.</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>DefaultRenameElementHandler</code>: Our custom N4JS implementation converts the selected element to be renamed into its corresponding TModule element.</p>
+</li>
+<li>
+<p><code>ILinkedPositionGroupCalculator</code>: This class is responsible for calculating locations of names to be changed during linked edit mode. We need to provide a custom N4JS implementation to handle composed elements.</p>
+</li>
+<li>
+<p><code>RenameElementProcessor</code>: We need to provide a custom N4JS implementation to add N4JS-specific validation of conditions, e.g. checking name conflicts etc.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>The key class for creating updates of a declaration and its associated references is <code>RenameElementProcessor</code>. In the following section, we will see how this class interacts with other classes to achieve this.</p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_renameelementprocessor-interaction"><a class="anchor" href="#_renameelementprocessor-interaction"></a><a class="link" href="#_renameelementprocessor-interaction">21.2. RenameElementProcessor interaction</a></h3>
+<div class="paragraph">
+<p>Diagram <a href="#fig:rename_refactoring_communication_diagram_part2">RenameElementProcessor interaction</a> shows the interaction of <code>RenameElementProcessor</code> and other classes to create changes for both declaration and references during rename refactoring.</p>
+</div>
+<div id="fig:rename_refactoring_communication_diagram_part2" class="imageblock center">
+<div class="content">
+<img src="chapters/25_renameRefactoring/images/rename_refactoring_communication_diagram_part2.svg" alt="title-"RenameElementProcessor interaction"">
+</div>
+</div>
+<div class="paragraph">
+<p>As seen in the diagram, there are two stages of creating updates:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Creating updates for declaration is done by <code>IRenameStrategy</code> and</p>
+</li>
+<li>
+<p>Creating updates for references is done by <code>ReferenceUpdateDispatcher</code>. <code>ReferenceUpdateDispatcher</code> in turn delegates the finding of references to <code>IReferenceFinder</code>.</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>The text edits for changing the definition and the references are accumulated by an <code>IRefactoringUpdateAcceptor</code>.</p>
+</div>
+<div class="paragraph">
+<p>The classes in yellow are customized by N4JS implementation.</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>IRenameStrategy</code>: the custom N4JS implementation creates updates for constituent members of composed elements.</p>
+</li>
+<li>
+<p><code>IReferenceFinder</code>: the custom N4JS implementation used for finding references of a declaration.</p>
+</li>
+<li>
+<p><code>RefactoringCrossReferenceSerializer</code>: custom N4JS implementation to retrieve the updated name for cross references. For some unknown reason, the default implementation does not work correctly.</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div id="footer">
+<div id="footer-text">
+Version 0.9<br>
+Last updated 2019-08-07 15:02:40 CEST
+</div>
+</div>
+<!-- ************* docinfo-footer *************************************************************** -->
+<div class="Grid social" style="color:#d5dfea">
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <h2>Quick Links</h2>
+    <ul>
+      <li><a href="../downloads.html">Download</a></li>
+      <li><a href="../userguides/index.html">Documentation</a></li>
+      <li><a href="https://github.com/eclipse/n4js/">Source</a></li>
+      <li><a href="https://github.com/eclipse/n4js/issues">Issues</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="https://www.eclipse.org/forums/index.php/f/365/">Forum</a></li>
+      <li><a href="http://n4js.blogspot.de/">Blog</a></li>
+      <li><a href="https://dev.eclipse.org/mailman/listinfo/n4js-dev">Mailing List</a></li>
+      <li><a href="https://projects.eclipse.org/projects/technology.n4js">Eclipse Project Page</a></li>
+      <li><a href="https://twitter.com/n4jsdev">Tweets by n4jsdev</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="http://www.eclipse.org/">Eclipse Home</a></li>
+      <li><a href="http://www.eclipse.org/legal/privacy.php">Privacy Policy</a></li>
+      <li><a href="http://www.eclipse.org/legal/termsofuse.php">Terms of Use</a></li>
+      <li><a href="http://www.eclipse.org/legal/copyright.php">Copyright Agent</a></li>
+      <li><a href="http://www.eclipse.org/legal/">Legal</a></li>
+    </ul>
+  </div>
+  <div style="clear: both; height: 0; overflow: hidden;"></div>
+</div>
+
+<!-- ************* UI Scripts ************* -->
+<script type="text/javascript" src="scripts/back-to-top.js"></script>
+
+<script type="text/javascript" src="scripts/treeview.js"></script>
+<script type="text/javascript" src="scripts/toc.js"></script>
+
+<!-- ************* Prism.js Syntax Highlighting ************* -->
+<script src="scripts/prism.js"></script>
+
+<script type="text/javascript">
+	// Add the 'toclist' id for search function
+	$(".toc2 > ul").attr('id', 'toclist');
+	// Generate a Search input form
+	$("#toclist > li:first-of-type").before('<input type="text" id="pagesearch" onkeyup="search()" placeholder="Search for section...">');
+	$("#toclist > li:first-of-type").before('<i id="clear" class="fa fa-times-circle-o"></i>');
+	$("#clear").click(function(){
+	    $("#pagesearch").val('');
+	    search();
+	    $('.toc2 > ul').treeView('collapseAll');
+	});
+	// intialize Treeview.js
+	$(".toc2 > ul").treeView();
+	// Initialize Scrollspy
+</script>
+<!-- ************* docinfo-footer *************************************************************** -->
+</body>
+</html>
\ No newline at end of file
diff --git a/design/scripts/back-to-top.js b/design/scripts/back-to-top.js
new file mode 100644
index 0000000..6f1b6fa
--- /dev/null
+++ b/design/scripts/back-to-top.js
@@ -0,0 +1,28 @@
+/**
+ * Copyright (c) 2016 NumberFour AG.
+ * All rights reserved. This program and the accompanying materials
+ * are made available under the terms of the Eclipse Public License v1.0
+ * which accompanies this distribution, and is available at
+ * http://www.eclipse.org/legal/epl-v10.html
+ *
+ * Contributors:
+ *   NumberFour AG - Initial API and implementation
+ */
+
+ 
+// Create a back to top button
+$('body').prepend('<a href="#" class="back-to-top">Back to Top</a>');
+var amountScrolled = 300;
+$(window).scroll(function() {
+if ( $(window).scrollTop() > amountScrolled ) {
+    $('a.back-to-top').fadeIn('slow');
+} else {
+    $('a.back-to-top').fadeOut('slow');
+}
+});
+$('a.back-to-top, a.simple-back-to-top').click(function() {
+$('html, body').animate({
+    scrollTop: 0
+}, 700);
+return false;
+});
diff --git a/design/scripts/prism.js b/design/scripts/prism.js
new file mode 100644
index 0000000..4f619ca
--- /dev/null
+++ b/design/scripts/prism.js
@@ -0,0 +1,58 @@
+/* http://prismjs.com/download.html?themes=prism&languages=markup+css+clike+javascript+asciidoc+bash+c+csharp+cpp+ruby+docker+git+go+groovy+http+ini+java+json+latex+lua+markdown+n4js+nginx+nix+perl+php+php-extras+powershell+properties+python+r+jsx+rust+sass+scss+sql+swift+typescript+yaml&plugins=line-highlight+line-numbers+show-invisibles+autolinker+file-highlight+toolbar+jsonp-highlight+highlight-keywords+autoloader+command-line+data-uri-highlight+show-language+copy-to-clipboard */
+var _self="undefined"!=typeof window?window:"undefined"!=typeof WorkerGlobalScope&&self instanceof WorkerGlobalScope?self:{},Prism=function(){var e=/\blang(?:uage)?-(\w+)\b/i,t=0,n=_self.Prism={util:{encode:function(e){return e instanceof a?new a(e.type,n.util.encode(e.content),e.alias):"Array"===n.util.type(e)?e.map(n.util.encode):e.replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/\u00a0/g," ")},type:function(e){return Object.prototype.toString.call(e).match(/\[object (\w+)\]/)[1]},objId:function(e){return e.__id||Object.defineProperty(e,"__id",{value:++t}),e.__id},clone:function(e){var t=n.util.type(e);switch(t){case"Object":var a={};for(var r in e)e.hasOwnProperty(r)&&(a[r]=n.util.clone(e[r]));return a;case"Array":return e.map&&e.map(function(e){return n.util.clone(e)})}return e}},languages:{extend:function(e,t){var a=n.util.clone(n.languages[e]);for(var r in t)a[r]=t[r];return a},insertBefore:function(e,t,a,r){r=r||n.languages;var i=r[e];if(2==arguments.length){a=arguments[1];for(var l in a)a.hasOwnProperty(l)&&(i[l]=a[l]);return i}var o={};for(var s in i)if(i.hasOwnProperty(s)){if(s==t)for(var l in a)a.hasOwnProperty(l)&&(o[l]=a[l]);o[s]=i[s]}return n.languages.DFS(n.languages,function(t,n){n===r[e]&&t!=e&&(this[t]=o)}),r[e]=o},DFS:function(e,t,a,r){r=r||{};for(var i in e)e.hasOwnProperty(i)&&(t.call(e,i,e[i],a||i),"Object"!==n.util.type(e[i])||r[n.util.objId(e[i])]?"Array"!==n.util.type(e[i])||r[n.util.objId(e[i])]||(r[n.util.objId(e[i])]=!0,n.languages.DFS(e[i],t,i,r)):(r[n.util.objId(e[i])]=!0,n.languages.DFS(e[i],t,null,r)))}},plugins:{},highlightAll:function(e,t){var a={callback:t,selector:'code[class*="language-"], [class*="language-"] code, code[class*="lang-"], [class*="lang-"] code'};n.hooks.run("before-highlightall",a);for(var r,i=a.elements||document.querySelectorAll(a.selector),l=0;r=i[l++];)n.highlightElement(r,e===!0,a.callback)},highlightElement:function(t,a,r){for(var i,l,o=t;o&&!e.test(o.className);)o=o.parentNode;o&&(i=(o.className.match(e)||[,""])[1].toLowerCase(),l=n.languages[i]),t.className=t.className.replace(e,"").replace(/\s+/g," ")+" language-"+i,o=t.parentNode,/pre/i.test(o.nodeName)&&(o.className=o.className.replace(e,"").replace(/\s+/g," ")+" language-"+i);var s=t.textContent,u={element:t,language:i,grammar:l,code:s};if(n.hooks.run("before-sanity-check",u),!u.code||!u.grammar)return u.code&&(u.element.textContent=u.code),n.hooks.run("complete",u),void 0;if(n.hooks.run("before-highlight",u),a&&_self.Worker){var g=new Worker(n.filename);g.onmessage=function(e){u.highlightedCode=e.data,n.hooks.run("before-insert",u),u.element.innerHTML=u.highlightedCode,r&&r.call(u.element),n.hooks.run("after-highlight",u),n.hooks.run("complete",u)},g.postMessage(JSON.stringify({language:u.language,code:u.code,immediateClose:!0}))}else u.highlightedCode=n.highlight(u.code,u.grammar,u.language),n.hooks.run("before-insert",u),u.element.innerHTML=u.highlightedCode,r&&r.call(t),n.hooks.run("after-highlight",u),n.hooks.run("complete",u)},highlight:function(e,t,r){var i=n.tokenize(e,t);return a.stringify(n.util.encode(i),r)},tokenize:function(e,t){var a=n.Token,r=[e],i=t.rest;if(i){for(var l in i)t[l]=i[l];delete t.rest}e:for(var l in t)if(t.hasOwnProperty(l)&&t[l]){var o=t[l];o="Array"===n.util.type(o)?o:[o];for(var s=0;s<o.length;++s){var u=o[s],g=u.inside,c=!!u.lookbehind,h=!!u.greedy,f=0,d=u.alias;if(h&&!u.pattern.global){var p=u.pattern.toString().match(/[imuy]*$/)[0];u.pattern=RegExp(u.pattern.source,p+"g")}u=u.pattern||u;for(var m=0,y=0;m<r.length;y+=r[m].length,++m){var v=r[m];if(r.length>e.length)break e;if(!(v instanceof a)){u.lastIndex=0;var b=u.exec(v),k=1;if(!b&&h&&m!=r.length-1){if(u.lastIndex=y,b=u.exec(e),!b)break;for(var w=b.index+(c?b[1].length:0),_=b.index+b[0].length,A=m,P=y,j=r.length;j>A&&_>P;++A)P+=r[A].length,w>=P&&(++m,y=P);if(r[m]instanceof a||r[A-1].greedy)continue;k=A-m,v=e.slice(y,P),b.index-=y}if(b){c&&(f=b[1].length);var w=b.index+f,b=b[0].slice(f),_=w+b.length,x=v.slice(0,w),O=v.slice(_),S=[m,k];x&&S.push(x);var N=new a(l,g?n.tokenize(b,g):b,d,b,h);S.push(N),O&&S.push(O),Array.prototype.splice.apply(r,S)}}}}}return r},hooks:{all:{},add:function(e,t){var a=n.hooks.all;a[e]=a[e]||[],a[e].push(t)},run:function(e,t){var a=n.hooks.all[e];if(a&&a.length)for(var r,i=0;r=a[i++];)r(t)}}},a=n.Token=function(e,t,n,a,r){this.type=e,this.content=t,this.alias=n,this.length=0|(a||"").length,this.greedy=!!r};if(a.stringify=function(e,t,r){if("string"==typeof e)return e;if("Array"===n.util.type(e))return e.map(function(n){return a.stringify(n,t,e)}).join("");var i={type:e.type,content:a.stringify(e.content,t,r),tag:"span",classes:["token",e.type],attributes:{},language:t,parent:r};if("comment"==i.type&&(i.attributes.spellcheck="true"),e.alias){var l="Array"===n.util.type(e.alias)?e.alias:[e.alias];Array.prototype.push.apply(i.classes,l)}n.hooks.run("wrap",i);var o=Object.keys(i.attributes).map(function(e){return e+'="'+(i.attributes[e]||"").replace(/"/g,"&quot;")+'"'}).join(" ");return"<"+i.tag+' class="'+i.classes.join(" ")+'"'+(o?" "+o:"")+">"+i.content+"</"+i.tag+">"},!_self.document)return _self.addEventListener?(_self.addEventListener("message",function(e){var t=JSON.parse(e.data),a=t.language,r=t.code,i=t.immediateClose;_self.postMessage(n.highlight(r,n.languages[a],a)),i&&_self.close()},!1),_self.Prism):_self.Prism;var r=document.currentScript||[].slice.call(document.getElementsByTagName("script")).pop();return r&&(n.filename=r.src,document.addEventListener&&!r.hasAttribute("data-manual")&&("loading"!==document.readyState?window.requestAnimationFrame?window.requestAnimationFrame(n.highlightAll):window.setTimeout(n.highlightAll,16):document.addEventListener("DOMContentLoaded",n.highlightAll))),_self.Prism}();"undefined"!=typeof module&&module.exports&&(module.exports=Prism),"undefined"!=typeof global&&(global.Prism=Prism);
+Prism.languages.markup={comment:/<!--[\w\W]*?-->/,prolog:/<\?[\w\W]+?\?>/,doctype:/<!DOCTYPE[\w\W]+?>/i,cdata:/<!\[CDATA\[[\w\W]*?]]>/i,tag:{pattern:/<\/?(?!\d)[^\s>\/=$<]+(?:\s+[^\s>\/=]+(?:=(?:("|')(?:\\\1|\\?(?!\1)[\w\W])*\1|[^\s'">=]+))?)*\s*\/?>/i,inside:{tag:{pattern:/^<\/?[^\s>\/]+/i,inside:{punctuation:/^<\/?/,namespace:/^[^\s>\/:]+:/}},"attr-value":{pattern:/=(?:('|")[\w\W]*?(\1)|[^\s>]+)/i,inside:{punctuation:/[=>"']/}},punctuation:/\/?>/,"attr-name":{pattern:/[^\s>\/]+/,inside:{namespace:/^[^\s>\/:]+:/}}}},entity:/&#?[\da-z]{1,8};/i},Prism.hooks.add("wrap",function(a){"entity"===a.type&&(a.attributes.title=a.content.replace(/&amp;/,"&"))}),Prism.languages.xml=Prism.languages.markup,Prism.languages.html=Prism.languages.markup,Prism.languages.mathml=Prism.languages.markup,Prism.languages.svg=Prism.languages.markup;
+Prism.languages.css={comment:/\/\*[\w\W]*?\*\//,atrule:{pattern:/@[\w-]+?.*?(;|(?=\s*\{))/i,inside:{rule:/@[\w-]+/}},url:/url\((?:(["'])(\\(?:\r\n|[\w\W])|(?!\1)[^\\\r\n])*\1|.*?)\)/i,selector:/[^\{\}\s][^\{\};]*?(?=\s*\{)/,string:{pattern:/("|')(\\(?:\r\n|[\w\W])|(?!\1)[^\\\r\n])*\1/,greedy:!0},property:/(\b|\B)[\w-]+(?=\s*:)/i,important:/\B!important\b/i,"function":/[-a-z0-9]+(?=\()/i,punctuation:/[(){};:]/},Prism.languages.css.atrule.inside.rest=Prism.util.clone(Prism.languages.css),Prism.languages.markup&&(Prism.languages.insertBefore("markup","tag",{style:{pattern:/(<style[\w\W]*?>)[\w\W]*?(?=<\/style>)/i,lookbehind:!0,inside:Prism.languages.css,alias:"language-css"}}),Prism.languages.insertBefore("inside","attr-value",{"style-attr":{pattern:/\s*style=("|').*?\1/i,inside:{"attr-name":{pattern:/^\s*style/i,inside:Prism.languages.markup.tag.inside},punctuation:/^\s*=\s*['"]|['"]\s*$/,"attr-value":{pattern:/.+/i,inside:Prism.languages.css}},alias:"language-css"}},Prism.languages.markup.tag));
+Prism.languages.clike={comment:[{pattern:/(^|[^\\])\/\*[\w\W]*?\*\//,lookbehind:!0},{pattern:/(^|[^\\:])\/\/.*/,lookbehind:!0}],string:{pattern:/(["'])(\\(?:\r\n|[\s\S])|(?!\1)[^\\\r\n])*\1/,greedy:!0},"class-name":{pattern:/((?:\b(?:class|interface|extends|implements|trait|instanceof|new)\s+)|(?:catch\s+\())[a-z0-9_\.\\]+/i,lookbehind:!0,inside:{punctuation:/(\.|\\)/}},keyword:/\b(if|else|while|do|for|return|in|instanceof|function|new|try|throw|catch|finally|null|break|continue)\b/,"boolean":/\b(true|false)\b/,"function":/[a-z0-9_]+(?=\()/i,number:/\b-?(?:0x[\da-f]+|\d*\.?\d+(?:e[+-]?\d+)?)\b/i,operator:/--?|\+\+?|!=?=?|<=?|>=?|==?=?|&&?|\|\|?|\?|\*|\/|~|\^|%/,punctuation:/[{}[\];(),.:]/};
+Prism.languages.javascript=Prism.languages.extend("clike",{keyword:/\b(as|async|await|break|case|catch|class|const|continue|debugger|default|delete|do|else|enum|export|extends|finally|for|from|function|get|if|implements|import|in|instanceof|interface|let|new|null|of|package|private|protected|public|return|set|static|super|switch|this|throw|try|typeof|var|void|while|with|yield)\b/,number:/\b-?(0x[\dA-Fa-f]+|0b[01]+|0o[0-7]+|\d*\.?\d+([Ee][+-]?\d+)?|NaN|Infinity)\b/,"function":/[_$a-zA-Z\xA0-\uFFFF][_$a-zA-Z0-9\xA0-\uFFFF]*(?=\()/i,operator:/--?|\+\+?|!=?=?|<=?|>=?|==?=?|&&?|\|\|?|\?|\*\*?|\/|~|\^|%|\.{3}/}),Prism.languages.insertBefore("javascript","keyword",{regex:{pattern:/(^|[^\/])\/(?!\/)(\[.+?]|\\.|[^\/\\\r\n])+\/[gimyu]{0,5}(?=\s*($|[\r\n,.;})]))/,lookbehind:!0,greedy:!0}}),Prism.languages.insertBefore("javascript","string",{"template-string":{pattern:/`(?:\\\\|\\?[^\\])*?`/,greedy:!0,inside:{interpolation:{pattern:/\$\{[^}]+\}/,inside:{"interpolation-punctuation":{pattern:/^\$\{|\}$/,alias:"punctuation"},rest:Prism.languages.javascript}},string:/[\s\S]+/}}}),Prism.languages.markup&&Prism.languages.insertBefore("markup","tag",{script:{pattern:/(<script[\w\W]*?>)[\w\W]*?(?=<\/script>)/i,lookbehind:!0,inside:Prism.languages.javascript,alias:"language-javascript"}}),Prism.languages.js=Prism.languages.javascript;
+!function(a){var i={pattern:/(^[ \t]*)\[(?!\[)(?:(["'$`])(?:(?!\2)[^\\]|\\.)*\2|\[(?:[^\]\\]|\\.)*\]|[^\]\\]|\\.)*\]/m,lookbehind:!0,inside:{quoted:{pattern:/([$`])(?:(?!\1)[^\\]|\\.)*\1/,inside:{punctuation:/^[$`]|[$`]$/}},interpreted:{pattern:/'(?:[^'\\]|\\.)*'/,inside:{punctuation:/^'|'$/}},string:/"(?:[^"\\]|\\.)*"/,variable:/\w+(?==)/,punctuation:/^\[|\]$|,/,operator:/=/,"attr-value":/(?!^\s+$).+/}};a.languages.asciidoc={"comment-block":{pattern:/^(\/{4,})(?:\r?\n|\r)(?:[\s\S]*(?:\r?\n|\r))??\1/m,alias:"comment"},table:{pattern:/^\|={3,}(?:(?:\r?\n|\r).*)*?(?:\r?\n|\r)\|={3,}$/m,inside:{specifiers:{pattern:/(?!\|)(?:(?:(?:\d+(?:\.\d+)?|\.\d+)[+*])?(?:[<^>](?:\.[<^>])?|\.[<^>])?[a-z]*)(?=\|)/,alias:"attr-value"},punctuation:{pattern:/(^|[^\\])[|!]=*/,lookbehind:!0}}},"passthrough-block":{pattern:/^(\+{4,})(?:\r?\n|\r)(?:[\s\S]*(?:\r?\n|\r))??\1$/m,inside:{punctuation:/^\++|\++$/}},"literal-block":{pattern:/^(-{4,}|\.{4,})(?:\r?\n|\r)(?:[\s\S]*(?:\r?\n|\r))??\1$/m,inside:{punctuation:/^(?:-+|\.+)|(?:-+|\.+)$/}},"other-block":{pattern:/^(--|\*{4,}|_{4,}|={4,})(?:\r?\n|\r)(?:[\s\S]*(?:\r?\n|\r))??\1$/m,inside:{punctuation:/^(?:-+|\*+|_+|=+)|(?:-+|\*+|_+|=+)$/}},"list-punctuation":{pattern:/(^[ \t]*)(?:-|\*{1,5}|\.{1,5}|(?:[a-z]|\d+)\.|[xvi]+\))(?= )/im,lookbehind:!0,alias:"punctuation"},"list-label":{pattern:/(^[ \t]*)[a-z\d].+(?::{2,4}|;;)(?=\s)/im,lookbehind:!0,alias:"symbol"},"indented-block":{pattern:/((\r?\n|\r)\2)([ \t]+)\S.*(?:(?:\r?\n|\r)\3.+)*(?=\2{2}|$)/,lookbehind:!0},comment:/^\/\/.*/m,title:{pattern:/^.+(?:\r?\n|\r)(?:={3,}|-{3,}|~{3,}|\^{3,}|\+{3,})$|^={1,5} +.+|^\.(?![\s.]).*/m,alias:"important",inside:{punctuation:/^(?:\.|=+)|(?:=+|-+|~+|\^+|\++)$/}},"attribute-entry":{pattern:/^:[^:\r\n]+:(?: .*?(?: \+(?:\r?\n|\r).*?)*)?$/m,alias:"tag"},attributes:i,hr:{pattern:/^'{3,}$/m,alias:"punctuation"},"page-break":{pattern:/^<{3,}$/m,alias:"punctuation"},admonition:{pattern:/^(?:TIP|NOTE|IMPORTANT|WARNING|CAUTION):/m,alias:"keyword"},callout:[{pattern:/(^[ \t]*)<?\d*>/m,lookbehind:!0,alias:"symbol"},{pattern:/<\d+>/,alias:"symbol"}],macro:{pattern:/\b[a-z\d][a-z\d-]*::?(?:(?:\S+)??\[(?:[^\]\\"]|(["'])(?:(?!\1)[^\\]|\\.)*\1|\\.)*\])/,inside:{"function":/^[a-z\d-]+(?=:)/,punctuation:/^::?/,attributes:{pattern:/(?:\[(?:[^\]\\"]|(["'])(?:(?!\1)[^\\]|\\.)*\1|\\.)*\])/,inside:i.inside}}},inline:{pattern:/(^|[^\\])(?:(?:\B\[(?:[^\]\\"]|(["'])(?:(?!\2)[^\\]|\\.)*\2|\\.)*\])?(?:\b_(?!\s)(?: _|[^_\\\r\n]|\\.)+(?:(?:\r?\n|\r)(?: _|[^_\\\r\n]|\\.)+)*_\b|\B``(?!\s).+?(?:(?:\r?\n|\r).+?)*''\B|\B`(?!\s)(?: ['`]|.)+?(?:(?:\r?\n|\r)(?: ['`]|.)+?)*['`]\B|\B(['*+#])(?!\s)(?: \3|(?!\3)[^\\\r\n]|\\.)+(?:(?:\r?\n|\r)(?: \3|(?!\3)[^\\\r\n]|\\.)+)*\3\B)|(?:\[(?:[^\]\\"]|(["'])(?:(?!\4)[^\\]|\\.)*\4|\\.)*\])?(?:(__|\*\*|\+\+\+?|##|\$\$|[~^]).+?(?:(?:\r?\n|\r).+?)*\5|\{[^}\r\n]+\}|\[\[\[?.+?(?:(?:\r?\n|\r).+?)*\]?\]\]|<<.+?(?:(?:\r?\n|\r).+?)*>>|\(\(\(?.+?(?:(?:\r?\n|\r).+?)*\)?\)\)))/m,lookbehind:!0,inside:{attributes:i,url:{pattern:/^(?:\[\[\[?.+?\]?\]\]|<<.+?>>)$/,inside:{punctuation:/^(?:\[\[\[?|<<)|(?:\]\]\]?|>>)$/}},"attribute-ref":{pattern:/^\{.+\}$/,inside:{variable:{pattern:/(^\{)[a-z\d,+_-]+/,lookbehind:!0},operator:/^[=?!#%@$]|!(?=[:}])/,punctuation:/^\{|\}$|::?/}},italic:{pattern:/^(['_])[\s\S]+\1$/,inside:{punctuation:/^(?:''?|__?)|(?:''?|__?)$/}},bold:{pattern:/^\*[\s\S]+\*$/,inside:{punctuation:/^\*\*?|\*\*?$/}},punctuation:/^(?:``?|\+{1,3}|##?|\$\$|[~^]|\(\(\(?)|(?:''?|\+{1,3}|##?|\$\$|[~^`]|\)?\)\))$/}},replacement:{pattern:/\((?:C|TM|R)\)/,alias:"builtin"},entity:/&#?[\da-z]{1,8};/i,"line-continuation":{pattern:/(^| )\+$/m,lookbehind:!0,alias:"punctuation"}},i.inside.interpreted.inside.rest={macro:a.languages.asciidoc.macro,inline:a.languages.asciidoc.inline,replacement:a.languages.asciidoc.replacement,entity:a.languages.asciidoc.entity},a.languages.asciidoc["passthrough-block"].inside.rest={macro:a.languages.asciidoc.macro},a.languages.asciidoc["literal-block"].inside.rest={callout:a.languages.asciidoc.callout},a.languages.asciidoc.table.inside.rest={"comment-block":a.languages.asciidoc["comment-block"],"passthrough-block":a.languages.asciidoc["passthrough-block"],"literal-block":a.languages.asciidoc["literal-block"],"other-block":a.languages.asciidoc["other-block"],"list-punctuation":a.languages.asciidoc["list-punctuation"],"indented-block":a.languages.asciidoc["indented-block"],comment:a.languages.asciidoc.comment,title:a.languages.asciidoc.title,"attribute-entry":a.languages.asciidoc["attribute-entry"],attributes:a.languages.asciidoc.attributes,hr:a.languages.asciidoc.hr,"page-break":a.languages.asciidoc["page-break"],admonition:a.languages.asciidoc.admonition,"list-label":a.languages.asciidoc["list-label"],callout:a.languages.asciidoc.callout,macro:a.languages.asciidoc.macro,inline:a.languages.asciidoc.inline,replacement:a.languages.asciidoc.replacement,entity:a.languages.asciidoc.entity,"line-continuation":a.languages.asciidoc["line-continuation"]},a.languages.asciidoc["other-block"].inside.rest={table:a.languages.asciidoc.table,"list-punctuation":a.languages.asciidoc["list-punctuation"],"indented-block":a.languages.asciidoc["indented-block"],comment:a.languages.asciidoc.comment,"attribute-entry":a.languages.asciidoc["attribute-entry"],attributes:a.languages.asciidoc.attributes,hr:a.languages.asciidoc.hr,"page-break":a.languages.asciidoc["page-break"],admonition:a.languages.asciidoc.admonition,"list-label":a.languages.asciidoc["list-label"],macro:a.languages.asciidoc.macro,inline:a.languages.asciidoc.inline,replacement:a.languages.asciidoc.replacement,entity:a.languages.asciidoc.entity,"line-continuation":a.languages.asciidoc["line-continuation"]},a.languages.asciidoc.title.inside.rest={macro:a.languages.asciidoc.macro,inline:a.languages.asciidoc.inline,replacement:a.languages.asciidoc.replacement,entity:a.languages.asciidoc.entity},a.hooks.add("wrap",function(a){"entity"===a.type&&(a.attributes.title=a.content.replace(/&amp;/,"&"))})}(Prism),Prism.languages.adoc=Prism.languages.asciidoc;
+!function(e){var t={variable:[{pattern:/\$?\(\([\w\W]+?\)\)/,inside:{variable:[{pattern:/(^\$\(\([\w\W]+)\)\)/,lookbehind:!0},/^\$\(\(/],number:/\b-?(?:0x[\dA-Fa-f]+|\d*\.?\d+(?:[Ee]-?\d+)?)\b/,operator:/--?|-=|\+\+?|\+=|!=?|~|\*\*?|\*=|\/=?|%=?|<<=?|>>=?|<=?|>=?|==?|&&?|&=|\^=?|\|\|?|\|=|\?|:/,punctuation:/\(\(?|\)\)?|,|;/}},{pattern:/\$\([^)]+\)|`[^`]+`/,inside:{variable:/^\$\(|^`|\)$|`$/}},/\$(?:[a-z0-9_#\?\*!@]+|\{[^}]+\})/i]};e.languages.bash={shebang:{pattern:/^#!\s*\/bin\/bash|^#!\s*\/bin\/sh/,alias:"important"},comment:{pattern:/(^|[^"{\\])#.*/,lookbehind:!0},string:[{pattern:/((?:^|[^<])<<\s*)(?:"|')?(\w+?)(?:"|')?\s*\r?\n(?:[\s\S])*?\r?\n\2/g,lookbehind:!0,greedy:!0,inside:t},{pattern:/(["'])(?:\\\\|\\?[^\\])*?\1/g,greedy:!0,inside:t}],variable:t.variable,"function":{pattern:/(^|\s|;|\||&)(?:alias|apropos|apt-get|aptitude|aspell|awk|basename|bash|bc|bg|builtin|bzip2|cal|cat|cd|cfdisk|chgrp|chmod|chown|chroot|chkconfig|cksum|clear|cmp|comm|command|cp|cron|crontab|csplit|cut|date|dc|dd|ddrescue|df|diff|diff3|dig|dir|dircolors|dirname|dirs|dmesg|du|egrep|eject|enable|env|ethtool|eval|exec|expand|expect|export|expr|fdformat|fdisk|fg|fgrep|file|find|fmt|fold|format|free|fsck|ftp|fuser|gawk|getopts|git|grep|groupadd|groupdel|groupmod|groups|gzip|hash|head|help|hg|history|hostname|htop|iconv|id|ifconfig|ifdown|ifup|import|install|jobs|join|kill|killall|less|link|ln|locate|logname|logout|look|lpc|lpr|lprint|lprintd|lprintq|lprm|ls|lsof|make|man|mkdir|mkfifo|mkisofs|mknod|more|most|mount|mtools|mtr|mv|mmv|nano|netstat|nice|nl|nohup|notify-send|npm|nslookup|open|op|passwd|paste|pathchk|ping|pkill|popd|pr|printcap|printenv|printf|ps|pushd|pv|pwd|quota|quotacheck|quotactl|ram|rar|rcp|read|readarray|readonly|reboot|rename|renice|remsync|rev|rm|rmdir|rsync|screen|scp|sdiff|sed|seq|service|sftp|shift|shopt|shutdown|sleep|slocate|sort|source|split|ssh|stat|strace|su|sudo|sum|suspend|sync|tail|tar|tee|test|time|timeout|times|touch|top|traceroute|trap|tr|tsort|tty|type|ulimit|umask|umount|unalias|uname|unexpand|uniq|units|unrar|unshar|uptime|useradd|userdel|usermod|users|uuencode|uudecode|v|vdir|vi|vmstat|wait|watch|wc|wget|whereis|which|who|whoami|write|xargs|xdg-open|yes|zip)(?=$|\s|;|\||&)/,lookbehind:!0},keyword:{pattern:/(^|\s|;|\||&)(?:let|:|\.|if|then|else|elif|fi|for|break|continue|while|in|case|function|select|do|done|until|echo|exit|return|set|declare)(?=$|\s|;|\||&)/,lookbehind:!0},"boolean":{pattern:/(^|\s|;|\||&)(?:true|false)(?=$|\s|;|\||&)/,lookbehind:!0},operator:/&&?|\|\|?|==?|!=?|<<<?|>>|<=?|>=?|=~/,punctuation:/\$?\(\(?|\)\)?|\.\.|[{}[\];]/};var a=t.variable[1].inside;a["function"]=e.languages.bash["function"],a.keyword=e.languages.bash.keyword,a.boolean=e.languages.bash.boolean,a.operator=e.languages.bash.operator,a.punctuation=e.languages.bash.punctuation}(Prism);
+Prism.languages.c=Prism.languages.extend("clike",{keyword:/\b(asm|typeof|inline|auto|break|case|char|const|continue|default|do|double|else|enum|extern|float|for|goto|if|int|long|register|return|short|signed|sizeof|static|struct|switch|typedef|union|unsigned|void|volatile|while)\b/,operator:/\-[>-]?|\+\+?|!=?|<<?=?|>>?=?|==?|&&?|\|?\||[~^%?*\/]/,number:/\b-?(?:0x[\da-f]+|\d*\.?\d+(?:e[+-]?\d+)?)[ful]*\b/i}),Prism.languages.insertBefore("c","string",{macro:{pattern:/(^\s*)#\s*[a-z]+([^\r\n\\]|\\.|\\(?:\r\n?|\n))*/im,lookbehind:!0,alias:"property",inside:{string:{pattern:/(#\s*include\s*)(<.+?>|("|')(\\?.)+?\3)/,lookbehind:!0},directive:{pattern:/(#\s*)\b(define|elif|else|endif|error|ifdef|ifndef|if|import|include|line|pragma|undef|using)\b/,lookbehind:!0,alias:"keyword"}}},constant:/\b(__FILE__|__LINE__|__DATE__|__TIME__|__TIMESTAMP__|__func__|EOF|NULL|stdin|stdout|stderr)\b/}),delete Prism.languages.c["class-name"],delete Prism.languages.c["boolean"];
+Prism.languages.csharp=Prism.languages.extend("clike",{keyword:/\b(abstract|as|async|await|base|bool|break|byte|case|catch|char|checked|class|const|continue|decimal|default|delegate|do|double|else|enum|event|explicit|extern|false|finally|fixed|float|for|foreach|goto|if|implicit|in|int|interface|internal|is|lock|long|namespace|new|null|object|operator|out|override|params|private|protected|public|readonly|ref|return|sbyte|sealed|short|sizeof|stackalloc|static|string|struct|switch|this|throw|true|try|typeof|uint|ulong|unchecked|unsafe|ushort|using|virtual|void|volatile|while|add|alias|ascending|async|await|descending|dynamic|from|get|global|group|into|join|let|orderby|partial|remove|select|set|value|var|where|yield)\b/,string:[/@("|')(\1\1|\\\1|\\?(?!\1)[\s\S])*\1/,/("|')(\\?.)*?\1/],number:/\b-?(0x[\da-f]+|\d*\.?\d+f?)\b/i}),Prism.languages.insertBefore("csharp","keyword",{"generic-method":{pattern:/[a-z0-9_]+\s*<[^>\r\n]+?>\s*(?=\()/i,alias:"function",inside:{keyword:Prism.languages.csharp.keyword,punctuation:/[<>(),.:]/}},preprocessor:{pattern:/(^\s*)#.*/m,lookbehind:!0,alias:"property",inside:{directive:{pattern:/(\s*#)\b(define|elif|else|endif|endregion|error|if|line|pragma|region|undef|warning)\b/,lookbehind:!0,alias:"keyword"}}}});
+Prism.languages.cpp=Prism.languages.extend("c",{keyword:/\b(alignas|alignof|asm|auto|bool|break|case|catch|char|char16_t|char32_t|class|compl|const|constexpr|const_cast|continue|decltype|default|delete|do|double|dynamic_cast|else|enum|explicit|export|extern|float|for|friend|goto|if|inline|int|long|mutable|namespace|new|noexcept|nullptr|operator|private|protected|public|register|reinterpret_cast|return|short|signed|sizeof|static|static_assert|static_cast|struct|switch|template|this|thread_local|throw|try|typedef|typeid|typename|union|unsigned|using|virtual|void|volatile|wchar_t|while)\b/,"boolean":/\b(true|false)\b/,operator:/[-+]{1,2}|!=?|<{1,2}=?|>{1,2}=?|\->|:{1,2}|={1,2}|\^|~|%|&{1,2}|\|?\||\?|\*|\/|\b(and|and_eq|bitand|bitor|not|not_eq|or|or_eq|xor|xor_eq)\b/}),Prism.languages.insertBefore("cpp","keyword",{"class-name":{pattern:/(class\s+)[a-z0-9_]+/i,lookbehind:!0}});
+!function(e){e.languages.ruby=e.languages.extend("clike",{comment:/#(?!\{[^\r\n]*?\}).*/,keyword:/\b(alias|and|BEGIN|begin|break|case|class|def|define_method|defined|do|each|else|elsif|END|end|ensure|false|for|if|in|module|new|next|nil|not|or|raise|redo|require|rescue|retry|return|self|super|then|throw|true|undef|unless|until|when|while|yield)\b/});var n={pattern:/#\{[^}]+\}/,inside:{delimiter:{pattern:/^#\{|\}$/,alias:"tag"},rest:e.util.clone(e.languages.ruby)}};e.languages.insertBefore("ruby","keyword",{regex:[{pattern:/%r([^a-zA-Z0-9\s\{\(\[<])(?:[^\\]|\\[\s\S])*?\1[gim]{0,3}/,inside:{interpolation:n}},{pattern:/%r\((?:[^()\\]|\\[\s\S])*\)[gim]{0,3}/,inside:{interpolation:n}},{pattern:/%r\{(?:[^#{}\\]|#(?:\{[^}]+\})?|\\[\s\S])*\}[gim]{0,3}/,inside:{interpolation:n}},{pattern:/%r\[(?:[^\[\]\\]|\\[\s\S])*\][gim]{0,3}/,inside:{interpolation:n}},{pattern:/%r<(?:[^<>\\]|\\[\s\S])*>[gim]{0,3}/,inside:{interpolation:n}},{pattern:/(^|[^\/])\/(?!\/)(\[.+?]|\\.|[^\/\r\n])+\/[gim]{0,3}(?=\s*($|[\r\n,.;})]))/,lookbehind:!0}],variable:/[@$]+[a-zA-Z_][a-zA-Z_0-9]*(?:[?!]|\b)/,symbol:/:[a-zA-Z_][a-zA-Z_0-9]*(?:[?!]|\b)/}),e.languages.insertBefore("ruby","number",{builtin:/\b(Array|Bignum|Binding|Class|Continuation|Dir|Exception|FalseClass|File|Stat|File|Fixnum|Float|Hash|Integer|IO|MatchData|Method|Module|NilClass|Numeric|Object|Proc|Range|Regexp|String|Struct|TMS|Symbol|ThreadGroup|Thread|Time|TrueClass)\b/,constant:/\b[A-Z][a-zA-Z_0-9]*(?:[?!]|\b)/}),e.languages.ruby.string=[{pattern:/%[qQiIwWxs]?([^a-zA-Z0-9\s\{\(\[<])(?:[^\\]|\\[\s\S])*?\1/,greedy:!0,inside:{interpolation:n}},{pattern:/%[qQiIwWxs]?\((?:[^()\\]|\\[\s\S])*\)/,greedy:!0,inside:{interpolation:n}},{pattern:/%[qQiIwWxs]?\{(?:[^#{}\\]|#(?:\{[^}]+\})?|\\[\s\S])*\}/,greedy:!0,inside:{interpolation:n}},{pattern:/%[qQiIwWxs]?\[(?:[^\[\]\\]|\\[\s\S])*\]/,greedy:!0,inside:{interpolation:n}},{pattern:/%[qQiIwWxs]?<(?:[^<>\\]|\\[\s\S])*>/,greedy:!0,inside:{interpolation:n}},{pattern:/("|')(#\{[^}]+\}|\\(?:\r?\n|\r)|\\?.)*?\1/,greedy:!0,inside:{interpolation:n}}]}(Prism);
+Prism.languages.docker={keyword:{pattern:/(^\s*)(?:ONBUILD|FROM|MAINTAINER|RUN|EXPOSE|ENV|ADD|COPY|VOLUME|USER|WORKDIR|CMD|LABEL|ENTRYPOINT)(?=\s)/im,lookbehind:!0},string:/("|')(?:(?!\1)[^\\\r\n]|\\(?:\r\n|[\s\S]))*?\1/,comment:/#.*/,punctuation:/---|\.\.\.|[:[\]{}\-,|>?]/};
+Prism.languages.ebnf={ruleheading:/([A-Z])\w.+?(:|\*:)\s/,literal:/'.+?'/,actions:{pattern:/{[A-Za-z].+?}/,inside:{ebnfkeyword:/fragment|true|false|current/}},ruleterminal:/;/,semi:/(s|S)emi/,multilinecomment:[{pattern:/(^|[^\\])\/\*[\w\W]*?\*\//,lookbehind:!0},{pattern:/(^|[^\\:])\/\/.*/,lookbehind:!0}],type:{pattern:/\[.+\]/,inside:{typereference:/[^\]+?[^\|]+/}},rulestructure:/(\?|\(|\)|\*|\||(\+^=))/,ebnfkeyword:/fragment|true|false|current/},Prism.languages.xtext=Prism.languages.ebnf;
+Prism.languages.git={comment:/^#.*/m,deleted:/^[-–].*/m,inserted:/^\+.*/m,string:/("|')(\\?.)*?\1/m,command:{pattern:/^.*\$ git .*$/m,inside:{parameter:/\s(--|-)\w+/m}},coord:/^@@.*@@$/m,commit_sha1:/^commit \w{40}$/m};
+Prism.languages.go=Prism.languages.extend("clike",{keyword:/\b(break|case|chan|const|continue|default|defer|else|fallthrough|for|func|go(to)?|if|import|interface|map|package|range|return|select|struct|switch|type|var)\b/,builtin:/\b(bool|byte|complex(64|128)|error|float(32|64)|rune|string|u?int(8|16|32|64|)|uintptr|append|cap|close|complex|copy|delete|imag|len|make|new|panic|print(ln)?|real|recover)\b/,"boolean":/\b(_|iota|nil|true|false)\b/,operator:/[*\/%^!=]=?|\+[=+]?|-[=-]?|\|[=|]?|&(?:=|&|\^=?)?|>(?:>=?|=)?|<(?:<=?|=|-)?|:=|\.\.\./,number:/\b(-?(0x[a-f\d]+|(\d+\.?\d*|\.\d+)(e[-+]?\d+)?)i?)\b/i,string:/("|'|`)(\\?.|\r|\n)*?\1/}),delete Prism.languages.go["class-name"];
+Prism.languages.groovy=Prism.languages.extend("clike",{keyword:/\b(as|def|in|abstract|assert|boolean|break|byte|case|catch|char|class|const|continue|default|do|double|else|enum|extends|final|finally|float|for|goto|if|implements|import|instanceof|int|interface|long|native|new|package|private|protected|public|return|short|static|strictfp|super|switch|synchronized|this|throw|throws|trait|transient|try|void|volatile|while)\b/,string:[{pattern:/("""|''')[\W\w]*?\1|(\$\/)(\$\/\$|[\W\w])*?\/\$/,greedy:!0},{pattern:/("|'|\/)(?:\\?.)*?\1/,greedy:!0}],number:/\b(?:0b[01_]+|0x[\da-f_]+(?:\.[\da-f_p\-]+)?|[\d_]+(?:\.[\d_]+)?(?:e[+-]?[\d]+)?)[glidf]?\b/i,operator:{pattern:/(^|[^.])(~|==?~?|\?[.:]?|\*(?:[.=]|\*=?)?|\.[@&]|\.\.<|\.{1,2}(?!\.)|-[-=>]?|\+[+=]?|!=?|<(?:<=?|=>?)?|>(?:>>?=?|=)?|&[&=]?|\|[|=]?|\/=?|\^=?|%=?)/,lookbehind:!0},punctuation:/\.+|[{}[\];(),:$]/}),Prism.languages.insertBefore("groovy","string",{shebang:{pattern:/#!.+/,alias:"comment"}}),Prism.languages.insertBefore("groovy","punctuation",{"spock-block":/\b(setup|given|when|then|and|cleanup|expect|where):/}),Prism.languages.insertBefore("groovy","function",{annotation:{alias:"punctuation",pattern:/(^|[^.])@\w+/,lookbehind:!0}}),Prism.hooks.add("wrap",function(e){if("groovy"===e.language&&"string"===e.type){var t=e.content[0];if("'"!=t){var n=/([^\\])(\$(\{.*?\}|[\w\.]+))/;"$"===t&&(n=/([^\$])(\$(\{.*?\}|[\w\.]+))/),e.content=e.content.replace(/&lt;/g,"<").replace(/&amp;/g,"&"),e.content=Prism.highlight(e.content,{expression:{pattern:n,lookbehind:!0,inside:Prism.languages.groovy}}),e.classes.push("/"===t?"regex":"gstring")}}});
+Prism.languages.http={"request-line":{pattern:/^(POST|GET|PUT|DELETE|OPTIONS|PATCH|TRACE|CONNECT)\b\shttps?:\/\/\S+\sHTTP\/[0-9.]+/m,inside:{property:/^(POST|GET|PUT|DELETE|OPTIONS|PATCH|TRACE|CONNECT)\b/,"attr-name":/:\w+/}},"response-status":{pattern:/^HTTP\/1.[01] [0-9]+.*/m,inside:{property:{pattern:/(^HTTP\/1.[01] )[0-9]+.*/i,lookbehind:!0}}},"header-name":{pattern:/^[\w-]+:(?=.)/m,alias:"keyword"}};var httpLanguages={"application/json":Prism.languages.javascript,"application/xml":Prism.languages.markup,"text/xml":Prism.languages.markup,"text/html":Prism.languages.markup};for(var contentType in httpLanguages)if(httpLanguages[contentType]){var options={};options[contentType]={pattern:new RegExp("(content-type:\\s*"+contentType+"[\\w\\W]*?)(?:\\r?\\n|\\r){2}[\\w\\W]*","i"),lookbehind:!0,inside:{rest:httpLanguages[contentType]}},Prism.languages.insertBefore("http","header-name",options)};
+Prism.languages.ini={comment:/^[ \t]*;.*$/m,selector:/^[ \t]*\[.*?\]/m,constant:/^[ \t]*[^\s=]+?(?=[ \t]*=)/m,"attr-value":{pattern:/=.*/,inside:{punctuation:/^[=]/}}};
+Prism.languages.java=Prism.languages.extend("clike",{keyword:/\b(abstract|continue|for|new|switch|assert|default|goto|package|synchronized|boolean|do|if|private|this|break|double|implements|protected|throw|byte|else|import|public|throws|case|enum|instanceof|return|transient|catch|extends|int|short|try|char|final|interface|static|void|class|finally|long|strictfp|volatile|const|float|native|super|while)\b/,number:/\b0b[01]+\b|\b0x[\da-f]*\.?[\da-fp\-]+\b|\b\d*\.?\d+(?:e[+-]?\d+)?[df]?\b/i,operator:{pattern:/(^|[^.])(?:\+[+=]?|-[-=]?|!=?|<<?=?|>>?>?=?|==?|&[&=]?|\|[|=]?|\*=?|\/=?|%=?|\^=?|[?:~])/m,lookbehind:!0}}),Prism.languages.insertBefore("java","function",{annotation:{alias:"punctuation",pattern:/(^|[^.])@\w+/,lookbehind:!0}});
+Prism.languages.json={property:/"(?:\\.|[^|"])*"(?=\s*:)/gi,string:/"(?!:)(?:\\.|[^|"])*"(?!:)/g,number:/\b-?(0x[\dA-Fa-f]+|\d*\.?\d+([Ee][+-]?\d+)?)\b/g,punctuation:/[{}[\]);,]/g,operator:/:/g,"boolean":/\b(true|false)\b/gi,"null":/\bnull\b/gi},Prism.languages.jsonp=Prism.languages.json;
+!function(a){var e=/\\([^a-z()[\]]|[a-z\*]+)/i,n={"equation-command":{pattern:e,alias:"regex"}};a.languages.latex={comment:/%.*/m,cdata:{pattern:/(\\begin\{((?:verbatim|lstlisting)\*?)\})([\w\W]*?)(?=\\end\{\2\})/,lookbehind:!0},equation:[{pattern:/\$(?:\\?[\w\W])*?\$|\\\((?:\\?[\w\W])*?\\\)|\\\[(?:\\?[\w\W])*?\\\]/,inside:n,alias:"string"},{pattern:/(\\begin\{((?:equation|math|eqnarray|align|multline|gather)\*?)\})([\w\W]*?)(?=\\end\{\2\})/,lookbehind:!0,inside:n,alias:"string"}],keyword:{pattern:/(\\(?:begin|end|ref|cite|label|usepackage|documentclass)(?:\[[^\]]+\])?\{)[^}]+(?=\})/,lookbehind:!0},url:{pattern:/(\\url\{)[^}]+(?=\})/,lookbehind:!0},headline:{pattern:/(\\(?:part|chapter|section|subsection|frametitle|subsubsection|paragraph|subparagraph|subsubparagraph|subsubsubparagraph)\*?(?:\[[^\]]+\])?\{)[^}]+(?=\}(?:\[[^\]]+\])?)/,lookbehind:!0,alias:"class-name"},"function":{pattern:e,alias:"selector"},punctuation:/[[\]{}&]/}}(Prism);
+Prism.languages.lua={comment:/^#!.+|--(?:\[(=*)\[[\s\S]*?\]\1\]|.*)/m,string:{pattern:/(["'])(?:(?!\1)[^\\\r\n]|\\z(?:\r\n|\s)|\\(?:\r\n|[\s\S]))*\1|\[(=*)\[[\s\S]*?\]\2\]/,greedy:!0},number:/\b0x[a-f\d]+\.?[a-f\d]*(?:p[+-]?\d+)?\b|\b\d+(?:\.\B|\.?\d*(?:e[+-]?\d+)?\b)|\B\.\d+(?:e[+-]?\d+)?\b/i,keyword:/\b(?:and|break|do|else|elseif|end|false|for|function|goto|if|in|local|nil|not|or|repeat|return|then|true|until|while)\b/,"function":/(?!\d)\w+(?=\s*(?:[({]))/,operator:[/[-+*%^&|#]|\/\/?|<[<=]?|>[>=]?|[=~]=?/,{pattern:/(^|[^.])\.\.(?!\.)/,lookbehind:!0}],punctuation:/[\[\](){},;]|\.+|:+/};
+Prism.languages.markdown=Prism.languages.extend("markup",{}),Prism.languages.insertBefore("markdown","prolog",{blockquote:{pattern:/^>(?:[\t ]*>)*/m,alias:"punctuation"},code:[{pattern:/^(?: {4}|\t).+/m,alias:"keyword"},{pattern:/``.+?``|`[^`\n]+`/,alias:"keyword"}],title:[{pattern:/\w+.*(?:\r?\n|\r)(?:==+|--+)/,alias:"important",inside:{punctuation:/==+$|--+$/}},{pattern:/(^\s*)#+.+/m,lookbehind:!0,alias:"important",inside:{punctuation:/^#+|#+$/}}],hr:{pattern:/(^\s*)([*-])([\t ]*\2){2,}(?=\s*$)/m,lookbehind:!0,alias:"punctuation"},list:{pattern:/(^\s*)(?:[*+-]|\d+\.)(?=[\t ].)/m,lookbehind:!0,alias:"punctuation"},"url-reference":{pattern:/!?\[[^\]]+\]:[\t ]+(?:\S+|<(?:\\.|[^>\\])+>)(?:[\t ]+(?:"(?:\\.|[^"\\])*"|'(?:\\.|[^'\\])*'|\((?:\\.|[^)\\])*\)))?/,inside:{variable:{pattern:/^(!?\[)[^\]]+/,lookbehind:!0},string:/(?:"(?:\\.|[^"\\])*"|'(?:\\.|[^'\\])*'|\((?:\\.|[^)\\])*\))$/,punctuation:/^[\[\]!:]|[<>]/},alias:"url"},bold:{pattern:/(^|[^\\])(\*\*|__)(?:(?:\r?\n|\r)(?!\r?\n|\r)|.)+?\2/,lookbehind:!0,inside:{punctuation:/^\*\*|^__|\*\*$|__$/}},italic:{pattern:/(^|[^\\])([*_])(?:(?:\r?\n|\r)(?!\r?\n|\r)|.)+?\2/,lookbehind:!0,inside:{punctuation:/^[*_]|[*_]$/}},url:{pattern:/!?\[[^\]]+\](?:\([^\s)]+(?:[\t ]+"(?:\\.|[^"\\])*")?\)| ?\[[^\]\n]*\])/,inside:{variable:{pattern:/(!?\[)[^\]]+(?=\]$)/,lookbehind:!0},string:{pattern:/"(?:\\.|[^"\\])*"(?=\)$)/}}}}),Prism.languages.markdown.bold.inside.url=Prism.util.clone(Prism.languages.markdown.url),Prism.languages.markdown.italic.inside.url=Prism.util.clone(Prism.languages.markdown.url),Prism.languages.markdown.bold.inside.italic=Prism.util.clone(Prism.languages.markdown.italic),Prism.languages.markdown.italic.inside.bold=Prism.util.clone(Prism.languages.markdown.bold);
+Prism.languages.n4js=Prism.languages.extend("javascript",{n4jsannotation:/@Binder|@Bind|@Test|@UseBinder|@This|@@ProvidedByRuntime|@@Global|@Inject|@Internal|@Undefined|@StringBased|@Final|@GenerateInjector|@WithParentInjector|@Spec|@Override|@Promisifiable|@Promisify|@This|@N4JS|@IgnoreImplementation|@Global|@ProvidedByRuntime|@TestAPI|@Polyfill|@StaticPolyfillAware|@StaticPolyfillModule|@StaticPolyfill|@Transient|@IDEBUG/,keyword:/\b(break|case|catch|class|const|continue|debugger|default|delete|do|else|enum|export|extends|false|finally|for|from|function|get|if|implements|import|in|instanceof|interface|let|new|null|package|private|protected|public|return|set|static|super|switch|this|throw|true|try|typeof|var|void|while|with|yield|module|declare|constructor|string|Function|any|number|boolean|Array|enum)\b/}),Prism.languages.ts=Prism.languages.n4js;
++!function(a){var e=a.util.clone(a.languages.n4js);a.languages.n4jsx=a.languages.extend("markup",e),a.languages.n4jsx.tag.pattern=/<\/?[\w\.:-]+\s*(?:\s+[\w\.:-]+(?:=(?:("|')(\\?[\w\W])*?\1|[^\s'">=]+|(\{[\w\W]*?\})))?\s*)*\/?>/i,a.languages.n4jsx.tag.inside["attr-value"].pattern=/=[^\{](?:('|")[\w\W]*?(\1)|[^\s>]+)/i;var s=a.util.clone(a.languages.n4jsx);delete s.punctuation,s=a.languages.insertBefore("n4jsx","operator",{punctuation:/=(?={)|[{}[\];(),.:]/},{n4jsx:s}),a.languages.insertBefore("inside","attr-value",{script:{pattern:/=(\{(?:\{[^}]*\}|[^}])+\})/i,inside:s,alias:"language-javascript"}},a.languages.n4jsx.tag)}(Prism);
+Prism.languages.n4mf=Prism.languages.extend("n4js",{keyword:/ProjectId|VendorId|VendorName|ProjectType|ProjectVersion|Output|Sources|TestedProjects|ProjectDependencies|RequiredRuntimeLibraries/i}),Prism.languages.json=Prism.languages.n4mf;
+Prism.languages.nginx=Prism.languages.extend("clike",{comment:{pattern:/(^|[^"{\\])#.*/,lookbehind:!0},keyword:/\b(?:CONTENT_|DOCUMENT_|GATEWAY_|HTTP_|HTTPS|if_not_empty|PATH_|QUERY_|REDIRECT_|REMOTE_|REQUEST_|SCGI|SCRIPT_|SERVER_|http|server|events|location|include|accept_mutex|accept_mutex_delay|access_log|add_after_body|add_before_body|add_header|addition_types|aio|alias|allow|ancient_browser|ancient_browser_value|auth|auth_basic|auth_basic_user_file|auth_http|auth_http_header|auth_http_timeout|autoindex|autoindex_exact_size|autoindex_localtime|break|charset|charset_map|charset_types|chunked_transfer_encoding|client_body_buffer_size|client_body_in_file_only|client_body_in_single_buffer|client_body_temp_path|client_body_timeout|client_header_buffer_size|client_header_timeout|client_max_body_size|connection_pool_size|create_full_put_path|daemon|dav_access|dav_methods|debug_connection|debug_points|default_type|deny|devpoll_changes|devpoll_events|directio|directio_alignment|disable_symlinks|empty_gif|env|epoll_events|error_log|error_page|expires|fastcgi_buffer_size|fastcgi_buffers|fastcgi_busy_buffers_size|fastcgi_cache|fastcgi_cache_bypass|fastcgi_cache_key|fastcgi_cache_lock|fastcgi_cache_lock_timeout|fastcgi_cache_methods|fastcgi_cache_min_uses|fastcgi_cache_path|fastcgi_cache_purge|fastcgi_cache_use_stale|fastcgi_cache_valid|fastcgi_connect_timeout|fastcgi_hide_header|fastcgi_ignore_client_abort|fastcgi_ignore_headers|fastcgi_index|fastcgi_intercept_errors|fastcgi_keep_conn|fastcgi_max_temp_file_size|fastcgi_next_upstream|fastcgi_no_cache|fastcgi_param|fastcgi_pass|fastcgi_pass_header|fastcgi_read_timeout|fastcgi_redirect_errors|fastcgi_send_timeout|fastcgi_split_path_info|fastcgi_store|fastcgi_store_access|fastcgi_temp_file_write_size|fastcgi_temp_path|flv|geo|geoip_city|geoip_country|google_perftools_profiles|gzip|gzip_buffers|gzip_comp_level|gzip_disable|gzip_http_version|gzip_min_length|gzip_proxied|gzip_static|gzip_types|gzip_vary|if|if_modified_since|ignore_invalid_headers|image_filter|image_filter_buffer|image_filter_jpeg_quality|image_filter_sharpen|image_filter_transparency|imap_capabilities|imap_client_buffer|include|index|internal|ip_hash|keepalive|keepalive_disable|keepalive_requests|keepalive_timeout|kqueue_changes|kqueue_events|large_client_header_buffers|limit_conn|limit_conn_log_level|limit_conn_zone|limit_except|limit_rate|limit_rate_after|limit_req|limit_req_log_level|limit_req_zone|limit_zone|lingering_close|lingering_time|lingering_timeout|listen|location|lock_file|log_format|log_format_combined|log_not_found|log_subrequest|map|map_hash_bucket_size|map_hash_max_size|master_process|max_ranges|memcached_buffer_size|memcached_connect_timeout|memcached_next_upstream|memcached_pass|memcached_read_timeout|memcached_send_timeout|merge_slashes|min_delete_depth|modern_browser|modern_browser_value|mp4|mp4_buffer_size|mp4_max_buffer_size|msie_padding|msie_refresh|multi_accept|open_file_cache|open_file_cache_errors|open_file_cache_min_uses|open_file_cache_valid|open_log_file_cache|optimize_server_names|override_charset|pcre_jit|perl|perl_modules|perl_require|perl_set|pid|pop3_auth|pop3_capabilities|port_in_redirect|post_action|postpone_output|protocol|proxy|proxy_buffer|proxy_buffer_size|proxy_buffering|proxy_buffers|proxy_busy_buffers_size|proxy_cache|proxy_cache_bypass|proxy_cache_key|proxy_cache_lock|proxy_cache_lock_timeout|proxy_cache_methods|proxy_cache_min_uses|proxy_cache_path|proxy_cache_use_stale|proxy_cache_valid|proxy_connect_timeout|proxy_cookie_domain|proxy_cookie_path|proxy_headers_hash_bucket_size|proxy_headers_hash_max_size|proxy_hide_header|proxy_http_version|proxy_ignore_client_abort|proxy_ignore_headers|proxy_intercept_errors|proxy_max_temp_file_size|proxy_method|proxy_next_upstream|proxy_no_cache|proxy_pass|proxy_pass_error_message|proxy_pass_header|proxy_pass_request_body|proxy_pass_request_headers|proxy_read_timeout|proxy_redirect|proxy_redirect_errors|proxy_send_lowat|proxy_send_timeout|proxy_set_body|proxy_set_header|proxy_ssl_session_reuse|proxy_store|proxy_store_access|proxy_temp_file_write_size|proxy_temp_path|proxy_timeout|proxy_upstream_fail_timeout|proxy_upstream_max_fails|random_index|read_ahead|real_ip_header|recursive_error_pages|request_pool_size|reset_timedout_connection|resolver|resolver_timeout|return|rewrite|root|rtsig_overflow_events|rtsig_overflow_test|rtsig_overflow_threshold|rtsig_signo|satisfy|satisfy_any|secure_link_secret|send_lowat|send_timeout|sendfile|sendfile_max_chunk|server|server_name|server_name_in_redirect|server_names_hash_bucket_size|server_names_hash_max_size|server_tokens|set|set_real_ip_from|smtp_auth|smtp_capabilities|so_keepalive|source_charset|split_clients|ssi|ssi_silent_errors|ssi_types|ssi_value_length|ssl|ssl_certificate|ssl_certificate_key|ssl_ciphers|ssl_client_certificate|ssl_crl|ssl_dhparam|ssl_engine|ssl_prefer_server_ciphers|ssl_protocols|ssl_session_cache|ssl_session_timeout|ssl_verify_client|ssl_verify_depth|starttls|stub_status|sub_filter|sub_filter_once|sub_filter_types|tcp_nodelay|tcp_nopush|timeout|timer_resolution|try_files|types|types_hash_bucket_size|types_hash_max_size|underscores_in_headers|uninitialized_variable_warn|upstream|use|user|userid|userid_domain|userid_expires|userid_name|userid_p3p|userid_path|userid_service|valid_referers|variables_hash_bucket_size|variables_hash_max_size|worker_connections|worker_cpu_affinity|worker_priority|worker_processes|worker_rlimit_core|worker_rlimit_nofile|worker_rlimit_sigpending|working_directory|xclient|xml_entities|xslt_entities|xslt_stylesheet|xslt_types)\b/i}),Prism.languages.insertBefore("nginx","keyword",{variable:/\$[a-z_]+/i});
+Prism.languages.nix={comment:/\/\*[\s\S]*?\*\/|#.*/,string:{pattern:/"(?:[^"\\]|\\[\s\S])*"|''(?:(?!'')[\s\S]|''(?:'|\\|\$\{))*''/,inside:{interpolation:{pattern:/(^|(?:^|(?!'').)[^\\])\$\{(?:[^}]|\{[^}]*\})*}/,lookbehind:!0,inside:{antiquotation:{pattern:/^\$(?=\{)/,alias:"variable"}}}}},url:[/\b(?:[a-z]{3,7}:\/\/)[\w\-+%~\/.:#=?&]+/,{pattern:/([^\/])(?:[\w\-+%~.:#=?&]*(?!\/\/)[\w\-+%~\/.:#=?&])?(?!\/\/)\/[\w\-+%~\/.:#=?&]*/,lookbehind:!0}],antiquotation:{pattern:/\$(?=\{)/,alias:"variable"},number:/\b\d+\b/,keyword:/\b(?:assert|builtins|else|if|in|inherit|let|null|or|then|with)\b/,"function":/\b(?:abort|add|all|any|attrNames|attrValues|baseNameOf|compareVersions|concatLists|currentSystem|deepSeq|derivation|dirOf|div|elem(?:At)?|fetch(?:url|Tarball)|filter(?:Source)?|fromJSON|genList|getAttr|getEnv|hasAttr|hashString|head|import|intersectAttrs|is(?:Attrs|Bool|Function|Int|List|Null|String)|length|lessThan|listToAttrs|map|mul|parseDrvName|pathExists|read(?:Dir|File)|removeAttrs|replaceStrings|seq|sort|stringLength|sub(?:string)?|tail|throw|to(?:File|JSON|Path|String|XML)|trace|typeOf)\b|\bfoldl'\B/,"boolean":/\b(?:true|false)\b/,operator:/[=!<>]=?|\+\+?|\|\||&&|\/\/|->?|[?@]/,punctuation:/[{}()[\].,:;]/},Prism.languages.nix.string.inside.interpolation.inside.rest=Prism.util.clone(Prism.languages.nix);
+Prism.languages.perl={comment:[{pattern:/(^\s*)=\w+[\s\S]*?=cut.*/m,lookbehind:!0},{pattern:/(^|[^\\$])#.*/,lookbehind:!0}],string:[/\b(?:q|qq|qx|qw)\s*([^a-zA-Z0-9\s\{\(\[<])(?:[^\\]|\\[\s\S])*?\1/,/\b(?:q|qq|qx|qw)\s+([a-zA-Z0-9])(?:[^\\]|\\[\s\S])*?\1/,/\b(?:q|qq|qx|qw)\s*\((?:[^()\\]|\\[\s\S])*\)/,/\b(?:q|qq|qx|qw)\s*\{(?:[^{}\\]|\\[\s\S])*\}/,/\b(?:q|qq|qx|qw)\s*\[(?:[^[\]\\]|\\[\s\S])*\]/,/\b(?:q|qq|qx|qw)\s*<(?:[^<>\\]|\\[\s\S])*>/,/("|`)(?:[^\\]|\\[\s\S])*?\1/,/'(?:[^'\\\r\n]|\\.)*'/],regex:[/\b(?:m|qr)\s*([^a-zA-Z0-9\s\{\(\[<])(?:[^\\]|\\[\s\S])*?\1[msixpodualngc]*/,/\b(?:m|qr)\s+([a-zA-Z0-9])(?:[^\\]|\\.)*?\1[msixpodualngc]*/,/\b(?:m|qr)\s*\((?:[^()\\]|\\[\s\S])*\)[msixpodualngc]*/,/\b(?:m|qr)\s*\{(?:[^{}\\]|\\[\s\S])*\}[msixpodualngc]*/,/\b(?:m|qr)\s*\[(?:[^[\]\\]|\\[\s\S])*\][msixpodualngc]*/,/\b(?:m|qr)\s*<(?:[^<>\\]|\\[\s\S])*>[msixpodualngc]*/,{pattern:/(^|[^-]\b)(?:s|tr|y)\s*([^a-zA-Z0-9\s\{\(\[<])(?:[^\\]|\\[\s\S])*?\2(?:[^\\]|\\[\s\S])*?\2[msixpodualngcer]*/,lookbehind:!0},{pattern:/(^|[^-]\b)(?:s|tr|y)\s+([a-zA-Z0-9])(?:[^\\]|\\[\s\S])*?\2(?:[^\\]|\\[\s\S])*?\2[msixpodualngcer]*/,lookbehind:!0},{pattern:/(^|[^-]\b)(?:s|tr|y)\s*\((?:[^()\\]|\\[\s\S])*\)\s*\((?:[^()\\]|\\[\s\S])*\)[msixpodualngcer]*/,lookbehind:!0},{pattern:/(^|[^-]\b)(?:s|tr|y)\s*\{(?:[^{}\\]|\\[\s\S])*\}\s*\{(?:[^{}\\]|\\[\s\S])*\}[msixpodualngcer]*/,lookbehind:!0},{pattern:/(^|[^-]\b)(?:s|tr|y)\s*\[(?:[^[\]\\]|\\[\s\S])*\]\s*\[(?:[^[\]\\]|\\[\s\S])*\][msixpodualngcer]*/,lookbehind:!0},{pattern:/(^|[^-]\b)(?:s|tr|y)\s*<(?:[^<>\\]|\\[\s\S])*>\s*<(?:[^<>\\]|\\[\s\S])*>[msixpodualngcer]*/,lookbehind:!0},/\/(?:[^\/\\\r\n]|\\.)*\/[msixpodualngc]*(?=\s*(?:$|[\r\n,.;})&|\-+*~<>!?^]|(lt|gt|le|ge|eq|ne|cmp|not|and|or|xor|x)\b))/],variable:[/[&*$@%]\{\^[A-Z]+\}/,/[&*$@%]\^[A-Z_]/,/[&*$@%]#?(?=\{)/,/[&*$@%]#?((::)*'?(?!\d)[\w$]+)+(::)*/i,/[&*$@%]\d+/,/(?!%=)[$@%][!"#$%&'()*+,\-.\/:;<=>?@[\\\]^_`{|}~]/],filehandle:{pattern:/<(?![<=])\S*>|\b_\b/,alias:"symbol"},vstring:{pattern:/v\d+(\.\d+)*|\d+(\.\d+){2,}/,alias:"string"},"function":{pattern:/sub [a-z0-9_]+/i,inside:{keyword:/sub/}},keyword:/\b(any|break|continue|default|delete|die|do|else|elsif|eval|for|foreach|given|goto|if|last|local|my|next|our|package|print|redo|require|say|state|sub|switch|undef|unless|until|use|when|while)\b/,number:/\b-?(0x[\dA-Fa-f](_?[\dA-Fa-f])*|0b[01](_?[01])*|(\d(_?\d)*)?\.?\d(_?\d)*([Ee][+-]?\d+)?)\b/,operator:/-[rwxoRWXOezsfdlpSbctugkTBMAC]\b|\+[+=]?|-[-=>]?|\*\*?=?|\/\/?=?|=[=~>]?|~[~=]?|\|\|?=?|&&?=?|<(?:=>?|<=?)?|>>?=?|![~=]?|[%^]=?|\.(?:=|\.\.?)?|[\\?]|\bx(?:=|\b)|\b(lt|gt|le|ge|eq|ne|cmp|not|and|or|xor)\b/,punctuation:/[{}[\];(),:]/};
+Prism.languages.php=Prism.languages.extend("clike",{keyword:/\b(and|or|xor|array|as|break|case|cfunction|class|const|continue|declare|default|die|do|else|elseif|enddeclare|endfor|endforeach|endif|endswitch|endwhile|extends|for|foreach|function|include|include_once|global|if|new|return|static|switch|use|require|require_once|var|while|abstract|interface|public|implements|private|protected|parent|throw|null|echo|print|trait|namespace|final|yield|goto|instanceof|finally|try|catch)\b/i,constant:/\b[A-Z0-9_]{2,}\b/,comment:{pattern:/(^|[^\\])(?:\/\*[\w\W]*?\*\/|\/\/.*)/,lookbehind:!0,greedy:!0}}),Prism.languages.insertBefore("php","class-name",{"shell-comment":{pattern:/(^|[^\\])#.*/,lookbehind:!0,alias:"comment"}}),Prism.languages.insertBefore("php","keyword",{delimiter:/\?>|<\?(?:php)?/i,variable:/\$\w+\b/i,"package":{pattern:/(\\|namespace\s+|use\s+)[\w\\]+/,lookbehind:!0,inside:{punctuation:/\\/}}}),Prism.languages.insertBefore("php","operator",{property:{pattern:/(->)[\w]+/,lookbehind:!0}}),Prism.languages.markup&&(Prism.hooks.add("before-highlight",function(e){"php"===e.language&&(e.tokenStack=[],e.backupCode=e.code,e.code=e.code.replace(/(?:<\?php|<\?)[\w\W]*?(?:\?>)/gi,function(a){return e.tokenStack.push(a),"{{{PHP"+e.tokenStack.length+"}}}"}))}),Prism.hooks.add("before-insert",function(e){"php"===e.language&&(e.code=e.backupCode,delete e.backupCode)}),Prism.hooks.add("after-highlight",function(e){if("php"===e.language){for(var a,n=0;a=e.tokenStack[n];n++)e.highlightedCode=e.highlightedCode.replace("{{{PHP"+(n+1)+"}}}",Prism.highlight(a,e.grammar,"php").replace(/\$/g,"$$$$"));e.element.innerHTML=e.highlightedCode}}),Prism.hooks.add("wrap",function(e){"php"===e.language&&"markup"===e.type&&(e.content=e.content.replace(/(\{\{\{PHP[0-9]+\}\}\})/g,'<span class="token php">$1</span>'))}),Prism.languages.insertBefore("php","comment",{markup:{pattern:/<[^?]\/?(.*?)>/,inside:Prism.languages.markup},php:/\{\{\{PHP[0-9]+\}\}\}/}));
+Prism.languages.insertBefore("php","variable",{"this":/\$this\b/,global:/\$(?:_(?:SERVER|GET|POST|FILES|REQUEST|SESSION|ENV|COOKIE)|GLOBALS|HTTP_RAW_POST_DATA|argc|argv|php_errormsg|http_response_header)/,scope:{pattern:/\b[\w\\]+::/,inside:{keyword:/(static|self|parent)/,punctuation:/(::|\\)/}}});
+Prism.languages.powershell={comment:[{pattern:/(^|[^`])<#[\w\W]*?#>/,lookbehind:!0},{pattern:/(^|[^`])#.*/,lookbehind:!0}],string:[{pattern:/"(`?[\w\W])*?"/,greedy:!0,inside:{"function":{pattern:/[^`]\$\(.*?\)/,inside:{}}}},{pattern:/'([^']|'')*'/,greedy:!0}],namespace:/\[[a-z][\w\W]*?\]/i,"boolean":/\$(true|false)\b/i,variable:/\$\w+\b/i,"function":[/\b(Add-(Computer|Content|History|Member|PSSnapin|Type)|Checkpoint-Computer|Clear-(Content|EventLog|History|Item|ItemProperty|Variable)|Compare-Object|Complete-Transaction|Connect-PSSession|ConvertFrom-(Csv|Json|StringData)|Convert-Path|ConvertTo-(Csv|Html|Json|Xml)|Copy-(Item|ItemProperty)|Debug-Process|Disable-(ComputerRestore|PSBreakpoint|PSRemoting|PSSessionConfiguration)|Disconnect-PSSession|Enable-(ComputerRestore|PSBreakpoint|PSRemoting|PSSessionConfiguration)|Enter-PSSession|Exit-PSSession|Export-(Alias|Clixml|Console|Csv|FormatData|ModuleMember|PSSession)|ForEach-Object|Format-(Custom|List|Table|Wide)|Get-(Alias|ChildItem|Command|ComputerRestorePoint|Content|ControlPanelItem|Culture|Date|Event|EventLog|EventSubscriber|FormatData|Help|History|Host|HotFix|Item|ItemProperty|Job|Location|Member|Module|Process|PSBreakpoint|PSCallStack|PSDrive|PSProvider|PSSession|PSSessionConfiguration|PSSnapin|Random|Service|TraceSource|Transaction|TypeData|UICulture|Unique|Variable|WmiObject)|Group-Object|Import-(Alias|Clixml|Csv|LocalizedData|Module|PSSession)|Invoke-(Command|Expression|History|Item|RestMethod|WebRequest|WmiMethod)|Join-Path|Limit-EventLog|Measure-(Command|Object)|Move-(Item|ItemProperty)|New-(Alias|Event|EventLog|Item|ItemProperty|Module|ModuleManifest|Object|PSDrive|PSSession|PSSessionConfigurationFile|PSSessionOption|PSTransportOption|Service|TimeSpan|Variable|WebServiceProxy)|Out-(Default|File|GridView|Host|Null|Printer|String)|Pop-Location|Push-Location|Read-Host|Receive-(Job|PSSession)|Register-(EngineEvent|ObjectEvent|PSSessionConfiguration|WmiEvent)|Remove-(Computer|Event|EventLog|Item|ItemProperty|Job|Module|PSBreakpoint|PSDrive|PSSession|PSSnapin|TypeData|Variable|WmiObject)|Rename-(Computer|Item|ItemProperty)|Reset-ComputerMachinePassword|Resolve-Path|Restart-(Computer|Service)|Restore-Computer|Resume-(Job|Service)|Save-Help|Select-(Object|String|Xml)|Send-MailMessage|Set-(Alias|Content|Date|Item|ItemProperty|Location|PSBreakpoint|PSDebug|PSSessionConfiguration|Service|StrictMode|TraceSource|Variable|WmiInstance)|Show-(Command|ControlPanelItem|EventLog)|Sort-Object|Split-Path|Start-(Job|Process|Service|Sleep|Transaction)|Stop-(Computer|Job|Process|Service)|Suspend-(Job|Service)|Tee-Object|Test-(ComputerSecureChannel|Connection|ModuleManifest|Path|PSSessionConfigurationFile)|Trace-Command|Unblock-File|Undo-Transaction|Unregister-(Event|PSSessionConfiguration)|Update-(FormatData|Help|List|TypeData)|Use-Transaction|Wait-(Event|Job|Process)|Where-Object|Write-(Debug|Error|EventLog|Host|Output|Progress|Verbose|Warning))\b/i,/\b(ac|cat|chdir|clc|cli|clp|clv|compare|copy|cp|cpi|cpp|cvpa|dbp|del|diff|dir|ebp|echo|epal|epcsv|epsn|erase|fc|fl|ft|fw|gal|gbp|gc|gci|gcs|gdr|gi|gl|gm|gp|gps|group|gsv|gu|gv|gwmi|iex|ii|ipal|ipcsv|ipsn|irm|iwmi|iwr|kill|lp|ls|measure|mi|mount|move|mp|mv|nal|ndr|ni|nv|ogv|popd|ps|pushd|pwd|rbp|rd|rdr|ren|ri|rm|rmdir|rni|rnp|rp|rv|rvpa|rwmi|sal|saps|sasv|sbp|sc|select|set|shcm|si|sl|sleep|sls|sort|sp|spps|spsv|start|sv|swmi|tee|trcm|type|write)\b/i],keyword:/\b(Begin|Break|Catch|Class|Continue|Data|Define|Do|DynamicParam|Else|ElseIf|End|Exit|Filter|Finally|For|ForEach|From|Function|If|InlineScript|Parallel|Param|Process|Return|Sequence|Switch|Throw|Trap|Try|Until|Using|Var|While|Workflow)\b/i,operator:{pattern:/(\W?)(!|-(eq|ne|gt|ge|lt|le|sh[lr]|not|b?(and|x?or)|(Not)?(Like|Match|Contains|In)|Replace|Join|is(Not)?|as)\b|-[-=]?|\+[+=]?|[*\/%]=?)/i,lookbehind:!0},punctuation:/[|{}[\];(),.]/},Prism.languages.powershell.string[0].inside.boolean=Prism.languages.powershell.boolean,Prism.languages.powershell.string[0].inside.variable=Prism.languages.powershell.variable,Prism.languages.powershell.string[0].inside.function.inside=Prism.util.clone(Prism.languages.powershell);
+Prism.languages.properties={comment:/^[ \t]*[#!].*$/m,"attr-value":{pattern:/(^[ \t]*(?:\\(?:\r\n|[\s\S])|[^\\\s:=])+?(?: *[=:] *| ))(?:\\(?:\r\n|[\s\S])|.)+/m,lookbehind:!0},"attr-name":/^[ \t]*(?:\\(?:\r\n|[\s\S])|[^\\\s:=])+?(?= *[ =:]| )/m,punctuation:/[=:]/};
+Prism.languages.python={"triple-quoted-string":{pattern:/"""[\s\S]+?"""|'''[\s\S]+?'''/,alias:"string"},comment:{pattern:/(^|[^\\])#.*/,lookbehind:!0},string:{pattern:/("|')(?:\\\\|\\?[^\\\r\n])*?\1/,greedy:!0},"function":{pattern:/((?:^|\s)def[ \t]+)[a-zA-Z_][a-zA-Z0-9_]*(?=\()/g,lookbehind:!0},"class-name":{pattern:/(\bclass\s+)[a-z0-9_]+/i,lookbehind:!0},keyword:/\b(?:as|assert|async|await|break|class|continue|def|del|elif|else|except|exec|finally|for|from|global|if|import|in|is|lambda|pass|print|raise|return|try|while|with|yield)\b/,"boolean":/\b(?:True|False)\b/,number:/\b-?(?:0[bo])?(?:(?:\d|0x[\da-f])[\da-f]*\.?\d*|\.\d+)(?:e[+-]?\d+)?j?\b/i,operator:/[-+%=]=?|!=|\*\*?=?|\/\/?=?|<[<=>]?|>[=>]?|[&|^~]|\b(?:or|and|not)\b/,punctuation:/[{}[\];(),.:]/};
+Prism.languages.r={comment:/#.*/,string:/(['"])(?:\\?.)*?\1/,"percent-operator":{pattern:/%[^%\s]*%/,alias:"operator"},"boolean":/\b(?:TRUE|FALSE)\b/,ellipsis:/\.\.(?:\.|\d+)/,number:[/\b(?:NaN|Inf)\b/,/\b(?:0x[\dA-Fa-f]+(?:\.\d*)?|\d*\.?\d+)(?:[EePp][+-]?\d+)?[iL]?\b/],keyword:/\b(?:if|else|repeat|while|function|for|in|next|break|NULL|NA|NA_integer_|NA_real_|NA_complex_|NA_character_)\b/,operator:/->?>?|<(?:=|<?-)?|[>=!]=?|::?|&&?|\|\|?|[+*\/^$@~]/,punctuation:/[(){}\[\],;]/};
+!function(a){var e=a.util.clone(a.languages.javascript);a.languages.jsx=a.languages.extend("markup",e),a.languages.jsx.tag.pattern=/<\/?[\w\.:-]+\s*(?:\s+[\w\.:-]+(?:=(?:("|')(\\?[\w\W])*?\1|[^\s'">=]+|(\{[\w\W]*?\})))?\s*)*\/?>/i,a.languages.jsx.tag.inside["attr-value"].pattern=/=[^\{](?:('|")[\w\W]*?(\1)|[^\s>]+)/i;var s=a.util.clone(a.languages.jsx);delete s.punctuation,s=a.languages.insertBefore("jsx","operator",{punctuation:/=(?={)|[{}[\];(),.:]/},{jsx:s}),a.languages.insertBefore("inside","attr-value",{script:{pattern:/=(\{(?:\{[^}]*\}|[^}])+\})/i,inside:s,alias:"language-javascript"}},a.languages.jsx.tag)}(Prism);
+Prism.languages.rust={comment:[{pattern:/(^|[^\\])\/\*[\w\W]*?\*\//,lookbehind:!0},{pattern:/(^|[^\\:])\/\/.*/,lookbehind:!0}],string:[/b?r(#*)"(?:\\?.)*?"\1/,/b?("|')(?:\\?.)*?\1/],keyword:/\b(?:abstract|alignof|as|be|box|break|const|continue|crate|do|else|enum|extern|false|final|fn|for|if|impl|in|let|loop|match|mod|move|mut|offsetof|once|override|priv|pub|pure|ref|return|sizeof|static|self|struct|super|true|trait|type|typeof|unsafe|unsized|use|virtual|where|while|yield)\b/,attribute:{pattern:/#!?\[.+?\]/,alias:"attr-name"},"function":[/[a-z0-9_]+(?=\s*\()/i,/[a-z0-9_]+!(?=\s*\(|\[)/i],"macro-rules":{pattern:/[a-z0-9_]+!/i,alias:"function"},number:/\b-?(?:0x[\dA-Fa-f](?:_?[\dA-Fa-f])*|0o[0-7](?:_?[0-7])*|0b[01](?:_?[01])*|(\d(_?\d)*)?\.?\d(_?\d)*([Ee][+-]?\d+)?)(?:_?(?:[iu](?:8|16|32|64)?|f32|f64))?\b/,"closure-params":{pattern:/\|[^|]*\|(?=\s*[{-])/,inside:{punctuation:/[\|:,]/,operator:/[&*]/}},punctuation:/[{}[\];(),:]|\.+|->/,operator:/[-+*\/%!^=]=?|@|&[&=]?|\|[|=]?|<<?=?|>>?=?/};
+!function(e){e.languages.sass=e.languages.extend("css",{comment:{pattern:/^([ \t]*)\/[\/*].*(?:(?:\r?\n|\r)\1[ \t]+.+)*/m,lookbehind:!0}}),e.languages.insertBefore("sass","atrule",{"atrule-line":{pattern:/^(?:[ \t]*)[@+=].+/m,inside:{atrule:/(?:@[\w-]+|[+=])/m}}}),delete e.languages.sass.atrule;var a=/((\$[-_\w]+)|(#\{\$[-_\w]+\}))/i,t=[/[+*\/%]|[=!]=|<=?|>=?|\b(?:and|or|not)\b/,{pattern:/(\s+)-(?=\s)/,lookbehind:!0}];e.languages.insertBefore("sass","property",{"variable-line":{pattern:/^[ \t]*\$.+/m,inside:{punctuation:/:/,variable:a,operator:t}},"property-line":{pattern:/^[ \t]*(?:[^:\s]+ *:.*|:[^:\s]+.*)/m,inside:{property:[/[^:\s]+(?=\s*:)/,{pattern:/(:)[^:\s]+/,lookbehind:!0}],punctuation:/:/,variable:a,operator:t,important:e.languages.sass.important}}}),delete e.languages.sass.property,delete e.languages.sass.important,delete e.languages.sass.selector,e.languages.insertBefore("sass","punctuation",{selector:{pattern:/([ \t]*)\S(?:,?[^,\r\n]+)*(?:,(?:\r?\n|\r)\1[ \t]+\S(?:,?[^,\r\n]+)*)*/,lookbehind:!0}})}(Prism);
+Prism.languages.scss=Prism.languages.extend("css",{comment:{pattern:/(^|[^\\])(?:\/\*[\w\W]*?\*\/|\/\/.*)/,lookbehind:!0},atrule:{pattern:/@[\w-]+(?:\([^()]+\)|[^(])*?(?=\s+[{;])/,inside:{rule:/@[\w-]+/}},url:/(?:[-a-z]+-)*url(?=\()/i,selector:{pattern:/(?=\S)[^@;\{\}\(\)]?([^@;\{\}\(\)]|&|#\{\$[-_\w]+\})+(?=\s*\{(\}|\s|[^\}]+(:|\{)[^\}]+))/m,inside:{parent:{pattern:/&/,alias:"important"},placeholder:/%[-_\w]+/,variable:/\$[-_\w]+|#\{\$[-_\w]+\}/}}}),Prism.languages.insertBefore("scss","atrule",{keyword:[/@(?:if|else(?: if)?|for|each|while|import|extend|debug|warn|mixin|include|function|return|content)/i,{pattern:/( +)(?:from|through)(?= )/,lookbehind:!0}]}),Prism.languages.scss.property={pattern:/(?:[\w-]|\$[-_\w]+|#\{\$[-_\w]+\})+(?=\s*:)/i,inside:{variable:/\$[-_\w]+|#\{\$[-_\w]+\}/}},Prism.languages.insertBefore("scss","important",{variable:/\$[-_\w]+|#\{\$[-_\w]+\}/}),Prism.languages.insertBefore("scss","function",{placeholder:{pattern:/%[-_\w]+/,alias:"selector"},statement:{pattern:/\B!(?:default|optional)\b/i,alias:"keyword"},"boolean":/\b(?:true|false)\b/,"null":/\bnull\b/,operator:{pattern:/(\s)(?:[-+*\/%]|[=!]=|<=?|>=?|and|or|not)(?=\s)/,lookbehind:!0}}),Prism.languages.scss.atrule.inside.rest=Prism.util.clone(Prism.languages.scss);
+Prism.languages.sql={comment:{pattern:/(^|[^\\])(?:\/\*[\w\W]*?\*\/|(?:--|\/\/|#).*)/,lookbehind:!0},string:{pattern:/(^|[^@\\])("|')(?:\\?[\s\S])*?\2/,lookbehind:!0},variable:/@[\w.$]+|@("|'|`)(?:\\?[\s\S])+?\1/,"function":/\b(?:COUNT|SUM|AVG|MIN|MAX|FIRST|LAST|UCASE|LCASE|MID|LEN|ROUND|NOW|FORMAT)(?=\s*\()/i,keyword:/\b(?:ACTION|ADD|AFTER|ALGORITHM|ALL|ALTER|ANALYZE|ANY|APPLY|AS|ASC|AUTHORIZATION|AUTO_INCREMENT|BACKUP|BDB|BEGIN|BERKELEYDB|BIGINT|BINARY|BIT|BLOB|BOOL|BOOLEAN|BREAK|BROWSE|BTREE|BULK|BY|CALL|CASCADED?|CASE|CHAIN|CHAR VARYING|CHARACTER (?:SET|VARYING)|CHARSET|CHECK|CHECKPOINT|CLOSE|CLUSTERED|COALESCE|COLLATE|COLUMN|COLUMNS|COMMENT|COMMIT|COMMITTED|COMPUTE|CONNECT|CONSISTENT|CONSTRAINT|CONTAINS|CONTAINSTABLE|CONTINUE|CONVERT|CREATE|CROSS|CURRENT(?:_DATE|_TIME|_TIMESTAMP|_USER)?|CURSOR|DATA(?:BASES?)?|DATE(?:TIME)?|DBCC|DEALLOCATE|DEC|DECIMAL|DECLARE|DEFAULT|DEFINER|DELAYED|DELETE|DELIMITER(?:S)?|DENY|DESC|DESCRIBE|DETERMINISTIC|DISABLE|DISCARD|DISK|DISTINCT|DISTINCTROW|DISTRIBUTED|DO|DOUBLE(?: PRECISION)?|DROP|DUMMY|DUMP(?:FILE)?|DUPLICATE KEY|ELSE|ENABLE|ENCLOSED BY|END|ENGINE|ENUM|ERRLVL|ERRORS|ESCAPE(?:D BY)?|EXCEPT|EXEC(?:UTE)?|EXISTS|EXIT|EXPLAIN|EXTENDED|FETCH|FIELDS|FILE|FILLFACTOR|FIRST|FIXED|FLOAT|FOLLOWING|FOR(?: EACH ROW)?|FORCE|FOREIGN|FREETEXT(?:TABLE)?|FROM|FULL|FUNCTION|GEOMETRY(?:COLLECTION)?|GLOBAL|GOTO|GRANT|GROUP|HANDLER|HASH|HAVING|HOLDLOCK|IDENTITY(?:_INSERT|COL)?|IF|IGNORE|IMPORT|INDEX|INFILE|INNER|INNODB|INOUT|INSERT|INT|INTEGER|INTERSECT|INTO|INVOKER|ISOLATION LEVEL|JOIN|KEYS?|KILL|LANGUAGE SQL|LAST|LEFT|LIMIT|LINENO|LINES|LINESTRING|LOAD|LOCAL|LOCK|LONG(?:BLOB|TEXT)|MATCH(?:ED)?|MEDIUM(?:BLOB|INT|TEXT)|MERGE|MIDDLEINT|MODIFIES SQL DATA|MODIFY|MULTI(?:LINESTRING|POINT|POLYGON)|NATIONAL(?: CHAR VARYING| CHARACTER(?: VARYING)?| VARCHAR)?|NATURAL|NCHAR(?: VARCHAR)?|NEXT|NO(?: SQL|CHECK|CYCLE)?|NONCLUSTERED|NULLIF|NUMERIC|OFF?|OFFSETS?|ON|OPEN(?:DATASOURCE|QUERY|ROWSET)?|OPTIMIZE|OPTION(?:ALLY)?|ORDER|OUT(?:ER|FILE)?|OVER|PARTIAL|PARTITION|PERCENT|PIVOT|PLAN|POINT|POLYGON|PRECEDING|PRECISION|PREV|PRIMARY|PRINT|PRIVILEGES|PROC(?:EDURE)?|PUBLIC|PURGE|QUICK|RAISERROR|READ(?:S SQL DATA|TEXT)?|REAL|RECONFIGURE|REFERENCES|RELEASE|RENAME|REPEATABLE|REPLICATION|REQUIRE|RESTORE|RESTRICT|RETURNS?|REVOKE|RIGHT|ROLLBACK|ROUTINE|ROW(?:COUNT|GUIDCOL|S)?|RTREE|RULE|SAVE(?:POINT)?|SCHEMA|SELECT|SERIAL(?:IZABLE)?|SESSION(?:_USER)?|SET(?:USER)?|SHARE MODE|SHOW|SHUTDOWN|SIMPLE|SMALLINT|SNAPSHOT|SOME|SONAME|START(?:ING BY)?|STATISTICS|STATUS|STRIPED|SYSTEM_USER|TABLES?|TABLESPACE|TEMP(?:ORARY|TABLE)?|TERMINATED BY|TEXT(?:SIZE)?|THEN|TIMESTAMP|TINY(?:BLOB|INT|TEXT)|TOP?|TRAN(?:SACTIONS?)?|TRIGGER|TRUNCATE|TSEQUAL|TYPES?|UNBOUNDED|UNCOMMITTED|UNDEFINED|UNION|UNIQUE|UNPIVOT|UPDATE(?:TEXT)?|USAGE|USE|USER|USING|VALUES?|VAR(?:BINARY|CHAR|CHARACTER|YING)|VIEW|WAITFOR|WARNINGS|WHEN|WHERE|WHILE|WITH(?: ROLLUP|IN)?|WORK|WRITE(?:TEXT)?)\b/i,"boolean":/\b(?:TRUE|FALSE|NULL)\b/i,number:/\b-?(?:0x)?\d*\.?[\da-f]+\b/,operator:/[-+*\/=%^~]|&&?|\|?\||!=?|<(?:=>?|<|>)?|>[>=]?|\b(?:AND|BETWEEN|IN|LIKE|NOT|OR|IS|DIV|REGEXP|RLIKE|SOUNDS LIKE|XOR)\b/i,punctuation:/[;[\]()`,.]/};
+Prism.languages.swift=Prism.languages.extend("clike",{string:{pattern:/("|')(\\(?:\((?:[^()]|\([^)]+\))+\)|\r\n|[\s\S])|(?!\1)[^\\\r\n])*\1/,greedy:!0,inside:{interpolation:{pattern:/\\\((?:[^()]|\([^)]+\))+\)/,inside:{delimiter:{pattern:/^\\\(|\)$/,alias:"variable"}}}}},keyword:/\b(as|associativity|break|case|catch|class|continue|convenience|default|defer|deinit|didSet|do|dynamic(?:Type)?|else|enum|extension|fallthrough|final|for|func|get|guard|if|import|in|infix|init|inout|internal|is|lazy|left|let|mutating|new|none|nonmutating|operator|optional|override|postfix|precedence|prefix|private|Protocol|public|repeat|required|rethrows|return|right|safe|self|Self|set|static|struct|subscript|super|switch|throws?|try|Type|typealias|unowned|unsafe|var|weak|where|while|willSet|__(?:COLUMN__|FILE__|FUNCTION__|LINE__))\b/,number:/\b([\d_]+(\.[\de_]+)?|0x[a-f0-9_]+(\.[a-f0-9p_]+)?|0b[01_]+|0o[0-7_]+)\b/i,constant:/\b(nil|[A-Z_]{2,}|k[A-Z][A-Za-z_]+)\b/,atrule:/@\b(IB(?:Outlet|Designable|Action|Inspectable)|class_protocol|exported|noreturn|NS(?:Copying|Managed)|objc|UIApplicationMain|auto_closure)\b/,builtin:/\b([A-Z]\S+|abs|advance|alignof(?:Value)?|assert|contains|count(?:Elements)?|debugPrint(?:ln)?|distance|drop(?:First|Last)|dump|enumerate|equal|filter|find|first|getVaList|indices|isEmpty|join|last|lexicographicalCompare|map|max(?:Element)?|min(?:Element)?|numericCast|overlaps|partition|print(?:ln)?|reduce|reflect|reverse|sizeof(?:Value)?|sort(?:ed)?|split|startsWith|stride(?:of(?:Value)?)?|suffix|swap|toDebugString|toString|transcode|underestimateCount|unsafeBitCast|with(?:ExtendedLifetime|Unsafe(?:MutablePointers?|Pointers?)|VaList))\b/}),Prism.languages.swift.string.inside.interpolation.inside.rest=Prism.util.clone(Prism.languages.swift);
+Prism.languages.typescript=Prism.languages.extend("javascript",{keyword:/\b(break|case|catch|class|const|continue|debugger|default|delete|do|else|enum|export|extends|false|finally|for|from|function|get|if|implements|import|in|instanceof|interface|let|new|null|package|private|protected|public|return|set|static|super|switch|this|throw|true|try|typeof|var|void|while|with|yield|module|declare|constructor|string|Function|any|number|boolean|Array|enum)\b/}),Prism.languages.ts=Prism.languages.typescript;
+Prism.languages.yaml={scalar:{pattern:/([\-:]\s*(![^\s]+)?[ \t]*[|>])[ \t]*(?:((?:\r?\n|\r)[ \t]+)[^\r\n]+(?:\3[^\r\n]+)*)/,lookbehind:!0,alias:"string"},comment:/#.*/,key:{pattern:/(\s*(?:^|[:\-,[{\r\n?])[ \t]*(![^\s]+)?[ \t]*)[^\r\n{[\]},#\s]+?(?=\s*:\s)/,lookbehind:!0,alias:"atrule"},directive:{pattern:/(^[ \t]*)%.+/m,lookbehind:!0,alias:"important"},datetime:{pattern:/([:\-,[{]\s*(![^\s]+)?[ \t]*)(\d{4}-\d\d?-\d\d?([tT]|[ \t]+)\d\d?:\d{2}:\d{2}(\.\d*)?[ \t]*(Z|[-+]\d\d?(:\d{2})?)?|\d{4}-\d{2}-\d{2}|\d\d?:\d{2}(:\d{2}(\.\d*)?)?)(?=[ \t]*($|,|]|}))/m,lookbehind:!0,alias:"number"},"boolean":{pattern:/([:\-,[{]\s*(![^\s]+)?[ \t]*)(true|false)[ \t]*(?=$|,|]|})/im,lookbehind:!0,alias:"important"},"null":{pattern:/([:\-,[{]\s*(![^\s]+)?[ \t]*)(null|~)[ \t]*(?=$|,|]|})/im,lookbehind:!0,alias:"important"},string:{pattern:/([:\-,[{]\s*(![^\s]+)?[ \t]*)("(?:[^"\\]|\\.)*"|'(?:[^'\\]|\\.)*')(?=[ \t]*($|,|]|}))/m,lookbehind:!0},number:{pattern:/([:\-,[{]\s*(![^\s]+)?[ \t]*)[+\-]?(0x[\da-f]+|0o[0-7]+|(\d+\.?\d*|\.?\d+)(e[\+\-]?\d+)?|\.inf|\.nan)[ \t]*(?=$|,|]|})/im,lookbehind:!0},tag:/![^\s]+/,important:/[&*][\w]+/,punctuation:/---|[:[\]{}\-,|>?]|\.\.\./};
+!function(){function e(e,t){return Array.prototype.slice.call((t||document).querySelectorAll(e))}function t(e,t){return t=" "+t+" ",(" "+e.className+" ").replace(/[\n\t]/g," ").indexOf(t)>-1}function n(e,n,i){for(var o,a=n.replace(/\s+/g,"").split(","),l=+e.getAttribute("data-line-offset")||0,d=r()?parseInt:parseFloat,c=d(getComputedStyle(e).lineHeight),s=0;o=a[s++];){o=o.split("-");var u=+o[0],m=+o[1]||u,h=document.createElement("div");h.textContent=Array(m-u+2).join(" \n"),h.setAttribute("aria-hidden","true"),h.className=(i||"")+" line-highlight",t(e,"line-numbers")||(h.setAttribute("data-start",u),m>u&&h.setAttribute("data-end",m)),h.style.top=(u-l-1)*c+"px",t(e,"line-numbers")?e.appendChild(h):(e.querySelector("code")||e).appendChild(h)}}function i(){var t=location.hash.slice(1);e(".temporary.line-highlight").forEach(function(e){e.parentNode.removeChild(e)});var i=(t.match(/\.([\d,-]+)$/)||[,""])[1];if(i&&!document.getElementById(t)){var r=t.slice(0,t.lastIndexOf(".")),o=document.getElementById(r);o&&(o.hasAttribute("data-line")||o.setAttribute("data-line",""),n(o,i,"temporary "),document.querySelector(".temporary.line-highlight").scrollIntoView())}}if("undefined"!=typeof self&&self.Prism&&self.document&&document.querySelector){var r=function(){var e;return function(){if("undefined"==typeof e){var t=document.createElement("div");t.style.fontSize="13px",t.style.lineHeight="1.5",t.style.padding=0,t.style.border=0,t.innerHTML="&nbsp;<br />&nbsp;",document.body.appendChild(t),e=38===t.offsetHeight,document.body.removeChild(t)}return e}}(),o=0;Prism.hooks.add("complete",function(t){var r=t.element.parentNode,a=r&&r.getAttribute("data-line");r&&a&&/pre/i.test(r.nodeName)&&(clearTimeout(o),e(".line-highlight",r).forEach(function(e){e.parentNode.removeChild(e)}),n(r,a),o=setTimeout(i,1))}),window.addEventListener&&window.addEventListener("hashchange",i)}}();
+!function(){"undefined"!=typeof self&&self.Prism&&self.document&&Prism.hooks.add("complete",function(e){if(e.code){var t=e.element.parentNode,s=/\s*\bline-numbers\b\s*/;if(t&&/pre/i.test(t.nodeName)&&(s.test(t.className)||s.test(e.element.className))&&!e.element.querySelector(".line-numbers-rows")){s.test(e.element.className)&&(e.element.className=e.element.className.replace(s,"")),s.test(t.className)||(t.className+=" line-numbers");var n,a=e.code.match(/\n(?!$)/g),l=a?a.length+1:1,r=new Array(l+1);r=r.join("<span></span>"),n=document.createElement("span"),n.setAttribute("aria-hidden","true"),n.className="line-numbers-rows",n.innerHTML=r,t.hasAttribute("data-start")&&(t.style.counterReset="linenumber "+(parseInt(t.getAttribute("data-start"),10)-1)),e.element.appendChild(n)}}})}();
+!function(){"undefined"!=typeof self&&!self.Prism||"undefined"!=typeof global&&!global.Prism||Prism.hooks.add("before-highlight",function(e){var f=e.grammar;f.tab=/\t/g,f.crlf=/\r\n/g,f.lf=/\n/g,f.cr=/\r/g,f.space=/ /g})}();
+!function(){if(("undefined"==typeof self||self.Prism)&&("undefined"==typeof global||global.Prism)){var i=/\b([a-z]{3,7}:\/\/|tel:)[\w\-+%~\/.:#=?&amp;]+/,n=/\b\S+@[\w.]+[a-z]{2}/,e=/\[([^\]]+)]\(([^)]+)\)/,t=["comment","url","attr-value","string"];Prism.plugins.autolinker={processGrammar:function(a){a&&!a["url-link"]&&(Prism.languages.DFS(a,function(a,r,l){t.indexOf(l)>-1&&"Array"!==Prism.util.type(r)&&(r.pattern||(r=this[a]={pattern:r}),r.inside=r.inside||{},"comment"==l&&(r.inside["md-link"]=e),"attr-value"==l?Prism.languages.insertBefore("inside","punctuation",{"url-link":i},r):r.inside["url-link"]=i,r.inside["email-link"]=n)}),a["url-link"]=i,a["email-link"]=n)}},Prism.hooks.add("before-highlight",function(i){Prism.plugins.autolinker.processGrammar(i.grammar)}),Prism.hooks.add("wrap",function(i){if(/-link$/.test(i.type)){i.tag="a";var n=i.content;if("email-link"==i.type&&0!=n.indexOf("mailto:"))n="mailto:"+n;else if("md-link"==i.type){var t=i.content.match(e);n=t[2],i.content=t[1]}i.attributes.href=n}})}}();
+!function(){"undefined"!=typeof self&&self.Prism&&self.document&&document.querySelector&&(self.Prism.fileHighlight=function(){var e={js:"javascript",py:"python",rb:"ruby",ps1:"powershell",psm1:"powershell",sh:"bash",bat:"batch",h:"c",tex:"latex"};Array.prototype.forEach&&Array.prototype.slice.call(document.querySelectorAll("pre[data-src]")).forEach(function(t){for(var a,s=t.getAttribute("data-src"),n=t,r=/\blang(?:uage)?-(?!\*)(\w+)\b/i;n&&!r.test(n.className);)n=n.parentNode;if(n&&(a=(t.className.match(r)||[,""])[1]),!a){var o=(s.match(/\.(\w+)$/)||[,""])[1];a=e[o]||o}var l=document.createElement("code");l.className="language-"+a,t.textContent="",l.textContent="Loading…",t.appendChild(l);var i=new XMLHttpRequest;i.open("GET",s,!0),i.onreadystatechange=function(){4==i.readyState&&(i.status<400&&i.responseText?(l.textContent=i.responseText,Prism.highlightElement(l)):l.textContent=i.status>=400?"✖ Error "+i.status+" while fetching file: "+i.statusText:"✖ Error: File does not exist or is empty")},i.send(null)})},document.addEventListener("DOMContentLoaded",self.Prism.fileHighlight))}();
+!function(){if("undefined"!=typeof self&&self.Prism&&self.document){var t=[],e={},n=function(){};Prism.plugins.toolbar={};var a=Prism.plugins.toolbar.registerButton=function(n,a){var o;o="function"==typeof a?a:function(t){var e;return"function"==typeof a.onClick?(e=document.createElement("button"),e.type="button",e.addEventListener("click",function(){a.onClick.call(this,t)})):"string"==typeof a.url?(e=document.createElement("a"),e.href=a.url):e=document.createElement("span"),e.textContent=a.text,e},t.push(e[n]=o)},o=Prism.plugins.toolbar.hook=function(a){var o=a.element.parentNode;if(o&&/pre/i.test(o.nodeName)&&!o.classList.contains("code-toolbar")){o.classList.add("code-toolbar");var r=document.createElement("div");r.classList.add("toolbar"),document.body.hasAttribute("data-toolbar-order")&&(t=document.body.getAttribute("data-toolbar-order").split(",").map(function(t){return e[t]||n})),t.forEach(function(t){var e=t(a);if(e){var n=document.createElement("div");n.classList.add("toolbar-item"),n.appendChild(e),r.appendChild(n)}}),o.appendChild(r)}};a("label",function(t){var e=t.element.parentNode;if(e&&/pre/i.test(e.nodeName)&&e.hasAttribute("data-label")){var n,a,o=e.getAttribute("data-label");try{a=document.querySelector("template#"+o)}catch(r){}return a?n=a.content:(e.hasAttribute("data-url")?(n=document.createElement("a"),n.href=e.getAttribute("data-url")):n=document.createElement("span"),n.textContent=o),n}}),Prism.hooks.add("complete",o)}}();
+!function(){function t(t){"function"!=typeof t||e(t)||r.push(t)}function e(t){return"function"==typeof t?r.filter(function(e){return e.valueOf()===t.valueOf()})[0]:"string"==typeof t&&t.length>0?r.filter(function(e){return e.name===t})[0]:null}function n(t){if("string"==typeof t&&(t=e(t)),"function"==typeof t){var n=r.indexOf(t);n>=0&&r.splice(n,1)}}function a(){Array.prototype.slice.call(document.querySelectorAll("pre[data-jsonp]")).forEach(function(t){t.textContent="";var e=document.createElement("code");e.textContent=i,t.appendChild(e);var n=t.getAttribute("data-adapter"),a=null;if(n){if("function"!=typeof window[n])return e.textContent="JSONP adapter function '"+n+"' doesn't exist",void 0;a=window[n]}var u="prismjsonp"+o++,f=document.createElement("a"),l=f.href=t.getAttribute("data-jsonp");f.href+=(f.search?"&":"?")+(t.getAttribute("data-callback")||"callback")+"="+u;var s=setTimeout(function(){e.textContent===i&&(e.textContent="Timeout loading '"+l+"'")},5e3),d=document.createElement("script");d.src=f.href,window[u]=function(n){document.head.removeChild(d),clearTimeout(s),delete window[u];var o="";if(a)o=a(n,t);else for(var i in r)if(o=r[i](n,t),null!==o)break;null===o?e.textContent="Cannot parse response (perhaps you need an adapter function?)":(e.textContent=o,Prism.highlightElement(e))},document.head.appendChild(d)})}if(self.Prism&&self.document&&document.querySelectorAll&&[].filter){var r=[];Prism.plugins.jsonphighlight={registerAdapter:t,removeAdapter:n,highlight:a},t(function(t){if(t&&t.meta&&t.data){if(t.meta.status&&t.meta.status>=400)return"Error: "+(t.data.message||t.meta.status);if("string"==typeof t.data.content)return"function"==typeof atob?atob(t.data.content.replace(/\s/g,"")):"Your browser cannot decode base64"}return null}),t(function(t,e){if(t&&t.meta&&t.data&&t.data.files){if(t.meta.status&&t.meta.status>=400)return"Error: "+(t.data.message||t.meta.status);var n=e.getAttribute("data-filename");if(null==n)for(var a in t.data.files)if(t.data.files.hasOwnProperty(a)){n=a;break}return void 0!==t.data.files[n]?t.data.files[n].content:"Error: unknown or missing gist file "+n}return null}),t(function(t){return t&&t.node&&"string"==typeof t.data?t.data:null});var o=0,i="Loading…";a()}}();
+!function(){"undefined"!=typeof self&&!self.Prism||"undefined"!=typeof global&&!global.Prism||Prism.hooks.add("wrap",function(e){"keyword"===e.type&&e.classes.push("keyword-"+e.content)})}();
+!function(){if("undefined"!=typeof self&&self.Prism&&self.document&&document.createElement){var e={javascript:"clike",actionscript:"javascript",aspnet:"markup",bison:"c",c:"clike",csharp:"clike",cpp:"c",coffeescript:"javascript",crystal:"ruby","css-extras":"css",d:"clike",dart:"clike",fsharp:"clike",glsl:"clike",go:"clike",groovy:"clike",haml:"ruby",handlebars:"markup",haxe:"clike",jade:"javascript",java:"clike",jolie:"clike",kotlin:"clike",less:"css",markdown:"markup",nginx:"clike",n4js:"javascript",n4mf:"json",nfon:"json",objectivec:"c",parser:"markup",php:"clike","php-extras":"php",processing:"clike",protobuf:"clike",qore:"clike",jsx:["markup","javascript"],reason:"clike",ruby:"clike",sass:"css",scss:"css",scala:"java",smarty:"markup",swift:"clike",textile:"markup",twig:"markup",typescript:"javascript",wiki:"markup"},c={},a="none",s=Prism.plugins.autoloader={languages_path:"components/",use_minified:!0},n=function(e,c,a){var s=document.createElement("script");s.src=e,s.async=!0,s.onload=function(){document.body.removeChild(s),c&&c()},s.onerror=function(){document.body.removeChild(s),a&&a()},document.body.appendChild(s)},r=function(e){return s.languages_path+"prism-"+e+(s.use_minified?".min":"")+".js"},i=function(e,a){var s=c[e];s||(s=c[e]={});var n=a.getAttribute("data-dependencies");!n&&a.parentNode&&"pre"===a.parentNode.tagName.toLowerCase()&&(n=a.parentNode.getAttribute("data-dependencies")),n=n?n.split(/\s*,\s*/g):[],l(n,function(){t(e,function(){Prism.highlightElement(a)})})},l=function(e,c,a){"string"==typeof e&&(e=[e]);var s=0,n=e.length,r=function(){n>s?t(e[s],function(){s++,r()},function(){a&&a(e[s])}):s===n&&c&&c(e)};r()},t=function(a,s,i){var t=function(){var e=!1;a.indexOf("!")>=0&&(e=!0,a=a.replace("!",""));var l=c[a];if(l||(l=c[a]={}),s&&(l.success_callbacks||(l.success_callbacks=[]),l.success_callbacks.push(s)),i&&(l.error_callbacks||(l.error_callbacks=[]),l.error_callbacks.push(i)),!e&&Prism.languages[a])o(a);else if(!e&&l.error)u(a);else if(e||!l.loading){l.loading=!0;var t=r(a);n(t,function(){l.loading=!1,o(a)},function(){l.loading=!1,l.error=!0,u(a)})}},p=e[a];p&&p.length?l(p,t):t()},o=function(e){c[e]&&c[e].success_callbacks&&c[e].success_callbacks.length&&c[e].success_callbacks.forEach(function(c){c(e)})},u=function(e){c[e]&&c[e].error_callbacks&&c[e].error_callbacks.length&&c[e].error_callbacks.forEach(function(c){c(e)})};Prism.hooks.add("complete",function(e){e.element&&e.language&&!e.grammar&&e.language!==a&&i(e.language,e.element)})}}();
+!function(){"undefined"!=typeof self&&self.Prism&&self.document&&Prism.hooks.add("complete",function(e){if(e.code){var t=e.element.parentNode,a=/\s*\bcommand-line\b\s*/;if(t&&/pre/i.test(t.nodeName)&&(a.test(t.className)||a.test(e.element.className))&&!e.element.querySelector(".command-line-prompt")){a.test(e.element.className)&&(e.element.className=e.element.className.replace(a,"")),a.test(t.className)||(t.className+=" command-line");var n=function(e,a){return(t.getAttribute(e)||a).replace(/"/g,"&quot")},s=new Array(1+e.code.split("\n").length),r=n("data-prompt","");if(""!==r)s=s.join('<span data-prompt="'+r+'"></span>');else{var l=n("data-user","user"),m=n("data-host","localhost");s=s.join('<span data-user="'+l+'" data-host="'+m+'"></span>')}var o=document.createElement("span");o.className="command-line-prompt",o.innerHTML=s;var i=t.getAttribute("data-output")||"";i=i.split(",");for(var c=0;c<i.length;c++){var p=i[c].split("-"),d=parseInt(p[0]),u=d;if(2===p.length&&(u=parseInt(p[1])),!isNaN(d)&&!isNaN(u))for(var f=d;u>=f&&f<=o.children.length;f++){var N=o.children[f-1];N.removeAttribute("data-user"),N.removeAttribute("data-host"),N.removeAttribute("data-prompt")}}e.element.innerHTML=o.outerHTML+e.element.innerHTML}}})}();
+!function(){if(("undefined"==typeof self||self.Prism)&&("undefined"==typeof global||global.Prism)){var i=function(i){return Prism.plugins.autolinker&&Prism.plugins.autolinker.processGrammar(i),i},a={pattern:/(.)\bdata:[^\/]+\/[^,]+,(?:(?!\1)[\s\S]|\\\1)+(?=\1)/,lookbehind:!0,inside:{"language-css":{pattern:/(data:[^\/]+\/(?:[^+,]+\+)?css,)[\s\S]+/,lookbehind:!0},"language-javascript":{pattern:/(data:[^\/]+\/(?:[^+,]+\+)?javascript,)[\s\S]+/,lookbehind:!0},"language-json":{pattern:/(data:[^\/]+\/(?:[^+,]+\+)?json,)[\s\S]+/,lookbehind:!0},"language-markup":{pattern:/(data:[^\/]+\/(?:[^+,]+\+)?(?:html|xml),)[\s\S]+/,lookbehind:!0}}},n=["url","attr-value","string"];Prism.plugins.dataURIHighlight={processGrammar:function(i){i&&!i["data-uri"]&&(Prism.languages.DFS(i,function(i,e,r){n.indexOf(r)>-1&&"Array"!==Prism.util.type(e)&&(e.pattern||(e=this[i]={pattern:e}),e.inside=e.inside||{},"attr-value"==r?Prism.languages.insertBefore("inside",e.inside["url-link"]?"url-link":"punctuation",{"data-uri":a},e):e.inside["url-link"]?Prism.languages.insertBefore("inside","url-link",{"data-uri":a},e):e.inside["data-uri"]=a)}),i["data-uri"]=a)}},Prism.hooks.add("before-highlight",function(n){if(a.pattern.test(n.code))for(var e in a.inside)if(a.inside.hasOwnProperty(e)&&!a.inside[e].inside&&a.inside[e].pattern.test(n.code)){var r=e.match(/^language-(.+)/)[1];Prism.languages[r]&&(a.inside[e].inside={rest:i(Prism.languages[r])})}Prism.plugins.dataURIHighlight.processGrammar(n.grammar)})}}();
+!function(){if("undefined"!=typeof self&&self.Prism&&self.document){if(!Prism.plugins.toolbar)return console.warn("Show Languages plugin loaded before Toolbar plugin."),void 0;var e={html:"HTML",xml:"XML",svg:"SVG",mathml:"MathML",css:"CSS",clike:"C-like",javascript:"JavaScript",abap:"ABAP",actionscript:"ActionScript",apacheconf:"Apache Configuration",apl:"APL",applescript:"AppleScript",asciidoc:"AsciiDoc",aspnet:"ASP.NET (C#)",autoit:"AutoIt",autohotkey:"AutoHotkey",basic:"BASIC",csharp:"C#",cpp:"C++",coffeescript:"CoffeeScript","css-extras":"CSS Extras",fsharp:"F#",glsl:"GLSL",graphql:"GraphQL",http:"HTTP",inform7:"Inform 7",json:"JSON",latex:"LaTeX",livescript:"LiveScript",lolcode:"LOLCODE",matlab:"MATLAB",mel:"MEL",n4js:"N4JS",n4jsx:"N4JSX",nfon:"NFON",n4mf:"N4JS Manifest",nasm:"NASM",nginx:"nginx",nsis:"NSIS",objectivec:"Objective-C",ocaml:"OCaml",parigp:"PARI/GP",php:"PHP","php-extras":"PHP Extras",powershell:"PowerShell",properties:".properties",protobuf:"Protocol Buffers",jsx:"React JSX",rest:"reST (reStructuredText)",sas:"SAS",sass:"Sass (Sass)",scss:"Sass (Scss)",sql:"SQL",typescript:"TypeScript",vhdl:"VHDL",vim:"vim",wiki:"Wiki markup",xojo:"Xojo (REALbasic)",yaml:"YAML"};Prism.plugins.toolbar.registerButton("show-language",function(t){var a=t.element.parentNode;if(a&&/pre/i.test(a.nodeName)){var s=a.getAttribute("data-language")||e[t.language]||t.language.substring(0,1).toUpperCase()+t.language.substring(1),r=document.createElement("span");return r.textContent=s,r}})}}();
+!function(){if("undefined"!=typeof self&&self.Prism&&self.document){if(!Prism.plugins.toolbar)return console.warn("Copy to Clipboard plugin loaded before Toolbar plugin."),void 0;var o=window.Clipboard||void 0;o||"function"!=typeof require||(o=require("clipboard"));var e=[];if(!o){var t=document.createElement("script"),n=document.querySelector("head");t.onload=function(){if(o=window.Clipboard)for(;e.length;)e.pop()()},t.src="https://cdnjs.cloudflare.com/ajax/libs/clipboard.js/1.5.8/clipboard.min.js",n.appendChild(t)}Prism.plugins.toolbar.registerButton("copy-to-clipboard",function(t){function n(){var e=new o(i,{text:function(){return t.code}});e.on("success",function(){i.textContent="Copied!",r()}),e.on("error",function(){i.textContent="Press Ctrl+C to copy",r()})}function r(){setTimeout(function(){i.textContent="Copy"},5e3)}var i=document.createElement("a");return i.textContent="Copy",o?n():e.push(n),i})}}();
+!function(){"undefined"!=typeof self&&self.Prism&&self.document&&document.createRange&&(Prism.plugins.KeepMarkup=!0,Prism.hooks.add("before-highlight",function(e){if(e.element.children.length){var n=0,o=[],t=function(e,d){var r={};d||(r.clone=e.cloneNode(!1),r.posOpen=n,o.push(r));for(var a=0,s=e.childNodes.length;s>a;a++){var p=e.childNodes[a];1===p.nodeType?t(p):3===p.nodeType&&(n+=p.data.length)}d||(r.posClose=n)};t(e.element,!0),o&&o.length&&(e.keepMarkup=o)}}),Prism.hooks.add("after-highlight",function(e){if(e.keepMarkup&&e.keepMarkup.length){var n=function(e,o){for(var t=0,d=e.childNodes.length;d>t;t++){var r=e.childNodes[t];if(1===r.nodeType){if(!n(r,o))return!1}else 3===r.nodeType&&(!o.nodeStart&&o.pos+r.data.length>o.node.posOpen&&(o.nodeStart=r,o.nodeStartPos=o.node.posOpen-o.pos),o.nodeStart&&o.pos+r.data.length>=o.node.posClose&&(o.nodeEnd=r,o.nodeEndPos=o.node.posClose-o.pos),o.pos+=r.data.length);if(o.nodeStart&&o.nodeEnd){var a=document.createRange();return a.setStart(o.nodeStart,o.nodeStartPos),a.setEnd(o.nodeEnd,o.nodeEndPos),o.node.clone.appendChild(a.extractContents()),a.insertNode(o.node.clone),a.detach(),!1}}return!0};e.keepMarkup.forEach(function(o){n(e.element,{node:o,pos:0})})}}))}();
diff --git a/design/scripts/toc.js b/design/scripts/toc.js
new file mode 100644
index 0000000..a3f0d27
--- /dev/null
+++ b/design/scripts/toc.js
@@ -0,0 +1,58 @@
+/**
+ * Copyright (c) 2016 NumberFour AG.
+ * All rights reserved. This program and the accompanying materials
+ * are made available under the terms of the Eclipse Public License v1.0
+ * which accompanies this distribution, and is available at
+ * http://www.eclipse.org/legal/epl-v10.html
+ *
+ * Contributors:
+ *   NumberFour AG - Initial API and implementation
+ */
+
+$( "button#collapsetoc" ).click(function () {
+    $(this).toggleClass("inactive");
+     if ( $( this ).hasClass( "inactive" ) ) {
+        $('.toc2 > ul').treeView('expandAll');
+        /*$(this).css("background-image", "collapse.png");*/
+    }
+    else {
+        $('.toc2 > ul').treeView('collapseAll');
+        /*$(this).css("background-image", "expand.png");*/
+    }
+});
+
+// simulate click on parent element for 'a' elements in TOC
+$( ".toc2 a" ).click(function () {
+    $(this).parent('li').trigger('click');
+});
+
+$(window).resize(function() {
+    if ($(window).width() < 768) {
+        $( "#header, #content, #footnotes, #footer, #links" ).animate({left: '40px'},"slow");
+        $( "body.toc2").css("width", "90%");
+    }
+    else if ($("#tocbutton").css('left') == '270px') {
+            $( "#header, #content, #footnotes, #footer, #links" ).animate({left: '260px'},"slow");
+            $( "body.toc2").css("width", "80%");
+    }
+});
+
+function search() {
+    // Declare variables
+    var input, filter, li, a, i;
+    input = document.getElementById('pagesearch');
+    filter = input.value.toUpperCase();
+    li = document.getElementById("toclist").getElementsByTagName('li');
+    $('.toc2 > ul').treeView('expandAll');
+    // Loop through all list items, and hide those who don't match the search query
+    for (i = 0; i < li.length; i++) {
+        //a = li[i].getElementsByTagName("a")[0];
+        if (li[i].innerHTML.toUpperCase().indexOf(filter) > -1) {
+            li[i].style.display = "block";
+            $(li[i]).addClass("found");
+        } else {
+            $(li[i]).removeClass("found");
+            li[i].style.display = "none";
+        }
+    }
+}
diff --git a/design/scripts/treeview.js b/design/scripts/treeview.js
new file mode 100644
index 0000000..fe28355
--- /dev/null
+++ b/design/scripts/treeview.js
@@ -0,0 +1,161 @@
+/*
+
+The MIT License (MIT)
+
+Copyright (c) 2015 Samarjeet Singh
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
+
+*/
+
+// Source - https://github.com/samarjeet27/TreeViewJS
+
+(function ($){
+    // doesn't work without jquery
+    if (!$) return;
+    // treeView
+    function treeView($me) {
+        // add treeview class name if not present
+        $me.addClass('treeview');
+        // collapsable elements i.e. the li with a ul in it
+        var $collapse = $me.find('li>ul').parent();
+        // generate tree from data
+        function generateTree(data, $root, options) {
+            // create a node from a node object
+            function createNode(nObj, $target) {
+                var li = $('<li>').appendTo($target);
+                // node icons require using a span element
+                var useSpan = options.useSpan || options.imageList.length > 0;
+                if (useSpan) {
+                    li.append($('<span>').text(nObj.label));
+                } else {
+                    li.text(nObj.label);
+                }
+                if(options.imageList.length > 0){
+                    // the image
+                    var image = 'url('+options.imageList[nObj.imageIndex]+')';
+                    // requires using span
+                    var $span = li.find('span');
+                    // indicates that it has a node image
+                    $span.addClass('has-node-icon');
+                    $span.css('background-image', image);
+                }
+                if (nObj.children != undefined && nObj.children.length > 0) {
+                    var innerList = $('<ul>').appendTo(li);
+                    for (var i = 0; i < nObj.children.length; i++) {
+                        var child = nObj.children[i];
+                        createNode(child, innerList);
+                    };
+                }
+                
+                return li;
+            }
+            for (var i = 0; i < data.length; i++) {
+                createNode(data[i], $root);
+            }
+        }
+
+        return {
+            //initialize control
+            init: function (data) {
+                // handle undefined error
+                data = data || { };
+
+                // default optoins
+                var defaults = {
+                    model: null, // treeview data model
+                    useSpan: false, // use <span> to build model
+                    imageList: [], // add icons to nodes
+                    // ajax: null, TODO: load data using ajax
+                    expanded: false // the tree is expanded
+                };
+                // configuration
+                var options = { };
+                
+                if (typeof data.concat != 'undefined') {
+                    // concat is an array method, thus checks if data is array
+                    // typeof array returns object otherwise
+                    defaults.model = data;
+                    // data has model only, which is transferred to defaults.model
+                    // prevents wrong merge in $.extend
+                    data = null;
+                }
+                // merge options
+                options = $.extend(defaults, data);
+
+                if (options.model != null) {
+                    // generate the tree
+                    generateTree(options.model, $me, options);
+                    // re assign var value for new dom structure
+                    $collapse = $me.find('li>ul').parent();
+                }
+                // all the collapsable items which have something
+                $collapse.addClass('contains-items');
+                // user config
+                if (options.expanded){
+                    $collapse.addClass('items-expanded')
+                } else {
+                    $me.find('ul').css('display', 'none');
+                }
+                // expand items which have something
+                $me.find('.contains-items').on('click', function (event) {
+                    if ($(event.target).hasClass('contains-items')){
+                        // expand icon
+                        $(this).toggleClass('items-expanded');
+                        // the inner list
+                        var $a = $(this).find('>ul');
+                        // slide effect
+                        $a.slideToggle();
+                        // stop propagation of inner elements
+                        event.stopPropagation();
+                    }
+                });
+            },
+            // expand all items
+            expandAll: function() {
+                var items = $me.find('.contains-items');
+                items.find('ul').slideDown();
+                items.addClass('items-expanded');
+            },
+            // collapse all items
+            collapseAll: function() {
+                var items = $me.find('.contains-items');
+                items.find('ul').slideUp();
+                items.removeClass('items-expanded');
+            }
+        }
+    }
+    // treeView jQuery plugin
+    $.fn.treeView = function(options) {
+        // if it's a function arguments
+        var args = (arguments.length > 1) ? Array.prototype.slice.call(arguments, 1) : undefined;
+        // all the elements by selector
+        return this.each(function () {
+            var instance = new treeView($(this));
+            if ( instance[options] ) {
+                // has requested method
+                return instance[options](args);
+            } else {
+                // no method requested, so initialize
+                instance.init(options);
+            }
+        });
+    }
+
+})(window.jQuery);
\ No newline at end of file
diff --git a/design/styles/backtotop.css b/design/styles/backtotop.css
new file mode 100644
index 0000000..05529ac
--- /dev/null
+++ b/design/styles/backtotop.css
@@ -0,0 +1,88 @@
+/* ========================================================================== Back-to-top button ======================================================================= */
+
+a.back-to-top {
+	display: none;
+	width: 25px;
+	height: 25px;
+	text-indent: -9999px;
+	position: fixed;
+	z-index: 999;
+	right: 8%;
+	bottom: 5%;
+	background: #032c52 url("../images/up-arrow.png") no-repeat center 43%;
+	-webkit-border-radius: 30px;
+	-moz-border-radius: 30px;
+	border-radius: 30px;
+}
+
+a:hover.back-to-top {
+	background-color: #F7D425 ;
+}
+#tocbutton {
+	visibility: hidden;
+}
+
+#tocbuttonbars.fa.fa-bars {
+	z-index: 1000;
+	right: 0;
+}
+
+#tocbutton:hover {
+	background: url("yellowbars.png") no-repeat center 50%;
+}
+
+
+body.toc2.toc-right a.back-to-top {
+	width: 25px;
+	height: 25px;
+	text-indent: -9999px;
+	position: fixed;
+	z-index: 1001;
+	right: 90px;
+	bottom: 20px;
+	background: #032c52 url("../images/up-arrow.png") no-repeat center 43%;
+	-webkit-border-radius: 30px;
+	-moz-border-radius: 30px;
+	border-radius: 30px;
+}
+
+body.toc2.toc-right #tocbutton {
+	visibility: visible;
+	width: 25px;
+	height: 25px;
+	text-indent: -9999px;
+	position: fixed;
+	z-index: 998;
+	border: none;
+	right: 25px;
+	top: 5px;
+	background: url("bars.png") no-repeat center 50%;
+}
+
+body.toc2.toc-right #tocbutton:hover {
+	background-color: #e3f2ff;
+	background: url("yellowbars.png") no-repeat center 50%;
+}
+
+body.toc2.toc-right a:hover.back-to-top {
+	background-color: #F7D425 ;
+}
+
+@media only screen and (max-width: 1535px) {
+	body.toc2.toc-right #tocbutton {
+	background: url("yellowbars.png") no-repeat center 50%;
+	left: 98%;
+	z-index: 100000;
+}
+@media only screen and (max-width: 1434px) {
+	body.toc2.toc-right #tocbutton {
+	visibility: hidden;
+}
+
+@media only screen and (min-width: ) 
+
+
+@media only screen and (max-width: 1462px) {
+	a.back-to-top {
+	left: 90%;
+}
diff --git a/design/styles/foundation.css b/design/styles/foundation.css
new file mode 100644
index 0000000..24f2eb9
--- /dev/null
+++ b/design/styles/foundation.css
@@ -0,0 +1,3128 @@
+article,
+aside,
+details,
+figcaption,
+figure,
+footer,
+header,
+hgroup,
+main,
+nav,
+section,
+summary {
+    display: block
+}
+
+audio,
+canvas,
+video {
+    display: inline-block
+}
+
+audio:not([controls]) {
+    display: none;
+    height: 0
+}
+
+[hidden],
+template {
+    display: none
+}
+
+script {
+    display: none!important
+}
+
+html {
+    font-family: sans-serif;
+    -ms-text-size-adjust: 100%;
+    -webkit-text-size-adjust: 100%;
+    overflow-x: hidden;
+    width: 100%
+}
+
+body {
+    margin: 0
+}
+
+a {
+    background: 0 0;
+    overflow-wrap: break-word
+}
+
+a:focus {
+    outline: thin dotted
+}
+
+a:active,
+a:hover {
+    outline: 0
+}
+
+h1 {
+    font-size: 2em;
+    margin: .67em 0
+}
+
+abbr[title] {
+    border-bottom: 1px dotted
+}
+
+b,
+strong {
+    font-weight: 700
+}
+
+dfn {
+    font-style: italic
+}
+
+hr {
+    -moz-box-sizing: content-box;
+    box-sizing: content-box;
+    height: 0
+}
+
+mark {
+    background: #ff0;
+    color: #000
+}
+
+code,
+kbd,
+pre,
+samp {
+    font-family: monospace, serif;
+    font-size: 1em
+}
+
+pre {
+    white-space: pre-wrap
+}
+
+q {
+    quotes: "\201C" "\201D" "\2018" "\2019"
+}
+
+small {
+    font-size: 80%
+}
+
+sub,
+sup {
+    font-size: 75%;
+    line-height: 0;
+    position: relative;
+    vertical-align: baseline
+}
+
+sup {
+    top: -.5em
+}
+
+sub {
+    bottom: -.25em
+}
+
+img {
+    border: 0
+}
+
+svg:not(:root) {
+    overflow: hidden
+}
+
+figure {
+    margin: 0
+}
+
+fieldset {
+    border: 1px solid silver;
+    margin: 0 2px;
+    padding: .35em .625em .75em
+}
+
+legend {
+    border: 0;
+    padding: 0
+}
+
+button,
+input,
+select,
+textarea {
+    font-family: inherit;
+    font-size: 100%;
+    margin: 0
+}
+
+button,
+input {
+    line-height: normal
+}
+
+button,
+select {
+    text-transform: none
+}
+
+button,
+html input[type=button],
+input[type=reset],
+input[type=submit] {
+    -webkit-appearance: button;
+    cursor: pointer
+}
+
+button[disabled],
+html input[disabled] {
+    cursor: default
+}
+
+input[type=checkbox],
+input[type=radio] {
+    box-sizing: border-box;
+    padding: 0
+}
+
+input[type=search] {
+    -webkit-appearance: textfield;
+    -moz-box-sizing: content-box;
+    -webkit-box-sizing: content-box;
+    box-sizing: content-box
+}
+
+input[type=search]::-webkit-search-cancel-button,
+input[type=search]::-webkit-search-decoration {
+    -webkit-appearance: none
+}
+
+button::-moz-focus-inner,
+input::-moz-focus-inner {
+    border: 0;
+    padding: 0
+}
+
+textarea {
+    overflow: auto;
+    vertical-align: top
+}
+
+table {
+    border-collapse: collapse;
+    border-spacing: 0
+}
+
+meta.foundation-mq-small {
+    font-family: "only screen and (min-width: 768px)";
+    width: 768px
+}
+
+meta.foundation-mq-medium {
+    font-family: "only screen and (min-width:1280px)";
+    width: 1280px
+}
+
+meta.foundation-mq-large {
+    font-family: "only screen and (min-width:1440px)";
+    width: 1440px
+}
+
+*,
+:after,
+:before {
+    -moz-box-sizing: border-box;
+    -webkit-box-sizing: border-box;
+    box-sizing: border-box
+}
+
+body,
+html {
+    font-size: 100%
+}
+
+body {
+    background: #fff;
+    color: #595959;
+    padding: 0;
+    margin: 0;
+    font-family: "Helvetica Neue", Helvetica, Helvetica, Arial, sans-serif;
+    font-weight: 400;
+    font-style: normal;
+    line-height: 1;
+    position: relative;
+    cursor: auto
+}
+
+a:hover {
+    cursor: pointer
+}
+
+embed,
+img,
+object {
+    max-width: 100%;
+    height: auto
+}
+
+embed,
+object {
+    height: 100%
+}
+
+img {
+    -ms-interpolation-mode: bicubic
+}
+
+#map_canvas embed,
+#map_canvas img,
+#map_canvas object,
+.map_canvas embed,
+.map_canvas img,
+.map_canvas object {
+    max-width: none!important
+}
+
+.left {
+    float: left!important
+}
+
+.right {
+    float: right!important
+}
+
+.text-left {
+    text-align: left!important
+}
+
+.text-right {
+    text-align: right!important
+}
+
+.text-center {
+    text-align: center!important
+}
+
+.text-justify {
+    text-align: justify!important
+}
+
+.hide {
+    display: none
+}
+
+.antialiased,
+body {
+    -webkit-font-smoothing: antialiased
+}
+
+img {
+    display: inline-block;
+    vertical-align: middle
+}
+
+textarea {
+    height: auto;
+    min-height: 50px
+}
+
+select {
+    width: 100%
+}
+
+object,
+svg {
+    display: inline-block;
+    vertical-align: middle
+}
+
+.center {
+    margin-left: auto;
+    margin-right: auto
+}
+
+.spread {
+    width: 100%
+}
+
+#preamble>.sectionbody>.paragraph:first-of-type p,
+.paragraph.lead>p,
+p.lead {
+    font-size: 1.21875em;
+    line-height: 1.6
+}
+
+.admonitionblock td.content>.title,
+.audioblock>.title,
+.dlist>.title,
+.exampleblock>.title,
+.hdlist>.title,
+.imageblock>.title,
+.listingblock>.title,
+.literalblock>.title,
+.olist>.title,
+.openblock>.title,
+.paragraph>.title,
+.qlist>.title,
+.quoteblock>.title,
+.stemblock>.title,
+.subheader,
+.ulist>.title,
+.verseblock>.title,
+.videoblock>.title,
+table.tableblock>.title {
+    line-height: 1.4;
+    color: #6f6f6f;
+    font-weight: 500;
+    margin-top: .2em;
+    margin-bottom: .5em
+}
+
+#toctitle,
+.sidebarblock>.content>.title,
+blockquote,
+dd,
+div,
+dl,
+dt,
+form,
+h1,
+h2,
+h3,
+h4,
+h5,
+h6,
+li,
+ol,
+p,
+pre,
+td,
+th,
+ul {
+    margin: 0;
+    padding: 0;
+    direction: ltr
+}
+
+a {
+    color: #2ba6cb;
+    text-decoration: none;
+    line-height: inherit
+}
+
+a:focus,
+a:hover {
+    color: #595959
+}
+
+a img {
+    border: none
+}
+
+p {
+    font-family: inherit;
+    font-weight: 400;
+    font-size: 1em;
+    line-height: 1.6;
+    margin-bottom: 5px;
+    text-rendering: optimizeLegibility
+}
+
+p aside {
+    font-size: .875em;
+    line-height: 1.35;
+    font-style: italic
+}
+
+#toctitle,
+.sidebarblock>.content>.title,
+h1,
+h2,
+h3,
+h4,
+h5,
+h6 {
+    font-family: "Helvetica Neue", Helvetica, Helvetica, Arial, sans-serif;
+    font-weight: 700;
+    font-style: normal;
+    color: #595959;
+    text-rendering: optimizeLegibility;
+    margin-top: 0.5em;
+    margin-bottom: .5em;
+    line-height: 1.2125em
+}
+
+#toctitle small,
+.sidebarblock>.content>.title small,
+h1 small,
+h2 small,
+h3 small,
+h4 small,
+h5 small,
+h6 small {
+    font-size: 60%;
+    color: #6f6f6f;
+    line-height: 0
+}
+
+h1 {
+    font-size: 2.125em
+}
+
+h2 {
+    font-size: 1.6875em
+}
+
+#toctitle,
+.sidebarblock>.content>.title,
+h3 {
+    font-size: 1.375em
+}
+
+h4 {
+    font-size: 1.125em
+}
+
+h5 {
+    font-size: 1.125em
+}
+
+h6 {
+    font-size: 1em
+}
+
+hr {
+    border: solid #ddd;
+    border-width: 1px 0 0;
+    clear: both;
+    margin: 1.25em 0 1.1875em;
+    height: 0
+}
+
+em,
+i {
+    font-style: italic;
+    line-height: inherit
+}
+
+b,
+strong {
+    font-weight: 700;
+    line-height: inherit
+}
+
+small {
+    font-size: 60%;
+    line-height: inherit
+}
+
+code {
+    font-family: Consolas, "Liberation Mono", Courier, monospace;
+    font-weight: 700;
+    color: #000;
+    border-radius: .3rem;
+    background-color: #f5f2f0
+}
+
+dl,
+ol,
+ul {
+    font-size: 1em;
+    line-height: 1.6;
+    margin-bottom: 1.25em;
+    list-style-position: outside;
+    font-family: inherit
+}
+
+ol,
+ul {
+    margin-left: 1.5em
+}
+
+ol.no-bullet,
+ul.no-bullet {
+    margin-left: 1.5em
+}
+
+ul li ol,
+ul li ul {
+    margin-left: 1.25em;
+    margin-bottom: 0;
+    font-size: 1em
+}
+
+ul.circle li ul,
+ul.disc li ul,
+ul.square li ul {
+    list-style: inherit
+}
+
+ul.square {
+    list-style-type: square
+}
+
+ul.circle {
+    list-style-type: circle
+}
+
+ul.disc {
+    list-style-type: disc
+}
+
+ul.no-bullet {
+    list-style: none
+}
+
+ol li ol,
+ol li ul {
+    margin-left: 1.25em;
+    margin-bottom: 0
+}
+
+dl dt {
+    margin-bottom: .3125em;
+    font-weight: 700
+}
+
+dl dd {
+    margin-bottom: 1.25em
+}
+
+abbr,
+acronym {
+    text-transform: uppercase;
+    font-size: 90%;
+    color: #222;
+    border-bottom: 1px dotted #ddd;
+    cursor: help
+}
+
+abbr {
+    text-transform: none
+}
+
+blockquote {
+    margin: 0 0 1.25em;
+    padding: .5625em 1.25em 0 1.1875em;
+    border-left: 1px solid #ddd
+}
+
+blockquote cite {
+    display: block;
+    font-size: .8125em;
+    color: #555
+}
+
+blockquote cite:before {
+    content: "\2014 \0020"
+}
+
+blockquote cite a,
+blockquote cite a:visited {
+    color: #555
+}
+
+blockquote,
+blockquote p {
+    line-height: 1.6;
+    color: #6f6f6f
+}
+
+.vcard {
+    display: inline-block;
+    margin: 0 0 1.25em 0;
+    border: 1px solid #ddd;
+    padding: .625em .75em
+}
+
+.vcard li {
+    margin: 0;
+    display: block
+}
+
+.vcard .fn {
+    font-weight: 700;
+    font-size: .9375em
+}
+
+.vevent .summary {
+    font-weight: 700
+}
+
+.vevent abbr {
+    cursor: auto;
+    text-decoration: none;
+    font-weight: 700;
+    border: none;
+    padding: 0 .0625em
+}
+
+@media only screen and (min-width:768px) {
+    #toctitle,
+    .sidebarblock>.content>.title,
+    h1,
+    h2,
+    h3,
+    h4,
+    h5,
+    h6 {
+        line-height: 1.4
+    }
+    h1 {
+        font-size: 2.75em
+    }
+    h2 {
+        font-size: 2.3125em
+    }
+    #toctitle,
+    .sidebarblock>.content>.title,
+    h3 {
+        font-size: 1.6875em
+    }
+    h4 {
+        font-size: 1.4375em
+    }
+}
+
+table {
+    background: #fff;
+    margin-bottom: 1.25em;
+    border: solid 1px #ddd
+}
+
+table tfoot,
+table thead {
+    background: #f5f5f5;
+    font-weight: 600
+}
+
+table tfoot tr td,
+table tfoot tr th,
+table thead tr td,
+table thead tr th {
+    padding: .5em .625em .625em;
+    font-size: inherit;
+    color: #222;
+    text-align: left
+}
+
+table tr td,
+table tr th {
+    padding: .5625em .625em;
+    font-size: inherit;
+    color: #595959
+}
+
+table tr.alt,
+table tr.even,
+table tr:nth-of-type(even) {
+    background: #f9f9f9
+}
+
+table tbody tr td,
+table tfoot tr td,
+table tfoot tr th,
+table thead tr th,
+table tr td {
+    display: table-cell;
+    line-height: 1.4
+}
+
+body {
+    tab-size: 4
+}
+
+#toctitle,
+.sidebarblock>.content>.title,
+h1,
+h2,
+h3,
+h4,
+h5,
+h6 {
+    line-height: 1.4
+}
+
+.clearfix:after,
+.clearfix:before,
+.float-group:after,
+.float-group:before {
+    content: " ";
+    display: table
+}
+
+.clearfix:after,
+.float-group:after {
+    clear: both
+}
+
+:not(pre)>code {
+    font-size: inherit;
+    font-style: normal!important;
+    letter-spacing: 0;
+    padding: 0;
+    line-height: inherit
+}
+
+pre,
+pre>code {
+    line-height: 1.4;
+    color: #000;
+    font-family: monospace, serif;
+    font-weight: 400
+}
+
+.keyseq {
+    color: #555
+}
+
+kbd {
+    font-family: Consolas, "Liberation Mono", Courier, monospace;
+    display: inline-block;
+    color: #222;
+    font-size: .65em;
+    line-height: 1.45;
+    background-color: #f7f7f7;
+    border: 1px solid #ccc;
+    -webkit-border-radius: 3px;
+    border-radius: 3px;
+    -webkit-box-shadow: 0 1px 0 rgba(0, 0, 0, .2), 0 0 0 .1em #fff inset;
+    box-shadow: 0 1px 0 rgba(0, 0, 0, .2), 0 0 0 .1em #fff inset;
+    margin: 0 .15em;
+    padding: .2em .5em;
+    vertical-align: middle;
+    position: relative;
+    top: -.1em;
+    white-space: nowrap
+}
+
+.keyseq kbd:first-child {
+    margin-left: 0
+}
+
+.keyseq kbd:last-child {
+    margin-right: 0
+}
+
+.menu,
+.menuseq {
+    color: #090909
+}
+
+b.button:after,
+b.button:before {
+    position: relative;
+    top: -1px;
+    font-weight: 400
+}
+
+b.button:before {
+    content: "[";
+    padding: 0 3px 0 2px
+}
+
+b.button:after {
+    content: "]";
+    padding: 0 2px 0 3px
+}
+
+#content,
+#footer,
+#footnotes,
+#header {
+    max-width: 1300px;
+    margin-right: 80px;
+    margin-top: 0;
+    margin-bottom: 0;
+    position: relative;
+    padding-left: .9375em;
+    padding-right: .9375em;
+    left: 40px
+}
+
+#content:after,
+#content:before,
+#footer:after,
+#footer:before,
+#footnotes:after,
+#footnotes:before,
+#header:after,
+#header:before {
+    content: " ";
+    display: table
+}
+
+#content:after,
+#footer:after,
+#footnotes:after,
+#header:after {
+    clear: both
+}
+
+#content {
+    margin-top: 0em;
+    padding-right: 0;
+    margin-right: 115px
+}
+
+#content:before {
+    content: none
+}
+
+#header>h1:first-child {
+    color: #595959;
+    margin-top: 2.25rem;
+    margin-bottom: 0
+}
+
+#header>h1:first-child+#toc {
+    margin-top: 8px;
+    border-top: 1px solid #ddd
+}
+
+#header>h1:only-child,
+body.toc2 #header>h1:nth-last-child(2) {
+    border-bottom: 1px solid #ddd;
+    padding-bottom: 8px
+}
+
+#header .details {
+    border-bottom: 1px solid #ddd;
+    line-height: 1.45;
+    padding-top: .25em;
+    padding-bottom: .25em;
+    padding-left: .25em;
+    color: #555;
+    display: -ms-flexbox;
+    display: -webkit-flex;
+    display: flex;
+    -ms-flex-flow: row wrap;
+    -webkit-flex-flow: row wrap;
+    flex-flow: row wrap
+}
+
+#header .details span:first-child {
+    margin-left: -.125em
+}
+
+#header .details span.email a {
+    color: #6f6f6f
+}
+
+#header .details br {
+    display: none
+}
+
+#header .details br+span:before {
+    content: "\00a0\2013\00a0"
+}
+
+#header .details br+span.author:before {
+    content: "\00a0\22c5\00a0";
+    color: #6f6f6f
+}
+
+#header .details br+span#revremark:before {
+    content: "\00a0|\00a0"
+}
+
+#header #revnumber {
+    text-transform: capitalize
+}
+
+#header #revnumber:after {
+    content: "\00a0"
+}
+
+#content>h1:first-child:not([class]) {
+    color: #000;
+    border-bottom: 1px solid #ddd;
+    padding-bottom: 8px;
+    margin-top: 0;
+    padding-top: 1rem;
+    margin-bottom: 1.25rem
+}
+
+#toc {
+    border-bottom: 1px solid #ddd;
+    padding-bottom: .5em;
+    position: relative;
+    left: 0
+}
+
+#toctitle {
+    color: #6f6f6f;
+    font-size: 1.2em
+}
+
+#toc ul li:before {
+    content: "";
+    margin-left: -.75em;
+    margin-right: .4em;
+    color: #244d82
+}
+
+div.ulist li:before {
+    content: "";
+    position: absolute;
+    margin-top: .2rem;
+    font-size: x-large;
+    margin-left: -.75em;
+    margin-bottom: -.75em;
+    margin-right: 0;
+    line-height: 1rem;
+    color: #244d82
+}
+
+#toctitle {
+    color: #595959;
+    font-size: 1.2em;
+    padding-left: 1em
+}
+
+#faq {
+    position: relative;
+    right: 9.3rem;
+    top: 9rem;
+    margin-bottom: 20px;
+    left: 45rem;
+    z-index: 1;
+    padding-left: 2rem;
+    border-left: 1px solid #d3d3d3
+}
+
+@media only screen and (max-width:945px) {
+    div#faq {
+        display: none
+    }
+}
+
+#faq h2 {
+    font-size: 25px;
+    font-weight: 600;
+    margin-top: -8rem
+}
+
+div#faq li:before {
+    content: "";
+    position: absolute;
+    font-size: x-large;
+    margin-left: -.75em;
+    margin-bottom: -.75em;
+    margin-right: 0;
+    line-height: 1rem;
+    color: #244d82
+}
+
+#features-nav {
+    position: absolute;
+    right: 1rem;
+    top: 2rem;
+    margin-bottom: 20px;
+    position: absolute;
+    z-index: 1;
+    padding-left: 2rem;
+    border-left: 1px solid #d3d3d3
+}
+
+@media only screen and (max-width:993px) {
+    #features-nav {
+        display: none
+    }
+}
+
+#features-nav h2 {
+    font-size: 25px;
+    font-weight: 600;
+    margin-top: -1rem
+}
+
+#features-nav li {
+    margin-top: .3rem
+}
+
+div#features-nav li:before {
+    content: "";
+    position: absolute;
+    font-size: x-large;
+    margin-left: -.75em;
+    margin-bottom: -.75em;
+    margin-right: 0;
+    line-height: 1rem;
+    color: #244d82
+}
+
+@media only screen and (min-width:768px) {
+    #toctitle {
+        padding-top: 0;
+        font-size: 1.375em
+    }
+    body.toc2 {
+        padding-left: 2em;
+        padding-right: 1em
+    }
+    #toc.toc2 {
+        margin-top: 0!important;
+        background-color: #f2f2f2;
+        position: fixed;
+        width: 260px;
+        left: 0;
+        top: 0;
+        border-right: 1px solid #ddd;
+        border-top-width: 0!important;
+        border-bottom-width: 0!important;
+        z-index: 1000;
+        padding: 1.25em .25em 0 .25em;
+        height: 100%;
+        overflow: auto
+    }
+    #toc.toc2 #toctitle {
+        margin-top: 0;
+        margin-bottom: .8rem;
+        font-size: 1.2em;
+        padding-left: 1em
+    }
+    #toc.toc2>ul {
+        font-size: .9em;
+        margin-bottom: 0
+    }
+    #toc.toc2 ul ul {
+        margin-left: 6px
+    }
+    #toc.toc2 ul.sectlevel0 ul.sectlevel1 {
+        padding-left: 0;
+        margin-top: .5em;
+        margin-bottom: .5em
+    }
+    body.toc2.toc-right {
+        padding-left: 2em;
+        padding-right: 2em
+    }
+    body.toc2.toc-right #toc.toc2 {
+        border-right-width: 0;
+        border-left: 1px solid #ddd;
+        left: auto;
+        right: -260px
+    }
+}
+
+body.toc2.toc-left #toc.toc2 {
+    left: -260px
+}
+
+@media only screen and (min-width:1535px) {
+    body.toc2 {
+        padding-left: 2em;
+        padding-right: 2em
+    }
+    #toctitle {
+        padding-top: 0;
+        font-size: 1.375em
+    }
+    #toc.toc2 {
+        width: 260px
+    }
+    #toc.toc2 #toctitle {
+        font-size: 1.375em
+    }
+    #toc.toc2>ul {
+        font-size: .95em
+    }
+    #toc.toc2 ul ul {
+        padding-left: 0
+    }
+    body.toc2.toc-right {
+        padding-left: 2em;
+        padding-right: 2em
+    }
+}
+
+#content #toc {
+    border-style: solid;
+    border-width: 1px;
+    border-color: #d9d9d9;
+    margin-bottom: 1.25em;
+    padding: 1.25em;
+    background: #f2f2f2;
+    -webkit-border-radius: 0;
+    border-radius: 0
+}
+
+#content #toc>:first-child {
+    margin-top: 0
+}
+
+#content #toc>:last-child {
+    margin-bottom: 0
+}
+
+#footer {
+    padding: 1.25em;
+    padding-bottom: 0;
+    margin-top: 2rem;
+    color: #fff
+}
+
+div.social {
+    padding: 1.25em;
+    padding-left: 20%;
+    padding-bottom: 0;
+    margin-top: 2rem;
+    color: #fff
+}
+
+div.social>ul li {
+    margin-left: 15%;
+    color: #fff;
+    line-height: 1.44;
+    font-size: 1.2em;
+    font-weight: 800;
+    font-style: bold;
+    position: relative;
+    list-style: none;
+    list-style-type: none;
+    display: inline;
+    text-decoration: none
+}
+
+#bottomright {
+    float: right
+}
+
+#footer-text {
+    color: #ddd;
+    line-height: 1.44
+}
+
+.sect1 {
+    padding-bottom: 0em
+}
+
+@media only screen and (min-width:768px) {
+    .sect1 {
+        padding-bottom: 0em
+    }
+}
+
+.sect1+.sect1 {
+    border-top: 1px solid #ddd
+}
+
+#content h1>a.anchor,
+#toctitle>a.anchor,
+.sidebarblock>.content>.title>a.anchor,
+h2>a.anchor,
+h3>a.anchor,
+h4>a.anchor,
+h5>a.anchor,
+h6>a.anchor {
+    position: absolute;
+    z-index: 1001;
+    width: 1.5ex;
+    margin-left: -1.5ex;
+    display: block;
+    text-decoration: none!important;
+    visibility: hidden;
+    text-align: center;
+    font-weight: 400
+}
+
+#content h1>a.anchor:before,
+#toctitle>a.anchor:before,
+.sidebarblock>.content>.title>a.anchor:before,
+h2>a.anchor:before,
+h3>a.anchor:before,
+h4>a.anchor:before,
+h5>a.anchor:before,
+h6>a.anchor:before {
+    content: "\00A7";
+    font-size: .85em;
+    display: block;
+    padding-top: .1em
+}
+
+#content h1:hover>a.anchor,
+#content h1>a.anchor:hover,
+#toctitle:hover>a.anchor,
+#toctitle>a.anchor:hover,
+.sidebarblock>.content>.title:hover>a.anchor,
+.sidebarblock>.content>.title>a.anchor:hover,
+h2:hover>a.anchor,
+h2>a.anchor:hover,
+h3:hover>a.anchor,
+h3>a.anchor:hover,
+h4:hover>a.anchor,
+h4>a.anchor:hover,
+h5:hover>a.anchor,
+h5>a.anchor:hover,
+h6:hover>a.anchor,
+h6>a.anchor:hover {
+    visibility: visible
+}
+
+#content h1>a.link,
+#toctitle>a.link,
+.sidebarblock>.content>.title>a.link,
+h2>a.link,
+h3>a.link,
+h4>a.link,
+h5>a.link,
+h6>a.link {
+    color: #595959;
+    text-decoration: none
+}
+
+#content h1>a.link:hover,
+#toctitle>a.link:hover,
+.sidebarblock>.content>.title>a.link:hover,
+h2>a.link:hover,
+h3>a.link:hover,
+h4>a.link:hover,
+h5>a.link:hover,
+h6>a.link:hover {
+    color: #151515
+}
+
+.audioblock,
+.imageblock,
+.listingblock,
+.literalblock,
+.stemblock,
+.videoblock {
+    margin-bottom: 1.25em
+}
+
+.admonitionblock td.content>.title,
+.audioblock>.title,
+.dlist>.title,
+.exampleblock>.title,
+.hdlist>.title,
+.imageblock>.title,
+.listingblock>.title,
+.literalblock>.title,
+.olist>.title,
+.openblock>.title,
+.paragraph>.title,
+.qlist>.title,
+.quoteblock>.title,
+.stemblock>.title,
+.ulist>.title,
+.verseblock>.title,
+.videoblock>.title,
+table.tableblock>.title {
+    text-rendering: optimizeLegibility;
+    text-align: left
+}
+
+table.tableblock>caption.title {
+    white-space: nowrap;
+    overflow: visible;
+    max-width: 0
+}
+
+#preamble>.sectionbody>.paragraph:first-of-type p,
+.paragraph.lead>p {
+    color: #000
+}
+
+table.tableblock #preamble>.sectionbody>.paragraph:first-of-type p {
+    font-size: inherit
+}
+
+.admonitionblock>table {
+    border-collapse: separate;
+    border: 0;
+    background: 0 0;
+    width: 100%
+}
+
+.admonitionblock>table td.icon {
+    text-align: center;
+    width: 80px
+}
+
+.admonitionblock>table td.icon img {
+    max-width: none
+}
+
+.admonitionblock>table td.icon .title {
+    font-weight: 700;
+    font-family: "Helvetica Neue", Helvetica, Helvetica, Arial, sans-serif;
+    text-transform: uppercase
+}
+
+.admonitionblock>table td.content {
+    padding-left: 1.125em;
+    padding-right: 1.25em;
+    border-left: 1px solid #ddd;
+    color: #555
+}
+
+.admonitionblock>table td.content>:last-child>:last-child {
+    margin-bottom: 0
+}
+
+.exampleblock>.content {
+    border-style: solid;
+    border-width: 2px;
+    border-color: #8c8989;
+    margin-bottom: 1.25em;
+    padding: 1.25em;
+    background: #fff;
+    -webkit-border-radius: 0;
+    border-radius: 15px
+}
+
+.exampleblock>.content>:first-child {
+    margin-top: 0
+}
+
+.exampleblock>.content>:last-child {
+    margin-bottom: 0
+}
+
+.sidebarblock {
+    position: absolute;
+    border-style: solid;
+    width: 90px;
+    border-width: 1px;
+    border-color: #d9d9d9;
+    right: -90px;
+    padding: .1rem;
+    background: #f2f2f2;
+    -webkit-border-radius: 0;
+    border-radius: 0;
+    text-align: left;
+    border-radius: 5px;
+    word-break: break-word;
+    font-size: smaller
+}
+
+.sidebarblock>:first-child {
+    margin-top: 0
+}
+
+.sidebarblock>:last-child {
+    margin-bottom: 0
+}
+
+.sidebarblock>.content>.title {
+    color: #6999d6;
+    margin-top: 0
+}
+
+.exampleblock>.content .olist>ol>li:last-child>:last-child,
+.exampleblock>.content .qlist>ol>li:last-child>:last-child,
+.exampleblock>.content .ulist>ul>li:last-child>:last-child,
+.exampleblock>.content>:last-child>:last-child,
+.sidebarblock>.content .olist>ol>li:last-child>:last-child,
+.sidebarblock>.content .qlist>ol>li:last-child>:last-child,
+.sidebarblock>.content .ulist>ul>li:last-child>:last-child,
+.sidebarblock>.content>:last-child>:last-child {
+    margin-bottom: 0
+}
+
+.listingblock pre.CodeRay,
+.listingblock pre.prettyprint,
+.listingblock pre:not(.highlight),
+.listingblock pre[class=highlight],
+.listingblock pre[class^="highlight "],
+.literalblock pre {
+    background: #eee
+}
+
+.sidebarblock .listingblock pre.CodeRay,
+.sidebarblock .listingblock pre.prettyprint,
+.sidebarblock .listingblock pre:not(.highlight),
+.sidebarblock .listingblock pre[class=highlight],
+.sidebarblock .listingblock pre[class^="highlight "],
+.sidebarblock .literalblock pre {
+    background: #f2f1f1
+}
+
+.listingblock pre,
+.listingblock pre[class],
+.literalblock pre,
+.literalblock pre[class] {
+    border: 1px solid #ccc;
+    -webkit-border-radius: 0;
+    border-radius: 0;
+    word-wrap: break-word;
+    padding: .8em .8em .65em .8em;
+    font-size: .8125em
+}
+
+.listingblock pre.nowrap,
+.listingblock pre[class].nowrap,
+.literalblock pre.nowrap,
+.literalblock pre[class].nowrap {
+    overflow-x: auto;
+    white-space: pre;
+    word-wrap: normal
+}
+
+@media only screen and (min-width:768px) {
+    .listingblock pre,
+    .listingblock pre[class],
+    .literalblock pre,
+    .literalblock pre[class] {
+        font-size: .90625em
+    }
+}
+
+@media only screen and (min-width:1280px) {
+    .listingblock pre,
+    .listingblock pre[class],
+    .literalblock pre,
+    .literalblock pre[class] {
+        font-size: 1em
+    }
+}
+
+.literalblock.output pre {
+    color: #eee;
+    background-color: #000
+}
+
+.listingblock pre.highlightjs {
+    padding: 0
+}
+
+.listingblock pre.highlightjs>code {
+    padding: .8em .8em .65em .8em;
+    -webkit-border-radius: 0;
+    border-radius: 0
+}
+
+.listingblock>.content {
+    position: relative
+}
+
+.listingblock.terminal pre .command:before {
+    content: attr(data-prompt);
+    padding-right: .5em;
+    color: #999
+}
+
+.listingblock.terminal pre .command:not([data-prompt]):before {
+    content: "$"
+}
+
+table.pyhltable {
+    border-collapse: separate;
+    border: 0;
+    margin-bottom: 0;
+    background: 0 0
+}
+
+table.pyhltable td {
+    vertical-align: top;
+    padding-top: 0;
+    padding-bottom: 0;
+    line-height: 1.4
+}
+
+table.pyhltable td.code {
+    padding-left: .75em;
+    padding-right: 0
+}
+
+pre.pygments .lineno,
+table.pyhltable td:not(.code) {
+    color: #999;
+    padding-left: 0;
+    padding-right: .5em;
+    border-right: 1px solid #ddd
+}
+
+pre.pygments .lineno {
+    display: inline-block;
+    margin-right: .25em
+}
+
+table.pyhltable .linenodiv {
+    background: 0 0!important;
+    padding-right: 0!important
+}
+
+.quoteblock {
+    margin: 0 1em 1.25em 1.5em;
+    display: table
+}
+
+.quoteblock>.title {
+    margin-left: -1.5em;
+    margin-bottom: .75em
+}
+
+.quoteblock blockquote,
+.quoteblock blockquote p {
+    color: #6f6f6f;
+    font-size: 1.15rem;
+    line-height: 1.75;
+    word-spacing: .1em;
+    letter-spacing: 0;
+    font-style: italic;
+    text-align: justify
+}
+
+.quoteblock blockquote {
+    margin: 0;
+    padding: 0;
+    border: 0
+}
+
+.quoteblock blockquote:before {
+    content: "\201c";
+    float: left;
+    font-size: 2.75em;
+    font-weight: 700;
+    line-height: .6em;
+    margin-left: -.6em;
+    color: #6f6f6f;
+    text-shadow: 0 1px 2px rgba(0, 0, 0, .1)
+}
+
+.quoteblock blockquote>.paragraph:last-child p {
+    margin-bottom: 0
+}
+
+.quoteblock .attribution {
+    margin-top: .5em;
+    margin-right: .5ex;
+    text-align: right
+}
+
+.quoteblock .quoteblock {
+    margin-left: 0;
+    margin-right: 0;
+    padding: .5em 0;
+    border-left: 3px solid #555
+}
+
+.quoteblock .quoteblock blockquote {
+    padding: 0 0 0 .75em
+}
+
+.quoteblock .quoteblock blockquote:before {
+    display: none
+}
+
+.verseblock {
+    margin: 0 1em 1.25em 1em
+}
+
+.verseblock pre {
+    font-family: "Open Sans", "DejaVu Sans", sans;
+    font-size: 1.15rem;
+    color: #6f6f6f;
+    font-weight: 300;
+    text-rendering: optimizeLegibility
+}
+
+.verseblock pre strong {
+    font-weight: 400
+}
+
+.verseblock .attribution {
+    margin-top: 1.25rem;
+    margin-left: .5ex
+}
+
+.quoteblock .attribution,
+.verseblock .attribution {
+    font-size: .8125em;
+    line-height: 1.45;
+    font-style: italic
+}
+
+.quoteblock .attribution br,
+.verseblock .attribution br {
+    display: none
+}
+
+.quoteblock .attribution cite,
+.verseblock .attribution cite {
+    display: block;
+    letter-spacing: -.025em;
+    color: #555
+}
+
+.quoteblock.abstract {
+    margin: 0 0 1.25em 0;
+    display: block
+}
+
+.quoteblock.abstract blockquote,
+.quoteblock.abstract blockquote p {
+    text-align: left;
+    word-spacing: 0
+}
+
+.quoteblock.abstract blockquote p:first-of-type:before,
+.quoteblock.abstract blockquote:before {
+    display: none
+}
+
+table.tableblock {
+    max-width: 100%;
+    border-collapse: separate
+}
+
+table.tableblock td>.paragraph:last-child p>p:last-child,
+table.tableblock td>p:last-child,
+table.tableblock th>p:last-child {
+    margin-bottom: 0
+}
+
+table.tableblock,
+td.tableblock,
+th.tableblock {
+    border: 0 solid #ddd
+}
+
+table.grid-all td.tableblock,
+table.grid-all th.tableblock {
+    border-width: 0 1px 1px 0
+}
+
+table.grid-all tfoot>tr>td.tableblock,
+table.grid-all tfoot>tr>th.tableblock {
+    border-width: 1px 1px 0 0
+}
+
+table.grid-cols td.tableblock,
+table.grid-cols th.tableblock {
+    border-width: 0 1px 0 0
+}
+
+table.grid-all *>tr>.tableblock:last-child,
+table.grid-cols *>tr>.tableblock:last-child {
+    border-right-width: 0
+}
+
+table.grid-rows td.tableblock,
+table.grid-rows th.tableblock {
+    border-width: 0 0 1px 0
+}
+
+table.grid-all tbody>tr:last-child>td.tableblock,
+table.grid-all tbody>tr:last-child>th.tableblock,
+table.grid-all thead:last-child>tr>th.tableblock,
+table.grid-rows tbody>tr:last-child>td.tableblock,
+table.grid-rows tbody>tr:last-child>th.tableblock,
+table.grid-rows thead:last-child>tr>th.tableblock {
+    border-bottom-width: 0
+}
+
+table.grid-rows tfoot>tr>td.tableblock,
+table.grid-rows tfoot>tr>th.tableblock {
+    border-width: 1px 0 0 0
+}
+
+table.frame-all {
+    border-width: 1px
+}
+
+table.frame-sides {
+    border-width: 0 1px
+}
+
+table.frame-topbot {
+    border-width: 1px 0
+}
+
+td.halign-left,
+th.halign-left {
+    text-align: left
+}
+
+td.halign-right,
+th.halign-right {
+    text-align: right
+}
+
+td.halign-center,
+th.halign-center {
+    text-align: center
+}
+
+td.valign-top,
+th.valign-top {
+    vertical-align: top
+}
+
+td.valign-bottom,
+th.valign-bottom {
+    vertical-align: bottom
+}
+
+td.valign-middle,
+th.valign-middle {
+    vertical-align: middle
+}
+
+table tfoot th,
+table thead th {
+    font-weight: 700
+}
+
+tbody tr th {
+    display: table-cell;
+    line-height: 1.4;
+    background: #f5f5f5
+}
+
+tbody tr th,
+tbody tr th p,
+tfoot tr th,
+tfoot tr th p {
+    color: #222;
+    font-weight: 700
+}
+
+p.tableblock>code:only-child {
+    background: 0 0;
+    padding: 0
+}
+
+p.tableblock {
+    font-size: 1em
+}
+
+td>div.verse {
+    white-space: pre
+}
+
+ol {
+    margin-left: 1.75em
+}
+
+ul li ol {
+    margin-left: 1.5em
+}
+
+dl dd {
+    margin-left: 1.125em
+}
+
+dl dd:last-child,
+dl dd:last-child>:last-child {
+    margin-bottom: 0
+}
+
+.olist .olist,
+.olist .ulist,
+.ulist .olist,
+.ulist .ulist,
+ol dd,
+ol>li p,
+ul dd,
+ul>li p {
+    margin-bottom: .625em
+}
+
+ol.unnumbered,
+ul.checklist,
+ul.none,
+ul.unstyled {
+    list-style-type: none
+}
+
+ol.unnumbered,
+ul.checklist,
+ul.unstyled {
+    margin-left: .625em
+}
+
+ul.checklist li>p:first-child>.fa-check-square-o:first-child,
+ul.checklist li>p:first-child>.fa-square-o:first-child {
+    width: 1em;
+    font-size: .85em
+}
+
+ul.checklist li>p:first-child>input[type=checkbox]:first-child {
+    width: 1em;
+    position: relative;
+    top: 1px
+}
+
+ul.inline {
+    margin: 0 auto .625em auto;
+    margin-left: -1.375em;
+    margin-right: 0;
+    padding: 0;
+    list-style: none;
+    overflow: hidden
+}
+
+ul.inline>li {
+    list-style: none;
+    float: left;
+    margin-left: 1.375em;
+    display: block
+}
+
+ul.inline>li>* {
+    display: block
+}
+
+.unstyled dl dt {
+    font-weight: 400;
+    font-style: normal
+}
+
+ol.arabic {
+    list-style-type: decimal
+}
+
+ol.decimal {
+    list-style-type: decimal-leading-zero
+}
+
+ol.loweralpha {
+    list-style-type: lower-alpha
+}
+
+ol.upperalpha {
+    list-style-type: upper-alpha
+}
+
+ol.lowerroman {
+    list-style-type: lower-roman
+}
+
+ol.upperroman {
+    list-style-type: upper-roman
+}
+
+ol.lowergreek {
+    list-style-type: lower-greek
+}
+
+.colist>table,
+.hdlist>table {
+    border: 0;
+    background: 0 0
+}
+
+.colist>table>tbody>tr,
+.hdlist>table>tbody>tr {
+    background: 0 0
+}
+
+td.hdlist1,
+td.hdlist2 {
+    vertical-align: top;
+    padding: 0 .625em
+}
+
+td.hdlist1 {
+    font-weight: 700;
+    padding-bottom: 1.25em
+}
+
+.listingblock+.colist,
+.literalblock+.colist {
+    margin-top: -.5em
+}
+
+.colist>table tr>td:first-of-type {
+    padding: 0 .75em;
+    line-height: 1
+}
+
+.colist>table tr>td:last-of-type {
+    padding: .25em 0
+}
+
+.th,
+.thumb {
+    line-height: 0;
+    display: inline-block;
+    border: solid 4px #fff;
+    -webkit-box-shadow: 0 0 0 1px #ddd;
+    box-shadow: 0 0 0 1px #ddd
+}
+
+.imageblock.left,
+.imageblock[style*="float: left"] {
+    margin: .25em .625em 1.25em 0
+}
+
+.imageblock.right,
+.imageblock[style*="float: right"] {
+    margin: .25em 0 1.25em .625em
+}
+
+.imageblock>.title {
+    margin-bottom: 0;
+    text-align: center
+}
+
+.imageblock.th,
+.imageblock.thumb {
+    border-width: 6px
+}
+
+.imageblock.th>.title,
+.imageblock.thumb>.title {
+    padding: 0 .125em
+}
+
+.image.left,
+.image.right {
+    margin-top: .25em;
+    margin-bottom: .25em;
+    display: inline-block;
+    line-height: 0
+}
+
+.image.left {
+    margin-right: .625em
+}
+
+.image.right {
+    margin-left: .625em
+}
+
+a.image {
+    text-decoration: none;
+    display: inline-block
+}
+
+a.image object {
+    pointer-events: none
+}
+
+sup.footnote,
+sup.footnoteref {
+    font-size: .875em;
+    position: static;
+    vertical-align: super
+}
+
+sup.footnote a,
+sup.footnoteref a {
+    text-decoration: none
+}
+
+sup.footnote a:active,
+sup.footnoteref a:active {
+    text-decoration: underline
+}
+
+#footnotes {
+    padding-top: .75em;
+    padding-bottom: .75em;
+    margin-bottom: .625em
+}
+
+#footnotes hr {
+    width: 20%;
+    min-width: 6.25em;
+    margin: -.25em 0 .75em 0;
+    border-width: 1px 0 0 0
+}
+
+#footnotes .footnote {
+    padding: 0 .375em 0 .225em;
+    line-height: 1.3334;
+    font-size: .875em;
+    margin-left: 1.2em;
+    text-indent: -1.05em;
+    margin-bottom: .2em
+}
+
+#footnotes .footnote a:first-of-type {
+    font-weight: 700;
+    text-decoration: none
+}
+
+#footnotes .footnote:last-of-type {
+    margin-bottom: 0
+}
+
+#content #footnotes {
+    margin-top: -.625em;
+    margin-bottom: 0;
+    padding: .75em 0
+}
+
+.gist .file-data>table {
+    border: 0;
+    background: #fff;
+    width: 100%;
+    margin-bottom: 0
+}
+
+.gist .file-data>table td.line-data {
+    width: 99%
+}
+
+div.unbreakable {
+    page-break-inside: avoid
+}
+
+.big {
+    font-size: larger
+}
+
+.small {
+    font-size: smaller
+}
+
+.x-small {
+    font-size: x-small
+}
+
+.xx-small {
+    font-size: xx-small
+}
+
+.x-large {
+    font-size: x-large
+}
+
+.xx-large {
+    font-size: xx-large
+}
+
+.underline {
+    text-decoration: underline
+}
+
+.overline {
+    text-decoration: overline
+}
+
+.line-through {
+    text-decoration: line-through
+}
+
+.aqua {
+    color: #00bfbf
+}
+
+.aqua-background {
+    background-color: #00fafa
+}
+
+.black {
+    color: #000
+}
+
+.black-background {
+    background-color: #000
+}
+
+.blue {
+    color: #0000bf
+}
+
+.blue-background {
+    background-color: #0000fa
+}
+
+.fuchsia {
+    color: #bf00bf
+}
+
+.fuchsia-background {
+    background-color: #fa00fa
+}
+
+.gray {
+    color: #606060
+}
+
+.gray-background {
+    background-color: #7d7d7d
+}
+
+.green {
+    color: #006000
+}
+
+.green-background {
+    background-color: #007d00
+}
+
+.lime {
+    color: #00bf00
+}
+
+.lime-background {
+    background-color: #00fa00
+}
+
+.maroon {
+    color: #600000
+}
+
+.maroon-background {
+    background-color: #7d0000
+}
+
+.navy {
+    color: #000060
+}
+
+.navy-background {
+    background-color: #00007d
+}
+
+.olive {
+    color: #606000
+}
+
+.olive-background {
+    background-color: #7d7d00
+}
+
+.purple {
+    color: #600060
+}
+
+.purple-background {
+    background-color: #7d007d
+}
+
+.red {
+    color: #bf0000
+}
+
+.red-background {
+    background-color: #fa0000
+}
+
+.silver {
+    color: #909090
+}
+
+.silver-background {
+    background-color: #bcbcbc
+}
+
+.teal {
+    color: #006060
+}
+
+.teal-background {
+    background-color: #007d7d
+}
+
+.white {
+    color: #bfbfbf
+}
+
+.white-background {
+    background-color: #fafafa
+}
+
+.yellow {
+    color: #bfbf00
+}
+
+.yellow-background {
+    background-color: #fafa00
+}
+
+span.icon>.fa {
+    cursor: default
+}
+
+.admonitionblock td.icon [class^="fa icon-"] {
+    font-size: 2.5em;
+    text-shadow: 1px 1px 2px rgba(0, 0, 0, .5);
+    cursor: default
+}
+
+.admonitionblock td.icon .icon-note:before {
+    content: "\f05a";
+    color: #207c98
+}
+
+.admonitionblock td.icon .icon-tip:before {
+    content: "\f0eb";
+    text-shadow: 1px 1px 2px rgba(155, 155, 0, .8);
+    color: #111
+}
+
+.admonitionblock td.icon .icon-warning:before {
+    content: "\f071";
+    color: #bf6900
+}
+
+.admonitionblock td.icon .icon-caution:before {
+    content: "\f06d";
+    color: #bf3400
+}
+
+.admonitionblock td.icon .icon-important:before {
+    content: "\f06a";
+    color: #bf0000
+}
+
+.conum[data-value] {
+    display: inline-block;
+    color: #fff!important;
+    background-color: #222;
+    -webkit-border-radius: 100px;
+    border-radius: 100px;
+    text-align: center;
+    font-size: .75em;
+    width: 1.67em;
+    height: 1.67em;
+    line-height: 1.67em;
+    font-family: "Open Sans", "DejaVu Sans", sans-serif;
+    font-style: normal;
+    font-weight: 700
+}
+
+.conum[data-value] * {
+    color: #fff!important
+}
+
+.conum[data-value]+b {
+    display: none
+}
+
+.conum[data-value]:after {
+    content: attr(data-value)
+}
+
+pre .conum[data-value] {
+    position: relative;
+    top: -.125em
+}
+
+b.conum * {
+    color: inherit!important
+}
+
+.conum:not([data-value]):empty {
+    display: none
+}
+
+.listingblock pre,
+.literalblock pre {
+    background: #eee
+}
+
+div#remarks.ulist {
+    max-width: 70%
+}
+
+@media only screen and (max-width:800px) {
+    a#bottomright {
+        visibility: hidden
+    }
+    .sectionbody.paragraph {
+        max-width: 100%
+    }
+    #preamble>.sectionbody>.paragraph:first-of-type p,
+    .paragraph.lead>p {
+        max-width: 100%
+    }
+}
+
+#div.paragraph.faq-intro {
+    max-width: 66.66%
+}
+
+#menu {
+    display: none
+}
+
+div.slicknav_menu {
+    padding-top: 5px;
+    padding-right: 15px;
+    margin-left: 200px;
+    text-align: right;
+    display: none;
+    right: 10px;
+    font-size: 1rem;
+    color: #fff;
+    padding-bottom: 2rem;
+    background: url(logo.png);
+    background-position: 100px 0;
+    background-repeat: no-repeat
+}
+
+span.slicknav_menutxt {
+    margin-right: -20px;
+    color: #fff
+}
+
+div.slicknav_menu a.scroll:first-of-type {
+    color: #f7d425;
+    font-size: 120%;
+    font-weight: 600
+}
+
+div.slicknav_menu ul li a {
+    color: #fff
+}
+
+div.slicknav_menu ul li a:hover {
+    color: #f7d425
+}
+
+div.slicknav_menu a:hover {
+    color: #f7d425
+}
+
+div.slicknav_menu a:visited {
+    color: #fff
+}
+
+div.slicknav_menu a {
+    color: #fff
+}
+
+a.slicknav_btn {
+    padding: 1rem
+}
+
+li.slicknav_parent.slicknav_open {
+    color: #fff
+}
+
+li.slicknav_parent.slicknav_open {
+    color: #fff
+}
+
+.banner {
+    height: 1rem;
+    padding-right: 2rem;
+    max-height: 1rem;
+    max-width: 50%;
+    vertical-align: middle
+}
+
+@media (max-width:800px) {
+    .banner {
+        flex-basis: 66.66%;
+        max-width: 25%;
+        margin: 1rem
+    }
+}
+
+#menubar ul {
+    margin: 0;
+    padding: 0;
+    white-space: nowrap;
+    padding-left: 10px;
+    padding-right: 10px;
+    line-height: 1.2rem
+}
+
+#menubar li {
+    margin: 0;
+    padding: 0
+}
+
+#menubar a {
+    margin: 0;
+    padding-left: 2.5rem;
+}
+
+#menubar ul {
+    list-style: none
+}
+
+#menubar a {
+    text-decoration: none
+}
+
+#menubar li {
+    margin-left: 0
+}
+
+#menubar {
+    height: 50px;
+    max-width: 1280px;
+    position: relative;
+    margin-left: 0px;
+    color: #fff;
+    font-size: 1.9rem;
+    border-bottom: #595959;
+    border-bottom: 2px solid #ddd
+}
+
+#menubar img {
+    padding-left: 45px;
+    margin-top: 15px;
+    padding-top: .2rem
+}
+
+#menubar>ul>li {
+    display: inline-block;
+    margin: .2rem;
+    position: relative;
+    z-index: 10000;
+    flex-basis: 66.666%;
+    font-weight: 700
+
+
+}
+
+@media only screen and (max-width:768px) {
+    body.toc2.toc-right #tocbutton {
+        visibility: hidden
+    }
+    #toc.toc2 {
+        display: none
+    }
+    #content,
+    #footer,
+    #footnotes,
+    #header {
+        margin-left: 0;
+        left: 0
+    }
+    body.toc2 {
+        left: 0
+    }
+}
+
+#logo {
+    margin-top: -55px;
+    left: 5px;
+    top: 10px;
+    position: relative;
+    overflow: hidden
+}
+
+#menubar>ul>li::after {
+    content: " · ";
+    position: relative;
+    top: 3px;
+    padding-left: 3px;
+    font-weight: 400
+}
+
+#menubar>ul>li:last-of-type::after {
+    content: none
+}
+
+#menubar>ul>li>a {
+    font-size: 1.2rem;
+    line-height: 50px;
+    font-weight: 400;
+    webkit-transition: color .15s;
+    -moz-transition: color .15s;
+    -o-transition: color .15s;
+    transition: color .15s;
+    white-space: nowrap;
+    -webkit-font-smoothing: auto;
+    letter-spacing: -.01em;
+    text-align: right
+}
+
+#menubar>ul {
+    margin-right: 12px;
+    margin-top: 10px
+}
+
+#menubar>ul>li>a:hover {
+    color: #f7d425
+}
+
+body.home li.home,
+body.tech li.tech {
+    font-weight: 700
+}
+
+#menubar>ul>li>ul {
+    opacity: 0;
+    visibility: hidden;
+    padding: 18px 0 20px 0;
+    background-color: #fff;
+    text-align: left;
+    position: absolute;
+    top: 55px;
+    left: 50%;
+    margin-left: -90px;
+    -webkit-transition: all .3s .1s;
+    -moz-transition: all .3s .1s;
+    -o-transition: all .3s .1s;
+    transition: all .3s .1s;
+    -webkit-border-radius: 5px;
+    -moz-border-radius: 5px;
+    border-radius: 5px;
+    -webkit-box-shadow: 0 1px 3px rgba(0, 0, 0, .4);
+    -moz-box-shadow: 0 1px 3px rgba(0, 0, 0, .4);
+    box-shadow: 0 1px 3px rgba(0, 0, 0, .4)
+}
+
+#menubar>li li {
+    width: 100%
+}
+
+#menubar>ul>li:hover>ul {
+    opacity: 1;
+    top: 65px;
+    visibility: visible
+}
+
+#menubar>ul>li>ul:before {
+    content: '';
+    display: block;
+    border-color: transparent transparent #fff transparent;
+    border-style: solid;
+    border-width: 10px;
+    position: absolute;
+    top: -20px;
+    left: 10%;
+    margin-left: -10px
+}
+
+#menubar>ul ul>li {
+    position: relative
+
+}
+
+#menubar ul ul a {
+    color: #323232;
+    font-family: ITC Officina Serif W01, sans-serif, Verdana, 'Lucida Grande';
+    font-size: 17px;
+    background-color: #fff;
+    padding: 5px 8px 7px 16px;
+    display: block;
+    -webkit-transition: background-color .1s;
+    -moz-transition: background-color .1s;
+    -o-transition: background-color .1s;
+    transition: background-color .1s
+}
+
+#menubar ul ul a:hover {
+    background-color: #244d82;
+    color: #f7d425
+}
+
+#menubar ul ul ul {
+    visibility: hidden;
+    opacity: 0;
+    position: absolute;
+    top: -16px;
+    left: 206px;
+    padding: 16px 0 20px 0;
+    background-color: #527aa3;
+    text-align: left;
+    width: 160px;
+    -webkit-transition: all .3s;
+    -moz-transition: all .3s;
+    -o-transition: all .3s;
+    transition: all .3s;
+    -webkit-border-radius: 5px;
+    -moz-border-radius: 5px;
+    border-radius: 5px;
+    -webkit-box-shadow: 0 1px 3px rgba(0, 0, 0, .4);
+    -moz-box-shadow: 0 1px 3px rgba(0, 0, 0, .4);
+    box-shadow: 0 1px 3px rgba(0, 0, 0, .4)
+}
+
+#menubar ul ul>li:hover>ul {
+    opacity: 1;
+    left: 196px;
+    visibility: visible
+}
+
+#menubar ul ul a:hover {
+    background-color: #244d82;
+    color: #f7d425
+}
+
+a.back-to-top {
+    display: none;
+    width: 25px;
+    height: 25px;
+    text-indent: -9999px;
+    position: fixed;
+    z-index: 999;
+    right: 20px;
+    bottom: 20px;
+    background: #2ba6cb url(../images/up-arrow.png) no-repeat center 43%;
+    -webkit-border-radius: 30px;
+    -moz-border-radius: 30px;
+    border-radius: 30px
+}
+
+a:hover.back-to-top {
+    background-color: #f7d425
+}
+
+#tocbutton {
+    visibility: hidden;
+    outline: 0
+}
+
+#tocbuttonbars.fa.fa-bars {
+    z-index: 1000;
+    right: 0
+}
+
+#tocbutton:hover {
+    background: url(yellowbars.png) no-repeat center 50%
+}
+
+body.toc2.toc-right a.back-to-top {
+    width: 25px;
+    height: 25px;
+    text-indent: -9999px;
+    position: fixed;
+    z-index: 1001;
+    right: 90px;
+    bottom: 20px;
+    background: #2ba6cb url(up-arrow.png) no-repeat center 43%;
+    -webkit-border-radius: 30px;
+    -moz-border-radius: 30px;
+    border-radius: 30px
+}
+
+body.toc2.toc-right #tocbutton {
+    visibility: visible;
+    width: 25px;
+    height: 25px;
+    text-indent: -9999px;
+    position: fixed;
+    z-index: 998;
+    border: none;
+    right: 25px;
+    top: 5px;
+    background: url(yellowbars.png) no-repeat center 50%
+}
+
+body.toc2.toc-left #tocbutton {
+    visibility: visible;
+    width: 25px;
+    height: 25px;
+    text-indent: -9999px;
+    position: fixed;
+    z-index: 998;
+    border: none;
+    left: 25px;
+    top: 25px;
+    background: url(bars-blue.png) no-repeat center 50%
+}
+
+body.toc2.toc-right #tocbutton:hover {
+    background-color: #e3f2ff;
+    background: url(yellowbars.png) no-repeat center 50%
+}
+
+body.toc2.toc-right a:hover.back-to-top {
+    background-color: #f7d425
+}
+
+@media only screen and (max-width:1535px) {
+    body.toc2.toc-right #tocbutton {
+        background: url(yellowbars.png) no-repeat center 50%;
+        left: 97%;
+        z-index: 100000
+    }
+}
+
+@media only screen and (max-width:768px) {
+    body.toc2.toc-left #tocbutton {
+        visibility: hidden
+    }
+    #toc.toc2 {
+        width: 100%;
+        left: 0
+    }
+    #content,
+    #footer,
+    #footnotes,
+    #header {
+        margin-left: 0;
+        margin-right: 50px
+    }
+}
+
+@media only screen and (max-width:1462px) {
+    a.back-to-top {
+        left: 90%
+    }
+}
+
+div.openblock.definition {
+    border: 1px solid #aaa;
+    padding: .5em;
+    margin-bottom: 1rem;
+    background-color: #f0f8ff;
+    border-radius: 10px;
+    padding: 1rem
+}
+
+.requirement {
+    border: 1px solid #aaa;
+    padding: .5em;
+    margin-bottom: 1rem;
+    background-color: #f5f5f5;
+    border-radius: 10px;
+    padding: 1rem;
+    padding-bottom: 30px
+}
+
+.bibliography .content .paragraph p:first-child::before {
+    color: #777;
+    content: "[" attr(id) "] "
+}
+
+.bibliography .content .paragraph {
+    padding-left: 6em;
+    text-indent: -6em
+}
+
+.todo {
+    color: #dc143c;
+    border: #dc143c;
+    border-width: 2px;
+    border-style: dotted;
+    border-radius: 15px;
+    padding: 12px;
+    background-color: #fff8dc;
+    margin-bottom: 15px
+}
+
+.hold {
+    color: #ff8c00;
+    border: #ff8c00;
+    border-width: 2px;
+    border-style: dotted;
+    border-radius: 15px;
+    padding: 12px;
+    background-color: #f5f5f5;
+    margin-bottom: 15px
+}
+
+.hold::before {
+    content: "ON HOLD"
+}
+
+@media print {
+    @page {
+        margin: 1cm .75cm
+    }
+    * {
+        -webkit-box-shadow: none!important;
+        box-shadow: none!important;
+        text-shadow: none!important
+    }
+    a {
+        color: inherit!important;
+        text-decoration: underline!important
+    }
+    a.bare,
+    a[href^="#"],
+    a[href^="mailto:"] {
+        text-decoration: none!important
+    }
+    abbr[title]:after {
+        content: " (" attr(title) ")"
+    }
+    blockquote,
+    img,
+    object,
+    pre,
+    svg,
+    tr {
+        page-break-inside: avoid
+    }
+    thead {
+        display: table-header-group
+    }
+    svg {
+        max-width: 90%
+    }
+    blockquote,
+    body,
+    dt,
+    p,
+    td.content {
+        font-size: 70%;
+        orphans: 3;
+        widows: 3
+    }
+    #toctitle,
+    .sidebarblock>.content>.title,
+    h2,
+    h3 {
+        page-break-after: avoid
+    }
+    #toc,
+    .exampleblock>.content,
+    .sidebarblock {
+        background: 0 0!important
+    }
+    #toc {
+        border-bottom: 1px solid #ddddd8!important;
+        padding-bottom: 0!important
+    }
+    .sect1 {
+        padding-bottom: 0!important
+    }
+    .sect1+.sect1 {
+        border: 0!important
+    }
+    #header>h1:first-child {
+        margin-top: 1.25rem
+    }
+    body.toc2 {
+        left: -30px;
+        max-width: 100%
+    }
+    #menubar,
+    #tocbutton,
+    body.toc2.toc-left #toc.toc2,
+    div.social {
+        display: none
+    }
+    .definition,
+    .exampleblock,
+    .hold,
+    .listingblock,
+    .requirement,
+    .todo,
+    table {
+        page-break-inside: avoid
+    }
+    body.book #header {
+        text-align: center
+    }
+    body.book #header>h1:first-child {
+        border: 0!important;
+        margin: 2.5em 0 1em 0
+    }
+    body.book #header .details {
+        border: 0!important;
+        display: block;
+        padding: 0!important
+    }
+    body.book #header .details span:first-child {
+        margin-left: 0!important
+    }
+    body.book #header .details br {
+        display: block
+    }
+    body.book #header .details br+span:before {
+        content: none!important
+    }
+    body.book #toc {
+        border: 0!important;
+        text-align: left!important;
+        padding: 0!important;
+        margin: 0!important
+    }
+    body.book #preamble,
+    body.book #toc,
+    body.book .sect1>h2,
+    body.book h1.sect0 {
+        page-break-before: always
+    }
+    #footer {
+        background: 0 0!important;
+        padding: 0 .9375em
+    }
+    #footer-text {
+        color: rgba(0, 0, 0, .6)!important;
+        font-size: .9em
+    }
+    .hide-on-print {
+        display: none!important
+    }
+    .print-only {
+        display: block!important
+    }
+    .hide-for-print {
+        display: none!important
+    }
+    .show-for-print {
+        display: inherit!important
+    }
+}
+
+.reqlinks,
+.reqlinks a,
+.reqlinks:hover {
+    font-size: 13px;
+    font-weight: 400
+}
+
+.reqlinks {
+    color: silver
+}
+
+.reqitem,
+.reqitem code {
+    list-style-type: none;
+    line-height: 1.2;
+    font-size: smaller
+}
+
+#links {
+    position: relative
+}
+
+.treeview,
+.treeview ul {
+    list-style-type: none;
+    overflow: hidden
+}
+
+.treeview li {
+    text-indent: 10%;
+    margin-top: 0;
+    padding: .2em 0 0 0;
+    line-height: 20px;
+    background-repeat: no-repeat;
+    background-size: 16px 16px;
+    background-position-y: 4px
+}
+
+#toclist>li>ul>li {
+    font-size: 90%
+}
+
+#iconTree li {
+    font-weight: 700;
+    line-height: 15px;
+    font-size: 90%;
+    background-size: 16px 16px
+}
+
+.treeview li.contains-items {
+    font-weight: 700;
+    background-image: url(expand.png);
+    background-size: 16px 16px
+}
+
+.treeview li.items-expanded {
+    font-weight: 400;
+    background-image: url(collapse.png);
+    background-size: 16px 16px
+}
+
+.items-expanded>a::first-of-type {
+    font-weight: 700
+}
+
+.treview-dotted-lines li {
+    margin-top: .4em!important
+}
+
+.treview-dotted-lines li.items-expanded li {
+    font-weight: 700;
+    border-left: 1px dotted #444;
+    border-bottom: 1px dotted #444;
+    width: 60%
+}
+
+.treeview>li:hover {
+    cursor: pointer
+}
+
+.treeview span.has-node-icon {
+    text-indent: 2%;
+    margin-top: .2em;
+    padding: .15em 0 .5em 1em;
+    line-height: 22px;
+    background-repeat: no-repeat;
+    background-size: 24px 24px
+}
+
+.treeview span {
+    padding: 5px
+}
+
+.treeview span:not(.has-node-icon):hover {
+    background-color: rgba(246, 246, 246, .7)
+}
+
+body.toc2.toc-left #collapsetoc {
+    outline: 0;
+    display: none;
+    width: 25px;
+    height: 25px;
+    text-indent: -9999px;
+    position: fixed;
+    z-index: 998;
+    border: none;
+    left: 25px;
+    top: 55px;
+    background: url(arrow-down.png) no-repeat center 50%
+}
+
+body.toc2.toc-left #collapsetoc.inactive {
+    background-image: url(arrow-right.png)
+}
+
+.active {
+    border-right: 3px solid #2ba6cb;
+    color: #000;
+    font-weight: 700
+}
+
+.found {
+    color: #000;
+    font-weight: 700
+}
+
+#toc {
+    margin-top: 0
+}
+
+#toc>ul {
+    margin-left: 0;
+    padding-left: 0
+}
+
+#toc ul.sectlevel0>li>a {
+    font-style: italic
+}
+
+#toc ul.sectlevel0 ul.sectlevel1 {
+    margin: 0 0
+}
+
+#toc ul {
+    font-family: "Helvetica Neue", Helvetica, Helvetica, Arial, sans-serif;
+    list-style-type: none
+}
+
+#toc a {
+    color: #595959
+}
+
+#toc a:hover {
+    color: #000
+}
+
+#toc a:active {
+    text-decoration: underline
+}
+
+#pagesearch {
+    background-image: url(searchicon.png);
+    background-position: 5px 5px;
+    background-repeat: no-repeat;
+    width: 100%;
+    font-size: 16px;
+    padding: 6px 10px 6px 40px;
+    border: 1px solid #ddd;
+    margin-bottom: 12px
+}
+
+#clear {
+    position: absolute;
+    right: 10px;
+    top: 72px;
+    bottom: 0;
+    height: 14px;
+    font-size: 14px;
+    cursor: pointer;
+    color: #ccc
+}
\ No newline at end of file
diff --git a/design/styles/foundation.min.css b/design/styles/foundation.min.css
new file mode 100644
index 0000000..a45c129
--- /dev/null
+++ b/design/styles/foundation.min.css
@@ -0,0 +1 @@
+img,legend{border:0}body,figure{margin:0}body,table{background:#fff}#content:after,#footer:after,#footnotes:after,#header:after,.clearfix:after,.float-group:after,hr{clear:both}#toc,b.button:after,b.button:before,body,kbd,sub,sup{position:relative}#toc a,.vevent abbr,a,div.social>ul li{text-decoration:none}article,aside,details,figcaption,figure,footer,header,hgroup,main,nav,section,summary{display:block}audio,canvas,video{display:inline-block}audio:not([controls]){display:none;height:0}[hidden],template{display:none}script{display:none !important}html{font-family:sans-serif;-ms-text-size-adjust:100%;-webkit-text-size-adjust:100%}a:focus{outline:dotted thin}a:active,a:hover{outline:0}abbr[title]{border-bottom:1px dotted}b,strong{font-weight:700}dfn{font-style:italic}hr{-moz-box-sizing:content-box;box-sizing:content-box}mark{background:#ff0;color:#000}code,kbd,pre,samp{font-family:monospace, serif;font-size:1em}pre{white-space:pre-wrap}q{quotes:"\201C" "\201D" "\2018" "\2019"}sub,sup{font-size:75%;line-height:0;vertical-align:baseline}sup{top:-.5em}sub{bottom:-.25em}svg:not(:root){overflow:hidden}fieldset{border:1px solid silver;margin:0 2px;padding:.35em .625em .75em}legend{padding:0}button,input,select,textarea{font-family:inherit;font-size:100%;margin:0}button,input{line-height:normal}button,select{text-transform:none}button,html input[type=button],input[type=reset],input[type=submit]{-webkit-appearance:button;cursor:pointer}button[disabled],html input[disabled]{cursor:default}input[type=checkbox],input[type=radio]{box-sizing:border-box;padding:0}input[type=search]{-webkit-appearance:textfield;-moz-box-sizing:content-box;-webkit-box-sizing:content-box;box-sizing:content-box}input[type=search]::-webkit-search-cancel-button,input[type=search]::-webkit-search-decoration{-webkit-appearance:none}button::-moz-focus-inner,input::-moz-focus-inner{border:0;padding:0}textarea{overflow:auto;vertical-align:top;height:auto;min-height:50px}meta.foundation-mq-small{font-family:"only screen and (min-width: 500px)";width:500px}meta.foundation-mq-medium{font-family:"only screen and (min-width:1280px)";width:1280px}meta.foundation-mq-large{font-family:"only screen and (min-width:1440px)";width:1440px}.spread,select{width:100%}*,:after,:before{-moz-box-sizing:border-box;-webkit-box-sizing:border-box;box-sizing:border-box}body,html{font-size:100%}body{color:#595959;padding:0;font-family:"Helvetica Neue", Helvetica, Helvetica, Arial, sans-serif;font-weight:400;font-style:normal;line-height:1;cursor:auto max-width: 1280px;tab-size:4}a:hover{cursor:pointer}embed,img,object{max-width:100%;height:auto}embed,object{height:100%}#map_canvas embed,#map_canvas img,#map_canvas object,.map_canvas embed,.map_canvas img,.map_canvas object{max-width:none !important}.left{float:left !important}.right{float:right !important}.text-left{text-align:left !important}.text-right{text-align:right !important}.text-center{text-align:center !important}.text-justify{text-align:justify !important}.hide{display:none}img,object,svg{display:inline-block;vertical-align:middle}.antialiased,body{-webkit-font-smoothing:antialiased}img{-ms-interpolation-mode:bicubic}.center{margin-left:auto;margin-right:auto}#preamble>.sectionbody>.paragraph:first-of-type p,.paragraph.lead>p,p.lead{font-size:1.21875em;line-height:1.6}.admonitionblock td.content>.title,.audioblock>.title,.dlist>.title,.exampleblock>.title,.hdlist>.title,.imageblock>.title,.listingblock>.title,.literalblock>.title,.olist>.title,.openblock>.title,.paragraph>.title,.qlist>.title,.quoteblock>.title,.stemblock>.title,.subheader,.ulist>.title,.verseblock>.title,.videoblock>.title,table.tableblock>.title{line-height:1.4;color:#6f6f6f;font-weight:300;margin-top:.2em;margin-bottom:.5em}#toctitle,.sidebarblock>.content>.title,blockquote,dd,div,dl,dt,form,h1,h2,h3,h4,h5,h6,li,ol,p,pre,td,th,ul{margin:0;padding:0;direction:ltr}a{background:0 0;color:#2ba6cb;line-height:inherit}a:focus,a:hover{color:#2795b6}a img{border:none}p{font-family:inherit;font-weight:400;font-size:1em;line-height:1.6;margin-bottom:1.25em;text-rendering:optimizeLegibility}#toctitle,.admonitionblock>table td.icon .title,.sidebarblock>.content>.title,h1,h2,h3,h4,h5,h6{font-family:"Helvetica Neue", Helvetica, Helvetica, Arial, sans-serif}.vcard .fn,.vevent .summary,.vevent abbr,code,dl dt{font-weight:700}p aside{font-size:.875em;line-height:1.35;font-style:italic}#toctitle,.sidebarblock>.content>.title,h1,h2,h3,h4,h5,h6{font-weight:700;font-style:normal;color:#595959;text-rendering:optimizeLegibility;margin-top:1em;margin-bottom:.5em}dl,dl dd,ol,ul{margin-bottom:1.25em}#toctitle small,.sidebarblock>.content>.title small,h1 small,h2 small,h3 small,h4 small,h5 small,h6 small{font-size:60%;color:#6f6f6f;line-height:0}b,em,i,small,strong{line-height:inherit}h1{font-size:2.125em}h2{font-size:1.6875em}#toctitle,.sidebarblock>.content>.title,h3{font-size:1.375em}h4,h5{font-size:1.125em}h6{font-size:1em}hr{border:solid #ddd;border-width:1px 0 0;margin:1.25em 0 1.1875em;height:0}em,i{font-style:italic}small{font-size:60%}dl,ol,ul,ul li ol,ul li ul{font-size:1em}code{font-family:Consolas, "Liberation Mono", Courier, monospace;color:#7f0a0c}dl,ol,ul{line-height:1.6;list-style-position:outside;font-family:inherit}ol,ol.no-bullet,ul,ul.no-bullet{margin-left:1.5em}ol li ol,ol li ul,ul li ol,ul li ul{margin-left:1.25em;margin-bottom:0}ul.circle li ul,ul.disc li ul,ul.square li ul{list-style:inherit}#menubar ul,ul.inline,ul.inline>li,ul.no-bullet{list-style:none}ul.square{list-style-type:square}ul.circle{list-style-type:circle}ul.disc{list-style-type:disc}dl dt{margin-bottom:.3125em}.vcard,blockquote{margin:0 0 1.25em}abbr,acronym{text-transform:uppercase;font-size:90%;color:#222;border-bottom:1px dotted #ddd;cursor:help}abbr{text-transform:none}blockquote{padding:.5625em 1.25em 0 1.1875em;border-left:1px solid #ddd}blockquote cite{display:block;font-size:.8125em;color:#555}blockquote cite:before{content:"\2014 \0020"}blockquote cite a,blockquote cite a:visited{color:#555}blockquote,blockquote p{line-height:1.6;color:#6f6f6f}.vcard{display:inline-block;border:1px solid #ddd;padding:.625em .75em}.vcard li{margin:0;display:block}.vcard .fn{font-size:.9375em}.vevent abbr{cursor:auto;border:none;padding:0 .0625em}@media only screen and (min-width:500px){#toctitle,.sidebarblock>.content>.title,h1,h2,h3,h4,h5,h6{line-height:1.4}h1{font-size:2.75em}h2{font-size:2.3125em}#toctitle,.sidebarblock>.content>.title,h3{font-size:1.6875em}h4{font-size:1.4375em}}table{border-collapse:collapse;border-spacing:0;margin-bottom:1.25em;border:1px solid #ddd}table tfoot,table thead{background:#f5f5f5;font-weight:600}table tfoot tr td,table tfoot tr th,table thead tr td,table thead tr th{padding:.5em .625em .625em;font-size:inherit;color:#222;text-align:left}table tr td,table tr th{padding:.5625em .625em;font-size:inherit;color:#595959}table tr.alt,table tr.even,table tr:nth-of-type(even){background:#f9f9f9}table tbody tr td,table tfoot tr td,table tfoot tr th,table thead tr th,table tr td{display:table-cell;line-height:1.4}#toctitle,.sidebarblock>.content>.title,h1,h2,h3,h4,h5,h6{line-height:1.4}.clearfix:after,.clearfix:before,.float-group:after,.float-group:before{content:" ";display:table}:not(pre)>code{font-size:inherit;font-style:normal !important;letter-spacing:0;padding:0;line-height:inherit}pre,pre>code{line-height:1.4;color:#000;font-family:monospace, serif;font-weight:400}.keyseq{color:#555}kbd{font-family:Consolas, "Liberation Mono", Courier, monospace;display:inline-block;color:#222;font-size:.65em;line-height:1.45;background-color:#f7f7f7;border:1px solid #ccc;-webkit-border-radius:3px;border-radius:3px;-webkit-box-shadow:0 1px 0 rgba(0, 0, 0, .2), 0 0 0 .1em #fff inset;box-shadow:0 1px 0 rgba(0, 0, 0, .2), 0 0 0 .1em #fff inset;margin:0 .15em;padding:.2em .5em;vertical-align:middle;top:-.1em;white-space:nowrap}table.pyhltable td,td.valign-top,th.valign-top{vertical-align:top}.keyseq kbd:first-child{margin-left:0}.keyseq kbd:last-child{margin-right:0}.menu,.menuseq{color:#090909}b.button:after,b.button:before{top:-1px;font-weight:400}b.button:before{content:"[";padding:0 3px 0 2px}b.button:after{content:"]";padding:0 2px 0 3px}#content,#footer,#footnotes,#header{max-width:1300px;margin-right:80px;margin-top:0;margin-bottom:0;position:relative;padding-left:0;padding-right:.9375em;left:40px}#content:after,#content:before,#footer:after,#footer:before,#footnotes:after,#footnotes:before,#header:after,#header:before{content:" ";display:table}#content{margin-top:1.25em;padding-right:0;margin-right:115px}#content:before{content:none}#header>h1:first-child{color:#595959;margin-top:2.25rem;margin-bottom:0}#header>h1:first-child+#toc{margin-top:8px;border-top:1px solid #ddd}#header>h1:only-child,body.toc2 #header>h1:nth-last-child(2){border-bottom:1px solid #ddd;padding-bottom:8px}#header .details{border-bottom:1px solid #ddd;line-height:1.45;padding-top:.25em;padding-bottom:.25em;padding-left:.25em;color:#555;display:-ms-flexbox;display:-webkit-flex;display:flex;-ms-flex-flow:row wrap;-webkit-flex-flow:row wrap;flex-flow:row wrap}#header .details span:first-child{margin-left:-.125em}#header .details span.email a{color:#6f6f6f}#header .details br{display:none}#header .details br+span:before{content:"\00a0\2013\00a0"}#header .details br+span.author:before{content:"\00a0\22c5\00a0";color:#6f6f6f}#header .details br+span#revremark:before{content:"\00a0|\00a0"}#header #revnumber{text-transform:capitalize}#header #revnumber:after{content:"\00a0"}#content>h1:first-child:not([class]){color:#000;border-bottom:1px solid #ddd;padding-bottom:8px;margin-top:0;padding-top:1rem;margin-bottom:1.25rem}#toc ul li:before,div#faq li:before,div#features-nav li:before,div.ulist li:before{content:"";color:#244d82}#toc{border-bottom:1px solid #ddd;padding-bottom:.5em;left:0}#toc li{line-height:1.3334;margin-top:0;padding-left:5px}#toc ul li:before{margin-left:-.75em;margin-right:.4em}div.ulist li:before{position:absolute;font-size:x-large;line-height:1rem;margin:.2rem 0 -.75em -.75em}#faq,#features-nav{margin-bottom:20px;z-index:1;padding-left:2rem;border-left:1px solid #d3d3d3}#toctitle{color:#595959;font-size:1.2em;padding-left:1em}#faq{position:relative;right:9.3rem;top:9rem;left:45rem}@media only screen and (max-width:945px){div#faq{display:none}}#faq h2{font-size:25px;font-weight:600;margin-top:-8rem}div#faq li:before,div#features-nav li:before{position:absolute;font-size:x-large;margin-left:-.75em;margin-bottom:-.75em;margin-right:0;line-height:1rem}#features-nav{right:1rem;top:2rem;position:absolute}@media only screen and (max-width:993px){#features-nav{display:none}}#features-nav h2{font-size:25px;font-weight:600;margin-top:-1rem}#features-nav li{margin-top:.3rem}@media only screen and (min-width:500px){#toctitle{padding-top:0;font-size:1.375em}body.toc2{padding-left:2em;padding-right:1em}#toc.toc2{margin-top:0 !important;background-color:#f2f2f2;position:fixed;width:260px;left:0;top:0;border-right:1px solid #ddd;border-top-width:0 !important;border-bottom-width:0 !important;z-index:1000;padding:1.25em .25em 0;height:100%;overflow:auto}#toc.toc2 #toctitle{margin-top:0;margin-bottom:.8rem;font-size:1.2em;padding-left:1em}#toc.toc2>ul{font-size:.9em;margin-bottom:0}#toc.toc2 ul ul{margin-left:6px}#toc.toc2 ul.sectlevel0 ul.sectlevel1{padding-left:10px;margin-top:.5em;margin-bottom:.5em}body.toc2.toc-right{padding-left:2em;padding-right:2em}body.toc2.toc-right #toc.toc2{border-right-width:0;border-left:1px solid #ddd;left:auto;right:-260px}}body.toc2.toc-left #toc.toc2{left:0}@media only screen and (min-width:1000px){#toc.toc2 #toctitle,#toctitle{font-size:1.375em}#content{max-width:1260px}body.toc2{padding-left:260px;padding-right:2em}#toctitle{padding-top:0}#toc.toc2{width:260px}#toc.toc2>ul{font-size:.95em}#toc.toc2 ul ul{padding-left:0}body.toc2.toc-right{padding-left:2em;padding-right:2em}}#content #toc{border-style:solid;border-width:1px;border-color:#d9d9d9;margin-bottom:1.25em;padding:1.25em;background:#f2f2f2;-webkit-border-radius:0;border-radius:0}#content #toc>:first-child{margin-top:0}#footer,div.social{margin-top:2rem;color:#fff}#content #toc>:last-child{margin-bottom:0}#footer{padding:1.25em 1.25em 0}div.social{padding:1.25em 1.25em 0 30px}.exampleblock>.content>:first-child,.sidebarblock>:first-child{margin-top:0}div.social>ul li{color:#fff;line-height:1.44;font-size:1.2em;font-weight:800;font-style:bold;position:relative;list-style:none;display:inline}#bottomright{float:right}#footer-text{color:#ddd;line-height:1.44}.sect1{padding-bottom:.625em}@media only screen and (min-width:500px){.sect1{padding-bottom:1.25em}}.sect1+.sect1{border-top:1px solid #ddd}#content h1>a.anchor,#toctitle>a.anchor,.sidebarblock>.content>.title>a.anchor,h2>a.anchor,h3>a.anchor,h4>a.anchor,h5>a.anchor,h6>a.anchor{position:absolute;z-index:1001;width:1.5ex;margin-left:-1.5ex;display:block;text-decoration:none !important;visibility:hidden;text-align:center;font-weight:400}a.image,sup.footnote a,sup.footnoteref a{text-decoration:none}#content h1>a.anchor:before,#toctitle>a.anchor:before,.sidebarblock>.content>.title>a.anchor:before,h2>a.anchor:before,h3>a.anchor:before,h4>a.anchor:before,h5>a.anchor:before,h6>a.anchor:before{content:"\00A7";font-size:.85em;display:block;padding-top:.1em}#content h1:hover>a.anchor,#content h1>a.anchor:hover,#toctitle:hover>a.anchor,#toctitle>a.anchor:hover,.sidebarblock>.content>.title:hover>a.anchor,.sidebarblock>.content>.title>a.anchor:hover,h2:hover>a.anchor,h2>a.anchor:hover,h3:hover>a.anchor,h3>a.anchor:hover,h4:hover>a.anchor,h4>a.anchor:hover,h5:hover>a.anchor,h5>a.anchor:hover,h6:hover>a.anchor,h6>a.anchor:hover{visibility:visible}#content h1>a.link,#toctitle>a.link,.sidebarblock>.content>.title>a.link,h2>a.link,h3>a.link,h4>a.link,h5>a.link,h6>a.link{color:#595959;text-decoration:none}#content h1>a.link:hover,#toctitle>a.link:hover,.sidebarblock>.content>.title>a.link:hover,h2>a.link:hover,h3>a.link:hover,h4>a.link:hover,h5>a.link:hover,h6>a.link:hover{color:#151515}.audioblock,.imageblock,.listingblock,.literalblock,.stemblock,.videoblock{margin-bottom:1.25em}.admonitionblock td.content>.title,.audioblock>.title,.dlist>.title,.exampleblock>.title,.hdlist>.title,.imageblock>.title,.listingblock>.title,.literalblock>.title,.olist>.title,.openblock>.title,.paragraph>.title,.qlist>.title,.quoteblock>.title,.stemblock>.title,.ulist>.title,.verseblock>.title,.videoblock>.title,table.tableblock>.title{text-rendering:optimizeLegibility;text-align:left}table.tableblock>caption.title{white-space:nowrap;overflow:visible;max-width:0}#preamble>.sectionbody>.paragraph:first-of-type p,.paragraph.lead>p{color:#000}table.tableblock #preamble>.sectionbody>.paragraph:first-of-type p{font-size:inherit}.admonitionblock>table{border-collapse:separate;border:0;background:0 0;width:100%}.admonitionblock>table td.icon{text-align:center;width:80px}.admonitionblock>table td.icon img{max-width:none}.admonitionblock>table td.icon .title{font-weight:700;text-transform:uppercase}.admonitionblock>table td.content{padding-left:1.125em;padding-right:1.25em;border-left:1px solid #ddd;color:#555}.admonitionblock>table td.content>:last-child>:last-child{margin-bottom:0}.exampleblock>.content{border-style:solid;border-width:1px;border-color:#e6e6e6;margin-bottom:1.25em;padding:1.25em;background:#fff;-webkit-border-radius:0;border-radius:0}.exampleblock>.content .olist>ol>li:last-child>:last-child,.exampleblock>.content .qlist>ol>li:last-child>:last-child,.exampleblock>.content .ulist>ul>li:last-child>:last-child,.exampleblock>.content>:last-child,.exampleblock>.content>:last-child>:last-child,.sidebarblock>.content .olist>ol>li:last-child>:last-child,.sidebarblock>.content .qlist>ol>li:last-child>:last-child,.sidebarblock>.content .ulist>ul>li:last-child>:last-child,.sidebarblock>.content>:last-child>:last-child,.sidebarblock>:last-child,table.pyhltable{margin-bottom:0}.sidebarblock{position:absolute;border-style:solid;width:90px;border-width:1px;border-color:#d9d9d9;right:-90px;padding:.1rem;background:#f2f2f2;-webkit-border-radius:0;text-align:left;border-radius:5px}.sidebarblock>.content>.title{color:#6999d6;margin-top:0}.listingblock pre.CodeRay,.listingblock pre.prettyprint,.listingblock pre:not(.highlight),.listingblock pre[class=highlight],.listingblock pre[class^="highlight "],.literalblock pre{background:#eee}.sidebarblock .listingblock pre.CodeRay,.sidebarblock .listingblock pre.prettyprint,.sidebarblock .listingblock pre:not(.highlight),.sidebarblock .listingblock pre[class=highlight],.sidebarblock .listingblock pre[class^="highlight "],.sidebarblock .literalblock pre{background:#f2f1f1}.listingblock pre,.listingblock pre[class],.literalblock pre,.literalblock pre[class]{border:1px solid #ccc;-webkit-border-radius:0;border-radius:0;word-wrap:break-word;padding:.8em .8em .65em;font-size:.8125em}.listingblock pre.nowrap,.listingblock pre[class].nowrap,.literalblock pre.nowrap,.literalblock pre[class].nowrap{overflow-x:auto;white-space:pre;word-wrap:normal}#logo,ul.inline{overflow:hidden}@media only screen and (min-width:500px){.listingblock pre,.listingblock pre[class],.literalblock pre,.literalblock pre[class]{font-size:.90625em}}@media only screen and (min-width:1280px){.listingblock pre,.listingblock pre[class],.literalblock pre,.literalblock pre[class]{font-size:1em}}.literalblock.output pre{color:#eee;background-color:#000}.listingblock pre.highlightjs{padding:0}.listingblock pre.highlightjs>code{padding:.8em .8em .65em;-webkit-border-radius:0;border-radius:0}.listingblock>.content{position:relative}.listingblock.terminal pre .command:before{content:attr(data-prompt);padding-right:.5em;color:#999}.listingblock.terminal pre .command:not([data-prompt]):before{content:"$"}table.pyhltable{border-collapse:separate;border:0;background:0 0}table.pyhltable td{padding-top:0;padding-bottom:0;line-height:1.4}table.pyhltable td.code{padding-left:.75em;padding-right:0}pre.pygments .lineno,table.pyhltable td:not(.code){color:#999;padding-left:0;padding-right:.5em;border-right:1px solid #ddd}pre.pygments .lineno{display:inline-block;margin-right:.25em}table.pyhltable .linenodiv{background:0 0 !important;padding-right:0 !important}.quoteblock{margin:0 1em 1.25em 1.5em;display:table}.quoteblock .attribution br,.quoteblock .quoteblock blockquote:before,.verseblock .attribution br{display:none}.quoteblock>.title{margin-left:-1.5em;margin-bottom:.75em}.quoteblock blockquote,.quoteblock blockquote p{color:#6f6f6f;font-size:1.15rem;line-height:1.75;word-spacing:.1em;letter-spacing:0;font-style:italic;text-align:justify}.quoteblock blockquote{margin:0;padding:0;border:0}.quoteblock blockquote:before{content:"\201c";float:left;font-size:2.75em;font-weight:700;line-height:.6em;margin-left:-.6em;color:#6f6f6f;text-shadow:0 1px 2px rgba(0, 0, 0, .1)}.quoteblock blockquote>.paragraph:last-child p{margin-bottom:0}.quoteblock .attribution{margin-top:.5em;margin-right:.5ex;text-align:right}.quoteblock .quoteblock{margin-left:0;margin-right:0;padding:.5em 0;border-left:3px solid #555}.quoteblock .quoteblock blockquote{padding:0 0 0 .75em}.verseblock{margin:0 1em 1.25em}.verseblock pre{font-family:"Open Sans", "DejaVu Sans", sans;font-size:1.15rem;color:#6f6f6f;font-weight:300;text-rendering:optimizeLegibility}.verseblock pre strong{font-weight:400}.verseblock .attribution{margin-top:1.25rem;margin-left:.5ex}.quoteblock .attribution,.verseblock .attribution{font-size:.8125em;line-height:1.45;font-style:italic}.quoteblock .attribution cite,.verseblock .attribution cite{display:block;letter-spacing:-.025em;color:#555}.quoteblock.abstract{margin:0 0 1.25em;display:block}dl dd:last-child,dl dd:last-child>:last-child,table.tableblock td>.paragraph:last-child p>p:last-child,table.tableblock td>p:last-child,table.tableblock th>p:last-child{margin-bottom:0}.quoteblock.abstract blockquote,.quoteblock.abstract blockquote p{text-align:left;word-spacing:0}.quoteblock.abstract blockquote p:first-of-type:before,.quoteblock.abstract blockquote:before{display:none}table.tableblock{max-width:100%;border-collapse:separate}table.tableblock,td.tableblock,th.tableblock{border:0 solid #ddd}table.grid-all td.tableblock,table.grid-all th.tableblock{border-width:0 1px 1px 0}table.grid-all tfoot>tr>td.tableblock,table.grid-all tfoot>tr>th.tableblock{border-width:1px 1px 0 0}table.grid-cols td.tableblock,table.grid-cols th.tableblock{border-width:0 1px 0 0}table.grid-all *>tr>.tableblock:last-child,table.grid-cols *>tr>.tableblock:last-child{border-right-width:0}table.grid-rows td.tableblock,table.grid-rows th.tableblock{border-width:0 0 1px}table.grid-all tbody>tr:last-child>td.tableblock,table.grid-all tbody>tr:last-child>th.tableblock,table.grid-all thead:last-child>tr>th.tableblock,table.grid-rows tbody>tr:last-child>td.tableblock,table.grid-rows tbody>tr:last-child>th.tableblock,table.grid-rows thead:last-child>tr>th.tableblock{border-bottom-width:0}table.grid-rows tfoot>tr>td.tableblock,table.grid-rows tfoot>tr>th.tableblock{border-width:1px 0 0}table.frame-all{border-width:1px}table.frame-sides{border-width:0 1px}table.frame-topbot{border-width:1px 0}td.halign-left,th.halign-left{text-align:left}td.halign-right,th.halign-right{text-align:right}td.halign-center,th.halign-center{text-align:center}td.valign-bottom,th.valign-bottom{vertical-align:bottom}td.valign-middle,th.valign-middle{vertical-align:middle}table tfoot th,table thead th{font-weight:700}tbody tr th{display:table-cell;line-height:1.4;background:#f5f5f5}ul.inline>li,ul.inline>li>*{display:block}tbody tr th,tbody tr th p,tfoot tr th,tfoot tr th p{color:#222;font-weight:700}p.tableblock>code:only-child{background:0 0;padding:0}p.tableblock{font-size:1em}td>div.verse{white-space:pre}ol{margin-left:1.75em}ul li ol{margin-left:1.5em}dl dd{margin-left:1.125em}.olist .olist,.olist .ulist,.ulist .olist,.ulist .ulist,ol dd,ol>li p,ul dd,ul>li p{margin-bottom:.625em}ol.unnumbered,ul.checklist,ul.none,ul.unstyled{list-style-type:none}ol.unnumbered,ul.checklist,ul.unstyled{margin-left:.625em}ul.checklist li>p:first-child>.fa-check-square-o:first-child,ul.checklist li>p:first-child>.fa-square-o:first-child{width:1em;font-size:.85em}ul.checklist li>p:first-child>input[type=checkbox]:first-child{width:1em;position:relative;top:1px}ul.inline{margin:0 0 .625em -1.375em;padding:0}ul.inline>li{float:left;margin-left:1.375em}.conum[data-value],.th,.thumb,a.image{display:inline-block}.unstyled dl dt{font-weight:400;font-style:normal}ol.arabic{list-style-type:decimal}ol.decimal{list-style-type:decimal-leading-zero}ol.loweralpha{list-style-type:lower-alpha}ol.upperalpha{list-style-type:upper-alpha}ol.lowerroman{list-style-type:lower-roman}ol.upperroman{list-style-type:upper-roman}ol.lowergreek{list-style-type:lower-greek}.colist>table,.hdlist>table{border:0;background:0 0}.colist>table>tbody>tr,.hdlist>table>tbody>tr{background:0 0}td.hdlist1,td.hdlist2{vertical-align:top;padding:0 .625em}td.hdlist1{font-weight:700;padding-bottom:1.25em}.listingblock+.colist,.literalblock+.colist{margin-top:-.5em}.colist>table tr>td:first-of-type{padding:0 .75em;line-height:1}.colist>table tr>td:last-of-type{padding:.25em 0}.th,.thumb{line-height:0;border:4px solid #fff;-webkit-box-shadow:0 0 0 1px #ddd;box-shadow:0 0 0 1px #ddd}.imageblock.left,.imageblock[style*="float: left"]{margin:.25em .625em 1.25em 0}.imageblock.right,.imageblock[style*="float: right"]{margin:.25em 0 1.25em .625em}.imageblock>.title{margin-bottom:0}.imageblock.th,.imageblock.thumb{border-width:6px}.imageblock.th>.title,.imageblock.thumb>.title{padding:0 .125em}.image.left,.image.right{margin-top:.25em;margin-bottom:.25em;display:inline-block;line-height:0}.image.left{margin-right:.625em}.image.right{margin-left:.625em}a.image object{pointer-events:none}sup.footnote,sup.footnoteref{font-size:.875em;position:static;vertical-align:super}#logo,#menubar,#menubar>ul>li,#menubar>ul>li::after{position:relative}sup.footnote a:active,sup.footnoteref a:active{text-decoration:underline}#footnotes{padding-top:.75em;padding-bottom:.75em;margin-bottom:.625em}#footnotes hr{width:20%;min-width:6.25em;margin:-.25em 0 .75em;border-width:1px 0 0}#footnotes .footnote{padding:0 .375em .2em .225em;line-height:1.3334;font-size:.875em;margin-left:1.2em;text-indent:-1.05em;margin-bottom:.2em}#footnotes .footnote a:first-of-type{font-weight:700;text-decoration:none}#footnotes .footnote:last-of-type{margin-bottom:0}#content #footnotes{margin-top:-.625em;margin-bottom:0;padding:.75em 0}.gist .file-data>table{border:0;background:#fff;width:100%;margin-bottom:0}.gist .file-data>table td.line-data{width:99%}div.unbreakable{page-break-inside:avoid}.big{font-size:larger}.small{font-size:smaller}.x-small{font-size:x-small}.xx-small{font-size:xx-small}.x-large{font-size:x-large}.xx-large{font-size:xx-large}.underline{text-decoration:underline}.overline{text-decoration:overline}.line-through{text-decoration:line-through}.aqua{color:#00bfbf}.aqua-background{background-color:#00fafa}.black{color:#000}.black-background{background-color:#000}.blue{color:#0000bf}.blue-background{background-color:#0000fa}.fuchsia{color:#bf00bf}.fuchsia-background{background-color:#fa00fa}.gray{color:#606060}.gray-background{background-color:#7d7d7d}.green{color:#006000}.green-background{background-color:#007d00}.lime{color:#00bf00}.lime-background{background-color:#00fa00}.maroon{color:#600000}.maroon-background{background-color:#7d0000}.navy{color:#000060}.navy-background{background-color:#00007d}.olive{color:#606000}.olive-background{background-color:#7d7d00}.purple{color:#600060}.purple-background{background-color:#7d007d}.red{color:#bf0000}.red-background{background-color:#fa0000}.silver{color:#909090}.silver-background{background-color:#bcbcbc}.teal{color:#006060}.teal-background{background-color:#007d7d}.white{color:#bfbfbf}.white-background{background-color:#fafafa}.yellow{color:#bfbf00}.yellow-background{background-color:#fafa00}span.icon>.fa{cursor:default}.admonitionblock td.icon [class^="fa icon-"]{font-size:2.5em;text-shadow:1px 1px 2px rgba(0, 0, 0, .5);cursor:default}#clear,.treeview>li:hover{cursor:pointer}.admonitionblock td.icon .icon-note:before{content:"\f05a";color:#207c98}.admonitionblock td.icon .icon-tip:before{content:"\f0eb";text-shadow:1px 1px 2px rgba(155, 155, 0, .8);color:#111}.admonitionblock td.icon .icon-warning:before{content:"\f071";color:#bf6900}.admonitionblock td.icon .icon-caution:before{content:"\f06d";color:#bf3400}.admonitionblock td.icon .icon-important:before{content:"\f06a";color:#bf0000}.conum[data-value],.conum[data-value] *{color:#fff !important}.conum[data-value]{background-color:#222;-webkit-border-radius:100px;border-radius:100px;text-align:center;font-size:.75em;width:1.67em;height:1.67em;line-height:1.67em;font-family:"Open Sans", "DejaVu Sans", sans-serif;font-style:normal;font-weight:700}#menu,.conum:not([data-value]):empty,.conum[data-value]+b{display:none}.conum[data-value]:after{content:attr(data-value)}pre .conum[data-value]{position:relative;top:-.125em}b.conum *{color:inherit !important}.listingblock pre,.literalblock pre{background:#eee}div#remarks.ulist{max-width:70%}@media only screen and (max-width:800px){a#bottomright{visibility:hidden}#preamble>.sectionbody>.paragraph:first-of-type p,.paragraph.lead>p,.sectionbody.paragraph{max-width:100%}}#div.paragraph.faq-intro{max-width:66.66%}div.slicknav_menu{padding-top:5px;padding-right:15px;margin-left:200px;text-align:right;display:none;right:10px;font-size:1rem;color:#fff;padding-bottom:2rem;background:url(logo.png) 100px 0 no-repeat}span.slicknav_menutxt{margin-right:-20px;color:#fff}div.slicknav_menu a.scroll:first-of-type{color:#F7D425;font-size:120%;font-weight:600}div.slicknav_menu ul li a{color:#fff}div.slicknav_menu a:hover,div.slicknav_menu ul li a:hover{color:#F7D425}div.slicknav_menu a,div.slicknav_menu a:visited,li.slicknav_parent.slicknav_open{color:#fff}a.slicknav_btn{padding:1rem}@media screen and (max-width:890px){div.slicknav_menu{display:block;color:#fff}#mobile-banner{display:block}}@media screen and (max-width:470px){div.slicknav_menu ul:first-of-type{margin-top:1.5rem}div.slicknav_menu ul li{color:#fff}div.slicknav_menu ul li:hover{color:#F7D425}}div.slicknav_menu li:last-of-type{padding-bottom:.7rem}.banner{height:1rem;padding-right:2rem;max-height:1rem;max-width:50%;vertical-align:middle}@media (max-width:800px){.banner{flex-basis:66.66%;max-width:25%;margin:1rem}}#menubar ul{margin:0;padding:0 10px;white-space:nowrap;line-height:1.2rem}#menubar a,#menubar li{margin:0;padding:0}#menubar a{text-decoration:none}#menubar li{margin-left:0}#menubar{height:90px;max-width:1280px;margin-left:50px;color:#fff;font-size:1.9rem;border-bottom:#595959;border-bottom:2px solid #ddd}#menubar img{padding-left:45px;margin-top:15px;padding-top:.2rem}#menubar>ul>li{display:inline-block;margin:.2rem;z-index:10000;flex-basis:66.666%;font-weight:700}@media only screen and (max-width:500px){#menubar,#menubar>ul>li{visibility:hidden;display:none}#toc.toc2{display:none}}@media only screen and (max-width:500px){body.toc2.toc-right #tocbutton{visibility:hidden}#content,#footer,#footnotes,#header{margin-left:0;left:0}body.toc2{padding-left:20px;left:0}}@media only screen and (max-width:500px){#menubar{display:none}}#logo{margin-top:-55px;left:5px;top:10px}#menubar>ul>li::after{content:" · ";top:3px;padding-left:3px;font-weight:400}#menubar>ul>li:last-of-type::after{content:none}#menubar>ul>li>a{font-size:1.2rem;line-height:50px;font-weight:400;webkit-transition:color .15s;margin-left:0;-moz-transition:color .15s;-o-transition:color .15s;transition:color .15s;white-space:nowrap;-webkit-font-smoothing:auto;letter-spacing:-.01em;text-align:right}#iconTree li,#toc>ul>li>a,body.home li.home,body.tech li.tech{font-weight:700}#menubar>ul{margin-right:12px;margin-top:1px}#menubar>ul>li>a:hover{color:#F7D425}#menubar>ul>li>ul{opacity:0;visibility:hidden;padding:18px 0 20px;background-color:#FFF;text-align:left;position:absolute;top:55px;left:50%;margin-left:-90px;-webkit-transition:all .3s .1s;-moz-transition:all .3s .1s;-o-transition:all .3s .1s;transition:all .3s .1s;-webkit-border-radius:5px;-moz-border-radius:5px;border-radius:5px;-webkit-box-shadow:0 1px 3px rgba(0, 0, 0, .4);-moz-box-shadow:0 1px 3px rgba(0, 0, 0, .4);box-shadow:0 1px 3px rgba(0, 0, 0, .4)}#menubar>li li{width:100%}#menubar>ul>li:hover>ul{opacity:1;top:65px;visibility:visible}#menubar>ul>li>ul:before{content:'';display:block;border-color:transparent transparent #FFF;border-style:solid;border-width:10px;position:absolute;top:-20px;left:10%;margin-left:-10px}#menubar>ul ul>li{position:relative}#menubar ul ul a{color:#323232;font-family:ITC Officina Serif W01, sans-serif, Verdana, 'Lucida Grande';font-size:17px;background-color:#FFF;padding:5px 8px 7px 16px;display:block;-webkit-transition:background-color .1s;-moz-transition:background-color .1s;-o-transition:background-color .1s;transition:background-color .1s}#menubar ul ul ul{visibility:hidden;opacity:0;position:absolute;top:-16px;left:206px;padding:16px 0 20px;background-color:#527AA3;text-align:left;width:160px;-webkit-transition:all .3s;-moz-transition:all .3s;-o-transition:all .3s;transition:all .3s;-webkit-border-radius:5px;-moz-border-radius:5px;border-radius:5px;-webkit-box-shadow:0 1px 3px rgba(0, 0, 0, .4);-moz-box-shadow:0 1px 3px rgba(0, 0, 0, .4);box-shadow:0 1px 3px rgba(0, 0, 0, .4)}a.back-to-top,body.toc2.toc-right a.back-to-top{width:25px;height:25px;text-indent:-9999px;position:fixed;bottom:20px}#menubar ul ul>li:hover>ul{opacity:1;left:196px;visibility:visible}#menubar ul ul a:hover{background-color:#244D82;color:#F7D425}a.back-to-top{display:none;z-index:999;right:20px;background:url(up-arrow.png) center 43% no-repeat #2ba6cb;-webkit-border-radius:30px;-moz-border-radius:30px;border-radius:30px}a:hover.back-to-top{background-color:#F7D425}#tocbutton{visibility:hidden}#tocbuttonbars.fa.fa-bars{z-index:1000;right:0}#tocbutton:hover{background:url(yellowbars.png) center 50% no-repeat}body.toc2.toc-right a.back-to-top{z-index:1001;right:90px;background:url(up-arrow.png) center 43% no-repeat #2ba6cb;-webkit-border-radius:30px;-moz-border-radius:30px;border-radius:30px}body.toc2.toc-left #tocbutton,body.toc2.toc-right #tocbutton{visibility:visible;width:25px;text-indent:-9999px;border:none;height:25px;position:fixed;z-index:998}body.toc2.toc-right #tocbutton{right:25px;top:5px;background:url(yellowbars.png) center 50% no-repeat}body.toc2.toc-left #tocbutton{left:25px;top:25px;background:url(bars-blue.png) center 50% no-repeat}body.toc2.toc-right #tocbutton:hover{background:url(yellowbars.png) center 50% no-repeat}#pagesearch,.treeview li{background-repeat:no-repeat}body.toc2.toc-right a:hover.back-to-top{background-color:#F7D425}@media only screen and (max-width:1000px){#toc.toc2{display:none}}@media only screen and (max-width:500px){body.toc2.toc-left #tocbutton{visibility:hidden}#toc.toc2{width:100%;left:0}#content,#footer,#footnotes,#header{margin-left:0;margin-right:50px}}@media only screen and (max-width:1462px){a.back-to-top{left:90%}}div.openblock.definition{border:1px solid #aaa;margin-bottom:1rem;background-color:#f0f8ff;border-radius:10px;padding:1rem}.requirement{border:1px solid #aaa;margin-bottom:1rem;background-color:#f5f5f5;border-radius:10px;padding:1rem}.bibliography .content .paragraph p:first-child::before{color:#777;content:"[" attr(id) "] "}.bibliography .content .paragraph{padding-left:6em;text-indent:-6em}.hold,.todo{padding:12px;margin-bottom:15px}.todo{color:#dc143c;border:dotted #dc143c;border-width:2px;border-radius:15px;background-color:#fff8dc}.todo::before{content:"TODO"}.hold{color:#ff8c00;border:dotted #ff8c00;border-width:2px;border-radius:15px;background-color:#f5f5f5}.hold::before{content:"ON HOLD"}#toc>ul>li>a{color:#595959;font-size:medium}#toc a:hover,.active,.found{color:#000}#iconTree li,#toclist>li>ul>li{font-size:90%}.treeview,.treeview ul{list-style-type:none;overflow:hidden}.treeview li{text-indent:10%;margin-top:0;padding:.2em 0 0;line-height:20px;background-size:16px 16px;background-position-y:4px}#iconTree li{line-height:15px;background-size:16px 16px}.treeview li.contains-items{font-weight:700;background-image:url(expand.png);background-size:16px 16px}.treeview li.items-expanded{font-weight:400;background-image:url(collapse.png);background-size:16px 16px}.active,.found,.items-expanded>a::first-of-type{font-weight:700}.treview-dotted-lines li{margin-top:.4em !important}.treview-dotted-lines li.items-expanded li{font-weight:700;border-left:1px dotted #444;border-bottom:1px dotted #444;width:60%}.treeview span.has-node-icon{text-indent:2%;margin-top:.2em;padding:.15em 0 .5em 1em;line-height:22px;background-repeat:no-repeat;background-size:24px 24px}.treeview span{padding:5px}.treeview span:not(.has-node-icon):hover{background-color:rgba(246, 246, 246, .7)}#collapsetoc{outline:0;display:none;width:25px;height:25px;text-indent:-9999px;position:fixed;z-index:998;border:none;left:25px;top:55px;background:url(arrow-down.png) center 50% no-repeat}#collapsetoc.inactive{background-image:url(arrow-right.png)}.active{border-right:3px solid #2ba6cb}#toc{margin-top:0}#toc>ul{margin-left:0;padding-left:0}#toc ul.sectlevel0>li>a{font-style:italic}#toc ul.sectlevel0 ul.sectlevel1{margin:0}#toc ul{font-family:"Helvetica Neue", Helvetica, Helvetica, Arial, sans-serif;list-style-type:none}#toc a{color:#595959}#toc a:active{text-decoration:underline}#pagesearch{background-image:url(searchicon.png);background-position:5px 5px;width:100%;font-size:16px;padding:6px 10px 6px 40px;border:1px solid #ddd;margin-bottom:12px}#clear{position:absolute;right:10px;top:72px;bottom:0;height:14px;font-size:14px;color:#ccc}
diff --git a/design/styles/n4js-adoc.css b/design/styles/n4js-adoc.css
new file mode 100644
index 0000000..2d585fc
--- /dev/null
+++ b/design/styles/n4js-adoc.css
@@ -0,0 +1,1278 @@
+@import url("backtotop.css");
+
+/* ========================================================================== HTML5 display definitions ========================================================================== */
+/** Correct `block` display not defined in IE 8/9. */
+@import url(https://fast.fonts.net/cssapi/20974f8a-0939-4574-aef9-681eda2faca8.css);
+article, aside, details, figcaption, figure, footer, header, hgroup, main, nav, section, summary { display: block; }
+
+/** Correct `inline-block` display not defined in IE 8/9. */
+audio, canvas, video { display: inline-block; }
+
+/** Prevent modern browsers from displaying `audio` without controls. Remove excess height in iOS 5 devices. */
+audio:not([controls]) { display: none; height: 0; }
+
+/** Address `[hidden]` styling not present in IE 8/9. Hide the `template` element in IE, Safari, and Firefox < 22. */
+[hidden], template { display: none; }
+
+script { display: none !important; }
+
+/* ========================================================================== Base ========================================================================== */
+/** 1. Set default font family to sans-serif. 2. Prevent iOS text size adjust after orientation change, without disabling user zoom. */
+html { /* 1 */ -ms-text-size-adjust: 100%; /* 2 */ -webkit-text-size-adjust: 100%; /* 2 */ background-color: #D5DFEA; }
+
+/** Remove default margin. */
+body { margin: 0; background-color: #D5DFEA; font-family:sans-serif; font-weight: 400} /* add margin-right 0 here for mobile*/
+
+/* ========================================================================== Links ========================================================================== */
+/** Remove the gray background color from active links in IE 10. */
+a { background: transparent; }
+
+/** Address `outline` inconsistency between Chrome and other browsers. */
+a:focus { outline: thin dotted; }
+
+/** Improve readability when focused and also mouse hovered in all browsers. */
+a:active, a:hover { outline: 0; }
+
+/* ========================================================================== Typography ========================================================================== */
+/** Address variable `h1` font-size and margin within `section` and `article` contexts in Firefox 4+, Safari 5, and Chrome. */
+h1 { font-size: 2em; margin: 0.67em 0; }
+
+/** Address styling not present in IE 8/9, Safari 5, and Chrome. */
+abbr[title] { border-bottom: 1px dotted; }
+
+/** Address style set to `bolder` in Firefox 4+, Safari 5, and Chrome. */
+b, strong { font-weight: 600; }
+
+/** Address styling not present in Safari 5 and Chrome. */
+dfn { font-style: italic; }
+
+/** Address differences between Firefox and other browsers. */
+hr { -moz-box-sizing: content-box; box-sizing: content-box; height: 0; }
+
+/** Address styling not present in IE 8/9. */
+mark { background: #ff0; color: #000; }
+
+/** Correct font family set oddly in Safari 5 and Chrome. */
+code, kbd, pre, samp { font-family: Fira Mono, monospace, serif; font-size: 1em; }
+
+/** Improve readability of pre-formatted text in all browsers. */
+pre { white-space: pre-wrap; }
+
+/** Set consistent quote types. */
+q { quotes: "\201C" "\201D" "\2018" "\2019"; }
+
+/** Address inconsistent and variable font size in all browsers. */
+small { font-size: 80%; }
+
+/** Prevent `sub` and `sup` affecting `line-height` in all browsers. */
+sub, sup { font-size: 75%; line-height: 0; position: relative; vertical-align: baseline; }
+
+sup { top: -0.5em; }
+
+sub { bottom: -0.25em; }
+
+/* ========================================================================== Embedded content ========================================================================== */
+/** Remove border when inside `a` element in IE 8/9. */
+img { border: 0; }
+
+/** Correct overflow displayed oddly in IE 9. */
+svg:not(:root) { overflow: hidden; }
+
+/* ========================================================================== Figures ========================================================================== */
+/** Address margin not present in IE 8/9 and Safari 5. */
+figure { margin: 0; }
+
+/* ========================================================================== Forms ========================================================================== */
+/** Define consistent border, margin, and padding. */
+fieldset { border: 1px solid #c0c0c0; margin: 0 2px; padding: 0.35em 0.625em 0.75em; }
+
+/** 1. Correct `color` not being inherited in IE 8/9. 2. Remove padding so people aren't caught out if they zero out fieldsets. */
+legend { border: 0; /* 1 */ padding: 0; /* 2 */ }
+
+/** 1. Correct font family not being inherited in all browsers. 2. Correct font size not being inherited in all browsers. 3. Address margins set differently in Firefox 4+, Safari 5, and Chrome. */
+button, input, select, textarea { font-family: inherit; /* 1 */ font-size: 100%; /* 2 */ margin: 0; /* 3 */ }
+
+/**
+#tocbutton {
+	top: 0;
+	left: 13rem;
+	position:fixed;
+	z-index: 1000;
+}
+*/
+/** Address Firefox 4+ setting `line-height` on `input` using `!important` in the UA stylesheet. */
+button, input { line-height: normal; }
+
+/** Address inconsistent `text-transform` inheritance for `button` and `select`. All other form control elements do not inherit `text-transform` values. Correct `button` style inheritance in Chrome, Safari 5+, and IE 8+. Correct `select` style inheritance in Firefox 4+ and Opera. */
+button, select { text-transform: none; }
+
+/** 1. Avoid the WebKit bug in Android 4.0.* where (2) destroys native `audio` and `video` controls. 2. Correct inability to style clickable `input` types in iOS. 3. Improve usability and consistency of cursor style between image-type `input` and others. */
+button, html input[type="button"], input[type="reset"], input[type="submit"] { -webkit-appearance: button; /* 2 */ cursor: pointer; /* 3 */ }
+
+/** Re-set default cursor for disabled elements. */
+button[disabled], html input[disabled] { cursor: default; }
+
+/** 1. Address box sizing set to `content-box` in IE 8/9. 2. Remove excess padding in IE 8/9. */
+input[type="checkbox"], input[type="radio"] { box-sizing: border-box; /* 1 */ padding: 0; /* 2 */ }
+
+/** 1. Address `appearance` set to `searchfield` in Safari 5 and Chrome. 2. Address `box-sizing` set to `border-box` in Safari 5 and Chrome (include `-moz` to future-proof). */
+input[type="search"] { -webkit-appearance: textfield; /* 1 */ -moz-box-sizing: content-box; -webkit-box-sizing: content-box; /* 2 */ box-sizing: content-box; }
+
+/** Remove inner padding and search cancel button in Safari 5 and Chrome on OS X. */
+input[type="search"]::-webkit-search-cancel-button, input[type="search"]::-webkit-search-decoration { -webkit-appearance: none; }
+
+/** Remove inner padding and border in Firefox 4+. */
+button::-moz-focus-inner, input::-moz-focus-inner { border: 0; padding: 0; }
+
+/** 1. Remove default vertical scrollbar in IE 8/9. 2. Improve readability and alignment in all browsers. */
+textarea { overflow: auto; /* 1 */ vertical-align: top; /* 2 */ }
+
+/* ========================================================================== Tables ========================================================================== */
+/** Remove most spacing between table cells. */
+table { border-collapse: collapse; border-spacing: 0; }
+
+meta.foundation-mq-small { font-family: "only screen and (min-width: 768px)"; width: 768px; }
+
+meta.foundation-mq-medium { font-family: "only screen and (min-width:1280px)"; width: 1280px; }
+
+meta.foundation-mq-large { font-family: "only screen and (min-width:1440px)"; width: 1440px; }
+
+*, *:before, *:after { -moz-box-sizing: border-box; -webkit-box-sizing: border-box; box-sizing: border-box; }
+
+html, body {  background-color:#527AA3; }
+
+body {  background: white; color: #222222;   padding: ; margin: 0; font-family:sans-serif, Helvetica, Arial, sans-serif; font-weight: 400; font-style: normal; position: relative; cursor: auto; padding-left: 2rem; padding-right: 2rem;}
+
+
+a:hover { cursor: pointer; }
+
+img, object, embed {  height: auto; max-width: 90%; }
+
+
+object, embed { height: 100%; }
+
+img { -ms-interpolation-mode: bicubic; }
+
+#map_canvas img, #map_canvas embed, #map_canvas object, .map_canvas img, .map_canvas embed, .map_canvas object { max-width: none !important; }
+
+.left { float: left !important; }
+
+.right { float: right !important; }	
+
+.text-left { text-align: left !important; }
+
+.text-right { text-align: right !important; }
+
+.text-center { text-align: center !important; }
+
+.text-justify { text-align: justify !important; }
+
+.hide { display: none; }
+
+.antialiased, body { -webkit-font-smoothing: antialiased; }
+
+img { display: inline-block; vertical-align: baseline; }
+
+textarea { height: auto; min-height: 50px; }
+
+select { width: 100%; }
+
+object, svg { display: inline-block; vertical-align: middle; }
+
+.center { margin-left: auto; margin-right: auto; }
+
+.spread { width: 100%; margin-right: 2rem; }
+
+p.lead, .paragraph.lead > p, #preamble > .sectionbody > .paragraph:first-of-type p { font-size: 1em; line-height: 1.6;  }
+
+
+/* Typography padding etc */
+.subheader, .admonitionblock td.content > .title, .audioblock > .title, .exampleblock > .title, .imageblock > .title, .listingblock > .title, .literalblock > .title, .stemblock > .title, .openblock > .title, .paragraph > .title, .quoteblock > .title, table.tableblock > .title, .verseblock > .title, .videoblock > .title, .dlist > .title, .olist > .title, .ulist > .title, .qlist > .title, .hdlist > .title { line-height: 2.4; color: #132445; font-weight: 400; margin-top: 0em; margin-bottom: 0.5em;  }
+
+
+/* Typography resets */
+div, dl, dt, dd, ul, ol, li, h1, h2, h3, #toctitle, .sidebarblock > .content > .title, h4, h5, h6, pre, form, p, blockquote, th, td { margin: 0; padding: 0; direction: ltr; }
+div.openblock.partintro, div.sectionbody.paragraph {font-weight: 500;  line-height: 1.4; margin-bottom: 1em; }
+div.sect1 {padding-top: 1rem;}
+
+div.paragraph.faq-intro {max-width: 66%;}
+
+
+/* Default Link Styles */
+a { color: #6999d6; text-decoration: none; line-height: inherit;  }
+a:hover, a:focus { color: #132445; }
+a img { border: none; }
+
+
+/* Grey links with black transition 
+
+a { color: #2ba6cb; text-decoration: none; line-height: inherit; color: rgba(0,0,0,.3); transition: .2s; }
+a:active, a:hover, a:focus { color: #212121; }
+a img { border: none; }
+
+*/
+
+
+
+/* Default paragraph styles */
+p { font-family:sans-serif; font-weight: 400; font-size: 1.2rem; line-height: 1.4; padding-bottom: 0.5em;    }
+p aside { font-size: 0.575em; line-height: 1.35; font-style: italic; }
+div.p, { width: 100% }
+
+
+/* Default header styles */
+h1, h2, h3, #toctitle, .sidebarblock > .content > .title, h4, h5, h6 { font-family: sans-serif; font-weight: 600; font-style: normal; color: #244d82; text-rendering: optimizeLegibility; margin-bottom: 0em; line-height: 1.2125em; margin-top:; 2rem;  }
+h1 small, h2 small, h3 small, #toctitle small, .sidebarblock > .content > .title small, h4 small, h5 small, h6 small { font-size: 60%; color: #6999d6; line-height: 0; }
+
+h1 { font-size: 2.125em; max-width:66.66%;}
+
+h2 { font-size: 1.6875em; }
+
+h3, #toctitle, .sidebarblock > .content > .title { font-size: 1.375em; }
+
+h4 { font-size: 1.125em; }
+
+h5 { font-size: 1.125em; }
+
+h6 { font-size: 1em; }
+
+hr { border: solid #dddddd; border-width: 1px 0 0; clear: both; margin: 1.25em 0 1.1875em; height: 0; }
+
+/* Helpful Typography Defaults */
+em, i { font-style: italic; line-height: inherit; }
+
+strong, b { font-weight: 600; line-height: inherit; }
+
+small { font-size: 60%; line-height: inherit; }
+
+code { font-family: Fira Mono, Consolas, "Liberation Mono", Courier, monospace;  }
+
+/* Lists */
+ul, ol, dl {  list-style-position: outside; font-family:sans-serif; padding-left: 0rem; list-style-type: none}
+
+ul, ol { margin-left: 0em;  }
+ul.no-bullet, ol.no-bullet { margin-left: 1.5em;  margin-bottom: 0;}
+
+/* Unordered Lists */
+ul li ul, ul li ol { margin-left: 1.25em; margin-bottom: 0; font-size: 1em; /* Override nested font-size change */  }
+ul.square li ul, ul.circle li ul, ul.disc li ul { list-style: inherit; }
+ul.square { list-style-type: square; }
+ul.circle { list-style-type: circle; }
+ul.disc { list-style-type: none; }
+ul.no-bullet { list-style: none; }
+
+/* Ordered Lists */
+ol li ul, ol li ol { margin-left: 1.25em; margin-bottom: 0;   }
+
+/* Definition Lists */
+dl dt { margin-bottom: 0.3125em; font-weight: bold; font-size: 1.2em; font-style: italic}
+dl dd { margin-bottom: 1.25em; }
+
+/* Abbreviations */
+abbr, acronym { text-transform: uppercase; font-size: 90%; color: #222222; border-bottom: 1px dotted #dddddd; cursor: help; }
+
+abbr { text-transform: none; }
+
+/* Blockquotes */
+blockquote { margin: 0 0 1.25em; padding: 0.5625em 1.25em 0 1.1875em; border-left: 1px solid #dddddd; }
+blockquote cite { display: block; font-size: inherit; color: color: #132445; }
+blockquote cite:before { content: "\2014 \0020"; }
+blockquote cite a, blockquote cite a:visited { color: #417dcb; }
+
+blockquote, blockquote p { line-height: 1.6; color: #132445; }
+
+/* Microformats */
+.vcard { display: inline-block; margin: 0 0 1.25em 0; border: 1px solid #dddddd; padding: 0.625em 0.75em; }
+.vcard li { margin: 0; display: block; }
+.vcard .fn { font-weight: bold; font-size: 0.9375em; }
+
+.vevent .summary { font-weight: bold; }
+.vevent abbr { cursor: auto; text-decoration: none; font-weight: bold; border: none; padding: 0 0.0625em; }
+
+@media only screen and (min-width: 768px) { h1, h2, h3, #toctitle, .sidebarblock > .content > .title, h4, h5, h6 { line-height: 1.4;  margin-top: 1rem; margin-bottom: 0.2rem;}
+  h1 { font-size: 2.75em; }
+  h2 { font-size: 2.3125em; }
+  h3, #toctitle, .sidebarblock > .content > .title { font-size: 1.6875em; }
+  h4 { font-size: 1.4375em; } }
+
+/* Tables */
+table { background: white; margin-bottom: 1.25em; border: solid 1px #dddddd; }
+table thead, table tfoot { background: whitesmoke; font-weight: 600; }
+table thead tr th, table thead tr td, table tfoot tr th, table tfoot tr td { padding: 0.5em 0.625em 0.625em; font-size: inherit; color: #222222; text-align: left; }
+table tr th, table tr td { padding: 0.5625em 0.625em; font-size: inherit; color: #222222; }
+table tr.even, table tr.alt, table tr:nth-of-type(even) { background: #f9f9f9; }
+table thead tr th, table tfoot tr th, table tbody tr td, table tr td, table tfoot tr td { display: table-cell; line-height: 1.4; }
+
+/* FEATURE TABLE */
+
+table.done, tr.done.alt, table.done tr:nth-of-type(even) {
+	background: #efe;
+	padding-top: 0;
+	padding-bottom: 0;
+	border: none;
+	margin-bottom: -1px;
+}
+
+table.most, tr.most.alt, table.most tr:nth-of-type(even) {
+	background: #ffd;
+	padding-top: 0;
+	padding-bottom: 0;
+	border: none;
+	margin-bottom: -1px;
+}
+
+table.tbc, tr.tbc.alt, table.tbc tr:nth-of-type(even) {
+	background: #fff6de;
+	padding-top: 0;
+	padding-bottom: 0;
+	border: none;
+	margin-bottom: -1px;
+}
+
+table.tbd, tr.tbd.alt, table.tbd tr:nth-of-type(even) {
+	background: #fee;
+	padding-top: 0;
+	padding-bottom: 0;
+	border: none;
+	margin-bottom: -1px;
+}
+
+table.done thead tr th, table.done tfoot tr th, table.done tfoot tr td, table.done.sect2, table.most thead tr th, table.most tfoot tr th, table.most tfoot tr td, table.most.sect2, table.tbc thead tr th, table.tbc tfoot tr th, table.tbc tfoot tr td, table.tbc.sect2, table.tbd thead tr th, table.tbd tfoot tr th, table.tbd tfoot tr td, table.tbd.sect2 {background: white; font-size: 1.9rem; color: #417dcb; }
+
+
+
+/* 
+green "done" = #efe
+yellow "most" = #ffd
+orange "tbc" = #fff6de
+red "tbd" = #fee
+ */
+
+
+
+body { tab-size: 4; max-width: 1050px; margin-right: auto; margin-left: auto; position: relative; margin-top: 0rem; margin-bottom: 0rem; padding-top: 0rem; /*  Fixes tables, breaks headers */}
+
+h1, h2, h3, #toctitle, .sidebarblock > .content > .title, h4, h5, h6 { line-height: 1.4;  margin-top: 0rem;}
+
+.clearfix:before, .clearfix:after, .float-group:before, .float-group:after { content: " "; display: table; }
+.clearfix:after, .float-group:after { clear: both; }
+
+*:not(pre) > code { font-size: inherit; font-style: normal !important; letter-spacing: 0; padding: 0; line-height: inherit; }
+
+pre, pre > code { line-height: 1.4; color: black; font-family: monospace, serif; font-weight: normal; }
+
+.keyseq { color: #555555; }
+
+kbd { font-family: Consolas, "Liberation Mono", Courier, monospace; display: inline-block; color: #222222; font-size: 0.65em; line-height: 1.45; background-color: #f7f7f7; border: 1px solid #ccc; -webkit-border-radius: 3px; border-radius: 3px; -webkit-box-shadow: 0 1px 0 rgba(0, 0, 0, 0.2), 0 0 0 0.1em white inset; box-shadow: 0 1px 0 rgba(0, 0, 0, 0.2), 0 0 0 0.1em white inset; margin: 0 0.15em; padding: 0.2em 0.5em; vertical-align: middle; position: relative; top: -0.1em; white-space: nowrap; }
+
+.keyseq kbd:first-child { margin-left: 0; }
+
+.keyseq kbd:last-child { margin-right: 0; }
+
+.menuseq, .menu { color: #090909; }
+
+b.button:before, b.button:after { position: relative; top: -1px; font-weight: normal; }
+
+b.button:before { content: "["; padding: 0 3px 0 2px; }
+
+b.button:after { content: "]"; padding: 0 2px 0 3px; }
+
+#header, #content, #footnotes, #footer {  max-width: 1050px; margin-right: auto; margin-left: auto; position: relative; margin-top: 0rem; margin-bottom: 0rem; padding-top: 0rem;  padding-right: 0rem;}
+#header:before, #header:after, #content:before, #content:after, #footnotes:before, #footnotes:after, #footer:before, #footer:after { content: " "; display: table; }
+#header:after, #content:after, #footnotes:after, #footer:after { clear: both; }
+
+
+#content:before { content: none; }
+#content {padding-left: 0.5rem;}
+
+#header > h1:first-child { color: black; font-weight: bold; margin-top: 2.25rem; margin-bottom: 0; }
+#header > h1:first-child + #toc { margin-top: 8px; border-top: 1px solid #dddddd; }
+#header > h1:only-child, body.toc2 #header > h1:nth-last-child(2) { border-bottom: 1px solid #dddddd; padding-bottom: 8px; }
+#header .details { border-bottom: 1px solid #dddddd; line-height: 1.45; padding-top: 0.25em; padding-bottom: 0.25em; padding-left: 0.25em; color: #417dcb; display: -ms-flexbox; display: -webkit-flex; display: flex; -ms-flex-flow: row wrap; -webkit-flex-flow: row wrap; flex-flow: row wrap; }
+#header .details span:first-child { margin-left: -0.125em; }
+#header .details span.email a { color: #6999d6; }
+#header .details br { display: none; }
+#header .details br + span:before { content: "\00a0\2013\00a0"; }
+#header .details br + span.author:before { content: "\00a0\22c5\00a0"; color: #6999d6; }
+#header .details br + span#revremark:before { content: "\00a0|\00a0"; }
+#header #revnumber { text-transform: capitalize; }
+#header #revnumber:after { content: "\00a0"; }
+
+#content > h1:first-child:not([class]) { color: black; font-weight: bold; border-bottom: 1px solid #dddddd; max-width: 1050px; margin-right: auto; margin-left: auto; position: relative; margin-top: 4rem; margin-bottom: 4rem; padding-top: 0rem;   }
+
+/* ========================================================================== Table of Contents ======================================================================= */
+
+
+
+#toc { border-bottom: 1px solid #dddddd; padding-bottom: 0.5em; position: relative; left: 0;}
+#toc > ul { margin-left: 0.125em; padding-left: 1em; }
+#toc ul.sectlevel0 > li > a { font-style: italic; }
+#toc ul.sectlevel0 ul.sectlevel1 { margin: 0.5em 0; }
+#toc ul { font-family: "Helvetica Neue", "Helvetica", Helvetica, Arial, sans-serif; list-style-type: none; }
+#toc li { line-height: 1.3334; margin-top: 0.3334em; }
+#toc a { text-decoration: none; }
+#toc a:active { text-decoration: underline; }
+
+#toc ul li:before {
+    content: "›";
+    margin-left: -.75em;
+    margin-right: .4em;
+    color: #244d82
+}
+
+
+
+div.ulist li:before {
+    content: "›";
+    position: absolute;
+    margin-top: .2rem;
+    font-size: x-large;
+    margin-left: -.75em;
+    margin-bottom: -.75em;
+    margin-right: 0;
+    line-height: 1rem;
+    color: #244d82
+
+}
+
+
+#toctitle { color: #244d82; font-size: 1.2em; padding-left: 1em; }
+
+#faq {
+	position: relative;
+	right: 9.3rem;
+    top: 9rem;
+	margin-bottom: 20px;
+	left: 45rem;
+	z-index:1;padding-left:2rem;border-left:1px solid #d3d3d3
+
+}
+@media only screen and (max-width: 945px) {
+	div#faq { display: none; }
+}
+
+#faq h2 {
+	font-size: 25px;
+	font-weight: 600;
+	margin-top: -8rem;
+}
+
+div#faq li:before {
+    content: "›";
+    position: absolute;
+    font-size: x-large;
+    margin-left: -.75em;
+    margin-bottom: -.75em;
+    margin-right: 0;
+    line-height: 1rem;
+    color: #244d82
+}
+
+#features-nav {
+	position: absolute;
+	right: 1rem;
+	top: 2rem;
+	margin-bottom: 20px;
+	position:absolute;z-index:1;padding-left:2rem;border-left:1px solid #d3d3d3
+}
+
+@media only screen and (max-width: 993px) {
+	#features-nav { display: none; }
+}
+
+#features-nav h2 {
+	font-size: 25px;
+	font-weight: 600;
+	margin-top: -1rem;
+}
+#features-nav li {
+	margin-top: .3rem;
+}
+
+div#features-nav li:before {
+    content: "›";
+    position: absolute;
+    font-size: x-large;
+    margin-left: -.75em;
+    margin-bottom: -.75em;
+    margin-right: 0;
+    line-height: 1rem;
+    color: #244d82
+}
+
+
+@media only screen and (min-width: 1434px) { body.toc2.toc-right #toc.toc2 { border-right-width: 0; border: none; left: 0px; } }
+
+@media only screen and (min-width: 1434px) { #toctitle { padding-top: 1.5rem; font-size: 1.375em; }
+  body.toc2 { padding-left: 2em; padding-right: 1em; }
+  #toc.toc2 { margin-top: 0 !important; background-color: #f2f2f2; position: fixed; width: 12em; left: 0; top: 0; border-right: 1px solid #dddddd; border-top-width: 0 !important; border-bottom-width: 0 !important; z-index: 1000; padding: 1.25em 0.25em 0em 0.25em; height: 100%; overflow: auto; }
+  #toc.toc2 #toctitle { margin-top: 0; margin-bottom: 0.8rem; font-size: 1.2em; padding-left: 1em;}
+  #toc.toc2 > ul { font-size: 0.9em; margin-bottom: 0; }
+  #toc.toc2 ul ul { margin-left: 1em; padding-left: .3em; }
+  #toc.toc2 ul.sectlevel0 ul.sectlevel1 { padding-left: 0; margin-top: 0.5em; margin-bottom: 0.5em; }
+  body.toc2.toc-right { padding-left: 2em; padding-right: 2em; }
+  body.toc2.toc-right #toc.toc2 { border-right-width: 0; border-left: 1px solid #dddddd; left: auto; right: -13rem; } }
+@media only screen and (min-width: 1535px) { 
+  body.toc2 { padding-left: 2em; padding-right: 2em; }
+  #toctitle { padding-top: 0rem; font-size: 1.375em; }
+  #toc.toc2 { width: 13em; }
+  #toc.toc2 #toctitle { font-size: 1.375em; }
+  #toc.toc2 > ul { font-size: 0.95em; }
+  #toc.toc2 ul ul { padding-left: 0; }
+  body.toc2.toc-right { padding-left: 2em; padding-right: 2em; } }
+#content #toc { border-style: solid; border-width: 1px; border-color: #d9d9d9; margin-bottom: 1.25em; padding: 1.25em; background: #f2f2f2; -webkit-border-radius: 0; border-radius: 0; }
+#content #toc > :first-child { margin-top: 0; }
+#content #toc > :last-child { margin-bottom: 0; }
+
+
+
+#footer {  width: 1050px;background-color: #132445; padding: 1.25em; padding-bottom: 0rem; margin-right: -2rem; margin-left: -2rem; margin-top: 2rem; color: white}
+div.social  { line-height: 1.4; color: #FFFFFF;font-size:  1.2rem; font-weight: 400; font-style: bold; background-color: #132445; margin-right: -2rem; margin-left: -2rem; text-align: left; padding-bottom: 4px; padding-left: 25px; }
+div.social li a {  margin-bottom: 2em;  color: #d5dfea;font-size:  1.2rem; font-weight: 800; font-style: bold; list-style: none; list-style-type: none; text-decoration-color: rgb(213, 223, 234); }
+/* div.social a:visited { color: #244D82; }*/
+div.social a:hover { color: #F7D425; }
+div.social :first-child { margin-top: 0; }
+div.social h2 {        margin-bottom: 20px;font-weight: 600;font-size: 1.3em;margin-top: 4rem;color: #244d82;font-family: sans-serif;}
+div.social li:before {content: "› "; color: #244d82;font-size: large;font-weight: 800;}
+div.social ul {margin-top: -10px;line-height: 30px;}
+div.social li {/* nothing */}
+
+#bottomright {float: right;}
+
+
+@media only screen and (max-width: 1050px) {
+	body {width: 100%;}
+}
+
+
+
+#footer-text { color: #dddddd; line-height: 1.44; }
+
+
+.sect1 { padding-bottom: 0.625em; }
+.sectionbody.paragraph {max-width: 66.666%}
+.sectionbody ul {padding-left: 1rem;}
+
+@media only screen and (min-width: 768px) { .sect1 { padding-bottom: 0em; } }
+.sect1 + .sect1 { border-top: 0px solid #dddddd; }
+
+#content h1 > a.anchor, h2 > a.anchor, h3 > a.anchor, #toctitle > a.anchor, .sidebarblock > .content > .title > a.anchor, h4 > a.anchor, h5 > a.anchor, h6 > a.anchor { position: absolute; z-index: 1001; width: 1.5ex; margin-left: -1.5ex; display: block; text-decoration: none !important; visibility: hidden; text-align: center; font-weight: 400; max-width: 1050px; }
+#content h1 > a.anchor:before, h2 > a.anchor:before, h3 > a.anchor:before, #toctitle > a.anchor:before, .sidebarblock > .content > .title > a.anchor:before, h4 > a.anchor:before, h5 > a.anchor:before, h6 > a.anchor:before { content: "\2771"; font-size: 0.85em; display: block; padding-top: 0.1em; vertical-align: bas }
+#content h1:hover > a.anchor, #content h1 > a.anchor:hover, h2:hover > a.anchor, h2 > a.anchor:hover, h3:hover > a.anchor, #toctitle:hover > a.anchor, .sidebarblock > .content > .title:hover > a.anchor, h3 > a.anchor:hover, #toctitle > a.anchor:hover, .sidebarblock > .content > .title > a.anchor:hover, h4:hover > a.anchor, h4 > a.anchor:hover, h5:hover > a.anchor, h5 > a.anchor:hover, h6:hover > a.anchor, h6 > a.anchor:hover { visibility: visible; }
+#content h1 > a.link, h2 > a.link, h3 > a.link, #toctitle > a.link, .sidebarblock > .content > .title > a.link, h4 > a.link, h5 > a.link, h6 > a.link { color: #244d82; text-decoration: none; font-family:  sans-serif}
+#content h1 > a.link:hover, h2 > a.link:hover, h3 > a.link:hover, #toctitle > a.link:hover, .sidebarblock > .content > .title > a.link:hover, h4 > a.link:hover, h5 > a.link:hover, h6 > a.link:hover { color: #1e416e; }
+
+.audioblock, .imageblock, .literalblock, .listingblock, .stemblock, .videoblock { margin-bottom: 1.25em; }
+
+.admonitionblock td.content > .title, .audioblock > .title, .exampleblock > .title, .imageblock > .title, .listingblock > .title, .literalblock > .title, .stemblock > .title, .openblock > .title, .paragraph > .title, .quoteblock > .title, table.tableblock > .title, .verseblock > .title, .videoblock > .title, .dlist > .title, .olist > .title, .ulist > .title, .qlist > .title, .hdlist > .title { text-rendering: optimizeLegibility; text-align: left;   }
+
+table.tableblock > caption.title { white-space: nowrap; overflow: visible; max-width: 0;  }
+
+.paragraph.lead > p, #preamble > .sectionbody > .paragraph:first-of-type p { color: black; max-width: 66%}
+
+table.tableblock #preamble > .sectionbody > .paragraph:first-of-type p { font-size: inherit; }
+
+.admonitionblock > table { border-collapse: separate; border: 0; background: none; max-width: 80%;}
+.admonitionblock > table td.icon { text-align: center; width: 80px; }
+.admonitionblock > table td.icon img { max-width: none; }
+.admonitionblock > table td.icon .title { font-weight: bold; font-family:  sans-serif, Georgia, Verdana, "Helvetica", Helvetica, Arial, sans-serif; text-transform: uppercase; }
+.admonitionblock > table td.content { padding-left: 1.125em; padding-right: 1.25em; border-left: 1px solid #dddddd; color: #417dcb; }
+.admonitionblock > table td.content > :last-child > :last-child { margin-bottom: 0; }
+
+.exampleblock > .content { border-style: solid; border-width: 1px; border-color: #e6e6e6; margin-bottom: 1.25em; padding: 1.25em; background-color: #fffef7; -webkit-border-radius: 0; border-radius: 0; }
+.exampleblock > .content > :first-child { margin-top: 0; }
+.exampleblock > .content > :last-child { margin-bottom: 0; }
+
+.sidebarblock { position: absolute; border-style: solid; border-width: 1px; border-color: #d9d9d9; margin: -2rem -7.5rem 0rem 63.65rem; padding: .2rem; background: #f2f2f2; -webkit-border-radius: 0; border-radius: 0; text-align: left; width: 5.5rem;}
+.sidebarblock > :first-child { margin-top: 0; }
+.sidebarblock > :last-child { margin-bottom: 0; }
+.sidebarblock > .content > .title { color: #6999d6; margin-top: 0; }
+
+@media only screen and (max-width: 1203px) { 
+.sidebarblock { position: absolute; right: 12%; }
+}
+@media only screen and (max-width: 817px) { 
+.sidebarblock { position: absolute; right: 18%; }
+}
+
+@media only screen and (max-width: 562px) { 
+.sidebarblock { position: absolute; right: 25%; }
+}
+
+.exampleblock > .content > :last-child > :last-child, .exampleblock > .content .olist > ol > li:last-child > :last-child, .exampleblock > .content .ulist > ul > li:last-child > :last-child, .exampleblock > .content .qlist > ol > li:last-child > :last-child, .sidebarblock > .content > :last-child > :last-child, .sidebarblock > .content .olist > ol > li:last-child > :last-child, .sidebarblock > .content .ulist > ul > li:last-child > :last-child, .sidebarblock > .content .qlist > ol > li:last-child > :last-child { margin-bottom: 0; }
+
+.literalblock pre, .listingblock pre:not(.highlight), .listingblock pre[class="highlight"], .listingblock pre[class^="highlight "], .listingblock pre.CodeRay, .listingblock pre.prettyprint { background: #eeeeee; }
+.sidebarblock .literalblock pre, .sidebarblock .listingblock pre:not(.highlight), .sidebarblock .listingblock pre[class="highlight"], .sidebarblock .listingblock pre[class^="highlight "], .sidebarblock .listingblock pre.CodeRay, .sidebarblock .listingblock pre.prettyprint { background: #f2f1f1; }
+
+.literalblock pre, .literalblock pre[class], .listingblock pre, .listingblock pre[class] { border: 1px solid #cccccc; -webkit-border-radius: 0; border-radius: 0; word-wrap: break-word; padding: 0.8em 0.8em 0.65em 0.8em; font-size: 0.8125em; }
+.literalblock pre.nowrap, .literalblock pre[class].nowrap, .listingblock pre.nowrap, .listingblock pre[class].nowrap { overflow-x: auto; white-space: pre; word-wrap: normal; }
+@media only screen and (min-width: 768px) { .literalblock pre, .literalblock pre[class], .listingblock pre, .listingblock pre[class] { font-size: 0.90625em; } }
+@media only screen and (min-width: 1280px) { .literalblock pre, .literalblock pre[class], .listingblock pre, .listingblock pre[class] { font-size: 1em; } }
+
+.literalblock.output pre { color: #eeeeee; background-color: black; }
+
+.listingblock pre.highlightjs { padding: 0;  margin-right: 0em; }
+.listingblock pre.highlightjs > code { padding: 0.8em 2rem 0.65em 0.8em; -webkit-border-radius: 0; border-radius: 0; padding-right: 2rem;}
+
+.listingblock > .content { position: relative; }
+
+.listingblock code[data-lang]:before { display: none; content: attr(data-lang); position: absolute; font-size: 0.75em; top: 0.425rem; right: 0.5rem; line-height: 1; text-transform: uppercase; color: #999; padding-right: 2rem; }
+
+.listingblock:hover code[data-lang]:before { display: none; }
+
+.listingblock.terminal pre .command:before { content: attr(data-prompt); padding-right: 0.5em; color: #999; }
+
+.listingblock.terminal pre .command:not([data-prompt]):before { content: "$"; }
+
+table.pyhltable { border-collapse: separate; border: 0; margin-bottom: 0; background: none; }
+
+table.pyhltable td { vertical-align: top; padding-top: 0; padding-bottom: 0; line-height: 1.4; }
+
+table.pyhltable td.code { padding-left: .75em; padding-right: 0; }
+
+pre.pygments .lineno, table.pyhltable td:not(.code) { color: #999; padding-left: 0; padding-right: .5em; border-right: 1px solid #dddddd; }
+
+pre.pygments .lineno { display: inline-block; margin-right: .25em; }
+
+table.pyhltable .linenodiv { background: none !important; padding-right: 0 !important; }
+
+.quoteblock { margin: 0 1em 1.25em 1.5em; display: table; }
+.quoteblock > .title { margin-left: -1.5em; margin-bottom: 0.75em; }
+.quoteblock blockquote, .quoteblock blockquote p { color: #132445; font-size: 1.15rem; line-height: 1.75; word-spacing: 0.1em; letter-spacing: 0; font-style: italic; text-align: justify; }
+.quoteblock blockquote { margin: 0; padding: 1rem; border: 0; }
+.quoteblock blockquote:before { content: "\201c"; float: left; font-size: 2.75em; font-weight: bold; line-height: 0.6em; margin-left: -0.6em; color: #6999d6; text-shadow: 0 1px 2px rgba(0, 0, 0, 0.1); }
+.quoteblock blockquote > .paragraph:last-child p { margin-bottom: 0; }
+.quoteblock .attribution { margin-top: 1em; margin-right: 0.5ex; text-align: right; }
+.quoteblock .quoteblock { margin-left: 0; margin-right: 0; padding: 0.5em 0; border-left: 3px solid #417dcb; }
+.quoteblock .quoteblock blockquote { padding: 0 0 0 0.75em; }
+.quoteblock .quoteblock blockquote:before { display: none; }
+
+.verseblock { margin: 0 1em 1.25em 1em; }
+.verseblock pre { font-family:  sans-serif, "Open Sans", "DejaVu Sans", sans; font-size: 1.15rem; color: #6999d6; font-weight: 300; text-rendering: optimizeLegibility; }
+.verseblock pre strong { font-weight: 400; }
+.verseblock .attribution { margin-top: 1.25rem; margin-left: 0.5ex; text-align: right;}
+
+.quoteblock .attribution, .verseblock .attribution { font-size: inherit; line-height: 1.45; font-style: italic; }
+.quoteblock .attribution br, .verseblock .attribution br { display: none; }
+.quoteblock .attribution cite, .verseblock .attribution cite { display: block; letter-spacing: -0.025em; color: #417dcb; }
+
+.quoteblock.abstract { margin: 0 0 1.25em 0; display: block; }
+.quoteblock.abstract blockquote, .quoteblock.abstract blockquote p { text-align: left; word-spacing: 0; }
+.quoteblock.abstract blockquote:before, .quoteblock.abstract blockquote p:first-of-type:before { display: none; }
+
+table.tableblock { max-width: 100%; border-collapse: separate;  }
+table.tableblock td > .paragraph:last-child p > p:last-child, table.tableblock th > p:last-child, table.tableblock td > p:last-child { margin-bottom: 0; }
+
+table.tableblock, th.tableblock, td.tableblock { border: 0 solid #dddddd; margin-right: 2rem;}
+
+table.grid-all th.tableblock, table.grid-all td.tableblock { border-width: 0 1px 1px 0; padding: 0.5rem;}
+
+table.grid-all tfoot > tr > th.tableblock, table.grid-all tfoot > tr > td.tableblock { border-width: 1px 1px 0 0; }
+
+table.grid-cols th.tableblock, table.grid-cols td.tableblock { border-width: 0 1px 0 0; }
+
+table.grid-all * > tr > .tableblock:last-child, table.grid-cols * > tr > .tableblock:last-child { border-right-width: 0; }
+
+table.grid-rows th.tableblock, table.grid-rows td.tableblock { border-width: 0 0 1px 0; }
+
+table.grid-all tbody > tr:last-child > th.tableblock, table.grid-all tbody > tr:last-child > td.tableblock, table.grid-all thead:last-child > tr > th.tableblock, table.grid-rows tbody > tr:last-child > th.tableblock, table.grid-rows tbody > tr:last-child > td.tableblock, table.grid-rows thead:last-child > tr > th.tableblock { border-bottom-width: 0;}
+
+table.grid-rows tfoot > tr > th.tableblock, table.grid-rows tfoot > tr > td.tableblock { border-width: 1px 0 0 0; }
+
+table.frame-all { border-width: 1px; }
+
+table.frame-sides { border-width: 0 1px; }
+
+table.frame-topbot { border-width: 1px 0; }
+
+th.halign-left, td.halign-left { text-align: left; }
+
+th.halign-right, td.halign-right { text-align: right; }
+
+th.halign-center, td.halign-center { text-align: center; }
+
+th.valign-top, td.valign-top { vertical-align: top; }
+
+th.valign-bottom, td.valign-bottom { vertical-align: bottom; }
+
+th.valign-middle, td.valign-middle { vertical-align: middle; }
+
+table thead th, table tfoot th { font-weight: 600; }
+
+tbody tr th { display: table-cell; line-height: 1.4; background: whitesmoke; }
+
+tbody tr th, tbody tr th p, tfoot tr th, tfoot tr th p { color: #222222; font-weight: 600; }
+
+p.tableblock > code:only-child { background: none; padding: 0; max-width: 100%}
+
+p.tableblock { font-size: 1em; max-width: 100% }
+
+td > div.verse { white-space: pre; }
+
+ol { margin-left: 1.75em; }
+
+ul li ol { margin-left: 1.5em; }
+
+
+dl dd { margin-left: 1.125em; }
+
+dl dd:last-child, dl dd:last-child > :last-child { margin-bottom: 0; }
+
+ol > li p, ul > li p, ul dd, ol dd, .olist .olist, .ulist .ulist, .ulist .olist, .olist .ulist { margin-bottom: -0.2em; }
+
+ul.unstyled, ol.unnumbered, ul.checklist, ul.none { list-style-type: none; }
+
+ul.unstyled, ol.unnumbered, ul.checklist { margin-left: 0.625em; }
+
+ul.checklist li > p:first-child > .fa-square-o:first-child, ul.checklist li > p:first-child > .fa-check-square-o:first-child { width: 1em; font-size: 0.85em; }
+
+ul.checklist li > p:first-child > input[type="checkbox"]:first-child { width: 1em; position: relative; top: 1px; }
+
+ul.inline { margin: 0 auto 0.625em auto; margin-left: -1.375em; margin-right: 0; padding: 0; list-style: none; overflow: hidden; }
+ul.inline > li { list-style: none; float: left; margin-left: 1.375em; display: block; }
+ul.inline > li > * { display: block; }
+
+.unstyled dl dt { font-weight: normal; font-style: normal; }
+
+ol.arabic { list-style-type: decimal; }
+
+ol.decimal { list-style-type: decimal-leading-zero; }
+
+ol.loweralpha { list-style-type: lower-alpha; }
+
+ol.upperalpha { list-style-type: upper-alpha; }
+
+ol.lowerroman { list-style-type: lower-roman; }
+
+ol.upperroman { list-style-type: upper-roman; }
+
+ol.lowergreek { list-style-type: lower-greek; }
+
+.hdlist > table, .colist > table { border: 0; background: none; }
+.hdlist > table > tbody > tr, .colist > table > tbody > tr { background: none; }
+
+td.hdlist1, td.hdlist2 { vertical-align: baseline; padding: 0 0.625em; }
+
+td.hdlist1 { font-weight: bold; padding-bottom: 1.25em; }
+
+.literalblock + .colist, .listingblock + .colist { margin-top: -0.5em;  }
+
+.colist > table tr > td:first-of-type { padding: 0 0.75em; line-height: 1; }
+.colist > table tr > td:last-of-type { padding: 0.25em 0; }
+
+.thumb, .th { line-height: 0; display: inline-block; border: solid 4px white; -webkit-box-shadow: 0 0 0 1px #dddddd; box-shadow: 0 0 0 1px #dddddd; }
+
+.imageblock.left, .imageblock[style*="float: left"] { margin: 0.25em 0.625em 1.25em 0;   }
+.imageblock.right, .imageblock[style*="float: right"] { margin: 0.25em 0 1.25em 0.625em;  }
+.imageblock > .title { margin-bottom: 0; }
+.imageblock.thumb, .imageblock.th { border-width: 6px; }
+.imageblock.thumb > .title, .imageblock.th > .title { padding: 0 0.125em; }
+
+.image.left, .image.right { margin-top: 0.25em; margin-bottom: 0.25em; display: inline-block; line-height: 0; }
+.image.left { margin-right: 0.625em; }
+.image.right { margin-left: 0.625em; }
+
+a.image { text-decoration: none; display: inline-block; }
+a.image object { pointer-events: none; }
+
+sup.footnote, sup.footnoteref { font-size: 0.875em; position: static; vertical-align: super; }
+sup.footnote a, sup.footnoteref a { text-decoration: none; }
+sup.footnote a:active, sup.footnoteref a:active { text-decoration: underline; }
+
+#footnotes { padding-top: 0.75em; padding-bottom: 0.75em; margin-bottom: 0.625em; }
+#footnotes hr { width: 20%; min-width: 6.25em; margin: -0.25em 0 0.75em 0; border-width: 1px 0 0 0; }
+#footnotes .footnote { padding: 0 0.375em 0 0.225em; line-height: 1.3334; font-size: 0.875em; margin-left: 1.2em; text-indent: -1.05em; margin-bottom: 0.2em; }
+#footnotes .footnote a:first-of-type { font-weight: bold; text-decoration: none; }
+#footnotes .footnote:last-of-type { margin-bottom: 0; }
+#content #footnotes { margin-top: -0.625em; margin-bottom: 0; padding: 0.75em 0; }
+
+.gist .file-data > table { border: 0; background: #fff; width: 100%; margin-bottom: 0; }
+.gist .file-data > table td.line-data { width: 99%; }
+
+div.github-block { text-align: right; margin-right: -1rem; }
+div.gist {padding-right: 2rem;}
+
+div.unbreakable { page-break-inside: avoid; }
+
+.big { font-size: larger; }
+
+.small { font-size: smaller; }
+
+.underline { text-decoration: underline; }
+
+.overline { text-decoration: overline; }
+
+.line-through { text-decoration: line-through; }
+
+.aqua { color: #00bfbf; }
+
+.aqua-background { background-color: #00fafa; }
+
+.black { color: black; }
+
+.black-background { background-color: black; }
+
+.blue { color: #0000bf; }
+
+.blue-background { background-color: #0000fa; }
+
+.fuchsia { color: #bf00bf; }
+
+.fuchsia-background { background-color: #fa00fa; }
+
+.gray { color: #606060; }
+
+.gray-background { background-color: #7d7d7d; }
+
+.green { color: #006000; }
+
+.green-background { background-color: #007d00; }
+
+.lime { color: #00bf00; }
+
+.lime-background { background-color: #00fa00; }
+
+.maroon { color: #600000; }
+
+.maroon-background { background-color: #7d0000; }
+
+.navy { color: #000060; }
+
+.navy-background { background-color: #00007d; }
+
+.olive { color: #606000; }
+
+.olive-background { background-color: #7d7d00; }
+
+.purple { color: #600060; }
+
+.purple-background { background-color: #7d007d; }
+
+.red { color: #bf0000; }
+
+.red-background { background-color: #fa0000; }
+
+.silver { color: #909090; }
+
+.silver-background { background-color: #bcbcbc; }
+
+.teal { color: #006060; }
+
+.teal-background { background-color: #007d7d; }
+
+.white { color: #bfbfbf; }
+
+.white-background { background-color: #fafafa; }
+
+.yellow { color: #bfbf00; }
+
+.yellow-background { background-color: #fafa00; }
+
+span.icon > .fa { cursor: default; }
+
+.admonitionblock td.icon [class^="fa icon-"] { font-size: 2.5em; text-shadow: 1px 1px 2px rgba(0, 0, 0, 0.5); cursor: default; }
+.admonitionblock td.icon .icon-note:before { content: "\f05a"; color: #207c98; }
+.admonitionblock td.icon .icon-tip:before { content: "\f0eb"; text-shadow: 1px 1px 2px rgba(155, 155, 0, 0.8); color: #111; }
+.admonitionblock td.icon .icon-warning:before { content: "\f071"; color: #bf6900; }
+.admonitionblock td.icon .icon-caution:before { content: "\f06d"; color: #bf3400; }
+.admonitionblock td.icon .icon-important:before { content: "\f06a"; color: #bf0000; }
+
+.conum[data-value] { display: inline-block; color: #fff !important; background-color: #222222; -webkit-border-radius: 100px; border-radius: 100px; text-align: center; font-size: 0.75em; width: 1.67em; height: 1.67em; line-height: 1.67em; font-family:sans-serif, "Open Sans", "DejaVu Sans", sans-serif; font-style: normal; font-weight: bold; }
+.conum[data-value] * { color: #fff !important; }
+.conum[data-value] + b { display: none; }
+.conum[data-value]:after { content: attr(data-value); }
+pre .conum[data-value] { position: relative; top: -0.125em; }
+
+b.conum * { color: inherit !important; }
+
+
+.conum:not([data-value]):empty { display: none; }
+
+.literalblock pre, .listingblock pre { background: #eeeeee; }
+
+div#remarks.ulist {
+	max-width: 70%;
+}
+
+div.title:first-of-type {
+    display: none;
+}
+
+/* Mobile */
+
+@media only screen and (max-width: 800px) {
+	a#bottomright {visibility: hidden;}
+	.sectionbody.paragraph {max-width: 100%}
+	.paragraph.lead > p, #preamble > .sectionbody > .paragraph:first-of-type p { max-width: 100% }
+}
+
+#div.paragraph.faq-intro {
+	max-width: 66.66%
+}
+/* ========================================================================== Mobile Menu ======================================================================= */
+#menu {
+    display: none;
+    }
+
+div.slicknav_menu {
+    padding-top: 5px;
+    padding-right: 15px;
+    background-color: #132445;
+    margin-left: -2rem;
+    margin-right: -2rem;
+    text-align: right;
+    display: none;
+    right: 10px;
+    font-size: 1rem;
+    color: white;
+    padding-bottom: 2rem;
+    background: url("n4js-logo.png");
+    background-position: 10px 10px;
+    background-size: 344.48px 40px;
+    background-repeat: no-repeat;
+    background-color: #132445;
+}
+
+span.slicknav_menutxt {
+    margin-right: -20px;
+    color: white;
+}
+
+div.slicknav_menu a.scroll:first-of-type {
+    color: #F7D425;
+    font-size: 120%;
+    font-weight: 600;
+}
+div.slicknav_menu ul li a {
+    color: white;
+}
+div.slicknav_menu ul li a:hover {
+    color: #F7D425;
+}
+
+div.slicknav_menu a:hover {color: #F7D425; }
+div.slicknav_menu a:visited {color: white; }
+div.slicknav_menu a {color: white;}
+a.slicknav_btn  {
+    padding: 1rem;
+}
+
+
+li.slicknav_parent.slicknav_open {
+    color: white;
+}
+
+li.slicknav_parent.slicknav_open  {
+    color: white;
+}
+
+@media screen and (max-width: 890px) {
+    div.slicknav_menu {
+        display: block;
+        color: white
+    }
+    #mobile-banner {
+        display: block;
+    }
+}
+
+@media screen and (max-width: 470px) {
+div.slicknav_menu ul:first-of-type {
+    margin-top: 1.5rem;
+}
+
+div.slicknav_menu ul li {
+    color: white;
+}
+div.slicknav_menu ul li:hover {
+    color: #F7D425;
+}
+}
+div.slicknav_menu li:last-of-type
+    {
+        padding-bottom: 0.7rem;
+    }
+/* ========================================================================== NavMenu ======================================================================= */
+
+.banner {
+  height: 1rem;
+  padding-right: 2rem;
+  max-height: 1rem;  
+  max-width: 50%;
+  vertical-align: middle;
+
+  @media (max-width: 800px) {
+    flex-basis: 66.666%%;
+    max-width: 25%;
+    margin: 1rem;
+
+  }
+}
+
+
+div.box p { 
+text-indent: 0px; 
+position: absolute;
+display: none;
+}
+
+
+#menubar ul { margin: 0; padding: 0; white-space:nowrap; padding-left: 10px; padding-right: 10px; line-height: 2rem;}
+#menubar li { margin: 0; padding: 0;   }
+#menubar a { margin: 0; padding: 0;}
+#menubar ul {list-style: none; text-align: right;}
+#menubar a {text-decoration: none;}
+#menubar li {margin-left: 0;}
+#menubar {height: 70px; background-color: #132445; /* box-shadow: 0px 2px 3px rgba(0,0,0,.4); */ position: relative; padding-right: 2rem; margin-left: -2rem;  margin-right: -2rem;  color: white; font-size: 1.9rem;}
+
+
+#menubar > ul > li {
+
+    display:inline-block;
+    margin: 0.2rem;
+    position: relative;
+    z-index: 10000;
+    flex-basis: 66.666%%;
+    font-weight: 700;
+
+}
+
+@media only screen and (max-width: 890px) {
+
+#n4js-mobile-logo { 
+    position: absolute;
+    top: 0;
+    left: 0;
+    width: 178px;
+    height: 60px;
+    background-color: transparent;
+}
+
+div.box p { 
+text-indent: -999px; 
+position: absolute;
+}
+
+  #menubar > ul > li, #menubar {
+    visibility: hidden;
+    display: none;
+  }
+
+}
+
+@media only screen and (max-width: 500px) {
+
+
+
+
+#menubar {
+  display: none;
+}
+
+#logo {
+  margin-top: -55px;
+}
+
+}
+
+#logo {
+  height: 40px;
+  margin-left: 40px;
+  margin-top: 17px;
+  position: relative;
+  overflow: hidden;
+}
+
+#menubar > ul > li::after {
+    content: " · ";
+    position: relative;
+    top: 3px;
+    padding-left: 3px;
+    font-weight: 400;
+}
+
+#menubar > ul > li:last-of-type::after {
+  content: none;
+}
+#menubar > ul > li:last-of-type {
+  padding-right: -1rem;
+}
+
+#menubar > ul > li > a {
+    color: #FFFFFF;
+    font-size:  1.2rem;
+    line-height: 50px; 
+    font-weight: 400;
+    /* padding-top: 2rem; */
+    webkit-transition: color .15s;
+    -moz-transition: color .15s;
+    -o-transition: color .15s;
+    transition: color .15s;
+    white-space:nowrap; 
+    -webkit-font-smoothing: auto;
+    letter-spacing: -.01em;
+    padding-top: 0.2em;
+    padding-left: 0rem;
+    padding-right: 0.1rem;
+}
+
+#menubar > ul {
+    margin-right: 12px;
+    margin-top: 0px;
+}
+
+#menubar > ul > li > a:hover {color: #F7D425; }
+body.home li.home, body.tech li.tech {font-weight:bold; }
+
+#menubar > ul > li > ul {
+    opacity: 0;
+    visibility: hidden;
+    padding: 18px 0 20px 0;
+    background-color: #FFFFFF; /* rgb(15,26,54); top menu color */
+    text-align: left;
+    position: absolute;
+    top: 55px;
+    left: 50%;
+    margin-left: -200px;
+-webkit-transition: all .3s .1s;
+   -moz-transition: all .3s .1s;
+     -o-transition: all .3s .1s;
+        transition: all .3s .1s;
+-webkit-border-radius: 5px;
+   -moz-border-radius: 5px;
+        border-radius: 5px;
+-webkit-box-shadow: 0px 1px 3px rgba(0,0,0,.4);
+   -moz-box-shadow: 0px 1px 3px rgba(0,0,0,.4);
+        box-shadow: 0px 1px 3px rgba(0,0,0,.4);
+}
+
+#menubar > li li {
+    width:100%;
+}
+
+#menubar > ul > li:hover > ul {
+    opacity: 1;
+    top: 65px;
+    visibility: visible;
+}
+
+#menubar > ul > li > ul:before{
+    content: '';
+    display: block;
+    border-color: transparent transparent #FFFFFF transparent;
+    border-style: solid;
+    border-width: 10px;
+    position: absolute;
+    top: -20px;
+    left: 10%;
+    margin-left: -10px;
+}
+
+#menubar > ul ul > li { position: relative;}
+
+#menubar ul ul a{
+    color: rgb(50,50,50);
+    font-family:  sans-serif, Verdana, 'Lucida Grande';
+    font-size: 17px;
+    background-color: #FFFFFF; /* rgb(15,26,54); top menu color */
+    padding: 5px 8px 7px 16px;
+    display: block;
+-webkit-transition: background-color .1s;
+   -moz-transition: background-color .1s;
+     -o-transition: background-color .1s;
+        transition: background-color .1s;
+}
+
+#menubar ul ul a:hover {background-color: #244D82; color: #F7D425;}
+
+#menubar ul ul ul {
+    visibility: hidden;
+    opacity: 0;
+    position: absolute;
+    top: -16px;
+    left: 206px;
+    padding: 16px 0 20px 0;
+    background-color: #527AA3;
+    text-align: left;
+    width: 160px;
+-webkit-transition: all .3s;
+   -moz-transition: all .3s;
+     -o-transition: all .3s;
+        transition: all .3s;
+-webkit-border-radius: 5px;
+   -moz-border-radius: 5px;
+        border-radius: 5px;
+-webkit-box-shadow: 0px 1px 3px rgba(0,0,0,.4);
+   -moz-box-shadow: 0px 1px 3px rgba(0,0,0,.4);
+        box-shadow: 0px 1px 3px rgba(0,0,0,.4);
+}
+
+
+#menubar ul ul > li:hover > ul { opacity: 1; left: 196px; visibility: visible;}
+
+
+#menubar ul ul a:hover{
+    background-color: #244D82;
+    color: #F7D425;
+}
+
+
+.Cell--12-12 {
+    -webkit-flex-basis: 100%;
+    -ms-flex-preferred-size: 100%;
+    flex-basis: 100%;
+    max-width: 100%
+}
+
+.Grid {
+    display: -webkit-flex;
+    display: -ms-flexbox;
+    display: flex;
+    -webkit-align-items: stretch;
+    -ms-flex-align: stretch;
+    align-items: stretch;
+    -webkit-flex-wrap: wrap;
+    -ms-flex-wrap: wrap;
+    flex-wrap: wrap;
+    -webkit-flex: 0 1 auto;
+    -ms-flex: 0 1 auto;
+    flex: 0 1 auto;
+    -webkit-flex-direction: row;
+    -ms-flex-direction: row;
+    flex-direction: row
+}
+
+.Cell,
+.Comparison .Comparison-left,
+.Comparison .Comparison-right,
+.ExampleExplanation .ExampleExplanation-code,
+.ExampleExplanation .ExampleExplanation-text,
+.FeatureTabs .FeatureTabs-stage,
+.Intro .Intro-Slogan {
+    padding-left: 1rem;
+    padding-right: 1rem;
+    -webkit-flex: 0 0 auto;
+    -ms-flex: 0 0 auto;
+    flex: 0 0 auto
+}
+
+#_index, #_feature_table {display: none;}
+
+#_documentation {margin-top: -2rem;}
+
+h3 {padding-top: 1rem}
+
+/* ========================================================================== AsciiSpec ======================================================================= */
+.requirement {
+	border: 1px solid #aaaaaa;
+	padding: 0.5em;
+	margin-bottom: 1rem;
+}
+
+.bibliography .content .paragraph p :first-child::before { 
+	color:#777777;
+	content: "[" attr(id) "] "; }
+
+.bibliography .content .paragraph {
+	padding-left: 6em;
+	text-indent: -6em;
\ No newline at end of file
diff --git a/design/styles/n4jsspec-adoc.css b/design/styles/n4jsspec-adoc.css
new file mode 100644
index 0000000..598cae4
--- /dev/null
+++ b/design/styles/n4jsspec-adoc.css
@@ -0,0 +1,1292 @@
+@import url("backtotop.css");
+
+/* ========================================================================== HTML5 display definitions ========================================================================== */
+/** Correct `block` display not defined in IE 8/9. */
+@import url(https://fast.fonts.net/cssapi/20974f8a-0939-4574-aef9-681eda2faca8.css);
+article, aside, details, figcaption, figure, footer, header, hgroup, main, nav, section, summary { display: block; }
+
+/** Correct `inline-block` display not defined in IE 8/9. */
+audio, canvas, video { display: inline-block; }
+
+/** Prevent modern browsers from displaying `audio` without controls. Remove excess height in iOS 5 devices. */
+audio:not([controls]) { display: none; height: 0; }
+
+/** Address `[hidden]` styling not present in IE 8/9. Hide the `template` element in IE, Safari, and Firefox < 22. */
+[hidden], template { display: none; }
+
+script { display: none !important; }
+
+/* ========================================================================== Base ========================================================================== */
+/** 1. Set default font family to sans-serif. 2. Prevent iOS text size adjust after orientation change, without disabling user zoom. */
+html { /* 1 */ -ms-text-size-adjust: 100%; /* 2 */ -webkit-text-size-adjust: 100%; /* 2 */ background-color: #D5DFEA; }
+
+/** Remove default margin. */
+body { margin: 0; background-color: #D5DFEA; font-family:sans-serif; font-weight: 400} /* add margin-right 0 here for mobile*/
+
+/* ========================================================================== Links ========================================================================== */
+/** Remove the gray background color from active links in IE 10. */
+a { background: transparent; }
+
+/** Address `outline` inconsistency between Chrome and other browsers. */
+a:focus { outline: thin dotted; }
+
+/** Improve readability when focused and also mouse hovered in all browsers. */
+a:active, a:hover { outline: 0; }
+
+/* ========================================================================== Typography ========================================================================== */
+/** Address variable `h1` font-size and margin within `section` and `article` contexts in Firefox 4+, Safari 5, and Chrome. */
+h1 { font-size: 2em; margin: 0.67em 0; }
+
+/** Address styling not present in IE 8/9, Safari 5, and Chrome. */
+abbr[title] { border-bottom: 1px dotted; }
+
+/** Address style set to `bolder` in Firefox 4+, Safari 5, and Chrome. */
+b, strong { font-weight: 600; }
+
+/** Address styling not present in Safari 5 and Chrome. */
+dfn { font-style: italic; }
+
+/** Address differences between Firefox and other browsers. */
+hr { -moz-box-sizing: content-box; box-sizing: content-box; height: 0; }
+
+/** Address styling not present in IE 8/9. */
+mark { background: #ff0; color: #000; }
+
+/** Correct font family set oddly in Safari 5 and Chrome. */
+code, kbd, pre, samp { font-family: Fira Mono, monospace, serif; font-size: 1em; }
+
+/** Improve readability of pre-formatted text in all browsers. */
+pre { white-space: pre-wrap; }
+
+/** Set consistent quote types. */
+q { quotes: "\201C" "\201D" "\2018" "\2019"; }
+
+/** Address inconsistent and variable font size in all browsers. */
+small { font-size: 80%; }
+
+/** Prevent `sub` and `sup` affecting `line-height` in all browsers. */
+sub, sup { font-size: 75%; line-height: 0; position: relative; vertical-align: baseline; }
+
+sup { top: -0.5em; }
+
+sub { bottom: -0.25em; }
+
+/* ========================================================================== Embedded content ========================================================================== */
+/** Remove border when inside `a` element in IE 8/9. */
+img { border: 0; }
+
+/** Correct overflow displayed oddly in IE 9. */
+svg:not(:root) { overflow: hidden; }
+
+/* ========================================================================== Figures ========================================================================== */
+/** Address margin not present in IE 8/9 and Safari 5. */
+figure { margin: 0; }
+
+/* ========================================================================== Forms ========================================================================== */
+/** Define consistent border, margin, and padding. */
+fieldset { border: 1px solid #c0c0c0; margin: 0 2px; padding: 0.35em 0.625em 0.75em; }
+
+/** 1. Correct `color` not being inherited in IE 8/9. 2. Remove padding so people aren't caught out if they zero out fieldsets. */
+legend { border: 0; /* 1 */ padding: 0; /* 2 */ }
+
+/** 1. Correct font family not being inherited in all browsers. 2. Correct font size not being inherited in all browsers. 3. Address margins set differently in Firefox 4+, Safari 5, and Chrome. */
+button, input, select, textarea { font-family: inherit; /* 1 */ font-size: 100%; /* 2 */ margin: 0; /* 3 */ }
+
+/**
+#tocbutton {
+	top: 0;
+	left: 13rem;
+	position:fixed;
+	z-index: 1000;
+}
+*/
+/** Address Firefox 4+ setting `line-height` on `input` using `!important` in the UA stylesheet. */
+button, input { line-height: normal; }
+
+/** Address inconsistent `text-transform` inheritance for `button` and `select`. All other form control elements do not inherit `text-transform` values. Correct `button` style inheritance in Chrome, Safari 5+, and IE 8+. Correct `select` style inheritance in Firefox 4+ and Opera. */
+button, select { text-transform: none; }
+
+/** 1. Avoid the WebKit bug in Android 4.0.* where (2) destroys native `audio` and `video` controls. 2. Correct inability to style clickable `input` types in iOS. 3. Improve usability and consistency of cursor style between image-type `input` and others. */
+button, html input[type="button"], input[type="reset"], input[type="submit"] { -webkit-appearance: button; /* 2 */ cursor: pointer; /* 3 */ }
+
+/** Re-set default cursor for disabled elements. */
+button[disabled], html input[disabled] { cursor: default; }
+
+/** 1. Address box sizing set to `content-box` in IE 8/9. 2. Remove excess padding in IE 8/9. */
+input[type="checkbox"], input[type="radio"] { box-sizing: border-box; /* 1 */ padding: 0; /* 2 */ }
+
+/** 1. Address `appearance` set to `searchfield` in Safari 5 and Chrome. 2. Address `box-sizing` set to `border-box` in Safari 5 and Chrome (include `-moz` to future-proof). */
+input[type="search"] { -webkit-appearance: textfield; /* 1 */ -moz-box-sizing: content-box; -webkit-box-sizing: content-box; /* 2 */ box-sizing: content-box; }
+
+/** Remove inner padding and search cancel button in Safari 5 and Chrome on OS X. */
+input[type="search"]::-webkit-search-cancel-button, input[type="search"]::-webkit-search-decoration { -webkit-appearance: none; }
+
+/** Remove inner padding and border in Firefox 4+. */
+button::-moz-focus-inner, input::-moz-focus-inner { border: 0; padding: 0; }
+
+/** 1. Remove default vertical scrollbar in IE 8/9. 2. Improve readability and alignment in all browsers. */
+textarea { overflow: auto; /* 1 */ vertical-align: top; /* 2 */ }
+
+/* ========================================================================== Tables ========================================================================== */
+/** Remove most spacing between table cells. */
+table { border-collapse: collapse; border-spacing: 0; }
+
+meta.foundation-mq-small { font-family: "only screen and (min-width: 768px)"; width: 768px; }
+
+meta.foundation-mq-medium { font-family: "only screen and (min-width:1280px)"; width: 1280px; }
+
+meta.foundation-mq-large { font-family: "only screen and (min-width:1440px)"; width: 1440px; }
+
+*, *:before, *:after { -moz-box-sizing: border-box; -webkit-box-sizing: border-box; box-sizing: border-box; }
+
+html, body {  background-color:#527AA3; }
+
+body {  background: white; color: #222222;   padding: ; margin: 0; font-family:sans-serif, Helvetica, Arial, sans-serif; font-weight: 400; font-style: normal; position: relative; cursor: auto; padding-left: 2rem; padding-right: 2rem;}
+
+
+a:hover { cursor: pointer; }
+
+img, object, embed {  height: auto; max-width: 90%; }
+
+
+object, embed { height: 100%; }
+
+img { -ms-interpolation-mode: bicubic; }
+
+#map_canvas img, #map_canvas embed, #map_canvas object, .map_canvas img, .map_canvas embed, .map_canvas object { max-width: none !important; }
+
+.left { float: left !important; }
+
+.right { float: right !important; }	
+
+.text-left { text-align: left !important; }
+
+.text-right { text-align: right !important; }
+
+.text-center { text-align: center !important; }
+
+.text-justify { text-align: justify !important; }
+
+.hide { display: none; }
+
+.antialiased, body { -webkit-font-smoothing: antialiased; }
+
+img { display: inline-block; vertical-align: baseline; }
+
+textarea { height: auto; min-height: 50px; }
+
+select { width: 100%; }
+
+object, svg { display: inline-block; vertical-align: middle; }
+
+.center { margin-left: auto; margin-right: auto; }
+
+.spread { width: 100%; margin-right: 2rem; }
+
+p.lead, .paragraph.lead > p, #preamble > .sectionbody > .paragraph:first-of-type p { font-size: 1em; line-height: 1.6;  }
+
+
+/* Typography padding etc */
+.subheader, .admonitionblock td.content > .title, .audioblock > .title, .exampleblock > .title, .imageblock > .title, .listingblock > .title, .literalblock > .title, .stemblock > .title, .openblock > .title, .paragraph > .title, .quoteblock > .title, table.tableblock > .title, .verseblock > .title, .videoblock > .title, .dlist > .title, .olist > .title, .ulist > .title, .qlist > .title, .hdlist > .title { line-height: 2.4; color: #132445; font-weight: 400; margin-top: 0em; margin-bottom: 0.5em;  }
+
+
+/* Typography resets */
+div, dl, dt, dd, ul, ol, li, h1, h2, h3, #toctitle, .sidebarblock > .content > .title, h4, h5, h6, pre, form, p, blockquote, th, td { margin: 0; padding: 0; direction: ltr; }
+div.openblock.partintro, div.sectionbody.paragraph {font-weight: 500;  line-height: 1.4; margin-bottom: 1em; }
+div.sect1 {
+	padding-top: 1rem;
+	padding-right: 1rem;
+}
+
+div.paragraph.faq-intro {max-width: 66%;}
+
+
+/* Default Link Styles */
+a { color: #6999d6; text-decoration: none; line-height: inherit;  }
+a:hover, a:focus { color: #132445; }
+a img { border: none; }
+
+
+/* Grey links with black transition 
+
+a { color: #2ba6cb; text-decoration: none; line-height: inherit; color: rgba(0,0,0,.3); transition: .2s; }
+a:active, a:hover, a:focus { color: #212121; }
+a img { border: none; }
+
+*/
+
+
+
+/* Default paragraph styles */
+p { font-family:sans-serif; font-weight: 400; font-size: 1.2rem; line-height: 1.4; padding-bottom: 0.5em;    }
+p aside { font-size: 0.575em; line-height: 1.35; font-style: italic; }
+div.p, { width: 100% }
+
+
+/* Default header styles */
+h1, h2, h3, #toctitle, .sidebarblock > .content > .title, h4, h5, h6 { font-family: sans-serif; font-weight: 600; font-style: normal; color: #244d82; text-rendering: optimizeLegibility; margin-bottom: 0em; line-height: 1.2125em; margin-top:; 2rem;  }
+h1 small, h2 small, h3 small, #toctitle small, .sidebarblock > .content > .title small, h4 small, h5 small, h6 small { font-size: 60%; color: #6999d6; line-height: 0; }
+
+h1 { font-size: 2.125em; max-width:66.66%;}
+
+h2 { font-size: 1.6875em; }
+
+h3, #toctitle, .sidebarblock > .content > .title { font-size: 1.375em; }
+
+h4 { font-size: 1.125em; }
+
+h5 { font-size: 1.125em; }
+
+h6 { font-size: 1em; }
+
+hr { border: solid #dddddd; border-width: 1px 0 0; clear: both; margin: 1.25em 0 1.1875em; height: 0; }
+
+/* Helpful Typography Defaults */
+em, i { font-style: italic; line-height: inherit; }
+
+strong, b { font-weight: 600; line-height: inherit; }
+
+small { font-size: 60%; line-height: inherit; }
+
+code { font-family: Fira Mono, Consolas, "Liberation Mono", Courier, monospace;  }
+
+/* Lists */
+ul, ol, dl {  list-style-position: outside; font-family:sans-serif; padding-left: 0rem; list-style-type: none}
+
+ul, ol { margin-left: 0em;  }
+ul.no-bullet, ol.no-bullet { margin-left: 1.5em;  margin-bottom: 0;}
+
+/* Unordered Lists */
+ul li ul, ul li ol { margin-left: 1.25em; margin-bottom: 0; font-size: 1em; /* Override nested font-size change */  }
+ul.square li ul, ul.circle li ul, ul.disc li ul { list-style: inherit; }
+ul.square { list-style-type: square; }
+ul.circle { list-style-type: circle; }
+ul.disc { list-style-type: none; }
+ul.no-bullet { list-style: none; }
+
+/* Ordered Lists */
+ol li ul, ol li ol { margin-left: 1.25em; margin-bottom: 0;   }
+
+/* Definition Lists */
+dl dt { margin-bottom: 0.3125em; font-weight: bold; font-size: 1.2em; font-style: italic}
+dl dd { margin-bottom: 1.25em; }
+
+/* Abbreviations */
+abbr, acronym { text-transform: uppercase; font-size: 90%; color: #222222; border-bottom: 1px dotted #dddddd; cursor: help; }
+
+abbr { text-transform: none; }
+
+/* Blockquotes */
+blockquote { margin: 0 0 1.25em; padding: 0.5625em 1.25em 0 1.1875em; border-left: 1px solid #dddddd; }
+blockquote cite { display: block; font-size: inherit; color: color: #132445; }
+blockquote cite:before { content: "\2014 \0020"; }
+blockquote cite a, blockquote cite a:visited { color: #417dcb; }
+
+blockquote, blockquote p { line-height: 1.6; color: #132445; }
+
+/* Microformats */
+.vcard { display: inline-block; margin: 0 0 1.25em 0; border: 1px solid #dddddd; padding: 0.625em 0.75em; }
+.vcard li { margin: 0; display: block; }
+.vcard .fn { font-weight: bold; font-size: 0.9375em; }
+
+.vevent .summary { font-weight: bold; }
+.vevent abbr { cursor: auto; text-decoration: none; font-weight: bold; border: none; padding: 0 0.0625em; }
+
+@media only screen and (min-width: 768px) { h1, h2, h3, #toctitle, .sidebarblock > .content > .title, h4, h5, h6 { line-height: 1.4;  margin-top: 1rem; margin-bottom: 0.2rem;}
+  h1 { font-size: 2.75em; }
+  h2 { font-size: 2.3125em; }
+  h3, #toctitle, .sidebarblock > .content > .title { font-size: 1.6875em; }
+  h4 { font-size: 1.4375em; } }
+
+/* Tables */
+table { background: white; margin-bottom: 1.25em; border: solid 1px #dddddd; }
+table thead, table tfoot { background: whitesmoke; font-weight: 600; }
+table thead tr th, table thead tr td, table tfoot tr th, table tfoot tr td { padding: 0.5em 0.625em 0.625em; font-size: inherit; color: #222222; text-align: left; }
+table tr th, table tr td { padding: 0.5625em 0.625em; font-size: inherit; color: #222222; }
+table tr.even, table tr.alt, table tr:nth-of-type(even) { background: #f9f9f9; }
+table thead tr th, table tfoot tr th, table tbody tr td, table tr td, table tfoot tr td { display: table-cell; line-height: 1.4; }
+
+/* FEATURE TABLE */
+
+table.done, tr.done.alt, table.done tr:nth-of-type(even) {
+	background: #efe;
+	padding-top: 0;
+	padding-bottom: 0;
+	border: none;
+	margin-bottom: -1px;
+}
+
+table.most, tr.most.alt, table.most tr:nth-of-type(even) {
+	background: #ffd;
+	padding-top: 0;
+	padding-bottom: 0;
+	border: none;
+	margin-bottom: -1px;
+}
+
+table.tbc, tr.tbc.alt, table.tbc tr:nth-of-type(even) {
+	background: #fff6de;
+	padding-top: 0;
+	padding-bottom: 0;
+	border: none;
+	margin-bottom: -1px;
+}
+
+table.tbd, tr.tbd.alt, table.tbd tr:nth-of-type(even) {
+	background: #fee;
+	padding-top: 0;
+	padding-bottom: 0;
+	border: none;
+	margin-bottom: -1px;
+}
+
+table.done thead tr th, table.done tfoot tr th, table.done tfoot tr td, table.done.sect2, table.most thead tr th, table.most tfoot tr th, table.most tfoot tr td, table.most.sect2, table.tbc thead tr th, table.tbc tfoot tr th, table.tbc tfoot tr td, table.tbc.sect2, table.tbd thead tr th, table.tbd tfoot tr th, table.tbd tfoot tr td, table.tbd.sect2 {background: white; font-size: 1.9rem; color: #417dcb; }
+
+
+
+/* 
+green "done" = #efe
+yellow "most" = #ffd
+orange "tbc" = #fff6de
+red "tbd" = #fee
+ */
+
+
+
+body { tab-size: 4; max-width: 1250px; margin-right: auto; margin-left: auto; position: relative; margin-top: 0rem; margin-bottom: 0rem; padding-top: 0rem; /*  Fixes tables, breaks headers */}
+
+h1, h2, h3, #toctitle, .sidebarblock > .content > .title, h4, h5, h6 { line-height: 1.4;  margin-top: 0rem;}
+
+.clearfix:before, .clearfix:after, .float-group:before, .float-group:after { content: " "; display: table; }
+.clearfix:after, .float-group:after { clear: both; }
+
+*:not(pre) > code { font-size: inherit; font-style: normal !important; letter-spacing: 0; padding: 0; line-height: inherit; }
+
+pre, pre > code { line-height: 1.4; color: black; font-family: monospace, serif; font-weight: normal; }
+
+.keyseq { color: #555555; }
+
+kbd { font-family: Consolas, "Liberation Mono", Courier, monospace; display: inline-block; color: #222222; font-size: 0.65em; line-height: 1.45; background-color: #f7f7f7; border: 1px solid #ccc; -webkit-border-radius: 3px; border-radius: 3px; -webkit-box-shadow: 0 1px 0 rgba(0, 0, 0, 0.2), 0 0 0 0.1em white inset; box-shadow: 0 1px 0 rgba(0, 0, 0, 0.2), 0 0 0 0.1em white inset; margin: 0 0.15em; padding: 0.2em 0.5em; vertical-align: middle; position: relative; top: -0.1em; white-space: nowrap; }
+
+.keyseq kbd:first-child { margin-left: 0; }
+
+.keyseq kbd:last-child { margin-right: 0; }
+
+.menuseq, .menu { color: #090909; }
+
+b.button:before, b.button:after { position: relative; top: -1px; font-weight: normal; }
+
+b.button:before { content: "["; padding: 0 3px 0 2px; }
+
+b.button:after { content: "]"; padding: 0 2px 0 3px; }
+
+#header, #content, #footnotes, #footer {  
+	max-width: 1050px; margin-right: auto; margin-left: auto; position: relative; 
+	margin-top: 0rem; margin-bottom: 0rem; 
+	padding-top: 0rem;  padding-right: 1rem;}
+#header:before, #header:after, #content:before, #content:after, #footnotes:before, #footnotes:after, #footer:before, #footer:after { content: " "; display: table; }
+#header:after, #content:after, #footnotes:after, #footer:after { clear: both; }
+
+
+#content:before { content: none; }
+#content {padding-left: 0.5rem;}
+
+#header > h1:first-child { color: black; font-weight: bold; margin-top: 2.25rem; margin-bottom: 0; }
+#header > h1:first-child + #toc { margin-top: 8px; border-top: 1px solid #dddddd; }
+#header > h1:only-child, body.toc2 #header > h1:nth-last-child(2) { border-bottom: 1px solid #dddddd; padding-bottom: 8px; }
+#header .details { border-bottom: 1px solid #dddddd; line-height: 1.45; padding-top: 0.25em; padding-bottom: 0.25em; padding-left: 0.25em; color: #417dcb; display: -ms-flexbox; display: -webkit-flex; display: flex; -ms-flex-flow: row wrap; -webkit-flex-flow: row wrap; flex-flow: row wrap; }
+#header .details span:first-child { margin-left: -0.125em; }
+#header .details span.email a { color: #6999d6; }
+#header .details br { display: none; }
+#header .details br + span:before { content: "\00a0\2013\00a0"; }
+#header .details br + span.author:before { content: "\00a0\22c5\00a0"; color: #6999d6; }
+#header .details br + span#revremark:before { content: "\00a0|\00a0"; }
+#header #revnumber { text-transform: capitalize; }
+#header #revnumber:after { content: "\00a0"; }
+
+#content > h1:first-child:not([class]) { color: black; font-weight: bold; border-bottom: 1px solid #dddddd; max-width: 1050px; margin-right: auto; margin-left: auto; position: relative; margin-top: 4rem; margin-bottom: 4rem; padding-top: 0rem;   }
+
+/* ========================================================================== Table of Contents ======================================================================= */
+
+
+
+#toc { border-bottom: 1px solid #dddddd; padding-bottom: 0.5em; position: relative; left: 0;}
+#toc > ul { margin-left: 0.125em; padding-left: 1em; }
+#toc ul.sectlevel0 > li > a { font-style: italic; }
+#toc ul.sectlevel0 ul.sectlevel1 { margin: 0.5em 0; }
+#toc ul { font-family: "Helvetica Neue", "Helvetica", Helvetica, Arial, sans-serif; list-style-type: none; }
+#toc li { line-height: 1.3334; margin-top: 0.3334em; }
+#toc a { text-decoration: none; }
+#toc a:active { text-decoration: underline; }
+
+#toc ul li:before {
+    /* content: "›"; */
+    margin-left: -.75em;
+    margin-right: .4em;
+    color: #244d82
+}
+
+
+
+div.ulist li:before {
+    content: "›";
+    position: absolute;
+    margin-top: .2rem;
+    font-size: x-large;
+    margin-left: -.75em;
+    margin-bottom: -.75em;
+    margin-right: 0;
+    line-height: 1rem;
+    color: #244d82
+
+}
+
+
+#toctitle { color: #244d82; font-size: 1.2em; padding-left: 1em; }
+
+#faq {
+	position: relative;
+	right: 9.3rem;
+    top: 9rem;
+	margin-bottom: 20px;
+	left: 45rem;
+	z-index:1;padding-left:2rem;border-left:1px solid #d3d3d3
+
+}
+@media only screen and (max-width: 945px) {
+	div#faq { display: none; }
+}
+
+#faq h2 {
+	font-size: 25px;
+	font-weight: 600;
+	margin-top: -8rem;
+}
+
+div#faq li:before {
+    content: "›";
+    position: absolute;
+    font-size: x-large;
+    margin-left: -.75em;
+    margin-bottom: -.75em;
+    margin-right: 0;
+    line-height: 1rem;
+    color: #244d82
+}
+
+#features-nav {
+	position: absolute;
+	right: 1rem;
+	top: 2rem;
+	margin-bottom: 20px;
+	position:absolute;z-index:1;padding-left:2rem;border-left:1px solid #d3d3d3
+}
+
+@media only screen and (max-width: 993px) {
+	#features-nav { display: none; }
+}
+
+#features-nav h2 {
+	font-size: 25px;
+	font-weight: 600;
+	margin-top: -1rem;
+}
+#features-nav li {
+	margin-top: .3rem;
+}
+
+div#features-nav li:before {
+    content: "›";
+    position: absolute;
+    font-size: x-large;
+    margin-left: -.75em;
+    margin-bottom: -.75em;
+    margin-right: 0;
+    line-height: 1rem;
+    color: #244d82
+}
+
+
+
+@media only screen and (min-width: 1434px ) { 
+	body.toc2.toc-right #toc.toc2 { border-right-width: 0; border: none; left: 0px; }
+	#toctitle { padding-top: 1.5rem; font-size: 1.375em; }
+	body.toc2 { padding-left: 2em; padding-right: 1em; }
+	#toc.toc2 { margin-top: 0 !important; background-color: #f2f2f2; position: fixed; width: 12em; left: 0; top: 0; border-right: 1px solid #dddddd; border-top-width: 0 !important; border-bottom-width: 0 !important; z-index: 1000; padding: 1.25em 0.25em 0em 0.25em; height: 100%; overflow: auto; }
+	#toc.toc2 #toctitle { margin-top: 0; margin-bottom: 0.8rem; font-size: 1.2em; padding-left: 1em;}
+	#toc.toc2 > ul { font-size: 0.9em; margin-bottom: 0; }
+	#toc.toc2 ul ul { margin-left: 1em; padding-left: .3em; }
+	#toc.toc2 ul.sectlevel0 ul.sectlevel1 { padding-left: 0; margin-top: 0.5em; margin-bottom: 0.5em; }
+	body.toc2.toc-right { padding-left: 2em; padding-right: 2em; }
+	body.toc2.toc-right #toc.toc2 { border-right-width: 0; border-left: 1px solid #dddddd; left: auto; right: -13rem; } 
+}
+@media only screen and (min-width: 1535px) { 
+	body.toc2 { padding-left: 2em; padding-right: 2em; }
+	#toctitle { padding-top: 0rem; font-size: 1.375em; }
+	#toc.toc2 { width: 13em; }
+	
+	#toc.toc2 #toctitle { font-size: 1.375em; }
+	
+	#toc.toc2 > ul { font-size: 0.95em; }
+	#toc.toc2 ul ul { padding-left: 0; }
+	body.toc2.toc-right { padding-left: 2em; padding-right: 2em; } 
+}
+
+#content #toc { border-style: solid; border-width: 1px; border-color: #d9d9d9; margin-bottom: 1.25em; padding: 1.25em; background: #f2f2f2; -webkit-border-radius: 0; border-radius: 0; }
+#content #toc > :first-child { margin-top: 0; }
+#content #toc > :last-child { margin-bottom: 0; }
+
+
+
+div.social  { line-height: 1.4; color: #FFFFFF;font-size:  1.2rem; font-weight: 400; font-style: bold; background-color: #132445; margin-right: -2rem; margin-left: -2rem; text-align: left; padding-bottom: 4px; padding-left: 25px; }
+div.social li a {  margin-bottom: 2em;  color: #d5dfea;font-size:  1.2rem; font-weight: 800; font-style: bold; list-style: none; list-style-type: none; text-decoration-color: rgb(213, 223, 234); }
+/* div.social a:visited { color: #244D82; }*/
+div.social a:hover { color: #F7D425; }
+div.social :first-child { margin-top: 0; }
+div.social h2 {        margin-bottom: 20px;font-weight: 600;font-size: 1.3em;margin-top: 4rem;color: #244d82;font-family: sans-serif;}
+div.social li:before {content: "› "; color: #244d82;font-size: large;font-weight: 800;}
+div.social ul {margin-top: -10px;line-height: 30px;}
+div.social li {/* nothing */}
+
+#bottomright {float: right;}
+
+
+
+
+
+#footer-text { color: #dddddd; line-height: 1.44; }
+
+
+.sect1 { padding-bottom: 0.625em; }
+.sectionbody.paragraph {max-width: 66.666%}
+.sectionbody ul {padding-left: 1rem;}
+
+@media only screen and (min-width: 768px) { .sect1 { padding-bottom: 0em; } }
+.sect1 + .sect1 { border-top: 0px solid #dddddd; }
+
+#content h1 > a.anchor, h2 > a.anchor, h3 > a.anchor, #toctitle > a.anchor, .sidebarblock > .content > .title > a.anchor, h4 > a.anchor, h5 > a.anchor, h6 > a.anchor { position: absolute; z-index: 1001; width: 1.5ex; margin-left: -1.5ex; display: block; text-decoration: none !important; visibility: hidden; text-align: center; font-weight: 400; max-width: 1050px; }
+#content h1 > a.anchor:before, h2 > a.anchor:before, h3 > a.anchor:before, #toctitle > a.anchor:before, .sidebarblock > .content > .title > a.anchor:before, h4 > a.anchor:before, h5 > a.anchor:before, h6 > a.anchor:before { content: "\2771"; font-size: 0.85em; display: block; padding-top: 0.1em; vertical-align: bas }
+#content h1:hover > a.anchor, #content h1 > a.anchor:hover, h2:hover > a.anchor, h2 > a.anchor:hover, h3:hover > a.anchor, #toctitle:hover > a.anchor, .sidebarblock > .content > .title:hover > a.anchor, h3 > a.anchor:hover, #toctitle > a.anchor:hover, .sidebarblock > .content > .title > a.anchor:hover, h4:hover > a.anchor, h4 > a.anchor:hover, h5:hover > a.anchor, h5 > a.anchor:hover, h6:hover > a.anchor, h6 > a.anchor:hover { visibility: visible; }
+#content h1 > a.link, h2 > a.link, h3 > a.link, #toctitle > a.link, .sidebarblock > .content > .title > a.link, h4 > a.link, h5 > a.link, h6 > a.link { color: #244d82; text-decoration: none; font-family:  sans-serif}
+#content h1 > a.link:hover, h2 > a.link:hover, h3 > a.link:hover, #toctitle > a.link:hover, .sidebarblock > .content > .title > a.link:hover, h4 > a.link:hover, h5 > a.link:hover, h6 > a.link:hover { color: #1e416e; }
+
+.audioblock, .imageblock, .literalblock, .listingblock, .stemblock, .videoblock { margin-bottom: 1.25em; }
+
+.admonitionblock td.content > .title, .audioblock > .title, .exampleblock > .title, .imageblock > .title, .listingblock > .title, .literalblock > .title, .stemblock > .title, .openblock > .title, .paragraph > .title, .quoteblock > .title, table.tableblock > .title, .verseblock > .title, .videoblock > .title, .dlist > .title, .olist > .title, .ulist > .title, .qlist > .title, .hdlist > .title { text-rendering: optimizeLegibility; text-align: left;   }
+
+table.tableblock > caption.title { white-space: nowrap; overflow: visible; max-width: 0;  }
+
+.paragraph.lead > p, #preamble > .sectionbody > .paragraph:first-of-type p { color: black; max-width: 66%}
+
+table.tableblock #preamble > .sectionbody > .paragraph:first-of-type p { font-size: inherit; }
+
+.admonitionblock > table { border-collapse: separate; border: 0; background: none; max-width: 80%;}
+.admonitionblock > table td.icon { text-align: center; width: 80px; }
+.admonitionblock > table td.icon img { max-width: none; }
+.admonitionblock > table td.icon .title { font-weight: bold; font-family:  sans-serif, Georgia, Verdana, "Helvetica", Helvetica, Arial, sans-serif; text-transform: uppercase; }
+.admonitionblock > table td.content { padding-left: 1.125em; padding-right: 1.25em; border-left: 1px solid #dddddd; color: #417dcb; }
+.admonitionblock > table td.content > :last-child > :last-child { margin-bottom: 0; }
+
+.exampleblock > .content { border-style: solid; border-width: 1px; border-color: #e6e6e6; margin-bottom: 1.25em; padding: 1.25em; background-color: #fffef7; -webkit-border-radius: 0; border-radius: 0; }
+.exampleblock > .content > :first-child { margin-top: 0; }
+.exampleblock > .content > :last-child { margin-bottom: 0; }
+
+.sidebarblock { position: absolute; border-style: solid; border-width: 1px; border-color: #d9d9d9; margin: -2rem -7.5rem 0rem 63.65rem; padding: .2rem; background: #f2f2f2; -webkit-border-radius: 0; border-radius: 0; text-align: left; width: 5.5rem;}
+.sidebarblock > :first-child { margin-top: 0; }
+.sidebarblock > :last-child { margin-bottom: 0; }
+.sidebarblock > .content > .title { color: #6999d6; margin-top: 0; }
+
+@media only screen and (max-width: 1203px) { 
+.sidebarblock { position: absolute; right: 12%; }
+}
+@media only screen and (max-width: 817px) { 
+.sidebarblock { position: absolute; right: 18%; }
+}
+
+@media only screen and (max-width: 562px) { 
+.sidebarblock { position: absolute; right: 25%; }
+}
+
+.exampleblock > .content > :last-child > :last-child, .exampleblock > .content .olist > ol > li:last-child > :last-child, .exampleblock > .content .ulist > ul > li:last-child > :last-child, .exampleblock > .content .qlist > ol > li:last-child > :last-child, .sidebarblock > .content > :last-child > :last-child, .sidebarblock > .content .olist > ol > li:last-child > :last-child, .sidebarblock > .content .ulist > ul > li:last-child > :last-child, .sidebarblock > .content .qlist > ol > li:last-child > :last-child { margin-bottom: 0; }
+
+.literalblock pre, .listingblock pre:not(.highlight), .listingblock pre[class="highlight"], .listingblock pre[class^="highlight "], .listingblock pre.CodeRay, .listingblock pre.prettyprint { background: #eeeeee; }
+.sidebarblock .literalblock pre, .sidebarblock .listingblock pre:not(.highlight), .sidebarblock .listingblock pre[class="highlight"], .sidebarblock .listingblock pre[class^="highlight "], .sidebarblock .listingblock pre.CodeRay, .sidebarblock .listingblock pre.prettyprint { background: #f2f1f1; }
+
+.literalblock pre, .literalblock pre[class], .listingblock pre, .listingblock pre[class] { border: 1px solid #cccccc; -webkit-border-radius: 0; border-radius: 0; word-wrap: break-word; padding: 0.8em 0.8em 0.65em 0.8em; font-size: 0.8125em; }
+.literalblock pre.nowrap, .literalblock pre[class].nowrap, .listingblock pre.nowrap, .listingblock pre[class].nowrap { overflow-x: auto; white-space: pre; word-wrap: normal; }
+@media only screen and (min-width: 768px) { .literalblock pre, .literalblock pre[class], .listingblock pre, .listingblock pre[class] { font-size: 0.90625em; } }
+@media only screen and (min-width: 1280px) { .literalblock pre, .literalblock pre[class], .listingblock pre, .listingblock pre[class] { font-size: 1em; } }
+
+.literalblock.output pre { color: #eeeeee; background-color: black; }
+
+.listingblock pre.highlightjs { padding: 0;  margin-right: 0em; }
+.listingblock pre.highlightjs > code { padding: 0.8em 2rem 0.65em 0.8em; -webkit-border-radius: 0; border-radius: 0; padding-right: 2rem;}
+
+.listingblock > .content { position: relative; }
+
+.listingblock code[data-lang]:before { display: none; content: attr(data-lang); position: absolute; font-size: 0.75em; top: 0.425rem; right: 0.5rem; line-height: 1; text-transform: uppercase; color: #999; padding-right: 2rem; }
+
+.listingblock:hover code[data-lang]:before { display: none; }
+
+.listingblock.terminal pre .command:before { content: attr(data-prompt); padding-right: 0.5em; color: #999; }
+
+.listingblock.terminal pre .command:not([data-prompt]):before { content: "$"; }
+
+table.pyhltable { border-collapse: separate; border: 0; margin-bottom: 0; background: none; }
+
+table.pyhltable td { vertical-align: top; padding-top: 0; padding-bottom: 0; line-height: 1.4; }
+
+table.pyhltable td.code { padding-left: .75em; padding-right: 0; }
+
+pre.pygments .lineno, table.pyhltable td:not(.code) { color: #999; padding-left: 0; padding-right: .5em; border-right: 1px solid #dddddd; }
+
+pre.pygments .lineno { display: inline-block; margin-right: .25em; }
+
+table.pyhltable .linenodiv { background: none !important; padding-right: 0 !important; }
+
+.quoteblock { margin: 0 1em 1.25em 1.5em; display: table; }
+.quoteblock > .title { margin-left: -1.5em; margin-bottom: 0.75em; }
+.quoteblock blockquote, .quoteblock blockquote p { color: #132445; font-size: 1.15rem; line-height: 1.75; word-spacing: 0.1em; letter-spacing: 0; font-style: italic; text-align: justify; }
+.quoteblock blockquote { margin: 0; padding: 1rem; border: 0; }
+.quoteblock blockquote:before { content: "\201c"; float: left; font-size: 2.75em; font-weight: bold; line-height: 0.6em; margin-left: -0.6em; color: #6999d6; text-shadow: 0 1px 2px rgba(0, 0, 0, 0.1); }
+.quoteblock blockquote > .paragraph:last-child p { margin-bottom: 0; }
+.quoteblock .attribution { margin-top: 1em; margin-right: 0.5ex; text-align: right; }
+.quoteblock .quoteblock { margin-left: 0; margin-right: 0; padding: 0.5em 0; border-left: 3px solid #417dcb; }
+.quoteblock .quoteblock blockquote { padding: 0 0 0 0.75em; }
+.quoteblock .quoteblock blockquote:before { display: none; }
+
+.verseblock { margin: 0 1em 1.25em 1em; }
+.verseblock pre { font-family:  sans-serif, "Open Sans", "DejaVu Sans", sans; font-size: 1.15rem; color: #6999d6; font-weight: 300; text-rendering: optimizeLegibility; }
+.verseblock pre strong { font-weight: 400; }
+.verseblock .attribution { margin-top: 1.25rem; margin-left: 0.5ex; text-align: right;}
+
+.quoteblock .attribution, .verseblock .attribution { font-size: inherit; line-height: 1.45; font-style: italic; }
+.quoteblock .attribution br, .verseblock .attribution br { display: none; }
+.quoteblock .attribution cite, .verseblock .attribution cite { display: block; letter-spacing: -0.025em; color: #417dcb; }
+
+.quoteblock.abstract { margin: 0 0 1.25em 0; display: block; }
+.quoteblock.abstract blockquote, .quoteblock.abstract blockquote p { text-align: left; word-spacing: 0; }
+.quoteblock.abstract blockquote:before, .quoteblock.abstract blockquote p:first-of-type:before { display: none; }
+
+table.tableblock { max-width: 100%; border-collapse: separate;  }
+table.tableblock td > .paragraph:last-child p > p:last-child, table.tableblock th > p:last-child, table.tableblock td > p:last-child { margin-bottom: 0; }
+
+table.tableblock, th.tableblock, td.tableblock { border: 0 solid #dddddd; margin-right: 2rem;}
+
+table.grid-all th.tableblock, table.grid-all td.tableblock { border-width: 0 1px 1px 0; padding: 0.5rem;}
+
+table.grid-all tfoot > tr > th.tableblock, table.grid-all tfoot > tr > td.tableblock { border-width: 1px 1px 0 0; }
+
+table.grid-cols th.tableblock, table.grid-cols td.tableblock { border-width: 0 1px 0 0; }
+
+table.grid-all * > tr > .tableblock:last-child, table.grid-cols * > tr > .tableblock:last-child { border-right-width: 0; }
+
+table.grid-rows th.tableblock, table.grid-rows td.tableblock { border-width: 0 0 1px 0; }
+
+table.grid-all tbody > tr:last-child > th.tableblock, table.grid-all tbody > tr:last-child > td.tableblock, table.grid-all thead:last-child > tr > th.tableblock, table.grid-rows tbody > tr:last-child > th.tableblock, table.grid-rows tbody > tr:last-child > td.tableblock, table.grid-rows thead:last-child > tr > th.tableblock { border-bottom-width: 0;}
+
+table.grid-rows tfoot > tr > th.tableblock, table.grid-rows tfoot > tr > td.tableblock { border-width: 1px 0 0 0; }
+
+table.frame-all { border-width: 1px; }
+
+table.frame-sides { border-width: 0 1px; }
+
+table.frame-topbot { border-width: 1px 0; }
+
+th.halign-left, td.halign-left { text-align: left; }
+
+th.halign-right, td.halign-right { text-align: right; }
+
+th.halign-center, td.halign-center { text-align: center; }
+
+th.valign-top, td.valign-top { vertical-align: top; }
+
+th.valign-bottom, td.valign-bottom { vertical-align: bottom; }
+
+th.valign-middle, td.valign-middle { vertical-align: middle; }
+
+table thead th, table tfoot th { font-weight: 600; }
+
+tbody tr th { display: table-cell; line-height: 1.4; background: whitesmoke; }
+
+tbody tr th, tbody tr th p, tfoot tr th, tfoot tr th p { color: #222222; font-weight: 600; }
+
+p.tableblock > code:only-child { background: none; padding: 0; max-width: 100%}
+
+p.tableblock { font-size: 1em; max-width: 100% }
+
+td > div.verse { white-space: pre; }
+
+ol { margin-left: 1.75em; }
+
+ul li ol { margin-left: 1.5em; }
+
+
+dl dd { margin-left: 1.125em; }
+
+dl dd:last-child, dl dd:last-child > :last-child { margin-bottom: 0; }
+
+ol > li p, ul > li p, ul dd, ol dd, .olist .olist, .ulist .ulist, .ulist .olist, .olist .ulist { margin-bottom: -0.2em; }
+
+ul.unstyled, ol.unnumbered, ul.checklist, ul.none { list-style-type: none; }
+
+ul.unstyled, ol.unnumbered, ul.checklist { margin-left: 0.625em; }
+
+ul.checklist li > p:first-child > .fa-square-o:first-child, ul.checklist li > p:first-child > .fa-check-square-o:first-child { width: 1em; font-size: 0.85em; }
+
+ul.checklist li > p:first-child > input[type="checkbox"]:first-child { width: 1em; position: relative; top: 1px; }
+
+ul.inline { margin: 0 auto 0.625em auto; margin-left: -1.375em; margin-right: 0; padding: 0; list-style: none; overflow: hidden; }
+ul.inline > li { list-style: none; float: left; margin-left: 1.375em; display: block; }
+ul.inline > li > * { display: block; }
+
+.unstyled dl dt { font-weight: normal; font-style: normal; }
+
+ol.arabic { list-style-type: decimal; }
+
+ol.decimal { list-style-type: decimal-leading-zero; }
+
+ol.loweralpha { list-style-type: lower-alpha; }
+
+ol.upperalpha { list-style-type: upper-alpha; }
+
+ol.lowerroman { list-style-type: lower-roman; }
+
+ol.upperroman { list-style-type: upper-roman; }
+
+ol.lowergreek { list-style-type: lower-greek; }
+
+.hdlist > table, .colist > table { border: 0; background: none; }
+.hdlist > table > tbody > tr, .colist > table > tbody > tr { background: none; }
+
+td.hdlist1, td.hdlist2 { vertical-align: baseline; padding: 0 0.625em; }
+
+td.hdlist1 { font-weight: bold; padding-bottom: 1.25em; }
+
+.literalblock + .colist, .listingblock + .colist { margin-top: -0.5em;  }
+
+.colist > table tr > td:first-of-type { padding: 0 0.75em; line-height: 1; }
+.colist > table tr > td:last-of-type { padding: 0.25em 0; }
+
+.thumb, .th { line-height: 0; display: inline-block; border: solid 4px white; -webkit-box-shadow: 0 0 0 1px #dddddd; box-shadow: 0 0 0 1px #dddddd; }
+
+.imageblock.left, .imageblock[style*="float: left"] { margin: 0.25em 0.625em 1.25em 0;   }
+.imageblock.right, .imageblock[style*="float: right"] { margin: 0.25em 0 1.25em 0.625em;  }
+.imageblock > .title { margin-bottom: 0; }
+.imageblock.thumb, .imageblock.th { border-width: 6px; }
+.imageblock.thumb > .title, .imageblock.th > .title { padding: 0 0.125em; }
+
+.image.left, .image.right { margin-top: 0.25em; margin-bottom: 0.25em; display: inline-block; line-height: 0; }
+.image.left { margin-right: 0.625em; }
+.image.right { margin-left: 0.625em; }
+
+a.image { text-decoration: none; display: inline-block; }
+a.image object { pointer-events: none; }
+
+sup.footnote, sup.footnoteref { font-size: 0.875em; position: static; vertical-align: super; }
+sup.footnote a, sup.footnoteref a { text-decoration: none; }
+sup.footnote a:active, sup.footnoteref a:active { text-decoration: underline; }
+
+#footnotes { padding-top: 0.75em; padding-bottom: 0.75em; margin-bottom: 0.625em; }
+#footnotes hr { width: 20%; min-width: 6.25em; margin: -0.25em 0 0.75em 0; border-width: 1px 0 0 0; }
+#footnotes .footnote { padding: 0 0.375em 0 0.225em; line-height: 1.3334; font-size: 0.875em; margin-left: 1.2em; text-indent: -1.05em; margin-bottom: 0.2em; }
+#footnotes .footnote a:first-of-type { font-weight: bold; text-decoration: none; }
+#footnotes .footnote:last-of-type { margin-bottom: 0; }
+#content #footnotes { margin-top: -0.625em; margin-bottom: 0; padding: 0.75em 0; }
+
+.gist .file-data > table { border: 0; background: #fff; width: 100%; margin-bottom: 0; }
+.gist .file-data > table td.line-data { width: 99%; }
+
+div.github-block { text-align: right; margin-right: -1rem; }
+div.gist {padding-right: 2rem;}
+
+div.unbreakable { page-break-inside: avoid; }
+
+.big { font-size: larger; }
+
+.small { font-size: smaller; }
+
+.underline { text-decoration: underline; }
+
+.overline { text-decoration: overline; }
+
+.line-through { text-decoration: line-through; }
+
+.aqua { color: #00bfbf; }
+
+.aqua-background { background-color: #00fafa; }
+
+.black { color: black; }
+
+.black-background { background-color: black; }
+
+.blue { color: #0000bf; }
+
+.blue-background { background-color: #0000fa; }
+
+.fuchsia { color: #bf00bf; }
+
+.fuchsia-background { background-color: #fa00fa; }
+
+.gray { color: #606060; }
+
+.gray-background { background-color: #7d7d7d; }
+
+.green { color: #006000; }
+
+.green-background { background-color: #007d00; }
+
+.lime { color: #00bf00; }
+
+.lime-background { background-color: #00fa00; }
+
+.maroon { color: #600000; }
+
+.maroon-background { background-color: #7d0000; }
+
+.navy { color: #000060; }
+
+.navy-background { background-color: #00007d; }
+
+.olive { color: #606000; }
+
+.olive-background { background-color: #7d7d00; }
+
+.purple { color: #600060; }
+
+.purple-background { background-color: #7d007d; }
+
+.red { color: #bf0000; }
+
+.red-background { background-color: #fa0000; }
+
+.silver { color: #909090; }
+
+.silver-background { background-color: #bcbcbc; }
+
+.teal { color: #006060; }
+
+.teal-background { background-color: #007d7d; }
+
+.white { color: #bfbfbf; }
+
+.white-background { background-color: #fafafa; }
+
+.yellow { color: #bfbf00; }
+
+.yellow-background { background-color: #fafa00; }
+
+span.icon > .fa { cursor: default; }
+
+.admonitionblock td.icon [class^="fa icon-"] { font-size: 2.5em; text-shadow: 1px 1px 2px rgba(0, 0, 0, 0.5); cursor: default; }
+.admonitionblock td.icon .icon-note:before { content: "\f05a"; color: #207c98; }
+.admonitionblock td.icon .icon-tip:before { content: "\f0eb"; text-shadow: 1px 1px 2px rgba(155, 155, 0, 0.8); color: #111; }
+.admonitionblock td.icon .icon-warning:before { content: "\f071"; color: #bf6900; }
+.admonitionblock td.icon .icon-caution:before { content: "\f06d"; color: #bf3400; }
+.admonitionblock td.icon .icon-important:before { content: "\f06a"; color: #bf0000; }
+
+.conum[data-value] { display: inline-block; color: #fff !important; background-color: #222222; -webkit-border-radius: 100px; border-radius: 100px; text-align: center; font-size: 0.75em; width: 1.67em; height: 1.67em; line-height: 1.67em; font-family:sans-serif, "Open Sans", "DejaVu Sans", sans-serif; font-style: normal; font-weight: bold; }
+.conum[data-value] * { color: #fff !important; }
+.conum[data-value] + b { display: none; }
+.conum[data-value]:after { content: attr(data-value); }
+pre .conum[data-value] { position: relative; top: -0.125em; }
+
+b.conum * { color: inherit !important; }
+
+
+.conum:not([data-value]):empty { display: none; }
+
+.literalblock pre, .listingblock pre { background: #eeeeee; }
+
+div#remarks.ulist {
+	max-width: 70%;
+}
+
+div.title:first-of-type {
+    display: none;
+}
+
+/* Mobile */
+
+@media only screen and (max-width: 800px) {
+	a#bottomright {visibility: hidden;}
+	.sectionbody.paragraph {max-width: 100%}
+	.paragraph.lead > p, #preamble > .sectionbody > .paragraph:first-of-type p { max-width: 100% }
+}
+
+#div.paragraph.faq-intro {
+	max-width: 66.66%
+}
+/* ========================================================================== Mobile Menu ======================================================================= */
+#menu {
+    display: none;
+    }
+
+div.slicknav_menu {
+    padding-top: 5px;
+    padding-right: 15px;
+    background-color: #132445;
+    margin-left: -2rem;
+    margin-right: -2rem;
+    text-align: right;
+    display: none;
+    right: 10px;
+    font-size: 1rem;
+    color: white;
+    padding-bottom: 2rem;
+    background: url("n4js-logo.png");
+    background-position: 10px 10px;
+    background-size: 344.48px 40px;
+    background-repeat: no-repeat;
+    background-color: #132445;
+}
+
+span.slicknav_menutxt {
+    margin-right: -20px;
+    color: white;
+}
+
+div.slicknav_menu a.scroll:first-of-type {
+    color: #F7D425;
+    font-size: 120%;
+    font-weight: 600;
+}
+div.slicknav_menu ul li a {
+    color: white;
+}
+div.slicknav_menu ul li a:hover {
+    color: #F7D425;
+}
+
+div.slicknav_menu a:hover {color: #F7D425; }
+div.slicknav_menu a:visited {color: white; }
+div.slicknav_menu a {color: white;}
+a.slicknav_btn  {
+    padding: 1rem;
+}
+
+
+li.slicknav_parent.slicknav_open {
+    color: white;
+}
+
+li.slicknav_parent.slicknav_open  {
+    color: white;
+}
+
+@media screen and (max-width: 890px) {
+    div.slicknav_menu {
+        display: block;
+        color: white
+    }
+    #mobile-banner {
+        display: block;
+    }
+}
+
+@media screen and (max-width: 470px) {
+div.slicknav_menu ul:first-of-type {
+    margin-top: 1.5rem;
+}
+
+div.slicknav_menu ul li {
+    color: white;
+}
+div.slicknav_menu ul li:hover {
+    color: #F7D425;
+}
+}
+div.slicknav_menu li:last-of-type
+    {
+        padding-bottom: 0.7rem;
+    }
+/* ========================================================================== NavMenu ======================================================================= */
+
+.banner {
+  height: 1rem;
+  padding-right: 2rem;
+  max-height: 1rem;  
+  max-width: 50%;
+  vertical-align: middle;
+
+  @media (max-width: 800px) {
+    flex-basis: 66.666%%;
+    max-width: 25%;
+    margin: 1rem;
+
+  }
+}
+
+
+div.box p { 
+text-indent: 0px; 
+position: absolute;
+display: none;
+}
+
+
+#menubar ul { margin: 0; padding: 0; white-space:nowrap; padding-left: 10px; padding-right: 10px; line-height: 2rem;}
+#menubar li { margin: 0; padding: 0;   }
+#menubar a { margin: 0; padding: 0;}
+#menubar ul {list-style: none; text-align: right;}
+#menubar a {text-decoration: none;}
+#menubar li {margin-left: 0;}
+#menubar {height: 70px; background-color: #132445; /* box-shadow: 0px 2px 3px rgba(0,0,0,.4); */ position: relative; padding-right: 2rem; margin-left: -2rem;  margin-right: -2rem;  color: white; font-size: 1.9rem;}
+
+
+#menubar > ul > li {
+
+    display:inline-block;
+    margin: 0.2rem;
+    position: relative;
+    z-index: 10000;
+    flex-basis: 66.666%%;
+    font-weight: 700;
+
+}
+
+#footer {  
+	/*width: 850px;*/
+	background-color: #ffffff; padding: 1.25em; padding-bottom: 0rem;
+	margin-right: 3rem; margin-left: -2rem; margin-top: 1rem; 
+	color: white}
+
+@media only screen and (max-width: 890px) {
+
+#n4js-mobile-logo { 
+    position: absolute;
+    top: 0;
+    left: 0;
+    width: 178px;
+    height: 60px;
+    background-color: transparent;
+}
+
+div.box p { 
+text-indent: -999px; 
+position: absolute;
+}
+
+  #menubar > ul > li, #menubar {
+    visibility: hidden;
+    display: none;
+  }
+
+}
+
+@media only screen and (max-width: 500px) {
+
+
+
+
+#menubar {
+  display: none;
+}
+
+#logo {
+  margin-top: -55px;
+}
+
+}
+
+#logo {
+  height: 40px;
+  margin-left: 40px;
+  margin-top: 17px;
+  position: relative;
+  overflow: hidden;
+}
+
+#menubar > ul > li::after {
+    content: " · ";
+    position: relative;
+    top: 3px;
+    padding-left: 3px;
+    font-weight: 400;
+}
+
+#menubar > ul > li:last-of-type::after {
+  content: none;
+}
+#menubar > ul > li:last-of-type {
+  padding-right: -1rem;
+}
+
+#menubar > ul > li > a {
+    color: #FFFFFF;
+    font-size:  1.2rem;
+    line-height: 50px; 
+    font-weight: 400;
+    /* padding-top: 2rem; */
+    webkit-transition: color .15s;
+    -moz-transition: color .15s;
+    -o-transition: color .15s;
+    transition: color .15s;
+    white-space:nowrap; 
+    -webkit-font-smoothing: auto;
+    letter-spacing: -.01em;
+    padding-top: 0.2em;
+    padding-left: 0rem;
+    padding-right: 0.1rem;
+}
+
+#menubar > ul {
+    margin-right: 12px;
+    margin-top: 0px;
+}
+
+#menubar > ul > li > a:hover {color: #F7D425; }
+body.home li.home, body.tech li.tech {font-weight:bold; }
+
+#menubar > ul > li > ul {
+    opacity: 0;
+    visibility: hidden;
+    padding: 18px 0 20px 0;
+    background-color: #FFFFFF; /* rgb(15,26,54); top menu color */
+    text-align: left;
+    position: absolute;
+    top: 55px;
+    left: 50%;
+    margin-left: -200px;
+-webkit-transition: all .3s .1s;
+   -moz-transition: all .3s .1s;
+     -o-transition: all .3s .1s;
+        transition: all .3s .1s;
+-webkit-border-radius: 5px;
+   -moz-border-radius: 5px;
+        border-radius: 5px;
+-webkit-box-shadow: 0px 1px 3px rgba(0,0,0,.4);
+   -moz-box-shadow: 0px 1px 3px rgba(0,0,0,.4);
+        box-shadow: 0px 1px 3px rgba(0,0,0,.4);
+}
+
+#menubar > li li {
+    width:100%;
+}
+
+#menubar > ul > li:hover > ul {
+    opacity: 1;
+    top: 65px;
+    visibility: visible;
+}
+
+#menubar > ul > li > ul:before{
+    content: '';
+    display: block;
+    border-color: transparent transparent #FFFFFF transparent;
+    border-style: solid;
+    border-width: 10px;
+    position: absolute;
+    top: -20px;
+    left: 10%;
+    margin-left: -10px;
+}
+
+#menubar > ul ul > li { position: relative;}
+
+#menubar ul ul a{
+    color: rgb(50,50,50);
+    font-family:  sans-serif, Verdana, 'Lucida Grande';
+    font-size: 17px;
+    background-color: #FFFFFF; /* rgb(15,26,54); top menu color */
+    padding: 5px 8px 7px 16px;
+    display: block;
+-webkit-transition: background-color .1s;
+   -moz-transition: background-color .1s;
+     -o-transition: background-color .1s;
+        transition: background-color .1s;
+}
+
+#menubar ul ul a:hover {background-color: #244D82; color: #F7D425;}
+
+#menubar ul ul ul {
+    visibility: hidden;
+    opacity: 0;
+    position: absolute;
+    top: -16px;
+    left: 206px;
+    padding: 16px 0 20px 0;
+    background-color: #527AA3;
+    text-align: left;
+    width: 160px;
+-webkit-transition: all .3s;
+   -moz-transition: all .3s;
+     -o-transition: all .3s;
+        transition: all .3s;
+-webkit-border-radius: 5px;
+   -moz-border-radius: 5px;
+        border-radius: 5px;
+-webkit-box-shadow: 0px 1px 3px rgba(0,0,0,.4);
+   -moz-box-shadow: 0px 1px 3px rgba(0,0,0,.4);
+        box-shadow: 0px 1px 3px rgba(0,0,0,.4);
+}
+
+
+#menubar ul ul > li:hover > ul { opacity: 1; left: 196px; visibility: visible;}
+
+
+#menubar ul ul a:hover{
+    background-color: #244D82;
+    color: #F7D425;
+}
+
+
+.Cell--12-12 {
+    -webkit-flex-basis: 100%;
+    -ms-flex-preferred-size: 100%;
+    flex-basis: 100%;
+    max-width: 100%
+}
+
+.Grid {
+    display: -webkit-flex;
+    display: -ms-flexbox;
+    display: flex;
+    -webkit-align-items: stretch;
+    -ms-flex-align: stretch;
+    align-items: stretch;
+    -webkit-flex-wrap: wrap;
+    -ms-flex-wrap: wrap;
+    flex-wrap: wrap;
+    -webkit-flex: 0 1 auto;
+    -ms-flex: 0 1 auto;
+    flex: 0 1 auto;
+    -webkit-flex-direction: row;
+    -ms-flex-direction: row;
+    flex-direction: row
+}
+
+.Cell,
+.Comparison .Comparison-left,
+.Comparison .Comparison-right,
+.ExampleExplanation .ExampleExplanation-code,
+.ExampleExplanation .ExampleExplanation-text,
+.FeatureTabs .FeatureTabs-stage,
+.Intro .Intro-Slogan {
+    padding-left: 1rem;
+    padding-right: 1rem;
+    -webkit-flex: 0 0 auto;
+    -ms-flex: 0 0 auto;
+    flex: 0 0 auto
+}
+
+#_index, #_feature_table {display: none;}
+
+#_documentation {margin-top: -2rem;}
+
+h3 {padding-top: 1rem}
+
+/* ========================================================================== AsciiSpec ======================================================================= */
+.requirement {
+	border: 1px solid #aaaaaa;
+	padding: 0.5em;
+	margin-bottom: 1rem;
+}
+
+.bibliography .content .paragraph p :first-child::before { 
+	color:#777777;
+	content: "[" attr(id) "] "; }
+
+.bibliography .content .paragraph {
+	padding-left: 6em;
+	text-indent: -6em;
\ No newline at end of file
diff --git a/design/styles/prism.min.css b/design/styles/prism.min.css
new file mode 100644
index 0000000..92f56d3
--- /dev/null
+++ b/design/styles/prism.min.css
@@ -0,0 +1 @@
+code[class*="language-"],pre[class*="language-"]{color:black;background:none;text-shadow:0 1px white;font-family:'Ubuntu Mono', monospace;text-align:left;word-spacing:normal;word-break:normal;word-wrap:normal;line-height:1.5;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-hyphens:none;-moz-hyphens:none;-ms-hyphens:none;hyphens:none}pre[class*="language-"]::-moz-selection,pre[class*="language-"] ::-moz-selection,code[class*="language-"]::-moz-selection,code[class*="language-"] ::-moz-selection{text-shadow:none;background:#b3d4fc}pre[class*="language-"]::selection,pre[class*="language-"] ::selection,code[class*="language-"]::selection,code[class*="language-"] ::selection{text-shadow:none;background:#b3d4fc}@media print{code[class*="language-"],pre[class*="language-"]{text-shadow:none}}pre[class*="language-"]{padding:1em;margin:.5em 0;overflow:auto}:not(pre) > code[class*="language-"],pre[class*="language-"]{background:#f5f2f0}:not(pre) > code[class*="language-"]{padding:.1em;border-radius:.3em;white-space:normal}.token.comment,.token.prolog,.token.doctype,.token.cdata{color:#3f7f5f}.token.punctuation{color:#999}.namespace{opacity:.7}.token.property,.token.tag,.token.boolean,.token.number,.token.constant,.token.symbol,.token.deleted{color:#905}.token.selector,.token.attr-name,.token.string,.token.char,.token.builtin,.token.inserted{color:#690}.token.operator,.token.entity,.token.url,.language-css .token.string,.style .token.string{color:#0086b3}.token.atrule,.token.attr-value,.token.keyword{color:#7f0055}.token.function{color:#2a00ff}.token.regex,.token.important,.token.variable{color:#e90}.token.important,.token.bold{font-weight:bold}.token.italic{font-style:italic}.token.entity{cursor:help}pre[data-line]{position:relative;padding:1em 0 1em 3em}.line-highlight{position:absolute;left:0;right:0;padding:inherit 0;margin-top:1em;background:hsla(24, 20%, 50%,.08);background:linear-gradient(to right, hsla(24, 20%, 50%,.1) 70%, hsla(24, 20%, 50%,0));pointer-events:none;line-height:inherit;white-space:pre}.line-highlight:before,.line-highlight[data-end]:after{content:attr(data-start);position:absolute;top:.4em;left:.6em;min-width:1em;padding:0 .5em;background-color:hsla(24, 20%, 50%,.4);color:hsl(24, 20%, 95%);font:bold 65%/1.5 sans-serif;text-align:center;vertical-align:.3em;border-radius:999px;text-shadow:none;box-shadow:0 1px white}.line-highlight[data-end]:after{content:attr(data-end);top:auto;bottom:.4em}pre.line-numbers{position:relative;padding-left:3.8em;counter-reset:linenumber}pre.line-numbers > code{position:relative}.line-numbers .line-numbers-rows{position:absolute;pointer-events:none;top:0;font-size:100%;left:-3.8em;width:3em;letter-spacing:-1px;border-right:1px solid #999;-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none;user-select:none}.line-numbers-rows > span{pointer-events:none;display:block;counter-increment:linenumber}.line-numbers-rows > span:before{content:counter(linenumber);color:#999;display:block;padding-right:0.8em;text-align:right}.token a{color:inherit}pre.code-toolbar{position:relative}pre.code-toolbar > .toolbar{position:absolute;top:.3em;right:.2em;transition:opacity 0.3s ease-in-out;opacity:0}pre.code-toolbar:hover > .toolbar{opacity:1}pre.code-toolbar > .toolbar .toolbar-item{display:inline-block}pre.code-toolbar > .toolbar a{cursor:pointer}pre.code-toolbar > .toolbar button{background:none;border:0;color:inherit;font:inherit;line-height:normal;overflow:visible;padding:0;-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none}pre.code-toolbar > .toolbar a,pre.code-toolbar > .toolbar button,pre.code-toolbar > .toolbar span{color:#bbb;font-size:.8em;padding:0 .5em;background:#f5f2f0;background:rgba(224, 224, 224, 0.2);box-shadow:0 2px 0 0 rgba(0,0,0,0.2);border-radius:.5em}pre.code-toolbar > .toolbar a:hover,pre.code-toolbar > .toolbar a:focus,pre.code-toolbar > .toolbar button:hover,pre.code-toolbar > .toolbar button:focus,pre.code-toolbar > .toolbar span:hover,pre.code-toolbar > .toolbar span:focus{color:inherit;text-decoration:none}.lang-markup script[type='text/plain'],.language-markup script[type='text/plain'],script[type='text/plain'].lang-markup,script[type='text/plain'].language-markup{display:block;font:100% Consolas, Monaco, monospace;white-space:pre;overflow:auto}.command-line-prompt{border-right:1px solid #999;display:block;float:left;font-size:100%;letter-spacing:-1px;margin-right:1em;pointer-events:none;-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none;user-select:none}.command-line-prompt > span:before{color:#999;content:' ';display:block;padding-right:0.8em}.command-line-prompt > span[data-user]:before{content:"[" attr(data-user) "@" attr(data-host) "] $"}.command-line-prompt > span[data-user="root"]:before{content:"[" attr(data-user) "@" attr(data-host) "] #"}.command-line-prompt > span[data-prompt]:before{content:attr(data-prompt)}.ebnfkeyword{font-weight:bold;color:#800000}.ruleheading{font-weight:bold;color:#000000}.literal{color:#0080ff}.actions{color:#EE7600}.ruleterminal{color:#000000;font-weight:bold}.semi{color:#696969;font-weight:normal}.multilinecomment{color:#228B22}.typereference{font-style:italic}.rulestructure{color:#9932CC}.token.n4jsannotation{color:#FF00FF;font-weight:normal}.punctuation + b{display:none}
\ No newline at end of file
diff --git a/design/styles/spec.min.css b/design/styles/spec.min.css
new file mode 100644
index 0000000..a5f004a
--- /dev/null
+++ b/design/styles/spec.min.css
@@ -0,0 +1 @@
+img,legend{border:0}body,figure{margin:0}body,table{background:#fff}#content:after,#footer:after,#footnotes:after,#header:after,.clearfix:after,.float-group:after,hr{clear:both}#toc,b.button:after,b.button:before,body,kbd,sub,sup{position:relative}#toc a,.vevent abbr,a,div.social>ul li{text-decoration:none}article,aside,details,figcaption,figure,footer,header,hgroup,main,nav,section,summary{display:block}audio,canvas,video{display:inline-block}audio:not([controls]){display:none;height:0}[hidden],template{display:none}script{display:none !important}html{font-family:sans-serif;-ms-text-size-adjust:100%;-webkit-text-size-adjust:100%}a:focus{outline:dotted thin}a:active,a:hover{outline:0}abbr[title]{border-bottom:1px dotted}b,strong{font-weight:700}dfn{font-style:italic}hr{-moz-box-sizing:content-box;box-sizing:content-box}mark{background:#ff0;color:#000}code,kbd,pre,samp{font-family:monospace, serif;font-size:1em}pre{white-space:pre-wrap}q{quotes:"\201C" "\201D" "\2018" "\2019"}sub,sup{font-size:75%;line-height:0;vertical-align:baseline}sup{top:-.5em}sub{bottom:-.25em}svg:not(:root){overflow:hidden}fieldset{border:1px solid silver;margin:0 2px;padding:.35em .625em .75em}legend{padding:0}button,input,select,textarea{font-family:inherit;font-size:100%;margin:0}button,input{line-height:normal}button,select{text-transform:none}button,html input[type=button],input[type=reset],input[type=submit]{-webkit-appearance:button;cursor:pointer}button[disabled],html input[disabled]{cursor:default}input[type=checkbox],input[type=radio]{box-sizing:border-box;padding:0}input[type=search]{-webkit-appearance:textfield;-moz-box-sizing:content-box;-webkit-box-sizing:content-box;box-sizing:content-box}input[type=search]::-webkit-search-cancel-button,input[type=search]::-webkit-search-decoration{-webkit-appearance:none}button::-moz-focus-inner,input::-moz-focus-inner{border:0;padding:0}textarea{overflow:auto;vertical-align:top;height:auto;min-height:50px}meta.foundation-mq-small{font-family:"only screen and (min-width: 500px)";width:500px}meta.foundation-mq-medium{font-family:"only screen and (min-width:1280px)";width:1280px}meta.foundation-mq-large{font-family:"only screen and (min-width:1440px)";width:1440px}.spread,select{width:100%}*,:after,:before{-moz-box-sizing:border-box;-webkit-box-sizing:border-box;box-sizing:border-box}body,html{font-size:100%}body{color:#595959;padding:0;font-family:"Helvetica Neue", Helvetica, Helvetica, Arial, sans-serif;font-weight:400;font-style:normal;line-height:1;cursor:auto max-width: 1280px;tab-size:4}a:hover{cursor:pointer}embed,img,object{max-width:100%;height:auto}embed,object{height:100%}#map_canvas embed,#map_canvas img,#map_canvas object,.map_canvas embed,.map_canvas img,.map_canvas object{max-width:none !important}.left{float:left !important}.right{float:right !important}.text-left{text-align:left !important}.text-right{text-align:right !important}.text-center{text-align:center !important}.text-justify{text-align:justify !important}.hide{display:none}img,object,svg{display:inline-block;vertical-align:middle}.antialiased,body{-webkit-font-smoothing:antialiased}img{-ms-interpolation-mode:bicubic}.center{margin-left:auto;margin-right:auto}#preamble>.sectionbody>.paragraph:first-of-type p,.paragraph.lead>p,p.lead{font-size:1.21875em;line-height:1.6}.admonitionblock td.content>.title,.audioblock>.title,.dlist>.title,.exampleblock>.title,.hdlist>.title,.imageblock>.title,.listingblock>.title,.literalblock>.title,.olist>.title,.openblock>.title,.paragraph>.title,.qlist>.title,.quoteblock>.title,.stemblock>.title,.subheader,.ulist>.title,.verseblock>.title,.videoblock>.title,table.tableblock>.title{line-height:1.4;color:#6f6f6f;font-weight:300;margin-top:.2em;margin-bottom:.5em}#toctitle,.sidebarblock>.content>.title,blockquote,dd,div,dl,dt,form,h1,h2,h3,h4,h5,h6,li,ol,p,pre,td,th,ul{margin:0;padding:0;direction:ltr}a{background:0 0;color:#2ba6cb;line-height:inherit}a:focus,a:hover{color:#2795b6}a img{border:none}p{font-family:inherit;font-weight:400;font-size:1em;line-height:1.6;margin-bottom:1.25em;text-rendering:optimizeLegibility}#toctitle,.admonitionblock>table td.icon .title,.sidebarblock>.content>.title,h1,h2,h3,h4,h5,h6{font-family:"Helvetica Neue", Helvetica, Helvetica, Arial, sans-serif}.vcard .fn,.vevent .summary,.vevent abbr,code,dl dt{font-weight:700}p aside{font-size:.875em;line-height:1.35;font-style:italic}#toctitle,.sidebarblock>.content>.title,h1,h2,h3,h4,h5,h6{font-weight:700;font-style:normal;color:#595959;text-rendering:optimizeLegibility;margin-top:1em;margin-bottom:.5em}dl,dl dd,ol,ul{margin-bottom:1.25em}#toctitle small,.sidebarblock>.content>.title small,h1 small,h2 small,h3 small,h4 small,h5 small,h6 small{font-size:60%;color:#6f6f6f;line-height:0}b,em,i,small,strong{line-height:inherit}h1{font-size:2.125em}h2{font-size:1.6875em}#toctitle,.sidebarblock>.content>.title,h3{font-size:1.375em}h4,h5{font-size:1.125em}h6{font-size:1em}hr{border:solid #ddd;border-width:1px 0 0;margin:1.25em 0 1.1875em;height:0}em,i{font-style:italic}small{font-size:60%}dl,ol,ul,ul li ol,ul li ul{font-size:1em}code{font-family:Consolas, "Liberation Mono", Courier, monospace;color:#7f0a0c}dl,ol,ul{line-height:1.6;list-style-position:outside;font-family:inherit}ol,ol.no-bullet,ul,ul.no-bullet{margin-left:1.5em}ol li ol,ol li ul,ul li ol,ul li ul{margin-left:1.25em;margin-bottom:0}ul.circle li ul,ul.disc li ul,ul.square li ul{list-style:inherit}#menubar ul,ul.inline,ul.inline>li,ul.no-bullet{list-style:none}ul.square{list-style-type:square}ul.circle{list-style-type:circle}ul.disc{list-style-type:disc}dl dt{margin-bottom:.3125em}.vcard,blockquote{margin:0 0 1.25em}abbr,acronym{text-transform:uppercase;font-size:90%;color:#222;border-bottom:1px dotted #ddd;cursor:help}abbr{text-transform:none}blockquote{padding:.5625em 1.25em 0 1.1875em;border-left:1px solid #ddd}blockquote cite{display:block;font-size:.8125em;color:#555}blockquote cite:before{content:"\2014 \0020"}blockquote cite a,blockquote cite a:visited{color:#555}blockquote,blockquote p{line-height:1.6;color:#6f6f6f}.vcard{display:inline-block;border:1px solid #ddd;padding:.625em .75em}.vcard li{margin:0;display:block}.vcard .fn{font-size:.9375em}.vevent abbr{cursor:auto;border:none;padding:0 .0625em}@media only screen and (min-width:500px){#toctitle,.sidebarblock>.content>.title,h1,h2,h3,h4,h5,h6{line-height:1.4}h1{font-size:2.75em}h2{font-size:2.3125em}#toctitle,.sidebarblock>.content>.title,h3{font-size:1.6875em}h4{font-size:1.4375em}}table{border-collapse:collapse;border-spacing:0;margin-bottom:1.25em;border:1px solid #ddd}table tfoot,table thead{background:#f5f5f5;font-weight:600}table tfoot tr td,table tfoot tr th,table thead tr td,table thead tr th{padding:.5em .625em .625em;font-size:inherit;color:#222;text-align:left}table tr td,table tr th{padding:.5625em .625em;font-size:inherit;color:#595959}table tr.alt,table tr.even,table tr:nth-of-type(even){background:#f9f9f9}table tbody tr td,table tfoot tr td,table tfoot tr th,table thead tr th,table tr td{display:table-cell;line-height:1.4}#toctitle,.sidebarblock>.content>.title,h1,h2,h3,h4,h5,h6{line-height:1.4}.clearfix:after,.clearfix:before,.float-group:after,.float-group:before{content:" ";display:table}:not(pre)>code{font-size:inherit;font-style:normal !important;letter-spacing:0;padding:0;line-height:inherit}pre,pre>code{line-height:1.4;color:#000;font-family:monospace, serif;font-weight:400}.keyseq{color:#555}kbd{font-family:Consolas, "Liberation Mono", Courier, monospace;display:inline-block;color:#222;font-size:.65em;line-height:1.45;background-color:#f7f7f7;border:1px solid #ccc;-webkit-border-radius:3px;border-radius:3px;-webkit-box-shadow:0 1px 0 rgba(0, 0, 0, .2), 0 0 0 .1em #fff inset;box-shadow:0 1px 0 rgba(0, 0, 0, .2), 0 0 0 .1em #fff inset;margin:0 .15em;padding:.2em .5em;vertical-align:middle;top:-.1em;white-space:nowrap}table.pyhltable td,td.valign-top,th.valign-top{vertical-align:top}.keyseq kbd:first-child{margin-left:0}.keyseq kbd:last-child{margin-right:0}.menu,.menuseq{color:#090909}b.button:after,b.button:before{top:-1px;font-weight:400}b.button:before{content:"[";padding:0 3px 0 2px}b.button:after{content:"]";padding:0 2px 0 3px}#content,#footer,#footnotes,#header{max-width:1300px;margin-right:80px;margin-top:0;margin-bottom:0;position:relative;padding-left:0;padding-right:.9375em;left:40px}#content:after,#content:before,#footer:after,#footer:before,#footnotes:after,#footnotes:before,#header:after,#header:before{content:" ";display:table}#content{margin-top:1.25em;padding-right:0;margin-right:115px}#content:before{content:none}#header>h1:first-child{color:#595959;margin-top:2.25rem;margin-bottom:0}#header>h1:first-child+#toc{margin-top:8px;border-top:1px solid #ddd}#header>h1:only-child,body.toc2 #header>h1:nth-last-child(2){border-bottom:1px solid #ddd;padding-bottom:8px}#header .details{border-bottom:1px solid #ddd;line-height:1.45;padding-top:.25em;padding-bottom:.25em;padding-left:.25em;color:#555;display:-ms-flexbox;display:-webkit-flex;display:flex;-ms-flex-flow:row wrap;-webkit-flex-flow:row wrap;flex-flow:row wrap}#header .details span:first-child{margin-left:-.125em}#header .details span.email a{color:#6f6f6f}#header .details br{display:none}#header .details br+span:before{content:"\00a0\2013\00a0"}#header .details br+span.author:before{content:"\00a0\22c5\00a0";color:#6f6f6f}#header .details br+span#revremark:before{content:"\00a0|\00a0"}#header #revnumber{text-transform:capitalize}#header #revnumber:after{content:"\00a0"}#content>h1:first-child:not([class]){color:#000;border-bottom:1px solid #ddd;padding-bottom:8px;margin-top:0;padding-top:1rem;margin-bottom:1.25rem}#toc ul li:before,div#faq li:before,div#features-nav li:before,div.ulist li:before{content:"";color:#244d82}#toc{border-bottom:1px solid #ddd;padding-bottom:.5em;left:0}#toc li{line-height:1.3334;margin-top:0;padding-left:5px}#toc ul li:before{margin-left:-.75em;margin-right:.4em}div.ulist li:before{position:absolute;font-size:x-large;line-height:1rem;margin:.2rem 0 -.75em -.75em}#faq,#features-nav{margin-bottom:20px;z-index:1;padding-left:2rem;border-left:1px solid #d3d3d3}#toctitle{color:#595959;font-size:1.2em;padding-left:1em}#faq{position:relative;right:9.3rem;top:9rem;left:45rem}@media only screen and (max-width:945px){div#faq{display:none}}#faq h2{font-size:25px;font-weight:600;margin-top:-8rem}div#faq li:before,div#features-nav li:before{position:absolute;font-size:x-large;margin-left:-.75em;margin-bottom:-.75em;margin-right:0;line-height:1rem}#features-nav{right:1rem;top:2rem;position:absolute}@media only screen and (max-width:993px){#features-nav{display:none}}#features-nav h2{font-size:25px;font-weight:600;margin-top:-1rem}#features-nav li{margin-top:.3rem}@media only screen and (min-width:500px){#toctitle{padding-top:0;font-size:1.375em}body.toc2{padding-left:2em;padding-right:1em}#toc.toc2{margin-top:0 !important;background-color:#f2f2f2;position:fixed;width:260px;left:0;top:0;border-right:1px solid #ddd;border-top-width:0 !important;border-bottom-width:0 !important;z-index:1000;padding:1.25em .25em 0;height:100%;overflow:auto}#toc.toc2 #toctitle{margin-top:0;margin-bottom:.8rem;font-size:1.2em;padding-left:1em}#toc.toc2>ul{font-size:.9em;margin-bottom:0}#toc.toc2 ul ul{margin-left:6px}#toc.toc2 ul.sectlevel0 ul.sectlevel1{padding-left:10px;margin-top:.5em;margin-bottom:.5em}body.toc2.toc-right{padding-left:2em;padding-right:2em}body.toc2.toc-right #toc.toc2{border-right-width:0;border-left:1px solid #ddd;left:auto;right:-260px}}body.toc2.toc-left #toc.toc2{left:0}@media only screen and (min-width:1000px){#toc.toc2 #toctitle,#toctitle{font-size:1.375em}#content{max-width:1260px}body.toc2{padding-left:260px;padding-right:2em}#toctitle{padding-top:0}#toc.toc2{width:260px}#toc.toc2>ul{font-size:.95em}#toc.toc2 ul ul{padding-left:0}body.toc2.toc-right{padding-left:2em;padding-right:2em}}#content #toc{border-style:solid;border-width:1px;border-color:#d9d9d9;margin-bottom:1.25em;padding:1.25em;background:#f2f2f2;-webkit-border-radius:0;border-radius:0}#content #toc>:first-child{margin-top:0}#footer,div.social{margin-top:2rem;color:#fff}#content #toc>:last-child{margin-bottom:0}#footer{padding:1.25em 1.25em 0}div.social{padding:1.25em 1.25em 0 30px}.exampleblock>.content>:first-child,.sidebarblock>:first-child{margin-top:0}div.social>ul li{color:#fff;line-height:1.44;font-size:1.2em;font-weight:800;font-style:bold;position:relative;list-style:none;display:inline}#bottomright{float:right}#footer-text{color:#ddd;line-height:1.44}.sect1{padding-bottom:.625em}@media only screen and (min-width:500px){.sect1{padding-bottom:1.25em}}.sect1+.sect1{border-top:1px solid #ddd}#content h1>a.anchor,#toctitle>a.anchor,.sidebarblock>.content>.title>a.anchor,h2>a.anchor,h3>a.anchor,h4>a.anchor,h5>a.anchor,h6>a.anchor{position:absolute;z-index:1001;width:1.5ex;margin-left:-1.5ex;display:block;text-decoration:none !important;visibility:hidden;text-align:center;font-weight:400}a.image,sup.footnote a,sup.footnoteref a{text-decoration:none}#content h1>a.anchor:before,#toctitle>a.anchor:before,.sidebarblock>.content>.title>a.anchor:before,h2>a.anchor:before,h3>a.anchor:before,h4>a.anchor:before,h5>a.anchor:before,h6>a.anchor:before{content:"\00A7";font-size:.85em;display:block;padding-top:.1em}#content h1:hover>a.anchor,#content h1>a.anchor:hover,#toctitle:hover>a.anchor,#toctitle>a.anchor:hover,.sidebarblock>.content>.title:hover>a.anchor,.sidebarblock>.content>.title>a.anchor:hover,h2:hover>a.anchor,h2>a.anchor:hover,h3:hover>a.anchor,h3>a.anchor:hover,h4:hover>a.anchor,h4>a.anchor:hover,h5:hover>a.anchor,h5>a.anchor:hover,h6:hover>a.anchor,h6>a.anchor:hover{visibility:visible}#content h1>a.link,#toctitle>a.link,.sidebarblock>.content>.title>a.link,h2>a.link,h3>a.link,h4>a.link,h5>a.link,h6>a.link{color:#595959;text-decoration:none}#content h1>a.link:hover,#toctitle>a.link:hover,.sidebarblock>.content>.title>a.link:hover,h2>a.link:hover,h3>a.link:hover,h4>a.link:hover,h5>a.link:hover,h6>a.link:hover{color:#151515}.audioblock,.imageblock,.listingblock,.literalblock,.stemblock,.videoblock{margin-bottom:1.25em}.admonitionblock td.content>.title,.audioblock>.title,.dlist>.title,.exampleblock>.title,.hdlist>.title,.imageblock>.title,.listingblock>.title,.literalblock>.title,.olist>.title,.openblock>.title,.paragraph>.title,.qlist>.title,.quoteblock>.title,.stemblock>.title,.ulist>.title,.verseblock>.title,.videoblock>.title,table.tableblock>.title{text-rendering:optimizeLegibility;text-align:left}table.tableblock>caption.title{white-space:nowrap;overflow:visible;max-width:0}#preamble>.sectionbody>.paragraph:first-of-type p,.paragraph.lead>p{color:#000}table.tableblock #preamble>.sectionbody>.paragraph:first-of-type p{font-size:inherit}.admonitionblock>table{border-collapse:separate;border:0;background:0 0;width:100%}.admonitionblock>table td.icon{text-align:center;width:80px}.admonitionblock>table td.icon img{max-width:none}.admonitionblock>table td.icon .title{font-weight:700;text-transform:uppercase}.admonitionblock>table td.content{padding-left:1.125em;padding-right:1.25em;border-left:1px solid #ddd;color:#555}.admonitionblock>table td.content>:last-child>:last-child{margin-bottom:0}.exampleblock>.content{border-style:solid;border-width:1px;border-color:#e6e6e6;margin-bottom:1.25em;padding:1.25em;background:#fff;-webkit-border-radius:0;border-radius:0}.exampleblock>.content .olist>ol>li:last-child>:last-child,.exampleblock>.content .qlist>ol>li:last-child>:last-child,.exampleblock>.content .ulist>ul>li:last-child>:last-child,.exampleblock>.content>:last-child,.exampleblock>.content>:last-child>:last-child,.sidebarblock>.content .olist>ol>li:last-child>:last-child,.sidebarblock>.content .qlist>ol>li:last-child>:last-child,.sidebarblock>.content .ulist>ul>li:last-child>:last-child,.sidebarblock>.content>:last-child>:last-child,.sidebarblock>:last-child,table.pyhltable{margin-bottom:0}.sidebarblock{position:absolute;border-style:solid;width:90px;border-width:1px;border-color:#d9d9d9;right:-90px;padding:.1rem;background:#f2f2f2;-webkit-border-radius:0;text-align:left;border-radius:5px}.sidebarblock>.content>.title{color:#6999d6;margin-top:0}.listingblock pre.CodeRay,.listingblock pre.prettyprint,.listingblock pre:not(.highlight),.listingblock pre[class=highlight],.listingblock pre[class^="highlight "],.literalblock pre{background:#eee}.sidebarblock .listingblock pre.CodeRay,.sidebarblock .listingblock pre.prettyprint,.sidebarblock .listingblock pre:not(.highlight),.sidebarblock .listingblock pre[class=highlight],.sidebarblock .listingblock pre[class^="highlight "],.sidebarblock .literalblock pre{background:#f2f1f1}.listingblock pre,.listingblock pre[class],.literalblock pre,.literalblock pre[class]{border:1px solid #ccc;-webkit-border-radius:0;border-radius:0;word-wrap:break-word;padding:.8em .8em .65em;font-size:.8125em}.listingblock pre.nowrap,.listingblock pre[class].nowrap,.literalblock pre.nowrap,.literalblock pre[class].nowrap{overflow-x:auto;white-space:pre;word-wrap:normal}#logo,ul.inline{overflow:hidden}@media only screen and (min-width:500px){.listingblock pre,.listingblock pre[class],.literalblock pre,.literalblock pre[class]{font-size:.90625em}}@media only screen and (min-width:1280px){.listingblock pre,.listingblock pre[class],.literalblock pre,.literalblock pre[class]{font-size:1em}}.literalblock.output pre{color:#eee;background-color:#000}.listingblock pre.highlightjs{padding:0}.listingblock pre.highlightjs>code{padding:.8em .8em .65em;-webkit-border-radius:0;border-radius:0}.listingblock>.content{position:relative}.listingblock.terminal pre .command:before{content:attr(data-prompt);padding-right:.5em;color:#999}.listingblock.terminal pre .command:not([data-prompt]):before{content:"$"}table.pyhltable{border-collapse:separate;border:0;background:0 0}table.pyhltable td{padding-top:0;padding-bottom:0;line-height:1.4}table.pyhltable td.code{padding-left:.75em;padding-right:0}pre.pygments .lineno,table.pyhltable td:not(.code){color:#999;padding-left:0;padding-right:.5em;border-right:1px solid #ddd}pre.pygments .lineno{display:inline-block;margin-right:.25em}table.pyhltable .linenodiv{background:0 0 !important;padding-right:0 !important}.quoteblock{margin:0 1em 1.25em 1.5em;display:table}.quoteblock .attribution br,.quoteblock .quoteblock blockquote:before,.verseblock .attribution br{display:none}.quoteblock>.title{margin-left:-1.5em;margin-bottom:.75em}.quoteblock blockquote,.quoteblock blockquote p{color:#6f6f6f;font-size:1.15rem;line-height:1.75;word-spacing:.1em;letter-spacing:0;font-style:italic;text-align:justify}.quoteblock blockquote{margin:0;padding:0;border:0}.quoteblock blockquote:before{content:"\201c";float:left;font-size:2.75em;font-weight:700;line-height:.6em;margin-left:-.6em;color:#6f6f6f;text-shadow:0 1px 2px rgba(0, 0, 0, .1)}.quoteblock blockquote>.paragraph:last-child p{margin-bottom:0}.quoteblock .attribution{margin-top:.5em;margin-right:.5ex;text-align:right}.quoteblock .quoteblock{margin-left:0;margin-right:0;padding:.5em 0;border-left:3px solid #555}.quoteblock .quoteblock blockquote{padding:0 0 0 .75em}.verseblock{margin:0 1em 1.25em}.verseblock pre{font-family:"Open Sans", "DejaVu Sans", sans;font-size:1.15rem;color:#6f6f6f;font-weight:300;text-rendering:optimizeLegibility}.verseblock pre strong{font-weight:400}.verseblock .attribution{margin-top:1.25rem;margin-left:.5ex}.quoteblock .attribution,.verseblock .attribution{font-size:.8125em;line-height:1.45;font-style:italic}.quoteblock .attribution cite,.verseblock .attribution cite{display:block;letter-spacing:-.025em;color:#555}.quoteblock.abstract{margin:0 0 1.25em;display:block}dl dd:last-child,dl dd:last-child>:last-child,table.tableblock td>.paragraph:last-child p>p:last-child,table.tableblock td>p:last-child,table.tableblock th>p:last-child{margin-bottom:0}.quoteblock.abstract blockquote,.quoteblock.abstract blockquote p{text-align:left;word-spacing:0}.quoteblock.abstract blockquote p:first-of-type:before,.quoteblock.abstract blockquote:before{display:none}table.tableblock{max-width:100%;border-collapse:separate}table.tableblock,td.tableblock,th.tableblock{border:0 solid #ddd}table.grid-all td.tableblock,table.grid-all th.tableblock{border-width:0 1px 1px 0}table.grid-all tfoot>tr>td.tableblock,table.grid-all tfoot>tr>th.tableblock{border-width:1px 1px 0 0}table.grid-cols td.tableblock,table.grid-cols th.tableblock{border-width:0 1px 0 0}table.grid-all *>tr>.tableblock:last-child,table.grid-cols *>tr>.tableblock:last-child{border-right-width:0}table.grid-rows td.tableblock,table.grid-rows th.tableblock{border-width:0 0 1px}table.grid-all tbody>tr:last-child>td.tableblock,table.grid-all tbody>tr:last-child>th.tableblock,table.grid-all thead:last-child>tr>th.tableblock,table.grid-rows tbody>tr:last-child>td.tableblock,table.grid-rows tbody>tr:last-child>th.tableblock,table.grid-rows thead:last-child>tr>th.tableblock{border-bottom-width:0}table.grid-rows tfoot>tr>td.tableblock,table.grid-rows tfoot>tr>th.tableblock{border-width:1px 0 0}table.frame-all{border-width:1px}table.frame-sides{border-width:0 1px}table.frame-topbot{border-width:1px 0}td.halign-left,th.halign-left{text-align:left}td.halign-right,th.halign-right{text-align:right}td.halign-center,th.halign-center{text-align:center}td.valign-bottom,th.valign-bottom{vertical-align:bottom}td.valign-middle,th.valign-middle{vertical-align:middle}table tfoot th,table thead th{font-weight:700}tbody tr th{display:table-cell;line-height:1.4;background:#f5f5f5}ul.inline>li,ul.inline>li>*{display:block}tbody tr th,tbody tr th p,tfoot tr th,tfoot tr th p{color:#222;font-weight:700}p.tableblock>code:only-child{background:0 0;padding:0}p.tableblock{font-size:1em}td>div.verse{white-space:pre}ol{margin-left:1.75em}ul li ol{margin-left:1.5em}dl dd{margin-left:1.125em}.olist .olist,.olist .ulist,.ulist .olist,.ulist .ulist,ol dd,ol>li p,ul dd,ul>li p{margin-bottom:.625em}ol.unnumbered,ul.checklist,ul.none,ul.unstyled{list-style-type:none}ol.unnumbered,ul.checklist,ul.unstyled{margin-left:.625em}ul.checklist li>p:first-child>.fa-check-square-o:first-child,ul.checklist li>p:first-child>.fa-square-o:first-child{width:1em;font-size:.85em}ul.checklist li>p:first-child>input[type=checkbox]:first-child{width:1em;position:relative;top:1px}ul.inline{margin:0 0 .625em -1.375em;padding:0}ul.inline>li{float:left;margin-left:1.375em}.conum[data-value],.th,.thumb,a.image{display:inline-block}.unstyled dl dt{font-weight:400;font-style:normal}ol.arabic{list-style-type:decimal}ol.decimal{list-style-type:decimal-leading-zero}ol.loweralpha{list-style-type:lower-alpha}ol.upperalpha{list-style-type:upper-alpha}ol.lowerroman{list-style-type:lower-roman}ol.upperroman{list-style-type:upper-roman}ol.lowergreek{list-style-type:lower-greek}.colist>table,.hdlist>table{border:0;background:0 0}.colist>table>tbody>tr,.hdlist>table>tbody>tr{background:0 0}td.hdlist1,td.hdlist2{vertical-align:top;padding:0 .625em}td.hdlist1{font-weight:700;padding-bottom:1.25em}.listingblock+.colist,.literalblock+.colist{margin-top:-.5em}.colist>table tr>td:first-of-type{padding:0 .75em;line-height:1}.colist>table tr>td:last-of-type{padding:.25em 0}.th,.thumb{line-height:0;border:4px solid #fff;-webkit-box-shadow:0 0 0 1px #ddd;box-shadow:0 0 0 1px #ddd}.imageblock.left,.imageblock[style*="float: left"]{margin:.25em .625em 1.25em 0}.imageblock.right,.imageblock[style*="float: right"]{margin:.25em 0 1.25em .625em}.imageblock>.title{margin-bottom:0}.imageblock.th,.imageblock.thumb{border-width:6px}.imageblock.th>.title,.imageblock.thumb>.title{padding:0 .125em}.image.left,.image.right{margin-top:.25em;margin-bottom:.25em;display:inline-block;line-height:0}.image.left{margin-right:.625em}.image.right{margin-left:.625em}a.image object{pointer-events:none}sup.footnote,sup.footnoteref{font-size:.875em;position:static;vertical-align:super}#logo,#menubar,#menubar>ul>li,#menubar>ul>li::after{position:relative}sup.footnote a:active,sup.footnoteref a:active{text-decoration:underline}#footnotes{padding-top:.75em;padding-bottom:.75em;margin-bottom:.625em}#footnotes hr{width:20%;min-width:6.25em;margin:-.25em 0 .75em;border-width:1px 0 0}#footnotes .footnote{padding:0 .375em .2em .225em;line-height:1.3334;font-size:.875em;margin-left:1.2em;text-indent:-1.05em;margin-bottom:.2em}#footnotes .footnote a:first-of-type{font-weight:700;text-decoration:none}#footnotes .footnote:last-of-type{margin-bottom:0}#content #footnotes{margin-top:-.625em;margin-bottom:0;padding:.75em 0}.gist .file-data>table{border:0;background:#fff;width:100%;margin-bottom:0}.gist .file-data>table td.line-data{width:99%}div.unbreakable{page-break-inside:avoid}.big{font-size:larger}.small{font-size:smaller}.x-small{font-size:x-small}.xx-small{font-size:xx-small}.x-large{font-size:x-large}.xx-large{font-size:xx-large}.underline{text-decoration:underline}.overline{text-decoration:overline}.line-through{text-decoration:line-through}.aqua{color:#00bfbf}.aqua-background{background-color:#00fafa}.black{color:#000}.black-background{background-color:#000}.blue{color:#0000bf}.blue-background{background-color:#0000fa}.fuchsia{color:#bf00bf}.fuchsia-background{background-color:#fa00fa}.gray{color:#606060}.gray-background{background-color:#7d7d7d}.green{color:#006000}.green-background{background-color:#007d00}.lime{color:#00bf00}.lime-background{background-color:#00fa00}.maroon{color:#600000}.maroon-background{background-color:#7d0000}.navy{color:#000060}.navy-background{background-color:#00007d}.olive{color:#606000}.olive-background{background-color:#7d7d00}.purple{color:#600060}.purple-background{background-color:#7d007d}.red{color:#bf0000}.red-background{background-color:#fa0000}.silver{color:#909090}.silver-background{background-color:#bcbcbc}.teal{color:#006060}.teal-background{background-color:#007d7d}.white{color:#bfbfbf}.white-background{background-color:#fafafa}.yellow{color:#bfbf00}.yellow-background{background-color:#fafa00}span.icon>.fa{cursor:default}.admonitionblock td.icon [class^="fa icon-"]{font-size:2.5em;text-shadow:1px 1px 2px rgba(0, 0, 0, .5);cursor:default}#clear,.treeview>li:hover{cursor:pointer}.admonitionblock td.icon .icon-note:before{content:"\f05a";color:#207c98}.admonitionblock td.icon .icon-tip:before{content:"\f0eb";text-shadow:1px 1px 2px rgba(155, 155, 0, .8);color:#111}.admonitionblock td.icon .icon-warning:before{content:"\f071";color:#bf6900}.admonitionblock td.icon .icon-caution:before{content:"\f06d";color:#bf3400}.admonitionblock td.icon .icon-important:before{content:"\f06a";color:#bf0000}.conum[data-value],.conum[data-value] *{color:#fff !important}.conum[data-value]{background-color:#222;-webkit-border-radius:100px;border-radius:100px;text-align:center;font-size:.75em;width:1.67em;height:1.67em;line-height:1.67em;font-family:"Open Sans", "DejaVu Sans", sans-serif;font-style:normal;font-weight:700}#menu,.conum:not([data-value]):empty,.conum[data-value]+b{display:none}.conum[data-value]:after{content:attr(data-value)}pre .conum[data-value]{position:relative;top:-.125em}b.conum *{color:inherit !important}.listingblock pre,.literalblock pre{background:#eee}div#remarks.ulist{max-width:70%}@media only screen and (max-width:800px){a#bottomright{visibility:hidden}#preamble>.sectionbody>.paragraph:first-of-type p,.paragraph.lead>p,.sectionbody.paragraph{max-width:100%}}#div.paragraph.faq-intro{max-width:66.66%}div.slicknav_menu{padding-top:5px;padding-right:15px;margin-left:200px;text-align:right;display:none;right:10px;font-size:1rem;color:#fff;padding-bottom:2rem;background:url(logo.png) 100px 0 no-repeat}span.slicknav_menutxt{margin-right:-20px;color:#fff}div.slicknav_menu a.scroll:first-of-type{color:#F7D425;font-size:120%;font-weight:600}div.slicknav_menu ul li a{color:#fff}div.slicknav_menu a:hover,div.slicknav_menu ul li a:hover{color:#F7D425}div.slicknav_menu a,div.slicknav_menu a:visited,li.slicknav_parent.slicknav_open{color:#fff}a.slicknav_btn{padding:1rem}@media screen and (max-width:890px){div.slicknav_menu{display:block;color:#fff}#mobile-banner{display:block}}@media screen and (max-width:470px){div.slicknav_menu ul:first-of-type{margin-top:1.5rem}div.slicknav_menu ul li{color:#fff}div.slicknav_menu ul li:hover{color:#F7D425}}div.slicknav_menu li:last-of-type{padding-bottom:.7rem}.banner{height:1rem;padding-right:2rem;max-height:1rem;max-width:50%;vertical-align:middle}@media (max-width:800px){.banner{flex-basis:66.66%;max-width:25%;margin:1rem}}#menubar ul{margin:0;padding:0 10px;white-space:nowrap;line-height:1.2rem}#menubar a,#menubar li{margin:0;padding:0}#menubar a{text-decoration:none}#menubar li{margin-left:0}#menubar{height:90px;max-width:1280px;margin-left:50px;color:#fff;font-size:1.9rem;border-bottom:#595959;border-bottom:2px solid #ddd}#menubar img{padding-left:45px;margin-top:15px;padding-top:.2rem}#menubar>ul>li{display:inline-block;margin:.2rem;z-index:10000;flex-basis:66.666%;font-weight:700}@media only screen and (max-width:500px){#menubar,#menubar>ul>li{visibility:hidden;display:none}#toc.toc2{display:none}}@media only screen and (max-width:500px){body.toc2.toc-right #tocbutton{visibility:hidden}#content,#footer,#footnotes,#header{margin-left:0;left:0}body.toc2{padding-left:20px;left:0}}@media only screen and (max-width:500px){#menubar{display:none}}#logo{margin-top:-55px;left:5px;top:10px}#menubar>ul>li::after{content:" · ";top:3px;padding-left:3px;font-weight:400}#menubar>ul>li:last-of-type::after{content:none}#menubar>ul>li>a{font-size:1.2rem;line-height:50px;font-weight:400;webkit-transition:color .15s;margin-left:0;-moz-transition:color .15s;-o-transition:color .15s;transition:color .15s;white-space:nowrap;-webkit-font-smoothing:auto;letter-spacing:-.01em;text-align:right}#iconTree li,#toc>ul>li>a,body.home li.home,body.tech li.tech{font-weight:700}#menubar>ul{margin-right:12px;margin-top:1px}#menubar>ul>li>a:hover{color:#F7D425}#menubar>ul>li>ul{opacity:0;visibility:hidden;padding:18px 0 20px;background-color:#FFF;text-align:left;position:absolute;top:55px;left:50%;margin-left:-90px;-webkit-transition:all .3s .1s;-moz-transition:all .3s .1s;-o-transition:all .3s .1s;transition:all .3s .1s;-webkit-border-radius:5px;-moz-border-radius:5px;border-radius:5px;-webkit-box-shadow:0 1px 3px rgba(0, 0, 0, .4);-moz-box-shadow:0 1px 3px rgba(0, 0, 0, .4);box-shadow:0 1px 3px rgba(0, 0, 0, .4)}#menubar>li li{width:100%}#menubar>ul>li:hover>ul{opacity:1;top:65px;visibility:visible}#menubar>ul>li>ul:before{content:'';display:block;border-color:transparent transparent #FFF;border-style:solid;border-width:10px;position:absolute;top:-20px;left:10%;margin-left:-10px}#menubar>ul ul>li{position:relative}#menubar ul ul a{color:#323232;font-family:ITC Officina Serif W01, sans-serif, Verdana, 'Lucida Grande';font-size:17px;background-color:#FFF;padding:5px 8px 7px 16px;display:block;-webkit-transition:background-color .1s;-moz-transition:background-color .1s;-o-transition:background-color .1s;transition:background-color .1s}#menubar ul ul ul{visibility:hidden;opacity:0;position:absolute;top:-16px;left:206px;padding:16px 0 20px;background-color:#527AA3;text-align:left;width:160px;-webkit-transition:all .3s;-moz-transition:all .3s;-o-transition:all .3s;transition:all .3s;-webkit-border-radius:5px;-moz-border-radius:5px;border-radius:5px;-webkit-box-shadow:0 1px 3px rgba(0, 0, 0, .4);-moz-box-shadow:0 1px 3px rgba(0, 0, 0, .4);box-shadow:0 1px 3px rgba(0, 0, 0, .4)}a.back-to-top,body.toc2.toc-right a.back-to-top{width:25px;height:25px;text-indent:-9999px;position:fixed;bottom:20px}#menubar ul ul>li:hover>ul{opacity:1;left:196px;visibility:visible}#menubar ul ul a:hover{background-color:#244D82;color:#F7D425}a.back-to-top{display:none;z-index:999;right:20px;background:url(../images/up-arrow.png) center 43% no-repeat #2ba6cb;-webkit-border-radius:30px;-moz-border-radius:30px;border-radius:30px}a:hover.back-to-top{background-color:#F7D425}#tocbutton{visibility:hidden}#tocbuttonbars.fa.fa-bars{z-index:1000;right:0}#tocbutton:hover{background:url(yellowbars.png) center 50% no-repeat}body.toc2.toc-right a.back-to-top{z-index:1001;right:90px;background:url(../images/up-arrow.png) center 43% no-repeat #2ba6cb;-webkit-border-radius:30px;-moz-border-radius:30px;border-radius:30px}body.toc2.toc-left #tocbutton,body.toc2.toc-right #tocbutton{visibility:visible;width:25px;text-indent:-9999px;border:none;height:25px;position:fixed;z-index:998}body.toc2.toc-right #tocbutton{right:25px;top:5px;background:url(yellowbars.png) center 50% no-repeat}body.toc2.toc-left #tocbutton{left:25px;top:25px;background:url(bars-blue.png) center 50% no-repeat}body.toc2.toc-right #tocbutton:hover{background:url(yellowbars.png) center 50% no-repeat}#pagesearch,.treeview li{background-repeat:no-repeat}body.toc2.toc-right a:hover.back-to-top{background-color:#F7D425}@media only screen and (max-width:1000px){#toc.toc2{display:none}}@media only screen and (max-width:500px){body.toc2.toc-left #tocbutton{visibility:hidden}#toc.toc2{width:100%;left:0}#content,#footer,#footnotes,#header{margin-left:0;margin-right:50px}}@media only screen and (max-width:1462px){a.back-to-top{left:90%}}div.openblock.definition{border:1px solid #aaa;margin-bottom:1rem;background-color:#f0f8ff;border-radius:10px;padding:1rem}.requirement{border:1px solid #aaa;margin-bottom:1rem;background-color:#f5f5f5;border-radius:10px;padding:1rem}.bibliography .content .paragraph p:first-child::before{color:#777;content:"[" attr(id) "] "}.bibliography .content .paragraph{padding-left:6em;text-indent:-6em}.hold,.todo{padding:12px;margin-bottom:15px}.todo{color:#dc143c;border:dotted #dc143c;border-width:2px;border-radius:15px;background-color:#fff8dc}.todo::before{content:"TODO"}.hold{color:#ff8c00;border:dotted #ff8c00;border-width:2px;border-radius:15px;background-color:#f5f5f5}.hold::before{content:"ON HOLD"}#toc>ul>li>a{color:#595959;font-size:medium}#toc a:hover,.active,.found{color:#000}#iconTree li,#toclist>li>ul>li{font-size:90%}.treeview,.treeview ul{list-style-type:none;overflow:hidden}.treeview li{text-indent:10%;margin-top:0;padding:.2em 0 0;line-height:20px;background-size:16px 16px;background-position-y:4px}#iconTree li{line-height:15px;background-size:16px 16px}.treeview li.contains-items{font-weight:700;background-image:url(../images/expand.png);background-size:16px 16px}.treeview li.items-expanded{font-weight:400;background-image:url(../images/collapse.png);background-size:16px 16px}.active,.found,.items-expanded>a::first-of-type{font-weight:700}.treview-dotted-lines li{margin-top:.4em !important}.treview-dotted-lines li.items-expanded li{font-weight:700;border-left:1px dotted #444;border-bottom:1px dotted #444;width:60%}.treeview span.has-node-icon{text-indent:2%;margin-top:.2em;padding:.15em 0 .5em 1em;line-height:22px;background-repeat:no-repeat;background-size:24px 24px}.treeview span{padding:5px}.treeview span:not(.has-node-icon):hover{background-color:rgba(246, 246, 246, .7)}#collapsetoc{outline:0;display:none;width:25px;height:25px;text-indent:-9999px;position:fixed;z-index:998;border:none;left:25px;top:55px;background:url(../images/arrow-down.png) center 50% no-repeat}#collapsetoc.inactive{background-image:url(../images/arrow-right.png)}.active{border-right:3px solid #2ba6cb}#toc{margin-top:0}#toc>ul{margin-left:0;padding-left:0}#toc ul.sectlevel0>li>a{font-style:italic}#toc ul.sectlevel0 ul.sectlevel1{margin:0}#toc ul{font-family:"Helvetica Neue", Helvetica, Helvetica, Arial, sans-serif;list-style-type:none}#toc a{color:#595959}#toc a:active{text-decoration:underline}#pagesearch{background-image:url(../images/searchicon.png);background-position:5px 5px;width:100%;font-size:16px;padding:6px 10px 6px 40px;border:1px solid #ddd;margin-bottom:12px}#clear{position:absolute;right:10px;top:72px;bottom:0;height:14px;font-size:14px;color:#ccc}
\ No newline at end of file
diff --git a/design/styles/styles.min.css b/design/styles/styles.min.css
new file mode 100644
index 0000000..8cc9d44
--- /dev/null
+++ b/design/styles/styles.min.css
@@ -0,0 +1 @@
+@charset "UTF-8";*,:after,:before{position:relative;margin:0;padding:0;box-sizing:inherit}button,input,select,textarea{font:inherit;-webkit-appearance:none;-moz-appearance:none;appearance:none}input[type=checkbox]{-webkit-appearance:checkbox;-moz-appearance:checkbox;appearance:checkbox}input[type=radio]{-webkit-appearance:radio;-moz-appearance:radio;appearance:radio}table{border-collapse:collapse}html{box-sizing:border-box;font-size:10px}.Comparison,.ExampleExplanation,.FeatureTable,.Grid{display:-webkit-flex;display:-ms-flexbox;display:flex;-webkit-align-items:stretch;-ms-flex-align:stretch;align-items:stretch;-webkit-flex-wrap:wrap;-ms-flex-wrap:wrap;flex-wrap:wrap;-webkit-flex:0 1 auto;-ms-flex:0 1 auto;flex:0 1 auto;-webkit-flex-direction:row;-ms-flex-direction:row;flex-direction:row}.Comparison,.ExampleExplanation,.Grid--fullWidth{margin-left:-2rem;margin-right:-2rem}.Comparison .Cell:first-child,.Comparison .Comparison-left:first-child,.Comparison .Comparison-right:first-child,.Comparison .FeatureTabs .FeatureTabs-stage:first-child,.Comparison .Intro .Intro-Slogan:first-child,.ExampleExplanation .Cell:first-child,.ExampleExplanation .ExampleExplanation-code:first-child,.ExampleExplanation .ExampleExplanation-text:first-child,.ExampleExplanation .FeatureTabs .FeatureTabs-stage:first-child,.ExampleExplanation .Intro .Intro-Slogan:first-child,.FeatureTabs .Comparison .FeatureTabs-stage:first-child,.FeatureTabs .ExampleExplanation .FeatureTabs-stage:first-child,.FeatureTabs .Grid--fullWidth .FeatureTabs-stage:first-child,.Grid--fullWidth .Cell:first-child,.Grid--fullWidth .FeatureTabs .FeatureTabs-stage:first-child,.Grid--fullWidth .Intro .Intro-Slogan:first-child,.Intro .Comparison .Intro-Slogan:first-child,.Intro .ExampleExplanation .Intro-Slogan:first-child,.Intro .Grid--fullWidth .Intro-Slogan:first-child{padding-left:4rem}.Comparison .Cell:last-child,.Comparison .Comparison-left:last-child,.Comparison .Comparison-right:last-child,.Comparison .FeatureTabs .FeatureTabs-stage:last-child,.Comparison .Intro .Intro-Slogan:last-child,.ExampleExplanation .Cell:last-child,.ExampleExplanation .ExampleExplanation-code:last-child,.ExampleExplanation .ExampleExplanation-text:last-child,.ExampleExplanation .FeatureTabs .FeatureTabs-stage:last-child,.ExampleExplanation .Intro .Intro-Slogan:last-child,.FeatureTabs .Comparison .FeatureTabs-stage:last-child,.FeatureTabs .ExampleExplanation .FeatureTabs-stage:last-child,.FeatureTabs .Grid--fullWidth .FeatureTabs-stage:last-child,.Grid--fullWidth .Cell:last-child,.Grid--fullWidth .FeatureTabs .FeatureTabs-stage:last-child,.Grid--fullWidth .Intro .Intro-Slogan:last-child,.Intro .Comparison .Intro-Slogan:last-child,.Intro .ExampleExplanation .Intro-Slogan:last-child,.Intro .Grid--fullWidth .Intro-Slogan:last-child{padding-right:4rem}@media (max-width:800px){.Comparison,.ExampleExplanation,.Grid--fullWidth{margin-left:-.75rem;margin-right:-.75rem}.Comparison .Cell:first-child,.Comparison .Cell:last-child,.Comparison .Comparison-left:first-child,.Comparison .Comparison-left:last-child,.Comparison .Comparison-right:first-child,.Comparison .Comparison-right:last-child,.Comparison .FeatureTabs .FeatureTabs-stage:first-child,.Comparison .FeatureTabs .FeatureTabs-stage:last-child,.Comparison .Intro .Intro-Slogan:first-child,.Comparison .Intro .Intro-Slogan:last-child,.ExampleExplanation .Cell:first-child,.ExampleExplanation .Cell:last-child,.ExampleExplanation .ExampleExplanation-code:first-child,.ExampleExplanation .ExampleExplanation-code:last-child,.ExampleExplanation .ExampleExplanation-text:first-child,.ExampleExplanation .ExampleExplanation-text:last-child,.ExampleExplanation .FeatureTabs .FeatureTabs-stage:first-child,.ExampleExplanation .FeatureTabs .FeatureTabs-stage:last-child,.ExampleExplanation .Intro .Intro-Slogan:first-child,.ExampleExplanation .Intro .Intro-Slogan:last-child,.FeatureTabs .Comparison .FeatureTabs-stage:first-child,.FeatureTabs .Comparison .FeatureTabs-stage:last-child,.FeatureTabs .ExampleExplanation .FeatureTabs-stage:first-child,.FeatureTabs .ExampleExplanation .FeatureTabs-stage:last-child,.FeatureTabs .Grid--fullWidth .FeatureTabs-stage:first-child,.FeatureTabs .Grid--fullWidth .FeatureTabs-stage:last-child,.Grid--fullWidth .Cell:first-child,.Grid--fullWidth .Cell:last-child,.Grid--fullWidth .FeatureTabs .FeatureTabs-stage:first-child,.Grid--fullWidth .FeatureTabs .FeatureTabs-stage:last-child,.Grid--fullWidth .Intro .Intro-Slogan:first-child,.Grid--fullWidth .Intro .Intro-Slogan:last-child,.Intro .Comparison .Intro-Slogan:first-child,.Intro .Comparison .Intro-Slogan:last-child,.Intro .ExampleExplanation .Intro-Slogan:first-child,.Intro .ExampleExplanation .Intro-Slogan:last-child,.Intro .Grid--fullWidth .Intro-Slogan:first-child,.Intro .Grid--fullWidth .Intro-Slogan:last-child{padding-left:1.5rem}}.Example,.Image.Image--fullWidth,.TODO,.u-fullWidth{margin-left:-2rem;margin-right:-2rem;padding-left:4rem;padding-right:4rem}.Cell,.Comparison .Comparison-left,.Comparison .Comparison-right,.ExampleExplanation .ExampleExplanation-code,.ExampleExplanation .ExampleExplanation-text,.FeatureTabs .FeatureTabs-stage,.Intro .Intro-Slogan{padding-left:2rem;padding-right:2rem;-webkit-flex:0 0 auto;-ms-flex:0 0 auto;flex:0 0 auto}@media (max-width:800px){.Cell,.Comparison .Comparison-left,.Comparison .Comparison-right,.ExampleExplanation .ExampleExplanation-code,.ExampleExplanation .ExampleExplanation-text,.FeatureTabs .FeatureTabs-stage,.Intro .Intro-Slogan{-webkit-flex-basis:100%;-ms-flex-preferred-size:100%;flex-basis:100%;max-width:100%}.m-Cell--withMargin{margin-bottom:3rem}}.Cell--3-12{-webkit-flex-basis:25%;-ms-flex-preferred-size:25%;flex-basis:25%;max-width:25%}.Nav,.u-width--3-12,nav.Nav--bottom,nav.Nav--top{max-width:25%;width:100%}@media (max-width:800px){.Nav,.u-width--3-12,nav.Nav--bottom,nav.Nav--top{max-width:100%}}.Cell--4-12,.ExampleExplanation .ExampleExplanation-text{-webkit-flex-basis:33.333%;-ms-flex-preferred-size:33.333%;flex-basis:33.333%;max-width:33.333%}@media (max-width:800px){.Cell--4-12,.ExampleExplanation .ExampleExplanation-text{-webkit-flex-basis:100%;-ms-flex-preferred-size:100%;flex-basis:100%;max-width:100%}}.Cell--6-12,.Comparison .Comparison-left,.Comparison .Comparison-right{-webkit-flex-basis:50%;-ms-flex-preferred-size:50%;flex-basis:50%;max-width:50%}@media (max-width:800px){.Cell--6-12,.Comparison .Comparison-left,.Comparison .Comparison-right{-webkit-flex-basis:100%;-ms-flex-preferred-size:100%;flex-basis:100%;max-width:100%}}.Cell--8-12,.ExampleExplanation .ExampleExplanation-code{-webkit-flex-basis:66.666%;-ms-flex-preferred-size:66.666%;flex-basis:66.666%;max-width:66.666%}@media (max-width:800px){.Cell--8-12,.ExampleExplanation .ExampleExplanation-code{-webkit-flex-basis:100%;-ms-flex-preferred-size:100%;flex-basis:100%;max-width:100%}}.Main article.Article--noGrid>.Image:not(.Image--fullWidth),.Main article.Article--noGrid>h1,.Main article.Article--noGrid>h2,.Main article.Article--noGrid>h3,.Main article.Article--noGrid>h4,.Main article.Article--noGrid>img,.Main article.Article--noGrid>ol,.Main article.Article--noGrid>p,.Main article.Article--noGrid>table,.Main article.Article--noGrid>ul,.u-width--8-12,main article.Article--noGrid>.Image:not(.Image--fullWidth),main article.Article--noGrid>h1,main article.Article--noGrid>h2,main article.Article--noGrid>h3,main article.Article--noGrid>h4,main article.Article--noGrid>img,main article.Article--noGrid>ol,main article.Article--noGrid>p,main article.Article--noGrid>table,main article.Article--noGrid>ul{max-width:66.666%;width:100%}@media (max-width:800px){.Main article.Article--noGrid>.Image:not(.Image--fullWidth),.Main article.Article--noGrid>h1,.Main article.Article--noGrid>h2,.Main article.Article--noGrid>h3,.Main article.Article--noGrid>h4,.Main article.Article--noGrid>img,.Main article.Article--noGrid>ol,.Main article.Article--noGrid>p,.Main article.Article--noGrid>table,.Main article.Article--noGrid>ul,.u-width--8-12,main article.Article--noGrid>.Image:not(.Image--fullWidth),main article.Article--noGrid>h1,main article.Article--noGrid>h2,main article.Article--noGrid>h3,main article.Article--noGrid>h4,main article.Article--noGrid>img,main article.Article--noGrid>ol,main article.Article--noGrid>p,main article.Article--noGrid>table,main article.Article--noGrid>ul{max-width:100%}}.Cell--9-12,.FeatureTabs .FeatureTabs-stage,.Intro .Intro-Slogan{-webkit-flex-basis:75%;-ms-flex-preferred-size:75%;flex-basis:75%;max-width:75%}.Cell--12-12{-webkit-flex-basis:100%;-ms-flex-preferred-size:100%;flex-basis:100%;max-width:100%}.Sans,body{font-family:sans-serif;font-weight:400}.FeatureTable .section,.H2,.H3,.H4,.Introduction,.Sans--bold,.Serif--bold,h1,h2,h3,h4,ul li:before{font-family:sans-serif;font-weight:600}body{font-size:1.9rem;line-height:1.4;color:#212121;background-color:#527aa3}h1{font-size:2em;margin-top:0;margin-bottom:4rem;color:#244d82}.FeatureTable .section,.H2,.H3,h2,h3{margin-top:4rem;margin-bottom:2rem}.FeatureTable .section,.H2,h2{font-size:1.3em;color:#244d82}.H3,.H4,h3,h4{font-size:1em}.H4,h4{margin-top:.5em;margin-bottom:0}ol,p,ul{margin-bottom:.5em}.Link,a{color:#6999d6}a:hover{color:#132445}.Link.Link--action,a.Link--action{color:#f7d425;text-decoration:none}.Link.Link--action:hover,a.Link--action:hover{text-decoration:underline}.Example .Example-caption,.FeatureTable,.FeatureTabs .FeatureTabs-stage ul,.Image .Image-caption,.SystemRequirements,.u-small,small{font-size:.8em;line-height:1.4em}ol ol,ol ul,ul ol,ul ul{margin-left:2em}ol li,ul li{margin-bottom:.2em}ol{margin-left:1.2em}ul{margin-left:.75em}ul li{list-style:none}ul li:before{content:"›";margin-left:-.75em;margin-right:.4em;color:#244d82}code{font-family:Fira Mono,Monaco,Consolas,Courier New,Courier,mono,serif;font-size:.85em;letter-spacing:.02em}img{width:100%;height:auto}h1:first-child,h2:first-child,h3:first-child{margin-top:0}.Main,.Page,footer,header,main{width:100%;max-width:1050px;margin-right:auto;margin-left:auto;padding-left:2rem;padding-right:2rem}.Main,main{background-color:#fff;position:relative}footer,header{background-color:#132445}.Main article,main article{margin-top:4rem;margin-bottom:4rem}.Main article:first-of-type,main article:first-of-type{margin-top:0;padding-top:0}@media (max-width:800px){.Main,.Page,footer,header,main{padding-left:.75rem;padding-right:.75rem}.Main article:first-of-type,main article:first-of-type{padding-top:1.5rem}}.Main article:last-of-type,main article:last-of-type{margin-bottom:0;padding-bottom:4rem}.Main article.Article--noGrid>h1,.Main article.Article--noGrid>h2,.Main article.Article--noGrid>h3,.Main article.Article--noGrid>h4,.Main article.Article--noGrid>ol,.Main article.Article--noGrid>p,.Main article.Article--noGrid>ul,main article.Article--noGrid>h1,main article.Article--noGrid>h2,main article.Article--noGrid>h3,main article.Article--noGrid>h4,main article.Article--noGrid>ol,main article.Article--noGrid>p,main article.Article--noGrid>ul{padding-left:2rem}@media (max-width:800px){.Main article.Article--noGrid>h1,.Main article.Article--noGrid>h2,.Main article.Article--noGrid>h3,.Main article.Article--noGrid>h4,.Main article.Article--noGrid>ol,.Main article.Article--noGrid>p,.Main article.Article--noGrid>ul,main article.Article--noGrid>h1,main article.Article--noGrid>h2,main article.Article--noGrid>h3,main article.Article--noGrid>h4,main article.Article--noGrid>ol,main article.Article--noGrid>p,main article.Article--noGrid>ul{padding-left:.75rem;padding-right:.75rem}}.Main article.Article--noGrid>table,main article.Article--noGrid>table{margin-left:2rem;margin-right:2rem;margin-bottom:2rem}.Main article.Article--noGrid>table td,.Main article.Article--noGrid>table th,main article.Article--noGrid>table td,main article.Article--noGrid>table th{padding:.2em .5em}.Main article.Article--noGrid>table th,main article.Article--noGrid>table th{text-align:left}.Main article.Article--noGrid>.Image:not(.Image--fullWidth),.Main article.Article--noGrid>img,main article.Article--noGrid>.Image:not(.Image--fullWidth),main article.Article--noGrid>img{padding-left:2rem;margin-top:2rem;margin-bottom:2rem}header{height:7rem;color:#fff;padding-top:1.7rem;padding-bottom:.8rem}header img{height:4rem;width:auto;margin:0}header nav{border:none;line-height:1em;padding-top:1.8rem;text-align:right}header nav a{display:inline-block;text-decoration:none;padding:0 1rem;transition:color .3s;color:#fff}header nav a.is-active,header nav a:hover{color:#f7d425}header nav a:last-child{padding-right:16px}footer{color:#fff;padding-top:2rem;padding-bottom:2rem}footer a{color:#d5dfea}footer a:hover{color:#F7D425}footer .Link--action{float:right}footer a,footer a:hover{text-decoration:none}.Nav,nav.Nav--bottom,nav.Nav--top{position:absolute;z-index:1;padding-left:2rem;border-left:1px solid #d3d3d3}@media (max-width:800px){header{height:auto}header img{max-width:100%;max-height:4rem;height:auto}header nav{display:none}footer{text-align:center}footer .Link--action{display:block;width:100%;float:none}.Nav,nav.Nav--bottom,nav.Nav--top{position:static;width:100%;padding-left:.75rem;border-left:none;padding-top:1.5rem;padding-bottom:3rem;border-bottom:1px solid #d3d3d3}}.Nav li:last-child,.Nav ul,nav.Nav--bottom li:last-child,nav.Nav--bottom ul,nav.Nav--top li:last-child,nav.Nav--top ul{margin-bottom:0}.Nav a,nav.Nav--bottom a,nav.Nav--top a{text-decoration:none;color:rgba(0,0,0,.3);transition:.2s}.Nav a.is-active,.Nav a:hover,nav.Nav--bottom a.is-active,nav.Nav--bottom a:hover,nav.Nav--top a.is-active,nav.Nav--top a:hover{color:#212121}.Nav.Nav--top,nav.Nav--bottom.Nav--top,nav.Nav--top.Nav--top{right:4rem;top:4rem}.Nav.Nav--bottom,nav.Nav--bottom.Nav--bottom,nav.Nav--top.Nav--bottom{right:4rem;bottom:4rem}.Intro{background-color:#244d82;padding:4rem 0;margin-bottom:-4rem;position:relative}@media (max-width:800px){.Intro{padding:0}}.Intro .Intro-Slogan{color:#fff;font-size:2em;padding:1rem 0;margin:0 auto}@media (max-width:800px){.Intro .Intro-Slogan{-webkit-flex-basis:100%;-ms-flex-preferred-size:100%;flex-basis:100%;max-width:100%;font-size:1.4em;padding:.5rem 2.5rem 1rem;padding-left:2.5rem!important}}.Intro img{z-index:1;margin:0;height:100%;width:100%}.Intro:after{content:"";position:absolute;left:0;right:0;bottom:0;top:65%;z-index:0;background-color:#fff}.GettingStarted{background-color:#fbffb4;padding:4rem 0}@media (max-width:800px){.GettingStarted h2{padding-left:1.5rem}}.GettingStarted .GettingStarted-u-paddingLeft{padding-left:4rem}.GettingStarted .GettingStarted-u-paddingRight{padding-right:4rem}@media (max-width:800px){.GettingStarted .GettingStarted-u-paddingLeft{margin-bottom:3rem;padding-left:3rem}.GettingStarted .GettingStarted-u-paddingRight{padding-right:3rem}}.SystemRequirements{color:rgba(0,0,0,.3);margin-top:2rem}.Comparison,.TODO{margin-top:4rem;margin-bottom:4rem}.TODO{padding-top:.5em;padding-bottom:.5em;color:#fff;background-color:#f39797}.TODO:before{content:"TODO: ";font-weight:700}.Comparison .Comparison-left{border-right:1px solid #d3d3d3}.Comparison .Comparison-left .Example,.Comparison .Comparison-left .Example-caption{margin-left:-4rem;margin-right:-2rem;padding-left:4rem;padding-right:2rem}.Comparison .Comparison-right .Example,.Comparison .Comparison-right .Example-caption{margin-left:-2rem;margin-right:-4rem;padding-left:2rem;padding-right:4rem}@media (max-width:800px){.Comparison .Comparison-left .Example,.Comparison .Comparison-left .Example-caption,.Comparison .Comparison-right .Example{padding-left:4rem;padding-right:4rem}.Comparison .Comparison-left .Example-caption{margin-right:-4rem}.Comparison .Comparison-right .Example-caption{padding-left:4rem;padding-right:4rem;margin-left:-4rem}}.Example{margin-top:2rem;margin-bottom:2rem}.Example .Example-code,.Example .dp-highlighter{padding-top:2rem;padding-bottom:2rem}.Example .Example-caption{margin-left:-4rem;margin-right:-4rem;padding:.5rem 4rem;background-color:#d5dfea}.ExampleExplanation{margin-top:4rem;margin-bottom:4rem}.ExampleExplanation .ExampleExplanation-text{background-color:#d5dfea;padding-top:2rem;padding-bottom:2rem}.ExampleExplanation .ExampleExplanation-code{padding-top:2rem;padding-bottom:2rem}.ExampleExplanation .ExampleExplanation-code .Example,.ExampleExplanation .ExampleExplanation-code .dp-highlighter{margin:0;padding:0}.Example,.ExampleExplanation-code{background-color:#f5f7fa}.Example .dp-highlighter,.ExampleExplanation-code .dp-highlighter{font-family:Fira Mono,Monaco,Consolas,Courier New,Courier,mono,serif;font-size:.7em;line-height:1.4em;overflow:auto}.Example .dp-highlighter ol,.Example .dp-highlighter ol li,.Example .dp-highlighter ol li span,.ExampleExplanation-code .dp-highlighter ol,.ExampleExplanation-code .dp-highlighter ol li,.ExampleExplanation-code .dp-highlighter ol li span{margin:0;padding:0;border:none}.Example .dp-highlighter ol li,.ExampleExplanation-code .dp-highlighter ol li{white-space:nowrap}.Example .dp-highlighter a,.Example .dp-highlighter a:hover,.ExampleExplanation-code .dp-highlighter a,.ExampleExplanation-code .dp-highlighter a:hover{background:0 0;border:none;padding:0;margin:0}.Example .dp-highlighter .bar,.ExampleExplanation-code .dp-highlighter .bar{padding-left:45px}.Example .dp-highlighter.collapsed .bar,.Example .dp-highlighter.nogutter .bar,.ExampleExplanation-code .dp-highlighter.collapsed .bar,.ExampleExplanation-code .dp-highlighter.nogutter .bar{padding-left:0}.Example .dp-highlighter ol,.ExampleExplanation-code .dp-highlighter ol{list-style:decimal;margin:0 0 0 34px!important;padding:0;color:rgba(0,0,0,.3)}.Example .dp-highlighter.nogutter ol,.Example .dp-highlighter.nogutter ol li,.ExampleExplanation-code .dp-highlighter.nogutter ol,.ExampleExplanation-code .dp-highlighter.nogutter ol li{list-style:none!important;margin-left:0!important}.Example .dp-highlighter .columns div,.Example .dp-highlighter ol li,.ExampleExplanation-code .dp-highlighter .columns div,.ExampleExplanation-code .dp-highlighter ol li{list-style:decimal-leading-zero;list-style-position:outside!important;margin:0!important;line-height:1.4em}.Example .dp-highlighter.nogutter .columns div,.Example .dp-highlighter.nogutter ol li,.ExampleExplanation-code .dp-highlighter.nogutter .columns div,.ExampleExplanation-code .dp-highlighter.nogutter ol li{border:0}.Example .dp-highlighter .columns,.ExampleExplanation-code .dp-highlighter .columns{background-color:#f8f8f8;color:gray;overflow:hidden;width:100%}.Example .dp-highlighter .columns div,.ExampleExplanation-code .dp-highlighter .columns div{padding-bottom:5px}.Example .dp-highlighter ol li.alt,.ExampleExplanation-code .dp-highlighter ol li.alt{color:inherit}.Example .dp-highlighter ol li span,.ExampleExplanation-code .dp-highlighter ol li span{color:#000;background-color:inherit}.Example .dp-highlighter.collapsed ol,.ExampleExplanation-code .dp-highlighter.collapsed ol{margin:0}.Example .dp-highlighter.collapsed ol li,.ExampleExplanation-code .dp-highlighter.collapsed ol li{display:none}.Example .dp-highlighter.printing,.ExampleExplanation-code .dp-highlighter.printing{border:none}.Example .dp-highlighter.printing .tools,.ExampleExplanation-code .dp-highlighter.printing .tools{display:none!important}.Example .dp-highlighter.printing li,.ExampleExplanation-code .dp-highlighter.printing li{display:list-item!important}.Example .dp-highlighter .tools,.ExampleExplanation-code .dp-highlighter .tools{padding:3px 8px 10px 10px;font:9px Verdana,Geneva,Arial,Helvetica,sans-serif;color:silver;border-left:1px solid #000}.Example .dp-highlighter.nogutter .tools,.ExampleExplanation-code .dp-highlighter.nogutter .tools{border-left:0}.Example .dp-highlighter.collapsed .tools,.ExampleExplanation-code .dp-highlighter.collapsed .tools{border-bottom:0}.Example .dp-highlighter .tools a,.ExampleExplanation-code .dp-highlighter .tools a{font-size:9px;color:#a0a0a0;text-decoration:none;margin-right:10px}.Example .dp-highlighter .tools a:hover,.ExampleExplanation-code .dp-highlighter .tools a:hover{color:red;background-color:inherit;text-decoration:underline}.Example .dp-about,.ExampleExplanation-code .dp-about{background-color:#fff;color:#333;margin:0;padding:0}.Example .dp-about table,.ExampleExplanation-code .dp-about table{width:100%;height:100%;font-size:11px;font-family:Tahoma,Verdana,Arial,sans-serif!important}.Example .dp-about td,.ExampleExplanation-code .dp-about td{padding:10px;vertical-align:top}.Example .dp-about .copy,.ExampleExplanation-code .dp-about .copy{border-bottom:1px solid #aca899;height:95%}.Example .dp-about .title,.ExampleExplanation-code .dp-about .title{color:red;background-color:inherit;font-weight:700}.Example .dp-about .para,.ExampleExplanation-code .dp-about .para{margin:0 0 4px}.Image,.Table{margin-bottom:2rem;margin-top:2rem}.Example .dp-about .footer,.ExampleExplanation-code .dp-about .footer{background-color:#eceadb;color:#333;border-top:1px solid #fff;text-align:right}.Example .dp-about .close,.ExampleExplanation-code .dp-about .close{font-size:11px;font-family:Tahoma,Verdana,Arial,sans-serif!important;background-color:#eceadb;color:#333;width:60px;height:22px}.Example .dp-highlighter .comment,.Example .dp-highlighter .comments,.ExampleExplanation-code .dp-highlighter .comment,.ExampleExplanation-code .dp-highlighter .comments{color:#3f6a4d;background-color:inherit}.Example .dp-highlighter .string,.ExampleExplanation-code .dp-highlighter .string{color:#101af9;background-color:inherit}.Example .dp-highlighter .keyword,.ExampleExplanation-code .dp-highlighter .keyword{color:#5f1441;font-weight:700;background-color:inherit}.Example .dp-highlighter .annotation,.ExampleExplanation-code .dp-highlighter .annotation{color:red;font-weight:700;background-color:inherit}.Example .dp-highlighter .preprocessor,.ExampleExplanation-code .dp-highlighter .preprocessor{color:#0f0;background-color:inherit}.Image{position:relative;text-align:center}.Image .Image-caption{padding-top:.5rem;padding-bottom:.5rem;text-align:left}.Image img{max-width:100%;max-height:100%;height:auto;width:auto}.Table th{background-color:#d5dfea}.Table td,.Table th,.Table tr{border:0 solid #d3d3d3}.Table.Table--horizontalLines tr{border-top-width:1px}.Table.Table--horizontalLines tr:last-child{border-bottom-width:1px}.Table.Table--verticalLines td,.Table.Table--verticalLines th{border-left-width:1px}.Table.Table--verticalLines td:last-child,.Table.Table--verticalLines th:last-child{border-right-width:1px}.FeatureTable tr:first-child th:first-child{width:25%}.FeatureTable .section{padding:1.5em 0 .5em}.FeatureTable .done{background-color:#efe}.FeatureTable .most{background-color:#ffd}.FeatureTable .tbc{background-color:#fff6de}.FeatureTable .tbd{background-color:#fee}.FeatureTabs .FeatureTabs-nav{background-color:#f5f7fa}.FeatureTabs .FeatureTabs-nav ul{margin-bottom:0;margin-left:0}@media (max-width:800px){.FeatureTabs .FeatureTabs-nav ul{display:none}}.FeatureTabs .FeatureTabs-nav ul li{display:block;padding-top:2rem;padding-bottom:2rem;border-bottom:1px solid #d3d3d3}.FeatureTabs .FeatureTabs-nav ul li:before{display:none}.FeatureTabs .FeatureTabs-nav ul li:last-child{border-bottom:none}.FeatureTabs .FeatureTabs-nav a{text-decoration:none;color:rgba(0,0,0,.3);transition:.3s}.FeatureTabs .FeatureTabs-nav a.is-activeTab,.FeatureTabs .FeatureTabs-nav a:hover{color:#212121}.FeatureTabs .FeatureTabs-stage{display:none;background-color:#d5dfea;padding-top:2rem;padding-bottom:2rem}.FeatureTabs .FeatureTabs-stage.is-activeTab{display:block}.FeatureTabs .FeatureTabs-stage img{margin-bottom:2rem}@media (max-width:800px){.FeatureTabs .FeatureTabs-stage{display:block;-webkit-flex-basis:100%;-ms-flex-preferred-size:100%;flex-basis:100%;max-width:100%;border-bottom:1px solid #94afc9;padding-left:3.75rem;padding-right:3.75rem}.FeatureTabs .FeatureTabs-stage h2{margin-bottom:.5rem}}.FeatureTabs .FeatureTabs-stage ul{display:-webkit-flex;display:-ms-flexbox;display:flex;margin-left:0;margin-top:2rem;color:rgba(0,0,0,.3)}.FeatureTabs .FeatureTabs-stage ul li{-webkit-flex-grow:1;-ms-flex-positive:1;flex-grow:1;padding-right:1rem}@media (max-width:800px){.FeatureTabs .FeatureTabs-stage ul{margin-top:.5rem;margin-bottom:1.5rem;display:block}.FeatureTabs .FeatureTabs-stage ul li{-webkit-flex-grow:none;-ms-flex-positive:none;flex-grow:none;width:100%;display:block}}.FeatureTabs .FeatureTabs-stage ul li:before{content:"✓";margin:0 .3em 0 0}.FeatureTabs .FeatureTabs-stage a{text-decoration:none;color:#244d82}.FeatureTabs .FeatureTabs-stage a:hover{text-decoration:underline}#community ul{padding-bottom:1rem;padding-top:1em}footer.social{line-height:1.4;color:#FFF;font-size:1.2rem;font-weight:400;font-style:bold;background-color:#132445}footer.social li a{margin-bottom:2em;color:#d5dfea;font-size:1.8rem;font-weight:400;font-style:bold;list-style:none;text-decoration-color:#d5dfea}footer.social a:hover{color:#F7D425}footer.social:first-child{margin-top:0}footer.social h2{margin-bottom:20px;font-weight:600;font-size:1.3em;margin-top:4rem;color:#244d82;font-family:sans-serif}footer.social li:before{content:"› ";color:#244d82;font-size:large;font-weight:800}footer.social ul{margin-top:-10px;line-height:30px}footer.social li{display:-webkit-inline-box;padding-right:10rem;padding-bottom:1rem}
diff --git a/design/tests.html b/design/tests.html
new file mode 100644
index 0000000..e9d877f
--- /dev/null
+++ b/design/tests.html
@@ -0,0 +1,3341 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="generator" content="Asciidoctor 1.5.5">
+<meta name="author" content="2019-08-07 15:02:40 CEST">
+<title>N4JS Design Specification</title>
+<link rel="stylesheet" href="styles/spec.min.css">
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.6.3/css/font-awesome.min.css">
+<!-- ************* docinfo ******************************************************************* -->
+
+
+<!-- ************* Favicon ************-->
+<link rel="icon" href="images/favicon.ico" />
+
+<!-- ************* Back-to-top JQuery ************* -->
+<script src="https://code.jquery.com/jquery-1.12.4.js"></script>
+<script src="https://code.jquery.com/ui/1.12.0/jquery-ui.js"></script>
+
+
+<link href="styles/prism.min.css" rel="stylesheet" />
+<script type="text/javascript" async
+  src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2/MathJax.js?config=TeX-MML-AM_CHTML">
+</script>
+
+<!-- ************* Styles ************* -->
+<link rel="stylesheet" type="text/css" href="styles/n4jsspec-adoc.css">
+
+
+<!-- ****************** NavBar ****************** -->
+<div id="menubar">
+	<div class="banner">
+        <a href="https://www.eclipse.org/n4js/#"><img id="logo" src="images/n4js-logo.png" alt="Eclipse N4JS"></a>
+    </div>
+<ul>
+  <li><a href="index.html">Index</a></li>
+</ul>
+</div>
+<!-- ************* docinfo ******************************************************************* -->
+<style>
+      .admonitionblock td.icon .icon-todo:before{content:"\f249";color:#f4ee42}
+    </style>
+</head>
+<body class="book toc2 toc-left">
+<div id="header">
+<h1>N4JS Design Specification</h1>
+<div class="details">
+<span id="author" class="author">2019-08-07 15:02:40 CEST</span><br>
+<span id="revnumber">version 0.9</span>
+</div>
+<div id="toc" class="toc2">
+<div id="toctitle">Table of Contents</div>
+<ul class="sectlevel1">
+<li><a href="introduction.html#_introduction">1. Introduction</a>
+<ul class="sectlevel2">
+<li><a href="introduction.html#notation">1.1. Notation</a></li>
+<li><a href="introduction.html#sec:IDE_Overview">1.2. IDE Components</a>
+<ul class="sectlevel3">
+<li><a href="introduction.html#sec:Naming_Conventions">1.2.1. Naming Conventions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="eclipse_setup.html#_eclipse-setup">2. Eclipse Setup</a>
+<ul class="sectlevel2">
+<li><a href="eclipse_setup.html#_system-requirements">2.1. System Requirements</a></li>
+<li><a href="eclipse_setup.html#_contribute">2.2. Contribute</a>
+<ul class="sectlevel3">
+<li><a href="eclipse_setup.html#_eclipse-installer">2.2.1. Eclipse Installer</a>
+<ul class="sectlevel4">
+<li><a href="eclipse_setup.html#_changing-the-setup-script">2.2.1.1. Changing the Setup Script</a></li>
+</ul>
+</li>
+<li><a href="eclipse_setup.html#_manual-ide-configuration">2.2.2. Manual IDE Configuration</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="release_engineering.html#_release-engineering">3. Release Engineering</a>
+<ul class="sectlevel2">
+<li><a href="release_engineering.html#_nightly-build-on-eclipse-infrastructure">3.1. Nightly build on Eclipse infrastructure</a></li>
+<li><a href="release_engineering.html#_build-the-n4js-ide-from-command-line">3.2. Build the N4JS IDE from command line</a>
+<ul class="sectlevel3">
+<li><a href="release_engineering.html#_publish-maven-tooling-code-org-eclipse-n4js-releng-util-code">3.2.1. Publish maven-tooling <code>org.eclipse.n4js.releng.util</code></a></li>
+<li><a href="release_engineering.html#sec:test-verdaccio">3.2.2. Test Verdaccio containing n4js-libs</a></li>
+<li><a href="release_engineering.html#_generation-of-eclipse-help-for-spec-and-design-document">3.2.3. Generation of Eclipse help for spec and design document</a></li>
+</ul>
+</li>
+<li><a href="release_engineering.html#_updating-frameworks-and-dependencies">3.3. Updating frameworks and dependencies</a>
+<ul class="sectlevel3">
+<li><a href="release_engineering.html#_update-of-eclipse-emf-xtext-etc">3.3.1. Update of Eclipse, EMF, Xtext, etc.</a></li>
+<li><a href="release_engineering.html#_update-of-the-embedded-jre">3.3.2. Update of the embedded JRE</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tips_and_tricks.html#_tips-and-tricks">4. Tips and Tricks</a>
+<ul class="sectlevel2">
+<li><a href="tips_and_tricks.html#_naming">4.1. Naming</a></li>
+<li><a href="tips_and_tricks.html#_logging">4.2. Logging</a></li>
+<li><a href="tips_and_tricks.html#_cancellation-handling">4.3. Cancellation Handling</a></li>
+<li><a href="tips_and_tricks.html#_caching">4.4. Caching</a></li>
+<li><a href="tips_and_tricks.html#_dependency-injection">4.5. Dependency Injection</a></li>
+<li><a href="tips_and_tricks.html#_miscellaneous">4.6. Miscellaneous</a></li>
+</ul>
+</li>
+<li><a href="parser.html#_parser">5. Parser</a>
+<ul class="sectlevel2">
+<li><a href="parser.html#sec:Parser_Overview">5.1. Overview</a></li>
+<li><a href="parser.html#sec:N4JS_Parser">5.2. N4JS Parser</a></li>
+<li><a href="parser.html#sec:Parser_Generation_Post_Processing">5.3. Parser Generation Post-Processing</a>
+<ul class="sectlevel3">
+<li><a href="parser.html#sec:Automatic_Semicolon_Insertion">5.3.1. Automatic Semicolon Insertion</a>
+<ul class="sectlevel4">
+<li><a href="parser.html#sec:Injected_code_in_the_Antlr_grammar_file">5.3.1.1. Injected code in the Antlr grammar file</a></li>
+<li><a href="parser.html#sec:Customized_error_recovery">5.3.1.2. Customized error recovery</a></li>
+</ul>
+</li>
+<li><a href="parser.html#sec:_No_line_terminator_allowed_here__handling">5.3.2. Async and <code>No line terminator allowed here</code> Handling</a></li>
+<li><a href="parser.html#sec:Regular_Expression">5.3.3. Regular Expression</a></li>
+<li><a href="parser.html#sec:Unicode">5.3.4. Unicode</a></li>
+<li><a href="parser.html#sec:Literals">5.3.5. Literals</a></li>
+</ul>
+</li>
+<li><a href="parser.html#sec:Modifiers">5.4. Modifiers</a></li>
+<li><a href="parser.html#sec:Conflict_Resolutions">5.5. Conflict Resolutions</a>
+<ul class="sectlevel3">
+<li><a href="parser.html#sec:Reserved_Keywords_vs__Identifier_Names">5.5.1. Reserved Keywords vs. Identifier Names</a></li>
+<li><a href="parser.html#sec:Operators_and_Generics">5.5.2. Operators and Generics</a></li>
+</ul>
+</li>
+<li><a href="parser.html#sec:Content_Assist_Parser">5.6. Content-Assist Parser</a></li>
+</ul>
+</li>
+<li><a href="type_system.html#_type-system">6. Type System</a>
+<ul class="sectlevel2">
+<li><a href="type_system.html#sec:Type_Model_and_Grammar">6.1. Type Model and Grammar</a>
+<ul class="sectlevel3">
+<li><a href="type_system.html#sec:Type_Model_Overview">6.1.1. Type Model Overview</a></li>
+<li><a href="type_system.html#sec:Built_in_Types">6.1.2. Built-in and Primitive Types</a></li>
+<li><a href="type_system.html#sec:Type_Model_DSL">6.1.3. Type Model DSL</a></li>
+</ul>
+</li>
+<li><a href="type_system.html#sec:Type_System_Implementation">6.2. Type System Implementation</a></li>
+<li><a href="type_system.html#sec:Type_Inference_combined_with_AST_Traversal">6.3. Type Inference of AST</a>
+<ul class="sectlevel3">
+<li><a href="type_system.html#sec:Type_Inference_combined_with_AST_Traversal__Background">6.3.1. Background</a></li>
+<li><a href="type_system.html#sec:Triggering_Type_Inference_of_AST">6.3.2. Triggering</a></li>
+<li><a href="type_system.html#sec:Traversal_Order_During_Type_Inference_of_AST">6.3.3. Traversal Order</a></li>
+<li><a href="type_system.html#sec:Cross_References_During_Type_Inference_of_AST">6.3.4. Cross-References</a></li>
+<li><a href="type_system.html#sec:Function_Accessor_Bodies_During_Type_Inference_of_AST">6.3.5. Function/Accessor Bodies</a></li>
+<li><a href="type_system.html#sec:Poly_Expressions_During_Type_Inference_of_AST">6.3.6. Poly Expressions</a></li>
+<li><a href="type_system.html#sec:Constraint_Solver_used_During_Type_Inference_of_AST">6.3.7. Constraint Solver</a></li>
+<li><a href="type_system.html#sec:Type_Guards_During_Type_Inference_of_AST">6.3.8. Type Guards</a></li>
+</ul>
+</li>
+<li><a href="type_system.html#sec:Structural_Typing">6.4. Structural Typing</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#_type-index">7. Type Index</a>
+<ul class="sectlevel2">
+<li><a href="type_index.html#sec:Type_Index_Design_Rationale">7.1. Design Rationale</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#sec:Getting_the_Xtext_Index_Content_IResourceDescriptions">7.1.1. Getting the Xtext Index (<code>IResourceDescriptions</code>) Content</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#sec:Design_Overview">7.2. Design Overview</a></li>
+<li><a href="type_index.html#sec:N4JS_Resource_Load_States">7.3. N4JS Resource Load States</a></li>
+<li><a href="type_index.html#sec:Type_Builder">7.4. Types Builder</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#sec:Type_Inference_not_allowed_in_Type_Builder">7.4.1. Type Inference not allowed in Types Builder</a></li>
+<li><a href="type_index.html#sec:ComputedTypeReferences">7.4.2. Deferred Type References</a></li>
+<li><a href="type_index.html#sec:Use_cases_of_ComputedTypeRef">7.4.3. Use cases of DeferredTypeRef</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#sec:Incremental_Builder_Overview">7.5. Incremental Builder (Overview)</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#sec:Incremental_Builder_Overview__XtextBuilder">7.5.1. XtextBuilder</a></li>
+<li><a href="type_index.html#sec:Incremental_Builder_Overview__IBuilderState">7.5.2. IBuilderState</a>
+<ul class="sectlevel4">
+<li><a href="type_index.html#copy-and-update-xtext-index">7.5.2.1. Copy and Update Xtext Index</a></li>
+<li><a href="type_index.html#build-state-setup-phase">7.5.2.2. Build State Setup Phase</a></li>
+<li><a href="type_index.html#process-queued-uris">7.5.2.3. Process Queued URIs</a></li>
+<li><a href="type_index.html#queueing-affected-resources">7.5.2.4. Queueing Affected Resources</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#sec:Incremental_Builder_Overview__Example">7.5.3. Example</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#dirty-state-handling">7.6. Dirty state handling</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#use-case-restoring-types-from-user-data">7.6.1. Use case: Restoring types from user data</a></li>
+<li><a href="type_index.html#use-case-updating-the-xtext-index">7.6.2. Use case: Updating the Xtext index</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="project_model.html#_project-model">8. Project Model</a>
+<ul class="sectlevel2">
+<li><a href="project_model.html#sec:Package_json">8.1. Package.json File</a></li>
+<li><a href="project_model.html#_accessing-project-information">8.2. Accessing Project Information</a>
+<ul class="sectlevel3">
+<li><a href="project_model.html#sec:IN4JSCore">8.2.1. IN4JSCore</a></li>
+<li><a href="project_model.html#sec:N4JSModel">8.2.2. N4JSModel</a></li>
+<li><a href="project_model.html#sec:N4JSWorkspace">8.2.3. N4JSWorkspace</a></li>
+<li><a href="project_model.html#sec:N4JSProject">8.2.4. N4JSProject</a></li>
+<li><a href="project_model.html#sec:SourceContainer">8.2.5. SourceContainer</a></li>
+<li><a href="project_model.html#sec:N4JSProjectsStateHelper">8.2.6. N4JSProjectsStateHelper</a></li>
+</ul>
+</li>
+<li><a href="project_model.html#sec:Caching">8.3. Caching</a>
+<ul class="sectlevel3">
+<li><a href="project_model.html#_caching-of-externallibraryworkspace">8.3.1. Caching of ExternalLibraryWorkspace</a></li>
+<li><a href="project_model.html#_caching-of-n4jsprojectsstatehelper">8.3.2. Caching of N4JSProjectsStateHelper</a></li>
+</ul>
+</li>
+<li><a href="project_model.html#sec:WildcardPathFilter">8.4. WildcardPathFilter</a></li>
+<li><a href="project_model.html#sec:ProjectUtils">8.5. ProjectUtils</a></li>
+</ul>
+</li>
+<li><a href="binding.html#_binding">9. Binding</a>
+<ul class="sectlevel2">
+<li><a href="binding.html#sec:Binding_Design_Rationale">9.1. Design Rationale</a></li>
+<li><a href="binding.html#sec:Binding_to_Members">9.2. Binding to Members</a></li>
+<li><a href="binding.html#sec:Binding_Getter_Setter">9.3. Getter / Setter Binding</a></li>
+<li><a href="binding.html#chap:Statics">9.4. Static Member Binding</a></li>
+<li><a href="binding.html#sec:Binding_Enumeration">9.5. Enumeration Literals Binding</a></li>
+<li><a href="binding.html#sec:Accessibility_of_types_and_members">9.6. Accessibility of types and members</a></li>
+<li><a href="binding.html#sec:Member_Scope_Example">9.7. Member Scope Example</a></li>
+<li><a href="binding.html#sec:Scoping_for_Members_of_Composed_Type_Explained">9.8. Scoping for Members of Composed Type (Union/Intersection) Example</a></li>
+<li><a href="binding.html#sec:Binding_of_Structurally_References_Types">9.9. Structurally References Types</a></li>
+<li><a href="binding.html#sec:Building">9.10. Building</a>
+<ul class="sectlevel3">
+<li><a href="binding.html#sec:Build_Phases">9.10.1. Build Phases</a></li>
+<li><a href="binding.html#sec:Build_Scenarios">9.10.2. Build Scenarios</a></li>
+<li><a href="binding.html#sec:Lazy_linking_problem">9.10.3. Lazy linking problem</a></li>
+</ul>
+</li>
+<li><a href="binding.html#sec:Proxies_and_Proxy_Resolution">9.11. Proxies and Proxy Resolution (Overview)</a>
+<ul class="sectlevel3">
+<li><a href="binding.html#xtexts-lazy-linking-proxies">9.11.1. Xtext’s Lazy Linking Proxies</a></li>
+<li><a href="binding.html#standard-emf-proxies">9.11.2. Standard EMF Proxies</a></li>
+<li><a href="binding.html#_how-is-proxy-resolution-triggered">9.11.3. How is Proxy Resolution Triggered?</a></li>
+<li><a href="binding.html#_when-is-proxy-resolution-allowed">9.11.4. When is Proxy Resolution Allowed?</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="validation.html#_validation">10. Validation</a>
+<ul class="sectlevel2">
+<li><a href="validation.html#sec:validation_overview">10.1. Validation overview</a></li>
+<li><a href="validation.html#sec:validation_control_flow">10.2. Validation control flow</a></li>
+<li><a href="validation.html#sec:validation_issue_ids">10.3. Issue IDs and Messages</a></li>
+<li><a href="validation.html#sec:validation_usage_patterns">10.4. Usage Pattern</a></li>
+<li><a href="validation.html#sec:validation_links">10.5. Links</a></li>
+</ul>
+</li>
+<li><a href="references.html#_references">11. References</a>
+<ul class="sectlevel2">
+<li><a href="references.html#sec:usecases">11.1. Use cases</a></li>
+<li><a href="references.html#sec:calculation_algorithm">11.2. Calculation algorithm</a>
+<ul class="sectlevel3">
+<li><a href="references.html#sec:Xtext_default_implementation">11.2.1. Xtext default implementation</a></li>
+<li><a href="references.html#sec:N4_implementation">11.2.2. N4JS implementation</a></li>
+</ul>
+</li>
+<li><a href="references.html#sec:PerformanceOfDependencyCalculation">11.3. Performance Of Dependency Calculation</a></li>
+<li><a href="references.html#sec:kinds_of_references">11.4. Kinds of references</a>
+<ul class="sectlevel3">
+<li><a href="references.html#sec:Cross_References_to_be_ignored">11.4.1. Cross References to be ignored</a></li>
+<li><a href="references.html#sec:Cross_References_to_be_handled">11.4.2. Cross References to be handled</a></li>
+</ul>
+</li>
+<li><a href="references.html#sec:transitive_dependencies">11.5. Transitive dependencies</a></li>
+<li><a href="references.html#sec:find-references">11.6. Find references</a>
+<ul class="sectlevel3">
+<li><a href="references.html#_background">11.6.1. Background</a></li>
+<li><a href="references.html#_how-find-references-work">11.6.2. How Find References Work</a>
+<ul class="sectlevel4">
+<li><a href="references.html#_step-1-convert-cursor-position-to-declared-element">11.6.2.1. Step 1: Convert Cursor Position to Declared Element</a></li>
+<li><a href="references.html#_step-2-convert-declared-element-to-target-uris">11.6.2.2. Step 2: Convert Declared Element to Target URIs</a></li>
+<li><a href="references.html#_step-3-filter-potential-resources">11.6.2.3. Step 3: Filter Potential Resources</a></li>
+<li><a href="references.html#_step-4-search-references-in-resource">11.6.2.4. Step 4: Search References in Resource</a></li>
+<li><a href="references.html#_limitations-and-possible-enhancements">11.6.2.5. Limitations and Possible Enhancements</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="compilation.html#_compilation">12. Compilation</a>
+<ul class="sectlevel2">
+<li><a href="compilation.html#chap:compilation">12.1. Introduction</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:general_design_rationals">12.1.1. General design rationals</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:logging_and_error_reporting">12.1.1.1. Logging and error reporting</a></li>
+<li><a href="compilation.html#sec:progress_monitor">12.1.1.2. Progress monitor</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Xtext_Integration">12.1.2. Xtext Integration</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:xtext_default_behaviour">12.1.2.1. Xtext default behaviour</a></li>
+<li><a href="compilation.html#sec:n4js_requirements">12.1.2.2. N4JS requirements</a></li>
+<li><a href="compilation.html#sec:compiler_discovery_in_ui">12.1.2.3. Compiler discovery in UI</a></li>
+<li><a href="compilation.html#sec:compiler_discovery_in_headless">12.1.2.4. Compiler discovery in headless</a></li>
+<li><a href="compilation.html#sec:general_generator_implementation">12.1.2.5. General generator implementation</a></li>
+<li><a href="compilation.html#sec:general_generator_activation">12.1.2.6. General generator activation</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Overview_of_Input_Models">12.1.3. Overview of the Input Models</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Core_Generator">12.2. Generators</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:Compiler_Components">12.2.1. Generator Components</a></li>
+<li><a href="compilation.html#sec:Generator_architecture">12.2.2. Generator architecture</a></li>
+<li><a href="compilation.html#sec:Unified_Compiler_Configuration">12.2.3. Unified Compiler Configuration</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Transpilers">12.3. Transpilers</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:Phases">12.3.1. Overview</a></li>
+<li><a href="compilation.html#relation-between-ast-and-im">12.3.2. Relation between AST and IM</a></li>
+<li><a href="compilation.html#implementation-overview">12.3.3. Implementation Overview</a></li>
+<li><a href="compilation.html#sec:Guidelines_for_Implementing_Transformations">12.3.4. Guidelines for Implementing Transformations</a></li>
+<li><a href="compilation.html#symbol-table-in-the-im">12.3.5. Symbol Table in the IM</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:N4JS_to_EcmaScript_Transpiler">12.4. N4JS-to-EcmaScript Transpiler</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:Overview_of_Transformations">12.4.1. Overview of Transformations</a></li>
+<li><a href="compilation.html#sec:Transpiling_members">12.4.2. Transpiling members</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:Transpiling_members__Delegating_members">12.4.2.1. Techniques for special member handling</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__Partial_shadowing_of_getter_setter_pairs">12.4.2.2. Partial shadowing</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__Consuming_or_inheriting_members_of_an_interface">12.4.2.3. Consuming or inheriting members of an interface</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__Static_polyfill">12.4.2.4. Static polyfill</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__API_implementation_stubs">12.4.2.5. API / implementation stubs</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Support_for_incomplete_API_implementation_testing_in_the_N4JS_to_EcmaScript_5_Transpiler">12.4.3. Support for incomplete API implementation testing</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:Modifications_in_Impl_projects">12.4.3.1. Modifications in Impl projects</a></li>
+<li><a href="compilation.html#sec:Implementation_of_stub_generation">12.4.3.2. Implementation of stub-generation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:n4jsc_Headless_Compiler_Interface">12.5. n4jsc Headless Compiler Interface</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:building_the_headless_compiler">12.5.1. building the headless compiler</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="execution.html#_execution">13. Execution</a>
+<ul class="sectlevel2">
+<li><a href="execution.html#sec:N4JS_Project_Execution_And_Linking_Model">13.1. N4JS Project Execution And Linking Model</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#subsec:N4JS_Execution_With_NodeJS">13.1.1. N4JS Execution With NodeJS</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:N4JS_Execution_And_Linking_File">13.2. N4JS Execution And Linking File</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#subsec:NodeJS_Specific_ELF">13.2.1. NodeJS Specific ELF</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Runners-execution">13.3. Runners</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#subsec:N4_Runtime_Environments_Convention">13.3.1. N4 Runtime Environments Convention</a></li>
+<li><a href="execution.html#subsec:Passing_Information_from_IDE_to_Execution_Code_in_Runtime_Environment">13.3.2. Passing Information from IDE to Execution Code in Runtime Environment</a></li>
+<li><a href="execution.html#subsec:Runners_Design">13.3.3. Runners Design</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Legacy_Execution_Engine">13.4. Legacy Execution Engine</a></li>
+<li><a href="execution.html#sec:Design">13.5. Design</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#sec:Usage_Outside_N4JSIDE">13.5.1. Usage Outside N4JSIDE</a>
+<ul class="sectlevel4">
+<li><a href="execution.html#sec:Use_Node_with_Maven">13.5.1.1. Use Node with Maven</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Usage_Inside_N4JSIDE">13.5.2. Usage Inside N4JSIDE</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Runtime_Injection">13.6. Runtime Injection</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#sec:Running_String_Code">13.6.1. Running String Code</a></li>
+<li><a href="execution.html#sec:Running_File_Code">13.6.2. Running File Code</a></li>
+<li><a href="execution.html#sec:Injection_Code_Example">13.6.3. Injection Code Example</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#_tests">14. Tests</a>
+<ul class="sectlevel2">
+<li><a href="#sec:Performance_Tests">14.1. Performance Tests</a>
+<ul class="sectlevel3">
+<li><a href="#sec:Synthetic_Performance_Tests">14.1.1. Synthetic Performance Tests</a>
+<ul class="sectlevel4">
+<li><a href="#sec:Design_of_Generator">14.1.1.1. Design of Generator</a></li>
+<li><a href="#sec:Design_of_Performance_Test_Execution">14.1.1.2. Design of Performance Test Configuration and Execution</a></li>
+<li><a href="#sec:JUnit_Configuration">14.1.1.3. JUnit Configuration</a></li>
+<li><a href="#sec:JUnitBenchmark_Test_Configuration">14.1.1.4. JUnitBenchmark Test Configuration</a></li>
+<li><a href="#sec:JUnitBenchmark_Report_Configuration">14.1.1.5. JUnitBenchmark Report Configuration</a></li>
+<li><a href="#sec:JUnitBenchmark_Run_Configuration">14.1.1.6. JUnitBenchmark Run Configuration</a></li>
+<li><a href="#sec:JUnitBenchmark_Example">14.1.1.7. JUnitBenchmark Example</a></li>
+<li><a href="#sec:Note_on_Jenkins_Job">14.1.1.8. Note on Jenkins Job</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#sec:ECMA_Tests">14.2. ECMA Tests</a>
+<ul class="sectlevel3">
+<li><a href="#sec:Grammar_Tests">14.2.1. Grammar Tests</a>
+<ul class="sectlevel4">
+<li><a href="#sec:Negative_Tests">14.2.1.1. Negative Tests</a></li>
+<li><a href="#sec:Test_Exclusion">14.2.1.2. Test Exclusion</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#sec:Integration_Tests">14.3. Integration Tests</a></li>
+<li><a href="#sec:Test_Helpers">14.4. Test Helpers</a>
+<ul class="sectlevel3">
+<li><a href="#sec:Parameterized_N4JS_Tests">14.4.1. Parameterized N4JS tests</a>
+<ul class="sectlevel4">
+<li><a href="#sec:ParameterizedXtextRunner">14.4.1.1. ParameterizedXtextRunner</a></li>
+<li><a href="#sec:TestCodeProvider">14.4.1.2. TestCodeProvider</a></li>
+<li><a href="#sec:Example_Of_Parameterized_Parser_Test">14.4.1.3. Example of parameterized parser test</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#sec:Issue_Suppression">14.5. Issue Suppression</a></li>
+<li><a href="#sec:Xpect_Tests">14.6. Xpect Tests</a>
+<ul class="sectlevel3">
+<li><a href="#sec:Xpect_Test_Setup">14.6.1. Xpect Test Setup</a></li>
+<li><a href="#sec:Xpect_Issue_Suppression">14.6.2. Xpect Issue Suppression</a></li>
+<li><a href="#sec:Xpect_Provided_Test_Methods">14.6.3. Xpect Provided Test Methods</a>
+<ul class="sectlevel4">
+<li><a href="#errors">14.6.3.1. errors</a></li>
+<li><a href="#warnings">14.6.3.2. warnings</a></li>
+</ul>
+</li>
+<li><a href="#sec:N4JS_Specific_Xpect_Test_Methods">14.6.4. N4JS Specific Xpect Test Methods</a>
+<ul class="sectlevel4">
+<li><a href="#sec:XPECT_noerrors">14.6.4.1. noerrors and nowarnings</a></li>
+<li><a href="#sec:XPECT_scope">14.6.4.2. scope</a></li>
+<li><a href="#sec:XPECT_scopeWithPosition">14.6.4.3. scopeWithPosition</a></li>
+<li><a href="#sec:XPECT_scopeWithResource">14.6.4.4. scopeWithResource</a></li>
+<li><a href="#sec:XPECT_binding">14.6.4.5. binding</a></li>
+<li><a href="#sec:XPECT_linkedPathname">14.6.4.6. linkedPathname</a></li>
+<li><a href="#sec:XPECT_type_of">14.6.4.7. type of</a></li>
+<li><a href="#sec:XPECT_expectedType">14.6.4.8. expectedType</a></li>
+<li><a href="#sec:XPECT_elementKeyword">14.6.4.9. elementKeyword</a></li>
+<li><a href="#sec:XPECT_accessModifier">14.6.4.10. accessModifier</a></li>
+<li><a href="#sec:XPECT_compileResult">14.6.4.11. compileResult</a></li>
+<li><a href="#sec:XPECT_output">14.6.4.12. output</a></li>
+<li><a href="#sec:XPECT_outputRegEx">14.6.4.13. outputRegEx</a></li>
+<li><a href="#sec:XPECT_calculatedAccessModifier">14.6.4.14. calculatedAccessModifier</a></li>
+<li><a href="#sec:XPECT_spec">14.6.4.15. spec</a></li>
+<li><a href="#sec:XPECT_deadCode">14.6.4.16. deadCode</a></li>
+<li><a href="#sec:XPECT_returnOrThrows">14.6.4.17. returnOrThrows</a></li>
+<li><a href="#sec:XPECT_lint">14.6.4.18. lint</a></li>
+<li><a href="#sec:XPECT_lintFails">14.6.4.19. lintFails</a></li>
+</ul>
+</li>
+<li><a href="#sec:FIXME_Xpect_modifier">14.6.5. FIXME Xpect modifier</a></li>
+<li><a href="#sec:Expectmatrix_Xpect_Test_Methods">14.6.6. Expectmatrix Xpect tests</a></li>
+<li><a href="#xpect-lint-tests">14.6.7. Xpect Lint Tests</a></li>
+</ul>
+</li>
+<li><a href="#xpect-proposal-tests">14.7. Xpect Proposal Tests</a>
+<ul class="sectlevel3">
+<li><a href="#sec:Validation_vs__Non_Validation">14.7.1. Validation vs. Non-Validation</a></li>
+<li><a href="#sec:General_Proposal_Test_Features">14.7.2. General Proposal Test Features</a>
+<ul class="sectlevel4">
+<li><a href="#sec:Test_Variables">14.7.2.1. Test Variables</a></li>
+<li><a href="#sec:Location_and_Selection">14.7.2.2. at – Location and Selection</a></li>
+<li><a href="#sec:Multi_Line_Expectations_in_Proposal_Tests">14.7.2.3. Multi Line Expectations in Proposal Tests</a></li>
+<li><a href="#sec:Timeout">14.7.2.4. Timeout and Performance</a></li>
+</ul>
+</li>
+<li><a href="#proposals-verify-existence-of-proposals">14.7.3. proposals – Verify Existence of Proposals</a></li>
+<li><a href="#sec:Verify_displayed_string">14.7.4. display – Verify displayed string</a></li>
+<li><a href="#sec:Apply_Proposal">14.7.5. apply – Apply Proposal</a>
+<ul class="sectlevel4">
+<li><a href="#resource-application-in-other-files">14.7.5.1. resource – application in other files</a></li>
+</ul>
+</li>
+<li><a href="#sec:Content_Assist_Cycling">14.7.6. kind – Content Assist Cycling</a></li>
+<li><a href="#fileValidVerify-validation-status">14.7.7. fileValid – Verify validation status</a></li>
+</ul>
+</li>
+<li><a href="#sec:Apply_Proposal_And_Execute_Tests">14.8. Apply Proposal And Execute Tests</a></li>
+<li><a href="#sec:Organize_Imports_Test">14.9. Organize Imports Test</a>
+<ul class="sectlevel3">
+<li><a href="#organizeimports">14.9.1. organizeImports</a></li>
+</ul>
+</li>
+<li><a href="#sec:Access_Control_Test">14.10. Access Control Test</a>
+<ul class="sectlevel3">
+<li><a href="#test-scenarios">14.10.1. Test Scenarios</a></li>
+<li><a href="#n4js-code-generator">14.10.2. N4JS Code Generator</a></li>
+<li><a href="#xtext-issue-matcher">14.10.3. Xtext Issue Matcher</a></li>
+</ul>
+</li>
+<li><a href="#sec:Smoke_Tests">14.11. Smoke Tests</a>
+<ul class="sectlevel3">
+<li><a href="#how-to-handle-smoke-test-errors">14.11.1. How to handle smoke test errors?</a></li>
+<li><a href="#smoketester-and-exceptionanalyzer">14.11.2. SmokeTester and ExceptionAnalyzer</a></li>
+</ul>
+</li>
+<li><a href="#sec:UI_Tests_with_SWTBot">14.12. UI Tests with SWTBot</a>
+<ul class="sectlevel3">
+<li><a href="#writing-swtbot-tests">14.12.1. Writing SWTBot Tests</a></li>
+<li><a href="#running-swtbot-tests">14.12.2. Running SWTBot Tests</a></li>
+</ul>
+</li>
+<li><a href="#sec:Debugging_UI_Tests">14.13. Debugging UI Tests</a>
+<ul class="sectlevel3">
+<li><a href="#sec:Connecting_to_the_X_server_on_the_build_node">14.13.1. Connecting to the X-server on the build-node</a></li>
+<li><a href="#sec:Tools_to_investigate_the_java_stack">14.13.2. Tools to investigate the java-stack</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="ui_concepts.html#_ui-concepts">15. UI Concepts</a>
+<ul class="sectlevel2">
+<li><a href="ui_concepts.html#sec:User_Interface_Concepts">15.1. User Interface Concepts</a>
+<ul class="sectlevel3">
+<li><a href="ui_concepts.html#sec:Eclipse_UI_Concepts">15.1.1. Eclipse UI Concepts</a>
+<ul class="sectlevel4">
+<li><a href="ui_concepts.html#sec:Label_Provider">15.1.1.1. Label Provider</a></li>
+<li><a href="ui_concepts.html#sec:Markers">15.1.1.2. Markers</a></li>
+<li><a href="ui_concepts.html#sec:Commands__Toolbar_and_Menus">15.1.1.3. Commands, Toolbar and Menus</a></li>
+<li><a href="ui_concepts.html#sec:Content_Assist">15.1.1.4. Content Assist</a></li>
+<li><a href="ui_concepts.html#sec:Quick_Fixes">15.1.1.5. Quick Fixes</a></li>
+<li><a href="ui_concepts.html#sec:Quick_Assist">15.1.1.6. Quick Assist</a></li>
+<li><a href="ui_concepts.html#sec:Clean_Up_Actions">15.1.1.7. Clean Up Actions</a></li>
+<li><a href="ui_concepts.html#sec:Save_Actions">15.1.1.8. Save Actions</a></li>
+<li><a href="ui_concepts.html#sec:Auto_Edit">15.1.1.9. Auto Edit</a></li>
+<li><a href="ui_concepts.html#sec:Template_Proposals">15.1.1.10. Template Proposals</a></li>
+<li><a href="ui_concepts.html#sec:Outline_View___Quick_Outline">15.1.1.11. Outline View / Quick Outline</a></li>
+<li><a href="ui_concepts.html#sec:Navigator__Package_Explorer__Project_Explorer">15.1.1.12. Navigator, Package Explorer, Project Explorer</a></li>
+<li><a href="ui_concepts.html#sec:Hyperlinking_and_Navigation">15.1.1.13. Hyperlinking and Navigation</a></li>
+<li><a href="ui_concepts.html#sec:Syntax_and_Semantic_Coloring">15.1.1.14. Syntax and Semantic Coloring</a></li>
+<li><a href="ui_concepts.html#sec:Code_Formatter">15.1.1.15. Code Formatter</a></li>
+<li><a href="ui_concepts.html#sec:Wizards">15.1.1.16. Wizards</a></li>
+<li><a href="ui_concepts.html#sec:Cheat_Sheets">15.1.1.17. Cheat Sheets</a></li>
+<li><a href="ui_concepts.html#sec:Context_sensitive_Help">15.1.1.18. Context-sensitive Help</a></li>
+<li><a href="ui_concepts.html#sec:Hovers">15.1.1.19. Hovers</a></li>
+<li><a href="ui_concepts.html#sec:Folding">15.1.1.20. Folding</a></li>
+<li><a href="ui_concepts.html#sec:Customizable_validation___severity">15.1.1.21. Customizable validation / severity</a></li>
+<li><a href="ui_concepts.html#sec:Proposals">15.1.1.22. Proposals</a></li>
+</ul>
+</li>
+<li><a href="ui_concepts.html#sec:Non_Eclipse_UI_Concepts">15.1.2. Non-Eclipse UI Concepts</a>
+<ul class="sectlevel4">
+<li><a href="ui_concepts.html#sec:Overlays">15.1.2.1. Overlays</a></li>
+<li><a href="ui_concepts.html#sec:Goto__Inferred__Type">15.1.2.2. Goto (Inferred) Type</a></li>
+<li><a href="ui_concepts.html#sec:Postfix_Completion">15.1.2.3. Postfix Completion</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="ui_concepts.html#_user-interface-resources">15.2. User Interface Resources</a>
+<ul class="sectlevel3">
+<li><a href="ui_concepts.html#_icons">15.2.1. Icons</a>
+<ul class="sectlevel4">
+<li><a href="ui_concepts.html#_eclipse-platform-icons">15.2.1.1. Eclipse Platform Icons</a></li>
+<li><a href="ui_concepts.html#_n4js-specific-icons">15.2.1.2. N4JS Specific Icons</a></li>
+<li><a href="ui_concepts.html#_high-resolution-icons">15.2.1.3. High Resolution Icons</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="formatting.html#_formatting">16. Formatting</a>
+<ul class="sectlevel2">
+<li><a href="formatting.html#sec:FmtObjective">16.1. Objective</a>
+<ul class="sectlevel3">
+<li><a href="formatting.html#sec:FmtFormatting_Comments">16.1.1. Formatting Comments</a></li>
+</ul>
+</li>
+<li><a href="formatting.html#sec:FmtArchitecture">16.2. Architecture</a>
+<ul class="sectlevel3">
+<li><a href="formatting.html#sec:Implementation_example">16.2.1. Implementation example</a></li>
+</ul>
+</li>
+<li><a href="formatting.html#sec:FmtFormatter_Implementation_Guidelines">16.3. Formatter Implementation Guidelines</a></li>
+<li><a href="formatting.html#sec:FmtConfiguration">16.4. Configuration</a></li>
+<li><a href="formatting.html#sec:FmtUI_Integration">16.5. UI Integration</a></li>
+<li><a href="formatting.html#sec:FmtUnit_Testing_with_Xpect">16.6. Unit Testing with Xpect</a></li>
+</ul>
+</li>
+<li><a href="external_libraries.html#_external-libraries">17. External Libraries</a>
+<ul class="sectlevel2">
+<li><a href="external_libraries.html#sec:Major_Components">17.1. Major Components</a>
+<ul class="sectlevel3">
+<li><a href="external_libraries.html#subsec:External_Resources">17.1.1. External Resources</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Workspace">17.1.2. External Library Workspace</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Preference_Store">17.1.3. External Library Preference Store</a></li>
+<li><a href="external_libraries.html#subsec:npm_Manager">17.1.4. Library Manager</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Builder_Helper">17.1.5. External Library Builder</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Xtext_Index_Persister">17.1.6. External Library Xtext Index Persister</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Preference_Page">17.1.7. External Library Preference Page</a></li>
+</ul>
+</li>
+<li><a href="external_libraries.html#sec:Headless_External_Library_Support">17.2. Headless External Library Support</a>
+<ul class="sectlevel3">
+<li><a href="external_libraries.html#_custom-npm-settings">17.2.1. Custom npm settings</a></li>
+</ul>
+</li>
+<li><a href="external_libraries.html#sec:lmFutureWork">17.3. Future Work</a>
+<ul class="sectlevel3">
+<li><a href="external_libraries.html#subsec:lmMultipleDependencyScope">17.3.1. Multiple Dependency Scope</a></li>
+<li><a href="external_libraries.html#subsec:lmRunTestsFromLibrary">17.3.2. Run Tests from TestLibrary</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="json_support.html#sec:JSON_Support">18. JSON Support</a>
+<ul class="sectlevel2">
+<li><a href="json_support.html#sec:JSON_Parser">18.1. JSON Parser</a>
+<ul class="sectlevel3">
+<li><a href="json_support.html#sec:JSON_Parser_Unicode_Escaping">18.1.1. Escaping Unicode Control Characters in String Literals</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Empty_Text">18.1.2. Empty Text</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Nested_Structures">18.1.3. Nested Structures</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Whitespace">18.1.4. Whitespace</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Comments">18.1.5. Comments</a></li>
+</ul>
+</li>
+<li><a href="json_support.html#sec:JSON_Language_Extensions">18.2. JSON Language Extensions</a>
+<ul class="sectlevel3">
+<li><a href="json_support.html#sec:JSON_Validator_Extensions">18.2.1. JSON Validator Extensions</a>
+<ul class="sectlevel4">
+<li><a href="json_support.html#sec:File_Specitic_Validator_Extensions">18.2.1.1. File-Specific Validator Extensions</a></li>
+<li><a href="json_support.html#sec:JSON_Declarative_JSON_Validator_Extensions">18.2.1.2. Declarative JSON Validator Extensions</a></li>
+</ul>
+</li>
+<li><a href="json_support.html#_json-resource-description-strategy">18.2.2. JSON Resource Description Strategy</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_jsdoc">19. JSDoc</a>
+<ul class="sectlevel2">
+<li><a href="jsdoc.html#sec:Design_Rationale">19.1. Design Rationale</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#_general-design">19.1.1. General Design</a></li>
+<li><a href="jsdoc.html#sec:Type_Expressions">19.1.2. Type Expressions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="docexporter.html#_docexporter">20. DocExporter</a>
+<ul class="sectlevel2">
+<li><a href="docexporter.html#sec:Specification_Exporter">20.1. Specification Exporter</a></li>
+</ul>
+</li>
+<li><a href="rename_refactoring.html#_rename-refactoring">21. Rename Refactoring</a>
+<ul class="sectlevel2">
+<li><a href="rename_refactoring.html#_rename-refactoring-ui-interaction">21.1. Rename Refactoring UI interaction</a></li>
+<li><a href="rename_refactoring.html#_renameelementprocessor-interaction">21.2. RenameElementProcessor interaction</a></li>
+</ul>
+</li>
+<li><a href="flow_graphs.html#chap:flowgraphs">22. Flow Graphs</a>
+<ul class="sectlevel2">
+<li><a href="flow_graphs.html#sec:flowgraphs_overview">22.1. Flow graphs overview</a>
+<ul class="sectlevel3">
+<li><a href="flow_graphs.html#_internal-graph">22.1.1. Internal graph</a></li>
+<li><a href="flow_graphs.html#_optimizations">22.1.2. Optimizations</a></li>
+<li><a href="flow_graphs.html#_api-for-client-analyses">22.1.3. API for client analyses</a>
+<ul class="sectlevel4">
+<li><a href="flow_graphs.html#_mapping-from-internal-to-ast-elements">22.1.3.1. Mapping from internal to AST elements</a></li>
+<li><a href="flow_graphs.html#_graph-visitor">22.1.3.2. Graph visitor</a></li>
+<li><a href="flow_graphs.html#_graph-explorer">22.1.3.3. Graph explorer</a></li>
+<li><a href="flow_graphs.html#_branch-walker">22.1.3.4. Branch walker</a></li>
+<li><a href="flow_graphs.html#_example-1-compute-string-for-each-path">22.1.3.5. Example 1: Compute string for each path</a></li>
+<li><a href="flow_graphs.html#_path-quantor">22.1.3.6. Path quantor</a></li>
+</ul>
+</li>
+<li><a href="flow_graphs.html#_control-flow-analyses">22.1.4. Control flow analyses</a>
+<ul class="sectlevel4">
+<li><a href="flow_graphs.html#_dead-code-analysis">22.1.4.1. Dead code analysis</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="flow_graphs.html#sec:dataflow">22.2. Dataflow</a>
+<ul class="sectlevel3">
+<li><a href="flow_graphs.html#_dataflow-graph">22.2.1. Dataflow graph</a></li>
+<li><a href="flow_graphs.html#_dataflow-analyses">22.2.2. Dataflow analyses</a>
+<ul class="sectlevel4">
+<li><a href="flow_graphs.html#_def-def-def-nothing-analysis">22.2.2.1. Def&#8594;Def / Def&#8594;Nothing analysis</a></li>
+<li><a href="flow_graphs.html#_def-use-decl-analysis">22.2.2.2. Def|Use&#8592;Decl analysis</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="publish_npms.html#sec:publish-npms-to-public">23. Publish npms</a>
+<ul class="sectlevel2">
+<li><a href="publish_npms.html#sec:publish-npms-n4js-maven">23.1. Publish n4js-libs to during  maven build</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Hints">Appendix A: Hints</a>
+<ul class="sectlevel2">
+<li><a href="appendix_a_hints.html#sec:XtextInjection">A.1. Xtext Injection</a>
+<ul class="sectlevel3">
+<li><a href="appendix_a_hints.html#sec:DI_MultipleInjectors_Singletons">A.1.1. Multiple Injectors and Singletons</a>
+<ul class="sectlevel4">
+<li><a href="appendix_a_hints.html#sec:DI_avoid_duplicate_singletons">A.1.1.1. Avoiding duplicate singletons</a>
+<ul class="sectlevel5">
+<li><a href="appendix_a_hints.html#sec:DI_binding_in_shared">A.1.1.1.1. Defining binding in the shared injector</a></li>
+<li><a href="appendix_a_hints.html#sec:DI_binding_in_custom">A.1.1.1.2. Defining binding in the custom injector</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:DI_Hints">A.1.2. Dependency Injection Hints</a>
+<ul class="sectlevel4">
+<li><a href="appendix_a_hints.html#sec:DI_custom_bundle">A.1.2.1. Use DI in custom bundle, use DI with extensions</a>
+<ul class="sectlevel5">
+<li><a href="appendix_a_hints.html#sec:DI_custom_bundle_problem">A.1.2.1.1. Problem</a></li>
+<li><a href="appendix_a_hints.html#sec:DI_custom_bundle_solution">A.1.2.1.2. Solution</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Access_Other_DSL_Injector">A.1.2.2. How do I get the Guice Injector of my language?</a>
+<ul class="sectlevel5">
+<li><a href="appendix_a_hints.html#sec:DSL_Injector_UI_context">A.1.2.2.1. UI context</a></li>
+<li><a href="appendix_a_hints.html#sec:DSL_Injector_Non_UI_context">A.1.2.2.2. Non UI context but with injection context</a></li>
+<li><a href="appendix_a_hints.html#sec:DSL_Injector_Non_UI_non_injection_context">A.1.2.2.3. Non UI context without injection context</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Cancel_Indicator">A.1.2.3. How do I get cancel indicators in different contexts?</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Eclipse">A.2. Eclipse</a>
+<ul class="sectlevel3">
+<li><a href="appendix_a_hints.html#sec:Show_Xtext_Index">A.2.1. Show the current Xtext index</a></li>
+<li><a href="appendix_a_hints.html#sec:Plugin_spy">A.2.2. Plug-in spy</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Maven-hints">A.3. Maven</a>
+<ul class="sectlevel3">
+<li><a href="appendix_a_hints.html#how-to-check-for-maven-mojo-updates">A.3.1. How to check for Maven MOJO updates</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#_module-loading">Appendix B: Module Loading</a>
+<ul class="sectlevel2">
+<li><a href="appendix_b_module_loading.html#sec:Dependency_Management">B.1. Dependency Management</a></li>
+<li><a href="appendix_b_module_loading.html#ecmascript-modules">B.2. ECMAScript Modules</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:ES5_Modules_Systems">B.2.1. ES5 Modules Systems</a></li>
+<li><a href="appendix_b_module_loading.html#sec:ES6_Modules">B.2.2. ES6 Modules</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:ECMAScript_Module_Loaders">B.3. ECMAScript Module Loaders</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:ES6_Module_Loaders">B.3.1. ES6 Module Loaders</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Polyfills_for_ES6_Module_Loaders">B.3.2. Polyfills for ES6 Module Loaders</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:es6_module_loader">B.3.2.1. es6-module-loader</a></li>
+<li><a href="appendix_b_module_loading.html#sec:SystemJS">B.3.2.2. SystemJS</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Demo">B.3.2.3. Demo</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#case-study-typescript">B.4. Case Study : TypeScript</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:ES6_Modules_Support">B.4.1. ES6 Modules Support</a></li>
+<li><a href="appendix_b_module_loading.html#sec:TypeScript_and_Module_Loading">B.4.2. TypeScript and Module Loading</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Cyclic_Dependencies">B.5. Cyclic Dependencies</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:Setup">B.5.1. Setup</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Transpile_and_Execute">B.5.2. Transpile and Execute</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Module_Format___AMD">B.5.2.1. Module Format = AMD</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Module_Format___CommonJS">B.5.2.2. Module Format = CommonJS</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Module_Format___SystemJS">B.5.2.3. Module Format = SystemJS</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Conclusion">B.5.3. Conclusion</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#system.register-as-transpilation-target">B.6. System.register as transpilation target</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:Introduction">B.6.1. Introduction</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:External_Transpilers">B.6.1.1. External Transpilers</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Example_of_a_System_register_module">B.6.1.2. Example of a System.register module</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Structure_of_a_System_register_module">B.6.2. Structure of a System.register module</a></li>
+<li><a href="appendix_b_module_loading.html#_transpilation-hints">B.6.3. Transpilation Hints</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Handling_Imports">B.6.3.1. Handling Imports</a></li>
+<li><a href="appendix_b_module_loading.html#sec:__exportFn__">B.6.3.2. &lt;&lt;exportFn&gt;&gt;</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Handling_Exports">B.6.3.3. Handling Exports</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Examples_w__Circular_Dependencies">B.6.4. Examples w/ Circular Dependencies</a></li>
+<li><a href="appendix_b_module_loading.html#sec:N4JS_Examples_w__Circular_Dependencies">B.6.5. N4JS Examples w/ Circular Dependencies</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Unresolved_Cyclic_Dependencies">B.6.5.1. Unresolved Cyclic Dependencies</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Variables___Functions">B.6.5.2. Examples with Variables &amp; Functions</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Classes">B.6.5.3. Examples with Classes</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Examples_with_SubClassing">B.6.5.4. Examples with SubClassing</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Miscellaneous">B.6.5.5. Miscellaneous</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#_resources">B.6.6. Resources</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:CommonJS_as_transpilation_target">B.7. CommonJS as transpilation target</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#_introduction-2">B.7.1. Introduction</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Transpilation_Hints">B.7.2. Transpilation Hints</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Import_Statements">B.7.2.1. Import Statements</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Export_Statements">B.7.2.2. Export Statements</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Tracking_Live_Bindings">B.7.2.3. Tracking Live Bindings</a></li>
+<li><a href="appendix_b_module_loading.html#sec:A_complete_example">B.7.2.4. A complete example</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#_resources-2">B.7.3. Resources</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_c_license.html#sec:License">Appendix C: License</a></li>
+<li><a href="appendix_d_acronyms.html#sec:Acronyms">Appendix D: Acronyms</a></li>
+<li><a href="appendix_e_bibliography_and_footnotes.html#_bibliography-and-footnotes">Appendix E: Bibliography and Footnotes</a></li>
+</ul>
+</div>
+</div>
+<div id="content"><div class="sect1">
+<h2 id="_tests"><a class="anchor" href="#_tests"></a><a class="link" href="#_tests">14. Tests</a></h2>
+<div class="sectionbody">
+<div class="admonitionblock warning">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-warning" title=""></i>
+</td>
+<td class="content">
+This chapter may be outdated.
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>In order to run all tests from command line, use maven:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre>mvn clean verify</pre>
+</div>
+</div>
+<div class="paragraph">
+<p>You may have to increase the memory for maven via <code>export MAVEN_OPTS="-Xmx2048m"</code> (Unix) or <code>set MAVEN_OPTS="-Xmx2048m"</code> (Windows).</p>
+</div>
+<div class="paragraph">
+<p>Do not run the tests via <code>mvn clean test</code> as this may lead to some failures.</p>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:Performance_Tests"><a class="anchor" href="#sec:Performance_Tests"></a><a class="link" href="#sec:Performance_Tests">14.1. Performance Tests</a></h3>
+<div class="paragraph">
+<p>There are two kind of performance tests:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Synthetic Tests: an arbitrary number of test classes is generated, and then some modifications are performed on these classes.</p>
+</li>
+<li>
+<p>Real World Tests: tests are based on a snapshot version of our platform libraries</p>
+</li>
+</ol>
+</div>
+<div class="sect3">
+<h4 id="sec:Synthetic_Performance_Tests"><a class="anchor" href="#sec:Synthetic_Performance_Tests"></a><a class="link" href="#sec:Synthetic_Performance_Tests">14.1.1. Synthetic Performance Tests</a></h4>
+<div class="paragraph">
+<p>The idea of the synthetic performance tests is to test the performance of specific functionality with a defined number classes, specially designed for the functionality under test.</p>
+</div>
+<div class="paragraph">
+<p>The overall structure of the synthetic performance test is</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>generate test classes</p>
+</li>
+<li>
+<p>compile these classes</p>
+</li>
+<li>
+<p>modify the test classes</p>
+</li>
+<li>
+<p>measure incremental build time</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>Step 3) and 4) can be done in a loop. Also, step 2) can be looped (with clean build).</p>
+</div>
+<div class="paragraph">
+<p>The test classes are spread over clusters and projects. The following categories are used:</p>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Cluster
+</td>
+<td class="hdlist2">
+<p>A cluster is a set of projects, each project of a cluster may depend on another project of the cluster. There are no dependencies between projects of different clusters</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Project
+</td>
+<td class="hdlist2">
+<p>A project simply is a N4JS project, containing packages. A project may depend on other projects.</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Package
+</td>
+<td class="hdlist2">
+<p>A package is a folder in a source folder of a project. A package contains classes.</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Class
+</td>
+<td class="hdlist2">
+<p>A class is defined in a file, usually one class per file. The file, and with it the class, is contained in a package. The class contains members.</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Member
+</td>
+<td class="hdlist2">
+<p>A member is either a field or method of a class. A method may has a body, which may contain variables with references to other classes.</p>
+</td>
+</tr>
+</table>
+</div>
+<div class="sect4 language-n4js">
+<h5 id="sec:Design_of_Generator"><a class="anchor" href="#sec:Design_of_Generator"></a><a class="link" href="#sec:Design_of_Generator">14.1.1.1. Design of Generator</a></h5>
+<div class="paragraph">
+<p><a href="#fig:cd_performancetest_generator">Performance Generator</a> shows the classes of the performance test generator.</p>
+</div>
+<div id="fig:cd_performancetest_generator" class="imageblock">
+<div class="content">
+<img src="chapters/15_tests/images/cd_performancetest_generator.svg" alt="cd performancetest generator">
+</div>
+</div>
+<div class="paragraph">
+<p>The package is designed as follows:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p><code>N4ProjectGenerator</code> main control class for generation</p>
+</li>
+<li>
+<p><code>TestDescriptor</code> and subclasses: In order to <em>keep memory consumption of the test class generator low</em>, there is no graph structure created for the test elements. Instead, each element is uniquely named by a number, this number (actually a tuple of numbers) is stored in <code>TestDescriptors</code> and sub classes. There is a descriptor for each element of the tests.</p>
+</li>
+<li>
+<p><code>AbstractModifier</code> and subclasses generarate the tests. The idea is as follows:</p>
+<div class="ulist">
+<ul>
+<li>
+<p><code>Modifier</code> generates all files, with complete references and no issues (complete)</p>
+</li>
+<li>
+<p>sub classes of <code>Modifier</code> skip certain generations or add modifications, leading to issues or solving them</p>
+</li>
+</ul>
+</div>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>In order to compute the name of a class from its descriptor, as well as retrieving a class based on an absolute number, the modifiers use utility methods provided by <code>PerformanceTestConfiguration</code>. Note that computing the names and numbers depends on a configuration!</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Design_of_Performance_Test_Execution"><a class="anchor" href="#sec:Design_of_Performance_Test_Execution"></a><a class="link" href="#sec:Design_of_Performance_Test_Execution">14.1.1.2. Design of Performance Test Configuration and Execution</a></h5>
+<div class="paragraph">
+<p><a href="#fig:cd_performancetest_configAnRun">Class Diagram of Performance Test Configuration and Execution</a> shows the classes of the performance test configuration and execution.</p>
+</div>
+<div id="fig:cd_performancetest_configAnRun" class="imageblock">
+<div class="content">
+<img src="chapters/15_tests/images/cd_performancetest_configAnRun.svg" alt="cd performancetest configAnRun">
+</div>
+<div class="title">Figure 45. Class Diagram of Performance Test Configuration and Execution</div>
+</div>
+<div class="paragraph">
+<p>The package is designed as follows:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p><code>PerformanceTestConfiguration</code> stores the test configuration. The configuration stores how many clusters, packages etc. are to be generated. It also provides methods for generating names from the descriptors mentioned above.</p>
+</li>
+<li>
+<p><code>PerformanceMeter</code> executes the test, listening to the (build) job to be finished etc.</p>
+</li>
+<li>
+<p><code>AbstractGeneratingPerformanceTest</code> Base test class contains setup, teardown and utility methods.</p>
+</li>
+<li>
+<p><code>PerformanceTest</code> Test class containing tests.</p>
+</li>
+</ol>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:JUnit_Configuration"><a class="anchor" href="#sec:JUnit_Configuration"></a><a class="link" href="#sec:JUnit_Configuration">14.1.1.3. JUnit Configuration</a></h5>
+<div class="paragraph">
+<p>We are using JUnitBenchamrks (<a href="http://labs.carrotsearch.com/junit-benchmarks.html/" class="bare">http://labs.carrotsearch.com/junit-benchmarks.html/</a>) to extend adjust plain JUnit behavior specifically to the performance tests needs.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:JUnitBenchmark_Test_Configuration"><a class="anchor" href="#sec:JUnitBenchmark_Test_Configuration"></a><a class="link" href="#sec:JUnitBenchmark_Test_Configuration">14.1.1.4. JUnitBenchmark Test Configuration</a></h5>
+<div class="paragraph">
+<p>JUnitBenchmark test configuration performed by annotating test method with <code>@BenchmarkOptions</code>. Parameters for that annotation include:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p><code>warmupRounds</code> how many times test will be executed without taking measurement</p>
+</li>
+<li>
+<p><code>benchmarkRounds</code> how many times test will be executed, measurements taken will be used in results report</p>
+</li>
+<li>
+<p><code>callgc</code> Call <code>System.gc()</code> before each test. This may slow down the tests in a significant way.</p>
+</li>
+<li>
+<p><code>concurrency</code> specifies how many threads to use for tests.</p>
+</li>
+<li>
+<p><code>clock</code> specifies which clock to use.</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>Typical configuration for our performance tests might look like:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>    @BenchmarkOptions(benchmarkRounds = 5, warmupRounds = 2)
+    @Test
+    public void test() throws Exception {
+        //test...
+    }</code></pre>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:JUnitBenchmark_Report_Configuration"><a class="anchor" href="#sec:JUnitBenchmark_Report_Configuration"></a><a class="link" href="#sec:JUnitBenchmark_Report_Configuration">14.1.1.5. JUnitBenchmark Report Configuration</a></h5>
+<div class="paragraph">
+<p>By annotating TestClass in proper way, JUnitBenchamrks will generate html reports with performance results. There are two reports that can be generated:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p><code>@BenchmarkMethodChart</code> report will contain results for every method from one test run (but all <code>benchmarkRounds</code> defined)</p>
+<div class="ulist">
+<ul>
+<li>
+<p><code>filePrefix</code> defines report file name</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p><code>@BenchmarkHistoryChart</code> report will contain trend of results from multiple test runs (it is aggregation of multiple instances of <code>@BenchmarkMethodChart</code> report)</p>
+<div class="ulist">
+<ul>
+<li>
+<p><code>filePrefix</code> defines report file name</p>
+</li>
+<li>
+<p><code>labelWith</code> defines label that will mark separate runs</p>
+</li>
+</ul>
+</div>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p><em>labelWith</em> property can have value propagated from run configuration/command line. example configuration might be <code>@BenchmarkHistoryChart(filePrefix = benchmark-history, labelWith = LabelType.CUSTOM_KEY)</code></p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:JUnitBenchmark_Run_Configuration"><a class="anchor" href="#sec:JUnitBenchmark_Run_Configuration"></a><a class="link" href="#sec:JUnitBenchmark_Run_Configuration">14.1.1.6. JUnitBenchmark Run Configuration</a></h5>
+<div class="paragraph">
+<p>It is possible to specify additional options for performance test run</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p><code>-Djub.consumers=CONSOLE,H2</code> specifies where results will be written, <em>H2</em> indicates H2 database to be used</p>
+</li>
+<li>
+<p><code>-Djub.db.file=.benchmarks</code> specifies name of the H2 database file</p>
+</li>
+<li>
+<p><code>-Djub.customkey=</code> value of that property scan be used as label in <code>@BenchmarkHistoryChart</code></p>
+</li>
+</ol>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:JUnitBenchmark_Example"><a class="anchor" href="#sec:JUnitBenchmark_Example"></a><a class="link" href="#sec:JUnitBenchmark_Example">14.1.1.7. JUnitBenchmark Example</a></h5>
+<div class="paragraph">
+<p>configuration example:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>@BenchmarkMethodChart(filePrefix = "benchmark-method")
+@BenchmarkHistoryChart(filePrefix = "benchmark-history", labelWith = LabelType.CUSTOM_KEY)
+public class PerformanceTest extends AbstractGeneratingPerformanceTest {
+
+    public PerformanceTest() {
+        super("PerfTest");
+    }
+
+    @Rule
+    public TestRule benchmarkRun = new BenchmarkRule();
+
+    @Test
+    @BenchmarkOptions(benchmarkRounds = 5, warmupRounds = 2)
+    public void Test1() throws Exception {
+
+        //Test...
+    }
+
+    @Test
+    @BenchmarkOptions(benchmarkRounds = 5, warmupRounds = 2)
+    public void Test2() throws Exception {
+
+        //Test...
+    }
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>executing this code in Eclipse with configuration:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-bash" data-lang="bash">-Xms512m -Xmx1024m -XX:MaxPermSize=512m $-$Djub.consumers=CONSOLE,H2 $-$Djub.db.file=.benchmarks $-$Djub.customkey=${current_date}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>will cause :</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>both tests to be executed 2 times for the warmup</p>
+</li>
+<li>
+<p>both of tests being executed 5 times with measurement taken</p>
+</li>
+<li>
+<p>results written to console</p>
+</li>
+<li>
+<p>results stored in local H2 db file (created if doesn’t exist)</p>
+</li>
+<li>
+<p>generated <em>benchmark-method.html</em> with performance results of every test in that execution</p>
+</li>
+<li>
+<p>generated <em>benchmark-history.html</em> with performance results of every execution</p>
+</li>
+<li>
+<p>separate test executions will be labeled in <em>benchmark-history.html</em> with their start time</p>
+</li>
+</ol>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Note_on_Jenkins_Job"><a class="anchor" href="#sec:Note_on_Jenkins_Job"></a><a class="link" href="#sec:Note_on_Jenkins_Job">14.1.1.8. Note on Jenkins Job</a></h5>
+<div class="paragraph">
+<p>For performance tests it is important not to get pass/fail result in terms of being below given threshold, but also to examine trend of those results. We achieve this by tooling described above. In order to keep this data independent of the build machine or build system storage, we are using separate repository to store performance artifacts. Jenkins in copying previous test results into workspace, runs performance tests, then commits and pushes combined results (adds current results to previous results) to repository.</p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:ECMA_Tests"><a class="anchor" href="#sec:ECMA_Tests"></a><a class="link" href="#sec:ECMA_Tests">14.2. ECMA Tests</a></h3>
+<div class="paragraph">
+<p>ECMAScript Language test262 is a test suite intended to check agreement between JavaScript implementations and ECMA-262, the ECMAScript Language Specification (currently 5.1 Edition).The test suite contains thousands of individual tests, each of which tests some specific requirements of the ECMAScript Language Specification. For more info refer to <a href="http://test262.ecmascript.org/" class="bare">http://test262.ecmascript.org/</a></p>
+</div>
+<div class="paragraph">
+<p>Uses of this suite may include:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>grammar tests</p>
+</li>
+<li>
+<p>validation tests</p>
+</li>
+<li>
+<p>run-time tests</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>ECMA test262 suite source code can be found here: <a href="http://hg.ecmascript.org/tests/test262" class="bare">http://hg.ecmascript.org/tests/test262</a></p>
+</div>
+<div class="sect3">
+<h4 id="sec:Grammar_Tests"><a class="anchor" href="#sec:Grammar_Tests"></a><a class="link" href="#sec:Grammar_Tests">14.2.1. Grammar Tests</a></h4>
+<div class="paragraph">
+<p>Based on the JS files included in test262 suite we are generating tests that feed provided JS code into the parser. This operation will result in</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>parser throwing exceptions</p>
+</li>
+<li>
+<p>parsed output will contain standard output</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>First case indicates that parsing provided JS code was not possible. This is considered to be Test Error.</p>
+</div>
+<div class="paragraph">
+<p>Second case case indicates that parsing of the provided code was successful, and will result either</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>output with no errors - code adhered parser grammar</p>
+</li>
+<li>
+<p>output with errors - code violated parser grammar</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Given test must interpret those results to provide proper test output.</p>
+</div>
+<div class="sect4">
+<h5 id="sec:Negative_Tests"><a class="anchor" href="#sec:Negative_Tests"></a><a class="link" href="#sec:Negative_Tests">14.2.1.1. Negative Tests</a></h5>
+<div class="paragraph">
+<p>It is important to note that some of the tests are positive and some are negative. Negative test cases are marked by the authors with <em>@negative</em> JSDoc like marker therefore parser tests must be aware of that to avoid both false positives and false negatives results.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Test_Exclusion"><a class="anchor" href="#sec:Test_Exclusion"></a><a class="link" href="#sec:Test_Exclusion">14.2.1.2. Test Exclusion</a></h5>
+<div class="paragraph">
+<p>To exclude validation tests or run-time related test, implementation is blacklist approach to exclude some of the ECMA test262 tests from execution.</p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:Integration_Tests"><a class="anchor" href="#sec:Integration_Tests"></a><a class="link" href="#sec:Integration_Tests">14.3. Integration Tests</a></h3>
+<div class="paragraph">
+<p>Integration tests based on the stdlib and online-presence code bases can be found in bundle <code>org.eclipse.n4js.hlc.tests</code>
+in package <code>org.eclipse.n4js.hlc.tests.integration</code> (headless case) and in bundle <code>org.eclipse.n4js.ui.tests</code> in
+package <code>org.eclipse.n4js.ui.tests.integration</code> (plugin-UI tests running inside Eclipse). The headless
+tests also execute mangelhaft tests, the UI tests only perform compilation of the test code.</p>
+</div>
+<div class="paragraph">
+<p>More information can be found in the API documentation of classes <code>AbstractIntegrationTest</code> and <code>AbstractIntegrationPluginUITest</code>.</p>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:Test_Helpers"><a class="anchor" href="#sec:Test_Helpers"></a><a class="link" href="#sec:Test_Helpers">14.4. Test Helpers</a></h3>
+<div class="paragraph">
+<p>Test helpers contain utility classes that are reused between different test plug-ins.</p>
+</div>
+<div class="sect3">
+<h4 id="sec:Parameterized_N4JS_Tests"><a class="anchor" href="#sec:Parameterized_N4JS_Tests"></a><a class="link" href="#sec:Parameterized_N4JS_Tests">14.4.1. Parameterized N4JS tests</a></h4>
+<div class="paragraph">
+<p>Xtext JUnit test runer injects test a ParserHelper that allows to run N4JS parser on given input and obtain information abut parsing results. In some cases we want to run this kind of tests on large input data. To address this we provide two utilities ParameterizedXtextRunner and TestCodeProvider. They allow write data driven parser tests.</p>
+</div>
+<div class="sect4">
+<h5 id="sec:ParameterizedXtextRunner"><a class="anchor" href="#sec:ParameterizedXtextRunner"></a><a class="link" href="#sec:ParameterizedXtextRunner">14.4.1.1. ParameterizedXtextRunner</a></h5>
+<div class="paragraph">
+<p>This This junit runner serves two purposes:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>injecting ParserHelper</p>
+</li>
+<li>
+<p>creating multiple test instances for each input data provided</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>This class is based on @link org.eclipse.xtext.testing.XtextRunner and @link org.junit.runners.Parameterized</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:TestCodeProvider"><a class="anchor" href="#sec:TestCodeProvider"></a><a class="link" href="#sec:TestCodeProvider">14.4.1.2. TestCodeProvider</a></h5>
+<div class="paragraph">
+<p>This class is repsonsible for extracting ZipEntry from provided ZipFile. Additinally it can filter out entries that match strings in provided black list file. Filtering out ZipEntries assumes that blacklist file contians Path of ZipEntry in ZipFile as string in one line. Lines starting with <em>#</em> in black list file are ignored by TestCodeProvider.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Example_Of_Parameterized_Parser_Test"><a class="anchor" href="#sec:Example_Of_Parameterized_Parser_Test"></a><a class="link" href="#sec:Example_Of_Parameterized_Parser_Test">14.4.1.3. Example of parameterized parser test</a></h5>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">@RunWith(XtextParameterizedRunner.class)
+@InjectWith(N4JSInjectorProvider.class)
+public class DataDrivenParserTestSuite {
+
+    /**
+     * Zip archives containing test files.
+     */
+    public static final Collection&lt;String&gt; TEST_DATA_RESOURCES = Arrays.asList("foo.zip", "bar.zip");
+
+    /**
+     * Blacklist of files requiring an execution engine.
+     */
+    public static final String BLACKLIST_FILENAME = "blacklist.txt";
+
+    /**
+     * Every generated test will use different ZipEntry as test data
+     */
+    final ZipEntry entry;
+
+    /**
+     * Name of resource containing corresponding ZipEntry
+     */
+    final String resourceName;
+
+    @Inject
+    protected ParseHelper&lt;Script&gt; parserN4JS;
+
+    Collection&lt;String&gt; blackList;
+
+    static final Logger logger = Logger.getLogger("someLogger");
+
+    public CopyOfLibraryParsingTestSuite(ZipEntry entry, String resourceName, Collection&lt;String&gt; blackList) {
+        this.entry = entry;
+        this.resourceName = resourceName;
+        this.blackList = blackList;
+    }
+
+    @Rule
+    public TestRule blackListHandler = new TestRule() {
+        @Override
+        public Statement apply(final Statement base, Description description) {
+            final String entryName = entry.getName();
+            if (blackList.contains(entryName)) {
+                return new Statement() {
+                    @Override
+                    public void evaluate() throws Throwable {
+                        try {
+                            base.evaluate();
+                        } catch (AssertionError e) {
+                            // expected
+                            return;
+                        }
+                    }
+                };
+            } else {
+                return base;
+            }
+        }
+    };
+
+    /**
+     * Generates collection of ZipEntry instances that will be used as data
+     * provided parameter is mapped to name of the test (takes advantage of fact
+     * that ZipEntry.toString() is the same as entry.getName())
+     *
+     * @return
+     * @throws URISyntaxException
+     * @throws ZipException
+     * @throws IOException
+     */
+    @Parameters(name = "{0}")
+    public static Collection&lt;Object[]&gt; data() throws URISyntaxException, ZipException, IOException {
+        return TestCodeProvider.getDataFromZippedRoots(TEST_DATA_RESOURCES, BLACKLIST_FILENAME);
+    }
+
+    /**
+     * generated instances of the tests will use this base implementation
+     *
+     * @throws Exception
+     */
+    @Test
+    public void test() throws Exception {
+        assertNotNull(this.entry);
+        assertNotNull(this.resourceName);
+        assertNotNull(this.parserN4JS);
+
+        //actual test code
+
+    }
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:Issue_Suppression"><a class="anchor" href="#sec:Issue_Suppression"></a><a class="link" href="#sec:Issue_Suppression">14.5. Issue Suppression</a></h3>
+<div class="paragraph">
+<p>It can be useful to suppress certain issues before tests are ran, so that test expectations don’t have to consider inessential warnings. This means that the validator still returns a full list of issues, but before passing them to the testing logic, the issues are filtered.</p>
+</div>
+<div class="paragraph">
+<p>When working with JUnit tests, the custom InjectorProvider <code>N4JSInjectorProviderWithIssueSuppression</code> can be used to configure them to suppress issues.</p>
+</div>
+<div class="paragraph">
+<p>The codes that are suppressed are globally specified by the<br>
+<code>DEFAULT_SUPPRESSED_ISSUE_CODES_FOR_TESTS</code> constant in <code>N4JSLanguageConstants</code>.</p>
+</div>
+<div class="paragraph">
+<p>When working with Xpect tests, the XpectSetupFactory <code>SuppressIssuesSetup</code> can be used. See <a href="#sec:Xpect_Issue_Suppression">Xpext Issue Suppression</a> for more details on Xpect issue suppression.</p>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:Xpect_Tests"><a class="anchor" href="#sec:Xpect_Tests"></a><a class="link" href="#sec:Xpect_Tests">14.6. Xpect Tests</a></h3>
+<div class="paragraph">
+<p>For many tests, Xpect [<a href="appendix_e_bibliography_and_footnotes.html#Xpect">Xpect</a>] is used. Xpect allows for defining tests inside the language which is the language under test. That is, it is possible to refer to a JUnit test method in a special annotated comment, along with arguments passed to that method (typically expectations and the concrete location). Xpect comes with a couple of predefined methods which could be used there, e.g., tests for checking whether some expected error messages actually are produced. We have defined (and will probably define more) N4JS specific test methods.</p>
+</div>
+<div class="paragraph">
+<p>In the following, we describe the most common Xpect test methods we use. Note that we do not use all types of tests shipped with Xpect. For example, AST tests (comparing the actual AST with an expected AST, using string dumps) is too hard to maintain.</p>
+</div>
+<div class="paragraph">
+<p>Xpect test can be ignored by inserting a <code>!</code> between <code>XPECT</code> and the test name, e.g.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>// XPECT ! errors --&gt; '~$message$~' at "~$location$~"</code></pre>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Xpect_Test_Setup"><a class="anchor" href="#sec:Xpect_Test_Setup"></a><a class="link" href="#sec:Xpect_Test_Setup">14.6.1. Xpect Test Setup</a></h4>
+<div class="paragraph">
+<p>The setup is either defined in the file itself, e.g.,</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>/* XPECT_SETUP org.eclipse.n4js.spec.tests.N4JSSpecTest END_SETUP */</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>or bundle-wide for a specific language in the plugin.xml (or fragment.xml), e.g.,</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>&lt;extension point="org.xpect.testSuite"&gt;
+    &lt;testSuite class="org.eclipse.n4js.spec.tests.N4JSSpecTest" fileExtension="n4js" /&gt;
+&lt;/extension&gt;</code></pre>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Xpect_Issue_Suppression"><a class="anchor" href="#sec:Xpect_Issue_Suppression"></a><a class="link" href="#sec:Xpect_Issue_Suppression">14.6.2. Xpect Issue Suppression</a></h4>
+<div class="paragraph">
+<p>To configure an Xpect test class to suppress issues, you have to use the <code>@XpectImport</code> annotation to import the XpectSetupFactory <code>org.eclipse.n4js.xpect.validation.suppression.SuppressIssuesSetup</code>. Any Xpect test that is executed by this runner will work on the filtered list of issues.</p>
+</div>
+<div class="paragraph">
+<p>Similar to issue suppressing JUnit tests, the suppressed issue codes are specified by<br>
+<code>DEFAULT_SUPPRESSED_ISSUE_CODES_FOR_TESTS</code> constant in <code>N4JSLanguageConstants</code>.</p>
+</div>
+<div class="paragraph">
+<p>For further per-file configuration a custom <code>XPECT_SETUP</code> parameter can be used. This overrides the suppression configuration of an Xpect runner class for the current file.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>/* XPECT_SETUP org.eclipse.n4js.tests.N4JSXpectTest
+
+IssueConfiguration {
+    IssueCode "AST_LOCAL_VAR_UNUSED" {enabled=true}
+}
+
+END_SETUP
+*/</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>In this example the issue code <code>AST_LOCAL_VAR_UNUSED</code> is explicitly enabled which means that no issue with this issue code will be suppressed.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Xpect_Provided_Test_Methods"><a class="anchor" href="#sec:Xpect_Provided_Test_Methods"></a><a class="link" href="#sec:Xpect_Provided_Test_Methods">14.6.3. Xpect Provided Test Methods</a></h4>
+<div class="sect4">
+<h5 id="errors"><a class="anchor" href="#errors"></a><a class="link" href="#errors">14.6.3.1. errors</a></h5>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Definition
+</td>
+<td class="hdlist2">
+<p>Single line:</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>// XPECT errors --&gt; '~$message$~' at "~$location$~"</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Multi line:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>/* XPECT errors ---
+'~$message_1$~' at "~$location_1$~"
+~$\dots$~
+'~$message_n$~' at "~$location_n$~"
+--- */</code></pre>
+</div>
+</div>
+</td>
+</tr>
+</table>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Description
+</td>
+<td class="hdlist2">
+<p>Checks that one or more errors are issued at given location and compares the actual messages at a given location with the expected messages specified in the test.</p>
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>Also see <code>no errors</code> below.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="warnings"><a class="anchor" href="#warnings"></a><a class="link" href="#warnings">14.6.3.2. warnings</a></h5>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Definition
+</td>
+<td class="hdlist2">
+<p>Single line:<br></p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>// XPECT warnings --&gt; '~$Message$~' at "~$Location$~"</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Multi line:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>/* XPECT warnings ---
+'~$message_1$~' at "~$location_1$~"
+~$\dots$~
+'~$message_n$~' at "~$location_n$~"
+--- */</code></pre>
+</div>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Description
+</td>
+<td class="hdlist2">
+<p>Checks that one or more warnings are issued at given location and compares the actual messages at a given location with the expected messages specified in the test.</p>
+</td>
+</tr>
+</table>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:N4JS_Specific_Xpect_Test_Methods"><a class="anchor" href="#sec:N4JS_Specific_Xpect_Test_Methods"></a><a class="link" href="#sec:N4JS_Specific_Xpect_Test_Methods">14.6.4. N4JS Specific Xpect Test Methods</a></h4>
+<div class="paragraph">
+<p>There are a lot of N4 specific Xpect tests methods available. To get all of these methods, search for references to annotation <code>org.xpect.runner.Xpect</code> in the N4 test plugins.</p>
+</div>
+<div class="sect4">
+<h5 id="sec:XPECT_noerrors"><a class="anchor" href="#sec:XPECT_noerrors"></a><a class="link" href="#sec:XPECT_noerrors">14.6.4.1. noerrors and nowarnings</a></h5>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Definition
+</td>
+<td class="hdlist2">
+<p>Single line:</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>// XPECT noerrors --&gt; '~$messageOrComment$~' at "~$location$~"</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Multi line:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>/* XPECT noerrors ---
+'~$messageOrComment_1$~' at "~$location_1$~"
+~$\dots$~
+'~$messageOrComment_n$~' at "~$location_n$~"
+--- */</code></pre>
+</div>
+</div>
+</td>
+</tr>
+</table>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Provided by
+</td>
+<td class="hdlist2">
+<p><code>NoerrorsValidationTest</code></p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Description
+</td>
+<td class="hdlist2">
+<p>Checks that at the given location <em>no</em> error (or warning) is issued. This tests is roughly speaker the opposite of <code>errors</code>. The idea behind this test is to replace comments in the code, stating that an expression is assumed to be valid, with an explicit test. This is in particular useful when you start working on a task, in which there are (wrong) errors at a given position, or for bug report.</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Example
+</td>
+<td class="hdlist2">
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>function foo(any o): number {
+    if (o instanceof string) {
+        // XPECT noerrors --&gt; "effect systems knows that o is a string" at "o"
+        return o.length;
+    }
+    return 0;
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>is clearer and more explicit than</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>function foo(any o): number {
+    if (o instanceof string) {
+        // here should be no error:
+        return o.length;
+    }
+    return 0;
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Also, the <code>noerrors</code> version will fail with a correct description, while the second one would fail with a general error and no location. Once the feature is implemented, regressions are detected much easier with the explicit version.</p>
+</div>
+</div>
+</div>
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:XPECT_scope"><a class="anchor" href="#sec:XPECT_scope"></a><a class="link" href="#sec:XPECT_scope">14.6.4.2. scope</a></h5>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Definition
+</td>
+<td class="hdlist2">
+<p>Single line:</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>// XPECT scope at $location$ --&gt; ~$[$~!~$]$~~$name_1$~, ~$\dots$~, ~$[$~!~$]$~~$name_n$~ ~$[$ ~, ...~$]$~</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Multi line:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>/* XPECT scope $location$ ---
+~$[$~!~$]$~~$name_1$~, ~$\dots$~,
+~$[$~!~$]$~~$name_n$~~$[$ ~, ...~$]$~
+--- */</code></pre>
+</div>
+</div>
+</td>
+</tr>
+</table>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Provided by
+</td>
+<td class="hdlist2">
+<p><code>PositionAwareScopingXpectTest</code></p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Description
+</td>
+<td class="hdlist2">
+<p>Checks that the expected elements are actually found in the scope (or explicitly not found, when <code>!</code>   is used). This is a modified version of the Xpect built-in scope test, ensuring that also elements only put into the scope when they are explicitly requested are found.</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Example
+</td>
+<td class="hdlist2">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>// XPECT scope at 'this.|$data_property_b' --&gt; a, b, $data_property_b, !newB, ...
+return this.$data_property_b + "_getter";</code></pre>
+</div>
+</div>
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:XPECT_scopeWithPosition"><a class="anchor" href="#sec:XPECT_scopeWithPosition"></a><a class="link" href="#sec:XPECT_scopeWithPosition">14.6.4.3. scopeWithPosition</a></h5>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Definition
+</td>
+<td class="hdlist2">
+<p>Single line:</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">// XPECT scopeWithPosition at $location$ --&gt; ~$[$~!~$]$~~$name_1$~ - ~$pos_1$~, ~$\dots$~, ~$[$~!~$]$~~$name_n$~ - ~$pos_n$~ ~$[$ ~, ...~$]$~</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Multi line:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">/* XPECT scopeWithPosition $location$ ---
+~$[$~!~$]$~~$name_1$~ - ~$pos_1$~, ~$\dots$~,
+~$[$~!~$]$~~$name_n$~ - ~$pos_n$~ ~$[$ ~, ...~$]$~
+--- */</code></pre>
+</div>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Provided by
+</td>
+<td class="hdlist2">
+<p><code>PositionAwareScopingXpectTest</code></p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Description
+</td>
+<td class="hdlist2">
+<p>Checks that the expected elements are actually found in the scope (or explicitly not found, when <code>!</code>   is used). The concrete syntax of the position, which is usually the line number, or the line number prefix with <code>T</code>   if a type element is referenced, is described in <code>EObjectDescriptionToNameWithPositionMapper</code>.</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Example
+</td>
+<td class="hdlist2">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>/* XPECT scopeWithPosition at foo2 ---
+    b - 9,
+    c - 25,
+    foo - T3,
+    foo2 - T9,
+    ...
+---*/
+foo2()</code></pre>
+</div>
+</div>
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:XPECT_scopeWithResource"><a class="anchor" href="#sec:XPECT_scopeWithResource"></a><a class="link" href="#sec:XPECT_scopeWithResource">14.6.4.4. scopeWithResource</a></h5>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Definition
+</td>
+<td class="hdlist2">
+<p>Single line:</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>//</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Multi line:</p>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Provided by
+</td>
+<td class="hdlist2">
+<p><code>N4JSXpectTest</code></p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Description
+</td>
+<td class="hdlist2">
+<p>Compares scope including resource name but not line number.</p>
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:XPECT_binding"><a class="anchor" href="#sec:XPECT_binding"></a><a class="link" href="#sec:XPECT_binding">14.6.4.5. binding</a></h5>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Definition
+</td>
+<td class="hdlist2">
+<p>Single line:</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>//</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Multi line:</p>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Provided by
+</td>
+<td class="hdlist2">
+<p><code>N4JSXpectTest</code></p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Description
+</td>
+<td class="hdlist2">
+<p>Checks that a given element is bound to something identified by (simple) qualified name. The check is designed as simple as possible. That is, simply the next following expression is tested, and within that we expect a property access or a direct identifiable element. The compared name is the simple qualified name, that is container (type) followed by elements name, without URIs of modules etc.</p>
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:XPECT_linkedPathname"><a class="anchor" href="#sec:XPECT_linkedPathname"></a><a class="link" href="#sec:XPECT_linkedPathname">14.6.4.6. linkedPathname</a></h5>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Definition
+</td>
+<td class="hdlist2">
+<p>Single line:</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>// XPECT linkedPathname at '$location$' --&gt; ~$pathname$~</code></pre>
+</div>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Provided by
+</td>
+<td class="hdlist2">
+<p><code>LinkingXpectMethod</code></p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Description
+</td>
+<td class="hdlist2">
+<p>Checks that an identifier is linked to a given element identified by its path name. The path name is the qualified name in which the segments are separated by ’/’. This test does not use the qualified name provider, as the provider may return null for non-globally available elements. It rather computes the name again by using reflection, joining all <code>name</code>   properties of the target and its containers.</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Example
+</td>
+<td class="hdlist2">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>// XPECT linkedPathname at 'foo()' --&gt; C/foo
+new C().foo();</code></pre>
+</div>
+</div>
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:XPECT_type_of"><a class="anchor" href="#sec:XPECT_type_of"></a><a class="link" href="#sec:XPECT_type_of">14.6.4.7. type of</a></h5>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Definition
+</td>
+<td class="hdlist2">
+<p>Single line:</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>// XPECT type of '$location$' --&gt; ~$type$~</code></pre>
+</div>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Provided by
+</td>
+<td class="hdlist2">
+<p><code>N4JSXpectTest</code></p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Description
+</td>
+<td class="hdlist2">
+<p>Checks that the type inferred at location is similar to expected type.</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Example
+</td>
+<td class="hdlist2">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>// XPECT type of 'x' --&gt; string
+var x = 'hello';
+// XPECT type of 'foo()' --&gt; union{A,number}
+var any y = foo();</code></pre>
+</div>
+</div>
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:XPECT_expectedType"><a class="anchor" href="#sec:XPECT_expectedType"></a><a class="link" href="#sec:XPECT_expectedType">14.6.4.8. expectedType</a></h5>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Definition
+</td>
+<td class="hdlist2">
+<p>-</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Single line
+</td>
+<td class="hdlist2">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>// XPECT expectedType at 'location' --&amp;gt; Type</code></pre>
+</div>
+</div>
+<div class="literalblock">
+<div class="content">
+<pre>The location (at) is optional.</pre>
+</div>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Provided by
+</td>
+<td class="hdlist2">
+<p><code>N4JSXpectTest</code></p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Description
+</td>
+<td class="hdlist2">
+<p>Checks that an element/expression has a certain expected type (i.e. Xsemantics judgment expectedTypeIn).</p>
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:XPECT_elementKeyword"><a class="anchor" href="#sec:XPECT_elementKeyword"></a><a class="link" href="#sec:XPECT_elementKeyword">14.6.4.9. elementKeyword</a></h5>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Definition
+</td>
+<td class="hdlist2">
+<p>Single line:</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>// XPECT elementKeyword at 'myFunction' -&gt; function</code></pre>
+</div>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Example
+</td>
+<td class="hdlist2">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>interface I {
+  fld: int;
+  get g(): string;
+  set s(p:string);
+}
+
+//XPECT elementKeyword at 'string' --&gt; primitive
+var v1: string;
+
+//XPECT elementKeyword at 'I' --&gt; interface
+var i: I;
+
+//XPECT elementKeyword at 'fld' --&gt; field
+i.fld;</code></pre>
+</div>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Provided by
+</td>
+<td class="hdlist2">
+<p><code>ElementKeywordXpectMethod</code></p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Description
+</td>
+<td class="hdlist2">
+<p>Checks that an element/expression has a certain element keyword. The expected element keyword is identical
+to the element keyword shown when hovering the mouse over that element/expression in the N4JS IDE. This method is particuarly useful for testing merged elements of union/intersection.</p>
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:XPECT_accessModifier"><a class="anchor" href="#sec:XPECT_accessModifier"></a><a class="link" href="#sec:XPECT_accessModifier">14.6.4.10. accessModifier</a></h5>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Definition
+</td>
+<td class="hdlist2">
+<p>Single line:</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>// XPECT accessModifier at 'myFunction' -&gt; function</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>or</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>// XPECT accessModifier -&gt; function</code></pre>
+</div>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Example
+</td>
+<td class="hdlist2">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>// XPECT accessModifier --&gt; publicInternal
+export @Internal public abstract class MyClass2 {
+
+// XPECT accessModifier --&gt; project
+abstract m1(): string;
+
+// XPECT accessModifier at 'm2' --&gt; project
+m2(): string {
+    return "";
+  }
+}</code></pre>
+</div>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Provided by
+</td>
+<td class="hdlist2">
+<p><code>AccessModifierXpectMethod</code></p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Description
+</td>
+<td class="hdlist2">
+<p>Checks that an element/expression has a certain accessibility.</p>
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:XPECT_compileResult"><a class="anchor" href="#sec:XPECT_compileResult"></a><a class="link" href="#sec:XPECT_compileResult">14.6.4.11. compileResult</a></h5>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Definition
+</td>
+<td class="hdlist2">
+<p>Single line:</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>//</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Multi line:</p>
+</div>
+</td>
+</tr>
+</table>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Provided by
+</td>
+<td class="hdlist2">
+<p>-</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Description
+</td>
+<td class="hdlist2">
+<p><em>This test should only be used during development of compiler and not used in the long run, because this kind of test is extremely difficult to maintain.</em></p>
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:XPECT_output"><a class="anchor" href="#sec:XPECT_output"></a><a class="link" href="#sec:XPECT_output">14.6.4.12. output</a></h5>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Definition
+</td>
+<td class="hdlist2">
+<p>Single line:</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>//</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Multi line:</p>
+</div>
+</td>
+</tr>
+</table>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Provided by
+</td>
+<td class="hdlist2">
+<p>-</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Description
+</td>
+<td class="hdlist2">
+<p>The most important test for compiler/transpiler, but also for ensuring that N4JS internal validations and assumptions are true at runtime.</p>
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:XPECT_outputRegEx"><a class="anchor" href="#sec:XPECT_outputRegEx"></a><a class="link" href="#sec:XPECT_outputRegEx">14.6.4.13. outputRegEx</a></h5>
+
+</div>
+<div class="sect4">
+<h5 id="sec:XPECT_calculatedAccessModifier"><a class="anchor" href="#sec:XPECT_calculatedAccessModifier"></a><a class="link" href="#sec:XPECT_calculatedAccessModifier">14.6.4.14. calculatedAccessModifier</a></h5>
+
+</div>
+<div class="sect4">
+<h5 id="sec:XPECT_spec"><a class="anchor" href="#sec:XPECT_spec"></a><a class="link" href="#sec:XPECT_spec">14.6.4.15. spec</a></h5>
+
+</div>
+<div class="sect4">
+<h5 id="sec:XPECT_deadCode"><a class="anchor" href="#sec:XPECT_deadCode"></a><a class="link" href="#sec:XPECT_deadCode">14.6.4.16. deadCode</a></h5>
+
+</div>
+<div class="sect4">
+<h5 id="sec:XPECT_returnOrThrows"><a class="anchor" href="#sec:XPECT_returnOrThrows"></a><a class="link" href="#sec:XPECT_returnOrThrows">14.6.4.17. returnOrThrows</a></h5>
+
+</div>
+<div class="sect4">
+<h5 id="sec:XPECT_lint"><a class="anchor" href="#sec:XPECT_lint"></a><a class="link" href="#sec:XPECT_lint">14.6.4.18. lint</a></h5>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Definition
+</td>
+<td class="hdlist2">
+<p>Single line:</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>/* XPECT lint */</code></pre>
+</div>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Provided by
+</td>
+<td class="hdlist2">
+<p><code>CompileAndLintTest</code></p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Description
+</td>
+<td class="hdlist2">
+<p>Passes the generated code through the JSHint JavaScript linter. This test includes for instance checking for missing semicolons and undefined variables. The whole test exclusively refers to the generated javascript code.</p>
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:XPECT_lintFails"><a class="anchor" href="#sec:XPECT_lintFails"></a><a class="link" href="#sec:XPECT_lintFails">14.6.4.19. lintFails</a></h5>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Definition
+</td>
+<td class="hdlist2">
+<p>Single line:</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>/* XPECT lintFails */</code></pre>
+</div>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Provided By
+</td>
+<td class="hdlist2">
+<p><code>CompileAndLintTest</code></p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Description
+</td>
+<td class="hdlist2">
+<p>Negation of lint. Fails on linting success. Expects linting errors.</p>
+</td>
+</tr>
+</table>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:FIXME_Xpect_modifier"><a class="anchor" href="#sec:FIXME_Xpect_modifier"></a><a class="link" href="#sec:FIXME_Xpect_modifier">14.6.5. FIXME Xpect modifier</a></h4>
+<div class="paragraph">
+<p>A modification of the official Xpect framework allows us to use the FIXME modifier on each test. <sup class="footnote">[<a id="_footnoteref_15" class="footnote" href="appendix_e_bibliography_and_footnotes.html#_footnote_15" title="View footnote.">15</a>]</sup></p>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Syntax
+</td>
+<td class="hdlist2">
+<p>FIXME can be applied on any test just after the XPECT keyword:</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>// XPECT FIXME  xpectmethod ... --&gt; ...</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Tests will still be ignored if an exclamation mark (!) is put between XPECT and FIXME.</p>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Description
+</td>
+<td class="hdlist2">
+<p>Using FIXME on a test negates the result of the underlying JUnit test framework. Thus a failure will be reported as a <code>true assertion</code>   and an assertion that holds will be reported as <code>failure</code>  . This enables to author valuable tests of behaviour, which is still not functional.</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Example
+</td>
+<td class="hdlist2">
+<p>For instance, if we encounter an error-message at a certain code position, but the code is perfectly right, then we have an issue. We can annotate the situation with a ’fix me’ ’noerrors’ expectation:</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>// Perfectly right behaviour XPECT FIXME noerrors --&gt;
+console.log("fine example code with wrong error marker here.");</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>This turns the script into an Xpect test. We can integrate the test right away into our test framework and it will not break our build (even though the bug is not fixed).</p>
+</div>
+<div class="paragraph">
+<p>When the issue will be worked on, the developer starts with removing ’FIXME’ turning this into useful unit-test.</p>
+</div>
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>It is crucial to understand that FIXME negates the whole assertion. Example: If one expects an error marker at a certain position using the ’errors’ directive, one must give the exact wording of the expected error-message to actually get the FIXME behaviour working. To avoid strange behaviour it is useful to describe the expected error a comment in front of the expectation and leave the message-section empty.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Expectmatrix_Xpect_Test_Methods"><a class="anchor" href="#sec:Expectmatrix_Xpect_Test_Methods"></a><a class="link" href="#sec:Expectmatrix_Xpect_Test_Methods">14.6.6. Expectmatrix Xpect tests</a></h4>
+<div class="paragraph">
+<p>Applying test-driven development begins with authoring acceptance and functional tests for the work in the current sprint. By this the overall code quality is ensured for the current tasks to solve. Rerunning all collected tests with each build ensures the quality of tasks solved in the past. Currently there is no real support for tasks, which are not in progress but are known to be processed in the near or far future. Capturing non-trivial bug reports and turning them into reproducable failing test-cases is one example.</p>
+</div>
+<div class="paragraph">
+<p>Usually people deactivate those future-task-tests in the test code by hand. This approach doesn’t allow to calculate any metrics about the code. One such metric would be: Is there any reported bug solved just by working on an (seemingly unrelated) scheduled task?</p>
+</div>
+<div class="paragraph">
+<p>To achieve measurements about known problems, a special build-scenario is set up. As a naming convention all classes with names matching <code>*  Pending</code> are assumed to be Junit tests. In bundle <code>org.eclipse.n4js.expectmatrix.tests</code> two different Xpect-Runners are provided, each working on its own subfolder. Usual Xpect-tests are organised in folder xpect-test while in folder xpect-pending all future-tests are placed. A normal maven-build processes only the standard junit and xpect tests. Starting a build with profile <code>execute-expectmatrix-pending-tests</code> will additionally execute Xpect tests from folder xpect-pending and for all bundles inheriting from <code>/tests/pom.xml</code> all unit tests ending in <code>*  Pending</code>. This profile is deactivated by default.</p>
+</div>
+<div class="paragraph">
+<p>A special jenkins-job - N4JS-IDE_nightly_bugreports_pending - is configured to run the pending tests and render an overview und history to compare issues over time. Due to internal Jenkins structures this build always marked failed, even though the maven-build succeeds successfully.</p>
+</div>
+<div class="paragraph">
+<p>Relevant additional information can be found in</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Jenkins job for pending cases: <a href="http://build-master:8080/view/N4JS/job/N4JS-IDE_nightly_bugreports_pending/" class="bare">http://build-master:8080/view/N4JS/job/N4JS-IDE_nightly_bugreports_pending/</a></p>
+</li>
+<li>
+<p>Testmatrix <a href="https://docs.google.com/a/numberfour.eu/spreadsheets/d/1Blo58cRwIWemaiBNSnOtsQ8U7b3FoodX3yEs7oJKIg0/" class="bare">https://docs.google.com/a/numberfour.eu/spreadsheets/d/1Blo58cRwIWemaiBNSnOtsQ8U7b3FoodX3yEs7oJKIg0/</a></p>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect3">
+<h4 id="xpect-lint-tests"><a class="anchor" href="#xpect-lint-tests"></a><a class="link" href="#xpect-lint-tests">14.6.7. Xpect Lint Tests</a></h4>
+<div id="sec:XPECT_Lint_Tests" class="imageblock">
+<div class="content">
+<img src="chapters/15_tests/images/diag_XpectLint.svg" alt="diag XpectLint">
+</div>
+<div class="title">Figure 46. Xpect Lint</div>
+</div>
+<div class="paragraph">
+<p>The test transpiles the provided n4js resource and checks the generated code. This is achieved using the Javascript linter JSHint.</p>
+</div>
+<div class="paragraph">
+<p>After transpiling the provided n4js resource the LintXpectMethod combines the generated code with the jshint code into a script. It calls the JSHint validation function and returns the linting result as a json object. The error results are displayed in the console. The script is executed using the <code>Engine</code> class. (<a href="execution.html#sec:Design">Design</a>)</p>
+</div>
+<div class="paragraph">
+<p>For the linting process an adapted configuration for JSHint is used. For the needs of N4JS the linter is configured to recognise N4JS specific globals. Details about the error codes can be found at the <a href="https://github.com/jshint/jshint/blob/2444a0463e1a99d46e4afa50ed934c317265529d/src/messages.js">jshint repository</a>.</p>
+</div>
+<div class="paragraph">
+<p>The following warnings are explicitly enabled/disabled:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><strong>W069</strong>: [’a’] is better written in dot notation <strong>DISABLED</strong></p>
+</li>
+<li>
+<p><strong>W033</strong>: Missing semicolon <strong>ENABLED</strong></p>
+</li>
+<li>
+<p><strong>W014</strong>: Bad line breaking before ’a’. <strong>DISABLED</strong></p>
+</li>
+<li>
+<p><strong>W032</strong>: Uneccesarry semicolon <strong>ENABLED</strong></p>
+</li>
+<li>
+<p><strong>W080</strong>: It’s not necessary to initialize ’a’ to ’undefined’. <strong>ENABLED</strong></p>
+</li>
+<li>
+<p><strong>W078</strong>: Setter is defined without getter. <strong>DISABLED</strong></p>
+</li>
+<li>
+<p>ES6 related warnings are <strong>disabled</strong> using the ’esnext’ option: <strong>W117</strong>: Symbol is not defined. <strong>DISABLED</strong> <strong>W104</strong>: ’yield’ is only available in ES6 <strong>DISABLED</strong> <strong>W117</strong>: Promise is not defined <strong>DISABLED</strong> <strong>W119</strong>: function* is only available in ES6 <strong>DISABLED</strong></p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>The xpect lint test only applies if the provided resource passes the n4js compiler.</p>
+</div>
+<div class="paragraph">
+<p>The xpect method lintFails can be used to create negative tests. All linting issues discovered during the development of the xpect plugin have there own negative test to keep track of their existence.</p>
+</div>
+<div class="paragraph">
+<p>Additional information:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>JSHint: <a href="http://jshint.com/docs/" class="bare">http://jshint.com/docs/</a></p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="xpect-proposal-tests"><a class="anchor" href="#xpect-proposal-tests"></a><a class="link" href="#xpect-proposal-tests">14.7. Xpect Proposal Tests</a></h3>
+<div class="paragraph">
+<p>Proposal tests are all tests which verify the existence and application of completion proposals, created by content assist, quick fixes etc.</p>
+</div>
+<div class="paragraph">
+<p>The key attributes of a proposal (cf <code>ConfigurableCompletionProposal</code>) are:</p>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+displayString
+</td>
+<td class="hdlist2">
+<p>the string displayed in the proposal list</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+replacementString
+</td>
+<td class="hdlist2">
+<p>simple variant of which is to be added to document, not necessarily the whole replacement (as this may affect several locations and even user interaction)</p>
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>In the tests, a <em>proposal is identified by a string contained in the displayString</em>. If several proposal match, test will fail (have to rewrite test setup or proposal identifier to be longer). Proposal identifier should be as short as possible (to make test robust), but not too short (to make test readable).</p>
+</div>
+<div class="paragraph">
+<p>The following proposal tests are defined:</p>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+contentAssist <math xmlns="http://www.w3.org/1998/Math/MathML"><mrow><mo>[</mo></mrow></math> List <math xmlns="http://www.w3.org/1998/Math/MathML"><mrow><mo>]</mo></mrow></math>
+</td>
+<td class="hdlist2">
+<p>verifies proposals created by content assist</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+quickFix <math xmlns="http://www.w3.org/1998/Math/MathML"><mrow><mo>[</mo></mrow></math> List <math xmlns="http://www.w3.org/1998/Math/MathML"><mrow><mo>]</mo></mrow></math>
+</td>
+<td class="hdlist2">
+<p>verifies proposals created by quick fixes. Cursor position is relevant, that’s handled by the framework. We only create tests with cursor position – fixes applied via the problem view should work similarly, but without final cursor position.</p>
+<div class="paragraph">
+<p>If no error is found at given position, test will fail (with appropriate error message!). In call cases of apply, the issue must be resolved. Usually, fixing an issue may leave the file invalid as other issues still exists, or because by fixing one issue others may be introduced (which may happen often as we try to avoid consequential errors in validation). For some special cases, quickFix tests support special features, see below.</p>
+</div>
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>Not tested in this context: Verify proposal description, as these tests would be rather hard to maintain and the descriptions are often computed asynchronously.</p>
+</div>
+<div class="sect3">
+<h4 id="sec:Validation_vs__Non_Validation"><a class="anchor" href="#sec:Validation_vs__Non_Validation"></a><a class="link" href="#sec:Validation_vs__Non_Validation">14.7.1. Validation vs. Non-Validation</a></h4>
+<div class="paragraph">
+<p>We expect proposal tests to be applied on non-valid test files, and usually file is also broken after a proposal has been applied. Thus, the test-suite must not fail if the file is not valid.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:General_Proposal_Test_Features"><a class="anchor" href="#sec:General_Proposal_Test_Features"></a><a class="link" href="#sec:General_Proposal_Test_Features">14.7.2. General Proposal Test Features</a></h4>
+<div class="sect4">
+<h5 id="sec:Test_Variables"><a class="anchor" href="#sec:Test_Variables"></a><a class="link" href="#sec:Test_Variables">14.7.2.1. Test Variables</a></h5>
+<div class="paragraph">
+<p>Often, list of proposals are similar for different tests (which define different scenarios in which the proposals should be generated). For that reason, variables can be defined in the test set up:</p>
+</div>
+<div class="paragraph">
+<p>In the Xpect-Setup there is now a special <code>Config</code> component where specific switches are accessible. For instance the timeout switch for content assist can be modified:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>/* XPECT_SETUP org.eclipse.n4js.tests.N4JSNotValidatingXpectPluginUITest
+    ...
+    Config {
+        content_assist_timeout = 1000
+        ...
+    }
+    ...
+*/</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Note: There should only be one <code>Config</code> component per Xpect-Setup.</p>
+</div>
+<div class="paragraph">
+<p>Variables are introduced via the <code>VarDef</code> component. It takes a string argument as the variable name on construction. Inside the body one add <code>MemberLists</code> and <code>StringLists</code> arguments. Variable definitions may appear in <code>Config</code> bodies or in the Xpect-Setup.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>VarDef "objectProposals" {
+    ...
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Define variables with expression: A simple selector is given with the <code>MemberList</code> component. These components take three <code>String</code> arguments in the constructor. The first one is a typename. The second one is the feature selector, e.g. <code>methods</code>  , <code>fields</code>  , …and the third one defines the visibility.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>/* XPECT_SETUP
+VarDef "stringProposals" { MemberList  "String" "methods" "public" {}}
+END_SETUP */</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>We have to define a filter later in Xtend/Java, e.g., <code>getClassWithName( <em>className</em> ).filterType(<em>methods</em>).filterVisibility(<em>accessodifier</em>)&#8230;&#8203;</code></p>
+</div>
+<div class="paragraph">
+<p>A variable is later referenced as follows:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>&lt;$variable&gt;</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Usage example:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>// XPECT contentAssistList at 'a.&lt;|&gt;methodA' proposals --&gt; &lt;$stringProposals&gt;, methodA2
+a.methodA</code></pre>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Location_and_Selection"><a class="anchor" href="#sec:Location_and_Selection"></a><a class="link" href="#sec:Location_and_Selection">14.7.2.2. at – Location and Selection</a></h5>
+<div class="paragraph">
+<p>Tokens in expectation/setup:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>&lt;|&gt;</code> cursor position</p>
+</li>
+<li>
+<p><code>&lt;[&gt;</code> selection start → also defines cursor position</p>
+</li>
+<li>
+<p><code>&lt;]&gt;</code> selection end</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>All proposal tests have to specify a location via <code>at</code>, the location must contain the cursor position and may contain a selection. E.g.:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>// XPECT contentAssistList at 'a.&lt;|&gt;methodA' apply 'methodA2' --&gt; a.methodA2()&lt;|&gt;methodA
+// XPECT contentAssistList at 'a.&lt;|&gt;&lt;[&gt;methodA&lt;]&gt;' apply 'methodA2' override --&gt; a.methodA2()&lt;|&gt;
+a.methodA</code></pre>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Multi_Line_Expectations_in_Proposal_Tests"><a class="anchor" href="#sec:Multi_Line_Expectations_in_Proposal_Tests"></a><a class="link" href="#sec:Multi_Line_Expectations_in_Proposal_Tests">14.7.2.3. Multi Line Expectations in Proposal Tests</a></h5>
+<div class="paragraph">
+<p>In multiline expectations, ignored lines can be marked with <code>&lt;&#8230;&#8203;&gt;</code>. This means that 0 to n lines may occur but are ignored for comparison.</p>
+</div>
+<div class="paragraph">
+<p>All multiline expectations are compared line-wise, with exact match except line delimiters (which are ignored as well)</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Timeout"><a class="anchor" href="#sec:Timeout"></a><a class="link" href="#sec:Timeout">14.7.2.4. Timeout and Performance</a></h5>
+<div class="paragraph">
+<p>We define a default timeout for content assist tests. In set up, this timeout may be changed:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">/* XPECT SETUP
+...
+content_assist_timeout = 2000ms
+...
+END_SETUP */</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Performance is measured by measuring the runtime of tests, we should later setup performance measurements similar to the performance tests.</p>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="proposals-verify-existence-of-proposals"><a class="anchor" href="#proposals-verify-existence-of-proposals"></a><a class="link" href="#proposals-verify-existence-of-proposals">14.7.3. proposals – Verify Existence of Proposals</a></h4>
+<div class="paragraph">
+<p>In general, one could verify if certain proposals are present or not present, and in which order they are present. This is verified by the <code>proposals</code> argument.</p>
+</div>
+<div class="paragraph">
+<p>E.g.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>// XPECT contentAssistList at 'a.&lt;|&gt;methodA' proposals --&gt; &lt;$stringProposals&gt;, methodA2
+a.methodA</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Additional flags:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Order modifier:</p>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+unordered
+</td>
+<td class="hdlist2">
+<p>by default</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+ordered
+</td>
+<td class="hdlist2">
+<p>the given expectations have to have that order, between these expectations other proposals may be present (in case of contains)</p>
+</td>
+</tr>
+</table>
+</div>
+</li>
+<li>
+<p>Subset modifier:</p>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+exactly
+</td>
+<td class="hdlist2">
+<p>(default, maybe changed later) no other expectations as the given ones (usually <code>contains</code>   is recommended).</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+contains
+</td>
+<td class="hdlist2">
+<p>at least the given expectations must be present, but others may be there as well.</p>
+<div class="paragraph">
+<p>Using <em>contains</em> must be used with care since we match items by searching for a proposal which contains one of the expected strings as a substring. So if the only available proposal were ’methodA2’ and we would test if proposals contain ’methodA’, ’methodA2’ we would obtain a passing test.</p>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+not
+</td>
+<td class="hdlist2">
+<p>any of the given proposals must be NOT be proposed</p>
+</td>
+</tr>
+</table>
+</div>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Verify_displayed_string"><a class="anchor" href="#sec:Verify_displayed_string"></a><a class="link" href="#sec:Verify_displayed_string">14.7.4. display – Verify displayed string</a></h4>
+<div class="paragraph">
+<p>We do not verify the text style. We only verify text:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>// XPECT contentAssistList at 'a.&lt;|&gt;methodA' display 'methodA2' --&gt; 'methodA2(): any - A'
+a.methodA</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>This kind of test should be only applied for few scenarios, because the long display tests are rather hard to maintain.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Apply_Proposal"><a class="anchor" href="#sec:Apply_Proposal"></a><a class="link" href="#sec:Apply_Proposal">14.7.5. apply – Apply Proposal</a></h4>
+<div class="paragraph">
+<p>Execution of proposal, the expectation describes the expected text result. The tests follow the naming convention of Ending in …Application.</p>
+</div>
+<div class="paragraph">
+<p>Additional flags:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>insertion mode</p>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+insert
+</td>
+<td class="hdlist2">
+<p>(default) Ctrl not pressed, proposal is inserted at given location</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+override
+</td>
+<td class="hdlist2">
+<p>Ctrl is pressed, proposal overrides selection.</p>
+</td>
+</tr>
+</table>
+</div>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Single line assumes change at line of initial cursor position:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>// XPECT contentAssist at 'a.&lt;|&gt;methodA' apply 'methodA2' --&gt; a.methodA2()methodA
+// XPECT contentAssist at 'a.&lt;|&gt;methodA' apply 'methodA2' insert --&gt; a.methodA2()methodA
+// XPECT contentAssist at 'a.&lt;|&gt;methodA' apply 'methodA2' override --&gt; a.methodA2()
+a.methodA</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>or</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>// XPECT quickFix at 'a.&lt;|&gt;method' apply 'methodA2' --&gt; a.methodA2();
+a.methodTypo();</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Multiline expectations describe changes to the whole. In order to match the expectation context information around the relevant places must be given. The format is similar to a unified diff with a special rule for inline-changes. The comparison works in a line-based mode. Each line in the expectation is prefixed with one character of ’+’, ’|’, ’-’ or ’ ’. Inserted lines are marked with + and removed lines with -. Lines marked with | denote changes in the line. Difference is placed inline inside of a pair of square brackets with a | separating the removal on the left and the addition on the right.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>/* XPECT contentAssistList at 'a.me&lt;|&gt;thodA' apply 'methodA2' ---
+&lt;...&gt;
+import A from "a/b/c"
+&lt;...&gt;
+a.methodA2()&lt;|&gt;methodA
+&lt;...&gt;
+--- */
+a.methodA</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>/* XPECT contentAssistList at 'a.me&lt;|&gt;thodA' apply 'methodA2' ---
+ import B from "p/b"
++import A from "a/b/c"
+
+ ...
+ foo() {
+|a.[me|thodA2()]
+ }
+ ...
+--- */
+a.methodA</code></pre>
+</div>
+</div>
+<div class="sect4">
+<h5 id="resource-application-in-other-files"><a class="anchor" href="#resource-application-in-other-files"></a><a class="link" href="#resource-application-in-other-files">14.7.5.1. resource – application in other files</a></h5>
+<div class="paragraph">
+<p>The resource parameter is available for the quickfix xpect method. It specifies the target resource of the quickfix. (e.g. change declaration of type in another file to quickfix an issue).</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>/* XPECT quickFix at 'sameVendor.protected&lt;|&gt;Method()' apply 'Declare member as public, @Internal' resource='../../otherProject/src/other_file.n4js' ---
+diff here
+---
+*/</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>The syntax is similar to a normal multiline quickfix xpect test besides the addition of the resource parameter. The relative path points to a file in the same workspace as the test file. Note that the path refers to the folder structure specified in the XPECT SETUP header. It is relative to the folder the test file is contained in.<br>
+<br>
+The diff is between the specified resource before and after the application of the quickfix<br>
+<br>
+Note that the fileValid (<a href="#fileValidVerify-validation-status">Verify Validation Status</a>) parameter is not applicable to an extern resource.</p>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Content_Assist_Cycling"><a class="anchor" href="#sec:Content_Assist_Cycling"></a><a class="link" href="#sec:Content_Assist_Cycling">14.7.6. kind – Content Assist Cycling</a></h4>
+<div class="paragraph">
+<p>We assume the default kind to be ’n4js’. It is possible to select a proposal kind in the test set up or via the argument <code>kind</code> in the test.</p>
+</div>
+<div class="paragraph">
+<p>Select kind in test setup:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>/* XPECT_SETUP
+content_assist_kind = 'recommenders'
+END_SETUP */</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Select kind in test:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>// XPECT contentAssistList kind 'smart' at 'a.&lt;|&gt;methodA' display 'methodA2' --&gt; 'methodA2(): any - A'
+a.methodA</code></pre>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="fileValidVerify-validation-status"><a class="anchor" href="#fileValidVerify-validation-status"></a><a class="link" href="#fileValidVerify-validation-status">14.7.7. fileValid – Verify validation status</a></h4>
+<div class="paragraph">
+<p>In some cases, in particular in case of quick fix tests, the file should be valid after the proposal has been applied. This is added by an additional argument <code>fileValid</code>.</p>
+</div>
+<div class="paragraph">
+<p>E.g.,</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>// XPECT quickFix at 'a.&lt;|&gt;method' apply 'methodA2' fileValid --&gt; a.&lt;|&gt;methodA2();
+a.methodTypo();</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:Apply_Proposal_And_Execute_Tests"><a class="anchor" href="#sec:Apply_Proposal_And_Execute_Tests"></a><a class="link" href="#sec:Apply_Proposal_And_Execute_Tests">14.8. Apply Proposal And Execute Tests</a></h3>
+<div class="paragraph">
+<p>If a proposal fixes all issues in a test file, the file could be executed. This is an important type of test, as this is what the user expects in the end. Besides, this type of test is very robust, as it does not depend on the concrete way how an issue is fixed. For quick fixes, these kind of tests are to be implemented!</p>
+</div>
+<div class="paragraph">
+<p>The following combined proposal and execute tests are provided:</p>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+quickFixAndRun
+</td>
+<td class="hdlist2">
+<p>applies a quick fix, verifies that all issues are solved, and executes the file.</p>
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>These tests are basically execution tests, that is the expectation describes the expected output of the script.</p>
+</div>
+<div class="paragraph">
+<p>E.g.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>// XPECT quickFixAndRun at 'a.&lt;|&gt;method' apply 'methodHelloWorld' --&gt; Hello World
+a.methodTypo();</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>with <code>methodHelloWorld</code> printing <code>’Hello World’</code> to the console. The expected output can be multiline:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>/* XPECT quickFixAndRun at 'a.&lt;|&gt;method' apply 'methodHelloWorld' ---
+Hello World
+--- */
+a.methodTypo();</code></pre>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:Organize_Imports_Test"><a class="anchor" href="#sec:Organize_Imports_Test"></a><a class="link" href="#sec:Organize_Imports_Test">14.9. Organize Imports Test</a></h3>
+<div class="paragraph">
+<p>For testing organise imports a Plugin-UI test method is available. It operates in two modes. Either a successful application of organise imports is tested or the expected abortion is checked.</p>
+</div>
+<div class="sect3">
+<h4 id="organizeimports"><a class="anchor" href="#organizeimports"></a><a class="link" href="#organizeimports">14.9.1. organizeImports</a></h4>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Definition
+</td>
+<td class="hdlist2">
+<p>Multi line:</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>/* XPECT organizeImports ---
+~Failure given by line-syntax starting with two characters:~
++ additional line
+| line with inplace[removed part|added part]
++ removed line
+  unchanged line
+--- */
+// XPECT warnings --&gt; "The import of A is unused." at "A"
+import A from "a/a1/A"
+...
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Single line:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>// XPECT organizeImports ambiguous '~Failure String of Exception~'--&gt;
+}</code></pre>
+</div>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Provided by
+</td>
+<td class="hdlist2">
+<p><code>OrganizeImportXpectMethod</code></p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Description
+</td>
+<td class="hdlist2">
+<p>Checks that the resulting source-file differs in the described way. The Multiline variant checks the result of a successful application of organise import to the file. All errors and warnings prior to organising imports must be marked as the appropriate XPECT-error or warning.</p>
+<div class="paragraph">
+<p>The single-line notation checks the failure of an fully automatic reorganisation of the imports due to some reason. The reason is verified to be the given string after the <code>ambiguous</code> keyword. The expectation side (right of <code>-&#8594;</code>) is empty.</p>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Example
+</td>
+<td class="hdlist2">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>/* XPECT_SETUP org.eclipse.n4js.tests.N4JSXpectPluginUITest
+   Workspace {
+     Project "P1" {
+        Folder "src" {
+            Folder "a" {  Folder "a1" { File "A.n4js" { from="../../a/a1/A.n4js" } }
+                            Folder "c"  { ThisFile {} }  }  }
+        File "package.json" { from="package_p1.json" }  }  }
+   END_SETUP
+*/
+
+/* XPECT organizeImports ---
+
+ | import [A from "a/a1/A"|]
+ | [import|] AR from "a/a1/A"
+   export public role BRole with AR {
+   }
+--- */
+// XPECT warnings --&gt; "The import of A is unused." at "A"
+import A from "a/a1/A"
+import AR from "a/a1/A"
+
+// XPECT noerrors --&gt; "Couldn't resolve reference to Type 'AR'."
+export public role BRole with AR {
+}</code></pre>
+</div>
+</div>
+</td>
+</tr>
+</table>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:Access_Control_Test"><a class="anchor" href="#sec:Access_Control_Test"></a><a class="link" href="#sec:Access_Control_Test">14.10. Access Control Test</a></h3>
+<div class="paragraph">
+<p>Access control refers to the decision whether or not a member or a top level element is accessible for a client. In this context, access refers to reading, writing, and calling a member or a top level function, and to overriding inherited members in classes and interfaces. In N4JS, access is controlled via modifiers at the type and at the member level. Due to the large number of such modifiers and the large number of different scenarios for access control, manually written tests can only cover a small number of actual scenarios. An automatic test generator helps to increase the test coverage for access control.</p>
+</div>
+<div class="paragraph">
+<p>The test generator loads test scenarios from a CSV table that also contains the expected results of each test case and then generates N4JS projects and code for each test case, compiles them using the headless compiler, and compares the compilation results to the expectations from the CSV table. Note that the test generator does not generate test cases that check access control for top level functions and variables.</p>
+</div>
+<div class="sect3">
+<h4 id="test-scenarios"><a class="anchor" href="#test-scenarios"></a><a class="link" href="#test-scenarios">14.10.1. Test Scenarios</a></h4>
+<div class="paragraph">
+<p>Each test scenario consists of a scenario specifier (one of <code>Extends</code>  , <code>Implements</code>  , <code>References</code>  ), a supplier and a client (each of which can be a class, and abstract class, an interface, or an interface with default implementations of its getters, setters, and methods). Thereby, the client attempts to access a member of the supplier either by reading, writing, or calling it or by overriding it in the case of an <code>Extends</code>   or <code>Implements</code>   scenario. Furthermore, each test cases specifies the location of the client in relation to the location of the supplier, e.g., whether the client is in the same module, or whether it is in the same project (but not the same module), and so forth. Finally, a test case must specify the access control modifiers of the supplier type and the member that is being accessed by the client, whether that member is static or not, and, lastly, the type of access that is being attempted.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="n4js-code-generator"><a class="anchor" href="#n4js-code-generator"></a><a class="link" href="#n4js-code-generator">14.10.2. N4JS Code Generator</a></h4>
+<div class="paragraph">
+<p>The test generator needs to generate N4JS projects and modules that implement a particular test case. For this purpose, it uses a simple code generator, available in the package <code>org.eclipse.n4js.tests.codegen</code>. The classes in that package allow specifying N4JS projects, modules, classes, and members in Java code and to generate the required artifacts as files at a given location.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="xtext-issue-matcher"><a class="anchor" href="#xtext-issue-matcher"></a><a class="link" href="#xtext-issue-matcher">14.10.3. Xtext Issue Matcher</a></h4>
+<div class="paragraph">
+<p>To match the test expectations from the CSV file against the issues generated by the compiler, the test generator uses a small library of issue matchers, available in the package <code>org.eclipse.n4js.tests.issues</code>. The classes in that package make it easy to specify expectations against Xtext issues programmatically and to evaluate these expectations against a specific set of Xtext issues. Mismatches, that is, unexpected issues as well as unmatched expectations, are explained textually. These explanations are then shown in the failure notifications of the test case generator.</p>
+</div>
+<div class="paragraph">
+<p>The test expectations allow for FIXME annotations in the CSV table to express cases where an access control error has been found, but hasn’t been fixed yet. Such expectations lead to inverted expectations against the generated issues: For example, if a test expects an attempted access to fail with an error, but the validation rules allow the access regardless, then a FIXME annotation at the test will invert the actual expectation: Where previously an error was expected, there must now be no error at all. Then, once the validation rules have been adjusted and the error occurs as expected, the FIXME test case will fail until the FIXME annotation has been removed. Therefore, the issue expectation matchers can be inverted and adjust their behavior accordingly.</p>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:Smoke_Tests"><a class="anchor" href="#sec:Smoke_Tests"></a><a class="link" href="#sec:Smoke_Tests">14.11. Smoke Tests</a></h3>
+<div class="paragraph">
+<p>Smoke tests are useful to ensure the robustness of the IDE. They aim at revealing potential exceptions that may surface to the end user in the IDE or in a headless compile run. Therefore, different permutations of a given input document are fed into processing components such as the validator or the type system. No exceptions may be thrown from these components.</p>
+</div>
+<div class="paragraph">
+<p>Since smoke tests are longrunning, it is not desired to execute them with each Maven run. That’s why the naming convention <code>*  Smoketest</code> was choosen. It will not be matched by the naming pattern for normal JUnit tests during a maven run.</p>
+</div>
+<div class="paragraph">
+<p>The smoke tests are generally created by using the (valid or invalid) input of existing test cases. Therefore, the a command line argument <code>-DSmokeTestWriter=true</code> may be passed to the VM that executes a test. All input documents that are processed by a <code>ParseHelper&lt;Script&gt;</code> will be written to a new test method on the console. The result can be merged manually into the <code>GeneraredSmoketest</code>.</p>
+</div>
+<div class="sect3">
+<h4 id="how-to-handle-smoke-test-errors"><a class="anchor" href="#how-to-handle-smoke-test-errors"></a><a class="link" href="#how-to-handle-smoke-test-errors">14.11.1. How to handle smoke test errors?</a></h4>
+<div class="paragraph">
+<p>If a smoke test fails, the concrete input should be extracted into a dedicated error test case. The existing classes like <code>scoping.ErrorTest</code> should be used to add the broken input document and create fast running cases for them. For that purpose, the <code>ExceptionAnalyzer</code> can be used. Such a test case will usually look like this:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>@Test
+def void testNoNPE_03() {
+    val script = ``  '
+        var target = {
+            s: "hello",
+            set x
+    ``  '.parse
+    analyser.analyse(script, "script", "script")
+}</code></pre>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="smoketester-and-exceptionanalyzer"><a class="anchor" href="#smoketester-and-exceptionanalyzer"></a><a class="link" href="#smoketester-and-exceptionanalyzer">14.11.2. SmokeTester and ExceptionAnalyzer</a></h4>
+<div class="paragraph">
+<p>The components that are used to implemement the smoke tests are the <code>SmokeTester</code> and the <code>ExceptionAnalyzer</code>. The smoke tester performs the permutation of the characters from the input model whereas the analyzer does the heavy lifting of passing the parsed model to various components such as the type system or the validation. Both utilities can be used to add either new smoke test documents or to check for the robustness of an implementation. It’s espeically useful to use the ExceptionAnalyzer in conjunction with existing test suites like the <code>LibraryParsingTestSuite</code> since it can be used instead of the other utilities like the <code>PositiveAnalyzer</code> or the <code>NegativeAnalyzer</code>.</p>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:UI_Tests_with_SWTBot"><a class="anchor" href="#sec:UI_Tests_with_SWTBot"></a><a class="link" href="#sec:UI_Tests_with_SWTBot">14.12. UI Tests with SWTBot</a></h3>
+<div class="paragraph">
+<p>For testing functionality from the end-user perspective we use UI tests based on SWTBot <a href="http://eclipse.org/swtbot/" class="bare">http://eclipse.org/swtbot/</a>.</p>
+</div>
+<div class="paragraph">
+<p>Since UI tests are usually rather fragile, it was decided to keep the number of these tests as low as possible. The main purpose of these tests is to ensure that the most fundamental IDE functionality is working properly, e.g. creating an N4JS project, creating a new N4JS file, running N4JS code in node.js.</p>
+</div>
+<div class="paragraph">
+<p>The tests have a number of SWTBot dependencies. For details, please refer to the latest target platform definition file.</p>
+</div>
+<div class="sect3">
+<h4 id="writing-swtbot-tests"><a class="anchor" href="#writing-swtbot-tests"></a><a class="link" href="#writing-swtbot-tests">14.12.1. Writing SWTBot Tests</a></h4>
+<div class="paragraph">
+<p>The implementation is contained in bundle <code>org.eclipse.swtbot.tests</code>. Writing SWTBot tests is straightforward; see source code of <code>AbstractSwtBotTest</code> for usage and examples.</p>
+</div>
+<div class="paragraph">
+<p>Some hints:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Many methods of the SWTBot framework already include assertions. For example, the method <code>#  menu(String)</code> to find a particular menu or menu item will assert that the item was found and otherwise throw an exception. Therefore, it is safe to write code like:</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>bot.menu("File").menu("New").menu("Project...").click();</code></pre>
+</div>
+</div>
+</li>
+<li>
+<p>It is usually considered bad practice to use sleep delays in UI tests. Instead, wait for the element to appear using methods such as <a href="http://download.eclipse.org/technology/swtbot/helios/dev-build/apidocs/org/eclipse/swtbot/swt/finder/SWTBot.html#waitUntil" class="bare">http://download.eclipse.org/technology/swtbot/helios/dev-build/apidocs/org/eclipse/swtbot/swt/finder/SWTBot.html#waitUntil</a> or <a href="http://download.eclipse.org/technology/swtbot/helios/dev-build/apidocs/org/eclipse/swtbot/swt/finder/SWTBot.html#waitWhile" class="bare">http://download.eclipse.org/technology/swtbot/helios/dev-build/apidocs/org/eclipse/swtbot/swt/finder/SWTBot.html#waitWhile</a>.</p>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect3">
+<h4 id="running-swtbot-tests"><a class="anchor" href="#running-swtbot-tests"></a><a class="link" href="#running-swtbot-tests">14.12.2. Running SWTBot Tests</a></h4>
+<div class="paragraph">
+<p>To run the tests locally in Eclipse just right-click the bundle and select <code>Run As &gt; SWTBot Test</code>  . To run them locally via maven simply start a normal maven build, no additional command line arguments, etc. required.</p>
+</div>
+<div class="paragraph">
+<p>To run remotely in a Jenkins build: on Windows the build must be executed with a logged-in user; on Linux Xvfb and a window manager are required. The recommended window manager is metacity. More information can be found here: <a href="http://wiki.eclipse.org/SWTBot/Automate_test_execution" class="bare">http://wiki.eclipse.org/SWTBot/Automate_test_execution</a>.</p>
+</div>
+<div class="paragraph">
+<p>To use metacity, add the following pre-build shell command to the Jenkins build configuration:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-bash" data-lang="bash">sleep 5; metacity --replace --sm-disable &amp;</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>The sleep is required because metacity depends on Xvfb to be fully initialized, which might take a moment on slower build nodes. The following Jenkins console log shows the expected output when starting Xvfb and metacitiy:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-bash" data-lang="bash">Xvfb starting$ Xvfb :1 -screen 0 1024x768x24 -fbdir /var/lib/build/2014-09-05_10-36-343337290231975947044xvfb
+[N4JS-IDE_Oliver] $ /bin/sh -xe /tmp/hudson4475531813520593700.sh
++ sleep 5
++ metacity --replace --sm-disable
+Xlib:  extension "RANDR" missing on display ":1.0".
+Window manager warning: 0 stored in GConf key /desktop/gnome/peripherals/mouse/cursor_size is out of range 1 to 128
+Process leaked file descriptors. See http://wiki.jenkins-ci.org/display/JENKINS/Spawning+processes+from+build for more information
+Parsing POMs
+...</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>The warnings and error messages in the above log are expected and are considered unharmful (cf. discussion with Jörg Baldzer).</p>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="sec:Debugging_UI_Tests"><a class="anchor" href="#sec:Debugging_UI_Tests"></a><a class="link" href="#sec:Debugging_UI_Tests">14.13. Debugging UI Tests</a></h3>
+<div class="paragraph">
+<p>In rare cases UI Tests behave differently depending on the underlying OS und the power of the test machine. Missing user interaction on the build-server often results in waiting processes which in turn get a timeout request from the driving unit-testing-framework. To investigate the UI state on the build node a X11 connection needs to established.</p>
+</div>
+<div class="sect3">
+<h4 id="sec:Connecting_to_the_X_server_on_the_build_node"><a class="anchor" href="#sec:Connecting_to_the_X_server_on_the_build_node"></a><a class="link" href="#sec:Connecting_to_the_X_server_on_the_build_node">14.13.1. Connecting to the X-server on the build-node</a></h4>
+<div class="paragraph">
+<p>First a vnc server needs to be started on the build-node. This is done via <code>x11vnc -display :1 -shared &gt;  /x11vnc.log 2&gt;&amp;1 &amp;</code> as a pre-build shellscript-step in Jenkins.</p>
+</div>
+<div class="paragraph">
+<p>You can narrow down the build to run on a specific node in Jenkins if a repeatable environment is required otherwise the current build-node is listed in the overview page. For security reasons the connection needs to be tunneld through an ssh login:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-bash" data-lang="bash">ssh -l viewer -L 5900:localhost:5900 build-linux-25 ’x11vnc -localhost -display :1</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Here we are using the mating <code>build-linux-25</code> with the generic user/password ’viewer’ to start the program <code>x11vnc</code>. For the actual display number – <code>:1</code> in this case – you can refer to the console output. The command above tunnels the default vnc port 5900. You can now connect on <code>localhost</code> with a vnc client. If the user is not available, the <code>x11vnc</code> program not installed or in case of other issues, ask the build-and-release team.</p>
+</div>
+<div class="paragraph">
+<p>To display the screen you can use any arbitrary vnc-client (on mac there is screen sharing, in theory just opened from the command line by hitting <code>open vnc://viewer:viewer@localhost:5900</code>). One working client is ’chicken of the vnc’ <a href="http://sourceforge.net/projects/cotvnc/" class="bare">http://sourceforge.net/projects/cotvnc/</a></p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Tools_to_investigate_the_java_stack"><a class="anchor" href="#sec:Tools_to_investigate_the_java_stack"></a><a class="link" href="#sec:Tools_to_investigate_the_java_stack">14.13.2. Tools to investigate the java-stack</a></h4>
+<div class="paragraph">
+<p>Unix and Java come with some useful programs for investigations. The following tools may need some advanced rights to see processes from other users.</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>htop</code> enhanced top to see all currently running processes</p>
+</li>
+<li>
+<p><code>jps</code> list running java processes</p>
+</li>
+<li>
+<p><code>jstack</code> investigate running java process</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div id="footer">
+<div id="footer-text">
+Version 0.9<br>
+Last updated 2019-08-07 15:02:40 CEST
+</div>
+</div>
+<!-- ************* docinfo-footer *************************************************************** -->
+<div class="Grid social" style="color:#d5dfea">
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <h2>Quick Links</h2>
+    <ul>
+      <li><a href="../downloads.html">Download</a></li>
+      <li><a href="../userguides/index.html">Documentation</a></li>
+      <li><a href="https://github.com/eclipse/n4js/">Source</a></li>
+      <li><a href="https://github.com/eclipse/n4js/issues">Issues</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="https://www.eclipse.org/forums/index.php/f/365/">Forum</a></li>
+      <li><a href="http://n4js.blogspot.de/">Blog</a></li>
+      <li><a href="https://dev.eclipse.org/mailman/listinfo/n4js-dev">Mailing List</a></li>
+      <li><a href="https://projects.eclipse.org/projects/technology.n4js">Eclipse Project Page</a></li>
+      <li><a href="https://twitter.com/n4jsdev">Tweets by n4jsdev</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="http://www.eclipse.org/">Eclipse Home</a></li>
+      <li><a href="http://www.eclipse.org/legal/privacy.php">Privacy Policy</a></li>
+      <li><a href="http://www.eclipse.org/legal/termsofuse.php">Terms of Use</a></li>
+      <li><a href="http://www.eclipse.org/legal/copyright.php">Copyright Agent</a></li>
+      <li><a href="http://www.eclipse.org/legal/">Legal</a></li>
+    </ul>
+  </div>
+  <div style="clear: both; height: 0; overflow: hidden;"></div>
+</div>
+
+<!-- ************* UI Scripts ************* -->
+<script type="text/javascript" src="scripts/back-to-top.js"></script>
+
+<script type="text/javascript" src="scripts/treeview.js"></script>
+<script type="text/javascript" src="scripts/toc.js"></script>
+
+<!-- ************* Prism.js Syntax Highlighting ************* -->
+<script src="scripts/prism.js"></script>
+
+<script type="text/javascript">
+	// Add the 'toclist' id for search function
+	$(".toc2 > ul").attr('id', 'toclist');
+	// Generate a Search input form
+	$("#toclist > li:first-of-type").before('<input type="text" id="pagesearch" onkeyup="search()" placeholder="Search for section...">');
+	$("#toclist > li:first-of-type").before('<i id="clear" class="fa fa-times-circle-o"></i>');
+	$("#clear").click(function(){
+	    $("#pagesearch").val('');
+	    search();
+	    $('.toc2 > ul').treeView('collapseAll');
+	});
+	// intialize Treeview.js
+	$(".toc2 > ul").treeView();
+	// Initialize Scrollspy
+</script>
+<!-- ************* docinfo-footer *************************************************************** -->
+</body>
+</html>
\ No newline at end of file
diff --git a/design/tips_and_tricks.html b/design/tips_and_tricks.html
new file mode 100644
index 0000000..bf408d1
--- /dev/null
+++ b/design/tips_and_tricks.html
@@ -0,0 +1,1149 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="generator" content="Asciidoctor 1.5.5">
+<meta name="author" content="2019-08-07 15:02:40 CEST">
+<title>N4JS Design Specification</title>
+<link rel="stylesheet" href="styles/spec.min.css">
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.6.3/css/font-awesome.min.css">
+<!-- ************* docinfo ******************************************************************* -->
+
+
+<!-- ************* Favicon ************-->
+<link rel="icon" href="images/favicon.ico" />
+
+<!-- ************* Back-to-top JQuery ************* -->
+<script src="https://code.jquery.com/jquery-1.12.4.js"></script>
+<script src="https://code.jquery.com/ui/1.12.0/jquery-ui.js"></script>
+
+
+<link href="styles/prism.min.css" rel="stylesheet" />
+<script type="text/javascript" async
+  src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2/MathJax.js?config=TeX-MML-AM_CHTML">
+</script>
+
+<!-- ************* Styles ************* -->
+<link rel="stylesheet" type="text/css" href="styles/n4jsspec-adoc.css">
+
+
+<!-- ****************** NavBar ****************** -->
+<div id="menubar">
+	<div class="banner">
+        <a href="https://www.eclipse.org/n4js/#"><img id="logo" src="images/n4js-logo.png" alt="Eclipse N4JS"></a>
+    </div>
+<ul>
+  <li><a href="index.html">Index</a></li>
+</ul>
+</div>
+<!-- ************* docinfo ******************************************************************* -->
+<style>
+      .admonitionblock td.icon .icon-todo:before{content:"\f249";color:#f4ee42}
+    </style>
+</head>
+<body class="book toc2 toc-left">
+<div id="header">
+<h1>N4JS Design Specification</h1>
+<div class="details">
+<span id="author" class="author">2019-08-07 15:02:40 CEST</span><br>
+<span id="revnumber">version 0.9</span>
+</div>
+<div id="toc" class="toc2">
+<div id="toctitle">Table of Contents</div>
+<ul class="sectlevel1">
+<li><a href="introduction.html#_introduction">1. Introduction</a>
+<ul class="sectlevel2">
+<li><a href="introduction.html#notation">1.1. Notation</a></li>
+<li><a href="introduction.html#sec:IDE_Overview">1.2. IDE Components</a>
+<ul class="sectlevel3">
+<li><a href="introduction.html#sec:Naming_Conventions">1.2.1. Naming Conventions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="eclipse_setup.html#_eclipse-setup">2. Eclipse Setup</a>
+<ul class="sectlevel2">
+<li><a href="eclipse_setup.html#_system-requirements">2.1. System Requirements</a></li>
+<li><a href="eclipse_setup.html#_contribute">2.2. Contribute</a>
+<ul class="sectlevel3">
+<li><a href="eclipse_setup.html#_eclipse-installer">2.2.1. Eclipse Installer</a>
+<ul class="sectlevel4">
+<li><a href="eclipse_setup.html#_changing-the-setup-script">2.2.1.1. Changing the Setup Script</a></li>
+</ul>
+</li>
+<li><a href="eclipse_setup.html#_manual-ide-configuration">2.2.2. Manual IDE Configuration</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="release_engineering.html#_release-engineering">3. Release Engineering</a>
+<ul class="sectlevel2">
+<li><a href="release_engineering.html#_nightly-build-on-eclipse-infrastructure">3.1. Nightly build on Eclipse infrastructure</a></li>
+<li><a href="release_engineering.html#_build-the-n4js-ide-from-command-line">3.2. Build the N4JS IDE from command line</a>
+<ul class="sectlevel3">
+<li><a href="release_engineering.html#_publish-maven-tooling-code-org-eclipse-n4js-releng-util-code">3.2.1. Publish maven-tooling <code>org.eclipse.n4js.releng.util</code></a></li>
+<li><a href="release_engineering.html#sec:test-verdaccio">3.2.2. Test Verdaccio containing n4js-libs</a></li>
+<li><a href="release_engineering.html#_generation-of-eclipse-help-for-spec-and-design-document">3.2.3. Generation of Eclipse help for spec and design document</a></li>
+</ul>
+</li>
+<li><a href="release_engineering.html#_updating-frameworks-and-dependencies">3.3. Updating frameworks and dependencies</a>
+<ul class="sectlevel3">
+<li><a href="release_engineering.html#_update-of-eclipse-emf-xtext-etc">3.3.1. Update of Eclipse, EMF, Xtext, etc.</a></li>
+<li><a href="release_engineering.html#_update-of-the-embedded-jre">3.3.2. Update of the embedded JRE</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#_tips-and-tricks">4. Tips and Tricks</a>
+<ul class="sectlevel2">
+<li><a href="#_naming">4.1. Naming</a></li>
+<li><a href="#_logging">4.2. Logging</a></li>
+<li><a href="#_cancellation-handling">4.3. Cancellation Handling</a></li>
+<li><a href="#_caching">4.4. Caching</a></li>
+<li><a href="#_dependency-injection">4.5. Dependency Injection</a></li>
+<li><a href="#_miscellaneous">4.6. Miscellaneous</a></li>
+</ul>
+</li>
+<li><a href="parser.html#_parser">5. Parser</a>
+<ul class="sectlevel2">
+<li><a href="parser.html#sec:Parser_Overview">5.1. Overview</a></li>
+<li><a href="parser.html#sec:N4JS_Parser">5.2. N4JS Parser</a></li>
+<li><a href="parser.html#sec:Parser_Generation_Post_Processing">5.3. Parser Generation Post-Processing</a>
+<ul class="sectlevel3">
+<li><a href="parser.html#sec:Automatic_Semicolon_Insertion">5.3.1. Automatic Semicolon Insertion</a>
+<ul class="sectlevel4">
+<li><a href="parser.html#sec:Injected_code_in_the_Antlr_grammar_file">5.3.1.1. Injected code in the Antlr grammar file</a></li>
+<li><a href="parser.html#sec:Customized_error_recovery">5.3.1.2. Customized error recovery</a></li>
+</ul>
+</li>
+<li><a href="parser.html#sec:_No_line_terminator_allowed_here__handling">5.3.2. Async and <code>No line terminator allowed here</code> Handling</a></li>
+<li><a href="parser.html#sec:Regular_Expression">5.3.3. Regular Expression</a></li>
+<li><a href="parser.html#sec:Unicode">5.3.4. Unicode</a></li>
+<li><a href="parser.html#sec:Literals">5.3.5. Literals</a></li>
+</ul>
+</li>
+<li><a href="parser.html#sec:Modifiers">5.4. Modifiers</a></li>
+<li><a href="parser.html#sec:Conflict_Resolutions">5.5. Conflict Resolutions</a>
+<ul class="sectlevel3">
+<li><a href="parser.html#sec:Reserved_Keywords_vs__Identifier_Names">5.5.1. Reserved Keywords vs. Identifier Names</a></li>
+<li><a href="parser.html#sec:Operators_and_Generics">5.5.2. Operators and Generics</a></li>
+</ul>
+</li>
+<li><a href="parser.html#sec:Content_Assist_Parser">5.6. Content-Assist Parser</a></li>
+</ul>
+</li>
+<li><a href="type_system.html#_type-system">6. Type System</a>
+<ul class="sectlevel2">
+<li><a href="type_system.html#sec:Type_Model_and_Grammar">6.1. Type Model and Grammar</a>
+<ul class="sectlevel3">
+<li><a href="type_system.html#sec:Type_Model_Overview">6.1.1. Type Model Overview</a></li>
+<li><a href="type_system.html#sec:Built_in_Types">6.1.2. Built-in and Primitive Types</a></li>
+<li><a href="type_system.html#sec:Type_Model_DSL">6.1.3. Type Model DSL</a></li>
+</ul>
+</li>
+<li><a href="type_system.html#sec:Type_System_Implementation">6.2. Type System Implementation</a></li>
+<li><a href="type_system.html#sec:Type_Inference_combined_with_AST_Traversal">6.3. Type Inference of AST</a>
+<ul class="sectlevel3">
+<li><a href="type_system.html#sec:Type_Inference_combined_with_AST_Traversal__Background">6.3.1. Background</a></li>
+<li><a href="type_system.html#sec:Triggering_Type_Inference_of_AST">6.3.2. Triggering</a></li>
+<li><a href="type_system.html#sec:Traversal_Order_During_Type_Inference_of_AST">6.3.3. Traversal Order</a></li>
+<li><a href="type_system.html#sec:Cross_References_During_Type_Inference_of_AST">6.3.4. Cross-References</a></li>
+<li><a href="type_system.html#sec:Function_Accessor_Bodies_During_Type_Inference_of_AST">6.3.5. Function/Accessor Bodies</a></li>
+<li><a href="type_system.html#sec:Poly_Expressions_During_Type_Inference_of_AST">6.3.6. Poly Expressions</a></li>
+<li><a href="type_system.html#sec:Constraint_Solver_used_During_Type_Inference_of_AST">6.3.7. Constraint Solver</a></li>
+<li><a href="type_system.html#sec:Type_Guards_During_Type_Inference_of_AST">6.3.8. Type Guards</a></li>
+</ul>
+</li>
+<li><a href="type_system.html#sec:Structural_Typing">6.4. Structural Typing</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#_type-index">7. Type Index</a>
+<ul class="sectlevel2">
+<li><a href="type_index.html#sec:Type_Index_Design_Rationale">7.1. Design Rationale</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#sec:Getting_the_Xtext_Index_Content_IResourceDescriptions">7.1.1. Getting the Xtext Index (<code>IResourceDescriptions</code>) Content</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#sec:Design_Overview">7.2. Design Overview</a></li>
+<li><a href="type_index.html#sec:N4JS_Resource_Load_States">7.3. N4JS Resource Load States</a></li>
+<li><a href="type_index.html#sec:Type_Builder">7.4. Types Builder</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#sec:Type_Inference_not_allowed_in_Type_Builder">7.4.1. Type Inference not allowed in Types Builder</a></li>
+<li><a href="type_index.html#sec:ComputedTypeReferences">7.4.2. Deferred Type References</a></li>
+<li><a href="type_index.html#sec:Use_cases_of_ComputedTypeRef">7.4.3. Use cases of DeferredTypeRef</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#sec:Incremental_Builder_Overview">7.5. Incremental Builder (Overview)</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#sec:Incremental_Builder_Overview__XtextBuilder">7.5.1. XtextBuilder</a></li>
+<li><a href="type_index.html#sec:Incremental_Builder_Overview__IBuilderState">7.5.2. IBuilderState</a>
+<ul class="sectlevel4">
+<li><a href="type_index.html#copy-and-update-xtext-index">7.5.2.1. Copy and Update Xtext Index</a></li>
+<li><a href="type_index.html#build-state-setup-phase">7.5.2.2. Build State Setup Phase</a></li>
+<li><a href="type_index.html#process-queued-uris">7.5.2.3. Process Queued URIs</a></li>
+<li><a href="type_index.html#queueing-affected-resources">7.5.2.4. Queueing Affected Resources</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#sec:Incremental_Builder_Overview__Example">7.5.3. Example</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#dirty-state-handling">7.6. Dirty state handling</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#use-case-restoring-types-from-user-data">7.6.1. Use case: Restoring types from user data</a></li>
+<li><a href="type_index.html#use-case-updating-the-xtext-index">7.6.2. Use case: Updating the Xtext index</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="project_model.html#_project-model">8. Project Model</a>
+<ul class="sectlevel2">
+<li><a href="project_model.html#sec:Package_json">8.1. Package.json File</a></li>
+<li><a href="project_model.html#_accessing-project-information">8.2. Accessing Project Information</a>
+<ul class="sectlevel3">
+<li><a href="project_model.html#sec:IN4JSCore">8.2.1. IN4JSCore</a></li>
+<li><a href="project_model.html#sec:N4JSModel">8.2.2. N4JSModel</a></li>
+<li><a href="project_model.html#sec:N4JSWorkspace">8.2.3. N4JSWorkspace</a></li>
+<li><a href="project_model.html#sec:N4JSProject">8.2.4. N4JSProject</a></li>
+<li><a href="project_model.html#sec:SourceContainer">8.2.5. SourceContainer</a></li>
+<li><a href="project_model.html#sec:N4JSProjectsStateHelper">8.2.6. N4JSProjectsStateHelper</a></li>
+</ul>
+</li>
+<li><a href="project_model.html#sec:Caching">8.3. Caching</a>
+<ul class="sectlevel3">
+<li><a href="project_model.html#_caching-of-externallibraryworkspace">8.3.1. Caching of ExternalLibraryWorkspace</a></li>
+<li><a href="project_model.html#_caching-of-n4jsprojectsstatehelper">8.3.2. Caching of N4JSProjectsStateHelper</a></li>
+</ul>
+</li>
+<li><a href="project_model.html#sec:WildcardPathFilter">8.4. WildcardPathFilter</a></li>
+<li><a href="project_model.html#sec:ProjectUtils">8.5. ProjectUtils</a></li>
+</ul>
+</li>
+<li><a href="binding.html#_binding">9. Binding</a>
+<ul class="sectlevel2">
+<li><a href="binding.html#sec:Binding_Design_Rationale">9.1. Design Rationale</a></li>
+<li><a href="binding.html#sec:Binding_to_Members">9.2. Binding to Members</a></li>
+<li><a href="binding.html#sec:Binding_Getter_Setter">9.3. Getter / Setter Binding</a></li>
+<li><a href="binding.html#chap:Statics">9.4. Static Member Binding</a></li>
+<li><a href="binding.html#sec:Binding_Enumeration">9.5. Enumeration Literals Binding</a></li>
+<li><a href="binding.html#sec:Accessibility_of_types_and_members">9.6. Accessibility of types and members</a></li>
+<li><a href="binding.html#sec:Member_Scope_Example">9.7. Member Scope Example</a></li>
+<li><a href="binding.html#sec:Scoping_for_Members_of_Composed_Type_Explained">9.8. Scoping for Members of Composed Type (Union/Intersection) Example</a></li>
+<li><a href="binding.html#sec:Binding_of_Structurally_References_Types">9.9. Structurally References Types</a></li>
+<li><a href="binding.html#sec:Building">9.10. Building</a>
+<ul class="sectlevel3">
+<li><a href="binding.html#sec:Build_Phases">9.10.1. Build Phases</a></li>
+<li><a href="binding.html#sec:Build_Scenarios">9.10.2. Build Scenarios</a></li>
+<li><a href="binding.html#sec:Lazy_linking_problem">9.10.3. Lazy linking problem</a></li>
+</ul>
+</li>
+<li><a href="binding.html#sec:Proxies_and_Proxy_Resolution">9.11. Proxies and Proxy Resolution (Overview)</a>
+<ul class="sectlevel3">
+<li><a href="binding.html#xtexts-lazy-linking-proxies">9.11.1. Xtext’s Lazy Linking Proxies</a></li>
+<li><a href="binding.html#standard-emf-proxies">9.11.2. Standard EMF Proxies</a></li>
+<li><a href="binding.html#_how-is-proxy-resolution-triggered">9.11.3. How is Proxy Resolution Triggered?</a></li>
+<li><a href="binding.html#_when-is-proxy-resolution-allowed">9.11.4. When is Proxy Resolution Allowed?</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="validation.html#_validation">10. Validation</a>
+<ul class="sectlevel2">
+<li><a href="validation.html#sec:validation_overview">10.1. Validation overview</a></li>
+<li><a href="validation.html#sec:validation_control_flow">10.2. Validation control flow</a></li>
+<li><a href="validation.html#sec:validation_issue_ids">10.3. Issue IDs and Messages</a></li>
+<li><a href="validation.html#sec:validation_usage_patterns">10.4. Usage Pattern</a></li>
+<li><a href="validation.html#sec:validation_links">10.5. Links</a></li>
+</ul>
+</li>
+<li><a href="references.html#_references">11. References</a>
+<ul class="sectlevel2">
+<li><a href="references.html#sec:usecases">11.1. Use cases</a></li>
+<li><a href="references.html#sec:calculation_algorithm">11.2. Calculation algorithm</a>
+<ul class="sectlevel3">
+<li><a href="references.html#sec:Xtext_default_implementation">11.2.1. Xtext default implementation</a></li>
+<li><a href="references.html#sec:N4_implementation">11.2.2. N4JS implementation</a></li>
+</ul>
+</li>
+<li><a href="references.html#sec:PerformanceOfDependencyCalculation">11.3. Performance Of Dependency Calculation</a></li>
+<li><a href="references.html#sec:kinds_of_references">11.4. Kinds of references</a>
+<ul class="sectlevel3">
+<li><a href="references.html#sec:Cross_References_to_be_ignored">11.4.1. Cross References to be ignored</a></li>
+<li><a href="references.html#sec:Cross_References_to_be_handled">11.4.2. Cross References to be handled</a></li>
+</ul>
+</li>
+<li><a href="references.html#sec:transitive_dependencies">11.5. Transitive dependencies</a></li>
+<li><a href="references.html#sec:find-references">11.6. Find references</a>
+<ul class="sectlevel3">
+<li><a href="references.html#_background">11.6.1. Background</a></li>
+<li><a href="references.html#_how-find-references-work">11.6.2. How Find References Work</a>
+<ul class="sectlevel4">
+<li><a href="references.html#_step-1-convert-cursor-position-to-declared-element">11.6.2.1. Step 1: Convert Cursor Position to Declared Element</a></li>
+<li><a href="references.html#_step-2-convert-declared-element-to-target-uris">11.6.2.2. Step 2: Convert Declared Element to Target URIs</a></li>
+<li><a href="references.html#_step-3-filter-potential-resources">11.6.2.3. Step 3: Filter Potential Resources</a></li>
+<li><a href="references.html#_step-4-search-references-in-resource">11.6.2.4. Step 4: Search References in Resource</a></li>
+<li><a href="references.html#_limitations-and-possible-enhancements">11.6.2.5. Limitations and Possible Enhancements</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="compilation.html#_compilation">12. Compilation</a>
+<ul class="sectlevel2">
+<li><a href="compilation.html#chap:compilation">12.1. Introduction</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:general_design_rationals">12.1.1. General design rationals</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:logging_and_error_reporting">12.1.1.1. Logging and error reporting</a></li>
+<li><a href="compilation.html#sec:progress_monitor">12.1.1.2. Progress monitor</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Xtext_Integration">12.1.2. Xtext Integration</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:xtext_default_behaviour">12.1.2.1. Xtext default behaviour</a></li>
+<li><a href="compilation.html#sec:n4js_requirements">12.1.2.2. N4JS requirements</a></li>
+<li><a href="compilation.html#sec:compiler_discovery_in_ui">12.1.2.3. Compiler discovery in UI</a></li>
+<li><a href="compilation.html#sec:compiler_discovery_in_headless">12.1.2.4. Compiler discovery in headless</a></li>
+<li><a href="compilation.html#sec:general_generator_implementation">12.1.2.5. General generator implementation</a></li>
+<li><a href="compilation.html#sec:general_generator_activation">12.1.2.6. General generator activation</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Overview_of_Input_Models">12.1.3. Overview of the Input Models</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Core_Generator">12.2. Generators</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:Compiler_Components">12.2.1. Generator Components</a></li>
+<li><a href="compilation.html#sec:Generator_architecture">12.2.2. Generator architecture</a></li>
+<li><a href="compilation.html#sec:Unified_Compiler_Configuration">12.2.3. Unified Compiler Configuration</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Transpilers">12.3. Transpilers</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:Phases">12.3.1. Overview</a></li>
+<li><a href="compilation.html#relation-between-ast-and-im">12.3.2. Relation between AST and IM</a></li>
+<li><a href="compilation.html#implementation-overview">12.3.3. Implementation Overview</a></li>
+<li><a href="compilation.html#sec:Guidelines_for_Implementing_Transformations">12.3.4. Guidelines for Implementing Transformations</a></li>
+<li><a href="compilation.html#symbol-table-in-the-im">12.3.5. Symbol Table in the IM</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:N4JS_to_EcmaScript_Transpiler">12.4. N4JS-to-EcmaScript Transpiler</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:Overview_of_Transformations">12.4.1. Overview of Transformations</a></li>
+<li><a href="compilation.html#sec:Transpiling_members">12.4.2. Transpiling members</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:Transpiling_members__Delegating_members">12.4.2.1. Techniques for special member handling</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__Partial_shadowing_of_getter_setter_pairs">12.4.2.2. Partial shadowing</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__Consuming_or_inheriting_members_of_an_interface">12.4.2.3. Consuming or inheriting members of an interface</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__Static_polyfill">12.4.2.4. Static polyfill</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__API_implementation_stubs">12.4.2.5. API / implementation stubs</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Support_for_incomplete_API_implementation_testing_in_the_N4JS_to_EcmaScript_5_Transpiler">12.4.3. Support for incomplete API implementation testing</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:Modifications_in_Impl_projects">12.4.3.1. Modifications in Impl projects</a></li>
+<li><a href="compilation.html#sec:Implementation_of_stub_generation">12.4.3.2. Implementation of stub-generation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:n4jsc_Headless_Compiler_Interface">12.5. n4jsc Headless Compiler Interface</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:building_the_headless_compiler">12.5.1. building the headless compiler</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="execution.html#_execution">13. Execution</a>
+<ul class="sectlevel2">
+<li><a href="execution.html#sec:N4JS_Project_Execution_And_Linking_Model">13.1. N4JS Project Execution And Linking Model</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#subsec:N4JS_Execution_With_NodeJS">13.1.1. N4JS Execution With NodeJS</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:N4JS_Execution_And_Linking_File">13.2. N4JS Execution And Linking File</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#subsec:NodeJS_Specific_ELF">13.2.1. NodeJS Specific ELF</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Runners-execution">13.3. Runners</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#subsec:N4_Runtime_Environments_Convention">13.3.1. N4 Runtime Environments Convention</a></li>
+<li><a href="execution.html#subsec:Passing_Information_from_IDE_to_Execution_Code_in_Runtime_Environment">13.3.2. Passing Information from IDE to Execution Code in Runtime Environment</a></li>
+<li><a href="execution.html#subsec:Runners_Design">13.3.3. Runners Design</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Legacy_Execution_Engine">13.4. Legacy Execution Engine</a></li>
+<li><a href="execution.html#sec:Design">13.5. Design</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#sec:Usage_Outside_N4JSIDE">13.5.1. Usage Outside N4JSIDE</a>
+<ul class="sectlevel4">
+<li><a href="execution.html#sec:Use_Node_with_Maven">13.5.1.1. Use Node with Maven</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Usage_Inside_N4JSIDE">13.5.2. Usage Inside N4JSIDE</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Runtime_Injection">13.6. Runtime Injection</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#sec:Running_String_Code">13.6.1. Running String Code</a></li>
+<li><a href="execution.html#sec:Running_File_Code">13.6.2. Running File Code</a></li>
+<li><a href="execution.html#sec:Injection_Code_Example">13.6.3. Injection Code Example</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#_tests">14. Tests</a>
+<ul class="sectlevel2">
+<li><a href="tests.html#sec:Performance_Tests">14.1. Performance Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Synthetic_Performance_Tests">14.1.1. Synthetic Performance Tests</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:Design_of_Generator">14.1.1.1. Design of Generator</a></li>
+<li><a href="tests.html#sec:Design_of_Performance_Test_Execution">14.1.1.2. Design of Performance Test Configuration and Execution</a></li>
+<li><a href="tests.html#sec:JUnit_Configuration">14.1.1.3. JUnit Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Test_Configuration">14.1.1.4. JUnitBenchmark Test Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Report_Configuration">14.1.1.5. JUnitBenchmark Report Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Run_Configuration">14.1.1.6. JUnitBenchmark Run Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Example">14.1.1.7. JUnitBenchmark Example</a></li>
+<li><a href="tests.html#sec:Note_on_Jenkins_Job">14.1.1.8. Note on Jenkins Job</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#sec:ECMA_Tests">14.2. ECMA Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Grammar_Tests">14.2.1. Grammar Tests</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:Negative_Tests">14.2.1.1. Negative Tests</a></li>
+<li><a href="tests.html#sec:Test_Exclusion">14.2.1.2. Test Exclusion</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Integration_Tests">14.3. Integration Tests</a></li>
+<li><a href="tests.html#sec:Test_Helpers">14.4. Test Helpers</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Parameterized_N4JS_Tests">14.4.1. Parameterized N4JS tests</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:ParameterizedXtextRunner">14.4.1.1. ParameterizedXtextRunner</a></li>
+<li><a href="tests.html#sec:TestCodeProvider">14.4.1.2. TestCodeProvider</a></li>
+<li><a href="tests.html#sec:Example_Of_Parameterized_Parser_Test">14.4.1.3. Example of parameterized parser test</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Issue_Suppression">14.5. Issue Suppression</a></li>
+<li><a href="tests.html#sec:Xpect_Tests">14.6. Xpect Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Xpect_Test_Setup">14.6.1. Xpect Test Setup</a></li>
+<li><a href="tests.html#sec:Xpect_Issue_Suppression">14.6.2. Xpect Issue Suppression</a></li>
+<li><a href="tests.html#sec:Xpect_Provided_Test_Methods">14.6.3. Xpect Provided Test Methods</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#errors">14.6.3.1. errors</a></li>
+<li><a href="tests.html#warnings">14.6.3.2. warnings</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:N4JS_Specific_Xpect_Test_Methods">14.6.4. N4JS Specific Xpect Test Methods</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:XPECT_noerrors">14.6.4.1. noerrors and nowarnings</a></li>
+<li><a href="tests.html#sec:XPECT_scope">14.6.4.2. scope</a></li>
+<li><a href="tests.html#sec:XPECT_scopeWithPosition">14.6.4.3. scopeWithPosition</a></li>
+<li><a href="tests.html#sec:XPECT_scopeWithResource">14.6.4.4. scopeWithResource</a></li>
+<li><a href="tests.html#sec:XPECT_binding">14.6.4.5. binding</a></li>
+<li><a href="tests.html#sec:XPECT_linkedPathname">14.6.4.6. linkedPathname</a></li>
+<li><a href="tests.html#sec:XPECT_type_of">14.6.4.7. type of</a></li>
+<li><a href="tests.html#sec:XPECT_expectedType">14.6.4.8. expectedType</a></li>
+<li><a href="tests.html#sec:XPECT_elementKeyword">14.6.4.9. elementKeyword</a></li>
+<li><a href="tests.html#sec:XPECT_accessModifier">14.6.4.10. accessModifier</a></li>
+<li><a href="tests.html#sec:XPECT_compileResult">14.6.4.11. compileResult</a></li>
+<li><a href="tests.html#sec:XPECT_output">14.6.4.12. output</a></li>
+<li><a href="tests.html#sec:XPECT_outputRegEx">14.6.4.13. outputRegEx</a></li>
+<li><a href="tests.html#sec:XPECT_calculatedAccessModifier">14.6.4.14. calculatedAccessModifier</a></li>
+<li><a href="tests.html#sec:XPECT_spec">14.6.4.15. spec</a></li>
+<li><a href="tests.html#sec:XPECT_deadCode">14.6.4.16. deadCode</a></li>
+<li><a href="tests.html#sec:XPECT_returnOrThrows">14.6.4.17. returnOrThrows</a></li>
+<li><a href="tests.html#sec:XPECT_lint">14.6.4.18. lint</a></li>
+<li><a href="tests.html#sec:XPECT_lintFails">14.6.4.19. lintFails</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:FIXME_Xpect_modifier">14.6.5. FIXME Xpect modifier</a></li>
+<li><a href="tests.html#sec:Expectmatrix_Xpect_Test_Methods">14.6.6. Expectmatrix Xpect tests</a></li>
+<li><a href="tests.html#xpect-lint-tests">14.6.7. Xpect Lint Tests</a></li>
+</ul>
+</li>
+<li><a href="tests.html#xpect-proposal-tests">14.7. Xpect Proposal Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Validation_vs__Non_Validation">14.7.1. Validation vs. Non-Validation</a></li>
+<li><a href="tests.html#sec:General_Proposal_Test_Features">14.7.2. General Proposal Test Features</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:Test_Variables">14.7.2.1. Test Variables</a></li>
+<li><a href="tests.html#sec:Location_and_Selection">14.7.2.2. at – Location and Selection</a></li>
+<li><a href="tests.html#sec:Multi_Line_Expectations_in_Proposal_Tests">14.7.2.3. Multi Line Expectations in Proposal Tests</a></li>
+<li><a href="tests.html#sec:Timeout">14.7.2.4. Timeout and Performance</a></li>
+</ul>
+</li>
+<li><a href="tests.html#proposals-verify-existence-of-proposals">14.7.3. proposals – Verify Existence of Proposals</a></li>
+<li><a href="tests.html#sec:Verify_displayed_string">14.7.4. display – Verify displayed string</a></li>
+<li><a href="tests.html#sec:Apply_Proposal">14.7.5. apply – Apply Proposal</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#resource-application-in-other-files">14.7.5.1. resource – application in other files</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Content_Assist_Cycling">14.7.6. kind – Content Assist Cycling</a></li>
+<li><a href="tests.html#fileValidVerify-validation-status">14.7.7. fileValid – Verify validation status</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Apply_Proposal_And_Execute_Tests">14.8. Apply Proposal And Execute Tests</a></li>
+<li><a href="tests.html#sec:Organize_Imports_Test">14.9. Organize Imports Test</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#organizeimports">14.9.1. organizeImports</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Access_Control_Test">14.10. Access Control Test</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#test-scenarios">14.10.1. Test Scenarios</a></li>
+<li><a href="tests.html#n4js-code-generator">14.10.2. N4JS Code Generator</a></li>
+<li><a href="tests.html#xtext-issue-matcher">14.10.3. Xtext Issue Matcher</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Smoke_Tests">14.11. Smoke Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#how-to-handle-smoke-test-errors">14.11.1. How to handle smoke test errors?</a></li>
+<li><a href="tests.html#smoketester-and-exceptionanalyzer">14.11.2. SmokeTester and ExceptionAnalyzer</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:UI_Tests_with_SWTBot">14.12. UI Tests with SWTBot</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#writing-swtbot-tests">14.12.1. Writing SWTBot Tests</a></li>
+<li><a href="tests.html#running-swtbot-tests">14.12.2. Running SWTBot Tests</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Debugging_UI_Tests">14.13. Debugging UI Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Connecting_to_the_X_server_on_the_build_node">14.13.1. Connecting to the X-server on the build-node</a></li>
+<li><a href="tests.html#sec:Tools_to_investigate_the_java_stack">14.13.2. Tools to investigate the java-stack</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="ui_concepts.html#_ui-concepts">15. UI Concepts</a>
+<ul class="sectlevel2">
+<li><a href="ui_concepts.html#sec:User_Interface_Concepts">15.1. User Interface Concepts</a>
+<ul class="sectlevel3">
+<li><a href="ui_concepts.html#sec:Eclipse_UI_Concepts">15.1.1. Eclipse UI Concepts</a>
+<ul class="sectlevel4">
+<li><a href="ui_concepts.html#sec:Label_Provider">15.1.1.1. Label Provider</a></li>
+<li><a href="ui_concepts.html#sec:Markers">15.1.1.2. Markers</a></li>
+<li><a href="ui_concepts.html#sec:Commands__Toolbar_and_Menus">15.1.1.3. Commands, Toolbar and Menus</a></li>
+<li><a href="ui_concepts.html#sec:Content_Assist">15.1.1.4. Content Assist</a></li>
+<li><a href="ui_concepts.html#sec:Quick_Fixes">15.1.1.5. Quick Fixes</a></li>
+<li><a href="ui_concepts.html#sec:Quick_Assist">15.1.1.6. Quick Assist</a></li>
+<li><a href="ui_concepts.html#sec:Clean_Up_Actions">15.1.1.7. Clean Up Actions</a></li>
+<li><a href="ui_concepts.html#sec:Save_Actions">15.1.1.8. Save Actions</a></li>
+<li><a href="ui_concepts.html#sec:Auto_Edit">15.1.1.9. Auto Edit</a></li>
+<li><a href="ui_concepts.html#sec:Template_Proposals">15.1.1.10. Template Proposals</a></li>
+<li><a href="ui_concepts.html#sec:Outline_View___Quick_Outline">15.1.1.11. Outline View / Quick Outline</a></li>
+<li><a href="ui_concepts.html#sec:Navigator__Package_Explorer__Project_Explorer">15.1.1.12. Navigator, Package Explorer, Project Explorer</a></li>
+<li><a href="ui_concepts.html#sec:Hyperlinking_and_Navigation">15.1.1.13. Hyperlinking and Navigation</a></li>
+<li><a href="ui_concepts.html#sec:Syntax_and_Semantic_Coloring">15.1.1.14. Syntax and Semantic Coloring</a></li>
+<li><a href="ui_concepts.html#sec:Code_Formatter">15.1.1.15. Code Formatter</a></li>
+<li><a href="ui_concepts.html#sec:Wizards">15.1.1.16. Wizards</a></li>
+<li><a href="ui_concepts.html#sec:Cheat_Sheets">15.1.1.17. Cheat Sheets</a></li>
+<li><a href="ui_concepts.html#sec:Context_sensitive_Help">15.1.1.18. Context-sensitive Help</a></li>
+<li><a href="ui_concepts.html#sec:Hovers">15.1.1.19. Hovers</a></li>
+<li><a href="ui_concepts.html#sec:Folding">15.1.1.20. Folding</a></li>
+<li><a href="ui_concepts.html#sec:Customizable_validation___severity">15.1.1.21. Customizable validation / severity</a></li>
+<li><a href="ui_concepts.html#sec:Proposals">15.1.1.22. Proposals</a></li>
+</ul>
+</li>
+<li><a href="ui_concepts.html#sec:Non_Eclipse_UI_Concepts">15.1.2. Non-Eclipse UI Concepts</a>
+<ul class="sectlevel4">
+<li><a href="ui_concepts.html#sec:Overlays">15.1.2.1. Overlays</a></li>
+<li><a href="ui_concepts.html#sec:Goto__Inferred__Type">15.1.2.2. Goto (Inferred) Type</a></li>
+<li><a href="ui_concepts.html#sec:Postfix_Completion">15.1.2.3. Postfix Completion</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="ui_concepts.html#_user-interface-resources">15.2. User Interface Resources</a>
+<ul class="sectlevel3">
+<li><a href="ui_concepts.html#_icons">15.2.1. Icons</a>
+<ul class="sectlevel4">
+<li><a href="ui_concepts.html#_eclipse-platform-icons">15.2.1.1. Eclipse Platform Icons</a></li>
+<li><a href="ui_concepts.html#_n4js-specific-icons">15.2.1.2. N4JS Specific Icons</a></li>
+<li><a href="ui_concepts.html#_high-resolution-icons">15.2.1.3. High Resolution Icons</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="formatting.html#_formatting">16. Formatting</a>
+<ul class="sectlevel2">
+<li><a href="formatting.html#sec:FmtObjective">16.1. Objective</a>
+<ul class="sectlevel3">
+<li><a href="formatting.html#sec:FmtFormatting_Comments">16.1.1. Formatting Comments</a></li>
+</ul>
+</li>
+<li><a href="formatting.html#sec:FmtArchitecture">16.2. Architecture</a>
+<ul class="sectlevel3">
+<li><a href="formatting.html#sec:Implementation_example">16.2.1. Implementation example</a></li>
+</ul>
+</li>
+<li><a href="formatting.html#sec:FmtFormatter_Implementation_Guidelines">16.3. Formatter Implementation Guidelines</a></li>
+<li><a href="formatting.html#sec:FmtConfiguration">16.4. Configuration</a></li>
+<li><a href="formatting.html#sec:FmtUI_Integration">16.5. UI Integration</a></li>
+<li><a href="formatting.html#sec:FmtUnit_Testing_with_Xpect">16.6. Unit Testing with Xpect</a></li>
+</ul>
+</li>
+<li><a href="external_libraries.html#_external-libraries">17. External Libraries</a>
+<ul class="sectlevel2">
+<li><a href="external_libraries.html#sec:Major_Components">17.1. Major Components</a>
+<ul class="sectlevel3">
+<li><a href="external_libraries.html#subsec:External_Resources">17.1.1. External Resources</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Workspace">17.1.2. External Library Workspace</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Preference_Store">17.1.3. External Library Preference Store</a></li>
+<li><a href="external_libraries.html#subsec:npm_Manager">17.1.4. Library Manager</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Builder_Helper">17.1.5. External Library Builder</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Xtext_Index_Persister">17.1.6. External Library Xtext Index Persister</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Preference_Page">17.1.7. External Library Preference Page</a></li>
+</ul>
+</li>
+<li><a href="external_libraries.html#sec:Headless_External_Library_Support">17.2. Headless External Library Support</a>
+<ul class="sectlevel3">
+<li><a href="external_libraries.html#_custom-npm-settings">17.2.1. Custom npm settings</a></li>
+</ul>
+</li>
+<li><a href="external_libraries.html#sec:lmFutureWork">17.3. Future Work</a>
+<ul class="sectlevel3">
+<li><a href="external_libraries.html#subsec:lmMultipleDependencyScope">17.3.1. Multiple Dependency Scope</a></li>
+<li><a href="external_libraries.html#subsec:lmRunTestsFromLibrary">17.3.2. Run Tests from TestLibrary</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="json_support.html#sec:JSON_Support">18. JSON Support</a>
+<ul class="sectlevel2">
+<li><a href="json_support.html#sec:JSON_Parser">18.1. JSON Parser</a>
+<ul class="sectlevel3">
+<li><a href="json_support.html#sec:JSON_Parser_Unicode_Escaping">18.1.1. Escaping Unicode Control Characters in String Literals</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Empty_Text">18.1.2. Empty Text</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Nested_Structures">18.1.3. Nested Structures</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Whitespace">18.1.4. Whitespace</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Comments">18.1.5. Comments</a></li>
+</ul>
+</li>
+<li><a href="json_support.html#sec:JSON_Language_Extensions">18.2. JSON Language Extensions</a>
+<ul class="sectlevel3">
+<li><a href="json_support.html#sec:JSON_Validator_Extensions">18.2.1. JSON Validator Extensions</a>
+<ul class="sectlevel4">
+<li><a href="json_support.html#sec:File_Specitic_Validator_Extensions">18.2.1.1. File-Specific Validator Extensions</a></li>
+<li><a href="json_support.html#sec:JSON_Declarative_JSON_Validator_Extensions">18.2.1.2. Declarative JSON Validator Extensions</a></li>
+</ul>
+</li>
+<li><a href="json_support.html#_json-resource-description-strategy">18.2.2. JSON Resource Description Strategy</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_jsdoc">19. JSDoc</a>
+<ul class="sectlevel2">
+<li><a href="jsdoc.html#sec:Design_Rationale">19.1. Design Rationale</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#_general-design">19.1.1. General Design</a></li>
+<li><a href="jsdoc.html#sec:Type_Expressions">19.1.2. Type Expressions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="docexporter.html#_docexporter">20. DocExporter</a>
+<ul class="sectlevel2">
+<li><a href="docexporter.html#sec:Specification_Exporter">20.1. Specification Exporter</a></li>
+</ul>
+</li>
+<li><a href="rename_refactoring.html#_rename-refactoring">21. Rename Refactoring</a>
+<ul class="sectlevel2">
+<li><a href="rename_refactoring.html#_rename-refactoring-ui-interaction">21.1. Rename Refactoring UI interaction</a></li>
+<li><a href="rename_refactoring.html#_renameelementprocessor-interaction">21.2. RenameElementProcessor interaction</a></li>
+</ul>
+</li>
+<li><a href="flow_graphs.html#chap:flowgraphs">22. Flow Graphs</a>
+<ul class="sectlevel2">
+<li><a href="flow_graphs.html#sec:flowgraphs_overview">22.1. Flow graphs overview</a>
+<ul class="sectlevel3">
+<li><a href="flow_graphs.html#_internal-graph">22.1.1. Internal graph</a></li>
+<li><a href="flow_graphs.html#_optimizations">22.1.2. Optimizations</a></li>
+<li><a href="flow_graphs.html#_api-for-client-analyses">22.1.3. API for client analyses</a>
+<ul class="sectlevel4">
+<li><a href="flow_graphs.html#_mapping-from-internal-to-ast-elements">22.1.3.1. Mapping from internal to AST elements</a></li>
+<li><a href="flow_graphs.html#_graph-visitor">22.1.3.2. Graph visitor</a></li>
+<li><a href="flow_graphs.html#_graph-explorer">22.1.3.3. Graph explorer</a></li>
+<li><a href="flow_graphs.html#_branch-walker">22.1.3.4. Branch walker</a></li>
+<li><a href="flow_graphs.html#_example-1-compute-string-for-each-path">22.1.3.5. Example 1: Compute string for each path</a></li>
+<li><a href="flow_graphs.html#_path-quantor">22.1.3.6. Path quantor</a></li>
+</ul>
+</li>
+<li><a href="flow_graphs.html#_control-flow-analyses">22.1.4. Control flow analyses</a>
+<ul class="sectlevel4">
+<li><a href="flow_graphs.html#_dead-code-analysis">22.1.4.1. Dead code analysis</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="flow_graphs.html#sec:dataflow">22.2. Dataflow</a>
+<ul class="sectlevel3">
+<li><a href="flow_graphs.html#_dataflow-graph">22.2.1. Dataflow graph</a></li>
+<li><a href="flow_graphs.html#_dataflow-analyses">22.2.2. Dataflow analyses</a>
+<ul class="sectlevel4">
+<li><a href="flow_graphs.html#_def-def-def-nothing-analysis">22.2.2.1. Def&#8594;Def / Def&#8594;Nothing analysis</a></li>
+<li><a href="flow_graphs.html#_def-use-decl-analysis">22.2.2.2. Def|Use&#8592;Decl analysis</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="publish_npms.html#sec:publish-npms-to-public">23. Publish npms</a>
+<ul class="sectlevel2">
+<li><a href="publish_npms.html#sec:publish-npms-n4js-maven">23.1. Publish n4js-libs to during  maven build</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Hints">Appendix A: Hints</a>
+<ul class="sectlevel2">
+<li><a href="appendix_a_hints.html#sec:XtextInjection">A.1. Xtext Injection</a>
+<ul class="sectlevel3">
+<li><a href="appendix_a_hints.html#sec:DI_MultipleInjectors_Singletons">A.1.1. Multiple Injectors and Singletons</a>
+<ul class="sectlevel4">
+<li><a href="appendix_a_hints.html#sec:DI_avoid_duplicate_singletons">A.1.1.1. Avoiding duplicate singletons</a>
+<ul class="sectlevel5">
+<li><a href="appendix_a_hints.html#sec:DI_binding_in_shared">A.1.1.1.1. Defining binding in the shared injector</a></li>
+<li><a href="appendix_a_hints.html#sec:DI_binding_in_custom">A.1.1.1.2. Defining binding in the custom injector</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:DI_Hints">A.1.2. Dependency Injection Hints</a>
+<ul class="sectlevel4">
+<li><a href="appendix_a_hints.html#sec:DI_custom_bundle">A.1.2.1. Use DI in custom bundle, use DI with extensions</a>
+<ul class="sectlevel5">
+<li><a href="appendix_a_hints.html#sec:DI_custom_bundle_problem">A.1.2.1.1. Problem</a></li>
+<li><a href="appendix_a_hints.html#sec:DI_custom_bundle_solution">A.1.2.1.2. Solution</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Access_Other_DSL_Injector">A.1.2.2. How do I get the Guice Injector of my language?</a>
+<ul class="sectlevel5">
+<li><a href="appendix_a_hints.html#sec:DSL_Injector_UI_context">A.1.2.2.1. UI context</a></li>
+<li><a href="appendix_a_hints.html#sec:DSL_Injector_Non_UI_context">A.1.2.2.2. Non UI context but with injection context</a></li>
+<li><a href="appendix_a_hints.html#sec:DSL_Injector_Non_UI_non_injection_context">A.1.2.2.3. Non UI context without injection context</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Cancel_Indicator">A.1.2.3. How do I get cancel indicators in different contexts?</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Eclipse">A.2. Eclipse</a>
+<ul class="sectlevel3">
+<li><a href="appendix_a_hints.html#sec:Show_Xtext_Index">A.2.1. Show the current Xtext index</a></li>
+<li><a href="appendix_a_hints.html#sec:Plugin_spy">A.2.2. Plug-in spy</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Maven-hints">A.3. Maven</a>
+<ul class="sectlevel3">
+<li><a href="appendix_a_hints.html#how-to-check-for-maven-mojo-updates">A.3.1. How to check for Maven MOJO updates</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#_module-loading">Appendix B: Module Loading</a>
+<ul class="sectlevel2">
+<li><a href="appendix_b_module_loading.html#sec:Dependency_Management">B.1. Dependency Management</a></li>
+<li><a href="appendix_b_module_loading.html#ecmascript-modules">B.2. ECMAScript Modules</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:ES5_Modules_Systems">B.2.1. ES5 Modules Systems</a></li>
+<li><a href="appendix_b_module_loading.html#sec:ES6_Modules">B.2.2. ES6 Modules</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:ECMAScript_Module_Loaders">B.3. ECMAScript Module Loaders</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:ES6_Module_Loaders">B.3.1. ES6 Module Loaders</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Polyfills_for_ES6_Module_Loaders">B.3.2. Polyfills for ES6 Module Loaders</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:es6_module_loader">B.3.2.1. es6-module-loader</a></li>
+<li><a href="appendix_b_module_loading.html#sec:SystemJS">B.3.2.2. SystemJS</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Demo">B.3.2.3. Demo</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#case-study-typescript">B.4. Case Study : TypeScript</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:ES6_Modules_Support">B.4.1. ES6 Modules Support</a></li>
+<li><a href="appendix_b_module_loading.html#sec:TypeScript_and_Module_Loading">B.4.2. TypeScript and Module Loading</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Cyclic_Dependencies">B.5. Cyclic Dependencies</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:Setup">B.5.1. Setup</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Transpile_and_Execute">B.5.2. Transpile and Execute</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Module_Format___AMD">B.5.2.1. Module Format = AMD</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Module_Format___CommonJS">B.5.2.2. Module Format = CommonJS</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Module_Format___SystemJS">B.5.2.3. Module Format = SystemJS</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Conclusion">B.5.3. Conclusion</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#system.register-as-transpilation-target">B.6. System.register as transpilation target</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:Introduction">B.6.1. Introduction</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:External_Transpilers">B.6.1.1. External Transpilers</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Example_of_a_System_register_module">B.6.1.2. Example of a System.register module</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Structure_of_a_System_register_module">B.6.2. Structure of a System.register module</a></li>
+<li><a href="appendix_b_module_loading.html#_transpilation-hints">B.6.3. Transpilation Hints</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Handling_Imports">B.6.3.1. Handling Imports</a></li>
+<li><a href="appendix_b_module_loading.html#sec:__exportFn__">B.6.3.2. &lt;&lt;exportFn&gt;&gt;</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Handling_Exports">B.6.3.3. Handling Exports</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Examples_w__Circular_Dependencies">B.6.4. Examples w/ Circular Dependencies</a></li>
+<li><a href="appendix_b_module_loading.html#sec:N4JS_Examples_w__Circular_Dependencies">B.6.5. N4JS Examples w/ Circular Dependencies</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Unresolved_Cyclic_Dependencies">B.6.5.1. Unresolved Cyclic Dependencies</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Variables___Functions">B.6.5.2. Examples with Variables &amp; Functions</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Classes">B.6.5.3. Examples with Classes</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Examples_with_SubClassing">B.6.5.4. Examples with SubClassing</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Miscellaneous">B.6.5.5. Miscellaneous</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#_resources">B.6.6. Resources</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:CommonJS_as_transpilation_target">B.7. CommonJS as transpilation target</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#_introduction-2">B.7.1. Introduction</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Transpilation_Hints">B.7.2. Transpilation Hints</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Import_Statements">B.7.2.1. Import Statements</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Export_Statements">B.7.2.2. Export Statements</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Tracking_Live_Bindings">B.7.2.3. Tracking Live Bindings</a></li>
+<li><a href="appendix_b_module_loading.html#sec:A_complete_example">B.7.2.4. A complete example</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#_resources-2">B.7.3. Resources</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_c_license.html#sec:License">Appendix C: License</a></li>
+<li><a href="appendix_d_acronyms.html#sec:Acronyms">Appendix D: Acronyms</a></li>
+<li><a href="appendix_e_bibliography_and_footnotes.html#_bibliography-and-footnotes">Appendix E: Bibliography and Footnotes</a></li>
+</ul>
+</div>
+</div>
+<div id="content"><div class="sect1">
+<h2 id="_tips-and-tricks"><a class="anchor" href="#_tips-and-tricks"></a><a class="link" href="#_tips-and-tricks">4. Tips and Tricks</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>In this chapter we collect some coding hints and guidelines on how to properly use the APIs of Eclipse, EMF, Xtext and
+other dependencies we are using, as well as our own utilities and helpers.</p>
+</div>
+<div class="paragraph">
+<p>This chapter is only about coding; add information on things like Eclipse setup or Maven/Jenkins to one of the preceding
+chapters. Similarly, this chapter is intended to provide just a quick overview, check-list and reminder; add detailed
+information and diagrams to one of the succeeding chapters.</p>
+</div>
+<div class="sect2">
+<h3 id="_naming"><a class="anchor" href="#_naming"></a><a class="link" href="#_naming">4.1. Naming</a></h3>
+<div class="ulist">
+<ul>
+<li>
+<p>The internal handling of N4JS project names is non-trivial (due to the support for npm scopes), see
+API documentation of <code>ProjectDescriptionUtils#isProjectNameWithScope(String)</code> for a detailed overview.
+In short:</p>
+<div class="ulist">
+<ul>
+<li>
+<p><code>IN4JSProject#getProjectName()</code> and <code>IProject#getName()</code> return different values!</p>
+</li>
+<li>
+<p>Avoid using the Eclipse project name, i.e. the return value of <code>IProject#getName()</code>, as far as possible
+(only use it in UI code when actually dealing with what is shown in the Eclipse UI).</p>
+</li>
+<li>
+<p>The last segment of an URI or path pointing to an N4JS project is <strong>not</strong> always the project name; use
+utilities in <code>ProjectDescriptionUtils</code> instead, e.g. <code>#deriveN4JSProjectNameFromURI()</code>!
+(However, given an URI or path pointing to a file inside an N4JS project, you can use its last segment
+to obtain the file name.)</p>
+</li>
+</ul>
+</div>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_logging"><a class="anchor" href="#_logging"></a><a class="link" href="#_logging">4.2. Logging</a></h3>
+<div class="paragraph">
+<p>In many situations developer needs to use some kind of logging. When in need, follow these rules:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Use <code>org.apache.log4j.Logger;</code> for logging. Other logging utilities (like java built in logger) are not configured.</p>
+</li>
+<li>
+<p>do not use <code>System.out</code> nor <code>Sysetem.err</code> for logging. It is ok to use it for debugging purposes, but those calls
+should never be merged to master. <em>(with exception of headless compiler, which uses them explicitly)</em></p>
+</li>
+<li>
+<p>There is central logger configuration in <code>org.eclipse.n4js.utils.logging</code> (and <code>org.eclipse.n4js.utils.logging</code>) that should
+be used</p>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p><code>log4j.xml</code> used for production</p>
+</li>
+<li>
+<p><code>log4j_tests.xml</code> used when running tests</p>
+</li>
+</ol>
+</div>
+</li>
+<li>
+<p>in Eclipse run configurations logger has to be set properly, e.g.
+<code>log4j.configuration=file:${workspace_loc:org.eclipse.n4js.utils.logging/log4j_tests.xml}</code></p>
+</li>
+<li>
+<p>in maven configurations logger has to be set separately, e.g.
+<code>-Dlog4j.configuration="file:${basedir}/../../plugins/org.eclipse.n4js.utils.logging/log4j_tests.xml</code></p>
+</li>
+</ol>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_cancellation-handling"><a class="anchor" href="#_cancellation-handling"></a><a class="link" href="#_cancellation-handling">4.3. Cancellation Handling</a></h3>
+<div class="paragraph">
+<p>At various occasions, Xtext provides an instance of class <code>CancelIndicator</code> to allow our code to handle cancellation of
+long-running task.</p>
+</div>
+<div class="paragraph">
+<p>Some things to keep in mind:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>whenever a <code>CancelIndicator</code> is available any code that might not return immediately should implement proper
+cancellation handling (as explained in the next items).</p>
+</li>
+<li>
+<p>most importantly: reacting to a cancellation by returning early from a method is an anti-pattern that leads to
+problems (client code might continue work on a canceled and thus invalid state); instead: throw an
+<code>OperationCanceledException</code>!</p>
+</li>
+<li>
+<p>don&#8217;t use <code>CancelIndicator#isCanceled()</code> for cancellation handling, except in certain special cases. A valid exception
+case might be during logging to show a message like "operation was canceled".</p>
+</li>
+<li>
+<p>instead, inject the Xtext service called <code>OperationCanceledManager</code> and invoke its method <code>#checkCanceled()</code>, passing-in
+the cancel indicator (this method is null-safe; it will throw an <code>OperationCanceledException</code> in case a cancellation has
+occurred). Don&#8217;t directly create and throw an <code>OperationCanceledException</code> yourself.</p>
+</li>
+<li>
+<p>use the other methods provided by <code>OperationCanceledManager</code> when appropriate (see code of that class for details).</p>
+</li>
+<li>
+<p>in try/catch blocks, when catching exceptions of a super type of <code>OperationCanceledException</code>, be sure to <strong>not suppress</strong>
+cancellation exceptions. For example:</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-java" data-lang="java">// Java code
+@Inject private OperationCanceledManager operationCanceledManager;
+/** Returns true on success, false otherwise. */
+public boolean doSomething(CancelIndicator ci) {
+  try {
+    // do something that might be canceled
+    return true;
+  } catch(Exception e) {
+    operationCanceledManager.propagateIfCancelException(e); // &lt;- IMPORTANT!
+    return false;
+  }
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Try/finally blocks, on the other hand, do not need any special handling.</p>
+</div>
+</li>
+<li>
+<p>a cancel indicator can also be stored in the rule environment (see <code>RuleEnvironmentExtensions#addCancelIndicator()</code>). This
+means:</p>
+<div class="ulist">
+<ul>
+<li>
+<p>if you create a rule environment completely from scratch and you have a cancel indicator at hand, add it to the rule
+environment via <code>RuleEnvironmentExtensions#addCancelIndicator()</code> (not required when using <code>RuleEnvironmentExtensions#wrap()</code> for
+deriving a rule environment from an existing one).</p>
+</li>
+<li>
+<p>if you have a rule environment available, be sure to use its cancel indicator in long-running operations, i.e. with
+code like:</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-java" data-lang="java">// Xtend code
+import static extension org.eclipse.n4js.typesystem.utils.RuleEnvironmentExtensions.*
+class C {
+  @Inject private OperationCanceledManager operationCanceledManager;
+  def void doSomething() {
+    for(a : aLotOfStuff) {
+      operationCanceledManager.checkCanceled(G.cancelIndicator);
+      // main work ...
+    }
+  }</code></pre>
+</div>
+</div>
+</li>
+</ul>
+</div>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_caching"><a class="anchor" href="#_caching"></a><a class="link" href="#_caching">4.4. Caching</a></h3>
+<div class="ulist">
+<ul>
+<li>
+<p>Caching of external libraries (implemented in ExternalProjectMappings)</p>
+<div class="ulist">
+<ul>
+<li>
+<p>update <em>only</em> using <code>EclipseExternalLibraryWorkspace#updateState()</code></p>
+</li>
+<li>
+<p>always mind that the diff of current state and cached state is a necessary information for cleaning dependencies of removed npms</p>
+<div class="ulist">
+<ul>
+<li>
+<p>see <code>EclipseExternalIndexSynchronizer#synchronizeNpms()</code> for implementation</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>updating also happens when external root locations change (see ExternalIndexUpdater)</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>Caching of user workspace projects (implemented in MuliCleartriggerCache)</p>
+<div class="ulist">
+<ul>
+<li>
+<p>caches only some project information and should be refactored along with Core, Model and EclipseBasedN4JSWorkspace</p>
+</li>
+</ul>
+</div>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_dependency-injection"><a class="anchor" href="#_dependency-injection"></a><a class="link" href="#_dependency-injection">4.5. Dependency Injection</a></h3>
+<div class="paragraph">
+<p>There are some things to keep in mind when using dependency injection in the context of Xtext. This is a longer topic and it is discussed in the appendix
+<a href="appendix_a_hints.html#sec:XtextInjection">Xtext Injection</a>.</p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_miscellaneous"><a class="anchor" href="#_miscellaneous"></a><a class="link" href="#_miscellaneous">4.6. Miscellaneous</a></h3>
+<div class="ulist">
+<ul>
+<li>
+<p>Resource load states: when an N4JS/N4JSD file is loaded, a certain sequence of processing is triggered (parsing,
+linking, validation, etc.) and thus an <code>N4JSResource</code> transitions through a sequence of "load states". For details,
+see <a href="type_index.html#sec:N4JS_Resource_Load_States">N4JS Resource Load States</a>.</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div id="footer">
+<div id="footer-text">
+Version 0.9<br>
+Last updated 2019-08-07 15:02:40 CEST
+</div>
+</div>
+<!-- ************* docinfo-footer *************************************************************** -->
+<div class="Grid social" style="color:#d5dfea">
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <h2>Quick Links</h2>
+    <ul>
+      <li><a href="../downloads.html">Download</a></li>
+      <li><a href="../userguides/index.html">Documentation</a></li>
+      <li><a href="https://github.com/eclipse/n4js/">Source</a></li>
+      <li><a href="https://github.com/eclipse/n4js/issues">Issues</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="https://www.eclipse.org/forums/index.php/f/365/">Forum</a></li>
+      <li><a href="http://n4js.blogspot.de/">Blog</a></li>
+      <li><a href="https://dev.eclipse.org/mailman/listinfo/n4js-dev">Mailing List</a></li>
+      <li><a href="https://projects.eclipse.org/projects/technology.n4js">Eclipse Project Page</a></li>
+      <li><a href="https://twitter.com/n4jsdev">Tweets by n4jsdev</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="http://www.eclipse.org/">Eclipse Home</a></li>
+      <li><a href="http://www.eclipse.org/legal/privacy.php">Privacy Policy</a></li>
+      <li><a href="http://www.eclipse.org/legal/termsofuse.php">Terms of Use</a></li>
+      <li><a href="http://www.eclipse.org/legal/copyright.php">Copyright Agent</a></li>
+      <li><a href="http://www.eclipse.org/legal/">Legal</a></li>
+    </ul>
+  </div>
+  <div style="clear: both; height: 0; overflow: hidden;"></div>
+</div>
+
+<!-- ************* UI Scripts ************* -->
+<script type="text/javascript" src="scripts/back-to-top.js"></script>
+
+<script type="text/javascript" src="scripts/treeview.js"></script>
+<script type="text/javascript" src="scripts/toc.js"></script>
+
+<!-- ************* Prism.js Syntax Highlighting ************* -->
+<script src="scripts/prism.js"></script>
+
+<script type="text/javascript">
+	// Add the 'toclist' id for search function
+	$(".toc2 > ul").attr('id', 'toclist');
+	// Generate a Search input form
+	$("#toclist > li:first-of-type").before('<input type="text" id="pagesearch" onkeyup="search()" placeholder="Search for section...">');
+	$("#toclist > li:first-of-type").before('<i id="clear" class="fa fa-times-circle-o"></i>');
+	$("#clear").click(function(){
+	    $("#pagesearch").val('');
+	    search();
+	    $('.toc2 > ul').treeView('collapseAll');
+	});
+	// intialize Treeview.js
+	$(".toc2 > ul").treeView();
+	// Initialize Scrollspy
+</script>
+<!-- ************* docinfo-footer *************************************************************** -->
+</body>
+</html>
\ No newline at end of file
diff --git a/design/type_index.html b/design/type_index.html
new file mode 100644
index 0000000..272949d
--- /dev/null
+++ b/design/type_index.html
@@ -0,0 +1,2178 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="generator" content="Asciidoctor 1.5.5">
+<meta name="author" content="2019-08-07 15:02:40 CEST">
+<title>N4JS Design Specification</title>
+<link rel="stylesheet" href="styles/spec.min.css">
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.6.3/css/font-awesome.min.css">
+<!-- ************* docinfo ******************************************************************* -->
+
+
+<!-- ************* Favicon ************-->
+<link rel="icon" href="images/favicon.ico" />
+
+<!-- ************* Back-to-top JQuery ************* -->
+<script src="https://code.jquery.com/jquery-1.12.4.js"></script>
+<script src="https://code.jquery.com/ui/1.12.0/jquery-ui.js"></script>
+
+
+<link href="styles/prism.min.css" rel="stylesheet" />
+<script type="text/javascript" async
+  src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2/MathJax.js?config=TeX-MML-AM_CHTML">
+</script>
+
+<!-- ************* Styles ************* -->
+<link rel="stylesheet" type="text/css" href="styles/n4jsspec-adoc.css">
+
+
+<!-- ****************** NavBar ****************** -->
+<div id="menubar">
+	<div class="banner">
+        <a href="https://www.eclipse.org/n4js/#"><img id="logo" src="images/n4js-logo.png" alt="Eclipse N4JS"></a>
+    </div>
+<ul>
+  <li><a href="index.html">Index</a></li>
+</ul>
+</div>
+<!-- ************* docinfo ******************************************************************* -->
+<style>
+      .admonitionblock td.icon .icon-todo:before{content:"\f249";color:#f4ee42}
+    </style>
+</head>
+<body class="book toc2 toc-left">
+<div id="header">
+<h1>N4JS Design Specification</h1>
+<div class="details">
+<span id="author" class="author">2019-08-07 15:02:40 CEST</span><br>
+<span id="revnumber">version 0.9</span>
+</div>
+<div id="toc" class="toc2">
+<div id="toctitle">Table of Contents</div>
+<ul class="sectlevel1">
+<li><a href="introduction.html#_introduction">1. Introduction</a>
+<ul class="sectlevel2">
+<li><a href="introduction.html#notation">1.1. Notation</a></li>
+<li><a href="introduction.html#sec:IDE_Overview">1.2. IDE Components</a>
+<ul class="sectlevel3">
+<li><a href="introduction.html#sec:Naming_Conventions">1.2.1. Naming Conventions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="eclipse_setup.html#_eclipse-setup">2. Eclipse Setup</a>
+<ul class="sectlevel2">
+<li><a href="eclipse_setup.html#_system-requirements">2.1. System Requirements</a></li>
+<li><a href="eclipse_setup.html#_contribute">2.2. Contribute</a>
+<ul class="sectlevel3">
+<li><a href="eclipse_setup.html#_eclipse-installer">2.2.1. Eclipse Installer</a>
+<ul class="sectlevel4">
+<li><a href="eclipse_setup.html#_changing-the-setup-script">2.2.1.1. Changing the Setup Script</a></li>
+</ul>
+</li>
+<li><a href="eclipse_setup.html#_manual-ide-configuration">2.2.2. Manual IDE Configuration</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="release_engineering.html#_release-engineering">3. Release Engineering</a>
+<ul class="sectlevel2">
+<li><a href="release_engineering.html#_nightly-build-on-eclipse-infrastructure">3.1. Nightly build on Eclipse infrastructure</a></li>
+<li><a href="release_engineering.html#_build-the-n4js-ide-from-command-line">3.2. Build the N4JS IDE from command line</a>
+<ul class="sectlevel3">
+<li><a href="release_engineering.html#_publish-maven-tooling-code-org-eclipse-n4js-releng-util-code">3.2.1. Publish maven-tooling <code>org.eclipse.n4js.releng.util</code></a></li>
+<li><a href="release_engineering.html#sec:test-verdaccio">3.2.2. Test Verdaccio containing n4js-libs</a></li>
+<li><a href="release_engineering.html#_generation-of-eclipse-help-for-spec-and-design-document">3.2.3. Generation of Eclipse help for spec and design document</a></li>
+</ul>
+</li>
+<li><a href="release_engineering.html#_updating-frameworks-and-dependencies">3.3. Updating frameworks and dependencies</a>
+<ul class="sectlevel3">
+<li><a href="release_engineering.html#_update-of-eclipse-emf-xtext-etc">3.3.1. Update of Eclipse, EMF, Xtext, etc.</a></li>
+<li><a href="release_engineering.html#_update-of-the-embedded-jre">3.3.2. Update of the embedded JRE</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tips_and_tricks.html#_tips-and-tricks">4. Tips and Tricks</a>
+<ul class="sectlevel2">
+<li><a href="tips_and_tricks.html#_naming">4.1. Naming</a></li>
+<li><a href="tips_and_tricks.html#_logging">4.2. Logging</a></li>
+<li><a href="tips_and_tricks.html#_cancellation-handling">4.3. Cancellation Handling</a></li>
+<li><a href="tips_and_tricks.html#_caching">4.4. Caching</a></li>
+<li><a href="tips_and_tricks.html#_dependency-injection">4.5. Dependency Injection</a></li>
+<li><a href="tips_and_tricks.html#_miscellaneous">4.6. Miscellaneous</a></li>
+</ul>
+</li>
+<li><a href="parser.html#_parser">5. Parser</a>
+<ul class="sectlevel2">
+<li><a href="parser.html#sec:Parser_Overview">5.1. Overview</a></li>
+<li><a href="parser.html#sec:N4JS_Parser">5.2. N4JS Parser</a></li>
+<li><a href="parser.html#sec:Parser_Generation_Post_Processing">5.3. Parser Generation Post-Processing</a>
+<ul class="sectlevel3">
+<li><a href="parser.html#sec:Automatic_Semicolon_Insertion">5.3.1. Automatic Semicolon Insertion</a>
+<ul class="sectlevel4">
+<li><a href="parser.html#sec:Injected_code_in_the_Antlr_grammar_file">5.3.1.1. Injected code in the Antlr grammar file</a></li>
+<li><a href="parser.html#sec:Customized_error_recovery">5.3.1.2. Customized error recovery</a></li>
+</ul>
+</li>
+<li><a href="parser.html#sec:_No_line_terminator_allowed_here__handling">5.3.2. Async and <code>No line terminator allowed here</code> Handling</a></li>
+<li><a href="parser.html#sec:Regular_Expression">5.3.3. Regular Expression</a></li>
+<li><a href="parser.html#sec:Unicode">5.3.4. Unicode</a></li>
+<li><a href="parser.html#sec:Literals">5.3.5. Literals</a></li>
+</ul>
+</li>
+<li><a href="parser.html#sec:Modifiers">5.4. Modifiers</a></li>
+<li><a href="parser.html#sec:Conflict_Resolutions">5.5. Conflict Resolutions</a>
+<ul class="sectlevel3">
+<li><a href="parser.html#sec:Reserved_Keywords_vs__Identifier_Names">5.5.1. Reserved Keywords vs. Identifier Names</a></li>
+<li><a href="parser.html#sec:Operators_and_Generics">5.5.2. Operators and Generics</a></li>
+</ul>
+</li>
+<li><a href="parser.html#sec:Content_Assist_Parser">5.6. Content-Assist Parser</a></li>
+</ul>
+</li>
+<li><a href="type_system.html#_type-system">6. Type System</a>
+<ul class="sectlevel2">
+<li><a href="type_system.html#sec:Type_Model_and_Grammar">6.1. Type Model and Grammar</a>
+<ul class="sectlevel3">
+<li><a href="type_system.html#sec:Type_Model_Overview">6.1.1. Type Model Overview</a></li>
+<li><a href="type_system.html#sec:Built_in_Types">6.1.2. Built-in and Primitive Types</a></li>
+<li><a href="type_system.html#sec:Type_Model_DSL">6.1.3. Type Model DSL</a></li>
+</ul>
+</li>
+<li><a href="type_system.html#sec:Type_System_Implementation">6.2. Type System Implementation</a></li>
+<li><a href="type_system.html#sec:Type_Inference_combined_with_AST_Traversal">6.3. Type Inference of AST</a>
+<ul class="sectlevel3">
+<li><a href="type_system.html#sec:Type_Inference_combined_with_AST_Traversal__Background">6.3.1. Background</a></li>
+<li><a href="type_system.html#sec:Triggering_Type_Inference_of_AST">6.3.2. Triggering</a></li>
+<li><a href="type_system.html#sec:Traversal_Order_During_Type_Inference_of_AST">6.3.3. Traversal Order</a></li>
+<li><a href="type_system.html#sec:Cross_References_During_Type_Inference_of_AST">6.3.4. Cross-References</a></li>
+<li><a href="type_system.html#sec:Function_Accessor_Bodies_During_Type_Inference_of_AST">6.3.5. Function/Accessor Bodies</a></li>
+<li><a href="type_system.html#sec:Poly_Expressions_During_Type_Inference_of_AST">6.3.6. Poly Expressions</a></li>
+<li><a href="type_system.html#sec:Constraint_Solver_used_During_Type_Inference_of_AST">6.3.7. Constraint Solver</a></li>
+<li><a href="type_system.html#sec:Type_Guards_During_Type_Inference_of_AST">6.3.8. Type Guards</a></li>
+</ul>
+</li>
+<li><a href="type_system.html#sec:Structural_Typing">6.4. Structural Typing</a></li>
+</ul>
+</li>
+<li><a href="#_type-index">7. Type Index</a>
+<ul class="sectlevel2">
+<li><a href="#sec:Type_Index_Design_Rationale">7.1. Design Rationale</a>
+<ul class="sectlevel3">
+<li><a href="#sec:Getting_the_Xtext_Index_Content_IResourceDescriptions">7.1.1. Getting the Xtext Index (<code>IResourceDescriptions</code>) Content</a></li>
+</ul>
+</li>
+<li><a href="#sec:Design_Overview">7.2. Design Overview</a></li>
+<li><a href="#sec:N4JS_Resource_Load_States">7.3. N4JS Resource Load States</a></li>
+<li><a href="#sec:Type_Builder">7.4. Types Builder</a>
+<ul class="sectlevel3">
+<li><a href="#sec:Type_Inference_not_allowed_in_Type_Builder">7.4.1. Type Inference not allowed in Types Builder</a></li>
+<li><a href="#sec:ComputedTypeReferences">7.4.2. Deferred Type References</a></li>
+<li><a href="#sec:Use_cases_of_ComputedTypeRef">7.4.3. Use cases of DeferredTypeRef</a></li>
+</ul>
+</li>
+<li><a href="#sec:Incremental_Builder_Overview">7.5. Incremental Builder (Overview)</a>
+<ul class="sectlevel3">
+<li><a href="#sec:Incremental_Builder_Overview__XtextBuilder">7.5.1. XtextBuilder</a></li>
+<li><a href="#sec:Incremental_Builder_Overview__IBuilderState">7.5.2. IBuilderState</a>
+<ul class="sectlevel4">
+<li><a href="#copy-and-update-xtext-index">7.5.2.1. Copy and Update Xtext Index</a></li>
+<li><a href="#build-state-setup-phase">7.5.2.2. Build State Setup Phase</a></li>
+<li><a href="#process-queued-uris">7.5.2.3. Process Queued URIs</a></li>
+<li><a href="#queueing-affected-resources">7.5.2.4. Queueing Affected Resources</a></li>
+</ul>
+</li>
+<li><a href="#sec:Incremental_Builder_Overview__Example">7.5.3. Example</a></li>
+</ul>
+</li>
+<li><a href="#dirty-state-handling">7.6. Dirty state handling</a>
+<ul class="sectlevel3">
+<li><a href="#use-case-restoring-types-from-user-data">7.6.1. Use case: Restoring types from user data</a></li>
+<li><a href="#use-case-updating-the-xtext-index">7.6.2. Use case: Updating the Xtext index</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="project_model.html#_project-model">8. Project Model</a>
+<ul class="sectlevel2">
+<li><a href="project_model.html#sec:Package_json">8.1. Package.json File</a></li>
+<li><a href="project_model.html#_accessing-project-information">8.2. Accessing Project Information</a>
+<ul class="sectlevel3">
+<li><a href="project_model.html#sec:IN4JSCore">8.2.1. IN4JSCore</a></li>
+<li><a href="project_model.html#sec:N4JSModel">8.2.2. N4JSModel</a></li>
+<li><a href="project_model.html#sec:N4JSWorkspace">8.2.3. N4JSWorkspace</a></li>
+<li><a href="project_model.html#sec:N4JSProject">8.2.4. N4JSProject</a></li>
+<li><a href="project_model.html#sec:SourceContainer">8.2.5. SourceContainer</a></li>
+<li><a href="project_model.html#sec:N4JSProjectsStateHelper">8.2.6. N4JSProjectsStateHelper</a></li>
+</ul>
+</li>
+<li><a href="project_model.html#sec:Caching">8.3. Caching</a>
+<ul class="sectlevel3">
+<li><a href="project_model.html#_caching-of-externallibraryworkspace">8.3.1. Caching of ExternalLibraryWorkspace</a></li>
+<li><a href="project_model.html#_caching-of-n4jsprojectsstatehelper">8.3.2. Caching of N4JSProjectsStateHelper</a></li>
+</ul>
+</li>
+<li><a href="project_model.html#sec:WildcardPathFilter">8.4. WildcardPathFilter</a></li>
+<li><a href="project_model.html#sec:ProjectUtils">8.5. ProjectUtils</a></li>
+</ul>
+</li>
+<li><a href="binding.html#_binding">9. Binding</a>
+<ul class="sectlevel2">
+<li><a href="binding.html#sec:Binding_Design_Rationale">9.1. Design Rationale</a></li>
+<li><a href="binding.html#sec:Binding_to_Members">9.2. Binding to Members</a></li>
+<li><a href="binding.html#sec:Binding_Getter_Setter">9.3. Getter / Setter Binding</a></li>
+<li><a href="binding.html#chap:Statics">9.4. Static Member Binding</a></li>
+<li><a href="binding.html#sec:Binding_Enumeration">9.5. Enumeration Literals Binding</a></li>
+<li><a href="binding.html#sec:Accessibility_of_types_and_members">9.6. Accessibility of types and members</a></li>
+<li><a href="binding.html#sec:Member_Scope_Example">9.7. Member Scope Example</a></li>
+<li><a href="binding.html#sec:Scoping_for_Members_of_Composed_Type_Explained">9.8. Scoping for Members of Composed Type (Union/Intersection) Example</a></li>
+<li><a href="binding.html#sec:Binding_of_Structurally_References_Types">9.9. Structurally References Types</a></li>
+<li><a href="binding.html#sec:Building">9.10. Building</a>
+<ul class="sectlevel3">
+<li><a href="binding.html#sec:Build_Phases">9.10.1. Build Phases</a></li>
+<li><a href="binding.html#sec:Build_Scenarios">9.10.2. Build Scenarios</a></li>
+<li><a href="binding.html#sec:Lazy_linking_problem">9.10.3. Lazy linking problem</a></li>
+</ul>
+</li>
+<li><a href="binding.html#sec:Proxies_and_Proxy_Resolution">9.11. Proxies and Proxy Resolution (Overview)</a>
+<ul class="sectlevel3">
+<li><a href="binding.html#xtexts-lazy-linking-proxies">9.11.1. Xtext’s Lazy Linking Proxies</a></li>
+<li><a href="binding.html#standard-emf-proxies">9.11.2. Standard EMF Proxies</a></li>
+<li><a href="binding.html#_how-is-proxy-resolution-triggered">9.11.3. How is Proxy Resolution Triggered?</a></li>
+<li><a href="binding.html#_when-is-proxy-resolution-allowed">9.11.4. When is Proxy Resolution Allowed?</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="validation.html#_validation">10. Validation</a>
+<ul class="sectlevel2">
+<li><a href="validation.html#sec:validation_overview">10.1. Validation overview</a></li>
+<li><a href="validation.html#sec:validation_control_flow">10.2. Validation control flow</a></li>
+<li><a href="validation.html#sec:validation_issue_ids">10.3. Issue IDs and Messages</a></li>
+<li><a href="validation.html#sec:validation_usage_patterns">10.4. Usage Pattern</a></li>
+<li><a href="validation.html#sec:validation_links">10.5. Links</a></li>
+</ul>
+</li>
+<li><a href="references.html#_references">11. References</a>
+<ul class="sectlevel2">
+<li><a href="references.html#sec:usecases">11.1. Use cases</a></li>
+<li><a href="references.html#sec:calculation_algorithm">11.2. Calculation algorithm</a>
+<ul class="sectlevel3">
+<li><a href="references.html#sec:Xtext_default_implementation">11.2.1. Xtext default implementation</a></li>
+<li><a href="references.html#sec:N4_implementation">11.2.2. N4JS implementation</a></li>
+</ul>
+</li>
+<li><a href="references.html#sec:PerformanceOfDependencyCalculation">11.3. Performance Of Dependency Calculation</a></li>
+<li><a href="references.html#sec:kinds_of_references">11.4. Kinds of references</a>
+<ul class="sectlevel3">
+<li><a href="references.html#sec:Cross_References_to_be_ignored">11.4.1. Cross References to be ignored</a></li>
+<li><a href="references.html#sec:Cross_References_to_be_handled">11.4.2. Cross References to be handled</a></li>
+</ul>
+</li>
+<li><a href="references.html#sec:transitive_dependencies">11.5. Transitive dependencies</a></li>
+<li><a href="references.html#sec:find-references">11.6. Find references</a>
+<ul class="sectlevel3">
+<li><a href="references.html#_background">11.6.1. Background</a></li>
+<li><a href="references.html#_how-find-references-work">11.6.2. How Find References Work</a>
+<ul class="sectlevel4">
+<li><a href="references.html#_step-1-convert-cursor-position-to-declared-element">11.6.2.1. Step 1: Convert Cursor Position to Declared Element</a></li>
+<li><a href="references.html#_step-2-convert-declared-element-to-target-uris">11.6.2.2. Step 2: Convert Declared Element to Target URIs</a></li>
+<li><a href="references.html#_step-3-filter-potential-resources">11.6.2.3. Step 3: Filter Potential Resources</a></li>
+<li><a href="references.html#_step-4-search-references-in-resource">11.6.2.4. Step 4: Search References in Resource</a></li>
+<li><a href="references.html#_limitations-and-possible-enhancements">11.6.2.5. Limitations and Possible Enhancements</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="compilation.html#_compilation">12. Compilation</a>
+<ul class="sectlevel2">
+<li><a href="compilation.html#chap:compilation">12.1. Introduction</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:general_design_rationals">12.1.1. General design rationals</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:logging_and_error_reporting">12.1.1.1. Logging and error reporting</a></li>
+<li><a href="compilation.html#sec:progress_monitor">12.1.1.2. Progress monitor</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Xtext_Integration">12.1.2. Xtext Integration</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:xtext_default_behaviour">12.1.2.1. Xtext default behaviour</a></li>
+<li><a href="compilation.html#sec:n4js_requirements">12.1.2.2. N4JS requirements</a></li>
+<li><a href="compilation.html#sec:compiler_discovery_in_ui">12.1.2.3. Compiler discovery in UI</a></li>
+<li><a href="compilation.html#sec:compiler_discovery_in_headless">12.1.2.4. Compiler discovery in headless</a></li>
+<li><a href="compilation.html#sec:general_generator_implementation">12.1.2.5. General generator implementation</a></li>
+<li><a href="compilation.html#sec:general_generator_activation">12.1.2.6. General generator activation</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Overview_of_Input_Models">12.1.3. Overview of the Input Models</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Core_Generator">12.2. Generators</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:Compiler_Components">12.2.1. Generator Components</a></li>
+<li><a href="compilation.html#sec:Generator_architecture">12.2.2. Generator architecture</a></li>
+<li><a href="compilation.html#sec:Unified_Compiler_Configuration">12.2.3. Unified Compiler Configuration</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Transpilers">12.3. Transpilers</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:Phases">12.3.1. Overview</a></li>
+<li><a href="compilation.html#relation-between-ast-and-im">12.3.2. Relation between AST and IM</a></li>
+<li><a href="compilation.html#implementation-overview">12.3.3. Implementation Overview</a></li>
+<li><a href="compilation.html#sec:Guidelines_for_Implementing_Transformations">12.3.4. Guidelines for Implementing Transformations</a></li>
+<li><a href="compilation.html#symbol-table-in-the-im">12.3.5. Symbol Table in the IM</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:N4JS_to_EcmaScript_Transpiler">12.4. N4JS-to-EcmaScript Transpiler</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:Overview_of_Transformations">12.4.1. Overview of Transformations</a></li>
+<li><a href="compilation.html#sec:Transpiling_members">12.4.2. Transpiling members</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:Transpiling_members__Delegating_members">12.4.2.1. Techniques for special member handling</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__Partial_shadowing_of_getter_setter_pairs">12.4.2.2. Partial shadowing</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__Consuming_or_inheriting_members_of_an_interface">12.4.2.3. Consuming or inheriting members of an interface</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__Static_polyfill">12.4.2.4. Static polyfill</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__API_implementation_stubs">12.4.2.5. API / implementation stubs</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Support_for_incomplete_API_implementation_testing_in_the_N4JS_to_EcmaScript_5_Transpiler">12.4.3. Support for incomplete API implementation testing</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:Modifications_in_Impl_projects">12.4.3.1. Modifications in Impl projects</a></li>
+<li><a href="compilation.html#sec:Implementation_of_stub_generation">12.4.3.2. Implementation of stub-generation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:n4jsc_Headless_Compiler_Interface">12.5. n4jsc Headless Compiler Interface</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:building_the_headless_compiler">12.5.1. building the headless compiler</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="execution.html#_execution">13. Execution</a>
+<ul class="sectlevel2">
+<li><a href="execution.html#sec:N4JS_Project_Execution_And_Linking_Model">13.1. N4JS Project Execution And Linking Model</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#subsec:N4JS_Execution_With_NodeJS">13.1.1. N4JS Execution With NodeJS</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:N4JS_Execution_And_Linking_File">13.2. N4JS Execution And Linking File</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#subsec:NodeJS_Specific_ELF">13.2.1. NodeJS Specific ELF</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Runners-execution">13.3. Runners</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#subsec:N4_Runtime_Environments_Convention">13.3.1. N4 Runtime Environments Convention</a></li>
+<li><a href="execution.html#subsec:Passing_Information_from_IDE_to_Execution_Code_in_Runtime_Environment">13.3.2. Passing Information from IDE to Execution Code in Runtime Environment</a></li>
+<li><a href="execution.html#subsec:Runners_Design">13.3.3. Runners Design</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Legacy_Execution_Engine">13.4. Legacy Execution Engine</a></li>
+<li><a href="execution.html#sec:Design">13.5. Design</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#sec:Usage_Outside_N4JSIDE">13.5.1. Usage Outside N4JSIDE</a>
+<ul class="sectlevel4">
+<li><a href="execution.html#sec:Use_Node_with_Maven">13.5.1.1. Use Node with Maven</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Usage_Inside_N4JSIDE">13.5.2. Usage Inside N4JSIDE</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Runtime_Injection">13.6. Runtime Injection</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#sec:Running_String_Code">13.6.1. Running String Code</a></li>
+<li><a href="execution.html#sec:Running_File_Code">13.6.2. Running File Code</a></li>
+<li><a href="execution.html#sec:Injection_Code_Example">13.6.3. Injection Code Example</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#_tests">14. Tests</a>
+<ul class="sectlevel2">
+<li><a href="tests.html#sec:Performance_Tests">14.1. Performance Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Synthetic_Performance_Tests">14.1.1. Synthetic Performance Tests</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:Design_of_Generator">14.1.1.1. Design of Generator</a></li>
+<li><a href="tests.html#sec:Design_of_Performance_Test_Execution">14.1.1.2. Design of Performance Test Configuration and Execution</a></li>
+<li><a href="tests.html#sec:JUnit_Configuration">14.1.1.3. JUnit Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Test_Configuration">14.1.1.4. JUnitBenchmark Test Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Report_Configuration">14.1.1.5. JUnitBenchmark Report Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Run_Configuration">14.1.1.6. JUnitBenchmark Run Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Example">14.1.1.7. JUnitBenchmark Example</a></li>
+<li><a href="tests.html#sec:Note_on_Jenkins_Job">14.1.1.8. Note on Jenkins Job</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#sec:ECMA_Tests">14.2. ECMA Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Grammar_Tests">14.2.1. Grammar Tests</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:Negative_Tests">14.2.1.1. Negative Tests</a></li>
+<li><a href="tests.html#sec:Test_Exclusion">14.2.1.2. Test Exclusion</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Integration_Tests">14.3. Integration Tests</a></li>
+<li><a href="tests.html#sec:Test_Helpers">14.4. Test Helpers</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Parameterized_N4JS_Tests">14.4.1. Parameterized N4JS tests</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:ParameterizedXtextRunner">14.4.1.1. ParameterizedXtextRunner</a></li>
+<li><a href="tests.html#sec:TestCodeProvider">14.4.1.2. TestCodeProvider</a></li>
+<li><a href="tests.html#sec:Example_Of_Parameterized_Parser_Test">14.4.1.3. Example of parameterized parser test</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Issue_Suppression">14.5. Issue Suppression</a></li>
+<li><a href="tests.html#sec:Xpect_Tests">14.6. Xpect Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Xpect_Test_Setup">14.6.1. Xpect Test Setup</a></li>
+<li><a href="tests.html#sec:Xpect_Issue_Suppression">14.6.2. Xpect Issue Suppression</a></li>
+<li><a href="tests.html#sec:Xpect_Provided_Test_Methods">14.6.3. Xpect Provided Test Methods</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#errors">14.6.3.1. errors</a></li>
+<li><a href="tests.html#warnings">14.6.3.2. warnings</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:N4JS_Specific_Xpect_Test_Methods">14.6.4. N4JS Specific Xpect Test Methods</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:XPECT_noerrors">14.6.4.1. noerrors and nowarnings</a></li>
+<li><a href="tests.html#sec:XPECT_scope">14.6.4.2. scope</a></li>
+<li><a href="tests.html#sec:XPECT_scopeWithPosition">14.6.4.3. scopeWithPosition</a></li>
+<li><a href="tests.html#sec:XPECT_scopeWithResource">14.6.4.4. scopeWithResource</a></li>
+<li><a href="tests.html#sec:XPECT_binding">14.6.4.5. binding</a></li>
+<li><a href="tests.html#sec:XPECT_linkedPathname">14.6.4.6. linkedPathname</a></li>
+<li><a href="tests.html#sec:XPECT_type_of">14.6.4.7. type of</a></li>
+<li><a href="tests.html#sec:XPECT_expectedType">14.6.4.8. expectedType</a></li>
+<li><a href="tests.html#sec:XPECT_elementKeyword">14.6.4.9. elementKeyword</a></li>
+<li><a href="tests.html#sec:XPECT_accessModifier">14.6.4.10. accessModifier</a></li>
+<li><a href="tests.html#sec:XPECT_compileResult">14.6.4.11. compileResult</a></li>
+<li><a href="tests.html#sec:XPECT_output">14.6.4.12. output</a></li>
+<li><a href="tests.html#sec:XPECT_outputRegEx">14.6.4.13. outputRegEx</a></li>
+<li><a href="tests.html#sec:XPECT_calculatedAccessModifier">14.6.4.14. calculatedAccessModifier</a></li>
+<li><a href="tests.html#sec:XPECT_spec">14.6.4.15. spec</a></li>
+<li><a href="tests.html#sec:XPECT_deadCode">14.6.4.16. deadCode</a></li>
+<li><a href="tests.html#sec:XPECT_returnOrThrows">14.6.4.17. returnOrThrows</a></li>
+<li><a href="tests.html#sec:XPECT_lint">14.6.4.18. lint</a></li>
+<li><a href="tests.html#sec:XPECT_lintFails">14.6.4.19. lintFails</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:FIXME_Xpect_modifier">14.6.5. FIXME Xpect modifier</a></li>
+<li><a href="tests.html#sec:Expectmatrix_Xpect_Test_Methods">14.6.6. Expectmatrix Xpect tests</a></li>
+<li><a href="tests.html#xpect-lint-tests">14.6.7. Xpect Lint Tests</a></li>
+</ul>
+</li>
+<li><a href="tests.html#xpect-proposal-tests">14.7. Xpect Proposal Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Validation_vs__Non_Validation">14.7.1. Validation vs. Non-Validation</a></li>
+<li><a href="tests.html#sec:General_Proposal_Test_Features">14.7.2. General Proposal Test Features</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:Test_Variables">14.7.2.1. Test Variables</a></li>
+<li><a href="tests.html#sec:Location_and_Selection">14.7.2.2. at – Location and Selection</a></li>
+<li><a href="tests.html#sec:Multi_Line_Expectations_in_Proposal_Tests">14.7.2.3. Multi Line Expectations in Proposal Tests</a></li>
+<li><a href="tests.html#sec:Timeout">14.7.2.4. Timeout and Performance</a></li>
+</ul>
+</li>
+<li><a href="tests.html#proposals-verify-existence-of-proposals">14.7.3. proposals – Verify Existence of Proposals</a></li>
+<li><a href="tests.html#sec:Verify_displayed_string">14.7.4. display – Verify displayed string</a></li>
+<li><a href="tests.html#sec:Apply_Proposal">14.7.5. apply – Apply Proposal</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#resource-application-in-other-files">14.7.5.1. resource – application in other files</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Content_Assist_Cycling">14.7.6. kind – Content Assist Cycling</a></li>
+<li><a href="tests.html#fileValidVerify-validation-status">14.7.7. fileValid – Verify validation status</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Apply_Proposal_And_Execute_Tests">14.8. Apply Proposal And Execute Tests</a></li>
+<li><a href="tests.html#sec:Organize_Imports_Test">14.9. Organize Imports Test</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#organizeimports">14.9.1. organizeImports</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Access_Control_Test">14.10. Access Control Test</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#test-scenarios">14.10.1. Test Scenarios</a></li>
+<li><a href="tests.html#n4js-code-generator">14.10.2. N4JS Code Generator</a></li>
+<li><a href="tests.html#xtext-issue-matcher">14.10.3. Xtext Issue Matcher</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Smoke_Tests">14.11. Smoke Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#how-to-handle-smoke-test-errors">14.11.1. How to handle smoke test errors?</a></li>
+<li><a href="tests.html#smoketester-and-exceptionanalyzer">14.11.2. SmokeTester and ExceptionAnalyzer</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:UI_Tests_with_SWTBot">14.12. UI Tests with SWTBot</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#writing-swtbot-tests">14.12.1. Writing SWTBot Tests</a></li>
+<li><a href="tests.html#running-swtbot-tests">14.12.2. Running SWTBot Tests</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Debugging_UI_Tests">14.13. Debugging UI Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Connecting_to_the_X_server_on_the_build_node">14.13.1. Connecting to the X-server on the build-node</a></li>
+<li><a href="tests.html#sec:Tools_to_investigate_the_java_stack">14.13.2. Tools to investigate the java-stack</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="ui_concepts.html#_ui-concepts">15. UI Concepts</a>
+<ul class="sectlevel2">
+<li><a href="ui_concepts.html#sec:User_Interface_Concepts">15.1. User Interface Concepts</a>
+<ul class="sectlevel3">
+<li><a href="ui_concepts.html#sec:Eclipse_UI_Concepts">15.1.1. Eclipse UI Concepts</a>
+<ul class="sectlevel4">
+<li><a href="ui_concepts.html#sec:Label_Provider">15.1.1.1. Label Provider</a></li>
+<li><a href="ui_concepts.html#sec:Markers">15.1.1.2. Markers</a></li>
+<li><a href="ui_concepts.html#sec:Commands__Toolbar_and_Menus">15.1.1.3. Commands, Toolbar and Menus</a></li>
+<li><a href="ui_concepts.html#sec:Content_Assist">15.1.1.4. Content Assist</a></li>
+<li><a href="ui_concepts.html#sec:Quick_Fixes">15.1.1.5. Quick Fixes</a></li>
+<li><a href="ui_concepts.html#sec:Quick_Assist">15.1.1.6. Quick Assist</a></li>
+<li><a href="ui_concepts.html#sec:Clean_Up_Actions">15.1.1.7. Clean Up Actions</a></li>
+<li><a href="ui_concepts.html#sec:Save_Actions">15.1.1.8. Save Actions</a></li>
+<li><a href="ui_concepts.html#sec:Auto_Edit">15.1.1.9. Auto Edit</a></li>
+<li><a href="ui_concepts.html#sec:Template_Proposals">15.1.1.10. Template Proposals</a></li>
+<li><a href="ui_concepts.html#sec:Outline_View___Quick_Outline">15.1.1.11. Outline View / Quick Outline</a></li>
+<li><a href="ui_concepts.html#sec:Navigator__Package_Explorer__Project_Explorer">15.1.1.12. Navigator, Package Explorer, Project Explorer</a></li>
+<li><a href="ui_concepts.html#sec:Hyperlinking_and_Navigation">15.1.1.13. Hyperlinking and Navigation</a></li>
+<li><a href="ui_concepts.html#sec:Syntax_and_Semantic_Coloring">15.1.1.14. Syntax and Semantic Coloring</a></li>
+<li><a href="ui_concepts.html#sec:Code_Formatter">15.1.1.15. Code Formatter</a></li>
+<li><a href="ui_concepts.html#sec:Wizards">15.1.1.16. Wizards</a></li>
+<li><a href="ui_concepts.html#sec:Cheat_Sheets">15.1.1.17. Cheat Sheets</a></li>
+<li><a href="ui_concepts.html#sec:Context_sensitive_Help">15.1.1.18. Context-sensitive Help</a></li>
+<li><a href="ui_concepts.html#sec:Hovers">15.1.1.19. Hovers</a></li>
+<li><a href="ui_concepts.html#sec:Folding">15.1.1.20. Folding</a></li>
+<li><a href="ui_concepts.html#sec:Customizable_validation___severity">15.1.1.21. Customizable validation / severity</a></li>
+<li><a href="ui_concepts.html#sec:Proposals">15.1.1.22. Proposals</a></li>
+</ul>
+</li>
+<li><a href="ui_concepts.html#sec:Non_Eclipse_UI_Concepts">15.1.2. Non-Eclipse UI Concepts</a>
+<ul class="sectlevel4">
+<li><a href="ui_concepts.html#sec:Overlays">15.1.2.1. Overlays</a></li>
+<li><a href="ui_concepts.html#sec:Goto__Inferred__Type">15.1.2.2. Goto (Inferred) Type</a></li>
+<li><a href="ui_concepts.html#sec:Postfix_Completion">15.1.2.3. Postfix Completion</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="ui_concepts.html#_user-interface-resources">15.2. User Interface Resources</a>
+<ul class="sectlevel3">
+<li><a href="ui_concepts.html#_icons">15.2.1. Icons</a>
+<ul class="sectlevel4">
+<li><a href="ui_concepts.html#_eclipse-platform-icons">15.2.1.1. Eclipse Platform Icons</a></li>
+<li><a href="ui_concepts.html#_n4js-specific-icons">15.2.1.2. N4JS Specific Icons</a></li>
+<li><a href="ui_concepts.html#_high-resolution-icons">15.2.1.3. High Resolution Icons</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="formatting.html#_formatting">16. Formatting</a>
+<ul class="sectlevel2">
+<li><a href="formatting.html#sec:FmtObjective">16.1. Objective</a>
+<ul class="sectlevel3">
+<li><a href="formatting.html#sec:FmtFormatting_Comments">16.1.1. Formatting Comments</a></li>
+</ul>
+</li>
+<li><a href="formatting.html#sec:FmtArchitecture">16.2. Architecture</a>
+<ul class="sectlevel3">
+<li><a href="formatting.html#sec:Implementation_example">16.2.1. Implementation example</a></li>
+</ul>
+</li>
+<li><a href="formatting.html#sec:FmtFormatter_Implementation_Guidelines">16.3. Formatter Implementation Guidelines</a></li>
+<li><a href="formatting.html#sec:FmtConfiguration">16.4. Configuration</a></li>
+<li><a href="formatting.html#sec:FmtUI_Integration">16.5. UI Integration</a></li>
+<li><a href="formatting.html#sec:FmtUnit_Testing_with_Xpect">16.6. Unit Testing with Xpect</a></li>
+</ul>
+</li>
+<li><a href="external_libraries.html#_external-libraries">17. External Libraries</a>
+<ul class="sectlevel2">
+<li><a href="external_libraries.html#sec:Major_Components">17.1. Major Components</a>
+<ul class="sectlevel3">
+<li><a href="external_libraries.html#subsec:External_Resources">17.1.1. External Resources</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Workspace">17.1.2. External Library Workspace</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Preference_Store">17.1.3. External Library Preference Store</a></li>
+<li><a href="external_libraries.html#subsec:npm_Manager">17.1.4. Library Manager</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Builder_Helper">17.1.5. External Library Builder</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Xtext_Index_Persister">17.1.6. External Library Xtext Index Persister</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Preference_Page">17.1.7. External Library Preference Page</a></li>
+</ul>
+</li>
+<li><a href="external_libraries.html#sec:Headless_External_Library_Support">17.2. Headless External Library Support</a>
+<ul class="sectlevel3">
+<li><a href="external_libraries.html#_custom-npm-settings">17.2.1. Custom npm settings</a></li>
+</ul>
+</li>
+<li><a href="external_libraries.html#sec:lmFutureWork">17.3. Future Work</a>
+<ul class="sectlevel3">
+<li><a href="external_libraries.html#subsec:lmMultipleDependencyScope">17.3.1. Multiple Dependency Scope</a></li>
+<li><a href="external_libraries.html#subsec:lmRunTestsFromLibrary">17.3.2. Run Tests from TestLibrary</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="json_support.html#sec:JSON_Support">18. JSON Support</a>
+<ul class="sectlevel2">
+<li><a href="json_support.html#sec:JSON_Parser">18.1. JSON Parser</a>
+<ul class="sectlevel3">
+<li><a href="json_support.html#sec:JSON_Parser_Unicode_Escaping">18.1.1. Escaping Unicode Control Characters in String Literals</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Empty_Text">18.1.2. Empty Text</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Nested_Structures">18.1.3. Nested Structures</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Whitespace">18.1.4. Whitespace</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Comments">18.1.5. Comments</a></li>
+</ul>
+</li>
+<li><a href="json_support.html#sec:JSON_Language_Extensions">18.2. JSON Language Extensions</a>
+<ul class="sectlevel3">
+<li><a href="json_support.html#sec:JSON_Validator_Extensions">18.2.1. JSON Validator Extensions</a>
+<ul class="sectlevel4">
+<li><a href="json_support.html#sec:File_Specitic_Validator_Extensions">18.2.1.1. File-Specific Validator Extensions</a></li>
+<li><a href="json_support.html#sec:JSON_Declarative_JSON_Validator_Extensions">18.2.1.2. Declarative JSON Validator Extensions</a></li>
+</ul>
+</li>
+<li><a href="json_support.html#_json-resource-description-strategy">18.2.2. JSON Resource Description Strategy</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_jsdoc">19. JSDoc</a>
+<ul class="sectlevel2">
+<li><a href="jsdoc.html#sec:Design_Rationale">19.1. Design Rationale</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#_general-design">19.1.1. General Design</a></li>
+<li><a href="jsdoc.html#sec:Type_Expressions">19.1.2. Type Expressions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="docexporter.html#_docexporter">20. DocExporter</a>
+<ul class="sectlevel2">
+<li><a href="docexporter.html#sec:Specification_Exporter">20.1. Specification Exporter</a></li>
+</ul>
+</li>
+<li><a href="rename_refactoring.html#_rename-refactoring">21. Rename Refactoring</a>
+<ul class="sectlevel2">
+<li><a href="rename_refactoring.html#_rename-refactoring-ui-interaction">21.1. Rename Refactoring UI interaction</a></li>
+<li><a href="rename_refactoring.html#_renameelementprocessor-interaction">21.2. RenameElementProcessor interaction</a></li>
+</ul>
+</li>
+<li><a href="flow_graphs.html#chap:flowgraphs">22. Flow Graphs</a>
+<ul class="sectlevel2">
+<li><a href="flow_graphs.html#sec:flowgraphs_overview">22.1. Flow graphs overview</a>
+<ul class="sectlevel3">
+<li><a href="flow_graphs.html#_internal-graph">22.1.1. Internal graph</a></li>
+<li><a href="flow_graphs.html#_optimizations">22.1.2. Optimizations</a></li>
+<li><a href="flow_graphs.html#_api-for-client-analyses">22.1.3. API for client analyses</a>
+<ul class="sectlevel4">
+<li><a href="flow_graphs.html#_mapping-from-internal-to-ast-elements">22.1.3.1. Mapping from internal to AST elements</a></li>
+<li><a href="flow_graphs.html#_graph-visitor">22.1.3.2. Graph visitor</a></li>
+<li><a href="flow_graphs.html#_graph-explorer">22.1.3.3. Graph explorer</a></li>
+<li><a href="flow_graphs.html#_branch-walker">22.1.3.4. Branch walker</a></li>
+<li><a href="flow_graphs.html#_example-1-compute-string-for-each-path">22.1.3.5. Example 1: Compute string for each path</a></li>
+<li><a href="flow_graphs.html#_path-quantor">22.1.3.6. Path quantor</a></li>
+</ul>
+</li>
+<li><a href="flow_graphs.html#_control-flow-analyses">22.1.4. Control flow analyses</a>
+<ul class="sectlevel4">
+<li><a href="flow_graphs.html#_dead-code-analysis">22.1.4.1. Dead code analysis</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="flow_graphs.html#sec:dataflow">22.2. Dataflow</a>
+<ul class="sectlevel3">
+<li><a href="flow_graphs.html#_dataflow-graph">22.2.1. Dataflow graph</a></li>
+<li><a href="flow_graphs.html#_dataflow-analyses">22.2.2. Dataflow analyses</a>
+<ul class="sectlevel4">
+<li><a href="flow_graphs.html#_def-def-def-nothing-analysis">22.2.2.1. Def&#8594;Def / Def&#8594;Nothing analysis</a></li>
+<li><a href="flow_graphs.html#_def-use-decl-analysis">22.2.2.2. Def|Use&#8592;Decl analysis</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="publish_npms.html#sec:publish-npms-to-public">23. Publish npms</a>
+<ul class="sectlevel2">
+<li><a href="publish_npms.html#sec:publish-npms-n4js-maven">23.1. Publish n4js-libs to during  maven build</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Hints">Appendix A: Hints</a>
+<ul class="sectlevel2">
+<li><a href="appendix_a_hints.html#sec:XtextInjection">A.1. Xtext Injection</a>
+<ul class="sectlevel3">
+<li><a href="appendix_a_hints.html#sec:DI_MultipleInjectors_Singletons">A.1.1. Multiple Injectors and Singletons</a>
+<ul class="sectlevel4">
+<li><a href="appendix_a_hints.html#sec:DI_avoid_duplicate_singletons">A.1.1.1. Avoiding duplicate singletons</a>
+<ul class="sectlevel5">
+<li><a href="appendix_a_hints.html#sec:DI_binding_in_shared">A.1.1.1.1. Defining binding in the shared injector</a></li>
+<li><a href="appendix_a_hints.html#sec:DI_binding_in_custom">A.1.1.1.2. Defining binding in the custom injector</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:DI_Hints">A.1.2. Dependency Injection Hints</a>
+<ul class="sectlevel4">
+<li><a href="appendix_a_hints.html#sec:DI_custom_bundle">A.1.2.1. Use DI in custom bundle, use DI with extensions</a>
+<ul class="sectlevel5">
+<li><a href="appendix_a_hints.html#sec:DI_custom_bundle_problem">A.1.2.1.1. Problem</a></li>
+<li><a href="appendix_a_hints.html#sec:DI_custom_bundle_solution">A.1.2.1.2. Solution</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Access_Other_DSL_Injector">A.1.2.2. How do I get the Guice Injector of my language?</a>
+<ul class="sectlevel5">
+<li><a href="appendix_a_hints.html#sec:DSL_Injector_UI_context">A.1.2.2.1. UI context</a></li>
+<li><a href="appendix_a_hints.html#sec:DSL_Injector_Non_UI_context">A.1.2.2.2. Non UI context but with injection context</a></li>
+<li><a href="appendix_a_hints.html#sec:DSL_Injector_Non_UI_non_injection_context">A.1.2.2.3. Non UI context without injection context</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Cancel_Indicator">A.1.2.3. How do I get cancel indicators in different contexts?</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Eclipse">A.2. Eclipse</a>
+<ul class="sectlevel3">
+<li><a href="appendix_a_hints.html#sec:Show_Xtext_Index">A.2.1. Show the current Xtext index</a></li>
+<li><a href="appendix_a_hints.html#sec:Plugin_spy">A.2.2. Plug-in spy</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Maven-hints">A.3. Maven</a>
+<ul class="sectlevel3">
+<li><a href="appendix_a_hints.html#how-to-check-for-maven-mojo-updates">A.3.1. How to check for Maven MOJO updates</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#_module-loading">Appendix B: Module Loading</a>
+<ul class="sectlevel2">
+<li><a href="appendix_b_module_loading.html#sec:Dependency_Management">B.1. Dependency Management</a></li>
+<li><a href="appendix_b_module_loading.html#ecmascript-modules">B.2. ECMAScript Modules</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:ES5_Modules_Systems">B.2.1. ES5 Modules Systems</a></li>
+<li><a href="appendix_b_module_loading.html#sec:ES6_Modules">B.2.2. ES6 Modules</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:ECMAScript_Module_Loaders">B.3. ECMAScript Module Loaders</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:ES6_Module_Loaders">B.3.1. ES6 Module Loaders</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Polyfills_for_ES6_Module_Loaders">B.3.2. Polyfills for ES6 Module Loaders</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:es6_module_loader">B.3.2.1. es6-module-loader</a></li>
+<li><a href="appendix_b_module_loading.html#sec:SystemJS">B.3.2.2. SystemJS</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Demo">B.3.2.3. Demo</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#case-study-typescript">B.4. Case Study : TypeScript</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:ES6_Modules_Support">B.4.1. ES6 Modules Support</a></li>
+<li><a href="appendix_b_module_loading.html#sec:TypeScript_and_Module_Loading">B.4.2. TypeScript and Module Loading</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Cyclic_Dependencies">B.5. Cyclic Dependencies</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:Setup">B.5.1. Setup</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Transpile_and_Execute">B.5.2. Transpile and Execute</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Module_Format___AMD">B.5.2.1. Module Format = AMD</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Module_Format___CommonJS">B.5.2.2. Module Format = CommonJS</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Module_Format___SystemJS">B.5.2.3. Module Format = SystemJS</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Conclusion">B.5.3. Conclusion</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#system.register-as-transpilation-target">B.6. System.register as transpilation target</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:Introduction">B.6.1. Introduction</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:External_Transpilers">B.6.1.1. External Transpilers</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Example_of_a_System_register_module">B.6.1.2. Example of a System.register module</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Structure_of_a_System_register_module">B.6.2. Structure of a System.register module</a></li>
+<li><a href="appendix_b_module_loading.html#_transpilation-hints">B.6.3. Transpilation Hints</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Handling_Imports">B.6.3.1. Handling Imports</a></li>
+<li><a href="appendix_b_module_loading.html#sec:__exportFn__">B.6.3.2. &lt;&lt;exportFn&gt;&gt;</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Handling_Exports">B.6.3.3. Handling Exports</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Examples_w__Circular_Dependencies">B.6.4. Examples w/ Circular Dependencies</a></li>
+<li><a href="appendix_b_module_loading.html#sec:N4JS_Examples_w__Circular_Dependencies">B.6.5. N4JS Examples w/ Circular Dependencies</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Unresolved_Cyclic_Dependencies">B.6.5.1. Unresolved Cyclic Dependencies</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Variables___Functions">B.6.5.2. Examples with Variables &amp; Functions</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Classes">B.6.5.3. Examples with Classes</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Examples_with_SubClassing">B.6.5.4. Examples with SubClassing</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Miscellaneous">B.6.5.5. Miscellaneous</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#_resources">B.6.6. Resources</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:CommonJS_as_transpilation_target">B.7. CommonJS as transpilation target</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#_introduction-2">B.7.1. Introduction</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Transpilation_Hints">B.7.2. Transpilation Hints</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Import_Statements">B.7.2.1. Import Statements</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Export_Statements">B.7.2.2. Export Statements</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Tracking_Live_Bindings">B.7.2.3. Tracking Live Bindings</a></li>
+<li><a href="appendix_b_module_loading.html#sec:A_complete_example">B.7.2.4. A complete example</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#_resources-2">B.7.3. Resources</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_c_license.html#sec:License">Appendix C: License</a></li>
+<li><a href="appendix_d_acronyms.html#sec:Acronyms">Appendix D: Acronyms</a></li>
+<li><a href="appendix_e_bibliography_and_footnotes.html#_bibliography-and-footnotes">Appendix E: Bibliography and Footnotes</a></li>
+</ul>
+</div>
+</div>
+<div id="content"><div class="sect1">
+<h2 id="_type-index"><a class="anchor" href="#_type-index"></a><a class="link" href="#_type-index">7. Type Index</a></h2>
+<div class="sectionbody">
+<div class="sect2 language-n4js">
+<h3 id="sec:Type_Index_Design_Rationale"><a class="anchor" href="#sec:Type_Index_Design_Rationale"></a><a class="link" href="#sec:Type_Index_Design_Rationale">7.1. Design Rationale</a></h3>
+<div class="paragraph">
+<p>We use a separate types model to represent types, see <a href="type_system.html#sec:Type_Model_and_Grammar">Type Model and Grammar</a>. Declared elements (e.g., classes)
+in N4JS are parsed and a new types model instance is derived from them. All type references (of the N4JS <a href="appendix_d_acronyms.html#AC">AST</a>)
+are then bound to these type instances and not to the N4JS declaration. However, there exists a relation between a type
+and its declaration. The type instances (which are EObjects) are added to the resource of the N4JS file as part of
+the public interface of the resource. This public interface is represented by a <code>TModule</code>. While the actual source code
+is the first element of a resource (index 0), the module is stored at index 1. It contains the derived type information,
+the information about exported variables and functions as well as information about the project and vendor. The Xtext
+serializer ignores the additional element. Besides, the complete type instances are stored in the user data section of
+the <code>IEObjectDescription</code> of the <code>TModule</code>. Since the user data only allows strings to be stored, the EObjects are serialized
+(within a virtual resource). When a reference is then bound to a type, the type can be directly recreated (deserialized)
+from the user data. The deserialized EObject is then added to the appropriate resource. It is not necessary to load the
+complete file just to refer to a type from that file.</p>
+</div>
+<div class="paragraph">
+<p>The design relies on two key features of Xtext:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Besides the parsed text (i.e., the AST), other elements can be stored in a resource, which are then ignored by
+the Xtext serializer, while still being properly contained in an EMF resource.</p>
+</li>
+<li>
+<p>The <code>DerivedStateAwareResource</code> allows some kind of post processing steps when reading a resource. This enables a custom
+class, here <code>N4JSDerivedStateComputer</code>, to create the types models (TClass, TRole and so on) from the parsed <code>N4ClassDeclaration</code>,
+<code>N4RoleDeclaration</code> and so on.</p>
+</li>
+</ol>
+</div>
+<div class="sect3">
+<h4 id="sec:Getting_the_Xtext_Index_Content_IResourceDescriptions"><a class="anchor" href="#sec:Getting_the_Xtext_Index_Content_IResourceDescriptions"></a><a class="link" href="#sec:Getting_the_Xtext_Index_Content_IResourceDescriptions">7.1.1. Getting the Xtext Index (<code>IResourceDescriptions</code>) Content</a></h4>
+<div class="paragraph">
+<p>An instance of the <code>IResourceDescriptions</code> can be acquired from the resource description provider. Just like all services
+in Xtext, this can be injected into the client code as well. The resource descriptions accepts a non-null resource set.
+The resource set argument is mandatory to provide the index with the proper state. We are differentiating between three
+different state. The first one is the persisted one, basically the builder state is a resource description as well, and
+it provides a content that is based on the persisted state of the files (in our case the modules and package.json file)
+on the file system. The second one is the live scoped index, this is modification and dirty state aware. Namely when using
+this resource descriptions then an object description will be searched in the resource set itself first, then in the dirty
+editor’s index, finally among the persisted ones. The third index is the named builder scoped one. This index should not be
+used by common client code, since it is designed and implemented for the Xtex builder itself.</p>
+</div>
+<div class="paragraph">
+<p>A resource set and hence the index can be acquired from the N4JS core, in such cases an optional N4JS project can be specified.
+The N4JS project argument is used to retrieve the underlying Eclipse resource project (if present) and get the resource set from
+the resource set provider. This is completely ignored when the application is running in headless mode and Eclipse resource
+projects are not available. It is also important to note that the resource set is always configured to load only the persisted
+states.</p>
+</div>
+<div class="paragraph">
+<p>When the Eclipse platform is running, the workspace is available and the all N4JS projects are backed by an Eclipse resource
+project. With the Eclipse resource project the resource sets can be initialized properly via the resource set initializer
+implementations. This mechanism is used to get the global objects (such as console) and the built-in types (such as string,
+number) into the resource set via the corresponding resource set adapters. In the headless case a special resource set
+implementation is used; <code>ResourceSetWithBuiltInScheme</code>. This implementation is responsible to initialize the globals and the
+built-in types into itself.</p>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:Design_Overview"><a class="anchor" href="#sec:Design_Overview"></a><a class="link" href="#sec:Design_Overview">7.2. Design Overview</a></h3>
+<div class="paragraph">
+<p><a href="#fig:cd_TypeModelWithXtextIndex">Type Model With Xtext Index</a> shows a simplified UML class diagram with the involved
+classes. In the figure, a class (defined as N4ClassExpression in the <a href="appendix_d_acronyms.html#AC">AST</a> and its type TClass) is used as a sample,
+declared type—roles or enums are handled similarly.</p>
+</div>
+<div class="paragraph">
+<p>In the Eclipse project build the <code>N4JSResourceDescriptionManager</code> (resp. by the logic of its super class) is called by the
+<code>N4JSGenerateImmediatelyBuilderState</code> to get the resource description for a resource. The resource description manager loads
+the resource to create / update the resource descriptions. Loading an Xtext resource means that it is reparsed again.
+All cross references are handled here only by the lazy linker so that the node model will contain an unresolved proxy
+for all cross references.</p>
+</div>
+<div class="paragraph">
+<p>After the resource is loaded there is a derived state installed to the resource. For this the <code>N4JSDerivedStateComputer</code> will
+be called. It will take the parse result (= EObject tree in first slot of the resource) and navigate through these objects
+to create type trees for each encountered exportable object that are stored in exported <code>TModule</code> of the resource.
+<a href="#fig:cd_CreateTypeFromAST">Create Type From AST</a>, a snippet of <a href="#fig:cd_TypeModelWithXtextIndex">Type Model with Xtext Index</a>,
+shows only the classes involved when creating the types from the resource.</p>
+</div>
+<div id="fig:cd_CreateTypeFromAST" class="imageblock center">
+<div class="content">
+<img src="chapters/07_typeindex/images/cd_CreateTypeFromAST.png" alt="cd CreateTypeFromAST">
+</div>
+<div class="title">Figure 11. Type From AST</div>
+</div>
+<div id="fig:cd_TypeModelWithXtextIndex" class="imageblock center">
+<div class="content">
+<img src="chapters/07_typeindex/images/cd_CreateTypeFromIndex.png" alt="cd CreateTypeFromIndex">
+</div>
+<div class="title">Figure 12. Create Type From Index</div>
+</div>
+<div id="fig:cd_SerializeToIndex" class="imageblock center">
+<div class="content">
+<img src="chapters/07_typeindex/images/cd_SerializeToIndex.png" alt="cd SerializeToIndex">
+</div>
+<div class="title">Figure 13. Serialize To Index</div>
+</div>
+<div class="paragraph language-javascript">
+<p>For these elements types have to be derived as they are exportable: <code>N4ClassDeclaration</code>, <code>N4RoleDeclaration</code>, <code>N4InterfaceDeclaration</code>,
+<code>N4EnumDeclaration</code>, <code>ExportedVariableDeclaration</code> and <code>FunctionDeclaration</code>.</p>
+</div>
+<div class="paragraph">
+<p>After loading and initializing the resources now all cross references in the resources are resolved. For this the
+<code>ErrorAwareLinkingService</code> is used. This class will in turn call the <code>N4JSScopeProvider</code> to first try to do scoping locally
+but eventually also delegate to the global scope provider to find linked elements outside the current resource. This
+will be done e.g. for every import statement inside the N4JS resource.</p>
+</div>
+<div class="paragraph">
+<p>For determine the global scope all visible containers for this resource are calculated. For this the project description
+(= loaded package.json file) is used to determine which folders of the current project should be included for looking for
+N4JS resources. Also all referenced projects and their resources are added to the visible containers. For these containers
+<code>N4JSGlobalScopeProvider</code> builds up a container scope. This container scope will be a <code>N4JSTypesScope</code> instance.</p>
+</div>
+<div class="paragraph">
+<p>For the actual linked element in the resource to be resolved, its fully qualified name is used. This name is calculated by
+using the <code>IQualifiedNameConverter</code>. We bound a custom class named <code>N4JSQualifiedNameConverter</code> who converts the <code>/</code> inside the
+qualified name to a dot, so e.g. <code>my/module/MyFileName</code> is converted to <code>my.module.MyFileName</code>. Btw. the initial qualified name
+was derived from the node model.</p>
+</div>
+<div class="paragraph">
+<p>With this qualified name <code>N4JSTypeScope.getSingleElement</code> is called. This method does the actual resolving of the cross reference.
+For this the URI of the cross reference is used to determine the linked resource.</p>
+</div>
+<div class="paragraph">
+<p>There are now three cases:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>If the resource which contains the linked EObject is already loaded the EObject description found for the URI is returned</p>
+</li>
+<li>
+<p>If the resource is not loaded but the first slot of the resource is empty the referenced type is tried to be rebuild from
+an existing resource description for the linked resource inside the Xtext index.</p>
+</li>
+<li>
+<p>If the resource is not loaded and the first slot is set, the linked EObject will be resolved with the fragment of the
+given URI.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>While calculating the resource description for a <code>N4JSResource</code>, the EObject descriptions of their exported objects have to be
+calculated as well. For this the <code>N4JSResourceDescriptionStrategy</code> is used. For computing the exported objects of a resource only
+the root <code>TModule</code> and its contained types and variables are taken in consideration.</p>
+</div>
+<div class="paragraph">
+<p>The EObjectDescriptions for a n4js resource include:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>An exported representation of the derived <code>TModule</code>. This carries these properties:</p>
+<div class="ulist">
+<ul>
+<li>
+<p>a qualified name (e.g. <code>my.module.MyFileName</code> when the resource is stored under <code>src/my/module/MyFileName.js</code> in the project and
+the project description has marked src has src folder). The calculation of the qualified name is delegated to the <code>N4JSNamingUtil</code>.</p>
+</li>
+<li>
+<p>the user data which is the serialized string of the exported <code>TModule</code> itself. It includes the types determined for this
+resource, so for every element found in this resource, that is contained in an <code>ExportStatement</code>, an EObject has been created
+before in <code>N4JSDerivedStateComputer</code>. In most cases this an EObject extending <code>Type</code> from the types model, e.g. <code>TClass</code> for
+<code>N4ClassDeclaration</code>. There is an exception for <code>ExportedVariableDeclaration</code> where <code>TVariable</code> is used as representative (and this
+EObject is not contained in the types model only in the N4JS model). For usability reasons (quicker quick fix etc.), also
+top level types not exported yet are stored in the <code>TModel</code>.</p>
+</li>
+<li>
+<p>the information on project and vendor id are part of the module descriptor.</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>Descriptions for all top level types that are defined in the resource. These descriptions do not have any special properties,
+so they just have a name.</p>
+</li>
+<li>
+<p>All exported variables are also described in the resource description. They don’t carry any special information either.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>The EObjectDescription for an EObject contained in an <code>ExportStatement</code>:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>the qualified name of the module export (e.g. for a <code>N4ClassDeclaration</code> the qualified name <code>my.module.MyFileName.MyClassName</code> would
+be produced, when the resource is stored under <code>src/my/module/MyFileName.js</code> in the project, the project description has marked
+src has src folder and the N4 class uses the name MyClassName]). The calculation of the qualified name is delegated to the
+<code>N4JSNamingUtil</code>.</p>
+</li>
+<li>
+<p>the EObject represented by the EObject description, here this is not the actual EObject from N4JS but the type EObject from
+the TypeSystem, that has been inferenced by using <code>N4JSTypeInferencer</code></p>
+</li>
+<li>
+<p>the user data is only an empty map for this EObjectDescription</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>With this the resource description for a resource should be fully created / updated. <a href="#fig:cd_SerializeToIndex">Serialize to Index</a>
+shows the classes involved creating the resource and EObjectDescriptions, along with the serialized type information.</p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="sec:N4JS_Resource_Load_States"><a class="anchor" href="#sec:N4JS_Resource_Load_States"></a><a class="link" href="#sec:N4JS_Resource_Load_States">7.3. N4JS Resource Load States</a></h3>
+<div class="paragraph">
+<p>Below state diagram depicts the state transitions when loading and resolving an N4JS resource.</p>
+</div>
+<div class="imageblock center">
+<div class="content">
+<img src="chapters/07_typeindex/images/resource_set_load_states.png" alt="resource set load states">
+</div>
+<div class="title">Figure 14. N4JS Resource resolution states</div>
+</div>
+<div class="paragraph">
+<p>Additionally, the following table relates the values of the resource&#8217;s flags to the states.</p>
+</div>
+<table class="tableblock frame-all grid-all spread">
+<colgroup>
+<col style="width: 11.1111%;">
+<col style="width: 11.1111%;">
+<col style="width: 11.1111%;">
+<col style="width: 11.1111%;">
+<col style="width: 11.1111%;">
+<col style="width: 11.1111%;">
+<col style="width: 11.1111%;">
+<col style="width: 11.1111%;">
+<col style="width: 11.1112%;">
+</colgroup>
+<thead>
+<tr>
+<th class="tableblock halign-left valign-top">State</th>
+<th class="tableblock halign-left valign-top">Parse Result</th>
+<th class="tableblock halign-left valign-top">AST</th>
+<th class="tableblock halign-left valign-top">TModule</th>
+<th class="tableblock halign-left valign-top">ASTMetaInfoCache</th>
+<th class="tableblock halign-left valign-top">loaded</th>
+<th class="tableblock halign-left valign-top">fullyInitialized</th>
+<th class="tableblock halign-left valign-top">fullyProcessed</th>
+<th class="tableblock halign-left valign-top">reconciled</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Created</p></th>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>null</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>null</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>null</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>null</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
+</tr>
+<tr>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Created'</p></th>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>null</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>null</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>null</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>null</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
+</tr>
+<tr>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Loaded</p></th>
+<td class="tableblock halign-left valign-top"><p class="tableblock">available</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">with lazy linking proxies</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>null</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>null</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
+</tr>
+<tr>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Pre-linked</p></th>
+<td class="tableblock halign-left valign-top"><p class="tableblock">available</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">with lazy linking proxies</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">with stubs</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>null</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
+</tr>
+<tr>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Fully Initialized</p></th>
+<td class="tableblock halign-left valign-top"><p class="tableblock">available</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">with lazy linking proxies</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">with DeferredTypeRefs</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>null</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
+</tr>
+<tr>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Fully Processed</p></th>
+<td class="tableblock halign-left valign-top"><p class="tableblock">available</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">available</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">available</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">available</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
+</tr>
+<tr>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Loaded from Description</p></th>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>null</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">proxy</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">available</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>null</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">indeterminate</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
+</tr>
+<tr>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Loaded from Description'</p></th>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>null</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">proxy</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">with DeferredTypeRefs</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>null</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">indeterminate</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
+</tr>
+<tr>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Fully Initialized ®</p></th>
+<td class="tableblock halign-left valign-top"><p class="tableblock">available</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">with lazy linking proxies</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">available</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>null</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">indeterminate</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
+</tr>
+<tr>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Fully Processed ®</p></th>
+<td class="tableblock halign-left valign-top"><p class="tableblock">available</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">available</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">available</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">available</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">indeterminate</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
+</tr>
+</tbody>
+</table>
+<div class="paragraph">
+<p>Remarks:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>oddities are shown in red ink, in the above figure.</p>
+</li>
+<li>
+<p>in the above figure:</p>
+<div class="ulist">
+<ul>
+<li>
+<p>"AST (proxy)" means the AST consists of only a single node of type <code>Script</code> and that is a proxy,</p>
+</li>
+<li>
+<p>"AST (lazy)" means the AST is completely created, but cross-references are represented by unresolved
+Xtext lazy-linking proxies,</p>
+</li>
+<li>
+<p>"TModule (stubs)" means the TModule has been created with incomplete information, e.g. return types of
+all TMethods/TFunctions will be <code>null</code> (only used internally by the incremental builder),</p>
+</li>
+<li>
+<p>"TModule (some deferred)" means the TModule has been created, does not contain stub, but some
+`TypeRef`s are `DeferredTypeRef`s that are supposed to be replaced by proper `TypeRef`s during post-processing.</p>
+</li>
+<li>
+<p>"AST" and "TModule" means the AST/TModule is available without any qualifications.</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>state <strong>Created'</strong>: only required because Xtext does not clear flag <code>fullyInitialized</code> upon unload; that is done lazily
+when <code>#load()</code> is invoked at a later time.. Thus, we do not reach state <strong>Created</strong> when unloading from state
+<strong>Fully Initialized</strong> but instead get to state <strong>Created'</strong>. To reach state <strong>Created</strong> from <strong>Fully Initialized</strong> we have to
+explicitly invoke <code>#discardDerivedState()</code> before(!) unloading.</p>
+</li>
+<li>
+<p>state <strong>Loaded from Description'</strong>: transition <code>#unloadAST()</code> from state <strong>Fully Initialized</strong> leaks a non-post-processed
+TModule into state <strong>Loaded from Description</strong>, which is inconsistent with actually loading a TModule from the index,
+because those are always fully processed. Hence, the addition of state <strong>Loaded from Description'</strong>.</p>
+</li>
+<li>
+<p>states <strong>Fully Initialized ®</strong> and <strong>Fully Processed ®</strong>: these states are reached via reconciliation of a pre-existing
+TModule with a newly loaded AST. These states differ in an unspecified way from their corresponding non-reconciled
+states. For example, in state <strong>Fully Initialized ®</strong> the TModule does not contain any DeferredTypeRefs while, at the
+same time, the TModule isn&#8217;t fully processed, because proxy resolution, typing, etc. have not taken place, yet.</p>
+</li>
+<li>
+<p>TODO old text (clarify this; I could not reproduce this behavior): when <code>unloadAST</code> is called, <code>fullyInitialized</code> remains
+unchanged. This is why the value of <code>fullyInitialized</code> should be indeterminate in row <strong>Loaded from Description</strong>; it
+depends on the previous value if the state <strong>Loaded from Description</strong> was reached by calling <code>unloadAST</code>.</p>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:Type_Builder"><a class="anchor" href="#sec:Type_Builder"></a><a class="link" href="#sec:Type_Builder">7.4. Types Builder</a></h3>
+<div class="paragraph">
+<p>When a resource is loaded, it is parsed, linked, post-processed, validated and eventually compiled. For linking and validation
+type information is needed, and as described above the type information is created automatically when loading a resource using
+the types builder. <a href="#fig:ad_resourceLoading">Resource Loading</a> shows an activity model with the different actions performed when
+a resource is loaded.</p>
+</div>
+<div id="fig:ad_resourceLoading" class="imageblock center">
+<div class="content">
+<img src="chapters/07_typeindex/images/ad_resourceLoading.png" alt="ad resourceLoading">
+</div>
+<div class="title">Figure 15. Activity Diagram, Resource Loading</div>
+</div>
+<div class="paragraph">
+<p>The blue colored steps are standard Xtext workflow. Handling the TModule and storing that in the index are N4 specific (red background).</p>
+</div>
+<div class="sect3">
+<h4 id="sec:Type_Inference_not_allowed_in_Type_Builder"><a class="anchor" href="#sec:Type_Inference_not_allowed_in_Type_Builder"></a><a class="link" href="#sec:Type_Inference_not_allowed_in_Type_Builder">7.4.1. Type Inference not allowed in Types Builder</a></h4>
+<div class="paragraph">
+<p>A crucial point in the workflow described above is the combination of types model building and type inference. In some cases,
+the type of a given element is not directly stated in the AST but has to be inferred from an expression and other types. For
+example, when a variable declaration does not declare the variable’s type explicitly but provides an initializer expression,
+the actual type of the variable is inferred to be the type of the expression.</p>
+</div>
+<div class="paragraph">
+<p>However, the types builder cannot be allowed to use type inference, mainly for two reasons:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>type inference through Xsemantics could lead to resolution of cross-references (i.e. EMF proxies generated by the lazy
+linker) and because the types builder is triggered when getContents() is called on the containing <code>N4JSResource</code> this would
+break a basic contract of EMF resources.</p>
+</li>
+<li>
+<p>type inference could cause other resources to be loaded which would lead to problems (infinite loops or strange results)
+in case of circular dependencies. This is illustrated in <a href="#fig:sd_typesBuilder_problem">Types Builder Problem</a> and
+<a href="#fig:sd_typesBuilder_proxies">Types Builder Proxies</a>.</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>Therefore, whenever the type of a particular element has to be inferred, the types builder will use a special type reference
+called <code>DeferredTypeRef</code> <sup class="footnote">[<a id="_footnoteref_3" class="footnote" href="appendix_e_bibliography_and_footnotes.html#_footnote_3" title="View footnote.">3</a>]</sup>,
+in order to defer the actual type inference to a later stage, i.e. the post-processing stage.</p>
+</div>
+<div id="fig:sd_typesBuilder_problem" class="imageblock center">
+<div class="content">
+<img src="chapters/07_typeindex/images/sd_typesBuilder_problem.png" alt="sd typesBuilder problem">
+</div>
+<div class="title">Figure 16. Sequence Diagram, Types Builder Problem</div>
+</div>
+<div id="fig:sd_typesBuilder_proxies" class="imageblock center">
+<div class="content">
+<img src="chapters/07_typeindex/images/sd_typesBuilder_proxies.png" alt="sd typesBuilder proxies">
+</div>
+<div class="title">Figure 17. Sequence Diagram, Types Builder with Proxies</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:ComputedTypeReferences"><a class="anchor" href="#sec:ComputedTypeReferences"></a><a class="link" href="#sec:ComputedTypeReferences">7.4.2. Deferred Type References</a></h4>
+<div class="paragraph">
+<p>Whenever type inference would be required to obtain the actual type of an element, the types builder will insert a stub to defer
+actual type inference (see previous section). A dedicated subclass of <code>TypeRef</code>, called <code>DeferredTypeRef</code>, is used that contains neither
+the actual type information nor any information necessary to perform the type inference at a later point in time. Later, this
+<code>DeferredTypeRef</code> will be replaced during post-processing, see <code>TypeDeferredProcessor</code>.</p>
+</div>
+<div class="paragraph">
+<p>All <code>DeferredTypeRef</code>s will be replaced by the actual types during post-processing. One important reason for resolving
+all <code>DeferredTypeRef</code>s as early as possible is that they are not suited for serialization and therefore have to be removed
+from the types model before populating the Xtext index, which includes serializing the TModule into the user data of the
+root element. This is always assured by the logic that manages the triggering of the post-processing phase.</p>
+</div>
+<div class="paragraph">
+<p>To manually trigger resolution of all <code>DeferredTypeRef</code>s in a given types model, simply call method <code>performPostProcessing(CancelIndicator)</code>
+of the containing <code>N4JSResource</code> (should never be required by client code such as validations).</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Use_cases_of_ComputedTypeRef"><a class="anchor" href="#sec:Use_cases_of_ComputedTypeRef"></a><a class="link" href="#sec:Use_cases_of_ComputedTypeRef">7.4.3. Use cases of DeferredTypeRef</a></h4>
+<div class="paragraph">
+<p>Currently, <code>DeferredTypeRef</code>s are created by the types builder only in these cases:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>actual type of an exported TVariable if no declared type but an initialization expression are given.</p>
+</li>
+<li>
+<p>actual type of a TField if no declared type but an initialization expression are given.</p>
+</li>
+<li>
+<p>actual type of properties of ObjectLiterals if not declared explicitly.</p>
+</li>
+<li>
+<p>actual type of formal parameters and return value of function expressions if not declared explicitly.</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>Note that this overview might easily get out-dated; see references to class <code>DeferredTypeRef</code> in the code.</p>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:Incremental_Builder_Overview"><a class="anchor" href="#sec:Incremental_Builder_Overview"></a><a class="link" href="#sec:Incremental_Builder_Overview">7.5. Incremental Builder (Overview)</a></h3>
+<div class="paragraph">
+<p>This section provides a brief overview of how the incremental builder works.</p>
+</div>
+<div class="paragraph">
+<p>General remarks:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>The N4JS incremental builder is a combination of Eclipse builder infrastructure, Xtext-specific builder functionality and
+several adjustments for N4JS and N4MF.</p>
+</li>
+<li>
+<p>The <code>IBuilderState</code> implementation is identical to the persisted Xtext index. No matter how many Xtext languages are supported
+by the application, only a single <code>IBuilderState</code> instance is available in the application. Since we have one single <code>IBuilderState</code>,
+we have one single persisted Xtext index throughout the application.</p>
+</li>
+<li>
+<p>For simplicity, the below description assumes we have only N4JS projects in the workspace and no other Xtext languages are
+installed.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Major components:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>XtextBuilder</code> (inherits from Eclipse’s <code>IncrementalProjectBuilder</code>):</p>
+<div class="ulist">
+<ul>
+<li>
+<p>the actual incremental builder</p>
+</li>
+<li>
+<p>note: Eclipse will create one instance of <code>XtextBuilder</code> per project at startup.</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p><code>IBuilderState</code> (Xtext specific; no Eclipse pendant):<br>
+identical to the <code>Xtext index</code>, i.e. the globally shared, persisted instance of<br>
+<code>IResourceDescriptions</code>.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Main workflow:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>for each project  that contains at least one resource that requires rebuilding, Eclipse will call the
+project’s <code>XtextBuilder</code>.</p>
+</li>
+<li>
+<p>each <code>XtextBuilder</code> will perform some preparations and will then delegate to <code>IBuilderState</code> which will iterate over
+all resources in the builder’s project that require rebuilding.</p>
+</li>
+</ol>
+</div>
+<div class="sect3">
+<h4 id="sec:Incremental_Builder_Overview__XtextBuilder"><a class="anchor" href="#sec:Incremental_Builder_Overview__XtextBuilder"></a><a class="link" href="#sec:Incremental_Builder_Overview__XtextBuilder">7.5.1. XtextBuilder</a></h4>
+<div class="paragraph">
+<p>Whenever a change in the workspace happens &#8230;&#8203;</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p><a id="itm:start"></a> Eclipse will collect all projects that contain changed resources and compute a project-level build
+order (using the <code>build order</code> of the workspace, see <code>Workspace#getBuildOrder()</code>, which is based on project dependencies)</p>
+</li>
+<li>
+<p>for the first <sup class="footnote">[<a id="_footnoteref_4" class="footnote" href="appendix_e_bibliography_and_footnotes.html#_footnote_4" title="View footnote.">4</a>]</sup> project with changed resources, Eclipse will invoke
+   method <code>IncrementalProjectBuilder#build(int,Map,IProgressMonitor)</code> of the project’s <code>XtextBuilder</code><br>
+(NOTE: from this point on, we are in the context of a <code>current project</code>)</p>
+</li>
+<li>
+<p>in <code>XtextBuilder#build(int,Map,IProgressMonitor)</code>:<br>
+the builder creates an empty instance of <code>ToBeBuilt</code> (Xtext specific)</p>
+</li>
+<li>
+<p>in <code>XtextBuilder#incrementalBuild(IResourceDelta,IProgressMonitor)</code>:</p>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p>The builder will iterate over all files in the project and for each will notify a <code>ToBeBuiltComputer</code> about the
+change (added, updated, or deleted) which can then decide how to update the <code>ToBeBuilt</code> instance,</p>
+</li>
+<li>
+<p>then forwards to <code>#doBuild()</code> .</p>
+<div class="paragraph">
+<p>Note: if user changes 1..* files in a single project  but later more files in other, dependant projects
+ need to be built, the above step will happen for all projects, but will have an effect only for the first project  that contains the actual file changes (i.e. in the standard case of saving a single file <code>ToBeBuilt</code> will always be non-empty for the <code>first</code> project, and always empty for the other, dependant projects; if a <code>Save All</code> is done, <code>ToBeBuilt</code> could be non-empty for later projects as well).</p>
+</div>
+</li>
+</ol>
+</div>
+</li>
+<li>
+<p>in <code>XtextBuilder#doBuild(ToBeBuilt,IProgressMonitor,BuildType)</code>:</p>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p>first check if <code>ToBeBuilt</code> is empty AND global build queue does not contain URIs for current project &#8594; then abort (nothing to do here)</p>
+</li>
+<li>
+<p>creates instance of BuildData with:</p>
+<div class="olist lowerroman">
+<ol class="lowerroman" type="i">
+<li>
+<p>name of current project (as string)</p>
+</li>
+<li>
+<p>newly created, fresh <code>ResourceSet</code></p>
+</li>
+<li>
+<p>the <code>ToBeBuilt</code> (containing URIs of actually changed resources within current project, possibly filtered by <code>ToBeBuiltComputer</code>)</p>
+</li>
+<li>
+<p>the <code>QueuedBuildData</code> (an injected singleton)</p>
+</li>
+<li>
+<p>mode flag <code>indexingOnly</code> (only true during crash recovery)</p>
+</li>
+</ol>
+</div>
+</li>
+<li>
+<p>invoke <code>IBuilderState</code> passing the <code>BuildData</code><br>
+&#8594; updates itself (it is the global Xtext index) to reflect all changes in <code>current project</code>; validates and updates markers; runs transpiler (see below for details)</p>
+</li>
+<li>
+<p>invoke all registered <code>IXtextBuilderParticipants</code> (Xtext specific) for the <code>current project</code></p>
+<div class="ulist">
+<ul>
+<li>
+<p>this is where normally we would do validation and run the transpiler; however, for performance reasons (do not load resource again) we already do this in the <code>IBuilderState</code> (this is the idea of the <code>GenerateImmediatelyBuilderState</code>)</p>
+</li>
+<li>
+<p>in our implementation, almost nothing is done here, except trivial stuff such as deleting files during clean build</p>
+<div class="paragraph">
+<p>At this point: returning from all methods.</p>
+</div>
+</li>
+</ul>
+</div>
+</li>
+</ol>
+</div>
+</li>
+<li>
+<p>back in <code>XtextBuilder#build(int,Map,IProgressMonitor)</code>:<br>
+&#8594; return with an array of IProjects; in our case: we return all other N4JSProjects referenced in the package.json of the project</p>
+<div class="ulist">
+<ul>
+<li>
+<p>important: these are <strong>not</strong> the projects that will be processed next: we need to continue with projects that depend on the current project, not with projects the current project depends on!</p>
+</li>
+<li>
+<p>Eclipse calls the returned projects <code>interestingProjects</code> and uses that as a hint for further processing; details not discussed here.</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>continue with step <a href="#itm:start">one</a>:<br>
+Eclipse will invoke <code>XtextBuilder#build(int,Map,IProgressMonitor)</code> again for all other projects that have a dependency to the <code>current project</code> of the previous iteration, plus all remaining projects with changed resources.</p>
+</li>
+</ol>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Incremental_Builder_Overview__IBuilderState"><a class="anchor" href="#sec:Incremental_Builder_Overview__IBuilderState"></a><a class="link" href="#sec:Incremental_Builder_Overview__IBuilderState">7.5.2. IBuilderState</a></h4>
+<div class="paragraph">
+<p>Invoked: once for each project containing a changed resource and dependant projects.<br>
+Input: one instance of <code>BuildData</code>, as created by <code>XtextBuilder</code>, containing:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>name of current project (as string)</p>
+</li>
+<li>
+<p>newly created, fresh <code>ResourceSet</code></p>
+</li>
+<li>
+<p>the <code>ToBeBuilt</code></p>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p>set of to-be-deleted URIs</p>
+</li>
+<li>
+<p>set of to-be-updated URIs</p>
+</li>
+</ol>
+</div>
+</li>
+<li>
+<p>the <code>QueuedBuildData</code>, an injected singleton maintaining the following values <sup class="footnote">[<a id="_footnoteref_5" class="footnote" href="appendix_e_bibliography_and_footnotes.html#_footnote_5" title="View footnote.">5</a>]</sup>:</p>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p>a queue of URIs per project (below called the <code>global queue</code>)<br>
+(actually stored in <code>QueuedBuildData#projectNameToChangedResource</code>)</p>
+</li>
+<li>
+<p>a collection of <code>all remaining URIs</code><br>
+(derived value: queued URIs of all projects + queues URIs not associated to a project (does not happen in N4JS))</p>
+</li>
+<li>
+<p>a collection of <code>pending deltas</code> (always empty in N4JS; probably only used for interaction with Java resources)</p>
+</li>
+</ol>
+</div>
+</li>
+<li>
+<p>mode flag <code>indexingOnly</code> (only true during crash recovery)</p>
+</li>
+</ol>
+</div>
+<div class="sect4">
+<h5 id="copy-and-update-xtext-index"><a class="anchor" href="#copy-and-update-xtext-index"></a><a class="link" href="#copy-and-update-xtext-index">7.5.2.1. Copy and Update Xtext Index</a></h5>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>in <code>IBuilderState#update(BuildData,IProgressMonitor)</code>:<br>
+creates a copy of its <code>ResourceDescriptionsData</code> called <code>newData</code> <sup class="footnote">[<a id="_footnoteref_6" class="footnote" href="appendix_e_bibliography_and_footnotes.html#_footnote_6" title="View footnote.">6</a>]</sup></p>
+</li>
+<li>
+<p>in <code>AbstractBuilderState#doUpdate(&#8230;&#8203;)</code>:<br>
+updates <code>newData</code> by writing new resource descriptions into it.</p>
+<div class="ulist">
+<ul>
+<li>
+<p>Creates a new load operation (<code>LoadOperation</code>) instance from the <code>BuildData#getToBeUpdated()</code> and loads all entries. While iterating and loading the resource descriptions, it updates <code>newData</code> by registering new resource descriptions that are being created on the fly from the most recent version of the corresponding resources.</p>
+</li>
+<li>
+<p>Adds these resources to the current project’s build queue. (<code>BuildData#queueURI(URI uri)</code>)</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>for all to-be-deleted URIs given in <code>ToBeBuilt</code> in the <code>BuildData</code>, removes the corresponding <code>IResourceDescription</code> from <code>newData</code></p>
+<div class="ulist">
+<ul>
+<li>
+<p><code>ToBeBuilt#getAndRemoveToBeDeleted()</code> returns all URIs that have been marked for deletion but not marked for update and will clear the set of to-be-deleted URIs in <code>ToBeBuilt</code>.</p>
+</li>
+</ul>
+</div>
+</li>
+</ol>
+</div>
+</div>
+<div class="sect4">
+<h5 id="build-state-setup-phase"><a class="anchor" href="#build-state-setup-phase"></a><a class="link" href="#build-state-setup-phase">7.5.2.2. Build State Setup Phase</a></h5>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Calculates a set <code>allRemainingURIs</code> <sup class="footnote">[<a id="_footnoteref_7" class="footnote" href="appendix_e_bibliography_and_footnotes.html#_footnote_7" title="View footnote.">7</a>]</sup> as follows:</p>
+<div class="ulist">
+<ul>
+<li>
+<p>Initially contains all resource URIs from <code>newData</code>.</p>
+</li>
+<li>
+<p>All URIs will be removed from it that are marked for update (<code>BuildData#getToBeUpdated()</code>).</p>
+</li>
+<li>
+<p>Finally, all URIs will be removed from it that are already queued for build/rebuild. (<code>BuildData#getAllRemainingURIs()</code>).</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>Creates an empty set <code>allDeltas</code> of resource description deltas<br>
+(c.f. <code>IResourceDescription.Delta</code>). <sup class="footnote">[<a id="_footnoteref_8" class="footnote" href="appendix_e_bibliography_and_footnotes.html#_footnote_8" title="View footnote.">8</a>]</sup></p>
+</li>
+<li>
+<p><a id="itm:processDeleted"></a> <strong>Process Deleted:</strong> for all to-be-deleted URIs, creates a delta where the old state is the current state of the resource and the new state is <code>null</code> and adds it to <code>allDeltas</code>.</p>
+</li>
+<li>
+<p>Adds all <code>pending deltas</code> from <code>QueuedBuildData</code> to <code>allDeltas</code> (does not apply to N4JS).</p>
+</li>
+<li>
+<p><strong><a id="itm:enqueueAffectedResources"></a>Enqueue affected resources, part 1:</strong> adds to the <code>global queue</code> the URIs of all resources affected by the changes in <code>allDeltas</code>.</p>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title=""></i>
+</td>
+<td class="content">
+For N4JS, <code>allDeltas</code> always seems to be empty at this point, so this does nothing at all.
+</td>
+</tr>
+</table>
+</div>
+</li>
+<li>
+<p>Creates an empty set <code>changedDeltas</code> for storing deltas that were modified by the build phase and represent an actual change. Unlike <code>allDeltas</code>, this set contains only those URIs that were processed by the builder - the underlying user data information contains the differences between the old and the new state.</p>
+</li>
+<li>
+<p>Creates a new <code>current queue</code> and adds all URIs from the <code>global queue</code> that belong to the <code>current project</code>.</p>
+</li>
+</ol>
+</div>
+</div>
+<div class="sect4">
+<h5 id="process-queued-uris"><a class="anchor" href="#process-queued-uris"></a><a class="link" href="#process-queued-uris">7.5.2.3. Process Queued URIs</a></h5>
+<div class="paragraph">
+<p>Processes all elements from the queue until it contains no more elements.</p>
+</div>
+<div id="itm:loadRes" class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Load the resource for the first/next URI on the current queue</p>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title=""></i>
+</td>
+<td class="content">
+In case of a move, the loaded resource could have a different URI!
+</td>
+</tr>
+</table>
+</div>
+</li>
+<li>
+<p>Once the resource has been loaded, it removes its URI from the current queue to ensure it will not be processed again.</p>
+</li>
+<li>
+<p>If the loaded resource is already marked for deletion, stop processing this resource and continue with next URI from the current queue (go to step <a href="#itm:loadRes">Load Res</a>)
+<sup class="footnote">[<a id="_footnoteref_9" class="footnote" href="appendix_e_bibliography_and_footnotes.html#_footnote_9" title="View footnote.">9</a>]</sup></p>
+</li>
+<li>
+<p>Resolves all lazy cross references in the loaded resource. This will trigger post-processing, including all type inference (c.f. <code>ASTProcessor#processAST(&#8230;&#8203;)</code>).</p>
+</li>
+<li>
+<p>Creates a delta for the loaded resource, including</p>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p>a resource description based on the new state of the resource, wrapped into the <code>EObject</code>-based resource description (as with the Xtext index persistence in <code>EMFBasedPersister#saveToResource()</code>).</p>
+</li>
+<li>
+<p>a resource description for the same resource with the state before the build process.</p>
+</li>
+</ol>
+</div>
+</li>
+<li>
+<p>Adds this new delta to <code>allDeltas</code> and, if the delta represents a change (according to <code>DefaultResourceDescriptionDelta#internalHasChanges()</code>), also adds it to <code>changedDeltas</code>.</p>
+</li>
+<li>
+<p>Adds the resource description representing the new state, stored in the delta, to <code>newData</code>, i.e. the copied <code>ResourceDescriptionsData</code>, replacing the old resource description of the loaded resource <sup class="footnote">[<a id="_footnoteref_10" class="footnote" href="appendix_e_bibliography_and_footnotes.html#_footnote_10" title="View footnote.">10</a>]</sup>.</p>
+</li>
+<li>
+<p>If the current queue is non-empty, go to step <a href="#itm:loadRes">Load Res</a> and continue with the next URI in the current queue.</p>
+</li>
+</ol>
+</div>
+</div>
+<div class="sect4">
+<h5 id="queueing-affected-resources"><a class="anchor" href="#queueing-affected-resources"></a><a class="link" href="#queueing-affected-resources">7.5.2.4. Queueing Affected Resources</a></h5>
+<div class="paragraph">
+<p>When the current queue contains no more URIs (all have been processed) &#8230;&#8203;</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p><a id="itm:updateGlobalQueue"></a> <strong>Enqueue affected resources, part 2:</strong> add to the global queue URIs for all resources affected by the changes in <code>changedDeltas</code> <sup class="footnote">[<a id="_footnoteref_11" class="footnote" href="appendix_e_bibliography_and_footnotes.html#_footnote_11" title="View footnote.">11</a>]</sup>.</p>
+</li>
+<li>
+<p>Returns from <code>#doUpdate()</code>, returning <code>allDeltas</code> (only used for event notification).</p>
+</li>
+<li>
+<p>back in <code>IBuilderState#update(BuildData,IProgressMonitor)</code>:<br>
+makes the <code>newData</code> the publicly visible, persistent state of the IBuilderState (i.e. the <code>official</code> Xtext index all other code will see).</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>We now provide some more details on how the global queue is being updated, i.e. steps <a href="#itm:enqueueAffectedResources">Enqueue Affected Resources</a> and <a href="#itm:updateGlobalQueue">Update Global Queue</a>.
+Due to the language specific customizations for N4JS, this second resource-enqueuing phase is the trickiest part of the incremental building process and has the largest impact on how other resources will be processed and enqueued at forthcoming builder state phases.</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>If <code>allDeltas</code> is empty, nothing to do.</p>
+</li>
+<li>
+<p>If <code>allDeltas</code> contains at least one element, we have to check other affected resources by going through the set of all resource URIs (<code>allRemainingURIs</code>) calculated in in the beginning of the build process.</p>
+</li>
+<li>
+<p>Assume we have at least one element in the <code>allDeltas</code> set, the latter case is true and we must check all elements whether they are affected or not. We simply iterate through the <code>allRemainingURIs</code> set and retrieve the old state of the resource description using the resource URI.</p>
+</li>
+<li>
+<p>Once the resource description with the old state is retrieved, we check if it is affected through the corresponding resource description manager. Since we currently support two languages, we have two different ways for checking whether a resource has changed or not. One for package.json files and the other for the N4JS language related resources.</p>
+</li>
+<li>
+<p>The package.json method is the following: get all project IDs referenced from the <code>candidate</code> package.json and compare it with the container-project name of the package.json files from the <code>deltas</code>. The referenced IDs are the followings:</p>
+<div class="ulist">
+<ul>
+<li>
+<p>tested project IDs,</p>
+</li>
+<li>
+<p>implemented project IDs,</p>
+</li>
+<li>
+<p>dependency project IDs,</p>
+</li>
+<li>
+<p>provided runtime library IDs,</p>
+</li>
+<li>
+<p>required runtime library IDs and</p>
+</li>
+<li>
+<p>extended runtime environment ID.</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>The N4JS method is the following:</p>
+<div class="ulist">
+<ul>
+<li>
+<p>We consider only those changed deltas which represent an actual change (<code>IResourceDescription.Delta#haveEObjectDescriptionsChanged()</code>) and have a valid file extension (<code>.n4js</code>, <code>.n4jsd</code> or <code>.js</code>).</p>
+</li>
+<li>
+<p>For each <code>candidate</code>, we calculate the imported FQNs. The imported FQNs includes indirectly imported names besides the directly imported ones. Indirectly imported FQNs are, for instance, the FQNs of all transitively extended super class names of a direct reference.</p>
+</li>
+<li>
+<p>We state that a <code>candidate</code> is affected if there is a dependency (for example name imported by a <code>candidate</code>) to any name exported by the description from a delta. That is, it computes if a candidate (with given <code>importedNames</code>) is affected by a change represented by the description from the delta.</p>
+</li>
+<li>
+<p>If a <code>candidate</code> is affected we have to do an additional dependency check due to the lack of distinct unique FQNs. If a project containing the delta equals with the project contained by the candidate, or if the project containing the candidate has a direct dependency to the project containing the delta, we mark a candidate as affected.</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>If a candidate was marked as affected, it will be removed from the <code>allRemainingURIs</code> and will be added to the build queue.</p>
+</li>
+<li>
+<p>If a candidate has been removed from the <code>allRemainingURIs</code> and queued for the build, we assume its <code>TModule</code> information stored in the user data is obsolete. To invalidate the obsolete information, we wrap the delta in the custom resource description delta so whenever the <code>TModule</code> information is asked for, it will be missing. We then register this wrapped delta into the copied Xtext index, end the builder state for the actual project then invoke the Xtext builder with the next dependent project.</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Incremental_Builder_Overview__Example"><a class="anchor" href="#sec:Incremental_Builder_Overview__Example"></a><a class="link" href="#sec:Incremental_Builder_Overview__Example">7.5.3. Example</a></h4>
+<div class="paragraph">
+<p>To conclude this section, we briefly describe the state of the above five phases through a simple example. Assume a
+workspace with four N4JS projects: <em>P1</em>, <em>P2</em>, <em>P3</em> and <em>PX</em>. Each project has one single module with one single
+publicly visible class. Also let’s assume project <em>P2</em> depends on <em>P1</em> and <em>P3</em> depends on <em>P2</em>. Project <em>PX</em> have
+no dependencies to other projects. Project <em>P1</em> has a module <em>A.n4js</em> with a class <code>A</code>, project <em>P2</em> has one single
+module <em>B.n4js</em>. This module has a public exported class <code>B</code> which extends class <code>A</code>. Furthermore, project <em>P3</em> has
+one single module: <em>C.n4js</em>. This module contains one exported public class <code>C</code> which extends <code>B</code>. Finally, project
+<em>PX</em> has a module <em>X.n4js</em> containing a class <code>X</code> that has no dependencies to any other classes. The figure below
+picture depicts the dependencies between the projects, the modules and the classes as described above.</p>
+</div>
+<div class="imageblock center">
+<div class="content">
+<img src="chapters/07_typeindex/images/builderStateExample.png" alt="builderStateExample">
+</div>
+<div class="title">Figure 18. Builder State Example</div>
+</div>
+<div class="paragraph">
+<p>For the sake of simplification, the table below describes a symbol table for all resources:</p>
+</div>
+<table class="tableblock frame-all grid-all spread">
+<caption class="title">Table 3. Resource Symbol Table</caption>
+<colgroup>
+<col style="width: 50%;">
+<col style="width: 50%;">
+</colgroup>
+<tbody>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">P1/src/A.n4js</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">A</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">P2/src/B.n4js</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">B</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">P3/src/C.n4js</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">C</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">PX/src/X.n4js</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">X</p></td>
+</tr>
+</tbody>
+</table>
+<div class="paragraph">
+<p>Let assume auto-build is enabled and the workspace contains no errors and/or warnings. We make one simple modification
+and expect one single validation error in class <code>C</code> after the incremental builder finished its processing; we delete the
+method <code>foo()</code> from class <code>A</code>.</p>
+</div>
+<div class="paragraph">
+<p>After deleting the method in the editor and saving the editor content, a workspace modification operation will run and
+that will trigger an auto-build job. The auto-build job will try to build the container project <em>P1</em> of module <em>A</em>. Since
+the project is configured with the Xtext builder command, a builder state update will be performed through the Xtext builder.
+Initially, due to an Eclipse resource change event (we literally modify the resource from the editor and save it), the
+<code>ToBeBuilt</code> instance wrapped into the <code>BuildData</code> will contain the URI of the module <em>A</em> marked for an update. When updating
+the copied index content, module <em>A</em> will be queued for a build. While processing the queued elements for project <em>P1</em>,
+module <em>A</em> will be processed and will be added to the <code>allDeltas</code> set. Besides that, it will be added to the <code>changedDeltas</code>
+set as well. That is correct, because its <code>TModule</code> information has been changed after deleting the public <code>foo()</code> method.
+When queuing affected resources, iterating through the set of <code>allRemainingURIs</code>, we recognize that module <em>B</em> is affected.
+That is indeed true; module <em>B</em> imports the qualified name of class <code>A</code> from module <em>A</em> and project <em>P2</em> has a direct
+dependency to <em>P1</em>. In this builder state phase, when building project <em>P1</em>, module <em>C</em> is not considered as affected.
+Although class <code>C</code> from module <em>C</em> also imports the qualified name of class <code>A</code> from module <em>A</em>, project <em>P3</em> does not
+have a direct dependency to project <em>P1</em>. When module <em>B</em> becomes enqueued for a forthcoming build phase, we assume its
+<code>TModule</code> information is obsolete. We invalidate this <code>TModule</code> related user data information on the resource description
+by wrapping the resource description into a custom implementation (<code>ResourceDescriptionWithoutModuleUserData</code>). Due to this
+wrapping the resource description for module <em>B</em> will be marked as changed (<code>IResourceDescription.Delta#haveEObjectDescriptionsChanged()</code>)
+whenever the old and current states are being compared.</p>
+</div>
+<div class="paragraph">
+<p>The Eclipse builder will recognize (via <code>IProjectDescription#getDynamicReferences()</code>) that project <em>P2</em> depends on project <em>P1</em>
+so the Xtext builder will run for project <em>P2</em> as well. At the previous phase we have enqueued module <em>B</em> for the build.
+We will therefore run into a builder state update again. We do not have any resource changes this time, so <code>ToBeBuilt</code> will
+be empty. Since <code>ToBeBuilt</code> is empty, we do not have to update the copied Xtext index state before the builder state setup
+phase. As the result of the previous builder state, phase module <em>B</em> is already enqueued for a build. When processing <em>B</em>
+we register it into the <code>allDeltas</code> set. That happens for each resource being processed by the builder state. But it will be
+registered into the <code>changedDeltas</code> because we have previously wrapped module <em>B</em> into a customized resource description delta
+to hide its obsolete <code>TModule</code> related user data information. Based on the builder state rules and logic described above,
+module <em>C</em> will be marked as an affected resource, will be queued for build and will be wrapped into a customized resource
+description delta to hide its <code>TModule</code> related user data information.</p>
+</div>
+<div class="paragraph">
+<p>In the next builder state phase, when building project <em>P3</em>, we apply the same logic as we applied for project <em>P2</em>. The
+builder state will process module <em>C</em> and will update the Xtext index state. No additional resources will be found as
+affected ones, nothing will be queued for build. The build will terminate, since there were no changed <code>IResource</code> instances
+and the build queue is empty.</p>
+</div>
+<div class="paragraph">
+<p>The outcome of the incremental build will be a workspace that contains exactly one validation error. The error will be
+associated with module <em>C</em> which was exactly our expectation, however, we have to clarify that transitive <em>C</em> dependency
+was built due to wrong reasons. Module <em>C</em> was build because we wrapped module <em>B</em> to hide its user data information and
+not because it imports and uses class <code>A</code> from module <em>A</em> which should be the logical and correct reason.</p>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="dirty-state-handling"><a class="anchor" href="#dirty-state-handling"></a><a class="link" href="#dirty-state-handling">7.6. Dirty state handling</a></h3>
+<div class="paragraph">
+<p>When two or more (N4)JS files are opened in editors and one of them is changed but without persisting this change the other
+open editors should be notified and if this change breaks (or heals) references in one of the other open resources their editors
+should updated so that warn and error markers are removed or added accordingly.</p>
+</div>
+<div class="paragraph">
+<p>When there are changes in the currently open editor these changes are propagated to all other open editors. Each Xtext editor has
+got its own resource set. The <code>N4JSUpdateEditorStateJob</code> runs for each open editor different from the editor where the changes have
+been made. In those editors the affected resources are unloaded and removed from the resource set. Then the Xtext resource of
+these editors is reparsed. After reparsing scoping and linking is invoked again, but now the references resources are rebuild
+as <code>EObjectDescription</code>s. The <code>N4JSResource</code> holds its own content that only contains 1..n slots when proxified.
+<code>N4JSTypeScope.getSingleElement</code> (called when resolving cross references and the linked element should be returned) will return the
+<code>EObjectDescription</code> created from the <code>ModuleAwareContentsList</code> in <code>N4JSResource</code>, that contains the first slot as proxy and the other
+slots as types. <a href="#fig:dirty_state_handling1">Sequence Diagram: Dirty State, Trigger <code>N4JSUpdateEditorStateJob</code></a> shows the flow to trigger the <code>N4JSUpdateEditorStateJob</code> and <a href="#fig:dirty_state_handling2">Sequence Diagram: Dirty State, <code>N4JSUpdateEditorStateJob</code> in Detail</a>
+shows the sequence logic of the <code>N4JSUpdateEditorStateJob</code> in detail.</p>
+</div>
+<div id="fig:dirty_state_handling1" class="imageblock center">
+<div class="content">
+<img src="chapters/07_typeindex/images/dirty_state_handling1.png" alt="dirty state handling1">
+</div>
+<div class="title">Figure 19. Sequence Diagram: Dirty State, Trigger <code>N4JSUpdateEditorStateJob</code></div>
+</div>
+<div id="fig:dirty_state_handling2" class="imageblock center">
+<div class="content">
+<img src="chapters/07_typeindex/images/dirty_state_handling2.png" alt="dirty state handling2">
+</div>
+<div class="title">Figure 20. Sequence Diagram: Dirty State, <code>N4JSUpdateEditorStateJob</code> in Detail</div>
+</div>
+<div class="paragraph">
+<p>A concrete example should illustrate the behaviour of the dirty state handling in conjunction with fully and partial loading
+of resources:</p>
+</div>
+<div class="paragraph">
+<p>Let A.js as above, and B.js as follows:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">import A from "A.js"
+export class B {}</code></pre>
+</div>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>assume  is opened and loaded:  is created with</p>
+<div class="ulist">
+<ul>
+<li>
+<p>is filled with a special proxy to resolve the <a href="appendix_d_acronyms.html#AC">AST</a> of A only if needed.</p>
+</li>
+<li>
+<p>will be set to type A, loaded from <code>EObjectDescription</code> of A.js/A</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p><a href="appendix_d_acronyms.html#AC">AST</a> of A.js is to be accessed, e.g., for displaying JSDoc. A.js is not opened in an editor!  is modified as follows:</p>
+<div class="ulist">
+<ul>
+<li>
+<p>is filled with <a href="appendix_d_acronyms.html#AC">AST</a>, i.e. proxy in 0 is resolved</p>
+</li>
+<li>
+<p>is updated with parsed type: 1) proxify , 2) unload  (remove from content), 3) reload with parsed types again</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>Assume now that A.js is opened and edited by the user.</p>
+<div class="ulist">
+<ul>
+<li>
+<p>Reconceiler replaces  with modified <a href="appendix_d_acronyms.html#AC">AST</a></p>
+</li>
+<li>
+<p>LazyLinker updates </p>
+</li>
+<li>
+<p>is proxified</p>
+</li>
+<li>
+<p>B <code>searches</code> for A and finds updated </p>
+</li>
+</ul>
+</div>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p><em>Each opened Xtext editor has got its own resource set!</em> Such a resource set contains the resource for the currently edited
+file in the first place. When starting editing the file, the resource is reparsed , reloaded and linking (resolving the cross
+references) is done. By resolving the cross references <code>N4JSTypeScope</code> is used and now the URIs of the linked elements are belonging
+to resources not contained in the resource set of the editor so these resources a create in the resource set and their contents
+is loaded from the resource descriptions via
+<code>N4JSResource.loadFromDescription</code> .</p>
+</div>
+<div class="paragraph">
+<p>When the resource content is loaded from the existing resource description available from Xtext index the first slot is set to be
+a proxy with name <code>#:astProxy</code>.
+After that for all exported EObject descriptions of that resource description the user data is fetched and deserialized to types
+and these types are added to the slots of the resource in order they were exported. But the order is not that important anymore.</p>
+</div>
+<div class="paragraph">
+<p>As the resource set for the editor is configured to use the DirtyStateManager ( <code>ExternalContentSupport.configureResourceSet(resourceSet, dirtyStateManager)</code> ),
+all other open editors will be notified by changes in the current editor. This is done by <code>N4JSDirtyStateEditorSupport</code> that schedules
+a <code>N4JSUpdateEditorStateJob</code> that create a new resource description change event.</p>
+</div>
+<div class="paragraph">
+<p>Via <code>isAffected</code> and <code>ResourceDescription.getImportedNames</code> it is determine if a change in another resource affects this resource.</p>
+</div>
+<div class="paragraph">
+<p>Before loading the resource always <code>N4JSDerivedStateComputer.installDerivedState</code> is execute that, as we learned earlier, is responsible
+for creating the types in the resource.</p>
+</div>
+<div class="paragraph">
+<p>On every change to a N4JS file that requires a reparse the <code>N4JSDerivedStateComputer.discardDerivedState</code> is executed. This method do an
+unload on every root element at the positions 1 to n. In the <code>N4JSUnloader</code> all contents of the this root elements are proxified (i.e.
+there is a proxy URI set to each of them) and the references to the <a href="appendix_d_acronyms.html#AC">AST</a> are set to null (to avoid notifications causing
+concurrent model changes). The proxification indicates for all callers of these elements, that they have to reload them. Afterwards
+it discards the complete content of the resource. The content is build up again with the reparse of the N4JS file content.</p>
+</div>
+<div class="paragraph">
+<p>As each editor has its own resource set, only the resource belonging to the current editor is fully loaded. All other referenced
+resources are only partially loaded, i.e. only the slot 1 of these resources are loaded (i.e. the types model elements) in this
+resource set. Linking is done only against these types model elements. Synchronization between the resource sets of multiple open
+editors is done via update job as described above.</p>
+</div>
+<div class="sect3">
+<h4 id="use-case-restoring-types-from-user-data"><a class="anchor" href="#use-case-restoring-types-from-user-data"></a><a class="link" href="#use-case-restoring-types-from-user-data">7.6.1. Use case: Restoring types from user data</a></h4>
+<div class="ulist">
+<ul>
+<li>
+<p>Use case: referencing resources in editor: This has been described already in context of dirty state handling</p>
+</li>
+<li>
+<p>Use case: referencing resources from JAR: This is still to be implemented.% taskIDE-37</p>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect3">
+<h4 id="use-case-updating-the-xtext-index"><a class="anchor" href="#use-case-updating-the-xtext-index"></a><a class="link" href="#use-case-updating-the-xtext-index">7.6.2. Use case: Updating the Xtext index</a></h4>
+<div class="paragraph">
+<p>When a N4JS file is changed in way that requires reparsing the file, the underlying resource is completely unloaded and loaded again.
+By this the also the elements at the Xtext index are recreated again, belonging to this resource (i.e. new entries for new elements
+in the resource, update index elements of changed elements, delete index entries for deleted elements).</p>
+</div>
+<div class="paragraph">
+<p>When Eclipse is closed the Xtext index is serialized in a file.</p>
+</div>
+<div class="imageblock center">
+<div class="content">
+<img src="chapters/07_typeindex/images/index_serialization.png" alt="index serialization">
+</div>
+</div>
+<div class="paragraph">
+<p>When starting Eclipse again, the Xtext index is restored from this file:</p>
+</div>
+<div class="imageblock center">
+<div class="content">
+<img src="chapters/07_typeindex/images/loading_existing_index.png" alt="loading existing index">
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div id="footer">
+<div id="footer-text">
+Version 0.9<br>
+Last updated 2019-08-07 15:02:40 CEST
+</div>
+</div>
+<!-- ************* docinfo-footer *************************************************************** -->
+<div class="Grid social" style="color:#d5dfea">
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <h2>Quick Links</h2>
+    <ul>
+      <li><a href="../downloads.html">Download</a></li>
+      <li><a href="../userguides/index.html">Documentation</a></li>
+      <li><a href="https://github.com/eclipse/n4js/">Source</a></li>
+      <li><a href="https://github.com/eclipse/n4js/issues">Issues</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="https://www.eclipse.org/forums/index.php/f/365/">Forum</a></li>
+      <li><a href="http://n4js.blogspot.de/">Blog</a></li>
+      <li><a href="https://dev.eclipse.org/mailman/listinfo/n4js-dev">Mailing List</a></li>
+      <li><a href="https://projects.eclipse.org/projects/technology.n4js">Eclipse Project Page</a></li>
+      <li><a href="https://twitter.com/n4jsdev">Tweets by n4jsdev</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="http://www.eclipse.org/">Eclipse Home</a></li>
+      <li><a href="http://www.eclipse.org/legal/privacy.php">Privacy Policy</a></li>
+      <li><a href="http://www.eclipse.org/legal/termsofuse.php">Terms of Use</a></li>
+      <li><a href="http://www.eclipse.org/legal/copyright.php">Copyright Agent</a></li>
+      <li><a href="http://www.eclipse.org/legal/">Legal</a></li>
+    </ul>
+  </div>
+  <div style="clear: both; height: 0; overflow: hidden;"></div>
+</div>
+
+<!-- ************* UI Scripts ************* -->
+<script type="text/javascript" src="scripts/back-to-top.js"></script>
+
+<script type="text/javascript" src="scripts/treeview.js"></script>
+<script type="text/javascript" src="scripts/toc.js"></script>
+
+<!-- ************* Prism.js Syntax Highlighting ************* -->
+<script src="scripts/prism.js"></script>
+
+<script type="text/javascript">
+	// Add the 'toclist' id for search function
+	$(".toc2 > ul").attr('id', 'toclist');
+	// Generate a Search input form
+	$("#toclist > li:first-of-type").before('<input type="text" id="pagesearch" onkeyup="search()" placeholder="Search for section...">');
+	$("#toclist > li:first-of-type").before('<i id="clear" class="fa fa-times-circle-o"></i>');
+	$("#clear").click(function(){
+	    $("#pagesearch").val('');
+	    search();
+	    $('.toc2 > ul').treeView('collapseAll');
+	});
+	// intialize Treeview.js
+	$(".toc2 > ul").treeView();
+	// Initialize Scrollspy
+</script>
+<!-- ************* docinfo-footer *************************************************************** -->
+</body>
+</html>
\ No newline at end of file
diff --git a/design/type_system.html b/design/type_system.html
new file mode 100644
index 0000000..643f3ad
--- /dev/null
+++ b/design/type_system.html
@@ -0,0 +1,1531 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="generator" content="Asciidoctor 1.5.5">
+<meta name="author" content="2019-08-07 15:02:40 CEST">
+<title>N4JS Design Specification</title>
+<link rel="stylesheet" href="styles/spec.min.css">
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.6.3/css/font-awesome.min.css">
+<!-- ************* docinfo ******************************************************************* -->
+
+
+<!-- ************* Favicon ************-->
+<link rel="icon" href="images/favicon.ico" />
+
+<!-- ************* Back-to-top JQuery ************* -->
+<script src="https://code.jquery.com/jquery-1.12.4.js"></script>
+<script src="https://code.jquery.com/ui/1.12.0/jquery-ui.js"></script>
+
+
+<link href="styles/prism.min.css" rel="stylesheet" />
+<script type="text/javascript" async
+  src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2/MathJax.js?config=TeX-MML-AM_CHTML">
+</script>
+
+<!-- ************* Styles ************* -->
+<link rel="stylesheet" type="text/css" href="styles/n4jsspec-adoc.css">
+
+
+<!-- ****************** NavBar ****************** -->
+<div id="menubar">
+	<div class="banner">
+        <a href="https://www.eclipse.org/n4js/#"><img id="logo" src="images/n4js-logo.png" alt="Eclipse N4JS"></a>
+    </div>
+<ul>
+  <li><a href="index.html">Index</a></li>
+</ul>
+</div>
+<!-- ************* docinfo ******************************************************************* -->
+<style>
+      .admonitionblock td.icon .icon-todo:before{content:"\f249";color:#f4ee42}
+    </style>
+</head>
+<body class="book toc2 toc-left">
+<div id="header">
+<h1>N4JS Design Specification</h1>
+<div class="details">
+<span id="author" class="author">2019-08-07 15:02:40 CEST</span><br>
+<span id="revnumber">version 0.9</span>
+</div>
+<div id="toc" class="toc2">
+<div id="toctitle">Table of Contents</div>
+<ul class="sectlevel1">
+<li><a href="introduction.html#_introduction">1. Introduction</a>
+<ul class="sectlevel2">
+<li><a href="introduction.html#notation">1.1. Notation</a></li>
+<li><a href="introduction.html#sec:IDE_Overview">1.2. IDE Components</a>
+<ul class="sectlevel3">
+<li><a href="introduction.html#sec:Naming_Conventions">1.2.1. Naming Conventions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="eclipse_setup.html#_eclipse-setup">2. Eclipse Setup</a>
+<ul class="sectlevel2">
+<li><a href="eclipse_setup.html#_system-requirements">2.1. System Requirements</a></li>
+<li><a href="eclipse_setup.html#_contribute">2.2. Contribute</a>
+<ul class="sectlevel3">
+<li><a href="eclipse_setup.html#_eclipse-installer">2.2.1. Eclipse Installer</a>
+<ul class="sectlevel4">
+<li><a href="eclipse_setup.html#_changing-the-setup-script">2.2.1.1. Changing the Setup Script</a></li>
+</ul>
+</li>
+<li><a href="eclipse_setup.html#_manual-ide-configuration">2.2.2. Manual IDE Configuration</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="release_engineering.html#_release-engineering">3. Release Engineering</a>
+<ul class="sectlevel2">
+<li><a href="release_engineering.html#_nightly-build-on-eclipse-infrastructure">3.1. Nightly build on Eclipse infrastructure</a></li>
+<li><a href="release_engineering.html#_build-the-n4js-ide-from-command-line">3.2. Build the N4JS IDE from command line</a>
+<ul class="sectlevel3">
+<li><a href="release_engineering.html#_publish-maven-tooling-code-org-eclipse-n4js-releng-util-code">3.2.1. Publish maven-tooling <code>org.eclipse.n4js.releng.util</code></a></li>
+<li><a href="release_engineering.html#sec:test-verdaccio">3.2.2. Test Verdaccio containing n4js-libs</a></li>
+<li><a href="release_engineering.html#_generation-of-eclipse-help-for-spec-and-design-document">3.2.3. Generation of Eclipse help for spec and design document</a></li>
+</ul>
+</li>
+<li><a href="release_engineering.html#_updating-frameworks-and-dependencies">3.3. Updating frameworks and dependencies</a>
+<ul class="sectlevel3">
+<li><a href="release_engineering.html#_update-of-eclipse-emf-xtext-etc">3.3.1. Update of Eclipse, EMF, Xtext, etc.</a></li>
+<li><a href="release_engineering.html#_update-of-the-embedded-jre">3.3.2. Update of the embedded JRE</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tips_and_tricks.html#_tips-and-tricks">4. Tips and Tricks</a>
+<ul class="sectlevel2">
+<li><a href="tips_and_tricks.html#_naming">4.1. Naming</a></li>
+<li><a href="tips_and_tricks.html#_logging">4.2. Logging</a></li>
+<li><a href="tips_and_tricks.html#_cancellation-handling">4.3. Cancellation Handling</a></li>
+<li><a href="tips_and_tricks.html#_caching">4.4. Caching</a></li>
+<li><a href="tips_and_tricks.html#_dependency-injection">4.5. Dependency Injection</a></li>
+<li><a href="tips_and_tricks.html#_miscellaneous">4.6. Miscellaneous</a></li>
+</ul>
+</li>
+<li><a href="parser.html#_parser">5. Parser</a>
+<ul class="sectlevel2">
+<li><a href="parser.html#sec:Parser_Overview">5.1. Overview</a></li>
+<li><a href="parser.html#sec:N4JS_Parser">5.2. N4JS Parser</a></li>
+<li><a href="parser.html#sec:Parser_Generation_Post_Processing">5.3. Parser Generation Post-Processing</a>
+<ul class="sectlevel3">
+<li><a href="parser.html#sec:Automatic_Semicolon_Insertion">5.3.1. Automatic Semicolon Insertion</a>
+<ul class="sectlevel4">
+<li><a href="parser.html#sec:Injected_code_in_the_Antlr_grammar_file">5.3.1.1. Injected code in the Antlr grammar file</a></li>
+<li><a href="parser.html#sec:Customized_error_recovery">5.3.1.2. Customized error recovery</a></li>
+</ul>
+</li>
+<li><a href="parser.html#sec:_No_line_terminator_allowed_here__handling">5.3.2. Async and <code>No line terminator allowed here</code> Handling</a></li>
+<li><a href="parser.html#sec:Regular_Expression">5.3.3. Regular Expression</a></li>
+<li><a href="parser.html#sec:Unicode">5.3.4. Unicode</a></li>
+<li><a href="parser.html#sec:Literals">5.3.5. Literals</a></li>
+</ul>
+</li>
+<li><a href="parser.html#sec:Modifiers">5.4. Modifiers</a></li>
+<li><a href="parser.html#sec:Conflict_Resolutions">5.5. Conflict Resolutions</a>
+<ul class="sectlevel3">
+<li><a href="parser.html#sec:Reserved_Keywords_vs__Identifier_Names">5.5.1. Reserved Keywords vs. Identifier Names</a></li>
+<li><a href="parser.html#sec:Operators_and_Generics">5.5.2. Operators and Generics</a></li>
+</ul>
+</li>
+<li><a href="parser.html#sec:Content_Assist_Parser">5.6. Content-Assist Parser</a></li>
+</ul>
+</li>
+<li><a href="#_type-system">6. Type System</a>
+<ul class="sectlevel2">
+<li><a href="#sec:Type_Model_and_Grammar">6.1. Type Model and Grammar</a>
+<ul class="sectlevel3">
+<li><a href="#sec:Type_Model_Overview">6.1.1. Type Model Overview</a></li>
+<li><a href="#sec:Built_in_Types">6.1.2. Built-in and Primitive Types</a></li>
+<li><a href="#sec:Type_Model_DSL">6.1.3. Type Model DSL</a></li>
+</ul>
+</li>
+<li><a href="#sec:Type_System_Implementation">6.2. Type System Implementation</a></li>
+<li><a href="#sec:Type_Inference_combined_with_AST_Traversal">6.3. Type Inference of AST</a>
+<ul class="sectlevel3">
+<li><a href="#sec:Type_Inference_combined_with_AST_Traversal__Background">6.3.1. Background</a></li>
+<li><a href="#sec:Triggering_Type_Inference_of_AST">6.3.2. Triggering</a></li>
+<li><a href="#sec:Traversal_Order_During_Type_Inference_of_AST">6.3.3. Traversal Order</a></li>
+<li><a href="#sec:Cross_References_During_Type_Inference_of_AST">6.3.4. Cross-References</a></li>
+<li><a href="#sec:Function_Accessor_Bodies_During_Type_Inference_of_AST">6.3.5. Function/Accessor Bodies</a></li>
+<li><a href="#sec:Poly_Expressions_During_Type_Inference_of_AST">6.3.6. Poly Expressions</a></li>
+<li><a href="#sec:Constraint_Solver_used_During_Type_Inference_of_AST">6.3.7. Constraint Solver</a></li>
+<li><a href="#sec:Type_Guards_During_Type_Inference_of_AST">6.3.8. Type Guards</a></li>
+</ul>
+</li>
+<li><a href="#sec:Structural_Typing">6.4. Structural Typing</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#_type-index">7. Type Index</a>
+<ul class="sectlevel2">
+<li><a href="type_index.html#sec:Type_Index_Design_Rationale">7.1. Design Rationale</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#sec:Getting_the_Xtext_Index_Content_IResourceDescriptions">7.1.1. Getting the Xtext Index (<code>IResourceDescriptions</code>) Content</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#sec:Design_Overview">7.2. Design Overview</a></li>
+<li><a href="type_index.html#sec:N4JS_Resource_Load_States">7.3. N4JS Resource Load States</a></li>
+<li><a href="type_index.html#sec:Type_Builder">7.4. Types Builder</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#sec:Type_Inference_not_allowed_in_Type_Builder">7.4.1. Type Inference not allowed in Types Builder</a></li>
+<li><a href="type_index.html#sec:ComputedTypeReferences">7.4.2. Deferred Type References</a></li>
+<li><a href="type_index.html#sec:Use_cases_of_ComputedTypeRef">7.4.3. Use cases of DeferredTypeRef</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#sec:Incremental_Builder_Overview">7.5. Incremental Builder (Overview)</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#sec:Incremental_Builder_Overview__XtextBuilder">7.5.1. XtextBuilder</a></li>
+<li><a href="type_index.html#sec:Incremental_Builder_Overview__IBuilderState">7.5.2. IBuilderState</a>
+<ul class="sectlevel4">
+<li><a href="type_index.html#copy-and-update-xtext-index">7.5.2.1. Copy and Update Xtext Index</a></li>
+<li><a href="type_index.html#build-state-setup-phase">7.5.2.2. Build State Setup Phase</a></li>
+<li><a href="type_index.html#process-queued-uris">7.5.2.3. Process Queued URIs</a></li>
+<li><a href="type_index.html#queueing-affected-resources">7.5.2.4. Queueing Affected Resources</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#sec:Incremental_Builder_Overview__Example">7.5.3. Example</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#dirty-state-handling">7.6. Dirty state handling</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#use-case-restoring-types-from-user-data">7.6.1. Use case: Restoring types from user data</a></li>
+<li><a href="type_index.html#use-case-updating-the-xtext-index">7.6.2. Use case: Updating the Xtext index</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="project_model.html#_project-model">8. Project Model</a>
+<ul class="sectlevel2">
+<li><a href="project_model.html#sec:Package_json">8.1. Package.json File</a></li>
+<li><a href="project_model.html#_accessing-project-information">8.2. Accessing Project Information</a>
+<ul class="sectlevel3">
+<li><a href="project_model.html#sec:IN4JSCore">8.2.1. IN4JSCore</a></li>
+<li><a href="project_model.html#sec:N4JSModel">8.2.2. N4JSModel</a></li>
+<li><a href="project_model.html#sec:N4JSWorkspace">8.2.3. N4JSWorkspace</a></li>
+<li><a href="project_model.html#sec:N4JSProject">8.2.4. N4JSProject</a></li>
+<li><a href="project_model.html#sec:SourceContainer">8.2.5. SourceContainer</a></li>
+<li><a href="project_model.html#sec:N4JSProjectsStateHelper">8.2.6. N4JSProjectsStateHelper</a></li>
+</ul>
+</li>
+<li><a href="project_model.html#sec:Caching">8.3. Caching</a>
+<ul class="sectlevel3">
+<li><a href="project_model.html#_caching-of-externallibraryworkspace">8.3.1. Caching of ExternalLibraryWorkspace</a></li>
+<li><a href="project_model.html#_caching-of-n4jsprojectsstatehelper">8.3.2. Caching of N4JSProjectsStateHelper</a></li>
+</ul>
+</li>
+<li><a href="project_model.html#sec:WildcardPathFilter">8.4. WildcardPathFilter</a></li>
+<li><a href="project_model.html#sec:ProjectUtils">8.5. ProjectUtils</a></li>
+</ul>
+</li>
+<li><a href="binding.html#_binding">9. Binding</a>
+<ul class="sectlevel2">
+<li><a href="binding.html#sec:Binding_Design_Rationale">9.1. Design Rationale</a></li>
+<li><a href="binding.html#sec:Binding_to_Members">9.2. Binding to Members</a></li>
+<li><a href="binding.html#sec:Binding_Getter_Setter">9.3. Getter / Setter Binding</a></li>
+<li><a href="binding.html#chap:Statics">9.4. Static Member Binding</a></li>
+<li><a href="binding.html#sec:Binding_Enumeration">9.5. Enumeration Literals Binding</a></li>
+<li><a href="binding.html#sec:Accessibility_of_types_and_members">9.6. Accessibility of types and members</a></li>
+<li><a href="binding.html#sec:Member_Scope_Example">9.7. Member Scope Example</a></li>
+<li><a href="binding.html#sec:Scoping_for_Members_of_Composed_Type_Explained">9.8. Scoping for Members of Composed Type (Union/Intersection) Example</a></li>
+<li><a href="binding.html#sec:Binding_of_Structurally_References_Types">9.9. Structurally References Types</a></li>
+<li><a href="binding.html#sec:Building">9.10. Building</a>
+<ul class="sectlevel3">
+<li><a href="binding.html#sec:Build_Phases">9.10.1. Build Phases</a></li>
+<li><a href="binding.html#sec:Build_Scenarios">9.10.2. Build Scenarios</a></li>
+<li><a href="binding.html#sec:Lazy_linking_problem">9.10.3. Lazy linking problem</a></li>
+</ul>
+</li>
+<li><a href="binding.html#sec:Proxies_and_Proxy_Resolution">9.11. Proxies and Proxy Resolution (Overview)</a>
+<ul class="sectlevel3">
+<li><a href="binding.html#xtexts-lazy-linking-proxies">9.11.1. Xtext’s Lazy Linking Proxies</a></li>
+<li><a href="binding.html#standard-emf-proxies">9.11.2. Standard EMF Proxies</a></li>
+<li><a href="binding.html#_how-is-proxy-resolution-triggered">9.11.3. How is Proxy Resolution Triggered?</a></li>
+<li><a href="binding.html#_when-is-proxy-resolution-allowed">9.11.4. When is Proxy Resolution Allowed?</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="validation.html#_validation">10. Validation</a>
+<ul class="sectlevel2">
+<li><a href="validation.html#sec:validation_overview">10.1. Validation overview</a></li>
+<li><a href="validation.html#sec:validation_control_flow">10.2. Validation control flow</a></li>
+<li><a href="validation.html#sec:validation_issue_ids">10.3. Issue IDs and Messages</a></li>
+<li><a href="validation.html#sec:validation_usage_patterns">10.4. Usage Pattern</a></li>
+<li><a href="validation.html#sec:validation_links">10.5. Links</a></li>
+</ul>
+</li>
+<li><a href="references.html#_references">11. References</a>
+<ul class="sectlevel2">
+<li><a href="references.html#sec:usecases">11.1. Use cases</a></li>
+<li><a href="references.html#sec:calculation_algorithm">11.2. Calculation algorithm</a>
+<ul class="sectlevel3">
+<li><a href="references.html#sec:Xtext_default_implementation">11.2.1. Xtext default implementation</a></li>
+<li><a href="references.html#sec:N4_implementation">11.2.2. N4JS implementation</a></li>
+</ul>
+</li>
+<li><a href="references.html#sec:PerformanceOfDependencyCalculation">11.3. Performance Of Dependency Calculation</a></li>
+<li><a href="references.html#sec:kinds_of_references">11.4. Kinds of references</a>
+<ul class="sectlevel3">
+<li><a href="references.html#sec:Cross_References_to_be_ignored">11.4.1. Cross References to be ignored</a></li>
+<li><a href="references.html#sec:Cross_References_to_be_handled">11.4.2. Cross References to be handled</a></li>
+</ul>
+</li>
+<li><a href="references.html#sec:transitive_dependencies">11.5. Transitive dependencies</a></li>
+<li><a href="references.html#sec:find-references">11.6. Find references</a>
+<ul class="sectlevel3">
+<li><a href="references.html#_background">11.6.1. Background</a></li>
+<li><a href="references.html#_how-find-references-work">11.6.2. How Find References Work</a>
+<ul class="sectlevel4">
+<li><a href="references.html#_step-1-convert-cursor-position-to-declared-element">11.6.2.1. Step 1: Convert Cursor Position to Declared Element</a></li>
+<li><a href="references.html#_step-2-convert-declared-element-to-target-uris">11.6.2.2. Step 2: Convert Declared Element to Target URIs</a></li>
+<li><a href="references.html#_step-3-filter-potential-resources">11.6.2.3. Step 3: Filter Potential Resources</a></li>
+<li><a href="references.html#_step-4-search-references-in-resource">11.6.2.4. Step 4: Search References in Resource</a></li>
+<li><a href="references.html#_limitations-and-possible-enhancements">11.6.2.5. Limitations and Possible Enhancements</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="compilation.html#_compilation">12. Compilation</a>
+<ul class="sectlevel2">
+<li><a href="compilation.html#chap:compilation">12.1. Introduction</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:general_design_rationals">12.1.1. General design rationals</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:logging_and_error_reporting">12.1.1.1. Logging and error reporting</a></li>
+<li><a href="compilation.html#sec:progress_monitor">12.1.1.2. Progress monitor</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Xtext_Integration">12.1.2. Xtext Integration</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:xtext_default_behaviour">12.1.2.1. Xtext default behaviour</a></li>
+<li><a href="compilation.html#sec:n4js_requirements">12.1.2.2. N4JS requirements</a></li>
+<li><a href="compilation.html#sec:compiler_discovery_in_ui">12.1.2.3. Compiler discovery in UI</a></li>
+<li><a href="compilation.html#sec:compiler_discovery_in_headless">12.1.2.4. Compiler discovery in headless</a></li>
+<li><a href="compilation.html#sec:general_generator_implementation">12.1.2.5. General generator implementation</a></li>
+<li><a href="compilation.html#sec:general_generator_activation">12.1.2.6. General generator activation</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Overview_of_Input_Models">12.1.3. Overview of the Input Models</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Core_Generator">12.2. Generators</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:Compiler_Components">12.2.1. Generator Components</a></li>
+<li><a href="compilation.html#sec:Generator_architecture">12.2.2. Generator architecture</a></li>
+<li><a href="compilation.html#sec:Unified_Compiler_Configuration">12.2.3. Unified Compiler Configuration</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Transpilers">12.3. Transpilers</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:Phases">12.3.1. Overview</a></li>
+<li><a href="compilation.html#relation-between-ast-and-im">12.3.2. Relation between AST and IM</a></li>
+<li><a href="compilation.html#implementation-overview">12.3.3. Implementation Overview</a></li>
+<li><a href="compilation.html#sec:Guidelines_for_Implementing_Transformations">12.3.4. Guidelines for Implementing Transformations</a></li>
+<li><a href="compilation.html#symbol-table-in-the-im">12.3.5. Symbol Table in the IM</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:N4JS_to_EcmaScript_Transpiler">12.4. N4JS-to-EcmaScript Transpiler</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:Overview_of_Transformations">12.4.1. Overview of Transformations</a></li>
+<li><a href="compilation.html#sec:Transpiling_members">12.4.2. Transpiling members</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:Transpiling_members__Delegating_members">12.4.2.1. Techniques for special member handling</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__Partial_shadowing_of_getter_setter_pairs">12.4.2.2. Partial shadowing</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__Consuming_or_inheriting_members_of_an_interface">12.4.2.3. Consuming or inheriting members of an interface</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__Static_polyfill">12.4.2.4. Static polyfill</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__API_implementation_stubs">12.4.2.5. API / implementation stubs</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Support_for_incomplete_API_implementation_testing_in_the_N4JS_to_EcmaScript_5_Transpiler">12.4.3. Support for incomplete API implementation testing</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:Modifications_in_Impl_projects">12.4.3.1. Modifications in Impl projects</a></li>
+<li><a href="compilation.html#sec:Implementation_of_stub_generation">12.4.3.2. Implementation of stub-generation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:n4jsc_Headless_Compiler_Interface">12.5. n4jsc Headless Compiler Interface</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:building_the_headless_compiler">12.5.1. building the headless compiler</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="execution.html#_execution">13. Execution</a>
+<ul class="sectlevel2">
+<li><a href="execution.html#sec:N4JS_Project_Execution_And_Linking_Model">13.1. N4JS Project Execution And Linking Model</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#subsec:N4JS_Execution_With_NodeJS">13.1.1. N4JS Execution With NodeJS</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:N4JS_Execution_And_Linking_File">13.2. N4JS Execution And Linking File</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#subsec:NodeJS_Specific_ELF">13.2.1. NodeJS Specific ELF</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Runners-execution">13.3. Runners</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#subsec:N4_Runtime_Environments_Convention">13.3.1. N4 Runtime Environments Convention</a></li>
+<li><a href="execution.html#subsec:Passing_Information_from_IDE_to_Execution_Code_in_Runtime_Environment">13.3.2. Passing Information from IDE to Execution Code in Runtime Environment</a></li>
+<li><a href="execution.html#subsec:Runners_Design">13.3.3. Runners Design</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Legacy_Execution_Engine">13.4. Legacy Execution Engine</a></li>
+<li><a href="execution.html#sec:Design">13.5. Design</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#sec:Usage_Outside_N4JSIDE">13.5.1. Usage Outside N4JSIDE</a>
+<ul class="sectlevel4">
+<li><a href="execution.html#sec:Use_Node_with_Maven">13.5.1.1. Use Node with Maven</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Usage_Inside_N4JSIDE">13.5.2. Usage Inside N4JSIDE</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Runtime_Injection">13.6. Runtime Injection</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#sec:Running_String_Code">13.6.1. Running String Code</a></li>
+<li><a href="execution.html#sec:Running_File_Code">13.6.2. Running File Code</a></li>
+<li><a href="execution.html#sec:Injection_Code_Example">13.6.3. Injection Code Example</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#_tests">14. Tests</a>
+<ul class="sectlevel2">
+<li><a href="tests.html#sec:Performance_Tests">14.1. Performance Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Synthetic_Performance_Tests">14.1.1. Synthetic Performance Tests</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:Design_of_Generator">14.1.1.1. Design of Generator</a></li>
+<li><a href="tests.html#sec:Design_of_Performance_Test_Execution">14.1.1.2. Design of Performance Test Configuration and Execution</a></li>
+<li><a href="tests.html#sec:JUnit_Configuration">14.1.1.3. JUnit Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Test_Configuration">14.1.1.4. JUnitBenchmark Test Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Report_Configuration">14.1.1.5. JUnitBenchmark Report Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Run_Configuration">14.1.1.6. JUnitBenchmark Run Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Example">14.1.1.7. JUnitBenchmark Example</a></li>
+<li><a href="tests.html#sec:Note_on_Jenkins_Job">14.1.1.8. Note on Jenkins Job</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#sec:ECMA_Tests">14.2. ECMA Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Grammar_Tests">14.2.1. Grammar Tests</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:Negative_Tests">14.2.1.1. Negative Tests</a></li>
+<li><a href="tests.html#sec:Test_Exclusion">14.2.1.2. Test Exclusion</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Integration_Tests">14.3. Integration Tests</a></li>
+<li><a href="tests.html#sec:Test_Helpers">14.4. Test Helpers</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Parameterized_N4JS_Tests">14.4.1. Parameterized N4JS tests</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:ParameterizedXtextRunner">14.4.1.1. ParameterizedXtextRunner</a></li>
+<li><a href="tests.html#sec:TestCodeProvider">14.4.1.2. TestCodeProvider</a></li>
+<li><a href="tests.html#sec:Example_Of_Parameterized_Parser_Test">14.4.1.3. Example of parameterized parser test</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Issue_Suppression">14.5. Issue Suppression</a></li>
+<li><a href="tests.html#sec:Xpect_Tests">14.6. Xpect Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Xpect_Test_Setup">14.6.1. Xpect Test Setup</a></li>
+<li><a href="tests.html#sec:Xpect_Issue_Suppression">14.6.2. Xpect Issue Suppression</a></li>
+<li><a href="tests.html#sec:Xpect_Provided_Test_Methods">14.6.3. Xpect Provided Test Methods</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#errors">14.6.3.1. errors</a></li>
+<li><a href="tests.html#warnings">14.6.3.2. warnings</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:N4JS_Specific_Xpect_Test_Methods">14.6.4. N4JS Specific Xpect Test Methods</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:XPECT_noerrors">14.6.4.1. noerrors and nowarnings</a></li>
+<li><a href="tests.html#sec:XPECT_scope">14.6.4.2. scope</a></li>
+<li><a href="tests.html#sec:XPECT_scopeWithPosition">14.6.4.3. scopeWithPosition</a></li>
+<li><a href="tests.html#sec:XPECT_scopeWithResource">14.6.4.4. scopeWithResource</a></li>
+<li><a href="tests.html#sec:XPECT_binding">14.6.4.5. binding</a></li>
+<li><a href="tests.html#sec:XPECT_linkedPathname">14.6.4.6. linkedPathname</a></li>
+<li><a href="tests.html#sec:XPECT_type_of">14.6.4.7. type of</a></li>
+<li><a href="tests.html#sec:XPECT_expectedType">14.6.4.8. expectedType</a></li>
+<li><a href="tests.html#sec:XPECT_elementKeyword">14.6.4.9. elementKeyword</a></li>
+<li><a href="tests.html#sec:XPECT_accessModifier">14.6.4.10. accessModifier</a></li>
+<li><a href="tests.html#sec:XPECT_compileResult">14.6.4.11. compileResult</a></li>
+<li><a href="tests.html#sec:XPECT_output">14.6.4.12. output</a></li>
+<li><a href="tests.html#sec:XPECT_outputRegEx">14.6.4.13. outputRegEx</a></li>
+<li><a href="tests.html#sec:XPECT_calculatedAccessModifier">14.6.4.14. calculatedAccessModifier</a></li>
+<li><a href="tests.html#sec:XPECT_spec">14.6.4.15. spec</a></li>
+<li><a href="tests.html#sec:XPECT_deadCode">14.6.4.16. deadCode</a></li>
+<li><a href="tests.html#sec:XPECT_returnOrThrows">14.6.4.17. returnOrThrows</a></li>
+<li><a href="tests.html#sec:XPECT_lint">14.6.4.18. lint</a></li>
+<li><a href="tests.html#sec:XPECT_lintFails">14.6.4.19. lintFails</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:FIXME_Xpect_modifier">14.6.5. FIXME Xpect modifier</a></li>
+<li><a href="tests.html#sec:Expectmatrix_Xpect_Test_Methods">14.6.6. Expectmatrix Xpect tests</a></li>
+<li><a href="tests.html#xpect-lint-tests">14.6.7. Xpect Lint Tests</a></li>
+</ul>
+</li>
+<li><a href="tests.html#xpect-proposal-tests">14.7. Xpect Proposal Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Validation_vs__Non_Validation">14.7.1. Validation vs. Non-Validation</a></li>
+<li><a href="tests.html#sec:General_Proposal_Test_Features">14.7.2. General Proposal Test Features</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:Test_Variables">14.7.2.1. Test Variables</a></li>
+<li><a href="tests.html#sec:Location_and_Selection">14.7.2.2. at – Location and Selection</a></li>
+<li><a href="tests.html#sec:Multi_Line_Expectations_in_Proposal_Tests">14.7.2.3. Multi Line Expectations in Proposal Tests</a></li>
+<li><a href="tests.html#sec:Timeout">14.7.2.4. Timeout and Performance</a></li>
+</ul>
+</li>
+<li><a href="tests.html#proposals-verify-existence-of-proposals">14.7.3. proposals – Verify Existence of Proposals</a></li>
+<li><a href="tests.html#sec:Verify_displayed_string">14.7.4. display – Verify displayed string</a></li>
+<li><a href="tests.html#sec:Apply_Proposal">14.7.5. apply – Apply Proposal</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#resource-application-in-other-files">14.7.5.1. resource – application in other files</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Content_Assist_Cycling">14.7.6. kind – Content Assist Cycling</a></li>
+<li><a href="tests.html#fileValidVerify-validation-status">14.7.7. fileValid – Verify validation status</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Apply_Proposal_And_Execute_Tests">14.8. Apply Proposal And Execute Tests</a></li>
+<li><a href="tests.html#sec:Organize_Imports_Test">14.9. Organize Imports Test</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#organizeimports">14.9.1. organizeImports</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Access_Control_Test">14.10. Access Control Test</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#test-scenarios">14.10.1. Test Scenarios</a></li>
+<li><a href="tests.html#n4js-code-generator">14.10.2. N4JS Code Generator</a></li>
+<li><a href="tests.html#xtext-issue-matcher">14.10.3. Xtext Issue Matcher</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Smoke_Tests">14.11. Smoke Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#how-to-handle-smoke-test-errors">14.11.1. How to handle smoke test errors?</a></li>
+<li><a href="tests.html#smoketester-and-exceptionanalyzer">14.11.2. SmokeTester and ExceptionAnalyzer</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:UI_Tests_with_SWTBot">14.12. UI Tests with SWTBot</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#writing-swtbot-tests">14.12.1. Writing SWTBot Tests</a></li>
+<li><a href="tests.html#running-swtbot-tests">14.12.2. Running SWTBot Tests</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Debugging_UI_Tests">14.13. Debugging UI Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Connecting_to_the_X_server_on_the_build_node">14.13.1. Connecting to the X-server on the build-node</a></li>
+<li><a href="tests.html#sec:Tools_to_investigate_the_java_stack">14.13.2. Tools to investigate the java-stack</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="ui_concepts.html#_ui-concepts">15. UI Concepts</a>
+<ul class="sectlevel2">
+<li><a href="ui_concepts.html#sec:User_Interface_Concepts">15.1. User Interface Concepts</a>
+<ul class="sectlevel3">
+<li><a href="ui_concepts.html#sec:Eclipse_UI_Concepts">15.1.1. Eclipse UI Concepts</a>
+<ul class="sectlevel4">
+<li><a href="ui_concepts.html#sec:Label_Provider">15.1.1.1. Label Provider</a></li>
+<li><a href="ui_concepts.html#sec:Markers">15.1.1.2. Markers</a></li>
+<li><a href="ui_concepts.html#sec:Commands__Toolbar_and_Menus">15.1.1.3. Commands, Toolbar and Menus</a></li>
+<li><a href="ui_concepts.html#sec:Content_Assist">15.1.1.4. Content Assist</a></li>
+<li><a href="ui_concepts.html#sec:Quick_Fixes">15.1.1.5. Quick Fixes</a></li>
+<li><a href="ui_concepts.html#sec:Quick_Assist">15.1.1.6. Quick Assist</a></li>
+<li><a href="ui_concepts.html#sec:Clean_Up_Actions">15.1.1.7. Clean Up Actions</a></li>
+<li><a href="ui_concepts.html#sec:Save_Actions">15.1.1.8. Save Actions</a></li>
+<li><a href="ui_concepts.html#sec:Auto_Edit">15.1.1.9. Auto Edit</a></li>
+<li><a href="ui_concepts.html#sec:Template_Proposals">15.1.1.10. Template Proposals</a></li>
+<li><a href="ui_concepts.html#sec:Outline_View___Quick_Outline">15.1.1.11. Outline View / Quick Outline</a></li>
+<li><a href="ui_concepts.html#sec:Navigator__Package_Explorer__Project_Explorer">15.1.1.12. Navigator, Package Explorer, Project Explorer</a></li>
+<li><a href="ui_concepts.html#sec:Hyperlinking_and_Navigation">15.1.1.13. Hyperlinking and Navigation</a></li>
+<li><a href="ui_concepts.html#sec:Syntax_and_Semantic_Coloring">15.1.1.14. Syntax and Semantic Coloring</a></li>
+<li><a href="ui_concepts.html#sec:Code_Formatter">15.1.1.15. Code Formatter</a></li>
+<li><a href="ui_concepts.html#sec:Wizards">15.1.1.16. Wizards</a></li>
+<li><a href="ui_concepts.html#sec:Cheat_Sheets">15.1.1.17. Cheat Sheets</a></li>
+<li><a href="ui_concepts.html#sec:Context_sensitive_Help">15.1.1.18. Context-sensitive Help</a></li>
+<li><a href="ui_concepts.html#sec:Hovers">15.1.1.19. Hovers</a></li>
+<li><a href="ui_concepts.html#sec:Folding">15.1.1.20. Folding</a></li>
+<li><a href="ui_concepts.html#sec:Customizable_validation___severity">15.1.1.21. Customizable validation / severity</a></li>
+<li><a href="ui_concepts.html#sec:Proposals">15.1.1.22. Proposals</a></li>
+</ul>
+</li>
+<li><a href="ui_concepts.html#sec:Non_Eclipse_UI_Concepts">15.1.2. Non-Eclipse UI Concepts</a>
+<ul class="sectlevel4">
+<li><a href="ui_concepts.html#sec:Overlays">15.1.2.1. Overlays</a></li>
+<li><a href="ui_concepts.html#sec:Goto__Inferred__Type">15.1.2.2. Goto (Inferred) Type</a></li>
+<li><a href="ui_concepts.html#sec:Postfix_Completion">15.1.2.3. Postfix Completion</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="ui_concepts.html#_user-interface-resources">15.2. User Interface Resources</a>
+<ul class="sectlevel3">
+<li><a href="ui_concepts.html#_icons">15.2.1. Icons</a>
+<ul class="sectlevel4">
+<li><a href="ui_concepts.html#_eclipse-platform-icons">15.2.1.1. Eclipse Platform Icons</a></li>
+<li><a href="ui_concepts.html#_n4js-specific-icons">15.2.1.2. N4JS Specific Icons</a></li>
+<li><a href="ui_concepts.html#_high-resolution-icons">15.2.1.3. High Resolution Icons</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="formatting.html#_formatting">16. Formatting</a>
+<ul class="sectlevel2">
+<li><a href="formatting.html#sec:FmtObjective">16.1. Objective</a>
+<ul class="sectlevel3">
+<li><a href="formatting.html#sec:FmtFormatting_Comments">16.1.1. Formatting Comments</a></li>
+</ul>
+</li>
+<li><a href="formatting.html#sec:FmtArchitecture">16.2. Architecture</a>
+<ul class="sectlevel3">
+<li><a href="formatting.html#sec:Implementation_example">16.2.1. Implementation example</a></li>
+</ul>
+</li>
+<li><a href="formatting.html#sec:FmtFormatter_Implementation_Guidelines">16.3. Formatter Implementation Guidelines</a></li>
+<li><a href="formatting.html#sec:FmtConfiguration">16.4. Configuration</a></li>
+<li><a href="formatting.html#sec:FmtUI_Integration">16.5. UI Integration</a></li>
+<li><a href="formatting.html#sec:FmtUnit_Testing_with_Xpect">16.6. Unit Testing with Xpect</a></li>
+</ul>
+</li>
+<li><a href="external_libraries.html#_external-libraries">17. External Libraries</a>
+<ul class="sectlevel2">
+<li><a href="external_libraries.html#sec:Major_Components">17.1. Major Components</a>
+<ul class="sectlevel3">
+<li><a href="external_libraries.html#subsec:External_Resources">17.1.1. External Resources</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Workspace">17.1.2. External Library Workspace</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Preference_Store">17.1.3. External Library Preference Store</a></li>
+<li><a href="external_libraries.html#subsec:npm_Manager">17.1.4. Library Manager</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Builder_Helper">17.1.5. External Library Builder</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Xtext_Index_Persister">17.1.6. External Library Xtext Index Persister</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Preference_Page">17.1.7. External Library Preference Page</a></li>
+</ul>
+</li>
+<li><a href="external_libraries.html#sec:Headless_External_Library_Support">17.2. Headless External Library Support</a>
+<ul class="sectlevel3">
+<li><a href="external_libraries.html#_custom-npm-settings">17.2.1. Custom npm settings</a></li>
+</ul>
+</li>
+<li><a href="external_libraries.html#sec:lmFutureWork">17.3. Future Work</a>
+<ul class="sectlevel3">
+<li><a href="external_libraries.html#subsec:lmMultipleDependencyScope">17.3.1. Multiple Dependency Scope</a></li>
+<li><a href="external_libraries.html#subsec:lmRunTestsFromLibrary">17.3.2. Run Tests from TestLibrary</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="json_support.html#sec:JSON_Support">18. JSON Support</a>
+<ul class="sectlevel2">
+<li><a href="json_support.html#sec:JSON_Parser">18.1. JSON Parser</a>
+<ul class="sectlevel3">
+<li><a href="json_support.html#sec:JSON_Parser_Unicode_Escaping">18.1.1. Escaping Unicode Control Characters in String Literals</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Empty_Text">18.1.2. Empty Text</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Nested_Structures">18.1.3. Nested Structures</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Whitespace">18.1.4. Whitespace</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Comments">18.1.5. Comments</a></li>
+</ul>
+</li>
+<li><a href="json_support.html#sec:JSON_Language_Extensions">18.2. JSON Language Extensions</a>
+<ul class="sectlevel3">
+<li><a href="json_support.html#sec:JSON_Validator_Extensions">18.2.1. JSON Validator Extensions</a>
+<ul class="sectlevel4">
+<li><a href="json_support.html#sec:File_Specitic_Validator_Extensions">18.2.1.1. File-Specific Validator Extensions</a></li>
+<li><a href="json_support.html#sec:JSON_Declarative_JSON_Validator_Extensions">18.2.1.2. Declarative JSON Validator Extensions</a></li>
+</ul>
+</li>
+<li><a href="json_support.html#_json-resource-description-strategy">18.2.2. JSON Resource Description Strategy</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_jsdoc">19. JSDoc</a>
+<ul class="sectlevel2">
+<li><a href="jsdoc.html#sec:Design_Rationale">19.1. Design Rationale</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#_general-design">19.1.1. General Design</a></li>
+<li><a href="jsdoc.html#sec:Type_Expressions">19.1.2. Type Expressions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="docexporter.html#_docexporter">20. DocExporter</a>
+<ul class="sectlevel2">
+<li><a href="docexporter.html#sec:Specification_Exporter">20.1. Specification Exporter</a></li>
+</ul>
+</li>
+<li><a href="rename_refactoring.html#_rename-refactoring">21. Rename Refactoring</a>
+<ul class="sectlevel2">
+<li><a href="rename_refactoring.html#_rename-refactoring-ui-interaction">21.1. Rename Refactoring UI interaction</a></li>
+<li><a href="rename_refactoring.html#_renameelementprocessor-interaction">21.2. RenameElementProcessor interaction</a></li>
+</ul>
+</li>
+<li><a href="flow_graphs.html#chap:flowgraphs">22. Flow Graphs</a>
+<ul class="sectlevel2">
+<li><a href="flow_graphs.html#sec:flowgraphs_overview">22.1. Flow graphs overview</a>
+<ul class="sectlevel3">
+<li><a href="flow_graphs.html#_internal-graph">22.1.1. Internal graph</a></li>
+<li><a href="flow_graphs.html#_optimizations">22.1.2. Optimizations</a></li>
+<li><a href="flow_graphs.html#_api-for-client-analyses">22.1.3. API for client analyses</a>
+<ul class="sectlevel4">
+<li><a href="flow_graphs.html#_mapping-from-internal-to-ast-elements">22.1.3.1. Mapping from internal to AST elements</a></li>
+<li><a href="flow_graphs.html#_graph-visitor">22.1.3.2. Graph visitor</a></li>
+<li><a href="flow_graphs.html#_graph-explorer">22.1.3.3. Graph explorer</a></li>
+<li><a href="flow_graphs.html#_branch-walker">22.1.3.4. Branch walker</a></li>
+<li><a href="flow_graphs.html#_example-1-compute-string-for-each-path">22.1.3.5. Example 1: Compute string for each path</a></li>
+<li><a href="flow_graphs.html#_path-quantor">22.1.3.6. Path quantor</a></li>
+</ul>
+</li>
+<li><a href="flow_graphs.html#_control-flow-analyses">22.1.4. Control flow analyses</a>
+<ul class="sectlevel4">
+<li><a href="flow_graphs.html#_dead-code-analysis">22.1.4.1. Dead code analysis</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="flow_graphs.html#sec:dataflow">22.2. Dataflow</a>
+<ul class="sectlevel3">
+<li><a href="flow_graphs.html#_dataflow-graph">22.2.1. Dataflow graph</a></li>
+<li><a href="flow_graphs.html#_dataflow-analyses">22.2.2. Dataflow analyses</a>
+<ul class="sectlevel4">
+<li><a href="flow_graphs.html#_def-def-def-nothing-analysis">22.2.2.1. Def&#8594;Def / Def&#8594;Nothing analysis</a></li>
+<li><a href="flow_graphs.html#_def-use-decl-analysis">22.2.2.2. Def|Use&#8592;Decl analysis</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="publish_npms.html#sec:publish-npms-to-public">23. Publish npms</a>
+<ul class="sectlevel2">
+<li><a href="publish_npms.html#sec:publish-npms-n4js-maven">23.1. Publish n4js-libs to during  maven build</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Hints">Appendix A: Hints</a>
+<ul class="sectlevel2">
+<li><a href="appendix_a_hints.html#sec:XtextInjection">A.1. Xtext Injection</a>
+<ul class="sectlevel3">
+<li><a href="appendix_a_hints.html#sec:DI_MultipleInjectors_Singletons">A.1.1. Multiple Injectors and Singletons</a>
+<ul class="sectlevel4">
+<li><a href="appendix_a_hints.html#sec:DI_avoid_duplicate_singletons">A.1.1.1. Avoiding duplicate singletons</a>
+<ul class="sectlevel5">
+<li><a href="appendix_a_hints.html#sec:DI_binding_in_shared">A.1.1.1.1. Defining binding in the shared injector</a></li>
+<li><a href="appendix_a_hints.html#sec:DI_binding_in_custom">A.1.1.1.2. Defining binding in the custom injector</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:DI_Hints">A.1.2. Dependency Injection Hints</a>
+<ul class="sectlevel4">
+<li><a href="appendix_a_hints.html#sec:DI_custom_bundle">A.1.2.1. Use DI in custom bundle, use DI with extensions</a>
+<ul class="sectlevel5">
+<li><a href="appendix_a_hints.html#sec:DI_custom_bundle_problem">A.1.2.1.1. Problem</a></li>
+<li><a href="appendix_a_hints.html#sec:DI_custom_bundle_solution">A.1.2.1.2. Solution</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Access_Other_DSL_Injector">A.1.2.2. How do I get the Guice Injector of my language?</a>
+<ul class="sectlevel5">
+<li><a href="appendix_a_hints.html#sec:DSL_Injector_UI_context">A.1.2.2.1. UI context</a></li>
+<li><a href="appendix_a_hints.html#sec:DSL_Injector_Non_UI_context">A.1.2.2.2. Non UI context but with injection context</a></li>
+<li><a href="appendix_a_hints.html#sec:DSL_Injector_Non_UI_non_injection_context">A.1.2.2.3. Non UI context without injection context</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Cancel_Indicator">A.1.2.3. How do I get cancel indicators in different contexts?</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Eclipse">A.2. Eclipse</a>
+<ul class="sectlevel3">
+<li><a href="appendix_a_hints.html#sec:Show_Xtext_Index">A.2.1. Show the current Xtext index</a></li>
+<li><a href="appendix_a_hints.html#sec:Plugin_spy">A.2.2. Plug-in spy</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Maven-hints">A.3. Maven</a>
+<ul class="sectlevel3">
+<li><a href="appendix_a_hints.html#how-to-check-for-maven-mojo-updates">A.3.1. How to check for Maven MOJO updates</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#_module-loading">Appendix B: Module Loading</a>
+<ul class="sectlevel2">
+<li><a href="appendix_b_module_loading.html#sec:Dependency_Management">B.1. Dependency Management</a></li>
+<li><a href="appendix_b_module_loading.html#ecmascript-modules">B.2. ECMAScript Modules</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:ES5_Modules_Systems">B.2.1. ES5 Modules Systems</a></li>
+<li><a href="appendix_b_module_loading.html#sec:ES6_Modules">B.2.2. ES6 Modules</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:ECMAScript_Module_Loaders">B.3. ECMAScript Module Loaders</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:ES6_Module_Loaders">B.3.1. ES6 Module Loaders</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Polyfills_for_ES6_Module_Loaders">B.3.2. Polyfills for ES6 Module Loaders</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:es6_module_loader">B.3.2.1. es6-module-loader</a></li>
+<li><a href="appendix_b_module_loading.html#sec:SystemJS">B.3.2.2. SystemJS</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Demo">B.3.2.3. Demo</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#case-study-typescript">B.4. Case Study : TypeScript</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:ES6_Modules_Support">B.4.1. ES6 Modules Support</a></li>
+<li><a href="appendix_b_module_loading.html#sec:TypeScript_and_Module_Loading">B.4.2. TypeScript and Module Loading</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Cyclic_Dependencies">B.5. Cyclic Dependencies</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:Setup">B.5.1. Setup</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Transpile_and_Execute">B.5.2. Transpile and Execute</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Module_Format___AMD">B.5.2.1. Module Format = AMD</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Module_Format___CommonJS">B.5.2.2. Module Format = CommonJS</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Module_Format___SystemJS">B.5.2.3. Module Format = SystemJS</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Conclusion">B.5.3. Conclusion</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#system.register-as-transpilation-target">B.6. System.register as transpilation target</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:Introduction">B.6.1. Introduction</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:External_Transpilers">B.6.1.1. External Transpilers</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Example_of_a_System_register_module">B.6.1.2. Example of a System.register module</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Structure_of_a_System_register_module">B.6.2. Structure of a System.register module</a></li>
+<li><a href="appendix_b_module_loading.html#_transpilation-hints">B.6.3. Transpilation Hints</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Handling_Imports">B.6.3.1. Handling Imports</a></li>
+<li><a href="appendix_b_module_loading.html#sec:__exportFn__">B.6.3.2. &lt;&lt;exportFn&gt;&gt;</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Handling_Exports">B.6.3.3. Handling Exports</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Examples_w__Circular_Dependencies">B.6.4. Examples w/ Circular Dependencies</a></li>
+<li><a href="appendix_b_module_loading.html#sec:N4JS_Examples_w__Circular_Dependencies">B.6.5. N4JS Examples w/ Circular Dependencies</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Unresolved_Cyclic_Dependencies">B.6.5.1. Unresolved Cyclic Dependencies</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Variables___Functions">B.6.5.2. Examples with Variables &amp; Functions</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Classes">B.6.5.3. Examples with Classes</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Examples_with_SubClassing">B.6.5.4. Examples with SubClassing</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Miscellaneous">B.6.5.5. Miscellaneous</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#_resources">B.6.6. Resources</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:CommonJS_as_transpilation_target">B.7. CommonJS as transpilation target</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#_introduction-2">B.7.1. Introduction</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Transpilation_Hints">B.7.2. Transpilation Hints</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Import_Statements">B.7.2.1. Import Statements</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Export_Statements">B.7.2.2. Export Statements</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Tracking_Live_Bindings">B.7.2.3. Tracking Live Bindings</a></li>
+<li><a href="appendix_b_module_loading.html#sec:A_complete_example">B.7.2.4. A complete example</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#_resources-2">B.7.3. Resources</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_c_license.html#sec:License">Appendix C: License</a></li>
+<li><a href="appendix_d_acronyms.html#sec:Acronyms">Appendix D: Acronyms</a></li>
+<li><a href="appendix_e_bibliography_and_footnotes.html#_bibliography-and-footnotes">Appendix E: Bibliography and Footnotes</a></li>
+</ul>
+</div>
+</div>
+<div id="content"><div class="sect1">
+<h2 id="_type-system"><a class="anchor" href="#_type-system"></a><a class="link" href="#_type-system">6. Type System</a></h2>
+<div class="sectionbody">
+<div class="sect2 language-n4js">
+<h3 id="sec:Type_Model_and_Grammar"><a class="anchor" href="#sec:Type_Model_and_Grammar"></a><a class="link" href="#sec:Type_Model_and_Grammar">6.1. Type Model and Grammar</a></h3>
+<div class="paragraph">
+<p>The type model is used to define actual types and their relations (meta-model is defined by means of Xcore in file <code>Types.xcore</code>)
+and also references to types (meta-model in <code>TypeRefs.xcore</code>). The type model is built via the <code>N4JSTypesBuilder</code> when a resource
+is loaded and processed, and most type related tasks work only on the type model. Some types that are (internally) available
+in N4JS are not defined in N4JS, but instead in a special, internal type language not available to N4JS developers, called N4TS
+and defined in file <code>Types.xtext</code>.</p>
+</div>
+<div class="paragraph">
+<p>The types are referenced by AST elements; vice versa the AST elements can be referenced from the types (see <code>SyntaxRelatedTElement</code>).
+This backward reference is a simple reference to an EObject.</p>
+</div>
+<div class="sect3">
+<h4 id="sec:Type_Model_Overview"><a class="anchor" href="#sec:Type_Model_Overview"></a><a class="link" href="#sec:Type_Model_Overview">6.1.1. Type Model Overview</a></h4>
+<div class="paragraph">
+<p>The following figure, <a href="#fig:cd_typeAndTypeRefHierarchy">Types and Type References</a>, shows the classes of the type model and their inheritance relations, both the actual type definitions as defined in <code>Types.xcore</code> and the type references defined in <code>TypeRefs.xcore</code>. The most important type reference is the <code>ParameterizedTypeRef</code>; it is used for most user-defined references, for both parameterized and non-parameterized references. In the latter case, the list of type arguments is empty.</p>
+</div>
+<div id="fig:cd_typeAndTypeRefHierarchy" class="imageblock">
+<div class="content">
+<img src="chapters/06_typesystem/images/cd_typeModelHierarchy_allInOne.png" alt="cd typeModelHierarchy allInOne">
+</div>
+<div class="title">Figure 8. Type Model Overview: Types in the upper half and Type References in the lower half.</div>
+</div>
+<div class="paragraph">
+<p>Most types are self-explanatory. <code>TypeDefs</code> is the container element used in N4TS. Note that not all types and properties of types are available in N4JS – some can only be used in the N4TS language or be inferred by the type system for internal purposes. Some types need some explanation:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>TObjectPrototype</code>: Metatype for defining built-in object types such as <code>Object</code> or <code>Date</code>, only available in N4TS.</p>
+</li>
+<li>
+<p><code>VirtualBaseType</code>: This type is not available in N4JS. It is used to define common properties provided by all types of a certain metatype. E.g., it is used for defining some properties shared by all enumerations (this was the reason for introducing this type).</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>We distinguish four kinds of types as summarized in <a href="#tab:KindOfTypes">Kind Of Types</a>. Role is an internal construct for different kind of users who can define the special kind of type. The language column refers to the language used to specify the type; which is either N4JS or N4TS.</p>
+</div>
+<table id="tab:KindOfTypes" class="tableblock frame-all grid-all spread">
+<caption class="title">Table 1. Kind of Types</caption>
+<colgroup>
+<col style="width: 10%;">
+<col style="width: 10%;">
+<col style="width: 10%;">
+<col style="width: 70%;">
+</colgroup>
+<thead>
+<tr>
+<th class="tableblock halign-left valign-top">Kind</th>
+<th class="tableblock halign-left valign-top">Language</th>
+<th class="tableblock halign-left valign-top">Role</th>
+<th class="tableblock halign-left valign-top">Remark</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<th class="tableblock halign-left valign-top"><p class="tableblock">user</p></th>
+<th class="tableblock halign-left valign-top"><p class="tableblock">N4JS</p></th>
+<th class="tableblock halign-left valign-top"><p class="tableblock">developer</p></th>
+<td class="tableblock halign-left valign-top"><p class="tableblock">User defined types, such as declared classes or functions. These types are to be explicitly defined or imported in the code.</p></td>
+</tr>
+<tr>
+<th class="tableblock halign-left valign-top"><p class="tableblock">library</p></th>
+<th class="tableblock halign-left valign-top"><p class="tableblock">N4JSD</p></th>
+<th class="tableblock halign-left valign-top"><p class="tableblock">developer</p></th>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Type declarations only, comparable to C header files, without implementation. Used for defining the API of 3rd party libraries. These type definitions are to be explicitly defined or imported in the code.</p></td>
+</tr>
+<tr>
+<th class="tableblock halign-left valign-top"><p class="tableblock">builtin</p></th>
+<th class="tableblock halign-left valign-top"><p class="tableblock">N4TS</p></th>
+<th class="tableblock halign-left valign-top"><p class="tableblock">smith</p></th>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Built-in ECMAScript objects interpreted as types. E.g., <code>String</code>, <code>Date</code>, <code>Math</code>. These types are provided by N4JS and are always available.</p></td>
+</tr>
+<tr>
+<th class="tableblock halign-left valign-top"><p class="tableblock">primitive</p></th>
+<th class="tableblock halign-left valign-top"><p class="tableblock">N4TS</p></th>
+<th class="tableblock halign-left valign-top"><p class="tableblock">smith</p></th>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Primitive ECMAScript (and N4JS ties), such as <code>string</code>, <code>number</code>, <code>pathselector&lt;T&gt;</code>, <code>i18n</code>, and also <code>any</code>, <code>undefined</code> and <code>void</code>. These types are provided by N4JS and are always available. Primitive types are described in detail in the spec (see chapter "Primitive ECMAScript Types").</p></td>
+</tr>
+</tbody>
+</table>
+</div>
+<div class="sect3">
+<h4 id="sec:Built_in_Types"><a class="anchor" href="#sec:Built_in_Types"></a><a class="link" href="#sec:Built_in_Types">6.1.2. Built-in and Primitive Types</a></h4>
+<div class="paragraph">
+<p>The built-in and primitive types are not defined by the user, i.e. N4JS programmer. Instead, they are defined in special
+internal files using the internal N4TS language: <code>builtin_js.n4ts</code>, <code>builtin_n4.n4ts</code>, <code>primitives_js.n4ts</code>, <code>primitives_n4.n4ts</code>.</p>
+</div>
+</div>
+<div class="sect3 language-n4js">
+<h4 id="sec:Type_Model_DSL"><a class="anchor" href="#sec:Type_Model_DSL"></a><a class="link" href="#sec:Type_Model_DSL">6.1.3. Type Model DSL</a></h4>
+<div class="paragraph">
+<p>For defining built-in types and for tests, a special DSL called N4TS is provided by means of an Xtext grammar and generated
+tools. The syntax is similar to n4js, but of course without method or function bodies, i.e. without any statements of expressions.
+The grammar file is found in <code>Types.xtext</code>.</p>
+</div>
+<div class="paragraph">
+<p>The following list documents some differences to N4JS:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>access modifiers directly support <code>Internal</code>, so no annotations are needed (nor supported) here.</p>
+</li>
+<li>
+<p>besides N4 classifiers such as classes, the following classifiers can be defined:</p>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p><code>object</code> define classes derived from object (predefined object types) Special features:</p>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+indexed
+</td>
+<td class="hdlist2">
+<p>defined what type is returned in case of index access</p>
+</td>
+</tr>
+</table>
+</div>
+</li>
+<li>
+<p><code>virtualBase</code> virtual base types for argument</p>
+</li>
+</ol>
+</div>
+</li>
+<li>
+<p><code>primitive</code> primitive types (number, string etc.) Special features:</p>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+indexed
+</td>
+<td class="hdlist2">
+<p>defined what type is returned in case of index access</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+autoboxedType
+</td>
+<td class="hdlist2">
+<p>defines to which type the primitive can be auto boxed</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+assignmnentCompatible
+</td>
+<td class="hdlist2">
+<p>defines to which type the primitive is assignment compatible</p>
+</td>
+</tr>
+</table>
+</div>
+</li>
+<li>
+<p>types <code>any</code>, <code>null</code>, <code>void</code>, <code>undefined</code> – special types.</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>Annotations are not supported in the types DSL.</p>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:Type_System_Implementation"><a class="anchor" href="#sec:Type_System_Implementation"></a><a class="link" href="#sec:Type_System_Implementation">6.2. Type System Implementation</a></h3>
+<div class="paragraph">
+<p>The bulk of the type system&#8217;s functionality is implemented in packages <code>org.eclipse.n4js.typesystem[.constraints|.utils]</code>.
+Client code, e.g. in validations, should only access the type system through the facade class <code>N4JSTypeSystem</code>.
+Each of the main type system functions, called "judgments", are implemented in one of the concrete subclasses of
+base class <code>AbstractJudgment</code>. Internally, the type system is using a constraint solver for various purposes;
+entry point for this functionality is class <code>InferenceContext</code>. All these classes are a good entry point into
+the code base, for investigating further details.</p>
+</div>
+<div class="paragraph">
+<p>Some type information is cached (e.g., the type of an expression in the AST) and the above facade will take care
+to read from the cache instead of re-computing the information every time, as far as possible. This type cache is
+being filled in a dedicated phase during loading and processing of an N4JS resource;
+see <a href="#sec:Type_Inference_combined_with_AST_Traversal">Type Inference of AST</a> and <a href="type_index.html#sec:N4JS_Resource_Load_States">N4JS Resource Load States</a> for details.</p>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:Type_Inference_combined_with_AST_Traversal"><a class="anchor" href="#sec:Type_Inference_combined_with_AST_Traversal"></a><a class="link" href="#sec:Type_Inference_combined_with_AST_Traversal">6.3. Type Inference of AST</a></h3>
+<div class="paragraph">
+<p>Most judgments provided by the facade <code>N4JSTypeSystem</code> and implemented by subclasses of <code>AbstractJudgment</code> are used
+ad-hoc whenever client code requires the information they provide. This is applied, in particular, to judgments</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>subtype</code></p>
+</li>
+<li>
+<p><code>substTypeVariables</code></p>
+</li>
+<li>
+<p><code>upperBound</code> / <code>lowerBound</code></p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>For judgment <code>type</code> footnote:<code class="Currently only for [language-n4js">type</code>, not for <code class="language-n4js">expectedType</code>,
+but this may be changed in a future, further refactoring.], however, the processing is very different: we make
+sure that the entire AST, i.e. all typable nodes of the AST, will be typed up-front in a single step, which
+takes place during the <em>post-processing step</em> of an N4JSResource (see <a href="type_index.html#sec:N4JS_Resource_Load_States">N4JS Resource Load States</a>), which
+also has a couple other responsibilities. By triggering post-processing when client code invokes the type judgment
+for the first time for some random AST node (at the latest; usually it is triggered earlier), we make sure that
+this sequence is always followed.</p>
+</div>
+<div class="paragraph">
+<p>The remainder of this section will explain this single-step typing of the entire AST in detail.</p>
+</div>
+<div class="sect3">
+<h4 id="sec:Type_Inference_combined_with_AST_Traversal__Background"><a class="anchor" href="#sec:Type_Inference_combined_with_AST_Traversal__Background"></a><a class="link" href="#sec:Type_Inference_combined_with_AST_Traversal__Background">6.3.1. Background</a></h4>
+<div class="paragraph">
+<p>Originally, the N4JS type system could be called with any <code>EObject</code> at any given time, without any knowledge of the
+context. While this looked flexible in the beginning, it caused severe problems solving some inference cases, e.g.,
+the rule environment had to be prepared from the outside and recursion problems could occur, and it was also
+inefficient because some things had to be recalculated over and over again (although caching helped).</p>
+</div>
+<div class="paragraph">
+<p>It is better to do type inferencing (that is, computing the type of expressions in general) in a controlled manner.
+That is, instead of randomly computing the type of an expression in the AST, it is better to traverse the AST in a
+well-defined traversal order. That way, it is guaranteed that certain other nodes have been visited and, if not,
+either some special handling can kick in or an error can be reported. This could even work with XSemantics and the
+declarative style of the rules. The difference is that by traversing the AST in a controlled manner, the rules can
+make certain assumptions about the content of the rule-environment, such as that it always contains information
+about type variable bindings and that it always contains information about expected types etc.</p>
+</div>
+<div class="paragraph">
+<p>In that scenario, all AST nodes are visited and all types (and expected types) are calculated up-front. Validation
+and other parts then do not need to actually compute types (by calling the actual, Xsemantics-generated type system);
+instead, at that time all types have already been calculated and can simply be retrieved from the cache (this is
+taken care of by the type system facade <code>N4JSTypeSystem</code>).</p>
+</div>
+<div class="paragraph">
+<p>This also affects scoping, since all cross-references have to be resolved in this type computation step. However,
+even for scoping this has positive effects: E.g., the receiver type in property access expressions is always visited
+<em>before</em> visiting the selector. Thus it is not necessary to re-calculate the receiver type in order to perform scoping
+for the selector.</p>
+</div>
+<div class="paragraph">
+<p>The above refactoring was done in summer 2015. After this refactoring, we are still using Xsemantics to compute the
+types, i.e. the <code>type</code>     judgement in Xsemantics was largely kept as before. However, the type judgment is invoked
+in a controlled traversal order for each typable AST node in largely one step (controlled by <code>ASTProcessor</code> and <code>TypeProcessor</code>).</p>
+</div>
+<div class="paragraph">
+<p>The upshot of this one-step type inference is that once it is completed, the type for every typable AST node is known.
+Instead of storing this information in a separate model, this information will be stored and persisted in the type model
+directly, as well as in transient fields of the AST <sup class="footnote">[<a id="_footnoteref_1" class="footnote" href="appendix_e_bibliography_and_footnotes.html#_footnote_1" title="View footnote.">1</a>]</sup>. Currently, this applies only to types, not expected types;
+the inference of expected types could / should be integrated into the one-step inference as part of a future, further
+refactoring.</p>
+</div>
+<table id="tab:typeInferenceBeforeAfter" class="tableblock frame-all grid-all spread">
+<caption class="title">Table 2. Comparison of inference of type of AST nodes before / after refactoring.</caption>
+<colgroup>
+<col style="width: 50%;">
+<col style="width: 50%;">
+</colgroup>
+<thead>
+<tr>
+<th class="tableblock halign-left valign-top">Before</th>
+<th class="tableblock halign-left valign-top">After</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">ad-hoc type inference (when client code needs the type information)</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">up-front type inference (once for entire AST;
+later only reading from cache)</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">started anywhere</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">starts with root, i.e. the <code>Script</code></p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Xsemantics rules traverse the AST at will, uncontrolled</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">well-defined, controlled traversal order</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">lazy, on-demand resolution of <code>ComputedTypeRef</code>s (they contain the resolution logic)</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">pro-active resolution of
+<code>DeferredTypeRef</code>s (they themselves are dumb)</p></td>
+</tr>
+</tbody>
+</table>
+</div>
+<div class="sect3">
+<h4 id="sec:Triggering_Type_Inference_of_AST"><a class="anchor" href="#sec:Triggering_Type_Inference_of_AST"></a><a class="link" href="#sec:Triggering_Type_Inference_of_AST">6.3.2. Triggering</a></h4>
+<div class="paragraph">
+<p>The up-front type inference of the entire AST is part of the post-processing of every N4JSResource and is thus
+triggered when post-processing is triggered. This happens when</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>someone directly calls <code>#performPostProcessing()</code> on an N4JSResource</p>
+</li>
+<li>
+<p>someone directly calls <code>#resolveAllLazyCrossReferences()</code> on an N4JSResource,</p>
+</li>
+<li>
+<p>EMF automatically resolves the first proxy, i.e. someone calls an EMF-generated getter for a value that is a proxy,</p>
+</li>
+<li>
+<p>someone asks for a type for the first time, i.e. calls <code>N4JSTypeSystem#type()</code>,</p>
+</li>
+<li>
+<p>&#8230;&#8203;</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>Usually this happens after the types builder was run with <code>preLinking==false</code> and before validation takes place.
+For details, see classes <code>PostProcessingAwareResource</code> and <code>N4JSPostProcessor</code>.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Traversal_Order_During_Type_Inference_of_AST"><a class="anchor" href="#sec:Traversal_Order_During_Type_Inference_of_AST"></a><a class="link" href="#sec:Traversal_Order_During_Type_Inference_of_AST">6.3.3. Traversal Order</a></h4>
+<div class="paragraph">
+<p>The traversal order during post-processing is a bit tricky, as some things need to be done in a top-down order (only
+few cases, for now <sup class="footnote">[<a id="_footnoteref_2" class="footnote" href="appendix_e_bibliography_and_footnotes.html#_footnote_2" title="View footnote.">2</a>]</sup>), others in a bottom-up order (e.g. the main typing of AST nodes),
+and there is a third case in which several AST nodes are processed together (constraint-based type inference).</p>
+</div>
+<div class="paragraph">
+<p>Figure <a href="#fig:traversalOrder">Order in which AST nodes are being processed during post-processing.</a> provides an example of an AST and shows in which order the nodes are processed. Green
+numbers represent top-down processing, red numbers represent bottom-up processing and blue numbers represent the
+processing of the surrounding yellow nodes in a single step.</p>
+</div>
+<div id="fig:traversalOrder" class="imageblock">
+<div class="content">
+<img src="chapters/06_typesystem/images/traversalOrder.png" alt="traversalOrder">
+</div>
+<div class="title">Figure 9. Order in which AST nodes are being processed during post-processing.</div>
+</div>
+<div class="paragraph">
+<p>In the code, this is controlled by class <code>ASTProcessor</code>. The two main processing methods are</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>#processNode_preChildren()</code>, which will be invoked for all AST nodes in a top-down order (so top-down processing should be put here),</p>
+</li>
+<li>
+<p><code>#processNode_postChildren()</code>, which will be invoked for all AST nodes in a bottom-up order (so bottom-up processing should be put here).</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>The common processing of groups of adjacent yellow nodes (represented in the figure by the two yellow/brown
+triangles) is achieved by <code>PolyProcessor</code> telling the <code>TypeProcessor</code> to</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>ignore certain nodes (all yellow nodes) and</p>
+</li>
+<li>
+<p>invoke method <code>PolyProcessor#inferType()</code> for the root yellow node in each group (only the root!).
+.
+For details, see the two methods <code>#isResponsibleFor()</code> and <code>#isEntryPoint()</code> in <code>PolyProcessor</code>.</p>
+</li>
+</ol>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Cross_References_During_Type_Inference_of_AST"><a class="anchor" href="#sec:Cross_References_During_Type_Inference_of_AST"></a><a class="link" href="#sec:Cross_References_During_Type_Inference_of_AST">6.3.4. Cross-References</a></h4>
+<div class="paragraph">
+<p>While typing the entire AST, cross-references need special care. Three cases of cross-references need to be distinguished:</p>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+backward reference
+</td>
+<td class="hdlist2">
+<p>= cross-reference within the same file to an AST node that was already processed</p>
+<div class="ulist">
+<ul>
+<li>
+<p>always legal</p>
+</li>
+<li>
+<p>processing: simply read the type from the cache that is currently being filled</p>
+</li>
+</ul>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+forward reference
+</td>
+<td class="hdlist2">
+<p>= cross-reference within the same file to an AST node that was not yet processed</p>
+<div class="ulist">
+<ul>
+<li>
+<p>usually illegal<br>
+exception: legal if reference points to an <em>identifiable subtree</em> (a subtree of an AST with an identifiable element at its root)</p>
+</li>
+<li>
+<p>processing: forward process the identifiable subtree and report back the type of its root</p>
+</li>
+</ul>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+references to other files
+</td>
+<td class="hdlist2">
+<div class="ulist">
+<ul>
+<li>
+<p>always legal, because they can, by nature, only point to an identifiable subtree in the other file&#8217;s AST</p>
+</li>
+<li>
+<p>processing: either &#8230;&#8203;</p>
+<div class="ulist">
+<ul>
+<li>
+<p>read type from TModule obtained from index (if available), or</p>
+</li>
+<li>
+<p>load other file from source, trigger its post-processing (if not in progress or completed already), forward process the identifiable subtree (if not processed already) and report back the type of its root.</p>
+</li>
+</ul>
+</div>
+</li>
+</ul>
+</div>
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>Note that for references to an ancestor (upward references) or successor (downward references) within an AST, the
+classification as a forward or backward reference depends on whether we are in top-down or bottom-up processing.
+Figure <a href="#fig:upwardDownward">Upward Downward</a> illustrates this: the left and right side show the same AST but on the
+left side we assume a top down processing whereas on the right we assume a bottom up processing. On both sides,
+backward references are shown in green ink (because they are unproblematic and always legal) and forward references
+are shown in red ink. Now, looking at the two arrows pointing from a node to its parent, we see that it is classified
+as a backward reference on the left side (i.e. top down case) but as a forward reference on the right side (i.e. bottom
+down case). Conversely, an arrow from a node to its child is classified as a forward reference on the left side and as
+a backward reference on the right side. Arrows across subtrees, however, are classified in the same way on the left and
+right side (see the horizontal arrows at the bottom).</p>
+</div>
+<div id="fig:upwardDownward" class="imageblock">
+<div class="content">
+<img src="chapters/06_typesystem/images/upwardDownward.png" alt="upwardDownward">
+</div>
+<div class="title">Figure 10. Backward and forward references in top-down and bottom-up processing.</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Function_Accessor_Bodies_During_Type_Inference_of_AST"><a class="anchor" href="#sec:Function_Accessor_Bodies_During_Type_Inference_of_AST"></a><a class="link" href="#sec:Function_Accessor_Bodies_During_Type_Inference_of_AST">6.3.5. Function/Accessor Bodies</a></h4>
+<div class="paragraph">
+<p>An important exception to the basic traversal order shown in Figure <a href="#fig:traversalOrder">Order in which AST nodes are being processed during post-processing.</a> is that the body of all
+functions (including methods) and field accessors is postponed until the end of processing. This is used to avoid
+unnecessary cycles during type inference due to a function&#8217;s body making use of the function itself or some other
+declarations on the same level as the containing function. For example, the following code relies on this:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">let x = f();
+function f(): X {
+	if(x) {
+		// XPECT noerrors --&gt; "any is not a subtype of X." at "x"
+		return x;
+	}
+	return new X();
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Similar situation using fields and methods:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">class C {
+	d = new D();
+	mc() {
+		// XPECT noerrors --&gt; "any is not a subtype of D." at "this.d"
+		let tmp: D = this.d;
+	}
+}
+class D {
+	md() {
+		new C().mc();
+	}
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>For details of this special handling of function bodies, see method <code>ASTProcessor#isPostponedNode(EObject)</code> and field
+<code>ASTMetaInfoCache#postponedSubTrees</code> and the code using it. For further investigation, change <code>isPostponedNode()</code> to always
+return false and debug with the two examples above (which will then show the incorrect errors mentioned in the XPECT
+comments) or run tests to find more cases that require this handling.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Poly_Expressions_During_Type_Inference_of_AST"><a class="anchor" href="#sec:Poly_Expressions_During_Type_Inference_of_AST"></a><a class="link" href="#sec:Poly_Expressions_During_Type_Inference_of_AST">6.3.6. Poly Expressions</a></h4>
+<div class="paragraph">
+<p>Polymorphic expressions, or <em>poly expressions</em> for short, are expressions for which the actual type depends on the
+expected type and/or the expected type depends on the actual type. They require constraint-based type inference
+because the dependency between the actual and expected type can introduce dependency cycles between the types of
+several AST nodes which are best broken up by using a constraint-based approach. This is particularly true when
+several poly expressions are nested. Therefore, poly expressions are inferred neither in top-down nor in bottom-up
+order, but all together by solving a single constraint system.</p>
+</div>
+<div class="paragraph">
+<p>Only a few types of expressions can be polymorphic; they are called <em>poly candidates</em>: array literals, object literals,
+call expressions, and function expressions. The following rules tell whether a poly candidate is actually poly:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>ArrayLiteral</code> — always poly (because their type cannot be declared explicitly).</p>
+</li>
+<li>
+<p><code>ObjectLiteral</code> — if one or more properties do not have a declared type.</p>
+</li>
+<li>
+<p><code>CallExpression</code> — if generic &amp; not parameterized.</p>
+</li>
+<li>
+<p><code>FunctionExpression</code> — if return type or type of one or more formal parameters is undeclared.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>This is a simplified overview of these rules, for details see method <code>#isPoly(Expression)</code> in <code>AbstractPolyProcessor</code>.</p>
+</div>
+<div class="paragraph">
+<p>The main logic for inferring the type of poly expressions is found in method <code>#inferType()</code> in class <code>PolyProcessor</code>.
+It is important to note that this method will only be called for root poly expressions (see above). In short, the basic
+approach is to create a new, empty <code>InferenceContext</code>, i.e. constraint system, add inference variables and constraints for
+the root poly expression and all its nested poly expressions, solve the constraint system and use the types in the solution
+as the types of the root and nested poly expressions. For more details see method <code>#inferType()</code> in class <code>PolyProcessor</code>.</p>
+</div>
+<div class="paragraph">
+<p>So, this means that nested poly expressions do not introduce a new constraint system but instead simply extend their parent
+poly’s constraint system by adding additional inference variables and constraints. <strong>But not every nested expression that is
+poly is a nested poly expression in that sense!</strong> Sometimes, a new constraint system has to be introduced. For example:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>child poly expressions that appear as argument to a call expression are nested poly expressions (i.e. inferred in same constraint system as the parent call expression),</p>
+</li>
+<li>
+<p>child poly expressions that appear as target of a call expression are <strong>not</strong> nested poly expressions and a new constraint system has to be introduced for them.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>For details see method <code>#isRootPoly()</code> in <code>AbstractPolyProcessor</code> and its clients.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Constraint_Solver_used_During_Type_Inference_of_AST"><a class="anchor" href="#sec:Constraint_Solver_used_During_Type_Inference_of_AST"></a><a class="link" href="#sec:Constraint_Solver_used_During_Type_Inference_of_AST">6.3.7. Constraint Solver</a></h4>
+<div class="paragraph">
+<p>The simple constraint solver used by the N4JS type system, mainly for the inference of poly expressions, is implemented
+by class <code>InferenceContext</code> and the other classes in package <code>org.eclipse.n4js.typesystem.constraints</code>.</p>
+</div>
+<div class="paragraph">
+<p>The constraint solving algorithm used here is largely modeled after the one defined in <code>The Java Language Specification 8</code>,
+Chapter 18, but was adjusted in a number of ways, esp. by removing functionality not required for N4JS (e.g. primitive types,
+method overloading) and adding support for specific N4JS language features (e.g. union types, structural typing).</p>
+</div>
+<div class="paragraph">
+<p>For details see the API documentation of class <code>InferenceContext</code>.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Type_Guards_During_Type_Inference_of_AST"><a class="anchor" href="#sec:Type_Guards_During_Type_Inference_of_AST"></a><a class="link" href="#sec:Type_Guards_During_Type_Inference_of_AST">6.3.8. Type Guards</a></h4>
+<div class="paragraph">
+<p>During AST post-processing, the control and data flow analyses are performed.
+This means, that first a flow graph is created and then traversed.
+During the traversal, a type guard analysis is performed which saves information by evaluating <code>instanceof</code> expressions.
+As a result, the analysis provides a reliable set of RHS expressions of <code>instanceof</code> expressions for each AST element of type <code>IdentifierRef</code>.</p>
+</div>
+<div class="paragraph">
+<p>This set is evaluated in the <code>TypeJudgments.java</code> when typing <code>IdentifierRef</code> elements.
+In case the set is not empty, the types of all elements is calculated.
+The type of the <code>IdentifierRef</code> will then become the intersection of its original type and all types previously calculated.</p>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="sec:Structural_Typing"><a class="anchor" href="#sec:Structural_Typing"></a><a class="link" href="#sec:Structural_Typing">6.4. Structural Typing</a></h3>
+<div class="paragraph">
+<p>Structural typing as an optional subtyping mode in N4JS is implemented in <code>StructuralTypingComputer</code>, activated depending on
+the value of property <code>typingStrategy</code> in <code>ParameterizedTypeRef</code> and its subclasses.</p>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div id="footer">
+<div id="footer-text">
+Version 0.9<br>
+Last updated 2019-08-07 15:02:40 CEST
+</div>
+</div>
+<!-- ************* docinfo-footer *************************************************************** -->
+<div class="Grid social" style="color:#d5dfea">
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <h2>Quick Links</h2>
+    <ul>
+      <li><a href="../downloads.html">Download</a></li>
+      <li><a href="../userguides/index.html">Documentation</a></li>
+      <li><a href="https://github.com/eclipse/n4js/">Source</a></li>
+      <li><a href="https://github.com/eclipse/n4js/issues">Issues</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="https://www.eclipse.org/forums/index.php/f/365/">Forum</a></li>
+      <li><a href="http://n4js.blogspot.de/">Blog</a></li>
+      <li><a href="https://dev.eclipse.org/mailman/listinfo/n4js-dev">Mailing List</a></li>
+      <li><a href="https://projects.eclipse.org/projects/technology.n4js">Eclipse Project Page</a></li>
+      <li><a href="https://twitter.com/n4jsdev">Tweets by n4jsdev</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="http://www.eclipse.org/">Eclipse Home</a></li>
+      <li><a href="http://www.eclipse.org/legal/privacy.php">Privacy Policy</a></li>
+      <li><a href="http://www.eclipse.org/legal/termsofuse.php">Terms of Use</a></li>
+      <li><a href="http://www.eclipse.org/legal/copyright.php">Copyright Agent</a></li>
+      <li><a href="http://www.eclipse.org/legal/">Legal</a></li>
+    </ul>
+  </div>
+  <div style="clear: both; height: 0; overflow: hidden;"></div>
+</div>
+
+<!-- ************* UI Scripts ************* -->
+<script type="text/javascript" src="scripts/back-to-top.js"></script>
+
+<script type="text/javascript" src="scripts/treeview.js"></script>
+<script type="text/javascript" src="scripts/toc.js"></script>
+
+<!-- ************* Prism.js Syntax Highlighting ************* -->
+<script src="scripts/prism.js"></script>
+
+<script type="text/javascript">
+	// Add the 'toclist' id for search function
+	$(".toc2 > ul").attr('id', 'toclist');
+	// Generate a Search input form
+	$("#toclist > li:first-of-type").before('<input type="text" id="pagesearch" onkeyup="search()" placeholder="Search for section...">');
+	$("#toclist > li:first-of-type").before('<i id="clear" class="fa fa-times-circle-o"></i>');
+	$("#clear").click(function(){
+	    $("#pagesearch").val('');
+	    search();
+	    $('.toc2 > ul').treeView('collapseAll');
+	});
+	// intialize Treeview.js
+	$(".toc2 > ul").treeView();
+	// Initialize Scrollspy
+</script>
+<!-- ************* docinfo-footer *************************************************************** -->
+</body>
+</html>
\ No newline at end of file
diff --git a/design/ui_concepts.html b/design/ui_concepts.html
new file mode 100644
index 0000000..639b43b
--- /dev/null
+++ b/design/ui_concepts.html
@@ -0,0 +1,2308 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="generator" content="Asciidoctor 1.5.5">
+<meta name="author" content="2019-08-07 15:02:40 CEST">
+<title>N4JS Design Specification</title>
+<link rel="stylesheet" href="styles/spec.min.css">
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.6.3/css/font-awesome.min.css">
+<!-- ************* docinfo ******************************************************************* -->
+
+
+<!-- ************* Favicon ************-->
+<link rel="icon" href="images/favicon.ico" />
+
+<!-- ************* Back-to-top JQuery ************* -->
+<script src="https://code.jquery.com/jquery-1.12.4.js"></script>
+<script src="https://code.jquery.com/ui/1.12.0/jquery-ui.js"></script>
+
+
+<link href="styles/prism.min.css" rel="stylesheet" />
+<script type="text/javascript" async
+  src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2/MathJax.js?config=TeX-MML-AM_CHTML">
+</script>
+
+<!-- ************* Styles ************* -->
+<link rel="stylesheet" type="text/css" href="styles/n4jsspec-adoc.css">
+
+
+<!-- ****************** NavBar ****************** -->
+<div id="menubar">
+	<div class="banner">
+        <a href="https://www.eclipse.org/n4js/#"><img id="logo" src="images/n4js-logo.png" alt="Eclipse N4JS"></a>
+    </div>
+<ul>
+  <li><a href="index.html">Index</a></li>
+</ul>
+</div>
+<!-- ************* docinfo ******************************************************************* -->
+<style>
+      .admonitionblock td.icon .icon-todo:before{content:"\f249";color:#f4ee42}
+    </style>
+</head>
+<body class="book toc2 toc-left">
+<div id="header">
+<h1>N4JS Design Specification</h1>
+<div class="details">
+<span id="author" class="author">2019-08-07 15:02:40 CEST</span><br>
+<span id="revnumber">version 0.9</span>
+</div>
+<div id="toc" class="toc2">
+<div id="toctitle">Table of Contents</div>
+<ul class="sectlevel1">
+<li><a href="introduction.html#_introduction">1. Introduction</a>
+<ul class="sectlevel2">
+<li><a href="introduction.html#notation">1.1. Notation</a></li>
+<li><a href="introduction.html#sec:IDE_Overview">1.2. IDE Components</a>
+<ul class="sectlevel3">
+<li><a href="introduction.html#sec:Naming_Conventions">1.2.1. Naming Conventions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="eclipse_setup.html#_eclipse-setup">2. Eclipse Setup</a>
+<ul class="sectlevel2">
+<li><a href="eclipse_setup.html#_system-requirements">2.1. System Requirements</a></li>
+<li><a href="eclipse_setup.html#_contribute">2.2. Contribute</a>
+<ul class="sectlevel3">
+<li><a href="eclipse_setup.html#_eclipse-installer">2.2.1. Eclipse Installer</a>
+<ul class="sectlevel4">
+<li><a href="eclipse_setup.html#_changing-the-setup-script">2.2.1.1. Changing the Setup Script</a></li>
+</ul>
+</li>
+<li><a href="eclipse_setup.html#_manual-ide-configuration">2.2.2. Manual IDE Configuration</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="release_engineering.html#_release-engineering">3. Release Engineering</a>
+<ul class="sectlevel2">
+<li><a href="release_engineering.html#_nightly-build-on-eclipse-infrastructure">3.1. Nightly build on Eclipse infrastructure</a></li>
+<li><a href="release_engineering.html#_build-the-n4js-ide-from-command-line">3.2. Build the N4JS IDE from command line</a>
+<ul class="sectlevel3">
+<li><a href="release_engineering.html#_publish-maven-tooling-code-org-eclipse-n4js-releng-util-code">3.2.1. Publish maven-tooling <code>org.eclipse.n4js.releng.util</code></a></li>
+<li><a href="release_engineering.html#sec:test-verdaccio">3.2.2. Test Verdaccio containing n4js-libs</a></li>
+<li><a href="release_engineering.html#_generation-of-eclipse-help-for-spec-and-design-document">3.2.3. Generation of Eclipse help for spec and design document</a></li>
+</ul>
+</li>
+<li><a href="release_engineering.html#_updating-frameworks-and-dependencies">3.3. Updating frameworks and dependencies</a>
+<ul class="sectlevel3">
+<li><a href="release_engineering.html#_update-of-eclipse-emf-xtext-etc">3.3.1. Update of Eclipse, EMF, Xtext, etc.</a></li>
+<li><a href="release_engineering.html#_update-of-the-embedded-jre">3.3.2. Update of the embedded JRE</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tips_and_tricks.html#_tips-and-tricks">4. Tips and Tricks</a>
+<ul class="sectlevel2">
+<li><a href="tips_and_tricks.html#_naming">4.1. Naming</a></li>
+<li><a href="tips_and_tricks.html#_logging">4.2. Logging</a></li>
+<li><a href="tips_and_tricks.html#_cancellation-handling">4.3. Cancellation Handling</a></li>
+<li><a href="tips_and_tricks.html#_caching">4.4. Caching</a></li>
+<li><a href="tips_and_tricks.html#_dependency-injection">4.5. Dependency Injection</a></li>
+<li><a href="tips_and_tricks.html#_miscellaneous">4.6. Miscellaneous</a></li>
+</ul>
+</li>
+<li><a href="parser.html#_parser">5. Parser</a>
+<ul class="sectlevel2">
+<li><a href="parser.html#sec:Parser_Overview">5.1. Overview</a></li>
+<li><a href="parser.html#sec:N4JS_Parser">5.2. N4JS Parser</a></li>
+<li><a href="parser.html#sec:Parser_Generation_Post_Processing">5.3. Parser Generation Post-Processing</a>
+<ul class="sectlevel3">
+<li><a href="parser.html#sec:Automatic_Semicolon_Insertion">5.3.1. Automatic Semicolon Insertion</a>
+<ul class="sectlevel4">
+<li><a href="parser.html#sec:Injected_code_in_the_Antlr_grammar_file">5.3.1.1. Injected code in the Antlr grammar file</a></li>
+<li><a href="parser.html#sec:Customized_error_recovery">5.3.1.2. Customized error recovery</a></li>
+</ul>
+</li>
+<li><a href="parser.html#sec:_No_line_terminator_allowed_here__handling">5.3.2. Async and <code>No line terminator allowed here</code> Handling</a></li>
+<li><a href="parser.html#sec:Regular_Expression">5.3.3. Regular Expression</a></li>
+<li><a href="parser.html#sec:Unicode">5.3.4. Unicode</a></li>
+<li><a href="parser.html#sec:Literals">5.3.5. Literals</a></li>
+</ul>
+</li>
+<li><a href="parser.html#sec:Modifiers">5.4. Modifiers</a></li>
+<li><a href="parser.html#sec:Conflict_Resolutions">5.5. Conflict Resolutions</a>
+<ul class="sectlevel3">
+<li><a href="parser.html#sec:Reserved_Keywords_vs__Identifier_Names">5.5.1. Reserved Keywords vs. Identifier Names</a></li>
+<li><a href="parser.html#sec:Operators_and_Generics">5.5.2. Operators and Generics</a></li>
+</ul>
+</li>
+<li><a href="parser.html#sec:Content_Assist_Parser">5.6. Content-Assist Parser</a></li>
+</ul>
+</li>
+<li><a href="type_system.html#_type-system">6. Type System</a>
+<ul class="sectlevel2">
+<li><a href="type_system.html#sec:Type_Model_and_Grammar">6.1. Type Model and Grammar</a>
+<ul class="sectlevel3">
+<li><a href="type_system.html#sec:Type_Model_Overview">6.1.1. Type Model Overview</a></li>
+<li><a href="type_system.html#sec:Built_in_Types">6.1.2. Built-in and Primitive Types</a></li>
+<li><a href="type_system.html#sec:Type_Model_DSL">6.1.3. Type Model DSL</a></li>
+</ul>
+</li>
+<li><a href="type_system.html#sec:Type_System_Implementation">6.2. Type System Implementation</a></li>
+<li><a href="type_system.html#sec:Type_Inference_combined_with_AST_Traversal">6.3. Type Inference of AST</a>
+<ul class="sectlevel3">
+<li><a href="type_system.html#sec:Type_Inference_combined_with_AST_Traversal__Background">6.3.1. Background</a></li>
+<li><a href="type_system.html#sec:Triggering_Type_Inference_of_AST">6.3.2. Triggering</a></li>
+<li><a href="type_system.html#sec:Traversal_Order_During_Type_Inference_of_AST">6.3.3. Traversal Order</a></li>
+<li><a href="type_system.html#sec:Cross_References_During_Type_Inference_of_AST">6.3.4. Cross-References</a></li>
+<li><a href="type_system.html#sec:Function_Accessor_Bodies_During_Type_Inference_of_AST">6.3.5. Function/Accessor Bodies</a></li>
+<li><a href="type_system.html#sec:Poly_Expressions_During_Type_Inference_of_AST">6.3.6. Poly Expressions</a></li>
+<li><a href="type_system.html#sec:Constraint_Solver_used_During_Type_Inference_of_AST">6.3.7. Constraint Solver</a></li>
+<li><a href="type_system.html#sec:Type_Guards_During_Type_Inference_of_AST">6.3.8. Type Guards</a></li>
+</ul>
+</li>
+<li><a href="type_system.html#sec:Structural_Typing">6.4. Structural Typing</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#_type-index">7. Type Index</a>
+<ul class="sectlevel2">
+<li><a href="type_index.html#sec:Type_Index_Design_Rationale">7.1. Design Rationale</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#sec:Getting_the_Xtext_Index_Content_IResourceDescriptions">7.1.1. Getting the Xtext Index (<code>IResourceDescriptions</code>) Content</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#sec:Design_Overview">7.2. Design Overview</a></li>
+<li><a href="type_index.html#sec:N4JS_Resource_Load_States">7.3. N4JS Resource Load States</a></li>
+<li><a href="type_index.html#sec:Type_Builder">7.4. Types Builder</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#sec:Type_Inference_not_allowed_in_Type_Builder">7.4.1. Type Inference not allowed in Types Builder</a></li>
+<li><a href="type_index.html#sec:ComputedTypeReferences">7.4.2. Deferred Type References</a></li>
+<li><a href="type_index.html#sec:Use_cases_of_ComputedTypeRef">7.4.3. Use cases of DeferredTypeRef</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#sec:Incremental_Builder_Overview">7.5. Incremental Builder (Overview)</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#sec:Incremental_Builder_Overview__XtextBuilder">7.5.1. XtextBuilder</a></li>
+<li><a href="type_index.html#sec:Incremental_Builder_Overview__IBuilderState">7.5.2. IBuilderState</a>
+<ul class="sectlevel4">
+<li><a href="type_index.html#copy-and-update-xtext-index">7.5.2.1. Copy and Update Xtext Index</a></li>
+<li><a href="type_index.html#build-state-setup-phase">7.5.2.2. Build State Setup Phase</a></li>
+<li><a href="type_index.html#process-queued-uris">7.5.2.3. Process Queued URIs</a></li>
+<li><a href="type_index.html#queueing-affected-resources">7.5.2.4. Queueing Affected Resources</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#sec:Incremental_Builder_Overview__Example">7.5.3. Example</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#dirty-state-handling">7.6. Dirty state handling</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#use-case-restoring-types-from-user-data">7.6.1. Use case: Restoring types from user data</a></li>
+<li><a href="type_index.html#use-case-updating-the-xtext-index">7.6.2. Use case: Updating the Xtext index</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="project_model.html#_project-model">8. Project Model</a>
+<ul class="sectlevel2">
+<li><a href="project_model.html#sec:Package_json">8.1. Package.json File</a></li>
+<li><a href="project_model.html#_accessing-project-information">8.2. Accessing Project Information</a>
+<ul class="sectlevel3">
+<li><a href="project_model.html#sec:IN4JSCore">8.2.1. IN4JSCore</a></li>
+<li><a href="project_model.html#sec:N4JSModel">8.2.2. N4JSModel</a></li>
+<li><a href="project_model.html#sec:N4JSWorkspace">8.2.3. N4JSWorkspace</a></li>
+<li><a href="project_model.html#sec:N4JSProject">8.2.4. N4JSProject</a></li>
+<li><a href="project_model.html#sec:SourceContainer">8.2.5. SourceContainer</a></li>
+<li><a href="project_model.html#sec:N4JSProjectsStateHelper">8.2.6. N4JSProjectsStateHelper</a></li>
+</ul>
+</li>
+<li><a href="project_model.html#sec:Caching">8.3. Caching</a>
+<ul class="sectlevel3">
+<li><a href="project_model.html#_caching-of-externallibraryworkspace">8.3.1. Caching of ExternalLibraryWorkspace</a></li>
+<li><a href="project_model.html#_caching-of-n4jsprojectsstatehelper">8.3.2. Caching of N4JSProjectsStateHelper</a></li>
+</ul>
+</li>
+<li><a href="project_model.html#sec:WildcardPathFilter">8.4. WildcardPathFilter</a></li>
+<li><a href="project_model.html#sec:ProjectUtils">8.5. ProjectUtils</a></li>
+</ul>
+</li>
+<li><a href="binding.html#_binding">9. Binding</a>
+<ul class="sectlevel2">
+<li><a href="binding.html#sec:Binding_Design_Rationale">9.1. Design Rationale</a></li>
+<li><a href="binding.html#sec:Binding_to_Members">9.2. Binding to Members</a></li>
+<li><a href="binding.html#sec:Binding_Getter_Setter">9.3. Getter / Setter Binding</a></li>
+<li><a href="binding.html#chap:Statics">9.4. Static Member Binding</a></li>
+<li><a href="binding.html#sec:Binding_Enumeration">9.5. Enumeration Literals Binding</a></li>
+<li><a href="binding.html#sec:Accessibility_of_types_and_members">9.6. Accessibility of types and members</a></li>
+<li><a href="binding.html#sec:Member_Scope_Example">9.7. Member Scope Example</a></li>
+<li><a href="binding.html#sec:Scoping_for_Members_of_Composed_Type_Explained">9.8. Scoping for Members of Composed Type (Union/Intersection) Example</a></li>
+<li><a href="binding.html#sec:Binding_of_Structurally_References_Types">9.9. Structurally References Types</a></li>
+<li><a href="binding.html#sec:Building">9.10. Building</a>
+<ul class="sectlevel3">
+<li><a href="binding.html#sec:Build_Phases">9.10.1. Build Phases</a></li>
+<li><a href="binding.html#sec:Build_Scenarios">9.10.2. Build Scenarios</a></li>
+<li><a href="binding.html#sec:Lazy_linking_problem">9.10.3. Lazy linking problem</a></li>
+</ul>
+</li>
+<li><a href="binding.html#sec:Proxies_and_Proxy_Resolution">9.11. Proxies and Proxy Resolution (Overview)</a>
+<ul class="sectlevel3">
+<li><a href="binding.html#xtexts-lazy-linking-proxies">9.11.1. Xtext’s Lazy Linking Proxies</a></li>
+<li><a href="binding.html#standard-emf-proxies">9.11.2. Standard EMF Proxies</a></li>
+<li><a href="binding.html#_how-is-proxy-resolution-triggered">9.11.3. How is Proxy Resolution Triggered?</a></li>
+<li><a href="binding.html#_when-is-proxy-resolution-allowed">9.11.4. When is Proxy Resolution Allowed?</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="validation.html#_validation">10. Validation</a>
+<ul class="sectlevel2">
+<li><a href="validation.html#sec:validation_overview">10.1. Validation overview</a></li>
+<li><a href="validation.html#sec:validation_control_flow">10.2. Validation control flow</a></li>
+<li><a href="validation.html#sec:validation_issue_ids">10.3. Issue IDs and Messages</a></li>
+<li><a href="validation.html#sec:validation_usage_patterns">10.4. Usage Pattern</a></li>
+<li><a href="validation.html#sec:validation_links">10.5. Links</a></li>
+</ul>
+</li>
+<li><a href="references.html#_references">11. References</a>
+<ul class="sectlevel2">
+<li><a href="references.html#sec:usecases">11.1. Use cases</a></li>
+<li><a href="references.html#sec:calculation_algorithm">11.2. Calculation algorithm</a>
+<ul class="sectlevel3">
+<li><a href="references.html#sec:Xtext_default_implementation">11.2.1. Xtext default implementation</a></li>
+<li><a href="references.html#sec:N4_implementation">11.2.2. N4JS implementation</a></li>
+</ul>
+</li>
+<li><a href="references.html#sec:PerformanceOfDependencyCalculation">11.3. Performance Of Dependency Calculation</a></li>
+<li><a href="references.html#sec:kinds_of_references">11.4. Kinds of references</a>
+<ul class="sectlevel3">
+<li><a href="references.html#sec:Cross_References_to_be_ignored">11.4.1. Cross References to be ignored</a></li>
+<li><a href="references.html#sec:Cross_References_to_be_handled">11.4.2. Cross References to be handled</a></li>
+</ul>
+</li>
+<li><a href="references.html#sec:transitive_dependencies">11.5. Transitive dependencies</a></li>
+<li><a href="references.html#sec:find-references">11.6. Find references</a>
+<ul class="sectlevel3">
+<li><a href="references.html#_background">11.6.1. Background</a></li>
+<li><a href="references.html#_how-find-references-work">11.6.2. How Find References Work</a>
+<ul class="sectlevel4">
+<li><a href="references.html#_step-1-convert-cursor-position-to-declared-element">11.6.2.1. Step 1: Convert Cursor Position to Declared Element</a></li>
+<li><a href="references.html#_step-2-convert-declared-element-to-target-uris">11.6.2.2. Step 2: Convert Declared Element to Target URIs</a></li>
+<li><a href="references.html#_step-3-filter-potential-resources">11.6.2.3. Step 3: Filter Potential Resources</a></li>
+<li><a href="references.html#_step-4-search-references-in-resource">11.6.2.4. Step 4: Search References in Resource</a></li>
+<li><a href="references.html#_limitations-and-possible-enhancements">11.6.2.5. Limitations and Possible Enhancements</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="compilation.html#_compilation">12. Compilation</a>
+<ul class="sectlevel2">
+<li><a href="compilation.html#chap:compilation">12.1. Introduction</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:general_design_rationals">12.1.1. General design rationals</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:logging_and_error_reporting">12.1.1.1. Logging and error reporting</a></li>
+<li><a href="compilation.html#sec:progress_monitor">12.1.1.2. Progress monitor</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Xtext_Integration">12.1.2. Xtext Integration</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:xtext_default_behaviour">12.1.2.1. Xtext default behaviour</a></li>
+<li><a href="compilation.html#sec:n4js_requirements">12.1.2.2. N4JS requirements</a></li>
+<li><a href="compilation.html#sec:compiler_discovery_in_ui">12.1.2.3. Compiler discovery in UI</a></li>
+<li><a href="compilation.html#sec:compiler_discovery_in_headless">12.1.2.4. Compiler discovery in headless</a></li>
+<li><a href="compilation.html#sec:general_generator_implementation">12.1.2.5. General generator implementation</a></li>
+<li><a href="compilation.html#sec:general_generator_activation">12.1.2.6. General generator activation</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Overview_of_Input_Models">12.1.3. Overview of the Input Models</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Core_Generator">12.2. Generators</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:Compiler_Components">12.2.1. Generator Components</a></li>
+<li><a href="compilation.html#sec:Generator_architecture">12.2.2. Generator architecture</a></li>
+<li><a href="compilation.html#sec:Unified_Compiler_Configuration">12.2.3. Unified Compiler Configuration</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Transpilers">12.3. Transpilers</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:Phases">12.3.1. Overview</a></li>
+<li><a href="compilation.html#relation-between-ast-and-im">12.3.2. Relation between AST and IM</a></li>
+<li><a href="compilation.html#implementation-overview">12.3.3. Implementation Overview</a></li>
+<li><a href="compilation.html#sec:Guidelines_for_Implementing_Transformations">12.3.4. Guidelines for Implementing Transformations</a></li>
+<li><a href="compilation.html#symbol-table-in-the-im">12.3.5. Symbol Table in the IM</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:N4JS_to_EcmaScript_Transpiler">12.4. N4JS-to-EcmaScript Transpiler</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:Overview_of_Transformations">12.4.1. Overview of Transformations</a></li>
+<li><a href="compilation.html#sec:Transpiling_members">12.4.2. Transpiling members</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:Transpiling_members__Delegating_members">12.4.2.1. Techniques for special member handling</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__Partial_shadowing_of_getter_setter_pairs">12.4.2.2. Partial shadowing</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__Consuming_or_inheriting_members_of_an_interface">12.4.2.3. Consuming or inheriting members of an interface</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__Static_polyfill">12.4.2.4. Static polyfill</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__API_implementation_stubs">12.4.2.5. API / implementation stubs</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Support_for_incomplete_API_implementation_testing_in_the_N4JS_to_EcmaScript_5_Transpiler">12.4.3. Support for incomplete API implementation testing</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:Modifications_in_Impl_projects">12.4.3.1. Modifications in Impl projects</a></li>
+<li><a href="compilation.html#sec:Implementation_of_stub_generation">12.4.3.2. Implementation of stub-generation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:n4jsc_Headless_Compiler_Interface">12.5. n4jsc Headless Compiler Interface</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:building_the_headless_compiler">12.5.1. building the headless compiler</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="execution.html#_execution">13. Execution</a>
+<ul class="sectlevel2">
+<li><a href="execution.html#sec:N4JS_Project_Execution_And_Linking_Model">13.1. N4JS Project Execution And Linking Model</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#subsec:N4JS_Execution_With_NodeJS">13.1.1. N4JS Execution With NodeJS</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:N4JS_Execution_And_Linking_File">13.2. N4JS Execution And Linking File</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#subsec:NodeJS_Specific_ELF">13.2.1. NodeJS Specific ELF</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Runners-execution">13.3. Runners</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#subsec:N4_Runtime_Environments_Convention">13.3.1. N4 Runtime Environments Convention</a></li>
+<li><a href="execution.html#subsec:Passing_Information_from_IDE_to_Execution_Code_in_Runtime_Environment">13.3.2. Passing Information from IDE to Execution Code in Runtime Environment</a></li>
+<li><a href="execution.html#subsec:Runners_Design">13.3.3. Runners Design</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Legacy_Execution_Engine">13.4. Legacy Execution Engine</a></li>
+<li><a href="execution.html#sec:Design">13.5. Design</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#sec:Usage_Outside_N4JSIDE">13.5.1. Usage Outside N4JSIDE</a>
+<ul class="sectlevel4">
+<li><a href="execution.html#sec:Use_Node_with_Maven">13.5.1.1. Use Node with Maven</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Usage_Inside_N4JSIDE">13.5.2. Usage Inside N4JSIDE</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Runtime_Injection">13.6. Runtime Injection</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#sec:Running_String_Code">13.6.1. Running String Code</a></li>
+<li><a href="execution.html#sec:Running_File_Code">13.6.2. Running File Code</a></li>
+<li><a href="execution.html#sec:Injection_Code_Example">13.6.3. Injection Code Example</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#_tests">14. Tests</a>
+<ul class="sectlevel2">
+<li><a href="tests.html#sec:Performance_Tests">14.1. Performance Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Synthetic_Performance_Tests">14.1.1. Synthetic Performance Tests</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:Design_of_Generator">14.1.1.1. Design of Generator</a></li>
+<li><a href="tests.html#sec:Design_of_Performance_Test_Execution">14.1.1.2. Design of Performance Test Configuration and Execution</a></li>
+<li><a href="tests.html#sec:JUnit_Configuration">14.1.1.3. JUnit Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Test_Configuration">14.1.1.4. JUnitBenchmark Test Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Report_Configuration">14.1.1.5. JUnitBenchmark Report Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Run_Configuration">14.1.1.6. JUnitBenchmark Run Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Example">14.1.1.7. JUnitBenchmark Example</a></li>
+<li><a href="tests.html#sec:Note_on_Jenkins_Job">14.1.1.8. Note on Jenkins Job</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#sec:ECMA_Tests">14.2. ECMA Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Grammar_Tests">14.2.1. Grammar Tests</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:Negative_Tests">14.2.1.1. Negative Tests</a></li>
+<li><a href="tests.html#sec:Test_Exclusion">14.2.1.2. Test Exclusion</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Integration_Tests">14.3. Integration Tests</a></li>
+<li><a href="tests.html#sec:Test_Helpers">14.4. Test Helpers</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Parameterized_N4JS_Tests">14.4.1. Parameterized N4JS tests</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:ParameterizedXtextRunner">14.4.1.1. ParameterizedXtextRunner</a></li>
+<li><a href="tests.html#sec:TestCodeProvider">14.4.1.2. TestCodeProvider</a></li>
+<li><a href="tests.html#sec:Example_Of_Parameterized_Parser_Test">14.4.1.3. Example of parameterized parser test</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Issue_Suppression">14.5. Issue Suppression</a></li>
+<li><a href="tests.html#sec:Xpect_Tests">14.6. Xpect Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Xpect_Test_Setup">14.6.1. Xpect Test Setup</a></li>
+<li><a href="tests.html#sec:Xpect_Issue_Suppression">14.6.2. Xpect Issue Suppression</a></li>
+<li><a href="tests.html#sec:Xpect_Provided_Test_Methods">14.6.3. Xpect Provided Test Methods</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#errors">14.6.3.1. errors</a></li>
+<li><a href="tests.html#warnings">14.6.3.2. warnings</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:N4JS_Specific_Xpect_Test_Methods">14.6.4. N4JS Specific Xpect Test Methods</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:XPECT_noerrors">14.6.4.1. noerrors and nowarnings</a></li>
+<li><a href="tests.html#sec:XPECT_scope">14.6.4.2. scope</a></li>
+<li><a href="tests.html#sec:XPECT_scopeWithPosition">14.6.4.3. scopeWithPosition</a></li>
+<li><a href="tests.html#sec:XPECT_scopeWithResource">14.6.4.4. scopeWithResource</a></li>
+<li><a href="tests.html#sec:XPECT_binding">14.6.4.5. binding</a></li>
+<li><a href="tests.html#sec:XPECT_linkedPathname">14.6.4.6. linkedPathname</a></li>
+<li><a href="tests.html#sec:XPECT_type_of">14.6.4.7. type of</a></li>
+<li><a href="tests.html#sec:XPECT_expectedType">14.6.4.8. expectedType</a></li>
+<li><a href="tests.html#sec:XPECT_elementKeyword">14.6.4.9. elementKeyword</a></li>
+<li><a href="tests.html#sec:XPECT_accessModifier">14.6.4.10. accessModifier</a></li>
+<li><a href="tests.html#sec:XPECT_compileResult">14.6.4.11. compileResult</a></li>
+<li><a href="tests.html#sec:XPECT_output">14.6.4.12. output</a></li>
+<li><a href="tests.html#sec:XPECT_outputRegEx">14.6.4.13. outputRegEx</a></li>
+<li><a href="tests.html#sec:XPECT_calculatedAccessModifier">14.6.4.14. calculatedAccessModifier</a></li>
+<li><a href="tests.html#sec:XPECT_spec">14.6.4.15. spec</a></li>
+<li><a href="tests.html#sec:XPECT_deadCode">14.6.4.16. deadCode</a></li>
+<li><a href="tests.html#sec:XPECT_returnOrThrows">14.6.4.17. returnOrThrows</a></li>
+<li><a href="tests.html#sec:XPECT_lint">14.6.4.18. lint</a></li>
+<li><a href="tests.html#sec:XPECT_lintFails">14.6.4.19. lintFails</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:FIXME_Xpect_modifier">14.6.5. FIXME Xpect modifier</a></li>
+<li><a href="tests.html#sec:Expectmatrix_Xpect_Test_Methods">14.6.6. Expectmatrix Xpect tests</a></li>
+<li><a href="tests.html#xpect-lint-tests">14.6.7. Xpect Lint Tests</a></li>
+</ul>
+</li>
+<li><a href="tests.html#xpect-proposal-tests">14.7. Xpect Proposal Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Validation_vs__Non_Validation">14.7.1. Validation vs. Non-Validation</a></li>
+<li><a href="tests.html#sec:General_Proposal_Test_Features">14.7.2. General Proposal Test Features</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:Test_Variables">14.7.2.1. Test Variables</a></li>
+<li><a href="tests.html#sec:Location_and_Selection">14.7.2.2. at – Location and Selection</a></li>
+<li><a href="tests.html#sec:Multi_Line_Expectations_in_Proposal_Tests">14.7.2.3. Multi Line Expectations in Proposal Tests</a></li>
+<li><a href="tests.html#sec:Timeout">14.7.2.4. Timeout and Performance</a></li>
+</ul>
+</li>
+<li><a href="tests.html#proposals-verify-existence-of-proposals">14.7.3. proposals – Verify Existence of Proposals</a></li>
+<li><a href="tests.html#sec:Verify_displayed_string">14.7.4. display – Verify displayed string</a></li>
+<li><a href="tests.html#sec:Apply_Proposal">14.7.5. apply – Apply Proposal</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#resource-application-in-other-files">14.7.5.1. resource – application in other files</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Content_Assist_Cycling">14.7.6. kind – Content Assist Cycling</a></li>
+<li><a href="tests.html#fileValidVerify-validation-status">14.7.7. fileValid – Verify validation status</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Apply_Proposal_And_Execute_Tests">14.8. Apply Proposal And Execute Tests</a></li>
+<li><a href="tests.html#sec:Organize_Imports_Test">14.9. Organize Imports Test</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#organizeimports">14.9.1. organizeImports</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Access_Control_Test">14.10. Access Control Test</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#test-scenarios">14.10.1. Test Scenarios</a></li>
+<li><a href="tests.html#n4js-code-generator">14.10.2. N4JS Code Generator</a></li>
+<li><a href="tests.html#xtext-issue-matcher">14.10.3. Xtext Issue Matcher</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Smoke_Tests">14.11. Smoke Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#how-to-handle-smoke-test-errors">14.11.1. How to handle smoke test errors?</a></li>
+<li><a href="tests.html#smoketester-and-exceptionanalyzer">14.11.2. SmokeTester and ExceptionAnalyzer</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:UI_Tests_with_SWTBot">14.12. UI Tests with SWTBot</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#writing-swtbot-tests">14.12.1. Writing SWTBot Tests</a></li>
+<li><a href="tests.html#running-swtbot-tests">14.12.2. Running SWTBot Tests</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Debugging_UI_Tests">14.13. Debugging UI Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Connecting_to_the_X_server_on_the_build_node">14.13.1. Connecting to the X-server on the build-node</a></li>
+<li><a href="tests.html#sec:Tools_to_investigate_the_java_stack">14.13.2. Tools to investigate the java-stack</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#_ui-concepts">15. UI Concepts</a>
+<ul class="sectlevel2">
+<li><a href="#sec:User_Interface_Concepts">15.1. User Interface Concepts</a>
+<ul class="sectlevel3">
+<li><a href="#sec:Eclipse_UI_Concepts">15.1.1. Eclipse UI Concepts</a>
+<ul class="sectlevel4">
+<li><a href="#sec:Label_Provider">15.1.1.1. Label Provider</a></li>
+<li><a href="#sec:Markers">15.1.1.2. Markers</a></li>
+<li><a href="#sec:Commands__Toolbar_and_Menus">15.1.1.3. Commands, Toolbar and Menus</a></li>
+<li><a href="#sec:Content_Assist">15.1.1.4. Content Assist</a></li>
+<li><a href="#sec:Quick_Fixes">15.1.1.5. Quick Fixes</a></li>
+<li><a href="#sec:Quick_Assist">15.1.1.6. Quick Assist</a></li>
+<li><a href="#sec:Clean_Up_Actions">15.1.1.7. Clean Up Actions</a></li>
+<li><a href="#sec:Save_Actions">15.1.1.8. Save Actions</a></li>
+<li><a href="#sec:Auto_Edit">15.1.1.9. Auto Edit</a></li>
+<li><a href="#sec:Template_Proposals">15.1.1.10. Template Proposals</a></li>
+<li><a href="#sec:Outline_View___Quick_Outline">15.1.1.11. Outline View / Quick Outline</a></li>
+<li><a href="#sec:Navigator__Package_Explorer__Project_Explorer">15.1.1.12. Navigator, Package Explorer, Project Explorer</a></li>
+<li><a href="#sec:Hyperlinking_and_Navigation">15.1.1.13. Hyperlinking and Navigation</a></li>
+<li><a href="#sec:Syntax_and_Semantic_Coloring">15.1.1.14. Syntax and Semantic Coloring</a></li>
+<li><a href="#sec:Code_Formatter">15.1.1.15. Code Formatter</a></li>
+<li><a href="#sec:Wizards">15.1.1.16. Wizards</a></li>
+<li><a href="#sec:Cheat_Sheets">15.1.1.17. Cheat Sheets</a></li>
+<li><a href="#sec:Context_sensitive_Help">15.1.1.18. Context-sensitive Help</a></li>
+<li><a href="#sec:Hovers">15.1.1.19. Hovers</a></li>
+<li><a href="#sec:Folding">15.1.1.20. Folding</a></li>
+<li><a href="#sec:Customizable_validation___severity">15.1.1.21. Customizable validation / severity</a></li>
+<li><a href="#sec:Proposals">15.1.1.22. Proposals</a></li>
+</ul>
+</li>
+<li><a href="#sec:Non_Eclipse_UI_Concepts">15.1.2. Non-Eclipse UI Concepts</a>
+<ul class="sectlevel4">
+<li><a href="#sec:Overlays">15.1.2.1. Overlays</a></li>
+<li><a href="#sec:Goto__Inferred__Type">15.1.2.2. Goto (Inferred) Type</a></li>
+<li><a href="#sec:Postfix_Completion">15.1.2.3. Postfix Completion</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#_user-interface-resources">15.2. User Interface Resources</a>
+<ul class="sectlevel3">
+<li><a href="#_icons">15.2.1. Icons</a>
+<ul class="sectlevel4">
+<li><a href="#_eclipse-platform-icons">15.2.1.1. Eclipse Platform Icons</a></li>
+<li><a href="#_n4js-specific-icons">15.2.1.2. N4JS Specific Icons</a></li>
+<li><a href="#_high-resolution-icons">15.2.1.3. High Resolution Icons</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="formatting.html#_formatting">16. Formatting</a>
+<ul class="sectlevel2">
+<li><a href="formatting.html#sec:FmtObjective">16.1. Objective</a>
+<ul class="sectlevel3">
+<li><a href="formatting.html#sec:FmtFormatting_Comments">16.1.1. Formatting Comments</a></li>
+</ul>
+</li>
+<li><a href="formatting.html#sec:FmtArchitecture">16.2. Architecture</a>
+<ul class="sectlevel3">
+<li><a href="formatting.html#sec:Implementation_example">16.2.1. Implementation example</a></li>
+</ul>
+</li>
+<li><a href="formatting.html#sec:FmtFormatter_Implementation_Guidelines">16.3. Formatter Implementation Guidelines</a></li>
+<li><a href="formatting.html#sec:FmtConfiguration">16.4. Configuration</a></li>
+<li><a href="formatting.html#sec:FmtUI_Integration">16.5. UI Integration</a></li>
+<li><a href="formatting.html#sec:FmtUnit_Testing_with_Xpect">16.6. Unit Testing with Xpect</a></li>
+</ul>
+</li>
+<li><a href="external_libraries.html#_external-libraries">17. External Libraries</a>
+<ul class="sectlevel2">
+<li><a href="external_libraries.html#sec:Major_Components">17.1. Major Components</a>
+<ul class="sectlevel3">
+<li><a href="external_libraries.html#subsec:External_Resources">17.1.1. External Resources</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Workspace">17.1.2. External Library Workspace</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Preference_Store">17.1.3. External Library Preference Store</a></li>
+<li><a href="external_libraries.html#subsec:npm_Manager">17.1.4. Library Manager</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Builder_Helper">17.1.5. External Library Builder</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Xtext_Index_Persister">17.1.6. External Library Xtext Index Persister</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Preference_Page">17.1.7. External Library Preference Page</a></li>
+</ul>
+</li>
+<li><a href="external_libraries.html#sec:Headless_External_Library_Support">17.2. Headless External Library Support</a>
+<ul class="sectlevel3">
+<li><a href="external_libraries.html#_custom-npm-settings">17.2.1. Custom npm settings</a></li>
+</ul>
+</li>
+<li><a href="external_libraries.html#sec:lmFutureWork">17.3. Future Work</a>
+<ul class="sectlevel3">
+<li><a href="external_libraries.html#subsec:lmMultipleDependencyScope">17.3.1. Multiple Dependency Scope</a></li>
+<li><a href="external_libraries.html#subsec:lmRunTestsFromLibrary">17.3.2. Run Tests from TestLibrary</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="json_support.html#sec:JSON_Support">18. JSON Support</a>
+<ul class="sectlevel2">
+<li><a href="json_support.html#sec:JSON_Parser">18.1. JSON Parser</a>
+<ul class="sectlevel3">
+<li><a href="json_support.html#sec:JSON_Parser_Unicode_Escaping">18.1.1. Escaping Unicode Control Characters in String Literals</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Empty_Text">18.1.2. Empty Text</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Nested_Structures">18.1.3. Nested Structures</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Whitespace">18.1.4. Whitespace</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Comments">18.1.5. Comments</a></li>
+</ul>
+</li>
+<li><a href="json_support.html#sec:JSON_Language_Extensions">18.2. JSON Language Extensions</a>
+<ul class="sectlevel3">
+<li><a href="json_support.html#sec:JSON_Validator_Extensions">18.2.1. JSON Validator Extensions</a>
+<ul class="sectlevel4">
+<li><a href="json_support.html#sec:File_Specitic_Validator_Extensions">18.2.1.1. File-Specific Validator Extensions</a></li>
+<li><a href="json_support.html#sec:JSON_Declarative_JSON_Validator_Extensions">18.2.1.2. Declarative JSON Validator Extensions</a></li>
+</ul>
+</li>
+<li><a href="json_support.html#_json-resource-description-strategy">18.2.2. JSON Resource Description Strategy</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_jsdoc">19. JSDoc</a>
+<ul class="sectlevel2">
+<li><a href="jsdoc.html#sec:Design_Rationale">19.1. Design Rationale</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#_general-design">19.1.1. General Design</a></li>
+<li><a href="jsdoc.html#sec:Type_Expressions">19.1.2. Type Expressions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="docexporter.html#_docexporter">20. DocExporter</a>
+<ul class="sectlevel2">
+<li><a href="docexporter.html#sec:Specification_Exporter">20.1. Specification Exporter</a></li>
+</ul>
+</li>
+<li><a href="rename_refactoring.html#_rename-refactoring">21. Rename Refactoring</a>
+<ul class="sectlevel2">
+<li><a href="rename_refactoring.html#_rename-refactoring-ui-interaction">21.1. Rename Refactoring UI interaction</a></li>
+<li><a href="rename_refactoring.html#_renameelementprocessor-interaction">21.2. RenameElementProcessor interaction</a></li>
+</ul>
+</li>
+<li><a href="flow_graphs.html#chap:flowgraphs">22. Flow Graphs</a>
+<ul class="sectlevel2">
+<li><a href="flow_graphs.html#sec:flowgraphs_overview">22.1. Flow graphs overview</a>
+<ul class="sectlevel3">
+<li><a href="flow_graphs.html#_internal-graph">22.1.1. Internal graph</a></li>
+<li><a href="flow_graphs.html#_optimizations">22.1.2. Optimizations</a></li>
+<li><a href="flow_graphs.html#_api-for-client-analyses">22.1.3. API for client analyses</a>
+<ul class="sectlevel4">
+<li><a href="flow_graphs.html#_mapping-from-internal-to-ast-elements">22.1.3.1. Mapping from internal to AST elements</a></li>
+<li><a href="flow_graphs.html#_graph-visitor">22.1.3.2. Graph visitor</a></li>
+<li><a href="flow_graphs.html#_graph-explorer">22.1.3.3. Graph explorer</a></li>
+<li><a href="flow_graphs.html#_branch-walker">22.1.3.4. Branch walker</a></li>
+<li><a href="flow_graphs.html#_example-1-compute-string-for-each-path">22.1.3.5. Example 1: Compute string for each path</a></li>
+<li><a href="flow_graphs.html#_path-quantor">22.1.3.6. Path quantor</a></li>
+</ul>
+</li>
+<li><a href="flow_graphs.html#_control-flow-analyses">22.1.4. Control flow analyses</a>
+<ul class="sectlevel4">
+<li><a href="flow_graphs.html#_dead-code-analysis">22.1.4.1. Dead code analysis</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="flow_graphs.html#sec:dataflow">22.2. Dataflow</a>
+<ul class="sectlevel3">
+<li><a href="flow_graphs.html#_dataflow-graph">22.2.1. Dataflow graph</a></li>
+<li><a href="flow_graphs.html#_dataflow-analyses">22.2.2. Dataflow analyses</a>
+<ul class="sectlevel4">
+<li><a href="flow_graphs.html#_def-def-def-nothing-analysis">22.2.2.1. Def&#8594;Def / Def&#8594;Nothing analysis</a></li>
+<li><a href="flow_graphs.html#_def-use-decl-analysis">22.2.2.2. Def|Use&#8592;Decl analysis</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="publish_npms.html#sec:publish-npms-to-public">23. Publish npms</a>
+<ul class="sectlevel2">
+<li><a href="publish_npms.html#sec:publish-npms-n4js-maven">23.1. Publish n4js-libs to during  maven build</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Hints">Appendix A: Hints</a>
+<ul class="sectlevel2">
+<li><a href="appendix_a_hints.html#sec:XtextInjection">A.1. Xtext Injection</a>
+<ul class="sectlevel3">
+<li><a href="appendix_a_hints.html#sec:DI_MultipleInjectors_Singletons">A.1.1. Multiple Injectors and Singletons</a>
+<ul class="sectlevel4">
+<li><a href="appendix_a_hints.html#sec:DI_avoid_duplicate_singletons">A.1.1.1. Avoiding duplicate singletons</a>
+<ul class="sectlevel5">
+<li><a href="appendix_a_hints.html#sec:DI_binding_in_shared">A.1.1.1.1. Defining binding in the shared injector</a></li>
+<li><a href="appendix_a_hints.html#sec:DI_binding_in_custom">A.1.1.1.2. Defining binding in the custom injector</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:DI_Hints">A.1.2. Dependency Injection Hints</a>
+<ul class="sectlevel4">
+<li><a href="appendix_a_hints.html#sec:DI_custom_bundle">A.1.2.1. Use DI in custom bundle, use DI with extensions</a>
+<ul class="sectlevel5">
+<li><a href="appendix_a_hints.html#sec:DI_custom_bundle_problem">A.1.2.1.1. Problem</a></li>
+<li><a href="appendix_a_hints.html#sec:DI_custom_bundle_solution">A.1.2.1.2. Solution</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Access_Other_DSL_Injector">A.1.2.2. How do I get the Guice Injector of my language?</a>
+<ul class="sectlevel5">
+<li><a href="appendix_a_hints.html#sec:DSL_Injector_UI_context">A.1.2.2.1. UI context</a></li>
+<li><a href="appendix_a_hints.html#sec:DSL_Injector_Non_UI_context">A.1.2.2.2. Non UI context but with injection context</a></li>
+<li><a href="appendix_a_hints.html#sec:DSL_Injector_Non_UI_non_injection_context">A.1.2.2.3. Non UI context without injection context</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Cancel_Indicator">A.1.2.3. How do I get cancel indicators in different contexts?</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Eclipse">A.2. Eclipse</a>
+<ul class="sectlevel3">
+<li><a href="appendix_a_hints.html#sec:Show_Xtext_Index">A.2.1. Show the current Xtext index</a></li>
+<li><a href="appendix_a_hints.html#sec:Plugin_spy">A.2.2. Plug-in spy</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Maven-hints">A.3. Maven</a>
+<ul class="sectlevel3">
+<li><a href="appendix_a_hints.html#how-to-check-for-maven-mojo-updates">A.3.1. How to check for Maven MOJO updates</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#_module-loading">Appendix B: Module Loading</a>
+<ul class="sectlevel2">
+<li><a href="appendix_b_module_loading.html#sec:Dependency_Management">B.1. Dependency Management</a></li>
+<li><a href="appendix_b_module_loading.html#ecmascript-modules">B.2. ECMAScript Modules</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:ES5_Modules_Systems">B.2.1. ES5 Modules Systems</a></li>
+<li><a href="appendix_b_module_loading.html#sec:ES6_Modules">B.2.2. ES6 Modules</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:ECMAScript_Module_Loaders">B.3. ECMAScript Module Loaders</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:ES6_Module_Loaders">B.3.1. ES6 Module Loaders</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Polyfills_for_ES6_Module_Loaders">B.3.2. Polyfills for ES6 Module Loaders</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:es6_module_loader">B.3.2.1. es6-module-loader</a></li>
+<li><a href="appendix_b_module_loading.html#sec:SystemJS">B.3.2.2. SystemJS</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Demo">B.3.2.3. Demo</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#case-study-typescript">B.4. Case Study : TypeScript</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:ES6_Modules_Support">B.4.1. ES6 Modules Support</a></li>
+<li><a href="appendix_b_module_loading.html#sec:TypeScript_and_Module_Loading">B.4.2. TypeScript and Module Loading</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Cyclic_Dependencies">B.5. Cyclic Dependencies</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:Setup">B.5.1. Setup</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Transpile_and_Execute">B.5.2. Transpile and Execute</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Module_Format___AMD">B.5.2.1. Module Format = AMD</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Module_Format___CommonJS">B.5.2.2. Module Format = CommonJS</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Module_Format___SystemJS">B.5.2.3. Module Format = SystemJS</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Conclusion">B.5.3. Conclusion</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#system.register-as-transpilation-target">B.6. System.register as transpilation target</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:Introduction">B.6.1. Introduction</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:External_Transpilers">B.6.1.1. External Transpilers</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Example_of_a_System_register_module">B.6.1.2. Example of a System.register module</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Structure_of_a_System_register_module">B.6.2. Structure of a System.register module</a></li>
+<li><a href="appendix_b_module_loading.html#_transpilation-hints">B.6.3. Transpilation Hints</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Handling_Imports">B.6.3.1. Handling Imports</a></li>
+<li><a href="appendix_b_module_loading.html#sec:__exportFn__">B.6.3.2. &lt;&lt;exportFn&gt;&gt;</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Handling_Exports">B.6.3.3. Handling Exports</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Examples_w__Circular_Dependencies">B.6.4. Examples w/ Circular Dependencies</a></li>
+<li><a href="appendix_b_module_loading.html#sec:N4JS_Examples_w__Circular_Dependencies">B.6.5. N4JS Examples w/ Circular Dependencies</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Unresolved_Cyclic_Dependencies">B.6.5.1. Unresolved Cyclic Dependencies</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Variables___Functions">B.6.5.2. Examples with Variables &amp; Functions</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Classes">B.6.5.3. Examples with Classes</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Examples_with_SubClassing">B.6.5.4. Examples with SubClassing</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Miscellaneous">B.6.5.5. Miscellaneous</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#_resources">B.6.6. Resources</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:CommonJS_as_transpilation_target">B.7. CommonJS as transpilation target</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#_introduction-2">B.7.1. Introduction</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Transpilation_Hints">B.7.2. Transpilation Hints</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Import_Statements">B.7.2.1. Import Statements</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Export_Statements">B.7.2.2. Export Statements</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Tracking_Live_Bindings">B.7.2.3. Tracking Live Bindings</a></li>
+<li><a href="appendix_b_module_loading.html#sec:A_complete_example">B.7.2.4. A complete example</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#_resources-2">B.7.3. Resources</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_c_license.html#sec:License">Appendix C: License</a></li>
+<li><a href="appendix_d_acronyms.html#sec:Acronyms">Appendix D: Acronyms</a></li>
+<li><a href="appendix_e_bibliography_and_footnotes.html#_bibliography-and-footnotes">Appendix E: Bibliography and Footnotes</a></li>
+</ul>
+</div>
+</div>
+<div id="content"><div class="sect1">
+<h2 id="_ui-concepts"><a class="anchor" href="#_ui-concepts"></a><a class="link" href="#_ui-concepts">15. UI Concepts</a></h2>
+<div class="sectionbody">
+<div class="admonitionblock warning">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-warning" title=""></i>
+</td>
+<td class="content">
+Parts of this chapter may be outdated.
+</td>
+</tr>
+</table>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:User_Interface_Concepts"><a class="anchor" href="#sec:User_Interface_Concepts"></a><a class="link" href="#sec:User_Interface_Concepts">15.1. User Interface Concepts</a></h3>
+<div class="sect3">
+<h4 id="sec:Eclipse_UI_Concepts"><a class="anchor" href="#sec:Eclipse_UI_Concepts"></a><a class="link" href="#sec:Eclipse_UI_Concepts">15.1.1. Eclipse UI Concepts</a></h4>
+<div class="paragraph">
+<p>The following list gives an overview of Eclipse specific UI concepts and which classes are used for implementation.</p>
+</div>
+<div class="sect4">
+<h5 id="sec:Label_Provider"><a class="anchor" href="#sec:Label_Provider"></a><a class="link" href="#sec:Label_Provider">15.1.1.1. Label Provider</a></h5>
+<div class="paragraph">
+<p>Also provides decorations for icons and text labels.</p>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Example
+</td>
+<td class="hdlist2">
+<p>The representation of objects in the outline view or in search results.</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Eclipse API
+</td>
+<td class="hdlist2">
+<div class="ulist">
+<ul>
+<li>
+<p><code>o.e.jface.viewers.ILabelProvider</code> → without styes</p>
+</li>
+<li>
+<p><code>o.e.jface.viewers.DelegatingStyledCellLabelProvider.IStyledLabelProvider</code> → with styles Drawback: Depends on Image rather than ImageDescriptor (see below)</p>
+</li>
+</ul>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Xtext Specifics
+</td>
+<td class="hdlist2">
+<div class="ulist">
+<ul>
+<li>
+<p><code>Declarative API</code>  via reflective, polymorphic dispatching. <code>org.eclipse.xtext.ui.label.AbstractLabelProvider</code></p>
+</li>
+<li>
+<p>Allows to work with ImageDescriptors (non-ui-thread, can be composed), but cumbersome</p>
+</li>
+<li>
+<p>DefaultLabelProvider will be used everywhere (outline etc.), returns the <code>name</code>  (via reflection). You could bind specific label providers.</p>
+</li>
+<li>
+<p>DescriptionLabelProvider provides labels for objects from the Xtext index used by <code>open model element</code> , <code>find references</code>  – the later is already customized)</p>
+</li>
+</ul>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Best Practices
+</td>
+<td class="hdlist2">
+<p>Labels are often use-case specific, so a single label provider is not always useful Therefore, in Xtext are different label providers for different use cases. Use cases are defined and enumerated (see <code>DefaultUiModule.configure*Label*</code>).
++
+Often labels could be easier created where they are needed instead of using a label provider (even for things like OutlineView). (LabelProvider are maybe over-engineered). (Note: default label provider has dependencies to SWT, because it uses images, which are often not needed; also they are only called with an object and no further configuration).
++
+Images:
++</p>
+<div class="ulist">
+<ul>
+<li>
+<p>DeclarativeLabelProvider: text and image (String: path relative to icons folder; or: ImageDescriptor, or Image), put it into folder (needs to be called <code>icons</code> , otherwise bind another name)</p>
+</li>
+<li>
+<p>better use AbstractLabelProvider and use EMF concepts (easier to debug and handle)</p>
+</li>
+<li>
+<p>image format and size: sub-folders with 32, 12, 16, 24, etc. (look which sizes are needed); in about view maybe bigger; png (supports transparency)</p>
+</li>
+</ul>
+</div>
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Markers"><a class="anchor" href="#sec:Markers"></a><a class="link" href="#sec:Markers">15.1.1.2. Markers</a></h5>
+<div class="quoteblock">
+<blockquote>
+<div class="paragraph">
+<p>Markers are objects that may be associated with Workbench resources. There are many uses of markers in the Workbench&#8230;&#8203;
+Markers are shown in a marker view (Tasks, Problems or Bookmark view) or on the marker bar in the editor area.</p>
+</div>
+</blockquote>
+<div class="attribution">
+&#8212; Eclispe Help
+</div>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Examples
+</td>
+<td class="hdlist2">
+<p>Tasks, Problems, Bookmarks, Breakpoints, Trace information</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Eclipse API
+</td>
+<td class="hdlist2">
+<p><code>org.eclipse.core.resources.IMarker</code> and <code>IResource.findMarkers</code>
++</p>
+<div class="ulist">
+<ul>
+<li>
+<p>Marker types registered via extension point (basically String). A marker is more or less a Map of String &#8594; String with some meta information, e.g. the resource location in WS, line numbers, type</p>
+</li>
+<li>
+<p>Markers are very efficient (e.g., find markers of a certain type), cf Xtext Specifics</p>
+</li>
+<li>
+<p>For validation, some new marker types are already registered.</p>
+</li>
+</ul>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Xtext
+</td>
+<td class="hdlist2">
+<p>(2.6)
++</p>
+<div class="ulist">
+<ul>
+<li>
+<p>Todo-Markers are created during build, task list is populated by these markers.</p>
+</li>
+<li>
+<p><code>org.eclipse.xtext.tasks.ITaskFinder</code> (and default implementation is bound by default, can be replaced with custom implementation)</p>
+</li>
+</ul>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Best Practices
+</td>
+<td class="hdlist2">
+<p>In Xtend, markers are used to trace from original file to generated file. They are hidden (and not displayed), so in general markers can be used for non-UI-problems as well (but only available in Eclipse of course) clean up markers: no general solution, often managed by some (single) life-cycle aware class (e.g., Builder)</p>
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Commands__Toolbar_and_Menus"><a class="anchor" href="#sec:Commands__Toolbar_and_Menus"></a><a class="link" href="#sec:Commands__Toolbar_and_Menus">15.1.1.3. Commands, Toolbar and Menus</a></h5>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Examples
+</td>
+<td class="hdlist2">
+<p>Organize Imports,</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Eclipse API
+</td>
+<td class="hdlist2">
+<p>use Commands + Handlers instead of Actions (or ActionDelegates etc.)</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Xtext Specifics
+</td>
+<td class="hdlist2">
+<p>uses commands and handlers</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Best Practice
+</td>
+<td class="hdlist2">
+<p><strong>Use commands and handlers</strong> -
+handler usually only delegates to real thing (that is, retrieve parameters from context and call the real thing)<br>
+<strong>Register in pluginxml</strong> via ExecutableExtensionFactory to be able to use injection (also pre-generatd, e.g.:</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xml" data-lang="xml">            &lt;handler class="org.eclipse.n4js.ui.N4JSExecutableExtensionFactory:org.eclipse.xtext.ui.editor.handler.ValidateActionHandler"
+                          commandId="org.eclipse.n4js.N4JS.validate"&gt;</code></pre>
+</div>
+</div>
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p><strong>Undo</strong>: use TextEdit and MultiTextEdit (composed)<br>
+otherwise very low level</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Content_Assist"><a class="anchor" href="#sec:Content_Assist"></a><a class="link" href="#sec:Content_Assist">15.1.1.4. Content Assist</a></h5>
+<div class="quoteblock">
+<blockquote>
+<div class="paragraph">
+<p>Content assist allows you to provide context sensitive content completion upon user request. Popup windows (infopops) are used to propose possible text choices to complete a phrase. The user can select these choices for insertion in the text. Content assist also supports contextual infopops for providing the user with information that is related to the current position in the document.</p>
+</div>
+</blockquote>
+<div class="attribution">
+&#8212; Eclipse Help
+</div>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Risk
+</td>
+<td class="hdlist2">
+<p>Always needs longer than anticipated.</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Examples
+</td>
+<td class="hdlist2">
+<p>complete name of function in function call, complete keywords</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Eclipse API
+</td>
+<td class="hdlist2">
+<div class="ulist">
+<ul>
+<li>
+<p>IContentAssistant wraps the widget,</p>
+</li>
+<li>
+<p>IContentProposalProvider computes the (array of) CompletionProposal (quite cumbersome!).</p>
+</li>
+<li>
+<p>Many extension interfaces that provide valuable UI features.</p>
+</li>
+</ul>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Xtext Specifics
+</td>
+<td class="hdlist2">
+<div class="ulist">
+<ul>
+<li>
+<p>ConfigurableCompletionProposal implements the currently defined extension interfaces, provides getters to modify the proposal after the fact.</p>
+</li>
+<li>
+<p>Context: The ContentAssistContext is provided by the framework according to the current cursor position in the document (cf. <code>ContentAssisParser</code>), semantic context (semantic element) computed with best match strategy (worst case you get the root element). Multiple contexts may be valid at the very same cursor position since the replace region may be different for different proposals.</p>
+</li>
+<li>
+<p>Various abstracts above the JFace stuff are available in Xtext, some of the <code>over the top</code> , others quite handy.</p>
+</li>
+</ul>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Best Practices
+</td>
+<td class="hdlist2">
+<div class="ulist">
+<ul>
+<li>
+<p>List of follow elements can be supposed to be complete, no need to figure out them with regular expressions etc.</p>
+</li>
+<li>
+<p>in rare cases it is necessary to <code>manually</code>  scan the text context, e.g. to get the variable name based on the variable type. → we will provider a utility class for that using regex. NEVER search on the text with simple string methods.</p>
+</li>
+<li>
+<p>In N4JSProposalProvider, override pre-generated methods (see <code>AbstractN4JSProposalProvider</code>) – do not overload (with concrete semantic element)</p>
+</li>
+<li>
+<p>how to implement complete-methods:</p>
+<div class="ulist">
+<ul>
+<li>
+<p>inspect context, examine current semantic element provide elements from scope or hard coded proposal: see <a href="#sec:Proposals">Proposals</a></p>
+</li>
+</ul>
+</div>
+</li>
+</ul>
+</div>
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Quick_Fixes"><a class="anchor" href="#sec:Quick_Fixes"></a><a class="link" href="#sec:Quick_Fixes">15.1.1.5. Quick Fixes</a></h5>
+<div class="quoteblock">
+<blockquote>
+Users can select a problem marker and choose a Quick Fix from a popup containing the list of supplied fixes contributed for the marker.
+</blockquote>
+<div class="attribution">
+&#8212; Eclipse Help
+</div>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Examples
+</td>
+<td class="hdlist2">
+<p>Add Import, Add Override Annotation</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Eclipse API
+</td>
+<td class="hdlist2">
+<p>Based on ICompletionProposal (powerful)
++</p>
+<div class="ulist">
+<ul>
+<li>
+<p>QuickFixes are registered to marker (marker attribute: is fixable or not – this attribute is a guess only, there does not need to be a quick fix)</p>
+</li>
+<li>
+<p>MarkerResolutionGenerator (can also be used to fix several markers at once)</p>
+</li>
+</ul>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Xtext Specifics
+</td>
+<td class="hdlist2">
+<p>Based on ISematicModification (seemingly powerful but in fact weak) and IModification (less weak, but still very weak compared to ICompletionProposal) – only creates DocumentChanges.
++
+Declarativ API that links to issue codes via annotations on 'fix' methods in AbstractDeclarativeQuickfixProvider.</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Best Practices
+</td>
+<td class="hdlist2">
+<p>ICompletionProposal vs. DocumentChanges, ICompletionProposal is much more powerful. IModifications can also provide semantic changes, but not really recommended
++</p>
+<div class="ulist">
+<ul>
+<li>
+<p>Associated to isses via IssueCodes, @Fix similar to @Check API – only less powerful Xtext abstraction (no ICompletionProposal)</p>
+</li>
+<li>
+<p>use issue data to provide hints for fix labels (which should be fast!) or solution strategies (but only strings) → do not compute the label for the fix from the model!</p>
+</li>
+<li>
+<p>share code between checks and fixes → no built-in pattern, come up with utility methods (maybe define conventions)</p>
+</li>
+<li>
+<p>maybe Sebastian can add a solution that more information is available via @Fix-approach</p>
+</li>
+<li>
+<p>no order of quickfixes (sorted by name and priority, latter is not provided by default)</p>
+</li>
+<li>
+<p>there can be several @Fix for a single issue code, or pass arbitrary number of resolution to the acceptor</p>
+</li>
+<li>
+<p>for most cases simple Xtext quick fix api is good enough (e.g. all Xtend quick fixes use that)
++
+→ Xtext feature request: solve multiple markers at a time (possible to do that right now: bind custom <code>XtextQuickAssistProcessor</code>, override <code>MarkerResolutionGenerator.getAdaptedResolutions(List&lt;IssueResolution&gt;</code>) – return a WorkbenchMarkerResolution)</p>
+</li>
+</ul>
+</div>
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Quick_Assist"><a class="anchor" href="#sec:Quick_Assist"></a><a class="link" href="#sec:Quick_Assist">15.1.1.6. Quick Assist</a></h5>
+<div class="quoteblock">
+<blockquote>
+"Quick assists perform local code transformations. They are invoked on a selection or a single cursor in the Java editor and use the same shortcut as quick fixes (Ctrl+1), but quick assist are usually hidden when an error is around. To show them even with errors present on the same line, press Ctrl+1 a second time."  (Eclipse Help)
+</blockquote>
+</div>
+<div class="paragraph">
+<p><code>like a quickfix without a problem</code></p>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Examples
+</td>
+<td class="hdlist2">
+<p>Add/remove inferred types</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Eclipse API
+</td>
+<td class="hdlist2">
+<p>Takes cursor position</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Xtext
+</td>
+<td class="hdlist2">
+<p>no Xtext support, e.g. no default implementation (XtextQuickAssistProcessor is a quick fix provider, has nothing to do with QuickAssist) but: XtextQuickAssistProcessor, override canAssist, override computeQuickAssistProposals</p>
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Clean_Up_Actions"><a class="anchor" href="#sec:Clean_Up_Actions"></a><a class="link" href="#sec:Clean_Up_Actions">15.1.1.7. Clean Up Actions</a></h5>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Examples
+</td>
+<td class="hdlist2">
+<p>Remove unused local vars, sort members</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Eclipse API
+</td>
+<td class="hdlist2">
+<p>None, JDT specific (see ICleanUp)</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Xtext Specifics
+</td>
+<td class="hdlist2">
+<p>None</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Best Practice
+</td>
+<td class="hdlist2">
+<p>Monkey sees - Monkey does (look at JDT), In the end a it’s a CompositeRefactoring, which is a CompletionProposal</p>
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Save_Actions"><a class="anchor" href="#sec:Save_Actions"></a><a class="link" href="#sec:Save_Actions">15.1.1.8. Save Actions</a></h5>
+<div class="paragraph">
+<p>Similar to clean up actions but performed on save</p>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Examples
+</td>
+<td class="hdlist2">
+<p>Format on save, Organize imports on save</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Eclipse API
+</td>
+<td class="hdlist2">
+<p>None, JDT specific (see IPostSaveListener)</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Xtext Specifics
+</td>
+<td class="hdlist2">
+<p>None</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Best Practice
+</td>
+<td class="hdlist2">
+<p>XtextDocumentProvider.doSaveDocument (maybe better solutions in the future ;-) )</p>
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Auto_Edit"><a class="anchor" href="#sec:Auto_Edit"></a><a class="link" href="#sec:Auto_Edit">15.1.1.9. Auto Edit</a></h5>
+<div class="paragraph">
+<p>Auto edit is about closing braces that just have been typed, adding indentation after a line break the code snippet <code>if (true)</code> so basically it should be unobtrusive typing aids.</p>
+</div>
+<div class="paragraph">
+<p>By default, restore model structure when editing (guide the user to proper text formatting, help the parser). Should not be used for other purposes in order to not hinder the user’s flow of editing.</p>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Examples
+</td>
+<td class="hdlist2">
+<p>( &#8594; ( &lt;cursor&gt; )</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Eclipse API
+</td>
+<td class="hdlist2">
+<p>org.eclipse.jface.text.IAutoEditStrategy</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Xtext Specifics
+</td>
+<td class="hdlist2">
+<p>org.eclipse.xtext.ui.editor.autoedit.AbstractEditStrategy, some utility methods + implements VerifyKeyListener. May use the ISourceViewer via implements ISourceViewerAware</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Best Practices
+</td>
+<td class="hdlist2">
+<p>Keep it as it is.</p>
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>Fun example but not useful in practice cf. <a href="https://code.google.com/a/eclipselabs.org/p/xtext-forms-integration/source/browse/trunk/plugins/org.eclipse.xtext.example.domainmodel.ui/src/org/eclipse/xtext/example/ui/autoedit/FantasticAutoEditStrategy.java?r=19">FantasticAutoEditStrategy</a></p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Template_Proposals"><a class="anchor" href="#sec:Template_Proposals"></a><a class="link" href="#sec:Template_Proposals">15.1.1.10. Template Proposals</a></h5>
+<div class="paragraph">
+<p>More sophisticated edit utils that are invoked by means of content assist.</p>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Examples
+</td>
+<td class="hdlist2">
+<p>sysout &#8594; System.out.println(<code>&lt;cursor&gt;</code> );</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Eclipse API
+</td>
+<td class="hdlist2">
+<p>Part of the completion proposal API, e.g. ICompletionProposal</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Xtext Specifics
+</td>
+<td class="hdlist2">
+<p>org.eclipse.xtext.ui.editor.contentassist.ITemplateProposalProvider, template contexts along the grammar rules by default, need to be stripped down to become usable.</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Best Practice
+</td>
+<td class="hdlist2">
+<p>ship some: create them manually in workbench, export them as XML, fix XML file (add IDs, in Xtext documentation), put XML file in folder <code>templates</code>  in UI plugin where propose a certain proposal: customize XtextTemplateContextTypeRegistry (bind subclass, override register context types) – by default too many context types are registered placeholders inside templates specific to Xtext – RTFM</p>
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Outline_View___Quick_Outline"><a class="anchor" href="#sec:Outline_View___Quick_Outline"></a><a class="link" href="#sec:Outline_View___Quick_Outline">15.1.1.11. Outline View / Quick Outline</a></h5>
+<div class="paragraph">
+<p>Structural represenation of the file contents (usually with different filter and sorting strategies).</p>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Examples
+</td>
+<td class="hdlist2">
+<p>Outline View (but not Navigator nor package explorer), Quick Outline (in Xtext: same provider)</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Eclipse API
+</td>
+<td class="hdlist2">
+<p>org.eclipse.ui.views.contentoutline.IContentOutlinePage</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Xtext Specifics
+</td>
+<td class="hdlist2">
+<p>Lazy tree creation, syncing via EObject ranges, thread save access to the EObject from nodes. Declarative API to create the tree contents. org.eclipse.xtext.ui.editor.outline.impl.DefaultOutlineTreeProvider
++
+allow actions on outline nodes (e.g., goto referenced file in <code>import</code>  of outline)</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Best Practice
+</td>
+<td class="hdlist2">
+<div class="ulist">
+<ul>
+<li>
+<p>Produced from semantic model, tree structure of outline nodes</p>
+<div class="ulist">
+<ul>
+<li>
+<p>show tree based on TypeModel, maybe filter out elements w/o SyntaxElements (with type model, this should be rather cheap!)</p>
+</li>
+<li>
+<p>use icons and styled labels (first user impression!)</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>May run in the background (BackgroundOutlineTreeProvider)</p>
+</li>
+<li>
+<p>done lazily</p>
+</li>
+<li>
+<p>workflow: reconceiler: outline is a model listener</p>
+</li>
+</ul>
+</div>
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>Helpful tools for icons in outline view:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><a href="http://marketplace.eclipse.org/content/eclipse-icon-archive-tool">Eclipse view</a> to show available Eclipse icons (that are of course licenced under EPL) with possibility to export them (<a href="http://bwgz-org.googlecode.com/files/EclipseIconArchiveTool-1.pdf">documentation</a>)</p>
+</li>
+<li>
+<p>overview of Eclipse icons: <a href="http://eclipse-icons.i24.cc/" class="bare">http://eclipse-icons.i24.cc/</a></p>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Navigator__Package_Explorer__Project_Explorer"><a class="anchor" href="#sec:Navigator__Package_Explorer__Project_Explorer"></a><a class="link" href="#sec:Navigator__Package_Explorer__Project_Explorer">15.1.1.12. Navigator, Package Explorer, Project Explorer</a></h5>
+<div class="paragraph">
+<p>three <code>explorers</code> , Navigator <code>latest</code>  and most extensible one</p>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Best Practices
+</td>
+<td class="hdlist2">
+<p>use Navigator only! (RTFM, nothing specific to Xtext yet)</p>
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>cf. <a href="http://projects.eclipse.org/projects/technology.handly" class="bare">http://projects.eclipse.org/projects/technology.handly</a> <code>read index and show it in the navigator</code></p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Hyperlinking_and_Navigation"><a class="anchor" href="#sec:Hyperlinking_and_Navigation"></a><a class="link" href="#sec:Hyperlinking_and_Navigation">15.1.1.13. Hyperlinking and Navigation</a></h5>
+<div class="paragraph">
+<p>Linking (propose multiple linking targets, e.g. goto declaration or goto implementation when CTRL (or other modifier) + Left Mouse Click on method when receiver type is interface - show all available implementations)</p>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Examples
+</td>
+<td class="hdlist2">
+<p>Go to declaration, Go to implementation, Go to super</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Eclipse API
+</td>
+<td class="hdlist2">
+<p>org.eclipse.jface.text.hyperlink.IHyperlinkDetector</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Xtext Specifics
+</td>
+<td class="hdlist2">
+<p>org.eclipse.xtext.ui.editor.hyperlinking.DefaultHyperlinkDetector, navigation to EObject URI most interesting: SIGNIFICANT cf. org.eclipse.xtext.resource.ILocationInFileProviderExtension.RegionDescription</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Best Practice
+</td>
+<td class="hdlist2">
+<div class="ulist">
+<ul>
+<li>
+<p>subclass and bind IHyperlinkHelper (returns an array of possible links, first one is the default)</p>
+</li>
+<li>
+<p>also see ILocationInFileProviderExtension (cf. navigation to syntax elements instead of types)</p>
+</li>
+</ul>
+</div>
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Syntax_and_Semantic_Coloring"><a class="anchor" href="#sec:Syntax_and_Semantic_Coloring"></a><a class="link" href="#sec:Syntax_and_Semantic_Coloring">15.1.1.14. Syntax and Semantic Coloring</a></h5>
+<div class="paragraph">
+<p>Coloring based on the lexical tokens or based on the semantic tokens (the parsed model). The parser may treat certain lexical keywords as valid identifiers in some contexts. Some of those should not appear as keywords. Semantic coloring is usually more expensive to compute thus run in the background and with some delay</p>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Examples
+</td>
+<td class="hdlist2">
+<p>Numbers, String literals (lexical) Escape sequences in Strings, method calls, property read / write access (semantic)</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Eclipse API
+</td>
+<td class="hdlist2">
+<p><code>org.eclipse.jface.text.presentation.IPresentationDamager</code> <code>org.eclipse.jface.text.presentation.IPresentationRepairer</code> <code>org.eclipse.jface.text.rules.ITokenScanner</code>
++
+Scan for tokens and associate text attributes with tokens. Compute the region of the document that has to be recolored after a text change. Tokens may not overlap.
++
+Also Eclipse provides Themes that are styled via CSS. Coloring can be adjusted to themes where the logical names are mapped to different default values.</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Xtext Specifics
+</td>
+<td class="hdlist2">
+<div class="ulist">
+<ul>
+<li>
+<p><code>o.e.x.ui.editor.syntaxcoloring.ITextAttributeProvider</code> - associate Antlr token names with coloring styles (logical names of text coloring)</p>
+</li>
+<li>
+<p><code>o.e.x.ui.editor.syntaxcoloring.AbstractAntlrTokenToAttributeIdMapper</code>- convert the antlr tokens to JFace ITokens with proper text applied</p>
+</li>
+<li>
+<p><code>o.e.x.ui.editor.syntaxcoloring.IHighlightingConfiguration</code> - register logical text colorings with default values, yields a preference page and the proper configuration for the text attribute provider</p>
+</li>
+<li>
+<p><code>o.e.x.ui.editor.syntaxcoloring.ISemanticHighlightingCalculator</code> - traverse the AST and associate arbitrary ranges of the text with.</p>
+</li>
+<li>
+<p>logical coloring names (this is a key to a style stored in the preference store), if multiple styles are returned, styles will be merged if they overlap (and if possible); JFace constraints are implicitly fulfilled</p>
+</li>
+</ul>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Best Practice
+</td>
+<td class="hdlist2">
+<div class="ulist">
+<ul>
+<li>
+<p>subclass DefaultSemanticHighlightingCalculator and bind ISemanticHighlightingCalculator</p>
+<div class="ulist">
+<ul>
+<li>
+<p>traverse resource from left to right (usually order of semantic elements – small performance improvement)</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>provide new logical style: subclass DefaultHighlightingConfiguration and bind IHighlightingConfiguration; override configure (see overridden)</p>
+</li>
+<li>
+<p>semantic coloring always wins</p>
+</li>
+<li>
+<p>only a few decisions can me made in lexical coloring, override lexical:</p>
+<div class="ulist">
+<ul>
+<li>
+<p>subclass <code>DefaultAntlrTokenToAttributeIdMapper</code> bind <code>TokenTypeToStringMapper</code></p>
+</li>
+<li>
+<p>e.g., color jsdoc comments differently to multiline, regex</p>
+</li>
+<li>
+<p>e.g. color tags inside jsdocs or regex inside, use semantic coloring</p>
+</li>
+<li>
+<p>lexical: different kind of keywords (e.g., N4JS keywords vs. JS keywords)</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>change coloring (via toggle button), possible approach:</p>
+<div class="ulist">
+<ul>
+<li>
+<p>(inject singleton into highlighter, state of singleton is changed by toggle button, listen to that object in the editor, calculator cannot be triggered from outside due to UI-thread issues)</p>
+</li>
+<li>
+<p>prefered: store state in preference store and get the information then from there in the hightligher, inject PreferencestoreAccess in Calculator</p>
+</li>
+</ul>
+</div>
+</li>
+</ul>
+</div>
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Code_Formatter"><a class="anchor" href="#sec:Code_Formatter"></a><a class="link" href="#sec:Code_Formatter">15.1.1.15. Code Formatter</a></h5>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Examples
+</td>
+<td class="hdlist2">
+<p>Auto-Format Source Code, Auto-Format code inserted by code-rewrite</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Eclipse API
+</td>
+<td class="hdlist2">
+<p><code>org.eclipse.jface.text.formatter.IContentFormatter</code> - here is the document and some range - modify at will</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Xtext Specifics
+</td>
+<td class="hdlist2">
+<p>Declarative Formatting API (to be deprecated) - associate formatting rules with grammar elements New formatting API (mixture of declarative and imperative) - here is the model, do what you want (space before, linebreak after, indentation increase / decrease), the engine will merge your advices and apply them to the document</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Best Practice
+</td>
+<td class="hdlist2">
+<p>wait for 2.8 (maybe in 2.7.x)</p>
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Wizards"><a class="anchor" href="#sec:Wizards"></a><a class="link" href="#sec:Wizards">15.1.1.16. Wizards</a></h5>
+<div class="quoteblock">
+<blockquote>
+Wizards are used to guide the user through a sequenced set of tasks. Your plug-in can contribute wizards at predefined extension points in the workbench. It can also create and launch its own wizards.
+</blockquote>
+<div class="attribution">
+&#8212; Eclipse Help
+</div>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Examples
+</td>
+<td class="hdlist2">
+<p>New N4JS Class</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Eclipse API
+<br>
+Xtext Specifics
+</td>
+<td class="hdlist2">
+<div class="ulist">
+<ul>
+<li>
+<p>Xtend based Wizards</p>
+</li>
+<li>
+<p>also see Formular Editor for Embedded Xtext editor</p>
+</li>
+</ul>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Best Practices
+</td>
+<td class="hdlist2">
+<div class="ulist">
+<ul>
+<li>
+<p>use preferences (could be hidden, so use them even if not made configurable to the user)</p>
+</li>
+<li>
+<p>use standard JFace wizard API, use Xtend template expressions for file templates</p>
+</li>
+</ul>
+</div>
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Cheat_Sheets"><a class="anchor" href="#sec:Cheat_Sheets"></a><a class="link" href="#sec:Cheat_Sheets">15.1.1.17. Cheat Sheets</a></h5>
+<div class="quoteblock">
+<blockquote>
+<div class="paragraph">
+<p>Composite cheat sheets provide guidance through complex problems by breaking the problem into a set of smaller tasks. Composite cheat sheets are registered using the the <code>org.eclipse.ui.cheatsheets.cheatSheetContent</code> extension point.</p>
+</div>
+</blockquote>
+<div class="attribution">
+&#8212; Eclipse Help
+</div>
+</div>
+<div class="paragraph">
+<p>(In Scala IDE: Work Sheets), often combined with Code Snippets</p>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Examples
+</td>
+<td class="hdlist2">
+<p>Create Hello World Application</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Eclipse API
+<br>
+Xtext Specifics
+</td>
+<td class="hdlist2">
+<p>None, probably the embedded editor could be used in a REPL (Read-Evaluate-Print-Loop)</p>
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Context_sensitive_Help"><a class="anchor" href="#sec:Context_sensitive_Help"></a><a class="link" href="#sec:Context_sensitive_Help">15.1.1.18. Context-sensitive Help</a></h5>
+<div class="quoteblock">
+<blockquote>
+<div class="paragraph">
+<p>A focused set of help topics that is related to the current context can be shown to users on demand using context-sensitive help. This form of user assistance is delivered to users when a platform-specific trigger is activated (e.g. F1 key on Windows, Ctrl+F1 on GTK, Help key on Carbon). Until Eclipse 3.1, context-sensitive help was presented in infopop windows. Since 3.1, a new Help view is the preferred way to deliver context-sensitive information to the user.</p>
+</div>
+</blockquote>
+<div class="attribution">
+&#8212; Eclipse Help
+</div>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Examples
+</td>
+<td class="hdlist2">
+<p>Help in Formular Editor, Help about syntax construct, API-Help</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Eclipse API
+<br>
+Xtext Specifics
+</td>
+<td class="hdlist2">
+<p>None</p>
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Hovers"><a class="anchor" href="#sec:Hovers"></a><a class="link" href="#sec:Hovers">15.1.1.19. Hovers</a></h5>
+<div class="paragraph">
+<p>Hover allow to display additional information as soon as the cursor stays on a certain text region. Some hovers can be requested by shortcuts (e.g. F2) similar to sort of an online help.</p>
+</div>
+<div class="paragraph">
+<p>Different kind of hovers may appear depending on the context, e.g. the error hover will have higher prio than the documentation hover. Different modifier keys may be assigned to request different hover kinds while hovering a region with the mouse. (didn’t a proper code pointer, though)</p>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Examples
+</td>
+<td class="hdlist2">
+<p>Hover over method shows JSDoc, Signatures or inferred types, error / problem details</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Eclipse API
+</td>
+<td class="hdlist2">
+<p><code>org.eclipse.jface.text.ITextHover</code> + <code>ITextHoverExtension*</code> - compute hover based on the region that is hovered. Various indirections with <code>IInformationControl</code> and <code>IInformationControlCreator</code> with many extension interfaces</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Xtext Specifics
+</td>
+<td class="hdlist2">
+<p><code>org.eclipse.xtext.ui.editor.hover.IEObjectHover</code> - compute hover based on <code>EObjects</code></p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Best Practice
+</td>
+<td class="hdlist2">
+<p>see XBase hover stuff</p>
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Folding"><a class="anchor" href="#sec:Folding"></a><a class="link" href="#sec:Folding">15.1.1.20. Folding</a></h5>
+<div class="paragraph">
+<p>Code folding allows to skip parts of the code that are mandatory semantically but usually do not provide added value for the reader, e.g. import sections</p>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Examples
+</td>
+<td class="hdlist2">
+<p>Import section folding, folding of arbitrary methods or comments</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Eclipse API
+</td>
+<td class="hdlist2">
+<p>Not much there, most of that stuff is implemented specific to JDT or ODE. Projections usually only work per line, that is, a subsection of a line cannot be folded, e.g. it’s not possible to show</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>var x = new Map&lt;String, List&lt;Pair&lt;String, Number&gt;&gt;&gt;()</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>as</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>var x = new Map&lt;...&gt;()</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Line only limitation in SWT (a guess, didn’t work for Sebastian otherwise)</p>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Xtext Specifics
+</td>
+<td class="hdlist2">
+<div class="ulist">
+<ul>
+<li>
+<p><code>org.eclipse.xtext.ui.editor.folding.DefaultFoldingRegionProvider</code> - here is the resource, compute the folding</p>
+</li>
+<li>
+<p><code>org.eclipse.xtext.ui.editor.folding.DefaultFoldingStructureProvider</code> - bridge between editor and custom computation, preferences etc would be read from here</p>
+</li>
+<li>
+<p>no preference page for folding provided by Xtext</p>
+</li>
+</ul>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Best Practice
+</td>
+<td class="hdlist2">
+<div class="ulist">
+<ul>
+<li>
+<p>maybe limit to blocks (subclass default, bind to interface)</p>
+</li>
+<li>
+<p>probably provide your own folding preference page</p>
+</li>
+</ul>
+</div>
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Customizable_validation___severity"><a class="anchor" href="#sec:Customizable_validation___severity"></a><a class="link" href="#sec:Customizable_validation___severity">15.1.1.21. Customizable validation / severity</a></h5>
+<div class="paragraph">
+<p>Some problems are more important to the user than others so they want to change the severity.</p>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Examples
+</td>
+<td class="hdlist2">
+<p>Deprecation could be an error, warning or ignored (e.g. in test projects)</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Eclipse API
+</td>
+<td class="hdlist2">
+<p>None</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Xtext Specifics
+</td>
+<td class="hdlist2">
+<p>IssueSeverityProvider (since 2.6), Monkey sees monkey does: see subclasses of IssueSeverityProvider (we already do that)</p>
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Proposals"><a class="anchor" href="#sec:Proposals"></a><a class="link" href="#sec:Proposals">15.1.1.22. Proposals</a></h5>
+<div class="paragraph">
+<p>Created by Content Assist, Quick Fixes, Quick Assist.</p>
+</div>
+<div class="paragraph">
+<p>Basics</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>simplest case: proposals are strings to be inserted</p>
+</li>
+<li>
+<p>or displayed string is different from inserted one (e.g. FQN vs. simple)</p>
+</li>
+<li>
+<p>ConfigurableCompletionProposal created via factory methods in AbstractN4JSProposalProvider (*create*Pro)</p>
+</li>
+<li>
+<p>PrefixMatcher (by default CamelCase aware) – for filtering, it usually is not necessary to use it when computing the proposal (only if it expensive to compute proposals) – that is, prefix can be ignored when computing a proposal because the prefix matcher will filter out invalid proposals anyway</p>
+</li>
+<li>
+<p>pass a filter (Guava preodicate) to filter out (semantically invalid) proposals, cf. lookupCrossReference(..) – for the things where there are proposals created by default</p>
+</li>
+<li>
+<p>priority defined by an int – for sorting. Cf. ContentProposalPriorities → define default priorities (constant values) in N4JS, do not add some random integers!</p>
+</li>
+<li>
+<p>modes: bind RepeatedContentAssistProcessor and enable modeaware in ProposalProvider (e.g. for private members which require a quickfix)</p>
+</li>
+<li>
+<p>what could be done in the background: hover, lazy (not prepared) proposals (cf. JDT), Xtext 2.7.; different situations are processed in parallel</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Several changes (e.g. automatic import):</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>ConfigurableCompletionProposal.setTextApplier</code></p>
+</li>
+<li>
+<p>TextApplier: can open dialogs etc., TextApplier is the callback</p>
+</li>
+<li>
+<p>usual case: add text at cursor position and somewhere else:</p>
+<div class="ulist">
+<ul>
+<li>
+<p>get document in TextApplier</p>
+</li>
+<li>
+<p>for performance, but also: do not use semantic changes in content assist, because model is broken (you will get funny things) – use model (AST) to get offset, but then insert line breaks etc. → maybe create utility class for retrieving current formattings which are then used in the text edit → maybe provide tools for retrieving certain locations (e.g. import section, field section, etc.)</p>
+</li>
+<li>
+<p>do not create model (AST) fragments (which are then serialized), instead directly provide text</p>
+</li>
+<li>
+<p>use TextEdit and MultiTextEdit</p>
+</li>
+<li>
+<p>set TextViewer redraw to false and to true after the text edits were applied</p>
+</li>
+<li>
+<p>have proper TESTS to ensure that file is not broken after the changes</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p><strong>LinkedEditing</strong>:</p>
+<div class="ulist">
+<ul>
+<li>
+<p>Linked-Editing mode in ConfigurableCompletionProposal with one editing group only (basically: move the cursor somewhere after editing it, see setSimpleLinkedMode)</p>
+</li>
+<li>
+<p>do it manually: cf. LinkedPositionGroup (see call hierarchy of constructor) – used for quick fixes or refactorings rather for content assist</p>
+</li>
+</ul>
+</div>
+</li>
+</ul>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Non_Eclipse_UI_Concepts"><a class="anchor" href="#sec:Non_Eclipse_UI_Concepts"></a><a class="link" href="#sec:Non_Eclipse_UI_Concepts">15.1.2. Non-Eclipse UI Concepts</a></h4>
+<div class="paragraph">
+<p>The following entries are not necessarily implemented yet.</p>
+</div>
+<div class="sect4">
+<h5 id="sec:Overlays"><a class="anchor" href="#sec:Overlays"></a><a class="link" href="#sec:Overlays">15.1.2.1. Overlays</a></h5>
+<div class="paragraph">
+<p>An overlay is a small annotation similar to an hover, attached to a specific location in the editor and is moved with that location.</p>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Examples
+</td>
+<td class="hdlist2">
+<p>Show inferred types</p>
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Goto__Inferred__Type"><a class="anchor" href="#sec:Goto__Inferred__Type"></a><a class="link" href="#sec:Goto__Inferred__Type">15.1.2.2. Goto (Inferred) Type</a></h5>
+<div class="paragraph">
+<p>Navigate to an inferred type (or other <code>invisible</code>  information)</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Postfix_Completion"><a class="anchor" href="#sec:Postfix_Completion"></a><a class="link" href="#sec:Postfix_Completion">15.1.2.3. Postfix Completion</a></h5>
+<div class="paragraph">
+<p>(IntelliJ) Replace code <em>AFTER</em> an expression</p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_user-interface-resources"><a class="anchor" href="#_user-interface-resources"></a><a class="link" href="#_user-interface-resources">15.2. User Interface Resources</a></h3>
+<div class="sect3">
+<h4 id="_icons"><a class="anchor" href="#_icons"></a><a class="link" href="#_icons">15.2.1. Icons</a></h4>
+<div class="paragraph">
+<p>In parts, the N4JS IDE re-uses some of the icons that come with the Eclipse Platform as well as the Eclipse JDT development environment. However, in some cases we also provide our own icons to illustrate N4JS-specific concepts.</p>
+</div>
+<div class="sect4">
+<h5 id="_eclipse-platform-icons"><a class="anchor" href="#_eclipse-platform-icons"></a><a class="link" href="#_eclipse-platform-icons">15.2.1.1. Eclipse Platform Icons</a></h5>
+<div class="paragraph">
+<p>When re-using the Eclipse Platform Icons, the icons are usually copied over to the <code>icons/</code> folder of the <code>org.eclipse.n4js.ui</code> bundle. In this folder, the <code>README.adoc</code> file keeps book on the origin of all the collected icons (e.g. different Eclipse Projects).</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_n4js-specific-icons"><a class="anchor" href="#_n4js-specific-icons"></a><a class="link" href="#_n4js-specific-icons">15.2.1.2. N4JS Specific Icons</a></h5>
+<div class="paragraph">
+<p>In some cases, the icons the Eclipse eco-system provides do not suffice to sensibly express N4JS concepts. In these cases we provide our own icons. When designing those we try to imitate the general Eclipse artstyle in order for our icons to integrate well with the overall appearance of Eclipse.</p>
+</div>
+<div class="paragraph">
+<p>For the creation of new icons, the <code>eclipse-svg-icons</code> repository (see <a href="https://github.com/Seung-Yoon/eclipse-svg-icons" class="bare">https://github.com/Seung-Yoon/eclipse-svg-icons</a>) has proven helpful. The repository contains raw SVG files which can be used to reproduce the bitmap icons that are contained in, for instance, the <code>org.eclipse.platform.ui</code> or <code>org.eclipse.jdt.ui</code> bundle. Based on that, common vector-graphics editing software may be used to further adapt color, form and style of existing icons (e.g. Inkscape <a href="https://inkscape.org/en/" class="bare">https://inkscape.org/en/</a>).</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_high-resolution-icons"><a class="anchor" href="#_high-resolution-icons"></a><a class="link" href="#_high-resolution-icons">15.2.1.3. High Resolution Icons</a></h5>
+<div class="paragraph">
+<p>With the Neon release, Eclipse SWT introduced explicit support for high-DPI monitors (see <a href="https://www.eclipse.org/eclipse/news/4.6/platform.php#swt-autoscale" class="bare">https://www.eclipse.org/eclipse/news/4.6/platform.php#swt-autoscale</a>). In order to provide a good user experience, we want to provide high-DPI support for as many of our icons as possible. For that, it suffices to simply provide an alternative resource with higher resolution by appending the prefix @2x to its name (e.g. <code>class.png</code> and <code>class@2x.png</code>). Code-wise, no adjustments are required. In case of copied Eclipse Platform Icons, most of the time a corresponding 2x-version can be obtained from the original source. In case of N4JS Specific Icons, we export all icons in the resolutions 16x16 and 32x32. For that, it is of particular importance to make sure that the scaling is done in accordance with the native resolution (cf. pixel perfect scaling, also see <a href="https://en.wikipedia.org/wiki/Native_resolution" class="bare">https://en.wikipedia.org/wiki/Native_resolution</a>).</p>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div id="footer">
+<div id="footer-text">
+Version 0.9<br>
+Last updated 2019-08-07 15:02:40 CEST
+</div>
+</div>
+<!-- ************* docinfo-footer *************************************************************** -->
+<div class="Grid social" style="color:#d5dfea">
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <h2>Quick Links</h2>
+    <ul>
+      <li><a href="../downloads.html">Download</a></li>
+      <li><a href="../userguides/index.html">Documentation</a></li>
+      <li><a href="https://github.com/eclipse/n4js/">Source</a></li>
+      <li><a href="https://github.com/eclipse/n4js/issues">Issues</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="https://www.eclipse.org/forums/index.php/f/365/">Forum</a></li>
+      <li><a href="http://n4js.blogspot.de/">Blog</a></li>
+      <li><a href="https://dev.eclipse.org/mailman/listinfo/n4js-dev">Mailing List</a></li>
+      <li><a href="https://projects.eclipse.org/projects/technology.n4js">Eclipse Project Page</a></li>
+      <li><a href="https://twitter.com/n4jsdev">Tweets by n4jsdev</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="http://www.eclipse.org/">Eclipse Home</a></li>
+      <li><a href="http://www.eclipse.org/legal/privacy.php">Privacy Policy</a></li>
+      <li><a href="http://www.eclipse.org/legal/termsofuse.php">Terms of Use</a></li>
+      <li><a href="http://www.eclipse.org/legal/copyright.php">Copyright Agent</a></li>
+      <li><a href="http://www.eclipse.org/legal/">Legal</a></li>
+    </ul>
+  </div>
+  <div style="clear: both; height: 0; overflow: hidden;"></div>
+</div>
+
+<!-- ************* UI Scripts ************* -->
+<script type="text/javascript" src="scripts/back-to-top.js"></script>
+
+<script type="text/javascript" src="scripts/treeview.js"></script>
+<script type="text/javascript" src="scripts/toc.js"></script>
+
+<!-- ************* Prism.js Syntax Highlighting ************* -->
+<script src="scripts/prism.js"></script>
+
+<script type="text/javascript">
+	// Add the 'toclist' id for search function
+	$(".toc2 > ul").attr('id', 'toclist');
+	// Generate a Search input form
+	$("#toclist > li:first-of-type").before('<input type="text" id="pagesearch" onkeyup="search()" placeholder="Search for section...">');
+	$("#toclist > li:first-of-type").before('<i id="clear" class="fa fa-times-circle-o"></i>');
+	$("#clear").click(function(){
+	    $("#pagesearch").val('');
+	    search();
+	    $('.toc2 > ul').treeView('collapseAll');
+	});
+	// intialize Treeview.js
+	$(".toc2 > ul").treeView();
+	// Initialize Scrollspy
+</script>
+<!-- ************* docinfo-footer *************************************************************** -->
+</body>
+</html>
\ No newline at end of file
diff --git a/design/validation.html b/design/validation.html
new file mode 100644
index 0000000..e2e59a1
--- /dev/null
+++ b/design/validation.html
@@ -0,0 +1,1431 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="generator" content="Asciidoctor 1.5.5">
+<meta name="author" content="2019-08-07 15:02:40 CEST">
+<title>N4JS Design Specification</title>
+<link rel="stylesheet" href="styles/spec.min.css">
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.6.3/css/font-awesome.min.css">
+<!-- ************* docinfo ******************************************************************* -->
+
+
+<!-- ************* Favicon ************-->
+<link rel="icon" href="images/favicon.ico" />
+
+<!-- ************* Back-to-top JQuery ************* -->
+<script src="https://code.jquery.com/jquery-1.12.4.js"></script>
+<script src="https://code.jquery.com/ui/1.12.0/jquery-ui.js"></script>
+
+
+<link href="styles/prism.min.css" rel="stylesheet" />
+<script type="text/javascript" async
+  src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2/MathJax.js?config=TeX-MML-AM_CHTML">
+</script>
+
+<!-- ************* Styles ************* -->
+<link rel="stylesheet" type="text/css" href="styles/n4jsspec-adoc.css">
+
+
+<!-- ****************** NavBar ****************** -->
+<div id="menubar">
+	<div class="banner">
+        <a href="https://www.eclipse.org/n4js/#"><img id="logo" src="images/n4js-logo.png" alt="Eclipse N4JS"></a>
+    </div>
+<ul>
+  <li><a href="index.html">Index</a></li>
+</ul>
+</div>
+<!-- ************* docinfo ******************************************************************* -->
+<style>
+      .admonitionblock td.icon .icon-todo:before{content:"\f249";color:#f4ee42}
+    </style>
+</head>
+<body class="book toc2 toc-left">
+<div id="header">
+<h1>N4JS Design Specification</h1>
+<div class="details">
+<span id="author" class="author">2019-08-07 15:02:40 CEST</span><br>
+<span id="revnumber">version 0.9</span>
+</div>
+<div id="toc" class="toc2">
+<div id="toctitle">Table of Contents</div>
+<ul class="sectlevel1">
+<li><a href="introduction.html#_introduction">1. Introduction</a>
+<ul class="sectlevel2">
+<li><a href="introduction.html#notation">1.1. Notation</a></li>
+<li><a href="introduction.html#sec:IDE_Overview">1.2. IDE Components</a>
+<ul class="sectlevel3">
+<li><a href="introduction.html#sec:Naming_Conventions">1.2.1. Naming Conventions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="eclipse_setup.html#_eclipse-setup">2. Eclipse Setup</a>
+<ul class="sectlevel2">
+<li><a href="eclipse_setup.html#_system-requirements">2.1. System Requirements</a></li>
+<li><a href="eclipse_setup.html#_contribute">2.2. Contribute</a>
+<ul class="sectlevel3">
+<li><a href="eclipse_setup.html#_eclipse-installer">2.2.1. Eclipse Installer</a>
+<ul class="sectlevel4">
+<li><a href="eclipse_setup.html#_changing-the-setup-script">2.2.1.1. Changing the Setup Script</a></li>
+</ul>
+</li>
+<li><a href="eclipse_setup.html#_manual-ide-configuration">2.2.2. Manual IDE Configuration</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="release_engineering.html#_release-engineering">3. Release Engineering</a>
+<ul class="sectlevel2">
+<li><a href="release_engineering.html#_nightly-build-on-eclipse-infrastructure">3.1. Nightly build on Eclipse infrastructure</a></li>
+<li><a href="release_engineering.html#_build-the-n4js-ide-from-command-line">3.2. Build the N4JS IDE from command line</a>
+<ul class="sectlevel3">
+<li><a href="release_engineering.html#_publish-maven-tooling-code-org-eclipse-n4js-releng-util-code">3.2.1. Publish maven-tooling <code>org.eclipse.n4js.releng.util</code></a></li>
+<li><a href="release_engineering.html#sec:test-verdaccio">3.2.2. Test Verdaccio containing n4js-libs</a></li>
+<li><a href="release_engineering.html#_generation-of-eclipse-help-for-spec-and-design-document">3.2.3. Generation of Eclipse help for spec and design document</a></li>
+</ul>
+</li>
+<li><a href="release_engineering.html#_updating-frameworks-and-dependencies">3.3. Updating frameworks and dependencies</a>
+<ul class="sectlevel3">
+<li><a href="release_engineering.html#_update-of-eclipse-emf-xtext-etc">3.3.1. Update of Eclipse, EMF, Xtext, etc.</a></li>
+<li><a href="release_engineering.html#_update-of-the-embedded-jre">3.3.2. Update of the embedded JRE</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tips_and_tricks.html#_tips-and-tricks">4. Tips and Tricks</a>
+<ul class="sectlevel2">
+<li><a href="tips_and_tricks.html#_naming">4.1. Naming</a></li>
+<li><a href="tips_and_tricks.html#_logging">4.2. Logging</a></li>
+<li><a href="tips_and_tricks.html#_cancellation-handling">4.3. Cancellation Handling</a></li>
+<li><a href="tips_and_tricks.html#_caching">4.4. Caching</a></li>
+<li><a href="tips_and_tricks.html#_dependency-injection">4.5. Dependency Injection</a></li>
+<li><a href="tips_and_tricks.html#_miscellaneous">4.6. Miscellaneous</a></li>
+</ul>
+</li>
+<li><a href="parser.html#_parser">5. Parser</a>
+<ul class="sectlevel2">
+<li><a href="parser.html#sec:Parser_Overview">5.1. Overview</a></li>
+<li><a href="parser.html#sec:N4JS_Parser">5.2. N4JS Parser</a></li>
+<li><a href="parser.html#sec:Parser_Generation_Post_Processing">5.3. Parser Generation Post-Processing</a>
+<ul class="sectlevel3">
+<li><a href="parser.html#sec:Automatic_Semicolon_Insertion">5.3.1. Automatic Semicolon Insertion</a>
+<ul class="sectlevel4">
+<li><a href="parser.html#sec:Injected_code_in_the_Antlr_grammar_file">5.3.1.1. Injected code in the Antlr grammar file</a></li>
+<li><a href="parser.html#sec:Customized_error_recovery">5.3.1.2. Customized error recovery</a></li>
+</ul>
+</li>
+<li><a href="parser.html#sec:_No_line_terminator_allowed_here__handling">5.3.2. Async and <code>No line terminator allowed here</code> Handling</a></li>
+<li><a href="parser.html#sec:Regular_Expression">5.3.3. Regular Expression</a></li>
+<li><a href="parser.html#sec:Unicode">5.3.4. Unicode</a></li>
+<li><a href="parser.html#sec:Literals">5.3.5. Literals</a></li>
+</ul>
+</li>
+<li><a href="parser.html#sec:Modifiers">5.4. Modifiers</a></li>
+<li><a href="parser.html#sec:Conflict_Resolutions">5.5. Conflict Resolutions</a>
+<ul class="sectlevel3">
+<li><a href="parser.html#sec:Reserved_Keywords_vs__Identifier_Names">5.5.1. Reserved Keywords vs. Identifier Names</a></li>
+<li><a href="parser.html#sec:Operators_and_Generics">5.5.2. Operators and Generics</a></li>
+</ul>
+</li>
+<li><a href="parser.html#sec:Content_Assist_Parser">5.6. Content-Assist Parser</a></li>
+</ul>
+</li>
+<li><a href="type_system.html#_type-system">6. Type System</a>
+<ul class="sectlevel2">
+<li><a href="type_system.html#sec:Type_Model_and_Grammar">6.1. Type Model and Grammar</a>
+<ul class="sectlevel3">
+<li><a href="type_system.html#sec:Type_Model_Overview">6.1.1. Type Model Overview</a></li>
+<li><a href="type_system.html#sec:Built_in_Types">6.1.2. Built-in and Primitive Types</a></li>
+<li><a href="type_system.html#sec:Type_Model_DSL">6.1.3. Type Model DSL</a></li>
+</ul>
+</li>
+<li><a href="type_system.html#sec:Type_System_Implementation">6.2. Type System Implementation</a></li>
+<li><a href="type_system.html#sec:Type_Inference_combined_with_AST_Traversal">6.3. Type Inference of AST</a>
+<ul class="sectlevel3">
+<li><a href="type_system.html#sec:Type_Inference_combined_with_AST_Traversal__Background">6.3.1. Background</a></li>
+<li><a href="type_system.html#sec:Triggering_Type_Inference_of_AST">6.3.2. Triggering</a></li>
+<li><a href="type_system.html#sec:Traversal_Order_During_Type_Inference_of_AST">6.3.3. Traversal Order</a></li>
+<li><a href="type_system.html#sec:Cross_References_During_Type_Inference_of_AST">6.3.4. Cross-References</a></li>
+<li><a href="type_system.html#sec:Function_Accessor_Bodies_During_Type_Inference_of_AST">6.3.5. Function/Accessor Bodies</a></li>
+<li><a href="type_system.html#sec:Poly_Expressions_During_Type_Inference_of_AST">6.3.6. Poly Expressions</a></li>
+<li><a href="type_system.html#sec:Constraint_Solver_used_During_Type_Inference_of_AST">6.3.7. Constraint Solver</a></li>
+<li><a href="type_system.html#sec:Type_Guards_During_Type_Inference_of_AST">6.3.8. Type Guards</a></li>
+</ul>
+</li>
+<li><a href="type_system.html#sec:Structural_Typing">6.4. Structural Typing</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#_type-index">7. Type Index</a>
+<ul class="sectlevel2">
+<li><a href="type_index.html#sec:Type_Index_Design_Rationale">7.1. Design Rationale</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#sec:Getting_the_Xtext_Index_Content_IResourceDescriptions">7.1.1. Getting the Xtext Index (<code>IResourceDescriptions</code>) Content</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#sec:Design_Overview">7.2. Design Overview</a></li>
+<li><a href="type_index.html#sec:N4JS_Resource_Load_States">7.3. N4JS Resource Load States</a></li>
+<li><a href="type_index.html#sec:Type_Builder">7.4. Types Builder</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#sec:Type_Inference_not_allowed_in_Type_Builder">7.4.1. Type Inference not allowed in Types Builder</a></li>
+<li><a href="type_index.html#sec:ComputedTypeReferences">7.4.2. Deferred Type References</a></li>
+<li><a href="type_index.html#sec:Use_cases_of_ComputedTypeRef">7.4.3. Use cases of DeferredTypeRef</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#sec:Incremental_Builder_Overview">7.5. Incremental Builder (Overview)</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#sec:Incremental_Builder_Overview__XtextBuilder">7.5.1. XtextBuilder</a></li>
+<li><a href="type_index.html#sec:Incremental_Builder_Overview__IBuilderState">7.5.2. IBuilderState</a>
+<ul class="sectlevel4">
+<li><a href="type_index.html#copy-and-update-xtext-index">7.5.2.1. Copy and Update Xtext Index</a></li>
+<li><a href="type_index.html#build-state-setup-phase">7.5.2.2. Build State Setup Phase</a></li>
+<li><a href="type_index.html#process-queued-uris">7.5.2.3. Process Queued URIs</a></li>
+<li><a href="type_index.html#queueing-affected-resources">7.5.2.4. Queueing Affected Resources</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#sec:Incremental_Builder_Overview__Example">7.5.3. Example</a></li>
+</ul>
+</li>
+<li><a href="type_index.html#dirty-state-handling">7.6. Dirty state handling</a>
+<ul class="sectlevel3">
+<li><a href="type_index.html#use-case-restoring-types-from-user-data">7.6.1. Use case: Restoring types from user data</a></li>
+<li><a href="type_index.html#use-case-updating-the-xtext-index">7.6.2. Use case: Updating the Xtext index</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="project_model.html#_project-model">8. Project Model</a>
+<ul class="sectlevel2">
+<li><a href="project_model.html#sec:Package_json">8.1. Package.json File</a></li>
+<li><a href="project_model.html#_accessing-project-information">8.2. Accessing Project Information</a>
+<ul class="sectlevel3">
+<li><a href="project_model.html#sec:IN4JSCore">8.2.1. IN4JSCore</a></li>
+<li><a href="project_model.html#sec:N4JSModel">8.2.2. N4JSModel</a></li>
+<li><a href="project_model.html#sec:N4JSWorkspace">8.2.3. N4JSWorkspace</a></li>
+<li><a href="project_model.html#sec:N4JSProject">8.2.4. N4JSProject</a></li>
+<li><a href="project_model.html#sec:SourceContainer">8.2.5. SourceContainer</a></li>
+<li><a href="project_model.html#sec:N4JSProjectsStateHelper">8.2.6. N4JSProjectsStateHelper</a></li>
+</ul>
+</li>
+<li><a href="project_model.html#sec:Caching">8.3. Caching</a>
+<ul class="sectlevel3">
+<li><a href="project_model.html#_caching-of-externallibraryworkspace">8.3.1. Caching of ExternalLibraryWorkspace</a></li>
+<li><a href="project_model.html#_caching-of-n4jsprojectsstatehelper">8.3.2. Caching of N4JSProjectsStateHelper</a></li>
+</ul>
+</li>
+<li><a href="project_model.html#sec:WildcardPathFilter">8.4. WildcardPathFilter</a></li>
+<li><a href="project_model.html#sec:ProjectUtils">8.5. ProjectUtils</a></li>
+</ul>
+</li>
+<li><a href="binding.html#_binding">9. Binding</a>
+<ul class="sectlevel2">
+<li><a href="binding.html#sec:Binding_Design_Rationale">9.1. Design Rationale</a></li>
+<li><a href="binding.html#sec:Binding_to_Members">9.2. Binding to Members</a></li>
+<li><a href="binding.html#sec:Binding_Getter_Setter">9.3. Getter / Setter Binding</a></li>
+<li><a href="binding.html#chap:Statics">9.4. Static Member Binding</a></li>
+<li><a href="binding.html#sec:Binding_Enumeration">9.5. Enumeration Literals Binding</a></li>
+<li><a href="binding.html#sec:Accessibility_of_types_and_members">9.6. Accessibility of types and members</a></li>
+<li><a href="binding.html#sec:Member_Scope_Example">9.7. Member Scope Example</a></li>
+<li><a href="binding.html#sec:Scoping_for_Members_of_Composed_Type_Explained">9.8. Scoping for Members of Composed Type (Union/Intersection) Example</a></li>
+<li><a href="binding.html#sec:Binding_of_Structurally_References_Types">9.9. Structurally References Types</a></li>
+<li><a href="binding.html#sec:Building">9.10. Building</a>
+<ul class="sectlevel3">
+<li><a href="binding.html#sec:Build_Phases">9.10.1. Build Phases</a></li>
+<li><a href="binding.html#sec:Build_Scenarios">9.10.2. Build Scenarios</a></li>
+<li><a href="binding.html#sec:Lazy_linking_problem">9.10.3. Lazy linking problem</a></li>
+</ul>
+</li>
+<li><a href="binding.html#sec:Proxies_and_Proxy_Resolution">9.11. Proxies and Proxy Resolution (Overview)</a>
+<ul class="sectlevel3">
+<li><a href="binding.html#xtexts-lazy-linking-proxies">9.11.1. Xtext’s Lazy Linking Proxies</a></li>
+<li><a href="binding.html#standard-emf-proxies">9.11.2. Standard EMF Proxies</a></li>
+<li><a href="binding.html#_how-is-proxy-resolution-triggered">9.11.3. How is Proxy Resolution Triggered?</a></li>
+<li><a href="binding.html#_when-is-proxy-resolution-allowed">9.11.4. When is Proxy Resolution Allowed?</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#_validation">10. Validation</a>
+<ul class="sectlevel2">
+<li><a href="#sec:validation_overview">10.1. Validation overview</a></li>
+<li><a href="#sec:validation_control_flow">10.2. Validation control flow</a></li>
+<li><a href="#sec:validation_issue_ids">10.3. Issue IDs and Messages</a></li>
+<li><a href="#sec:validation_usage_patterns">10.4. Usage Pattern</a></li>
+<li><a href="#sec:validation_links">10.5. Links</a></li>
+</ul>
+</li>
+<li><a href="references.html#_references">11. References</a>
+<ul class="sectlevel2">
+<li><a href="references.html#sec:usecases">11.1. Use cases</a></li>
+<li><a href="references.html#sec:calculation_algorithm">11.2. Calculation algorithm</a>
+<ul class="sectlevel3">
+<li><a href="references.html#sec:Xtext_default_implementation">11.2.1. Xtext default implementation</a></li>
+<li><a href="references.html#sec:N4_implementation">11.2.2. N4JS implementation</a></li>
+</ul>
+</li>
+<li><a href="references.html#sec:PerformanceOfDependencyCalculation">11.3. Performance Of Dependency Calculation</a></li>
+<li><a href="references.html#sec:kinds_of_references">11.4. Kinds of references</a>
+<ul class="sectlevel3">
+<li><a href="references.html#sec:Cross_References_to_be_ignored">11.4.1. Cross References to be ignored</a></li>
+<li><a href="references.html#sec:Cross_References_to_be_handled">11.4.2. Cross References to be handled</a></li>
+</ul>
+</li>
+<li><a href="references.html#sec:transitive_dependencies">11.5. Transitive dependencies</a></li>
+<li><a href="references.html#sec:find-references">11.6. Find references</a>
+<ul class="sectlevel3">
+<li><a href="references.html#_background">11.6.1. Background</a></li>
+<li><a href="references.html#_how-find-references-work">11.6.2. How Find References Work</a>
+<ul class="sectlevel4">
+<li><a href="references.html#_step-1-convert-cursor-position-to-declared-element">11.6.2.1. Step 1: Convert Cursor Position to Declared Element</a></li>
+<li><a href="references.html#_step-2-convert-declared-element-to-target-uris">11.6.2.2. Step 2: Convert Declared Element to Target URIs</a></li>
+<li><a href="references.html#_step-3-filter-potential-resources">11.6.2.3. Step 3: Filter Potential Resources</a></li>
+<li><a href="references.html#_step-4-search-references-in-resource">11.6.2.4. Step 4: Search References in Resource</a></li>
+<li><a href="references.html#_limitations-and-possible-enhancements">11.6.2.5. Limitations and Possible Enhancements</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="compilation.html#_compilation">12. Compilation</a>
+<ul class="sectlevel2">
+<li><a href="compilation.html#chap:compilation">12.1. Introduction</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:general_design_rationals">12.1.1. General design rationals</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:logging_and_error_reporting">12.1.1.1. Logging and error reporting</a></li>
+<li><a href="compilation.html#sec:progress_monitor">12.1.1.2. Progress monitor</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Xtext_Integration">12.1.2. Xtext Integration</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:xtext_default_behaviour">12.1.2.1. Xtext default behaviour</a></li>
+<li><a href="compilation.html#sec:n4js_requirements">12.1.2.2. N4JS requirements</a></li>
+<li><a href="compilation.html#sec:compiler_discovery_in_ui">12.1.2.3. Compiler discovery in UI</a></li>
+<li><a href="compilation.html#sec:compiler_discovery_in_headless">12.1.2.4. Compiler discovery in headless</a></li>
+<li><a href="compilation.html#sec:general_generator_implementation">12.1.2.5. General generator implementation</a></li>
+<li><a href="compilation.html#sec:general_generator_activation">12.1.2.6. General generator activation</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Overview_of_Input_Models">12.1.3. Overview of the Input Models</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Core_Generator">12.2. Generators</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:Compiler_Components">12.2.1. Generator Components</a></li>
+<li><a href="compilation.html#sec:Generator_architecture">12.2.2. Generator architecture</a></li>
+<li><a href="compilation.html#sec:Unified_Compiler_Configuration">12.2.3. Unified Compiler Configuration</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Transpilers">12.3. Transpilers</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:Phases">12.3.1. Overview</a></li>
+<li><a href="compilation.html#relation-between-ast-and-im">12.3.2. Relation between AST and IM</a></li>
+<li><a href="compilation.html#implementation-overview">12.3.3. Implementation Overview</a></li>
+<li><a href="compilation.html#sec:Guidelines_for_Implementing_Transformations">12.3.4. Guidelines for Implementing Transformations</a></li>
+<li><a href="compilation.html#symbol-table-in-the-im">12.3.5. Symbol Table in the IM</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:N4JS_to_EcmaScript_Transpiler">12.4. N4JS-to-EcmaScript Transpiler</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:Overview_of_Transformations">12.4.1. Overview of Transformations</a></li>
+<li><a href="compilation.html#sec:Transpiling_members">12.4.2. Transpiling members</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:Transpiling_members__Delegating_members">12.4.2.1. Techniques for special member handling</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__Partial_shadowing_of_getter_setter_pairs">12.4.2.2. Partial shadowing</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__Consuming_or_inheriting_members_of_an_interface">12.4.2.3. Consuming or inheriting members of an interface</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__Static_polyfill">12.4.2.4. Static polyfill</a></li>
+<li><a href="compilation.html#sec:Transpiling_members__API_implementation_stubs">12.4.2.5. API / implementation stubs</a></li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:Support_for_incomplete_API_implementation_testing_in_the_N4JS_to_EcmaScript_5_Transpiler">12.4.3. Support for incomplete API implementation testing</a>
+<ul class="sectlevel4">
+<li><a href="compilation.html#sec:Modifications_in_Impl_projects">12.4.3.1. Modifications in Impl projects</a></li>
+<li><a href="compilation.html#sec:Implementation_of_stub_generation">12.4.3.2. Implementation of stub-generation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="compilation.html#sec:n4jsc_Headless_Compiler_Interface">12.5. n4jsc Headless Compiler Interface</a>
+<ul class="sectlevel3">
+<li><a href="compilation.html#sec:building_the_headless_compiler">12.5.1. building the headless compiler</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="execution.html#_execution">13. Execution</a>
+<ul class="sectlevel2">
+<li><a href="execution.html#sec:N4JS_Project_Execution_And_Linking_Model">13.1. N4JS Project Execution And Linking Model</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#subsec:N4JS_Execution_With_NodeJS">13.1.1. N4JS Execution With NodeJS</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:N4JS_Execution_And_Linking_File">13.2. N4JS Execution And Linking File</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#subsec:NodeJS_Specific_ELF">13.2.1. NodeJS Specific ELF</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Runners-execution">13.3. Runners</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#subsec:N4_Runtime_Environments_Convention">13.3.1. N4 Runtime Environments Convention</a></li>
+<li><a href="execution.html#subsec:Passing_Information_from_IDE_to_Execution_Code_in_Runtime_Environment">13.3.2. Passing Information from IDE to Execution Code in Runtime Environment</a></li>
+<li><a href="execution.html#subsec:Runners_Design">13.3.3. Runners Design</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Legacy_Execution_Engine">13.4. Legacy Execution Engine</a></li>
+<li><a href="execution.html#sec:Design">13.5. Design</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#sec:Usage_Outside_N4JSIDE">13.5.1. Usage Outside N4JSIDE</a>
+<ul class="sectlevel4">
+<li><a href="execution.html#sec:Use_Node_with_Maven">13.5.1.1. Use Node with Maven</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Usage_Inside_N4JSIDE">13.5.2. Usage Inside N4JSIDE</a></li>
+</ul>
+</li>
+<li><a href="execution.html#sec:Runtime_Injection">13.6. Runtime Injection</a>
+<ul class="sectlevel3">
+<li><a href="execution.html#sec:Running_String_Code">13.6.1. Running String Code</a></li>
+<li><a href="execution.html#sec:Running_File_Code">13.6.2. Running File Code</a></li>
+<li><a href="execution.html#sec:Injection_Code_Example">13.6.3. Injection Code Example</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#_tests">14. Tests</a>
+<ul class="sectlevel2">
+<li><a href="tests.html#sec:Performance_Tests">14.1. Performance Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Synthetic_Performance_Tests">14.1.1. Synthetic Performance Tests</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:Design_of_Generator">14.1.1.1. Design of Generator</a></li>
+<li><a href="tests.html#sec:Design_of_Performance_Test_Execution">14.1.1.2. Design of Performance Test Configuration and Execution</a></li>
+<li><a href="tests.html#sec:JUnit_Configuration">14.1.1.3. JUnit Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Test_Configuration">14.1.1.4. JUnitBenchmark Test Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Report_Configuration">14.1.1.5. JUnitBenchmark Report Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Run_Configuration">14.1.1.6. JUnitBenchmark Run Configuration</a></li>
+<li><a href="tests.html#sec:JUnitBenchmark_Example">14.1.1.7. JUnitBenchmark Example</a></li>
+<li><a href="tests.html#sec:Note_on_Jenkins_Job">14.1.1.8. Note on Jenkins Job</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#sec:ECMA_Tests">14.2. ECMA Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Grammar_Tests">14.2.1. Grammar Tests</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:Negative_Tests">14.2.1.1. Negative Tests</a></li>
+<li><a href="tests.html#sec:Test_Exclusion">14.2.1.2. Test Exclusion</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Integration_Tests">14.3. Integration Tests</a></li>
+<li><a href="tests.html#sec:Test_Helpers">14.4. Test Helpers</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Parameterized_N4JS_Tests">14.4.1. Parameterized N4JS tests</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:ParameterizedXtextRunner">14.4.1.1. ParameterizedXtextRunner</a></li>
+<li><a href="tests.html#sec:TestCodeProvider">14.4.1.2. TestCodeProvider</a></li>
+<li><a href="tests.html#sec:Example_Of_Parameterized_Parser_Test">14.4.1.3. Example of parameterized parser test</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Issue_Suppression">14.5. Issue Suppression</a></li>
+<li><a href="tests.html#sec:Xpect_Tests">14.6. Xpect Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Xpect_Test_Setup">14.6.1. Xpect Test Setup</a></li>
+<li><a href="tests.html#sec:Xpect_Issue_Suppression">14.6.2. Xpect Issue Suppression</a></li>
+<li><a href="tests.html#sec:Xpect_Provided_Test_Methods">14.6.3. Xpect Provided Test Methods</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#errors">14.6.3.1. errors</a></li>
+<li><a href="tests.html#warnings">14.6.3.2. warnings</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:N4JS_Specific_Xpect_Test_Methods">14.6.4. N4JS Specific Xpect Test Methods</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:XPECT_noerrors">14.6.4.1. noerrors and nowarnings</a></li>
+<li><a href="tests.html#sec:XPECT_scope">14.6.4.2. scope</a></li>
+<li><a href="tests.html#sec:XPECT_scopeWithPosition">14.6.4.3. scopeWithPosition</a></li>
+<li><a href="tests.html#sec:XPECT_scopeWithResource">14.6.4.4. scopeWithResource</a></li>
+<li><a href="tests.html#sec:XPECT_binding">14.6.4.5. binding</a></li>
+<li><a href="tests.html#sec:XPECT_linkedPathname">14.6.4.6. linkedPathname</a></li>
+<li><a href="tests.html#sec:XPECT_type_of">14.6.4.7. type of</a></li>
+<li><a href="tests.html#sec:XPECT_expectedType">14.6.4.8. expectedType</a></li>
+<li><a href="tests.html#sec:XPECT_elementKeyword">14.6.4.9. elementKeyword</a></li>
+<li><a href="tests.html#sec:XPECT_accessModifier">14.6.4.10. accessModifier</a></li>
+<li><a href="tests.html#sec:XPECT_compileResult">14.6.4.11. compileResult</a></li>
+<li><a href="tests.html#sec:XPECT_output">14.6.4.12. output</a></li>
+<li><a href="tests.html#sec:XPECT_outputRegEx">14.6.4.13. outputRegEx</a></li>
+<li><a href="tests.html#sec:XPECT_calculatedAccessModifier">14.6.4.14. calculatedAccessModifier</a></li>
+<li><a href="tests.html#sec:XPECT_spec">14.6.4.15. spec</a></li>
+<li><a href="tests.html#sec:XPECT_deadCode">14.6.4.16. deadCode</a></li>
+<li><a href="tests.html#sec:XPECT_returnOrThrows">14.6.4.17. returnOrThrows</a></li>
+<li><a href="tests.html#sec:XPECT_lint">14.6.4.18. lint</a></li>
+<li><a href="tests.html#sec:XPECT_lintFails">14.6.4.19. lintFails</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:FIXME_Xpect_modifier">14.6.5. FIXME Xpect modifier</a></li>
+<li><a href="tests.html#sec:Expectmatrix_Xpect_Test_Methods">14.6.6. Expectmatrix Xpect tests</a></li>
+<li><a href="tests.html#xpect-lint-tests">14.6.7. Xpect Lint Tests</a></li>
+</ul>
+</li>
+<li><a href="tests.html#xpect-proposal-tests">14.7. Xpect Proposal Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Validation_vs__Non_Validation">14.7.1. Validation vs. Non-Validation</a></li>
+<li><a href="tests.html#sec:General_Proposal_Test_Features">14.7.2. General Proposal Test Features</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#sec:Test_Variables">14.7.2.1. Test Variables</a></li>
+<li><a href="tests.html#sec:Location_and_Selection">14.7.2.2. at – Location and Selection</a></li>
+<li><a href="tests.html#sec:Multi_Line_Expectations_in_Proposal_Tests">14.7.2.3. Multi Line Expectations in Proposal Tests</a></li>
+<li><a href="tests.html#sec:Timeout">14.7.2.4. Timeout and Performance</a></li>
+</ul>
+</li>
+<li><a href="tests.html#proposals-verify-existence-of-proposals">14.7.3. proposals – Verify Existence of Proposals</a></li>
+<li><a href="tests.html#sec:Verify_displayed_string">14.7.4. display – Verify displayed string</a></li>
+<li><a href="tests.html#sec:Apply_Proposal">14.7.5. apply – Apply Proposal</a>
+<ul class="sectlevel4">
+<li><a href="tests.html#resource-application-in-other-files">14.7.5.1. resource – application in other files</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Content_Assist_Cycling">14.7.6. kind – Content Assist Cycling</a></li>
+<li><a href="tests.html#fileValidVerify-validation-status">14.7.7. fileValid – Verify validation status</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Apply_Proposal_And_Execute_Tests">14.8. Apply Proposal And Execute Tests</a></li>
+<li><a href="tests.html#sec:Organize_Imports_Test">14.9. Organize Imports Test</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#organizeimports">14.9.1. organizeImports</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Access_Control_Test">14.10. Access Control Test</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#test-scenarios">14.10.1. Test Scenarios</a></li>
+<li><a href="tests.html#n4js-code-generator">14.10.2. N4JS Code Generator</a></li>
+<li><a href="tests.html#xtext-issue-matcher">14.10.3. Xtext Issue Matcher</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Smoke_Tests">14.11. Smoke Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#how-to-handle-smoke-test-errors">14.11.1. How to handle smoke test errors?</a></li>
+<li><a href="tests.html#smoketester-and-exceptionanalyzer">14.11.2. SmokeTester and ExceptionAnalyzer</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:UI_Tests_with_SWTBot">14.12. UI Tests with SWTBot</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#writing-swtbot-tests">14.12.1. Writing SWTBot Tests</a></li>
+<li><a href="tests.html#running-swtbot-tests">14.12.2. Running SWTBot Tests</a></li>
+</ul>
+</li>
+<li><a href="tests.html#sec:Debugging_UI_Tests">14.13. Debugging UI Tests</a>
+<ul class="sectlevel3">
+<li><a href="tests.html#sec:Connecting_to_the_X_server_on_the_build_node">14.13.1. Connecting to the X-server on the build-node</a></li>
+<li><a href="tests.html#sec:Tools_to_investigate_the_java_stack">14.13.2. Tools to investigate the java-stack</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="ui_concepts.html#_ui-concepts">15. UI Concepts</a>
+<ul class="sectlevel2">
+<li><a href="ui_concepts.html#sec:User_Interface_Concepts">15.1. User Interface Concepts</a>
+<ul class="sectlevel3">
+<li><a href="ui_concepts.html#sec:Eclipse_UI_Concepts">15.1.1. Eclipse UI Concepts</a>
+<ul class="sectlevel4">
+<li><a href="ui_concepts.html#sec:Label_Provider">15.1.1.1. Label Provider</a></li>
+<li><a href="ui_concepts.html#sec:Markers">15.1.1.2. Markers</a></li>
+<li><a href="ui_concepts.html#sec:Commands__Toolbar_and_Menus">15.1.1.3. Commands, Toolbar and Menus</a></li>
+<li><a href="ui_concepts.html#sec:Content_Assist">15.1.1.4. Content Assist</a></li>
+<li><a href="ui_concepts.html#sec:Quick_Fixes">15.1.1.5. Quick Fixes</a></li>
+<li><a href="ui_concepts.html#sec:Quick_Assist">15.1.1.6. Quick Assist</a></li>
+<li><a href="ui_concepts.html#sec:Clean_Up_Actions">15.1.1.7. Clean Up Actions</a></li>
+<li><a href="ui_concepts.html#sec:Save_Actions">15.1.1.8. Save Actions</a></li>
+<li><a href="ui_concepts.html#sec:Auto_Edit">15.1.1.9. Auto Edit</a></li>
+<li><a href="ui_concepts.html#sec:Template_Proposals">15.1.1.10. Template Proposals</a></li>
+<li><a href="ui_concepts.html#sec:Outline_View___Quick_Outline">15.1.1.11. Outline View / Quick Outline</a></li>
+<li><a href="ui_concepts.html#sec:Navigator__Package_Explorer__Project_Explorer">15.1.1.12. Navigator, Package Explorer, Project Explorer</a></li>
+<li><a href="ui_concepts.html#sec:Hyperlinking_and_Navigation">15.1.1.13. Hyperlinking and Navigation</a></li>
+<li><a href="ui_concepts.html#sec:Syntax_and_Semantic_Coloring">15.1.1.14. Syntax and Semantic Coloring</a></li>
+<li><a href="ui_concepts.html#sec:Code_Formatter">15.1.1.15. Code Formatter</a></li>
+<li><a href="ui_concepts.html#sec:Wizards">15.1.1.16. Wizards</a></li>
+<li><a href="ui_concepts.html#sec:Cheat_Sheets">15.1.1.17. Cheat Sheets</a></li>
+<li><a href="ui_concepts.html#sec:Context_sensitive_Help">15.1.1.18. Context-sensitive Help</a></li>
+<li><a href="ui_concepts.html#sec:Hovers">15.1.1.19. Hovers</a></li>
+<li><a href="ui_concepts.html#sec:Folding">15.1.1.20. Folding</a></li>
+<li><a href="ui_concepts.html#sec:Customizable_validation___severity">15.1.1.21. Customizable validation / severity</a></li>
+<li><a href="ui_concepts.html#sec:Proposals">15.1.1.22. Proposals</a></li>
+</ul>
+</li>
+<li><a href="ui_concepts.html#sec:Non_Eclipse_UI_Concepts">15.1.2. Non-Eclipse UI Concepts</a>
+<ul class="sectlevel4">
+<li><a href="ui_concepts.html#sec:Overlays">15.1.2.1. Overlays</a></li>
+<li><a href="ui_concepts.html#sec:Goto__Inferred__Type">15.1.2.2. Goto (Inferred) Type</a></li>
+<li><a href="ui_concepts.html#sec:Postfix_Completion">15.1.2.3. Postfix Completion</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="ui_concepts.html#_user-interface-resources">15.2. User Interface Resources</a>
+<ul class="sectlevel3">
+<li><a href="ui_concepts.html#_icons">15.2.1. Icons</a>
+<ul class="sectlevel4">
+<li><a href="ui_concepts.html#_eclipse-platform-icons">15.2.1.1. Eclipse Platform Icons</a></li>
+<li><a href="ui_concepts.html#_n4js-specific-icons">15.2.1.2. N4JS Specific Icons</a></li>
+<li><a href="ui_concepts.html#_high-resolution-icons">15.2.1.3. High Resolution Icons</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="formatting.html#_formatting">16. Formatting</a>
+<ul class="sectlevel2">
+<li><a href="formatting.html#sec:FmtObjective">16.1. Objective</a>
+<ul class="sectlevel3">
+<li><a href="formatting.html#sec:FmtFormatting_Comments">16.1.1. Formatting Comments</a></li>
+</ul>
+</li>
+<li><a href="formatting.html#sec:FmtArchitecture">16.2. Architecture</a>
+<ul class="sectlevel3">
+<li><a href="formatting.html#sec:Implementation_example">16.2.1. Implementation example</a></li>
+</ul>
+</li>
+<li><a href="formatting.html#sec:FmtFormatter_Implementation_Guidelines">16.3. Formatter Implementation Guidelines</a></li>
+<li><a href="formatting.html#sec:FmtConfiguration">16.4. Configuration</a></li>
+<li><a href="formatting.html#sec:FmtUI_Integration">16.5. UI Integration</a></li>
+<li><a href="formatting.html#sec:FmtUnit_Testing_with_Xpect">16.6. Unit Testing with Xpect</a></li>
+</ul>
+</li>
+<li><a href="external_libraries.html#_external-libraries">17. External Libraries</a>
+<ul class="sectlevel2">
+<li><a href="external_libraries.html#sec:Major_Components">17.1. Major Components</a>
+<ul class="sectlevel3">
+<li><a href="external_libraries.html#subsec:External_Resources">17.1.1. External Resources</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Workspace">17.1.2. External Library Workspace</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Preference_Store">17.1.3. External Library Preference Store</a></li>
+<li><a href="external_libraries.html#subsec:npm_Manager">17.1.4. Library Manager</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Builder_Helper">17.1.5. External Library Builder</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Xtext_Index_Persister">17.1.6. External Library Xtext Index Persister</a></li>
+<li><a href="external_libraries.html#subsec:External_Library_Preference_Page">17.1.7. External Library Preference Page</a></li>
+</ul>
+</li>
+<li><a href="external_libraries.html#sec:Headless_External_Library_Support">17.2. Headless External Library Support</a>
+<ul class="sectlevel3">
+<li><a href="external_libraries.html#_custom-npm-settings">17.2.1. Custom npm settings</a></li>
+</ul>
+</li>
+<li><a href="external_libraries.html#sec:lmFutureWork">17.3. Future Work</a>
+<ul class="sectlevel3">
+<li><a href="external_libraries.html#subsec:lmMultipleDependencyScope">17.3.1. Multiple Dependency Scope</a></li>
+<li><a href="external_libraries.html#subsec:lmRunTestsFromLibrary">17.3.2. Run Tests from TestLibrary</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="json_support.html#sec:JSON_Support">18. JSON Support</a>
+<ul class="sectlevel2">
+<li><a href="json_support.html#sec:JSON_Parser">18.1. JSON Parser</a>
+<ul class="sectlevel3">
+<li><a href="json_support.html#sec:JSON_Parser_Unicode_Escaping">18.1.1. Escaping Unicode Control Characters in String Literals</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Empty_Text">18.1.2. Empty Text</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Nested_Structures">18.1.3. Nested Structures</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Whitespace">18.1.4. Whitespace</a></li>
+<li><a href="json_support.html#sec:JSON_Parser_Comments">18.1.5. Comments</a></li>
+</ul>
+</li>
+<li><a href="json_support.html#sec:JSON_Language_Extensions">18.2. JSON Language Extensions</a>
+<ul class="sectlevel3">
+<li><a href="json_support.html#sec:JSON_Validator_Extensions">18.2.1. JSON Validator Extensions</a>
+<ul class="sectlevel4">
+<li><a href="json_support.html#sec:File_Specitic_Validator_Extensions">18.2.1.1. File-Specific Validator Extensions</a></li>
+<li><a href="json_support.html#sec:JSON_Declarative_JSON_Validator_Extensions">18.2.1.2. Declarative JSON Validator Extensions</a></li>
+</ul>
+</li>
+<li><a href="json_support.html#_json-resource-description-strategy">18.2.2. JSON Resource Description Strategy</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_jsdoc">19. JSDoc</a>
+<ul class="sectlevel2">
+<li><a href="jsdoc.html#sec:Design_Rationale">19.1. Design Rationale</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#_general-design">19.1.1. General Design</a></li>
+<li><a href="jsdoc.html#sec:Type_Expressions">19.1.2. Type Expressions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="docexporter.html#_docexporter">20. DocExporter</a>
+<ul class="sectlevel2">
+<li><a href="docexporter.html#sec:Specification_Exporter">20.1. Specification Exporter</a></li>
+</ul>
+</li>
+<li><a href="rename_refactoring.html#_rename-refactoring">21. Rename Refactoring</a>
+<ul class="sectlevel2">
+<li><a href="rename_refactoring.html#_rename-refactoring-ui-interaction">21.1. Rename Refactoring UI interaction</a></li>
+<li><a href="rename_refactoring.html#_renameelementprocessor-interaction">21.2. RenameElementProcessor interaction</a></li>
+</ul>
+</li>
+<li><a href="flow_graphs.html#chap:flowgraphs">22. Flow Graphs</a>
+<ul class="sectlevel2">
+<li><a href="flow_graphs.html#sec:flowgraphs_overview">22.1. Flow graphs overview</a>
+<ul class="sectlevel3">
+<li><a href="flow_graphs.html#_internal-graph">22.1.1. Internal graph</a></li>
+<li><a href="flow_graphs.html#_optimizations">22.1.2. Optimizations</a></li>
+<li><a href="flow_graphs.html#_api-for-client-analyses">22.1.3. API for client analyses</a>
+<ul class="sectlevel4">
+<li><a href="flow_graphs.html#_mapping-from-internal-to-ast-elements">22.1.3.1. Mapping from internal to AST elements</a></li>
+<li><a href="flow_graphs.html#_graph-visitor">22.1.3.2. Graph visitor</a></li>
+<li><a href="flow_graphs.html#_graph-explorer">22.1.3.3. Graph explorer</a></li>
+<li><a href="flow_graphs.html#_branch-walker">22.1.3.4. Branch walker</a></li>
+<li><a href="flow_graphs.html#_example-1-compute-string-for-each-path">22.1.3.5. Example 1: Compute string for each path</a></li>
+<li><a href="flow_graphs.html#_path-quantor">22.1.3.6. Path quantor</a></li>
+</ul>
+</li>
+<li><a href="flow_graphs.html#_control-flow-analyses">22.1.4. Control flow analyses</a>
+<ul class="sectlevel4">
+<li><a href="flow_graphs.html#_dead-code-analysis">22.1.4.1. Dead code analysis</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="flow_graphs.html#sec:dataflow">22.2. Dataflow</a>
+<ul class="sectlevel3">
+<li><a href="flow_graphs.html#_dataflow-graph">22.2.1. Dataflow graph</a></li>
+<li><a href="flow_graphs.html#_dataflow-analyses">22.2.2. Dataflow analyses</a>
+<ul class="sectlevel4">
+<li><a href="flow_graphs.html#_def-def-def-nothing-analysis">22.2.2.1. Def&#8594;Def / Def&#8594;Nothing analysis</a></li>
+<li><a href="flow_graphs.html#_def-use-decl-analysis">22.2.2.2. Def|Use&#8592;Decl analysis</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="publish_npms.html#sec:publish-npms-to-public">23. Publish npms</a>
+<ul class="sectlevel2">
+<li><a href="publish_npms.html#sec:publish-npms-n4js-maven">23.1. Publish n4js-libs to during  maven build</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Hints">Appendix A: Hints</a>
+<ul class="sectlevel2">
+<li><a href="appendix_a_hints.html#sec:XtextInjection">A.1. Xtext Injection</a>
+<ul class="sectlevel3">
+<li><a href="appendix_a_hints.html#sec:DI_MultipleInjectors_Singletons">A.1.1. Multiple Injectors and Singletons</a>
+<ul class="sectlevel4">
+<li><a href="appendix_a_hints.html#sec:DI_avoid_duplicate_singletons">A.1.1.1. Avoiding duplicate singletons</a>
+<ul class="sectlevel5">
+<li><a href="appendix_a_hints.html#sec:DI_binding_in_shared">A.1.1.1.1. Defining binding in the shared injector</a></li>
+<li><a href="appendix_a_hints.html#sec:DI_binding_in_custom">A.1.1.1.2. Defining binding in the custom injector</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:DI_Hints">A.1.2. Dependency Injection Hints</a>
+<ul class="sectlevel4">
+<li><a href="appendix_a_hints.html#sec:DI_custom_bundle">A.1.2.1. Use DI in custom bundle, use DI with extensions</a>
+<ul class="sectlevel5">
+<li><a href="appendix_a_hints.html#sec:DI_custom_bundle_problem">A.1.2.1.1. Problem</a></li>
+<li><a href="appendix_a_hints.html#sec:DI_custom_bundle_solution">A.1.2.1.2. Solution</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Access_Other_DSL_Injector">A.1.2.2. How do I get the Guice Injector of my language?</a>
+<ul class="sectlevel5">
+<li><a href="appendix_a_hints.html#sec:DSL_Injector_UI_context">A.1.2.2.1. UI context</a></li>
+<li><a href="appendix_a_hints.html#sec:DSL_Injector_Non_UI_context">A.1.2.2.2. Non UI context but with injection context</a></li>
+<li><a href="appendix_a_hints.html#sec:DSL_Injector_Non_UI_non_injection_context">A.1.2.2.3. Non UI context without injection context</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Cancel_Indicator">A.1.2.3. How do I get cancel indicators in different contexts?</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Eclipse">A.2. Eclipse</a>
+<ul class="sectlevel3">
+<li><a href="appendix_a_hints.html#sec:Show_Xtext_Index">A.2.1. Show the current Xtext index</a></li>
+<li><a href="appendix_a_hints.html#sec:Plugin_spy">A.2.2. Plug-in spy</a></li>
+</ul>
+</li>
+<li><a href="appendix_a_hints.html#sec:Maven-hints">A.3. Maven</a>
+<ul class="sectlevel3">
+<li><a href="appendix_a_hints.html#how-to-check-for-maven-mojo-updates">A.3.1. How to check for Maven MOJO updates</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#_module-loading">Appendix B: Module Loading</a>
+<ul class="sectlevel2">
+<li><a href="appendix_b_module_loading.html#sec:Dependency_Management">B.1. Dependency Management</a></li>
+<li><a href="appendix_b_module_loading.html#ecmascript-modules">B.2. ECMAScript Modules</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:ES5_Modules_Systems">B.2.1. ES5 Modules Systems</a></li>
+<li><a href="appendix_b_module_loading.html#sec:ES6_Modules">B.2.2. ES6 Modules</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:ECMAScript_Module_Loaders">B.3. ECMAScript Module Loaders</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:ES6_Module_Loaders">B.3.1. ES6 Module Loaders</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Polyfills_for_ES6_Module_Loaders">B.3.2. Polyfills for ES6 Module Loaders</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:es6_module_loader">B.3.2.1. es6-module-loader</a></li>
+<li><a href="appendix_b_module_loading.html#sec:SystemJS">B.3.2.2. SystemJS</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Demo">B.3.2.3. Demo</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#case-study-typescript">B.4. Case Study : TypeScript</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:ES6_Modules_Support">B.4.1. ES6 Modules Support</a></li>
+<li><a href="appendix_b_module_loading.html#sec:TypeScript_and_Module_Loading">B.4.2. TypeScript and Module Loading</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Cyclic_Dependencies">B.5. Cyclic Dependencies</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:Setup">B.5.1. Setup</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Transpile_and_Execute">B.5.2. Transpile and Execute</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Module_Format___AMD">B.5.2.1. Module Format = AMD</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Module_Format___CommonJS">B.5.2.2. Module Format = CommonJS</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Module_Format___SystemJS">B.5.2.3. Module Format = SystemJS</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Conclusion">B.5.3. Conclusion</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#system.register-as-transpilation-target">B.6. System.register as transpilation target</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#sec:Introduction">B.6.1. Introduction</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:External_Transpilers">B.6.1.1. External Transpilers</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Example_of_a_System_register_module">B.6.1.2. Example of a System.register module</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Structure_of_a_System_register_module">B.6.2. Structure of a System.register module</a></li>
+<li><a href="appendix_b_module_loading.html#_transpilation-hints">B.6.3. Transpilation Hints</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Handling_Imports">B.6.3.1. Handling Imports</a></li>
+<li><a href="appendix_b_module_loading.html#sec:__exportFn__">B.6.3.2. &lt;&lt;exportFn&gt;&gt;</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Handling_Exports">B.6.3.3. Handling Exports</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:Examples_w__Circular_Dependencies">B.6.4. Examples w/ Circular Dependencies</a></li>
+<li><a href="appendix_b_module_loading.html#sec:N4JS_Examples_w__Circular_Dependencies">B.6.5. N4JS Examples w/ Circular Dependencies</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Unresolved_Cyclic_Dependencies">B.6.5.1. Unresolved Cyclic Dependencies</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Variables___Functions">B.6.5.2. Examples with Variables &amp; Functions</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Classes">B.6.5.3. Examples with Classes</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Examples_with_SubClassing">B.6.5.4. Examples with SubClassing</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Miscellaneous">B.6.5.5. Miscellaneous</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#_resources">B.6.6. Resources</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#sec:CommonJS_as_transpilation_target">B.7. CommonJS as transpilation target</a>
+<ul class="sectlevel3">
+<li><a href="appendix_b_module_loading.html#_introduction-2">B.7.1. Introduction</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Transpilation_Hints">B.7.2. Transpilation Hints</a>
+<ul class="sectlevel4">
+<li><a href="appendix_b_module_loading.html#sec:Import_Statements">B.7.2.1. Import Statements</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Export_Statements">B.7.2.2. Export Statements</a></li>
+<li><a href="appendix_b_module_loading.html#sec:Tracking_Live_Bindings">B.7.2.3. Tracking Live Bindings</a></li>
+<li><a href="appendix_b_module_loading.html#sec:A_complete_example">B.7.2.4. A complete example</a></li>
+</ul>
+</li>
+<li><a href="appendix_b_module_loading.html#_resources-2">B.7.3. Resources</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_c_license.html#sec:License">Appendix C: License</a></li>
+<li><a href="appendix_d_acronyms.html#sec:Acronyms">Appendix D: Acronyms</a></li>
+<li><a href="appendix_e_bibliography_and_footnotes.html#_bibliography-and-footnotes">Appendix E: Bibliography and Footnotes</a></li>
+</ul>
+</div>
+</div>
+<div id="content"><div class="sect1">
+<h2 id="_validation"><a class="anchor" href="#_validation"></a><a class="link" href="#_validation">10. Validation</a></h2>
+<div class="sectionbody">
+<div class="admonitionblock warning">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-warning" title=""></i>
+</td>
+<td class="content">
+This chapter may be outdated.
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>In this chapter the concept for the validation infrastructure of the N4JS IDE is described.</p>
+</div>
+<div class="paragraph">
+<p>Requirements:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>like in old IDE centralize issue codes and messages</p>
+</li>
+<li>
+<p>instead of the DLTK API, the Xtext Validation API should be used</p>
+</li>
+<li>
+<p>there should be an unified approach / call to produce validation messages (as in old IDE with the call of reportProblem)</p>
+</li>
+</ul>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:validation_overview"><a class="anchor" href="#sec:validation_overview"></a><a class="link" href="#sec:validation_overview">10.1. Validation overview</a></h3>
+<div class="ulist">
+<ul>
+<li>
+<p>in Xtext in most cases validation should triggered after all Xtext resources are linked (so everything is resolved), so most validations are defined in N4JSValidator and there in composed validators</p>
+</li>
+<li>
+<p>in Xtext there are resource diagnostics and validation diagnostics</p>
+<div class="ulist">
+<ul>
+<li>
+<p>resource diagnostics are produced for issues related to found syntax errors and linking errors</p>
+</li>
+<li>
+<p>validation diagnostics are produced for issues found during semantic validation (model invariants)</p>
+</li>
+<li>
+<p>Note, that you can only produce diagnostics only for the resource currenlty validated - e.g. it isn’t possible to create a marker for a duplicate issue in the other resource that contains the first element while producing the issue for the second - you have to create the diagnostic when validating the other resource</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>validation message sources</p>
+<div class="ulist">
+<ul>
+<li>
+<p>parser, e.g. ANTLR parser: messages are contained and produced internally by the parser but can be adapted by a customized SyntaxErrorMessageProvider (see link section below)</p>
+</li>
+<li>
+<p>lazy linking - N4JSLinker (extension of lazy linker): custom handling exceptions from value converters, that produces own issues as XtextLinkingDiagnostic (this is a resource diagnostic)</p>
+</li>
+<li>
+<p>lazy linking - ASTStructureValidator: traverses AST and produces custom DiagnosticMessage (triggered during N4JSLinker.doLinkModel), creates XtextLinkingDiagnostic (this is a resource diagnostic). The ASTStructureValidator checks for things like allowed occurence of continue, break, return as well as allowed labels</p>
+</li>
+<li>
+<p>linking - default: uses the ILinkingDiagnosticMessageProvider to create error messages for typical error cases (referenced not resolved, unique constraint violation, bounds contraints violation, etc.)</p>
+</li>
+<li>
+<p>linking - ErrorAwareLinkingService: In N4JS we have introduced a custom IEObjectDescription AbstractDescriptionWithError that holds issue code and error message and ErrorAwareLinkingService as extension of DefaultLinkingService to produce for every AbstractDescriptionWithError a XtextLinkingDiagnostic (this is a resource diagnostic) - the usual Xtext behavior would be to produce a linking error with linking disabled, with our customization linking still works but the error message/marker is produced as well. Currently there are these custom AbstractDescriptionWithError implementations, that are produced during scoping</p>
+<div class="ulist">
+<ul>
+<li>
+<p>AmbiguousImportDescription: indicate an ambiguous wildcard import</p>
+</li>
+<li>
+<p>PlainAccessOfAliasedImportDescription: indicate accessing type directly instead of using the alias it has been imported with</p>
+</li>
+<li>
+<p>InvisibleMemberDescription: indicate accessing a member, that is not visible to the caller due to access modifier restrictions</p>
+</li>
+<li>
+<p>InvisibleTypeOrVariableDescription: indicate accessing a type / variable or function, that is not visible to the caller due to access modifier restrictions</p>
+</li>
+<li>
+<p>WrongFieldAccessorDescription: setter/getter access used in wrong context</p>
+</li>
+<li>
+<p>WrongStaticAccessorDescription: static/non-static access used in wrong context</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>N4JSTypeSystem:</p>
+<div class="ulist">
+<ul>
+<li>
+<p>error: cannot type given expression</p>
+</li>
+<li>
+<p>error: element is not a subtype of another type</p>
+</li>
+<li>
+<p>RuleFailedException is thrown in type system, then handled as result where out of the contained information the AbstractDeclarativeValidator API is used to create issues via calls to error(..) or warning(..) methods</p>
+</li>
+<li>
+<p>RuleFailedExceptionWithoutStacktrace - sub class of RuleFailedException</p>
+</li>
+<li>
+<p>N4JSTypeValidator.createError &#8594; delegates to AbstractDeclarativeValidator, or directly calls AbstractDeclarativeValidator.error</p>
+</li>
+<li>
+<p>XsemanticsValidatorErrorGenerator (currently not used)</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>N4JSValidation: composed validators, declarative checks, i.e. using annotation @Check at methods, issues mostly created by using combination of message, context object, EFeature and index passed to AbstractDeclarativeValidator methods like error(..), warning(..)</p>
+<div class="ulist">
+<ul>
+<li>
+<p>N4JSClassValidator - checks related to classes, like duplicate member check</p>
+</li>
+<li>
+<p>N4JSFunctionValidator - checks for function expressions in expression statements and creates an error, but this validation is already done by the ASTStructureValidator</p>
+</li>
+<li>
+<p>N4JSImportValidator - checks invalid, duplicated and invalid imports</p>
+</li>
+<li>
+<p>N4JSInterfaceValidator - currently checks only for static members</p>
+</li>
+<li>
+<p>N4JSRoleValidator - currently checks only for static members</p>
+</li>
+<li>
+<p>N4JSStrictValidator - checks for function expressions in expression statements and creates an error, but this validation is already done by the ASTStructureValidator, thus this composite test is commented out</p>
+</li>
+<li>
+<p>N4JSTypeValidator - this is type system, see above</p>
+</li>
+</ul>
+</div>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>Check types and check modes</p>
+<div class="ulist">
+<ul>
+<li>
+<p>Check types are used in <code>@Check</code> annotation to influence, when a validation is triggered</p>
+<div class="ulist">
+<ul>
+<li>
+<p><code>FAST</code> - Check is declared as fast</p>
+</li>
+<li>
+<p><code>NORMAL</code> - the common checks</p>
+</li>
+<li>
+<p><code>EXPENSIVE</code> - long running checks</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>Check modes decide using check types when to run which types of checks</p>
+<div class="ulist">
+<ul>
+<li>
+<p><code>FAST_ONLY</code> - used by Xtext editor to execute FAST checks on every key stroke and in embedded Xtext editors</p>
+</li>
+<li>
+<p><code>NORMAL_ONLY</code> - not used in Xtext framework itself</p>
+</li>
+<li>
+<p><code>EXPENSIVE_ONLY</code> - not used in Xtext framework itself</p>
+</li>
+<li>
+<p><code>NORMAL_AND_FAST</code> - used by Xtext editor to execute FAST and NORMAL checks on file save as well as on marker update for changed resources (delta calculated by Xtext builder)</p>
+</li>
+<li>
+<p>ALL - executes all types of checks when invoking explicitley the Validate action in the context menu of the Xtext editor</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>So by default check types and modes aren’t configurable at runtime</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>Severity</p>
+<div class="ulist">
+<ul>
+<li>
+<p>types</p>
+<div class="ulist">
+<ul>
+<li>
+<p><code>ERROR</code> - indicates a serious issue, that later will prevent things like builder, compiler and so on, to run</p>
+</li>
+<li>
+<p><code>WARNING</code> - indicates a possible semantic problem, where the user have to decide how to handle it. Issues with such severity won’t stop any post processing</p>
+</li>
+<li>
+<p><code>INFO</code> - only an information hint for the user. Note, it is not allowed to create a diagnostic with severity INFO.</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>can be statically provided by calling the AbstractDeclarativeValidator methods error(..), warning(..), info(..) or directly pass the severity to a sub class of AbstractValidationDiagnostic (e.g. FeatureBasedDiagnostic, RangeBasedDiagnostic)</p>
+</li>
+<li>
+<p>can also determined dynamically at runtime with using the IssueSeveritiesProvider and a implementation of IPreferenceValuesProvider (e.g. the EclipsePreferencesProvider that uses the Eclipse preference store and preference page)</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>Issue codes</p>
+<div class="ulist">
+<ul>
+<li>
+<p>used to identify an issue elsewhere, e.g. when applying an quickfix for a validation issue but also for configuring validation handling (e.g. in a Eclipse preference page).</p>
+</li>
+<li>
+<p>We can use this issue code to also externalize the issue messages at a central place</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>Issue data: String array to store additional data to be used in other places (e.g. hints for quickfixes)</p>
+</li>
+<li>
+<p>message: The message shown as text for the marker created at the resource in Eclipse and shown in the Xtext editor but also available by the methods getWarnings and getErrors at the XtextResource itself and so usable when logging messages to console in headless mode</p>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:validation_control_flow"><a class="anchor" href="#sec:validation_control_flow"></a><a class="link" href="#sec:validation_control_flow">10.2. Validation control flow</a></h3>
+<div class="paragraph">
+<p><a href="#fig:cd_validation">Validation control flow</a> gives an overview over the common control flow that triggers validation.</p>
+</div>
+<div id="fig:cd_validation" class="imageblock center">
+<div class="content">
+<img src="chapters/10_validation/images/cd_validation.svg" alt="cd validation">
+</div>
+<div class="title">Figure 24. Validation control flow</div>
+</div>
+<div class="paragraph">
+<p>Validation is either triggered by dirty state handling (editing an Xtext document without saving starts a validation job) or by the automated build (invoked directly or started by resource changes in the project e.g. after saving a file).</p>
+</div>
+<div class="paragraph">
+<p>While in dirty state handling the current resource is already parsed and resolved the builder have to load the resource.</p>
+</div>
+<div class="paragraph">
+<p>All issues collected during load (i.e. during parsing, linking and scoping) the resource are added to the resource.</p>
+</div>
+<div class="paragraph">
+<p>In the automated build process there is step <code>updateMarkers</code> that triggers the validation.</p>
+</div>
+<div class="paragraph">
+<p>The <code>SourceContainerAwareResourceValidator</code> is a customization by us to handle only files that are contained in folders declared as source container by the package.json file.</p>
+</div>
+<div class="paragraph">
+<p>The <code>CancelableDiagnostican</code>, called by the resource validator, iterates over all elements contained in the resource. For each element the bound validator is called, in our case <code>N4JSValidator</code>, as it is registered as validator for the N4JS EPackage (in <code>AbstractN4JSValidator</code>).</p>
+</div>
+<div class="paragraph">
+<p>As this validator extends <code>AbstractDeclarativeValidator</code> in the first step all methods that are annotated with @Check and that have exactly one parameter are collected keyed by the type of their input parameter. The result of this collection process is cached. There is a defined order how the methods are collected:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>all local methods</p>
+</li>
+<li>
+<p>all methods recursively found in the super classes of the current class</p>
+</li>
+<li>
+<p>all methods found for the in the composed check annotation defined validators (by applying this algorithm as well)</p>
+</li>
+<li>
+<p>all methods recursively found in the composed checks in the super classes of the current class (by applying this algorithm as well)</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>The <code>N4JSValidator</code> filters all methods that uses the type of the currently traversed element from the before collected check methods and invokes them with the element from the resource.</p>
+</div>
+<div class="paragraph">
+<p>The Xsemantics type system validator is used as one of the composed validators in <code>N4JSValidator</code>. So although <code>N4JSValidator</code> extends <code>N4JSTypeSystemValidator</code>, <code>N4JSTypeSystemValidator</code> just re-uses the validation infrastructure but not its call hierarchy.</p>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:validation_issue_ids"><a class="anchor" href="#sec:validation_issue_ids"></a><a class="link" href="#sec:validation_issue_ids">10.3. Issue IDs and Messages</a></h3>
+<div class="paragraph">
+<p>For now the NLS validation message bundle resides in<br>
+<code>/org.eclipse.n4js/src/org/eclipse/n4js/validation/messages.properties</code><br>
+The entries in the messages.properties follows the pattern as described in <code>NLSProcessor</code>, the NLS class is <code>IssueCodes</code></p>
+</div>
+<div class="admonitionblock tip">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-tip" title=""></i>
+</td>
+<td class="content">
+We use the same pattern for semver and json.
+</td>
+</tr>
+</table>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>IDs shouldn’t be to long, as there might be a lot of markers and the issue codes are stored in memory</p>
+</li>
+<li>
+<p>the ID should encode where the issue has been created, therefore there should be common used prefixes like</p>
+<div class="ulist">
+<ul>
+<li>
+<p>PRS for parser (not used yet)</p>
+</li>
+<li>
+<p>VCO for value converter</p>
+</li>
+<li>
+<p>AST for issues found during AST traversal</p>
+</li>
+<li>
+<p>LIN for issues found during scoping/linking (not used yet)</p>
+</li>
+<li>
+<p>TYS for type system</p>
+</li>
+<li>
+<p>VAL for semantic validation (not used yet)</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>besides the source also the domain of the issue should be encoded (the following list may reduced or extended over time, when it gets obvious which sorts of domain specific validations are required in which frequency)</p>
+<div class="ulist">
+<ul>
+<li>
+<p>CLF for issues common to all classifiers</p>
+</li>
+<li>
+<p>CLA for classes (not used yet)</p>
+</li>
+<li>
+<p>ROL for roles</p>
+</li>
+<li>
+<p>FUN for function</p>
+</li>
+<li>
+<p>IMP for imports</p>
+</li>
+<li>
+<p>VAR for variables (not used yet)</p>
+</li>
+<li>
+<p>MEM for classifier members in general</p>
+</li>
+<li>
+<p>OLI for object literals (not used yet)</p>
+</li>
+<li>
+<p>ENU for enumerations (not used yet)</p>
+</li>
+<li>
+<p>ARR for array literals (not used yet)</p>
+</li>
+<li>
+<p>ANN for annotation related issues (not used yet)</p>
+</li>
+<li>
+<p>EXP for expression related issues (assignment expression, binary expression, etc.) (not used yet)</p>
+</li>
+<li>
+<p>STMT for statement related issues, such as if-else (conditional) , loops, switch etc.</p>
+</li>
+<li>
+<p>PRP for property access related issues (not used yet)</p>
+</li>
+<li>
+<p>EXC for exception handling related issues (not used yet)</p>
+</li>
+<li>
+<p>LBL for labels related issues (not used yet)</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>also technical validation aspects can be encoded</p>
+<div class="ulist">
+<ul>
+<li>
+<p>DUP for duplicate checks</p>
+</li>
+<li>
+<p>VIS for visibility checks (public, private, export, etc.)</p>
+</li>
+<li>
+<p>STR for issues related only applied in strict mode</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>examples</p>
+<div class="ulist">
+<ul>
+<li>
+<p><code>IMP_AMBIGUOUS</code></p>
+</li>
+<li>
+<p><code>VIS_ILLEGAL_MEMBER_ACCESS</code></p>
+</li>
+<li>
+<p><code>CLF_ABSTRACT_FINAL</code></p>
+</li>
+<li>
+<p><code>AST_RESERVED_IDENTIFIER</code></p>
+</li>
+<li>
+<p><code>VCO_HEXINT_CONVERT_EMPTY_STR</code></p>
+</li>
+<li>
+<p><code>TYS_NO_SUBTYPE</code></p>
+</li>
+</ul>
+</div>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:validation_usage_patterns"><a class="anchor" href="#sec:validation_usage_patterns"></a><a class="link" href="#sec:validation_usage_patterns">10.4. Usage Pattern</a></h3>
+<div class="paragraph">
+<p>Due to the different places and circumstances a real unification of the API wasn’t possible yet (and wouldn’t have made sense), so there are these different usage patterns</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>in a custom error aware EObjectDescription like WrongFieldAccessorDescription you just return the issue code in getIssueCode and the message created using the issue code as well as the replacements for the wildcards in getMessage</p>
+</li>
+<li>
+<p>in a validator extending AbstractDeclarativeValidator you just call <code>addIssue(message, context, EFeature, issueCode)</code>. The message you have to create before by calling the corresponding <code>getMessageFor[ISSUE_ID]</code> method passing the required wildcard replacement</p>
+</li>
+<li>
+<p>in the ASTStructureValidator you have to call <code>producer.addDiagnostic(new DiagnosticMessage(IssueCodes.messageFor[ISSUE_ID](wildcard1, wildcard2, ..), IssueCodes.getDefaultSeverity(IssueCodes.[ISSUE_ID]), IssueCodes.[ISSUE_ID]))</code></p>
+</li>
+<li>
+<p>in the custom value converters you have to pass the information to an exception, so the call is: <code>new N4JSValueConverterException(IssueCodes.getMessageFor[ISSUE_ID](wildcard1, wildcard2, ..), IssueCodes.[ISSUE_ID], node, null)</code>. Beside this exception also N4JSValueConverterWithValueException is used in some places. In N4JSLinker then these exceptions are catched and a DiagnosticMessage is created out of the informations contained in these exceptions.</p>
+</li>
+<li>
+<p>As Xsemantics uses hard wired error or warning in its grammar you cannot adapt these places, but there are currently only three messages produced by Xsemantic (cannot type, not a sub type, null object passed to system). They are all handled in N4JSTypeValidator.createError where the message from Xsemantic is split up in its parts and then passed as wild card replacements to e.g. <code>IssueCodes.getMessageForTYS_NO_SUBTYPE</code>.</p>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect2">
+<h3 id="sec:validation_links"><a class="anchor" href="#sec:validation_links"></a><a class="link" href="#sec:validation_links">10.5. Links</a></h3>
+<div class="ulist">
+<ul>
+<li>
+<p><a href="http://www.eclipse.org/Xtext/documentation.html#validation">Xtext Runtime Concepts: Validation</a></p>
+</li>
+<li>
+<p><a href="http://blog.dietmar-stoll.de/2013/04/multiple-validators-in-xtext.html">Multiple validators in Xtext</a></p>
+</li>
+<li>
+<p>Customize error messages</p>
+<div class="ulist">
+<ul>
+<li>
+<p><a href="http://zarnekow.blogspot.de/2010/06/customizing-error-messages-in-xtext-10.html">Customizing error messages in Xtext</a></p>
+</li>
+<li>
+<p><a href="http://blog.dietmar-stoll.de/2012/07/custom-syntax-error-messages-with-quick.html">Custom syntax error messages with quickfix</a></p>
+</li>
+<li>
+<p><a href="http://stackoverflow.com/questions/14526524/xtext-customizing-error-msg-by-unordered-groups">Xtext: customizing error messages by unordered groups</a></p>
+</li>
+</ul>
+</div>
+</li>
+</ul>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div id="footer">
+<div id="footer-text">
+Version 0.9<br>
+Last updated 2019-08-07 15:02:40 CEST
+</div>
+</div>
+<!-- ************* docinfo-footer *************************************************************** -->
+<div class="Grid social" style="color:#d5dfea">
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <h2>Quick Links</h2>
+    <ul>
+      <li><a href="../downloads.html">Download</a></li>
+      <li><a href="../userguides/index.html">Documentation</a></li>
+      <li><a href="https://github.com/eclipse/n4js/">Source</a></li>
+      <li><a href="https://github.com/eclipse/n4js/issues">Issues</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="https://www.eclipse.org/forums/index.php/f/365/">Forum</a></li>
+      <li><a href="http://n4js.blogspot.de/">Blog</a></li>
+      <li><a href="https://dev.eclipse.org/mailman/listinfo/n4js-dev">Mailing List</a></li>
+      <li><a href="https://projects.eclipse.org/projects/technology.n4js">Eclipse Project Page</a></li>
+      <li><a href="https://twitter.com/n4jsdev">Tweets by n4jsdev</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="http://www.eclipse.org/">Eclipse Home</a></li>
+      <li><a href="http://www.eclipse.org/legal/privacy.php">Privacy Policy</a></li>
+      <li><a href="http://www.eclipse.org/legal/termsofuse.php">Terms of Use</a></li>
+      <li><a href="http://www.eclipse.org/legal/copyright.php">Copyright Agent</a></li>
+      <li><a href="http://www.eclipse.org/legal/">Legal</a></li>
+    </ul>
+  </div>
+  <div style="clear: both; height: 0; overflow: hidden;"></div>
+</div>
+
+<!-- ************* UI Scripts ************* -->
+<script type="text/javascript" src="scripts/back-to-top.js"></script>
+
+<script type="text/javascript" src="scripts/treeview.js"></script>
+<script type="text/javascript" src="scripts/toc.js"></script>
+
+<!-- ************* Prism.js Syntax Highlighting ************* -->
+<script src="scripts/prism.js"></script>
+
+<script type="text/javascript">
+	// Add the 'toclist' id for search function
+	$(".toc2 > ul").attr('id', 'toclist');
+	// Generate a Search input form
+	$("#toclist > li:first-of-type").before('<input type="text" id="pagesearch" onkeyup="search()" placeholder="Search for section...">');
+	$("#toclist > li:first-of-type").before('<i id="clear" class="fa fa-times-circle-o"></i>');
+	$("#clear").click(function(){
+	    $("#pagesearch").val('');
+	    search();
+	    $('.toc2 > ul').treeView('collapseAll');
+	});
+	// intialize Treeview.js
+	$(".toc2 > ul").treeView();
+	// Initialize Scrollspy
+</script>
+<!-- ************* docinfo-footer *************************************************************** -->
+</body>
+</html>
\ No newline at end of file
diff --git a/idespec/N4JSIDESpec.html b/idespec/N4JSIDESpec.html
new file mode 100644
index 0000000..e94e76b
--- /dev/null
+++ b/idespec/N4JSIDESpec.html
@@ -0,0 +1,5894 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="generator" content="Asciidoctor 1.5.5">
+<meta name="author" content="2019-08-07 15:02:40 CEST">
+<title>N4JS IDE Specification</title>
+<link rel="stylesheet" href="styles/spec.min.css">
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.6.3/css/font-awesome.min.css">
+<!-- ************* docinfo ******************************************************************* -->
+
+
+<!-- ************* Favicon ************-->
+<link rel="icon" href="images/favicon.ico" />
+
+<!-- ************* Back-to-top JQuery ************* -->
+<script src="https://code.jquery.com/jquery-1.12.4.js"></script>
+<script src="https://code.jquery.com/ui/1.12.0/jquery-ui.js"></script>
+
+
+<link href="styles/prism.min.css" rel="stylesheet" />
+<script type="text/javascript" async
+  src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2/MathJax.js?config=TeX-MML-AM_CHTML">
+</script>
+
+<!-- ************* Styles ************* -->
+<link rel="stylesheet" type="text/css" href="styles/n4jsspec-adoc.css">
+
+
+<!-- ****************** NavBar ****************** -->
+<div id="menubar">
+	<div class="banner">
+        <a href="https://www.eclipse.org/n4js/#"><img id="logo" src="images/n4js-logo.png" alt="Eclipse N4JS"></a>
+    </div>
+<ul>
+  <li><a href="index.html">Index</a></li>
+</ul>
+</div>
+<!-- ************* docinfo ******************************************************************* -->
+<style>
+      .admonitionblock td.icon .icon-todo:before{content:"\f249";color:#f4ee42}
+    </style>
+</head>
+<body class="book toc2 toc-left">
+<div id="header">
+<h1>N4JS IDE Specification</h1>
+<div class="details">
+<span id="author" class="author">2019-08-07 15:02:40 CEST</span><br>
+<span id="revnumber">version 0.9</span>
+</div>
+<div id="toc" class="toc2">
+<div id="toctitle">Table of Contents</div>
+<ul class="sectlevel1">
+<li><a href="#sec:Views">1. Views</a>
+<ul class="sectlevel2">
+<li><a href="#_eclipse-standard-views">1.1. Eclipse Standard Views</a>
+<ul class="sectlevel3">
+<li><a href="#sec:Project_Explorer_View">1.1.1. Project Explorer</a></li>
+<li><a href="#sec:Outline_View">1.1.2. Outline</a></li>
+<li><a href="#sec:Problems_View">1.1.3. Problems</a></li>
+<li><a href="#sec:Console_View">1.1.4. Console</a></li>
+<li><a href="#sec:History_View">1.1.5. History</a></li>
+<li><a href="#sec:Error_Log_View">1.1.6. Error Log</a></li>
+</ul>
+</li>
+<li><a href="#_n4js-specific-views">1.2. N4JS Specific Views</a>
+<ul class="sectlevel3">
+<li><a href="#_test-results">1.2.1. Test Results</a></li>
+<li><a href="#_source-graphs">1.2.2. Source Graphs</a></li>
+<li><a href="#_api-compare">1.2.3. API Compare</a></li>
+<li><a href="#_performance-graphs">1.2.4. Performance Graphs</a></li>
+<li><a href="#_source-mapping">1.2.5. Source Mapping</a></li>
+<li><a href="#_xpect-view">1.2.6. Xpect View</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#_navigation">2. Navigation</a>
+<ul class="sectlevel2">
+<li><a href="#sec:Outline_Navigation">2.1. Outline</a>
+<ul class="sectlevel3">
+<li><a href="#_quick-outline">2.1.1. Quick Outline</a></li>
+<li><a href="#_normal-outline">2.1.2. Normal Outline</a></li>
+</ul>
+</li>
+<li><a href="#_navigation-commands">2.2. Navigation Commands</a>
+<ul class="sectlevel3">
+<li><a href="#sec:Navigate_to_Declaration">2.2.1. Navigate to Declaration</a></li>
+<li><a href="#sec:find_by_references">2.2.2. Find by References</a></li>
+<li><a href="#sec:Open_Type_Declaration">2.2.3. Open Type Declaration</a></li>
+</ul>
+</li>
+<li><a href="#sec:Working_Sets">2.3. Working Sets</a>
+<ul class="sectlevel3">
+<li><a href="#sec:Working_Set_Managers">2.3.1. Working Set Managers</a></li>
+<li><a href="#sec:Working_Set_Constraints">2.3.2. Working Set Constraints</a></li>
+<li><a href="#sec:Manual_Association_Working_Set_Manager_UI_Features">2.3.3. Manual Association Working Set Manager - UI Features</a></li>
+<li><a href="#sec:Project_Name_Filter_Working_Set_Manager">2.3.4. Project Name Filter Working Set Manager</a></li>
+<li><a href="#sec:Git_Repository_Working_Set_Manager">2.3.5. Git Repository Working Set Manager</a></li>
+<li><a href="#sec:Project_Location_Working_Set_Manager">2.3.6. Project Location Working Set Manager</a></li>
+<li><a href="#sec:N4JS_Project_Type_Working_Set_Manager">2.3.7. N4JS Project Type Working Set Manager</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#_assistance">3. Assistance</a>
+<ul class="sectlevel2">
+<li><a href="#sec:Content_Assist">3.1. Content Assist</a>
+<ul class="sectlevel3">
+<li><a href="#sec:Complete_Keywords">3.1.1. Complete Keywords</a></li>
+<li><a href="#sec:Complete_Annotations">3.1.2. Complete Annotations</a></li>
+<li><a href="#sec:Complete_Identifier_Reference">3.1.3. Complete Identifier Reference</a></li>
+<li><a href="#sec:Complete_Member_Overrides">3.1.4. Complete Member Overrides</a></li>
+<li><a href="#sec:Constructor_Completion">3.1.5. Constructor Completion</a></li>
+<li><a href="#sec:Complete_Function_Expression">3.1.6. Complete Function Expression with Known Type</a></li>
+<li><a href="#sec:Complete_Variable_and_Parameter_Names">3.1.7. Complete Variable and Parameter Names</a></li>
+</ul>
+</li>
+<li><a href="#sec:Quick_Fixes">3.2. Quick Fixes</a>
+<ul class="sectlevel3">
+<li><a href="#sec:N4JS_Issue_Properties">3.2.1. N4JS Issue User data</a></li>
+<li><a href="#sec:N4JS_Issue_Fixes">3.2.2. N4JS Issue Fixes</a>
+<ul class="sectlevel4">
+<li><a href="#sec:Linking_Issues">3.2.2.1. Linking Issues</a></li>
+<li><a href="#sec:Import_Issues">3.2.2.2. Import Issues</a></li>
+<li><a href="#sec:Visibility_Issues">3.2.2.3. Visibility Issues</a></li>
+<li><a href="#sec:Classifier_Issues">3.2.2.4. Classifier Issues</a></li>
+<li><a href="#sec:Function_Issues">3.2.2.5. Function Issues</a></li>
+<li><a href="#sec:Syntax_Issues">3.2.2.6. Syntax Issues</a></li>
+<li><a href="#sec:Conversion_Issues">3.2.2.7. Conversion Issues</a></li>
+<li><a href="#sec:Type_Issues">3.2.2.8. Type Issues</a></li>
+<li><a href="#sec:Expression_Issues">3.2.2.9. Expression Issues</a></li>
+<li><a href="#sec:Super_Keyword_Issues">3.2.2.10. Super Keyword Issues</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#sec:Quick_Assist">3.3. Quick Assist</a></li>
+<li><a href="#sec:Cleanup_Operations">3.4. Cleanup Operations</a>
+<ul class="sectlevel3">
+<li><a href="#sec:Formatting">3.4.1. Formatting</a></li>
+<li><a href="#sec:Organize_Imports">3.4.2. Organize Imports</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#_wizards">4. Wizards</a>
+<ul class="sectlevel2">
+<li><a href="#sec:N4JS_Project_Wizard">4.1. N4JS Project Wizard</a></li>
+<li><a href="#sec:Empty_N4JS_File">4.2. Empty N4JS File</a></li>
+<li><a href="#sec:Empty_JS_File">4.3. Empty JS File</a>
+<ul class="sectlevel3">
+<li><a href="#sec:N4JS_Class_File_Wizard">4.3.1. N4JS Class Wizard</a></li>
+<li><a href="#field-properties">4.3.2. Field Properties</a></li>
+<li><a href="#visibility-issues-or-final-super-classes">4.3.3. Visibility issues or <code>@Final</code> super classes</a></li>
+<li><a href="#generation-1">4.3.4. Generation</a></li>
+<li><a href="#preview-1">4.3.5. Preview</a></li>
+</ul>
+</li>
+<li><a href="#sec:N4JS_Interface_Wizard">4.4. Interface Wizard</a>
+<ul class="sectlevel3">
+<li><a href="#field-properties-1">4.4.1. Field Properties</a></li>
+<li><a href="#visibility-issues">4.4.2. Visibility Issues</a></li>
+<li><a href="#import-naming-conflicts">4.4.3. Import naming conflicts</a></li>
+<li><a href="#generation-2">4.4.4. Generation</a></li>
+<li><a href="#preview-2">4.4.5. Preview</a></li>
+</ul>
+</li>
+<li><a href="#sec:N4JS_Enum_File_Wizard">4.5. Enum Wizard</a>
+<ul class="sectlevel3">
+<li><a href="#field-properties-2">4.5.1. Field Properties</a></li>
+<li><a href="#generation-3">4.5.2. Generation</a></li>
+<li><a href="#preview-3">4.5.3. Preview</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#_execution-support">5. Execution Support</a>
+<ul class="sectlevel2">
+<li><a href="#sec:Non_UI_Execution">5.1. Non-UI Execution</a>
+<ul class="sectlevel3">
+<li><a href="#sec:Non_UI_Debugging">5.1.1. Non-UI Debugging</a></li>
+</ul>
+</li>
+<li><a href="#sec:UI_Execution">5.2. UI Execution</a></li>
+</ul>
+</li>
+<li><a href="#_test-support">6. Test Support</a>
+<ul class="sectlevel2">
+<li><a href="#sec:N4JS_Mangelhaft_support">6.1. N4JS Mangelhaft support</a>
+<ul class="sectlevel3">
+<li><a href="#sec:Asynchronous_Tests">6.1.1. Asynchronous Tests, Test Isolation and Timeouts</a></li>
+<li><a href="#sec:Supported_xUnit_API">6.1.2. Supported xUnit API</a>
+<ul class="sectlevel4">
+<li><a href="#sec:Test_Group">6.1.2.1. Test Group</a></li>
+<li><a href="#sec:Test_Method">6.1.2.2. Test Method</a></li>
+<li><a href="#sec:BeforeAll">6.1.2.3. BeforeAll Setup</a></li>
+<li><a href="#sec:Before_Setup">6.1.2.4. Before Setup</a></li>
+<li><a href="#sec:After_Teardown">6.1.2.5. After Teardown</a></li>
+<li><a href="#sec:AfterAll_Teardown">6.1.2.6. AfterAll Teardown</a></li>
+<li><a href="#sec:Test_Ignore">6.1.2.7. Test Ignore</a></li>
+<li><a href="#sec:Timeout">6.1.2.8. Timeout</a></li>
+<li><a href="#sec:Description">6.1.2.9. Description</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#sec:Test_Reporting">6.2. Test Reporting</a>
+<ul class="sectlevel3">
+<li><a href="#sec:Test_Messages">6.2.1. Test Messages</a>
+<ul class="sectlevel4">
+<li><a href="#_test-case-ids">6.2.1.1. Test Case IDs</a></li>
+<li><a href="#sec:Start_Session">6.2.1.2. Start Session</a></li>
+<li><a href="#sec:Ping_Session">6.2.1.3. Ping Session</a></li>
+<li><a href="#sec:End_Session">6.2.1.4. End Session</a></li>
+<li><a href="#sec:Start_Test">6.2.1.5. Start Test</a></li>
+<li><a href="#sec:End_Test">6.2.1.6. End Test</a></li>
+<li><a href="#sec:Ping_Test">6.2.1.7. Ping Test</a></li>
+<li><a href="#sec:Test_Catalog">6.2.1.8. Test Catalog</a></li>
+<li><a href="#sec:Test_Session_Example">6.2.1.9. Test Session Example</a></li>
+</ul>
+</li>
+<li><a href="#sec:Test_Runtime_Configuration">6.2.2. Test Runtime Configuration</a></li>
+<li><a href="#sec:Test_Plan">6.2.3. Test Plan</a></li>
+<li><a href="#sec:Test_Environment_Configuration">6.2.4. Test Environment Configuration</a></li>
+<li><a href="#sec:Test_Environment_Configuration_Example">6.2.5. Test Environment Configuration Example</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#_help-system">7. Help System</a>
+<ul class="sectlevel2">
+<li><a href="#sec:Built_In_Help">7.1. Built-In Help</a></li>
+<li><a href="#sec:Context_Sensitive_Help">7.2. Context Sensitive Help</a></li>
+<li><a href="#sec:Cheat_Sheets">7.3. Cheat Sheets</a></li>
+<li><a href="#sec:JSDoc">7.4. JSDoc</a></li>
+<li><a href="#sec:Hovering">7.5. Hovering</a>
+<ul class="sectlevel3">
+<li><a href="#sec:Show_Type_Information_of_Selection">7.5.1. Show Type Information of Selection</a></li>
+</ul>
+</li>
+<li><a href="#sec:Example_Projects_and_Files">7.6. Example Projects and Files</a></li>
+</ul>
+</li>
+<li><a href="#_bug-management">8. Bug Management</a>
+<ul class="sectlevel2">
+<li><a href="#sec:Built_In_Xpect_Support">8.1. Built-In Xpect Support</a>
+<ul class="sectlevel3">
+<li><a href="#sec:Report_View">8.1.1. Report View</a></li>
+<li><a href="#sec:Generate_Bug_Report">8.1.2. Generate Bug Report</a></li>
+<li><a href="#sec:Supported_Xpect_Tests">8.1.3. Supported Xpect Tests</a>
+<ul class="sectlevel4">
+<li><a href="#sec:XPECT_N4JS_Errors">8.1.3.1. Errors, Warnings, Infos, Issues</a></li>
+<li><a href="#sec:XPECT_N4JS_Noerrors">8.1.3.2. Noerrors</a></li>
+<li><a href="#sec:XPECT_N4JS_Output">8.1.3.3. Output, OutputRegex</a></li>
+<li><a href="#sec:XPECT_N4JS_Type_Of">8.1.3.4. Type Of</a></li>
+<li><a href="#sec:XPECT_Advanced_Methods">8.1.3.5. Advanced methods</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#_cli">9. CLI</a>
+<ul class="sectlevel2">
+<li><a href="#sec:Headless_Compiler">9.1. Headless Compiler</a></li>
+<li><a href="#sec:Headless_Dependencies">9.2. Headless Dependnecies</a></li>
+<li><a href="#sec:Headless_Execution">9.3. Headless Execution</a>
+<ul class="sectlevel3">
+<li><a href="#sec:Cleaning_Headlessly">9.3.1. Cleaning Headlessly</a></li>
+<li><a href="#sec:Running_Headlessly">9.3.2. Running Headlessly</a></li>
+<li><a href="#sec:Information_about_running_headlessly">9.3.3. Information about running headlessly</a></li>
+<li><a href="#sec:Testing_Headlessly">9.3.4. Testing Headlessly</a></li>
+<li><a href="#sec:Information_about_testing_headlessly">9.3.5. Information about testing headlessly</a></li>
+<li><a href="#_testresults">9.3.6. TestResults</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#sec:License">Appendix A: License</a></li>
+<li><a href="#sec:Acronyms">Appendix B: Acronyms</a></li>
+<li><a href="#_bibliography">Appendix C: Bibliography</a></li>
+</ul>
+</div>
+</div>
+<div id="content">
+<div id="preamble">
+<div class="sectionbody">
+<div class="paragraph center">
+<p><strong>Last Updated: 2019-08-07</strong></p>
+</div>
+<div class="paragraph center">
+<p><strong>Authors:</strong><br>
+Jens von Pilgrim, Jakub Siberski, Mark-Oliver Reiser, Torsten Krämer, Ákos Kitta, Sebastian Zarnekow, Lorenzo Bettini, Jörg Reichert, Kristian Duske, Marcus Mews, Minh Quang Tran, Luca Beurer-Kellner</p>
+</div>
+<div style="page-break-after: always;"></div>
+<h2 id="_abstract" class="discrete">Abstract</h2>
+<div class="paragraph">
+<p>This document contains the N4JS IDE Specification.</p>
+</div>
+<h2 id="_introduction" class="discrete">Introduction</h2>
+<div class="paragraph">
+<p>This document describes the features of the N4JS <a href="#AC">IDE</a>, that is the user interface and features available to users of the <a href="#AC">IDE</a>. The language N4JS is described in [<a href="#N4JSSpec">N4JSSpec</a>] and is not part of this document.</p>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="sec:Views"><a class="anchor" href="#sec:Views"></a><a class="link" href="#sec:Views">1. Views</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>This section briefly introduces all the views that belong to the application’s default perspective.</p>
+</div>
+<div class="sect2">
+<h3 id="_eclipse-standard-views"><a class="anchor" href="#_eclipse-standard-views"></a><a class="link" href="#_eclipse-standard-views">1.1. Eclipse Standard Views</a></h3>
+<div class="paragraph">
+<p>In the following we descibe views usually available in Eclipse based IDEs. Some of the views were slightly adjusted to match specific N4JS needs.</p>
+</div>
+<div class="sect3">
+<h4 id="sec:Project_Explorer_View"><a class="anchor" href="#sec:Project_Explorer_View"></a><a class="link" href="#sec:Project_Explorer_View">1.1.1. Project Explorer</a></h4>
+<div class="paragraph">
+<p>The Project Explorer view shows the resources from the underlying workspace in a hierarchical way. From this view one can open a resource for editing in the associated editor or select it to perform an operation on the resource. A popup contest menu is available from the Project Explorer for each resources if used right clicks any of them. A lot of convenient actions are available for from the popping context menu: file modifications (such as Copy, Cut, Paste and Delete) and import/export. Project Explorer support file system modifications by drag-and-dropping resources. One can link the Project Explorer with the editors, if one enables the view-editor-linking then the node in the tree representing a particular resource in the workspace will be automatically revealed and highlighted once one activates the corresponding editor. This works the other way around as well, when a node is selected in the tree and the corresponding resource is opened in an editor, then the editor will be activated.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Outline_View"><a class="anchor" href="#sec:Outline_View"></a><a class="link" href="#sec:Outline_View">1.1.2. Outline</a></h4>
+<div class="paragraph">
+<p>The Outline view is responsible for displaying the outline of a structured file that is currently opened in an editor. In case of opening an N4JS file the view depicts all the types defined in the file. The owned members, functions and methods of a particular type are represented in a tree structure. Furthermore in case of opening an N4JS file in the editor, one can link the Outline view with the editor which means whenever one selects a node from the outline view the corresponding item will be revealed and highlighted in the editor.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Problems_View"><a class="anchor" href="#sec:Problems_View"></a><a class="link" href="#sec:Problems_View">1.1.3. Problems</a></h4>
+<div class="paragraph">
+<p>This view is used to show all validation errors and warnings in a table that are generated for workbench resources such as N4JS files. For instance when one writes and/or saves an N4JS file that contains validation errors and/or warnings those issues will be automatically logged into the Problems view. One can reveal the actual problem in the N4JS by simply double-clicking on the problem in the view. In this case the corresponding N4JS file will be opened (if it was not already opened), activated and the relevant line will be revealed in the editor. By default the grouping in the Problems view is done by the severity of the issues. One can group the issues by issue type or just disable the grouping at all. The first column of the table is the actual description of the issue for a particular resource. The second column names the problematic resource itself. The third column shows the relative path of the problematic resource. The location, fifth, column describes the problematic line in the resource. And last but not least the sixth column is for naming the type of the problem. This is optional and might be missing for some cases. One can customise the content of the view from the view menu. One can limit the number of revealed items in the table or can modify the behaviour of the content provider.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Console_View"><a class="anchor" href="#sec:Console_View"></a><a class="link" href="#sec:Console_View">1.1.4. Console</a></h4>
+<div class="paragraph">
+<p>The Console view is used to reveal a text based output provided by a running process and also allows user to provide any input to the running process from the keyboard.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:History_View"><a class="anchor" href="#sec:History_View"></a><a class="link" href="#sec:History_View">1.1.5. History</a></h4>
+<div class="paragraph">
+<p>History view supports a way to track the changes of the workbench resources. This view also responsible for providing a convenient way to reveal historical revisions of a particular resource and it is even supports a mechanism to compare two different revisions of a resource. By default this view only provides local historical information but if a resource is under version control then one can retrieve revisions for that particular resource even it was made by remotely by another IDE user.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Error_Log_View"><a class="anchor" href="#sec:Error_Log_View"></a><a class="link" href="#sec:Error_Log_View">1.1.6. Error Log</a></h4>
+<div class="paragraph">
+<p>The Error Log view captures and logs all errors and warnings in a table generated by the application itself. Unlike Problems view the Error Log is responsible to collect and to reveal issues caused by a malfunctioned component or module of the IDE.</p>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_n4js-specific-views"><a class="anchor" href="#_n4js-specific-views"></a><a class="link" href="#_n4js-specific-views">1.2. N4JS Specific Views</a></h3>
+<div class="paragraph">
+<p>The following views are specific to N4JS. Some of these views are useful for developers of the N4JS language itself as they reveal internal details at runtime. Most of these views can be opened via <code>Windows/Show View/Other..</code>, see <code>N4JS</code> category.</p>
+</div>
+<div class="sect3">
+<h4 id="_test-results"><a class="anchor" href="#_test-results"></a><a class="link" href="#_test-results">1.2.1. Test Results</a></h4>
+<div class="paragraph">
+<p>The N4JS equivalent to the JUnit test view.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_source-graphs"><a class="anchor" href="#_source-graphs"></a><a class="link" href="#_source-graphs">1.2.2. Source Graphs</a></h4>
+<div class="paragraph">
+<p>Shows the AST of the current source code in the editor windows.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_api-compare"><a class="anchor" href="#_api-compare"></a><a class="link" href="#_api-compare">1.2.3. API Compare</a></h4>
+<div class="paragraph">
+<p>Shows compare results, i.e. the difference between an API definition project and its implementation.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_performance-graphs"><a class="anchor" href="#_performance-graphs"></a><a class="link" href="#_performance-graphs">1.2.4. Performance Graphs</a></h4>
+<div class="paragraph">
+<p>Shows some performance measurements of typical tasks such as builds.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_source-mapping"><a class="anchor" href="#_source-mapping"></a><a class="link" href="#_source-mapping">1.2.5. Source Mapping</a></h4>
+<div class="paragraph">
+<p>Shows source maps, i.e. the relation between N4JS source code and the generated plain JavaScript code.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_xpect-view"><a class="anchor" href="#_xpect-view"></a><a class="link" href="#_xpect-view">1.2.6. Xpect View</a></h4>
+<div class="paragraph">
+<p>Shows result of an Xpext run, may be used to submit bug reports.</p>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_navigation"><a class="anchor" href="#_navigation"></a><a class="link" href="#_navigation">2. Navigation</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>In this chapter we describe specific views and features to allow for easy navigation.</p>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:Outline_Navigation"><a class="anchor" href="#sec:Outline_Navigation"></a><a class="link" href="#sec:Outline_Navigation">2.1. Outline</a></h3>
+<div class="paragraph">
+<p>In general, a outline view and a quick outline are supported. Both outlines work similar, which is why both are specified together. The outline of an N4JS file is a tree which should show the following structure: <a id="sec:N4JS_Outline"></a></p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Top-level defined classes, interfaces, roles, enums, functions and exported variables. For all these different types, icons are to be used (similar to JDT). Beside the name, type variables should be shown as well, if defined.</p>
+</li>
+<li>
+<p>Members of classifiers are to be shown in the classifier branch. All members (fields, methods, field accessors) are to be shown, with appropriate icons indicating the type (field/member), static flag, access modifier, abstract flag. The icons should look similar to JDT.</p>
+</li>
+<li>
+<p>an import declaration should have a node in the outline view, if multiple elements are imported these should represented as child nodes of that import declaration node. If the import uses aliases the original name and the alias name should appear in the outline node text.</p>
+</li>
+<li>
+<p>for a non exported function declaration no outline node should be created</p>
+</li>
+<li>
+<p>for a non exported variable declaration no outline node should be created</p>
+</li>
+<li>
+<p>for a exported variable statement there should be a node in the outline, if this statement contains only one variable declaration the node represents this declaration. For multiple variable declarations in the statement the statement node just is a comma separated list of the variable names and for each variable there is child node</p>
+</li>
+<li>
+<p>for fields, functions, methods, getters and variables their declared (return) type should be shown (by adding : typeName after the element name). If the type is inferred then the type name should be presented in a different color</p>
+</li>
+<li>
+<p>for functions, methods and setters each formal parameter should be represented by its declared or inferred type (when inferred than with different color)</p>
+</li>
+<li>
+<p>constructors are represented by the method icon and a decorator in the top right corner</p>
+</li>
+<li>
+<p>enumeration literals are represented with the same decoration as static final fields</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>The top-level elements must be sortable either by order in the file (default) or alphabetically.</p>
+</div>
+<div class="sect3">
+<h4 id="_quick-outline"><a class="anchor" href="#_quick-outline"></a><a class="link" href="#_quick-outline">2.1.1. Quick Outline</a></h4>
+<div class="paragraph">
+<p>The quick outline supports two modes. The modes are iteratively selected by pressing <span class="keyseq"><kbd>CMD/CTRL</kbd>+<kbd>O</kbd></span>.</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">owned</dt>
+<dd>
+<p>This is the default mode, only members directly owned by the type are shown</p>
+</dd>
+<dt class="hdlist1">inherited</dt>
+<dd>
+<p>In this mode, the owned members are shown including inherited, consumed, or polyfilled members. The origin is also shown and a different color is used to highlight the special status of these members. For usability reasons (limiting the number of filters), inherited, consumed and polyfilled members are treated similarly.</p>
+</dd>
+</dl>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_normal-outline"><a class="anchor" href="#_normal-outline"></a><a class="link" href="#_normal-outline">2.1.2. Normal Outline</a></h4>
+<div class="paragraph">
+<p>In the normal outline view, toggles are used for the same purpose. Visualisations are similar to the quick outline view.</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">inherited</dt>
+<dd>
+<p>By default, only owned members of a type are shown. If the "inherited" toggle is active, inherited, consumed, or polyfilled members as well. For usability reasons (limiting the number of filters), inherited, consumed, and polyfilled members are treated similarly.</p>
+</dd>
+</dl>
+</div>
+<div class="paragraph">
+<p></p>
+</div>
+<div class="sidebarblock">
+<div class="content">
+<a href="https://github.com/eclipse/n4js/issues/99" class="gray" title="GitHub Issues"><span class="image"><img src="images/issue.svg" alt=""></span> #99</a>
+</div>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">sorting</dt>
+<dd>
+<p>By default, all elements are sorted in the order of their appearance in the source code. If alphabetic sorting is enabled, they are sorted alphabetically.</p>
+</dd>
+</dl>
+</div>
+<div class="admonitionblock todo">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-todo" title="Todo"></i>
+</td>
+<td class="content">
+<div class="paragraph">
+<p>Potential improvements:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>show decorator when a member overrides and member from a super class / super interface or role</p>
+</li>
+<li>
+<p>show object literals and their members in the outline view (just filter <code>eAllContents</code> of an element that already has a node in outline view for object literals)</p>
+</li>
+<li>
+<p>show function expression in the outline view (just filter <code>eAllContents</code> of an element that already has a node in outline view for function expressions)</p>
+</li>
+</ul>
+</div>
+</td>
+</tr>
+</table>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_navigation-commands"><a class="anchor" href="#_navigation-commands"></a><a class="link" href="#_navigation-commands">2.2. Navigation Commands</a></h3>
+<div class="sect3">
+<h4 id="sec:Navigate_to_Declaration"><a class="anchor" href="#sec:Navigate_to_Declaration"></a><a class="link" href="#sec:Navigate_to_Declaration">2.2.1. Navigate to Declaration</a></h4>
+<div class="paragraph">
+<p>It is possible to Command-click on almost every reference and jump to its declaration.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:find_by_references"><a class="anchor" href="#sec:find_by_references"></a><a class="link" href="#sec:find_by_references">2.2.2. Find by References</a></h4>
+<div class="paragraph">
+<p>For each referenceable element in an open N4JS file you can click your mouse and invoke the context menu to select <code>Find references</code>. Then in the Eclipse search view all found references are displayed as tree: each match is structured by resource path and coarse grained element in the resource (like a method). If there are multiple matches within a method only the first match is linked but in its display string the total match count is shown in brackets.</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>find by references shows the result as tree in the Eclipse search view with having elements that are members or have defined type displayed as nodes</p>
+</li>
+<li>
+<p>every found reference is displayed under its nearest parent that is a member or has a defined type</p>
+</li>
+<li>
+<p>if there a multiple found references in a node only the first one is displayed (and linked) + the number of all total matches is shown as part of the display string (like in JDT)</p>
+</li>
+</ol>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Open_Type_Declaration"><a class="anchor" href="#sec:Open_Type_Declaration"></a><a class="link" href="#sec:Open_Type_Declaration">2.2.3. Open Type Declaration</a></h4>
+<div class="paragraph">
+<p>One can quickly browse the workbench for available types. The declaration of the types can be opened in editor from this dialog. The N4JS type search dialog can be raised with the <kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>T</kbd> key binding (<kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>T</kbd> on Windows and Linux systems).</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Enter <strong>exact type name</strong>, prefix name or a camel case pattern to run a query against the types. The following rules and patterns are supported.</p>
+<div class="ulist">
+<ul>
+<li>
+<p><strong>Wildcards</strong>: <code>?</code>  for any character and <code>*</code> for any string.</p>
+</li>
+<li>
+<p><strong>Camel case</strong>: <code>DM</code>  will return with all types that contains <code>D</code> and <code>M</code> with the given order such as <code>DataMap</code> and <code>DataMapEntry</code> but not <code>ImmutableDataMap</code>.</p>
+<div class="paragraph">
+<p><code>AcBuGr</code> will return with all types that contain <code>Ac</code>, <code>Bu</code> and <code>Gr</code> with the given order such as <code>ActionButtonGroup</code>.</p>
+</div>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p><strong>Highlighting</strong>: The matching types names are highlighted according to the matching parts.</p>
+</li>
+<li>
+<p><strong>Decorator</strong> for duplicate type names: The internally used fully qualified name of the type will be appended to the type name automatically, so one can easily distinguish between types even there are type name collision.</p>
+</li>
+<li>
+<p><strong>Opening types in editor</strong>: Type declarations can be opened in the editor in the following ways: after entering the type name prefix or pattern to the filter text one can navigate among the filtered items with the up and/or down arrow keys. Simply hitting return on the keyboard or clicking on the ’OK’ button the currently selected declaration of the selected type will be opened in the editor. For opening multiple type declarations one can use the <kbd>Shift</kbd>  modifier to select more than one element. Single type can be opened with double clicking on it in the dialog.</p>
+</li>
+<li>
+<p><strong>History</strong>: Once a type is being opened then it will be available among the recently opened type in the type search dialog. These items will show up in the upper part of the list in the dialog.</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+<div class="sect2 language-bash">
+<h3 id="sec:Working_Sets"><a class="anchor" href="#sec:Working_Sets"></a><a class="link" href="#sec:Working_Sets">2.3. Working Sets</a></h3>
+<div class="paragraph">
+<p>Working sets are used to logically group resources, projects in the Project Explorer (navigator) and in the UI in general. Although a couple of projects can be easily handled and shown without any sophisticated working set support in the navigator, larger code sources consisting of multiple projects could cause some trouble when one has to maintain them. Indeed one could use multiple workspaces and could switch between them or can simply manually open-close relevant projects, but this gets cumbersome too.</p>
+</div>
+<div class="paragraph">
+<p>This section describes the general design of the N4JS specific working set support and also introduces a couple of use cases while enumerating the constraints.</p>
+</div>
+<div class="sect3">
+<h4 id="sec:Working_Set_Managers"><a class="anchor" href="#sec:Working_Set_Managers"></a><a class="link" href="#sec:Working_Set_Managers">2.3.1. Working Set Managers</a></h4>
+<div class="paragraph">
+<p>Just like the JDT (<code>org.eclipse.jdt.internal.ui.workingsets.WorkingSetModel</code>) based working set support, the N4JS IDE based approach is also aware of the <code>org.eclipse.ui.IWorkingSet</code> and the <code>org.eclipse.ui.IWorkingSetManager</code> APIs but besides simply using them it comes with its own implementation and adapts it to the default Eclipse based one, furthermore it also comes with an Eclipse extension point based mechanism to support various working set managers at the same time to provide even better user experience and a more convenient way of working set management.</p>
+</div>
+<div class="paragraph">
+<p>A working set manager can be contributed to the IDE via the <code>org.eclipse.n4js.ui.workingSetManager</code> extension point, then the implementation class must implement the <code>org.eclipse.n4js.ui.workingsets.WorkingSetManager</code> interface but it is highly recommended to rather extend the <code>org.eclipse.n4js.ui.workingsets.WorkingSetManagerImpl</code> class. Guice based dependency injection should also be considered when implementing the custom working set manager. It means that each custom working set manager implementation must have a public <em>no-args</em> constructor. This <em>no-args</em> constructor will be invoked when creating the instances via <code>IConfigurationElement#createExecutableExtension(String)</code> method. Then the members, if any will be injected by the working set manager broker. Below <code>plugin.xml</code> snippet describes how to contribute a custom working set manager to the IDE.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xml" data-lang="xml">   &lt;extension
+         point="org.eclipse.n4js.ui.workingSetManager"&gt;
+      &lt;manager
+            class="some.package.name.MyExecutableExtensionFactory:some.package.name.MyWorkingSetManager"&gt;
+      &lt;/manager&gt;
+   &lt;/extension&gt;</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>By default the N4JS IDE comes with five different built-in working set managers. These are the followings:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Manual Association Working Set Manager,</p>
+</li>
+<li>
+<p>Project Name Filter Working Set Manager,</p>
+</li>
+<li>
+<p>Git Repository Working Set Manager,</p>
+</li>
+<li>
+<p>Project Location Working Set Manager and</p>
+</li>
+<li>
+<p>N4JS Project Type Working Set Manager.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>The benefits and the details of each built-in working set managers will be discussed in later sections but first we have to distinguish between three conceptually different working set manager approaches.</p>
+</div>
+<div class="paragraph">
+<p>First off, IDE supports fully static working set managers. Fully static working set managers might manage any arbitrary number of working sets, and each working set might be associated with any number of Eclipse projects. That means, user might create, edit and remove working sets and manually associate projects with individual working sets. One project might belong to multiple working sets. There is a dedicated working set, <em>Other Projects</em>, that cannot be renamed and/or deleted. When no user defined working sets are available this dedicated working set will be still available. IDE comes with one single fully static working set manager: <em>Manual Association Working Set Manager</em>.</p>
+</div>
+<div class="paragraph">
+<p>The second kind of working set manager is the semi-dynamic one. That means, user can create, modify and delete working sets, but the associations between the projects and the working sets are automatic. This means, the user might define a working set - project association rule, and the projects will be automatically associated with the working sets. Just like in the above kind, one project might belong to multiple working sets and here as well, there is a dedicated working set manager, that cannot be modified: <em>Other Projects</em>. IDE comes with one semi-dynamic working set manager. That is the <em>Project Name Filter Working Set Manager</em>. User might define a project name filter rule with a regular expression, and each project which name matches a pattern will be associated with the working set. If a project does not comply to any working set manager rule, then it will belong to the <em>Other Projects</em> working set.</p>
+</div>
+<div class="paragraph">
+<p>The third kind of working set manager is the fully-dynamic working set manager. Both the working sets and the project associations are done by some implementation specific rules. Such as Git repository provider based, or project location based approaches. These working set managers have the dedicated <em>Other Projects</em> working set that is used as a fallback working set. For instance, if the <em>Git Repository Working Set Manager</em> is the active one, all projects that are shared with Git will belong to the corresponding working set manager but if a project is not yet a shared project, then it will belong to the dedicated fallback working set. As always that working set manager cannot be deleted and/or modified.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Working_Set_Constraints"><a class="anchor" href="#sec:Working_Set_Constraints"></a><a class="link" href="#sec:Working_Set_Constraints">2.3.2. Working Set Constraints</a></h4>
+<div class="paragraph">
+<p>This section enumerates a set of constraints that have to considered by both end users and implementors:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Working set manager identifier must be unique.</p>
+</li>
+<li>
+<p>The identifier of the working set manager must be unique per container working set managers.</p>
+</li>
+<li>
+<p>Each working set must have a working set with <em>Other Projects</em> unique ID and name.</p>
+</li>
+<li>
+<p>Working sets with <em>Other Projects</em> unique ID must not be editable nor deletable.</p>
+</li>
+<li>
+<p>At least one working set should be visible (not hidden) per working set managers.</p>
+</li>
+<li>
+<p>Working set managers are activated when the <em>Working Sets</em> are configured as <em>Top Level Elements</em> in the <em>Project Explorer</em>.</p>
+</li>
+<li>
+<p>Working set order can be specified and customized by the user if it is not specified yet, then a case sensitive ordering based on the working set names should be applied.</p>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Manual_Association_Working_Set_Manager_UI_Features"><a class="anchor" href="#sec:Manual_Association_Working_Set_Manager_UI_Features"></a><a class="link" href="#sec:Manual_Association_Working_Set_Manager_UI_Features">2.3.3. Manual Association Working Set Manager - UI Features</a></h4>
+<div class="paragraph">
+<p>This section describes the working set manager by introducing the UI capabilities as well.</p>
+</div>
+<div class="paragraph">
+<p>This working set manager is a fully static working set manager and activated and used as the default one when the working set manager support is turned on in the IDE. With this working set manager one can create a new working set by simply defining a unique name for the working set and associating any number of workspace project to the working set. Furthermore existing working sets can be modified and deleted but the <em>Other Projects</em> working set. The working set support can be turned on in the <em>Project Explorer</em> view. Via the view menu one has to select <em>Top Level Elements</em> <em>&gt;</em> <em>Working Sets</em> menu item.</p>
+</div>
+<div class="imageblock center" style="text-align: center">
+<div class="content">
+<img src="chapters/04_navigation/fig/activate_working_set_managers.png" alt="Activate_Working_Set_Managers" width="50%">
+</div>
+<div class="title">Figure 1. Activate Working Set Managers</div>
+</div>
+<div class="paragraph">
+<p>After the working set manager mode activation, a new toolbar contribution item become visible and user can select among the available working set managers.</p>
+</div>
+<div class="imageblock center" style="text-align: center">
+<div class="content">
+<img src="chapters/04_navigation/fig/select_working_set_manager_01.png" alt="Select_Working_Set_Manager" width="50%">
+</div>
+<div class="title">Figure 2. Select Working Set Manager</div>
+</div>
+<div class="paragraph">
+<p>As the below picture depicts the available working set managers are listed and the currently active manager is marked with a check. In our case that is the <em>Manual Association Working Set Manager</em>.</p>
+</div>
+<div class="imageblock center" style="text-align: center">
+<div class="content">
+<img src="chapters/04_navigation/fig/select_working_set_manager_02.png" alt="Activate_Working_Set_Manager" width="25%">
+</div>
+<div class="title">Figure 3. Activate Working Set Manager</div>
+</div>
+<div class="paragraph">
+<p>Once the the <em>Configure Manual Association&#8230;&#8203;</em> menu item is selected, the working set manager configuration dialog pops up. By clicking on the <em>New&#8230;&#8203;</em> button in the configuration dialog, a new working set wizard will be invoked and the manual working set - project association can be configured.</p>
+</div>
+<div class="imageblock center" style="text-align: center">
+<div class="content">
+<img src="chapters/04_navigation/fig/configure_working_sets_01.png" alt="Configure_Working_Sets" width="25%">
+</div>
+<div class="title">Figure 4. Configure Working Sets</div>
+</div>
+<div class="paragraph">
+<p>In the wizard after specifying the desired unique name of the working set an arbitrary number of workspace projects can be associated with the working set. It is important to note, that a project can be associated with more than one working sets. If a project is not associated with any working sets then it will be automatically linked to the fallback <em>Other Projects</em> working set.</p>
+</div>
+<div class="imageblock center" style="text-align: center">
+<div class="content">
+<img src="chapters/04_navigation/fig/working_set_project_association.png" alt="Configure_Working_Set_Project_Association" width="50%">
+</div>
+<div class="title">Figure 5. Working Set - Projects Association</div>
+</div>
+<div class="paragraph">
+<p>Once all the changes made are confirmed and the configuration dialog is closed via the <em>OK</em> button, the <em>Project Explorer</em> will be refreshed and will reflect the working set changes.</p>
+</div>
+<div class="imageblock center" style="text-align: center">
+<div class="content">
+<img src="chapters/04_navigation/fig/working_sets_in_navigator.png" alt="Custom_Working_Sets_In_Project_Explorer" width="25%">
+</div>
+<div class="title">Figure 6. Custom Working Sets In Project Explorer</div>
+</div>
+<div class="paragraph">
+<p>The order of the working sets can be configured and customized in the working set manager configuration dialog, or just simply reordering it from the navigator itself by drag and dropping the available working set managers.</p>
+</div>
+<div class="imageblock center" style="text-align: center">
+<div class="content">
+<img src="chapters/04_navigation/fig/working_set_reorder.png" alt="Re_Ordering_Working_Sets_In_Project_Explorer" width="25%">
+</div>
+<div class="title">Figure 7. Re-ordering Working Sets In Project Explorer</div>
+</div>
+<div class="paragraph">
+<p>Besides changing the order of the working sets, working sets can be hidden from the navigator. Just like the ordering, this can be changed from the working set configuration dialog, or by simply selecting working sets in the navigator and hiding them via <em>Hide Selected Working Set</em> menu item. Important to note, at least one working set should be visible in the navigator, so if all the working sets are selected in the navigator, then the menu item will be disabled. Same behavior in the working set customization dialog, if all items are unchecked, then the <em>OK</em> button is disabled in the dialog.</p>
+</div>
+<div class="imageblock center" style="text-align: center">
+<div class="content">
+<img src="chapters/04_navigation/fig/working_set_hide.png" alt="Hide_Working_Sets_In_Project_Explorer" width="25%">
+</div>
+<div class="title">Figure 8. Hide Working Sets In Project Explorer</div>
+</div>
+<div class="paragraph">
+<p>Once at least one working set is hidden from the UI, then a new toolbar contribution become visible in the <em>Project Explorer</em>. This UI contribution provides a quick, convenient way to show a specific or all hidden working sets in the navigator. It is worth to note, if a project is automatically associated with the <em>Other Projects</em> working set (because it does not belong to any working sets due to the lack of manual association) it will be not shown in the navigator if the <em>Other Projects</em> working set is hidden. Once all working sets are visible, indeed the <em>Show Hidden Working Sets</em> toolbar contribution become invisible.</p>
+</div>
+<div class="imageblock center" style="text-align: center">
+<div class="content">
+<img src="chapters/04_navigation/fig/working_set_show.png" alt="Show_Hidden_Working_Sets_In_Project_Explorer" width="25%">
+</div>
+<div class="title">Figure 9. Show Hidden Working Sets In Project Explorer</div>
+</div>
+<div class="paragraph">
+<p>Besides the above described generic working set UI support, projects can be associated with working sets by simply drag and dropping them from one working set into another. Note, this is only supported for the <em>Manual Association Working Set Manager</em>.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Project_Name_Filter_Working_Set_Manager"><a class="anchor" href="#sec:Project_Name_Filter_Working_Set_Manager"></a><a class="link" href="#sec:Project_Name_Filter_Working_Set_Manager">2.3.4. Project Name Filter Working Set Manager</a></h4>
+<div class="paragraph">
+<p>As mentioned earlier, this working set is a semi-dynamic working set. The working sets can be created, edited and deleted by the user by simply specifying project name filter pattern as valid regular expressions but the project association itself is fully automatic. If the name of a project does not match with any project name filter rule, then the project will be associated with the <em>Other Projects</em> working set. Although reordering the working sets from the navigator by simple drag and dropping them is supported, project association is disabled.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Git_Repository_Working_Set_Manager"><a class="anchor" href="#sec:Git_Repository_Working_Set_Manager"></a><a class="link" href="#sec:Git_Repository_Working_Set_Manager">2.3.5. Git Repository Working Set Manager</a></h4>
+<div class="paragraph">
+<p>This working set is a fully-dynamic working set. Projects will be associated by the Git providers. It means, if a project is imported from a pre-configured local Git repository, then the project will be associated with the working set linked with the Git repository. The subset of the available working sets is become automatically updated once the Git repository preferences changed by the user. These preferences can be changed on the <em>Git</em> perspective in the <em>Git Repositories</em> view by simple adding or hiding/removing a repository from the view.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Project_Location_Working_Set_Manager"><a class="anchor" href="#sec:Project_Location_Working_Set_Manager"></a><a class="link" href="#sec:Project_Location_Working_Set_Manager">2.3.6. Project Location Working Set Manager</a></h4>
+<div class="paragraph">
+<p>This fully-dynamic working set manager calculates the subset of available working sets based on the parent folder of the projects. The benefit of this working set manager is to support the convention recommended by the maven/Git folder structuring. The following constraints are applied when associating the projects with the available working sets:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>If a project is located in the root of the Eclipse workspace, then it will be associated with <em>Other Projects</em> working set.</p>
+</li>
+<li>
+<p>If a project is nested somewhere in the Eclipse workspace, then it will be associated with a working set that has the same name as the parent folder of the project. Let assume the Eclipse workspace root points to <code>/eclipse/root</code> and there is a project <code>P1</code> nested in the workspace root at <code>/eclipse/root/path/to/nested/location/P1</code>, then the associated working set will be <code>location</code>.</p>
+</li>
+<li>
+<p>If a project is not contained in the workspace, but has a Git provider that is configured in IDE, and the project root is the local Git repository root, then the associated working set name will be the name of the Git repository. For example, if we have Eclipse workspace root pointing to <code>/eclipse/root</code> location and a <code>P2</code> project located <code>/some/path/to/git/P2</code> but this location is the location of a registered Git repository, then the name of the associated working set will be neither <code>Other Projects</code> not <code>git</code> but <code>P2</code> since that is known Git local repository root.</p>
+</li>
+<li>
+<p>If project <code>P3</code> is not contained in the Eclipse workspace but contained in a known local Git repository just like above, but the project root is not the local Git repository root, then the name of the parent folder will be considered as the name of the associated working set. This rule is a hybrid alternative of the second and the third constraints, hence for instance if the project is under <code>/some/path/to/git/repositoryName/plugins/P3</code> and <code>repositoryName</code> is local git repository, then the name of the associated working set will be <code>plugins</code> and not <code>repositoryName</code>.</p>
+</li>
+<li>
+<p>Else the associated working set will be the <em>Other Projects</em> fallback working set.</p>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:N4JS_Project_Type_Working_Set_Manager"><a class="anchor" href="#sec:N4JS_Project_Type_Working_Set_Manager"></a><a class="link" href="#sec:N4JS_Project_Type_Working_Set_Manager">2.3.7. N4JS Project Type Working Set Manager</a></h4>
+<div class="paragraph">
+<p>This is working set manager is a N4JS specific fully-dynamic working set manager. The working sets will be calculated based on the instances defined by the <code>org.eclipse.n4js.n4mf.ProjectType</code> type. Each accessible N4JS project will be associated to a working set based on the project type. A workspace project will be associated with the <em>Other Projects</em> fallback working set if any of the followings are true to the project:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>The project is not accessible. (It does not exist or is not opened.)</p>
+</li>
+<li>
+<p>The project does not configured with <em>Xtext</em> nature.</p>
+</li>
+<li>
+<p>The project does not have an <em>Xtext</em> builder command ID.</p>
+</li>
+<li>
+<p>The project does not have a valid N4 manifest file.</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_assistance"><a class="anchor" href="#_assistance"></a><a class="link" href="#_assistance">3. Assistance</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>In this chapter we describe all kind of tools assisting the user when writing code, i.e. content assist, quickfixes, quick assists, etc.</p>
+</div>
+<div class="admonitionblock warning">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-warning" title=""></i>
+</td>
+<td class="content">
+Not all features are yet implemented!
+</td>
+</tr>
+</table>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:Content_Assist"><a class="anchor" href="#sec:Content_Assist"></a><a class="link" href="#sec:Content_Assist">3.1. Content Assist</a></h3>
+<div class="paragraph">
+<p>Content assist may change the document at various places at once. In those cases, it is important to prevent flickering in the editor. The FQNImporter provides a blue print how to adjust line numbers properly and scroll the viewport of the current editor to minimize flickering in the UI.</p>
+</div>
+<div class="paragraph">
+<p>Completions not listed here as they are provided by template proposals:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Classifier declaration template proposal</p>
+</li>
+<li>
+<p>Function declaration template proposal</p>
+</li>
+<li>
+<p>Getter/Setter pair template proposal</p>
+</li>
+</ol>
+</div>
+<div class="sect3">
+<h4 id="sec:Complete_Keywords"><a class="anchor" href="#sec:Complete_Keywords"></a><a class="link" href="#sec:Complete_Keywords">3.1.1. Complete Keywords</a></h4>
+<div class="paragraph">
+<p>Complete keyword which are syntactically correct at a given location. Do not suggest completions which would lead to wrong code.</p>
+</div>
+<div class="paragraph">
+<p>Keywords that contain only a single character are not proposed since they would pollute the proposal window and don’t offer added value.</p>
+</div>
+<div class="paragraph">
+<p>Special attention has to be given to operators. Since they are modelled in the grammar and not as cross references, their validaty is purely syntactically. That is, there is no generic facility in Xtext, that allows to filter unapplicable operators as there is for cross references.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Complete_Annotations"><a class="anchor" href="#sec:Complete_Annotations"></a><a class="link" href="#sec:Complete_Annotations">3.1.2. Complete Annotations</a></h4>
+<div class="paragraph">
+<p>Annotations can be proposed depending on the following elements or the context.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Complete_Identifier_Reference"><a class="anchor" href="#sec:Complete_Identifier_Reference"></a><a class="link" href="#sec:Complete_Identifier_Reference">3.1.3. Complete Identifier Reference</a></h4>
+<div class="paragraph">
+<p>References to identifiers can be automatically completed. This is even true if the declaration is not imported yet, as the import may be automatically added as well.</p>
+</div>
+<div class="openblock">
+<div class="title">Complete identifier references</div>
+<div class="content">
+<div class="paragraph">
+<p>The IDE supports auto-completion of an identifier referencing to a declaration.</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Complete type references.</p>
+</li>
+<li>
+<p>Complete function references.</p>
+</li>
+<li>
+<p>Complete variable references.</p>
+</li>
+<li>
+<p>Complete parameter references.</p>
+</li>
+<li>
+<p>If necessary, imports are added automatically to complete reference <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>r</mi></math> to declaration <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>D</mi></math>.</p>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Precondition</dt>
+<dd>
+<p>-</p>
+</dd>
+<dt class="hdlist1">Postcondition</dt>
+<dd>
+<div class="paragraph">
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mi>b</mi><mi>i</mi><mi>n</mi><mi>d</mi><mfenced close=")" open="("><mi>r</mi><mi>D</mi></mfenced></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mo>⇔</mo></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mi>r</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><mi>D</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mi>D</mi><mo>∈</mo><mi>r</mi><mo>.</mo><mi>m</mi><mi>o</mi><mi>d</mi><mi>u</mi><mi>l</mi><mi>e</mi></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mo>⊕</mo></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mo>∃</mo><mstyle mathvariant="monospace"><mtext>NamedImportSpecifier</mtext></mstyle><mi>N</mi><mi>I</mi><mi>S</mi><mi>:</mi></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mi>W</mi><mi>I</mi><mi>S</mi><mo>.</mo><mi>i</mi><mi>m</mi><mi>p</mi><mi>o</mi><mi>r</mi><mi>t</mi><mi>D</mi><mi>e</mi><mi>c</mi><mi>l</mi><mo>.</mo><mi>i</mi><mi>m</mi><mi>p</mi><mi>o</mi><mi>r</mi><mi>t</mi><mi>e</mi><mi>d</mi><mi>M</mi><mi>o</mi><mi>d</mi><mi>u</mi><mi>l</mi><mi>e</mi><mo>=</mo><mi>D</mi><mo>.</mo><mi>m</mi><mi>o</mi><mi>d</mi><mi>u</mi><mi>l</mi><mi>e</mi></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mo>∨</mo><mo>∃</mo><mstyle mathvariant="monospace"><mtext>WildcardImportSpecifier</mtext></mstyle><mi>W</mi><mi>I</mi><mi>S</mi><mi>:</mi></math></p>
+</div>
+</dd>
+<dt class="hdlist1">Description</dt>
+<dd>
+<p>There might be multiple declarations <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>D</mi></math> in project (or in dependent projects) with <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>D</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><mi>r</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi></math>. If the declaration <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>D</mi></math> is not local, then a named import may be created by the content assist:</p>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p>If the declaration <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>D</mi></math> is local, no import is created</p>
+</li>
+<li>
+<p>If an import enabling access to the declaration already exists, no other import is created.</p>
+</li>
+<li>
+<p>If an alias already exists, the alias name is used, even if the prefix was different when the content assist was activated.</p>
+</li>
+<li>
+<p>If the import would conflict with an existing member, an alias is proposed along with the import. Linked editing helps to choose a proper alias.</p>
+</li>
+<li>
+<p>All imports from a single module are done within a single import declaration. The exception to this rule are wildcard imports that provide a simple name which is currently unused. In that case, a new import may be necessary to disambiguate the wildcard.</p>
+</li>
+</ol>
+</div>
+</dd>
+</dl>
+</div>
+</li>
+<li>
+<p>If the identifier reference refers to a function (or method), an opening and a closing parenthesis are appended and
+the cursor is positioned between these two parentheses.</p>
+</li>
+</ol>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Complete_Member_Overrides"><a class="anchor" href="#sec:Complete_Member_Overrides"></a><a class="link" href="#sec:Complete_Member_Overrides">3.1.4. Complete Member Overrides</a></h4>
+<div class="openblock">
+<div class="title">Complete Member Overrides Inside a classifier</div>
+<div class="content">
+<div class="paragraph">
+<p>A prefix of an inherited member can be used to autocomplete that to a complete declaration.
+This is in particular true for methods.</p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Constructor_Completion"><a class="anchor" href="#sec:Constructor_Completion"></a><a class="link" href="#sec:Constructor_Completion">3.1.5. Constructor Completion</a></h4>
+<div class="openblock">
+<div class="title">Constructor Completion</div>
+<div class="content">
+<div class="paragraph">
+<p>Constructor Completion Based on the declared fields and super constructor, constructor methods can be completed.</p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Complete_Function_Expression"><a class="anchor" href="#sec:Complete_Function_Expression"></a><a class="link" href="#sec:Complete_Function_Expression">3.1.6. Complete Function Expression with Known Type</a></h4>
+<div class="openblock">
+<div class="title">Complete Function Expression</div>
+<div class="content">
+<div class="paragraph">
+<p>If a function expression is used as an argument or assigned to a typed variable, the signature of the function can be derived from the type. This can be used to complete a function expression.</p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Complete_Variable_and_Parameter_Names"><a class="anchor" href="#sec:Complete_Variable_and_Parameter_Names"></a><a class="link" href="#sec:Complete_Variable_and_Parameter_Names">3.1.7. Complete Variable and Parameter Names</a></h4>
+<div class="openblock">
+<div class="title">Type based completion of Variable and Parameter Names</div>
+<div class="content">
+<div class="paragraph">
+<p>Variable and parameter names can be completed based on the type. Camel case detection is used to propose different variations.</p>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Completion of variables references see <a href="#sec:Complete_Identifier_Reference">Complete Identifier Reference</a>.</p>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:Quick_Fixes"><a class="anchor" href="#sec:Quick_Fixes"></a><a class="link" href="#sec:Quick_Fixes">3.2. Quick Fixes</a></h3>
+<div class="paragraph">
+<p>Quick fixes try to solve issues, i.e. errors or warnings, automatically. This is done by rewriting code, either at the location of the issue or at referenced locations.</p>
+</div>
+<div class="paragraph">
+<p>In all cases, a quick fix must only be suggested if the following preconditions are fulfilled:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>All locations at which modifications have to be done must be writeable.</p>
+</li>
+<li>
+<p>If bindings are involved, e.g., names are to be changed, all previous bindings must remain similar. This might be more complicated as it seems!</p>
+</li>
+</ol>
+</div>
+<div class="sect3">
+<h4 id="sec:N4JS_Issue_Properties"><a class="anchor" href="#sec:N4JS_Issue_Properties"></a><a class="link" href="#sec:N4JS_Issue_Properties">3.2.1. N4JS Issue User data</a></h4>
+<div class="paragraph">
+<p>As some quick fixes need more information to decide upfront which strategy to use, some issues provide additional data. These properties are defined in the file <code>IssueUserDataKeys.java</code> in the <code>org.eclipse.n4js.validation</code> package. They can for example be accessed by passing the according key to the <code>getUserData</code> method of an <code>N4JSIssue</code> instance. They are also available as array based Xtext Issue user data.<br></p>
+</div>
+<div class="paragraph">
+<p>All available user data keys are described for each Issue code in <a href="#sec:N4JS_Issue_Fixes">N4JS Issue Fixes</a>.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:N4JS_Issue_Fixes"><a class="anchor" href="#sec:N4JS_Issue_Fixes"></a><a class="link" href="#sec:N4JS_Issue_Fixes">3.2.2. N4JS Issue Fixes</a></h4>
+<div class="paragraph">
+<p>The principle idea is to provide a quick fix for every issue, if it is possible to automatically solve it.</p>
+</div>
+<div class="sect4">
+<h5 id="sec:Linking_Issues"><a class="anchor" href="#sec:Linking_Issues"></a><a class="link" href="#sec:Linking_Issues">3.2.2.1. Linking Issues</a></h5>
+<div class="paragraph">
+<p>Linking issues are special in that they are created by the standard Xtext linker and use all the same built-in issue code <code>Diagnostic.LINKING_DIAGNOSTIC</code>. Therefore, we cannot refer to these issues using one of our custom N4JS issue codes.</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Diagnostic.LINKING_DIAGNOSTIC</dt>
+<dd>
+<p><code>Couldn’t resolve reference to <em>n</em></code></p>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Add missing import declaration for unresolved name <em>n</em>.</p>
+</li>
+</ol>
+</div>
+</dd>
+</dl>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Precondition
+</td>
+<td class="hdlist2">
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p>An exported identifiable element <em>e</em> with name <em>n</em> exists in another module <em>m</em>.</p>
+</li>
+<li>
+<p><em>e</em> is visible from the given location.</p>
+</li>
+</ol>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Label
+</td>
+<td class="hdlist2">
+<p><code>Import <em>n</em> - <em>m</em></code></p>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Postcondition</dt>
+<dd>
+<p>An import declaration was added such that name <em>n</em> is now resolvable at the given location and bound to <em>e</em>.</p>
+</dd>
+<dt class="hdlist1">Description</dt>
+<dd>
+<p>Some important notes:</p>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p><code>A</code> separate quick fix is proposed for each candidate element instead of having a single generic quick fix for adding imports and showing a dialog later (for example, create two quick fixes “Import class <code>X</code> from module M1" and “Import interface <code>X</code> from module M2" instead of a single quick fix “Add import for name X").<br>
+This is unusual for quick fixes, because it means significant work has to be done upfront when creating the quick fix / modification proposals, which raises performance concerns. However,</p>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p>the JDT handles this the same way and</p>
+</li>
+<li>
+<p>this brings the implementation closer to content assist allowing more reuse, therefore this decision was taken.</p>
+</li>
+</ol>
+</div>
+</li>
+<li>
+<p>For consistency, matching of lower/upper/camel case is to be handled as in code completion during content assist. The same applies to display string formatting, esp. name formatting and coloring of element <em>e</em> and module <em>m</em>.</p>
+</li>
+<li>
+<p>Note that here we can make more assumptions than during import as part of content assist. For example, we know that the element is not imported yet (otherwise there would not be an error) and there won’t be a need for an alias and linked editing.</p>
+</li>
+</ol>
+</div>
+</dd>
+</dl>
+</div>
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Import_Issues"><a class="anchor" href="#sec:Import_Issues"></a><a class="link" href="#sec:Import_Issues">3.2.2.2. Import Issues</a></h5>
+
+</div>
+<div class="sect4">
+<h5 id="sec:Visibility_Issues"><a class="anchor" href="#sec:Visibility_Issues"></a><a class="link" href="#sec:Visibility_Issues">3.2.2.3. Visibility Issues</a></h5>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">VIS_ILLEGAL_MEMBER_ACCESS</dt>
+<dd>
+<p><code>The <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>m</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi></math> <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>m</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi></math> is not visible.</code></p>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Change access modifier to protected/public or remove <code>@Internal</code> annotation.</p>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Precondition</dt>
+<dd>
+<p>The file containing the declaration of <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>m</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi></math> is modifiable</p>
+</dd>
+<dt class="hdlist1">Postcondition</dt>
+<dd>
+<p>The access modifier has been changed so that <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>m</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi></math> is visible at issue location.</p>
+</dd>
+<dt class="hdlist1">User Data</dt>
+<dd>
+<div class="ulist">
+<ul>
+<li>
+<p><strong>ACCESS_SUGGESTION</strong> The most restrictive modifier making the member visible.</p>
+</li>
+<li>
+<p><strong>DECLARATION_OBJECT_URI</strong> The EObject URI of the member declaration</p>
+</li>
+</ul>
+</div>
+</dd>
+</dl>
+</div>
+</li>
+</ol>
+</div>
+</dd>
+</dl>
+</div>
+<div class="paragraph">
+<p>This table shows the access modifier changes to perform to fix the visibility issue while maintaining the strongest access restrictions possible.</p>
+</div>
+<table class="tableblock frame-all grid-all spread">
+<colgroup>
+<col style="width: 14.2857%;">
+<col style="width: 14.2857%;">
+<col style="width: 14.2857%;">
+<col style="width: 14.2857%;">
+<col style="width: 14.2857%;">
+<col style="width: 14.2857%;">
+<col style="width: 14.2858%;">
+</colgroup>
+<tbody>
+<tr>
+<td class="tableblock halign-center valign-top" rowspan="2"><p class="tableblock"><code>Access Modifier</code></p></td>
+<td class="tableblock halign-center valign-top" colspan="6"><p class="tableblock"><code>Accessible From</code></p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Inside Module</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Inside Project</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Vendor Subtypes</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Vendor Projects</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Other Subtypes</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Everywhere</code></p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>private</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>-</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>project</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>protected@Internal</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>public@Internal</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>protected</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>public</code></p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>project</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>-</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>-</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>protected@Internal</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>public@Internal</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>protected</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>public</code></p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>protected@Internal</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>-</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>-</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>-</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>public@Internal</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>protected</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>public</code></p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>protected</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>-</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>-</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>-</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>public@Internal</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>-</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>public</code></p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>public@Internal</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>-</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>-</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>-</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>-</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>public</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>public</code></p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>public</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>-</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>-</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>-</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>-</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>-</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>-</code></p></td>
+</tr>
+</tbody>
+</table>
+<div class="paragraph">
+<p>Member access modifier changes for quick fixes</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">VIS_ILLEGAL_FUN_ACCESS</dt>
+<dd>
+<p><code>The function <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>f</mi></math> is not visible.</code></p>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Change access modifier to protected/public or remove <code>@Internal</code> annotation.</p>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Precondition</dt>
+<dd>
+<p>–</p>
+</dd>
+<dt class="hdlist1">Postcondition</dt>
+<dd>
+<p>The access modifier has been changed so that <em>f</em> is visible at issue location.</p>
+</dd>
+<dt class="hdlist1">User Data</dt>
+<dd>
+<div class="ulist">
+<ul>
+<li>
+<p><strong>ACCESS_SUGGESTION</strong> The most restrictive modifier making the function visible.</p>
+</li>
+<li>
+<p><strong>DECLARATION_OBJECT_URI</strong> The EObject URI of the function declaration</p>
+</li>
+</ul>
+</div>
+</dd>
+</dl>
+</div>
+</li>
+</ol>
+</div>
+</dd>
+<dt class="hdlist1">VIS_ILLEGAL_TYPE_ACCESS</dt>
+<dd>
+<p><code>The type <em>T</em> is not visible.</code></p>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Change access modifier to protected/public or remove <code>@Internal</code> annotation.</p>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Precondition</dt>
+<dd>
+<p>–</p>
+</dd>
+<dt class="hdlist1">Postcondition</dt>
+<dd>
+<p>The access modifier has been changed so that <em>T</em> is visible at issue location.</p>
+</dd>
+<dt class="hdlist1">User Data</dt>
+<dd>
+<p>see VIS_ILLEGAL_FUN_ACCESS</p>
+</dd>
+</dl>
+</div>
+</li>
+</ol>
+</div>
+</dd>
+<dt class="hdlist1">VIS_ILLEGAL_VARIABLE_ACCESS</dt>
+<dd>
+<p><code>The variable <em>v</em> is not visible.</code></p>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Change access modifier to protected/public or remove <code>@Internal</code> annotation.</p>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Precondition</dt>
+<dd>
+<p>Module containing <em>v</em> is writeable.</p>
+</dd>
+<dt class="hdlist1">Postcondition</dt>
+<dd>
+<p>The access modifier has been changed so that <em>v</em> is visible at issue location.</p>
+</dd>
+<dt class="hdlist1">User Data</dt>
+<dd>
+<p>see VIS_ILLEGAL_FUN_ACCESS</p>
+</dd>
+</dl>
+</div>
+</li>
+</ol>
+</div>
+</dd>
+</dl>
+</div>
+<div class="paragraph">
+<p>For type, variable and function visibility issues the following changes have to be made to solve the visibility issue:</p>
+</div>
+<table id="tab:typeAccessControl" class="tableblock frame-all grid-all spread">
+<caption class="title">Table 1. Type,function and variable access modifier changes for quick fixes</caption>
+<colgroup>
+<col style="width: 20%;">
+<col style="width: 20%;">
+<col style="width: 20%;">
+<col style="width: 20%;">
+<col style="width: 20%;">
+</colgroup>
+<tbody>
+<tr>
+<th class="tableblock halign-center valign-top" rowspan="2"><p class="tableblock">Access Modifier</p></th>
+<th class="tableblock halign-center valign-top" colspan="4"><p class="tableblock">Accessible From</p></th>
+</tr>
+<tr>
+<th class="tableblock halign-center valign-top"><p class="tableblock">Module</p></th>
+<th class="tableblock halign-center valign-top"><p class="tableblock">Project</p></th>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Vendor</p></th>
+<th class="tableblock halign-left valign-top"><p class="tableblock">World</p></th>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>private</code></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>-</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>export project</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>export public@Internal</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>export public</code></p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>project</code></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>-</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>export project</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>export public@Internal</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>export public</code></p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>export project</code></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>-</code></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>-</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>export public@Internal</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>export public</code></p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>export public@Internal</code></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>-</code></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>-</code></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>-</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>export public</code></p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>export public</code></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>-</code></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>-</code></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>-</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>export public</code></p></td>
+</tr>
+</tbody>
+</table>
+</div>
+<div class="sect4">
+<h5 id="sec:Classifier_Issues"><a class="anchor" href="#sec:Classifier_Issues"></a><a class="link" href="#sec:Classifier_Issues">3.2.2.4. Classifier Issues</a></h5>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">CLF_EXTEND_FINAL</dt>
+<dd>
+<p><code>Cannot extend final class <em>C</em>.</code></p>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Remove <code>@Final</code> annotation in class <em>C</em></p>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Precondition</dt>
+<dd>
+<p>–</p>
+</dd>
+<dt class="hdlist1">Postcondition</dt>
+<dd>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mo>¬</mo><mi>C</mi><mo>.</mo><mi>f</mi><mi>i</mi><mi>n</mi><mi>a</mi><mi>l</mi></math></p>
+</dd>
+</dl>
+</div>
+</li>
+</ol>
+</div>
+</dd>
+<dt class="hdlist1">CLF_OBSERVABLE_MISSING</dt>
+<dd>
+<p><code>Class <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>0</mn></msub></math> extends observable class <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>1</mn></msub></math> and must therefore be annotated with @Observable.</code></p>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Add <code>@Obervable</code> annotation in class <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>0</mn></msub></math></p>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Precondition</dt>
+<dd>
+<p>–</p>
+</dd>
+<dt class="hdlist1">Postcondition</dt>
+<dd>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>0.</mn></msub><mi>o</mi><mi>b</mi><mi>s</mi><mi>e</mi><mi>r</mi><mi>v</mi><mi>a</mi><mi>b</mi><mi>l</mi><mi>e</mi></math></p>
+</dd>
+</dl>
+</div>
+</li>
+</ol>
+</div>
+</dd>
+<dt class="hdlist1">CLF_OVERRIDE_ANNOTATION</dt>
+<dd>
+<p><code>The <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>0</mn></msub></math> overriding <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>1</mn></msub></math> must be annotated with @Override.</code></p>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Add <code>@Override</code> annotation to <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>0</mn></msub></math></p>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Precondition</dt>
+<dd>
+<p>–</p>
+</dd>
+<dt class="hdlist1">Label</dt>
+<dd>
+<p><code>Add @Override</code></p>
+</dd>
+<dt class="hdlist1">Postcondition</dt>
+<dd>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>0.</mn></msub><mi>o</mi><mi>v</mi><mi>e</mi><mi>r</mi><mi>r</mi><mi>i</mi><mi>d</mi><mi>e</mi></math></p>
+</dd>
+</dl>
+</div>
+</li>
+</ol>
+</div>
+</dd>
+<dt class="hdlist1">CLF_OVERRIDE_FINAL</dt>
+<dd>
+<p><code>The <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>0</mn></msub></math> cannot override final <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>1</mn></msub></math>.</code></p>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Remove <code>@Final</code> annotation in <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>1</mn></msub></math></p>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Precondition</dt>
+<dd>
+<p>–</p>
+</dd>
+<dt class="hdlist1">Postcondition</dt>
+<dd>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mo>¬</mo><msub><mi>e</mi><mn>1.</mn></msub><mi>f</mi><mi>i</mi><mi>n</mi><mi>a</mi><mi>l</mi></math></p>
+</dd>
+</dl>
+</div>
+</li>
+</ol>
+</div>
+</dd>
+<dt class="hdlist1">CLF_OVERRIDE_VISIBILITY</dt>
+<dd>
+<p><code>The <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>0</mn></msub></math> cannot reduce the visibility of <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>1</mn></msub></math>.</code></p>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Set access modifier of <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>0</mn></msub></math> to access modifier of <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>1</mn></msub></math></p>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Precondition</dt>
+<dd>
+<p>–</p>
+</dd>
+<dt class="hdlist1">Postcondition</dt>
+<dd>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>0.</mn></msub><mi>a</mi><mi>c</mi><mi>c</mi><mo>=</mo><mo>=</mo><msub><mi>e</mi><mn>1.</mn></msub><mi>a</mi><mi>c</mi><mi>c</mi></math></p>
+</dd>
+</dl>
+</div>
+</li>
+</ol>
+</div>
+</dd>
+<dt class="hdlist1">CLF_OVERRIDE_NON_EXISTENT</dt>
+<dd>
+<p><code>The <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>0</mn></msub></math> <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>1</mn></msub></math> must override or implement a <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>0</mn></msub></math> from a super class, consumed role or implemented interface.</code></p>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Remove <code>@Override</code> annotation in <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>1</mn></msub></math></p>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Precondition</dt>
+<dd>
+<p>–</p>
+</dd>
+<dt class="hdlist1">Label</dt>
+<dd>
+<p><code>Remove @Override</code></p>
+</dd>
+<dt class="hdlist1">Postcondition</dt>
+<dd>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mo>¬</mo><msub><mi>e</mi><mn>1.</mn></msub><mi>o</mi><mi>v</mi><mi>e</mi><mi>r</mi><mi>r</mi><mi>i</mi><mi>d</mi><mi>e</mi></math></p>
+</dd>
+</dl>
+</div>
+</li>
+</ol>
+</div>
+</dd>
+<dt class="hdlist1">CLF_REDEFINED_TYPE_NOT_SAME_TYPE</dt>
+<dd>
+<p><code>Type of <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>0</mn></msub></math> must equal type of <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>1</mn></msub></math> <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>2</mn></msub></math>.</code></p>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Set declared type of <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>0</mn></msub></math> to declared type of <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>2</mn></msub></math></p>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Precondition</dt>
+<dd>
+<p>–</p>
+</dd>
+<dt class="hdlist1">Postcondition</dt>
+<dd>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>τ</mi><msub><mi>e</mi><mn>0</mn></msub><mo>=</mo><msub><mi>e</mi><mn>2</mn></msub></math></p>
+</dd>
+</dl>
+</div>
+</li>
+</ol>
+</div>
+</dd>
+<dt class="hdlist1">CLF_REDEFINED_MEMBER_TYPE_INVALID</dt>
+<dd>
+<p><code>Type of <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>0</mn></msub></math> does not conform to <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>2</mn></msub></math> <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>1</mn></msub></math>: <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>3</mn></msub></math>.</code></p>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Set declared type of <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>0</mn></msub></math> to declared type of <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>1</mn></msub></math></p>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Precondition</dt>
+<dd>
+<p>–</p>
+</dd>
+<dt class="hdlist1">Postcondition</dt>
+<dd>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>τ</mi><msub><mi>e</mi><mn>0</mn></msub><mo>=</mo><msub><mi>e</mi><mn>1</mn></msub></math></p>
+</dd>
+</dl>
+</div>
+</li>
+</ol>
+</div>
+</dd>
+<dt class="hdlist1">CLF_REDEFINED_METHOD_TYPE_CONFLICT</dt>
+<dd>
+<p><code>Signature of <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>0</mn></msub></math> does not conform to <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>1</mn></msub></math> <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>2</mn></msub></math>: <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>3</mn></msub></math>.</code></p>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Set declared type of <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>0</mn></msub></math> to declared type of <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>2</mn></msub></math></p>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Precondition</dt>
+<dd>
+<p>–</p>
+</dd>
+<dt class="hdlist1">Postcondition</dt>
+<dd>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>τ</mi><msub><mi>e</mi><mn>0</mn></msub><mo>=</mo><msub><mi>e</mi><mn>2</mn></msub></math></p>
+</dd>
+</dl>
+</div>
+</li>
+</ol>
+</div>
+</dd>
+<dt class="hdlist1">CLF_MISSING_IMPLEMENTATION</dt>
+<dd>
+<p><code>Class <em>C</em> must either be defined abstract or implement <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>m</mi></math>.</code></p>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Declare <em>C</em> as abstract</p>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Precondition</dt>
+<dd>
+<p>–</p>
+</dd>
+<dt class="hdlist1">Postcondition</dt>
+<dd>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>C</mi><mo>.</mo><mi>a</mi><mi>b</mi><mi>s</mi><mi>t</mi><mi>r</mi><mi>a</mi><mi>c</mi><mi>t</mi></math></p>
+</dd>
+</dl>
+</div>
+</li>
+</ol>
+</div>
+</dd>
+<dt class="hdlist1">CLF_ABSTRACT_BODY</dt>
+<dd>
+<p><code>Abstract methods do not specify a body.</code> for method <em>M</em></p>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Remove abstract annotation from method.</p>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Precondition</dt>
+<dd>
+<p>–</p>
+</dd>
+<dt class="hdlist1">Postcondition</dt>
+<dd>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mo>¬</mo><mi>M</mi><mo>.</mo><mi>a</mi><mi>b</mi><mi>s</mi><mi>t</mi><mi>r</mi><mi>a</mi><mi>c</mi><mi>t</mi></math></p>
+</dd>
+</dl>
+</div>
+</li>
+</ol>
+</div>
+</dd>
+<dt class="hdlist1">CLF_ABSTRACT_MISSING</dt>
+<dd>
+<p><code>The abstract <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>0</mn></msub></math> <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>1</mn></msub></math> in class <em>C</em> can only be defined in an abstract class.</code></p>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Declare <em>C</em> as abstract</p>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Precondition</dt>
+<dd>
+<p>–</p>
+</dd>
+<dt class="hdlist1">Postcondition</dt>
+<dd>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>C</mi><mo>.</mo><mi>a</mi><mi>b</mi><mi>s</mi><mi>t</mi><mi>r</mi><mi>a</mi><mi>c</mi><mi>t</mi></math></p>
+</dd>
+<dt class="hdlist1">Multi appliable</dt>
+<dd>
+<p>false</p>
+</dd>
+</dl>
+</div>
+</li>
+</ol>
+</div>
+</dd>
+<dt class="hdlist1">CLF_MISSING_BODY</dt>
+<dd>
+<p><code>The <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>0</mn></msub></math> <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>1</mn></msub></math> has to have either a body or must be defined abstract.</code></p>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Declare <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>1</mn></msub></math> as abstract</p>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Precondition</dt>
+<dd>
+<p>–</p>
+</dd>
+<dt class="hdlist1">Postcondition</dt>
+<dd>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>1.</mn></msub><mi>a</mi><mi>b</mi><mi>s</mi><mi>t</mi><mi>r</mi><mi>a</mi><mi>c</mi><mi>t</mi></math></p>
+</dd>
+</dl>
+</div>
+</li>
+</ol>
+</div>
+</dd>
+<dt class="hdlist1">CLF_EXT_EXTERNAL_N4JSD</dt>
+<dd>
+<p><code><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>0</mn></msub></math> declared as external have to be placed in a file with file extension ’n4jsd’.</code></p>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Remove external annotation</p>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Precondition</dt>
+<dd>
+<p>–</p>
+</dd>
+<dt class="hdlist1">Postcondition</dt>
+<dd>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mo>¬</mo><msub><mi>e</mi><mn>0.</mn></msub><mi>e</mi><mi>x</mi><mi>t</mi><mi>e</mi><mi>r</mi><mi>n</mi><mi>a</mi><mi>l</mi></math></p>
+</dd>
+</dl>
+</div>
+</li>
+<li>
+<p>Change module file extension to n4jsd</p>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Precondition</dt>
+<dd>
+<p>–</p>
+</dd>
+<dt class="hdlist1">Postcondition</dt>
+<dd>
+<p>module file extension is n4jsd</p>
+</dd>
+</dl>
+</div>
+</li>
+</ol>
+</div>
+</dd>
+<dt class="hdlist1">CLF_NOT_EXPORTED_NOT_PRIVATE</dt>
+<dd>
+<p><code>A <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>0</mn></msub></math> with visibility <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>1</mn></msub></math> must be marked as exported.</code></p>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Export <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>0</mn></msub></math></p>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Precondition</dt>
+<dd>
+<p>–</p>
+</dd>
+<dt class="hdlist1">Postcondition</dt>
+<dd>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>0</mn></msub></math> is exported</p>
+</dd>
+</dl>
+</div>
+</li>
+</ol>
+</div>
+</dd>
+</dl>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Function_Issues"><a class="anchor" href="#sec:Function_Issues"></a><a class="link" href="#sec:Function_Issues">3.2.2.5. Function Issues</a></h5>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+FUN_BLOCK
+</td>
+<td class="hdlist2">
+<p><code>Functions declarations should not be placed in blocks. Use a function expression or move the statement to the top of the outer function.</code> with function <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>F</mi></math></p>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Change function declaration to function expression</p>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Precondition</dt>
+<dd>
+<p>–</p>
+</dd>
+<dt class="hdlist1">Postcondition</dt>
+</dl>
+</div>
+</li>
+</ol>
+</div>
+</td>
+</tr>
+</table>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mtable><mtr><mtd/><mtd><mo>∃</mo><mstyle mathvariant="monospace"><mtext>Variable</mtext></mstyle><mi> </mi><mi>v</mi><mo>∈</mo><mi>F</mi><mo>.</mo><mi>v</mi><mi>e</mi><mi>e</mi><mi>:</mi></mtd></mtr><mtr><mtd/><mtd><mspace width="3.0em"/><mi>v</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><mi>F</mi></mtd></mtr><mtr><mtd/><mtd><mspace width="3.0em"/><mo>∧</mo><mi>v</mi><mo>.</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mo>.</mo><mi>μ</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>FunctionExpression</mtext></mstyle></mtd></mtr><mtr><mtd/><mtd><mspace width="3.0em"/><mo>∧</mo><mi>v</mi><mo>.</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><mi>F</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>,</mo><mi>v</mi><mo>.</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mo>.</mo><mi>b</mi><mi>o</mi><mi>d</mi><mi>y</mi><mo>=</mo><mi>F</mi><mo>.</mo><mi>b</mi><mi>o</mi><mi>d</mi><mi>y</mi></mtd></mtr></mtable></math>
+</div>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Description</dt>
+<dd>
+<p>Change function declaration to function expression assigned to variable of the function name</p>
+</dd>
+</dl>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Syntax_Issues"><a class="anchor" href="#sec:Syntax_Issues"></a><a class="link" href="#sec:Syntax_Issues">3.2.2.6. Syntax Issues</a></h5>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">AST_STR_FUN_NOT_NESTED</dt>
+<dd>
+<p><code>Functions must only be declared on script level or as part of other expressions</code></p>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Change function declaration to function expression assigned to variable of the function name</p>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Precondition</dt>
+<dd>
+<p>–</p>
+</dd>
+<dt class="hdlist1">Postcondition</dt>
+</dl>
+</div>
+</li>
+</ol>
+</div>
+</dd>
+</dl>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mtable><mtr><mtd/><mtd><mo>∃</mo><mstyle mathvariant="monospace"><mtext>Variable</mtext></mstyle><mi> </mi><mi>v</mi><mo>∈</mo><mi>F</mi><mo>.</mo><mi>v</mi><mi>e</mi><mi>e</mi><mi>:</mi></mtd></mtr><mtr><mtd/><mtd><mspace width="3.0em"/><mi>v</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><mi>F</mi></mtd></mtr><mtr><mtd/><mtd><mspace width="3.0em"/><mo>∧</mo><mi>v</mi><mo>.</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mo>.</mo><mi>μ</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>FunctionExpression</mtext></mstyle></mtd></mtr><mtr><mtd/><mtd><mspace width="3.0em"/><mo>∧</mo><mi>v</mi><mo>.</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><mi>F</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>,</mo><mi>v</mi><mo>.</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mo>.</mo><mi>b</mi><mi>o</mi><mi>d</mi><mi>y</mi><mo>=</mo><mi>F</mi><mo>.</mo><mi>b</mi><mi>o</mi><mi>d</mi><mi>y</mi></mtd></mtr></mtable></math>
+</div>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">SYN_MODIFIER_BAD_ORDER</dt>
+<dd>
+<p><code>Modifiers should appear in this order: O </code></p>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Rearrange access modifiers</p>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Precondition</dt>
+<dd>
+<p>–</p>
+</dd>
+<dt class="hdlist1">Postcondition</dt>
+<dd>
+<p>Modifiers are in order O</p>
+</dd>
+<dt class="hdlist1">Description</dt>
+<dd>
+<p>Reorder the access modifiers to match the N4JS compliant order.</p>
+</dd>
+</dl>
+</div>
+</li>
+</ol>
+</div>
+</dd>
+</dl>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Conversion_Issues"><a class="anchor" href="#sec:Conversion_Issues"></a><a class="link" href="#sec:Conversion_Issues">3.2.2.7. Conversion Issues</a></h5>
+
+</div>
+<div class="sect4">
+<h5 id="sec:Type_Issues"><a class="anchor" href="#sec:Type_Issues"></a><a class="link" href="#sec:Type_Issues">3.2.2.8. Type Issues</a></h5>
+
+</div>
+<div class="sect4">
+<h5 id="sec:Expression_Issues"><a class="anchor" href="#sec:Expression_Issues"></a><a class="link" href="#sec:Expression_Issues">3.2.2.9. Expression Issues</a></h5>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">EXP_WRONG_NUMBER_OF_TYPEARGS</dt>
+<dd>
+<p><code>Incorrect number of type arguments for <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi></math> <em>C</em>: expected <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>t</mi><mi>p</mi><mi>c</mi><mi>o</mi><mi>u</mi><mi>n</mi><mi>t</mi></math>, got <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>t</mi><mi>a</mi><mi>c</mi><mi>o</mi><mi>u</mi><mi>n</mi><mi>t</mi></math>.</code></p>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Remove superfluous arguments</p>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Precondition</dt>
+<dd>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>t</mi><mi>a</mi><mi>c</mi><mi>o</mi><mi>u</mi><mi>n</mi><mi>t</mi><mo>&gt;</mo><mi>t</mi><mi>p</mi><mi>c</mi><mi>o</mi><mi>u</mi><mi>n</mi><mi>t</mi></math></p>
+</dd>
+<dt class="hdlist1">Postcondition</dt>
+<dd>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>t</mi><mi>a</mi><mi>c</mi><mi>o</mi><mi>u</mi><mi>n</mi><mi>t</mi><mo>=</mo><mi>t</mi><mi>p</mi><mi>c</mi><mi>o</mi><mi>u</mi><mi>n</mi><mi>t</mi></math></p>
+</dd>
+<dt class="hdlist1">Description</dt>
+</dl>
+</div>
+</li>
+</ol>
+</div>
+</dd>
+<dt class="hdlist1">EXP_NUM_OF_ARGS_TOO_MANY</dt>
+<dd>
+<p><code>Incorrect number of arguments: expected <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>f</mi><mi>p</mi><mi>c</mi><mi>o</mi><mi>u</mi><mi>n</mi><mi>t</mi></math>, got <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>a</mi><mi>r</mi><mi>g</mi><mi>c</mi><mi>o</mi><mi>u</mi><mi>n</mi><mi>t</mi></math>.</code></p>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Remove superfluous arguments</p>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Precondition</dt>
+<dd>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>a</mi><mi>r</mi><mi>g</mi><mi>c</mi><mi>o</mi><mi>u</mi><mi>n</mi><mi>t</mi><mo>&gt;</mo><mi>f</mi><mi>p</mi><mi>c</mi><mi>o</mi><mi>u</mi><mi>n</mi><mi>t</mi></math></p>
+</dd>
+<dt class="hdlist1">Postcondition</dt>
+<dd>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>a</mi><mi>r</mi><mi>g</mi><mi>c</mi><mi>o</mi><mi>u</mi><mi>n</mi><mi>t</mi><mo>=</mo><mi>f</mi><mi>p</mi><mi>c</mi><mi>o</mi><mi>u</mi><mi>n</mi><mi>t</mi></math></p>
+</dd>
+<dt class="hdlist1">Description</dt>
+</dl>
+</div>
+</li>
+</ol>
+</div>
+</dd>
+<dt class="hdlist1">EXP_CAST_UNNECESSARY</dt>
+<dd>
+<p><code>Unnecessary cast from <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>S</mi></math> to <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi></math></code></p>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Remove cast</p>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Precondition</dt>
+<dd>
+<p>–</p>
+</dd>
+<dt class="hdlist1">Postcondition</dt>
+<dd>
+<p>cast removed</p>
+</dd>
+<dt class="hdlist1">Description</dt>
+</dl>
+</div>
+</li>
+</ol>
+</div>
+</dd>
+</dl>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Super_Keyword_Issues"><a class="anchor" href="#sec:Super_Keyword_Issues"></a><a class="link" href="#sec:Super_Keyword_Issues">3.2.2.10. Super Keyword Issues</a></h5>
+
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="sec:Quick_Assist"><a class="anchor" href="#sec:Quick_Assist"></a><a class="link" href="#sec:Quick_Assist">3.3. Quick Assist</a></h3>
+
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:Cleanup_Operations"><a class="anchor" href="#sec:Cleanup_Operations"></a><a class="link" href="#sec:Cleanup_Operations">3.4. Cleanup Operations</a></h3>
+<div class="sect3">
+<h4 id="sec:Formatting"><a class="anchor" href="#sec:Formatting"></a><a class="link" href="#sec:Formatting">3.4.1. Formatting</a></h4>
+
+</div>
+<div class="sect3">
+<h4 id="sec:Organize_Imports"><a class="anchor" href="#sec:Organize_Imports"></a><a class="link" href="#sec:Organize_Imports">3.4.2. Organize Imports</a></h4>
+<div class="paragraph">
+<p>Import statements can be cleaned up or automatically inserted by invoking <code>Organize Imports</code>. <code>Organize Imports</code> is available in the context menu <code>Source / Organise imports</code> , in menu <code>Source &gt; Organize imports</code> or by hitting <kbd>Cmd</kbd> + <kbd>Option</kbd> +<kbd>O</kbd> (Win/Linux - <kbd>Ctrl</kbd> +<kbd>Alt</kbd> +<kbd>O</kbd>).</p>
+</div>
+<div class="paragraph">
+<p>For a valid file without errors, this will result in the following actions:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Unused explicit imports will be removed.</p>
+</li>
+<li>
+<p>Unused wildcard imports will be removed.</p>
+</li>
+<li>
+<p>In each import statement the imported elements will be lexicographically sorted depending on the imported element’s name.</p>
+</li>
+<li>
+<p>All import statements will be lexicographically sorted depending on the module specifier as major and the element name as minor key.</p>
+</li>
+<li>
+<p>All import statements will be moved to the top of the file.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>For a file with error-conditions of unresolved references, this will result in the automatic actions:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>All ambiguous wildcard imports will be presented in one dialog, requesting the user to resolve the ambiguity.</p>
+</li>
+<li>
+<p>Each uniquely resolvable <code>unresolved Classifier</code> will be added by a named import. The search scope is limited to the dependencies declared in the current project-setup.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>No action will be taken, if &#8230;&#8203;</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>a classifier with name <code>X</code> is already imported by name from a module <code>A</code> and a unknown member of this classifier is marked. Even though the import of <code>X</code> from a different module <code>B</code> could remove this error, the semantic consequences could not be evaluated. The state will be left as-is.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>If more then one option leads to a possible resolution the situation should be clarified using quick-fixes, e.g. if &#8230;&#8203;</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>more then one module provides an element, which would render a formerly unresolved reference to be valid.</p>
+</li>
+<li>
+<p>for a wildcard-imported element <code>X</code> there are unknown members and a different module provides an element <code>X</code> containing the missing members. In such a case a named import of <code>X</code> would be proposed, optionally using an alias.</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_wizards"><a class="anchor" href="#_wizards"></a><a class="link" href="#_wizards">4. Wizards</a></h2>
+<div class="sectionbody">
+<div class="admonitionblock warning">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-warning" title=""></i>
+</td>
+<td class="content">
+Some descriptions may be outdated.
+</td>
+</tr>
+</table>
+</div>
+<div class="admonitionblock warning">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-warning" title=""></i>
+</td>
+<td class="content">
+All requirement sections are not linked to real issues. They were left here as an example and to complete the issues.
+</td>
+</tr>
+</table>
+</div>
+<div class="sect2">
+<h3 id="sec:N4JS_Project_Wizard"><a class="anchor" href="#sec:N4JS_Project_Wizard"></a><a class="link" href="#sec:N4JS_Project_Wizard">4.1. N4JS Project Wizard</a></h3>
+<div class="paragraph">
+<p>Wizard creates a new N4JS project.</p>
+</div>
+<div class="paragraph">
+<p>The following information is to be specified by the user:</p>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Project Name
+</td>
+<td class="hdlist2">
+<p>string, name of project</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Default Location
+</td>
+<td class="hdlist2">
+<p>boolean, true by default</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Location
+</td>
+<td class="hdlist2">
+<p>string, computed default location, if user set location then default location flag must be false</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Project Type
+</td>
+<td class="hdlist2">
+<p>enumeration, the type of the new project</p>
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>The following files are to be created:</p>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Project Folder
+</td>
+<td class="hdlist2">
+<p>with name of project at given location</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Manifest
+</td>
+<td class="hdlist2">
+<p>with default project structure and name</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Source Folder
+</td>
+<td class="hdlist2">
+<p>default source folder (src)</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Output Folder
+</td>
+<td class="hdlist2">
+<p>default source folder (src-gen)</p>
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect2">
+<h3 id="sec:Empty_N4JS_File"><a class="anchor" href="#sec:Empty_N4JS_File"></a><a class="link" href="#sec:Empty_N4JS_File">4.2. Empty N4JS File</a></h3>
+<div class="paragraph">
+<p>The following information is to be specified by the user:</p>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Package Name
+</td>
+<td class="hdlist2">
+<p>dot separated name of the package, empty by default (or set to the package/folder selected in the navigator)</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Module Name
+</td>
+<td class="hdlist2">
+<p>string, name of the module – must be a valid module name without extension</p>
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>The following files are to be created:</p>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Package Folder(s)
+</td>
+<td class="hdlist2">
+<p>if folders representing package structure do not exist, they are to be created</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Module File
+</td>
+<td class="hdlist2">
+<p>empty file with name of module and extension <code>n4js</code>  in the appropriate package folder</p>
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect2">
+<h3 id="sec:Empty_JS_File"><a class="anchor" href="#sec:Empty_JS_File"></a><a class="link" href="#sec:Empty_JS_File">4.3. Empty JS File</a></h3>
+<div class="paragraph">
+<p>Similar to <a href="#sec:Empty_N4JS_File">Empty N4JS File</a> but with the file extension <code>js</code>.</p>
+</div>
+<div class="sect3">
+<h4 id="sec:N4JS_Class_File_Wizard"><a class="anchor" href="#sec:N4JS_Class_File_Wizard"></a><a class="link" href="#sec:N4JS_Class_File_Wizard">4.3.1. N4JS Class Wizard</a></h4>
+<div class="paragraph">
+<p>It is recommended to define a single classifier in a file, the name of the classifier should have the same name as the file. Based on that assumption, file wizards are provided for N4JS classes, interfaces and enumerations.</p>
+</div>
+<div class="imageblock center">
+<div class="content">
+<img src="chapters/06_wizards/fig/newclasswizard.png" alt="newclasswizard">
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="field-properties"><a class="anchor" href="#field-properties"></a><a class="link" href="#field-properties">4.3.2. Field Properties</a></h4>
+<div class="paragraph">
+<p><a id="Class_File_Wizard-Project_Field"></a> The New N4JS Class wizard offers following fields:</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Project</dt>
+<dd>
+<p>Specifies the containing project.</p>
+</dd>
+</dl>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-GH-1413"></a><strong>Req. GH-1413:</strong> <a href="#Req-GH-1413">Project constraints</a> (ver. 1)</p>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Constraints
+</td>
+<td class="hdlist2">
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>It is a path of a valid project in the current workspace</p>
+</li>
+<li>
+<p>This field must not be empty</p>
+</li>
+</ol>
+</div>
+</td>
+</tr>
+</table>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-GH-1413"></a><strong>Req. GH-1413:</strong> <a href="#Req-GH-1413">Project browse button</a> (ver. 1)</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Browse Button</dt>
+<dd>
+<p>Browsing only allows the selection of projects in the current workspace. Project creation is not possible.</p>
+</dd>
+</dl>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-GH-1413"></a><strong>Req. GH-1413:</strong> <a href="#Req-GH-1413">Project initial selection inference</a> (ver. 1)</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Initial selection</dt>
+<dd>
+<p>The project should be derived from the initial selection.</p>
+</dd>
+</dl>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-GH-1413"></a><strong>Req. GH-1413:</strong> <a href="#Req-GH-1413">Project content assist</a> (ver. 1)</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Content Assist</dt>
+<dd>
+<p>Workspace projects</p>
+</dd>
+</dl>
+</div>
+</div>
+</div>
+<div id="Class_File_Wizard-Source_Folder_Field" class="dlist">
+<dl>
+<dt class="hdlist1">Source folder</dt>
+<dd>
+<p>Specifies the containing source folder.</p>
+</dd>
+</dl>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-GH-1413"></a><strong>Req. GH-1413:</strong> <a href="#Req-GH-1413">Source folder constraints</a> (ver. 1)</p>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Constraints
+</td>
+<td class="hdlist2">
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>The folder is listed as source folder in the project manifest</p>
+</li>
+<li>
+<p>This field must not be empty.</p>
+</li>
+<li>
+<p>The name is a valid path that means each segment of the path matches the following expression:</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-ebnf" data-lang="ebnf">[a-zA-z_](([\\.][a-zA-z_0-9\\-])|[a-zA-z_0-9\\-])*</code></pre>
+</div>
+</div>
+</li>
+</ol>
+</div>
+</td>
+</tr>
+</table>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-GH-1413"></a><strong>Req. GH-1413:</strong> <a href="#Req-GH-1413">Source folder browse button</a> (ver. 1)</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Browse Button</dt>
+<dd>
+<p>Browsing only allows the selection of source folders in the selected project. The dialog should provide a list of all source folders of the selected project. This includes nested source folders. A list element is a relative path of a source folder in the project.</p>
+</dd>
+</dl>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-GH-1413"></a><strong>Req. GH-1413:</strong> <a href="#Req-GH-1413">Source folder initial selection inference</a> (ver. 1)</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Initial selection</dt>
+<dd>
+<p>The source folder field should be derived from the initial selection</p>
+</dd>
+</dl>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-GH-1413"></a><strong>Req. GH-1413:</strong> <a href="#Req-GH-1413">Source folder content assist</a> (ver. 1)</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Content Assist</dt>
+<dd>
+<p>source folders defined by the project manifest</p>
+</dd>
+</dl>
+</div>
+</div>
+</div>
+<div id="Class_File_Wizard-Module_Specifier_Field" class="dlist">
+<dl>
+<dt class="hdlist1">Module specifier</dt>
+<dd>
+<p>Specifies the module specifier. May only specify a module container (a folder) but could also include module name. May also be an already existing module. Does not include the file extension.</p>
+</dd>
+</dl>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-GH-1413"></a><strong>Req. GH-1413:</strong> <a href="#Req-GH-1413">Module specifier constraints</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>The specifier is a valid module specifier that is
+- Segments are separated by the path separator
+- No separator at the beginning or end</p>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-GH-1413"></a><strong>Req. GH-1413:</strong> <a href="#Req-GH-1413">Module specifier completion</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>Manually inserting a specifier ending with a separator is valid.
+It is then interpreted as base path for the full module specifier automatically completed by the class name. (cf. grey suffix)</p>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-GH-1413"></a><strong>Req. GH-1413:</strong> <a href="#Req-GH-1413">Module specifier grey suffix</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>A grey suffix should suggest the attached class name as module name if the specifier only specifies a base path.</p>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-GH-1413"></a><strong>Req. GH-1413:</strong> <a href="#Req-GH-1413">Module specifier browse button</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>Browsing only allows the selection of modules or module containers in the selected source folder. The browse dialog has to offer a module container creation functionality. In contrast to the other parts of the wizard, the creation of module containers in this dialog should be immediate and on file system level. This is important to comply with the conceptual model of eclipse and the operating system.</p>
+</div>
+<div class="paragraph">
+<p>When inserting a non-existent path in the text input and opening the browse dialog, an additional dialog should ask the user whether he wants to create this structure on the file system. If he denies, the dialog shows the selection to the level it already exists on the file system.</p>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-GH-1413"></a><strong>Req. GH-1413:</strong> <a href="#Req-GH-1413">Module specifier initial selection inference</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>The module specifier should be derived from the initial selection by using the container of the selection as initial module container</p>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-GH-1413"></a><strong>Req. GH-1413:</strong> <a href="#Req-GH-1413">Module specifier content assist</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>Modules in the selected source folder</p>
+</div>
+</div>
+</div>
+<div class="paragraph todo">
+<p>For now the spec doesn&#8217;t specify any constraints for module specifiers</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Class name</dt>
+<dd>
+<p>Specifies the class name.</p>
+</dd>
+</dl>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-GH-1413"></a><strong>Req. GH-1413:</strong> <a href="#Req-GH-1413">Class name basic constraints</a> (ver. 1)</p>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Constraints
+</td>
+<td class="hdlist2">
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>The name is a valid n4js class identifier Must not be empty</p>
+</li>
+<li>
+<p>If the target module already exists no other type with the same identifier may exist in this module</p>
+</li>
+</ol>
+</div>
+</td>
+</tr>
+</table>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-GH-1413"></a><strong>Req. GH-1413:</strong> <a href="#Req-GH-1413">Class name conflict validation</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>If the target module already exists no other type with the same identifier may exist in this module</p>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-GH-1413"></a><strong>Req. GH-1413:</strong> <a href="#Req-GH-1413">File type options</a> (ver. 1)</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Definition file (.n4jsd)</dt>
+<dd>
+<p>Specifies whether the class should be declared external. This option changes the file extension to <code>n4jsd</code></p>
+</dd>
+</dl>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-GH-1413"></a><strong>Req. GH-1413:</strong> <a href="#Req-GH-1413">Access modifier constraints</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>Specifies the access modifiers of the class. One of <code>public</code>, <code>project</code>, <strong>private</strong>. <code>@Internal</code> is an additionally selectable option.</p>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Constraints
+</td>
+<td class="hdlist2">
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>One of the provided access modifiers has to be selected</p>
+</li>
+<li>
+<p>The <code>@Internal</code> option is only selectable in case of <code>public</code> or <code>project</code></p>
+</li>
+</ol>
+</div>
+</td>
+</tr>
+</table>
+</div>
+</div>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Other modifiers</dt>
+<dd>
+<p>Specifies other modifiers and annotations of the class. The non-exclusive options are <code>@Final</code> and <strong>@N4JS</strong></p>
+</dd>
+</dl>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-GH-1413"></a><strong>Req. GH-1413:</strong> <a href="#Req-GH-1413">Other modifiers constraints</a> (ver. 1)</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Constraints</dt>
+<dd>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p><strong>@N4JS</strong> annotation is only enabled and selectable if the Definition File box is checked</p>
+</li>
+</ol>
+</div>
+</dd>
+</dl>
+</div>
+</div>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Super class</dt>
+<dd>
+<p>Specifies the super class</p>
+</dd>
+</dl>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-GH-1413"></a><strong>Req. GH-1413:</strong> <a href="#Req-GH-1413">Super class constraints</a> (ver. 1)</p>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Constraints
+</td>
+<td class="hdlist2">
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>A valid absolute class specifier that is a module specifier and a class name separated by a dot.</p>
+</li>
+</ol>
+</div>
+</td>
+</tr>
+</table>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-GH-1413"></a><strong>Req. GH-1413:</strong> <a href="#Req-GH-1413">Super class browse button</a> (ver. 1)</p>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Browse Button
+</td>
+<td class="hdlist2">
+<p>Browsing allows the selection of all classes in the current workspace with modifiable source and visible classes with unmodifiable sources.</p>
+</td>
+</tr>
+</table>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-GH-1413"></a><strong>Req. GH-1413:</strong> <a href="#Req-GH-1413">Super class content assist</a> (ver. 1)</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Content Assist</dt>
+<dd>
+<p>All classes matching mentioned criteria</p>
+</dd>
+</dl>
+</div>
+</div>
+</div>
+<div id="Class_File_Wizard-Interfaces_Field" class="dlist">
+<dl>
+<dt class="hdlist1">Interfaces</dt>
+<dd>
+<p>Specifies the implemented interfaces of the class</p>
+</dd>
+</dl>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-GH-1413"></a><strong>Req. GH-1413:</strong> <a href="#Req-GH-1413">Interfaces constraints</a> (ver. 1)</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>A valid absolute interface specifier that is a module specifier and an interface name separated by a dot.</p>
+</li>
+</ol>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-GH-1413"></a><strong>Req. GH-1413:</strong> <a href="#Req-GH-1413">Interfaces browsing</a> (ver. 1)</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Add Button</dt>
+<dd>
+<p>Browsing allows the selection of all interfaces in the current workspace with modifiable source and visible interfaces with unmodifiable sources.</p>
+</dd>
+<dt class="hdlist1">Remove Button</dt>
+<dd>
+<p>Removes the selected interface from the list. Disabled if nothing is selected.</p>
+</dd>
+</dl>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-GH-1413"></a><strong>Req. GH-1413:</strong> <a href="#Req-GH-1413">Interfaces content assist</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>Text input is available by clicking in empty space at the end of the list. Content Assist provides all interfaces matching mentioned criteria.</p>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-GH-1413"></a><strong>Req. GH-1413:</strong> <a href="#Req-GH-1413">Create method stubs</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>Specifies if the wizard should generate method stubs for all abstract methods of the newly generated class. That are abstract super class methods or methods that need to be implemented by the class to conform to the selected interfaces.</p>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-GH-1413"></a><strong>Req. GH-1413:</strong> <a href="#Req-GH-1413">Create method stub conflict detection</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>If the selected interfaces are impossible to implement (e.g. method name overlap with unrelated parameter types) this option needs to be disabled and a warning needs to be shown.</p>
+</div>
+</div>
+</div>
+<div class="paragraph todo">
+<p>Shouldn&#8217;t this be a constraint of the selected interfaces? (Never generate invalid code)</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="visibility-issues-or-final-super-classes"><a class="anchor" href="#visibility-issues-or-final-super-classes"></a><a class="link" href="#visibility-issues-or-final-super-classes">4.3.3. Visibility issues or <code>@Final</code> super classes</a></h4>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-GH-1413"></a><strong>Req. GH-1413:</strong> <a href="#Req-GH-1413">Visibility issue conflict solving</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>By allowing the user to select invisible interfaces and super classes or unextendable <code>@Final</code>-annotated super classes, accessability issues may come up. The goal is to never generate a file containing invalid code. To accomplish this, conflicts must get solved before the file is generated.</p>
+</div>
+<div class="paragraph">
+<p>The slight limitation of the selection of interfaces and classes to elements from modifiable sources (cf. <a href="#Req-GH-1413">super class browse button</a>) allows to solve all possibly occurring visibility issues.</p>
+</div>
+<div class="paragraph">
+<p>If the modifications by finishing the wizard do imply changes different from insertions and creations, a compare view is to be shown, giving the user an overview of the needed changes before they’re applied.</p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="generation-1"><a class="anchor" href="#generation-1"></a><a class="link" href="#generation-1">4.3.4. Generation</a></h4>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-GH-1413"></a><strong>Req. GH-1413:</strong> <a href="#Req-GH-1413">Wizard generation</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>The following changes are to be made by the wizard:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Create a new file containing the new class (optional)</p>
+</li>
+<li>
+<p>Insert the new class into the specified module</p>
+</li>
+<li>
+<p>Change the source module of the super class to fix possible visibility issues (optional)</p>
+</li>
+<li>
+<p>Change the source module of the interfaces to fix possible visibility issues (optional)</p>
+</li>
+<li>
+<p>Change the project manifest to add a new source folder (optional) or add new project dependencies (optional)</p>
+</li>
+</ol>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="preview-1"><a class="anchor" href="#preview-1"></a><a class="link" href="#preview-1">4.3.5. Preview</a></h4>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-GH-1413"></a><strong>Req. GH-1413:</strong> <a href="#Req-GH-1413">Generation preview</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>On the right of the wizard form a preview window should be provided. It should preview the full path of the generated file and all code that is generated with the options of the wizard. Changes should be updated in realtime as the user is choosing different options.</p>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="sec:N4JS_Interface_Wizard"><a class="anchor" href="#sec:N4JS_Interface_Wizard"></a><a class="link" href="#sec:N4JS_Interface_Wizard">4.4. Interface Wizard</a></h3>
+<div class="paragraph">
+<p>The N4JS interface wizards is strongly similar to the <a href="#sec:N4JS_Class_File_Wizard">N4JS Class Wizard</a>. The following paragraph is meant to state the differences and will strongly refer to the N4JS Class Wizard as a lot of properties stay the same.</p>
+</div>
+<div class="imageblock center">
+<div class="content">
+<img src="chapters/06_wizards/fig/newinterfacewizard.png" alt="newinterfacewizard">
+</div>
+</div>
+<div class="sect3">
+<h4 id="field-properties-1"><a class="anchor" href="#field-properties-1"></a><a class="link" href="#field-properties-1">4.4.1. Field Properties</a></h4>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Project
+</td>
+<td class="hdlist2">
+<p>Specifies the containing project.
+See <a href="#Class_File_Wizard-Project_Field">N4JS Class Wizard Project</a>.</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Source Folder
+</td>
+<td class="hdlist2">
+<p>Specifies the containing source folder.<br>
+See <a href="#Class_File_Wizard-Source_Folder_Field">N4JS Class Wizard Source Folder</a></p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Module Specifier
+</td>
+<td class="hdlist2">
+<p>Specifies the containing source folder.<br>
+See <a href="#Class_File_Wizard-Module_Specifier_Field">N4JS Class Wizard Module specifier</a></p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Interface name
+</td>
+<td class="hdlist2">
+<p>Specifies the name of the interface<br></p>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Constraints</dt>
+<dd>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>The name is a valid n4js interface identifier</p>
+</li>
+<li>
+<p>Must not be empty</p>
+</li>
+<li>
+<p>If the target module already exists, no other type with the same identifier may exist in this module</p>
+</li>
+</ol>
+</div>
+</dd>
+</dl>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Definition file (.n4jsd)
+</td>
+<td class="hdlist2">
+<p>Specifies whether the interface should be declared external. This option changes the file extension to <code>n4jsd</code> .</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Access Modifiers
+</td>
+<td class="hdlist2">
+<p>Specifies the interface’s access modifiers</p>
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>See <a href="#Req-GH-1413">N4JS Class Wizard Modifier Field</a> except for the following point:</p>
+</div>
+<div class="paragraph">
+<p><em>Other than classes, interfaces must not be declared as <code>@Final</code>, therefore this option is removed.</em></p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Interfaces</dt>
+<dd>
+<p>The interfaces the interface is implementing</p>
+</dd>
+</dl>
+</div>
+<div class="paragraph">
+<p>See <a href="#Class_File_Wizard-Interfaces_Field">N4JS Class Wizard Interfaces field</a> except for the following point:</p>
+</div>
+<div class="paragraph">
+<p><em>Other than classes interfaces must not be declared as <code>@Final</code>, therefore this option is removed.</em></p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Create method stubs</dt>
+<dd>
+<p>Specifies if the wizard should generate method stubs for all abstract methods of the newly generated class. That are abstract super interface methods or methods that need to be implemented by the interface to conform to the given interfaces.</p>
+<div class="paragraph">
+<p>If the selected interfaces are impossible to implement (e.g. method name overlap with unrelated parameter types) this option needs to be disabled and a warning needs to be shown.</p>
+</div>
+</dd>
+</dl>
+</div>
+<div class="paragraph todo">
+<p>Shouldn&#8217;t this be a constraint of the selected interfaces? (Never generate invalid code)</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="visibility-issues"><a class="anchor" href="#visibility-issues"></a><a class="link" href="#visibility-issues">4.4.2. Visibility Issues</a></h4>
+<div class="paragraph">
+<p>As the user might select invisible interfaces, the wizard has to solve these visibility issues. See ** for details.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="import-naming-conflicts"><a class="anchor" href="#import-naming-conflicts"></a><a class="link" href="#import-naming-conflicts">4.4.3. Import naming conflicts</a></h4>
+<div class="paragraph">
+<p>As the user may select identically named interfaces, the wizard has to solve these naming conflicts. See
+<strong><a href="#Req-GH-1413">Class Wizard Visibility Issues</a></strong> for details.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="generation-2"><a class="anchor" href="#generation-2"></a><a class="link" href="#generation-2">4.4.4. Generation</a></h4>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Create a new file at the given module specifier location (optional)</p>
+</li>
+<li>
+<p>Insert the new interface into the specified module</p>
+</li>
+<li>
+<p>Change the source module of the super class to fix visibility issues (optional)</p>
+</li>
+<li>
+<p>Change the source module of the interfaces to fix possible visibility issues (optional)</p>
+</li>
+<li>
+<p>Change the project manifest to add a possibly new source folder (optional) or add new project dependencies (optional)</p>
+</li>
+</ol>
+</div>
+</div>
+<div class="sect3">
+<h4 id="preview-2"><a class="anchor" href="#preview-2"></a><a class="link" href="#preview-2">4.4.5. Preview</a></h4>
+<div class="paragraph">
+<p>The Interface Wizard should provided a preview. (See <a href="#sec:N4JS_Wizards:Wizard_Preview">Wizard Preview</a>)</p>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="sec:N4JS_Enum_File_Wizard"><a class="anchor" href="#sec:N4JS_Enum_File_Wizard"></a><a class="link" href="#sec:N4JS_Enum_File_Wizard">4.5. Enum Wizard</a></h3>
+<div class="paragraph">
+<p>The N4JS Enum File wizards provides the user a wizard to create enums. When speaking of enums in this context ordinary enums as specified in the N4JS Specification are meant.</p>
+</div>
+<div class="sect3">
+<h4 id="field-properties-2"><a class="anchor" href="#field-properties-2"></a><a class="link" href="#field-properties-2">4.5.1. Field Properties</a></h4>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Project
+</td>
+<td class="hdlist2">
+<p>Specifies the containing project.<br>
+See <a href="#Class_File_Wizard-Project_Field">N4JS Class Wizard Project</a></p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Source Folder
+</td>
+<td class="hdlist2">
+<p> Specifies the containing source folder.<br>
+See <a href="#Class_File_Wizard-Source_Folder_Field">N4JS Class Wizard Source Folder</a></p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Module Specifier
+</td>
+<td class="hdlist2">
+<p>Specifies the containing source folder. See <a href="#Class_File_Wizard-Module_Specifier_Field">N4JS Class Wizard Module specifier</a></p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Enum name
+</td>
+<td class="hdlist2">
+<p>Specifies the name of the interface<br></p>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Constraints</dt>
+<dd>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>The name is a valid n4js enum identifier</p>
+</li>
+<li>
+<p>Must not be empty</p>
+</li>
+<li>
+<p>If the target module already exists, no other type with the same identifier may exist in this module</p>
+</li>
+</ol>
+</div>
+</dd>
+</dl>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Modifiers
+</td>
+<td class="hdlist2">
+<p>Specifies the interface’s access modifiers
++
+Allows the user to select from following modifier options: <code>public</code>,<code>project</code>,<code>private</code>. The wizard automatically adds missing <code>export</code> if needed.
++
+Furthermore the enum can be declared <code>@Internal</code> using a checkbox.</p>
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph todo">
+<p>Should the enum wizard also provide functionality to create enum literals?</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="generation-3"><a class="anchor" href="#generation-3"></a><a class="link" href="#generation-3">4.5.2. Generation</a></h4>
+<div class="paragraph">
+<p>The following changes are to be made by the wizard:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Create a new file containing the new enum (optional, only if module doesn’t exists yet )</p>
+</li>
+<li>
+<p>Insert the new enum into the specified module</p>
+</li>
+</ol>
+</div>
+</div>
+<div class="sect3">
+<h4 id="preview-3"><a class="anchor" href="#preview-3"></a><a class="link" href="#preview-3">4.5.3. Preview</a></h4>
+<div class="paragraph">
+<p>The Enum Wizard should provided a preview. (See <a href="#sec:N4JS_Wizards:Wizard_Preview">Wizard Preview</a>)</p>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_execution-support"><a class="anchor" href="#_execution-support"></a><a class="link" href="#_execution-support">5. Execution Support</a></h2>
+<div class="sectionbody">
+<div class="admonitionblock warning">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-warning" title=""></i>
+</td>
+<td class="content">
+Parts of this document may be outdated.
+</td>
+</tr>
+</table>
+</div>
+<div class="sect2">
+<h3 id="sec:Non_UI_Execution"><a class="anchor" href="#sec:Non_UI_Execution"></a><a class="link" href="#sec:Non_UI_Execution">5.1. Non-UI Execution</a></h3>
+<div class="sect3">
+<h4 id="sec:Non_UI_Debugging"><a class="anchor" href="#sec:Non_UI_Debugging"></a><a class="link" href="#sec:Non_UI_Debugging">5.1.1. Non-UI Debugging</a></h4>
+<div class="paragraph">
+<p>not supported yet</p>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="sec:UI_Execution"><a class="anchor" href="#sec:UI_Execution"></a><a class="link" href="#sec:UI_Execution">5.2. UI Execution</a></h3>
+<div class="paragraph">
+<p>The N4JS IDE supports launching a file via a so called "runner". That is, a selected file is started as main
+file with Node.js or Chrome, depending on the available runners.</p>
+</div>
+<div class="admonitionblock warning">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-warning" title=""></i>
+</td>
+<td class="content">
+Chrome support not available yet.
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>For testing, a file, package, or even a whole project can be executed with a "tester". In that case, instead of directly executing the selected resource with Node.js (or other runners), the "mangelhaft" framework is used to run the selected resource or all its content as tests. For test support in general, see next chapter.</p>
+</div>
+<div class="paragraph">
+<p>Running or testing a resource is done via a launch configuration. This can be configured.</p>
+</div>
+<div class="paragraph">
+<p>The node.js runner/tester allows for configuration of</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>the NODE_MODULE path. This can be adjusted if the automatically path is not suited.</p>
+</li>
+<li>
+<p>other environment variables (simply as key=value pairs per line)</p>
+</li>
+<li>
+<p>node.js options to be passed as arguments to node.js</p>
+</li>
+<li>
+<p>the system loader to be used, this is "System.js" by default</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>
+Since in the JavaScript world these configurations are often used, it is cumbersome, particularly for tests, to define them for every single file. Thus the N4JS IDE copies the node.js settings found in a project launch configuration to a resource specific launch configuration.</p>
+</div>
+<div class="sidebarblock">
+<div class="content">
+<a href="https://github.com/eclipse/n4js/issues/716" class="gray" title="GitHub Issues"><span class="image"><img src="images/issue.svg" alt=""></span> #716</a>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_test-support"><a class="anchor" href="#_test-support"></a><a class="link" href="#_test-support">6. Test Support</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>N4IDE provides tests support by allowing different <em>TestRunner</em>s to extend it with test specific functionality. This allows to support specialized and very different from each other test requirements (e.g. nodejs based tests, browser based interactive ui tests, server integration tests).</p>
+</div>
+<div id="fig:test_support_diagram" class="imageblock">
+<div class="content">
+<img src="chapters/09_testsupport/fig/cd_testsupport.png" alt="cd testsupport">
+</div>
+<div class="title">Figure 10. Test Support Diagram</div>
+</div>
+<div class="paragraph">
+<p>Explanation of the main components:</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><em>User Project</em></dt>
+<dd>
+<div class="ulist">
+<ul>
+<li>
+<p>a project with production code (e.g. <code>src</code> folder), and test code (e.g. test folder)</p>
+</li>
+<li>
+<p>test code may contain special language features contributed by <em>Test Library</em></p>
+</li>
+</ul>
+</div>
+</dd>
+<dt class="hdlist1"><em>N4IDE</em></dt>
+<dd>
+<div class="ulist">
+<ul>
+<li>
+<p>manage user project, including all test related parts (e.g. support test related code, validate some test code constraints)</p>
+</li>
+<li>
+<p>host runner, allow its UI contributions</p>
+</li>
+</ul>
+</div>
+</dd>
+<dt class="hdlist1"><em>Test Runner</em></dt>
+<dd>
+<div class="ulist">
+<ul>
+<li>
+<p>contribute to N4IDE necessary elements (test results view, user test selection, test start/stop actions)</p>
+</li>
+<li>
+<p>use N4IDE mechanisms to access user project test fragment (e.g. discover tests)</p>
+</li>
+<li>
+<p>configure <em>Test Execution Environment</em></p>
+</li>
+<li>
+<p>manage test runtime (e.g. start/stop execution environment)</p>
+</li>
+</ul>
+</div>
+</dd>
+<dt class="hdlist1"><em>Test Execution Environment</em></dt>
+<dd>
+<div class="ulist">
+<ul>
+<li>
+<p>hosts (directly or indirectly) js engine in which tests are executed</p>
+</li>
+<li>
+<p>executes test library logic</p>
+</li>
+<li>
+<p>is responsible for some tests execution aspects (e.g. test isolation)</p>
+</li>
+<li>
+<p>deals with some execution errors (e.g. no callback from async test, infinite loop in test)</p>
+</li>
+</ul>
+</div>
+</dd>
+<dt class="hdlist1"><em>Test Library</em></dt>
+<dd>
+<div class="ulist">
+<ul>
+<li>
+<p>provides test api that user can use in his project</p>
+</li>
+<li>
+<p>coordinates scheduling and test code execution (e.g. order of tests, execution of setups / teardowns)</p>
+</li>
+<li>
+<p>creates test results</p>
+</li>
+</ul>
+</div>
+</dd>
+</dl>
+</div>
+<div class="paragraph">
+<p>Below picture and listings depicts the components of the Test Runner in the IDE:</p>
+</div>
+<div id="fig:test_runner_components" class="imageblock" style="text-align: center">
+<div class="content">
+<img src="chapters/09_testsupport/fig/test_runner_components.png" alt="test runner components" width="75%">
+</div>
+<div class="title">Figure 11. Test Runner Components</div>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+<em>Test Delegate</em>
+</td>
+<td class="hdlist2">
+<div class="ulist">
+<ul>
+<li>
+<p>After the test discovery it starts and stops the test session via the Test Facade.</p>
+</li>
+</ul>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+<em>Test Facade</em>
+</td>
+<td class="hdlist2">
+<div class="ulist">
+<ul>
+<li>
+<p>Ensures that an embedded HTTP server is running to receive messages from the Test Execution Environment. Registers a test session into the IDE side via the Test Finite State Machine Registry and triggers the actual test running at Test Execution Environment.</p>
+</li>
+</ul>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+<em>HTTP Server</em>
+</td>
+<td class="hdlist2">
+<div class="ulist">
+<ul>
+<li>
+<p>HTTP server is listening for HTTP requests from the Test Execution Environment via its RESTful API.</p>
+</li>
+</ul>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+<em>Resource Router Servlet</em>
+</td>
+<td class="hdlist2">
+<div class="ulist">
+<ul>
+<li>
+<p>This servlet is deployed into the servlet container of the HTTP Server. The servlet percepts the HTTP requests from the Test Execution Environment and delegates the request body to the corresponding REST Endpoint Logic.</p>
+</li>
+</ul>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+<em>REST Endpoint Logic</em>
+</td>
+<td class="hdlist2">
+<div class="ulist">
+<ul>
+<li>
+<p>Parses the HTTP request bodies, creates special events and sends them to all subscribers via the Test Event Bus.</p>
+</li>
+</ul>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+<em>Test Event Bus</em>
+</td>
+<td class="hdlist2">
+<div class="ulist">
+<ul>
+<li>
+<p>This component is used to asynchronously deliver messages between the main test runner components in a decoupled fashion.</p>
+</li>
+</ul>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+<em>Test Finite State Machine Registry</em>
+</td>
+<td class="hdlist2">
+<div class="ulist">
+<ul>
+<li>
+<p>This registry is used to cache test sessions represented as test trees and Test Finite State Machines. Percepts all messages initially sent by the Test Execution Environment and delegates them to the corresponding subscribers.</p>
+</li>
+</ul>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+<em>Test Finite State Machine</em>
+</td>
+<td class="hdlist2">
+<div class="ulist">
+<ul>
+<li>
+<p>Ensures the lifecycle of a test session. Handles timeouts duo to possible communication errors between the HTTP server and the Test Execution Environment.</p>
+</li>
+</ul>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+<em>Test Tree Registry</em>
+</td>
+<td class="hdlist2">
+<div class="ulist">
+<ul>
+<li>
+<p>Registry to handle the state of a test session. Responsible for updating a test tree associated with a test session with the received test results.</p>
+</li>
+</ul>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+<em>Test UI</em>
+</td>
+<td class="hdlist2">
+<div class="ulist">
+<ul>
+<li>
+<p>This UI component provides feedback about the running test session to the end-user.</p>
+</li>
+</ul>
+</div>
+</td>
+</tr>
+</table>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:N4JS_Mangelhaft_support"><a class="anchor" href="#sec:N4JS_Mangelhaft_support"></a><a class="link" href="#sec:N4JS_Mangelhaft_support">6.1. N4JS Mangelhaft support</a></h3>
+<div id="fig:xUnitSupportDesign" class="imageblock center" style="text-align: center">
+<div class="content">
+<img src="chapters/09_testsupport/fig/xUnitSupportDesign.png" alt="xUnitSupportDesign" width="75%">
+</div>
+<div class="title">Figure 12. xUnit Support Design</div>
+</div>
+<div class="paragraph">
+<p>In this section and subsections we specify N4IDE support for testing with Mangelhaft.</p>
+</div>
+<div class="paragraph">
+<p>Mangelhaft is N4JS <em>Test Library</em>. It is focused more on a xUnit tests than other forms of testing (BDD, Acceptance Testing, Functional UI Testing).</p>
+</div>
+<div class="paragraph">
+<p>The following test scenarios are supported on different <em>Test Execution Environment</em>s:</p>
+</div>
+<table id="tab:Test_Scenarios" class="tableblock frame-all grid-all spread">
+<caption class="title">Table 2. Test Scenarios</caption>
+<colgroup>
+<col style="width: 25%;">
+<col style="width: 25%;">
+<col style="width: 25%;">
+<col style="width: 25%;">
+</colgroup>
+<thead>
+<tr>
+<th class="tableblock halign-center valign-top">Test</th>
+<th class="tableblock halign-center valign-top">Node</th>
+<th class="tableblock halign-center valign-top">Browser</th>
+<th class="tableblock halign-center valign-top">Wrapper</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Plain</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>yes</code></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>yes</code></p></td>
+<td class="tableblock halign-center valign-top"></td>
+</tr>
+<tr>
+<th class="tableblock halign-left valign-top"><p class="tableblock">DOM</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>-</code></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>yes</code></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>-</code></p></td>
+</tr>
+<tr>
+<th class="tableblock halign-left valign-top"><p class="tableblock">non-interactive UI</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>-</code></p></td>
+<td class="tableblock halign-center valign-top"></td>
+<td class="tableblock halign-center valign-top"></td>
+</tr>
+<tr>
+<th class="tableblock halign-left valign-top"><p class="tableblock">interactive UI (iUI)</p></th>
+<td class="tableblock halign-center valign-top"></td>
+<td class="tableblock halign-center valign-top"></td>
+<td class="tableblock halign-center valign-top"></td>
+</tr>
+<tr>
+<th class="tableblock halign-left valign-top"><p class="tableblock">(non UI) Server</p></th>
+<td class="tableblock halign-center valign-top"></td>
+<td class="tableblock halign-center valign-top"></td>
+<td class="tableblock halign-center valign-top"></td>
+</tr>
+<tr>
+<th class="tableblock halign-left valign-top"><p class="tableblock">iUI Server</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>-</code></p></td>
+<td class="tableblock halign-center valign-top"></td>
+<td class="tableblock halign-center valign-top"></td>
+</tr>
+</tbody>
+</table>
+<div class="sect3">
+<h4 id="sec:Asynchronous_Tests"><a class="anchor" href="#sec:Asynchronous_Tests"></a><a class="link" href="#sec:Asynchronous_Tests">6.1.1. Asynchronous Tests, Test Isolation and Timeouts</a></h4>
+<div class="paragraph">
+<p>A special problem about JavaScript tests is to control asynchronous tests and non-terminating tests.</p>
+</div>
+<div class="paragraph">
+<p>Performance and test isolation are conflicting goals: a perfect isolation would mean to run every tests by a separate JavaScript engine, which is not performant. For that reason, all tests are run by the same JS-engine in general. A test has to notify the test runner when it has been finished (successfully or with failure). If it does not finish in a defined time (timeout), <em>Test Execution Environment</em> or <em>Manglehaft</em> needs to handle that (e.g. restart node vm in which code is executed)&#8230;&#8203;</p>
+</div>
+<div class="paragraph">
+<p>Main concerns with running test in parallel on js side are:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Timeouts Mangelhaft is supposed to track test timeout. If tests are running in fake parallel mode achieved by cooperative multitasking, then one test running eats up time for other test. This can cause tests to timeout when running in parallel, while succeed when running in sequential mode.</p>
+</li>
+<li>
+<p>Mutability on client. Tests running in parallel can affect each other by mutating global state in which they operate. When they run in sequential mode this can happen too, but it is much less likely to.</p>
+</li>
+<li>
+<p>Mutable state on the server. Tests running on the same session/login are prone to affecting each other through server interaction (and or mutating data on the server).</p>
+</li>
+</ol>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Supported_xUnit_API"><a class="anchor" href="#sec:Supported_xUnit_API"></a><a class="link" href="#sec:Supported_xUnit_API">6.1.2. Supported xUnit API</a></h4>
+<div class="paragraph">
+<p>xUnit API is user facing API for defining tests. It allows test developer to define tests and configure some test execution aspects. N4IDE (via <em>Test Runner</em> extension) supports defined API by :</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>gathering information via AST analysis and reflection</p>
+</li>
+<li>
+<p>presenting user available actions, based on gathered information</p>
+</li>
+<li>
+<p>gathering user input and configurations for test execution</p>
+</li>
+<li>
+<p>generating proper data for test infrastructure, based on user actions</p>
+</li>
+</ul>
+</div>
+<div class="sect4">
+<h5 id="sec:Test_Group"><a class="anchor" href="#sec:Test_Group"></a><a class="link" href="#sec:Test_Group">6.1.2.1. Test Group</a></h5>
+<div class="paragraph">
+<p>A test group is a logical collection of tests. It is created by grouping <code>N4ClassDeclarations</code> that contain test methods or test methods directly (see <a href="#sec:Test_Method">Test Method</a>). Those classes or individual methods can be assigned to a <em>Group</em> by annotating them with <code>@Group</code> annotation. This annotation takes non empty list of strings as parameter. Passed strings are used as category name (which is like its id).</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">Annotation:
+    '@Group'
+    (' $group+=$STRING ')?
+    AnnotatedElement
+;
+
+AnnnotatedElement:
+    N4JSClassDeclaration | N4JSMethodDeclaration
+;</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p><code>@Group</code> properties</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>name &#8594; <code>Group</code></p>
+</li>
+<li>
+<p>targets &#8594; N4Method, N4Class</p>
+</li>
+<li>
+<p>retention policy &#8594; RUNTIME</p>
+</li>
+<li>
+<p>transitive &#8594; YES</p>
+</li>
+<li>
+<p>repeatable &#8594; YES</p>
+</li>
+<li>
+<p>arguments &#8594; <em>String</em>s</p>
+</li>
+<li>
+<p>arguments are optional &#8594; NO</p>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Test_Method"><a class="anchor" href="#sec:Test_Method"></a><a class="link" href="#sec:Test_Method">6.1.2.2. Test Method</a></h5>
+<div class="paragraph">
+<p><em>Test Method</em> marks procedure that has to be executed by <em>Test Library</em>.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">Annotation:
+    '@Test'
+    AnnotatedElement
+;
+
+AnnnotatedElement:
+    N4JSMethodDeclaration
+;</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p><code>@Test</code> properties</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>name &#8594; <code>Test</code></p>
+</li>
+<li>
+<p>targets &#8594; N4Method</p>
+</li>
+<li>
+<p>retention policy &#8594; RUNTIME</p>
+</li>
+<li>
+<p>transitive &#8594; NO</p>
+</li>
+<li>
+<p>repeatable &#8594; NO</p>
+</li>
+<li>
+<p>arguments &#8594; none</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Additional <em>TestMethod</em> constraints:</p>
+</div>
+<div class="paragraph">
+<p>Test Method <a id="cnst:Test_Method"></a></p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>allowed only <code>N4ClassDeclarations</code> in project test fragment</p>
+</li>
+<li>
+<p>method must be public</p>
+</li>
+<li>
+<p>method takes no parameters</p>
+</li>
+<li>
+<p>method return type is <code>Promise?</code></p>
+</li>
+<li>
+<p>method must not be referenced by other owning class members or other classes (also no <em>@override</em>)</p>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:BeforeAll"><a class="anchor" href="#sec:BeforeAll"></a><a class="link" href="#sec:BeforeAll">6.1.2.3. BeforeAll Setup</a></h5>
+<div class="paragraph">
+<p><code>@BeforeAll</code> marks method that will be executed once before <strong>all</strong> tests in a given test class will be executed.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">Annotation:
+    '@BeforeAll'
+    AnnotatedElement
+;
+
+AnnnotatedElement:
+    N4JSMethodDeclaration
+;</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p><code>@BeforeAll</code> properties</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>name &#8594; <code>BeforeAll</code></p>
+</li>
+<li>
+<p>targets &#8594; N4Method</p>
+</li>
+<li>
+<p>retention policy &#8594; RUNTIME</p>
+</li>
+<li>
+<p>transitive &#8594; NO</p>
+</li>
+<li>
+<p>repeatable &#8594; NO</p>
+</li>
+<li>
+<p>arguments &#8594; none</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>The same constraints apply as for the test method, see <a href="#cnst:Test_Method">Test Method Constraints</a>.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Before_Setup"><a class="anchor" href="#sec:Before_Setup"></a><a class="link" href="#sec:Before_Setup">6.1.2.4. Before Setup</a></h5>
+<div class="paragraph">
+<p><code>@Before</code> marks method that will be executed once before <strong>each</strong> tests in a given test class will be executed.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">Annotation:
+    '@Before'
+    AnnotatedElement
+;
+
+AnnnotatedElement:
+    N4JSMethodDeclaration
+;</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p><code>@Before</code> properties</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>name &#8594; <code>Before</code></p>
+</li>
+<li>
+<p>targets &#8594; N4Method</p>
+</li>
+<li>
+<p>retention policy &#8594; RUNTIME</p>
+</li>
+<li>
+<p>transitive &#8594; NO</p>
+</li>
+<li>
+<p>repeatable &#8594; NO</p>
+</li>
+<li>
+<p>arguments &#8594; none</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>The same constraints apply as for the test method, see <a href="#cnst:Test_Method">Test Method Constraints</a>.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:After_Teardown"><a class="anchor" href="#sec:After_Teardown"></a><a class="link" href="#sec:After_Teardown">6.1.2.5. After Teardown</a></h5>
+<div class="paragraph">
+<p><code>@After</code> marks method that will be executed once after <strong>each</strong> tests in a given test class will be executed.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">Annotation:
+    '@After'
+    AnnotatedElement
+;
+
+AnnnotatedElement:
+    N4JSMethodDeclaration
+;</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p><code>@After</code> properties</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>name &#8594; <code>After</code></p>
+</li>
+<li>
+<p>targets &#8594; N4Method</p>
+</li>
+<li>
+<p>retention policy &#8594; RUNTIME</p>
+</li>
+<li>
+<p>transitive &#8594; NO</p>
+</li>
+<li>
+<p>repeatable &#8594; NO</p>
+</li>
+<li>
+<p>arguments &#8594; none</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>The same constraints apply as for the test method, see <a href="#cnst:Test_Method">Test Method Constraints</a>.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:AfterAll_Teardown"><a class="anchor" href="#sec:AfterAll_Teardown"></a><a class="link" href="#sec:AfterAll_Teardown">6.1.2.6. AfterAll Teardown</a></h5>
+<div class="paragraph">
+<p><code>@AfterAll</code> marks method that will be executed once after <strong>all</strong> tests in a given test class will be executed.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">Annotation:
+    '@After'
+    AnnotatedElement
+;
+
+AnnnotatedElement:
+    N4JSMethodDeclaration
+;</code></pre>
+</div>
+</div>
+<div class="ulist Test Fixture][cnst:Test_Fixture">
+<ul class="Test Fixture][cnst:Test_Fixture">
+<li>
+<p>allowed only in class marked with <em>@TestClass</em></p>
+</li>
+<li>
+<p>method must be public</p>
+</li>
+<li>
+<p>method takes no parameters</p>
+</li>
+<li>
+<p>method return type is <code>void</code></p>
+</li>
+<li>
+<p>method must not be referenced by other owning class members</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p><code>@AfterAll</code> properties</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>name &#8594; <code>AfterAll</code></p>
+</li>
+<li>
+<p>targets &#8594; N4Method</p>
+</li>
+<li>
+<p>retention policy &#8594; RUNTIME</p>
+</li>
+<li>
+<p>transitive &#8594; NO</p>
+</li>
+<li>
+<p>repeatable &#8594; NO</p>
+</li>
+<li>
+<p>arguments &#8594; none</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>The same constraints apply as for the test method, see <a href="#cnst:Test_Method">Test Method Constraints</a>.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Test_Ignore"><a class="anchor" href="#sec:Test_Ignore"></a><a class="link" href="#sec:Test_Ignore">6.1.2.7. Test Ignore</a></h5>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+name
+</td>
+<td class="hdlist2">
+<p>@Ignore</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+targets
+</td>
+<td class="hdlist2">
+<p>N4Method, N4Class</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+retention policy
+</td>
+<td class="hdlist2">
+<p>RUNTIME</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+transitive
+</td>
+<td class="hdlist2">
+<p>YES</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+repeatable
+</td>
+<td class="hdlist2">
+<p>NO</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+arguments
+</td>
+<td class="hdlist2">
+<p>String reason</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+arguments are optional
+</td>
+<td class="hdlist2">
+<p>&#8594; Yes</p>
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p><em>Test Ignore</em> allows to mark tests that should be skipped during the test execution. That is the preferred way to temporarily disable tests without removing them (or commenting them out). Test developers may provide reason for skipping to make reason/intentions clearer.</p>
+</div>
+<div class="paragraph">
+<p>This annotation is <em>transitive</em>, which means that: <em>Test Method</em> is considered as marked with <em>Test Skip</em></p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>explicitly when it is directly marked or</p>
+</li>
+<li>
+<p>implicitly, when container of a <em>Test Method</em> is marked.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>If a class is marked as <code>@Ignore</code>, then all its contained test methods will be ignored.<br>
+When <code>@Ignore</code> occurs at class level in a test class hierarchy chain, then the following rules are applied. Assume the following test classes:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">export public class A {
+
+    @Test
+    public aTest(): void {
+        console.log('A#aTest');
+    }
+
+}</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">import { A } from "A"
+
+@Ignore('Class B is ignored.')
+export public class B extends A {
+
+    @Test
+    public b1Test(): void {
+        console.log('B#b1Test');
+    }
+
+    @Ignore("Method B#b2Test is ignored.")
+    @Test
+    public b2Test(): void {
+        console.log("B#b2Test");
+    }
+
+}</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">import { B } from "B"
+
+export public class C extends B {
+
+    @Test
+    public cTest(): void {
+        console.log('C#cTest');
+    }
+
+}</code></pre>
+</div>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>When module <em>A</em> is being tested, then it is obvious that all the test methods of <code>A</code> will be tested. No methods will be skipped at all.</p>
+</li>
+<li>
+<p>When module <em>B</em> is being tested, then although the inherited members of class <code>A</code> will be included in the test tree, all methods, including the inherited ones (from class <code>A</code> from module <em>A</em>) will be skipped. Nothing will be tested.</p>
+</li>
+<li>
+<p>When module <em>C</em> is being tested, then all inherited members from class <code>B</code> and class <code>A</code> will be collected an included in the test tree. The <code>@Ignore</code> annotation declared at class level at <code>B</code> will be ignored but the <code>@Ignore</code> at method level in class <code>B</code> will be considered. In a nutshell, the following methods will be executed:</p>
+<div class="ulist">
+<ul>
+<li>
+<p><code>A#aTest</code></p>
+</li>
+<li>
+<p><code>B#b1Test</code></p>
+</li>
+<li>
+<p><code>C#cTest</code></p>
+</li>
+</ul>
+</div>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>The above described behavior is identical to the behavior of <em>JUnit 4</em> with respect to the <code>@Ignore</code> annotation handling in case of test class inheritance.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Timeout"><a class="anchor" href="#sec:Timeout"></a><a class="link" href="#sec:Timeout">6.1.2.8. Timeout</a></h5>
+<div class="paragraph">
+<p><em>Timeout</em> allows test developer to set custom timeout when executing given test code. This can be used to set timeout for both <em>Test Method</em>s or <em>Test Fixtures</em></p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">Annotation:
+    '@Timeout'
+    ($timoeout+=$INT)?
+    AnnotatedElement
+;
+
+AnnnotatedElement:
+    N4JSClassDeclaration | N4JSMethodDeclaration
+;</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p><code>@Timeout</code> properties</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>name &#8594; <code>Timeout</code></p>
+</li>
+<li>
+<p>targets &#8594; N4Method, N4Class</p>
+</li>
+<li>
+<p>retention policy &#8594; RUNTIME</p>
+</li>
+<li>
+<p>transitive &#8594; YES</p>
+</li>
+<li>
+<p>repeatable &#8594; NO</p>
+</li>
+<li>
+<p>arguments &#8594; Number</p>
+</li>
+<li>
+<p>arguments are optional &#8594; NO</p>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Description"><a class="anchor" href="#sec:Description"></a><a class="link" href="#sec:Description">6.1.2.9. Description</a></h5>
+<div class="paragraph">
+<p><em>Description</em> allows test developer provide string describing given test or test class that <em>can</em> be used in IDE test view or in the test report.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">Annotation:
+    '@Description'
+    ($desc+=$STRING)?
+    AnnotatedElement
+;
+
+AnnnotatedElement:
+    N4JSClassDeclaration | N4JSMethodDeclaration
+;</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p><code>@Description</code> properties</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>name &#8594; <code>Description</code></p>
+</li>
+<li>
+<p>targets &#8594; N4Method, N4Class</p>
+</li>
+<li>
+<p>retention policy &#8594; RUNTIME</p>
+</li>
+<li>
+<p>transitive &#8594; YES</p>
+</li>
+<li>
+<p>arguments &#8594; String</p>
+</li>
+<li>
+<p>arguments are optional &#8594; NO</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="sec:Test_Reporting"><a class="anchor" href="#sec:Test_Reporting"></a><a class="link" href="#sec:Test_Reporting">6.2. Test Reporting</a></h3>
+<div class="paragraph">
+<p><em>Test Runtime Environment</em> communicates with <em>Test Runner</em> over HTTP. Defined communication is based on protocol used between lupenrein and old ide. It is used to send the information about test execution progress from the <em>Test Runtime</em> to <em>Test Runner</em>. Information send by this protocol is not equivalent to test results. <em>Test Runner</em> interprets progress it receives and based on gathered information it generates test results. Under specific conditions <em>Test Runner</em> may change reported test status PASS to test result FAILED and put this information to the test report e.g. when timeout happens (see note on timeouts below).</p>
+</div>
+<div id="fig:sm_TestListener" class="imageblock center" style="text-align: center">
+<div class="content">
+<img src="chapters/09_testsupport/fig/sm_TestListener.png" alt="sm TestListener" width="25%">
+</div>
+<div class="title">Figure 13. TestListener</div>
+</div>
+<div class="paragraph">
+<p><a href="#fig:sm_TestListener">Test Listener</a> shows Communication flow expected by the <em>Test Runner</em>. When the <em>Test Runner</em> is started first it waits for <em>Start Session</em> message. Next <em>Test Tree</em> message is expected. This describes list of all tests that are expected to be executed. For all tests in the list <em>Test Runner</em> expects <em>Test Start</em> and <em>Test End</em> message to be received. <em>End Session</em> is expected to be last message in the test session. <em>Ping</em> message can be send multiple times in between other messages to manage synchronization issues between <em>Test Runner</em> and <em>Test Runtime</em> (see below).</p>
+</div>
+<div class="paragraph">
+<p>Since all communication is asynchronous, IDE <em>Test Runner</em> must assume some timeout values that will define standard wait time during communication:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Initial 90s timeout to wait for the <em>Start Session</em> message. It may be fixed or adjusted to given environment (local/remote) and project (library/application).</p>
+</li>
+<li>
+<p>Default timeout between all other test messages is 10 seconds. <em>Test Runtime</em> may notify IDE <em>Test Runner</em> that it should wait longer with <em>Ping</em> <em>test message</em>. This is one time thing, as soon as another command is received the default timeout will have to be reused again.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Do to the asynchronous nature of the tests, status updates can be given out of order by the Test Runtime Environment. The only sure thing is that all tests begin with <em>SessionStart</em> and ends with a <em>SessionEnd</em>. Furthermore a <em>TestStart</em> will be send before the <em>TestEnd</em> for a particular test.</p>
+</div>
+<div class="sect3">
+<h4 id="sec:Test_Messages"><a class="anchor" href="#sec:Test_Messages"></a><a class="link" href="#sec:Test_Messages">6.2.1. Test Messages</a></h4>
+<div class="paragraph">
+<p>IDE <em>Test Runner</em> will be waiting for specific messages from <em>Test Runtime</em>. We assume that communication will be done over HTTP protocol. <em>Test Execution Environement</em> should be configured by the <em>Test Runner</em> in a way that <em>Test Runtime</em> knows address where it has to send messages (see
+<a href="#sec:Test_Runtime_Configuration">Test Runtime Configuration</a>). <em>Test Runner</em> exposes RESTful API allowing him to receive messages. Below we define parts of that api that enable specific messages to be communicated.</p>
+</div>
+<div class="paragraph">
+<p>When defining <em>Test Message</em>s we assume following model of tests:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">TestTree {
+    ID sessionId,
+    Array&lt;TestSuite&gt;? testSuites
+}
+
+TestSuite {
+    string name,
+    Array&lt;TestCase&gt;? testCases,
+    Array&lt;TestSuite&gt;? children
+}
+
+TestCase {
+    ID id,
+    string className,
+    string origin,
+    string name,
+    string displayName,
+    TestResult? result
+}
+
+TestResult {
+    TestStatus teststatus,
+    number elapsed,
+    string? expected,
+    string? actual,
+    string? message,
+    array&lt;string&gt;? trace
+}
+
+enum TestStatus {
+    PASSED, SKIPPED, FAILED, ERROR
+}
+
+ID {
+    string value
+}</code></pre>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_test-case-ids"><a class="anchor" href="#_test-case-ids"></a><a class="link" href="#_test-case-ids">6.2.1.1. Test Case IDs</a></h5>
+<div class="paragraph">
+<p>The ID of a test case in the following specifications is referred to as <code>testID</code>.
+This ID is of the following structure:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre>testID: fqn '#' methodName</pre>
+</div>
+</div>
+<div class="paragraph">
+<p>When used as part of the URL the testID is percent-escaped as defined in <a href="https://tools.ietf.org/html/rfc3986#section-2.1">RFC3986 Section 2.1</a>. This is necessarry to circumvent the fact that the N4JS FQN delimiter <code>/</code> is a reserved character in URLs and cannot be used in its original form.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Start_Session"><a class="anchor" href="#sec:Start_Session"></a><a class="link" href="#sec:Start_Session">6.2.1.2. Start Session</a></h5>
+<div class="paragraph">
+<p>Signals start of the test session. When user triggers test execution, configures <em>IDETestRunnerCtrl</em>, afterwards IDE <em>Listener</em> waits for this message from <em>TestRunner</em>.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-json" data-lang="json">StartSession :
+    uri : /n4js/testing/sessions/{sessionID}/start
+    method : POST
+    contentType : application/vnd.n4js.start_session_req.tm+json
+    accept: application/json
+    responses:
+        200:
+        400:</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Start session request object MIME type <em>application/vnd.n4js.start_session_req.tm+json</em>:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-json" data-lang="json">{
+    map&lt;string, string&gt;? properties
+}</code></pre>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Ping_Session"><a class="anchor" href="#sec:Ping_Session"></a><a class="link" href="#sec:Ping_Session">6.2.1.3. Ping Session</a></h5>
+<div class="paragraph">
+<p>Signals that test runner is still busy doing things, and will report later to the listener.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-json" data-lang="json">PingSession :
+    uri : /n4js/testing/sessions/{sessionID}/ping
+    method : POST
+    contentType : application/vnd.n4js.ping_session_req.tm+json
+    accept: application/json
+    responses:
+        200:
+        400:</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Ping session request object MIME type <em>application/vnd.n4js.ping_session_req.tm+json</em>:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-json" data-lang="json">{
+    number timeout,
+    string? comment
+}</code></pre>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:End_Session"><a class="anchor" href="#sec:End_Session"></a><a class="link" href="#sec:End_Session">6.2.1.4. End Session</a></h5>
+<div class="paragraph">
+<p>Signals end of test session Notifies IDE <em>Listener</em> that session is finished and no further related <em>TestMessage</em>s are expected. IDE, can stop listening and proceed with its own tasks (e.g. create summary test report ).</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-json" data-lang="json">EndSession :
+    uri : /n4js/testing/sessions/{sessionID}/end
+    method : POST
+    responses:
+        200:
+        400:</code></pre>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Start_Test"><a class="anchor" href="#sec:Start_Test"></a><a class="link" href="#sec:Start_Test">6.2.1.5. Start Test</a></h5>
+<div class="paragraph">
+<p>Signals that a test run has started. Updates the state of the test reported with the <em>tree</em> .</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-json" data-lang="json">StartTest :
+    uri : /n4js/testing/sessions/{sessionID}/tests/{testID}/start
+    method : POST
+    contentType : application/vnd.n4js.start_test_req.tm+json
+    accept: application/json
+    responses:
+        200:
+            contentType : application/vnd.n4js.start_test_res.tm+json
+        400:</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Start test request object MIME type <em>application/vnd.n4js.start_test_req.tm+json</em>:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-json" data-lang="json">{
+    number timeout,
+    map&lt;string, string&gt;? properties
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Start test response object MIME type <em>application/vnd.n4js.start_test_res.tm+json</em>:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-json" data-lang="json">{
+    links : [
+        {
+            rel: "ping test",
+            uri: "/n4js/testing/sessions/{sessionID}/tests/{testID}/ping"
+        },
+        {
+            rel: "end test",
+            uri: "/n4js/testing/sessions/{sessionID}/tests/{testID}/end"
+        }
+    ]
+}</code></pre>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:End_Test"><a class="anchor" href="#sec:End_Test"></a><a class="link" href="#sec:End_Test">6.2.1.6. End Test</a></h5>
+<div class="paragraph">
+<p>Signals that a test run has ended. Updates the state of the test reported with the <em>tree</em> .</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-json" data-lang="json">EndTest :
+    uri : /n4js/testing/sessions/{sessionID}/tests/{testID}/end
+    method : POST
+    contentType : application/vnd.n4js.end_test_req.tm+json
+    accept: application/json
+    responses:
+        200:
+        400:</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>End test request object MIME type <em>application/vnd.n4js.end_test_req.tm+json</em>:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-json" data-lang="json">{
+    TestResult result
+}</code></pre>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Ping_Test"><a class="anchor" href="#sec:Ping_Test"></a><a class="link" href="#sec:Ping_Test">6.2.1.7. Ping Test</a></h5>
+<div class="paragraph">
+<p>Notifies IDE that <em>TestRunner</em> is doing something (e.g. test setup/teardown code, long running test). Without this notification IDE might interpret long pause in received messages as timeout, <em>TestRunner</em> crash or other issues (in consequence it might terminate whole test execution environment).</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-json" data-lang="json">PingTest :
+    uri : /n4js/testing/sessions/{sessionID}/tests/{testID}/ping
+    method : POST
+    contentType : application/vnd.n4js.ping_test_req.tm+json
+    accept: application/json
+    responses:
+        200:
+        400:</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Ping test request object MIME type <em>application/vnd.n4js.ping_test_req.tm+json</em>:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-json" data-lang="json">{
+    number timeout,
+    string? comment
+}</code></pre>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Test_Catalog"><a class="anchor" href="#sec:Test_Catalog"></a><a class="link" href="#sec:Test_Catalog">6.2.1.8. Test Catalog</a></h5>
+<div class="paragraph">
+<p>Assembles and returns with the test catalog representing all the tests available in the underlying <em>IN4JSCore</em> specific workspace. The content of the test catalog is calculated dynamically. The test catalog calculation depends on the current built state of the workspace. If the workspace was cleaned and not built yet, then a test catalog containing zero test suites (and test cases) will be provided as a response. If the workspace is built and in consistent state, then a catalog containing all test cases will be sent as the response body. The provided test catalog format complies to the Mangelhaft reporters.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-json" data-lang="json">TestCatalog :
+    uri : /n4js/testing/sessions/testcatalog
+    method : GET
+    contentType : application/vnd.n4js.assemble_test_catalog_req.tm+json
+    accept: application/json
+    responses:
+        200:
+        400:</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Below listings represents an example of the test catalog format:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-json" data-lang="json">{
+  "endpoint": "http://localhost:9415",
+  "sessionId": "fc3a425c-b675-47d7-8602-8877111cf909",
+  "testDescriptors": [
+    {
+      "origin": "SysProjectA-0.0.1",
+      "fqn": "T/T",
+      "testMethods": [
+        "t"
+      ]
+    },
+    {
+      "origin": "TestProjectA-0.0.1",
+      "fqn": "A/A",
+      "testMethods": [
+        "a"
+      ]
+    },
+    {
+      "origin": "TestProjectA-0.0.1",
+      "fqn": "B/B",
+      "testMethods": [
+        "b1",
+        "b2"
+      ]
+    },
+    {
+      "origin": "TestProjectB-0.0.1",
+      "fqn": "CSub1/CSub1",
+      "testMethods": [
+        "c1",
+        "c2"
+      ]
+    },
+    {
+      "origin": "TestProjectB-0.0.1",
+      "fqn": "CSub2/CSub2",
+      "testMethods": [
+        "c1",
+        "c2",
+        "c3"
+      ]
+    }
+  ]
+}</code></pre>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Test_Session_Example"><a class="anchor" href="#sec:Test_Session_Example"></a><a class="link" href="#sec:Test_Session_Example">6.2.1.9. Test Session Example</a></h5>
+<div class="paragraph">
+<p>Below example demonstrates what are the expected HTTP requests and JSON structures for a simple test group.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">class A {
+
+    @Test
+    public void foo() {}
+
+    @Test
+    @Ignore
+    public void bar() {}
+}
+
+class B {
+
+    @Test
+    public void baz() {}
+}
+
+class C {
+
+    @Test
+    public void qux() {}
+}</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-json" data-lang="json">Request method: POST
+Request path:   http://localhost:9415/n4js/testing/sessions/19f47a37-c1d1-4cb7-a514-1e131f26ab13/start/
+Headers:        Accept=*/*
+                Content-Type=application/vnd.n4js.start_session_req.tm+json; charset=ISO-8859-1</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-json" data-lang="json">Request method: POST
+Request path:   http://localhost:9415/n4js/testing/sessions/19f47a37-c1d1-4cb7-a514-1e131f26ab13/tests/Test%2FC%23qux/start/
+Headers:        Accept=*/*
+                Content-Type=application/vnd.n4js.start_test_req.tm+json; charset=ISO-8859-1
+Body:
+{
+    "timeout": 1000
+}
+
+
+Request method: POST
+Request path:   http://localhost:9415/n4js/testing/sessions/19f47a37-c1d1-4cb7-a514-1e131f26ab13/tests/Test%2FB%23baz/start/
+Headers:        Accept=*/*
+                Content-Type=application/vnd.n4js.start_test_req.tm+json; charset=ISO-8859-1
+Body:
+{
+    "timeout": 1000
+}
+
+
+Request method: POST
+Request path:   http://localhost:9415/n4js/testing/sessions/19f47a37-c1d1-4cb7-a514-1e131f26ab13/tests/Test%2FA%23bar/start/
+Headers:        Accept=*/*
+                Content-Type=application/vnd.n4js.start_test_req.tm+json; charset=ISO-8859-1
+Body:
+{
+    "timeout": 1000
+}
+
+
+Request method: POST
+Request path:   http://localhost:9415/n4js/testing/sessions/19f47a37-c1d1-4cb7-a514-1e131f26ab13/tests/Test%2FA%23foo/start/
+Headers:        Accept=*/*
+                Content-Type=application/vnd.n4js.start_test_req.tm+json; charset=ISO-8859-1
+Body:
+{
+    "timeout": 1000
+}</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-json" data-lang="json">Request method: POST
+Request path:   http://localhost:9415/n4js/testing/sessions/19f47a37-c1d1-4cb7-a514-1e131f26ab13/tests/Test%2FA%23bar/ping
+Headers:        Accept=*/*
+                Content-Type=application/vnd.n4js.ping_test_req.tm+json; charset=ISO-8859-1
+Body:
+{
+    "timeout": 1000
+}
+
+
+Request method: POST
+Request path:   http://localhost:9415/n4js/testing/sessions/19f47a37-c1d1-4cb7-a514-1e131f26ab13/tests/Test%2FC%23qux/ping/
+Headers:        Accept=*/*
+                Content-Type=application/vnd.n4js.ping_test_req.tm+json; charset=ISO-8859-1
+Body:
+{
+    "timeout": 2000
+}</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-json" data-lang="json">Request method: POST
+Request path:   http://localhost:9415/n4js/testing/sessions/19f47a37-c1d1-4cb7-a514-1e131f26ab13/tests/Test%2FB%23baz/end/
+Headers:        Accept=*/*
+                Content-Type=application/vnd.n4js.end_test_req.tm+json; charset=ISO-8859-1
+Body:
+{
+    "message": "Some optional message.",
+        "trace": [
+        "trace_element_1",
+        "trace_element_2",
+        "trace_element_3"
+    ],
+    "expected": "1",
+    "testStatus": "FAILED",
+    "elapsedTime": 100,
+    "actual": "2"
+}
+
+
+Request method: POST
+Request path:   http://localhost:9415/n4js/testing/sessions/19f47a37-c1d1-4cb7-a514-1e131f26ab13/tests/Test%2FC%23qux/end/
+Headers:        Accept=*/*
+                Content-Type=application/vnd.n4js.end_test_req.tm+json; charset=ISO-8859-1
+Body:
+{
+    "message": "Some failure message.",
+        "trace": [
+        "trace_element_1",
+        "trace_element_2",
+        "trace_element_3"
+    ],
+    "expected": "4",
+    "testStatus": "FAILED",
+    "elapsedTime": 50,
+    "actual": "3"
+}
+
+
+Request method: POST
+Request path:   http://localhost:9415/n4js/testing/sessions/19f47a37-c1d1-4cb7-a514-1e131f26ab13/tests/Test%2F%23foo/end/
+Headers:        Accept=*/*
+                Content-Type=application/vnd.n4js.end_test_req.tm+json; charset=ISO-8859-1
+Body:
+{
+    "expected": "2",
+    "testStatus": "PASSED",
+    "elapsedTime": 60,
+    "actual": "power of 2 for 2"
+}
+
+
+Request method: POST
+Request path:   http://localhost:9415/n4js/testing/sessions/19f47a37-c1d1-4cb7-a514-1e131f26ab13/tests/Test%2FA%23bar/end/
+Headers:        Accept=*/*
+                Content-Type=application/vnd.n4js.end_test_req.tm+json; charset=ISO-8859-1
+Body:
+{
+    "testStatus": "SKIPPED",
+    "elapsedTime": 0,
+}</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-json" data-lang="json">Request method: POST
+Request path:   http://localhost:9415/n4js/testing/sessions/19f47a37-c1d1-4cb7-a514-1e131f26ab13/end/
+Headers:        Accept=*/*
+                Content-Type=application/vnd.n4js.end_session_req.tm+json; charset=ISO-8859-1</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Test_Runtime_Configuration"><a class="anchor" href="#sec:Test_Runtime_Configuration"></a><a class="link" href="#sec:Test_Runtime_Configuration">6.2.2. Test Runtime Configuration</a></h4>
+<div class="paragraph">
+<p><em>Test Runner</em> must gather relevant information and send it to <em>Test Environment</em> to allow proper test execution:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>gathering user input and test options</p>
+</li>
+<li>
+<p>gathering information about user project test code</p>
+</li>
+<li>
+<p>maintaining proper name mappings (e.g. if project is minimized test names/references must be mapped correctly)</p>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Test_Plan"><a class="anchor" href="#sec:Test_Plan"></a><a class="link" href="#sec:Test_Plan">6.2.3. Test Plan</a></h4>
+<div class="paragraph">
+<p><em>Test Runner</em> uses N4IDE infrastructure to obtain information about test fragment of the user project. Based on that information and user input in UI (e.g. triggering test execution on whole project) IDE can determine <em>Test Method</em>s that should be executed. Such test list or <em>Test Plan</em> is send to <em>Test Environment</em> and is expected to be executed by a <em>Test Library</em>.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-json" data-lang="json">TestPlan {
+    Array&lt;TestProcedure&gt; procedures
+}
+
+TestProcedure {
+    string functionName,
+    string functionType,
+    string functionContainer,
+    string containerModule
+}</code></pre>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Test_Environment_Configuration"><a class="anchor" href="#sec:Test_Environment_Configuration"></a><a class="link" href="#sec:Test_Environment_Configuration">6.2.4. Test Environment Configuration</a></h4>
+<div class="paragraph">
+<p>Additionally <em>Test Runner</em> sends to <em>Test Environment</em> other configuration options:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><em>Test Runner</em> test communication protocol base url (<em>baseURL</em>)</p>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Test_Environment_Configuration_Example"><a class="anchor" href="#sec:Test_Environment_Configuration_Example"></a><a class="link" href="#sec:Test_Environment_Configuration_Example">6.2.5. Test Environment Configuration Example</a></h4>
+<div class="paragraph">
+<p>For example assuming that user selects <em>ProjectX</em> to test that contains only one test class in <em>src/test/n4js/core</em> path like:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">class MyTestClass{
+
+    @BeforeAll
+    public void someOneTimeSetup(){ /* setup code */}
+
+    @Test
+    public void testA(){ /* some test code*/ }
+    @Test
+    public void testB(){ /* some test code*/ }
+    @Test
+    public void testC(){ /* some test code*/ }
+
+    @After
+    public void afterCleanup(){ /* setup code */}
+
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Configuration sent for <em>Test Execution Environment</em> would look like:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-json" data-lang="json">{
+    "baseURL" : "http://localhost:1234/",
+    "testPlan":
+        [
+          {
+            "functionName": "someOneTimeSetup",
+            "functionType": "@BeforeAll",
+            "functionContainer": "MyTestClass",
+            "containerModule": "test/n4js/core/MyTestClass",
+          },
+          {
+            "functionName": "testA",
+            "functionType": "@Test",
+            "functionContainer": "MyTestClassA",
+            "containerModule": "test/n4js/core/MyTestClassA",
+          },
+          {
+            "functionName": "afterCleanup",
+            "functionType": "@After",
+            "functionContainer": "MyTestClassA",
+            "containerModule": "test/n4js/core/MyTestClassA",
+          },
+          {
+            "functionName": "testB",
+            "functionType": "@Test",
+            "functionContainer": "MyTestClassA",
+            "containerModule": "test/n4js/core/MyTestClassA",
+          },
+          {
+            "functionName": "afterCleanup",
+            "functionType": "@After",
+            "functionContainer": "MyTestClassA",
+            "containerModule": "test/n4js/core/MyTestClassA",
+          },
+          {
+            "functionName": "testC",
+            "functionType": "@Test",
+            "functionContainer": "MyTestClassA",
+            "containerModule": "test/n4js/core/MyTestClassA",
+          },
+          {
+            "functionName": "afterCleanup",
+            "functionType": "@After",
+            "functionContainer": "MyTestClassA",
+            "containerModule": "test/n4js/core/MyTestClassA",
+          }
+        ]
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_help-system"><a class="anchor" href="#_help-system"></a><a class="link" href="#_help-system">7. Help System</a></h2>
+<div class="sectionbody">
+<div class="sect2">
+<h3 id="sec:Built_In_Help"><a class="anchor" href="#sec:Built_In_Help"></a><a class="link" href="#sec:Built_In_Help">7.1. Built-In Help</a></h3>
+
+</div>
+<div class="sect2">
+<h3 id="sec:Context_Sensitive_Help"><a class="anchor" href="#sec:Context_Sensitive_Help"></a><a class="link" href="#sec:Context_Sensitive_Help">7.2. Context Sensitive Help</a></h3>
+
+</div>
+<div class="sect2">
+<h3 id="sec:Cheat_Sheets"><a class="anchor" href="#sec:Cheat_Sheets"></a><a class="link" href="#sec:Cheat_Sheets">7.3. Cheat Sheets</a></h3>
+
+</div>
+<div class="sect2">
+<h3 id="sec:JSDoc"><a class="anchor" href="#sec:JSDoc"></a><a class="link" href="#sec:JSDoc">7.4. JSDoc</a></h3>
+
+</div>
+<div class="sect2">
+<h3 id="sec:Hovering"><a class="anchor" href="#sec:Hovering"></a><a class="link" href="#sec:Hovering">7.5. Hovering</a></h3>
+<div class="paragraph">
+<p>Hovering over an element (such as type, field, method, function or variable declaration) in the N4JS editor will cause a tooltip appear containing information about the underlying element. Currently this information is the type (could be the inferred type as well), the name and the keyword (such as class, variable, field) of the actual element. By default the tooltip does not grab the focus from the currently active workbench window and will automatically disappear after the focus is lost from the element. One can grab the focus for the tooltip by clicking into the tooltip area or pressing <kbd>F2</kbd> function key.</p>
+</div>
+<div class="sect3">
+<h4 id="sec:Show_Type_Information_of_Selection"><a class="anchor" href="#sec:Show_Type_Information_of_Selection"></a><a class="link" href="#sec:Show_Type_Information_of_Selection">7.5.1. Show Type Information of Selection</a></h4>
+<div class="paragraph">
+<p>In some cases, during the development process, one would like to know what is the actual or even the inferred type of an N4JS expression. To use this functionality one can select the desired expression in the editor and invoke the ’Show Type Information’ command via the <kbd>Cmd</kbd> + <kbd>Option</kbd>+ <kbd>I</kbd> ( <kbd>Ctrl</kbd> + <kbd>Alt</kbd>+ <kbd>I</kbd> Windows/Linux) from the keyboard. This case a popup window will be raised containing the type information of the actual selection.</p>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="sec:Example_Projects_and_Files"><a class="anchor" href="#sec:Example_Projects_and_Files"></a><a class="link" href="#sec:Example_Projects_and_Files">7.6. Example Projects and Files</a></h3>
+
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_bug-management"><a class="anchor" href="#_bug-management"></a><a class="link" href="#_bug-management">8. Bug Management</a></h2>
+<div class="sectionbody">
+<div class="admonitionblock warning">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-warning" title=""></i>
+</td>
+<td class="content">
+Parts of this document may be outdated.
+</td>
+</tr>
+</table>
+</div>
+<div class="sect2">
+<h3 id="sec:Built_In_Xpect_Support"><a class="anchor" href="#sec:Built_In_Xpect_Support"></a><a class="link" href="#sec:Built_In_Xpect_Support">8.1. Built-In Xpect Support</a></h3>
+<div class="paragraph">
+<p>N4IDE contains built-in support for <a href="http://www.xpect-tests.org/">xpect</a> based tests. The purpose of those is to create tests for N4IDE support for user code, not the user code itself. Users can create <em>fileName.n4js.xt</em> to write their test for a given N4IDE functionality. Those files can be executed (via context menu, run configurations, etc.) to verify user expectations.</p>
+</div>
+<div class="sect3">
+<h4 id="sec:Report_View"><a class="anchor" href="#sec:Report_View"></a><a class="link" href="#sec:Report_View">8.1.1. Report View</a></h4>
+<div class="paragraph">
+<p>When executing xpect tests, users can view the results in a special view available in the IDE: <kbd>Window</kbd> &#8594; <kbd>Show View</kbd> &#8594; <kbd>Other</kbd>  &#8594; <kbd>Test Views</kbd> &#8594; <kbd>Xpect View</kbd>.</p>
+</div>
+<div id="fig:test_view" class="imageblock center" style="text-align: center">
+<div class="content">
+<img src="chapters/11_bugmanagement/fig/testView.png" alt="testView" width="75%">
+</div>
+<div class="title">Figure 14. Test View</div>
+</div>
+<div class="paragraph">
+<p>This view allows user to generate bug report (see <a href="#sec:Generate_Bug_Report">Generating Bug Reports</a>).</p>
+</div>
+<div class="paragraph">
+<p>In case of failing tests, users can see additional information (e.g. a stacktrace), or call a comparison view.</p>
+</div>
+<div id="fig:comparison" class="imageblock center" style="text-align: center">
+<div class="content">
+<img src="chapters/11_bugmanagement/fig/comparison.png" alt="comparison" width="75%">
+</div>
+<div class="title">Figure 15. Comparison</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Generate_Bug_Report"><a class="anchor" href="#sec:Generate_Bug_Report"></a><a class="link" href="#sec:Generate_Bug_Report">8.1.2. Generate Bug Report</a></h4>
+<div class="paragraph">
+<p>Generating bug reports can be done when there is some <code>.n4js.xt</code> file with all passing expectations, and at least one of them marked with <em>FIXME</em>. In this case icon of the executed test suite changes and via context menu user can call generate bug report option. When it is done, user can see contents of the bug generated in the console view. This output is prepared for out JIRA ticketing system.</p>
+</div>
+<div id="fig:bug_report" class="imageblock center" style="text-align: center">
+<div class="content">
+<img src="chapters/11_bugmanagement/fig/bugReport.png" alt="bugReport" width="75%">
+</div>
+<div class="title">Figure 16. Bug Report</div>
+</div>
+<div class="paragraph">
+<p>There is also possibility to generate bug report via file selection and context menu. In this case xpect test is not executed, only bug contents are generated.</p>
+</div>
+<div id="fig:bug" class="imageblock center" style="text-align: center">
+<div class="content">
+<img src="chapters/11_bugmanagement/fig/bug.png" alt="bug" width="50%">
+</div>
+<div class="title">Figure 17. Submited Bug</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Supported_Xpect_Tests"><a class="anchor" href="#sec:Supported_Xpect_Tests"></a><a class="link" href="#sec:Supported_Xpect_Tests">8.1.3. Supported Xpect Tests</a></h4>
+<div class="paragraph">
+<p>Xpect methods are special form of comments inside <em>.xt</em> files. General syntax for declaring usage of such method is <em>XPECT</em> marker followed by <em>XpectMethodName</em> and parameters for that method, all placed in comment. This can have three forms:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Single line comment (see the first comment in the listing below), Notice <strong><code>&#8594;</code></strong> separating the method name and its parameters.</p>
+</li>
+<li>
+<p>Multi line comment with one method invocation, notice <strong><code>-</code></strong> separating the method name and its parameters</p>
+</li>
+<li>
+<p>Multi line comment with multiple method invocations, simmilar to one above, but each line of method parameters indicates separate method invocation</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">//XPECT errors --&gt; "Couldn't resolve reference to IdentifiableElement 'consoleX'." at "consoleX"
+consoleX.log(10);
+
+/*XPECT errors ---
+ "Couldn't resolve reference to IdentifiableElement 'logY'." at "logY"
+---*/
+console.logY(10);
+
+/*XPECT errors ---
+ "Couldn't resolve reference to IdentifiableElement 'log'." at "log"
+ "Couldn't resolve reference to IdentifiableElement 'ref'." at "ref"
+ --- */
+log(ref);</code></pre>
+</div>
+</div>
+</li>
+</ul>
+</div>
+<div class="sect4">
+<h5 id="sec:XPECT_N4JS_Errors"><a class="anchor" href="#sec:XPECT_N4JS_Errors"></a><a class="link" href="#sec:XPECT_N4JS_Errors">8.1.3.1. Errors, Warnings, Infos, Issues</a></h5>
+<div class="paragraph">
+<p><em>Errors</em>, <em>Warnings</em>, <em>Infos</em> are xpect methods that allow to capture marker of given severity. Additionally <em>Issues</em> allows to allow markers of all above severities.</p>
+</div>
+<div class="paragraph">
+<p>All of those methods can be used single invocations or as mutline invocations.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">//XPECT errors --&gt; "Couldn't resolve reference to IdentifiableElement 'x'." at "x"
+console.log(x)
+
+//XPECT warnings --&gt; "Variable names should start with lower case letter." at "String"
+var String = "some string"</code></pre>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:XPECT_N4JS_Noerrors"><a class="anchor" href="#sec:XPECT_N4JS_Noerrors"></a><a class="link" href="#sec:XPECT_N4JS_Noerrors">8.1.3.2. Noerrors</a></h5>
+<div class="paragraph">
+<p>No errors allows to catch (and suppress) marker of any severity (<em>error</em>, <em>warning</em>, <em>info</em>).</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">//XPECT noerrors --&gt; "window object should be recognized"
+console.log(window)</code></pre>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:XPECT_N4JS_Output"><a class="anchor" href="#sec:XPECT_N4JS_Output"></a><a class="link" href="#sec:XPECT_N4JS_Output">8.1.3.3. Output, OutputRegex</a></h5>
+<div class="paragraph">
+<p>Output methods are special in sense that they are not intended to be used on single element of the script, but they apply to the whole script.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">/* XPECT output ---
+&lt;==
+stdout:
+hello world
+stderr:
+==&gt;
+--- */
+console.log("hello world")</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Second method accepts regex expressions. This allows to deal with troublesome output (e.g. dates)</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">/* XPECT outputRegex ---
+&lt;==
+stdout:
+[^\n]*
+stderr:
+==&gt;
+--- */
+console.log(new Date())</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">/* XPECT outputRegex ---
+&lt;==
+stdout:
+hello world
+stderr:
+
+[^\n]+
+throw ' cruel world'
+\^
+ cruel world
+==&gt;
+--- */
+console.log("hello world")
+throw ' cruel world'</code></pre>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:XPECT_N4JS_Type_Of"><a class="anchor" href="#sec:XPECT_N4JS_Type_Of"></a><a class="link" href="#sec:XPECT_N4JS_Type_Of">8.1.3.4. Type Of</a></h5>
+<div class="paragraph">
+<p>Xpect type methods allow test type inference, both for inferred type or expected type.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">//XPECT type of 'probablySomeString' --&gt; string
+var probablySomeString = "some string";
+
+var union{string,number} u;
+// XPECT expectedType at 'null' --&gt; {function(number?):string}
+u.toString = null</code></pre>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:XPECT_Advanced_Methods"><a class="anchor" href="#sec:XPECT_Advanced_Methods"></a><a class="link" href="#sec:XPECT_Advanced_Methods">8.1.3.5. Advanced methods</a></h5>
+<div class="paragraph">
+<p>There are also other methods provided, that allow to test quick fixes and content assist. Their parameters syntax is more complicated. Additionally they actively modify contents of the editor, or even close it if needed. Their usage exceeds scope of this document.</p>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_cli"><a class="anchor" href="#_cli"></a><a class="link" href="#_cli">9. CLI</a></h2>
+<div class="sectionbody">
+<div class="admonitionblock warning">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-warning" title=""></i>
+</td>
+<td class="content">
+Parts of this document may be outdated.
+</td>
+</tr>
+</table>
+</div>
+<div class="sect2 language-bash">
+<h3 id="sec:Headless_Compiler"><a class="anchor" href="#sec:Headless_Compiler"></a><a class="link" href="#sec:Headless_Compiler">9.1. Headless Compiler</a></h3>
+<div class="paragraph">
+<p>The headless compiler is provided as a separate tool, coming as a single jar file <code>n4jsc.jar</code>. It is to be invoked via</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-bash" data-lang="bash">java -jar n4jsc.jar</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Simply invoking the headless compiler with no further arguments will print out a description of command line options.</p>
+</div>
+<div class="paragraph">
+<p>The headless compiler works in three major modes (given as arguments to the switch <code>-bt</code>):</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>compilation of single files (<code>-bt singlefile</code>, <em>default</em>),</p>
+</li>
+<li>
+<p>compilation of given projects (<code>-bt projects</code>) or</p>
+</li>
+<li>
+<p>compilation of all projects (<code>-bt allprojects</code>)</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>The command-line invocation usually has the form of</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-bash" data-lang="bash">java -jar n4jsc.jar  ^$[options]$^  file1 file2 ...</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Standard compiler <em>options</em>:</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><code>--buildType</code> , <code>-bt</code> <em>mode</em></dt>
+<dd>
+<p>With <em>mode</em> as exactly one of</p>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">singlefile</dt>
+<dd>
+<p>only the source files given by <em>file1</em>, <em>file2</em>, &#8230;&#8203; are compiled.</p>
+</dd>
+<dt class="hdlist1">projects</dt>
+<dd>
+<p><em>file1</em>, <em>file2</em>, &#8230;&#8203; denote projects (folders containing a <code>manifest.n4mf</code>). These projects will be compiled.</p>
+</dd>
+<dt class="hdlist1">allprojects</dt>
+<dd>
+<p>All project found under the project-root(s) are compiled. There should be no <em>file&#8230;&#8203;</em> given.</p>
+</dd>
+<dt class="hdlist1">dontcompile</dt>
+<dd>
+<p>Nothing will be compiled. There should be no <em>file&#8230;&#8203;</em> given. (This is the default if no <code>-t</code> option is given).</p>
+</dd>
+</dl>
+</div>
+</dd>
+<dt class="hdlist1"><code>--projectlocations</code> (<code>-pl</code>) <code>path</code></dt>
+<dd>
+<p><a id="opt-projectlocations"></a> provide folder(s) to search for projects. If not set, the base folder of the running JVM will be taken as the location. Multiple folders are separated by the systems path-separator (’<code>:</code>’ on Mac / Unix and ’<code>;</code>’ on Windows). Only direct subfolders will be queried for projects. A subfolder is assumed to be a N4JS-project if it contains a <code>manifest.n4mf</code> file. All found projects are taken into consideration for dependency-resolution. Example on Linux:<br>
+  <code>-pl  /rootA/: /rootB:/some/absolute/path/to/projects</code>.</p>
+</dd>
+</dl>
+</div>
+<div class="paragraph">
+<p>Advanced compiler options (optional):</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><code>--notests</code></dt>
+<dd>
+<p>turn off compilation of code in test-folders. Can not be combined with <code>–testonly</code></p>
+</dd>
+<dt class="hdlist1"><code>--testonly</code></dt>
+<dd>
+<p>only compile test code. Externals and sources will not be compiled. Can not be combined with <code>–notests</code></p>
+</dd>
+<dt class="hdlist1"><code>--keepCompiling</code></dt>
+<dd>
+<p>try to compile even if some errors occur.</p>
+</dd>
+<dt class="hdlist1"><code>--preference</code> <em>file</em></dt>
+<dd>
+<p>uses <em>file</em> as there internal preferences-store similar to the preferences internally stored by the N4IDE.</p>
+</dd>
+</dl>
+</div>
+<div class="paragraph">
+<p>Additional command line options (optional):</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><code>--help</code> , <code>-h</code> </dt>
+<dd>
+<p>prints out help to the console and exits.</p>
+</dd>
+<dt class="hdlist1"><code>--verbose</code> , <code>-v</code></dt>
+<dd>
+<p>verbose output during build</p>
+</dd>
+<dt class="hdlist1"><code>--debug</code> </dt>
+<dd>
+<p>before executing, summarises the information of the current setup like resolved pathnames and other information, carries on with normal workflow and prints additional status information about loading and unloading projects and processing each resource.</p>
+</dd>
+<dt class="hdlist1"><code>--log</code></dt>
+<dd>
+<p>write a log file <code>n4jsc.log</code> to the base folder. (Change filename with <code>–logfile filename</code>)</p>
+</dd>
+</dl>
+</div>
+</div>
+<div class="sect2 language-bash">
+<h3 id="sec:Headless_Dependencies"><a class="anchor" href="#sec:Headless_Dependencies"></a><a class="link" href="#sec:Headless_Dependencies">9.2. Headless Dependnecies</a></h3>
+<div class="paragraph">
+<p>Compiler can manage dependencies of the processed projects:</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><code>--installMissingDependencies</code> , <code>-imd</code> </dt>
+<dd>
+<p>alnalyzes available projects and installs missing dependencies</p>
+</dd>
+<dt class="hdlist1"><code>--targetPlatformInstallLocation</code> , <code>-tl</code></dt>
+<dd>
+<p>location to which dependencies will be installed, if not provided temporal location will be used</p>
+</dd>
+<dt class="hdlist1"><code>--npmrcRootLocation</code></dt>
+<dd>
+<p>location of the <em>.npmrc</em> file to be used in <em>npm</em> invocations</p>
+</dd>
+</dl>
+</div>
+</div>
+<div class="sect2 language-bash">
+<h3 id="sec:Headless_Execution"><a class="anchor" href="#sec:Headless_Execution"></a><a class="link" href="#sec:Headless_Execution">9.3. Headless Execution</a></h3>
+<div class="paragraph">
+<p>For headless compiling, running and testing of N4JS code a general command line tool is provided. Many parameters of the different use cases are shared. Although you can combine the use cases each of them is described in its own section. This section is about running compiled code.</p>
+</div>
+<div class="paragraph">
+<p>For compiling refer to <a href="#sec:Headless_Compiler">Headless Compiler</a> for executing tests refer to <a href="#_test_support">Tests</a>.</p>
+</div>
+<div class="sect3">
+<h4 id="sec:Cleaning_Headlessly"><a class="anchor" href="#sec:Cleaning_Headlessly"></a><a class="link" href="#sec:Cleaning_Headlessly">9.3.1. Cleaning Headlessly</a></h4>
+<div class="paragraph">
+<p>It is possible to use the headless compiler to clean projects by using the following option</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><code>--clean</code> (<code>-c</code>)</dt>
+<dd>
+<p>When this option is used. The headless compiler only cleans projects without compilation. Moreover, the use of this option requires that the option <code>-t</code> must be specified and must be either <code>-t projects</code> or <code>-t allprojects</code>.</p>
+</dd>
+</dl>
+</div>
+<div class="paragraph">
+<p>For instance, <code>n4jsc --clean -t allprojects -pl path/to/project</code> or <code>n4jsc --clean -t projects project1 project2</code> are valid use while <code>n4jsc --clean -t singlefile file1 file2</code> is invalid.
+After the calling the command with <code>--clean (</code>-c`), the output folders of the specified projects (e.g. <code>src-gen</code> folders) are cleaned.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Running_Headlessly"><a class="anchor" href="#sec:Running_Headlessly"></a><a class="link" href="#sec:Running_Headlessly">9.3.2. Running Headlessly</a></h4>
+<div class="paragraph">
+<p>Running code from the command line requires basically three different pieces of information:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>The locations where projects, libraries and environments can be found must be given.</p>
+</li>
+<li>
+<p>The starting point of execution must be given by pointing to a module.</p>
+</li>
+<li>
+<p>Since there are multiple different project types, an adequate Runner has to be selected.</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>The follwing command line switches are used to provide this information:</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><code>--projectlocations</code> (<code>-pl</code>) <code>path</code></dt>
+<dd>
+<p>path of locations to search for projects (c.f. <a href="#sec:Headless_Compiler">Headless Compiler</a> ,<a href="#opt-projectlocations">Project Locations</a>)</p>
+</dd>
+<dt class="hdlist1"><code>--runWith</code> (<code>-rw</code>) <code>VAL</code></dt>
+<dd>
+<p>denotes the runner-id (as listed with --list-runners) or at least the last segment of it</p>
+</dd>
+<dt class="hdlist1"><code>--run</code> (<code>-r</code>) <code>FILE</code></dt>
+<dd>
+<p>source-module to run. Note you should point to the full location of the source file (*.n4js). The runner is <em>responsible to determine the compiled file</em>. It is not sufficient to give a project-relative path, it always needs to be a full path to the source file.</p>
+</dd>
+</dl>
+</div>
+<div class="paragraph">
+<p>It is possible to compile and run with a single CLI line. Compilation always precedes the execution. It the compilation fails the runner will not be started.</p>
+</div>
+<div class="paragraph">
+<p>To ease the usage of different runners it is allowed to provide the last segment(s) of the runner-id in a case-insensitive way, e.g. one can use the runner with id <code>org.eclipse.n4js.runner.nodejs.NODEJS</code> as follows:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-bash" data-lang="bash">.. --runWith org.eclipse.n4js.runner.nodejs.NODEJS ..</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>or in short</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-bash" data-lang="bash">.. --rw NODEJS ..</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>or even lower-cased with</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-bash" data-lang="bash">.. --rw nodejs ..</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Assume having a common workspace location ’wsp’ with a project ’P1’ containing the module ’A’. The following line shows how to run this code:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-bash" data-lang="bash">java -jar n4jsc.jar -pl wsp -rw nodejs -r wsp/P1/src/A.n4js</code></pre>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Information_about_running_headlessly"><a class="anchor" href="#sec:Information_about_running_headlessly"></a><a class="link" href="#sec:Information_about_running_headlessly">9.3.3. Information about running headlessly</a></h4>
+<div class="paragraph">
+<p>Available runner-ids can be actively queried:</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><code>--listRunners</code> (<code>-lr</code>)</dt>
+<dd>
+<p>prints out a list of all available command-line runners</p>
+</dd>
+</dl>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Testing_Headlessly"><a class="anchor" href="#sec:Testing_Headlessly"></a><a class="link" href="#sec:Testing_Headlessly">9.3.4. Testing Headlessly</a></h4>
+<div class="paragraph">
+<p>Testing code from the command line requires basically three different pieces of information:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>The locations where projects, libraries and environments can be found must be given.</p>
+</li>
+<li>
+<p>The starting point of test execution must be given by pointing to what is supposed to be tested (single file / whole project)/</p>
+</li>
+<li>
+<p>Since there are multiple different project types, an adequate Tester has to be selected.</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>The follwing command line switches are used to provide this information:</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><code>--projectlocations</code> (<code>-pl</code>) <code>path</code></dt>
+<dd>
+<p>path of locations to search for projects (c.f. <a href="#sec:Headless_Compiler">Headless Compiler</a> ,<a href="#opt-projectlocations">Project Locations</a>)</p>
+</dd>
+<dt class="hdlist1"><code>--testWith</code> (<code>-tw</code>) <code>VAL</code></dt>
+<dd>
+<p>denotes the tester-id (as listed with --list-testers) or at least the last segment of it</p>
+</dd>
+<dt class="hdlist1"><code>--test</code> (<code>-t</code>) <code>FILE</code></dt>
+<dd>
+<p>source-module to run. Note you should point to the full location of the project with tests, specific folder inside project with tests or the test source file (*.n4js). It is not sufficient to give a project-relative path, it always needs to be a full path to the source file.</p>
+</dd>
+</dl>
+</div>
+<div class="paragraph">
+<p>It is possible to compile and run with a single CLI line. Compilation always precedes the execution. It the compilation fails the tester will not be started.</p>
+</div>
+<div class="paragraph">
+<p>To ease the usage of different testers it is allowed to provide the last segment(s) of the tester-id in a case-insensitive way, e.g. one can use the runner with id <code>org.eclipse.n4js.tester.nodejs.NODEJS_MANGELHAFT</code> as follows:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-bash" data-lang="bash">.. --runWith org.eclipse.n4js.tester.nodejs.NODEJS_MANGELHAFT ..</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>or in short</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-bash" data-lang="bash">.. --rw NODEJS_MANGELHAFT ..</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>or even lower-cased with</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-bash" data-lang="bash">.. --rw nodejs_mangelhaft ..</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Assume having a common workspace location ’wsp’ with a project ’P1’ containing the module ’TestA’. The following line shows how to execute this test code:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-bash" data-lang="bash">java -jar n4jsc.jar -pl wsp -tw nodejs_mangelhaft -t wsp/P1/src/TestA.n4js</code></pre>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Information_about_testing_headlessly"><a class="anchor" href="#sec:Information_about_testing_headlessly"></a><a class="link" href="#sec:Information_about_testing_headlessly">9.3.5. Information about testing headlessly</a></h4>
+<div class="paragraph">
+<p>Available tester-ids can be actively queried:</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><code>--listTesters</code> (<code>-lt</code>)</dt>
+<dd>
+<p>prints out a list of all available command-line testers</p>
+</dd>
+</dl>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_testresults"><a class="anchor" href="#_testresults"></a><a class="link" href="#_testresults">9.3.6. TestResults</a></h4>
+<div class="paragraph">
+<p>TODO</p>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="sec:License"><a class="anchor" href="#sec:License"></a><a class="link" href="#sec:License">Appendix A: License</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>This specification and the accompanying materials is made available
+under the terms of the Eclipse Public License v1.0 which accompanies
+this distribution, and is available at <a href="http://www.eclipse.org/legal/epl-v10.html" class="bare">http://www.eclipse.org/legal/epl-v10.html</a></p>
+</div>
+<h3 id="_eclipse-public-license-v-1-0" class="discrete">Eclipse Public License - v 1.0</h3>
+<div class="paragraph">
+<p>THE ACCOMPANYING PROGRAM IS PROVIDED UNDER THE TERMS OF THIS ECLIPSE
+PUBLIC LICENSE (<code>AGREEMENT</code>). ANY USE, REPRODUCTION OR DISTRIBUTION OF
+THE PROGRAM CONSTITUTES RECIPIENT’S ACCEPTANCE OF THIS AGREEMENT.</p>
+</div>
+<h4 id="_1-definitions" class="discrete">1. DEFINITIONS</h4>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><code>Contribution</code> means: </dt>
+<dd>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>in the case of the initial Contributor, the initial code and
+documentation distributed under this Agreement, and</p>
+</li>
+<li>
+<p>in the case of each subsequent Contributor:</p>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p>changes to the Program, and</p>
+</li>
+<li>
+<p>additions to the Program;</p>
+<div class="paragraph">
+<p>where such changes and/or additions to the Program originate from and
+are distributed by that particular Contributor. A Contribution
+’originates’ from a Contributor if it was added to the Program by such
+Contributor itself or anyone acting on such Contributor’s behalf.
+Contributions do not include additions to the Program which:</p>
+</div>
+<div class="olist lowerroman">
+<ol class="lowerroman" type="i">
+<li>
+<p>are separate modules of software distributed in conjunction with the Program
+under their own license agreement, and</p>
+</li>
+<li>
+<p>are not derivative works of the Program.</p>
+</li>
+</ol>
+</div>
+</li>
+</ol>
+</div>
+</li>
+</ol>
+</div>
+</dd>
+<dt class="hdlist1"><code>Contributor</code></dt>
+<dd>
+<p>means any person or entity that distributes the Program.</p>
+</dd>
+<dt class="hdlist1"><code>Licensed Patents</code> </dt>
+<dd>
+<p>mean patent claims licensable by a Contributor
+which are necessarily infringed by the use or sale of its Contribution
+alone or when combined with the Program.</p>
+</dd>
+<dt class="hdlist1"><code>Program</code> </dt>
+<dd>
+<p>means the Contributions distributed in accordance with this
+Agreement.</p>
+</dd>
+<dt class="hdlist1"><code>Recipient</code> </dt>
+<dd>
+<p>means anyone who receives the Program under this
+Agreement, including all Contributors.</p>
+</dd>
+</dl>
+</div>
+<h4 id="_2-grant-of-rights" class="discrete">2. GRANT OF RIGHTS</h4>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Subject to the terms of this Agreement, each Contributor hereby
+grants Recipient a non-exclusive, worldwide, royalty-free copyright
+license to reproduce, prepare derivative works of, publicly display,
+publicly perform, distribute and sublicense the Contribution of such
+Contributor, if any, and such derivative works, in source code and
+object code form.</p>
+</li>
+<li>
+<p>Subject to the terms of this Agreement, each Contributor hereby
+grants Recipient a non-exclusive, worldwide, royalty-free patent license
+under Licensed Patents to make, use, sell, offer to sell, import and
+otherwise transfer the Contribution of such Contributor, if any, in
+source code and object code form. This patent license shall apply to the
+combination of the Contribution and the Program if, at the time the
+Contribution is added by the Contributor, such addition of the
+Contribution causes such combination to be covered by the Licensed
+Patents. The patent license shall not apply to any other combinations
+which include the Contribution. No hardware per se is licensed
+hereunder.</p>
+</li>
+<li>
+<p>Recipient understands that although each Contributor grants the
+licenses to its Contributions set forth herein, no assurances are
+provided by any Contributor that the Program does not infringe the
+patent or other intellectual property rights of any other entity. Each
+Contributor disclaims any liability to Recipient for claims brought by
+any other entity based on infringement of intellectual property rights
+or otherwise. As a condition to exercising the rights and licenses
+granted hereunder, each Recipient hereby assumes sole responsibility to
+secure any other intellectual property rights needed, if any. For
+example, if a third party patent license is required to allow Recipient
+to distribute the Program, it is Recipient’s responsibility to acquire
+that license before distributing the Program.</p>
+</li>
+<li>
+<p>Each Contributor represents that to its knowledge it has sufficient
+copyright rights in its Contribution, if any, to grant the copyright
+license set forth in this Agreement.</p>
+</li>
+</ol>
+</div>
+<h4 id="_3-requirements" class="discrete">3. REQUIREMENTS</h4>
+<div class="paragraph">
+<p>A Contributor may choose to distribute the Program in object code form
+under its own license agreement, provided that:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>it complies with the terms and conditions of this Agreement; and</p>
+</li>
+<li>
+<p>its license agreement:</p>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p>effectively disclaims on behalf of all Contributors all warranties
+and conditions, express and implied, including warranties or conditions
+of title and non-infringement, and implied warranties or conditions of
+merchantability and fitness for a particular purpose;</p>
+</li>
+<li>
+<p>effectively excludes on behalf of all Contributors all liability for
+damages, including direct, indirect, special, incidental and
+consequential damages, such as lost profits;</p>
+</li>
+<li>
+<p>states that any provisions which differ from this Agreement are
+offered by that Contributor alone and not by any other party; and</p>
+</li>
+<li>
+<p>states that source code for the Program is available from such
+Contributor, and informs licensees how to obtain it in a reasonable
+manner on or through a medium customarily used for software exchange.</p>
+</li>
+</ol>
+</div>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>When the Program is made available in source code form:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>it must be made available under this Agreement; and</p>
+</li>
+<li>
+<p>a copy of this Agreement must be included with each copy of the
+Program.</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>Contributors may not remove or alter any copyright notices contained
+within the Program.</p>
+</div>
+<div class="paragraph">
+<p>Each Contributor must identify itself as the originator of its
+Contribution, if any, in a manner that reasonably allows subsequent
+Recipients to identify the originator of the Contribution.</p>
+</div>
+<h4 id="_4-commercial-distribution" class="discrete">4. COMMERCIAL DISTRIBUTION</h4>
+<div class="paragraph">
+<p>Commercial distributors of software may accept certain responsibilities
+with respect to end users, business partners and the like. While this
+license is intended to facilitate the commercial use of the Program, the
+Contributor who includes the Program in a commercial product offering
+should do so in a manner which does not create potential liability for
+other Contributors. Therefore, if a Contributor includes the Program in
+a commercial product offering, such Contributor (<code>Commercial
+Contributor</code>) hereby agrees to defend and indemnify every other
+Contributor (<code>Indemnified Contributor</code>) against any losses, damages
+and costs (collectively <code>Losses</code>) arising from claims, lawsuits and
+other legal actions brought by a third party against the Indemnified
+Contributor to the extent caused by the acts or omissions of such
+Commercial Contributor in connection with its distribution of the
+Program in a commercial product offering. The obligations in this
+section do not apply to any claims or Losses relating to any actual or
+alleged intellectual property infringement. In order to qualify, an
+Indemnified Contributor must: a) promptly notify the Commercial
+Contributor in writing of such claim, and b) allow the Commercial
+Contributor to control, and cooperate with the Commercial Contributor
+in, the defense and any related settlement negotiations. The Indemnified
+Contributor may participate in any such claim at its own expense.</p>
+</div>
+<div class="paragraph">
+<p>For example, a Contributor might include the Program in a commercial
+product offering, Product X. That Contributor is then a Commercial
+Contributor. If that Commercial Contributor then makes performance
+claims, or offers warranties related to Product X, those performance
+claims and warranties are such Commercial Contributor’s responsibility
+alone. Under this section, the Commercial Contributor would have to
+defend claims against the other Contributors related to those
+performance claims and warranties, and if a court requires any other
+Contributor to pay any damages as a result, the Commercial Contributor
+must pay those damages.</p>
+</div>
+<h4 id="_5-no-warranty" class="discrete">5. NO WARRANTY</h4>
+<div class="paragraph">
+<p>EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, THE PROGRAM IS PROVIDED
+ON AN <code>AS IS</code> BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,
+EITHER EXPRESS OR IMPLIED INCLUDING, WITHOUT LIMITATION, ANY WARRANTIES
+OR CONDITIONS OF TITLE, NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR
+A PARTICULAR PURPOSE. Each Recipient is solely responsible for
+determining the appropriateness of using and distributing the Program
+and assumes all risks associated with its exercise of rights under this
+Agreement , including but not limited to the risks and costs of program
+errors, compliance with applicable laws, damage to or loss of data,
+programs or equipment, and unavailability or interruption of operations.</p>
+</div>
+<h4 id="_6-disclaimer-of-liability" class="discrete">6. DISCLAIMER OF LIABILITY</h4>
+<div class="paragraph">
+<p>EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, NEITHER RECIPIENT NOR
+ANY CONTRIBUTORS SHALL HAVE ANY LIABILITY FOR ANY DIRECT, INDIRECT,
+INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING
+WITHOUT LIMITATION LOST PROFITS), HOWEVER CAUSED AND ON ANY THEORY OF
+LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OR
+DISTRIBUTION OF THE PROGRAM OR THE EXERCISE OF ANY RIGHTS GRANTED
+HEREUNDER, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.</p>
+</div>
+<h4 id="_7-general" class="discrete">7. GENERAL</h4>
+<div class="paragraph">
+<p>If any provision of this Agreement is invalid or unenforceable under
+applicable law, it shall not affect the validity or enforceability of
+the remainder of the terms of this Agreement, and without further action
+by the parties hereto, such provision shall be reformed to the minimum
+extent necessary to make such provision valid and enforceable.</p>
+</div>
+<div class="paragraph">
+<p>If Recipient institutes patent litigation against any entity (including
+a cross-claim or counterclaim in a lawsuit) alleging that the Program
+itself (excluding combinations of the Program with other software or
+hardware) infringes such Recipient’s patent(s), then such Recipient’s
+rights granted under Section 2(b) shall terminate as of the date such
+litigation is filed.</p>
+</div>
+<div class="paragraph">
+<p>All Recipient’s rights under this Agreement shall terminate if it fails
+to comply with any of the material terms or conditions of this Agreement
+and does not cure such failure in a reasonable period of time after
+becoming aware of such noncompliance. If all Recipient’s rights under
+this Agreement terminate, Recipient agrees to cease use and distribution
+of the Program as soon as reasonably practicable. However, Recipient’s
+obligations under this Agreement and any licenses granted by Recipient
+relating to the Program shall continue and survive.</p>
+</div>
+<div class="paragraph">
+<p>Everyone is permitted to copy and distribute copies of this Agreement,
+but in order to avoid inconsistency the Agreement is copyrighted and may
+only be modified in the following manner. The Agreement Steward reserves
+the right to publish new versions (including revisions) of this
+Agreement from time to time. No one other than the Agreement Steward has
+the right to modify this Agreement. The Eclipse Foundation is the
+initial Agreement Steward. The Eclipse Foundation may assign the
+responsibility to serve as the Agreement Steward to a suitable separate
+entity. Each new version of the Agreement will be given a distinguishing
+version number. The Program (including Contributions) may always be
+distributed subject to the version of the Agreement under which it was
+received. In addition, after a new version of the Agreement is
+published, Contributor may elect to distribute the Program (including
+its Contributions) under the new version. Except as expressly stated in
+Sections 2(a) and 2(b) above, Recipient receives no rights or licenses
+to the intellectual property of any Contributor under this Agreement,
+whether expressly, by implication, estoppel or otherwise. All rights in
+the Program not expressly granted under this Agreement are reserved.</p>
+</div>
+<div class="paragraph">
+<p>This Agreement is governed by the laws of the State of New York and the
+intellectual property laws of the United States of America. No party to
+this Agreement will bring a legal action under this Agreement more than
+one year after the cause of action arose. Each party waives its rights
+to a jury trial in any resulting litigation.</p>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="sec:Acronyms"><a class="anchor" href="#sec:Acronyms"></a><a class="link" href="#sec:Acronyms">Appendix B: Acronyms</a></h2>
+<div class="sectionbody">
+<table id="AC" class="tableblock frame-all grid-all spread language-bash">
+<colgroup>
+<col style="width: 8.3333%;">
+<col style="width: 41.6666%;">
+<col style="width: 8.3333%;">
+<col style="width: 41.6668%;">
+</colgroup>
+<tbody>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>CDep</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Compile-Time Dependency</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>RDep</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Run-Time Dependency</p></th>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>LDep</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Load-Time Dependency</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>IDep</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Initialization-Time Dependency</p></th>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>EDep</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Execution-Time Dependency</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>ANTLR</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">ANother Tool for Language Recognition</p></th>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>API</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Application Programming Interface</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>AST</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Abstract Syntax Tree</p></th>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>ASI</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Automatic Semicolon Insertion</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>BNF</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Backus-Naur Form</p></th>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>CLI</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Command Line Interface (including a headless compiler and runner.)</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>DI</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Dependency Injection</p></th>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>DIC</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">DI Component</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>DOM</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Document Object Model</p></th>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>DSL</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Domain Specific Language</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>EBNF</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Extended Backus-Naur Form</p></th>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>EMF</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Eclipse Modeling Framework <a id="EMF"></a></p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>FQN</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Fully Qualified Name</p></th>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>GLB</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Greatest Lower Bound, also known as <em>infimum</em></p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>GCST</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Greatest Common Sub Type, also known as <em>meet</em></p></th>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>IDE</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Integrated Development Environment</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>IDL</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Interface Definition Language</p></th>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>LSP</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Liskov Substitution Principle [<a href="#Martin96b">Martin96b</a>]</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>LUB</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Least Upper Bound, also known as <em>supremum</em></p></th>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>LCST</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Least Common Super Type, also known as <em>join</em></p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>N4JS</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">N4JS for JavaScript</p></th>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>N4JSED</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">N4JS Environment Definition</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>N4JSIDE</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">N4JS Integrated Development Environment (Eclipse-based IDE for all N4JS related languages and projects)</p></th>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>VM</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Virtual Machine</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>XML</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Extensible Markup Language</p></th>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>XSLT / XSL</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">XSL Transformations</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>XSL</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Extensible Stylesheet Language</p></th>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>WYSIWYG</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">What You See Is What You Get</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>WLOG</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Without loss of generality</p></th>
+</tr>
+</tbody>
+</table>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_bibliography"><a class="anchor" href="#_bibliography"></a><a class="link" href="#_bibliography">Appendix C: Bibliography</a></h2>
+<div class="sectionbody">
+<div class="openblock bibliography">
+<div class="content">
+<div class="paragraph">
+<p><a id="N4JSSpec"></a><em>N4JS Language Specification</em>. </p>
+</div>
+<div class="paragraph">
+<p><a id="Martin96b"></a>Martin, Robert C. (1996). <em>The Liskov Substitution Principle</em>. Retrieved from <a href="http://www.objectmentor.com/publications/lsp.pdf" class="bare">http://www.objectmentor.com/publications/lsp.pdf</a></p>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div id="footer">
+<div id="footer-text">
+Version 0.9<br>
+Last updated 2019-08-07 15:02:40 CEST
+</div>
+</div>
+<!-- ************* docinfo-footer *************************************************************** -->
+<div class="Grid social" style="color:#d5dfea">
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <h2>Quick Links</h2>
+    <ul>
+      <li><a href="../downloads.html">Download</a></li>
+      <li><a href="../userguides/index.html">Documentation</a></li>
+      <li><a href="https://github.com/eclipse/n4js/">Source</a></li>
+      <li><a href="https://github.com/eclipse/n4js/issues">Issues</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="https://www.eclipse.org/forums/index.php/f/365/">Forum</a></li>
+      <li><a href="http://n4js.blogspot.de/">Blog</a></li>
+      <li><a href="https://dev.eclipse.org/mailman/listinfo/n4js-dev">Mailing List</a></li>
+      <li><a href="https://projects.eclipse.org/projects/technology.n4js">Eclipse Project Page</a></li>
+      <li><a href="https://twitter.com/n4jsdev">Tweets by n4jsdev</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="http://www.eclipse.org/">Eclipse Home</a></li>
+      <li><a href="http://www.eclipse.org/legal/privacy.php">Privacy Policy</a></li>
+      <li><a href="http://www.eclipse.org/legal/termsofuse.php">Terms of Use</a></li>
+      <li><a href="http://www.eclipse.org/legal/copyright.php">Copyright Agent</a></li>
+      <li><a href="http://www.eclipse.org/legal/">Legal</a></li>
+    </ul>
+  </div>
+  <div style="clear: both; height: 0; overflow: hidden;"></div>
+</div>
+
+<!-- ************* UI Scripts ************* -->
+<script type="text/javascript" src="scripts/back-to-top.js"></script>
+
+<script type="text/javascript" src="scripts/treeview.js"></script>
+<script type="text/javascript" src="scripts/toc.js"></script>
+
+<!-- ************* Prism.js Syntax Highlighting ************* -->
+<script src="scripts/prism.js"></script>
+
+<script type="text/javascript">
+	// Add the 'toclist' id for search function
+	$(".toc2 > ul").attr('id', 'toclist');
+	// Generate a Search input form
+	$("#toclist > li:first-of-type").before('<input type="text" id="pagesearch" onkeyup="search()" placeholder="Search for section...">');
+	$("#toclist > li:first-of-type").before('<i id="clear" class="fa fa-times-circle-o"></i>');
+	$("#clear").click(function(){
+	    $("#pagesearch").val('');
+	    search();
+	    $('.toc2 > ul').treeView('collapseAll');
+	});
+	// intialize Treeview.js
+	$(".toc2 > ul").treeView();
+	// Initialize Scrollspy
+</script>
+<!-- ************* docinfo-footer *************************************************************** -->
+</body>
+</html>
\ No newline at end of file
diff --git a/idespec/N4JSIDESpec.xml b/idespec/N4JSIDESpec.xml
new file mode 100644
index 0000000..5efd4fc
--- /dev/null
+++ b/idespec/N4JSIDESpec.xml
@@ -0,0 +1,4774 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<?asciidoc-toc maxdepth="5"?>
+<?asciidoc-numbered maxdepth="5"?>
+<book xmlns="http://docbook.org/ns/docbook" xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en">
+<info>
+<title>N4JS IDE Specification</title>
+<date>2019-08-07</date>
+<author>
+<personname>
+<firstname>2019-08-07 15:02:40 CEST</firstname>
+</personname>
+</author>
+<authorinitials>{</authorinitials>
+<style>
+      .admonitionblock td.icon .icon-todo:before{content:"\f249";color:#f4ee42}
+    </style>
+</info>
+<preface>
+<title></title>
+<simpara role="center"><emphasis role="strong">Last Updated: 2019-08-07</emphasis></simpara>
+<simpara role="center"><emphasis role="strong">Authors:</emphasis><?asciidoc-br?>
+Jens von Pilgrim, Jakub Siberski, Mark-Oliver Reiser, Torsten Krämer, Ákos Kitta, Sebastian Zarnekow, Lorenzo Bettini, Jörg Reichert, Kristian Duske, Marcus Mews, Minh Quang Tran, Luca Beurer-Kellner</simpara>
+<simpara><?asciidoc-pagebreak?></simpara>
+<bridgehead xml:id="_abstract" renderas="sect1">Abstract</bridgehead>
+<simpara>This document contains the N4JS IDE Specification.</simpara>
+<bridgehead xml:id="_introduction" renderas="sect1">Introduction</bridgehead>
+<simpara>This document describes the features of the N4JS <link linkend="AC">IDE</link>, that is the user interface and features available to users of the <link linkend="AC">IDE</link>. The language N4JS is described in [<link linkend="N4JSSpec">N4JSSpec</link>] and is not part of this document.</simpara>
+</preface>
+<chapter xml:id="sec:Views">
+<title>Views</title>
+<simpara>This section briefly introduces all the views that belong to the application’s default perspective.</simpara>
+<section xml:id="_eclipse-standard-views">
+<title>Eclipse Standard Views</title>
+<simpara>In the following we descibe views usually available in Eclipse based IDEs. Some of the views were slightly adjusted to match specific N4JS needs.</simpara>
+<section xml:id="sec:Project_Explorer_View">
+<title>Project Explorer</title>
+<simpara>The Project Explorer view shows the resources from the underlying workspace in a hierarchical way. From this view one can open a resource for editing in the associated editor or select it to perform an operation on the resource. A popup contest menu is available from the Project Explorer for each resources if used right clicks any of them. A lot of convenient actions are available for from the popping context menu: file modifications (such as Copy, Cut, Paste and Delete) and import/export. Project Explorer support file system modifications by drag-and-dropping resources. One can link the Project Explorer with the editors, if one enables the view-editor-linking then the node in the tree representing a particular resource in the workspace will be automatically revealed and highlighted once one activates the corresponding editor. This works the other way around as well, when a node is selected in the tree and the corresponding resource is opened in an editor, then the editor will be activated.</simpara>
+</section>
+<section xml:id="sec:Outline_View">
+<title>Outline</title>
+<simpara>The Outline view is responsible for displaying the outline of a structured file that is currently opened in an editor. In case of opening an N4JS file the view depicts all the types defined in the file. The owned members, functions and methods of a particular type are represented in a tree structure. Furthermore in case of opening an N4JS file in the editor, one can link the Outline view with the editor which means whenever one selects a node from the outline view the corresponding item will be revealed and highlighted in the editor.</simpara>
+</section>
+<section xml:id="sec:Problems_View">
+<title>Problems</title>
+<simpara>This view is used to show all validation errors and warnings in a table that are generated for workbench resources such as N4JS files. For instance when one writes and/or saves an N4JS file that contains validation errors and/or warnings those issues will be automatically logged into the Problems view. One can reveal the actual problem in the N4JS by simply double-clicking on the problem in the view. In this case the corresponding N4JS file will be opened (if it was not already opened), activated and the relevant line will be revealed in the editor. By default the grouping in the Problems view is done by the severity of the issues. One can group the issues by issue type or just disable the grouping at all. The first column of the table is the actual description of the issue for a particular resource. The second column names the problematic resource itself. The third column shows the relative path of the problematic resource. The location, fifth, column describes the problematic line in the resource. And last but not least the sixth column is for naming the type of the problem. This is optional and might be missing for some cases. One can customise the content of the view from the view menu. One can limit the number of revealed items in the table or can modify the behaviour of the content provider.</simpara>
+</section>
+<section xml:id="sec:Console_View">
+<title>Console</title>
+<simpara>The Console view is used to reveal a text based output provided by a running process and also allows user to provide any input to the running process from the keyboard.</simpara>
+</section>
+<section xml:id="sec:History_View">
+<title>History</title>
+<simpara>History view supports a way to track the changes of the workbench resources. This view also responsible for providing a convenient way to reveal historical revisions of a particular resource and it is even supports a mechanism to compare two different revisions of a resource. By default this view only provides local historical information but if a resource is under version control then one can retrieve revisions for that particular resource even it was made by remotely by another IDE user.</simpara>
+</section>
+<section xml:id="sec:Error_Log_View">
+<title>Error Log</title>
+<simpara>The Error Log view captures and logs all errors and warnings in a table generated by the application itself. Unlike Problems view the Error Log is responsible to collect and to reveal issues caused by a malfunctioned component or module of the IDE.</simpara>
+</section>
+</section>
+<section xml:id="_n4js-specific-views">
+<title>N4JS Specific Views</title>
+<simpara>The following views are specific to N4JS. Some of these views are useful for developers of the N4JS language itself as they reveal internal details at runtime. Most of these views can be opened via <literal>Windows/Show View/Other..</literal>, see <literal>N4JS</literal> category.</simpara>
+<section xml:id="_test-results">
+<title>Test Results</title>
+<simpara>The N4JS equivalent to the JUnit test view.</simpara>
+</section>
+<section xml:id="_source-graphs">
+<title>Source Graphs</title>
+<simpara>Shows the AST of the current source code in the editor windows.</simpara>
+</section>
+<section xml:id="_api-compare">
+<title>API Compare</title>
+<simpara>Shows compare results, i.e. the difference between an API definition project and its implementation.</simpara>
+</section>
+<section xml:id="_performance-graphs">
+<title>Performance Graphs</title>
+<simpara>Shows some performance measurements of typical tasks such as builds.</simpara>
+</section>
+<section xml:id="_source-mapping">
+<title>Source Mapping</title>
+<simpara>Shows source maps, i.e. the relation between N4JS source code and the generated plain JavaScript code.</simpara>
+</section>
+<section xml:id="_xpect-view">
+<title>Xpect View</title>
+<simpara>Shows result of an Xpext run, may be used to submit bug reports.</simpara>
+</section>
+</section>
+</chapter>
+<chapter xml:id="_navigation">
+<title>Navigation</title>
+<simpara>In this chapter we describe specific views and features to allow for easy navigation.</simpara>
+<section xml:id="sec:Outline_Navigation" role="language-n4js">
+<title>Outline</title>
+<simpara>In general, a outline view and a quick outline are supported. Both outlines work similar, which is why both are specified together. The outline of an N4JS file is a tree which should show the following structure: <anchor xml:id="sec:N4JS_Outline" xreflabel="[sec:N4JS_Outline]"/></simpara>
+<itemizedlist>
+<listitem>
+<simpara>Top-level defined classes, interfaces, roles, enums, functions and exported variables. For all these different types, icons are to be used (similar to JDT). Beside the name, type variables should be shown as well, if defined.</simpara>
+</listitem>
+<listitem>
+<simpara>Members of classifiers are to be shown in the classifier branch. All members (fields, methods, field accessors) are to be shown, with appropriate icons indicating the type (field/member), static flag, access modifier, abstract flag. The icons should look similar to JDT.</simpara>
+</listitem>
+<listitem>
+<simpara>an import declaration should have a node in the outline view, if multiple elements are imported these should represented as child nodes of that import declaration node. If the import uses aliases the original name and the alias name should appear in the outline node text.</simpara>
+</listitem>
+<listitem>
+<simpara>for a non exported function declaration no outline node should be created</simpara>
+</listitem>
+<listitem>
+<simpara>for a non exported variable declaration no outline node should be created</simpara>
+</listitem>
+<listitem>
+<simpara>for a exported variable statement there should be a node in the outline, if this statement contains only one variable declaration the node represents this declaration. For multiple variable declarations in the statement the statement node just is a comma separated list of the variable names and for each variable there is child node</simpara>
+</listitem>
+<listitem>
+<simpara>for fields, functions, methods, getters and variables their declared (return) type should be shown (by adding : typeName after the element name). If the type is inferred then the type name should be presented in a different color</simpara>
+</listitem>
+<listitem>
+<simpara>for functions, methods and setters each formal parameter should be represented by its declared or inferred type (when inferred than with different color)</simpara>
+</listitem>
+<listitem>
+<simpara>constructors are represented by the method icon and a decorator in the top right corner</simpara>
+</listitem>
+<listitem>
+<simpara>enumeration literals are represented with the same decoration as static final fields</simpara>
+</listitem>
+</itemizedlist>
+<simpara>The top-level elements must be sortable either by order in the file (default) or alphabetically.</simpara>
+<section xml:id="_quick-outline">
+<title>Quick Outline</title>
+<simpara>The quick outline supports two modes. The modes are iteratively selected by pressing <keycombo><keycap>CMD/CTRL</keycap><keycap>O</keycap></keycombo>.</simpara>
+<variablelist>
+<varlistentry>
+<term>owned</term>
+<listitem>
+<simpara>This is the default mode, only members directly owned by the type are shown</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>inherited</term>
+<listitem>
+<simpara>In this mode, the owned members are shown including inherited, consumed, or polyfilled members. The origin is also shown and a different color is used to highlight the special status of these members. For usability reasons (limiting the number of filters), inherited, consumed and polyfilled members are treated similarly.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+</section>
+<section xml:id="_normal-outline">
+<title>Normal Outline</title>
+<simpara>In the normal outline view, toggles are used for the same purpose. Visualisations are similar to the quick outline view.</simpara>
+<variablelist>
+<varlistentry>
+<term>inherited</term>
+<listitem>
+<simpara>By default, only owned members of a type are shown. If the "inherited" toggle is active, inherited, consumed, or polyfilled members as well. For usability reasons (limiting the number of filters), inherited, consumed, and polyfilled members are treated similarly.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+<simpara></simpara>
+<sidebar>
+<simpara><link xl:href="https://github.com/eclipse/n4js/issues/99"><inlinemediaobject>
+<imageobject>
+<imagedata fileref="images/issue.svg"/>
+</imageobject>
+<textobject><phrase></phrase></textobject>
+</inlinemediaobject> #99</link></simpara>
+</sidebar>
+<variablelist>
+<varlistentry>
+<term>sorting</term>
+<listitem>
+<simpara>By default, all elements are sorted in the order of their appearance in the source code. If alphabetic sorting is enabled, they are sorted alphabetically.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+<todo>
+<simpara>Potential improvements:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>show decorator when a member overrides and member from a super class / super interface or role</simpara>
+</listitem>
+<listitem>
+<simpara>show object literals and their members in the outline view (just filter <literal>eAllContents</literal> of an element that already has a node in outline view for object literals)</simpara>
+</listitem>
+<listitem>
+<simpara>show function expression in the outline view (just filter <literal>eAllContents</literal> of an element that already has a node in outline view for function expressions)</simpara>
+</listitem>
+</itemizedlist>
+</todo>
+</section>
+</section>
+<section xml:id="_navigation-commands">
+<title>Navigation Commands</title>
+<section xml:id="sec:Navigate_to_Declaration">
+<title>Navigate to Declaration</title>
+<simpara>It is possible to Command-click on almost every reference and jump to its declaration.</simpara>
+</section>
+<section xml:id="sec:find_by_references">
+<title>Find by References</title>
+<simpara>For each referenceable element in an open N4JS file you can click your mouse and invoke the context menu to select <literal>Find references</literal>. Then in the Eclipse search view all found references are displayed as tree: each match is structured by resource path and coarse grained element in the resource (like a method). If there are multiple matches within a method only the first match is linked but in its display string the total match count is shown in brackets.</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>find by references shows the result as tree in the Eclipse search view with having elements that are members or have defined type displayed as nodes</simpara>
+</listitem>
+<listitem>
+<simpara>every found reference is displayed under its nearest parent that is a member or has a defined type</simpara>
+</listitem>
+<listitem>
+<simpara>if there a multiple found references in a node only the first one is displayed (and linked) + the number of all total matches is shown as part of the display string (like in JDT)</simpara>
+</listitem>
+</orderedlist>
+</section>
+<section xml:id="sec:Open_Type_Declaration">
+<title>Open Type Declaration</title>
+<simpara>One can quickly browse the workbench for available types. The declaration of the types can be opened in editor from this dialog. The N4JS type search dialog can be raised with the <keycap>Cmd</keycap> + <keycap>Shift</keycap> + <keycap>T</keycap> key binding (<keycap>Ctrl</keycap> + <keycap>Shift</keycap> + <keycap>T</keycap> on Windows and Linux systems).</simpara>
+<itemizedlist>
+<listitem>
+<simpara>Enter <emphasis role="strong">exact type name</emphasis>, prefix name or a camel case pattern to run a query against the types. The following rules and patterns are supported.</simpara>
+<itemizedlist>
+<listitem>
+<simpara><emphasis role="strong">Wildcards</emphasis>: <literal>?</literal>  for any character and <literal>*</literal> for any string.</simpara>
+</listitem>
+<listitem>
+<simpara><emphasis role="strong">Camel case</emphasis>: <literal>DM</literal>  will return with all types that contains <literal>D</literal> and <literal>M</literal> with the given order such as <literal>DataMap</literal> and <literal>DataMapEntry</literal> but not <literal>ImmutableDataMap</literal>.</simpara>
+<simpara><literal>AcBuGr</literal> will return with all types that contain <literal>Ac</literal>, <literal>Bu</literal> and <literal>Gr</literal> with the given order such as <literal>ActionButtonGroup</literal>.</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+<listitem>
+<simpara><emphasis role="strong">Highlighting</emphasis>: The matching types names are highlighted according to the matching parts.</simpara>
+</listitem>
+<listitem>
+<simpara><emphasis role="strong">Decorator</emphasis> for duplicate type names: The internally used fully qualified name of the type will be appended to the type name automatically, so one can easily distinguish between types even there are type name collision.</simpara>
+</listitem>
+<listitem>
+<simpara><emphasis role="strong">Opening types in editor</emphasis>: Type declarations can be opened in the editor in the following ways: after entering the type name prefix or pattern to the filter text one can navigate among the filtered items with the up and/or down arrow keys. Simply hitting return on the keyboard or clicking on the ’OK’ button the currently selected declaration of the selected type will be opened in the editor. For opening multiple type declarations one can use the <keycap>Shift</keycap>  modifier to select more than one element. Single type can be opened with double clicking on it in the dialog.</simpara>
+</listitem>
+<listitem>
+<simpara><emphasis role="strong">History</emphasis>: Once a type is being opened then it will be available among the recently opened type in the type search dialog. These items will show up in the upper part of the list in the dialog.</simpara>
+</listitem>
+</itemizedlist>
+</section>
+</section>
+<section xml:id="sec:Working_Sets" role="language-bash">
+<title>Working Sets</title>
+<simpara>Working sets are used to logically group resources, projects in the Project Explorer (navigator) and in the UI in general. Although a couple of projects can be easily handled and shown without any sophisticated working set support in the navigator, larger code sources consisting of multiple projects could cause some trouble when one has to maintain them. Indeed one could use multiple workspaces and could switch between them or can simply manually open-close relevant projects, but this gets cumbersome too.</simpara>
+<simpara>This section describes the general design of the N4JS specific working set support and also introduces a couple of use cases while enumerating the constraints.</simpara>
+<section xml:id="sec:Working_Set_Managers">
+<title>Working Set Managers</title>
+<simpara>Just like the JDT (<literal>org.eclipse.jdt.internal.ui.workingsets.WorkingSetModel</literal>) based working set support, the N4JS IDE based approach is also aware of the <literal>org.eclipse.ui.IWorkingSet</literal> and the <literal>org.eclipse.ui.IWorkingSetManager</literal> APIs but besides simply using them it comes with its own implementation and adapts it to the default Eclipse based one, furthermore it also comes with an Eclipse extension point based mechanism to support various working set managers at the same time to provide even better user experience and a more convenient way of working set management.</simpara>
+<simpara>A working set manager can be contributed to the IDE via the <literal>org.eclipse.n4js.ui.workingSetManager</literal> extension point, then the implementation class must implement the <literal>org.eclipse.n4js.ui.workingsets.WorkingSetManager</literal> interface but it is highly recommended to rather extend the <literal>org.eclipse.n4js.ui.workingsets.WorkingSetManagerImpl</literal> class. Guice based dependency injection should also be considered when implementing the custom working set manager. It means that each custom working set manager implementation must have a public <emphasis>no-args</emphasis> constructor. This <emphasis>no-args</emphasis> constructor will be invoked when creating the instances via <literal>IConfigurationElement#createExecutableExtension(String)</literal> method. Then the members, if any will be injected by the working set manager broker. Below <literal>plugin.xml</literal> snippet describes how to contribute a custom working set manager to the IDE.</simpara>
+<programlisting language="xml" linenumbering="unnumbered">   &lt;extension
+         point="org.eclipse.n4js.ui.workingSetManager"&gt;
+      &lt;manager
+            class="some.package.name.MyExecutableExtensionFactory:some.package.name.MyWorkingSetManager"&gt;
+      &lt;/manager&gt;
+   &lt;/extension&gt;</programlisting>
+<simpara>By default the N4JS IDE comes with five different built-in working set managers. These are the followings:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>Manual Association Working Set Manager,</simpara>
+</listitem>
+<listitem>
+<simpara>Project Name Filter Working Set Manager,</simpara>
+</listitem>
+<listitem>
+<simpara>Git Repository Working Set Manager,</simpara>
+</listitem>
+<listitem>
+<simpara>Project Location Working Set Manager and</simpara>
+</listitem>
+<listitem>
+<simpara>N4JS Project Type Working Set Manager.</simpara>
+</listitem>
+</itemizedlist>
+<simpara>The benefits and the details of each built-in working set managers will be discussed in later sections but first we have to distinguish between three conceptually different working set manager approaches.</simpara>
+<simpara>First off, IDE supports fully static working set managers. Fully static working set managers might manage any arbitrary number of working sets, and each working set might be associated with any number of Eclipse projects. That means, user might create, edit and remove working sets and manually associate projects with individual working sets. One project might belong to multiple working sets. There is a dedicated working set, <emphasis>Other Projects</emphasis>, that cannot be renamed and/or deleted. When no user defined working sets are available this dedicated working set will be still available. IDE comes with one single fully static working set manager: <emphasis>Manual Association Working Set Manager</emphasis>.</simpara>
+<simpara>The second kind of working set manager is the semi-dynamic one. That means, user can create, modify and delete working sets, but the associations between the projects and the working sets are automatic. This means, the user might define a working set - project association rule, and the projects will be automatically associated with the working sets. Just like in the above kind, one project might belong to multiple working sets and here as well, there is a dedicated working set manager, that cannot be modified: <emphasis>Other Projects</emphasis>. IDE comes with one semi-dynamic working set manager. That is the <emphasis>Project Name Filter Working Set Manager</emphasis>. User might define a project name filter rule with a regular expression, and each project which name matches a pattern will be associated with the working set. If a project does not comply to any working set manager rule, then it will belong to the <emphasis>Other Projects</emphasis> working set.</simpara>
+<simpara>The third kind of working set manager is the fully-dynamic working set manager. Both the working sets and the project associations are done by some implementation specific rules. Such as Git repository provider based, or project location based approaches. These working set managers have the dedicated <emphasis>Other Projects</emphasis> working set that is used as a fallback working set. For instance, if the <emphasis>Git Repository Working Set Manager</emphasis> is the active one, all projects that are shared with Git will belong to the corresponding working set manager but if a project is not yet a shared project, then it will belong to the dedicated fallback working set. As always that working set manager cannot be deleted and/or modified.</simpara>
+</section>
+<section xml:id="sec:Working_Set_Constraints">
+<title>Working Set Constraints</title>
+<simpara>This section enumerates a set of constraints that have to considered by both end users and implementors:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>Working set manager identifier must be unique.</simpara>
+</listitem>
+<listitem>
+<simpara>The identifier of the working set manager must be unique per container working set managers.</simpara>
+</listitem>
+<listitem>
+<simpara>Each working set must have a working set with <emphasis>Other Projects</emphasis> unique ID and name.</simpara>
+</listitem>
+<listitem>
+<simpara>Working sets with <emphasis>Other Projects</emphasis> unique ID must not be editable nor deletable.</simpara>
+</listitem>
+<listitem>
+<simpara>At least one working set should be visible (not hidden) per working set managers.</simpara>
+</listitem>
+<listitem>
+<simpara>Working set managers are activated when the <emphasis>Working Sets</emphasis> are configured as <emphasis>Top Level Elements</emphasis> in the <emphasis>Project Explorer</emphasis>.</simpara>
+</listitem>
+<listitem>
+<simpara>Working set order can be specified and customized by the user if it is not specified yet, then a case sensitive ordering based on the working set names should be applied.</simpara>
+</listitem>
+</itemizedlist>
+</section>
+<section xml:id="sec:Manual_Association_Working_Set_Manager_UI_Features">
+<title>Manual Association Working Set Manager - UI Features</title>
+<simpara>This section describes the working set manager by introducing the UI capabilities as well.</simpara>
+<simpara>This working set manager is a fully static working set manager and activated and used as the default one when the working set manager support is turned on in the IDE. With this working set manager one can create a new working set by simply defining a unique name for the working set and associating any number of workspace project to the working set. Furthermore existing working sets can be modified and deleted but the <emphasis>Other Projects</emphasis> working set. The working set support can be turned on in the <emphasis>Project Explorer</emphasis> view. Via the view menu one has to select <emphasis>Top Level Elements</emphasis> <emphasis>&gt;</emphasis> <emphasis>Working Sets</emphasis> menu item.</simpara>
+<figure role="center">
+<title>Activate Working Set Managers</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/04_navigation/fig/activate_working_set_managers.png" width="50%" scalefit="1" align="center"/>
+</imageobject>
+<textobject><phrase>Activate_Working_Set_Managers</phrase></textobject>
+</mediaobject>
+</figure>
+<simpara>After the working set manager mode activation, a new toolbar contribution item become visible and user can select among the available working set managers.</simpara>
+<figure role="center">
+<title>Select Working Set Manager</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/04_navigation/fig/select_working_set_manager_01.png" width="50%" scalefit="1" align="center"/>
+</imageobject>
+<textobject><phrase>Select_Working_Set_Manager</phrase></textobject>
+</mediaobject>
+</figure>
+<simpara>As the below picture depicts the available working set managers are listed and the currently active manager is marked with a check. In our case that is the <emphasis>Manual Association Working Set Manager</emphasis>.</simpara>
+<figure role="center">
+<title>Activate Working Set Manager</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/04_navigation/fig/select_working_set_manager_02.png" width="25%" scalefit="1" align="center"/>
+</imageobject>
+<textobject><phrase>Activate_Working_Set_Manager</phrase></textobject>
+</mediaobject>
+</figure>
+<simpara>Once the the <emphasis>Configure Manual Association&#8230;&#8203;</emphasis> menu item is selected, the working set manager configuration dialog pops up. By clicking on the <emphasis>New&#8230;&#8203;</emphasis> button in the configuration dialog, a new working set wizard will be invoked and the manual working set - project association can be configured.</simpara>
+<figure role="center">
+<title>Configure Working Sets</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/04_navigation/fig/configure_working_sets_01.png" width="25%" scalefit="1" align="center"/>
+</imageobject>
+<textobject><phrase>Configure_Working_Sets</phrase></textobject>
+</mediaobject>
+</figure>
+<simpara>In the wizard after specifying the desired unique name of the working set an arbitrary number of workspace projects can be associated with the working set. It is important to note, that a project can be associated with more than one working sets. If a project is not associated with any working sets then it will be automatically linked to the fallback <emphasis>Other Projects</emphasis> working set.</simpara>
+<figure role="center">
+<title>Working Set - Projects Association</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/04_navigation/fig/working_set_project_association.png" width="50%" scalefit="1" align="center"/>
+</imageobject>
+<textobject><phrase>Configure_Working_Set_Project_Association</phrase></textobject>
+</mediaobject>
+</figure>
+<simpara>Once all the changes made are confirmed and the configuration dialog is closed via the <emphasis>OK</emphasis> button, the <emphasis>Project Explorer</emphasis> will be refreshed and will reflect the working set changes.</simpara>
+<figure role="center">
+<title>Custom Working Sets In Project Explorer</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/04_navigation/fig/working_sets_in_navigator.png" width="25%" scalefit="1" align="center"/>
+</imageobject>
+<textobject><phrase>Custom_Working_Sets_In_Project_Explorer</phrase></textobject>
+</mediaobject>
+</figure>
+<simpara>The order of the working sets can be configured and customized in the working set manager configuration dialog, or just simply reordering it from the navigator itself by drag and dropping the available working set managers.</simpara>
+<figure role="center">
+<title>Re-ordering Working Sets In Project Explorer</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/04_navigation/fig/working_set_reorder.png" width="25%" scalefit="1" align="center"/>
+</imageobject>
+<textobject><phrase>Re_Ordering_Working_Sets_In_Project_Explorer</phrase></textobject>
+</mediaobject>
+</figure>
+<simpara>Besides changing the order of the working sets, working sets can be hidden from the navigator. Just like the ordering, this can be changed from the working set configuration dialog, or by simply selecting working sets in the navigator and hiding them via <emphasis>Hide Selected Working Set</emphasis> menu item. Important to note, at least one working set should be visible in the navigator, so if all the working sets are selected in the navigator, then the menu item will be disabled. Same behavior in the working set customization dialog, if all items are unchecked, then the <emphasis>OK</emphasis> button is disabled in the dialog.</simpara>
+<figure role="center">
+<title>Hide Working Sets In Project Explorer</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/04_navigation/fig/working_set_hide.png" width="25%" scalefit="1" align="center"/>
+</imageobject>
+<textobject><phrase>Hide_Working_Sets_In_Project_Explorer</phrase></textobject>
+</mediaobject>
+</figure>
+<simpara>Once at least one working set is hidden from the UI, then a new toolbar contribution become visible in the <emphasis>Project Explorer</emphasis>. This UI contribution provides a quick, convenient way to show a specific or all hidden working sets in the navigator. It is worth to note, if a project is automatically associated with the <emphasis>Other Projects</emphasis> working set (because it does not belong to any working sets due to the lack of manual association) it will be not shown in the navigator if the <emphasis>Other Projects</emphasis> working set is hidden. Once all working sets are visible, indeed the <emphasis>Show Hidden Working Sets</emphasis> toolbar contribution become invisible.</simpara>
+<figure role="center">
+<title>Show Hidden Working Sets In Project Explorer</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/04_navigation/fig/working_set_show.png" width="25%" scalefit="1" align="center"/>
+</imageobject>
+<textobject><phrase>Show_Hidden_Working_Sets_In_Project_Explorer</phrase></textobject>
+</mediaobject>
+</figure>
+<simpara>Besides the above described generic working set UI support, projects can be associated with working sets by simply drag and dropping them from one working set into another. Note, this is only supported for the <emphasis>Manual Association Working Set Manager</emphasis>.</simpara>
+</section>
+<section xml:id="sec:Project_Name_Filter_Working_Set_Manager">
+<title>Project Name Filter Working Set Manager</title>
+<simpara>As mentioned earlier, this working set is a semi-dynamic working set. The working sets can be created, edited and deleted by the user by simply specifying project name filter pattern as valid regular expressions but the project association itself is fully automatic. If the name of a project does not match with any project name filter rule, then the project will be associated with the <emphasis>Other Projects</emphasis> working set. Although reordering the working sets from the navigator by simple drag and dropping them is supported, project association is disabled.</simpara>
+</section>
+<section xml:id="sec:Git_Repository_Working_Set_Manager">
+<title>Git Repository Working Set Manager</title>
+<simpara>This working set is a fully-dynamic working set. Projects will be associated by the Git providers. It means, if a project is imported from a pre-configured local Git repository, then the project will be associated with the working set linked with the Git repository. The subset of the available working sets is become automatically updated once the Git repository preferences changed by the user. These preferences can be changed on the <emphasis>Git</emphasis> perspective in the <emphasis>Git Repositories</emphasis> view by simple adding or hiding/removing a repository from the view.</simpara>
+</section>
+<section xml:id="sec:Project_Location_Working_Set_Manager">
+<title>Project Location Working Set Manager</title>
+<simpara>This fully-dynamic working set manager calculates the subset of available working sets based on the parent folder of the projects. The benefit of this working set manager is to support the convention recommended by the maven/Git folder structuring. The following constraints are applied when associating the projects with the available working sets:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>If a project is located in the root of the Eclipse workspace, then it will be associated with <emphasis>Other Projects</emphasis> working set.</simpara>
+</listitem>
+<listitem>
+<simpara>If a project is nested somewhere in the Eclipse workspace, then it will be associated with a working set that has the same name as the parent folder of the project. Let assume the Eclipse workspace root points to <literal>/eclipse/root</literal> and there is a project <literal>P1</literal> nested in the workspace root at <literal>/eclipse/root/path/to/nested/location/P1</literal>, then the associated working set will be <literal>location</literal>.</simpara>
+</listitem>
+<listitem>
+<simpara>If a project is not contained in the workspace, but has a Git provider that is configured in IDE, and the project root is the local Git repository root, then the associated working set name will be the name of the Git repository. For example, if we have Eclipse workspace root pointing to <literal>/eclipse/root</literal> location and a <literal>P2</literal> project located <literal>/some/path/to/git/P2</literal> but this location is the location of a registered Git repository, then the name of the associated working set will be neither <literal>Other Projects</literal> not <literal>git</literal> but <literal>P2</literal> since that is known Git local repository root.</simpara>
+</listitem>
+<listitem>
+<simpara>If project <literal>P3</literal> is not contained in the Eclipse workspace but contained in a known local Git repository just like above, but the project root is not the local Git repository root, then the name of the parent folder will be considered as the name of the associated working set. This rule is a hybrid alternative of the second and the third constraints, hence for instance if the project is under <literal>/some/path/to/git/repositoryName/plugins/P3</literal> and <literal>repositoryName</literal> is local git repository, then the name of the associated working set will be <literal>plugins</literal> and not <literal>repositoryName</literal>.</simpara>
+</listitem>
+<listitem>
+<simpara>Else the associated working set will be the <emphasis>Other Projects</emphasis> fallback working set.</simpara>
+</listitem>
+</itemizedlist>
+</section>
+<section xml:id="sec:N4JS_Project_Type_Working_Set_Manager">
+<title>N4JS Project Type Working Set Manager</title>
+<simpara>This is working set manager is a N4JS specific fully-dynamic working set manager. The working sets will be calculated based on the instances defined by the <literal>org.eclipse.n4js.n4mf.ProjectType</literal> type. Each accessible N4JS project will be associated to a working set based on the project type. A workspace project will be associated with the <emphasis>Other Projects</emphasis> fallback working set if any of the followings are true to the project:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>The project is not accessible. (It does not exist or is not opened.)</simpara>
+</listitem>
+<listitem>
+<simpara>The project does not configured with <emphasis>Xtext</emphasis> nature.</simpara>
+</listitem>
+<listitem>
+<simpara>The project does not have an <emphasis>Xtext</emphasis> builder command ID.</simpara>
+</listitem>
+<listitem>
+<simpara>The project does not have a valid N4 manifest file.</simpara>
+</listitem>
+</itemizedlist>
+</section>
+</section>
+</chapter>
+<chapter xml:id="_assistance">
+<title>Assistance</title>
+<simpara>In this chapter we describe all kind of tools assisting the user when writing code, i.e. content assist, quickfixes, quick assists, etc.</simpara>
+<warning>
+<simpara>Not all features are yet implemented!</simpara>
+</warning>
+<section xml:id="sec:Content_Assist" role="language-n4js">
+<title>Content Assist</title>
+<simpara>Content assist may change the document at various places at once. In those cases, it is important to prevent flickering in the editor. The FQNImporter provides a blue print how to adjust line numbers properly and scroll the viewport of the current editor to minimize flickering in the UI.</simpara>
+<simpara>Completions not listed here as they are provided by template proposals:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>Classifier declaration template proposal</simpara>
+</listitem>
+<listitem>
+<simpara>Function declaration template proposal</simpara>
+</listitem>
+<listitem>
+<simpara>Getter/Setter pair template proposal</simpara>
+</listitem>
+</orderedlist>
+<section xml:id="sec:Complete_Keywords">
+<title>Complete Keywords</title>
+<simpara>Complete keyword which are syntactically correct at a given location. Do not suggest completions which would lead to wrong code.</simpara>
+<simpara>Keywords that contain only a single character are not proposed since they would pollute the proposal window and don’t offer added value.</simpara>
+<simpara>Special attention has to be given to operators. Since they are modelled in the grammar and not as cross references, their validaty is purely syntactically. That is, there is no generic facility in Xtext, that allows to filter unapplicable operators as there is for cross references.</simpara>
+</section>
+<section xml:id="sec:Complete_Annotations">
+<title>Complete Annotations</title>
+<simpara>Annotations can be proposed depending on the following elements or the context.</simpara>
+</section>
+<section xml:id="sec:Complete_Identifier_Reference">
+<title>Complete Identifier Reference</title>
+<simpara>References to identifiers can be automatically completed. This is even true if the declaration is not imported yet, as the import may be automatically added as well.</simpara>
+<simpara>The IDE supports auto-completion of an identifier referencing to a declaration.</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>Complete type references.</simpara>
+</listitem>
+<listitem>
+<simpara>Complete function references.</simpara>
+</listitem>
+<listitem>
+<simpara>Complete variable references.</simpara>
+</listitem>
+<listitem>
+<simpara>Complete parameter references.</simpara>
+</listitem>
+<listitem>
+<simpara>If necessary, imports are added automatically to complete reference <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>r</mi></math> to declaration <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>D</mi></math>.</simpara>
+<variablelist>
+<varlistentry>
+<term>Precondition</term>
+<listitem>
+<simpara>-</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>Postcondition</term>
+<listitem>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mi>b</mi><mi>i</mi><mi>n</mi><mi>d</mi><mfenced close=")" open="("><mi>r</mi><mi>D</mi></mfenced></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mo>⇔</mo></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mi>r</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><mi>D</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mi>D</mi><mo>∈</mo><mi>r</mi><mo>.</mo><mi>m</mi><mi>o</mi><mi>d</mi><mi>u</mi><mi>l</mi><mi>e</mi></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mo>⊕</mo></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mo>∃</mo><mstyle mathvariant="monospace"><mtext>NamedImportSpecifier</mtext></mstyle><mi>N</mi><mi>I</mi><mi>S</mi><mi>:</mi></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mi>W</mi><mi>I</mi><mi>S</mi><mo>.</mo><mi>i</mi><mi>m</mi><mi>p</mi><mi>o</mi><mi>r</mi><mi>t</mi><mi>D</mi><mi>e</mi><mi>c</mi><mi>l</mi><mo>.</mo><mi>i</mi><mi>m</mi><mi>p</mi><mi>o</mi><mi>r</mi><mi>t</mi><mi>e</mi><mi>d</mi><mi>M</mi><mi>o</mi><mi>d</mi><mi>u</mi><mi>l</mi><mi>e</mi><mo>=</mo><mi>D</mi><mo>.</mo><mi>m</mi><mi>o</mi><mi>d</mi><mi>u</mi><mi>l</mi><mi>e</mi></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mo>∨</mo><mo>∃</mo><mstyle mathvariant="monospace"><mtext>WildcardImportSpecifier</mtext></mstyle><mi>W</mi><mi>I</mi><mi>S</mi><mi>:</mi></math></simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>Description</term>
+<listitem>
+<simpara>There might be multiple declarations <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>D</mi></math> in project (or in dependent projects) with <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>D</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><mi>r</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi></math>. If the declaration <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>D</mi></math> is not local, then a named import may be created by the content assist:</simpara>
+<orderedlist numeration="loweralpha">
+<listitem>
+<simpara>If the declaration <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>D</mi></math> is local, no import is created</simpara>
+</listitem>
+<listitem>
+<simpara>If an import enabling access to the declaration already exists, no other import is created.</simpara>
+</listitem>
+<listitem>
+<simpara>If an alias already exists, the alias name is used, even if the prefix was different when the content assist was activated.</simpara>
+</listitem>
+<listitem>
+<simpara>If the import would conflict with an existing member, an alias is proposed along with the import. Linked editing helps to choose a proper alias.</simpara>
+</listitem>
+<listitem>
+<simpara>All imports from a single module are done within a single import declaration. The exception to this rule are wildcard imports that provide a simple name which is currently unused. In that case, a new import may be necessary to disambiguate the wildcard.</simpara>
+</listitem>
+</orderedlist>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+<listitem>
+<simpara>If the identifier reference refers to a function (or method), an opening and a closing parenthesis are appended and
+the cursor is positioned between these two parentheses.</simpara>
+</listitem>
+</orderedlist>
+</section>
+<section xml:id="sec:Complete_Member_Overrides">
+<title>Complete Member Overrides</title>
+<simpara>A prefix of an inherited member can be used to autocomplete that to a complete declaration.
+This is in particular true for methods.</simpara>
+</section>
+<section xml:id="sec:Constructor_Completion">
+<title>Constructor Completion</title>
+<simpara>Constructor Completion Based on the declared fields and super constructor, constructor methods can be completed.</simpara>
+</section>
+<section xml:id="sec:Complete_Function_Expression">
+<title>Complete Function Expression with Known Type</title>
+<simpara>If a function expression is used as an argument or assigned to a typed variable, the signature of the function can be derived from the type. This can be used to complete a function expression.</simpara>
+</section>
+<section xml:id="sec:Complete_Variable_and_Parameter_Names">
+<title>Complete Variable and Parameter Names</title>
+<simpara>Variable and parameter names can be completed based on the type. Camel case detection is used to propose different variations.</simpara>
+<simpara>Completion of variables references see <link linkend="sec:Complete_Identifier_Reference">Complete Identifier Reference</link>.</simpara>
+</section>
+</section>
+<section xml:id="sec:Quick_Fixes" role="language-n4js">
+<title>Quick Fixes</title>
+<simpara>Quick fixes try to solve issues, i.e. errors or warnings, automatically. This is done by rewriting code, either at the location of the issue or at referenced locations.</simpara>
+<simpara>In all cases, a quick fix must only be suggested if the following preconditions are fulfilled:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>All locations at which modifications have to be done must be writeable.</simpara>
+</listitem>
+<listitem>
+<simpara>If bindings are involved, e.g., names are to be changed, all previous bindings must remain similar. This might be more complicated as it seems!</simpara>
+</listitem>
+</orderedlist>
+<section xml:id="sec:N4JS_Issue_Properties">
+<title>N4JS Issue User data</title>
+<simpara>As some quick fixes need more information to decide upfront which strategy to use, some issues provide additional data. These properties are defined in the file <literal>IssueUserDataKeys.java</literal> in the <literal>org.eclipse.n4js.validation</literal> package. They can for example be accessed by passing the according key to the <literal>getUserData</literal> method of an <literal>N4JSIssue</literal> instance. They are also available as array based Xtext Issue user data.<?asciidoc-br?></simpara>
+<simpara>All available user data keys are described for each Issue code in <link linkend="sec:N4JS_Issue_Fixes">N4JS Issue Fixes</link>.</simpara>
+</section>
+<section xml:id="sec:N4JS_Issue_Fixes">
+<title>N4JS Issue Fixes</title>
+<simpara>The principle idea is to provide a quick fix for every issue, if it is possible to automatically solve it.</simpara>
+<section xml:id="sec:Linking_Issues">
+<title>Linking Issues</title>
+<simpara>Linking issues are special in that they are created by the standard Xtext linker and use all the same built-in issue code <literal>Diagnostic.LINKING_DIAGNOSTIC</literal>. Therefore, we cannot refer to these issues using one of our custom N4JS issue codes.</simpara>
+<variablelist>
+<varlistentry>
+<term>Diagnostic.LINKING_DIAGNOSTIC</term>
+<listitem>
+<simpara><literal>Couldn’t resolve reference to <emphasis>n</emphasis></literal></simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>Add missing import declaration for unresolved name <emphasis>n</emphasis>.</simpara>
+</listitem>
+</orderedlist>
+</listitem>
+</varlistentry>
+</variablelist>
+<informaltable tabstyle="horizontal" frame="none" colsep="0" rowsep="0">
+<tgroup cols="2">
+<colspec colwidth="15*"/>
+<colspec colwidth="85*"/>
+<tbody valign="top">
+<row>
+<entry>
+<simpara>Precondition</simpara>
+</entry>
+<entry>
+<orderedlist numeration="loweralpha">
+<listitem>
+<simpara>An exported identifiable element <emphasis>e</emphasis> with name <emphasis>n</emphasis> exists in another module <emphasis>m</emphasis>.</simpara>
+</listitem>
+<listitem>
+<simpara><emphasis>e</emphasis> is visible from the given location.</simpara>
+</listitem>
+</orderedlist>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Label</simpara>
+</entry>
+<entry>
+<simpara><literal>Import <emphasis>n</emphasis> - <emphasis>m</emphasis></literal></simpara>
+<variablelist>
+<varlistentry>
+<term>Postcondition</term>
+<listitem>
+<simpara>An import declaration was added such that name <emphasis>n</emphasis> is now resolvable at the given location and bound to <emphasis>e</emphasis>.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>Description</term>
+<listitem>
+<simpara>Some important notes:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara><literal>A</literal> separate quick fix is proposed for each candidate element instead of having a single generic quick fix for adding imports and showing a dialog later (for example, create two quick fixes “Import class <literal>X</literal> from module M1" and “Import interface <literal>X</literal> from module M2" instead of a single quick fix “Add import for name X").<?asciidoc-br?>
+This is unusual for quick fixes, because it means significant work has to be done upfront when creating the quick fix / modification proposals, which raises performance concerns. However,</simpara>
+<orderedlist numeration="loweralpha">
+<listitem>
+<simpara>the JDT handles this the same way and</simpara>
+</listitem>
+<listitem>
+<simpara>this brings the implementation closer to content assist allowing more reuse, therefore this decision was taken.</simpara>
+</listitem>
+</orderedlist>
+</listitem>
+<listitem>
+<simpara>For consistency, matching of lower/upper/camel case is to be handled as in code completion during content assist. The same applies to display string formatting, esp. name formatting and coloring of element <emphasis>e</emphasis> and module <emphasis>m</emphasis>.</simpara>
+</listitem>
+<listitem>
+<simpara>Note that here we can make more assumptions than during import as part of content assist. For example, we know that the element is not imported yet (otherwise there would not be an error) and there won’t be a need for an alias and linked editing.</simpara>
+</listitem>
+</orderedlist>
+</listitem>
+</varlistentry>
+</variablelist>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+</section>
+<section xml:id="sec:Import_Issues">
+<title>Import Issues</title>
+
+</section>
+<section xml:id="sec:Visibility_Issues">
+<title>Visibility Issues</title>
+<variablelist>
+<varlistentry>
+<term>VIS_ILLEGAL_MEMBER_ACCESS</term>
+<listitem>
+<simpara><literal>The <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>m</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi></math> <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>m</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi></math> is not visible.</literal></simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>Change access modifier to protected/public or remove <literal>@Internal</literal> annotation.</simpara>
+<variablelist>
+<varlistentry>
+<term>Precondition</term>
+<listitem>
+<simpara>The file containing the declaration of <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>m</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi></math> is modifiable</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>Postcondition</term>
+<listitem>
+<simpara>The access modifier has been changed so that <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>m</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi></math> is visible at issue location.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>User Data</term>
+<listitem>
+<itemizedlist>
+<listitem>
+<simpara><emphasis role="strong">ACCESS_SUGGESTION</emphasis> The most restrictive modifier making the member visible.</simpara>
+</listitem>
+<listitem>
+<simpara><emphasis role="strong">DECLARATION_OBJECT_URI</emphasis> The EObject URI of the member declaration</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</orderedlist>
+</listitem>
+</varlistentry>
+</variablelist>
+<simpara>This table shows the access modifier changes to perform to fix the visibility issue while maintaining the strongest access restrictions possible.</simpara>
+<informaltable frame="all" rowsep="1" colsep="1">
+<tgroup cols="7">
+<colspec colname="col_1" colwidth="14.2857*"/>
+<colspec colname="col_2" colwidth="14.2857*"/>
+<colspec colname="col_3" colwidth="14.2857*"/>
+<colspec colname="col_4" colwidth="14.2857*"/>
+<colspec colname="col_5" colwidth="14.2857*"/>
+<colspec colname="col_6" colwidth="14.2857*"/>
+<colspec colname="col_7" colwidth="14.2858*"/>
+<tbody>
+<row>
+<entry align="center" valign="top" morerows="1"><simpara><literal>Access Modifier</literal></simpara></entry>
+<entry align="center" valign="top" namest="col_2" nameend="col_7"><simpara><literal>Accessible From</literal></simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><literal>Inside Module</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>Inside Project</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>Vendor Subtypes</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>Vendor Projects</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>Other Subtypes</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>Everywhere</literal></simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><literal>private</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>-</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>project</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>protected@Internal</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>public@Internal</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>protected</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>public</literal></simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><literal>project</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>-</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>-</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>protected@Internal</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>public@Internal</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>protected</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>public</literal></simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><literal>protected@Internal</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>-</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>-</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>-</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>public@Internal</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>protected</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>public</literal></simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><literal>protected</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>-</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>-</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>-</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>public@Internal</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>-</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>public</literal></simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><literal>public@Internal</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>-</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>-</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>-</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>-</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>public</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>public</literal></simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><literal>public</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>-</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>-</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>-</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>-</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>-</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>-</literal></simpara></entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+<simpara>Member access modifier changes for quick fixes</simpara>
+<variablelist>
+<varlistentry>
+<term>VIS_ILLEGAL_FUN_ACCESS</term>
+<listitem>
+<simpara><literal>The function <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>f</mi></math> is not visible.</literal></simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>Change access modifier to protected/public or remove <literal>@Internal</literal> annotation.</simpara>
+<variablelist>
+<varlistentry>
+<term>Precondition</term>
+<listitem>
+<simpara>–</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>Postcondition</term>
+<listitem>
+<simpara>The access modifier has been changed so that <emphasis>f</emphasis> is visible at issue location.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>User Data</term>
+<listitem>
+<itemizedlist>
+<listitem>
+<simpara><emphasis role="strong">ACCESS_SUGGESTION</emphasis> The most restrictive modifier making the function visible.</simpara>
+</listitem>
+<listitem>
+<simpara><emphasis role="strong">DECLARATION_OBJECT_URI</emphasis> The EObject URI of the function declaration</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</orderedlist>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>VIS_ILLEGAL_TYPE_ACCESS</term>
+<listitem>
+<simpara><literal>The type <emphasis>T</emphasis> is not visible.</literal></simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>Change access modifier to protected/public or remove <literal>@Internal</literal> annotation.</simpara>
+<variablelist>
+<varlistentry>
+<term>Precondition</term>
+<listitem>
+<simpara>–</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>Postcondition</term>
+<listitem>
+<simpara>The access modifier has been changed so that <emphasis>T</emphasis> is visible at issue location.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>User Data</term>
+<listitem>
+<simpara>see VIS_ILLEGAL_FUN_ACCESS</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</orderedlist>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>VIS_ILLEGAL_VARIABLE_ACCESS</term>
+<listitem>
+<simpara><literal>The variable <emphasis>v</emphasis> is not visible.</literal></simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>Change access modifier to protected/public or remove <literal>@Internal</literal> annotation.</simpara>
+<variablelist>
+<varlistentry>
+<term>Precondition</term>
+<listitem>
+<simpara>Module containing <emphasis>v</emphasis> is writeable.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>Postcondition</term>
+<listitem>
+<simpara>The access modifier has been changed so that <emphasis>v</emphasis> is visible at issue location.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>User Data</term>
+<listitem>
+<simpara>see VIS_ILLEGAL_FUN_ACCESS</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</orderedlist>
+</listitem>
+</varlistentry>
+</variablelist>
+<simpara>For type, variable and function visibility issues the following changes have to be made to solve the visibility issue:</simpara>
+<table xml:id="tab:typeAccessControl" frame="all" rowsep="1" colsep="1">
+<title>Type,function and variable access modifier changes for quick fixes</title>
+<tgroup cols="5">
+<colspec colname="col_1" colwidth="20*"/>
+<colspec colname="col_2" colwidth="20*"/>
+<colspec colname="col_3" colwidth="20*"/>
+<colspec colname="col_4" colwidth="20*"/>
+<colspec colname="col_5" colwidth="20*"/>
+<tbody>
+<row>
+<entry align="center" valign="top" morerows="1"><simpara><emphasis role="strong">Access Modifier</emphasis></simpara></entry>
+<entry align="center" valign="top" namest="col_2" nameend="col_5"><simpara><emphasis role="strong">Accessible From</emphasis></simpara></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><emphasis role="strong">Module</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><emphasis role="strong">Project</emphasis></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">Vendor</emphasis></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">World</emphasis></simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><literal>private</literal></simpara></entry>
+<entry align="center" valign="top"><simpara><literal>-</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>export project</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>export public@Internal</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>export public</literal></simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><literal>project</literal></simpara></entry>
+<entry align="center" valign="top"><simpara><literal>-</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>export project</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>export public@Internal</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>export public</literal></simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><literal>export project</literal></simpara></entry>
+<entry align="center" valign="top"><simpara><literal>-</literal></simpara></entry>
+<entry align="center" valign="top"><simpara><literal>-</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>export public@Internal</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>export public</literal></simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><literal>export public@Internal</literal></simpara></entry>
+<entry align="center" valign="top"><simpara><literal>-</literal></simpara></entry>
+<entry align="center" valign="top"><simpara><literal>-</literal></simpara></entry>
+<entry align="center" valign="top"><simpara><literal>-</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>export public</literal></simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><literal>export public</literal></simpara></entry>
+<entry align="center" valign="top"><simpara><literal>-</literal></simpara></entry>
+<entry align="center" valign="top"><simpara><literal>-</literal></simpara></entry>
+<entry align="center" valign="top"><simpara><literal>-</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>export public</literal></simpara></entry>
+</row>
+</tbody>
+</tgroup>
+</table>
+</section>
+<section xml:id="sec:Classifier_Issues">
+<title>Classifier Issues</title>
+<variablelist>
+<varlistentry>
+<term>CLF_EXTEND_FINAL</term>
+<listitem>
+<simpara><literal>Cannot extend final class <emphasis>C</emphasis>.</literal></simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>Remove <literal>@Final</literal> annotation in class <emphasis>C</emphasis></simpara>
+<variablelist>
+<varlistentry>
+<term>Precondition</term>
+<listitem>
+<simpara>–</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>Postcondition</term>
+<listitem>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mo>¬</mo><mi>C</mi><mo>.</mo><mi>f</mi><mi>i</mi><mi>n</mi><mi>a</mi><mi>l</mi></math></simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</orderedlist>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>CLF_OBSERVABLE_MISSING</term>
+<listitem>
+<simpara><literal>Class <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>0</mn></msub></math> extends observable class <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>1</mn></msub></math> and must therefore be annotated with @Observable.</literal></simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>Add <literal>@Obervable</literal> annotation in class <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>0</mn></msub></math></simpara>
+<variablelist>
+<varlistentry>
+<term>Precondition</term>
+<listitem>
+<simpara>–</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>Postcondition</term>
+<listitem>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>0.</mn></msub><mi>o</mi><mi>b</mi><mi>s</mi><mi>e</mi><mi>r</mi><mi>v</mi><mi>a</mi><mi>b</mi><mi>l</mi><mi>e</mi></math></simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</orderedlist>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>CLF_OVERRIDE_ANNOTATION</term>
+<listitem>
+<simpara><literal>The <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>0</mn></msub></math> overriding <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>1</mn></msub></math> must be annotated with @Override.</literal></simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>Add <literal>@Override</literal> annotation to <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>0</mn></msub></math></simpara>
+<variablelist>
+<varlistentry>
+<term>Precondition</term>
+<listitem>
+<simpara>–</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>Label</term>
+<listitem>
+<simpara><literal>Add @Override</literal></simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>Postcondition</term>
+<listitem>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>0.</mn></msub><mi>o</mi><mi>v</mi><mi>e</mi><mi>r</mi><mi>r</mi><mi>i</mi><mi>d</mi><mi>e</mi></math></simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</orderedlist>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>CLF_OVERRIDE_FINAL</term>
+<listitem>
+<simpara><literal>The <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>0</mn></msub></math> cannot override final <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>1</mn></msub></math>.</literal></simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>Remove <literal>@Final</literal> annotation in <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>1</mn></msub></math></simpara>
+<variablelist>
+<varlistentry>
+<term>Precondition</term>
+<listitem>
+<simpara>–</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>Postcondition</term>
+<listitem>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mo>¬</mo><msub><mi>e</mi><mn>1.</mn></msub><mi>f</mi><mi>i</mi><mi>n</mi><mi>a</mi><mi>l</mi></math></simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</orderedlist>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>CLF_OVERRIDE_VISIBILITY</term>
+<listitem>
+<simpara><literal>The <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>0</mn></msub></math> cannot reduce the visibility of <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>1</mn></msub></math>.</literal></simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>Set access modifier of <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>0</mn></msub></math> to access modifier of <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>1</mn></msub></math></simpara>
+<variablelist>
+<varlistentry>
+<term>Precondition</term>
+<listitem>
+<simpara>–</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>Postcondition</term>
+<listitem>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>0.</mn></msub><mi>a</mi><mi>c</mi><mi>c</mi><mo>=</mo><mo>=</mo><msub><mi>e</mi><mn>1.</mn></msub><mi>a</mi><mi>c</mi><mi>c</mi></math></simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</orderedlist>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>CLF_OVERRIDE_NON_EXISTENT</term>
+<listitem>
+<simpara><literal>The <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>0</mn></msub></math> <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>1</mn></msub></math> must override or implement a <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>0</mn></msub></math> from a super class, consumed role or implemented interface.</literal></simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>Remove <literal>@Override</literal> annotation in <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>1</mn></msub></math></simpara>
+<variablelist>
+<varlistentry>
+<term>Precondition</term>
+<listitem>
+<simpara>–</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>Label</term>
+<listitem>
+<simpara><literal>Remove @Override</literal></simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>Postcondition</term>
+<listitem>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mo>¬</mo><msub><mi>e</mi><mn>1.</mn></msub><mi>o</mi><mi>v</mi><mi>e</mi><mi>r</mi><mi>r</mi><mi>i</mi><mi>d</mi><mi>e</mi></math></simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</orderedlist>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>CLF_REDEFINED_TYPE_NOT_SAME_TYPE</term>
+<listitem>
+<simpara><literal>Type of <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>0</mn></msub></math> must equal type of <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>1</mn></msub></math> <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>2</mn></msub></math>.</literal></simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>Set declared type of <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>0</mn></msub></math> to declared type of <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>2</mn></msub></math></simpara>
+<variablelist>
+<varlistentry>
+<term>Precondition</term>
+<listitem>
+<simpara>–</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>Postcondition</term>
+<listitem>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>τ</mi><msub><mi>e</mi><mn>0</mn></msub><mo>=</mo><msub><mi>e</mi><mn>2</mn></msub></math></simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</orderedlist>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>CLF_REDEFINED_MEMBER_TYPE_INVALID</term>
+<listitem>
+<simpara><literal>Type of <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>0</mn></msub></math> does not conform to <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>2</mn></msub></math> <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>1</mn></msub></math>: <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>3</mn></msub></math>.</literal></simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>Set declared type of <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>0</mn></msub></math> to declared type of <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>1</mn></msub></math></simpara>
+<variablelist>
+<varlistentry>
+<term>Precondition</term>
+<listitem>
+<simpara>–</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>Postcondition</term>
+<listitem>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>τ</mi><msub><mi>e</mi><mn>0</mn></msub><mo>=</mo><msub><mi>e</mi><mn>1</mn></msub></math></simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</orderedlist>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>CLF_REDEFINED_METHOD_TYPE_CONFLICT</term>
+<listitem>
+<simpara><literal>Signature of <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>0</mn></msub></math> does not conform to <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>1</mn></msub></math> <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>2</mn></msub></math>: <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>3</mn></msub></math>.</literal></simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>Set declared type of <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>0</mn></msub></math> to declared type of <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>2</mn></msub></math></simpara>
+<variablelist>
+<varlistentry>
+<term>Precondition</term>
+<listitem>
+<simpara>–</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>Postcondition</term>
+<listitem>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>τ</mi><msub><mi>e</mi><mn>0</mn></msub><mo>=</mo><msub><mi>e</mi><mn>2</mn></msub></math></simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</orderedlist>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>CLF_MISSING_IMPLEMENTATION</term>
+<listitem>
+<simpara><literal>Class <emphasis>C</emphasis> must either be defined abstract or implement <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>m</mi></math>.</literal></simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>Declare <emphasis>C</emphasis> as abstract</simpara>
+<variablelist>
+<varlistentry>
+<term>Precondition</term>
+<listitem>
+<simpara>–</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>Postcondition</term>
+<listitem>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>C</mi><mo>.</mo><mi>a</mi><mi>b</mi><mi>s</mi><mi>t</mi><mi>r</mi><mi>a</mi><mi>c</mi><mi>t</mi></math></simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</orderedlist>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>CLF_ABSTRACT_BODY</term>
+<listitem>
+<simpara><literal>Abstract methods do not specify a body.</literal> for method <emphasis>M</emphasis></simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>Remove abstract annotation from method.</simpara>
+<variablelist>
+<varlistentry>
+<term>Precondition</term>
+<listitem>
+<simpara>–</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>Postcondition</term>
+<listitem>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mo>¬</mo><mi>M</mi><mo>.</mo><mi>a</mi><mi>b</mi><mi>s</mi><mi>t</mi><mi>r</mi><mi>a</mi><mi>c</mi><mi>t</mi></math></simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</orderedlist>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>CLF_ABSTRACT_MISSING</term>
+<listitem>
+<simpara><literal>The abstract <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>0</mn></msub></math> <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>1</mn></msub></math> in class <emphasis>C</emphasis> can only be defined in an abstract class.</literal></simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>Declare <emphasis>C</emphasis> as abstract</simpara>
+<variablelist>
+<varlistentry>
+<term>Precondition</term>
+<listitem>
+<simpara>–</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>Postcondition</term>
+<listitem>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>C</mi><mo>.</mo><mi>a</mi><mi>b</mi><mi>s</mi><mi>t</mi><mi>r</mi><mi>a</mi><mi>c</mi><mi>t</mi></math></simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>Multi appliable</term>
+<listitem>
+<simpara>false</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</orderedlist>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>CLF_MISSING_BODY</term>
+<listitem>
+<simpara><literal>The <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>0</mn></msub></math> <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>1</mn></msub></math> has to have either a body or must be defined abstract.</literal></simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>Declare <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>1</mn></msub></math> as abstract</simpara>
+<variablelist>
+<varlistentry>
+<term>Precondition</term>
+<listitem>
+<simpara>–</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>Postcondition</term>
+<listitem>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>1.</mn></msub><mi>a</mi><mi>b</mi><mi>s</mi><mi>t</mi><mi>r</mi><mi>a</mi><mi>c</mi><mi>t</mi></math></simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</orderedlist>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>CLF_EXT_EXTERNAL_N4JSD</term>
+<listitem>
+<simpara><literal><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>0</mn></msub></math> declared as external have to be placed in a file with file extension ’n4jsd’.</literal></simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>Remove external annotation</simpara>
+<variablelist>
+<varlistentry>
+<term>Precondition</term>
+<listitem>
+<simpara>–</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>Postcondition</term>
+<listitem>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mo>¬</mo><msub><mi>e</mi><mn>0.</mn></msub><mi>e</mi><mi>x</mi><mi>t</mi><mi>e</mi><mi>r</mi><mi>n</mi><mi>a</mi><mi>l</mi></math></simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+<listitem>
+<simpara>Change module file extension to n4jsd</simpara>
+<variablelist>
+<varlistentry>
+<term>Precondition</term>
+<listitem>
+<simpara>–</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>Postcondition</term>
+<listitem>
+<simpara>module file extension is n4jsd</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</orderedlist>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>CLF_NOT_EXPORTED_NOT_PRIVATE</term>
+<listitem>
+<simpara><literal>A <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>0</mn></msub></math> with visibility <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>1</mn></msub></math> must be marked as exported.</literal></simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>Export <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>0</mn></msub></math></simpara>
+<variablelist>
+<varlistentry>
+<term>Precondition</term>
+<listitem>
+<simpara>–</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>Postcondition</term>
+<listitem>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>0</mn></msub></math> is exported</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</orderedlist>
+</listitem>
+</varlistentry>
+</variablelist>
+</section>
+<section xml:id="sec:Function_Issues">
+<title>Function Issues</title>
+<informaltable tabstyle="horizontal" frame="none" colsep="0" rowsep="0">
+<tgroup cols="2">
+<colspec colwidth="15*"/>
+<colspec colwidth="85*"/>
+<tbody valign="top">
+<row>
+<entry>
+<simpara>FUN_BLOCK</simpara>
+</entry>
+<entry>
+<simpara><literal>Functions declarations should not be placed in blocks. Use a function expression or move the statement to the top of the outer function.</literal> with function <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>F</mi></math></simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>Change function declaration to function expression</simpara>
+<variablelist>
+<varlistentry>
+<term>Precondition</term>
+<listitem>
+<simpara>–</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>Postcondition</term>
+<listitem>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</orderedlist>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mtable><mtr><mtd/><mtd><mo>∃</mo><mstyle mathvariant="monospace"><mtext>Variable</mtext></mstyle><mi> </mi><mi>v</mi><mo>∈</mo><mi>F</mi><mo>.</mo><mi>v</mi><mi>e</mi><mi>e</mi><mi>:</mi></mtd></mtr><mtr><mtd/><mtd><mspace width="3.0em"/><mi>v</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><mi>F</mi></mtd></mtr><mtr><mtd/><mtd><mspace width="3.0em"/><mo>∧</mo><mi>v</mi><mo>.</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mo>.</mo><mi>μ</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>FunctionExpression</mtext></mstyle></mtd></mtr><mtr><mtd/><mtd><mspace width="3.0em"/><mo>∧</mo><mi>v</mi><mo>.</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><mi>F</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>,</mo><mi>v</mi><mo>.</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mo>.</mo><mi>b</mi><mi>o</mi><mi>d</mi><mi>y</mi><mo>=</mo><mi>F</mi><mo>.</mo><mi>b</mi><mi>o</mi><mi>d</mi><mi>y</mi></mtd></mtr></mtable></math>
+<variablelist>
+<varlistentry>
+<term>Description</term>
+<listitem>
+<simpara>Change function declaration to function expression assigned to variable of the function name</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+</section>
+<section xml:id="sec:Syntax_Issues">
+<title>Syntax Issues</title>
+<variablelist>
+<varlistentry>
+<term>AST_STR_FUN_NOT_NESTED</term>
+<listitem>
+<simpara><literal>Functions must only be declared on script level or as part of other expressions</literal></simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>Change function declaration to function expression assigned to variable of the function name</simpara>
+<variablelist>
+<varlistentry>
+<term>Precondition</term>
+<listitem>
+<simpara>–</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>Postcondition</term>
+<listitem>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</orderedlist>
+</listitem>
+</varlistentry>
+</variablelist>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mtable><mtr><mtd/><mtd><mo>∃</mo><mstyle mathvariant="monospace"><mtext>Variable</mtext></mstyle><mi> </mi><mi>v</mi><mo>∈</mo><mi>F</mi><mo>.</mo><mi>v</mi><mi>e</mi><mi>e</mi><mi>:</mi></mtd></mtr><mtr><mtd/><mtd><mspace width="3.0em"/><mi>v</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><mi>F</mi></mtd></mtr><mtr><mtd/><mtd><mspace width="3.0em"/><mo>∧</mo><mi>v</mi><mo>.</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mo>.</mo><mi>μ</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>FunctionExpression</mtext></mstyle></mtd></mtr><mtr><mtd/><mtd><mspace width="3.0em"/><mo>∧</mo><mi>v</mi><mo>.</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><mi>F</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>,</mo><mi>v</mi><mo>.</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mo>.</mo><mi>b</mi><mi>o</mi><mi>d</mi><mi>y</mi><mo>=</mo><mi>F</mi><mo>.</mo><mi>b</mi><mi>o</mi><mi>d</mi><mi>y</mi></mtd></mtr></mtable></math>
+<variablelist>
+<varlistentry>
+<term>SYN_MODIFIER_BAD_ORDER</term>
+<listitem>
+<simpara><literal>Modifiers should appear in this order: O </literal></simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>Rearrange access modifiers</simpara>
+<variablelist>
+<varlistentry>
+<term>Precondition</term>
+<listitem>
+<simpara>–</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>Postcondition</term>
+<listitem>
+<simpara>Modifiers are in order O</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>Description</term>
+<listitem>
+<simpara>Reorder the access modifiers to match the N4JS compliant order.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</orderedlist>
+</listitem>
+</varlistentry>
+</variablelist>
+</section>
+<section xml:id="sec:Conversion_Issues">
+<title>Conversion Issues</title>
+
+</section>
+<section xml:id="sec:Type_Issues">
+<title>Type Issues</title>
+
+</section>
+<section xml:id="sec:Expression_Issues">
+<title>Expression Issues</title>
+<variablelist>
+<varlistentry>
+<term>EXP_WRONG_NUMBER_OF_TYPEARGS</term>
+<listitem>
+<simpara><literal>Incorrect number of type arguments for <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi></math> <emphasis>C</emphasis>: expected <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>t</mi><mi>p</mi><mi>c</mi><mi>o</mi><mi>u</mi><mi>n</mi><mi>t</mi></math>, got <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>t</mi><mi>a</mi><mi>c</mi><mi>o</mi><mi>u</mi><mi>n</mi><mi>t</mi></math>.</literal></simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>Remove superfluous arguments</simpara>
+<variablelist>
+<varlistentry>
+<term>Precondition</term>
+<listitem>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>t</mi><mi>a</mi><mi>c</mi><mi>o</mi><mi>u</mi><mi>n</mi><mi>t</mi><mo>&gt;</mo><mi>t</mi><mi>p</mi><mi>c</mi><mi>o</mi><mi>u</mi><mi>n</mi><mi>t</mi></math></simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>Postcondition</term>
+<listitem>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>t</mi><mi>a</mi><mi>c</mi><mi>o</mi><mi>u</mi><mi>n</mi><mi>t</mi><mo>=</mo><mi>t</mi><mi>p</mi><mi>c</mi><mi>o</mi><mi>u</mi><mi>n</mi><mi>t</mi></math></simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>Description</term>
+<listitem>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</orderedlist>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>EXP_NUM_OF_ARGS_TOO_MANY</term>
+<listitem>
+<simpara><literal>Incorrect number of arguments: expected <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>f</mi><mi>p</mi><mi>c</mi><mi>o</mi><mi>u</mi><mi>n</mi><mi>t</mi></math>, got <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>a</mi><mi>r</mi><mi>g</mi><mi>c</mi><mi>o</mi><mi>u</mi><mi>n</mi><mi>t</mi></math>.</literal></simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>Remove superfluous arguments</simpara>
+<variablelist>
+<varlistentry>
+<term>Precondition</term>
+<listitem>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>a</mi><mi>r</mi><mi>g</mi><mi>c</mi><mi>o</mi><mi>u</mi><mi>n</mi><mi>t</mi><mo>&gt;</mo><mi>f</mi><mi>p</mi><mi>c</mi><mi>o</mi><mi>u</mi><mi>n</mi><mi>t</mi></math></simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>Postcondition</term>
+<listitem>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>a</mi><mi>r</mi><mi>g</mi><mi>c</mi><mi>o</mi><mi>u</mi><mi>n</mi><mi>t</mi><mo>=</mo><mi>f</mi><mi>p</mi><mi>c</mi><mi>o</mi><mi>u</mi><mi>n</mi><mi>t</mi></math></simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>Description</term>
+<listitem>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</orderedlist>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>EXP_CAST_UNNECESSARY</term>
+<listitem>
+<simpara><literal>Unnecessary cast from <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>S</mi></math> to <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi></math></literal></simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>Remove cast</simpara>
+<variablelist>
+<varlistentry>
+<term>Precondition</term>
+<listitem>
+<simpara>–</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>Postcondition</term>
+<listitem>
+<simpara>cast removed</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>Description</term>
+<listitem>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</orderedlist>
+</listitem>
+</varlistentry>
+</variablelist>
+</section>
+<section xml:id="sec:Super_Keyword_Issues">
+<title>Super Keyword Issues</title>
+
+</section>
+</section>
+</section>
+<section xml:id="sec:Quick_Assist">
+<title>Quick Assist</title>
+
+</section>
+<section xml:id="sec:Cleanup_Operations" role="language-n4js">
+<title>Cleanup Operations</title>
+<section xml:id="sec:Formatting">
+<title>Formatting</title>
+
+</section>
+<section xml:id="sec:Organize_Imports">
+<title>Organize Imports</title>
+<simpara>Import statements can be cleaned up or automatically inserted by invoking <literal>Organize Imports</literal>. <literal>Organize Imports</literal> is available in the context menu <literal>Source / Organise imports</literal> , in menu <literal>Source &gt; Organize imports</literal> or by hitting <keycap>Cmd</keycap> + <keycap>Option</keycap> +<keycap>O</keycap> (Win/Linux - <keycap>Ctrl</keycap> +<keycap>Alt</keycap> +<keycap>O</keycap>).</simpara>
+<simpara>For a valid file without errors, this will result in the following actions:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>Unused explicit imports will be removed.</simpara>
+</listitem>
+<listitem>
+<simpara>Unused wildcard imports will be removed.</simpara>
+</listitem>
+<listitem>
+<simpara>In each import statement the imported elements will be lexicographically sorted depending on the imported element’s name.</simpara>
+</listitem>
+<listitem>
+<simpara>All import statements will be lexicographically sorted depending on the module specifier as major and the element name as minor key.</simpara>
+</listitem>
+<listitem>
+<simpara>All import statements will be moved to the top of the file.</simpara>
+</listitem>
+</itemizedlist>
+<simpara>For a file with error-conditions of unresolved references, this will result in the automatic actions:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>All ambiguous wildcard imports will be presented in one dialog, requesting the user to resolve the ambiguity.</simpara>
+</listitem>
+<listitem>
+<simpara>Each uniquely resolvable <literal>unresolved Classifier</literal> will be added by a named import. The search scope is limited to the dependencies declared in the current project-setup.</simpara>
+</listitem>
+</itemizedlist>
+<simpara>No action will be taken, if &#8230;&#8203;</simpara>
+<itemizedlist>
+<listitem>
+<simpara>a classifier with name <literal>X</literal> is already imported by name from a module <literal>A</literal> and a unknown member of this classifier is marked. Even though the import of <literal>X</literal> from a different module <literal>B</literal> could remove this error, the semantic consequences could not be evaluated. The state will be left as-is.</simpara>
+</listitem>
+</itemizedlist>
+<simpara>If more then one option leads to a possible resolution the situation should be clarified using quick-fixes, e.g. if &#8230;&#8203;</simpara>
+<itemizedlist>
+<listitem>
+<simpara>more then one module provides an element, which would render a formerly unresolved reference to be valid.</simpara>
+</listitem>
+<listitem>
+<simpara>for a wildcard-imported element <literal>X</literal> there are unknown members and a different module provides an element <literal>X</literal> containing the missing members. In such a case a named import of <literal>X</literal> would be proposed, optionally using an alias.</simpara>
+</listitem>
+</itemizedlist>
+</section>
+</section>
+</chapter>
+<chapter xml:id="_wizards">
+<title>Wizards</title>
+<warning>
+<simpara>Some descriptions may be outdated.</simpara>
+</warning>
+<warning>
+<simpara>All requirement sections are not linked to real issues. They were left here as an example and to complete the issues.</simpara>
+</warning>
+<section xml:id="sec:N4JS_Project_Wizard">
+<title>N4JS Project Wizard</title>
+<simpara>Wizard creates a new N4JS project.</simpara>
+<simpara>The following information is to be specified by the user:</simpara>
+<informaltable tabstyle="horizontal" frame="none" colsep="0" rowsep="0">
+<tgroup cols="2">
+<colspec colwidth="15*"/>
+<colspec colwidth="85*"/>
+<tbody valign="top">
+<row>
+<entry>
+<simpara>Project Name</simpara>
+</entry>
+<entry>
+<simpara>string, name of project</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Default Location</simpara>
+</entry>
+<entry>
+<simpara>boolean, true by default</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Location</simpara>
+</entry>
+<entry>
+<simpara>string, computed default location, if user set location then default location flag must be false</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Project Type</simpara>
+</entry>
+<entry>
+<simpara>enumeration, the type of the new project</simpara>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+<simpara>The following files are to be created:</simpara>
+<informaltable tabstyle="horizontal" frame="none" colsep="0" rowsep="0">
+<tgroup cols="2">
+<colspec colwidth="15*"/>
+<colspec colwidth="85*"/>
+<tbody valign="top">
+<row>
+<entry>
+<simpara>Project Folder</simpara>
+</entry>
+<entry>
+<simpara>with name of project at given location</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Manifest</simpara>
+</entry>
+<entry>
+<simpara>with default project structure and name</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Source Folder</simpara>
+</entry>
+<entry>
+<simpara>default source folder (src)</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Output Folder</simpara>
+</entry>
+<entry>
+<simpara>default source folder (src-gen)</simpara>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+</section>
+<section xml:id="sec:Empty_N4JS_File">
+<title>Empty N4JS File</title>
+<simpara>The following information is to be specified by the user:</simpara>
+<informaltable tabstyle="horizontal" frame="none" colsep="0" rowsep="0">
+<tgroup cols="2">
+<colspec colwidth="15*"/>
+<colspec colwidth="85*"/>
+<tbody valign="top">
+<row>
+<entry>
+<simpara>Package Name</simpara>
+</entry>
+<entry>
+<simpara>dot separated name of the package, empty by default (or set to the package/folder selected in the navigator)</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Module Name</simpara>
+</entry>
+<entry>
+<simpara>string, name of the module – must be a valid module name without extension</simpara>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+<simpara>The following files are to be created:</simpara>
+<informaltable tabstyle="horizontal" frame="none" colsep="0" rowsep="0">
+<tgroup cols="2">
+<colspec colwidth="15*"/>
+<colspec colwidth="85*"/>
+<tbody valign="top">
+<row>
+<entry>
+<simpara>Package Folder(s)</simpara>
+</entry>
+<entry>
+<simpara>if folders representing package structure do not exist, they are to be created</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Module File</simpara>
+</entry>
+<entry>
+<simpara>empty file with name of module and extension <literal>n4js</literal>  in the appropriate package folder</simpara>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+</section>
+<section xml:id="sec:Empty_JS_File">
+<title>Empty JS File</title>
+<simpara>Similar to <link linkend="sec:Empty_N4JS_File">Empty N4JS File</link> but with the file extension <literal>js</literal>.</simpara>
+<section xml:id="sec:N4JS_Class_File_Wizard">
+<title>N4JS Class Wizard</title>
+<simpara>It is recommended to define a single classifier in a file, the name of the classifier should have the same name as the file. Based on that assumption, file wizards are provided for N4JS classes, interfaces and enumerations.</simpara>
+<informalfigure role="center">
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/06_wizards/fig/newclasswizard.png" width="60%" scalefit="1"/>
+</imageobject>
+<textobject><phrase>newclasswizard</phrase></textobject>
+</mediaobject>
+</informalfigure>
+</section>
+<section xml:id="field-properties">
+<title>Field Properties</title>
+<simpara><anchor xml:id="Class_File_Wizard-Project_Field" xreflabel="[Class_File_Wizard-Project_Field]"/> The New N4JS Class wizard offers following fields:</simpara>
+<variablelist>
+<varlistentry>
+<term>Project</term>
+<listitem>
+<simpara>Specifies the containing project.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+<requirement xml:id="GH-1413">
+<title>Project constraints</title>
+<simpara>
+<anchor xml:id="Req-GH-1413" xreflabel="[Req-GH-1413]"/>
+<emphasis role="strong">Requirement: GH-1413:</emphasis>
+<link linkend="Req-GH-1413">Project constraints</link> (ver. 1)</simpara>
+    <simpara>
+</simpara>
+<informaltable tabstyle="horizontal" frame="none" colsep="0" rowsep="0">
+<tgroup cols="2">
+<colspec colwidth="15*"/>
+<colspec colwidth="85*"/>
+<tbody valign="top">
+<row>
+<entry>
+<simpara>Constraints</simpara>
+</entry>
+<entry>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>It is a path of a valid project in the current workspace</simpara>
+</listitem>
+<listitem>
+<simpara>This field must not be empty</simpara>
+</listitem>
+</orderedlist>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+</requirement>
+<requirement xml:id="GH-1413">
+<title>Project browse button</title>
+<simpara>
+<anchor xml:id="Req-GH-1413" xreflabel="[Req-GH-1413]"/>
+<emphasis role="strong">Requirement: GH-1413:</emphasis>
+<link linkend="Req-GH-1413">Project browse button</link> (ver. 1)</simpara>
+    <simpara>
+
+Browse Button::
+  Browsing only allows the selection of projects in the current workspace. Project creation is not possible.</simpara>
+</requirement>
+<requirement xml:id="GH-1413">
+<title>Project initial selection inference</title>
+<simpara>
+<anchor xml:id="Req-GH-1413" xreflabel="[Req-GH-1413]"/>
+<emphasis role="strong">Requirement: GH-1413:</emphasis>
+<link linkend="Req-GH-1413">Project initial selection inference</link> (ver. 1)</simpara>
+    <simpara>
+
+Initial selection::
+  The project should be derived from the initial selection.</simpara>
+</requirement>
+<requirement xml:id="GH-1413">
+<title>Project content assist</title>
+<simpara>
+<anchor xml:id="Req-GH-1413" xreflabel="[Req-GH-1413]"/>
+<emphasis role="strong">Requirement: GH-1413:</emphasis>
+<link linkend="Req-GH-1413">Project content assist</link> (ver. 1)</simpara>
+    <simpara>
+
+Content Assist::
+  Workspace projects</simpara>
+</requirement>
+<variablelist xml:id="Class_File_Wizard-Source_Folder_Field">
+<varlistentry>
+<term>Source folder</term>
+<listitem>
+<simpara>Specifies the containing source folder.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+<requirement xml:id="GH-1413">
+<title>Source folder constraints</title>
+<simpara>
+<anchor xml:id="Req-GH-1413" xreflabel="[Req-GH-1413]"/>
+<emphasis role="strong">Requirement: GH-1413:</emphasis>
+<link linkend="Req-GH-1413">Source folder constraints</link> (ver. 1)</simpara>
+    <simpara>
+</simpara>
+<informaltable tabstyle="horizontal" frame="none" colsep="0" rowsep="0">
+<tgroup cols="2">
+<colspec colwidth="15*"/>
+<colspec colwidth="85*"/>
+<tbody valign="top">
+<row>
+<entry>
+<simpara>Constraints</simpara>
+</entry>
+<entry>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>The folder is listed as source folder in the project manifest</simpara>
+</listitem>
+<listitem>
+<simpara>This field must not be empty.</simpara>
+</listitem>
+<listitem>
+<simpara>The name is a valid path that means each segment of the path matches the following expression:</simpara>
+<programlisting language="ebnf" linenumbering="unnumbered">[a-zA-z_](([\\.][a-zA-z_0-9\\-])|[a-zA-z_0-9\\-])*</programlisting>
+</listitem>
+</orderedlist>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+</requirement>
+<requirement xml:id="GH-1413">
+<title>Source folder browse button</title>
+<simpara>
+<anchor xml:id="Req-GH-1413" xreflabel="[Req-GH-1413]"/>
+<emphasis role="strong">Requirement: GH-1413:</emphasis>
+<link linkend="Req-GH-1413">Source folder browse button</link> (ver. 1)</simpara>
+    <simpara>
+
+Browse Button::
+  Browsing only allows the selection of source folders in the selected project. The dialog should provide a list of all source folders of the selected project. This includes nested source folders. A list element is a relative path of a source folder in the project.</simpara>
+</requirement>
+<requirement xml:id="GH-1413">
+<title>Source folder initial selection inference</title>
+<simpara>
+<anchor xml:id="Req-GH-1413" xreflabel="[Req-GH-1413]"/>
+<emphasis role="strong">Requirement: GH-1413:</emphasis>
+<link linkend="Req-GH-1413">Source folder initial selection inference</link> (ver. 1)</simpara>
+    <simpara>
+
+Initial selection::
+  The source folder field should be derived from the initial selection</simpara>
+</requirement>
+<requirement xml:id="GH-1413">
+<title>Source folder content assist</title>
+<simpara>
+<anchor xml:id="Req-GH-1413" xreflabel="[Req-GH-1413]"/>
+<emphasis role="strong">Requirement: GH-1413:</emphasis>
+<link linkend="Req-GH-1413">Source folder content assist</link> (ver. 1)</simpara>
+    <simpara>
+
+Content Assist::
+  source folders defined by the project manifest</simpara>
+</requirement>
+<variablelist xml:id="Class_File_Wizard-Module_Specifier_Field">
+<varlistentry>
+<term>Module specifier</term>
+<listitem>
+<simpara>Specifies the module specifier. May only specify a module container (a folder) but could also include module name. May also be an already existing module. Does not include the file extension.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+<requirement xml:id="GH-1413">
+<title>Module specifier constraints</title>
+<simpara>
+<anchor xml:id="Req-GH-1413" xreflabel="[Req-GH-1413]"/>
+<emphasis role="strong">Requirement: GH-1413:</emphasis>
+<link linkend="Req-GH-1413">Module specifier constraints</link> (ver. 1)</simpara>
+    <simpara>
+
+The specifier is a valid module specifier that is
+- Segments are separated by the path separator
+- No separator at the beginning or end</simpara>
+</requirement>
+<requirement xml:id="GH-1413">
+<title>Module specifier completion</title>
+<simpara>
+<anchor xml:id="Req-GH-1413" xreflabel="[Req-GH-1413]"/>
+<emphasis role="strong">Requirement: GH-1413:</emphasis>
+<link linkend="Req-GH-1413">Module specifier completion</link> (ver. 1)</simpara>
+    <simpara>
+
+Manually inserting a specifier ending with a separator is valid.
+It is then interpreted as base path for the full module specifier automatically completed by the class name. (cf. grey suffix)</simpara>
+</requirement>
+<requirement xml:id="GH-1413">
+<title>Module specifier grey suffix</title>
+<simpara>
+<anchor xml:id="Req-GH-1413" xreflabel="[Req-GH-1413]"/>
+<emphasis role="strong">Requirement: GH-1413:</emphasis>
+<link linkend="Req-GH-1413">Module specifier grey suffix</link> (ver. 1)</simpara>
+    <simpara>
+
+A grey suffix should suggest the attached class name as module name if the specifier only specifies a base path.</simpara>
+</requirement>
+<requirement xml:id="GH-1413">
+<title>Module specifier browse button</title>
+<simpara>
+<anchor xml:id="Req-GH-1413" xreflabel="[Req-GH-1413]"/>
+<emphasis role="strong">Requirement: GH-1413:</emphasis>
+<link linkend="Req-GH-1413">Module specifier browse button</link> (ver. 1)</simpara>
+    <simpara>
+
+Browsing only allows the selection of modules or module containers in the selected source folder. The browse dialog has to offer a module container creation functionality. In contrast to the other parts of the wizard, the creation of module containers in this dialog should be immediate and on file system level. This is important to comply with the conceptual model of eclipse and the operating system.</simpara>
+<simpara>When inserting a non-existent path in the text input and opening the browse dialog, an additional dialog should ask the user whether he wants to create this structure on the file system. If he denies, the dialog shows the selection to the level it already exists on the file system.</simpara>
+</requirement>
+<requirement xml:id="GH-1413">
+<title>Module specifier initial selection inference</title>
+<simpara>
+<anchor xml:id="Req-GH-1413" xreflabel="[Req-GH-1413]"/>
+<emphasis role="strong">Requirement: GH-1413:</emphasis>
+<link linkend="Req-GH-1413">Module specifier initial selection inference</link> (ver. 1)</simpara>
+    <simpara>
+
+The module specifier should be derived from the initial selection by using the container of the selection as initial module container</simpara>
+</requirement>
+<requirement xml:id="GH-1413">
+<title>Module specifier content assist</title>
+<simpara>
+<anchor xml:id="Req-GH-1413" xreflabel="[Req-GH-1413]"/>
+<emphasis role="strong">Requirement: GH-1413:</emphasis>
+<link linkend="Req-GH-1413">Module specifier content assist</link> (ver. 1)</simpara>
+    <simpara>
+
+Modules in the selected source folder</simpara>
+</requirement>
+<simpara role="todo">For now the spec doesn&#8217;t specify any constraints for module specifiers</simpara>
+<variablelist>
+<varlistentry>
+<term>Class name</term>
+<listitem>
+<simpara>Specifies the class name.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+<requirement xml:id="GH-1413">
+<title>Class name basic constraints</title>
+<simpara>
+<anchor xml:id="Req-GH-1413" xreflabel="[Req-GH-1413]"/>
+<emphasis role="strong">Requirement: GH-1413:</emphasis>
+<link linkend="Req-GH-1413">Class name basic constraints</link> (ver. 1)</simpara>
+    <simpara>
+</simpara>
+<informaltable tabstyle="horizontal" frame="none" colsep="0" rowsep="0">
+<tgroup cols="2">
+<colspec colwidth="15*"/>
+<colspec colwidth="85*"/>
+<tbody valign="top">
+<row>
+<entry>
+<simpara>Constraints</simpara>
+</entry>
+<entry>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>The name is a valid n4js class identifier Must not be empty</simpara>
+</listitem>
+<listitem>
+<simpara>If the target module already exists no other type with the same identifier may exist in this module</simpara>
+</listitem>
+</orderedlist>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+</requirement>
+<requirement xml:id="GH-1413">
+<title>Class name conflict validation</title>
+<simpara>
+<anchor xml:id="Req-GH-1413" xreflabel="[Req-GH-1413]"/>
+<emphasis role="strong">Requirement: GH-1413:</emphasis>
+<link linkend="Req-GH-1413">Class name conflict validation</link> (ver. 1)</simpara>
+    <simpara>
+
+If the target module already exists no other type with the same identifier may exist in this module</simpara>
+</requirement>
+<requirement xml:id="GH-1413">
+<title>File type options</title>
+<simpara>
+<anchor xml:id="Req-GH-1413" xreflabel="[Req-GH-1413]"/>
+<emphasis role="strong">Requirement: GH-1413:</emphasis>
+<link linkend="Req-GH-1413">File type options</link> (ver. 1)</simpara>
+    <simpara>
+
+Definition file (.n4jsd):: Specifies whether the class should be declared external. This option changes the file extension to <literal>n4jsd</literal></simpara>
+</requirement>
+<requirement xml:id="GH-1413">
+<title>Access modifier constraints</title>
+<simpara>
+<anchor xml:id="Req-GH-1413" xreflabel="[Req-GH-1413]"/>
+<emphasis role="strong">Requirement: GH-1413:</emphasis>
+<link linkend="Req-GH-1413">Access modifier constraints</link> (ver. 1)</simpara>
+    <simpara>
+
+Specifies the access modifiers of the class. One of <literal>public</literal>, <literal>project</literal>, <emphasis role="strong">private</emphasis>. <literal>@Internal</literal> is an additionally selectable option.</simpara>
+<informaltable tabstyle="horizontal" frame="none" colsep="0" rowsep="0">
+<tgroup cols="2">
+<colspec colwidth="15*"/>
+<colspec colwidth="85*"/>
+<tbody valign="top">
+<row>
+<entry>
+<simpara>Constraints</simpara>
+</entry>
+<entry>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>One of the provided access modifiers has to be selected</simpara>
+</listitem>
+<listitem>
+<simpara>The <literal>@Internal</literal> option is only selectable in case of <literal>public</literal> or <literal>project</literal></simpara>
+</listitem>
+</orderedlist>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+</requirement>
+<variablelist>
+<varlistentry>
+<term>Other modifiers</term>
+<listitem>
+<simpara>Specifies other modifiers and annotations of the class. The non-exclusive options are <literal>@Final</literal> and <emphasis role="strong">@N4JS</emphasis></simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+<requirement xml:id="GH-1413">
+<title>Other modifiers constraints</title>
+<simpara>
+<anchor xml:id="Req-GH-1413" xreflabel="[Req-GH-1413]"/>
+<emphasis role="strong">Requirement: GH-1413:</emphasis>
+<link linkend="Req-GH-1413">Other modifiers constraints</link> (ver. 1)</simpara>
+    <simpara>
+
+Constraints::
+  1.  <emphasis role="strong">@N4JS</emphasis> annotation is only enabled and selectable if the Definition File box is checked</simpara>
+</requirement>
+<variablelist>
+<varlistentry>
+<term>Super class</term>
+<listitem>
+<simpara>Specifies the super class</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+<requirement xml:id="GH-1413">
+<title>Super class constraints</title>
+<simpara>
+<anchor xml:id="Req-GH-1413" xreflabel="[Req-GH-1413]"/>
+<emphasis role="strong">Requirement: GH-1413:</emphasis>
+<link linkend="Req-GH-1413">Super class constraints</link> (ver. 1)</simpara>
+    <simpara>
+</simpara>
+<informaltable tabstyle="horizontal" frame="none" colsep="0" rowsep="0">
+<tgroup cols="2">
+<colspec colwidth="15*"/>
+<colspec colwidth="85*"/>
+<tbody valign="top">
+<row>
+<entry>
+<simpara>Constraints</simpara>
+</entry>
+<entry>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>A valid absolute class specifier that is a module specifier and a class name separated by a dot.</simpara>
+</listitem>
+</orderedlist>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+</requirement>
+<requirement xml:id="GH-1413">
+<title>Super class browse button</title>
+<simpara>
+<anchor xml:id="Req-GH-1413" xreflabel="[Req-GH-1413]"/>
+<emphasis role="strong">Requirement: GH-1413:</emphasis>
+<link linkend="Req-GH-1413">Super class browse button</link> (ver. 1)</simpara>
+    <simpara>
+</simpara>
+<informaltable tabstyle="horizontal" frame="none" colsep="0" rowsep="0">
+<tgroup cols="2">
+<colspec colwidth="15*"/>
+<colspec colwidth="85*"/>
+<tbody valign="top">
+<row>
+<entry>
+<simpara>Browse Button</simpara>
+</entry>
+<entry>
+<simpara>Browsing allows the selection of all classes in the current workspace with modifiable source and visible classes with unmodifiable sources.</simpara>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+</requirement>
+<requirement xml:id="GH-1413">
+<title>Super class content assist</title>
+<simpara>
+<anchor xml:id="Req-GH-1413" xreflabel="[Req-GH-1413]"/>
+<emphasis role="strong">Requirement: GH-1413:</emphasis>
+<link linkend="Req-GH-1413">Super class content assist</link> (ver. 1)</simpara>
+    <simpara>
+
+Content Assist::
+  All classes matching mentioned criteria</simpara>
+</requirement>
+<variablelist xml:id="Class_File_Wizard-Interfaces_Field">
+<varlistentry>
+<term>Interfaces</term>
+<listitem>
+<simpara>Specifies the implemented interfaces of the class</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+<requirement xml:id="GH-1413">
+<title>Interfaces constraints</title>
+<simpara>
+<anchor xml:id="Req-GH-1413" xreflabel="[Req-GH-1413]"/>
+<emphasis role="strong">Requirement: GH-1413:</emphasis>
+<link linkend="Req-GH-1413">Interfaces constraints</link> (ver. 1)</simpara>
+    <simpara>
+
+1.  A valid absolute interface specifier that is a module specifier and an interface name separated by a dot.</simpara>
+</requirement>
+<requirement xml:id="GH-1413">
+<title>Interfaces browsing</title>
+<simpara>
+<anchor xml:id="Req-GH-1413" xreflabel="[Req-GH-1413]"/>
+<emphasis role="strong">Requirement: GH-1413:</emphasis>
+<link linkend="Req-GH-1413">Interfaces browsing</link> (ver. 1)</simpara>
+    <simpara>
+
+Add Button:: Browsing allows the selection of all interfaces in the current workspace with modifiable source and visible interfaces with unmodifiable sources.</simpara>
+<variablelist>
+<varlistentry>
+<term>Remove Button</term>
+<listitem>
+<simpara>Removes the selected interface from the list. Disabled if nothing is selected.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+</requirement>
+<requirement xml:id="GH-1413">
+<title>Interfaces content assist</title>
+<simpara>
+<anchor xml:id="Req-GH-1413" xreflabel="[Req-GH-1413]"/>
+<emphasis role="strong">Requirement: GH-1413:</emphasis>
+<link linkend="Req-GH-1413">Interfaces content assist</link> (ver. 1)</simpara>
+    <simpara>
+
+Text input is available by clicking in empty space at the end of the list. Content Assist provides all interfaces matching mentioned criteria.</simpara>
+</requirement>
+<requirement xml:id="GH-1413">
+<title>Create method stubs</title>
+<simpara>
+<anchor xml:id="Req-GH-1413" xreflabel="[Req-GH-1413]"/>
+<emphasis role="strong">Requirement: GH-1413:</emphasis>
+<link linkend="Req-GH-1413">Create method stubs</link> (ver. 1)</simpara>
+    <simpara>
+
+Specifies if the wizard should generate method stubs for all abstract methods of the newly generated class. That are abstract super class methods or methods that need to be implemented by the class to conform to the selected interfaces.</simpara>
+</requirement>
+<requirement xml:id="GH-1413">
+<title>Create method stub conflict detection</title>
+<simpara>
+<anchor xml:id="Req-GH-1413" xreflabel="[Req-GH-1413]"/>
+<emphasis role="strong">Requirement: GH-1413:</emphasis>
+<link linkend="Req-GH-1413">Create method stub conflict detection</link> (ver. 1)</simpara>
+    <simpara>
+
+If the selected interfaces are impossible to implement (e.g. method name overlap with unrelated parameter types) this option needs to be disabled and a warning needs to be shown.</simpara>
+</requirement>
+<simpara role="todo">Shouldn&#8217;t this be a constraint of the selected interfaces? (Never generate invalid code)</simpara>
+</section>
+<section xml:id="visibility-issues-or-final-super-classes">
+<title>Visibility issues or <literal>@Final</literal> super classes</title>
+<requirement xml:id="GH-1413">
+<title>Visibility issue conflict solving</title>
+<simpara>
+<anchor xml:id="Req-GH-1413" xreflabel="[Req-GH-1413]"/>
+<emphasis role="strong">Requirement: GH-1413:</emphasis>
+<link linkend="Req-GH-1413">Visibility issue conflict solving</link> (ver. 1)</simpara>
+    <simpara>
+</simpara>
+<simpara>By allowing the user to select invisible interfaces and super classes or unextendable <literal>@Final</literal>-annotated super classes, accessability issues may come up. The goal is to never generate a file containing invalid code. To accomplish this, conflicts must get solved before the file is generated.</simpara>
+<simpara>The slight limitation of the selection of interfaces and classes to elements from modifiable sources (cf. <link linkend="Req-GH-1413">super class browse button</link>) allows to solve all possibly occurring visibility issues.</simpara>
+<simpara>If the modifications by finishing the wizard do imply changes different from insertions and creations, a compare view is to be shown, giving the user an overview of the needed changes before they’re applied.</simpara>
+</requirement>
+</section>
+<section xml:id="generation-1">
+<title>Generation</title>
+<requirement xml:id="GH-1413">
+<title>Wizard generation</title>
+<simpara>
+<anchor xml:id="Req-GH-1413" xreflabel="[Req-GH-1413]"/>
+<emphasis role="strong">Requirement: GH-1413:</emphasis>
+<link linkend="Req-GH-1413">Wizard generation</link> (ver. 1)</simpara>
+    <simpara>
+
+The following changes are to be made by the wizard:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>Create a new file containing the new class (optional)</simpara>
+</listitem>
+<listitem>
+<simpara>Insert the new class into the specified module</simpara>
+</listitem>
+<listitem>
+<simpara>Change the source module of the super class to fix possible visibility issues (optional)</simpara>
+</listitem>
+<listitem>
+<simpara>Change the source module of the interfaces to fix possible visibility issues (optional)</simpara>
+</listitem>
+<listitem>
+<simpara>Change the project manifest to add a new source folder (optional) or add new project dependencies (optional)</simpara>
+</listitem>
+</orderedlist>
+</requirement>
+</section>
+<section xml:id="preview-1">
+<title>Preview</title>
+<requirement xml:id="GH-1413">
+<title>Generation preview</title>
+<simpara>
+<anchor xml:id="Req-GH-1413" xreflabel="[Req-GH-1413]"/>
+<emphasis role="strong">Requirement: GH-1413:</emphasis>
+<link linkend="Req-GH-1413">Generation preview</link> (ver. 1)</simpara>
+    <simpara>
+
+On the right of the wizard form a preview window should be provided. It should preview the full path of the generated file and all code that is generated with the options of the wizard. Changes should be updated in realtime as the user is choosing different options.</simpara>
+</requirement>
+</section>
+</section>
+<section xml:id="sec:N4JS_Interface_Wizard">
+<title>Interface Wizard</title>
+<simpara>The N4JS interface wizards is strongly similar to the <link linkend="sec:N4JS_Class_File_Wizard">N4JS Class Wizard</link>. The following paragraph is meant to state the differences and will strongly refer to the N4JS Class Wizard as a lot of properties stay the same.</simpara>
+<informalfigure role="center">
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/06_wizards/fig/newinterfacewizard.png" width="60%" scalefit="1"/>
+</imageobject>
+<textobject><phrase>newinterfacewizard</phrase></textobject>
+</mediaobject>
+</informalfigure>
+<section xml:id="field-properties-1">
+<title>Field Properties</title>
+<informaltable tabstyle="horizontal" frame="none" colsep="0" rowsep="0">
+<tgroup cols="2">
+<colspec colwidth="15*"/>
+<colspec colwidth="85*"/>
+<tbody valign="top">
+<row>
+<entry>
+<simpara>Project</simpara>
+</entry>
+<entry>
+<simpara>Specifies the containing project.
+See <link linkend="Class_File_Wizard-Project_Field">N4JS Class Wizard Project</link>.</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Source Folder</simpara>
+</entry>
+<entry>
+<simpara>Specifies the containing source folder.<?asciidoc-br?>
+See <link linkend="Class_File_Wizard-Source_Folder_Field">N4JS Class Wizard Source Folder</link></simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Module Specifier</simpara>
+</entry>
+<entry>
+<simpara>Specifies the containing source folder.<?asciidoc-br?>
+See <link linkend="Class_File_Wizard-Module_Specifier_Field">N4JS Class Wizard Module specifier</link></simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Interface name</simpara>
+</entry>
+<entry>
+<simpara>Specifies the name of the interface<?asciidoc-br?></simpara>
+<variablelist>
+<varlistentry>
+<term>Constraints</term>
+<listitem>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>The name is a valid n4js interface identifier</simpara>
+</listitem>
+<listitem>
+<simpara>Must not be empty</simpara>
+</listitem>
+<listitem>
+<simpara>If the target module already exists, no other type with the same identifier may exist in this module</simpara>
+</listitem>
+</orderedlist>
+</listitem>
+</varlistentry>
+</variablelist>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Definition file (.n4jsd)</simpara>
+</entry>
+<entry>
+<simpara>Specifies whether the interface should be declared external. This option changes the file extension to <literal>n4jsd</literal> .</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Access Modifiers</simpara>
+</entry>
+<entry>
+<simpara>Specifies the interface’s access modifiers</simpara>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+<simpara>See <link linkend="Req-GH-1413">N4JS Class Wizard Modifier Field</link> except for the following point:</simpara>
+<simpara><emphasis>Other than classes, interfaces must not be declared as <literal>@Final</literal>, therefore this option is removed.</emphasis></simpara>
+<variablelist>
+<varlistentry>
+<term>Interfaces</term>
+<listitem>
+<simpara>The interfaces the interface is implementing</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+<simpara>See <link linkend="Class_File_Wizard-Interfaces_Field">N4JS Class Wizard Interfaces field</link> except for the following point:</simpara>
+<simpara><emphasis>Other than classes interfaces must not be declared as <literal>@Final</literal>, therefore this option is removed.</emphasis></simpara>
+<variablelist>
+<varlistentry>
+<term>Create method stubs</term>
+<listitem>
+<simpara>Specifies if the wizard should generate method stubs for all abstract methods of the newly generated class. That are abstract super interface methods or methods that need to be implemented by the interface to conform to the given interfaces.</simpara>
+<simpara>If the selected interfaces are impossible to implement (e.g. method name overlap with unrelated parameter types) this option needs to be disabled and a warning needs to be shown.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+<simpara role="todo">Shouldn&#8217;t this be a constraint of the selected interfaces? (Never generate invalid code)</simpara>
+</section>
+<section xml:id="visibility-issues">
+<title>Visibility Issues</title>
+<simpara>As the user might select invisible interfaces, the wizard has to solve these visibility issues. See ** for details.</simpara>
+</section>
+<section xml:id="import-naming-conflicts">
+<title>Import naming conflicts</title>
+<simpara>As the user may select identically named interfaces, the wizard has to solve these naming conflicts. See
+<emphasis role="strong"><link linkend="Req-GH-1413">Class Wizard Visibility Issues</link></emphasis> for details.</simpara>
+</section>
+<section xml:id="generation-2">
+<title>Generation</title>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>Create a new file at the given module specifier location (optional)</simpara>
+</listitem>
+<listitem>
+<simpara>Insert the new interface into the specified module</simpara>
+</listitem>
+<listitem>
+<simpara>Change the source module of the super class to fix visibility issues (optional)</simpara>
+</listitem>
+<listitem>
+<simpara>Change the source module of the interfaces to fix possible visibility issues (optional)</simpara>
+</listitem>
+<listitem>
+<simpara>Change the project manifest to add a possibly new source folder (optional) or add new project dependencies (optional)</simpara>
+</listitem>
+</orderedlist>
+</section>
+<section xml:id="preview-2">
+<title>Preview</title>
+<simpara>The Interface Wizard should provided a preview. (See <link linkend="sec:N4JS_Wizards:Wizard_Preview">Wizard Preview</link>)</simpara>
+</section>
+</section>
+<section xml:id="sec:N4JS_Enum_File_Wizard">
+<title>Enum Wizard</title>
+<simpara>The N4JS Enum File wizards provides the user a wizard to create enums. When speaking of enums in this context ordinary enums as specified in the N4JS Specification are meant.</simpara>
+<section xml:id="field-properties-2">
+<title>Field Properties</title>
+<informaltable tabstyle="horizontal" frame="none" colsep="0" rowsep="0">
+<tgroup cols="2">
+<colspec colwidth="15*"/>
+<colspec colwidth="85*"/>
+<tbody valign="top">
+<row>
+<entry>
+<simpara>Project</simpara>
+</entry>
+<entry>
+<simpara>Specifies the containing project.<?asciidoc-br?>
+See <link linkend="Class_File_Wizard-Project_Field">N4JS Class Wizard Project</link></simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Source Folder</simpara>
+</entry>
+<entry>
+<simpara> Specifies the containing source folder.<?asciidoc-br?>
+See <link linkend="Class_File_Wizard-Source_Folder_Field">N4JS Class Wizard Source Folder</link></simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Module Specifier</simpara>
+</entry>
+<entry>
+<simpara>Specifies the containing source folder. See <link linkend="Class_File_Wizard-Module_Specifier_Field">N4JS Class Wizard Module specifier</link></simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Enum name</simpara>
+</entry>
+<entry>
+<simpara>Specifies the name of the interface<?asciidoc-br?></simpara>
+<variablelist>
+<varlistentry>
+<term>Constraints</term>
+<listitem>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>The name is a valid n4js enum identifier</simpara>
+</listitem>
+<listitem>
+<simpara>Must not be empty</simpara>
+</listitem>
+<listitem>
+<simpara>If the target module already exists, no other type with the same identifier may exist in this module</simpara>
+</listitem>
+</orderedlist>
+</listitem>
+</varlistentry>
+</variablelist>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>Modifiers</simpara>
+</entry>
+<entry>
+<simpara>Specifies the interface’s access modifiers
++
+Allows the user to select from following modifier options: <literal>public</literal>,<literal>project</literal>,<literal>private</literal>. The wizard automatically adds missing <literal>export</literal> if needed.
++
+Furthermore the enum can be declared <literal>@Internal</literal> using a checkbox.</simpara>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+<simpara role="todo">Should the enum wizard also provide functionality to create enum literals?</simpara>
+</section>
+<section xml:id="generation-3">
+<title>Generation</title>
+<simpara>The following changes are to be made by the wizard:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>Create a new file containing the new enum (optional, only if module doesn’t exists yet )</simpara>
+</listitem>
+<listitem>
+<simpara>Insert the new enum into the specified module</simpara>
+</listitem>
+</orderedlist>
+</section>
+<section xml:id="preview-3">
+<title>Preview</title>
+<simpara>The Enum Wizard should provided a preview. (See <link linkend="sec:N4JS_Wizards:Wizard_Preview">Wizard Preview</link>)</simpara>
+</section>
+</section>
+</chapter>
+<chapter xml:id="_execution-support">
+<title>Execution Support</title>
+<warning>
+<simpara>Parts of this document may be outdated.</simpara>
+</warning>
+<section xml:id="sec:Non_UI_Execution">
+<title>Non-UI Execution</title>
+<section xml:id="sec:Non_UI_Debugging">
+<title>Non-UI Debugging</title>
+<simpara>not supported yet</simpara>
+</section>
+</section>
+<section xml:id="sec:UI_Execution">
+<title>UI Execution</title>
+<simpara>The N4JS IDE supports launching a file via a so called "runner". That is, a selected file is started as main
+file with Node.js or Chrome, depending on the available runners.</simpara>
+<warning>
+<simpara>Chrome support not available yet.</simpara>
+</warning>
+<simpara>For testing, a file, package, or even a whole project can be executed with a "tester". In that case, instead of directly executing the selected resource with Node.js (or other runners), the "mangelhaft" framework is used to run the selected resource or all its content as tests. For test support in general, see next chapter.</simpara>
+<simpara>Running or testing a resource is done via a launch configuration. This can be configured.</simpara>
+<simpara>The node.js runner/tester allows for configuration of</simpara>
+<itemizedlist>
+<listitem>
+<simpara>the NODE_MODULE path. This can be adjusted if the automatically path is not suited.</simpara>
+</listitem>
+<listitem>
+<simpara>other environment variables (simply as key=value pairs per line)</simpara>
+</listitem>
+<listitem>
+<simpara>node.js options to be passed as arguments to node.js</simpara>
+</listitem>
+<listitem>
+<simpara>the system loader to be used, this is "System.js" by default</simpara>
+</listitem>
+</itemizedlist>
+<simpara>
+Since in the JavaScript world these configurations are often used, it is cumbersome, particularly for tests, to define them for every single file. Thus the N4JS IDE copies the node.js settings found in a project launch configuration to a resource specific launch configuration.</simpara>
+<sidebar>
+<simpara><link xl:href="https://github.com/eclipse/n4js/issues/716"><inlinemediaobject>
+<imageobject>
+<imagedata fileref="images/issue.svg"/>
+</imageobject>
+<textobject><phrase></phrase></textobject>
+</inlinemediaobject> #716</link></simpara>
+</sidebar>
+</section>
+</chapter>
+<chapter xml:id="_test-support">
+<title>Test Support</title>
+<simpara>N4IDE provides tests support by allowing different <emphasis>TestRunner</emphasis>s to extend it with test specific functionality. This allows to support specialized and very different from each other test requirements (e.g. nodejs based tests, browser based interactive ui tests, server integration tests).</simpara>
+<figure xml:id="fig:test_support_diagram">
+<title>Test Support Diagram</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/09_testsupport/fig/cd_testsupport.png"/>
+</imageobject>
+<textobject><phrase>cd testsupport</phrase></textobject>
+</mediaobject>
+</figure>
+<simpara>Explanation of the main components:</simpara>
+<variablelist>
+<varlistentry>
+<term><emphasis>User Project</emphasis></term>
+<listitem>
+<itemizedlist>
+<listitem>
+<simpara>a project with production code (e.g. <literal>src</literal> folder), and test code (e.g. test folder)</simpara>
+</listitem>
+<listitem>
+<simpara>test code may contain special language features contributed by <emphasis>Test Library</emphasis></simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><emphasis>N4IDE</emphasis></term>
+<listitem>
+<itemizedlist>
+<listitem>
+<simpara>manage user project, including all test related parts (e.g. support test related code, validate some test code constraints)</simpara>
+</listitem>
+<listitem>
+<simpara>host runner, allow its UI contributions</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><emphasis>Test Runner</emphasis></term>
+<listitem>
+<itemizedlist>
+<listitem>
+<simpara>contribute to N4IDE necessary elements (test results view, user test selection, test start/stop actions)</simpara>
+</listitem>
+<listitem>
+<simpara>use N4IDE mechanisms to access user project test fragment (e.g. discover tests)</simpara>
+</listitem>
+<listitem>
+<simpara>configure <emphasis>Test Execution Environment</emphasis></simpara>
+</listitem>
+<listitem>
+<simpara>manage test runtime (e.g. start/stop execution environment)</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><emphasis>Test Execution Environment</emphasis></term>
+<listitem>
+<itemizedlist>
+<listitem>
+<simpara>hosts (directly or indirectly) js engine in which tests are executed</simpara>
+</listitem>
+<listitem>
+<simpara>executes test library logic</simpara>
+</listitem>
+<listitem>
+<simpara>is responsible for some tests execution aspects (e.g. test isolation)</simpara>
+</listitem>
+<listitem>
+<simpara>deals with some execution errors (e.g. no callback from async test, infinite loop in test)</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><emphasis>Test Library</emphasis></term>
+<listitem>
+<itemizedlist>
+<listitem>
+<simpara>provides test api that user can use in his project</simpara>
+</listitem>
+<listitem>
+<simpara>coordinates scheduling and test code execution (e.g. order of tests, execution of setups / teardowns)</simpara>
+</listitem>
+<listitem>
+<simpara>creates test results</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+</varlistentry>
+</variablelist>
+<simpara>Below picture and listings depicts the components of the Test Runner in the IDE:</simpara>
+<figure xml:id="fig:test_runner_components">
+<title>Test Runner Components</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/09_testsupport/fig/test_runner_components.png" width="75%" scalefit="1" align="center"/>
+</imageobject>
+<textobject><phrase>test runner components</phrase></textobject>
+</mediaobject>
+</figure>
+<informaltable tabstyle="horizontal" frame="none" colsep="0" rowsep="0">
+<tgroup cols="2">
+<colspec colwidth="15*"/>
+<colspec colwidth="85*"/>
+<tbody valign="top">
+<row>
+<entry>
+<simpara><emphasis>Test Delegate</emphasis></simpara>
+</entry>
+<entry>
+<itemizedlist>
+<listitem>
+<simpara>After the test discovery it starts and stops the test session via the Test Facade.</simpara>
+</listitem>
+</itemizedlist>
+</entry>
+</row>
+<row>
+<entry>
+<simpara><emphasis>Test Facade</emphasis></simpara>
+</entry>
+<entry>
+<itemizedlist>
+<listitem>
+<simpara>Ensures that an embedded HTTP server is running to receive messages from the Test Execution Environment. Registers a test session into the IDE side via the Test Finite State Machine Registry and triggers the actual test running at Test Execution Environment.</simpara>
+</listitem>
+</itemizedlist>
+</entry>
+</row>
+<row>
+<entry>
+<simpara><emphasis>HTTP Server</emphasis></simpara>
+</entry>
+<entry>
+<itemizedlist>
+<listitem>
+<simpara>HTTP server is listening for HTTP requests from the Test Execution Environment via its RESTful API.</simpara>
+</listitem>
+</itemizedlist>
+</entry>
+</row>
+<row>
+<entry>
+<simpara><emphasis>Resource Router Servlet</emphasis></simpara>
+</entry>
+<entry>
+<itemizedlist>
+<listitem>
+<simpara>This servlet is deployed into the servlet container of the HTTP Server. The servlet percepts the HTTP requests from the Test Execution Environment and delegates the request body to the corresponding REST Endpoint Logic.</simpara>
+</listitem>
+</itemizedlist>
+</entry>
+</row>
+<row>
+<entry>
+<simpara><emphasis>REST Endpoint Logic</emphasis></simpara>
+</entry>
+<entry>
+<itemizedlist>
+<listitem>
+<simpara>Parses the HTTP request bodies, creates special events and sends them to all subscribers via the Test Event Bus.</simpara>
+</listitem>
+</itemizedlist>
+</entry>
+</row>
+<row>
+<entry>
+<simpara><emphasis>Test Event Bus</emphasis></simpara>
+</entry>
+<entry>
+<itemizedlist>
+<listitem>
+<simpara>This component is used to asynchronously deliver messages between the main test runner components in a decoupled fashion.</simpara>
+</listitem>
+</itemizedlist>
+</entry>
+</row>
+<row>
+<entry>
+<simpara><emphasis>Test Finite State Machine Registry</emphasis></simpara>
+</entry>
+<entry>
+<itemizedlist>
+<listitem>
+<simpara>This registry is used to cache test sessions represented as test trees and Test Finite State Machines. Percepts all messages initially sent by the Test Execution Environment and delegates them to the corresponding subscribers.</simpara>
+</listitem>
+</itemizedlist>
+</entry>
+</row>
+<row>
+<entry>
+<simpara><emphasis>Test Finite State Machine</emphasis></simpara>
+</entry>
+<entry>
+<itemizedlist>
+<listitem>
+<simpara>Ensures the lifecycle of a test session. Handles timeouts duo to possible communication errors between the HTTP server and the Test Execution Environment.</simpara>
+</listitem>
+</itemizedlist>
+</entry>
+</row>
+<row>
+<entry>
+<simpara><emphasis>Test Tree Registry</emphasis></simpara>
+</entry>
+<entry>
+<itemizedlist>
+<listitem>
+<simpara>Registry to handle the state of a test session. Responsible for updating a test tree associated with a test session with the received test results.</simpara>
+</listitem>
+</itemizedlist>
+</entry>
+</row>
+<row>
+<entry>
+<simpara><emphasis>Test UI</emphasis></simpara>
+</entry>
+<entry>
+<itemizedlist>
+<listitem>
+<simpara>This UI component provides feedback about the running test session to the end-user.</simpara>
+</listitem>
+</itemizedlist>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+<section xml:id="sec:N4JS_Mangelhaft_support" role="language-n4js">
+<title>N4JS Mangelhaft support</title>
+<figure xml:id="fig:xUnitSupportDesign" role="center">
+<title>xUnit Support Design</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/09_testsupport/fig/xUnitSupportDesign.png" width="75%" scalefit="1" align="center"/>
+</imageobject>
+<textobject><phrase>xUnitSupportDesign</phrase></textobject>
+</mediaobject>
+</figure>
+<simpara>In this section and subsections we specify N4IDE support for testing with Mangelhaft.</simpara>
+<simpara>Mangelhaft is N4JS <emphasis>Test Library</emphasis>. It is focused more on a xUnit tests than other forms of testing (BDD, Acceptance Testing, Functional UI Testing).</simpara>
+<simpara>The following test scenarios are supported on different <emphasis>Test Execution Environment</emphasis>s:</simpara>
+<table xml:id="tab:Test_Scenarios" frame="all" rowsep="1" colsep="1">
+<title>Test Scenarios</title>
+<tgroup cols="4">
+<colspec colname="col_1" colwidth="25*"/>
+<colspec colname="col_2" colwidth="25*"/>
+<colspec colname="col_3" colwidth="25*"/>
+<colspec colname="col_4" colwidth="25*"/>
+<thead>
+<row>
+<entry align="center" valign="top">Test</entry>
+<entry align="center" valign="top">Node</entry>
+<entry align="center" valign="top">Browser</entry>
+<entry align="center" valign="top">Wrapper</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry align="left" valign="top"><simpara><emphasis role="strong">Plain</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><literal>yes</literal></simpara></entry>
+<entry align="center" valign="top"><simpara><literal>yes</literal></simpara></entry>
+<entry align="center" valign="top"></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><emphasis role="strong">DOM</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><literal>-</literal></simpara></entry>
+<entry align="center" valign="top"><simpara><literal>yes</literal></simpara></entry>
+<entry align="center" valign="top"><simpara><literal>-</literal></simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><emphasis role="strong">non-interactive UI</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><literal>-</literal></simpara></entry>
+<entry align="center" valign="top"></entry>
+<entry align="center" valign="top"></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><emphasis role="strong">interactive UI (iUI)</emphasis></simpara></entry>
+<entry align="center" valign="top"></entry>
+<entry align="center" valign="top"></entry>
+<entry align="center" valign="top"></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><emphasis role="strong">(non UI) Server</emphasis></simpara></entry>
+<entry align="center" valign="top"></entry>
+<entry align="center" valign="top"></entry>
+<entry align="center" valign="top"></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><emphasis role="strong">iUI Server</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><literal>-</literal></simpara></entry>
+<entry align="center" valign="top"></entry>
+<entry align="center" valign="top"></entry>
+</row>
+</tbody>
+</tgroup>
+</table>
+<section xml:id="sec:Asynchronous_Tests">
+<title>Asynchronous Tests, Test Isolation and Timeouts</title>
+<simpara>A special problem about JavaScript tests is to control asynchronous tests and non-terminating tests.</simpara>
+<simpara>Performance and test isolation are conflicting goals: a perfect isolation would mean to run every tests by a separate JavaScript engine, which is not performant. For that reason, all tests are run by the same JS-engine in general. A test has to notify the test runner when it has been finished (successfully or with failure). If it does not finish in a defined time (timeout), <emphasis>Test Execution Environment</emphasis> or <emphasis>Manglehaft</emphasis> needs to handle that (e.g. restart node vm in which code is executed)&#8230;&#8203;</simpara>
+<simpara>Main concerns with running test in parallel on js side are:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>Timeouts Mangelhaft is supposed to track test timeout. If tests are running in fake parallel mode achieved by cooperative multitasking, then one test running eats up time for other test. This can cause tests to timeout when running in parallel, while succeed when running in sequential mode.</simpara>
+</listitem>
+<listitem>
+<simpara>Mutability on client. Tests running in parallel can affect each other by mutating global state in which they operate. When they run in sequential mode this can happen too, but it is much less likely to.</simpara>
+</listitem>
+<listitem>
+<simpara>Mutable state on the server. Tests running on the same session/login are prone to affecting each other through server interaction (and or mutating data on the server).</simpara>
+</listitem>
+</orderedlist>
+</section>
+<section xml:id="sec:Supported_xUnit_API">
+<title>Supported xUnit API</title>
+<simpara>xUnit API is user facing API for defining tests. It allows test developer to define tests and configure some test execution aspects. N4IDE (via <emphasis>Test Runner</emphasis> extension) supports defined API by :</simpara>
+<itemizedlist>
+<listitem>
+<simpara>gathering information via AST analysis and reflection</simpara>
+</listitem>
+<listitem>
+<simpara>presenting user available actions, based on gathered information</simpara>
+</listitem>
+<listitem>
+<simpara>gathering user input and configurations for test execution</simpara>
+</listitem>
+<listitem>
+<simpara>generating proper data for test infrastructure, based on user actions</simpara>
+</listitem>
+</itemizedlist>
+<section xml:id="sec:Test_Group">
+<title>Test Group</title>
+<simpara>A test group is a logical collection of tests. It is created by grouping <literal>N4ClassDeclarations</literal> that contain test methods or test methods directly (see <link linkend="sec:Test_Method">Test Method</link>). Those classes or individual methods can be assigned to a <emphasis>Group</emphasis> by annotating them with <literal>@Group</literal> annotation. This annotation takes non empty list of strings as parameter. Passed strings are used as category name (which is like its id).</simpara>
+<programlisting language="xtext" linenumbering="unnumbered">Annotation:
+    '@Group'
+    (' $group+=$STRING ')?
+    AnnotatedElement
+;
+
+AnnnotatedElement:
+    N4JSClassDeclaration | N4JSMethodDeclaration
+;</programlisting>
+<simpara><literal>@Group</literal> properties</simpara>
+<itemizedlist>
+<listitem>
+<simpara>name &#8594; <literal>Group</literal></simpara>
+</listitem>
+<listitem>
+<simpara>targets &#8594; N4Method, N4Class</simpara>
+</listitem>
+<listitem>
+<simpara>retention policy &#8594; RUNTIME</simpara>
+</listitem>
+<listitem>
+<simpara>transitive &#8594; YES</simpara>
+</listitem>
+<listitem>
+<simpara>repeatable &#8594; YES</simpara>
+</listitem>
+<listitem>
+<simpara>arguments &#8594; <emphasis>String</emphasis>s</simpara>
+</listitem>
+<listitem>
+<simpara>arguments are optional &#8594; NO</simpara>
+</listitem>
+</itemizedlist>
+</section>
+<section xml:id="sec:Test_Method">
+<title>Test Method</title>
+<simpara><emphasis>Test Method</emphasis> marks procedure that has to be executed by <emphasis>Test Library</emphasis>.</simpara>
+<programlisting language="xtext" linenumbering="unnumbered">Annotation:
+    '@Test'
+    AnnotatedElement
+;
+
+AnnnotatedElement:
+    N4JSMethodDeclaration
+;</programlisting>
+<simpara><literal>@Test</literal> properties</simpara>
+<itemizedlist>
+<listitem>
+<simpara>name &#8594; <literal>Test</literal></simpara>
+</listitem>
+<listitem>
+<simpara>targets &#8594; N4Method</simpara>
+</listitem>
+<listitem>
+<simpara>retention policy &#8594; RUNTIME</simpara>
+</listitem>
+<listitem>
+<simpara>transitive &#8594; NO</simpara>
+</listitem>
+<listitem>
+<simpara>repeatable &#8594; NO</simpara>
+</listitem>
+<listitem>
+<simpara>arguments &#8594; none</simpara>
+</listitem>
+</itemizedlist>
+<simpara>Additional <emphasis>TestMethod</emphasis> constraints:</simpara>
+<simpara>Test Method <anchor xml:id="cnst:Test_Method" xreflabel="[cnst:Test_Method]"/></simpara>
+<itemizedlist>
+<listitem>
+<simpara>allowed only <literal>N4ClassDeclarations</literal> in project test fragment</simpara>
+</listitem>
+<listitem>
+<simpara>method must be public</simpara>
+</listitem>
+<listitem>
+<simpara>method takes no parameters</simpara>
+</listitem>
+<listitem>
+<simpara>method return type is <literal>Promise?</literal></simpara>
+</listitem>
+<listitem>
+<simpara>method must not be referenced by other owning class members or other classes (also no <emphasis>@override</emphasis>)</simpara>
+</listitem>
+</itemizedlist>
+</section>
+<section xml:id="sec:BeforeAll">
+<title>BeforeAll Setup</title>
+<simpara><literal>@BeforeAll</literal> marks method that will be executed once before <emphasis role="strong">all</emphasis> tests in a given test class will be executed.</simpara>
+<programlisting language="xtext" linenumbering="unnumbered">Annotation:
+    '@BeforeAll'
+    AnnotatedElement
+;
+
+AnnnotatedElement:
+    N4JSMethodDeclaration
+;</programlisting>
+<simpara><literal>@BeforeAll</literal> properties</simpara>
+<itemizedlist>
+<listitem>
+<simpara>name &#8594; <literal>BeforeAll</literal></simpara>
+</listitem>
+<listitem>
+<simpara>targets &#8594; N4Method</simpara>
+</listitem>
+<listitem>
+<simpara>retention policy &#8594; RUNTIME</simpara>
+</listitem>
+<listitem>
+<simpara>transitive &#8594; NO</simpara>
+</listitem>
+<listitem>
+<simpara>repeatable &#8594; NO</simpara>
+</listitem>
+<listitem>
+<simpara>arguments &#8594; none</simpara>
+</listitem>
+</itemizedlist>
+<simpara>The same constraints apply as for the test method, see <link linkend="cnst:Test_Method">Test Method Constraints</link>.</simpara>
+</section>
+<section xml:id="sec:Before_Setup">
+<title>Before Setup</title>
+<simpara><literal>@Before</literal> marks method that will be executed once before <emphasis role="strong">each</emphasis> tests in a given test class will be executed.</simpara>
+<programlisting language="xtext" linenumbering="unnumbered">Annotation:
+    '@Before'
+    AnnotatedElement
+;
+
+AnnnotatedElement:
+    N4JSMethodDeclaration
+;</programlisting>
+<simpara><literal>@Before</literal> properties</simpara>
+<itemizedlist>
+<listitem>
+<simpara>name &#8594; <literal>Before</literal></simpara>
+</listitem>
+<listitem>
+<simpara>targets &#8594; N4Method</simpara>
+</listitem>
+<listitem>
+<simpara>retention policy &#8594; RUNTIME</simpara>
+</listitem>
+<listitem>
+<simpara>transitive &#8594; NO</simpara>
+</listitem>
+<listitem>
+<simpara>repeatable &#8594; NO</simpara>
+</listitem>
+<listitem>
+<simpara>arguments &#8594; none</simpara>
+</listitem>
+</itemizedlist>
+<simpara>The same constraints apply as for the test method, see <link linkend="cnst:Test_Method">Test Method Constraints</link>.</simpara>
+</section>
+<section xml:id="sec:After_Teardown">
+<title>After Teardown</title>
+<simpara><literal>@After</literal> marks method that will be executed once after <emphasis role="strong">each</emphasis> tests in a given test class will be executed.</simpara>
+<programlisting language="xtext" linenumbering="unnumbered">Annotation:
+    '@After'
+    AnnotatedElement
+;
+
+AnnnotatedElement:
+    N4JSMethodDeclaration
+;</programlisting>
+<simpara><literal>@After</literal> properties</simpara>
+<itemizedlist>
+<listitem>
+<simpara>name &#8594; <literal>After</literal></simpara>
+</listitem>
+<listitem>
+<simpara>targets &#8594; N4Method</simpara>
+</listitem>
+<listitem>
+<simpara>retention policy &#8594; RUNTIME</simpara>
+</listitem>
+<listitem>
+<simpara>transitive &#8594; NO</simpara>
+</listitem>
+<listitem>
+<simpara>repeatable &#8594; NO</simpara>
+</listitem>
+<listitem>
+<simpara>arguments &#8594; none</simpara>
+</listitem>
+</itemizedlist>
+<simpara>The same constraints apply as for the test method, see <link linkend="cnst:Test_Method">Test Method Constraints</link>.</simpara>
+</section>
+<section xml:id="sec:AfterAll_Teardown">
+<title>AfterAll Teardown</title>
+<simpara><literal>@AfterAll</literal> marks method that will be executed once after <emphasis role="strong">all</emphasis> tests in a given test class will be executed.</simpara>
+<programlisting language="xtext" linenumbering="unnumbered">Annotation:
+    '@After'
+    AnnotatedElement
+;
+
+AnnnotatedElement:
+    N4JSMethodDeclaration
+;</programlisting>
+<itemizedlist mark="Test Fixture][cnst:Test_Fixture">
+<listitem>
+<simpara>allowed only in class marked with <emphasis>@TestClass</emphasis></simpara>
+</listitem>
+<listitem>
+<simpara>method must be public</simpara>
+</listitem>
+<listitem>
+<simpara>method takes no parameters</simpara>
+</listitem>
+<listitem>
+<simpara>method return type is <literal>void</literal></simpara>
+</listitem>
+<listitem>
+<simpara>method must not be referenced by other owning class members</simpara>
+</listitem>
+</itemizedlist>
+<simpara><literal>@AfterAll</literal> properties</simpara>
+<itemizedlist>
+<listitem>
+<simpara>name &#8594; <literal>AfterAll</literal></simpara>
+</listitem>
+<listitem>
+<simpara>targets &#8594; N4Method</simpara>
+</listitem>
+<listitem>
+<simpara>retention policy &#8594; RUNTIME</simpara>
+</listitem>
+<listitem>
+<simpara>transitive &#8594; NO</simpara>
+</listitem>
+<listitem>
+<simpara>repeatable &#8594; NO</simpara>
+</listitem>
+<listitem>
+<simpara>arguments &#8594; none</simpara>
+</listitem>
+</itemizedlist>
+<simpara>The same constraints apply as for the test method, see <link linkend="cnst:Test_Method">Test Method Constraints</link>.</simpara>
+</section>
+<section xml:id="sec:Test_Ignore">
+<title>Test Ignore</title>
+<informaltable tabstyle="horizontal" frame="none" colsep="0" rowsep="0">
+<tgroup cols="2">
+<colspec colwidth="15*"/>
+<colspec colwidth="85*"/>
+<tbody valign="top">
+<row>
+<entry>
+<simpara>name</simpara>
+</entry>
+<entry>
+<simpara>@Ignore</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>targets</simpara>
+</entry>
+<entry>
+<simpara>N4Method, N4Class</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>retention policy</simpara>
+</entry>
+<entry>
+<simpara>RUNTIME</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>transitive</simpara>
+</entry>
+<entry>
+<simpara>YES</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>repeatable</simpara>
+</entry>
+<entry>
+<simpara>NO</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>arguments</simpara>
+</entry>
+<entry>
+<simpara>String reason</simpara>
+</entry>
+</row>
+<row>
+<entry>
+<simpara>arguments are optional</simpara>
+</entry>
+<entry>
+<simpara>&#8594; Yes</simpara>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+<simpara><emphasis>Test Ignore</emphasis> allows to mark tests that should be skipped during the test execution. That is the preferred way to temporarily disable tests without removing them (or commenting them out). Test developers may provide reason for skipping to make reason/intentions clearer.</simpara>
+<simpara>This annotation is <emphasis>transitive</emphasis>, which means that: <emphasis>Test Method</emphasis> is considered as marked with <emphasis>Test Skip</emphasis></simpara>
+<itemizedlist>
+<listitem>
+<simpara>explicitly when it is directly marked or</simpara>
+</listitem>
+<listitem>
+<simpara>implicitly, when container of a <emphasis>Test Method</emphasis> is marked.</simpara>
+</listitem>
+</itemizedlist>
+<simpara>If a class is marked as <literal>@Ignore</literal>, then all its contained test methods will be ignored.<?asciidoc-br?>
+When <literal>@Ignore</literal> occurs at class level in a test class hierarchy chain, then the following rules are applied. Assume the following test classes:</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">export public class A {
+
+    @Test
+    public aTest(): void {
+        console.log('A#aTest');
+    }
+
+}</programlisting>
+<programlisting language="n4js" linenumbering="unnumbered">import { A } from "A"
+
+@Ignore('Class B is ignored.')
+export public class B extends A {
+
+    @Test
+    public b1Test(): void {
+        console.log('B#b1Test');
+    }
+
+    @Ignore("Method B#b2Test is ignored.")
+    @Test
+    public b2Test(): void {
+        console.log("B#b2Test");
+    }
+
+}</programlisting>
+<programlisting language="n4js" linenumbering="unnumbered">import { B } from "B"
+
+export public class C extends B {
+
+    @Test
+    public cTest(): void {
+        console.log('C#cTest');
+    }
+
+}</programlisting>
+<itemizedlist>
+<listitem>
+<simpara>When module <emphasis>A</emphasis> is being tested, then it is obvious that all the test methods of <literal>A</literal> will be tested. No methods will be skipped at all.</simpara>
+</listitem>
+<listitem>
+<simpara>When module <emphasis>B</emphasis> is being tested, then although the inherited members of class <literal>A</literal> will be included in the test tree, all methods, including the inherited ones (from class <literal>A</literal> from module <emphasis>A</emphasis>) will be skipped. Nothing will be tested.</simpara>
+</listitem>
+<listitem>
+<simpara>When module <emphasis>C</emphasis> is being tested, then all inherited members from class <literal>B</literal> and class <literal>A</literal> will be collected an included in the test tree. The <literal>@Ignore</literal> annotation declared at class level at <literal>B</literal> will be ignored but the <literal>@Ignore</literal> at method level in class <literal>B</literal> will be considered. In a nutshell, the following methods will be executed:</simpara>
+<itemizedlist>
+<listitem>
+<simpara><literal>A#aTest</literal></simpara>
+</listitem>
+<listitem>
+<simpara><literal>B#b1Test</literal></simpara>
+</listitem>
+<listitem>
+<simpara><literal>C#cTest</literal></simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+</itemizedlist>
+<simpara>The above described behavior is identical to the behavior of <emphasis>JUnit 4</emphasis> with respect to the <literal>@Ignore</literal> annotation handling in case of test class inheritance.</simpara>
+</section>
+<section xml:id="sec:Timeout">
+<title>Timeout</title>
+<simpara><emphasis>Timeout</emphasis> allows test developer to set custom timeout when executing given test code. This can be used to set timeout for both <emphasis>Test Method</emphasis>s or <emphasis>Test Fixtures</emphasis></simpara>
+<programlisting language="xtext" linenumbering="unnumbered">Annotation:
+    '@Timeout'
+    ($timoeout+=$INT)?
+    AnnotatedElement
+;
+
+AnnnotatedElement:
+    N4JSClassDeclaration | N4JSMethodDeclaration
+;</programlisting>
+<simpara><literal>@Timeout</literal> properties</simpara>
+<itemizedlist>
+<listitem>
+<simpara>name &#8594; <literal>Timeout</literal></simpara>
+</listitem>
+<listitem>
+<simpara>targets &#8594; N4Method, N4Class</simpara>
+</listitem>
+<listitem>
+<simpara>retention policy &#8594; RUNTIME</simpara>
+</listitem>
+<listitem>
+<simpara>transitive &#8594; YES</simpara>
+</listitem>
+<listitem>
+<simpara>repeatable &#8594; NO</simpara>
+</listitem>
+<listitem>
+<simpara>arguments &#8594; Number</simpara>
+</listitem>
+<listitem>
+<simpara>arguments are optional &#8594; NO</simpara>
+</listitem>
+</itemizedlist>
+</section>
+<section xml:id="sec:Description">
+<title>Description</title>
+<simpara><emphasis>Description</emphasis> allows test developer provide string describing given test or test class that <emphasis>can</emphasis> be used in IDE test view or in the test report.</simpara>
+<programlisting language="xtext" linenumbering="unnumbered">Annotation:
+    '@Description'
+    ($desc+=$STRING)?
+    AnnotatedElement
+;
+
+AnnnotatedElement:
+    N4JSClassDeclaration | N4JSMethodDeclaration
+;</programlisting>
+<simpara><literal>@Description</literal> properties</simpara>
+<itemizedlist>
+<listitem>
+<simpara>name &#8594; <literal>Description</literal></simpara>
+</listitem>
+<listitem>
+<simpara>targets &#8594; N4Method, N4Class</simpara>
+</listitem>
+<listitem>
+<simpara>retention policy &#8594; RUNTIME</simpara>
+</listitem>
+<listitem>
+<simpara>transitive &#8594; YES</simpara>
+</listitem>
+<listitem>
+<simpara>arguments &#8594; String</simpara>
+</listitem>
+<listitem>
+<simpara>arguments are optional &#8594; NO</simpara>
+</listitem>
+</itemizedlist>
+</section>
+</section>
+</section>
+<section xml:id="sec:Test_Reporting">
+<title>Test Reporting</title>
+<simpara><emphasis>Test Runtime Environment</emphasis> communicates with <emphasis>Test Runner</emphasis> over HTTP. Defined communication is based on protocol used between lupenrein and old ide. It is used to send the information about test execution progress from the <emphasis>Test Runtime</emphasis> to <emphasis>Test Runner</emphasis>. Information send by this protocol is not equivalent to test results. <emphasis>Test Runner</emphasis> interprets progress it receives and based on gathered information it generates test results. Under specific conditions <emphasis>Test Runner</emphasis> may change reported test status PASS to test result FAILED and put this information to the test report e.g. when timeout happens (see note on timeouts below).</simpara>
+<figure xml:id="fig:sm_TestListener" role="center">
+<title>TestListener</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/09_testsupport/fig/sm_TestListener.png" width="25%" scalefit="1" align="center"/>
+</imageobject>
+<textobject><phrase>sm TestListener</phrase></textobject>
+</mediaobject>
+</figure>
+<simpara><link linkend="fig:sm_TestListener">Test Listener</link> shows Communication flow expected by the <emphasis>Test Runner</emphasis>. When the <emphasis>Test Runner</emphasis> is started first it waits for <emphasis>Start Session</emphasis> message. Next <emphasis>Test Tree</emphasis> message is expected. This describes list of all tests that are expected to be executed. For all tests in the list <emphasis>Test Runner</emphasis> expects <emphasis>Test Start</emphasis> and <emphasis>Test End</emphasis> message to be received. <emphasis>End Session</emphasis> is expected to be last message in the test session. <emphasis>Ping</emphasis> message can be send multiple times in between other messages to manage synchronization issues between <emphasis>Test Runner</emphasis> and <emphasis>Test Runtime</emphasis> (see below).</simpara>
+<simpara>Since all communication is asynchronous, IDE <emphasis>Test Runner</emphasis> must assume some timeout values that will define standard wait time during communication:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>Initial 90s timeout to wait for the <emphasis>Start Session</emphasis> message. It may be fixed or adjusted to given environment (local/remote) and project (library/application).</simpara>
+</listitem>
+<listitem>
+<simpara>Default timeout between all other test messages is 10 seconds. <emphasis>Test Runtime</emphasis> may notify IDE <emphasis>Test Runner</emphasis> that it should wait longer with <emphasis>Ping</emphasis> <emphasis>test message</emphasis>. This is one time thing, as soon as another command is received the default timeout will have to be reused again.</simpara>
+</listitem>
+</itemizedlist>
+<simpara>Do to the asynchronous nature of the tests, status updates can be given out of order by the Test Runtime Environment. The only sure thing is that all tests begin with <emphasis>SessionStart</emphasis> and ends with a <emphasis>SessionEnd</emphasis>. Furthermore a <emphasis>TestStart</emphasis> will be send before the <emphasis>TestEnd</emphasis> for a particular test.</simpara>
+<section xml:id="sec:Test_Messages">
+<title>Test Messages</title>
+<simpara>IDE <emphasis>Test Runner</emphasis> will be waiting for specific messages from <emphasis>Test Runtime</emphasis>. We assume that communication will be done over HTTP protocol. <emphasis>Test Execution Environement</emphasis> should be configured by the <emphasis>Test Runner</emphasis> in a way that <emphasis>Test Runtime</emphasis> knows address where it has to send messages (see
+<link linkend="sec:Test_Runtime_Configuration">Test Runtime Configuration</link>). <emphasis>Test Runner</emphasis> exposes RESTful API allowing him to receive messages. Below we define parts of that api that enable specific messages to be communicated.</simpara>
+<simpara>When defining <emphasis>Test Message</emphasis>s we assume following model of tests:</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">TestTree {
+    ID sessionId,
+    Array&lt;TestSuite&gt;? testSuites
+}
+
+TestSuite {
+    string name,
+    Array&lt;TestCase&gt;? testCases,
+    Array&lt;TestSuite&gt;? children
+}
+
+TestCase {
+    ID id,
+    string className,
+    string origin,
+    string name,
+    string displayName,
+    TestResult? result
+}
+
+TestResult {
+    TestStatus teststatus,
+    number elapsed,
+    string? expected,
+    string? actual,
+    string? message,
+    array&lt;string&gt;? trace
+}
+
+enum TestStatus {
+    PASSED, SKIPPED, FAILED, ERROR
+}
+
+ID {
+    string value
+}</programlisting>
+<section xml:id="_test-case-ids">
+<title>Test Case IDs</title>
+<simpara>The ID of a test case in the following specifications is referred to as <literal>testID</literal>.
+This ID is of the following structure:</simpara>
+<screen>testID: fqn '#' methodName</screen>
+<simpara>When used as part of the URL the testID is percent-escaped as defined in <link xl:href="https://tools.ietf.org/html/rfc3986#section-2.1">RFC3986 Section 2.1</link>. This is necessarry to circumvent the fact that the N4JS FQN delimiter <literal>/</literal> is a reserved character in URLs and cannot be used in its original form.</simpara>
+</section>
+<section xml:id="sec:Start_Session">
+<title>Start Session</title>
+<simpara>Signals start of the test session. When user triggers test execution, configures <emphasis>IDETestRunnerCtrl</emphasis>, afterwards IDE <emphasis>Listener</emphasis> waits for this message from <emphasis>TestRunner</emphasis>.</simpara>
+<programlisting language="json" linenumbering="unnumbered">StartSession :
+    uri : /n4js/testing/sessions/{sessionID}/start
+    method : POST
+    contentType : application/vnd.n4js.start_session_req.tm+json
+    accept: application/json
+    responses:
+        200:
+        400:</programlisting>
+<simpara>Start session request object MIME type <emphasis>application/vnd.n4js.start_session_req.tm+json</emphasis>:</simpara>
+<programlisting language="json" linenumbering="unnumbered">{
+    map&lt;string, string&gt;? properties
+}</programlisting>
+</section>
+<section xml:id="sec:Ping_Session">
+<title>Ping Session</title>
+<simpara>Signals that test runner is still busy doing things, and will report later to the listener.</simpara>
+<programlisting language="json" linenumbering="unnumbered">PingSession :
+    uri : /n4js/testing/sessions/{sessionID}/ping
+    method : POST
+    contentType : application/vnd.n4js.ping_session_req.tm+json
+    accept: application/json
+    responses:
+        200:
+        400:</programlisting>
+<simpara>Ping session request object MIME type <emphasis>application/vnd.n4js.ping_session_req.tm+json</emphasis>:</simpara>
+<programlisting language="json" linenumbering="unnumbered">{
+    number timeout,
+    string? comment
+}</programlisting>
+</section>
+<section xml:id="sec:End_Session">
+<title>End Session</title>
+<simpara>Signals end of test session Notifies IDE <emphasis>Listener</emphasis> that session is finished and no further related <emphasis>TestMessage</emphasis>s are expected. IDE, can stop listening and proceed with its own tasks (e.g. create summary test report ).</simpara>
+<programlisting language="json" linenumbering="unnumbered">EndSession :
+    uri : /n4js/testing/sessions/{sessionID}/end
+    method : POST
+    responses:
+        200:
+        400:</programlisting>
+</section>
+<section xml:id="sec:Start_Test">
+<title>Start Test</title>
+<simpara>Signals that a test run has started. Updates the state of the test reported with the <emphasis>tree</emphasis> .</simpara>
+<programlisting language="json" linenumbering="unnumbered">StartTest :
+    uri : /n4js/testing/sessions/{sessionID}/tests/{testID}/start
+    method : POST
+    contentType : application/vnd.n4js.start_test_req.tm+json
+    accept: application/json
+    responses:
+        200:
+            contentType : application/vnd.n4js.start_test_res.tm+json
+        400:</programlisting>
+<simpara>Start test request object MIME type <emphasis>application/vnd.n4js.start_test_req.tm+json</emphasis>:</simpara>
+<programlisting language="json" linenumbering="unnumbered">{
+    number timeout,
+    map&lt;string, string&gt;? properties
+}</programlisting>
+<simpara>Start test response object MIME type <emphasis>application/vnd.n4js.start_test_res.tm+json</emphasis>:</simpara>
+<programlisting language="json" linenumbering="unnumbered">{
+    links : [
+        {
+            rel: "ping test",
+            uri: "/n4js/testing/sessions/{sessionID}/tests/{testID}/ping"
+        },
+        {
+            rel: "end test",
+            uri: "/n4js/testing/sessions/{sessionID}/tests/{testID}/end"
+        }
+    ]
+}</programlisting>
+</section>
+<section xml:id="sec:End_Test">
+<title>End Test</title>
+<simpara>Signals that a test run has ended. Updates the state of the test reported with the <emphasis>tree</emphasis> .</simpara>
+<programlisting language="json" linenumbering="unnumbered">EndTest :
+    uri : /n4js/testing/sessions/{sessionID}/tests/{testID}/end
+    method : POST
+    contentType : application/vnd.n4js.end_test_req.tm+json
+    accept: application/json
+    responses:
+        200:
+        400:</programlisting>
+<simpara>End test request object MIME type <emphasis>application/vnd.n4js.end_test_req.tm+json</emphasis>:</simpara>
+<programlisting language="json" linenumbering="unnumbered">{
+    TestResult result
+}</programlisting>
+</section>
+<section xml:id="sec:Ping_Test">
+<title>Ping Test</title>
+<simpara>Notifies IDE that <emphasis>TestRunner</emphasis> is doing something (e.g. test setup/teardown code, long running test). Without this notification IDE might interpret long pause in received messages as timeout, <emphasis>TestRunner</emphasis> crash or other issues (in consequence it might terminate whole test execution environment).</simpara>
+<programlisting language="json" linenumbering="unnumbered">PingTest :
+    uri : /n4js/testing/sessions/{sessionID}/tests/{testID}/ping
+    method : POST
+    contentType : application/vnd.n4js.ping_test_req.tm+json
+    accept: application/json
+    responses:
+        200:
+        400:</programlisting>
+<simpara>Ping test request object MIME type <emphasis>application/vnd.n4js.ping_test_req.tm+json</emphasis>:</simpara>
+<programlisting language="json" linenumbering="unnumbered">{
+    number timeout,
+    string? comment
+}</programlisting>
+</section>
+<section xml:id="sec:Test_Catalog">
+<title>Test Catalog</title>
+<simpara>Assembles and returns with the test catalog representing all the tests available in the underlying <emphasis>IN4JSCore</emphasis> specific workspace. The content of the test catalog is calculated dynamically. The test catalog calculation depends on the current built state of the workspace. If the workspace was cleaned and not built yet, then a test catalog containing zero test suites (and test cases) will be provided as a response. If the workspace is built and in consistent state, then a catalog containing all test cases will be sent as the response body. The provided test catalog format complies to the Mangelhaft reporters.</simpara>
+<programlisting language="json" linenumbering="unnumbered">TestCatalog :
+    uri : /n4js/testing/sessions/testcatalog
+    method : GET
+    contentType : application/vnd.n4js.assemble_test_catalog_req.tm+json
+    accept: application/json
+    responses:
+        200:
+        400:</programlisting>
+<simpara>Below listings represents an example of the test catalog format:</simpara>
+<programlisting language="json" linenumbering="unnumbered">{
+  "endpoint": "http://localhost:9415",
+  "sessionId": "fc3a425c-b675-47d7-8602-8877111cf909",
+  "testDescriptors": [
+    {
+      "origin": "SysProjectA-0.0.1",
+      "fqn": "T/T",
+      "testMethods": [
+        "t"
+      ]
+    },
+    {
+      "origin": "TestProjectA-0.0.1",
+      "fqn": "A/A",
+      "testMethods": [
+        "a"
+      ]
+    },
+    {
+      "origin": "TestProjectA-0.0.1",
+      "fqn": "B/B",
+      "testMethods": [
+        "b1",
+        "b2"
+      ]
+    },
+    {
+      "origin": "TestProjectB-0.0.1",
+      "fqn": "CSub1/CSub1",
+      "testMethods": [
+        "c1",
+        "c2"
+      ]
+    },
+    {
+      "origin": "TestProjectB-0.0.1",
+      "fqn": "CSub2/CSub2",
+      "testMethods": [
+        "c1",
+        "c2",
+        "c3"
+      ]
+    }
+  ]
+}</programlisting>
+</section>
+<section xml:id="sec:Test_Session_Example">
+<title>Test Session Example</title>
+<simpara>Below example demonstrates what are the expected HTTP requests and JSON structures for a simple test group.</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">class A {
+
+    @Test
+    public void foo() {}
+
+    @Test
+    @Ignore
+    public void bar() {}
+}
+
+class B {
+
+    @Test
+    public void baz() {}
+}
+
+class C {
+
+    @Test
+    public void qux() {}
+}</programlisting>
+<programlisting language="json" linenumbering="unnumbered">Request method: POST
+Request path:   http://localhost:9415/n4js/testing/sessions/19f47a37-c1d1-4cb7-a514-1e131f26ab13/start/
+Headers:        Accept=*/*
+                Content-Type=application/vnd.n4js.start_session_req.tm+json; charset=ISO-8859-1</programlisting>
+<programlisting language="json" linenumbering="unnumbered">Request method: POST
+Request path:   http://localhost:9415/n4js/testing/sessions/19f47a37-c1d1-4cb7-a514-1e131f26ab13/tests/Test%2FC%23qux/start/
+Headers:        Accept=*/*
+                Content-Type=application/vnd.n4js.start_test_req.tm+json; charset=ISO-8859-1
+Body:
+{
+    "timeout": 1000
+}
+
+
+Request method: POST
+Request path:   http://localhost:9415/n4js/testing/sessions/19f47a37-c1d1-4cb7-a514-1e131f26ab13/tests/Test%2FB%23baz/start/
+Headers:        Accept=*/*
+                Content-Type=application/vnd.n4js.start_test_req.tm+json; charset=ISO-8859-1
+Body:
+{
+    "timeout": 1000
+}
+
+
+Request method: POST
+Request path:   http://localhost:9415/n4js/testing/sessions/19f47a37-c1d1-4cb7-a514-1e131f26ab13/tests/Test%2FA%23bar/start/
+Headers:        Accept=*/*
+                Content-Type=application/vnd.n4js.start_test_req.tm+json; charset=ISO-8859-1
+Body:
+{
+    "timeout": 1000
+}
+
+
+Request method: POST
+Request path:   http://localhost:9415/n4js/testing/sessions/19f47a37-c1d1-4cb7-a514-1e131f26ab13/tests/Test%2FA%23foo/start/
+Headers:        Accept=*/*
+                Content-Type=application/vnd.n4js.start_test_req.tm+json; charset=ISO-8859-1
+Body:
+{
+    "timeout": 1000
+}</programlisting>
+<programlisting language="json" linenumbering="unnumbered">Request method: POST
+Request path:   http://localhost:9415/n4js/testing/sessions/19f47a37-c1d1-4cb7-a514-1e131f26ab13/tests/Test%2FA%23bar/ping
+Headers:        Accept=*/*
+                Content-Type=application/vnd.n4js.ping_test_req.tm+json; charset=ISO-8859-1
+Body:
+{
+    "timeout": 1000
+}
+
+
+Request method: POST
+Request path:   http://localhost:9415/n4js/testing/sessions/19f47a37-c1d1-4cb7-a514-1e131f26ab13/tests/Test%2FC%23qux/ping/
+Headers:        Accept=*/*
+                Content-Type=application/vnd.n4js.ping_test_req.tm+json; charset=ISO-8859-1
+Body:
+{
+    "timeout": 2000
+}</programlisting>
+<programlisting language="json" linenumbering="unnumbered">Request method: POST
+Request path:   http://localhost:9415/n4js/testing/sessions/19f47a37-c1d1-4cb7-a514-1e131f26ab13/tests/Test%2FB%23baz/end/
+Headers:        Accept=*/*
+                Content-Type=application/vnd.n4js.end_test_req.tm+json; charset=ISO-8859-1
+Body:
+{
+    "message": "Some optional message.",
+        "trace": [
+        "trace_element_1",
+        "trace_element_2",
+        "trace_element_3"
+    ],
+    "expected": "1",
+    "testStatus": "FAILED",
+    "elapsedTime": 100,
+    "actual": "2"
+}
+
+
+Request method: POST
+Request path:   http://localhost:9415/n4js/testing/sessions/19f47a37-c1d1-4cb7-a514-1e131f26ab13/tests/Test%2FC%23qux/end/
+Headers:        Accept=*/*
+                Content-Type=application/vnd.n4js.end_test_req.tm+json; charset=ISO-8859-1
+Body:
+{
+    "message": "Some failure message.",
+        "trace": [
+        "trace_element_1",
+        "trace_element_2",
+        "trace_element_3"
+    ],
+    "expected": "4",
+    "testStatus": "FAILED",
+    "elapsedTime": 50,
+    "actual": "3"
+}
+
+
+Request method: POST
+Request path:   http://localhost:9415/n4js/testing/sessions/19f47a37-c1d1-4cb7-a514-1e131f26ab13/tests/Test%2F%23foo/end/
+Headers:        Accept=*/*
+                Content-Type=application/vnd.n4js.end_test_req.tm+json; charset=ISO-8859-1
+Body:
+{
+    "expected": "2",
+    "testStatus": "PASSED",
+    "elapsedTime": 60,
+    "actual": "power of 2 for 2"
+}
+
+
+Request method: POST
+Request path:   http://localhost:9415/n4js/testing/sessions/19f47a37-c1d1-4cb7-a514-1e131f26ab13/tests/Test%2FA%23bar/end/
+Headers:        Accept=*/*
+                Content-Type=application/vnd.n4js.end_test_req.tm+json; charset=ISO-8859-1
+Body:
+{
+    "testStatus": "SKIPPED",
+    "elapsedTime": 0,
+}</programlisting>
+<programlisting language="json" linenumbering="unnumbered">Request method: POST
+Request path:   http://localhost:9415/n4js/testing/sessions/19f47a37-c1d1-4cb7-a514-1e131f26ab13/end/
+Headers:        Accept=*/*
+                Content-Type=application/vnd.n4js.end_session_req.tm+json; charset=ISO-8859-1</programlisting>
+</section>
+</section>
+<section xml:id="sec:Test_Runtime_Configuration">
+<title>Test Runtime Configuration</title>
+<simpara><emphasis>Test Runner</emphasis> must gather relevant information and send it to <emphasis>Test Environment</emphasis> to allow proper test execution:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>gathering user input and test options</simpara>
+</listitem>
+<listitem>
+<simpara>gathering information about user project test code</simpara>
+</listitem>
+<listitem>
+<simpara>maintaining proper name mappings (e.g. if project is minimized test names/references must be mapped correctly)</simpara>
+</listitem>
+</itemizedlist>
+</section>
+<section xml:id="sec:Test_Plan">
+<title>Test Plan</title>
+<simpara><emphasis>Test Runner</emphasis> uses N4IDE infrastructure to obtain information about test fragment of the user project. Based on that information and user input in UI (e.g. triggering test execution on whole project) IDE can determine <emphasis>Test Method</emphasis>s that should be executed. Such test list or <emphasis>Test Plan</emphasis> is send to <emphasis>Test Environment</emphasis> and is expected to be executed by a <emphasis>Test Library</emphasis>.</simpara>
+<programlisting language="json" linenumbering="unnumbered">TestPlan {
+    Array&lt;TestProcedure&gt; procedures
+}
+
+TestProcedure {
+    string functionName,
+    string functionType,
+    string functionContainer,
+    string containerModule
+}</programlisting>
+</section>
+<section xml:id="sec:Test_Environment_Configuration">
+<title>Test Environment Configuration</title>
+<simpara>Additionally <emphasis>Test Runner</emphasis> sends to <emphasis>Test Environment</emphasis> other configuration options:</simpara>
+<itemizedlist>
+<listitem>
+<simpara><emphasis>Test Runner</emphasis> test communication protocol base url (<emphasis>baseURL</emphasis>)</simpara>
+</listitem>
+</itemizedlist>
+</section>
+<section xml:id="sec:Test_Environment_Configuration_Example">
+<title>Test Environment Configuration Example</title>
+<simpara>For example assuming that user selects <emphasis>ProjectX</emphasis> to test that contains only one test class in <emphasis>src/test/n4js/core</emphasis> path like:</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">class MyTestClass{
+
+    @BeforeAll
+    public void someOneTimeSetup(){ /* setup code */}
+
+    @Test
+    public void testA(){ /* some test code*/ }
+    @Test
+    public void testB(){ /* some test code*/ }
+    @Test
+    public void testC(){ /* some test code*/ }
+
+    @After
+    public void afterCleanup(){ /* setup code */}
+
+}</programlisting>
+<simpara>Configuration sent for <emphasis>Test Execution Environment</emphasis> would look like:</simpara>
+<programlisting language="json" linenumbering="unnumbered">{
+    "baseURL" : "http://localhost:1234/",
+    "testPlan":
+        [
+          {
+            "functionName": "someOneTimeSetup",
+            "functionType": "@BeforeAll",
+            "functionContainer": "MyTestClass",
+            "containerModule": "test/n4js/core/MyTestClass",
+          },
+          {
+            "functionName": "testA",
+            "functionType": "@Test",
+            "functionContainer": "MyTestClassA",
+            "containerModule": "test/n4js/core/MyTestClassA",
+          },
+          {
+            "functionName": "afterCleanup",
+            "functionType": "@After",
+            "functionContainer": "MyTestClassA",
+            "containerModule": "test/n4js/core/MyTestClassA",
+          },
+          {
+            "functionName": "testB",
+            "functionType": "@Test",
+            "functionContainer": "MyTestClassA",
+            "containerModule": "test/n4js/core/MyTestClassA",
+          },
+          {
+            "functionName": "afterCleanup",
+            "functionType": "@After",
+            "functionContainer": "MyTestClassA",
+            "containerModule": "test/n4js/core/MyTestClassA",
+          },
+          {
+            "functionName": "testC",
+            "functionType": "@Test",
+            "functionContainer": "MyTestClassA",
+            "containerModule": "test/n4js/core/MyTestClassA",
+          },
+          {
+            "functionName": "afterCleanup",
+            "functionType": "@After",
+            "functionContainer": "MyTestClassA",
+            "containerModule": "test/n4js/core/MyTestClassA",
+          }
+        ]
+}</programlisting>
+</section>
+</section>
+</chapter>
+<chapter xml:id="_help-system">
+<title>Help System</title>
+<section xml:id="sec:Built_In_Help">
+<title>Built-In Help</title>
+
+</section>
+<section xml:id="sec:Context_Sensitive_Help">
+<title>Context Sensitive Help</title>
+
+</section>
+<section xml:id="sec:Cheat_Sheets">
+<title>Cheat Sheets</title>
+
+</section>
+<section xml:id="sec:JSDoc">
+<title>JSDoc</title>
+
+</section>
+<section xml:id="sec:Hovering">
+<title>Hovering</title>
+<simpara>Hovering over an element (such as type, field, method, function or variable declaration) in the N4JS editor will cause a tooltip appear containing information about the underlying element. Currently this information is the type (could be the inferred type as well), the name and the keyword (such as class, variable, field) of the actual element. By default the tooltip does not grab the focus from the currently active workbench window and will automatically disappear after the focus is lost from the element. One can grab the focus for the tooltip by clicking into the tooltip area or pressing <keycap>F2</keycap> function key.</simpara>
+<section xml:id="sec:Show_Type_Information_of_Selection">
+<title>Show Type Information of Selection</title>
+<simpara>In some cases, during the development process, one would like to know what is the actual or even the inferred type of an N4JS expression. To use this functionality one can select the desired expression in the editor and invoke the ’Show Type Information’ command via the <keycap>Cmd</keycap> + <keycap>Option</keycap>+ <keycap>I</keycap> ( <keycap>Ctrl</keycap> + <keycap>Alt</keycap>+ <keycap>I</keycap> Windows/Linux) from the keyboard. This case a popup window will be raised containing the type information of the actual selection.</simpara>
+</section>
+</section>
+<section xml:id="sec:Example_Projects_and_Files">
+<title>Example Projects and Files</title>
+
+</section>
+</chapter>
+<chapter xml:id="_bug-management">
+<title>Bug Management</title>
+<warning>
+<simpara>Parts of this document may be outdated.</simpara>
+</warning>
+<section xml:id="sec:Built_In_Xpect_Support">
+<title>Built-In Xpect Support</title>
+<simpara>N4IDE contains built-in support for <link xl:href="http://www.xpect-tests.org/">xpect</link> based tests. The purpose of those is to create tests for N4IDE support for user code, not the user code itself. Users can create <emphasis>fileName.n4js.xt</emphasis> to write their test for a given N4IDE functionality. Those files can be executed (via context menu, run configurations, etc.) to verify user expectations.</simpara>
+<section xml:id="sec:Report_View">
+<title>Report View</title>
+<simpara>When executing xpect tests, users can view the results in a special view available in the IDE: <keycap>Window</keycap> &#8594; <keycap>Show View</keycap> &#8594; <keycap>Other</keycap>  &#8594; <keycap>Test Views</keycap> &#8594; <keycap>Xpect View</keycap>.</simpara>
+<figure xml:id="fig:test_view" role="center">
+<title>Test View</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/11_bugmanagement/fig/testView.png" width="75%" scalefit="1" align="center"/>
+</imageobject>
+<textobject><phrase>testView</phrase></textobject>
+</mediaobject>
+</figure>
+<simpara>This view allows user to generate bug report (see <link linkend="sec:Generate_Bug_Report">Generating Bug Reports</link>).</simpara>
+<simpara>In case of failing tests, users can see additional information (e.g. a stacktrace), or call a comparison view.</simpara>
+<figure xml:id="fig:comparison" role="center">
+<title>Comparison</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/11_bugmanagement/fig/comparison.png" width="75%" scalefit="1" align="center"/>
+</imageobject>
+<textobject><phrase>comparison</phrase></textobject>
+</mediaobject>
+</figure>
+</section>
+<section xml:id="sec:Generate_Bug_Report">
+<title>Generate Bug Report</title>
+<simpara>Generating bug reports can be done when there is some <literal>.n4js.xt</literal> file with all passing expectations, and at least one of them marked with <emphasis>FIXME</emphasis>. In this case icon of the executed test suite changes and via context menu user can call generate bug report option. When it is done, user can see contents of the bug generated in the console view. This output is prepared for out JIRA ticketing system.</simpara>
+<figure xml:id="fig:bug_report" role="center">
+<title>Bug Report</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/11_bugmanagement/fig/bugReport.png" width="75%" scalefit="1" align="center"/>
+</imageobject>
+<textobject><phrase>bugReport</phrase></textobject>
+</mediaobject>
+</figure>
+<simpara>There is also possibility to generate bug report via file selection and context menu. In this case xpect test is not executed, only bug contents are generated.</simpara>
+<figure xml:id="fig:bug" role="center">
+<title>Submited Bug</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/11_bugmanagement/fig/bug.png" width="50%" scalefit="1" align="center"/>
+</imageobject>
+<textobject><phrase>bug</phrase></textobject>
+</mediaobject>
+</figure>
+</section>
+<section xml:id="sec:Supported_Xpect_Tests">
+<title>Supported Xpect Tests</title>
+<simpara>Xpect methods are special form of comments inside <emphasis>.xt</emphasis> files. General syntax for declaring usage of such method is <emphasis>XPECT</emphasis> marker followed by <emphasis>XpectMethodName</emphasis> and parameters for that method, all placed in comment. This can have three forms:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>Single line comment (see the first comment in the listing below), Notice <emphasis role="strong"><literal>&#8594;</literal></emphasis> separating the method name and its parameters.</simpara>
+</listitem>
+<listitem>
+<simpara>Multi line comment with one method invocation, notice <emphasis role="strong"><literal>-</literal></emphasis> separating the method name and its parameters</simpara>
+</listitem>
+<listitem>
+<simpara>Multi line comment with multiple method invocations, simmilar to one above, but each line of method parameters indicates separate method invocation</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">//XPECT errors --&gt; "Couldn't resolve reference to IdentifiableElement 'consoleX'." at "consoleX"
+consoleX.log(10);
+
+/*XPECT errors ---
+ "Couldn't resolve reference to IdentifiableElement 'logY'." at "logY"
+---*/
+console.logY(10);
+
+/*XPECT errors ---
+ "Couldn't resolve reference to IdentifiableElement 'log'." at "log"
+ "Couldn't resolve reference to IdentifiableElement 'ref'." at "ref"
+ --- */
+log(ref);</programlisting>
+</listitem>
+</itemizedlist>
+<section xml:id="sec:XPECT_N4JS_Errors">
+<title>Errors, Warnings, Infos, Issues</title>
+<simpara><emphasis>Errors</emphasis>, <emphasis>Warnings</emphasis>, <emphasis>Infos</emphasis> are xpect methods that allow to capture marker of given severity. Additionally <emphasis>Issues</emphasis> allows to allow markers of all above severities.</simpara>
+<simpara>All of those methods can be used single invocations or as mutline invocations.</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">//XPECT errors --&gt; "Couldn't resolve reference to IdentifiableElement 'x'." at "x"
+console.log(x)
+
+//XPECT warnings --&gt; "Variable names should start with lower case letter." at "String"
+var String = "some string"</programlisting>
+</section>
+<section xml:id="sec:XPECT_N4JS_Noerrors">
+<title>Noerrors</title>
+<simpara>No errors allows to catch (and suppress) marker of any severity (<emphasis>error</emphasis>, <emphasis>warning</emphasis>, <emphasis>info</emphasis>).</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">//XPECT noerrors --&gt; "window object should be recognized"
+console.log(window)</programlisting>
+</section>
+<section xml:id="sec:XPECT_N4JS_Output">
+<title>Output, OutputRegex</title>
+<simpara>Output methods are special in sense that they are not intended to be used on single element of the script, but they apply to the whole script.</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">/* XPECT output ---
+&lt;==
+stdout:
+hello world
+stderr:
+==&gt;
+--- */
+console.log("hello world")</programlisting>
+<simpara>Second method accepts regex expressions. This allows to deal with troublesome output (e.g. dates)</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">/* XPECT outputRegex ---
+&lt;==
+stdout:
+[^\n]*
+stderr:
+==&gt;
+--- */
+console.log(new Date())</programlisting>
+<programlisting language="n4js" linenumbering="unnumbered">/* XPECT outputRegex ---
+&lt;==
+stdout:
+hello world
+stderr:
+
+[^\n]+
+throw ' cruel world'
+\^
+ cruel world
+==&gt;
+--- */
+console.log("hello world")
+throw ' cruel world'</programlisting>
+</section>
+<section xml:id="sec:XPECT_N4JS_Type_Of">
+<title>Type Of</title>
+<simpara>Xpect type methods allow test type inference, both for inferred type or expected type.</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">//XPECT type of 'probablySomeString' --&gt; string
+var probablySomeString = "some string";
+
+var union{string,number} u;
+// XPECT expectedType at 'null' --&gt; {function(number?):string}
+u.toString = null</programlisting>
+</section>
+<section xml:id="sec:XPECT_Advanced_Methods">
+<title>Advanced methods</title>
+<simpara>There are also other methods provided, that allow to test quick fixes and content assist. Their parameters syntax is more complicated. Additionally they actively modify contents of the editor, or even close it if needed. Their usage exceeds scope of this document.</simpara>
+</section>
+</section>
+</section>
+</chapter>
+<chapter xml:id="_cli">
+<title>CLI</title>
+<warning>
+<simpara>Parts of this document may be outdated.</simpara>
+</warning>
+<section xml:id="sec:Headless_Compiler" role="language-bash">
+<title>Headless Compiler</title>
+<simpara>The headless compiler is provided as a separate tool, coming as a single jar file <literal>n4jsc.jar</literal>. It is to be invoked via</simpara>
+<programlisting language="bash" linenumbering="unnumbered">java -jar n4jsc.jar</programlisting>
+<simpara>Simply invoking the headless compiler with no further arguments will print out a description of command line options.</simpara>
+<simpara>The headless compiler works in three major modes (given as arguments to the switch <literal>-bt</literal>):</simpara>
+<itemizedlist>
+<listitem>
+<simpara>compilation of single files (<literal>-bt singlefile</literal>, <emphasis>default</emphasis>),</simpara>
+</listitem>
+<listitem>
+<simpara>compilation of given projects (<literal>-bt projects</literal>) or</simpara>
+</listitem>
+<listitem>
+<simpara>compilation of all projects (<literal>-bt allprojects</literal>)</simpara>
+</listitem>
+</itemizedlist>
+<simpara>The command-line invocation usually has the form of</simpara>
+<programlisting language="bash" linenumbering="unnumbered">java -jar n4jsc.jar  ^$[options]$^  file1 file2 ...</programlisting>
+<simpara>Standard compiler <emphasis>options</emphasis>:</simpara>
+<variablelist>
+<varlistentry>
+<term><literal>--buildType</literal> , <literal>-bt</literal> <emphasis>mode</emphasis></term>
+<listitem>
+<simpara>With <emphasis>mode</emphasis> as exactly one of</simpara>
+<variablelist>
+<varlistentry>
+<term>singlefile</term>
+<listitem>
+<simpara>only the source files given by <emphasis>file1</emphasis>, <emphasis>file2</emphasis>, &#8230;&#8203; are compiled.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>projects</term>
+<listitem>
+<simpara><emphasis>file1</emphasis>, <emphasis>file2</emphasis>, &#8230;&#8203; denote projects (folders containing a <literal>manifest.n4mf</literal>). These projects will be compiled.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>allprojects</term>
+<listitem>
+<simpara>All project found under the project-root(s) are compiled. There should be no <emphasis>file&#8230;&#8203;</emphasis> given.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>dontcompile</term>
+<listitem>
+<simpara>Nothing will be compiled. There should be no <emphasis>file&#8230;&#8203;</emphasis> given. (This is the default if no <literal>-t</literal> option is given).</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>--projectlocations</literal> (<literal>-pl</literal>) <literal>path</literal></term>
+<listitem>
+<simpara><anchor xml:id="opt-projectlocations" xreflabel="[opt-projectlocations]"/> provide folder(s) to search for projects. If not set, the base folder of the running JVM will be taken as the location. Multiple folders are separated by the systems path-separator (’<literal>:</literal>’ on Mac / Unix and ’<literal>;</literal>’ on Windows). Only direct subfolders will be queried for projects. A subfolder is assumed to be a N4JS-project if it contains a <literal>manifest.n4mf</literal> file. All found projects are taken into consideration for dependency-resolution. Example on Linux:<?asciidoc-br?>
+  <literal>-pl  /rootA/: /rootB:/some/absolute/path/to/projects</literal>.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+<simpara>Advanced compiler options (optional):</simpara>
+<variablelist>
+<varlistentry>
+<term><literal>--notests</literal></term>
+<listitem>
+<simpara>turn off compilation of code in test-folders. Can not be combined with <literal>–testonly</literal></simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>--testonly</literal></term>
+<listitem>
+<simpara>only compile test code. Externals and sources will not be compiled. Can not be combined with <literal>–notests</literal></simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>--keepCompiling</literal></term>
+<listitem>
+<simpara>try to compile even if some errors occur.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>--preference</literal> <emphasis>file</emphasis></term>
+<listitem>
+<simpara>uses <emphasis>file</emphasis> as there internal preferences-store similar to the preferences internally stored by the N4IDE.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+<simpara>Additional command line options (optional):</simpara>
+<variablelist>
+<varlistentry>
+<term><literal>--help</literal> , <literal>-h</literal> </term>
+<listitem>
+<simpara>prints out help to the console and exits.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>--verbose</literal> , <literal>-v</literal></term>
+<listitem>
+<simpara>verbose output during build</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>--debug</literal> </term>
+<listitem>
+<simpara>before executing, summarises the information of the current setup like resolved pathnames and other information, carries on with normal workflow and prints additional status information about loading and unloading projects and processing each resource.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>--log</literal></term>
+<listitem>
+<simpara>write a log file <literal>n4jsc.log</literal> to the base folder. (Change filename with <literal>–logfile filename</literal>)</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+</section>
+<section xml:id="sec:Headless_Dependencies" role="language-bash">
+<title>Headless Dependnecies</title>
+<simpara>Compiler can manage dependencies of the processed projects:</simpara>
+<variablelist>
+<varlistentry>
+<term><literal>--installMissingDependencies</literal> , <literal>-imd</literal> </term>
+<listitem>
+<simpara>alnalyzes available projects and installs missing dependencies</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>--targetPlatformInstallLocation</literal> , <literal>-tl</literal></term>
+<listitem>
+<simpara>location to which dependencies will be installed, if not provided temporal location will be used</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>--npmrcRootLocation</literal></term>
+<listitem>
+<simpara>location of the <emphasis>.npmrc</emphasis> file to be used in <emphasis>npm</emphasis> invocations</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+</section>
+<section xml:id="sec:Headless_Execution" role="language-bash">
+<title>Headless Execution</title>
+<simpara>For headless compiling, running and testing of N4JS code a general command line tool is provided. Many parameters of the different use cases are shared. Although you can combine the use cases each of them is described in its own section. This section is about running compiled code.</simpara>
+<simpara>For compiling refer to <link linkend="sec:Headless_Compiler">Headless Compiler</link> for executing tests refer to <link linkend="_test_support">Tests</link>.</simpara>
+<section xml:id="sec:Cleaning_Headlessly">
+<title>Cleaning Headlessly</title>
+<simpara>It is possible to use the headless compiler to clean projects by using the following option</simpara>
+<variablelist>
+<varlistentry>
+<term><literal>--clean</literal> (<literal>-c</literal>)</term>
+<listitem>
+<simpara>When this option is used. The headless compiler only cleans projects without compilation. Moreover, the use of this option requires that the option <literal>-t</literal> must be specified and must be either <literal>-t projects</literal> or <literal>-t allprojects</literal>.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+<simpara>For instance, <literal>n4jsc --clean -t allprojects -pl path/to/project</literal> or <literal>n4jsc --clean -t projects project1 project2</literal> are valid use while <literal>n4jsc --clean -t singlefile file1 file2</literal> is invalid.
+After the calling the command with <literal>--clean (</literal>-c`), the output folders of the specified projects (e.g. <literal>src-gen</literal> folders) are cleaned.</simpara>
+</section>
+<section xml:id="sec:Running_Headlessly">
+<title>Running Headlessly</title>
+<simpara>Running code from the command line requires basically three different pieces of information:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>The locations where projects, libraries and environments can be found must be given.</simpara>
+</listitem>
+<listitem>
+<simpara>The starting point of execution must be given by pointing to a module.</simpara>
+</listitem>
+<listitem>
+<simpara>Since there are multiple different project types, an adequate Runner has to be selected.</simpara>
+</listitem>
+</orderedlist>
+<simpara>The follwing command line switches are used to provide this information:</simpara>
+<variablelist>
+<varlistentry>
+<term><literal>--projectlocations</literal> (<literal>-pl</literal>) <literal>path</literal></term>
+<listitem>
+<simpara>path of locations to search for projects (c.f. <link linkend="sec:Headless_Compiler">Headless Compiler</link> ,<link linkend="opt-projectlocations">Project Locations</link>)</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>--runWith</literal> (<literal>-rw</literal>) <literal>VAL</literal></term>
+<listitem>
+<simpara>denotes the runner-id (as listed with --list-runners) or at least the last segment of it</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>--run</literal> (<literal>-r</literal>) <literal>FILE</literal></term>
+<listitem>
+<simpara>source-module to run. Note you should point to the full location of the source file (*.n4js). The runner is <emphasis>responsible to determine the compiled file</emphasis>. It is not sufficient to give a project-relative path, it always needs to be a full path to the source file.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+<simpara>It is possible to compile and run with a single CLI line. Compilation always precedes the execution. It the compilation fails the runner will not be started.</simpara>
+<simpara>To ease the usage of different runners it is allowed to provide the last segment(s) of the runner-id in a case-insensitive way, e.g. one can use the runner with id <literal>org.eclipse.n4js.runner.nodejs.NODEJS</literal> as follows:</simpara>
+<programlisting language="bash" linenumbering="unnumbered">.. --runWith org.eclipse.n4js.runner.nodejs.NODEJS ..</programlisting>
+<simpara>or in short</simpara>
+<programlisting language="bash" linenumbering="unnumbered">.. --rw NODEJS ..</programlisting>
+<simpara>or even lower-cased with</simpara>
+<programlisting language="bash" linenumbering="unnumbered">.. --rw nodejs ..</programlisting>
+<simpara>Assume having a common workspace location ’wsp’ with a project ’P1’ containing the module ’A’. The following line shows how to run this code:</simpara>
+<programlisting language="bash" linenumbering="unnumbered">java -jar n4jsc.jar -pl wsp -rw nodejs -r wsp/P1/src/A.n4js</programlisting>
+</section>
+<section xml:id="sec:Information_about_running_headlessly">
+<title>Information about running headlessly</title>
+<simpara>Available runner-ids can be actively queried:</simpara>
+<variablelist>
+<varlistentry>
+<term><literal>--listRunners</literal> (<literal>-lr</literal>)</term>
+<listitem>
+<simpara>prints out a list of all available command-line runners</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+</section>
+<section xml:id="sec:Testing_Headlessly">
+<title>Testing Headlessly</title>
+<simpara>Testing code from the command line requires basically three different pieces of information:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>The locations where projects, libraries and environments can be found must be given.</simpara>
+</listitem>
+<listitem>
+<simpara>The starting point of test execution must be given by pointing to what is supposed to be tested (single file / whole project)/</simpara>
+</listitem>
+<listitem>
+<simpara>Since there are multiple different project types, an adequate Tester has to be selected.</simpara>
+</listitem>
+</orderedlist>
+<simpara>The follwing command line switches are used to provide this information:</simpara>
+<variablelist>
+<varlistentry>
+<term><literal>--projectlocations</literal> (<literal>-pl</literal>) <literal>path</literal></term>
+<listitem>
+<simpara>path of locations to search for projects (c.f. <link linkend="sec:Headless_Compiler">Headless Compiler</link> ,<link linkend="opt-projectlocations">Project Locations</link>)</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>--testWith</literal> (<literal>-tw</literal>) <literal>VAL</literal></term>
+<listitem>
+<simpara>denotes the tester-id (as listed with --list-testers) or at least the last segment of it</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>--test</literal> (<literal>-t</literal>) <literal>FILE</literal></term>
+<listitem>
+<simpara>source-module to run. Note you should point to the full location of the project with tests, specific folder inside project with tests or the test source file (*.n4js). It is not sufficient to give a project-relative path, it always needs to be a full path to the source file.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+<simpara>It is possible to compile and run with a single CLI line. Compilation always precedes the execution. It the compilation fails the tester will not be started.</simpara>
+<simpara>To ease the usage of different testers it is allowed to provide the last segment(s) of the tester-id in a case-insensitive way, e.g. one can use the runner with id <literal>org.eclipse.n4js.tester.nodejs.NODEJS_MANGELHAFT</literal> as follows:</simpara>
+<programlisting language="bash" linenumbering="unnumbered">.. --runWith org.eclipse.n4js.tester.nodejs.NODEJS_MANGELHAFT ..</programlisting>
+<simpara>or in short</simpara>
+<programlisting language="bash" linenumbering="unnumbered">.. --rw NODEJS_MANGELHAFT ..</programlisting>
+<simpara>or even lower-cased with</simpara>
+<programlisting language="bash" linenumbering="unnumbered">.. --rw nodejs_mangelhaft ..</programlisting>
+<simpara>Assume having a common workspace location ’wsp’ with a project ’P1’ containing the module ’TestA’. The following line shows how to execute this test code:</simpara>
+<programlisting language="bash" linenumbering="unnumbered">java -jar n4jsc.jar -pl wsp -tw nodejs_mangelhaft -t wsp/P1/src/TestA.n4js</programlisting>
+</section>
+<section xml:id="sec:Information_about_testing_headlessly">
+<title>Information about testing headlessly</title>
+<simpara>Available tester-ids can be actively queried:</simpara>
+<variablelist>
+<varlistentry>
+<term><literal>--listTesters</literal> (<literal>-lt</literal>)</term>
+<listitem>
+<simpara>prints out a list of all available command-line testers</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+</section>
+<section xml:id="_testresults">
+<title>TestResults</title>
+<simpara>TODO</simpara>
+<simpara><?asciidoc-pagebreak?></simpara>
+</section>
+</section>
+</chapter>
+<appendix xml:id="sec:License">
+<title>License</title>
+<simpara>This specification and the accompanying materials is made available
+under the terms of the Eclipse Public License v1.0 which accompanies
+this distribution, and is available at <link xl:href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</link></simpara>
+<bridgehead xml:id="_eclipse-public-license-v-1-0" renderas="sect2">Eclipse Public License - v 1.0</bridgehead>
+<simpara>THE ACCOMPANYING PROGRAM IS PROVIDED UNDER THE TERMS OF THIS ECLIPSE
+PUBLIC LICENSE (<literal>AGREEMENT</literal>). ANY USE, REPRODUCTION OR DISTRIBUTION OF
+THE PROGRAM CONSTITUTES RECIPIENT’S ACCEPTANCE OF THIS AGREEMENT.</simpara>
+<bridgehead xml:id="_1-definitions" renderas="sect3">1. DEFINITIONS</bridgehead>
+<variablelist>
+<varlistentry>
+<term><literal>Contribution</literal> means: </term>
+<listitem>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>in the case of the initial Contributor, the initial code and
+documentation distributed under this Agreement, and</simpara>
+</listitem>
+<listitem>
+<simpara>in the case of each subsequent Contributor:</simpara>
+<orderedlist numeration="loweralpha">
+<listitem>
+<simpara>changes to the Program, and</simpara>
+</listitem>
+<listitem>
+<simpara>additions to the Program;</simpara>
+<simpara>where such changes and/or additions to the Program originate from and
+are distributed by that particular Contributor. A Contribution
+’originates’ from a Contributor if it was added to the Program by such
+Contributor itself or anyone acting on such Contributor’s behalf.
+Contributions do not include additions to the Program which:</simpara>
+<orderedlist numeration="lowerroman">
+<listitem>
+<simpara>are separate modules of software distributed in conjunction with the Program
+under their own license agreement, and</simpara>
+</listitem>
+<listitem>
+<simpara>are not derivative works of the Program.</simpara>
+</listitem>
+</orderedlist>
+</listitem>
+</orderedlist>
+</listitem>
+</orderedlist>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>Contributor</literal></term>
+<listitem>
+<simpara>means any person or entity that distributes the Program.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>Licensed Patents</literal> </term>
+<listitem>
+<simpara>mean patent claims licensable by a Contributor
+which are necessarily infringed by the use or sale of its Contribution
+alone or when combined with the Program.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>Program</literal> </term>
+<listitem>
+<simpara>means the Contributions distributed in accordance with this
+Agreement.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>Recipient</literal> </term>
+<listitem>
+<simpara>means anyone who receives the Program under this
+Agreement, including all Contributors.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+<bridgehead xml:id="_2-grant-of-rights" renderas="sect3">2. GRANT OF RIGHTS</bridgehead>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>Subject to the terms of this Agreement, each Contributor hereby
+grants Recipient a non-exclusive, worldwide, royalty-free copyright
+license to reproduce, prepare derivative works of, publicly display,
+publicly perform, distribute and sublicense the Contribution of such
+Contributor, if any, and such derivative works, in source code and
+object code form.</simpara>
+</listitem>
+<listitem>
+<simpara>Subject to the terms of this Agreement, each Contributor hereby
+grants Recipient a non-exclusive, worldwide, royalty-free patent license
+under Licensed Patents to make, use, sell, offer to sell, import and
+otherwise transfer the Contribution of such Contributor, if any, in
+source code and object code form. This patent license shall apply to the
+combination of the Contribution and the Program if, at the time the
+Contribution is added by the Contributor, such addition of the
+Contribution causes such combination to be covered by the Licensed
+Patents. The patent license shall not apply to any other combinations
+which include the Contribution. No hardware per se is licensed
+hereunder.</simpara>
+</listitem>
+<listitem>
+<simpara>Recipient understands that although each Contributor grants the
+licenses to its Contributions set forth herein, no assurances are
+provided by any Contributor that the Program does not infringe the
+patent or other intellectual property rights of any other entity. Each
+Contributor disclaims any liability to Recipient for claims brought by
+any other entity based on infringement of intellectual property rights
+or otherwise. As a condition to exercising the rights and licenses
+granted hereunder, each Recipient hereby assumes sole responsibility to
+secure any other intellectual property rights needed, if any. For
+example, if a third party patent license is required to allow Recipient
+to distribute the Program, it is Recipient’s responsibility to acquire
+that license before distributing the Program.</simpara>
+</listitem>
+<listitem>
+<simpara>Each Contributor represents that to its knowledge it has sufficient
+copyright rights in its Contribution, if any, to grant the copyright
+license set forth in this Agreement.</simpara>
+</listitem>
+</orderedlist>
+<bridgehead xml:id="_3-requirements" renderas="sect3">3. REQUIREMENTS</bridgehead>
+<simpara>A Contributor may choose to distribute the Program in object code form
+under its own license agreement, provided that:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>it complies with the terms and conditions of this Agreement; and</simpara>
+</listitem>
+<listitem>
+<simpara>its license agreement:</simpara>
+<orderedlist numeration="loweralpha">
+<listitem>
+<simpara>effectively disclaims on behalf of all Contributors all warranties
+and conditions, express and implied, including warranties or conditions
+of title and non-infringement, and implied warranties or conditions of
+merchantability and fitness for a particular purpose;</simpara>
+</listitem>
+<listitem>
+<simpara>effectively excludes on behalf of all Contributors all liability for
+damages, including direct, indirect, special, incidental and
+consequential damages, such as lost profits;</simpara>
+</listitem>
+<listitem>
+<simpara>states that any provisions which differ from this Agreement are
+offered by that Contributor alone and not by any other party; and</simpara>
+</listitem>
+<listitem>
+<simpara>states that source code for the Program is available from such
+Contributor, and informs licensees how to obtain it in a reasonable
+manner on or through a medium customarily used for software exchange.</simpara>
+</listitem>
+</orderedlist>
+</listitem>
+</orderedlist>
+<simpara>When the Program is made available in source code form:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>it must be made available under this Agreement; and</simpara>
+</listitem>
+<listitem>
+<simpara>a copy of this Agreement must be included with each copy of the
+Program.</simpara>
+</listitem>
+</orderedlist>
+<simpara>Contributors may not remove or alter any copyright notices contained
+within the Program.</simpara>
+<simpara>Each Contributor must identify itself as the originator of its
+Contribution, if any, in a manner that reasonably allows subsequent
+Recipients to identify the originator of the Contribution.</simpara>
+<bridgehead xml:id="_4-commercial-distribution" renderas="sect3">4. COMMERCIAL DISTRIBUTION</bridgehead>
+<simpara>Commercial distributors of software may accept certain responsibilities
+with respect to end users, business partners and the like. While this
+license is intended to facilitate the commercial use of the Program, the
+Contributor who includes the Program in a commercial product offering
+should do so in a manner which does not create potential liability for
+other Contributors. Therefore, if a Contributor includes the Program in
+a commercial product offering, such Contributor (<literal>Commercial
+Contributor</literal>) hereby agrees to defend and indemnify every other
+Contributor (<literal>Indemnified Contributor</literal>) against any losses, damages
+and costs (collectively <literal>Losses</literal>) arising from claims, lawsuits and
+other legal actions brought by a third party against the Indemnified
+Contributor to the extent caused by the acts or omissions of such
+Commercial Contributor in connection with its distribution of the
+Program in a commercial product offering. The obligations in this
+section do not apply to any claims or Losses relating to any actual or
+alleged intellectual property infringement. In order to qualify, an
+Indemnified Contributor must: a) promptly notify the Commercial
+Contributor in writing of such claim, and b) allow the Commercial
+Contributor to control, and cooperate with the Commercial Contributor
+in, the defense and any related settlement negotiations. The Indemnified
+Contributor may participate in any such claim at its own expense.</simpara>
+<simpara>For example, a Contributor might include the Program in a commercial
+product offering, Product X. That Contributor is then a Commercial
+Contributor. If that Commercial Contributor then makes performance
+claims, or offers warranties related to Product X, those performance
+claims and warranties are such Commercial Contributor’s responsibility
+alone. Under this section, the Commercial Contributor would have to
+defend claims against the other Contributors related to those
+performance claims and warranties, and if a court requires any other
+Contributor to pay any damages as a result, the Commercial Contributor
+must pay those damages.</simpara>
+<bridgehead xml:id="_5-no-warranty" renderas="sect3">5. NO WARRANTY</bridgehead>
+<simpara>EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, THE PROGRAM IS PROVIDED
+ON AN <literal>AS IS</literal> BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,
+EITHER EXPRESS OR IMPLIED INCLUDING, WITHOUT LIMITATION, ANY WARRANTIES
+OR CONDITIONS OF TITLE, NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR
+A PARTICULAR PURPOSE. Each Recipient is solely responsible for
+determining the appropriateness of using and distributing the Program
+and assumes all risks associated with its exercise of rights under this
+Agreement , including but not limited to the risks and costs of program
+errors, compliance with applicable laws, damage to or loss of data,
+programs or equipment, and unavailability or interruption of operations.</simpara>
+<bridgehead xml:id="_6-disclaimer-of-liability" renderas="sect3">6. DISCLAIMER OF LIABILITY</bridgehead>
+<simpara>EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, NEITHER RECIPIENT NOR
+ANY CONTRIBUTORS SHALL HAVE ANY LIABILITY FOR ANY DIRECT, INDIRECT,
+INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING
+WITHOUT LIMITATION LOST PROFITS), HOWEVER CAUSED AND ON ANY THEORY OF
+LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OR
+DISTRIBUTION OF THE PROGRAM OR THE EXERCISE OF ANY RIGHTS GRANTED
+HEREUNDER, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.</simpara>
+<bridgehead xml:id="_7-general" renderas="sect3">7. GENERAL</bridgehead>
+<simpara>If any provision of this Agreement is invalid or unenforceable under
+applicable law, it shall not affect the validity or enforceability of
+the remainder of the terms of this Agreement, and without further action
+by the parties hereto, such provision shall be reformed to the minimum
+extent necessary to make such provision valid and enforceable.</simpara>
+<simpara>If Recipient institutes patent litigation against any entity (including
+a cross-claim or counterclaim in a lawsuit) alleging that the Program
+itself (excluding combinations of the Program with other software or
+hardware) infringes such Recipient’s patent(s), then such Recipient’s
+rights granted under Section 2(b) shall terminate as of the date such
+litigation is filed.</simpara>
+<simpara>All Recipient’s rights under this Agreement shall terminate if it fails
+to comply with any of the material terms or conditions of this Agreement
+and does not cure such failure in a reasonable period of time after
+becoming aware of such noncompliance. If all Recipient’s rights under
+this Agreement terminate, Recipient agrees to cease use and distribution
+of the Program as soon as reasonably practicable. However, Recipient’s
+obligations under this Agreement and any licenses granted by Recipient
+relating to the Program shall continue and survive.</simpara>
+<simpara>Everyone is permitted to copy and distribute copies of this Agreement,
+but in order to avoid inconsistency the Agreement is copyrighted and may
+only be modified in the following manner. The Agreement Steward reserves
+the right to publish new versions (including revisions) of this
+Agreement from time to time. No one other than the Agreement Steward has
+the right to modify this Agreement. The Eclipse Foundation is the
+initial Agreement Steward. The Eclipse Foundation may assign the
+responsibility to serve as the Agreement Steward to a suitable separate
+entity. Each new version of the Agreement will be given a distinguishing
+version number. The Program (including Contributions) may always be
+distributed subject to the version of the Agreement under which it was
+received. In addition, after a new version of the Agreement is
+published, Contributor may elect to distribute the Program (including
+its Contributions) under the new version. Except as expressly stated in
+Sections 2(a) and 2(b) above, Recipient receives no rights or licenses
+to the intellectual property of any Contributor under this Agreement,
+whether expressly, by implication, estoppel or otherwise. All rights in
+the Program not expressly granted under this Agreement are reserved.</simpara>
+<simpara>This Agreement is governed by the laws of the State of New York and the
+intellectual property laws of the United States of America. No party to
+this Agreement will bring a legal action under this Agreement more than
+one year after the cause of action arose. Each party waives its rights
+to a jury trial in any resulting litigation.</simpara>
+</appendix>
+<appendix xml:id="sec:Acronyms">
+<title>Acronyms</title>
+<informaltable xml:id="AC" role="language-bash" frame="all" rowsep="1" colsep="1">
+<tgroup cols="4">
+<colspec colname="col_1" colwidth="8.3333*"/>
+<colspec colname="col_2" colwidth="41.6666*"/>
+<colspec colname="col_3" colwidth="8.3333*"/>
+<colspec colname="col_4" colwidth="41.6668*"/>
+<tbody>
+<row>
+<entry align="center" valign="top"><simpara><literal>CDep</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">Compile-Time Dependency</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><literal>RDep</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">Run-Time Dependency</emphasis></simpara></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><literal>LDep</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">Load-Time Dependency</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><literal>IDep</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">Initialization-Time Dependency</emphasis></simpara></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><literal>EDep</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">Execution-Time Dependency</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><literal>ANTLR</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">ANother Tool for Language Recognition</emphasis></simpara></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><literal>API</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">Application Programming Interface</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><literal>AST</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">Abstract Syntax Tree</emphasis></simpara></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><literal>ASI</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">Automatic Semicolon Insertion</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><literal>BNF</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">Backus-Naur Form</emphasis></simpara></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><literal>CLI</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">Command Line Interface (including a headless compiler and runner.)</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><literal>DI</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">Dependency Injection</emphasis></simpara></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><literal>DIC</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">DI Component</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><literal>DOM</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">Document Object Model</emphasis></simpara></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><literal>DSL</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">Domain Specific Language</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><literal>EBNF</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">Extended Backus-Naur Form</emphasis></simpara></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><literal>EMF</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">Eclipse Modeling Framework <anchor xml:id="EMF" xreflabel="[EMF]"/></emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><literal>FQN</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">Fully Qualified Name</emphasis></simpara></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><literal>GLB</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">Greatest Lower Bound, also known as <emphasis>infimum</emphasis></emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><literal>GCST</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">Greatest Common Sub Type, also known as <emphasis>meet</emphasis></emphasis></simpara></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><literal>IDE</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">Integrated Development Environment</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><literal>IDL</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">Interface Definition Language</emphasis></simpara></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><literal>LSP</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">Liskov Substitution Principle [<link linkend="Martin96b">Martin96b</link>]</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><literal>LUB</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">Least Upper Bound, also known as <emphasis>supremum</emphasis></emphasis></simpara></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><literal>LCST</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">Least Common Super Type, also known as <emphasis>join</emphasis></emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><literal>N4JS</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">N4JS for JavaScript</emphasis></simpara></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><literal>N4JSED</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">N4JS Environment Definition</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><literal>N4JSIDE</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">N4JS Integrated Development Environment (Eclipse-based IDE for all N4JS related languages and projects)</emphasis></simpara></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><literal>VM</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">Virtual Machine</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><literal>XML</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">Extensible Markup Language</emphasis></simpara></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><literal>XSLT / XSL</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">XSL Transformations</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><literal>XSL</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">Extensible Stylesheet Language</emphasis></simpara></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><literal>WYSIWYG</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">What You See Is What You Get</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><literal>WLOG</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">Without loss of generality</emphasis></simpara></entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+</appendix>
+<appendix xml:id="_bibliography">
+<title>Bibliography</title>
+<simpara><anchor xml:id="N4JSSpec" xreflabel="[N4JSSpec]"/><emphasis>N4JS Language Specification</emphasis>. </simpara>
+<simpara><anchor xml:id="Martin96b" xreflabel="[Martin96b]"/>Martin, Robert C. (1996). <emphasis>The Liskov Substitution Principle</emphasis>. Retrieved from <link xl:href="http://www.objectmentor.com/publications/lsp.pdf">http://www.objectmentor.com/publications/lsp.pdf</link></simpara>
+</appendix>
+</book>
\ No newline at end of file
diff --git a/idespec/appendix_a_license.html b/idespec/appendix_a_license.html
new file mode 100644
index 0000000..cfd8d07
--- /dev/null
+++ b/idespec/appendix_a_license.html
@@ -0,0 +1,658 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="generator" content="Asciidoctor 1.5.5">
+<meta name="author" content="2019-08-07 15:02:40 CEST">
+<title>N4JS IDE Specification</title>
+<link rel="stylesheet" href="styles/spec.min.css">
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.6.3/css/font-awesome.min.css">
+<!-- ************* docinfo ******************************************************************* -->
+
+
+<!-- ************* Favicon ************-->
+<link rel="icon" href="images/favicon.ico" />
+
+<!-- ************* Back-to-top JQuery ************* -->
+<script src="https://code.jquery.com/jquery-1.12.4.js"></script>
+<script src="https://code.jquery.com/ui/1.12.0/jquery-ui.js"></script>
+
+
+<link href="styles/prism.min.css" rel="stylesheet" />
+<script type="text/javascript" async
+  src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2/MathJax.js?config=TeX-MML-AM_CHTML">
+</script>
+
+<!-- ************* Styles ************* -->
+<link rel="stylesheet" type="text/css" href="styles/n4jsspec-adoc.css">
+
+
+<!-- ****************** NavBar ****************** -->
+<div id="menubar">
+	<div class="banner">
+        <a href="https://www.eclipse.org/n4js/#"><img id="logo" src="images/n4js-logo.png" alt="Eclipse N4JS"></a>
+    </div>
+<ul>
+  <li><a href="index.html">Index</a></li>
+</ul>
+</div>
+<!-- ************* docinfo ******************************************************************* -->
+<style>
+      .admonitionblock td.icon .icon-todo:before{content:"\f249";color:#f4ee42}
+    </style>
+</head>
+<body class="book toc2 toc-left">
+<div id="header">
+<h1>N4JS IDE Specification</h1>
+<div class="details">
+<span id="author" class="author">2019-08-07 15:02:40 CEST</span><br>
+<span id="revnumber">version 0.9</span>
+</div>
+<div id="toc" class="toc2">
+<div id="toctitle">Table of Contents</div>
+<ul class="sectlevel1">
+<li><a href="views.html#sec:Views">1. Views</a>
+<ul class="sectlevel2">
+<li><a href="views.html#_eclipse-standard-views">1.1. Eclipse Standard Views</a>
+<ul class="sectlevel3">
+<li><a href="views.html#sec:Project_Explorer_View">1.1.1. Project Explorer</a></li>
+<li><a href="views.html#sec:Outline_View">1.1.2. Outline</a></li>
+<li><a href="views.html#sec:Problems_View">1.1.3. Problems</a></li>
+<li><a href="views.html#sec:Console_View">1.1.4. Console</a></li>
+<li><a href="views.html#sec:History_View">1.1.5. History</a></li>
+<li><a href="views.html#sec:Error_Log_View">1.1.6. Error Log</a></li>
+</ul>
+</li>
+<li><a href="views.html#_n4js-specific-views">1.2. N4JS Specific Views</a>
+<ul class="sectlevel3">
+<li><a href="views.html#_test-results">1.2.1. Test Results</a></li>
+<li><a href="views.html#_source-graphs">1.2.2. Source Graphs</a></li>
+<li><a href="views.html#_api-compare">1.2.3. API Compare</a></li>
+<li><a href="views.html#_performance-graphs">1.2.4. Performance Graphs</a></li>
+<li><a href="views.html#_source-mapping">1.2.5. Source Mapping</a></li>
+<li><a href="views.html#_xpect-view">1.2.6. Xpect View</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="navigation.html#_navigation">2. Navigation</a>
+<ul class="sectlevel2">
+<li><a href="navigation.html#sec:Outline_Navigation">2.1. Outline</a>
+<ul class="sectlevel3">
+<li><a href="navigation.html#_quick-outline">2.1.1. Quick Outline</a></li>
+<li><a href="navigation.html#_normal-outline">2.1.2. Normal Outline</a></li>
+</ul>
+</li>
+<li><a href="navigation.html#_navigation-commands">2.2. Navigation Commands</a>
+<ul class="sectlevel3">
+<li><a href="navigation.html#sec:Navigate_to_Declaration">2.2.1. Navigate to Declaration</a></li>
+<li><a href="navigation.html#sec:find_by_references">2.2.2. Find by References</a></li>
+<li><a href="navigation.html#sec:Open_Type_Declaration">2.2.3. Open Type Declaration</a></li>
+</ul>
+</li>
+<li><a href="navigation.html#sec:Working_Sets">2.3. Working Sets</a>
+<ul class="sectlevel3">
+<li><a href="navigation.html#sec:Working_Set_Managers">2.3.1. Working Set Managers</a></li>
+<li><a href="navigation.html#sec:Working_Set_Constraints">2.3.2. Working Set Constraints</a></li>
+<li><a href="navigation.html#sec:Manual_Association_Working_Set_Manager_UI_Features">2.3.3. Manual Association Working Set Manager - UI Features</a></li>
+<li><a href="navigation.html#sec:Project_Name_Filter_Working_Set_Manager">2.3.4. Project Name Filter Working Set Manager</a></li>
+<li><a href="navigation.html#sec:Git_Repository_Working_Set_Manager">2.3.5. Git Repository Working Set Manager</a></li>
+<li><a href="navigation.html#sec:Project_Location_Working_Set_Manager">2.3.6. Project Location Working Set Manager</a></li>
+<li><a href="navigation.html#sec:N4JS_Project_Type_Working_Set_Manager">2.3.7. N4JS Project Type Working Set Manager</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="assistance.html#_assistance">3. Assistance</a>
+<ul class="sectlevel2">
+<li><a href="assistance.html#sec:Content_Assist">3.1. Content Assist</a>
+<ul class="sectlevel3">
+<li><a href="assistance.html#sec:Complete_Keywords">3.1.1. Complete Keywords</a></li>
+<li><a href="assistance.html#sec:Complete_Annotations">3.1.2. Complete Annotations</a></li>
+<li><a href="assistance.html#sec:Complete_Identifier_Reference">3.1.3. Complete Identifier Reference</a></li>
+<li><a href="assistance.html#sec:Complete_Member_Overrides">3.1.4. Complete Member Overrides</a></li>
+<li><a href="assistance.html#sec:Constructor_Completion">3.1.5. Constructor Completion</a></li>
+<li><a href="assistance.html#sec:Complete_Function_Expression">3.1.6. Complete Function Expression with Known Type</a></li>
+<li><a href="assistance.html#sec:Complete_Variable_and_Parameter_Names">3.1.7. Complete Variable and Parameter Names</a></li>
+</ul>
+</li>
+<li><a href="assistance.html#sec:Quick_Fixes">3.2. Quick Fixes</a>
+<ul class="sectlevel3">
+<li><a href="assistance.html#sec:N4JS_Issue_Properties">3.2.1. N4JS Issue User data</a></li>
+<li><a href="assistance.html#sec:N4JS_Issue_Fixes">3.2.2. N4JS Issue Fixes</a>
+<ul class="sectlevel4">
+<li><a href="assistance.html#sec:Linking_Issues">3.2.2.1. Linking Issues</a></li>
+<li><a href="assistance.html#sec:Import_Issues">3.2.2.2. Import Issues</a></li>
+<li><a href="assistance.html#sec:Visibility_Issues">3.2.2.3. Visibility Issues</a></li>
+<li><a href="assistance.html#sec:Classifier_Issues">3.2.2.4. Classifier Issues</a></li>
+<li><a href="assistance.html#sec:Function_Issues">3.2.2.5. Function Issues</a></li>
+<li><a href="assistance.html#sec:Syntax_Issues">3.2.2.6. Syntax Issues</a></li>
+<li><a href="assistance.html#sec:Conversion_Issues">3.2.2.7. Conversion Issues</a></li>
+<li><a href="assistance.html#sec:Type_Issues">3.2.2.8. Type Issues</a></li>
+<li><a href="assistance.html#sec:Expression_Issues">3.2.2.9. Expression Issues</a></li>
+<li><a href="assistance.html#sec:Super_Keyword_Issues">3.2.2.10. Super Keyword Issues</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="assistance.html#sec:Quick_Assist">3.3. Quick Assist</a></li>
+<li><a href="assistance.html#sec:Cleanup_Operations">3.4. Cleanup Operations</a>
+<ul class="sectlevel3">
+<li><a href="assistance.html#sec:Formatting">3.4.1. Formatting</a></li>
+<li><a href="assistance.html#sec:Organize_Imports">3.4.2. Organize Imports</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="wizards.html#_wizards">4. Wizards</a>
+<ul class="sectlevel2">
+<li><a href="wizards.html#sec:N4JS_Project_Wizard">4.1. N4JS Project Wizard</a></li>
+<li><a href="wizards.html#sec:Empty_N4JS_File">4.2. Empty N4JS File</a></li>
+<li><a href="wizards.html#sec:Empty_JS_File">4.3. Empty JS File</a>
+<ul class="sectlevel3">
+<li><a href="wizards.html#sec:N4JS_Class_File_Wizard">4.3.1. N4JS Class Wizard</a></li>
+<li><a href="wizards.html#field-properties">4.3.2. Field Properties</a></li>
+<li><a href="wizards.html#visibility-issues-or-final-super-classes">4.3.3. Visibility issues or <code>@Final</code> super classes</a></li>
+<li><a href="wizards.html#generation-1">4.3.4. Generation</a></li>
+<li><a href="wizards.html#preview-1">4.3.5. Preview</a></li>
+</ul>
+</li>
+<li><a href="wizards.html#sec:N4JS_Interface_Wizard">4.4. Interface Wizard</a>
+<ul class="sectlevel3">
+<li><a href="wizards.html#field-properties-1">4.4.1. Field Properties</a></li>
+<li><a href="wizards.html#visibility-issues">4.4.2. Visibility Issues</a></li>
+<li><a href="wizards.html#import-naming-conflicts">4.4.3. Import naming conflicts</a></li>
+<li><a href="wizards.html#generation-2">4.4.4. Generation</a></li>
+<li><a href="wizards.html#preview-2">4.4.5. Preview</a></li>
+</ul>
+</li>
+<li><a href="wizards.html#sec:N4JS_Enum_File_Wizard">4.5. Enum Wizard</a>
+<ul class="sectlevel3">
+<li><a href="wizards.html#field-properties-2">4.5.1. Field Properties</a></li>
+<li><a href="wizards.html#generation-3">4.5.2. Generation</a></li>
+<li><a href="wizards.html#preview-3">4.5.3. Preview</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="execution_support.html#_execution-support">5. Execution Support</a>
+<ul class="sectlevel2">
+<li><a href="execution_support.html#sec:Non_UI_Execution">5.1. Non-UI Execution</a>
+<ul class="sectlevel3">
+<li><a href="execution_support.html#sec:Non_UI_Debugging">5.1.1. Non-UI Debugging</a></li>
+</ul>
+</li>
+<li><a href="execution_support.html#sec:UI_Execution">5.2. UI Execution</a></li>
+</ul>
+</li>
+<li><a href="test_support.html#_test-support">6. Test Support</a>
+<ul class="sectlevel2">
+<li><a href="test_support.html#sec:N4JS_Mangelhaft_support">6.1. N4JS Mangelhaft support</a>
+<ul class="sectlevel3">
+<li><a href="test_support.html#sec:Asynchronous_Tests">6.1.1. Asynchronous Tests, Test Isolation and Timeouts</a></li>
+<li><a href="test_support.html#sec:Supported_xUnit_API">6.1.2. Supported xUnit API</a>
+<ul class="sectlevel4">
+<li><a href="test_support.html#sec:Test_Group">6.1.2.1. Test Group</a></li>
+<li><a href="test_support.html#sec:Test_Method">6.1.2.2. Test Method</a></li>
+<li><a href="test_support.html#sec:BeforeAll">6.1.2.3. BeforeAll Setup</a></li>
+<li><a href="test_support.html#sec:Before_Setup">6.1.2.4. Before Setup</a></li>
+<li><a href="test_support.html#sec:After_Teardown">6.1.2.5. After Teardown</a></li>
+<li><a href="test_support.html#sec:AfterAll_Teardown">6.1.2.6. AfterAll Teardown</a></li>
+<li><a href="test_support.html#sec:Test_Ignore">6.1.2.7. Test Ignore</a></li>
+<li><a href="test_support.html#sec:Timeout">6.1.2.8. Timeout</a></li>
+<li><a href="test_support.html#sec:Description">6.1.2.9. Description</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="test_support.html#sec:Test_Reporting">6.2. Test Reporting</a>
+<ul class="sectlevel3">
+<li><a href="test_support.html#sec:Test_Messages">6.2.1. Test Messages</a>
+<ul class="sectlevel4">
+<li><a href="test_support.html#_test-case-ids">6.2.1.1. Test Case IDs</a></li>
+<li><a href="test_support.html#sec:Start_Session">6.2.1.2. Start Session</a></li>
+<li><a href="test_support.html#sec:Ping_Session">6.2.1.3. Ping Session</a></li>
+<li><a href="test_support.html#sec:End_Session">6.2.1.4. End Session</a></li>
+<li><a href="test_support.html#sec:Start_Test">6.2.1.5. Start Test</a></li>
+<li><a href="test_support.html#sec:End_Test">6.2.1.6. End Test</a></li>
+<li><a href="test_support.html#sec:Ping_Test">6.2.1.7. Ping Test</a></li>
+<li><a href="test_support.html#sec:Test_Catalog">6.2.1.8. Test Catalog</a></li>
+<li><a href="test_support.html#sec:Test_Session_Example">6.2.1.9. Test Session Example</a></li>
+</ul>
+</li>
+<li><a href="test_support.html#sec:Test_Runtime_Configuration">6.2.2. Test Runtime Configuration</a></li>
+<li><a href="test_support.html#sec:Test_Plan">6.2.3. Test Plan</a></li>
+<li><a href="test_support.html#sec:Test_Environment_Configuration">6.2.4. Test Environment Configuration</a></li>
+<li><a href="test_support.html#sec:Test_Environment_Configuration_Example">6.2.5. Test Environment Configuration Example</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="help_system.html#_help-system">7. Help System</a>
+<ul class="sectlevel2">
+<li><a href="help_system.html#sec:Built_In_Help">7.1. Built-In Help</a></li>
+<li><a href="help_system.html#sec:Context_Sensitive_Help">7.2. Context Sensitive Help</a></li>
+<li><a href="help_system.html#sec:Cheat_Sheets">7.3. Cheat Sheets</a></li>
+<li><a href="help_system.html#sec:JSDoc">7.4. JSDoc</a></li>
+<li><a href="help_system.html#sec:Hovering">7.5. Hovering</a>
+<ul class="sectlevel3">
+<li><a href="help_system.html#sec:Show_Type_Information_of_Selection">7.5.1. Show Type Information of Selection</a></li>
+</ul>
+</li>
+<li><a href="help_system.html#sec:Example_Projects_and_Files">7.6. Example Projects and Files</a></li>
+</ul>
+</li>
+<li><a href="bug_management.html#_bug-management">8. Bug Management</a>
+<ul class="sectlevel2">
+<li><a href="bug_management.html#sec:Built_In_Xpect_Support">8.1. Built-In Xpect Support</a>
+<ul class="sectlevel3">
+<li><a href="bug_management.html#sec:Report_View">8.1.1. Report View</a></li>
+<li><a href="bug_management.html#sec:Generate_Bug_Report">8.1.2. Generate Bug Report</a></li>
+<li><a href="bug_management.html#sec:Supported_Xpect_Tests">8.1.3. Supported Xpect Tests</a>
+<ul class="sectlevel4">
+<li><a href="bug_management.html#sec:XPECT_N4JS_Errors">8.1.3.1. Errors, Warnings, Infos, Issues</a></li>
+<li><a href="bug_management.html#sec:XPECT_N4JS_Noerrors">8.1.3.2. Noerrors</a></li>
+<li><a href="bug_management.html#sec:XPECT_N4JS_Output">8.1.3.3. Output, OutputRegex</a></li>
+<li><a href="bug_management.html#sec:XPECT_N4JS_Type_Of">8.1.3.4. Type Of</a></li>
+<li><a href="bug_management.html#sec:XPECT_Advanced_Methods">8.1.3.5. Advanced methods</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="cli.html#_cli">9. CLI</a>
+<ul class="sectlevel2">
+<li><a href="cli.html#sec:Headless_Compiler">9.1. Headless Compiler</a></li>
+<li><a href="cli.html#sec:Headless_Dependencies">9.2. Headless Dependnecies</a></li>
+<li><a href="cli.html#sec:Headless_Execution">9.3. Headless Execution</a>
+<ul class="sectlevel3">
+<li><a href="cli.html#sec:Cleaning_Headlessly">9.3.1. Cleaning Headlessly</a></li>
+<li><a href="cli.html#sec:Running_Headlessly">9.3.2. Running Headlessly</a></li>
+<li><a href="cli.html#sec:Information_about_running_headlessly">9.3.3. Information about running headlessly</a></li>
+<li><a href="cli.html#sec:Testing_Headlessly">9.3.4. Testing Headlessly</a></li>
+<li><a href="cli.html#sec:Information_about_testing_headlessly">9.3.5. Information about testing headlessly</a></li>
+<li><a href="cli.html#_testresults">9.3.6. TestResults</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#sec:License">Appendix A: License</a></li>
+<li><a href="appendix_b_acronyms.html#sec:Acronyms">Appendix B: Acronyms</a></li>
+<li><a href="appendix_c_bibliography.html#_bibliography">Appendix C: Bibliography</a></li>
+</ul>
+</div>
+</div>
+<div id="content"><div class="sect1">
+<h2 id="sec:License"><a class="anchor" href="#sec:License"></a><a class="link" href="#sec:License">Appendix A: License</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>This specification and the accompanying materials is made available
+under the terms of the Eclipse Public License v1.0 which accompanies
+this distribution, and is available at <a href="http://www.eclipse.org/legal/epl-v10.html" class="bare">http://www.eclipse.org/legal/epl-v10.html</a></p>
+</div>
+<h3 id="_eclipse-public-license-v-1-0" class="discrete">Eclipse Public License - v 1.0</h3>
+<div class="paragraph">
+<p>THE ACCOMPANYING PROGRAM IS PROVIDED UNDER THE TERMS OF THIS ECLIPSE
+PUBLIC LICENSE (<code>AGREEMENT</code>). ANY USE, REPRODUCTION OR DISTRIBUTION OF
+THE PROGRAM CONSTITUTES RECIPIENT’S ACCEPTANCE OF THIS AGREEMENT.</p>
+</div>
+<h4 id="_1-definitions" class="discrete">1. DEFINITIONS</h4>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><code>Contribution</code> means: </dt>
+<dd>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>in the case of the initial Contributor, the initial code and
+documentation distributed under this Agreement, and</p>
+</li>
+<li>
+<p>in the case of each subsequent Contributor:</p>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p>changes to the Program, and</p>
+</li>
+<li>
+<p>additions to the Program;</p>
+<div class="paragraph">
+<p>where such changes and/or additions to the Program originate from and
+are distributed by that particular Contributor. A Contribution
+’originates’ from a Contributor if it was added to the Program by such
+Contributor itself or anyone acting on such Contributor’s behalf.
+Contributions do not include additions to the Program which:</p>
+</div>
+<div class="olist lowerroman">
+<ol class="lowerroman" type="i">
+<li>
+<p>are separate modules of software distributed in conjunction with the Program
+under their own license agreement, and</p>
+</li>
+<li>
+<p>are not derivative works of the Program.</p>
+</li>
+</ol>
+</div>
+</li>
+</ol>
+</div>
+</li>
+</ol>
+</div>
+</dd>
+<dt class="hdlist1"><code>Contributor</code></dt>
+<dd>
+<p>means any person or entity that distributes the Program.</p>
+</dd>
+<dt class="hdlist1"><code>Licensed Patents</code> </dt>
+<dd>
+<p>mean patent claims licensable by a Contributor
+which are necessarily infringed by the use or sale of its Contribution
+alone or when combined with the Program.</p>
+</dd>
+<dt class="hdlist1"><code>Program</code> </dt>
+<dd>
+<p>means the Contributions distributed in accordance with this
+Agreement.</p>
+</dd>
+<dt class="hdlist1"><code>Recipient</code> </dt>
+<dd>
+<p>means anyone who receives the Program under this
+Agreement, including all Contributors.</p>
+</dd>
+</dl>
+</div>
+<h4 id="_2-grant-of-rights" class="discrete">2. GRANT OF RIGHTS</h4>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Subject to the terms of this Agreement, each Contributor hereby
+grants Recipient a non-exclusive, worldwide, royalty-free copyright
+license to reproduce, prepare derivative works of, publicly display,
+publicly perform, distribute and sublicense the Contribution of such
+Contributor, if any, and such derivative works, in source code and
+object code form.</p>
+</li>
+<li>
+<p>Subject to the terms of this Agreement, each Contributor hereby
+grants Recipient a non-exclusive, worldwide, royalty-free patent license
+under Licensed Patents to make, use, sell, offer to sell, import and
+otherwise transfer the Contribution of such Contributor, if any, in
+source code and object code form. This patent license shall apply to the
+combination of the Contribution and the Program if, at the time the
+Contribution is added by the Contributor, such addition of the
+Contribution causes such combination to be covered by the Licensed
+Patents. The patent license shall not apply to any other combinations
+which include the Contribution. No hardware per se is licensed
+hereunder.</p>
+</li>
+<li>
+<p>Recipient understands that although each Contributor grants the
+licenses to its Contributions set forth herein, no assurances are
+provided by any Contributor that the Program does not infringe the
+patent or other intellectual property rights of any other entity. Each
+Contributor disclaims any liability to Recipient for claims brought by
+any other entity based on infringement of intellectual property rights
+or otherwise. As a condition to exercising the rights and licenses
+granted hereunder, each Recipient hereby assumes sole responsibility to
+secure any other intellectual property rights needed, if any. For
+example, if a third party patent license is required to allow Recipient
+to distribute the Program, it is Recipient’s responsibility to acquire
+that license before distributing the Program.</p>
+</li>
+<li>
+<p>Each Contributor represents that to its knowledge it has sufficient
+copyright rights in its Contribution, if any, to grant the copyright
+license set forth in this Agreement.</p>
+</li>
+</ol>
+</div>
+<h4 id="_3-requirements" class="discrete">3. REQUIREMENTS</h4>
+<div class="paragraph">
+<p>A Contributor may choose to distribute the Program in object code form
+under its own license agreement, provided that:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>it complies with the terms and conditions of this Agreement; and</p>
+</li>
+<li>
+<p>its license agreement:</p>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p>effectively disclaims on behalf of all Contributors all warranties
+and conditions, express and implied, including warranties or conditions
+of title and non-infringement, and implied warranties or conditions of
+merchantability and fitness for a particular purpose;</p>
+</li>
+<li>
+<p>effectively excludes on behalf of all Contributors all liability for
+damages, including direct, indirect, special, incidental and
+consequential damages, such as lost profits;</p>
+</li>
+<li>
+<p>states that any provisions which differ from this Agreement are
+offered by that Contributor alone and not by any other party; and</p>
+</li>
+<li>
+<p>states that source code for the Program is available from such
+Contributor, and informs licensees how to obtain it in a reasonable
+manner on or through a medium customarily used for software exchange.</p>
+</li>
+</ol>
+</div>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>When the Program is made available in source code form:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>it must be made available under this Agreement; and</p>
+</li>
+<li>
+<p>a copy of this Agreement must be included with each copy of the
+Program.</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>Contributors may not remove or alter any copyright notices contained
+within the Program.</p>
+</div>
+<div class="paragraph">
+<p>Each Contributor must identify itself as the originator of its
+Contribution, if any, in a manner that reasonably allows subsequent
+Recipients to identify the originator of the Contribution.</p>
+</div>
+<h4 id="_4-commercial-distribution" class="discrete">4. COMMERCIAL DISTRIBUTION</h4>
+<div class="paragraph">
+<p>Commercial distributors of software may accept certain responsibilities
+with respect to end users, business partners and the like. While this
+license is intended to facilitate the commercial use of the Program, the
+Contributor who includes the Program in a commercial product offering
+should do so in a manner which does not create potential liability for
+other Contributors. Therefore, if a Contributor includes the Program in
+a commercial product offering, such Contributor (<code>Commercial
+Contributor</code>) hereby agrees to defend and indemnify every other
+Contributor (<code>Indemnified Contributor</code>) against any losses, damages
+and costs (collectively <code>Losses</code>) arising from claims, lawsuits and
+other legal actions brought by a third party against the Indemnified
+Contributor to the extent caused by the acts or omissions of such
+Commercial Contributor in connection with its distribution of the
+Program in a commercial product offering. The obligations in this
+section do not apply to any claims or Losses relating to any actual or
+alleged intellectual property infringement. In order to qualify, an
+Indemnified Contributor must: a) promptly notify the Commercial
+Contributor in writing of such claim, and b) allow the Commercial
+Contributor to control, and cooperate with the Commercial Contributor
+in, the defense and any related settlement negotiations. The Indemnified
+Contributor may participate in any such claim at its own expense.</p>
+</div>
+<div class="paragraph">
+<p>For example, a Contributor might include the Program in a commercial
+product offering, Product X. That Contributor is then a Commercial
+Contributor. If that Commercial Contributor then makes performance
+claims, or offers warranties related to Product X, those performance
+claims and warranties are such Commercial Contributor’s responsibility
+alone. Under this section, the Commercial Contributor would have to
+defend claims against the other Contributors related to those
+performance claims and warranties, and if a court requires any other
+Contributor to pay any damages as a result, the Commercial Contributor
+must pay those damages.</p>
+</div>
+<h4 id="_5-no-warranty" class="discrete">5. NO WARRANTY</h4>
+<div class="paragraph">
+<p>EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, THE PROGRAM IS PROVIDED
+ON AN <code>AS IS</code> BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,
+EITHER EXPRESS OR IMPLIED INCLUDING, WITHOUT LIMITATION, ANY WARRANTIES
+OR CONDITIONS OF TITLE, NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR
+A PARTICULAR PURPOSE. Each Recipient is solely responsible for
+determining the appropriateness of using and distributing the Program
+and assumes all risks associated with its exercise of rights under this
+Agreement , including but not limited to the risks and costs of program
+errors, compliance with applicable laws, damage to or loss of data,
+programs or equipment, and unavailability or interruption of operations.</p>
+</div>
+<h4 id="_6-disclaimer-of-liability" class="discrete">6. DISCLAIMER OF LIABILITY</h4>
+<div class="paragraph">
+<p>EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, NEITHER RECIPIENT NOR
+ANY CONTRIBUTORS SHALL HAVE ANY LIABILITY FOR ANY DIRECT, INDIRECT,
+INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING
+WITHOUT LIMITATION LOST PROFITS), HOWEVER CAUSED AND ON ANY THEORY OF
+LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OR
+DISTRIBUTION OF THE PROGRAM OR THE EXERCISE OF ANY RIGHTS GRANTED
+HEREUNDER, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.</p>
+</div>
+<h4 id="_7-general" class="discrete">7. GENERAL</h4>
+<div class="paragraph">
+<p>If any provision of this Agreement is invalid or unenforceable under
+applicable law, it shall not affect the validity or enforceability of
+the remainder of the terms of this Agreement, and without further action
+by the parties hereto, such provision shall be reformed to the minimum
+extent necessary to make such provision valid and enforceable.</p>
+</div>
+<div class="paragraph">
+<p>If Recipient institutes patent litigation against any entity (including
+a cross-claim or counterclaim in a lawsuit) alleging that the Program
+itself (excluding combinations of the Program with other software or
+hardware) infringes such Recipient’s patent(s), then such Recipient’s
+rights granted under Section 2(b) shall terminate as of the date such
+litigation is filed.</p>
+</div>
+<div class="paragraph">
+<p>All Recipient’s rights under this Agreement shall terminate if it fails
+to comply with any of the material terms or conditions of this Agreement
+and does not cure such failure in a reasonable period of time after
+becoming aware of such noncompliance. If all Recipient’s rights under
+this Agreement terminate, Recipient agrees to cease use and distribution
+of the Program as soon as reasonably practicable. However, Recipient’s
+obligations under this Agreement and any licenses granted by Recipient
+relating to the Program shall continue and survive.</p>
+</div>
+<div class="paragraph">
+<p>Everyone is permitted to copy and distribute copies of this Agreement,
+but in order to avoid inconsistency the Agreement is copyrighted and may
+only be modified in the following manner. The Agreement Steward reserves
+the right to publish new versions (including revisions) of this
+Agreement from time to time. No one other than the Agreement Steward has
+the right to modify this Agreement. The Eclipse Foundation is the
+initial Agreement Steward. The Eclipse Foundation may assign the
+responsibility to serve as the Agreement Steward to a suitable separate
+entity. Each new version of the Agreement will be given a distinguishing
+version number. The Program (including Contributions) may always be
+distributed subject to the version of the Agreement under which it was
+received. In addition, after a new version of the Agreement is
+published, Contributor may elect to distribute the Program (including
+its Contributions) under the new version. Except as expressly stated in
+Sections 2(a) and 2(b) above, Recipient receives no rights or licenses
+to the intellectual property of any Contributor under this Agreement,
+whether expressly, by implication, estoppel or otherwise. All rights in
+the Program not expressly granted under this Agreement are reserved.</p>
+</div>
+<div class="paragraph">
+<p>This Agreement is governed by the laws of the State of New York and the
+intellectual property laws of the United States of America. No party to
+this Agreement will bring a legal action under this Agreement more than
+one year after the cause of action arose. Each party waives its rights
+to a jury trial in any resulting litigation.</p>
+</div>
+</div>
+</div>
+</div>
+<div id="footer">
+<div id="footer-text">
+Version 0.9<br>
+Last updated 2019-08-07 15:02:40 CEST
+</div>
+</div>
+<!-- ************* docinfo-footer *************************************************************** -->
+<div class="Grid social" style="color:#d5dfea">
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <h2>Quick Links</h2>
+    <ul>
+      <li><a href="../downloads.html">Download</a></li>
+      <li><a href="../userguides/index.html">Documentation</a></li>
+      <li><a href="https://github.com/eclipse/n4js/">Source</a></li>
+      <li><a href="https://github.com/eclipse/n4js/issues">Issues</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="https://www.eclipse.org/forums/index.php/f/365/">Forum</a></li>
+      <li><a href="http://n4js.blogspot.de/">Blog</a></li>
+      <li><a href="https://dev.eclipse.org/mailman/listinfo/n4js-dev">Mailing List</a></li>
+      <li><a href="https://projects.eclipse.org/projects/technology.n4js">Eclipse Project Page</a></li>
+      <li><a href="https://twitter.com/n4jsdev">Tweets by n4jsdev</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="http://www.eclipse.org/">Eclipse Home</a></li>
+      <li><a href="http://www.eclipse.org/legal/privacy.php">Privacy Policy</a></li>
+      <li><a href="http://www.eclipse.org/legal/termsofuse.php">Terms of Use</a></li>
+      <li><a href="http://www.eclipse.org/legal/copyright.php">Copyright Agent</a></li>
+      <li><a href="http://www.eclipse.org/legal/">Legal</a></li>
+    </ul>
+  </div>
+  <div style="clear: both; height: 0; overflow: hidden;"></div>
+</div>
+
+<!-- ************* UI Scripts ************* -->
+<script type="text/javascript" src="scripts/back-to-top.js"></script>
+
+<script type="text/javascript" src="scripts/treeview.js"></script>
+<script type="text/javascript" src="scripts/toc.js"></script>
+
+<!-- ************* Prism.js Syntax Highlighting ************* -->
+<script src="scripts/prism.js"></script>
+
+<script type="text/javascript">
+	// Add the 'toclist' id for search function
+	$(".toc2 > ul").attr('id', 'toclist');
+	// Generate a Search input form
+	$("#toclist > li:first-of-type").before('<input type="text" id="pagesearch" onkeyup="search()" placeholder="Search for section...">');
+	$("#toclist > li:first-of-type").before('<i id="clear" class="fa fa-times-circle-o"></i>');
+	$("#clear").click(function(){
+	    $("#pagesearch").val('');
+	    search();
+	    $('.toc2 > ul').treeView('collapseAll');
+	});
+	// intialize Treeview.js
+	$(".toc2 > ul").treeView();
+	// Initialize Scrollspy
+</script>
+<!-- ************* docinfo-footer *************************************************************** -->
+</body>
+</html>
\ No newline at end of file
diff --git a/idespec/appendix_b_acronyms.html b/idespec/appendix_b_acronyms.html
new file mode 100644
index 0000000..70ee999
--- /dev/null
+++ b/idespec/appendix_b_acronyms.html
@@ -0,0 +1,472 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="generator" content="Asciidoctor 1.5.5">
+<meta name="author" content="2019-08-07 15:02:40 CEST">
+<title>N4JS IDE Specification</title>
+<link rel="stylesheet" href="styles/spec.min.css">
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.6.3/css/font-awesome.min.css">
+<!-- ************* docinfo ******************************************************************* -->
+
+
+<!-- ************* Favicon ************-->
+<link rel="icon" href="images/favicon.ico" />
+
+<!-- ************* Back-to-top JQuery ************* -->
+<script src="https://code.jquery.com/jquery-1.12.4.js"></script>
+<script src="https://code.jquery.com/ui/1.12.0/jquery-ui.js"></script>
+
+
+<link href="styles/prism.min.css" rel="stylesheet" />
+<script type="text/javascript" async
+  src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2/MathJax.js?config=TeX-MML-AM_CHTML">
+</script>
+
+<!-- ************* Styles ************* -->
+<link rel="stylesheet" type="text/css" href="styles/n4jsspec-adoc.css">
+
+
+<!-- ****************** NavBar ****************** -->
+<div id="menubar">
+	<div class="banner">
+        <a href="https://www.eclipse.org/n4js/#"><img id="logo" src="images/n4js-logo.png" alt="Eclipse N4JS"></a>
+    </div>
+<ul>
+  <li><a href="index.html">Index</a></li>
+</ul>
+</div>
+<!-- ************* docinfo ******************************************************************* -->
+<style>
+      .admonitionblock td.icon .icon-todo:before{content:"\f249";color:#f4ee42}
+    </style>
+</head>
+<body class="book toc2 toc-left">
+<div id="header">
+<h1>N4JS IDE Specification</h1>
+<div class="details">
+<span id="author" class="author">2019-08-07 15:02:40 CEST</span><br>
+<span id="revnumber">version 0.9</span>
+</div>
+<div id="toc" class="toc2">
+<div id="toctitle">Table of Contents</div>
+<ul class="sectlevel1">
+<li><a href="views.html#sec:Views">1. Views</a>
+<ul class="sectlevel2">
+<li><a href="views.html#_eclipse-standard-views">1.1. Eclipse Standard Views</a>
+<ul class="sectlevel3">
+<li><a href="views.html#sec:Project_Explorer_View">1.1.1. Project Explorer</a></li>
+<li><a href="views.html#sec:Outline_View">1.1.2. Outline</a></li>
+<li><a href="views.html#sec:Problems_View">1.1.3. Problems</a></li>
+<li><a href="views.html#sec:Console_View">1.1.4. Console</a></li>
+<li><a href="views.html#sec:History_View">1.1.5. History</a></li>
+<li><a href="views.html#sec:Error_Log_View">1.1.6. Error Log</a></li>
+</ul>
+</li>
+<li><a href="views.html#_n4js-specific-views">1.2. N4JS Specific Views</a>
+<ul class="sectlevel3">
+<li><a href="views.html#_test-results">1.2.1. Test Results</a></li>
+<li><a href="views.html#_source-graphs">1.2.2. Source Graphs</a></li>
+<li><a href="views.html#_api-compare">1.2.3. API Compare</a></li>
+<li><a href="views.html#_performance-graphs">1.2.4. Performance Graphs</a></li>
+<li><a href="views.html#_source-mapping">1.2.5. Source Mapping</a></li>
+<li><a href="views.html#_xpect-view">1.2.6. Xpect View</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="navigation.html#_navigation">2. Navigation</a>
+<ul class="sectlevel2">
+<li><a href="navigation.html#sec:Outline_Navigation">2.1. Outline</a>
+<ul class="sectlevel3">
+<li><a href="navigation.html#_quick-outline">2.1.1. Quick Outline</a></li>
+<li><a href="navigation.html#_normal-outline">2.1.2. Normal Outline</a></li>
+</ul>
+</li>
+<li><a href="navigation.html#_navigation-commands">2.2. Navigation Commands</a>
+<ul class="sectlevel3">
+<li><a href="navigation.html#sec:Navigate_to_Declaration">2.2.1. Navigate to Declaration</a></li>
+<li><a href="navigation.html#sec:find_by_references">2.2.2. Find by References</a></li>
+<li><a href="navigation.html#sec:Open_Type_Declaration">2.2.3. Open Type Declaration</a></li>
+</ul>
+</li>
+<li><a href="navigation.html#sec:Working_Sets">2.3. Working Sets</a>
+<ul class="sectlevel3">
+<li><a href="navigation.html#sec:Working_Set_Managers">2.3.1. Working Set Managers</a></li>
+<li><a href="navigation.html#sec:Working_Set_Constraints">2.3.2. Working Set Constraints</a></li>
+<li><a href="navigation.html#sec:Manual_Association_Working_Set_Manager_UI_Features">2.3.3. Manual Association Working Set Manager - UI Features</a></li>
+<li><a href="navigation.html#sec:Project_Name_Filter_Working_Set_Manager">2.3.4. Project Name Filter Working Set Manager</a></li>
+<li><a href="navigation.html#sec:Git_Repository_Working_Set_Manager">2.3.5. Git Repository Working Set Manager</a></li>
+<li><a href="navigation.html#sec:Project_Location_Working_Set_Manager">2.3.6. Project Location Working Set Manager</a></li>
+<li><a href="navigation.html#sec:N4JS_Project_Type_Working_Set_Manager">2.3.7. N4JS Project Type Working Set Manager</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="assistance.html#_assistance">3. Assistance</a>
+<ul class="sectlevel2">
+<li><a href="assistance.html#sec:Content_Assist">3.1. Content Assist</a>
+<ul class="sectlevel3">
+<li><a href="assistance.html#sec:Complete_Keywords">3.1.1. Complete Keywords</a></li>
+<li><a href="assistance.html#sec:Complete_Annotations">3.1.2. Complete Annotations</a></li>
+<li><a href="assistance.html#sec:Complete_Identifier_Reference">3.1.3. Complete Identifier Reference</a></li>
+<li><a href="assistance.html#sec:Complete_Member_Overrides">3.1.4. Complete Member Overrides</a></li>
+<li><a href="assistance.html#sec:Constructor_Completion">3.1.5. Constructor Completion</a></li>
+<li><a href="assistance.html#sec:Complete_Function_Expression">3.1.6. Complete Function Expression with Known Type</a></li>
+<li><a href="assistance.html#sec:Complete_Variable_and_Parameter_Names">3.1.7. Complete Variable and Parameter Names</a></li>
+</ul>
+</li>
+<li><a href="assistance.html#sec:Quick_Fixes">3.2. Quick Fixes</a>
+<ul class="sectlevel3">
+<li><a href="assistance.html#sec:N4JS_Issue_Properties">3.2.1. N4JS Issue User data</a></li>
+<li><a href="assistance.html#sec:N4JS_Issue_Fixes">3.2.2. N4JS Issue Fixes</a>
+<ul class="sectlevel4">
+<li><a href="assistance.html#sec:Linking_Issues">3.2.2.1. Linking Issues</a></li>
+<li><a href="assistance.html#sec:Import_Issues">3.2.2.2. Import Issues</a></li>
+<li><a href="assistance.html#sec:Visibility_Issues">3.2.2.3. Visibility Issues</a></li>
+<li><a href="assistance.html#sec:Classifier_Issues">3.2.2.4. Classifier Issues</a></li>
+<li><a href="assistance.html#sec:Function_Issues">3.2.2.5. Function Issues</a></li>
+<li><a href="assistance.html#sec:Syntax_Issues">3.2.2.6. Syntax Issues</a></li>
+<li><a href="assistance.html#sec:Conversion_Issues">3.2.2.7. Conversion Issues</a></li>
+<li><a href="assistance.html#sec:Type_Issues">3.2.2.8. Type Issues</a></li>
+<li><a href="assistance.html#sec:Expression_Issues">3.2.2.9. Expression Issues</a></li>
+<li><a href="assistance.html#sec:Super_Keyword_Issues">3.2.2.10. Super Keyword Issues</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="assistance.html#sec:Quick_Assist">3.3. Quick Assist</a></li>
+<li><a href="assistance.html#sec:Cleanup_Operations">3.4. Cleanup Operations</a>
+<ul class="sectlevel3">
+<li><a href="assistance.html#sec:Formatting">3.4.1. Formatting</a></li>
+<li><a href="assistance.html#sec:Organize_Imports">3.4.2. Organize Imports</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="wizards.html#_wizards">4. Wizards</a>
+<ul class="sectlevel2">
+<li><a href="wizards.html#sec:N4JS_Project_Wizard">4.1. N4JS Project Wizard</a></li>
+<li><a href="wizards.html#sec:Empty_N4JS_File">4.2. Empty N4JS File</a></li>
+<li><a href="wizards.html#sec:Empty_JS_File">4.3. Empty JS File</a>
+<ul class="sectlevel3">
+<li><a href="wizards.html#sec:N4JS_Class_File_Wizard">4.3.1. N4JS Class Wizard</a></li>
+<li><a href="wizards.html#field-properties">4.3.2. Field Properties</a></li>
+<li><a href="wizards.html#visibility-issues-or-final-super-classes">4.3.3. Visibility issues or <code>@Final</code> super classes</a></li>
+<li><a href="wizards.html#generation-1">4.3.4. Generation</a></li>
+<li><a href="wizards.html#preview-1">4.3.5. Preview</a></li>
+</ul>
+</li>
+<li><a href="wizards.html#sec:N4JS_Interface_Wizard">4.4. Interface Wizard</a>
+<ul class="sectlevel3">
+<li><a href="wizards.html#field-properties-1">4.4.1. Field Properties</a></li>
+<li><a href="wizards.html#visibility-issues">4.4.2. Visibility Issues</a></li>
+<li><a href="wizards.html#import-naming-conflicts">4.4.3. Import naming conflicts</a></li>
+<li><a href="wizards.html#generation-2">4.4.4. Generation</a></li>
+<li><a href="wizards.html#preview-2">4.4.5. Preview</a></li>
+</ul>
+</li>
+<li><a href="wizards.html#sec:N4JS_Enum_File_Wizard">4.5. Enum Wizard</a>
+<ul class="sectlevel3">
+<li><a href="wizards.html#field-properties-2">4.5.1. Field Properties</a></li>
+<li><a href="wizards.html#generation-3">4.5.2. Generation</a></li>
+<li><a href="wizards.html#preview-3">4.5.3. Preview</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="execution_support.html#_execution-support">5. Execution Support</a>
+<ul class="sectlevel2">
+<li><a href="execution_support.html#sec:Non_UI_Execution">5.1. Non-UI Execution</a>
+<ul class="sectlevel3">
+<li><a href="execution_support.html#sec:Non_UI_Debugging">5.1.1. Non-UI Debugging</a></li>
+</ul>
+</li>
+<li><a href="execution_support.html#sec:UI_Execution">5.2. UI Execution</a></li>
+</ul>
+</li>
+<li><a href="test_support.html#_test-support">6. Test Support</a>
+<ul class="sectlevel2">
+<li><a href="test_support.html#sec:N4JS_Mangelhaft_support">6.1. N4JS Mangelhaft support</a>
+<ul class="sectlevel3">
+<li><a href="test_support.html#sec:Asynchronous_Tests">6.1.1. Asynchronous Tests, Test Isolation and Timeouts</a></li>
+<li><a href="test_support.html#sec:Supported_xUnit_API">6.1.2. Supported xUnit API</a>
+<ul class="sectlevel4">
+<li><a href="test_support.html#sec:Test_Group">6.1.2.1. Test Group</a></li>
+<li><a href="test_support.html#sec:Test_Method">6.1.2.2. Test Method</a></li>
+<li><a href="test_support.html#sec:BeforeAll">6.1.2.3. BeforeAll Setup</a></li>
+<li><a href="test_support.html#sec:Before_Setup">6.1.2.4. Before Setup</a></li>
+<li><a href="test_support.html#sec:After_Teardown">6.1.2.5. After Teardown</a></li>
+<li><a href="test_support.html#sec:AfterAll_Teardown">6.1.2.6. AfterAll Teardown</a></li>
+<li><a href="test_support.html#sec:Test_Ignore">6.1.2.7. Test Ignore</a></li>
+<li><a href="test_support.html#sec:Timeout">6.1.2.8. Timeout</a></li>
+<li><a href="test_support.html#sec:Description">6.1.2.9. Description</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="test_support.html#sec:Test_Reporting">6.2. Test Reporting</a>
+<ul class="sectlevel3">
+<li><a href="test_support.html#sec:Test_Messages">6.2.1. Test Messages</a>
+<ul class="sectlevel4">
+<li><a href="test_support.html#_test-case-ids">6.2.1.1. Test Case IDs</a></li>
+<li><a href="test_support.html#sec:Start_Session">6.2.1.2. Start Session</a></li>
+<li><a href="test_support.html#sec:Ping_Session">6.2.1.3. Ping Session</a></li>
+<li><a href="test_support.html#sec:End_Session">6.2.1.4. End Session</a></li>
+<li><a href="test_support.html#sec:Start_Test">6.2.1.5. Start Test</a></li>
+<li><a href="test_support.html#sec:End_Test">6.2.1.6. End Test</a></li>
+<li><a href="test_support.html#sec:Ping_Test">6.2.1.7. Ping Test</a></li>
+<li><a href="test_support.html#sec:Test_Catalog">6.2.1.8. Test Catalog</a></li>
+<li><a href="test_support.html#sec:Test_Session_Example">6.2.1.9. Test Session Example</a></li>
+</ul>
+</li>
+<li><a href="test_support.html#sec:Test_Runtime_Configuration">6.2.2. Test Runtime Configuration</a></li>
+<li><a href="test_support.html#sec:Test_Plan">6.2.3. Test Plan</a></li>
+<li><a href="test_support.html#sec:Test_Environment_Configuration">6.2.4. Test Environment Configuration</a></li>
+<li><a href="test_support.html#sec:Test_Environment_Configuration_Example">6.2.5. Test Environment Configuration Example</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="help_system.html#_help-system">7. Help System</a>
+<ul class="sectlevel2">
+<li><a href="help_system.html#sec:Built_In_Help">7.1. Built-In Help</a></li>
+<li><a href="help_system.html#sec:Context_Sensitive_Help">7.2. Context Sensitive Help</a></li>
+<li><a href="help_system.html#sec:Cheat_Sheets">7.3. Cheat Sheets</a></li>
+<li><a href="help_system.html#sec:JSDoc">7.4. JSDoc</a></li>
+<li><a href="help_system.html#sec:Hovering">7.5. Hovering</a>
+<ul class="sectlevel3">
+<li><a href="help_system.html#sec:Show_Type_Information_of_Selection">7.5.1. Show Type Information of Selection</a></li>
+</ul>
+</li>
+<li><a href="help_system.html#sec:Example_Projects_and_Files">7.6. Example Projects and Files</a></li>
+</ul>
+</li>
+<li><a href="bug_management.html#_bug-management">8. Bug Management</a>
+<ul class="sectlevel2">
+<li><a href="bug_management.html#sec:Built_In_Xpect_Support">8.1. Built-In Xpect Support</a>
+<ul class="sectlevel3">
+<li><a href="bug_management.html#sec:Report_View">8.1.1. Report View</a></li>
+<li><a href="bug_management.html#sec:Generate_Bug_Report">8.1.2. Generate Bug Report</a></li>
+<li><a href="bug_management.html#sec:Supported_Xpect_Tests">8.1.3. Supported Xpect Tests</a>
+<ul class="sectlevel4">
+<li><a href="bug_management.html#sec:XPECT_N4JS_Errors">8.1.3.1. Errors, Warnings, Infos, Issues</a></li>
+<li><a href="bug_management.html#sec:XPECT_N4JS_Noerrors">8.1.3.2. Noerrors</a></li>
+<li><a href="bug_management.html#sec:XPECT_N4JS_Output">8.1.3.3. Output, OutputRegex</a></li>
+<li><a href="bug_management.html#sec:XPECT_N4JS_Type_Of">8.1.3.4. Type Of</a></li>
+<li><a href="bug_management.html#sec:XPECT_Advanced_Methods">8.1.3.5. Advanced methods</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="cli.html#_cli">9. CLI</a>
+<ul class="sectlevel2">
+<li><a href="cli.html#sec:Headless_Compiler">9.1. Headless Compiler</a></li>
+<li><a href="cli.html#sec:Headless_Dependencies">9.2. Headless Dependnecies</a></li>
+<li><a href="cli.html#sec:Headless_Execution">9.3. Headless Execution</a>
+<ul class="sectlevel3">
+<li><a href="cli.html#sec:Cleaning_Headlessly">9.3.1. Cleaning Headlessly</a></li>
+<li><a href="cli.html#sec:Running_Headlessly">9.3.2. Running Headlessly</a></li>
+<li><a href="cli.html#sec:Information_about_running_headlessly">9.3.3. Information about running headlessly</a></li>
+<li><a href="cli.html#sec:Testing_Headlessly">9.3.4. Testing Headlessly</a></li>
+<li><a href="cli.html#sec:Information_about_testing_headlessly">9.3.5. Information about testing headlessly</a></li>
+<li><a href="cli.html#_testresults">9.3.6. TestResults</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_license.html#sec:License">Appendix A: License</a></li>
+<li><a href="#sec:Acronyms">Appendix B: Acronyms</a></li>
+<li><a href="appendix_c_bibliography.html#_bibliography">Appendix C: Bibliography</a></li>
+</ul>
+</div>
+</div>
+<div id="content"><div class="sect1">
+<h2 id="sec:Acronyms"><a class="anchor" href="#sec:Acronyms"></a><a class="link" href="#sec:Acronyms">Appendix B: Acronyms</a></h2>
+<div class="sectionbody">
+<table id="AC" class="tableblock frame-all grid-all spread language-bash">
+<colgroup>
+<col style="width: 8.3333%;">
+<col style="width: 41.6666%;">
+<col style="width: 8.3333%;">
+<col style="width: 41.6668%;">
+</colgroup>
+<tbody>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>CDep</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Compile-Time Dependency</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>RDep</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Run-Time Dependency</p></th>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>LDep</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Load-Time Dependency</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>IDep</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Initialization-Time Dependency</p></th>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>EDep</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Execution-Time Dependency</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>ANTLR</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">ANother Tool for Language Recognition</p></th>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>API</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Application Programming Interface</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>AST</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Abstract Syntax Tree</p></th>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>ASI</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Automatic Semicolon Insertion</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>BNF</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Backus-Naur Form</p></th>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>CLI</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Command Line Interface (including a headless compiler and runner.)</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>DI</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Dependency Injection</p></th>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>DIC</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">DI Component</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>DOM</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Document Object Model</p></th>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>DSL</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Domain Specific Language</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>EBNF</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Extended Backus-Naur Form</p></th>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>EMF</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Eclipse Modeling Framework <a id="EMF"></a></p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>FQN</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Fully Qualified Name</p></th>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>GLB</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Greatest Lower Bound, also known as <em>infimum</em></p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>GCST</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Greatest Common Sub Type, also known as <em>meet</em></p></th>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>IDE</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Integrated Development Environment</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>IDL</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Interface Definition Language</p></th>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>LSP</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Liskov Substitution Principle [<a href="appendix_c_bibliography.html#Martin96b">Martin96b</a>]</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>LUB</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Least Upper Bound, also known as <em>supremum</em></p></th>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>LCST</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Least Common Super Type, also known as <em>join</em></p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>N4JS</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">N4JS for JavaScript</p></th>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>N4JSED</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">N4JS Environment Definition</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>N4JSIDE</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">N4JS Integrated Development Environment (Eclipse-based IDE for all N4JS related languages and projects)</p></th>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>VM</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Virtual Machine</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>XML</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Extensible Markup Language</p></th>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>XSLT / XSL</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">XSL Transformations</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>XSL</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Extensible Stylesheet Language</p></th>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>WYSIWYG</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">What You See Is What You Get</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>WLOG</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Without loss of generality</p></th>
+</tr>
+</tbody>
+</table>
+</div>
+</div>
+</div>
+<div id="footer">
+<div id="footer-text">
+Version 0.9<br>
+Last updated 2019-08-07 15:02:40 CEST
+</div>
+</div>
+<!-- ************* docinfo-footer *************************************************************** -->
+<div class="Grid social" style="color:#d5dfea">
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <h2>Quick Links</h2>
+    <ul>
+      <li><a href="../downloads.html">Download</a></li>
+      <li><a href="../userguides/index.html">Documentation</a></li>
+      <li><a href="https://github.com/eclipse/n4js/">Source</a></li>
+      <li><a href="https://github.com/eclipse/n4js/issues">Issues</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="https://www.eclipse.org/forums/index.php/f/365/">Forum</a></li>
+      <li><a href="http://n4js.blogspot.de/">Blog</a></li>
+      <li><a href="https://dev.eclipse.org/mailman/listinfo/n4js-dev">Mailing List</a></li>
+      <li><a href="https://projects.eclipse.org/projects/technology.n4js">Eclipse Project Page</a></li>
+      <li><a href="https://twitter.com/n4jsdev">Tweets by n4jsdev</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="http://www.eclipse.org/">Eclipse Home</a></li>
+      <li><a href="http://www.eclipse.org/legal/privacy.php">Privacy Policy</a></li>
+      <li><a href="http://www.eclipse.org/legal/termsofuse.php">Terms of Use</a></li>
+      <li><a href="http://www.eclipse.org/legal/copyright.php">Copyright Agent</a></li>
+      <li><a href="http://www.eclipse.org/legal/">Legal</a></li>
+    </ul>
+  </div>
+  <div style="clear: both; height: 0; overflow: hidden;"></div>
+</div>
+
+<!-- ************* UI Scripts ************* -->
+<script type="text/javascript" src="scripts/back-to-top.js"></script>
+
+<script type="text/javascript" src="scripts/treeview.js"></script>
+<script type="text/javascript" src="scripts/toc.js"></script>
+
+<!-- ************* Prism.js Syntax Highlighting ************* -->
+<script src="scripts/prism.js"></script>
+
+<script type="text/javascript">
+	// Add the 'toclist' id for search function
+	$(".toc2 > ul").attr('id', 'toclist');
+	// Generate a Search input form
+	$("#toclist > li:first-of-type").before('<input type="text" id="pagesearch" onkeyup="search()" placeholder="Search for section...">');
+	$("#toclist > li:first-of-type").before('<i id="clear" class="fa fa-times-circle-o"></i>');
+	$("#clear").click(function(){
+	    $("#pagesearch").val('');
+	    search();
+	    $('.toc2 > ul').treeView('collapseAll');
+	});
+	// intialize Treeview.js
+	$(".toc2 > ul").treeView();
+	// Initialize Scrollspy
+</script>
+<!-- ************* docinfo-footer *************************************************************** -->
+</body>
+</html>
\ No newline at end of file
diff --git a/idespec/appendix_c_bibliography.html b/idespec/appendix_c_bibliography.html
new file mode 100644
index 0000000..5547f3a
--- /dev/null
+++ b/idespec/appendix_c_bibliography.html
@@ -0,0 +1,370 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="generator" content="Asciidoctor 1.5.5">
+<meta name="author" content="2019-08-07 15:02:40 CEST">
+<title>N4JS IDE Specification</title>
+<link rel="stylesheet" href="styles/spec.min.css">
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.6.3/css/font-awesome.min.css">
+<!-- ************* docinfo ******************************************************************* -->
+
+
+<!-- ************* Favicon ************-->
+<link rel="icon" href="images/favicon.ico" />
+
+<!-- ************* Back-to-top JQuery ************* -->
+<script src="https://code.jquery.com/jquery-1.12.4.js"></script>
+<script src="https://code.jquery.com/ui/1.12.0/jquery-ui.js"></script>
+
+
+<link href="styles/prism.min.css" rel="stylesheet" />
+<script type="text/javascript" async
+  src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2/MathJax.js?config=TeX-MML-AM_CHTML">
+</script>
+
+<!-- ************* Styles ************* -->
+<link rel="stylesheet" type="text/css" href="styles/n4jsspec-adoc.css">
+
+
+<!-- ****************** NavBar ****************** -->
+<div id="menubar">
+	<div class="banner">
+        <a href="https://www.eclipse.org/n4js/#"><img id="logo" src="images/n4js-logo.png" alt="Eclipse N4JS"></a>
+    </div>
+<ul>
+  <li><a href="index.html">Index</a></li>
+</ul>
+</div>
+<!-- ************* docinfo ******************************************************************* -->
+<style>
+      .admonitionblock td.icon .icon-todo:before{content:"\f249";color:#f4ee42}
+    </style>
+</head>
+<body class="book toc2 toc-left">
+<div id="header">
+<h1>N4JS IDE Specification</h1>
+<div class="details">
+<span id="author" class="author">2019-08-07 15:02:40 CEST</span><br>
+<span id="revnumber">version 0.9</span>
+</div>
+<div id="toc" class="toc2">
+<div id="toctitle">Table of Contents</div>
+<ul class="sectlevel1">
+<li><a href="views.html#sec:Views">1. Views</a>
+<ul class="sectlevel2">
+<li><a href="views.html#_eclipse-standard-views">1.1. Eclipse Standard Views</a>
+<ul class="sectlevel3">
+<li><a href="views.html#sec:Project_Explorer_View">1.1.1. Project Explorer</a></li>
+<li><a href="views.html#sec:Outline_View">1.1.2. Outline</a></li>
+<li><a href="views.html#sec:Problems_View">1.1.3. Problems</a></li>
+<li><a href="views.html#sec:Console_View">1.1.4. Console</a></li>
+<li><a href="views.html#sec:History_View">1.1.5. History</a></li>
+<li><a href="views.html#sec:Error_Log_View">1.1.6. Error Log</a></li>
+</ul>
+</li>
+<li><a href="views.html#_n4js-specific-views">1.2. N4JS Specific Views</a>
+<ul class="sectlevel3">
+<li><a href="views.html#_test-results">1.2.1. Test Results</a></li>
+<li><a href="views.html#_source-graphs">1.2.2. Source Graphs</a></li>
+<li><a href="views.html#_api-compare">1.2.3. API Compare</a></li>
+<li><a href="views.html#_performance-graphs">1.2.4. Performance Graphs</a></li>
+<li><a href="views.html#_source-mapping">1.2.5. Source Mapping</a></li>
+<li><a href="views.html#_xpect-view">1.2.6. Xpect View</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="navigation.html#_navigation">2. Navigation</a>
+<ul class="sectlevel2">
+<li><a href="navigation.html#sec:Outline_Navigation">2.1. Outline</a>
+<ul class="sectlevel3">
+<li><a href="navigation.html#_quick-outline">2.1.1. Quick Outline</a></li>
+<li><a href="navigation.html#_normal-outline">2.1.2. Normal Outline</a></li>
+</ul>
+</li>
+<li><a href="navigation.html#_navigation-commands">2.2. Navigation Commands</a>
+<ul class="sectlevel3">
+<li><a href="navigation.html#sec:Navigate_to_Declaration">2.2.1. Navigate to Declaration</a></li>
+<li><a href="navigation.html#sec:find_by_references">2.2.2. Find by References</a></li>
+<li><a href="navigation.html#sec:Open_Type_Declaration">2.2.3. Open Type Declaration</a></li>
+</ul>
+</li>
+<li><a href="navigation.html#sec:Working_Sets">2.3. Working Sets</a>
+<ul class="sectlevel3">
+<li><a href="navigation.html#sec:Working_Set_Managers">2.3.1. Working Set Managers</a></li>
+<li><a href="navigation.html#sec:Working_Set_Constraints">2.3.2. Working Set Constraints</a></li>
+<li><a href="navigation.html#sec:Manual_Association_Working_Set_Manager_UI_Features">2.3.3. Manual Association Working Set Manager - UI Features</a></li>
+<li><a href="navigation.html#sec:Project_Name_Filter_Working_Set_Manager">2.3.4. Project Name Filter Working Set Manager</a></li>
+<li><a href="navigation.html#sec:Git_Repository_Working_Set_Manager">2.3.5. Git Repository Working Set Manager</a></li>
+<li><a href="navigation.html#sec:Project_Location_Working_Set_Manager">2.3.6. Project Location Working Set Manager</a></li>
+<li><a href="navigation.html#sec:N4JS_Project_Type_Working_Set_Manager">2.3.7. N4JS Project Type Working Set Manager</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="assistance.html#_assistance">3. Assistance</a>
+<ul class="sectlevel2">
+<li><a href="assistance.html#sec:Content_Assist">3.1. Content Assist</a>
+<ul class="sectlevel3">
+<li><a href="assistance.html#sec:Complete_Keywords">3.1.1. Complete Keywords</a></li>
+<li><a href="assistance.html#sec:Complete_Annotations">3.1.2. Complete Annotations</a></li>
+<li><a href="assistance.html#sec:Complete_Identifier_Reference">3.1.3. Complete Identifier Reference</a></li>
+<li><a href="assistance.html#sec:Complete_Member_Overrides">3.1.4. Complete Member Overrides</a></li>
+<li><a href="assistance.html#sec:Constructor_Completion">3.1.5. Constructor Completion</a></li>
+<li><a href="assistance.html#sec:Complete_Function_Expression">3.1.6. Complete Function Expression with Known Type</a></li>
+<li><a href="assistance.html#sec:Complete_Variable_and_Parameter_Names">3.1.7. Complete Variable and Parameter Names</a></li>
+</ul>
+</li>
+<li><a href="assistance.html#sec:Quick_Fixes">3.2. Quick Fixes</a>
+<ul class="sectlevel3">
+<li><a href="assistance.html#sec:N4JS_Issue_Properties">3.2.1. N4JS Issue User data</a></li>
+<li><a href="assistance.html#sec:N4JS_Issue_Fixes">3.2.2. N4JS Issue Fixes</a>
+<ul class="sectlevel4">
+<li><a href="assistance.html#sec:Linking_Issues">3.2.2.1. Linking Issues</a></li>
+<li><a href="assistance.html#sec:Import_Issues">3.2.2.2. Import Issues</a></li>
+<li><a href="assistance.html#sec:Visibility_Issues">3.2.2.3. Visibility Issues</a></li>
+<li><a href="assistance.html#sec:Classifier_Issues">3.2.2.4. Classifier Issues</a></li>
+<li><a href="assistance.html#sec:Function_Issues">3.2.2.5. Function Issues</a></li>
+<li><a href="assistance.html#sec:Syntax_Issues">3.2.2.6. Syntax Issues</a></li>
+<li><a href="assistance.html#sec:Conversion_Issues">3.2.2.7. Conversion Issues</a></li>
+<li><a href="assistance.html#sec:Type_Issues">3.2.2.8. Type Issues</a></li>
+<li><a href="assistance.html#sec:Expression_Issues">3.2.2.9. Expression Issues</a></li>
+<li><a href="assistance.html#sec:Super_Keyword_Issues">3.2.2.10. Super Keyword Issues</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="assistance.html#sec:Quick_Assist">3.3. Quick Assist</a></li>
+<li><a href="assistance.html#sec:Cleanup_Operations">3.4. Cleanup Operations</a>
+<ul class="sectlevel3">
+<li><a href="assistance.html#sec:Formatting">3.4.1. Formatting</a></li>
+<li><a href="assistance.html#sec:Organize_Imports">3.4.2. Organize Imports</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="wizards.html#_wizards">4. Wizards</a>
+<ul class="sectlevel2">
+<li><a href="wizards.html#sec:N4JS_Project_Wizard">4.1. N4JS Project Wizard</a></li>
+<li><a href="wizards.html#sec:Empty_N4JS_File">4.2. Empty N4JS File</a></li>
+<li><a href="wizards.html#sec:Empty_JS_File">4.3. Empty JS File</a>
+<ul class="sectlevel3">
+<li><a href="wizards.html#sec:N4JS_Class_File_Wizard">4.3.1. N4JS Class Wizard</a></li>
+<li><a href="wizards.html#field-properties">4.3.2. Field Properties</a></li>
+<li><a href="wizards.html#visibility-issues-or-final-super-classes">4.3.3. Visibility issues or <code>@Final</code> super classes</a></li>
+<li><a href="wizards.html#generation-1">4.3.4. Generation</a></li>
+<li><a href="wizards.html#preview-1">4.3.5. Preview</a></li>
+</ul>
+</li>
+<li><a href="wizards.html#sec:N4JS_Interface_Wizard">4.4. Interface Wizard</a>
+<ul class="sectlevel3">
+<li><a href="wizards.html#field-properties-1">4.4.1. Field Properties</a></li>
+<li><a href="wizards.html#visibility-issues">4.4.2. Visibility Issues</a></li>
+<li><a href="wizards.html#import-naming-conflicts">4.4.3. Import naming conflicts</a></li>
+<li><a href="wizards.html#generation-2">4.4.4. Generation</a></li>
+<li><a href="wizards.html#preview-2">4.4.5. Preview</a></li>
+</ul>
+</li>
+<li><a href="wizards.html#sec:N4JS_Enum_File_Wizard">4.5. Enum Wizard</a>
+<ul class="sectlevel3">
+<li><a href="wizards.html#field-properties-2">4.5.1. Field Properties</a></li>
+<li><a href="wizards.html#generation-3">4.5.2. Generation</a></li>
+<li><a href="wizards.html#preview-3">4.5.3. Preview</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="execution_support.html#_execution-support">5. Execution Support</a>
+<ul class="sectlevel2">
+<li><a href="execution_support.html#sec:Non_UI_Execution">5.1. Non-UI Execution</a>
+<ul class="sectlevel3">
+<li><a href="execution_support.html#sec:Non_UI_Debugging">5.1.1. Non-UI Debugging</a></li>
+</ul>
+</li>
+<li><a href="execution_support.html#sec:UI_Execution">5.2. UI Execution</a></li>
+</ul>
+</li>
+<li><a href="test_support.html#_test-support">6. Test Support</a>
+<ul class="sectlevel2">
+<li><a href="test_support.html#sec:N4JS_Mangelhaft_support">6.1. N4JS Mangelhaft support</a>
+<ul class="sectlevel3">
+<li><a href="test_support.html#sec:Asynchronous_Tests">6.1.1. Asynchronous Tests, Test Isolation and Timeouts</a></li>
+<li><a href="test_support.html#sec:Supported_xUnit_API">6.1.2. Supported xUnit API</a>
+<ul class="sectlevel4">
+<li><a href="test_support.html#sec:Test_Group">6.1.2.1. Test Group</a></li>
+<li><a href="test_support.html#sec:Test_Method">6.1.2.2. Test Method</a></li>
+<li><a href="test_support.html#sec:BeforeAll">6.1.2.3. BeforeAll Setup</a></li>
+<li><a href="test_support.html#sec:Before_Setup">6.1.2.4. Before Setup</a></li>
+<li><a href="test_support.html#sec:After_Teardown">6.1.2.5. After Teardown</a></li>
+<li><a href="test_support.html#sec:AfterAll_Teardown">6.1.2.6. AfterAll Teardown</a></li>
+<li><a href="test_support.html#sec:Test_Ignore">6.1.2.7. Test Ignore</a></li>
+<li><a href="test_support.html#sec:Timeout">6.1.2.8. Timeout</a></li>
+<li><a href="test_support.html#sec:Description">6.1.2.9. Description</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="test_support.html#sec:Test_Reporting">6.2. Test Reporting</a>
+<ul class="sectlevel3">
+<li><a href="test_support.html#sec:Test_Messages">6.2.1. Test Messages</a>
+<ul class="sectlevel4">
+<li><a href="test_support.html#_test-case-ids">6.2.1.1. Test Case IDs</a></li>
+<li><a href="test_support.html#sec:Start_Session">6.2.1.2. Start Session</a></li>
+<li><a href="test_support.html#sec:Ping_Session">6.2.1.3. Ping Session</a></li>
+<li><a href="test_support.html#sec:End_Session">6.2.1.4. End Session</a></li>
+<li><a href="test_support.html#sec:Start_Test">6.2.1.5. Start Test</a></li>
+<li><a href="test_support.html#sec:End_Test">6.2.1.6. End Test</a></li>
+<li><a href="test_support.html#sec:Ping_Test">6.2.1.7. Ping Test</a></li>
+<li><a href="test_support.html#sec:Test_Catalog">6.2.1.8. Test Catalog</a></li>
+<li><a href="test_support.html#sec:Test_Session_Example">6.2.1.9. Test Session Example</a></li>
+</ul>
+</li>
+<li><a href="test_support.html#sec:Test_Runtime_Configuration">6.2.2. Test Runtime Configuration</a></li>
+<li><a href="test_support.html#sec:Test_Plan">6.2.3. Test Plan</a></li>
+<li><a href="test_support.html#sec:Test_Environment_Configuration">6.2.4. Test Environment Configuration</a></li>
+<li><a href="test_support.html#sec:Test_Environment_Configuration_Example">6.2.5. Test Environment Configuration Example</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="help_system.html#_help-system">7. Help System</a>
+<ul class="sectlevel2">
+<li><a href="help_system.html#sec:Built_In_Help">7.1. Built-In Help</a></li>
+<li><a href="help_system.html#sec:Context_Sensitive_Help">7.2. Context Sensitive Help</a></li>
+<li><a href="help_system.html#sec:Cheat_Sheets">7.3. Cheat Sheets</a></li>
+<li><a href="help_system.html#sec:JSDoc">7.4. JSDoc</a></li>
+<li><a href="help_system.html#sec:Hovering">7.5. Hovering</a>
+<ul class="sectlevel3">
+<li><a href="help_system.html#sec:Show_Type_Information_of_Selection">7.5.1. Show Type Information of Selection</a></li>
+</ul>
+</li>
+<li><a href="help_system.html#sec:Example_Projects_and_Files">7.6. Example Projects and Files</a></li>
+</ul>
+</li>
+<li><a href="bug_management.html#_bug-management">8. Bug Management</a>
+<ul class="sectlevel2">
+<li><a href="bug_management.html#sec:Built_In_Xpect_Support">8.1. Built-In Xpect Support</a>
+<ul class="sectlevel3">
+<li><a href="bug_management.html#sec:Report_View">8.1.1. Report View</a></li>
+<li><a href="bug_management.html#sec:Generate_Bug_Report">8.1.2. Generate Bug Report</a></li>
+<li><a href="bug_management.html#sec:Supported_Xpect_Tests">8.1.3. Supported Xpect Tests</a>
+<ul class="sectlevel4">
+<li><a href="bug_management.html#sec:XPECT_N4JS_Errors">8.1.3.1. Errors, Warnings, Infos, Issues</a></li>
+<li><a href="bug_management.html#sec:XPECT_N4JS_Noerrors">8.1.3.2. Noerrors</a></li>
+<li><a href="bug_management.html#sec:XPECT_N4JS_Output">8.1.3.3. Output, OutputRegex</a></li>
+<li><a href="bug_management.html#sec:XPECT_N4JS_Type_Of">8.1.3.4. Type Of</a></li>
+<li><a href="bug_management.html#sec:XPECT_Advanced_Methods">8.1.3.5. Advanced methods</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="cli.html#_cli">9. CLI</a>
+<ul class="sectlevel2">
+<li><a href="cli.html#sec:Headless_Compiler">9.1. Headless Compiler</a></li>
+<li><a href="cli.html#sec:Headless_Dependencies">9.2. Headless Dependnecies</a></li>
+<li><a href="cli.html#sec:Headless_Execution">9.3. Headless Execution</a>
+<ul class="sectlevel3">
+<li><a href="cli.html#sec:Cleaning_Headlessly">9.3.1. Cleaning Headlessly</a></li>
+<li><a href="cli.html#sec:Running_Headlessly">9.3.2. Running Headlessly</a></li>
+<li><a href="cli.html#sec:Information_about_running_headlessly">9.3.3. Information about running headlessly</a></li>
+<li><a href="cli.html#sec:Testing_Headlessly">9.3.4. Testing Headlessly</a></li>
+<li><a href="cli.html#sec:Information_about_testing_headlessly">9.3.5. Information about testing headlessly</a></li>
+<li><a href="cli.html#_testresults">9.3.6. TestResults</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_license.html#sec:License">Appendix A: License</a></li>
+<li><a href="appendix_b_acronyms.html#sec:Acronyms">Appendix B: Acronyms</a></li>
+<li><a href="#_bibliography">Appendix C: Bibliography</a></li>
+</ul>
+</div>
+</div>
+<div id="content"><div class="sect1">
+<h2 id="_bibliography"><a class="anchor" href="#_bibliography"></a><a class="link" href="#_bibliography">Appendix C: Bibliography</a></h2>
+<div class="sectionbody">
+<div class="openblock bibliography">
+<div class="content">
+<div class="paragraph">
+<p><a id="N4JSSpec"></a><em>N4JS Language Specification</em>. </p>
+</div>
+<div class="paragraph">
+<p><a id="Martin96b"></a>Martin, Robert C. (1996). <em>The Liskov Substitution Principle</em>. Retrieved from <a href="http://www.objectmentor.com/publications/lsp.pdf" class="bare">http://www.objectmentor.com/publications/lsp.pdf</a></p>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div id="footer">
+<div id="footer-text">
+Version 0.9<br>
+Last updated 2019-08-07 15:02:40 CEST
+</div>
+</div>
+<!-- ************* docinfo-footer *************************************************************** -->
+<div class="Grid social" style="color:#d5dfea">
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <h2>Quick Links</h2>
+    <ul>
+      <li><a href="../downloads.html">Download</a></li>
+      <li><a href="../userguides/index.html">Documentation</a></li>
+      <li><a href="https://github.com/eclipse/n4js/">Source</a></li>
+      <li><a href="https://github.com/eclipse/n4js/issues">Issues</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="https://www.eclipse.org/forums/index.php/f/365/">Forum</a></li>
+      <li><a href="http://n4js.blogspot.de/">Blog</a></li>
+      <li><a href="https://dev.eclipse.org/mailman/listinfo/n4js-dev">Mailing List</a></li>
+      <li><a href="https://projects.eclipse.org/projects/technology.n4js">Eclipse Project Page</a></li>
+      <li><a href="https://twitter.com/n4jsdev">Tweets by n4jsdev</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="http://www.eclipse.org/">Eclipse Home</a></li>
+      <li><a href="http://www.eclipse.org/legal/privacy.php">Privacy Policy</a></li>
+      <li><a href="http://www.eclipse.org/legal/termsofuse.php">Terms of Use</a></li>
+      <li><a href="http://www.eclipse.org/legal/copyright.php">Copyright Agent</a></li>
+      <li><a href="http://www.eclipse.org/legal/">Legal</a></li>
+    </ul>
+  </div>
+  <div style="clear: both; height: 0; overflow: hidden;"></div>
+</div>
+
+<!-- ************* UI Scripts ************* -->
+<script type="text/javascript" src="scripts/back-to-top.js"></script>
+
+<script type="text/javascript" src="scripts/treeview.js"></script>
+<script type="text/javascript" src="scripts/toc.js"></script>
+
+<!-- ************* Prism.js Syntax Highlighting ************* -->
+<script src="scripts/prism.js"></script>
+
+<script type="text/javascript">
+	// Add the 'toclist' id for search function
+	$(".toc2 > ul").attr('id', 'toclist');
+	// Generate a Search input form
+	$("#toclist > li:first-of-type").before('<input type="text" id="pagesearch" onkeyup="search()" placeholder="Search for section...">');
+	$("#toclist > li:first-of-type").before('<i id="clear" class="fa fa-times-circle-o"></i>');
+	$("#clear").click(function(){
+	    $("#pagesearch").val('');
+	    search();
+	    $('.toc2 > ul').treeView('collapseAll');
+	});
+	// intialize Treeview.js
+	$(".toc2 > ul").treeView();
+	// Initialize Scrollspy
+</script>
+<!-- ************* docinfo-footer *************************************************************** -->
+</body>
+</html>
\ No newline at end of file
diff --git a/idespec/assistance.html b/idespec/assistance.html
new file mode 100644
index 0000000..d6bec19
--- /dev/null
+++ b/idespec/assistance.html
@@ -0,0 +1,1602 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="generator" content="Asciidoctor 1.5.5">
+<meta name="author" content="2019-08-07 15:02:40 CEST">
+<title>N4JS IDE Specification</title>
+<link rel="stylesheet" href="styles/spec.min.css">
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.6.3/css/font-awesome.min.css">
+<!-- ************* docinfo ******************************************************************* -->
+
+
+<!-- ************* Favicon ************-->
+<link rel="icon" href="images/favicon.ico" />
+
+<!-- ************* Back-to-top JQuery ************* -->
+<script src="https://code.jquery.com/jquery-1.12.4.js"></script>
+<script src="https://code.jquery.com/ui/1.12.0/jquery-ui.js"></script>
+
+
+<link href="styles/prism.min.css" rel="stylesheet" />
+<script type="text/javascript" async
+  src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2/MathJax.js?config=TeX-MML-AM_CHTML">
+</script>
+
+<!-- ************* Styles ************* -->
+<link rel="stylesheet" type="text/css" href="styles/n4jsspec-adoc.css">
+
+
+<!-- ****************** NavBar ****************** -->
+<div id="menubar">
+	<div class="banner">
+        <a href="https://www.eclipse.org/n4js/#"><img id="logo" src="images/n4js-logo.png" alt="Eclipse N4JS"></a>
+    </div>
+<ul>
+  <li><a href="index.html">Index</a></li>
+</ul>
+</div>
+<!-- ************* docinfo ******************************************************************* -->
+<style>
+      .admonitionblock td.icon .icon-todo:before{content:"\f249";color:#f4ee42}
+    </style>
+</head>
+<body class="book toc2 toc-left">
+<div id="header">
+<h1>N4JS IDE Specification</h1>
+<div class="details">
+<span id="author" class="author">2019-08-07 15:02:40 CEST</span><br>
+<span id="revnumber">version 0.9</span>
+</div>
+<div id="toc" class="toc2">
+<div id="toctitle">Table of Contents</div>
+<ul class="sectlevel1">
+<li><a href="views.html#sec:Views">1. Views</a>
+<ul class="sectlevel2">
+<li><a href="views.html#_eclipse-standard-views">1.1. Eclipse Standard Views</a>
+<ul class="sectlevel3">
+<li><a href="views.html#sec:Project_Explorer_View">1.1.1. Project Explorer</a></li>
+<li><a href="views.html#sec:Outline_View">1.1.2. Outline</a></li>
+<li><a href="views.html#sec:Problems_View">1.1.3. Problems</a></li>
+<li><a href="views.html#sec:Console_View">1.1.4. Console</a></li>
+<li><a href="views.html#sec:History_View">1.1.5. History</a></li>
+<li><a href="views.html#sec:Error_Log_View">1.1.6. Error Log</a></li>
+</ul>
+</li>
+<li><a href="views.html#_n4js-specific-views">1.2. N4JS Specific Views</a>
+<ul class="sectlevel3">
+<li><a href="views.html#_test-results">1.2.1. Test Results</a></li>
+<li><a href="views.html#_source-graphs">1.2.2. Source Graphs</a></li>
+<li><a href="views.html#_api-compare">1.2.3. API Compare</a></li>
+<li><a href="views.html#_performance-graphs">1.2.4. Performance Graphs</a></li>
+<li><a href="views.html#_source-mapping">1.2.5. Source Mapping</a></li>
+<li><a href="views.html#_xpect-view">1.2.6. Xpect View</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="navigation.html#_navigation">2. Navigation</a>
+<ul class="sectlevel2">
+<li><a href="navigation.html#sec:Outline_Navigation">2.1. Outline</a>
+<ul class="sectlevel3">
+<li><a href="navigation.html#_quick-outline">2.1.1. Quick Outline</a></li>
+<li><a href="navigation.html#_normal-outline">2.1.2. Normal Outline</a></li>
+</ul>
+</li>
+<li><a href="navigation.html#_navigation-commands">2.2. Navigation Commands</a>
+<ul class="sectlevel3">
+<li><a href="navigation.html#sec:Navigate_to_Declaration">2.2.1. Navigate to Declaration</a></li>
+<li><a href="navigation.html#sec:find_by_references">2.2.2. Find by References</a></li>
+<li><a href="navigation.html#sec:Open_Type_Declaration">2.2.3. Open Type Declaration</a></li>
+</ul>
+</li>
+<li><a href="navigation.html#sec:Working_Sets">2.3. Working Sets</a>
+<ul class="sectlevel3">
+<li><a href="navigation.html#sec:Working_Set_Managers">2.3.1. Working Set Managers</a></li>
+<li><a href="navigation.html#sec:Working_Set_Constraints">2.3.2. Working Set Constraints</a></li>
+<li><a href="navigation.html#sec:Manual_Association_Working_Set_Manager_UI_Features">2.3.3. Manual Association Working Set Manager - UI Features</a></li>
+<li><a href="navigation.html#sec:Project_Name_Filter_Working_Set_Manager">2.3.4. Project Name Filter Working Set Manager</a></li>
+<li><a href="navigation.html#sec:Git_Repository_Working_Set_Manager">2.3.5. Git Repository Working Set Manager</a></li>
+<li><a href="navigation.html#sec:Project_Location_Working_Set_Manager">2.3.6. Project Location Working Set Manager</a></li>
+<li><a href="navigation.html#sec:N4JS_Project_Type_Working_Set_Manager">2.3.7. N4JS Project Type Working Set Manager</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#_assistance">3. Assistance</a>
+<ul class="sectlevel2">
+<li><a href="#sec:Content_Assist">3.1. Content Assist</a>
+<ul class="sectlevel3">
+<li><a href="#sec:Complete_Keywords">3.1.1. Complete Keywords</a></li>
+<li><a href="#sec:Complete_Annotations">3.1.2. Complete Annotations</a></li>
+<li><a href="#sec:Complete_Identifier_Reference">3.1.3. Complete Identifier Reference</a></li>
+<li><a href="#sec:Complete_Member_Overrides">3.1.4. Complete Member Overrides</a></li>
+<li><a href="#sec:Constructor_Completion">3.1.5. Constructor Completion</a></li>
+<li><a href="#sec:Complete_Function_Expression">3.1.6. Complete Function Expression with Known Type</a></li>
+<li><a href="#sec:Complete_Variable_and_Parameter_Names">3.1.7. Complete Variable and Parameter Names</a></li>
+</ul>
+</li>
+<li><a href="#sec:Quick_Fixes">3.2. Quick Fixes</a>
+<ul class="sectlevel3">
+<li><a href="#sec:N4JS_Issue_Properties">3.2.1. N4JS Issue User data</a></li>
+<li><a href="#sec:N4JS_Issue_Fixes">3.2.2. N4JS Issue Fixes</a>
+<ul class="sectlevel4">
+<li><a href="#sec:Linking_Issues">3.2.2.1. Linking Issues</a></li>
+<li><a href="#sec:Import_Issues">3.2.2.2. Import Issues</a></li>
+<li><a href="#sec:Visibility_Issues">3.2.2.3. Visibility Issues</a></li>
+<li><a href="#sec:Classifier_Issues">3.2.2.4. Classifier Issues</a></li>
+<li><a href="#sec:Function_Issues">3.2.2.5. Function Issues</a></li>
+<li><a href="#sec:Syntax_Issues">3.2.2.6. Syntax Issues</a></li>
+<li><a href="#sec:Conversion_Issues">3.2.2.7. Conversion Issues</a></li>
+<li><a href="#sec:Type_Issues">3.2.2.8. Type Issues</a></li>
+<li><a href="#sec:Expression_Issues">3.2.2.9. Expression Issues</a></li>
+<li><a href="#sec:Super_Keyword_Issues">3.2.2.10. Super Keyword Issues</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#sec:Quick_Assist">3.3. Quick Assist</a></li>
+<li><a href="#sec:Cleanup_Operations">3.4. Cleanup Operations</a>
+<ul class="sectlevel3">
+<li><a href="#sec:Formatting">3.4.1. Formatting</a></li>
+<li><a href="#sec:Organize_Imports">3.4.2. Organize Imports</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="wizards.html#_wizards">4. Wizards</a>
+<ul class="sectlevel2">
+<li><a href="wizards.html#sec:N4JS_Project_Wizard">4.1. N4JS Project Wizard</a></li>
+<li><a href="wizards.html#sec:Empty_N4JS_File">4.2. Empty N4JS File</a></li>
+<li><a href="wizards.html#sec:Empty_JS_File">4.3. Empty JS File</a>
+<ul class="sectlevel3">
+<li><a href="wizards.html#sec:N4JS_Class_File_Wizard">4.3.1. N4JS Class Wizard</a></li>
+<li><a href="wizards.html#field-properties">4.3.2. Field Properties</a></li>
+<li><a href="wizards.html#visibility-issues-or-final-super-classes">4.3.3. Visibility issues or <code>@Final</code> super classes</a></li>
+<li><a href="wizards.html#generation-1">4.3.4. Generation</a></li>
+<li><a href="wizards.html#preview-1">4.3.5. Preview</a></li>
+</ul>
+</li>
+<li><a href="wizards.html#sec:N4JS_Interface_Wizard">4.4. Interface Wizard</a>
+<ul class="sectlevel3">
+<li><a href="wizards.html#field-properties-1">4.4.1. Field Properties</a></li>
+<li><a href="wizards.html#visibility-issues">4.4.2. Visibility Issues</a></li>
+<li><a href="wizards.html#import-naming-conflicts">4.4.3. Import naming conflicts</a></li>
+<li><a href="wizards.html#generation-2">4.4.4. Generation</a></li>
+<li><a href="wizards.html#preview-2">4.4.5. Preview</a></li>
+</ul>
+</li>
+<li><a href="wizards.html#sec:N4JS_Enum_File_Wizard">4.5. Enum Wizard</a>
+<ul class="sectlevel3">
+<li><a href="wizards.html#field-properties-2">4.5.1. Field Properties</a></li>
+<li><a href="wizards.html#generation-3">4.5.2. Generation</a></li>
+<li><a href="wizards.html#preview-3">4.5.3. Preview</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="execution_support.html#_execution-support">5. Execution Support</a>
+<ul class="sectlevel2">
+<li><a href="execution_support.html#sec:Non_UI_Execution">5.1. Non-UI Execution</a>
+<ul class="sectlevel3">
+<li><a href="execution_support.html#sec:Non_UI_Debugging">5.1.1. Non-UI Debugging</a></li>
+</ul>
+</li>
+<li><a href="execution_support.html#sec:UI_Execution">5.2. UI Execution</a></li>
+</ul>
+</li>
+<li><a href="test_support.html#_test-support">6. Test Support</a>
+<ul class="sectlevel2">
+<li><a href="test_support.html#sec:N4JS_Mangelhaft_support">6.1. N4JS Mangelhaft support</a>
+<ul class="sectlevel3">
+<li><a href="test_support.html#sec:Asynchronous_Tests">6.1.1. Asynchronous Tests, Test Isolation and Timeouts</a></li>
+<li><a href="test_support.html#sec:Supported_xUnit_API">6.1.2. Supported xUnit API</a>
+<ul class="sectlevel4">
+<li><a href="test_support.html#sec:Test_Group">6.1.2.1. Test Group</a></li>
+<li><a href="test_support.html#sec:Test_Method">6.1.2.2. Test Method</a></li>
+<li><a href="test_support.html#sec:BeforeAll">6.1.2.3. BeforeAll Setup</a></li>
+<li><a href="test_support.html#sec:Before_Setup">6.1.2.4. Before Setup</a></li>
+<li><a href="test_support.html#sec:After_Teardown">6.1.2.5. After Teardown</a></li>
+<li><a href="test_support.html#sec:AfterAll_Teardown">6.1.2.6. AfterAll Teardown</a></li>
+<li><a href="test_support.html#sec:Test_Ignore">6.1.2.7. Test Ignore</a></li>
+<li><a href="test_support.html#sec:Timeout">6.1.2.8. Timeout</a></li>
+<li><a href="test_support.html#sec:Description">6.1.2.9. Description</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="test_support.html#sec:Test_Reporting">6.2. Test Reporting</a>
+<ul class="sectlevel3">
+<li><a href="test_support.html#sec:Test_Messages">6.2.1. Test Messages</a>
+<ul class="sectlevel4">
+<li><a href="test_support.html#_test-case-ids">6.2.1.1. Test Case IDs</a></li>
+<li><a href="test_support.html#sec:Start_Session">6.2.1.2. Start Session</a></li>
+<li><a href="test_support.html#sec:Ping_Session">6.2.1.3. Ping Session</a></li>
+<li><a href="test_support.html#sec:End_Session">6.2.1.4. End Session</a></li>
+<li><a href="test_support.html#sec:Start_Test">6.2.1.5. Start Test</a></li>
+<li><a href="test_support.html#sec:End_Test">6.2.1.6. End Test</a></li>
+<li><a href="test_support.html#sec:Ping_Test">6.2.1.7. Ping Test</a></li>
+<li><a href="test_support.html#sec:Test_Catalog">6.2.1.8. Test Catalog</a></li>
+<li><a href="test_support.html#sec:Test_Session_Example">6.2.1.9. Test Session Example</a></li>
+</ul>
+</li>
+<li><a href="test_support.html#sec:Test_Runtime_Configuration">6.2.2. Test Runtime Configuration</a></li>
+<li><a href="test_support.html#sec:Test_Plan">6.2.3. Test Plan</a></li>
+<li><a href="test_support.html#sec:Test_Environment_Configuration">6.2.4. Test Environment Configuration</a></li>
+<li><a href="test_support.html#sec:Test_Environment_Configuration_Example">6.2.5. Test Environment Configuration Example</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="help_system.html#_help-system">7. Help System</a>
+<ul class="sectlevel2">
+<li><a href="help_system.html#sec:Built_In_Help">7.1. Built-In Help</a></li>
+<li><a href="help_system.html#sec:Context_Sensitive_Help">7.2. Context Sensitive Help</a></li>
+<li><a href="help_system.html#sec:Cheat_Sheets">7.3. Cheat Sheets</a></li>
+<li><a href="help_system.html#sec:JSDoc">7.4. JSDoc</a></li>
+<li><a href="help_system.html#sec:Hovering">7.5. Hovering</a>
+<ul class="sectlevel3">
+<li><a href="help_system.html#sec:Show_Type_Information_of_Selection">7.5.1. Show Type Information of Selection</a></li>
+</ul>
+</li>
+<li><a href="help_system.html#sec:Example_Projects_and_Files">7.6. Example Projects and Files</a></li>
+</ul>
+</li>
+<li><a href="bug_management.html#_bug-management">8. Bug Management</a>
+<ul class="sectlevel2">
+<li><a href="bug_management.html#sec:Built_In_Xpect_Support">8.1. Built-In Xpect Support</a>
+<ul class="sectlevel3">
+<li><a href="bug_management.html#sec:Report_View">8.1.1. Report View</a></li>
+<li><a href="bug_management.html#sec:Generate_Bug_Report">8.1.2. Generate Bug Report</a></li>
+<li><a href="bug_management.html#sec:Supported_Xpect_Tests">8.1.3. Supported Xpect Tests</a>
+<ul class="sectlevel4">
+<li><a href="bug_management.html#sec:XPECT_N4JS_Errors">8.1.3.1. Errors, Warnings, Infos, Issues</a></li>
+<li><a href="bug_management.html#sec:XPECT_N4JS_Noerrors">8.1.3.2. Noerrors</a></li>
+<li><a href="bug_management.html#sec:XPECT_N4JS_Output">8.1.3.3. Output, OutputRegex</a></li>
+<li><a href="bug_management.html#sec:XPECT_N4JS_Type_Of">8.1.3.4. Type Of</a></li>
+<li><a href="bug_management.html#sec:XPECT_Advanced_Methods">8.1.3.5. Advanced methods</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="cli.html#_cli">9. CLI</a>
+<ul class="sectlevel2">
+<li><a href="cli.html#sec:Headless_Compiler">9.1. Headless Compiler</a></li>
+<li><a href="cli.html#sec:Headless_Dependencies">9.2. Headless Dependnecies</a></li>
+<li><a href="cli.html#sec:Headless_Execution">9.3. Headless Execution</a>
+<ul class="sectlevel3">
+<li><a href="cli.html#sec:Cleaning_Headlessly">9.3.1. Cleaning Headlessly</a></li>
+<li><a href="cli.html#sec:Running_Headlessly">9.3.2. Running Headlessly</a></li>
+<li><a href="cli.html#sec:Information_about_running_headlessly">9.3.3. Information about running headlessly</a></li>
+<li><a href="cli.html#sec:Testing_Headlessly">9.3.4. Testing Headlessly</a></li>
+<li><a href="cli.html#sec:Information_about_testing_headlessly">9.3.5. Information about testing headlessly</a></li>
+<li><a href="cli.html#_testresults">9.3.6. TestResults</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_license.html#sec:License">Appendix A: License</a></li>
+<li><a href="appendix_b_acronyms.html#sec:Acronyms">Appendix B: Acronyms</a></li>
+<li><a href="appendix_c_bibliography.html#_bibliography">Appendix C: Bibliography</a></li>
+</ul>
+</div>
+</div>
+<div id="content"><div class="sect1">
+<h2 id="_assistance"><a class="anchor" href="#_assistance"></a><a class="link" href="#_assistance">3. Assistance</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>In this chapter we describe all kind of tools assisting the user when writing code, i.e. content assist, quickfixes, quick assists, etc.</p>
+</div>
+<div class="admonitionblock warning">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-warning" title=""></i>
+</td>
+<td class="content">
+Not all features are yet implemented!
+</td>
+</tr>
+</table>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:Content_Assist"><a class="anchor" href="#sec:Content_Assist"></a><a class="link" href="#sec:Content_Assist">3.1. Content Assist</a></h3>
+<div class="paragraph">
+<p>Content assist may change the document at various places at once. In those cases, it is important to prevent flickering in the editor. The FQNImporter provides a blue print how to adjust line numbers properly and scroll the viewport of the current editor to minimize flickering in the UI.</p>
+</div>
+<div class="paragraph">
+<p>Completions not listed here as they are provided by template proposals:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Classifier declaration template proposal</p>
+</li>
+<li>
+<p>Function declaration template proposal</p>
+</li>
+<li>
+<p>Getter/Setter pair template proposal</p>
+</li>
+</ol>
+</div>
+<div class="sect3">
+<h4 id="sec:Complete_Keywords"><a class="anchor" href="#sec:Complete_Keywords"></a><a class="link" href="#sec:Complete_Keywords">3.1.1. Complete Keywords</a></h4>
+<div class="paragraph">
+<p>Complete keyword which are syntactically correct at a given location. Do not suggest completions which would lead to wrong code.</p>
+</div>
+<div class="paragraph">
+<p>Keywords that contain only a single character are not proposed since they would pollute the proposal window and don’t offer added value.</p>
+</div>
+<div class="paragraph">
+<p>Special attention has to be given to operators. Since they are modelled in the grammar and not as cross references, their validaty is purely syntactically. That is, there is no generic facility in Xtext, that allows to filter unapplicable operators as there is for cross references.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Complete_Annotations"><a class="anchor" href="#sec:Complete_Annotations"></a><a class="link" href="#sec:Complete_Annotations">3.1.2. Complete Annotations</a></h4>
+<div class="paragraph">
+<p>Annotations can be proposed depending on the following elements or the context.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Complete_Identifier_Reference"><a class="anchor" href="#sec:Complete_Identifier_Reference"></a><a class="link" href="#sec:Complete_Identifier_Reference">3.1.3. Complete Identifier Reference</a></h4>
+<div class="paragraph">
+<p>References to identifiers can be automatically completed. This is even true if the declaration is not imported yet, as the import may be automatically added as well.</p>
+</div>
+<div class="openblock">
+<div class="title">Complete identifier references</div>
+<div class="content">
+<div class="paragraph">
+<p>The IDE supports auto-completion of an identifier referencing to a declaration.</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Complete type references.</p>
+</li>
+<li>
+<p>Complete function references.</p>
+</li>
+<li>
+<p>Complete variable references.</p>
+</li>
+<li>
+<p>Complete parameter references.</p>
+</li>
+<li>
+<p>If necessary, imports are added automatically to complete reference <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>r</mi></math> to declaration <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>D</mi></math>.</p>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Precondition</dt>
+<dd>
+<p>-</p>
+</dd>
+<dt class="hdlist1">Postcondition</dt>
+<dd>
+<div class="paragraph">
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mi>b</mi><mi>i</mi><mi>n</mi><mi>d</mi><mfenced close=")" open="("><mi>r</mi><mi>D</mi></mfenced></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mo>⇔</mo></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mi>r</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><mi>D</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mi>D</mi><mo>∈</mo><mi>r</mi><mo>.</mo><mi>m</mi><mi>o</mi><mi>d</mi><mi>u</mi><mi>l</mi><mi>e</mi></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mo>⊕</mo></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mo>∃</mo><mstyle mathvariant="monospace"><mtext>NamedImportSpecifier</mtext></mstyle><mi>N</mi><mi>I</mi><mi>S</mi><mi>:</mi></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mi>W</mi><mi>I</mi><mi>S</mi><mo>.</mo><mi>i</mi><mi>m</mi><mi>p</mi><mi>o</mi><mi>r</mi><mi>t</mi><mi>D</mi><mi>e</mi><mi>c</mi><mi>l</mi><mo>.</mo><mi>i</mi><mi>m</mi><mi>p</mi><mi>o</mi><mi>r</mi><mi>t</mi><mi>e</mi><mi>d</mi><mi>M</mi><mi>o</mi><mi>d</mi><mi>u</mi><mi>l</mi><mi>e</mi><mo>=</mo><mi>D</mi><mo>.</mo><mi>m</mi><mi>o</mi><mi>d</mi><mi>u</mi><mi>l</mi><mi>e</mi></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mo>∨</mo><mo>∃</mo><mstyle mathvariant="monospace"><mtext>WildcardImportSpecifier</mtext></mstyle><mi>W</mi><mi>I</mi><mi>S</mi><mi>:</mi></math></p>
+</div>
+</dd>
+<dt class="hdlist1">Description</dt>
+<dd>
+<p>There might be multiple declarations <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>D</mi></math> in project (or in dependent projects) with <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>D</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><mi>r</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi></math>. If the declaration <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>D</mi></math> is not local, then a named import may be created by the content assist:</p>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p>If the declaration <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>D</mi></math> is local, no import is created</p>
+</li>
+<li>
+<p>If an import enabling access to the declaration already exists, no other import is created.</p>
+</li>
+<li>
+<p>If an alias already exists, the alias name is used, even if the prefix was different when the content assist was activated.</p>
+</li>
+<li>
+<p>If the import would conflict with an existing member, an alias is proposed along with the import. Linked editing helps to choose a proper alias.</p>
+</li>
+<li>
+<p>All imports from a single module are done within a single import declaration. The exception to this rule are wildcard imports that provide a simple name which is currently unused. In that case, a new import may be necessary to disambiguate the wildcard.</p>
+</li>
+</ol>
+</div>
+</dd>
+</dl>
+</div>
+</li>
+<li>
+<p>If the identifier reference refers to a function (or method), an opening and a closing parenthesis are appended and
+the cursor is positioned between these two parentheses.</p>
+</li>
+</ol>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Complete_Member_Overrides"><a class="anchor" href="#sec:Complete_Member_Overrides"></a><a class="link" href="#sec:Complete_Member_Overrides">3.1.4. Complete Member Overrides</a></h4>
+<div class="openblock">
+<div class="title">Complete Member Overrides Inside a classifier</div>
+<div class="content">
+<div class="paragraph">
+<p>A prefix of an inherited member can be used to autocomplete that to a complete declaration.
+This is in particular true for methods.</p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Constructor_Completion"><a class="anchor" href="#sec:Constructor_Completion"></a><a class="link" href="#sec:Constructor_Completion">3.1.5. Constructor Completion</a></h4>
+<div class="openblock">
+<div class="title">Constructor Completion</div>
+<div class="content">
+<div class="paragraph">
+<p>Constructor Completion Based on the declared fields and super constructor, constructor methods can be completed.</p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Complete_Function_Expression"><a class="anchor" href="#sec:Complete_Function_Expression"></a><a class="link" href="#sec:Complete_Function_Expression">3.1.6. Complete Function Expression with Known Type</a></h4>
+<div class="openblock">
+<div class="title">Complete Function Expression</div>
+<div class="content">
+<div class="paragraph">
+<p>If a function expression is used as an argument or assigned to a typed variable, the signature of the function can be derived from the type. This can be used to complete a function expression.</p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Complete_Variable_and_Parameter_Names"><a class="anchor" href="#sec:Complete_Variable_and_Parameter_Names"></a><a class="link" href="#sec:Complete_Variable_and_Parameter_Names">3.1.7. Complete Variable and Parameter Names</a></h4>
+<div class="openblock">
+<div class="title">Type based completion of Variable and Parameter Names</div>
+<div class="content">
+<div class="paragraph">
+<p>Variable and parameter names can be completed based on the type. Camel case detection is used to propose different variations.</p>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Completion of variables references see <a href="#sec:Complete_Identifier_Reference">Complete Identifier Reference</a>.</p>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:Quick_Fixes"><a class="anchor" href="#sec:Quick_Fixes"></a><a class="link" href="#sec:Quick_Fixes">3.2. Quick Fixes</a></h3>
+<div class="paragraph">
+<p>Quick fixes try to solve issues, i.e. errors or warnings, automatically. This is done by rewriting code, either at the location of the issue or at referenced locations.</p>
+</div>
+<div class="paragraph">
+<p>In all cases, a quick fix must only be suggested if the following preconditions are fulfilled:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>All locations at which modifications have to be done must be writeable.</p>
+</li>
+<li>
+<p>If bindings are involved, e.g., names are to be changed, all previous bindings must remain similar. This might be more complicated as it seems!</p>
+</li>
+</ol>
+</div>
+<div class="sect3">
+<h4 id="sec:N4JS_Issue_Properties"><a class="anchor" href="#sec:N4JS_Issue_Properties"></a><a class="link" href="#sec:N4JS_Issue_Properties">3.2.1. N4JS Issue User data</a></h4>
+<div class="paragraph">
+<p>As some quick fixes need more information to decide upfront which strategy to use, some issues provide additional data. These properties are defined in the file <code>IssueUserDataKeys.java</code> in the <code>org.eclipse.n4js.validation</code> package. They can for example be accessed by passing the according key to the <code>getUserData</code> method of an <code>N4JSIssue</code> instance. They are also available as array based Xtext Issue user data.<br></p>
+</div>
+<div class="paragraph">
+<p>All available user data keys are described for each Issue code in <a href="#sec:N4JS_Issue_Fixes">N4JS Issue Fixes</a>.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:N4JS_Issue_Fixes"><a class="anchor" href="#sec:N4JS_Issue_Fixes"></a><a class="link" href="#sec:N4JS_Issue_Fixes">3.2.2. N4JS Issue Fixes</a></h4>
+<div class="paragraph">
+<p>The principle idea is to provide a quick fix for every issue, if it is possible to automatically solve it.</p>
+</div>
+<div class="sect4">
+<h5 id="sec:Linking_Issues"><a class="anchor" href="#sec:Linking_Issues"></a><a class="link" href="#sec:Linking_Issues">3.2.2.1. Linking Issues</a></h5>
+<div class="paragraph">
+<p>Linking issues are special in that they are created by the standard Xtext linker and use all the same built-in issue code <code>Diagnostic.LINKING_DIAGNOSTIC</code>. Therefore, we cannot refer to these issues using one of our custom N4JS issue codes.</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Diagnostic.LINKING_DIAGNOSTIC</dt>
+<dd>
+<p><code>Couldn’t resolve reference to <em>n</em></code></p>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Add missing import declaration for unresolved name <em>n</em>.</p>
+</li>
+</ol>
+</div>
+</dd>
+</dl>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Precondition
+</td>
+<td class="hdlist2">
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p>An exported identifiable element <em>e</em> with name <em>n</em> exists in another module <em>m</em>.</p>
+</li>
+<li>
+<p><em>e</em> is visible from the given location.</p>
+</li>
+</ol>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Label
+</td>
+<td class="hdlist2">
+<p><code>Import <em>n</em> - <em>m</em></code></p>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Postcondition</dt>
+<dd>
+<p>An import declaration was added such that name <em>n</em> is now resolvable at the given location and bound to <em>e</em>.</p>
+</dd>
+<dt class="hdlist1">Description</dt>
+<dd>
+<p>Some important notes:</p>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p><code>A</code> separate quick fix is proposed for each candidate element instead of having a single generic quick fix for adding imports and showing a dialog later (for example, create two quick fixes “Import class <code>X</code> from module M1" and “Import interface <code>X</code> from module M2" instead of a single quick fix “Add import for name X").<br>
+This is unusual for quick fixes, because it means significant work has to be done upfront when creating the quick fix / modification proposals, which raises performance concerns. However,</p>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p>the JDT handles this the same way and</p>
+</li>
+<li>
+<p>this brings the implementation closer to content assist allowing more reuse, therefore this decision was taken.</p>
+</li>
+</ol>
+</div>
+</li>
+<li>
+<p>For consistency, matching of lower/upper/camel case is to be handled as in code completion during content assist. The same applies to display string formatting, esp. name formatting and coloring of element <em>e</em> and module <em>m</em>.</p>
+</li>
+<li>
+<p>Note that here we can make more assumptions than during import as part of content assist. For example, we know that the element is not imported yet (otherwise there would not be an error) and there won’t be a need for an alias and linked editing.</p>
+</li>
+</ol>
+</div>
+</dd>
+</dl>
+</div>
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Import_Issues"><a class="anchor" href="#sec:Import_Issues"></a><a class="link" href="#sec:Import_Issues">3.2.2.2. Import Issues</a></h5>
+
+</div>
+<div class="sect4">
+<h5 id="sec:Visibility_Issues"><a class="anchor" href="#sec:Visibility_Issues"></a><a class="link" href="#sec:Visibility_Issues">3.2.2.3. Visibility Issues</a></h5>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">VIS_ILLEGAL_MEMBER_ACCESS</dt>
+<dd>
+<p><code>The <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>m</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi></math> <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>m</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi></math> is not visible.</code></p>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Change access modifier to protected/public or remove <code>@Internal</code> annotation.</p>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Precondition</dt>
+<dd>
+<p>The file containing the declaration of <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>m</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi></math> is modifiable</p>
+</dd>
+<dt class="hdlist1">Postcondition</dt>
+<dd>
+<p>The access modifier has been changed so that <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>m</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi></math> is visible at issue location.</p>
+</dd>
+<dt class="hdlist1">User Data</dt>
+<dd>
+<div class="ulist">
+<ul>
+<li>
+<p><strong>ACCESS_SUGGESTION</strong> The most restrictive modifier making the member visible.</p>
+</li>
+<li>
+<p><strong>DECLARATION_OBJECT_URI</strong> The EObject URI of the member declaration</p>
+</li>
+</ul>
+</div>
+</dd>
+</dl>
+</div>
+</li>
+</ol>
+</div>
+</dd>
+</dl>
+</div>
+<div class="paragraph">
+<p>This table shows the access modifier changes to perform to fix the visibility issue while maintaining the strongest access restrictions possible.</p>
+</div>
+<table class="tableblock frame-all grid-all spread">
+<colgroup>
+<col style="width: 14.2857%;">
+<col style="width: 14.2857%;">
+<col style="width: 14.2857%;">
+<col style="width: 14.2857%;">
+<col style="width: 14.2857%;">
+<col style="width: 14.2857%;">
+<col style="width: 14.2858%;">
+</colgroup>
+<tbody>
+<tr>
+<td class="tableblock halign-center valign-top" rowspan="2"><p class="tableblock"><code>Access Modifier</code></p></td>
+<td class="tableblock halign-center valign-top" colspan="6"><p class="tableblock"><code>Accessible From</code></p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Inside Module</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Inside Project</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Vendor Subtypes</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Vendor Projects</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Other Subtypes</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Everywhere</code></p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>private</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>-</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>project</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>protected@Internal</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>public@Internal</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>protected</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>public</code></p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>project</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>-</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>-</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>protected@Internal</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>public@Internal</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>protected</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>public</code></p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>protected@Internal</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>-</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>-</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>-</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>public@Internal</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>protected</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>public</code></p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>protected</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>-</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>-</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>-</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>public@Internal</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>-</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>public</code></p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>public@Internal</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>-</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>-</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>-</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>-</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>public</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>public</code></p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>public</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>-</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>-</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>-</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>-</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>-</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>-</code></p></td>
+</tr>
+</tbody>
+</table>
+<div class="paragraph">
+<p>Member access modifier changes for quick fixes</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">VIS_ILLEGAL_FUN_ACCESS</dt>
+<dd>
+<p><code>The function <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>f</mi></math> is not visible.</code></p>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Change access modifier to protected/public or remove <code>@Internal</code> annotation.</p>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Precondition</dt>
+<dd>
+<p>–</p>
+</dd>
+<dt class="hdlist1">Postcondition</dt>
+<dd>
+<p>The access modifier has been changed so that <em>f</em> is visible at issue location.</p>
+</dd>
+<dt class="hdlist1">User Data</dt>
+<dd>
+<div class="ulist">
+<ul>
+<li>
+<p><strong>ACCESS_SUGGESTION</strong> The most restrictive modifier making the function visible.</p>
+</li>
+<li>
+<p><strong>DECLARATION_OBJECT_URI</strong> The EObject URI of the function declaration</p>
+</li>
+</ul>
+</div>
+</dd>
+</dl>
+</div>
+</li>
+</ol>
+</div>
+</dd>
+<dt class="hdlist1">VIS_ILLEGAL_TYPE_ACCESS</dt>
+<dd>
+<p><code>The type <em>T</em> is not visible.</code></p>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Change access modifier to protected/public or remove <code>@Internal</code> annotation.</p>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Precondition</dt>
+<dd>
+<p>–</p>
+</dd>
+<dt class="hdlist1">Postcondition</dt>
+<dd>
+<p>The access modifier has been changed so that <em>T</em> is visible at issue location.</p>
+</dd>
+<dt class="hdlist1">User Data</dt>
+<dd>
+<p>see VIS_ILLEGAL_FUN_ACCESS</p>
+</dd>
+</dl>
+</div>
+</li>
+</ol>
+</div>
+</dd>
+<dt class="hdlist1">VIS_ILLEGAL_VARIABLE_ACCESS</dt>
+<dd>
+<p><code>The variable <em>v</em> is not visible.</code></p>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Change access modifier to protected/public or remove <code>@Internal</code> annotation.</p>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Precondition</dt>
+<dd>
+<p>Module containing <em>v</em> is writeable.</p>
+</dd>
+<dt class="hdlist1">Postcondition</dt>
+<dd>
+<p>The access modifier has been changed so that <em>v</em> is visible at issue location.</p>
+</dd>
+<dt class="hdlist1">User Data</dt>
+<dd>
+<p>see VIS_ILLEGAL_FUN_ACCESS</p>
+</dd>
+</dl>
+</div>
+</li>
+</ol>
+</div>
+</dd>
+</dl>
+</div>
+<div class="paragraph">
+<p>For type, variable and function visibility issues the following changes have to be made to solve the visibility issue:</p>
+</div>
+<table id="tab:typeAccessControl" class="tableblock frame-all grid-all spread">
+<caption class="title">Table 1. Type,function and variable access modifier changes for quick fixes</caption>
+<colgroup>
+<col style="width: 20%;">
+<col style="width: 20%;">
+<col style="width: 20%;">
+<col style="width: 20%;">
+<col style="width: 20%;">
+</colgroup>
+<tbody>
+<tr>
+<th class="tableblock halign-center valign-top" rowspan="2"><p class="tableblock">Access Modifier</p></th>
+<th class="tableblock halign-center valign-top" colspan="4"><p class="tableblock">Accessible From</p></th>
+</tr>
+<tr>
+<th class="tableblock halign-center valign-top"><p class="tableblock">Module</p></th>
+<th class="tableblock halign-center valign-top"><p class="tableblock">Project</p></th>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Vendor</p></th>
+<th class="tableblock halign-left valign-top"><p class="tableblock">World</p></th>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>private</code></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>-</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>export project</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>export public@Internal</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>export public</code></p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>project</code></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>-</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>export project</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>export public@Internal</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>export public</code></p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>export project</code></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>-</code></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>-</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>export public@Internal</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>export public</code></p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>export public@Internal</code></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>-</code></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>-</code></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>-</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>export public</code></p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>export public</code></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>-</code></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>-</code></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>-</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>export public</code></p></td>
+</tr>
+</tbody>
+</table>
+</div>
+<div class="sect4">
+<h5 id="sec:Classifier_Issues"><a class="anchor" href="#sec:Classifier_Issues"></a><a class="link" href="#sec:Classifier_Issues">3.2.2.4. Classifier Issues</a></h5>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">CLF_EXTEND_FINAL</dt>
+<dd>
+<p><code>Cannot extend final class <em>C</em>.</code></p>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Remove <code>@Final</code> annotation in class <em>C</em></p>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Precondition</dt>
+<dd>
+<p>–</p>
+</dd>
+<dt class="hdlist1">Postcondition</dt>
+<dd>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mo>¬</mo><mi>C</mi><mo>.</mo><mi>f</mi><mi>i</mi><mi>n</mi><mi>a</mi><mi>l</mi></math></p>
+</dd>
+</dl>
+</div>
+</li>
+</ol>
+</div>
+</dd>
+<dt class="hdlist1">CLF_OBSERVABLE_MISSING</dt>
+<dd>
+<p><code>Class <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>0</mn></msub></math> extends observable class <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>1</mn></msub></math> and must therefore be annotated with @Observable.</code></p>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Add <code>@Obervable</code> annotation in class <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>0</mn></msub></math></p>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Precondition</dt>
+<dd>
+<p>–</p>
+</dd>
+<dt class="hdlist1">Postcondition</dt>
+<dd>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>0.</mn></msub><mi>o</mi><mi>b</mi><mi>s</mi><mi>e</mi><mi>r</mi><mi>v</mi><mi>a</mi><mi>b</mi><mi>l</mi><mi>e</mi></math></p>
+</dd>
+</dl>
+</div>
+</li>
+</ol>
+</div>
+</dd>
+<dt class="hdlist1">CLF_OVERRIDE_ANNOTATION</dt>
+<dd>
+<p><code>The <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>0</mn></msub></math> overriding <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>1</mn></msub></math> must be annotated with @Override.</code></p>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Add <code>@Override</code> annotation to <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>0</mn></msub></math></p>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Precondition</dt>
+<dd>
+<p>–</p>
+</dd>
+<dt class="hdlist1">Label</dt>
+<dd>
+<p><code>Add @Override</code></p>
+</dd>
+<dt class="hdlist1">Postcondition</dt>
+<dd>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>0.</mn></msub><mi>o</mi><mi>v</mi><mi>e</mi><mi>r</mi><mi>r</mi><mi>i</mi><mi>d</mi><mi>e</mi></math></p>
+</dd>
+</dl>
+</div>
+</li>
+</ol>
+</div>
+</dd>
+<dt class="hdlist1">CLF_OVERRIDE_FINAL</dt>
+<dd>
+<p><code>The <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>0</mn></msub></math> cannot override final <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>1</mn></msub></math>.</code></p>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Remove <code>@Final</code> annotation in <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>1</mn></msub></math></p>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Precondition</dt>
+<dd>
+<p>–</p>
+</dd>
+<dt class="hdlist1">Postcondition</dt>
+<dd>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mo>¬</mo><msub><mi>e</mi><mn>1.</mn></msub><mi>f</mi><mi>i</mi><mi>n</mi><mi>a</mi><mi>l</mi></math></p>
+</dd>
+</dl>
+</div>
+</li>
+</ol>
+</div>
+</dd>
+<dt class="hdlist1">CLF_OVERRIDE_VISIBILITY</dt>
+<dd>
+<p><code>The <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>0</mn></msub></math> cannot reduce the visibility of <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>1</mn></msub></math>.</code></p>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Set access modifier of <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>0</mn></msub></math> to access modifier of <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>1</mn></msub></math></p>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Precondition</dt>
+<dd>
+<p>–</p>
+</dd>
+<dt class="hdlist1">Postcondition</dt>
+<dd>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>0.</mn></msub><mi>a</mi><mi>c</mi><mi>c</mi><mo>=</mo><mo>=</mo><msub><mi>e</mi><mn>1.</mn></msub><mi>a</mi><mi>c</mi><mi>c</mi></math></p>
+</dd>
+</dl>
+</div>
+</li>
+</ol>
+</div>
+</dd>
+<dt class="hdlist1">CLF_OVERRIDE_NON_EXISTENT</dt>
+<dd>
+<p><code>The <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>0</mn></msub></math> <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>1</mn></msub></math> must override or implement a <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>0</mn></msub></math> from a super class, consumed role or implemented interface.</code></p>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Remove <code>@Override</code> annotation in <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>1</mn></msub></math></p>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Precondition</dt>
+<dd>
+<p>–</p>
+</dd>
+<dt class="hdlist1">Label</dt>
+<dd>
+<p><code>Remove @Override</code></p>
+</dd>
+<dt class="hdlist1">Postcondition</dt>
+<dd>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mo>¬</mo><msub><mi>e</mi><mn>1.</mn></msub><mi>o</mi><mi>v</mi><mi>e</mi><mi>r</mi><mi>r</mi><mi>i</mi><mi>d</mi><mi>e</mi></math></p>
+</dd>
+</dl>
+</div>
+</li>
+</ol>
+</div>
+</dd>
+<dt class="hdlist1">CLF_REDEFINED_TYPE_NOT_SAME_TYPE</dt>
+<dd>
+<p><code>Type of <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>0</mn></msub></math> must equal type of <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>1</mn></msub></math> <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>2</mn></msub></math>.</code></p>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Set declared type of <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>0</mn></msub></math> to declared type of <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>2</mn></msub></math></p>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Precondition</dt>
+<dd>
+<p>–</p>
+</dd>
+<dt class="hdlist1">Postcondition</dt>
+<dd>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>τ</mi><msub><mi>e</mi><mn>0</mn></msub><mo>=</mo><msub><mi>e</mi><mn>2</mn></msub></math></p>
+</dd>
+</dl>
+</div>
+</li>
+</ol>
+</div>
+</dd>
+<dt class="hdlist1">CLF_REDEFINED_MEMBER_TYPE_INVALID</dt>
+<dd>
+<p><code>Type of <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>0</mn></msub></math> does not conform to <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>2</mn></msub></math> <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>1</mn></msub></math>: <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>3</mn></msub></math>.</code></p>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Set declared type of <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>0</mn></msub></math> to declared type of <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>1</mn></msub></math></p>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Precondition</dt>
+<dd>
+<p>–</p>
+</dd>
+<dt class="hdlist1">Postcondition</dt>
+<dd>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>τ</mi><msub><mi>e</mi><mn>0</mn></msub><mo>=</mo><msub><mi>e</mi><mn>1</mn></msub></math></p>
+</dd>
+</dl>
+</div>
+</li>
+</ol>
+</div>
+</dd>
+<dt class="hdlist1">CLF_REDEFINED_METHOD_TYPE_CONFLICT</dt>
+<dd>
+<p><code>Signature of <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>0</mn></msub></math> does not conform to <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>1</mn></msub></math> <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>2</mn></msub></math>: <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>3</mn></msub></math>.</code></p>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Set declared type of <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>0</mn></msub></math> to declared type of <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>2</mn></msub></math></p>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Precondition</dt>
+<dd>
+<p>–</p>
+</dd>
+<dt class="hdlist1">Postcondition</dt>
+<dd>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>τ</mi><msub><mi>e</mi><mn>0</mn></msub><mo>=</mo><msub><mi>e</mi><mn>2</mn></msub></math></p>
+</dd>
+</dl>
+</div>
+</li>
+</ol>
+</div>
+</dd>
+<dt class="hdlist1">CLF_MISSING_IMPLEMENTATION</dt>
+<dd>
+<p><code>Class <em>C</em> must either be defined abstract or implement <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>m</mi></math>.</code></p>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Declare <em>C</em> as abstract</p>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Precondition</dt>
+<dd>
+<p>–</p>
+</dd>
+<dt class="hdlist1">Postcondition</dt>
+<dd>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>C</mi><mo>.</mo><mi>a</mi><mi>b</mi><mi>s</mi><mi>t</mi><mi>r</mi><mi>a</mi><mi>c</mi><mi>t</mi></math></p>
+</dd>
+</dl>
+</div>
+</li>
+</ol>
+</div>
+</dd>
+<dt class="hdlist1">CLF_ABSTRACT_BODY</dt>
+<dd>
+<p><code>Abstract methods do not specify a body.</code> for method <em>M</em></p>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Remove abstract annotation from method.</p>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Precondition</dt>
+<dd>
+<p>–</p>
+</dd>
+<dt class="hdlist1">Postcondition</dt>
+<dd>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mo>¬</mo><mi>M</mi><mo>.</mo><mi>a</mi><mi>b</mi><mi>s</mi><mi>t</mi><mi>r</mi><mi>a</mi><mi>c</mi><mi>t</mi></math></p>
+</dd>
+</dl>
+</div>
+</li>
+</ol>
+</div>
+</dd>
+<dt class="hdlist1">CLF_ABSTRACT_MISSING</dt>
+<dd>
+<p><code>The abstract <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>0</mn></msub></math> <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>1</mn></msub></math> in class <em>C</em> can only be defined in an abstract class.</code></p>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Declare <em>C</em> as abstract</p>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Precondition</dt>
+<dd>
+<p>–</p>
+</dd>
+<dt class="hdlist1">Postcondition</dt>
+<dd>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>C</mi><mo>.</mo><mi>a</mi><mi>b</mi><mi>s</mi><mi>t</mi><mi>r</mi><mi>a</mi><mi>c</mi><mi>t</mi></math></p>
+</dd>
+<dt class="hdlist1">Multi appliable</dt>
+<dd>
+<p>false</p>
+</dd>
+</dl>
+</div>
+</li>
+</ol>
+</div>
+</dd>
+<dt class="hdlist1">CLF_MISSING_BODY</dt>
+<dd>
+<p><code>The <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>0</mn></msub></math> <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>1</mn></msub></math> has to have either a body or must be defined abstract.</code></p>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Declare <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>1</mn></msub></math> as abstract</p>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Precondition</dt>
+<dd>
+<p>–</p>
+</dd>
+<dt class="hdlist1">Postcondition</dt>
+<dd>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>1.</mn></msub><mi>a</mi><mi>b</mi><mi>s</mi><mi>t</mi><mi>r</mi><mi>a</mi><mi>c</mi><mi>t</mi></math></p>
+</dd>
+</dl>
+</div>
+</li>
+</ol>
+</div>
+</dd>
+<dt class="hdlist1">CLF_EXT_EXTERNAL_N4JSD</dt>
+<dd>
+<p><code><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>0</mn></msub></math> declared as external have to be placed in a file with file extension ’n4jsd’.</code></p>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Remove external annotation</p>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Precondition</dt>
+<dd>
+<p>–</p>
+</dd>
+<dt class="hdlist1">Postcondition</dt>
+<dd>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mo>¬</mo><msub><mi>e</mi><mn>0.</mn></msub><mi>e</mi><mi>x</mi><mi>t</mi><mi>e</mi><mi>r</mi><mi>n</mi><mi>a</mi><mi>l</mi></math></p>
+</dd>
+</dl>
+</div>
+</li>
+<li>
+<p>Change module file extension to n4jsd</p>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Precondition</dt>
+<dd>
+<p>–</p>
+</dd>
+<dt class="hdlist1">Postcondition</dt>
+<dd>
+<p>module file extension is n4jsd</p>
+</dd>
+</dl>
+</div>
+</li>
+</ol>
+</div>
+</dd>
+<dt class="hdlist1">CLF_NOT_EXPORTED_NOT_PRIVATE</dt>
+<dd>
+<p><code>A <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>0</mn></msub></math> with visibility <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>1</mn></msub></math> must be marked as exported.</code></p>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Export <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>0</mn></msub></math></p>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Precondition</dt>
+<dd>
+<p>–</p>
+</dd>
+<dt class="hdlist1">Postcondition</dt>
+<dd>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>e</mi><mn>0</mn></msub></math> is exported</p>
+</dd>
+</dl>
+</div>
+</li>
+</ol>
+</div>
+</dd>
+</dl>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Function_Issues"><a class="anchor" href="#sec:Function_Issues"></a><a class="link" href="#sec:Function_Issues">3.2.2.5. Function Issues</a></h5>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+FUN_BLOCK
+</td>
+<td class="hdlist2">
+<p><code>Functions declarations should not be placed in blocks. Use a function expression or move the statement to the top of the outer function.</code> with function <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>F</mi></math></p>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Change function declaration to function expression</p>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Precondition</dt>
+<dd>
+<p>–</p>
+</dd>
+<dt class="hdlist1">Postcondition</dt>
+</dl>
+</div>
+</li>
+</ol>
+</div>
+</td>
+</tr>
+</table>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mtable><mtr><mtd/><mtd><mo>∃</mo><mstyle mathvariant="monospace"><mtext>Variable</mtext></mstyle><mi> </mi><mi>v</mi><mo>∈</mo><mi>F</mi><mo>.</mo><mi>v</mi><mi>e</mi><mi>e</mi><mi>:</mi></mtd></mtr><mtr><mtd/><mtd><mspace width="3.0em"/><mi>v</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><mi>F</mi></mtd></mtr><mtr><mtd/><mtd><mspace width="3.0em"/><mo>∧</mo><mi>v</mi><mo>.</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mo>.</mo><mi>μ</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>FunctionExpression</mtext></mstyle></mtd></mtr><mtr><mtd/><mtd><mspace width="3.0em"/><mo>∧</mo><mi>v</mi><mo>.</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><mi>F</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>,</mo><mi>v</mi><mo>.</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mo>.</mo><mi>b</mi><mi>o</mi><mi>d</mi><mi>y</mi><mo>=</mo><mi>F</mi><mo>.</mo><mi>b</mi><mi>o</mi><mi>d</mi><mi>y</mi></mtd></mtr></mtable></math>
+</div>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Description</dt>
+<dd>
+<p>Change function declaration to function expression assigned to variable of the function name</p>
+</dd>
+</dl>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Syntax_Issues"><a class="anchor" href="#sec:Syntax_Issues"></a><a class="link" href="#sec:Syntax_Issues">3.2.2.6. Syntax Issues</a></h5>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">AST_STR_FUN_NOT_NESTED</dt>
+<dd>
+<p><code>Functions must only be declared on script level or as part of other expressions</code></p>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Change function declaration to function expression assigned to variable of the function name</p>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Precondition</dt>
+<dd>
+<p>–</p>
+</dd>
+<dt class="hdlist1">Postcondition</dt>
+</dl>
+</div>
+</li>
+</ol>
+</div>
+</dd>
+</dl>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mtable><mtr><mtd/><mtd><mo>∃</mo><mstyle mathvariant="monospace"><mtext>Variable</mtext></mstyle><mi> </mi><mi>v</mi><mo>∈</mo><mi>F</mi><mo>.</mo><mi>v</mi><mi>e</mi><mi>e</mi><mi>:</mi></mtd></mtr><mtr><mtd/><mtd><mspace width="3.0em"/><mi>v</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><mi>F</mi></mtd></mtr><mtr><mtd/><mtd><mspace width="3.0em"/><mo>∧</mo><mi>v</mi><mo>.</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mo>.</mo><mi>μ</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>FunctionExpression</mtext></mstyle></mtd></mtr><mtr><mtd/><mtd><mspace width="3.0em"/><mo>∧</mo><mi>v</mi><mo>.</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><mi>F</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>,</mo><mi>v</mi><mo>.</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mo>.</mo><mi>b</mi><mi>o</mi><mi>d</mi><mi>y</mi><mo>=</mo><mi>F</mi><mo>.</mo><mi>b</mi><mi>o</mi><mi>d</mi><mi>y</mi></mtd></mtr></mtable></math>
+</div>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">SYN_MODIFIER_BAD_ORDER</dt>
+<dd>
+<p><code>Modifiers should appear in this order: O </code></p>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Rearrange access modifiers</p>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Precondition</dt>
+<dd>
+<p>–</p>
+</dd>
+<dt class="hdlist1">Postcondition</dt>
+<dd>
+<p>Modifiers are in order O</p>
+</dd>
+<dt class="hdlist1">Description</dt>
+<dd>
+<p>Reorder the access modifiers to match the N4JS compliant order.</p>
+</dd>
+</dl>
+</div>
+</li>
+</ol>
+</div>
+</dd>
+</dl>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Conversion_Issues"><a class="anchor" href="#sec:Conversion_Issues"></a><a class="link" href="#sec:Conversion_Issues">3.2.2.7. Conversion Issues</a></h5>
+
+</div>
+<div class="sect4">
+<h5 id="sec:Type_Issues"><a class="anchor" href="#sec:Type_Issues"></a><a class="link" href="#sec:Type_Issues">3.2.2.8. Type Issues</a></h5>
+
+</div>
+<div class="sect4">
+<h5 id="sec:Expression_Issues"><a class="anchor" href="#sec:Expression_Issues"></a><a class="link" href="#sec:Expression_Issues">3.2.2.9. Expression Issues</a></h5>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">EXP_WRONG_NUMBER_OF_TYPEARGS</dt>
+<dd>
+<p><code>Incorrect number of type arguments for <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi></math> <em>C</em>: expected <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>t</mi><mi>p</mi><mi>c</mi><mi>o</mi><mi>u</mi><mi>n</mi><mi>t</mi></math>, got <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>t</mi><mi>a</mi><mi>c</mi><mi>o</mi><mi>u</mi><mi>n</mi><mi>t</mi></math>.</code></p>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Remove superfluous arguments</p>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Precondition</dt>
+<dd>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>t</mi><mi>a</mi><mi>c</mi><mi>o</mi><mi>u</mi><mi>n</mi><mi>t</mi><mo>&gt;</mo><mi>t</mi><mi>p</mi><mi>c</mi><mi>o</mi><mi>u</mi><mi>n</mi><mi>t</mi></math></p>
+</dd>
+<dt class="hdlist1">Postcondition</dt>
+<dd>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>t</mi><mi>a</mi><mi>c</mi><mi>o</mi><mi>u</mi><mi>n</mi><mi>t</mi><mo>=</mo><mi>t</mi><mi>p</mi><mi>c</mi><mi>o</mi><mi>u</mi><mi>n</mi><mi>t</mi></math></p>
+</dd>
+<dt class="hdlist1">Description</dt>
+</dl>
+</div>
+</li>
+</ol>
+</div>
+</dd>
+<dt class="hdlist1">EXP_NUM_OF_ARGS_TOO_MANY</dt>
+<dd>
+<p><code>Incorrect number of arguments: expected <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>f</mi><mi>p</mi><mi>c</mi><mi>o</mi><mi>u</mi><mi>n</mi><mi>t</mi></math>, got <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>a</mi><mi>r</mi><mi>g</mi><mi>c</mi><mi>o</mi><mi>u</mi><mi>n</mi><mi>t</mi></math>.</code></p>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Remove superfluous arguments</p>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Precondition</dt>
+<dd>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>a</mi><mi>r</mi><mi>g</mi><mi>c</mi><mi>o</mi><mi>u</mi><mi>n</mi><mi>t</mi><mo>&gt;</mo><mi>f</mi><mi>p</mi><mi>c</mi><mi>o</mi><mi>u</mi><mi>n</mi><mi>t</mi></math></p>
+</dd>
+<dt class="hdlist1">Postcondition</dt>
+<dd>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>a</mi><mi>r</mi><mi>g</mi><mi>c</mi><mi>o</mi><mi>u</mi><mi>n</mi><mi>t</mi><mo>=</mo><mi>f</mi><mi>p</mi><mi>c</mi><mi>o</mi><mi>u</mi><mi>n</mi><mi>t</mi></math></p>
+</dd>
+<dt class="hdlist1">Description</dt>
+</dl>
+</div>
+</li>
+</ol>
+</div>
+</dd>
+<dt class="hdlist1">EXP_CAST_UNNECESSARY</dt>
+<dd>
+<p><code>Unnecessary cast from <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>S</mi></math> to <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi></math></code></p>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Remove cast</p>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Precondition</dt>
+<dd>
+<p>–</p>
+</dd>
+<dt class="hdlist1">Postcondition</dt>
+<dd>
+<p>cast removed</p>
+</dd>
+<dt class="hdlist1">Description</dt>
+</dl>
+</div>
+</li>
+</ol>
+</div>
+</dd>
+</dl>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Super_Keyword_Issues"><a class="anchor" href="#sec:Super_Keyword_Issues"></a><a class="link" href="#sec:Super_Keyword_Issues">3.2.2.10. Super Keyword Issues</a></h5>
+
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="sec:Quick_Assist"><a class="anchor" href="#sec:Quick_Assist"></a><a class="link" href="#sec:Quick_Assist">3.3. Quick Assist</a></h3>
+
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:Cleanup_Operations"><a class="anchor" href="#sec:Cleanup_Operations"></a><a class="link" href="#sec:Cleanup_Operations">3.4. Cleanup Operations</a></h3>
+<div class="sect3">
+<h4 id="sec:Formatting"><a class="anchor" href="#sec:Formatting"></a><a class="link" href="#sec:Formatting">3.4.1. Formatting</a></h4>
+
+</div>
+<div class="sect3">
+<h4 id="sec:Organize_Imports"><a class="anchor" href="#sec:Organize_Imports"></a><a class="link" href="#sec:Organize_Imports">3.4.2. Organize Imports</a></h4>
+<div class="paragraph">
+<p>Import statements can be cleaned up or automatically inserted by invoking <code>Organize Imports</code>. <code>Organize Imports</code> is available in the context menu <code>Source / Organise imports</code> , in menu <code>Source &gt; Organize imports</code> or by hitting <kbd>Cmd</kbd> + <kbd>Option</kbd> +<kbd>O</kbd> (Win/Linux - <kbd>Ctrl</kbd> +<kbd>Alt</kbd> +<kbd>O</kbd>).</p>
+</div>
+<div class="paragraph">
+<p>For a valid file without errors, this will result in the following actions:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Unused explicit imports will be removed.</p>
+</li>
+<li>
+<p>Unused wildcard imports will be removed.</p>
+</li>
+<li>
+<p>In each import statement the imported elements will be lexicographically sorted depending on the imported element’s name.</p>
+</li>
+<li>
+<p>All import statements will be lexicographically sorted depending on the module specifier as major and the element name as minor key.</p>
+</li>
+<li>
+<p>All import statements will be moved to the top of the file.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>For a file with error-conditions of unresolved references, this will result in the automatic actions:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>All ambiguous wildcard imports will be presented in one dialog, requesting the user to resolve the ambiguity.</p>
+</li>
+<li>
+<p>Each uniquely resolvable <code>unresolved Classifier</code> will be added by a named import. The search scope is limited to the dependencies declared in the current project-setup.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>No action will be taken, if &#8230;&#8203;</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>a classifier with name <code>X</code> is already imported by name from a module <code>A</code> and a unknown member of this classifier is marked. Even though the import of <code>X</code> from a different module <code>B</code> could remove this error, the semantic consequences could not be evaluated. The state will be left as-is.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>If more then one option leads to a possible resolution the situation should be clarified using quick-fixes, e.g. if &#8230;&#8203;</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>more then one module provides an element, which would render a formerly unresolved reference to be valid.</p>
+</li>
+<li>
+<p>for a wildcard-imported element <code>X</code> there are unknown members and a different module provides an element <code>X</code> containing the missing members. In such a case a named import of <code>X</code> would be proposed, optionally using an alias.</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div id="footer">
+<div id="footer-text">
+Version 0.9<br>
+Last updated 2019-08-07 15:02:40 CEST
+</div>
+</div>
+<!-- ************* docinfo-footer *************************************************************** -->
+<div class="Grid social" style="color:#d5dfea">
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <h2>Quick Links</h2>
+    <ul>
+      <li><a href="../downloads.html">Download</a></li>
+      <li><a href="../userguides/index.html">Documentation</a></li>
+      <li><a href="https://github.com/eclipse/n4js/">Source</a></li>
+      <li><a href="https://github.com/eclipse/n4js/issues">Issues</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="https://www.eclipse.org/forums/index.php/f/365/">Forum</a></li>
+      <li><a href="http://n4js.blogspot.de/">Blog</a></li>
+      <li><a href="https://dev.eclipse.org/mailman/listinfo/n4js-dev">Mailing List</a></li>
+      <li><a href="https://projects.eclipse.org/projects/technology.n4js">Eclipse Project Page</a></li>
+      <li><a href="https://twitter.com/n4jsdev">Tweets by n4jsdev</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="http://www.eclipse.org/">Eclipse Home</a></li>
+      <li><a href="http://www.eclipse.org/legal/privacy.php">Privacy Policy</a></li>
+      <li><a href="http://www.eclipse.org/legal/termsofuse.php">Terms of Use</a></li>
+      <li><a href="http://www.eclipse.org/legal/copyright.php">Copyright Agent</a></li>
+      <li><a href="http://www.eclipse.org/legal/">Legal</a></li>
+    </ul>
+  </div>
+  <div style="clear: both; height: 0; overflow: hidden;"></div>
+</div>
+
+<!-- ************* UI Scripts ************* -->
+<script type="text/javascript" src="scripts/back-to-top.js"></script>
+
+<script type="text/javascript" src="scripts/treeview.js"></script>
+<script type="text/javascript" src="scripts/toc.js"></script>
+
+<!-- ************* Prism.js Syntax Highlighting ************* -->
+<script src="scripts/prism.js"></script>
+
+<script type="text/javascript">
+	// Add the 'toclist' id for search function
+	$(".toc2 > ul").attr('id', 'toclist');
+	// Generate a Search input form
+	$("#toclist > li:first-of-type").before('<input type="text" id="pagesearch" onkeyup="search()" placeholder="Search for section...">');
+	$("#toclist > li:first-of-type").before('<i id="clear" class="fa fa-times-circle-o"></i>');
+	$("#clear").click(function(){
+	    $("#pagesearch").val('');
+	    search();
+	    $('.toc2 > ul').treeView('collapseAll');
+	});
+	// intialize Treeview.js
+	$(".toc2 > ul").treeView();
+	// Initialize Scrollspy
+</script>
+<!-- ************* docinfo-footer *************************************************************** -->
+</body>
+</html>
\ No newline at end of file
diff --git a/idespec/bug_management.html b/idespec/bug_management.html
new file mode 100644
index 0000000..c06f8da
--- /dev/null
+++ b/idespec/bug_management.html
@@ -0,0 +1,562 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="generator" content="Asciidoctor 1.5.5">
+<meta name="author" content="2019-08-07 15:02:40 CEST">
+<title>N4JS IDE Specification</title>
+<link rel="stylesheet" href="styles/spec.min.css">
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.6.3/css/font-awesome.min.css">
+<!-- ************* docinfo ******************************************************************* -->
+
+
+<!-- ************* Favicon ************-->
+<link rel="icon" href="images/favicon.ico" />
+
+<!-- ************* Back-to-top JQuery ************* -->
+<script src="https://code.jquery.com/jquery-1.12.4.js"></script>
+<script src="https://code.jquery.com/ui/1.12.0/jquery-ui.js"></script>
+
+
+<link href="styles/prism.min.css" rel="stylesheet" />
+<script type="text/javascript" async
+  src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2/MathJax.js?config=TeX-MML-AM_CHTML">
+</script>
+
+<!-- ************* Styles ************* -->
+<link rel="stylesheet" type="text/css" href="styles/n4jsspec-adoc.css">
+
+
+<!-- ****************** NavBar ****************** -->
+<div id="menubar">
+	<div class="banner">
+        <a href="https://www.eclipse.org/n4js/#"><img id="logo" src="images/n4js-logo.png" alt="Eclipse N4JS"></a>
+    </div>
+<ul>
+  <li><a href="index.html">Index</a></li>
+</ul>
+</div>
+<!-- ************* docinfo ******************************************************************* -->
+<style>
+      .admonitionblock td.icon .icon-todo:before{content:"\f249";color:#f4ee42}
+    </style>
+</head>
+<body class="book toc2 toc-left">
+<div id="header">
+<h1>N4JS IDE Specification</h1>
+<div class="details">
+<span id="author" class="author">2019-08-07 15:02:40 CEST</span><br>
+<span id="revnumber">version 0.9</span>
+</div>
+<div id="toc" class="toc2">
+<div id="toctitle">Table of Contents</div>
+<ul class="sectlevel1">
+<li><a href="views.html#sec:Views">1. Views</a>
+<ul class="sectlevel2">
+<li><a href="views.html#_eclipse-standard-views">1.1. Eclipse Standard Views</a>
+<ul class="sectlevel3">
+<li><a href="views.html#sec:Project_Explorer_View">1.1.1. Project Explorer</a></li>
+<li><a href="views.html#sec:Outline_View">1.1.2. Outline</a></li>
+<li><a href="views.html#sec:Problems_View">1.1.3. Problems</a></li>
+<li><a href="views.html#sec:Console_View">1.1.4. Console</a></li>
+<li><a href="views.html#sec:History_View">1.1.5. History</a></li>
+<li><a href="views.html#sec:Error_Log_View">1.1.6. Error Log</a></li>
+</ul>
+</li>
+<li><a href="views.html#_n4js-specific-views">1.2. N4JS Specific Views</a>
+<ul class="sectlevel3">
+<li><a href="views.html#_test-results">1.2.1. Test Results</a></li>
+<li><a href="views.html#_source-graphs">1.2.2. Source Graphs</a></li>
+<li><a href="views.html#_api-compare">1.2.3. API Compare</a></li>
+<li><a href="views.html#_performance-graphs">1.2.4. Performance Graphs</a></li>
+<li><a href="views.html#_source-mapping">1.2.5. Source Mapping</a></li>
+<li><a href="views.html#_xpect-view">1.2.6. Xpect View</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="navigation.html#_navigation">2. Navigation</a>
+<ul class="sectlevel2">
+<li><a href="navigation.html#sec:Outline_Navigation">2.1. Outline</a>
+<ul class="sectlevel3">
+<li><a href="navigation.html#_quick-outline">2.1.1. Quick Outline</a></li>
+<li><a href="navigation.html#_normal-outline">2.1.2. Normal Outline</a></li>
+</ul>
+</li>
+<li><a href="navigation.html#_navigation-commands">2.2. Navigation Commands</a>
+<ul class="sectlevel3">
+<li><a href="navigation.html#sec:Navigate_to_Declaration">2.2.1. Navigate to Declaration</a></li>
+<li><a href="navigation.html#sec:find_by_references">2.2.2. Find by References</a></li>
+<li><a href="navigation.html#sec:Open_Type_Declaration">2.2.3. Open Type Declaration</a></li>
+</ul>
+</li>
+<li><a href="navigation.html#sec:Working_Sets">2.3. Working Sets</a>
+<ul class="sectlevel3">
+<li><a href="navigation.html#sec:Working_Set_Managers">2.3.1. Working Set Managers</a></li>
+<li><a href="navigation.html#sec:Working_Set_Constraints">2.3.2. Working Set Constraints</a></li>
+<li><a href="navigation.html#sec:Manual_Association_Working_Set_Manager_UI_Features">2.3.3. Manual Association Working Set Manager - UI Features</a></li>
+<li><a href="navigation.html#sec:Project_Name_Filter_Working_Set_Manager">2.3.4. Project Name Filter Working Set Manager</a></li>
+<li><a href="navigation.html#sec:Git_Repository_Working_Set_Manager">2.3.5. Git Repository Working Set Manager</a></li>
+<li><a href="navigation.html#sec:Project_Location_Working_Set_Manager">2.3.6. Project Location Working Set Manager</a></li>
+<li><a href="navigation.html#sec:N4JS_Project_Type_Working_Set_Manager">2.3.7. N4JS Project Type Working Set Manager</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="assistance.html#_assistance">3. Assistance</a>
+<ul class="sectlevel2">
+<li><a href="assistance.html#sec:Content_Assist">3.1. Content Assist</a>
+<ul class="sectlevel3">
+<li><a href="assistance.html#sec:Complete_Keywords">3.1.1. Complete Keywords</a></li>
+<li><a href="assistance.html#sec:Complete_Annotations">3.1.2. Complete Annotations</a></li>
+<li><a href="assistance.html#sec:Complete_Identifier_Reference">3.1.3. Complete Identifier Reference</a></li>
+<li><a href="assistance.html#sec:Complete_Member_Overrides">3.1.4. Complete Member Overrides</a></li>
+<li><a href="assistance.html#sec:Constructor_Completion">3.1.5. Constructor Completion</a></li>
+<li><a href="assistance.html#sec:Complete_Function_Expression">3.1.6. Complete Function Expression with Known Type</a></li>
+<li><a href="assistance.html#sec:Complete_Variable_and_Parameter_Names">3.1.7. Complete Variable and Parameter Names</a></li>
+</ul>
+</li>
+<li><a href="assistance.html#sec:Quick_Fixes">3.2. Quick Fixes</a>
+<ul class="sectlevel3">
+<li><a href="assistance.html#sec:N4JS_Issue_Properties">3.2.1. N4JS Issue User data</a></li>
+<li><a href="assistance.html#sec:N4JS_Issue_Fixes">3.2.2. N4JS Issue Fixes</a>
+<ul class="sectlevel4">
+<li><a href="assistance.html#sec:Linking_Issues">3.2.2.1. Linking Issues</a></li>
+<li><a href="assistance.html#sec:Import_Issues">3.2.2.2. Import Issues</a></li>
+<li><a href="assistance.html#sec:Visibility_Issues">3.2.2.3. Visibility Issues</a></li>
+<li><a href="assistance.html#sec:Classifier_Issues">3.2.2.4. Classifier Issues</a></li>
+<li><a href="assistance.html#sec:Function_Issues">3.2.2.5. Function Issues</a></li>
+<li><a href="assistance.html#sec:Syntax_Issues">3.2.2.6. Syntax Issues</a></li>
+<li><a href="assistance.html#sec:Conversion_Issues">3.2.2.7. Conversion Issues</a></li>
+<li><a href="assistance.html#sec:Type_Issues">3.2.2.8. Type Issues</a></li>
+<li><a href="assistance.html#sec:Expression_Issues">3.2.2.9. Expression Issues</a></li>
+<li><a href="assistance.html#sec:Super_Keyword_Issues">3.2.2.10. Super Keyword Issues</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="assistance.html#sec:Quick_Assist">3.3. Quick Assist</a></li>
+<li><a href="assistance.html#sec:Cleanup_Operations">3.4. Cleanup Operations</a>
+<ul class="sectlevel3">
+<li><a href="assistance.html#sec:Formatting">3.4.1. Formatting</a></li>
+<li><a href="assistance.html#sec:Organize_Imports">3.4.2. Organize Imports</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="wizards.html#_wizards">4. Wizards</a>
+<ul class="sectlevel2">
+<li><a href="wizards.html#sec:N4JS_Project_Wizard">4.1. N4JS Project Wizard</a></li>
+<li><a href="wizards.html#sec:Empty_N4JS_File">4.2. Empty N4JS File</a></li>
+<li><a href="wizards.html#sec:Empty_JS_File">4.3. Empty JS File</a>
+<ul class="sectlevel3">
+<li><a href="wizards.html#sec:N4JS_Class_File_Wizard">4.3.1. N4JS Class Wizard</a></li>
+<li><a href="wizards.html#field-properties">4.3.2. Field Properties</a></li>
+<li><a href="wizards.html#visibility-issues-or-final-super-classes">4.3.3. Visibility issues or <code>@Final</code> super classes</a></li>
+<li><a href="wizards.html#generation-1">4.3.4. Generation</a></li>
+<li><a href="wizards.html#preview-1">4.3.5. Preview</a></li>
+</ul>
+</li>
+<li><a href="wizards.html#sec:N4JS_Interface_Wizard">4.4. Interface Wizard</a>
+<ul class="sectlevel3">
+<li><a href="wizards.html#field-properties-1">4.4.1. Field Properties</a></li>
+<li><a href="wizards.html#visibility-issues">4.4.2. Visibility Issues</a></li>
+<li><a href="wizards.html#import-naming-conflicts">4.4.3. Import naming conflicts</a></li>
+<li><a href="wizards.html#generation-2">4.4.4. Generation</a></li>
+<li><a href="wizards.html#preview-2">4.4.5. Preview</a></li>
+</ul>
+</li>
+<li><a href="wizards.html#sec:N4JS_Enum_File_Wizard">4.5. Enum Wizard</a>
+<ul class="sectlevel3">
+<li><a href="wizards.html#field-properties-2">4.5.1. Field Properties</a></li>
+<li><a href="wizards.html#generation-3">4.5.2. Generation</a></li>
+<li><a href="wizards.html#preview-3">4.5.3. Preview</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="execution_support.html#_execution-support">5. Execution Support</a>
+<ul class="sectlevel2">
+<li><a href="execution_support.html#sec:Non_UI_Execution">5.1. Non-UI Execution</a>
+<ul class="sectlevel3">
+<li><a href="execution_support.html#sec:Non_UI_Debugging">5.1.1. Non-UI Debugging</a></li>
+</ul>
+</li>
+<li><a href="execution_support.html#sec:UI_Execution">5.2. UI Execution</a></li>
+</ul>
+</li>
+<li><a href="test_support.html#_test-support">6. Test Support</a>
+<ul class="sectlevel2">
+<li><a href="test_support.html#sec:N4JS_Mangelhaft_support">6.1. N4JS Mangelhaft support</a>
+<ul class="sectlevel3">
+<li><a href="test_support.html#sec:Asynchronous_Tests">6.1.1. Asynchronous Tests, Test Isolation and Timeouts</a></li>
+<li><a href="test_support.html#sec:Supported_xUnit_API">6.1.2. Supported xUnit API</a>
+<ul class="sectlevel4">
+<li><a href="test_support.html#sec:Test_Group">6.1.2.1. Test Group</a></li>
+<li><a href="test_support.html#sec:Test_Method">6.1.2.2. Test Method</a></li>
+<li><a href="test_support.html#sec:BeforeAll">6.1.2.3. BeforeAll Setup</a></li>
+<li><a href="test_support.html#sec:Before_Setup">6.1.2.4. Before Setup</a></li>
+<li><a href="test_support.html#sec:After_Teardown">6.1.2.5. After Teardown</a></li>
+<li><a href="test_support.html#sec:AfterAll_Teardown">6.1.2.6. AfterAll Teardown</a></li>
+<li><a href="test_support.html#sec:Test_Ignore">6.1.2.7. Test Ignore</a></li>
+<li><a href="test_support.html#sec:Timeout">6.1.2.8. Timeout</a></li>
+<li><a href="test_support.html#sec:Description">6.1.2.9. Description</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="test_support.html#sec:Test_Reporting">6.2. Test Reporting</a>
+<ul class="sectlevel3">
+<li><a href="test_support.html#sec:Test_Messages">6.2.1. Test Messages</a>
+<ul class="sectlevel4">
+<li><a href="test_support.html#_test-case-ids">6.2.1.1. Test Case IDs</a></li>
+<li><a href="test_support.html#sec:Start_Session">6.2.1.2. Start Session</a></li>
+<li><a href="test_support.html#sec:Ping_Session">6.2.1.3. Ping Session</a></li>
+<li><a href="test_support.html#sec:End_Session">6.2.1.4. End Session</a></li>
+<li><a href="test_support.html#sec:Start_Test">6.2.1.5. Start Test</a></li>
+<li><a href="test_support.html#sec:End_Test">6.2.1.6. End Test</a></li>
+<li><a href="test_support.html#sec:Ping_Test">6.2.1.7. Ping Test</a></li>
+<li><a href="test_support.html#sec:Test_Catalog">6.2.1.8. Test Catalog</a></li>
+<li><a href="test_support.html#sec:Test_Session_Example">6.2.1.9. Test Session Example</a></li>
+</ul>
+</li>
+<li><a href="test_support.html#sec:Test_Runtime_Configuration">6.2.2. Test Runtime Configuration</a></li>
+<li><a href="test_support.html#sec:Test_Plan">6.2.3. Test Plan</a></li>
+<li><a href="test_support.html#sec:Test_Environment_Configuration">6.2.4. Test Environment Configuration</a></li>
+<li><a href="test_support.html#sec:Test_Environment_Configuration_Example">6.2.5. Test Environment Configuration Example</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="help_system.html#_help-system">7. Help System</a>
+<ul class="sectlevel2">
+<li><a href="help_system.html#sec:Built_In_Help">7.1. Built-In Help</a></li>
+<li><a href="help_system.html#sec:Context_Sensitive_Help">7.2. Context Sensitive Help</a></li>
+<li><a href="help_system.html#sec:Cheat_Sheets">7.3. Cheat Sheets</a></li>
+<li><a href="help_system.html#sec:JSDoc">7.4. JSDoc</a></li>
+<li><a href="help_system.html#sec:Hovering">7.5. Hovering</a>
+<ul class="sectlevel3">
+<li><a href="help_system.html#sec:Show_Type_Information_of_Selection">7.5.1. Show Type Information of Selection</a></li>
+</ul>
+</li>
+<li><a href="help_system.html#sec:Example_Projects_and_Files">7.6. Example Projects and Files</a></li>
+</ul>
+</li>
+<li><a href="#_bug-management">8. Bug Management</a>
+<ul class="sectlevel2">
+<li><a href="#sec:Built_In_Xpect_Support">8.1. Built-In Xpect Support</a>
+<ul class="sectlevel3">
+<li><a href="#sec:Report_View">8.1.1. Report View</a></li>
+<li><a href="#sec:Generate_Bug_Report">8.1.2. Generate Bug Report</a></li>
+<li><a href="#sec:Supported_Xpect_Tests">8.1.3. Supported Xpect Tests</a>
+<ul class="sectlevel4">
+<li><a href="#sec:XPECT_N4JS_Errors">8.1.3.1. Errors, Warnings, Infos, Issues</a></li>
+<li><a href="#sec:XPECT_N4JS_Noerrors">8.1.3.2. Noerrors</a></li>
+<li><a href="#sec:XPECT_N4JS_Output">8.1.3.3. Output, OutputRegex</a></li>
+<li><a href="#sec:XPECT_N4JS_Type_Of">8.1.3.4. Type Of</a></li>
+<li><a href="#sec:XPECT_Advanced_Methods">8.1.3.5. Advanced methods</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="cli.html#_cli">9. CLI</a>
+<ul class="sectlevel2">
+<li><a href="cli.html#sec:Headless_Compiler">9.1. Headless Compiler</a></li>
+<li><a href="cli.html#sec:Headless_Dependencies">9.2. Headless Dependnecies</a></li>
+<li><a href="cli.html#sec:Headless_Execution">9.3. Headless Execution</a>
+<ul class="sectlevel3">
+<li><a href="cli.html#sec:Cleaning_Headlessly">9.3.1. Cleaning Headlessly</a></li>
+<li><a href="cli.html#sec:Running_Headlessly">9.3.2. Running Headlessly</a></li>
+<li><a href="cli.html#sec:Information_about_running_headlessly">9.3.3. Information about running headlessly</a></li>
+<li><a href="cli.html#sec:Testing_Headlessly">9.3.4. Testing Headlessly</a></li>
+<li><a href="cli.html#sec:Information_about_testing_headlessly">9.3.5. Information about testing headlessly</a></li>
+<li><a href="cli.html#_testresults">9.3.6. TestResults</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_license.html#sec:License">Appendix A: License</a></li>
+<li><a href="appendix_b_acronyms.html#sec:Acronyms">Appendix B: Acronyms</a></li>
+<li><a href="appendix_c_bibliography.html#_bibliography">Appendix C: Bibliography</a></li>
+</ul>
+</div>
+</div>
+<div id="content"><div class="sect1">
+<h2 id="_bug-management"><a class="anchor" href="#_bug-management"></a><a class="link" href="#_bug-management">8. Bug Management</a></h2>
+<div class="sectionbody">
+<div class="admonitionblock warning">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-warning" title=""></i>
+</td>
+<td class="content">
+Parts of this document may be outdated.
+</td>
+</tr>
+</table>
+</div>
+<div class="sect2">
+<h3 id="sec:Built_In_Xpect_Support"><a class="anchor" href="#sec:Built_In_Xpect_Support"></a><a class="link" href="#sec:Built_In_Xpect_Support">8.1. Built-In Xpect Support</a></h3>
+<div class="paragraph">
+<p>N4IDE contains built-in support for <a href="http://www.xpect-tests.org/">xpect</a> based tests. The purpose of those is to create tests for N4IDE support for user code, not the user code itself. Users can create <em>fileName.n4js.xt</em> to write their test for a given N4IDE functionality. Those files can be executed (via context menu, run configurations, etc.) to verify user expectations.</p>
+</div>
+<div class="sect3">
+<h4 id="sec:Report_View"><a class="anchor" href="#sec:Report_View"></a><a class="link" href="#sec:Report_View">8.1.1. Report View</a></h4>
+<div class="paragraph">
+<p>When executing xpect tests, users can view the results in a special view available in the IDE: <kbd>Window</kbd> &#8594; <kbd>Show View</kbd> &#8594; <kbd>Other</kbd>  &#8594; <kbd>Test Views</kbd> &#8594; <kbd>Xpect View</kbd>.</p>
+</div>
+<div id="fig:test_view" class="imageblock center" style="text-align: center">
+<div class="content">
+<img src="chapters/11_bugmanagement/fig/testView.png" alt="testView" width="75%">
+</div>
+<div class="title">Figure 14. Test View</div>
+</div>
+<div class="paragraph">
+<p>This view allows user to generate bug report (see <a href="#sec:Generate_Bug_Report">Generating Bug Reports</a>).</p>
+</div>
+<div class="paragraph">
+<p>In case of failing tests, users can see additional information (e.g. a stacktrace), or call a comparison view.</p>
+</div>
+<div id="fig:comparison" class="imageblock center" style="text-align: center">
+<div class="content">
+<img src="chapters/11_bugmanagement/fig/comparison.png" alt="comparison" width="75%">
+</div>
+<div class="title">Figure 15. Comparison</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Generate_Bug_Report"><a class="anchor" href="#sec:Generate_Bug_Report"></a><a class="link" href="#sec:Generate_Bug_Report">8.1.2. Generate Bug Report</a></h4>
+<div class="paragraph">
+<p>Generating bug reports can be done when there is some <code>.n4js.xt</code> file with all passing expectations, and at least one of them marked with <em>FIXME</em>. In this case icon of the executed test suite changes and via context menu user can call generate bug report option. When it is done, user can see contents of the bug generated in the console view. This output is prepared for out JIRA ticketing system.</p>
+</div>
+<div id="fig:bug_report" class="imageblock center" style="text-align: center">
+<div class="content">
+<img src="chapters/11_bugmanagement/fig/bugReport.png" alt="bugReport" width="75%">
+</div>
+<div class="title">Figure 16. Bug Report</div>
+</div>
+<div class="paragraph">
+<p>There is also possibility to generate bug report via file selection and context menu. In this case xpect test is not executed, only bug contents are generated.</p>
+</div>
+<div id="fig:bug" class="imageblock center" style="text-align: center">
+<div class="content">
+<img src="chapters/11_bugmanagement/fig/bug.png" alt="bug" width="50%">
+</div>
+<div class="title">Figure 17. Submited Bug</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Supported_Xpect_Tests"><a class="anchor" href="#sec:Supported_Xpect_Tests"></a><a class="link" href="#sec:Supported_Xpect_Tests">8.1.3. Supported Xpect Tests</a></h4>
+<div class="paragraph">
+<p>Xpect methods are special form of comments inside <em>.xt</em> files. General syntax for declaring usage of such method is <em>XPECT</em> marker followed by <em>XpectMethodName</em> and parameters for that method, all placed in comment. This can have three forms:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Single line comment (see the first comment in the listing below), Notice <strong><code>&#8594;</code></strong> separating the method name and its parameters.</p>
+</li>
+<li>
+<p>Multi line comment with one method invocation, notice <strong><code>-</code></strong> separating the method name and its parameters</p>
+</li>
+<li>
+<p>Multi line comment with multiple method invocations, simmilar to one above, but each line of method parameters indicates separate method invocation</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">//XPECT errors --&gt; "Couldn't resolve reference to IdentifiableElement 'consoleX'." at "consoleX"
+consoleX.log(10);
+
+/*XPECT errors ---
+ "Couldn't resolve reference to IdentifiableElement 'logY'." at "logY"
+---*/
+console.logY(10);
+
+/*XPECT errors ---
+ "Couldn't resolve reference to IdentifiableElement 'log'." at "log"
+ "Couldn't resolve reference to IdentifiableElement 'ref'." at "ref"
+ --- */
+log(ref);</code></pre>
+</div>
+</div>
+</li>
+</ul>
+</div>
+<div class="sect4">
+<h5 id="sec:XPECT_N4JS_Errors"><a class="anchor" href="#sec:XPECT_N4JS_Errors"></a><a class="link" href="#sec:XPECT_N4JS_Errors">8.1.3.1. Errors, Warnings, Infos, Issues</a></h5>
+<div class="paragraph">
+<p><em>Errors</em>, <em>Warnings</em>, <em>Infos</em> are xpect methods that allow to capture marker of given severity. Additionally <em>Issues</em> allows to allow markers of all above severities.</p>
+</div>
+<div class="paragraph">
+<p>All of those methods can be used single invocations or as mutline invocations.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">//XPECT errors --&gt; "Couldn't resolve reference to IdentifiableElement 'x'." at "x"
+console.log(x)
+
+//XPECT warnings --&gt; "Variable names should start with lower case letter." at "String"
+var String = "some string"</code></pre>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:XPECT_N4JS_Noerrors"><a class="anchor" href="#sec:XPECT_N4JS_Noerrors"></a><a class="link" href="#sec:XPECT_N4JS_Noerrors">8.1.3.2. Noerrors</a></h5>
+<div class="paragraph">
+<p>No errors allows to catch (and suppress) marker of any severity (<em>error</em>, <em>warning</em>, <em>info</em>).</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">//XPECT noerrors --&gt; "window object should be recognized"
+console.log(window)</code></pre>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:XPECT_N4JS_Output"><a class="anchor" href="#sec:XPECT_N4JS_Output"></a><a class="link" href="#sec:XPECT_N4JS_Output">8.1.3.3. Output, OutputRegex</a></h5>
+<div class="paragraph">
+<p>Output methods are special in sense that they are not intended to be used on single element of the script, but they apply to the whole script.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">/* XPECT output ---
+&lt;==
+stdout:
+hello world
+stderr:
+==&gt;
+--- */
+console.log("hello world")</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Second method accepts regex expressions. This allows to deal with troublesome output (e.g. dates)</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">/* XPECT outputRegex ---
+&lt;==
+stdout:
+[^\n]*
+stderr:
+==&gt;
+--- */
+console.log(new Date())</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">/* XPECT outputRegex ---
+&lt;==
+stdout:
+hello world
+stderr:
+
+[^\n]+
+throw ' cruel world'
+\^
+ cruel world
+==&gt;
+--- */
+console.log("hello world")
+throw ' cruel world'</code></pre>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:XPECT_N4JS_Type_Of"><a class="anchor" href="#sec:XPECT_N4JS_Type_Of"></a><a class="link" href="#sec:XPECT_N4JS_Type_Of">8.1.3.4. Type Of</a></h5>
+<div class="paragraph">
+<p>Xpect type methods allow test type inference, both for inferred type or expected type.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">//XPECT type of 'probablySomeString' --&gt; string
+var probablySomeString = "some string";
+
+var union{string,number} u;
+// XPECT expectedType at 'null' --&gt; {function(number?):string}
+u.toString = null</code></pre>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:XPECT_Advanced_Methods"><a class="anchor" href="#sec:XPECT_Advanced_Methods"></a><a class="link" href="#sec:XPECT_Advanced_Methods">8.1.3.5. Advanced methods</a></h5>
+<div class="paragraph">
+<p>There are also other methods provided, that allow to test quick fixes and content assist. Their parameters syntax is more complicated. Additionally they actively modify contents of the editor, or even close it if needed. Their usage exceeds scope of this document.</p>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div id="footer">
+<div id="footer-text">
+Version 0.9<br>
+Last updated 2019-08-07 15:02:40 CEST
+</div>
+</div>
+<!-- ************* docinfo-footer *************************************************************** -->
+<div class="Grid social" style="color:#d5dfea">
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <h2>Quick Links</h2>
+    <ul>
+      <li><a href="../downloads.html">Download</a></li>
+      <li><a href="../userguides/index.html">Documentation</a></li>
+      <li><a href="https://github.com/eclipse/n4js/">Source</a></li>
+      <li><a href="https://github.com/eclipse/n4js/issues">Issues</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="https://www.eclipse.org/forums/index.php/f/365/">Forum</a></li>
+      <li><a href="http://n4js.blogspot.de/">Blog</a></li>
+      <li><a href="https://dev.eclipse.org/mailman/listinfo/n4js-dev">Mailing List</a></li>
+      <li><a href="https://projects.eclipse.org/projects/technology.n4js">Eclipse Project Page</a></li>
+      <li><a href="https://twitter.com/n4jsdev">Tweets by n4jsdev</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="http://www.eclipse.org/">Eclipse Home</a></li>
+      <li><a href="http://www.eclipse.org/legal/privacy.php">Privacy Policy</a></li>
+      <li><a href="http://www.eclipse.org/legal/termsofuse.php">Terms of Use</a></li>
+      <li><a href="http://www.eclipse.org/legal/copyright.php">Copyright Agent</a></li>
+      <li><a href="http://www.eclipse.org/legal/">Legal</a></li>
+    </ul>
+  </div>
+  <div style="clear: both; height: 0; overflow: hidden;"></div>
+</div>
+
+<!-- ************* UI Scripts ************* -->
+<script type="text/javascript" src="scripts/back-to-top.js"></script>
+
+<script type="text/javascript" src="scripts/treeview.js"></script>
+<script type="text/javascript" src="scripts/toc.js"></script>
+
+<!-- ************* Prism.js Syntax Highlighting ************* -->
+<script src="scripts/prism.js"></script>
+
+<script type="text/javascript">
+	// Add the 'toclist' id for search function
+	$(".toc2 > ul").attr('id', 'toclist');
+	// Generate a Search input form
+	$("#toclist > li:first-of-type").before('<input type="text" id="pagesearch" onkeyup="search()" placeholder="Search for section...">');
+	$("#toclist > li:first-of-type").before('<i id="clear" class="fa fa-times-circle-o"></i>');
+	$("#clear").click(function(){
+	    $("#pagesearch").val('');
+	    search();
+	    $('.toc2 > ul').treeView('collapseAll');
+	});
+	// intialize Treeview.js
+	$(".toc2 > ul").treeView();
+	// Initialize Scrollspy
+</script>
+<!-- ************* docinfo-footer *************************************************************** -->
+</body>
+</html>
\ No newline at end of file
diff --git a/idespec/chapters/04_navigation/fig/activate_working_set_managers.png b/idespec/chapters/04_navigation/fig/activate_working_set_managers.png
new file mode 100644
index 0000000..0a64b0e
--- /dev/null
+++ b/idespec/chapters/04_navigation/fig/activate_working_set_managers.png
Binary files differ
diff --git a/idespec/chapters/04_navigation/fig/configure_working_sets_01.png b/idespec/chapters/04_navigation/fig/configure_working_sets_01.png
new file mode 100644
index 0000000..f90bc4b
--- /dev/null
+++ b/idespec/chapters/04_navigation/fig/configure_working_sets_01.png
Binary files differ
diff --git a/idespec/chapters/04_navigation/fig/select_working_set_manager_01.png b/idespec/chapters/04_navigation/fig/select_working_set_manager_01.png
new file mode 100644
index 0000000..948bf38
--- /dev/null
+++ b/idespec/chapters/04_navigation/fig/select_working_set_manager_01.png
Binary files differ
diff --git a/idespec/chapters/04_navigation/fig/select_working_set_manager_02.png b/idespec/chapters/04_navigation/fig/select_working_set_manager_02.png
new file mode 100644
index 0000000..fa4a625
--- /dev/null
+++ b/idespec/chapters/04_navigation/fig/select_working_set_manager_02.png
Binary files differ
diff --git a/idespec/chapters/04_navigation/fig/working_set_hide.png b/idespec/chapters/04_navigation/fig/working_set_hide.png
new file mode 100644
index 0000000..9631e59
--- /dev/null
+++ b/idespec/chapters/04_navigation/fig/working_set_hide.png
Binary files differ
diff --git a/idespec/chapters/04_navigation/fig/working_set_project_association.png b/idespec/chapters/04_navigation/fig/working_set_project_association.png
new file mode 100644
index 0000000..7176325
--- /dev/null
+++ b/idespec/chapters/04_navigation/fig/working_set_project_association.png
Binary files differ
diff --git a/idespec/chapters/04_navigation/fig/working_set_reorder.png b/idespec/chapters/04_navigation/fig/working_set_reorder.png
new file mode 100644
index 0000000..d69430b
--- /dev/null
+++ b/idespec/chapters/04_navigation/fig/working_set_reorder.png
Binary files differ
diff --git a/idespec/chapters/04_navigation/fig/working_set_show.png b/idespec/chapters/04_navigation/fig/working_set_show.png
new file mode 100644
index 0000000..caf7624
--- /dev/null
+++ b/idespec/chapters/04_navigation/fig/working_set_show.png
Binary files differ
diff --git a/idespec/chapters/04_navigation/fig/working_sets_in_navigator.png b/idespec/chapters/04_navigation/fig/working_sets_in_navigator.png
new file mode 100644
index 0000000..22b3a2a
--- /dev/null
+++ b/idespec/chapters/04_navigation/fig/working_sets_in_navigator.png
Binary files differ
diff --git a/idespec/chapters/06_wizards/fig/newclasswizard.png b/idespec/chapters/06_wizards/fig/newclasswizard.png
new file mode 100644
index 0000000..033f525
--- /dev/null
+++ b/idespec/chapters/06_wizards/fig/newclasswizard.png
Binary files differ
diff --git a/idespec/chapters/06_wizards/fig/newinterfacewizard.png b/idespec/chapters/06_wizards/fig/newinterfacewizard.png
new file mode 100644
index 0000000..b4d0823
--- /dev/null
+++ b/idespec/chapters/06_wizards/fig/newinterfacewizard.png
Binary files differ
diff --git a/idespec/chapters/09_testsupport/fig/cd_testsupport.png b/idespec/chapters/09_testsupport/fig/cd_testsupport.png
new file mode 100644
index 0000000..b8655b9
--- /dev/null
+++ b/idespec/chapters/09_testsupport/fig/cd_testsupport.png
Binary files differ
diff --git a/idespec/chapters/09_testsupport/fig/sm_TestListener.png b/idespec/chapters/09_testsupport/fig/sm_TestListener.png
new file mode 100644
index 0000000..b3fe24f
--- /dev/null
+++ b/idespec/chapters/09_testsupport/fig/sm_TestListener.png
Binary files differ
diff --git a/idespec/chapters/09_testsupport/fig/test_runner_components.png b/idespec/chapters/09_testsupport/fig/test_runner_components.png
new file mode 100644
index 0000000..db106e0
--- /dev/null
+++ b/idespec/chapters/09_testsupport/fig/test_runner_components.png
Binary files differ
diff --git a/idespec/chapters/09_testsupport/fig/xUnitDesign.png b/idespec/chapters/09_testsupport/fig/xUnitDesign.png
new file mode 100644
index 0000000..80ed72f
--- /dev/null
+++ b/idespec/chapters/09_testsupport/fig/xUnitDesign.png
Binary files differ
diff --git a/idespec/chapters/09_testsupport/fig/xUnitSupportDesign.png b/idespec/chapters/09_testsupport/fig/xUnitSupportDesign.png
new file mode 100644
index 0000000..d50cc40
--- /dev/null
+++ b/idespec/chapters/09_testsupport/fig/xUnitSupportDesign.png
Binary files differ
diff --git a/idespec/chapters/11_bugmanagement/fig/bug.png b/idespec/chapters/11_bugmanagement/fig/bug.png
new file mode 100644
index 0000000..3e40454
--- /dev/null
+++ b/idespec/chapters/11_bugmanagement/fig/bug.png
Binary files differ
diff --git a/idespec/chapters/11_bugmanagement/fig/bugReport.png b/idespec/chapters/11_bugmanagement/fig/bugReport.png
new file mode 100644
index 0000000..3d85e12
--- /dev/null
+++ b/idespec/chapters/11_bugmanagement/fig/bugReport.png
Binary files differ
diff --git a/idespec/chapters/11_bugmanagement/fig/comparison.png b/idespec/chapters/11_bugmanagement/fig/comparison.png
new file mode 100644
index 0000000..3267079
--- /dev/null
+++ b/idespec/chapters/11_bugmanagement/fig/comparison.png
Binary files differ
diff --git a/idespec/chapters/11_bugmanagement/fig/testView.png b/idespec/chapters/11_bugmanagement/fig/testView.png
new file mode 100644
index 0000000..f00ab7d
--- /dev/null
+++ b/idespec/chapters/11_bugmanagement/fig/testView.png
Binary files differ
diff --git a/idespec/cli.html b/idespec/cli.html
new file mode 100644
index 0000000..113b0dc
--- /dev/null
+++ b/idespec/cli.html
@@ -0,0 +1,721 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="generator" content="Asciidoctor 1.5.5">
+<meta name="author" content="2019-08-07 15:02:40 CEST">
+<title>N4JS IDE Specification</title>
+<link rel="stylesheet" href="styles/spec.min.css">
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.6.3/css/font-awesome.min.css">
+<!-- ************* docinfo ******************************************************************* -->
+
+
+<!-- ************* Favicon ************-->
+<link rel="icon" href="images/favicon.ico" />
+
+<!-- ************* Back-to-top JQuery ************* -->
+<script src="https://code.jquery.com/jquery-1.12.4.js"></script>
+<script src="https://code.jquery.com/ui/1.12.0/jquery-ui.js"></script>
+
+
+<link href="styles/prism.min.css" rel="stylesheet" />
+<script type="text/javascript" async
+  src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2/MathJax.js?config=TeX-MML-AM_CHTML">
+</script>
+
+<!-- ************* Styles ************* -->
+<link rel="stylesheet" type="text/css" href="styles/n4jsspec-adoc.css">
+
+
+<!-- ****************** NavBar ****************** -->
+<div id="menubar">
+	<div class="banner">
+        <a href="https://www.eclipse.org/n4js/#"><img id="logo" src="images/n4js-logo.png" alt="Eclipse N4JS"></a>
+    </div>
+<ul>
+  <li><a href="index.html">Index</a></li>
+</ul>
+</div>
+<!-- ************* docinfo ******************************************************************* -->
+<style>
+      .admonitionblock td.icon .icon-todo:before{content:"\f249";color:#f4ee42}
+    </style>
+</head>
+<body class="book toc2 toc-left">
+<div id="header">
+<h1>N4JS IDE Specification</h1>
+<div class="details">
+<span id="author" class="author">2019-08-07 15:02:40 CEST</span><br>
+<span id="revnumber">version 0.9</span>
+</div>
+<div id="toc" class="toc2">
+<div id="toctitle">Table of Contents</div>
+<ul class="sectlevel1">
+<li><a href="views.html#sec:Views">1. Views</a>
+<ul class="sectlevel2">
+<li><a href="views.html#_eclipse-standard-views">1.1. Eclipse Standard Views</a>
+<ul class="sectlevel3">
+<li><a href="views.html#sec:Project_Explorer_View">1.1.1. Project Explorer</a></li>
+<li><a href="views.html#sec:Outline_View">1.1.2. Outline</a></li>
+<li><a href="views.html#sec:Problems_View">1.1.3. Problems</a></li>
+<li><a href="views.html#sec:Console_View">1.1.4. Console</a></li>
+<li><a href="views.html#sec:History_View">1.1.5. History</a></li>
+<li><a href="views.html#sec:Error_Log_View">1.1.6. Error Log</a></li>
+</ul>
+</li>
+<li><a href="views.html#_n4js-specific-views">1.2. N4JS Specific Views</a>
+<ul class="sectlevel3">
+<li><a href="views.html#_test-results">1.2.1. Test Results</a></li>
+<li><a href="views.html#_source-graphs">1.2.2. Source Graphs</a></li>
+<li><a href="views.html#_api-compare">1.2.3. API Compare</a></li>
+<li><a href="views.html#_performance-graphs">1.2.4. Performance Graphs</a></li>
+<li><a href="views.html#_source-mapping">1.2.5. Source Mapping</a></li>
+<li><a href="views.html#_xpect-view">1.2.6. Xpect View</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="navigation.html#_navigation">2. Navigation</a>
+<ul class="sectlevel2">
+<li><a href="navigation.html#sec:Outline_Navigation">2.1. Outline</a>
+<ul class="sectlevel3">
+<li><a href="navigation.html#_quick-outline">2.1.1. Quick Outline</a></li>
+<li><a href="navigation.html#_normal-outline">2.1.2. Normal Outline</a></li>
+</ul>
+</li>
+<li><a href="navigation.html#_navigation-commands">2.2. Navigation Commands</a>
+<ul class="sectlevel3">
+<li><a href="navigation.html#sec:Navigate_to_Declaration">2.2.1. Navigate to Declaration</a></li>
+<li><a href="navigation.html#sec:find_by_references">2.2.2. Find by References</a></li>
+<li><a href="navigation.html#sec:Open_Type_Declaration">2.2.3. Open Type Declaration</a></li>
+</ul>
+</li>
+<li><a href="navigation.html#sec:Working_Sets">2.3. Working Sets</a>
+<ul class="sectlevel3">
+<li><a href="navigation.html#sec:Working_Set_Managers">2.3.1. Working Set Managers</a></li>
+<li><a href="navigation.html#sec:Working_Set_Constraints">2.3.2. Working Set Constraints</a></li>
+<li><a href="navigation.html#sec:Manual_Association_Working_Set_Manager_UI_Features">2.3.3. Manual Association Working Set Manager - UI Features</a></li>
+<li><a href="navigation.html#sec:Project_Name_Filter_Working_Set_Manager">2.3.4. Project Name Filter Working Set Manager</a></li>
+<li><a href="navigation.html#sec:Git_Repository_Working_Set_Manager">2.3.5. Git Repository Working Set Manager</a></li>
+<li><a href="navigation.html#sec:Project_Location_Working_Set_Manager">2.3.6. Project Location Working Set Manager</a></li>
+<li><a href="navigation.html#sec:N4JS_Project_Type_Working_Set_Manager">2.3.7. N4JS Project Type Working Set Manager</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="assistance.html#_assistance">3. Assistance</a>
+<ul class="sectlevel2">
+<li><a href="assistance.html#sec:Content_Assist">3.1. Content Assist</a>
+<ul class="sectlevel3">
+<li><a href="assistance.html#sec:Complete_Keywords">3.1.1. Complete Keywords</a></li>
+<li><a href="assistance.html#sec:Complete_Annotations">3.1.2. Complete Annotations</a></li>
+<li><a href="assistance.html#sec:Complete_Identifier_Reference">3.1.3. Complete Identifier Reference</a></li>
+<li><a href="assistance.html#sec:Complete_Member_Overrides">3.1.4. Complete Member Overrides</a></li>
+<li><a href="assistance.html#sec:Constructor_Completion">3.1.5. Constructor Completion</a></li>
+<li><a href="assistance.html#sec:Complete_Function_Expression">3.1.6. Complete Function Expression with Known Type</a></li>
+<li><a href="assistance.html#sec:Complete_Variable_and_Parameter_Names">3.1.7. Complete Variable and Parameter Names</a></li>
+</ul>
+</li>
+<li><a href="assistance.html#sec:Quick_Fixes">3.2. Quick Fixes</a>
+<ul class="sectlevel3">
+<li><a href="assistance.html#sec:N4JS_Issue_Properties">3.2.1. N4JS Issue User data</a></li>
+<li><a href="assistance.html#sec:N4JS_Issue_Fixes">3.2.2. N4JS Issue Fixes</a>
+<ul class="sectlevel4">
+<li><a href="assistance.html#sec:Linking_Issues">3.2.2.1. Linking Issues</a></li>
+<li><a href="assistance.html#sec:Import_Issues">3.2.2.2. Import Issues</a></li>
+<li><a href="assistance.html#sec:Visibility_Issues">3.2.2.3. Visibility Issues</a></li>
+<li><a href="assistance.html#sec:Classifier_Issues">3.2.2.4. Classifier Issues</a></li>
+<li><a href="assistance.html#sec:Function_Issues">3.2.2.5. Function Issues</a></li>
+<li><a href="assistance.html#sec:Syntax_Issues">3.2.2.6. Syntax Issues</a></li>
+<li><a href="assistance.html#sec:Conversion_Issues">3.2.2.7. Conversion Issues</a></li>
+<li><a href="assistance.html#sec:Type_Issues">3.2.2.8. Type Issues</a></li>
+<li><a href="assistance.html#sec:Expression_Issues">3.2.2.9. Expression Issues</a></li>
+<li><a href="assistance.html#sec:Super_Keyword_Issues">3.2.2.10. Super Keyword Issues</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="assistance.html#sec:Quick_Assist">3.3. Quick Assist</a></li>
+<li><a href="assistance.html#sec:Cleanup_Operations">3.4. Cleanup Operations</a>
+<ul class="sectlevel3">
+<li><a href="assistance.html#sec:Formatting">3.4.1. Formatting</a></li>
+<li><a href="assistance.html#sec:Organize_Imports">3.4.2. Organize Imports</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="wizards.html#_wizards">4. Wizards</a>
+<ul class="sectlevel2">
+<li><a href="wizards.html#sec:N4JS_Project_Wizard">4.1. N4JS Project Wizard</a></li>
+<li><a href="wizards.html#sec:Empty_N4JS_File">4.2. Empty N4JS File</a></li>
+<li><a href="wizards.html#sec:Empty_JS_File">4.3. Empty JS File</a>
+<ul class="sectlevel3">
+<li><a href="wizards.html#sec:N4JS_Class_File_Wizard">4.3.1. N4JS Class Wizard</a></li>
+<li><a href="wizards.html#field-properties">4.3.2. Field Properties</a></li>
+<li><a href="wizards.html#visibility-issues-or-final-super-classes">4.3.3. Visibility issues or <code>@Final</code> super classes</a></li>
+<li><a href="wizards.html#generation-1">4.3.4. Generation</a></li>
+<li><a href="wizards.html#preview-1">4.3.5. Preview</a></li>
+</ul>
+</li>
+<li><a href="wizards.html#sec:N4JS_Interface_Wizard">4.4. Interface Wizard</a>
+<ul class="sectlevel3">
+<li><a href="wizards.html#field-properties-1">4.4.1. Field Properties</a></li>
+<li><a href="wizards.html#visibility-issues">4.4.2. Visibility Issues</a></li>
+<li><a href="wizards.html#import-naming-conflicts">4.4.3. Import naming conflicts</a></li>
+<li><a href="wizards.html#generation-2">4.4.4. Generation</a></li>
+<li><a href="wizards.html#preview-2">4.4.5. Preview</a></li>
+</ul>
+</li>
+<li><a href="wizards.html#sec:N4JS_Enum_File_Wizard">4.5. Enum Wizard</a>
+<ul class="sectlevel3">
+<li><a href="wizards.html#field-properties-2">4.5.1. Field Properties</a></li>
+<li><a href="wizards.html#generation-3">4.5.2. Generation</a></li>
+<li><a href="wizards.html#preview-3">4.5.3. Preview</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="execution_support.html#_execution-support">5. Execution Support</a>
+<ul class="sectlevel2">
+<li><a href="execution_support.html#sec:Non_UI_Execution">5.1. Non-UI Execution</a>
+<ul class="sectlevel3">
+<li><a href="execution_support.html#sec:Non_UI_Debugging">5.1.1. Non-UI Debugging</a></li>
+</ul>
+</li>
+<li><a href="execution_support.html#sec:UI_Execution">5.2. UI Execution</a></li>
+</ul>
+</li>
+<li><a href="test_support.html#_test-support">6. Test Support</a>
+<ul class="sectlevel2">
+<li><a href="test_support.html#sec:N4JS_Mangelhaft_support">6.1. N4JS Mangelhaft support</a>
+<ul class="sectlevel3">
+<li><a href="test_support.html#sec:Asynchronous_Tests">6.1.1. Asynchronous Tests, Test Isolation and Timeouts</a></li>
+<li><a href="test_support.html#sec:Supported_xUnit_API">6.1.2. Supported xUnit API</a>
+<ul class="sectlevel4">
+<li><a href="test_support.html#sec:Test_Group">6.1.2.1. Test Group</a></li>
+<li><a href="test_support.html#sec:Test_Method">6.1.2.2. Test Method</a></li>
+<li><a href="test_support.html#sec:BeforeAll">6.1.2.3. BeforeAll Setup</a></li>
+<li><a href="test_support.html#sec:Before_Setup">6.1.2.4. Before Setup</a></li>
+<li><a href="test_support.html#sec:After_Teardown">6.1.2.5. After Teardown</a></li>
+<li><a href="test_support.html#sec:AfterAll_Teardown">6.1.2.6. AfterAll Teardown</a></li>
+<li><a href="test_support.html#sec:Test_Ignore">6.1.2.7. Test Ignore</a></li>
+<li><a href="test_support.html#sec:Timeout">6.1.2.8. Timeout</a></li>
+<li><a href="test_support.html#sec:Description">6.1.2.9. Description</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="test_support.html#sec:Test_Reporting">6.2. Test Reporting</a>
+<ul class="sectlevel3">
+<li><a href="test_support.html#sec:Test_Messages">6.2.1. Test Messages</a>
+<ul class="sectlevel4">
+<li><a href="test_support.html#_test-case-ids">6.2.1.1. Test Case IDs</a></li>
+<li><a href="test_support.html#sec:Start_Session">6.2.1.2. Start Session</a></li>
+<li><a href="test_support.html#sec:Ping_Session">6.2.1.3. Ping Session</a></li>
+<li><a href="test_support.html#sec:End_Session">6.2.1.4. End Session</a></li>
+<li><a href="test_support.html#sec:Start_Test">6.2.1.5. Start Test</a></li>
+<li><a href="test_support.html#sec:End_Test">6.2.1.6. End Test</a></li>
+<li><a href="test_support.html#sec:Ping_Test">6.2.1.7. Ping Test</a></li>
+<li><a href="test_support.html#sec:Test_Catalog">6.2.1.8. Test Catalog</a></li>
+<li><a href="test_support.html#sec:Test_Session_Example">6.2.1.9. Test Session Example</a></li>
+</ul>
+</li>
+<li><a href="test_support.html#sec:Test_Runtime_Configuration">6.2.2. Test Runtime Configuration</a></li>
+<li><a href="test_support.html#sec:Test_Plan">6.2.3. Test Plan</a></li>
+<li><a href="test_support.html#sec:Test_Environment_Configuration">6.2.4. Test Environment Configuration</a></li>
+<li><a href="test_support.html#sec:Test_Environment_Configuration_Example">6.2.5. Test Environment Configuration Example</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="help_system.html#_help-system">7. Help System</a>
+<ul class="sectlevel2">
+<li><a href="help_system.html#sec:Built_In_Help">7.1. Built-In Help</a></li>
+<li><a href="help_system.html#sec:Context_Sensitive_Help">7.2. Context Sensitive Help</a></li>
+<li><a href="help_system.html#sec:Cheat_Sheets">7.3. Cheat Sheets</a></li>
+<li><a href="help_system.html#sec:JSDoc">7.4. JSDoc</a></li>
+<li><a href="help_system.html#sec:Hovering">7.5. Hovering</a>
+<ul class="sectlevel3">
+<li><a href="help_system.html#sec:Show_Type_Information_of_Selection">7.5.1. Show Type Information of Selection</a></li>
+</ul>
+</li>
+<li><a href="help_system.html#sec:Example_Projects_and_Files">7.6. Example Projects and Files</a></li>
+</ul>
+</li>
+<li><a href="bug_management.html#_bug-management">8. Bug Management</a>
+<ul class="sectlevel2">
+<li><a href="bug_management.html#sec:Built_In_Xpect_Support">8.1. Built-In Xpect Support</a>
+<ul class="sectlevel3">
+<li><a href="bug_management.html#sec:Report_View">8.1.1. Report View</a></li>
+<li><a href="bug_management.html#sec:Generate_Bug_Report">8.1.2. Generate Bug Report</a></li>
+<li><a href="bug_management.html#sec:Supported_Xpect_Tests">8.1.3. Supported Xpect Tests</a>
+<ul class="sectlevel4">
+<li><a href="bug_management.html#sec:XPECT_N4JS_Errors">8.1.3.1. Errors, Warnings, Infos, Issues</a></li>
+<li><a href="bug_management.html#sec:XPECT_N4JS_Noerrors">8.1.3.2. Noerrors</a></li>
+<li><a href="bug_management.html#sec:XPECT_N4JS_Output">8.1.3.3. Output, OutputRegex</a></li>
+<li><a href="bug_management.html#sec:XPECT_N4JS_Type_Of">8.1.3.4. Type Of</a></li>
+<li><a href="bug_management.html#sec:XPECT_Advanced_Methods">8.1.3.5. Advanced methods</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#_cli">9. CLI</a>
+<ul class="sectlevel2">
+<li><a href="#sec:Headless_Compiler">9.1. Headless Compiler</a></li>
+<li><a href="#sec:Headless_Dependencies">9.2. Headless Dependnecies</a></li>
+<li><a href="#sec:Headless_Execution">9.3. Headless Execution</a>
+<ul class="sectlevel3">
+<li><a href="#sec:Cleaning_Headlessly">9.3.1. Cleaning Headlessly</a></li>
+<li><a href="#sec:Running_Headlessly">9.3.2. Running Headlessly</a></li>
+<li><a href="#sec:Information_about_running_headlessly">9.3.3. Information about running headlessly</a></li>
+<li><a href="#sec:Testing_Headlessly">9.3.4. Testing Headlessly</a></li>
+<li><a href="#sec:Information_about_testing_headlessly">9.3.5. Information about testing headlessly</a></li>
+<li><a href="#_testresults">9.3.6. TestResults</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_license.html#sec:License">Appendix A: License</a></li>
+<li><a href="appendix_b_acronyms.html#sec:Acronyms">Appendix B: Acronyms</a></li>
+<li><a href="appendix_c_bibliography.html#_bibliography">Appendix C: Bibliography</a></li>
+</ul>
+</div>
+</div>
+<div id="content"><div class="sect1">
+<h2 id="_cli"><a class="anchor" href="#_cli"></a><a class="link" href="#_cli">9. CLI</a></h2>
+<div class="sectionbody">
+<div class="admonitionblock warning">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-warning" title=""></i>
+</td>
+<td class="content">
+Parts of this document may be outdated.
+</td>
+</tr>
+</table>
+</div>
+<div class="sect2 language-bash">
+<h3 id="sec:Headless_Compiler"><a class="anchor" href="#sec:Headless_Compiler"></a><a class="link" href="#sec:Headless_Compiler">9.1. Headless Compiler</a></h3>
+<div class="paragraph">
+<p>The headless compiler is provided as a separate tool, coming as a single jar file <code>n4jsc.jar</code>. It is to be invoked via</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-bash" data-lang="bash">java -jar n4jsc.jar</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Simply invoking the headless compiler with no further arguments will print out a description of command line options.</p>
+</div>
+<div class="paragraph">
+<p>The headless compiler works in three major modes (given as arguments to the switch <code>-bt</code>):</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>compilation of single files (<code>-bt singlefile</code>, <em>default</em>),</p>
+</li>
+<li>
+<p>compilation of given projects (<code>-bt projects</code>) or</p>
+</li>
+<li>
+<p>compilation of all projects (<code>-bt allprojects</code>)</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>The command-line invocation usually has the form of</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-bash" data-lang="bash">java -jar n4jsc.jar  ^$[options]$^  file1 file2 ...</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Standard compiler <em>options</em>:</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><code>--buildType</code> , <code>-bt</code> <em>mode</em></dt>
+<dd>
+<p>With <em>mode</em> as exactly one of</p>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">singlefile</dt>
+<dd>
+<p>only the source files given by <em>file1</em>, <em>file2</em>, &#8230;&#8203; are compiled.</p>
+</dd>
+<dt class="hdlist1">projects</dt>
+<dd>
+<p><em>file1</em>, <em>file2</em>, &#8230;&#8203; denote projects (folders containing a <code>manifest.n4mf</code>). These projects will be compiled.</p>
+</dd>
+<dt class="hdlist1">allprojects</dt>
+<dd>
+<p>All project found under the project-root(s) are compiled. There should be no <em>file&#8230;&#8203;</em> given.</p>
+</dd>
+<dt class="hdlist1">dontcompile</dt>
+<dd>
+<p>Nothing will be compiled. There should be no <em>file&#8230;&#8203;</em> given. (This is the default if no <code>-t</code> option is given).</p>
+</dd>
+</dl>
+</div>
+</dd>
+<dt class="hdlist1"><code>--projectlocations</code> (<code>-pl</code>) <code>path</code></dt>
+<dd>
+<p><a id="opt-projectlocations"></a> provide folder(s) to search for projects. If not set, the base folder of the running JVM will be taken as the location. Multiple folders are separated by the systems path-separator (’<code>:</code>’ on Mac / Unix and ’<code>;</code>’ on Windows). Only direct subfolders will be queried for projects. A subfolder is assumed to be a N4JS-project if it contains a <code>manifest.n4mf</code> file. All found projects are taken into consideration for dependency-resolution. Example on Linux:<br>
+  <code>-pl  /rootA/: /rootB:/some/absolute/path/to/projects</code>.</p>
+</dd>
+</dl>
+</div>
+<div class="paragraph">
+<p>Advanced compiler options (optional):</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><code>--notests</code></dt>
+<dd>
+<p>turn off compilation of code in test-folders. Can not be combined with <code>–testonly</code></p>
+</dd>
+<dt class="hdlist1"><code>--testonly</code></dt>
+<dd>
+<p>only compile test code. Externals and sources will not be compiled. Can not be combined with <code>–notests</code></p>
+</dd>
+<dt class="hdlist1"><code>--keepCompiling</code></dt>
+<dd>
+<p>try to compile even if some errors occur.</p>
+</dd>
+<dt class="hdlist1"><code>--preference</code> <em>file</em></dt>
+<dd>
+<p>uses <em>file</em> as there internal preferences-store similar to the preferences internally stored by the N4IDE.</p>
+</dd>
+</dl>
+</div>
+<div class="paragraph">
+<p>Additional command line options (optional):</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><code>--help</code> , <code>-h</code> </dt>
+<dd>
+<p>prints out help to the console and exits.</p>
+</dd>
+<dt class="hdlist1"><code>--verbose</code> , <code>-v</code></dt>
+<dd>
+<p>verbose output during build</p>
+</dd>
+<dt class="hdlist1"><code>--debug</code> </dt>
+<dd>
+<p>before executing, summarises the information of the current setup like resolved pathnames and other information, carries on with normal workflow and prints additional status information about loading and unloading projects and processing each resource.</p>
+</dd>
+<dt class="hdlist1"><code>--log</code></dt>
+<dd>
+<p>write a log file <code>n4jsc.log</code> to the base folder. (Change filename with <code>–logfile filename</code>)</p>
+</dd>
+</dl>
+</div>
+</div>
+<div class="sect2 language-bash">
+<h3 id="sec:Headless_Dependencies"><a class="anchor" href="#sec:Headless_Dependencies"></a><a class="link" href="#sec:Headless_Dependencies">9.2. Headless Dependnecies</a></h3>
+<div class="paragraph">
+<p>Compiler can manage dependencies of the processed projects:</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><code>--installMissingDependencies</code> , <code>-imd</code> </dt>
+<dd>
+<p>alnalyzes available projects and installs missing dependencies</p>
+</dd>
+<dt class="hdlist1"><code>--targetPlatformInstallLocation</code> , <code>-tl</code></dt>
+<dd>
+<p>location to which dependencies will be installed, if not provided temporal location will be used</p>
+</dd>
+<dt class="hdlist1"><code>--npmrcRootLocation</code></dt>
+<dd>
+<p>location of the <em>.npmrc</em> file to be used in <em>npm</em> invocations</p>
+</dd>
+</dl>
+</div>
+</div>
+<div class="sect2 language-bash">
+<h3 id="sec:Headless_Execution"><a class="anchor" href="#sec:Headless_Execution"></a><a class="link" href="#sec:Headless_Execution">9.3. Headless Execution</a></h3>
+<div class="paragraph">
+<p>For headless compiling, running and testing of N4JS code a general command line tool is provided. Many parameters of the different use cases are shared. Although you can combine the use cases each of them is described in its own section. This section is about running compiled code.</p>
+</div>
+<div class="paragraph">
+<p>For compiling refer to <a href="#sec:Headless_Compiler">Headless Compiler</a> for executing tests refer to <a href="#_test_support">Tests</a>.</p>
+</div>
+<div class="sect3">
+<h4 id="sec:Cleaning_Headlessly"><a class="anchor" href="#sec:Cleaning_Headlessly"></a><a class="link" href="#sec:Cleaning_Headlessly">9.3.1. Cleaning Headlessly</a></h4>
+<div class="paragraph">
+<p>It is possible to use the headless compiler to clean projects by using the following option</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><code>--clean</code> (<code>-c</code>)</dt>
+<dd>
+<p>When this option is used. The headless compiler only cleans projects without compilation. Moreover, the use of this option requires that the option <code>-t</code> must be specified and must be either <code>-t projects</code> or <code>-t allprojects</code>.</p>
+</dd>
+</dl>
+</div>
+<div class="paragraph">
+<p>For instance, <code>n4jsc --clean -t allprojects -pl path/to/project</code> or <code>n4jsc --clean -t projects project1 project2</code> are valid use while <code>n4jsc --clean -t singlefile file1 file2</code> is invalid.
+After the calling the command with <code>--clean (</code>-c`), the output folders of the specified projects (e.g. <code>src-gen</code> folders) are cleaned.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Running_Headlessly"><a class="anchor" href="#sec:Running_Headlessly"></a><a class="link" href="#sec:Running_Headlessly">9.3.2. Running Headlessly</a></h4>
+<div class="paragraph">
+<p>Running code from the command line requires basically three different pieces of information:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>The locations where projects, libraries and environments can be found must be given.</p>
+</li>
+<li>
+<p>The starting point of execution must be given by pointing to a module.</p>
+</li>
+<li>
+<p>Since there are multiple different project types, an adequate Runner has to be selected.</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>The follwing command line switches are used to provide this information:</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><code>--projectlocations</code> (<code>-pl</code>) <code>path</code></dt>
+<dd>
+<p>path of locations to search for projects (c.f. <a href="#sec:Headless_Compiler">Headless Compiler</a> ,<a href="#opt-projectlocations">Project Locations</a>)</p>
+</dd>
+<dt class="hdlist1"><code>--runWith</code> (<code>-rw</code>) <code>VAL</code></dt>
+<dd>
+<p>denotes the runner-id (as listed with --list-runners) or at least the last segment of it</p>
+</dd>
+<dt class="hdlist1"><code>--run</code> (<code>-r</code>) <code>FILE</code></dt>
+<dd>
+<p>source-module to run. Note you should point to the full location of the source file (*.n4js). The runner is <em>responsible to determine the compiled file</em>. It is not sufficient to give a project-relative path, it always needs to be a full path to the source file.</p>
+</dd>
+</dl>
+</div>
+<div class="paragraph">
+<p>It is possible to compile and run with a single CLI line. Compilation always precedes the execution. It the compilation fails the runner will not be started.</p>
+</div>
+<div class="paragraph">
+<p>To ease the usage of different runners it is allowed to provide the last segment(s) of the runner-id in a case-insensitive way, e.g. one can use the runner with id <code>org.eclipse.n4js.runner.nodejs.NODEJS</code> as follows:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-bash" data-lang="bash">.. --runWith org.eclipse.n4js.runner.nodejs.NODEJS ..</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>or in short</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-bash" data-lang="bash">.. --rw NODEJS ..</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>or even lower-cased with</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-bash" data-lang="bash">.. --rw nodejs ..</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Assume having a common workspace location ’wsp’ with a project ’P1’ containing the module ’A’. The following line shows how to run this code:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-bash" data-lang="bash">java -jar n4jsc.jar -pl wsp -rw nodejs -r wsp/P1/src/A.n4js</code></pre>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Information_about_running_headlessly"><a class="anchor" href="#sec:Information_about_running_headlessly"></a><a class="link" href="#sec:Information_about_running_headlessly">9.3.3. Information about running headlessly</a></h4>
+<div class="paragraph">
+<p>Available runner-ids can be actively queried:</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><code>--listRunners</code> (<code>-lr</code>)</dt>
+<dd>
+<p>prints out a list of all available command-line runners</p>
+</dd>
+</dl>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Testing_Headlessly"><a class="anchor" href="#sec:Testing_Headlessly"></a><a class="link" href="#sec:Testing_Headlessly">9.3.4. Testing Headlessly</a></h4>
+<div class="paragraph">
+<p>Testing code from the command line requires basically three different pieces of information:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>The locations where projects, libraries and environments can be found must be given.</p>
+</li>
+<li>
+<p>The starting point of test execution must be given by pointing to what is supposed to be tested (single file / whole project)/</p>
+</li>
+<li>
+<p>Since there are multiple different project types, an adequate Tester has to be selected.</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>The follwing command line switches are used to provide this information:</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><code>--projectlocations</code> (<code>-pl</code>) <code>path</code></dt>
+<dd>
+<p>path of locations to search for projects (c.f. <a href="#sec:Headless_Compiler">Headless Compiler</a> ,<a href="#opt-projectlocations">Project Locations</a>)</p>
+</dd>
+<dt class="hdlist1"><code>--testWith</code> (<code>-tw</code>) <code>VAL</code></dt>
+<dd>
+<p>denotes the tester-id (as listed with --list-testers) or at least the last segment of it</p>
+</dd>
+<dt class="hdlist1"><code>--test</code> (<code>-t</code>) <code>FILE</code></dt>
+<dd>
+<p>source-module to run. Note you should point to the full location of the project with tests, specific folder inside project with tests or the test source file (*.n4js). It is not sufficient to give a project-relative path, it always needs to be a full path to the source file.</p>
+</dd>
+</dl>
+</div>
+<div class="paragraph">
+<p>It is possible to compile and run with a single CLI line. Compilation always precedes the execution. It the compilation fails the tester will not be started.</p>
+</div>
+<div class="paragraph">
+<p>To ease the usage of different testers it is allowed to provide the last segment(s) of the tester-id in a case-insensitive way, e.g. one can use the runner with id <code>org.eclipse.n4js.tester.nodejs.NODEJS_MANGELHAFT</code> as follows:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-bash" data-lang="bash">.. --runWith org.eclipse.n4js.tester.nodejs.NODEJS_MANGELHAFT ..</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>or in short</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-bash" data-lang="bash">.. --rw NODEJS_MANGELHAFT ..</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>or even lower-cased with</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-bash" data-lang="bash">.. --rw nodejs_mangelhaft ..</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Assume having a common workspace location ’wsp’ with a project ’P1’ containing the module ’TestA’. The following line shows how to execute this test code:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-bash" data-lang="bash">java -jar n4jsc.jar -pl wsp -tw nodejs_mangelhaft -t wsp/P1/src/TestA.n4js</code></pre>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Information_about_testing_headlessly"><a class="anchor" href="#sec:Information_about_testing_headlessly"></a><a class="link" href="#sec:Information_about_testing_headlessly">9.3.5. Information about testing headlessly</a></h4>
+<div class="paragraph">
+<p>Available tester-ids can be actively queried:</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><code>--listTesters</code> (<code>-lt</code>)</dt>
+<dd>
+<p>prints out a list of all available command-line testers</p>
+</dd>
+</dl>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_testresults"><a class="anchor" href="#_testresults"></a><a class="link" href="#_testresults">9.3.6. TestResults</a></h4>
+<div class="paragraph">
+<p>TODO</p>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div id="footer">
+<div id="footer-text">
+Version 0.9<br>
+Last updated 2019-08-07 15:02:40 CEST
+</div>
+</div>
+<!-- ************* docinfo-footer *************************************************************** -->
+<div class="Grid social" style="color:#d5dfea">
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <h2>Quick Links</h2>
+    <ul>
+      <li><a href="../downloads.html">Download</a></li>
+      <li><a href="../userguides/index.html">Documentation</a></li>
+      <li><a href="https://github.com/eclipse/n4js/">Source</a></li>
+      <li><a href="https://github.com/eclipse/n4js/issues">Issues</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="https://www.eclipse.org/forums/index.php/f/365/">Forum</a></li>
+      <li><a href="http://n4js.blogspot.de/">Blog</a></li>
+      <li><a href="https://dev.eclipse.org/mailman/listinfo/n4js-dev">Mailing List</a></li>
+      <li><a href="https://projects.eclipse.org/projects/technology.n4js">Eclipse Project Page</a></li>
+      <li><a href="https://twitter.com/n4jsdev">Tweets by n4jsdev</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="http://www.eclipse.org/">Eclipse Home</a></li>
+      <li><a href="http://www.eclipse.org/legal/privacy.php">Privacy Policy</a></li>
+      <li><a href="http://www.eclipse.org/legal/termsofuse.php">Terms of Use</a></li>
+      <li><a href="http://www.eclipse.org/legal/copyright.php">Copyright Agent</a></li>
+      <li><a href="http://www.eclipse.org/legal/">Legal</a></li>
+    </ul>
+  </div>
+  <div style="clear: both; height: 0; overflow: hidden;"></div>
+</div>
+
+<!-- ************* UI Scripts ************* -->
+<script type="text/javascript" src="scripts/back-to-top.js"></script>
+
+<script type="text/javascript" src="scripts/treeview.js"></script>
+<script type="text/javascript" src="scripts/toc.js"></script>
+
+<!-- ************* Prism.js Syntax Highlighting ************* -->
+<script src="scripts/prism.js"></script>
+
+<script type="text/javascript">
+	// Add the 'toclist' id for search function
+	$(".toc2 > ul").attr('id', 'toclist');
+	// Generate a Search input form
+	$("#toclist > li:first-of-type").before('<input type="text" id="pagesearch" onkeyup="search()" placeholder="Search for section...">');
+	$("#toclist > li:first-of-type").before('<i id="clear" class="fa fa-times-circle-o"></i>');
+	$("#clear").click(function(){
+	    $("#pagesearch").val('');
+	    search();
+	    $('.toc2 > ul').treeView('collapseAll');
+	});
+	// intialize Treeview.js
+	$(".toc2 > ul").treeView();
+	// Initialize Scrollspy
+</script>
+<!-- ************* docinfo-footer *************************************************************** -->
+</body>
+</html>
\ No newline at end of file
diff --git a/idespec/execution_support.html b/idespec/execution_support.html
new file mode 100644
index 0000000..47ef512
--- /dev/null
+++ b/idespec/execution_support.html
@@ -0,0 +1,434 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="generator" content="Asciidoctor 1.5.5">
+<meta name="author" content="2019-08-07 15:02:40 CEST">
+<title>N4JS IDE Specification</title>
+<link rel="stylesheet" href="styles/spec.min.css">
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.6.3/css/font-awesome.min.css">
+<!-- ************* docinfo ******************************************************************* -->
+
+
+<!-- ************* Favicon ************-->
+<link rel="icon" href="images/favicon.ico" />
+
+<!-- ************* Back-to-top JQuery ************* -->
+<script src="https://code.jquery.com/jquery-1.12.4.js"></script>
+<script src="https://code.jquery.com/ui/1.12.0/jquery-ui.js"></script>
+
+
+<link href="styles/prism.min.css" rel="stylesheet" />
+<script type="text/javascript" async
+  src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2/MathJax.js?config=TeX-MML-AM_CHTML">
+</script>
+
+<!-- ************* Styles ************* -->
+<link rel="stylesheet" type="text/css" href="styles/n4jsspec-adoc.css">
+
+
+<!-- ****************** NavBar ****************** -->
+<div id="menubar">
+	<div class="banner">
+        <a href="https://www.eclipse.org/n4js/#"><img id="logo" src="images/n4js-logo.png" alt="Eclipse N4JS"></a>
+    </div>
+<ul>
+  <li><a href="index.html">Index</a></li>
+</ul>
+</div>
+<!-- ************* docinfo ******************************************************************* -->
+<style>
+      .admonitionblock td.icon .icon-todo:before{content:"\f249";color:#f4ee42}
+    </style>
+</head>
+<body class="book toc2 toc-left">
+<div id="header">
+<h1>N4JS IDE Specification</h1>
+<div class="details">
+<span id="author" class="author">2019-08-07 15:02:40 CEST</span><br>
+<span id="revnumber">version 0.9</span>
+</div>
+<div id="toc" class="toc2">
+<div id="toctitle">Table of Contents</div>
+<ul class="sectlevel1">
+<li><a href="views.html#sec:Views">1. Views</a>
+<ul class="sectlevel2">
+<li><a href="views.html#_eclipse-standard-views">1.1. Eclipse Standard Views</a>
+<ul class="sectlevel3">
+<li><a href="views.html#sec:Project_Explorer_View">1.1.1. Project Explorer</a></li>
+<li><a href="views.html#sec:Outline_View">1.1.2. Outline</a></li>
+<li><a href="views.html#sec:Problems_View">1.1.3. Problems</a></li>
+<li><a href="views.html#sec:Console_View">1.1.4. Console</a></li>
+<li><a href="views.html#sec:History_View">1.1.5. History</a></li>
+<li><a href="views.html#sec:Error_Log_View">1.1.6. Error Log</a></li>
+</ul>
+</li>
+<li><a href="views.html#_n4js-specific-views">1.2. N4JS Specific Views</a>
+<ul class="sectlevel3">
+<li><a href="views.html#_test-results">1.2.1. Test Results</a></li>
+<li><a href="views.html#_source-graphs">1.2.2. Source Graphs</a></li>
+<li><a href="views.html#_api-compare">1.2.3. API Compare</a></li>
+<li><a href="views.html#_performance-graphs">1.2.4. Performance Graphs</a></li>
+<li><a href="views.html#_source-mapping">1.2.5. Source Mapping</a></li>
+<li><a href="views.html#_xpect-view">1.2.6. Xpect View</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="navigation.html#_navigation">2. Navigation</a>
+<ul class="sectlevel2">
+<li><a href="navigation.html#sec:Outline_Navigation">2.1. Outline</a>
+<ul class="sectlevel3">
+<li><a href="navigation.html#_quick-outline">2.1.1. Quick Outline</a></li>
+<li><a href="navigation.html#_normal-outline">2.1.2. Normal Outline</a></li>
+</ul>
+</li>
+<li><a href="navigation.html#_navigation-commands">2.2. Navigation Commands</a>
+<ul class="sectlevel3">
+<li><a href="navigation.html#sec:Navigate_to_Declaration">2.2.1. Navigate to Declaration</a></li>
+<li><a href="navigation.html#sec:find_by_references">2.2.2. Find by References</a></li>
+<li><a href="navigation.html#sec:Open_Type_Declaration">2.2.3. Open Type Declaration</a></li>
+</ul>
+</li>
+<li><a href="navigation.html#sec:Working_Sets">2.3. Working Sets</a>
+<ul class="sectlevel3">
+<li><a href="navigation.html#sec:Working_Set_Managers">2.3.1. Working Set Managers</a></li>
+<li><a href="navigation.html#sec:Working_Set_Constraints">2.3.2. Working Set Constraints</a></li>
+<li><a href="navigation.html#sec:Manual_Association_Working_Set_Manager_UI_Features">2.3.3. Manual Association Working Set Manager - UI Features</a></li>
+<li><a href="navigation.html#sec:Project_Name_Filter_Working_Set_Manager">2.3.4. Project Name Filter Working Set Manager</a></li>
+<li><a href="navigation.html#sec:Git_Repository_Working_Set_Manager">2.3.5. Git Repository Working Set Manager</a></li>
+<li><a href="navigation.html#sec:Project_Location_Working_Set_Manager">2.3.6. Project Location Working Set Manager</a></li>
+<li><a href="navigation.html#sec:N4JS_Project_Type_Working_Set_Manager">2.3.7. N4JS Project Type Working Set Manager</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="assistance.html#_assistance">3. Assistance</a>
+<ul class="sectlevel2">
+<li><a href="assistance.html#sec:Content_Assist">3.1. Content Assist</a>
+<ul class="sectlevel3">
+<li><a href="assistance.html#sec:Complete_Keywords">3.1.1. Complete Keywords</a></li>
+<li><a href="assistance.html#sec:Complete_Annotations">3.1.2. Complete Annotations</a></li>
+<li><a href="assistance.html#sec:Complete_Identifier_Reference">3.1.3. Complete Identifier Reference</a></li>
+<li><a href="assistance.html#sec:Complete_Member_Overrides">3.1.4. Complete Member Overrides</a></li>
+<li><a href="assistance.html#sec:Constructor_Completion">3.1.5. Constructor Completion</a></li>
+<li><a href="assistance.html#sec:Complete_Function_Expression">3.1.6. Complete Function Expression with Known Type</a></li>
+<li><a href="assistance.html#sec:Complete_Variable_and_Parameter_Names">3.1.7. Complete Variable and Parameter Names</a></li>
+</ul>
+</li>
+<li><a href="assistance.html#sec:Quick_Fixes">3.2. Quick Fixes</a>
+<ul class="sectlevel3">
+<li><a href="assistance.html#sec:N4JS_Issue_Properties">3.2.1. N4JS Issue User data</a></li>
+<li><a href="assistance.html#sec:N4JS_Issue_Fixes">3.2.2. N4JS Issue Fixes</a>
+<ul class="sectlevel4">
+<li><a href="assistance.html#sec:Linking_Issues">3.2.2.1. Linking Issues</a></li>
+<li><a href="assistance.html#sec:Import_Issues">3.2.2.2. Import Issues</a></li>
+<li><a href="assistance.html#sec:Visibility_Issues">3.2.2.3. Visibility Issues</a></li>
+<li><a href="assistance.html#sec:Classifier_Issues">3.2.2.4. Classifier Issues</a></li>
+<li><a href="assistance.html#sec:Function_Issues">3.2.2.5. Function Issues</a></li>
+<li><a href="assistance.html#sec:Syntax_Issues">3.2.2.6. Syntax Issues</a></li>
+<li><a href="assistance.html#sec:Conversion_Issues">3.2.2.7. Conversion Issues</a></li>
+<li><a href="assistance.html#sec:Type_Issues">3.2.2.8. Type Issues</a></li>
+<li><a href="assistance.html#sec:Expression_Issues">3.2.2.9. Expression Issues</a></li>
+<li><a href="assistance.html#sec:Super_Keyword_Issues">3.2.2.10. Super Keyword Issues</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="assistance.html#sec:Quick_Assist">3.3. Quick Assist</a></li>
+<li><a href="assistance.html#sec:Cleanup_Operations">3.4. Cleanup Operations</a>
+<ul class="sectlevel3">
+<li><a href="assistance.html#sec:Formatting">3.4.1. Formatting</a></li>
+<li><a href="assistance.html#sec:Organize_Imports">3.4.2. Organize Imports</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="wizards.html#_wizards">4. Wizards</a>
+<ul class="sectlevel2">
+<li><a href="wizards.html#sec:N4JS_Project_Wizard">4.1. N4JS Project Wizard</a></li>
+<li><a href="wizards.html#sec:Empty_N4JS_File">4.2. Empty N4JS File</a></li>
+<li><a href="wizards.html#sec:Empty_JS_File">4.3. Empty JS File</a>
+<ul class="sectlevel3">
+<li><a href="wizards.html#sec:N4JS_Class_File_Wizard">4.3.1. N4JS Class Wizard</a></li>
+<li><a href="wizards.html#field-properties">4.3.2. Field Properties</a></li>
+<li><a href="wizards.html#visibility-issues-or-final-super-classes">4.3.3. Visibility issues or <code>@Final</code> super classes</a></li>
+<li><a href="wizards.html#generation-1">4.3.4. Generation</a></li>
+<li><a href="wizards.html#preview-1">4.3.5. Preview</a></li>
+</ul>
+</li>
+<li><a href="wizards.html#sec:N4JS_Interface_Wizard">4.4. Interface Wizard</a>
+<ul class="sectlevel3">
+<li><a href="wizards.html#field-properties-1">4.4.1. Field Properties</a></li>
+<li><a href="wizards.html#visibility-issues">4.4.2. Visibility Issues</a></li>
+<li><a href="wizards.html#import-naming-conflicts">4.4.3. Import naming conflicts</a></li>
+<li><a href="wizards.html#generation-2">4.4.4. Generation</a></li>
+<li><a href="wizards.html#preview-2">4.4.5. Preview</a></li>
+</ul>
+</li>
+<li><a href="wizards.html#sec:N4JS_Enum_File_Wizard">4.5. Enum Wizard</a>
+<ul class="sectlevel3">
+<li><a href="wizards.html#field-properties-2">4.5.1. Field Properties</a></li>
+<li><a href="wizards.html#generation-3">4.5.2. Generation</a></li>
+<li><a href="wizards.html#preview-3">4.5.3. Preview</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#_execution-support">5. Execution Support</a>
+<ul class="sectlevel2">
+<li><a href="#sec:Non_UI_Execution">5.1. Non-UI Execution</a>
+<ul class="sectlevel3">
+<li><a href="#sec:Non_UI_Debugging">5.1.1. Non-UI Debugging</a></li>
+</ul>
+</li>
+<li><a href="#sec:UI_Execution">5.2. UI Execution</a></li>
+</ul>
+</li>
+<li><a href="test_support.html#_test-support">6. Test Support</a>
+<ul class="sectlevel2">
+<li><a href="test_support.html#sec:N4JS_Mangelhaft_support">6.1. N4JS Mangelhaft support</a>
+<ul class="sectlevel3">
+<li><a href="test_support.html#sec:Asynchronous_Tests">6.1.1. Asynchronous Tests, Test Isolation and Timeouts</a></li>
+<li><a href="test_support.html#sec:Supported_xUnit_API">6.1.2. Supported xUnit API</a>
+<ul class="sectlevel4">
+<li><a href="test_support.html#sec:Test_Group">6.1.2.1. Test Group</a></li>
+<li><a href="test_support.html#sec:Test_Method">6.1.2.2. Test Method</a></li>
+<li><a href="test_support.html#sec:BeforeAll">6.1.2.3. BeforeAll Setup</a></li>
+<li><a href="test_support.html#sec:Before_Setup">6.1.2.4. Before Setup</a></li>
+<li><a href="test_support.html#sec:After_Teardown">6.1.2.5. After Teardown</a></li>
+<li><a href="test_support.html#sec:AfterAll_Teardown">6.1.2.6. AfterAll Teardown</a></li>
+<li><a href="test_support.html#sec:Test_Ignore">6.1.2.7. Test Ignore</a></li>
+<li><a href="test_support.html#sec:Timeout">6.1.2.8. Timeout</a></li>
+<li><a href="test_support.html#sec:Description">6.1.2.9. Description</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="test_support.html#sec:Test_Reporting">6.2. Test Reporting</a>
+<ul class="sectlevel3">
+<li><a href="test_support.html#sec:Test_Messages">6.2.1. Test Messages</a>
+<ul class="sectlevel4">
+<li><a href="test_support.html#_test-case-ids">6.2.1.1. Test Case IDs</a></li>
+<li><a href="test_support.html#sec:Start_Session">6.2.1.2. Start Session</a></li>
+<li><a href="test_support.html#sec:Ping_Session">6.2.1.3. Ping Session</a></li>
+<li><a href="test_support.html#sec:End_Session">6.2.1.4. End Session</a></li>
+<li><a href="test_support.html#sec:Start_Test">6.2.1.5. Start Test</a></li>
+<li><a href="test_support.html#sec:End_Test">6.2.1.6. End Test</a></li>
+<li><a href="test_support.html#sec:Ping_Test">6.2.1.7. Ping Test</a></li>
+<li><a href="test_support.html#sec:Test_Catalog">6.2.1.8. Test Catalog</a></li>
+<li><a href="test_support.html#sec:Test_Session_Example">6.2.1.9. Test Session Example</a></li>
+</ul>
+</li>
+<li><a href="test_support.html#sec:Test_Runtime_Configuration">6.2.2. Test Runtime Configuration</a></li>
+<li><a href="test_support.html#sec:Test_Plan">6.2.3. Test Plan</a></li>
+<li><a href="test_support.html#sec:Test_Environment_Configuration">6.2.4. Test Environment Configuration</a></li>
+<li><a href="test_support.html#sec:Test_Environment_Configuration_Example">6.2.5. Test Environment Configuration Example</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="help_system.html#_help-system">7. Help System</a>
+<ul class="sectlevel2">
+<li><a href="help_system.html#sec:Built_In_Help">7.1. Built-In Help</a></li>
+<li><a href="help_system.html#sec:Context_Sensitive_Help">7.2. Context Sensitive Help</a></li>
+<li><a href="help_system.html#sec:Cheat_Sheets">7.3. Cheat Sheets</a></li>
+<li><a href="help_system.html#sec:JSDoc">7.4. JSDoc</a></li>
+<li><a href="help_system.html#sec:Hovering">7.5. Hovering</a>
+<ul class="sectlevel3">
+<li><a href="help_system.html#sec:Show_Type_Information_of_Selection">7.5.1. Show Type Information of Selection</a></li>
+</ul>
+</li>
+<li><a href="help_system.html#sec:Example_Projects_and_Files">7.6. Example Projects and Files</a></li>
+</ul>
+</li>
+<li><a href="bug_management.html#_bug-management">8. Bug Management</a>
+<ul class="sectlevel2">
+<li><a href="bug_management.html#sec:Built_In_Xpect_Support">8.1. Built-In Xpect Support</a>
+<ul class="sectlevel3">
+<li><a href="bug_management.html#sec:Report_View">8.1.1. Report View</a></li>
+<li><a href="bug_management.html#sec:Generate_Bug_Report">8.1.2. Generate Bug Report</a></li>
+<li><a href="bug_management.html#sec:Supported_Xpect_Tests">8.1.3. Supported Xpect Tests</a>
+<ul class="sectlevel4">
+<li><a href="bug_management.html#sec:XPECT_N4JS_Errors">8.1.3.1. Errors, Warnings, Infos, Issues</a></li>
+<li><a href="bug_management.html#sec:XPECT_N4JS_Noerrors">8.1.3.2. Noerrors</a></li>
+<li><a href="bug_management.html#sec:XPECT_N4JS_Output">8.1.3.3. Output, OutputRegex</a></li>
+<li><a href="bug_management.html#sec:XPECT_N4JS_Type_Of">8.1.3.4. Type Of</a></li>
+<li><a href="bug_management.html#sec:XPECT_Advanced_Methods">8.1.3.5. Advanced methods</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="cli.html#_cli">9. CLI</a>
+<ul class="sectlevel2">
+<li><a href="cli.html#sec:Headless_Compiler">9.1. Headless Compiler</a></li>
+<li><a href="cli.html#sec:Headless_Dependencies">9.2. Headless Dependnecies</a></li>
+<li><a href="cli.html#sec:Headless_Execution">9.3. Headless Execution</a>
+<ul class="sectlevel3">
+<li><a href="cli.html#sec:Cleaning_Headlessly">9.3.1. Cleaning Headlessly</a></li>
+<li><a href="cli.html#sec:Running_Headlessly">9.3.2. Running Headlessly</a></li>
+<li><a href="cli.html#sec:Information_about_running_headlessly">9.3.3. Information about running headlessly</a></li>
+<li><a href="cli.html#sec:Testing_Headlessly">9.3.4. Testing Headlessly</a></li>
+<li><a href="cli.html#sec:Information_about_testing_headlessly">9.3.5. Information about testing headlessly</a></li>
+<li><a href="cli.html#_testresults">9.3.6. TestResults</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_license.html#sec:License">Appendix A: License</a></li>
+<li><a href="appendix_b_acronyms.html#sec:Acronyms">Appendix B: Acronyms</a></li>
+<li><a href="appendix_c_bibliography.html#_bibliography">Appendix C: Bibliography</a></li>
+</ul>
+</div>
+</div>
+<div id="content"><div class="sect1">
+<h2 id="_execution-support"><a class="anchor" href="#_execution-support"></a><a class="link" href="#_execution-support">5. Execution Support</a></h2>
+<div class="sectionbody">
+<div class="admonitionblock warning">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-warning" title=""></i>
+</td>
+<td class="content">
+Parts of this document may be outdated.
+</td>
+</tr>
+</table>
+</div>
+<div class="sect2">
+<h3 id="sec:Non_UI_Execution"><a class="anchor" href="#sec:Non_UI_Execution"></a><a class="link" href="#sec:Non_UI_Execution">5.1. Non-UI Execution</a></h3>
+<div class="sect3">
+<h4 id="sec:Non_UI_Debugging"><a class="anchor" href="#sec:Non_UI_Debugging"></a><a class="link" href="#sec:Non_UI_Debugging">5.1.1. Non-UI Debugging</a></h4>
+<div class="paragraph">
+<p>not supported yet</p>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="sec:UI_Execution"><a class="anchor" href="#sec:UI_Execution"></a><a class="link" href="#sec:UI_Execution">5.2. UI Execution</a></h3>
+<div class="paragraph">
+<p>The N4JS IDE supports launching a file via a so called "runner". That is, a selected file is started as main
+file with Node.js or Chrome, depending on the available runners.</p>
+</div>
+<div class="admonitionblock warning">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-warning" title=""></i>
+</td>
+<td class="content">
+Chrome support not available yet.
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>For testing, a file, package, or even a whole project can be executed with a "tester". In that case, instead of directly executing the selected resource with Node.js (or other runners), the "mangelhaft" framework is used to run the selected resource or all its content as tests. For test support in general, see next chapter.</p>
+</div>
+<div class="paragraph">
+<p>Running or testing a resource is done via a launch configuration. This can be configured.</p>
+</div>
+<div class="paragraph">
+<p>The node.js runner/tester allows for configuration of</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>the NODE_MODULE path. This can be adjusted if the automatically path is not suited.</p>
+</li>
+<li>
+<p>other environment variables (simply as key=value pairs per line)</p>
+</li>
+<li>
+<p>node.js options to be passed as arguments to node.js</p>
+</li>
+<li>
+<p>the system loader to be used, this is "System.js" by default</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>
+Since in the JavaScript world these configurations are often used, it is cumbersome, particularly for tests, to define them for every single file. Thus the N4JS IDE copies the node.js settings found in a project launch configuration to a resource specific launch configuration.</p>
+</div>
+<div class="sidebarblock">
+<div class="content">
+<a href="https://github.com/eclipse/n4js/issues/716" class="gray" title="GitHub Issues"><span class="image"><img src="images/issue.svg" alt=""></span> #716</a>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div id="footer">
+<div id="footer-text">
+Version 0.9<br>
+Last updated 2019-08-07 15:02:40 CEST
+</div>
+</div>
+<!-- ************* docinfo-footer *************************************************************** -->
+<div class="Grid social" style="color:#d5dfea">
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <h2>Quick Links</h2>
+    <ul>
+      <li><a href="../downloads.html">Download</a></li>
+      <li><a href="../userguides/index.html">Documentation</a></li>
+      <li><a href="https://github.com/eclipse/n4js/">Source</a></li>
+      <li><a href="https://github.com/eclipse/n4js/issues">Issues</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="https://www.eclipse.org/forums/index.php/f/365/">Forum</a></li>
+      <li><a href="http://n4js.blogspot.de/">Blog</a></li>
+      <li><a href="https://dev.eclipse.org/mailman/listinfo/n4js-dev">Mailing List</a></li>
+      <li><a href="https://projects.eclipse.org/projects/technology.n4js">Eclipse Project Page</a></li>
+      <li><a href="https://twitter.com/n4jsdev">Tweets by n4jsdev</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="http://www.eclipse.org/">Eclipse Home</a></li>
+      <li><a href="http://www.eclipse.org/legal/privacy.php">Privacy Policy</a></li>
+      <li><a href="http://www.eclipse.org/legal/termsofuse.php">Terms of Use</a></li>
+      <li><a href="http://www.eclipse.org/legal/copyright.php">Copyright Agent</a></li>
+      <li><a href="http://www.eclipse.org/legal/">Legal</a></li>
+    </ul>
+  </div>
+  <div style="clear: both; height: 0; overflow: hidden;"></div>
+</div>
+
+<!-- ************* UI Scripts ************* -->
+<script type="text/javascript" src="scripts/back-to-top.js"></script>
+
+<script type="text/javascript" src="scripts/treeview.js"></script>
+<script type="text/javascript" src="scripts/toc.js"></script>
+
+<!-- ************* Prism.js Syntax Highlighting ************* -->
+<script src="scripts/prism.js"></script>
+
+<script type="text/javascript">
+	// Add the 'toclist' id for search function
+	$(".toc2 > ul").attr('id', 'toclist');
+	// Generate a Search input form
+	$("#toclist > li:first-of-type").before('<input type="text" id="pagesearch" onkeyup="search()" placeholder="Search for section...">');
+	$("#toclist > li:first-of-type").before('<i id="clear" class="fa fa-times-circle-o"></i>');
+	$("#clear").click(function(){
+	    $("#pagesearch").val('');
+	    search();
+	    $('.toc2 > ul').treeView('collapseAll');
+	});
+	// intialize Treeview.js
+	$(".toc2 > ul").treeView();
+	// Initialize Scrollspy
+</script>
+<!-- ************* docinfo-footer *************************************************************** -->
+</body>
+</html>
\ No newline at end of file
diff --git a/idespec/help_system.html b/idespec/help_system.html
new file mode 100644
index 0000000..71095c3
--- /dev/null
+++ b/idespec/help_system.html
@@ -0,0 +1,392 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="generator" content="Asciidoctor 1.5.5">
+<meta name="author" content="2019-08-07 15:02:40 CEST">
+<title>N4JS IDE Specification</title>
+<link rel="stylesheet" href="styles/spec.min.css">
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.6.3/css/font-awesome.min.css">
+<!-- ************* docinfo ******************************************************************* -->
+
+
+<!-- ************* Favicon ************-->
+<link rel="icon" href="images/favicon.ico" />
+
+<!-- ************* Back-to-top JQuery ************* -->
+<script src="https://code.jquery.com/jquery-1.12.4.js"></script>
+<script src="https://code.jquery.com/ui/1.12.0/jquery-ui.js"></script>
+
+
+<link href="styles/prism.min.css" rel="stylesheet" />
+<script type="text/javascript" async
+  src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2/MathJax.js?config=TeX-MML-AM_CHTML">
+</script>
+
+<!-- ************* Styles ************* -->
+<link rel="stylesheet" type="text/css" href="styles/n4jsspec-adoc.css">
+
+
+<!-- ****************** NavBar ****************** -->
+<div id="menubar">
+	<div class="banner">
+        <a href="https://www.eclipse.org/n4js/#"><img id="logo" src="images/n4js-logo.png" alt="Eclipse N4JS"></a>
+    </div>
+<ul>
+  <li><a href="index.html">Index</a></li>
+</ul>
+</div>
+<!-- ************* docinfo ******************************************************************* -->
+<style>
+      .admonitionblock td.icon .icon-todo:before{content:"\f249";color:#f4ee42}
+    </style>
+</head>
+<body class="book toc2 toc-left">
+<div id="header">
+<h1>N4JS IDE Specification</h1>
+<div class="details">
+<span id="author" class="author">2019-08-07 15:02:40 CEST</span><br>
+<span id="revnumber">version 0.9</span>
+</div>
+<div id="toc" class="toc2">
+<div id="toctitle">Table of Contents</div>
+<ul class="sectlevel1">
+<li><a href="views.html#sec:Views">1. Views</a>
+<ul class="sectlevel2">
+<li><a href="views.html#_eclipse-standard-views">1.1. Eclipse Standard Views</a>
+<ul class="sectlevel3">
+<li><a href="views.html#sec:Project_Explorer_View">1.1.1. Project Explorer</a></li>
+<li><a href="views.html#sec:Outline_View">1.1.2. Outline</a></li>
+<li><a href="views.html#sec:Problems_View">1.1.3. Problems</a></li>
+<li><a href="views.html#sec:Console_View">1.1.4. Console</a></li>
+<li><a href="views.html#sec:History_View">1.1.5. History</a></li>
+<li><a href="views.html#sec:Error_Log_View">1.1.6. Error Log</a></li>
+</ul>
+</li>
+<li><a href="views.html#_n4js-specific-views">1.2. N4JS Specific Views</a>
+<ul class="sectlevel3">
+<li><a href="views.html#_test-results">1.2.1. Test Results</a></li>
+<li><a href="views.html#_source-graphs">1.2.2. Source Graphs</a></li>
+<li><a href="views.html#_api-compare">1.2.3. API Compare</a></li>
+<li><a href="views.html#_performance-graphs">1.2.4. Performance Graphs</a></li>
+<li><a href="views.html#_source-mapping">1.2.5. Source Mapping</a></li>
+<li><a href="views.html#_xpect-view">1.2.6. Xpect View</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="navigation.html#_navigation">2. Navigation</a>
+<ul class="sectlevel2">
+<li><a href="navigation.html#sec:Outline_Navigation">2.1. Outline</a>
+<ul class="sectlevel3">
+<li><a href="navigation.html#_quick-outline">2.1.1. Quick Outline</a></li>
+<li><a href="navigation.html#_normal-outline">2.1.2. Normal Outline</a></li>
+</ul>
+</li>
+<li><a href="navigation.html#_navigation-commands">2.2. Navigation Commands</a>
+<ul class="sectlevel3">
+<li><a href="navigation.html#sec:Navigate_to_Declaration">2.2.1. Navigate to Declaration</a></li>
+<li><a href="navigation.html#sec:find_by_references">2.2.2. Find by References</a></li>
+<li><a href="navigation.html#sec:Open_Type_Declaration">2.2.3. Open Type Declaration</a></li>
+</ul>
+</li>
+<li><a href="navigation.html#sec:Working_Sets">2.3. Working Sets</a>
+<ul class="sectlevel3">
+<li><a href="navigation.html#sec:Working_Set_Managers">2.3.1. Working Set Managers</a></li>
+<li><a href="navigation.html#sec:Working_Set_Constraints">2.3.2. Working Set Constraints</a></li>
+<li><a href="navigation.html#sec:Manual_Association_Working_Set_Manager_UI_Features">2.3.3. Manual Association Working Set Manager - UI Features</a></li>
+<li><a href="navigation.html#sec:Project_Name_Filter_Working_Set_Manager">2.3.4. Project Name Filter Working Set Manager</a></li>
+<li><a href="navigation.html#sec:Git_Repository_Working_Set_Manager">2.3.5. Git Repository Working Set Manager</a></li>
+<li><a href="navigation.html#sec:Project_Location_Working_Set_Manager">2.3.6. Project Location Working Set Manager</a></li>
+<li><a href="navigation.html#sec:N4JS_Project_Type_Working_Set_Manager">2.3.7. N4JS Project Type Working Set Manager</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="assistance.html#_assistance">3. Assistance</a>
+<ul class="sectlevel2">
+<li><a href="assistance.html#sec:Content_Assist">3.1. Content Assist</a>
+<ul class="sectlevel3">
+<li><a href="assistance.html#sec:Complete_Keywords">3.1.1. Complete Keywords</a></li>
+<li><a href="assistance.html#sec:Complete_Annotations">3.1.2. Complete Annotations</a></li>
+<li><a href="assistance.html#sec:Complete_Identifier_Reference">3.1.3. Complete Identifier Reference</a></li>
+<li><a href="assistance.html#sec:Complete_Member_Overrides">3.1.4. Complete Member Overrides</a></li>
+<li><a href="assistance.html#sec:Constructor_Completion">3.1.5. Constructor Completion</a></li>
+<li><a href="assistance.html#sec:Complete_Function_Expression">3.1.6. Complete Function Expression with Known Type</a></li>
+<li><a href="assistance.html#sec:Complete_Variable_and_Parameter_Names">3.1.7. Complete Variable and Parameter Names</a></li>
+</ul>
+</li>
+<li><a href="assistance.html#sec:Quick_Fixes">3.2. Quick Fixes</a>
+<ul class="sectlevel3">
+<li><a href="assistance.html#sec:N4JS_Issue_Properties">3.2.1. N4JS Issue User data</a></li>
+<li><a href="assistance.html#sec:N4JS_Issue_Fixes">3.2.2. N4JS Issue Fixes</a>
+<ul class="sectlevel4">
+<li><a href="assistance.html#sec:Linking_Issues">3.2.2.1. Linking Issues</a></li>
+<li><a href="assistance.html#sec:Import_Issues">3.2.2.2. Import Issues</a></li>
+<li><a href="assistance.html#sec:Visibility_Issues">3.2.2.3. Visibility Issues</a></li>
+<li><a href="assistance.html#sec:Classifier_Issues">3.2.2.4. Classifier Issues</a></li>
+<li><a href="assistance.html#sec:Function_Issues">3.2.2.5. Function Issues</a></li>
+<li><a href="assistance.html#sec:Syntax_Issues">3.2.2.6. Syntax Issues</a></li>
+<li><a href="assistance.html#sec:Conversion_Issues">3.2.2.7. Conversion Issues</a></li>
+<li><a href="assistance.html#sec:Type_Issues">3.2.2.8. Type Issues</a></li>
+<li><a href="assistance.html#sec:Expression_Issues">3.2.2.9. Expression Issues</a></li>
+<li><a href="assistance.html#sec:Super_Keyword_Issues">3.2.2.10. Super Keyword Issues</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="assistance.html#sec:Quick_Assist">3.3. Quick Assist</a></li>
+<li><a href="assistance.html#sec:Cleanup_Operations">3.4. Cleanup Operations</a>
+<ul class="sectlevel3">
+<li><a href="assistance.html#sec:Formatting">3.4.1. Formatting</a></li>
+<li><a href="assistance.html#sec:Organize_Imports">3.4.2. Organize Imports</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="wizards.html#_wizards">4. Wizards</a>
+<ul class="sectlevel2">
+<li><a href="wizards.html#sec:N4JS_Project_Wizard">4.1. N4JS Project Wizard</a></li>
+<li><a href="wizards.html#sec:Empty_N4JS_File">4.2. Empty N4JS File</a></li>
+<li><a href="wizards.html#sec:Empty_JS_File">4.3. Empty JS File</a>
+<ul class="sectlevel3">
+<li><a href="wizards.html#sec:N4JS_Class_File_Wizard">4.3.1. N4JS Class Wizard</a></li>
+<li><a href="wizards.html#field-properties">4.3.2. Field Properties</a></li>
+<li><a href="wizards.html#visibility-issues-or-final-super-classes">4.3.3. Visibility issues or <code>@Final</code> super classes</a></li>
+<li><a href="wizards.html#generation-1">4.3.4. Generation</a></li>
+<li><a href="wizards.html#preview-1">4.3.5. Preview</a></li>
+</ul>
+</li>
+<li><a href="wizards.html#sec:N4JS_Interface_Wizard">4.4. Interface Wizard</a>
+<ul class="sectlevel3">
+<li><a href="wizards.html#field-properties-1">4.4.1. Field Properties</a></li>
+<li><a href="wizards.html#visibility-issues">4.4.2. Visibility Issues</a></li>
+<li><a href="wizards.html#import-naming-conflicts">4.4.3. Import naming conflicts</a></li>
+<li><a href="wizards.html#generation-2">4.4.4. Generation</a></li>
+<li><a href="wizards.html#preview-2">4.4.5. Preview</a></li>
+</ul>
+</li>
+<li><a href="wizards.html#sec:N4JS_Enum_File_Wizard">4.5. Enum Wizard</a>
+<ul class="sectlevel3">
+<li><a href="wizards.html#field-properties-2">4.5.1. Field Properties</a></li>
+<li><a href="wizards.html#generation-3">4.5.2. Generation</a></li>
+<li><a href="wizards.html#preview-3">4.5.3. Preview</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="execution_support.html#_execution-support">5. Execution Support</a>
+<ul class="sectlevel2">
+<li><a href="execution_support.html#sec:Non_UI_Execution">5.1. Non-UI Execution</a>
+<ul class="sectlevel3">
+<li><a href="execution_support.html#sec:Non_UI_Debugging">5.1.1. Non-UI Debugging</a></li>
+</ul>
+</li>
+<li><a href="execution_support.html#sec:UI_Execution">5.2. UI Execution</a></li>
+</ul>
+</li>
+<li><a href="test_support.html#_test-support">6. Test Support</a>
+<ul class="sectlevel2">
+<li><a href="test_support.html#sec:N4JS_Mangelhaft_support">6.1. N4JS Mangelhaft support</a>
+<ul class="sectlevel3">
+<li><a href="test_support.html#sec:Asynchronous_Tests">6.1.1. Asynchronous Tests, Test Isolation and Timeouts</a></li>
+<li><a href="test_support.html#sec:Supported_xUnit_API">6.1.2. Supported xUnit API</a>
+<ul class="sectlevel4">
+<li><a href="test_support.html#sec:Test_Group">6.1.2.1. Test Group</a></li>
+<li><a href="test_support.html#sec:Test_Method">6.1.2.2. Test Method</a></li>
+<li><a href="test_support.html#sec:BeforeAll">6.1.2.3. BeforeAll Setup</a></li>
+<li><a href="test_support.html#sec:Before_Setup">6.1.2.4. Before Setup</a></li>
+<li><a href="test_support.html#sec:After_Teardown">6.1.2.5. After Teardown</a></li>
+<li><a href="test_support.html#sec:AfterAll_Teardown">6.1.2.6. AfterAll Teardown</a></li>
+<li><a href="test_support.html#sec:Test_Ignore">6.1.2.7. Test Ignore</a></li>
+<li><a href="test_support.html#sec:Timeout">6.1.2.8. Timeout</a></li>
+<li><a href="test_support.html#sec:Description">6.1.2.9. Description</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="test_support.html#sec:Test_Reporting">6.2. Test Reporting</a>
+<ul class="sectlevel3">
+<li><a href="test_support.html#sec:Test_Messages">6.2.1. Test Messages</a>
+<ul class="sectlevel4">
+<li><a href="test_support.html#_test-case-ids">6.2.1.1. Test Case IDs</a></li>
+<li><a href="test_support.html#sec:Start_Session">6.2.1.2. Start Session</a></li>
+<li><a href="test_support.html#sec:Ping_Session">6.2.1.3. Ping Session</a></li>
+<li><a href="test_support.html#sec:End_Session">6.2.1.4. End Session</a></li>
+<li><a href="test_support.html#sec:Start_Test">6.2.1.5. Start Test</a></li>
+<li><a href="test_support.html#sec:End_Test">6.2.1.6. End Test</a></li>
+<li><a href="test_support.html#sec:Ping_Test">6.2.1.7. Ping Test</a></li>
+<li><a href="test_support.html#sec:Test_Catalog">6.2.1.8. Test Catalog</a></li>
+<li><a href="test_support.html#sec:Test_Session_Example">6.2.1.9. Test Session Example</a></li>
+</ul>
+</li>
+<li><a href="test_support.html#sec:Test_Runtime_Configuration">6.2.2. Test Runtime Configuration</a></li>
+<li><a href="test_support.html#sec:Test_Plan">6.2.3. Test Plan</a></li>
+<li><a href="test_support.html#sec:Test_Environment_Configuration">6.2.4. Test Environment Configuration</a></li>
+<li><a href="test_support.html#sec:Test_Environment_Configuration_Example">6.2.5. Test Environment Configuration Example</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#_help-system">7. Help System</a>
+<ul class="sectlevel2">
+<li><a href="#sec:Built_In_Help">7.1. Built-In Help</a></li>
+<li><a href="#sec:Context_Sensitive_Help">7.2. Context Sensitive Help</a></li>
+<li><a href="#sec:Cheat_Sheets">7.3. Cheat Sheets</a></li>
+<li><a href="#sec:JSDoc">7.4. JSDoc</a></li>
+<li><a href="#sec:Hovering">7.5. Hovering</a>
+<ul class="sectlevel3">
+<li><a href="#sec:Show_Type_Information_of_Selection">7.5.1. Show Type Information of Selection</a></li>
+</ul>
+</li>
+<li><a href="#sec:Example_Projects_and_Files">7.6. Example Projects and Files</a></li>
+</ul>
+</li>
+<li><a href="bug_management.html#_bug-management">8. Bug Management</a>
+<ul class="sectlevel2">
+<li><a href="bug_management.html#sec:Built_In_Xpect_Support">8.1. Built-In Xpect Support</a>
+<ul class="sectlevel3">
+<li><a href="bug_management.html#sec:Report_View">8.1.1. Report View</a></li>
+<li><a href="bug_management.html#sec:Generate_Bug_Report">8.1.2. Generate Bug Report</a></li>
+<li><a href="bug_management.html#sec:Supported_Xpect_Tests">8.1.3. Supported Xpect Tests</a>
+<ul class="sectlevel4">
+<li><a href="bug_management.html#sec:XPECT_N4JS_Errors">8.1.3.1. Errors, Warnings, Infos, Issues</a></li>
+<li><a href="bug_management.html#sec:XPECT_N4JS_Noerrors">8.1.3.2. Noerrors</a></li>
+<li><a href="bug_management.html#sec:XPECT_N4JS_Output">8.1.3.3. Output, OutputRegex</a></li>
+<li><a href="bug_management.html#sec:XPECT_N4JS_Type_Of">8.1.3.4. Type Of</a></li>
+<li><a href="bug_management.html#sec:XPECT_Advanced_Methods">8.1.3.5. Advanced methods</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="cli.html#_cli">9. CLI</a>
+<ul class="sectlevel2">
+<li><a href="cli.html#sec:Headless_Compiler">9.1. Headless Compiler</a></li>
+<li><a href="cli.html#sec:Headless_Dependencies">9.2. Headless Dependnecies</a></li>
+<li><a href="cli.html#sec:Headless_Execution">9.3. Headless Execution</a>
+<ul class="sectlevel3">
+<li><a href="cli.html#sec:Cleaning_Headlessly">9.3.1. Cleaning Headlessly</a></li>
+<li><a href="cli.html#sec:Running_Headlessly">9.3.2. Running Headlessly</a></li>
+<li><a href="cli.html#sec:Information_about_running_headlessly">9.3.3. Information about running headlessly</a></li>
+<li><a href="cli.html#sec:Testing_Headlessly">9.3.4. Testing Headlessly</a></li>
+<li><a href="cli.html#sec:Information_about_testing_headlessly">9.3.5. Information about testing headlessly</a></li>
+<li><a href="cli.html#_testresults">9.3.6. TestResults</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_license.html#sec:License">Appendix A: License</a></li>
+<li><a href="appendix_b_acronyms.html#sec:Acronyms">Appendix B: Acronyms</a></li>
+<li><a href="appendix_c_bibliography.html#_bibliography">Appendix C: Bibliography</a></li>
+</ul>
+</div>
+</div>
+<div id="content"><div class="sect1">
+<h2 id="_help-system"><a class="anchor" href="#_help-system"></a><a class="link" href="#_help-system">7. Help System</a></h2>
+<div class="sectionbody">
+<div class="sect2">
+<h3 id="sec:Built_In_Help"><a class="anchor" href="#sec:Built_In_Help"></a><a class="link" href="#sec:Built_In_Help">7.1. Built-In Help</a></h3>
+
+</div>
+<div class="sect2">
+<h3 id="sec:Context_Sensitive_Help"><a class="anchor" href="#sec:Context_Sensitive_Help"></a><a class="link" href="#sec:Context_Sensitive_Help">7.2. Context Sensitive Help</a></h3>
+
+</div>
+<div class="sect2">
+<h3 id="sec:Cheat_Sheets"><a class="anchor" href="#sec:Cheat_Sheets"></a><a class="link" href="#sec:Cheat_Sheets">7.3. Cheat Sheets</a></h3>
+
+</div>
+<div class="sect2">
+<h3 id="sec:JSDoc"><a class="anchor" href="#sec:JSDoc"></a><a class="link" href="#sec:JSDoc">7.4. JSDoc</a></h3>
+
+</div>
+<div class="sect2">
+<h3 id="sec:Hovering"><a class="anchor" href="#sec:Hovering"></a><a class="link" href="#sec:Hovering">7.5. Hovering</a></h3>
+<div class="paragraph">
+<p>Hovering over an element (such as type, field, method, function or variable declaration) in the N4JS editor will cause a tooltip appear containing information about the underlying element. Currently this information is the type (could be the inferred type as well), the name and the keyword (such as class, variable, field) of the actual element. By default the tooltip does not grab the focus from the currently active workbench window and will automatically disappear after the focus is lost from the element. One can grab the focus for the tooltip by clicking into the tooltip area or pressing <kbd>F2</kbd> function key.</p>
+</div>
+<div class="sect3">
+<h4 id="sec:Show_Type_Information_of_Selection"><a class="anchor" href="#sec:Show_Type_Information_of_Selection"></a><a class="link" href="#sec:Show_Type_Information_of_Selection">7.5.1. Show Type Information of Selection</a></h4>
+<div class="paragraph">
+<p>In some cases, during the development process, one would like to know what is the actual or even the inferred type of an N4JS expression. To use this functionality one can select the desired expression in the editor and invoke the ’Show Type Information’ command via the <kbd>Cmd</kbd> + <kbd>Option</kbd>+ <kbd>I</kbd> ( <kbd>Ctrl</kbd> + <kbd>Alt</kbd>+ <kbd>I</kbd> Windows/Linux) from the keyboard. This case a popup window will be raised containing the type information of the actual selection.</p>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="sec:Example_Projects_and_Files"><a class="anchor" href="#sec:Example_Projects_and_Files"></a><a class="link" href="#sec:Example_Projects_and_Files">7.6. Example Projects and Files</a></h3>
+
+</div>
+</div>
+</div>
+</div>
+<div id="footer">
+<div id="footer-text">
+Version 0.9<br>
+Last updated 2019-08-07 15:02:40 CEST
+</div>
+</div>
+<!-- ************* docinfo-footer *************************************************************** -->
+<div class="Grid social" style="color:#d5dfea">
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <h2>Quick Links</h2>
+    <ul>
+      <li><a href="../downloads.html">Download</a></li>
+      <li><a href="../userguides/index.html">Documentation</a></li>
+      <li><a href="https://github.com/eclipse/n4js/">Source</a></li>
+      <li><a href="https://github.com/eclipse/n4js/issues">Issues</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="https://www.eclipse.org/forums/index.php/f/365/">Forum</a></li>
+      <li><a href="http://n4js.blogspot.de/">Blog</a></li>
+      <li><a href="https://dev.eclipse.org/mailman/listinfo/n4js-dev">Mailing List</a></li>
+      <li><a href="https://projects.eclipse.org/projects/technology.n4js">Eclipse Project Page</a></li>
+      <li><a href="https://twitter.com/n4jsdev">Tweets by n4jsdev</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="http://www.eclipse.org/">Eclipse Home</a></li>
+      <li><a href="http://www.eclipse.org/legal/privacy.php">Privacy Policy</a></li>
+      <li><a href="http://www.eclipse.org/legal/termsofuse.php">Terms of Use</a></li>
+      <li><a href="http://www.eclipse.org/legal/copyright.php">Copyright Agent</a></li>
+      <li><a href="http://www.eclipse.org/legal/">Legal</a></li>
+    </ul>
+  </div>
+  <div style="clear: both; height: 0; overflow: hidden;"></div>
+</div>
+
+<!-- ************* UI Scripts ************* -->
+<script type="text/javascript" src="scripts/back-to-top.js"></script>
+
+<script type="text/javascript" src="scripts/treeview.js"></script>
+<script type="text/javascript" src="scripts/toc.js"></script>
+
+<!-- ************* Prism.js Syntax Highlighting ************* -->
+<script src="scripts/prism.js"></script>
+
+<script type="text/javascript">
+	// Add the 'toclist' id for search function
+	$(".toc2 > ul").attr('id', 'toclist');
+	// Generate a Search input form
+	$("#toclist > li:first-of-type").before('<input type="text" id="pagesearch" onkeyup="search()" placeholder="Search for section...">');
+	$("#toclist > li:first-of-type").before('<i id="clear" class="fa fa-times-circle-o"></i>');
+	$("#clear").click(function(){
+	    $("#pagesearch").val('');
+	    search();
+	    $('.toc2 > ul').treeView('collapseAll');
+	});
+	// intialize Treeview.js
+	$(".toc2 > ul").treeView();
+	// Initialize Scrollspy
+</script>
+<!-- ************* docinfo-footer *************************************************************** -->
+</body>
+</html>
\ No newline at end of file
diff --git a/idespec/images/arrow-down.png b/idespec/images/arrow-down.png
new file mode 100644
index 0000000..bd60af3
--- /dev/null
+++ b/idespec/images/arrow-down.png
Binary files differ
diff --git a/idespec/images/arrow-right.png b/idespec/images/arrow-right.png
new file mode 100644
index 0000000..220a9b9
--- /dev/null
+++ b/idespec/images/arrow-right.png
Binary files differ
diff --git a/idespec/images/collapse.png b/idespec/images/collapse.png
new file mode 100644
index 0000000..fe71915
--- /dev/null
+++ b/idespec/images/collapse.png
Binary files differ
diff --git a/idespec/images/cover.png b/idespec/images/cover.png
new file mode 100644
index 0000000..3999673
--- /dev/null
+++ b/idespec/images/cover.png
Binary files differ
diff --git a/idespec/images/expand.png b/idespec/images/expand.png
new file mode 100644
index 0000000..169e56e
--- /dev/null
+++ b/idespec/images/expand.png
Binary files differ
diff --git a/idespec/images/favicon-16x16.png b/idespec/images/favicon-16x16.png
new file mode 100644
index 0000000..d0078b3
--- /dev/null
+++ b/idespec/images/favicon-16x16.png
Binary files differ
diff --git a/idespec/images/favicon-32x32.png b/idespec/images/favicon-32x32.png
new file mode 100644
index 0000000..1149301
--- /dev/null
+++ b/idespec/images/favicon-32x32.png
Binary files differ
diff --git a/idespec/images/favicon.ico b/idespec/images/favicon.ico
new file mode 100644
index 0000000..13e30de
--- /dev/null
+++ b/idespec/images/favicon.ico
Binary files differ
diff --git a/idespec/images/issue.svg b/idespec/images/issue.svg
new file mode 100644
index 0000000..f1651d2
--- /dev/null
+++ b/idespec/images/issue.svg
@@ -0,0 +1,29 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:xl="http://www.w3.org/1999/xlink" version="1.1" xmlns="http://www.w3.org/2000/svg" viewBox="342 217 26 27" width="26" height="27">
+  <defs>
+    <font-face font-family="Helvetica Neue" font-size="21" panose-1="2 0 8 3 0 0 0 9 0 4" units-per-em="1000" underline-position="-100" underline-thickness="50" slope="0" x-height="517" cap-height="714" ascent="975.0061" descent="-216.99524" font-weight="700">
+      <font-face-src>
+        <font-face-name name="HelveticaNeue-Bold"/>
+      </font-face-src>
+    </font-face>
+  </defs>
+  <metadata> Produced by OmniGraffle 7.8.2 
+    <dc:date>2018-11-22 16:16:36 +0000</dc:date>
+  </metadata>
+  <g id="Canvas_1" fill-opacity="1" stroke-dasharray="none" stroke="none" stroke-opacity="1" fill="none">
+    <title>Canvas 1</title>
+    <g id="Canvas_1: Layer 1">
+      <title>Layer 1</title>
+      <g id="Graphic_4">
+        <circle cx="354.8125" cy="230.25" r="11.2500179763964" fill="white"/>
+        <circle cx="354.8125" cy="230.25" r="11.2500179763964" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="2"/>
+      </g>
+      <g id="Graphic_2">
+        <text transform="translate(351.8125 217.44543)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="21" font-weight="700" fill="black" x=".081" y="20">!</tspan>
+        </text>
+      </g>
+    </g>
+  </g>
+</svg>
diff --git a/idespec/images/n4js-logo.png b/idespec/images/n4js-logo.png
new file mode 100644
index 0000000..e0b8340
--- /dev/null
+++ b/idespec/images/n4js-logo.png
Binary files differ
diff --git a/idespec/images/n4jslogo.png b/idespec/images/n4jslogo.png
new file mode 100644
index 0000000..a8e2982
--- /dev/null
+++ b/idespec/images/n4jslogo.png
Binary files differ
diff --git a/idespec/images/n4jslogo.svg b/idespec/images/n4jslogo.svg
new file mode 100644
index 0000000..9f6f27f
--- /dev/null
+++ b/idespec/images/n4jslogo.svg
@@ -0,0 +1,30 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN"
+"http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+
+
+<!-- Page 1 -->
+<svg x="0" y="0" width="1527" height="1459" viewBox="0 0 1527 1459" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink"
+style="display: block;margin-left: auto;margin-right: auto;">
+<defs>
+<clipPath id="c0_1"><path d="M848.7,1459c-31.1,0,-48.1,-19.3,-48.1,-54.6c0,-2.7,0.6,-3.5,2.4,-3.5l26.6,0c2.1,0,2.9,1.1,2.9,3.7l0,3.5c0,14.3,5.8,22,16.7,22c5.6,0,10.3,-2.4,12.2,-6.6c2.4,-4.3,2.6,-7.2,2.6,-19.9L864,1298l-36.8,0c-4.5,0,-5.4,-0.8,-5.4,-5.6l0,-14.3c0,-4.8,0.9,-5.6,5.4,-5.6l66.9,0c4.7,0,5.5,0.8,5.5,5.6l0,120.4c0,23.4,-3.4,35.9,-12.2,45.7c-8.7,9.8,-22,14.8,-38.7,14.8Zm-367.9,-4.5c-5.1,0,-5.6,-0.5,-5.6,-5.6l0,-14.3c0,-4.8,0.8,-5.6,5.6,-5.6l13.5,0l0,-131l-13.5,0c-4.8,0,-5.6,-0.8,-5.6,-5.6l0,-14.3c0,-4.8,0.5,-5.6,5.6,-5.6l40.9,0c3.7,0,4.2,0.3,6.1,3.7l44,82.3c5.9,10.9,13.3,28.1,16.5,38.4c-0.8,-19.6,-0.8,-25.2,-0.8,-34.5l0,-64.4l-13.5,0c-4.8,0,-5.6,-0.8,-5.6,-5.6l0,-14.3c0,-4.8,0.8,-5.6,5.6,-5.6l57.3,0c5,0,5.6,0.8,5.6,5.6l0,14.3c0,4.8,-0.8,5.6,-5.6,5.6l-13.5,0l0,150.9c0,4.8,-0.8,5.6,-5.6,5.6l-17.5,0c-3.7,0,-4.3,-0.2,-6.1,-3.7l-48.9,-90.7c-8,-14.9,-11.4,-22.1,-16.2,-36.1c1.1,21.2,1.1,21.2,1.1,34.2l0,70.8l13.5,0c4.8,0,5.6,0.8,5.6,5.6l0,14.3c0,4.8,-0.8,5.6,-5.6,5.6Zm242.9,1.5c-5,0,-5.6,-0.5,-5.6,-5.3l0,-34.5l-65,0c-5,0,-5.6,-0.5,-5.6,-5.3l0,-27.9l66.1,-110.3c1.6,-2.7,2.4,-3.5,3.5,-3.5c0.8,0,1.9,0.3,3.7,1.1l16,6.6c2.9,1.3,3.9,2.1,3.9,3.7c0,0.8,-0.5,2.1,-1.6,3.7l-61.8,105.1l41.4,0l3.4,-42.7c0.3,-4.5,1.1,-5.1,5.6,-5.1l18.1,0c5,0,5.6,0.6,5.6,5.6l0,43l15.1,0c5,0,5.6,0.5,5.6,6.4l0,14.3c0,4.5,-0.9,5.3,-5.6,5.3l-15.1,0l0,34.5c0,4.8,-0.6,5.3,-5.6,5.3Zm266,2.2c-16.7,0,-39.6,-4.7,-50.7,-10.6c-3.2,-1.6,-4,-3.2,-4,-6.6l0,-40.1c0,-3.7,0.8,-4.5,4.5,-4.5l19.7,0c3.7,0,4.5,0.8,4.5,4.5l0,22.3c10.3,3.7,17.2,5.3,24.9,5.3c15.4,0,24.2,-8.2,24.2,-22.5c0,-6.4,-2.1,-12,-5.9,-15.7c-4.7,-4.8,-6.6,-5.8,-30.8,-17.2c-15.9,-7.7,-24.1,-12.8,-29.4,-18.3c-7.5,-7.7,-11.4,-19.2,-11.4,-32.7c0,-32.9,22.3,-53.3,58.1,-53.3c15.4,0,32.9,4.2,43.8,10.3c3.2,1.9,4,3.2,4,6.4l0,36.1c0,3.7,-0.8,4.5,-4.5,4.5l-19.7,0c-3.7,0,-4.5,-0.8,-4.5,-4.5l0,-20.7c-7.7,-2.4,-11.9,-3.2,-17.8,-3.2c-15.6,0,-24.9,7.4,-24.9,19.9c0,9.8,4.5,14.3,23.6,23.9c25.5,12.7,32.1,17,39,24.4c9.6,10.6,14.4,22.8,14.4,37.1c0,32.7,-23.1,55.2,-57.1,55.2ZM494.4,821.7c-13.5,0,-24.5,-10.9,-24.5,-24.4c0,-13.5,11,-24.4,24.5,-24.4l508,0c13.5,0,24.5,10.9,24.5,24.4c0,13.5,-11,24.4,-24.5,24.4ZM362,837.7c-11.6,0,-22.8,-5.8,-29.3,-16.3c-10,-16.2,-4.9,-37.3,11.2,-47.3c5.6,-3.4,11.9,-5.1,18,-5.1c11.6,0,22.8,5.8,29.3,16.4c10,16.1,4.9,37.3,-11.2,47.2c-5.7,3.5,-11.9,5.1,-18,5.1ZM494.4,662.9c-13.5,0,-24.5,-11,-24.5,-24.5c0,-13.5,11,-24.4,24.5,-24.4l631.9,0c13.5,0,24.4,10.9,24.4,24.4c0,13.5,-10.9,24.5,-24.4,24.5ZM492.4,504C478.9,504,468,493.1,468,479.6c0,-13.5,10.9,-24.5,24.4,-24.5l598.4,0c13.5,0,24.4,11,24.4,24.5c0,13.5,-10.9,24.4,-24.4,24.4Zm2,-158.8c-13.5,0,-24.5,-11,-24.5,-24.5c0,-13.5,11,-24.4,24.5,-24.4l422.3,0c13.5,0,24.4,10.9,24.4,24.4c0,13.5,-10.9,24.5,-24.4,24.5Zm941.7,751.5c23.6,0,42.8,-19.1,42.8,-42.7l0,-962.4c0,-23.6,-19.2,-42.7,-42.8,-42.7L91.7,48.9C68.1,48.9,48.9,68,48.9,91.6l0,962.4c0,23.6,19.1,42.7,42.8,42.7ZM91.7,1145.6C41,1145.6,0,1104.6,0,1054L0,91.6C0,41,41.1,0,91.7,0L1436.1,0c50.6,0,91.7,41,91.7,91.6l0,962.4c0,50.6,-41.1,91.6,-91.7,91.6Z" /></clipPath>
+
+<style type="text/css"><![CDATA[
+
+.g1_1{
+}
+
+
+]]></style>
+
+</defs>
+<path d="M0,0
+L0,1459
+L1527,1459
+L1527,0 Z " 
+fill="#FFFFFF" stroke="none" />
+<g clip-path="url(#c0_1)">
+<path d="M-7,-7l1542,0l0,1473L-7,1466Z" class="g1_1" />
+</g>
+
+</svg>
diff --git a/idespec/images/searchicon.png b/idespec/images/searchicon.png
new file mode 100644
index 0000000..71f06af
--- /dev/null
+++ b/idespec/images/searchicon.png
Binary files differ
diff --git a/idespec/images/up-arrow.png b/idespec/images/up-arrow.png
new file mode 100644
index 0000000..1ff179f
--- /dev/null
+++ b/idespec/images/up-arrow.png
Binary files differ
diff --git a/idespec/index.html b/idespec/index.html
new file mode 100644
index 0000000..19b089f
--- /dev/null
+++ b/idespec/index.html
@@ -0,0 +1,402 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="generator" content="Asciidoctor 1.5.5">
+<meta name="author" content="2019-08-07 15:02:40 CEST">
+<title>N4JS IDE Specification</title>
+<link rel="stylesheet" href="styles/spec.min.css">
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.6.3/css/font-awesome.min.css">
+<!-- ************* docinfo ******************************************************************* -->
+
+
+<!-- ************* Favicon ************-->
+<link rel="icon" href="images/favicon.ico" />
+
+<!-- ************* Back-to-top JQuery ************* -->
+<script src="https://code.jquery.com/jquery-1.12.4.js"></script>
+<script src="https://code.jquery.com/ui/1.12.0/jquery-ui.js"></script>
+
+
+<link href="styles/prism.min.css" rel="stylesheet" />
+<script type="text/javascript" async
+  src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2/MathJax.js?config=TeX-MML-AM_CHTML">
+</script>
+
+<!-- ************* Styles ************* -->
+<link rel="stylesheet" type="text/css" href="styles/n4jsspec-adoc.css">
+
+
+<!-- ****************** NavBar ****************** -->
+<div id="menubar">
+	<div class="banner">
+        <a href="https://www.eclipse.org/n4js/#"><img id="logo" src="images/n4js-logo.png" alt="Eclipse N4JS"></a>
+    </div>
+<ul>
+  <li><a href="index.html">Index</a></li>
+</ul>
+</div>
+<!-- ************* docinfo ******************************************************************* -->
+<style>
+      .admonitionblock td.icon .icon-todo:before{content:"\f249";color:#f4ee42}
+    </style>
+</head>
+<body class="book toc2 toc-left">
+<div id="header">
+<h1>N4JS IDE Specification</h1>
+<div class="details">
+<span id="author" class="author">2019-08-07 15:02:40 CEST</span><br>
+<span id="revnumber">version 0.9</span>
+</div>
+<div id="toc" class="toc2">
+<div id="toctitle">Table of Contents</div>
+<ul class="sectlevel1">
+<li><a href="views.html#sec:Views">1. Views</a>
+<ul class="sectlevel2">
+<li><a href="views.html#_eclipse-standard-views">1.1. Eclipse Standard Views</a>
+<ul class="sectlevel3">
+<li><a href="views.html#sec:Project_Explorer_View">1.1.1. Project Explorer</a></li>
+<li><a href="views.html#sec:Outline_View">1.1.2. Outline</a></li>
+<li><a href="views.html#sec:Problems_View">1.1.3. Problems</a></li>
+<li><a href="views.html#sec:Console_View">1.1.4. Console</a></li>
+<li><a href="views.html#sec:History_View">1.1.5. History</a></li>
+<li><a href="views.html#sec:Error_Log_View">1.1.6. Error Log</a></li>
+</ul>
+</li>
+<li><a href="views.html#_n4js-specific-views">1.2. N4JS Specific Views</a>
+<ul class="sectlevel3">
+<li><a href="views.html#_test-results">1.2.1. Test Results</a></li>
+<li><a href="views.html#_source-graphs">1.2.2. Source Graphs</a></li>
+<li><a href="views.html#_api-compare">1.2.3. API Compare</a></li>
+<li><a href="views.html#_performance-graphs">1.2.4. Performance Graphs</a></li>
+<li><a href="views.html#_source-mapping">1.2.5. Source Mapping</a></li>
+<li><a href="views.html#_xpect-view">1.2.6. Xpect View</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="navigation.html#_navigation">2. Navigation</a>
+<ul class="sectlevel2">
+<li><a href="navigation.html#sec:Outline_Navigation">2.1. Outline</a>
+<ul class="sectlevel3">
+<li><a href="navigation.html#_quick-outline">2.1.1. Quick Outline</a></li>
+<li><a href="navigation.html#_normal-outline">2.1.2. Normal Outline</a></li>
+</ul>
+</li>
+<li><a href="navigation.html#_navigation-commands">2.2. Navigation Commands</a>
+<ul class="sectlevel3">
+<li><a href="navigation.html#sec:Navigate_to_Declaration">2.2.1. Navigate to Declaration</a></li>
+<li><a href="navigation.html#sec:find_by_references">2.2.2. Find by References</a></li>
+<li><a href="navigation.html#sec:Open_Type_Declaration">2.2.3. Open Type Declaration</a></li>
+</ul>
+</li>
+<li><a href="navigation.html#sec:Working_Sets">2.3. Working Sets</a>
+<ul class="sectlevel3">
+<li><a href="navigation.html#sec:Working_Set_Managers">2.3.1. Working Set Managers</a></li>
+<li><a href="navigation.html#sec:Working_Set_Constraints">2.3.2. Working Set Constraints</a></li>
+<li><a href="navigation.html#sec:Manual_Association_Working_Set_Manager_UI_Features">2.3.3. Manual Association Working Set Manager - UI Features</a></li>
+<li><a href="navigation.html#sec:Project_Name_Filter_Working_Set_Manager">2.3.4. Project Name Filter Working Set Manager</a></li>
+<li><a href="navigation.html#sec:Git_Repository_Working_Set_Manager">2.3.5. Git Repository Working Set Manager</a></li>
+<li><a href="navigation.html#sec:Project_Location_Working_Set_Manager">2.3.6. Project Location Working Set Manager</a></li>
+<li><a href="navigation.html#sec:N4JS_Project_Type_Working_Set_Manager">2.3.7. N4JS Project Type Working Set Manager</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="assistance.html#_assistance">3. Assistance</a>
+<ul class="sectlevel2">
+<li><a href="assistance.html#sec:Content_Assist">3.1. Content Assist</a>
+<ul class="sectlevel3">
+<li><a href="assistance.html#sec:Complete_Keywords">3.1.1. Complete Keywords</a></li>
+<li><a href="assistance.html#sec:Complete_Annotations">3.1.2. Complete Annotations</a></li>
+<li><a href="assistance.html#sec:Complete_Identifier_Reference">3.1.3. Complete Identifier Reference</a></li>
+<li><a href="assistance.html#sec:Complete_Member_Overrides">3.1.4. Complete Member Overrides</a></li>
+<li><a href="assistance.html#sec:Constructor_Completion">3.1.5. Constructor Completion</a></li>
+<li><a href="assistance.html#sec:Complete_Function_Expression">3.1.6. Complete Function Expression with Known Type</a></li>
+<li><a href="assistance.html#sec:Complete_Variable_and_Parameter_Names">3.1.7. Complete Variable and Parameter Names</a></li>
+</ul>
+</li>
+<li><a href="assistance.html#sec:Quick_Fixes">3.2. Quick Fixes</a>
+<ul class="sectlevel3">
+<li><a href="assistance.html#sec:N4JS_Issue_Properties">3.2.1. N4JS Issue User data</a></li>
+<li><a href="assistance.html#sec:N4JS_Issue_Fixes">3.2.2. N4JS Issue Fixes</a>
+<ul class="sectlevel4">
+<li><a href="assistance.html#sec:Linking_Issues">3.2.2.1. Linking Issues</a></li>
+<li><a href="assistance.html#sec:Import_Issues">3.2.2.2. Import Issues</a></li>
+<li><a href="assistance.html#sec:Visibility_Issues">3.2.2.3. Visibility Issues</a></li>
+<li><a href="assistance.html#sec:Classifier_Issues">3.2.2.4. Classifier Issues</a></li>
+<li><a href="assistance.html#sec:Function_Issues">3.2.2.5. Function Issues</a></li>
+<li><a href="assistance.html#sec:Syntax_Issues">3.2.2.6. Syntax Issues</a></li>
+<li><a href="assistance.html#sec:Conversion_Issues">3.2.2.7. Conversion Issues</a></li>
+<li><a href="assistance.html#sec:Type_Issues">3.2.2.8. Type Issues</a></li>
+<li><a href="assistance.html#sec:Expression_Issues">3.2.2.9. Expression Issues</a></li>
+<li><a href="assistance.html#sec:Super_Keyword_Issues">3.2.2.10. Super Keyword Issues</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="assistance.html#sec:Quick_Assist">3.3. Quick Assist</a></li>
+<li><a href="assistance.html#sec:Cleanup_Operations">3.4. Cleanup Operations</a>
+<ul class="sectlevel3">
+<li><a href="assistance.html#sec:Formatting">3.4.1. Formatting</a></li>
+<li><a href="assistance.html#sec:Organize_Imports">3.4.2. Organize Imports</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="wizards.html#_wizards">4. Wizards</a>
+<ul class="sectlevel2">
+<li><a href="wizards.html#sec:N4JS_Project_Wizard">4.1. N4JS Project Wizard</a></li>
+<li><a href="wizards.html#sec:Empty_N4JS_File">4.2. Empty N4JS File</a></li>
+<li><a href="wizards.html#sec:Empty_JS_File">4.3. Empty JS File</a>
+<ul class="sectlevel3">
+<li><a href="wizards.html#sec:N4JS_Class_File_Wizard">4.3.1. N4JS Class Wizard</a></li>
+<li><a href="wizards.html#field-properties">4.3.2. Field Properties</a></li>
+<li><a href="wizards.html#visibility-issues-or-final-super-classes">4.3.3. Visibility issues or <code>@Final</code> super classes</a></li>
+<li><a href="wizards.html#generation-1">4.3.4. Generation</a></li>
+<li><a href="wizards.html#preview-1">4.3.5. Preview</a></li>
+</ul>
+</li>
+<li><a href="wizards.html#sec:N4JS_Interface_Wizard">4.4. Interface Wizard</a>
+<ul class="sectlevel3">
+<li><a href="wizards.html#field-properties-1">4.4.1. Field Properties</a></li>
+<li><a href="wizards.html#visibility-issues">4.4.2. Visibility Issues</a></li>
+<li><a href="wizards.html#import-naming-conflicts">4.4.3. Import naming conflicts</a></li>
+<li><a href="wizards.html#generation-2">4.4.4. Generation</a></li>
+<li><a href="wizards.html#preview-2">4.4.5. Preview</a></li>
+</ul>
+</li>
+<li><a href="wizards.html#sec:N4JS_Enum_File_Wizard">4.5. Enum Wizard</a>
+<ul class="sectlevel3">
+<li><a href="wizards.html#field-properties-2">4.5.1. Field Properties</a></li>
+<li><a href="wizards.html#generation-3">4.5.2. Generation</a></li>
+<li><a href="wizards.html#preview-3">4.5.3. Preview</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="execution_support.html#_execution-support">5. Execution Support</a>
+<ul class="sectlevel2">
+<li><a href="execution_support.html#sec:Non_UI_Execution">5.1. Non-UI Execution</a>
+<ul class="sectlevel3">
+<li><a href="execution_support.html#sec:Non_UI_Debugging">5.1.1. Non-UI Debugging</a></li>
+</ul>
+</li>
+<li><a href="execution_support.html#sec:UI_Execution">5.2. UI Execution</a></li>
+</ul>
+</li>
+<li><a href="test_support.html#_test-support">6. Test Support</a>
+<ul class="sectlevel2">
+<li><a href="test_support.html#sec:N4JS_Mangelhaft_support">6.1. N4JS Mangelhaft support</a>
+<ul class="sectlevel3">
+<li><a href="test_support.html#sec:Asynchronous_Tests">6.1.1. Asynchronous Tests, Test Isolation and Timeouts</a></li>
+<li><a href="test_support.html#sec:Supported_xUnit_API">6.1.2. Supported xUnit API</a>
+<ul class="sectlevel4">
+<li><a href="test_support.html#sec:Test_Group">6.1.2.1. Test Group</a></li>
+<li><a href="test_support.html#sec:Test_Method">6.1.2.2. Test Method</a></li>
+<li><a href="test_support.html#sec:BeforeAll">6.1.2.3. BeforeAll Setup</a></li>
+<li><a href="test_support.html#sec:Before_Setup">6.1.2.4. Before Setup</a></li>
+<li><a href="test_support.html#sec:After_Teardown">6.1.2.5. After Teardown</a></li>
+<li><a href="test_support.html#sec:AfterAll_Teardown">6.1.2.6. AfterAll Teardown</a></li>
+<li><a href="test_support.html#sec:Test_Ignore">6.1.2.7. Test Ignore</a></li>
+<li><a href="test_support.html#sec:Timeout">6.1.2.8. Timeout</a></li>
+<li><a href="test_support.html#sec:Description">6.1.2.9. Description</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="test_support.html#sec:Test_Reporting">6.2. Test Reporting</a>
+<ul class="sectlevel3">
+<li><a href="test_support.html#sec:Test_Messages">6.2.1. Test Messages</a>
+<ul class="sectlevel4">
+<li><a href="test_support.html#_test-case-ids">6.2.1.1. Test Case IDs</a></li>
+<li><a href="test_support.html#sec:Start_Session">6.2.1.2. Start Session</a></li>
+<li><a href="test_support.html#sec:Ping_Session">6.2.1.3. Ping Session</a></li>
+<li><a href="test_support.html#sec:End_Session">6.2.1.4. End Session</a></li>
+<li><a href="test_support.html#sec:Start_Test">6.2.1.5. Start Test</a></li>
+<li><a href="test_support.html#sec:End_Test">6.2.1.6. End Test</a></li>
+<li><a href="test_support.html#sec:Ping_Test">6.2.1.7. Ping Test</a></li>
+<li><a href="test_support.html#sec:Test_Catalog">6.2.1.8. Test Catalog</a></li>
+<li><a href="test_support.html#sec:Test_Session_Example">6.2.1.9. Test Session Example</a></li>
+</ul>
+</li>
+<li><a href="test_support.html#sec:Test_Runtime_Configuration">6.2.2. Test Runtime Configuration</a></li>
+<li><a href="test_support.html#sec:Test_Plan">6.2.3. Test Plan</a></li>
+<li><a href="test_support.html#sec:Test_Environment_Configuration">6.2.4. Test Environment Configuration</a></li>
+<li><a href="test_support.html#sec:Test_Environment_Configuration_Example">6.2.5. Test Environment Configuration Example</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="help_system.html#_help-system">7. Help System</a>
+<ul class="sectlevel2">
+<li><a href="help_system.html#sec:Built_In_Help">7.1. Built-In Help</a></li>
+<li><a href="help_system.html#sec:Context_Sensitive_Help">7.2. Context Sensitive Help</a></li>
+<li><a href="help_system.html#sec:Cheat_Sheets">7.3. Cheat Sheets</a></li>
+<li><a href="help_system.html#sec:JSDoc">7.4. JSDoc</a></li>
+<li><a href="help_system.html#sec:Hovering">7.5. Hovering</a>
+<ul class="sectlevel3">
+<li><a href="help_system.html#sec:Show_Type_Information_of_Selection">7.5.1. Show Type Information of Selection</a></li>
+</ul>
+</li>
+<li><a href="help_system.html#sec:Example_Projects_and_Files">7.6. Example Projects and Files</a></li>
+</ul>
+</li>
+<li><a href="bug_management.html#_bug-management">8. Bug Management</a>
+<ul class="sectlevel2">
+<li><a href="bug_management.html#sec:Built_In_Xpect_Support">8.1. Built-In Xpect Support</a>
+<ul class="sectlevel3">
+<li><a href="bug_management.html#sec:Report_View">8.1.1. Report View</a></li>
+<li><a href="bug_management.html#sec:Generate_Bug_Report">8.1.2. Generate Bug Report</a></li>
+<li><a href="bug_management.html#sec:Supported_Xpect_Tests">8.1.3. Supported Xpect Tests</a>
+<ul class="sectlevel4">
+<li><a href="bug_management.html#sec:XPECT_N4JS_Errors">8.1.3.1. Errors, Warnings, Infos, Issues</a></li>
+<li><a href="bug_management.html#sec:XPECT_N4JS_Noerrors">8.1.3.2. Noerrors</a></li>
+<li><a href="bug_management.html#sec:XPECT_N4JS_Output">8.1.3.3. Output, OutputRegex</a></li>
+<li><a href="bug_management.html#sec:XPECT_N4JS_Type_Of">8.1.3.4. Type Of</a></li>
+<li><a href="bug_management.html#sec:XPECT_Advanced_Methods">8.1.3.5. Advanced methods</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="cli.html#_cli">9. CLI</a>
+<ul class="sectlevel2">
+<li><a href="cli.html#sec:Headless_Compiler">9.1. Headless Compiler</a></li>
+<li><a href="cli.html#sec:Headless_Dependencies">9.2. Headless Dependnecies</a></li>
+<li><a href="cli.html#sec:Headless_Execution">9.3. Headless Execution</a>
+<ul class="sectlevel3">
+<li><a href="cli.html#sec:Cleaning_Headlessly">9.3.1. Cleaning Headlessly</a></li>
+<li><a href="cli.html#sec:Running_Headlessly">9.3.2. Running Headlessly</a></li>
+<li><a href="cli.html#sec:Information_about_running_headlessly">9.3.3. Information about running headlessly</a></li>
+<li><a href="cli.html#sec:Testing_Headlessly">9.3.4. Testing Headlessly</a></li>
+<li><a href="cli.html#sec:Information_about_testing_headlessly">9.3.5. Information about testing headlessly</a></li>
+<li><a href="cli.html#_testresults">9.3.6. TestResults</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_license.html#sec:License">Appendix A: License</a></li>
+<li><a href="appendix_b_acronyms.html#sec:Acronyms">Appendix B: Acronyms</a></li>
+<li><a href="appendix_c_bibliography.html#_bibliography">Appendix C: Bibliography</a></li>
+</ul>
+</div>
+</div>
+<div id="content">
+<div id="preamble">
+<div class="sectionbody">
+<div class="paragraph center">
+<p><strong>Last Updated: 2019-08-07</strong></p>
+</div>
+<div class="paragraph center">
+<p><strong>Authors:</strong><br>
+Jens von Pilgrim, Jakub Siberski, Mark-Oliver Reiser, Torsten Krämer, Ákos Kitta, Sebastian Zarnekow, Lorenzo Bettini, Jörg Reichert, Kristian Duske, Marcus Mews, Minh Quang Tran, Luca Beurer-Kellner</p>
+</div>
+<div style="page-break-after: always;"></div>
+<h2 id="_abstract" class="discrete">Abstract</h2>
+<div class="paragraph">
+<p>This document contains the N4JS IDE Specification.</p>
+</div>
+<h2 id="_introduction" class="discrete">Introduction</h2>
+<div class="paragraph">
+<p>This document describes the features of the N4JS <a href="appendix_b_acronyms.html#AC">IDE</a>, that is the user interface and features available to users of the <a href="appendix_b_acronyms.html#AC">IDE</a>. The language N4JS is described in [<a href="appendix_c_bibliography.html#N4JSSpec">N4JSSpec</a>] and is not part of this document.</p>
+</div>
+</div>
+</div>
+<ol>
+
+	<li><a href="./views.html#sec:Views">Views</a>
+	</li>
+	<li><a href="./navigation.html#_navigation">Navigation</a>
+	</li>
+	<li><a href="./assistance.html#_assistance">Assistance</a>
+	</li>
+	<li><a href="./wizards.html#_wizards">Wizards</a>
+	</li>
+	<li><a href="./execution_support.html#_execution-support">Execution Support</a>
+	</li>
+	<li><a href="./test_support.html#_test-support">Test Support</a>
+	</li>
+	<li><a href="./help_system.html#_help-system">Help System</a>
+	</li>
+	<li><a href="./bug_management.html#_bug-management">Bug Management</a>
+	</li>
+	<li><a href="./cli.html#_cli">CLI</a>
+	</li><li>Appendix
+<ol>
+
+	<li><a href="./appendix_a_license.html#sec:License">License</a></li>
+	<li><a href="./appendix_b_acronyms.html#sec:Acronyms">Acronyms</a></li>
+	<li><a href="./appendix_c_bibliography.html#_bibliography">Bibliography</a></li></ol></li>
+
+</ol></div>
+<div id="footer">
+<div id="footer-text">
+Version 0.9<br>
+Last updated 2019-08-07 15:02:40 CEST
+</div>
+</div>
+<!-- ************* docinfo-footer *************************************************************** -->
+<div class="Grid social" style="color:#d5dfea">
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <h2>Quick Links</h2>
+    <ul>
+      <li><a href="../downloads.html">Download</a></li>
+      <li><a href="../userguides/index.html">Documentation</a></li>
+      <li><a href="https://github.com/eclipse/n4js/">Source</a></li>
+      <li><a href="https://github.com/eclipse/n4js/issues">Issues</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="https://www.eclipse.org/forums/index.php/f/365/">Forum</a></li>
+      <li><a href="http://n4js.blogspot.de/">Blog</a></li>
+      <li><a href="https://dev.eclipse.org/mailman/listinfo/n4js-dev">Mailing List</a></li>
+      <li><a href="https://projects.eclipse.org/projects/technology.n4js">Eclipse Project Page</a></li>
+      <li><a href="https://twitter.com/n4jsdev">Tweets by n4jsdev</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="http://www.eclipse.org/">Eclipse Home</a></li>
+      <li><a href="http://www.eclipse.org/legal/privacy.php">Privacy Policy</a></li>
+      <li><a href="http://www.eclipse.org/legal/termsofuse.php">Terms of Use</a></li>
+      <li><a href="http://www.eclipse.org/legal/copyright.php">Copyright Agent</a></li>
+      <li><a href="http://www.eclipse.org/legal/">Legal</a></li>
+    </ul>
+  </div>
+  <div style="clear: both; height: 0; overflow: hidden;"></div>
+</div>
+
+<!-- ************* UI Scripts ************* -->
+<script type="text/javascript" src="scripts/back-to-top.js"></script>
+
+<script type="text/javascript" src="scripts/treeview.js"></script>
+<script type="text/javascript" src="scripts/toc.js"></script>
+
+<!-- ************* Prism.js Syntax Highlighting ************* -->
+<script src="scripts/prism.js"></script>
+
+<script type="text/javascript">
+	// Add the 'toclist' id for search function
+	$(".toc2 > ul").attr('id', 'toclist');
+	// Generate a Search input form
+	$("#toclist > li:first-of-type").before('<input type="text" id="pagesearch" onkeyup="search()" placeholder="Search for section...">');
+	$("#toclist > li:first-of-type").before('<i id="clear" class="fa fa-times-circle-o"></i>');
+	$("#clear").click(function(){
+	    $("#pagesearch").val('');
+	    search();
+	    $('.toc2 > ul').treeView('collapseAll');
+	});
+	// intialize Treeview.js
+	$(".toc2 > ul").treeView();
+	// Initialize Scrollspy
+</script>
+<!-- ************* docinfo-footer *************************************************************** -->
+</body>
+</html>
\ No newline at end of file
diff --git a/idespec/navigation.html b/idespec/navigation.html
new file mode 100644
index 0000000..12f4629
--- /dev/null
+++ b/idespec/navigation.html
@@ -0,0 +1,789 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="generator" content="Asciidoctor 1.5.5">
+<meta name="author" content="2019-08-07 15:02:40 CEST">
+<title>N4JS IDE Specification</title>
+<link rel="stylesheet" href="styles/spec.min.css">
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.6.3/css/font-awesome.min.css">
+<!-- ************* docinfo ******************************************************************* -->
+
+
+<!-- ************* Favicon ************-->
+<link rel="icon" href="images/favicon.ico" />
+
+<!-- ************* Back-to-top JQuery ************* -->
+<script src="https://code.jquery.com/jquery-1.12.4.js"></script>
+<script src="https://code.jquery.com/ui/1.12.0/jquery-ui.js"></script>
+
+
+<link href="styles/prism.min.css" rel="stylesheet" />
+<script type="text/javascript" async
+  src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2/MathJax.js?config=TeX-MML-AM_CHTML">
+</script>
+
+<!-- ************* Styles ************* -->
+<link rel="stylesheet" type="text/css" href="styles/n4jsspec-adoc.css">
+
+
+<!-- ****************** NavBar ****************** -->
+<div id="menubar">
+	<div class="banner">
+        <a href="https://www.eclipse.org/n4js/#"><img id="logo" src="images/n4js-logo.png" alt="Eclipse N4JS"></a>
+    </div>
+<ul>
+  <li><a href="index.html">Index</a></li>
+</ul>
+</div>
+<!-- ************* docinfo ******************************************************************* -->
+<style>
+      .admonitionblock td.icon .icon-todo:before{content:"\f249";color:#f4ee42}
+    </style>
+</head>
+<body class="book toc2 toc-left">
+<div id="header">
+<h1>N4JS IDE Specification</h1>
+<div class="details">
+<span id="author" class="author">2019-08-07 15:02:40 CEST</span><br>
+<span id="revnumber">version 0.9</span>
+</div>
+<div id="toc" class="toc2">
+<div id="toctitle">Table of Contents</div>
+<ul class="sectlevel1">
+<li><a href="views.html#sec:Views">1. Views</a>
+<ul class="sectlevel2">
+<li><a href="views.html#_eclipse-standard-views">1.1. Eclipse Standard Views</a>
+<ul class="sectlevel3">
+<li><a href="views.html#sec:Project_Explorer_View">1.1.1. Project Explorer</a></li>
+<li><a href="views.html#sec:Outline_View">1.1.2. Outline</a></li>
+<li><a href="views.html#sec:Problems_View">1.1.3. Problems</a></li>
+<li><a href="views.html#sec:Console_View">1.1.4. Console</a></li>
+<li><a href="views.html#sec:History_View">1.1.5. History</a></li>
+<li><a href="views.html#sec:Error_Log_View">1.1.6. Error Log</a></li>
+</ul>
+</li>
+<li><a href="views.html#_n4js-specific-views">1.2. N4JS Specific Views</a>
+<ul class="sectlevel3">
+<li><a href="views.html#_test-results">1.2.1. Test Results</a></li>
+<li><a href="views.html#_source-graphs">1.2.2. Source Graphs</a></li>
+<li><a href="views.html#_api-compare">1.2.3. API Compare</a></li>
+<li><a href="views.html#_performance-graphs">1.2.4. Performance Graphs</a></li>
+<li><a href="views.html#_source-mapping">1.2.5. Source Mapping</a></li>
+<li><a href="views.html#_xpect-view">1.2.6. Xpect View</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#_navigation">2. Navigation</a>
+<ul class="sectlevel2">
+<li><a href="#sec:Outline_Navigation">2.1. Outline</a>
+<ul class="sectlevel3">
+<li><a href="#_quick-outline">2.1.1. Quick Outline</a></li>
+<li><a href="#_normal-outline">2.1.2. Normal Outline</a></li>
+</ul>
+</li>
+<li><a href="#_navigation-commands">2.2. Navigation Commands</a>
+<ul class="sectlevel3">
+<li><a href="#sec:Navigate_to_Declaration">2.2.1. Navigate to Declaration</a></li>
+<li><a href="#sec:find_by_references">2.2.2. Find by References</a></li>
+<li><a href="#sec:Open_Type_Declaration">2.2.3. Open Type Declaration</a></li>
+</ul>
+</li>
+<li><a href="#sec:Working_Sets">2.3. Working Sets</a>
+<ul class="sectlevel3">
+<li><a href="#sec:Working_Set_Managers">2.3.1. Working Set Managers</a></li>
+<li><a href="#sec:Working_Set_Constraints">2.3.2. Working Set Constraints</a></li>
+<li><a href="#sec:Manual_Association_Working_Set_Manager_UI_Features">2.3.3. Manual Association Working Set Manager - UI Features</a></li>
+<li><a href="#sec:Project_Name_Filter_Working_Set_Manager">2.3.4. Project Name Filter Working Set Manager</a></li>
+<li><a href="#sec:Git_Repository_Working_Set_Manager">2.3.5. Git Repository Working Set Manager</a></li>
+<li><a href="#sec:Project_Location_Working_Set_Manager">2.3.6. Project Location Working Set Manager</a></li>
+<li><a href="#sec:N4JS_Project_Type_Working_Set_Manager">2.3.7. N4JS Project Type Working Set Manager</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="assistance.html#_assistance">3. Assistance</a>
+<ul class="sectlevel2">
+<li><a href="assistance.html#sec:Content_Assist">3.1. Content Assist</a>
+<ul class="sectlevel3">
+<li><a href="assistance.html#sec:Complete_Keywords">3.1.1. Complete Keywords</a></li>
+<li><a href="assistance.html#sec:Complete_Annotations">3.1.2. Complete Annotations</a></li>
+<li><a href="assistance.html#sec:Complete_Identifier_Reference">3.1.3. Complete Identifier Reference</a></li>
+<li><a href="assistance.html#sec:Complete_Member_Overrides">3.1.4. Complete Member Overrides</a></li>
+<li><a href="assistance.html#sec:Constructor_Completion">3.1.5. Constructor Completion</a></li>
+<li><a href="assistance.html#sec:Complete_Function_Expression">3.1.6. Complete Function Expression with Known Type</a></li>
+<li><a href="assistance.html#sec:Complete_Variable_and_Parameter_Names">3.1.7. Complete Variable and Parameter Names</a></li>
+</ul>
+</li>
+<li><a href="assistance.html#sec:Quick_Fixes">3.2. Quick Fixes</a>
+<ul class="sectlevel3">
+<li><a href="assistance.html#sec:N4JS_Issue_Properties">3.2.1. N4JS Issue User data</a></li>
+<li><a href="assistance.html#sec:N4JS_Issue_Fixes">3.2.2. N4JS Issue Fixes</a>
+<ul class="sectlevel4">
+<li><a href="assistance.html#sec:Linking_Issues">3.2.2.1. Linking Issues</a></li>
+<li><a href="assistance.html#sec:Import_Issues">3.2.2.2. Import Issues</a></li>
+<li><a href="assistance.html#sec:Visibility_Issues">3.2.2.3. Visibility Issues</a></li>
+<li><a href="assistance.html#sec:Classifier_Issues">3.2.2.4. Classifier Issues</a></li>
+<li><a href="assistance.html#sec:Function_Issues">3.2.2.5. Function Issues</a></li>
+<li><a href="assistance.html#sec:Syntax_Issues">3.2.2.6. Syntax Issues</a></li>
+<li><a href="assistance.html#sec:Conversion_Issues">3.2.2.7. Conversion Issues</a></li>
+<li><a href="assistance.html#sec:Type_Issues">3.2.2.8. Type Issues</a></li>
+<li><a href="assistance.html#sec:Expression_Issues">3.2.2.9. Expression Issues</a></li>
+<li><a href="assistance.html#sec:Super_Keyword_Issues">3.2.2.10. Super Keyword Issues</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="assistance.html#sec:Quick_Assist">3.3. Quick Assist</a></li>
+<li><a href="assistance.html#sec:Cleanup_Operations">3.4. Cleanup Operations</a>
+<ul class="sectlevel3">
+<li><a href="assistance.html#sec:Formatting">3.4.1. Formatting</a></li>
+<li><a href="assistance.html#sec:Organize_Imports">3.4.2. Organize Imports</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="wizards.html#_wizards">4. Wizards</a>
+<ul class="sectlevel2">
+<li><a href="wizards.html#sec:N4JS_Project_Wizard">4.1. N4JS Project Wizard</a></li>
+<li><a href="wizards.html#sec:Empty_N4JS_File">4.2. Empty N4JS File</a></li>
+<li><a href="wizards.html#sec:Empty_JS_File">4.3. Empty JS File</a>
+<ul class="sectlevel3">
+<li><a href="wizards.html#sec:N4JS_Class_File_Wizard">4.3.1. N4JS Class Wizard</a></li>
+<li><a href="wizards.html#field-properties">4.3.2. Field Properties</a></li>
+<li><a href="wizards.html#visibility-issues-or-final-super-classes">4.3.3. Visibility issues or <code>@Final</code> super classes</a></li>
+<li><a href="wizards.html#generation-1">4.3.4. Generation</a></li>
+<li><a href="wizards.html#preview-1">4.3.5. Preview</a></li>
+</ul>
+</li>
+<li><a href="wizards.html#sec:N4JS_Interface_Wizard">4.4. Interface Wizard</a>
+<ul class="sectlevel3">
+<li><a href="wizards.html#field-properties-1">4.4.1. Field Properties</a></li>
+<li><a href="wizards.html#visibility-issues">4.4.2. Visibility Issues</a></li>
+<li><a href="wizards.html#import-naming-conflicts">4.4.3. Import naming conflicts</a></li>
+<li><a href="wizards.html#generation-2">4.4.4. Generation</a></li>
+<li><a href="wizards.html#preview-2">4.4.5. Preview</a></li>
+</ul>
+</li>
+<li><a href="wizards.html#sec:N4JS_Enum_File_Wizard">4.5. Enum Wizard</a>
+<ul class="sectlevel3">
+<li><a href="wizards.html#field-properties-2">4.5.1. Field Properties</a></li>
+<li><a href="wizards.html#generation-3">4.5.2. Generation</a></li>
+<li><a href="wizards.html#preview-3">4.5.3. Preview</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="execution_support.html#_execution-support">5. Execution Support</a>
+<ul class="sectlevel2">
+<li><a href="execution_support.html#sec:Non_UI_Execution">5.1. Non-UI Execution</a>
+<ul class="sectlevel3">
+<li><a href="execution_support.html#sec:Non_UI_Debugging">5.1.1. Non-UI Debugging</a></li>
+</ul>
+</li>
+<li><a href="execution_support.html#sec:UI_Execution">5.2. UI Execution</a></li>
+</ul>
+</li>
+<li><a href="test_support.html#_test-support">6. Test Support</a>
+<ul class="sectlevel2">
+<li><a href="test_support.html#sec:N4JS_Mangelhaft_support">6.1. N4JS Mangelhaft support</a>
+<ul class="sectlevel3">
+<li><a href="test_support.html#sec:Asynchronous_Tests">6.1.1. Asynchronous Tests, Test Isolation and Timeouts</a></li>
+<li><a href="test_support.html#sec:Supported_xUnit_API">6.1.2. Supported xUnit API</a>
+<ul class="sectlevel4">
+<li><a href="test_support.html#sec:Test_Group">6.1.2.1. Test Group</a></li>
+<li><a href="test_support.html#sec:Test_Method">6.1.2.2. Test Method</a></li>
+<li><a href="test_support.html#sec:BeforeAll">6.1.2.3. BeforeAll Setup</a></li>
+<li><a href="test_support.html#sec:Before_Setup">6.1.2.4. Before Setup</a></li>
+<li><a href="test_support.html#sec:After_Teardown">6.1.2.5. After Teardown</a></li>
+<li><a href="test_support.html#sec:AfterAll_Teardown">6.1.2.6. AfterAll Teardown</a></li>
+<li><a href="test_support.html#sec:Test_Ignore">6.1.2.7. Test Ignore</a></li>
+<li><a href="test_support.html#sec:Timeout">6.1.2.8. Timeout</a></li>
+<li><a href="test_support.html#sec:Description">6.1.2.9. Description</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="test_support.html#sec:Test_Reporting">6.2. Test Reporting</a>
+<ul class="sectlevel3">
+<li><a href="test_support.html#sec:Test_Messages">6.2.1. Test Messages</a>
+<ul class="sectlevel4">
+<li><a href="test_support.html#_test-case-ids">6.2.1.1. Test Case IDs</a></li>
+<li><a href="test_support.html#sec:Start_Session">6.2.1.2. Start Session</a></li>
+<li><a href="test_support.html#sec:Ping_Session">6.2.1.3. Ping Session</a></li>
+<li><a href="test_support.html#sec:End_Session">6.2.1.4. End Session</a></li>
+<li><a href="test_support.html#sec:Start_Test">6.2.1.5. Start Test</a></li>
+<li><a href="test_support.html#sec:End_Test">6.2.1.6. End Test</a></li>
+<li><a href="test_support.html#sec:Ping_Test">6.2.1.7. Ping Test</a></li>
+<li><a href="test_support.html#sec:Test_Catalog">6.2.1.8. Test Catalog</a></li>
+<li><a href="test_support.html#sec:Test_Session_Example">6.2.1.9. Test Session Example</a></li>
+</ul>
+</li>
+<li><a href="test_support.html#sec:Test_Runtime_Configuration">6.2.2. Test Runtime Configuration</a></li>
+<li><a href="test_support.html#sec:Test_Plan">6.2.3. Test Plan</a></li>
+<li><a href="test_support.html#sec:Test_Environment_Configuration">6.2.4. Test Environment Configuration</a></li>
+<li><a href="test_support.html#sec:Test_Environment_Configuration_Example">6.2.5. Test Environment Configuration Example</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="help_system.html#_help-system">7. Help System</a>
+<ul class="sectlevel2">
+<li><a href="help_system.html#sec:Built_In_Help">7.1. Built-In Help</a></li>
+<li><a href="help_system.html#sec:Context_Sensitive_Help">7.2. Context Sensitive Help</a></li>
+<li><a href="help_system.html#sec:Cheat_Sheets">7.3. Cheat Sheets</a></li>
+<li><a href="help_system.html#sec:JSDoc">7.4. JSDoc</a></li>
+<li><a href="help_system.html#sec:Hovering">7.5. Hovering</a>
+<ul class="sectlevel3">
+<li><a href="help_system.html#sec:Show_Type_Information_of_Selection">7.5.1. Show Type Information of Selection</a></li>
+</ul>
+</li>
+<li><a href="help_system.html#sec:Example_Projects_and_Files">7.6. Example Projects and Files</a></li>
+</ul>
+</li>
+<li><a href="bug_management.html#_bug-management">8. Bug Management</a>
+<ul class="sectlevel2">
+<li><a href="bug_management.html#sec:Built_In_Xpect_Support">8.1. Built-In Xpect Support</a>
+<ul class="sectlevel3">
+<li><a href="bug_management.html#sec:Report_View">8.1.1. Report View</a></li>
+<li><a href="bug_management.html#sec:Generate_Bug_Report">8.1.2. Generate Bug Report</a></li>
+<li><a href="bug_management.html#sec:Supported_Xpect_Tests">8.1.3. Supported Xpect Tests</a>
+<ul class="sectlevel4">
+<li><a href="bug_management.html#sec:XPECT_N4JS_Errors">8.1.3.1. Errors, Warnings, Infos, Issues</a></li>
+<li><a href="bug_management.html#sec:XPECT_N4JS_Noerrors">8.1.3.2. Noerrors</a></li>
+<li><a href="bug_management.html#sec:XPECT_N4JS_Output">8.1.3.3. Output, OutputRegex</a></li>
+<li><a href="bug_management.html#sec:XPECT_N4JS_Type_Of">8.1.3.4. Type Of</a></li>
+<li><a href="bug_management.html#sec:XPECT_Advanced_Methods">8.1.3.5. Advanced methods</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="cli.html#_cli">9. CLI</a>
+<ul class="sectlevel2">
+<li><a href="cli.html#sec:Headless_Compiler">9.1. Headless Compiler</a></li>
+<li><a href="cli.html#sec:Headless_Dependencies">9.2. Headless Dependnecies</a></li>
+<li><a href="cli.html#sec:Headless_Execution">9.3. Headless Execution</a>
+<ul class="sectlevel3">
+<li><a href="cli.html#sec:Cleaning_Headlessly">9.3.1. Cleaning Headlessly</a></li>
+<li><a href="cli.html#sec:Running_Headlessly">9.3.2. Running Headlessly</a></li>
+<li><a href="cli.html#sec:Information_about_running_headlessly">9.3.3. Information about running headlessly</a></li>
+<li><a href="cli.html#sec:Testing_Headlessly">9.3.4. Testing Headlessly</a></li>
+<li><a href="cli.html#sec:Information_about_testing_headlessly">9.3.5. Information about testing headlessly</a></li>
+<li><a href="cli.html#_testresults">9.3.6. TestResults</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_license.html#sec:License">Appendix A: License</a></li>
+<li><a href="appendix_b_acronyms.html#sec:Acronyms">Appendix B: Acronyms</a></li>
+<li><a href="appendix_c_bibliography.html#_bibliography">Appendix C: Bibliography</a></li>
+</ul>
+</div>
+</div>
+<div id="content"><div class="sect1">
+<h2 id="_navigation"><a class="anchor" href="#_navigation"></a><a class="link" href="#_navigation">2. Navigation</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>In this chapter we describe specific views and features to allow for easy navigation.</p>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:Outline_Navigation"><a class="anchor" href="#sec:Outline_Navigation"></a><a class="link" href="#sec:Outline_Navigation">2.1. Outline</a></h3>
+<div class="paragraph">
+<p>In general, a outline view and a quick outline are supported. Both outlines work similar, which is why both are specified together. The outline of an N4JS file is a tree which should show the following structure: <a id="sec:N4JS_Outline"></a></p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Top-level defined classes, interfaces, roles, enums, functions and exported variables. For all these different types, icons are to be used (similar to JDT). Beside the name, type variables should be shown as well, if defined.</p>
+</li>
+<li>
+<p>Members of classifiers are to be shown in the classifier branch. All members (fields, methods, field accessors) are to be shown, with appropriate icons indicating the type (field/member), static flag, access modifier, abstract flag. The icons should look similar to JDT.</p>
+</li>
+<li>
+<p>an import declaration should have a node in the outline view, if multiple elements are imported these should represented as child nodes of that import declaration node. If the import uses aliases the original name and the alias name should appear in the outline node text.</p>
+</li>
+<li>
+<p>for a non exported function declaration no outline node should be created</p>
+</li>
+<li>
+<p>for a non exported variable declaration no outline node should be created</p>
+</li>
+<li>
+<p>for a exported variable statement there should be a node in the outline, if this statement contains only one variable declaration the node represents this declaration. For multiple variable declarations in the statement the statement node just is a comma separated list of the variable names and for each variable there is child node</p>
+</li>
+<li>
+<p>for fields, functions, methods, getters and variables their declared (return) type should be shown (by adding : typeName after the element name). If the type is inferred then the type name should be presented in a different color</p>
+</li>
+<li>
+<p>for functions, methods and setters each formal parameter should be represented by its declared or inferred type (when inferred than with different color)</p>
+</li>
+<li>
+<p>constructors are represented by the method icon and a decorator in the top right corner</p>
+</li>
+<li>
+<p>enumeration literals are represented with the same decoration as static final fields</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>The top-level elements must be sortable either by order in the file (default) or alphabetically.</p>
+</div>
+<div class="sect3">
+<h4 id="_quick-outline"><a class="anchor" href="#_quick-outline"></a><a class="link" href="#_quick-outline">2.1.1. Quick Outline</a></h4>
+<div class="paragraph">
+<p>The quick outline supports two modes. The modes are iteratively selected by pressing <span class="keyseq"><kbd>CMD/CTRL</kbd>+<kbd>O</kbd></span>.</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">owned</dt>
+<dd>
+<p>This is the default mode, only members directly owned by the type are shown</p>
+</dd>
+<dt class="hdlist1">inherited</dt>
+<dd>
+<p>In this mode, the owned members are shown including inherited, consumed, or polyfilled members. The origin is also shown and a different color is used to highlight the special status of these members. For usability reasons (limiting the number of filters), inherited, consumed and polyfilled members are treated similarly.</p>
+</dd>
+</dl>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_normal-outline"><a class="anchor" href="#_normal-outline"></a><a class="link" href="#_normal-outline">2.1.2. Normal Outline</a></h4>
+<div class="paragraph">
+<p>In the normal outline view, toggles are used for the same purpose. Visualisations are similar to the quick outline view.</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">inherited</dt>
+<dd>
+<p>By default, only owned members of a type are shown. If the "inherited" toggle is active, inherited, consumed, or polyfilled members as well. For usability reasons (limiting the number of filters), inherited, consumed, and polyfilled members are treated similarly.</p>
+</dd>
+</dl>
+</div>
+<div class="paragraph">
+<p></p>
+</div>
+<div class="sidebarblock">
+<div class="content">
+<a href="https://github.com/eclipse/n4js/issues/99" class="gray" title="GitHub Issues"><span class="image"><img src="images/issue.svg" alt=""></span> #99</a>
+</div>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">sorting</dt>
+<dd>
+<p>By default, all elements are sorted in the order of their appearance in the source code. If alphabetic sorting is enabled, they are sorted alphabetically.</p>
+</dd>
+</dl>
+</div>
+<div class="admonitionblock todo">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-todo" title="Todo"></i>
+</td>
+<td class="content">
+<div class="paragraph">
+<p>Potential improvements:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>show decorator when a member overrides and member from a super class / super interface or role</p>
+</li>
+<li>
+<p>show object literals and their members in the outline view (just filter <code>eAllContents</code> of an element that already has a node in outline view for object literals)</p>
+</li>
+<li>
+<p>show function expression in the outline view (just filter <code>eAllContents</code> of an element that already has a node in outline view for function expressions)</p>
+</li>
+</ul>
+</div>
+</td>
+</tr>
+</table>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_navigation-commands"><a class="anchor" href="#_navigation-commands"></a><a class="link" href="#_navigation-commands">2.2. Navigation Commands</a></h3>
+<div class="sect3">
+<h4 id="sec:Navigate_to_Declaration"><a class="anchor" href="#sec:Navigate_to_Declaration"></a><a class="link" href="#sec:Navigate_to_Declaration">2.2.1. Navigate to Declaration</a></h4>
+<div class="paragraph">
+<p>It is possible to Command-click on almost every reference and jump to its declaration.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:find_by_references"><a class="anchor" href="#sec:find_by_references"></a><a class="link" href="#sec:find_by_references">2.2.2. Find by References</a></h4>
+<div class="paragraph">
+<p>For each referenceable element in an open N4JS file you can click your mouse and invoke the context menu to select <code>Find references</code>. Then in the Eclipse search view all found references are displayed as tree: each match is structured by resource path and coarse grained element in the resource (like a method). If there are multiple matches within a method only the first match is linked but in its display string the total match count is shown in brackets.</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>find by references shows the result as tree in the Eclipse search view with having elements that are members or have defined type displayed as nodes</p>
+</li>
+<li>
+<p>every found reference is displayed under its nearest parent that is a member or has a defined type</p>
+</li>
+<li>
+<p>if there a multiple found references in a node only the first one is displayed (and linked) + the number of all total matches is shown as part of the display string (like in JDT)</p>
+</li>
+</ol>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Open_Type_Declaration"><a class="anchor" href="#sec:Open_Type_Declaration"></a><a class="link" href="#sec:Open_Type_Declaration">2.2.3. Open Type Declaration</a></h4>
+<div class="paragraph">
+<p>One can quickly browse the workbench for available types. The declaration of the types can be opened in editor from this dialog. The N4JS type search dialog can be raised with the <kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>T</kbd> key binding (<kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>T</kbd> on Windows and Linux systems).</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Enter <strong>exact type name</strong>, prefix name or a camel case pattern to run a query against the types. The following rules and patterns are supported.</p>
+<div class="ulist">
+<ul>
+<li>
+<p><strong>Wildcards</strong>: <code>?</code>  for any character and <code>*</code> for any string.</p>
+</li>
+<li>
+<p><strong>Camel case</strong>: <code>DM</code>  will return with all types that contains <code>D</code> and <code>M</code> with the given order such as <code>DataMap</code> and <code>DataMapEntry</code> but not <code>ImmutableDataMap</code>.</p>
+<div class="paragraph">
+<p><code>AcBuGr</code> will return with all types that contain <code>Ac</code>, <code>Bu</code> and <code>Gr</code> with the given order such as <code>ActionButtonGroup</code>.</p>
+</div>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p><strong>Highlighting</strong>: The matching types names are highlighted according to the matching parts.</p>
+</li>
+<li>
+<p><strong>Decorator</strong> for duplicate type names: The internally used fully qualified name of the type will be appended to the type name automatically, so one can easily distinguish between types even there are type name collision.</p>
+</li>
+<li>
+<p><strong>Opening types in editor</strong>: Type declarations can be opened in the editor in the following ways: after entering the type name prefix or pattern to the filter text one can navigate among the filtered items with the up and/or down arrow keys. Simply hitting return on the keyboard or clicking on the ’OK’ button the currently selected declaration of the selected type will be opened in the editor. For opening multiple type declarations one can use the <kbd>Shift</kbd>  modifier to select more than one element. Single type can be opened with double clicking on it in the dialog.</p>
+</li>
+<li>
+<p><strong>History</strong>: Once a type is being opened then it will be available among the recently opened type in the type search dialog. These items will show up in the upper part of the list in the dialog.</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+<div class="sect2 language-bash">
+<h3 id="sec:Working_Sets"><a class="anchor" href="#sec:Working_Sets"></a><a class="link" href="#sec:Working_Sets">2.3. Working Sets</a></h3>
+<div class="paragraph">
+<p>Working sets are used to logically group resources, projects in the Project Explorer (navigator) and in the UI in general. Although a couple of projects can be easily handled and shown without any sophisticated working set support in the navigator, larger code sources consisting of multiple projects could cause some trouble when one has to maintain them. Indeed one could use multiple workspaces and could switch between them or can simply manually open-close relevant projects, but this gets cumbersome too.</p>
+</div>
+<div class="paragraph">
+<p>This section describes the general design of the N4JS specific working set support and also introduces a couple of use cases while enumerating the constraints.</p>
+</div>
+<div class="sect3">
+<h4 id="sec:Working_Set_Managers"><a class="anchor" href="#sec:Working_Set_Managers"></a><a class="link" href="#sec:Working_Set_Managers">2.3.1. Working Set Managers</a></h4>
+<div class="paragraph">
+<p>Just like the JDT (<code>org.eclipse.jdt.internal.ui.workingsets.WorkingSetModel</code>) based working set support, the N4JS IDE based approach is also aware of the <code>org.eclipse.ui.IWorkingSet</code> and the <code>org.eclipse.ui.IWorkingSetManager</code> APIs but besides simply using them it comes with its own implementation and adapts it to the default Eclipse based one, furthermore it also comes with an Eclipse extension point based mechanism to support various working set managers at the same time to provide even better user experience and a more convenient way of working set management.</p>
+</div>
+<div class="paragraph">
+<p>A working set manager can be contributed to the IDE via the <code>org.eclipse.n4js.ui.workingSetManager</code> extension point, then the implementation class must implement the <code>org.eclipse.n4js.ui.workingsets.WorkingSetManager</code> interface but it is highly recommended to rather extend the <code>org.eclipse.n4js.ui.workingsets.WorkingSetManagerImpl</code> class. Guice based dependency injection should also be considered when implementing the custom working set manager. It means that each custom working set manager implementation must have a public <em>no-args</em> constructor. This <em>no-args</em> constructor will be invoked when creating the instances via <code>IConfigurationElement#createExecutableExtension(String)</code> method. Then the members, if any will be injected by the working set manager broker. Below <code>plugin.xml</code> snippet describes how to contribute a custom working set manager to the IDE.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xml" data-lang="xml">   &lt;extension
+         point="org.eclipse.n4js.ui.workingSetManager"&gt;
+      &lt;manager
+            class="some.package.name.MyExecutableExtensionFactory:some.package.name.MyWorkingSetManager"&gt;
+      &lt;/manager&gt;
+   &lt;/extension&gt;</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>By default the N4JS IDE comes with five different built-in working set managers. These are the followings:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Manual Association Working Set Manager,</p>
+</li>
+<li>
+<p>Project Name Filter Working Set Manager,</p>
+</li>
+<li>
+<p>Git Repository Working Set Manager,</p>
+</li>
+<li>
+<p>Project Location Working Set Manager and</p>
+</li>
+<li>
+<p>N4JS Project Type Working Set Manager.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>The benefits and the details of each built-in working set managers will be discussed in later sections but first we have to distinguish between three conceptually different working set manager approaches.</p>
+</div>
+<div class="paragraph">
+<p>First off, IDE supports fully static working set managers. Fully static working set managers might manage any arbitrary number of working sets, and each working set might be associated with any number of Eclipse projects. That means, user might create, edit and remove working sets and manually associate projects with individual working sets. One project might belong to multiple working sets. There is a dedicated working set, <em>Other Projects</em>, that cannot be renamed and/or deleted. When no user defined working sets are available this dedicated working set will be still available. IDE comes with one single fully static working set manager: <em>Manual Association Working Set Manager</em>.</p>
+</div>
+<div class="paragraph">
+<p>The second kind of working set manager is the semi-dynamic one. That means, user can create, modify and delete working sets, but the associations between the projects and the working sets are automatic. This means, the user might define a working set - project association rule, and the projects will be automatically associated with the working sets. Just like in the above kind, one project might belong to multiple working sets and here as well, there is a dedicated working set manager, that cannot be modified: <em>Other Projects</em>. IDE comes with one semi-dynamic working set manager. That is the <em>Project Name Filter Working Set Manager</em>. User might define a project name filter rule with a regular expression, and each project which name matches a pattern will be associated with the working set. If a project does not comply to any working set manager rule, then it will belong to the <em>Other Projects</em> working set.</p>
+</div>
+<div class="paragraph">
+<p>The third kind of working set manager is the fully-dynamic working set manager. Both the working sets and the project associations are done by some implementation specific rules. Such as Git repository provider based, or project location based approaches. These working set managers have the dedicated <em>Other Projects</em> working set that is used as a fallback working set. For instance, if the <em>Git Repository Working Set Manager</em> is the active one, all projects that are shared with Git will belong to the corresponding working set manager but if a project is not yet a shared project, then it will belong to the dedicated fallback working set. As always that working set manager cannot be deleted and/or modified.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Working_Set_Constraints"><a class="anchor" href="#sec:Working_Set_Constraints"></a><a class="link" href="#sec:Working_Set_Constraints">2.3.2. Working Set Constraints</a></h4>
+<div class="paragraph">
+<p>This section enumerates a set of constraints that have to considered by both end users and implementors:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Working set manager identifier must be unique.</p>
+</li>
+<li>
+<p>The identifier of the working set manager must be unique per container working set managers.</p>
+</li>
+<li>
+<p>Each working set must have a working set with <em>Other Projects</em> unique ID and name.</p>
+</li>
+<li>
+<p>Working sets with <em>Other Projects</em> unique ID must not be editable nor deletable.</p>
+</li>
+<li>
+<p>At least one working set should be visible (not hidden) per working set managers.</p>
+</li>
+<li>
+<p>Working set managers are activated when the <em>Working Sets</em> are configured as <em>Top Level Elements</em> in the <em>Project Explorer</em>.</p>
+</li>
+<li>
+<p>Working set order can be specified and customized by the user if it is not specified yet, then a case sensitive ordering based on the working set names should be applied.</p>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Manual_Association_Working_Set_Manager_UI_Features"><a class="anchor" href="#sec:Manual_Association_Working_Set_Manager_UI_Features"></a><a class="link" href="#sec:Manual_Association_Working_Set_Manager_UI_Features">2.3.3. Manual Association Working Set Manager - UI Features</a></h4>
+<div class="paragraph">
+<p>This section describes the working set manager by introducing the UI capabilities as well.</p>
+</div>
+<div class="paragraph">
+<p>This working set manager is a fully static working set manager and activated and used as the default one when the working set manager support is turned on in the IDE. With this working set manager one can create a new working set by simply defining a unique name for the working set and associating any number of workspace project to the working set. Furthermore existing working sets can be modified and deleted but the <em>Other Projects</em> working set. The working set support can be turned on in the <em>Project Explorer</em> view. Via the view menu one has to select <em>Top Level Elements</em> <em>&gt;</em> <em>Working Sets</em> menu item.</p>
+</div>
+<div class="imageblock center" style="text-align: center">
+<div class="content">
+<img src="chapters/04_navigation/fig/activate_working_set_managers.png" alt="Activate_Working_Set_Managers" width="50%">
+</div>
+<div class="title">Figure 1. Activate Working Set Managers</div>
+</div>
+<div class="paragraph">
+<p>After the working set manager mode activation, a new toolbar contribution item become visible and user can select among the available working set managers.</p>
+</div>
+<div class="imageblock center" style="text-align: center">
+<div class="content">
+<img src="chapters/04_navigation/fig/select_working_set_manager_01.png" alt="Select_Working_Set_Manager" width="50%">
+</div>
+<div class="title">Figure 2. Select Working Set Manager</div>
+</div>
+<div class="paragraph">
+<p>As the below picture depicts the available working set managers are listed and the currently active manager is marked with a check. In our case that is the <em>Manual Association Working Set Manager</em>.</p>
+</div>
+<div class="imageblock center" style="text-align: center">
+<div class="content">
+<img src="chapters/04_navigation/fig/select_working_set_manager_02.png" alt="Activate_Working_Set_Manager" width="25%">
+</div>
+<div class="title">Figure 3. Activate Working Set Manager</div>
+</div>
+<div class="paragraph">
+<p>Once the the <em>Configure Manual Association&#8230;&#8203;</em> menu item is selected, the working set manager configuration dialog pops up. By clicking on the <em>New&#8230;&#8203;</em> button in the configuration dialog, a new working set wizard will be invoked and the manual working set - project association can be configured.</p>
+</div>
+<div class="imageblock center" style="text-align: center">
+<div class="content">
+<img src="chapters/04_navigation/fig/configure_working_sets_01.png" alt="Configure_Working_Sets" width="25%">
+</div>
+<div class="title">Figure 4. Configure Working Sets</div>
+</div>
+<div class="paragraph">
+<p>In the wizard after specifying the desired unique name of the working set an arbitrary number of workspace projects can be associated with the working set. It is important to note, that a project can be associated with more than one working sets. If a project is not associated with any working sets then it will be automatically linked to the fallback <em>Other Projects</em> working set.</p>
+</div>
+<div class="imageblock center" style="text-align: center">
+<div class="content">
+<img src="chapters/04_navigation/fig/working_set_project_association.png" alt="Configure_Working_Set_Project_Association" width="50%">
+</div>
+<div class="title">Figure 5. Working Set - Projects Association</div>
+</div>
+<div class="paragraph">
+<p>Once all the changes made are confirmed and the configuration dialog is closed via the <em>OK</em> button, the <em>Project Explorer</em> will be refreshed and will reflect the working set changes.</p>
+</div>
+<div class="imageblock center" style="text-align: center">
+<div class="content">
+<img src="chapters/04_navigation/fig/working_sets_in_navigator.png" alt="Custom_Working_Sets_In_Project_Explorer" width="25%">
+</div>
+<div class="title">Figure 6. Custom Working Sets In Project Explorer</div>
+</div>
+<div class="paragraph">
+<p>The order of the working sets can be configured and customized in the working set manager configuration dialog, or just simply reordering it from the navigator itself by drag and dropping the available working set managers.</p>
+</div>
+<div class="imageblock center" style="text-align: center">
+<div class="content">
+<img src="chapters/04_navigation/fig/working_set_reorder.png" alt="Re_Ordering_Working_Sets_In_Project_Explorer" width="25%">
+</div>
+<div class="title">Figure 7. Re-ordering Working Sets In Project Explorer</div>
+</div>
+<div class="paragraph">
+<p>Besides changing the order of the working sets, working sets can be hidden from the navigator. Just like the ordering, this can be changed from the working set configuration dialog, or by simply selecting working sets in the navigator and hiding them via <em>Hide Selected Working Set</em> menu item. Important to note, at least one working set should be visible in the navigator, so if all the working sets are selected in the navigator, then the menu item will be disabled. Same behavior in the working set customization dialog, if all items are unchecked, then the <em>OK</em> button is disabled in the dialog.</p>
+</div>
+<div class="imageblock center" style="text-align: center">
+<div class="content">
+<img src="chapters/04_navigation/fig/working_set_hide.png" alt="Hide_Working_Sets_In_Project_Explorer" width="25%">
+</div>
+<div class="title">Figure 8. Hide Working Sets In Project Explorer</div>
+</div>
+<div class="paragraph">
+<p>Once at least one working set is hidden from the UI, then a new toolbar contribution become visible in the <em>Project Explorer</em>. This UI contribution provides a quick, convenient way to show a specific or all hidden working sets in the navigator. It is worth to note, if a project is automatically associated with the <em>Other Projects</em> working set (because it does not belong to any working sets due to the lack of manual association) it will be not shown in the navigator if the <em>Other Projects</em> working set is hidden. Once all working sets are visible, indeed the <em>Show Hidden Working Sets</em> toolbar contribution become invisible.</p>
+</div>
+<div class="imageblock center" style="text-align: center">
+<div class="content">
+<img src="chapters/04_navigation/fig/working_set_show.png" alt="Show_Hidden_Working_Sets_In_Project_Explorer" width="25%">
+</div>
+<div class="title">Figure 9. Show Hidden Working Sets In Project Explorer</div>
+</div>
+<div class="paragraph">
+<p>Besides the above described generic working set UI support, projects can be associated with working sets by simply drag and dropping them from one working set into another. Note, this is only supported for the <em>Manual Association Working Set Manager</em>.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Project_Name_Filter_Working_Set_Manager"><a class="anchor" href="#sec:Project_Name_Filter_Working_Set_Manager"></a><a class="link" href="#sec:Project_Name_Filter_Working_Set_Manager">2.3.4. Project Name Filter Working Set Manager</a></h4>
+<div class="paragraph">
+<p>As mentioned earlier, this working set is a semi-dynamic working set. The working sets can be created, edited and deleted by the user by simply specifying project name filter pattern as valid regular expressions but the project association itself is fully automatic. If the name of a project does not match with any project name filter rule, then the project will be associated with the <em>Other Projects</em> working set. Although reordering the working sets from the navigator by simple drag and dropping them is supported, project association is disabled.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Git_Repository_Working_Set_Manager"><a class="anchor" href="#sec:Git_Repository_Working_Set_Manager"></a><a class="link" href="#sec:Git_Repository_Working_Set_Manager">2.3.5. Git Repository Working Set Manager</a></h4>
+<div class="paragraph">
+<p>This working set is a fully-dynamic working set. Projects will be associated by the Git providers. It means, if a project is imported from a pre-configured local Git repository, then the project will be associated with the working set linked with the Git repository. The subset of the available working sets is become automatically updated once the Git repository preferences changed by the user. These preferences can be changed on the <em>Git</em> perspective in the <em>Git Repositories</em> view by simple adding or hiding/removing a repository from the view.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Project_Location_Working_Set_Manager"><a class="anchor" href="#sec:Project_Location_Working_Set_Manager"></a><a class="link" href="#sec:Project_Location_Working_Set_Manager">2.3.6. Project Location Working Set Manager</a></h4>
+<div class="paragraph">
+<p>This fully-dynamic working set manager calculates the subset of available working sets based on the parent folder of the projects. The benefit of this working set manager is to support the convention recommended by the maven/Git folder structuring. The following constraints are applied when associating the projects with the available working sets:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>If a project is located in the root of the Eclipse workspace, then it will be associated with <em>Other Projects</em> working set.</p>
+</li>
+<li>
+<p>If a project is nested somewhere in the Eclipse workspace, then it will be associated with a working set that has the same name as the parent folder of the project. Let assume the Eclipse workspace root points to <code>/eclipse/root</code> and there is a project <code>P1</code> nested in the workspace root at <code>/eclipse/root/path/to/nested/location/P1</code>, then the associated working set will be <code>location</code>.</p>
+</li>
+<li>
+<p>If a project is not contained in the workspace, but has a Git provider that is configured in IDE, and the project root is the local Git repository root, then the associated working set name will be the name of the Git repository. For example, if we have Eclipse workspace root pointing to <code>/eclipse/root</code> location and a <code>P2</code> project located <code>/some/path/to/git/P2</code> but this location is the location of a registered Git repository, then the name of the associated working set will be neither <code>Other Projects</code> not <code>git</code> but <code>P2</code> since that is known Git local repository root.</p>
+</li>
+<li>
+<p>If project <code>P3</code> is not contained in the Eclipse workspace but contained in a known local Git repository just like above, but the project root is not the local Git repository root, then the name of the parent folder will be considered as the name of the associated working set. This rule is a hybrid alternative of the second and the third constraints, hence for instance if the project is under <code>/some/path/to/git/repositoryName/plugins/P3</code> and <code>repositoryName</code> is local git repository, then the name of the associated working set will be <code>plugins</code> and not <code>repositoryName</code>.</p>
+</li>
+<li>
+<p>Else the associated working set will be the <em>Other Projects</em> fallback working set.</p>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:N4JS_Project_Type_Working_Set_Manager"><a class="anchor" href="#sec:N4JS_Project_Type_Working_Set_Manager"></a><a class="link" href="#sec:N4JS_Project_Type_Working_Set_Manager">2.3.7. N4JS Project Type Working Set Manager</a></h4>
+<div class="paragraph">
+<p>This is working set manager is a N4JS specific fully-dynamic working set manager. The working sets will be calculated based on the instances defined by the <code>org.eclipse.n4js.n4mf.ProjectType</code> type. Each accessible N4JS project will be associated to a working set based on the project type. A workspace project will be associated with the <em>Other Projects</em> fallback working set if any of the followings are true to the project:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>The project is not accessible. (It does not exist or is not opened.)</p>
+</li>
+<li>
+<p>The project does not configured with <em>Xtext</em> nature.</p>
+</li>
+<li>
+<p>The project does not have an <em>Xtext</em> builder command ID.</p>
+</li>
+<li>
+<p>The project does not have a valid N4 manifest file.</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div id="footer">
+<div id="footer-text">
+Version 0.9<br>
+Last updated 2019-08-07 15:02:40 CEST
+</div>
+</div>
+<!-- ************* docinfo-footer *************************************************************** -->
+<div class="Grid social" style="color:#d5dfea">
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <h2>Quick Links</h2>
+    <ul>
+      <li><a href="../downloads.html">Download</a></li>
+      <li><a href="../userguides/index.html">Documentation</a></li>
+      <li><a href="https://github.com/eclipse/n4js/">Source</a></li>
+      <li><a href="https://github.com/eclipse/n4js/issues">Issues</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="https://www.eclipse.org/forums/index.php/f/365/">Forum</a></li>
+      <li><a href="http://n4js.blogspot.de/">Blog</a></li>
+      <li><a href="https://dev.eclipse.org/mailman/listinfo/n4js-dev">Mailing List</a></li>
+      <li><a href="https://projects.eclipse.org/projects/technology.n4js">Eclipse Project Page</a></li>
+      <li><a href="https://twitter.com/n4jsdev">Tweets by n4jsdev</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="http://www.eclipse.org/">Eclipse Home</a></li>
+      <li><a href="http://www.eclipse.org/legal/privacy.php">Privacy Policy</a></li>
+      <li><a href="http://www.eclipse.org/legal/termsofuse.php">Terms of Use</a></li>
+      <li><a href="http://www.eclipse.org/legal/copyright.php">Copyright Agent</a></li>
+      <li><a href="http://www.eclipse.org/legal/">Legal</a></li>
+    </ul>
+  </div>
+  <div style="clear: both; height: 0; overflow: hidden;"></div>
+</div>
+
+<!-- ************* UI Scripts ************* -->
+<script type="text/javascript" src="scripts/back-to-top.js"></script>
+
+<script type="text/javascript" src="scripts/treeview.js"></script>
+<script type="text/javascript" src="scripts/toc.js"></script>
+
+<!-- ************* Prism.js Syntax Highlighting ************* -->
+<script src="scripts/prism.js"></script>
+
+<script type="text/javascript">
+	// Add the 'toclist' id for search function
+	$(".toc2 > ul").attr('id', 'toclist');
+	// Generate a Search input form
+	$("#toclist > li:first-of-type").before('<input type="text" id="pagesearch" onkeyup="search()" placeholder="Search for section...">');
+	$("#toclist > li:first-of-type").before('<i id="clear" class="fa fa-times-circle-o"></i>');
+	$("#clear").click(function(){
+	    $("#pagesearch").val('');
+	    search();
+	    $('.toc2 > ul').treeView('collapseAll');
+	});
+	// intialize Treeview.js
+	$(".toc2 > ul").treeView();
+	// Initialize Scrollspy
+</script>
+<!-- ************* docinfo-footer *************************************************************** -->
+</body>
+</html>
\ No newline at end of file
diff --git a/idespec/scripts/back-to-top.js b/idespec/scripts/back-to-top.js
new file mode 100644
index 0000000..6f1b6fa
--- /dev/null
+++ b/idespec/scripts/back-to-top.js
@@ -0,0 +1,28 @@
+/**
+ * Copyright (c) 2016 NumberFour AG.
+ * All rights reserved. This program and the accompanying materials
+ * are made available under the terms of the Eclipse Public License v1.0
+ * which accompanies this distribution, and is available at
+ * http://www.eclipse.org/legal/epl-v10.html
+ *
+ * Contributors:
+ *   NumberFour AG - Initial API and implementation
+ */
+
+ 
+// Create a back to top button
+$('body').prepend('<a href="#" class="back-to-top">Back to Top</a>');
+var amountScrolled = 300;
+$(window).scroll(function() {
+if ( $(window).scrollTop() > amountScrolled ) {
+    $('a.back-to-top').fadeIn('slow');
+} else {
+    $('a.back-to-top').fadeOut('slow');
+}
+});
+$('a.back-to-top, a.simple-back-to-top').click(function() {
+$('html, body').animate({
+    scrollTop: 0
+}, 700);
+return false;
+});
diff --git a/idespec/scripts/prism.js b/idespec/scripts/prism.js
new file mode 100644
index 0000000..4f619ca
--- /dev/null
+++ b/idespec/scripts/prism.js
@@ -0,0 +1,58 @@
+/* http://prismjs.com/download.html?themes=prism&languages=markup+css+clike+javascript+asciidoc+bash+c+csharp+cpp+ruby+docker+git+go+groovy+http+ini+java+json+latex+lua+markdown+n4js+nginx+nix+perl+php+php-extras+powershell+properties+python+r+jsx+rust+sass+scss+sql+swift+typescript+yaml&plugins=line-highlight+line-numbers+show-invisibles+autolinker+file-highlight+toolbar+jsonp-highlight+highlight-keywords+autoloader+command-line+data-uri-highlight+show-language+copy-to-clipboard */
+var _self="undefined"!=typeof window?window:"undefined"!=typeof WorkerGlobalScope&&self instanceof WorkerGlobalScope?self:{},Prism=function(){var e=/\blang(?:uage)?-(\w+)\b/i,t=0,n=_self.Prism={util:{encode:function(e){return e instanceof a?new a(e.type,n.util.encode(e.content),e.alias):"Array"===n.util.type(e)?e.map(n.util.encode):e.replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/\u00a0/g," ")},type:function(e){return Object.prototype.toString.call(e).match(/\[object (\w+)\]/)[1]},objId:function(e){return e.__id||Object.defineProperty(e,"__id",{value:++t}),e.__id},clone:function(e){var t=n.util.type(e);switch(t){case"Object":var a={};for(var r in e)e.hasOwnProperty(r)&&(a[r]=n.util.clone(e[r]));return a;case"Array":return e.map&&e.map(function(e){return n.util.clone(e)})}return e}},languages:{extend:function(e,t){var a=n.util.clone(n.languages[e]);for(var r in t)a[r]=t[r];return a},insertBefore:function(e,t,a,r){r=r||n.languages;var i=r[e];if(2==arguments.length){a=arguments[1];for(var l in a)a.hasOwnProperty(l)&&(i[l]=a[l]);return i}var o={};for(var s in i)if(i.hasOwnProperty(s)){if(s==t)for(var l in a)a.hasOwnProperty(l)&&(o[l]=a[l]);o[s]=i[s]}return n.languages.DFS(n.languages,function(t,n){n===r[e]&&t!=e&&(this[t]=o)}),r[e]=o},DFS:function(e,t,a,r){r=r||{};for(var i in e)e.hasOwnProperty(i)&&(t.call(e,i,e[i],a||i),"Object"!==n.util.type(e[i])||r[n.util.objId(e[i])]?"Array"!==n.util.type(e[i])||r[n.util.objId(e[i])]||(r[n.util.objId(e[i])]=!0,n.languages.DFS(e[i],t,i,r)):(r[n.util.objId(e[i])]=!0,n.languages.DFS(e[i],t,null,r)))}},plugins:{},highlightAll:function(e,t){var a={callback:t,selector:'code[class*="language-"], [class*="language-"] code, code[class*="lang-"], [class*="lang-"] code'};n.hooks.run("before-highlightall",a);for(var r,i=a.elements||document.querySelectorAll(a.selector),l=0;r=i[l++];)n.highlightElement(r,e===!0,a.callback)},highlightElement:function(t,a,r){for(var i,l,o=t;o&&!e.test(o.className);)o=o.parentNode;o&&(i=(o.className.match(e)||[,""])[1].toLowerCase(),l=n.languages[i]),t.className=t.className.replace(e,"").replace(/\s+/g," ")+" language-"+i,o=t.parentNode,/pre/i.test(o.nodeName)&&(o.className=o.className.replace(e,"").replace(/\s+/g," ")+" language-"+i);var s=t.textContent,u={element:t,language:i,grammar:l,code:s};if(n.hooks.run("before-sanity-check",u),!u.code||!u.grammar)return u.code&&(u.element.textContent=u.code),n.hooks.run("complete",u),void 0;if(n.hooks.run("before-highlight",u),a&&_self.Worker){var g=new Worker(n.filename);g.onmessage=function(e){u.highlightedCode=e.data,n.hooks.run("before-insert",u),u.element.innerHTML=u.highlightedCode,r&&r.call(u.element),n.hooks.run("after-highlight",u),n.hooks.run("complete",u)},g.postMessage(JSON.stringify({language:u.language,code:u.code,immediateClose:!0}))}else u.highlightedCode=n.highlight(u.code,u.grammar,u.language),n.hooks.run("before-insert",u),u.element.innerHTML=u.highlightedCode,r&&r.call(t),n.hooks.run("after-highlight",u),n.hooks.run("complete",u)},highlight:function(e,t,r){var i=n.tokenize(e,t);return a.stringify(n.util.encode(i),r)},tokenize:function(e,t){var a=n.Token,r=[e],i=t.rest;if(i){for(var l in i)t[l]=i[l];delete t.rest}e:for(var l in t)if(t.hasOwnProperty(l)&&t[l]){var o=t[l];o="Array"===n.util.type(o)?o:[o];for(var s=0;s<o.length;++s){var u=o[s],g=u.inside,c=!!u.lookbehind,h=!!u.greedy,f=0,d=u.alias;if(h&&!u.pattern.global){var p=u.pattern.toString().match(/[imuy]*$/)[0];u.pattern=RegExp(u.pattern.source,p+"g")}u=u.pattern||u;for(var m=0,y=0;m<r.length;y+=r[m].length,++m){var v=r[m];if(r.length>e.length)break e;if(!(v instanceof a)){u.lastIndex=0;var b=u.exec(v),k=1;if(!b&&h&&m!=r.length-1){if(u.lastIndex=y,b=u.exec(e),!b)break;for(var w=b.index+(c?b[1].length:0),_=b.index+b[0].length,A=m,P=y,j=r.length;j>A&&_>P;++A)P+=r[A].length,w>=P&&(++m,y=P);if(r[m]instanceof a||r[A-1].greedy)continue;k=A-m,v=e.slice(y,P),b.index-=y}if(b){c&&(f=b[1].length);var w=b.index+f,b=b[0].slice(f),_=w+b.length,x=v.slice(0,w),O=v.slice(_),S=[m,k];x&&S.push(x);var N=new a(l,g?n.tokenize(b,g):b,d,b,h);S.push(N),O&&S.push(O),Array.prototype.splice.apply(r,S)}}}}}return r},hooks:{all:{},add:function(e,t){var a=n.hooks.all;a[e]=a[e]||[],a[e].push(t)},run:function(e,t){var a=n.hooks.all[e];if(a&&a.length)for(var r,i=0;r=a[i++];)r(t)}}},a=n.Token=function(e,t,n,a,r){this.type=e,this.content=t,this.alias=n,this.length=0|(a||"").length,this.greedy=!!r};if(a.stringify=function(e,t,r){if("string"==typeof e)return e;if("Array"===n.util.type(e))return e.map(function(n){return a.stringify(n,t,e)}).join("");var i={type:e.type,content:a.stringify(e.content,t,r),tag:"span",classes:["token",e.type],attributes:{},language:t,parent:r};if("comment"==i.type&&(i.attributes.spellcheck="true"),e.alias){var l="Array"===n.util.type(e.alias)?e.alias:[e.alias];Array.prototype.push.apply(i.classes,l)}n.hooks.run("wrap",i);var o=Object.keys(i.attributes).map(function(e){return e+'="'+(i.attributes[e]||"").replace(/"/g,"&quot;")+'"'}).join(" ");return"<"+i.tag+' class="'+i.classes.join(" ")+'"'+(o?" "+o:"")+">"+i.content+"</"+i.tag+">"},!_self.document)return _self.addEventListener?(_self.addEventListener("message",function(e){var t=JSON.parse(e.data),a=t.language,r=t.code,i=t.immediateClose;_self.postMessage(n.highlight(r,n.languages[a],a)),i&&_self.close()},!1),_self.Prism):_self.Prism;var r=document.currentScript||[].slice.call(document.getElementsByTagName("script")).pop();return r&&(n.filename=r.src,document.addEventListener&&!r.hasAttribute("data-manual")&&("loading"!==document.readyState?window.requestAnimationFrame?window.requestAnimationFrame(n.highlightAll):window.setTimeout(n.highlightAll,16):document.addEventListener("DOMContentLoaded",n.highlightAll))),_self.Prism}();"undefined"!=typeof module&&module.exports&&(module.exports=Prism),"undefined"!=typeof global&&(global.Prism=Prism);
+Prism.languages.markup={comment:/<!--[\w\W]*?-->/,prolog:/<\?[\w\W]+?\?>/,doctype:/<!DOCTYPE[\w\W]+?>/i,cdata:/<!\[CDATA\[[\w\W]*?]]>/i,tag:{pattern:/<\/?(?!\d)[^\s>\/=$<]+(?:\s+[^\s>\/=]+(?:=(?:("|')(?:\\\1|\\?(?!\1)[\w\W])*\1|[^\s'">=]+))?)*\s*\/?>/i,inside:{tag:{pattern:/^<\/?[^\s>\/]+/i,inside:{punctuation:/^<\/?/,namespace:/^[^\s>\/:]+:/}},"attr-value":{pattern:/=(?:('|")[\w\W]*?(\1)|[^\s>]+)/i,inside:{punctuation:/[=>"']/}},punctuation:/\/?>/,"attr-name":{pattern:/[^\s>\/]+/,inside:{namespace:/^[^\s>\/:]+:/}}}},entity:/&#?[\da-z]{1,8};/i},Prism.hooks.add("wrap",function(a){"entity"===a.type&&(a.attributes.title=a.content.replace(/&amp;/,"&"))}),Prism.languages.xml=Prism.languages.markup,Prism.languages.html=Prism.languages.markup,Prism.languages.mathml=Prism.languages.markup,Prism.languages.svg=Prism.languages.markup;
+Prism.languages.css={comment:/\/\*[\w\W]*?\*\//,atrule:{pattern:/@[\w-]+?.*?(;|(?=\s*\{))/i,inside:{rule:/@[\w-]+/}},url:/url\((?:(["'])(\\(?:\r\n|[\w\W])|(?!\1)[^\\\r\n])*\1|.*?)\)/i,selector:/[^\{\}\s][^\{\};]*?(?=\s*\{)/,string:{pattern:/("|')(\\(?:\r\n|[\w\W])|(?!\1)[^\\\r\n])*\1/,greedy:!0},property:/(\b|\B)[\w-]+(?=\s*:)/i,important:/\B!important\b/i,"function":/[-a-z0-9]+(?=\()/i,punctuation:/[(){};:]/},Prism.languages.css.atrule.inside.rest=Prism.util.clone(Prism.languages.css),Prism.languages.markup&&(Prism.languages.insertBefore("markup","tag",{style:{pattern:/(<style[\w\W]*?>)[\w\W]*?(?=<\/style>)/i,lookbehind:!0,inside:Prism.languages.css,alias:"language-css"}}),Prism.languages.insertBefore("inside","attr-value",{"style-attr":{pattern:/\s*style=("|').*?\1/i,inside:{"attr-name":{pattern:/^\s*style/i,inside:Prism.languages.markup.tag.inside},punctuation:/^\s*=\s*['"]|['"]\s*$/,"attr-value":{pattern:/.+/i,inside:Prism.languages.css}},alias:"language-css"}},Prism.languages.markup.tag));
+Prism.languages.clike={comment:[{pattern:/(^|[^\\])\/\*[\w\W]*?\*\//,lookbehind:!0},{pattern:/(^|[^\\:])\/\/.*/,lookbehind:!0}],string:{pattern:/(["'])(\\(?:\r\n|[\s\S])|(?!\1)[^\\\r\n])*\1/,greedy:!0},"class-name":{pattern:/((?:\b(?:class|interface|extends|implements|trait|instanceof|new)\s+)|(?:catch\s+\())[a-z0-9_\.\\]+/i,lookbehind:!0,inside:{punctuation:/(\.|\\)/}},keyword:/\b(if|else|while|do|for|return|in|instanceof|function|new|try|throw|catch|finally|null|break|continue)\b/,"boolean":/\b(true|false)\b/,"function":/[a-z0-9_]+(?=\()/i,number:/\b-?(?:0x[\da-f]+|\d*\.?\d+(?:e[+-]?\d+)?)\b/i,operator:/--?|\+\+?|!=?=?|<=?|>=?|==?=?|&&?|\|\|?|\?|\*|\/|~|\^|%/,punctuation:/[{}[\];(),.:]/};
+Prism.languages.javascript=Prism.languages.extend("clike",{keyword:/\b(as|async|await|break|case|catch|class|const|continue|debugger|default|delete|do|else|enum|export|extends|finally|for|from|function|get|if|implements|import|in|instanceof|interface|let|new|null|of|package|private|protected|public|return|set|static|super|switch|this|throw|try|typeof|var|void|while|with|yield)\b/,number:/\b-?(0x[\dA-Fa-f]+|0b[01]+|0o[0-7]+|\d*\.?\d+([Ee][+-]?\d+)?|NaN|Infinity)\b/,"function":/[_$a-zA-Z\xA0-\uFFFF][_$a-zA-Z0-9\xA0-\uFFFF]*(?=\()/i,operator:/--?|\+\+?|!=?=?|<=?|>=?|==?=?|&&?|\|\|?|\?|\*\*?|\/|~|\^|%|\.{3}/}),Prism.languages.insertBefore("javascript","keyword",{regex:{pattern:/(^|[^\/])\/(?!\/)(\[.+?]|\\.|[^\/\\\r\n])+\/[gimyu]{0,5}(?=\s*($|[\r\n,.;})]))/,lookbehind:!0,greedy:!0}}),Prism.languages.insertBefore("javascript","string",{"template-string":{pattern:/`(?:\\\\|\\?[^\\])*?`/,greedy:!0,inside:{interpolation:{pattern:/\$\{[^}]+\}/,inside:{"interpolation-punctuation":{pattern:/^\$\{|\}$/,alias:"punctuation"},rest:Prism.languages.javascript}},string:/[\s\S]+/}}}),Prism.languages.markup&&Prism.languages.insertBefore("markup","tag",{script:{pattern:/(<script[\w\W]*?>)[\w\W]*?(?=<\/script>)/i,lookbehind:!0,inside:Prism.languages.javascript,alias:"language-javascript"}}),Prism.languages.js=Prism.languages.javascript;
+!function(a){var i={pattern:/(^[ \t]*)\[(?!\[)(?:(["'$`])(?:(?!\2)[^\\]|\\.)*\2|\[(?:[^\]\\]|\\.)*\]|[^\]\\]|\\.)*\]/m,lookbehind:!0,inside:{quoted:{pattern:/([$`])(?:(?!\1)[^\\]|\\.)*\1/,inside:{punctuation:/^[$`]|[$`]$/}},interpreted:{pattern:/'(?:[^'\\]|\\.)*'/,inside:{punctuation:/^'|'$/}},string:/"(?:[^"\\]|\\.)*"/,variable:/\w+(?==)/,punctuation:/^\[|\]$|,/,operator:/=/,"attr-value":/(?!^\s+$).+/}};a.languages.asciidoc={"comment-block":{pattern:/^(\/{4,})(?:\r?\n|\r)(?:[\s\S]*(?:\r?\n|\r))??\1/m,alias:"comment"},table:{pattern:/^\|={3,}(?:(?:\r?\n|\r).*)*?(?:\r?\n|\r)\|={3,}$/m,inside:{specifiers:{pattern:/(?!\|)(?:(?:(?:\d+(?:\.\d+)?|\.\d+)[+*])?(?:[<^>](?:\.[<^>])?|\.[<^>])?[a-z]*)(?=\|)/,alias:"attr-value"},punctuation:{pattern:/(^|[^\\])[|!]=*/,lookbehind:!0}}},"passthrough-block":{pattern:/^(\+{4,})(?:\r?\n|\r)(?:[\s\S]*(?:\r?\n|\r))??\1$/m,inside:{punctuation:/^\++|\++$/}},"literal-block":{pattern:/^(-{4,}|\.{4,})(?:\r?\n|\r)(?:[\s\S]*(?:\r?\n|\r))??\1$/m,inside:{punctuation:/^(?:-+|\.+)|(?:-+|\.+)$/}},"other-block":{pattern:/^(--|\*{4,}|_{4,}|={4,})(?:\r?\n|\r)(?:[\s\S]*(?:\r?\n|\r))??\1$/m,inside:{punctuation:/^(?:-+|\*+|_+|=+)|(?:-+|\*+|_+|=+)$/}},"list-punctuation":{pattern:/(^[ \t]*)(?:-|\*{1,5}|\.{1,5}|(?:[a-z]|\d+)\.|[xvi]+\))(?= )/im,lookbehind:!0,alias:"punctuation"},"list-label":{pattern:/(^[ \t]*)[a-z\d].+(?::{2,4}|;;)(?=\s)/im,lookbehind:!0,alias:"symbol"},"indented-block":{pattern:/((\r?\n|\r)\2)([ \t]+)\S.*(?:(?:\r?\n|\r)\3.+)*(?=\2{2}|$)/,lookbehind:!0},comment:/^\/\/.*/m,title:{pattern:/^.+(?:\r?\n|\r)(?:={3,}|-{3,}|~{3,}|\^{3,}|\+{3,})$|^={1,5} +.+|^\.(?![\s.]).*/m,alias:"important",inside:{punctuation:/^(?:\.|=+)|(?:=+|-+|~+|\^+|\++)$/}},"attribute-entry":{pattern:/^:[^:\r\n]+:(?: .*?(?: \+(?:\r?\n|\r).*?)*)?$/m,alias:"tag"},attributes:i,hr:{pattern:/^'{3,}$/m,alias:"punctuation"},"page-break":{pattern:/^<{3,}$/m,alias:"punctuation"},admonition:{pattern:/^(?:TIP|NOTE|IMPORTANT|WARNING|CAUTION):/m,alias:"keyword"},callout:[{pattern:/(^[ \t]*)<?\d*>/m,lookbehind:!0,alias:"symbol"},{pattern:/<\d+>/,alias:"symbol"}],macro:{pattern:/\b[a-z\d][a-z\d-]*::?(?:(?:\S+)??\[(?:[^\]\\"]|(["'])(?:(?!\1)[^\\]|\\.)*\1|\\.)*\])/,inside:{"function":/^[a-z\d-]+(?=:)/,punctuation:/^::?/,attributes:{pattern:/(?:\[(?:[^\]\\"]|(["'])(?:(?!\1)[^\\]|\\.)*\1|\\.)*\])/,inside:i.inside}}},inline:{pattern:/(^|[^\\])(?:(?:\B\[(?:[^\]\\"]|(["'])(?:(?!\2)[^\\]|\\.)*\2|\\.)*\])?(?:\b_(?!\s)(?: _|[^_\\\r\n]|\\.)+(?:(?:\r?\n|\r)(?: _|[^_\\\r\n]|\\.)+)*_\b|\B``(?!\s).+?(?:(?:\r?\n|\r).+?)*''\B|\B`(?!\s)(?: ['`]|.)+?(?:(?:\r?\n|\r)(?: ['`]|.)+?)*['`]\B|\B(['*+#])(?!\s)(?: \3|(?!\3)[^\\\r\n]|\\.)+(?:(?:\r?\n|\r)(?: \3|(?!\3)[^\\\r\n]|\\.)+)*\3\B)|(?:\[(?:[^\]\\"]|(["'])(?:(?!\4)[^\\]|\\.)*\4|\\.)*\])?(?:(__|\*\*|\+\+\+?|##|\$\$|[~^]).+?(?:(?:\r?\n|\r).+?)*\5|\{[^}\r\n]+\}|\[\[\[?.+?(?:(?:\r?\n|\r).+?)*\]?\]\]|<<.+?(?:(?:\r?\n|\r).+?)*>>|\(\(\(?.+?(?:(?:\r?\n|\r).+?)*\)?\)\)))/m,lookbehind:!0,inside:{attributes:i,url:{pattern:/^(?:\[\[\[?.+?\]?\]\]|<<.+?>>)$/,inside:{punctuation:/^(?:\[\[\[?|<<)|(?:\]\]\]?|>>)$/}},"attribute-ref":{pattern:/^\{.+\}$/,inside:{variable:{pattern:/(^\{)[a-z\d,+_-]+/,lookbehind:!0},operator:/^[=?!#%@$]|!(?=[:}])/,punctuation:/^\{|\}$|::?/}},italic:{pattern:/^(['_])[\s\S]+\1$/,inside:{punctuation:/^(?:''?|__?)|(?:''?|__?)$/}},bold:{pattern:/^\*[\s\S]+\*$/,inside:{punctuation:/^\*\*?|\*\*?$/}},punctuation:/^(?:``?|\+{1,3}|##?|\$\$|[~^]|\(\(\(?)|(?:''?|\+{1,3}|##?|\$\$|[~^`]|\)?\)\))$/}},replacement:{pattern:/\((?:C|TM|R)\)/,alias:"builtin"},entity:/&#?[\da-z]{1,8};/i,"line-continuation":{pattern:/(^| )\+$/m,lookbehind:!0,alias:"punctuation"}},i.inside.interpreted.inside.rest={macro:a.languages.asciidoc.macro,inline:a.languages.asciidoc.inline,replacement:a.languages.asciidoc.replacement,entity:a.languages.asciidoc.entity},a.languages.asciidoc["passthrough-block"].inside.rest={macro:a.languages.asciidoc.macro},a.languages.asciidoc["literal-block"].inside.rest={callout:a.languages.asciidoc.callout},a.languages.asciidoc.table.inside.rest={"comment-block":a.languages.asciidoc["comment-block"],"passthrough-block":a.languages.asciidoc["passthrough-block"],"literal-block":a.languages.asciidoc["literal-block"],"other-block":a.languages.asciidoc["other-block"],"list-punctuation":a.languages.asciidoc["list-punctuation"],"indented-block":a.languages.asciidoc["indented-block"],comment:a.languages.asciidoc.comment,title:a.languages.asciidoc.title,"attribute-entry":a.languages.asciidoc["attribute-entry"],attributes:a.languages.asciidoc.attributes,hr:a.languages.asciidoc.hr,"page-break":a.languages.asciidoc["page-break"],admonition:a.languages.asciidoc.admonition,"list-label":a.languages.asciidoc["list-label"],callout:a.languages.asciidoc.callout,macro:a.languages.asciidoc.macro,inline:a.languages.asciidoc.inline,replacement:a.languages.asciidoc.replacement,entity:a.languages.asciidoc.entity,"line-continuation":a.languages.asciidoc["line-continuation"]},a.languages.asciidoc["other-block"].inside.rest={table:a.languages.asciidoc.table,"list-punctuation":a.languages.asciidoc["list-punctuation"],"indented-block":a.languages.asciidoc["indented-block"],comment:a.languages.asciidoc.comment,"attribute-entry":a.languages.asciidoc["attribute-entry"],attributes:a.languages.asciidoc.attributes,hr:a.languages.asciidoc.hr,"page-break":a.languages.asciidoc["page-break"],admonition:a.languages.asciidoc.admonition,"list-label":a.languages.asciidoc["list-label"],macro:a.languages.asciidoc.macro,inline:a.languages.asciidoc.inline,replacement:a.languages.asciidoc.replacement,entity:a.languages.asciidoc.entity,"line-continuation":a.languages.asciidoc["line-continuation"]},a.languages.asciidoc.title.inside.rest={macro:a.languages.asciidoc.macro,inline:a.languages.asciidoc.inline,replacement:a.languages.asciidoc.replacement,entity:a.languages.asciidoc.entity},a.hooks.add("wrap",function(a){"entity"===a.type&&(a.attributes.title=a.content.replace(/&amp;/,"&"))})}(Prism),Prism.languages.adoc=Prism.languages.asciidoc;
+!function(e){var t={variable:[{pattern:/\$?\(\([\w\W]+?\)\)/,inside:{variable:[{pattern:/(^\$\(\([\w\W]+)\)\)/,lookbehind:!0},/^\$\(\(/],number:/\b-?(?:0x[\dA-Fa-f]+|\d*\.?\d+(?:[Ee]-?\d+)?)\b/,operator:/--?|-=|\+\+?|\+=|!=?|~|\*\*?|\*=|\/=?|%=?|<<=?|>>=?|<=?|>=?|==?|&&?|&=|\^=?|\|\|?|\|=|\?|:/,punctuation:/\(\(?|\)\)?|,|;/}},{pattern:/\$\([^)]+\)|`[^`]+`/,inside:{variable:/^\$\(|^`|\)$|`$/}},/\$(?:[a-z0-9_#\?\*!@]+|\{[^}]+\})/i]};e.languages.bash={shebang:{pattern:/^#!\s*\/bin\/bash|^#!\s*\/bin\/sh/,alias:"important"},comment:{pattern:/(^|[^"{\\])#.*/,lookbehind:!0},string:[{pattern:/((?:^|[^<])<<\s*)(?:"|')?(\w+?)(?:"|')?\s*\r?\n(?:[\s\S])*?\r?\n\2/g,lookbehind:!0,greedy:!0,inside:t},{pattern:/(["'])(?:\\\\|\\?[^\\])*?\1/g,greedy:!0,inside:t}],variable:t.variable,"function":{pattern:/(^|\s|;|\||&)(?:alias|apropos|apt-get|aptitude|aspell|awk|basename|bash|bc|bg|builtin|bzip2|cal|cat|cd|cfdisk|chgrp|chmod|chown|chroot|chkconfig|cksum|clear|cmp|comm|command|cp|cron|crontab|csplit|cut|date|dc|dd|ddrescue|df|diff|diff3|dig|dir|dircolors|dirname|dirs|dmesg|du|egrep|eject|enable|env|ethtool|eval|exec|expand|expect|export|expr|fdformat|fdisk|fg|fgrep|file|find|fmt|fold|format|free|fsck|ftp|fuser|gawk|getopts|git|grep|groupadd|groupdel|groupmod|groups|gzip|hash|head|help|hg|history|hostname|htop|iconv|id|ifconfig|ifdown|ifup|import|install|jobs|join|kill|killall|less|link|ln|locate|logname|logout|look|lpc|lpr|lprint|lprintd|lprintq|lprm|ls|lsof|make|man|mkdir|mkfifo|mkisofs|mknod|more|most|mount|mtools|mtr|mv|mmv|nano|netstat|nice|nl|nohup|notify-send|npm|nslookup|open|op|passwd|paste|pathchk|ping|pkill|popd|pr|printcap|printenv|printf|ps|pushd|pv|pwd|quota|quotacheck|quotactl|ram|rar|rcp|read|readarray|readonly|reboot|rename|renice|remsync|rev|rm|rmdir|rsync|screen|scp|sdiff|sed|seq|service|sftp|shift|shopt|shutdown|sleep|slocate|sort|source|split|ssh|stat|strace|su|sudo|sum|suspend|sync|tail|tar|tee|test|time|timeout|times|touch|top|traceroute|trap|tr|tsort|tty|type|ulimit|umask|umount|unalias|uname|unexpand|uniq|units|unrar|unshar|uptime|useradd|userdel|usermod|users|uuencode|uudecode|v|vdir|vi|vmstat|wait|watch|wc|wget|whereis|which|who|whoami|write|xargs|xdg-open|yes|zip)(?=$|\s|;|\||&)/,lookbehind:!0},keyword:{pattern:/(^|\s|;|\||&)(?:let|:|\.|if|then|else|elif|fi|for|break|continue|while|in|case|function|select|do|done|until|echo|exit|return|set|declare)(?=$|\s|;|\||&)/,lookbehind:!0},"boolean":{pattern:/(^|\s|;|\||&)(?:true|false)(?=$|\s|;|\||&)/,lookbehind:!0},operator:/&&?|\|\|?|==?|!=?|<<<?|>>|<=?|>=?|=~/,punctuation:/\$?\(\(?|\)\)?|\.\.|[{}[\];]/};var a=t.variable[1].inside;a["function"]=e.languages.bash["function"],a.keyword=e.languages.bash.keyword,a.boolean=e.languages.bash.boolean,a.operator=e.languages.bash.operator,a.punctuation=e.languages.bash.punctuation}(Prism);
+Prism.languages.c=Prism.languages.extend("clike",{keyword:/\b(asm|typeof|inline|auto|break|case|char|const|continue|default|do|double|else|enum|extern|float|for|goto|if|int|long|register|return|short|signed|sizeof|static|struct|switch|typedef|union|unsigned|void|volatile|while)\b/,operator:/\-[>-]?|\+\+?|!=?|<<?=?|>>?=?|==?|&&?|\|?\||[~^%?*\/]/,number:/\b-?(?:0x[\da-f]+|\d*\.?\d+(?:e[+-]?\d+)?)[ful]*\b/i}),Prism.languages.insertBefore("c","string",{macro:{pattern:/(^\s*)#\s*[a-z]+([^\r\n\\]|\\.|\\(?:\r\n?|\n))*/im,lookbehind:!0,alias:"property",inside:{string:{pattern:/(#\s*include\s*)(<.+?>|("|')(\\?.)+?\3)/,lookbehind:!0},directive:{pattern:/(#\s*)\b(define|elif|else|endif|error|ifdef|ifndef|if|import|include|line|pragma|undef|using)\b/,lookbehind:!0,alias:"keyword"}}},constant:/\b(__FILE__|__LINE__|__DATE__|__TIME__|__TIMESTAMP__|__func__|EOF|NULL|stdin|stdout|stderr)\b/}),delete Prism.languages.c["class-name"],delete Prism.languages.c["boolean"];
+Prism.languages.csharp=Prism.languages.extend("clike",{keyword:/\b(abstract|as|async|await|base|bool|break|byte|case|catch|char|checked|class|const|continue|decimal|default|delegate|do|double|else|enum|event|explicit|extern|false|finally|fixed|float|for|foreach|goto|if|implicit|in|int|interface|internal|is|lock|long|namespace|new|null|object|operator|out|override|params|private|protected|public|readonly|ref|return|sbyte|sealed|short|sizeof|stackalloc|static|string|struct|switch|this|throw|true|try|typeof|uint|ulong|unchecked|unsafe|ushort|using|virtual|void|volatile|while|add|alias|ascending|async|await|descending|dynamic|from|get|global|group|into|join|let|orderby|partial|remove|select|set|value|var|where|yield)\b/,string:[/@("|')(\1\1|\\\1|\\?(?!\1)[\s\S])*\1/,/("|')(\\?.)*?\1/],number:/\b-?(0x[\da-f]+|\d*\.?\d+f?)\b/i}),Prism.languages.insertBefore("csharp","keyword",{"generic-method":{pattern:/[a-z0-9_]+\s*<[^>\r\n]+?>\s*(?=\()/i,alias:"function",inside:{keyword:Prism.languages.csharp.keyword,punctuation:/[<>(),.:]/}},preprocessor:{pattern:/(^\s*)#.*/m,lookbehind:!0,alias:"property",inside:{directive:{pattern:/(\s*#)\b(define|elif|else|endif|endregion|error|if|line|pragma|region|undef|warning)\b/,lookbehind:!0,alias:"keyword"}}}});
+Prism.languages.cpp=Prism.languages.extend("c",{keyword:/\b(alignas|alignof|asm|auto|bool|break|case|catch|char|char16_t|char32_t|class|compl|const|constexpr|const_cast|continue|decltype|default|delete|do|double|dynamic_cast|else|enum|explicit|export|extern|float|for|friend|goto|if|inline|int|long|mutable|namespace|new|noexcept|nullptr|operator|private|protected|public|register|reinterpret_cast|return|short|signed|sizeof|static|static_assert|static_cast|struct|switch|template|this|thread_local|throw|try|typedef|typeid|typename|union|unsigned|using|virtual|void|volatile|wchar_t|while)\b/,"boolean":/\b(true|false)\b/,operator:/[-+]{1,2}|!=?|<{1,2}=?|>{1,2}=?|\->|:{1,2}|={1,2}|\^|~|%|&{1,2}|\|?\||\?|\*|\/|\b(and|and_eq|bitand|bitor|not|not_eq|or|or_eq|xor|xor_eq)\b/}),Prism.languages.insertBefore("cpp","keyword",{"class-name":{pattern:/(class\s+)[a-z0-9_]+/i,lookbehind:!0}});
+!function(e){e.languages.ruby=e.languages.extend("clike",{comment:/#(?!\{[^\r\n]*?\}).*/,keyword:/\b(alias|and|BEGIN|begin|break|case|class|def|define_method|defined|do|each|else|elsif|END|end|ensure|false|for|if|in|module|new|next|nil|not|or|raise|redo|require|rescue|retry|return|self|super|then|throw|true|undef|unless|until|when|while|yield)\b/});var n={pattern:/#\{[^}]+\}/,inside:{delimiter:{pattern:/^#\{|\}$/,alias:"tag"},rest:e.util.clone(e.languages.ruby)}};e.languages.insertBefore("ruby","keyword",{regex:[{pattern:/%r([^a-zA-Z0-9\s\{\(\[<])(?:[^\\]|\\[\s\S])*?\1[gim]{0,3}/,inside:{interpolation:n}},{pattern:/%r\((?:[^()\\]|\\[\s\S])*\)[gim]{0,3}/,inside:{interpolation:n}},{pattern:/%r\{(?:[^#{}\\]|#(?:\{[^}]+\})?|\\[\s\S])*\}[gim]{0,3}/,inside:{interpolation:n}},{pattern:/%r\[(?:[^\[\]\\]|\\[\s\S])*\][gim]{0,3}/,inside:{interpolation:n}},{pattern:/%r<(?:[^<>\\]|\\[\s\S])*>[gim]{0,3}/,inside:{interpolation:n}},{pattern:/(^|[^\/])\/(?!\/)(\[.+?]|\\.|[^\/\r\n])+\/[gim]{0,3}(?=\s*($|[\r\n,.;})]))/,lookbehind:!0}],variable:/[@$]+[a-zA-Z_][a-zA-Z_0-9]*(?:[?!]|\b)/,symbol:/:[a-zA-Z_][a-zA-Z_0-9]*(?:[?!]|\b)/}),e.languages.insertBefore("ruby","number",{builtin:/\b(Array|Bignum|Binding|Class|Continuation|Dir|Exception|FalseClass|File|Stat|File|Fixnum|Float|Hash|Integer|IO|MatchData|Method|Module|NilClass|Numeric|Object|Proc|Range|Regexp|String|Struct|TMS|Symbol|ThreadGroup|Thread|Time|TrueClass)\b/,constant:/\b[A-Z][a-zA-Z_0-9]*(?:[?!]|\b)/}),e.languages.ruby.string=[{pattern:/%[qQiIwWxs]?([^a-zA-Z0-9\s\{\(\[<])(?:[^\\]|\\[\s\S])*?\1/,greedy:!0,inside:{interpolation:n}},{pattern:/%[qQiIwWxs]?\((?:[^()\\]|\\[\s\S])*\)/,greedy:!0,inside:{interpolation:n}},{pattern:/%[qQiIwWxs]?\{(?:[^#{}\\]|#(?:\{[^}]+\})?|\\[\s\S])*\}/,greedy:!0,inside:{interpolation:n}},{pattern:/%[qQiIwWxs]?\[(?:[^\[\]\\]|\\[\s\S])*\]/,greedy:!0,inside:{interpolation:n}},{pattern:/%[qQiIwWxs]?<(?:[^<>\\]|\\[\s\S])*>/,greedy:!0,inside:{interpolation:n}},{pattern:/("|')(#\{[^}]+\}|\\(?:\r?\n|\r)|\\?.)*?\1/,greedy:!0,inside:{interpolation:n}}]}(Prism);
+Prism.languages.docker={keyword:{pattern:/(^\s*)(?:ONBUILD|FROM|MAINTAINER|RUN|EXPOSE|ENV|ADD|COPY|VOLUME|USER|WORKDIR|CMD|LABEL|ENTRYPOINT)(?=\s)/im,lookbehind:!0},string:/("|')(?:(?!\1)[^\\\r\n]|\\(?:\r\n|[\s\S]))*?\1/,comment:/#.*/,punctuation:/---|\.\.\.|[:[\]{}\-,|>?]/};
+Prism.languages.ebnf={ruleheading:/([A-Z])\w.+?(:|\*:)\s/,literal:/'.+?'/,actions:{pattern:/{[A-Za-z].+?}/,inside:{ebnfkeyword:/fragment|true|false|current/}},ruleterminal:/;/,semi:/(s|S)emi/,multilinecomment:[{pattern:/(^|[^\\])\/\*[\w\W]*?\*\//,lookbehind:!0},{pattern:/(^|[^\\:])\/\/.*/,lookbehind:!0}],type:{pattern:/\[.+\]/,inside:{typereference:/[^\]+?[^\|]+/}},rulestructure:/(\?|\(|\)|\*|\||(\+^=))/,ebnfkeyword:/fragment|true|false|current/},Prism.languages.xtext=Prism.languages.ebnf;
+Prism.languages.git={comment:/^#.*/m,deleted:/^[-–].*/m,inserted:/^\+.*/m,string:/("|')(\\?.)*?\1/m,command:{pattern:/^.*\$ git .*$/m,inside:{parameter:/\s(--|-)\w+/m}},coord:/^@@.*@@$/m,commit_sha1:/^commit \w{40}$/m};
+Prism.languages.go=Prism.languages.extend("clike",{keyword:/\b(break|case|chan|const|continue|default|defer|else|fallthrough|for|func|go(to)?|if|import|interface|map|package|range|return|select|struct|switch|type|var)\b/,builtin:/\b(bool|byte|complex(64|128)|error|float(32|64)|rune|string|u?int(8|16|32|64|)|uintptr|append|cap|close|complex|copy|delete|imag|len|make|new|panic|print(ln)?|real|recover)\b/,"boolean":/\b(_|iota|nil|true|false)\b/,operator:/[*\/%^!=]=?|\+[=+]?|-[=-]?|\|[=|]?|&(?:=|&|\^=?)?|>(?:>=?|=)?|<(?:<=?|=|-)?|:=|\.\.\./,number:/\b(-?(0x[a-f\d]+|(\d+\.?\d*|\.\d+)(e[-+]?\d+)?)i?)\b/i,string:/("|'|`)(\\?.|\r|\n)*?\1/}),delete Prism.languages.go["class-name"];
+Prism.languages.groovy=Prism.languages.extend("clike",{keyword:/\b(as|def|in|abstract|assert|boolean|break|byte|case|catch|char|class|const|continue|default|do|double|else|enum|extends|final|finally|float|for|goto|if|implements|import|instanceof|int|interface|long|native|new|package|private|protected|public|return|short|static|strictfp|super|switch|synchronized|this|throw|throws|trait|transient|try|void|volatile|while)\b/,string:[{pattern:/("""|''')[\W\w]*?\1|(\$\/)(\$\/\$|[\W\w])*?\/\$/,greedy:!0},{pattern:/("|'|\/)(?:\\?.)*?\1/,greedy:!0}],number:/\b(?:0b[01_]+|0x[\da-f_]+(?:\.[\da-f_p\-]+)?|[\d_]+(?:\.[\d_]+)?(?:e[+-]?[\d]+)?)[glidf]?\b/i,operator:{pattern:/(^|[^.])(~|==?~?|\?[.:]?|\*(?:[.=]|\*=?)?|\.[@&]|\.\.<|\.{1,2}(?!\.)|-[-=>]?|\+[+=]?|!=?|<(?:<=?|=>?)?|>(?:>>?=?|=)?|&[&=]?|\|[|=]?|\/=?|\^=?|%=?)/,lookbehind:!0},punctuation:/\.+|[{}[\];(),:$]/}),Prism.languages.insertBefore("groovy","string",{shebang:{pattern:/#!.+/,alias:"comment"}}),Prism.languages.insertBefore("groovy","punctuation",{"spock-block":/\b(setup|given|when|then|and|cleanup|expect|where):/}),Prism.languages.insertBefore("groovy","function",{annotation:{alias:"punctuation",pattern:/(^|[^.])@\w+/,lookbehind:!0}}),Prism.hooks.add("wrap",function(e){if("groovy"===e.language&&"string"===e.type){var t=e.content[0];if("'"!=t){var n=/([^\\])(\$(\{.*?\}|[\w\.]+))/;"$"===t&&(n=/([^\$])(\$(\{.*?\}|[\w\.]+))/),e.content=e.content.replace(/&lt;/g,"<").replace(/&amp;/g,"&"),e.content=Prism.highlight(e.content,{expression:{pattern:n,lookbehind:!0,inside:Prism.languages.groovy}}),e.classes.push("/"===t?"regex":"gstring")}}});
+Prism.languages.http={"request-line":{pattern:/^(POST|GET|PUT|DELETE|OPTIONS|PATCH|TRACE|CONNECT)\b\shttps?:\/\/\S+\sHTTP\/[0-9.]+/m,inside:{property:/^(POST|GET|PUT|DELETE|OPTIONS|PATCH|TRACE|CONNECT)\b/,"attr-name":/:\w+/}},"response-status":{pattern:/^HTTP\/1.[01] [0-9]+.*/m,inside:{property:{pattern:/(^HTTP\/1.[01] )[0-9]+.*/i,lookbehind:!0}}},"header-name":{pattern:/^[\w-]+:(?=.)/m,alias:"keyword"}};var httpLanguages={"application/json":Prism.languages.javascript,"application/xml":Prism.languages.markup,"text/xml":Prism.languages.markup,"text/html":Prism.languages.markup};for(var contentType in httpLanguages)if(httpLanguages[contentType]){var options={};options[contentType]={pattern:new RegExp("(content-type:\\s*"+contentType+"[\\w\\W]*?)(?:\\r?\\n|\\r){2}[\\w\\W]*","i"),lookbehind:!0,inside:{rest:httpLanguages[contentType]}},Prism.languages.insertBefore("http","header-name",options)};
+Prism.languages.ini={comment:/^[ \t]*;.*$/m,selector:/^[ \t]*\[.*?\]/m,constant:/^[ \t]*[^\s=]+?(?=[ \t]*=)/m,"attr-value":{pattern:/=.*/,inside:{punctuation:/^[=]/}}};
+Prism.languages.java=Prism.languages.extend("clike",{keyword:/\b(abstract|continue|for|new|switch|assert|default|goto|package|synchronized|boolean|do|if|private|this|break|double|implements|protected|throw|byte|else|import|public|throws|case|enum|instanceof|return|transient|catch|extends|int|short|try|char|final|interface|static|void|class|finally|long|strictfp|volatile|const|float|native|super|while)\b/,number:/\b0b[01]+\b|\b0x[\da-f]*\.?[\da-fp\-]+\b|\b\d*\.?\d+(?:e[+-]?\d+)?[df]?\b/i,operator:{pattern:/(^|[^.])(?:\+[+=]?|-[-=]?|!=?|<<?=?|>>?>?=?|==?|&[&=]?|\|[|=]?|\*=?|\/=?|%=?|\^=?|[?:~])/m,lookbehind:!0}}),Prism.languages.insertBefore("java","function",{annotation:{alias:"punctuation",pattern:/(^|[^.])@\w+/,lookbehind:!0}});
+Prism.languages.json={property:/"(?:\\.|[^|"])*"(?=\s*:)/gi,string:/"(?!:)(?:\\.|[^|"])*"(?!:)/g,number:/\b-?(0x[\dA-Fa-f]+|\d*\.?\d+([Ee][+-]?\d+)?)\b/g,punctuation:/[{}[\]);,]/g,operator:/:/g,"boolean":/\b(true|false)\b/gi,"null":/\bnull\b/gi},Prism.languages.jsonp=Prism.languages.json;
+!function(a){var e=/\\([^a-z()[\]]|[a-z\*]+)/i,n={"equation-command":{pattern:e,alias:"regex"}};a.languages.latex={comment:/%.*/m,cdata:{pattern:/(\\begin\{((?:verbatim|lstlisting)\*?)\})([\w\W]*?)(?=\\end\{\2\})/,lookbehind:!0},equation:[{pattern:/\$(?:\\?[\w\W])*?\$|\\\((?:\\?[\w\W])*?\\\)|\\\[(?:\\?[\w\W])*?\\\]/,inside:n,alias:"string"},{pattern:/(\\begin\{((?:equation|math|eqnarray|align|multline|gather)\*?)\})([\w\W]*?)(?=\\end\{\2\})/,lookbehind:!0,inside:n,alias:"string"}],keyword:{pattern:/(\\(?:begin|end|ref|cite|label|usepackage|documentclass)(?:\[[^\]]+\])?\{)[^}]+(?=\})/,lookbehind:!0},url:{pattern:/(\\url\{)[^}]+(?=\})/,lookbehind:!0},headline:{pattern:/(\\(?:part|chapter|section|subsection|frametitle|subsubsection|paragraph|subparagraph|subsubparagraph|subsubsubparagraph)\*?(?:\[[^\]]+\])?\{)[^}]+(?=\}(?:\[[^\]]+\])?)/,lookbehind:!0,alias:"class-name"},"function":{pattern:e,alias:"selector"},punctuation:/[[\]{}&]/}}(Prism);
+Prism.languages.lua={comment:/^#!.+|--(?:\[(=*)\[[\s\S]*?\]\1\]|.*)/m,string:{pattern:/(["'])(?:(?!\1)[^\\\r\n]|\\z(?:\r\n|\s)|\\(?:\r\n|[\s\S]))*\1|\[(=*)\[[\s\S]*?\]\2\]/,greedy:!0},number:/\b0x[a-f\d]+\.?[a-f\d]*(?:p[+-]?\d+)?\b|\b\d+(?:\.\B|\.?\d*(?:e[+-]?\d+)?\b)|\B\.\d+(?:e[+-]?\d+)?\b/i,keyword:/\b(?:and|break|do|else|elseif|end|false|for|function|goto|if|in|local|nil|not|or|repeat|return|then|true|until|while)\b/,"function":/(?!\d)\w+(?=\s*(?:[({]))/,operator:[/[-+*%^&|#]|\/\/?|<[<=]?|>[>=]?|[=~]=?/,{pattern:/(^|[^.])\.\.(?!\.)/,lookbehind:!0}],punctuation:/[\[\](){},;]|\.+|:+/};
+Prism.languages.markdown=Prism.languages.extend("markup",{}),Prism.languages.insertBefore("markdown","prolog",{blockquote:{pattern:/^>(?:[\t ]*>)*/m,alias:"punctuation"},code:[{pattern:/^(?: {4}|\t).+/m,alias:"keyword"},{pattern:/``.+?``|`[^`\n]+`/,alias:"keyword"}],title:[{pattern:/\w+.*(?:\r?\n|\r)(?:==+|--+)/,alias:"important",inside:{punctuation:/==+$|--+$/}},{pattern:/(^\s*)#+.+/m,lookbehind:!0,alias:"important",inside:{punctuation:/^#+|#+$/}}],hr:{pattern:/(^\s*)([*-])([\t ]*\2){2,}(?=\s*$)/m,lookbehind:!0,alias:"punctuation"},list:{pattern:/(^\s*)(?:[*+-]|\d+\.)(?=[\t ].)/m,lookbehind:!0,alias:"punctuation"},"url-reference":{pattern:/!?\[[^\]]+\]:[\t ]+(?:\S+|<(?:\\.|[^>\\])+>)(?:[\t ]+(?:"(?:\\.|[^"\\])*"|'(?:\\.|[^'\\])*'|\((?:\\.|[^)\\])*\)))?/,inside:{variable:{pattern:/^(!?\[)[^\]]+/,lookbehind:!0},string:/(?:"(?:\\.|[^"\\])*"|'(?:\\.|[^'\\])*'|\((?:\\.|[^)\\])*\))$/,punctuation:/^[\[\]!:]|[<>]/},alias:"url"},bold:{pattern:/(^|[^\\])(\*\*|__)(?:(?:\r?\n|\r)(?!\r?\n|\r)|.)+?\2/,lookbehind:!0,inside:{punctuation:/^\*\*|^__|\*\*$|__$/}},italic:{pattern:/(^|[^\\])([*_])(?:(?:\r?\n|\r)(?!\r?\n|\r)|.)+?\2/,lookbehind:!0,inside:{punctuation:/^[*_]|[*_]$/}},url:{pattern:/!?\[[^\]]+\](?:\([^\s)]+(?:[\t ]+"(?:\\.|[^"\\])*")?\)| ?\[[^\]\n]*\])/,inside:{variable:{pattern:/(!?\[)[^\]]+(?=\]$)/,lookbehind:!0},string:{pattern:/"(?:\\.|[^"\\])*"(?=\)$)/}}}}),Prism.languages.markdown.bold.inside.url=Prism.util.clone(Prism.languages.markdown.url),Prism.languages.markdown.italic.inside.url=Prism.util.clone(Prism.languages.markdown.url),Prism.languages.markdown.bold.inside.italic=Prism.util.clone(Prism.languages.markdown.italic),Prism.languages.markdown.italic.inside.bold=Prism.util.clone(Prism.languages.markdown.bold);
+Prism.languages.n4js=Prism.languages.extend("javascript",{n4jsannotation:/@Binder|@Bind|@Test|@UseBinder|@This|@@ProvidedByRuntime|@@Global|@Inject|@Internal|@Undefined|@StringBased|@Final|@GenerateInjector|@WithParentInjector|@Spec|@Override|@Promisifiable|@Promisify|@This|@N4JS|@IgnoreImplementation|@Global|@ProvidedByRuntime|@TestAPI|@Polyfill|@StaticPolyfillAware|@StaticPolyfillModule|@StaticPolyfill|@Transient|@IDEBUG/,keyword:/\b(break|case|catch|class|const|continue|debugger|default|delete|do|else|enum|export|extends|false|finally|for|from|function|get|if|implements|import|in|instanceof|interface|let|new|null|package|private|protected|public|return|set|static|super|switch|this|throw|true|try|typeof|var|void|while|with|yield|module|declare|constructor|string|Function|any|number|boolean|Array|enum)\b/}),Prism.languages.ts=Prism.languages.n4js;
++!function(a){var e=a.util.clone(a.languages.n4js);a.languages.n4jsx=a.languages.extend("markup",e),a.languages.n4jsx.tag.pattern=/<\/?[\w\.:-]+\s*(?:\s+[\w\.:-]+(?:=(?:("|')(\\?[\w\W])*?\1|[^\s'">=]+|(\{[\w\W]*?\})))?\s*)*\/?>/i,a.languages.n4jsx.tag.inside["attr-value"].pattern=/=[^\{](?:('|")[\w\W]*?(\1)|[^\s>]+)/i;var s=a.util.clone(a.languages.n4jsx);delete s.punctuation,s=a.languages.insertBefore("n4jsx","operator",{punctuation:/=(?={)|[{}[\];(),.:]/},{n4jsx:s}),a.languages.insertBefore("inside","attr-value",{script:{pattern:/=(\{(?:\{[^}]*\}|[^}])+\})/i,inside:s,alias:"language-javascript"}},a.languages.n4jsx.tag)}(Prism);
+Prism.languages.n4mf=Prism.languages.extend("n4js",{keyword:/ProjectId|VendorId|VendorName|ProjectType|ProjectVersion|Output|Sources|TestedProjects|ProjectDependencies|RequiredRuntimeLibraries/i}),Prism.languages.json=Prism.languages.n4mf;
+Prism.languages.nginx=Prism.languages.extend("clike",{comment:{pattern:/(^|[^"{\\])#.*/,lookbehind:!0},keyword:/\b(?:CONTENT_|DOCUMENT_|GATEWAY_|HTTP_|HTTPS|if_not_empty|PATH_|QUERY_|REDIRECT_|REMOTE_|REQUEST_|SCGI|SCRIPT_|SERVER_|http|server|events|location|include|accept_mutex|accept_mutex_delay|access_log|add_after_body|add_before_body|add_header|addition_types|aio|alias|allow|ancient_browser|ancient_browser_value|auth|auth_basic|auth_basic_user_file|auth_http|auth_http_header|auth_http_timeout|autoindex|autoindex_exact_size|autoindex_localtime|break|charset|charset_map|charset_types|chunked_transfer_encoding|client_body_buffer_size|client_body_in_file_only|client_body_in_single_buffer|client_body_temp_path|client_body_timeout|client_header_buffer_size|client_header_timeout|client_max_body_size|connection_pool_size|create_full_put_path|daemon|dav_access|dav_methods|debug_connection|debug_points|default_type|deny|devpoll_changes|devpoll_events|directio|directio_alignment|disable_symlinks|empty_gif|env|epoll_events|error_log|error_page|expires|fastcgi_buffer_size|fastcgi_buffers|fastcgi_busy_buffers_size|fastcgi_cache|fastcgi_cache_bypass|fastcgi_cache_key|fastcgi_cache_lock|fastcgi_cache_lock_timeout|fastcgi_cache_methods|fastcgi_cache_min_uses|fastcgi_cache_path|fastcgi_cache_purge|fastcgi_cache_use_stale|fastcgi_cache_valid|fastcgi_connect_timeout|fastcgi_hide_header|fastcgi_ignore_client_abort|fastcgi_ignore_headers|fastcgi_index|fastcgi_intercept_errors|fastcgi_keep_conn|fastcgi_max_temp_file_size|fastcgi_next_upstream|fastcgi_no_cache|fastcgi_param|fastcgi_pass|fastcgi_pass_header|fastcgi_read_timeout|fastcgi_redirect_errors|fastcgi_send_timeout|fastcgi_split_path_info|fastcgi_store|fastcgi_store_access|fastcgi_temp_file_write_size|fastcgi_temp_path|flv|geo|geoip_city|geoip_country|google_perftools_profiles|gzip|gzip_buffers|gzip_comp_level|gzip_disable|gzip_http_version|gzip_min_length|gzip_proxied|gzip_static|gzip_types|gzip_vary|if|if_modified_since|ignore_invalid_headers|image_filter|image_filter_buffer|image_filter_jpeg_quality|image_filter_sharpen|image_filter_transparency|imap_capabilities|imap_client_buffer|include|index|internal|ip_hash|keepalive|keepalive_disable|keepalive_requests|keepalive_timeout|kqueue_changes|kqueue_events|large_client_header_buffers|limit_conn|limit_conn_log_level|limit_conn_zone|limit_except|limit_rate|limit_rate_after|limit_req|limit_req_log_level|limit_req_zone|limit_zone|lingering_close|lingering_time|lingering_timeout|listen|location|lock_file|log_format|log_format_combined|log_not_found|log_subrequest|map|map_hash_bucket_size|map_hash_max_size|master_process|max_ranges|memcached_buffer_size|memcached_connect_timeout|memcached_next_upstream|memcached_pass|memcached_read_timeout|memcached_send_timeout|merge_slashes|min_delete_depth|modern_browser|modern_browser_value|mp4|mp4_buffer_size|mp4_max_buffer_size|msie_padding|msie_refresh|multi_accept|open_file_cache|open_file_cache_errors|open_file_cache_min_uses|open_file_cache_valid|open_log_file_cache|optimize_server_names|override_charset|pcre_jit|perl|perl_modules|perl_require|perl_set|pid|pop3_auth|pop3_capabilities|port_in_redirect|post_action|postpone_output|protocol|proxy|proxy_buffer|proxy_buffer_size|proxy_buffering|proxy_buffers|proxy_busy_buffers_size|proxy_cache|proxy_cache_bypass|proxy_cache_key|proxy_cache_lock|proxy_cache_lock_timeout|proxy_cache_methods|proxy_cache_min_uses|proxy_cache_path|proxy_cache_use_stale|proxy_cache_valid|proxy_connect_timeout|proxy_cookie_domain|proxy_cookie_path|proxy_headers_hash_bucket_size|proxy_headers_hash_max_size|proxy_hide_header|proxy_http_version|proxy_ignore_client_abort|proxy_ignore_headers|proxy_intercept_errors|proxy_max_temp_file_size|proxy_method|proxy_next_upstream|proxy_no_cache|proxy_pass|proxy_pass_error_message|proxy_pass_header|proxy_pass_request_body|proxy_pass_request_headers|proxy_read_timeout|proxy_redirect|proxy_redirect_errors|proxy_send_lowat|proxy_send_timeout|proxy_set_body|proxy_set_header|proxy_ssl_session_reuse|proxy_store|proxy_store_access|proxy_temp_file_write_size|proxy_temp_path|proxy_timeout|proxy_upstream_fail_timeout|proxy_upstream_max_fails|random_index|read_ahead|real_ip_header|recursive_error_pages|request_pool_size|reset_timedout_connection|resolver|resolver_timeout|return|rewrite|root|rtsig_overflow_events|rtsig_overflow_test|rtsig_overflow_threshold|rtsig_signo|satisfy|satisfy_any|secure_link_secret|send_lowat|send_timeout|sendfile|sendfile_max_chunk|server|server_name|server_name_in_redirect|server_names_hash_bucket_size|server_names_hash_max_size|server_tokens|set|set_real_ip_from|smtp_auth|smtp_capabilities|so_keepalive|source_charset|split_clients|ssi|ssi_silent_errors|ssi_types|ssi_value_length|ssl|ssl_certificate|ssl_certificate_key|ssl_ciphers|ssl_client_certificate|ssl_crl|ssl_dhparam|ssl_engine|ssl_prefer_server_ciphers|ssl_protocols|ssl_session_cache|ssl_session_timeout|ssl_verify_client|ssl_verify_depth|starttls|stub_status|sub_filter|sub_filter_once|sub_filter_types|tcp_nodelay|tcp_nopush|timeout|timer_resolution|try_files|types|types_hash_bucket_size|types_hash_max_size|underscores_in_headers|uninitialized_variable_warn|upstream|use|user|userid|userid_domain|userid_expires|userid_name|userid_p3p|userid_path|userid_service|valid_referers|variables_hash_bucket_size|variables_hash_max_size|worker_connections|worker_cpu_affinity|worker_priority|worker_processes|worker_rlimit_core|worker_rlimit_nofile|worker_rlimit_sigpending|working_directory|xclient|xml_entities|xslt_entities|xslt_stylesheet|xslt_types)\b/i}),Prism.languages.insertBefore("nginx","keyword",{variable:/\$[a-z_]+/i});
+Prism.languages.nix={comment:/\/\*[\s\S]*?\*\/|#.*/,string:{pattern:/"(?:[^"\\]|\\[\s\S])*"|''(?:(?!'')[\s\S]|''(?:'|\\|\$\{))*''/,inside:{interpolation:{pattern:/(^|(?:^|(?!'').)[^\\])\$\{(?:[^}]|\{[^}]*\})*}/,lookbehind:!0,inside:{antiquotation:{pattern:/^\$(?=\{)/,alias:"variable"}}}}},url:[/\b(?:[a-z]{3,7}:\/\/)[\w\-+%~\/.:#=?&]+/,{pattern:/([^\/])(?:[\w\-+%~.:#=?&]*(?!\/\/)[\w\-+%~\/.:#=?&])?(?!\/\/)\/[\w\-+%~\/.:#=?&]*/,lookbehind:!0}],antiquotation:{pattern:/\$(?=\{)/,alias:"variable"},number:/\b\d+\b/,keyword:/\b(?:assert|builtins|else|if|in|inherit|let|null|or|then|with)\b/,"function":/\b(?:abort|add|all|any|attrNames|attrValues|baseNameOf|compareVersions|concatLists|currentSystem|deepSeq|derivation|dirOf|div|elem(?:At)?|fetch(?:url|Tarball)|filter(?:Source)?|fromJSON|genList|getAttr|getEnv|hasAttr|hashString|head|import|intersectAttrs|is(?:Attrs|Bool|Function|Int|List|Null|String)|length|lessThan|listToAttrs|map|mul|parseDrvName|pathExists|read(?:Dir|File)|removeAttrs|replaceStrings|seq|sort|stringLength|sub(?:string)?|tail|throw|to(?:File|JSON|Path|String|XML)|trace|typeOf)\b|\bfoldl'\B/,"boolean":/\b(?:true|false)\b/,operator:/[=!<>]=?|\+\+?|\|\||&&|\/\/|->?|[?@]/,punctuation:/[{}()[\].,:;]/},Prism.languages.nix.string.inside.interpolation.inside.rest=Prism.util.clone(Prism.languages.nix);
+Prism.languages.perl={comment:[{pattern:/(^\s*)=\w+[\s\S]*?=cut.*/m,lookbehind:!0},{pattern:/(^|[^\\$])#.*/,lookbehind:!0}],string:[/\b(?:q|qq|qx|qw)\s*([^a-zA-Z0-9\s\{\(\[<])(?:[^\\]|\\[\s\S])*?\1/,/\b(?:q|qq|qx|qw)\s+([a-zA-Z0-9])(?:[^\\]|\\[\s\S])*?\1/,/\b(?:q|qq|qx|qw)\s*\((?:[^()\\]|\\[\s\S])*\)/,/\b(?:q|qq|qx|qw)\s*\{(?:[^{}\\]|\\[\s\S])*\}/,/\b(?:q|qq|qx|qw)\s*\[(?:[^[\]\\]|\\[\s\S])*\]/,/\b(?:q|qq|qx|qw)\s*<(?:[^<>\\]|\\[\s\S])*>/,/("|`)(?:[^\\]|\\[\s\S])*?\1/,/'(?:[^'\\\r\n]|\\.)*'/],regex:[/\b(?:m|qr)\s*([^a-zA-Z0-9\s\{\(\[<])(?:[^\\]|\\[\s\S])*?\1[msixpodualngc]*/,/\b(?:m|qr)\s+([a-zA-Z0-9])(?:[^\\]|\\.)*?\1[msixpodualngc]*/,/\b(?:m|qr)\s*\((?:[^()\\]|\\[\s\S])*\)[msixpodualngc]*/,/\b(?:m|qr)\s*\{(?:[^{}\\]|\\[\s\S])*\}[msixpodualngc]*/,/\b(?:m|qr)\s*\[(?:[^[\]\\]|\\[\s\S])*\][msixpodualngc]*/,/\b(?:m|qr)\s*<(?:[^<>\\]|\\[\s\S])*>[msixpodualngc]*/,{pattern:/(^|[^-]\b)(?:s|tr|y)\s*([^a-zA-Z0-9\s\{\(\[<])(?:[^\\]|\\[\s\S])*?\2(?:[^\\]|\\[\s\S])*?\2[msixpodualngcer]*/,lookbehind:!0},{pattern:/(^|[^-]\b)(?:s|tr|y)\s+([a-zA-Z0-9])(?:[^\\]|\\[\s\S])*?\2(?:[^\\]|\\[\s\S])*?\2[msixpodualngcer]*/,lookbehind:!0},{pattern:/(^|[^-]\b)(?:s|tr|y)\s*\((?:[^()\\]|\\[\s\S])*\)\s*\((?:[^()\\]|\\[\s\S])*\)[msixpodualngcer]*/,lookbehind:!0},{pattern:/(^|[^-]\b)(?:s|tr|y)\s*\{(?:[^{}\\]|\\[\s\S])*\}\s*\{(?:[^{}\\]|\\[\s\S])*\}[msixpodualngcer]*/,lookbehind:!0},{pattern:/(^|[^-]\b)(?:s|tr|y)\s*\[(?:[^[\]\\]|\\[\s\S])*\]\s*\[(?:[^[\]\\]|\\[\s\S])*\][msixpodualngcer]*/,lookbehind:!0},{pattern:/(^|[^-]\b)(?:s|tr|y)\s*<(?:[^<>\\]|\\[\s\S])*>\s*<(?:[^<>\\]|\\[\s\S])*>[msixpodualngcer]*/,lookbehind:!0},/\/(?:[^\/\\\r\n]|\\.)*\/[msixpodualngc]*(?=\s*(?:$|[\r\n,.;})&|\-+*~<>!?^]|(lt|gt|le|ge|eq|ne|cmp|not|and|or|xor|x)\b))/],variable:[/[&*$@%]\{\^[A-Z]+\}/,/[&*$@%]\^[A-Z_]/,/[&*$@%]#?(?=\{)/,/[&*$@%]#?((::)*'?(?!\d)[\w$]+)+(::)*/i,/[&*$@%]\d+/,/(?!%=)[$@%][!"#$%&'()*+,\-.\/:;<=>?@[\\\]^_`{|}~]/],filehandle:{pattern:/<(?![<=])\S*>|\b_\b/,alias:"symbol"},vstring:{pattern:/v\d+(\.\d+)*|\d+(\.\d+){2,}/,alias:"string"},"function":{pattern:/sub [a-z0-9_]+/i,inside:{keyword:/sub/}},keyword:/\b(any|break|continue|default|delete|die|do|else|elsif|eval|for|foreach|given|goto|if|last|local|my|next|our|package|print|redo|require|say|state|sub|switch|undef|unless|until|use|when|while)\b/,number:/\b-?(0x[\dA-Fa-f](_?[\dA-Fa-f])*|0b[01](_?[01])*|(\d(_?\d)*)?\.?\d(_?\d)*([Ee][+-]?\d+)?)\b/,operator:/-[rwxoRWXOezsfdlpSbctugkTBMAC]\b|\+[+=]?|-[-=>]?|\*\*?=?|\/\/?=?|=[=~>]?|~[~=]?|\|\|?=?|&&?=?|<(?:=>?|<=?)?|>>?=?|![~=]?|[%^]=?|\.(?:=|\.\.?)?|[\\?]|\bx(?:=|\b)|\b(lt|gt|le|ge|eq|ne|cmp|not|and|or|xor)\b/,punctuation:/[{}[\];(),:]/};
+Prism.languages.php=Prism.languages.extend("clike",{keyword:/\b(and|or|xor|array|as|break|case|cfunction|class|const|continue|declare|default|die|do|else|elseif|enddeclare|endfor|endforeach|endif|endswitch|endwhile|extends|for|foreach|function|include|include_once|global|if|new|return|static|switch|use|require|require_once|var|while|abstract|interface|public|implements|private|protected|parent|throw|null|echo|print|trait|namespace|final|yield|goto|instanceof|finally|try|catch)\b/i,constant:/\b[A-Z0-9_]{2,}\b/,comment:{pattern:/(^|[^\\])(?:\/\*[\w\W]*?\*\/|\/\/.*)/,lookbehind:!0,greedy:!0}}),Prism.languages.insertBefore("php","class-name",{"shell-comment":{pattern:/(^|[^\\])#.*/,lookbehind:!0,alias:"comment"}}),Prism.languages.insertBefore("php","keyword",{delimiter:/\?>|<\?(?:php)?/i,variable:/\$\w+\b/i,"package":{pattern:/(\\|namespace\s+|use\s+)[\w\\]+/,lookbehind:!0,inside:{punctuation:/\\/}}}),Prism.languages.insertBefore("php","operator",{property:{pattern:/(->)[\w]+/,lookbehind:!0}}),Prism.languages.markup&&(Prism.hooks.add("before-highlight",function(e){"php"===e.language&&(e.tokenStack=[],e.backupCode=e.code,e.code=e.code.replace(/(?:<\?php|<\?)[\w\W]*?(?:\?>)/gi,function(a){return e.tokenStack.push(a),"{{{PHP"+e.tokenStack.length+"}}}"}))}),Prism.hooks.add("before-insert",function(e){"php"===e.language&&(e.code=e.backupCode,delete e.backupCode)}),Prism.hooks.add("after-highlight",function(e){if("php"===e.language){for(var a,n=0;a=e.tokenStack[n];n++)e.highlightedCode=e.highlightedCode.replace("{{{PHP"+(n+1)+"}}}",Prism.highlight(a,e.grammar,"php").replace(/\$/g,"$$$$"));e.element.innerHTML=e.highlightedCode}}),Prism.hooks.add("wrap",function(e){"php"===e.language&&"markup"===e.type&&(e.content=e.content.replace(/(\{\{\{PHP[0-9]+\}\}\})/g,'<span class="token php">$1</span>'))}),Prism.languages.insertBefore("php","comment",{markup:{pattern:/<[^?]\/?(.*?)>/,inside:Prism.languages.markup},php:/\{\{\{PHP[0-9]+\}\}\}/}));
+Prism.languages.insertBefore("php","variable",{"this":/\$this\b/,global:/\$(?:_(?:SERVER|GET|POST|FILES|REQUEST|SESSION|ENV|COOKIE)|GLOBALS|HTTP_RAW_POST_DATA|argc|argv|php_errormsg|http_response_header)/,scope:{pattern:/\b[\w\\]+::/,inside:{keyword:/(static|self|parent)/,punctuation:/(::|\\)/}}});
+Prism.languages.powershell={comment:[{pattern:/(^|[^`])<#[\w\W]*?#>/,lookbehind:!0},{pattern:/(^|[^`])#.*/,lookbehind:!0}],string:[{pattern:/"(`?[\w\W])*?"/,greedy:!0,inside:{"function":{pattern:/[^`]\$\(.*?\)/,inside:{}}}},{pattern:/'([^']|'')*'/,greedy:!0}],namespace:/\[[a-z][\w\W]*?\]/i,"boolean":/\$(true|false)\b/i,variable:/\$\w+\b/i,"function":[/\b(Add-(Computer|Content|History|Member|PSSnapin|Type)|Checkpoint-Computer|Clear-(Content|EventLog|History|Item|ItemProperty|Variable)|Compare-Object|Complete-Transaction|Connect-PSSession|ConvertFrom-(Csv|Json|StringData)|Convert-Path|ConvertTo-(Csv|Html|Json|Xml)|Copy-(Item|ItemProperty)|Debug-Process|Disable-(ComputerRestore|PSBreakpoint|PSRemoting|PSSessionConfiguration)|Disconnect-PSSession|Enable-(ComputerRestore|PSBreakpoint|PSRemoting|PSSessionConfiguration)|Enter-PSSession|Exit-PSSession|Export-(Alias|Clixml|Console|Csv|FormatData|ModuleMember|PSSession)|ForEach-Object|Format-(Custom|List|Table|Wide)|Get-(Alias|ChildItem|Command|ComputerRestorePoint|Content|ControlPanelItem|Culture|Date|Event|EventLog|EventSubscriber|FormatData|Help|History|Host|HotFix|Item|ItemProperty|Job|Location|Member|Module|Process|PSBreakpoint|PSCallStack|PSDrive|PSProvider|PSSession|PSSessionConfiguration|PSSnapin|Random|Service|TraceSource|Transaction|TypeData|UICulture|Unique|Variable|WmiObject)|Group-Object|Import-(Alias|Clixml|Csv|LocalizedData|Module|PSSession)|Invoke-(Command|Expression|History|Item|RestMethod|WebRequest|WmiMethod)|Join-Path|Limit-EventLog|Measure-(Command|Object)|Move-(Item|ItemProperty)|New-(Alias|Event|EventLog|Item|ItemProperty|Module|ModuleManifest|Object|PSDrive|PSSession|PSSessionConfigurationFile|PSSessionOption|PSTransportOption|Service|TimeSpan|Variable|WebServiceProxy)|Out-(Default|File|GridView|Host|Null|Printer|String)|Pop-Location|Push-Location|Read-Host|Receive-(Job|PSSession)|Register-(EngineEvent|ObjectEvent|PSSessionConfiguration|WmiEvent)|Remove-(Computer|Event|EventLog|Item|ItemProperty|Job|Module|PSBreakpoint|PSDrive|PSSession|PSSnapin|TypeData|Variable|WmiObject)|Rename-(Computer|Item|ItemProperty)|Reset-ComputerMachinePassword|Resolve-Path|Restart-(Computer|Service)|Restore-Computer|Resume-(Job|Service)|Save-Help|Select-(Object|String|Xml)|Send-MailMessage|Set-(Alias|Content|Date|Item|ItemProperty|Location|PSBreakpoint|PSDebug|PSSessionConfiguration|Service|StrictMode|TraceSource|Variable|WmiInstance)|Show-(Command|ControlPanelItem|EventLog)|Sort-Object|Split-Path|Start-(Job|Process|Service|Sleep|Transaction)|Stop-(Computer|Job|Process|Service)|Suspend-(Job|Service)|Tee-Object|Test-(ComputerSecureChannel|Connection|ModuleManifest|Path|PSSessionConfigurationFile)|Trace-Command|Unblock-File|Undo-Transaction|Unregister-(Event|PSSessionConfiguration)|Update-(FormatData|Help|List|TypeData)|Use-Transaction|Wait-(Event|Job|Process)|Where-Object|Write-(Debug|Error|EventLog|Host|Output|Progress|Verbose|Warning))\b/i,/\b(ac|cat|chdir|clc|cli|clp|clv|compare|copy|cp|cpi|cpp|cvpa|dbp|del|diff|dir|ebp|echo|epal|epcsv|epsn|erase|fc|fl|ft|fw|gal|gbp|gc|gci|gcs|gdr|gi|gl|gm|gp|gps|group|gsv|gu|gv|gwmi|iex|ii|ipal|ipcsv|ipsn|irm|iwmi|iwr|kill|lp|ls|measure|mi|mount|move|mp|mv|nal|ndr|ni|nv|ogv|popd|ps|pushd|pwd|rbp|rd|rdr|ren|ri|rm|rmdir|rni|rnp|rp|rv|rvpa|rwmi|sal|saps|sasv|sbp|sc|select|set|shcm|si|sl|sleep|sls|sort|sp|spps|spsv|start|sv|swmi|tee|trcm|type|write)\b/i],keyword:/\b(Begin|Break|Catch|Class|Continue|Data|Define|Do|DynamicParam|Else|ElseIf|End|Exit|Filter|Finally|For|ForEach|From|Function|If|InlineScript|Parallel|Param|Process|Return|Sequence|Switch|Throw|Trap|Try|Until|Using|Var|While|Workflow)\b/i,operator:{pattern:/(\W?)(!|-(eq|ne|gt|ge|lt|le|sh[lr]|not|b?(and|x?or)|(Not)?(Like|Match|Contains|In)|Replace|Join|is(Not)?|as)\b|-[-=]?|\+[+=]?|[*\/%]=?)/i,lookbehind:!0},punctuation:/[|{}[\];(),.]/},Prism.languages.powershell.string[0].inside.boolean=Prism.languages.powershell.boolean,Prism.languages.powershell.string[0].inside.variable=Prism.languages.powershell.variable,Prism.languages.powershell.string[0].inside.function.inside=Prism.util.clone(Prism.languages.powershell);
+Prism.languages.properties={comment:/^[ \t]*[#!].*$/m,"attr-value":{pattern:/(^[ \t]*(?:\\(?:\r\n|[\s\S])|[^\\\s:=])+?(?: *[=:] *| ))(?:\\(?:\r\n|[\s\S])|.)+/m,lookbehind:!0},"attr-name":/^[ \t]*(?:\\(?:\r\n|[\s\S])|[^\\\s:=])+?(?= *[ =:]| )/m,punctuation:/[=:]/};
+Prism.languages.python={"triple-quoted-string":{pattern:/"""[\s\S]+?"""|'''[\s\S]+?'''/,alias:"string"},comment:{pattern:/(^|[^\\])#.*/,lookbehind:!0},string:{pattern:/("|')(?:\\\\|\\?[^\\\r\n])*?\1/,greedy:!0},"function":{pattern:/((?:^|\s)def[ \t]+)[a-zA-Z_][a-zA-Z0-9_]*(?=\()/g,lookbehind:!0},"class-name":{pattern:/(\bclass\s+)[a-z0-9_]+/i,lookbehind:!0},keyword:/\b(?:as|assert|async|await|break|class|continue|def|del|elif|else|except|exec|finally|for|from|global|if|import|in|is|lambda|pass|print|raise|return|try|while|with|yield)\b/,"boolean":/\b(?:True|False)\b/,number:/\b-?(?:0[bo])?(?:(?:\d|0x[\da-f])[\da-f]*\.?\d*|\.\d+)(?:e[+-]?\d+)?j?\b/i,operator:/[-+%=]=?|!=|\*\*?=?|\/\/?=?|<[<=>]?|>[=>]?|[&|^~]|\b(?:or|and|not)\b/,punctuation:/[{}[\];(),.:]/};
+Prism.languages.r={comment:/#.*/,string:/(['"])(?:\\?.)*?\1/,"percent-operator":{pattern:/%[^%\s]*%/,alias:"operator"},"boolean":/\b(?:TRUE|FALSE)\b/,ellipsis:/\.\.(?:\.|\d+)/,number:[/\b(?:NaN|Inf)\b/,/\b(?:0x[\dA-Fa-f]+(?:\.\d*)?|\d*\.?\d+)(?:[EePp][+-]?\d+)?[iL]?\b/],keyword:/\b(?:if|else|repeat|while|function|for|in|next|break|NULL|NA|NA_integer_|NA_real_|NA_complex_|NA_character_)\b/,operator:/->?>?|<(?:=|<?-)?|[>=!]=?|::?|&&?|\|\|?|[+*\/^$@~]/,punctuation:/[(){}\[\],;]/};
+!function(a){var e=a.util.clone(a.languages.javascript);a.languages.jsx=a.languages.extend("markup",e),a.languages.jsx.tag.pattern=/<\/?[\w\.:-]+\s*(?:\s+[\w\.:-]+(?:=(?:("|')(\\?[\w\W])*?\1|[^\s'">=]+|(\{[\w\W]*?\})))?\s*)*\/?>/i,a.languages.jsx.tag.inside["attr-value"].pattern=/=[^\{](?:('|")[\w\W]*?(\1)|[^\s>]+)/i;var s=a.util.clone(a.languages.jsx);delete s.punctuation,s=a.languages.insertBefore("jsx","operator",{punctuation:/=(?={)|[{}[\];(),.:]/},{jsx:s}),a.languages.insertBefore("inside","attr-value",{script:{pattern:/=(\{(?:\{[^}]*\}|[^}])+\})/i,inside:s,alias:"language-javascript"}},a.languages.jsx.tag)}(Prism);
+Prism.languages.rust={comment:[{pattern:/(^|[^\\])\/\*[\w\W]*?\*\//,lookbehind:!0},{pattern:/(^|[^\\:])\/\/.*/,lookbehind:!0}],string:[/b?r(#*)"(?:\\?.)*?"\1/,/b?("|')(?:\\?.)*?\1/],keyword:/\b(?:abstract|alignof|as|be|box|break|const|continue|crate|do|else|enum|extern|false|final|fn|for|if|impl|in|let|loop|match|mod|move|mut|offsetof|once|override|priv|pub|pure|ref|return|sizeof|static|self|struct|super|true|trait|type|typeof|unsafe|unsized|use|virtual|where|while|yield)\b/,attribute:{pattern:/#!?\[.+?\]/,alias:"attr-name"},"function":[/[a-z0-9_]+(?=\s*\()/i,/[a-z0-9_]+!(?=\s*\(|\[)/i],"macro-rules":{pattern:/[a-z0-9_]+!/i,alias:"function"},number:/\b-?(?:0x[\dA-Fa-f](?:_?[\dA-Fa-f])*|0o[0-7](?:_?[0-7])*|0b[01](?:_?[01])*|(\d(_?\d)*)?\.?\d(_?\d)*([Ee][+-]?\d+)?)(?:_?(?:[iu](?:8|16|32|64)?|f32|f64))?\b/,"closure-params":{pattern:/\|[^|]*\|(?=\s*[{-])/,inside:{punctuation:/[\|:,]/,operator:/[&*]/}},punctuation:/[{}[\];(),:]|\.+|->/,operator:/[-+*\/%!^=]=?|@|&[&=]?|\|[|=]?|<<?=?|>>?=?/};
+!function(e){e.languages.sass=e.languages.extend("css",{comment:{pattern:/^([ \t]*)\/[\/*].*(?:(?:\r?\n|\r)\1[ \t]+.+)*/m,lookbehind:!0}}),e.languages.insertBefore("sass","atrule",{"atrule-line":{pattern:/^(?:[ \t]*)[@+=].+/m,inside:{atrule:/(?:@[\w-]+|[+=])/m}}}),delete e.languages.sass.atrule;var a=/((\$[-_\w]+)|(#\{\$[-_\w]+\}))/i,t=[/[+*\/%]|[=!]=|<=?|>=?|\b(?:and|or|not)\b/,{pattern:/(\s+)-(?=\s)/,lookbehind:!0}];e.languages.insertBefore("sass","property",{"variable-line":{pattern:/^[ \t]*\$.+/m,inside:{punctuation:/:/,variable:a,operator:t}},"property-line":{pattern:/^[ \t]*(?:[^:\s]+ *:.*|:[^:\s]+.*)/m,inside:{property:[/[^:\s]+(?=\s*:)/,{pattern:/(:)[^:\s]+/,lookbehind:!0}],punctuation:/:/,variable:a,operator:t,important:e.languages.sass.important}}}),delete e.languages.sass.property,delete e.languages.sass.important,delete e.languages.sass.selector,e.languages.insertBefore("sass","punctuation",{selector:{pattern:/([ \t]*)\S(?:,?[^,\r\n]+)*(?:,(?:\r?\n|\r)\1[ \t]+\S(?:,?[^,\r\n]+)*)*/,lookbehind:!0}})}(Prism);
+Prism.languages.scss=Prism.languages.extend("css",{comment:{pattern:/(^|[^\\])(?:\/\*[\w\W]*?\*\/|\/\/.*)/,lookbehind:!0},atrule:{pattern:/@[\w-]+(?:\([^()]+\)|[^(])*?(?=\s+[{;])/,inside:{rule:/@[\w-]+/}},url:/(?:[-a-z]+-)*url(?=\()/i,selector:{pattern:/(?=\S)[^@;\{\}\(\)]?([^@;\{\}\(\)]|&|#\{\$[-_\w]+\})+(?=\s*\{(\}|\s|[^\}]+(:|\{)[^\}]+))/m,inside:{parent:{pattern:/&/,alias:"important"},placeholder:/%[-_\w]+/,variable:/\$[-_\w]+|#\{\$[-_\w]+\}/}}}),Prism.languages.insertBefore("scss","atrule",{keyword:[/@(?:if|else(?: if)?|for|each|while|import|extend|debug|warn|mixin|include|function|return|content)/i,{pattern:/( +)(?:from|through)(?= )/,lookbehind:!0}]}),Prism.languages.scss.property={pattern:/(?:[\w-]|\$[-_\w]+|#\{\$[-_\w]+\})+(?=\s*:)/i,inside:{variable:/\$[-_\w]+|#\{\$[-_\w]+\}/}},Prism.languages.insertBefore("scss","important",{variable:/\$[-_\w]+|#\{\$[-_\w]+\}/}),Prism.languages.insertBefore("scss","function",{placeholder:{pattern:/%[-_\w]+/,alias:"selector"},statement:{pattern:/\B!(?:default|optional)\b/i,alias:"keyword"},"boolean":/\b(?:true|false)\b/,"null":/\bnull\b/,operator:{pattern:/(\s)(?:[-+*\/%]|[=!]=|<=?|>=?|and|or|not)(?=\s)/,lookbehind:!0}}),Prism.languages.scss.atrule.inside.rest=Prism.util.clone(Prism.languages.scss);
+Prism.languages.sql={comment:{pattern:/(^|[^\\])(?:\/\*[\w\W]*?\*\/|(?:--|\/\/|#).*)/,lookbehind:!0},string:{pattern:/(^|[^@\\])("|')(?:\\?[\s\S])*?\2/,lookbehind:!0},variable:/@[\w.$]+|@("|'|`)(?:\\?[\s\S])+?\1/,"function":/\b(?:COUNT|SUM|AVG|MIN|MAX|FIRST|LAST|UCASE|LCASE|MID|LEN|ROUND|NOW|FORMAT)(?=\s*\()/i,keyword:/\b(?:ACTION|ADD|AFTER|ALGORITHM|ALL|ALTER|ANALYZE|ANY|APPLY|AS|ASC|AUTHORIZATION|AUTO_INCREMENT|BACKUP|BDB|BEGIN|BERKELEYDB|BIGINT|BINARY|BIT|BLOB|BOOL|BOOLEAN|BREAK|BROWSE|BTREE|BULK|BY|CALL|CASCADED?|CASE|CHAIN|CHAR VARYING|CHARACTER (?:SET|VARYING)|CHARSET|CHECK|CHECKPOINT|CLOSE|CLUSTERED|COALESCE|COLLATE|COLUMN|COLUMNS|COMMENT|COMMIT|COMMITTED|COMPUTE|CONNECT|CONSISTENT|CONSTRAINT|CONTAINS|CONTAINSTABLE|CONTINUE|CONVERT|CREATE|CROSS|CURRENT(?:_DATE|_TIME|_TIMESTAMP|_USER)?|CURSOR|DATA(?:BASES?)?|DATE(?:TIME)?|DBCC|DEALLOCATE|DEC|DECIMAL|DECLARE|DEFAULT|DEFINER|DELAYED|DELETE|DELIMITER(?:S)?|DENY|DESC|DESCRIBE|DETERMINISTIC|DISABLE|DISCARD|DISK|DISTINCT|DISTINCTROW|DISTRIBUTED|DO|DOUBLE(?: PRECISION)?|DROP|DUMMY|DUMP(?:FILE)?|DUPLICATE KEY|ELSE|ENABLE|ENCLOSED BY|END|ENGINE|ENUM|ERRLVL|ERRORS|ESCAPE(?:D BY)?|EXCEPT|EXEC(?:UTE)?|EXISTS|EXIT|EXPLAIN|EXTENDED|FETCH|FIELDS|FILE|FILLFACTOR|FIRST|FIXED|FLOAT|FOLLOWING|FOR(?: EACH ROW)?|FORCE|FOREIGN|FREETEXT(?:TABLE)?|FROM|FULL|FUNCTION|GEOMETRY(?:COLLECTION)?|GLOBAL|GOTO|GRANT|GROUP|HANDLER|HASH|HAVING|HOLDLOCK|IDENTITY(?:_INSERT|COL)?|IF|IGNORE|IMPORT|INDEX|INFILE|INNER|INNODB|INOUT|INSERT|INT|INTEGER|INTERSECT|INTO|INVOKER|ISOLATION LEVEL|JOIN|KEYS?|KILL|LANGUAGE SQL|LAST|LEFT|LIMIT|LINENO|LINES|LINESTRING|LOAD|LOCAL|LOCK|LONG(?:BLOB|TEXT)|MATCH(?:ED)?|MEDIUM(?:BLOB|INT|TEXT)|MERGE|MIDDLEINT|MODIFIES SQL DATA|MODIFY|MULTI(?:LINESTRING|POINT|POLYGON)|NATIONAL(?: CHAR VARYING| CHARACTER(?: VARYING)?| VARCHAR)?|NATURAL|NCHAR(?: VARCHAR)?|NEXT|NO(?: SQL|CHECK|CYCLE)?|NONCLUSTERED|NULLIF|NUMERIC|OFF?|OFFSETS?|ON|OPEN(?:DATASOURCE|QUERY|ROWSET)?|OPTIMIZE|OPTION(?:ALLY)?|ORDER|OUT(?:ER|FILE)?|OVER|PARTIAL|PARTITION|PERCENT|PIVOT|PLAN|POINT|POLYGON|PRECEDING|PRECISION|PREV|PRIMARY|PRINT|PRIVILEGES|PROC(?:EDURE)?|PUBLIC|PURGE|QUICK|RAISERROR|READ(?:S SQL DATA|TEXT)?|REAL|RECONFIGURE|REFERENCES|RELEASE|RENAME|REPEATABLE|REPLICATION|REQUIRE|RESTORE|RESTRICT|RETURNS?|REVOKE|RIGHT|ROLLBACK|ROUTINE|ROW(?:COUNT|GUIDCOL|S)?|RTREE|RULE|SAVE(?:POINT)?|SCHEMA|SELECT|SERIAL(?:IZABLE)?|SESSION(?:_USER)?|SET(?:USER)?|SHARE MODE|SHOW|SHUTDOWN|SIMPLE|SMALLINT|SNAPSHOT|SOME|SONAME|START(?:ING BY)?|STATISTICS|STATUS|STRIPED|SYSTEM_USER|TABLES?|TABLESPACE|TEMP(?:ORARY|TABLE)?|TERMINATED BY|TEXT(?:SIZE)?|THEN|TIMESTAMP|TINY(?:BLOB|INT|TEXT)|TOP?|TRAN(?:SACTIONS?)?|TRIGGER|TRUNCATE|TSEQUAL|TYPES?|UNBOUNDED|UNCOMMITTED|UNDEFINED|UNION|UNIQUE|UNPIVOT|UPDATE(?:TEXT)?|USAGE|USE|USER|USING|VALUES?|VAR(?:BINARY|CHAR|CHARACTER|YING)|VIEW|WAITFOR|WARNINGS|WHEN|WHERE|WHILE|WITH(?: ROLLUP|IN)?|WORK|WRITE(?:TEXT)?)\b/i,"boolean":/\b(?:TRUE|FALSE|NULL)\b/i,number:/\b-?(?:0x)?\d*\.?[\da-f]+\b/,operator:/[-+*\/=%^~]|&&?|\|?\||!=?|<(?:=>?|<|>)?|>[>=]?|\b(?:AND|BETWEEN|IN|LIKE|NOT|OR|IS|DIV|REGEXP|RLIKE|SOUNDS LIKE|XOR)\b/i,punctuation:/[;[\]()`,.]/};
+Prism.languages.swift=Prism.languages.extend("clike",{string:{pattern:/("|')(\\(?:\((?:[^()]|\([^)]+\))+\)|\r\n|[\s\S])|(?!\1)[^\\\r\n])*\1/,greedy:!0,inside:{interpolation:{pattern:/\\\((?:[^()]|\([^)]+\))+\)/,inside:{delimiter:{pattern:/^\\\(|\)$/,alias:"variable"}}}}},keyword:/\b(as|associativity|break|case|catch|class|continue|convenience|default|defer|deinit|didSet|do|dynamic(?:Type)?|else|enum|extension|fallthrough|final|for|func|get|guard|if|import|in|infix|init|inout|internal|is|lazy|left|let|mutating|new|none|nonmutating|operator|optional|override|postfix|precedence|prefix|private|Protocol|public|repeat|required|rethrows|return|right|safe|self|Self|set|static|struct|subscript|super|switch|throws?|try|Type|typealias|unowned|unsafe|var|weak|where|while|willSet|__(?:COLUMN__|FILE__|FUNCTION__|LINE__))\b/,number:/\b([\d_]+(\.[\de_]+)?|0x[a-f0-9_]+(\.[a-f0-9p_]+)?|0b[01_]+|0o[0-7_]+)\b/i,constant:/\b(nil|[A-Z_]{2,}|k[A-Z][A-Za-z_]+)\b/,atrule:/@\b(IB(?:Outlet|Designable|Action|Inspectable)|class_protocol|exported|noreturn|NS(?:Copying|Managed)|objc|UIApplicationMain|auto_closure)\b/,builtin:/\b([A-Z]\S+|abs|advance|alignof(?:Value)?|assert|contains|count(?:Elements)?|debugPrint(?:ln)?|distance|drop(?:First|Last)|dump|enumerate|equal|filter|find|first|getVaList|indices|isEmpty|join|last|lexicographicalCompare|map|max(?:Element)?|min(?:Element)?|numericCast|overlaps|partition|print(?:ln)?|reduce|reflect|reverse|sizeof(?:Value)?|sort(?:ed)?|split|startsWith|stride(?:of(?:Value)?)?|suffix|swap|toDebugString|toString|transcode|underestimateCount|unsafeBitCast|with(?:ExtendedLifetime|Unsafe(?:MutablePointers?|Pointers?)|VaList))\b/}),Prism.languages.swift.string.inside.interpolation.inside.rest=Prism.util.clone(Prism.languages.swift);
+Prism.languages.typescript=Prism.languages.extend("javascript",{keyword:/\b(break|case|catch|class|const|continue|debugger|default|delete|do|else|enum|export|extends|false|finally|for|from|function|get|if|implements|import|in|instanceof|interface|let|new|null|package|private|protected|public|return|set|static|super|switch|this|throw|true|try|typeof|var|void|while|with|yield|module|declare|constructor|string|Function|any|number|boolean|Array|enum)\b/}),Prism.languages.ts=Prism.languages.typescript;
+Prism.languages.yaml={scalar:{pattern:/([\-:]\s*(![^\s]+)?[ \t]*[|>])[ \t]*(?:((?:\r?\n|\r)[ \t]+)[^\r\n]+(?:\3[^\r\n]+)*)/,lookbehind:!0,alias:"string"},comment:/#.*/,key:{pattern:/(\s*(?:^|[:\-,[{\r\n?])[ \t]*(![^\s]+)?[ \t]*)[^\r\n{[\]},#\s]+?(?=\s*:\s)/,lookbehind:!0,alias:"atrule"},directive:{pattern:/(^[ \t]*)%.+/m,lookbehind:!0,alias:"important"},datetime:{pattern:/([:\-,[{]\s*(![^\s]+)?[ \t]*)(\d{4}-\d\d?-\d\d?([tT]|[ \t]+)\d\d?:\d{2}:\d{2}(\.\d*)?[ \t]*(Z|[-+]\d\d?(:\d{2})?)?|\d{4}-\d{2}-\d{2}|\d\d?:\d{2}(:\d{2}(\.\d*)?)?)(?=[ \t]*($|,|]|}))/m,lookbehind:!0,alias:"number"},"boolean":{pattern:/([:\-,[{]\s*(![^\s]+)?[ \t]*)(true|false)[ \t]*(?=$|,|]|})/im,lookbehind:!0,alias:"important"},"null":{pattern:/([:\-,[{]\s*(![^\s]+)?[ \t]*)(null|~)[ \t]*(?=$|,|]|})/im,lookbehind:!0,alias:"important"},string:{pattern:/([:\-,[{]\s*(![^\s]+)?[ \t]*)("(?:[^"\\]|\\.)*"|'(?:[^'\\]|\\.)*')(?=[ \t]*($|,|]|}))/m,lookbehind:!0},number:{pattern:/([:\-,[{]\s*(![^\s]+)?[ \t]*)[+\-]?(0x[\da-f]+|0o[0-7]+|(\d+\.?\d*|\.?\d+)(e[\+\-]?\d+)?|\.inf|\.nan)[ \t]*(?=$|,|]|})/im,lookbehind:!0},tag:/![^\s]+/,important:/[&*][\w]+/,punctuation:/---|[:[\]{}\-,|>?]|\.\.\./};
+!function(){function e(e,t){return Array.prototype.slice.call((t||document).querySelectorAll(e))}function t(e,t){return t=" "+t+" ",(" "+e.className+" ").replace(/[\n\t]/g," ").indexOf(t)>-1}function n(e,n,i){for(var o,a=n.replace(/\s+/g,"").split(","),l=+e.getAttribute("data-line-offset")||0,d=r()?parseInt:parseFloat,c=d(getComputedStyle(e).lineHeight),s=0;o=a[s++];){o=o.split("-");var u=+o[0],m=+o[1]||u,h=document.createElement("div");h.textContent=Array(m-u+2).join(" \n"),h.setAttribute("aria-hidden","true"),h.className=(i||"")+" line-highlight",t(e,"line-numbers")||(h.setAttribute("data-start",u),m>u&&h.setAttribute("data-end",m)),h.style.top=(u-l-1)*c+"px",t(e,"line-numbers")?e.appendChild(h):(e.querySelector("code")||e).appendChild(h)}}function i(){var t=location.hash.slice(1);e(".temporary.line-highlight").forEach(function(e){e.parentNode.removeChild(e)});var i=(t.match(/\.([\d,-]+)$/)||[,""])[1];if(i&&!document.getElementById(t)){var r=t.slice(0,t.lastIndexOf(".")),o=document.getElementById(r);o&&(o.hasAttribute("data-line")||o.setAttribute("data-line",""),n(o,i,"temporary "),document.querySelector(".temporary.line-highlight").scrollIntoView())}}if("undefined"!=typeof self&&self.Prism&&self.document&&document.querySelector){var r=function(){var e;return function(){if("undefined"==typeof e){var t=document.createElement("div");t.style.fontSize="13px",t.style.lineHeight="1.5",t.style.padding=0,t.style.border=0,t.innerHTML="&nbsp;<br />&nbsp;",document.body.appendChild(t),e=38===t.offsetHeight,document.body.removeChild(t)}return e}}(),o=0;Prism.hooks.add("complete",function(t){var r=t.element.parentNode,a=r&&r.getAttribute("data-line");r&&a&&/pre/i.test(r.nodeName)&&(clearTimeout(o),e(".line-highlight",r).forEach(function(e){e.parentNode.removeChild(e)}),n(r,a),o=setTimeout(i,1))}),window.addEventListener&&window.addEventListener("hashchange",i)}}();
+!function(){"undefined"!=typeof self&&self.Prism&&self.document&&Prism.hooks.add("complete",function(e){if(e.code){var t=e.element.parentNode,s=/\s*\bline-numbers\b\s*/;if(t&&/pre/i.test(t.nodeName)&&(s.test(t.className)||s.test(e.element.className))&&!e.element.querySelector(".line-numbers-rows")){s.test(e.element.className)&&(e.element.className=e.element.className.replace(s,"")),s.test(t.className)||(t.className+=" line-numbers");var n,a=e.code.match(/\n(?!$)/g),l=a?a.length+1:1,r=new Array(l+1);r=r.join("<span></span>"),n=document.createElement("span"),n.setAttribute("aria-hidden","true"),n.className="line-numbers-rows",n.innerHTML=r,t.hasAttribute("data-start")&&(t.style.counterReset="linenumber "+(parseInt(t.getAttribute("data-start"),10)-1)),e.element.appendChild(n)}}})}();
+!function(){"undefined"!=typeof self&&!self.Prism||"undefined"!=typeof global&&!global.Prism||Prism.hooks.add("before-highlight",function(e){var f=e.grammar;f.tab=/\t/g,f.crlf=/\r\n/g,f.lf=/\n/g,f.cr=/\r/g,f.space=/ /g})}();
+!function(){if(("undefined"==typeof self||self.Prism)&&("undefined"==typeof global||global.Prism)){var i=/\b([a-z]{3,7}:\/\/|tel:)[\w\-+%~\/.:#=?&amp;]+/,n=/\b\S+@[\w.]+[a-z]{2}/,e=/\[([^\]]+)]\(([^)]+)\)/,t=["comment","url","attr-value","string"];Prism.plugins.autolinker={processGrammar:function(a){a&&!a["url-link"]&&(Prism.languages.DFS(a,function(a,r,l){t.indexOf(l)>-1&&"Array"!==Prism.util.type(r)&&(r.pattern||(r=this[a]={pattern:r}),r.inside=r.inside||{},"comment"==l&&(r.inside["md-link"]=e),"attr-value"==l?Prism.languages.insertBefore("inside","punctuation",{"url-link":i},r):r.inside["url-link"]=i,r.inside["email-link"]=n)}),a["url-link"]=i,a["email-link"]=n)}},Prism.hooks.add("before-highlight",function(i){Prism.plugins.autolinker.processGrammar(i.grammar)}),Prism.hooks.add("wrap",function(i){if(/-link$/.test(i.type)){i.tag="a";var n=i.content;if("email-link"==i.type&&0!=n.indexOf("mailto:"))n="mailto:"+n;else if("md-link"==i.type){var t=i.content.match(e);n=t[2],i.content=t[1]}i.attributes.href=n}})}}();
+!function(){"undefined"!=typeof self&&self.Prism&&self.document&&document.querySelector&&(self.Prism.fileHighlight=function(){var e={js:"javascript",py:"python",rb:"ruby",ps1:"powershell",psm1:"powershell",sh:"bash",bat:"batch",h:"c",tex:"latex"};Array.prototype.forEach&&Array.prototype.slice.call(document.querySelectorAll("pre[data-src]")).forEach(function(t){for(var a,s=t.getAttribute("data-src"),n=t,r=/\blang(?:uage)?-(?!\*)(\w+)\b/i;n&&!r.test(n.className);)n=n.parentNode;if(n&&(a=(t.className.match(r)||[,""])[1]),!a){var o=(s.match(/\.(\w+)$/)||[,""])[1];a=e[o]||o}var l=document.createElement("code");l.className="language-"+a,t.textContent="",l.textContent="Loading…",t.appendChild(l);var i=new XMLHttpRequest;i.open("GET",s,!0),i.onreadystatechange=function(){4==i.readyState&&(i.status<400&&i.responseText?(l.textContent=i.responseText,Prism.highlightElement(l)):l.textContent=i.status>=400?"✖ Error "+i.status+" while fetching file: "+i.statusText:"✖ Error: File does not exist or is empty")},i.send(null)})},document.addEventListener("DOMContentLoaded",self.Prism.fileHighlight))}();
+!function(){if("undefined"!=typeof self&&self.Prism&&self.document){var t=[],e={},n=function(){};Prism.plugins.toolbar={};var a=Prism.plugins.toolbar.registerButton=function(n,a){var o;o="function"==typeof a?a:function(t){var e;return"function"==typeof a.onClick?(e=document.createElement("button"),e.type="button",e.addEventListener("click",function(){a.onClick.call(this,t)})):"string"==typeof a.url?(e=document.createElement("a"),e.href=a.url):e=document.createElement("span"),e.textContent=a.text,e},t.push(e[n]=o)},o=Prism.plugins.toolbar.hook=function(a){var o=a.element.parentNode;if(o&&/pre/i.test(o.nodeName)&&!o.classList.contains("code-toolbar")){o.classList.add("code-toolbar");var r=document.createElement("div");r.classList.add("toolbar"),document.body.hasAttribute("data-toolbar-order")&&(t=document.body.getAttribute("data-toolbar-order").split(",").map(function(t){return e[t]||n})),t.forEach(function(t){var e=t(a);if(e){var n=document.createElement("div");n.classList.add("toolbar-item"),n.appendChild(e),r.appendChild(n)}}),o.appendChild(r)}};a("label",function(t){var e=t.element.parentNode;if(e&&/pre/i.test(e.nodeName)&&e.hasAttribute("data-label")){var n,a,o=e.getAttribute("data-label");try{a=document.querySelector("template#"+o)}catch(r){}return a?n=a.content:(e.hasAttribute("data-url")?(n=document.createElement("a"),n.href=e.getAttribute("data-url")):n=document.createElement("span"),n.textContent=o),n}}),Prism.hooks.add("complete",o)}}();
+!function(){function t(t){"function"!=typeof t||e(t)||r.push(t)}function e(t){return"function"==typeof t?r.filter(function(e){return e.valueOf()===t.valueOf()})[0]:"string"==typeof t&&t.length>0?r.filter(function(e){return e.name===t})[0]:null}function n(t){if("string"==typeof t&&(t=e(t)),"function"==typeof t){var n=r.indexOf(t);n>=0&&r.splice(n,1)}}function a(){Array.prototype.slice.call(document.querySelectorAll("pre[data-jsonp]")).forEach(function(t){t.textContent="";var e=document.createElement("code");e.textContent=i,t.appendChild(e);var n=t.getAttribute("data-adapter"),a=null;if(n){if("function"!=typeof window[n])return e.textContent="JSONP adapter function '"+n+"' doesn't exist",void 0;a=window[n]}var u="prismjsonp"+o++,f=document.createElement("a"),l=f.href=t.getAttribute("data-jsonp");f.href+=(f.search?"&":"?")+(t.getAttribute("data-callback")||"callback")+"="+u;var s=setTimeout(function(){e.textContent===i&&(e.textContent="Timeout loading '"+l+"'")},5e3),d=document.createElement("script");d.src=f.href,window[u]=function(n){document.head.removeChild(d),clearTimeout(s),delete window[u];var o="";if(a)o=a(n,t);else for(var i in r)if(o=r[i](n,t),null!==o)break;null===o?e.textContent="Cannot parse response (perhaps you need an adapter function?)":(e.textContent=o,Prism.highlightElement(e))},document.head.appendChild(d)})}if(self.Prism&&self.document&&document.querySelectorAll&&[].filter){var r=[];Prism.plugins.jsonphighlight={registerAdapter:t,removeAdapter:n,highlight:a},t(function(t){if(t&&t.meta&&t.data){if(t.meta.status&&t.meta.status>=400)return"Error: "+(t.data.message||t.meta.status);if("string"==typeof t.data.content)return"function"==typeof atob?atob(t.data.content.replace(/\s/g,"")):"Your browser cannot decode base64"}return null}),t(function(t,e){if(t&&t.meta&&t.data&&t.data.files){if(t.meta.status&&t.meta.status>=400)return"Error: "+(t.data.message||t.meta.status);var n=e.getAttribute("data-filename");if(null==n)for(var a in t.data.files)if(t.data.files.hasOwnProperty(a)){n=a;break}return void 0!==t.data.files[n]?t.data.files[n].content:"Error: unknown or missing gist file "+n}return null}),t(function(t){return t&&t.node&&"string"==typeof t.data?t.data:null});var o=0,i="Loading…";a()}}();
+!function(){"undefined"!=typeof self&&!self.Prism||"undefined"!=typeof global&&!global.Prism||Prism.hooks.add("wrap",function(e){"keyword"===e.type&&e.classes.push("keyword-"+e.content)})}();
+!function(){if("undefined"!=typeof self&&self.Prism&&self.document&&document.createElement){var e={javascript:"clike",actionscript:"javascript",aspnet:"markup",bison:"c",c:"clike",csharp:"clike",cpp:"c",coffeescript:"javascript",crystal:"ruby","css-extras":"css",d:"clike",dart:"clike",fsharp:"clike",glsl:"clike",go:"clike",groovy:"clike",haml:"ruby",handlebars:"markup",haxe:"clike",jade:"javascript",java:"clike",jolie:"clike",kotlin:"clike",less:"css",markdown:"markup",nginx:"clike",n4js:"javascript",n4mf:"json",nfon:"json",objectivec:"c",parser:"markup",php:"clike","php-extras":"php",processing:"clike",protobuf:"clike",qore:"clike",jsx:["markup","javascript"],reason:"clike",ruby:"clike",sass:"css",scss:"css",scala:"java",smarty:"markup",swift:"clike",textile:"markup",twig:"markup",typescript:"javascript",wiki:"markup"},c={},a="none",s=Prism.plugins.autoloader={languages_path:"components/",use_minified:!0},n=function(e,c,a){var s=document.createElement("script");s.src=e,s.async=!0,s.onload=function(){document.body.removeChild(s),c&&c()},s.onerror=function(){document.body.removeChild(s),a&&a()},document.body.appendChild(s)},r=function(e){return s.languages_path+"prism-"+e+(s.use_minified?".min":"")+".js"},i=function(e,a){var s=c[e];s||(s=c[e]={});var n=a.getAttribute("data-dependencies");!n&&a.parentNode&&"pre"===a.parentNode.tagName.toLowerCase()&&(n=a.parentNode.getAttribute("data-dependencies")),n=n?n.split(/\s*,\s*/g):[],l(n,function(){t(e,function(){Prism.highlightElement(a)})})},l=function(e,c,a){"string"==typeof e&&(e=[e]);var s=0,n=e.length,r=function(){n>s?t(e[s],function(){s++,r()},function(){a&&a(e[s])}):s===n&&c&&c(e)};r()},t=function(a,s,i){var t=function(){var e=!1;a.indexOf("!")>=0&&(e=!0,a=a.replace("!",""));var l=c[a];if(l||(l=c[a]={}),s&&(l.success_callbacks||(l.success_callbacks=[]),l.success_callbacks.push(s)),i&&(l.error_callbacks||(l.error_callbacks=[]),l.error_callbacks.push(i)),!e&&Prism.languages[a])o(a);else if(!e&&l.error)u(a);else if(e||!l.loading){l.loading=!0;var t=r(a);n(t,function(){l.loading=!1,o(a)},function(){l.loading=!1,l.error=!0,u(a)})}},p=e[a];p&&p.length?l(p,t):t()},o=function(e){c[e]&&c[e].success_callbacks&&c[e].success_callbacks.length&&c[e].success_callbacks.forEach(function(c){c(e)})},u=function(e){c[e]&&c[e].error_callbacks&&c[e].error_callbacks.length&&c[e].error_callbacks.forEach(function(c){c(e)})};Prism.hooks.add("complete",function(e){e.element&&e.language&&!e.grammar&&e.language!==a&&i(e.language,e.element)})}}();
+!function(){"undefined"!=typeof self&&self.Prism&&self.document&&Prism.hooks.add("complete",function(e){if(e.code){var t=e.element.parentNode,a=/\s*\bcommand-line\b\s*/;if(t&&/pre/i.test(t.nodeName)&&(a.test(t.className)||a.test(e.element.className))&&!e.element.querySelector(".command-line-prompt")){a.test(e.element.className)&&(e.element.className=e.element.className.replace(a,"")),a.test(t.className)||(t.className+=" command-line");var n=function(e,a){return(t.getAttribute(e)||a).replace(/"/g,"&quot")},s=new Array(1+e.code.split("\n").length),r=n("data-prompt","");if(""!==r)s=s.join('<span data-prompt="'+r+'"></span>');else{var l=n("data-user","user"),m=n("data-host","localhost");s=s.join('<span data-user="'+l+'" data-host="'+m+'"></span>')}var o=document.createElement("span");o.className="command-line-prompt",o.innerHTML=s;var i=t.getAttribute("data-output")||"";i=i.split(",");for(var c=0;c<i.length;c++){var p=i[c].split("-"),d=parseInt(p[0]),u=d;if(2===p.length&&(u=parseInt(p[1])),!isNaN(d)&&!isNaN(u))for(var f=d;u>=f&&f<=o.children.length;f++){var N=o.children[f-1];N.removeAttribute("data-user"),N.removeAttribute("data-host"),N.removeAttribute("data-prompt")}}e.element.innerHTML=o.outerHTML+e.element.innerHTML}}})}();
+!function(){if(("undefined"==typeof self||self.Prism)&&("undefined"==typeof global||global.Prism)){var i=function(i){return Prism.plugins.autolinker&&Prism.plugins.autolinker.processGrammar(i),i},a={pattern:/(.)\bdata:[^\/]+\/[^,]+,(?:(?!\1)[\s\S]|\\\1)+(?=\1)/,lookbehind:!0,inside:{"language-css":{pattern:/(data:[^\/]+\/(?:[^+,]+\+)?css,)[\s\S]+/,lookbehind:!0},"language-javascript":{pattern:/(data:[^\/]+\/(?:[^+,]+\+)?javascript,)[\s\S]+/,lookbehind:!0},"language-json":{pattern:/(data:[^\/]+\/(?:[^+,]+\+)?json,)[\s\S]+/,lookbehind:!0},"language-markup":{pattern:/(data:[^\/]+\/(?:[^+,]+\+)?(?:html|xml),)[\s\S]+/,lookbehind:!0}}},n=["url","attr-value","string"];Prism.plugins.dataURIHighlight={processGrammar:function(i){i&&!i["data-uri"]&&(Prism.languages.DFS(i,function(i,e,r){n.indexOf(r)>-1&&"Array"!==Prism.util.type(e)&&(e.pattern||(e=this[i]={pattern:e}),e.inside=e.inside||{},"attr-value"==r?Prism.languages.insertBefore("inside",e.inside["url-link"]?"url-link":"punctuation",{"data-uri":a},e):e.inside["url-link"]?Prism.languages.insertBefore("inside","url-link",{"data-uri":a},e):e.inside["data-uri"]=a)}),i["data-uri"]=a)}},Prism.hooks.add("before-highlight",function(n){if(a.pattern.test(n.code))for(var e in a.inside)if(a.inside.hasOwnProperty(e)&&!a.inside[e].inside&&a.inside[e].pattern.test(n.code)){var r=e.match(/^language-(.+)/)[1];Prism.languages[r]&&(a.inside[e].inside={rest:i(Prism.languages[r])})}Prism.plugins.dataURIHighlight.processGrammar(n.grammar)})}}();
+!function(){if("undefined"!=typeof self&&self.Prism&&self.document){if(!Prism.plugins.toolbar)return console.warn("Show Languages plugin loaded before Toolbar plugin."),void 0;var e={html:"HTML",xml:"XML",svg:"SVG",mathml:"MathML",css:"CSS",clike:"C-like",javascript:"JavaScript",abap:"ABAP",actionscript:"ActionScript",apacheconf:"Apache Configuration",apl:"APL",applescript:"AppleScript",asciidoc:"AsciiDoc",aspnet:"ASP.NET (C#)",autoit:"AutoIt",autohotkey:"AutoHotkey",basic:"BASIC",csharp:"C#",cpp:"C++",coffeescript:"CoffeeScript","css-extras":"CSS Extras",fsharp:"F#",glsl:"GLSL",graphql:"GraphQL",http:"HTTP",inform7:"Inform 7",json:"JSON",latex:"LaTeX",livescript:"LiveScript",lolcode:"LOLCODE",matlab:"MATLAB",mel:"MEL",n4js:"N4JS",n4jsx:"N4JSX",nfon:"NFON",n4mf:"N4JS Manifest",nasm:"NASM",nginx:"nginx",nsis:"NSIS",objectivec:"Objective-C",ocaml:"OCaml",parigp:"PARI/GP",php:"PHP","php-extras":"PHP Extras",powershell:"PowerShell",properties:".properties",protobuf:"Protocol Buffers",jsx:"React JSX",rest:"reST (reStructuredText)",sas:"SAS",sass:"Sass (Sass)",scss:"Sass (Scss)",sql:"SQL",typescript:"TypeScript",vhdl:"VHDL",vim:"vim",wiki:"Wiki markup",xojo:"Xojo (REALbasic)",yaml:"YAML"};Prism.plugins.toolbar.registerButton("show-language",function(t){var a=t.element.parentNode;if(a&&/pre/i.test(a.nodeName)){var s=a.getAttribute("data-language")||e[t.language]||t.language.substring(0,1).toUpperCase()+t.language.substring(1),r=document.createElement("span");return r.textContent=s,r}})}}();
+!function(){if("undefined"!=typeof self&&self.Prism&&self.document){if(!Prism.plugins.toolbar)return console.warn("Copy to Clipboard plugin loaded before Toolbar plugin."),void 0;var o=window.Clipboard||void 0;o||"function"!=typeof require||(o=require("clipboard"));var e=[];if(!o){var t=document.createElement("script"),n=document.querySelector("head");t.onload=function(){if(o=window.Clipboard)for(;e.length;)e.pop()()},t.src="https://cdnjs.cloudflare.com/ajax/libs/clipboard.js/1.5.8/clipboard.min.js",n.appendChild(t)}Prism.plugins.toolbar.registerButton("copy-to-clipboard",function(t){function n(){var e=new o(i,{text:function(){return t.code}});e.on("success",function(){i.textContent="Copied!",r()}),e.on("error",function(){i.textContent="Press Ctrl+C to copy",r()})}function r(){setTimeout(function(){i.textContent="Copy"},5e3)}var i=document.createElement("a");return i.textContent="Copy",o?n():e.push(n),i})}}();
+!function(){"undefined"!=typeof self&&self.Prism&&self.document&&document.createRange&&(Prism.plugins.KeepMarkup=!0,Prism.hooks.add("before-highlight",function(e){if(e.element.children.length){var n=0,o=[],t=function(e,d){var r={};d||(r.clone=e.cloneNode(!1),r.posOpen=n,o.push(r));for(var a=0,s=e.childNodes.length;s>a;a++){var p=e.childNodes[a];1===p.nodeType?t(p):3===p.nodeType&&(n+=p.data.length)}d||(r.posClose=n)};t(e.element,!0),o&&o.length&&(e.keepMarkup=o)}}),Prism.hooks.add("after-highlight",function(e){if(e.keepMarkup&&e.keepMarkup.length){var n=function(e,o){for(var t=0,d=e.childNodes.length;d>t;t++){var r=e.childNodes[t];if(1===r.nodeType){if(!n(r,o))return!1}else 3===r.nodeType&&(!o.nodeStart&&o.pos+r.data.length>o.node.posOpen&&(o.nodeStart=r,o.nodeStartPos=o.node.posOpen-o.pos),o.nodeStart&&o.pos+r.data.length>=o.node.posClose&&(o.nodeEnd=r,o.nodeEndPos=o.node.posClose-o.pos),o.pos+=r.data.length);if(o.nodeStart&&o.nodeEnd){var a=document.createRange();return a.setStart(o.nodeStart,o.nodeStartPos),a.setEnd(o.nodeEnd,o.nodeEndPos),o.node.clone.appendChild(a.extractContents()),a.insertNode(o.node.clone),a.detach(),!1}}return!0};e.keepMarkup.forEach(function(o){n(e.element,{node:o,pos:0})})}}))}();
diff --git a/idespec/scripts/toc.js b/idespec/scripts/toc.js
new file mode 100644
index 0000000..a3f0d27
--- /dev/null
+++ b/idespec/scripts/toc.js
@@ -0,0 +1,58 @@
+/**
+ * Copyright (c) 2016 NumberFour AG.
+ * All rights reserved. This program and the accompanying materials
+ * are made available under the terms of the Eclipse Public License v1.0
+ * which accompanies this distribution, and is available at
+ * http://www.eclipse.org/legal/epl-v10.html
+ *
+ * Contributors:
+ *   NumberFour AG - Initial API and implementation
+ */
+
+$( "button#collapsetoc" ).click(function () {
+    $(this).toggleClass("inactive");
+     if ( $( this ).hasClass( "inactive" ) ) {
+        $('.toc2 > ul').treeView('expandAll');
+        /*$(this).css("background-image", "collapse.png");*/
+    }
+    else {
+        $('.toc2 > ul').treeView('collapseAll');
+        /*$(this).css("background-image", "expand.png");*/
+    }
+});
+
+// simulate click on parent element for 'a' elements in TOC
+$( ".toc2 a" ).click(function () {
+    $(this).parent('li').trigger('click');
+});
+
+$(window).resize(function() {
+    if ($(window).width() < 768) {
+        $( "#header, #content, #footnotes, #footer, #links" ).animate({left: '40px'},"slow");
+        $( "body.toc2").css("width", "90%");
+    }
+    else if ($("#tocbutton").css('left') == '270px') {
+            $( "#header, #content, #footnotes, #footer, #links" ).animate({left: '260px'},"slow");
+            $( "body.toc2").css("width", "80%");
+    }
+});
+
+function search() {
+    // Declare variables
+    var input, filter, li, a, i;
+    input = document.getElementById('pagesearch');
+    filter = input.value.toUpperCase();
+    li = document.getElementById("toclist").getElementsByTagName('li');
+    $('.toc2 > ul').treeView('expandAll');
+    // Loop through all list items, and hide those who don't match the search query
+    for (i = 0; i < li.length; i++) {
+        //a = li[i].getElementsByTagName("a")[0];
+        if (li[i].innerHTML.toUpperCase().indexOf(filter) > -1) {
+            li[i].style.display = "block";
+            $(li[i]).addClass("found");
+        } else {
+            $(li[i]).removeClass("found");
+            li[i].style.display = "none";
+        }
+    }
+}
diff --git a/idespec/scripts/treeview.js b/idespec/scripts/treeview.js
new file mode 100644
index 0000000..fe28355
--- /dev/null
+++ b/idespec/scripts/treeview.js
@@ -0,0 +1,161 @@
+/*
+
+The MIT License (MIT)
+
+Copyright (c) 2015 Samarjeet Singh
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
+
+*/
+
+// Source - https://github.com/samarjeet27/TreeViewJS
+
+(function ($){
+    // doesn't work without jquery
+    if (!$) return;
+    // treeView
+    function treeView($me) {
+        // add treeview class name if not present
+        $me.addClass('treeview');
+        // collapsable elements i.e. the li with a ul in it
+        var $collapse = $me.find('li>ul').parent();
+        // generate tree from data
+        function generateTree(data, $root, options) {
+            // create a node from a node object
+            function createNode(nObj, $target) {
+                var li = $('<li>').appendTo($target);
+                // node icons require using a span element
+                var useSpan = options.useSpan || options.imageList.length > 0;
+                if (useSpan) {
+                    li.append($('<span>').text(nObj.label));
+                } else {
+                    li.text(nObj.label);
+                }
+                if(options.imageList.length > 0){
+                    // the image
+                    var image = 'url('+options.imageList[nObj.imageIndex]+')';
+                    // requires using span
+                    var $span = li.find('span');
+                    // indicates that it has a node image
+                    $span.addClass('has-node-icon');
+                    $span.css('background-image', image);
+                }
+                if (nObj.children != undefined && nObj.children.length > 0) {
+                    var innerList = $('<ul>').appendTo(li);
+                    for (var i = 0; i < nObj.children.length; i++) {
+                        var child = nObj.children[i];
+                        createNode(child, innerList);
+                    };
+                }
+                
+                return li;
+            }
+            for (var i = 0; i < data.length; i++) {
+                createNode(data[i], $root);
+            }
+        }
+
+        return {
+            //initialize control
+            init: function (data) {
+                // handle undefined error
+                data = data || { };
+
+                // default optoins
+                var defaults = {
+                    model: null, // treeview data model
+                    useSpan: false, // use <span> to build model
+                    imageList: [], // add icons to nodes
+                    // ajax: null, TODO: load data using ajax
+                    expanded: false // the tree is expanded
+                };
+                // configuration
+                var options = { };
+                
+                if (typeof data.concat != 'undefined') {
+                    // concat is an array method, thus checks if data is array
+                    // typeof array returns object otherwise
+                    defaults.model = data;
+                    // data has model only, which is transferred to defaults.model
+                    // prevents wrong merge in $.extend
+                    data = null;
+                }
+                // merge options
+                options = $.extend(defaults, data);
+
+                if (options.model != null) {
+                    // generate the tree
+                    generateTree(options.model, $me, options);
+                    // re assign var value for new dom structure
+                    $collapse = $me.find('li>ul').parent();
+                }
+                // all the collapsable items which have something
+                $collapse.addClass('contains-items');
+                // user config
+                if (options.expanded){
+                    $collapse.addClass('items-expanded')
+                } else {
+                    $me.find('ul').css('display', 'none');
+                }
+                // expand items which have something
+                $me.find('.contains-items').on('click', function (event) {
+                    if ($(event.target).hasClass('contains-items')){
+                        // expand icon
+                        $(this).toggleClass('items-expanded');
+                        // the inner list
+                        var $a = $(this).find('>ul');
+                        // slide effect
+                        $a.slideToggle();
+                        // stop propagation of inner elements
+                        event.stopPropagation();
+                    }
+                });
+            },
+            // expand all items
+            expandAll: function() {
+                var items = $me.find('.contains-items');
+                items.find('ul').slideDown();
+                items.addClass('items-expanded');
+            },
+            // collapse all items
+            collapseAll: function() {
+                var items = $me.find('.contains-items');
+                items.find('ul').slideUp();
+                items.removeClass('items-expanded');
+            }
+        }
+    }
+    // treeView jQuery plugin
+    $.fn.treeView = function(options) {
+        // if it's a function arguments
+        var args = (arguments.length > 1) ? Array.prototype.slice.call(arguments, 1) : undefined;
+        // all the elements by selector
+        return this.each(function () {
+            var instance = new treeView($(this));
+            if ( instance[options] ) {
+                // has requested method
+                return instance[options](args);
+            } else {
+                // no method requested, so initialize
+                instance.init(options);
+            }
+        });
+    }
+
+})(window.jQuery);
\ No newline at end of file
diff --git a/idespec/styles/backtotop.css b/idespec/styles/backtotop.css
new file mode 100644
index 0000000..05529ac
--- /dev/null
+++ b/idespec/styles/backtotop.css
@@ -0,0 +1,88 @@
+/* ========================================================================== Back-to-top button ======================================================================= */
+
+a.back-to-top {
+	display: none;
+	width: 25px;
+	height: 25px;
+	text-indent: -9999px;
+	position: fixed;
+	z-index: 999;
+	right: 8%;
+	bottom: 5%;
+	background: #032c52 url("../images/up-arrow.png") no-repeat center 43%;
+	-webkit-border-radius: 30px;
+	-moz-border-radius: 30px;
+	border-radius: 30px;
+}
+
+a:hover.back-to-top {
+	background-color: #F7D425 ;
+}
+#tocbutton {
+	visibility: hidden;
+}
+
+#tocbuttonbars.fa.fa-bars {
+	z-index: 1000;
+	right: 0;
+}
+
+#tocbutton:hover {
+	background: url("yellowbars.png") no-repeat center 50%;
+}
+
+
+body.toc2.toc-right a.back-to-top {
+	width: 25px;
+	height: 25px;
+	text-indent: -9999px;
+	position: fixed;
+	z-index: 1001;
+	right: 90px;
+	bottom: 20px;
+	background: #032c52 url("../images/up-arrow.png") no-repeat center 43%;
+	-webkit-border-radius: 30px;
+	-moz-border-radius: 30px;
+	border-radius: 30px;
+}
+
+body.toc2.toc-right #tocbutton {
+	visibility: visible;
+	width: 25px;
+	height: 25px;
+	text-indent: -9999px;
+	position: fixed;
+	z-index: 998;
+	border: none;
+	right: 25px;
+	top: 5px;
+	background: url("bars.png") no-repeat center 50%;
+}
+
+body.toc2.toc-right #tocbutton:hover {
+	background-color: #e3f2ff;
+	background: url("yellowbars.png") no-repeat center 50%;
+}
+
+body.toc2.toc-right a:hover.back-to-top {
+	background-color: #F7D425 ;
+}
+
+@media only screen and (max-width: 1535px) {
+	body.toc2.toc-right #tocbutton {
+	background: url("yellowbars.png") no-repeat center 50%;
+	left: 98%;
+	z-index: 100000;
+}
+@media only screen and (max-width: 1434px) {
+	body.toc2.toc-right #tocbutton {
+	visibility: hidden;
+}
+
+@media only screen and (min-width: ) 
+
+
+@media only screen and (max-width: 1462px) {
+	a.back-to-top {
+	left: 90%;
+}
diff --git a/idespec/styles/foundation.css b/idespec/styles/foundation.css
new file mode 100644
index 0000000..24f2eb9
--- /dev/null
+++ b/idespec/styles/foundation.css
@@ -0,0 +1,3128 @@
+article,
+aside,
+details,
+figcaption,
+figure,
+footer,
+header,
+hgroup,
+main,
+nav,
+section,
+summary {
+    display: block
+}
+
+audio,
+canvas,
+video {
+    display: inline-block
+}
+
+audio:not([controls]) {
+    display: none;
+    height: 0
+}
+
+[hidden],
+template {
+    display: none
+}
+
+script {
+    display: none!important
+}
+
+html {
+    font-family: sans-serif;
+    -ms-text-size-adjust: 100%;
+    -webkit-text-size-adjust: 100%;
+    overflow-x: hidden;
+    width: 100%
+}
+
+body {
+    margin: 0
+}
+
+a {
+    background: 0 0;
+    overflow-wrap: break-word
+}
+
+a:focus {
+    outline: thin dotted
+}
+
+a:active,
+a:hover {
+    outline: 0
+}
+
+h1 {
+    font-size: 2em;
+    margin: .67em 0
+}
+
+abbr[title] {
+    border-bottom: 1px dotted
+}
+
+b,
+strong {
+    font-weight: 700
+}
+
+dfn {
+    font-style: italic
+}
+
+hr {
+    -moz-box-sizing: content-box;
+    box-sizing: content-box;
+    height: 0
+}
+
+mark {
+    background: #ff0;
+    color: #000
+}
+
+code,
+kbd,
+pre,
+samp {
+    font-family: monospace, serif;
+    font-size: 1em
+}
+
+pre {
+    white-space: pre-wrap
+}
+
+q {
+    quotes: "\201C" "\201D" "\2018" "\2019"
+}
+
+small {
+    font-size: 80%
+}
+
+sub,
+sup {
+    font-size: 75%;
+    line-height: 0;
+    position: relative;
+    vertical-align: baseline
+}
+
+sup {
+    top: -.5em
+}
+
+sub {
+    bottom: -.25em
+}
+
+img {
+    border: 0
+}
+
+svg:not(:root) {
+    overflow: hidden
+}
+
+figure {
+    margin: 0
+}
+
+fieldset {
+    border: 1px solid silver;
+    margin: 0 2px;
+    padding: .35em .625em .75em
+}
+
+legend {
+    border: 0;
+    padding: 0
+}
+
+button,
+input,
+select,
+textarea {
+    font-family: inherit;
+    font-size: 100%;
+    margin: 0
+}
+
+button,
+input {
+    line-height: normal
+}
+
+button,
+select {
+    text-transform: none
+}
+
+button,
+html input[type=button],
+input[type=reset],
+input[type=submit] {
+    -webkit-appearance: button;
+    cursor: pointer
+}
+
+button[disabled],
+html input[disabled] {
+    cursor: default
+}
+
+input[type=checkbox],
+input[type=radio] {
+    box-sizing: border-box;
+    padding: 0
+}
+
+input[type=search] {
+    -webkit-appearance: textfield;
+    -moz-box-sizing: content-box;
+    -webkit-box-sizing: content-box;
+    box-sizing: content-box
+}
+
+input[type=search]::-webkit-search-cancel-button,
+input[type=search]::-webkit-search-decoration {
+    -webkit-appearance: none
+}
+
+button::-moz-focus-inner,
+input::-moz-focus-inner {
+    border: 0;
+    padding: 0
+}
+
+textarea {
+    overflow: auto;
+    vertical-align: top
+}
+
+table {
+    border-collapse: collapse;
+    border-spacing: 0
+}
+
+meta.foundation-mq-small {
+    font-family: "only screen and (min-width: 768px)";
+    width: 768px
+}
+
+meta.foundation-mq-medium {
+    font-family: "only screen and (min-width:1280px)";
+    width: 1280px
+}
+
+meta.foundation-mq-large {
+    font-family: "only screen and (min-width:1440px)";
+    width: 1440px
+}
+
+*,
+:after,
+:before {
+    -moz-box-sizing: border-box;
+    -webkit-box-sizing: border-box;
+    box-sizing: border-box
+}
+
+body,
+html {
+    font-size: 100%
+}
+
+body {
+    background: #fff;
+    color: #595959;
+    padding: 0;
+    margin: 0;
+    font-family: "Helvetica Neue", Helvetica, Helvetica, Arial, sans-serif;
+    font-weight: 400;
+    font-style: normal;
+    line-height: 1;
+    position: relative;
+    cursor: auto
+}
+
+a:hover {
+    cursor: pointer
+}
+
+embed,
+img,
+object {
+    max-width: 100%;
+    height: auto
+}
+
+embed,
+object {
+    height: 100%
+}
+
+img {
+    -ms-interpolation-mode: bicubic
+}
+
+#map_canvas embed,
+#map_canvas img,
+#map_canvas object,
+.map_canvas embed,
+.map_canvas img,
+.map_canvas object {
+    max-width: none!important
+}
+
+.left {
+    float: left!important
+}
+
+.right {
+    float: right!important
+}
+
+.text-left {
+    text-align: left!important
+}
+
+.text-right {
+    text-align: right!important
+}
+
+.text-center {
+    text-align: center!important
+}
+
+.text-justify {
+    text-align: justify!important
+}
+
+.hide {
+    display: none
+}
+
+.antialiased,
+body {
+    -webkit-font-smoothing: antialiased
+}
+
+img {
+    display: inline-block;
+    vertical-align: middle
+}
+
+textarea {
+    height: auto;
+    min-height: 50px
+}
+
+select {
+    width: 100%
+}
+
+object,
+svg {
+    display: inline-block;
+    vertical-align: middle
+}
+
+.center {
+    margin-left: auto;
+    margin-right: auto
+}
+
+.spread {
+    width: 100%
+}
+
+#preamble>.sectionbody>.paragraph:first-of-type p,
+.paragraph.lead>p,
+p.lead {
+    font-size: 1.21875em;
+    line-height: 1.6
+}
+
+.admonitionblock td.content>.title,
+.audioblock>.title,
+.dlist>.title,
+.exampleblock>.title,
+.hdlist>.title,
+.imageblock>.title,
+.listingblock>.title,
+.literalblock>.title,
+.olist>.title,
+.openblock>.title,
+.paragraph>.title,
+.qlist>.title,
+.quoteblock>.title,
+.stemblock>.title,
+.subheader,
+.ulist>.title,
+.verseblock>.title,
+.videoblock>.title,
+table.tableblock>.title {
+    line-height: 1.4;
+    color: #6f6f6f;
+    font-weight: 500;
+    margin-top: .2em;
+    margin-bottom: .5em
+}
+
+#toctitle,
+.sidebarblock>.content>.title,
+blockquote,
+dd,
+div,
+dl,
+dt,
+form,
+h1,
+h2,
+h3,
+h4,
+h5,
+h6,
+li,
+ol,
+p,
+pre,
+td,
+th,
+ul {
+    margin: 0;
+    padding: 0;
+    direction: ltr
+}
+
+a {
+    color: #2ba6cb;
+    text-decoration: none;
+    line-height: inherit
+}
+
+a:focus,
+a:hover {
+    color: #595959
+}
+
+a img {
+    border: none
+}
+
+p {
+    font-family: inherit;
+    font-weight: 400;
+    font-size: 1em;
+    line-height: 1.6;
+    margin-bottom: 5px;
+    text-rendering: optimizeLegibility
+}
+
+p aside {
+    font-size: .875em;
+    line-height: 1.35;
+    font-style: italic
+}
+
+#toctitle,
+.sidebarblock>.content>.title,
+h1,
+h2,
+h3,
+h4,
+h5,
+h6 {
+    font-family: "Helvetica Neue", Helvetica, Helvetica, Arial, sans-serif;
+    font-weight: 700;
+    font-style: normal;
+    color: #595959;
+    text-rendering: optimizeLegibility;
+    margin-top: 0.5em;
+    margin-bottom: .5em;
+    line-height: 1.2125em
+}
+
+#toctitle small,
+.sidebarblock>.content>.title small,
+h1 small,
+h2 small,
+h3 small,
+h4 small,
+h5 small,
+h6 small {
+    font-size: 60%;
+    color: #6f6f6f;
+    line-height: 0
+}
+
+h1 {
+    font-size: 2.125em
+}
+
+h2 {
+    font-size: 1.6875em
+}
+
+#toctitle,
+.sidebarblock>.content>.title,
+h3 {
+    font-size: 1.375em
+}
+
+h4 {
+    font-size: 1.125em
+}
+
+h5 {
+    font-size: 1.125em
+}
+
+h6 {
+    font-size: 1em
+}
+
+hr {
+    border: solid #ddd;
+    border-width: 1px 0 0;
+    clear: both;
+    margin: 1.25em 0 1.1875em;
+    height: 0
+}
+
+em,
+i {
+    font-style: italic;
+    line-height: inherit
+}
+
+b,
+strong {
+    font-weight: 700;
+    line-height: inherit
+}
+
+small {
+    font-size: 60%;
+    line-height: inherit
+}
+
+code {
+    font-family: Consolas, "Liberation Mono", Courier, monospace;
+    font-weight: 700;
+    color: #000;
+    border-radius: .3rem;
+    background-color: #f5f2f0
+}
+
+dl,
+ol,
+ul {
+    font-size: 1em;
+    line-height: 1.6;
+    margin-bottom: 1.25em;
+    list-style-position: outside;
+    font-family: inherit
+}
+
+ol,
+ul {
+    margin-left: 1.5em
+}
+
+ol.no-bullet,
+ul.no-bullet {
+    margin-left: 1.5em
+}
+
+ul li ol,
+ul li ul {
+    margin-left: 1.25em;
+    margin-bottom: 0;
+    font-size: 1em
+}
+
+ul.circle li ul,
+ul.disc li ul,
+ul.square li ul {
+    list-style: inherit
+}
+
+ul.square {
+    list-style-type: square
+}
+
+ul.circle {
+    list-style-type: circle
+}
+
+ul.disc {
+    list-style-type: disc
+}
+
+ul.no-bullet {
+    list-style: none
+}
+
+ol li ol,
+ol li ul {
+    margin-left: 1.25em;
+    margin-bottom: 0
+}
+
+dl dt {
+    margin-bottom: .3125em;
+    font-weight: 700
+}
+
+dl dd {
+    margin-bottom: 1.25em
+}
+
+abbr,
+acronym {
+    text-transform: uppercase;
+    font-size: 90%;
+    color: #222;
+    border-bottom: 1px dotted #ddd;
+    cursor: help
+}
+
+abbr {
+    text-transform: none
+}
+
+blockquote {
+    margin: 0 0 1.25em;
+    padding: .5625em 1.25em 0 1.1875em;
+    border-left: 1px solid #ddd
+}
+
+blockquote cite {
+    display: block;
+    font-size: .8125em;
+    color: #555
+}
+
+blockquote cite:before {
+    content: "\2014 \0020"
+}
+
+blockquote cite a,
+blockquote cite a:visited {
+    color: #555
+}
+
+blockquote,
+blockquote p {
+    line-height: 1.6;
+    color: #6f6f6f
+}
+
+.vcard {
+    display: inline-block;
+    margin: 0 0 1.25em 0;
+    border: 1px solid #ddd;
+    padding: .625em .75em
+}
+
+.vcard li {
+    margin: 0;
+    display: block
+}
+
+.vcard .fn {
+    font-weight: 700;
+    font-size: .9375em
+}
+
+.vevent .summary {
+    font-weight: 700
+}
+
+.vevent abbr {
+    cursor: auto;
+    text-decoration: none;
+    font-weight: 700;
+    border: none;
+    padding: 0 .0625em
+}
+
+@media only screen and (min-width:768px) {
+    #toctitle,
+    .sidebarblock>.content>.title,
+    h1,
+    h2,
+    h3,
+    h4,
+    h5,
+    h6 {
+        line-height: 1.4
+    }
+    h1 {
+        font-size: 2.75em
+    }
+    h2 {
+        font-size: 2.3125em
+    }
+    #toctitle,
+    .sidebarblock>.content>.title,
+    h3 {
+        font-size: 1.6875em
+    }
+    h4 {
+        font-size: 1.4375em
+    }
+}
+
+table {
+    background: #fff;
+    margin-bottom: 1.25em;
+    border: solid 1px #ddd
+}
+
+table tfoot,
+table thead {
+    background: #f5f5f5;
+    font-weight: 600
+}
+
+table tfoot tr td,
+table tfoot tr th,
+table thead tr td,
+table thead tr th {
+    padding: .5em .625em .625em;
+    font-size: inherit;
+    color: #222;
+    text-align: left
+}
+
+table tr td,
+table tr th {
+    padding: .5625em .625em;
+    font-size: inherit;
+    color: #595959
+}
+
+table tr.alt,
+table tr.even,
+table tr:nth-of-type(even) {
+    background: #f9f9f9
+}
+
+table tbody tr td,
+table tfoot tr td,
+table tfoot tr th,
+table thead tr th,
+table tr td {
+    display: table-cell;
+    line-height: 1.4
+}
+
+body {
+    tab-size: 4
+}
+
+#toctitle,
+.sidebarblock>.content>.title,
+h1,
+h2,
+h3,
+h4,
+h5,
+h6 {
+    line-height: 1.4
+}
+
+.clearfix:after,
+.clearfix:before,
+.float-group:after,
+.float-group:before {
+    content: " ";
+    display: table
+}
+
+.clearfix:after,
+.float-group:after {
+    clear: both
+}
+
+:not(pre)>code {
+    font-size: inherit;
+    font-style: normal!important;
+    letter-spacing: 0;
+    padding: 0;
+    line-height: inherit
+}
+
+pre,
+pre>code {
+    line-height: 1.4;
+    color: #000;
+    font-family: monospace, serif;
+    font-weight: 400
+}
+
+.keyseq {
+    color: #555
+}
+
+kbd {
+    font-family: Consolas, "Liberation Mono", Courier, monospace;
+    display: inline-block;
+    color: #222;
+    font-size: .65em;
+    line-height: 1.45;
+    background-color: #f7f7f7;
+    border: 1px solid #ccc;
+    -webkit-border-radius: 3px;
+    border-radius: 3px;
+    -webkit-box-shadow: 0 1px 0 rgba(0, 0, 0, .2), 0 0 0 .1em #fff inset;
+    box-shadow: 0 1px 0 rgba(0, 0, 0, .2), 0 0 0 .1em #fff inset;
+    margin: 0 .15em;
+    padding: .2em .5em;
+    vertical-align: middle;
+    position: relative;
+    top: -.1em;
+    white-space: nowrap
+}
+
+.keyseq kbd:first-child {
+    margin-left: 0
+}
+
+.keyseq kbd:last-child {
+    margin-right: 0
+}
+
+.menu,
+.menuseq {
+    color: #090909
+}
+
+b.button:after,
+b.button:before {
+    position: relative;
+    top: -1px;
+    font-weight: 400
+}
+
+b.button:before {
+    content: "[";
+    padding: 0 3px 0 2px
+}
+
+b.button:after {
+    content: "]";
+    padding: 0 2px 0 3px
+}
+
+#content,
+#footer,
+#footnotes,
+#header {
+    max-width: 1300px;
+    margin-right: 80px;
+    margin-top: 0;
+    margin-bottom: 0;
+    position: relative;
+    padding-left: .9375em;
+    padding-right: .9375em;
+    left: 40px
+}
+
+#content:after,
+#content:before,
+#footer:after,
+#footer:before,
+#footnotes:after,
+#footnotes:before,
+#header:after,
+#header:before {
+    content: " ";
+    display: table
+}
+
+#content:after,
+#footer:after,
+#footnotes:after,
+#header:after {
+    clear: both
+}
+
+#content {
+    margin-top: 0em;
+    padding-right: 0;
+    margin-right: 115px
+}
+
+#content:before {
+    content: none
+}
+
+#header>h1:first-child {
+    color: #595959;
+    margin-top: 2.25rem;
+    margin-bottom: 0
+}
+
+#header>h1:first-child+#toc {
+    margin-top: 8px;
+    border-top: 1px solid #ddd
+}
+
+#header>h1:only-child,
+body.toc2 #header>h1:nth-last-child(2) {
+    border-bottom: 1px solid #ddd;
+    padding-bottom: 8px
+}
+
+#header .details {
+    border-bottom: 1px solid #ddd;
+    line-height: 1.45;
+    padding-top: .25em;
+    padding-bottom: .25em;
+    padding-left: .25em;
+    color: #555;
+    display: -ms-flexbox;
+    display: -webkit-flex;
+    display: flex;
+    -ms-flex-flow: row wrap;
+    -webkit-flex-flow: row wrap;
+    flex-flow: row wrap
+}
+
+#header .details span:first-child {
+    margin-left: -.125em
+}
+
+#header .details span.email a {
+    color: #6f6f6f
+}
+
+#header .details br {
+    display: none
+}
+
+#header .details br+span:before {
+    content: "\00a0\2013\00a0"
+}
+
+#header .details br+span.author:before {
+    content: "\00a0\22c5\00a0";
+    color: #6f6f6f
+}
+
+#header .details br+span#revremark:before {
+    content: "\00a0|\00a0"
+}
+
+#header #revnumber {
+    text-transform: capitalize
+}
+
+#header #revnumber:after {
+    content: "\00a0"
+}
+
+#content>h1:first-child:not([class]) {
+    color: #000;
+    border-bottom: 1px solid #ddd;
+    padding-bottom: 8px;
+    margin-top: 0;
+    padding-top: 1rem;
+    margin-bottom: 1.25rem
+}
+
+#toc {
+    border-bottom: 1px solid #ddd;
+    padding-bottom: .5em;
+    position: relative;
+    left: 0
+}
+
+#toctitle {
+    color: #6f6f6f;
+    font-size: 1.2em
+}
+
+#toc ul li:before {
+    content: "";
+    margin-left: -.75em;
+    margin-right: .4em;
+    color: #244d82
+}
+
+div.ulist li:before {
+    content: "";
+    position: absolute;
+    margin-top: .2rem;
+    font-size: x-large;
+    margin-left: -.75em;
+    margin-bottom: -.75em;
+    margin-right: 0;
+    line-height: 1rem;
+    color: #244d82
+}
+
+#toctitle {
+    color: #595959;
+    font-size: 1.2em;
+    padding-left: 1em
+}
+
+#faq {
+    position: relative;
+    right: 9.3rem;
+    top: 9rem;
+    margin-bottom: 20px;
+    left: 45rem;
+    z-index: 1;
+    padding-left: 2rem;
+    border-left: 1px solid #d3d3d3
+}
+
+@media only screen and (max-width:945px) {
+    div#faq {
+        display: none
+    }
+}
+
+#faq h2 {
+    font-size: 25px;
+    font-weight: 600;
+    margin-top: -8rem
+}
+
+div#faq li:before {
+    content: "";
+    position: absolute;
+    font-size: x-large;
+    margin-left: -.75em;
+    margin-bottom: -.75em;
+    margin-right: 0;
+    line-height: 1rem;
+    color: #244d82
+}
+
+#features-nav {
+    position: absolute;
+    right: 1rem;
+    top: 2rem;
+    margin-bottom: 20px;
+    position: absolute;
+    z-index: 1;
+    padding-left: 2rem;
+    border-left: 1px solid #d3d3d3
+}
+
+@media only screen and (max-width:993px) {
+    #features-nav {
+        display: none
+    }
+}
+
+#features-nav h2 {
+    font-size: 25px;
+    font-weight: 600;
+    margin-top: -1rem
+}
+
+#features-nav li {
+    margin-top: .3rem
+}
+
+div#features-nav li:before {
+    content: "";
+    position: absolute;
+    font-size: x-large;
+    margin-left: -.75em;
+    margin-bottom: -.75em;
+    margin-right: 0;
+    line-height: 1rem;
+    color: #244d82
+}
+
+@media only screen and (min-width:768px) {
+    #toctitle {
+        padding-top: 0;
+        font-size: 1.375em
+    }
+    body.toc2 {
+        padding-left: 2em;
+        padding-right: 1em
+    }
+    #toc.toc2 {
+        margin-top: 0!important;
+        background-color: #f2f2f2;
+        position: fixed;
+        width: 260px;
+        left: 0;
+        top: 0;
+        border-right: 1px solid #ddd;
+        border-top-width: 0!important;
+        border-bottom-width: 0!important;
+        z-index: 1000;
+        padding: 1.25em .25em 0 .25em;
+        height: 100%;
+        overflow: auto
+    }
+    #toc.toc2 #toctitle {
+        margin-top: 0;
+        margin-bottom: .8rem;
+        font-size: 1.2em;
+        padding-left: 1em
+    }
+    #toc.toc2>ul {
+        font-size: .9em;
+        margin-bottom: 0
+    }
+    #toc.toc2 ul ul {
+        margin-left: 6px
+    }
+    #toc.toc2 ul.sectlevel0 ul.sectlevel1 {
+        padding-left: 0;
+        margin-top: .5em;
+        margin-bottom: .5em
+    }
+    body.toc2.toc-right {
+        padding-left: 2em;
+        padding-right: 2em
+    }
+    body.toc2.toc-right #toc.toc2 {
+        border-right-width: 0;
+        border-left: 1px solid #ddd;
+        left: auto;
+        right: -260px
+    }
+}
+
+body.toc2.toc-left #toc.toc2 {
+    left: -260px
+}
+
+@media only screen and (min-width:1535px) {
+    body.toc2 {
+        padding-left: 2em;
+        padding-right: 2em
+    }
+    #toctitle {
+        padding-top: 0;
+        font-size: 1.375em
+    }
+    #toc.toc2 {
+        width: 260px
+    }
+    #toc.toc2 #toctitle {
+        font-size: 1.375em
+    }
+    #toc.toc2>ul {
+        font-size: .95em
+    }
+    #toc.toc2 ul ul {
+        padding-left: 0
+    }
+    body.toc2.toc-right {
+        padding-left: 2em;
+        padding-right: 2em
+    }
+}
+
+#content #toc {
+    border-style: solid;
+    border-width: 1px;
+    border-color: #d9d9d9;
+    margin-bottom: 1.25em;
+    padding: 1.25em;
+    background: #f2f2f2;
+    -webkit-border-radius: 0;
+    border-radius: 0
+}
+
+#content #toc>:first-child {
+    margin-top: 0
+}
+
+#content #toc>:last-child {
+    margin-bottom: 0
+}
+
+#footer {
+    padding: 1.25em;
+    padding-bottom: 0;
+    margin-top: 2rem;
+    color: #fff
+}
+
+div.social {
+    padding: 1.25em;
+    padding-left: 20%;
+    padding-bottom: 0;
+    margin-top: 2rem;
+    color: #fff
+}
+
+div.social>ul li {
+    margin-left: 15%;
+    color: #fff;
+    line-height: 1.44;
+    font-size: 1.2em;
+    font-weight: 800;
+    font-style: bold;
+    position: relative;
+    list-style: none;
+    list-style-type: none;
+    display: inline;
+    text-decoration: none
+}
+
+#bottomright {
+    float: right
+}
+
+#footer-text {
+    color: #ddd;
+    line-height: 1.44
+}
+
+.sect1 {
+    padding-bottom: 0em
+}
+
+@media only screen and (min-width:768px) {
+    .sect1 {
+        padding-bottom: 0em
+    }
+}
+
+.sect1+.sect1 {
+    border-top: 1px solid #ddd
+}
+
+#content h1>a.anchor,
+#toctitle>a.anchor,
+.sidebarblock>.content>.title>a.anchor,
+h2>a.anchor,
+h3>a.anchor,
+h4>a.anchor,
+h5>a.anchor,
+h6>a.anchor {
+    position: absolute;
+    z-index: 1001;
+    width: 1.5ex;
+    margin-left: -1.5ex;
+    display: block;
+    text-decoration: none!important;
+    visibility: hidden;
+    text-align: center;
+    font-weight: 400
+}
+
+#content h1>a.anchor:before,
+#toctitle>a.anchor:before,
+.sidebarblock>.content>.title>a.anchor:before,
+h2>a.anchor:before,
+h3>a.anchor:before,
+h4>a.anchor:before,
+h5>a.anchor:before,
+h6>a.anchor:before {
+    content: "\00A7";
+    font-size: .85em;
+    display: block;
+    padding-top: .1em
+}
+
+#content h1:hover>a.anchor,
+#content h1>a.anchor:hover,
+#toctitle:hover>a.anchor,
+#toctitle>a.anchor:hover,
+.sidebarblock>.content>.title:hover>a.anchor,
+.sidebarblock>.content>.title>a.anchor:hover,
+h2:hover>a.anchor,
+h2>a.anchor:hover,
+h3:hover>a.anchor,
+h3>a.anchor:hover,
+h4:hover>a.anchor,
+h4>a.anchor:hover,
+h5:hover>a.anchor,
+h5>a.anchor:hover,
+h6:hover>a.anchor,
+h6>a.anchor:hover {
+    visibility: visible
+}
+
+#content h1>a.link,
+#toctitle>a.link,
+.sidebarblock>.content>.title>a.link,
+h2>a.link,
+h3>a.link,
+h4>a.link,
+h5>a.link,
+h6>a.link {
+    color: #595959;
+    text-decoration: none
+}
+
+#content h1>a.link:hover,
+#toctitle>a.link:hover,
+.sidebarblock>.content>.title>a.link:hover,
+h2>a.link:hover,
+h3>a.link:hover,
+h4>a.link:hover,
+h5>a.link:hover,
+h6>a.link:hover {
+    color: #151515
+}
+
+.audioblock,
+.imageblock,
+.listingblock,
+.literalblock,
+.stemblock,
+.videoblock {
+    margin-bottom: 1.25em
+}
+
+.admonitionblock td.content>.title,
+.audioblock>.title,
+.dlist>.title,
+.exampleblock>.title,
+.hdlist>.title,
+.imageblock>.title,
+.listingblock>.title,
+.literalblock>.title,
+.olist>.title,
+.openblock>.title,
+.paragraph>.title,
+.qlist>.title,
+.quoteblock>.title,
+.stemblock>.title,
+.ulist>.title,
+.verseblock>.title,
+.videoblock>.title,
+table.tableblock>.title {
+    text-rendering: optimizeLegibility;
+    text-align: left
+}
+
+table.tableblock>caption.title {
+    white-space: nowrap;
+    overflow: visible;
+    max-width: 0
+}
+
+#preamble>.sectionbody>.paragraph:first-of-type p,
+.paragraph.lead>p {
+    color: #000
+}
+
+table.tableblock #preamble>.sectionbody>.paragraph:first-of-type p {
+    font-size: inherit
+}
+
+.admonitionblock>table {
+    border-collapse: separate;
+    border: 0;
+    background: 0 0;
+    width: 100%
+}
+
+.admonitionblock>table td.icon {
+    text-align: center;
+    width: 80px
+}
+
+.admonitionblock>table td.icon img {
+    max-width: none
+}
+
+.admonitionblock>table td.icon .title {
+    font-weight: 700;
+    font-family: "Helvetica Neue", Helvetica, Helvetica, Arial, sans-serif;
+    text-transform: uppercase
+}
+
+.admonitionblock>table td.content {
+    padding-left: 1.125em;
+    padding-right: 1.25em;
+    border-left: 1px solid #ddd;
+    color: #555
+}
+
+.admonitionblock>table td.content>:last-child>:last-child {
+    margin-bottom: 0
+}
+
+.exampleblock>.content {
+    border-style: solid;
+    border-width: 2px;
+    border-color: #8c8989;
+    margin-bottom: 1.25em;
+    padding: 1.25em;
+    background: #fff;
+    -webkit-border-radius: 0;
+    border-radius: 15px
+}
+
+.exampleblock>.content>:first-child {
+    margin-top: 0
+}
+
+.exampleblock>.content>:last-child {
+    margin-bottom: 0
+}
+
+.sidebarblock {
+    position: absolute;
+    border-style: solid;
+    width: 90px;
+    border-width: 1px;
+    border-color: #d9d9d9;
+    right: -90px;
+    padding: .1rem;
+    background: #f2f2f2;
+    -webkit-border-radius: 0;
+    border-radius: 0;
+    text-align: left;
+    border-radius: 5px;
+    word-break: break-word;
+    font-size: smaller
+}
+
+.sidebarblock>:first-child {
+    margin-top: 0
+}
+
+.sidebarblock>:last-child {
+    margin-bottom: 0
+}
+
+.sidebarblock>.content>.title {
+    color: #6999d6;
+    margin-top: 0
+}
+
+.exampleblock>.content .olist>ol>li:last-child>:last-child,
+.exampleblock>.content .qlist>ol>li:last-child>:last-child,
+.exampleblock>.content .ulist>ul>li:last-child>:last-child,
+.exampleblock>.content>:last-child>:last-child,
+.sidebarblock>.content .olist>ol>li:last-child>:last-child,
+.sidebarblock>.content .qlist>ol>li:last-child>:last-child,
+.sidebarblock>.content .ulist>ul>li:last-child>:last-child,
+.sidebarblock>.content>:last-child>:last-child {
+    margin-bottom: 0
+}
+
+.listingblock pre.CodeRay,
+.listingblock pre.prettyprint,
+.listingblock pre:not(.highlight),
+.listingblock pre[class=highlight],
+.listingblock pre[class^="highlight "],
+.literalblock pre {
+    background: #eee
+}
+
+.sidebarblock .listingblock pre.CodeRay,
+.sidebarblock .listingblock pre.prettyprint,
+.sidebarblock .listingblock pre:not(.highlight),
+.sidebarblock .listingblock pre[class=highlight],
+.sidebarblock .listingblock pre[class^="highlight "],
+.sidebarblock .literalblock pre {
+    background: #f2f1f1
+}
+
+.listingblock pre,
+.listingblock pre[class],
+.literalblock pre,
+.literalblock pre[class] {
+    border: 1px solid #ccc;
+    -webkit-border-radius: 0;
+    border-radius: 0;
+    word-wrap: break-word;
+    padding: .8em .8em .65em .8em;
+    font-size: .8125em
+}
+
+.listingblock pre.nowrap,
+.listingblock pre[class].nowrap,
+.literalblock pre.nowrap,
+.literalblock pre[class].nowrap {
+    overflow-x: auto;
+    white-space: pre;
+    word-wrap: normal
+}
+
+@media only screen and (min-width:768px) {
+    .listingblock pre,
+    .listingblock pre[class],
+    .literalblock pre,
+    .literalblock pre[class] {
+        font-size: .90625em
+    }
+}
+
+@media only screen and (min-width:1280px) {
+    .listingblock pre,
+    .listingblock pre[class],
+    .literalblock pre,
+    .literalblock pre[class] {
+        font-size: 1em
+    }
+}
+
+.literalblock.output pre {
+    color: #eee;
+    background-color: #000
+}
+
+.listingblock pre.highlightjs {
+    padding: 0
+}
+
+.listingblock pre.highlightjs>code {
+    padding: .8em .8em .65em .8em;
+    -webkit-border-radius: 0;
+    border-radius: 0
+}
+
+.listingblock>.content {
+    position: relative
+}
+
+.listingblock.terminal pre .command:before {
+    content: attr(data-prompt);
+    padding-right: .5em;
+    color: #999
+}
+
+.listingblock.terminal pre .command:not([data-prompt]):before {
+    content: "$"
+}
+
+table.pyhltable {
+    border-collapse: separate;
+    border: 0;
+    margin-bottom: 0;
+    background: 0 0
+}
+
+table.pyhltable td {
+    vertical-align: top;
+    padding-top: 0;
+    padding-bottom: 0;
+    line-height: 1.4
+}
+
+table.pyhltable td.code {
+    padding-left: .75em;
+    padding-right: 0
+}
+
+pre.pygments .lineno,
+table.pyhltable td:not(.code) {
+    color: #999;
+    padding-left: 0;
+    padding-right: .5em;
+    border-right: 1px solid #ddd
+}
+
+pre.pygments .lineno {
+    display: inline-block;
+    margin-right: .25em
+}
+
+table.pyhltable .linenodiv {
+    background: 0 0!important;
+    padding-right: 0!important
+}
+
+.quoteblock {
+    margin: 0 1em 1.25em 1.5em;
+    display: table
+}
+
+.quoteblock>.title {
+    margin-left: -1.5em;
+    margin-bottom: .75em
+}
+
+.quoteblock blockquote,
+.quoteblock blockquote p {
+    color: #6f6f6f;
+    font-size: 1.15rem;
+    line-height: 1.75;
+    word-spacing: .1em;
+    letter-spacing: 0;
+    font-style: italic;
+    text-align: justify
+}
+
+.quoteblock blockquote {
+    margin: 0;
+    padding: 0;
+    border: 0
+}
+
+.quoteblock blockquote:before {
+    content: "\201c";
+    float: left;
+    font-size: 2.75em;
+    font-weight: 700;
+    line-height: .6em;
+    margin-left: -.6em;
+    color: #6f6f6f;
+    text-shadow: 0 1px 2px rgba(0, 0, 0, .1)
+}
+
+.quoteblock blockquote>.paragraph:last-child p {
+    margin-bottom: 0
+}
+
+.quoteblock .attribution {
+    margin-top: .5em;
+    margin-right: .5ex;
+    text-align: right
+}
+
+.quoteblock .quoteblock {
+    margin-left: 0;
+    margin-right: 0;
+    padding: .5em 0;
+    border-left: 3px solid #555
+}
+
+.quoteblock .quoteblock blockquote {
+    padding: 0 0 0 .75em
+}
+
+.quoteblock .quoteblock blockquote:before {
+    display: none
+}
+
+.verseblock {
+    margin: 0 1em 1.25em 1em
+}
+
+.verseblock pre {
+    font-family: "Open Sans", "DejaVu Sans", sans;
+    font-size: 1.15rem;
+    color: #6f6f6f;
+    font-weight: 300;
+    text-rendering: optimizeLegibility
+}
+
+.verseblock pre strong {
+    font-weight: 400
+}
+
+.verseblock .attribution {
+    margin-top: 1.25rem;
+    margin-left: .5ex
+}
+
+.quoteblock .attribution,
+.verseblock .attribution {
+    font-size: .8125em;
+    line-height: 1.45;
+    font-style: italic
+}
+
+.quoteblock .attribution br,
+.verseblock .attribution br {
+    display: none
+}
+
+.quoteblock .attribution cite,
+.verseblock .attribution cite {
+    display: block;
+    letter-spacing: -.025em;
+    color: #555
+}
+
+.quoteblock.abstract {
+    margin: 0 0 1.25em 0;
+    display: block
+}
+
+.quoteblock.abstract blockquote,
+.quoteblock.abstract blockquote p {
+    text-align: left;
+    word-spacing: 0
+}
+
+.quoteblock.abstract blockquote p:first-of-type:before,
+.quoteblock.abstract blockquote:before {
+    display: none
+}
+
+table.tableblock {
+    max-width: 100%;
+    border-collapse: separate
+}
+
+table.tableblock td>.paragraph:last-child p>p:last-child,
+table.tableblock td>p:last-child,
+table.tableblock th>p:last-child {
+    margin-bottom: 0
+}
+
+table.tableblock,
+td.tableblock,
+th.tableblock {
+    border: 0 solid #ddd
+}
+
+table.grid-all td.tableblock,
+table.grid-all th.tableblock {
+    border-width: 0 1px 1px 0
+}
+
+table.grid-all tfoot>tr>td.tableblock,
+table.grid-all tfoot>tr>th.tableblock {
+    border-width: 1px 1px 0 0
+}
+
+table.grid-cols td.tableblock,
+table.grid-cols th.tableblock {
+    border-width: 0 1px 0 0
+}
+
+table.grid-all *>tr>.tableblock:last-child,
+table.grid-cols *>tr>.tableblock:last-child {
+    border-right-width: 0
+}
+
+table.grid-rows td.tableblock,
+table.grid-rows th.tableblock {
+    border-width: 0 0 1px 0
+}
+
+table.grid-all tbody>tr:last-child>td.tableblock,
+table.grid-all tbody>tr:last-child>th.tableblock,
+table.grid-all thead:last-child>tr>th.tableblock,
+table.grid-rows tbody>tr:last-child>td.tableblock,
+table.grid-rows tbody>tr:last-child>th.tableblock,
+table.grid-rows thead:last-child>tr>th.tableblock {
+    border-bottom-width: 0
+}
+
+table.grid-rows tfoot>tr>td.tableblock,
+table.grid-rows tfoot>tr>th.tableblock {
+    border-width: 1px 0 0 0
+}
+
+table.frame-all {
+    border-width: 1px
+}
+
+table.frame-sides {
+    border-width: 0 1px
+}
+
+table.frame-topbot {
+    border-width: 1px 0
+}
+
+td.halign-left,
+th.halign-left {
+    text-align: left
+}
+
+td.halign-right,
+th.halign-right {
+    text-align: right
+}
+
+td.halign-center,
+th.halign-center {
+    text-align: center
+}
+
+td.valign-top,
+th.valign-top {
+    vertical-align: top
+}
+
+td.valign-bottom,
+th.valign-bottom {
+    vertical-align: bottom
+}
+
+td.valign-middle,
+th.valign-middle {
+    vertical-align: middle
+}
+
+table tfoot th,
+table thead th {
+    font-weight: 700
+}
+
+tbody tr th {
+    display: table-cell;
+    line-height: 1.4;
+    background: #f5f5f5
+}
+
+tbody tr th,
+tbody tr th p,
+tfoot tr th,
+tfoot tr th p {
+    color: #222;
+    font-weight: 700
+}
+
+p.tableblock>code:only-child {
+    background: 0 0;
+    padding: 0
+}
+
+p.tableblock {
+    font-size: 1em
+}
+
+td>div.verse {
+    white-space: pre
+}
+
+ol {
+    margin-left: 1.75em
+}
+
+ul li ol {
+    margin-left: 1.5em
+}
+
+dl dd {
+    margin-left: 1.125em
+}
+
+dl dd:last-child,
+dl dd:last-child>:last-child {
+    margin-bottom: 0
+}
+
+.olist .olist,
+.olist .ulist,
+.ulist .olist,
+.ulist .ulist,
+ol dd,
+ol>li p,
+ul dd,
+ul>li p {
+    margin-bottom: .625em
+}
+
+ol.unnumbered,
+ul.checklist,
+ul.none,
+ul.unstyled {
+    list-style-type: none
+}
+
+ol.unnumbered,
+ul.checklist,
+ul.unstyled {
+    margin-left: .625em
+}
+
+ul.checklist li>p:first-child>.fa-check-square-o:first-child,
+ul.checklist li>p:first-child>.fa-square-o:first-child {
+    width: 1em;
+    font-size: .85em
+}
+
+ul.checklist li>p:first-child>input[type=checkbox]:first-child {
+    width: 1em;
+    position: relative;
+    top: 1px
+}
+
+ul.inline {
+    margin: 0 auto .625em auto;
+    margin-left: -1.375em;
+    margin-right: 0;
+    padding: 0;
+    list-style: none;
+    overflow: hidden
+}
+
+ul.inline>li {
+    list-style: none;
+    float: left;
+    margin-left: 1.375em;
+    display: block
+}
+
+ul.inline>li>* {
+    display: block
+}
+
+.unstyled dl dt {
+    font-weight: 400;
+    font-style: normal
+}
+
+ol.arabic {
+    list-style-type: decimal
+}
+
+ol.decimal {
+    list-style-type: decimal-leading-zero
+}
+
+ol.loweralpha {
+    list-style-type: lower-alpha
+}
+
+ol.upperalpha {
+    list-style-type: upper-alpha
+}
+
+ol.lowerroman {
+    list-style-type: lower-roman
+}
+
+ol.upperroman {
+    list-style-type: upper-roman
+}
+
+ol.lowergreek {
+    list-style-type: lower-greek
+}
+
+.colist>table,
+.hdlist>table {
+    border: 0;
+    background: 0 0
+}
+
+.colist>table>tbody>tr,
+.hdlist>table>tbody>tr {
+    background: 0 0
+}
+
+td.hdlist1,
+td.hdlist2 {
+    vertical-align: top;
+    padding: 0 .625em
+}
+
+td.hdlist1 {
+    font-weight: 700;
+    padding-bottom: 1.25em
+}
+
+.listingblock+.colist,
+.literalblock+.colist {
+    margin-top: -.5em
+}
+
+.colist>table tr>td:first-of-type {
+    padding: 0 .75em;
+    line-height: 1
+}
+
+.colist>table tr>td:last-of-type {
+    padding: .25em 0
+}
+
+.th,
+.thumb {
+    line-height: 0;
+    display: inline-block;
+    border: solid 4px #fff;
+    -webkit-box-shadow: 0 0 0 1px #ddd;
+    box-shadow: 0 0 0 1px #ddd
+}
+
+.imageblock.left,
+.imageblock[style*="float: left"] {
+    margin: .25em .625em 1.25em 0
+}
+
+.imageblock.right,
+.imageblock[style*="float: right"] {
+    margin: .25em 0 1.25em .625em
+}
+
+.imageblock>.title {
+    margin-bottom: 0;
+    text-align: center
+}
+
+.imageblock.th,
+.imageblock.thumb {
+    border-width: 6px
+}
+
+.imageblock.th>.title,
+.imageblock.thumb>.title {
+    padding: 0 .125em
+}
+
+.image.left,
+.image.right {
+    margin-top: .25em;
+    margin-bottom: .25em;
+    display: inline-block;
+    line-height: 0
+}
+
+.image.left {
+    margin-right: .625em
+}
+
+.image.right {
+    margin-left: .625em
+}
+
+a.image {
+    text-decoration: none;
+    display: inline-block
+}
+
+a.image object {
+    pointer-events: none
+}
+
+sup.footnote,
+sup.footnoteref {
+    font-size: .875em;
+    position: static;
+    vertical-align: super
+}
+
+sup.footnote a,
+sup.footnoteref a {
+    text-decoration: none
+}
+
+sup.footnote a:active,
+sup.footnoteref a:active {
+    text-decoration: underline
+}
+
+#footnotes {
+    padding-top: .75em;
+    padding-bottom: .75em;
+    margin-bottom: .625em
+}
+
+#footnotes hr {
+    width: 20%;
+    min-width: 6.25em;
+    margin: -.25em 0 .75em 0;
+    border-width: 1px 0 0 0
+}
+
+#footnotes .footnote {
+    padding: 0 .375em 0 .225em;
+    line-height: 1.3334;
+    font-size: .875em;
+    margin-left: 1.2em;
+    text-indent: -1.05em;
+    margin-bottom: .2em
+}
+
+#footnotes .footnote a:first-of-type {
+    font-weight: 700;
+    text-decoration: none
+}
+
+#footnotes .footnote:last-of-type {
+    margin-bottom: 0
+}
+
+#content #footnotes {
+    margin-top: -.625em;
+    margin-bottom: 0;
+    padding: .75em 0
+}
+
+.gist .file-data>table {
+    border: 0;
+    background: #fff;
+    width: 100%;
+    margin-bottom: 0
+}
+
+.gist .file-data>table td.line-data {
+    width: 99%
+}
+
+div.unbreakable {
+    page-break-inside: avoid
+}
+
+.big {
+    font-size: larger
+}
+
+.small {
+    font-size: smaller
+}
+
+.x-small {
+    font-size: x-small
+}
+
+.xx-small {
+    font-size: xx-small
+}
+
+.x-large {
+    font-size: x-large
+}
+
+.xx-large {
+    font-size: xx-large
+}
+
+.underline {
+    text-decoration: underline
+}
+
+.overline {
+    text-decoration: overline
+}
+
+.line-through {
+    text-decoration: line-through
+}
+
+.aqua {
+    color: #00bfbf
+}
+
+.aqua-background {
+    background-color: #00fafa
+}
+
+.black {
+    color: #000
+}
+
+.black-background {
+    background-color: #000
+}
+
+.blue {
+    color: #0000bf
+}
+
+.blue-background {
+    background-color: #0000fa
+}
+
+.fuchsia {
+    color: #bf00bf
+}
+
+.fuchsia-background {
+    background-color: #fa00fa
+}
+
+.gray {
+    color: #606060
+}
+
+.gray-background {
+    background-color: #7d7d7d
+}
+
+.green {
+    color: #006000
+}
+
+.green-background {
+    background-color: #007d00
+}
+
+.lime {
+    color: #00bf00
+}
+
+.lime-background {
+    background-color: #00fa00
+}
+
+.maroon {
+    color: #600000
+}
+
+.maroon-background {
+    background-color: #7d0000
+}
+
+.navy {
+    color: #000060
+}
+
+.navy-background {
+    background-color: #00007d
+}
+
+.olive {
+    color: #606000
+}
+
+.olive-background {
+    background-color: #7d7d00
+}
+
+.purple {
+    color: #600060
+}
+
+.purple-background {
+    background-color: #7d007d
+}
+
+.red {
+    color: #bf0000
+}
+
+.red-background {
+    background-color: #fa0000
+}
+
+.silver {
+    color: #909090
+}
+
+.silver-background {
+    background-color: #bcbcbc
+}
+
+.teal {
+    color: #006060
+}
+
+.teal-background {
+    background-color: #007d7d
+}
+
+.white {
+    color: #bfbfbf
+}
+
+.white-background {
+    background-color: #fafafa
+}
+
+.yellow {
+    color: #bfbf00
+}
+
+.yellow-background {
+    background-color: #fafa00
+}
+
+span.icon>.fa {
+    cursor: default
+}
+
+.admonitionblock td.icon [class^="fa icon-"] {
+    font-size: 2.5em;
+    text-shadow: 1px 1px 2px rgba(0, 0, 0, .5);
+    cursor: default
+}
+
+.admonitionblock td.icon .icon-note:before {
+    content: "\f05a";
+    color: #207c98
+}
+
+.admonitionblock td.icon .icon-tip:before {
+    content: "\f0eb";
+    text-shadow: 1px 1px 2px rgba(155, 155, 0, .8);
+    color: #111
+}
+
+.admonitionblock td.icon .icon-warning:before {
+    content: "\f071";
+    color: #bf6900
+}
+
+.admonitionblock td.icon .icon-caution:before {
+    content: "\f06d";
+    color: #bf3400
+}
+
+.admonitionblock td.icon .icon-important:before {
+    content: "\f06a";
+    color: #bf0000
+}
+
+.conum[data-value] {
+    display: inline-block;
+    color: #fff!important;
+    background-color: #222;
+    -webkit-border-radius: 100px;
+    border-radius: 100px;
+    text-align: center;
+    font-size: .75em;
+    width: 1.67em;
+    height: 1.67em;
+    line-height: 1.67em;
+    font-family: "Open Sans", "DejaVu Sans", sans-serif;
+    font-style: normal;
+    font-weight: 700
+}
+
+.conum[data-value] * {
+    color: #fff!important
+}
+
+.conum[data-value]+b {
+    display: none
+}
+
+.conum[data-value]:after {
+    content: attr(data-value)
+}
+
+pre .conum[data-value] {
+    position: relative;
+    top: -.125em
+}
+
+b.conum * {
+    color: inherit!important
+}
+
+.conum:not([data-value]):empty {
+    display: none
+}
+
+.listingblock pre,
+.literalblock pre {
+    background: #eee
+}
+
+div#remarks.ulist {
+    max-width: 70%
+}
+
+@media only screen and (max-width:800px) {
+    a#bottomright {
+        visibility: hidden
+    }
+    .sectionbody.paragraph {
+        max-width: 100%
+    }
+    #preamble>.sectionbody>.paragraph:first-of-type p,
+    .paragraph.lead>p {
+        max-width: 100%
+    }
+}
+
+#div.paragraph.faq-intro {
+    max-width: 66.66%
+}
+
+#menu {
+    display: none
+}
+
+div.slicknav_menu {
+    padding-top: 5px;
+    padding-right: 15px;
+    margin-left: 200px;
+    text-align: right;
+    display: none;
+    right: 10px;
+    font-size: 1rem;
+    color: #fff;
+    padding-bottom: 2rem;
+    background: url(logo.png);
+    background-position: 100px 0;
+    background-repeat: no-repeat
+}
+
+span.slicknav_menutxt {
+    margin-right: -20px;
+    color: #fff
+}
+
+div.slicknav_menu a.scroll:first-of-type {
+    color: #f7d425;
+    font-size: 120%;
+    font-weight: 600
+}
+
+div.slicknav_menu ul li a {
+    color: #fff
+}
+
+div.slicknav_menu ul li a:hover {
+    color: #f7d425
+}
+
+div.slicknav_menu a:hover {
+    color: #f7d425
+}
+
+div.slicknav_menu a:visited {
+    color: #fff
+}
+
+div.slicknav_menu a {
+    color: #fff
+}
+
+a.slicknav_btn {
+    padding: 1rem
+}
+
+li.slicknav_parent.slicknav_open {
+    color: #fff
+}
+
+li.slicknav_parent.slicknav_open {
+    color: #fff
+}
+
+.banner {
+    height: 1rem;
+    padding-right: 2rem;
+    max-height: 1rem;
+    max-width: 50%;
+    vertical-align: middle
+}
+
+@media (max-width:800px) {
+    .banner {
+        flex-basis: 66.66%;
+        max-width: 25%;
+        margin: 1rem
+    }
+}
+
+#menubar ul {
+    margin: 0;
+    padding: 0;
+    white-space: nowrap;
+    padding-left: 10px;
+    padding-right: 10px;
+    line-height: 1.2rem
+}
+
+#menubar li {
+    margin: 0;
+    padding: 0
+}
+
+#menubar a {
+    margin: 0;
+    padding-left: 2.5rem;
+}
+
+#menubar ul {
+    list-style: none
+}
+
+#menubar a {
+    text-decoration: none
+}
+
+#menubar li {
+    margin-left: 0
+}
+
+#menubar {
+    height: 50px;
+    max-width: 1280px;
+    position: relative;
+    margin-left: 0px;
+    color: #fff;
+    font-size: 1.9rem;
+    border-bottom: #595959;
+    border-bottom: 2px solid #ddd
+}
+
+#menubar img {
+    padding-left: 45px;
+    margin-top: 15px;
+    padding-top: .2rem
+}
+
+#menubar>ul>li {
+    display: inline-block;
+    margin: .2rem;
+    position: relative;
+    z-index: 10000;
+    flex-basis: 66.666%;
+    font-weight: 700
+
+
+}
+
+@media only screen and (max-width:768px) {
+    body.toc2.toc-right #tocbutton {
+        visibility: hidden
+    }
+    #toc.toc2 {
+        display: none
+    }
+    #content,
+    #footer,
+    #footnotes,
+    #header {
+        margin-left: 0;
+        left: 0
+    }
+    body.toc2 {
+        left: 0
+    }
+}
+
+#logo {
+    margin-top: -55px;
+    left: 5px;
+    top: 10px;
+    position: relative;
+    overflow: hidden
+}
+
+#menubar>ul>li::after {
+    content: " · ";
+    position: relative;
+    top: 3px;
+    padding-left: 3px;
+    font-weight: 400
+}
+
+#menubar>ul>li:last-of-type::after {
+    content: none
+}
+
+#menubar>ul>li>a {
+    font-size: 1.2rem;
+    line-height: 50px;
+    font-weight: 400;
+    webkit-transition: color .15s;
+    -moz-transition: color .15s;
+    -o-transition: color .15s;
+    transition: color .15s;
+    white-space: nowrap;
+    -webkit-font-smoothing: auto;
+    letter-spacing: -.01em;
+    text-align: right
+}
+
+#menubar>ul {
+    margin-right: 12px;
+    margin-top: 10px
+}
+
+#menubar>ul>li>a:hover {
+    color: #f7d425
+}
+
+body.home li.home,
+body.tech li.tech {
+    font-weight: 700
+}
+
+#menubar>ul>li>ul {
+    opacity: 0;
+    visibility: hidden;
+    padding: 18px 0 20px 0;
+    background-color: #fff;
+    text-align: left;
+    position: absolute;
+    top: 55px;
+    left: 50%;
+    margin-left: -90px;
+    -webkit-transition: all .3s .1s;
+    -moz-transition: all .3s .1s;
+    -o-transition: all .3s .1s;
+    transition: all .3s .1s;
+    -webkit-border-radius: 5px;
+    -moz-border-radius: 5px;
+    border-radius: 5px;
+    -webkit-box-shadow: 0 1px 3px rgba(0, 0, 0, .4);
+    -moz-box-shadow: 0 1px 3px rgba(0, 0, 0, .4);
+    box-shadow: 0 1px 3px rgba(0, 0, 0, .4)
+}
+
+#menubar>li li {
+    width: 100%
+}
+
+#menubar>ul>li:hover>ul {
+    opacity: 1;
+    top: 65px;
+    visibility: visible
+}
+
+#menubar>ul>li>ul:before {
+    content: '';
+    display: block;
+    border-color: transparent transparent #fff transparent;
+    border-style: solid;
+    border-width: 10px;
+    position: absolute;
+    top: -20px;
+    left: 10%;
+    margin-left: -10px
+}
+
+#menubar>ul ul>li {
+    position: relative
+
+}
+
+#menubar ul ul a {
+    color: #323232;
+    font-family: ITC Officina Serif W01, sans-serif, Verdana, 'Lucida Grande';
+    font-size: 17px;
+    background-color: #fff;
+    padding: 5px 8px 7px 16px;
+    display: block;
+    -webkit-transition: background-color .1s;
+    -moz-transition: background-color .1s;
+    -o-transition: background-color .1s;
+    transition: background-color .1s
+}
+
+#menubar ul ul a:hover {
+    background-color: #244d82;
+    color: #f7d425
+}
+
+#menubar ul ul ul {
+    visibility: hidden;
+    opacity: 0;
+    position: absolute;
+    top: -16px;
+    left: 206px;
+    padding: 16px 0 20px 0;
+    background-color: #527aa3;
+    text-align: left;
+    width: 160px;
+    -webkit-transition: all .3s;
+    -moz-transition: all .3s;
+    -o-transition: all .3s;
+    transition: all .3s;
+    -webkit-border-radius: 5px;
+    -moz-border-radius: 5px;
+    border-radius: 5px;
+    -webkit-box-shadow: 0 1px 3px rgba(0, 0, 0, .4);
+    -moz-box-shadow: 0 1px 3px rgba(0, 0, 0, .4);
+    box-shadow: 0 1px 3px rgba(0, 0, 0, .4)
+}
+
+#menubar ul ul>li:hover>ul {
+    opacity: 1;
+    left: 196px;
+    visibility: visible
+}
+
+#menubar ul ul a:hover {
+    background-color: #244d82;
+    color: #f7d425
+}
+
+a.back-to-top {
+    display: none;
+    width: 25px;
+    height: 25px;
+    text-indent: -9999px;
+    position: fixed;
+    z-index: 999;
+    right: 20px;
+    bottom: 20px;
+    background: #2ba6cb url(../images/up-arrow.png) no-repeat center 43%;
+    -webkit-border-radius: 30px;
+    -moz-border-radius: 30px;
+    border-radius: 30px
+}
+
+a:hover.back-to-top {
+    background-color: #f7d425
+}
+
+#tocbutton {
+    visibility: hidden;
+    outline: 0
+}
+
+#tocbuttonbars.fa.fa-bars {
+    z-index: 1000;
+    right: 0
+}
+
+#tocbutton:hover {
+    background: url(yellowbars.png) no-repeat center 50%
+}
+
+body.toc2.toc-right a.back-to-top {
+    width: 25px;
+    height: 25px;
+    text-indent: -9999px;
+    position: fixed;
+    z-index: 1001;
+    right: 90px;
+    bottom: 20px;
+    background: #2ba6cb url(up-arrow.png) no-repeat center 43%;
+    -webkit-border-radius: 30px;
+    -moz-border-radius: 30px;
+    border-radius: 30px
+}
+
+body.toc2.toc-right #tocbutton {
+    visibility: visible;
+    width: 25px;
+    height: 25px;
+    text-indent: -9999px;
+    position: fixed;
+    z-index: 998;
+    border: none;
+    right: 25px;
+    top: 5px;
+    background: url(yellowbars.png) no-repeat center 50%
+}
+
+body.toc2.toc-left #tocbutton {
+    visibility: visible;
+    width: 25px;
+    height: 25px;
+    text-indent: -9999px;
+    position: fixed;
+    z-index: 998;
+    border: none;
+    left: 25px;
+    top: 25px;
+    background: url(bars-blue.png) no-repeat center 50%
+}
+
+body.toc2.toc-right #tocbutton:hover {
+    background-color: #e3f2ff;
+    background: url(yellowbars.png) no-repeat center 50%
+}
+
+body.toc2.toc-right a:hover.back-to-top {
+    background-color: #f7d425
+}
+
+@media only screen and (max-width:1535px) {
+    body.toc2.toc-right #tocbutton {
+        background: url(yellowbars.png) no-repeat center 50%;
+        left: 97%;
+        z-index: 100000
+    }
+}
+
+@media only screen and (max-width:768px) {
+    body.toc2.toc-left #tocbutton {
+        visibility: hidden
+    }
+    #toc.toc2 {
+        width: 100%;
+        left: 0
+    }
+    #content,
+    #footer,
+    #footnotes,
+    #header {
+        margin-left: 0;
+        margin-right: 50px
+    }
+}
+
+@media only screen and (max-width:1462px) {
+    a.back-to-top {
+        left: 90%
+    }
+}
+
+div.openblock.definition {
+    border: 1px solid #aaa;
+    padding: .5em;
+    margin-bottom: 1rem;
+    background-color: #f0f8ff;
+    border-radius: 10px;
+    padding: 1rem
+}
+
+.requirement {
+    border: 1px solid #aaa;
+    padding: .5em;
+    margin-bottom: 1rem;
+    background-color: #f5f5f5;
+    border-radius: 10px;
+    padding: 1rem;
+    padding-bottom: 30px
+}
+
+.bibliography .content .paragraph p:first-child::before {
+    color: #777;
+    content: "[" attr(id) "] "
+}
+
+.bibliography .content .paragraph {
+    padding-left: 6em;
+    text-indent: -6em
+}
+
+.todo {
+    color: #dc143c;
+    border: #dc143c;
+    border-width: 2px;
+    border-style: dotted;
+    border-radius: 15px;
+    padding: 12px;
+    background-color: #fff8dc;
+    margin-bottom: 15px
+}
+
+.hold {
+    color: #ff8c00;
+    border: #ff8c00;
+    border-width: 2px;
+    border-style: dotted;
+    border-radius: 15px;
+    padding: 12px;
+    background-color: #f5f5f5;
+    margin-bottom: 15px
+}
+
+.hold::before {
+    content: "ON HOLD"
+}
+
+@media print {
+    @page {
+        margin: 1cm .75cm
+    }
+    * {
+        -webkit-box-shadow: none!important;
+        box-shadow: none!important;
+        text-shadow: none!important
+    }
+    a {
+        color: inherit!important;
+        text-decoration: underline!important
+    }
+    a.bare,
+    a[href^="#"],
+    a[href^="mailto:"] {
+        text-decoration: none!important
+    }
+    abbr[title]:after {
+        content: " (" attr(title) ")"
+    }
+    blockquote,
+    img,
+    object,
+    pre,
+    svg,
+    tr {
+        page-break-inside: avoid
+    }
+    thead {
+        display: table-header-group
+    }
+    svg {
+        max-width: 90%
+    }
+    blockquote,
+    body,
+    dt,
+    p,
+    td.content {
+        font-size: 70%;
+        orphans: 3;
+        widows: 3
+    }
+    #toctitle,
+    .sidebarblock>.content>.title,
+    h2,
+    h3 {
+        page-break-after: avoid
+    }
+    #toc,
+    .exampleblock>.content,
+    .sidebarblock {
+        background: 0 0!important
+    }
+    #toc {
+        border-bottom: 1px solid #ddddd8!important;
+        padding-bottom: 0!important
+    }
+    .sect1 {
+        padding-bottom: 0!important
+    }
+    .sect1+.sect1 {
+        border: 0!important
+    }
+    #header>h1:first-child {
+        margin-top: 1.25rem
+    }
+    body.toc2 {
+        left: -30px;
+        max-width: 100%
+    }
+    #menubar,
+    #tocbutton,
+    body.toc2.toc-left #toc.toc2,
+    div.social {
+        display: none
+    }
+    .definition,
+    .exampleblock,
+    .hold,
+    .listingblock,
+    .requirement,
+    .todo,
+    table {
+        page-break-inside: avoid
+    }
+    body.book #header {
+        text-align: center
+    }
+    body.book #header>h1:first-child {
+        border: 0!important;
+        margin: 2.5em 0 1em 0
+    }
+    body.book #header .details {
+        border: 0!important;
+        display: block;
+        padding: 0!important
+    }
+    body.book #header .details span:first-child {
+        margin-left: 0!important
+    }
+    body.book #header .details br {
+        display: block
+    }
+    body.book #header .details br+span:before {
+        content: none!important
+    }
+    body.book #toc {
+        border: 0!important;
+        text-align: left!important;
+        padding: 0!important;
+        margin: 0!important
+    }
+    body.book #preamble,
+    body.book #toc,
+    body.book .sect1>h2,
+    body.book h1.sect0 {
+        page-break-before: always
+    }
+    #footer {
+        background: 0 0!important;
+        padding: 0 .9375em
+    }
+    #footer-text {
+        color: rgba(0, 0, 0, .6)!important;
+        font-size: .9em
+    }
+    .hide-on-print {
+        display: none!important
+    }
+    .print-only {
+        display: block!important
+    }
+    .hide-for-print {
+        display: none!important
+    }
+    .show-for-print {
+        display: inherit!important
+    }
+}
+
+.reqlinks,
+.reqlinks a,
+.reqlinks:hover {
+    font-size: 13px;
+    font-weight: 400
+}
+
+.reqlinks {
+    color: silver
+}
+
+.reqitem,
+.reqitem code {
+    list-style-type: none;
+    line-height: 1.2;
+    font-size: smaller
+}
+
+#links {
+    position: relative
+}
+
+.treeview,
+.treeview ul {
+    list-style-type: none;
+    overflow: hidden
+}
+
+.treeview li {
+    text-indent: 10%;
+    margin-top: 0;
+    padding: .2em 0 0 0;
+    line-height: 20px;
+    background-repeat: no-repeat;
+    background-size: 16px 16px;
+    background-position-y: 4px
+}
+
+#toclist>li>ul>li {
+    font-size: 90%
+}
+
+#iconTree li {
+    font-weight: 700;
+    line-height: 15px;
+    font-size: 90%;
+    background-size: 16px 16px
+}
+
+.treeview li.contains-items {
+    font-weight: 700;
+    background-image: url(expand.png);
+    background-size: 16px 16px
+}
+
+.treeview li.items-expanded {
+    font-weight: 400;
+    background-image: url(collapse.png);
+    background-size: 16px 16px
+}
+
+.items-expanded>a::first-of-type {
+    font-weight: 700
+}
+
+.treview-dotted-lines li {
+    margin-top: .4em!important
+}
+
+.treview-dotted-lines li.items-expanded li {
+    font-weight: 700;
+    border-left: 1px dotted #444;
+    border-bottom: 1px dotted #444;
+    width: 60%
+}
+
+.treeview>li:hover {
+    cursor: pointer
+}
+
+.treeview span.has-node-icon {
+    text-indent: 2%;
+    margin-top: .2em;
+    padding: .15em 0 .5em 1em;
+    line-height: 22px;
+    background-repeat: no-repeat;
+    background-size: 24px 24px
+}
+
+.treeview span {
+    padding: 5px
+}
+
+.treeview span:not(.has-node-icon):hover {
+    background-color: rgba(246, 246, 246, .7)
+}
+
+body.toc2.toc-left #collapsetoc {
+    outline: 0;
+    display: none;
+    width: 25px;
+    height: 25px;
+    text-indent: -9999px;
+    position: fixed;
+    z-index: 998;
+    border: none;
+    left: 25px;
+    top: 55px;
+    background: url(arrow-down.png) no-repeat center 50%
+}
+
+body.toc2.toc-left #collapsetoc.inactive {
+    background-image: url(arrow-right.png)
+}
+
+.active {
+    border-right: 3px solid #2ba6cb;
+    color: #000;
+    font-weight: 700
+}
+
+.found {
+    color: #000;
+    font-weight: 700
+}
+
+#toc {
+    margin-top: 0
+}
+
+#toc>ul {
+    margin-left: 0;
+    padding-left: 0
+}
+
+#toc ul.sectlevel0>li>a {
+    font-style: italic
+}
+
+#toc ul.sectlevel0 ul.sectlevel1 {
+    margin: 0 0
+}
+
+#toc ul {
+    font-family: "Helvetica Neue", Helvetica, Helvetica, Arial, sans-serif;
+    list-style-type: none
+}
+
+#toc a {
+    color: #595959
+}
+
+#toc a:hover {
+    color: #000
+}
+
+#toc a:active {
+    text-decoration: underline
+}
+
+#pagesearch {
+    background-image: url(searchicon.png);
+    background-position: 5px 5px;
+    background-repeat: no-repeat;
+    width: 100%;
+    font-size: 16px;
+    padding: 6px 10px 6px 40px;
+    border: 1px solid #ddd;
+    margin-bottom: 12px
+}
+
+#clear {
+    position: absolute;
+    right: 10px;
+    top: 72px;
+    bottom: 0;
+    height: 14px;
+    font-size: 14px;
+    cursor: pointer;
+    color: #ccc
+}
\ No newline at end of file
diff --git a/idespec/styles/foundation.min.css b/idespec/styles/foundation.min.css
new file mode 100644
index 0000000..a45c129
--- /dev/null
+++ b/idespec/styles/foundation.min.css
@@ -0,0 +1 @@
+img,legend{border:0}body,figure{margin:0}body,table{background:#fff}#content:after,#footer:after,#footnotes:after,#header:after,.clearfix:after,.float-group:after,hr{clear:both}#toc,b.button:after,b.button:before,body,kbd,sub,sup{position:relative}#toc a,.vevent abbr,a,div.social>ul li{text-decoration:none}article,aside,details,figcaption,figure,footer,header,hgroup,main,nav,section,summary{display:block}audio,canvas,video{display:inline-block}audio:not([controls]){display:none;height:0}[hidden],template{display:none}script{display:none !important}html{font-family:sans-serif;-ms-text-size-adjust:100%;-webkit-text-size-adjust:100%}a:focus{outline:dotted thin}a:active,a:hover{outline:0}abbr[title]{border-bottom:1px dotted}b,strong{font-weight:700}dfn{font-style:italic}hr{-moz-box-sizing:content-box;box-sizing:content-box}mark{background:#ff0;color:#000}code,kbd,pre,samp{font-family:monospace, serif;font-size:1em}pre{white-space:pre-wrap}q{quotes:"\201C" "\201D" "\2018" "\2019"}sub,sup{font-size:75%;line-height:0;vertical-align:baseline}sup{top:-.5em}sub{bottom:-.25em}svg:not(:root){overflow:hidden}fieldset{border:1px solid silver;margin:0 2px;padding:.35em .625em .75em}legend{padding:0}button,input,select,textarea{font-family:inherit;font-size:100%;margin:0}button,input{line-height:normal}button,select{text-transform:none}button,html input[type=button],input[type=reset],input[type=submit]{-webkit-appearance:button;cursor:pointer}button[disabled],html input[disabled]{cursor:default}input[type=checkbox],input[type=radio]{box-sizing:border-box;padding:0}input[type=search]{-webkit-appearance:textfield;-moz-box-sizing:content-box;-webkit-box-sizing:content-box;box-sizing:content-box}input[type=search]::-webkit-search-cancel-button,input[type=search]::-webkit-search-decoration{-webkit-appearance:none}button::-moz-focus-inner,input::-moz-focus-inner{border:0;padding:0}textarea{overflow:auto;vertical-align:top;height:auto;min-height:50px}meta.foundation-mq-small{font-family:"only screen and (min-width: 500px)";width:500px}meta.foundation-mq-medium{font-family:"only screen and (min-width:1280px)";width:1280px}meta.foundation-mq-large{font-family:"only screen and (min-width:1440px)";width:1440px}.spread,select{width:100%}*,:after,:before{-moz-box-sizing:border-box;-webkit-box-sizing:border-box;box-sizing:border-box}body,html{font-size:100%}body{color:#595959;padding:0;font-family:"Helvetica Neue", Helvetica, Helvetica, Arial, sans-serif;font-weight:400;font-style:normal;line-height:1;cursor:auto max-width: 1280px;tab-size:4}a:hover{cursor:pointer}embed,img,object{max-width:100%;height:auto}embed,object{height:100%}#map_canvas embed,#map_canvas img,#map_canvas object,.map_canvas embed,.map_canvas img,.map_canvas object{max-width:none !important}.left{float:left !important}.right{float:right !important}.text-left{text-align:left !important}.text-right{text-align:right !important}.text-center{text-align:center !important}.text-justify{text-align:justify !important}.hide{display:none}img,object,svg{display:inline-block;vertical-align:middle}.antialiased,body{-webkit-font-smoothing:antialiased}img{-ms-interpolation-mode:bicubic}.center{margin-left:auto;margin-right:auto}#preamble>.sectionbody>.paragraph:first-of-type p,.paragraph.lead>p,p.lead{font-size:1.21875em;line-height:1.6}.admonitionblock td.content>.title,.audioblock>.title,.dlist>.title,.exampleblock>.title,.hdlist>.title,.imageblock>.title,.listingblock>.title,.literalblock>.title,.olist>.title,.openblock>.title,.paragraph>.title,.qlist>.title,.quoteblock>.title,.stemblock>.title,.subheader,.ulist>.title,.verseblock>.title,.videoblock>.title,table.tableblock>.title{line-height:1.4;color:#6f6f6f;font-weight:300;margin-top:.2em;margin-bottom:.5em}#toctitle,.sidebarblock>.content>.title,blockquote,dd,div,dl,dt,form,h1,h2,h3,h4,h5,h6,li,ol,p,pre,td,th,ul{margin:0;padding:0;direction:ltr}a{background:0 0;color:#2ba6cb;line-height:inherit}a:focus,a:hover{color:#2795b6}a img{border:none}p{font-family:inherit;font-weight:400;font-size:1em;line-height:1.6;margin-bottom:1.25em;text-rendering:optimizeLegibility}#toctitle,.admonitionblock>table td.icon .title,.sidebarblock>.content>.title,h1,h2,h3,h4,h5,h6{font-family:"Helvetica Neue", Helvetica, Helvetica, Arial, sans-serif}.vcard .fn,.vevent .summary,.vevent abbr,code,dl dt{font-weight:700}p aside{font-size:.875em;line-height:1.35;font-style:italic}#toctitle,.sidebarblock>.content>.title,h1,h2,h3,h4,h5,h6{font-weight:700;font-style:normal;color:#595959;text-rendering:optimizeLegibility;margin-top:1em;margin-bottom:.5em}dl,dl dd,ol,ul{margin-bottom:1.25em}#toctitle small,.sidebarblock>.content>.title small,h1 small,h2 small,h3 small,h4 small,h5 small,h6 small{font-size:60%;color:#6f6f6f;line-height:0}b,em,i,small,strong{line-height:inherit}h1{font-size:2.125em}h2{font-size:1.6875em}#toctitle,.sidebarblock>.content>.title,h3{font-size:1.375em}h4,h5{font-size:1.125em}h6{font-size:1em}hr{border:solid #ddd;border-width:1px 0 0;margin:1.25em 0 1.1875em;height:0}em,i{font-style:italic}small{font-size:60%}dl,ol,ul,ul li ol,ul li ul{font-size:1em}code{font-family:Consolas, "Liberation Mono", Courier, monospace;color:#7f0a0c}dl,ol,ul{line-height:1.6;list-style-position:outside;font-family:inherit}ol,ol.no-bullet,ul,ul.no-bullet{margin-left:1.5em}ol li ol,ol li ul,ul li ol,ul li ul{margin-left:1.25em;margin-bottom:0}ul.circle li ul,ul.disc li ul,ul.square li ul{list-style:inherit}#menubar ul,ul.inline,ul.inline>li,ul.no-bullet{list-style:none}ul.square{list-style-type:square}ul.circle{list-style-type:circle}ul.disc{list-style-type:disc}dl dt{margin-bottom:.3125em}.vcard,blockquote{margin:0 0 1.25em}abbr,acronym{text-transform:uppercase;font-size:90%;color:#222;border-bottom:1px dotted #ddd;cursor:help}abbr{text-transform:none}blockquote{padding:.5625em 1.25em 0 1.1875em;border-left:1px solid #ddd}blockquote cite{display:block;font-size:.8125em;color:#555}blockquote cite:before{content:"\2014 \0020"}blockquote cite a,blockquote cite a:visited{color:#555}blockquote,blockquote p{line-height:1.6;color:#6f6f6f}.vcard{display:inline-block;border:1px solid #ddd;padding:.625em .75em}.vcard li{margin:0;display:block}.vcard .fn{font-size:.9375em}.vevent abbr{cursor:auto;border:none;padding:0 .0625em}@media only screen and (min-width:500px){#toctitle,.sidebarblock>.content>.title,h1,h2,h3,h4,h5,h6{line-height:1.4}h1{font-size:2.75em}h2{font-size:2.3125em}#toctitle,.sidebarblock>.content>.title,h3{font-size:1.6875em}h4{font-size:1.4375em}}table{border-collapse:collapse;border-spacing:0;margin-bottom:1.25em;border:1px solid #ddd}table tfoot,table thead{background:#f5f5f5;font-weight:600}table tfoot tr td,table tfoot tr th,table thead tr td,table thead tr th{padding:.5em .625em .625em;font-size:inherit;color:#222;text-align:left}table tr td,table tr th{padding:.5625em .625em;font-size:inherit;color:#595959}table tr.alt,table tr.even,table tr:nth-of-type(even){background:#f9f9f9}table tbody tr td,table tfoot tr td,table tfoot tr th,table thead tr th,table tr td{display:table-cell;line-height:1.4}#toctitle,.sidebarblock>.content>.title,h1,h2,h3,h4,h5,h6{line-height:1.4}.clearfix:after,.clearfix:before,.float-group:after,.float-group:before{content:" ";display:table}:not(pre)>code{font-size:inherit;font-style:normal !important;letter-spacing:0;padding:0;line-height:inherit}pre,pre>code{line-height:1.4;color:#000;font-family:monospace, serif;font-weight:400}.keyseq{color:#555}kbd{font-family:Consolas, "Liberation Mono", Courier, monospace;display:inline-block;color:#222;font-size:.65em;line-height:1.45;background-color:#f7f7f7;border:1px solid #ccc;-webkit-border-radius:3px;border-radius:3px;-webkit-box-shadow:0 1px 0 rgba(0, 0, 0, .2), 0 0 0 .1em #fff inset;box-shadow:0 1px 0 rgba(0, 0, 0, .2), 0 0 0 .1em #fff inset;margin:0 .15em;padding:.2em .5em;vertical-align:middle;top:-.1em;white-space:nowrap}table.pyhltable td,td.valign-top,th.valign-top{vertical-align:top}.keyseq kbd:first-child{margin-left:0}.keyseq kbd:last-child{margin-right:0}.menu,.menuseq{color:#090909}b.button:after,b.button:before{top:-1px;font-weight:400}b.button:before{content:"[";padding:0 3px 0 2px}b.button:after{content:"]";padding:0 2px 0 3px}#content,#footer,#footnotes,#header{max-width:1300px;margin-right:80px;margin-top:0;margin-bottom:0;position:relative;padding-left:0;padding-right:.9375em;left:40px}#content:after,#content:before,#footer:after,#footer:before,#footnotes:after,#footnotes:before,#header:after,#header:before{content:" ";display:table}#content{margin-top:1.25em;padding-right:0;margin-right:115px}#content:before{content:none}#header>h1:first-child{color:#595959;margin-top:2.25rem;margin-bottom:0}#header>h1:first-child+#toc{margin-top:8px;border-top:1px solid #ddd}#header>h1:only-child,body.toc2 #header>h1:nth-last-child(2){border-bottom:1px solid #ddd;padding-bottom:8px}#header .details{border-bottom:1px solid #ddd;line-height:1.45;padding-top:.25em;padding-bottom:.25em;padding-left:.25em;color:#555;display:-ms-flexbox;display:-webkit-flex;display:flex;-ms-flex-flow:row wrap;-webkit-flex-flow:row wrap;flex-flow:row wrap}#header .details span:first-child{margin-left:-.125em}#header .details span.email a{color:#6f6f6f}#header .details br{display:none}#header .details br+span:before{content:"\00a0\2013\00a0"}#header .details br+span.author:before{content:"\00a0\22c5\00a0";color:#6f6f6f}#header .details br+span#revremark:before{content:"\00a0|\00a0"}#header #revnumber{text-transform:capitalize}#header #revnumber:after{content:"\00a0"}#content>h1:first-child:not([class]){color:#000;border-bottom:1px solid #ddd;padding-bottom:8px;margin-top:0;padding-top:1rem;margin-bottom:1.25rem}#toc ul li:before,div#faq li:before,div#features-nav li:before,div.ulist li:before{content:"";color:#244d82}#toc{border-bottom:1px solid #ddd;padding-bottom:.5em;left:0}#toc li{line-height:1.3334;margin-top:0;padding-left:5px}#toc ul li:before{margin-left:-.75em;margin-right:.4em}div.ulist li:before{position:absolute;font-size:x-large;line-height:1rem;margin:.2rem 0 -.75em -.75em}#faq,#features-nav{margin-bottom:20px;z-index:1;padding-left:2rem;border-left:1px solid #d3d3d3}#toctitle{color:#595959;font-size:1.2em;padding-left:1em}#faq{position:relative;right:9.3rem;top:9rem;left:45rem}@media only screen and (max-width:945px){div#faq{display:none}}#faq h2{font-size:25px;font-weight:600;margin-top:-8rem}div#faq li:before,div#features-nav li:before{position:absolute;font-size:x-large;margin-left:-.75em;margin-bottom:-.75em;margin-right:0;line-height:1rem}#features-nav{right:1rem;top:2rem;position:absolute}@media only screen and (max-width:993px){#features-nav{display:none}}#features-nav h2{font-size:25px;font-weight:600;margin-top:-1rem}#features-nav li{margin-top:.3rem}@media only screen and (min-width:500px){#toctitle{padding-top:0;font-size:1.375em}body.toc2{padding-left:2em;padding-right:1em}#toc.toc2{margin-top:0 !important;background-color:#f2f2f2;position:fixed;width:260px;left:0;top:0;border-right:1px solid #ddd;border-top-width:0 !important;border-bottom-width:0 !important;z-index:1000;padding:1.25em .25em 0;height:100%;overflow:auto}#toc.toc2 #toctitle{margin-top:0;margin-bottom:.8rem;font-size:1.2em;padding-left:1em}#toc.toc2>ul{font-size:.9em;margin-bottom:0}#toc.toc2 ul ul{margin-left:6px}#toc.toc2 ul.sectlevel0 ul.sectlevel1{padding-left:10px;margin-top:.5em;margin-bottom:.5em}body.toc2.toc-right{padding-left:2em;padding-right:2em}body.toc2.toc-right #toc.toc2{border-right-width:0;border-left:1px solid #ddd;left:auto;right:-260px}}body.toc2.toc-left #toc.toc2{left:0}@media only screen and (min-width:1000px){#toc.toc2 #toctitle,#toctitle{font-size:1.375em}#content{max-width:1260px}body.toc2{padding-left:260px;padding-right:2em}#toctitle{padding-top:0}#toc.toc2{width:260px}#toc.toc2>ul{font-size:.95em}#toc.toc2 ul ul{padding-left:0}body.toc2.toc-right{padding-left:2em;padding-right:2em}}#content #toc{border-style:solid;border-width:1px;border-color:#d9d9d9;margin-bottom:1.25em;padding:1.25em;background:#f2f2f2;-webkit-border-radius:0;border-radius:0}#content #toc>:first-child{margin-top:0}#footer,div.social{margin-top:2rem;color:#fff}#content #toc>:last-child{margin-bottom:0}#footer{padding:1.25em 1.25em 0}div.social{padding:1.25em 1.25em 0 30px}.exampleblock>.content>:first-child,.sidebarblock>:first-child{margin-top:0}div.social>ul li{color:#fff;line-height:1.44;font-size:1.2em;font-weight:800;font-style:bold;position:relative;list-style:none;display:inline}#bottomright{float:right}#footer-text{color:#ddd;line-height:1.44}.sect1{padding-bottom:.625em}@media only screen and (min-width:500px){.sect1{padding-bottom:1.25em}}.sect1+.sect1{border-top:1px solid #ddd}#content h1>a.anchor,#toctitle>a.anchor,.sidebarblock>.content>.title>a.anchor,h2>a.anchor,h3>a.anchor,h4>a.anchor,h5>a.anchor,h6>a.anchor{position:absolute;z-index:1001;width:1.5ex;margin-left:-1.5ex;display:block;text-decoration:none !important;visibility:hidden;text-align:center;font-weight:400}a.image,sup.footnote a,sup.footnoteref a{text-decoration:none}#content h1>a.anchor:before,#toctitle>a.anchor:before,.sidebarblock>.content>.title>a.anchor:before,h2>a.anchor:before,h3>a.anchor:before,h4>a.anchor:before,h5>a.anchor:before,h6>a.anchor:before{content:"\00A7";font-size:.85em;display:block;padding-top:.1em}#content h1:hover>a.anchor,#content h1>a.anchor:hover,#toctitle:hover>a.anchor,#toctitle>a.anchor:hover,.sidebarblock>.content>.title:hover>a.anchor,.sidebarblock>.content>.title>a.anchor:hover,h2:hover>a.anchor,h2>a.anchor:hover,h3:hover>a.anchor,h3>a.anchor:hover,h4:hover>a.anchor,h4>a.anchor:hover,h5:hover>a.anchor,h5>a.anchor:hover,h6:hover>a.anchor,h6>a.anchor:hover{visibility:visible}#content h1>a.link,#toctitle>a.link,.sidebarblock>.content>.title>a.link,h2>a.link,h3>a.link,h4>a.link,h5>a.link,h6>a.link{color:#595959;text-decoration:none}#content h1>a.link:hover,#toctitle>a.link:hover,.sidebarblock>.content>.title>a.link:hover,h2>a.link:hover,h3>a.link:hover,h4>a.link:hover,h5>a.link:hover,h6>a.link:hover{color:#151515}.audioblock,.imageblock,.listingblock,.literalblock,.stemblock,.videoblock{margin-bottom:1.25em}.admonitionblock td.content>.title,.audioblock>.title,.dlist>.title,.exampleblock>.title,.hdlist>.title,.imageblock>.title,.listingblock>.title,.literalblock>.title,.olist>.title,.openblock>.title,.paragraph>.title,.qlist>.title,.quoteblock>.title,.stemblock>.title,.ulist>.title,.verseblock>.title,.videoblock>.title,table.tableblock>.title{text-rendering:optimizeLegibility;text-align:left}table.tableblock>caption.title{white-space:nowrap;overflow:visible;max-width:0}#preamble>.sectionbody>.paragraph:first-of-type p,.paragraph.lead>p{color:#000}table.tableblock #preamble>.sectionbody>.paragraph:first-of-type p{font-size:inherit}.admonitionblock>table{border-collapse:separate;border:0;background:0 0;width:100%}.admonitionblock>table td.icon{text-align:center;width:80px}.admonitionblock>table td.icon img{max-width:none}.admonitionblock>table td.icon .title{font-weight:700;text-transform:uppercase}.admonitionblock>table td.content{padding-left:1.125em;padding-right:1.25em;border-left:1px solid #ddd;color:#555}.admonitionblock>table td.content>:last-child>:last-child{margin-bottom:0}.exampleblock>.content{border-style:solid;border-width:1px;border-color:#e6e6e6;margin-bottom:1.25em;padding:1.25em;background:#fff;-webkit-border-radius:0;border-radius:0}.exampleblock>.content .olist>ol>li:last-child>:last-child,.exampleblock>.content .qlist>ol>li:last-child>:last-child,.exampleblock>.content .ulist>ul>li:last-child>:last-child,.exampleblock>.content>:last-child,.exampleblock>.content>:last-child>:last-child,.sidebarblock>.content .olist>ol>li:last-child>:last-child,.sidebarblock>.content .qlist>ol>li:last-child>:last-child,.sidebarblock>.content .ulist>ul>li:last-child>:last-child,.sidebarblock>.content>:last-child>:last-child,.sidebarblock>:last-child,table.pyhltable{margin-bottom:0}.sidebarblock{position:absolute;border-style:solid;width:90px;border-width:1px;border-color:#d9d9d9;right:-90px;padding:.1rem;background:#f2f2f2;-webkit-border-radius:0;text-align:left;border-radius:5px}.sidebarblock>.content>.title{color:#6999d6;margin-top:0}.listingblock pre.CodeRay,.listingblock pre.prettyprint,.listingblock pre:not(.highlight),.listingblock pre[class=highlight],.listingblock pre[class^="highlight "],.literalblock pre{background:#eee}.sidebarblock .listingblock pre.CodeRay,.sidebarblock .listingblock pre.prettyprint,.sidebarblock .listingblock pre:not(.highlight),.sidebarblock .listingblock pre[class=highlight],.sidebarblock .listingblock pre[class^="highlight "],.sidebarblock .literalblock pre{background:#f2f1f1}.listingblock pre,.listingblock pre[class],.literalblock pre,.literalblock pre[class]{border:1px solid #ccc;-webkit-border-radius:0;border-radius:0;word-wrap:break-word;padding:.8em .8em .65em;font-size:.8125em}.listingblock pre.nowrap,.listingblock pre[class].nowrap,.literalblock pre.nowrap,.literalblock pre[class].nowrap{overflow-x:auto;white-space:pre;word-wrap:normal}#logo,ul.inline{overflow:hidden}@media only screen and (min-width:500px){.listingblock pre,.listingblock pre[class],.literalblock pre,.literalblock pre[class]{font-size:.90625em}}@media only screen and (min-width:1280px){.listingblock pre,.listingblock pre[class],.literalblock pre,.literalblock pre[class]{font-size:1em}}.literalblock.output pre{color:#eee;background-color:#000}.listingblock pre.highlightjs{padding:0}.listingblock pre.highlightjs>code{padding:.8em .8em .65em;-webkit-border-radius:0;border-radius:0}.listingblock>.content{position:relative}.listingblock.terminal pre .command:before{content:attr(data-prompt);padding-right:.5em;color:#999}.listingblock.terminal pre .command:not([data-prompt]):before{content:"$"}table.pyhltable{border-collapse:separate;border:0;background:0 0}table.pyhltable td{padding-top:0;padding-bottom:0;line-height:1.4}table.pyhltable td.code{padding-left:.75em;padding-right:0}pre.pygments .lineno,table.pyhltable td:not(.code){color:#999;padding-left:0;padding-right:.5em;border-right:1px solid #ddd}pre.pygments .lineno{display:inline-block;margin-right:.25em}table.pyhltable .linenodiv{background:0 0 !important;padding-right:0 !important}.quoteblock{margin:0 1em 1.25em 1.5em;display:table}.quoteblock .attribution br,.quoteblock .quoteblock blockquote:before,.verseblock .attribution br{display:none}.quoteblock>.title{margin-left:-1.5em;margin-bottom:.75em}.quoteblock blockquote,.quoteblock blockquote p{color:#6f6f6f;font-size:1.15rem;line-height:1.75;word-spacing:.1em;letter-spacing:0;font-style:italic;text-align:justify}.quoteblock blockquote{margin:0;padding:0;border:0}.quoteblock blockquote:before{content:"\201c";float:left;font-size:2.75em;font-weight:700;line-height:.6em;margin-left:-.6em;color:#6f6f6f;text-shadow:0 1px 2px rgba(0, 0, 0, .1)}.quoteblock blockquote>.paragraph:last-child p{margin-bottom:0}.quoteblock .attribution{margin-top:.5em;margin-right:.5ex;text-align:right}.quoteblock .quoteblock{margin-left:0;margin-right:0;padding:.5em 0;border-left:3px solid #555}.quoteblock .quoteblock blockquote{padding:0 0 0 .75em}.verseblock{margin:0 1em 1.25em}.verseblock pre{font-family:"Open Sans", "DejaVu Sans", sans;font-size:1.15rem;color:#6f6f6f;font-weight:300;text-rendering:optimizeLegibility}.verseblock pre strong{font-weight:400}.verseblock .attribution{margin-top:1.25rem;margin-left:.5ex}.quoteblock .attribution,.verseblock .attribution{font-size:.8125em;line-height:1.45;font-style:italic}.quoteblock .attribution cite,.verseblock .attribution cite{display:block;letter-spacing:-.025em;color:#555}.quoteblock.abstract{margin:0 0 1.25em;display:block}dl dd:last-child,dl dd:last-child>:last-child,table.tableblock td>.paragraph:last-child p>p:last-child,table.tableblock td>p:last-child,table.tableblock th>p:last-child{margin-bottom:0}.quoteblock.abstract blockquote,.quoteblock.abstract blockquote p{text-align:left;word-spacing:0}.quoteblock.abstract blockquote p:first-of-type:before,.quoteblock.abstract blockquote:before{display:none}table.tableblock{max-width:100%;border-collapse:separate}table.tableblock,td.tableblock,th.tableblock{border:0 solid #ddd}table.grid-all td.tableblock,table.grid-all th.tableblock{border-width:0 1px 1px 0}table.grid-all tfoot>tr>td.tableblock,table.grid-all tfoot>tr>th.tableblock{border-width:1px 1px 0 0}table.grid-cols td.tableblock,table.grid-cols th.tableblock{border-width:0 1px 0 0}table.grid-all *>tr>.tableblock:last-child,table.grid-cols *>tr>.tableblock:last-child{border-right-width:0}table.grid-rows td.tableblock,table.grid-rows th.tableblock{border-width:0 0 1px}table.grid-all tbody>tr:last-child>td.tableblock,table.grid-all tbody>tr:last-child>th.tableblock,table.grid-all thead:last-child>tr>th.tableblock,table.grid-rows tbody>tr:last-child>td.tableblock,table.grid-rows tbody>tr:last-child>th.tableblock,table.grid-rows thead:last-child>tr>th.tableblock{border-bottom-width:0}table.grid-rows tfoot>tr>td.tableblock,table.grid-rows tfoot>tr>th.tableblock{border-width:1px 0 0}table.frame-all{border-width:1px}table.frame-sides{border-width:0 1px}table.frame-topbot{border-width:1px 0}td.halign-left,th.halign-left{text-align:left}td.halign-right,th.halign-right{text-align:right}td.halign-center,th.halign-center{text-align:center}td.valign-bottom,th.valign-bottom{vertical-align:bottom}td.valign-middle,th.valign-middle{vertical-align:middle}table tfoot th,table thead th{font-weight:700}tbody tr th{display:table-cell;line-height:1.4;background:#f5f5f5}ul.inline>li,ul.inline>li>*{display:block}tbody tr th,tbody tr th p,tfoot tr th,tfoot tr th p{color:#222;font-weight:700}p.tableblock>code:only-child{background:0 0;padding:0}p.tableblock{font-size:1em}td>div.verse{white-space:pre}ol{margin-left:1.75em}ul li ol{margin-left:1.5em}dl dd{margin-left:1.125em}.olist .olist,.olist .ulist,.ulist .olist,.ulist .ulist,ol dd,ol>li p,ul dd,ul>li p{margin-bottom:.625em}ol.unnumbered,ul.checklist,ul.none,ul.unstyled{list-style-type:none}ol.unnumbered,ul.checklist,ul.unstyled{margin-left:.625em}ul.checklist li>p:first-child>.fa-check-square-o:first-child,ul.checklist li>p:first-child>.fa-square-o:first-child{width:1em;font-size:.85em}ul.checklist li>p:first-child>input[type=checkbox]:first-child{width:1em;position:relative;top:1px}ul.inline{margin:0 0 .625em -1.375em;padding:0}ul.inline>li{float:left;margin-left:1.375em}.conum[data-value],.th,.thumb,a.image{display:inline-block}.unstyled dl dt{font-weight:400;font-style:normal}ol.arabic{list-style-type:decimal}ol.decimal{list-style-type:decimal-leading-zero}ol.loweralpha{list-style-type:lower-alpha}ol.upperalpha{list-style-type:upper-alpha}ol.lowerroman{list-style-type:lower-roman}ol.upperroman{list-style-type:upper-roman}ol.lowergreek{list-style-type:lower-greek}.colist>table,.hdlist>table{border:0;background:0 0}.colist>table>tbody>tr,.hdlist>table>tbody>tr{background:0 0}td.hdlist1,td.hdlist2{vertical-align:top;padding:0 .625em}td.hdlist1{font-weight:700;padding-bottom:1.25em}.listingblock+.colist,.literalblock+.colist{margin-top:-.5em}.colist>table tr>td:first-of-type{padding:0 .75em;line-height:1}.colist>table tr>td:last-of-type{padding:.25em 0}.th,.thumb{line-height:0;border:4px solid #fff;-webkit-box-shadow:0 0 0 1px #ddd;box-shadow:0 0 0 1px #ddd}.imageblock.left,.imageblock[style*="float: left"]{margin:.25em .625em 1.25em 0}.imageblock.right,.imageblock[style*="float: right"]{margin:.25em 0 1.25em .625em}.imageblock>.title{margin-bottom:0}.imageblock.th,.imageblock.thumb{border-width:6px}.imageblock.th>.title,.imageblock.thumb>.title{padding:0 .125em}.image.left,.image.right{margin-top:.25em;margin-bottom:.25em;display:inline-block;line-height:0}.image.left{margin-right:.625em}.image.right{margin-left:.625em}a.image object{pointer-events:none}sup.footnote,sup.footnoteref{font-size:.875em;position:static;vertical-align:super}#logo,#menubar,#menubar>ul>li,#menubar>ul>li::after{position:relative}sup.footnote a:active,sup.footnoteref a:active{text-decoration:underline}#footnotes{padding-top:.75em;padding-bottom:.75em;margin-bottom:.625em}#footnotes hr{width:20%;min-width:6.25em;margin:-.25em 0 .75em;border-width:1px 0 0}#footnotes .footnote{padding:0 .375em .2em .225em;line-height:1.3334;font-size:.875em;margin-left:1.2em;text-indent:-1.05em;margin-bottom:.2em}#footnotes .footnote a:first-of-type{font-weight:700;text-decoration:none}#footnotes .footnote:last-of-type{margin-bottom:0}#content #footnotes{margin-top:-.625em;margin-bottom:0;padding:.75em 0}.gist .file-data>table{border:0;background:#fff;width:100%;margin-bottom:0}.gist .file-data>table td.line-data{width:99%}div.unbreakable{page-break-inside:avoid}.big{font-size:larger}.small{font-size:smaller}.x-small{font-size:x-small}.xx-small{font-size:xx-small}.x-large{font-size:x-large}.xx-large{font-size:xx-large}.underline{text-decoration:underline}.overline{text-decoration:overline}.line-through{text-decoration:line-through}.aqua{color:#00bfbf}.aqua-background{background-color:#00fafa}.black{color:#000}.black-background{background-color:#000}.blue{color:#0000bf}.blue-background{background-color:#0000fa}.fuchsia{color:#bf00bf}.fuchsia-background{background-color:#fa00fa}.gray{color:#606060}.gray-background{background-color:#7d7d7d}.green{color:#006000}.green-background{background-color:#007d00}.lime{color:#00bf00}.lime-background{background-color:#00fa00}.maroon{color:#600000}.maroon-background{background-color:#7d0000}.navy{color:#000060}.navy-background{background-color:#00007d}.olive{color:#606000}.olive-background{background-color:#7d7d00}.purple{color:#600060}.purple-background{background-color:#7d007d}.red{color:#bf0000}.red-background{background-color:#fa0000}.silver{color:#909090}.silver-background{background-color:#bcbcbc}.teal{color:#006060}.teal-background{background-color:#007d7d}.white{color:#bfbfbf}.white-background{background-color:#fafafa}.yellow{color:#bfbf00}.yellow-background{background-color:#fafa00}span.icon>.fa{cursor:default}.admonitionblock td.icon [class^="fa icon-"]{font-size:2.5em;text-shadow:1px 1px 2px rgba(0, 0, 0, .5);cursor:default}#clear,.treeview>li:hover{cursor:pointer}.admonitionblock td.icon .icon-note:before{content:"\f05a";color:#207c98}.admonitionblock td.icon .icon-tip:before{content:"\f0eb";text-shadow:1px 1px 2px rgba(155, 155, 0, .8);color:#111}.admonitionblock td.icon .icon-warning:before{content:"\f071";color:#bf6900}.admonitionblock td.icon .icon-caution:before{content:"\f06d";color:#bf3400}.admonitionblock td.icon .icon-important:before{content:"\f06a";color:#bf0000}.conum[data-value],.conum[data-value] *{color:#fff !important}.conum[data-value]{background-color:#222;-webkit-border-radius:100px;border-radius:100px;text-align:center;font-size:.75em;width:1.67em;height:1.67em;line-height:1.67em;font-family:"Open Sans", "DejaVu Sans", sans-serif;font-style:normal;font-weight:700}#menu,.conum:not([data-value]):empty,.conum[data-value]+b{display:none}.conum[data-value]:after{content:attr(data-value)}pre .conum[data-value]{position:relative;top:-.125em}b.conum *{color:inherit !important}.listingblock pre,.literalblock pre{background:#eee}div#remarks.ulist{max-width:70%}@media only screen and (max-width:800px){a#bottomright{visibility:hidden}#preamble>.sectionbody>.paragraph:first-of-type p,.paragraph.lead>p,.sectionbody.paragraph{max-width:100%}}#div.paragraph.faq-intro{max-width:66.66%}div.slicknav_menu{padding-top:5px;padding-right:15px;margin-left:200px;text-align:right;display:none;right:10px;font-size:1rem;color:#fff;padding-bottom:2rem;background:url(logo.png) 100px 0 no-repeat}span.slicknav_menutxt{margin-right:-20px;color:#fff}div.slicknav_menu a.scroll:first-of-type{color:#F7D425;font-size:120%;font-weight:600}div.slicknav_menu ul li a{color:#fff}div.slicknav_menu a:hover,div.slicknav_menu ul li a:hover{color:#F7D425}div.slicknav_menu a,div.slicknav_menu a:visited,li.slicknav_parent.slicknav_open{color:#fff}a.slicknav_btn{padding:1rem}@media screen and (max-width:890px){div.slicknav_menu{display:block;color:#fff}#mobile-banner{display:block}}@media screen and (max-width:470px){div.slicknav_menu ul:first-of-type{margin-top:1.5rem}div.slicknav_menu ul li{color:#fff}div.slicknav_menu ul li:hover{color:#F7D425}}div.slicknav_menu li:last-of-type{padding-bottom:.7rem}.banner{height:1rem;padding-right:2rem;max-height:1rem;max-width:50%;vertical-align:middle}@media (max-width:800px){.banner{flex-basis:66.66%;max-width:25%;margin:1rem}}#menubar ul{margin:0;padding:0 10px;white-space:nowrap;line-height:1.2rem}#menubar a,#menubar li{margin:0;padding:0}#menubar a{text-decoration:none}#menubar li{margin-left:0}#menubar{height:90px;max-width:1280px;margin-left:50px;color:#fff;font-size:1.9rem;border-bottom:#595959;border-bottom:2px solid #ddd}#menubar img{padding-left:45px;margin-top:15px;padding-top:.2rem}#menubar>ul>li{display:inline-block;margin:.2rem;z-index:10000;flex-basis:66.666%;font-weight:700}@media only screen and (max-width:500px){#menubar,#menubar>ul>li{visibility:hidden;display:none}#toc.toc2{display:none}}@media only screen and (max-width:500px){body.toc2.toc-right #tocbutton{visibility:hidden}#content,#footer,#footnotes,#header{margin-left:0;left:0}body.toc2{padding-left:20px;left:0}}@media only screen and (max-width:500px){#menubar{display:none}}#logo{margin-top:-55px;left:5px;top:10px}#menubar>ul>li::after{content:" · ";top:3px;padding-left:3px;font-weight:400}#menubar>ul>li:last-of-type::after{content:none}#menubar>ul>li>a{font-size:1.2rem;line-height:50px;font-weight:400;webkit-transition:color .15s;margin-left:0;-moz-transition:color .15s;-o-transition:color .15s;transition:color .15s;white-space:nowrap;-webkit-font-smoothing:auto;letter-spacing:-.01em;text-align:right}#iconTree li,#toc>ul>li>a,body.home li.home,body.tech li.tech{font-weight:700}#menubar>ul{margin-right:12px;margin-top:1px}#menubar>ul>li>a:hover{color:#F7D425}#menubar>ul>li>ul{opacity:0;visibility:hidden;padding:18px 0 20px;background-color:#FFF;text-align:left;position:absolute;top:55px;left:50%;margin-left:-90px;-webkit-transition:all .3s .1s;-moz-transition:all .3s .1s;-o-transition:all .3s .1s;transition:all .3s .1s;-webkit-border-radius:5px;-moz-border-radius:5px;border-radius:5px;-webkit-box-shadow:0 1px 3px rgba(0, 0, 0, .4);-moz-box-shadow:0 1px 3px rgba(0, 0, 0, .4);box-shadow:0 1px 3px rgba(0, 0, 0, .4)}#menubar>li li{width:100%}#menubar>ul>li:hover>ul{opacity:1;top:65px;visibility:visible}#menubar>ul>li>ul:before{content:'';display:block;border-color:transparent transparent #FFF;border-style:solid;border-width:10px;position:absolute;top:-20px;left:10%;margin-left:-10px}#menubar>ul ul>li{position:relative}#menubar ul ul a{color:#323232;font-family:ITC Officina Serif W01, sans-serif, Verdana, 'Lucida Grande';font-size:17px;background-color:#FFF;padding:5px 8px 7px 16px;display:block;-webkit-transition:background-color .1s;-moz-transition:background-color .1s;-o-transition:background-color .1s;transition:background-color .1s}#menubar ul ul ul{visibility:hidden;opacity:0;position:absolute;top:-16px;left:206px;padding:16px 0 20px;background-color:#527AA3;text-align:left;width:160px;-webkit-transition:all .3s;-moz-transition:all .3s;-o-transition:all .3s;transition:all .3s;-webkit-border-radius:5px;-moz-border-radius:5px;border-radius:5px;-webkit-box-shadow:0 1px 3px rgba(0, 0, 0, .4);-moz-box-shadow:0 1px 3px rgba(0, 0, 0, .4);box-shadow:0 1px 3px rgba(0, 0, 0, .4)}a.back-to-top,body.toc2.toc-right a.back-to-top{width:25px;height:25px;text-indent:-9999px;position:fixed;bottom:20px}#menubar ul ul>li:hover>ul{opacity:1;left:196px;visibility:visible}#menubar ul ul a:hover{background-color:#244D82;color:#F7D425}a.back-to-top{display:none;z-index:999;right:20px;background:url(up-arrow.png) center 43% no-repeat #2ba6cb;-webkit-border-radius:30px;-moz-border-radius:30px;border-radius:30px}a:hover.back-to-top{background-color:#F7D425}#tocbutton{visibility:hidden}#tocbuttonbars.fa.fa-bars{z-index:1000;right:0}#tocbutton:hover{background:url(yellowbars.png) center 50% no-repeat}body.toc2.toc-right a.back-to-top{z-index:1001;right:90px;background:url(up-arrow.png) center 43% no-repeat #2ba6cb;-webkit-border-radius:30px;-moz-border-radius:30px;border-radius:30px}body.toc2.toc-left #tocbutton,body.toc2.toc-right #tocbutton{visibility:visible;width:25px;text-indent:-9999px;border:none;height:25px;position:fixed;z-index:998}body.toc2.toc-right #tocbutton{right:25px;top:5px;background:url(yellowbars.png) center 50% no-repeat}body.toc2.toc-left #tocbutton{left:25px;top:25px;background:url(bars-blue.png) center 50% no-repeat}body.toc2.toc-right #tocbutton:hover{background:url(yellowbars.png) center 50% no-repeat}#pagesearch,.treeview li{background-repeat:no-repeat}body.toc2.toc-right a:hover.back-to-top{background-color:#F7D425}@media only screen and (max-width:1000px){#toc.toc2{display:none}}@media only screen and (max-width:500px){body.toc2.toc-left #tocbutton{visibility:hidden}#toc.toc2{width:100%;left:0}#content,#footer,#footnotes,#header{margin-left:0;margin-right:50px}}@media only screen and (max-width:1462px){a.back-to-top{left:90%}}div.openblock.definition{border:1px solid #aaa;margin-bottom:1rem;background-color:#f0f8ff;border-radius:10px;padding:1rem}.requirement{border:1px solid #aaa;margin-bottom:1rem;background-color:#f5f5f5;border-radius:10px;padding:1rem}.bibliography .content .paragraph p:first-child::before{color:#777;content:"[" attr(id) "] "}.bibliography .content .paragraph{padding-left:6em;text-indent:-6em}.hold,.todo{padding:12px;margin-bottom:15px}.todo{color:#dc143c;border:dotted #dc143c;border-width:2px;border-radius:15px;background-color:#fff8dc}.todo::before{content:"TODO"}.hold{color:#ff8c00;border:dotted #ff8c00;border-width:2px;border-radius:15px;background-color:#f5f5f5}.hold::before{content:"ON HOLD"}#toc>ul>li>a{color:#595959;font-size:medium}#toc a:hover,.active,.found{color:#000}#iconTree li,#toclist>li>ul>li{font-size:90%}.treeview,.treeview ul{list-style-type:none;overflow:hidden}.treeview li{text-indent:10%;margin-top:0;padding:.2em 0 0;line-height:20px;background-size:16px 16px;background-position-y:4px}#iconTree li{line-height:15px;background-size:16px 16px}.treeview li.contains-items{font-weight:700;background-image:url(expand.png);background-size:16px 16px}.treeview li.items-expanded{font-weight:400;background-image:url(collapse.png);background-size:16px 16px}.active,.found,.items-expanded>a::first-of-type{font-weight:700}.treview-dotted-lines li{margin-top:.4em !important}.treview-dotted-lines li.items-expanded li{font-weight:700;border-left:1px dotted #444;border-bottom:1px dotted #444;width:60%}.treeview span.has-node-icon{text-indent:2%;margin-top:.2em;padding:.15em 0 .5em 1em;line-height:22px;background-repeat:no-repeat;background-size:24px 24px}.treeview span{padding:5px}.treeview span:not(.has-node-icon):hover{background-color:rgba(246, 246, 246, .7)}#collapsetoc{outline:0;display:none;width:25px;height:25px;text-indent:-9999px;position:fixed;z-index:998;border:none;left:25px;top:55px;background:url(arrow-down.png) center 50% no-repeat}#collapsetoc.inactive{background-image:url(arrow-right.png)}.active{border-right:3px solid #2ba6cb}#toc{margin-top:0}#toc>ul{margin-left:0;padding-left:0}#toc ul.sectlevel0>li>a{font-style:italic}#toc ul.sectlevel0 ul.sectlevel1{margin:0}#toc ul{font-family:"Helvetica Neue", Helvetica, Helvetica, Arial, sans-serif;list-style-type:none}#toc a{color:#595959}#toc a:active{text-decoration:underline}#pagesearch{background-image:url(searchicon.png);background-position:5px 5px;width:100%;font-size:16px;padding:6px 10px 6px 40px;border:1px solid #ddd;margin-bottom:12px}#clear{position:absolute;right:10px;top:72px;bottom:0;height:14px;font-size:14px;color:#ccc}
diff --git a/idespec/styles/n4js-adoc.css b/idespec/styles/n4js-adoc.css
new file mode 100644
index 0000000..2d585fc
--- /dev/null
+++ b/idespec/styles/n4js-adoc.css
@@ -0,0 +1,1278 @@
+@import url("backtotop.css");
+
+/* ========================================================================== HTML5 display definitions ========================================================================== */
+/** Correct `block` display not defined in IE 8/9. */
+@import url(https://fast.fonts.net/cssapi/20974f8a-0939-4574-aef9-681eda2faca8.css);
+article, aside, details, figcaption, figure, footer, header, hgroup, main, nav, section, summary { display: block; }
+
+/** Correct `inline-block` display not defined in IE 8/9. */
+audio, canvas, video { display: inline-block; }
+
+/** Prevent modern browsers from displaying `audio` without controls. Remove excess height in iOS 5 devices. */
+audio:not([controls]) { display: none; height: 0; }
+
+/** Address `[hidden]` styling not present in IE 8/9. Hide the `template` element in IE, Safari, and Firefox < 22. */
+[hidden], template { display: none; }
+
+script { display: none !important; }
+
+/* ========================================================================== Base ========================================================================== */
+/** 1. Set default font family to sans-serif. 2. Prevent iOS text size adjust after orientation change, without disabling user zoom. */
+html { /* 1 */ -ms-text-size-adjust: 100%; /* 2 */ -webkit-text-size-adjust: 100%; /* 2 */ background-color: #D5DFEA; }
+
+/** Remove default margin. */
+body { margin: 0; background-color: #D5DFEA; font-family:sans-serif; font-weight: 400} /* add margin-right 0 here for mobile*/
+
+/* ========================================================================== Links ========================================================================== */
+/** Remove the gray background color from active links in IE 10. */
+a { background: transparent; }
+
+/** Address `outline` inconsistency between Chrome and other browsers. */
+a:focus { outline: thin dotted; }
+
+/** Improve readability when focused and also mouse hovered in all browsers. */
+a:active, a:hover { outline: 0; }
+
+/* ========================================================================== Typography ========================================================================== */
+/** Address variable `h1` font-size and margin within `section` and `article` contexts in Firefox 4+, Safari 5, and Chrome. */
+h1 { font-size: 2em; margin: 0.67em 0; }
+
+/** Address styling not present in IE 8/9, Safari 5, and Chrome. */
+abbr[title] { border-bottom: 1px dotted; }
+
+/** Address style set to `bolder` in Firefox 4+, Safari 5, and Chrome. */
+b, strong { font-weight: 600; }
+
+/** Address styling not present in Safari 5 and Chrome. */
+dfn { font-style: italic; }
+
+/** Address differences between Firefox and other browsers. */
+hr { -moz-box-sizing: content-box; box-sizing: content-box; height: 0; }
+
+/** Address styling not present in IE 8/9. */
+mark { background: #ff0; color: #000; }
+
+/** Correct font family set oddly in Safari 5 and Chrome. */
+code, kbd, pre, samp { font-family: Fira Mono, monospace, serif; font-size: 1em; }
+
+/** Improve readability of pre-formatted text in all browsers. */
+pre { white-space: pre-wrap; }
+
+/** Set consistent quote types. */
+q { quotes: "\201C" "\201D" "\2018" "\2019"; }
+
+/** Address inconsistent and variable font size in all browsers. */
+small { font-size: 80%; }
+
+/** Prevent `sub` and `sup` affecting `line-height` in all browsers. */
+sub, sup { font-size: 75%; line-height: 0; position: relative; vertical-align: baseline; }
+
+sup { top: -0.5em; }
+
+sub { bottom: -0.25em; }
+
+/* ========================================================================== Embedded content ========================================================================== */
+/** Remove border when inside `a` element in IE 8/9. */
+img { border: 0; }
+
+/** Correct overflow displayed oddly in IE 9. */
+svg:not(:root) { overflow: hidden; }
+
+/* ========================================================================== Figures ========================================================================== */
+/** Address margin not present in IE 8/9 and Safari 5. */
+figure { margin: 0; }
+
+/* ========================================================================== Forms ========================================================================== */
+/** Define consistent border, margin, and padding. */
+fieldset { border: 1px solid #c0c0c0; margin: 0 2px; padding: 0.35em 0.625em 0.75em; }
+
+/** 1. Correct `color` not being inherited in IE 8/9. 2. Remove padding so people aren't caught out if they zero out fieldsets. */
+legend { border: 0; /* 1 */ padding: 0; /* 2 */ }
+
+/** 1. Correct font family not being inherited in all browsers. 2. Correct font size not being inherited in all browsers. 3. Address margins set differently in Firefox 4+, Safari 5, and Chrome. */
+button, input, select, textarea { font-family: inherit; /* 1 */ font-size: 100%; /* 2 */ margin: 0; /* 3 */ }
+
+/**
+#tocbutton {
+	top: 0;
+	left: 13rem;
+	position:fixed;
+	z-index: 1000;
+}
+*/
+/** Address Firefox 4+ setting `line-height` on `input` using `!important` in the UA stylesheet. */
+button, input { line-height: normal; }
+
+/** Address inconsistent `text-transform` inheritance for `button` and `select`. All other form control elements do not inherit `text-transform` values. Correct `button` style inheritance in Chrome, Safari 5+, and IE 8+. Correct `select` style inheritance in Firefox 4+ and Opera. */
+button, select { text-transform: none; }
+
+/** 1. Avoid the WebKit bug in Android 4.0.* where (2) destroys native `audio` and `video` controls. 2. Correct inability to style clickable `input` types in iOS. 3. Improve usability and consistency of cursor style between image-type `input` and others. */
+button, html input[type="button"], input[type="reset"], input[type="submit"] { -webkit-appearance: button; /* 2 */ cursor: pointer; /* 3 */ }
+
+/** Re-set default cursor for disabled elements. */
+button[disabled], html input[disabled] { cursor: default; }
+
+/** 1. Address box sizing set to `content-box` in IE 8/9. 2. Remove excess padding in IE 8/9. */
+input[type="checkbox"], input[type="radio"] { box-sizing: border-box; /* 1 */ padding: 0; /* 2 */ }
+
+/** 1. Address `appearance` set to `searchfield` in Safari 5 and Chrome. 2. Address `box-sizing` set to `border-box` in Safari 5 and Chrome (include `-moz` to future-proof). */
+input[type="search"] { -webkit-appearance: textfield; /* 1 */ -moz-box-sizing: content-box; -webkit-box-sizing: content-box; /* 2 */ box-sizing: content-box; }
+
+/** Remove inner padding and search cancel button in Safari 5 and Chrome on OS X. */
+input[type="search"]::-webkit-search-cancel-button, input[type="search"]::-webkit-search-decoration { -webkit-appearance: none; }
+
+/** Remove inner padding and border in Firefox 4+. */
+button::-moz-focus-inner, input::-moz-focus-inner { border: 0; padding: 0; }
+
+/** 1. Remove default vertical scrollbar in IE 8/9. 2. Improve readability and alignment in all browsers. */
+textarea { overflow: auto; /* 1 */ vertical-align: top; /* 2 */ }
+
+/* ========================================================================== Tables ========================================================================== */
+/** Remove most spacing between table cells. */
+table { border-collapse: collapse; border-spacing: 0; }
+
+meta.foundation-mq-small { font-family: "only screen and (min-width: 768px)"; width: 768px; }
+
+meta.foundation-mq-medium { font-family: "only screen and (min-width:1280px)"; width: 1280px; }
+
+meta.foundation-mq-large { font-family: "only screen and (min-width:1440px)"; width: 1440px; }
+
+*, *:before, *:after { -moz-box-sizing: border-box; -webkit-box-sizing: border-box; box-sizing: border-box; }
+
+html, body {  background-color:#527AA3; }
+
+body {  background: white; color: #222222;   padding: ; margin: 0; font-family:sans-serif, Helvetica, Arial, sans-serif; font-weight: 400; font-style: normal; position: relative; cursor: auto; padding-left: 2rem; padding-right: 2rem;}
+
+
+a:hover { cursor: pointer; }
+
+img, object, embed {  height: auto; max-width: 90%; }
+
+
+object, embed { height: 100%; }
+
+img { -ms-interpolation-mode: bicubic; }
+
+#map_canvas img, #map_canvas embed, #map_canvas object, .map_canvas img, .map_canvas embed, .map_canvas object { max-width: none !important; }
+
+.left { float: left !important; }
+
+.right { float: right !important; }	
+
+.text-left { text-align: left !important; }
+
+.text-right { text-align: right !important; }
+
+.text-center { text-align: center !important; }
+
+.text-justify { text-align: justify !important; }
+
+.hide { display: none; }
+
+.antialiased, body { -webkit-font-smoothing: antialiased; }
+
+img { display: inline-block; vertical-align: baseline; }
+
+textarea { height: auto; min-height: 50px; }
+
+select { width: 100%; }
+
+object, svg { display: inline-block; vertical-align: middle; }
+
+.center { margin-left: auto; margin-right: auto; }
+
+.spread { width: 100%; margin-right: 2rem; }
+
+p.lead, .paragraph.lead > p, #preamble > .sectionbody > .paragraph:first-of-type p { font-size: 1em; line-height: 1.6;  }
+
+
+/* Typography padding etc */
+.subheader, .admonitionblock td.content > .title, .audioblock > .title, .exampleblock > .title, .imageblock > .title, .listingblock > .title, .literalblock > .title, .stemblock > .title, .openblock > .title, .paragraph > .title, .quoteblock > .title, table.tableblock > .title, .verseblock > .title, .videoblock > .title, .dlist > .title, .olist > .title, .ulist > .title, .qlist > .title, .hdlist > .title { line-height: 2.4; color: #132445; font-weight: 400; margin-top: 0em; margin-bottom: 0.5em;  }
+
+
+/* Typography resets */
+div, dl, dt, dd, ul, ol, li, h1, h2, h3, #toctitle, .sidebarblock > .content > .title, h4, h5, h6, pre, form, p, blockquote, th, td { margin: 0; padding: 0; direction: ltr; }
+div.openblock.partintro, div.sectionbody.paragraph {font-weight: 500;  line-height: 1.4; margin-bottom: 1em; }
+div.sect1 {padding-top: 1rem;}
+
+div.paragraph.faq-intro {max-width: 66%;}
+
+
+/* Default Link Styles */
+a { color: #6999d6; text-decoration: none; line-height: inherit;  }
+a:hover, a:focus { color: #132445; }
+a img { border: none; }
+
+
+/* Grey links with black transition 
+
+a { color: #2ba6cb; text-decoration: none; line-height: inherit; color: rgba(0,0,0,.3); transition: .2s; }
+a:active, a:hover, a:focus { color: #212121; }
+a img { border: none; }
+
+*/
+
+
+
+/* Default paragraph styles */
+p { font-family:sans-serif; font-weight: 400; font-size: 1.2rem; line-height: 1.4; padding-bottom: 0.5em;    }
+p aside { font-size: 0.575em; line-height: 1.35; font-style: italic; }
+div.p, { width: 100% }
+
+
+/* Default header styles */
+h1, h2, h3, #toctitle, .sidebarblock > .content > .title, h4, h5, h6 { font-family: sans-serif; font-weight: 600; font-style: normal; color: #244d82; text-rendering: optimizeLegibility; margin-bottom: 0em; line-height: 1.2125em; margin-top:; 2rem;  }
+h1 small, h2 small, h3 small, #toctitle small, .sidebarblock > .content > .title small, h4 small, h5 small, h6 small { font-size: 60%; color: #6999d6; line-height: 0; }
+
+h1 { font-size: 2.125em; max-width:66.66%;}
+
+h2 { font-size: 1.6875em; }
+
+h3, #toctitle, .sidebarblock > .content > .title { font-size: 1.375em; }
+
+h4 { font-size: 1.125em; }
+
+h5 { font-size: 1.125em; }
+
+h6 { font-size: 1em; }
+
+hr { border: solid #dddddd; border-width: 1px 0 0; clear: both; margin: 1.25em 0 1.1875em; height: 0; }
+
+/* Helpful Typography Defaults */
+em, i { font-style: italic; line-height: inherit; }
+
+strong, b { font-weight: 600; line-height: inherit; }
+
+small { font-size: 60%; line-height: inherit; }
+
+code { font-family: Fira Mono, Consolas, "Liberation Mono", Courier, monospace;  }
+
+/* Lists */
+ul, ol, dl {  list-style-position: outside; font-family:sans-serif; padding-left: 0rem; list-style-type: none}
+
+ul, ol { margin-left: 0em;  }
+ul.no-bullet, ol.no-bullet { margin-left: 1.5em;  margin-bottom: 0;}
+
+/* Unordered Lists */
+ul li ul, ul li ol { margin-left: 1.25em; margin-bottom: 0; font-size: 1em; /* Override nested font-size change */  }
+ul.square li ul, ul.circle li ul, ul.disc li ul { list-style: inherit; }
+ul.square { list-style-type: square; }
+ul.circle { list-style-type: circle; }
+ul.disc { list-style-type: none; }
+ul.no-bullet { list-style: none; }
+
+/* Ordered Lists */
+ol li ul, ol li ol { margin-left: 1.25em; margin-bottom: 0;   }
+
+/* Definition Lists */
+dl dt { margin-bottom: 0.3125em; font-weight: bold; font-size: 1.2em; font-style: italic}
+dl dd { margin-bottom: 1.25em; }
+
+/* Abbreviations */
+abbr, acronym { text-transform: uppercase; font-size: 90%; color: #222222; border-bottom: 1px dotted #dddddd; cursor: help; }
+
+abbr { text-transform: none; }
+
+/* Blockquotes */
+blockquote { margin: 0 0 1.25em; padding: 0.5625em 1.25em 0 1.1875em; border-left: 1px solid #dddddd; }
+blockquote cite { display: block; font-size: inherit; color: color: #132445; }
+blockquote cite:before { content: "\2014 \0020"; }
+blockquote cite a, blockquote cite a:visited { color: #417dcb; }
+
+blockquote, blockquote p { line-height: 1.6; color: #132445; }
+
+/* Microformats */
+.vcard { display: inline-block; margin: 0 0 1.25em 0; border: 1px solid #dddddd; padding: 0.625em 0.75em; }
+.vcard li { margin: 0; display: block; }
+.vcard .fn { font-weight: bold; font-size: 0.9375em; }
+
+.vevent .summary { font-weight: bold; }
+.vevent abbr { cursor: auto; text-decoration: none; font-weight: bold; border: none; padding: 0 0.0625em; }
+
+@media only screen and (min-width: 768px) { h1, h2, h3, #toctitle, .sidebarblock > .content > .title, h4, h5, h6 { line-height: 1.4;  margin-top: 1rem; margin-bottom: 0.2rem;}
+  h1 { font-size: 2.75em; }
+  h2 { font-size: 2.3125em; }
+  h3, #toctitle, .sidebarblock > .content > .title { font-size: 1.6875em; }
+  h4 { font-size: 1.4375em; } }
+
+/* Tables */
+table { background: white; margin-bottom: 1.25em; border: solid 1px #dddddd; }
+table thead, table tfoot { background: whitesmoke; font-weight: 600; }
+table thead tr th, table thead tr td, table tfoot tr th, table tfoot tr td { padding: 0.5em 0.625em 0.625em; font-size: inherit; color: #222222; text-align: left; }
+table tr th, table tr td { padding: 0.5625em 0.625em; font-size: inherit; color: #222222; }
+table tr.even, table tr.alt, table tr:nth-of-type(even) { background: #f9f9f9; }
+table thead tr th, table tfoot tr th, table tbody tr td, table tr td, table tfoot tr td { display: table-cell; line-height: 1.4; }
+
+/* FEATURE TABLE */
+
+table.done, tr.done.alt, table.done tr:nth-of-type(even) {
+	background: #efe;
+	padding-top: 0;
+	padding-bottom: 0;
+	border: none;
+	margin-bottom: -1px;
+}
+
+table.most, tr.most.alt, table.most tr:nth-of-type(even) {
+	background: #ffd;
+	padding-top: 0;
+	padding-bottom: 0;
+	border: none;
+	margin-bottom: -1px;
+}
+
+table.tbc, tr.tbc.alt, table.tbc tr:nth-of-type(even) {
+	background: #fff6de;
+	padding-top: 0;
+	padding-bottom: 0;
+	border: none;
+	margin-bottom: -1px;
+}
+
+table.tbd, tr.tbd.alt, table.tbd tr:nth-of-type(even) {
+	background: #fee;
+	padding-top: 0;
+	padding-bottom: 0;
+	border: none;
+	margin-bottom: -1px;
+}
+
+table.done thead tr th, table.done tfoot tr th, table.done tfoot tr td, table.done.sect2, table.most thead tr th, table.most tfoot tr th, table.most tfoot tr td, table.most.sect2, table.tbc thead tr th, table.tbc tfoot tr th, table.tbc tfoot tr td, table.tbc.sect2, table.tbd thead tr th, table.tbd tfoot tr th, table.tbd tfoot tr td, table.tbd.sect2 {background: white; font-size: 1.9rem; color: #417dcb; }
+
+
+
+/* 
+green "done" = #efe
+yellow "most" = #ffd
+orange "tbc" = #fff6de
+red "tbd" = #fee
+ */
+
+
+
+body { tab-size: 4; max-width: 1050px; margin-right: auto; margin-left: auto; position: relative; margin-top: 0rem; margin-bottom: 0rem; padding-top: 0rem; /*  Fixes tables, breaks headers */}
+
+h1, h2, h3, #toctitle, .sidebarblock > .content > .title, h4, h5, h6 { line-height: 1.4;  margin-top: 0rem;}
+
+.clearfix:before, .clearfix:after, .float-group:before, .float-group:after { content: " "; display: table; }
+.clearfix:after, .float-group:after { clear: both; }
+
+*:not(pre) > code { font-size: inherit; font-style: normal !important; letter-spacing: 0; padding: 0; line-height: inherit; }
+
+pre, pre > code { line-height: 1.4; color: black; font-family: monospace, serif; font-weight: normal; }
+
+.keyseq { color: #555555; }
+
+kbd { font-family: Consolas, "Liberation Mono", Courier, monospace; display: inline-block; color: #222222; font-size: 0.65em; line-height: 1.45; background-color: #f7f7f7; border: 1px solid #ccc; -webkit-border-radius: 3px; border-radius: 3px; -webkit-box-shadow: 0 1px 0 rgba(0, 0, 0, 0.2), 0 0 0 0.1em white inset; box-shadow: 0 1px 0 rgba(0, 0, 0, 0.2), 0 0 0 0.1em white inset; margin: 0 0.15em; padding: 0.2em 0.5em; vertical-align: middle; position: relative; top: -0.1em; white-space: nowrap; }
+
+.keyseq kbd:first-child { margin-left: 0; }
+
+.keyseq kbd:last-child { margin-right: 0; }
+
+.menuseq, .menu { color: #090909; }
+
+b.button:before, b.button:after { position: relative; top: -1px; font-weight: normal; }
+
+b.button:before { content: "["; padding: 0 3px 0 2px; }
+
+b.button:after { content: "]"; padding: 0 2px 0 3px; }
+
+#header, #content, #footnotes, #footer {  max-width: 1050px; margin-right: auto; margin-left: auto; position: relative; margin-top: 0rem; margin-bottom: 0rem; padding-top: 0rem;  padding-right: 0rem;}
+#header:before, #header:after, #content:before, #content:after, #footnotes:before, #footnotes:after, #footer:before, #footer:after { content: " "; display: table; }
+#header:after, #content:after, #footnotes:after, #footer:after { clear: both; }
+
+
+#content:before { content: none; }
+#content {padding-left: 0.5rem;}
+
+#header > h1:first-child { color: black; font-weight: bold; margin-top: 2.25rem; margin-bottom: 0; }
+#header > h1:first-child + #toc { margin-top: 8px; border-top: 1px solid #dddddd; }
+#header > h1:only-child, body.toc2 #header > h1:nth-last-child(2) { border-bottom: 1px solid #dddddd; padding-bottom: 8px; }
+#header .details { border-bottom: 1px solid #dddddd; line-height: 1.45; padding-top: 0.25em; padding-bottom: 0.25em; padding-left: 0.25em; color: #417dcb; display: -ms-flexbox; display: -webkit-flex; display: flex; -ms-flex-flow: row wrap; -webkit-flex-flow: row wrap; flex-flow: row wrap; }
+#header .details span:first-child { margin-left: -0.125em; }
+#header .details span.email a { color: #6999d6; }
+#header .details br { display: none; }
+#header .details br + span:before { content: "\00a0\2013\00a0"; }
+#header .details br + span.author:before { content: "\00a0\22c5\00a0"; color: #6999d6; }
+#header .details br + span#revremark:before { content: "\00a0|\00a0"; }
+#header #revnumber { text-transform: capitalize; }
+#header #revnumber:after { content: "\00a0"; }
+
+#content > h1:first-child:not([class]) { color: black; font-weight: bold; border-bottom: 1px solid #dddddd; max-width: 1050px; margin-right: auto; margin-left: auto; position: relative; margin-top: 4rem; margin-bottom: 4rem; padding-top: 0rem;   }
+
+/* ========================================================================== Table of Contents ======================================================================= */
+
+
+
+#toc { border-bottom: 1px solid #dddddd; padding-bottom: 0.5em; position: relative; left: 0;}
+#toc > ul { margin-left: 0.125em; padding-left: 1em; }
+#toc ul.sectlevel0 > li > a { font-style: italic; }
+#toc ul.sectlevel0 ul.sectlevel1 { margin: 0.5em 0; }
+#toc ul { font-family: "Helvetica Neue", "Helvetica", Helvetica, Arial, sans-serif; list-style-type: none; }
+#toc li { line-height: 1.3334; margin-top: 0.3334em; }
+#toc a { text-decoration: none; }
+#toc a:active { text-decoration: underline; }
+
+#toc ul li:before {
+    content: "›";
+    margin-left: -.75em;
+    margin-right: .4em;
+    color: #244d82
+}
+
+
+
+div.ulist li:before {
+    content: "›";
+    position: absolute;
+    margin-top: .2rem;
+    font-size: x-large;
+    margin-left: -.75em;
+    margin-bottom: -.75em;
+    margin-right: 0;
+    line-height: 1rem;
+    color: #244d82
+
+}
+
+
+#toctitle { color: #244d82; font-size: 1.2em; padding-left: 1em; }
+
+#faq {
+	position: relative;
+	right: 9.3rem;
+    top: 9rem;
+	margin-bottom: 20px;
+	left: 45rem;
+	z-index:1;padding-left:2rem;border-left:1px solid #d3d3d3
+
+}
+@media only screen and (max-width: 945px) {
+	div#faq { display: none; }
+}
+
+#faq h2 {
+	font-size: 25px;
+	font-weight: 600;
+	margin-top: -8rem;
+}
+
+div#faq li:before {
+    content: "›";
+    position: absolute;
+    font-size: x-large;
+    margin-left: -.75em;
+    margin-bottom: -.75em;
+    margin-right: 0;
+    line-height: 1rem;
+    color: #244d82
+}
+
+#features-nav {
+	position: absolute;
+	right: 1rem;
+	top: 2rem;
+	margin-bottom: 20px;
+	position:absolute;z-index:1;padding-left:2rem;border-left:1px solid #d3d3d3
+}
+
+@media only screen and (max-width: 993px) {
+	#features-nav { display: none; }
+}
+
+#features-nav h2 {
+	font-size: 25px;
+	font-weight: 600;
+	margin-top: -1rem;
+}
+#features-nav li {
+	margin-top: .3rem;
+}
+
+div#features-nav li:before {
+    content: "›";
+    position: absolute;
+    font-size: x-large;
+    margin-left: -.75em;
+    margin-bottom: -.75em;
+    margin-right: 0;
+    line-height: 1rem;
+    color: #244d82
+}
+
+
+@media only screen and (min-width: 1434px) { body.toc2.toc-right #toc.toc2 { border-right-width: 0; border: none; left: 0px; } }
+
+@media only screen and (min-width: 1434px) { #toctitle { padding-top: 1.5rem; font-size: 1.375em; }
+  body.toc2 { padding-left: 2em; padding-right: 1em; }
+  #toc.toc2 { margin-top: 0 !important; background-color: #f2f2f2; position: fixed; width: 12em; left: 0; top: 0; border-right: 1px solid #dddddd; border-top-width: 0 !important; border-bottom-width: 0 !important; z-index: 1000; padding: 1.25em 0.25em 0em 0.25em; height: 100%; overflow: auto; }
+  #toc.toc2 #toctitle { margin-top: 0; margin-bottom: 0.8rem; font-size: 1.2em; padding-left: 1em;}
+  #toc.toc2 > ul { font-size: 0.9em; margin-bottom: 0; }
+  #toc.toc2 ul ul { margin-left: 1em; padding-left: .3em; }
+  #toc.toc2 ul.sectlevel0 ul.sectlevel1 { padding-left: 0; margin-top: 0.5em; margin-bottom: 0.5em; }
+  body.toc2.toc-right { padding-left: 2em; padding-right: 2em; }
+  body.toc2.toc-right #toc.toc2 { border-right-width: 0; border-left: 1px solid #dddddd; left: auto; right: -13rem; } }
+@media only screen and (min-width: 1535px) { 
+  body.toc2 { padding-left: 2em; padding-right: 2em; }
+  #toctitle { padding-top: 0rem; font-size: 1.375em; }
+  #toc.toc2 { width: 13em; }
+  #toc.toc2 #toctitle { font-size: 1.375em; }
+  #toc.toc2 > ul { font-size: 0.95em; }
+  #toc.toc2 ul ul { padding-left: 0; }
+  body.toc2.toc-right { padding-left: 2em; padding-right: 2em; } }
+#content #toc { border-style: solid; border-width: 1px; border-color: #d9d9d9; margin-bottom: 1.25em; padding: 1.25em; background: #f2f2f2; -webkit-border-radius: 0; border-radius: 0; }
+#content #toc > :first-child { margin-top: 0; }
+#content #toc > :last-child { margin-bottom: 0; }
+
+
+
+#footer {  width: 1050px;background-color: #132445; padding: 1.25em; padding-bottom: 0rem; margin-right: -2rem; margin-left: -2rem; margin-top: 2rem; color: white}
+div.social  { line-height: 1.4; color: #FFFFFF;font-size:  1.2rem; font-weight: 400; font-style: bold; background-color: #132445; margin-right: -2rem; margin-left: -2rem; text-align: left; padding-bottom: 4px; padding-left: 25px; }
+div.social li a {  margin-bottom: 2em;  color: #d5dfea;font-size:  1.2rem; font-weight: 800; font-style: bold; list-style: none; list-style-type: none; text-decoration-color: rgb(213, 223, 234); }
+/* div.social a:visited { color: #244D82; }*/
+div.social a:hover { color: #F7D425; }
+div.social :first-child { margin-top: 0; }
+div.social h2 {        margin-bottom: 20px;font-weight: 600;font-size: 1.3em;margin-top: 4rem;color: #244d82;font-family: sans-serif;}
+div.social li:before {content: "› "; color: #244d82;font-size: large;font-weight: 800;}
+div.social ul {margin-top: -10px;line-height: 30px;}
+div.social li {/* nothing */}
+
+#bottomright {float: right;}
+
+
+@media only screen and (max-width: 1050px) {
+	body {width: 100%;}
+}
+
+
+
+#footer-text { color: #dddddd; line-height: 1.44; }
+
+
+.sect1 { padding-bottom: 0.625em; }
+.sectionbody.paragraph {max-width: 66.666%}
+.sectionbody ul {padding-left: 1rem;}
+
+@media only screen and (min-width: 768px) { .sect1 { padding-bottom: 0em; } }
+.sect1 + .sect1 { border-top: 0px solid #dddddd; }
+
+#content h1 > a.anchor, h2 > a.anchor, h3 > a.anchor, #toctitle > a.anchor, .sidebarblock > .content > .title > a.anchor, h4 > a.anchor, h5 > a.anchor, h6 > a.anchor { position: absolute; z-index: 1001; width: 1.5ex; margin-left: -1.5ex; display: block; text-decoration: none !important; visibility: hidden; text-align: center; font-weight: 400; max-width: 1050px; }
+#content h1 > a.anchor:before, h2 > a.anchor:before, h3 > a.anchor:before, #toctitle > a.anchor:before, .sidebarblock > .content > .title > a.anchor:before, h4 > a.anchor:before, h5 > a.anchor:before, h6 > a.anchor:before { content: "\2771"; font-size: 0.85em; display: block; padding-top: 0.1em; vertical-align: bas }
+#content h1:hover > a.anchor, #content h1 > a.anchor:hover, h2:hover > a.anchor, h2 > a.anchor:hover, h3:hover > a.anchor, #toctitle:hover > a.anchor, .sidebarblock > .content > .title:hover > a.anchor, h3 > a.anchor:hover, #toctitle > a.anchor:hover, .sidebarblock > .content > .title > a.anchor:hover, h4:hover > a.anchor, h4 > a.anchor:hover, h5:hover > a.anchor, h5 > a.anchor:hover, h6:hover > a.anchor, h6 > a.anchor:hover { visibility: visible; }
+#content h1 > a.link, h2 > a.link, h3 > a.link, #toctitle > a.link, .sidebarblock > .content > .title > a.link, h4 > a.link, h5 > a.link, h6 > a.link { color: #244d82; text-decoration: none; font-family:  sans-serif}
+#content h1 > a.link:hover, h2 > a.link:hover, h3 > a.link:hover, #toctitle > a.link:hover, .sidebarblock > .content > .title > a.link:hover, h4 > a.link:hover, h5 > a.link:hover, h6 > a.link:hover { color: #1e416e; }
+
+.audioblock, .imageblock, .literalblock, .listingblock, .stemblock, .videoblock { margin-bottom: 1.25em; }
+
+.admonitionblock td.content > .title, .audioblock > .title, .exampleblock > .title, .imageblock > .title, .listingblock > .title, .literalblock > .title, .stemblock > .title, .openblock > .title, .paragraph > .title, .quoteblock > .title, table.tableblock > .title, .verseblock > .title, .videoblock > .title, .dlist > .title, .olist > .title, .ulist > .title, .qlist > .title, .hdlist > .title { text-rendering: optimizeLegibility; text-align: left;   }
+
+table.tableblock > caption.title { white-space: nowrap; overflow: visible; max-width: 0;  }
+
+.paragraph.lead > p, #preamble > .sectionbody > .paragraph:first-of-type p { color: black; max-width: 66%}
+
+table.tableblock #preamble > .sectionbody > .paragraph:first-of-type p { font-size: inherit; }
+
+.admonitionblock > table { border-collapse: separate; border: 0; background: none; max-width: 80%;}
+.admonitionblock > table td.icon { text-align: center; width: 80px; }
+.admonitionblock > table td.icon img { max-width: none; }
+.admonitionblock > table td.icon .title { font-weight: bold; font-family:  sans-serif, Georgia, Verdana, "Helvetica", Helvetica, Arial, sans-serif; text-transform: uppercase; }
+.admonitionblock > table td.content { padding-left: 1.125em; padding-right: 1.25em; border-left: 1px solid #dddddd; color: #417dcb; }
+.admonitionblock > table td.content > :last-child > :last-child { margin-bottom: 0; }
+
+.exampleblock > .content { border-style: solid; border-width: 1px; border-color: #e6e6e6; margin-bottom: 1.25em; padding: 1.25em; background-color: #fffef7; -webkit-border-radius: 0; border-radius: 0; }
+.exampleblock > .content > :first-child { margin-top: 0; }
+.exampleblock > .content > :last-child { margin-bottom: 0; }
+
+.sidebarblock { position: absolute; border-style: solid; border-width: 1px; border-color: #d9d9d9; margin: -2rem -7.5rem 0rem 63.65rem; padding: .2rem; background: #f2f2f2; -webkit-border-radius: 0; border-radius: 0; text-align: left; width: 5.5rem;}
+.sidebarblock > :first-child { margin-top: 0; }
+.sidebarblock > :last-child { margin-bottom: 0; }
+.sidebarblock > .content > .title { color: #6999d6; margin-top: 0; }
+
+@media only screen and (max-width: 1203px) { 
+.sidebarblock { position: absolute; right: 12%; }
+}
+@media only screen and (max-width: 817px) { 
+.sidebarblock { position: absolute; right: 18%; }
+}
+
+@media only screen and (max-width: 562px) { 
+.sidebarblock { position: absolute; right: 25%; }
+}
+
+.exampleblock > .content > :last-child > :last-child, .exampleblock > .content .olist > ol > li:last-child > :last-child, .exampleblock > .content .ulist > ul > li:last-child > :last-child, .exampleblock > .content .qlist > ol > li:last-child > :last-child, .sidebarblock > .content > :last-child > :last-child, .sidebarblock > .content .olist > ol > li:last-child > :last-child, .sidebarblock > .content .ulist > ul > li:last-child > :last-child, .sidebarblock > .content .qlist > ol > li:last-child > :last-child { margin-bottom: 0; }
+
+.literalblock pre, .listingblock pre:not(.highlight), .listingblock pre[class="highlight"], .listingblock pre[class^="highlight "], .listingblock pre.CodeRay, .listingblock pre.prettyprint { background: #eeeeee; }
+.sidebarblock .literalblock pre, .sidebarblock .listingblock pre:not(.highlight), .sidebarblock .listingblock pre[class="highlight"], .sidebarblock .listingblock pre[class^="highlight "], .sidebarblock .listingblock pre.CodeRay, .sidebarblock .listingblock pre.prettyprint { background: #f2f1f1; }
+
+.literalblock pre, .literalblock pre[class], .listingblock pre, .listingblock pre[class] { border: 1px solid #cccccc; -webkit-border-radius: 0; border-radius: 0; word-wrap: break-word; padding: 0.8em 0.8em 0.65em 0.8em; font-size: 0.8125em; }
+.literalblock pre.nowrap, .literalblock pre[class].nowrap, .listingblock pre.nowrap, .listingblock pre[class].nowrap { overflow-x: auto; white-space: pre; word-wrap: normal; }
+@media only screen and (min-width: 768px) { .literalblock pre, .literalblock pre[class], .listingblock pre, .listingblock pre[class] { font-size: 0.90625em; } }
+@media only screen and (min-width: 1280px) { .literalblock pre, .literalblock pre[class], .listingblock pre, .listingblock pre[class] { font-size: 1em; } }
+
+.literalblock.output pre { color: #eeeeee; background-color: black; }
+
+.listingblock pre.highlightjs { padding: 0;  margin-right: 0em; }
+.listingblock pre.highlightjs > code { padding: 0.8em 2rem 0.65em 0.8em; -webkit-border-radius: 0; border-radius: 0; padding-right: 2rem;}
+
+.listingblock > .content { position: relative; }
+
+.listingblock code[data-lang]:before { display: none; content: attr(data-lang); position: absolute; font-size: 0.75em; top: 0.425rem; right: 0.5rem; line-height: 1; text-transform: uppercase; color: #999; padding-right: 2rem; }
+
+.listingblock:hover code[data-lang]:before { display: none; }
+
+.listingblock.terminal pre .command:before { content: attr(data-prompt); padding-right: 0.5em; color: #999; }
+
+.listingblock.terminal pre .command:not([data-prompt]):before { content: "$"; }
+
+table.pyhltable { border-collapse: separate; border: 0; margin-bottom: 0; background: none; }
+
+table.pyhltable td { vertical-align: top; padding-top: 0; padding-bottom: 0; line-height: 1.4; }
+
+table.pyhltable td.code { padding-left: .75em; padding-right: 0; }
+
+pre.pygments .lineno, table.pyhltable td:not(.code) { color: #999; padding-left: 0; padding-right: .5em; border-right: 1px solid #dddddd; }
+
+pre.pygments .lineno { display: inline-block; margin-right: .25em; }
+
+table.pyhltable .linenodiv { background: none !important; padding-right: 0 !important; }
+
+.quoteblock { margin: 0 1em 1.25em 1.5em; display: table; }
+.quoteblock > .title { margin-left: -1.5em; margin-bottom: 0.75em; }
+.quoteblock blockquote, .quoteblock blockquote p { color: #132445; font-size: 1.15rem; line-height: 1.75; word-spacing: 0.1em; letter-spacing: 0; font-style: italic; text-align: justify; }
+.quoteblock blockquote { margin: 0; padding: 1rem; border: 0; }
+.quoteblock blockquote:before { content: "\201c"; float: left; font-size: 2.75em; font-weight: bold; line-height: 0.6em; margin-left: -0.6em; color: #6999d6; text-shadow: 0 1px 2px rgba(0, 0, 0, 0.1); }
+.quoteblock blockquote > .paragraph:last-child p { margin-bottom: 0; }
+.quoteblock .attribution { margin-top: 1em; margin-right: 0.5ex; text-align: right; }
+.quoteblock .quoteblock { margin-left: 0; margin-right: 0; padding: 0.5em 0; border-left: 3px solid #417dcb; }
+.quoteblock .quoteblock blockquote { padding: 0 0 0 0.75em; }
+.quoteblock .quoteblock blockquote:before { display: none; }
+
+.verseblock { margin: 0 1em 1.25em 1em; }
+.verseblock pre { font-family:  sans-serif, "Open Sans", "DejaVu Sans", sans; font-size: 1.15rem; color: #6999d6; font-weight: 300; text-rendering: optimizeLegibility; }
+.verseblock pre strong { font-weight: 400; }
+.verseblock .attribution { margin-top: 1.25rem; margin-left: 0.5ex; text-align: right;}
+
+.quoteblock .attribution, .verseblock .attribution { font-size: inherit; line-height: 1.45; font-style: italic; }
+.quoteblock .attribution br, .verseblock .attribution br { display: none; }
+.quoteblock .attribution cite, .verseblock .attribution cite { display: block; letter-spacing: -0.025em; color: #417dcb; }
+
+.quoteblock.abstract { margin: 0 0 1.25em 0; display: block; }
+.quoteblock.abstract blockquote, .quoteblock.abstract blockquote p { text-align: left; word-spacing: 0; }
+.quoteblock.abstract blockquote:before, .quoteblock.abstract blockquote p:first-of-type:before { display: none; }
+
+table.tableblock { max-width: 100%; border-collapse: separate;  }
+table.tableblock td > .paragraph:last-child p > p:last-child, table.tableblock th > p:last-child, table.tableblock td > p:last-child { margin-bottom: 0; }
+
+table.tableblock, th.tableblock, td.tableblock { border: 0 solid #dddddd; margin-right: 2rem;}
+
+table.grid-all th.tableblock, table.grid-all td.tableblock { border-width: 0 1px 1px 0; padding: 0.5rem;}
+
+table.grid-all tfoot > tr > th.tableblock, table.grid-all tfoot > tr > td.tableblock { border-width: 1px 1px 0 0; }
+
+table.grid-cols th.tableblock, table.grid-cols td.tableblock { border-width: 0 1px 0 0; }
+
+table.grid-all * > tr > .tableblock:last-child, table.grid-cols * > tr > .tableblock:last-child { border-right-width: 0; }
+
+table.grid-rows th.tableblock, table.grid-rows td.tableblock { border-width: 0 0 1px 0; }
+
+table.grid-all tbody > tr:last-child > th.tableblock, table.grid-all tbody > tr:last-child > td.tableblock, table.grid-all thead:last-child > tr > th.tableblock, table.grid-rows tbody > tr:last-child > th.tableblock, table.grid-rows tbody > tr:last-child > td.tableblock, table.grid-rows thead:last-child > tr > th.tableblock { border-bottom-width: 0;}
+
+table.grid-rows tfoot > tr > th.tableblock, table.grid-rows tfoot > tr > td.tableblock { border-width: 1px 0 0 0; }
+
+table.frame-all { border-width: 1px; }
+
+table.frame-sides { border-width: 0 1px; }
+
+table.frame-topbot { border-width: 1px 0; }
+
+th.halign-left, td.halign-left { text-align: left; }
+
+th.halign-right, td.halign-right { text-align: right; }
+
+th.halign-center, td.halign-center { text-align: center; }
+
+th.valign-top, td.valign-top { vertical-align: top; }
+
+th.valign-bottom, td.valign-bottom { vertical-align: bottom; }
+
+th.valign-middle, td.valign-middle { vertical-align: middle; }
+
+table thead th, table tfoot th { font-weight: 600; }
+
+tbody tr th { display: table-cell; line-height: 1.4; background: whitesmoke; }
+
+tbody tr th, tbody tr th p, tfoot tr th, tfoot tr th p { color: #222222; font-weight: 600; }
+
+p.tableblock > code:only-child { background: none; padding: 0; max-width: 100%}
+
+p.tableblock { font-size: 1em; max-width: 100% }
+
+td > div.verse { white-space: pre; }
+
+ol { margin-left: 1.75em; }
+
+ul li ol { margin-left: 1.5em; }
+
+
+dl dd { margin-left: 1.125em; }
+
+dl dd:last-child, dl dd:last-child > :last-child { margin-bottom: 0; }
+
+ol > li p, ul > li p, ul dd, ol dd, .olist .olist, .ulist .ulist, .ulist .olist, .olist .ulist { margin-bottom: -0.2em; }
+
+ul.unstyled, ol.unnumbered, ul.checklist, ul.none { list-style-type: none; }
+
+ul.unstyled, ol.unnumbered, ul.checklist { margin-left: 0.625em; }
+
+ul.checklist li > p:first-child > .fa-square-o:first-child, ul.checklist li > p:first-child > .fa-check-square-o:first-child { width: 1em; font-size: 0.85em; }
+
+ul.checklist li > p:first-child > input[type="checkbox"]:first-child { width: 1em; position: relative; top: 1px; }
+
+ul.inline { margin: 0 auto 0.625em auto; margin-left: -1.375em; margin-right: 0; padding: 0; list-style: none; overflow: hidden; }
+ul.inline > li { list-style: none; float: left; margin-left: 1.375em; display: block; }
+ul.inline > li > * { display: block; }
+
+.unstyled dl dt { font-weight: normal; font-style: normal; }
+
+ol.arabic { list-style-type: decimal; }
+
+ol.decimal { list-style-type: decimal-leading-zero; }
+
+ol.loweralpha { list-style-type: lower-alpha; }
+
+ol.upperalpha { list-style-type: upper-alpha; }
+
+ol.lowerroman { list-style-type: lower-roman; }
+
+ol.upperroman { list-style-type: upper-roman; }
+
+ol.lowergreek { list-style-type: lower-greek; }
+
+.hdlist > table, .colist > table { border: 0; background: none; }
+.hdlist > table > tbody > tr, .colist > table > tbody > tr { background: none; }
+
+td.hdlist1, td.hdlist2 { vertical-align: baseline; padding: 0 0.625em; }
+
+td.hdlist1 { font-weight: bold; padding-bottom: 1.25em; }
+
+.literalblock + .colist, .listingblock + .colist { margin-top: -0.5em;  }
+
+.colist > table tr > td:first-of-type { padding: 0 0.75em; line-height: 1; }
+.colist > table tr > td:last-of-type { padding: 0.25em 0; }
+
+.thumb, .th { line-height: 0; display: inline-block; border: solid 4px white; -webkit-box-shadow: 0 0 0 1px #dddddd; box-shadow: 0 0 0 1px #dddddd; }
+
+.imageblock.left, .imageblock[style*="float: left"] { margin: 0.25em 0.625em 1.25em 0;   }
+.imageblock.right, .imageblock[style*="float: right"] { margin: 0.25em 0 1.25em 0.625em;  }
+.imageblock > .title { margin-bottom: 0; }
+.imageblock.thumb, .imageblock.th { border-width: 6px; }
+.imageblock.thumb > .title, .imageblock.th > .title { padding: 0 0.125em; }
+
+.image.left, .image.right { margin-top: 0.25em; margin-bottom: 0.25em; display: inline-block; line-height: 0; }
+.image.left { margin-right: 0.625em; }
+.image.right { margin-left: 0.625em; }
+
+a.image { text-decoration: none; display: inline-block; }
+a.image object { pointer-events: none; }
+
+sup.footnote, sup.footnoteref { font-size: 0.875em; position: static; vertical-align: super; }
+sup.footnote a, sup.footnoteref a { text-decoration: none; }
+sup.footnote a:active, sup.footnoteref a:active { text-decoration: underline; }
+
+#footnotes { padding-top: 0.75em; padding-bottom: 0.75em; margin-bottom: 0.625em; }
+#footnotes hr { width: 20%; min-width: 6.25em; margin: -0.25em 0 0.75em 0; border-width: 1px 0 0 0; }
+#footnotes .footnote { padding: 0 0.375em 0 0.225em; line-height: 1.3334; font-size: 0.875em; margin-left: 1.2em; text-indent: -1.05em; margin-bottom: 0.2em; }
+#footnotes .footnote a:first-of-type { font-weight: bold; text-decoration: none; }
+#footnotes .footnote:last-of-type { margin-bottom: 0; }
+#content #footnotes { margin-top: -0.625em; margin-bottom: 0; padding: 0.75em 0; }
+
+.gist .file-data > table { border: 0; background: #fff; width: 100%; margin-bottom: 0; }
+.gist .file-data > table td.line-data { width: 99%; }
+
+div.github-block { text-align: right; margin-right: -1rem; }
+div.gist {padding-right: 2rem;}
+
+div.unbreakable { page-break-inside: avoid; }
+
+.big { font-size: larger; }
+
+.small { font-size: smaller; }
+
+.underline { text-decoration: underline; }
+
+.overline { text-decoration: overline; }
+
+.line-through { text-decoration: line-through; }
+
+.aqua { color: #00bfbf; }
+
+.aqua-background { background-color: #00fafa; }
+
+.black { color: black; }
+
+.black-background { background-color: black; }
+
+.blue { color: #0000bf; }
+
+.blue-background { background-color: #0000fa; }
+
+.fuchsia { color: #bf00bf; }
+
+.fuchsia-background { background-color: #fa00fa; }
+
+.gray { color: #606060; }
+
+.gray-background { background-color: #7d7d7d; }
+
+.green { color: #006000; }
+
+.green-background { background-color: #007d00; }
+
+.lime { color: #00bf00; }
+
+.lime-background { background-color: #00fa00; }
+
+.maroon { color: #600000; }
+
+.maroon-background { background-color: #7d0000; }
+
+.navy { color: #000060; }
+
+.navy-background { background-color: #00007d; }
+
+.olive { color: #606000; }
+
+.olive-background { background-color: #7d7d00; }
+
+.purple { color: #600060; }
+
+.purple-background { background-color: #7d007d; }
+
+.red { color: #bf0000; }
+
+.red-background { background-color: #fa0000; }
+
+.silver { color: #909090; }
+
+.silver-background { background-color: #bcbcbc; }
+
+.teal { color: #006060; }
+
+.teal-background { background-color: #007d7d; }
+
+.white { color: #bfbfbf; }
+
+.white-background { background-color: #fafafa; }
+
+.yellow { color: #bfbf00; }
+
+.yellow-background { background-color: #fafa00; }
+
+span.icon > .fa { cursor: default; }
+
+.admonitionblock td.icon [class^="fa icon-"] { font-size: 2.5em; text-shadow: 1px 1px 2px rgba(0, 0, 0, 0.5); cursor: default; }
+.admonitionblock td.icon .icon-note:before { content: "\f05a"; color: #207c98; }
+.admonitionblock td.icon .icon-tip:before { content: "\f0eb"; text-shadow: 1px 1px 2px rgba(155, 155, 0, 0.8); color: #111; }
+.admonitionblock td.icon .icon-warning:before { content: "\f071"; color: #bf6900; }
+.admonitionblock td.icon .icon-caution:before { content: "\f06d"; color: #bf3400; }
+.admonitionblock td.icon .icon-important:before { content: "\f06a"; color: #bf0000; }
+
+.conum[data-value] { display: inline-block; color: #fff !important; background-color: #222222; -webkit-border-radius: 100px; border-radius: 100px; text-align: center; font-size: 0.75em; width: 1.67em; height: 1.67em; line-height: 1.67em; font-family:sans-serif, "Open Sans", "DejaVu Sans", sans-serif; font-style: normal; font-weight: bold; }
+.conum[data-value] * { color: #fff !important; }
+.conum[data-value] + b { display: none; }
+.conum[data-value]:after { content: attr(data-value); }
+pre .conum[data-value] { position: relative; top: -0.125em; }
+
+b.conum * { color: inherit !important; }
+
+
+.conum:not([data-value]):empty { display: none; }
+
+.literalblock pre, .listingblock pre { background: #eeeeee; }
+
+div#remarks.ulist {
+	max-width: 70%;
+}
+
+div.title:first-of-type {
+    display: none;
+}
+
+/* Mobile */
+
+@media only screen and (max-width: 800px) {
+	a#bottomright {visibility: hidden;}
+	.sectionbody.paragraph {max-width: 100%}
+	.paragraph.lead > p, #preamble > .sectionbody > .paragraph:first-of-type p { max-width: 100% }
+}
+
+#div.paragraph.faq-intro {
+	max-width: 66.66%
+}
+/* ========================================================================== Mobile Menu ======================================================================= */
+#menu {
+    display: none;
+    }
+
+div.slicknav_menu {
+    padding-top: 5px;
+    padding-right: 15px;
+    background-color: #132445;
+    margin-left: -2rem;
+    margin-right: -2rem;
+    text-align: right;
+    display: none;
+    right: 10px;
+    font-size: 1rem;
+    color: white;
+    padding-bottom: 2rem;
+    background: url("n4js-logo.png");
+    background-position: 10px 10px;
+    background-size: 344.48px 40px;
+    background-repeat: no-repeat;
+    background-color: #132445;
+}
+
+span.slicknav_menutxt {
+    margin-right: -20px;
+    color: white;
+}
+
+div.slicknav_menu a.scroll:first-of-type {
+    color: #F7D425;
+    font-size: 120%;
+    font-weight: 600;
+}
+div.slicknav_menu ul li a {
+    color: white;
+}
+div.slicknav_menu ul li a:hover {
+    color: #F7D425;
+}
+
+div.slicknav_menu a:hover {color: #F7D425; }
+div.slicknav_menu a:visited {color: white; }
+div.slicknav_menu a {color: white;}
+a.slicknav_btn  {
+    padding: 1rem;
+}
+
+
+li.slicknav_parent.slicknav_open {
+    color: white;
+}
+
+li.slicknav_parent.slicknav_open  {
+    color: white;
+}
+
+@media screen and (max-width: 890px) {
+    div.slicknav_menu {
+        display: block;
+        color: white
+    }
+    #mobile-banner {
+        display: block;
+    }
+}
+
+@media screen and (max-width: 470px) {
+div.slicknav_menu ul:first-of-type {
+    margin-top: 1.5rem;
+}
+
+div.slicknav_menu ul li {
+    color: white;
+}
+div.slicknav_menu ul li:hover {
+    color: #F7D425;
+}
+}
+div.slicknav_menu li:last-of-type
+    {
+        padding-bottom: 0.7rem;
+    }
+/* ========================================================================== NavMenu ======================================================================= */
+
+.banner {
+  height: 1rem;
+  padding-right: 2rem;
+  max-height: 1rem;  
+  max-width: 50%;
+  vertical-align: middle;
+
+  @media (max-width: 800px) {
+    flex-basis: 66.666%%;
+    max-width: 25%;
+    margin: 1rem;
+
+  }
+}
+
+
+div.box p { 
+text-indent: 0px; 
+position: absolute;
+display: none;
+}
+
+
+#menubar ul { margin: 0; padding: 0; white-space:nowrap; padding-left: 10px; padding-right: 10px; line-height: 2rem;}
+#menubar li { margin: 0; padding: 0;   }
+#menubar a { margin: 0; padding: 0;}
+#menubar ul {list-style: none; text-align: right;}
+#menubar a {text-decoration: none;}
+#menubar li {margin-left: 0;}
+#menubar {height: 70px; background-color: #132445; /* box-shadow: 0px 2px 3px rgba(0,0,0,.4); */ position: relative; padding-right: 2rem; margin-left: -2rem;  margin-right: -2rem;  color: white; font-size: 1.9rem;}
+
+
+#menubar > ul > li {
+
+    display:inline-block;
+    margin: 0.2rem;
+    position: relative;
+    z-index: 10000;
+    flex-basis: 66.666%%;
+    font-weight: 700;
+
+}
+
+@media only screen and (max-width: 890px) {
+
+#n4js-mobile-logo { 
+    position: absolute;
+    top: 0;
+    left: 0;
+    width: 178px;
+    height: 60px;
+    background-color: transparent;
+}
+
+div.box p { 
+text-indent: -999px; 
+position: absolute;
+}
+
+  #menubar > ul > li, #menubar {
+    visibility: hidden;
+    display: none;
+  }
+
+}
+
+@media only screen and (max-width: 500px) {
+
+
+
+
+#menubar {
+  display: none;
+}
+
+#logo {
+  margin-top: -55px;
+}
+
+}
+
+#logo {
+  height: 40px;
+  margin-left: 40px;
+  margin-top: 17px;
+  position: relative;
+  overflow: hidden;
+}
+
+#menubar > ul > li::after {
+    content: " · ";
+    position: relative;
+    top: 3px;
+    padding-left: 3px;
+    font-weight: 400;
+}
+
+#menubar > ul > li:last-of-type::after {
+  content: none;
+}
+#menubar > ul > li:last-of-type {
+  padding-right: -1rem;
+}
+
+#menubar > ul > li > a {
+    color: #FFFFFF;
+    font-size:  1.2rem;
+    line-height: 50px; 
+    font-weight: 400;
+    /* padding-top: 2rem; */
+    webkit-transition: color .15s;
+    -moz-transition: color .15s;
+    -o-transition: color .15s;
+    transition: color .15s;
+    white-space:nowrap; 
+    -webkit-font-smoothing: auto;
+    letter-spacing: -.01em;
+    padding-top: 0.2em;
+    padding-left: 0rem;
+    padding-right: 0.1rem;
+}
+
+#menubar > ul {
+    margin-right: 12px;
+    margin-top: 0px;
+}
+
+#menubar > ul > li > a:hover {color: #F7D425; }
+body.home li.home, body.tech li.tech {font-weight:bold; }
+
+#menubar > ul > li > ul {
+    opacity: 0;
+    visibility: hidden;
+    padding: 18px 0 20px 0;
+    background-color: #FFFFFF; /* rgb(15,26,54); top menu color */
+    text-align: left;
+    position: absolute;
+    top: 55px;
+    left: 50%;
+    margin-left: -200px;
+-webkit-transition: all .3s .1s;
+   -moz-transition: all .3s .1s;
+     -o-transition: all .3s .1s;
+        transition: all .3s .1s;
+-webkit-border-radius: 5px;
+   -moz-border-radius: 5px;
+        border-radius: 5px;
+-webkit-box-shadow: 0px 1px 3px rgba(0,0,0,.4);
+   -moz-box-shadow: 0px 1px 3px rgba(0,0,0,.4);
+        box-shadow: 0px 1px 3px rgba(0,0,0,.4);
+}
+
+#menubar > li li {
+    width:100%;
+}
+
+#menubar > ul > li:hover > ul {
+    opacity: 1;
+    top: 65px;
+    visibility: visible;
+}
+
+#menubar > ul > li > ul:before{
+    content: '';
+    display: block;
+    border-color: transparent transparent #FFFFFF transparent;
+    border-style: solid;
+    border-width: 10px;
+    position: absolute;
+    top: -20px;
+    left: 10%;
+    margin-left: -10px;
+}
+
+#menubar > ul ul > li { position: relative;}
+
+#menubar ul ul a{
+    color: rgb(50,50,50);
+    font-family:  sans-serif, Verdana, 'Lucida Grande';
+    font-size: 17px;
+    background-color: #FFFFFF; /* rgb(15,26,54); top menu color */
+    padding: 5px 8px 7px 16px;
+    display: block;
+-webkit-transition: background-color .1s;
+   -moz-transition: background-color .1s;
+     -o-transition: background-color .1s;
+        transition: background-color .1s;
+}
+
+#menubar ul ul a:hover {background-color: #244D82; color: #F7D425;}
+
+#menubar ul ul ul {
+    visibility: hidden;
+    opacity: 0;
+    position: absolute;
+    top: -16px;
+    left: 206px;
+    padding: 16px 0 20px 0;
+    background-color: #527AA3;
+    text-align: left;
+    width: 160px;
+-webkit-transition: all .3s;
+   -moz-transition: all .3s;
+     -o-transition: all .3s;
+        transition: all .3s;
+-webkit-border-radius: 5px;
+   -moz-border-radius: 5px;
+        border-radius: 5px;
+-webkit-box-shadow: 0px 1px 3px rgba(0,0,0,.4);
+   -moz-box-shadow: 0px 1px 3px rgba(0,0,0,.4);
+        box-shadow: 0px 1px 3px rgba(0,0,0,.4);
+}
+
+
+#menubar ul ul > li:hover > ul { opacity: 1; left: 196px; visibility: visible;}
+
+
+#menubar ul ul a:hover{
+    background-color: #244D82;
+    color: #F7D425;
+}
+
+
+.Cell--12-12 {
+    -webkit-flex-basis: 100%;
+    -ms-flex-preferred-size: 100%;
+    flex-basis: 100%;
+    max-width: 100%
+}
+
+.Grid {
+    display: -webkit-flex;
+    display: -ms-flexbox;
+    display: flex;
+    -webkit-align-items: stretch;
+    -ms-flex-align: stretch;
+    align-items: stretch;
+    -webkit-flex-wrap: wrap;
+    -ms-flex-wrap: wrap;
+    flex-wrap: wrap;
+    -webkit-flex: 0 1 auto;
+    -ms-flex: 0 1 auto;
+    flex: 0 1 auto;
+    -webkit-flex-direction: row;
+    -ms-flex-direction: row;
+    flex-direction: row
+}
+
+.Cell,
+.Comparison .Comparison-left,
+.Comparison .Comparison-right,
+.ExampleExplanation .ExampleExplanation-code,
+.ExampleExplanation .ExampleExplanation-text,
+.FeatureTabs .FeatureTabs-stage,
+.Intro .Intro-Slogan {
+    padding-left: 1rem;
+    padding-right: 1rem;
+    -webkit-flex: 0 0 auto;
+    -ms-flex: 0 0 auto;
+    flex: 0 0 auto
+}
+
+#_index, #_feature_table {display: none;}
+
+#_documentation {margin-top: -2rem;}
+
+h3 {padding-top: 1rem}
+
+/* ========================================================================== AsciiSpec ======================================================================= */
+.requirement {
+	border: 1px solid #aaaaaa;
+	padding: 0.5em;
+	margin-bottom: 1rem;
+}
+
+.bibliography .content .paragraph p :first-child::before { 
+	color:#777777;
+	content: "[" attr(id) "] "; }
+
+.bibliography .content .paragraph {
+	padding-left: 6em;
+	text-indent: -6em;
\ No newline at end of file
diff --git a/idespec/styles/n4jsspec-adoc.css b/idespec/styles/n4jsspec-adoc.css
new file mode 100644
index 0000000..598cae4
--- /dev/null
+++ b/idespec/styles/n4jsspec-adoc.css
@@ -0,0 +1,1292 @@
+@import url("backtotop.css");
+
+/* ========================================================================== HTML5 display definitions ========================================================================== */
+/** Correct `block` display not defined in IE 8/9. */
+@import url(https://fast.fonts.net/cssapi/20974f8a-0939-4574-aef9-681eda2faca8.css);
+article, aside, details, figcaption, figure, footer, header, hgroup, main, nav, section, summary { display: block; }
+
+/** Correct `inline-block` display not defined in IE 8/9. */
+audio, canvas, video { display: inline-block; }
+
+/** Prevent modern browsers from displaying `audio` without controls. Remove excess height in iOS 5 devices. */
+audio:not([controls]) { display: none; height: 0; }
+
+/** Address `[hidden]` styling not present in IE 8/9. Hide the `template` element in IE, Safari, and Firefox < 22. */
+[hidden], template { display: none; }
+
+script { display: none !important; }
+
+/* ========================================================================== Base ========================================================================== */
+/** 1. Set default font family to sans-serif. 2. Prevent iOS text size adjust after orientation change, without disabling user zoom. */
+html { /* 1 */ -ms-text-size-adjust: 100%; /* 2 */ -webkit-text-size-adjust: 100%; /* 2 */ background-color: #D5DFEA; }
+
+/** Remove default margin. */
+body { margin: 0; background-color: #D5DFEA; font-family:sans-serif; font-weight: 400} /* add margin-right 0 here for mobile*/
+
+/* ========================================================================== Links ========================================================================== */
+/** Remove the gray background color from active links in IE 10. */
+a { background: transparent; }
+
+/** Address `outline` inconsistency between Chrome and other browsers. */
+a:focus { outline: thin dotted; }
+
+/** Improve readability when focused and also mouse hovered in all browsers. */
+a:active, a:hover { outline: 0; }
+
+/* ========================================================================== Typography ========================================================================== */
+/** Address variable `h1` font-size and margin within `section` and `article` contexts in Firefox 4+, Safari 5, and Chrome. */
+h1 { font-size: 2em; margin: 0.67em 0; }
+
+/** Address styling not present in IE 8/9, Safari 5, and Chrome. */
+abbr[title] { border-bottom: 1px dotted; }
+
+/** Address style set to `bolder` in Firefox 4+, Safari 5, and Chrome. */
+b, strong { font-weight: 600; }
+
+/** Address styling not present in Safari 5 and Chrome. */
+dfn { font-style: italic; }
+
+/** Address differences between Firefox and other browsers. */
+hr { -moz-box-sizing: content-box; box-sizing: content-box; height: 0; }
+
+/** Address styling not present in IE 8/9. */
+mark { background: #ff0; color: #000; }
+
+/** Correct font family set oddly in Safari 5 and Chrome. */
+code, kbd, pre, samp { font-family: Fira Mono, monospace, serif; font-size: 1em; }
+
+/** Improve readability of pre-formatted text in all browsers. */
+pre { white-space: pre-wrap; }
+
+/** Set consistent quote types. */
+q { quotes: "\201C" "\201D" "\2018" "\2019"; }
+
+/** Address inconsistent and variable font size in all browsers. */
+small { font-size: 80%; }
+
+/** Prevent `sub` and `sup` affecting `line-height` in all browsers. */
+sub, sup { font-size: 75%; line-height: 0; position: relative; vertical-align: baseline; }
+
+sup { top: -0.5em; }
+
+sub { bottom: -0.25em; }
+
+/* ========================================================================== Embedded content ========================================================================== */
+/** Remove border when inside `a` element in IE 8/9. */
+img { border: 0; }
+
+/** Correct overflow displayed oddly in IE 9. */
+svg:not(:root) { overflow: hidden; }
+
+/* ========================================================================== Figures ========================================================================== */
+/** Address margin not present in IE 8/9 and Safari 5. */
+figure { margin: 0; }
+
+/* ========================================================================== Forms ========================================================================== */
+/** Define consistent border, margin, and padding. */
+fieldset { border: 1px solid #c0c0c0; margin: 0 2px; padding: 0.35em 0.625em 0.75em; }
+
+/** 1. Correct `color` not being inherited in IE 8/9. 2. Remove padding so people aren't caught out if they zero out fieldsets. */
+legend { border: 0; /* 1 */ padding: 0; /* 2 */ }
+
+/** 1. Correct font family not being inherited in all browsers. 2. Correct font size not being inherited in all browsers. 3. Address margins set differently in Firefox 4+, Safari 5, and Chrome. */
+button, input, select, textarea { font-family: inherit; /* 1 */ font-size: 100%; /* 2 */ margin: 0; /* 3 */ }
+
+/**
+#tocbutton {
+	top: 0;
+	left: 13rem;
+	position:fixed;
+	z-index: 1000;
+}
+*/
+/** Address Firefox 4+ setting `line-height` on `input` using `!important` in the UA stylesheet. */
+button, input { line-height: normal; }
+
+/** Address inconsistent `text-transform` inheritance for `button` and `select`. All other form control elements do not inherit `text-transform` values. Correct `button` style inheritance in Chrome, Safari 5+, and IE 8+. Correct `select` style inheritance in Firefox 4+ and Opera. */
+button, select { text-transform: none; }
+
+/** 1. Avoid the WebKit bug in Android 4.0.* where (2) destroys native `audio` and `video` controls. 2. Correct inability to style clickable `input` types in iOS. 3. Improve usability and consistency of cursor style between image-type `input` and others. */
+button, html input[type="button"], input[type="reset"], input[type="submit"] { -webkit-appearance: button; /* 2 */ cursor: pointer; /* 3 */ }
+
+/** Re-set default cursor for disabled elements. */
+button[disabled], html input[disabled] { cursor: default; }
+
+/** 1. Address box sizing set to `content-box` in IE 8/9. 2. Remove excess padding in IE 8/9. */
+input[type="checkbox"], input[type="radio"] { box-sizing: border-box; /* 1 */ padding: 0; /* 2 */ }
+
+/** 1. Address `appearance` set to `searchfield` in Safari 5 and Chrome. 2. Address `box-sizing` set to `border-box` in Safari 5 and Chrome (include `-moz` to future-proof). */
+input[type="search"] { -webkit-appearance: textfield; /* 1 */ -moz-box-sizing: content-box; -webkit-box-sizing: content-box; /* 2 */ box-sizing: content-box; }
+
+/** Remove inner padding and search cancel button in Safari 5 and Chrome on OS X. */
+input[type="search"]::-webkit-search-cancel-button, input[type="search"]::-webkit-search-decoration { -webkit-appearance: none; }
+
+/** Remove inner padding and border in Firefox 4+. */
+button::-moz-focus-inner, input::-moz-focus-inner { border: 0; padding: 0; }
+
+/** 1. Remove default vertical scrollbar in IE 8/9. 2. Improve readability and alignment in all browsers. */
+textarea { overflow: auto; /* 1 */ vertical-align: top; /* 2 */ }
+
+/* ========================================================================== Tables ========================================================================== */
+/** Remove most spacing between table cells. */
+table { border-collapse: collapse; border-spacing: 0; }
+
+meta.foundation-mq-small { font-family: "only screen and (min-width: 768px)"; width: 768px; }
+
+meta.foundation-mq-medium { font-family: "only screen and (min-width:1280px)"; width: 1280px; }
+
+meta.foundation-mq-large { font-family: "only screen and (min-width:1440px)"; width: 1440px; }
+
+*, *:before, *:after { -moz-box-sizing: border-box; -webkit-box-sizing: border-box; box-sizing: border-box; }
+
+html, body {  background-color:#527AA3; }
+
+body {  background: white; color: #222222;   padding: ; margin: 0; font-family:sans-serif, Helvetica, Arial, sans-serif; font-weight: 400; font-style: normal; position: relative; cursor: auto; padding-left: 2rem; padding-right: 2rem;}
+
+
+a:hover { cursor: pointer; }
+
+img, object, embed {  height: auto; max-width: 90%; }
+
+
+object, embed { height: 100%; }
+
+img { -ms-interpolation-mode: bicubic; }
+
+#map_canvas img, #map_canvas embed, #map_canvas object, .map_canvas img, .map_canvas embed, .map_canvas object { max-width: none !important; }
+
+.left { float: left !important; }
+
+.right { float: right !important; }	
+
+.text-left { text-align: left !important; }
+
+.text-right { text-align: right !important; }
+
+.text-center { text-align: center !important; }
+
+.text-justify { text-align: justify !important; }
+
+.hide { display: none; }
+
+.antialiased, body { -webkit-font-smoothing: antialiased; }
+
+img { display: inline-block; vertical-align: baseline; }
+
+textarea { height: auto; min-height: 50px; }
+
+select { width: 100%; }
+
+object, svg { display: inline-block; vertical-align: middle; }
+
+.center { margin-left: auto; margin-right: auto; }
+
+.spread { width: 100%; margin-right: 2rem; }
+
+p.lead, .paragraph.lead > p, #preamble > .sectionbody > .paragraph:first-of-type p { font-size: 1em; line-height: 1.6;  }
+
+
+/* Typography padding etc */
+.subheader, .admonitionblock td.content > .title, .audioblock > .title, .exampleblock > .title, .imageblock > .title, .listingblock > .title, .literalblock > .title, .stemblock > .title, .openblock > .title, .paragraph > .title, .quoteblock > .title, table.tableblock > .title, .verseblock > .title, .videoblock > .title, .dlist > .title, .olist > .title, .ulist > .title, .qlist > .title, .hdlist > .title { line-height: 2.4; color: #132445; font-weight: 400; margin-top: 0em; margin-bottom: 0.5em;  }
+
+
+/* Typography resets */
+div, dl, dt, dd, ul, ol, li, h1, h2, h3, #toctitle, .sidebarblock > .content > .title, h4, h5, h6, pre, form, p, blockquote, th, td { margin: 0; padding: 0; direction: ltr; }
+div.openblock.partintro, div.sectionbody.paragraph {font-weight: 500;  line-height: 1.4; margin-bottom: 1em; }
+div.sect1 {
+	padding-top: 1rem;
+	padding-right: 1rem;
+}
+
+div.paragraph.faq-intro {max-width: 66%;}
+
+
+/* Default Link Styles */
+a { color: #6999d6; text-decoration: none; line-height: inherit;  }
+a:hover, a:focus { color: #132445; }
+a img { border: none; }
+
+
+/* Grey links with black transition 
+
+a { color: #2ba6cb; text-decoration: none; line-height: inherit; color: rgba(0,0,0,.3); transition: .2s; }
+a:active, a:hover, a:focus { color: #212121; }
+a img { border: none; }
+
+*/
+
+
+
+/* Default paragraph styles */
+p { font-family:sans-serif; font-weight: 400; font-size: 1.2rem; line-height: 1.4; padding-bottom: 0.5em;    }
+p aside { font-size: 0.575em; line-height: 1.35; font-style: italic; }
+div.p, { width: 100% }
+
+
+/* Default header styles */
+h1, h2, h3, #toctitle, .sidebarblock > .content > .title, h4, h5, h6 { font-family: sans-serif; font-weight: 600; font-style: normal; color: #244d82; text-rendering: optimizeLegibility; margin-bottom: 0em; line-height: 1.2125em; margin-top:; 2rem;  }
+h1 small, h2 small, h3 small, #toctitle small, .sidebarblock > .content > .title small, h4 small, h5 small, h6 small { font-size: 60%; color: #6999d6; line-height: 0; }
+
+h1 { font-size: 2.125em; max-width:66.66%;}
+
+h2 { font-size: 1.6875em; }
+
+h3, #toctitle, .sidebarblock > .content > .title { font-size: 1.375em; }
+
+h4 { font-size: 1.125em; }
+
+h5 { font-size: 1.125em; }
+
+h6 { font-size: 1em; }
+
+hr { border: solid #dddddd; border-width: 1px 0 0; clear: both; margin: 1.25em 0 1.1875em; height: 0; }
+
+/* Helpful Typography Defaults */
+em, i { font-style: italic; line-height: inherit; }
+
+strong, b { font-weight: 600; line-height: inherit; }
+
+small { font-size: 60%; line-height: inherit; }
+
+code { font-family: Fira Mono, Consolas, "Liberation Mono", Courier, monospace;  }
+
+/* Lists */
+ul, ol, dl {  list-style-position: outside; font-family:sans-serif; padding-left: 0rem; list-style-type: none}
+
+ul, ol { margin-left: 0em;  }
+ul.no-bullet, ol.no-bullet { margin-left: 1.5em;  margin-bottom: 0;}
+
+/* Unordered Lists */
+ul li ul, ul li ol { margin-left: 1.25em; margin-bottom: 0; font-size: 1em; /* Override nested font-size change */  }
+ul.square li ul, ul.circle li ul, ul.disc li ul { list-style: inherit; }
+ul.square { list-style-type: square; }
+ul.circle { list-style-type: circle; }
+ul.disc { list-style-type: none; }
+ul.no-bullet { list-style: none; }
+
+/* Ordered Lists */
+ol li ul, ol li ol { margin-left: 1.25em; margin-bottom: 0;   }
+
+/* Definition Lists */
+dl dt { margin-bottom: 0.3125em; font-weight: bold; font-size: 1.2em; font-style: italic}
+dl dd { margin-bottom: 1.25em; }
+
+/* Abbreviations */
+abbr, acronym { text-transform: uppercase; font-size: 90%; color: #222222; border-bottom: 1px dotted #dddddd; cursor: help; }
+
+abbr { text-transform: none; }
+
+/* Blockquotes */
+blockquote { margin: 0 0 1.25em; padding: 0.5625em 1.25em 0 1.1875em; border-left: 1px solid #dddddd; }
+blockquote cite { display: block; font-size: inherit; color: color: #132445; }
+blockquote cite:before { content: "\2014 \0020"; }
+blockquote cite a, blockquote cite a:visited { color: #417dcb; }
+
+blockquote, blockquote p { line-height: 1.6; color: #132445; }
+
+/* Microformats */
+.vcard { display: inline-block; margin: 0 0 1.25em 0; border: 1px solid #dddddd; padding: 0.625em 0.75em; }
+.vcard li { margin: 0; display: block; }
+.vcard .fn { font-weight: bold; font-size: 0.9375em; }
+
+.vevent .summary { font-weight: bold; }
+.vevent abbr { cursor: auto; text-decoration: none; font-weight: bold; border: none; padding: 0 0.0625em; }
+
+@media only screen and (min-width: 768px) { h1, h2, h3, #toctitle, .sidebarblock > .content > .title, h4, h5, h6 { line-height: 1.4;  margin-top: 1rem; margin-bottom: 0.2rem;}
+  h1 { font-size: 2.75em; }
+  h2 { font-size: 2.3125em; }
+  h3, #toctitle, .sidebarblock > .content > .title { font-size: 1.6875em; }
+  h4 { font-size: 1.4375em; } }
+
+/* Tables */
+table { background: white; margin-bottom: 1.25em; border: solid 1px #dddddd; }
+table thead, table tfoot { background: whitesmoke; font-weight: 600; }
+table thead tr th, table thead tr td, table tfoot tr th, table tfoot tr td { padding: 0.5em 0.625em 0.625em; font-size: inherit; color: #222222; text-align: left; }
+table tr th, table tr td { padding: 0.5625em 0.625em; font-size: inherit; color: #222222; }
+table tr.even, table tr.alt, table tr:nth-of-type(even) { background: #f9f9f9; }
+table thead tr th, table tfoot tr th, table tbody tr td, table tr td, table tfoot tr td { display: table-cell; line-height: 1.4; }
+
+/* FEATURE TABLE */
+
+table.done, tr.done.alt, table.done tr:nth-of-type(even) {
+	background: #efe;
+	padding-top: 0;
+	padding-bottom: 0;
+	border: none;
+	margin-bottom: -1px;
+}
+
+table.most, tr.most.alt, table.most tr:nth-of-type(even) {
+	background: #ffd;
+	padding-top: 0;
+	padding-bottom: 0;
+	border: none;
+	margin-bottom: -1px;
+}
+
+table.tbc, tr.tbc.alt, table.tbc tr:nth-of-type(even) {
+	background: #fff6de;
+	padding-top: 0;
+	padding-bottom: 0;
+	border: none;
+	margin-bottom: -1px;
+}
+
+table.tbd, tr.tbd.alt, table.tbd tr:nth-of-type(even) {
+	background: #fee;
+	padding-top: 0;
+	padding-bottom: 0;
+	border: none;
+	margin-bottom: -1px;
+}
+
+table.done thead tr th, table.done tfoot tr th, table.done tfoot tr td, table.done.sect2, table.most thead tr th, table.most tfoot tr th, table.most tfoot tr td, table.most.sect2, table.tbc thead tr th, table.tbc tfoot tr th, table.tbc tfoot tr td, table.tbc.sect2, table.tbd thead tr th, table.tbd tfoot tr th, table.tbd tfoot tr td, table.tbd.sect2 {background: white; font-size: 1.9rem; color: #417dcb; }
+
+
+
+/* 
+green "done" = #efe
+yellow "most" = #ffd
+orange "tbc" = #fff6de
+red "tbd" = #fee
+ */
+
+
+
+body { tab-size: 4; max-width: 1250px; margin-right: auto; margin-left: auto; position: relative; margin-top: 0rem; margin-bottom: 0rem; padding-top: 0rem; /*  Fixes tables, breaks headers */}
+
+h1, h2, h3, #toctitle, .sidebarblock > .content > .title, h4, h5, h6 { line-height: 1.4;  margin-top: 0rem;}
+
+.clearfix:before, .clearfix:after, .float-group:before, .float-group:after { content: " "; display: table; }
+.clearfix:after, .float-group:after { clear: both; }
+
+*:not(pre) > code { font-size: inherit; font-style: normal !important; letter-spacing: 0; padding: 0; line-height: inherit; }
+
+pre, pre > code { line-height: 1.4; color: black; font-family: monospace, serif; font-weight: normal; }
+
+.keyseq { color: #555555; }
+
+kbd { font-family: Consolas, "Liberation Mono", Courier, monospace; display: inline-block; color: #222222; font-size: 0.65em; line-height: 1.45; background-color: #f7f7f7; border: 1px solid #ccc; -webkit-border-radius: 3px; border-radius: 3px; -webkit-box-shadow: 0 1px 0 rgba(0, 0, 0, 0.2), 0 0 0 0.1em white inset; box-shadow: 0 1px 0 rgba(0, 0, 0, 0.2), 0 0 0 0.1em white inset; margin: 0 0.15em; padding: 0.2em 0.5em; vertical-align: middle; position: relative; top: -0.1em; white-space: nowrap; }
+
+.keyseq kbd:first-child { margin-left: 0; }
+
+.keyseq kbd:last-child { margin-right: 0; }
+
+.menuseq, .menu { color: #090909; }
+
+b.button:before, b.button:after { position: relative; top: -1px; font-weight: normal; }
+
+b.button:before { content: "["; padding: 0 3px 0 2px; }
+
+b.button:after { content: "]"; padding: 0 2px 0 3px; }
+
+#header, #content, #footnotes, #footer {  
+	max-width: 1050px; margin-right: auto; margin-left: auto; position: relative; 
+	margin-top: 0rem; margin-bottom: 0rem; 
+	padding-top: 0rem;  padding-right: 1rem;}
+#header:before, #header:after, #content:before, #content:after, #footnotes:before, #footnotes:after, #footer:before, #footer:after { content: " "; display: table; }
+#header:after, #content:after, #footnotes:after, #footer:after { clear: both; }
+
+
+#content:before { content: none; }
+#content {padding-left: 0.5rem;}
+
+#header > h1:first-child { color: black; font-weight: bold; margin-top: 2.25rem; margin-bottom: 0; }
+#header > h1:first-child + #toc { margin-top: 8px; border-top: 1px solid #dddddd; }
+#header > h1:only-child, body.toc2 #header > h1:nth-last-child(2) { border-bottom: 1px solid #dddddd; padding-bottom: 8px; }
+#header .details { border-bottom: 1px solid #dddddd; line-height: 1.45; padding-top: 0.25em; padding-bottom: 0.25em; padding-left: 0.25em; color: #417dcb; display: -ms-flexbox; display: -webkit-flex; display: flex; -ms-flex-flow: row wrap; -webkit-flex-flow: row wrap; flex-flow: row wrap; }
+#header .details span:first-child { margin-left: -0.125em; }
+#header .details span.email a { color: #6999d6; }
+#header .details br { display: none; }
+#header .details br + span:before { content: "\00a0\2013\00a0"; }
+#header .details br + span.author:before { content: "\00a0\22c5\00a0"; color: #6999d6; }
+#header .details br + span#revremark:before { content: "\00a0|\00a0"; }
+#header #revnumber { text-transform: capitalize; }
+#header #revnumber:after { content: "\00a0"; }
+
+#content > h1:first-child:not([class]) { color: black; font-weight: bold; border-bottom: 1px solid #dddddd; max-width: 1050px; margin-right: auto; margin-left: auto; position: relative; margin-top: 4rem; margin-bottom: 4rem; padding-top: 0rem;   }
+
+/* ========================================================================== Table of Contents ======================================================================= */
+
+
+
+#toc { border-bottom: 1px solid #dddddd; padding-bottom: 0.5em; position: relative; left: 0;}
+#toc > ul { margin-left: 0.125em; padding-left: 1em; }
+#toc ul.sectlevel0 > li > a { font-style: italic; }
+#toc ul.sectlevel0 ul.sectlevel1 { margin: 0.5em 0; }
+#toc ul { font-family: "Helvetica Neue", "Helvetica", Helvetica, Arial, sans-serif; list-style-type: none; }
+#toc li { line-height: 1.3334; margin-top: 0.3334em; }
+#toc a { text-decoration: none; }
+#toc a:active { text-decoration: underline; }
+
+#toc ul li:before {
+    /* content: "›"; */
+    margin-left: -.75em;
+    margin-right: .4em;
+    color: #244d82
+}
+
+
+
+div.ulist li:before {
+    content: "›";
+    position: absolute;
+    margin-top: .2rem;
+    font-size: x-large;
+    margin-left: -.75em;
+    margin-bottom: -.75em;
+    margin-right: 0;
+    line-height: 1rem;
+    color: #244d82
+
+}
+
+
+#toctitle { color: #244d82; font-size: 1.2em; padding-left: 1em; }
+
+#faq {
+	position: relative;
+	right: 9.3rem;
+    top: 9rem;
+	margin-bottom: 20px;
+	left: 45rem;
+	z-index:1;padding-left:2rem;border-left:1px solid #d3d3d3
+
+}
+@media only screen and (max-width: 945px) {
+	div#faq { display: none; }
+}
+
+#faq h2 {
+	font-size: 25px;
+	font-weight: 600;
+	margin-top: -8rem;
+}
+
+div#faq li:before {
+    content: "›";
+    position: absolute;
+    font-size: x-large;
+    margin-left: -.75em;
+    margin-bottom: -.75em;
+    margin-right: 0;
+    line-height: 1rem;
+    color: #244d82
+}
+
+#features-nav {
+	position: absolute;
+	right: 1rem;
+	top: 2rem;
+	margin-bottom: 20px;
+	position:absolute;z-index:1;padding-left:2rem;border-left:1px solid #d3d3d3
+}
+
+@media only screen and (max-width: 993px) {
+	#features-nav { display: none; }
+}
+
+#features-nav h2 {
+	font-size: 25px;
+	font-weight: 600;
+	margin-top: -1rem;
+}
+#features-nav li {
+	margin-top: .3rem;
+}
+
+div#features-nav li:before {
+    content: "›";
+    position: absolute;
+    font-size: x-large;
+    margin-left: -.75em;
+    margin-bottom: -.75em;
+    margin-right: 0;
+    line-height: 1rem;
+    color: #244d82
+}
+
+
+
+@media only screen and (min-width: 1434px ) { 
+	body.toc2.toc-right #toc.toc2 { border-right-width: 0; border: none; left: 0px; }
+	#toctitle { padding-top: 1.5rem; font-size: 1.375em; }
+	body.toc2 { padding-left: 2em; padding-right: 1em; }
+	#toc.toc2 { margin-top: 0 !important; background-color: #f2f2f2; position: fixed; width: 12em; left: 0; top: 0; border-right: 1px solid #dddddd; border-top-width: 0 !important; border-bottom-width: 0 !important; z-index: 1000; padding: 1.25em 0.25em 0em 0.25em; height: 100%; overflow: auto; }
+	#toc.toc2 #toctitle { margin-top: 0; margin-bottom: 0.8rem; font-size: 1.2em; padding-left: 1em;}
+	#toc.toc2 > ul { font-size: 0.9em; margin-bottom: 0; }
+	#toc.toc2 ul ul { margin-left: 1em; padding-left: .3em; }
+	#toc.toc2 ul.sectlevel0 ul.sectlevel1 { padding-left: 0; margin-top: 0.5em; margin-bottom: 0.5em; }
+	body.toc2.toc-right { padding-left: 2em; padding-right: 2em; }
+	body.toc2.toc-right #toc.toc2 { border-right-width: 0; border-left: 1px solid #dddddd; left: auto; right: -13rem; } 
+}
+@media only screen and (min-width: 1535px) { 
+	body.toc2 { padding-left: 2em; padding-right: 2em; }
+	#toctitle { padding-top: 0rem; font-size: 1.375em; }
+	#toc.toc2 { width: 13em; }
+	
+	#toc.toc2 #toctitle { font-size: 1.375em; }
+	
+	#toc.toc2 > ul { font-size: 0.95em; }
+	#toc.toc2 ul ul { padding-left: 0; }
+	body.toc2.toc-right { padding-left: 2em; padding-right: 2em; } 
+}
+
+#content #toc { border-style: solid; border-width: 1px; border-color: #d9d9d9; margin-bottom: 1.25em; padding: 1.25em; background: #f2f2f2; -webkit-border-radius: 0; border-radius: 0; }
+#content #toc > :first-child { margin-top: 0; }
+#content #toc > :last-child { margin-bottom: 0; }
+
+
+
+div.social  { line-height: 1.4; color: #FFFFFF;font-size:  1.2rem; font-weight: 400; font-style: bold; background-color: #132445; margin-right: -2rem; margin-left: -2rem; text-align: left; padding-bottom: 4px; padding-left: 25px; }
+div.social li a {  margin-bottom: 2em;  color: #d5dfea;font-size:  1.2rem; font-weight: 800; font-style: bold; list-style: none; list-style-type: none; text-decoration-color: rgb(213, 223, 234); }
+/* div.social a:visited { color: #244D82; }*/
+div.social a:hover { color: #F7D425; }
+div.social :first-child { margin-top: 0; }
+div.social h2 {        margin-bottom: 20px;font-weight: 600;font-size: 1.3em;margin-top: 4rem;color: #244d82;font-family: sans-serif;}
+div.social li:before {content: "› "; color: #244d82;font-size: large;font-weight: 800;}
+div.social ul {margin-top: -10px;line-height: 30px;}
+div.social li {/* nothing */}
+
+#bottomright {float: right;}
+
+
+
+
+
+#footer-text { color: #dddddd; line-height: 1.44; }
+
+
+.sect1 { padding-bottom: 0.625em; }
+.sectionbody.paragraph {max-width: 66.666%}
+.sectionbody ul {padding-left: 1rem;}
+
+@media only screen and (min-width: 768px) { .sect1 { padding-bottom: 0em; } }
+.sect1 + .sect1 { border-top: 0px solid #dddddd; }
+
+#content h1 > a.anchor, h2 > a.anchor, h3 > a.anchor, #toctitle > a.anchor, .sidebarblock > .content > .title > a.anchor, h4 > a.anchor, h5 > a.anchor, h6 > a.anchor { position: absolute; z-index: 1001; width: 1.5ex; margin-left: -1.5ex; display: block; text-decoration: none !important; visibility: hidden; text-align: center; font-weight: 400; max-width: 1050px; }
+#content h1 > a.anchor:before, h2 > a.anchor:before, h3 > a.anchor:before, #toctitle > a.anchor:before, .sidebarblock > .content > .title > a.anchor:before, h4 > a.anchor:before, h5 > a.anchor:before, h6 > a.anchor:before { content: "\2771"; font-size: 0.85em; display: block; padding-top: 0.1em; vertical-align: bas }
+#content h1:hover > a.anchor, #content h1 > a.anchor:hover, h2:hover > a.anchor, h2 > a.anchor:hover, h3:hover > a.anchor, #toctitle:hover > a.anchor, .sidebarblock > .content > .title:hover > a.anchor, h3 > a.anchor:hover, #toctitle > a.anchor:hover, .sidebarblock > .content > .title > a.anchor:hover, h4:hover > a.anchor, h4 > a.anchor:hover, h5:hover > a.anchor, h5 > a.anchor:hover, h6:hover > a.anchor, h6 > a.anchor:hover { visibility: visible; }
+#content h1 > a.link, h2 > a.link, h3 > a.link, #toctitle > a.link, .sidebarblock > .content > .title > a.link, h4 > a.link, h5 > a.link, h6 > a.link { color: #244d82; text-decoration: none; font-family:  sans-serif}
+#content h1 > a.link:hover, h2 > a.link:hover, h3 > a.link:hover, #toctitle > a.link:hover, .sidebarblock > .content > .title > a.link:hover, h4 > a.link:hover, h5 > a.link:hover, h6 > a.link:hover { color: #1e416e; }
+
+.audioblock, .imageblock, .literalblock, .listingblock, .stemblock, .videoblock { margin-bottom: 1.25em; }
+
+.admonitionblock td.content > .title, .audioblock > .title, .exampleblock > .title, .imageblock > .title, .listingblock > .title, .literalblock > .title, .stemblock > .title, .openblock > .title, .paragraph > .title, .quoteblock > .title, table.tableblock > .title, .verseblock > .title, .videoblock > .title, .dlist > .title, .olist > .title, .ulist > .title, .qlist > .title, .hdlist > .title { text-rendering: optimizeLegibility; text-align: left;   }
+
+table.tableblock > caption.title { white-space: nowrap; overflow: visible; max-width: 0;  }
+
+.paragraph.lead > p, #preamble > .sectionbody > .paragraph:first-of-type p { color: black; max-width: 66%}
+
+table.tableblock #preamble > .sectionbody > .paragraph:first-of-type p { font-size: inherit; }
+
+.admonitionblock > table { border-collapse: separate; border: 0; background: none; max-width: 80%;}
+.admonitionblock > table td.icon { text-align: center; width: 80px; }
+.admonitionblock > table td.icon img { max-width: none; }
+.admonitionblock > table td.icon .title { font-weight: bold; font-family:  sans-serif, Georgia, Verdana, "Helvetica", Helvetica, Arial, sans-serif; text-transform: uppercase; }
+.admonitionblock > table td.content { padding-left: 1.125em; padding-right: 1.25em; border-left: 1px solid #dddddd; color: #417dcb; }
+.admonitionblock > table td.content > :last-child > :last-child { margin-bottom: 0; }
+
+.exampleblock > .content { border-style: solid; border-width: 1px; border-color: #e6e6e6; margin-bottom: 1.25em; padding: 1.25em; background-color: #fffef7; -webkit-border-radius: 0; border-radius: 0; }
+.exampleblock > .content > :first-child { margin-top: 0; }
+.exampleblock > .content > :last-child { margin-bottom: 0; }
+
+.sidebarblock { position: absolute; border-style: solid; border-width: 1px; border-color: #d9d9d9; margin: -2rem -7.5rem 0rem 63.65rem; padding: .2rem; background: #f2f2f2; -webkit-border-radius: 0; border-radius: 0; text-align: left; width: 5.5rem;}
+.sidebarblock > :first-child { margin-top: 0; }
+.sidebarblock > :last-child { margin-bottom: 0; }
+.sidebarblock > .content > .title { color: #6999d6; margin-top: 0; }
+
+@media only screen and (max-width: 1203px) { 
+.sidebarblock { position: absolute; right: 12%; }
+}
+@media only screen and (max-width: 817px) { 
+.sidebarblock { position: absolute; right: 18%; }
+}
+
+@media only screen and (max-width: 562px) { 
+.sidebarblock { position: absolute; right: 25%; }
+}
+
+.exampleblock > .content > :last-child > :last-child, .exampleblock > .content .olist > ol > li:last-child > :last-child, .exampleblock > .content .ulist > ul > li:last-child > :last-child, .exampleblock > .content .qlist > ol > li:last-child > :last-child, .sidebarblock > .content > :last-child > :last-child, .sidebarblock > .content .olist > ol > li:last-child > :last-child, .sidebarblock > .content .ulist > ul > li:last-child > :last-child, .sidebarblock > .content .qlist > ol > li:last-child > :last-child { margin-bottom: 0; }
+
+.literalblock pre, .listingblock pre:not(.highlight), .listingblock pre[class="highlight"], .listingblock pre[class^="highlight "], .listingblock pre.CodeRay, .listingblock pre.prettyprint { background: #eeeeee; }
+.sidebarblock .literalblock pre, .sidebarblock .listingblock pre:not(.highlight), .sidebarblock .listingblock pre[class="highlight"], .sidebarblock .listingblock pre[class^="highlight "], .sidebarblock .listingblock pre.CodeRay, .sidebarblock .listingblock pre.prettyprint { background: #f2f1f1; }
+
+.literalblock pre, .literalblock pre[class], .listingblock pre, .listingblock pre[class] { border: 1px solid #cccccc; -webkit-border-radius: 0; border-radius: 0; word-wrap: break-word; padding: 0.8em 0.8em 0.65em 0.8em; font-size: 0.8125em; }
+.literalblock pre.nowrap, .literalblock pre[class].nowrap, .listingblock pre.nowrap, .listingblock pre[class].nowrap { overflow-x: auto; white-space: pre; word-wrap: normal; }
+@media only screen and (min-width: 768px) { .literalblock pre, .literalblock pre[class], .listingblock pre, .listingblock pre[class] { font-size: 0.90625em; } }
+@media only screen and (min-width: 1280px) { .literalblock pre, .literalblock pre[class], .listingblock pre, .listingblock pre[class] { font-size: 1em; } }
+
+.literalblock.output pre { color: #eeeeee; background-color: black; }
+
+.listingblock pre.highlightjs { padding: 0;  margin-right: 0em; }
+.listingblock pre.highlightjs > code { padding: 0.8em 2rem 0.65em 0.8em; -webkit-border-radius: 0; border-radius: 0; padding-right: 2rem;}
+
+.listingblock > .content { position: relative; }
+
+.listingblock code[data-lang]:before { display: none; content: attr(data-lang); position: absolute; font-size: 0.75em; top: 0.425rem; right: 0.5rem; line-height: 1; text-transform: uppercase; color: #999; padding-right: 2rem; }
+
+.listingblock:hover code[data-lang]:before { display: none; }
+
+.listingblock.terminal pre .command:before { content: attr(data-prompt); padding-right: 0.5em; color: #999; }
+
+.listingblock.terminal pre .command:not([data-prompt]):before { content: "$"; }
+
+table.pyhltable { border-collapse: separate; border: 0; margin-bottom: 0; background: none; }
+
+table.pyhltable td { vertical-align: top; padding-top: 0; padding-bottom: 0; line-height: 1.4; }
+
+table.pyhltable td.code { padding-left: .75em; padding-right: 0; }
+
+pre.pygments .lineno, table.pyhltable td:not(.code) { color: #999; padding-left: 0; padding-right: .5em; border-right: 1px solid #dddddd; }
+
+pre.pygments .lineno { display: inline-block; margin-right: .25em; }
+
+table.pyhltable .linenodiv { background: none !important; padding-right: 0 !important; }
+
+.quoteblock { margin: 0 1em 1.25em 1.5em; display: table; }
+.quoteblock > .title { margin-left: -1.5em; margin-bottom: 0.75em; }
+.quoteblock blockquote, .quoteblock blockquote p { color: #132445; font-size: 1.15rem; line-height: 1.75; word-spacing: 0.1em; letter-spacing: 0; font-style: italic; text-align: justify; }
+.quoteblock blockquote { margin: 0; padding: 1rem; border: 0; }
+.quoteblock blockquote:before { content: "\201c"; float: left; font-size: 2.75em; font-weight: bold; line-height: 0.6em; margin-left: -0.6em; color: #6999d6; text-shadow: 0 1px 2px rgba(0, 0, 0, 0.1); }
+.quoteblock blockquote > .paragraph:last-child p { margin-bottom: 0; }
+.quoteblock .attribution { margin-top: 1em; margin-right: 0.5ex; text-align: right; }
+.quoteblock .quoteblock { margin-left: 0; margin-right: 0; padding: 0.5em 0; border-left: 3px solid #417dcb; }
+.quoteblock .quoteblock blockquote { padding: 0 0 0 0.75em; }
+.quoteblock .quoteblock blockquote:before { display: none; }
+
+.verseblock { margin: 0 1em 1.25em 1em; }
+.verseblock pre { font-family:  sans-serif, "Open Sans", "DejaVu Sans", sans; font-size: 1.15rem; color: #6999d6; font-weight: 300; text-rendering: optimizeLegibility; }
+.verseblock pre strong { font-weight: 400; }
+.verseblock .attribution { margin-top: 1.25rem; margin-left: 0.5ex; text-align: right;}
+
+.quoteblock .attribution, .verseblock .attribution { font-size: inherit; line-height: 1.45; font-style: italic; }
+.quoteblock .attribution br, .verseblock .attribution br { display: none; }
+.quoteblock .attribution cite, .verseblock .attribution cite { display: block; letter-spacing: -0.025em; color: #417dcb; }
+
+.quoteblock.abstract { margin: 0 0 1.25em 0; display: block; }
+.quoteblock.abstract blockquote, .quoteblock.abstract blockquote p { text-align: left; word-spacing: 0; }
+.quoteblock.abstract blockquote:before, .quoteblock.abstract blockquote p:first-of-type:before { display: none; }
+
+table.tableblock { max-width: 100%; border-collapse: separate;  }
+table.tableblock td > .paragraph:last-child p > p:last-child, table.tableblock th > p:last-child, table.tableblock td > p:last-child { margin-bottom: 0; }
+
+table.tableblock, th.tableblock, td.tableblock { border: 0 solid #dddddd; margin-right: 2rem;}
+
+table.grid-all th.tableblock, table.grid-all td.tableblock { border-width: 0 1px 1px 0; padding: 0.5rem;}
+
+table.grid-all tfoot > tr > th.tableblock, table.grid-all tfoot > tr > td.tableblock { border-width: 1px 1px 0 0; }
+
+table.grid-cols th.tableblock, table.grid-cols td.tableblock { border-width: 0 1px 0 0; }
+
+table.grid-all * > tr > .tableblock:last-child, table.grid-cols * > tr > .tableblock:last-child { border-right-width: 0; }
+
+table.grid-rows th.tableblock, table.grid-rows td.tableblock { border-width: 0 0 1px 0; }
+
+table.grid-all tbody > tr:last-child > th.tableblock, table.grid-all tbody > tr:last-child > td.tableblock, table.grid-all thead:last-child > tr > th.tableblock, table.grid-rows tbody > tr:last-child > th.tableblock, table.grid-rows tbody > tr:last-child > td.tableblock, table.grid-rows thead:last-child > tr > th.tableblock { border-bottom-width: 0;}
+
+table.grid-rows tfoot > tr > th.tableblock, table.grid-rows tfoot > tr > td.tableblock { border-width: 1px 0 0 0; }
+
+table.frame-all { border-width: 1px; }
+
+table.frame-sides { border-width: 0 1px; }
+
+table.frame-topbot { border-width: 1px 0; }
+
+th.halign-left, td.halign-left { text-align: left; }
+
+th.halign-right, td.halign-right { text-align: right; }
+
+th.halign-center, td.halign-center { text-align: center; }
+
+th.valign-top, td.valign-top { vertical-align: top; }
+
+th.valign-bottom, td.valign-bottom { vertical-align: bottom; }
+
+th.valign-middle, td.valign-middle { vertical-align: middle; }
+
+table thead th, table tfoot th { font-weight: 600; }
+
+tbody tr th { display: table-cell; line-height: 1.4; background: whitesmoke; }
+
+tbody tr th, tbody tr th p, tfoot tr th, tfoot tr th p { color: #222222; font-weight: 600; }
+
+p.tableblock > code:only-child { background: none; padding: 0; max-width: 100%}
+
+p.tableblock { font-size: 1em; max-width: 100% }
+
+td > div.verse { white-space: pre; }
+
+ol { margin-left: 1.75em; }
+
+ul li ol { margin-left: 1.5em; }
+
+
+dl dd { margin-left: 1.125em; }
+
+dl dd:last-child, dl dd:last-child > :last-child { margin-bottom: 0; }
+
+ol > li p, ul > li p, ul dd, ol dd, .olist .olist, .ulist .ulist, .ulist .olist, .olist .ulist { margin-bottom: -0.2em; }
+
+ul.unstyled, ol.unnumbered, ul.checklist, ul.none { list-style-type: none; }
+
+ul.unstyled, ol.unnumbered, ul.checklist { margin-left: 0.625em; }
+
+ul.checklist li > p:first-child > .fa-square-o:first-child, ul.checklist li > p:first-child > .fa-check-square-o:first-child { width: 1em; font-size: 0.85em; }
+
+ul.checklist li > p:first-child > input[type="checkbox"]:first-child { width: 1em; position: relative; top: 1px; }
+
+ul.inline { margin: 0 auto 0.625em auto; margin-left: -1.375em; margin-right: 0; padding: 0; list-style: none; overflow: hidden; }
+ul.inline > li { list-style: none; float: left; margin-left: 1.375em; display: block; }
+ul.inline > li > * { display: block; }
+
+.unstyled dl dt { font-weight: normal; font-style: normal; }
+
+ol.arabic { list-style-type: decimal; }
+
+ol.decimal { list-style-type: decimal-leading-zero; }
+
+ol.loweralpha { list-style-type: lower-alpha; }
+
+ol.upperalpha { list-style-type: upper-alpha; }
+
+ol.lowerroman { list-style-type: lower-roman; }
+
+ol.upperroman { list-style-type: upper-roman; }
+
+ol.lowergreek { list-style-type: lower-greek; }
+
+.hdlist > table, .colist > table { border: 0; background: none; }
+.hdlist > table > tbody > tr, .colist > table > tbody > tr { background: none; }
+
+td.hdlist1, td.hdlist2 { vertical-align: baseline; padding: 0 0.625em; }
+
+td.hdlist1 { font-weight: bold; padding-bottom: 1.25em; }
+
+.literalblock + .colist, .listingblock + .colist { margin-top: -0.5em;  }
+
+.colist > table tr > td:first-of-type { padding: 0 0.75em; line-height: 1; }
+.colist > table tr > td:last-of-type { padding: 0.25em 0; }
+
+.thumb, .th { line-height: 0; display: inline-block; border: solid 4px white; -webkit-box-shadow: 0 0 0 1px #dddddd; box-shadow: 0 0 0 1px #dddddd; }
+
+.imageblock.left, .imageblock[style*="float: left"] { margin: 0.25em 0.625em 1.25em 0;   }
+.imageblock.right, .imageblock[style*="float: right"] { margin: 0.25em 0 1.25em 0.625em;  }
+.imageblock > .title { margin-bottom: 0; }
+.imageblock.thumb, .imageblock.th { border-width: 6px; }
+.imageblock.thumb > .title, .imageblock.th > .title { padding: 0 0.125em; }
+
+.image.left, .image.right { margin-top: 0.25em; margin-bottom: 0.25em; display: inline-block; line-height: 0; }
+.image.left { margin-right: 0.625em; }
+.image.right { margin-left: 0.625em; }
+
+a.image { text-decoration: none; display: inline-block; }
+a.image object { pointer-events: none; }
+
+sup.footnote, sup.footnoteref { font-size: 0.875em; position: static; vertical-align: super; }
+sup.footnote a, sup.footnoteref a { text-decoration: none; }
+sup.footnote a:active, sup.footnoteref a:active { text-decoration: underline; }
+
+#footnotes { padding-top: 0.75em; padding-bottom: 0.75em; margin-bottom: 0.625em; }
+#footnotes hr { width: 20%; min-width: 6.25em; margin: -0.25em 0 0.75em 0; border-width: 1px 0 0 0; }
+#footnotes .footnote { padding: 0 0.375em 0 0.225em; line-height: 1.3334; font-size: 0.875em; margin-left: 1.2em; text-indent: -1.05em; margin-bottom: 0.2em; }
+#footnotes .footnote a:first-of-type { font-weight: bold; text-decoration: none; }
+#footnotes .footnote:last-of-type { margin-bottom: 0; }
+#content #footnotes { margin-top: -0.625em; margin-bottom: 0; padding: 0.75em 0; }
+
+.gist .file-data > table { border: 0; background: #fff; width: 100%; margin-bottom: 0; }
+.gist .file-data > table td.line-data { width: 99%; }
+
+div.github-block { text-align: right; margin-right: -1rem; }
+div.gist {padding-right: 2rem;}
+
+div.unbreakable { page-break-inside: avoid; }
+
+.big { font-size: larger; }
+
+.small { font-size: smaller; }
+
+.underline { text-decoration: underline; }
+
+.overline { text-decoration: overline; }
+
+.line-through { text-decoration: line-through; }
+
+.aqua { color: #00bfbf; }
+
+.aqua-background { background-color: #00fafa; }
+
+.black { color: black; }
+
+.black-background { background-color: black; }
+
+.blue { color: #0000bf; }
+
+.blue-background { background-color: #0000fa; }
+
+.fuchsia { color: #bf00bf; }
+
+.fuchsia-background { background-color: #fa00fa; }
+
+.gray { color: #606060; }
+
+.gray-background { background-color: #7d7d7d; }
+
+.green { color: #006000; }
+
+.green-background { background-color: #007d00; }
+
+.lime { color: #00bf00; }
+
+.lime-background { background-color: #00fa00; }
+
+.maroon { color: #600000; }
+
+.maroon-background { background-color: #7d0000; }
+
+.navy { color: #000060; }
+
+.navy-background { background-color: #00007d; }
+
+.olive { color: #606000; }
+
+.olive-background { background-color: #7d7d00; }
+
+.purple { color: #600060; }
+
+.purple-background { background-color: #7d007d; }
+
+.red { color: #bf0000; }
+
+.red-background { background-color: #fa0000; }
+
+.silver { color: #909090; }
+
+.silver-background { background-color: #bcbcbc; }
+
+.teal { color: #006060; }
+
+.teal-background { background-color: #007d7d; }
+
+.white { color: #bfbfbf; }
+
+.white-background { background-color: #fafafa; }
+
+.yellow { color: #bfbf00; }
+
+.yellow-background { background-color: #fafa00; }
+
+span.icon > .fa { cursor: default; }
+
+.admonitionblock td.icon [class^="fa icon-"] { font-size: 2.5em; text-shadow: 1px 1px 2px rgba(0, 0, 0, 0.5); cursor: default; }
+.admonitionblock td.icon .icon-note:before { content: "\f05a"; color: #207c98; }
+.admonitionblock td.icon .icon-tip:before { content: "\f0eb"; text-shadow: 1px 1px 2px rgba(155, 155, 0, 0.8); color: #111; }
+.admonitionblock td.icon .icon-warning:before { content: "\f071"; color: #bf6900; }
+.admonitionblock td.icon .icon-caution:before { content: "\f06d"; color: #bf3400; }
+.admonitionblock td.icon .icon-important:before { content: "\f06a"; color: #bf0000; }
+
+.conum[data-value] { display: inline-block; color: #fff !important; background-color: #222222; -webkit-border-radius: 100px; border-radius: 100px; text-align: center; font-size: 0.75em; width: 1.67em; height: 1.67em; line-height: 1.67em; font-family:sans-serif, "Open Sans", "DejaVu Sans", sans-serif; font-style: normal; font-weight: bold; }
+.conum[data-value] * { color: #fff !important; }
+.conum[data-value] + b { display: none; }
+.conum[data-value]:after { content: attr(data-value); }
+pre .conum[data-value] { position: relative; top: -0.125em; }
+
+b.conum * { color: inherit !important; }
+
+
+.conum:not([data-value]):empty { display: none; }
+
+.literalblock pre, .listingblock pre { background: #eeeeee; }
+
+div#remarks.ulist {
+	max-width: 70%;
+}
+
+div.title:first-of-type {
+    display: none;
+}
+
+/* Mobile */
+
+@media only screen and (max-width: 800px) {
+	a#bottomright {visibility: hidden;}
+	.sectionbody.paragraph {max-width: 100%}
+	.paragraph.lead > p, #preamble > .sectionbody > .paragraph:first-of-type p { max-width: 100% }
+}
+
+#div.paragraph.faq-intro {
+	max-width: 66.66%
+}
+/* ========================================================================== Mobile Menu ======================================================================= */
+#menu {
+    display: none;
+    }
+
+div.slicknav_menu {
+    padding-top: 5px;
+    padding-right: 15px;
+    background-color: #132445;
+    margin-left: -2rem;
+    margin-right: -2rem;
+    text-align: right;
+    display: none;
+    right: 10px;
+    font-size: 1rem;
+    color: white;
+    padding-bottom: 2rem;
+    background: url("n4js-logo.png");
+    background-position: 10px 10px;
+    background-size: 344.48px 40px;
+    background-repeat: no-repeat;
+    background-color: #132445;
+}
+
+span.slicknav_menutxt {
+    margin-right: -20px;
+    color: white;
+}
+
+div.slicknav_menu a.scroll:first-of-type {
+    color: #F7D425;
+    font-size: 120%;
+    font-weight: 600;
+}
+div.slicknav_menu ul li a {
+    color: white;
+}
+div.slicknav_menu ul li a:hover {
+    color: #F7D425;
+}
+
+div.slicknav_menu a:hover {color: #F7D425; }
+div.slicknav_menu a:visited {color: white; }
+div.slicknav_menu a {color: white;}
+a.slicknav_btn  {
+    padding: 1rem;
+}
+
+
+li.slicknav_parent.slicknav_open {
+    color: white;
+}
+
+li.slicknav_parent.slicknav_open  {
+    color: white;
+}
+
+@media screen and (max-width: 890px) {
+    div.slicknav_menu {
+        display: block;
+        color: white
+    }
+    #mobile-banner {
+        display: block;
+    }
+}
+
+@media screen and (max-width: 470px) {
+div.slicknav_menu ul:first-of-type {
+    margin-top: 1.5rem;
+}
+
+div.slicknav_menu ul li {
+    color: white;
+}
+div.slicknav_menu ul li:hover {
+    color: #F7D425;
+}
+}
+div.slicknav_menu li:last-of-type
+    {
+        padding-bottom: 0.7rem;
+    }
+/* ========================================================================== NavMenu ======================================================================= */
+
+.banner {
+  height: 1rem;
+  padding-right: 2rem;
+  max-height: 1rem;  
+  max-width: 50%;
+  vertical-align: middle;
+
+  @media (max-width: 800px) {
+    flex-basis: 66.666%%;
+    max-width: 25%;
+    margin: 1rem;
+
+  }
+}
+
+
+div.box p { 
+text-indent: 0px; 
+position: absolute;
+display: none;
+}
+
+
+#menubar ul { margin: 0; padding: 0; white-space:nowrap; padding-left: 10px; padding-right: 10px; line-height: 2rem;}
+#menubar li { margin: 0; padding: 0;   }
+#menubar a { margin: 0; padding: 0;}
+#menubar ul {list-style: none; text-align: right;}
+#menubar a {text-decoration: none;}
+#menubar li {margin-left: 0;}
+#menubar {height: 70px; background-color: #132445; /* box-shadow: 0px 2px 3px rgba(0,0,0,.4); */ position: relative; padding-right: 2rem; margin-left: -2rem;  margin-right: -2rem;  color: white; font-size: 1.9rem;}
+
+
+#menubar > ul > li {
+
+    display:inline-block;
+    margin: 0.2rem;
+    position: relative;
+    z-index: 10000;
+    flex-basis: 66.666%%;
+    font-weight: 700;
+
+}
+
+#footer {  
+	/*width: 850px;*/
+	background-color: #ffffff; padding: 1.25em; padding-bottom: 0rem;
+	margin-right: 3rem; margin-left: -2rem; margin-top: 1rem; 
+	color: white}
+
+@media only screen and (max-width: 890px) {
+
+#n4js-mobile-logo { 
+    position: absolute;
+    top: 0;
+    left: 0;
+    width: 178px;
+    height: 60px;
+    background-color: transparent;
+}
+
+div.box p { 
+text-indent: -999px; 
+position: absolute;
+}
+
+  #menubar > ul > li, #menubar {
+    visibility: hidden;
+    display: none;
+  }
+
+}
+
+@media only screen and (max-width: 500px) {
+
+
+
+
+#menubar {
+  display: none;
+}
+
+#logo {
+  margin-top: -55px;
+}
+
+}
+
+#logo {
+  height: 40px;
+  margin-left: 40px;
+  margin-top: 17px;
+  position: relative;
+  overflow: hidden;
+}
+
+#menubar > ul > li::after {
+    content: " · ";
+    position: relative;
+    top: 3px;
+    padding-left: 3px;
+    font-weight: 400;
+}
+
+#menubar > ul > li:last-of-type::after {
+  content: none;
+}
+#menubar > ul > li:last-of-type {
+  padding-right: -1rem;
+}
+
+#menubar > ul > li > a {
+    color: #FFFFFF;
+    font-size:  1.2rem;
+    line-height: 50px; 
+    font-weight: 400;
+    /* padding-top: 2rem; */
+    webkit-transition: color .15s;
+    -moz-transition: color .15s;
+    -o-transition: color .15s;
+    transition: color .15s;
+    white-space:nowrap; 
+    -webkit-font-smoothing: auto;
+    letter-spacing: -.01em;
+    padding-top: 0.2em;
+    padding-left: 0rem;
+    padding-right: 0.1rem;
+}
+
+#menubar > ul {
+    margin-right: 12px;
+    margin-top: 0px;
+}
+
+#menubar > ul > li > a:hover {color: #F7D425; }
+body.home li.home, body.tech li.tech {font-weight:bold; }
+
+#menubar > ul > li > ul {
+    opacity: 0;
+    visibility: hidden;
+    padding: 18px 0 20px 0;
+    background-color: #FFFFFF; /* rgb(15,26,54); top menu color */
+    text-align: left;
+    position: absolute;
+    top: 55px;
+    left: 50%;
+    margin-left: -200px;
+-webkit-transition: all .3s .1s;
+   -moz-transition: all .3s .1s;
+     -o-transition: all .3s .1s;
+        transition: all .3s .1s;
+-webkit-border-radius: 5px;
+   -moz-border-radius: 5px;
+        border-radius: 5px;
+-webkit-box-shadow: 0px 1px 3px rgba(0,0,0,.4);
+   -moz-box-shadow: 0px 1px 3px rgba(0,0,0,.4);
+        box-shadow: 0px 1px 3px rgba(0,0,0,.4);
+}
+
+#menubar > li li {
+    width:100%;
+}
+
+#menubar > ul > li:hover > ul {
+    opacity: 1;
+    top: 65px;
+    visibility: visible;
+}
+
+#menubar > ul > li > ul:before{
+    content: '';
+    display: block;
+    border-color: transparent transparent #FFFFFF transparent;
+    border-style: solid;
+    border-width: 10px;
+    position: absolute;
+    top: -20px;
+    left: 10%;
+    margin-left: -10px;
+}
+
+#menubar > ul ul > li { position: relative;}
+
+#menubar ul ul a{
+    color: rgb(50,50,50);
+    font-family:  sans-serif, Verdana, 'Lucida Grande';
+    font-size: 17px;
+    background-color: #FFFFFF; /* rgb(15,26,54); top menu color */
+    padding: 5px 8px 7px 16px;
+    display: block;
+-webkit-transition: background-color .1s;
+   -moz-transition: background-color .1s;
+     -o-transition: background-color .1s;
+        transition: background-color .1s;
+}
+
+#menubar ul ul a:hover {background-color: #244D82; color: #F7D425;}
+
+#menubar ul ul ul {
+    visibility: hidden;
+    opacity: 0;
+    position: absolute;
+    top: -16px;
+    left: 206px;
+    padding: 16px 0 20px 0;
+    background-color: #527AA3;
+    text-align: left;
+    width: 160px;
+-webkit-transition: all .3s;
+   -moz-transition: all .3s;
+     -o-transition: all .3s;
+        transition: all .3s;
+-webkit-border-radius: 5px;
+   -moz-border-radius: 5px;
+        border-radius: 5px;
+-webkit-box-shadow: 0px 1px 3px rgba(0,0,0,.4);
+   -moz-box-shadow: 0px 1px 3px rgba(0,0,0,.4);
+        box-shadow: 0px 1px 3px rgba(0,0,0,.4);
+}
+
+
+#menubar ul ul > li:hover > ul { opacity: 1; left: 196px; visibility: visible;}
+
+
+#menubar ul ul a:hover{
+    background-color: #244D82;
+    color: #F7D425;
+}
+
+
+.Cell--12-12 {
+    -webkit-flex-basis: 100%;
+    -ms-flex-preferred-size: 100%;
+    flex-basis: 100%;
+    max-width: 100%
+}
+
+.Grid {
+    display: -webkit-flex;
+    display: -ms-flexbox;
+    display: flex;
+    -webkit-align-items: stretch;
+    -ms-flex-align: stretch;
+    align-items: stretch;
+    -webkit-flex-wrap: wrap;
+    -ms-flex-wrap: wrap;
+    flex-wrap: wrap;
+    -webkit-flex: 0 1 auto;
+    -ms-flex: 0 1 auto;
+    flex: 0 1 auto;
+    -webkit-flex-direction: row;
+    -ms-flex-direction: row;
+    flex-direction: row
+}
+
+.Cell,
+.Comparison .Comparison-left,
+.Comparison .Comparison-right,
+.ExampleExplanation .ExampleExplanation-code,
+.ExampleExplanation .ExampleExplanation-text,
+.FeatureTabs .FeatureTabs-stage,
+.Intro .Intro-Slogan {
+    padding-left: 1rem;
+    padding-right: 1rem;
+    -webkit-flex: 0 0 auto;
+    -ms-flex: 0 0 auto;
+    flex: 0 0 auto
+}
+
+#_index, #_feature_table {display: none;}
+
+#_documentation {margin-top: -2rem;}
+
+h3 {padding-top: 1rem}
+
+/* ========================================================================== AsciiSpec ======================================================================= */
+.requirement {
+	border: 1px solid #aaaaaa;
+	padding: 0.5em;
+	margin-bottom: 1rem;
+}
+
+.bibliography .content .paragraph p :first-child::before { 
+	color:#777777;
+	content: "[" attr(id) "] "; }
+
+.bibliography .content .paragraph {
+	padding-left: 6em;
+	text-indent: -6em;
\ No newline at end of file
diff --git a/idespec/styles/prism.min.css b/idespec/styles/prism.min.css
new file mode 100644
index 0000000..92f56d3
--- /dev/null
+++ b/idespec/styles/prism.min.css
@@ -0,0 +1 @@
+code[class*="language-"],pre[class*="language-"]{color:black;background:none;text-shadow:0 1px white;font-family:'Ubuntu Mono', monospace;text-align:left;word-spacing:normal;word-break:normal;word-wrap:normal;line-height:1.5;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-hyphens:none;-moz-hyphens:none;-ms-hyphens:none;hyphens:none}pre[class*="language-"]::-moz-selection,pre[class*="language-"] ::-moz-selection,code[class*="language-"]::-moz-selection,code[class*="language-"] ::-moz-selection{text-shadow:none;background:#b3d4fc}pre[class*="language-"]::selection,pre[class*="language-"] ::selection,code[class*="language-"]::selection,code[class*="language-"] ::selection{text-shadow:none;background:#b3d4fc}@media print{code[class*="language-"],pre[class*="language-"]{text-shadow:none}}pre[class*="language-"]{padding:1em;margin:.5em 0;overflow:auto}:not(pre) > code[class*="language-"],pre[class*="language-"]{background:#f5f2f0}:not(pre) > code[class*="language-"]{padding:.1em;border-radius:.3em;white-space:normal}.token.comment,.token.prolog,.token.doctype,.token.cdata{color:#3f7f5f}.token.punctuation{color:#999}.namespace{opacity:.7}.token.property,.token.tag,.token.boolean,.token.number,.token.constant,.token.symbol,.token.deleted{color:#905}.token.selector,.token.attr-name,.token.string,.token.char,.token.builtin,.token.inserted{color:#690}.token.operator,.token.entity,.token.url,.language-css .token.string,.style .token.string{color:#0086b3}.token.atrule,.token.attr-value,.token.keyword{color:#7f0055}.token.function{color:#2a00ff}.token.regex,.token.important,.token.variable{color:#e90}.token.important,.token.bold{font-weight:bold}.token.italic{font-style:italic}.token.entity{cursor:help}pre[data-line]{position:relative;padding:1em 0 1em 3em}.line-highlight{position:absolute;left:0;right:0;padding:inherit 0;margin-top:1em;background:hsla(24, 20%, 50%,.08);background:linear-gradient(to right, hsla(24, 20%, 50%,.1) 70%, hsla(24, 20%, 50%,0));pointer-events:none;line-height:inherit;white-space:pre}.line-highlight:before,.line-highlight[data-end]:after{content:attr(data-start);position:absolute;top:.4em;left:.6em;min-width:1em;padding:0 .5em;background-color:hsla(24, 20%, 50%,.4);color:hsl(24, 20%, 95%);font:bold 65%/1.5 sans-serif;text-align:center;vertical-align:.3em;border-radius:999px;text-shadow:none;box-shadow:0 1px white}.line-highlight[data-end]:after{content:attr(data-end);top:auto;bottom:.4em}pre.line-numbers{position:relative;padding-left:3.8em;counter-reset:linenumber}pre.line-numbers > code{position:relative}.line-numbers .line-numbers-rows{position:absolute;pointer-events:none;top:0;font-size:100%;left:-3.8em;width:3em;letter-spacing:-1px;border-right:1px solid #999;-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none;user-select:none}.line-numbers-rows > span{pointer-events:none;display:block;counter-increment:linenumber}.line-numbers-rows > span:before{content:counter(linenumber);color:#999;display:block;padding-right:0.8em;text-align:right}.token a{color:inherit}pre.code-toolbar{position:relative}pre.code-toolbar > .toolbar{position:absolute;top:.3em;right:.2em;transition:opacity 0.3s ease-in-out;opacity:0}pre.code-toolbar:hover > .toolbar{opacity:1}pre.code-toolbar > .toolbar .toolbar-item{display:inline-block}pre.code-toolbar > .toolbar a{cursor:pointer}pre.code-toolbar > .toolbar button{background:none;border:0;color:inherit;font:inherit;line-height:normal;overflow:visible;padding:0;-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none}pre.code-toolbar > .toolbar a,pre.code-toolbar > .toolbar button,pre.code-toolbar > .toolbar span{color:#bbb;font-size:.8em;padding:0 .5em;background:#f5f2f0;background:rgba(224, 224, 224, 0.2);box-shadow:0 2px 0 0 rgba(0,0,0,0.2);border-radius:.5em}pre.code-toolbar > .toolbar a:hover,pre.code-toolbar > .toolbar a:focus,pre.code-toolbar > .toolbar button:hover,pre.code-toolbar > .toolbar button:focus,pre.code-toolbar > .toolbar span:hover,pre.code-toolbar > .toolbar span:focus{color:inherit;text-decoration:none}.lang-markup script[type='text/plain'],.language-markup script[type='text/plain'],script[type='text/plain'].lang-markup,script[type='text/plain'].language-markup{display:block;font:100% Consolas, Monaco, monospace;white-space:pre;overflow:auto}.command-line-prompt{border-right:1px solid #999;display:block;float:left;font-size:100%;letter-spacing:-1px;margin-right:1em;pointer-events:none;-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none;user-select:none}.command-line-prompt > span:before{color:#999;content:' ';display:block;padding-right:0.8em}.command-line-prompt > span[data-user]:before{content:"[" attr(data-user) "@" attr(data-host) "] $"}.command-line-prompt > span[data-user="root"]:before{content:"[" attr(data-user) "@" attr(data-host) "] #"}.command-line-prompt > span[data-prompt]:before{content:attr(data-prompt)}.ebnfkeyword{font-weight:bold;color:#800000}.ruleheading{font-weight:bold;color:#000000}.literal{color:#0080ff}.actions{color:#EE7600}.ruleterminal{color:#000000;font-weight:bold}.semi{color:#696969;font-weight:normal}.multilinecomment{color:#228B22}.typereference{font-style:italic}.rulestructure{color:#9932CC}.token.n4jsannotation{color:#FF00FF;font-weight:normal}.punctuation + b{display:none}
\ No newline at end of file
diff --git a/idespec/styles/spec.min.css b/idespec/styles/spec.min.css
new file mode 100644
index 0000000..a5f004a
--- /dev/null
+++ b/idespec/styles/spec.min.css
@@ -0,0 +1 @@
+img,legend{border:0}body,figure{margin:0}body,table{background:#fff}#content:after,#footer:after,#footnotes:after,#header:after,.clearfix:after,.float-group:after,hr{clear:both}#toc,b.button:after,b.button:before,body,kbd,sub,sup{position:relative}#toc a,.vevent abbr,a,div.social>ul li{text-decoration:none}article,aside,details,figcaption,figure,footer,header,hgroup,main,nav,section,summary{display:block}audio,canvas,video{display:inline-block}audio:not([controls]){display:none;height:0}[hidden],template{display:none}script{display:none !important}html{font-family:sans-serif;-ms-text-size-adjust:100%;-webkit-text-size-adjust:100%}a:focus{outline:dotted thin}a:active,a:hover{outline:0}abbr[title]{border-bottom:1px dotted}b,strong{font-weight:700}dfn{font-style:italic}hr{-moz-box-sizing:content-box;box-sizing:content-box}mark{background:#ff0;color:#000}code,kbd,pre,samp{font-family:monospace, serif;font-size:1em}pre{white-space:pre-wrap}q{quotes:"\201C" "\201D" "\2018" "\2019"}sub,sup{font-size:75%;line-height:0;vertical-align:baseline}sup{top:-.5em}sub{bottom:-.25em}svg:not(:root){overflow:hidden}fieldset{border:1px solid silver;margin:0 2px;padding:.35em .625em .75em}legend{padding:0}button,input,select,textarea{font-family:inherit;font-size:100%;margin:0}button,input{line-height:normal}button,select{text-transform:none}button,html input[type=button],input[type=reset],input[type=submit]{-webkit-appearance:button;cursor:pointer}button[disabled],html input[disabled]{cursor:default}input[type=checkbox],input[type=radio]{box-sizing:border-box;padding:0}input[type=search]{-webkit-appearance:textfield;-moz-box-sizing:content-box;-webkit-box-sizing:content-box;box-sizing:content-box}input[type=search]::-webkit-search-cancel-button,input[type=search]::-webkit-search-decoration{-webkit-appearance:none}button::-moz-focus-inner,input::-moz-focus-inner{border:0;padding:0}textarea{overflow:auto;vertical-align:top;height:auto;min-height:50px}meta.foundation-mq-small{font-family:"only screen and (min-width: 500px)";width:500px}meta.foundation-mq-medium{font-family:"only screen and (min-width:1280px)";width:1280px}meta.foundation-mq-large{font-family:"only screen and (min-width:1440px)";width:1440px}.spread,select{width:100%}*,:after,:before{-moz-box-sizing:border-box;-webkit-box-sizing:border-box;box-sizing:border-box}body,html{font-size:100%}body{color:#595959;padding:0;font-family:"Helvetica Neue", Helvetica, Helvetica, Arial, sans-serif;font-weight:400;font-style:normal;line-height:1;cursor:auto max-width: 1280px;tab-size:4}a:hover{cursor:pointer}embed,img,object{max-width:100%;height:auto}embed,object{height:100%}#map_canvas embed,#map_canvas img,#map_canvas object,.map_canvas embed,.map_canvas img,.map_canvas object{max-width:none !important}.left{float:left !important}.right{float:right !important}.text-left{text-align:left !important}.text-right{text-align:right !important}.text-center{text-align:center !important}.text-justify{text-align:justify !important}.hide{display:none}img,object,svg{display:inline-block;vertical-align:middle}.antialiased,body{-webkit-font-smoothing:antialiased}img{-ms-interpolation-mode:bicubic}.center{margin-left:auto;margin-right:auto}#preamble>.sectionbody>.paragraph:first-of-type p,.paragraph.lead>p,p.lead{font-size:1.21875em;line-height:1.6}.admonitionblock td.content>.title,.audioblock>.title,.dlist>.title,.exampleblock>.title,.hdlist>.title,.imageblock>.title,.listingblock>.title,.literalblock>.title,.olist>.title,.openblock>.title,.paragraph>.title,.qlist>.title,.quoteblock>.title,.stemblock>.title,.subheader,.ulist>.title,.verseblock>.title,.videoblock>.title,table.tableblock>.title{line-height:1.4;color:#6f6f6f;font-weight:300;margin-top:.2em;margin-bottom:.5em}#toctitle,.sidebarblock>.content>.title,blockquote,dd,div,dl,dt,form,h1,h2,h3,h4,h5,h6,li,ol,p,pre,td,th,ul{margin:0;padding:0;direction:ltr}a{background:0 0;color:#2ba6cb;line-height:inherit}a:focus,a:hover{color:#2795b6}a img{border:none}p{font-family:inherit;font-weight:400;font-size:1em;line-height:1.6;margin-bottom:1.25em;text-rendering:optimizeLegibility}#toctitle,.admonitionblock>table td.icon .title,.sidebarblock>.content>.title,h1,h2,h3,h4,h5,h6{font-family:"Helvetica Neue", Helvetica, Helvetica, Arial, sans-serif}.vcard .fn,.vevent .summary,.vevent abbr,code,dl dt{font-weight:700}p aside{font-size:.875em;line-height:1.35;font-style:italic}#toctitle,.sidebarblock>.content>.title,h1,h2,h3,h4,h5,h6{font-weight:700;font-style:normal;color:#595959;text-rendering:optimizeLegibility;margin-top:1em;margin-bottom:.5em}dl,dl dd,ol,ul{margin-bottom:1.25em}#toctitle small,.sidebarblock>.content>.title small,h1 small,h2 small,h3 small,h4 small,h5 small,h6 small{font-size:60%;color:#6f6f6f;line-height:0}b,em,i,small,strong{line-height:inherit}h1{font-size:2.125em}h2{font-size:1.6875em}#toctitle,.sidebarblock>.content>.title,h3{font-size:1.375em}h4,h5{font-size:1.125em}h6{font-size:1em}hr{border:solid #ddd;border-width:1px 0 0;margin:1.25em 0 1.1875em;height:0}em,i{font-style:italic}small{font-size:60%}dl,ol,ul,ul li ol,ul li ul{font-size:1em}code{font-family:Consolas, "Liberation Mono", Courier, monospace;color:#7f0a0c}dl,ol,ul{line-height:1.6;list-style-position:outside;font-family:inherit}ol,ol.no-bullet,ul,ul.no-bullet{margin-left:1.5em}ol li ol,ol li ul,ul li ol,ul li ul{margin-left:1.25em;margin-bottom:0}ul.circle li ul,ul.disc li ul,ul.square li ul{list-style:inherit}#menubar ul,ul.inline,ul.inline>li,ul.no-bullet{list-style:none}ul.square{list-style-type:square}ul.circle{list-style-type:circle}ul.disc{list-style-type:disc}dl dt{margin-bottom:.3125em}.vcard,blockquote{margin:0 0 1.25em}abbr,acronym{text-transform:uppercase;font-size:90%;color:#222;border-bottom:1px dotted #ddd;cursor:help}abbr{text-transform:none}blockquote{padding:.5625em 1.25em 0 1.1875em;border-left:1px solid #ddd}blockquote cite{display:block;font-size:.8125em;color:#555}blockquote cite:before{content:"\2014 \0020"}blockquote cite a,blockquote cite a:visited{color:#555}blockquote,blockquote p{line-height:1.6;color:#6f6f6f}.vcard{display:inline-block;border:1px solid #ddd;padding:.625em .75em}.vcard li{margin:0;display:block}.vcard .fn{font-size:.9375em}.vevent abbr{cursor:auto;border:none;padding:0 .0625em}@media only screen and (min-width:500px){#toctitle,.sidebarblock>.content>.title,h1,h2,h3,h4,h5,h6{line-height:1.4}h1{font-size:2.75em}h2{font-size:2.3125em}#toctitle,.sidebarblock>.content>.title,h3{font-size:1.6875em}h4{font-size:1.4375em}}table{border-collapse:collapse;border-spacing:0;margin-bottom:1.25em;border:1px solid #ddd}table tfoot,table thead{background:#f5f5f5;font-weight:600}table tfoot tr td,table tfoot tr th,table thead tr td,table thead tr th{padding:.5em .625em .625em;font-size:inherit;color:#222;text-align:left}table tr td,table tr th{padding:.5625em .625em;font-size:inherit;color:#595959}table tr.alt,table tr.even,table tr:nth-of-type(even){background:#f9f9f9}table tbody tr td,table tfoot tr td,table tfoot tr th,table thead tr th,table tr td{display:table-cell;line-height:1.4}#toctitle,.sidebarblock>.content>.title,h1,h2,h3,h4,h5,h6{line-height:1.4}.clearfix:after,.clearfix:before,.float-group:after,.float-group:before{content:" ";display:table}:not(pre)>code{font-size:inherit;font-style:normal !important;letter-spacing:0;padding:0;line-height:inherit}pre,pre>code{line-height:1.4;color:#000;font-family:monospace, serif;font-weight:400}.keyseq{color:#555}kbd{font-family:Consolas, "Liberation Mono", Courier, monospace;display:inline-block;color:#222;font-size:.65em;line-height:1.45;background-color:#f7f7f7;border:1px solid #ccc;-webkit-border-radius:3px;border-radius:3px;-webkit-box-shadow:0 1px 0 rgba(0, 0, 0, .2), 0 0 0 .1em #fff inset;box-shadow:0 1px 0 rgba(0, 0, 0, .2), 0 0 0 .1em #fff inset;margin:0 .15em;padding:.2em .5em;vertical-align:middle;top:-.1em;white-space:nowrap}table.pyhltable td,td.valign-top,th.valign-top{vertical-align:top}.keyseq kbd:first-child{margin-left:0}.keyseq kbd:last-child{margin-right:0}.menu,.menuseq{color:#090909}b.button:after,b.button:before{top:-1px;font-weight:400}b.button:before{content:"[";padding:0 3px 0 2px}b.button:after{content:"]";padding:0 2px 0 3px}#content,#footer,#footnotes,#header{max-width:1300px;margin-right:80px;margin-top:0;margin-bottom:0;position:relative;padding-left:0;padding-right:.9375em;left:40px}#content:after,#content:before,#footer:after,#footer:before,#footnotes:after,#footnotes:before,#header:after,#header:before{content:" ";display:table}#content{margin-top:1.25em;padding-right:0;margin-right:115px}#content:before{content:none}#header>h1:first-child{color:#595959;margin-top:2.25rem;margin-bottom:0}#header>h1:first-child+#toc{margin-top:8px;border-top:1px solid #ddd}#header>h1:only-child,body.toc2 #header>h1:nth-last-child(2){border-bottom:1px solid #ddd;padding-bottom:8px}#header .details{border-bottom:1px solid #ddd;line-height:1.45;padding-top:.25em;padding-bottom:.25em;padding-left:.25em;color:#555;display:-ms-flexbox;display:-webkit-flex;display:flex;-ms-flex-flow:row wrap;-webkit-flex-flow:row wrap;flex-flow:row wrap}#header .details span:first-child{margin-left:-.125em}#header .details span.email a{color:#6f6f6f}#header .details br{display:none}#header .details br+span:before{content:"\00a0\2013\00a0"}#header .details br+span.author:before{content:"\00a0\22c5\00a0";color:#6f6f6f}#header .details br+span#revremark:before{content:"\00a0|\00a0"}#header #revnumber{text-transform:capitalize}#header #revnumber:after{content:"\00a0"}#content>h1:first-child:not([class]){color:#000;border-bottom:1px solid #ddd;padding-bottom:8px;margin-top:0;padding-top:1rem;margin-bottom:1.25rem}#toc ul li:before,div#faq li:before,div#features-nav li:before,div.ulist li:before{content:"";color:#244d82}#toc{border-bottom:1px solid #ddd;padding-bottom:.5em;left:0}#toc li{line-height:1.3334;margin-top:0;padding-left:5px}#toc ul li:before{margin-left:-.75em;margin-right:.4em}div.ulist li:before{position:absolute;font-size:x-large;line-height:1rem;margin:.2rem 0 -.75em -.75em}#faq,#features-nav{margin-bottom:20px;z-index:1;padding-left:2rem;border-left:1px solid #d3d3d3}#toctitle{color:#595959;font-size:1.2em;padding-left:1em}#faq{position:relative;right:9.3rem;top:9rem;left:45rem}@media only screen and (max-width:945px){div#faq{display:none}}#faq h2{font-size:25px;font-weight:600;margin-top:-8rem}div#faq li:before,div#features-nav li:before{position:absolute;font-size:x-large;margin-left:-.75em;margin-bottom:-.75em;margin-right:0;line-height:1rem}#features-nav{right:1rem;top:2rem;position:absolute}@media only screen and (max-width:993px){#features-nav{display:none}}#features-nav h2{font-size:25px;font-weight:600;margin-top:-1rem}#features-nav li{margin-top:.3rem}@media only screen and (min-width:500px){#toctitle{padding-top:0;font-size:1.375em}body.toc2{padding-left:2em;padding-right:1em}#toc.toc2{margin-top:0 !important;background-color:#f2f2f2;position:fixed;width:260px;left:0;top:0;border-right:1px solid #ddd;border-top-width:0 !important;border-bottom-width:0 !important;z-index:1000;padding:1.25em .25em 0;height:100%;overflow:auto}#toc.toc2 #toctitle{margin-top:0;margin-bottom:.8rem;font-size:1.2em;padding-left:1em}#toc.toc2>ul{font-size:.9em;margin-bottom:0}#toc.toc2 ul ul{margin-left:6px}#toc.toc2 ul.sectlevel0 ul.sectlevel1{padding-left:10px;margin-top:.5em;margin-bottom:.5em}body.toc2.toc-right{padding-left:2em;padding-right:2em}body.toc2.toc-right #toc.toc2{border-right-width:0;border-left:1px solid #ddd;left:auto;right:-260px}}body.toc2.toc-left #toc.toc2{left:0}@media only screen and (min-width:1000px){#toc.toc2 #toctitle,#toctitle{font-size:1.375em}#content{max-width:1260px}body.toc2{padding-left:260px;padding-right:2em}#toctitle{padding-top:0}#toc.toc2{width:260px}#toc.toc2>ul{font-size:.95em}#toc.toc2 ul ul{padding-left:0}body.toc2.toc-right{padding-left:2em;padding-right:2em}}#content #toc{border-style:solid;border-width:1px;border-color:#d9d9d9;margin-bottom:1.25em;padding:1.25em;background:#f2f2f2;-webkit-border-radius:0;border-radius:0}#content #toc>:first-child{margin-top:0}#footer,div.social{margin-top:2rem;color:#fff}#content #toc>:last-child{margin-bottom:0}#footer{padding:1.25em 1.25em 0}div.social{padding:1.25em 1.25em 0 30px}.exampleblock>.content>:first-child,.sidebarblock>:first-child{margin-top:0}div.social>ul li{color:#fff;line-height:1.44;font-size:1.2em;font-weight:800;font-style:bold;position:relative;list-style:none;display:inline}#bottomright{float:right}#footer-text{color:#ddd;line-height:1.44}.sect1{padding-bottom:.625em}@media only screen and (min-width:500px){.sect1{padding-bottom:1.25em}}.sect1+.sect1{border-top:1px solid #ddd}#content h1>a.anchor,#toctitle>a.anchor,.sidebarblock>.content>.title>a.anchor,h2>a.anchor,h3>a.anchor,h4>a.anchor,h5>a.anchor,h6>a.anchor{position:absolute;z-index:1001;width:1.5ex;margin-left:-1.5ex;display:block;text-decoration:none !important;visibility:hidden;text-align:center;font-weight:400}a.image,sup.footnote a,sup.footnoteref a{text-decoration:none}#content h1>a.anchor:before,#toctitle>a.anchor:before,.sidebarblock>.content>.title>a.anchor:before,h2>a.anchor:before,h3>a.anchor:before,h4>a.anchor:before,h5>a.anchor:before,h6>a.anchor:before{content:"\00A7";font-size:.85em;display:block;padding-top:.1em}#content h1:hover>a.anchor,#content h1>a.anchor:hover,#toctitle:hover>a.anchor,#toctitle>a.anchor:hover,.sidebarblock>.content>.title:hover>a.anchor,.sidebarblock>.content>.title>a.anchor:hover,h2:hover>a.anchor,h2>a.anchor:hover,h3:hover>a.anchor,h3>a.anchor:hover,h4:hover>a.anchor,h4>a.anchor:hover,h5:hover>a.anchor,h5>a.anchor:hover,h6:hover>a.anchor,h6>a.anchor:hover{visibility:visible}#content h1>a.link,#toctitle>a.link,.sidebarblock>.content>.title>a.link,h2>a.link,h3>a.link,h4>a.link,h5>a.link,h6>a.link{color:#595959;text-decoration:none}#content h1>a.link:hover,#toctitle>a.link:hover,.sidebarblock>.content>.title>a.link:hover,h2>a.link:hover,h3>a.link:hover,h4>a.link:hover,h5>a.link:hover,h6>a.link:hover{color:#151515}.audioblock,.imageblock,.listingblock,.literalblock,.stemblock,.videoblock{margin-bottom:1.25em}.admonitionblock td.content>.title,.audioblock>.title,.dlist>.title,.exampleblock>.title,.hdlist>.title,.imageblock>.title,.listingblock>.title,.literalblock>.title,.olist>.title,.openblock>.title,.paragraph>.title,.qlist>.title,.quoteblock>.title,.stemblock>.title,.ulist>.title,.verseblock>.title,.videoblock>.title,table.tableblock>.title{text-rendering:optimizeLegibility;text-align:left}table.tableblock>caption.title{white-space:nowrap;overflow:visible;max-width:0}#preamble>.sectionbody>.paragraph:first-of-type p,.paragraph.lead>p{color:#000}table.tableblock #preamble>.sectionbody>.paragraph:first-of-type p{font-size:inherit}.admonitionblock>table{border-collapse:separate;border:0;background:0 0;width:100%}.admonitionblock>table td.icon{text-align:center;width:80px}.admonitionblock>table td.icon img{max-width:none}.admonitionblock>table td.icon .title{font-weight:700;text-transform:uppercase}.admonitionblock>table td.content{padding-left:1.125em;padding-right:1.25em;border-left:1px solid #ddd;color:#555}.admonitionblock>table td.content>:last-child>:last-child{margin-bottom:0}.exampleblock>.content{border-style:solid;border-width:1px;border-color:#e6e6e6;margin-bottom:1.25em;padding:1.25em;background:#fff;-webkit-border-radius:0;border-radius:0}.exampleblock>.content .olist>ol>li:last-child>:last-child,.exampleblock>.content .qlist>ol>li:last-child>:last-child,.exampleblock>.content .ulist>ul>li:last-child>:last-child,.exampleblock>.content>:last-child,.exampleblock>.content>:last-child>:last-child,.sidebarblock>.content .olist>ol>li:last-child>:last-child,.sidebarblock>.content .qlist>ol>li:last-child>:last-child,.sidebarblock>.content .ulist>ul>li:last-child>:last-child,.sidebarblock>.content>:last-child>:last-child,.sidebarblock>:last-child,table.pyhltable{margin-bottom:0}.sidebarblock{position:absolute;border-style:solid;width:90px;border-width:1px;border-color:#d9d9d9;right:-90px;padding:.1rem;background:#f2f2f2;-webkit-border-radius:0;text-align:left;border-radius:5px}.sidebarblock>.content>.title{color:#6999d6;margin-top:0}.listingblock pre.CodeRay,.listingblock pre.prettyprint,.listingblock pre:not(.highlight),.listingblock pre[class=highlight],.listingblock pre[class^="highlight "],.literalblock pre{background:#eee}.sidebarblock .listingblock pre.CodeRay,.sidebarblock .listingblock pre.prettyprint,.sidebarblock .listingblock pre:not(.highlight),.sidebarblock .listingblock pre[class=highlight],.sidebarblock .listingblock pre[class^="highlight "],.sidebarblock .literalblock pre{background:#f2f1f1}.listingblock pre,.listingblock pre[class],.literalblock pre,.literalblock pre[class]{border:1px solid #ccc;-webkit-border-radius:0;border-radius:0;word-wrap:break-word;padding:.8em .8em .65em;font-size:.8125em}.listingblock pre.nowrap,.listingblock pre[class].nowrap,.literalblock pre.nowrap,.literalblock pre[class].nowrap{overflow-x:auto;white-space:pre;word-wrap:normal}#logo,ul.inline{overflow:hidden}@media only screen and (min-width:500px){.listingblock pre,.listingblock pre[class],.literalblock pre,.literalblock pre[class]{font-size:.90625em}}@media only screen and (min-width:1280px){.listingblock pre,.listingblock pre[class],.literalblock pre,.literalblock pre[class]{font-size:1em}}.literalblock.output pre{color:#eee;background-color:#000}.listingblock pre.highlightjs{padding:0}.listingblock pre.highlightjs>code{padding:.8em .8em .65em;-webkit-border-radius:0;border-radius:0}.listingblock>.content{position:relative}.listingblock.terminal pre .command:before{content:attr(data-prompt);padding-right:.5em;color:#999}.listingblock.terminal pre .command:not([data-prompt]):before{content:"$"}table.pyhltable{border-collapse:separate;border:0;background:0 0}table.pyhltable td{padding-top:0;padding-bottom:0;line-height:1.4}table.pyhltable td.code{padding-left:.75em;padding-right:0}pre.pygments .lineno,table.pyhltable td:not(.code){color:#999;padding-left:0;padding-right:.5em;border-right:1px solid #ddd}pre.pygments .lineno{display:inline-block;margin-right:.25em}table.pyhltable .linenodiv{background:0 0 !important;padding-right:0 !important}.quoteblock{margin:0 1em 1.25em 1.5em;display:table}.quoteblock .attribution br,.quoteblock .quoteblock blockquote:before,.verseblock .attribution br{display:none}.quoteblock>.title{margin-left:-1.5em;margin-bottom:.75em}.quoteblock blockquote,.quoteblock blockquote p{color:#6f6f6f;font-size:1.15rem;line-height:1.75;word-spacing:.1em;letter-spacing:0;font-style:italic;text-align:justify}.quoteblock blockquote{margin:0;padding:0;border:0}.quoteblock blockquote:before{content:"\201c";float:left;font-size:2.75em;font-weight:700;line-height:.6em;margin-left:-.6em;color:#6f6f6f;text-shadow:0 1px 2px rgba(0, 0, 0, .1)}.quoteblock blockquote>.paragraph:last-child p{margin-bottom:0}.quoteblock .attribution{margin-top:.5em;margin-right:.5ex;text-align:right}.quoteblock .quoteblock{margin-left:0;margin-right:0;padding:.5em 0;border-left:3px solid #555}.quoteblock .quoteblock blockquote{padding:0 0 0 .75em}.verseblock{margin:0 1em 1.25em}.verseblock pre{font-family:"Open Sans", "DejaVu Sans", sans;font-size:1.15rem;color:#6f6f6f;font-weight:300;text-rendering:optimizeLegibility}.verseblock pre strong{font-weight:400}.verseblock .attribution{margin-top:1.25rem;margin-left:.5ex}.quoteblock .attribution,.verseblock .attribution{font-size:.8125em;line-height:1.45;font-style:italic}.quoteblock .attribution cite,.verseblock .attribution cite{display:block;letter-spacing:-.025em;color:#555}.quoteblock.abstract{margin:0 0 1.25em;display:block}dl dd:last-child,dl dd:last-child>:last-child,table.tableblock td>.paragraph:last-child p>p:last-child,table.tableblock td>p:last-child,table.tableblock th>p:last-child{margin-bottom:0}.quoteblock.abstract blockquote,.quoteblock.abstract blockquote p{text-align:left;word-spacing:0}.quoteblock.abstract blockquote p:first-of-type:before,.quoteblock.abstract blockquote:before{display:none}table.tableblock{max-width:100%;border-collapse:separate}table.tableblock,td.tableblock,th.tableblock{border:0 solid #ddd}table.grid-all td.tableblock,table.grid-all th.tableblock{border-width:0 1px 1px 0}table.grid-all tfoot>tr>td.tableblock,table.grid-all tfoot>tr>th.tableblock{border-width:1px 1px 0 0}table.grid-cols td.tableblock,table.grid-cols th.tableblock{border-width:0 1px 0 0}table.grid-all *>tr>.tableblock:last-child,table.grid-cols *>tr>.tableblock:last-child{border-right-width:0}table.grid-rows td.tableblock,table.grid-rows th.tableblock{border-width:0 0 1px}table.grid-all tbody>tr:last-child>td.tableblock,table.grid-all tbody>tr:last-child>th.tableblock,table.grid-all thead:last-child>tr>th.tableblock,table.grid-rows tbody>tr:last-child>td.tableblock,table.grid-rows tbody>tr:last-child>th.tableblock,table.grid-rows thead:last-child>tr>th.tableblock{border-bottom-width:0}table.grid-rows tfoot>tr>td.tableblock,table.grid-rows tfoot>tr>th.tableblock{border-width:1px 0 0}table.frame-all{border-width:1px}table.frame-sides{border-width:0 1px}table.frame-topbot{border-width:1px 0}td.halign-left,th.halign-left{text-align:left}td.halign-right,th.halign-right{text-align:right}td.halign-center,th.halign-center{text-align:center}td.valign-bottom,th.valign-bottom{vertical-align:bottom}td.valign-middle,th.valign-middle{vertical-align:middle}table tfoot th,table thead th{font-weight:700}tbody tr th{display:table-cell;line-height:1.4;background:#f5f5f5}ul.inline>li,ul.inline>li>*{display:block}tbody tr th,tbody tr th p,tfoot tr th,tfoot tr th p{color:#222;font-weight:700}p.tableblock>code:only-child{background:0 0;padding:0}p.tableblock{font-size:1em}td>div.verse{white-space:pre}ol{margin-left:1.75em}ul li ol{margin-left:1.5em}dl dd{margin-left:1.125em}.olist .olist,.olist .ulist,.ulist .olist,.ulist .ulist,ol dd,ol>li p,ul dd,ul>li p{margin-bottom:.625em}ol.unnumbered,ul.checklist,ul.none,ul.unstyled{list-style-type:none}ol.unnumbered,ul.checklist,ul.unstyled{margin-left:.625em}ul.checklist li>p:first-child>.fa-check-square-o:first-child,ul.checklist li>p:first-child>.fa-square-o:first-child{width:1em;font-size:.85em}ul.checklist li>p:first-child>input[type=checkbox]:first-child{width:1em;position:relative;top:1px}ul.inline{margin:0 0 .625em -1.375em;padding:0}ul.inline>li{float:left;margin-left:1.375em}.conum[data-value],.th,.thumb,a.image{display:inline-block}.unstyled dl dt{font-weight:400;font-style:normal}ol.arabic{list-style-type:decimal}ol.decimal{list-style-type:decimal-leading-zero}ol.loweralpha{list-style-type:lower-alpha}ol.upperalpha{list-style-type:upper-alpha}ol.lowerroman{list-style-type:lower-roman}ol.upperroman{list-style-type:upper-roman}ol.lowergreek{list-style-type:lower-greek}.colist>table,.hdlist>table{border:0;background:0 0}.colist>table>tbody>tr,.hdlist>table>tbody>tr{background:0 0}td.hdlist1,td.hdlist2{vertical-align:top;padding:0 .625em}td.hdlist1{font-weight:700;padding-bottom:1.25em}.listingblock+.colist,.literalblock+.colist{margin-top:-.5em}.colist>table tr>td:first-of-type{padding:0 .75em;line-height:1}.colist>table tr>td:last-of-type{padding:.25em 0}.th,.thumb{line-height:0;border:4px solid #fff;-webkit-box-shadow:0 0 0 1px #ddd;box-shadow:0 0 0 1px #ddd}.imageblock.left,.imageblock[style*="float: left"]{margin:.25em .625em 1.25em 0}.imageblock.right,.imageblock[style*="float: right"]{margin:.25em 0 1.25em .625em}.imageblock>.title{margin-bottom:0}.imageblock.th,.imageblock.thumb{border-width:6px}.imageblock.th>.title,.imageblock.thumb>.title{padding:0 .125em}.image.left,.image.right{margin-top:.25em;margin-bottom:.25em;display:inline-block;line-height:0}.image.left{margin-right:.625em}.image.right{margin-left:.625em}a.image object{pointer-events:none}sup.footnote,sup.footnoteref{font-size:.875em;position:static;vertical-align:super}#logo,#menubar,#menubar>ul>li,#menubar>ul>li::after{position:relative}sup.footnote a:active,sup.footnoteref a:active{text-decoration:underline}#footnotes{padding-top:.75em;padding-bottom:.75em;margin-bottom:.625em}#footnotes hr{width:20%;min-width:6.25em;margin:-.25em 0 .75em;border-width:1px 0 0}#footnotes .footnote{padding:0 .375em .2em .225em;line-height:1.3334;font-size:.875em;margin-left:1.2em;text-indent:-1.05em;margin-bottom:.2em}#footnotes .footnote a:first-of-type{font-weight:700;text-decoration:none}#footnotes .footnote:last-of-type{margin-bottom:0}#content #footnotes{margin-top:-.625em;margin-bottom:0;padding:.75em 0}.gist .file-data>table{border:0;background:#fff;width:100%;margin-bottom:0}.gist .file-data>table td.line-data{width:99%}div.unbreakable{page-break-inside:avoid}.big{font-size:larger}.small{font-size:smaller}.x-small{font-size:x-small}.xx-small{font-size:xx-small}.x-large{font-size:x-large}.xx-large{font-size:xx-large}.underline{text-decoration:underline}.overline{text-decoration:overline}.line-through{text-decoration:line-through}.aqua{color:#00bfbf}.aqua-background{background-color:#00fafa}.black{color:#000}.black-background{background-color:#000}.blue{color:#0000bf}.blue-background{background-color:#0000fa}.fuchsia{color:#bf00bf}.fuchsia-background{background-color:#fa00fa}.gray{color:#606060}.gray-background{background-color:#7d7d7d}.green{color:#006000}.green-background{background-color:#007d00}.lime{color:#00bf00}.lime-background{background-color:#00fa00}.maroon{color:#600000}.maroon-background{background-color:#7d0000}.navy{color:#000060}.navy-background{background-color:#00007d}.olive{color:#606000}.olive-background{background-color:#7d7d00}.purple{color:#600060}.purple-background{background-color:#7d007d}.red{color:#bf0000}.red-background{background-color:#fa0000}.silver{color:#909090}.silver-background{background-color:#bcbcbc}.teal{color:#006060}.teal-background{background-color:#007d7d}.white{color:#bfbfbf}.white-background{background-color:#fafafa}.yellow{color:#bfbf00}.yellow-background{background-color:#fafa00}span.icon>.fa{cursor:default}.admonitionblock td.icon [class^="fa icon-"]{font-size:2.5em;text-shadow:1px 1px 2px rgba(0, 0, 0, .5);cursor:default}#clear,.treeview>li:hover{cursor:pointer}.admonitionblock td.icon .icon-note:before{content:"\f05a";color:#207c98}.admonitionblock td.icon .icon-tip:before{content:"\f0eb";text-shadow:1px 1px 2px rgba(155, 155, 0, .8);color:#111}.admonitionblock td.icon .icon-warning:before{content:"\f071";color:#bf6900}.admonitionblock td.icon .icon-caution:before{content:"\f06d";color:#bf3400}.admonitionblock td.icon .icon-important:before{content:"\f06a";color:#bf0000}.conum[data-value],.conum[data-value] *{color:#fff !important}.conum[data-value]{background-color:#222;-webkit-border-radius:100px;border-radius:100px;text-align:center;font-size:.75em;width:1.67em;height:1.67em;line-height:1.67em;font-family:"Open Sans", "DejaVu Sans", sans-serif;font-style:normal;font-weight:700}#menu,.conum:not([data-value]):empty,.conum[data-value]+b{display:none}.conum[data-value]:after{content:attr(data-value)}pre .conum[data-value]{position:relative;top:-.125em}b.conum *{color:inherit !important}.listingblock pre,.literalblock pre{background:#eee}div#remarks.ulist{max-width:70%}@media only screen and (max-width:800px){a#bottomright{visibility:hidden}#preamble>.sectionbody>.paragraph:first-of-type p,.paragraph.lead>p,.sectionbody.paragraph{max-width:100%}}#div.paragraph.faq-intro{max-width:66.66%}div.slicknav_menu{padding-top:5px;padding-right:15px;margin-left:200px;text-align:right;display:none;right:10px;font-size:1rem;color:#fff;padding-bottom:2rem;background:url(logo.png) 100px 0 no-repeat}span.slicknav_menutxt{margin-right:-20px;color:#fff}div.slicknav_menu a.scroll:first-of-type{color:#F7D425;font-size:120%;font-weight:600}div.slicknav_menu ul li a{color:#fff}div.slicknav_menu a:hover,div.slicknav_menu ul li a:hover{color:#F7D425}div.slicknav_menu a,div.slicknav_menu a:visited,li.slicknav_parent.slicknav_open{color:#fff}a.slicknav_btn{padding:1rem}@media screen and (max-width:890px){div.slicknav_menu{display:block;color:#fff}#mobile-banner{display:block}}@media screen and (max-width:470px){div.slicknav_menu ul:first-of-type{margin-top:1.5rem}div.slicknav_menu ul li{color:#fff}div.slicknav_menu ul li:hover{color:#F7D425}}div.slicknav_menu li:last-of-type{padding-bottom:.7rem}.banner{height:1rem;padding-right:2rem;max-height:1rem;max-width:50%;vertical-align:middle}@media (max-width:800px){.banner{flex-basis:66.66%;max-width:25%;margin:1rem}}#menubar ul{margin:0;padding:0 10px;white-space:nowrap;line-height:1.2rem}#menubar a,#menubar li{margin:0;padding:0}#menubar a{text-decoration:none}#menubar li{margin-left:0}#menubar{height:90px;max-width:1280px;margin-left:50px;color:#fff;font-size:1.9rem;border-bottom:#595959;border-bottom:2px solid #ddd}#menubar img{padding-left:45px;margin-top:15px;padding-top:.2rem}#menubar>ul>li{display:inline-block;margin:.2rem;z-index:10000;flex-basis:66.666%;font-weight:700}@media only screen and (max-width:500px){#menubar,#menubar>ul>li{visibility:hidden;display:none}#toc.toc2{display:none}}@media only screen and (max-width:500px){body.toc2.toc-right #tocbutton{visibility:hidden}#content,#footer,#footnotes,#header{margin-left:0;left:0}body.toc2{padding-left:20px;left:0}}@media only screen and (max-width:500px){#menubar{display:none}}#logo{margin-top:-55px;left:5px;top:10px}#menubar>ul>li::after{content:" · ";top:3px;padding-left:3px;font-weight:400}#menubar>ul>li:last-of-type::after{content:none}#menubar>ul>li>a{font-size:1.2rem;line-height:50px;font-weight:400;webkit-transition:color .15s;margin-left:0;-moz-transition:color .15s;-o-transition:color .15s;transition:color .15s;white-space:nowrap;-webkit-font-smoothing:auto;letter-spacing:-.01em;text-align:right}#iconTree li,#toc>ul>li>a,body.home li.home,body.tech li.tech{font-weight:700}#menubar>ul{margin-right:12px;margin-top:1px}#menubar>ul>li>a:hover{color:#F7D425}#menubar>ul>li>ul{opacity:0;visibility:hidden;padding:18px 0 20px;background-color:#FFF;text-align:left;position:absolute;top:55px;left:50%;margin-left:-90px;-webkit-transition:all .3s .1s;-moz-transition:all .3s .1s;-o-transition:all .3s .1s;transition:all .3s .1s;-webkit-border-radius:5px;-moz-border-radius:5px;border-radius:5px;-webkit-box-shadow:0 1px 3px rgba(0, 0, 0, .4);-moz-box-shadow:0 1px 3px rgba(0, 0, 0, .4);box-shadow:0 1px 3px rgba(0, 0, 0, .4)}#menubar>li li{width:100%}#menubar>ul>li:hover>ul{opacity:1;top:65px;visibility:visible}#menubar>ul>li>ul:before{content:'';display:block;border-color:transparent transparent #FFF;border-style:solid;border-width:10px;position:absolute;top:-20px;left:10%;margin-left:-10px}#menubar>ul ul>li{position:relative}#menubar ul ul a{color:#323232;font-family:ITC Officina Serif W01, sans-serif, Verdana, 'Lucida Grande';font-size:17px;background-color:#FFF;padding:5px 8px 7px 16px;display:block;-webkit-transition:background-color .1s;-moz-transition:background-color .1s;-o-transition:background-color .1s;transition:background-color .1s}#menubar ul ul ul{visibility:hidden;opacity:0;position:absolute;top:-16px;left:206px;padding:16px 0 20px;background-color:#527AA3;text-align:left;width:160px;-webkit-transition:all .3s;-moz-transition:all .3s;-o-transition:all .3s;transition:all .3s;-webkit-border-radius:5px;-moz-border-radius:5px;border-radius:5px;-webkit-box-shadow:0 1px 3px rgba(0, 0, 0, .4);-moz-box-shadow:0 1px 3px rgba(0, 0, 0, .4);box-shadow:0 1px 3px rgba(0, 0, 0, .4)}a.back-to-top,body.toc2.toc-right a.back-to-top{width:25px;height:25px;text-indent:-9999px;position:fixed;bottom:20px}#menubar ul ul>li:hover>ul{opacity:1;left:196px;visibility:visible}#menubar ul ul a:hover{background-color:#244D82;color:#F7D425}a.back-to-top{display:none;z-index:999;right:20px;background:url(../images/up-arrow.png) center 43% no-repeat #2ba6cb;-webkit-border-radius:30px;-moz-border-radius:30px;border-radius:30px}a:hover.back-to-top{background-color:#F7D425}#tocbutton{visibility:hidden}#tocbuttonbars.fa.fa-bars{z-index:1000;right:0}#tocbutton:hover{background:url(yellowbars.png) center 50% no-repeat}body.toc2.toc-right a.back-to-top{z-index:1001;right:90px;background:url(../images/up-arrow.png) center 43% no-repeat #2ba6cb;-webkit-border-radius:30px;-moz-border-radius:30px;border-radius:30px}body.toc2.toc-left #tocbutton,body.toc2.toc-right #tocbutton{visibility:visible;width:25px;text-indent:-9999px;border:none;height:25px;position:fixed;z-index:998}body.toc2.toc-right #tocbutton{right:25px;top:5px;background:url(yellowbars.png) center 50% no-repeat}body.toc2.toc-left #tocbutton{left:25px;top:25px;background:url(bars-blue.png) center 50% no-repeat}body.toc2.toc-right #tocbutton:hover{background:url(yellowbars.png) center 50% no-repeat}#pagesearch,.treeview li{background-repeat:no-repeat}body.toc2.toc-right a:hover.back-to-top{background-color:#F7D425}@media only screen and (max-width:1000px){#toc.toc2{display:none}}@media only screen and (max-width:500px){body.toc2.toc-left #tocbutton{visibility:hidden}#toc.toc2{width:100%;left:0}#content,#footer,#footnotes,#header{margin-left:0;margin-right:50px}}@media only screen and (max-width:1462px){a.back-to-top{left:90%}}div.openblock.definition{border:1px solid #aaa;margin-bottom:1rem;background-color:#f0f8ff;border-radius:10px;padding:1rem}.requirement{border:1px solid #aaa;margin-bottom:1rem;background-color:#f5f5f5;border-radius:10px;padding:1rem}.bibliography .content .paragraph p:first-child::before{color:#777;content:"[" attr(id) "] "}.bibliography .content .paragraph{padding-left:6em;text-indent:-6em}.hold,.todo{padding:12px;margin-bottom:15px}.todo{color:#dc143c;border:dotted #dc143c;border-width:2px;border-radius:15px;background-color:#fff8dc}.todo::before{content:"TODO"}.hold{color:#ff8c00;border:dotted #ff8c00;border-width:2px;border-radius:15px;background-color:#f5f5f5}.hold::before{content:"ON HOLD"}#toc>ul>li>a{color:#595959;font-size:medium}#toc a:hover,.active,.found{color:#000}#iconTree li,#toclist>li>ul>li{font-size:90%}.treeview,.treeview ul{list-style-type:none;overflow:hidden}.treeview li{text-indent:10%;margin-top:0;padding:.2em 0 0;line-height:20px;background-size:16px 16px;background-position-y:4px}#iconTree li{line-height:15px;background-size:16px 16px}.treeview li.contains-items{font-weight:700;background-image:url(../images/expand.png);background-size:16px 16px}.treeview li.items-expanded{font-weight:400;background-image:url(../images/collapse.png);background-size:16px 16px}.active,.found,.items-expanded>a::first-of-type{font-weight:700}.treview-dotted-lines li{margin-top:.4em !important}.treview-dotted-lines li.items-expanded li{font-weight:700;border-left:1px dotted #444;border-bottom:1px dotted #444;width:60%}.treeview span.has-node-icon{text-indent:2%;margin-top:.2em;padding:.15em 0 .5em 1em;line-height:22px;background-repeat:no-repeat;background-size:24px 24px}.treeview span{padding:5px}.treeview span:not(.has-node-icon):hover{background-color:rgba(246, 246, 246, .7)}#collapsetoc{outline:0;display:none;width:25px;height:25px;text-indent:-9999px;position:fixed;z-index:998;border:none;left:25px;top:55px;background:url(../images/arrow-down.png) center 50% no-repeat}#collapsetoc.inactive{background-image:url(../images/arrow-right.png)}.active{border-right:3px solid #2ba6cb}#toc{margin-top:0}#toc>ul{margin-left:0;padding-left:0}#toc ul.sectlevel0>li>a{font-style:italic}#toc ul.sectlevel0 ul.sectlevel1{margin:0}#toc ul{font-family:"Helvetica Neue", Helvetica, Helvetica, Arial, sans-serif;list-style-type:none}#toc a{color:#595959}#toc a:active{text-decoration:underline}#pagesearch{background-image:url(../images/searchicon.png);background-position:5px 5px;width:100%;font-size:16px;padding:6px 10px 6px 40px;border:1px solid #ddd;margin-bottom:12px}#clear{position:absolute;right:10px;top:72px;bottom:0;height:14px;font-size:14px;color:#ccc}
\ No newline at end of file
diff --git a/idespec/styles/styles.min.css b/idespec/styles/styles.min.css
new file mode 100644
index 0000000..8cc9d44
--- /dev/null
+++ b/idespec/styles/styles.min.css
@@ -0,0 +1 @@
+@charset "UTF-8";*,:after,:before{position:relative;margin:0;padding:0;box-sizing:inherit}button,input,select,textarea{font:inherit;-webkit-appearance:none;-moz-appearance:none;appearance:none}input[type=checkbox]{-webkit-appearance:checkbox;-moz-appearance:checkbox;appearance:checkbox}input[type=radio]{-webkit-appearance:radio;-moz-appearance:radio;appearance:radio}table{border-collapse:collapse}html{box-sizing:border-box;font-size:10px}.Comparison,.ExampleExplanation,.FeatureTable,.Grid{display:-webkit-flex;display:-ms-flexbox;display:flex;-webkit-align-items:stretch;-ms-flex-align:stretch;align-items:stretch;-webkit-flex-wrap:wrap;-ms-flex-wrap:wrap;flex-wrap:wrap;-webkit-flex:0 1 auto;-ms-flex:0 1 auto;flex:0 1 auto;-webkit-flex-direction:row;-ms-flex-direction:row;flex-direction:row}.Comparison,.ExampleExplanation,.Grid--fullWidth{margin-left:-2rem;margin-right:-2rem}.Comparison .Cell:first-child,.Comparison .Comparison-left:first-child,.Comparison .Comparison-right:first-child,.Comparison .FeatureTabs .FeatureTabs-stage:first-child,.Comparison .Intro .Intro-Slogan:first-child,.ExampleExplanation .Cell:first-child,.ExampleExplanation .ExampleExplanation-code:first-child,.ExampleExplanation .ExampleExplanation-text:first-child,.ExampleExplanation .FeatureTabs .FeatureTabs-stage:first-child,.ExampleExplanation .Intro .Intro-Slogan:first-child,.FeatureTabs .Comparison .FeatureTabs-stage:first-child,.FeatureTabs .ExampleExplanation .FeatureTabs-stage:first-child,.FeatureTabs .Grid--fullWidth .FeatureTabs-stage:first-child,.Grid--fullWidth .Cell:first-child,.Grid--fullWidth .FeatureTabs .FeatureTabs-stage:first-child,.Grid--fullWidth .Intro .Intro-Slogan:first-child,.Intro .Comparison .Intro-Slogan:first-child,.Intro .ExampleExplanation .Intro-Slogan:first-child,.Intro .Grid--fullWidth .Intro-Slogan:first-child{padding-left:4rem}.Comparison .Cell:last-child,.Comparison .Comparison-left:last-child,.Comparison .Comparison-right:last-child,.Comparison .FeatureTabs .FeatureTabs-stage:last-child,.Comparison .Intro .Intro-Slogan:last-child,.ExampleExplanation .Cell:last-child,.ExampleExplanation .ExampleExplanation-code:last-child,.ExampleExplanation .ExampleExplanation-text:last-child,.ExampleExplanation .FeatureTabs .FeatureTabs-stage:last-child,.ExampleExplanation .Intro .Intro-Slogan:last-child,.FeatureTabs .Comparison .FeatureTabs-stage:last-child,.FeatureTabs .ExampleExplanation .FeatureTabs-stage:last-child,.FeatureTabs .Grid--fullWidth .FeatureTabs-stage:last-child,.Grid--fullWidth .Cell:last-child,.Grid--fullWidth .FeatureTabs .FeatureTabs-stage:last-child,.Grid--fullWidth .Intro .Intro-Slogan:last-child,.Intro .Comparison .Intro-Slogan:last-child,.Intro .ExampleExplanation .Intro-Slogan:last-child,.Intro .Grid--fullWidth .Intro-Slogan:last-child{padding-right:4rem}@media (max-width:800px){.Comparison,.ExampleExplanation,.Grid--fullWidth{margin-left:-.75rem;margin-right:-.75rem}.Comparison .Cell:first-child,.Comparison .Cell:last-child,.Comparison .Comparison-left:first-child,.Comparison .Comparison-left:last-child,.Comparison .Comparison-right:first-child,.Comparison .Comparison-right:last-child,.Comparison .FeatureTabs .FeatureTabs-stage:first-child,.Comparison .FeatureTabs .FeatureTabs-stage:last-child,.Comparison .Intro .Intro-Slogan:first-child,.Comparison .Intro .Intro-Slogan:last-child,.ExampleExplanation .Cell:first-child,.ExampleExplanation .Cell:last-child,.ExampleExplanation .ExampleExplanation-code:first-child,.ExampleExplanation .ExampleExplanation-code:last-child,.ExampleExplanation .ExampleExplanation-text:first-child,.ExampleExplanation .ExampleExplanation-text:last-child,.ExampleExplanation .FeatureTabs .FeatureTabs-stage:first-child,.ExampleExplanation .FeatureTabs .FeatureTabs-stage:last-child,.ExampleExplanation .Intro .Intro-Slogan:first-child,.ExampleExplanation .Intro .Intro-Slogan:last-child,.FeatureTabs .Comparison .FeatureTabs-stage:first-child,.FeatureTabs .Comparison .FeatureTabs-stage:last-child,.FeatureTabs .ExampleExplanation .FeatureTabs-stage:first-child,.FeatureTabs .ExampleExplanation .FeatureTabs-stage:last-child,.FeatureTabs .Grid--fullWidth .FeatureTabs-stage:first-child,.FeatureTabs .Grid--fullWidth .FeatureTabs-stage:last-child,.Grid--fullWidth .Cell:first-child,.Grid--fullWidth .Cell:last-child,.Grid--fullWidth .FeatureTabs .FeatureTabs-stage:first-child,.Grid--fullWidth .FeatureTabs .FeatureTabs-stage:last-child,.Grid--fullWidth .Intro .Intro-Slogan:first-child,.Grid--fullWidth .Intro .Intro-Slogan:last-child,.Intro .Comparison .Intro-Slogan:first-child,.Intro .Comparison .Intro-Slogan:last-child,.Intro .ExampleExplanation .Intro-Slogan:first-child,.Intro .ExampleExplanation .Intro-Slogan:last-child,.Intro .Grid--fullWidth .Intro-Slogan:first-child,.Intro .Grid--fullWidth .Intro-Slogan:last-child{padding-left:1.5rem}}.Example,.Image.Image--fullWidth,.TODO,.u-fullWidth{margin-left:-2rem;margin-right:-2rem;padding-left:4rem;padding-right:4rem}.Cell,.Comparison .Comparison-left,.Comparison .Comparison-right,.ExampleExplanation .ExampleExplanation-code,.ExampleExplanation .ExampleExplanation-text,.FeatureTabs .FeatureTabs-stage,.Intro .Intro-Slogan{padding-left:2rem;padding-right:2rem;-webkit-flex:0 0 auto;-ms-flex:0 0 auto;flex:0 0 auto}@media (max-width:800px){.Cell,.Comparison .Comparison-left,.Comparison .Comparison-right,.ExampleExplanation .ExampleExplanation-code,.ExampleExplanation .ExampleExplanation-text,.FeatureTabs .FeatureTabs-stage,.Intro .Intro-Slogan{-webkit-flex-basis:100%;-ms-flex-preferred-size:100%;flex-basis:100%;max-width:100%}.m-Cell--withMargin{margin-bottom:3rem}}.Cell--3-12{-webkit-flex-basis:25%;-ms-flex-preferred-size:25%;flex-basis:25%;max-width:25%}.Nav,.u-width--3-12,nav.Nav--bottom,nav.Nav--top{max-width:25%;width:100%}@media (max-width:800px){.Nav,.u-width--3-12,nav.Nav--bottom,nav.Nav--top{max-width:100%}}.Cell--4-12,.ExampleExplanation .ExampleExplanation-text{-webkit-flex-basis:33.333%;-ms-flex-preferred-size:33.333%;flex-basis:33.333%;max-width:33.333%}@media (max-width:800px){.Cell--4-12,.ExampleExplanation .ExampleExplanation-text{-webkit-flex-basis:100%;-ms-flex-preferred-size:100%;flex-basis:100%;max-width:100%}}.Cell--6-12,.Comparison .Comparison-left,.Comparison .Comparison-right{-webkit-flex-basis:50%;-ms-flex-preferred-size:50%;flex-basis:50%;max-width:50%}@media (max-width:800px){.Cell--6-12,.Comparison .Comparison-left,.Comparison .Comparison-right{-webkit-flex-basis:100%;-ms-flex-preferred-size:100%;flex-basis:100%;max-width:100%}}.Cell--8-12,.ExampleExplanation .ExampleExplanation-code{-webkit-flex-basis:66.666%;-ms-flex-preferred-size:66.666%;flex-basis:66.666%;max-width:66.666%}@media (max-width:800px){.Cell--8-12,.ExampleExplanation .ExampleExplanation-code{-webkit-flex-basis:100%;-ms-flex-preferred-size:100%;flex-basis:100%;max-width:100%}}.Main article.Article--noGrid>.Image:not(.Image--fullWidth),.Main article.Article--noGrid>h1,.Main article.Article--noGrid>h2,.Main article.Article--noGrid>h3,.Main article.Article--noGrid>h4,.Main article.Article--noGrid>img,.Main article.Article--noGrid>ol,.Main article.Article--noGrid>p,.Main article.Article--noGrid>table,.Main article.Article--noGrid>ul,.u-width--8-12,main article.Article--noGrid>.Image:not(.Image--fullWidth),main article.Article--noGrid>h1,main article.Article--noGrid>h2,main article.Article--noGrid>h3,main article.Article--noGrid>h4,main article.Article--noGrid>img,main article.Article--noGrid>ol,main article.Article--noGrid>p,main article.Article--noGrid>table,main article.Article--noGrid>ul{max-width:66.666%;width:100%}@media (max-width:800px){.Main article.Article--noGrid>.Image:not(.Image--fullWidth),.Main article.Article--noGrid>h1,.Main article.Article--noGrid>h2,.Main article.Article--noGrid>h3,.Main article.Article--noGrid>h4,.Main article.Article--noGrid>img,.Main article.Article--noGrid>ol,.Main article.Article--noGrid>p,.Main article.Article--noGrid>table,.Main article.Article--noGrid>ul,.u-width--8-12,main article.Article--noGrid>.Image:not(.Image--fullWidth),main article.Article--noGrid>h1,main article.Article--noGrid>h2,main article.Article--noGrid>h3,main article.Article--noGrid>h4,main article.Article--noGrid>img,main article.Article--noGrid>ol,main article.Article--noGrid>p,main article.Article--noGrid>table,main article.Article--noGrid>ul{max-width:100%}}.Cell--9-12,.FeatureTabs .FeatureTabs-stage,.Intro .Intro-Slogan{-webkit-flex-basis:75%;-ms-flex-preferred-size:75%;flex-basis:75%;max-width:75%}.Cell--12-12{-webkit-flex-basis:100%;-ms-flex-preferred-size:100%;flex-basis:100%;max-width:100%}.Sans,body{font-family:sans-serif;font-weight:400}.FeatureTable .section,.H2,.H3,.H4,.Introduction,.Sans--bold,.Serif--bold,h1,h2,h3,h4,ul li:before{font-family:sans-serif;font-weight:600}body{font-size:1.9rem;line-height:1.4;color:#212121;background-color:#527aa3}h1{font-size:2em;margin-top:0;margin-bottom:4rem;color:#244d82}.FeatureTable .section,.H2,.H3,h2,h3{margin-top:4rem;margin-bottom:2rem}.FeatureTable .section,.H2,h2{font-size:1.3em;color:#244d82}.H3,.H4,h3,h4{font-size:1em}.H4,h4{margin-top:.5em;margin-bottom:0}ol,p,ul{margin-bottom:.5em}.Link,a{color:#6999d6}a:hover{color:#132445}.Link.Link--action,a.Link--action{color:#f7d425;text-decoration:none}.Link.Link--action:hover,a.Link--action:hover{text-decoration:underline}.Example .Example-caption,.FeatureTable,.FeatureTabs .FeatureTabs-stage ul,.Image .Image-caption,.SystemRequirements,.u-small,small{font-size:.8em;line-height:1.4em}ol ol,ol ul,ul ol,ul ul{margin-left:2em}ol li,ul li{margin-bottom:.2em}ol{margin-left:1.2em}ul{margin-left:.75em}ul li{list-style:none}ul li:before{content:"›";margin-left:-.75em;margin-right:.4em;color:#244d82}code{font-family:Fira Mono,Monaco,Consolas,Courier New,Courier,mono,serif;font-size:.85em;letter-spacing:.02em}img{width:100%;height:auto}h1:first-child,h2:first-child,h3:first-child{margin-top:0}.Main,.Page,footer,header,main{width:100%;max-width:1050px;margin-right:auto;margin-left:auto;padding-left:2rem;padding-right:2rem}.Main,main{background-color:#fff;position:relative}footer,header{background-color:#132445}.Main article,main article{margin-top:4rem;margin-bottom:4rem}.Main article:first-of-type,main article:first-of-type{margin-top:0;padding-top:0}@media (max-width:800px){.Main,.Page,footer,header,main{padding-left:.75rem;padding-right:.75rem}.Main article:first-of-type,main article:first-of-type{padding-top:1.5rem}}.Main article:last-of-type,main article:last-of-type{margin-bottom:0;padding-bottom:4rem}.Main article.Article--noGrid>h1,.Main article.Article--noGrid>h2,.Main article.Article--noGrid>h3,.Main article.Article--noGrid>h4,.Main article.Article--noGrid>ol,.Main article.Article--noGrid>p,.Main article.Article--noGrid>ul,main article.Article--noGrid>h1,main article.Article--noGrid>h2,main article.Article--noGrid>h3,main article.Article--noGrid>h4,main article.Article--noGrid>ol,main article.Article--noGrid>p,main article.Article--noGrid>ul{padding-left:2rem}@media (max-width:800px){.Main article.Article--noGrid>h1,.Main article.Article--noGrid>h2,.Main article.Article--noGrid>h3,.Main article.Article--noGrid>h4,.Main article.Article--noGrid>ol,.Main article.Article--noGrid>p,.Main article.Article--noGrid>ul,main article.Article--noGrid>h1,main article.Article--noGrid>h2,main article.Article--noGrid>h3,main article.Article--noGrid>h4,main article.Article--noGrid>ol,main article.Article--noGrid>p,main article.Article--noGrid>ul{padding-left:.75rem;padding-right:.75rem}}.Main article.Article--noGrid>table,main article.Article--noGrid>table{margin-left:2rem;margin-right:2rem;margin-bottom:2rem}.Main article.Article--noGrid>table td,.Main article.Article--noGrid>table th,main article.Article--noGrid>table td,main article.Article--noGrid>table th{padding:.2em .5em}.Main article.Article--noGrid>table th,main article.Article--noGrid>table th{text-align:left}.Main article.Article--noGrid>.Image:not(.Image--fullWidth),.Main article.Article--noGrid>img,main article.Article--noGrid>.Image:not(.Image--fullWidth),main article.Article--noGrid>img{padding-left:2rem;margin-top:2rem;margin-bottom:2rem}header{height:7rem;color:#fff;padding-top:1.7rem;padding-bottom:.8rem}header img{height:4rem;width:auto;margin:0}header nav{border:none;line-height:1em;padding-top:1.8rem;text-align:right}header nav a{display:inline-block;text-decoration:none;padding:0 1rem;transition:color .3s;color:#fff}header nav a.is-active,header nav a:hover{color:#f7d425}header nav a:last-child{padding-right:16px}footer{color:#fff;padding-top:2rem;padding-bottom:2rem}footer a{color:#d5dfea}footer a:hover{color:#F7D425}footer .Link--action{float:right}footer a,footer a:hover{text-decoration:none}.Nav,nav.Nav--bottom,nav.Nav--top{position:absolute;z-index:1;padding-left:2rem;border-left:1px solid #d3d3d3}@media (max-width:800px){header{height:auto}header img{max-width:100%;max-height:4rem;height:auto}header nav{display:none}footer{text-align:center}footer .Link--action{display:block;width:100%;float:none}.Nav,nav.Nav--bottom,nav.Nav--top{position:static;width:100%;padding-left:.75rem;border-left:none;padding-top:1.5rem;padding-bottom:3rem;border-bottom:1px solid #d3d3d3}}.Nav li:last-child,.Nav ul,nav.Nav--bottom li:last-child,nav.Nav--bottom ul,nav.Nav--top li:last-child,nav.Nav--top ul{margin-bottom:0}.Nav a,nav.Nav--bottom a,nav.Nav--top a{text-decoration:none;color:rgba(0,0,0,.3);transition:.2s}.Nav a.is-active,.Nav a:hover,nav.Nav--bottom a.is-active,nav.Nav--bottom a:hover,nav.Nav--top a.is-active,nav.Nav--top a:hover{color:#212121}.Nav.Nav--top,nav.Nav--bottom.Nav--top,nav.Nav--top.Nav--top{right:4rem;top:4rem}.Nav.Nav--bottom,nav.Nav--bottom.Nav--bottom,nav.Nav--top.Nav--bottom{right:4rem;bottom:4rem}.Intro{background-color:#244d82;padding:4rem 0;margin-bottom:-4rem;position:relative}@media (max-width:800px){.Intro{padding:0}}.Intro .Intro-Slogan{color:#fff;font-size:2em;padding:1rem 0;margin:0 auto}@media (max-width:800px){.Intro .Intro-Slogan{-webkit-flex-basis:100%;-ms-flex-preferred-size:100%;flex-basis:100%;max-width:100%;font-size:1.4em;padding:.5rem 2.5rem 1rem;padding-left:2.5rem!important}}.Intro img{z-index:1;margin:0;height:100%;width:100%}.Intro:after{content:"";position:absolute;left:0;right:0;bottom:0;top:65%;z-index:0;background-color:#fff}.GettingStarted{background-color:#fbffb4;padding:4rem 0}@media (max-width:800px){.GettingStarted h2{padding-left:1.5rem}}.GettingStarted .GettingStarted-u-paddingLeft{padding-left:4rem}.GettingStarted .GettingStarted-u-paddingRight{padding-right:4rem}@media (max-width:800px){.GettingStarted .GettingStarted-u-paddingLeft{margin-bottom:3rem;padding-left:3rem}.GettingStarted .GettingStarted-u-paddingRight{padding-right:3rem}}.SystemRequirements{color:rgba(0,0,0,.3);margin-top:2rem}.Comparison,.TODO{margin-top:4rem;margin-bottom:4rem}.TODO{padding-top:.5em;padding-bottom:.5em;color:#fff;background-color:#f39797}.TODO:before{content:"TODO: ";font-weight:700}.Comparison .Comparison-left{border-right:1px solid #d3d3d3}.Comparison .Comparison-left .Example,.Comparison .Comparison-left .Example-caption{margin-left:-4rem;margin-right:-2rem;padding-left:4rem;padding-right:2rem}.Comparison .Comparison-right .Example,.Comparison .Comparison-right .Example-caption{margin-left:-2rem;margin-right:-4rem;padding-left:2rem;padding-right:4rem}@media (max-width:800px){.Comparison .Comparison-left .Example,.Comparison .Comparison-left .Example-caption,.Comparison .Comparison-right .Example{padding-left:4rem;padding-right:4rem}.Comparison .Comparison-left .Example-caption{margin-right:-4rem}.Comparison .Comparison-right .Example-caption{padding-left:4rem;padding-right:4rem;margin-left:-4rem}}.Example{margin-top:2rem;margin-bottom:2rem}.Example .Example-code,.Example .dp-highlighter{padding-top:2rem;padding-bottom:2rem}.Example .Example-caption{margin-left:-4rem;margin-right:-4rem;padding:.5rem 4rem;background-color:#d5dfea}.ExampleExplanation{margin-top:4rem;margin-bottom:4rem}.ExampleExplanation .ExampleExplanation-text{background-color:#d5dfea;padding-top:2rem;padding-bottom:2rem}.ExampleExplanation .ExampleExplanation-code{padding-top:2rem;padding-bottom:2rem}.ExampleExplanation .ExampleExplanation-code .Example,.ExampleExplanation .ExampleExplanation-code .dp-highlighter{margin:0;padding:0}.Example,.ExampleExplanation-code{background-color:#f5f7fa}.Example .dp-highlighter,.ExampleExplanation-code .dp-highlighter{font-family:Fira Mono,Monaco,Consolas,Courier New,Courier,mono,serif;font-size:.7em;line-height:1.4em;overflow:auto}.Example .dp-highlighter ol,.Example .dp-highlighter ol li,.Example .dp-highlighter ol li span,.ExampleExplanation-code .dp-highlighter ol,.ExampleExplanation-code .dp-highlighter ol li,.ExampleExplanation-code .dp-highlighter ol li span{margin:0;padding:0;border:none}.Example .dp-highlighter ol li,.ExampleExplanation-code .dp-highlighter ol li{white-space:nowrap}.Example .dp-highlighter a,.Example .dp-highlighter a:hover,.ExampleExplanation-code .dp-highlighter a,.ExampleExplanation-code .dp-highlighter a:hover{background:0 0;border:none;padding:0;margin:0}.Example .dp-highlighter .bar,.ExampleExplanation-code .dp-highlighter .bar{padding-left:45px}.Example .dp-highlighter.collapsed .bar,.Example .dp-highlighter.nogutter .bar,.ExampleExplanation-code .dp-highlighter.collapsed .bar,.ExampleExplanation-code .dp-highlighter.nogutter .bar{padding-left:0}.Example .dp-highlighter ol,.ExampleExplanation-code .dp-highlighter ol{list-style:decimal;margin:0 0 0 34px!important;padding:0;color:rgba(0,0,0,.3)}.Example .dp-highlighter.nogutter ol,.Example .dp-highlighter.nogutter ol li,.ExampleExplanation-code .dp-highlighter.nogutter ol,.ExampleExplanation-code .dp-highlighter.nogutter ol li{list-style:none!important;margin-left:0!important}.Example .dp-highlighter .columns div,.Example .dp-highlighter ol li,.ExampleExplanation-code .dp-highlighter .columns div,.ExampleExplanation-code .dp-highlighter ol li{list-style:decimal-leading-zero;list-style-position:outside!important;margin:0!important;line-height:1.4em}.Example .dp-highlighter.nogutter .columns div,.Example .dp-highlighter.nogutter ol li,.ExampleExplanation-code .dp-highlighter.nogutter .columns div,.ExampleExplanation-code .dp-highlighter.nogutter ol li{border:0}.Example .dp-highlighter .columns,.ExampleExplanation-code .dp-highlighter .columns{background-color:#f8f8f8;color:gray;overflow:hidden;width:100%}.Example .dp-highlighter .columns div,.ExampleExplanation-code .dp-highlighter .columns div{padding-bottom:5px}.Example .dp-highlighter ol li.alt,.ExampleExplanation-code .dp-highlighter ol li.alt{color:inherit}.Example .dp-highlighter ol li span,.ExampleExplanation-code .dp-highlighter ol li span{color:#000;background-color:inherit}.Example .dp-highlighter.collapsed ol,.ExampleExplanation-code .dp-highlighter.collapsed ol{margin:0}.Example .dp-highlighter.collapsed ol li,.ExampleExplanation-code .dp-highlighter.collapsed ol li{display:none}.Example .dp-highlighter.printing,.ExampleExplanation-code .dp-highlighter.printing{border:none}.Example .dp-highlighter.printing .tools,.ExampleExplanation-code .dp-highlighter.printing .tools{display:none!important}.Example .dp-highlighter.printing li,.ExampleExplanation-code .dp-highlighter.printing li{display:list-item!important}.Example .dp-highlighter .tools,.ExampleExplanation-code .dp-highlighter .tools{padding:3px 8px 10px 10px;font:9px Verdana,Geneva,Arial,Helvetica,sans-serif;color:silver;border-left:1px solid #000}.Example .dp-highlighter.nogutter .tools,.ExampleExplanation-code .dp-highlighter.nogutter .tools{border-left:0}.Example .dp-highlighter.collapsed .tools,.ExampleExplanation-code .dp-highlighter.collapsed .tools{border-bottom:0}.Example .dp-highlighter .tools a,.ExampleExplanation-code .dp-highlighter .tools a{font-size:9px;color:#a0a0a0;text-decoration:none;margin-right:10px}.Example .dp-highlighter .tools a:hover,.ExampleExplanation-code .dp-highlighter .tools a:hover{color:red;background-color:inherit;text-decoration:underline}.Example .dp-about,.ExampleExplanation-code .dp-about{background-color:#fff;color:#333;margin:0;padding:0}.Example .dp-about table,.ExampleExplanation-code .dp-about table{width:100%;height:100%;font-size:11px;font-family:Tahoma,Verdana,Arial,sans-serif!important}.Example .dp-about td,.ExampleExplanation-code .dp-about td{padding:10px;vertical-align:top}.Example .dp-about .copy,.ExampleExplanation-code .dp-about .copy{border-bottom:1px solid #aca899;height:95%}.Example .dp-about .title,.ExampleExplanation-code .dp-about .title{color:red;background-color:inherit;font-weight:700}.Example .dp-about .para,.ExampleExplanation-code .dp-about .para{margin:0 0 4px}.Image,.Table{margin-bottom:2rem;margin-top:2rem}.Example .dp-about .footer,.ExampleExplanation-code .dp-about .footer{background-color:#eceadb;color:#333;border-top:1px solid #fff;text-align:right}.Example .dp-about .close,.ExampleExplanation-code .dp-about .close{font-size:11px;font-family:Tahoma,Verdana,Arial,sans-serif!important;background-color:#eceadb;color:#333;width:60px;height:22px}.Example .dp-highlighter .comment,.Example .dp-highlighter .comments,.ExampleExplanation-code .dp-highlighter .comment,.ExampleExplanation-code .dp-highlighter .comments{color:#3f6a4d;background-color:inherit}.Example .dp-highlighter .string,.ExampleExplanation-code .dp-highlighter .string{color:#101af9;background-color:inherit}.Example .dp-highlighter .keyword,.ExampleExplanation-code .dp-highlighter .keyword{color:#5f1441;font-weight:700;background-color:inherit}.Example .dp-highlighter .annotation,.ExampleExplanation-code .dp-highlighter .annotation{color:red;font-weight:700;background-color:inherit}.Example .dp-highlighter .preprocessor,.ExampleExplanation-code .dp-highlighter .preprocessor{color:#0f0;background-color:inherit}.Image{position:relative;text-align:center}.Image .Image-caption{padding-top:.5rem;padding-bottom:.5rem;text-align:left}.Image img{max-width:100%;max-height:100%;height:auto;width:auto}.Table th{background-color:#d5dfea}.Table td,.Table th,.Table tr{border:0 solid #d3d3d3}.Table.Table--horizontalLines tr{border-top-width:1px}.Table.Table--horizontalLines tr:last-child{border-bottom-width:1px}.Table.Table--verticalLines td,.Table.Table--verticalLines th{border-left-width:1px}.Table.Table--verticalLines td:last-child,.Table.Table--verticalLines th:last-child{border-right-width:1px}.FeatureTable tr:first-child th:first-child{width:25%}.FeatureTable .section{padding:1.5em 0 .5em}.FeatureTable .done{background-color:#efe}.FeatureTable .most{background-color:#ffd}.FeatureTable .tbc{background-color:#fff6de}.FeatureTable .tbd{background-color:#fee}.FeatureTabs .FeatureTabs-nav{background-color:#f5f7fa}.FeatureTabs .FeatureTabs-nav ul{margin-bottom:0;margin-left:0}@media (max-width:800px){.FeatureTabs .FeatureTabs-nav ul{display:none}}.FeatureTabs .FeatureTabs-nav ul li{display:block;padding-top:2rem;padding-bottom:2rem;border-bottom:1px solid #d3d3d3}.FeatureTabs .FeatureTabs-nav ul li:before{display:none}.FeatureTabs .FeatureTabs-nav ul li:last-child{border-bottom:none}.FeatureTabs .FeatureTabs-nav a{text-decoration:none;color:rgba(0,0,0,.3);transition:.3s}.FeatureTabs .FeatureTabs-nav a.is-activeTab,.FeatureTabs .FeatureTabs-nav a:hover{color:#212121}.FeatureTabs .FeatureTabs-stage{display:none;background-color:#d5dfea;padding-top:2rem;padding-bottom:2rem}.FeatureTabs .FeatureTabs-stage.is-activeTab{display:block}.FeatureTabs .FeatureTabs-stage img{margin-bottom:2rem}@media (max-width:800px){.FeatureTabs .FeatureTabs-stage{display:block;-webkit-flex-basis:100%;-ms-flex-preferred-size:100%;flex-basis:100%;max-width:100%;border-bottom:1px solid #94afc9;padding-left:3.75rem;padding-right:3.75rem}.FeatureTabs .FeatureTabs-stage h2{margin-bottom:.5rem}}.FeatureTabs .FeatureTabs-stage ul{display:-webkit-flex;display:-ms-flexbox;display:flex;margin-left:0;margin-top:2rem;color:rgba(0,0,0,.3)}.FeatureTabs .FeatureTabs-stage ul li{-webkit-flex-grow:1;-ms-flex-positive:1;flex-grow:1;padding-right:1rem}@media (max-width:800px){.FeatureTabs .FeatureTabs-stage ul{margin-top:.5rem;margin-bottom:1.5rem;display:block}.FeatureTabs .FeatureTabs-stage ul li{-webkit-flex-grow:none;-ms-flex-positive:none;flex-grow:none;width:100%;display:block}}.FeatureTabs .FeatureTabs-stage ul li:before{content:"✓";margin:0 .3em 0 0}.FeatureTabs .FeatureTabs-stage a{text-decoration:none;color:#244d82}.FeatureTabs .FeatureTabs-stage a:hover{text-decoration:underline}#community ul{padding-bottom:1rem;padding-top:1em}footer.social{line-height:1.4;color:#FFF;font-size:1.2rem;font-weight:400;font-style:bold;background-color:#132445}footer.social li a{margin-bottom:2em;color:#d5dfea;font-size:1.8rem;font-weight:400;font-style:bold;list-style:none;text-decoration-color:#d5dfea}footer.social a:hover{color:#F7D425}footer.social:first-child{margin-top:0}footer.social h2{margin-bottom:20px;font-weight:600;font-size:1.3em;margin-top:4rem;color:#244d82;font-family:sans-serif}footer.social li:before{content:"› ";color:#244d82;font-size:large;font-weight:800}footer.social ul{margin-top:-10px;line-height:30px}footer.social li{display:-webkit-inline-box;padding-right:10rem;padding-bottom:1rem}
diff --git a/idespec/test_support.html b/idespec/test_support.html
new file mode 100644
index 0000000..b6e1e18
--- /dev/null
+++ b/idespec/test_support.html
@@ -0,0 +1,1950 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="generator" content="Asciidoctor 1.5.5">
+<meta name="author" content="2019-08-07 15:02:40 CEST">
+<title>N4JS IDE Specification</title>
+<link rel="stylesheet" href="styles/spec.min.css">
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.6.3/css/font-awesome.min.css">
+<!-- ************* docinfo ******************************************************************* -->
+
+
+<!-- ************* Favicon ************-->
+<link rel="icon" href="images/favicon.ico" />
+
+<!-- ************* Back-to-top JQuery ************* -->
+<script src="https://code.jquery.com/jquery-1.12.4.js"></script>
+<script src="https://code.jquery.com/ui/1.12.0/jquery-ui.js"></script>
+
+
+<link href="styles/prism.min.css" rel="stylesheet" />
+<script type="text/javascript" async
+  src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2/MathJax.js?config=TeX-MML-AM_CHTML">
+</script>
+
+<!-- ************* Styles ************* -->
+<link rel="stylesheet" type="text/css" href="styles/n4jsspec-adoc.css">
+
+
+<!-- ****************** NavBar ****************** -->
+<div id="menubar">
+	<div class="banner">
+        <a href="https://www.eclipse.org/n4js/#"><img id="logo" src="images/n4js-logo.png" alt="Eclipse N4JS"></a>
+    </div>
+<ul>
+  <li><a href="index.html">Index</a></li>
+</ul>
+</div>
+<!-- ************* docinfo ******************************************************************* -->
+<style>
+      .admonitionblock td.icon .icon-todo:before{content:"\f249";color:#f4ee42}
+    </style>
+</head>
+<body class="book toc2 toc-left">
+<div id="header">
+<h1>N4JS IDE Specification</h1>
+<div class="details">
+<span id="author" class="author">2019-08-07 15:02:40 CEST</span><br>
+<span id="revnumber">version 0.9</span>
+</div>
+<div id="toc" class="toc2">
+<div id="toctitle">Table of Contents</div>
+<ul class="sectlevel1">
+<li><a href="views.html#sec:Views">1. Views</a>
+<ul class="sectlevel2">
+<li><a href="views.html#_eclipse-standard-views">1.1. Eclipse Standard Views</a>
+<ul class="sectlevel3">
+<li><a href="views.html#sec:Project_Explorer_View">1.1.1. Project Explorer</a></li>
+<li><a href="views.html#sec:Outline_View">1.1.2. Outline</a></li>
+<li><a href="views.html#sec:Problems_View">1.1.3. Problems</a></li>
+<li><a href="views.html#sec:Console_View">1.1.4. Console</a></li>
+<li><a href="views.html#sec:History_View">1.1.5. History</a></li>
+<li><a href="views.html#sec:Error_Log_View">1.1.6. Error Log</a></li>
+</ul>
+</li>
+<li><a href="views.html#_n4js-specific-views">1.2. N4JS Specific Views</a>
+<ul class="sectlevel3">
+<li><a href="views.html#_test-results">1.2.1. Test Results</a></li>
+<li><a href="views.html#_source-graphs">1.2.2. Source Graphs</a></li>
+<li><a href="views.html#_api-compare">1.2.3. API Compare</a></li>
+<li><a href="views.html#_performance-graphs">1.2.4. Performance Graphs</a></li>
+<li><a href="views.html#_source-mapping">1.2.5. Source Mapping</a></li>
+<li><a href="views.html#_xpect-view">1.2.6. Xpect View</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="navigation.html#_navigation">2. Navigation</a>
+<ul class="sectlevel2">
+<li><a href="navigation.html#sec:Outline_Navigation">2.1. Outline</a>
+<ul class="sectlevel3">
+<li><a href="navigation.html#_quick-outline">2.1.1. Quick Outline</a></li>
+<li><a href="navigation.html#_normal-outline">2.1.2. Normal Outline</a></li>
+</ul>
+</li>
+<li><a href="navigation.html#_navigation-commands">2.2. Navigation Commands</a>
+<ul class="sectlevel3">
+<li><a href="navigation.html#sec:Navigate_to_Declaration">2.2.1. Navigate to Declaration</a></li>
+<li><a href="navigation.html#sec:find_by_references">2.2.2. Find by References</a></li>
+<li><a href="navigation.html#sec:Open_Type_Declaration">2.2.3. Open Type Declaration</a></li>
+</ul>
+</li>
+<li><a href="navigation.html#sec:Working_Sets">2.3. Working Sets</a>
+<ul class="sectlevel3">
+<li><a href="navigation.html#sec:Working_Set_Managers">2.3.1. Working Set Managers</a></li>
+<li><a href="navigation.html#sec:Working_Set_Constraints">2.3.2. Working Set Constraints</a></li>
+<li><a href="navigation.html#sec:Manual_Association_Working_Set_Manager_UI_Features">2.3.3. Manual Association Working Set Manager - UI Features</a></li>
+<li><a href="navigation.html#sec:Project_Name_Filter_Working_Set_Manager">2.3.4. Project Name Filter Working Set Manager</a></li>
+<li><a href="navigation.html#sec:Git_Repository_Working_Set_Manager">2.3.5. Git Repository Working Set Manager</a></li>
+<li><a href="navigation.html#sec:Project_Location_Working_Set_Manager">2.3.6. Project Location Working Set Manager</a></li>
+<li><a href="navigation.html#sec:N4JS_Project_Type_Working_Set_Manager">2.3.7. N4JS Project Type Working Set Manager</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="assistance.html#_assistance">3. Assistance</a>
+<ul class="sectlevel2">
+<li><a href="assistance.html#sec:Content_Assist">3.1. Content Assist</a>
+<ul class="sectlevel3">
+<li><a href="assistance.html#sec:Complete_Keywords">3.1.1. Complete Keywords</a></li>
+<li><a href="assistance.html#sec:Complete_Annotations">3.1.2. Complete Annotations</a></li>
+<li><a href="assistance.html#sec:Complete_Identifier_Reference">3.1.3. Complete Identifier Reference</a></li>
+<li><a href="assistance.html#sec:Complete_Member_Overrides">3.1.4. Complete Member Overrides</a></li>
+<li><a href="assistance.html#sec:Constructor_Completion">3.1.5. Constructor Completion</a></li>
+<li><a href="assistance.html#sec:Complete_Function_Expression">3.1.6. Complete Function Expression with Known Type</a></li>
+<li><a href="assistance.html#sec:Complete_Variable_and_Parameter_Names">3.1.7. Complete Variable and Parameter Names</a></li>
+</ul>
+</li>
+<li><a href="assistance.html#sec:Quick_Fixes">3.2. Quick Fixes</a>
+<ul class="sectlevel3">
+<li><a href="assistance.html#sec:N4JS_Issue_Properties">3.2.1. N4JS Issue User data</a></li>
+<li><a href="assistance.html#sec:N4JS_Issue_Fixes">3.2.2. N4JS Issue Fixes</a>
+<ul class="sectlevel4">
+<li><a href="assistance.html#sec:Linking_Issues">3.2.2.1. Linking Issues</a></li>
+<li><a href="assistance.html#sec:Import_Issues">3.2.2.2. Import Issues</a></li>
+<li><a href="assistance.html#sec:Visibility_Issues">3.2.2.3. Visibility Issues</a></li>
+<li><a href="assistance.html#sec:Classifier_Issues">3.2.2.4. Classifier Issues</a></li>
+<li><a href="assistance.html#sec:Function_Issues">3.2.2.5. Function Issues</a></li>
+<li><a href="assistance.html#sec:Syntax_Issues">3.2.2.6. Syntax Issues</a></li>
+<li><a href="assistance.html#sec:Conversion_Issues">3.2.2.7. Conversion Issues</a></li>
+<li><a href="assistance.html#sec:Type_Issues">3.2.2.8. Type Issues</a></li>
+<li><a href="assistance.html#sec:Expression_Issues">3.2.2.9. Expression Issues</a></li>
+<li><a href="assistance.html#sec:Super_Keyword_Issues">3.2.2.10. Super Keyword Issues</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="assistance.html#sec:Quick_Assist">3.3. Quick Assist</a></li>
+<li><a href="assistance.html#sec:Cleanup_Operations">3.4. Cleanup Operations</a>
+<ul class="sectlevel3">
+<li><a href="assistance.html#sec:Formatting">3.4.1. Formatting</a></li>
+<li><a href="assistance.html#sec:Organize_Imports">3.4.2. Organize Imports</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="wizards.html#_wizards">4. Wizards</a>
+<ul class="sectlevel2">
+<li><a href="wizards.html#sec:N4JS_Project_Wizard">4.1. N4JS Project Wizard</a></li>
+<li><a href="wizards.html#sec:Empty_N4JS_File">4.2. Empty N4JS File</a></li>
+<li><a href="wizards.html#sec:Empty_JS_File">4.3. Empty JS File</a>
+<ul class="sectlevel3">
+<li><a href="wizards.html#sec:N4JS_Class_File_Wizard">4.3.1. N4JS Class Wizard</a></li>
+<li><a href="wizards.html#field-properties">4.3.2. Field Properties</a></li>
+<li><a href="wizards.html#visibility-issues-or-final-super-classes">4.3.3. Visibility issues or <code>@Final</code> super classes</a></li>
+<li><a href="wizards.html#generation-1">4.3.4. Generation</a></li>
+<li><a href="wizards.html#preview-1">4.3.5. Preview</a></li>
+</ul>
+</li>
+<li><a href="wizards.html#sec:N4JS_Interface_Wizard">4.4. Interface Wizard</a>
+<ul class="sectlevel3">
+<li><a href="wizards.html#field-properties-1">4.4.1. Field Properties</a></li>
+<li><a href="wizards.html#visibility-issues">4.4.2. Visibility Issues</a></li>
+<li><a href="wizards.html#import-naming-conflicts">4.4.3. Import naming conflicts</a></li>
+<li><a href="wizards.html#generation-2">4.4.4. Generation</a></li>
+<li><a href="wizards.html#preview-2">4.4.5. Preview</a></li>
+</ul>
+</li>
+<li><a href="wizards.html#sec:N4JS_Enum_File_Wizard">4.5. Enum Wizard</a>
+<ul class="sectlevel3">
+<li><a href="wizards.html#field-properties-2">4.5.1. Field Properties</a></li>
+<li><a href="wizards.html#generation-3">4.5.2. Generation</a></li>
+<li><a href="wizards.html#preview-3">4.5.3. Preview</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="execution_support.html#_execution-support">5. Execution Support</a>
+<ul class="sectlevel2">
+<li><a href="execution_support.html#sec:Non_UI_Execution">5.1. Non-UI Execution</a>
+<ul class="sectlevel3">
+<li><a href="execution_support.html#sec:Non_UI_Debugging">5.1.1. Non-UI Debugging</a></li>
+</ul>
+</li>
+<li><a href="execution_support.html#sec:UI_Execution">5.2. UI Execution</a></li>
+</ul>
+</li>
+<li><a href="#_test-support">6. Test Support</a>
+<ul class="sectlevel2">
+<li><a href="#sec:N4JS_Mangelhaft_support">6.1. N4JS Mangelhaft support</a>
+<ul class="sectlevel3">
+<li><a href="#sec:Asynchronous_Tests">6.1.1. Asynchronous Tests, Test Isolation and Timeouts</a></li>
+<li><a href="#sec:Supported_xUnit_API">6.1.2. Supported xUnit API</a>
+<ul class="sectlevel4">
+<li><a href="#sec:Test_Group">6.1.2.1. Test Group</a></li>
+<li><a href="#sec:Test_Method">6.1.2.2. Test Method</a></li>
+<li><a href="#sec:BeforeAll">6.1.2.3. BeforeAll Setup</a></li>
+<li><a href="#sec:Before_Setup">6.1.2.4. Before Setup</a></li>
+<li><a href="#sec:After_Teardown">6.1.2.5. After Teardown</a></li>
+<li><a href="#sec:AfterAll_Teardown">6.1.2.6. AfterAll Teardown</a></li>
+<li><a href="#sec:Test_Ignore">6.1.2.7. Test Ignore</a></li>
+<li><a href="#sec:Timeout">6.1.2.8. Timeout</a></li>
+<li><a href="#sec:Description">6.1.2.9. Description</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#sec:Test_Reporting">6.2. Test Reporting</a>
+<ul class="sectlevel3">
+<li><a href="#sec:Test_Messages">6.2.1. Test Messages</a>
+<ul class="sectlevel4">
+<li><a href="#_test-case-ids">6.2.1.1. Test Case IDs</a></li>
+<li><a href="#sec:Start_Session">6.2.1.2. Start Session</a></li>
+<li><a href="#sec:Ping_Session">6.2.1.3. Ping Session</a></li>
+<li><a href="#sec:End_Session">6.2.1.4. End Session</a></li>
+<li><a href="#sec:Start_Test">6.2.1.5. Start Test</a></li>
+<li><a href="#sec:End_Test">6.2.1.6. End Test</a></li>
+<li><a href="#sec:Ping_Test">6.2.1.7. Ping Test</a></li>
+<li><a href="#sec:Test_Catalog">6.2.1.8. Test Catalog</a></li>
+<li><a href="#sec:Test_Session_Example">6.2.1.9. Test Session Example</a></li>
+</ul>
+</li>
+<li><a href="#sec:Test_Runtime_Configuration">6.2.2. Test Runtime Configuration</a></li>
+<li><a href="#sec:Test_Plan">6.2.3. Test Plan</a></li>
+<li><a href="#sec:Test_Environment_Configuration">6.2.4. Test Environment Configuration</a></li>
+<li><a href="#sec:Test_Environment_Configuration_Example">6.2.5. Test Environment Configuration Example</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="help_system.html#_help-system">7. Help System</a>
+<ul class="sectlevel2">
+<li><a href="help_system.html#sec:Built_In_Help">7.1. Built-In Help</a></li>
+<li><a href="help_system.html#sec:Context_Sensitive_Help">7.2. Context Sensitive Help</a></li>
+<li><a href="help_system.html#sec:Cheat_Sheets">7.3. Cheat Sheets</a></li>
+<li><a href="help_system.html#sec:JSDoc">7.4. JSDoc</a></li>
+<li><a href="help_system.html#sec:Hovering">7.5. Hovering</a>
+<ul class="sectlevel3">
+<li><a href="help_system.html#sec:Show_Type_Information_of_Selection">7.5.1. Show Type Information of Selection</a></li>
+</ul>
+</li>
+<li><a href="help_system.html#sec:Example_Projects_and_Files">7.6. Example Projects and Files</a></li>
+</ul>
+</li>
+<li><a href="bug_management.html#_bug-management">8. Bug Management</a>
+<ul class="sectlevel2">
+<li><a href="bug_management.html#sec:Built_In_Xpect_Support">8.1. Built-In Xpect Support</a>
+<ul class="sectlevel3">
+<li><a href="bug_management.html#sec:Report_View">8.1.1. Report View</a></li>
+<li><a href="bug_management.html#sec:Generate_Bug_Report">8.1.2. Generate Bug Report</a></li>
+<li><a href="bug_management.html#sec:Supported_Xpect_Tests">8.1.3. Supported Xpect Tests</a>
+<ul class="sectlevel4">
+<li><a href="bug_management.html#sec:XPECT_N4JS_Errors">8.1.3.1. Errors, Warnings, Infos, Issues</a></li>
+<li><a href="bug_management.html#sec:XPECT_N4JS_Noerrors">8.1.3.2. Noerrors</a></li>
+<li><a href="bug_management.html#sec:XPECT_N4JS_Output">8.1.3.3. Output, OutputRegex</a></li>
+<li><a href="bug_management.html#sec:XPECT_N4JS_Type_Of">8.1.3.4. Type Of</a></li>
+<li><a href="bug_management.html#sec:XPECT_Advanced_Methods">8.1.3.5. Advanced methods</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="cli.html#_cli">9. CLI</a>
+<ul class="sectlevel2">
+<li><a href="cli.html#sec:Headless_Compiler">9.1. Headless Compiler</a></li>
+<li><a href="cli.html#sec:Headless_Dependencies">9.2. Headless Dependnecies</a></li>
+<li><a href="cli.html#sec:Headless_Execution">9.3. Headless Execution</a>
+<ul class="sectlevel3">
+<li><a href="cli.html#sec:Cleaning_Headlessly">9.3.1. Cleaning Headlessly</a></li>
+<li><a href="cli.html#sec:Running_Headlessly">9.3.2. Running Headlessly</a></li>
+<li><a href="cli.html#sec:Information_about_running_headlessly">9.3.3. Information about running headlessly</a></li>
+<li><a href="cli.html#sec:Testing_Headlessly">9.3.4. Testing Headlessly</a></li>
+<li><a href="cli.html#sec:Information_about_testing_headlessly">9.3.5. Information about testing headlessly</a></li>
+<li><a href="cli.html#_testresults">9.3.6. TestResults</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_license.html#sec:License">Appendix A: License</a></li>
+<li><a href="appendix_b_acronyms.html#sec:Acronyms">Appendix B: Acronyms</a></li>
+<li><a href="appendix_c_bibliography.html#_bibliography">Appendix C: Bibliography</a></li>
+</ul>
+</div>
+</div>
+<div id="content"><div class="sect1">
+<h2 id="_test-support"><a class="anchor" href="#_test-support"></a><a class="link" href="#_test-support">6. Test Support</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>N4IDE provides tests support by allowing different <em>TestRunner</em>s to extend it with test specific functionality. This allows to support specialized and very different from each other test requirements (e.g. nodejs based tests, browser based interactive ui tests, server integration tests).</p>
+</div>
+<div id="fig:test_support_diagram" class="imageblock">
+<div class="content">
+<img src="chapters/09_testsupport/fig/cd_testsupport.png" alt="cd testsupport">
+</div>
+<div class="title">Figure 10. Test Support Diagram</div>
+</div>
+<div class="paragraph">
+<p>Explanation of the main components:</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><em>User Project</em></dt>
+<dd>
+<div class="ulist">
+<ul>
+<li>
+<p>a project with production code (e.g. <code>src</code> folder), and test code (e.g. test folder)</p>
+</li>
+<li>
+<p>test code may contain special language features contributed by <em>Test Library</em></p>
+</li>
+</ul>
+</div>
+</dd>
+<dt class="hdlist1"><em>N4IDE</em></dt>
+<dd>
+<div class="ulist">
+<ul>
+<li>
+<p>manage user project, including all test related parts (e.g. support test related code, validate some test code constraints)</p>
+</li>
+<li>
+<p>host runner, allow its UI contributions</p>
+</li>
+</ul>
+</div>
+</dd>
+<dt class="hdlist1"><em>Test Runner</em></dt>
+<dd>
+<div class="ulist">
+<ul>
+<li>
+<p>contribute to N4IDE necessary elements (test results view, user test selection, test start/stop actions)</p>
+</li>
+<li>
+<p>use N4IDE mechanisms to access user project test fragment (e.g. discover tests)</p>
+</li>
+<li>
+<p>configure <em>Test Execution Environment</em></p>
+</li>
+<li>
+<p>manage test runtime (e.g. start/stop execution environment)</p>
+</li>
+</ul>
+</div>
+</dd>
+<dt class="hdlist1"><em>Test Execution Environment</em></dt>
+<dd>
+<div class="ulist">
+<ul>
+<li>
+<p>hosts (directly or indirectly) js engine in which tests are executed</p>
+</li>
+<li>
+<p>executes test library logic</p>
+</li>
+<li>
+<p>is responsible for some tests execution aspects (e.g. test isolation)</p>
+</li>
+<li>
+<p>deals with some execution errors (e.g. no callback from async test, infinite loop in test)</p>
+</li>
+</ul>
+</div>
+</dd>
+<dt class="hdlist1"><em>Test Library</em></dt>
+<dd>
+<div class="ulist">
+<ul>
+<li>
+<p>provides test api that user can use in his project</p>
+</li>
+<li>
+<p>coordinates scheduling and test code execution (e.g. order of tests, execution of setups / teardowns)</p>
+</li>
+<li>
+<p>creates test results</p>
+</li>
+</ul>
+</div>
+</dd>
+</dl>
+</div>
+<div class="paragraph">
+<p>Below picture and listings depicts the components of the Test Runner in the IDE:</p>
+</div>
+<div id="fig:test_runner_components" class="imageblock" style="text-align: center">
+<div class="content">
+<img src="chapters/09_testsupport/fig/test_runner_components.png" alt="test runner components" width="75%">
+</div>
+<div class="title">Figure 11. Test Runner Components</div>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+<em>Test Delegate</em>
+</td>
+<td class="hdlist2">
+<div class="ulist">
+<ul>
+<li>
+<p>After the test discovery it starts and stops the test session via the Test Facade.</p>
+</li>
+</ul>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+<em>Test Facade</em>
+</td>
+<td class="hdlist2">
+<div class="ulist">
+<ul>
+<li>
+<p>Ensures that an embedded HTTP server is running to receive messages from the Test Execution Environment. Registers a test session into the IDE side via the Test Finite State Machine Registry and triggers the actual test running at Test Execution Environment.</p>
+</li>
+</ul>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+<em>HTTP Server</em>
+</td>
+<td class="hdlist2">
+<div class="ulist">
+<ul>
+<li>
+<p>HTTP server is listening for HTTP requests from the Test Execution Environment via its RESTful API.</p>
+</li>
+</ul>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+<em>Resource Router Servlet</em>
+</td>
+<td class="hdlist2">
+<div class="ulist">
+<ul>
+<li>
+<p>This servlet is deployed into the servlet container of the HTTP Server. The servlet percepts the HTTP requests from the Test Execution Environment and delegates the request body to the corresponding REST Endpoint Logic.</p>
+</li>
+</ul>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+<em>REST Endpoint Logic</em>
+</td>
+<td class="hdlist2">
+<div class="ulist">
+<ul>
+<li>
+<p>Parses the HTTP request bodies, creates special events and sends them to all subscribers via the Test Event Bus.</p>
+</li>
+</ul>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+<em>Test Event Bus</em>
+</td>
+<td class="hdlist2">
+<div class="ulist">
+<ul>
+<li>
+<p>This component is used to asynchronously deliver messages between the main test runner components in a decoupled fashion.</p>
+</li>
+</ul>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+<em>Test Finite State Machine Registry</em>
+</td>
+<td class="hdlist2">
+<div class="ulist">
+<ul>
+<li>
+<p>This registry is used to cache test sessions represented as test trees and Test Finite State Machines. Percepts all messages initially sent by the Test Execution Environment and delegates them to the corresponding subscribers.</p>
+</li>
+</ul>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+<em>Test Finite State Machine</em>
+</td>
+<td class="hdlist2">
+<div class="ulist">
+<ul>
+<li>
+<p>Ensures the lifecycle of a test session. Handles timeouts duo to possible communication errors between the HTTP server and the Test Execution Environment.</p>
+</li>
+</ul>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+<em>Test Tree Registry</em>
+</td>
+<td class="hdlist2">
+<div class="ulist">
+<ul>
+<li>
+<p>Registry to handle the state of a test session. Responsible for updating a test tree associated with a test session with the received test results.</p>
+</li>
+</ul>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+<em>Test UI</em>
+</td>
+<td class="hdlist2">
+<div class="ulist">
+<ul>
+<li>
+<p>This UI component provides feedback about the running test session to the end-user.</p>
+</li>
+</ul>
+</div>
+</td>
+</tr>
+</table>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="sec:N4JS_Mangelhaft_support"><a class="anchor" href="#sec:N4JS_Mangelhaft_support"></a><a class="link" href="#sec:N4JS_Mangelhaft_support">6.1. N4JS Mangelhaft support</a></h3>
+<div id="fig:xUnitSupportDesign" class="imageblock center" style="text-align: center">
+<div class="content">
+<img src="chapters/09_testsupport/fig/xUnitSupportDesign.png" alt="xUnitSupportDesign" width="75%">
+</div>
+<div class="title">Figure 12. xUnit Support Design</div>
+</div>
+<div class="paragraph">
+<p>In this section and subsections we specify N4IDE support for testing with Mangelhaft.</p>
+</div>
+<div class="paragraph">
+<p>Mangelhaft is N4JS <em>Test Library</em>. It is focused more on a xUnit tests than other forms of testing (BDD, Acceptance Testing, Functional UI Testing).</p>
+</div>
+<div class="paragraph">
+<p>The following test scenarios are supported on different <em>Test Execution Environment</em>s:</p>
+</div>
+<table id="tab:Test_Scenarios" class="tableblock frame-all grid-all spread">
+<caption class="title">Table 2. Test Scenarios</caption>
+<colgroup>
+<col style="width: 25%;">
+<col style="width: 25%;">
+<col style="width: 25%;">
+<col style="width: 25%;">
+</colgroup>
+<thead>
+<tr>
+<th class="tableblock halign-center valign-top">Test</th>
+<th class="tableblock halign-center valign-top">Node</th>
+<th class="tableblock halign-center valign-top">Browser</th>
+<th class="tableblock halign-center valign-top">Wrapper</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Plain</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>yes</code></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>yes</code></p></td>
+<td class="tableblock halign-center valign-top"></td>
+</tr>
+<tr>
+<th class="tableblock halign-left valign-top"><p class="tableblock">DOM</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>-</code></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>yes</code></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>-</code></p></td>
+</tr>
+<tr>
+<th class="tableblock halign-left valign-top"><p class="tableblock">non-interactive UI</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>-</code></p></td>
+<td class="tableblock halign-center valign-top"></td>
+<td class="tableblock halign-center valign-top"></td>
+</tr>
+<tr>
+<th class="tableblock halign-left valign-top"><p class="tableblock">interactive UI (iUI)</p></th>
+<td class="tableblock halign-center valign-top"></td>
+<td class="tableblock halign-center valign-top"></td>
+<td class="tableblock halign-center valign-top"></td>
+</tr>
+<tr>
+<th class="tableblock halign-left valign-top"><p class="tableblock">(non UI) Server</p></th>
+<td class="tableblock halign-center valign-top"></td>
+<td class="tableblock halign-center valign-top"></td>
+<td class="tableblock halign-center valign-top"></td>
+</tr>
+<tr>
+<th class="tableblock halign-left valign-top"><p class="tableblock">iUI Server</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>-</code></p></td>
+<td class="tableblock halign-center valign-top"></td>
+<td class="tableblock halign-center valign-top"></td>
+</tr>
+</tbody>
+</table>
+<div class="sect3">
+<h4 id="sec:Asynchronous_Tests"><a class="anchor" href="#sec:Asynchronous_Tests"></a><a class="link" href="#sec:Asynchronous_Tests">6.1.1. Asynchronous Tests, Test Isolation and Timeouts</a></h4>
+<div class="paragraph">
+<p>A special problem about JavaScript tests is to control asynchronous tests and non-terminating tests.</p>
+</div>
+<div class="paragraph">
+<p>Performance and test isolation are conflicting goals: a perfect isolation would mean to run every tests by a separate JavaScript engine, which is not performant. For that reason, all tests are run by the same JS-engine in general. A test has to notify the test runner when it has been finished (successfully or with failure). If it does not finish in a defined time (timeout), <em>Test Execution Environment</em> or <em>Manglehaft</em> needs to handle that (e.g. restart node vm in which code is executed)&#8230;&#8203;</p>
+</div>
+<div class="paragraph">
+<p>Main concerns with running test in parallel on js side are:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Timeouts Mangelhaft is supposed to track test timeout. If tests are running in fake parallel mode achieved by cooperative multitasking, then one test running eats up time for other test. This can cause tests to timeout when running in parallel, while succeed when running in sequential mode.</p>
+</li>
+<li>
+<p>Mutability on client. Tests running in parallel can affect each other by mutating global state in which they operate. When they run in sequential mode this can happen too, but it is much less likely to.</p>
+</li>
+<li>
+<p>Mutable state on the server. Tests running on the same session/login are prone to affecting each other through server interaction (and or mutating data on the server).</p>
+</li>
+</ol>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Supported_xUnit_API"><a class="anchor" href="#sec:Supported_xUnit_API"></a><a class="link" href="#sec:Supported_xUnit_API">6.1.2. Supported xUnit API</a></h4>
+<div class="paragraph">
+<p>xUnit API is user facing API for defining tests. It allows test developer to define tests and configure some test execution aspects. N4IDE (via <em>Test Runner</em> extension) supports defined API by :</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>gathering information via AST analysis and reflection</p>
+</li>
+<li>
+<p>presenting user available actions, based on gathered information</p>
+</li>
+<li>
+<p>gathering user input and configurations for test execution</p>
+</li>
+<li>
+<p>generating proper data for test infrastructure, based on user actions</p>
+</li>
+</ul>
+</div>
+<div class="sect4">
+<h5 id="sec:Test_Group"><a class="anchor" href="#sec:Test_Group"></a><a class="link" href="#sec:Test_Group">6.1.2.1. Test Group</a></h5>
+<div class="paragraph">
+<p>A test group is a logical collection of tests. It is created by grouping <code>N4ClassDeclarations</code> that contain test methods or test methods directly (see <a href="#sec:Test_Method">Test Method</a>). Those classes or individual methods can be assigned to a <em>Group</em> by annotating them with <code>@Group</code> annotation. This annotation takes non empty list of strings as parameter. Passed strings are used as category name (which is like its id).</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">Annotation:
+    '@Group'
+    (' $group+=$STRING ')?
+    AnnotatedElement
+;
+
+AnnnotatedElement:
+    N4JSClassDeclaration | N4JSMethodDeclaration
+;</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p><code>@Group</code> properties</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>name &#8594; <code>Group</code></p>
+</li>
+<li>
+<p>targets &#8594; N4Method, N4Class</p>
+</li>
+<li>
+<p>retention policy &#8594; RUNTIME</p>
+</li>
+<li>
+<p>transitive &#8594; YES</p>
+</li>
+<li>
+<p>repeatable &#8594; YES</p>
+</li>
+<li>
+<p>arguments &#8594; <em>String</em>s</p>
+</li>
+<li>
+<p>arguments are optional &#8594; NO</p>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Test_Method"><a class="anchor" href="#sec:Test_Method"></a><a class="link" href="#sec:Test_Method">6.1.2.2. Test Method</a></h5>
+<div class="paragraph">
+<p><em>Test Method</em> marks procedure that has to be executed by <em>Test Library</em>.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">Annotation:
+    '@Test'
+    AnnotatedElement
+;
+
+AnnnotatedElement:
+    N4JSMethodDeclaration
+;</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p><code>@Test</code> properties</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>name &#8594; <code>Test</code></p>
+</li>
+<li>
+<p>targets &#8594; N4Method</p>
+</li>
+<li>
+<p>retention policy &#8594; RUNTIME</p>
+</li>
+<li>
+<p>transitive &#8594; NO</p>
+</li>
+<li>
+<p>repeatable &#8594; NO</p>
+</li>
+<li>
+<p>arguments &#8594; none</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Additional <em>TestMethod</em> constraints:</p>
+</div>
+<div class="paragraph">
+<p>Test Method <a id="cnst:Test_Method"></a></p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>allowed only <code>N4ClassDeclarations</code> in project test fragment</p>
+</li>
+<li>
+<p>method must be public</p>
+</li>
+<li>
+<p>method takes no parameters</p>
+</li>
+<li>
+<p>method return type is <code>Promise?</code></p>
+</li>
+<li>
+<p>method must not be referenced by other owning class members or other classes (also no <em>@override</em>)</p>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:BeforeAll"><a class="anchor" href="#sec:BeforeAll"></a><a class="link" href="#sec:BeforeAll">6.1.2.3. BeforeAll Setup</a></h5>
+<div class="paragraph">
+<p><code>@BeforeAll</code> marks method that will be executed once before <strong>all</strong> tests in a given test class will be executed.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">Annotation:
+    '@BeforeAll'
+    AnnotatedElement
+;
+
+AnnnotatedElement:
+    N4JSMethodDeclaration
+;</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p><code>@BeforeAll</code> properties</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>name &#8594; <code>BeforeAll</code></p>
+</li>
+<li>
+<p>targets &#8594; N4Method</p>
+</li>
+<li>
+<p>retention policy &#8594; RUNTIME</p>
+</li>
+<li>
+<p>transitive &#8594; NO</p>
+</li>
+<li>
+<p>repeatable &#8594; NO</p>
+</li>
+<li>
+<p>arguments &#8594; none</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>The same constraints apply as for the test method, see <a href="#cnst:Test_Method">Test Method Constraints</a>.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Before_Setup"><a class="anchor" href="#sec:Before_Setup"></a><a class="link" href="#sec:Before_Setup">6.1.2.4. Before Setup</a></h5>
+<div class="paragraph">
+<p><code>@Before</code> marks method that will be executed once before <strong>each</strong> tests in a given test class will be executed.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">Annotation:
+    '@Before'
+    AnnotatedElement
+;
+
+AnnnotatedElement:
+    N4JSMethodDeclaration
+;</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p><code>@Before</code> properties</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>name &#8594; <code>Before</code></p>
+</li>
+<li>
+<p>targets &#8594; N4Method</p>
+</li>
+<li>
+<p>retention policy &#8594; RUNTIME</p>
+</li>
+<li>
+<p>transitive &#8594; NO</p>
+</li>
+<li>
+<p>repeatable &#8594; NO</p>
+</li>
+<li>
+<p>arguments &#8594; none</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>The same constraints apply as for the test method, see <a href="#cnst:Test_Method">Test Method Constraints</a>.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:After_Teardown"><a class="anchor" href="#sec:After_Teardown"></a><a class="link" href="#sec:After_Teardown">6.1.2.5. After Teardown</a></h5>
+<div class="paragraph">
+<p><code>@After</code> marks method that will be executed once after <strong>each</strong> tests in a given test class will be executed.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">Annotation:
+    '@After'
+    AnnotatedElement
+;
+
+AnnnotatedElement:
+    N4JSMethodDeclaration
+;</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p><code>@After</code> properties</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>name &#8594; <code>After</code></p>
+</li>
+<li>
+<p>targets &#8594; N4Method</p>
+</li>
+<li>
+<p>retention policy &#8594; RUNTIME</p>
+</li>
+<li>
+<p>transitive &#8594; NO</p>
+</li>
+<li>
+<p>repeatable &#8594; NO</p>
+</li>
+<li>
+<p>arguments &#8594; none</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>The same constraints apply as for the test method, see <a href="#cnst:Test_Method">Test Method Constraints</a>.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:AfterAll_Teardown"><a class="anchor" href="#sec:AfterAll_Teardown"></a><a class="link" href="#sec:AfterAll_Teardown">6.1.2.6. AfterAll Teardown</a></h5>
+<div class="paragraph">
+<p><code>@AfterAll</code> marks method that will be executed once after <strong>all</strong> tests in a given test class will be executed.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">Annotation:
+    '@After'
+    AnnotatedElement
+;
+
+AnnnotatedElement:
+    N4JSMethodDeclaration
+;</code></pre>
+</div>
+</div>
+<div class="ulist Test Fixture][cnst:Test_Fixture">
+<ul class="Test Fixture][cnst:Test_Fixture">
+<li>
+<p>allowed only in class marked with <em>@TestClass</em></p>
+</li>
+<li>
+<p>method must be public</p>
+</li>
+<li>
+<p>method takes no parameters</p>
+</li>
+<li>
+<p>method return type is <code>void</code></p>
+</li>
+<li>
+<p>method must not be referenced by other owning class members</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p><code>@AfterAll</code> properties</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>name &#8594; <code>AfterAll</code></p>
+</li>
+<li>
+<p>targets &#8594; N4Method</p>
+</li>
+<li>
+<p>retention policy &#8594; RUNTIME</p>
+</li>
+<li>
+<p>transitive &#8594; NO</p>
+</li>
+<li>
+<p>repeatable &#8594; NO</p>
+</li>
+<li>
+<p>arguments &#8594; none</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>The same constraints apply as for the test method, see <a href="#cnst:Test_Method">Test Method Constraints</a>.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Test_Ignore"><a class="anchor" href="#sec:Test_Ignore"></a><a class="link" href="#sec:Test_Ignore">6.1.2.7. Test Ignore</a></h5>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+name
+</td>
+<td class="hdlist2">
+<p>@Ignore</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+targets
+</td>
+<td class="hdlist2">
+<p>N4Method, N4Class</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+retention policy
+</td>
+<td class="hdlist2">
+<p>RUNTIME</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+transitive
+</td>
+<td class="hdlist2">
+<p>YES</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+repeatable
+</td>
+<td class="hdlist2">
+<p>NO</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+arguments
+</td>
+<td class="hdlist2">
+<p>String reason</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+arguments are optional
+</td>
+<td class="hdlist2">
+<p>&#8594; Yes</p>
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p><em>Test Ignore</em> allows to mark tests that should be skipped during the test execution. That is the preferred way to temporarily disable tests without removing them (or commenting them out). Test developers may provide reason for skipping to make reason/intentions clearer.</p>
+</div>
+<div class="paragraph">
+<p>This annotation is <em>transitive</em>, which means that: <em>Test Method</em> is considered as marked with <em>Test Skip</em></p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>explicitly when it is directly marked or</p>
+</li>
+<li>
+<p>implicitly, when container of a <em>Test Method</em> is marked.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>If a class is marked as <code>@Ignore</code>, then all its contained test methods will be ignored.<br>
+When <code>@Ignore</code> occurs at class level in a test class hierarchy chain, then the following rules are applied. Assume the following test classes:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">export public class A {
+
+    @Test
+    public aTest(): void {
+        console.log('A#aTest');
+    }
+
+}</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">import { A } from "A"
+
+@Ignore('Class B is ignored.')
+export public class B extends A {
+
+    @Test
+    public b1Test(): void {
+        console.log('B#b1Test');
+    }
+
+    @Ignore("Method B#b2Test is ignored.")
+    @Test
+    public b2Test(): void {
+        console.log("B#b2Test");
+    }
+
+}</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">import { B } from "B"
+
+export public class C extends B {
+
+    @Test
+    public cTest(): void {
+        console.log('C#cTest');
+    }
+
+}</code></pre>
+</div>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>When module <em>A</em> is being tested, then it is obvious that all the test methods of <code>A</code> will be tested. No methods will be skipped at all.</p>
+</li>
+<li>
+<p>When module <em>B</em> is being tested, then although the inherited members of class <code>A</code> will be included in the test tree, all methods, including the inherited ones (from class <code>A</code> from module <em>A</em>) will be skipped. Nothing will be tested.</p>
+</li>
+<li>
+<p>When module <em>C</em> is being tested, then all inherited members from class <code>B</code> and class <code>A</code> will be collected an included in the test tree. The <code>@Ignore</code> annotation declared at class level at <code>B</code> will be ignored but the <code>@Ignore</code> at method level in class <code>B</code> will be considered. In a nutshell, the following methods will be executed:</p>
+<div class="ulist">
+<ul>
+<li>
+<p><code>A#aTest</code></p>
+</li>
+<li>
+<p><code>B#b1Test</code></p>
+</li>
+<li>
+<p><code>C#cTest</code></p>
+</li>
+</ul>
+</div>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>The above described behavior is identical to the behavior of <em>JUnit 4</em> with respect to the <code>@Ignore</code> annotation handling in case of test class inheritance.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Timeout"><a class="anchor" href="#sec:Timeout"></a><a class="link" href="#sec:Timeout">6.1.2.8. Timeout</a></h5>
+<div class="paragraph">
+<p><em>Timeout</em> allows test developer to set custom timeout when executing given test code. This can be used to set timeout for both <em>Test Method</em>s or <em>Test Fixtures</em></p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">Annotation:
+    '@Timeout'
+    ($timoeout+=$INT)?
+    AnnotatedElement
+;
+
+AnnnotatedElement:
+    N4JSClassDeclaration | N4JSMethodDeclaration
+;</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p><code>@Timeout</code> properties</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>name &#8594; <code>Timeout</code></p>
+</li>
+<li>
+<p>targets &#8594; N4Method, N4Class</p>
+</li>
+<li>
+<p>retention policy &#8594; RUNTIME</p>
+</li>
+<li>
+<p>transitive &#8594; YES</p>
+</li>
+<li>
+<p>repeatable &#8594; NO</p>
+</li>
+<li>
+<p>arguments &#8594; Number</p>
+</li>
+<li>
+<p>arguments are optional &#8594; NO</p>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Description"><a class="anchor" href="#sec:Description"></a><a class="link" href="#sec:Description">6.1.2.9. Description</a></h5>
+<div class="paragraph">
+<p><em>Description</em> allows test developer provide string describing given test or test class that <em>can</em> be used in IDE test view or in the test report.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">Annotation:
+    '@Description'
+    ($desc+=$STRING)?
+    AnnotatedElement
+;
+
+AnnnotatedElement:
+    N4JSClassDeclaration | N4JSMethodDeclaration
+;</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p><code>@Description</code> properties</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>name &#8594; <code>Description</code></p>
+</li>
+<li>
+<p>targets &#8594; N4Method, N4Class</p>
+</li>
+<li>
+<p>retention policy &#8594; RUNTIME</p>
+</li>
+<li>
+<p>transitive &#8594; YES</p>
+</li>
+<li>
+<p>arguments &#8594; String</p>
+</li>
+<li>
+<p>arguments are optional &#8594; NO</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="sec:Test_Reporting"><a class="anchor" href="#sec:Test_Reporting"></a><a class="link" href="#sec:Test_Reporting">6.2. Test Reporting</a></h3>
+<div class="paragraph">
+<p><em>Test Runtime Environment</em> communicates with <em>Test Runner</em> over HTTP. Defined communication is based on protocol used between lupenrein and old ide. It is used to send the information about test execution progress from the <em>Test Runtime</em> to <em>Test Runner</em>. Information send by this protocol is not equivalent to test results. <em>Test Runner</em> interprets progress it receives and based on gathered information it generates test results. Under specific conditions <em>Test Runner</em> may change reported test status PASS to test result FAILED and put this information to the test report e.g. when timeout happens (see note on timeouts below).</p>
+</div>
+<div id="fig:sm_TestListener" class="imageblock center" style="text-align: center">
+<div class="content">
+<img src="chapters/09_testsupport/fig/sm_TestListener.png" alt="sm TestListener" width="25%">
+</div>
+<div class="title">Figure 13. TestListener</div>
+</div>
+<div class="paragraph">
+<p><a href="#fig:sm_TestListener">Test Listener</a> shows Communication flow expected by the <em>Test Runner</em>. When the <em>Test Runner</em> is started first it waits for <em>Start Session</em> message. Next <em>Test Tree</em> message is expected. This describes list of all tests that are expected to be executed. For all tests in the list <em>Test Runner</em> expects <em>Test Start</em> and <em>Test End</em> message to be received. <em>End Session</em> is expected to be last message in the test session. <em>Ping</em> message can be send multiple times in between other messages to manage synchronization issues between <em>Test Runner</em> and <em>Test Runtime</em> (see below).</p>
+</div>
+<div class="paragraph">
+<p>Since all communication is asynchronous, IDE <em>Test Runner</em> must assume some timeout values that will define standard wait time during communication:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Initial 90s timeout to wait for the <em>Start Session</em> message. It may be fixed or adjusted to given environment (local/remote) and project (library/application).</p>
+</li>
+<li>
+<p>Default timeout between all other test messages is 10 seconds. <em>Test Runtime</em> may notify IDE <em>Test Runner</em> that it should wait longer with <em>Ping</em> <em>test message</em>. This is one time thing, as soon as another command is received the default timeout will have to be reused again.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Do to the asynchronous nature of the tests, status updates can be given out of order by the Test Runtime Environment. The only sure thing is that all tests begin with <em>SessionStart</em> and ends with a <em>SessionEnd</em>. Furthermore a <em>TestStart</em> will be send before the <em>TestEnd</em> for a particular test.</p>
+</div>
+<div class="sect3">
+<h4 id="sec:Test_Messages"><a class="anchor" href="#sec:Test_Messages"></a><a class="link" href="#sec:Test_Messages">6.2.1. Test Messages</a></h4>
+<div class="paragraph">
+<p>IDE <em>Test Runner</em> will be waiting for specific messages from <em>Test Runtime</em>. We assume that communication will be done over HTTP protocol. <em>Test Execution Environement</em> should be configured by the <em>Test Runner</em> in a way that <em>Test Runtime</em> knows address where it has to send messages (see
+<a href="#sec:Test_Runtime_Configuration">Test Runtime Configuration</a>). <em>Test Runner</em> exposes RESTful API allowing him to receive messages. Below we define parts of that api that enable specific messages to be communicated.</p>
+</div>
+<div class="paragraph">
+<p>When defining <em>Test Message</em>s we assume following model of tests:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">TestTree {
+    ID sessionId,
+    Array&lt;TestSuite&gt;? testSuites
+}
+
+TestSuite {
+    string name,
+    Array&lt;TestCase&gt;? testCases,
+    Array&lt;TestSuite&gt;? children
+}
+
+TestCase {
+    ID id,
+    string className,
+    string origin,
+    string name,
+    string displayName,
+    TestResult? result
+}
+
+TestResult {
+    TestStatus teststatus,
+    number elapsed,
+    string? expected,
+    string? actual,
+    string? message,
+    array&lt;string&gt;? trace
+}
+
+enum TestStatus {
+    PASSED, SKIPPED, FAILED, ERROR
+}
+
+ID {
+    string value
+}</code></pre>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_test-case-ids"><a class="anchor" href="#_test-case-ids"></a><a class="link" href="#_test-case-ids">6.2.1.1. Test Case IDs</a></h5>
+<div class="paragraph">
+<p>The ID of a test case in the following specifications is referred to as <code>testID</code>.
+This ID is of the following structure:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre>testID: fqn '#' methodName</pre>
+</div>
+</div>
+<div class="paragraph">
+<p>When used as part of the URL the testID is percent-escaped as defined in <a href="https://tools.ietf.org/html/rfc3986#section-2.1">RFC3986 Section 2.1</a>. This is necessarry to circumvent the fact that the N4JS FQN delimiter <code>/</code> is a reserved character in URLs and cannot be used in its original form.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Start_Session"><a class="anchor" href="#sec:Start_Session"></a><a class="link" href="#sec:Start_Session">6.2.1.2. Start Session</a></h5>
+<div class="paragraph">
+<p>Signals start of the test session. When user triggers test execution, configures <em>IDETestRunnerCtrl</em>, afterwards IDE <em>Listener</em> waits for this message from <em>TestRunner</em>.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-json" data-lang="json">StartSession :
+    uri : /n4js/testing/sessions/{sessionID}/start
+    method : POST
+    contentType : application/vnd.n4js.start_session_req.tm+json
+    accept: application/json
+    responses:
+        200:
+        400:</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Start session request object MIME type <em>application/vnd.n4js.start_session_req.tm+json</em>:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-json" data-lang="json">{
+    map&lt;string, string&gt;? properties
+}</code></pre>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Ping_Session"><a class="anchor" href="#sec:Ping_Session"></a><a class="link" href="#sec:Ping_Session">6.2.1.3. Ping Session</a></h5>
+<div class="paragraph">
+<p>Signals that test runner is still busy doing things, and will report later to the listener.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-json" data-lang="json">PingSession :
+    uri : /n4js/testing/sessions/{sessionID}/ping
+    method : POST
+    contentType : application/vnd.n4js.ping_session_req.tm+json
+    accept: application/json
+    responses:
+        200:
+        400:</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Ping session request object MIME type <em>application/vnd.n4js.ping_session_req.tm+json</em>:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-json" data-lang="json">{
+    number timeout,
+    string? comment
+}</code></pre>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:End_Session"><a class="anchor" href="#sec:End_Session"></a><a class="link" href="#sec:End_Session">6.2.1.4. End Session</a></h5>
+<div class="paragraph">
+<p>Signals end of test session Notifies IDE <em>Listener</em> that session is finished and no further related <em>TestMessage</em>s are expected. IDE, can stop listening and proceed with its own tasks (e.g. create summary test report ).</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-json" data-lang="json">EndSession :
+    uri : /n4js/testing/sessions/{sessionID}/end
+    method : POST
+    responses:
+        200:
+        400:</code></pre>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Start_Test"><a class="anchor" href="#sec:Start_Test"></a><a class="link" href="#sec:Start_Test">6.2.1.5. Start Test</a></h5>
+<div class="paragraph">
+<p>Signals that a test run has started. Updates the state of the test reported with the <em>tree</em> .</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-json" data-lang="json">StartTest :
+    uri : /n4js/testing/sessions/{sessionID}/tests/{testID}/start
+    method : POST
+    contentType : application/vnd.n4js.start_test_req.tm+json
+    accept: application/json
+    responses:
+        200:
+            contentType : application/vnd.n4js.start_test_res.tm+json
+        400:</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Start test request object MIME type <em>application/vnd.n4js.start_test_req.tm+json</em>:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-json" data-lang="json">{
+    number timeout,
+    map&lt;string, string&gt;? properties
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Start test response object MIME type <em>application/vnd.n4js.start_test_res.tm+json</em>:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-json" data-lang="json">{
+    links : [
+        {
+            rel: "ping test",
+            uri: "/n4js/testing/sessions/{sessionID}/tests/{testID}/ping"
+        },
+        {
+            rel: "end test",
+            uri: "/n4js/testing/sessions/{sessionID}/tests/{testID}/end"
+        }
+    ]
+}</code></pre>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:End_Test"><a class="anchor" href="#sec:End_Test"></a><a class="link" href="#sec:End_Test">6.2.1.6. End Test</a></h5>
+<div class="paragraph">
+<p>Signals that a test run has ended. Updates the state of the test reported with the <em>tree</em> .</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-json" data-lang="json">EndTest :
+    uri : /n4js/testing/sessions/{sessionID}/tests/{testID}/end
+    method : POST
+    contentType : application/vnd.n4js.end_test_req.tm+json
+    accept: application/json
+    responses:
+        200:
+        400:</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>End test request object MIME type <em>application/vnd.n4js.end_test_req.tm+json</em>:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-json" data-lang="json">{
+    TestResult result
+}</code></pre>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Ping_Test"><a class="anchor" href="#sec:Ping_Test"></a><a class="link" href="#sec:Ping_Test">6.2.1.7. Ping Test</a></h5>
+<div class="paragraph">
+<p>Notifies IDE that <em>TestRunner</em> is doing something (e.g. test setup/teardown code, long running test). Without this notification IDE might interpret long pause in received messages as timeout, <em>TestRunner</em> crash or other issues (in consequence it might terminate whole test execution environment).</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-json" data-lang="json">PingTest :
+    uri : /n4js/testing/sessions/{sessionID}/tests/{testID}/ping
+    method : POST
+    contentType : application/vnd.n4js.ping_test_req.tm+json
+    accept: application/json
+    responses:
+        200:
+        400:</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Ping test request object MIME type <em>application/vnd.n4js.ping_test_req.tm+json</em>:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-json" data-lang="json">{
+    number timeout,
+    string? comment
+}</code></pre>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Test_Catalog"><a class="anchor" href="#sec:Test_Catalog"></a><a class="link" href="#sec:Test_Catalog">6.2.1.8. Test Catalog</a></h5>
+<div class="paragraph">
+<p>Assembles and returns with the test catalog representing all the tests available in the underlying <em>IN4JSCore</em> specific workspace. The content of the test catalog is calculated dynamically. The test catalog calculation depends on the current built state of the workspace. If the workspace was cleaned and not built yet, then a test catalog containing zero test suites (and test cases) will be provided as a response. If the workspace is built and in consistent state, then a catalog containing all test cases will be sent as the response body. The provided test catalog format complies to the Mangelhaft reporters.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-json" data-lang="json">TestCatalog :
+    uri : /n4js/testing/sessions/testcatalog
+    method : GET
+    contentType : application/vnd.n4js.assemble_test_catalog_req.tm+json
+    accept: application/json
+    responses:
+        200:
+        400:</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Below listings represents an example of the test catalog format:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-json" data-lang="json">{
+  "endpoint": "http://localhost:9415",
+  "sessionId": "fc3a425c-b675-47d7-8602-8877111cf909",
+  "testDescriptors": [
+    {
+      "origin": "SysProjectA-0.0.1",
+      "fqn": "T/T",
+      "testMethods": [
+        "t"
+      ]
+    },
+    {
+      "origin": "TestProjectA-0.0.1",
+      "fqn": "A/A",
+      "testMethods": [
+        "a"
+      ]
+    },
+    {
+      "origin": "TestProjectA-0.0.1",
+      "fqn": "B/B",
+      "testMethods": [
+        "b1",
+        "b2"
+      ]
+    },
+    {
+      "origin": "TestProjectB-0.0.1",
+      "fqn": "CSub1/CSub1",
+      "testMethods": [
+        "c1",
+        "c2"
+      ]
+    },
+    {
+      "origin": "TestProjectB-0.0.1",
+      "fqn": "CSub2/CSub2",
+      "testMethods": [
+        "c1",
+        "c2",
+        "c3"
+      ]
+    }
+  ]
+}</code></pre>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="sec:Test_Session_Example"><a class="anchor" href="#sec:Test_Session_Example"></a><a class="link" href="#sec:Test_Session_Example">6.2.1.9. Test Session Example</a></h5>
+<div class="paragraph">
+<p>Below example demonstrates what are the expected HTTP requests and JSON structures for a simple test group.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">class A {
+
+    @Test
+    public void foo() {}
+
+    @Test
+    @Ignore
+    public void bar() {}
+}
+
+class B {
+
+    @Test
+    public void baz() {}
+}
+
+class C {
+
+    @Test
+    public void qux() {}
+}</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-json" data-lang="json">Request method: POST
+Request path:   http://localhost:9415/n4js/testing/sessions/19f47a37-c1d1-4cb7-a514-1e131f26ab13/start/
+Headers:        Accept=*/*
+                Content-Type=application/vnd.n4js.start_session_req.tm+json; charset=ISO-8859-1</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-json" data-lang="json">Request method: POST
+Request path:   http://localhost:9415/n4js/testing/sessions/19f47a37-c1d1-4cb7-a514-1e131f26ab13/tests/Test%2FC%23qux/start/
+Headers:        Accept=*/*
+                Content-Type=application/vnd.n4js.start_test_req.tm+json; charset=ISO-8859-1
+Body:
+{
+    "timeout": 1000
+}
+
+
+Request method: POST
+Request path:   http://localhost:9415/n4js/testing/sessions/19f47a37-c1d1-4cb7-a514-1e131f26ab13/tests/Test%2FB%23baz/start/
+Headers:        Accept=*/*
+                Content-Type=application/vnd.n4js.start_test_req.tm+json; charset=ISO-8859-1
+Body:
+{
+    "timeout": 1000
+}
+
+
+Request method: POST
+Request path:   http://localhost:9415/n4js/testing/sessions/19f47a37-c1d1-4cb7-a514-1e131f26ab13/tests/Test%2FA%23bar/start/
+Headers:        Accept=*/*
+                Content-Type=application/vnd.n4js.start_test_req.tm+json; charset=ISO-8859-1
+Body:
+{
+    "timeout": 1000
+}
+
+
+Request method: POST
+Request path:   http://localhost:9415/n4js/testing/sessions/19f47a37-c1d1-4cb7-a514-1e131f26ab13/tests/Test%2FA%23foo/start/
+Headers:        Accept=*/*
+                Content-Type=application/vnd.n4js.start_test_req.tm+json; charset=ISO-8859-1
+Body:
+{
+    "timeout": 1000
+}</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-json" data-lang="json">Request method: POST
+Request path:   http://localhost:9415/n4js/testing/sessions/19f47a37-c1d1-4cb7-a514-1e131f26ab13/tests/Test%2FA%23bar/ping
+Headers:        Accept=*/*
+                Content-Type=application/vnd.n4js.ping_test_req.tm+json; charset=ISO-8859-1
+Body:
+{
+    "timeout": 1000
+}
+
+
+Request method: POST
+Request path:   http://localhost:9415/n4js/testing/sessions/19f47a37-c1d1-4cb7-a514-1e131f26ab13/tests/Test%2FC%23qux/ping/
+Headers:        Accept=*/*
+                Content-Type=application/vnd.n4js.ping_test_req.tm+json; charset=ISO-8859-1
+Body:
+{
+    "timeout": 2000
+}</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-json" data-lang="json">Request method: POST
+Request path:   http://localhost:9415/n4js/testing/sessions/19f47a37-c1d1-4cb7-a514-1e131f26ab13/tests/Test%2FB%23baz/end/
+Headers:        Accept=*/*
+                Content-Type=application/vnd.n4js.end_test_req.tm+json; charset=ISO-8859-1
+Body:
+{
+    "message": "Some optional message.",
+        "trace": [
+        "trace_element_1",
+        "trace_element_2",
+        "trace_element_3"
+    ],
+    "expected": "1",
+    "testStatus": "FAILED",
+    "elapsedTime": 100,
+    "actual": "2"
+}
+
+
+Request method: POST
+Request path:   http://localhost:9415/n4js/testing/sessions/19f47a37-c1d1-4cb7-a514-1e131f26ab13/tests/Test%2FC%23qux/end/
+Headers:        Accept=*/*
+                Content-Type=application/vnd.n4js.end_test_req.tm+json; charset=ISO-8859-1
+Body:
+{
+    "message": "Some failure message.",
+        "trace": [
+        "trace_element_1",
+        "trace_element_2",
+        "trace_element_3"
+    ],
+    "expected": "4",
+    "testStatus": "FAILED",
+    "elapsedTime": 50,
+    "actual": "3"
+}
+
+
+Request method: POST
+Request path:   http://localhost:9415/n4js/testing/sessions/19f47a37-c1d1-4cb7-a514-1e131f26ab13/tests/Test%2F%23foo/end/
+Headers:        Accept=*/*
+                Content-Type=application/vnd.n4js.end_test_req.tm+json; charset=ISO-8859-1
+Body:
+{
+    "expected": "2",
+    "testStatus": "PASSED",
+    "elapsedTime": 60,
+    "actual": "power of 2 for 2"
+}
+
+
+Request method: POST
+Request path:   http://localhost:9415/n4js/testing/sessions/19f47a37-c1d1-4cb7-a514-1e131f26ab13/tests/Test%2FA%23bar/end/
+Headers:        Accept=*/*
+                Content-Type=application/vnd.n4js.end_test_req.tm+json; charset=ISO-8859-1
+Body:
+{
+    "testStatus": "SKIPPED",
+    "elapsedTime": 0,
+}</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-json" data-lang="json">Request method: POST
+Request path:   http://localhost:9415/n4js/testing/sessions/19f47a37-c1d1-4cb7-a514-1e131f26ab13/end/
+Headers:        Accept=*/*
+                Content-Type=application/vnd.n4js.end_session_req.tm+json; charset=ISO-8859-1</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Test_Runtime_Configuration"><a class="anchor" href="#sec:Test_Runtime_Configuration"></a><a class="link" href="#sec:Test_Runtime_Configuration">6.2.2. Test Runtime Configuration</a></h4>
+<div class="paragraph">
+<p><em>Test Runner</em> must gather relevant information and send it to <em>Test Environment</em> to allow proper test execution:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>gathering user input and test options</p>
+</li>
+<li>
+<p>gathering information about user project test code</p>
+</li>
+<li>
+<p>maintaining proper name mappings (e.g. if project is minimized test names/references must be mapped correctly)</p>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Test_Plan"><a class="anchor" href="#sec:Test_Plan"></a><a class="link" href="#sec:Test_Plan">6.2.3. Test Plan</a></h4>
+<div class="paragraph">
+<p><em>Test Runner</em> uses N4IDE infrastructure to obtain information about test fragment of the user project. Based on that information and user input in UI (e.g. triggering test execution on whole project) IDE can determine <em>Test Method</em>s that should be executed. Such test list or <em>Test Plan</em> is send to <em>Test Environment</em> and is expected to be executed by a <em>Test Library</em>.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-json" data-lang="json">TestPlan {
+    Array&lt;TestProcedure&gt; procedures
+}
+
+TestProcedure {
+    string functionName,
+    string functionType,
+    string functionContainer,
+    string containerModule
+}</code></pre>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Test_Environment_Configuration"><a class="anchor" href="#sec:Test_Environment_Configuration"></a><a class="link" href="#sec:Test_Environment_Configuration">6.2.4. Test Environment Configuration</a></h4>
+<div class="paragraph">
+<p>Additionally <em>Test Runner</em> sends to <em>Test Environment</em> other configuration options:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><em>Test Runner</em> test communication protocol base url (<em>baseURL</em>)</p>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Test_Environment_Configuration_Example"><a class="anchor" href="#sec:Test_Environment_Configuration_Example"></a><a class="link" href="#sec:Test_Environment_Configuration_Example">6.2.5. Test Environment Configuration Example</a></h4>
+<div class="paragraph">
+<p>For example assuming that user selects <em>ProjectX</em> to test that contains only one test class in <em>src/test/n4js/core</em> path like:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">class MyTestClass{
+
+    @BeforeAll
+    public void someOneTimeSetup(){ /* setup code */}
+
+    @Test
+    public void testA(){ /* some test code*/ }
+    @Test
+    public void testB(){ /* some test code*/ }
+    @Test
+    public void testC(){ /* some test code*/ }
+
+    @After
+    public void afterCleanup(){ /* setup code */}
+
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Configuration sent for <em>Test Execution Environment</em> would look like:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-json" data-lang="json">{
+    "baseURL" : "http://localhost:1234/",
+    "testPlan":
+        [
+          {
+            "functionName": "someOneTimeSetup",
+            "functionType": "@BeforeAll",
+            "functionContainer": "MyTestClass",
+            "containerModule": "test/n4js/core/MyTestClass",
+          },
+          {
+            "functionName": "testA",
+            "functionType": "@Test",
+            "functionContainer": "MyTestClassA",
+            "containerModule": "test/n4js/core/MyTestClassA",
+          },
+          {
+            "functionName": "afterCleanup",
+            "functionType": "@After",
+            "functionContainer": "MyTestClassA",
+            "containerModule": "test/n4js/core/MyTestClassA",
+          },
+          {
+            "functionName": "testB",
+            "functionType": "@Test",
+            "functionContainer": "MyTestClassA",
+            "containerModule": "test/n4js/core/MyTestClassA",
+          },
+          {
+            "functionName": "afterCleanup",
+            "functionType": "@After",
+            "functionContainer": "MyTestClassA",
+            "containerModule": "test/n4js/core/MyTestClassA",
+          },
+          {
+            "functionName": "testC",
+            "functionType": "@Test",
+            "functionContainer": "MyTestClassA",
+            "containerModule": "test/n4js/core/MyTestClassA",
+          },
+          {
+            "functionName": "afterCleanup",
+            "functionType": "@After",
+            "functionContainer": "MyTestClassA",
+            "containerModule": "test/n4js/core/MyTestClassA",
+          }
+        ]
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div id="footer">
+<div id="footer-text">
+Version 0.9<br>
+Last updated 2019-08-07 15:02:40 CEST
+</div>
+</div>
+<!-- ************* docinfo-footer *************************************************************** -->
+<div class="Grid social" style="color:#d5dfea">
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <h2>Quick Links</h2>
+    <ul>
+      <li><a href="../downloads.html">Download</a></li>
+      <li><a href="../userguides/index.html">Documentation</a></li>
+      <li><a href="https://github.com/eclipse/n4js/">Source</a></li>
+      <li><a href="https://github.com/eclipse/n4js/issues">Issues</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="https://www.eclipse.org/forums/index.php/f/365/">Forum</a></li>
+      <li><a href="http://n4js.blogspot.de/">Blog</a></li>
+      <li><a href="https://dev.eclipse.org/mailman/listinfo/n4js-dev">Mailing List</a></li>
+      <li><a href="https://projects.eclipse.org/projects/technology.n4js">Eclipse Project Page</a></li>
+      <li><a href="https://twitter.com/n4jsdev">Tweets by n4jsdev</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="http://www.eclipse.org/">Eclipse Home</a></li>
+      <li><a href="http://www.eclipse.org/legal/privacy.php">Privacy Policy</a></li>
+      <li><a href="http://www.eclipse.org/legal/termsofuse.php">Terms of Use</a></li>
+      <li><a href="http://www.eclipse.org/legal/copyright.php">Copyright Agent</a></li>
+      <li><a href="http://www.eclipse.org/legal/">Legal</a></li>
+    </ul>
+  </div>
+  <div style="clear: both; height: 0; overflow: hidden;"></div>
+</div>
+
+<!-- ************* UI Scripts ************* -->
+<script type="text/javascript" src="scripts/back-to-top.js"></script>
+
+<script type="text/javascript" src="scripts/treeview.js"></script>
+<script type="text/javascript" src="scripts/toc.js"></script>
+
+<!-- ************* Prism.js Syntax Highlighting ************* -->
+<script src="scripts/prism.js"></script>
+
+<script type="text/javascript">
+	// Add the 'toclist' id for search function
+	$(".toc2 > ul").attr('id', 'toclist');
+	// Generate a Search input form
+	$("#toclist > li:first-of-type").before('<input type="text" id="pagesearch" onkeyup="search()" placeholder="Search for section...">');
+	$("#toclist > li:first-of-type").before('<i id="clear" class="fa fa-times-circle-o"></i>');
+	$("#clear").click(function(){
+	    $("#pagesearch").val('');
+	    search();
+	    $('.toc2 > ul').treeView('collapseAll');
+	});
+	// intialize Treeview.js
+	$(".toc2 > ul").treeView();
+	// Initialize Scrollspy
+</script>
+<!-- ************* docinfo-footer *************************************************************** -->
+</body>
+</html>
\ No newline at end of file
diff --git a/idespec/views.html b/idespec/views.html
new file mode 100644
index 0000000..04aa1c5
--- /dev/null
+++ b/idespec/views.html
@@ -0,0 +1,447 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="generator" content="Asciidoctor 1.5.5">
+<meta name="author" content="2019-08-07 15:02:40 CEST">
+<title>N4JS IDE Specification</title>
+<link rel="stylesheet" href="styles/spec.min.css">
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.6.3/css/font-awesome.min.css">
+<!-- ************* docinfo ******************************************************************* -->
+
+
+<!-- ************* Favicon ************-->
+<link rel="icon" href="images/favicon.ico" />
+
+<!-- ************* Back-to-top JQuery ************* -->
+<script src="https://code.jquery.com/jquery-1.12.4.js"></script>
+<script src="https://code.jquery.com/ui/1.12.0/jquery-ui.js"></script>
+
+
+<link href="styles/prism.min.css" rel="stylesheet" />
+<script type="text/javascript" async
+  src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2/MathJax.js?config=TeX-MML-AM_CHTML">
+</script>
+
+<!-- ************* Styles ************* -->
+<link rel="stylesheet" type="text/css" href="styles/n4jsspec-adoc.css">
+
+
+<!-- ****************** NavBar ****************** -->
+<div id="menubar">
+	<div class="banner">
+        <a href="https://www.eclipse.org/n4js/#"><img id="logo" src="images/n4js-logo.png" alt="Eclipse N4JS"></a>
+    </div>
+<ul>
+  <li><a href="index.html">Index</a></li>
+</ul>
+</div>
+<!-- ************* docinfo ******************************************************************* -->
+<style>
+      .admonitionblock td.icon .icon-todo:before{content:"\f249";color:#f4ee42}
+    </style>
+</head>
+<body class="book toc2 toc-left">
+<div id="header">
+<h1>N4JS IDE Specification</h1>
+<div class="details">
+<span id="author" class="author">2019-08-07 15:02:40 CEST</span><br>
+<span id="revnumber">version 0.9</span>
+</div>
+<div id="toc" class="toc2">
+<div id="toctitle">Table of Contents</div>
+<ul class="sectlevel1">
+<li><a href="#sec:Views">1. Views</a>
+<ul class="sectlevel2">
+<li><a href="#_eclipse-standard-views">1.1. Eclipse Standard Views</a>
+<ul class="sectlevel3">
+<li><a href="#sec:Project_Explorer_View">1.1.1. Project Explorer</a></li>
+<li><a href="#sec:Outline_View">1.1.2. Outline</a></li>
+<li><a href="#sec:Problems_View">1.1.3. Problems</a></li>
+<li><a href="#sec:Console_View">1.1.4. Console</a></li>
+<li><a href="#sec:History_View">1.1.5. History</a></li>
+<li><a href="#sec:Error_Log_View">1.1.6. Error Log</a></li>
+</ul>
+</li>
+<li><a href="#_n4js-specific-views">1.2. N4JS Specific Views</a>
+<ul class="sectlevel3">
+<li><a href="#_test-results">1.2.1. Test Results</a></li>
+<li><a href="#_source-graphs">1.2.2. Source Graphs</a></li>
+<li><a href="#_api-compare">1.2.3. API Compare</a></li>
+<li><a href="#_performance-graphs">1.2.4. Performance Graphs</a></li>
+<li><a href="#_source-mapping">1.2.5. Source Mapping</a></li>
+<li><a href="#_xpect-view">1.2.6. Xpect View</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="navigation.html#_navigation">2. Navigation</a>
+<ul class="sectlevel2">
+<li><a href="navigation.html#sec:Outline_Navigation">2.1. Outline</a>
+<ul class="sectlevel3">
+<li><a href="navigation.html#_quick-outline">2.1.1. Quick Outline</a></li>
+<li><a href="navigation.html#_normal-outline">2.1.2. Normal Outline</a></li>
+</ul>
+</li>
+<li><a href="navigation.html#_navigation-commands">2.2. Navigation Commands</a>
+<ul class="sectlevel3">
+<li><a href="navigation.html#sec:Navigate_to_Declaration">2.2.1. Navigate to Declaration</a></li>
+<li><a href="navigation.html#sec:find_by_references">2.2.2. Find by References</a></li>
+<li><a href="navigation.html#sec:Open_Type_Declaration">2.2.3. Open Type Declaration</a></li>
+</ul>
+</li>
+<li><a href="navigation.html#sec:Working_Sets">2.3. Working Sets</a>
+<ul class="sectlevel3">
+<li><a href="navigation.html#sec:Working_Set_Managers">2.3.1. Working Set Managers</a></li>
+<li><a href="navigation.html#sec:Working_Set_Constraints">2.3.2. Working Set Constraints</a></li>
+<li><a href="navigation.html#sec:Manual_Association_Working_Set_Manager_UI_Features">2.3.3. Manual Association Working Set Manager - UI Features</a></li>
+<li><a href="navigation.html#sec:Project_Name_Filter_Working_Set_Manager">2.3.4. Project Name Filter Working Set Manager</a></li>
+<li><a href="navigation.html#sec:Git_Repository_Working_Set_Manager">2.3.5. Git Repository Working Set Manager</a></li>
+<li><a href="navigation.html#sec:Project_Location_Working_Set_Manager">2.3.6. Project Location Working Set Manager</a></li>
+<li><a href="navigation.html#sec:N4JS_Project_Type_Working_Set_Manager">2.3.7. N4JS Project Type Working Set Manager</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="assistance.html#_assistance">3. Assistance</a>
+<ul class="sectlevel2">
+<li><a href="assistance.html#sec:Content_Assist">3.1. Content Assist</a>
+<ul class="sectlevel3">
+<li><a href="assistance.html#sec:Complete_Keywords">3.1.1. Complete Keywords</a></li>
+<li><a href="assistance.html#sec:Complete_Annotations">3.1.2. Complete Annotations</a></li>
+<li><a href="assistance.html#sec:Complete_Identifier_Reference">3.1.3. Complete Identifier Reference</a></li>
+<li><a href="assistance.html#sec:Complete_Member_Overrides">3.1.4. Complete Member Overrides</a></li>
+<li><a href="assistance.html#sec:Constructor_Completion">3.1.5. Constructor Completion</a></li>
+<li><a href="assistance.html#sec:Complete_Function_Expression">3.1.6. Complete Function Expression with Known Type</a></li>
+<li><a href="assistance.html#sec:Complete_Variable_and_Parameter_Names">3.1.7. Complete Variable and Parameter Names</a></li>
+</ul>
+</li>
+<li><a href="assistance.html#sec:Quick_Fixes">3.2. Quick Fixes</a>
+<ul class="sectlevel3">
+<li><a href="assistance.html#sec:N4JS_Issue_Properties">3.2.1. N4JS Issue User data</a></li>
+<li><a href="assistance.html#sec:N4JS_Issue_Fixes">3.2.2. N4JS Issue Fixes</a>
+<ul class="sectlevel4">
+<li><a href="assistance.html#sec:Linking_Issues">3.2.2.1. Linking Issues</a></li>
+<li><a href="assistance.html#sec:Import_Issues">3.2.2.2. Import Issues</a></li>
+<li><a href="assistance.html#sec:Visibility_Issues">3.2.2.3. Visibility Issues</a></li>
+<li><a href="assistance.html#sec:Classifier_Issues">3.2.2.4. Classifier Issues</a></li>
+<li><a href="assistance.html#sec:Function_Issues">3.2.2.5. Function Issues</a></li>
+<li><a href="assistance.html#sec:Syntax_Issues">3.2.2.6. Syntax Issues</a></li>
+<li><a href="assistance.html#sec:Conversion_Issues">3.2.2.7. Conversion Issues</a></li>
+<li><a href="assistance.html#sec:Type_Issues">3.2.2.8. Type Issues</a></li>
+<li><a href="assistance.html#sec:Expression_Issues">3.2.2.9. Expression Issues</a></li>
+<li><a href="assistance.html#sec:Super_Keyword_Issues">3.2.2.10. Super Keyword Issues</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="assistance.html#sec:Quick_Assist">3.3. Quick Assist</a></li>
+<li><a href="assistance.html#sec:Cleanup_Operations">3.4. Cleanup Operations</a>
+<ul class="sectlevel3">
+<li><a href="assistance.html#sec:Formatting">3.4.1. Formatting</a></li>
+<li><a href="assistance.html#sec:Organize_Imports">3.4.2. Organize Imports</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="wizards.html#_wizards">4. Wizards</a>
+<ul class="sectlevel2">
+<li><a href="wizards.html#sec:N4JS_Project_Wizard">4.1. N4JS Project Wizard</a></li>
+<li><a href="wizards.html#sec:Empty_N4JS_File">4.2. Empty N4JS File</a></li>
+<li><a href="wizards.html#sec:Empty_JS_File">4.3. Empty JS File</a>
+<ul class="sectlevel3">
+<li><a href="wizards.html#sec:N4JS_Class_File_Wizard">4.3.1. N4JS Class Wizard</a></li>
+<li><a href="wizards.html#field-properties">4.3.2. Field Properties</a></li>
+<li><a href="wizards.html#visibility-issues-or-final-super-classes">4.3.3. Visibility issues or <code>@Final</code> super classes</a></li>
+<li><a href="wizards.html#generation-1">4.3.4. Generation</a></li>
+<li><a href="wizards.html#preview-1">4.3.5. Preview</a></li>
+</ul>
+</li>
+<li><a href="wizards.html#sec:N4JS_Interface_Wizard">4.4. Interface Wizard</a>
+<ul class="sectlevel3">
+<li><a href="wizards.html#field-properties-1">4.4.1. Field Properties</a></li>
+<li><a href="wizards.html#visibility-issues">4.4.2. Visibility Issues</a></li>
+<li><a href="wizards.html#import-naming-conflicts">4.4.3. Import naming conflicts</a></li>
+<li><a href="wizards.html#generation-2">4.4.4. Generation</a></li>
+<li><a href="wizards.html#preview-2">4.4.5. Preview</a></li>
+</ul>
+</li>
+<li><a href="wizards.html#sec:N4JS_Enum_File_Wizard">4.5. Enum Wizard</a>
+<ul class="sectlevel3">
+<li><a href="wizards.html#field-properties-2">4.5.1. Field Properties</a></li>
+<li><a href="wizards.html#generation-3">4.5.2. Generation</a></li>
+<li><a href="wizards.html#preview-3">4.5.3. Preview</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="execution_support.html#_execution-support">5. Execution Support</a>
+<ul class="sectlevel2">
+<li><a href="execution_support.html#sec:Non_UI_Execution">5.1. Non-UI Execution</a>
+<ul class="sectlevel3">
+<li><a href="execution_support.html#sec:Non_UI_Debugging">5.1.1. Non-UI Debugging</a></li>
+</ul>
+</li>
+<li><a href="execution_support.html#sec:UI_Execution">5.2. UI Execution</a></li>
+</ul>
+</li>
+<li><a href="test_support.html#_test-support">6. Test Support</a>
+<ul class="sectlevel2">
+<li><a href="test_support.html#sec:N4JS_Mangelhaft_support">6.1. N4JS Mangelhaft support</a>
+<ul class="sectlevel3">
+<li><a href="test_support.html#sec:Asynchronous_Tests">6.1.1. Asynchronous Tests, Test Isolation and Timeouts</a></li>
+<li><a href="test_support.html#sec:Supported_xUnit_API">6.1.2. Supported xUnit API</a>
+<ul class="sectlevel4">
+<li><a href="test_support.html#sec:Test_Group">6.1.2.1. Test Group</a></li>
+<li><a href="test_support.html#sec:Test_Method">6.1.2.2. Test Method</a></li>
+<li><a href="test_support.html#sec:BeforeAll">6.1.2.3. BeforeAll Setup</a></li>
+<li><a href="test_support.html#sec:Before_Setup">6.1.2.4. Before Setup</a></li>
+<li><a href="test_support.html#sec:After_Teardown">6.1.2.5. After Teardown</a></li>
+<li><a href="test_support.html#sec:AfterAll_Teardown">6.1.2.6. AfterAll Teardown</a></li>
+<li><a href="test_support.html#sec:Test_Ignore">6.1.2.7. Test Ignore</a></li>
+<li><a href="test_support.html#sec:Timeout">6.1.2.8. Timeout</a></li>
+<li><a href="test_support.html#sec:Description">6.1.2.9. Description</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="test_support.html#sec:Test_Reporting">6.2. Test Reporting</a>
+<ul class="sectlevel3">
+<li><a href="test_support.html#sec:Test_Messages">6.2.1. Test Messages</a>
+<ul class="sectlevel4">
+<li><a href="test_support.html#_test-case-ids">6.2.1.1. Test Case IDs</a></li>
+<li><a href="test_support.html#sec:Start_Session">6.2.1.2. Start Session</a></li>
+<li><a href="test_support.html#sec:Ping_Session">6.2.1.3. Ping Session</a></li>
+<li><a href="test_support.html#sec:End_Session">6.2.1.4. End Session</a></li>
+<li><a href="test_support.html#sec:Start_Test">6.2.1.5. Start Test</a></li>
+<li><a href="test_support.html#sec:End_Test">6.2.1.6. End Test</a></li>
+<li><a href="test_support.html#sec:Ping_Test">6.2.1.7. Ping Test</a></li>
+<li><a href="test_support.html#sec:Test_Catalog">6.2.1.8. Test Catalog</a></li>
+<li><a href="test_support.html#sec:Test_Session_Example">6.2.1.9. Test Session Example</a></li>
+</ul>
+</li>
+<li><a href="test_support.html#sec:Test_Runtime_Configuration">6.2.2. Test Runtime Configuration</a></li>
+<li><a href="test_support.html#sec:Test_Plan">6.2.3. Test Plan</a></li>
+<li><a href="test_support.html#sec:Test_Environment_Configuration">6.2.4. Test Environment Configuration</a></li>
+<li><a href="test_support.html#sec:Test_Environment_Configuration_Example">6.2.5. Test Environment Configuration Example</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="help_system.html#_help-system">7. Help System</a>
+<ul class="sectlevel2">
+<li><a href="help_system.html#sec:Built_In_Help">7.1. Built-In Help</a></li>
+<li><a href="help_system.html#sec:Context_Sensitive_Help">7.2. Context Sensitive Help</a></li>
+<li><a href="help_system.html#sec:Cheat_Sheets">7.3. Cheat Sheets</a></li>
+<li><a href="help_system.html#sec:JSDoc">7.4. JSDoc</a></li>
+<li><a href="help_system.html#sec:Hovering">7.5. Hovering</a>
+<ul class="sectlevel3">
+<li><a href="help_system.html#sec:Show_Type_Information_of_Selection">7.5.1. Show Type Information of Selection</a></li>
+</ul>
+</li>
+<li><a href="help_system.html#sec:Example_Projects_and_Files">7.6. Example Projects and Files</a></li>
+</ul>
+</li>
+<li><a href="bug_management.html#_bug-management">8. Bug Management</a>
+<ul class="sectlevel2">
+<li><a href="bug_management.html#sec:Built_In_Xpect_Support">8.1. Built-In Xpect Support</a>
+<ul class="sectlevel3">
+<li><a href="bug_management.html#sec:Report_View">8.1.1. Report View</a></li>
+<li><a href="bug_management.html#sec:Generate_Bug_Report">8.1.2. Generate Bug Report</a></li>
+<li><a href="bug_management.html#sec:Supported_Xpect_Tests">8.1.3. Supported Xpect Tests</a>
+<ul class="sectlevel4">
+<li><a href="bug_management.html#sec:XPECT_N4JS_Errors">8.1.3.1. Errors, Warnings, Infos, Issues</a></li>
+<li><a href="bug_management.html#sec:XPECT_N4JS_Noerrors">8.1.3.2. Noerrors</a></li>
+<li><a href="bug_management.html#sec:XPECT_N4JS_Output">8.1.3.3. Output, OutputRegex</a></li>
+<li><a href="bug_management.html#sec:XPECT_N4JS_Type_Of">8.1.3.4. Type Of</a></li>
+<li><a href="bug_management.html#sec:XPECT_Advanced_Methods">8.1.3.5. Advanced methods</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="cli.html#_cli">9. CLI</a>
+<ul class="sectlevel2">
+<li><a href="cli.html#sec:Headless_Compiler">9.1. Headless Compiler</a></li>
+<li><a href="cli.html#sec:Headless_Dependencies">9.2. Headless Dependnecies</a></li>
+<li><a href="cli.html#sec:Headless_Execution">9.3. Headless Execution</a>
+<ul class="sectlevel3">
+<li><a href="cli.html#sec:Cleaning_Headlessly">9.3.1. Cleaning Headlessly</a></li>
+<li><a href="cli.html#sec:Running_Headlessly">9.3.2. Running Headlessly</a></li>
+<li><a href="cli.html#sec:Information_about_running_headlessly">9.3.3. Information about running headlessly</a></li>
+<li><a href="cli.html#sec:Testing_Headlessly">9.3.4. Testing Headlessly</a></li>
+<li><a href="cli.html#sec:Information_about_testing_headlessly">9.3.5. Information about testing headlessly</a></li>
+<li><a href="cli.html#_testresults">9.3.6. TestResults</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_license.html#sec:License">Appendix A: License</a></li>
+<li><a href="appendix_b_acronyms.html#sec:Acronyms">Appendix B: Acronyms</a></li>
+<li><a href="appendix_c_bibliography.html#_bibliography">Appendix C: Bibliography</a></li>
+</ul>
+</div>
+</div>
+<div id="content"><div class="sect1">
+<h2 id="sec:Views"><a class="anchor" href="#sec:Views"></a><a class="link" href="#sec:Views">1. Views</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>This section briefly introduces all the views that belong to the application’s default perspective.</p>
+</div>
+<div class="sect2">
+<h3 id="_eclipse-standard-views"><a class="anchor" href="#_eclipse-standard-views"></a><a class="link" href="#_eclipse-standard-views">1.1. Eclipse Standard Views</a></h3>
+<div class="paragraph">
+<p>In the following we descibe views usually available in Eclipse based IDEs. Some of the views were slightly adjusted to match specific N4JS needs.</p>
+</div>
+<div class="sect3">
+<h4 id="sec:Project_Explorer_View"><a class="anchor" href="#sec:Project_Explorer_View"></a><a class="link" href="#sec:Project_Explorer_View">1.1.1. Project Explorer</a></h4>
+<div class="paragraph">
+<p>The Project Explorer view shows the resources from the underlying workspace in a hierarchical way. From this view one can open a resource for editing in the associated editor or select it to perform an operation on the resource. A popup contest menu is available from the Project Explorer for each resources if used right clicks any of them. A lot of convenient actions are available for from the popping context menu: file modifications (such as Copy, Cut, Paste and Delete) and import/export. Project Explorer support file system modifications by drag-and-dropping resources. One can link the Project Explorer with the editors, if one enables the view-editor-linking then the node in the tree representing a particular resource in the workspace will be automatically revealed and highlighted once one activates the corresponding editor. This works the other way around as well, when a node is selected in the tree and the corresponding resource is opened in an editor, then the editor will be activated.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Outline_View"><a class="anchor" href="#sec:Outline_View"></a><a class="link" href="#sec:Outline_View">1.1.2. Outline</a></h4>
+<div class="paragraph">
+<p>The Outline view is responsible for displaying the outline of a structured file that is currently opened in an editor. In case of opening an N4JS file the view depicts all the types defined in the file. The owned members, functions and methods of a particular type are represented in a tree structure. Furthermore in case of opening an N4JS file in the editor, one can link the Outline view with the editor which means whenever one selects a node from the outline view the corresponding item will be revealed and highlighted in the editor.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Problems_View"><a class="anchor" href="#sec:Problems_View"></a><a class="link" href="#sec:Problems_View">1.1.3. Problems</a></h4>
+<div class="paragraph">
+<p>This view is used to show all validation errors and warnings in a table that are generated for workbench resources such as N4JS files. For instance when one writes and/or saves an N4JS file that contains validation errors and/or warnings those issues will be automatically logged into the Problems view. One can reveal the actual problem in the N4JS by simply double-clicking on the problem in the view. In this case the corresponding N4JS file will be opened (if it was not already opened), activated and the relevant line will be revealed in the editor. By default the grouping in the Problems view is done by the severity of the issues. One can group the issues by issue type or just disable the grouping at all. The first column of the table is the actual description of the issue for a particular resource. The second column names the problematic resource itself. The third column shows the relative path of the problematic resource. The location, fifth, column describes the problematic line in the resource. And last but not least the sixth column is for naming the type of the problem. This is optional and might be missing for some cases. One can customise the content of the view from the view menu. One can limit the number of revealed items in the table or can modify the behaviour of the content provider.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Console_View"><a class="anchor" href="#sec:Console_View"></a><a class="link" href="#sec:Console_View">1.1.4. Console</a></h4>
+<div class="paragraph">
+<p>The Console view is used to reveal a text based output provided by a running process and also allows user to provide any input to the running process from the keyboard.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:History_View"><a class="anchor" href="#sec:History_View"></a><a class="link" href="#sec:History_View">1.1.5. History</a></h4>
+<div class="paragraph">
+<p>History view supports a way to track the changes of the workbench resources. This view also responsible for providing a convenient way to reveal historical revisions of a particular resource and it is even supports a mechanism to compare two different revisions of a resource. By default this view only provides local historical information but if a resource is under version control then one can retrieve revisions for that particular resource even it was made by remotely by another IDE user.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="sec:Error_Log_View"><a class="anchor" href="#sec:Error_Log_View"></a><a class="link" href="#sec:Error_Log_View">1.1.6. Error Log</a></h4>
+<div class="paragraph">
+<p>The Error Log view captures and logs all errors and warnings in a table generated by the application itself. Unlike Problems view the Error Log is responsible to collect and to reveal issues caused by a malfunctioned component or module of the IDE.</p>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_n4js-specific-views"><a class="anchor" href="#_n4js-specific-views"></a><a class="link" href="#_n4js-specific-views">1.2. N4JS Specific Views</a></h3>
+<div class="paragraph">
+<p>The following views are specific to N4JS. Some of these views are useful for developers of the N4JS language itself as they reveal internal details at runtime. Most of these views can be opened via <code>Windows/Show View/Other..</code>, see <code>N4JS</code> category.</p>
+</div>
+<div class="sect3">
+<h4 id="_test-results"><a class="anchor" href="#_test-results"></a><a class="link" href="#_test-results">1.2.1. Test Results</a></h4>
+<div class="paragraph">
+<p>The N4JS equivalent to the JUnit test view.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_source-graphs"><a class="anchor" href="#_source-graphs"></a><a class="link" href="#_source-graphs">1.2.2. Source Graphs</a></h4>
+<div class="paragraph">
+<p>Shows the AST of the current source code in the editor windows.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_api-compare"><a class="anchor" href="#_api-compare"></a><a class="link" href="#_api-compare">1.2.3. API Compare</a></h4>
+<div class="paragraph">
+<p>Shows compare results, i.e. the difference between an API definition project and its implementation.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_performance-graphs"><a class="anchor" href="#_performance-graphs"></a><a class="link" href="#_performance-graphs">1.2.4. Performance Graphs</a></h4>
+<div class="paragraph">
+<p>Shows some performance measurements of typical tasks such as builds.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_source-mapping"><a class="anchor" href="#_source-mapping"></a><a class="link" href="#_source-mapping">1.2.5. Source Mapping</a></h4>
+<div class="paragraph">
+<p>Shows source maps, i.e. the relation between N4JS source code and the generated plain JavaScript code.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_xpect-view"><a class="anchor" href="#_xpect-view"></a><a class="link" href="#_xpect-view">1.2.6. Xpect View</a></h4>
+<div class="paragraph">
+<p>Shows result of an Xpext run, may be used to submit bug reports.</p>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div id="footer">
+<div id="footer-text">
+Version 0.9<br>
+Last updated 2019-08-07 15:02:40 CEST
+</div>
+</div>
+<!-- ************* docinfo-footer *************************************************************** -->
+<div class="Grid social" style="color:#d5dfea">
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <h2>Quick Links</h2>
+    <ul>
+      <li><a href="../downloads.html">Download</a></li>
+      <li><a href="../userguides/index.html">Documentation</a></li>
+      <li><a href="https://github.com/eclipse/n4js/">Source</a></li>
+      <li><a href="https://github.com/eclipse/n4js/issues">Issues</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="https://www.eclipse.org/forums/index.php/f/365/">Forum</a></li>
+      <li><a href="http://n4js.blogspot.de/">Blog</a></li>
+      <li><a href="https://dev.eclipse.org/mailman/listinfo/n4js-dev">Mailing List</a></li>
+      <li><a href="https://projects.eclipse.org/projects/technology.n4js">Eclipse Project Page</a></li>
+      <li><a href="https://twitter.com/n4jsdev">Tweets by n4jsdev</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="http://www.eclipse.org/">Eclipse Home</a></li>
+      <li><a href="http://www.eclipse.org/legal/privacy.php">Privacy Policy</a></li>
+      <li><a href="http://www.eclipse.org/legal/termsofuse.php">Terms of Use</a></li>
+      <li><a href="http://www.eclipse.org/legal/copyright.php">Copyright Agent</a></li>
+      <li><a href="http://www.eclipse.org/legal/">Legal</a></li>
+    </ul>
+  </div>
+  <div style="clear: both; height: 0; overflow: hidden;"></div>
+</div>
+
+<!-- ************* UI Scripts ************* -->
+<script type="text/javascript" src="scripts/back-to-top.js"></script>
+
+<script type="text/javascript" src="scripts/treeview.js"></script>
+<script type="text/javascript" src="scripts/toc.js"></script>
+
+<!-- ************* Prism.js Syntax Highlighting ************* -->
+<script src="scripts/prism.js"></script>
+
+<script type="text/javascript">
+	// Add the 'toclist' id for search function
+	$(".toc2 > ul").attr('id', 'toclist');
+	// Generate a Search input form
+	$("#toclist > li:first-of-type").before('<input type="text" id="pagesearch" onkeyup="search()" placeholder="Search for section...">');
+	$("#toclist > li:first-of-type").before('<i id="clear" class="fa fa-times-circle-o"></i>');
+	$("#clear").click(function(){
+	    $("#pagesearch").val('');
+	    search();
+	    $('.toc2 > ul').treeView('collapseAll');
+	});
+	// intialize Treeview.js
+	$(".toc2 > ul").treeView();
+	// Initialize Scrollspy
+</script>
+<!-- ************* docinfo-footer *************************************************************** -->
+</body>
+</html>
\ No newline at end of file
diff --git a/idespec/wizards.html b/idespec/wizards.html
new file mode 100644
index 0000000..7749005
--- /dev/null
+++ b/idespec/wizards.html
@@ -0,0 +1,1381 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="generator" content="Asciidoctor 1.5.5">
+<meta name="author" content="2019-08-07 15:02:40 CEST">
+<title>N4JS IDE Specification</title>
+<link rel="stylesheet" href="styles/spec.min.css">
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.6.3/css/font-awesome.min.css">
+<!-- ************* docinfo ******************************************************************* -->
+
+
+<!-- ************* Favicon ************-->
+<link rel="icon" href="images/favicon.ico" />
+
+<!-- ************* Back-to-top JQuery ************* -->
+<script src="https://code.jquery.com/jquery-1.12.4.js"></script>
+<script src="https://code.jquery.com/ui/1.12.0/jquery-ui.js"></script>
+
+
+<link href="styles/prism.min.css" rel="stylesheet" />
+<script type="text/javascript" async
+  src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2/MathJax.js?config=TeX-MML-AM_CHTML">
+</script>
+
+<!-- ************* Styles ************* -->
+<link rel="stylesheet" type="text/css" href="styles/n4jsspec-adoc.css">
+
+
+<!-- ****************** NavBar ****************** -->
+<div id="menubar">
+	<div class="banner">
+        <a href="https://www.eclipse.org/n4js/#"><img id="logo" src="images/n4js-logo.png" alt="Eclipse N4JS"></a>
+    </div>
+<ul>
+  <li><a href="index.html">Index</a></li>
+</ul>
+</div>
+<!-- ************* docinfo ******************************************************************* -->
+<style>
+      .admonitionblock td.icon .icon-todo:before{content:"\f249";color:#f4ee42}
+    </style>
+</head>
+<body class="book toc2 toc-left">
+<div id="header">
+<h1>N4JS IDE Specification</h1>
+<div class="details">
+<span id="author" class="author">2019-08-07 15:02:40 CEST</span><br>
+<span id="revnumber">version 0.9</span>
+</div>
+<div id="toc" class="toc2">
+<div id="toctitle">Table of Contents</div>
+<ul class="sectlevel1">
+<li><a href="views.html#sec:Views">1. Views</a>
+<ul class="sectlevel2">
+<li><a href="views.html#_eclipse-standard-views">1.1. Eclipse Standard Views</a>
+<ul class="sectlevel3">
+<li><a href="views.html#sec:Project_Explorer_View">1.1.1. Project Explorer</a></li>
+<li><a href="views.html#sec:Outline_View">1.1.2. Outline</a></li>
+<li><a href="views.html#sec:Problems_View">1.1.3. Problems</a></li>
+<li><a href="views.html#sec:Console_View">1.1.4. Console</a></li>
+<li><a href="views.html#sec:History_View">1.1.5. History</a></li>
+<li><a href="views.html#sec:Error_Log_View">1.1.6. Error Log</a></li>
+</ul>
+</li>
+<li><a href="views.html#_n4js-specific-views">1.2. N4JS Specific Views</a>
+<ul class="sectlevel3">
+<li><a href="views.html#_test-results">1.2.1. Test Results</a></li>
+<li><a href="views.html#_source-graphs">1.2.2. Source Graphs</a></li>
+<li><a href="views.html#_api-compare">1.2.3. API Compare</a></li>
+<li><a href="views.html#_performance-graphs">1.2.4. Performance Graphs</a></li>
+<li><a href="views.html#_source-mapping">1.2.5. Source Mapping</a></li>
+<li><a href="views.html#_xpect-view">1.2.6. Xpect View</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="navigation.html#_navigation">2. Navigation</a>
+<ul class="sectlevel2">
+<li><a href="navigation.html#sec:Outline_Navigation">2.1. Outline</a>
+<ul class="sectlevel3">
+<li><a href="navigation.html#_quick-outline">2.1.1. Quick Outline</a></li>
+<li><a href="navigation.html#_normal-outline">2.1.2. Normal Outline</a></li>
+</ul>
+</li>
+<li><a href="navigation.html#_navigation-commands">2.2. Navigation Commands</a>
+<ul class="sectlevel3">
+<li><a href="navigation.html#sec:Navigate_to_Declaration">2.2.1. Navigate to Declaration</a></li>
+<li><a href="navigation.html#sec:find_by_references">2.2.2. Find by References</a></li>
+<li><a href="navigation.html#sec:Open_Type_Declaration">2.2.3. Open Type Declaration</a></li>
+</ul>
+</li>
+<li><a href="navigation.html#sec:Working_Sets">2.3. Working Sets</a>
+<ul class="sectlevel3">
+<li><a href="navigation.html#sec:Working_Set_Managers">2.3.1. Working Set Managers</a></li>
+<li><a href="navigation.html#sec:Working_Set_Constraints">2.3.2. Working Set Constraints</a></li>
+<li><a href="navigation.html#sec:Manual_Association_Working_Set_Manager_UI_Features">2.3.3. Manual Association Working Set Manager - UI Features</a></li>
+<li><a href="navigation.html#sec:Project_Name_Filter_Working_Set_Manager">2.3.4. Project Name Filter Working Set Manager</a></li>
+<li><a href="navigation.html#sec:Git_Repository_Working_Set_Manager">2.3.5. Git Repository Working Set Manager</a></li>
+<li><a href="navigation.html#sec:Project_Location_Working_Set_Manager">2.3.6. Project Location Working Set Manager</a></li>
+<li><a href="navigation.html#sec:N4JS_Project_Type_Working_Set_Manager">2.3.7. N4JS Project Type Working Set Manager</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="assistance.html#_assistance">3. Assistance</a>
+<ul class="sectlevel2">
+<li><a href="assistance.html#sec:Content_Assist">3.1. Content Assist</a>
+<ul class="sectlevel3">
+<li><a href="assistance.html#sec:Complete_Keywords">3.1.1. Complete Keywords</a></li>
+<li><a href="assistance.html#sec:Complete_Annotations">3.1.2. Complete Annotations</a></li>
+<li><a href="assistance.html#sec:Complete_Identifier_Reference">3.1.3. Complete Identifier Reference</a></li>
+<li><a href="assistance.html#sec:Complete_Member_Overrides">3.1.4. Complete Member Overrides</a></li>
+<li><a href="assistance.html#sec:Constructor_Completion">3.1.5. Constructor Completion</a></li>
+<li><a href="assistance.html#sec:Complete_Function_Expression">3.1.6. Complete Function Expression with Known Type</a></li>
+<li><a href="assistance.html#sec:Complete_Variable_and_Parameter_Names">3.1.7. Complete Variable and Parameter Names</a></li>
+</ul>
+</li>
+<li><a href="assistance.html#sec:Quick_Fixes">3.2. Quick Fixes</a>
+<ul class="sectlevel3">
+<li><a href="assistance.html#sec:N4JS_Issue_Properties">3.2.1. N4JS Issue User data</a></li>
+<li><a href="assistance.html#sec:N4JS_Issue_Fixes">3.2.2. N4JS Issue Fixes</a>
+<ul class="sectlevel4">
+<li><a href="assistance.html#sec:Linking_Issues">3.2.2.1. Linking Issues</a></li>
+<li><a href="assistance.html#sec:Import_Issues">3.2.2.2. Import Issues</a></li>
+<li><a href="assistance.html#sec:Visibility_Issues">3.2.2.3. Visibility Issues</a></li>
+<li><a href="assistance.html#sec:Classifier_Issues">3.2.2.4. Classifier Issues</a></li>
+<li><a href="assistance.html#sec:Function_Issues">3.2.2.5. Function Issues</a></li>
+<li><a href="assistance.html#sec:Syntax_Issues">3.2.2.6. Syntax Issues</a></li>
+<li><a href="assistance.html#sec:Conversion_Issues">3.2.2.7. Conversion Issues</a></li>
+<li><a href="assistance.html#sec:Type_Issues">3.2.2.8. Type Issues</a></li>
+<li><a href="assistance.html#sec:Expression_Issues">3.2.2.9. Expression Issues</a></li>
+<li><a href="assistance.html#sec:Super_Keyword_Issues">3.2.2.10. Super Keyword Issues</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="assistance.html#sec:Quick_Assist">3.3. Quick Assist</a></li>
+<li><a href="assistance.html#sec:Cleanup_Operations">3.4. Cleanup Operations</a>
+<ul class="sectlevel3">
+<li><a href="assistance.html#sec:Formatting">3.4.1. Formatting</a></li>
+<li><a href="assistance.html#sec:Organize_Imports">3.4.2. Organize Imports</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#_wizards">4. Wizards</a>
+<ul class="sectlevel2">
+<li><a href="#sec:N4JS_Project_Wizard">4.1. N4JS Project Wizard</a></li>
+<li><a href="#sec:Empty_N4JS_File">4.2. Empty N4JS File</a></li>
+<li><a href="#sec:Empty_JS_File">4.3. Empty JS File</a>
+<ul class="sectlevel3">
+<li><a href="#sec:N4JS_Class_File_Wizard">4.3.1. N4JS Class Wizard</a></li>
+<li><a href="#field-properties">4.3.2. Field Properties</a></li>
+<li><a href="#visibility-issues-or-final-super-classes">4.3.3. Visibility issues or <code>@Final</code> super classes</a></li>
+<li><a href="#generation-1">4.3.4. Generation</a></li>
+<li><a href="#preview-1">4.3.5. Preview</a></li>
+</ul>
+</li>
+<li><a href="#sec:N4JS_Interface_Wizard">4.4. Interface Wizard</a>
+<ul class="sectlevel3">
+<li><a href="#field-properties-1">4.4.1. Field Properties</a></li>
+<li><a href="#visibility-issues">4.4.2. Visibility Issues</a></li>
+<li><a href="#import-naming-conflicts">4.4.3. Import naming conflicts</a></li>
+<li><a href="#generation-2">4.4.4. Generation</a></li>
+<li><a href="#preview-2">4.4.5. Preview</a></li>
+</ul>
+</li>
+<li><a href="#sec:N4JS_Enum_File_Wizard">4.5. Enum Wizard</a>
+<ul class="sectlevel3">
+<li><a href="#field-properties-2">4.5.1. Field Properties</a></li>
+<li><a href="#generation-3">4.5.2. Generation</a></li>
+<li><a href="#preview-3">4.5.3. Preview</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="execution_support.html#_execution-support">5. Execution Support</a>
+<ul class="sectlevel2">
+<li><a href="execution_support.html#sec:Non_UI_Execution">5.1. Non-UI Execution</a>
+<ul class="sectlevel3">
+<li><a href="execution_support.html#sec:Non_UI_Debugging">5.1.1. Non-UI Debugging</a></li>
+</ul>
+</li>
+<li><a href="execution_support.html#sec:UI_Execution">5.2. UI Execution</a></li>
+</ul>
+</li>
+<li><a href="test_support.html#_test-support">6. Test Support</a>
+<ul class="sectlevel2">
+<li><a href="test_support.html#sec:N4JS_Mangelhaft_support">6.1. N4JS Mangelhaft support</a>
+<ul class="sectlevel3">
+<li><a href="test_support.html#sec:Asynchronous_Tests">6.1.1. Asynchronous Tests, Test Isolation and Timeouts</a></li>
+<li><a href="test_support.html#sec:Supported_xUnit_API">6.1.2. Supported xUnit API</a>
+<ul class="sectlevel4">
+<li><a href="test_support.html#sec:Test_Group">6.1.2.1. Test Group</a></li>
+<li><a href="test_support.html#sec:Test_Method">6.1.2.2. Test Method</a></li>
+<li><a href="test_support.html#sec:BeforeAll">6.1.2.3. BeforeAll Setup</a></li>
+<li><a href="test_support.html#sec:Before_Setup">6.1.2.4. Before Setup</a></li>
+<li><a href="test_support.html#sec:After_Teardown">6.1.2.5. After Teardown</a></li>
+<li><a href="test_support.html#sec:AfterAll_Teardown">6.1.2.6. AfterAll Teardown</a></li>
+<li><a href="test_support.html#sec:Test_Ignore">6.1.2.7. Test Ignore</a></li>
+<li><a href="test_support.html#sec:Timeout">6.1.2.8. Timeout</a></li>
+<li><a href="test_support.html#sec:Description">6.1.2.9. Description</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="test_support.html#sec:Test_Reporting">6.2. Test Reporting</a>
+<ul class="sectlevel3">
+<li><a href="test_support.html#sec:Test_Messages">6.2.1. Test Messages</a>
+<ul class="sectlevel4">
+<li><a href="test_support.html#_test-case-ids">6.2.1.1. Test Case IDs</a></li>
+<li><a href="test_support.html#sec:Start_Session">6.2.1.2. Start Session</a></li>
+<li><a href="test_support.html#sec:Ping_Session">6.2.1.3. Ping Session</a></li>
+<li><a href="test_support.html#sec:End_Session">6.2.1.4. End Session</a></li>
+<li><a href="test_support.html#sec:Start_Test">6.2.1.5. Start Test</a></li>
+<li><a href="test_support.html#sec:End_Test">6.2.1.6. End Test</a></li>
+<li><a href="test_support.html#sec:Ping_Test">6.2.1.7. Ping Test</a></li>
+<li><a href="test_support.html#sec:Test_Catalog">6.2.1.8. Test Catalog</a></li>
+<li><a href="test_support.html#sec:Test_Session_Example">6.2.1.9. Test Session Example</a></li>
+</ul>
+</li>
+<li><a href="test_support.html#sec:Test_Runtime_Configuration">6.2.2. Test Runtime Configuration</a></li>
+<li><a href="test_support.html#sec:Test_Plan">6.2.3. Test Plan</a></li>
+<li><a href="test_support.html#sec:Test_Environment_Configuration">6.2.4. Test Environment Configuration</a></li>
+<li><a href="test_support.html#sec:Test_Environment_Configuration_Example">6.2.5. Test Environment Configuration Example</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="help_system.html#_help-system">7. Help System</a>
+<ul class="sectlevel2">
+<li><a href="help_system.html#sec:Built_In_Help">7.1. Built-In Help</a></li>
+<li><a href="help_system.html#sec:Context_Sensitive_Help">7.2. Context Sensitive Help</a></li>
+<li><a href="help_system.html#sec:Cheat_Sheets">7.3. Cheat Sheets</a></li>
+<li><a href="help_system.html#sec:JSDoc">7.4. JSDoc</a></li>
+<li><a href="help_system.html#sec:Hovering">7.5. Hovering</a>
+<ul class="sectlevel3">
+<li><a href="help_system.html#sec:Show_Type_Information_of_Selection">7.5.1. Show Type Information of Selection</a></li>
+</ul>
+</li>
+<li><a href="help_system.html#sec:Example_Projects_and_Files">7.6. Example Projects and Files</a></li>
+</ul>
+</li>
+<li><a href="bug_management.html#_bug-management">8. Bug Management</a>
+<ul class="sectlevel2">
+<li><a href="bug_management.html#sec:Built_In_Xpect_Support">8.1. Built-In Xpect Support</a>
+<ul class="sectlevel3">
+<li><a href="bug_management.html#sec:Report_View">8.1.1. Report View</a></li>
+<li><a href="bug_management.html#sec:Generate_Bug_Report">8.1.2. Generate Bug Report</a></li>
+<li><a href="bug_management.html#sec:Supported_Xpect_Tests">8.1.3. Supported Xpect Tests</a>
+<ul class="sectlevel4">
+<li><a href="bug_management.html#sec:XPECT_N4JS_Errors">8.1.3.1. Errors, Warnings, Infos, Issues</a></li>
+<li><a href="bug_management.html#sec:XPECT_N4JS_Noerrors">8.1.3.2. Noerrors</a></li>
+<li><a href="bug_management.html#sec:XPECT_N4JS_Output">8.1.3.3. Output, OutputRegex</a></li>
+<li><a href="bug_management.html#sec:XPECT_N4JS_Type_Of">8.1.3.4. Type Of</a></li>
+<li><a href="bug_management.html#sec:XPECT_Advanced_Methods">8.1.3.5. Advanced methods</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="cli.html#_cli">9. CLI</a>
+<ul class="sectlevel2">
+<li><a href="cli.html#sec:Headless_Compiler">9.1. Headless Compiler</a></li>
+<li><a href="cli.html#sec:Headless_Dependencies">9.2. Headless Dependnecies</a></li>
+<li><a href="cli.html#sec:Headless_Execution">9.3. Headless Execution</a>
+<ul class="sectlevel3">
+<li><a href="cli.html#sec:Cleaning_Headlessly">9.3.1. Cleaning Headlessly</a></li>
+<li><a href="cli.html#sec:Running_Headlessly">9.3.2. Running Headlessly</a></li>
+<li><a href="cli.html#sec:Information_about_running_headlessly">9.3.3. Information about running headlessly</a></li>
+<li><a href="cli.html#sec:Testing_Headlessly">9.3.4. Testing Headlessly</a></li>
+<li><a href="cli.html#sec:Information_about_testing_headlessly">9.3.5. Information about testing headlessly</a></li>
+<li><a href="cli.html#_testresults">9.3.6. TestResults</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_license.html#sec:License">Appendix A: License</a></li>
+<li><a href="appendix_b_acronyms.html#sec:Acronyms">Appendix B: Acronyms</a></li>
+<li><a href="appendix_c_bibliography.html#_bibliography">Appendix C: Bibliography</a></li>
+</ul>
+</div>
+</div>
+<div id="content"><div class="sect1">
+<h2 id="_wizards"><a class="anchor" href="#_wizards"></a><a class="link" href="#_wizards">4. Wizards</a></h2>
+<div class="sectionbody">
+<div class="admonitionblock warning">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-warning" title=""></i>
+</td>
+<td class="content">
+Some descriptions may be outdated.
+</td>
+</tr>
+</table>
+</div>
+<div class="admonitionblock warning">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-warning" title=""></i>
+</td>
+<td class="content">
+All requirement sections are not linked to real issues. They were left here as an example and to complete the issues.
+</td>
+</tr>
+</table>
+</div>
+<div class="sect2">
+<h3 id="sec:N4JS_Project_Wizard"><a class="anchor" href="#sec:N4JS_Project_Wizard"></a><a class="link" href="#sec:N4JS_Project_Wizard">4.1. N4JS Project Wizard</a></h3>
+<div class="paragraph">
+<p>Wizard creates a new N4JS project.</p>
+</div>
+<div class="paragraph">
+<p>The following information is to be specified by the user:</p>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Project Name
+</td>
+<td class="hdlist2">
+<p>string, name of project</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Default Location
+</td>
+<td class="hdlist2">
+<p>boolean, true by default</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Location
+</td>
+<td class="hdlist2">
+<p>string, computed default location, if user set location then default location flag must be false</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Project Type
+</td>
+<td class="hdlist2">
+<p>enumeration, the type of the new project</p>
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>The following files are to be created:</p>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Project Folder
+</td>
+<td class="hdlist2">
+<p>with name of project at given location</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Manifest
+</td>
+<td class="hdlist2">
+<p>with default project structure and name</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Source Folder
+</td>
+<td class="hdlist2">
+<p>default source folder (src)</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Output Folder
+</td>
+<td class="hdlist2">
+<p>default source folder (src-gen)</p>
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect2">
+<h3 id="sec:Empty_N4JS_File"><a class="anchor" href="#sec:Empty_N4JS_File"></a><a class="link" href="#sec:Empty_N4JS_File">4.2. Empty N4JS File</a></h3>
+<div class="paragraph">
+<p>The following information is to be specified by the user:</p>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Package Name
+</td>
+<td class="hdlist2">
+<p>dot separated name of the package, empty by default (or set to the package/folder selected in the navigator)</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Module Name
+</td>
+<td class="hdlist2">
+<p>string, name of the module – must be a valid module name without extension</p>
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>The following files are to be created:</p>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Package Folder(s)
+</td>
+<td class="hdlist2">
+<p>if folders representing package structure do not exist, they are to be created</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Module File
+</td>
+<td class="hdlist2">
+<p>empty file with name of module and extension <code>n4js</code>  in the appropriate package folder</p>
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect2">
+<h3 id="sec:Empty_JS_File"><a class="anchor" href="#sec:Empty_JS_File"></a><a class="link" href="#sec:Empty_JS_File">4.3. Empty JS File</a></h3>
+<div class="paragraph">
+<p>Similar to <a href="#sec:Empty_N4JS_File">Empty N4JS File</a> but with the file extension <code>js</code>.</p>
+</div>
+<div class="sect3">
+<h4 id="sec:N4JS_Class_File_Wizard"><a class="anchor" href="#sec:N4JS_Class_File_Wizard"></a><a class="link" href="#sec:N4JS_Class_File_Wizard">4.3.1. N4JS Class Wizard</a></h4>
+<div class="paragraph">
+<p>It is recommended to define a single classifier in a file, the name of the classifier should have the same name as the file. Based on that assumption, file wizards are provided for N4JS classes, interfaces and enumerations.</p>
+</div>
+<div class="imageblock center">
+<div class="content">
+<img src="chapters/06_wizards/fig/newclasswizard.png" alt="newclasswizard">
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="field-properties"><a class="anchor" href="#field-properties"></a><a class="link" href="#field-properties">4.3.2. Field Properties</a></h4>
+<div class="paragraph">
+<p><a id="Class_File_Wizard-Project_Field"></a> The New N4JS Class wizard offers following fields:</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Project</dt>
+<dd>
+<p>Specifies the containing project.</p>
+</dd>
+</dl>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-GH-1413"></a><strong>Req. GH-1413:</strong> <a href="#Req-GH-1413">Project constraints</a> (ver. 1)</p>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Constraints
+</td>
+<td class="hdlist2">
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>It is a path of a valid project in the current workspace</p>
+</li>
+<li>
+<p>This field must not be empty</p>
+</li>
+</ol>
+</div>
+</td>
+</tr>
+</table>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-GH-1413"></a><strong>Req. GH-1413:</strong> <a href="#Req-GH-1413">Project browse button</a> (ver. 1)</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Browse Button</dt>
+<dd>
+<p>Browsing only allows the selection of projects in the current workspace. Project creation is not possible.</p>
+</dd>
+</dl>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-GH-1413"></a><strong>Req. GH-1413:</strong> <a href="#Req-GH-1413">Project initial selection inference</a> (ver. 1)</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Initial selection</dt>
+<dd>
+<p>The project should be derived from the initial selection.</p>
+</dd>
+</dl>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-GH-1413"></a><strong>Req. GH-1413:</strong> <a href="#Req-GH-1413">Project content assist</a> (ver. 1)</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Content Assist</dt>
+<dd>
+<p>Workspace projects</p>
+</dd>
+</dl>
+</div>
+</div>
+</div>
+<div id="Class_File_Wizard-Source_Folder_Field" class="dlist">
+<dl>
+<dt class="hdlist1">Source folder</dt>
+<dd>
+<p>Specifies the containing source folder.</p>
+</dd>
+</dl>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-GH-1413"></a><strong>Req. GH-1413:</strong> <a href="#Req-GH-1413">Source folder constraints</a> (ver. 1)</p>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Constraints
+</td>
+<td class="hdlist2">
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>The folder is listed as source folder in the project manifest</p>
+</li>
+<li>
+<p>This field must not be empty.</p>
+</li>
+<li>
+<p>The name is a valid path that means each segment of the path matches the following expression:</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-ebnf" data-lang="ebnf">[a-zA-z_](([\\.][a-zA-z_0-9\\-])|[a-zA-z_0-9\\-])*</code></pre>
+</div>
+</div>
+</li>
+</ol>
+</div>
+</td>
+</tr>
+</table>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-GH-1413"></a><strong>Req. GH-1413:</strong> <a href="#Req-GH-1413">Source folder browse button</a> (ver. 1)</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Browse Button</dt>
+<dd>
+<p>Browsing only allows the selection of source folders in the selected project. The dialog should provide a list of all source folders of the selected project. This includes nested source folders. A list element is a relative path of a source folder in the project.</p>
+</dd>
+</dl>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-GH-1413"></a><strong>Req. GH-1413:</strong> <a href="#Req-GH-1413">Source folder initial selection inference</a> (ver. 1)</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Initial selection</dt>
+<dd>
+<p>The source folder field should be derived from the initial selection</p>
+</dd>
+</dl>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-GH-1413"></a><strong>Req. GH-1413:</strong> <a href="#Req-GH-1413">Source folder content assist</a> (ver. 1)</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Content Assist</dt>
+<dd>
+<p>source folders defined by the project manifest</p>
+</dd>
+</dl>
+</div>
+</div>
+</div>
+<div id="Class_File_Wizard-Module_Specifier_Field" class="dlist">
+<dl>
+<dt class="hdlist1">Module specifier</dt>
+<dd>
+<p>Specifies the module specifier. May only specify a module container (a folder) but could also include module name. May also be an already existing module. Does not include the file extension.</p>
+</dd>
+</dl>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-GH-1413"></a><strong>Req. GH-1413:</strong> <a href="#Req-GH-1413">Module specifier constraints</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>The specifier is a valid module specifier that is
+- Segments are separated by the path separator
+- No separator at the beginning or end</p>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-GH-1413"></a><strong>Req. GH-1413:</strong> <a href="#Req-GH-1413">Module specifier completion</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>Manually inserting a specifier ending with a separator is valid.
+It is then interpreted as base path for the full module specifier automatically completed by the class name. (cf. grey suffix)</p>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-GH-1413"></a><strong>Req. GH-1413:</strong> <a href="#Req-GH-1413">Module specifier grey suffix</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>A grey suffix should suggest the attached class name as module name if the specifier only specifies a base path.</p>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-GH-1413"></a><strong>Req. GH-1413:</strong> <a href="#Req-GH-1413">Module specifier browse button</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>Browsing only allows the selection of modules or module containers in the selected source folder. The browse dialog has to offer a module container creation functionality. In contrast to the other parts of the wizard, the creation of module containers in this dialog should be immediate and on file system level. This is important to comply with the conceptual model of eclipse and the operating system.</p>
+</div>
+<div class="paragraph">
+<p>When inserting a non-existent path in the text input and opening the browse dialog, an additional dialog should ask the user whether he wants to create this structure on the file system. If he denies, the dialog shows the selection to the level it already exists on the file system.</p>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-GH-1413"></a><strong>Req. GH-1413:</strong> <a href="#Req-GH-1413">Module specifier initial selection inference</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>The module specifier should be derived from the initial selection by using the container of the selection as initial module container</p>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-GH-1413"></a><strong>Req. GH-1413:</strong> <a href="#Req-GH-1413">Module specifier content assist</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>Modules in the selected source folder</p>
+</div>
+</div>
+</div>
+<div class="paragraph todo">
+<p>For now the spec doesn&#8217;t specify any constraints for module specifiers</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Class name</dt>
+<dd>
+<p>Specifies the class name.</p>
+</dd>
+</dl>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-GH-1413"></a><strong>Req. GH-1413:</strong> <a href="#Req-GH-1413">Class name basic constraints</a> (ver. 1)</p>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Constraints
+</td>
+<td class="hdlist2">
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>The name is a valid n4js class identifier Must not be empty</p>
+</li>
+<li>
+<p>If the target module already exists no other type with the same identifier may exist in this module</p>
+</li>
+</ol>
+</div>
+</td>
+</tr>
+</table>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-GH-1413"></a><strong>Req. GH-1413:</strong> <a href="#Req-GH-1413">Class name conflict validation</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>If the target module already exists no other type with the same identifier may exist in this module</p>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-GH-1413"></a><strong>Req. GH-1413:</strong> <a href="#Req-GH-1413">File type options</a> (ver. 1)</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Definition file (.n4jsd)</dt>
+<dd>
+<p>Specifies whether the class should be declared external. This option changes the file extension to <code>n4jsd</code></p>
+</dd>
+</dl>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-GH-1413"></a><strong>Req. GH-1413:</strong> <a href="#Req-GH-1413">Access modifier constraints</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>Specifies the access modifiers of the class. One of <code>public</code>, <code>project</code>, <strong>private</strong>. <code>@Internal</code> is an additionally selectable option.</p>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Constraints
+</td>
+<td class="hdlist2">
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>One of the provided access modifiers has to be selected</p>
+</li>
+<li>
+<p>The <code>@Internal</code> option is only selectable in case of <code>public</code> or <code>project</code></p>
+</li>
+</ol>
+</div>
+</td>
+</tr>
+</table>
+</div>
+</div>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Other modifiers</dt>
+<dd>
+<p>Specifies other modifiers and annotations of the class. The non-exclusive options are <code>@Final</code> and <strong>@N4JS</strong></p>
+</dd>
+</dl>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-GH-1413"></a><strong>Req. GH-1413:</strong> <a href="#Req-GH-1413">Other modifiers constraints</a> (ver. 1)</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Constraints</dt>
+<dd>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p><strong>@N4JS</strong> annotation is only enabled and selectable if the Definition File box is checked</p>
+</li>
+</ol>
+</div>
+</dd>
+</dl>
+</div>
+</div>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Super class</dt>
+<dd>
+<p>Specifies the super class</p>
+</dd>
+</dl>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-GH-1413"></a><strong>Req. GH-1413:</strong> <a href="#Req-GH-1413">Super class constraints</a> (ver. 1)</p>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Constraints
+</td>
+<td class="hdlist2">
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>A valid absolute class specifier that is a module specifier and a class name separated by a dot.</p>
+</li>
+</ol>
+</div>
+</td>
+</tr>
+</table>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-GH-1413"></a><strong>Req. GH-1413:</strong> <a href="#Req-GH-1413">Super class browse button</a> (ver. 1)</p>
+</div>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Browse Button
+</td>
+<td class="hdlist2">
+<p>Browsing allows the selection of all classes in the current workspace with modifiable source and visible classes with unmodifiable sources.</p>
+</td>
+</tr>
+</table>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-GH-1413"></a><strong>Req. GH-1413:</strong> <a href="#Req-GH-1413">Super class content assist</a> (ver. 1)</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Content Assist</dt>
+<dd>
+<p>All classes matching mentioned criteria</p>
+</dd>
+</dl>
+</div>
+</div>
+</div>
+<div id="Class_File_Wizard-Interfaces_Field" class="dlist">
+<dl>
+<dt class="hdlist1">Interfaces</dt>
+<dd>
+<p>Specifies the implemented interfaces of the class</p>
+</dd>
+</dl>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-GH-1413"></a><strong>Req. GH-1413:</strong> <a href="#Req-GH-1413">Interfaces constraints</a> (ver. 1)</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>A valid absolute interface specifier that is a module specifier and an interface name separated by a dot.</p>
+</li>
+</ol>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-GH-1413"></a><strong>Req. GH-1413:</strong> <a href="#Req-GH-1413">Interfaces browsing</a> (ver. 1)</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Add Button</dt>
+<dd>
+<p>Browsing allows the selection of all interfaces in the current workspace with modifiable source and visible interfaces with unmodifiable sources.</p>
+</dd>
+<dt class="hdlist1">Remove Button</dt>
+<dd>
+<p>Removes the selected interface from the list. Disabled if nothing is selected.</p>
+</dd>
+</dl>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-GH-1413"></a><strong>Req. GH-1413:</strong> <a href="#Req-GH-1413">Interfaces content assist</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>Text input is available by clicking in empty space at the end of the list. Content Assist provides all interfaces matching mentioned criteria.</p>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-GH-1413"></a><strong>Req. GH-1413:</strong> <a href="#Req-GH-1413">Create method stubs</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>Specifies if the wizard should generate method stubs for all abstract methods of the newly generated class. That are abstract super class methods or methods that need to be implemented by the class to conform to the selected interfaces.</p>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-GH-1413"></a><strong>Req. GH-1413:</strong> <a href="#Req-GH-1413">Create method stub conflict detection</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>If the selected interfaces are impossible to implement (e.g. method name overlap with unrelated parameter types) this option needs to be disabled and a warning needs to be shown.</p>
+</div>
+</div>
+</div>
+<div class="paragraph todo">
+<p>Shouldn&#8217;t this be a constraint of the selected interfaces? (Never generate invalid code)</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="visibility-issues-or-final-super-classes"><a class="anchor" href="#visibility-issues-or-final-super-classes"></a><a class="link" href="#visibility-issues-or-final-super-classes">4.3.3. Visibility issues or <code>@Final</code> super classes</a></h4>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-GH-1413"></a><strong>Req. GH-1413:</strong> <a href="#Req-GH-1413">Visibility issue conflict solving</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>By allowing the user to select invisible interfaces and super classes or unextendable <code>@Final</code>-annotated super classes, accessability issues may come up. The goal is to never generate a file containing invalid code. To accomplish this, conflicts must get solved before the file is generated.</p>
+</div>
+<div class="paragraph">
+<p>The slight limitation of the selection of interfaces and classes to elements from modifiable sources (cf. <a href="#Req-GH-1413">super class browse button</a>) allows to solve all possibly occurring visibility issues.</p>
+</div>
+<div class="paragraph">
+<p>If the modifications by finishing the wizard do imply changes different from insertions and creations, a compare view is to be shown, giving the user an overview of the needed changes before they’re applied.</p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="generation-1"><a class="anchor" href="#generation-1"></a><a class="link" href="#generation-1">4.3.4. Generation</a></h4>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-GH-1413"></a><strong>Req. GH-1413:</strong> <a href="#Req-GH-1413">Wizard generation</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>The following changes are to be made by the wizard:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Create a new file containing the new class (optional)</p>
+</li>
+<li>
+<p>Insert the new class into the specified module</p>
+</li>
+<li>
+<p>Change the source module of the super class to fix possible visibility issues (optional)</p>
+</li>
+<li>
+<p>Change the source module of the interfaces to fix possible visibility issues (optional)</p>
+</li>
+<li>
+<p>Change the project manifest to add a new source folder (optional) or add new project dependencies (optional)</p>
+</li>
+</ol>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="preview-1"><a class="anchor" href="#preview-1"></a><a class="link" href="#preview-1">4.3.5. Preview</a></h4>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-GH-1413"></a><strong>Req. GH-1413:</strong> <a href="#Req-GH-1413">Generation preview</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>On the right of the wizard form a preview window should be provided. It should preview the full path of the generated file and all code that is generated with the options of the wizard. Changes should be updated in realtime as the user is choosing different options.</p>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="sec:N4JS_Interface_Wizard"><a class="anchor" href="#sec:N4JS_Interface_Wizard"></a><a class="link" href="#sec:N4JS_Interface_Wizard">4.4. Interface Wizard</a></h3>
+<div class="paragraph">
+<p>The N4JS interface wizards is strongly similar to the <a href="#sec:N4JS_Class_File_Wizard">N4JS Class Wizard</a>. The following paragraph is meant to state the differences and will strongly refer to the N4JS Class Wizard as a lot of properties stay the same.</p>
+</div>
+<div class="imageblock center">
+<div class="content">
+<img src="chapters/06_wizards/fig/newinterfacewizard.png" alt="newinterfacewizard">
+</div>
+</div>
+<div class="sect3">
+<h4 id="field-properties-1"><a class="anchor" href="#field-properties-1"></a><a class="link" href="#field-properties-1">4.4.1. Field Properties</a></h4>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Project
+</td>
+<td class="hdlist2">
+<p>Specifies the containing project.
+See <a href="#Class_File_Wizard-Project_Field">N4JS Class Wizard Project</a>.</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Source Folder
+</td>
+<td class="hdlist2">
+<p>Specifies the containing source folder.<br>
+See <a href="#Class_File_Wizard-Source_Folder_Field">N4JS Class Wizard Source Folder</a></p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Module Specifier
+</td>
+<td class="hdlist2">
+<p>Specifies the containing source folder.<br>
+See <a href="#Class_File_Wizard-Module_Specifier_Field">N4JS Class Wizard Module specifier</a></p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Interface name
+</td>
+<td class="hdlist2">
+<p>Specifies the name of the interface<br></p>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Constraints</dt>
+<dd>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>The name is a valid n4js interface identifier</p>
+</li>
+<li>
+<p>Must not be empty</p>
+</li>
+<li>
+<p>If the target module already exists, no other type with the same identifier may exist in this module</p>
+</li>
+</ol>
+</div>
+</dd>
+</dl>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Definition file (.n4jsd)
+</td>
+<td class="hdlist2">
+<p>Specifies whether the interface should be declared external. This option changes the file extension to <code>n4jsd</code> .</p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Access Modifiers
+</td>
+<td class="hdlist2">
+<p>Specifies the interface’s access modifiers</p>
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>See <a href="#Req-GH-1413">N4JS Class Wizard Modifier Field</a> except for the following point:</p>
+</div>
+<div class="paragraph">
+<p><em>Other than classes, interfaces must not be declared as <code>@Final</code>, therefore this option is removed.</em></p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Interfaces</dt>
+<dd>
+<p>The interfaces the interface is implementing</p>
+</dd>
+</dl>
+</div>
+<div class="paragraph">
+<p>See <a href="#Class_File_Wizard-Interfaces_Field">N4JS Class Wizard Interfaces field</a> except for the following point:</p>
+</div>
+<div class="paragraph">
+<p><em>Other than classes interfaces must not be declared as <code>@Final</code>, therefore this option is removed.</em></p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Create method stubs</dt>
+<dd>
+<p>Specifies if the wizard should generate method stubs for all abstract methods of the newly generated class. That are abstract super interface methods or methods that need to be implemented by the interface to conform to the given interfaces.</p>
+<div class="paragraph">
+<p>If the selected interfaces are impossible to implement (e.g. method name overlap with unrelated parameter types) this option needs to be disabled and a warning needs to be shown.</p>
+</div>
+</dd>
+</dl>
+</div>
+<div class="paragraph todo">
+<p>Shouldn&#8217;t this be a constraint of the selected interfaces? (Never generate invalid code)</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="visibility-issues"><a class="anchor" href="#visibility-issues"></a><a class="link" href="#visibility-issues">4.4.2. Visibility Issues</a></h4>
+<div class="paragraph">
+<p>As the user might select invisible interfaces, the wizard has to solve these visibility issues. See ** for details.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="import-naming-conflicts"><a class="anchor" href="#import-naming-conflicts"></a><a class="link" href="#import-naming-conflicts">4.4.3. Import naming conflicts</a></h4>
+<div class="paragraph">
+<p>As the user may select identically named interfaces, the wizard has to solve these naming conflicts. See
+<strong><a href="#Req-GH-1413">Class Wizard Visibility Issues</a></strong> for details.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="generation-2"><a class="anchor" href="#generation-2"></a><a class="link" href="#generation-2">4.4.4. Generation</a></h4>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Create a new file at the given module specifier location (optional)</p>
+</li>
+<li>
+<p>Insert the new interface into the specified module</p>
+</li>
+<li>
+<p>Change the source module of the super class to fix visibility issues (optional)</p>
+</li>
+<li>
+<p>Change the source module of the interfaces to fix possible visibility issues (optional)</p>
+</li>
+<li>
+<p>Change the project manifest to add a possibly new source folder (optional) or add new project dependencies (optional)</p>
+</li>
+</ol>
+</div>
+</div>
+<div class="sect3">
+<h4 id="preview-2"><a class="anchor" href="#preview-2"></a><a class="link" href="#preview-2">4.4.5. Preview</a></h4>
+<div class="paragraph">
+<p>The Interface Wizard should provided a preview. (See <a href="#sec:N4JS_Wizards:Wizard_Preview">Wizard Preview</a>)</p>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="sec:N4JS_Enum_File_Wizard"><a class="anchor" href="#sec:N4JS_Enum_File_Wizard"></a><a class="link" href="#sec:N4JS_Enum_File_Wizard">4.5. Enum Wizard</a></h3>
+<div class="paragraph">
+<p>The N4JS Enum File wizards provides the user a wizard to create enums. When speaking of enums in this context ordinary enums as specified in the N4JS Specification are meant.</p>
+</div>
+<div class="sect3">
+<h4 id="field-properties-2"><a class="anchor" href="#field-properties-2"></a><a class="link" href="#field-properties-2">4.5.1. Field Properties</a></h4>
+<div class="hdlist">
+<table>
+<tr>
+<td class="hdlist1">
+Project
+</td>
+<td class="hdlist2">
+<p>Specifies the containing project.<br>
+See <a href="#Class_File_Wizard-Project_Field">N4JS Class Wizard Project</a></p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Source Folder
+</td>
+<td class="hdlist2">
+<p> Specifies the containing source folder.<br>
+See <a href="#Class_File_Wizard-Source_Folder_Field">N4JS Class Wizard Source Folder</a></p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Module Specifier
+</td>
+<td class="hdlist2">
+<p>Specifies the containing source folder. See <a href="#Class_File_Wizard-Module_Specifier_Field">N4JS Class Wizard Module specifier</a></p>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Enum name
+</td>
+<td class="hdlist2">
+<p>Specifies the name of the interface<br></p>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Constraints</dt>
+<dd>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>The name is a valid n4js enum identifier</p>
+</li>
+<li>
+<p>Must not be empty</p>
+</li>
+<li>
+<p>If the target module already exists, no other type with the same identifier may exist in this module</p>
+</li>
+</ol>
+</div>
+</dd>
+</dl>
+</div>
+</td>
+</tr>
+<tr>
+<td class="hdlist1">
+Modifiers
+</td>
+<td class="hdlist2">
+<p>Specifies the interface’s access modifiers
++
+Allows the user to select from following modifier options: <code>public</code>,<code>project</code>,<code>private</code>. The wizard automatically adds missing <code>export</code> if needed.
++
+Furthermore the enum can be declared <code>@Internal</code> using a checkbox.</p>
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph todo">
+<p>Should the enum wizard also provide functionality to create enum literals?</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="generation-3"><a class="anchor" href="#generation-3"></a><a class="link" href="#generation-3">4.5.2. Generation</a></h4>
+<div class="paragraph">
+<p>The following changes are to be made by the wizard:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Create a new file containing the new enum (optional, only if module doesn’t exists yet )</p>
+</li>
+<li>
+<p>Insert the new enum into the specified module</p>
+</li>
+</ol>
+</div>
+</div>
+<div class="sect3">
+<h4 id="preview-3"><a class="anchor" href="#preview-3"></a><a class="link" href="#preview-3">4.5.3. Preview</a></h4>
+<div class="paragraph">
+<p>The Enum Wizard should provided a preview. (See <a href="#sec:N4JS_Wizards:Wizard_Preview">Wizard Preview</a>)</p>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div id="footer">
+<div id="footer-text">
+Version 0.9<br>
+Last updated 2019-08-07 15:02:40 CEST
+</div>
+</div>
+<!-- ************* docinfo-footer *************************************************************** -->
+<div class="Grid social" style="color:#d5dfea">
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <h2>Quick Links</h2>
+    <ul>
+      <li><a href="../downloads.html">Download</a></li>
+      <li><a href="../userguides/index.html">Documentation</a></li>
+      <li><a href="https://github.com/eclipse/n4js/">Source</a></li>
+      <li><a href="https://github.com/eclipse/n4js/issues">Issues</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="https://www.eclipse.org/forums/index.php/f/365/">Forum</a></li>
+      <li><a href="http://n4js.blogspot.de/">Blog</a></li>
+      <li><a href="https://dev.eclipse.org/mailman/listinfo/n4js-dev">Mailing List</a></li>
+      <li><a href="https://projects.eclipse.org/projects/technology.n4js">Eclipse Project Page</a></li>
+      <li><a href="https://twitter.com/n4jsdev">Tweets by n4jsdev</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="http://www.eclipse.org/">Eclipse Home</a></li>
+      <li><a href="http://www.eclipse.org/legal/privacy.php">Privacy Policy</a></li>
+      <li><a href="http://www.eclipse.org/legal/termsofuse.php">Terms of Use</a></li>
+      <li><a href="http://www.eclipse.org/legal/copyright.php">Copyright Agent</a></li>
+      <li><a href="http://www.eclipse.org/legal/">Legal</a></li>
+    </ul>
+  </div>
+  <div style="clear: both; height: 0; overflow: hidden;"></div>
+</div>
+
+<!-- ************* UI Scripts ************* -->
+<script type="text/javascript" src="scripts/back-to-top.js"></script>
+
+<script type="text/javascript" src="scripts/treeview.js"></script>
+<script type="text/javascript" src="scripts/toc.js"></script>
+
+<!-- ************* Prism.js Syntax Highlighting ************* -->
+<script src="scripts/prism.js"></script>
+
+<script type="text/javascript">
+	// Add the 'toclist' id for search function
+	$(".toc2 > ul").attr('id', 'toclist');
+	// Generate a Search input form
+	$("#toclist > li:first-of-type").before('<input type="text" id="pagesearch" onkeyup="search()" placeholder="Search for section...">');
+	$("#toclist > li:first-of-type").before('<i id="clear" class="fa fa-times-circle-o"></i>');
+	$("#clear").click(function(){
+	    $("#pagesearch").val('');
+	    search();
+	    $('.toc2 > ul').treeView('collapseAll');
+	});
+	// intialize Treeview.js
+	$(".toc2 > ul").treeView();
+	// Initialize Scrollspy
+</script>
+<!-- ************* docinfo-footer *************************************************************** -->
+</body>
+</html>
\ No newline at end of file
diff --git a/spec/N4JSSpec.html b/spec/N4JSSpec.html
index 8cbd864..747572d 100644
--- a/spec/N4JSSpec.html
+++ b/spec/N4JSSpec.html
@@ -5,15 +5,12 @@
 <!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
 <meta name="viewport" content="width=device-width, initial-scale=1.0">
 <meta name="generator" content="Asciidoctor 1.5.5">
-<meta name="author" content="2018-11-06 16:56:07 CET">
+<meta name="author" content="2019-08-07 15:02:40 CEST">
 <title>N4JS Language Specification</title>
 <link rel="stylesheet" href="styles/spec.min.css">
 <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.6.3/css/font-awesome.min.css">
-<!-- ************* Meta ************* -->
-<meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1" />
+<!-- ************* docinfo ******************************************************************* -->
 
-<!-- ************* OpenGraph ************-->
-<meta name="description" content="N4JS Language Specification">
 
 <!-- ************* Favicon ************-->
 <link rel="icon" href="images/favicon.ico" />
@@ -22,19 +19,26 @@
 <script src="https://code.jquery.com/jquery-1.12.4.js"></script>
 <script src="https://code.jquery.com/ui/1.12.0/jquery-ui.js"></script>
 
-<link href="styles/prism.min.css" rel="stylesheet" />
 
+<link href="styles/prism.min.css" rel="stylesheet" />
 <script type="text/javascript" async
-  src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=MML_CHTML">
+  src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2/MathJax.js?config=TeX-MML-AM_CHTML">
 </script>
 
+<!-- ************* Styles ************* -->
+<link rel="stylesheet" type="text/css" href="styles/n4jsspec-adoc.css">
+
 
 <!-- ****************** NavBar ****************** -->
 <div id="menubar">
-	<ul class="fa-ul">
-		<li><a href="N4JSSpec.pdf">Download as PDF</a></li>
-	</ul>
+	<div class="banner">
+        <a href="https://www.eclipse.org/n4js/#"><img id="logo" src="images/n4js-logo.png" alt="Eclipse N4JS"></a>
+    </div>
+<ul>
+  <li><a href="index.html">Index</a></li>
+</ul>
 </div>
+<!-- ************* docinfo ******************************************************************* -->
 <style>
       .admonitionblock td.icon .icon-todo:before{content:"\f249";color:#f4ee42}
     </style>
@@ -43,8 +47,8 @@
 <div id="header">
 <h1>N4JS Language Specification</h1>
 <div class="details">
-<span id="author" class="author">2018-11-06 16:56:07 CET</span><br>
-<span id="revnumber">version 0.4</span>
+<span id="author" class="author">2019-08-07 15:02:40 CEST</span><br>
+<span id="revnumber">version 0.9</span>
 </div>
 <div id="toc" class="toc2">
 <div id="toctitle">Table of Contents</div>
@@ -184,12 +188,12 @@
 </ul>
 </li>
 <li><a href="#_n4class">4.8.2. N4Class</a></li>
-<li><a href="#_iterablen">4.8.3. IterableN</a></li>
+<li><a href="#IterableN">4.8.3. IterableN</a></li>
 </ul>
 </li>
 <li><a href="#_type-modifiers">4.9. Type Modifiers</a>
 <ul class="sectlevel3">
-<li><a href="#_dynamic">4.9.1. Dynamic</a></li>
+<li><a href="#Type_Modifiers_Dynamic">4.9.1. Dynamic</a></li>
 <li><a href="#_optional-return-types">4.9.2. Optional Return Types</a></li>
 </ul>
 </li>
@@ -250,6 +254,12 @@
 <li><a href="#_string-based-enums">4.13.2. String-Based Enums</a></li>
 </ul>
 </li>
+<li><a href="#_short-hand-syntax">4.14. Short-Hand Syntax</a>
+<ul class="sectlevel3">
+<li><a href="#_array-short-hand-syntax">4.14.1. Array Short-Hand Syntax</a></li>
+<li><a href="#_iterablen-short-hand-syntax">4.14.2. IterableN Short-Hand Syntax</a></li>
+</ul>
+</li>
 </ul>
 </li>
 <li><a href="#_classifiers">5. Classifiers</a>
@@ -551,8 +561,12 @@
 <li><a href="#_n4js-specific-expressions">8.4. N4JS Specific Expressions</a>
 <ul class="sectlevel3">
 <li><a href="#_class-expression">8.4.1. Class Expression</a></li>
-<li><a href="#_cast-as-expression">8.4.2. Cast (As) Expression</a></li>
-<li><a href="#cast-as-expression-semantics-type-inference">8.4.3. Semantics and Type Inference</a></li>
+<li><a href="#_cast-as-expression">8.4.2. Cast (As) Expression</a>
+<ul class="sectlevel4">
+<li><a href="#cast-as-expression-semantics-type-inference">8.4.2.1. Semantics and Type Inference</a></li>
+</ul>
+</li>
+<li><a href="#Import_Calls">8.4.3. Import Calls</a></li>
 </ul>
 </li>
 <li><a href="#compile-time-expressions">8.5. Compile-Time Expressions</a></li>
@@ -580,7 +594,7 @@
 <li><a href="#_for-of-statement">9.2.3. <code>for &#8230;&#8203; of</code> statement</a></li>
 <li><a href="#_import-statement">9.2.4. Import Statement</a>
 <ul class="sectlevel4">
-<li><a href="#_dynamic-imports">9.2.4.1. Dynamic Imports</a></li>
+<li><a href="#Dynamic_Imports">9.2.4.1. Dynamic Imports</a></li>
 <li><a href="#_immutabilaty-of-imports">9.2.4.2. Immutabilaty of Imports</a></li>
 </ul>
 </li>
@@ -674,12 +688,8 @@
 </li>
 <li><a href="#_components">12. Components</a>
 <ul class="sectlevel2">
-<li><a href="#_n4js-platform-architecture">12.1. N4JS Platform Architecture</a>
-<ul class="sectlevel3">
-<li><a href="#_overview-2">12.1.1. Overview</a></li>
-</ul>
-</li>
-<li><a href="#_component-types">12.2. Component Types</a>
+<li><a href="#_overview-2">12.1. Overview</a></li>
+<li><a href="#Component_Types">12.2. Component Types</a>
 <ul class="sectlevel3">
 <li><a href="#_libraries">12.2.1. Libraries</a></li>
 <li><a href="#_runtime-environment-and-runtime-libraries">12.2.2. Runtime Environment and Runtime Libraries</a></li>
@@ -687,46 +697,34 @@
 <li><a href="#_type-definitions">12.2.4. Type Definitions</a></li>
 </ul>
 </li>
-<li><a href="#_component-content">12.3. Component Content</a></li>
-<li><a href="#package-json">12.4. Package.json File</a>
+<li><a href="#package-json">12.3. Package.json File</a>
 <ul class="sectlevel3">
-<li><a href="#_basic-properties">12.4.1. Basic Properties</a></li>
-<li><a href="#_n4js-properties">12.4.2. N4JS Properties</a></li>
-<li><a href="#_constraints">12.4.3. Constraints</a></li>
+<li><a href="#_basic-properties">12.3.1. Basic Properties</a></li>
+<li><a href="#_n4js-properties">12.3.2. N4JS Properties</a></li>
+<li><a href="#_constraints">12.3.3. Constraints</a></li>
 </ul>
 </li>
-<li><a href="#_support-for-npm-scopes">12.5. Support for NPM Scopes</a></li>
-<li><a href="#_component-dependencies">12.6. Component Dependencies</a>
+<li><a href="#_support-for-npm-scopes">12.4. Support for NPM Scopes</a></li>
+<li><a href="#sec:N4JS-Type-Definitions">12.5. N4JS Type Definitions</a>
 <ul class="sectlevel3">
-<li><a href="#_runtime-environment-resolution">12.6.1. Runtime Environment Resolution</a></li>
-</ul>
-</li>
-<li><a href="#sec:N4JS-Type-Definitions">12.7. N4JS Type Definitions</a>
-<ul class="sectlevel3">
-<li><a href="#_specify-type-definition">12.7.1. Specify Type Definition</a></li>
-<li><a href="#_name-conventions">12.7.2. Name Conventions</a></li>
-<li><a href="#_version-conventions">12.7.3. Version Conventions</a>
+<li><a href="#_specify-type-definition">12.5.1. Specify Type Definition</a></li>
+<li><a href="#_name-conventions">12.5.2. Name Conventions</a></li>
+<li><a href="#_version-conventions">12.5.3. Version Conventions</a>
 <ul class="sectlevel4">
-<li><a href="#_define-a-new-type-definition-package">12.7.3.1. Define a New Type Definition Package</a></li>
-<li><a href="#_using-a-type-definition-package">12.7.3.2. Using a Type Definition Package</a></li>
-<li><a href="#_rational">12.7.3.3. Rational</a></li>
+<li><a href="#_define-a-new-type-definition-package">12.5.3.1. Define a New Type Definition Package</a></li>
+<li><a href="#_using-a-type-definition-package">12.5.3.2. Using a Type Definition Package</a></li>
+<li><a href="#_rational">12.5.3.3. Rational</a></li>
 </ul>
 </li>
 </ul>
 </li>
-<li><a href="#_modules">12.8. Modules</a></li>
-<li><a href="#_properties-files">12.9. Properties Files</a>
+<li><a href="#_modules">12.6. Modules</a></li>
+<li><a href="#_api-and-implementation-component">12.7. API and Implementation Component</a>
 <ul class="sectlevel3">
-<li><a href="#property-file-syntax">12.9.1. Syntax</a></li>
-<li><a href="#_constraints-2">12.9.2. Constraints</a></li>
+<li><a href="#_execution-of-api-and-implementation-components">12.7.1. Execution of API and Implementation Components</a></li>
+<li><a href="#_api-and-implementation-with-di">12.7.2. API and Implementation With DI</a></li>
 </ul>
 </li>
-<li><a href="#_api-and-implementation-components">12.10. API and Implementation Components</a>
-<ul class="sectlevel3">
-<li><a href="#_execution-of-api-and-implementation-components">12.10.1. Execution of API and Implementation Components</a></li>
-</ul>
-</li>
-<li><a href="#_api-and-implementation-with-di">12.11. API and Implementation With DI</a></li>
 </ul>
 </li>
 <li><a href="#_plainjs">13. PlainJS</a>
@@ -834,387 +832,26 @@
 </ul>
 </li>
 <li><a href="#_acronyms">Appendix A: Acronyms</a></li>
-<li><a href="#_bibliography">Appendix B: Bibliography</a></li>
+<li><a href="#sec:License">Appendix B: License</a></li>
+<li><a href="#_bibliography">Appendix C: Bibliography</a></li>
 </ul>
 </div>
 </div>
 <div id="content">
 <div id="preamble">
 <div class="sectionbody">
-<div class="imageblock n4jslogo" style="text-align: center">
-<div class="content">
-<img src="images/n4jslogo.png" alt="400" width="400">
-</div>
-</div>
 <div class="paragraph center">
-<p><strong>Last Updated: 2018-11-06</strong></p>
+<p><strong>Last Updated: 2019-08-07</strong></p>
 </div>
 <div class="paragraph center">
 <p><strong>Authors:</strong><br>
-Jens von Pilgrim, Jakub Siberski, Mark-Oliver Reiser,<br>
-Torsten Krämer, Ákos Kitta, Sebastian Zarnekow, Lorenzo Bettini, Jörg Reichert, Kristian Duske, Marcus Mews, Minh Quang Tran, Luca Beurer-Kellner</p>
+Jens von Pilgrim, Jakub Siberski, Mark-Oliver Reiser, Torsten Krämer, Ákos Kitta, Sebastian Zarnekow, Lorenzo Bettini, Jörg Reichert, Kristian Duske, Marcus Mews, Minh Quang Tran, Luca Beurer-Kellner</p>
 </div>
 <div style="page-break-after: always;"></div>
 <h2 id="_abstract" class="discrete">Abstract</h2>
 <div class="paragraph">
 <p>This document contains the N4JS Specification.</p>
 </div>
-<h2 id="_revision-history" class="discrete">Revision History</h2>
-<table class="tableblock frame-all grid-all spread language-n4js">
-<colgroup>
-<col style="width: 16.6666%;">
-<col style="width: 16.6666%;">
-<col style="width: 66.6668%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-center valign-top">Date</th>
-<th class="tableblock halign-center valign-top">Author</th>
-<th class="tableblock halign-left valign-top">Description</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-center valign-top"><p class="tableblock"><em>2013-03-21</em></p></td>
-<td class="tableblock halign-center valign-top"><p class="tableblock"><strong>v.Pilgrim</strong></p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">initial commit</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-center valign-top"><p class="tableblock"><em>2016-03-13</em></p></td>
-<td class="tableblock halign-center valign-top"><p class="tableblock"><strong>v.Pilgrim</strong></p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">public release, version 0.3 (alpha)</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-center valign-top"><p class="tableblock"><em>2016-05-31</em></p></td>
-<td class="tableblock halign-center valign-top"><p class="tableblock"><strong>mor</strong></p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">support for definition-site variance, cf. <a href="#sec:definition-site-variance">Definition-Site Variance</a></p></td>
-</tr>
-<tr>
-<td class="tableblock halign-center valign-top"><p class="tableblock"><em>2016-07-18</em></p></td>
-<td class="tableblock halign-center valign-top"><p class="tableblock"><strong>mor</strong></p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">rename manifest property <code>artifactId</code> to <code>projectId</code>; remove <code>projectName</code></p></td>
-</tr>
-<tr>
-<td class="tableblock halign-center valign-top"><p class="tableblock"><em>2016-09-09</em></p></td>
-<td class="tableblock halign-center valign-top"><p class="tableblock"><strong>mor</strong></p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">add <code>@CovariantConstructor</code>, cf. <a href="#_covariant-constructors">Covariant Constructors</a>, plus related adjustments</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-center valign-top"><p class="tableblock"><em>2016-11-09</em></p></td>
-<td class="tableblock halign-center valign-top"><p class="tableblock"><strong>bsmith</strong></p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">convert from <code>LaTeX</code> to AsciiDoc</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-center valign-top"><p class="tableblock"><em>2017-07-03</em></p></td>
-<td class="tableblock halign-center valign-top"><p class="tableblock"><strong>qtran</strong></p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Describe semantics of optional fields in ternay expressions <a href="#optional-fields">Optional Fields</a></p></td>
-</tr>
-<tr>
-<td class="tableblock halign-center valign-top"><p class="tableblock"><em>2018-09-13</em></p></td>
-<td class="tableblock halign-center valign-top"><p class="tableblock"><strong>mmews</strong></p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">add subsection <a href="#sec:N4JS-Type-Definitions">N4JS Type Definitions</a></p></td>
-</tr>
-</tbody>
-</table>
-<h2 id="_licence" class="discrete">Licence</h2>
-<div class="paragraph">
-<p>This specification and the accompanying materials is made available
-under the terms of the Eclipse Public License v1.0 which accompanies
-this distribution, and is available at <a href="http://www.eclipse.org/legal/epl-v10.html" class="bare">http://www.eclipse.org/legal/epl-v10.html</a></p>
-</div>
-<h3 id="_eclipse-public-license-v-1-0" class="discrete">Eclipse Public License - v 1.0</h3>
-<div class="paragraph">
-<p>THE ACCOMPANYING PROGRAM IS PROVIDED UNDER THE TERMS OF THIS ECLIPSE
-PUBLIC LICENSE (<code>AGREEMENT</code>). ANY USE, REPRODUCTION OR DISTRIBUTION OF
-THE PROGRAM CONSTITUTES RECIPIENT’S ACCEPTANCE OF THIS AGREEMENT.</p>
-</div>
-<h4 id="_1-definitions" class="discrete">1. DEFINITIONS</h4>
-<div class="dlist">
-<dl>
-<dt class="hdlist1"><code>Contribution</code> means: </dt>
-<dd>
-<div class="olist arabic">
-<ol class="arabic">
-<li>
-<p>in the case of the initial Contributor, the initial code and
-documentation distributed under this Agreement, and</p>
-</li>
-<li>
-<p>in the case of each subsequent Contributor:</p>
-<div class="olist loweralpha">
-<ol class="loweralpha" type="a">
-<li>
-<p>changes to the Program, and</p>
-</li>
-<li>
-<p>additions to the Program;</p>
-<div class="paragraph">
-<p>where such changes and/or additions to the Program originate from and
-are distributed by that particular Contributor. A Contribution
-’originates’ from a Contributor if it was added to the Program by such
-Contributor itself or anyone acting on such Contributor’s behalf.
-Contributions do not include additions to the Program which:</p>
-</div>
-<div class="olist lowerroman">
-<ol class="lowerroman" type="i">
-<li>
-<p>are separate modules of software distributed in conjunction with the Program
-under their own license agreement, and</p>
-</li>
-<li>
-<p>are not derivative works of the Program.</p>
-</li>
-</ol>
-</div>
-</li>
-</ol>
-</div>
-</li>
-</ol>
-</div>
-</dd>
-<dt class="hdlist1"><code>Contributor</code></dt>
-<dd>
-<p>means any person or entity that distributes the Program.</p>
-</dd>
-<dt class="hdlist1"><code>Licensed Patents</code> </dt>
-<dd>
-<p>mean patent claims licensable by a Contributor
-which are necessarily infringed by the use or sale of its Contribution
-alone or when combined with the Program.</p>
-</dd>
-<dt class="hdlist1"><code>Program</code> </dt>
-<dd>
-<p>means the Contributions distributed in accordance with this
-Agreement.</p>
-</dd>
-<dt class="hdlist1"><code>Recipient</code> </dt>
-<dd>
-<p>means anyone who receives the Program under this
-Agreement, including all Contributors.</p>
-</dd>
-</dl>
-</div>
-<h4 id="_2-grant-of-rights" class="discrete">2. GRANT OF RIGHTS</h4>
-<div class="olist arabic">
-<ol class="arabic">
-<li>
-<p>Subject to the terms of this Agreement, each Contributor hereby
-grants Recipient a non-exclusive, worldwide, royalty-free copyright
-license to reproduce, prepare derivative works of, publicly display,
-publicly perform, distribute and sublicense the Contribution of such
-Contributor, if any, and such derivative works, in source code and
-object code form.</p>
-</li>
-<li>
-<p>Subject to the terms of this Agreement, each Contributor hereby
-grants Recipient a non-exclusive, worldwide, royalty-free patent license
-under Licensed Patents to make, use, sell, offer to sell, import and
-otherwise transfer the Contribution of such Contributor, if any, in
-source code and object code form. This patent license shall apply to the
-combination of the Contribution and the Program if, at the time the
-Contribution is added by the Contributor, such addition of the
-Contribution causes such combination to be covered by the Licensed
-Patents. The patent license shall not apply to any other combinations
-which include the Contribution. No hardware per se is licensed
-hereunder.</p>
-</li>
-<li>
-<p>Recipient understands that although each Contributor grants the
-licenses to its Contributions set forth herein, no assurances are
-provided by any Contributor that the Program does not infringe the
-patent or other intellectual property rights of any other entity. Each
-Contributor disclaims any liability to Recipient for claims brought by
-any other entity based on infringement of intellectual property rights
-or otherwise. As a condition to exercising the rights and licenses
-granted hereunder, each Recipient hereby assumes sole responsibility to
-secure any other intellectual property rights needed, if any. For
-example, if a third party patent license is required to allow Recipient
-to distribute the Program, it is Recipient’s responsibility to acquire
-that license before distributing the Program.</p>
-</li>
-<li>
-<p>Each Contributor represents that to its knowledge it has sufficient
-copyright rights in its Contribution, if any, to grant the copyright
-license set forth in this Agreement.</p>
-</li>
-</ol>
-</div>
-<h4 id="_3-requirements" class="discrete">3. REQUIREMENTS</h4>
-<div class="paragraph">
-<p>A Contributor may choose to distribute the Program in object code form
-under its own license agreement, provided that:</p>
-</div>
-<div class="olist arabic">
-<ol class="arabic">
-<li>
-<p>it complies with the terms and conditions of this Agreement; and</p>
-</li>
-<li>
-<p>its license agreement:</p>
-<div class="olist loweralpha">
-<ol class="loweralpha" type="a">
-<li>
-<p>effectively disclaims on behalf of all Contributors all warranties
-and conditions, express and implied, including warranties or conditions
-of title and non-infringement, and implied warranties or conditions of
-merchantability and fitness for a particular purpose;</p>
-</li>
-<li>
-<p>effectively excludes on behalf of all Contributors all liability for
-damages, including direct, indirect, special, incidental and
-consequential damages, such as lost profits;</p>
-</li>
-<li>
-<p>states that any provisions which differ from this Agreement are
-offered by that Contributor alone and not by any other party; and</p>
-</li>
-<li>
-<p>states that source code for the Program is available from such
-Contributor, and informs licensees how to obtain it in a reasonable
-manner on or through a medium customarily used for software exchange.</p>
-</li>
-</ol>
-</div>
-</li>
-</ol>
-</div>
-<div class="paragraph">
-<p>When the Program is made available in source code form:</p>
-</div>
-<div class="olist arabic">
-<ol class="arabic">
-<li>
-<p>it must be made available under this Agreement; and</p>
-</li>
-<li>
-<p>a copy of this Agreement must be included with each copy of the
-Program.</p>
-</li>
-</ol>
-</div>
-<div class="paragraph">
-<p>Contributors may not remove or alter any copyright notices contained
-within the Program.</p>
-</div>
-<div class="paragraph">
-<p>Each Contributor must identify itself as the originator of its
-Contribution, if any, in a manner that reasonably allows subsequent
-Recipients to identify the originator of the Contribution.</p>
-</div>
-<h4 id="_4-commercial-distribution" class="discrete">4. COMMERCIAL DISTRIBUTION</h4>
-<div class="paragraph">
-<p>Commercial distributors of software may accept certain responsibilities
-with respect to end users, business partners and the like. While this
-license is intended to facilitate the commercial use of the Program, the
-Contributor who includes the Program in a commercial product offering
-should do so in a manner which does not create potential liability for
-other Contributors. Therefore, if a Contributor includes the Program in
-a commercial product offering, such Contributor (<code>Commercial
-Contributor</code>) hereby agrees to defend and indemnify every other
-Contributor (<code>Indemnified Contributor</code>) against any losses, damages
-and costs (collectively <code>Losses</code>) arising from claims, lawsuits and
-other legal actions brought by a third party against the Indemnified
-Contributor to the extent caused by the acts or omissions of such
-Commercial Contributor in connection with its distribution of the
-Program in a commercial product offering. The obligations in this
-section do not apply to any claims or Losses relating to any actual or
-alleged intellectual property infringement. In order to qualify, an
-Indemnified Contributor must: a) promptly notify the Commercial
-Contributor in writing of such claim, and b) allow the Commercial
-Contributor to control, and cooperate with the Commercial Contributor
-in, the defense and any related settlement negotiations. The Indemnified
-Contributor may participate in any such claim at its own expense.</p>
-</div>
-<div class="paragraph">
-<p>For example, a Contributor might include the Program in a commercial
-product offering, Product X. That Contributor is then a Commercial
-Contributor. If that Commercial Contributor then makes performance
-claims, or offers warranties related to Product X, those performance
-claims and warranties are such Commercial Contributor’s responsibility
-alone. Under this section, the Commercial Contributor would have to
-defend claims against the other Contributors related to those
-performance claims and warranties, and if a court requires any other
-Contributor to pay any damages as a result, the Commercial Contributor
-must pay those damages.</p>
-</div>
-<h4 id="_5-no-warranty" class="discrete">5. NO WARRANTY</h4>
-<div class="paragraph">
-<p>EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, THE PROGRAM IS PROVIDED
-ON AN <code>AS IS</code> BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,
-EITHER EXPRESS OR IMPLIED INCLUDING, WITHOUT LIMITATION, ANY WARRANTIES
-OR CONDITIONS OF TITLE, NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR
-A PARTICULAR PURPOSE. Each Recipient is solely responsible for
-determining the appropriateness of using and distributing the Program
-and assumes all risks associated with its exercise of rights under this
-Agreement , including but not limited to the risks and costs of program
-errors, compliance with applicable laws, damage to or loss of data,
-programs or equipment, and unavailability or interruption of operations.</p>
-</div>
-<h4 id="_6-disclaimer-of-liability" class="discrete">6. DISCLAIMER OF LIABILITY</h4>
-<div class="paragraph">
-<p>EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, NEITHER RECIPIENT NOR
-ANY CONTRIBUTORS SHALL HAVE ANY LIABILITY FOR ANY DIRECT, INDIRECT,
-INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING
-WITHOUT LIMITATION LOST PROFITS), HOWEVER CAUSED AND ON ANY THEORY OF
-LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
-NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OR
-DISTRIBUTION OF THE PROGRAM OR THE EXERCISE OF ANY RIGHTS GRANTED
-HEREUNDER, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.</p>
-</div>
-<h4 id="_7-general" class="discrete">7. GENERAL</h4>
-<div class="paragraph">
-<p>If any provision of this Agreement is invalid or unenforceable under
-applicable law, it shall not affect the validity or enforceability of
-the remainder of the terms of this Agreement, and without further action
-by the parties hereto, such provision shall be reformed to the minimum
-extent necessary to make such provision valid and enforceable.</p>
-</div>
-<div class="paragraph">
-<p>If Recipient institutes patent litigation against any entity (including
-a cross-claim or counterclaim in a lawsuit) alleging that the Program
-itself (excluding combinations of the Program with other software or
-hardware) infringes such Recipient’s patent(s), then such Recipient’s
-rights granted under Section 2(b) shall terminate as of the date such
-litigation is filed.</p>
-</div>
-<div class="paragraph">
-<p>All Recipient’s rights under this Agreement shall terminate if it fails
-to comply with any of the material terms or conditions of this Agreement
-and does not cure such failure in a reasonable period of time after
-becoming aware of such noncompliance. If all Recipient’s rights under
-this Agreement terminate, Recipient agrees to cease use and distribution
-of the Program as soon as reasonably practicable. However, Recipient’s
-obligations under this Agreement and any licenses granted by Recipient
-relating to the Program shall continue and survive.</p>
-</div>
-<div class="paragraph">
-<p>Everyone is permitted to copy and distribute copies of this Agreement,
-but in order to avoid inconsistency the Agreement is copyrighted and may
-only be modified in the following manner. The Agreement Steward reserves
-the right to publish new versions (including revisions) of this
-Agreement from time to time. No one other than the Agreement Steward has
-the right to modify this Agreement. The Eclipse Foundation is the
-initial Agreement Steward. The Eclipse Foundation may assign the
-responsibility to serve as the Agreement Steward to a suitable separate
-entity. Each new version of the Agreement will be given a distinguishing
-version number. The Program (including Contributions) may always be
-distributed subject to the version of the Agreement under which it was
-received. In addition, after a new version of the Agreement is
-published, Contributor may elect to distribute the Program (including
-its Contributions) under the new version. Except as expressly stated in
-Sections 2(a) and 2(b) above, Recipient receives no rights or licenses
-to the intellectual property of any Contributor under this Agreement,
-whether expressly, by implication, estoppel or otherwise. All rights in
-the Program not expressly granted under this Agreement are reserved.</p>
-</div>
-<div class="paragraph">
-<p>This Agreement is governed by the laws of the State of New York and the
-intellectual property laws of the United States of America. No party to
-this Agreement will bring a legal action under this Agreement more than
-one year after the cause of action arose. Each party waives its rights
-to a jury trial in any resulting litigation.</p>
-</div>
 </div>
 </div>
 <div class="sect1">
@@ -4696,7 +4333,7 @@
 </div>
 </div>
 <div class="sect3">
-<h4 id="_iterablen"><a class="anchor" href="#_iterablen"></a><a class="link" href="#_iterablen">4.8.3. IterableN</a></h4>
+<h4 id="IterableN"><a class="anchor" href="#IterableN"></a><a class="link" href="#IterableN">4.8.3. IterableN</a></h4>
 <div class="paragraph todo">
 <p>Work in progress.</p>
 </div>
@@ -4730,7 +4367,7 @@
 Optional and variadic modifiers can only be applied for formal parameters.</p>
 </div>
 <div class="sect3">
-<h4 id="_dynamic"><a class="anchor" href="#_dynamic"></a><a class="link" href="#_dynamic">4.9.1. Dynamic</a></h4>
+<h4 id="Type_Modifiers_Dynamic"><a class="anchor" href="#Type_Modifiers_Dynamic"></a><a class="link" href="#Type_Modifiers_Dynamic">4.9.1. Dynamic</a></h4>
 <div class="paragraph">
 <p>The dynamic type modifier marks a type as being dynamic.
 A dynamic type behaves like a normal JavaScript object, so you can read/write any property and call any method on it.
@@ -6707,6 +6344,91 @@
 </div>
 </div>
 </div>
+<div class="sect2 language-n4js">
+<h3 id="_short-hand-syntax"><a class="anchor" href="#_short-hand-syntax"></a><a class="link" href="#_short-hand-syntax">4.14. Short-Hand Syntax</a></h3>
+<div class="paragraph">
+<p>Short-hand syntax is available for a number of built-in types.</p>
+</div>
+<div class="sect3">
+<h4 id="_array-short-hand-syntax"><a class="anchor" href="#_array-short-hand-syntax"></a><a class="link" href="#_array-short-hand-syntax">4.14.1. Array Short-Hand Syntax</a></h4>
+<div class="paragraph">
+<p>For the built-in type <code>Array</code> a convenience short form is available. Thus, writing</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">let arr: string[];</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>is equivalent to</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">let arr: Array&lt;string&gt;;</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Multi-dimensional arrays can be declared as such:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">let arr: string[][][];</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>which is equivalent to</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">let arr: Array&lt;Array&lt;Array&lt;string&gt;&gt;&gt;;</code></pre>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_iterablen-short-hand-syntax"><a class="anchor" href="#_iterablen-short-hand-syntax"></a><a class="link" href="#_iterablen-short-hand-syntax">4.14.2. IterableN Short-Hand Syntax</a></h4>
+<div class="paragraph">
+<p>The built-in IterableN types (i.e. <code>Iterable2</code>, <code>Iterable3</code>, &#8230;&#8203; <code>Iterable9</code>, see <a href="#IterableN">IterableN</a>) are
+also provided with a short-hand syntax. For example, writing</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">let i3: [string,number,string[]];</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>would be equivalent to</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">let i3: Iterable3&lt;string,number,Array&lt;string&gt;&gt;;</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Note the following special cases:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">let i0: [];
+let i1: [string];
+let union: string|number[];</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>which is equivalent to</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">let i0: Iterable&lt;?&gt;;
+let i1: Iterable&lt;string&gt;;
+let union: union{string,Array&lt;number&gt;}; // not: Array&lt;union{string,number}&gt;</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Further note: while this syntax is very similar to TypeScript&#8217;s tuple syntax, the semantics
+of tuples and IterableN are very different.</p>
+</div>
+</div>
+</div>
 </div>
 </div>
 <div class="sect1">
@@ -7238,6 +6960,14 @@
 <div class="paragraph">
 <p><a id="Req-IDE-46"></a><strong>Req. IDE-46:</strong> <a href="#Req-IDE-46">Abstract Member</a> (ver. 1)</p>
 </div>
+<div class="paragraph">
+<p></p>
+</div>
+<div class="sidebarblock">
+<div class="content">
+<a href="https://github.com/eclipse/n4js/issues/1047" class="gray" title="GitHub Issues"><span class="image"><img src="images/issue.svg" alt=""></span> #1047</a>
+</div>
+</div>
 <div class="olist arabic">
 <ol class="arabic">
 <li>
@@ -7250,15 +6980,44 @@
 <p>It is not possible to inherit from an abstract class which contains abstract members which are not visible in the subclass.</p>
 </li>
 <li>
-<p>An abstract member cannot be set to final (with annotation @Final).</p>
+<p>An abstract member must not be set to final (with annotation <code>@Final</code>).</p>
 </li>
 <li>
-<p>Static members may not be declared abstract.</p>
+<p>Static members must not be declared abstract.</p>
 </li>
 </ol>
 </div>
 </div>
 </div>
+<div class="paragraph">
+<p>Remarks:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>We decided to disallow abstract static members, since we cannot guarantee that a static members is not accessed in all cases</p>
+</li>
+<li>
+<p>Only static members can override static members and only instance members can override other instance members of course.</p>
+</li>
+<li>
+<p>An abstract member must not be declared in a final class (i.e. a class annotated with <code>@Final</code>). This is not explicitly defined as constraint in <a href="#Req-IDE-46">[Req-IDE-46]</a> since abstract classes must not defined final anyway. We also do not produce error message for abstract members in final classes since these errors would be consequential errors.</p>
+</li>
+</ul>
+</div>
+<div class="admonitionblock warning">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-warning" title=""></i>
+</td>
+<td class="content">
+Abstract members might be declared private, as they can be accessed from within the module.
+This is to be changed in order to be aligned with TypeScript, cf. <a href="https://github.com/eclipse/n4js/issues/1221" class="gray" title="GitHub Issues"><span class="image"><img src="images/issue.svg" alt=""></span> #1221</a>. However we also want to add class expressions&#8201;&#8212;&#8201;and then the abstract members may be accessed (and overridden) in nested classes created by means of class expressions.
+</td>
+</tr>
+</table>
+</div>
 </div>
 <div class="sect4">
 <h5 id="_non-instantiable-classes"><a class="anchor" href="#_non-instantiable-classes"></a><a class="link" href="#_non-instantiable-classes">5.1.3.5. Non-Instantiable Classes</a></h5>
@@ -14146,7 +13905,7 @@
 <p>Autoboxing is not directly supported in N4JS. Instead, primitive types virtually have the same members as their corresponding object types.
 It is then possible to use the Autoboxing feature when calling a member.
 In general, Autoboxing is only supported for accessing built-in read-only (immutable) properties.
-For example, <code>"some string value".split(" ");</code> is supported but <code>"some string value".foo=1;</code> will be rejected as String does not allow properties to be added (cf. <code>String</code> vs. <code>String+</code>, see <a href="#_dynamic">Dynamic</a>).</p>
+For example, <code>"some string value".split(" ");</code> is supported but <code>"some string value".foo=1;</code> will be rejected as String does not allow properties to be added (cf. <code>String</code> vs. <code>String+</code>, see <a href="#_dynamic">[_dynamic]</a>).</p>
 </div>
 <div class="paragraph">
 <p>Autoboxing often leads to problems, in particular in combination with dynamic types – this is why it is not directly supported in N4JS.</p>
@@ -15574,6 +15333,9 @@
 </div>
 <div class="sect3">
 <h4 id="_object-literal"><a class="anchor" href="#_object-literal"></a><a class="link" href="#_object-literal">8.1.5. Object Literal</a></h4>
+<div class="paragraph">
+<p>In addition to ordinary Javascript object literals, N4JS supports the spread operator within object literals as introduced in [<a href="#ECMA18a">ECMA18a</a>].</p>
+</div>
 <h5 id="object-literal-syntax" class="discrete">Syntax</h5>
 <div class="paragraph">
 <p>Cf. [<a href="#ECMA11a">ECMA11a(p.S11.1.5, p.p.65ff)</a>]
@@ -15595,6 +15357,7 @@
     | PropertySetterDeclaration&lt;Yield&gt;
     | PropertyMethodDeclaration&lt;Yield&gt;
     | PropertyNameValuePairSingleName&lt;Yield&gt;
+    | PropertySpread&lt;Yield&gt;
 ;
 
 
@@ -15646,6 +15409,10 @@
         -&gt;LiteralOrComputedPropertyName &lt;Yield&gt;
     )
     '(' fpar=FormalParameter&lt;Yield&gt; ')' body=Block&lt;Yield=false&gt;
+;
+
+PropertySpread &lt;Yield&gt;:
+	'...' expression=AssignmentExpression&lt;In=true,Yield&gt;
 ;</code></pre>
 </div>
 </div>
@@ -17705,9 +17472,8 @@
     | IntersectionTypeExpression</code></pre>
 </div>
 </div>
-</div>
-<div class="sect3">
-<h4 id="cast-as-expression-semantics-type-inference"><a class="anchor" href="#cast-as-expression-semantics-type-inference"></a><a class="link" href="#cast-as-expression-semantics-type-inference">8.4.3. Semantics and Type Inference</a></h4>
+<div class="sect4">
+<h5 id="cast-as-expression-semantics-type-inference"><a class="anchor" href="#cast-as-expression-semantics-type-inference"></a><a class="link" href="#cast-as-expression-semantics-type-inference">8.4.2.1. Semantics and Type Inference</a></h5>
 <div class="paragraph">
 <p>The inferred type of the type cast expression is the target type:</p>
 </div>
@@ -17726,6 +17492,31 @@
 </div>
 </div>
 </div>
+<div class="sect3">
+<h4 id="Import_Calls"><a class="anchor" href="#Import_Calls"></a><a class="link" href="#Import_Calls">8.4.3. Import Calls</a></h4>
+<div class="paragraph">
+<p>Import calls as specified by the corresponding <a href="https://github.com/tc39/proposal-dynamic-import">ECMA TC39 proposal</a> are
+available in N4JS. Such an import call has the form</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">import(moduleSpecifier)</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>and may appear in the source code wherever an expression may appear. It&#8217;s argument need not be a string literal, as is
+the case with module specifiers of ordinary imports; instead, any expression that evaluates to a string at runtime is
+accepted. Hence, it can be used to import from a target module that is not yet known at compile time.</p>
+</div>
+<div class="paragraph">
+<p>A note on terminology: import calls covered in this section are sometimes referred to as "dynamic import". In N4JS
+that term is already used for imports of the form <code>import * as N+ from "&#8230;&#8203;"</code>, i.e. compile-time imports that do not
+require type information of the module imported from, see <a href="#Dynamic_Imports">Dynamic Imports</a>, and stems from the term "dynamic type"
+(see <a href="#Type_Modifiers_Dynamic">Dynamic</a>). To avoid confusion, we will usually avoid referring to import calls as a "dynamic
+import".</p>
+</div>
+</div>
+</div>
 <div class="sect2 language-n4js">
 <h3 id="compile-time-expressions"><a class="anchor" href="#compile-time-expressions"></a><a class="link" href="#compile-time-expressions">8.5. Compile-Time Expressions</a></h3>
 <div class="paragraph">
@@ -18439,7 +18230,7 @@
 <div class="sect3">
 <h4 id="_for-of-statement"><a class="anchor" href="#_for-of-statement"></a><a class="link" href="#_for-of-statement">9.2.3. <code>for &#8230;&#8203; of</code> statement</a></h4>
 <div class="paragraph">
-<p>ES6 introduced a new form of <code>for</code> statement: <code>for &#8230;&#8203; of</code> to iterate over the elements of an  <code>Iterable</code>, cf. <a href="#_iterablen">IterableN</a>.</p>
+<p>ES6 introduced a new form of <code>for</code> statement: <code>for &#8230;&#8203; of</code> to iterate over the elements of an  <code>Iterable</code>, cf. <a href="#_iterablen">[_iterablen]</a>.</p>
 </div>
 <h5 id="for-of-statement-syntax" class="discrete">Syntax</h5>
 <div class="paragraph">
@@ -18869,10 +18660,11 @@
 </div>
 </div>
 <div class="sect4">
-<h5 id="_dynamic-imports"><a class="anchor" href="#_dynamic-imports"></a><a class="link" href="#_dynamic-imports">9.2.4.1. Dynamic Imports</a></h5>
+<h5 id="Dynamic_Imports"><a class="anchor" href="#Dynamic_Imports"></a><a class="link" href="#Dynamic_Imports">9.2.4.1. Dynamic Imports</a></h5>
 <div class="paragraph">
 <p>N4JS extends the ES6 module import in order that modules without a <code>n4jsd</code> or <code>n4js</code> file (plain <code>js</code> modules) can be imported.
-This is done by adding <code>+</code> to the name of the named import.</p>
+This is done by adding <code>+</code> to the name of the named import. This form of compile-time import without type information is not
+to be confused with import calls as described in <a href="#Import_Calls">Import Calls</a>, which are sometimes referred to as "dynamic import" as well.</p>
 </div>
 <div class="openblock requirement">
 <div class="content">
@@ -21360,7 +21152,7 @@
 <p>In plain JavaScript, so called <em>polyfill</em> (or sometimes called <em>shim</em>) libraries are provided in order to modify existing classes which are only prototypes in plain JavaScript.
 In N4JS, this can be defined for declarations via the annotation <code>@Polyfill</code> or <code>@StaticPolyfill</code>.
 One of these annotations can be added to class declarations which do not look that much different from normal classes.
-In the case of polyfill classes, the extended class is modified (or filled) instead of being subclassed.</p>
+In the case of polyfill classes, the extended class is modified (or filled) instead of being subclassed. It is therefore valid to polyfill a class even if it is declared <code>@Final</code>.</p>
 </div>
 <div class="paragraph">
 <p>We distinguish two flavours of polyfill classes: runtime and static.</p>
@@ -21743,96 +21535,97 @@
 <h2 id="_components"><a class="anchor" href="#_components"></a><a class="link" href="#_components">12. Components</a></h2>
 <div class="sectionbody">
 <div class="sect2 language-n4js">
-<h3 id="_n4js-platform-architecture"><a class="anchor" href="#_n4js-platform-architecture"></a><a class="link" href="#_n4js-platform-architecture">12.1. N4JS Platform Architecture</a></h3>
-<div class="sect3">
-<h4 id="_overview-2"><a class="anchor" href="#_overview-2"></a><a class="link" href="#_overview-2">12.1.1. Overview</a></h4>
+<h3 id="_overview-2"><a class="anchor" href="#_overview-2"></a><a class="link" href="#_overview-2">12.1. Overview</a></h3>
 <div class="paragraph">
-<p><a href="#fig-cmpd_components_in_n4js">N4JS Component Overview</a> shows the N4JS components described in detail in this
-chapter.<sup class="footnote">[<a id="_footnoteref_60" class="footnote" href="#_footnote_60" title="View footnote.">60</a>]</sup></p>
+<p>For modularization purposes, N4JS code is managed in so-called <em>components</em>. These components correspond to what
+node and npm call <em>packages</em>, what OSGi calls <em>bundle</em>, and what Eclipse calls <em>project</em>.</p>
+</div>
+<div class="paragraph">
+<p>N4JS distinguishes several types of such components. <a href="#fig-cmpd_components_in_n4js">Overview of N4JS Components (OLD)</a> shows the N4JS component types
+described in detail in this chapter. <a href="#fig-cmp_components">Overview of N4JS Components and Dependencies (NEW)</a> shows a recently updated diagram, which is not yet fully
+reflected in the implementation.</p>
 </div>
 <div id="fig-cmpd_components_in_n4js" class="imageblock" style="text-align: center">
 <div class="content">
 <img src="chapters/12_components/fig/cmpd_components_in_n4js.svg" alt="cmpd components in n4js">
 </div>
-<div class="title">Figure 10. N4JS Component Overview</div>
+<div class="title">Figure 10. Overview of N4JS Components (OLD)</div>
+</div>
+<div id="fig-cmp_components" class="imageblock" style="text-align: center">
+<div class="content">
+<img src="chapters/12_components/fig/cmp_components.svg" alt="cmp components">
+</div>
+<div class="title">Figure 11. Overview of N4JS Components and Dependencies (NEW)</div>
 </div>
 <div class="paragraph">
-<p>The N4JS platform distinguishes several types of components. The
-following components can only be created by internal developers:</p>
+<p>The following types of components can only be created by internal developers:</p>
 </div>
 <div class="dlist">
 <dl>
 <dt class="hdlist1">Runtime Environment</dt>
 <dd>
-<p>Definition of a runtime environment such as ECMAScript 5.
-A Runtime Environment describes the base types provided by the runtime directly which are usually globally available.
-Other components do not directly rely on runtime environments, but on runtime libraries.</p>
+<p>Definition of a runtime environment such as ECMAScript 5, node.js, or Chrome.
+A Runtime Environment provides a number of base types which are usually globally available.
+Other components do not directly rely on runtime environments, but on runtime libraries.
+NOTE: runtime environments are not fully implemented at this time (see GH-1291).</p>
 </dd>
 <dt class="hdlist1">Runtime Library</dt>
 <dd>
-<p>Collections of types provided by the runtime.
+<p>Contains type definitions for the base types provided by one or more runtime environments.
 These types may be extensions to certain language specifications.
 E.g., the ECMAScript 6 collection classes are already provided by some environments otherwise only supporting ECMAScript 5.
 The collections are defined in terms of a runtime library which can then be provided by these environments.
-Runtime libraries may also contain polyfils to alter types predefined in the environment.</p>
-</dd>
-<dt class="hdlist1">Test Environment</dt>
-<dd>
-<p>Not yet clear. Environments defined for tests.</p>
-</dd>
-<dt class="hdlist1">Test Library</dt>
-<dd>
-<p>Not yet clear. Libraries defined for tests supported by the to enable running tests and viewing test reports directly within the , such as <em>Mangelhaft</em>.</p>
+Runtime libraries may also contain polyfills to alter types predefined in the environment.</p>
 </dd>
 </dl>
 </div>
 <div class="paragraph">
 <p>The following components can be created by external developers:</p>
 </div>
-<div id="Apps" class="dlist">
+<div id="App" class="dlist">
 <dl>
-<dt class="hdlist1">Apps</dt>
+<dt class="hdlist1">App</dt>
 <dd>
-<p>User-written N4JS applications running in a web browser (the reference browser is Chrome).</p>
+<p>User-written N4JS applications.</p>
 </dd>
-<dt class="hdlist1">Processors</dt>
+<dt class="hdlist1">Processor</dt>
 <dd>
-<p>User-written N4JS processors running on Node.js.</p>
+<p>User-written N4JS code running server-side on the N4 platform. Not implemented yet.</p>
 </dd>
-<dt class="hdlist1">Libraries</dt>
+<dt class="hdlist1">Library</dt>
 <dd>
-<p>User-written libraries used by apps, processors or other libraries.</p>
+<p>User-written libraries used by apps, processors, or other libraries.</p>
 </dd>
 </dl>
 </div>
 <div class="paragraph">
-<p>These components are described in detail later.</p>
+<p>The available component types are described in more detail in <a href="#Component_Types">Component Types</a>.</p>
 </div>
 <div class="paragraph">
-<p>A component is similar to a single project in the N4JS IDE. Generally, it contains the following:</p>
+<p>A component corresponds to a single project in the N4JS IDE. Generally, it contains the following:</p>
 </div>
 <div class="dlist">
 <dl>
 <dt class="hdlist1">Package.json File</dt>
 <dd>
-<p>The <code>package.json</code> file describing the components, dependencies and metadata.</p>
+<p>The <code>package.json</code> file describing the contents, dependencies and metadata.</p>
 </dd>
 <dt class="hdlist1">Resources</dt>
 <dd>
-<p>Resources such as images, N4ML files etc.</p>
+<p>Resources such as images, data files etc.</p>
 </dd>
 <dt class="hdlist1">Sources</dt>
 <dd>
-<p>Source files of modules - actual N4JS files used in a project.</p>
+<p>Source files containing either N4JS code or plain Javascript. The actual code used in a project.</p>
 </dd>
-<dt class="hdlist1">Compilation</dt>
+<dt class="hdlist1">Output Code</dt>
 <dd>
-<p>Compiled, minified and concatenated versions of the N4JS files and
-other JS files.</p>
+<p>Compiled and possibly adjusted (e.g. minified, concatenated) versions of the N4JS source files and
+plain Javascript files.</p>
 </dd>
 <dt class="hdlist1">Tests</dt>
 <dd>
-<p>Optional test sources and compiled tests.</p>
+<p>Optional test sources and compiled output code.</p>
 </dd>
 <dt class="hdlist1">Source Maps</dt>
 <dd>
@@ -21847,16 +21640,17 @@
 <div class="content">
 <img src="chapters/12_components/fig/cmpd_component_content.svg" alt="cmpd component content">
 </div>
-<div class="title">Figure 11. Content of a Component</div>
+<div class="title">Figure 12. Content of a Component</div>
 </div>
+<div class="paragraph">
+<p>At both compile time and runtime, all components defined as dependency have to be available. Since dependencies
+are defined in <code>package.json</code> files in a form compliant to node/npm, this can be fully managed by npm (or yarn).</p>
 </div>
 </div>
 <div class="sect2 language-n4js">
-<h3 id="_component-types"><a class="anchor" href="#_component-types"></a><a class="link" href="#_component-types">12.2. Component Types</a></h3>
+<h3 id="Component_Types"><a class="anchor" href="#Component_Types"></a><a class="link" href="#Component_Types">12.2. Component Types</a></h3>
 <div class="paragraph">
-<p>Different N4JS component types are described in this section.
-At compile time and runtime, dependent components have to be available.
-This is the responsibility of the user interface (<a href="#AC">IDE</a> or <a href="#AC">CLI</a>) and described in the <a href="#AC">N4IDE</a> specification.</p>
+<p>Different N4JS component types are described in this section.</p>
 </div>
 <div class="sect3">
 <h4 id="_libraries"><a class="anchor" href="#_libraries"></a><a class="link" href="#_libraries">12.2.1. Libraries</a></h4>
@@ -21866,6 +21660,18 @@
 </div>
 <div class="sect3">
 <h4 id="_runtime-environment-and-runtime-libraries"><a class="anchor" href="#_runtime-environment-and-runtime-libraries"></a><a class="link" href="#_runtime-environment-and-runtime-libraries">12.2.2. Runtime Environment and Runtime Libraries</a></h4>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title=""></i>
+</td>
+<td class="content">
+runtime environments are not fully implemented at this time (see GH-1291).
+</td>
+</tr>
+</table>
+</div>
 <div class="paragraph">
 <p>Runtime environments and libraries define globally available elements (types, variables, functions) provided by the JavaScript engine.
 Both must contain <em>only</em> definition files (n4jsd) of which all elements are marked as <code>@ProvidedByRuntime</code> (<a href="#_runtime-definitions">Runtime Definitions</a>) and <code>@Global</code> (<a href="#_global-definitions">Global Definitions</a>).</p>
@@ -21955,31 +21761,19 @@
 </div>
 </div>
 <div class="sect2 language-n4js">
-<h3 id="_component-content"><a class="anchor" href="#_component-content"></a><a class="link" href="#_component-content">12.3. Component Content</a></h3>
-<div class="paragraph">
-<p>A component is similar to a project in the N4JS IDE. It consists of sources and test sources.
-These items are contained in separate folders alongside output folders and settings specified in the <code>package.json</code> file.
-The <code>package.json</code> file serves as the project description file and is stored at the root of the project (see <a href="#package-json">Package.json File</a> for details).</p>
-</div>
-<div class="paragraph">
-<p>For build and production purposes, other files such as <code>pom.xml</code> or <code>.project</code> files are automatically derived from the <code>package.json</code>.
-These files are not to be added manually.</p>
-</div>
-</div>
-<div class="sect2 language-n4js">
-<h3 id="package-json"><a class="anchor" href="#package-json"></a><a class="link" href="#package-json">12.4. Package.json File</a></h3>
+<h3 id="package-json"><a class="anchor" href="#package-json"></a><a class="link" href="#package-json">12.3. Package.json File</a></h3>
 <div class="paragraph">
 <p>A folder is a "component" if and only if it contains a <code>package.json</code> file. Being a component means
 that this folder is recognized by all N4JS-related tools but does not necessarily mean the component
 contains N4JS code (it could just contain plain Javascript). The main benefit of being a component
-in this sense is that this unit of code can be used from N4JS components as a dependency.</p>
+in this sense is that this unit of code can be used by other N4JS components as a dependency.</p>
 </div>
 <div class="paragraph">
 <p>For example, a plain npm project containing only plain Javascript can be a component and
-can therefore be used as a project dependency of a full-blown N4JS project.</p>
+can therefore be used as a project dependency of a full-blown N4JS component.</p>
 </div>
 <div class="sect3">
-<h4 id="_basic-properties"><a class="anchor" href="#_basic-properties"></a><a class="link" href="#_basic-properties">12.4.1. Basic Properties</a></h4>
+<h4 id="_basic-properties"><a class="anchor" href="#_basic-properties"></a><a class="link" href="#_basic-properties">12.3.1. Basic Properties</a></h4>
 <div class="paragraph">
 <p>The following standard <code>package.json</code> properties are used by N4JS tooling. Unless otherwise
 noted, all these properties have the exact same format and meaning as usual in <code>package.json</code>
@@ -22024,11 +21818,24 @@
 used for <code>.n4js</code> files; in that case, property "mainModule" has to be used
 (see below).</p>
 </dd>
+<dt class="hdlist1">workspaces </dt>
+<dd>
+<p>(array of strings) Property used by package management tool <code>yarn</code> to denote
+that a project serves as a "yarn workspace" and to denote the other projects
+that form the members of this yarn workspace. For details, see
+<a href="https://yarnpkg.com/lang/en/docs/workspaces">here</a>.
+In N4JS, a project is called a "yarn workspace root" if and only if its
+<code>package.json</code> file contains top-level property "workspaces", no matter the property&#8217;s
+value (i.e. it will be called "yarn workspace root" even if the value of property
+"workspaces" is the empty array or an invalid value such as a number). The nested
+projects referred to via the strings in this property&#8217;s array value are called
+"member projects" of the yarn workspace.</p>
+</dd>
 </dl>
 </div>
 </div>
 <div class="sect3">
-<h4 id="_n4js-properties"><a class="anchor" href="#_n4js-properties"></a><a class="link" href="#_n4js-properties">12.4.2. N4JS Properties</a></h4>
+<h4 id="_n4js-properties"><a class="anchor" href="#_n4js-properties"></a><a class="link" href="#_n4js-properties">12.3.2. N4JS Properties</a></h4>
 <div class="paragraph">
 <p>In addition to the standard properties above, there is a single N4JS-specific
 top-level property called "n4js". The value of this property must always be
@@ -22043,7 +21850,7 @@
 <dl>
 <dt class="hdlist1">application</dt>
 <dd>
-<p>An application. See <a href="#Apps">[Apps]</a>.</p>
+<p>An application. See <a href="#App">[App]</a>.</p>
 </dd>
 <dt class="hdlist1">library</dt>
 <dd>
@@ -22061,11 +21868,13 @@
 <dt class="hdlist1">api</dt>
 <dd>
 <p>For N4JS projects that contain only API (in <code>.n4jsd</code> files) to be implemented by other,
-so-called implementation projects. See properties "implementationId", "implementedProjects".</p>
+so-called implementation projects. See properties "implementationId", "implementedProjects".
+NOTE: the API/Implementation concept is not fully implemented at this time (see GH-1291).</p>
 </dd>
 <dt class="hdlist1">runtimeEnvironment</dt>
 <dd>
-<p>Runtime environments. See <a href="#_runtime-environment-resolution">Runtime Environment Resolution</a>.</p>
+<p>Runtime environments. See <a href="#Runtime Environment Resolution">[Runtime Environment Resolution]</a>.
+NOTE: runtime environments are not fully implemented at this time (see GH-1291).</p>
 </dd>
 <dt class="hdlist1">runtimeLibrary</dt>
 <dd>
@@ -22103,7 +21912,7 @@
 <dt class="hdlist1">sources</dt>
 <dd>
 <p>(object) Defines various sub-folders where sources, etc. are located. All properties
-of the given object must have to following format: the name must be "source", "external",
+of the given object must have the following format: the name must be "source", "external",
 or "test"; the value must be an array of strings, with each string defining a
 path relative to the component&#8217;s root folder, pointing to a folder where
 source files of the corresponding type are located. For example, paths given via name
@@ -22132,11 +21941,6 @@
 to declarations inside these modules.
 Note that switching off validation for n4js files is disallowed.</p>
 </dd>
-<dt class="hdlist1">noModuleWrap</dt>
-<dd>
-<p>Files matching this filter are not wrapped into modules and they are not semantically validated.
-Since they are assumed to be wrapped into modules, declarations inside these modules cannot be referenced by n4js code.</p>
-</dd>
 </dl>
 </div>
 </dd>
@@ -22157,9 +21961,6 @@
 			"module": "xyz*",
 			"sourceContainer": "src/n4js"
 		}
-	],
-	"noModuleWrap": [
-		// syntax same as for noValidate above
 	]
 }</code></pre>
 </div>
@@ -22190,7 +21991,7 @@
 <dd>
 <p>(string) If this property is defined, this component is called an "implementation project" and the string value
   provides a unique identifier for the implementation provided in this component. If this is defined, property
-  "implementedProjects" must be defined as well. For details, see <a href="#_api-and-implementation-components">API and Implementation Components</a>.</p>
+  "implementedProjects" must be defined as well. For details, see <a href="#API and Implementation Components">[API and Implementation Components]</a>.</p>
 <div class="paragraph">
 <p>Only projects of type "application", "processor", "library", "api" or "validation" may declare this property.</p>
 </div>
@@ -22203,7 +22004,7 @@
 <dd>
 <p>(array) A list of API components (components of type "api") that are implemented by this component. If this
 is defined, property "implementationId" must be defined as well. For details, see
-<a href="#_api-and-implementation-components">API and Implementation Components</a>. Only components of type  "application", "processor", "library", "api"
+<a href="#API and Implementation Components">[API and Implementation Components]</a>. Only components of type  "application", "processor", "library", "api"
 or "validation" may declare this property.</p>
 </dd>
 </dl>
@@ -22217,30 +22018,6 @@
  required runtime library must also be specified as a dependency using one of the top-level
  properties <code>dependencies</code> or <code>devDependencies</code>.</p>
 </dd>
-<dt class="hdlist1">moduleLoader</dt>
-<dd>
-<p>(string) This property defines what module loaders are supported by the modules in this component. Possible values are the following:</p>
-<div class="dlist">
-<dl>
-<dt class="hdlist1">n4js</dt>
-<dd>
-<p>(default) The modules in this component can be loaded with SystemJS or with CommonJS.</p>
-</dd>
-<dt class="hdlist1">commonjs</dt>
-<dd>
-<p>Modules in this component must be loaded with CommonJS. When these modules are referenced in
-generated code (i.e. when importing from these modules), the module specifier will be prefixed
-with <code>@@cjs/</code>.</p>
-</dd>
-<dt class="hdlist1">node_builtin</dt>
-<dd>
-<p>Modules in this component represent node built-in modules such as fs or https. When these modules
-are referenced in generated code (i.e. when importing from these modules), the module specifier will
-be prefixed with <code>@node/</code>.</p>
-</dd>
-</dl>
-</div>
-</dd>
 <dt class="hdlist1">extendedRuntimeEnvironment</dt>
 <dd>
 <p>(string) The name of the runtime environment project that is extended by this component. Only components of
@@ -22251,22 +22028,6 @@
 <p>(array) The list of runtime library components that are provided by this component. Only components of
 type "runtime environment" may declare this property.</p>
 </dd>
-<dt class="hdlist1">initModules</dt>
-<dd>
-<p>(array) A list of modules in terms of module specifiers (strings), that are executed when the component
-is initialized. This property may only be declared by components of type "runtime environment" and "runtime library".</p>
-<div class="paragraph">
-<p>These init modules are executed right before the execution of a user-specified module starts. They may be used to initialize
- polyfills or perform other initialization work with regard to the execution environment (e.g. define global properties).</p>
-</div>
-</dd>
-<dt class="hdlist1">execModule</dt>
-<dd>
-<p>(string) The module specifier of the exec module of a runtime environment. This property may only be declared by components
-of type "runtime environment" and "runtime library". The exec module of a runtime environment is executed as the entry-point
-to the execution of a user-specified module. The underlying script must interpret the execution data and trigger the actual
-module execution in the runtime environment.</p>
-</dd>
 </dl>
 </div>
 <div id="package-json-definesPackage" class="dlist">
@@ -22316,12 +22077,14 @@
 </tr>
 <tr>
 <td class="tableblock halign-left valign-top"><p class="tableblock">sources</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">a single source-container of type "source" with path "."</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">a single source-container of type "source" with path "." (except for yarn workspace roots, see below)</p></td>
 </tr>
 </tbody>
 </table>
 <div class="paragraph">
-<p>All other properties are undefined if not given in the <code>package.json</code> file.</p>
+<p>All other properties are undefined if not given in the <code>package.json</code> file. The default source folder of "." does not
+apply to projects that represent the root folder of a yarn workspace; those projects do not have any source folder,
+by default.</p>
 </div>
 <div class="exampleblock">
 <div class="title">Example 103. A package.json file with N4JS-specific properties.</div>
@@ -22368,9 +22131,6 @@
 					"module": "xyz*",
 					"sourceContainer": "src/n4js"
 				}
-			],
-			"noModuleWrap": [
-				// syntax same as for noValidate above
 			]
 		},
 		"requiredRuntimeLibraries": [
@@ -22384,7 +22144,7 @@
 </div>
 </div>
 <div class="sect3">
-<h4 id="_constraints"><a class="anchor" href="#_constraints"></a><a class="link" href="#_constraints">12.4.3. Constraints</a></h4>
+<h4 id="_constraints"><a class="anchor" href="#_constraints"></a><a class="link" href="#_constraints">12.3.3. Constraints</a></h4>
 <div class="paragraph">
 <p>The following constraints apply.</p>
 </div>
@@ -22519,7 +22279,7 @@
 </div>
 </div>
 <div class="sect2 language-n4js">
-<h3 id="_support-for-npm-scopes"><a class="anchor" href="#_support-for-npm-scopes"></a><a class="link" href="#_support-for-npm-scopes">12.5. Support for NPM Scopes</a></h3>
+<h3 id="_support-for-npm-scopes"><a class="anchor" href="#_support-for-npm-scopes"></a><a class="link" href="#_support-for-npm-scopes">12.4. Support for NPM Scopes</a></h3>
 <div class="paragraph">
 <p>NPM supports a namespace concept for npm packages. Such namespaces are called "scopes". For details see
 <a href="https://docs.npmjs.com/misc/scope" class="bare">https://docs.npmjs.com/misc/scope</a> and <a href="https://docs.npmjs.com/getting-started/scoped-packages" class="bare">https://docs.npmjs.com/getting-started/scoped-packages</a>.
@@ -22604,113 +22364,8 @@
 </div>
 </div>
 </div>
-<div class="sect2 language-n4js">
-<h3 id="_component-dependencies"><a class="anchor" href="#_component-dependencies"></a><a class="link" href="#_component-dependencies">12.6. Component Dependencies</a></h3>
-<div class="paragraph">
-<p>There are several dependencies between components.
-We can distinguish between <em>require</em> dependencies and <em>provide</em> dependencies.</p>
-</div>
-<div class="dlist">
-<dl>
-<dt class="hdlist1">require</dt>
-<dd>
-<p><em>N4JS Components</em> require:</p>
-<div class="ulist">
-<ul>
-<li>
-<p><em>APIs</em></p>
-</li>
-<li>
-<p><em>RuntimeLiberaries</em> and</p>
-</li>
-<li>
-<p><em>Libraries</em></p>
-</li>
-</ul>
-</div>
-</dd>
-<dt class="hdlist1">provide</dt>
-<dd>
-<div class="ulist">
-<ul>
-<li>
-<p><em>Runtime Environments</em> provide <em>Runtime Libraries</em> and maybe extend other <em>Runtime Environments</em> (which means they provide the same runtime libraries as the extended environments and the same base types).</p>
-</li>
-<li>
-<p><em>SysLibs</em> implement (<em>provide implementations</em> of) <em>APIs</em></p>
-</li>
-</ul>
-</div>
-</dd>
-</dl>
-</div>
-<div class="sect3">
-<h4 id="_runtime-environment-resolution"><a class="anchor" href="#_runtime-environment-resolution"></a><a class="link" href="#_runtime-environment-resolution">12.6.1. Runtime Environment Resolution</a></h4>
-<div class="paragraph">
-<p>In order to execute (run, debug, or test) an <em>N4JS Component</em>, an actual <em>runner</em> has to be determined.
-Since runners support runtime environments, this basically means calculating runtime environments which provide all necessary runtime libraries needed by the component.
-This is done by computing the transitive closure of required runtime libraries and by comparing that with the transitive closure of runtime libraries provided by an environment.</p>
-</div>
-<div class="openblock definition">
-<div class="content">
-<div class="paragraph">
-<p><a id="transitive_component_dependencies"></a><strong>Definition:</strong> <a href="#transitive_component_dependencies">Transitive Component Dependencies</a></p>
-</div>
-<div class="paragraph">
-<p>We defined the following transitive closures of dependencies:</p>
-</div>
-<div class="paragraph">
-<p>For a given N4JS Component <code>C</code> we define</p>
-</div>
-<div class="openblock">
-<div class="content">
-<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mtable><mtr><mtd><mi>C</mi><mo>.</mo><mi>r</mi><mi>e</mi><mi>q</mi><mi>u</mi><mi>i</mi><mi>r</mi><mi>e</mi><mi>d</mi><mi>A</mi><mi>P</mi><mi>I</mi><msup><mi>s</mi><mo>*</mo></msup></mtd><mtd><mo>=</mo><mi>C</mi><mo>.</mo><mi>r</mi><mi>e</mi><mi>q</mi><mi>u</mi><mi>i</mi><mi>r</mi><mi>e</mi><mi>d</mi><mi>P</mi><mi>I</mi><mi>s</mi></mtd></mtr><mtr><mtd/><mtd><mspace width="4.0em"/><mo>∪</mo></mtd></mtr><mtr><mtd/><mtd><munder><mo>⋃</mo><mrow><mi>L</mi><mo>∈</mo><mi>C</mi><mo>.</mo><mi>r</mi><mi>e</mi><mi>q</mi><mi>u</mi><mi>i</mi><mi>r</mi><mi>e</mi><mi>d</mi><mi>L</mi><mi>i</mi><mi>b</mi><mi>s</mi></mrow></munder><mi>C</mi><mo>.</mo><mi>r</mi><mi>e</mi><mi>q</mi><mi>u</mi><mi>i</mi><mi>r</mi><mi>e</mi><mi>d</mi><mi>P</mi><mi>I</mi><msup><mi>s</mi><mo>*</mo></msup></mtd></mtr><mtr><mtd/><mtd><mspace width="4.0em"/><mo>∪</mo></mtd></mtr><mtr><mtd/><mtd><munder><mo>⋃</mo><mrow><mi>S</mi><mo>∈</mo><mi>C</mi><mo>.</mo><mi>r</mi><mi>e</mi><mi>q</mi><mi>u</mi><mi>i</mi><mi>r</mi><mi>e</mi><mi>d</mi><mi>A</mi><mi>P</mi><mi>I</mi><mi>s</mi></mrow></munder><mi>S</mi><mo>.</mo><mi>r</mi><mi>e</mi><mi>q</mi><mi>u</mi><mi>i</mi><mi>r</mi><mi>e</mi><mi>d</mi><mi>A</mi><mi>P</mi><mi>I</mi><msup><mi>s</mi><mo>*</mo></msup></mtd></mtr><mtr><mtd><mi>C</mi><mo>.</mo><mi>r</mi><mi>e</mi><mi>q</mi><mi>u</mi><mi>i</mi><mi>r</mi><mi>e</mi><mi>d</mi><mi>L</mi><mi>i</mi><mi>b</mi><msup><mi>s</mi><mo>*</mo></msup></mtd><mtd><mo>=</mo><mi>C</mi><mo>.</mo><mi>r</mi><mi>e</mi><mi>q</mi><mi>u</mi><mi>i</mi><mi>r</mi><mi>e</mi><mi>d</mi><mi>R</mi><mi>T</mi><mi>L</mi><mi>i</mi><mi>b</mi><mi>s</mi></mtd></mtr><mtr><mtd/><mtd><mspace width="4.0em"/><mo>∪</mo></mtd></mtr><mtr><mtd/><mtd><munder><mo>⋃</mo><mrow><mi>L</mi><mo>∈</mo><mi>C</mi><mo>.</mo><mi>r</mi><mi>e</mi><mi>q</mi><mi>u</mi><mi>i</mi><mi>r</mi><mi>e</mi><mi>d</mi><mi>L</mi><mi>i</mi><mi>b</mi><mi>s</mi></mrow></munder><mi>L</mi><mo>.</mo><mi>r</mi><mi>e</mi><mi>q</mi><mi>u</mi><mi>i</mi><mi>r</mi><mi>e</mi><mi>d</mi><mi>R</mi><mi>T</mi><mi>L</mi><mi>i</mi><mi>b</mi><msup><mi>s</mi><mo>*</mo></msup></mtd></mtr></mtable></math>
-</div>
-</div>
-<div class="paragraph">
-<p>For a given Runtime Environment <code>E</code> we define</p>
-</div>
-<div class="openblock">
-<div class="content">
-<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mtable><mtr><mtd><mi>E</mi><mo>.</mo><mi>p</mi><mi>r</mi><mi>o</mi><mi>v</mi><mi>i</mi><mi>d</mi><mi>e</mi><mi>d</mi><mi>R</mi><mi>T</mi><mi>L</mi><mi>i</mi><mi>b</mi><msup><mi>s</mi><mo>*</mo></msup></mtd><mtd><mo>=</mo><mi>E</mi><mo>.</mo><mi>p</mi><mi>r</mi><mi>o</mi><mi>v</mi><mi>i</mi><mi>d</mi><mi>e</mi><mi>d</mi><mi>R</mi><mi>T</mi><mi>L</mi><mi>i</mi><mi>b</mi><mi>s</mi></mtd></mtr><mtr><mtd/><mtd><mspace width="4.0em"/><mo>∪</mo></mtd></mtr><mtr><mtd/><mtd><munder><mo>⋃</mo><mrow><mi>E</mi><mi>S</mi><mo>∈</mo><mi>E</mi><mo>.</mo><mi>e</mi><mi>x</mi><mi>t</mi><mi>e</mi><mi>n</mi><mi>d</mi><mi>e</mi><mi>d</mi><mi>R</mi><mi>T</mi><mi>E</mi><mi>n</mi><mi>v</mi><mi>s</mi></mrow></munder><mi>E</mi><mi>S</mi><mo>.</mo><mi>E</mi><mo>.</mo><mi>p</mi><mi>r</mi><mi>o</mi><mi>v</mi><mi>i</mi><mi>d</mi><mi>e</mi><mi>d</mi><mi>R</mi><mi>T</mi><mi>L</mi><mi>i</mi><mi>b</mi><msup><mi>s</mi><mo>*</mo></msup></mtd></mtr></mtable></math>
-</div>
-</div>
-</div>
-</div>
-<div class="openblock requirement">
-<div class="content">
-<div class="paragraph">
-<p><a id="Req-IDE-162"></a><strong>Req. IDE-162:</strong> <a href="#Req-IDE-162">Runtime Environment Resolution</a> (ver. 1)</p>
-</div>
-<div class="paragraph">
-<p>An N4JS Component <code>C</code> can be executed in an runtime environment <code>E</code>, written as <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>E</mi><mo>⊨</mo><mi>C</mi></math> if the following constraints hold:<br></p>
-</div>
-<div class="olist arabic">
-<ol class="arabic">
-<li>
-<p>The environment must provide all runtime libraries transitively required by the component:</p>
-<div class="openblock">
-<div class="content">
-<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mo>∀</mo><mi>R</mi><mo>∈</mo><mi>C</mi><mo>.</mo><mi>r</mi><mi>e</mi><mi>q</mi><mi>u</mi><mi>i</mi><mi>r</mi><mi>e</mi><mi>d</mi><mi>R</mi><mi>T</mi><mi>L</mi><mi>i</mi><mi>b</mi><msup><mi>s</mi><mo>*</mo></msup><mi>:</mi><mi>R</mi><mo>∈</mo><mi>E</mi><mo>.</mo><mi>p</mi><mi>r</mi><mi>o</mi><mi>v</mi><mi>i</mi><mi>d</mi><mi>e</mi><mi>d</mi><mi>R</mi><mi>T</mi><mi>L</mi><mi>i</mi><mi>b</mi><msup><mi>s</mi><mo>*</mo></msup></math>
-</div>
-</div>
-</li>
-<li>
-<p>There exist libraries which can be executed by the environment, so that all APIs are implemented:</p>
-<div class="openblock">
-<div class="content">
-<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mo>∀</mo><mi>S</mi><mo>∈</mo><mi>C</mi><mo>.</mo><mi>r</mi><mi>e</mi><mi>q</mi><mi>u</mi><mi>i</mi><mi>r</mi><mi>e</mi><mi>d</mi><mi>A</mi><mi>P</mi><mi>I</mi><msup><mi>s</mi><mo>*</mo></msup><mi>:</mi><mo>∃</mo><mi>I</mi><mi>:</mi><mi>S</mi><mo>∈</mo><mi>I</mi><mo>.</mo><mi>i</mi><mi>m</mi><mi>p</mi><mi>l</mi><mi>e</mi><mi>m</mi><mi>e</mi><mi>n</mi><mi>t</mi><mi>e</mi><mi>d</mi><mi>A</mi><mi>P</mi><mi>I</mi><mi>s</mi><mo>∧</mo><mi>E</mi><mo>⊨</mo><mi>I</mi></math>
-</div>
-</div>
-</li>
-</ol>
-</div>
-</div>
-</div>
-</div>
-</div>
 <div class="sect2">
-<h3 id="sec:N4JS-Type-Definitions"><a class="anchor" href="#sec:N4JS-Type-Definitions"></a><a class="link" href="#sec:N4JS-Type-Definitions">12.7. N4JS Type Definitions</a></h3>
+<h3 id="sec:N4JS-Type-Definitions"><a class="anchor" href="#sec:N4JS-Type-Definitions"></a><a class="link" href="#sec:N4JS-Type-Definitions">12.5. N4JS Type Definitions</a></h3>
 <div class="paragraph">
 <p>N4JS projects can depend on ordinary JavaScript projects by including them in the package.json file.
 From there on, modules of those JavaScript projects can be imported when writing N4JS code.
@@ -22720,7 +22375,7 @@
 To refer to a JavaScript npm, the term <em>plain-JS project</em> will be used.</p>
 </div>
 <div class="sect3">
-<h4 id="_specify-type-definition"><a class="anchor" href="#_specify-type-definition"></a><a class="link" href="#_specify-type-definition">12.7.1. Specify Type Definition</a></h4>
+<h4 id="_specify-type-definition"><a class="anchor" href="#_specify-type-definition"></a><a class="link" href="#_specify-type-definition">12.5.1. Specify Type Definition</a></h4>
 <div class="paragraph">
 <p>A type definition project is structured like a normal npm.
 The major difference is that it provides n4jsd files instead of js files.
@@ -22743,13 +22398,17 @@
 <div class="paragraph">
 <p>The project type declares this project to be a type definition projects.
 Consequently, it has to also declare the name for which plain-JS project its type definitions are provided (using <code>definesPackage</code>).
-Lastly, the main module has to be specified since this information will not be taken from the package.json of the plain-JS project.
-In case the plain-JS project does not have a main module or the main module is located at the package root,
-the mainModule property can be omitted.</p>
+Lastly, the main module has to be specified since this information will not be taken from the package.json of the plain-JS project.</p>
+</div>
+<div class="paragraph">
+<p>A type definition project may only define a main module if the corresponding plain-JS project defines a main module. In this case,
+the main module of the type definition project may have a different fully-qualified name / module specifier (but should, of course,
+define the types provided by the plain-JS project&#8217;s main module). This is possible, because in client code the import of a main
+module will always look the same, no matter the main module&#8217;s fully-qualified name / module specifier.</p>
 </div>
 </div>
 <div class="sect3">
-<h4 id="_name-conventions"><a class="anchor" href="#_name-conventions"></a><a class="link" href="#_name-conventions">12.7.2. Name Conventions</a></h4>
+<h4 id="_name-conventions"><a class="anchor" href="#_name-conventions"></a><a class="link" href="#_name-conventions">12.5.2. Name Conventions</a></h4>
 <div class="paragraph">
 <p>A type definition package can have an arbitrary name and define an arbitrary npm package.
 This can be handy for testing purposes or just creating some temporary type definitions for a local package.
@@ -22760,7 +22419,7 @@
 </div>
 </div>
 <div class="sect3">
-<h4 id="_version-conventions"><a class="anchor" href="#_version-conventions"></a><a class="link" href="#_version-conventions">12.7.3. Version Conventions</a></h4>
+<h4 id="_version-conventions"><a class="anchor" href="#_version-conventions"></a><a class="link" href="#_version-conventions">12.5.3. Version Conventions</a></h4>
 <div class="paragraph">
 <p>Since the plain-JS project will evolve over time and publish different versions, the need arises to also
 publish the type definition project in different versions that reflect this evolution.
@@ -22774,7 +22433,7 @@
 we propose the following conventions to partially align the type definition project&#8217;s version to that of the plain-JS project.</p>
 </div>
 <div class="sect4">
-<h5 id="_define-a-new-type-definition-package"><a class="anchor" href="#_define-a-new-type-definition-package"></a><a class="link" href="#_define-a-new-type-definition-package">12.7.3.1. Define a New Type Definition Package</a></h5>
+<h5 id="_define-a-new-type-definition-package"><a class="anchor" href="#_define-a-new-type-definition-package"></a><a class="link" href="#_define-a-new-type-definition-package">12.5.3.1. Define a New Type Definition Package</a></h5>
 <div class="paragraph">
 <p>We use the following convention to compute the version of type definition packages.</p>
 </div>
@@ -22806,7 +22465,7 @@
 </div>
 </div>
 <div class="sect4">
-<h5 id="_using-a-type-definition-package"><a class="anchor" href="#_using-a-type-definition-package"></a><a class="link" href="#_using-a-type-definition-package">12.7.3.2. Using a Type Definition Package</a></h5>
+<h5 id="_using-a-type-definition-package"><a class="anchor" href="#_using-a-type-definition-package"></a><a class="link" href="#_using-a-type-definition-package">12.5.3.2. Using a Type Definition Package</a></h5>
 <div class="paragraph">
 <p>On the client side, a type definition package is listed among the dependency section.
 Here we use the following convention to specify the required version of a type definition package.</p>
@@ -22841,7 +22500,7 @@
 </div>
 </div>
 <div class="sect4">
-<h5 id="_rational"><a class="anchor" href="#_rational"></a><a class="link" href="#_rational">12.7.3.3. Rational</a></h5>
+<h5 id="_rational"><a class="anchor" href="#_rational"></a><a class="link" href="#_rational">12.5.3.3. Rational</a></h5>
 <div class="paragraph">
 <p>The rational behind this convention reflects the idea of semantic versioning:</p>
 </div>
@@ -22886,9 +22545,9 @@
 </div>
 </div>
 <div class="sect2 language-n4js">
-<h3 id="_modules"><a class="anchor" href="#_modules"></a><a class="link" href="#_modules">12.8. Modules</a></h3>
+<h3 id="_modules"><a class="anchor" href="#_modules"></a><a class="link" href="#_modules">12.6. Modules</a></h3>
 <div class="paragraph">
-<p>All N4JS files are modules, sometimes also called compilation unit (CU).
+<p>Each N4JS source file defines a module in the sense of ECMAScript2015, [<a href="#ECMA15a">ECMA15a(p.S14)</a>].
 This is the overall structure of a module, based on [<a href="#ECMA15a">ECMA15a(p.S14)</a>].</p>
 </div>
 <div class="listingblock">
@@ -22919,111 +22578,21 @@
 module under the given alias (which is similar to the original name if no alias is defined).
 The name of the module is its project’s source folder’s relative path without any extension, see <a href="#_qualified-names">Qualified Names</a> for details.</p>
 </div>
-<div class="paragraph">
-<p>This are the properties of script, which can be specified by the user:</p>
-</div>
-<div class="dlist">
-<dl>
-<dt class="hdlist1"><code>annotations</code> </dt>
-<dd>
-<p>Arbitrary annotations, see <a href="#_annotations">Annotations</a> and below for details.</p>
-</dd>
-<dt class="hdlist1"><code>scriptElements</code></dt>
-<dd>
-<p>The content of the script.</p>
-</dd>
-</dl>
-</div>
-<div class="paragraph">
-<p>And we additionally define the following pseudo properties:</p>
-</div>
-<div class="dlist">
-<dl>
-<dt class="hdlist1"><code>path</code> </dt>
-<dd>
-<p>File system path (path delimiter is always <code>’/’</code>) relative to the source fragment of the file without the extension.
-E.g.: given a source folder <code>src</code>, <code>path</code> of a module located at:</p>
-<div class="ulist">
-<ul>
-<li>
-<p><code>src/n4/lang/List.js</code> is <code>n4/lang/List</code></p>
-</li>
-<li>
-<p><code>src/n4/lang/Objects.prototypes</code> is <code>n4/lang/Objects</code></p>
-</li>
-</ul>
-</div>
-</dd>
-<dt class="hdlist1"><code>expandedPath</code> </dt>
-<dd>
-<p>Pseudo property consists of the project name and project version of the module followed by the path,
-the concrete syntax is: <code>&lt;project.name&gt;-&lt;project.version&gt;/&lt;module.path&gt;</code> where project version includes all version parts except the qualifier.</p>
-<div class="paragraph">
-<p>E.g. given a module with path <code>n4/lang/List</code> in a project <code>lib</code> with
-version <code>1.0.0</code>, the <code>expandedPath</code> is <code>lib-1.0.0/n4/lang/List</code>.</p>
-</div>
-</dd>
-<dt class="hdlist1"><code>loadtimeDeps</code> </dt>
-<dd>
-<p>Pseudo property contains all load time dependencies of this module.</p>
-</dd>
-<dt class="hdlist1"><code>runtimeDeps</code> </dt>
-<dd>
-<p>Pseudo property contains all runtime dependencies of this module.</p>
-</dd>
-<dt class="hdlist1"><code>allDeps</code> </dt>
-<dd>
-<p>Pseudo property contains all dependencies of this module.
-This is the union of <em>loadtimeDeps</em> and <em>runtimeDeps</em> which maintains the ordering of both lists, with the <em>loadtimeDeps</em> at the front.</p>
-</dd>
-</dl>
-</div>
-<div class="paragraph">
-<p>Pseudo properties to be set via annotations are explained in <a href="#_annotations">Annotations</a>.</p>
-</div>
 </div>
 <div class="sect2 language-n4js">
-<h3 id="_properties-files"><a class="anchor" href="#_properties-files"></a><a class="link" href="#_properties-files">12.9. Properties Files</a></h3>
-<div class="paragraph">
-<p>Properties files have the file extension <code>properties</code> and describe how to localize text in a project.
-They basically define keys <a href="#_primitive-pathselector-and-i18nkey">Primitive Pathselector and I18nKey</a> with their values.
-The key is used during runtime to retrieve text localized to the user’s locale.</p>
+<h3 id="_api-and-implementation-component"><a class="anchor" href="#_api-and-implementation-component"></a><a class="link" href="#_api-and-implementation-component">12.7. API and Implementation Component</a></h3>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title=""></i>
+</td>
+<td class="content">
+the API/Implementation concept is not fully implemented at this time (see GH-1291).
+</td>
+</tr>
+</table>
 </div>
-<div class="sect3">
-<h4 id="property-file-syntax"><a class="anchor" href="#property-file-syntax"></a><a class="link" href="#property-file-syntax">12.9.1. Syntax</a></h4>
-<div class="paragraph">
-<p>The syntax of a resource file is defined as:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlight"><code class="language-xtext" data-lang="xtext">ResourceFile:   Comment* | $entry+=$ Entry*;
-Comment:        'pass:[#]' .* EOL;
-Entry:          $key$ = KeyIdentifier '=' $value$ = .* EOL;
-KeyIdentifier:  LETTER (DIGIT | LETTER | '.')*;</code></pre>
-</div>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_constraints-2"><a class="anchor" href="#_constraints-2"></a><a class="link" href="#_constraints-2">12.9.2. Constraints</a></h4>
-<div class="paragraph">
-<p>Properties files have to be stored in source fragment of type source.
-The <em>base folder</em> for storing the properties files of a project <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>p</mi></math> is <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>p</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mstyle mathvariant="monospace"><mtext>/nls</mtext></mstyle></math>.
-The language-specific resource files are stored in subfolders of the base folder.
-The base language (normally english) has to be located in a subfolder of the base folder.
-The resource files for other languages have to be located in a subfolder with the name given by syntax <code>&lt;ISO Language Code&gt;_&lt;ISO Country Code&gt;</code>,
-where ISO Language Code is given by the ISO-639 standard and ISO Country Code is given by the ISO-3166 standard.</p>
-</div>
-<div class="paragraph">
-<p>All resource files stored in a language folder are compiled to a JavaScript file which exports all resource keys as an object literal.</p>
-</div>
-<div class="paragraph">
-<p>The resource files of a project are automatically loaded.
-To access a resource key <code>key</code> stored in a resource file <code>my.properties</code>, you have to use the file name as a prefix (e.g. you have to use the key <code>my.key</code>).</p>
-</div>
-</div>
-</div>
-<div class="sect2 language-n4js">
-<h3 id="_api-and-implementation-components"><a class="anchor" href="#_api-and-implementation-components"></a><a class="link" href="#_api-and-implementation-components">12.10. API and Implementation Components</a></h3>
 <div class="paragraph">
 <p>Instead of providing an implementation, N4JS components may only define an API by way of one or more n4jsd files which is then implemented by separate implementation projects.
 For one such API project, several implementation projects may be provided.
@@ -23080,7 +22649,7 @@
 </ul>
 </div>
 <div class="sect3">
-<h4 id="_execution-of-api-and-implementation-components"><a class="anchor" href="#_execution-of-api-and-implementation-components"></a><a class="link" href="#_execution-of-api-and-implementation-components">12.10.1. Execution of API and Implementation Components</a></h4>
+<h4 id="_execution-of-api-and-implementation-components"><a class="anchor" href="#_execution-of-api-and-implementation-components"></a><a class="link" href="#_execution-of-api-and-implementation-components">12.7.1. Execution of API and Implementation Components</a></h4>
 <div class="paragraph">
 <p>When launching an N4JS component <em>C</em> under runtime environment <a href="#AC">RE</a>, the user may(!) provide an implementation ID <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>I</mi><mspace width="-0.167em"/><mi>I</mi><mspace width="-0.167em"/><mi>D</mi></math> to run.
 Then, for each API project <em>A</em> in the direct or indirect dependencies of <em>C</em> an implementation project is chosen as follows:</p>
@@ -23129,9 +22698,8 @@
 output folder (esp. when constructing a <code>class path</code>) and when loading or importing a type from <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>A</mi><mi>n</mi></msub></math> return the corresponding type with the same fully-qualified name from <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>I</mi><mi>n</mi></msub></math>.</p>
 </div>
 </div>
-</div>
-<div class="sect2 language-n4js">
-<h3 id="_api-and-implementation-with-di"><a class="anchor" href="#_api-and-implementation-with-di"></a><a class="link" href="#_api-and-implementation-with-di">12.11. API and Implementation With DI</a></h3>
+<div class="sect3 language-n4js">
+<h4 id="_api-and-implementation-with-di"><a class="anchor" href="#_api-and-implementation-with-di"></a><a class="link" href="#_api-and-implementation-with-di">12.7.2. API and Implementation With DI</a></h4>
 <div class="paragraph">
 <p>API projects may use N4JS DI (<a href="#_dependency-injection">Dependency Injection</a>) language features which require Implementation projects to provide DI-compatible behaviour
 in order to allow a Client (implemented against an API project) to be executed with a given Implementation project.
@@ -23144,7 +22712,7 @@
 <div class="content">
 <img src="chapters/12_components/fig/diag_ApiTestsDI_Overview.svg" alt="diag ApiTestsDI Overview">
 </div>
-<div class="title">Figure 12. Overview of API tests with DI</div>
+<div class="title">Figure 13. Overview of API tests with DI</div>
 </div>
 <div class="paragraph">
 <p>Static DI mechanisms in N4JS allow an API project to enforce Implementation projects to provide all necessary information.
@@ -23157,7 +22725,7 @@
 <div class="content">
 <img src="chapters/12_components/fig/diag_ApiTestsDI_StaticDI.svg" alt="diag ApiTestsDI StaticDI">
 </div>
-<div class="title">Figure 13. API tests with static DI</div>
+<div class="title">Figure 14. API tests with static DI</div>
 </div>
 <div class="paragraph">
 <p>During Client execution, weather it is test execution or not, N4JS mechanisms will replace the API project with a proper Implementation project.
@@ -23170,7 +22738,8 @@
 <div class="content">
 <img src="chapters/12_components/fig/diag_ApiTestsDI_Views.svg" alt="diag ApiTestsDI Views">
 </div>
-<div class="title">Figure 14. Types view and Instances view</div>
+<div class="title">Figure 15. Types view and Instances view</div>
+</div>
 </div>
 </div>
 </div>
@@ -23393,7 +22962,7 @@
 A possible approach is to use a structurally typed interface instead of a class to link to the implementation.</p>
 </div>
 <div class="paragraph">
-<p>In case of API-definitions (see <a href="#_api-and-implementation-components">API and Implementation Components</a>), it might be useful to limit the visibility of classes to narrower scopes such as package or private.</p>
+<p>In case of API-definitions (see <a href="#_api-and-implementation-components">[_api-and-implementation-components]</a>), it might be useful to limit the visibility of classes to narrower scopes such as package or private.</p>
 </div>
 <div class="paragraph">
 <p>External declarations can be instantiated if the following three requirements are fulfilled (not a constraint!):</p>
@@ -23454,7 +23023,7 @@
 </div>
 <div class="paragraph">
 <p>For a given external declaration <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>D</mi></math> but not for
-API-definitions <sup class="footnote">[<a id="_footnoteref_61" class="footnote" href="#_footnote_61" title="View footnote.">61</a>]</sup>, the
+API-definitions <sup class="footnote">[<a id="_footnoteref_60" class="footnote" href="#_footnote_60" title="View footnote.">60</a>]</sup>, the
 following constraints must hold:</p>
 </div>
 <div class="olist arabic">
@@ -23479,7 +23048,7 @@
 <div class="content">
 <img src="chapters/13_plainJS/fig/externalClassImplementation_naming.svg" alt="externalClassImplementation naming">
 </div>
-<div class="title">Figure 15. External Class Implementation, Naming Convention</div>
+<div class="title">Figure 16. External Class Implementation, Naming Convention</div>
 </div>
 </div>
 </div>
@@ -23580,7 +23149,7 @@
 <div class="paragraph">
 <p>N4JS supports global definitions via the annotation <code>Global</code>.
 This annotation can only be defined on modules (via <code>@@Global</code>) – this means that all declarations in the module are
-globally defined.<sup class="footnote">[<a id="_footnoteref_62" class="footnote" href="#_footnote_62" title="View footnote.">62</a>]</sup></p>
+globally defined.<sup class="footnote">[<a id="_footnoteref_61" class="footnote" href="#_footnote_61" title="View footnote.">61</a>]</sup></p>
 </div>
 <div class="paragraph">
 <p>We introduce a new pseudo property <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>g</mi><mi>l</mi><mi>o</mi><mi>b</mi><mi>a</mi><mi>l</mi></math> on all declared elements accordingly:</p>
@@ -25922,7 +25491,7 @@
 <h3 id="_object"><a class="anchor" href="#_object"></a><a class="link" href="#_object">17.1. Object</a></h3>
 <div class="paragraph">
 <p><code>Object</code> is the super type of all declared types and <code>N4Object</code>. It is almost similar to the JavaScript type <code>Object</code> except that no properties may be dynamically added to it. In order to declare a variable to which properties can be dynamically added, the <code>Object+</code> type has to be declared (cf.
-<a href="#_dynamic">Dynamic</a>).</p>
+<a href="#_dynamic">[_dynamic]</a>).</p>
 </div>
 <h4 id="_attributes" class="discrete">Attributes</h4>
 <div class="dlist">
@@ -26908,7 +26477,7 @@
 <div class="content">
 <img src="chapters/a03_n4jsobjects/fig/cd_reflectionModel.svg" alt="cd reflectionModel">
 </div>
-<div class="title">Figure 16. N4JS Reflection Classes</div>
+<div class="title">Figure 17. N4JS Reflection Classes</div>
 </div>
 <div class="paragraph">
 <p>Remark: This section is work in progress. The final goal is to provide a
@@ -27413,12 +26982,315 @@
 </div>
 </div>
 <div class="sect1">
-<h2 id="_bibliography"><a class="anchor" href="#_bibliography"></a><a class="link" href="#_bibliography">Appendix B: Bibliography</a></h2>
+<h2 id="sec:License"><a class="anchor" href="#sec:License"></a><a class="link" href="#sec:License">Appendix B: License</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>This specification and the accompanying materials is made available
+under the terms of the Eclipse Public License v1.0 which accompanies
+this distribution, and is available at <a href="http://www.eclipse.org/legal/epl-v10.html" class="bare">http://www.eclipse.org/legal/epl-v10.html</a></p>
+</div>
+<h3 id="_eclipse-public-license-v-1-0" class="discrete">Eclipse Public License - v 1.0</h3>
+<div class="paragraph">
+<p>THE ACCOMPANYING PROGRAM IS PROVIDED UNDER THE TERMS OF THIS ECLIPSE
+PUBLIC LICENSE (<code>AGREEMENT</code>). ANY USE, REPRODUCTION OR DISTRIBUTION OF
+THE PROGRAM CONSTITUTES RECIPIENT’S ACCEPTANCE OF THIS AGREEMENT.</p>
+</div>
+<h4 id="_1-definitions" class="discrete">1. DEFINITIONS</h4>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><code>Contribution</code> means: </dt>
+<dd>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>in the case of the initial Contributor, the initial code and
+documentation distributed under this Agreement, and</p>
+</li>
+<li>
+<p>in the case of each subsequent Contributor:</p>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p>changes to the Program, and</p>
+</li>
+<li>
+<p>additions to the Program;</p>
+<div class="paragraph">
+<p>where such changes and/or additions to the Program originate from and
+are distributed by that particular Contributor. A Contribution
+’originates’ from a Contributor if it was added to the Program by such
+Contributor itself or anyone acting on such Contributor’s behalf.
+Contributions do not include additions to the Program which:</p>
+</div>
+<div class="olist lowerroman">
+<ol class="lowerroman" type="i">
+<li>
+<p>are separate modules of software distributed in conjunction with the Program
+under their own license agreement, and</p>
+</li>
+<li>
+<p>are not derivative works of the Program.</p>
+</li>
+</ol>
+</div>
+</li>
+</ol>
+</div>
+</li>
+</ol>
+</div>
+</dd>
+<dt class="hdlist1"><code>Contributor</code></dt>
+<dd>
+<p>means any person or entity that distributes the Program.</p>
+</dd>
+<dt class="hdlist1"><code>Licensed Patents</code> </dt>
+<dd>
+<p>mean patent claims licensable by a Contributor
+which are necessarily infringed by the use or sale of its Contribution
+alone or when combined with the Program.</p>
+</dd>
+<dt class="hdlist1"><code>Program</code> </dt>
+<dd>
+<p>means the Contributions distributed in accordance with this
+Agreement.</p>
+</dd>
+<dt class="hdlist1"><code>Recipient</code> </dt>
+<dd>
+<p>means anyone who receives the Program under this
+Agreement, including all Contributors.</p>
+</dd>
+</dl>
+</div>
+<h4 id="_2-grant-of-rights" class="discrete">2. GRANT OF RIGHTS</h4>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Subject to the terms of this Agreement, each Contributor hereby
+grants Recipient a non-exclusive, worldwide, royalty-free copyright
+license to reproduce, prepare derivative works of, publicly display,
+publicly perform, distribute and sublicense the Contribution of such
+Contributor, if any, and such derivative works, in source code and
+object code form.</p>
+</li>
+<li>
+<p>Subject to the terms of this Agreement, each Contributor hereby
+grants Recipient a non-exclusive, worldwide, royalty-free patent license
+under Licensed Patents to make, use, sell, offer to sell, import and
+otherwise transfer the Contribution of such Contributor, if any, in
+source code and object code form. This patent license shall apply to the
+combination of the Contribution and the Program if, at the time the
+Contribution is added by the Contributor, such addition of the
+Contribution causes such combination to be covered by the Licensed
+Patents. The patent license shall not apply to any other combinations
+which include the Contribution. No hardware per se is licensed
+hereunder.</p>
+</li>
+<li>
+<p>Recipient understands that although each Contributor grants the
+licenses to its Contributions set forth herein, no assurances are
+provided by any Contributor that the Program does not infringe the
+patent or other intellectual property rights of any other entity. Each
+Contributor disclaims any liability to Recipient for claims brought by
+any other entity based on infringement of intellectual property rights
+or otherwise. As a condition to exercising the rights and licenses
+granted hereunder, each Recipient hereby assumes sole responsibility to
+secure any other intellectual property rights needed, if any. For
+example, if a third party patent license is required to allow Recipient
+to distribute the Program, it is Recipient’s responsibility to acquire
+that license before distributing the Program.</p>
+</li>
+<li>
+<p>Each Contributor represents that to its knowledge it has sufficient
+copyright rights in its Contribution, if any, to grant the copyright
+license set forth in this Agreement.</p>
+</li>
+</ol>
+</div>
+<h4 id="_3-requirements" class="discrete">3. REQUIREMENTS</h4>
+<div class="paragraph">
+<p>A Contributor may choose to distribute the Program in object code form
+under its own license agreement, provided that:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>it complies with the terms and conditions of this Agreement; and</p>
+</li>
+<li>
+<p>its license agreement:</p>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p>effectively disclaims on behalf of all Contributors all warranties
+and conditions, express and implied, including warranties or conditions
+of title and non-infringement, and implied warranties or conditions of
+merchantability and fitness for a particular purpose;</p>
+</li>
+<li>
+<p>effectively excludes on behalf of all Contributors all liability for
+damages, including direct, indirect, special, incidental and
+consequential damages, such as lost profits;</p>
+</li>
+<li>
+<p>states that any provisions which differ from this Agreement are
+offered by that Contributor alone and not by any other party; and</p>
+</li>
+<li>
+<p>states that source code for the Program is available from such
+Contributor, and informs licensees how to obtain it in a reasonable
+manner on or through a medium customarily used for software exchange.</p>
+</li>
+</ol>
+</div>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>When the Program is made available in source code form:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>it must be made available under this Agreement; and</p>
+</li>
+<li>
+<p>a copy of this Agreement must be included with each copy of the
+Program.</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>Contributors may not remove or alter any copyright notices contained
+within the Program.</p>
+</div>
+<div class="paragraph">
+<p>Each Contributor must identify itself as the originator of its
+Contribution, if any, in a manner that reasonably allows subsequent
+Recipients to identify the originator of the Contribution.</p>
+</div>
+<h4 id="_4-commercial-distribution" class="discrete">4. COMMERCIAL DISTRIBUTION</h4>
+<div class="paragraph">
+<p>Commercial distributors of software may accept certain responsibilities
+with respect to end users, business partners and the like. While this
+license is intended to facilitate the commercial use of the Program, the
+Contributor who includes the Program in a commercial product offering
+should do so in a manner which does not create potential liability for
+other Contributors. Therefore, if a Contributor includes the Program in
+a commercial product offering, such Contributor (<code>Commercial
+Contributor</code>) hereby agrees to defend and indemnify every other
+Contributor (<code>Indemnified Contributor</code>) against any losses, damages
+and costs (collectively <code>Losses</code>) arising from claims, lawsuits and
+other legal actions brought by a third party against the Indemnified
+Contributor to the extent caused by the acts or omissions of such
+Commercial Contributor in connection with its distribution of the
+Program in a commercial product offering. The obligations in this
+section do not apply to any claims or Losses relating to any actual or
+alleged intellectual property infringement. In order to qualify, an
+Indemnified Contributor must: a) promptly notify the Commercial
+Contributor in writing of such claim, and b) allow the Commercial
+Contributor to control, and cooperate with the Commercial Contributor
+in, the defense and any related settlement negotiations. The Indemnified
+Contributor may participate in any such claim at its own expense.</p>
+</div>
+<div class="paragraph">
+<p>For example, a Contributor might include the Program in a commercial
+product offering, Product X. That Contributor is then a Commercial
+Contributor. If that Commercial Contributor then makes performance
+claims, or offers warranties related to Product X, those performance
+claims and warranties are such Commercial Contributor’s responsibility
+alone. Under this section, the Commercial Contributor would have to
+defend claims against the other Contributors related to those
+performance claims and warranties, and if a court requires any other
+Contributor to pay any damages as a result, the Commercial Contributor
+must pay those damages.</p>
+</div>
+<h4 id="_5-no-warranty" class="discrete">5. NO WARRANTY</h4>
+<div class="paragraph">
+<p>EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, THE PROGRAM IS PROVIDED
+ON AN <code>AS IS</code> BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,
+EITHER EXPRESS OR IMPLIED INCLUDING, WITHOUT LIMITATION, ANY WARRANTIES
+OR CONDITIONS OF TITLE, NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR
+A PARTICULAR PURPOSE. Each Recipient is solely responsible for
+determining the appropriateness of using and distributing the Program
+and assumes all risks associated with its exercise of rights under this
+Agreement , including but not limited to the risks and costs of program
+errors, compliance with applicable laws, damage to or loss of data,
+programs or equipment, and unavailability or interruption of operations.</p>
+</div>
+<h4 id="_6-disclaimer-of-liability" class="discrete">6. DISCLAIMER OF LIABILITY</h4>
+<div class="paragraph">
+<p>EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, NEITHER RECIPIENT NOR
+ANY CONTRIBUTORS SHALL HAVE ANY LIABILITY FOR ANY DIRECT, INDIRECT,
+INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING
+WITHOUT LIMITATION LOST PROFITS), HOWEVER CAUSED AND ON ANY THEORY OF
+LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OR
+DISTRIBUTION OF THE PROGRAM OR THE EXERCISE OF ANY RIGHTS GRANTED
+HEREUNDER, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.</p>
+</div>
+<h4 id="_7-general" class="discrete">7. GENERAL</h4>
+<div class="paragraph">
+<p>If any provision of this Agreement is invalid or unenforceable under
+applicable law, it shall not affect the validity or enforceability of
+the remainder of the terms of this Agreement, and without further action
+by the parties hereto, such provision shall be reformed to the minimum
+extent necessary to make such provision valid and enforceable.</p>
+</div>
+<div class="paragraph">
+<p>If Recipient institutes patent litigation against any entity (including
+a cross-claim or counterclaim in a lawsuit) alleging that the Program
+itself (excluding combinations of the Program with other software or
+hardware) infringes such Recipient’s patent(s), then such Recipient’s
+rights granted under Section 2(b) shall terminate as of the date such
+litigation is filed.</p>
+</div>
+<div class="paragraph">
+<p>All Recipient’s rights under this Agreement shall terminate if it fails
+to comply with any of the material terms or conditions of this Agreement
+and does not cure such failure in a reasonable period of time after
+becoming aware of such noncompliance. If all Recipient’s rights under
+this Agreement terminate, Recipient agrees to cease use and distribution
+of the Program as soon as reasonably practicable. However, Recipient’s
+obligations under this Agreement and any licenses granted by Recipient
+relating to the Program shall continue and survive.</p>
+</div>
+<div class="paragraph">
+<p>Everyone is permitted to copy and distribute copies of this Agreement,
+but in order to avoid inconsistency the Agreement is copyrighted and may
+only be modified in the following manner. The Agreement Steward reserves
+the right to publish new versions (including revisions) of this
+Agreement from time to time. No one other than the Agreement Steward has
+the right to modify this Agreement. The Eclipse Foundation is the
+initial Agreement Steward. The Eclipse Foundation may assign the
+responsibility to serve as the Agreement Steward to a suitable separate
+entity. Each new version of the Agreement will be given a distinguishing
+version number. The Program (including Contributions) may always be
+distributed subject to the version of the Agreement under which it was
+received. In addition, after a new version of the Agreement is
+published, Contributor may elect to distribute the Program (including
+its Contributions) under the new version. Except as expressly stated in
+Sections 2(a) and 2(b) above, Recipient receives no rights or licenses
+to the intellectual property of any Contributor under this Agreement,
+whether expressly, by implication, estoppel or otherwise. All rights in
+the Program not expressly granted under this Agreement are reserved.</p>
+</div>
+<div class="paragraph">
+<p>This Agreement is governed by the laws of the State of New York and the
+intellectual property laws of the United States of America. No party to
+this Agreement will bring a legal action under this Agreement more than
+one year after the cause of action arose. Each party waives its rights
+to a jury trial in any resulting litigation.</p>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_bibliography"><a class="anchor" href="#_bibliography"></a><a class="link" href="#_bibliography">Appendix C: Bibliography</a></h2>
 <div class="sectionbody">
 <div class="openblock bibliography">
 <div class="content">
 <div class="paragraph">
-<p><a id="ECMA15a"></a>ECMA. (2015). <em>ECMAScript 2015 Language Specification</em>. Retrieved from <a href="http://www.ecma-international.org/publications/files/ECMA-ST/Ecma-262.pdf" class="bare">http://www.ecma-international.org/publications/files/ECMA-ST/Ecma-262.pdf</a></p>
+<p><a id="ECMA15a"></a>ECMA. (2015). <em>ECMAScript 2015 Language Specification</em>. Retrieved from <a href="http://www.ecma-international.org/ecma-262/6.0/index.html" class="bare">http://www.ecma-international.org/ecma-262/6.0/index.html</a></p>
 </div>
 <div class="paragraph">
 <p><a id="ECMA11a"></a>(2011). <em>ECMAScript Language Specification</em>. Retrieved from <a href="http://www.ecma-international.org/publications/standards/Ecma-262.htm" class="bare">http://www.ecma-international.org/publications/standards/Ecma-262.htm</a></p>
@@ -27484,6 +27356,9 @@
 <p><a id="West06a"></a>West, Mike. (2006). <em>Scope in JavaScript</em>. Retrieved from <a href="http://www.digital-web.com/articles/scope_in_javascript/" class="bare">http://www.digital-web.com/articles/scope_in_javascript/</a></p>
 </div>
 <div class="paragraph">
+<p><a id="ECMA18a"></a>ECMA. (2018). <em>ECMAScript 2018 Language Specification</em>. Retrieved from <a href="http://www.ecma-international.org/ecma-262/9.0/index.html" class="bare">http://www.ecma-international.org/ecma-262/9.0/index.html</a></p>
+</div>
+<div class="paragraph">
 <p><a id="MozillaJSRef"></a><em>JavaScript Reference</em>. Retrieved from <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference" class="bare">https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference</a></p>
 </div>
 <div class="paragraph">
@@ -27701,26 +27576,52 @@
 <a href="#_footnoteref_59">59</a>. This restriction has two reasons: Firstly, user-defined types with implementations would require to ’bootstrap’ the polyfill, which is impossible to do automatically without serious constraints on bootstrap code in general. Secondly, instead of filling user-defined types, they can be subclasses. Mechanisms such as dependency injection could then solve almost all remaining problems.
 </div>
 <div class="footnote" id="_footnote_60">
-<a href="#_footnoteref_60">60</a>. Note that this diagram does not necessarily reflect the actual internal implementation but only the external view.
+<a href="#_footnoteref_60">60</a>. <a href="#_api-and-implementation-components">[_api-and-implementation-components]</a>
 </div>
 <div class="footnote" id="_footnote_61">
-<a href="#_footnoteref_61">61</a>. <a href="#_api-and-implementation-components">API and Implementation Components</a>
-</div>
-<div class="footnote" id="_footnote_62">
-<a href="#_footnoteref_62">62</a>. Global basically means that the module defines no namespace on its own. Thus the annotation is a script/module related annotation.
+<a href="#_footnoteref_61">61</a>. Global basically means that the module defines no namespace on its own. Thus the annotation is a script/module related annotation.
 </div>
 </div>
 <div id="footer">
 <div id="footer-text">
-Version 0.4<br>
-Last updated 2018-11-06 16:56:07 CET
+Version 0.9<br>
+Last updated 2019-08-07 15:02:40 CEST
 </div>
 </div>
-<div class="social">
-	<ul class="fa-ul">
-		<li><a href="https://github.com/eclipse/n4js"><i class="fa-li fa fa-github"></i>N4JS Repository</a></li>
-	</ul>
+<!-- ************* docinfo-footer *************************************************************** -->
+<div class="Grid social" style="color:#d5dfea">
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <h2>Quick Links</h2>
+    <ul>
+      <li><a href="../downloads.html">Download</a></li>
+      <li><a href="../userguides/index.html">Documentation</a></li>
+      <li><a href="https://github.com/eclipse/n4js/">Source</a></li>
+      <li><a href="https://github.com/eclipse/n4js/issues">Issues</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="https://www.eclipse.org/forums/index.php/f/365/">Forum</a></li>
+      <li><a href="http://n4js.blogspot.de/">Blog</a></li>
+      <li><a href="https://dev.eclipse.org/mailman/listinfo/n4js-dev">Mailing List</a></li>
+      <li><a href="https://projects.eclipse.org/projects/technology.n4js">Eclipse Project Page</a></li>
+      <li><a href="https://twitter.com/n4jsdev">Tweets by n4jsdev</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="http://www.eclipse.org/">Eclipse Home</a></li>
+      <li><a href="http://www.eclipse.org/legal/privacy.php">Privacy Policy</a></li>
+      <li><a href="http://www.eclipse.org/legal/termsofuse.php">Terms of Use</a></li>
+      <li><a href="http://www.eclipse.org/legal/copyright.php">Copyright Agent</a></li>
+      <li><a href="http://www.eclipse.org/legal/">Legal</a></li>
+    </ul>
+  </div>
+  <div style="clear: both; height: 0; overflow: hidden;"></div>
 </div>
+
 <!-- ************* UI Scripts ************* -->
 <script type="text/javascript" src="scripts/back-to-top.js"></script>
 
@@ -27745,5 +27646,6 @@
 	$(".toc2 > ul").treeView();
 	// Initialize Scrollspy
 </script>
+<!-- ************* docinfo-footer *************************************************************** -->
 </body>
 </html>
\ No newline at end of file
diff --git a/spec/N4JSSpec.pdf b/spec/N4JSSpec.pdf
deleted file mode 100644
index dd1e3f9..0000000
--- a/spec/N4JSSpec.pdf
+++ /dev/null
Binary files differ
diff --git a/spec/N4JSSpec.xml b/spec/N4JSSpec.xml
new file mode 100644
index 0000000..67bab11
--- /dev/null
+++ b/spec/N4JSSpec.xml
@@ -0,0 +1,21057 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<?asciidoc-toc maxdepth="5"?>
+<?asciidoc-numbered maxdepth="5"?>
+<book xmlns="http://docbook.org/ns/docbook" xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en">
+<info>
+<title>N4JS Language Specification</title>
+<date>2019-08-07</date>
+<author>
+<personname>
+<firstname>2019-08-07 15:02:40 CEST</firstname>
+</personname>
+</author>
+<authorinitials>{</authorinitials>
+<style>
+      .admonitionblock td.icon .icon-todo:before{content:"\f249";color:#f4ee42}
+    </style>
+</info>
+<preface>
+<title></title>
+<simpara role="center"><emphasis role="strong">Last Updated: 2019-08-07</emphasis></simpara>
+<simpara role="center"><emphasis role="strong">Authors:</emphasis><?asciidoc-br?>
+Jens von Pilgrim, Jakub Siberski, Mark-Oliver Reiser, Torsten Krämer, Ákos Kitta, Sebastian Zarnekow, Lorenzo Bettini, Jörg Reichert, Kristian Duske, Marcus Mews, Minh Quang Tran, Luca Beurer-Kellner</simpara>
+<simpara><?asciidoc-pagebreak?></simpara>
+<bridgehead xml:id="_abstract" renderas="sect1">Abstract</bridgehead>
+<simpara>This document contains the N4JS Specification.</simpara>
+<simpara><?asciidoc-pagebreak?></simpara>
+</preface>
+<chapter xml:id="_introduction">
+<title>Introduction</title>
+<simpara>This specification defines the N4JS language.</simpara>
+<simpara>In general, the N4JS JavaScript dialect used is identical to the standard ECMAScript as defined in the 6th edition of
+ECMA-262, also known as ECMAScript 2015, referred to as [<link linkend="ECMA15a">ECMA15a</link>].</simpara>
+<section xml:id="_notation" role="language-n4js">
+<title>Notation</title>
+<section xml:id="_grammar-notation">
+<title>Grammar Notation</title>
+<simpara>For the specification of the syntax and structure of elements, we use a
+slightly augmented similar to the grammar language of Xtext <link xl:href="http://www.eclipse.org/Xtext/documentation/301_grammarlanguage.html">Grammar Language</link>.</simpara>
+<simpara>Similar to [<link linkend="ECMA11a">ECMA11a</link>], we define types with properties only for the purpose of explanation and usage within this specification.
+We use the Xtext notation style to assign values to meta-properties.
+Particularly, we use the Xtext notation for collection (<literal>+=</literal>) and boolean (<literal>?=</literal>) values.
+These properties are written in italics. Enumerations are defined similar to Xtext.
+In order to allow the specification of default values, which are often defined by omitting the value, we always define the literal explicitly if it can be defined by the user.</simpara>
+<simpara>The following lists informally defines the grammar:</simpara>
+<variablelist>
+<varlistentry>
+<term>Terminal</term>
+<listitem>
+<simpara>Terminals (or terminal strings) are enclosed in single quotes, e.g., <literal>terminal</literal>.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>Enumerations</term>
+<listitem>
+<simpara>Rules which contain only terminals used as values for properties are
+marked with <literal>enum</literal> for enumeration.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>Properties</term>
+<listitem>
+<simpara>Values of non-terminals, e.g., other rules, can be assigned to
+properties. The property name and the assignment are not part of the
+original syntax and only used for the meta description. E.g., <literal><emphasis>name=</emphasis>Identifier</literal>.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>Collection Properties</term>
+<listitem>
+<simpara>If a property is a collection, values are added to that list via <literal>+=</literal>.
+E.g.,<literal><emphasis>property+=</emphasis>Value</literal> .</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>Boolean Properties</term>
+<listitem>
+<simpara>Boolean properties are set to false by default, if the value (usually
+a terminal) is found, the boolean value is set to true. Often, the
+name of the property is similar to the terminal. E.g., <literal><emphasis>final?</emphasis>='final'?</literal>.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+<simpara>Properties of a non-terminal are sometimes listed again below the
+grammar. In that case, often pseudo properties are introduced which are
+derived from other properties and which are only used for
+simplification.</simpara>
+</section>
+<section xml:id="_type-judgments-and-rules-and-constraints-notation">
+<title>Type Judgments and Rules and Constraints Notation</title>
+<section xml:id="_typing-rules-and-judgments">
+<title>Typing Rules and Judgments</title>
+<definition>
+<title>Rule</title>
+<simpara>
+<anchor xml:id="rule" xreflabel="[rule]"/>
+<emphasis role="strong">Definition:</emphasis>
+<link linkend="rule">Rule</link></simpara>
+<simpara>
+
+We use the common notation for rules such as type inference rules <footnote><simpara>A brief introduction can be found at <link xl:href="http://www.cs.cornell.edu/~ross/publications/mixedsite/tutorial.html">http://www.cs.cornell.edu/~ross/publications/mixedsite/tutorial.html</link>. In general, we refer the reader to [<link linkend="Pierce02a">Pierce02a</link>]</simpara></footnote>, that is</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><mi>p</mi><mi>r</mi><mi>e</mi><mi>m</mi><mi>i</mi><mi>s</mi><mi>e</mi><mi>s</mi></mrow><mrow><mi>c</mi><mi>o</mi><mi>n</mi><mi>c</mi><mi>l</mi><mi>u</mi><mi>s</mi><mi>i</mi><mi>o</mi><mi>n</mi></mrow></mfrac><mspace width="5.0mm"/><mstyle mathvariant="normal"><mtext>rule name</mtext></mstyle></math>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>p</mi><mi>r</mi><mi>e</mi><mi>m</mi><mi>i</mi><mi>s</mi><mi>e</mi><mi>s</mi></math> is the rule’s premises (e.g., the expression to be inferred), <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>c</mi><mi>o</mi><mi>n</mi><mi>c</mi><mi>l</mi><mi>u</mi><mi>s</mi><mi>i</mi><mi>o</mi><mi>n</mi></math> the result of the rule.
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>r</mi><mi>u</mi><mi>l</mi><mi>e</mi><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi></math> is an optional condition which may be omitted.</simpara>
+<simpara>Both parts of the rule may contain multiple expressions, which are concatenated via 'and'.</simpara>
+<simpara>For example, the following</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><msub><mi>P</mi><mn>1</mn></msub><mspace width="5.0mm"/><msub><mi>P</mi><mn>2</mn></msub><mspace width="5.0mm"/><msub><mi>P</mi><mn>3</mn></msub></mrow><mi>C</mi></mfrac></math>
+<simpara>can be read as</simpara>
+<blockquote>
+<simpara>if <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>P</mi><mn>1</mn></msub></math>, <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>P</mi><mn>2</mn></msub></math>, <emphasis>and</emphasis> <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>P</mi><mn>3</mn></msub></math> are all true, then <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>C</mi></math> is true as well.</simpara>
+</blockquote>
+</definition>
+<simpara>The following judgments (with relation symbols) are used:</simpara>
+<variablelist>
+<varlistentry>
+<term>subtype <math xmlns="http://www.w3.org/1998/Math/MathML"><mo>&lt;</mo></math> </term>
+<listitem>
+<simpara>-</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>type <math xmlns="http://www.w3.org/1998/Math/MathML"><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle></math> </term>
+<listitem>
+<simpara>in which the left hand side is a declaration or expression, and the right hand side a type.
+We also use <math xmlns="http://www.w3.org/1998/Math/MathML"><mrow><mo>[</mo><mspace width="-0.167em"/><mrow><mo>[</mo></mrow></mrow><mrow><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/></mrow><mrow><mrow><mo>]</mo></mrow><mspace width="-0.167em"/><mo>]</mo></mrow></math> as a function returning the (inferred) type of an expression.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>expectedTypeIn <math xmlns="http://www.w3.org/1998/Math/MathML"><mo>⊲</mo><mi>:</mi></math> </term>
+<listitem>
+<simpara>a relation with three arguments:
+  <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>c</mi><mi>o</mi><mi>n</mi><mi>t</mi><mi>a</mi><mi>i</mi><mi>n</mi><mi>e</mi><mi>r</mi><mo>⊲</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>e</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>o</mi><mi>n</mi><mi>:</mi><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi></math> means, that
+  <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>e</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>o</mi><mi>n</mi></math> is expected to be a subtype of
+  <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi></math> inside <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>c</mi><mi>o</mi><mi>n</mi><mi>t</mi><mi>a</mi><mi>i</mi><mi>n</mi><mi>e</mi><mi>r</mi></math></simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+<simpara>The following statement, for example, defines transitivity of subtypes
+(in a simplified manner):</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><mi>Γ</mi><mo>⊢</mo><mi>B</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>A</mi><mspace width="5.0mm"/><mi>Γ</mi><mo>⊢</mo><mi>C</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>B</mi></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mi>C</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>A</mi></mrow></mfrac></math>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mo>⊢</mo></math> is the context containing (bound) type variables etc., <math xmlns="http://www.w3.org/1998/Math/MathML"><mo>⊢</mo></math> can be read as <literal>entails</literal>.
+Thus, the rule can be read as follows:</simpara>
+<blockquote>
+<simpara>if the type B is a subtype of type A in context <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>Γ</mi></math> (i.e. with constraints on type variables specified in <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>Γ</mi></math>), and if type C is a subtype of B, then C is also a subtype of A in context <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>Γ</mi></math>.</simpara>
+</blockquote>
+<simpara>In rules, we sometimes omit the environment if it is not needed.
+New information is sometimes added to the environment, in particular, substitutions (that is binding type variables to a type).
+The set of substitutions is written with <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>θ</mi></math> (theta).
+If new substitutions are explicitly added to that set, we write <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>θ</mi><mfenced close=")" open="("><mrow><mi>V</mi><mo>←</mo><mi>T</mi></mrow></mfenced></math> (<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>V</mi></math> is substituted with type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi></math>).
+Often, these bindings are computed from a parameterized type reference which declares type arguments which are bound to the type variables of the generic declaration.
+In this case we simply write <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>θ</mi><mfenced close=")" open="("><mi>p</mi></mfenced></math>, in which <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>p</mi></math> is the parameterized type declaration.
+As these new substitutions must become part of a (newly) created environment, we then usually write <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>Γ</mi><mo>←</mo><mi>θ</mi><mfenced close=")" open="("><mi>p</mi></mfenced></math>.
+These substitutions are usually omitted.</simpara>
+</section>
+<section xml:id="_types-of-an-element">
+<title>Types of an Element</title>
+<simpara>A variable or other typed element may be associated with three types:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>Declared type: the type explicitly specified in the code, e.g., <literal>var s: string</literal>.</simpara>
+</listitem>
+<listitem>
+<simpara>Inferred type: the type inferred by the type inferencer, e.g., <literal>var s = "Hello"</literal> infers the type of s to <literal>string</literal>. I.e.
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>Γ</mi><mo>⊢</mo><mi>s</mi><mi>:</mi><mrow><mi>s</mi><mi>t</mi><mi>r</mi><mi>i</mi><mi>n</mi><mi>g</mi></mrow></math> will be true, or <math xmlns="http://www.w3.org/1998/Math/MathML"><mrow><mo>[</mo><mspace width="-0.167em"/><mrow><mo>[</mo></mrow></mrow><mi>s</mi><mrow><mrow><mo>]</mo></mrow><mspace width="-0.167em"/><mo>]</mo></mrow><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>s</mi><mi>t</mi><mi>r</mi><mi>i</mi><mi>n</mi><mi>g</mi></math>.
+If an element is annotated with a type ,i.e. it has a declared type, the inferred type will always be the declared type.</simpara>
+</listitem>
+<listitem>
+<simpara>Actual type: the actual type of a variable during runtime.
+This type information is not available at compile time and ignored in this specification.</simpara>
+</listitem>
+</orderedlist>
+<simpara>These types are not type declarations but type references, in fact, as they may be parameterized.
+For the sake of simplicity, we often omit the <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>R</mi><mi>e</mi><mi>f</mi></math> suffix to shorten formulas.
+Consequently, we define the following properties and pseudo properties for typed elements such as variables:</simpara>
+<variablelist>
+<varlistentry>
+<term>declaredType<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>R</mi><mi>e</mi><mi>f</mi></math> </term>
+<listitem>
+<simpara>The explicitly declared type, this is usually a real property of the construct.
+Not all elements allow the specification of a declared type, such as expressions.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>inferredType<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>R</mi><mi>e</mi><mi>f</mi></math> or <math xmlns="http://www.w3.org/1998/Math/MathML"><mrow><mo>[</mo><mspace width="-0.167em"/><mrow><mo>[</mo></mrow></mrow><mrow><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/></mrow><mrow><mrow><mo>]</mo></mrow><mspace width="-0.167em"/><mo>]</mo></mrow></math></term>
+<listitem>
+<simpara>This pseudo property is the inferred type computed by the type inferencer.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>type<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>R</mi><mi>e</mi><mi>f</mi></math> </term>
+<listitem>
+<simpara>A pseudo property for elements with a <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>d</mi><mi>e</mi><mi>c</mi><mi>l</mi><mi>a</mi><mi>r</mi><mi>e</mi><mi>d</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi></math> property.
+It is similar to the inferred type, i.e. <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>e</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mo>=</mo><mrow><mo>[</mo><mspace width="-0.167em"/><mrow><mo>[</mo></mrow></mrow><mi>e</mi><mrow><mrow><mo>]</mo></mrow><mspace width="-0.167em"/><mo>]</mo></mrow></math></simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+</section>
+</section>
+</section>
+<section xml:id="_auxiliary-functions" role="language-n4js">
+<title>Auxiliary Functions</title>
+<simpara>This section describes some auxiliary functions required for definition of type inference rules later on.</simpara>
+<section xml:id="_binding">
+<title>Binding</title>
+<simpara>Binding an identifier (variable reference) to a variable declaration (or
+variable definition) is not part of this specification as this is
+standard ECMAScript functionality. However, some valid ECMAScript
+bindings are permitted due to visibility constraints.</simpara>
+<definition>
+<title>Binding Relation</title>
+<simpara>
+<anchor xml:id="binding_relation" xreflabel="[binding_relation]"/>
+<emphasis role="strong">Definition:</emphasis>
+<link linkend="binding_relation">Binding Relation</link></simpara>
+<simpara>
+
+We define a pseudo relation</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mi>b</mi><mi>i</mi><mi>n</mi><mi>d</mi><mi>:</mi><mi>V</mi><mi>a</mi><mi>r</mi><mi>i</mi><mi>a</mi><mi>b</mi><mi>l</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mi>e</mi><mi>r</mi><mi>e</mi><mi>n</mi><mi>c</mi><mi>e</mi><mo>×</mo><mi>V</mi><mi>a</mi><mi>r</mi><mi>i</mi><mi>a</mi><mi>b</mi><mi>l</mi><mi>e</mi><mi>D</mi><mi>e</mi><mi>c</mi><mi>l</mi><mi>a</mi><mi>r</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>o</mi><mi>n</mi></math>
+<simpara>which binds a reference, i.e. an identifier, to a declaration (e.g.,variable declaration).</simpara>
+<simpara>Binding of variable references to declaration is defined by ECMAScript already.
+Type references only occur in type expressions, how these are handled is explained in <xref linkend="_type-expressions"/>.</simpara>
+<simpara>We usually omit this binding mechanism in most rules and use the reference similarly to the declaration or definition it is bound to.
+If a variable reference <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>r</mi></math>, for example, is bound to a variable declaration <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>D</mi></math>, i.e. <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>b</mi><mi>i</mi><mi>n</mi><mi>d</mi><mfenced close=")" open="("><mi>r</mi><mi>D</mi></mfenced></math>, we simply write <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>r</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi></math> instead of <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>b</mi><mi>i</mi><mi>n</mi><mi>d</mi><mfenced close=")" open="("><mi>r</mi><mi>D</mi></mfenced><mo>,</mo><mi>D</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi></math> to refer to the type expression
+(of the variable).<footnote><simpara>One can interpret this similar to delegate methods, that is, instead of writing <literal role="language-n4js">r.binding().getType()</literal>, a method <literal role="language-n4js">r.getType()\{return binding().getType();</literal> is defined.</simpara></footnote></simpara>
+</definition>
+<simpara>A <literal>DeclaredType</literal> references the type declaration by its simple name that has been imported from a module specifier.
+We define the method <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>b</mi><mi>i</mi><mi>n</mi><mi>d</mi></math> for declared types as well:</simpara>
+<definition>
+<title>Binding Relation of Types</title>
+<simpara>
+<anchor xml:id="binding_relation_of_types" xreflabel="[binding_relation_of_types]"/>
+<emphasis role="strong">Definition:</emphasis>
+<link linkend="binding_relation_of_types">Binding Relation of Types</link></simpara>
+<simpara>
+
+We define a pseudo relation</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mi>b</mi><mi>i</mi><mi>n</mi><mi>d</mi><mi>:</mi><mi>D</mi><mi>e</mi><mi>c</mi><mi>l</mi><mi>a</mi><mi>r</mi><mi>e</mi><mi>d</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi><mo>×</mo><mi>C</mi><mi>l</mi><mi>a</mi><mi>s</mi><mi>s</mi><mo>|</mo><mi>I</mi><mi>n</mi><mi>t</mi><mi>e</mi><mi>r</mi><mi>f</mi><mi>a</mi><mi>c</mi><mi>e</mi><mo>|</mo><mi>E</mi><mi>n</mi><mi>u</mi><mi>m</mi></math>
+<simpara>which binds a type reference, i.e. a simple name, to the type declaration.</simpara>
+</definition>
+</section>
+<section xml:id="_merging-types">
+<title>Merging Types</title>
+<simpara>In some cases we have to merge types, e.g., types of a union type or item types of an array.
+For that purpose, we define a method <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>m</mi><mi>e</mi><mi>r</mi><mi>g</mi><mi>e</mi></math> as follows.</simpara>
+<definition>
+<title>Merge Function</title>
+<simpara>
+<anchor xml:id="merge_function" xreflabel="[merge_function]"/>
+<emphasis role="strong">Definition:</emphasis>
+<link linkend="merge_function">Merge Function</link></simpara>
+<simpara>
+
+We define a pseudo function</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mi>m</mi><mi>e</mi><mi>r</mi><mi>g</mi><mi>e</mi><mi>:</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi><mo>×</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>×</mo><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi><mo>⇒</mo><mi mathvariant="script">P</mi><mfenced close=")" open="("><mrow><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi></mrow></mfenced></math>
+<simpara>The idea of this function is to remove duplicates.
+For example; if a union type contains two type expressions <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>t</mi><msub><mi>e</mi><mn>1</mn></msub></math> and <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>t</mi><msub><mi>e</mi><mi>k</mi></msub></math>, and if <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>τ</mi><mfenced close=")" open="("><mrow><mi>t</mi><msub><mi>e</mi><mn>1</mn></msub></mrow></mfenced><mo>=</mo><mi>τ</mi><mfenced close=")" open="("><mrow><mi>t</mi><msub><mi>e</mi><mn>2</mn></msub></mrow></mfenced></math>, then <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>m</mi><mi>e</mi><mi>r</mi><mi>g</mi><mi>e</mi><mfenced close=")" open="("><mrow><mi>τ</mi><mfenced close=")" open="("><mrow><mi>t</mi><msub><mi>e</mi><mn>1</mn></msub></mrow></mfenced></mrow><mrow><mi>τ</mi><mfenced close=")" open="("><mrow><mi>t</mi><msub><mi>e</mi><mn>2</mn></msub></mrow></mfenced></mrow></mfenced></math> contains only one element.
+The order of the elements is lost, however.</simpara>
+</definition>
+<section xml:id="_logic-formulas">
+<title>Logic Formulas</title>
+<simpara>In general, we use a pragmatic mixture of pseudo code, predicate logic, and OCL.
+Within constraints (also within the inference rules), the properties defined in the grammar are used.</simpara>
+<simpara>In some rules, it is necessary to type the rule variables.
+Instead of explicitly checking the metatype (via <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>μ</mi><mfenced close=")" open="("><mi>X</mi></mfenced><mo>=</mo><mi>:</mi><mrow><mi>M</mi><mi>e</mi><mi>t</mi><mi>a</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi></mrow></math>), we precede the variable with the type, that is: <math xmlns="http://www.w3.org/1998/Math/MathML"><mrow><mi>M</mi><mi>e</mi><mi>t</mi><mi>a</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi></mrow><mi>X</mi></math>.</simpara>
+<simpara>Instead of "type casting" elements, often properties are simply accessed.
+If an element does not define that element, it is either assumed to be false or null by default.</simpara>
+<simpara>If a property <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>p</mi></math> is optional and not set, we write <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>p</mi><mo>=</mo><mi>n</mi><mi>u</mi><mi>l</mi><mi>l</mi></math> to test its absence.
+Note that <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>p</mi><mo>=</mo><mi>n</mi><mi>u</mi><mi>l</mi><mi>l</mi></math> is different from <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>p</mi><mo>=</mo><mi>N</mi><mi>u</mi><mi>l</mi><mi>l</mi></math>, as the latter refers to the null type.
+Non-terminals may implicitly be subclasses.
+In that case, the concrete non-terminal, or type, of a property may be subject for a test in a constraint.</simpara>
+</section>
+</section>
+<section xml:id="_symbols-and-font-convention">
+<title>Symbols and Font Convention</title>
+<simpara>Variables and their properties are printed in italic when used in formulas (such as rules).
+A dot-notation is used for member access, e.g. <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>v</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi></math>.
+Also defined functions are printed in italic, e.g., <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>a</mi><mi>c</mi><mi>c</mi><mfenced close=")" open="("><mi>r</mi><mi>D</mi></mfenced></math>.
+Properties which define sets are usually ordered and we assume 0-indexed access to elements, the index subscripted, e.g., <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>v</mi><mo>.</mo><mi>m</mi><mi>e</mi><mi>t</mi><mi>h</mi><mi>o</mi><mi>d</mi><msub><mi>s</mi><mi>i</mi></msub></math>.</simpara>
+<simpara>We use the following symbols and font conventions:</simpara>
+<variablelist>
+<varlistentry>
+<term><math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∧</mo></math>, <math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∨</mo></math>, <math xmlns="http://www.w3.org/1998/Math/MathML"><mo>⊕</mo></math>, <math xmlns="http://www.w3.org/1998/Math/MathML"><mo>¬</mo></math></term>
+<listitem>
+<simpara>Logical and, or, exclusive or (xor), and not.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><math xmlns="http://www.w3.org/1998/Math/MathML"><mo>⇒</mo></math>, <math xmlns="http://www.w3.org/1998/Math/MathML"><mo>⇔</mo></math>, <math xmlns="http://www.w3.org/1998/Math/MathML"><mstyle mathvariant="bold"><mtext>if</mtext></mstyle><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/></math>, <math xmlns="http://www.w3.org/1998/Math/MathML"><mstyle mathvariant="bold"><mtext>then</mtext></mstyle><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/></math>, <math xmlns="http://www.w3.org/1998/Math/MathML"><mstyle mathvariant="bold"><mtext>else</mtext></mstyle><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/></math> </term>
+<listitem>
+<simpara>Logical implication, if and only if, and if-then-else.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><math xmlns="http://www.w3.org/1998/Math/MathML"><mstyle mathvariant="monospace"><mtext>true</mtext></mstyle></math>, <math xmlns="http://www.w3.org/1998/Math/MathML"><mstyle mathvariant="monospace"><mtext>false</mtext></mstyle></math>, <math xmlns="http://www.w3.org/1998/Math/MathML"><mstyle mathvariant="monospace"><mtext>null</mtext></mstyle></math>, <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>∅</mi></math></term>
+<listitem>
+<simpara>Boolean true, boolean false, null (i.e., not specified, e.g.,
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>v</mi><mo>.</mo><mi>s</mi><mi>u</mi><mi>p</mi><mo>=</mo></math> means that there are is no <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>s</mi><mi>u</mi><mi>p</mi></math>
+(super class) specified), empty set.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∈</mo></math>, <math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∉</mo></math>, <math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∪</mo></math>, <math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∩</mo></math>, <math xmlns="http://www.w3.org/1998/Math/MathML"><mo>|</mo><mi>x</mi><mo>|</mo></math></term>
+<listitem>
+<simpara>Element of, not an element of, union set, intersection set,
+cardinality of set x.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><math xmlns="http://www.w3.org/1998/Math/MathML"><mi mathvariant="script">P</mi><mfenced close=")" open="("><mi>X</mi></mfenced></math></term>
+<listitem>
+<simpara>Power set of <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>X</mi></math>, i.e.
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi mathvariant="script">P</mi><mfenced close=")" open="("><mi>X</mi></mfenced><mo>=</mo><mfenced close="}" open="{"><mrow><mi>U</mi><mi>:</mi><mi>U</mi><mo>⊆</mo><mi>X</mi></mrow></mfenced></math>.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∃</mo></math>, <math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∄</mo></math>, <math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∀</mo></math></term>
+<listitem>
+<simpara>Exists, not exists, for all; we write <math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∃</mo><mi>x</mi><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><mi>z</mi><mi>:</mi><mi>P</mi><mfenced close=")" open="("><mi>x</mi><mrow><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/></mrow><mi>z</mi></mfenced></math> and say</simpara>
+<blockquote>
+<simpara>"there exists <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>x</mi><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><mi>z</mi></math> such that predicate <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>P</mi></math> is true".</simpara>
+</blockquote>
+<simpara>Note that <math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∄</mo><mi>x</mi><mi>:</mi><mi>P</mi><mfenced close=")" open="("><mi>x</mi></mfenced><mo>⇔</mo><mo>∀</mo><mi>x</mi><mi>:</mi><mo>¬</mo><mi>P</mi><mfenced close=")" open="("><mi>x</mi></mfenced></math>.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>μ</mi><mfenced close=")" open="("><mrow><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/></mrow></mfenced></math></term>
+<listitem>
+<simpara>(mu) read "<emphasis role="strong">metatype of</emphasis>"; metatype of a variable or property, e.g.,</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mstyle mathvariant="bold"><mtext>if</mtext></mstyle><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mi>μ</mi><mfenced close=")" open="("><mi>x</mi></mfenced><mo>=</mo><mi>:</mi><mrow><mi>C</mi><mi>l</mi><mi>a</mi><mi>s</mi><mi>s</mi></mrow><mstyle mathvariant="bold"><mtext>then</mtext></mstyle><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mstyle mathvariant="bold"><mtext>else</mtext></mstyle><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/></math>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><math xmlns="http://www.w3.org/1998/Math/MathML"><mover accent="true"><mi>x</mi><mo>¯</mo></mover></math></term>
+<listitem>
+<simpara>Sequence of elements <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>x</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>x</mi><mi>n</mi></msub></math>. E.g., if we want to
+define a constraint that the owner of a members of a class
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>C</mi></math> is the class, we simply write</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mi>C</mi><mo>.</mo><mover accent="true"><mrow><mi>m</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi><mi>s</mi></mrow><mo>¯</mo></mover><mo>.</mo><mi>o</mi><mi>w</mi><mi>n</mi><mi>e</mi><mi>r</mi><mo>=</mo><mi>C</mi></math>
+<simpara>instead of</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mo>∀</mo><mi>m</mi><mo>∈</mo><mi>C</mi><mo>.</mo><mi>m</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi><mi>s</mi><mi>:</mi><mi>m</mi><mo>.</mo><mi>o</mi><mi>w</mi><mi>n</mi><mi>e</mi><mi>r</mi><mo>=</mo><mi>C</mi></math>
+<simpara>or even more complicated with index variables.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+<simpara>Sequences are 1-based, e.g., a sequence <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>s</mi></math> with length <math xmlns="http://www.w3.org/1998/Math/MathML"><mo>|</mo><mi>s</mi><mo>|</mo><mo>=</mo><mi>n</mi></math>, has elements <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>s</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>s</mi><mi>n</mi></msub></math>.</simpara>
+</section>
+</section>
+</chapter>
+<chapter xml:id="_grammar">
+<title>Grammar</title>
+<section xml:id="_lexical-conventions" role="language-n4js">
+<title>Lexical Conventions</title>
+<simpara>As a super language on top of ECMAScript, the same lexical conventions are supported as described in [<link linkend="ECMA11a">ECMA11a(p.S7)</link>] within strict mode.
+Some further constraints are defined, however, restricting certain constructs. These constraints are described in the following.</simpara>
+<section xml:id="_identifier-names-and-identifiers">
+<title>Identifier Names and Identifiers</title>
+<simpara>Cf. [<link linkend="ECMA11a">ECMA11a(p.S7.6)</link>], [<link linkend="ECMA11a">ECMA11a(p.S11.1.2, p.p.63)</link>] and [<link linkend="ECMA11a">ECMA11a(p.S01.2, p.p.51ff)</link>].</simpara>
+<simpara>As a reminder, identifiers are defined as follows in the ECMAScript specification:</simpara>
+<programlisting language="xtext" linenumbering="unnumbered">IdentifierName: IdentifierStart* IdentifierPart;
+IdentifierStart : UnicodeLetter | '_';
+                \ UnicodeEscapeSequence</programlisting>
+<simpara>N4JS supports a limited form of computed-names for member declarations:</simpara>
+<programlisting language="xtext" linenumbering="unnumbered">N4JSPropertyComputedName:
+    '[' (SymbolLiteralComputedName | StringLiteralComputedName) ']'
+;
+
+SymbolLiteralComputedName: N4JSIdentifier '.' N4JSIdentifier ;
+
+StringLiteralComputedName: STRING ;</programlisting>
+<simpara>As can be seen, a computed-name must be either</simpara>
+<itemizedlist>
+<listitem>
+<simpara>a symbol reference, e.g., <literal>Symbol.iterator</literal></simpara>
+</listitem>
+<listitem>
+<simpara>a string literal, i.e., a compile time known constant.
+This notation is useful when interoperating with libraries that define members whose names contain special characters (e.g., a field name starting with commercial-at)</simpara>
+</listitem>
+</itemizedlist>
+<simpara>In N4JS, identifiers are further constrained in order to avoid ambiguities and to make code more readable.
+Some of these constraints will lead to errors, others only to warnings.
+They do not apply for identifiers declared in definitions file (n4jsd) in order to enable declaration of external entities.</simpara>
+<requirement xml:id="IDE-1">
+<title>N4JS Identifier Restrictions</title>
+<simpara>
+<anchor xml:id="Req-IDE-1" xreflabel="[Req-IDE-1]"/>
+<emphasis role="strong">Requirement: IDE-1:</emphasis>
+<link linkend="Req-IDE-1">N4JS Identifier Restrictions</link> (ver. 1)</simpara>
+    <simpara>
+
+. If the following constraints do not hold, errors are created.
+..  Leading <literal>$</literal> (dollar sign) character is prohibited for any variable name such as fields, variables, types functions and methods.
+..  Leading <literal>_</literal> (underscore) character is not allowed for identifying any functions or methods.</simpara>
+</requirement>
+<requirement xml:id="IDE-2">
+<title>N4JS identifier recommendations</title>
+<simpara>
+<anchor xml:id="Req-IDE-2" xreflabel="[Req-IDE-2]"/>
+<emphasis role="strong">Requirement: IDE-2:</emphasis>
+<link linkend="Req-IDE-2">N4JS identifier recommendations</link> (ver. 1)</simpara>
+    <simpara>
+
+. If the following constraints do not hold, warnings are created.
+. Variable names should, in general, be constructed form the 26 ASCII upper and lower case alphabetic letters (a..z, A..Z), from the 10 decimal digits (0..9) and from the <literal>_</literal> (underscore).
+Although the usage of the international characters are allowed (according to the ECMAScript specification)
+it is discouraged because these characters may not be read or understood well in every circumstance <footnote><simpara><link xl:href="http://javascript.crockford.com/code.html">http://javascript.crockford.com/code.html</link></simpara></footnote>.</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>Type (and Type Variable) Identifiers</simpara>
+<programlisting language="xtext" linenumbering="unnumbered">TypeIdentifier: [_A-Z][_a-zA-Z0-9]*
+TypeVariableIdentifier: [_A-Z][_a-zA-Z0-9]*</programlisting>
+</listitem>
+<listitem>
+<simpara>Package Identifiers</simpara>
+<programlisting language="xtext" linenumbering="unnumbered">PackageIdentifier: [_a-z][._a-zA-Z0-9]*; // i.e. the folder names, must not end with .</programlisting>
+</listitem>
+<listitem>
+<simpara>Member Identifiers and Enum Literals</simpara>
+<programlisting language="xtext" linenumbering="unnumbered">InstanceFieldIdentifier: [_a-z][_a-zA-Z0-9]*
+StaticFieldIdentifier: [_A-Z][_A-Z0-9]*([_A-Z0-9]+)*
+EnumLiteral: [_A-Z][_A-Z0-9]*([_A-Z0-9]+)*</programlisting>
+</listitem>
+<listitem>
+<simpara>Variable and Parameter Names</simpara>
+<programlisting language="xtext" linenumbering="unnumbered">VariableIdentifier: [_a-zA-Z0-9]*
+􏰀ParameterIdentifier: [_a-z][_a-zA-Z0-9]*</programlisting>
+</listitem>
+<listitem>
+<simpara>Methods</simpara>
+<programlisting language="xtext" linenumbering="unnumbered">MethodIdentifier: [_a-z][_a-zA-Z0-9]*;</programlisting>
+</listitem>
+<listitem>
+<simpara>Annotations</simpara>
+<programlisting language="xtext" linenumbering="unnumbered">AnnotationIdentifier: [_A-Z][_a-zA-Z0-9]*</programlisting>
+</listitem>
+</orderedlist>
+<simpara>The following rules describe how fully qualified names of elements are created.
+Note that these fully qualified names cannot be used in N4JS directly.
+Though they may be shown in error messages etc. to identify elements.</simpara>
+<programlisting language="xtext" linenumbering="unnumbered">TypeIdentifier:         [A-Z][a-zA-Z0-9]*;
+PackageIdentifier:      [a-z][a-zA-Z0-9]*;
+FQNType:                (PackageIdentifier '.')+ TypeIdentifier;</programlisting>
+</requirement>
+</section>
+<section xml:id="_this-keyword">
+<title>This Keyword</title>
+<simpara>Cf. [<link linkend="ECMA11a">ECMA11a(p.S11.1.1, p.p.63)</link>]</simpara>
+</section>
+<section xml:id="_regular-expression-literals">
+<title>Regular Expression Literals</title>
+<simpara>Cf. [<link linkend="ECMA11a">ECMA11a(p.S7.8.5)</link>]</simpara>
+</section>
+<section xml:id="_automatic-semicolon-insertion">
+<title>Automatic Semicolon Insertion</title>
+<simpara>Cf. [<link linkend="ECMA11a">ECMA11a(p.S7.9)</link>]</simpara>
+<simpara><link linkend="_acronyms">ASI</link> is supported by the parser, however warnings are issued.</simpara>
+</section>
+<section xml:id="_jsdoc">
+<title>JSDoc</title>
+<simpara>JSDoc are comments similar to JavaDoc in Java for documenting types, functions and members.
+There is no semantic information expressed in JSDoc, that is, the behavior of a program must not change if all the JSDoc is removed.
+The JSDoc tags and overall syntax is a mixture of tags defined by the <link xl:href="https://developers.google.com/closure/compiler/docs/js-for-compiler">Google Closure Compiler</link>, Java&#8217;s <link xl:href="http://www.oracle.com/technetwork/java/javase/documentation/index-jsp-135444.html">JavaDoc</link> tool and N4-specific tags.</simpara>
+<simpara>JSDoc comments are multiline comments, starting with <literal>/**</literal> (instead of simple multiline comments, starting with <literal>/*</literal>).</simpara>
+<programlisting language="xtext" linenumbering="unnumbered">MultiLineComment: '/*' MultiLineCommentChars? '*/'  // from ECMAScript specification
+JSDoc:            '/**' MultiLineCommentChars? '*/'</programlisting>
+<simpara>In general, JSDoc comments are placed directly before the annotated language element.
+In some cases, this is slightly different, such as for method parameters, for example, where it is then explicitly specified.</simpara>
+<simpara>The content of JSDoc comments will be covered in more detail in upcoming chapters.
+For documentation purposes, multi- and single-line descriptions are used in several constructs.</simpara>
+<programlisting language="xtext" linenumbering="unnumbered">MLVALUE:         ([^@]+[^\n]+)+;
+SLVALUE:         ([^\n]+);</programlisting>
+<variablelist>
+<varlistentry>
+<term><literal>MLVALUE</literal> </term>
+<listitem>
+<simpara>short for <literal>multi-line value</literal>. This is usually only used for the general description of types or members.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>SLVALUE</literal> </term>
+<listitem>
+<simpara>short for <literal>single-line value</literal>. This is a description which ends at the end of a line.
+It is usually used in combination with other tags, e.g., to further describe a parameter of a method.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+</section>
+</section>
+</chapter>
+<chapter xml:id="_names">
+<title>Names</title>
+<simpara><emphasis>Visibility</emphasis> defines the scope in which a declaration is visible, that is in which context references can be bound to the declaration.
+<emphasis>Access control</emphasis> defines the extent to which types and members are accessible beyond their immediate context.
+Access control may, therefore, restrict the visibility of a declaration by limiting its scope.</simpara>
+<simpara><emphasis>Extensibility</emphasis> refers to whether a given type can be subtyped, or in the case of members, whether they can be overridden.
+Access control is a prerequisite for extensibility which is further explained in <xref linkend="_n4js-specific-classifiers"/></simpara>
+<section xml:id="_access-control" role="language-n4js">
+<title>Access Control</title>
+<simpara>Types from one project may or may not be made accessible to another project.
+Likewise, members from a given type may or may not be made accessible to members existing outside that type.
+For example, if a developer writes an application which uses a library, which types within that library can the application see?
+Given a type that is set as visible, which members of that type can the application see?</simpara>
+<simpara>Accessing a type or member actually means that a reference is bound to a
+declaration with the same identifier.</simpara>
+<simpara>We distinguish the following contexts from which an element is accessed
+as follows:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara><emphasis role="strong">Module or type</emphasis>: access from elements in the same module or type.</simpara>
+</listitem>
+<listitem>
+<simpara><emphasis role="strong">Subtype</emphasis>: access from a subtype.</simpara>
+</listitem>
+<listitem>
+<simpara><emphasis role="strong">Project</emphasis>: access from the same project.</simpara>
+</listitem>
+<listitem>
+<simpara><emphasis role="strong">Vendor</emphasis>: access from different project of the same vendor.</simpara>
+</listitem>
+<listitem>
+<simpara><emphasis role="strong">World</emphasis>: access from anything else.</simpara>
+</listitem>
+</orderedlist>
+<simpara>Accessibility is defined by modifiers on types and members, e.g <literal>public</literal>, <literal>protected</literal>, <literal>project</literal>, <literal>private</literal>, via the <literal>export</literal> statement, and by the <literal>@Internal</literal> annotation.
+Extensibility is defined by the <literal>@Final</literal> annotation respectively.</simpara>
+</section>
+<section xml:id="_accessibility-of-types-top-level-variables-and-function-declarations" role="language-n4js">
+<title>Accessibility of Types, Top-Level Variables and Function Declarations</title>
+<simpara>We define types (classes, interfaces, enums) whereby each type has members (fields and methods, depending on the kind of type).
+When we define a type, we need to define whether it is visible only for the specifying module, project or whether that type should be accessible from outside of that project.</simpara>
+<simpara>The same is true for variable declarations and function declarations defined as top-level elements of a module.</simpara>
+<simpara>The following type access modifiers are supported by N4JS:</simpara>
+<programlisting language="xtext" linenumbering="unnumbered">enum TypeAccessModifier:      project
+                            | public;</programlisting>
+<simpara>If a type is not exported, its visibility is private.
+If a type has declared visibility <literal>public</literal>, it may additionally be marked as internal via the annotation <literal>@Internal</literal>.
+Thus, we have the following set of type access modifiers:</simpara>
+<simpara>TAM = <literal>private</literal> <literal>project</literal> <literal>public@Internal</literal> <literal>public</literal></simpara>
+<simpara>That is, in N4JS, only the type access modifiers and are available.
+The redundant <literal>project</literal> modifier serves only documentation purpose and can be synthesized if the <literal>export</literal> modifier is preset.</simpara>
+<simpara>All other modifiers used here are synthesized as shown in the next example:</simpara>
+<formalpara>
+<title>Synthesized Type Access Modifiers in N4JS</title>
+<para>
+<programlisting language="n4js" linenumbering="unnumbered">class C0 {}                         // private
+export class C1 {}                  // project
+export project class C1 {}          // project
+export @Internal public class C1 {} // public@Internal
+export public class C2 {}           // public
+
+var v0;                             // private
+export var v1;                      // project
+export project var v1;              // project
+export @Internal public var v3;     // public@Internal
+export public var v2;               // public
+
+
+function f0() {}                    // private
+export function f1() {}             // project
+export project function f1() {}     // project
+export @Internal public function f3() {} // public@Internal
+export public function f2() {}      // public</programlisting>
+</para>
+</formalpara>
+<simpara>The access control levels are defined as listed in <xref linkend="tab:type-access-control"/>.</simpara>
+<table xml:id="tab:type-access-control" frame="all" rowsep="1" colsep="1">
+<title>Type Access Control</title>
+<tgroup cols="5">
+<colspec colname="col_1" colwidth="20*"/>
+<colspec colname="col_2" colwidth="20*"/>
+<colspec colname="col_3" colwidth="20*"/>
+<colspec colname="col_4" colwidth="20*"/>
+<colspec colname="col_5" colwidth="20*"/>
+<thead>
+<row>
+<entry align="center" valign="top" namest="col_1" nameend="col_5"><emphasis role="strong">Type Access</emphasis></entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry align="center" valign="top"><simpara><emphasis role="strong">Modifier</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><emphasis role="strong">Module</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><emphasis role="strong">Project</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><emphasis role="strong">Vendor</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><emphasis role="strong">World</emphasis></simpara></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><literal>private</literal></simpara></entry>
+<entry align="center" valign="top"><simpara>yes</simpara></entry>
+<entry align="center" valign="top"><simpara>no</simpara></entry>
+<entry align="center" valign="top"><simpara>no</simpara></entry>
+<entry align="center" valign="top"><simpara>no</simpara></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><literal>project</literal></simpara></entry>
+<entry align="center" valign="top"><simpara>yes</simpara></entry>
+<entry align="center" valign="top"><simpara>yes</simpara></entry>
+<entry align="center" valign="top"><simpara>no</simpara></entry>
+<entry align="center" valign="top"><simpara>no</simpara></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><literal>public@Internal</literal></simpara></entry>
+<entry align="center" valign="top"><simpara>yes</simpara></entry>
+<entry align="center" valign="top"><simpara>yes</simpara></entry>
+<entry align="center" valign="top"><simpara>yes</simpara></entry>
+<entry align="center" valign="top"><simpara>no</simpara></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><literal>public</literal></simpara></entry>
+<entry align="center" valign="top"><simpara>yes</simpara></entry>
+<entry align="center" valign="top"><simpara>yes</simpara></entry>
+<entry align="center" valign="top"><simpara>yes</simpara></entry>
+<entry align="center" valign="top"><simpara>yes</simpara></entry>
+</row>
+</tbody>
+</tgroup>
+</table>
+<simpara><literal>TAM</literal> is a totally ordered set:</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mstyle mathvariant="monospace"><mtext>private</mtext></mstyle><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>project</mtext></mstyle><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>public@Internal</mtext></mstyle><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>public</mtext></mstyle></math>
+<requirement xml:id="IDE-3">
+<title>Type Access Modifiers</title>
+<simpara>
+<anchor xml:id="Req-IDE-3" xreflabel="[Req-IDE-3]"/>
+<emphasis role="strong">Requirement: IDE-3:</emphasis>
+<link linkend="Req-IDE-3">Type Access Modifiers</link> (ver. 1)</simpara>
+    <simpara>
+
+The following constraints for type access modifiers for a given type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi></math> (which may be a classifier declaration, a function or a variable) must hold:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>It is an error if <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi></math> is not exported but defined as <literal>project</literal>, <literal>public</literal> or <literal>public@Internal</literal>.</simpara>
+</listitem>
+<listitem>
+<simpara>It is an error if an annotation <literal>@Internal</literal> is present on a module private or <literal>project</literal> visible type.</simpara>
+</listitem>
+<listitem>
+<simpara>The type modifier for all built-in ECMAScript types is <literal>public</literal>.</simpara>
+</listitem>
+<listitem>
+<simpara>The <emphasis>default modifier</emphasis> for user declared exported declarations is <literal>project</literal>.
+That is, this modifier is assumed if no modifier is explicitly specified.</simpara>
+</listitem>
+</itemizedlist>
+</requirement>
+<definition>
+<title>Type Accessibility T</title>
+<simpara>
+<anchor xml:id="type_accessibility_t" xreflabel="[type_accessibility_t]"/>
+<emphasis role="strong">Definition:</emphasis>
+<link linkend="type_accessibility_t">Type Accessibility T</link></simpara>
+<simpara>
+
+The function <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>α</mi><mi>T</mi></msub><mi>:</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mi>e</mi><mi>r</mi><mi>e</mi><mi>n</mi><mi>c</mi><mi>e</mi><mo>×</mo><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>D</mi><mi>e</mi><mi>c</mi><mi>l</mi><mi>a</mi><mi>r</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>o</mi><mi>n</mi><mo>⇒</mo><mi>B</mi><mi>o</mi><mi>o</mi><mi>l</mi><mi>e</mi><mi>a</mi><mi>n</mi></math> computes whether a given type, (top-level) variable or function
+reference can access the declaration that it references.
+<math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>α</mi><mi>T</mi></msub></math> is defined with <xref linkend="tab:type-access-control"/>.</simpara>
+<simpara>Formally, we define <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>α</mi><mi>T</mi></msub></math> for a given reference <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>r</mi></math> and a module top level variable, function or type declaration <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>D</mi></math> as follows <footnote><simpara>See for definitions of metatype properties.</simpara></footnote>:</simpara>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mfrac><mrow><mi>D</mi><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>public</mtext></mstyle></mrow><mrow><msub><mi>α</mi><mi>T</mi></msub><mfenced close=")" open="("><mi>r</mi><mi>D</mi></mfenced></mrow></mfrac></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mfrac><mrow><mi>D</mi><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>public@Internal</mtext></mstyle><mspace width="3.0mm"/><mi>r</mi><mo>.</mo><mi>v</mi><mi>e</mi><mi>n</mi><mi>d</mi><mi>o</mi><mi>r</mi><mo>=</mo><mi>D</mi><mo>.</mo><mi>v</mi><mi>e</mi><mi>n</mi><mi>d</mi><mi>o</mi><mi>r</mi></mrow><mrow><msub><mi>α</mi><mi>T</mi></msub><mfenced close=")" open="("><mi>r</mi><mi>D</mi></mfenced></mrow></mfrac></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mfrac><mrow><mi>D</mi><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>project</mtext></mstyle><mspace width="3.0mm"/><mi>r</mi><mo>.</mo><mi>p</mi><mi>r</mi><mi>o</mi><mi>j</mi><mi>e</mi><mi>c</mi><mi>t</mi><mo>=</mo><mi>D</mi><mo>.</mo><mi>p</mi><mi>r</mi><mi>o</mi><mi>j</mi><mi>e</mi><mi>c</mi><mi>t</mi></mrow><mrow><msub><mi>α</mi><mi>T</mi></msub><mfenced close=")" open="("><mi>r</mi><mi>D</mi></mfenced></mrow></mfrac></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mfrac><mrow><mi>D</mi><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>private</mtext></mstyle><mspace width="3.0mm"/><mi>r</mi><mo>.</mo><mi>m</mi><mi>o</mi><mi>d</mi><mi>u</mi><mi>l</mi><mi>e</mi><mo>=</mo><mi>D</mi><mo>.</mo><mi>m</mi><mi>o</mi><mi>d</mi><mi>u</mi><mi>l</mi><mi>e</mi></mrow><mrow><msub><mi>α</mi><mi>T</mi></msub><mfenced close=")" open="("><mi>r</mi><mi>D</mi></mfenced></mrow></mfrac></math></simpara>
+<simpara>If the type of the arguments is clear from the context, we simply write <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>α</mi><mfenced close=")" open="("><mi>r</mi><mi>D</mi></mfenced></math> instead of <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>α</mi><mi>T</mi></msub><mfenced close=")" open="("><mi>r</mi><mi>D</mi></mfenced></math>.</simpara>
+<simpara>Accessibility for types is only checked for types that manifest themselves in the concrete syntax of the N4JS file.
+Types that do not have to be written to concrete syntax may be used even if they are generally not accessible.
+This is illustrated by <xref linkend="ex:implicit-type-references"/>:</simpara>
+<example xml:id="ex:implicit-type-references">
+<title>Implicit, allowed type references in N4JS</title>
+<programlisting language="n4js" linenumbering="unnumbered">export public class D {
+    public takeC(): C { .. }
+    public acceptC(c: C): void { .. }
+}
+/* private */ class C {}</programlisting>
+<programlisting language="n4js" linenumbering="unnumbered">var d: D = new D()
+d.acceptC( d.takeC() )</programlisting>
+</example>
+</definition>
+<section xml:id="_accessibility-of-members">
+<title>Accessibility of Members</title>
+<simpara>Accessibility at the member level is only applicable when the type itself is accessible.
+If you cannot access the type, you cannot access any of its members.
+Note that inherited members (from an interface or class) become members of a class.
+For example, if <literal>B extends A</literal>, and if <literal>A</literal> is not accessible to some client <literal>C</literal> but <literal>B</literal> is, then the members of <literal>A</literal> are indirectly accessible to <literal>C</literal> in so far as they are accessed via <literal>B</literal>.
+This is true in particular for interfaces, as their properties are possibly merged into the consuming class (cf. <xref linkend="_implementation-of-members"/>).</simpara>
+<simpara>The following member access modifiers are supported by N4JS:</simpara>
+<programlisting language="xtext" linenumbering="unnumbered">enum MemberAccessModifier:    private
+                            | project
+                            | protected
+                            | public;</programlisting>
+<simpara>The modifiers <literal>protected</literal> and <literal>public</literal> may be annotated with <literal>@Internal</literal>.
+Thus, we can define the following set of member access modifiers:</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mtable><mtr><mtd><mi>M</mi><mi>A</mi><mi>M</mi><mo>=</mo><mrow><mo>{</mo><mspace width="3.0mm"/></mrow></mtd></mtr><mtr><mtd><mstyle mathvariant="monospace"><mtext>private</mtext></mstyle><mo>,</mo><mstyle mathvariant="monospace"><mtext>protected@Internal</mtext></mstyle><mo>,</mo><mstyle mathvariant="monospace"><mtext>protected</mtext></mstyle><mo>,</mo></mtd></mtr><mtr><mtd><mstyle mathvariant="monospace"><mtext>project</mtext></mstyle><mo>,</mo><mstyle mathvariant="monospace"><mtext>public@Internal</mtext></mstyle><mo>,</mo><mstyle mathvariant="monospace"><mtext>public</mtext></mstyle></mtd></mtr><mtr><mtd><mrow><mo>}</mo></mrow></mtd></mtr></mtable></math>
+<simpara><literal>protected@Internal</literal> and <literal>public@Internal</literal> are synthesized tags and were introduced as shorthand notation for the <literal>@Internal</literal> annotation together with <literal>protected</literal> or <literal>public</literal> access modifiers.
+The <literal>project</literal> modifier is the default one and it can be omitted.
+As with the type access modifiers, not all member access modifiers are available in N4JS.
+Instead, they are synthesized from different construct as shown in the next example.</simpara>
+<example>
+<title>Synthesized Member Access Modifiers in N4JS</title>
+<programlisting language="n4js" linenumbering="unnumbered">export @Internal public class C {
+
+    private f0;                 // private
+    f1;                         // project
+    project f2;                 // project
+    @Internal protected f3;     // protected@Internal
+    protected f4;               // protected
+    @Internal public f5;        // public@Internal
+    public f6;                  // public
+
+    private m0() {}             // private
+    m1() {}                     // project
+    project m2() {}             // project
+    @Internal protected m3() {} // protected@Internal
+    protected m4() {}           // protected
+    @Internal public m5() {}    // public@Internal
+    public  m6() {}             // public
+}</programlisting>
+</example>
+<simpara><literal>MAM</literal> does not define a totally ordered set. However, its subset</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mi>M</mi><mi>A</mi><mi>M</mi><mo>\</mo><mfenced close="}" open="{"><mstyle mathvariant="monospace"><mtext>public@Internal</mtext></mstyle></mfenced></math>
+<simpara>is a totally ordered set <footnote><simpara>That is, for application developers not providing a library or a public API available to other vendors, member access modifiers behave almost similar to modifiers known from Java.</simpara></footnote> :</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mstyle mathvariant="monospace"><mtext>private</mtext></mstyle><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>project</mtext></mstyle><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>protected@Internal</mtext></mstyle><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>protected</mtext></mstyle><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>public</mtext></mstyle></math>
+<simpara><xref linkend="tab:Member-Access-Controls"/> shows which members are accessible from where.</simpara>
+<table xml:id="tab:Member-Access-Controls" frame="all" rowsep="1" colsep="1">
+<title>Member Access Control</title>
+<tgroup cols="7">
+<colspec colname="col_1" colwidth="25*"/>
+<colspec colname="col_2" colwidth="12.5*"/>
+<colspec colname="col_3" colwidth="12.5*"/>
+<colspec colname="col_4" colwidth="12.5*"/>
+<colspec colname="col_5" colwidth="12.5*"/>
+<colspec colname="col_6" colwidth="12.5*"/>
+<colspec colname="col_7" colwidth="12.5*"/>
+<thead>
+<row>
+<entry align="left" valign="top">Access Modifier</entry>
+<entry align="center" valign="top">Inside Module</entry>
+<entry align="center" valign="top">Inside Project</entry>
+<entry align="center" valign="top">Vendor</entry>
+<entry align="center" valign="top">Vendor Subtypes</entry>
+<entry align="center" valign="top">Other Projects</entry>
+<entry align="center" valign="top">Everywhere</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry align="left" valign="top"><simpara><literal>private</literal></simpara></entry>
+<entry align="center" valign="top"><simpara>yes</simpara></entry>
+<entry align="center" valign="top"><simpara>no</simpara></entry>
+<entry align="center" valign="top"><simpara>no</simpara></entry>
+<entry align="center" valign="top"><simpara>no</simpara></entry>
+<entry align="center" valign="top"><simpara>no</simpara></entry>
+<entry align="center" valign="top"><simpara>no</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><literal>project</literal></simpara></entry>
+<entry align="center" valign="top"><simpara>yes</simpara></entry>
+<entry align="center" valign="top"><simpara>yes</simpara></entry>
+<entry align="center" valign="top"><simpara>no</simpara></entry>
+<entry align="center" valign="top"><simpara>no</simpara></entry>
+<entry align="center" valign="top"><simpara>no</simpara></entry>
+<entry align="center" valign="top"><simpara>no</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><literal>protected@Internal</literal></simpara></entry>
+<entry align="center" valign="top"><simpara>yes</simpara></entry>
+<entry align="center" valign="top"><simpara>yes</simpara></entry>
+<entry align="center" valign="top"><simpara>yes</simpara></entry>
+<entry align="center" valign="top"><simpara>no</simpara></entry>
+<entry align="center" valign="top"><simpara>no</simpara></entry>
+<entry align="center" valign="top"><simpara>no</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><literal>protected</literal></simpara></entry>
+<entry align="center" valign="top"><simpara>yes</simpara></entry>
+<entry align="center" valign="top"><simpara>yes</simpara></entry>
+<entry align="center" valign="top"><simpara>yes</simpara></entry>
+<entry align="center" valign="top"><simpara>no</simpara></entry>
+<entry align="center" valign="top"><simpara>yes</simpara></entry>
+<entry align="center" valign="top"><simpara>no</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><literal>public@Internal</literal></simpara></entry>
+<entry align="center" valign="top"><simpara>yes</simpara></entry>
+<entry align="center" valign="top"><simpara>yes</simpara></entry>
+<entry align="center" valign="top"><simpara>yes</simpara></entry>
+<entry align="center" valign="top"><simpara>yes</simpara></entry>
+<entry align="center" valign="top"><simpara>no</simpara></entry>
+<entry align="center" valign="top"><simpara>no</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><literal>public</literal></simpara></entry>
+<entry align="center" valign="top"><simpara>yes</simpara></entry>
+<entry align="center" valign="top"><simpara>yes</simpara></entry>
+<entry align="center" valign="top"><simpara>yes</simpara></entry>
+<entry align="center" valign="top"><simpara>yes</simpara></entry>
+<entry align="center" valign="top"><simpara>yes</simpara></entry>
+<entry align="center" valign="top"><simpara>yes</simpara></entry>
+</row>
+</tbody>
+</tgroup>
+</table>
+<definition>
+<title>Type and Member Accessibility Relation</title>
+<simpara>
+<anchor xml:id="type_and_member_accessibility_relation" xreflabel="[type_and_member_accessibility_relation]"/>
+<emphasis role="strong">Definition:</emphasis>
+<link linkend="type_and_member_accessibility_relation">Type and Member Accessibility Relation</link></simpara>
+<simpara>
+
+We define the relation</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mo>=</mo><mspace width="1.0em"/><mi>:</mi><mspace width="1.0em"/><mi>T</mi><mi>A</mi><mi>M</mi><mo>×</mo><mi>M</mi><mi>A</mi><mi>M</mi></math>
+<simpara>as follows:</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mtable><mtr><mtd><mo>=</mo><mspace width="1.0em"/><mi>:</mi><mi>:</mi><mo>=</mo><mrow><mo>{</mo></mrow></mtd><mtd><mfenced close=")" open="("><mstyle mathvariant="monospace"><mtext>private</mtext></mstyle><mstyle mathvariant="monospace"><mtext>private</mtext></mstyle></mfenced><mo>,</mo><mfenced close=")" open="("><mstyle mathvariant="monospace"><mtext>project</mtext></mstyle><mstyle mathvariant="monospace"><mtext>project</mtext></mstyle></mfenced><mo>,</mo></mtd></mtr><mtr><mtd/><mtd><mrow><mfenced close=")" open="("><mstyle mathvariant="monospace"><mtext>public@Internal</mtext></mstyle><mstyle mathvariant="monospace"><mtext>public@Internal</mtext></mstyle></mfenced><mo>,</mo><mfenced close=")" open="("><mstyle mathvariant="monospace"><mtext>public</mtext></mstyle><mstyle mathvariant="monospace"><mtext>public</mtext></mstyle></mfenced><mo>}</mo></mrow></mtd></mtr></mtable></math>
+<simpara>We further define the relation <math xmlns="http://www.w3.org/1998/Math/MathML"><mo>≥</mo><mi>:</mi><mi>T</mi><mi>A</mi><mi>M</mi><mo>×</mo><mi>M</mi><mi>A</mi><mi>M</mi></math> as follows:</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><mo>∃</mo><mi>m</mi><mi>a</mi><msup><mi>m</mi><mi>'</mi></msup><mo>∈</mo><mi>M</mi><mi>A</mi><mi>M</mi><mi>:</mi><mi>t</mi><mi>a</mi><mi>m</mi><mo>=</mo><mi>m</mi><mi>a</mi><msup><mi>m</mi><mi>'</mi></msup><mo>∧</mo><mi>m</mi><mi>a</mi><msup><mi>m</mi><mi>'</mi></msup><mo>≥</mo><mi>m</mi><mi>a</mi><mi>m</mi></mrow><mrow><mi>t</mi><mi>a</mi><mi>m</mi><mo>≥</mo><mi>m</mi><mi>a</mi><mi>m</mi></mrow></mfrac></math>
+<simpara>Less, greater then etc. are defined accordingly.</simpara>
+</definition>
+<definition>
+<title>Member Accessibility</title>
+<simpara>
+<anchor xml:id="member_accessibility" xreflabel="[member_accessibility]"/>
+<emphasis role="strong">Definition:</emphasis>
+<link linkend="member_accessibility">Member Accessibility</link></simpara>
+<simpara>
+
+The function</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><msub><mi>α</mi><mi>m</mi></msub><mi>:</mi><mi>M</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi><mi>R</mi><mi>e</mi><mi>f</mi><mi>e</mi><mi>r</mi><mi>e</mi><mi>n</mi><mi>c</mi><mi>e</mi><mo>×</mo><mi>M</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi><mi>D</mi><mi>e</mi><mi>c</mi><mi>l</mi><mi>a</mi><mi>r</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>o</mi><mi>n</mi><mo>⇒</mo><mi>B</mi><mi>o</mi><mi>o</mi><mi>l</mi><mi>e</mi><mi>a</mi><mi>n</mi></math>
+<simpara>computes if a given reference can access the member declaration that it
+references.</simpara>
+</definition>
+<simpara>Note that <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>α</mi><mi>m</mi></msub></math> and <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>b</mi><mi>i</mi><mi>n</mi><mi>d</mi></math> are different functions.
+A reference can only bind to a declaration if it can access the declaration.
+However, bind requires more condition to work (correct metatypes, no shadowing etc).</simpara>
+<simpara>Formally, we define <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>α</mi><mi>m</mi></msub></math> for a given reference <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>r</mi></math> and member declaration <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>M</mi></math> as follows: <footnote><simpara>See <xref linkend="_n4js-specific-classifiers"/> for definitions of metatype properties. Note that <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>r</mi><mo>.</mo><mi>r</mi><mi>e</mi><mi>c</mi><mi>e</mi><mi>i</mi><mi>v</mi><mi>e</mi><mi>r</mi></math> always refers to a type declaration in the context of an expression as the receiver type of <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>r</mi></math>. The declaring type of the member declaration is considered to be the receiver type of the member reference rather than the type that originally declares the member declaration.</simpara></footnote> <footnote><simpara>Note the Java-like access restriction for members of visibility <literal role="language-n4js">protected</literal> or <literal role="language-n4js">protected@Internal</literal> to code that is responsible for the implementation of that object. [<link linkend="Gosling15a">Gosling15a(p.S6.6.2, p.p.166)</link>]</simpara></footnote></simpara>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mfrac><mrow><mi>M</mi><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>public</mtext></mstyle></mrow><mrow><msub><mi>α</mi><mi>m</mi></msub><mfenced close=")" open="("><mi>r</mi><mi>M</mi></mfenced></mrow></mfrac></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mfrac><mrow><mi>r</mi><mo>.</mo><mi>v</mi><mi>e</mi><mi>n</mi><mi>d</mi><mi>o</mi><mi>r</mi><mo>=</mo><mi>M</mi><mo>.</mo><mi>v</mi><mi>e</mi><mi>n</mi><mi>d</mi><mi>o</mi><mi>r</mi><mspace width="3.0mm"/><mi>M</mi><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>public@Internal</mtext></mstyle></mrow><mrow><msub><mi>α</mi><mi>m</mi></msub><mfenced close=")" open="("><mi>r</mi><mi>M</mi></mfenced></mrow></mfrac></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mfrac><mrow><mi>r</mi><mo>.</mo><mi>o</mi><mi>w</mi><mi>n</mi><mi>e</mi><mi>r</mi><mo>∈</mo><mi>r</mi><mo>.</mo><mi>r</mi><mi>e</mi><mi>c</mi><mi>e</mi><mi>i</mi><mi>v</mi><mi>e</mi><mi>r</mi><mo>.</mo><mi>s</mi><mi>u</mi><mi>p</mi><mi>e</mi><msup><mi>r</mi><mo>*</mo></msup><mspace width="3.0mm"/><mi>M</mi><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>protected</mtext></mstyle></mrow><mrow><msub><mi>α</mi><mi>m</mi></msub><mfenced close=")" open="("><mi>r</mi><mi>M</mi></mfenced></mrow></mfrac></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mfrac><mrow><mi>r</mi><mo>.</mo><mi>o</mi><mi>w</mi><mi>n</mi><mi>e</mi><mi>r</mi><mo>∈</mo><mi>r</mi><mo>.</mo><mi>r</mi><mi>e</mi><mi>c</mi><mi>e</mi><mi>i</mi><mi>v</mi><mi>e</mi><mi>r</mi><mo>.</mo><mi>s</mi><mi>u</mi><mi>p</mi><mi>e</mi><msup><mi>r</mi><mo>*</mo></msup><mspace width="3.0mm"/><mi>r</mi><mo>.</mo><mi>v</mi><mi>e</mi><mi>n</mi><mi>d</mi><mi>o</mi><mi>r</mi><mo>=</mo><mi>M</mi><mo>.</mo><mi>v</mi><mi>e</mi><mi>n</mi><mi>d</mi><mi>o</mi><mi>r</mi><mspace width="3.0mm"/><mi>M</mi><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>protected@Internal</mtext></mstyle></mrow><mrow><msub><mi>α</mi><mi>m</mi></msub><mfenced close=")" open="("><mi>r</mi><mi>M</mi></mfenced></mrow></mfrac></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mfrac><mrow><mi>r</mi><mo>.</mo><mi>p</mi><mi>r</mi><mi>o</mi><mi>j</mi><mi>e</mi><mi>c</mi><mi>t</mi><mo>=</mo><mi>M</mi><mo>.</mo><mi>p</mi><mi>r</mi><mi>o</mi><mi>j</mi><mi>e</mi><mi>c</mi><mi>t</mi><mspace width="3.0mm"/><mi>M</mi><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>project</mtext></mstyle></mrow><mrow><msub><mi>α</mi><mi>m</mi></msub><mfenced close=")" open="("><mi>r</mi><mi>M</mi></mfenced></mrow></mfrac></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mfrac><mrow><mi>r</mi><mo>.</mo><mi>m</mi><mi>o</mi><mi>d</mi><mi>u</mi><mi>l</mi><mi>e</mi><mo>=</mo><mi>r</mi><mo>.</mo><mi>m</mi><mi>o</mi><mi>d</mi><mi>u</mi><mi>l</mi><mi>e</mi><mspace width="3.0mm"/><mi>M</mi><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>private</mtext></mstyle></mrow><mrow><msub><mi>α</mi><mi>m</mi></msub><mfenced close=")" open="("><mi>r</mi><mi>M</mi></mfenced></mrow></mfrac></math></simpara>
+<simpara>If the type of the arguments is clear from the context, we simply write <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>α</mi><mfenced close=")" open="("><mi>r</mi><mi>M</mi></mfenced></math> instead of <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>α</mi><mi>m</mi></msub><mfenced close=")" open="("><mi>r</mi><mi>M</mi></mfenced></math>.</simpara>
+<simpara>Although private members are accessible inside a module, it is not possible to redefine (override etc.) these members (see <xref linkend="_redefinition-of-members"/>).</simpara>
+<requirement xml:id="IDE-4">
+<title>Default Member Access Modifiers</title>
+<simpara>
+<anchor xml:id="Req-IDE-4" xreflabel="[Req-IDE-4]"/>
+<emphasis role="strong">Requirement: IDE-4:</emphasis>
+<link linkend="Req-IDE-4">Default Member Access Modifiers</link> (ver. 1)</simpara>
+    <simpara>
+
+The following constraints for member access modifiers must hold:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>The <emphasis>default modifier</emphasis> for members of user-declared classes is <literal>project</literal>.</simpara>
+</listitem>
+<listitem>
+<simpara>The <emphasis>default modifier</emphasis> for members of interfaces is the same as the visibility of the interface itself, except for private interfaces.
+For private interfaces, the default modifier for members is <literal>project</literal>.</simpara>
+</listitem>
+<listitem>
+<simpara>The modifier for enum literals is always <literal>public</literal>.</simpara>
+</listitem>
+<listitem>
+<simpara>Private members of a classifier are visible and accessible within a module, i.e. you can access the private method of a class, for instance,
+when the use of the class as receiver is in the same module where the class has been defined.
+In case of inheritance, private members are visible if the host (e.g. the class) is in the same module as the provider (the extended class).
+This also means that abstract members of a class are allowed to be defined private as they may be overridden within a module.</simpara>
+</listitem>
+</orderedlist>
+</requirement>
+<example>
+<title>Type and Member Access Modifiers</title>
+<programlisting language="n4js" linenumbering="unnumbered">export project interface I {
+    project foo();
+}
+
+// This interface may be used publicly, but since the inherited method foo() is project visible only,
+// it is not possible to implement that interface in other projects.
+export public interface J extends I {
+}
+
+// Since the visibility of foo is set to public here, it is possible to implement this interface in other projects.
+export public interface K extends I {
+    @Override public foo();
+}
+
+// Since foo is private, it is not possible to subclass the class in other modules. Still, it
+// is possible to use it in other projects.
+// XPECT noerrors --&gt;
+export public abstract class C {
+    private abstract foo();
+
+    public static C instance() {
+        // return some default instance
+        ...
+    }
+}</programlisting>
+<simpara>As demonstrated in the following snippet, class <literal>C</literal> can be used but not subclassed in other modules:</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">import C from "C"
+
+// XPECT errors --&gt; "Cannot extend class C: cannot implement one or more non-accessible abstract members: method C.foo." at "C"
+export public abstract class Sub extends C {
+}
+
+// XPECT noerrors --&gt;
+var c: C = C.instance();</programlisting>
+</example>
+<simpara>Members of non-visible types are, in general, not visible for a client.
+Members may become visible, however, if they are accessed via a visible type which inherits these members.
+The following examples demonstrate two different scenarios:</simpara>
+<example>
+<title>Declaring type vs receiver type</title>
+<simpara>It is especially noteworthy that the declaring type of a member is
+generally not considered for the accessibility of that member but only
+the receiver type is relevant.</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">class Base {
+    public m(b: Base): void {}
+}
+export public class ApiType extends Base {
+}</programlisting>
+<programlisting language="n4js" linenumbering="unnumbered">import * as N from "Base";
+
+var t = new N.ApiType();
+// member can be accessed although type Base is not exported:
+t.m(t);</programlisting>
+</example>
+<simpara>The property access to the member <literal>m</literal> is valid because it fulfills the constraints for accessibility.
+The receiver of the property access is <literal>t</literal> of type <literal>ApiType</literal>.
+That type is exported and accessible.
+Therefore, the inherited member <literal>m</literal> is also considered valid since it is also defined <literal>public</literal>.</simpara>
+<simpara>This rule allows for defining a common functionality in module or project visible types that becomes accessible via exported, visible subtypes.</simpara>
+<example>
+<title>Member Access and Type Access Interplay</title>
+<simpara>The following example demonstrates the behavior when
+non-visible types are used as return types. In this case, all the
+members of the non-visible types are not accessible, even if they have a
+public access modifier.</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">class A {
+    foo(): void{}
+}
+export public class C {
+    public getHidden(): A { return new A() };
+}</programlisting>
+<programlisting language="n4js" linenumbering="unnumbered">import * as Nfrom "A"
+
+class Client {
+    f(): void {
+        var c = new N.C();
+        // XPECT noerrors --&gt; Getting an instance the hidden type is possible
+        var hidden = c.getHidden();
+        // XPECT errors --&gt; "The method foo is not visible." at "foo"
+        hidden.foo();
+    }
+}</programlisting>
+</example>
+</section>
+<section xml:id="_valid-names">
+<title>Valid Names</title>
+<simpara>For identifier and property names, the same constraints as in ECMAScript
+[<link linkend="ECMA11a">ECMA11a(p.S7.6)</link>]
+[<link linkend="ECMA11a">ECMA11a(p.S7.6.1.2)</link>]
+[<link linkend="ECMA11a">ECMA11a(p.S11.6)</link>] are applied.</simpara>
+<simpara>Identifier names in N4JS are defined similar to [<link linkend="ECMA11a">ECMA11a(p.S11.6)</link>], making it possible to even use reserved words (keywords etc.).
+For some element types, errors or warnings are issued in order to prevent problems when using these names.</simpara>
+<requirement xml:id="IDE-5">
+<title>Forbidden Identifier Names in N4JS</title>
+<simpara>
+<anchor xml:id="Req-IDE-5" xreflabel="[Req-IDE-5]"/>
+<emphasis role="strong">Requirement: IDE-5:</emphasis>
+<link linkend="Req-IDE-5">Forbidden Identifier Names in N4JS</link> (ver. 1)</simpara>
+    <simpara>
+</simpara>
+<simpara>In N4JS mode, errors are generated in the following cases:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>A name of a type equals</simpara>
+<orderedlist numeration="loweralpha">
+<listitem>
+<simpara>an access modifier</simpara>
+</listitem>
+<listitem>
+<simpara><literal>set</literal> or <literal>get</literal></simpara>
+</listitem>
+<listitem>
+<simpara>an ECMAScript keyword</simpara>
+</listitem>
+<listitem>
+<simpara>a boolean literal</simpara>
+</listitem>
+<listitem>
+<simpara>the name of a base type</simpara>
+</listitem>
+</orderedlist>
+</listitem>
+<listitem>
+<simpara>The name of a function or function expression equals (but not the method)</simpara>
+<orderedlist numeration="loweralpha">
+<listitem>
+<simpara>an ECMAScript keyword</simpara>
+</listitem>
+<listitem>
+<simpara>a reserved future ECMAScript word</simpara>
+</listitem>
+</orderedlist>
+</listitem>
+</orderedlist>
+</requirement>
+<requirement xml:id="IDE-6">
+<title>Undesired Identifier Names in N4JS</title>
+<simpara>
+<anchor xml:id="Req-IDE-6" xreflabel="[Req-IDE-6]"/>
+<emphasis role="strong">Requirement: IDE-6:</emphasis>
+<link linkend="Req-IDE-6">Undesired Identifier Names in N4JS</link> (ver. 1)</simpara>
+    <simpara>
+</simpara>
+<simpara>In N4JS mode, warnings are generated in the following cases:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>The name of a member (of a non external type)</simpara>
+<orderedlist numeration="loweralpha">
+<listitem>
+<simpara>equals the name of a base type <footnote><simpara><literal role="language-n4js">string, boolean, number, any, null</literal></simpara></footnote> but the type of the variable is different from that type</simpara>
+</listitem>
+<listitem>
+<simpara>is not static nor const but starts with an upper case letter</simpara>
+</listitem>
+</orderedlist>
+</listitem>
+<listitem>
+<simpara>The name of a non-external N4 types (class, interface, enum) starts with a lower case letter</simpara>
+</listitem>
+<listitem>
+<simpara>The name of a variable (incl. formal parameter or catch variable and fields)</simpara>
+<orderedlist numeration="loweralpha">
+<listitem>
+<simpara>equals an N4JS keyword</simpara>
+</listitem>
+<listitem>
+<simpara>equals the name of a base type but the type of the variable is different from that type</simpara>
+</listitem>
+<listitem>
+<simpara>is not const but starts with an upper case letter</simpara>
+</listitem>
+</orderedlist>
+</listitem>
+</orderedlist>
+</requirement>
+</section>
+<section xml:id="_qualified-names">
+<title>Qualified Names</title>
+<simpara>In N4JS source code, types can only be referenced using their simple name.
+There is no such thing as a fully-qualified type name in N4JS or ECMAScript.
+Types are uniquely identified by their simple name, maybe together with an import and the module specifier given there.
+Clashes between simple names of imported type and locally declared types can be resolved by importing the type under an alias.</simpara>
+<simpara>In some cases, however, we need to define references to types or even members.
+For example, if we want to reference certain members in JSDoc comments or for unambiguous error messages.
+For this reason, we formally define qualified names even if they cannot occur in source code.</simpara>
+<simpara><xref linkend="tab:typenames"/> shows the different names of a given type <literal>C</literal>, defined in a module
+<literal>M.n4js</literal>, defined in a package <literal>p</literal> of a project <literal>MyProject</literal>.</simpara>
+<simpara>Simple type names are used throughout N4JS code in order to refer to types.
+The different forms of module specifiers are only used in import declarations in the string following the <literal>from</literal> keyword.</simpara>
+<table xml:id="tab:typenames" frame="all" rowsep="1" colsep="1">
+<title>Different forms of module and type specifiers.</title>
+<tgroup cols="2">
+<colspec colname="col_1" colwidth="50*"/>
+<colspec colname="col_2" colwidth="50*"/>
+<thead>
+<row>
+<entry align="left" valign="top">Name</entry>
+<entry align="center" valign="top">Example</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry align="left" valign="top"><simpara>Simple Type Name</simpara></entry>
+<entry align="center" valign="top"><simpara><literal>C</literal></simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara>(Plain) Module Specifier</simpara></entry>
+<entry align="center" valign="top"><simpara><literal>p/M</literal></simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara>Complete Module Specifier</simpara></entry>
+<entry align="center" valign="top"><simpara><literal>MyProject/p/M</literal></simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara>Complete Type Specifier</simpara></entry>
+<entry align="center" valign="top"><simpara><literal>MyProject/p/M.C</literal></simpara></entry>
+</row>
+</tbody>
+</tgroup>
+</table>
+</section>
+<section xml:id="_name-duplicates">
+<title>Name Duplicates</title>
+<simpara>There might be cases where two (or more) scopes created by different entities with the same (simple) name overlap.
+Those situations can be referred to as shadowing, hiding, or obscuring.
+While they are not the same, many of those cases are not allowed in N4JS.
+For simplicity we refer to them all as shadowing or duplication (see below).
+Rule of thumb is that N4JS allows everything that is allowed in JavaScript StrictMode.</simpara>
+<section xml:id="_lexical-environment">
+<title>Lexical Environment</title>
+<simpara>N4JS handles scopes similar to ECMAScript, so that function scope is applied to variables declared with <literal>var</literal> (and parameters), and block scope for variables is declared with <literal>let</literal> or <literal>const</literal>.
+In general, ECMAScript defines <emphasis>Lexical Environments</emphasis> as a specification type used to define the association of Identifiers to specific variables and functions based upon the lexical nesting structure of ECMAScript code [<link linkend="ECMA11a">ECMA11a(p.10.2)</link>].</simpara>
+<variablelist>
+<varlistentry>
+<term>Elements that introduce lexical environments: </term>
+<listitem>
+<simpara><literal>FunctionDefinition</literal>, <literal>VariableDeclaration</literal>, <literal>CatchBlock</literal>, <literal>WithStatement</literal>, <literal>ImportDeclaration</literal></simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>N4JS specific declarations: </term>
+<listitem>
+<simpara><literal>N4ClassDeclaration</literal>, <literal>N4InterfaceDeclaration</literal>,
+<literal>N4EnumDeclaration</literal>, <literal>N4MethodDeclaration</literal>.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+<simpara>Additionally, a built-in lexical environment that defines global scope exists for every <literal>Script</literal>.</simpara>
+<simpara>Since N4JS is extended (and a bit more strict) JS strict mode, <emphasis>Object environment record</emphasis>s created by <literal>WithStatement</literal> are not taken into account when resolving duplicates.
+This applies to both N4JS mode and JS strict mode.
+In unrestricted JS the <literal>WithStatement</literal> is allowed but duplicates are not validated.</simpara>
+<note>
+<simpara>In case of names introduced by <literal>ImportDeclaration</literal>s only <literal>NamedImportSpecifiers</literal>s are taken into account (their import name or its alias if available).
+<literal>WildcardImportSpecifiers</literal>s are not taken into account.
+Potential optimizations by compiler or user annotation are also not currently taken into account during analysis.</simpara>
+</note>
+</section>
+<section xml:id="_duplicates-and-shadowing">
+<title>Duplicates and Shadowing</title>
+<definition>
+<title>Shadowing Overriding Duplicates</title>
+<simpara>
+<anchor xml:id="shadowing_overriding_duplicates" xreflabel="[shadowing_overriding_duplicates]"/>
+<emphasis role="strong">Definition:</emphasis>
+<link linkend="shadowing_overriding_duplicates">Shadowing Overriding Duplicates</link></simpara>
+<simpara>
+</simpara>
+<simpara>Two elements with the same name declared in the same lexical environment (cf. [<link linkend="ECMA11a">ECMA11a(p.S10.2.2.1)</link>] are called <emphasis>duplicates</emphasis>.
+An element defined in an environment <emphasis>shadows</emphasis> all elements with the same name in outer environments.</simpara>
+<simpara>In class hierarchies, a member with the same name as a member defined in a supertype is said to override the latter.
+Overriding is discussed in <xref linkend="_redefinition-of-members"/>.</simpara>
+<simpara>For the following constraints, we make the following assumptions:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>Names of function expressions or declarations are handles similar to locally declared elements in the function.
+Function declarations are additionally declaring a name in their outer scope.</simpara>
+</listitem>
+<listitem>
+<simpara>The implicit formal parameter <literal>arguments</literal> is treated similar to declared formal parameters.</simpara>
+</listitem>
+<listitem>
+<simpara>Formal parameters are defined in the lexical environment of a function, that is, they are defined in the same lexical environment as local <literal>var</literal>-variables or other declarations in that function.</simpara>
+</listitem>
+<listitem>
+<simpara>The "global" environment contains objects globally defined by the execution environment.</simpara>
+</listitem>
+</itemizedlist>
+</definition>
+<requirement xml:id="IDE-7">
+<title>Forbidden Duplicates</title>
+<simpara>
+<anchor xml:id="Req-IDE-7" xreflabel="[Req-IDE-7]"/>
+<emphasis role="strong">Requirement: IDE-7:</emphasis>
+<link linkend="Req-IDE-7">Forbidden Duplicates</link> (ver. 1)</simpara>
+    <simpara>
+
+There must be no two elements defined in the same lexical environment with the same name,
+that is, there must be no duplicates.</simpara>
+</requirement>
+<requirement xml:id="IDE-8">
+<title>Forbidden Shadowing</title>
+<simpara>
+<anchor xml:id="Req-IDE-8" xreflabel="[Req-IDE-8]"/>
+<emphasis role="strong">Requirement: IDE-8:</emphasis>
+<link linkend="Req-IDE-8">Forbidden Shadowing</link> (ver. 1)</simpara>
+    <simpara>
+
+In general, shadowing is allowed in N4JS.
+But it is not allowed in the following cases:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>No element defined in the standard global scope must be shadowed.</simpara>
+</listitem>
+<listitem>
+<simpara>There must be no function shadowing another function.</simpara>
+</listitem>
+<listitem>
+<simpara>Elements defined in catch blocks must not shadow elements defined all parent non-catch-block environments.</simpara>
+</listitem>
+</orderedlist>
+</requirement>
+<requirement xml:id="IDE-9">
+<title>Forbidden Names</title>
+<simpara>
+<anchor xml:id="Req-IDE-9" xreflabel="[Req-IDE-9]"/>
+<emphasis role="strong">Requirement: IDE-9:</emphasis>
+<link linkend="Req-IDE-9">Forbidden Names</link> (ver. 1)</simpara>
+    <simpara>
+
+1. In the script environment, it is not allowed to use the name
+’arguments’.<footnote><simpara>This conflicts with the implicit parameter arguments introduced by the transpiler when wrapping the script/module into a definition function.</simpara></footnote></simpara>
+<simpara>+
+<xref linkend="fig-forbidden-shadowing"/> shows nested lexical environments with named elements declared inside (all named <literal>x</literal> here), the forbidden cases are marked with arrows
+(the numbers at the left side refer to the numbers in <xref linkend="Req-IDE-8"/>.</simpara>
+<figure xml:id="fig-forbidden-shadowing">
+<title>Forbidden Shadowing</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/03_names/fig/shadowing.png" width="50%" scalefit="1" align="center"/>
+</imageobject>
+<textobject><phrase>shadowing</phrase></textobject>
+</mediaobject>
+</figure>
+<simpara>Rationale:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>We expect only few named nested functions.
+Since this is expected to be a rare case, no shadowing should occur there as this is maybe not expected by the programmer.</simpara>
+</listitem>
+<listitem>
+<simpara>It is typical that nested environments define local variables.
+In particular helper variables (such as <literal>i: number i</literal> or <literal>s: string</literal> ) are expected to be used quite often.
+Since this is a typical case, we allow shadowing for local variables.</simpara>
+</listitem>
+<listitem>
+<simpara>Function declarations may shadow type declarations.
+However, both entities are to be handled completely differently, so that an error will occur if the shadowing is ignored by the programmer anyway.</simpara>
+</listitem>
+</itemizedlist>
+</requirement>
+</section>
+</section>
+</section>
+</chapter>
+<chapter xml:id="_types">
+<title>Types</title>
+<section xml:id="_overview" role="language-n4js">
+<title>Overview</title>
+<simpara>N4JS is essentially ECMAScript with the inclusion of types.
+In the following sections we will describe how types are defined and used in N4JS.</simpara>
+<simpara>Besides standard JavaScript types, the following metatypes are introduced:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>Classifiers, that is class or interface (see <xref linkend="_classifiers"/>)</simpara>
+</listitem>
+<listitem>
+<simpara>Enum</simpara>
+</listitem>
+</itemizedlist>
+<simpara>Classifiers, methods and functions may be declared generic.</simpara>
+<simpara>Types are related to each other by the subtype relation.</simpara>
+<definition>
+<title>Subtype Relation</title>
+<simpara>
+<anchor xml:id="subtype_relation" xreflabel="[subtype_relation]"/>
+<emphasis role="strong">Definition:</emphasis>
+<link linkend="subtype_relation">Subtype Relation</link></simpara>
+<simpara>
+
+We use <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>s</mi><mi>u</mi><mi>b</mi><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi></math> for the general subtype relation or type conformance.</simpara>
+<simpara>In nominal typing, <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>S</mi></math> means that <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>S</mi></math> is a (transitive) supertype of <emphasis>T</emphasis>.
+Generally in structural typing, this means that <emphasis>T</emphasis> <emphasis>conforms</emphasis> to <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>S</mi></math>.
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/></math> is defined transitive reflexive by default.</simpara>
+<simpara>We write <math xmlns="http://www.w3.org/1998/Math/MathML"><mo>&lt;</mo></math> to refer to the transitive non-reflexive relation, that is <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi><mo>&lt;</mo><mi>S</mi><mo>⇔</mo><mi>T</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>S</mi><mo>∧</mo><mi>T</mi><mo>≠</mo><mi>S</mi></math></simpara>
+</definition>
+<simpara>Whether nominal or structural typing is used depends on the declaration of the type or the reference.
+This is explained further in <xref linkend="_structural-typing"/>.</simpara>
+<simpara>For convenience reasons, we sometimes revert the operator, that is <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>S</mi><mo>⇔</mo><mi>S</mi><mi>:</mi><mo>&gt;</mo><mi>T</mi></math>.
+We write <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi><mspace width="1.0mm"/><mo>≮</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>S</mi></math> if <emphasis>T</emphasis> is not type conforming to <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>S</mi></math>. (cf. [<link linkend="Gosling12a">Gosling12a(p.S4.10)</link>])</simpara>
+<simpara>Join and meet are defined as follows:</simpara>
+<definition>
+<title>Join and Meet</title>
+<simpara>
+<anchor xml:id="join_and_meet" xreflabel="[join_and_meet]"/>
+<emphasis role="strong">Definition:</emphasis>
+<link linkend="join_and_meet">Join and Meet</link></simpara>
+<simpara>
+
+A type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>J</mi></math> is called a <emphasis>join</emphasis> (or least common supertype, ) of a pair of types <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>S</mi></math> and <emphasis>T</emphasis>, written <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>S</mi><mo>∨</mo><mi>T</mi><mo>=</mo><mi>J</mi></math>, if</simpara>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>S</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>J</mi></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>J</mi></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∀</mo><mi>L</mi><mi>:</mi><mrow><mo>(</mo><mrow><mi>S</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>L</mi><mo>)</mo></mrow><mo>∧</mo><mrow><mo>(</mo><mrow><mi>T</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>L</mi><mo>)</mo></mrow><mo>→</mo><mi>J</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>L</mi></mrow></mrow></math></simpara>
+<simpara>Similarly, we say that a type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>M</mi></math> is a <emphasis>meet</emphasis> (or greatest common subtype, ) of <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>S</mi></math> and <emphasis>T</emphasis>, written <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>S</mi><mo>∧</mo><mi>T</mi><mo>=</mo><mi>M</mi></math>, if<?asciidoc-br?></simpara>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>M</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>S</mi></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>M</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>T</mi></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∀</mo><mi>L</mi><mi>:</mi><mrow><mo>(</mo><mrow><mi>L</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>S</mi><mo>)</mo></mrow><mo>∧</mo><mrow><mo>(</mo><mrow><mi>L</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>T</mi><mo>)</mo></mrow><mo>→</mo><mi>L</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>M</mi></mrow></mrow></math></simpara>
+</definition>
+<simpara>Note that this declarative definition needs to be specified in detail for special cases, such as union and intersection types.
+Usually, the union type of two types is also the join.</simpara>
+<simpara><xref linkend="fig-cd-predefined-type-hierarchy"/> summarizes all predefined types,
+that is primitive and built-in ECMAScript and N4JS types.
+Specific rules for the subtype relation are defined in the following sections.
+This type hierarchy shows <literal>any</literal> and <literal>undefined</literal> as the top and bottom type (cf. [<link linkend="Pierce02a">Pierce02a(p.15.4)</link>]) We define these types here explicitly:</simpara>
+<definition>
+<title>Top and Bottom Type</title>
+<simpara>
+<anchor xml:id="top_and_bottom_type" xreflabel="[top_and_bottom_type]"/>
+<emphasis role="strong">Definition:</emphasis>
+<link linkend="top_and_bottom_type">Top and Bottom Type</link></simpara>
+<simpara>
+
+We call <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi><mi>o</mi><mi>p</mi></math> the top type, if for all types <emphasis>T</emphasis> the relation  <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>T</mi><mi>o</mi><mi>p</mi></math> is true.
+We call <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>B</mi><mi>o</mi><mi>t</mi></math> the bottom type, if for all types <emphasis>T</emphasis> the relation <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>B</mi><mi>o</mi><mi>t</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>T</mi></math> is true.
+In N4JS, <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi><mi>o</mi><mi>p</mi><mo>=</mo><mi>a</mi><mi>n</mi><mi>y</mi></math>, the bottom type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>B</mi><mi>o</mi><mi>t</mi><mo>=</mo><mi>u</mi><mi>n</mi><mi>d</mi><mi>e</mi><mi>f</mi><mi>i</mi><mi>n</mi><mi>e</mi><mi>d</mi></math>.</simpara>
+</definition>
+<simpara><literal>null</literal> is almost similar to <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>B</mi><mi>o</mi><mi>t</mi></math>, except that it is not a subtype of <literal>undefined</literal>.</simpara>
+<figure xml:id="fig-cd-predefined-type-hierarchy">
+<title>Predefined Types Hierarchy</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/04_types/fig/cdPredefinedTypesHierarchy.svg" width="80%" scalefit="1" align="center"/>
+</imageobject>
+<textobject><phrase>cdPredefinedTypesHierarchy</phrase></textobject>
+</mediaobject>
+</figure>
+<simpara>For every primitive type there is a corresponding built-in type as defined in [<link linkend="ECMA11a">ECMA11a</link>], e.g. <literal>string</literal> and <literal>String</literal>.
+There is no inheritance supported for primitive types and built-in types – these types are final.</simpara>
+<simpara>Although the diagram shows inheritance between <literal>void</literal> and <literal>undefined</literal>, this relationship is only semantic: <literal>void</literal> is a refinement of <literal>undefined</literal> from a type system viewpoint.
+The same applies to the relation of <literal>Object</literal> as well as the subtypes shown for <literal>string</literal> and <literal>String</literal>.</simpara>
+<example xml:id="ex:class-hierarchy">
+<title>Type Examples, Class Hierarchy</title>
+<simpara>In the following examples, we assume the following classes to be given:</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">// C &lt;: B &lt;: A
+class A{}
+class B extends A{}
+class C extends B{}
+
+// independent types X, Y, and Z
+class X{} class Y{} class Z{}
+
+// interfaces I, I1 &lt;: I, I2 &lt;: I, I3
+interface I
+interface I1 extends I {}
+interface I2 extends I {}
+interface I3 {}
+
+// class implementing the interfaces
+class H1 implements I1{}
+class H12 implements I1,I2{}
+class H23 implements I2,I3{}
+
+// a generic class with getter (contra-variance) and setter (co-variance)
+class G&lt;T&gt; {
+    get(). T;
+    set(x: T): void;
+}</programlisting>
+</example>
+</section>
+<section xml:id="_type-expressions" role="language-n4js">
+<title>Type Expressions</title>
+<simpara>In contrast to ECMAScript, N4JS defines static types.
+Aside from simple type references, type expressions may be used to specify the type of variables.</simpara>
+<section xml:id="_syntax">
+<title>Syntax</title>
+<simpara>The listing <xref linkend="lst:EBNFTypeExpression"/> summarizes the type expression grammar.
+Depending on the context, not all constructs are allowed.
+For example, the variadic modifier is only allowed for function parameters.</simpara>
+<simpara>References to user-declared types are expressed via <literal>ParameterizedTypeRef</literal>.
+This is also true for non-generic types, as the type arguments are optional.
+See <xref linkend="_parameterized-types"/> for details on that reference.</simpara>
+<simpara>For qualified names and type reference names, see <xref linkend="_qualified-names"/></simpara>
+<simpara>The type expressions are usually added to parameter, field, or variable declarations as a suffix, separated with colon (<literal>:</literal>).
+The same is true for function, method, getter or setter return types.
+Exceptions in the cases of object literals or destructuring are explained later on.</simpara>
+<example>
+<title>Type Annotation Syntax</title>
+<simpara>The following two listings show the very same code and type annotations are provided on
+the left hand side. For simplicity, <literal>string</literal> is always used as type expression.<footnote><simpara>In the N4JS IDE, type annotations are highlighted differently than ordinary code.</simpara></footnote></simpara>
+<informaltable frame="none" rowsep="0" colsep="0">
+<tgroup cols="2">
+<colspec colname="col_1" colwidth="50*"/>
+<colspec colname="col_2" colwidth="50*"/>
+<tbody>
+<row>
+<entry align="left" valign="top"><programlisting language="n4js" linenumbering="unnumbered">var x: string;
+var s: string = "Hello";
+function f(p: string): string {
+    return p;
+}
+class C {
+    f: string;
+    s: string = "Hello";
+    m(p: string): string {
+        return p;
+    }
+    get x(): string {
+        return this.f;
+    }
+    set x(v: string) {
+        this.f = v;
+    }
+}</programlisting></entry>
+<entry align="left" valign="top"><programlisting language="n4js" linenumbering="unnumbered">var x;
+var s = "Hello";
+function f(p) {
+    return p;
+}
+class C {
+    f;
+    s = "Hello";
+    m(p) {
+        return p;
+    }
+    get x() {
+        return this.f;
+    }
+    set x(v) {
+        this.f = v;
+    }
+}</programlisting></entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+<simpara>The code on the right hand side is almost all valid ECMAScript 2015, with the exception of field declarations in the class.
+These are moved into the constructor by the N4JS transpiler.</simpara>
+</example>
+</section>
+<section xml:id="_properties">
+<title>Properties</title>
+<simpara>Besides the properties indirectly defined by the grammar, the following pseudo properties are used for type expressions:</simpara>
+<simpara>Properties of <literal>TypeExpression</literal>:</simpara>
+<variablelist>
+<varlistentry>
+<term><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>v</mi><mi>a</mi><mi>r</mi></math> </term>
+<listitem>
+<simpara>If true, variable of that type is variadic. This is only allowed for parameters. Default value: <literal>false</literal>.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>o</mi><mi>p</mi><mi>t</mi></math> </term>
+<listitem>
+<simpara>If true, variable of that type is optional. This is only allowed for parameters and return types.
+This actually means that the type <emphasis>T</emphasis> actually is a union type of <literal>Undef|<emphasis>T</emphasis></literal>.
+Default value: <literal>false</literal>.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>o</mi><mi>p</mi><mi>t</mi><mi>v</mi><mi>a</mi><mi>r</mi></math> </term>
+<listitem>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>o</mi><mi>p</mi><mi>t</mi><mi>v</mi><mi>a</mi><mi>r</mi><mo>=</mo><mi>v</mi><mi>a</mi><mi>r</mi><mo>∨</mo><mi>o</mi><mi>p</mi><mi>t</mi></math>, reflect the facts that a variadic parameter is also optional (as its cardinality is <math xmlns="http://www.w3.org/1998/Math/MathML"><mrow><mfenced close="]" open="["><mrow><mn>0</mn><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mi>n</mi></mrow></mfenced><mo>)</mo></mrow><mo>.</mo></math></simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>e</mi><mi>n</mi><mi>t</mi><mi>i</mi><mi>t</mi><mi>y</mi></math> </term>
+<listitem>
+<simpara>Pseudo property referencing the variable declaration (or expression) which <literal>owns</literal> the type expression.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+</section>
+<section xml:id="_semantics">
+<title>Semantics</title>
+<simpara>The ECMAScript types <emphasis>undefined</emphasis> and <emphasis>null</emphasis> are also supported.
+These types cannot be referenced directly, however.
+Note that <literal>void</literal> and <emphasis>undefined</emphasis> are almost similar.
+Actually, the inferred type of a types element with declared type of <literal>void</literal> will be <emphasis>undefined</emphasis>.
+The difference between void and undefined is that an element of type void can never have another type,
+while an element of type undefined may be assigned a value later on and thus become a different type.
+<literal>void</literal> is only used for function and method return types.</simpara>
+<simpara>Note that not any type reference is allowed in any context.
+Variables or formal parameters must not be declared <literal>void</literal> or union types must not be declared dynamic, for example.
+These constraints are explained in the following section.</simpara>
+<simpara>The types mentioned above are described in detail in the next sections.
+They are hierarchically defined and the following list displays all possible types.
+Note that all types are actually references to types.
+A type variable can only be used in some cases, e.g., the variable has to be visible in the given scope.</simpara>
+<bridgehead xml:id="_ecmascript-types" renderas="sect4">ECMAScript Types</bridgehead>
+<variablelist>
+<varlistentry>
+<term>Predefined Type</term>
+<listitem>
+<simpara>Predefined types, such as String, Number, or Object; and .</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>Array Type</term>
+<listitem>
+<simpara><xref linkend="_array-object-type"/>.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>Function Type</term>
+<listitem>
+<simpara>Described in <xref linkend="_functions"/>, <xref linkend="_function-type"/>.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>Any Type</term>
+<listitem>
+<simpara><xref linkend="_any-type"/>.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+<bridgehead xml:id="_n4types" renderas="sect4">N4Types</bridgehead>
+<variablelist>
+<varlistentry>
+<term>Declared Type</term>
+<listitem>
+<simpara>(Unparameterized) Reference to defined class <xref linkend="_classes"/> or enum <xref linkend="_enums"/>.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>Parameterized Type</term>
+<listitem>
+<simpara>Parameterized reference to defined generic class or interface; <xref linkend="_parameterized-types"/>.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>This Type</term>
+<listitem>
+<simpara><xref linkend="_this-type"/>.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>Constructor and Type Type</term>
+<listitem>
+<simpara>Class type, that is the meta class of a defined class or interface, <xref linkend="_constructor-and-classifier-type"/>.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>Union Types</term>
+<listitem>
+<simpara>Union of types, <xref linkend="_union-type"/>.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>Type Variable</term>
+<listitem>
+<simpara>Type variable, <xref linkend="_type-variables"/>.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+<simpara>Type expressions are used to explicitly declare the type of a variable, parameter and return type of a function or method, fields (and object literal properties).</simpara>
+</section>
+</section>
+<section xml:id="_type-inference" role="language-n4js">
+<title>Type Inference</title>
+<simpara>If no type is explicitly declared, it is inferred based on the given context, as in the expected type of expressions or function parameters, for example.
+The type inference rules are described in the remainder of this specification.</simpara>
+<definition>
+<title>Default Type</title>
+<simpara>
+<anchor xml:id="default_type" xreflabel="[default_type]"/>
+<emphasis role="strong">Definition:</emphasis>
+<link linkend="default_type">Default Type</link></simpara>
+<simpara>
+
+In N4JS mode , if no type is explicitly specified and if no type information can be inferred, <literal>any</literal> is assumed as the default type.</simpara>
+<simpara>In JS mode, the default type is <literal>any+</literal>.</simpara>
+<simpara>Once the type of a variable is either declared or inferred, it is not supposed to be changed.</simpara>
+</definition>
+<simpara>Given the following example.</simpara>
+<formalpara>
+<title>Variable type is not changeable</title>
+<para>
+<programlisting language="n4js" linenumbering="unnumbered">var x: any;
+x = 42;
+x-5; // error: any is not a subtype of number.</programlisting>
+</para>
+</formalpara>
+<simpara>Type of <literal>x</literal> is declared as <literal>any</literal> in line 1. Although a number is assigned to <literal>x</literal> in line 2, the type of <literal>x</literal> is not changed. Thus an error is issued in line 3 because the type of <literal>x</literal> is still <literal>any</literal>.</simpara>
+<simpara role="todo">At the moment, N4JS does not support type guards or, more general, effect system (cf. [<link linkend="Nielson99a">Nielson99a</link>]).</simpara>
+</section>
+<section xml:id="_generic-and-parameterized-types" role="language-n4js">
+<title>Generic and Parameterized Types</title>
+<simpara>Some notes on terminology:</simpara>
+<variablelist>
+<varlistentry>
+<term>Type Parameter vs. Type Argument</term>
+<listitem>
+<simpara>A type parameter is a declaration containing type variables.
+A type argument is a binding of a type parameter to a concrete type or to another type parameter.
+Binding to another type parameter can further restrict the bounds of the type parameter.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+<simpara>This is similar to function declarations (with formal parameters) and function calls (with arguments).</simpara>
+<section xml:id="_generic-types">
+<title>Generic Types</title>
+<simpara>A class declaration or interface declaration with type parameters declares a generic type.
+A generic type declares a family of types.
+The type parameters have to be bound with type arguments when referencing a generic type.</simpara>
+</section>
+<section xml:id="_type-variables">
+<title>Type Variables</title>
+<simpara>A type variable is an identifier used as a type in the context of a generic class definition, generic interface definition or generic method definition.
+A type variable is declared in a type parameter as follows.</simpara>
+<bridgehead xml:id="_syntax-2" renderas="sect4">Syntax</bridgehead>
+<programlisting language="xtext" linenumbering="unnumbered">TypeVariable:
+	(declaredCovariant?='out' | declaredContravariant?='in')?
+	name=IdentifierOrThis ('extends' declaredUpperBound=TypeRef)?
+;</programlisting>
+<example>
+<title>Type Variable as Upper Bound</title>
+<simpara>Note that type variables are also interpreted as types.
+Thus, the upper bound of a type variable may be a type variable as shown in the following snippet:</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">class G&lt;T&gt; {
+    &lt;X extends T&gt; foo(x: X): void { }
+}</programlisting>
+</example>
+<bridgehead xml:id="type-variables-properties" renderas="sect4">Properties</bridgehead>
+<simpara>A type parameter defines a type variable, which type may be constrained with an upper bound.</simpara>
+<simpara>Properties of <literal>TypeVariable</literal>:</simpara>
+<variablelist>
+<varlistentry>
+<term><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi></math> </term>
+<listitem>
+<simpara>Type variable, as type variable contains only an identifier, we use type parameter instead of type variable (and vice versa) if the correct element is clear from the context.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>d</mi><mi>e</mi><mi>c</mi><mi>l</mi><mi>a</mi><mi>r</mi><mi>e</mi><mi>d</mi><mi>U</mi><mi>p</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>B</mi><mi>o</mi><mi>u</mi><mi>n</mi><mi>d</mi></math> </term>
+<listitem>
+<simpara>Upper bound of the concrete type being bound to this type variable, i.e. a super class.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+<bridgehead xml:id="type-variables-semantics" renderas="sect4">Semantics</bridgehead>
+<requirement xml:id="IDE-10">
+<title>Type Variable Semantics</title>
+<simpara>
+<anchor xml:id="Req-IDE-10" xreflabel="[Req-IDE-10]"/>
+<emphasis role="strong">Requirement: IDE-10:</emphasis>
+<link linkend="Req-IDE-10">Type Variable Semantics</link> (ver. 1)</simpara>
+    <simpara>
+
+1.  Enum is not a valid metatype in <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>d</mi><mi>e</mi><mi>c</mi><mi>l</mi><mi>a</mi><mi>r</mi><mi>e</mi><mi>d</mi><mi>U</mi><mi>p</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>B</mi><mi>o</mi><mi>u</mi><mi>n</mi><mi>d</mi><mi>s</mi></math>.
+2.  Wildcards are not valid in <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>d</mi><mi>e</mi><mi>c</mi><mi>l</mi><mi>a</mi><mi>r</mi><mi>e</mi><mi>d</mi><mi>U</mi><mi>p</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>B</mi><mi>o</mi><mi>u</mi><mi>n</mi><mi>d</mi><mi>s</mi></math>.
+3.  Primitives are not valid in <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>d</mi><mi>e</mi><mi>c</mi><mi>l</mi><mi>a</mi><mi>r</mi><mi>e</mi><mi>d</mi><mi>U</mi><mi>p</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>B</mi><mi>o</mi><mi>u</mi><mi>n</mi><mi>d</mi><mi>s</mi></math>.
+4.  Type variables are valid in <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>d</mi><mi>e</mi><mi>c</mi><mi>l</mi><mi>a</mi><mi>r</mi><mi>e</mi><mi>d</mi><mi>U</mi><mi>p</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>B</mi><mi>o</mi><mi>u</mi><mi>n</mi><mi>d</mi><mi>s</mi></math>.</simpara>
+</requirement>
+<simpara>A type variable can be used in any type expression contained in the generic class, generic interface, or generic function / method definition.</simpara>
+<example>
+<title>F bounded quantification</title>
+<simpara>Using a type variable in the upper bound reference may lead to recursive definition.</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">class Chain&lt;C extends Chain&lt;C, T&gt;, T&gt; {
+    next() : C { return null; }
+    m() : T { return null; }
+}</programlisting>
+</example>
+<bridgehead xml:id="type-variables-type-inference" renderas="sect4">Type Inference</bridgehead>
+<simpara>In many cases, type variables are not directly used in subtype relations as they are substituted with the concrete types specified by some type arguments.
+In these cases, the ordinary subtype rules apply without change.
+However, there are other cases in which type variables cannot be substituted:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>Inside a generic declaration.</simpara>
+</listitem>
+<listitem>
+<simpara>If the generic type is used as raw type.</simpara>
+</listitem>
+<listitem>
+<simpara>If a generic function / method is called without type arguments and without the possibility to infer the type from the context.</simpara>
+</listitem>
+</orderedlist>
+<simpara>In these cases, an unbound type variable may appear on one or both sides of a subtype relation and we require subtype rules that take type variables into account.</simpara>
+<simpara>It is important to note that while type variables may have a declared upper bound, they cannot be simply replaced with that upper bound and treated like existential types.
+The following example illustrates this:</simpara>
+<example>
+<title>Type variables vs. existential types</title>
+<programlisting language="n4js" linenumbering="unnumbered">class A {}
+class B extends A {}
+class C extends B {}
+
+class G&lt;T&gt; {}
+
+class X&lt;T extends A, S extends B&gt; {
+
+    m(): void {
+
+        // plain type variables:
+        var t: T;
+        var s: S;
+
+        t = s;  // ERROR: "S is not a subtype of T." at "s" <co xml:id="CO1-1"/>
+
+        // existential types:
+        var ga: G&lt;? extends A&gt;;
+        var gb: G&lt;? extends B&gt;;
+
+        ga = gb;  <co xml:id="CO1-2"/>
+    }
+}</programlisting>
+<calloutlist>
+<callout arearefs="CO1-1">
+<para>Even though the upper bound of <literal>S</literal> is a subtype of <literal>T</literal>’s upper bound (since <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>B</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>A</mi></math>), we cannot infer that <literal>S</literal> is a subtype of <literal>T</literal>,
+because there are valid concrete bindings for which this would not be true: for example, if <literal>T</literal> were bound to <literal>C</literal> and <literal>S</literal> to <literal>B</literal>.</para>
+</callout>
+<callout arearefs="CO1-2">
+<para>This differs from existential types (see <literal>ga</literal> and <literal>gb</literal> and line 21):<?asciidoc-br?>
+<literal>G&lt;? extends B&gt;</literal> <math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/></math> <literal>G&lt;? extends A&gt;</literal> ).</para>
+</callout>
+</calloutlist>
+</example>
+<simpara>We thus have to define subtype rules for type variables, taking the declared upper bound into account.
+If we have a subtype relation in which a type variable appears on one or both sides, we distinguish the following cases:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>If we have type variables on both sides: the result is true if and only if there is the identical type variable on both sides.</simpara>
+</listitem>
+<listitem>
+<simpara>If we have a type variable on the left side and no type variable on the right side:<?asciidoc-br?>
+the result is true if and only if the type variable on the left has one or more declared upper bounds.<?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>i</mi><mi>n</mi><mi>t</mi><mi>e</mi><mi>r</mi><mi>s</mi><mi>e</mi><mi>c</mi><mi>t</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close=")" open="("><mrow><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi><mo>.</mo><mi>d</mi><mi>e</mi><mi>c</mi><mi>l</mi><mi>a</mi><mi>r</mi><mi>e</mi><mi>d</mi><mi>U</mi><mi>p</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>B</mi><mi>o</mi><mi>u</mi><mi>n</mi><mi>d</mi><mi>s</mi></mrow></mfenced><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>r</mi><mi>i</mi><mi>g</mi><mi>h</mi><mi>t</mi></math><?asciidoc-br?>
+This is the case for</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfenced close=")" open="("><mrow><mi>T</mi><mspace width="3.0mm"/><mi>e</mi><mi>x</mi><mi>t</mi><mi>e</mi><mi>n</mi><mi>d</mi><mi>s</mi><mspace width="3.0mm"/><mi>B</mi></mrow></mfenced><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>A</mi></math>
+<simpara>in which T is an unbound type variable and A, B two classes with <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>B</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>A</mi></math>.</simpara>
+</listitem>
+<listitem>
+<simpara>In all other cases the result is false.<?asciidoc-br?>
+This includes cases such as</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mi>B</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mfenced close=")" open="("><mrow><mi>T</mi><mspace width="3.0mm"/><mi>e</mi><mi>x</mi><mi>t</mi><mi>e</mi><mi>n</mi><mi>d</mi><mi>s</mi><mspace width="3.0mm"/><mi>A</mi></mrow></mfenced></math>
+<simpara>which is always false, even if <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>B</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>A</mi></math> or</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfenced close=")" open="("><mrow><mi>T</mi><mspace width="3.0mm"/><mi>e</mi><mi>x</mi><mi>t</mi><mi>e</mi><mi>n</mi><mi>d</mi><mi>s</mi><mspace width="3.0mm"/><mi>A</mi></mrow></mfenced><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mfenced close=")" open="("><mrow><mi>S</mi><mspace width="3.0mm"/><mi>e</mi><mi>x</mi><mi>t</mi><mi>e</mi><mi>n</mi><mi>d</mi><mi>s</mi><mspace width="3.0mm"/><mi>B</mi></mrow></mfenced></math>
+<simpara>which is always false, even if <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>A</mi><mo>=</mo><mi>B</mi></math>.</simpara>
+</listitem>
+</orderedlist>
+<simpara>We thus obtain the following defintion:</simpara>
+<definition>
+<title>Subtype Relation for Type Variables</title>
+<simpara>
+<anchor xml:id="subtype_relation_for_type_variables" xreflabel="[subtype_relation_for_type_variables]"/>
+<emphasis role="strong">Definition:</emphasis>
+<link linkend="subtype_relation_for_type_variables">Subtype Relation for Type Variables</link></simpara>
+<simpara>
+
+For two types <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi><mo>,</mo><mi>S</mi></math> of which at least one is a type variable, we define</simpara>
+<itemizedlist>
+<listitem>
+<simpara>if both <emphasis>T</emphasis> and <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>S</mi></math> are type variables:</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><mi>T</mi><mo>=</mo><mi>S</mi></mrow><mrow><mi>T</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>S</mi></mrow></mfrac></math>
+</listitem>
+<listitem>
+<simpara>if <emphasis>T</emphasis> is a type variable and <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>S</mi></math> is not:</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><mrow><mi>T</mi><mo>.</mo><mstyle mathvariant="italic"><mi>d</mi><mi>e</mi><mi>c</mi><mi>l</mi><mi>a</mi><mi>r</mi><mi>e</mi><mi>d</mi><mi>U</mi><mi>p</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>B</mi><mi>o</mi><mi>u</mi><mi>n</mi><mi>d</mi><mi>s</mi></mstyle><mo>.</mo><mstyle mathvariant="italic"><mi>s</mi><mi>i</mi><mi>z</mi><mi>e</mi></mstyle><mo>&gt;</mo><mn>0</mn></mrow><mrow><mi> </mi><mo>∧</mo><mi> </mi><mo>∀</mo><mi>t</mi><mo>∈</mo><mi>T</mi><mo>.</mo><mstyle mathvariant="italic"><mi>d</mi><mi>e</mi><mi>c</mi><mi>l</mi><mi>a</mi><mi>r</mi><mi>e</mi><mi>d</mi><mi>U</mi><mi>p</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>B</mi><mi>o</mi><mi>u</mi><mi>n</mi><mi>d</mi><mi>s</mi></mstyle><mi>:</mi><mi>t</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>S</mi></mrow></mrow><mrow><mi>T</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>S</mi></mrow></mfrac></math>
+</listitem>
+</itemizedlist>
+</definition>
+</section>
+<section xml:id="_parameterized-types">
+<title>Parameterized Types</title>
+<simpara>References to generic types (cf. <xref linkend="_classes"/>) can be parameterized with type arguments.
+A type reference with type arguments is called parameterized type.</simpara>
+<bridgehead xml:id="parameterized-types-syntax" renderas="sect4">Syntax</bridgehead>
+<programlisting language="xtext" linenumbering="unnumbered">ParameterizedTypeRef:
+    ParameterizedTypeRefNominal | ParameterizedTypeRefStructural;
+
+ParameterizedTypeRefNominal:
+    declaredType=[Type|TypeReferenceName]
+    (=&gt; '&lt;' typeArgs+=TypeArgument (',' typeArgs+=TypeArgument)* '&gt;')?;
+
+ParameterizedTypeRefStructural:
+    definedTypingStrategy=TypingStrategyUseSiteOperator
+    declaredType=[Type|TypeReferenceName]
+    (=&gt;'&lt;' typeArgs+=TypeArgument (',' typeArgs+=TypeArgument)* '&gt;')?
+    ('with' TStructMemberList)?;
+
+TypeArgument returns TypeArgument:
+    Wildcard | TypeRef;
+
+Wildcard returns Wildcard:
+    '?'
+    (
+          'extends' declaredUpperBound=TypeRef
+        | 'super' declaredLowerBound=TypeRef
+    )?
+;</programlisting>
+<bridgehead xml:id="parameterized-types-properties" renderas="sect4">Properties</bridgehead>
+<simpara>Properties of parameterized type references (nominal or structural):</simpara>
+<variablelist>
+<varlistentry>
+<term><literal>declaredType</literal> </term>
+<listitem>
+<simpara>Referenced type by type reference name (either the simple name or a qualified name, e.g. in case of namespace imports).</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>typeArgs</literal> </term>
+<listitem>
+<simpara>The type arguments, may be empty.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>definedTypingStrategy</literal> </term>
+<listitem>
+<simpara>Typing strategy, by default nominal, see <xref linkend="_structural-typing"/> for details</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>structuralMembers</literal> </term>
+<listitem>
+<simpara>in case of structural typing, reference can add additional members to the structural type, see <xref linkend="_structural-typing"/> for details.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+<simpara><emphasis role="strong">Pseudo Properties:</emphasis></simpara>
+<variablelist>
+<varlistentry>
+<term><literal>importSpec</literal> </term>
+<listitem>
+<simpara>The <literal>ImportSpecifier</literal>, may be null if this is a local type reference.
+Note that this may be a <literal>NamedImportSpecifier</literal>. See <xref linkend="_import-statement"/> for details for details.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>moduleWideName</literal> </term>
+<listitem>
+<simpara>Returns simple name of type, that is either the simple name as declared, or the alias in case of an imported type with alias in the import statement.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+<bridgehead xml:id="parameterized-types-semantics" renderas="sect4">Semantics</bridgehead>
+<simpara>The main purpose of a parameterized type reference is to simply refer to the declared type.
+If the declared type is a generic type, the parameterized type references defines a <emphasis>substitution</emphasis> of the type parameters of a generic type with actual type arguments.
+A type argument can either be a concrete type, a wildcard or a type variable declared in the surrounding generic declaration.
+The actual type arguments must conform to the type parameters so that code referencing the generic type parameters is still valid.</simpara>
+<requirement xml:id="IDE-11">
+<title>Parameterized Types</title>
+<simpara>
+<anchor xml:id="Req-IDE-11" xreflabel="[Req-IDE-11]"/>
+<emphasis role="strong">Requirement: IDE-11:</emphasis>
+<link linkend="Req-IDE-11">Parameterized Types</link> (ver. 1)</simpara>
+    <simpara>
+
+For a given parameterized type reference <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>R</mi></math> with <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>G</mi><mo>=</mo><mi>R</mi><mo>.</mo><mi>d</mi><mi>e</mi><mi>c</mi><mi>l</mi><mi>a</mi><mi>r</mi><mi>e</mi><mi>d</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi></math>, the following constraints must hold:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>The actual type arguments must conform to the type parameters, that is:</simpara>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mo>|</mo><mi>G</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>P</mi><mi>a</mi><mi>r</mi><mi>s</mi><mo>|</mo><mo>=</mo><mo>|</mo><mi>R</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>A</mi><mi>r</mi><mi>g</mi><mi>s</mi><mo>|</mo></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∧</mo><mo>∀</mo><mi> </mi><mi>i</mi><mo>,</mo><mn>0</mn><mo>&lt;</mo><mi>i</mi><mo>&lt;</mo><mo>|</mo><mi>R</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>A</mi><mi>r</mi><mi>g</mi><mi>s</mi><mo>|</mo><mi>:</mi><mrow><mo>[</mo><mspace width="-0.167em"/><mrow><mo>[</mo></mrow></mrow><mrow><mi>R</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>A</mi><mi>r</mi><mi>g</mi><msub><mi>s</mi><mi>i</mi></msub></mrow><mrow><mrow><mo>]</mo></mrow><mspace width="-0.167em"/><mo>]</mo></mrow><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mrow><mo>[</mo><mspace width="-0.167em"/><mrow><mo>[</mo></mrow></mrow><mrow><mi>R</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>P</mi><mi>a</mi><mi>r</mi><msub><mi>s</mi><mi>i</mi></msub></mrow><mrow><mrow><mo>]</mo></mrow><mspace width="-0.167em"/><mo>]</mo></mrow></math></simpara>
+</listitem>
+</itemizedlist>
+</requirement>
+<simpara>We define type erasure similar to Java [<link linkend="Gosling12a">Gosling12a(p.S4.6)</link>] as 'mapping from types (possibly including parameterized types and type variables)
+to types (that are never parameterized types or type variables)'. We write <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi></math><superscript>o</superscript>
+for the erasure of type <emphasis>T</emphasis>.<footnote><simpara>The notation <math xmlns="http://www.w3.org/1998/Math/MathML"><mo>|</mo><mi>T</mi><mo>|</mo></math> used in [<link linkend="Gosling12a">Gosling12a</link>] conflicts with the notation of cardinality of sets, which we use in case of union or intersection types for types as well. The notation used here is inspired by [<link linkend="Crary02a">Crary02a</link>], in which a mapping is defined between a typed language <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>λ</mi></math> to an untyped language <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>λ</mi></math><superscript>o</superscript>.</simpara></footnote></simpara>
+<definition>
+<title>Parameterized Type</title>
+<simpara>
+<anchor xml:id="parameterized_type" xreflabel="[parameterized_type]"/>
+<emphasis role="strong">Definition:</emphasis>
+<link linkend="parameterized_type">Parameterized Type</link></simpara>
+<simpara>
+
+A parameterized type reference <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>R</mi></math> defines a parameterized type <emphasis>T</emphasis>, in which all type parameters of <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>R</mi><mo>.</mo><mi>d</mi><mi>e</mi><mi>c</mi><mi>l</mi><mi>a</mi><mi>r</mi><mi>e</mi><mi>d</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi></math> are substituted with the actual values of the type arguments.
+We call the type <math xmlns="http://www.w3.org/1998/Math/MathML"><msup><mi>T</mi><mn>0</mn></msup></math>, in which all type parameters of <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>R</mi><mo>.</mo><mi>d</mi><mi>e</mi><mi>c</mi><mi>l</mi><mi>a</mi><mi>r</mi><mi>e</mi><mi>d</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi></math> are ignored, the <emphasis>raw type</emphasis> or <emphasis>erasure</emphasis> of <emphasis>T</emphasis>.</simpara>
+<simpara>We define for types in general:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>The erasure <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>G</mi></math><superscript>o</superscript> of a parameterized type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>G</mi><mo>&lt;</mo><msub><mi>T</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>T</mi><mi>n</mi></msub><mo>&gt;</mo></math> is simply <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>G</mi></math>.</simpara>
+</listitem>
+<listitem>
+<simpara>The erasure of a type variable is the erasure of its upper bound.</simpara>
+</listitem>
+<listitem>
+<simpara>The erasure of any other type is the type itself.</simpara>
+</listitem>
+</itemizedlist>
+</definition>
+<simpara>This concept of type erasure is purely defined for specification purposes.
+It is not to be confused with the <literal>real</literal> type erasure which takes place at runtime, in which almost no types (except primitive types) are available.</simpara>
+<simpara>That is, the type reference in <literal>var G&lt;string&gt; gs;</literal> actually defines a type <literal>G&lt;string&gt;</literal>, so that <math xmlns="http://www.w3.org/1998/Math/MathML"><mrow><mo>[</mo><mspace width="-0.167em"/><mrow><mo>[</mo></mrow></mrow><mrow><mi>g</mi><mi>s</mi></mrow><mrow><mrow><mo>]</mo></mrow><mspace width="-0.167em"/><mo>]</mo></mrow><mo>=</mo><mstyle mathvariant="monospace"><mtext>G</mtext></mstyle><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>string</mtext></mstyle><mo>&gt;</mo></math>.
+It may reference a type defined by a class declaration <literal>class G&lt;T&gt;</literal>.
+It is important that the type <literal>G&lt;string&gt;</literal> is different from <literal>G&lt;T&gt;</literal>.</simpara>
+<simpara>If a parameterized type reference <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>R</mi></math> has no type arguments, then it is similar to the declared type.
+That is, <math xmlns="http://www.w3.org/1998/Math/MathML"><mrow><mo>[</mo><mspace width="-0.167em"/><mrow><mo>[</mo></mrow></mrow><mi>R</mi><mrow><mrow><mo>]</mo></mrow><mspace width="-0.167em"/><mo>]</mo></mrow><mo>=</mo><mi>T</mi><mo>=</mo><mi>R</mi><mo>.</mo><mi>d</mi><mi>e</mi><mi>c</mi><mi>l</mi><mi>a</mi><mi>r</mi><mi>e</mi><mi>d</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi></math> if (and only if) <math xmlns="http://www.w3.org/1998/Math/MathML"><mo>|</mo><mi>R</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>A</mi><mi>r</mi><mi>g</mi><mi>s</mi><mo>|</mo><mo>=</mo><mn>0</mn></math>.</simpara>
+<simpara>In the following, we do not distinguish between parameter type reference and parameter type – they are both two sides of the same coin.</simpara>
+<example>
+<title>Raw Types</title>
+<simpara>In Java, due to backward compatibility (generics were only introduced in Java 1.5), it is possible to use raw types in which we refer to a generic type without specifying any type arguments.
+This is not possible in N4JS, as there is no unique interpretation of the type in that case as shown in the following example.
+Given the following declarations:</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">class A{}
+class B extends A{}
+class G&lt;T extends A&gt; { t: T; }
+var g: G;</programlisting>
+</example>
+<simpara>In this case, variable <literal>g</literal> refers to the <emphasis>raw type</emphasis> <literal>G</literal>.
+This is forbidden in N4JS, because two interpretations are possible:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara><literal>g</literal> is of type <literal>G&lt;?  extends&gt;</literal></simpara>
+</listitem>
+<listitem>
+<simpara><literal>g</literal> is of type <literal>G&lt;A&gt;</literal></simpara>
+</listitem>
+</orderedlist>
+<simpara>In the first case, an existential type would be created, and <literal>g.t = new A();</literal> must fail.</simpara>
+<simpara>In the second case, <literal>g = new G&lt;B&gt;();</literal> must fail.</simpara>
+<simpara>In Java, both assignments work with raw types, which is not really safe.
+To avoid problems due to different interpretations, usage of raw types
+is not allowed in N4JS. <footnote><simpara>Although raw type usage is prohibited, the N4JS validator interprets raw types according to the first case, which may lead to consequential errors.</simpara></footnote></simpara>
+<simpara>Calls to generic functions and methods can also be parameterized, this is described in <xref linkend="_function-calls"/>.
+Note that invocation of generic functions or methods does not need to be parameterized.</simpara>
+<definition>
+<title>Type Conformance</title>
+<simpara>
+<anchor xml:id="type_conformance" xreflabel="[type_conformance]"/>
+<emphasis role="strong">Definition:</emphasis>
+<link linkend="type_conformance">Type Conformance</link></simpara>
+<simpara>
+
+We define type conformance for non-primitive type references as follows:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>For two non-parameterized types <math xmlns="http://www.w3.org/1998/Math/MathML"><msup><mi>T</mi><mn>0</mn></msup></math> and <math xmlns="http://www.w3.org/1998/Math/MathML"><msup><mi>S</mi><mn>0</mn></msup></math>,</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><msup><mi>S</mi><mn>0</mn></msup><mo>∈</mo><msup><mi>T</mi><mn>0</mn></msup><mo>.</mo><mi>s</mi><mi>u</mi><msup><mi>p</mi><mo>*</mo></msup><mo>∪</mo><msup><mi>T</mi><mn>0</mn></msup><mo>.</mo><mi>i</mi><mi>n</mi><mi>t</mi><mi>e</mi><mi>r</mi><mi>f</mi><mi>a</mi><mi>c</mi><mi>e</mi><msup><mi>s</mi><mo>*</mo></msup></mrow><mrow><msup><mi>T</mi><mn>0</mn></msup><mo>&lt;</mo><mi>:</mi><msup><mi>S</mi><mn>0</mn></msup></mrow></mfrac></math>
+</listitem>
+<listitem>
+<simpara>For two parameterized types <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi><mo>&lt;</mo><msub><mi>T</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>T</mi><mi>n</mi></msub><mo>&gt;</mo></math> and <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>S</mi><mo>&lt;</mo><msub><mi>S</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>S</mi><mi>m</mi></msub><mo>&gt;</mo></math></simpara>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mfrac><mrow><msup><mi>T</mi><mn>0</mn></msup><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><msup><mi>S</mi><mn>0</mn></msup></mrow><mrow><mspace width="10.0em"/><mi>T</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>S</mi><mspace width="10.0em"/></mrow></mfrac></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mrow><mo>(</mo><mi>n</mi><mo>=</mo><mn>0</mn><mo>∨</mo><mi>m</mi><mo>=</mo><mn>0</mn><mo>∨</mo><mrow><mo>(</mo><mi>n</mi><mo>=</mo><mi>m</mi><mo>→</mo><mo>∀</mo><mi>i</mi><mi>:</mi></mrow></mrow></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="2.0em"/><mrow><msub><mi>T</mi><mi>i</mi></msub><mo>.</mo><mi>u</mi><mi>p</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>B</mi><mi>o</mi><mi>u</mi><mi>n</mi><mi>d</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><msub><mi>S</mi><mi>i</mi></msub><mo>.</mo><mi>u</mi><mi>p</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>B</mi><mi>o</mi><mi>u</mi><mi>n</mi><mi>d</mi></mrow></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mrow><mrow><mspace width="1.0em"/><mo>∧</mo><mrow><msub><mi>T</mi><mi>i</mi></msub><mo>.</mo><mi>l</mi><mi>o</mi><mi>w</mi><mi>e</mi><mi>r</mi><mi>B</mi><mi>o</mi><mi>u</mi><mi>n</mi><mi>d</mi><mi>:</mi><mo>&gt;</mo><msub><mi>S</mi><mi>i</mi></msub><mo>.</mo><mi>l</mi><mi>o</mi><mi>w</mi><mi>e</mi><mi>r</mi><mi>B</mi><mi>o</mi><mi>u</mi><mi>n</mi><mi>d</mi></mrow><mo>)</mo></mrow><mo>)</mo></mrow><mi>}</mi></math></simpara>
+</listitem>
+</itemizedlist>
+</definition>
+<example>
+<title>Subtyping with parameterized types</title>
+<simpara>Let classes A, B, and C are defined as in the chapter beginning (<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>C</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>B</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>A</mi></math>).
+The following subtype relations are evaluated as indicated:</simpara>
+<programlisting language="xtext" linenumbering="unnumbered">G&lt;A&gt; &lt;: G&lt;B&gt;                        -&gt; false
+G&lt;B&gt; &lt;: G&lt;A&gt;                        -&gt; false
+G&lt;A&gt; &lt;: G&lt;A&gt;                        -&gt; true
+G&lt;A&gt; &lt;: G&lt;?&gt;                        -&gt; true
+G&lt;? extends A&gt; &lt;: G&lt;? extends A&gt;    -&gt; true
+G&lt;? super A&gt; &lt;: G&lt;? super A&gt;        -&gt; true
+G&lt;? extends A&gt; &lt;: G&lt;? extends B&gt;    -&gt; false
+G&lt;? extends B&gt; &lt;: G&lt;? extends A&gt;    -&gt; true
+G&lt;? super A&gt; &lt;: G&lt;? super B&gt;        -&gt; true
+G&lt;? super B&gt; &lt;: G&lt;? super A&gt;        -&gt; false
+G&lt;? extends A&gt; &lt;: G&lt;A&gt;              -&gt; false
+G&lt;A&gt; &lt;: G&lt;? extends A&gt;              -&gt; true
+G&lt;? super A&gt; &lt;: G&lt;A&gt;                -&gt; false
+G&lt;A&gt; &lt;: G&lt;? super A&gt;                -&gt; true
+G&lt;? super A&gt; &lt;: G&lt;? extends A&gt;      -&gt; false
+G&lt;? extends A&gt; &lt;: G&lt;? super A&gt;      -&gt; false
+G&lt;?&gt; &lt;: G&lt;? super A&gt;                -&gt; false
+G&lt;? super A&gt; &lt;: G&lt;?&gt;                -&gt; true
+G&lt;?&gt; &lt;: G&lt;? extends A&gt;              -&gt; false
+G&lt;? extends A&gt; &lt;: G&lt;?&gt;              -&gt; true</programlisting>
+</example>
+<simpara>The figure <xref linkend="cdVarianceChart"/> shows the subtype relations of parameterized types (of a single generic type), which can be used as a cheat sheet.</simpara>
+<figure xml:id="cdVarianceChart">
+<title>Cheat Sheet: Subtype Relation of Parameterized Types</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/04_types/fig/cdVarianceChart.svg" align="center"/>
+</imageobject>
+<textobject><phrase>cdVarianceChart</phrase></textobject>
+</mediaobject>
+</figure>
+<example>
+<title>Subtyping between different generic types</title>
+<simpara>Let classes <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>G</mi></math> and <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>H</mi></math> be two generic classes where:</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">class G&lt;T&gt; {}
+class H&lt;T&gt; extends G&lt;T&gt; {}</programlisting>
+<simpara>Given a simple, non-parameterized class <emphasis>A</emphasis>, the following
+subtype relations are evaluated as indicated:</simpara>
+<programlisting language="xtext" linenumbering="unnumbered">G&lt;A&gt; &lt;: G&lt;A&gt;                        -&gt; true
+H&lt;A&gt; &lt;: G&lt;A&gt;                        -&gt; true
+G&lt;A&gt; &lt;: H&lt;A&gt;                        -&gt; false</programlisting>
+</example>
+<bridgehead xml:id="parameterized-types-type-inference" renderas="sect4">Type Inference</bridgehead>
+<simpara>Type inference for parameterized types uses the concept of existential types (in Java, a slightly modified version called capture conversion is implemented).</simpara>
+<simpara>The general concept for checking type conformance and inferring types for generic and parameterized types is described in [<link linkend="Igarashi01a">Igarashi01a</link>] for <emphasis>Featherweight Java with Generics</emphasis>.</simpara>
+<simpara>The concept of existential types with wildcard capture (a special kind of existential type) is published in [<link linkend="Torgersen05a">Torgersen05a</link>], further developed in [<link linkend="Cameron08b">Cameron08b</link>] (further developed in  [<link linkend="Cameron09a">Cameron09a</link>] [<link linkend="Summers10a">Summers10a</link>], also see [<link linkend="Wehr08a">Wehr08a</link>] for a similar approach).
+The key feature of the Java generic wildcard handling is called capture conversion, described in [<link linkend="Gosling12a">Gosling12a(p.S5.1.10)</link>].
+However, there are some slight differences to Java 6 and 7, only with Java 8 similar results can be expected.
+All these papers include formal proofs of certain aspects, however even these paper lack proof of other aspect</simpara>
+<simpara>The idea is quite simple: All unbound wildcards are replaced with freshly created new types <footnote><simpara>in the Java 8 spec and compiler, they are called type variables, which are types as well</simpara></footnote>,
+fulfilling the constraints defined by the wildcard’s upper and lower bound.
+These newly created types are then handled similar to real types during type inference and type conformance validation.</simpara>
+<example>
+<title>Existential Type</title>
+<simpara>The inferred type of a variable
+declared as</simpara>
+<simpara><literal>var x: G&lt;? extends A&gt;;</literal>,</simpara>
+<simpara>that is the parameterized type, is an existential type <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>E</mi><mn>1</mn></msub></math>, which is a subtype of A.
+If you have another variable declared as</simpara>
+<simpara><literal>var y: G&lt;? extends A&gt;;</literal></simpara>
+<simpara>another type <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>E</mi><mn>2</mn></msub></math> is created, which is also a subtype of A.
+Note that <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>E</mi><mn>1</mn></msub><mo>≠</mo><msub><mi>E</mi><mn>2</mn></msub></math>! Assuming typical setter or getter in G, e.g. <literal>set(T t)</literal> and <literal>T get()</literal>, the following code snippet will produce an error:</simpara>
+<simpara><literal>y.set(x.get())</literal></simpara>
+<simpara>This is no surprise, as <literal>x.get()</literal> actually returns a type <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>E</mi><mn>1</mn></msub></math>, which is not a subtype of <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>E</mi><mn>2</mn></msub></math>.</simpara>
+</example>
+<simpara>The upper and lower bound declarations are, of course, still available during type inference for these existential types.
+This enables the type inferencer to calculate the join and meet of parameterized types as well.</simpara>
+<requirement xml:id="IDE-12">
+<title>Join of Parameterized Types</title>
+<simpara>
+<anchor xml:id="Req-IDE-12" xreflabel="[Req-IDE-12]"/>
+<emphasis role="strong">Requirement: IDE-12:</emphasis>
+<link linkend="Req-IDE-12">Join of Parameterized Types</link> (ver. 1)</simpara>
+    <simpara>
+
+The join of two parameterized types <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>G</mi><mo>&lt;</mo><msub><mi>T</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>T</mi><mi>n</mi></msub><mo>&gt;</mo></math> and <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>H</mi><mo>&lt;</mo><msub><mi>S</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>S</mi><mi>m</mi></msub><mo>&gt;</mo></math> is the join of the raw types, this join is then parameterized with the join of the
+upper bounds of of type arguments and the meet of the lower bounds of the type arguments.</simpara>
+<simpara>For all type rules, we assume that the upper and lower bounds of a non-generic type, including type variables,
+simply equal the type itself, that is for a given type <emphasis>T</emphasis>, the following constraints hold:<?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>u</mi><mi>p</mi><mi>p</mi><mi>e</mi><mi>r</mi><mfenced close=")" open="("><mi>T</mi></mfenced><mo>=</mo><mi>l</mi><mi>o</mi><mi>w</mi><mi>e</mi><mi>r</mi><mfenced close=")" open="("><mi>T</mi></mfenced><mo>=</mo><mi>T</mi></math></simpara>
+</requirement>
+<example>
+<title>Upper and lower bound of parameterized types</title>
+<simpara>Assuming the given classes listed above, the following upper and lower bounds are expected:</simpara>
+<programlisting language="xtext" linenumbering="unnumbered">G&lt;A&gt;            -&gt; upperBound = lowerBound = A
+G&lt;? extends A&gt;  -&gt; lowerBound = null, upperBound = A
+G&lt;? super A&gt;    -&gt; lowerBound = A, upperBound = any
+G&lt;?&gt;            -&gt; lowerBound = null, upperBound = any</programlisting>
+<simpara>This leads to the following expected subtype relations:</simpara>
+<programlisting language="xtext" linenumbering="unnumbered">(? extends A) &lt;: A  -&gt; true
+(? super A) &lt;: A    -&gt; false
+A &lt;: (? extends A)  -&gt; false
+A &lt;: (? super A)    -&gt; true</programlisting>
+</example>
+<simpara>Note that there is a slight difference to Java: In N4JS it is not possible to use a generic type in a raw fashion, that is to say without specifying any type arguments.
+In Java, this is possible due to backwards compatibility with early Java versions in which no generics were supported.</simpara>
+<simpara>In case an upper bound of a type variable shall consist only of a few members, it seems convenient to use additional structural members,
+like on interface I2 in the example <xref linkend="ex:use-declared-interfaces-for-lower-bounds"/> below.
+However, type variables must not be constrained using structural types (see constraint <xref linkend="Req-IDE-76"/>).
+Hence, the recommended solution is to use an explicitly declared interface that uses definition site structural typing for these constraints as an upper bound (see interface in <xref linkend="ex:use-declared-interfaces-for-lower-bounds"/>).</simpara>
+<example xml:id="ex:use-declared-interfaces-for-lower-bounds">
+<title>Use declared interfaces for lower bounds</title>
+<programlisting language="n4js" linenumbering="unnumbered">interface I1&lt;T extends any with {prop : int}&gt; { // error
+}
+
+interface ~J {
+    prop : int;
+}
+interface I2&lt;T extends J&gt; {
+}</programlisting>
+</example>
+</section>
+</section>
+<section xml:id="_primitive-ecmascript-types" role="language-n4js">
+<title>Primitive ECMAScript Types</title>
+<simpara>N4JS provides the same basic types as ECMAScript [<link linkend="ECMA11a">ECMA11a(p.p.28)</link>].</simpara>
+<note>
+<simpara>In ECMAScript, basic types come in two flavors: as primitive types [<link linkend="ECMA11a">ECMA11a(p.S8Types, p.p.28)</link>] and as Objects [<link linkend="ECMA11a">ECMA11a(p.S15, p.p.102)</link>].
+In N4JS, primitive types are written with lower cases, object types with first case capitalized.
+For example, <literal>String</literal> is the primitive ECMAScript string type, while <literal>String</literal> is an object.</simpara>
+</note>
+<simpara>The following ECMAScript primitive types are supported, they are written
+with lower case letters::</simpara>
+<itemizedlist>
+<listitem>
+<simpara><literal>undefined</literal>: [<link linkend="ECMA11a">ECMA11a(p.S8.3)</link>]; cannot be used in type expression, see void below.</simpara>
+</listitem>
+<listitem>
+<simpara><literal>null</literal> [<link linkend="ECMA11a">ECMA11a(p.S8.3)</link>]; cannot be used in type expression</simpara>
+</listitem>
+<listitem>
+<simpara><literal>boolean</literal>  [<link linkend="ECMA11a">ECMA11a(p.S8.3)</link>]</simpara>
+</listitem>
+<listitem>
+<simpara><literal>string</literal> [<link linkend="ECMA11a">ECMA11a(p.S8.4)</link>]</simpara>
+</listitem>
+<listitem>
+<simpara><literal>number</literal> [<link linkend="ECMA11a">ECMA11a(p.S8.5)</link>]</simpara>
+</listitem>
+</itemizedlist>
+<simpara>Although Object is a primitive type in [<link linkend="ECMA11a">ECMA11a(p.S8.5)</link>], it is interpreted here as an object type and described in <xref linkend="_object-type"/>.</simpara>
+<simpara>Please note that primitive types are values (= no objects) so they have no properties and you cannot inherit from them.</simpara>
+<section xml:id="_undefined-type">
+<title>Undefined Type</title>
+<simpara>As a built-in type, the type <literal>undefined</literal> cannot be declared explicitly by the user by means of a type expression.
+Note in ECMAScript there are three distinct use cases of <literal>undefined</literal>:</simpara>
+<itemizedlist>
+<listitem>
+<simpara><literal>undefined</literal> as type (as used here)</simpara>
+</listitem>
+<listitem>
+<simpara><literal>undefined</literal> as value (the only value of the undefined type)</simpara>
+</listitem>
+<listitem>
+<simpara><literal>undefined</literal> is a property of the global object with undefined (value) as initial value.
+Since ECMAScript 5 it is not allowed to reassign this property but this is not enforced by all ECMAScript/JavaScript engines.</simpara>
+</listitem>
+</itemizedlist>
+<simpara>The type <literal>undefined</literal> will be inferred to false in a boolean expression.
+It is important to note that something that is not assigned to a value is <literal>undefined</literal> but not <literal>null</literal>.</simpara>
+<simpara>The type <literal>undefined</literal> is a subtype of all types. That is,</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow/><mrow><mi>Γ</mi><mo>⊢</mo><mstyle mathvariant="monospace"><mtext>undefined</mtext></mstyle><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>T</mi></mrow></mfrac></math>
+<simpara>is an axiom and true for all types <emphasis>T</emphasis>.</simpara>
+<simpara>Whenever an expression <emphasis>E</emphasis> has an inferred type of <literal>undefined</literal>, which means it will always evaluate to
+value <literal>undefined</literal> at runtime, a warning is shown, unless <emphasis>E</emphasis> is &#8230;&#8203;</simpara>
+<itemizedlist>
+<listitem>
+<simpara>a <literal>void</literal> expression</simpara>
+</listitem>
+<listitem>
+<simpara>the direct child expression of a <literal>void</literal> expression,</simpara>
+</listitem>
+<listitem>
+<simpara>the direct child expression of an expression statement,</simpara>
+</listitem>
+<listitem>
+<simpara>the <literal>undefined</literal> literal (i.e. the literal representing the <literal>undefined</literal> value),</simpara>
+</listitem>
+<listitem>
+<simpara>the <literal>this</literal> literal.</simpara>
+</listitem>
+</itemizedlist>
+</section>
+<section xml:id="_null-type">
+<title>Null Type</title>
+<simpara>The <literal>null</literal> type cannot be declared explicitly by the user. Only the keyword <literal>null</literal> is inferred to type <literal>null</literal>.</simpara>
+<bridgehead xml:id="null-type-semantics" renderas="sect4">Semantics</bridgehead>
+<simpara>In contrast to <literal>undefined</literal>, it expresses the intentional absence of a value.</simpara>
+<simpara>The <literal>null</literal> type can be assigned to any other type.
+That is, the type <literal>null</literal> is a subtype of all other types except <literal>undefined</literal>:</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><mi>r</mi><mi>i</mi><mi>g</mi><mi>h</mi><mi>t</mi><mo>≠</mo><mstyle mathvariant="monospace"><mtext>undefined</mtext></mstyle></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mstyle mathvariant="monospace"><mtext>null</mtext></mstyle><mi> </mi><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mstyle mathvariant="monospace"><mtext>Type</mtext></mstyle><mi>r</mi><mi>i</mi><mi>g</mi><mi>h</mi><mi>t</mi></mrow></mfrac></math>
+<simpara>Please note that</simpara>
+<itemizedlist>
+<listitem>
+<simpara><literal>null==undefined</literal> evaluates to <literal>true</literal></simpara>
+</listitem>
+<listitem>
+<simpara><literal>null===undefined</literal> evaluates to <literal>false</literal></simpara>
+</listitem>
+<listitem>
+<simpara><literal>typeof null</literal> evaluates to <literal>object</literal></simpara>
+</listitem>
+</itemizedlist>
+<simpara>Only the <literal>null</literal> keyword is inferred to type null. If <literal>null</literal> is assigned to a variable, the type of the variable is not changed.
+This is true, in particular, for variable declarations.
+For example in</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">var x = null;</programlisting>
+<simpara>the type of variable <literal>x</literal> is inferred to <literal>any</literal> (cf. <xref linkend="_variable-statement"/>).</simpara>
+<simpara>The type <literal>null</literal> will be inferred to false in a boolean expression.</simpara>
+<simpara>The call <literal>typeof null</literal> will return ’object’.</simpara>
+</section>
+<section xml:id="_primitive-boolean-type">
+<title>Primitive Boolean Type</title>
+<simpara>Represents a logical entity having two values, true and false.</simpara>
+<simpara>Please note that a boolean primitive is coerced to a number in a comparison operation so that</simpara>
+<informaltable frame="all" rowsep="1" colsep="1">
+<tgroup cols="2">
+<colspec colname="col_1" colwidth="66.6666*"/>
+<colspec colname="col_2" colwidth="33.3334*"/>
+<thead>
+<row>
+<entry align="center" valign="top">Source</entry>
+<entry align="center" valign="middle">Result</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry align="left" valign="top"><programlisting language="n4js" linenumbering="unnumbered">var a = true; console.log(a == 1)</programlisting></entry>
+<entry align="center" valign="middle"><simpara><emphasis role="strong">prints true</emphasis></simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><programlisting language="n4js" linenumbering="unnumbered">var b = false; console.log(b == 0)</programlisting></entry>
+<entry align="center" valign="middle"><simpara><emphasis role="strong">prints true</emphasis></simpara></entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+<bridgehead xml:id="primitive-boolean-type-semantics" renderas="sect4">Semantics</bridgehead>
+<simpara>The type <literal>boolean</literal> is subtype of <literal>any</literal>:</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow/><mrow><mstyle mathvariant="monospace"><mtext>boolean</mtext></mstyle><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mstyle mathvariant="monospace"><mtext>any</mtext></mstyle></mrow></mfrac><mrow/></math>
+<simpara>Variables of type <literal>boolean</literal> can be auto-converted (coerced) to <literal>Boolean</literal>, as described in <xref linkend="_autoboxing-and-coercing"/>.</simpara>
+</section>
+<section xml:id="_primitive-string-type">
+<title>Primitive String Type</title>
+<simpara>A finite sequence of zero or more 16-bit unsigned integer values (elements).
+Each element is considered to be a single UTF-16 code unit.</simpara>
+<simpara>Also string as primitive type has no properties, you can access the properties available on the object String as string will be coerced to String on the fly
+but just for that property call, the original variable keeps its type:</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">var a = "MyString"
+console.log(typeof a) // string
+console.log(a.length) // 8
+console.log(typeof a) // string</programlisting>
+<simpara>You can handle a primitive <literal>string</literal> like an object type <literal>String</literal> but with these exceptions:</simpara>
+<itemizedlist>
+<listitem>
+<simpara><literal>typeof "MyString"</literal> is <literal>'string'</literal> but <literal>typeof new String("MyString")</literal> is <literal>'object'</literal></simpara>
+</listitem>
+<listitem>
+<simpara><literal>"MyString" instanceof String</literal> or <literal>instanceof Object</literal> will return <literal>false</literal>, for <literal>new String("MyString")</literal> both checks evaluate to <literal>true</literal></simpara>
+</listitem>
+<listitem>
+<simpara><literal>console.log(eval("2+2"))</literal> returns <literal>4</literal>, <literal>console.log(eval(new String("2+2")))</literal> returns string <literal>"2+2"</literal></simpara>
+</listitem>
+</itemizedlist>
+<simpara>This marks a difference to Java.
+In JavaScript, Unicode escape sequences are never interpreted as a special character.</simpara>
+<bridgehead xml:id="primitive-string-type-semantics" renderas="sect4">Semantics</bridgehead>
+<simpara>The <literal>string</literal> type is a subtype of <literal>any</literal>:</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow/><mrow><mstyle mathvariant="monospace"><mtext>string</mtext></mstyle><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mstyle mathvariant="monospace"><mtext>any</mtext></mstyle></mrow></mfrac><mrow/></math>
+<simpara>It is supertype of the N4JS primitive type <literal>pathselector</literal>, <literal>typeName</literal> and <literal>i18nKey</literal>.
+<xref linkend="_primitive-pathselector-and-i18nkey"/></simpara>
+<simpara>However, variables of type <literal>string</literal> can be auto-converted (coerced) to <literal>string</literal>, as described in <xref linkend="_autoboxing-and-coercing"/>.</simpara>
+</section>
+<section xml:id="_primitive-number-type">
+<title>Primitive Number Type</title>
+<simpara>In ECMAScript numbers are usually 64-bit floating point numbers.
+For details see [<link linkend="ECMA11a">ECMA11a(p.8.5)</link>].
+The prefix <literal>0</literal> indicates that the number is octal-based and the prefix <literal>0x</literal> marks it as hexadecimal-based.</simpara>
+<simpara><literal>NaN</literal> can be produced by e.g. &#8216;0 / 0&#8217;' or &#8216;1 - x&#8217;. <literal>typeof NaN</literal> will return <literal>number</literal>.</simpara>
+<bridgehead xml:id="primitive-number-type-semantics" renderas="sect4">Semantics</bridgehead>
+<simpara>The type <literal>number</literal> is subtype of <literal>any</literal>:</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow/><mrow><mstyle mathvariant="monospace"><mtext>number</mtext></mstyle><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mstyle mathvariant="monospace"><mtext>any</mtext></mstyle></mrow></mfrac><mrow/></math>
+<simpara>However, variables of type <literal>number</literal> can be auto-converted (coerced) to <literal>Number</literal>, as described in <link linkend="_integer-literals">Integer Literals</link> .</simpara>
+</section>
+<section xml:id="_primitive-type-int">
+<title>Primitive Type int</title>
+<simpara>Actually ECMAScript defines an internal type <literal>int32</literal>.
+A number of this type is returned by the binary or operation using zero as operand, e.g. ECMAScript’s internal type int32 can be represented in N4JS by a built-in primitive type called <literal>int</literal>.
+For details on how numeric literals map to types <literal>number</literal> and <literal>int</literal>, refer to <xref linkend="_integer-literals"/>.</simpara>
+<important>
+<simpara>for the time being, built-in type <literal>int</literal> is synonymous to type <literal>number</literal>.
+This means one can be assigned to the other and a value declared to be of type <literal>int</literal> may actually be a 64-bit floating
+point number.<footnote><simpara>The rationale for having this limited implementation of type is that API designers already want to start providing hints where later only 32-bit integers will be used. For the time being, <emphasis role="strong">this is checked neither statically nor at runtime</emphasis>!</simpara></footnote></simpara>
+</important>
+</section>
+<section xml:id="_primitive-symbol-type">
+<title>Primitive Symbol Type</title>
+<simpara>The primitive type <literal>symbol</literal> is directly as in ECMAScript 6.
+Support for symbols is kept to a minimum in N4JS. While this primitive type can be used without any restrictions, the only value of this type available in N4JS is the built-in symbol <literal>Symbol.iterator</literal>.
+Other built-in symbols from ECMAScript 6 and the creation of new symbols are not supported.
+For more details, see <xref linkend="_symbol"/>.</simpara>
+</section>
+</section>
+<section xml:id="_primitive-n4js-types" role="language-n4js">
+<title>Primitive N4JS Types</title>
+<simpara>Additionally to the primitive ECMAScript types, the following N4JS-specific primitive types are supported:</simpara>
+<variablelist>
+<varlistentry>
+<term><literal>any</literal></term>
+<listitem>
+<simpara>enables ECMAScript-like untyped variable declarations</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>void</literal></term>
+<listitem>
+<simpara>almost similar to undefined, except it can be used as a return type of functions and methods</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>unknown</literal></term>
+<listitem>
+<simpara>inferred in case of a type inference error</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>pathSelector&lt;T&gt;</literal>, <literal>i18nKey</literal></term>
+<listitem>
+<simpara>subtypes of string</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+<section xml:id="_any-type">
+<title>Any Type</title>
+<simpara>Any type is the default type of all variables for without a type declaration.
+It has no properties.
+A value of any other type can be assigned to a variable of type <literal>any</literal>, but a variable declared <literal>any</literal> can only be assigned to another variable declared with the type <literal>any</literal>.</simpara>
+<section xml:id="any-type-semantics">
+<title>Semantics</title>
+<simpara><literal>any</literal> is supertype of all other types. That is,</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow/><mrow><mi>Γ</mi><mo>⊢</mo><mstyle mathvariant="monospace"><mtext>Type</mtext></mstyle><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mrow><mi>a</mi><mi>n</mi><mi>y</mi></mrow></mrow></mfrac></math>
+<simpara>is an axiom and true for all types.</simpara>
+</section>
+<section xml:id="any-type-type-inference">
+<title>Type Inference</title>
+<simpara>If a variable is explicitly declared as type <literal>any</literal>, the inferred type of that variable will always be <literal>any</literal>.</simpara>
+<section xml:id="_default-type-of-variables">
+<title>Default Type of Variables</title>
+<simpara>If a type annotation is missing and no initializer is provided, then the type of a variable is implicitly set to <literal>any</literal>.</simpara>
+<simpara>In that case, the inferred type of that variable will always be <literal>any</literal> as well.
+If an initializer is provided, the declared type of the variable will be set to the inferred type of the initializer.
+Therefore in the latter case, the inferred type of the variable will always be the type of the initializer (cf. <xref linkend="_variable-statement"/>).</simpara>
+<simpara>If a variable is declared as type , it can be used just as every variable can be used in raw ECMAScript.
+Since every property can be get and set, the types of properties is inferred as as well.
+This is formally expressed in <xref linkend="_identifier"/>.</simpara>
+</section>
+</section>
+</section>
+<section xml:id="_void-type">
+<title>Void Type</title>
+<simpara>The type <literal>void</literal> is used to denote that there is no value at all, as opposed to type
+<literal>undefined</literal> which denotes that there is a value, but it is always undefined.</simpara>
+<simpara>The only valid use of type <literal>void</literal> is to declare that a function or method does not
+return anything. In particular, this means:</simpara>
+<itemizedlist>
+<listitem>
+<simpara><literal>void</literal> is disallowed as type argument,</simpara>
+</listitem>
+<listitem>
+<simpara><literal>void</literal> is disallowed as upper/lower bound of type parameters and wild cards,</simpara>
+</listitem>
+<listitem>
+<simpara>when used as return type of functions or methods, <literal>void</literal> may not be nested, i.e.</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">function foo(): void {}  // ok
+function bar(): any|void {}  // error</programlisting>
+</listitem>
+</itemizedlist>
+<simpara>In all the above disallowed cases, type <literal>undefined</literal> should be used instead of <literal>void</literal>.</simpara>
+<section xml:id="void-type-semantics">
+<title>Semantics</title>
+<requirement xml:id="IDE-13">
+<title>Void Type</title>
+<simpara>
+<anchor xml:id="Req-IDE-13" xreflabel="[Req-IDE-13]"/>
+<emphasis role="strong">Requirement: IDE-13:</emphasis>
+<link linkend="Req-IDE-13">Void Type</link> (ver. 1)</simpara>
+    <simpara>
+
+* The type <literal>void</literal> may only be used as the immediate return type of a function or method.</simpara>
+<itemizedlist>
+<listitem>
+<simpara>If a function <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>f</mi></math> is declared to return <literal>void</literal>, an error is created if a return statement contains an expression:</simpara>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>f</mi><mo>.</mo><mi>r</mi><mi>e</mi><mi>t</mi><mi>u</mi><mi>r</mi><mi>n</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>void</mtext></mstyle><mo>→</mo></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∀</mo><mi>r</mi><mo>,</mo><mi>μ</mi><mfenced close=")" open="("><mi>r</mi></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>ReturnStatement</mtext></mstyle><mo>,</mo><mi>r</mi><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>t</mi><mi>a</mi><mi>i</mi><mi>n</mi><mi>i</mi><mi>n</mi><mi>g</mi><mi>F</mi><mi>u</mi><mi>n</mi><mi>c</mi><mi>t</mi><mi>i</mi><mi>o</mi><mi>n</mi><mo>=</mo><mi>f</mi><mi>:</mi><mi>r</mi><mo>.</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>e</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>o</mi><mi>n</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>null</mtext></mstyle></math></simpara>
+</listitem>
+<listitem>
+<simpara>If a function <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>f</mi></math> is declared to return <literal>void</literal>, an error is issued if the function is called in any statement or expression but an expression statement directly:</simpara>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>f</mi><mo>.</mo><mi>r</mi><mi>e</mi><mi>t</mi><mi>u</mi><mi>r</mi><mi>n</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>void</mtext></mstyle><mo>→</mo></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∀</mo><mi>e</mi><mo>,</mo><mi>b</mi><mi>i</mi><mi>n</mi><mi>d</mi><mfenced close=")" open="("><mi>e</mi><mi>f</mi></mfenced><mi>:</mi><mi>μ</mi><mfenced close=")" open="("><mrow><mi>e</mi><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>t</mi><mi>a</mi><mi>i</mi><mi>n</mi><mi>e</mi><mi>r</mi></mrow></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>ExpressionStatement</mtext></mstyle></math></simpara>
+</listitem>
+</itemizedlist>
+</requirement>
+<simpara>The following type hierarchy is defined: <literal>void</literal> is only a subtype of itself but not of any other type and no other type is a subtype of void.</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow/><mrow><mstyle mathvariant="monospace"><mtext>void</mtext></mstyle><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mstyle mathvariant="monospace"><mtext>void</mtext></mstyle></mrow></mfrac></math>
+<simpara>Since <literal>void</literal> cannot be used as the type of variables, fields, formal parameters, etc., a
+function or method with a return type of void cannot be used on the right-hand side of
+an assignment or in the argument list of a call expression (note the difference to plain
+JavaScript).</simpara>
+<simpara>The ECMAScript <literal>void</literal> operator (see <link linkend="_unary-expression">Unary Expressions</link>) has a type
+of <literal>undefined</literal>, not <literal>void</literal>, because it evaluates to value <literal>undefined</literal> and can be used
+on the right-hand side of assignments, etc.</simpara>
+</section>
+</section>
+<section xml:id="_unknown-type">
+<title>Unknown Type</title>
+<simpara>Internally N4JS defines the type <literal>unknown</literal>.
+This type cannot be used by the user.
+Instead, it is inferred in case of errors.
+<literal>unknown</literal> behaves almost similar to <literal>any+</literal>.
+However no error messages once a variable or expression has been inferred to <literal>unknown</literal> in order to avoid consequential errors.</simpara>
+</section>
+<section xml:id="_primitive-pathselector-and-i18nkey">
+<title>Primitive Pathselector and I18nKey</title>
+<simpara>N4JS introduces three new types which are subtypes of string.
+These types are, in fact, translated to strings and do not add any new functionality.
+They are solely defined for enabling additional validation.</simpara>
+<itemizedlist>
+<listitem>
+<simpara><literal>pathSelector&lt;T&gt;</literal> is a generic type for specifying path selector expressions. PathSelectors are used to specify a path to a property in a (JSON-like) model tree.</simpara>
+</listitem>
+<listitem>
+<simpara>The type variable <literal>T</literal> defines the context type (or type of the root of the tree) in which the selector is to be validated.
+A path selector is defined as a string literal that has to conform to the path selector grammar.
+The context type is then used to perform a semantic</simpara>
+</listitem>
+<listitem>
+<simpara><literal>i18nKey</literal> is a string which refers to an internationalization key.
+The <literal>i18nKey</literal> type is used to reference resource keys specified in resource files.
+In a project <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>p</mi></math>, the <literal>i18nKey</literal> type defines the transitive set of all resource keys accessible from <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>p</mi></math>.
+Since resource keys are specified as strings, this means that the <literal>i18nKey</literal> type defines a subset of all string literals that can be assigned to a variable of type <literal>i18nKey</literal> in the current project.
+That means that an assignment of a string literal to a variable of type <literal>i18nKey</literal> is only valid if that string literal is contained in the set defined by <literal>i18nKey</literal>.
+Resource keys are declared in the properties files of a project and all resource keys from a project are accessible to any project depending on it.</simpara>
+</listitem>
+</itemizedlist>
+<simpara role="todo">I18nkeys are not yet validated</simpara>
+<section xml:id="pathselector-semantics">
+<title>Semantics</title>
+<simpara>The N4JS primitive types <literal>pathSelector&lt;T&gt;</literal>, <literal>i18nKey</literal> and <literal>pathSelector&lt;T&gt;</literal> are basically only marker types of strings for enabling additional validation.
+Thus, they are completely interchangeable with string types:</simpara>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mfrac><mrow/><mrow><mstyle mathvariant="monospace"><mtext>typeName</mtext></mstyle><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>T</mtext></mstyle><mo>&gt;</mo><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mstyle mathvariant="monospace"><mtext>string</mtext></mstyle></mrow></mfrac><mspace width="3.0mm"/><mfrac><mrow/><mrow><mstyle mathvariant="monospace"><mtext>string</mtext></mstyle><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mstyle mathvariant="monospace"><mtext>typeName</mtext></mstyle><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>T</mtext></mstyle><mo>&gt;</mo></mrow></mfrac></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mfrac><mrow/><mrow><mstyle mathvariant="monospace"><mtext>i18nKey</mtext></mstyle><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mstyle mathvariant="monospace"><mtext>string</mtext></mstyle></mrow></mfrac><mspace width="3.0mm"/><mfrac><mrow/><mrow><mstyle mathvariant="monospace"><mtext>string</mtext></mstyle><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mstyle mathvariant="monospace"><mtext>i18nKey</mtext></mstyle></mrow></mfrac></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mfrac><mrow/><mrow><mstyle mathvariant="monospace"><mtext>pathSelector</mtext></mstyle><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>T</mtext></mstyle><mo>&gt;</mo><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mstyle mathvariant="monospace"><mtext>string</mtext></mstyle></mrow></mfrac><mspace width="3.0mm"/><mfrac><mrow/><mrow><mstyle mathvariant="monospace"><mtext>string</mtext></mstyle><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mstyle mathvariant="monospace"><mtext>pathSelector</mtext></mstyle><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>T</mtext></mstyle><mo>&gt;</mo></mrow></mfrac></math></simpara>
+<simpara>As special literals for these N4JS types do not exist, the type has to be explicitly specified in order to enable the additional validation.
+Note that this validation cannot be applied for more complicated expressions with parts which cannot be evaluated at compile time.
+For example, <literal>"some.path."segment".prop"</literal> cannot be evaluated at compile time.</simpara>
+</section>
+</section>
+</section>
+<section xml:id="_built-in-ecmascript-object-types" role="language-n4js">
+<title>Built-in ECMAScript Object Types</title>
+<simpara>N4JS supports all built-in ECMAScript objects [<link linkend="ECMA11a">ECMA11a(p.S15)</link>], interpreted as classes.
+Some of these object types are object versions of primitive types.
+The object types have the same name as their corresponding primitive type, but start with an upper case letter.</simpara>
+<simpara>The following types, derived from certain ECMAScript predefined objects and constructs, are supported by means of built-in types as they are required by certain expressions.</simpara>
+<itemizedlist>
+<listitem>
+<simpara><literal>Object</literal>   [<link linkend="ECMA11a">ECMA11a(p.p.111)</link>];</simpara>
+</listitem>
+<listitem>
+<simpara><literal>Function</literal>  [<link linkend="ECMA11a">ECMA11a(p.p.117)</link>]; representing functions and function objects <xref linkend="_function-type"/> but also methods (<xref linkend="_methods"/>)</simpara>
+</listitem>
+<listitem>
+<simpara><literal>Array</literal>    [<link linkend="ECMA11a">ECMA11a(p.p.122)</link>], representing array objects, see <xref linkend="_array-object-type"/></simpara>
+</listitem>
+<listitem>
+<simpara><literal>String</literal> [<link linkend="ECMA11a">ECMA11a(p.p.141)</link>]</simpara>
+</listitem>
+<listitem>
+<simpara><literal>Boolean</literal> [<link linkend="ECMA11a">ECMA11a(p.p.141)</link>]</simpara>
+</listitem>
+<listitem>
+<simpara><literal>Number</literal> [<link linkend="ECMA11a">ECMA11a(p.p.141)</link>]</simpara>
+</listitem>
+<listitem>
+<simpara><literal>RegExp</literal> [<link linkend="ECMA11a">ECMA11a(p.p.180)</link>]; they can be constructed by means of special literals (cf. <xref linkend="_literals"/>)</simpara>
+</listitem>
+<listitem>
+<simpara>global object type</simpara>
+</listitem>
+<listitem>
+<simpara><literal>Symbol</literal></simpara>
+</listitem>
+<listitem>
+<simpara><literal>Promise</literal></simpara>
+</listitem>
+<listitem>
+<simpara><literal>Iterator</literal> and <literal>Iterable</literal></simpara>
+</listitem>
+</itemizedlist>
+<simpara>All other ECMAScript types ([<link linkend="ECMA11a">ECMA11a(p.S15)</link>], such as <literal>Math</literal>, <literal>Date</literal>, or <literal>Error</literal> are supported by means of predefined classes.
+ECMAScript 2015 types are defined in the ECMAScript 2015 runtime environment.
+Since they are defined and used similar to user defined classes, they are not explained in further detail here.
+These predefined objects are kind of subtypes of <literal>Object</literal>.</simpara>
+<section xml:id="ECMAScript-objects-semantics">
+<title>Semantics</title>
+<simpara>It is not possible to inherit from any of the built-in ECMAScript object types except for <literal>Object</literal> and <literal>Error</literal>, that is,
+to use one of these types as supertype of a class.
+From the N4JS language’s point of view, these built-in types are all final.</simpara>
+</section>
+<section xml:id="_object-type">
+<title>Object Type</title>
+<simpara><literal>Object</literal> [<link linkend="ECMA11a">ECMA11a(p.S8.6)</link>] is the (implicit) supertype of all declared (i.e., non-primtive) types, including native types.
+It models the ECMAScript type <literal>Object</literal>, except that no properties may be dynamically added to it.
+In order to declare a variable to which properties can be dynamically added, the type <literal>Object+</literal> has to be declared
+(cf. <xref linkend="_type-modifiers"/>).</simpara>
+</section>
+<section xml:id="_function-object-type">
+<title>Function-Object-Type</title>
+<simpara>The built-in object type <literal>Function</literal>, a subtype of <literal>Object</literal>, represents all functions, regardless of how they are defined (either via function expression,
+function declaration, or method declaration).
+They are described in detail in <xref linkend="_function-object-type"/>.</simpara>
+<simpara>Since <literal>Function</literal> is the supertype of all functions regardless of number and types of formal parameters, return type, and number and bounds of type parameters,
+it would not normally be possible to invoke an instance of <literal>Function</literal>.
+For the time being, however, an instance of <literal>Function</literal> can be invoked, any number of arguments may be provided and the invocation may be parameterized with any number of
+type arguments (which will be ignored), i.e.  <xref linkend="Req-IDE-101"/> and <xref linkend="Req-IDE-102"/> do not apply.</simpara>
+</section>
+<section xml:id="_array-object-type">
+<title>Array Object Type</title>
+<simpara>The <literal>Array</literal> type is generic with one type parameter, which is the item type. An array is accessed with the index operator, the type of the index parameter is <literal>Number</literal>.
+The type of the stored values is <emphasis>typeArgs[0]</emphasis> (cf. <xref linkend="_array-literal"/>). Due to type erasure, the item type is not available during runtime,
+that is to say there are no reflective methods returning the item type of an array.</simpara>
+<requirement xml:id="IDE-14">
+<title>Array Type</title>
+<simpara>
+<anchor xml:id="Req-IDE-14" xreflabel="[Req-IDE-14]"/>
+<emphasis role="strong">Requirement: IDE-14:</emphasis>
+<link linkend="Req-IDE-14">Array Type</link> (ver. 1)</simpara>
+    <simpara>
+
+For an array type <emphasis>A</emphasis>, the following conditions must be true:</simpara>
+<itemizedlist>
+<listitem>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mo>|</mo><mi>A</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>A</mi><mi>r</mi><mi>g</mi><mi>s</mi><mo>|</mo><mo>=</mo><mn>1</mn></math></simpara>
+</listitem>
+</itemizedlist>
+</requirement>
+</section>
+<section xml:id="_string-object-type">
+<title>String Object Type</title>
+<simpara>Object type version of <literal>string</literal>. It is highly recommend to use the primitive version only.
+Note that is is not possible to assign a primitive typed value to an object typed variable.</simpara>
+</section>
+<section xml:id="_boolean-object-type">
+<title>Boolean Object Type</title>
+<simpara>Object type version of <literal>boolean</literal>. It is highly recommend to use the primitive version only.
+Note that is is not possible to assign a primitive typed value to an object typed variable.</simpara>
+</section>
+<section xml:id="_number-object-type">
+<title>Number Object Type</title>
+<simpara>Object type version of <literal>number</literal>. It is highly recommend to use the primitive version only.
+Note that is is not possible to assign a primitive typed value to an object typed variable.</simpara>
+</section>
+<section xml:id="_global-object-type">
+<title>Global Object Type</title>
+<simpara>This is the globally accessible namespace which contains element such as undefined, and in case of browsers, window. Depending on the runtime environment,
+the global object may has different properties defined by means of dynamic polyfills.</simpara>
+</section>
+<section xml:id="_symbol">
+<title>Symbol</title>
+<simpara>The symbol constructor function of ECMAScript 2015. Support for symbols
+is kept to a minimum in N4JS:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>creating symbols with <literal>var sym = Symbol("description")</literal> is not supported.</simpara>
+</listitem>
+<listitem>
+<simpara>creating shared symbols with <literal>var sym = Symbol.for("key")</literal> is not supported.
+Also the inverse <literal>Symbol.keyFor(sym)</literal> is not supported.</simpara>
+</listitem>
+<listitem>
+<simpara>retrieving built-in symbols via properties in <literal>Symbol</literal> is supported, however, the only built-in symbol available in N4JS is the iterator symbol that can be retrieved with <literal>Symbol.iterator</literal>.</simpara>
+</listitem>
+</itemizedlist>
+<simpara>The rationale for this selective support for symbols in N4JS is to allow for the use (and custom definition) of iterators and iterables and their application in the <literal>for&#8230;&#8203;of</literal>
+loop with as little support for symbols as possible.</simpara>
+</section>
+<section xml:id="_promise">
+<title>Promise</title>
+<simpara><literal>Promise</literal> is provided as a built-in type as in ECMAScript 2015.
+Also see <xref linkend="_asynchronous-functions"/> for asynchronous functions.</simpara>
+</section>
+<section xml:id="_iterator-interface">
+<title>Iterator Interface</title>
+<simpara>A structurally typed interface for <emphasis>iterators</emphasis> as defined by theECMAScript 6 iterator protocol.</simpara>
+<formalpara>
+<title>Iterable in N4JS</title>
+<para>
+<programlisting language="n4js" linenumbering="unnumbered">// providedByRuntime
+export public interface ~Iterator&lt;T&gt;  {
+    public next(): IteratorEntry&lt;T&gt;
+}
+
+// providedByRuntime
+export public interface ~IteratorEntry&lt;T&gt; {
+    public done: boolean;
+    public value: T?;
+}</programlisting>
+</para>
+</formalpara>
+<simpara role="todo">Interface <literal>IteratorEntry</literal> was introduced mainly as a workaround; this interface could be removed and replaced with a corresponding
+structural type reference as return type of method <literal>next()</literal></simpara>
+</section>
+<section xml:id="_iterable-interface">
+<title>Iterable Interface</title>
+<simpara>A structurally typed interface for objects that can be iterated over, i.e. <emphasis>iterables</emphasis> as defined by the ECMAScript 6 iterator protocol.</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">// providedByRuntime
+export public interface ~Iterable&lt;T&gt; {
+    public [Symbol.iterator](): Iterator&lt;T&gt;
+}</programlisting>
+<simpara>Note that this interface’s method is special in that a symbol is used as identifier.
+You can use the ordinary syntax for computed property names in ECMAScript 6 for overriding / implementing or invoking this method.</simpara>
+</section>
+</section>
+<section xml:id="_built-in-n4js-types" role="language-n4js">
+<title>Built-In N4JS Types</title>
+<simpara>N4JS additionally provides some built-in classes which are always available with the need to explicitly import them.</simpara>
+<section xml:id="_n4object">
+<title>N4Object</title>
+<simpara>Although <literal>N4Object</literal> is a built-in type, it is not the default supertype.
+It is a subtype of <literal>Object</literal>.</simpara>
+<section xml:id="N4Object-semantics">
+<title>Semantics</title>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow/><mrow><mstyle mathvariant="monospace"><mtext>N4Object</mtext></mstyle><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mstyle mathvariant="monospace"><mtext>Object</mtext></mstyle></mrow></mfrac></math>
+</section>
+</section>
+<section xml:id="_n4class">
+<title>N4Class</title>
+<simpara>The type <literal>N4Class</literal> is used for extended reflection in N4JS.</simpara>
+<simpara role="todo">Add further docs for this type</simpara>
+</section>
+<section xml:id="IterableN">
+<title>IterableN</title>
+<simpara role="todo">Work in progress.</simpara>
+<simpara>Currently there are built-in types <literal>Iterable2&lt;T1,T2&gt;</literal>&#8230;&#8203;<literal>Iterable9&lt;T1,&#8230;&#8203;,T9&gt;</literal>.
+They are mainly intended for type system support of array destructuring literals.</simpara>
+<note>
+<simpara>This is not documented in detail yet, because we want to gain experience with the current solution first, major refinement may be incoming.</simpara>
+</note>
+</section>
+</section>
+<section xml:id="_type-modifiers" role="language-n4js">
+<title>Type Modifiers</title>
+<simpara>Type expressions can be further described with type modifiers.
+The type modifiers add additional constraints to the type expression which are then used to perform a stricter validation of the source code.
+Type modifiers can not be used in type arguments.</simpara>
+<simpara>The general type modifiers <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>n</mi><mi>u</mi><mi>l</mi><mi>l</mi><mi>a</mi><mi>b</mi><mi>l</mi><mi>e</mi></math>, <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>n</mi><mi>o</mi><mi>n</mi><mi>n</mi><mi>u</mi><mi>l</mi><mi>l</mi></math> and <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>d</mi><mi>y</mi><mi>n</mi><mi>a</mi><mi>m</mi><mi>i</mi><mi>c</mi></math> can be used for variables, attributes, method parameters and method types.
+Optional and variadic modifiers can only be applied for formal parameters.</simpara>
+<section xml:id="Type_Modifiers_Dynamic">
+<title>Dynamic</title>
+<simpara>The dynamic type modifier marks a type as being dynamic.
+A dynamic type behaves like a normal JavaScript object, so you can read/write any property and call any method on it.
+The default behavior for a type is to be static, that is no new properties can be added and no unknown properties can be accessed.</simpara>
+<simpara><literal>T</literal> <math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/></math> <literal>T+</literal> and <literal>T+</literal> <math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/></math> <literal>T</literal> is always true.
+Using dynamically added members of a dynamic type is never type safe.
+Using the <literal>delete</literal> operator on a subtype of <literal>N4Object</literal> is not allowed.</simpara>
+<requirement xml:id="IDE-15">
+<title>Non-Dynamic Primitive Types</title>
+<simpara>
+<anchor xml:id="Req-IDE-15" xreflabel="[Req-IDE-15]"/>
+<emphasis role="strong">Requirement: IDE-15:</emphasis>
+<link linkend="Req-IDE-15">Non-Dynamic Primitive Types</link> (ver. 1)</simpara>
+    <simpara>
+
+1.  All primitive types except <literal>any</literal> must not be declared dynamic.
+2.  Only parameterized type references and this type reference can be declared dynamic.<footnote><simpara>This is a consequence of the syntax definition.</simpara></footnote></simpara>
+</requirement>
+</section>
+<section xml:id="_optional-return-types">
+<title>Optional Return Types</title>
+<simpara>Only formal parameters and return types can be marked as optional.</simpara>
+<simpara>An optional return type indicates that the function / method need not be left via a return statement with an expression; in that case the return value is <literal>undefined</literal>.
+For constraints on using the optional modifier, see <xref linkend="_function-object-type"/>.</simpara>
+</section>
+</section>
+<section xml:id="_union-and-intersection-type-composed-types" role="language-n4js">
+<title>Union and Intersection Type (Composed Types)</title>
+<simpara>Given two or more existing types, it is possible to compose a new type by forming either the union or intersection of the base types.
+The following example gives a small overview of common use cases of union and intersection types.</simpara>
+<example>
+<title>Composed types</title>
+<simpara>This example shows how union and intersection types affect the types of their field members in case the fields have different types.
+It is for illustration purposes only.
+The type of the composed field depends on the access type:
+When reading, the field type of an intersection/union also resolves to the intersection/union.
+In contrast, when writing a field, the field type of an intersection/union resolves to the union/intersection respectively.</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">interface A { f : int = 1; }
+interface B { f : string = "h"; }
+
+class CA implements A {}
+class CB implements B {}
+
+let aub : A|B; // union type
+let aib : A&amp;B; // intersection type
+
+function u() {
+    aub = (catIsAlive)? new CA() : new CB(); // catIsAlive is boolean
+    let x = aub.f; // x = {1 | "h"}
+    aub.f = undefined; // undefined can be assigned to int and string types
+}
+function i() {
+    let a = aib as A;
+    let b = aib as B;
+    a.f = 23;
+    b.f = "text";
+    let x = aib.f; // x = {23 &amp; "text"} which is impossible
+}
+// type of 'aub.f' --&gt; int|string
+let fu = aub.f;
+// type of 'aub.f' --&gt; int&amp;string
+aub.f = undefined;
+// type of 'aib.f' --&gt; int&amp;string
+let fi = aib.f;
+// type of 'aib.f' --&gt; int|string
+aib.f = undefined;</programlisting>
+<simpara>Note that no instance <literal>aib</literal> of intersection type <literal>A&amp;B</literal> can be instantiated, since the instance&#8217;s class would have to define a field <literal>f</literal> which would have to comply to both of the interfaces <literal>A</literal> and <literal>B</literal>.
+Still the function <literal>i()</literal> shows in general how variables of intersection types can be casted and accessed.</simpara>
+</example>
+<simpara>The following sections define these <emphasis>union</emphasis> and <emphasis>intersection types</emphasis> in detail.</simpara>
+<section xml:id="_union-type">
+<title>Union Type</title>
+<simpara>Union type reflect the dynamic nature of JavaScript. Union types can be used almost everywhere (e.g., in variable declarations or in formal method parameters).
+The type inferencer usually avoids returning union types and prefers single typed joins or meets.
+<emphasis>The most common use case for union types is for emulating method overloading</emphasis>, as
+we describe later on.<footnote><simpara>For type theory about union types, [<link linkend="Pierce02a">Pierce02a(p.15.7)</link>] and [<link linkend="Igarashi07a">Igarashi07a</link>], other languages that explicitly support the notion of union type include Ceylon [<link linkend="King13a">King13a(p.3.2.4/5)</link>]</simpara></footnote></simpara>
+<section xml:id="union-type-syntax">
+<title>Syntax</title>
+<simpara>For convenience, we repeat the definition of union type expression:</simpara>
+<programlisting language="xtext" linenumbering="unnumbered">UnionTypeExpression: 'union' '{' typeRefs+=TypeRefWithoutModifiers (',' typeRefs+=TypeRefWithoutModifiers)* '}';</programlisting>
+</section>
+<section xml:id="union-type-semantics">
+<title>Semantics</title>
+<simpara>An union type states that the type of a variable may be one or more types contained in the union type.
+In other words, a union type is a kind of type set, and the type of a variable is contained in the type set.
+Due to interfaces, a variable may conform to multiple types.</simpara>
+<requirement xml:id="IDE-18">
+<title>Union Type</title>
+<simpara>
+<anchor xml:id="Req-IDE-18" xreflabel="[Req-IDE-18]"/>
+<emphasis role="strong">Requirement: IDE-18:</emphasis>
+<link linkend="Req-IDE-18">Union Type</link> (ver. 1)</simpara>
+    <simpara>
+
+For a given union type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>U</mi><mo>=</mo><mi>u</mi><mi>n</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><msub><mi>T</mi><mn>1</mn></msub><mrow><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/></mrow><msub><mi>T</mi><mi>n</mi></msub></mfenced></math>, the following conditions must hold:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>Non-empty: At least one element has to be specified:<?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>U</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mi>s</mi><mo>≠</mo><mi>∅</mi></math> (<math xmlns="http://www.w3.org/1998/Math/MathML"><mrow><mi>n</mi><mo>≥</mo><mn>1</mn><mo>)</mo></mrow></math></simpara>
+</listitem>
+<listitem>
+<simpara>Non-dynamic: The union type itself must not be declared dynamic:<?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mo>¬</mo><mi>U</mi><mo>.</mo><mi>d</mi><mi>y</mi><mi>n</mi><mi>a</mi><mi>m</mi><mi>i</mi><mi>c</mi></math></simpara>
+</listitem>
+<listitem>
+<simpara>Non-optional elements:<?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∀</mo><mi>T</mi><mo>∈</mo><mi>U</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mi>s</mi><mo>→</mo><mo>¬</mo><mi>T</mi><mo>.</mo><mi>o</mi><mi>p</mi><mi>t</mi></math></simpara>
+</listitem>
+</orderedlist>
+</requirement>
+<requirement xml:id="IDE-19">
+<title>Union Type Subtyping Rules</title>
+<simpara>
+<anchor xml:id="Req-IDE-19" xreflabel="[Req-IDE-19]"/>
+<emphasis role="strong">Requirement: IDE-19:</emphasis>
+<link linkend="Req-IDE-19">Union Type Subtyping Rules</link> (ver. 1)</simpara>
+    <simpara>
+
+Let <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>U</mi></math> be an union type.</simpara>
+<itemizedlist>
+<listitem>
+<simpara>The union type is a common supertype of all its element types:</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><mi>T</mi><mo>∈</mo><mi>U</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mi>s</mi></mrow><mrow><mi>T</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>U</mi></mrow></mfrac></math>
+</listitem>
+<listitem>
+<simpara>More generally, a type is a subtype of a union type, if it is a
+subtype of at least one type contained in the union:</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><mo>∃</mo><mi>T</mi><mo>∈</mo><mi>U</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mi>s</mi><mi>:</mi><mi>S</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>T</mi></mrow><mrow><mi>S</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>U</mi></mrow></mfrac></math>
+</listitem>
+<listitem>
+<simpara>A union type is a subtype of a type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>S</mi></math>, if all types of the union are subtypes of that type.
+This rule is a generalization of the sub typing rules given in [<link linkend="Igarashi07a">Igarashi07a(p.p.40)</link>]</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><mo>∀</mo><mi>T</mi><mo>∈</mo><mi>U</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mi>s</mi><mi>:</mi><mi>T</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>S</mi></mrow><mrow><mi>U</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>S</mi></mrow></mfrac></math>
+</listitem>
+<listitem>
+<simpara>Commutativity: The order of element does not matter:</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mi>u</mi><mi>n</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><mi>A</mi><mo>,</mo><mi>B</mi></mrow></mfenced><mo>=</mo><mi>u</mi><mi>n</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><mi>B</mi><mo>,</mo><mi>A</mi></mrow></mfenced></math>
+</listitem>
+<listitem>
+<simpara>Associativity:
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>u</mi><mi>n</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><mi>A</mi><mo>,</mo><mi>u</mi><mi>n</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><mi>B</mi><mo>,</mo><mi>C</mi></mrow></mfenced></mrow></mfenced><mo>=</mo><mi>u</mi><mi>n</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><mi>u</mi><mi>n</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><mi>A</mi><mo>,</mo><mi>B</mi></mrow></mfenced><mo>,</mo><mi>C</mi></mrow></mfenced></math></simpara>
+</listitem>
+<listitem>
+<simpara>Uniqueness of elements: A union type may not contain duplicates
+(similar to sets):</simpara>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∀</mo><mn>1</mn><mo>≤</mo><mi>i</mi><mo>&lt;</mo><mi>k</mi><mo>≤</mo><mi>n</mi><mo>,</mo><mi>u</mi><mi>n</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><msub><mi>T</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>T</mi><mi>n</mi></msub></mrow></mfenced><mi>:</mi><msub><mi>T</mi><mi>i</mi></msub><mo>≠</mo><msub><mi>T</mi><mi>k</mi></msub></math></simpara>
+</listitem>
+</itemizedlist>
+</requirement>
+<requirement xml:id="IDE-20">
+<title>Implicit simplification of union types</title>
+<simpara>
+<anchor xml:id="Req-IDE-20" xreflabel="[Req-IDE-20]"/>
+<emphasis role="strong">Requirement: IDE-20:</emphasis>
+<link linkend="Req-IDE-20">Implicit simplification of union types</link> (ver. 1)</simpara>
+    <simpara>
+
+Let <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>U</mi></math> be an union type.
+The following simplification rules are always automatically applied to union types.</simpara>
+<itemizedlist>
+<listitem>
+<simpara>Simplification of union type with one element:
+If a union type contains only one element, it is reduced to the element:</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><mi>u</mi><mi>n</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mi>T</mi></mfenced></mrow><mi>T</mi></mfrac></math>
+</listitem>
+<listitem>
+<simpara>Simplification of union types of union types:
+A union type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>U</mi></math> containing another union type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>V</mi></math> is reduced to a single union type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>W</mi></math>, with
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>W</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mi>s</mi><mo>=</mo><mi>U</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mi>s</mi><mo>∪</mo><mi>V</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mi>s</mi></math>:</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><mi>u</mi><mi>n</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><msub><mi>S</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>S</mi><mrow><mi>k</mi><mo>-</mo><mn>1</mn></mrow></msub><mo>,</mo><mi>u</mi><mi>n</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><msub><mi>T</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>T</mi><mi>m</mi></msub></mrow></mfenced><mo>,</mo><msub><mi>S</mi><mrow><mi>k</mi><mo>+</mo><mn>1</mn></mrow></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>S</mi><mi>n</mi></msub></mrow></mfenced></mrow><mrow><mi>u</mi><mi>n</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><msub><mi>S</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>S</mi><mrow><mi>k</mi><mo>-</mo><mn>1</mn></mrow></msub><mo>,</mo><msub><mi>T</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>T</mi><mi>m</mi></msub><mo>,</mo><msub><mi>S</mi><mrow><mi>k</mi><mo>+</mo><mn>1</mn></mrow></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>S</mi><mi>n</mi></msub></mrow></mfenced></mrow></mfrac></math>
+</listitem>
+<listitem>
+<simpara>Simplification of union type with undefined or null:
+Since undefined is the bottom type, and null is kind of a second button type, they are removed from the union:</simpara>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mfrac><mrow><mi>u</mi><mi>n</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><msub><mi>T</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>T</mi><mrow><mi>k</mi><mo>-</mo><mn>1</mn></mrow></msub><mo>,</mo><msub><mi>T</mi><mi>k</mi></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>T</mi><mi>n</mi></msub></mrow></mfenced></mrow><mrow><mi>u</mi><mi>n</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><msub><mi>T</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>T</mi><mrow><mi>k</mi><mo>-</mo><mn>1</mn></mrow></msub><mo>,</mo><mi>u</mi><mi>n</mi><mi>d</mi><mi>e</mi><mi>f</mi><mi>i</mi><mi>n</mi><mi>e</mi><mi>d</mi></mrow></mfenced><mo>,</mo><msub><mi>T</mi><mi>k</mi></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>T</mi><mi>n</mi></msub></mrow></mfrac></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mfrac><mrow><mi>u</mi><mi>n</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><msub><mi>T</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>T</mi><mrow><mi>k</mi><mo>-</mo><mn>1</mn></mrow></msub><mo>,</mo><msub><mi>T</mi><mi>k</mi></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>T</mi><mi>n</mi></msub></mrow></mfenced></mrow><mrow><mi>u</mi><mi>n</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><msub><mi>T</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>T</mi><mrow><mi>k</mi><mo>-</mo><mn>1</mn></mrow></msub><mo>,</mo><mi>n</mi><mi>u</mi><mi>l</mi><mi>l</mi></mrow></mfenced><mo>,</mo><msub><mi>T</mi><mi>k</mi></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>T</mi><mi>n</mi></msub></mrow></mfrac></math></simpara>
+</listitem>
+</itemizedlist>
+<note>
+<simpara>Simplification rules for union types with one element are applied first.</simpara>
+</note>
+<itemizedlist>
+<listitem>
+<simpara>The structural typing strategy is propagated to the types of the union:</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><mi>~</mi><mi>u</mi><mi>n</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><msub><mi>T</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>T</mi><mi>n</mi></msub></mrow></mfenced></mrow><mrow><mi>u</mi><mi>n</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><mi>~</mi><msub><mstyle mathvariant="monospace"><mtext>T</mtext></mstyle><mn>1</mn></msub><mo>,</mo><mi>…</mi><mo>,</mo><mi>~</mi><msub><mstyle mathvariant="monospace"><mtext>T</mtext></mstyle><mi>n</mi></msub></mrow></mfenced></mrow></mfrac></math>
+</listitem>
+</itemizedlist>
+</requirement>
+<simpara>Remarks:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>The simplification rules may be applied recursively.</simpara>
+</listitem>
+<listitem>
+<simpara>For given types <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>B</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>A</mi></math>, and the union type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>U</mi><mo>=</mo><mi>u</mi><mi>n</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><mi>A</mi><mo>,</mo><mi>B</mi></mrow></mfenced></math>, <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>U</mi><mo>≠</mo><mi>B</mi></math>.
+The types are equivalent, however: <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>A</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mo>=</mo><mi>U</mi></math> and <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>U</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mo>=</mo><mi>A</mi></math>.<footnote><simpara>This is different from Ceylon ( [<link linkend="King13a">King13a(p.3.2.3)</link>]), in which the union is defined to be <literal>the same type as</literal> <emphasis>A</emphasis>. Although the meaning of <literal>same</literal> is not clear, it is possibly used as a synonym for <literal>equivalent</literal>.</simpara></footnote></simpara>
+</listitem>
+</itemizedlist>
+<example>
+<title>Subtyping with union type</title>
+<simpara>Let A, B, and C be defined as in the chapter beginning (<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>C</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>B</mi><mo>&lt;</mo><mi>:</mi><mi>A</mi></math>)</simpara>
+<simpara>The following subtyping relations with union types are to be evaluated as follows: <footnote><simpara>See Example <xref linkend="ex:class-hierarchy"/> for class definitions.</simpara></footnote></simpara>
+<programlisting language="n4js" linenumbering="unnumbered">A &lt;: union{A}                                   -&gt; true
+A &lt;: union{A,B}                                 -&gt; true
+B &lt;: union{A,B}                                 -&gt; true
+C &lt;: union{A,B}                                 -&gt; true
+A &lt;: union{B,C}                                 -&gt; false
+B &lt;: union{B,C}                                 -&gt; true
+C &lt;: union{B,C}                                 -&gt; true
+union{A} &lt;: A                                   -&gt; true
+union{B} &lt;: A                                   -&gt; true
+union{B,C} &lt;: A                                 -&gt; true
+union{A,B} &lt;: B                                 -&gt; false
+union{X,Z} &lt;: union{Z,X}                        -&gt; true
+union{X,Y} &lt;: union{X,Y,Z}                      -&gt; true
+union{X,Y,Z} &lt;: union{X,Y}                      -&gt; false</programlisting>
+</example>
+<simpara>The simplification constraints are used by the type inferrer.
+It may be useful, however, to define union types with superfluous elements, as the next example demonstrates</simpara>
+<example>
+<title>Superfluous elements in union type</title>
+<programlisting language="n4js" linenumbering="unnumbered">class A{}
+class B extends A{}
+class C extends A{}
+
+function foo(p: union{A,B}) {..}</programlisting>
+</example>
+<simpara>Although <literal>B</literal> is superfluous, it may indicate that the function handles parameters of type differently than one of type <literal>A</literal> or <literal>C</literal>.</simpara>
+<simpara>Although a union type is a <literal><link linkend="_acronyms">LCST</link></literal> of its contained (non-superfluous) types, the type inferrer usually does not create new union types when computing the join of types.
+If the join of types including at least one union type is calculated, the union type is preserved if possible.
+The same is true for meet.</simpara>
+<simpara>For the definition of join and meet for union types, we define how a type is added to a union type:</simpara>
+<requirement xml:id="IDE-21">
+<title>Union of union type</title>
+<simpara>
+<anchor xml:id="Req-IDE-21" xreflabel="[Req-IDE-21]"/>
+<emphasis role="strong">Requirement: IDE-21:</emphasis>
+<link linkend="Req-IDE-21">Union of union type</link> (ver. 1)</simpara>
+    <simpara>
+
+The union of union types is defined similar to the union of sets.
+The union is not simplified, but it contains no duplicates.</simpara>
+<simpara>If a type A is contained in a union type, then the union type is a common supertype, and (since it is the union itself) also the <literal><link linkend="_acronyms">LCST</link></literal> of both types.
+This finding is the foundation of the definition of join of a (non-union) type with a union type:</simpara>
+</requirement>
+<requirement xml:id="IDE-22">
+<title>Join with Union Type</title>
+<simpara>
+<anchor xml:id="Req-IDE-22" xreflabel="[Req-IDE-22]"/>
+<emphasis role="strong">Requirement: IDE-22:</emphasis>
+<link linkend="Req-IDE-22">Join with Union Type</link> (ver. 1)</simpara>
+    <simpara>
+
+The join <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>J</mi></math> of a union type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>U</mi></math> with a type <emphasis>T</emphasis> is the union of both types:</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><mi>J</mi><mo>=</mo><mi>U</mi><mo>∪</mo><mi>T</mi></mrow><mrow><mfenced close=")" open="("><mrow><mi>U</mi><mo>∨</mo><mi>T</mi></mrow></mfenced><mo>=</mo><mi>J</mi></mrow></mfrac></math>
+<simpara>Remarks:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>Joining a union type with another type is not similar to joining the elements of the union type directly with another type.
+That is</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mi>A</mi><mspace width="3.0mm"/><mstyle mathvariant="bold"><mi>j</mi><mi>o</mi><mi>i</mi><mi>n</mi></mstyle><mspace width="3.0mm"/><mi>u</mi><mi>n</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><mi>B</mi><mo>,</mo><mi>C</mi></mrow></mfenced><mo>≠</mo><mi>A</mi><mspace width="3.0mm"/><mstyle mathvariant="bold"><mi>j</mi><mi>o</mi><mi>i</mi><mi>n</mi></mstyle><mspace width="3.0mm"/><mi>B</mi><mspace width="3.0mm"/><mstyle mathvariant="bold"><mi>j</mi><mi>o</mi><mi>i</mi><mi>n</mi></mstyle><mspace width="3.0mm"/><mi>C</mi></math>
+</listitem>
+<listitem>
+<simpara>The computed join is simplified according to the constraints defined above.</simpara>
+</listitem>
+</itemizedlist>
+</requirement>
+<requirement xml:id="IDE-23">
+<title>Meet with Union Type</title>
+<simpara>
+<anchor xml:id="Req-IDE-23" xreflabel="[Req-IDE-23]"/>
+<emphasis role="strong">Requirement: IDE-23:</emphasis>
+<link linkend="Req-IDE-23">Meet with Union Type</link> (ver. 1)</simpara>
+    <simpara>
+
+The meet of union types is defined as the meet of the elements.
+That is</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mtable><mtr><mtd><mfrac><mrow><msub><mi>T</mi><mn>1</mn></msub><mo>∧</mo><mi>S</mi><mo>∧</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>∧</mo><msub><mi>T</mi><mi>n</mi></msub><mo>∧</mo><mi>S</mi></mrow><mrow><mi>u</mi><mi>n</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><msub><mi>T</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>T</mi><mi>n</mi></msub></mrow></mfenced><mo>∧</mo><mi>S</mi></mrow></mfrac></mtd></mtr><mtr><mtd><mfrac><mrow><msub><mi>T</mi><mn>1</mn></msub><mo>∧</mo><msub><mi>S</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>T</mi><mn>1</mn></msub><mo>∧</mo><msub><mi>S</mi><mi>m</mi></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>T</mi><mi>n</mi></msub><mo>∧</mo><msub><mi>S</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>T</mi><mi>n</mi></msub><mo>∧</mo><msub><mi>S</mi><mi>m</mi></msub></mrow><mrow><mi>u</mi><mi>n</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><msub><mi>T</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>T</mi><mi>n</mi></msub></mrow></mfenced><mo>∧</mo><mi>u</mi><mi>n</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><msub><mi>S</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>S</mi><mi>m</mi></msub></mrow></mfenced></mrow></mfrac></mtd></mtr></mtable></math>
+<simpara>Remarks:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>The meet of a union type with another type is not a union type itself.
+This gets clear when looking at the definition of meet and union type.
+While for a given <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>U</mi><mo>=</mo><mi>u</mi><mi>n</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><mi>A</mi><mo>,</mo><mi>B</mi></mrow></mfenced></math>, <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>A</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>U</mi></math> and <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>B</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>U</mi></math>, the opposite <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>U</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>A</mi></math> is usually not true (unless <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>U</mi></math> can be simplified to <emphasis>A</emphasis>).
+So, for <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>A</mi><mo>∧</mo><mi>U</mi></math>, usually <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>U</mi></math> cannot be the meet.</simpara>
+</listitem>
+</itemizedlist>
+</requirement>
+<requirement xml:id="IDE-24">
+<title>Upper and Lower Bound of a Union Type</title>
+<simpara>
+<anchor xml:id="Req-IDE-24" xreflabel="[Req-IDE-24]"/>
+<emphasis role="strong">Requirement: IDE-24:</emphasis>
+<link linkend="Req-IDE-24">Upper and Lower Bound of a Union Type</link> (ver. 1)</simpara>
+    <simpara>
+</simpara>
+<simpara>The upper and lower bound of a union type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>U</mi></math> is a union type <math xmlns="http://www.w3.org/1998/Math/MathML"><msup><mi>U</mi><mi>'</mi></msup></math> containing the upper and lower bound of the elements of <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>U</mi></math>:</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mtable><mtr><mtd><mi>u</mi><mi>p</mi><mi>p</mi><mi>e</mi><mi>r</mi><mfenced close=")" open="("><mrow><mi>u</mi><mi>n</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><msub><mi>T</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>T</mi><mi>n</mi></msub></mrow></mfenced></mrow></mfenced><mi>:</mi><mo>=</mo><mi>u</mi><mi>n</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><mi>u</mi><mi>p</mi><mi>p</mi><mi>e</mi><mi>r</mi><mfenced close=")" open="("><msub><mi>T</mi><mn>1</mn></msub></mfenced><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><mi>u</mi><mi>p</mi><mi>p</mi><mi>e</mi><mi>r</mi><mfenced close=")" open="("><msub><mi>T</mi><mn>1</mn></msub></mfenced></mrow></mfenced></mtd></mtr><mtr><mtd><mi>l</mi><mi>o</mi><mi>w</mi><mi>e</mi><mi>r</mi><mfenced close=")" open="("><mrow><mi>u</mi><mi>n</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><msub><mi>T</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>T</mi><mi>n</mi></msub></mrow></mfenced></mrow></mfenced><mi>:</mi><mo>=</mo><mi>u</mi><mi>n</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><mi>l</mi><mi>o</mi><mi>w</mi><mi>e</mi><mi>r</mi><mfenced close=")" open="("><msub><mi>T</mi><mn>1</mn></msub></mfenced><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><mi>l</mi><mi>o</mi><mi>w</mi><mi>e</mi><mi>r</mi><mfenced close=")" open="("><msub><mi>T</mi><mn>1</mn></msub></mfenced></mrow></mfenced></mtd></mtr></mtable></math>
+</requirement>
+</section>
+<section xml:id="_warnings">
+<title>Warnings</title>
+<simpara>In case the <literal>any</literal> type is used in a union type, all other types in the union type definition become obsolete.
+However, defining other typers along with the <literal>any</literal> type might seem reasonable in case those other types are treated specifically and thus are mentioned explicitly in the definition.
+Nevertheless the use of the <literal>any</literal> type produces a warning, since its use can indicate a misunderstanding of the union type concept and since documentation can also be done in a comment.</simpara>
+<requirement xml:id="IDE-25">
+<title>Any type in union types</title>
+<simpara>
+<anchor xml:id="Req-IDE-25" xreflabel="[Req-IDE-25]"/>
+<emphasis role="strong">Requirement: IDE-25:</emphasis>
+<link linkend="Req-IDE-25">Any type in union types</link> (ver. 1)</simpara>
+    <simpara>
+
+No union type shall conatin an type:</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mo>∄</mo><mi>a</mi><mi>n</mi><mi>y</mi><mo>∈</mo><mi>U</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mi>s</mi></math>
+<simpara>Similar to the documentary purpose of using specific classes along with the <literal>any</literal> type is the following case.
+When two types are used, one of them a subtype of the other, then this subtype is obsolete. Still it can be used for documentary purposes.
+However, a warning will be produced to indicate unecessary code.
+The warning is only produced when both of the types are either classes or interfaces, since e.g. structural types are supertypes of any classes or interfaces.</simpara>
+</requirement>
+<requirement xml:id="IDE-26">
+<title>Redundant subtypes in union types</title>
+<simpara>
+<anchor xml:id="Req-IDE-26" xreflabel="[Req-IDE-26]"/>
+<emphasis role="strong">Requirement: IDE-26:</emphasis>
+<link linkend="Req-IDE-26">Redundant subtypes in union types</link> (ver. 1)</simpara>
+    <simpara>
+
+Union types shall not
+contain class or interface types which are a subtype of another class or interface type that also is contained in the union type.</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mtable><mtr><mtd><mo>∄</mo><mi>T</mi><mi>T</mi><mo>∈</mo><mi>U</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mi>s</mi><mi>:</mi><mo>∃</mo><mi>T</mi><mo>∈</mo><mi>U</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mi>s</mi><mi>:</mi></mtd></mtr><mtr><mtd><mrow><mo>(</mo><mrow><mi>T</mi><mi>T</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>T</mi><mo>∧</mo><mi>i</mi><mi>s</mi><mi>C</mi><mi>l</mi><mi>a</mi><mi>s</mi><mi>s</mi><mi>O</mi><mi>r</mi><mi>I</mi><mi>n</mi><mi>t</mi><mi>e</mi><mi>r</mi><mi>f</mi><mi>a</mi><mi>c</mi><mi>e</mi><mfenced close=")" open="("><mi>T</mi></mfenced><mo>∧</mo><mi>i</mi><mi>s</mi><mi>C</mi><mi>l</mi><mi>a</mi><mi>s</mi><mi>s</mi><mi>O</mi><mi>r</mi><mi>I</mi><mi>n</mi><mi>t</mi><mi>e</mi><mi>r</mi><mi>f</mi><mi>a</mi><mi>c</mi><mi>e</mi><mfenced close=")" open="("><mrow><mi>T</mi><mi>T</mi></mrow></mfenced><mo>)</mo></mrow></mrow></mtd></mtr></mtable></math>
+</requirement>
+</section>
+</section>
+<section xml:id="_intersection-type">
+<title>Intersection Type</title>
+<simpara>Intersection type reflects the dynamic nature of JavaScript, similar to union type.
+As in Java, intersection type is used to define the type boundaries of type variables in type parameter definitions.
+They are inferred by the type inferencer for type checking (as a result of join or meet).
+In contrast to Java, however, intersection type can be declared explicitly by means of intersection type expression.<footnote><simpara>For type theory about intersection types, see [<link linkend="Pierce02a">Pierce02a(p.15.7)</link>] and [<link linkend="Laurent12a">Laurent12a</link>], other languages supporting explicit notion of intersection type include Ceylon [<link linkend="King13a">King13a(p.3.2.4/5)</link>].</simpara></footnote></simpara>
+<section xml:id="intersection-type-syntax">
+<title>Syntax</title>
+<simpara>For convenience, we repeat the definition of intersection type expression and of type variables in which intersection types can be defined as in Java:</simpara>
+<programlisting language="xtext" linenumbering="unnumbered">InterSectionTypeExpression: 'intersection' '{' typeRefs+=TypeRefWithoutModifiers (',' typeRefs+=TypeRefWithoutModifiers)* '}';
+
+TypeVariable:   name=IDENTIFIER ('extends' declaredUpperBounds+=ParameterizedTypeRefNominal ('&amp;' declaredUpperBounds+=ParameterizedTypeRefNominal)*)?</programlisting>
+</section>
+<section xml:id="intersection-type-semantics">
+<title>Semantics</title>
+<simpara>An intersection type may contain several interfaces but only one class.
+It virtually declares a subclass of this one class and implements all interfaces declared in the intersection type.
+If no class is declared in the intersection type, the intersection type virtually declares a subclass of an N4Object instead.
+This virtual subclass also explains why only one single class may be contained in the intersection.</simpara>
+<requirement xml:id="IDE-27">
+<title>Intersection Type</title>
+<simpara>
+<anchor xml:id="Req-IDE-27" xreflabel="[Req-IDE-27]"/>
+<emphasis role="strong">Requirement: IDE-27:</emphasis>
+<link linkend="Req-IDE-27">Intersection Type</link> (ver. 1)</simpara>
+    <simpara>
+
+For a given intersection type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>I</mi></math>, the following conditions must hold:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>The intersection must contain at least one type:</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mi>I</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mi>s</mi><mo>≠</mo><mi>∅</mi></math>
+</listitem>
+<listitem>
+<simpara>Only one class must be contained in the intersection type:</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfenced close=")" open="("><mrow><mo>∃</mo><mi>C</mi><mo>∈</mo><mi>I</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mi>s</mi><mi>:</mi><mi>μ</mi><mfenced close=")" open="("><mi>C</mi></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>Class</mtext></mstyle></mrow></mfenced><mo>→</mo><mo>∄</mo><mi>T</mi><mo>∈</mo><mi>I</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mi>s</mi><mo>∖</mo><mfenced close="}" open="{"><mi>C</mi></mfenced><mi>:</mi><mi>μ</mi><mfenced close=")" open="("><mi>T</mi></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>Class</mtext></mstyle></math>
+<simpara>For the time being, only a warning is produced when more than one class is contained in the intersection type .</simpara>
+</listitem>
+<listitem>
+<simpara>Non-optional elements:</simpara>
+</listitem>
+</orderedlist>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mo>∀</mo><mi>T</mi><mo>∈</mo><mi>I</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mi>s</mi><mo>→</mo><mo>¬</mo><mi>T</mi><mo>.</mo><mi>o</mi><mi>p</mi><mi>t</mi></math>
+</requirement>
+<requirement xml:id="IDE-175">
+<title>Intersection Type Subtyping Rules</title>
+<simpara>
+<anchor xml:id="Req-IDE-175" xreflabel="[Req-IDE-175]"/>
+<emphasis role="strong">Requirement: IDE-175:</emphasis>
+<link linkend="Req-IDE-175">Intersection Type Subtyping Rules</link> (ver. 1)</simpara>
+    <simpara>
+
+Let <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>I</mi></math> be an intersection type.</simpara>
+<itemizedlist>
+<listitem>
+<simpara>An intersection type is a subtype of another type, if at least one of
+its contained types is a subtype of that type: <footnote><simpara>This rule is a generalization of the subtyping rules given in [<link linkend="Laurent12a">Laurent12a</link>] Table 2, <math xmlns="http://www.w3.org/1998/Math/MathML"><msubsup><mo>∩</mo><mi>l</mi><mn>1</mn></msubsup></math> and <math xmlns="http://www.w3.org/1998/Math/MathML"><msubsup><mo>∩</mo><mi>l</mi><mn>2</mn></msubsup></math></simpara></footnote></simpara>
+</listitem>
+</itemizedlist>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><mo>∃</mo><mi>T</mi><mo>∈</mo><mi>I</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mi>s</mi><mi>:</mi><mi>T</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>S</mi></mrow><mrow><mi>I</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>S</mi></mrow></mfrac></math>
+<itemizedlist>
+<listitem>
+<simpara>A type is a subtype of an intersection type, if it is a subtype of all
+types contained in the intersection type: <footnote><simpara>This rule is a generalization of the subtyping rules given in [<link linkend="Laurent12a">Laurent12a</link>] Table 2, <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mo>∩</mo><mi>r</mi></msub></math></simpara></footnote></simpara>
+</listitem>
+</itemizedlist>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><mo>∀</mo><mi>T</mi><mo>∈</mo><mi>I</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mi>s</mi><mi>:</mi><mi>S</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>T</mi></mrow><mrow><mi>S</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>I</mi></mrow></mfrac></math>
+<itemizedlist>
+<listitem>
+<simpara>Non-optional elements:
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∀</mo><mi>T</mi><mo>∈</mo><mi>I</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mi>s</mi><mo>→</mo><mo>¬</mo><mi>T</mi><mo>.</mo><mi>o</mi><mi>p</mi><mi>t</mi></math></simpara>
+</listitem>
+</itemizedlist>
+</requirement>
+<requirement xml:id="IDE-28">
+<title>Implicit simplification of intersection types</title>
+<simpara>
+<anchor xml:id="Req-IDE-28" xreflabel="[Req-IDE-28]"/>
+<emphasis role="strong">Requirement: IDE-28:</emphasis>
+<link linkend="Req-IDE-28">Implicit simplification of intersection types</link> (ver. 1)</simpara>
+    <simpara>
+
+Let <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>I</mi></math> be an intersection type.
+The following simplification rules are always automatically applied to intersection types.</simpara>
+<itemizedlist>
+<listitem>
+<simpara>The structural typing strategy is propagated to the types of the intersection:</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><mi>~</mi><mi>i</mi><mi>n</mi><mi>t</mi><mi>e</mi><mi>r</mi><mi>s</mi><mi>e</mi><mi>c</mi><mi>t</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><msub><mi>T</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>T</mi><mi>n</mi></msub></mrow></mfenced></mrow><mrow><mi>i</mi><mi>n</mi><mi>t</mi><mi>e</mi><mi>r</mi><mi>s</mi><mi>e</mi><mi>c</mi><mi>t</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><mi>~</mi><msub><mstyle mathvariant="monospace"><mtext>T</mtext></mstyle><mn>1</mn></msub><mo>,</mo><mi>…</mi><mo>,</mo><mi>~</mi><msub><mstyle mathvariant="monospace"><mtext>T</mtext></mstyle><mi>n</mi></msub></mrow></mfenced></mrow></mfrac></math>
+</listitem>
+</itemizedlist>
+<simpara>These subtyping rules are similar to Ceylon. <footnote><simpara>In Ceylon, for a given union type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>U</mi><mo>=</mo><msub><mi>T</mi><mn>1</mn></msub><mo>|</mo><msub><mi>T</mi><mn>2</mn></msub></math> and intersection type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>I</mi><mo>=</mo><msub><mi>T</mi><mn>1</mn></msub><mi>&amp;</mi><msub><mi>T</mi><mn>2</mn></msub></math> (with ’|’ is union and ’&amp;’ is intersection), <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>T</mi><mn>1</mn></msub><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>U</mi></math> and <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>T</mi><mn>2</mn></msub><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>U</mi></math> is true, and <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>T</mi><mn>1</mn></msub><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>I</mi></math> and <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>T</mi><mn>2</mn></msub><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>I</mi></math> is true. We should define that as well (if it is not already defined). Cf [<link linkend="King13a">King13a(p.3.2.4/5)</link>]</simpara></footnote></simpara>
+<simpara>During validation, intersection types containing union or other intersection types may be inferred.
+In this case, the composed types are flattened.
+The aforementioned constraints must hold.
+We also implicitly use this representation in this specification.</simpara>
+<example>
+<title>Subtyping with intersection type</title>
+<simpara>Let A, B, and C be defined as in the chapter beginning (<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>C</mi><mo>&lt;</mo><mi>:</mi><mi>B</mi><mo>&lt;</mo><mi>:</mi><mi>A</mi></math>)</simpara>
+<simpara>The following subtyping relations with intersection types are to be
+evaluated as follows: <footnote><simpara>See Example <xref linkend="ex:class-hierarchy"/> for class definitions.</simpara></footnote></simpara>
+<programlisting language="xtext" linenumbering="unnumbered">A &lt;: intersection{A}                            -&gt; true
+A &lt;: intersection{A,A}                          -&gt; true
+intersection{A,X} &lt;: A                          -&gt; true
+intersection{X,A} &lt;: A                          -&gt; true
+A &lt;: intersection{A,X}                          -&gt; false
+intersection{A,X} &lt;: intersection{X,A}          -&gt; true
+H12 &lt;: intersection{I1,I2}                      -&gt; true
+intersection{I1,I2} &lt;: H12                      -&gt; false
+H1 &lt;: intersection{I1,I2}                       -&gt; false
+H23 &lt;: intersection{I1,I2}                      -&gt; false
+B &lt;: intersection{A}                            -&gt; true
+intersection{I1,I2} &lt;: I                        -&gt; true
+H12 &lt;: intersection{I,I2}                       -&gt; true
+A &lt;: intersection{A,Any}                        -&gt; true
+intersection{A,Any} &lt;: A                        -&gt; true</programlisting>
+</example>
+</requirement>
+<simpara>The join of intersection types is defined as the join of the elements.
+That is:</simpara>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mfrac><mrow><msub><mi>T</mi><mn>1</mn></msub><mo>∨</mo><mi>S</mi><mo>∨</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>∨</mo><msub><mi>T</mi><mi>n</mi></msub><mo>∨</mo><mi>S</mi></mrow><mrow><mi>i</mi><mi>n</mi><mi>t</mi><mi>e</mi><mi>r</mi><mi>s</mi><mi>e</mi><mi>c</mi><mi>t</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><msub><mi>T</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>T</mi><mi>n</mi></msub></mrow></mfenced><mo>∨</mo><mi>S</mi></mrow></mfrac></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mfrac><mrow><msub><mi>T</mi><mn>1</mn></msub><mo>∨</mo><msub><mi>S</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>T</mi><mn>1</mn></msub><mo>∨</mo><msub><mi>S</mi><mi>m</mi></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>T</mi><mi>n</mi></msub><mo>∨</mo><msub><mi>S</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>T</mi><mi>n</mi></msub><mo>∨</mo><msub><mi>S</mi><mi>m</mi></msub></mrow><mrow><mi>i</mi><mi>n</mi><mi>t</mi><mi>e</mi><mi>r</mi><mi>s</mi><mi>e</mi><mi>c</mi><mi>t</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><msub><mi>T</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>T</mi><mi>n</mi></msub></mrow></mfenced><mo>∨</mo><mi>i</mi><mi>n</mi><mi>t</mi><mi>e</mi><mi>r</mi><mi>s</mi><mi>e</mi><mi>c</mi><mi>t</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><msub><mi>S</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>S</mi><mi>m</mi></msub></mrow></mfenced></mrow></mfrac></math></simpara>
+
+<simpara>The meet of intersection types is defined over their elements.
+That is:</simpara>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mfrac><mrow><mi>i</mi><mi>n</mi><mi>t</mi><mi>e</mi><mi>r</mi><mi>s</mi><mi>e</mi><mi>c</mi><mi>t</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><msub><mi>T</mi><mn>1</mn></msub><mo>∧</mo><mi>S</mi><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>T</mi><mi>n</mi></msub><mo>∧</mo><mi>S</mi></mrow></mfenced></mrow><mrow><mi>i</mi><mi>n</mi><mi>t</mi><mi>e</mi><mi>r</mi><mi>s</mi><mi>e</mi><mi>c</mi><mi>t</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><msub><mi>T</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>T</mi><mi>n</mi></msub></mrow></mfenced><mo>∧</mo><mi>S</mi></mrow></mfrac></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mfrac><mrow><mi>i</mi><mi>n</mi><mi>t</mi><mi>e</mi><mi>r</mi><mi>s</mi><mi>e</mi><mi>c</mi><mi>t</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><msub><mi>T</mi><mn>1</mn></msub><mo>∧</mo><msub><mi>S</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>T</mi><mn>1</mn></msub><mo>∧</mo><msub><mi>S</mi><mi>m</mi></msub><mo>,</mo><mspace width="1em"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><mspace width="1em"/><msub><mi>T</mi><mi>n</mi></msub><mo>∧</mo><msub><mi>S</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>T</mi><mi>n</mi></msub><mo>∧</mo><msub><mi>S</mi><mi>m</mi></msub></mrow></mfenced></mrow><mrow><mi>i</mi><mi>n</mi><mi>t</mi><mi>e</mi><mi>r</mi><mi>s</mi><mi>e</mi><mi>c</mi><mi>t</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><msub><mi>T</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>T</mi><mi>n</mi></msub></mrow></mfenced><mo>∧</mo><mi>i</mi><mi>n</mi><mi>t</mi><mi>e</mi><mi>r</mi><mi>s</mi><mi>e</mi><mi>c</mi><mi>t</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><msub><mi>S</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>S</mi><mi>m</mi></msub></mrow></mfenced></mrow></mfrac></math></simpara>
+
+<simpara>The upper and lower bound of an intersection type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>I</mi></math> is a union type <math xmlns="http://www.w3.org/1998/Math/MathML"><msup><mi>I</mi><mi>'</mi></msup></math> containing the upper and lower bound of the elements of <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>I</mi></math>:</simpara>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>u</mi><mi>p</mi><mi>p</mi><mi>e</mi><mi>r</mi><mfenced close=")" open="("><mrow><mi>i</mi><mi>n</mi><mi>t</mi><mi>e</mi><mi>r</mi><mi>s</mi><mi>e</mi><mi>c</mi><mi>t</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><msub><mi>T</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>T</mi><mi>n</mi></msub></mrow></mfenced></mrow></mfenced><mi>:</mi><mo>=</mo><mi>i</mi><mi>n</mi><mi>t</mi><mi>e</mi><mi>r</mi><mi>s</mi><mi>e</mi><mi>c</mi><mi>t</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><mi>u</mi><mi>p</mi><mi>p</mi><mi>e</mi><mi>r</mi><mfenced close=")" open="("><msub><mi>T</mi><mn>1</mn></msub></mfenced><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><mi>u</mi><mi>p</mi><mi>p</mi><mi>e</mi><mi>r</mi><mfenced close=")" open="("><msub><mi>T</mi><mn>1</mn></msub></mfenced></mrow></mfenced></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>l</mi><mi>o</mi><mi>w</mi><mi>e</mi><mi>r</mi><mfenced close=")" open="("><mrow><mi>i</mi><mi>n</mi><mi>t</mi><mi>e</mi><mi>r</mi><mi>s</mi><mi>e</mi><mi>c</mi><mi>t</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><msub><mi>T</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>T</mi><mi>n</mi></msub></mrow></mfenced></mrow></mfenced><mi>:</mi><mo>=</mo><mi>i</mi><mi>n</mi><mi>t</mi><mi>e</mi><mi>r</mi><mi>s</mi><mi>e</mi><mi>c</mi><mi>t</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><mi>l</mi><mi>o</mi><mi>w</mi><mi>e</mi><mi>r</mi><mfenced close=")" open="("><msub><mi>T</mi><mn>1</mn></msub></mfenced><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><mi>l</mi><mi>o</mi><mi>w</mi><mi>e</mi><mi>r</mi><mfenced close=")" open="("><msub><mi>T</mi><mn>1</mn></msub></mfenced></mrow></mfenced></math></simpara>
+
+</section>
+<section xml:id="_warnings-2">
+<title>Warnings</title>
+<simpara>Using <literal>any</literal> types in intersection types is obsolete since they do not change the resulting intersection type.
+E.g. the intersection type of A, B and <literal>any</literal> is equivialent to the intersection type of A and B.
+However, using the <literal>any</literal> type is no error because it can be seen as a neutral argument to the intersection.
+Nevertheless the use of the <literal>any</literal> type produces a warning, since its use can indicate a misunderstanding of the intersection type concept and since it always can be omitted.</simpara>
+<requirement xml:id="IDE-32">
+<title>Any type in intersection types</title>
+<simpara>
+<anchor xml:id="Req-IDE-32" xreflabel="[Req-IDE-32]"/>
+<emphasis role="strong">Requirement: IDE-32:</emphasis>
+<link linkend="Req-IDE-32">Any type in intersection types</link> (ver. 1)</simpara>
+    <simpara>
+
+No intersection type shall contain an type:</simpara>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∄</mo><mi>a</mi><mi>n</mi><mi>y</mi><mo>∈</mo><mi>I</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mi>s</mi></math></simpara>
+</requirement>
+<simpara>The use of the <literal>any</literal> type in an intersection type is similar to the following case.
+When two types are used, one of them a supertype of the other, then this supertype is obsolete.
+Hence, a warning will be produced to indicate unecessary code.
+The warning is only produced when both of the types are either classes or interfaces, since e.g. structural types are supertypes of any classes or interfaces.</simpara>
+<requirement xml:id="IDE-33">
+<title>Redundant supertypes in intersection types</title>
+<simpara>
+<anchor xml:id="Req-IDE-33" xreflabel="[Req-IDE-33]"/>
+<emphasis role="strong">Requirement: IDE-33:</emphasis>
+<link linkend="Req-IDE-33">Redundant supertypes in intersection types</link> (ver. 1)</simpara>
+    <simpara>
+
+Intersection types shall not contain class or interface types which are a supertype of another class or interface type that also is contained in the intersection type.</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mo>∄</mo><mi>T</mi><mo>∈</mo><mi>I</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mi>s</mi><mi>:</mi><mo>∃</mo><mi>T</mi><mi>T</mi><mo>∈</mo><mi>I</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mi>s</mi><mi>:</mi><mtext>
+</mtext><mrow><mo>(</mo><mrow><mi>T</mi><mi>T</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>T</mi><mo>∧</mo><mi>i</mi><mi>s</mi><mi>C</mi><mi>l</mi><mi>a</mi><mi>s</mi><mi>s</mi><mi>O</mi><mi>r</mi><mi>I</mi><mi>n</mi><mi>t</mi><mi>e</mi><mi>r</mi><mi>f</mi><mi>a</mi><mi>c</mi><mi>e</mi><mfenced close=")" open="("><mi>T</mi></mfenced><mo>∧</mo><mi>i</mi><mi>s</mi><mi>C</mi><mi>l</mi><mi>a</mi><mi>s</mi><mi>s</mi><mi>O</mi><mi>r</mi><mi>I</mi><mi>n</mi><mi>t</mi><mi>e</mi><mi>r</mi><mi>f</mi><mi>a</mi><mi>c</mi><mi>e</mi><mfenced close=")" open="("><mrow><mi>T</mi><mi>T</mi></mrow></mfenced><mo>)</mo></mrow></mrow></math>
+</requirement>
+</section>
+</section>
+<section xml:id="_composed-types-in-wildcards">
+<title>Composed Types in Wildcards</title>
+<simpara>Composed types may appear as the bound of a wildcard.
+The following constraints apply: <footnote><simpara>see "Covariance and contravariance with unions and intersections" at <link xl:href="http://ceylon-lang.org/documentation/1.1/tour/generics/">http://ceylon-lang.org/documentation/1.1/tour/generics/</link></simpara></footnote></simpara>
+<requirement xml:id="IDE-34">
+<title>Composed Types as Bound of a Wildcard</title>
+<simpara>
+<anchor xml:id="Req-IDE-34" xreflabel="[Req-IDE-34]"/>
+<emphasis role="strong">Requirement: IDE-34:</emphasis>
+<link linkend="Req-IDE-34">Composed Types as Bound of a Wildcard</link> (ver. 1)</simpara>
+    <simpara>
+
+A composed type may appear as the upper or lower bound of a wildcard.
+In the covariant case, the following subtype relations apply:</simpara>
+<programlisting language="ebnf" linenumbering="unnumbered">union{ G&lt;? extends A&gt;, G&lt;? extends B&gt; }  \subtype  G&lt;? extends union{A,B}&gt;
+G&lt;? extends intersection{A,B}&gt;  \subtype  intersection{ G&lt;? extends A&gt;, G&lt;? extends B&gt; }</programlisting>
+<simpara>In the contra variant case, the following subtype relations apply:</simpara>
+<programlisting language="ebnf" linenumbering="unnumbered">union{ G&lt;? super A&gt;, G&lt;? super B&gt; }  \subtype  G&lt;? super intersection{A,B}&gt;
+G&lt;? super union{A,B}&gt;  \subtype  intersection{ G&lt;? super A&gt;, G&lt;? super B&gt; }</programlisting>
+</requirement>
+</section>
+<section xml:id="_property-access-for-composed-types">
+<title>Property Access for Composed Types</title>
+<simpara>It is possible to directly access properties of union and intersection types.
+The following sections define which properties are accessible.</simpara>
+<section xml:id="_properties-of-union-type">
+<title>Properties of Union Type</title>
+<simpara>As an (oversimplified) rule of thumb, the properties of a union type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>U</mi><mo>=</mo><msub><mi>T</mi><mn>1</mn></msub><mo>|</mo><msub><mi>T</mi><mn>2</mn></msub></math> are simply the intersection of the properties <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>U</mi><mo>.</mo><mi>p</mi><mi>r</mi><mi>o</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>t</mi><mi>i</mi><mi>e</mi><mi>s</mi><mo>=</mo><msub><mi>T</mi><mn>1</mn></msub><mo>.</mo><mi>p</mi><mi>r</mi><mi>o</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>t</mi><mi>i</mi><mi>e</mi><mi>s</mi><mo>∩</mo><msub><mi>T</mi><mn>2</mn></msub><mo>.</mo><mi>p</mi><mi>r</mi><mi>o</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>t</mi><mi>i</mi><mi>e</mi><mi>s</mi></math>.
+In other words, a property 'p' in the union type is the least common denominator of all 'p' in T_{1} and T_{2}.
+It is not quite that simple, however, as the question of "equality" with regards to properties has to be answered.</simpara>
+<simpara><?asciidoc-hr?></simpara>
+<simpara>For a given union type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>U</mi><mo>=</mo><msub><mi>T</mi><mn>1</mn></msub><mo>|</mo><msub><mi>T</mi><mn>2</mn></msub></math>, the following constraints for its members must hold:</simpara>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∀</mo><mi> </mi><mi>a</mi><mo>∈</mo><mi>U</mi><mo>.</mo><mi>a</mi><mi>t</mi><mi>t</mi><mi>r</mi><mi>i</mi><mi>b</mi><mi>u</mi><mi>t</mi><mi>e</mi><mi>s</mi><mi>:</mi></math></simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mtable><mtr><mtd/><mtd><mo>∀</mo><mi> </mi><mi>k</mi><mo>∈</mo><mfenced close="}" open="{"><mn>1</mn><mn>2</mn></mfenced><mi>:</mi><mo>∃</mo><mi> </mi><msub><mi>a</mi><mi>k</mi></msub><mo>∈</mo><msub><mi>T</mi><mi>k</mi></msub><mo>.</mo><mi>a</mi><mi>t</mi><mi>t</mi><mi>r</mi><mi>i</mi><mi>b</mi><mi>u</mi><mi>t</mi><mi>e</mi><mi>s</mi><mi>:</mi><msub><mi>a</mi><mi>k</mi></msub><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mo>&gt;</mo><mi>p</mi><mi>r</mi><mi>i</mi><mi>v</mi><mi>a</mi><mi>t</mi><mi>e</mi></mtd></mtr><mtr><mtd/><mtd><mo>∧</mo><mi>a</mi><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mo>=</mo><mi>m</mi><mi>i</mi><mi>n</mi><mfenced close=")" open="("><mrow><msub><mi>a</mi><mn>1</mn></msub><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi></mrow><mrow><msub><mi>a</mi><mn>2</mn></msub><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi></mrow></mfenced></mtd></mtr><mtr><mtd/><mtd><mo>∧</mo><mi>a</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><msub><mi>a</mi><mn>1</mn></msub><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><msub><mi>a</mi><mn>2</mn></msub><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi></mtd></mtr><mtr><mtd/><mtd><mo>∧</mo><mi>a</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mo>=</mo><msub><mi>a</mi><mn>1</mn></msub><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mo>=</mo><msub><mi>a</mi><mn>2</mn></msub><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi></mtd></mtr></mtable></math>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∀</mo><mi> </mi><mi>m</mi><mo>∈</mo><mi>U</mi><mo>.</mo><mi>m</mi><mi>e</mi><mi>t</mi><mi>h</mi><mi>o</mi><mi>d</mi><mi>s</mi><mi>:</mi></math></simpara>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∃</mo><mi> </mi><msub><mi>m</mi><mn>1</mn></msub><mo>∈</mo><msub><mi>T</mi><mn>1</mn></msub><mo>.</mo><mi>m</mi><mi>e</mi><mi>t</mi><mi>h</mi><mi>o</mi><mi>d</mi><mi>s</mi><mo>,</mo><msub><mi>m</mi><mn>2</mn></msub><mo>∈</mo><msub><mi>T</mi><mn>2</mn></msub><mo>.</mo><mi>m</mi><mi>e</mi><mi>t</mi><mi>h</mi><mi>o</mi><mi>d</mi><mi>s</mi><mo>,</mo></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="2.0em"/><mstyle mathvariant="bold"><mi>w</mi><mi>i</mi><mi>t</mi><mi>h</mi></mstyle><mi>p</mi><mo>=</mo><mi>m</mi><mo>.</mo><mi>f</mi><mi>p</mi><mi>a</mi><mi>r</mi><mi>s</mi><mo>∧</mo><msup><mi>p</mi><mi>'</mi></msup><mo>=</mo><msub><mi>m</mi><mn>1</mn></msub><mo>.</mo><mi>f</mi><mi>p</mi><mi>a</mi><mi>r</mi><mi>s</mi><mo>∧</mo><mi>p</mi><mi>"</mi><mo>=</mo><msub><mi>m</mi><mn>2</mn></msub><mo>.</mo><mi>f</mi><mi>p</mi><mi>a</mi><mi>r</mi><mi>s</mi><mo>,</mo><mstyle mathvariant="bold"><mi>W</mi><mi>L</mi><mi>O</mi><mi>G</mi></mstyle><mo>|</mo><msup><mi>p</mi><mi>'</mi></msup><mo>|</mo><mo>≤</mo><mo>|</mo><mi>p</mi><mi>"</mi><mo>|</mo><mi>:</mi></math><?asciidoc-br?></simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mtable><mtr><mtd/><mtd><mspace width="1.2em"/><mo>∀</mo><mi>k</mi><mo>∈</mo><mfenced close="}" open="{"><mn>1</mn><mn>2</mn></mfenced><mi>:</mi><msub><mi>m</mi><mi>k</mi></msub><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mo>&gt;</mo><mi>p</mi><mi>r</mi><mi>i</mi><mi>v</mi><mi>a</mi><mi>t</mi><mi>e</mi></mtd></mtr><mtr><mtd/><mtd><mo>∧</mo><mi>m</mi><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mo>=</mo><mi>m</mi><mi>i</mi><mi>n</mi><mfenced close=")" open="("><mrow><msub><mi>m</mi><mn>1</mn></msub><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi></mrow><mrow><msub><mi>m</mi><mn>2</mn></msub><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi></mrow></mfenced></mtd></mtr><mtr><mtd/><mtd><mo>∧</mo><mi>m</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><msub><mi>m</mi><mn>1</mn></msub><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><msub><mi>m</mi><mn>2</mn></msub><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi></mtd></mtr><mtr><mtd/><mtd><mo>∧</mo><mi>m</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mo>=</mo><msub><mi>m</mi><mn>1</mn></msub><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mo>|</mo><msub><mi>m</mi><mn>2</mn></msub><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi></mtd></mtr><mtr><mtd/><mtd><mo>∧</mo><mo>∀</mo><mi> </mi><mi>i</mi><mo>&lt;</mo><mo>|</mo><mi>p</mi><mi>"</mi><mo>|</mo><mi>:</mi><msub><mi>p</mi><mi>i</mi></msub><mi> </mi><mstyle mathvariant="bold"><mi>e</mi><mi>x</mi><mi>i</mi><mi>s</mi><mi>t</mi><mi>s</mi></mstyle><mspace width="1.0mm"/><mstyle mathvariant="bold"><mi>w</mi><mi>i</mi><mi>t</mi><mi>h</mi></mstyle></mtd></mtr><mtr><mtd/><mtd><mspace width="2.0em"/><msub><mi>p</mi><mi>i</mi></msub><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><mfenced close="" open="{"><mtable><mtr><mtd><msub><mrow><mi>p</mi><mi>"</mi></mrow><mi>i</mi></msub><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi></mtd><mtd><mi>i</mi><mo>≥</mo><mo>|</mo><msup><mi>p</mi><mi>'</mi></msup><mo>|</mo><mo>∨</mo><msub><msup><mi>p</mi><mi>'</mi></msup><mi>i</mi></msub><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><msub><mrow><mi>p</mi><mi>"</mi></mrow><mi>i</mi></msub><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi></mtd></mtr><mtr><mtd><msub><msup><mi>p</mi><mi>'</mi></msup><mi>i</mi></msub><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>+</mo><mstyle mathvariant="bold"><mi>"</mi><mi>_</mi><mi>"</mi></mstyle><mo>+</mo><msub><mrow><mi>p</mi><mi>"</mi></mrow><mi>i</mi></msub><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi></mtd><mtd><mstyle mathvariant="bold"><mi>e</mi><mi>l</mi><mi>s</mi><mi>e</mi></mstyle></mtd></mtr></mtable></mfenced></mtd></mtr><mtr><mtd/><mtd><mspace width="2.0em"/><msub><mi>p</mi><mi>i</mi></msub><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mo>=</mo><mfenced close="" open="{"><mtable><mtr><mtd><msub><msup><mi>p</mi><mi>'</mi></msup><mi>i</mi></msub><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mi>&amp;</mi><msub><mrow><mi>p</mi><mi>"</mi></mrow><mi>i</mi></msub><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi></mtd><mtd><mi>i</mi><mo>&lt;</mo><mo>|</mo><msup><mi>p</mi><mi>'</mi></msup><mo>|</mo></mtd></mtr><mtr><mtd><msub><msup><mi>p</mi><mi>'</mi></msup><mrow><mo>|</mo><msup><mi>p</mi><mi>'</mi></msup><mo>|</mo><mo>-</mo><mn>1</mn></mrow></msub><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mi>&amp;</mi><msub><mrow><mi>p</mi><mi>"</mi></mrow><mi>i</mi></msub><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi></mtd><mtd><mi>i</mi><mo>≥</mo><mo>|</mo><msup><mi>p</mi><mi>'</mi></msup><mo>|</mo><mo>∧</mo><msub><msup><mi>p</mi><mi>'</mi></msup><mrow><mo>|</mo><msup><mi>p</mi><mi>'</mi></msup><mo>|</mo><mo>-</mo><mn>1</mn></mrow></msub><mo>.</mo><mi>v</mi><mi>a</mi><mi>r</mi></mtd></mtr><mtr><mtd><msub><mrow><mi>p</mi><mi>"</mi></mrow><mi>i</mi></msub><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi></mtd><mtd><mstyle mathvariant="bold"><mi>e</mi><mi>l</mi><mi>s</mi><mi>e</mi></mstyle></mtd></mtr></mtable></mfenced></mtd></mtr><mtr><mtd/><mtd><mspace width="2.0em"/><msub><mi>p</mi><mi>i</mi></msub><mo>.</mo><mi>o</mi><mi>p</mi><mi>t</mi><mo>=</mo><mfenced close="" open="{"><mtable><mtr><mtd><mfenced close=")" open="("><mrow><msub><msup><mi>p</mi><mi>'</mi></msup><mi>i</mi></msub><mo>.</mo><mi>o</mi><mi>p</mi><mi>t</mi><mo>∧</mo><msub><mrow><mi>p</mi><mi>"</mi></mrow><mi>i</mi></msub><mo>.</mo><mi>o</mi><mi>p</mi><mi>t</mi></mrow></mfenced></mtd><mtd><mi>i</mi><mo>&lt;</mo><mo>|</mo><msup><mi>p</mi><mi>'</mi></msup><mo>|</mo></mtd></mtr><mtr><mtd><msub><mrow><mi>p</mi><mi>"</mi></mrow><mi>i</mi></msub><mo>.</mo><mi>o</mi><mi>p</mi><mi>t</mi></mtd><mtd><mstyle mathvariant="bold"><mi>e</mi><mi>l</mi><mi>s</mi><mi>e</mi></mstyle></mtd></mtr></mtable></mfenced></mtd></mtr><mtr><mtd/><mtd><mspace width="2.0em"/><msub><mi>p</mi><mi>i</mi></msub><mo>.</mo><mi>v</mi><mi>a</mi><mi>r</mi><mo>=</mo><mfenced close="" open="{"><mtable><mtr><mtd><msub><msup><mi>p</mi><mi>'</mi></msup><mi>i</mi></msub><mo>.</mo><mi>v</mi><mi>a</mi><mi>r</mi><mo>∧</mo><msub><mrow><mi>p</mi><mi>"</mi></mrow><mi>i</mi></msub><mo>.</mo><mi>v</mi><mi>a</mi><mi>r</mi></mtd><mtd><mi>i</mi><mo>&lt;</mo><mo>|</mo><msup><mi>p</mi><mi>'</mi></msup><mo>|</mo><mo>∧</mo><mi>i</mi><mo>=</mo><mo>|</mo><mi>p</mi><mi>"</mi><mo>|</mo><mo>-</mo><mn>1</mn></mtd></mtr><mtr><mtd><msub><mrow><mi>p</mi><mi>"</mi></mrow><mi>i</mi></msub><mo>.</mo><mi>v</mi><mi>a</mi><mi>r</mi></mtd><mtd><mi>i</mi><mo>≥</mo><mo>|</mo><msup><mi>p</mi><mi>'</mi></msup><mo>|</mo><mo>∧</mo><mi>i</mi><mo>=</mo><mo>|</mo><mi>p</mi><mi>"</mi><mo>|</mo><mo>-</mo><mn>1</mn></mtd></mtr><mtr><mtd><mi>f</mi><mi>a</mi><mi>l</mi><mi>s</mi><mi>e</mi></mtd><mtd><mstyle mathvariant="bold"><mi>e</mi><mi>l</mi><mi>s</mi><mi>e</mi></mstyle></mtd></mtr></mtable></mfenced></mtd></mtr></mtable></math>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∧</mo><mrow><mo>(</mo><mi>l</mi><mo>=</mo><mo>|</mo><msup><mi>p</mi><mi>'</mi></msup><mo>|</mo><mo>=</mo><mo>|</mo><mi>p</mi><mi>"</mi><mo>|</mo><mo>∧</mo><mo>¬</mo><mfenced close=")" open="("><mrow><msub><msup><mi>p</mi><mi>'</mi></msup><mi>l</mi></msub><mo>-</mo><mn>1</mn><mo>.</mo><mi>o</mi><mi>p</mi><mi>t</mi><mo>∧</mo><msub><mrow><mi>p</mi><mi>"</mi></mrow><mrow><mi>l</mi><mo>-</mo><mn>1</mn></mrow></msub><mo>.</mo><mi>o</mi><mi>p</mi><mi>t</mi></mrow></mfenced><mo>∧</mo><mo>∃</mo><mi>v</mi><mo>∈</mo><mfenced close="}" open="{"><mrow><mi>p</mi><msub><mi>'</mi><mi>l</mi></msub><mo>-</mo><mn>1</mn></mrow><mrow><mi>p</mi><msub><mi>"</mi><mi>l</mi></msub><mo>-</mo><mn>1</mn></mrow></mfenced><mi>v</mi><mo>.</mo><mi>v</mi><mi>a</mi><mi>r</mi><mi>:</mi><msub><mi>p</mi><mi>l</mi></msub><mi> </mi><mstyle mathvariant="bold"><mi>e</mi><mi>x</mi><mi>i</mi><mi>s</mi><mi>t</mi><mi>s</mi></mstyle><mspace width="1.0mm"/><mstyle mathvariant="bold"><mi>w</mi><mi>i</mi><mi>t</mi><mi>h</mi></mstyle></mrow></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="2.0em"/><msub><mi>p</mi><mi>l</mi></msub><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><mi>v</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="2.0em"/><msub><mi>p</mi><mi>i</mi></msub><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mo>=</mo><mi>v</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="2.0em"/><msub><mi>p</mi><mi>i</mi></msub><mo>.</mo><mi>o</mi><mi>p</mi><mi>t</mi><mo>=</mo><mi>t</mi><mi>r</mi><mi>u</mi><mi>e</mi></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="2.0em"/><msub><mi>p</mi><mi>i</mi></msub><mo>.</mo><mi>v</mi><mi>a</mi><mi>r</mi><mo>=</mo><mi>t</mi><mi>r</mi><mi>u</mi><mi>e</mi></math></simpara>
+<simpara><?asciidoc-hr?></simpara>
+<simpara>The following table shows how non-method members of union types are merged.
+The resulting member type depends on whether the member is being accessed during a read (R) or write (W) operation.
+The type of a field, of a getter or of the parameter of a setter is indicated in brackets.</simpara>
+<table frame="all" rowsep="1" colsep="1">
+<title>Merged Members of Unions</title>
+<tgroup cols="5">
+<colspec colname="col_1" colwidth="20*"/>
+<colspec colname="col_2" colwidth="20*"/>
+<colspec colname="col_3" colwidth="20*"/>
+<colspec colname="col_4" colwidth="20*"/>
+<colspec colname="col_5" colwidth="20*"/>
+<thead>
+<row>
+<entry align="center" valign="top">Members</entry>
+<entry align="center" valign="top" namest="col_2" nameend="col_3">S=T</entry>
+<entry align="center" valign="top" namest="col_3" nameend="col_4">S≠T</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry align="center" valign="top"></entry>
+<entry align="center" valign="top"><simpara><emphasis role="strong">R</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><emphasis role="strong">W</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><emphasis role="strong">R</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><emphasis role="strong">W</emphasis></simpara></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><emphasis role="strong">field:S  | field:T</emphasis></simpara></entry>
+<entry align="center" valign="top" namest="col_2" nameend="col_3"><simpara>field:S</simpara></entry>
+<entry align="center" valign="top"><simpara>getter:S|T</simpara></entry>
+<entry align="center" valign="top"><simpara>setter:S&amp;T</simpara></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><emphasis role="strong">getter:S | getter:T</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara>getter:S</simpara></entry>
+<entry align="center" valign="top"><simpara>-</simpara></entry>
+<entry align="center" valign="top"><simpara>getter:S|T</simpara></entry>
+<entry align="center" valign="top"><simpara>-</simpara></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><emphasis role="strong">setter:S | setter:T</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara>-</simpara></entry>
+<entry align="center" valign="top"><simpara>setter:S</simpara></entry>
+<entry align="center" valign="top"><simpara>-</simpara></entry>
+<entry align="center" valign="top"><simpara>setter:S&amp;T</simpara></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><emphasis role="strong">field:S  | getter:T</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara>getter:S</simpara></entry>
+<entry align="center" valign="top"><simpara>-</simpara></entry>
+<entry align="center" valign="top"><simpara>getter:S|T</simpara></entry>
+<entry align="center" valign="top"><simpara>-</simpara></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><emphasis role="strong">field:S  | setter:T</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara>-</simpara></entry>
+<entry align="center" valign="top"><simpara>setter:S</simpara></entry>
+<entry align="center" valign="top"><simpara>-</simpara></entry>
+<entry align="center" valign="top"><simpara>setter:S&amp;T</simpara></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><emphasis role="strong">getter:S | setter:T</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara>-</simpara></entry>
+<entry align="center" valign="top"><simpara>-</simpara></entry>
+<entry align="center" valign="top"><simpara>-</simpara></entry>
+<entry align="center" valign="top"><simpara>-</simpara></entry>
+</row>
+</tbody>
+</tgroup>
+</table>
+<section xml:id="_remarks-on-union-type-s-members">
+<title>Remarks on union type’s members:</title>
+<itemizedlist>
+<listitem>
+<simpara>Fields of the same type are merged to a composed field with the same type.
+Fields of different types are merged to a getter and setter.</simpara>
+</listitem>
+<listitem>
+<simpara>The return type of a composed getter is the <emphasis>union</emphasis> type of the return types of the merged getters.</simpara>
+</listitem>
+<listitem>
+<simpara>The type of a composed setter is the <emphasis>intersection</emphasis> type of the types of the merged setters.</simpara>
+</listitem>
+<listitem>
+<simpara>Fields can be combined with getters and/or setters:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>fields combined with getters allow read-access.</simpara>
+</listitem>
+<listitem>
+<simpara>non-const fields combined with setters allow write-access.</simpara>
+</listitem>
+<listitem>
+<simpara>non-const fields combined with getters <emphasis>and</emphasis> setters, i.e. each type has either a non-const field or both a getter and a setter of the given name, allow both read- and write-access.</simpara>
+<simpara>Again, types need not be identical; for read-access the <emphasis>union</emphasis> of the fields’ types and the getters’ return types is formed, for write-access the <emphasis>intersection</emphasis> of the fields’ types and the setters’ types is formed.
+In the third case above, types are combined independently for read- and write-access if the getters and setters have different types.</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+<listitem>
+<simpara>The name of a method’s parameter is only used for error or warning messages and cannot be referenced otherwise.</simpara>
+</listitem>
+<listitem>
+<simpara>The return type of a composed method is the <emphasis>union</emphasis> type of the return types of the merged methods.</simpara>
+</listitem>
+<listitem>
+<simpara>A composed method parameter’s type is the <emphasis>intersection</emphasis> type of the merged parameters types.</simpara>
+</listitem>
+</itemizedlist>
+</section>
+</section>
+<section xml:id="_properties-of-intersection-type">
+<title>Properties of Intersection Type</title>
+<simpara>As an (oversimplified) rule of thumb, the properties of an intersection type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>I</mi><mo>=</mo><msub><mi>T</mi><mn>1</mn></msub><mi>&amp;</mi><msub><mi>T</mi><mn>2</mn></msub></math> are the union of properties <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>I</mi><mo>.</mo><mi>p</mi><mi>r</mi><mi>o</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>t</mi><mi>i</mi><mi>e</mi><mi>s</mi><mo>=</mo><msub><mi>T</mi><mn>1</mn></msub><mo>.</mo><mi>p</mi><mi>r</mi><mi>o</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>t</mi><mi>i</mi><mi>e</mi><mi>s</mi><mo>∪</mo><msub><mi>T</mi><mn>2</mn></msub><mo>.</mo><mi>p</mi><mi>r</mi><mi>o</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>t</mi><mi>i</mi><mi>e</mi><mi>s</mi></math>.
+In other words, a property 'p' in the union type is the greates common denominator of all 'p' in T_{1} and T_{2}.
+It is not quite that simple, however, as the question of "equality” with regards to properties has to be answered.</simpara>
+<requirement xml:id="IDE-36">
+<title>Members of an Intersection Type</title>
+<simpara>
+<anchor xml:id="Req-IDE-36" xreflabel="[Req-IDE-36]"/>
+<emphasis role="strong">Requirement: IDE-36:</emphasis>
+<link linkend="Req-IDE-36">Members of an Intersection Type</link> (ver. 1)</simpara>
+    <simpara>
+
+For a given intersection type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>I</mi><mo>=</mo><msub><mi>T</mi><mn>1</mn></msub><mi>&amp;</mi><msub><mi>T</mi><mn>2</mn></msub></math>, the following constraints for its members must hold:</simpara>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∀</mo><mi>a</mi><mo>∈</mo><mi>I</mi><mo>.</mo><mi>a</mi><mi>t</mi><mi>t</mi><mi>r</mi><mi>i</mi><mi>b</mi><mi>u</mi><mi>t</mi><mi>e</mi><mi>s</mi><mi>:</mi></math></simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mtable><mtr><mtd/><mtd><mrow><mo>(</mo><mrow><mo>∃</mo><msub><mi>a</mi><mn>1</mn></msub><mo>∈</mo><msub><mi>T</mi><mn>1</mn></msub><mo>.</mo><mi>a</mi><mi>t</mi><mi>t</mi><mi>r</mi><mi>i</mi><mi>b</mi><mi>u</mi><mi>t</mi><mi>e</mi><mi>s</mi><mo>,</mo><msub><mi>a</mi><mn>1</mn></msub><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mo>&gt;</mo><mi>p</mi><mi>r</mi><mi>i</mi><mi>v</mi><mi>a</mi><mi>t</mi><mi>e</mi><mo>)</mo></mrow><mo>∨</mo><mrow><mo>(</mo><mrow><mo>∃</mo><msub><mi>a</mi><mn>2</mn></msub><mo>∈</mo><msub><mi>T</mi><mn>2</mn></msub><mo>.</mo><mi>a</mi><mi>t</mi><mi>t</mi><mi>r</mi><mi>i</mi><mi>b</mi><mi>u</mi><mi>t</mi><mi>e</mi><mi>s</mi><mo>,</mo><msub><mi>a</mi><mn>2</mn></msub><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mo>&gt;</mo><mi>p</mi><mi>r</mi><mi>i</mi><mi>v</mi><mi>a</mi><mi>t</mi><mi>e</mi><mo>)</mo></mrow></mrow></mrow></mtd></mtr><mtr><mtd/><mtd><mo>∧</mo><mi>a</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><mfenced close="" open="{"><mtable><mtr><mtd><msub><mi>a</mi><mn>1</mn></msub><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi></mtd><mtd><msub><mi>a</mi><mn>1</mn></msub><mo>≠</mo><mi>n</mi><mi>u</mi><mi>l</mi><mi>l</mi><mo>∧</mo><mfenced close=")" open="("><mrow><msub><mi>a</mi><mn>2</mn></msub><mo>=</mo><mi>n</mi><mi>u</mi><mi>l</mi><mi>l</mi><mo>∨</mo><msub><mi>a</mi><mn>2</mn></msub><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><msub><mi>a</mi><mn>1</mn></msub><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi></mrow></mfenced></mtd></mtr><mtr><mtd><msub><mi>a</mi><mn>2</mn></msub><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi></mtd><mtd><mstyle mathvariant="bold"><mi>e</mi><mi>l</mi><mi>s</mi><mi>e</mi></mstyle></mtd></mtr></mtable></mfenced></mtd></mtr><mtr><mtd/><mtd><mo>∧</mo><mi>a</mi><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mo>=</mo><mfenced close="" open="{"><mtable><mtr><mtd><msub><mi>a</mi><mn>1</mn></msub><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi></mtd><mtd><msub><mi>a</mi><mn>1</mn></msub><mo>≠</mo><mi>n</mi><mi>u</mi><mi>l</mi><mi>l</mi><mo>∧</mo><mfenced close=")" open="("><mrow><msub><mi>a</mi><mn>2</mn></msub><mo>=</mo><mi>n</mi><mi>u</mi><mi>l</mi><mi>l</mi><mo>∨</mo><msub><mi>a</mi><mn>2</mn></msub><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mo>≤</mo><msub><mi>a</mi><mn>1</mn></msub><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi></mrow></mfenced></mtd></mtr><mtr><mtd><msub><mi>a</mi><mn>2</mn></msub><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi></mtd><mtd><mstyle mathvariant="bold"><mi>e</mi><mi>l</mi><mi>s</mi><mi>e</mi></mstyle></mtd></mtr></mtable></mfenced></mtd></mtr><mtr><mtd/><mtd><mo>∧</mo><mi>a</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mo>=</mo><mfenced close="" open="{"><mtable><mtr><mtd><msub><mi>a</mi><mn>1</mn></msub><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mi>&amp;</mi><msub><mi>a</mi><mn>2</mn></msub><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi></mtd><mtd><msub><mi>a</mi><mn>1</mn></msub><mo>≠</mo><mi>n</mi><mi>u</mi><mi>l</mi><mi>l</mi><mo>∧</mo><msub><mi>a</mi><mn>2</mn></msub><mo>≠</mo><mi>n</mi><mi>u</mi><mi>l</mi><mi>l</mi></mtd></mtr><mtr><mtd><msub><mi>a</mi><mn>1</mn></msub><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi></mtd><mtd><msub><mi>a</mi><mn>1</mn></msub><mo>≠</mo><mi>n</mi><mi>u</mi><mi>l</mi><mi>l</mi></mtd></mtr><mtr><mtd><msub><mi>a</mi><mn>2</mn></msub><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi></mtd><mtd><mstyle mathvariant="bold"><mi>e</mi><mi>l</mi><mi>s</mi><mi>e</mi></mstyle><mfenced close=")" open="("><mrow><msub><mi>a</mi><mn>2</mn></msub><mo>≠</mo><mi>n</mi><mi>u</mi><mi>l</mi><mi>l</mi></mrow></mfenced></mtd></mtr></mtable></mfenced></mtd></mtr></mtable></math>
+<simpara><?asciidoc-pagebreak?></simpara>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∀</mo><mi>m</mi><mo>∈</mo><mi>I</mi><mo>.</mo><mi>m</mi><mi>e</mi><mi>t</mi><mi>h</mi><mi>o</mi><mi>d</mi><mi>s</mi></math>:</simpara>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mrow><mo>(</mo><mrow><mo>∃</mo><msub><mi>m</mi><mn>1</mn></msub><mo>∈</mo><msub><mi>T</mi><mn>1</mn></msub><mo>.</mo><mi>m</mi><mi>e</mi><mi>t</mi><mi>h</mi><mi>o</mi><mi>d</mi><mi>s</mi><mo>,</mo><msub><mi>m</mi><mn>1</mn></msub><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mo>&gt;</mo><mi>p</mi><mi>r</mi><mi>i</mi><mi>v</mi><mi>a</mi><mi>t</mi><mi>e</mi><mo>)</mo></mrow><mo>∨</mo><mrow><mo>(</mo><mrow><mo>∃</mo><msub><mi>m</mi><mn>2</mn></msub><mo>∈</mo><msub><mi>T</mi><mn>1</mn></msub><mo>.</mo><mi>m</mi><mi>e</mi><mi>t</mi><mi>h</mi><mi>o</mi><mi>d</mi><mi>s</mi><mo>,</mo><msub><mi>m</mi><mn>2</mn></msub><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mo>&gt;</mo><mi>p</mi><mi>r</mi><mi>i</mi><mi>v</mi><mi>a</mi><mi>t</mi><mi>e</mi><mo>)</mo></mrow><mi>:</mi></mrow></mrow></math></simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mtable><mtr><mtd/><mtd><mspace width="2.0em"/><mstyle mathvariant="bold"><mi>w</mi><mi>i</mi><mi>t</mi><mi>h</mi></mstyle><mi>p</mi><mo>=</mo><mi>m</mi><mo>.</mo><mi>f</mi><mi>p</mi><mi>a</mi><mi>r</mi><mi>s</mi></mtd></mtr><mtr><mtd/><mtd><mspace width="3.0em"/><mo>∧</mo><mstyle mathvariant="bold"><mi>i</mi><mi>f</mi></mstyle><mi> </mi><msub><mi>m</mi><mn>1</mn></msub><mi> </mi><mstyle mathvariant="bold"><mi>e</mi><mi>x</mi><mi>i</mi><mi>s</mi><mi>t</mi><mi>s</mi></mstyle><mi> </mi><msup><mi>p</mi><mi>'</mi></msup><mo>=</mo><msub><mi>m</mi><mn>1</mn></msub><mo>.</mo><mi>f</mi><mi>p</mi><mi>a</mi><mi>r</mi><mi>s</mi><mi> </mi><mstyle mathvariant="bold"><mfenced close=")" open="("><mrow><mi>e</mi><mi>l</mi><mi>s</mi><mi>e</mi><msup><mi>p</mi><mi>'</mi></msup><mo>=</mo><mi>∅</mi></mrow></mfenced></mstyle><mo>,</mo></mtd></mtr><mtr><mtd/><mtd><mspace width="3.0em"/><mo>∧</mo><mstyle mathvariant="bold"><mi>i</mi><mi>f</mi></mstyle><mi> </mi><msub><mi>m</mi><mn>2</mn></msub><mi> </mi><mstyle mathvariant="bold"><mi>e</mi><mi>x</mi><mi>i</mi><mi>s</mi><mi>t</mi><mi>s</mi></mstyle><mi> </mi><mi>p</mi><mi>"</mi><mo>=</mo><msub><mi>m</mi><mn>2</mn></msub><mo>.</mo><mi>f</mi><mi>p</mi><mi>a</mi><mi>r</mi><mi>s</mi><mi> </mi><mstyle mathvariant="bold"><mfenced close=")" open="("><mrow><mi>e</mi><mi>l</mi><mi>s</mi><mi>e</mi><mi>p</mi><mi>"</mi><mo>=</mo><mi>∅</mi></mrow></mfenced></mstyle><mo>,</mo><mstyle mathvariant="bold"><mstyle mathvariant="bold"><mi>W</mi><mi>L</mi><mi>O</mi><mi>G</mi></mstyle></mstyle><mo>|</mo><msup><mi>p</mi><mi>'</mi></msup><mo>|</mo><mo>≤</mo><mo>|</mo><mi>p</mi><mi>"</mi><mo>|</mo><mi>:</mi></mtd></mtr><mtr><mtd/><mtd><mspace width="1.0em"/><mi>m</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><mfenced close="" open="{"><mtable><mtr><mtd><msub><mi>m</mi><mn>1</mn></msub><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi></mtd><mtd><msub><mi>m</mi><mn>1</mn></msub><mo>≠</mo><mi>n</mi><mi>u</mi><mi>l</mi><mi>l</mi><mo>∧</mo><mfenced close=")" open="("><mrow><msub><mi>m</mi><mn>2</mn></msub><mo>=</mo><mi>n</mi><mi>u</mi><mi>l</mi><mi>l</mi><mo>∨</mo><msub><mi>m</mi><mn>2</mn></msub><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><msub><mi>m</mi><mn>1</mn></msub><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi></mrow></mfenced></mtd></mtr><mtr><mtd><msub><mi>m</mi><mn>2</mn></msub><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi></mtd><mtd><mstyle mathvariant="bold"><mi>e</mi><mi>l</mi><mi>s</mi><mi>e</mi></mstyle></mtd></mtr></mtable></mfenced></mtd></mtr><mtr><mtd/><mtd><mo>∧</mo><mi>m</mi><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mo>=</mo><mfenced close="" open="{"><mtable><mtr><mtd><msub><mi>m</mi><mn>1</mn></msub><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi></mtd><mtd><msub><mi>m</mi><mn>1</mn></msub><mo>≠</mo><mi>n</mi><mi>u</mi><mi>l</mi><mi>l</mi><mo>∧</mo><mfenced close=")" open="("><mrow><msub><mi>m</mi><mn>2</mn></msub><mo>=</mo><mi>n</mi><mi>u</mi><mi>l</mi><mi>l</mi><mo>∨</mo><msub><mi>m</mi><mn>2</mn></msub><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mo>≤</mo><msub><mi>m</mi><mn>1</mn></msub><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi></mrow></mfenced></mtd></mtr><mtr><mtd><msub><mi>m</mi><mn>2</mn></msub><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi></mtd><mtd><mstyle mathvariant="bold"><mi>e</mi><mi>l</mi><mi>s</mi><mi>e</mi></mstyle></mtd></mtr></mtable></mfenced></mtd></mtr><mtr><mtd/><mtd><mo>∧</mo><mi>m</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mo>=</mo><mfenced close="" open="{"><mtable><mtr><mtd><msub><mi>m</mi><mn>1</mn></msub><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mi>&amp;</mi><msub><mi>m</mi><mn>2</mn></msub><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi></mtd><mtd><msub><mi>m</mi><mn>1</mn></msub><mo>≠</mo><mi>n</mi><mi>u</mi><mi>l</mi><mi>l</mi><mo>∧</mo><msub><mi>m</mi><mn>2</mn></msub><mo>≠</mo><mi>n</mi><mi>u</mi><mi>l</mi><mi>l</mi></mtd></mtr><mtr><mtd><msub><mi>m</mi><mn>1</mn></msub><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi></mtd><mtd><msub><mi>m</mi><mn>1</mn></msub><mo>≠</mo><mi>n</mi><mi>u</mi><mi>l</mi><mi>l</mi></mtd></mtr><mtr><mtd><msub><mi>m</mi><mn>2</mn></msub><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi></mtd><mtd><mstyle mathvariant="bold"><mi>e</mi><mi>l</mi><mi>s</mi><mi>e</mi></mstyle><mfenced close=")" open="("><mrow><msub><mi>m</mi><mn>2</mn></msub><mo>≠</mo><mi>n</mi><mi>u</mi><mi>l</mi><mi>l</mi></mrow></mfenced></mtd></mtr></mtable></mfenced></mtd></mtr><mtr><mtd/><mtd><mo>∧</mo><mo>∀</mo><mi> </mi><mi>i</mi><mo>&lt;</mo><mo>|</mo><mi>p</mi><mi>"</mi><mo>|</mo><mi>:</mi><msub><mi>p</mi><mi>i</mi></msub><mi> </mi><mstyle mathvariant="bold"><mi>e</mi><mi>x</mi><mi>i</mi><mi>s</mi><mi>t</mi><mi>s</mi><mi>w</mi><mi>i</mi><mi>t</mi><mi>h</mi></mstyle></mtd></mtr><mtr><mtd/><mtd><mspace width="2.0em"/><msub><mi>p</mi><mi>i</mi></msub><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><mfenced close="" open="{"><mtable><mtr><mtd><msub><mrow><mi>p</mi><mi>"</mi></mrow><mi>i</mi></msub><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi></mtd><mtd><mi>i</mi><mo>≥</mo><mo>|</mo><msup><mi>p</mi><mi>'</mi></msup><mo>|</mo><mo>∨</mo><msub><mrow><mi>p</mi><mi>"</mi></mrow><mi>i</mi></msub><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><msub><msup><mi>p</mi><mi>'</mi></msup><mi>i</mi></msub><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi></mtd></mtr><mtr><mtd><msub><msup><mi>p</mi><mi>'</mi></msup><mi>i</mi></msub><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>+</mo><mstyle mathvariant="bold"><mi>"</mi><mi>_</mi><mi>"</mi></mstyle><mo>+</mo><msub><mrow><mi>p</mi><mi>"</mi></mrow><mi>i</mi></msub><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi></mtd><mtd><mstyle mathvariant="bold"><mi>e</mi><mi>l</mi><mi>s</mi><mi>e</mi></mstyle></mtd></mtr></mtable></mfenced></mtd></mtr><mtr><mtd/><mtd><mspace width="2.0em"/><msub><mi>p</mi><mi>i</mi></msub><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mo>=</mo><mfenced close="" open="{"><mtable><mtr><mtd><msub><msup><mi>p</mi><mi>'</mi></msup><mi>i</mi></msub><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mo>|</mo><msub><mrow><mi>p</mi><mi>"</mi></mrow><mi>i</mi></msub><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi></mtd><mtd><mi>i</mi><mo>&lt;</mo><mo>|</mo><msup><mi>p</mi><mi>'</mi></msup><mo>|</mo></mtd></mtr><mtr><mtd><msub><msup><mi>p</mi><mi>'</mi></msup><mrow><mo>|</mo><msup><mi>p</mi><mi>'</mi></msup><mo>|</mo><mo>-</mo><mn>1</mn></mrow></msub><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mo>|</mo><msub><mrow><mi>p</mi><mi>"</mi></mrow><mi>i</mi></msub><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi></mtd><mtd><mi>i</mi><mo>≥</mo><mo>|</mo><msup><mi>p</mi><mi>'</mi></msup><mo>|</mo><mo>∧</mo><msub><msup><mi>p</mi><mi>'</mi></msup><mrow><mo>|</mo><msup><mi>p</mi><mi>'</mi></msup><mo>|</mo><mo>-</mo><mn>1</mn></mrow></msub><mo>.</mo><mi>v</mi><mi>a</mi><mi>r</mi></mtd></mtr><mtr><mtd><msub><mrow><mi>p</mi><mi>"</mi></mrow><mi>i</mi></msub><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi></mtd><mtd><mstyle mathvariant="bold"><mi>e</mi><mi>l</mi><mi>s</mi><mi>e</mi></mstyle></mtd></mtr></mtable></mfenced></mtd></mtr><mtr><mtd/><mtd><mspace width="2.0em"/><msub><mi>p</mi><mi>i</mi></msub><mo>.</mo><mi>o</mi><mi>p</mi><mi>t</mi><mo>=</mo><mfenced close=")" open="("><mrow><mo>∃</mo><mi>k</mi><mo>≤</mo><mi>m</mi><mi>i</mi><mi>n</mi><mfenced close=")" open="("><mrow><mo>|</mo><msup><mi>p</mi><mi>'</mi></msup><mo>|</mo><mo>-</mo><mn>1</mn></mrow><mi>i</mi></mfenced><mi>:</mi><mi>p</mi><msub><mi>'</mi><mi>k</mi></msub><mo>.</mo><mi>o</mi><mi>p</mi><mi>t</mi></mrow></mfenced><mo>∨</mo><mfenced close=")" open="("><mrow><mo>∃</mo><mi>k</mi><mo>≤</mo><mi>i</mi><mi>:</mi><mi>p</mi><msub><mi>"</mi><mi>k</mi></msub><mo>.</mo><mi>o</mi><mi>p</mi><mi>t</mi></mrow></mfenced></mtd></mtr><mtr><mtd/><mtd><mspace width="2.0em"/><msub><mi>p</mi><mi>i</mi></msub><mo>.</mo><mi>v</mi><mi>a</mi><mi>r</mi><mo>=</mo><mfenced close="" open="{"><mtable><mtr><mtd><msub><mi>p</mi><mi>i</mi></msub><mo>.</mo><mi>o</mi><mi>p</mi><mi>t</mi><mo>∨</mo><mfenced close=")" open="("><mrow><msub><msup><mi>p</mi><mi>'</mi></msup><mi>i</mi></msub><mo>.</mo><mi>v</mi><mi>a</mi><mi>r</mi><mo>∨</mo><msub><mrow><mi>p</mi><mi>"</mi></mrow><mi>i</mi></msub><mo>.</mo><mi>v</mi><mi>a</mi><mi>r</mi></mrow></mfenced></mtd><mtd><mi>i</mi><mo>&lt;</mo><mo>|</mo><msup><mi>p</mi><mi>'</mi></msup><mo>|</mo><mo>∧</mo><mi>i</mi><mo>=</mo><mo>|</mo><mi>p</mi><mi>"</mi><mo>|</mo><mo>-</mo><mn>1</mn></mtd></mtr><mtr><mtd><msub><mrow><mi>p</mi><mi>"</mi></mrow><mi>i</mi></msub><mo>.</mo><mi>v</mi><mi>a</mi><mi>r</mi></mtd><mtd><mi>i</mi><mo>≥</mo><mo>|</mo><msup><mi>p</mi><mi>'</mi></msup><mo>|</mo><mo>∧</mo><mi>i</mi><mo>=</mo><mo>|</mo><mi>p</mi><mi>"</mi><mo>|</mo><mo>-</mo><mn>1</mn></mtd></mtr><mtr><mtd><mi>f</mi><mi>a</mi><mi>l</mi><mi>s</mi><mi>e</mi></mtd><mtd><mstyle mathvariant="bold"><mi>e</mi><mi>l</mi><mi>s</mi><mi>e</mi></mstyle></mtd></mtr></mtable></mfenced></mtd></mtr></mtable></math>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∧</mo><mrow><mo>(</mo><mi>l</mi><mo>=</mo><mo>|</mo><msup><mi>p</mi><mi>'</mi></msup><mo>|</mo><mo>=</mo><mo>|</mo><mi>p</mi><mi>"</mi><mo>|</mo><mo>∧</mo><mi>l</mi><mo>&gt;</mo><mn>0</mn><mo>∧</mo><mo>¬</mo><mfenced close=")" open="("><mrow><msub><mi>p</mi><mrow><mi>l</mi><mo>-</mo><mn>1</mn></mrow></msub><mo>.</mo><mi>o</mi><mi>p</mi><mi>t</mi></mrow></mfenced><mo>∧</mo><mo>∃</mo><mi>v</mi><mo>∈</mo><mfenced close="}" open="{"><mrow><mi>p</mi><msub><mi>'</mi><mrow><mi>l</mi><mo>-</mo><mn>1</mn></mrow></msub></mrow><mrow><mi>p</mi><msub><mi>"</mi><mrow><mi>l</mi><mo>-</mo><mn>1</mn></mrow></msub></mrow></mfenced><mi>v</mi><mo>.</mo><mi>v</mi><mi>a</mi><mi>r</mi><mi>:</mi><msub><mi>p</mi><mi>l</mi></msub><mi> </mi><mstyle mathvariant="bold"><mi>e</mi><mi>x</mi><mi>i</mi><mi>s</mi><mi>t</mi><mi>s</mi></mstyle><mspace width="1.0mm"/><mstyle mathvariant="bold"><mi>w</mi><mi>i</mi><mi>t</mi><mi>h</mi></mstyle></mrow></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="2.0em"/><msub><mi>p</mi><mi>l</mi></msub><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><mi>v</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="2.0em"/><msub><mi>p</mi><mi>i</mi></msub><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mo>=</mo><mi>v</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="2.0em"/><msub><mi>p</mi><mi>i</mi></msub><mo>.</mo><mi>o</mi><mi>p</mi><mi>t</mi><mo>=</mo><mi>t</mi><mi>r</mi><mi>u</mi><mi>e</mi></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="2.0em"/><msub><mi>p</mi><mi>i</mi></msub><mo>.</mo><mi>v</mi><mi>a</mi><mi>r</mi><mo>=</mo><mi>t</mi><mi>r</mi><mi>u</mi><mi>e</mi></math></simpara>
+</requirement>
+<simpara>The following table shows how non-method members of intersection types are merged.
+The resulting member type depends on whether the member is being accessed during a read (R) or write (W) operation.
+The type of a field, of a getter or of the parameter of a setter is indicated in brackets.</simpara>
+<table frame="all" rowsep="1" colsep="1">
+<title>Merged Members of Intersections</title>
+<tgroup cols="5">
+<colspec colname="col_1" colwidth="20*"/>
+<colspec colname="col_2" colwidth="20*"/>
+<colspec colname="col_3" colwidth="20*"/>
+<colspec colname="col_4" colwidth="20*"/>
+<colspec colname="col_5" colwidth="20*"/>
+<thead>
+<row>
+<entry align="center" valign="top">Members</entry>
+<entry align="center" valign="top" namest="col_2" nameend="col_3">S=T</entry>
+<entry align="center" valign="top" namest="col_3" nameend="col_4">S≠T</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry align="center" valign="top"></entry>
+<entry align="center" valign="top"><simpara><emphasis role="strong">R</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><emphasis role="strong">W</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><emphasis role="strong">R</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><emphasis role="strong">W</emphasis></simpara></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><emphasis role="strong">field:S   &amp; field:T</emphasis></simpara></entry>
+<entry align="center" valign="top" namest="col_2" nameend="col_3"><simpara>field:S</simpara></entry>
+<entry align="center" valign="top"><simpara>getter:S&amp;T</simpara></entry>
+<entry align="center" valign="top"><simpara>setter:S|T</simpara></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><emphasis role="strong">getter:S  &amp; getter:T</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara>getter:S</simpara></entry>
+<entry align="center" valign="top"><simpara>-</simpara></entry>
+<entry align="center" valign="top"><simpara>getter:S&amp;T</simpara></entry>
+<entry align="center" valign="top"><simpara>-</simpara></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><emphasis role="strong">setter:S  &amp; setter:T</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara>-</simpara></entry>
+<entry align="center" valign="top"><simpara>setter:S</simpara></entry>
+<entry align="center" valign="top"><simpara>-</simpara></entry>
+<entry align="center" valign="top"><simpara>setter:S|T</simpara></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><emphasis role="strong">field:S   &amp; getter:T</emphasis></simpara></entry>
+<entry align="center" valign="top" namest="col_2" nameend="col_3"><simpara>field:S</simpara></entry>
+<entry align="center" valign="top"><simpara>getter:S&amp;T</simpara></entry>
+<entry align="center" valign="top"><simpara>setter:S</simpara></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><emphasis role="strong">field:S   &amp; setter:T</emphasis></simpara></entry>
+<entry align="center" valign="top" namest="col_2" nameend="col_3"><simpara>field:S</simpara></entry>
+<entry align="center" valign="top"><simpara>getter:S</simpara></entry>
+<entry align="center" valign="top"><simpara>setter:S|T</simpara></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><emphasis role="strong">getter:S  &amp; setter:T</emphasis></simpara></entry>
+<entry align="center" valign="top" namest="col_2" nameend="col_3"><simpara>field:S</simpara></entry>
+<entry align="center" valign="top"><simpara>getter:S</simpara></entry>
+<entry align="center" valign="top"><simpara>setter:T</simpara></entry>
+</row>
+</tbody>
+</tgroup>
+</table>
+<section xml:id="_remarks-on-intersection-type-s-methods">
+<title>Remarks on intersection type’s methods:</title>
+<itemizedlist>
+<listitem>
+<simpara>The name of a method’s parameter is only used for error or warning messages and cannot be referenced otherwise.</simpara>
+</listitem>
+<listitem>
+<simpara>The return type of a method is the <emphasis>intersection</emphasis> type of the return types of the merged methods.</simpara>
+</listitem>
+<listitem>
+<simpara>A method parameter’s type is the <emphasis>union</emphasis> type of the merged parameters types.</simpara>
+</listitem>
+</itemizedlist>
+</section>
+</section>
+</section>
+</section>
+<section xml:id="_constructor-and-classifier-type" role="language-n4js">
+<title>Constructor and Classifier Type</title>
+<simpara>A class definition as described in <xref linkend="_classes"/> declares types.
+Often, it is necessary to access these types directly, for example to access staticmembers or for dynamic construction of instances.
+These two use cases are actually slightly different and N4JS provides two different types, one for each use case: constructor and classifier type.<footnote><simpara>The classifier type is, in fact, the <literal>type type</literal> or <literal>metatype</literal> of a type. We use the term classifier type in the specification to avoid the bogus <literal>type type</literal> terminology.</simpara></footnote>
+The constructor is basically the classifier type with the additional possibility to call it via <literal>new</literal> in order to create new instances of the declared type.</simpara>
+<simpara>Both <literal>meta</literal> types are different from Java’s type <literal>Class&lt;T&gt;</literal>, as the latter has a defined set of members, while the N4JS metatypes will have members according to a class definition.
+The concept of constructors as metatypes is similar to ECMAScript 2015 [<link linkend="ECMA15a">ECMA15a(p.14.5)</link>].</simpara>
+<section xml:id="_syntax-3">
+<title>Syntax</title>
+<programlisting language="n4js" linenumbering="unnumbered">ConstructorTypeRef returns ConstructorTypeRef: 'constructor' '{' typeArg = [TypeArgument] '}';
+
+ClassifierTypeRef returns ClassifierTypeRef: 'type' '{' typeArg = [TypeRef] '}';</programlisting>
+</section>
+<section xml:id="_semantics-2">
+<title>Semantics</title>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>Static members of a type <emphasis>T</emphasis> are actually members of the classifier type <literal>type{T}</literal>.</simpara>
+</listitem>
+<listitem>
+<simpara>The keyword <literal>this</literal> in a static method of a type <emphasis>T</emphasis> actually binds to the classifier type <literal>type{T}</literal>.</simpara>
+</listitem>
+<listitem>
+<simpara>The constructor type <literal>constructor</literal><emphasis>{T}</emphasis> is a subtype of the classifier type <literal>type{T}</literal>:</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mo>∀</mo><mi>T</mi><mi>:</mi><mi>c</mi><mi>o</mi><mi>n</mi><mi>s</mi><mi>t</mi><mi>r</mi><mi>u</mi><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi><mfenced close="}" open="{"><mi>T</mi></mfenced><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mfenced close="}" open="{"><mi>T</mi></mfenced></math>
+</listitem>
+<listitem>
+<simpara>If a class <emphasis>B</emphasis> is a subtype (subclass) of a class <emphasis>A</emphasis>, then the classifier type <literal>type{B}</literal> also is a subtype of <literal>type{A}</literal>:</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><mi>B</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>A</mi></mrow><mrow><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mfenced close="}" open="{"><mi>B</mi></mfenced><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mfenced close="}" open="{"><mi>A</mi></mfenced></mrow></mfrac></math>
+</listitem>
+<listitem>
+<simpara>If a class <emphasis>B</emphasis> is a subtype (subclass) of a class <emphasis>A</emphasis>, and if the constructor function of <emphasis>B</emphasis> is a subtype of the constructor function of <emphasis>A</emphasis>, then the
+classifier type <literal>constructor{B}</literal> also is a subtype of <literal>constructor{A}</literal> :</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><mi>B</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>A</mi><mspace width="3.0mm"/><mi>B</mi><mo>.</mo><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>A</mi><mo>.</mo><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi></mrow><mrow><mi>c</mi><mi>o</mi><mi>n</mi><mi>s</mi><mi>t</mi><mi>r</mi><mi>u</mi><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi><mfenced close="}" open="{"><mi>B</mi></mfenced><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>c</mi><mi>o</mi><mi>n</mi><mi>s</mi><mi>t</mi><mi>r</mi><mi>u</mi><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi><mfenced close="}" open="{"><mi>A</mi></mfenced></mrow></mfrac></math>
+<simpara>The subtype relation of the constructor function is defined in <xref linkend="_function-type"/>.
+In the case of the default <literal>N4Object</literal> constructor, the type of the object literal argument depends on required attributes.</simpara>
+<simpara>This subtype relation for the constructor type is enforced if the constructor of the super class is marked as <literal>final</literal>, see <xref linkend="_constructor-and-classifier-type"/> for details.</simpara>
+</listitem>
+<listitem>
+<simpara>The type of a classifier declaration or classifier expression is the constructor of that class:</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><mi>μ</mi><mfenced close=")" open="("><mi>C</mi></mfenced><mo>∈</mo><mfenced close="}" open="{"><mrow><mi>c</mi><mi>l</mi><mi>a</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>f</mi><mi>i</mi><mi>e</mi><mi>r</mi><mi>D</mi><mi>e</mi><mi>f</mi><mi>i</mi><mi>n</mi><mi>i</mi><mi>t</mi><mi>i</mi><mi>o</mi><mi>n</mi></mrow></mfenced></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mi>C</mi><mi>:</mi><mstyle mathvariant="monospace"><mtext>constructor[C]</mtext></mstyle></mrow></mfrac></math>
+</listitem>
+<listitem>
+<simpara>A class cannot be called as a function in ECMAScript.
+Thus, the constructor and type type are only subtype of <literal>Object</literal>:</simpara>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∀</mo><mi>T</mi><mi>:</mi></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mstyle mathvariant="monospace"><mtext>constructor</mtext></mstyle><mfenced close="}" open="{"><mstyle mathvariant="monospace"><mtext>T</mtext></mstyle></mfenced><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mstyle mathvariant="monospace"><mtext>Object</mtext></mstyle></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mstyle mathvariant="monospace"><mtext>type</mtext></mstyle><mfenced close="}" open="{"><mstyle mathvariant="monospace"><mtext>T</mtext></mstyle></mfenced><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mstyle mathvariant="monospace"><mtext>Object</mtext></mstyle></math></simpara>
+</listitem>
+<listitem>
+<simpara>If the type argument of the constructor is not a declared type (i.e., a wildcard or a type variable with bounds), the constructor cannot be used in a new expression.
+Thus, the constructor function signature becomes irrelevant for subtype checking.
+In that case, the following rules apply:</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mtable><mtr><mtd><mfrac><mrow><mi>S</mi><mo>.</mo><mi>u</mi><mi>p</mi><mi>p</mi><mi>e</mi><mi>r</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>T</mi><mo>.</mo><mi>u</mi><mi>p</mi><mi>p</mi><mi>e</mi><mi>r</mi><mspace width="3.0mm"/><mi>T</mi><mo>.</mo><mi>l</mi><mi>o</mi><mi>w</mi><mi>e</mi><mi>r</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>S</mi><mo>.</mo><mi>l</mi><mi>o</mi><mi>w</mi><mi>e</mi><mi>r</mi><mspace width="3.0mm"/><mi>μ</mi><mfenced close=")" open="("><mi>T</mi></mfenced><mo>≠</mo><mstyle mathvariant="monospace"><mtext>DeclaredTypeWithAccessModifier</mtext></mstyle></mrow><mrow><mstyle mathvariant="monospace"><mtext>constructor</mtext><mtext>S</mtext></mstyle><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mstyle mathvariant="monospace"><mtext>constructor</mtext><mtext>T</mtext></mstyle></mrow></mfrac></mtd></mtr></mtable></math>
+<simpara>Note that this is only true for the right hand side of the subtyping rule.
+A constructor type with a wildcard is never a subtype of a constructor type without a wildcard.</simpara>
+</listitem>
+</orderedlist>
+<simpara>The figure <xref linkend="cdConstructorClassifierType"/> shows the subtype relations defined by the preceding rules.</simpara>
+<figure xml:id="cdConstructorClassifierType">
+<title>Classifier and Constructor Type Subtype Relations</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/04_types/fig/cdConstructorClassifierType.svg" width="60%" scalefit="1" align="center"/>
+</imageobject>
+<textobject><phrase>cdConstructorClassifierType</phrase></textobject>
+</mediaobject>
+</figure>
+<simpara>Consequences:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>Overriding of static methods is possible and by using the constructor or classifier type, polymorphism for static methods is possible as well.</simpara>
+<example xml:id="_polymorphism-and-static-methods">
+<title>Static Polymorphism</title>
+<programlisting language="n4js" linenumbering="unnumbered">class A {
+    static foo(): string { return "A"; }
+    static bar(): string { return this.foo(); }
+}
+class B extends A {
+    @Override
+    static foo(): string { return "B"; }
+}
+
+A.bar(); // will return "A"
+B.bar(); // will return "B", as foo() is called polymorphical</programlisting>
+</example>
+</listitem>
+<listitem>
+<simpara>It is even possible to refer to the constructor of an abstract class.
+The abstract class itself cannot provide this constructor (it only provides a type..), that is to say only concrete subclasses can provide constructors compatible to the constructor.</simpara>
+<example>
+<title>Constructor of Abstract Class</title>
+<programlisting language="n4js" linenumbering="unnumbered">abstract class A {}
+class B extends A {}
+function f(ctor: constructor{A}): A { return new ctor(); }
+
+f(A); // not working: type{A} is not a subtype of constructor{A}.
+f(B); // ok</programlisting>
+</example>
+</listitem>
+</itemizedlist>
+<simpara>Allowing wildcards on constructor type references has pragmatic reasons.
+The usage of constructor references usually indicates very dynamic scenarios.
+In some of these scenarios, e.g., in case of dynamic creation of objects in the context of generic testing or injectors, arbitrary constructors may be used.
+Of course, it won’t be possible to check the correct new expression call in these cases – and using new expressions is prevented by N4JS if the constructor reference contains a wildcard.
+But other constraints, implemented by the client logic, may guarantee correct instantiation via more dynamic constructors, for example via the ECMAScript 2015 reflection API.
+In order to simplify these scenarios and preventing the use of <literal>any</literal>, wildcards are supported in constructors. Since a constructor with a wildcard cannot be used
+in a new expression anyway, using a classifier type is usually better than using a constructor type with wildcard.</simpara>
+<simpara>Using wildcards on classifier types would have the same meaning as using the upper bound directly.
+That is, a type reference <literal>type{? extends C}</literal> can simply be replaced with <literal>type{c}</literal>, and <literal>type{?}</literal> with <literal>type{any}</literal>.</simpara>
+<simpara>To conclude this chapter, let us compare the different types introduced above depending on whether they are used with wildcards or not:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>having a value of type <literal>constructor{C}</literal>, we know we have</simpara>
+<itemizedlist>
+<listitem>
+<simpara>a constructor function of <literal>{C}</literal> or a subclass of <literal>{C}</literal>,</simpara>
+</listitem>
+<listitem>
+<simpara>that can be used for instantiation (i.e. the represented class is not abstract),</simpara>
+</listitem>
+<listitem>
+<simpara>that has a signature compatible to the owned or inherited constructor of <literal>{C}</literal>.</simpara>
+<simpara>This means we have the constructor function of class <literal>{C}</literal> (but only if is non-abstract) or the constructor function of any non-abstract
+subclass of <literal>{C}</literal> with an override compatible signature to that of <literal>{C}</literal>'s constructor function.</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+<listitem>
+<simpara>having a value of type <literal>constructor{? extends C}</literal>, we know we have</simpara>
+<itemizedlist>
+<listitem>
+<simpara>a constructor function of <literal>{C}</literal> or a subclass of <literal>{C}</literal>,</simpara>
+</listitem>
+<listitem>
+<simpara>that can be used for instantiation (i.e. the represented class is not abstract).</simpara>
+<simpara>So, same situation as before except that we know nothing about the constructor function’s signature.
+However, if <literal>{C}</literal> has a covariant constructor, cf. <xref linkend="_covariant-constructors"/>, we can still conclude that we have an override compatible
+constructor function to that of <literal>{C}</literal>, because classes with covariant constructors enforce all their subclasses to have override compatible constructors.</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+<listitem>
+<simpara>have a value of type <literal>type{? extends C}</literal> or <literal>type{C}</literal> (the two types are equivalent), we know we have:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>an object representing a type (often constructor functions are used for this, e.g. in the case of classes, but could also be a plain object, e.g. in the case of interfaces),</simpara>
+</listitem>
+<listitem>
+<simpara>that represents type <literal>{C}</literal> or a subtype thereof,</simpara>
+</listitem>
+<listitem>
+<simpara>that cannot be used for instantiation (e.g. could be the constructor function of an abstract class, the object representing an interface, etc.).</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+</orderedlist>
+<simpara>Slightly simplified, we can say that in the first above case we can always use the value for creating an instance with <literal>new</literal>, in the second case only if the
+referenced type has a covariant constructor, cf. <xref linkend="_covariant-constructors"/>, and never in the third case.</simpara>
+</section>
+<section xml:id="_constructors-and-prototypes-in-ecmascript-2015">
+<title>Constructors and Prototypes in ECMAScript 2015</title>
+<simpara><xref linkend="fig-constructors-and-prototypes"/> for two classes A and B in ECMAScript 2015 shows the constructors, prototypes, and the relations between them for the ECMAScript 2015
+code shown in <xref linkend="ex-constructors-and-prototypes"/>.</simpara>
+<example xml:id="ex-constructors-and-prototypes">
+<title>Constructors and Prototypes</title>
+<programlisting language="javascript" linenumbering="unnumbered">class A {}
+class B extends A {}
+
+var b = new B();</programlisting>
+</example>
+<note>
+<simpara><xref linkend="fig-constructors-and-prototypes"/> shows plain ECMAScript 2015 only.
+Also note that <literal>A</literal> is defined without an <literal>extends</literal> clause, which is what ECMAScript 2015 calls a <emphasis>base class</emphasis> (as opposed to a <emphasis>derived class</emphasis>).
+The constructor of a base class always has Function.prototype as its prototype.
+If we had defined <literal>A</literal> as <literal>class A extends Object {}</literal> in the listing above, then the constructor of <literal>A</literal> would have Object’s constructor as its prototype
+(depicted in as a dashed red arrow), which would make a more consistent overall picture.</simpara>
+</note>
+<figure xml:id="fig-constructors-and-prototypes">
+<title>Constructors and prototypes for two classes A and B in ECMAScript 2015 (not N4JS!)</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/04_types/fig/ctorsProtosInES6.svg" align="center"/>
+</imageobject>
+<textobject><phrase>ctorsProtosInES6</phrase></textobject>
+</mediaobject>
+</figure>
+<simpara>Base classes in the above sense are not available in N4JS.
+If an N4JS class does not provide an <literal>extends</literal> clause, it will implicitly inherit from built-in class <literal>N4Object</literal>,
+if it provides an <literal>extends</literal> clause stating <literal>Object</literal> as its super type, then it corresponds to what is shown in <xref linkend="fig-constructors-and-prototypes"/> with the red dashed arrow.</simpara>
+</section>
+</section>
+<section xml:id="_this-type" role="language-n4js">
+<title>This Type</title>
+<simpara>The <literal>this</literal> keyword may represent either a <literal>this</literal> literal (cf. <xref linkend="ex:this-keyword-and-type-in-instance-and-static-context"/>) or may refer to the <literal>this</literal> type.
+In this section, we describe the latter case.</simpara>
+<simpara>Typical use cases of the <literal>this</literal> type include:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>declaring the return type of instance methods</simpara>
+</listitem>
+<listitem>
+<simpara>declaring the return type of static methods</simpara>
+</listitem>
+<listitem>
+<simpara>as formal parameter type of constructors in conjunction with use-site structural typing</simpara>
+</listitem>
+<listitem>
+<simpara>the parameter type of a function type expression, which appears as type of a method parameter</simpara>
+</listitem>
+<listitem>
+<simpara>the parameter type in a return type expression (<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi></math><literal>{this}</literal>,<literal>constructor{this}</literal>)</simpara>
+</listitem>
+<listitem>
+<simpara>an existential type argument inside a return type expression for methods (e.g.<literal>ArrayList&lt;? extends this&gt; method(){&#8230;&#8203;}</literal>)</simpara>
+</listitem>
+</itemizedlist>
+<simpara>The precise rule where it may appear is given below in <xref linkend="Req-IDE-37"/>.</simpara>
+<simpara>The <literal>this</literal> type is similar to a type variable, and it is bound to the declared or inferred type of the receiver.
+If it is used as return type, all return statements of the methods must return the <literal>this</literal> keyword or a variable value implicitly inferred to a <literal>this</literal> type (e.g. <literal>var x = this; return x;</literal>).</simpara>
+<formalpara>
+<title>Simple This Type</title>
+<para>
+<programlisting language="n4js" linenumbering="unnumbered">class A {
+    f(): this {
+        return this;
+    }
+})
+class B extends A {}
+
+var a: A; var b: B;
+a.f(); // returns something with the type of A
+b.f(); // returns something with the type of B</programlisting>
+</para>
+</formalpara>
+<simpara><literal>this</literal> can be thought of as a type variable which is implicitly substituted with the declaring class (i.e. this type used in a class <literal>{A}</literal> actually means <literal>&lt;? extends A&gt;</literal>).</simpara>
+<section xml:id="this-type-syntax">
+<title>Syntax</title>
+<programlisting language="xtext" linenumbering="unnumbered">ThisTypeRef returns ThisTypeRef:
+    ThisTypeRefNominal | ThisTypeRefStructural;
+
+ThisTypeRefNominal returns ThisTypeRefNominal:
+    {ThisTypeRefNominal} 'this'
+;
+
+ThisTypeRefStructural  returns ThisTypeRefStructural:
+        typingStrategy=TypingStrategyUseSiteOperator
+        'this'
+        ('with' '{' ownedStructuralMembers+=TStructMember* '}')?
+;</programlisting>
+<simpara>The keyword <literal>this</literal> and the type expression <literal>this</literal> look similar, however they can refer to different types.
+The type always refers to the type of instances of a class.
+The <literal>this</literal> keyword refers to the type of instances of the class in case of instance methods, but to the classifier the of the class in case of static methods.
+See <xref linkend="_this-keyword"/> for details.</simpara>
+<example xml:id="ex:this-keyword-and-type-in-instance-and-static-context">
+<title>This keyword and type in instance and static context</title>
+<simpara>Note that the following code is not working, because some usages below are
+not valid in N4JS. This is only to demonstrate the types.</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">class C {
+    instanceMethod() {
+        var c: this = this;
+    }
+    static staticMethod() {
+        var C: type{this} = this;
+    }
+}</programlisting>
+</example>
+<simpara>Structural typing and additional members in structural referenced types is described in <xref linkend="_structural-typing"/>.</simpara>
+</section>
+<section xml:id="this-keyword-semantics">
+<title>Semantics</title>
+<requirement xml:id="IDE-37">
+<title>This Type</title>
+<simpara>
+<anchor xml:id="Req-IDE-37" xreflabel="[Req-IDE-37]"/>
+<emphasis role="strong">Requirement: IDE-37:</emphasis>
+<link linkend="Req-IDE-37">This Type</link> (ver. 1)</simpara>
+    <simpara>
+</simpara>
+<itemizedlist>
+<listitem>
+<simpara><literal>this</literal> used in the context of a class is actually inferred to an existential type <literal>? extends A</literal> inside the class itself.</simpara>
+</listitem>
+<listitem>
+<simpara>the <literal>this</literal> type may only be used</simpara>
+<itemizedlist>
+<listitem>
+<simpara>as the type of a formal parameter of a constructor, if and only if combined with use-site structural typing.</simpara>
+</listitem>
+<listitem>
+<simpara>at covariant positions within member declarations, except for static members of interfaces.</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+</itemizedlist>
+</requirement>
+<simpara>Remarks</simpara>
+<itemizedlist>
+<listitem>
+<simpara>Due to the function subtype relation and constraints on overriding methods (in which the overriding method has to be a subtype of the overridden method),
+it is not possible to use the <literal>this</literal> type in formal parameters but only as return type. The following listing demonstrates that problem:</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">class A {
+    bar(x: this): void { ... } // error
+    // virtually defines: bar(x: A): void
+}
+class B extends A {
+    // virtually defines: bar(x: B): void
+}</programlisting>
+<simpara>As the <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>t</mi><mi>h</mi><mi>i</mi><mi>s</mi></math> type is replaced similar to a type variable, the virtually defined method <literal>bar</literal> in is not override compatible with <literal>bar</literal> in <literal>A</literal>.</simpara>
+<simpara>In case of constructors, this problem does not occur because a subclass constructor does not need to be override compatible with the constructor of the super class.
+Using <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>t</mi><mi>h</mi><mi>i</mi><mi>s</mi></math> as the type of a constructor’s parameter, however, would mean that you can only create an instance of the class if you already have
+an instance (considering that due to the lack of method overloading a class can have only a single constructor), making creation of the first instance impossible.
+Therefore, <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>t</mi><mi>h</mi><mi>i</mi><mi>s</mi></math> is also disallowed as the type of a constructor’s parameter.</simpara>
+</listitem>
+<listitem>
+<simpara>The difference between the type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>t</mi><mi>h</mi><mi>i</mi><mi>s</mi></math> and the keyword <literal>this</literal> is when and how theactual type is set:
+the actual type of the <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>t</mi><mi>h</mi><mi>i</mi><mi>s</mi></math> type is computed at compile(or validation) time and is always the containing type (of the member in which the type expression is used)
+or a subtype of that type – this isnot a heuristic, this is so by definition.
+In contrast, the actual typeof the keyword <literal>this</literal> is only available at runtime, while the type used at compilation time is only a heuristically-computed type, in other words,a good guess.</simpara>
+</listitem>
+<listitem>
+<simpara>The value of the <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>t</mi><mi>h</mi><mi>i</mi><mi>s</mi></math> type is, in fact, not influenced by any <literal>@This</literal> annotations.
+Instead of using <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>t</mi><mi>h</mi><mi>i</mi><mi>s</mi></math> in these cases, the type expressions in the <literal>@This</literal> annotations can be used.</simpara>
+</listitem>
+<listitem>
+<simpara>The <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>t</mi><mi>h</mi><mi>i</mi><mi>s</mi></math> type is always bound to the instance-type regardless of the context it occurs in (non-static or static).
+To refer to the this-classifier (static type) the construct <literal>type{this}</literal> is used.</simpara>
+</listitem>
+</itemizedlist>
+<simpara><?asciidoc-pagebreak?></simpara>
+<example>
+<title>This type in function-type-expression</title>
+<programlisting language="n4js" linenumbering="unnumbered">class A {
+    alive: boolean = true;
+    methodA(func: {function(this)}): string {
+       func(this);   // applying the passed-in function
+       return "done";
+    }
+}</programlisting>
+</example>
+<simpara>The use of <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>t</mi><mi>h</mi><mi>i</mi><mi>s</mi></math> type is limited to situations where it cannot be referred in mixed co- and contra-variant ways.
+In the following example the problem is sketched up. <footnote><simpara>The phenomenon is described in IDEBUG-263</simpara></footnote></simpara>
+<example>
+<title>Problems with this type and type arguments</title>
+<programlisting language="n4js" linenumbering="unnumbered">// Non-working example, see problem in line 15.
+class M&lt;V&gt; {  public value: V;  }
+class A {
+    public store: M&lt;{function(this)}&gt;; // usually not allowed, but let's assume it would be possible----
+}
+class B extends A { public x=0; } // type of store is M&lt;{function(B)}&gt;
+
+var funcA = function(a: A) {/*...something with a...*/}
+var funcB = function(b: B) { console.log(b.x); }
+var a: A = new A();  var b: B = new B();
+b.store.value = funcA  // OK, since {function(A)} &lt;: {function(B)}
+b.store.value = funcB  // OK.
+
+var a2: A = b; // OK, since B is a subtype of A
+a2.store.value( a ) // RUNTIME ERROR, the types are all correct, but remember b.store.value was assigned to funcB, which can only handle subtypes of B!</programlisting>
+</example>
+</section>
+</section>
+<section xml:id="_enums" role="language-n4js">
+<title>Enums</title>
+<simpara>Enums are an ordered set of literals.
+Although enums are not true classes, they come with built-in methods for accessing value, name and type name of the enum.</simpara>
+<simpara>In N4JS, two flavours of enumerations are distinguished: ordinary enums (N4JS) and string based enums.
+Ordinary enums (or in short, enums) are used while programming in N4JS.
+String based enums are introduced to access enumerations derived from standards, mainly developed by the W3C, in order to access the closed set of string literals defined in webIDL syntax.</simpara>
+<section xml:id="_enums-n4js">
+<title>Enums (N4JS)</title>
+<simpara>Definition and usage of an enumeration:</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">// assume this file to be contained in a package "myPackage"
+enum Color {
+    RED, GREEN, BLUE
+}
+
+enum Country {
+    DE : "276",
+    US : "840",
+    TR : "792"
+}
+
+var red: Color = Color.RED;
+var us: Country = Country.US;
+
+console.log(red.name); // --&gt; RED
+console.log(red.value); // --&gt; RED
+console.log(red.n4class.fqn); // --&gt; myPackage.Color
+console.log(red.toString()); // --&gt; RED
+
+console.log(us.name); // --&gt; US
+console.log(us.value); // --&gt; 840
+console.log(us.n4classfqn); // --&gt; myPackage.Country
+console.log(us.toString()); // --&gt; 840</programlisting>
+<section xml:id="enums-syntax">
+<title>Syntax</title>
+<programlisting language="xtext" linenumbering="unnumbered">N4EnumDeclaration &lt;Yield&gt;:
+	=&gt;(	{N4EnumDeclaration}
+		(declaredModifiers+=N4Modifier)*
+		'enum' name=BindingIdentifier&lt;Yield&gt;? )
+	'{'
+		(literals+=N4EnumLiteral (',' literals+=N4EnumLiteral)*)?
+	'}';
+
+N4EnumLiteral: name=IdentifierName (':' value=STRING)?;</programlisting>
+</section>
+<section xml:id="enums-semantics" role="language-n4js">
+<title>Semantics</title>
+<simpara>The enum declaration <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>E</mi></math> is of type <literal>type{E}</literal> and every enumeration is implicitly derived from <literal>N4Enum</literal>.
+There are similarities to other languages such as Java, for example, where the literals of an enum are treated as final static fields with the type
+of the enumeration and the concrete enumeration provides specific static methods including the literals.
+This leads to the following typing rules:</simpara>
+<requirement xml:id="IDE-38">
+<title>Enum Type Rules</title>
+<simpara>
+<anchor xml:id="Req-IDE-38" xreflabel="[Req-IDE-38]"/>
+<emphasis role="strong">Requirement: IDE-38:</emphasis>
+<link linkend="Req-IDE-38">Enum Type Rules</link> (ver. 1)</simpara>
+    <simpara>
+
+For a given enumeration declaration <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>E</mi></math> with literals <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>L</mi></math>, the following type rules are defined:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>Every enumeration <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>E</mi></math> is a subtype of the base type <literal>N4Enum</literal>:</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow/><mrow><mi>Γ</mi><mo>⊢</mo><mi>E</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>N</mi><mn>4</mn><mi>E</mi><mi>n</mi><mi>u</mi><mi>m</mi></mrow></mfrac><mrow/></math>
+<simpara>which itself is a subtype of <literal>Object</literal>:</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow/><mrow><mi>N</mi><mn>4</mn><mi>E</mi><mi>n</mi><mi>u</mi><mi>m</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>O</mi><mi>b</mi><mi>j</mi><mi>e</mi><mi>c</mi><mi>t</mi></mrow></mfrac></math>
+</listitem>
+<listitem>
+<simpara>Every literal <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>L</mi></math> of an enumeration <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>E</mi></math> is
+of the type of the enumeration:</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><mi>L</mi><mo>∈</mo><mi>E</mi><mo>.</mo><mi>l</mi><mi>i</mi><mi>t</mi><mi>e</mi><mi>r</mi><mi>a</mi><mi>l</mi><mi>s</mi></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mi>L</mi><mi>:</mi><mi>E</mi></mrow></mfrac></math>
+</listitem>
+</orderedlist>
+<simpara>This means that every literal is a subtype of <literal>N4Enum</literal> and <literal>Object</literal>:</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><mi>L</mi><mo>∈</mo><mi>E</mi><mo>.</mo><mi>l</mi><mi>i</mi><mi>t</mi><mi>e</mi><mi>r</mi><mi>a</mi><mi>l</mi><mi>s</mi></mrow><mrow><mi>L</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>N</mi><mn>4</mn><mi>E</mi><mi>n</mi><mi>u</mi><mi>m</mi><mo>∧</mo><mi>L</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>O</mi><mi>b</mi><mi>j</mi><mi>e</mi><mi>c</mi><mi>t</mi></mrow></mfrac></math>
+<simpara>The base enumeration type <literal>N4Enum</literal> is defined as follows:</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">/**
+ * Base class for all enumeration, literals are assumed to be static constant fields of concrete subclasses.
+ */
+public object N4Enum {
+
+    /**
+     * Returns the name of a concrete literal
+     */
+    public get name(): string
+
+    /**
+     * Returns the value of a concrete literal. If no value is
+     * explicitly set, it is similar to the name.
+     */
+    public get value(): string
+
+    /**
+     * Returns a string representation of a concrete literal, it returns
+     * the same result as value()
+     */
+     public toString(): string
+
+    /**
+     * Returns the meta class object of this enum literal for reflection.
+     * The very same meta class object can be retrieved from the enumeration type directly.
+     */
+    public static get n4type(): N4EnumType
+
+    //IDE-785 this as return type in static
+
+    /**
+     * Returns array of concrete enum literals
+     */
+    public static get literals(): Array&lt;? extends this&gt;
+
+    /**
+     * Returns concrete enum literal that matches provided name,
+     * if no match found returns undefined.
+     */
+    public static findLiteralByName(name: string): this
+
+    /**
+     * Returns concrete enum literal that matches provided value,
+     * if no match found returns undefined.
+     */
+    public static findLiteralByValue (value: string): this
+}</programlisting>
+</requirement>
+<requirement xml:id="IDE-39">
+<title>Unique literal names</title>
+<simpara>
+<anchor xml:id="Req-IDE-39" xreflabel="[Req-IDE-39]"/>
+<emphasis role="strong">Requirement: IDE-39:</emphasis>
+<link linkend="Req-IDE-39">Unique literal names</link> (ver. 1)</simpara>
+    <simpara>
+
+* <math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∀</mo><mi>i</mi><mo>,</mo><mi>j</mi><mi>:</mi><mi>l</mi><mi>i</mi><mi>t</mi><mi>e</mi><mi>r</mi><mi>a</mi><mi>l</mi><mi>s</mi><mfenced close="]" open="["><mi>i</mi></mfenced><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><mi>l</mi><mi>i</mi><mi>t</mi><mi>e</mi><mi>r</mi><mi>a</mi><mi>l</mi><mi>s</mi><mfenced close="]" open="["><mi>j</mi></mfenced><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>⇔</mo><mi>i</mi><mo>=</mo><mi>j</mi></math></simpara>
+<simpara>Literal names have to be unique.</simpara>
+</requirement>
+<requirement xml:id="IDE-40">
+<title>Enum Literals are Singletons</title>
+<simpara>
+<anchor xml:id="Req-IDE-40" xreflabel="[Req-IDE-40]"/>
+<emphasis role="strong">Requirement: IDE-40:</emphasis>
+<link linkend="Req-IDE-40">Enum Literals are Singletons</link> (ver. 1)</simpara>
+    <simpara>
+
+Enum literals are singletons:</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mo>∀</mo><msub><mi>e</mi><mn>1</mn></msub><mo>,</mo><msub><mi>e</mi><mn>2</mn></msub><mo>,</mo><mi>μ</mi><mfenced close=")" open="("><msub><mi>e</mi><mn>1</mn></msub></mfenced><mo>=</mo><mi>μ</mi><mfenced close=")" open="("><msub><mi>e</mi><mn>2</mn></msub></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>N4EnumLiteral</mtext></mstyle><mo>∧</mo><mi>Γ</mi><mo>⊢</mo><msub><mi>e</mi><mn>1</mn></msub><mo>=</mo><mi>Γ</mi><mo>⊢</mo><msub><mi>e</mi><mn>2</mn></msub><mi>:</mi><msub><mi>e</mi><mn>1</mn></msub><mo>=</mo><mo>=</mo><msub><mi>e</mi><mn>2</mn></msub><mo>⇔</mo><msub><mi>e</mi><mn>1</mn></msub><mo>=</mo><mo>=</mo><mo>=</mo><msub><mi>e</mi><mn>2</mn></msub></math>
+</requirement>
+<example>
+<title>Enumeration List</title>
+<simpara>Due to the common base type <literal>N4Enum</literal> it is possible to define generics accepting only enumeration, as shown in this example:</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">enum Color { R, G, B}
+
+class EList&lt;T extends N4Enum&gt; {
+    add(t: T) {}
+    get(): T { return null; }
+}
+
+var colors: EList&lt;Color&gt;;
+colors.add(Color.R);
+var c: Color = colors.get();</programlisting>
+</example>
+</section>
+</section>
+<section xml:id="_string-based-enums">
+<title>String-Based Enums</title>
+<simpara>In current web standards [<link linkend="W3C:Steen:14:XL">W3C:Steen:14:XL</link>], definitions of enumerations are often given in webIDL syntax.
+While the webIDL-definition assembles a set of unique string literals as a named enum-entity, the language binding to ECMAScript refers to the usage of the members of these enumerations only.
+Hence, if an element of an enumeration is stored in a variable or field, passed as a parameter into a method or function or given back as a result, the actual type in JavaScript will be <literal>string</literal>.
+To provide the N4JS user with some validations regarding the validity of a statement at compile time, a special kind of subtypes of <literal>string</literal> are introduced: the string-based enum using the <literal>@StringBased</literal> annotation.
+(See also other string-based types like <literal>typename&lt;T&gt;</literal> <literal>pathSelector&lt;T&gt;</literal> and <literal>i18nKey</literal> in <xref linkend="_primitive-pathselector-and-i18nkey"/>.)</simpara>
+<simpara>String-based enums do not have any kind of runtime representation; instead, the transpiler will replace each reference to a literal of a string-based enum by a corresponding string literal in the output code.
+Furthermore, no meta-information is available for string-based enums, i.e. the <literal>n4type</literal> property is not available.
+The only exception is the static getter <literal>literals</literal>: it is available also for string-based enums and has the same meaning.
+In case of string-based enums, however, there won’t be a getter used at runtime; instead, the transpiler replaces every read access to this getter by an array literal containing a string literal for each of the enum’s literals.</simpara>
+<requirement xml:id="IDE-41">
+<title>String-Based Enum Type Rules</title>
+<simpara>
+<anchor xml:id="Req-IDE-41" xreflabel="[Req-IDE-41]"/>
+<emphasis role="strong">Requirement: IDE-41:</emphasis>
+<link linkend="Req-IDE-41">String-Based Enum Type Rules</link> (ver. 1)</simpara>
+    <simpara>
+</simpara>
+<simpara>For a string-based enum declaration <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>E</mi><mi>S</mi></msub></math> with literals <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>L</mi><mi>S</mi></msub></math> the following type rules are defined:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>Every string-based enumeration <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>E</mi><mi>S</mi></msub></math> is a subtype of the base type <literal>N4StringBasedEnum</literal>:</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow/><mrow><mi>Γ</mi><mo>⊢</mo><mstyle mathvariant="monospace"><mtext>type</mtext></mstyle><mfenced close="}" open="{"><msub><mi>E</mi><mi>S</mi></msub></mfenced><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mstyle mathvariant="monospace"><mtext>N4StringBasedEnum</mtext></mstyle></mrow></mfrac><mrow/></math>
+<simpara>which itself is not related to the standard enumeration type <literal>N4Enum</literal></simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mtable><mtr><mtd><mfrac><mrow/><mrow><mstyle mathvariant="monospace"><mtext>N4StringBasedEnum</mtext></mstyle><mspace width="1.0mm"/><mo>≮</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mstyle mathvariant="monospace"><mtext>N4Enum</mtext></mstyle></mrow></mfrac></mtd></mtr><mtr><mtd><mfrac><mrow/><mrow><mstyle mathvariant="monospace"><mtext>N4Enum</mtext></mstyle><mspace width="1.0mm"/><mo>≮</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mstyle mathvariant="monospace"><mtext>N4StringBasedEnum</mtext></mstyle></mrow></mfrac></mtd></mtr></mtable></math>
+</listitem>
+<listitem>
+<simpara><literal>N4StringBasedEnum</literal> is a subtype of <literal>string</literal></simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mtable><mtr><mtd><mfrac><mrow/><mrow><mstyle mathvariant="monospace"><mtext>N4StringBasedEnum</mtext></mstyle><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mstyle mathvariant="monospace"><mtext>string</mtext></mstyle></mrow></mfrac></mtd></mtr></mtable></math>
+</listitem>
+<listitem>
+<simpara>Each literal in <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>L</mi><mi>S</mi></msub></math> of a string-based enumeration
+<math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>E</mi><mi>S</mi></msub></math> is of the type of the string-based enumeration.</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><mi>l</mi><mo>∈</mo><msub><mi>E</mi><mi>S</mi></msub><mo>.</mo><msub><mi>L</mi><mi>S</mi></msub></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mi>l</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><msub><mi>E</mi><mi>S</mi></msub></mrow></mfrac></math>
+</listitem>
+<listitem>
+<simpara><xref linkend="Req-IDE-39"/> also applies for <literal>N4StringBasedEnum</literal>.</simpara>
+</listitem>
+<listitem>
+<simpara><xref linkend="Req-IDE-40"/> also applies for <literal>N4StringBasedEnum</literal>.</simpara>
+</listitem>
+<listitem>
+<simpara>References to string-based enums may only be used in the following places:</simpara>
+<orderedlist numeration="loweralpha">
+<listitem>
+<simpara>in type annotations</simpara>
+</listitem>
+<listitem>
+<simpara>in property access expressions to refer to one of the enum’s literals</simpara>
+</listitem>
+<listitem>
+<simpara>in property access expressions to read from the static getter <literal>literals</literal></simpara>
+<simpara>In particular, it is invalid to use the type of a string-based enum as a
+value, as in</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">    @StringBased enum Color { RED, GREEN, BLUE }
+    var c = Color;</programlisting>
+</listitem>
+</orderedlist>
+</listitem>
+</orderedlist>
+<example>
+<title>WebIDL example</title>
+<formalpara>
+<title>Gecko-Engine webIDL XMLHttpRequestResponseType as taken from [<link linkend="W3C:Steen:14:XL">W3C:Steen:14:XL</link>]</title>
+<para>
+<programlisting language="n4js" linenumbering="unnumbered">enum XMLHttpRequestResponseType {
+  "",
+  "arraybuffer",
+  "blob",
+  "document",
+  "json",
+  "text" //, ... and some mozilla-specific additions
+}</programlisting>
+</para>
+</formalpara>
+<simpara>Compatible Definition of this Enumeration in N4JS, provided through a
+runtime-library definition:</simpara>
+<formalpara>
+<title>File in source-folder: w3c/dom/XMLHttpRequestResponseType.n4js</title>
+<para>
+<programlisting language="n4js" linenumbering="unnumbered">@StringBased enum XMLHttpRequestResponseType {
+  vacant : "",
+  arrayBuffer : "arraybuffer",
+  blob : "blob",
+  document : "document",
+  json : "json",
+  text : "text"
+ }</programlisting>
+</para>
+</formalpara>
+<simpara>Usage of the enumeration in the definition files of the runtime-library.
+Note the explicit import of the enumeration.</simpara>
+<formalpara>
+<title>XMLHttpRequestResponse.n4jsd</title>
+<para>
+<programlisting language="n4js" linenumbering="unnumbered">@@ProvidedByRuntime
+import XMLHttpRequestResponseType from "w3c/dom/XMLHttpRequestResponseType";
+@Global
+export external public class XMLHttpRequestResponse extends XMLHttpRequestEventTarget {
+  // ...
+  // Setter Throws TypeError Exception
+  public responseType: XMLHttpRequestResponseType;
+  // ...
+}</programlisting>
+</para>
+</formalpara>
+<simpara>Client code importing the runtime-library as defined above can now use the Enumeration in a type-safe way:</simpara>
+<formalpara>
+<title>String-Based Enumeration Usage</title>
+<para>
+<programlisting language="n4js" linenumbering="unnumbered">import XMLHttpRequestResponseType from "w3c/dom/XMLHttpRequestResponseType";
+
+public function process(req: XMLHttpRequest) : void {
+  if( req.responseType == XMLHttpRequestResponseType.text ) {
+    // do stuff ...
+  } else {
+       // signal unrecognized type.
+       var errMessage: req.responseType + " is not supported"; // concatination of two strings.
+       show( errMessage );
+  }
+}</programlisting>
+</para>
+</formalpara>
+</example>
+</requirement>
+</section>
+</section>
+<section xml:id="_short-hand-syntax" role="language-n4js">
+<title>Short-Hand Syntax</title>
+<simpara>Short-hand syntax is available for a number of built-in types.</simpara>
+<section xml:id="_array-short-hand-syntax">
+<title>Array Short-Hand Syntax</title>
+<simpara>For the built-in type <literal>Array</literal> a convenience short form is available. Thus, writing</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">let arr: string[];</programlisting>
+<simpara>is equivalent to</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">let arr: Array&lt;string&gt;;</programlisting>
+<simpara>Multi-dimensional arrays can be declared as such:</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">let arr: string[][][];</programlisting>
+<simpara>which is equivalent to</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">let arr: Array&lt;Array&lt;Array&lt;string&gt;&gt;&gt;;</programlisting>
+</section>
+<section xml:id="_iterablen-short-hand-syntax">
+<title>IterableN Short-Hand Syntax</title>
+<simpara>The built-in IterableN types (i.e. <literal>Iterable2</literal>, <literal>Iterable3</literal>, &#8230;&#8203; <literal>Iterable9</literal>, see <xref linkend="IterableN"/>) are
+also provided with a short-hand syntax. For example, writing</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">let i3: [string,number,string[]];</programlisting>
+<simpara>would be equivalent to</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">let i3: Iterable3&lt;string,number,Array&lt;string&gt;&gt;;</programlisting>
+<simpara>Note the following special cases:</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">let i0: [];
+let i1: [string];
+let union: string|number[];</programlisting>
+<simpara>which is equivalent to</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">let i0: Iterable&lt;?&gt;;
+let i1: Iterable&lt;string&gt;;
+let union: union{string,Array&lt;number&gt;}; // not: Array&lt;union{string,number}&gt;</programlisting>
+<simpara>Further note: while this syntax is very similar to TypeScript&#8217;s tuple syntax, the semantics
+of tuples and IterableN are very different.</simpara>
+</section>
+</section>
+</chapter>
+<chapter xml:id="_classifiers">
+<title>Classifiers</title>
+<section xml:id="_n4js-specific-classifiers">
+<title>N4JS Specific Classifiers</title>
+<simpara>N4JS provides three new metatypes: class, interface, and enums.
+In this section we describe classes and interfaces.
+These metatypes, called <emphasis>classifiers</emphasis>, share some common properties which are described before type specific properties are outlined in the following sections.</simpara>
+<simpara>All of these metatypes can be marked with type access modifiers:</simpara>
+<programlisting language="xtext" linenumbering="unnumbered">enum N4JSTypeAccessModifier: project | public;</programlisting>
+<section xml:id="_properties-2" role="language-n4js">
+<title>Properties</title>
+<simpara><emphasis role="strong">Properties defined by syntactic elements:</emphasis></simpara>
+<variablelist>
+<varlistentry>
+<term><literal>annotations</literal> </term>
+<listitem>
+<simpara>Arbitrary annotations, see <xref linkend="_annotations"/> for details.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>accessModifier</literal> </term>
+<listitem>
+<simpara>N4JS type access modifier: <literal>public</literal>, or <literal>project</literal>;  <literal>public</literal> can be combined with <literal>@Internal</literal>; if
+<emphasis role="strong">export</emphasis> is <literal>true</literal> the default is else the default is <literal>private</literal>.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>name</literal> </term>
+<listitem>
+<simpara>The simple name of a classifier. If the classifier is defined by an anonymous class expression, an artificial but unique name is created.
+The name needs to be a valid identifier, see <xref linkend="_valid-names"/>.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>typePars</literal> </term>
+<listitem>
+<simpara>Collection of type parameters of a generic classifier; empty by default.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>ownedMembers</literal> </term>
+<listitem>
+<simpara>Collection of owned members, i.e. methods and fields defined directly in the classifier and, if present, the explicitly defined constructor.
+Depending on the concrete classifier, additional constraints are defined.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>typingStrategy</literal> </term>
+<listitem>
+<simpara>The definition-site typing strategy. By default nominal typing is used.
+See <xref linkend="_structural-typing"/> for details.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+<simpara><emphasis role="strong">The following pseudo properties are defined via annotations:</emphasis></simpara>
+<variablelist>
+<varlistentry>
+<term><literal>export</literal> </term>
+<listitem>
+<simpara>Boolean property set to true if the <literal>export</literal> modifier is set.
+If value is true, the classifier may be accessible outside the project.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>final</literal> </term>
+<listitem>
+<simpara>Boolean property which is set to final if annotation <literal>@Final</literal> is set.
+Also see <xref linkend="_final-modifier"/></simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>deprecated</literal> </term>
+<listitem>
+<simpara>Boolean property set to true if annotation <literal>@Deprecated</literal> is set.</simpara>
+<note>
+<simpara>Version 0.4, not implemented in Version 0.3</simpara>
+</note>
+</listitem>
+</varlistentry>
+</variablelist>
+<simpara><emphasis role="strong">We additionally define the following pseudo properties:</emphasis></simpara>
+<variablelist>
+<varlistentry>
+<term><literal>acc</literal> </term>
+<listitem>
+<simpara>Type access modifier as described in <xref linkend="_accessibility-of-types-top-level-variables-and-function-declarations"/>, it is the aggregated value of the
+<literal>accessModifier</literal> and the <emphasis role="strong">export</emphasis> property.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>owned{Fields|Methods|Getters|Setters|Accessors}</literal> </term>
+<listitem>
+<simpara>Filters ownedMembers by metatype, short for<?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>x</mi><mo>∈</mo><mi>o</mi><mi>w</mi><mi>n</mi><mi>e</mi><mi>d</mi><mi>M</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi><mi>s</mi><mo>,</mo><mi>μ</mi><mfenced close=")" open="("><mi>x</mi></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>Field</mtext></mstyle></math> etc.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>members</literal> </term>
+<listitem>
+<simpara>Reflexive transitive closure of all members of a classifier and its super classifiers, see <xref linkend="_common-semantics-of-classifiers"/> on how this is calculated.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>fields|methods|getters|setters|accessors</literal> </term>
+<listitem>
+<simpara>Filters members by metatype, short for<?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>x</mi><mo>∈</mo><mi>m</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi><mi>s</mi><mo>,</mo><mi>μ</mi><mfenced close=")" open="("><mi>x</mi></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>Field</mtext></mstyle></math> etc.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>superClassifiers</literal> </term>
+<listitem>
+<simpara>Classes and interface may extend or implement classes or interfaces.
+Any class or interface extended or interface implemented is called <emphasis>super classifier</emphasis>.
+We distinguish the directly subtyped classifiers and from the transitive closure of supertypes <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>s</mi><mi>u</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>C</mi><mi>l</mi><mi>a</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>f</mi><mi>i</mi><mi>e</mi><mi>r</mi><msup><mi>s</mi><mo>*</mo></msup></math></simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+</section>
+<section xml:id="_common-semantics-of-classifiers" role="language-n4js">
+<title>Common Semantics of Classifiers</title>
+<requirement xml:id="IDE-42">
+<title>Subtyping of Classifiers</title>
+<simpara>
+<anchor xml:id="Req-IDE-42" xreflabel="[Req-IDE-42]"/>
+<emphasis role="strong">Requirement: IDE-42:</emphasis>
+<link linkend="Req-IDE-42">Subtyping of Classifiers</link> (ver. 1)</simpara>
+    <simpara>
+
+For a given type <literal>C</literal>, and supertypes <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>s</mi><mi>u</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>C</mi><mi>l</mi><mi>a</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>f</mi><mi>i</mi><mi>e</mi><mi>r</mi><mi>s</mi><mo>=</mo><mfenced close="}" open="{"><msub><mi>S</mi><mn>1</mn></msub><mrow><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/></mrow><msub><mi>S</mi><mi>n</mi></msub></mfenced></math> directly subtyped
+<literal>C</literal>, the following constraints must be true:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>The supertypes must be accessible to the subtype:<?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>S</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>S</mi><mi>n</mi></msub></math> must be accessible to <literal>C</literal>.</simpara>
+</listitem>
+<listitem>
+<simpara>All type parameters of the direct supertypes have to be bound by type arguments in the subtype and the type arguments have to be substitutable types of the type parameters.</simpara>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∀</mo><mn>0</mn><mo>&lt;</mo><mi>i</mi><mo>≤</mo><mi>k</mi><mi>:</mi><mo>∀</mo><mi>P</mi><mo>∈</mo><msub><mi>S</mi><mi>i</mi></msub><mi>:</mi></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∃</mo><mi>A</mi><mo>∈</mo><msub><mi>C</mi><mo>.</mo></msub><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>A</mi><mi>r</mi><mi>g</mi><mi>s</mi><mi>:</mi><mi>b</mi><mi>i</mi><mi>n</mi><mi>d</mi><mfenced close=")" open="("><mi>A</mi><mi>P</mi></mfenced><mo>∧</mo><mi>A</mi><mo>.</mo><mi>u</mi><mi>p</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>B</mi><mi>o</mi><mi>u</mi><mi>n</mi><mi>d</mi><mo>&lt;</mo><mi>:</mi><mi>P</mi><mo>.</mo><mi>u</mi><mi>p</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>B</mi><mi>o</mi><mi>u</mi><mi>n</mi><mi>d</mi></math></simpara>
+</listitem>
+<listitem>
+<simpara>Wildcards may not be used as type argument when binding a supertype’s type parameters.</simpara>
+</listitem>
+<listitem>
+<simpara>A classifier cannot be directly subtyped directly multiple times:<?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∀</mo><msub><mi>S</mi><mi>i</mi></msub><mo>,</mo><msub><mi>S</mi><mi>j</mi></msub><mfenced close=")" open="("><mi>i</mi><mrow><mi>j</mi><mo>∈</mo><mfenced close="}" open="{"><mrow><mn>1.</mn><mo>.</mo><mi>n</mi></mrow></mfenced></mrow></mfenced><mi>:</mi><msub><mi>S</mi><mi>i</mi></msub><mo>=</mo><msub><mi>S</mi><mi>j</mi></msub><mo>→</mo><mi>i</mi><mo>=</mo><mi>j</mi></math></simpara>
+</listitem>
+</orderedlist>
+<simpara>In order to simplify the following constraints, we use the pseudo property <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>m</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi><mi>s</mi></math> to refer to all members of a classifier.
+This includes all members directly declared by the classifier itself, i.e. the <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>o</mi><mi>w</mi><mi>n</mi><mi>e</mi><mi>d</mi><mi>M</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi></math>, and all members inherited from its super classifiers.
+The concrete mechanisms for inheriting a member are different and further constraint (cf. <xref linkend="_redefinition-of-members"/>).
+A classifier only inherits its members from its direct supertypes, although the supertypes may contains members inherited from their supertypes.</simpara>
+</requirement>
+</section>
+<section xml:id="_classes" role="language-n4js">
+<title>Classes</title>
+<section xml:id="_definition-of-classes">
+<title>Definition of Classes</title>
+<simpara>Classes are either declared with a class declaration on top level, or they can be used as anonymous classes in expressions.
+The latter may have a name, which may be used for error messages and reflection.</simpara>
+<simpara>At the current stage, class expressions are effectively disabled at least until the semantics of them are finalized in ECMAScript 6.</simpara>
+<simpara>In N4JS (as in many other languages) multi-inheritance of classes is not supported.
+Although the <literal>diamond problem</literal> (of functions being defined in both superclasses) could be solved via union and intersection types, this would lead to problems when calling these super implementations.
+This is particularly an issue due to JavaScript not supporting
+multiple prototypes.<footnote><simpara>E.g., for given <literal role="language-n4js">class A{ foo(A):A{}} class B{ foo(B):B{}}</literal>, a class C could be defined as <literal role="language-n4js">class C{ foo(union{A,B}):intersection{A,B}{}}</literal>. In this case it would then be a syntactical problem (and even worse - a conceptual problem) of how to call the super methods defined in A and Bfrom C.</simpara></footnote>
+Interfaces, however, allow for multi-inheritance. Since the former can also define functions with bodies, this is not a hard restriction.</simpara>
+<section xml:id="class-syntax">
+<title>Syntax</title>
+<formalpara>
+<title>Syntax N4 Class Declaration and Expression</title>
+<para>
+<programlisting language="xtext" linenumbering="unnumbered">N4ClassDeclaration &lt;Yield&gt;:
+    =&gt;(
+        {N4ClassDeclaration}
+        annotations+=Annotation*
+        (declaredModifiers+=N4Modifier)*
+        'class' typingStrategy=TypingStrategyDefSiteOperator? name=BindingIdentifier&lt;Yield&gt;?
+    )
+    TypeVariables?
+    ClassExtendsClause&lt;Yield&gt;?
+    Members&lt;Yield&gt;
+;
+
+N4ClassExpression &lt;Yield&gt;:
+    {N4ClassExpression}
+    'class' name=BindingIdentifier&lt;Yield&gt;?
+    ClassExtendsClause&lt;Yield&gt;?
+    Members&lt;Yield&gt;;
+
+
+fragment ClassExtendsClause &lt;Yield&gt;*:
+    'extends' (
+          =&gt;superClassRef=ParameterizedTypeRefNominal ('implements' ClassImplementsList)?
+        | superClassExpression=LeftHandSideExpression&lt;Yield&gt;
+    )
+    | 'implements' ClassImplementsList
+;
+
+fragment ClassImplementsList*:
+    implementedInterfaceRefs+=ParameterizedTypeRefNominal
+    (',' implementedInterfaceRefs+=ParameterizedTypeRefNominal)*
+;
+
+fragment Members &lt;Yield&gt;*:
+    '{'
+    ownedMembers+=N4MemberDeclaration&lt;Yield&gt;*
+    '}'
+;</programlisting>
+</para>
+</formalpara>
+</section>
+<section xml:id="class-properties">
+<title>Properties</title>
+<simpara>These are the properties of class, which can be specified by the user:
+Syntax N4 Class Declaration and Expression</simpara>
+<variablelist>
+<varlistentry>
+<term><literal>abstract</literal> </term>
+<listitem>
+<simpara>Boolean flag indicating whether class may be instantiable; default is <literal>false</literal>, see <xref linkend="_abstract-classes"/>.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>external</literal> </term>
+<listitem>
+<simpara>Boolean flag indicating whether class is a declaration without implementation or with an external (non-N4JS) implementation; default is <literal>false</literal>, see <xref linkend="_definition-site-structural-typing"/>.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>defStructural</literal> </term>
+<listitem>
+<simpara>Boolean flag indicating whether subtype relation uses nominal or structural typing, see <xref linkend="_definition-site-structural-typing"/> for details.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>superType/sup</literal> </term>
+<listitem>
+<simpara>The type referenced by <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>s</mi><mi>u</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi></math> is called direct superclass of a class, and vice versa the class is a direct subclass of <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>s</mi><mi>u</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi></math>.
+Instead of <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>s</mi><mi>u</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi></math>, we sometimes simply write <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>s</mi><mi>u</mi><mi>p</mi></math>.
+The derived set <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>s</mi><mi>u</mi><msup><mi>p</mi><mo>+</mo></msup></math> is defined as the transitive closures of all direct and indirect superclasses of a class.
+If no supertype is explicitly stated, classes are derived from <literal>N4Object</literal>.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>implementedInterfaces</literal>/<literal>interfaces</literal> </term>
+<listitem>
+<simpara>Collection of interfaces directly <emphasis>implemented</emphasis> by the class; empty by default.
+Instead of <literal>implementedInterfaces</literal>, we simply write <literal>interfaces</literal>.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>ownedCtor</literal> </term>
+<listitem>
+<simpara>Explicit constructor of a class (if any), see <xref linkend="_constructor-and-classifier-type"/>.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+<simpara>And we additionally define the following pseudo properties:</simpara>
+<variablelist>
+<varlistentry>
+<term><literal>ctor</literal> </term>
+<listitem>
+<simpara>Explicit or implicit constructor of a class, see <xref linkend="_constructor-and-classifier-type"/>.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>fields</literal> </term>
+<listitem>
+<simpara>Further derived properties for retrieving all methods (property <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>m</mi><mi>e</mi><mi>t</mi><mi>h</mi><mi>o</mi><mi>d</mi><mi>s</mi></math>), fields (property <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>f</mi><mi>i</mi><mi>e</mi><mi>l</mi><mi>d</mi><mi>s</mi></math>), static
+members (property <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>c</mi><mi>O</mi><mi>w</mi><mi>n</mi><mi>e</mi><mi>d</mi><mi>M</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi><mi>s</mi></math>), etc. can easily be added by filtering properties <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>m</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi><mi>s</mi></math> or <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>o</mi><mi>w</mi><mi>n</mi><mi>e</mi><mi>d</mi><mi>M</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi><mi>s</mi></math>.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+</section>
+<section xml:id="class-type-inference">
+<title>Type Inference</title>
+<simpara>The type of a class declaration or class expression <literal>C</literal> (i.e., a class definition in general) is of type <literal>constructor{C}</literal> if it is not abstract,
+that is if it can be instantiated.
+If it is abstract, the type of the definition simply is <literal>type{C}</literal>:</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mtable><mtr><mtd><mfrac><mrow><mo>¬</mo><mi>C</mi><mo>.</mo><mi>a</mi><mi>b</mi><mi>s</mi><mi>t</mi><mi>r</mi><mi>a</mi><mi>c</mi><mi>t</mi></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mi>C</mi><mi>:</mi><mstyle mathvariant="monospace"><mtext>constructor</mtext></mstyle><mfenced close="}" open="{"><mi>C</mi></mfenced></mrow></mfrac></mtd></mtr><mtr><mtd><mfrac><mrow><mi>C</mi><mo>.</mo><mi>a</mi><mi>b</mi><mi>s</mi><mi>t</mi><mi>r</mi><mi>a</mi><mi>c</mi><mi>t</mi></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mi>C</mi><mi>:</mi><mstyle mathvariant="monospace"><mtext>type</mtext></mstyle><mfenced close="}" open="{"><mi>C</mi></mfenced></mrow></mfrac></mtd></mtr></mtable></math>
+<requirement xml:id="IDE-43">
+<title>Structural and Nominal Supertypes</title>
+<simpara>
+<anchor xml:id="Req-IDE-43" xreflabel="[Req-IDE-43]"/>
+<emphasis role="strong">Requirement: IDE-43:</emphasis>
+<link linkend="Req-IDE-43">Structural and Nominal Supertypes</link> (ver. 1)</simpara>
+    <simpara>
+
+The type of supertypes and implemented interfaces is always the nominal type, even if the supertype is declared structurally.</simpara>
+
+</requirement>
+</section>
+</section>
+<section xml:id="class-semantics">
+<title>Semantics</title>
+<simpara>This section deals with the (more or less) type-independent constraints on classes.</simpara>
+<simpara>Class expressions are not fully supported at the moment.</simpara>
+<definition>
+<title>Transitive closure of members</title>
+<simpara>
+<anchor xml:id="transitive_closure_of_members" xreflabel="[transitive_closure_of_members]"/>
+<emphasis role="strong">Definition:</emphasis>
+<link linkend="transitive_closure_of_members">Transitive closure of members</link></simpara>
+<simpara>
+
+The reflexive transitive closure of members of a class is indirectly defined by the override and implementation constraints defined in <xref linkend="_redefinition-of-members"/>.</simpara>
+<simpara>Note that since overloading is forbidden, the following constraint is true <footnote><simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>a</mi><mi>c</mi><mi>c</mi><mi>e</mi><mi>s</mi><mi>s</mi><mi>o</mi><mi>r</mi><mi>P</mi><mi>a</mi><mi>i</mi><mi>r</mi><mfenced close=")" open="("><msub><mi>m</mi><mn>1</mn></msub><msub><mi>m</mi><mn>2</mn></msub></mfenced></math> is defined as follows: <math xmlns="http://www.w3.org/1998/Math/MathML"><mfenced close=")" open="("><mrow><mi>μ</mi><mfenced close=")" open="("><msub><mi>m</mi><mn>1</mn></msub></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>getter</mtext></mstyle><mo>∧</mo><mi>μ</mi><mfenced close=")" open="("><msub><mi>m</mi><mn>2</mn></msub></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>setter</mtext></mstyle></mrow></mfenced><mo>∨</mo><mfenced close=")" open="("><mrow><mi>μ</mi><mfenced close=")" open="("><msub><mi>m</mi><mn>1</mn></msub></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>setter</mtext></mstyle><mo>∧</mo><mi>μ</mi><mfenced close=")" open="("><msub><mi>m</mi><mn>2</mn></msub></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>getter</mtext></mstyle></mrow></mfenced></math></simpara></footnote>:</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mo>∀</mo><msub><mi>m</mi><mn>1</mn></msub><mo>,</mo><msub><mi>m</mi><mn>2</mn></msub><mo>∈</mo><mi>m</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi><mi>s</mi><mi>:</mi><msub><mi>m</mi><mn>1</mn></msub><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><msub><mi>m</mi><mn>2</mn></msub><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>⇔</mo><msub><mi>m</mi><mn>1</mn></msub><mo>=</mo><msub><mi>m</mi><mn>2</mn></msub><mo>∨</mo><mi>a</mi><mi>c</mi><mi>c</mi><mi>e</mi><mi>s</mi><mi>s</mi><mi>o</mi><mi>r</mi><mi>P</mi><mi>a</mi><mi>i</mi><mi>r</mi><mfenced close=")" open="("><msub><mi>m</mi><mn>1</mn></msub><msub><mi>m</mi><mn>2</mn></msub></mfenced></math>
+<simpara>Remarks: Class and method definition is quite similar to the proposed ECMAScript version 6 draft [<link linkend="ECMA15a">ECMA15a(p.S13.5)</link>], except that an N4 class and members may contain</simpara>
+<itemizedlist>
+<listitem>
+<simpara>annotations, abstract and access modifiers</simpara>
+</listitem>
+<listitem>
+<simpara>fields</simpara>
+</listitem>
+<listitem>
+<simpara>types</simpara>
+</listitem>
+<listitem>
+<simpara>implemented interfaces</simpara>
+</listitem>
+</itemizedlist>
+<simpara>Note that even <literal>static</literal> is used in ECMAScript 6.</simpara>
+</definition>
+<simpara>Mixing in members (i.e. interface’s methods with default implementation or fields) is similar to mixing in members from roles as defined in [<link linkend="Dart13a">Dart13a(p.S9.1)</link>].
+It is also similar to default implementations in Java 8 [<link linkend="Gosling15a">Gosling15a</link>].
+In Java, however, more constraints exist, (for example, methods of interfaces must be public).</simpara>
+<example>
+<title>Simple Class</title>
+<simpara>This first example shows a very simple class with a field, a constructor and a method.</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">class C {
+    data: any;
+
+    constructor(data: any) {
+        this.data = data;
+    }
+
+    foo(): void { }
+}</programlisting>
+</example>
+<example>
+<title>Extend and implement</title>
+<simpara>The following example demonstrate how a class can extend a superclass and implement an interface.</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">interface I {
+    foo(): void
+}
+class C{}
+class X extends C implements I {
+    @Override
+    foo(): void {}
+}</programlisting>
+</example>
+<simpara>A class <literal>C</literal> is a subtype of another classifier <literal>S</literal> (which can be a class or interface) if the other classifier <literal>S</literal> is (transitively) contained in the supertypes (superclasses or implemented interfaces) of the class:</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi><mo>=</mo><mi>r</mi><mi>i</mi><mi>g</mi><mi>h</mi><mi>t</mi></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mstyle mathvariant="monospace"><mtext>TClass</mtext></mstyle><mi> </mi><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mfenced close="]" open="["><mrow><mi>T</mi><mi>C</mi><mi>l</mi><mi>a</mi><mi>s</mi><mi>s</mi></mrow></mfenced><mi> </mi><mi>r</mi><mi>i</mi><mi>g</mi><mi>h</mi><mi>t</mi></mrow></mfrac><mfenced close="]" open="["><mrow><mi>s</mi><mi>h</mi><mi>o</mi><mi>r</mi><mi>t</mi><mi>c</mi><mi>u</mi><mi>t</mi></mrow></mfenced><mtext>
+</mtext></math>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><mi>Γ</mi><mo>⊢</mo><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi><mo>.</mo><mi>s</mi><mi>u</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi><mo>.</mo><mi>d</mi><mi>e</mi><mi>c</mi><mi>l</mi><mi>a</mi><mi>r</mi><mi>e</mi><mi>d</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>r</mi><mi>i</mi><mi>g</mi><mi>h</mi><mi>t</mi></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mstyle mathvariant="monospace"><mtext>TClass</mtext></mstyle><mi> </mi><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mfenced close="]" open="["><mrow><mi>T</mi><mi>C</mi><mi>l</mi><mi>a</mi><mi>s</mi><mi>s</mi></mrow></mfenced><mi> </mi><mi>r</mi><mi>i</mi><mi>g</mi><mi>h</mi><mi>t</mi></mrow></mfrac></math>
+<requirement xml:id="IDE-44">
+<title>Implicit Supertype of Classes</title>
+<simpara>
+<anchor xml:id="Req-IDE-44" xreflabel="[Req-IDE-44]"/>
+<emphasis role="strong">Requirement: IDE-44:</emphasis>
+<link linkend="Req-IDE-44">Implicit Supertype of Classes</link> (ver. 1)</simpara>
+    <simpara>
+
+1.  The implicit supertype of all classes is <literal>N4Object</literal>.
+All classes with no explicit supertype are inherited from <literal>N4Object</literal>.
+2.  If the supertype is explicitly set to <literal>Object</literal>, then the class is not derived from <literal>N4Object</literal>.
+Meta-information is created similar to an <literal>N4Object</literal>-derived class.
+Usually, there is no reason to explicitly derive a class from <literal>Object</literal>.
+3.  External classes are implicitly derived from , unless they are annotated with <literal>@N4JS</literal>(cf.<xref linkend="_external-declarations"/>).</simpara>
+</requirement>
+</section>
+<section xml:id="_final-modifier">
+<title>Final Modifier</title>
+<simpara>Extensibility refers to whether a given classifier can be subtyped.
+Accessibility is a prerequisite for extensibility.
+If a type cannot be seen, it cannot be subclassed.
+The only modifier influencing the extensibility directly is the annotation <literal>@Final</literal>, which prevents all subtyping.
+The following table shows how to prevent other projects or vendors from subtyping by also restricting the accessibility of the constructor:</simpara>
+<table frame="all" rowsep="1" colsep="1">
+<title>Extensibility of Types</title>
+<tgroup cols="4">
+<colspec colname="col_1" colwidth="62.5*"/>
+<colspec colname="col_2" colwidth="12.5*"/>
+<colspec colname="col_3" colwidth="12.5*"/>
+<colspec colname="col_4" colwidth="12.5*"/>
+<thead>
+<row>
+<entry align="center" valign="top">Type <literal>C</literal> Settings</entry>
+<entry align="center" valign="top" namest="col_2" nameend="col_4">Subclassed in</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry align="left" valign="top"></entry>
+<entry align="center" valign="top"><simpara><emphasis role="strong">Project</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><emphasis role="strong">Vendor</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><emphasis role="strong">World</emphasis></simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><literal>C.final</literal></simpara></entry>
+<entry align="center" valign="top"><simpara>no</simpara></entry>
+<entry align="center" valign="top"><simpara>no</simpara></entry>
+<entry align="center" valign="top"><simpara>no</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><literal>C.ctor.accessModifier=\lenum{project}</literal></simpara></entry>
+<entry align="center" valign="top"><simpara>yes</simpara></entry>
+<entry align="center" valign="top"><simpara>no</simpara></entry>
+<entry align="center" valign="top"><simpara>no</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><literal>C.ctor.accessModifier=\lenum{public@Internal}</literal></simpara></entry>
+<entry align="center" valign="top"><simpara>yes</simpara></entry>
+<entry align="center" valign="top"><simpara>yes</simpara></entry>
+<entry align="center" valign="top"><simpara>no</simpara></entry>
+</row>
+</tbody>
+</tgroup>
+</table>
+<simpara>Since interfaces are always to be implemented, they must not be declared final.</simpara>
+</section>
+<section xml:id="_abstract-classes">
+<title>Abstract Classes</title>
+<simpara>A class with modifier <literal>abstract</literal> is called an <emphasis>abstract class</emphasis> and has its <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>a</mi><mi>b</mi><mi>s</mi><mi>t</mi><mi>r</mi><mi>a</mi><mi>c</mi><mi>t</mi></math> property set to true.
+Other classes are called <emphasis>concrete</emphasis> classes.</simpara>
+<requirement xml:id="IDE-45">
+<title>Abstract Class</title>
+<simpara>
+<anchor xml:id="Req-IDE-45" xreflabel="[Req-IDE-45]"/>
+<emphasis role="strong">Requirement: IDE-45:</emphasis>
+<link linkend="Req-IDE-45">Abstract Class</link> (ver. 1)</simpara>
+    <simpara>
+</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>A class <literal>C</literal> must be declared abstract if it owns or inherits one or more abstract members and neither C nor any interfaces implemented by C implements these members.
+A concrete class has to, therefore, implement all abstract members of its superclasses’ implemented interfaces.
+Note that a class may implement fields with field accessors and vice versa.</simpara>
+</listitem>
+<listitem>
+<simpara>An abstract class may not be instantiated.</simpara>
+</listitem>
+<listitem>
+<simpara>An abstract class cannot be set to final (with annotation <literal>@Final</literal>).</simpara>
+</listitem>
+</orderedlist>
+</requirement>
+<requirement xml:id="IDE-46">
+<title>Abstract Member</title>
+<simpara>
+<anchor xml:id="Req-IDE-46" xreflabel="[Req-IDE-46]"/>
+<emphasis role="strong">Requirement: IDE-46:</emphasis>
+<link linkend="Req-IDE-46">Abstract Member</link> (ver. 1)</simpara>
+    <simpara>
+</simpara>
+<sidebar>
+<simpara><link xl:href="https://github.com/eclipse/n4js/issues/1047"><inlinemediaobject>
+<imageobject>
+<imagedata fileref="images/issue.svg"/>
+</imageobject>
+<textobject><phrase></phrase></textobject>
+</inlinemediaobject> #1047</link></simpara>
+</sidebar>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>A member declared as abstract must not have a method body (in contrary a method not declared as abstract have to have a method body).</simpara>
+</listitem>
+<listitem>
+<simpara>Only methods, getters and setters can be declared as abstract (fields cannot be abstract).</simpara>
+</listitem>
+<listitem>
+<simpara>It is not possible to inherit from an abstract class which contains abstract members which are not visible in the subclass.</simpara>
+</listitem>
+<listitem>
+<simpara>An abstract member must not be set to final (with annotation <literal>@Final</literal>).</simpara>
+</listitem>
+<listitem>
+<simpara>Static members must not be declared abstract.</simpara>
+</listitem>
+</orderedlist>
+</requirement>
+<simpara>Remarks:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>We decided to disallow abstract static members, since we cannot guarantee that a static members is not accessed in all cases</simpara>
+</listitem>
+<listitem>
+<simpara>Only static members can override static members and only instance members can override other instance members of course.</simpara>
+</listitem>
+<listitem>
+<simpara>An abstract member must not be declared in a final class (i.e. a class annotated with <literal>@Final</literal>). This is not explicitly defined as constraint in <xref linkend="Req-IDE-46"/> since abstract classes must not defined final anyway. We also do not produce error message for abstract members in final classes since these errors would be consequential errors.</simpara>
+</listitem>
+</itemizedlist>
+<warning>
+<simpara>Abstract members might be declared private, as they can be accessed from within the module.
+This is to be changed in order to be aligned with TypeScript, cf. <link xl:href="https://github.com/eclipse/n4js/issues/1221"><inlinemediaobject>
+<imageobject>
+<imagedata fileref="images/issue.svg"/>
+</imageobject>
+<textobject><phrase></phrase></textobject>
+</inlinemediaobject> #1221</link>. However we also want to add class expressions&#8201;&#8212;&#8201;and then the abstract members may be accessed (and overridden) in nested classes created by means of class expressions.</simpara>
+</warning>
+</section>
+<section xml:id="_non-instantiable-classes">
+<title>Non-Instantiable Classes</title>
+<simpara>To make a class non-instantiable outside a defining compilation unit, i.e. disallow creation of instances for this class, simply declare the constructor as private.
+This can be used for singletons.</simpara>
+</section>
+<section xml:id="_superclass">
+<title>Superclass</title>
+<requirement xml:id="IDE-47">
+<title>Superclass</title>
+<simpara>
+<anchor xml:id="Req-IDE-47" xreflabel="[Req-IDE-47]"/>
+<emphasis role="strong">Requirement: IDE-47:</emphasis>
+<link linkend="Req-IDE-47">Superclass</link> (ver. 1)</simpara>
+    <simpara>
+
+For a class <literal>C</literal> with a supertype <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>S</mi><mo>=</mo><mi>C</mi><mo>.</mo><mi>s</mi><mi>u</mi><mi>p</mi></math>, the following constraints must hold;</simpara>
+<itemizedlist>
+<listitem>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>C</mi><mo>.</mo><mi>s</mi><mi>u</mi><mi>p</mi></math> must reference a class declaration <literal>S</literal></simpara>
+</listitem>
+<listitem>
+<simpara><literal>S</literal> must be be extendable in the project of <literal>C</literal></simpara>
+</listitem>
+<listitem>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>C</mi><mo>∉</mo><mi>C</mi><mo>.</mo><mi>s</mi><mi>u</mi><msup><mi>p</mi><mo>+</mo></msup></math></simpara>
+</listitem>
+<listitem>
+<simpara>All abstract members in <literal>S</literal> must be accessible from <literal>C</literal>:</simpara>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∀</mo><mi>M</mi><mo>∈</mo><mi>S</mi><mo>.</mo><mi>m</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi><mi>s</mi><mi>:</mi><mi>M</mi><mo>.</mo><mi>a</mi><mi>b</mi><mi>s</mi><mi>t</mi><mi>r</mi><mi>a</mi><mi>c</mi><mi>t</mi><mo>⇒</mo></math><?asciidoc-br?>
+<literal>M</literal> is accessible from <literal>C</literal>.<?asciidoc-br?>
+Note that <literal>M</literal> need not be an owned member of <literal>S</literal> and that this constraint applies even if <literal>C</literal> is abstract).</simpara>
+</listitem>
+</itemizedlist>
+<simpara>All members of superclasses become members of a class.
+This is true even if the owning classes are not directly accessible to a class.
+The member-specific access control is not changed.</simpara>
+</requirement>
+</section>
+</section>
+<section xml:id="_interfaces" role="language-n4js">
+<title>Interfaces</title>
+<section xml:id="_definition-of-interfaces">
+<title>Definition of Interfaces</title>
+<section xml:id="interfaces-syntax">
+<title>Syntax</title>
+<formalpara>
+<title>Syntax N4 Interface Declaration</title>
+<para>
+<programlisting language="xtext" linenumbering="unnumbered">N4InterfaceDeclaration &lt;Yield&gt;:
+    =&gt; (
+        {N4InterfaceDeclaration}
+        annotations+=Annotation*
+        (declaredModifiers+=N4Modifier)*
+        'interface' typingStrategy=TypingStrategyDefSiteOperator? name=BindingIdentifier&lt;Yield&gt;?
+    )
+    TypeVariables?
+    InterfaceImplementsList?
+    Members&lt;Yield&gt;
+;
+
+fragment InterfaceImplementsList*:
+    'implements' superInterfaceRefs+=ParameterizedTypeRefNominal
+        (',' superInterfaceRefs+=ParameterizedTypeRefNominal)*
+;</programlisting>
+</para>
+</formalpara>
+</section>
+<section xml:id="interfaces-properties">
+<title>Properties</title>
+<simpara>These are the additional properties of interfaces, which can be specified by the user:</simpara>
+<variablelist>
+<varlistentry>
+<term><literal>superInterfaces</literal></term>
+<listitem>
+<simpara>Collection of interfaces extended by this interface; empty by default.
+Instead of <literal>superInterfaces</literal>, we simply write <literal>interfaces</literal>.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+</section>
+<section xml:id="interfaces-type-inference">
+<title>Type Inference</title>
+<simpara>The type of an interface declaration <literal>I</literal> is of type <literal>type{I}</literal>:</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow/><mrow><mi>Γ</mi><mo>⊢</mo><mi>I</mi><mi>:</mi><mstyle mathvariant="monospace"><mtext>type</mtext></mstyle><mfenced close="}" open="{"><mi>I</mi></mfenced></mrow></mfrac></math>
+</section>
+<section xml:id="interfaces-semantics">
+<title>Semantics</title>
+<simpara>Interfaces are used to describe the public <link linkend="_acronyms">API</link> of a classifier.
+The main requirement is that the instance of an interface, which must be an instance of a class since interfaces cannot have instances, provides all members declared in the interface.
+Thus, a (concrete) class implementing an interface must provide implementations for all the fields, methods, getters and setters of the interface (otherwise it the class must be declared abstract).
+The implementations have to be provided either directly in the class itself, through a superclass, or by the interface if the member has a default implementation.</simpara>
+<simpara>A field declaration in an interface denotes that all implementing classes can either provide a field of the same name and the same(!) type or corresponding field accessors.
+If no such members are defined in the class or a (transitive) superclass, the field is mixed in from the interface automatically.
+This is also true for the initializer of the field.</simpara>
+<simpara>All instance methods, getters and setters declared in an interface are implicitly abstract if they do not provide a default implementation.
+The modifier <literal>abstract</literal> is not required, therefore, in the source code.
+The following constraints apply:</simpara>
+<requirement xml:id="IDE-48">
+<title>Interfaces</title>
+<simpara>
+<anchor xml:id="Req-IDE-48" xreflabel="[Req-IDE-48]"/>
+<emphasis role="strong">Requirement: IDE-48:</emphasis>
+<link linkend="Req-IDE-48">Interfaces</link> (ver. 1)</simpara>
+    <simpara>
+
+For any interface <literal>I</literal>, the following must hold:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>Interfaces may not be instantiated.</simpara>
+</listitem>
+<listitem>
+<simpara>Interfaces cannot be set to final (with annotation @Final): <math xmlns="http://www.w3.org/1998/Math/MathML"><mo>¬</mo><mi>I</mi><mo>.</mo><mi>f</mi><mi>i</mi><mi>n</mi><mi>a</mi><mi>l</mi></math>.</simpara>
+</listitem>
+<listitem>
+<simpara>Members of an interface must not be declared private.
+The default access modifier in interfaces is the the type’s visibility or <literal>project</literal>, if the type’s visibility is <literal>private</literal>.</simpara>
+</listitem>
+<listitem>
+<simpara>Members of an interface, except methods, must not be declared <literal>@Final</literal>:</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mo>∀</mo><mi>m</mi><mo>∈</mo><mi>I</mi><mo>.</mo><mi>m</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi><mi>:</mi><mi>m</mi><mo>.</mo><mi>f</mi><mi>i</mi><mi>n</mi><mi>a</mi><mi>l</mi><mo>→</mo><mi>m</mi><mo>∈</mo><mi>I</mi><mo>.</mo><mi>m</mi><mi>e</mi><mi>t</mi><mi>h</mi><mi>o</mi><mi>d</mi><mi>s</mi></math>
+<note>
+<simpara>not allowing field accessors to be declared final was a deliberate decision, because it would complicate the internal handling of member redefinition; might be reconsidered at a later time</simpara>
+</note>
+</listitem>
+<listitem>
+<simpara>The literal may not be used in the initializer expression of a field of an interface.<?asciidoc-br?>
+This restriction is required, because the order of implementation of these fields in an implementing class cannot be guaranteed.
+This applies to both instance and static fields in interfaces, but in case of static fields, <literal>this</literal> is also disallowed due to <xref linkend="_static-members-of-interfaces"/>.</simpara>
+</listitem>
+</orderedlist>
+</requirement>
+<simpara>It is possible to declare members in interfaces with a smaller visibility as the interface itself.
+In that case, clients of the interface may be able to use the interface but not to implement it.</simpara>
+<simpara>In order to simplify modeling of runtime types, such as elements, interfaces do not only support the notation of static methods but constant data fields as well.
+Since <link linkend="_acronyms">IDL</link> [<link linkend="OMG14a">OMG14a</link>] is used to describe these elements in specifications (and mapped to JavaScript via rules described in [<link linkend="W3C12a">W3C12a</link>])
+constant data fields are an often-used technique there and they can be modeled in N4JS 1:1.</simpara>
+<simpara>As specified in <xref linkend="Req-IDE-56"/>, interfaces cannot contain a constructor i.e.<?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∀</mo><mi>m</mi><mo>∈</mo><mi>I</mi><mo>.</mo><mi>o</mi><mi>w</mi><mi>n</mi><mi>e</mi><mi>d</mi><mi>M</mi><mi>e</mi><mi>t</mi><mi>h</mi><mi>o</mi><mi>d</mi><mi>s</mi><mi>:</mi><mi>m</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><msup><mo>≠</mo><mi>'</mi></msup><mi>c</mi><mi>o</mi><mi>n</mi><mi>s</mi><mi>t</mi><mi>r</mi><mi>u</mi><mi>c</mi><mi>t</mi><mi>o</mi><msup><mi>r</mi><mi>'</mi></msup></math>.</simpara>
+<example>
+<title>Simple Interfaces</title>
+<simpara>The following example shows the syntax for defining interfaces.
+The second interface extends the first one.
+Note that methods are implicitly defined abstract in interfaces.</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">interface I {
+    foo(): void
+}
+interface I2 extends I {
+    someText: string;
+    bar(): void
+}</programlisting>
+</example>
+<simpara>If a classifier <literal>C</literal> <emphasis>implements</emphasis> an interface <literal>I</literal>, we say <literal>I</literal> is <emphasis>implemented</emphasis> by <literal>C</literal>.
+If <literal>C</literal> redefines members declared in <literal>I</literal>, we say that these members are <emphasis>implemented</emphasis> by <literal>C</literal>.
+Members not redefined by <literal>C</literal> but with a default implementations are <emphasis>mixed in</emphasis> or <emphasis>consumed by</emphasis> <literal>C</literal>.
+We all cases we call <literal>C</literal> the <emphasis>implementor</emphasis>.</simpara>
+<simpara>Besides the general constraints described in <xref linkend="_common-semantics-of-classifiers"/>, the following constraints must hold for extending or implementing interfaces:</simpara>
+<requirement xml:id="IDE-49">
+<title>Extending Interfaces</title>
+<simpara>
+<anchor xml:id="Req-IDE-49" xreflabel="[Req-IDE-49]"/>
+<emphasis role="strong">Requirement: IDE-49:</emphasis>
+<link linkend="Req-IDE-49">Extending Interfaces</link> (ver. 1)</simpara>
+    <simpara>
+
+For a given type
+<literal>I</literal>, and <math xmlns="http://www.w3.org/1998/Math/MathML"><mfenced close="}" open="{"><msub><mi>I</mi><mn>1</mn></msub><mrow><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/></mrow><msub><mi>I</mi><mi>n</mi></msub></mfenced></math> directly extended by <literal>I</literal>, the following constraints must be true:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>Only interfaces can extend interfaces: <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>I</mi><mo>,</mo><msub><mi>I</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>I</mi><mi>n</mi></msub></math> must be interfaces.</simpara>
+</listitem>
+<listitem>
+<simpara>An interface may not directly extend the same interface more than once:<?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>I</mi><mi>i</mi></msub><mo>=</mo><msub><mi>I</mi><mi>j</mi></msub><mo>→</mo><mi>i</mi><mo>=</mo><mi>j</mi></math> for any
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>i</mi><mo>,</mo><mi>j</mi><mo>∈</mo><mfenced close="}" open="{"><mrow><mn>1</mn><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mi>n</mi></mrow></mfenced></math>.</simpara>
+</listitem>
+<listitem>
+<simpara>An interface may (indirectly) extend the same interface <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>J</mi></math> more than once only if</simpara>
+<orderedlist numeration="loweralpha">
+<listitem>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>J</mi></math> is not parameterized, or</simpara>
+</listitem>
+<listitem>
+<simpara>in all cases <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>J</mi></math> is extended with the same type arguments for all invariant type parameters.<?asciidoc-br?>
+Note that for type parameters of <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>J</mi></math> that are declared covariant or contravariant on definition site, different type arguments may be used.</simpara>
+</listitem>
+</orderedlist>
+</listitem>
+<listitem>
+<simpara>All abstract members in <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>I</mi><mi>i</mi></msub></math>, <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>i</mi><mo>∈</mo><mfenced close="}" open="{"><mn>1</mn><mrow><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/></mrow><mi>n</mi></mfenced></math>, must be accessible from <literal>I</literal>:<?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∀</mo><mi>i</mi><mo>∈</mo><mfenced close="}" open="{"><mn>1</mn><mrow><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/></mrow><mi>n</mi></mfenced><mi>:</mi><mi>M</mi><mo>∈</mo><msub><mi>I</mi><mi>i</mi></msub><mo>.</mo><mi>m</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi><mi>s</mi><mo>∧</mo><mi>M</mi><mo>.</mo><mi>a</mi><mi>b</mi><mi>s</mi><mi>t</mi><mi>r</mi><mi>a</mi><mi>c</mi><mi>t</mi><mo>→</mo></math> <literal>M</literal> is accessible from <literal>I</literal>.<?asciidoc-br?>
+Note that <literal>M</literal> need not be an owned member of <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>I</mi><mi>i</mi></msub></math>.</simpara>
+</listitem>
+</orderedlist>
+</requirement>
+<requirement xml:id="IDE-50">
+<title>Implementing Interfaces</title>
+<simpara>
+<anchor xml:id="Req-IDE-50" xreflabel="[Req-IDE-50]"/>
+<emphasis role="strong">Requirement: IDE-50:</emphasis>
+<link linkend="Req-IDE-50">Implementing Interfaces</link> (ver. 1)</simpara>
+    <simpara>
+</simpara>
+<simpara>For a given type
+<literal>C</literal>, and <math xmlns="http://www.w3.org/1998/Math/MathML"><mfenced close="}" open="{"><msub><mi>I</mi><mn>1</mn></msub><mrow><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/></mrow><msub><mi>I</mi><mi>n</mi></msub></mfenced></math> directly implemented
+by <literal>C</literal>, the following constraints must be true:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>Only classes can implement interfaces: <literal>C</literal> must be a Class.</simpara>
+</listitem>
+<listitem>
+<simpara>A class can only implement interfaces: <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>I</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>I</mi><mi>n</mi></msub></math> must be interfaces.</simpara>
+</listitem>
+<listitem>
+<simpara>A class may not directly implement the same interface more than once:<?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>I</mi><mi>i</mi></msub><mo>=</mo><msub><mi>I</mi><mi>j</mi></msub><mo>⇒</mo><mi>i</mi><mo>=</mo><mi>j</mi></math> for any <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>i</mi><mo>,</mo><mi>j</mi><mo>∈</mo><mfenced close="}" open="{"><mn>1</mn><mrow><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/></mrow><mi>n</mi></mfenced></math>.</simpara>
+</listitem>
+<listitem>
+<simpara>A class may (indirectly) implement the same interface <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>J</mi></math> more than once only if</simpara>
+<orderedlist numeration="loweralpha">
+<listitem>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>J</mi></math> is not parameterized, or</simpara>
+</listitem>
+<listitem>
+<simpara>in all cases <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>J</mi></math> is implemented with the same type arguments for all invariant type parameters.<?asciidoc-br?>
+Note that for type parameters of <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>J</mi></math> that are declared covariant or contravariant on definition site, different type arguments may be used.</simpara>
+</listitem>
+</orderedlist>
+</listitem>
+<listitem>
+<simpara>All abstract members in <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>I</mi><mi>i</mi></msub></math>, <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>i</mi><mo>∈</mo><mfenced close="}" open="{"><mn>1</mn><mrow><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/></mrow><mi>n</mi></mfenced></math>, must be accessible from <literal>C</literal>:<?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∀</mo><mi>i</mi><mo>∈</mo><mfenced close="}" open="{"><mn>1</mn><mrow><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/></mrow><mi>n</mi></mfenced><mi>:</mi><mi>M</mi><mo>∈</mo><msub><mi>I</mi><mi>i</mi></msub><mo>.</mo><mi>m</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi><mi>s</mi><mo>∧</mo><mi>M</mi><mo>.</mo><mi>a</mi><mi>b</mi><mi>s</mi><mi>t</mi><mi>r</mi><mi>a</mi><mi>c</mi><mi>t</mi><mo>→</mo></math> <literal>M</literal> is accessible from <literal>C</literal>.<?asciidoc-br?>
+Note that <literal>M</literal> need not be an owned member of <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>I</mi><mi>i</mi></msub></math>.</simpara>
+</listitem>
+</orderedlist>
+</requirement>
+<simpara>For default methods in interfaces, see <xref linkend="_default-methods-in-interfaces"/>.</simpara>
+</section>
+</section>
+</section>
+<section xml:id="_generic-classifiers" role="language-n4js">
+<title>Generic Classifiers</title>
+<simpara>Classifiers can be declared generic by defining a type parameter via <literal>type-param</literal>.</simpara>
+<definition>
+<title>Generic Classifiers</title>
+<simpara>
+<anchor xml:id="generic_classifiers" xreflabel="[generic_classifiers]"/>
+<emphasis role="strong">Definition:</emphasis>
+<link linkend="generic_classifiers">Generic Classifiers</link></simpara>
+<simpara>
+
+A generic classifier is a classifier with at least one type parameter.
+That is, a given classifier <literal>C</literal> is generic if and only if <math xmlns="http://www.w3.org/1998/Math/MathML"><mo>|</mo><mi>C</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>P</mi><mi>a</mi><mi>r</mi><mi>s</mi><mo>|</mo><mo>≥</mo><mn>1</mn></math>.</simpara>
+<simpara>If a classifier does not define any type parameters, it is not generic, even if its superclass or any implemented interface is generic.</simpara>
+<simpara>The format of the type parameter expression is described in <xref linkend="_parameterized-types"/>.
+The type variable defined by the type parameter’s type expression can be used just like a normal type inside the class definition.</simpara>
+<simpara>If using a generic classifier as type of a variable, it may be parameterized.
+This is usually done via a type expression (cf. <xref linkend="_parameterized-types"/>) or via <literal>typearg</literal> in case of supertypes.
+If a generic classifier defines multiple type variables, these variables are bound in the order of their definition.
+In any case, all type variables have to be bound.
+That means in particular that raw types are not allowed. (cf <xref linkend="_parameterized-types"/> for details).</simpara>
+<simpara>If a generic classifier is used as super classifier, the type arguments can be type variables.
+Note that the type variable of the super classifier is not lifted, that is to say that all type variables are to be explicitly bound in the type references used in the <literal>extend</literal>, <literal>with</literal>, or <literal>implements</literal> section using <literal>typearg</literal>.
+If a type variable is used in <literal>typearg</literal> to bound a type variable of a type parameter, it has to fulfil possible type constraints (upper/lower bound) specified in the type parameter.</simpara>
+</definition>
+<example>
+<title>Generic Type Definition and Usage as Type of Variable</title>
+<simpara>This example demonstrates how to define a generic type and how to refer to it in a variable definition.</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">export class Container&lt;T&gt; {
+    private item: T;
+
+    getItem(): T {
+        return this.item;
+    }
+
+    setItem(item: T): void {
+        this.item = item;
+    }
+}</programlisting>
+</example>
+<simpara>This type can now be used as a type of a variable as follows</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">import Container from "p/Container"
+
+var stringContainer: Container&lt;string&gt; = new Container&lt;string&gt;();
+stringContainer.setItem("Hello");
+var s: string = stringContainer.getItem();</programlisting>
+<simpara>In line 3, the type variable <literal>T</literal> of the generic class <literal>Container</literal> is bound to <literal>string</literal>.</simpara>
+<example>
+<title>Binding of type variables with multiple types</title>
+<simpara>For a given generic class <literal>G</literal></simpara>
+<programlisting language="n4js" linenumbering="unnumbered">class A{}
+class B{}
+class C extends A{}
+
+class G&lt;S, T extends A, U extends B&gt; {
+}</programlisting>
+<simpara>the variable definition</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">var x: G&lt;Number,C,B&gt;;</programlisting>
+<simpara>would bind the type variables as follows:</simpara>
+<informaltable frame="all" rowsep="1" colsep="1">
+<tgroup cols="3">
+<colspec colname="col_1" colwidth="16.6666*"/>
+<colspec colname="col_2" colwidth="16.6666*"/>
+<colspec colname="col_3" colwidth="66.6668*"/>
+<tbody>
+<row>
+<entry align="center" valign="top"><simpara><literal>S</literal></simpara></entry>
+<entry align="center" valign="top"><simpara><literal>Number</literal></simpara></entry>
+<entry align="center" valign="top"><simpara>Bound by first type argument, no bound constraints defined for <literal>S</literal>.</simpara></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><literal>T</literal></simpara></entry>
+<entry align="center" valign="top"><simpara><literal>C</literal></simpara></entry>
+<entry align="center" valign="top"><simpara>Bound by second type argument, <literal>C</literal> must be a subtype of in order to fulfill the type constraint.</simpara></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><literal>U</literal></simpara></entry>
+<entry align="center" valign="top"><simpara><literal>B</literal></simpara></entry>
+<entry align="center" valign="top"><simpara>Bound by third type argument, <literal>extends</literal> is reflexive, that is <literal>B</literal> fulfills the
+type constraint.</simpara></entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+</example>
+<requirement xml:id="IDE-51">
+<title>Generic Superclass, Type Argument with Type Variable</title>
+<simpara>
+<anchor xml:id="Req-IDE-51" xreflabel="[Req-IDE-51]"/>
+<emphasis role="strong">Requirement: IDE-51:</emphasis>
+<link linkend="Req-IDE-51">Generic Superclass, Type Argument with Type Variable</link> (ver. 1)</simpara>
+    <simpara>
+
+For a given generic superclass <literal>SuperClass</literal></simpara>
+<programlisting language="n4js" linenumbering="unnumbered">class SuperClass&lt;S, T extends A, U extends B&gt; {};</programlisting>
+<simpara>and a generic subclass <literal>SubClass</literal></simpara>
+<programlisting language="n4js" linenumbering="unnumbered">class SubClass&lt;X extends A&gt; extends SuperClass&lt;Number, X, B&gt; {..};</programlisting>
+<simpara>the variable definition</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">var s: SubClass&lt;C&gt;;</programlisting>
+<simpara>would bind the type variables as follows:<?asciidoc-br?></simpara>
+<informaltable frame="all" rowsep="1" colsep="1">
+<tgroup cols="3">
+<colspec colname="col_1" colwidth="16.6666*"/>
+<colspec colname="col_2" colwidth="16.6666*"/>
+<colspec colname="col_3" colwidth="66.6668*"/>
+<thead>
+<row>
+<entry align="center" valign="top">TypeVariable</entry>
+<entry align="center" valign="top">Bound to</entry>
+<entry align="center" valign="top">Explanation</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry align="center" valign="top"><simpara><literal>SuperClass.S</literal></simpara></entry>
+<entry align="center" valign="top"><simpara><literal>Number</literal></simpara></entry>
+<entry align="left" valign="top"><simpara>Type variable <literal>s</literal> of supertype <literal>SuperClass</literal> is bound to <literal>Number</literal>.</simpara></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><literal>SuperClass.T</literal></simpara></entry>
+<entry align="center" valign="top"><simpara><literal>SubClass.X=C</literal></simpara></entry>
+<entry align="left" valign="top"><simpara>Type variable <literal>T</literal> of supertype <literal>SuperClass</literal> is bound to type variable <literal>X</literal> of <literal>SubClass</literal>. It gets
+then indirectly bound to <literal>C</literal> as specified by the type argument of the
+variable definition.</simpara></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><literal>SuperClass.U</literal></simpara></entry>
+<entry align="center" valign="top"><simpara><literal>B</literal></simpara></entry>
+<entry align="left" valign="top"><simpara>Type variable <literal>U</literal> of supertype <literal>SuperClass</literal> is auto-bound to <literal>C</literal> as no explicit binding for the third type variable is specified.</simpara></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><literal>SubClass.X</literal></simpara></entry>
+<entry align="center" valign="top"><simpara><literal>C</literal></simpara></entry>
+<entry align="left" valign="top"><simpara>Bound by first type argument specified in variable definition.</simpara></entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+</requirement>
+</section>
+<section xml:id="sec:definition-site-variance" role="language-n4js">
+<title>Definition-Site Variance</title>
+<simpara>In addition to use-site declaration of variance in the form of Java-like wildcards, N4JS provides support for definition-site declaration of variance as known from languages such as C# and Scala.</simpara>
+<simpara>The <emphasis>variance</emphasis> of a parameterized type states how its subtyping relates to its type arguments’ subtyping.
+For example, given a parameterized type <literal>G&lt;T&gt;</literal> and plain types <literal>A</literal> and <literal>B</literal>, we know</simpara>
+<itemizedlist>
+<listitem>
+<simpara>if <literal>G</literal> is <emphasis role="strong">covariant</emphasis> w.r.t. its parameter <literal>T</literal>, then</simpara>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mstyle mathvariant="monospace"><mtext>B</mtext></mstyle><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mstyle mathvariant="monospace"><mtext>A</mtext></mstyle><mo>→</mo><mstyle mathvariant="monospace"><mtext>G</mtext></mstyle><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>B</mtext></mstyle><mo>&gt;</mo><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mstyle mathvariant="monospace"><mtext>G</mtext></mstyle><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>A</mtext></mstyle><mo>&gt;</mo></math></simpara>
+</listitem>
+<listitem>
+<simpara>if <literal>G</literal> is <emphasis role="strong">contravariant</emphasis> w.r.t. its parameter <literal>T</literal>, then</simpara>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mstyle mathvariant="monospace"><mtext>B</mtext></mstyle><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mstyle mathvariant="monospace"><mtext>A</mtext></mstyle><mo>→</mo><mstyle mathvariant="monospace"><mtext>G</mtext></mstyle><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>A</mtext></mstyle><mo>&gt;</mo><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mstyle mathvariant="monospace"><mtext>G</mtext></mstyle><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>B</mtext></mstyle><mo>&gt;</mo></math></simpara>
+</listitem>
+<listitem>
+<simpara>if <literal>G</literal> is <emphasis role="strong">invariant</emphasis> w.r.t. its parameter <literal>T</literal>, then</simpara>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mstyle mathvariant="monospace"><mtext>B</mtext></mstyle><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mstyle mathvariant="monospace"><mtext>A</mtext></mstyle><mo>→</mo><mstyle mathvariant="monospace"><mtext>G</mtext></mstyle><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>A</mtext></mstyle><mo>&gt;</mo><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mstyle mathvariant="monospace"><mtext>G</mtext></mstyle><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>B</mtext></mstyle><mo>&gt;</mo></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mstyle mathvariant="monospace"><mtext>B</mtext></mstyle><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mstyle mathvariant="monospace"><mtext>A</mtext></mstyle><mo>→</mo><mstyle mathvariant="monospace"><mtext>G</mtext></mstyle><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>A</mtext></mstyle><mo>&gt;</mo><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mstyle mathvariant="monospace"><mtext>G</mtext></mstyle><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>B</mtext></mstyle><mo>&gt;</mo></math></simpara>
+</listitem>
+</itemizedlist>
+<simpara>Note that variance is declared per type parameter, so a single parameterized type with more than one type parameter may be, for example, covariant w.r.t. one type parameter and contravariant w.r.t. another.</simpara>
+<simpara>Strictly speaking, a type parameter/variable itself is not co- or contravariant;<?asciidoc-br?>
+however, for the sake of simplicity we say <emphasis><literal>T</literal> is covariant</emphasis> as a short form for <emphasis><literal>G</literal> is covariant with respect to its type parameter <literal>T</literal></emphasis> (for contravariant and invariant accordingly).</simpara>
+<simpara>To declare the variance of a parameterized classifier on definition site, simply add keyword <literal>in</literal> or <literal>out</literal> before the corresponding type parameter:</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">class ReadOnlyList&lt;out T&gt; { // covariance
+    // ...
+}
+
+interface Consumer&lt;in T&gt; { // contravariance
+    // ...
+}</programlisting>
+<simpara>In such cases, the following constraints apply.</simpara>
+<requirement xml:id="IDE-174">
+<title>Definition-Site Variance</title>
+<simpara>
+<anchor xml:id="Req-IDE-174" xreflabel="[Req-IDE-174]"/>
+<emphasis role="strong">Requirement: IDE-174:</emphasis>
+<link linkend="Req-IDE-174">Definition-Site Variance</link> (ver. 1)</simpara>
+    <simpara>
+
+Given a parameterized type with a type parameter , the following must hold:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara><literal>T</literal> may only appear in variance-compatible positions:</simpara>
+<orderedlist numeration="loweralpha">
+<listitem>
+<simpara>if <literal>T</literal> is declared on definition site to be <emphasis role="strong">covariant</emphasis>, then it may only appear in covariant positions within the type’s non-private member declarations.</simpara>
+</listitem>
+<listitem>
+<simpara>if <literal>T</literal> is declared on definition site to be <emphasis role="strong">contravariant</emphasis>, then it may only appear in contravariant positions within the type’s non-private member declarations.</simpara>
+</listitem>
+<listitem>
+<simpara>if <literal>T</literal> is <emphasis role="strong">invariant</emphasis>, i.e. neither declared covariant nor declared contravariant on definition site, then it may appear in any position (where type variables are allowed).</simpara>
+<simpara>Thus, no restrictions apply within the declaration of private members and within the body of field accessors and methods.</simpara>
+</listitem>
+</orderedlist>
+</listitem>
+<listitem>
+<simpara>definition-site variance may not be combined with incompatible use-site variance:</simpara>
+<orderedlist numeration="loweralpha">
+<listitem>
+<simpara>if <literal>T</literal> is declared on definition site to be <emphasis role="strong">covariant</emphasis>, then no wildcard with a <emphasis role="strong">lower</emphasis> bound may be provided as type argument for <literal>T</literal>.</simpara>
+</listitem>
+<listitem>
+<simpara>if <literal>T</literal> is declared on definition site to be <emphasis role="strong">contravariant</emphasis>, then no wildcard with an <emphasis role="strong">upper</emphasis> bound may be provided as type argument for <literal>T</literal>.</simpara>
+</listitem>
+<listitem>
+<simpara>if <literal>T</literal> is <emphasis role="strong">invariant</emphasis>, i.e. neither declared covariant nor declared contravariant on definition site, then any kind of wildcard may be provided as type argument.</simpara>
+<simpara>Unbounded wildcards are allowed in all cases.</simpara>
+</listitem>
+</orderedlist>
+</listitem>
+</orderedlist>
+</requirement>
+<example xml:id="ex:use-site-declaration-variance">
+<title>Use-site declaration of variance</title>
+<simpara>For illustration purposes, let’s compare use-site and definition-site declaration of variance.
+Since use-site variance is more familiar to the Java developer, we start with this flavor.</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">class Person {
+    name: string;
+}
+class Employee extends Person {}
+
+interface List&lt;T&gt; {
+    add(elem: T)
+    read(idx: int): T
+}
+
+function getNameOfFirstPerson(list: List&lt;? extends Person&gt;): string {
+    return list.read(0).name;
+}</programlisting>
+<simpara>Function <literal>getNameOfFirstPerson</literal> below takes a list and returns the name of the first person in the list.
+Since it never adds new elements to the given list, it could accept <literal>List</literal>s of any subtype of <literal>Person</literal>, for example a <literal>List&lt;Employee&gt;</literal>.
+To allow this, its formal parameter has a type of <literal>List&lt;? extends Person&gt;</literal> instead of <literal>List&lt;Person&gt;</literal>.
+Such use-site variance is useful whenever an invariant type, like <literal>List</literal> above, is being used in a way such that it can be treated as if it were co- or contravariant.</simpara>
+<simpara>Sometimes, however, we are dealing with types that are inherently covariant or contravariant, for example an <literal>ImmutableList</literal> from which we can only read elements would be covariant.
+In such a case, use-site declaration of variance is tedious and error-prone: we would have to declare the variance wherever the type is being used and would have to
+make sure not to forget the declaration or otherwise limit the flexibility and reusability of the code (for example, in the above code we could not call <literal>getNameOfFirstPerson</literal> with a <literal>List&lt;Employee&gt;</literal>).</simpara>
+<simpara>The solution is to declare the variance on declaration site, as in the following code sample:</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">interface ImmutableList&lt;out T&gt; {
+//  add(elem: T)  // error: such a method would now be disallowed
+    read(idx: int): T
+}
+
+function getNameOfFirstPerson2(list: ImmutableList&lt;Person&gt;): string {
+    return list.read(0).name;
+}</programlisting>
+<simpara>Now we can invoke <literal>getNameOfFirstPerson2</literal> with a <literal>List&lt;Employee&gt;</literal> even though the implementor of <literal>getNameOfFirstPerson2</literal> did not add a
+use-site declaration of covariance, because the type <literal>ImmutableList</literal> is declared to be covariant with respect to its parameter <literal>T</literal>, and this applies globally
+throughout the program.</simpara>
+</example>
+</section>
+</section>
+<section xml:id="_members">
+<title>Members</title>
+<simpara>A member is either a method (which may be a special constructor function), a data field, or a getter or a setter.
+The latter two implicitly define an accessor field.
+Similar to object literals, there must be no data field with the same name as a getter or setter.</simpara>
+<simpara>(overriding, implementation and consumption) is
+described in <xref linkend="_redefinition-of-members"/>.</simpara>
+<section xml:id="_syntax-4" role="language-n4js">
+<title>Syntax</title>
+<formalpara>
+<title>Syntax N4JS member access modifier</title>
+<para>
+<programlisting language="xtext" linenumbering="unnumbered">enum N4JSMemberAccessModifier: private | project | protected | public;
+
+N4MemberDeclaration: N4MethodDeclaration | N4FieldDeclaration | N4GetterDeclaration | N4SetterDeclaration;</programlisting>
+</para>
+</formalpara>
+<section xml:id="_properties-3">
+<title>Properties</title>
+<simpara>Members share the following properties:</simpara>
+<variablelist>
+<varlistentry>
+<term><literal>annotations</literal> </term>
+<listitem>
+<simpara>Arbitrary annotations, see <xref linkend="_annotations"/> for details.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>accessModifier</literal> </term>
+<listitem>
+<simpara>N4JS member access modifier: <literal>private</literal>, <literal>project</literal>, <literal>potected</literal>, or <literal>public</literal>; the latter two can be combined with <literal>@Internal</literal>; default is <literal>project</literal> for classes and private interfaces.
+For a non-private interface defaults to the interface’s visibility.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>name</literal> </term>
+<listitem>
+<simpara>The simple name of the member, that is an identifier name (cf. <xref linkend="_valid-names"/>).</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>static</literal> </term>
+<listitem>
+<simpara>Boolean property to distinguish instance from classifier members, see <xref linkend="_static-members"/>.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+<simpara>The following pseudo properties are defined via annotations:</simpara>
+<variablelist>
+<varlistentry>
+<term><literal>deprecated</literal> </term>
+<listitem>
+<simpara>Boolean property set to true if annotation <literal>@Deprecated</literal> is set. <footnote><simpara>not yet implemented</simpara></footnote></simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+<simpara>And we additionally define the following pseudo properties:</simpara>
+<variablelist>
+<varlistentry>
+<term><literal>acc</literal> </term>
+<listitem>
+<simpara>Member access modifier as described in <xref linkend="_accessibility-of-members"/>, it is the aggregated value of
+the <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>a</mi><mi>c</mi><mi>c</mi><mi>e</mi><mi>s</mi><mi>s</mi><mi>M</mi><mi>o</mi><mi>d</mi><mi>i</mi><mi>f</mi><mi>i</mi><mi>e</mi><mi>r</mi></math> and the <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>e</mi><mi>x</mi><mi>p</mi><mi>o</mi><mi>r</mi><mi>t</mi></math> property.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>owner</literal> </term>
+<listitem>
+<simpara>Owner classifier of the member.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>typeRef</literal> </term>
+<listitem>
+<simpara>Type of the member—this is the type of a field or the type of the method which is a function type (and not the return type).</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>assignability</literal> </term>
+<listitem>
+<simpara>Enumeration, may be one of the following values:</simpara>
+<variablelist>
+<varlistentry>
+<term><literal>set</literal></term>
+<listitem>
+<simpara>Member may only be set, i.e. it could only be used on the left hand   side of an assignment.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>get</literal></term>
+<listitem>
+<simpara>Member may only be retrieved, i.e. it could only be used on the right hand side of an assignment. This is the default setting for methods.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>any</literal></term>
+<listitem>
+<simpara>  Member may be set or retrieved, i.e. it could only be used on the left or right hand side of an assignment.
+This is the default setting for fields.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+</variablelist>
+<note>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>a</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>g</mi><mi>n</mi><mi>a</mi><mi>b</mi><mi>i</mi><mi>l</mi><mi>i</mi><mi>t</mi><mi>y</mi></math> is related but not equal to writable modifiers used for fields.
+We define a partial order on this enumeration as follows:<?asciidoc-br?></simpara>
+</note>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mo>&lt;</mo><mfenced close=")" open="("><mi>l</mi><mi>r</mi></mfenced><mspace width="3.0mm"/><mi>:</mi><mi>:</mi><mo>=</mo><mspace width="3.0mm"/><mfenced close="}" open="{"><mfenced close=")" open="("><mstyle mathvariant="monospace"><mtext>set</mtext></mstyle><mstyle mathvariant="monospace"><mtext>any</mtext></mstyle></mfenced><mfenced close=")" open="("><mstyle mathvariant="monospace"><mtext>get</mtext></mstyle><mstyle mathvariant="monospace"><mtext>any</mtext></mstyle></mfenced></mfenced></math>
+<variablelist>
+<varlistentry>
+<term><literal>abstract</literal> </term>
+<listitem>
+<simpara>All members have a flag <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>a</mi><mi>b</mi><mi>s</mi><mi>t</mi><mi>r</mi><mi>a</mi><mi>c</mi><mi>t</mi></math>, which is user-defined for methods, getters and setter, but which is always false for fields.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+<simpara>The following pseudo property is set to make fields compatible with properties of an object literal, however it cannot be changed:</simpara>
+<variablelist>
+<varlistentry>
+<term><literal>configurable</literal> </term>
+<listitem>
+<simpara>Boolean flag reflecting the property descriptor <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>c</mi><mi>o</mi><mi>n</mi><mi>f</mi><mi>i</mi><mi>g</mi><mi>u</mi><mi>r</mi><mi>a</mi><mi>b</mi><mi>l</mi><mi>e</mi></math>, this is always set to false for members.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+</section>
+</section>
+<section xml:id="_semantics-3">
+<title>Semantics</title>
+<simpara>The members of a given classifier <literal>C</literal> must be named such that the following constraints are met:</simpara>
+<requirement xml:id="IDE-52">
+<title>Member Names</title>
+<simpara>
+<anchor xml:id="Req-IDE-52" xreflabel="[Req-IDE-52]"/>
+<emphasis role="strong">Requirement: IDE-52:</emphasis>
+<link linkend="Req-IDE-52">Member Names</link> (ver. 1)</simpara>
+    <simpara>
+
+. The name of a member is given as an identifier, a string literal, a numeric literal, or as a computed property name with a compile-time expression (see <xref linkend="compile-time-expressions"/>). In particular, string literals, e.g. <literal>['myProp']</literal>, built-in symbols, e.g. <literal>[Symbol.iterator]</literal>, and literals of <literal>@StringBased</literal> enums are all valid computed property names.
+.  No two members may have the same name, except one is static and the
+other is non-static:</simpara>
+<simpara>+</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mtable><mtr><mtd><mo>∀</mo><msub><mi>m</mi><mn>1</mn></msub><mo>,</mo><msub><mi>m</mi><mn>2</mn></msub><mo>∈</mo><mi>C</mi><mo>.</mo><mi>o</mi><mi>w</mi><mi>n</mi><mi>e</mi><mi>d</mi><mi>M</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi><mi>s</mi><mo>,</mo><msub><mi>m</mi><mn>1</mn></msub><mo>≠</mo><msub><mi>m</mi><mn>2</mn></msub><mi>:</mi><msub><mi>m</mi><mn>1</mn></msub><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>≠</mo><msub><mi>m</mi><mn>2</mn></msub><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>∨</mo><msub><mi>m</mi><mn>1</mn></msub><mo>.</mo><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>c</mi><mo>≠</mo><msub><mi>m</mi><mn>2</mn></msub><mo>.</mo><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>c</mi></mtd></mtr></mtable></math>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>The member name must be a valid identifier name, see <link linkend="_identifier-names-and-identifiers">Identifier Grammar</link>.</simpara>
+</listitem>
+</orderedlist>
+</requirement>
+<simpara>Thus, over<emphasis>loading</emphasis> of methods is not supported <footnote><simpara>In order to emulate method overloading, union types are to be used.</simpara></footnote> and no field may have the same name as a method.
+However, over<emphasis>riding</emphasis> of methods, getters, and setters are possible, see <xref linkend="_redefinition-of-members"/>.
+Static members may also have the same name as non-static members.<footnote><simpara>[<link linkend="ECMA15a">ECMA15a(p.p214)</link>], <literal>ClassBody : ClassElementList</literal> indicates that it is possible to have the same name for instance and static members.</simpara></footnote></simpara>
+<simpara>The dollar character <literal>$</literal> is not allowed for user-defined member identifiers as the dollar sign is used for rewriting private members.</simpara>
+</section>
+<section xml:id="_methods" role="language-n4js">
+<title>Methods</title>
+<simpara>Methods are simply JavaScript functions.
+They are defined similarly to methods as proposed in [<link linkend="ECMA15a">ECMA15a(p.S13.5)</link>] except for the type information and some modifiers.</simpara>
+<section xml:id="_syntax-5">
+<title>Syntax</title>
+<formalpara>
+<title>Syntax Method Declaration</title>
+<para>
+<programlisting language="xtext" linenumbering="unnumbered">N4MethodDeclaration &lt;Yield&gt;:
+    =&gt; ({N4MethodDeclaration}
+        annotations+=Annotation*
+        accessModifier=N4JSMemberAccessModifier?
+        (abstract?=’abstract’ | static?=’static’)?
+        TypeVariables?
+        (
+                generator?='*' LiteralOrComputedPropertyName&lt;Yield&gt; -&gt; MethodParamsReturnAndBody &lt;Generator=true&gt;
+            |   AsyncNoTrailingLineBreak LiteralOrComputedPropertyName&lt;Yield&gt; -&gt; MethodParamsReturnAndBody &lt;Generator=false&gt;
+        )
+    ) ';'?
+;
+
+fragment MethodParamsAndBody &lt;Generator&gt;*:
+    StrictFormalParameters&lt;Yield=Generator&gt;
+    (body=Block&lt;Yield=Generator&gt;)?
+;
+
+fragment MethodParamsReturnAndBody &lt;Generator&gt;*:
+    StrictFormalParameters&lt;Yield=Generator&gt;
+    (':' returnTypeRef=TypeRef)?
+    (body=Block&lt;Yield=Generator&gt;)?
+;
+
+fragment LiteralOrComputedPropertyName &lt;Yield&gt;*:
+    name=IdentifierName | name=STRING | name=NumericLiteralAsString
+    | '[' (=&gt;((name=SymbolLiteralComputedName&lt;Yield&gt; | name=StringLiteralAsName) ']') | computeNameFrom=AssignmentExpression&lt;In=true,Yield&gt; ']')
+;
+
+SymbolLiteralComputedName &lt;Yield&gt;:
+    BindingIdentifier&lt;Yield&gt; ('.' IdentifierName)?
+;
+
+BindingIdentifier &lt;Yield&gt;:
+    IDENTIFIER
+    | &lt;!Yield&gt; 'yield'
+    | N4Keyword
+;
+
+IdentifierName: IDENTIFIER | ReservedWord | N4Keyword;
+NumericLiteralAsString: DOUBLE | INT | OCTAL_INT | HEX_INT | SCIENTIFIC_INT;
+StringLiteralAsName: STRING;
+
+fragment AsyncNoTrailingLineBreak *: (declaredAsync?='async' NoLineTerminator)?;  // See Asynchronous Functions
+
+fragment StrictFormalParameters &lt;Yield&gt;*:
+    '(' (fpars+=FormalParameter&lt;Yield&gt; (',' fpars+=FormalParameter&lt;Yield&gt;)*)? ')'
+;
+
+FormalParameter &lt;Yield&gt;:
+    {FormalParameter} BindingElementFragment&lt;Yield&gt;
+;
+
+fragment BindingElementFragment &lt;Yield&gt;*:
+    (=&gt; bindingPattern=BindingPattern&lt;Yield&gt;
+    | annotations+=Annotation*
+        (
+            variadic?='...'? name=BindingIdentifier&lt;Yield&gt; ColonSepTypeRef?
+        )
+    )
+    ('=' initializer=AssignmentExpression&lt;In=true, Yield&gt;)?
+;
+
+fragment ColonSepTypeRef*:
+    ':' declaredTypeRef=TypeRef
+;</programlisting>
+</para>
+</formalpara>
+</section>
+<section xml:id="_properties-4" role="language-n4js">
+<title>Properties</title>
+<simpara>Methods have all the properties of members and the following additional properties can be explicitly defined:</simpara>
+<variablelist>
+<varlistentry>
+<term><literal>abstract</literal> </term>
+<listitem>
+<simpara>Method is declared but not defined.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>typePars</literal> </term>
+<listitem>
+<simpara>Collection of type parameters of a generic method; empty by default.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>returnTypeRef</literal> </term>
+<listitem>
+<simpara>Return type of the method, default return type is <math xmlns="http://www.w3.org/1998/Math/MathML"><mstyle mathvariant="italic"><mi>V</mi><mi>o</mi><mi>i</mi><mi>d</mi></mstyle></math>.
+The type of the method as a member of the owning classifier is not the method’s return type but is instead a function type.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>fpars</literal> </term>
+<listitem>
+<simpara>List of formal parameters, may be left empty.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>body</literal> </term>
+<listitem>
+<simpara>The body of the method (this is not available in the pure types model)</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+<simpara>The following pseudo properties are defined via annotations:</simpara>
+<variablelist>
+<varlistentry>
+<term><literal>final</literal> </term>
+<listitem>
+<simpara>Boolean flag set to true if annotation <literal>@Final</literal> is set.
+The flag indicates that method must not be overridden in subclasses; see <xref linkend="_final-methods"/>.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>declaresOverride</literal> </term>
+<listitem>
+<simpara>Flag set to true if annotation <literal>@Overrides</literal> is set. The flag indicates that method must override a method of a superclass; see <xref linkend="_overriding-of-members"/>.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+<simpara>Additionally, we define the following pseudo properties:</simpara>
+<variablelist>
+<varlistentry>
+<term><literal>overrides</literal> </term>
+<listitem>
+<simpara>True if method overrides a super method or implements an interface method, false otherwise.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>typeRef</literal> </term>
+<listitem>
+<simpara>Type of the method. This is, in fact, a function type (and not the return type).</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+<simpara>The following pseudo property is set to make methods compatible with properties of an object literal, however it cannot be changed:</simpara>
+<variablelist>
+<varlistentry>
+<term><literal>enumerable</literal> </term>
+<listitem>
+<simpara>Boolean flag reflecting the property descriptor <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>e</mi><mi>n</mi><mi>u</mi><mi>m</mi><mi>e</mi><mi>r</mi><mi>a</mi><mi>b</mi><mi>l</mi><mi>e</mi></math>, this is always set to false for methods.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+</section>
+<section xml:id="_semantics-4">
+<title>Semantics</title>
+<simpara>Since methods are ECMAScript functions, all constraints specified in <xref linkend="_function-type"/> apply to methods as well.
+This section describes default values and function type conformance which is required for overriding and implementing methods.</simpara>
+<simpara>In addition, method declarations and definitions have to comply with the constraints for naming members of classifiers (cf. <xref linkend="Req-IDE-52"/>)
+and with the constraints detailed in the following sections on final methods (<xref linkend="_final-methods"/>), abstract methods (<xref linkend="_abstract-methods"/> and
+method overriding and implementation (<xref linkend="_overriding-of-members"/>, <xref linkend="_implementation-of-members"/>).</simpara>
+<simpara>The following constraints are defined for methods in ECMAScript 6 [<link linkend="ECMA15a">ECMA15a(p.207)</link>]</simpara>
+<requirement xml:id="IDE-53">
+<title>Method Definition ECMAScript 6</title>
+<simpara>
+<anchor xml:id="Req-IDE-53" xreflabel="[Req-IDE-53]"/>
+<emphasis role="strong">Requirement: IDE-53:</emphasis>
+<link linkend="Req-IDE-53">Method Definition ECMAScript 6</link> (ver. 1)</simpara>
+    <simpara>
+
+* It is a Syntax Error if any element of the BoundNames of StrictFormalParameters also occurs in the VarDeclaredNames of FunctionBody.
+* It is a Syntax Error if any element of the BoundNames of StrictFormalParameters also occurs in the LexicallyDeclaredNames of FunctionBody.</simpara>
+</requirement>
+<simpara>Methods – like functions – define a variable execution environment and therefore provide access to the actual passed-in parameters through the implicit <literal>arguments</literal> variable inside of their bodies (c.f. <xref linkend="_arguments-object"/>).</simpara>
+<simpara>Methods are similar to function definitions but they must not be assigned to or from variables.
+The following code issues an error although the type of the method would be compatible to the type of the variable <literal>v</literal>:</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">class C {
+    m(): void {}
+}
+var v: {function():void} = new C().m;</programlisting>
+<requirement xml:id="IDE-54">
+<title>Method Assignment</title>
+<simpara>
+<anchor xml:id="Req-IDE-54" xreflabel="[Req-IDE-54]"/>
+<emphasis role="strong">Requirement: IDE-54:</emphasis>
+<link linkend="Req-IDE-54">Method Assignment</link> (ver. 1)</simpara>
+    <simpara>
+
+. In contrast to ECMAScript 2015, methods are defined as readonly, that is, it is not possible to dynamically re-assign a property defined as method with a new value.
+This is because assigning or re-assigning a method breaks encapsulation. Methods are the <xref linkend="_acronyms"/> of a class, their implementation is internal to the class.
+.  When assigning a method to a variable, a warning is issued since this would lead to an detached this reference inside the method when it is called without explicitly providing the receiver. No warning is issued only if it is guaranteed that no problems will occur:
+..  The method’s body can be determined at compile time (i.e., it has been declared <literal>@Final</literal>) and it lacks usages of <literal>this</literal> or <literal>super</literal>. This is true for instance and static methods.
+..  The method is the constructor.</simpara>
+</requirement>
+<note>
+<simpara>The following code demonstrates problems arising when methods are assigned to variables in terms of function expressions.
+Given are two classes and instances of each class as follows:</simpara>
+</note>
+<programlisting language="n4js" linenumbering="unnumbered">class C {
+    m(): void { }
+    static k(): void {}
+}
+class D extends C {
+    @Override m(): void { this.f()}
+    f(): void {}
+
+    @Override static k(): void { this.f()}
+    static f(): void {}
+}
+var c: C = new C();
+var d: C = new D(); // d looks like a C</programlisting>
+<simpara>Assigning an instance method to a variable could cause problems, as the method assumes this to be bound to the class in which it is defined.
+This may work in some cases, but will cause problems in particular in combination with method overriding:</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">var v1: {@This(C)function():void} = c.m;
+var v2: {@This(C)function():void} = d.m;
+
+v1.call(c);
+v2.call(c);</programlisting>
+<simpara>Calling <literal>c.m</literal> indirectly via <literal>v1</literal> with <literal>c</literal> as this object will work.
+However, it won’t work for <literal>v2</literal>: the method is overridden in <literal>D</literal>, and the method in expects other methods available in <literal>D</literal> but not in <literal>C</literal>.
+That is, the last call would lead to a runtime error as method <literal>f</literal> which is called in <literal>D.m</literal> won’t be available.</simpara>
+<simpara>The same scenario occurs in case of static methods if they are retrieved polymorphically via the variables of type <literal>constructor{C}</literal>:</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">var ctor: constructor{C} = C;
+var dtor: constructor{C} = D;
+
+var v3: {@This(constructor{C})function():void} = ctor.k;
+var v4: {@This(constructor{C})function():void} = dtor.k;</programlisting>
+<simpara>In both cases, the problem could be solved by restricting these kinds of assignments to final methods only.
+In the static case, the problem would also be solved by accessing the static method directly via the class type (and not polymorphically via the constructor).
+Both restrictions are severe but would be necessary to avoid unexpected runtime problems.</simpara>
+<simpara>The following example shows a problem with breaking the encapsulation of a class.</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">class C {
+    x: any = "";
+    f(): void { this.g(this); }
+    g(c: C): void { c.h(); }
+    h(): void {}
+}
+class D extends C {
+
+    @Override f(): void {
+        this.g(this.x);
+    }
+    @Override g(c: any) {
+        // do nothing, do not call h())
+    }
+}
+
+var c = new C();
+var d = new D();
+
+var v5: {@This(C)function():void} = c.f;
+var v6: {@This(C)function():void} = d.f;
+
+v5.call(c)
+v6.call(c)</programlisting>
+<simpara>In <literal>D</literal>, method <literal>g</literal> is overridden to accept more types as the original method defined in <literal>C</literal>.
+Calling this new method with receiver type <literal>C</literal> (as done in the last line) will cause problems, as in <literal>D</literal> not only <literal>f</literal> has been adapted but also <literal>g</literal>.
+Eventually, this would lead to a runtime error as well.</simpara>
+</section>
+<section xml:id="_final-methods">
+<title>Final Methods</title>
+<simpara>By default, methods can be overridden.
+To prevent a method from being overridden, it must be annotated with <literal>@Final</literal>.</simpara>
+<simpara>Of course, a method cannot be declared both abstract and final (cf. <xref linkend="Req-IDE-46"/>).
+Private methods are implicitly declared final.
+Because static methods can be overridden in subclasses (which is different to Java), they also can be marked as final.</simpara>
+<simpara>Default methods in interfaces, cf. <xref linkend="_default-methods-in-interfaces"/>, may also be declared <literal>@Final</literal>.</simpara>
+<example>
+<title>Final Methods in Interfaces</title>
+<simpara>If a method in an interface is provided with a body, it may be declared final.
+This will ensure that the given method’s body will be in effect for all instances of the interface.
+Note that this means that;</simpara>
+<orderedlist numeration="loweralpha">
+<listitem>
+<simpara>a class implementing that interface must not define a method with the same name and</simpara>
+</listitem>
+<listitem>
+<simpara>a class inheriting a method of that name cannot implement this interface.</simpara>
+</listitem>
+</orderedlist>
+<simpara>The latter case is illustrated here:</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">interface I {
+    @Final m(): void {}
+}
+
+class C1 {
+    m(): void {}
+}
+
+// error at "I": "The method C1.m cannot override final method I.m."
+class C2 extends C1 implements I {
+}</programlisting>
+</example>
+</section>
+<section xml:id="_abstract-methods">
+<title>Abstract Methods</title>
+<simpara>A method can be declared without defining it, i.e. without providing a method body, and is then called an <emphasis>abstract method</emphasis>.
+Such methods must be declared with modifier <literal>abstract</literal> and have their property <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>a</mi><mi>b</mi><mi>s</mi><mi>t</mi><mi>r</mi><mi>a</mi><mi>c</mi><mi>t</mi></math> set to true.
+Constraints for abstract methods are covered in <xref linkend="Req-IDE-46"/> (see <xref linkend="_abstract-classes"/>).</simpara>
+<simpara>In interfaces, methods are always abstract by default and they do not have to be marked as abstract.
+If a method in an interface provides a body, then this is the default implementation.
+See <xref linkend="_implementation-of-members"/> about how the default implementation may be mixed in the consumer.</simpara>
+</section>
+<section xml:id="_generic-methods" role="language-n4js">
+<title>Generic Methods</title>
+<simpara>Methods of generic classes can, of course, refer to the type variables defined by type parameters of the generic class.
+These type variables are used similarly to predefined or declared types.
+Additionally, methods may be declared generic independently from their containing class.
+That is to say that type parameters (with type variables) can be defined for methods as well, just like for generic functions (see <xref linkend="_generic-functions"/>).</simpara>
+<requirement xml:id="IDE-55">
+<title>Type variable names for generic methods</title>
+<simpara>
+<anchor xml:id="Req-IDE-55" xreflabel="[Req-IDE-55]"/>
+<emphasis role="strong">Requirement: IDE-55:</emphasis>
+<link linkend="Req-IDE-55">Type variable names for generic methods</link> (ver. 1)</simpara>
+    <simpara>
+
+For a given generic method <literal>M</literal> of a class <literal>C</literal>, the following
+constraint must hold:<?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∀</mo><mi> </mi><mi>t</mi><msub><mi>p</mi><mi>m</mi></msub><mo>∈</mo><mi>m</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>P</mi><mi>a</mi><mi>r</mi><mi>s</mi><mo>,</mo><mi>t</mi><msub><mi>p</mi><mi>C</mi></msub><mo>∈</mo><mi>C</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>P</mi><mi>a</mi><mi>r</mi><mi>s</mi><mi>:</mi><mi>t</mi><msub><mi>p</mi><mi>m</mi></msub><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>≠</mo><mi>t</mi><msub><mi>p</mi><mi>C</mi></msub><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi></math></simpara>
+</requirement>
+<simpara>Since type variables can be used similarly to types in the scope of a generic class, a generic method may refer to a type variable of its containing class.</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">class C {
+    &lt;T&gt; foo(p: T p): T { return p;}
+};</programlisting>
+<simpara>If a generic type parameter is not used as a formal parameter type or the return type, a warning is generated unless the method overrides a member inherited from a super class or interface.</simpara>
+</section>
+</section>
+<section xml:id="_default-methods-in-interfaces">
+<title>Default Methods in Interfaces</title>
+<simpara>If a method declared in an interface defines a body, then this is the so-called <emphasis>default implementation</emphasis> and the method is called a <emphasis>default method</emphasis>.
+This will be mixed into an implementor of the interface if, and only if, neither the implementing class nor any of its direct or indirect superclasses already provides an implementation for this method;
+for details see <xref linkend="_member-consumption"/>.
+Since the implementor is not known, some constraints exist for the body. I.e., no access to super is possible, cf. <xref linkend="Req-IDE-124"/>.</simpara>
+<simpara>In order to declare an interface to provide a default implementation in a definition file, annotation <literal>@ProvidesDefaultImplementation</literal> can be used, cf. <xref linkend="Req-IDE-167"/>.</simpara>
+<simpara>When a method in an interface is provided with a default implementation, it may even be declared <literal>@Final</literal>, see <xref linkend="_final-methods"/>.</simpara>
+<section xml:id="_asynchronous-methods">
+<title>Asynchronous Methods</title>
+<simpara>N4JS implements the async/await concept proposed for ECMAScript 7, which provides a more convenient and readable syntax for writing asynchronous code compared to using built-in type Promise directly.
+This concept can be applied to methods in exactly the same way as to declared functions.
+See <xref linkend="_asynchronous-functions"/> and <xref linkend="_asynchronous-arrow-functions"/> for details.</simpara>
+</section>
+</section>
+<section xml:id="_constructors" role="language-n4js">
+<title>Constructors</title>
+<simpara>A constructor is a special function defined on a class which returns an instance of that class.
+The constructor looks like a normal method with name "constructor".
+The constructor can be defined explicitly or implicitly and every class has an (implicit) constructor.</simpara>
+<simpara>For a given a class <literal>C</literal>, the constructor is available via two properties:</simpara>
+<variablelist>
+<varlistentry>
+<term><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>o</mi><mi>w</mi><mi>n</mi><mi>e</mi><mi>d</mi><mi>C</mi><mi>t</mi><mi>o</mi><mi>r</mi></math></term>
+<listitem>
+<simpara>the explicitly defined constructor (if any).</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi></math></term>
+<listitem>
+<simpara>the explicit or implicit constructor.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+<simpara>If <literal>C</literal> is provided with an explicit constructor, we have <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>C</mi><mo>.</mo><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi><mo>=</mo><mi>C</mi><mo>.</mo><mi>o</mi><mi>w</mi><mi>n</mi><mi>e</mi><mi>d</mi><mi>C</mi><mi>t</mi><mi>o</mi><mi>r</mi></math> and <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>C</mi><mo>.</mo><mi>o</mi><mi>w</mi><mi>n</mi><mi>e</mi><mi>d</mi><mi>C</mi><mi>t</mi><mi>o</mi><mi>r</mi><mo>∈</mo><mi>C</mi><mo>.</mo><mi>o</mi><mi>w</mi><mi>n</mi><mi>e</mi><mi>d</mi><mi>M</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi><mi>s</mi></math>.
+Note that <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>C</mi><mo>.</mo><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi><mo>∉</mo><mi>C</mi><mo>.</mo><mi>o</mi><mi>w</mi><mi>n</mi><mi>e</mi><mi>d</mi><mi>M</mi><mi>e</mi><mi>t</mi><mi>h</mi><mi>o</mi><mi>d</mi><mi>s</mi></math> in all cases.</simpara>
+<simpara>The return type of the constructor of a class <literal>C</literal> is <literal>C</literal>.
+If <literal>C</literal> has type parameters <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>T</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>T</mi><mi>n</mi></msub></math>, then the return type is <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>C</mi><mo>&lt;</mo><msub><mi>T</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>T</mi><mi>n</mi></msub><mo>&gt;</mo></math>. The constructor is called with the operator.
+Since the return type of a constructor is implicitly defined by the class, it is to be omitted.
+By this definition, a constructor looks like the following:</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">class C {
+    public constructor(s: string) {
+        // init something
+    }
+}</programlisting>
+<simpara>Constructors define a variable execution environment and therefore provide access to the actual passed-in parameters through the implicit variable inside of their bodies (c.f. <xref linkend="_arguments-object"/>).</simpara>
+<requirement xml:id="IDE-56">
+<title>Defining and Calling Constructors</title>
+<simpara>
+<anchor xml:id="Req-IDE-56" xreflabel="[Req-IDE-56]"/>
+<emphasis role="strong">Requirement: IDE-56:</emphasis>
+<link linkend="Req-IDE-56">Defining and Calling Constructors</link> (ver. 1)</simpara>
+    <simpara>
+
+For a constructor <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi></math> of a class <literal>C</literal>, the following conditions
+must hold:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi></math> must neither be abstract nor static nor final and it must not be annotated with <literal>@Override</literal>.</simpara>
+</listitem>
+<listitem>
+<simpara>If a class does not explicitly define a constructor then the constructor’s signature of the superclass constructor is assumed.</simpara>
+</listitem>
+<listitem>
+<simpara>If a class defines a constructor with formal parameters then this constructor has to be called explicitly in constructors defined in subclasses.</simpara>
+</listitem>
+<listitem>
+<simpara>If a super constructor is called explicitly, this call must be the only expression of an expression statement which has to be the first statement of the body.</simpara>
+</listitem>
+<listitem>
+<simpara>Constructors may appear in interfaces, but some restrictions apply:</simpara>
+<orderedlist numeration="loweralpha">
+<listitem>
+<simpara>constructors in interfaces must not have a body.</simpara>
+</listitem>
+<listitem>
+<simpara>constructors in interfaces or their containing interface or one of its direct or indirect super interfaces must be annotated with <literal>@CovariantConstructor</literal>.</simpara>
+</listitem>
+</orderedlist>
+</listitem>
+<listitem>
+<simpara>A constructor must not have an explicit return type declaration.</simpara>
+</listitem>
+<listitem>
+<simpara>The implicit return type of a constructor is <literal>this?</literal>.</simpara>
+</listitem>
+<listitem>
+<simpara>A constructor must not have any type parameters.</simpara>
+</listitem>
+</orderedlist>
+</requirement>
+<simpara>Properties of object literals may be called <literal>constructor</literal>.
+However they are not recognized as constructors in these cases.</simpara>
+<requirement xml:id="IDE-57">
+<title>Initialization of Final Fields in the Constructor</title>
+<simpara>
+<anchor xml:id="Req-IDE-57" xreflabel="[Req-IDE-57]"/>
+<emphasis role="strong">Requirement: IDE-57:</emphasis>
+<link linkend="Req-IDE-57">Initialization of Final Fields in the Constructor</link> (ver. 1)</simpara>
+    <simpara>
+</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>Required attributes must be initialized:<?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∀</mo><mi>a</mi><mo>∈</mo><mi>C</mi><mo>.</mo><mi>a</mi><mi>t</mi><mi>t</mi><mi>r</mi><mi>:</mi><mi>a</mi><mo>.</mo><mi>r</mi><mi>e</mi><mi>q</mi><mi>u</mi><mi>i</mi><mi>r</mi><mi>e</mi><mi>d</mi><mo>⇒</mo><mo>∃</mo><mi>e</mi><mo>∈</mo><mi>r</mi><mo>.</mo><mi>e</mi><mi>l</mi><mi>e</mi><mi>m</mi><mi>e</mi><mi>n</mi><mi>t</mi><mi>s</mi><mi>:</mi><mi>a</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><mi>e</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi></math></simpara>
+</listitem>
+</orderedlist>
+</requirement>
+<simpara>Note on syntax: ECMAScript 6 defines constructors similarly, [<link linkend="ECMA15a">ECMA15a(p.S13.5)</link>]. In
+ECMAScript 6 the super constructor is not called automatically as well.</simpara>
+<simpara>The super literal used in order to call super methods is further
+described in <xref linkend="_the-super-keyword"/>.</simpara>
+<section xml:id="_structural-this-type-in-constructor">
+<title>Structural This Type in Constructor</title>
+<simpara>The use of a structural this reference as a formal parameter type is possible only in constructors.
+This parameter can be annotated with <literal>@Spec</literal> which causes the compiler to generate initialization code.</simpara>
+<simpara>Simply using <literal>this</literal> as a type in the constructor causes the constructor to require an object providing all public fields of the class for initialization purposes.
+The fields have to be set manually as shown in the following code snippet.</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">class A{
+    public s: string;
+    public constructor(src: ~~this) {
+        this.s = src.s;
+    }
+}</programlisting>
+<simpara>Remarks:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>The type of the formal parameter <literal>~~this</literal> refers to the structural field type, see <xref linkend="_structural-typing"/> for details on structural typing.
+It contains all public fields of the type.</simpara>
+</listitem>
+<listitem>
+<simpara>Subclasses may override the constructor and introduce additional parameters.
+They have to call the super constructor explicitly, however, providing a parameter with at least all required attributes of the superclass.
+Usually the type <literal>this</literal> is replaced with the actual subclass, but in the case of a <literal>super()</literal> call the <literal>this</literal> type of structural formal parameters is replaced with the <literal>this</literal> type of the superclass,
+hence only required fields of the superclass must be present.</simpara>
+</listitem>
+</itemizedlist>
+<simpara>As with other structural references, it is possible to add the structural reference with additional structural members, which can be used to initialize private fields which
+become not automatically part of the structural field type. For example:</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">class A{
+    public s: string;
+    private myPrivateNumber: number;
+    public constructor(src: ~~this with { x: number; }) {
+        this.s = src.s;
+        this.myPrivateNumber = src.x;
+    }
+}</programlisting>
+<simpara>Defining additional members may become a problem if a subclass defines  public fields with the same name, as the <literal>~~this</literal> type will contain these fields in the subclass.
+This is marked as an error in the subclass.</simpara>
+<requirement xml:id="IDE-58">
+<title>Names of additional members of structural this type in constructor</title>
+<simpara>
+<anchor xml:id="Req-IDE-58" xreflabel="[Req-IDE-58]"/>
+<emphasis role="strong">Requirement: IDE-58:</emphasis>
+<link linkend="Req-IDE-58">Names of additional members of structural this type in constructor</link> (ver. 1)</simpara>
+    <simpara>
+
+If the structural this type is used in a constructor of a class <literal>C</literal>, and if this structural reference contains an additional structural member <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>S</mi><mi>M</mi></math>, the following constraints must hold true:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>For any subclass <literal>S</literal> of <literal>C</literal>, with <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>S</mi><mo>.</mo><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi><mo>=</mo><mi>C</mi><mo>.</mo><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi></math> (the subclass does not define its own constructor), <literal>S</literal> must not contain a public member with same name as <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>S</mi><mi>M</mi></math>:</simpara>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>S</mi><mo>&lt;</mo><mi>:</mi><mi>C</mi><mo>,</mo><mi>S</mi><mo>.</mo><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi><mo>=</mo><mi>C</mi><mo>.</mo><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi></math>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0em"/><mo>⇒</mo><mo>∄</mo><mi>M</mi><mo>∈</mo><mi>S</mi><mo>.</mo><mi>m</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi><mi>s</mi><mi>:</mi></math>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="5.0em"/><mi>M</mi><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>public</mtext></mstyle><mo>∧</mo><mi>M</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><mi>S</mi><mi>M</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi></math></simpara>
+</listitem>
+<listitem>
+<simpara><literal>C</literal> itself must not contain a public member with same name as <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>S</mi><mi>M</mi></math>:</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mo>∄</mo><mi>M</mi><mo>∈</mo><mi>C</mi><mo>.</mo><mi>m</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi><mi>s</mi><mi>:</mi><mi>M</mi><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>public</mtext></mstyle><mo>∧</mo><mi>M</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><mi>S</mi><mi>M</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi></math>
+</listitem>
+</orderedlist>
+</requirement>
+<example>
+<title>Field name conflicts with structural member name</title>
+<simpara>The situation described in <xref linkend="Req-IDE-58"/> is demonstrated in the following code fragment:</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">class A {
+    private myPrivateNumber: number;
+    public constructor(src: ~~this with { x: number; }) {
+        this.myPrivateNumber = src.x;
+    }
+}
+
+class B extends A {
+    public x: number; // will cause an error message
+}</programlisting>
+</example>
+</section>
+<section xml:id="spec-constructor">
+<title>@Spec Constructor</title>
+<simpara>The tedious process of copying the members of the parameter to the fields of the class can be automated via the <literal>@Spec</literal>
+annotation if the argument has <literal>~i~this</literal> structural initializer field typing. More details about this typing can be
+found in <xref linkend="structural-readWriteInit-field-typing"/>. This can be used as shown in the following listing:</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">class A {
+    public field: string;
+    public constructor(@Spec spec: ~i~this) {}
+}
+let a = new A({field: 'hello'});
+console.log(a.field); // prints: hello</programlisting>
+<simpara>The code for initializing the public field of <literal>A</literal> is automatically generated, thanks to the <literal>@Spec</literal> annotation being
+given in the constructor.</simpara>
+<requirement xml:id="IDE-59">
+<title>@Spec Constructor</title>
+<simpara>
+<anchor xml:id="Req-IDE-59" xreflabel="[Req-IDE-59]"/>
+<emphasis role="strong">Requirement: IDE-59:</emphasis>
+<link linkend="Req-IDE-59">@Spec Constructor</link> (ver. 1)</simpara>
+    <simpara>
+</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>Annotation <literal>@Spec</literal> may only appear on a formal parameter of a constructor. Such a formal parameter is then called
+<emphasis>@Spec parameter</emphasis> or simply <emphasis>spec parameter</emphasis> and its owning constructor is referred to as a <emphasis>@Spec constructor</emphasis> or
+<emphasis>spec constructor</emphasis>. An argument to the spec parameter is called <emphasis>spec object</emphasis>.</simpara>
+</listitem>
+<listitem>
+<simpara>Only a single formal parameter of a constructor may be annotated with <literal>@Spec</literal>.</simpara>
+</listitem>
+<listitem>
+<simpara>If a formal parameter is annotated with <literal>@Spec</literal>, the parameter’s type must be <literal>~i~this</literal> (i.e. a use-site
+structural initializer field type of <literal>this</literal>, see <xref linkend="structural-readWriteInit-field-typing"/>).</simpara>
+</listitem>
+<listitem>
+<simpara>Using the data provided in the spec object, i.e. in the argument to the spec parameter, a spec constructor will
+automatically initialize</simpara>
+<orderedlist numeration="loweralpha">
+<listitem>
+<simpara>all <emphasis role="strong">owned</emphasis> data fields and <emphasis role="strong">owned</emphasis> setters of the containing class, and</simpara>
+</listitem>
+<listitem>
+<simpara>all data fields and setters from interfaces implemented by the containing class</simpara>
+</listitem>
+</orderedlist>
+<simpara>if and only if those members are also part of the spec parameter&#8217;s structural initializer field type.</simpara>
+</listitem>
+<listitem>
+<simpara>Fields explicitly added to the spec parameter, e.g. <literal>@Spec spec: ~i~this with {name:string}</literal>, are used for initialization
+if a non-public field of the same name exists in the class, either as an owned member or from an implemented interface.
+The type of such an additional field must be a subtype of the declared type of the field being initialized:</simpara>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∀</mo><mi>s</mi><mo>∈</mo><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi><mo>.</mo><mi>f</mi><mi>p</mi><mi>a</mi><mi>r</mi><mo>.</mo><mi>s</mi><mi>t</mi><mi>r</mi><mi>u</mi><mi>c</mi><mi>t</mi><mi>u</mi><mi>r</mi><mi>a</mi><mi>l</mi><mi>M</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi><mi>s</mi><mo>,</mo><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi><mo>.</mo><mi>f</mi><mi>p</mi><mi>a</mi><mi>r</mi><mo>.</mo><mi>s</mi><mi>p</mi><mi>e</mi><mi>c</mi><mi>:</mi></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="2.0em"/><mo>∃</mo><mi>f</mi><mo>∈</mo><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi><mo>.</mo><mi>o</mi><mi>w</mi><mi>n</mi><mi>e</mi><mi>r</mi><mo>.</mo><mi>o</mi><mi>w</mi><mi>n</mi><mi>e</mi><mi>d</mi><mi>F</mi><mi>i</mi><mi>e</mi><mi>l</mi><mi>d</mi><mi>s</mi><mo>⇒</mo><mi>Γ</mi><mo>⊢</mo><mi>s</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>f</mi></math></simpara>
+</listitem>
+<listitem>
+<simpara>Even if the <literal>@Spec</literal> annotation is used, the super constructor must be invoked explicitly (as usual).</simpara>
+</listitem>
+</orderedlist>
+</requirement>
+<simpara>It follows from no. 4 above that</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>non-public data fields and setters are never initialized (because they will never be part of the spec parameter&#8217;s
+structural initializer field type),</simpara>
+</listitem>
+<listitem>
+<simpara>properties provided in the spec object but not defined in the parameter&#8217;s structural initializer field type, are
+<emphasis>not</emphasis> used for initialization, even if a (protected or private) field of the same name exists in the class,</simpara>
+</listitem>
+<listitem>
+<simpara>data fields and setters inherited from a super class are never initialized by a spec constructor (instead, this will
+happen in the spec constructor of the super class).</simpara>
+</listitem>
+</orderedlist>
+<simpara>The last of these implications will be detailed further at the end of the coming section.</simpara>
+<simpara><emphasis role="strong">@Spec Constructors and Inheritance</emphasis></simpara>
+<simpara>Spec constructors are inherited by subclasses that do not have a constructor and, when creating instances of the
+subclass, will then require properties for writable public fields of the subclass in the spec object <emphasis role="strong">and</emphasis> include
+initialization code for them.</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">class A {
+    public fa;
+    public constructor(@Spec spec: ~i~this) {}
+}
+class B extends A {
+    public fb;
+}
+
+const b = new B({fa: 'hello', fb: 'world'}); // requires &amp; initializes fb too!
+console.log(b.fa); // prints: hello
+console.log(b.fb); // prints: world</programlisting>
+<simpara>Public writable fields from implemented interfaces are included as well, i.e. required as property in spec object <emphasis role="strong">and</emphasis>
+initialized by auto-generated code in the <literal>@Spec</literal> constructor:</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">interface I {
+    public fi;
+}
+class B implements I {
+    public fb;
+    public constructor(@Spec spec: ~i~this) {}
+}
+
+const a = new B({fb: 'hello', fi: 'world'}); // requires &amp; initializes fi too!
+console.log(a.fb); // prints: hello
+console.log(a.fi); // prints: world</programlisting>
+<simpara>When having a spec constructor in a class <literal>B</literal> that extends a super class <literal>A</literal> without an owned or inherited spec
+constructor, it should be noted that the <literal>~i~this</literal> type will require properties for public writable fields of <literal>A</literal>,
+but the initialization code automatically generated due to the <literal>@Spec</literal> annotation will <emphasis role="strong">not</emphasis> initialize those members.
+For public writable fields from an interface <literal>I</literal> implemented by <literal>B</literal>, however, both a property will be required by
+<literal>~i~this</literal> <emphasis role="strong">and</emphasis> initialization code will be generated in the <literal>@Spec</literal> constructor. This is illustrated in the
+following code example.</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">class A {
+    public fa;
+}
+interface I {
+    public fi;
+}
+class B extends A implements I {
+    public fb;
+    public constructor(@Spec spec: ~i~this) { // &lt;- fa, fi, fb required in spec object
+        // Constructor is responsible for initializing fa, fi, fb.
+        // The @Spec annotation will generate initialization code
+        // for fb and fi, but not for fa!
+    }
+}
+
+let b = new B({
+    fa: 'hello', // &lt;- fa is required (removing it would be a compile error)
+    fi: 'world',
+    fb: '!!'
+});
+
+console.log(b.fa); // undefined
+console.log(b.fi); // world
+console.log(b.fb); // !!</programlisting>
+<simpara>The rationale for this different handling of fields from super classes and implemented interfaces is
+1. fields from an implemented interface are not seen as inherited but rather implemented by implementing class, so from
+   the <literal>@Spec</literal> annotation&#8217;s perspective the field is a field of the implementing class, and
+2. in case of a field inherited from a super class the correct way of initialization may depend on details of the super
+   class and has to be taken care of by custom code in the constructor of the subclass (usually by invoking the non-<literal>@Spec</literal>
+   constructor of the superclass with <literal>super</literal>).</simpara>
+<simpara><emphasis role="strong">Special Use Cases</emphasis></simpara>
+<simpara>The following examples illustrate further details of other use cases of spec constructors.</simpara>
+<example>
+<title>Anonymous Interface in Constructor</title>
+<simpara>The base class <literal>A</literal> in the examples redefines the constructor already defined in <literal>N4Object</literal>. This is not
+generally necessary and is only used here to make the example legible.</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">class A {
+    public s: string;
+    public constructor(@Spec spec: ~i~this) {
+        // initialization of s is automatically generated
+    }
+}
+class B extends A {
+    public t: string;
+    private n: number;
+    public constructor(spec: ~~this with {n: number;}) {
+        super(spec);    // only inherited field s is set in super constructor
+    }
+}</programlisting>
+</example>
+<example>
+<title>Spec Object and Subclasses</title>
+<programlisting language="n4js" linenumbering="unnumbered">class A1 {
+    public s: string;
+    public n: number;
+    public constructor(@Spec spec: ~i~this) {}
+}
+class B extends A1 {
+    public constructor() {
+        super({s:"Hello"}); // &lt;-- error, n must be set in object literal
+    }
+}
+class C extends A1 {
+    public constructor() {
+        super({s:"Hello"}); // &lt;-- error, n must be set in object literal
+        this.n = 10; // &lt;-- this has no effect on the super constructor!
+    }
+}
+
+class A2 {
+    public s: string;
+    public n: number?; // now n is optional!
+    public constructor(@Spec spec: ~i~this) {}
+}
+class D extends A2 {
+    public constructor() {
+        super({s:"Hello"}); // and this is ok now!
+        this.n = 10; // this explains why it is optional
+    }
+}
+
+class A3 {
+    public s: string;
+    public n: number = 10; // now n is not required in ~~this
+    public constructor(@Spec spec: ~i~this) {}
+}
+class E extends A3 {
+    public constructor() {
+        super({s:"Hello"}); // and this is ok now!
+    }
+}</programlisting>
+<simpara>The last case (class E) demonstrates a special feature of the typing strategy modifier in combination with the <literal>this</literal> type, see <xref linkend="_structural-typing"/> for details.</simpara>
+<simpara>The constructor in class <literal>B</literal> contains an error because the super constructor expects all required attributes in <literal>A1</literal> to be set.
+The additional initialization of the required field <literal>A1.n</literal> as seen in <literal>C</literal> does not change that expectation.
+In this example, the field <literal>n</literal> should not have been defined as required in the first place.</simpara>
+<simpara>Optional fields like <literal>n?</literal> in class <literal>A2</literal> or fields with default values like <literal>n=10</literal> in class <literal>A3</literal> are not required to be part of the <literal>spec</literal> object.</simpara>
+</example>
+<example>
+<title>Superfluous Properties in @Spec Constructors</title>
+<simpara>Each non-<math xmlns="http://www.w3.org/1998/Math/MathML"><mstyle mathvariant="monospace"><mtext>public</mtext></mstyle></math> field has to be set in the constructor via the <math xmlns="http://www.w3.org/1998/Math/MathML"><mstyle mathvariant="monospace"><mtext>with</mtext></mstyle></math> to the parameter otherwise properties are <emphasis>not</emphasis> used to set non-<math xmlns="http://www.w3.org/1998/Math/MathML"><mstyle mathvariant="monospace"><mtext>public</mtext></mstyle></math> fields.</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">class C {
+    public s: string;
+    n: number;
+    constructor(@Spec spec: ~i~this) {}
+}
+
+// n is ignored here
+new C( { s: "Hello", n: 42 });
+
+// but:
+var ol = { s: "Hello", n: 42 };
+// "ol may be used elsewhere, we cannot issue warning here" at "ol"
+new C(ol) ;
+
+// of course this is true for all superfluous properties
+// weird is not used in constructor
+new C( { s: "Hello", weird: true } );</programlisting>
+</example>
+<variablelist>
+<varlistentry>
+<term>Restriction when initializing interface fields via @Spec constructor <anchor xml:id="restriction-interface-field-spec-constructor" xreflabel="[restriction-interface-field-spec-constructor]"/> </term>
+<listitem>
+<simpara>In most cases, interface definitions in <literal>n4jsd</literal> files simply declare functions and fields that are supposed to be provided by the runtime environment.
+As a result, there are restrictions as to whether fields of interfaces defined in <literal>n4jsd</literal> files can initialized via <literal>@Spec</literal> constructors or not.
+In particular, fields of an interface declared in a <literal>n4jsd</literal> file  cannot be initialized via @Spec constructor if the interface</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>is a built-in or</simpara>
+</listitem>
+<listitem>
+<simpara>does not have an <literal>@N4JS</literal> annotation</simpara>
+</listitem>
+</orderedlist>
+</listitem>
+</varlistentry>
+</variablelist>
+<simpara>The following example illustrates this restriction.</simpara>
+<example>
+<title>Interface fields that cannot be initialized via @Spec constructors</title>
+<formalpara>
+<title>Inf.n4jsd</title>
+<para>
+<programlisting language="n4js" linenumbering="unnumbered">export external interface I  {
+    public m: string;
+}
+
+@N4JS
+export external interface J  {
+    public n: string;
+}</programlisting>
+</para>
+</formalpara>
+<formalpara>
+<title>Test.n4js</title>
+<para>
+<programlisting language="n4js" linenumbering="unnumbered">import { I } from "Inf";
+// I is an external interface WITHOUT @N4JS annotation
+class C implements I {
+    constructor(@Spec spec:~i~this) {}
+}
+
+// J is an external interface with @N4JS annotation
+class D implements J {
+    constructor(@Spec spec:~i~this) {}
+}
+
+// XPECT warnings --&gt; "m is a property of built-in / provided by runtime / external without @N4JS annotation interface I and can not be initialized in Spec constructor." at "m"
+let c:C = new C({m: "Hello"});
+
+// XPECT nowarnings
+let d:D = new D({n: "Bye"});
+
+console.log(c.m)
+console.log(d.n)
+
+/* XPECT output ---
+&lt;==
+stdout:
+undefined
+Bye
+stderr:
+==&gt;
+--- */</programlisting>
+</para>
+</formalpara>
+</example>
+<simpara>In this example, the interface <literal>I</literal> is defined in the <literal>Inf.n4jsd</literal> file without the <literal>@N4JS</literal> annotation. As a result, its field <literal>m</literal> cannot be initialized via the <literal>@Spec</literal> constructor and hence the output of <literal>console.log(c.m)</literal> is <literal>undefined</literal>. On the other hand,  since the interface <literal>J</literal> is declared with the annotation <literal>@N4JS</literal>, it is possible to initialize its field <literal>n</literal> in the <literal>@Spec</literal> constructor. That&#8217;s why the result of <literal>console.log(d.n)</literal> is <literal>Bye</literal>.</simpara>
+</section>
+<section xml:id="_callable-constructors">
+<title>Callable Constructors</title>
+
+</section>
+<section xml:id="_covariant-constructors">
+<title>Covariant Constructors</title>
+<simpara>Usually, the constructor of a subclass need not be override compatible with the constructor of its super class.
+By way of annotation <literal>@CovariantConstructor</literal> it is possible to change this default behavior and enforce all subclasses to have constructors with override compatible signatures.
+A subclass can achieve this by either inheriting the constructor from the super class (which is usually override compatible,
+with the special case of <literal>@Spec</literal> constructors) or by defining a new constructor with a signature compatible to the inherited constructor.
+The same rules as for method overriding apply.</simpara>
+<simpara>The <literal>@CovariantConstructor</literal> annotation may be applied to the constructor, the containing classifier, or both.
+It can also be used for interfaces; in fact, constructors are allowed in interfaces only if they themselves or the interface is annotated with <literal>@CovariantConstructor</literal> (see <xref linkend="Req-IDE-60"/>).</simpara>
+<definition>
+<title>Covariant Constructor</title>
+<simpara>
+<anchor xml:id="covariant_constructor" xreflabel="[covariant_constructor]"/>
+<emphasis role="strong">Definition:</emphasis>
+<link linkend="covariant_constructor">Covariant Constructor</link></simpara>
+<simpara>
+
+A classifier <literal>C</literal> is said to <literal><emphasis>have a covariant constructor</emphasis></literal> if and
+only if one of the following applies:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara><literal>C</literal> has a direct super class <math xmlns="http://www.w3.org/1998/Math/MathML"><msup><mi>C</mi><mi>'</mi></msup></math> and <math xmlns="http://www.w3.org/1998/Math/MathML"><msup><mi>C</mi><mi>'</mi></msup></math> is annotated with <literal>@CovariantConstructor</literal> or <math xmlns="http://www.w3.org/1998/Math/MathML"><msup><mi>C</mi><mi>'</mi></msup></math> has a constructor annotated with <literal>@CovariantConstructor</literal>.</simpara>
+</listitem>
+<listitem>
+<simpara><literal>C</literal> has a directly implemented interface <literal>I and `I</literal> is annotated with  <literal>@CovariantConstructor</literal> or <literal>I</literal> has a constructor annotated with <literal>@CovariantConstructor</literal>.</simpara>
+</listitem>
+<listitem>
+<simpara><literal>C</literal> has a direct super class or directly implemented interface that <literal><emphasis>has a covariant constructor</emphasis></literal> (as defined here).</simpara>
+</listitem>
+</orderedlist>
+</definition>
+<simpara>Note that <literal>C</literal> does not need to have an owned(!) constructor; also a constructor inherited from a super class can be declared covariant.</simpara>
+<simpara>The following rules apply to covariant constructors.</simpara>
+<requirement xml:id="IDE-60">
+<title>Covariant Constructors</title>
+<simpara>
+<anchor xml:id="Req-IDE-60" xreflabel="[Req-IDE-60]"/>
+<emphasis role="strong">Requirement: IDE-60:</emphasis>
+<link linkend="Req-IDE-60">Covariant Constructors</link> (ver. 1)</simpara>
+    <simpara>
+
+.  Annotation <literal>@CovariantConstructor</literal> may only be applied to classes, interfaces, and constructors.
+Annotating a constructor with this annotation, or its containing classifier, or both have all the same effect.
+.  Given a class <literal>C</literal> with an owned constructor <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi></math> and a super class <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>S</mi><mi>u</mi><mi>p</mi></math> that has a covariant constructor (owned or inherited, see <xref linkend="_covariant-constructors"/>),
+then <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>S</mi><mi>u</mi><mi>p</mi><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>s</mi><mi>t</mi><mi>r</mi><mi>u</mi><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi></math> must be accessible from <literal>C</literal>,
+..  <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi></math> must be override compatible with <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>S</mi><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>s</mi><mi>t</mi><mi>r</mi><mi>u</mi><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi></math>:</simpara>
+<simpara>+
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>o</mi><mi>v</mi><mi>e</mi><mi>r</mi><mi>r</mi><mi>i</mi><mi>d</mi><mi>e</mi><mi>C</mi><mi>o</mi><mi>m</mi><mi>p</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>b</mi><mi>l</mi><mi>e</mi><mfenced close=")" open="("><mrow><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi></mrow><mrow><mi>S</mi><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>s</mi><mi>t</mi><mi>r</mi><mi>u</mi><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi></mrow></mfenced></math></simpara>
+<simpara>+
+This constraint corresponds to <xref linkend="Req-IDE-72"/> except for the <literal>Override</literal> annotation which is not required here.
+.  Given a classifier <literal>C</literal> implementing interface <literal>I</literal> and <literal>I</literal> has a covariant constructor (owned or inherited, see <xref linkend="_covariant-constructors"/>), we require
+..  <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>I</mi><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>s</mi><mi>t</mi><mi>r</mi><mi>u</mi><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi></math> must be accessible from <literal>C</literal>,
+..  an implementation-compatible constructor <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi></math> must be defined in C with</simpara>
+<simpara>+
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>o</mi><mi>v</mi><mi>e</mi><mi>r</mi><mi>r</mi><mi>i</mi><mi>d</mi><mi>e</mi><mi>C</mi><mi>o</mi><mi>m</mi><mi>p</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>b</mi><mi>l</mi><mi>e</mi><mfenced close=")" open="("><mrow><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi></mrow><mrow><mi>I</mi><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>s</mi><mi>t</mi><mi>r</mi><mi>u</mi><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi></mrow></mfenced></math></simpara>
+<simpara>+
+This constraint corresponds to <xref linkend="Req-IDE-74"/> except for the <literal>@Override</literal> annotation, which is not required, here.
+..  Given a classifier <literal>C</literal> without an owned constructor and an extended class or interface <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>S</mi><mi>u</mi><mi>p</mi></math> that has a covariant constructor (owned or inherited, see <xref linkend="_covariant-constructors"/>),
+we require the inherited constructor <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi></math> of <literal>C</literal> within the context of <literal>C</literal> to be override compatible to itself in the context of <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>S</mi><mi>u</mi><mi>p</mi></math>.
+Using notation <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>m</mi><mfenced close="]" open="["><mi>T</mi></mfenced></math> to denote that a member <literal>M</literal> is to be treated as defined in container type <literal>T</literal>, which means the this-binding is set to <literal>T</literal>, we can write:</simpara>
+<simpara>+
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>o</mi><mi>v</mi><mi>e</mi><mi>r</mi><mi>r</mi><mi>i</mi><mi>d</mi><mi>e</mi><mi>C</mi><mi>o</mi><mi>m</mi><mi>p</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>b</mi><mi>l</mi><mi>e</mi><mfenced close=")" open="("><mrow><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi><mfenced close="]" open="["><mi>C</mi></mfenced></mrow><mrow><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi><mfenced close="]" open="["><mrow><mi>S</mi><mi>u</mi><mi>p</mi></mrow></mfenced></mrow></mfenced></math></simpara>
+<simpara>+
+This constraint does not correspond to any of the constraints for the redefinition of ordinary members.</simpara>
+</requirement>
+<simpara>The following example demonstrates a use case for covariant constructors.
+It shows a small class hierarchy using covariant constructors, <literal>Cls</literal> and <literal>Cls2</literal>, together with a helper function <literal>createAnother</literal> that creates and returns a new instance of the same type as its argument <literal>value</literal>.</simpara>
+<example xml:id="ex:covariant_constructors">
+<title>Covariant Constructors</title>
+<programlisting language="n4js" linenumbering="unnumbered">class A {}
+class B extends A {}
+
+@CovariantConstructor
+class Cls {
+    constructor(p: B) {}
+}
+class Cls2 extends Cls {
+    constructor(p: A) { // it's legal to generalize the type of parameter 'p'
+        super(null);
+    }
+}
+
+function &lt;T extends Cls&gt; createAnother(value: T, p: B): T {
+    let ctor = value.constructor;
+    return new ctor(p);
+}
+
+let x = new Cls2(new A());
+let y: Cls2;
+
+y = createAnother(x, new B());</programlisting>
+</example>
+<simpara>In the code of <xref linkend="ex:covariant_constructors"/>, we would get an error if we changed the type of parameter <literal>p</literal> in the constructor of <literal>Cls2</literal> to some other type that
+is not a super type of <literal>B</literal>, i.e. the type of the corresponding parameter of <literal>Cls</literal>’s constructor.
+If we removed the <literal>@CovariantConstructor</literal> annotation on <literal>Cls</literal>, we would get an error in the new expression inside function <literal>createAnother</literal>.</simpara>
+<simpara>The next example illustrates how to use <literal>@CovariantConstructor</literal> with interfaces and shows a behavior that might be surprising at first sight.</simpara>
+<example xml:id="ex:covariant-constructors-in-interfaces">
+<title>Covariant Constructors in Interfaces</title>
+<programlisting language="n4js" linenumbering="unnumbered">@CovariantConstructor
+interface I {
+    constructor(p: number)
+}
+
+class C implements I {
+    // no constructor required!
+}
+
+class D extends C {
+    // XPECT errors --&gt; "Signature of constructor of class D does not conform to overridden constructor of class N4Object: {function(number)} is not a subtype of {function()}." at "constructor"
+    constructor(p: number) {}
+}</programlisting>
+</example>
+<simpara>Interface <literal>I</literal> declares a covariant constructor expecting a single parameter of type <literal>number</literal>.
+Even though class <literal>C</literal> implements <literal>I</literal>, it does not need to define an owned constructor with such a parameter.
+According to <xref linkend="Req-IDE-60"/>, it is enough for <literal>C</literal> to have a constructor, either owned or inherited, that is override compatible with the one declared by <literal>I</literal>.
+Class <literal>C</literal> inherits the default constructor from <literal>N4Object</literal>, which does not have any arguments and is thus override compatible to <literal>I</literal>’s constructor.</simpara>
+<simpara>In addition, subclasses are now required to have constructors which are override compatible with the constructor of class <literal>C</literal>, i.e. the one inherited from <literal>N4Object</literal>.
+<xref linkend="ex:covariant-constructors-in-interfaces"/> shows that this is violated even when repeating the exact same constructor signature from interface <literal>I</literal>,
+because that constructor now appears on the other side of the subtype test during checking override compatibility.</simpara>
+</section>
+</section>
+<section xml:id="_data-fields" role="language-n4js">
+<title>Data Fields</title>
+<simpara>A data field is a simple property of a class.
+There must be no getter or setter defined with the same name as the data field.
+In ECMAScript 6, a class has no explicit data fields.
+It is possible, however, to implicitly define a data field by simply assigning a value to a variable of the this element (e.g. <literal>this.x = 10</literal> implicitly defines a field <literal>x</literal>).
+Data fields in N4JS are similar to these implicit fields in ECMAScript 6 except that they are defined explicitly in order to simplify validation and user assistance.</simpara>
+<section xml:id="data-fields-syntax">
+<title>Syntax</title>
+<programlisting language="xtext" linenumbering="unnumbered">N4FieldDeclaration &lt;Yield&gt;:
+    {N4FieldDeclaration}
+    FieldDeclarationImpl&lt;Yield&gt;
+;
+
+fragment FieldDeclarationImpl &lt;Yield&gt;*:
+    (declaredModifiers+=N4Modifier)* BogusTypeRefFragment?
+    declaredName=LiteralOrComputedPropertyName&lt;Yield&gt;
+    (declaredOptional?='?')?
+    ColonSepTypeRef?
+    ('=' expression=Expression&lt;In=true,Yield&gt;)?
+    Semi
+;</programlisting>
+</section>
+<section xml:id="data-fields-properties">
+<title>Properties</title>
+<simpara>Fields have the following properties which can be explicitly defined:</simpara>
+<variablelist>
+<varlistentry>
+<term><literal>declaredOptional</literal> </term>
+<listitem>
+<simpara>Tells whether the accessor was declared optional.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>typeRef</literal> </term>
+<listitem>
+<simpara>Type of the field; default value is <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>A</mi><mi>n</mi><mi>y</mi></math>.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>expr</literal> </term>
+<listitem>
+<simpara>Initializer expression, i.e. sets default value.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>static</literal> </term>
+<listitem>
+<simpara>Boolean flag set to true if field is a static field.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>const</literal> </term>
+<listitem>
+<simpara>Boolean flag set to true if field cannot be changed. Note that const fields are automatically static.
+Const fields need an initializer. Also see <xref linkend="_assignment-modifiers"/>.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+<note>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>c</mi><mi>o</mi><mi>n</mi><mi>s</mi><mi>t</mi></math> is <emphasis>not</emphasis> the (reversed) value of the property descriptor <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>w</mi><mi>r</mi><mi>i</mi><mi>t</mi><mi>a</mi><mi>b</mi><mi>l</mi><mi>e</mi></math> as the latter is checked at runtime while const may or may not be checked at runtime.</simpara>
+</note>
+<simpara>The following pseudo properties are defined via annotations for setting the values of the property descriptor:</simpara>
+<variablelist>
+<varlistentry>
+<term><literal>enumerable</literal> </term>
+<listitem>
+<simpara>Boolean flag reflecting the property descriptor <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>e</mi><mi>n</mi><mi>u</mi><mi>m</mi><mi>e</mi><mi>r</mi><mi>a</mi><mi>b</mi><mi>l</mi><mi>e</mi></math>, set via annotation <literal>@Enumerable(true|false)</literal>.
+The default value is <math xmlns="http://www.w3.org/1998/Math/MathML"><mstyle mathvariant="monospace"><mtext>true</mtext></mstyle></math>.<footnote><simpara>version 4.0</simpara></footnote></simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>declaredWriteable</literal> </term>
+<listitem>
+<simpara>Boolean flag reflecting the property descriptor <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>w</mi><mi>r</mi><mi>i</mi><mi>t</mi><mi>e</mi><mi>a</mi><mi>b</mi><mi>l</mi><mi>e</mi></math>, set via annotation <literal>@Writeable(true|false)</literal>.
+The default value is <math xmlns="http://www.w3.org/1998/Math/MathML"><mstyle mathvariant="monospace"><mtext>true</mtext></mstyle></math>.<footnote><simpara>This cannot be done w/o <literal>null</literal>/<literal>undefined</literal> analysis</simpara></footnote></simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>final</literal> </term>
+<listitem>
+<simpara>Boolean flag making the field read-only, and it must be set in the constructor. Also see <xref linkend="_assignment-modifiers"/>.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+<bridgehead xml:id="data-fields-derived-values" renderas="sect5">Derived values for fields</bridgehead>
+<variablelist>
+<varlistentry>
+<term><literal>readable</literal> </term>
+<listitem>
+<simpara>Always true for fields.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>abstract</literal> </term>
+<listitem>
+<simpara>Always false for fields.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>writeable</literal> </term>
+<listitem>
+<simpara>Set to false if field is declared const or final. In the latter case, it may be set in the constructor (cf. <xref linkend="_assignment-modifiers"/>).</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+<section xml:id="data-fields-semantics">
+<title>Semantics</title>
+<requirement xml:id="IDE-61">
+<title>Attributes</title>
+<simpara>
+<anchor xml:id="Req-IDE-61" xreflabel="[Req-IDE-61]"/>
+<emphasis role="strong">Requirement: IDE-61:</emphasis>
+<link linkend="Req-IDE-61">Attributes</link> (ver. 1)</simpara>
+    <simpara>
+
+For any attribute <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>a</mi></math> if a
+class <literal>C</literal>, the following constraints must hold:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>A required data field must not define an initializer:<?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>a</mi><mo>.</mo><mi>r</mi><mi>e</mi><mi>q</mi><mi>u</mi><mi>i</mi><mi>r</mi><mi>e</mi><mi>d</mi><mo>⇒</mo><mi>a</mi><mo>.</mo><mi>i</mi><mi>n</mi><mi>i</mi><mi>t</mi><mo>=</mo><mi>n</mi><mi>u</mi><mi>l</mi><mi>l</mi></math></simpara>
+</listitem>
+<listitem>
+<simpara>There must be no other member with the same name of a data field <literal>f</literal>.
+In particular, there must be no getter or setter defined with the same name:<?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mo>∀</mo><mi> </mi><mi>m</mi><mo>∈</mo><mi>f</mi><mo>.</mo><mi>o</mi><mi>w</mi><mi>n</mi><mi>e</mi><mi>r</mi><mo>.</mo><mi>m</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi><mi>s</mi><mi>:</mi><mi>m</mi><mo>≠</mo><mi>f</mi><mo>⇒</mo><mi>m</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>≠</mo><mi>f</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi></math></simpara>
+</listitem>
+</orderedlist>
+<simpara>If a subclass should set a different default value, this has to be done in the constructor of the subclass.</simpara>
+<simpara>For the relation of data fields and field accessors in the context of extending classes or implementing interfaces see <xref linkend="_redefinition-of-members"/>.</simpara>
+</requirement>
+</section>
+<section xml:id="data-fields-type-inference">
+<title>Type Inference</title>
+<simpara>The type of a field is the type of its declaration:</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow/><mrow><mi>Γ</mi><mo>⊢</mo><mi>f</mi><mi>:</mi><mi>Γ</mi><mo>⊢</mo><mi>d</mi></mrow></mfrac></math>
+<simpara>The type of a field declaration is either the declared type or the inferred type of the initializer expression:</simpara>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mfrac><mrow><mi>d</mi><mo>.</mo><mi>d</mi><mi>e</mi><mi>c</mi><mi>l</mi><mi>a</mi><mi>r</mi><mi>e</mi><mi>d</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi><mo>≠</mo><mstyle mathvariant="monospace"><mtext>null</mtext></mstyle><mspace width="3.0mm"/><mi>T</mi><mo>=</mo><mi>d</mi><mo>.</mo><mi>d</mi><mi>e</mi><mi>c</mi><mi>l</mi><mi>a</mi><mi>r</mi><mi>e</mi><mi>d</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mi>d</mi><mi>:</mi><mi>T</mi></mrow></mfrac></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mfrac><mrow><mi>d</mi><mo>.</mo><mi>d</mi><mi>e</mi><mi>c</mi><mi>l</mi><mi>a</mi><mi>r</mi><mi>e</mi><mi>d</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>null</mtext></mstyle><mspace width="3.0mm"/><mi>d</mi><mo>.</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>e</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>o</mi><mi>n</mi><mo>≠</mo><mstyle mathvariant="monospace"><mtext>null</mtext></mstyle></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mi>d</mi><mi>:</mi><mi>T</mi></mrow></mfrac></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mi>E</mi><mo>=</mo><mi>Γ</mi><mo>⊢</mo><mi>d</mi><mo>.</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>e</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>o</mi><mi>n</mi><mspace width="3.0mm"/><mi>E</mi><mo>∉</mo><mfenced close="}" open="{"><mstyle mathvariant="monospace"><mtext>null, undefined</mtext></mstyle></mfenced><mspace width="3.0mm"/><mi>T</mi><mo>=</mo><mi>E</mi><mi>}</mi></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mfrac><mrow><mi>e</mi><mi>l</mi><mi>s</mi><mi>e</mi></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mi>d</mi><mi>:</mi><mstyle mathvariant="monospace"><mtext>any</mtext></mstyle></mrow></mfrac></math></simpara>
+<simpara>If the type contains type variables they are substituted according to
+type parameters which are provided by the reference:</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><mi>Γ</mi><mo>⊢</mo><mi>t</mi><mi>f</mi><mi>i</mi><mi>e</mi><mi>l</mi><mi>d</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mi>:</mi><mi>T</mi></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mstyle mathvariant="monospace"><mtext>TField</mtext></mstyle><mi> </mi><mi>t</mi><mi>f</mi><mi>i</mi><mi>e</mi><mi>l</mi><mi>d</mi><mi>:</mi><mi>T</mi></mrow></mfrac></math>
+</section>
+</section>
+<section xml:id="_assignment-modifiers">
+<title>Assignment Modifiers</title>
+<simpara>Assignment of data fields can be modified by the assignment modifiers <literal>const</literal> (similar to constant variable declarations, see <xref linkend="_const"/>) and <literal>@Final</literal>.</simpara>
+<requirement xml:id="IDE-62">
+<title>Const Data Fields</title>
+<simpara>
+<anchor xml:id="Req-IDE-62" xreflabel="[Req-IDE-62]"/>
+<emphasis role="strong">Requirement: IDE-62:</emphasis>
+<link linkend="Req-IDE-62">Const Data Fields</link> (ver. 1)</simpara>
+    <simpara>
+
+For a data field <literal>f</literal> marked as <literal>const</literal>, the following constraints must hold:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>An initializer expression must be provided in the declaration (except in n4jsd files):<?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>f</mi><mo>.</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mo>≠</mo><mstyle mathvariant="monospace"><mtext>null</mtext></mstyle></math></simpara>
+</listitem>
+<listitem>
+<simpara>A constant data field is implicitly static and must be accessed only via the classifier type.
+It is not possible, therefore, to use the <literal>this</literal> keyword in the initializer expression of a constant field:<?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∄</mo><mi>s</mi><mi>u</mi><mi>b</mi><mo>∈</mo><mi>f</mi><mo>.</mo><mi>e</mi><mi>x</mi><mi>p</mi><msup><mi>r</mi><mo>*</mo></msup><mi>:</mi><mi>s</mi><mi>u</mi><mi>b</mi><mo>=</mo><mi>"</mi><mi>t</mi><mi>h</mi><mi>i</mi><mi>s</mi><mi>"</mi></math></simpara>
+</listitem>
+<listitem>
+<simpara>A constant data field must not be annotated with <literal>@Final</literal>:<?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>f</mi><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>s</mi><mi>t</mi><mo>→</mo><mo>¬</mo><mi>f</mi><mo>.</mo><mi>f</mi><mi>i</mi><mi>n</mi><mi>a</mi><mi>l</mi></math></simpara>
+</listitem>
+<listitem>
+<simpara>Constant data fields are not writeable (cf. <xref linkend="Req-IDE-68"/>):<?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>f</mi><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>s</mi><mi>t</mi><mo>→</mo><mo>¬</mo><mi>f</mi><mo>.</mo><mi>w</mi><mi>r</mi><mi>i</mi><mi>t</mi><mi>e</mi><mi>a</mi><mi>b</mi><mi>l</mi><mi>e</mi></math></simpara>
+</listitem>
+</orderedlist>
+</requirement>
+<requirement xml:id="IDE-63">
+<title>Final Data Fields</title>
+<simpara>
+<anchor xml:id="Req-IDE-63" xreflabel="[Req-IDE-63]"/>
+<emphasis role="strong">Requirement: IDE-63:</emphasis>
+<link linkend="Req-IDE-63">Final Data Fields</link> (ver. 1)</simpara>
+    <simpara>
+
+For a data field <literal>f</literal> marked as <literal>@Final</literal>, the following constraints must hold:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>A final data field must not be modified with <literal>const</literal> or <literal>static</literal>:<?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>f</mi><mo>.</mo><mi>f</mi><mi>i</mi><mi>n</mi><mi>a</mi><mi>l</mi><mo>→</mo><mo>¬</mo><mi>f</mi><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>s</mi><mi>t</mi><mo>∧</mo><mo>¬</mo><mi>f</mi><mo>.</mo><mi>d</mi><mi>e</mi><mi>c</mi><mi>l</mi><mi>a</mi><mi>r</mi><mi>e</mi><mi>d</mi><mi>S</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>c</mi></math></simpara>
+</listitem>
+<listitem>
+<simpara>A final data field is not writeable:<?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>f</mi><mo>.</mo><mi>f</mi><mi>i</mi><mi>n</mi><mi>a</mi><mi>l</mi><mo>→</mo><mo>¬</mo><mi>f</mi><mo>.</mo><mi>w</mi><mi>r</mi><mi>i</mi><mi>t</mi><mi>e</mi><mi>a</mi><mi>b</mi><mi>l</mi><mi>e</mi></math><?asciidoc-br?>
+A final field may, however, be set in the constructor.
+See <xref linkend="Req-IDE-68"/> for details.</simpara>
+</listitem>
+<listitem>
+<simpara>A final data field must be either initialized by an initializer expression or in the constructor.
+If the field is initialized in the constructor, this may be done either explicitly or via a spec style constructor.</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mtable><mtr><mtd><mspace width="3.0mm"/><mi>f</mi><mo>.</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mo>≠</mo><mstyle mathvariant="monospace"><mtext>null</mtext></mstyle></mtd></mtr><mtr><mtd><mspace width="3.0mm"/><mo>∨</mo><mrow><mo>(</mo><mo>∃</mo><mi>a</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>g</mi><mi>n</mi><mi>E</mi><mi>x</mi><mi>p</mi><mi>:</mi><mi>a</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>g</mi><mi>n</mi><mi>E</mi><mi>x</mi><mi>p</mi><mi>r</mi><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>t</mi><mi>a</mi><mi>i</mi><mi>n</mi><mi>i</mi><mi>n</mi><mi>g</mi><mi>F</mi><mi>u</mi><mi>n</mi><mi>c</mi><mi>t</mi><mi>i</mi><mi>o</mi><mi>n</mi><mo>=</mo><mi>f</mi><mo>.</mo><mi>o</mi><mi>w</mi><mi>n</mi><mi>e</mi><mi>r</mi><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>s</mi><mi>t</mi><mi>r</mi><mi>u</mi><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi></mrow></mtd></mtr><mtr><mtd><mspace width="3.0mm"/><mspace width="3.0em"/><mo>∧</mo><mi>a</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>g</mi><mi>n</mi><mi>E</mi><mi>x</mi><mi>p</mi><mi>r</mi><mo>.</mo><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi><mo>.</mo><mi>t</mi><mi>a</mi><mi>r</mi><mi>g</mi><mi>e</mi><mi>t</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>"this"</mtext></mstyle></mtd></mtr><mtr><mtd><mrow><mspace width="3.0mm"/><mspace width="3.0em"/><mo>∧</mo><mi>b</mi><mi>i</mi><mi>n</mi><mi>d</mi><mfenced close=")" open="("><mrow><mi>a</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>g</mi><mi>n</mi><mi>E</mi><mi>x</mi><mi>p</mi><mi>r</mi><mo>.</mo><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi><mo>.</mo><mi>p</mi><mi>r</mi><mi>o</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>t</mi><mi>y</mi></mrow><mi>f</mi></mfenced><mo>)</mo></mrow></mtd></mtr><mtr><mtd><mspace width="3.0mm"/><mo>∨</mo><mrow><mo>(</mo><mi>f</mi><mo>.</mo><mi>p</mi><mi>u</mi><mi>b</mi><mi>l</mi><mi>i</mi><mi>c</mi><mo>∧</mo><mo>∃</mo><mi>f</mi><mi>p</mi><mi>a</mi><mi>r</mi><mo>∈</mo><mi>f</mi><mo>.</mo><mi>o</mi><mi>w</mi><mi>n</mi><mi>e</mi><mi>r</mi><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>s</mi><mi>t</mi><mi>r</mi><mi>u</mi><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi><mo>.</mo><mi>f</mi><mi>p</mi><mi>a</mi><mi>r</mi><mi>s</mi><mi>:</mi></mrow></mtd></mtr><mtr><mtd><mrow><mspace width="3.0mm"/><mspace width="3.0em"/><mi>f</mi><mi>p</mi><mi>a</mi><mi>r</mi><mo>.</mo><mi>s</mi><mi>p</mi><mi>e</mi><mi>c</mi><mo>∧</mo><mo>∃</mo><mi>s</mi><mi>m</mi><mo>∈</mo><mi>s</mi><mi>t</mi><mi>r</mi><mi>u</mi><mi>c</mi><mi>t</mi><mi>u</mi><mi>r</mi><mi>a</mi><mi>l</mi><mi>M</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi><mi>s</mi><mi>:</mi><mi>s</mi><mi>m</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><mi>f</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>)</mo></mrow></mtd></mtr></mtable></math>
+</listitem>
+</orderedlist>
+</requirement>
+</section>
+<section xml:id="_field-accessors-getter-setter">
+<title>Field Accessors (Getter/Setter)</title>
+<simpara>Instead of a simple data field, a field can be defined by means of the getter and setter accessor methods.
+These accessor methods are similar to the accuser methods in object literals:</simpara>
+<section xml:id="field-acessors-syntax">
+<title>Syntax</title>
+<programlisting language="xtext" linenumbering="unnumbered">N4GetterDeclaration &lt;Yield&gt;:
+    =&gt; ({N4GetterDeclaration}
+    (declaredModifiers+=N4Modifier)*
+    GetterHeader&lt;Yield&gt;)
+    (body=Block&lt;Yield&gt;)? ';'?
+;
+
+fragment GetterHeader &lt;Yield&gt;*:
+    BogusTypeRefFragment? 'get' -&gt; declaredName=LiteralOrComputedPropertyName&lt;Yield&gt;
+    (declaredOptional?='?')?
+    '(' ')'
+    ColonSepTypeRef?
+;
+
+N4SetterDeclaration &lt;Yield&gt;:
+    =&gt;({N4SetterDeclaration}
+        (declaredModifiers+=N4Modifier)*
+        'set'
+        -&gt;declaredName=LiteralOrComputedPropertyName &lt;Yield&gt;
+    )
+    (declaredOptional?='?')?
+    '(' fpar=FormalParameter&lt;Yield&gt; ')' (body=Block&lt;Yield&gt;)? ';'?
+;</programlisting>
+<simpara>Notes with regard to syntax: Although ECMAScript 6 does not define fields in classes, it defines getter and setter methods similarly (cf. [<link linkend="ECMA15a">ECMA15a(p.S13.3, p.p.209)</link>]).</simpara>
+<example>
+<title>Getter and Setter</title>
+<simpara>The getter and setter implementations usually reference data fields internally.
+These are to be declared explicitly (although ECMAScript allows creating fields on the fly on their first usage).
+The following example demonstrates a typical usage of getter and setter in combination with a data field.
+The getter lazily initializes the field on demand.
+The setter performs some notification.</simpara>
+<formalpara>
+<title>Getter Setter</title>
+<para>
+<programlisting language="n4js" linenumbering="unnumbered">class A {}
+
+class C {
+    private _data: A = null;
+
+    public get data(): A {
+        if (this._data==null) {
+            this._data = new A();
+        }
+        return this._data;
+    }
+
+    public set data(data: A) {
+        this._data = data;
+        this.notifyListeners();
+    }
+
+    notifyListeners(): void {
+        // ...
+    }
+}</programlisting>
+</para>
+</formalpara>
+</example>
+</section>
+<section xml:id="field-acessors-properties">
+<title>Properties</title>
+<simpara>Properties for field accessors:</simpara>
+<variablelist>
+<varlistentry>
+<term><literal>declaredOptional</literal> </term>
+<listitem>
+<simpara>Tells whether the accessor was declared optional.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>readable</literal> </term>
+<listitem>
+<simpara>Derived value: true for getters and false for setters.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>writable</literal> </term>
+<listitem>
+<simpara>Derived value: false for getters and true for setters.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+</section>
+<section xml:id="field-accessors-semantics">
+<title>Semantics</title>
+<simpara>There must be no field or method with the same name as a field accessor (follows from <xref linkend="Req-IDE-52"/>). In addition, the following constraints must hold:</simpara>
+<requirement xml:id="IDE-64">
+<title>Field Accessors</title>
+<simpara>
+<anchor xml:id="Req-IDE-64" xreflabel="[Req-IDE-64]"/>
+<emphasis role="strong">Requirement: IDE-64:</emphasis>
+<link linkend="Req-IDE-64">Field Accessors</link> (ver. 1)</simpara>
+    <simpara>
+</simpara>
+<itemizedlist>
+<listitem>
+<simpara>The return type of a getter must not be <literal>void</literal>.</simpara>
+</listitem>
+<listitem>
+<simpara>The type of the parameter of a setter must not be <literal>void</literal>.</simpara>
+</listitem>
+<listitem>
+<simpara>If a getter <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>g</mi></math> is defined or consumed (from an interface) or merged-in (via static polyfill) in a class <literal>C</literal> and a setter <literal>S</literal> with <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>s</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><mi>g</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>∧</mo><mi>s</mi><mo>.</mo><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>c</mi><mo>=</mo><mi>g</mi><mo>.</mo><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>c</mi></math> is inherited by
+<literal>C</literal> from one of its super classes, then <literal>C</literal> must define a setter <math xmlns="http://www.w3.org/1998/Math/MathML"><msup><mi>s</mi><mi>'</mi></msup></math> with
+<math xmlns="http://www.w3.org/1998/Math/MathML"><msup><mi>s</mi><mi>'</mi></msup><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><mi>g</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>∧</mo><msup><mi>s</mi><mi>'</mi></msup><mo>.</mo><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>c</mi><mo>=</mo><mi>g</mi><mo>.</mo><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>c</mi></math> <footnote><simpara>This is required, because in Javascript a getter shadows a corresponding setter defined further up in the prototype chain; likewise a setter shadows a corresponding getter.</simpara></footnote>.</simpara>
+</listitem>
+<listitem>
+<simpara>A setter must have exactly one formal parameter, i.e. variadic or default modifiers are not allowed.</simpara>
+</listitem>
+</itemizedlist>
+<simpara>The same applies to setters, accordingly.</simpara>
+<itemizedlist>
+<listitem>
+<simpara><xref linkend="Req-IDE-72"/>, <xref linkend="Req-IDE-73"/>, and <xref linkend="Req-IDE-74"/> apply to field accessors accordingly (getter / setter overriding).</simpara>
+</listitem>
+</itemizedlist>
+<note role="language-n4js">
+<simpara>A getter and setter with the same name need not have the same type, i.e. the getter’s return type need not be the same as a subtype of
+the type of the setter’s parameter (the types can be completely unrelated).<footnote><simpara>Thus, the type of one accessor is not used to infer the type of the other one. E.g., from <literal>set x(string s)</literal>, we cannot infer <literal>get x()</literal> to return <literal>string</literal> — instead, the getter is inferred to return <literal>any</literal>.</simpara></footnote></simpara>
+</note>
+</requirement>
+<simpara>Getters and setters – like functions – define a variable execution environment and therefore provide access to the actual passed-in parameters through the implicit <literal>arguments</literal>
+variable inside of their bodies (c.f. <xref linkend="_arguments-object"/>).</simpara>
+</section>
+</section>
+<section xml:id="optional-fields">
+<title>Optional Fields</title>
+<simpara>Data fields and field accessors of a classifier C can be declared optional, meaning that a structural subtype of C
+need not provide this field, but if it does, the field must be of correct type. However, to ensure overall type safety,
+the scope of application of this optionality is limited to a small number of specific use cases, as described in the
+following.</simpara>
+<section xml:id="_syntax-6">
+<title>Syntax</title>
+<simpara>To denote a data field or accessor as optional, a question mark is placed right after the name:</simpara>
+<formalpara>
+<title>Syntax of optional fields</title>
+<para>
+<programlisting language="n4js" linenumbering="unnumbered">class C {
+    public field?: string;
+
+    public get getter?(): number {
+        return 42;
+    }
+    public set setter?(value: number) {}
+}</programlisting>
+</para>
+</formalpara>
+<simpara>The detailed grammar is given in the sections for data fields, cf. <xref linkend="data-fields-syntax"/>,
+and field accessors, cf. <xref linkend="field-acessors-syntax"/>.</simpara>
+</section>
+<section xml:id="_semantics-5">
+<title>Semantics</title>
+<simpara>It is important to note that the optionality of a field is, by default and in most cases, ignored and
+has an effect only in certain special cases.</simpara>
+<simpara>The effect of a field being optional is defined by the following requirement.</simpara>
+<requirement xml:id="IDE-240500">
+<title>Optional Fields</title>
+<simpara>
+<anchor xml:id="Req-IDE-240500" xreflabel="[Req-IDE-240500]"/>
+<emphasis role="strong">Requirement: IDE-240500:</emphasis>
+<link linkend="Req-IDE-240500">Optional Fields</link> (ver. 1)</simpara>
+    <simpara>
+</simpara>
+<simpara>By default, a data field, getter, or setter that is declared optional is handled in the
+exact same way as if no optionality were involved (i.e. by default, optionality is ignored).</simpara>
+<simpara>Optionality has an effect only in case of structural subtype checks <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>L</mi><mo>&lt;</mo><mi>:</mi><mi>R</mi></math> in which
+the left-hand side is one of the following:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>an object literal.</simpara>
+</listitem>
+<listitem>
+<simpara>a new expression.</simpara>
+</listitem>
+<listitem>
+<simpara>an instance of a final class, i.e. the type of the value on left-hand side must be nominal and refer to a final class.</simpara>
+</listitem>
+<listitem>
+<simpara>a reference to a const variable if its initializer expression is one of the following:</simpara>
+<orderedlist numeration="loweralpha">
+<listitem>
+<simpara>an object literal.</simpara>
+</listitem>
+<listitem>
+<simpara>a new expression.</simpara>
+</listitem>
+<listitem>
+<simpara>an instance of a final class (as explained above).</simpara>
+</listitem>
+<listitem>
+<simpara>an ternary expression</simpara>
+</listitem>
+</orderedlist>
+</listitem>
+</orderedlist>
+<simpara>and then</simpara>
+<itemizedlist>
+<listitem>
+<simpara>in cases 1 and 4a, <emphasis role="strong">both</emphasis> fields and accessors (getters and setters) are optional.
+That means, an optional data field, getter, or setter of <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>R</mi></math> needs not be present in <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>L</mi></math>.</simpara>
+</listitem>
+<listitem>
+<simpara>in cases 2, 3, 4b, and 4c, only <emphasis role="strong">getters</emphasis> are optional, setters are not optional.
+That means, an optional getter of <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>R</mi></math> needs not be present in <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>L</mi></math> and an optional field of <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>R</mi></math> requires only a setter in <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>L</mi></math>. Note that these cases are more restricted than the cases 1 and 4a.</simpara>
+</listitem>
+</itemizedlist>
+<simpara>Moreover, optionality has an effect in case of ternary expression <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>L</mi><mo>&lt;</mo><mi>:</mi><mi>R</mi></math> in which the left-hand side is a ternary expression, e.g. <literal>l = b? trueExpr : falseExpr</literal> whose <literal>trueExpr</literal> or <literal>falseExpr</literal> possibly recursively contains an expression of the kind mentioned above. In this case, the optionality effect is the more restricted optinality of <literal>trueExpr</literal> and <literal>falseExpr</literal>.</simpara>
+<simpara>If, according to these rules, a data field / getter / setter of <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>R</mi></math> need not be present in
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>L</mi></math> but a member with the same name and access is actually present in <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>L</mi></math>, that member in <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>L</mi></math>
+must be a data field / getter / setter of the same type / a subtype / a super type, respectively.
+In other words, if a not actually required member is present in the subtype, ordinary rules
+for member compatibility apply as if no optionality were involved (cf. general subtyping rules
+for structural types).</simpara>
+</requirement>
+<simpara>In other words, in object literals (cases 1 and 4a) neither optional getters, optional setters,
+nor optional data fields are required. However, in case of new expressions and instances of
+final classes (cases 2, 3, 4b, 4c) only optional getters are not required in a subtype;
+optional setters are required as normal (i.e. optionality ignored) and optional data fields
+require at least a setter.</simpara>
+<simpara>The following table summarizes the most common cases and shows how this relates to the different
+forms of structural typing.</simpara>
+<table xml:id="tab:optionalFields" frame="all" rowsep="1" colsep="1">
+<title>Optional Fields</title>
+<tgroup cols="8">
+<colspec colname="col_1" colwidth="25*"/>
+<colspec colname="col_2" colwidth="8.3333*"/>
+<colspec colname="col_3" colwidth="8.3333*"/>
+<colspec colname="col_4" colwidth="8.3333*"/>
+<colspec colname="col_5" colwidth="8.3333*"/>
+<colspec colname="col_6" colwidth="8.3333*"/>
+<colspec colname="col_7" colwidth="8.3333*"/>
+<colspec colname="col_8" colwidth="25.0002*"/>
+<tbody>
+<row>
+<entry align="left" valign="top"></entry>
+<entry align="center" valign="top" namest="col_2" nameend="col_6"><simpara>&#916;</simpara></entry>
+<entry align="center" valign="top"><simpara>Case</simpara></entry>
+<entry align="left" valign="top"><simpara>Comment</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"></entry>
+<entry align="center" valign="top"><simpara><literal>~</literal></simpara></entry>
+<entry align="center" valign="top"><simpara><literal>~~</literal></simpara></entry>
+<entry align="center" valign="top"><simpara><literal>~w~</literal></simpara></entry>
+<entry align="center" valign="top"><simpara><literal>~r~</literal></simpara></entry>
+<entry align="center" valign="top"><simpara><literal>~i~</literal></simpara></entry>
+<entry align="center" valign="top"></entry>
+<entry align="left" valign="top"></entry>
+</row>
+<row>
+<entry align="left" valign="top"></entry>
+<entry align="center" valign="top" namest="col_2" nameend="col_4"><simpara>may have setter</simpara></entry>
+<entry align="center" valign="top" namest="col_3" nameend="col_4"><simpara>never has setter</simpara></entry>
+<entry align="center" valign="top"></entry>
+<entry align="center" valign="top"></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><emphasis role="strong"><literal>let x: &#916;C = {};</literal></emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara>✓</simpara></entry>
+<entry align="center" valign="top"><simpara>✓</simpara></entry>
+<entry align="center" valign="top"><simpara>✓</simpara></entry>
+<entry align="center" valign="top"><simpara>✓</simpara></entry>
+<entry align="center" valign="top"><simpara>✓</simpara></entry>
+<entry align="center" valign="top"><simpara>1</simpara></entry>
+<entry align="left" valign="top"><simpara>nothing mandatory</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><emphasis role="strong"><literal>let x: &#916;C = new D0();</literal></emphasis></simpara></entry>
+<entry align="center" valign="top"></entry>
+<entry align="center" valign="top"></entry>
+<entry align="center" valign="top"></entry>
+<entry align="center" valign="top"><simpara>✓</simpara></entry>
+<entry align="center" valign="top"><simpara>✓</simpara></entry>
+<entry align="center" valign="top"><simpara>2</simpara></entry>
+<entry align="left" valign="top"><simpara>setters mandatory</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><emphasis role="strong"><literal>let x: &#916;C = new DG();</literal></emphasis></simpara></entry>
+<entry align="center" valign="top"></entry>
+<entry align="center" valign="top"></entry>
+<entry align="center" valign="top"></entry>
+<entry align="center" valign="top"><simpara>✓</simpara></entry>
+<entry align="center" valign="top"><simpara>✓</simpara></entry>
+<entry align="center" valign="top"><simpara>2</simpara></entry>
+<entry align="left" valign="top"><simpara>setters mandatory</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><emphasis role="strong"><literal>let x: &#916;C = new DS();</literal></emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara>✓</simpara></entry>
+<entry align="center" valign="top"><simpara>✓</simpara></entry>
+<entry align="center" valign="top"><simpara>✓</simpara></entry>
+<entry align="center" valign="top"><simpara>✓</simpara></entry>
+<entry align="center" valign="top"><simpara>✓</simpara></entry>
+<entry align="center" valign="top"><simpara>2</simpara></entry>
+<entry align="left" valign="top"><simpara>setters mandatory</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><emphasis role="strong"><literal>let x: &#916;C = fooD0();</literal></emphasis></simpara></entry>
+<entry align="center" valign="top"></entry>
+<entry align="center" valign="top"></entry>
+<entry align="center" valign="top"></entry>
+<entry align="center" valign="top"></entry>
+<entry align="center" valign="top"></entry>
+<entry align="center" valign="top"><simpara>none</simpara></entry>
+<entry align="left" valign="top"><simpara>D0 not final</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><emphasis role="strong"><literal>let x: &#916;C = fooSF0();</literal></emphasis></simpara></entry>
+<entry align="center" valign="top"></entry>
+<entry align="center" valign="top"></entry>
+<entry align="center" valign="top"></entry>
+<entry align="center" valign="top"></entry>
+<entry align="center" valign="top"></entry>
+<entry align="center" valign="top"><simpara>none</simpara></entry>
+<entry align="left" valign="top"><simpara>fooSF0() not nominal</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><emphasis role="strong"><literal>let x: &#916;C = fooF0();</literal></emphasis></simpara></entry>
+<entry align="center" valign="top"></entry>
+<entry align="center" valign="top"></entry>
+<entry align="center" valign="top"></entry>
+<entry align="center" valign="top"><simpara>✓</simpara></entry>
+<entry align="center" valign="top"><simpara>✓</simpara></entry>
+<entry align="center" valign="top"><simpara>3</simpara></entry>
+<entry align="left" valign="top"><simpara>setters mandatory</simpara></entry>
+</row>
+</tbody>
+</tgroup>
+</table>
+<simpara>In the table, a "✓" means that the particular example is valid; in all other cases an error would
+be shown in N4JS source code. Here are the classes and functions used in the above table:</simpara>
+<formalpara>
+<title>Classes and functions used in table</title>
+<para>
+<programlisting language="n4js" linenumbering="unnumbered">class C {
+    public field?: string;
+}
+
+class D0 {}
+
+class DG {
+    public get field(): string { return "hello"; }
+}
+
+class DS {
+    public set field(value: string) {}
+}
+
+@Final class F0 {}
+
+function fooD0(): D0   { return new D0(); }
+function fooSF0(): ~F0 { return new F0(); }
+function fooF0(): F0   { return new F0(); }</programlisting>
+</para>
+</formalpara>
+<simpara>It follows from the above definitions in Requirements <xref linkend="Req-IDE-240500"/> that cases 4a and 4b are not
+transitive across a chain of several <literal>const</literal> variables, whereas case 4c is transitive. For example:</simpara>
+<formalpara>
+<title>Transitivity of the use cases of optional fields</title>
+<para>
+<programlisting language="n4js" linenumbering="unnumbered">class C {
+	public get getter?(): string {return null;}
+}
+class D {}
+@Final class F {}
+
+let c: ~C;
+
+
+// no transitivity via several const variables in use case "object literal":
+
+const ol1 = {};
+const ol2 = ol1;
+
+// XPECT errors --&gt; "~Object is not a structural subtype of ~C: missing getter getter." at "ol2"
+c = ol2;
+
+
+// no transitivity via several const variables in use case "new expression":
+
+const new1 = new D();
+const new2 = new1;
+
+// XPECT errors --&gt; "D is not a structural subtype of ~C: missing getter getter." at "new2"
+c = new2;
+
+
+// BUT: we do have transitivity via several const variables in use case "final nominal type":
+
+const finalNominal1 = new F();
+const finalNominal2 = finalNominal1;
+
+// XPECT noerrors --&gt;
+c = finalNominal1;
+// XPECT noerrors --&gt; "transitivity applies in this case"
+c = finalNominal2;</programlisting>
+</para>
+</formalpara>
+<simpara>The following example demonstrates how optionality behaves in ternay expressions.</simpara>
+<formalpara>
+<title>Optional fields in ternay expressions</title>
+<para>
+<programlisting language="n4js" linenumbering="unnumbered">interface ~I {
+    public m?: int;
+}
+
+class ~C { }
+
+@Final class F { }
+
+let b: boolean;
+const cc: C = {}
+let f1 = new F();
+let f2: ~F = {};
+
+// True expression is a const object literal, so both fields and accessors in I are optional.
+// False expression is a new expression, so only getters in I are optionals.
+// As a result, only getters in I are optional.
+// XPECT errors --&gt; "C is not a structural subtype of I: missing field m." at "b? cc : new C()"
+var te1: I = b? cc : new C()
+
+// No errors because both true and false expressions are object literal constants and hence
+// Both fields and accessors in I are optional.
+// XPECT noerrors
+var te2: I = b? cc : {}</programlisting>
+</para>
+</formalpara>
+</section>
+<section xml:id="_background">
+<title>Background</title>
+<simpara>The following example illustrates why optionality of fields has to be restricted
+to the few special cases defined above (i.e. object literals, new expressions, etc.).</simpara>
+<formalpara>
+<title>Problem 1 of optional fields</title>
+<para>
+<programlisting language="n4js" linenumbering="unnumbered">class C {
+	public field?: string = "hello";
+}
+
+class D {}
+class DD extends D {
+	public field: number = 42;
+}
+
+let c: ~C;
+let d: D;
+
+d = new DD();
+
+c = d;  // without the restrictive semantics of optional fields, this assignment would be allowed (but shows compile-time error in N4JS)
+
+console.log(c.field); // prints 42 even though the type is string
+c.field.charAt(0); // exception at runtime: c.field.charAt is not a function</programlisting>
+</para>
+</formalpara>
+<simpara>In the last line of the above example, <literal>c.field</literal> is actually <literal>42</literal> but the type systems claims it is of type <literal>string</literal> and
+thus allows accessing member <literal>charAt</literal> of type <literal>string</literal> which is undefined at runtime the actual value <literal>42</literal>.</simpara>
+<simpara>The next example shows why cases 2 and 3 (i.e. new expressions and instances of final classes) have to be handled in
+a more restrictive manner than case 1 (i.e. object literals).</simpara>
+<formalpara>
+<title>Problem 2 of optional fields</title>
+<para>
+<programlisting language="n4js" linenumbering="unnumbered">class C {
+	public field?: string;
+}
+
+class D {}
+
+let c: ~C;
+
+c = new D(); // error: new expression but D is missing setter
+
+c.field = "hello";</programlisting>
+</para>
+</formalpara>
+<simpara>In the previous code, if <literal>c = new D()</literal> were allowed, we would add a new property <literal>field</literal> to the instance of class
+<literal>D</literal> in the last line, which N4JS aims to avoid in general, unless unsafe language features such as dynamic types
+are being employed.</simpara>
+</section>
+</section>
+</section>
+<section xml:id="_static-members" role="language-n4js">
+<title>Static Members</title>
+<simpara>Static data fields, field accessors and methods are quite similar to instance members, however they are not members of instances of the type but the type itself.
+They are defined similarly to instance members except that they are specified with the modifier <literal>static</literal>.
+Since they are members of the type, the <literal>this</literal> keyword is not bound to instances of the class, but again to the type itself.
+This is similar as in ECMAScript 6 ([<link linkend="ECMA15a">ECMA15a(p.14.5.15)</link>]).
+Since static members are not instance but type members, it is even possible that a static member has the same name as an instance member.</simpara>
+<simpara>Note that static members are not only allowed in classes but also in interfaces, but there are important differences
+(for example, no inheritance of static members of interfaces, cf. Section <xref linkend="_static-members-of-interfaces"/>).</simpara>
+<requirement xml:id="IDE-65">
+<title>Static member not abstract</title>
+<simpara>
+<anchor xml:id="Req-IDE-65" xreflabel="[Req-IDE-65]"/>
+<emphasis role="strong">Requirement: IDE-65:</emphasis>
+<link linkend="Req-IDE-65">Static member not abstract</link> (ver. 1)</simpara>
+    <simpara>
+
+For a static field accessor or method <literal>S</literal>, the following constraint must hold:</simpara>
+<itemizedlist>
+<listitem>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>s</mi><mo>.</mo><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>c</mi><mo>⇔</mo><mo>¬</mo><mi>s</mi><mo>.</mo><mi>a</mi><mi>b</mi><mi>s</mi><mi>t</mi><mi>r</mi><mi>a</mi><mi>c</mi><mi>t</mi></math></simpara>
+</listitem>
+</itemizedlist>
+</requirement>
+<simpara>Like instance methods, static methods of classes are inherited by subclasses and it is possible to override static methods in subclasses.
+The very same override constraints are valid in this case as well.</simpara>
+<section xml:id="_access-from-and-to-static-members">
+<title>Access From and To Static Members</title>
+<requirement xml:id="IDE-66">
+<title>Accessing Static Members</title>
+<simpara>
+<anchor xml:id="Req-IDE-66" xreflabel="[Req-IDE-66]"/>
+<emphasis role="strong">Requirement: IDE-66:</emphasis>
+<link linkend="Req-IDE-66">Accessing Static Members</link> (ver. 1)</simpara>
+    <simpara>
+</simpara>
+<simpara>Let <literal>M</literal> be a static member of class <literal>C</literal>. Except for write-access to
+fields, which will be explained later, you can access <literal>M</literal>
+via:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>The class declaration instance, i.e. the classifier or constructor type, <literal>constructor{C}</literal>, i.e. <literal>C.m</literal></simpara>
+</listitem>
+<listitem>
+<simpara>The class declaration instance of a subtype, i.e. the classifier or constructor type, i.e. <literal>D.m</literal>, if <literal>D</literal> is a subclass of <literal>C</literal>.</simpara>
+</listitem>
+<listitem>
+<simpara><literal>v.m</literal>, if <literal>v</literal> is a variable of type <literal>C</literal> (i.e. classifier type as defined in <xref linkend="_constructor-and-classifier-type"/>) or a subtype thereof.</simpara>
+</listitem>
+<listitem>
+<simpara><literal>this.m</literal> inside the body of any static method declared in <literal>C</literal> or any sub-class of <literal>C</literal>.</simpara>
+</listitem>
+<listitem>
+<simpara>Via a type variable <literal>T</literal> which upper bound is a subclassof <literal>C</literal> e.g., <literal>function &lt;T extends C&gt; f(){T.m}</literal></simpara>
+</listitem>
+</orderedlist>
+</requirement>
+<requirement xml:id="IDE-67">
+<title>Static Member Access</title>
+<simpara>
+<anchor xml:id="Req-IDE-67" xreflabel="[Req-IDE-67]"/>
+<emphasis role="strong">Requirement: IDE-67:</emphasis>
+<link linkend="Req-IDE-67">Static Member Access</link> (ver. 1)</simpara>
+    <simpara>
+
+It is not possible to access instance members from static members.
+This is true in particular for type variables defined by a generic classifier.</simpara>
+</requirement>
+<requirement xml:id="IDE-68">
+<title>Write-access to static data fields and static setter</title>
+<simpara>
+<anchor xml:id="Req-IDE-68" xreflabel="[Req-IDE-68]"/>
+<emphasis role="strong">Requirement: IDE-68:</emphasis>
+<link linkend="Req-IDE-68">Write-access to static data fields and static setter</link> (ver. 1)</simpara>
+    <simpara>
+</simpara>
+<simpara>For static data fields and static setter <literal>f</literal> the following constraint must hold:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>For every assign expression <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>a</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>g</mi><mi>n</mi><mi>E</mi><mi>x</mi><mi>p</mi><mi>r</mi></math> with <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>f</mi><mo>.</mo><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>c</mi><mo>∧</mo><mi>a</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>g</mi><mi>n</mi><mi>E</mi><mi>x</mi><mi>p</mi><mi>r</mi><mo>.</mo><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi><mo>=</mo><mi>T</mi><mo>.</mo><mi>f</mi><mo>⇒</mo><mi>T</mi><mo>=</mo><mi>f</mi><mo>.</mo><mi>o</mi><mi>w</mi><mi>n</mi><mi>e</mi><mi>r</mi></math>.</simpara>
+</listitem>
+<listitem>
+<simpara>For every writing unary expression <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>u</mi></math> with <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>u</mi><mo>.</mo><mi>o</mi><mi>p</mi><mo>∈</mo><mfenced close="}" open="{"><mrow><mo>+</mo><mo>+</mo></mrow><mrow><mo>-</mo><mo>-</mo></mrow></mfenced><mo>∧</mo><mi>f</mi><mo>.</mo><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>c</mi><mo>∧</mo><mi>u</mi><mo>.</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>e</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>o</mi><mi>n</mi><mo>=</mo><mi>T</mi><mo>.</mo><mi>f</mi><mo>⇒</mo><mi>T</mi><mo>=</mo><mi>f</mi><mo>.</mo><mi>o</mi><mi>w</mi><mi>n</mi><mi>e</mi><mi>r</mi></math>.</simpara>
+</listitem>
+</itemizedlist>
+</requirement>
+<simpara>In the special case of <literal>m</literal> being a static data field, write-access is only possible via the defining type name <literal>C.m</literal>.
+In the list above, only the first line can be used when assigning values to a field. Note that this only applies to fields and set-accessors.<footnote><simpara>The technical reason for this rule is the way properties are stored in JavaScript. Take for an example subclass-write access : <literal role="language-n4js">class C { static f="a";}</literal> with <literal role="language-n4js">class D extends C { }</literal>. Now the data field <literal>f</literal> on <literal>C</literal> can also be queried using <literal>D</literal> (<literal role="language-n4js">var q=D.f;</literal>) but writing (<literal role="language-n4js">D.f="b";</literal>) would introduce a newly created property <literal>f</literal> on class <literal>D</literal>, which differs from the one defined on <literal>C</literal>. It would do this without explicitly overriding the inherited property. Subsequent reads to <literal role="language-n4js">D.f</literal> would route to this ’accidentally’ introduced property. Such a behavior would not be expected and therefore has been disallowed. Note that this write restriction applies to data-fields and to field setters.</simpara></footnote></simpara>
+<simpara>It is even possible to call a static field accessor or method of a class using dynamic polymorphism, as demonstrated in the following example:</simpara>
+<example xml:id="ex:Polymorphism_and_static_methods">
+<title>Static members of classes, inheritance and polymorphism</title>
+<programlisting language="n4js" linenumbering="unnumbered">class A {
+    static m(): void { console.log('A#m'); }
+
+    static foo(): void { console.log('A#foo'); }
+
+    static bar(): void {
+        this.foo();
+    }
+}
+
+class B extends A {
+    @Override
+    static foo(): void { console.log('B#foo'); }
+}
+
+A.m(); // will print "A#m"
+B.m(); // will print "A#m" (m is inherited by B)
+
+var t: type{A} = A;
+t.foo(); // will print "A#foo"
+t = B;
+t.foo(); // will print "B#foo"
+
+// using 'this':
+
+A.bar(); // will print "A#foo"
+B.bar(); // will print "B#foo"</programlisting>
+</example>
+<simpara>This is quite different from Java where static methods are not inherited and references to static methods are statically bound at compile time
+depending on the declared type of the receiver (and not its value):</simpara>
+<example>
+<title>Static members in Java</title>
+<programlisting language="java" linenumbering="unnumbered">// !!! JAVA CODE !!!
+public class C {
+
+    static void m() { System.out.println("C#m"); }
+
+    public static void main(String[] args) {
+        final C c = null;
+        c.m();  // will print "C#m" (no NullPointerException at runtime)
+    }
+}</programlisting>
+</example>
+</section>
+<section xml:id="_generic-static-methods">
+<title>Generic static methods</title>
+<simpara>It is not possible to refer to type variables of a generic class, as these type variables are never bound to any concrete types.
+A static method can, however, be declared generic.
+Generic static methods are defined similarly to generic instance methods.
+Since they cannot refer to type variables of a generic class, the constraint to avoid type variables with equal names (see <xref linkend="Req-IDE-55"/>) does not need to hold for generic static methods.</simpara>
+</section>
+<section xml:id="_static-members-of-interfaces">
+<title>Static Members of Interfaces</title>
+<simpara>Data fields, field accessors and methods of interfaces may be declared
+static. A few restrictions apply:</simpara>
+<requirement xml:id="IDE-69">
+<title>Static Members of Interfaces</title>
+<simpara>
+<anchor xml:id="Req-IDE-69" xreflabel="[Req-IDE-69]"/>
+<emphasis role="strong">Requirement: IDE-69:</emphasis>
+<link linkend="Req-IDE-69">Static Members of Interfaces</link> (ver. 1)</simpara>
+    <simpara>
+</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>Static members of interfaces may only be accessed directly via the containing interface’s type name
+(this means, of the four ways of accessing static members of classes defined in <xref linkend="Req-IDE-66"/> above, only the first one applies to static members of interfaces).</simpara>
+</listitem>
+<listitem>
+<simpara>The <literal>this</literal> literal may not be used in static methods or field accessors of interfaces and it may not be used in the initializer expression of static fields of interfaces. See <xref linkend="Req-IDE-173"/>.</simpara>
+</listitem>
+<listitem>
+<simpara>The <literal>super</literal> literal may not be used in static methods or field accessors of interfaces (in fact, it may not be used in interfaces at all, cf. <xref linkend="Req-IDE-123"/>).</simpara>
+</listitem>
+</orderedlist>
+</requirement>
+<simpara>Note that the <literal>this</literal> type as a return type for methods is only allowed for instance methods and as an argument type only in constructors (structurally typed).
+There is no need to disallow these cases for static interface methods in the constraints above.</simpara>
+<simpara>In general, static members may not be abstract, cf. <xref linkend="Req-IDE-46"/>, which applies here as well.
+Static methods and field accessors of interfaces, therefore, always have to provide a body.</simpara>
+<simpara>Static members of interfaces are much more restricted than those of classes.
+Compare the following example to <xref linkend="_polymorphism-and-static-methods"/> for classes above:</simpara>
+<example>
+<title>Static members of interfaces</title>
+<programlisting language="n4js" linenumbering="unnumbered">interface I {
+    static m(): void { console.log('I#m'); }
+}
+
+interface J extends I {}
+
+I.m(); // prints "I#m"
+J.m(); // ERROR! (m is not inherited by J)
+
+var ti: type{I} = I;
+ti.m(); // ERROR! (access to m only allowed directly via type name I)
+ti = J;
+ti.m(); // ERROR! (access to m only allowed directly via type name I)</programlisting>
+</example>
+<simpara>The last line in is the reason why access to static members has to be restricted to direct access via the type name of the containing interfaces.</simpara>
+</section>
+</section>
+<section xml:id="_redefinition-of-members">
+<title>Redefinition of Members</title>
+<simpara>Members defined in classes or interfaces can be redefined by means of being overridden or implemented in subclasses, sub-interfaces, or implementing classes.
+Fields and methods with default implementation defined in interfaces can be consumed by the implementor, but certain restrictions apply.</simpara>
+<requirement xml:id="IDE-70">
+<title>Override Compatible</title>
+<simpara>
+<anchor xml:id="Req-IDE-70" xreflabel="[Req-IDE-70]"/>
+<emphasis role="strong">Requirement: IDE-70:</emphasis>
+<link linkend="Req-IDE-70">Override Compatible</link> (ver. 1)</simpara>
+    <simpara>
+
+A member <literal>M</literal> is <emphasis>override compatible</emphasis> to a member <literal>S</literal> if and only if the
+following constraints hold:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>The name and static modifiers are equal:<?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>M</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><mi>S</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>∧</mo><mi>M</mi><mo>.</mo><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>c</mi><mo>=</mo><mi>S</mi><mo>.</mo><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>c</mi></math></simpara>
+</listitem>
+<listitem>
+<simpara>The metatypes are compatible:</simpara>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>μ</mi><mfenced close=")" open="("><mi>S</mi></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>Method</mtext></mstyle><mspace width="3.0mm"/><mo>→</mo><mspace width="3.0mm"/><mi>μ</mi><mfenced close=")" open="("><mi>M</mi></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>Method</mtext></mstyle></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>μ</mi><mfenced close=")" open="("><mi>S</mi></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>Field</mtext></mstyle><mspace width="3.0mm"/><mo>→</mo><mspace width="3.0mm"/><mi>μ</mi><mfenced close=")" open="("><mi>M</mi></mfenced><mo>∈</mo><mstyle mathvariant="monospace"><mtext>Field, Getter, Setter</mtext></mstyle></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>μ</mi><mfenced close=")" open="("><mi>S</mi></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>Getter</mtext></mstyle><mspace width="3.0mm"/><mo>→</mo><mspace width="3.0mm"/><mi>μ</mi><mfenced close=")" open="("><mi>M</mi></mfenced><mo>∈</mo><mstyle mathvariant="monospace"><mtext>Field, Getter</mtext></mstyle></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>μ</mi><mfenced close=")" open="("><mi>S</mi></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>Setter</mtext></mstyle><mspace width="3.0mm"/><mo>→</mo><mspace width="3.0mm"/><mi>μ</mi><mfenced close=")" open="("><mi>M</mi></mfenced><mo>∈</mo><mstyle mathvariant="monospace"><mtext>Field, Setter</mtext></mstyle></math></simpara>
+</listitem>
+<listitem>
+<simpara>The overridden member must not be declared final:<?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mo>¬</mo><mi>S</mi><mo>.</mo><mi>f</mi><mi>i</mi><mi>n</mi><mi>a</mi><mi>l</mi></math></simpara>
+</listitem>
+<listitem>
+<simpara>Overridden member declared const can only be overridden (redefined) by const members:<?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>S</mi><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>s</mi><mi>t</mi><mo>⇔</mo><mi>M</mi><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>s</mi><mi>t</mi></math></simpara>
+</listitem>
+<listitem>
+<simpara>It is not possible to override a non-final / non-const field or a setter with a final / const field:<?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mfenced close=")" open="("><mrow><mi>μ</mi><mfenced close=")" open="("><mi>S</mi></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>Field</mtext></mstyle><mo>∧</mo><mo>¬</mo><mfenced close=")" open="("><mrow><mi>S</mi><mo>.</mo><mi>f</mi><mi>i</mi><mi>n</mi><mi>a</mi><mi>l</mi><mo>∨</mo><mi>S</mi><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>s</mi><mi>t</mi></mrow></mfenced></mrow></mfenced><mo>∨</mo><mi>μ</mi><mfenced close=")" open="("><mi>S</mi></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>Setter</mtext></mstyle><mo>⇒</mo><mo>¬</mo><mfenced close=")" open="("><mrow><mi>μ</mi><mfenced close=")" open="("><mi>M</mi></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>Field</mtext></mstyle><mo>∧</mo><mfenced close=")" open="("><mrow><mi>M</mi><mo>.</mo><mi>f</mi><mi>i</mi><mi>n</mi><mi>a</mi><mi>l</mi><mo>∨</mo><mi>M</mi><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>s</mi><mi>t</mi></mrow></mfenced></mrow></mfenced></math></simpara>
+</listitem>
+<listitem>
+<simpara>It is not possible to override a non-abstract member with an abstract one:<?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mo>¬</mo><mi>M</mi><mo>.</mo><mi>a</mi><mi>b</mi><mi>s</mi><mi>t</mi><mi>r</mi><mi>a</mi><mi>c</mi><mi>t</mi><mo>∨</mo><mi>S</mi><mo>.</mo><mi>a</mi><mi>b</mi><mi>s</mi><mi>t</mi><mi>r</mi><mi>a</mi><mi>c</mi><mi>t</mi></math></simpara>
+</listitem>
+<listitem>
+<simpara>The types are compatible:</simpara>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mfenced close=")" open="("><mrow><mi>μ</mi><mfenced close=")" open="("><mi>M</mi></mfenced><mo>∈</mo><mstyle mathvariant="monospace"><mtext>Method, Getter, Field</mtext></mstyle><mo>∧</mo><mi>μ</mi><mfenced close=")" open="("><mi>S</mi></mfenced><mo>≠</mo><mstyle mathvariant="monospace"><mtext>Setter</mtext></mstyle></mrow></mfenced><mspace width="3.0mm"/><mo>→</mo><mi>Γ</mi><mo>⊢</mo><mi>M</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>S</mi></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mfenced close=")" open="("><mrow><mi>μ</mi><mfenced close=")" open="("><mi>M</mi></mfenced><mo>∈</mo><mstyle mathvariant="monospace"><mtext>Setter, Field</mtext></mstyle><mo>∧</mo><mi>μ</mi><mfenced close=")" open="("><mi>S</mi></mfenced><mo>≠</mo><mstyle mathvariant="monospace"><mtext>Getter</mtext></mstyle><mo>∧</mo><mo>¬</mo><mi>S</mi><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>s</mi><mi>t</mi></mrow></mfenced><mspace width="3.0mm"/><mo>→</mo><mi>Γ</mi><mo>⊢</mo><mi>S</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>M</mi></math>4</simpara>
+</listitem>
+<listitem>
+<simpara>The access modifier is compatible:<?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>M</mi><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mo>≥</mo><mi>S</mi><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi></math></simpara>
+</listitem>
+</orderedlist>
+</requirement>
+<simpara>We define a relation <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>o</mi><mi>v</mi><mi>e</mi><mi>r</mi><mi>r</mi><mi>i</mi><mi>d</mi><mi>e</mi><mi>C</mi><mi>o</mi><mi>m</mi><mi>p</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>b</mi><mi>l</mi><mi>e</mi><mfenced close=")" open="("><mi>M</mi><mi>S</mi></mfenced></math> accordingly.</simpara>
+<simpara>Members overriding or implementing other members must be declared as override.
+If a member does not override another, however, it must not be declared as override.</simpara>
+<requirement xml:id="IDE-71">
+<title>Non-Override Declaration</title>
+<simpara>
+<anchor xml:id="Req-IDE-71" xreflabel="[Req-IDE-71]"/>
+<emphasis role="strong">Requirement: IDE-71:</emphasis>
+<link linkend="Req-IDE-71">Non-Override Declaration</link> (ver. 1)</simpara>
+    <simpara>
+
+If and only if a member <literal>M</literal> of a class <literal>C</literal> (extending a class <literal>S</literal> and interfaces <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>I</mi><mi>i</mi></msub></math>) does not override or implement another member, then it must not be declared as override.
+That is the following constraint must hold:</simpara>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mo>¬</mo><mi>M</mi><mo>.</mo><mi>o</mi><mi>v</mi><mi>e</mi><mi>r</mi><mi>r</mi><mi>i</mi><mi>d</mi><mi>e</mi></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mo>∧</mo></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mo>∄</mo><msup><mi>M</mi><mi>'</mi></msup><mo>∈</mo><mi>C</mi><mo>.</mo><mi>s</mi><mi>u</mi><mi>p</mi><mi>e</mi><mi>r</mi><mo>.</mo><mi>m</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi><mi>s</mi><mo>∪</mo><msubsup><mo>⋃</mo><mrow><mi>i</mi><mo>=</mo><mn>1</mn></mrow><mi>n</mi></msubsup><msub><mi>I</mi><mi>i</mi></msub><mo>.</mo><mi>m</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi><mi>s</mi><mi>:</mi></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><msup><mi>M</mi><mi>'</mi></msup><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><mi>M</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>∧</mo><msup><mi>M</mi><mi>'</mi></msup><mo>.</mo><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>c</mi><mo>=</mo><mi>M</mi><mo>.</mo><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>c</mi></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mo>∧</mo><msup><mi>M</mi><mi>'</mi></msup><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mo>&gt;</mo><mstyle mathvariant="monospace"><mtext>private</mtext></mstyle></math></simpara>
+</requirement>
+<section xml:id="_overriding-of-members" role="language-n4js">
+<title>Overriding of Members</title>
+<simpara>In general, the N4JS platform supports overriding members by redefining them in sub-classes.
+This definition allows for overriding of static methods, but it does not apply to constructors because <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>C</mi><mo>.</mo><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi><mo>∉</mo><mi>C</mi><mo>.</mo><mi>o</mi><mi>w</mi><mi>n</mi><mi>e</mi><mi>d</mi><mi>M</mi><mi>e</mi><mi>t</mi><mi>h</mi><mi>o</mi><mi>d</mi><mi>s</mi></math>.</simpara>
+<requirement xml:id="IDE-72">
+<title>Overriding Members</title>
+<simpara>
+<anchor xml:id="Req-IDE-72" xreflabel="[Req-IDE-72]"/>
+<emphasis role="strong">Requirement: IDE-72:</emphasis>
+<link linkend="Req-IDE-72">Overriding Members</link> (ver. 1)</simpara>
+    <simpara>
+
+Given a class <literal>C</literal> and a superclass <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>S</mi><mi>u</mi><mi>p</mi></math>.
+If for an instance or static member <literal>M</literal> defined in <literal>C</literal> a member <literal>S</literal> exists with null
+then we call <literal>M</literal> the overriding member and <literal>S</literal> the overridden member.
+In that case the following constraints must hold:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara><literal>S</literal> must be accessible from <literal>C</literal></simpara>
+</listitem>
+<listitem>
+<simpara><literal>M</literal> must be override compatible with <literal>S</literal>:<?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>o</mi><mi>v</mi><mi>e</mi><mi>r</mi><mi>r</mi><mi>i</mi><mi>d</mi><mi>e</mi><mi>C</mi><mi>o</mi><mi>m</mi><mi>p</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>b</mi><mi>l</mi><mi>e</mi><mfenced close=")" open="("><mi>M</mi><mi>S</mi></mfenced></math></simpara>
+</listitem>
+<listitem>
+<simpara>If <literal>S</literal> is a field and <literal>M</literal> is an accessor, then an additional accessor <math xmlns="http://www.w3.org/1998/Math/MathML"><msup><mi>M</mi><mi>'</mi></msup></math> must exists so that <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>M</mi><mo>,</mo><msup><mi>M</mi><mi>'</mi></msup></math> are an accessor pair for <literal>S</literal>:</simpara>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mi>μ</mi><mfenced close=")" open="("><mi>S</mi></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>Field</mtext></mstyle><mo>∧</mo><mi>μ</mi><mfenced close=")" open="("><mi>M</mi></mfenced><mo>=</mo><mrow><mi>A</mi><mi>c</mi><mi>c</mi><mi>e</mi><mi>s</mi><mi>s</mi><mi>o</mi><mi>r</mi></mrow></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mo>→</mo><mo>∃</mo><msup><mi>M</mi><mi>'</mi></msup><mo>∈</mo><mi>C</mi><mo>.</mo><mi>m</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi><mi>:</mi></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mspace width="4.0em"/><mi>o</mi><mi>v</mi><mi>e</mi><mi>r</mi><mi>r</mi><mi>i</mi><mi>d</mi><mi>e</mi><mi>C</mi><mi>o</mi><mi>m</mi><mi>p</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>b</mi><mi>l</mi><mi>e</mi><mfenced close=")" open="("><msup><mi>M</mi><mi>'</mi></msup><mi>S</mi></mfenced><mo>∧</mo><mfenced close="}" open="{"><mrow><mi>μ</mi><mfenced close=")" open="("><mi>M</mi></mfenced></mrow><mrow><mi>μ</mi><mfenced close=")" open="("><msup><mi>M</mi><mi>'</mi></msup></mfenced></mrow></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>Getter,Setter</mtext></mstyle></math></simpara>
+</listitem>
+<listitem>
+<simpara><literal>M</literal> must be declared as override:<?asciidoc-br?>
+<literal>M.override</literal></simpara>
+</listitem>
+</orderedlist>
+</requirement>
+<simpara>Remarks:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>An overridden method, getter, or setter may called via <literal>super</literal>.
+Note that this is not possible for fields.</simpara>
+</listitem>
+<listitem>
+<simpara>There is no ’hiding’ of fields as in Java, instead there is field overriding.</simpara>
+</listitem>
+<listitem>
+<simpara>It is not possible to override a field with a consumed getter and an overridden setter, because the getter is not consumed if there exists a field in a superclass.
+In this case, the consuming and extending class needs to define the accessor pair explicitly.
+The same is true for other combination of accessors and fields.</simpara>
+</listitem>
+<listitem>
+<simpara>Overriding a field usually makes only sense if the visibility of the field is to be increased.</simpara>
+</listitem>
+</itemizedlist>
+</section>
+<section xml:id="_implementation-of-members">
+<title>Implementation of Members</title>
+<definition>
+<title>Interface and Class Member Sets</title>
+<simpara>
+<anchor xml:id="interface_and_class_member_sets" xreflabel="[interface_and_class_member_sets]"/>
+<emphasis role="strong">Definition:</emphasis>
+<link linkend="interface_and_class_member_sets">Interface and Class Member Sets</link></simpara>
+<simpara>
+
+For the following constraints, we define two helper sets <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>M</mi><mi>C</mi></msub></math> and <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>M</mi><mi>I</mi></msub></math> as follows:</simpara>
+<simpara>Given a <literal>C</literal>, and interface <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>I</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>I</mi><mi>n</mi></msub></math>, implemented by <literal>C</literal>, with</simpara>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>M</mi><mi>C</mi></msub><mspace width="3.0mm"/><mo>=</mo><mi>C</mi><mo>.</mo><mi>o</mi><mi>w</mi><mi>n</mi><mi>e</mi><mi>d</mi><mi>M</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi><mi>s</mi><mo>∪</mo><mrow><mo>{</mo><mrow><mi>m</mi><mo>∈</mo><mi>C</mi><mo>.</mo><mi>s</mi><mi>u</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi><mo>.</mo><mi>m</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi><mi>s</mi><mo>|</mo><mi>m</mi><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mo>&gt;</mo><mstyle mathvariant="monospace"><mtext>private</mtext></mstyle><mo>}</mo></mrow></mrow></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>M</mi><mi>I</mi></msub><mspace width="3.0mm"/><mo>=</mo><msubsup><mo>⋃</mo><mrow><mi>i</mi><mo>=</mo><mn>1</mn></mrow><mi>n</mi></msubsup><msub><mi>I</mi><mi>i</mi></msub><mo>.</mo><mi>m</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi><mi>s</mi></math></simpara>
+<simpara>Note that these sets already contain only non-private data fields.</simpara>
+</definition>
+<section xml:id="_member-consumption">
+<title>Member Consumption</title>
+<definition>
+<title>Member Consumption and Implementation</title>
+<simpara>
+<anchor xml:id="member_consumption_and_implementation" xreflabel="[member_consumption_and_implementation]"/>
+<emphasis role="strong">Definition:</emphasis>
+<link linkend="member_consumption_and_implementation">Member Consumption and Implementation</link></simpara>
+<simpara>
+
+A member <literal>M</literal> defined in an interface <literal>I</literal> is <emphasis>consumed</emphasis> by an implementor <literal>C</literal>, if it becomes a member of the class, that is, <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>M</mi><mo>∈</mo><mi>C</mi><mo>.</mo><mi>m</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi><mi>s</mi></math>.</simpara>
+<simpara>A member <literal>M</literal> is consumed if there is no member defined in the implementor with the same name and if there is no non-private,
+non-abstract member with that name inherited by the implementor from its superclass. <footnote><simpara>There had been the idea of preventing static members of being consumed. However, this would break the type subtype relation.</simpara></footnote></simpara>
+<simpara>If the implementor defines the member itself, then the member is implemented rather than consumed.</simpara>
+<simpara>The concrete rules are described in the following;</simpara>
+<simpara>It is not always possible to directly consume a member.
+In general, a rather conservative strategy is used: if two implemented interfaces define the same (non-abstract) member then the implementor must redefine the member in order to solve conflicts.
+Even if the two conflicting members have the same types, the implementor must redefine them as we generally assume semantic differences which the consumer has to be aware of.
+Data fields defined in interfaces, in particular, are assumed to be concrete.
+It is not, therefore, possible to consume a field defined in two implemented interfaces.</simpara>
+</definition>
+<requirement xml:id="IDE-73">
+<title>Consumption of Interface Members</title>
+<simpara>
+<anchor xml:id="Req-IDE-73" xreflabel="[Req-IDE-73]"/>
+<emphasis role="strong">Requirement: IDE-73:</emphasis>
+<link linkend="Req-IDE-73">Consumption of Interface Members</link> (ver. 1)</simpara>
+    <simpara>
+
+Given a classifier <literal>C</literal> <footnote><simpara><literal>C</literal> could either be a class or an interface.</simpara></footnote>, and interfaces <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>I</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>I</mi><mi>n</mi></msub></math> implemented (or extended) by <literal>C</literal>, and sets <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>M</mi><mi>C</mi></msub></math> and <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>M</mi><mi>I</mi></msub></math> as defined in <xref linkend="interface_and_class_member_sets"/>.
+A non-static member <literal>M</literal> defined in any interface <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>I</mi><mi>i</mi></msub></math> is merged into the consumer (<literal>C</literal>), if for all other (possible) members <math xmlns="http://www.w3.org/1998/Math/MathML"><msup><mi>M</mi><mi>'</mi></msup></math> of <literal>C</literal></simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mo>∀</mo><msup><mi>M</mi><mi>'</mi></msup><mo>∈</mo><msub><mi>M</mi><mi>C</mi></msub><mo>∪</mo><msub><mi>M</mi><mi>I</mi></msub><mo>∖</mo><mfenced close="}" open="{"><mi>M</mi></mfenced><mi>:</mi><mi>M</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><msup><mi>M</mi><mi>'</mi></msup><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>∧</mo><mo>¬</mo><msup><mi>M</mi><mi>'</mi></msup><mo>.</mo><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>c</mi></math>
+<simpara>the following constraints hold:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>The other member’s meta type matches the meta type of the merge candiate:</simpara>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>μ</mi><mfenced close=")" open="("><mi>M</mi></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>Method</mtext></mstyle><mspace width="3.0mm"/><mo>→</mo><mi>μ</mi><mfenced close=")" open="("><msup><mi>M</mi><mi>'</mi></msup></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>Method</mtext></mstyle></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>μ</mi><mfenced close=")" open="("><mi>M</mi></mfenced><mo>≠</mo><mstyle mathvariant="monospace"><mtext>Method</mtext></mstyle><mspace width="3.0mm"/><mo>→</mo><mi>μ</mi><mfenced close=")" open="("><msup><mi>M</mi><mi>'</mi></msup></mfenced><mo>∈</mo><mstyle mathvariant="monospace"><mtext>Field, FieldAccessor</mtext></mstyle></math></simpara>
+</listitem>
+<listitem>
+<simpara>The other member is abstract and not owned by the consumer:</simpara>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mi>μ</mi><mfenced close=")" open="("><mi>M</mi></mfenced><mo>=</mo><mi>μ</mi><mfenced close=")" open="("><msup><mi>M</mi><mi>'</mi></msup></mfenced><mo>∨</mo><mi>μ</mi><mfenced close=")" open="("><mi>M</mi></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>Field</mtext></mstyle></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mspace width="2.0em"/><mo>→</mo><msup><mi>M</mi><mi>'</mi></msup><mo>.</mo><mi>a</mi><mi>b</mi><mi>s</mi><mi>t</mi><mi>r</mi><mi>a</mi><mi>c</mi><mi>t</mi><mo>∧</mo><msup><mi>M</mi><mi>'</mi></msup><mo>∉</mo><mi>C</mi><mo>.</mo><mi>o</mi><mi>w</mi><mi>n</mi><mi>e</mi><mi>d</mi><mi>M</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi><mi>s</mi></math></simpara>
+</listitem>
+<listitem>
+<simpara>The merge candidate’s access modifier is not less than the modifier of the other member:</simpara>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mi>μ</mi><mfenced close=")" open="("><mi>M</mi></mfenced><mo>=</mo><mi>μ</mi><mfenced close=")" open="("><msup><mi>M</mi><mi>'</mi></msup></mfenced><mo>∨</mo><mi>μ</mi><mfenced close=")" open="("><mi>M</mi></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>Field</mtext></mstyle></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mspace width="2.0em"/><mo>→</mo><mi>M</mi><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mo>≥</mo><msup><mi>M</mi><mi>'</mi></msup><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi></math></simpara>
+</listitem>
+<listitem>
+<simpara>The merge candidate’s type compatible with the other member:</simpara>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>μ</mi><mfenced close=")" open="("><mi>M</mi></mfenced><mo>∈</mo><mfenced close="}" open="{"><mstyle mathvariant="monospace"><mtext>Method, Getter, Field</mtext></mstyle></mfenced><mo>∧</mo><mi>μ</mi><mfenced close=")" open="("><msup><mi>M</mi><mi>'</mi></msup></mfenced><mo>≠</mo><mstyle mathvariant="monospace"><mtext>Setter</mtext></mstyle><mspace width="3.0mm"/><mo>→</mo><mi>Γ</mi><mo>⊢</mo><mi>M</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><msup><mi>M</mi><mi>'</mi></msup></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>μ</mi><mfenced close=")" open="("><mi>M</mi></mfenced><mo>∈</mo><mfenced close="}" open="{"><mstyle mathvariant="monospace"><mtext>Setter, Field</mtext></mstyle></mfenced><mo>∧</mo><mi>μ</mi><mfenced close=")" open="("><msup><mi>M</mi><mi>'</mi></msup></mfenced><mo>≠</mo><mstyle mathvariant="monospace"><mtext>Getter</mtext></mstyle><mspace width="3.0mm"/><mo>→</mo><mi>Γ</mi><mo>⊢</mo><msup><mi>M</mi><mi>'</mi></msup><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>M</mi></math></simpara>
+</listitem>
+</orderedlist>
+</requirement>
+</section>
+<section xml:id="_member-implementation" role="language-n4js">
+<title>Member Implementation</title>
+<requirement xml:id="IDE-74">
+<title>Implementation of Interface Members</title>
+<simpara>
+<anchor xml:id="Req-IDE-74" xreflabel="[Req-IDE-74]"/>
+<emphasis role="strong">Requirement: IDE-74:</emphasis>
+<link linkend="Req-IDE-74">Implementation of Interface Members</link> (ver. 1)</simpara>
+    <simpara>
+
+For any non-static abstract member <literal>M</literal> defined in an interface <literal>I implemented (or extended) by a classifier `C</literal>, <literal>M</literal> must be accessible
+from <literal>C</literal> and one or two member(s) in <literal>C</literal> must exist which are implementation-compatible with <literal>M</literal>.
+The implementing member(s) must be declared as override if they are directly defined in the consumer.</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara><literal>M</literal> must be accessible from <literal>C</literal>.</simpara>
+</listitem>
+<listitem>
+<simpara>An implementation-compatible member <math xmlns="http://www.w3.org/1998/Math/MathML"><msup><mi>M</mi><mi>'</mi></msup></math> must exist in <literal>C</literal>:</simpara>
+<orderedlist numeration="loweralpha">
+<listitem>
+<simpara>if <literal>M</literal> is not a field:</simpara>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>μ</mi><mfenced close=")" open="("><mi>M</mi></mfenced><mo>≠</mo><mstyle mathvariant="monospace"><mtext>Field</mtext></mstyle><mspace width="3.0mm"/><mo>→</mo></math><?asciidoc-br?>
+            <math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mo>∃</mo><msup><mi>M</mi><mi>'</mi></msup><mo>∈</mo><mi>C</mi><mo>.</mo><mi>m</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi><mi>s</mi><mi>:</mi></math><?asciidoc-br?>
+            <math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mspace width="3.0em"/><mi>o</mi><mi>v</mi><mi>e</mi><mi>r</mi><mi>r</mi><mi>i</mi><mi>d</mi><mi>e</mi><mi>C</mi><mi>o</mi><mi>m</mi><mi>p</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>b</mi><mi>l</mi><mi>e</mi><mfenced close=")" open="("><msup><mi>M</mi><mi>'</mi></msup><mi>M</mi></mfenced></math><?asciidoc-br?>
+            <math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mspace width="3.0em"/><mo>∧</mo><mfenced close=")" open="("><mrow><msup><mi>M</mi><mi>'</mi></msup><mo>∈</mo><mi>C</mi><mo>.</mo><mi>o</mi><mi>w</mi><mi>n</mi><mi>e</mi><mi>d</mi><mi>M</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi><mi>s</mi><mo>→</mo><msup><mi>M</mi><mi>'</mi></msup><mo>.</mo><mi>o</mi><mi>v</mi><mi>e</mi><mi>r</mi><mi>r</mi><mi>i</mi><mi>d</mi><mi>e</mi></mrow></mfenced></math></simpara>
+</listitem>
+<listitem>
+<simpara>if <literal>M</literal> is a field, then either an
+implementation-compatible field <math xmlns="http://www.w3.org/1998/Math/MathML"><msup><mi>F</mi><mi>'</mi></msup></math> or accessor pair <math xmlns="http://www.w3.org/1998/Math/MathML"><msup><mi>G</mi><mi>'</mi></msup><mo>,</mo><msup><mi>S</mi><mi>'</mi></msup></math> must exist:</simpara>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>μ</mi><mfenced close=")" open="("><mi>M</mi></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>Field</mtext></mstyle><mspace width="3.0mm"/><mo>→</mo></math><?asciidoc-br?>
+                        <math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mo>∃</mo><msup><mi>F</mi><mi>'</mi></msup><mo>∈</mo><mi>C</mi><mo>.</mo><mi>f</mi><mi>i</mi><mi>e</mi><mi>l</mi><mi>d</mi><mi>s</mi><mi>:</mi></math><?asciidoc-br?>
+                            <math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mspace width="3.0em"/><mi>o</mi><mi>v</mi><mi>e</mi><mi>r</mi><mi>r</mi><mi>i</mi><mi>d</mi><mi>e</mi><mi>C</mi><mi>o</mi><mi>m</mi><mi>p</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>b</mi><mi>l</mi><mi>e</mi><mfenced close=")" open="("><msup><mi>F</mi><mi>'</mi></msup><mi>M</mi></mfenced></math><?asciidoc-br?>
+                            <math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mspace width="3.0em"/><mo>∧</mo><mfenced close=")" open="("><mrow><msup><mi>F</mi><mi>'</mi></msup><mo>∈</mo><mi>C</mi><mo>.</mo><mi>o</mi><mi>w</mi><mi>n</mi><mi>e</mi><mi>d</mi><mi>M</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi><mi>s</mi><mo>→</mo><msup><mi>F</mi><mi>'</mi></msup><mo>.</mo><mi>o</mi><mi>v</mi><mi>e</mi><mi>r</mi><mi>r</mi><mi>i</mi><mi>d</mi><mi>e</mi></mrow></mfenced></math><?asciidoc-br?>
+                        <math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mo>∨</mo></math><?asciidoc-br?>
+                        <math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mo>∃</mo><msup><mi>G</mi><mi>'</mi></msup><mo>∈</mo><mi>C</mi><mo>.</mo><mi>g</mi><mi>e</mi><mi>t</mi><mi>t</mi><mi>e</mi><mi>r</mi><mi>s</mi><mo>,</mo><msup><mi>S</mi><mi>'</mi></msup><mo>∈</mo><mi>C</mi><mo>.</mo><mi>s</mi><mi>e</mi><mi>t</mi><mi>t</mi><mi>e</mi><mi>r</mi><mi>s</mi><mi>:</mi></math><?asciidoc-br?>
+                            <math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mspace width="3.0em"/><mi>o</mi><mi>v</mi><mi>e</mi><mi>r</mi><mi>r</mi><mi>i</mi><mi>d</mi><mi>e</mi><mi>C</mi><mi>o</mi><mi>m</mi><mi>p</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>b</mi><mi>l</mi><mi>e</mi><mfenced close=")" open="("><msup><mi>G</mi><mi>'</mi></msup><mi>M</mi></mfenced></math><?asciidoc-br?>
+                            <math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mspace width="3.0em"/><mo>∧</mo><mi>o</mi><mi>v</mi><mi>e</mi><mi>r</mi><mi>r</mi><mi>i</mi><mi>d</mi><mi>e</mi><mi>C</mi><mi>o</mi><mi>m</mi><mi>p</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>b</mi><mi>l</mi><mi>e</mi><mfenced close=")" open="("><msup><mi>S</mi><mi>'</mi></msup><mi>M</mi></mfenced></math><?asciidoc-br?>
+                            <math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mspace width="3.0em"/><mo>∧</mo><mfenced close=")" open="("><mrow><msup><mi>G</mi><mi>'</mi></msup><mo>∈</mo><mi>C</mi><mo>.</mo><mi>o</mi><mi>w</mi><mi>n</mi><mi>e</mi><mi>d</mi><mi>M</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi><mi>s</mi><mo>→</mo><msup><mi>G</mi><mi>'</mi></msup><mo>.</mo><mi>o</mi><mi>v</mi><mi>e</mi><mi>r</mi><mi>r</mi><mi>i</mi><mi>d</mi><mi>e</mi></mrow></mfenced></math><?asciidoc-br?>
+                            <math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mspace width="3.0em"/><mo>∧</mo><mfenced close=")" open="("><mrow><msup><mi>S</mi><mi>'</mi></msup><mo>∈</mo><mi>C</mi><mo>.</mo><mi>o</mi><mi>w</mi><mi>n</mi><mi>e</mi><mi>d</mi><mi>M</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi><mi>s</mi><mo>→</mo><msup><mi>S</mi><mi>'</mi></msup><mo>.</mo><mi>o</mi><mi>v</mi><mi>e</mi><mi>r</mi><mi>r</mi><mi>i</mi><mi>d</mi><mi>e</mi></mrow></mfenced></math></simpara>
+</listitem>
+</orderedlist>
+</listitem>
+</orderedlist>
+</requirement>
+<simpara>Methods defined in interfaces are automatically declared abstract if they do not provide a default implementation.
+This can also be expressed explicitly via adding the <literal>abstract</literal> modifier.
+If a class implementing an abstract interface does not implement a method declared in the interface, the class needs to be declared abstract (cf. <xref linkend="_abstract-classes"/>).</simpara>
+<simpara>Consequences for method implementation:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>It may be require the implementor to explicitly define a method in order to solve type conflicts produced by methods of different interfaces with same name but different signatures.</simpara>
+</listitem>
+<listitem>
+<simpara>Methods in an implementor cannot decrease the accessibility of methods from implemented interfaces, that is</simpara>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mo>∀</mo><mi>M</mi><mo>∈</mo><mi>C</mi><mo>.</mo><mi>m</mi><mi>e</mi><mi>t</mi><mi>h</mi><mi>o</mi><mi>d</mi><mi>s</mi><mo>,</mo><msup><mi>M</mi><mi>'</mi></msup><mo>∈</mo><msub><mi>I</mi><mi>i</mi></msub><mo>.</mo><mi>m</mi><mi>e</mi><mi>t</mi><mi>h</mi><mi>o</mi><mi>d</mi><mi>s</mi><mfenced close=")" open="("><mrow><mi>i</mi><mo>=</mo><mn>1</mn><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mi>n</mi></mrow></mfenced><mi>:</mi></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mspace width="2.0em"/><mi>M</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><msup><mi>M</mi><mi>'</mi></msup><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>→</mo><mi>M</mi><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mo>≠</mo><mi>p</mi><mi>r</mi><mi>i</mi><mi>v</mi><mi>a</mi><mi>t</mi><mi>e</mi><mo>⇒</mo><mi>M</mi><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mo>≥</mo><msup><mi>M</mi><mi>'</mi></msup><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi></math></simpara>
+</listitem>
+<listitem>
+<simpara>Methods in the implementor must be a supertype <footnote><simpara>As defined in <xref linkend="_function-type"/> for function types.</simpara></footnote> of methods from implemented interfaces.
+That is to say the implemented methods are override-compatible.</simpara>
+</listitem>
+<listitem>
+<simpara>There may be several methods <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>M</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>M</mi><mi>n</mi></msub></math> defined in different implemented interfaces and a single owned method <math xmlns="http://www.w3.org/1998/Math/MathML"><msup><mi>M</mi><mi>'</mi></msup></math> in <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>M</mi><mi>C</mi></msub></math>.
+In this case, the above constraints must hold for <emphasis>all</emphasis> methods. In particular, <math xmlns="http://www.w3.org/1998/Math/MathML"><msup><mi>M</mi><mi>'</mi></msup></math>’s signature must conform to all conflicting methods’ signatures.
+This is possible by using union types for the arguments and an intersection type as return type.
+Such a method <math xmlns="http://www.w3.org/1998/Math/MathML"><msup><mi>M</mi><mi>'</mi></msup></math> is said to <emphasis>resolve</emphasis> the conflict between the implemented (and also inherited) methods.</simpara>
+</listitem>
+<listitem>
+<simpara>Since abstracts methods may become part of the implementor methods, the implementor must either define these methods or it must be declared abstract itself.
+Since interfaces are abstract by default, responsibility for implementing abstract methods is passed on to any implementor of interfaces.</simpara>
+</listitem>
+<listitem>
+<simpara>If two implemented interfaces provide (non-abstract) members with the same name, they are not automatically consumed by the implementor even if the types would be similar.
+In these cases, the implementor has to redefine the members in order to be aware of possible semantic differences.</simpara>
+</listitem>
+</orderedlist>
+<simpara>There is currently no separate annotation to indicate that methods are implemented or overridden in order to solve conflicts.
+We always use the <literal>@Override</literal> annotation.</simpara>
+<example>
+<title>Method Consumption</title>
+<simpara><xref linkend="tab:methodConsumption"/> shows simple examples of above rules.
+Assuming that <literal>class C</literal> extends super <literal>class S</literal> and implements interface <literal>I1</literal> and <literal>I2</literal>:</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">class C extends S implements I1, I2 {...}</programlisting>
+</example>
+<simpara>The columns describe different scenarios in which a method (with same name) is defined in different classifiers.
+We assume that the defined methods are always non-abstract (i.e. have default implementations), non-private and have the same signature.
+The last row shows which method will be actually used in class <literal>C</literal>.
+If the method is defined in class <literal>C</literal>, and if this method is printed bold, then this means that the method is required to be defined in <literal>C</literal> in order to solve conflicts.</simpara>
+<table xml:id="tab:methodConsumption" frame="all" rowsep="1" colsep="1">
+<title>Consumption of methods</title>
+<tgroup cols="7">
+<colspec colname="col_1" colwidth="25*"/>
+<colspec colname="col_2" colwidth="12.5*"/>
+<colspec colname="col_3" colwidth="12.5*"/>
+<colspec colname="col_4" colwidth="12.5*"/>
+<colspec colname="col_5" colwidth="12.5*"/>
+<colspec colname="col_6" colwidth="12.5*"/>
+<colspec colname="col_7" colwidth="12.5*"/>
+<tbody>
+<row>
+<entry align="left" valign="top"><simpara><emphasis role="strong">Interface <literal>I1</literal></emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><emphasis>M<subscript>I1</subscript></emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><emphasis>M<subscript>I1</subscript></emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><emphasis>M<subscript>I1</subscript></emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><emphasis>M<subscript>I1</subscript></emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><emphasis>M<subscript>I1</subscript></emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><emphasis>M<subscript>I1</subscript></emphasis></simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><emphasis role="strong">Interface <literal>I2</literal></emphasis></simpara></entry>
+<entry align="center" valign="top"></entry>
+<entry align="center" valign="top"></entry>
+<entry align="center" valign="top"><simpara><emphasis>M<subscript>I2</subscript></emphasis></simpara></entry>
+<entry align="center" valign="top"></entry>
+<entry align="center" valign="top"><simpara><emphasis>M<subscript>I2</subscript></emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><emphasis>M<subscript>I2</subscript></emphasis></simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><emphasis role="strong">class <literal>S</literal></emphasis></simpara></entry>
+<entry align="center" valign="top"></entry>
+<entry align="center" valign="top"></entry>
+<entry align="center" valign="top"></entry>
+<entry align="center" valign="top"><simpara><emphasis>M<subscript>S</subscript></emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><emphasis>M<subscript>S</subscript></emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><emphasis>M<subscript>S</subscript></emphasis></simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><emphasis role="strong">class <literal>C</literal></emphasis></simpara></entry>
+<entry align="center" valign="top"></entry>
+<entry align="center" valign="top"><simpara><emphasis>M<subscript>C</subscript></emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><emphasis role="strong">M<subscript>C</subscript></emphasis></simpara></entry>
+<entry align="center" valign="top"></entry>
+<entry align="center" valign="top"></entry>
+<entry align="center" valign="top"><simpara><emphasis>M<subscript>C</subscript></emphasis></simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><emphasis role="strong"><math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∈</mo><mi>C</mi><mo>.</mo><mi>m</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi><mi>s</mi></math></emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><emphasis>M<subscript>I1</subscript></emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><emphasis>M<subscript>C</subscript></emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><emphasis>M<subscript>C</subscript></emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><emphasis>M<subscript>S</subscript></emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><emphasis>M<subscript>S</subscript></emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><emphasis>M<subscript>C</subscript></emphasis></simpara></entry>
+</row>
+</tbody>
+</tgroup>
+</table>
+<variablelist xml:id="consuming-field-initializers">
+<varlistentry>
+<term>Consuming Field Initializers </term>
+<listitem>
+<simpara>Aside from the fields themselves, an implementor <emphasis>always</emphasis> consumes the field initialization if the field is consumed – this is how the consumption is noticed at runtime.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+<example>
+<title>Field and Field Initializer Consumption</title>
+<programlisting language="n4js" linenumbering="unnumbered">/* XPECT  output ~~~
+&lt;==
+stdout:
+s: C , t: D ,u: I1 ,v: I2
+stderr:
+==&gt;
+~~~ */
+
+interface I0 {
+    v: string = "I0";
+}
+
+interface I1 {
+    s: string = "I1";
+    t: string = "I1";
+    u: string = "I1";
+}
+
+interface I2 extends I1, I0 {
+    @Override
+    t: string = "I2";
+    @Override
+    v: string = "I2";
+}
+
+class C {
+    s: string = "C";
+}
+
+class D extends C implements I1, I2 {
+    @Override
+    t: string = "D";
+}
+
+var d = new D();
+
+console.log(
+    "s:", d.s, ", t:", d.t, ",u:", d.u, ",v:", d.v
+)</programlisting>
+<simpara>We expect the following output (for each field):</simpara>
+<itemizedlist>
+<listitem>
+<simpara><literal>d.s = "C"</literal> : <literal>s</literal>: is inherited from <literal>C</literal>, so it is not consumed from <literal>I1</literal> (or <literal>I2</literal>).
+Consequently, the initializer of <literal>s</literal> in <literal>C</literal> is used.</simpara>
+</listitem>
+<listitem>
+<simpara><literal>d.t = "D"</literal>: <literal>t</literal> is defined in <literal>D</literal>, solving a conflict stemming from the definition of <literal>t</literal> in <literal>I1</literal> and <literal>I2</literal>. Thus, the initializer of <literal>t</literal> in <literal>D</literal> is used.</simpara>
+</listitem>
+<listitem>
+<simpara><literal>d.u = "I1"</literal> : <literal>u</literal> is only defined in <literal>I1</literal>, thus the initializer defined in <literal>I1</literal> is used.</simpara>
+</listitem>
+<listitem>
+<simpara><literal>d.v = "I2"</literal> : <literal>v</literal> is overridden in <literal>I2</literal>, so is the field initializer. This is why <literal>d.v</literal> must be assigned to <literal>I2</literal> and not <literal>I0</literal>.</simpara>
+</listitem>
+</itemizedlist>
+</example>
+</section>
+</section>
+</section>
+</section>
+<section xml:id="_structural-typing">
+<title>Structural Typing</title>
+<simpara>In general, N4JS uses nominal typing.
+This is to say that a duck is a duck only if it is declared to be a duck.
+In particular when working with external APIs, it is more convenient to use structural or duck typing.
+That is, a thing that can swim and quacks like a duck, is a duck.</simpara>
+<simpara role="language-n4js">Interfaces or classes can be used for this purpose with a <emphasis>typing strategy modifier</emphasis>.
+Given a type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi></math>, the simple <literal>~</literal> (tilde) can be added to its declaration (on definition-site) or in a reference (on use-site) to indicate that the type system should use structural typing
+rather than nominal typing.<footnote><simpara>This kind of typing is used by TypeScript only. By defining a structural typed classifier or reference, it basically behaves as it would behave – without that modifier – in TypeScript.</simpara></footnote>
+This means that some other type must provide the same members as type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi></math> to be deemed a structural subtype.
+However, the operator cannot be used anymore with the type or reference as this operator relies on the declaration information (or at least the closest thing available at runtime).
+In this case, <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi></math> is, therefore, always a structural subtype of <emphasis>~T</emphasis>.</simpara>
+<simpara role="language-n4js">Sometimes it is convenient to refer only to the fields of a classifier, for example when the initial field values are to be provided in a variable passed to the constructor.
+In that case, the type can be modified with <literal>~~</literal> (two tildes). This is only possible on use-site, i.e. on type references.
+Furthermore, only on the use-site, it is possible to consider only either readable or writable or fields by using the read-only <literal>~r~</literal> or write-only <literal>~w~</literal> structural field typing.
+For initialization blocks, it is even possible to use structural initializer field typing via the <literal>~i~</literal> operator.</simpara>
+<section xml:id="_syntax-7" role="language-n4js">
+<title>Syntax</title>
+<simpara>Structural typing is specified using the typing strategy modifier. There
+are two modifiers defined; one for definition-site and one for use-site
+structural typing.</simpara>
+<formalpara xml:id="lst:Structural_Type_Operator_and_References">
+<title>Structural Type Operator and References</title>
+<para>
+<programlisting language="xtext" linenumbering="unnumbered">TypingStrategyUseSiteOperator returns TypingStrategy:
+    '~' ('~' | STRUCTMODSUFFIX)?;
+
+TypingStrategyDefSiteOperator returns TypingStrategy:
+    '~';
+
+terminal STRUCTMODSUFFIX:
+    ('r' | 'i' | 'w') '~'
+;
+
+ParameterizedTypeRefStructural returns ParameterizedTypeRefStructural:
+    definedTypingStrategy=TypingStrategyUseSiteOperator
+    declaredType=[Type|TypeReferenceName]
+    (=&gt; '&lt;' typeArgs+=TypeArgument (',' typeArgs+=TypeArgument)* '&gt;')?
+    (=&gt; 'with' '{' astStructuralMembers+=TStructMember* '}')?
+;
+
+ThisTypeRefStructural returns ThisTypeRefStructural:
+    definedTypingStrategy=TypingStrategyUseSiteOperator
+    'this'
+    ('with' '{' astStructuralMembers+=TStructMember* '}')?
+;</programlisting>
+</para>
+</formalpara>
+</section>
+<section xml:id="_definition-site-structural-typing" role="language-n4js">
+<title>Definition Site Structural Typing</title>
+<simpara>An interface or class can be defined to be used with structural typing by adding the structural modifier to its definition (or, in case of external classes, to the declaration).
+This changes the default type system strategy from nominal to structural typing for that type.
+That means that all types with the same members as the specified type are subtypes of that type, except for subtypes of <literal>N4Object</literal>.
+In the latter case, programmers are enforced to nominal declare the type relation.</simpara>
+<simpara>If a type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi></math> is declared as structural at its definition, <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi><mo>.</mo><mi>d</mi><mi>e</mi><mi>f</mi><mi>S</mi><mi>t</mi><mi>r</mi><mi>u</mi><mi>c</mi><mi>t</mi><mi>u</mi><mi>r</mi><mi>a</mi><mi>l</mi></math> is true.</simpara>
+<requirement xml:id="IDE-75">
+<title>Definition Site Structural Typing</title>
+<simpara>
+<anchor xml:id="Req-IDE-75" xreflabel="[Req-IDE-75]"/>
+<emphasis role="strong">Requirement: IDE-75:</emphasis>
+<link linkend="Req-IDE-75">Definition Site Structural Typing</link> (ver. 1)</simpara>
+    <simpara>
+</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>The structurally defined type cannot be used on the right hand side of the <literal>instanceof</literal> operator:
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>x</mi><mi> </mi><mstyle mathvariant="monospace"><mtext>instanceof</mtext></mstyle><mi> </mi><mi>T</mi><mo>⇒</mo><mo>¬</mo><mi>T</mi><mo>.</mo><mi>d</mi><mi>e</mi><mi>f</mi><mi>S</mi><mi>t</mi><mi>r</mi><mi>u</mi><mi>c</mi><mi>t</mi><mi>u</mi><mi>r</mi><mi>a</mi><mi>l</mi></math></simpara>
+</listitem>
+<listitem>
+<simpara>A type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>X</mi></math> is a subtype of a structurally defined type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi></math> either</simpara>
+<orderedlist numeration="loweralpha">
+<listitem>
+<simpara>if it is not a subtype of <literal>N4Object</literal> <footnote><simpara>We enforce programmers of N4JS to use nominal typing, therefore, it is not possible to bypass that principle by declaring a type as structural for normally defined classes (except those explicitly derived from <literal>N4Object</literal>).</simpara></footnote>
+but it contains all public, non-static members of that type</simpara>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>X</mi><mspace width="1.0mm"/><mo>≮</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mfenced close="}" open="{"><mstyle mathvariant="monospace"><mtext>N4Object</mtext></mstyle></mfenced><mspace width="3.0em"/><mi>T</mi><mo>.</mo><mi>d</mi><mi>e</mi><mi>f</mi><mi>S</mi><mi>t</mi><mi>r</mi><mi>u</mi><mi>c</mi><mi>t</mi><mi>u</mi><mi>r</mi><mi>a</mi><mi>l</mi><mi>}</mi></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∀</mo><mi>m</mi><mo>∈</mo><mi>T</mi><mo>.</mo><mi>m</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi><mi>s</mi><mo>,</mo><mi>m</mi><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>public</mtext></mstyle><mo>,</mo><mo>¬</mo><mi>m</mi><mo>.</mo><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>c</mi><mo>,</mo><mi>m</mi><mo>≠</mo><mi>T</mi><mo>.</mo><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi><mi>:</mi><mi>}</mi></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="1.0em"/><mo>∃</mo><msup><mi>m</mi><mi>'</mi></msup><mo>∈</mo><mi>X</mi><mo>.</mo><mi>m</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi><mi>s</mi><mi>:</mi><mi>}</mi></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="2.0em"/><msup><mi>m</mi><mi>'</mi></msup><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>public</mtext></mstyle><mo>∧</mo><mo>¬</mo><msup><mi>m</mi><mi>'</mi></msup><mo>.</mo><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>c</mi><mo>∧</mo><msup><mi>m</mi><mi>'</mi></msup><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><mi>m</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mi>}</mi></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="2.0em"/><mo>∧</mo><mi>Γ</mi><mo>⊢</mo><msup><mi>m</mi><mi>'</mi></msup><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>m</mi><mi>}</mi></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mfrac><mrow><mspace width="2.0em"/><mo>∧</mo><mi>μ</mi><mfenced close=")" open="("><mi>m</mi></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>Field</mtext></mstyle><mo>⇒</mo><mi>Γ</mi><mo>⊢</mo><mi>m</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><msup><mi>m</mi><mi>'</mi></msup></mrow><mrow><mspace width="13.0em"/><mi>Γ</mi><mo>⊢</mo><mi>X</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>T</mi><mspace width="13.0em"/></mrow></mfrac></math><?asciidoc-br?>
+or</simpara>
+</listitem>
+<listitem>
+<simpara>if it is a subtype of <literal>N4Object</literal> which explicitly extends or implements the
+structurally defined type.</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><mi>X</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mfenced close="}" open="{"><mstyle mathvariant="monospace"><mtext>N4Object</mtext></mstyle></mfenced><mspace width="3.0mm"/><mi>T</mi><mo>.</mo><mi>d</mi><mi>e</mi><mi>f</mi><mi>S</mi><mi>t</mi><mi>r</mi><mi>u</mi><mi>c</mi><mi>t</mi><mi>u</mi><mi>r</mi><mi>a</mi><mi>l</mi><mspace width="3.0mm"/><mrow><mi>T</mi><mo>∈</mo><mi>X</mi><mo>.</mo><mi>s</mi><mi>u</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi><msup><mi>s</mi><mo>*</mo></msup></mrow></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mi>X</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>T</mi></mrow></mfrac></math>
+</listitem>
+<listitem>
+<simpara>A structurally defined type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi></math> is implicitly derived
+from <literal>Object</literal> if no other type is specified. In particular, a structurally
+defined type must not be inherited from</simpara>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mfrac><mrow><mi>T</mi><mo>.</mo><mi>d</mi><mi>e</mi><mi>f</mi><mi>S</mi><mi>t</mi><mi>r</mi><mi>u</mi><mi>c</mi><mi>t</mi><mi>u</mi><mi>r</mi><mi>a</mi><mi>l</mi></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mi>T</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mstyle mathvariant="monospace"><mtext>Object</mtext></mstyle></mrow></mfrac></math></simpara>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi><mo>.</mo><mi>d</mi><mi>e</mi><mi>f</mi><mi>S</mi><mi>t</mi><mi>r</mi><mi>u</mi><mi>c</mi><mi>t</mi><mi>u</mi><mi>r</mi><mi>a</mi><mi>l</mi><mo>⇒</mo><mi>Γ</mi><mo>⊢</mo><mi>T</mi><mspace width="1.0mm"/><mo>≮</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mstyle mathvariant="monospace"><mtext>N4Object</mtext></mstyle><mo>∧</mo><mstyle mathvariant="monospace"><mtext>N4Object</mtext></mstyle><mo>∉</mo><mi>T</mi><mo>.</mo><mi>s</mi><mi>u</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi><msup><mi>s</mi><mo>*</mo></msup></math></simpara>
+</listitem>
+</orderedlist>
+</listitem>
+</orderedlist>
+</requirement>
+<example>
+<title>Declaration Site Structural Typing</title>
+<simpara>The following snippet demonstrates the effect of definition-site structural types by comparing them to
+nominal declared types: <anchor xml:id="ex:declaration-site-structural-typing" xreflabel="[ex:declaration-site-structural-typing]"/></simpara>
+<formalpara>
+<title>Declaration Site Structural Typing</title>
+<para>
+<programlisting language="n4js" linenumbering="unnumbered">interface ~Tilde { x; y; }
+interface Nominal { x; y; }
+class C { public x; public y;}
+class D extends C implements Tilde { }
+
+function f(p: Tilde) {}
+function g(p: Nominal) {}
+
+f(new C());         // error: nominal typing, C does not implement ~Tilde
+f(new D());         // ok, D is a nominal subtype (as it implements Tilde)
+f({x:10,y:10});     // ok: Tilde is used with structural typing for non-N4-classifiers</programlisting>
+</para>
+</formalpara>
+<simpara>Definition site structural typing may lead to unexpected results. For
+example;</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">class C{}
+class ~E extends C{}</programlisting>
+<simpara>It may be unexpected, but <literal>E</literal> is not a subtype of <literal>C</literal>, i.e.
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>E</mi><mspace width="1.0mm"/><mo>≮</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>C</mi></math>! E.g., <literal>instanceof</literal> won’t work with <literal>E</literal>, while it works
+with <literal>C</literal>!</simpara>
+</example>
+</section>
+<section xml:id="_use-site-structural-typing" role="language-n4js">
+<title>Use-Site Structural Typing</title>
+<simpara>Use-site structural typing offers several typing strategy modifiers to define the accessability of public properties of classes and interfaces.
+They can be used e.g. on variable declarations like this: <literal>var c : ~C</literal>.
+The table <xref linkend="tab:available-fields-of-structural-types"/> shows which properties of structural types can be accessed in the different type strategies.
+For example, when using the write-only structural strategy (i.e. <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>~</mi><mstyle mathvariant="monospace"><mtext>w</mtext></mstyle><mi>~</mi><mstyle mathvariant="monospace"><mtext>X</mtext></mstyle></math>), only the writeable fields, can be accessed for writing.
+In the table, the term field to both, public datafields and accessors of type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>X</mi></math>.
+Non-public properties are never accessable in use-site structural types.
+In any field-structural type, methods of the referenced nominal type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>X</mi></math> are not available.
+The initializer structural typing provides readable fields for every writeable field of the references type.</simpara>
+<table xml:id="tab:available-fields-of-structural-types" frame="all" rowsep="1" colsep="1">
+<title>Available Fields of Structural Types</title>
+<tgroup cols="6">
+<colspec colname="col_1" colwidth="16.6666*"/>
+<colspec colname="col_2" colwidth="16.6666*"/>
+<colspec colname="col_3" colwidth="16.6666*"/>
+<colspec colname="col_4" colwidth="16.6666*"/>
+<colspec colname="col_5" colwidth="16.6666*"/>
+<colspec colname="col_6" colwidth="16.667*"/>
+<thead>
+<row>
+<entry align="left" valign="top">Property of <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>X</mi></math></entry>
+<entry align="center" valign="top"><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>~</mi><mstyle mathvariant="monospace"><mtext>X</mtext></mstyle></math></entry>
+<entry align="center" valign="top"><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>~</mi><mi>~</mi><mstyle mathvariant="monospace"><mtext>X</mtext></mstyle></math></entry>
+<entry align="center" valign="top"><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>~</mi><mstyle mathvariant="monospace"><mtext>r</mtext></mstyle><mi>~</mi><mstyle mathvariant="monospace"><mtext>X</mtext></mstyle></math></entry>
+<entry align="center" valign="top"><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>~</mi><mstyle mathvariant="monospace"><mtext>w</mtext></mstyle><mi>~</mi><mstyle mathvariant="monospace"><mtext>X</mtext></mstyle></math></entry>
+<entry align="center" valign="top"><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>~</mi><mstyle mathvariant="monospace"><mtext>i</mtext></mstyle><mi>~</mi><mstyle mathvariant="monospace"><mtext>X</mtext></mstyle></math></entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry align="left" valign="top"><simpara>public method</simpara></entry>
+<entry align="center" valign="top"></entry>
+<entry align="center" valign="top"><simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>∅</mi></math></simpara></entry>
+<entry align="center" valign="top"><simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>∅</mi></math></simpara></entry>
+<entry align="center" valign="top"><simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>∅</mi></math></simpara></entry>
+<entry align="center" valign="top"><simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>∅</mi></math></simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara>public writable field</simpara></entry>
+<entry align="center" valign="top"></entry>
+<entry align="center" valign="top"></entry>
+<entry align="center" valign="top"><simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>∅</mi></math></simpara></entry>
+<entry align="center" valign="top"></entry>
+<entry align="center" valign="top"><simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>∅</mi></math></simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara>public readable field</simpara></entry>
+<entry align="center" valign="top"></entry>
+<entry align="center" valign="top"></entry>
+<entry align="center" valign="top"></entry>
+<entry align="center" valign="top"><simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>∅</mi></math></simpara></entry>
+<entry align="center" valign="top"><simpara>writable fields</simpara></entry>
+</row>
+</tbody>
+</tgroup>
+</table>
+<simpara>Multiple structural typing strategies can be nested when there are multiple use sites, like in the example <xref linkend="ex:nested-structural-typing-strategies"/> below at the locations ST1 and ST2.
+In the example, the datafield <literal>a.field</literal> has the nested structural type <literal>~r~ ~i~ A</literal> and thus the datafield <literal>a.field.df</literal> is readable.
+Nested structural types are evaluated on the fly when doing subtype checks.</simpara>
+<example xml:id="ex:nested-structural-typing-strategies">
+<title>Nested Structural Typing Strategies</title>
+<programlisting language="n4js" linenumbering="unnumbered">class A {
+    public df : string;
+}
+interface I&lt;T&gt; {
+    public field : ~r~T; // ST1
+}
+var a : ~i~A; // ST2</programlisting>
+</example>
+<simpara>The following example demonstrates the effect of the structural type modifiers:</simpara>
+<example>
+<title>Effect of structural type modifiers on use-site</title>
+<simpara>Let’s assume the type defined on the left.
+The following <emphasis>pseudo</emphasis> code snippets explicitly list the type with its members virtually created by a structural modifier.
+Note that this is pseudo code, as there are no real or virtual types created.
+Instead, only the subtype relation is defined accordingly:</simpara>
+<simpara>Effect of structural type modifiers on use-site</simpara>
+<informaltable frame="all" rowsep="1" colsep="1">
+<tgroup cols="3">
+<colspec colname="col_1" colwidth="33.3333*"/>
+<colspec colname="col_2" colwidth="33.3333*"/>
+<colspec colname="col_3" colwidth="33.3334*"/>
+<tbody>
+<row>
+<entry align="center" valign="top" namest="col_1" nameend="col_3"><simpara><emphasis role="strong">Effect of structural type modifiers on use-site</emphasis></simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><programlisting language="n4js" linenumbering="unnumbered">var c:C
+
+class C {
+    private x;
+    public y;
+    public f()
+    private g()
+    public get z():Z
+    public set z(z:Z)
+}
+interface I {
+    a;
+    func();
+}</programlisting></entry>
+<entry align="left" valign="top"><programlisting language="n4js" linenumbering="unnumbered">var cstructural:~C
+
+class cstructural {
+
+    public y;
+    public f()
+
+    public get z():Z
+    public set z(z:Z)
+}
+interface ~I {
+    a;
+    func();
+}</programlisting></entry>
+<entry align="left" valign="top"><programlisting language="n4js" linenumbering="unnumbered">var cfields:~~C
+
+class cfields {
+
+    public y;
+
+
+    public get z():Z
+    public set z(z:Z)
+}
+interface ~~I {
+    a;
+
+}</programlisting></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><emphasis role="strong">Type</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><emphasis role="strong">Structural Type</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><emphasis role="strong">Structural Field Type</emphasis></simpara></entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+<informaltable frame="all" rowsep="1" colsep="1">
+<tgroup cols="3">
+<colspec colname="col_1" colwidth="33.3333*"/>
+<colspec colname="col_2" colwidth="33.3333*"/>
+<colspec colname="col_3" colwidth="33.3334*"/>
+<tbody>
+<row>
+<entry align="left" valign="top"><programlisting language="n4js" linenumbering="unnumbered">var crofields:~r~C
+
+class crofields {
+
+    public get y():Y
+
+
+    public get z():Z
+
+}
+interface ~r~I {
+    public get a():A
+
+}</programlisting></entry>
+<entry align="left" valign="top"><programlisting language="n4js" linenumbering="unnumbered">var cwofields:~w~C
+
+class cwofields {
+
+    public set y(y:Y)
+
+
+
+    public set z(z:Z)
+}
+interface ~w~I {
+    public set a(a:A)
+
+}</programlisting></entry>
+<entry align="left" valign="top"><programlisting language="n4js" linenumbering="unnumbered">var cinitfields:~i~C
+
+class cinitfields {
+
+    public get y():Y
+
+
+    public get z():Z
+
+}
+interface ~i~I {
+    public get a():A
+
+}</programlisting></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><emphasis role="strong">Structural Read-only Field Type</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><emphasis role="strong">Structural Write-only Field Type</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><emphasis role="strong">Structural Initializer Field Type</emphasis></simpara></entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+<simpara><?asciidoc-pagebreak?></simpara>
+<simpara>Note that even if a type is defined without the structural modifier, it is not possible to use <literal>instanceof</literal> for variables declared as structural, as shown in the next example:</simpara>
+<informaltable frame="all" rowsep="1" colsep="1">
+<tgroup cols="3">
+<colspec colname="col_1" colwidth="33.3333*"/>
+<colspec colname="col_2" colwidth="33.3333*"/>
+<colspec colname="col_3" colwidth="33.3334*"/>
+<tbody>
+<row>
+<entry align="left" valign="top"><programlisting language="n4js" linenumbering="unnumbered">class C {..}
+interface I {..}
+
+foo(c: C, i: I) {
+    c instanceof C; // ok
+    c instanceof I; // ok
+}</programlisting></entry>
+<entry align="left" valign="top"><programlisting language="n4js" linenumbering="unnumbered">class C {..}
+interface I {..}
+
+foo(c: ~C, i: ~I) {
+    c instanceof C; // error
+    c instanceof I; // error
+}</programlisting></entry>
+<entry align="left" valign="top"><programlisting language="n4js" linenumbering="unnumbered">class C {..}
+interface I {..}
+
+foo(c: ~~C, i: ~~I) {
+    c instanceof C; // error
+    C instanceof I; // error
+}</programlisting></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><emphasis role="strong">Type</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><emphasis role="strong">Structural Type</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><emphasis role="strong">Structural Field Type</emphasis></simpara></entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+<itemizedlist>
+<listitem>
+<simpara>If a type is referenced with the structural type modifier <literal>~</literal> , the property <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi><mo>.</mo><mi>r</mi><mi>e</mi><mi>f</mi><mi>S</mi><mi>t</mi><mi>r</mi><mi>u</mi><mi>c</mi><mi>t</mi><mi>u</mi><mi>r</mi><mi>a</mi><mi>l</mi></math> is true.</simpara>
+</listitem>
+<listitem>
+<simpara>If a type is referenced with the structural field type modifier <literal>~~</literal>, the property <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi><mo>.</mo><mi>r</mi><mi>e</mi><mi>f</mi><mi>S</mi><mi>t</mi><mi>r</mi><mi>u</mi><mi>c</mi><mi>t</mi><mi>u</mi><mi>r</mi><mi>a</mi><mi>l</mi><mi>F</mi><mi>i</mi><mi>e</mi><mi>l</mi><mi>d</mi></math> is true.</simpara>
+</listitem>
+<listitem>
+<simpara>If a type is referenced with the structural read-only field type modifier <literal>~r~</literal>, the property <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi><mo>.</mo><mi>r</mi><mi>e</mi><mi>f</mi><mi>S</mi><mi>t</mi><mi>r</mi><mi>u</mi><mi>c</mi><mi>t</mi><mi>u</mi><mi>r</mi><mi>a</mi><mi>l</mi><mi>R</mi><mi>e</mi><mi>a</mi><mi>d</mi><mi>O</mi><mi>n</mi><mi>l</mi><mi>y</mi><mi>F</mi><mi>i</mi><mi>e</mi><mi>l</mi><mi>d</mi></math> is true.</simpara>
+</listitem>
+<listitem>
+<simpara>If a type is referenced with the structural write-only field type modifier <literal>~w~</literal>, then the property <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi><mo>.</mo><mi>r</mi><mi>e</mi><mi>f</mi><mi>S</mi><mi>t</mi><mi>r</mi><mi>u</mi><mi>c</mi><mi>t</mi><mi>u</mi><mi>r</mi><mi>a</mi><mi>l</mi><mi>W</mi><mi>r</mi><mi>i</mi><mi>t</mi><mi>e</mi><mi>O</mi><mi>n</mi><mi>l</mi><mi>y</mi><mi>F</mi><mi>i</mi><mi>e</mi><mi>l</mi><mi>d</mi></math> is true.</simpara>
+</listitem>
+<listitem>
+<simpara>If a type is referenced with the structural initializer field type modifier <literal>~i~</literal>, then the property <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi><mo>.</mo><mi>r</mi><mi>e</mi><mi>f</mi><mi>S</mi><mi>t</mi><mi>r</mi><mi>u</mi><mi>c</mi><mi>t</mi><mi>u</mi><mi>r</mi><mi>a</mi><mi>l</mi><mi>I</mi><mi>n</mi><mi>i</mi><mi>t</mi><mi>F</mi><mi>i</mi><mi>e</mi><mi>l</mi><mi>d</mi></math> is true.</simpara>
+</listitem>
+</itemizedlist>
+<simpara>We call the following:</simpara>
+<itemizedlist>
+<listitem>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi></math> the (nominal) type T,</simpara>
+</listitem>
+<listitem>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>~</mi><mstyle mathvariant="monospace"><mtext>T</mtext></mstyle></math> the structural version of <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi></math>,</simpara>
+</listitem>
+<listitem>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>~</mi><mi>~</mi><mstyle mathvariant="monospace"><mtext>T</mtext></mstyle></math> the structural field version of <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi></math>,</simpara>
+</listitem>
+<listitem>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>~</mi><mstyle mathvariant="monospace"><mtext>r</mtext></mstyle><mi>~</mi><mstyle mathvariant="monospace"><mtext>T</mtext></mstyle></math> the structural read-only field,</simpara>
+</listitem>
+<listitem>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>~</mi><mstyle mathvariant="monospace"><mtext>w</mtext></mstyle><mi>~</mi><mstyle mathvariant="monospace"><mtext>T</mtext></mstyle></math> the structural write-only field and</simpara>
+</listitem>
+<listitem>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>~</mi><mstyle mathvariant="monospace"><mtext>i</mtext></mstyle><mi>~</mi><mstyle mathvariant="monospace"><mtext>T</mtext></mstyle></math> the structural initializer field version of <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi></math>.</simpara>
+</listitem>
+</itemizedlist>
+</example>
+<requirement xml:id="IDE-76">
+<title>Use-Site Structural Typing</title>
+<simpara>
+<anchor xml:id="Req-IDE-76" xreflabel="[Req-IDE-76]"/>
+<emphasis role="strong">Requirement: IDE-76:</emphasis>
+<link linkend="Req-IDE-76">Use-Site Structural Typing</link> (ver. 1)</simpara>
+    <simpara>
+
+1.  The structural version of a type is a supertype of the nominal type:<?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>:</mi><mi>~</mi><mstyle mathvariant="monospace"><mtext>T</mtext></mstyle></math>
+2.  The structural field version of a type is a supertype of the structural type:<?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>~</mi><mstyle mathvariant="monospace"><mtext>T</mtext></mstyle><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>:</mi><mi>~</mi><mi>~</mi><mstyle mathvariant="monospace"><mtext>T</mtext></mstyle></math>
+3.  The structural read-only field version of a type is a supertype of the structural field type:<?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>~</mi><mi>~</mi><mstyle mathvariant="monospace"><mtext>T</mtext></mstyle><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>:</mi><mi>~</mi><mstyle mathvariant="monospace"><mtext>r</mtext></mstyle><mi>~</mi><mstyle mathvariant="monospace"><mtext>T</mtext></mstyle></math>
+4.  The structural write-only field version of a type is a supertype of the structural field type:<?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>~</mi><mi>~</mi><mstyle mathvariant="monospace"><mtext>T</mtext></mstyle><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>:</mi><mi>~</mi><mstyle mathvariant="monospace"><mtext>w</mtext></mstyle><mi>~</mi><mstyle mathvariant="monospace"><mtext>T</mtext></mstyle></math>
+5.  The structural (field) version of a type cannot be used on the right hand side of the <literal>instanceof</literal> operator:</simpara>
+<simpara>+</simpara>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mi>x</mi><mi> </mi><mstyle mathvariant="monospace"><mtext>instanceof</mtext></mstyle><mi> </mi><mi>E</mi><mo>⇒</mo><mi>Γ</mi><mo>⊢</mo><mi>E</mi><mi>:</mi><mi>T</mi></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mspace width="3.0em"/><mo>⇒</mo><mo>¬</mo><mrow><mo>(</mo><mi>T</mi><mo>.</mo><mi>r</mi><mi>e</mi><mi>f</mi><mi>S</mi><mi>t</mi><mi>r</mi><mi>u</mi><mi>c</mi><mi>t</mi><mi>u</mi><mi>r</mi><mi>a</mi><mi>l</mi></mrow></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mspace width="6.0em"/><mo>∨</mo><mi>T</mi><mo>.</mo><mi>r</mi><mi>e</mi><mi>f</mi><mi>S</mi><mi>t</mi><mi>r</mi><mi>u</mi><mi>c</mi><mi>t</mi><mi>u</mi><mi>r</mi><mi>a</mi><mi>l</mi><mi>F</mi><mi>i</mi><mi>e</mi><mi>l</mi><mi>d</mi></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mspace width="6.0em"/><mo>∨</mo><mi>T</mi><mo>.</mo><mi>r</mi><mi>e</mi><mi>f</mi><mi>S</mi><mi>t</mi><mi>r</mi><mi>u</mi><mi>c</mi><mi>t</mi><mi>u</mi><mi>r</mi><mi>a</mi><mi>l</mi><mi>R</mi><mi>e</mi><mi>a</mi><mi>d</mi><mi>O</mi><mi>n</mi><mi>l</mi><mi>y</mi><mi>F</mi><mi>i</mi><mi>e</mi><mi>l</mi><mi>d</mi></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mspace width="6.0em"/><mo>∨</mo><mi>T</mi><mo>.</mo><mi>r</mi><mi>e</mi><mi>f</mi><mi>S</mi><mi>t</mi><mi>r</mi><mi>u</mi><mi>c</mi><mi>t</mi><mi>u</mi><mi>r</mi><mi>a</mi><mi>l</mi><mi>W</mi><mi>r</mi><mi>i</mi><mi>t</mi><mi>e</mi><mi>O</mi><mi>n</mi><mi>l</mi><mi>y</mi><mi>F</mi><mi>i</mi><mi>e</mi><mi>l</mi><mi>d</mi></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mrow><mspace width="3.0mm"/><mspace width="6.0em"/><mo>∨</mo><mi>T</mi><mo>.</mo><mi>r</mi><mi>e</mi><mi>f</mi><mi>S</mi><mi>t</mi><mi>r</mi><mi>u</mi><mi>c</mi><mi>t</mi><mi>u</mi><mi>r</mi><mi>a</mi><mi>l</mi><mi>I</mi><mi>n</mi><mi>i</mi><mi>t</mi><mi>F</mi><mi>i</mi><mi>e</mi><mi>l</mi><mi>d</mi><mo>)</mo></mrow></math></simpara>
+<simpara>+
+That is, the following code will always issue an error: <literal>x instanceof ~T</literal> <footnote><simpara>Since this is already prevented by the parser (the tilde is interpreted as an unary operator), error messages are likely to look a little strange.</simpara></footnote>.
+6. A type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>X</mi></math> is a subtype of a structural version of a type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>~</mi><mstyle mathvariant="monospace"><mtext>T</mtext></mstyle></math>, if it contains all public, non-static members of the type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi></math>: <footnote><simpara>Note that due to this relaxed definition (compared with definition-site structural types) it is possible to pass an <literal>N4Object</literal> instance to a function of method with a declared structural type parameter.</simpara></footnote></simpara>
+<simpara>+</simpara>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∀</mo><mi>m</mi><mo>∈</mo><mi>T</mi><mo>.</mo><mi>m</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi><mi>s</mi><mo>,</mo><mi>m</mi><mo>.</mo><mi>o</mi><mi>w</mi><mi>n</mi><mi>e</mi><mi>r</mi><mo>∉</mo><mstyle mathvariant="monospace"><mtext>N4Object</mtext></mstyle><mo>,</mo><mi>m</mi><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>public</mtext></mstyle><mo>,</mo><mo>¬</mo><mi>m</mi><mo>.</mo><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>c</mi><mo>,</mo><mi>m</mi><mo>≠</mo><mi>T</mi><mo>.</mo><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi><mi>:</mi></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="1.0em"/><mo>∃</mo><msup><mi>m</mi><mi>'</mi></msup><mo>∈</mo><mi>X</mi><mo>.</mo><mi>m</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi><mi>s</mi><mi>:</mi></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="2.0em"/><msup><mi>m</mi><mi>'</mi></msup><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>public</mtext></mstyle><mo>∧</mo><mo>¬</mo><msup><mi>m</mi><mi>'</mi></msup><mo>.</mo><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>c</mi><mo>∧</mo><msup><mi>m</mi><mi>'</mi></msup><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><mi>m</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mfrac><mrow><mspace width="2.0em"/><mo>∧</mo><mi>Γ</mi><mo>⊢</mo><msup><mi>m</mi><mi>'</mi></msup><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>Γ</mi><mo>⊢</mo><mi>m</mi></mrow><mrow><mspace width="13.0em"/><mi>Γ</mi><mo>⊢</mo><mi>X</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>Γ</mi><mo>⊢</mo><mi>~</mi><mstyle mathvariant="monospace"><mtext>T</mtext></mstyle><mspace width="13.0em"/></mrow></mfrac></math><?asciidoc-br?>
+7.  A type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>X</mi></math> is a subtype of a structural field version of a type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>~</mi><mi>~</mi><mstyle mathvariant="monospace"><mtext>T</mtext></mstyle></math>, if it contains all public, non-static fields of the type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi></math>.<?asciidoc-br?>
+Special cases regarding optional fields are described in <link linkend="optional-fields">Optional Fields</link>.</simpara>
+<simpara>+</simpara>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∀</mo><mi>m</mi><mo>∈</mo><mi>T</mi><mo>.</mo><mi>f</mi><mi>i</mi><mi>e</mi><mi>l</mi><mi>d</mi><mi>s</mi><mo>,</mo><mi>m</mi><mo>.</mo><mi>o</mi><mi>w</mi><mi>n</mi><mi>e</mi><mi>r</mi><mo>∉</mo><mstyle mathvariant="monospace"><mtext>N4Object</mtext></mstyle><mo>,</mo><mi>m</mi><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>public</mtext></mstyle><mo>,</mo><mo>¬</mo><mi>m</mi><mo>.</mo><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>c</mi></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="1.0em"/><mo>∨</mo><mi> </mi><mo>∃</mo><msup><mi>m</mi><mi>'</mi></msup><mo>∈</mo><mi>X</mi><mo>.</mo><mi>f</mi><mi>i</mi><mi>e</mi><mi>l</mi><mi>d</mi><mi>s</mi><mi>:</mi></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0em"/><msup><mi>m</mi><mi>'</mi></msup><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>public</mtext></mstyle><mo>∧</mo><mo>¬</mo><msup><mi>m</mi><mi>'</mi></msup><mo>.</mo><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>c</mi><mo>∧</mo><msup><mi>m</mi><mi>'</mi></msup><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><mi>m</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0em"/><mo>∧</mo><mi>Γ</mi><mo>⊢</mo><msup><mi>m</mi><mi>'</mi></msup><mi>:</mi><msub><mi>T</mi><mi>m</mi></msub><mo>∧</mo><mi>Γ</mi><mo>⊢</mo><mi>m</mi><mi>:</mi><msub><mi>T</mi><msup><mi>m</mi><mi>'</mi></msup></msub><mo>∧</mo><msub><mi>T</mi><mi>m</mi></msub><mo>=</mo><msub><mi>T</mi><msup><mi>m</mi><mi>'</mi></msup></msub><mi>}</mi></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mfrac><mrow><mspace width="3.0em"/><mo>∧</mo><msup><mi>m</mi><mi>'</mi></msup><mo>.</mo><mi>a</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>g</mi><mi>n</mi><mi>a</mi><mi>b</mi><mi>i</mi><mi>l</mi><mi>i</mi><mi>t</mi><mi>y</mi><mo>≥</mo><mi>m</mi><mo>.</mo><mi>a</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>g</mi><mi>n</mi><mi>a</mi><mi>b</mi><mi>i</mi><mi>l</mi><mi>i</mi><mi>t</mi><mi>y</mi></mrow><mrow><mspace width="13.0em"/><mi>Γ</mi><mo>⊢</mo><mi>X</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>~</mi><mi>~</mi><mstyle mathvariant="monospace"><mtext>T</mtext></mstyle><mspace width="13.0em"/></mrow></mfrac></math></simpara>
+<simpara>+
+8.  A type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>X</mi></math> is a subtype of a structural read-only field version of a type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>~</mi><mstyle mathvariant="monospace"><mtext>r</mtext></mstyle><mi>~</mi><mstyle mathvariant="monospace"><mtext>T</mtext></mstyle></math>, if it contains all public and non-static readable fields of the type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi></math>.
+Special cases regarding optional fields are described in <link linkend="optional-fields">Optional Fields</link>.</simpara>
+<simpara>+</simpara>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∀</mo><mi>m</mi><mo>∈</mo><mi>T</mi><mo>.</mo><mi>f</mi><mi>i</mi><mi>e</mi><mi>l</mi><mi>d</mi><mi>s</mi><mo>∪</mo><mi>T</mi><mo>.</mo><mi>g</mi><mi>e</mi><mi>t</mi><mi>t</mi><mi>e</mi><mi>r</mi><mi>s</mi><mo>,</mo><mi>m</mi><mo>.</mo><mi>o</mi><mi>w</mi><mi>n</mi><mi>e</mi><mi>r</mi><mo>∉</mo><mstyle mathvariant="monospace"><mtext>N4Object</mtext></mstyle><mo>,</mo><mi>m</mi><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>public</mtext></mstyle><mo>,</mo><mo>¬</mo><mi>m</mi><mo>.</mo><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>c</mi></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="1.0em"/><mo>∨</mo><mi> </mi><mo>∃</mo><msup><mi>m</mi><mi>'</mi></msup><mo>∈</mo><mi>X</mi><mo>.</mo><mi>f</mi><mi>i</mi><mi>e</mi><mi>l</mi><mi>d</mi><mi>s</mi><mo>∪</mo><mi>X</mi><mo>.</mo><mi>g</mi><mi>e</mi><mi>t</mi><mi>t</mi><mi>e</mi><mi>r</mi><mi>s</mi><mi>:</mi></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0em"/><msup><mi>m</mi><mi>'</mi></msup><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>public</mtext></mstyle><mo>∧</mo><mo>¬</mo><msup><mi>m</mi><mi>'</mi></msup><mo>.</mo><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>c</mi><mo>∧</mo><msup><mi>m</mi><mi>'</mi></msup><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><mi>m</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0em"/><mo>∧</mo><mi>Γ</mi><mo>⊢</mo><msup><mi>m</mi><mi>'</mi></msup><mi>:</mi><msub><mi>T</mi><mi>m</mi></msub><mo>∧</mo><mi>Γ</mi><mo>⊢</mo><mi>m</mi><mi>:</mi><msub><mi>T</mi><msup><mi>m</mi><mi>'</mi></msup></msub><mo>∧</mo><msub><mi>T</mi><mi>m</mi></msub><mo>=</mo><msub><mi>T</mi><msup><mi>m</mi><mi>'</mi></msup></msub></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mfrac><mrow><mspace width="3.0em"/><mo>∧</mo><msup><mi>m</mi><mi>'</mi></msup><mo>.</mo><mi>a</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>g</mi><mi>n</mi><mi>a</mi><mi>b</mi><mi>i</mi><mi>l</mi><mi>i</mi><mi>t</mi><mi>y</mi><mo>≥</mo><mi>m</mi><mo>.</mo><mi>a</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>g</mi><mi>n</mi><mi>a</mi><mi>b</mi><mi>i</mi><mi>l</mi><mi>i</mi><mi>t</mi><mi>y</mi></mrow><mrow><mspace width="13.0em"/><mi>Γ</mi><mo>⊢</mo><mi>X</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>~</mi><mstyle mathvariant="monospace"><mtext>r</mtext></mstyle><mi>~</mi><mstyle mathvariant="monospace"><mtext>T</mtext></mstyle><mspace width="13.0em"/></mrow></mfrac></math></simpara>
+<simpara>+
+9.  A type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>X</mi></math> is a subtype of a structural write-only field version of a type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>~</mi><mstyle mathvariant="monospace"><mtext>w</mtext></mstyle><mi>~</mi><mstyle mathvariant="monospace"><mtext>T</mtext></mstyle></math>, if it contains all public and non-static writable fields of the type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi></math>. Special cases regarding optional fields are described in <link linkend="optional-fields">Optional Fields</link>.</simpara>
+<simpara>+</simpara>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∀</mo><mi>m</mi><mo>∈</mo><mi>T</mi><mo>.</mo><mi>f</mi><mi>i</mi><mi>e</mi><mi>l</mi><mi>d</mi><mi>s</mi><mo>∪</mo><mi>T</mi><mo>.</mo><mi>s</mi><mi>e</mi><mi>t</mi><mi>t</mi><mi>e</mi><mi>r</mi><mi>s</mi><mo>,</mo><mi>m</mi><mo>.</mo><mi>o</mi><mi>w</mi><mi>n</mi><mi>e</mi><mi>r</mi><mo>∉</mo><mstyle mathvariant="monospace"><mtext>N4Object</mtext></mstyle><mo>,</mo><mi>m</mi><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>public</mtext></mstyle><mo>,</mo><mo>¬</mo><mi>m</mi><mo>.</mo><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>c</mi><mo>,</mo><mo>¬</mo><mi>m</mi><mo>.</mo><mi>f</mi><mi>i</mi><mi>n</mi><mi>a</mi><mi>l</mi></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="1.0em"/><mo>∨</mo><mi> </mi><mo>∃</mo><msup><mi>m</mi><mi>'</mi></msup><mo>∈</mo><mi>X</mi><mo>.</mo><mi>f</mi><mi>i</mi><mi>e</mi><mi>l</mi><mi>d</mi><mi>s</mi><mo>∪</mo><mi>X</mi><mo>.</mo><mi>s</mi><mi>e</mi><mi>t</mi><mi>t</mi><mi>e</mi><mi>r</mi><mi>s</mi><mi>:</mi></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0em"/><msup><mi>m</mi><mi>'</mi></msup><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>public</mtext></mstyle><mo>∧</mo><mo>¬</mo><msup><mi>m</mi><mi>'</mi></msup><mo>.</mo><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>c</mi><mo>∧</mo><msup><mi>m</mi><mi>'</mi></msup><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><mi>m</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0em"/><mo>∧</mo><mi>Γ</mi><mo>⊢</mo><msup><mi>m</mi><mi>'</mi></msup><mi>:</mi><msub><mi>T</mi><mi>m</mi></msub><mo>∧</mo><mi>Γ</mi><mo>⊢</mo><mi>m</mi><mi>:</mi><msub><mi>T</mi><msup><mi>m</mi><mi>'</mi></msup></msub><mo>∧</mo><msub><mi>T</mi><mi>m</mi></msub><mo>=</mo><msub><mi>T</mi><msup><mi>m</mi><mi>'</mi></msup></msub></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mfrac><mrow><mspace width="3.0em"/><mo>∧</mo><msup><mi>m</mi><mi>'</mi></msup><mo>.</mo><mi>a</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>g</mi><mi>n</mi><mi>a</mi><mi>b</mi><mi>i</mi><mi>l</mi><mi>i</mi><mi>t</mi><mi>y</mi><mo>≥</mo><mi>m</mi><mo>.</mo><mi>a</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>g</mi><mi>n</mi><mi>a</mi><mi>b</mi><mi>i</mi><mi>l</mi><mi>i</mi><mi>t</mi><mi>y</mi></mrow><mrow><mspace width="13.0em"/><mi>Γ</mi><mo>⊢</mo><mi>X</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>~</mi><mstyle mathvariant="monospace"><mtext>w</mtext></mstyle><mi>~</mi><mstyle mathvariant="monospace"><mtext>T</mtext></mstyle><mspace width="13.0em"/></mrow></mfrac></math></simpara>
+<simpara>+
+10. A type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>X</mi></math> is a subtype of a structural field version of a type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>~</mi><mi>~</mi><mstyle mathvariant="monospace"><mtext>this</mtext></mstyle></math>, if it contains all public, non-static fields,
+either defined via data fields or field get accessors, of the inferred type of <literal>this</literal>.
+Special cases regarding optional fields are described in <link linkend="optional-fields">Optional Fields</link>.</simpara>
+<simpara>+</simpara>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>Γ</mi><mo>⊢</mo><mi>t</mi><mi>h</mi><mi>i</mi><mi>s</mi><mi>:</mi><mi>T</mi></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∀</mo><mi>m</mi><mo>∈</mo><mi>T</mi><mo>.</mo><mi>f</mi><mi>i</mi><mi>e</mi><mi>l</mi><mi>d</mi><mi>s</mi><mo>∪</mo><mi>T</mi><mo>.</mo><mi>s</mi><mi>e</mi><mi>t</mi><mi>t</mi><mi>e</mi><mi>r</mi><mi>s</mi><mo>,</mo><mi>m</mi><mo>.</mo><mi>o</mi><mi>w</mi><mi>n</mi><mi>e</mi><mi>r</mi><mo>∉</mo><mstyle mathvariant="monospace"><mtext>N4Object</mtext></mstyle><mo>,</mo><mi>m</mi><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>public</mtext></mstyle><mo>,</mo><mo>¬</mo><mi>m</mi><mo>.</mo><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>c</mi></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∨</mo><mi>m</mi><mo>.</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mo>≠</mo><mstyle mathvariant="monospace"><mtext>null</mtext></mstyle></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="1.0em"/><mo>∨</mo><mi> </mi><mo>∃</mo><msup><mi>m</mi><mi>'</mi></msup><mo>∈</mo><mi>X</mi><mo>.</mo><mi>f</mi><mi>i</mi><mi>e</mi><mi>l</mi><mi>d</mi><mi>s</mi><mo>∪</mo><mi>X</mi><mo>.</mo><mi>g</mi><mi>e</mi><mi>t</mi><mi>t</mi><mi>e</mi><mi>r</mi><mi>s</mi><mi>:</mi></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0em"/><msup><mi>m</mi><mi>'</mi></msup><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>public</mtext></mstyle><mo>∧</mo><mo>¬</mo><msup><mi>m</mi><mi>'</mi></msup><mo>.</mo><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>c</mi><mo>∧</mo><msup><mi>m</mi><mi>'</mi></msup><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><mi>m</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mfrac><mrow><mspace width="3.0em"/><mo>∧</mo><mi>Γ</mi><mo>⊢</mo><msup><mi>m</mi><mi>'</mi></msup><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>m</mi><mo>∧</mo><msup><mi>m</mi><mi>'</mi></msup><mo>.</mo><mi>a</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>g</mi><mi>n</mi><mi>a</mi><mi>b</mi><mi>i</mi><mi>l</mi><mi>i</mi><mi>t</mi><mi>y</mi><mo>≥</mo><mi>m</mi><mo>.</mo><mi>a</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>g</mi><mi>n</mi><mi>a</mi><mi>b</mi><mi>i</mi><mi>l</mi><mi>i</mi><mi>t</mi><mi>y</mi></mrow><mrow><mspace width="13.0em"/><mi>Γ</mi><mo>⊢</mo><mi>X</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>~</mi><mi>~</mi><mstyle mathvariant="monospace"><mtext>t</mtext></mstyle><mi>h</mi><mi>i</mi><mi>s</mi><mspace width="13.0em"/></mrow></mfrac></math></simpara>
+<simpara>+
+11. A structural field type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>~</mi><mi>~</mi><mstyle mathvariant="monospace"><mtext>T</mtext></mstyle></math> is a subtype of a structural type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>~</mi><mstyle mathvariant="monospace"><mtext>X</mtext></mstyle></math>, if <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>~</mi><mstyle mathvariant="monospace"><mtext>X</mtext></mstyle></math> only contains fields (except methods inherited from <literal>Object</literal>) and if <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>~</mi><mi>~</mi><mstyle mathvariant="monospace"><mtext>T</mtext></mstyle><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>~</mi><mi>~</mi><mstyle mathvariant="monospace"><mtext>X</mtext></mstyle></math>.</simpara>
+<simpara>+</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><mi>X</mi><mo>.</mo><mi>m</mi><mi>e</mi><mi>t</mi><mi>h</mi><mi>o</mi><mi>d</mi><mi>s</mi><mo>∖</mo><mstyle mathvariant="monospace"><mtext>Object</mtext></mstyle><mo>.</mo><mi>m</mi><mi>e</mi><mi>t</mi><mi>h</mi><mi>o</mi><mi>d</mi><mi>s</mi><mo>=</mo><mi>∅</mi><mo>∧</mo><mi>Γ</mi><mo>⊢</mo><mi>~</mi><mi>~</mi><mstyle mathvariant="monospace"><mtext>T</mtext></mstyle><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>~</mi><mi>~</mi><mstyle mathvariant="monospace"><mtext>X</mtext></mstyle></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mi>~</mi><mi>~</mi><mstyle mathvariant="monospace"><mtext>T</mtext></mstyle><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>~</mi><mstyle mathvariant="monospace"><mtext>X</mtext></mstyle></mrow></mfrac></math>
+<simpara>+
+12. Use-site structural typing cannot be used for declaring supertypes of classes or interfaces.
+That is to say that structural types cannot be used after <literal>extends</literal>, <literal>implements</literal> or <literal>with</literal> in type declarations <footnote><simpara>This is already constrained by the grammar.</simpara></footnote>.</simpara>
+</requirement>
+<simpara>Note that all members of <literal>N4Object</literal> are excluded.
+This implies that extended reflective features (cf. <xref linkend="_reflection-meta-information"/> ) are not available in the context of structural typing.
+The <literal>instanceof</literal> operator is still working as described in <xref linkend="_relational-expression"/>, in that it can be used to check the type of an instance.</simpara>
+<simpara>If a type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>X</mi></math> is a (nominal) subtype of T, it is, of course, also a subtype of <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>~</mi><mstyle mathvariant="monospace"><mtext>T</mtext></mstyle></math>:</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><mi>Γ</mi><mo>⊢</mo><mi>X</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>Γ</mi><mo>⊢</mo><mi>T</mi></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mi>X</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>Γ</mi><mo>⊢</mo><mi>~</mi><mstyle mathvariant="monospace"><mtext>T</mtext></mstyle></mrow></mfrac></math>
+<simpara>This is only a shortcut for the type inference defined above.</simpara>
+<requirement xml:id="IDE-77">
+<title>Definition and Use-Site Precedence</title>
+<simpara>
+<anchor xml:id="Req-IDE-77" xreflabel="[Req-IDE-77]"/>
+<emphasis role="strong">Requirement: IDE-77:</emphasis>
+<link linkend="Req-IDE-77">Definition and Use-Site Precedence</link> (ver. 1)</simpara>
+    <simpara>
+
+If a type is structurally typed on both definition and use-site, the rules for
+use-site structural typing (<xref linkend="Req-IDE-76"/>) are
+applied.</simpara>
+<example>
+<title>Use-Site Structural Typing</title>
+<simpara>The following example demonstrates the effect of the structural (field) modifier, used in this case for function parameters.</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">interface I { public x: number; public foo()};
+class C { public x: number; public foo() {}};
+
+function n(p: I) {}
+function f(p: ~I) {}
+function g(p: ~~I) {}
+
+n(new C());     // error: nominal typing, C does not implement I
+f(new C());     // ok: C is a (structural) subtype of ~I
+f({x:10});      // error, the object literal does not provide function foo()
+g({x:10});      // ok: object literal provides all fields of I</programlisting>
+</example>
+<example>
+<title>Structural types variable and instanceof operator</title>
+<simpara>It is possible to use a variable typed with a structural version of a type on the left hand side of the <literal>instanceof</literal> operator, as demonstrated in this example:</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">class C {
+    public x;
+    public betterX() { return this.x||1;}
+}
+
+function f(p: ~~C) {
+    if (p instanceof C) {
+        console.log((p as C).betterX);
+    } else {
+        console.log(p.x||1);
+    }
+}</programlisting>
+</example>
+<simpara>The following table describes the member availability of <literal>X</literal> in various
+typing scenarios. Such as <literal>~~X</literal>, <literal>~r~X</literal>, <literal>~w~X</literal>,  <literal>~i~X</literal>.</simpara>
+<table role="language-n4js" frame="all" rowsep="1" colsep="1">
+<title>Member Availability in various Typing Scenarios</title>
+<tgroup cols="5">
+<colspec colname="col_1" colwidth="33.3333*"/>
+<colspec colname="col_2" colwidth="16.6666*"/>
+<colspec colname="col_3" colwidth="16.6666*"/>
+<colspec colname="col_4" colwidth="16.6666*"/>
+<colspec colname="col_5" colwidth="16.6669*"/>
+<thead>
+<row>
+<entry align="left" valign="top">Member of type <emphasis>X</emphasis></entry>
+<entry align="center" valign="top"><literal>~~X</literal></entry>
+<entry align="center" valign="top"><literal>~r~X</literal></entry>
+<entry align="center" valign="top"><literal>~w~X</literal></entry>
+<entry align="center" valign="top"><literal>~i~X</literal></entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry align="left" valign="top"><simpara><literal>private m0;</literal></simpara></entry>
+<entry align="center" valign="top"><simpara>&#8201;&#8212;&#8201;</simpara></entry>
+<entry align="center" valign="top"><simpara>&#8201;&#8212;&#8201;</simpara></entry>
+<entry align="center" valign="top"><simpara>&#8201;&#8212;&#8201;</simpara></entry>
+<entry align="center" valign="top"><simpara>&#8201;&#8212;&#8201;</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><literal>public set m1(m) { }</literal></simpara></entry>
+<entry align="center" valign="top"><simpara>write</simpara></entry>
+<entry align="center" valign="top"><simpara>&#8201;&#8212;&#8201;</simpara></entry>
+<entry align="center" valign="top"><simpara>write</simpara></entry>
+<entry align="center" valign="top"><simpara>read</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><literal>public get m2() {&#8230;&#8203;}</literal></simpara></entry>
+<entry align="center" valign="top"><simpara>read</simpara></entry>
+<entry align="center" valign="top"><simpara>read</simpara></entry>
+<entry align="center" valign="top"><simpara>&#8201;&#8212;&#8201;</simpara></entry>
+<entry align="center" valign="top"></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><literal>public m3;</literal></simpara></entry>
+<entry align="center" valign="top"><simpara>read/write</simpara></entry>
+<entry align="center" valign="top"><simpara>read</simpara></entry>
+<entry align="center" valign="top"><simpara>write</simpara></entry>
+<entry align="center" valign="top"><simpara>read</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><literal>public m4 = 'init.m4';</literal></simpara></entry>
+<entry align="center" valign="top"><simpara>read/write</simpara></entry>
+<entry align="center" valign="top"><simpara>read</simpara></entry>
+<entry align="center" valign="top"><simpara>write</simpara></entry>
+<entry align="center" valign="top"><simpara>read <emphasis>?</emphasis></simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><literal>public m5: any?;</literal></simpara></entry>
+<entry align="center" valign="top"><simpara>read<emphasis>?</emphasis>/write</simpara></entry>
+<entry align="center" valign="top"><simpara>read<emphasis>?</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara>write</simpara></entry>
+<entry align="center" valign="top"><simpara>read<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>?</mi></math></simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><literal>@Final public m6 = 'init.m6';</literal></simpara></entry>
+<entry align="center" valign="top"><simpara>read</simpara></entry>
+<entry align="center" valign="top"><simpara>read</simpara></entry>
+<entry align="center" valign="top"></entry>
+<entry align="center" valign="top"></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><literal>@Final public m7;</literal></simpara></entry>
+<entry align="center" valign="top"><simpara>read</simpara></entry>
+<entry align="center" valign="top"><simpara>read</simpara></entry>
+<entry align="center" valign="top"></entry>
+<entry align="center" valign="top"><simpara>read</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><literal>public get m8() {&#8230;&#8203;}</literal></simpara></entry>
+<entry align="center" valign="middle" morerows="1"><simpara>read/write</simpara></entry>
+<entry align="center" valign="middle" morerows="1"><simpara>read</simpara></entry>
+<entry align="center" valign="middle" morerows="1"><simpara>write</simpara></entry>
+<entry align="center" valign="middle" morerows="1"><simpara>read</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><literal>public set m8(m) { }</literal></simpara></entry>
+</row>
+</tbody>
+</tgroup>
+</table>
+</requirement>
+</section>
+<section xml:id="structural-readWriteInit-field-typing" role="language-n4js">
+<title>Structural Read-only, Write-only and Initializer Field Typing</title>
+<simpara>Structural read-only, write-only and initializer field typings are extensions of structural field typing.
+Everything that is defined for the field structural typing must comply with these extension field typings.
+For the read-only type, readable fields (mutable and <literal>@Final</literal> ones) and setters are considered, for the write-only type; only the setters and mutable fields are considered.
+Due to the hybrid nature of the initializer type it can act two different ways.
+To be more precise, a type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>X</mi></math> (structural initializer field type) is a supertype of <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>Y</mi></math> (structural initializer field type) if for each public, non-static, non-optional writable field (mutable data field of setter) of <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>X</mi></math>, there is a corresponding, public, non-static readable field of <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>Y</mi></math>.
+All public member fields with <literal>@Final</literal> annotation are considered to be mandatory in the initializer field typing  <literal>@Spec</literal> constructors.
+The already-initialized <literal>@Final</literal> fields can be either omitted from, or can be re-initialized via, an initializer field typing <literal>@Spec</literal> style constructor.</simpara>
+<example>
+<title>Subtype relationship between structural field typing</title>
+<programlisting language="n4js" linenumbering="unnumbered">class A1 {
+    public s: string;
+}
+
+class A2 {
+    public set s(s: string) { }
+    public get s(): string { return null; }
+}
+
+class A3 {
+    @Final public s: string = null;
+}
+
+class A4 {
+    public get s(): string { return null; }
+}
+
+class A5 {
+    public set s(s: string) { }
+}</programlisting>
+<simpara><?asciidoc-pagebreak?></simpara>
+<informaltable role="small" frame="all" rowsep="1" colsep="1">
+<tgroup cols="19">
+<colspec colname="col_1" colwidth="5.2631*"/>
+<colspec colname="col_2" colwidth="5.2631*"/>
+<colspec colname="col_3" colwidth="5.2631*"/>
+<colspec colname="col_4" colwidth="5.2631*"/>
+<colspec colname="col_5" colwidth="5.2631*"/>
+<colspec colname="col_6" colwidth="5.2631*"/>
+<colspec colname="col_7" colwidth="5.2631*"/>
+<colspec colname="col_8" colwidth="5.2631*"/>
+<colspec colname="col_9" colwidth="5.2631*"/>
+<colspec colname="col_10" colwidth="5.2631*"/>
+<colspec colname="col_11" colwidth="5.2631*"/>
+<colspec colname="col_12" colwidth="5.2631*"/>
+<colspec colname="col_13" colwidth="5.2631*"/>
+<colspec colname="col_14" colwidth="5.2631*"/>
+<colspec colname="col_15" colwidth="5.2631*"/>
+<colspec colname="col_16" colwidth="5.2631*"/>
+<colspec colname="col_17" colwidth="5.2631*"/>
+<colspec colname="col_18" colwidth="5.2631*"/>
+<colspec colname="col_19" colwidth="5.2642*"/>
+<tbody>
+<row>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>A1</simpara></entry>
+<entry align="left" valign="top"><simpara>~A1</simpara></entry>
+<entry align="left" valign="top"><simpara>~~A1</simpara></entry>
+<entry align="left" valign="top"><simpara>~r~A1</simpara></entry>
+<entry align="left" valign="top"><simpara>~r~A2</simpara></entry>
+<entry align="left" valign="top"><simpara>~r~A3</simpara></entry>
+<entry align="left" valign="top"><simpara>~r~A4</simpara></entry>
+<entry align="left" valign="top"><simpara>~r~A5</simpara></entry>
+<entry align="left" valign="top"><simpara>~w~A1</simpara></entry>
+<entry align="left" valign="top"><simpara>~w~A2</simpara></entry>
+<entry align="left" valign="top"><simpara>~w~A3</simpara></entry>
+<entry align="left" valign="top"><simpara>~w~A4</simpara></entry>
+<entry align="left" valign="top"><simpara>~w~A5</simpara></entry>
+<entry align="left" valign="top"><simpara>~i~A1</simpara></entry>
+<entry align="left" valign="top"><simpara>~i~A2</simpara></entry>
+<entry align="left" valign="top"><simpara>~i~A3</simpara></entry>
+<entry align="left" valign="top"><simpara>~r~A4</simpara></entry>
+<entry align="left" valign="top"><simpara>~r~A5</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara>A1</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara>~A1</simpara></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara>~~A1</simpara></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara>~r~A1</simpara></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara>~r~A2</simpara></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara>~r~A3</simpara></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara>~r~A4</simpara></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara>~r~A5</simpara></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara>~w~A1</simpara></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara>~w~A2</simpara></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara>~w~A3</simpara></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara>~w~A4</simpara></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara>~w~A5</simpara></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara>~i~A1</simpara></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara>~i~A2</simpara></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara>~i~A3</simpara></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara>~r~A4</simpara></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara>~r~A5</simpara></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"><simpara>✓</simpara></entry>
+<entry align="left" valign="top"></entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+</example>
+</section>
+<section xml:id="_public-setter-annotated-with-literal-providesinitializer-literal" role="language-n4js">
+<title>Public Setter Annotated With <literal>ProvidesInitializer</literal></title>
+<simpara>Public setters with <literal>ProvidesInitializer</literal> annotation can declare optional fields implemented by means of field accessors instead of data fields.
+Data fields with an initializer are treated as optional in the initializer field type.</simpara>
+<simpara>It is important to note that it is valid to use the <literal>ProvidesInitializer</literal> annotation for setters in <literal>n4js</literal> files and not only definition files.</simpara>
+<example>
+<title>Setters with <literal>@ProvidesInitializer</literal> treated as optional</title>
+<programlisting language="n4js" linenumbering="unnumbered">class C {
+    private _y: int = 1;
+
+    public get y() { return this._y; }
+    @ProvidesInitializer
+    public set y(v: int) { this._y = v; }
+
+    public constructor(@Spec spec: ~i~this) { }
+}
+
+console.log(new C({}).y); // 1
+console.log(new C({y: 42}).y); //24</programlisting>
+</example>
+</section>
+<section xml:id="_structural-types-with-optional-fields" role="language-n4js">
+<title>Structural Types With Optional Fields</title>
+<simpara>Public optional fields become a member of the structural (field) type as
+well. To ensure the overall type safety, the semantics of optionality (e.g. on or off) depends on the context, in which the optional fields are currently being used (See <link linkend="optional-fields">Optional Fields</link>).</simpara>
+</section>
+<section xml:id="_structural-types-with-access-modifier" role="language-n4js">
+<title>Structural Types With Access Modifier</title>
+<simpara>The access modifier of the subtype have to provide equal or higher
+visibility.</simpara>
+<example>
+<title>Access modifier in structural typing</title>
+<programlisting language="n4js" linenumbering="unnumbered">class C {
+    public s: number;
+}
+class D {
+    project s: number;
+}
+function f(c: ~C) {}
+f(new D()); // error: D is no (structural) subtype of ~C, as visibility of s in D is lower
+function g(d: ~D) {}
+g(new C()); // ok: C is a (structural) subtype of ~D, as visibility of s in C is greater-than-or-equal to s in D</programlisting>
+</example>
+</section>
+<section xml:id="_structural-types-with-additional-members" role="language-n4js">
+<title>Structural Types With Additional Members</title>
+<simpara>It is possible to add additional members when structurally referencing a
+declared type.</simpara>
+<section xml:id="_syntax-8">
+<title>Syntax</title>
+<programlisting language="xtext" linenumbering="unnumbered">TStructMember:
+    TStructGetter | TStructGetterES4 | TStructSetter | TStructMethod | TStructMethodES4 | TStructField;
+
+TStructMethod:
+    =&gt;
+    ({TStructMethod} ('&lt;' typeVars+=TypeVariable (',' typeVars+=TypeVariable)* '&gt;')?
+    returnTypeRef=TypeRef name=TypesIdentifier '(')
+        (fpars+=TAnonymousFormalParameter (',' fpars+=TAnonymousFormalParameter)*)? ')'
+    ';'?;
+
+TStructMethodES4 returns TStructMethod:
+    =&gt;
+    ({TStructMethod} ('&lt;' typeVars+=TypeVariable (',' typeVars+=TypeVariable)* '&gt;')?
+        name=TypesIdentifier '(')
+        (fpars+=TAnonymousFormalParameter (',' fpars+=TAnonymousFormalParameter)*)? ')'
+        (':' returnTypeRef=TypeRef)?
+    ';'?;
+
+TStructField:
+    (
+        typeRef=TypeRef name=TypesIdentifier
+        | name=TypesIdentifier (':' typeRef=TypeRef)?
+    )
+    ';';
+
+TStructGetter:
+    =&gt; ({TStructGetter}
+    declaredTypeRef=TypeRef
+    'get'
+    name=TypesIdentifier)
+    '(' ')' ';'?;
+
+TStructGetterES4 returns TStructGetter:
+    =&gt; ({TStructGetter}
+    'get'
+    name=TypesIdentifier)
+    '(' ')' (':' declaredTypeRef=TypeRef)? ';'?;
+
+TStructSetter:
+    =&gt; ({TStructSetter}
+    'set'
+    name=TypesIdentifier)
+    '(' fpar=TAnonymousFormalParameter ')' ';'?;
+
+TAnonymousFormalParameter:
+    typeRef=TypeRef variadic?='...'? name=TIdentifier?
+    | variadic?='...'? (=&gt; name=TIdentifier ':') typeRef=TypeRef;</programlisting>
+<section xml:id="_semantics-6">
+<title>Semantics</title>
+<requirement xml:id="IDE-78">
+<title>Additional structural members</title>
+<simpara>
+<anchor xml:id="Req-IDE-78" xreflabel="[Req-IDE-78]"/>
+<emphasis role="strong">Requirement: IDE-78:</emphasis>
+<link linkend="Req-IDE-78">Additional structural members</link> (ver. 1)</simpara>
+    <simpara>
+</simpara>
+<simpara>It is only possible to add additional members to a type if use-site structural typing is used.</simpara>
+<simpara>The following constraints must hold:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>For all additional members defined in a structural type reference, the constraints for member overriding (<xref linkend="Req-IDE-72"/>) apply as well.</simpara>
+</listitem>
+<listitem>
+<simpara>All additional members have the access modifier set to <literal>public</literal>.</simpara>
+</listitem>
+<listitem>
+<simpara>Type variables must not be augmented with additional structural members.</simpara>
+</listitem>
+</orderedlist>
+<simpara>Additional fields may be declared optional in the same way as fields in classes.
+The rules given in <xref linkend="_structural-types-with-optional-fields"/> apply accordingly.
+Consider the following example:</simpara>
+</requirement>
+<example>
+<title>Additional optional members in structural typing</title>
+<programlisting language="n4js" linenumbering="unnumbered">class C {
+    public f1: number;
+}
+
+var c1: ~C with { f3: string; } c1;
+var c2: ~C with { f3: string?; } c2;
+
+c1 = { f1:42 };  // error: "~Object with { number f1; } is not a subtype of ~C with { string f3; }."
+c2 = { f1:42 };  // ok!!</programlisting>
+</example>
+<simpara>Augmenting a type variable T with additional structural members can cause collisions with another member of a type argument for T.
+Hence, type variables must not be augmented with additional structural members like in the following example.</simpara>
+<example>
+<title>Forbidden additional structural members on type variables</title>
+<programlisting language="n4js" linenumbering="unnumbered">interface I&lt;T&gt; {
+    public field : ~T with {prop : int} // error "No additional structural members allowed on type variables."
+}</programlisting>
+</example>
+<simpara>Using an additional structural member on a type variable T could be seen as a constraint to T.
+However, constraints like this should be rather stated using an explicit interface like in the example below.</simpara>
+<example>
+<title>Use explicitly defined Interfaces</title>
+<programlisting language="n4js" linenumbering="unnumbered">interface ~J {
+    prop : int;
+}
+interface II&lt;T extends J&gt; {
+}</programlisting>
+</example>
+</section>
+</section>
+</section>
+</section>
+</chapter>
+<chapter xml:id="_functions">
+<title>Functions</title>
+<simpara>Functions, be they function declarations, expressions or even methods, are internally modeled by means of a function type.
+In this chapter, the general function type is described along with its semantics and type constraints.
+Function definitions and expressions are then introduced in terms of statements and expressions.
+Method definitions and special usages are described in <xref linkend="_methods"/>.</simpara>
+<section xml:id="_function-type" role="language-n4js">
+<title>Function Type</title>
+<simpara>A function type is modeled as <literal>Object</literal> (see [<link linkend="ECMA11a">ECMA11a(p.S13, p.p.98)</link>] in ECMAScript.</simpara>
+<simpara>Function types can be defined by means of;</simpara>
+<itemizedlist>
+<listitem>
+<simpara>A function object (<xref linkend="_function-object-type"/>).</simpara>
+</listitem>
+<listitem>
+<simpara>A function type expression (<xref linkend="_type-expressions"/>).</simpara>
+</listitem>
+<listitem>
+<simpara>A function declaration (<xref linkend="_function-declaration"/>).</simpara>
+</listitem>
+<listitem>
+<simpara>A method declaration (<xref linkend="_methods"/>).</simpara>
+</listitem>
+</itemizedlist>
+<section xml:id="_properties-5">
+<title>Properties</title>
+<simpara>In any case, a function type declares the signature of a function and allows validation of calls to that function.
+A function type has the following properties:</simpara>
+<variablelist>
+<varlistentry>
+<term><literal>typePars</literal>  </term>
+<listitem>
+<simpara>(0-indexed) list of type parameters (i.e. type variables) for generic functions.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>fpars</literal>  </term>
+<listitem>
+<simpara>(0-indexed) list of formal parameters.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>returnType</literal> </term>
+<listitem>
+<simpara>(possibly inferred) return type (expression) of the function or method.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>name</literal> </term>
+<listitem>
+<simpara>Name of function or method, may be empty or automatically generated (for messages).</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>body</literal> </term>
+<listitem>
+<simpara>The body of the function, it contains statements <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>s</mi><mi>t</mi><mi>m</mi><mi>t</mi><mi>s</mi></math>.
+The body is null if a function type is defined in a type expression, and it is the last argument in case of a function object constructor, or the content of the function definition body.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+<simpara>Additionally, the following pseudo properties for functions are defined:</simpara>
+<variablelist>
+<varlistentry>
+<term><literal>thisTypeRef</literal> </term>
+<listitem>
+<simpara>The this type ref is the type to which the <literal>this</literal>-keyword would be evaluated
+if used inside the function or member. The inference rules are described
+in <xref linkend="_this-keyword"/>.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>fpars</literal> </term>
+<listitem>
+<simpara>List of formal parameters and the this type ref.
+This is only used for sub typing rules.
+If <literal>this</literal> is not used inside the function, then <literal>any</literal> is set instead of the inferred thisTypeRef to allow for more usages.
+The property is computed as follows:</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mi>t</mi><mi>f</mi><mi>p</mi><mi>a</mi><mi>r</mi><mi>s</mi><mo>=</mo><mstyle mathvariant="bold"><mtext>if</mtext></mstyle><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mspace width="3.0mm"/><mstyle mathvariant="bold"><mtext>this is used or explicitly declared</mtext></mstyle><mspace width="3.0mm"/><mstyle mathvariant="bold"><mtext>then</mtext></mstyle><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mi>t</mi><mi>h</mi><mi>i</mi><mi>s</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mo>+</mo><mi>f</mi><mi>p</mi><mi>a</mi><mi>r</mi><mi>s</mi><mspace width="3.0mm"/><mstyle mathvariant="bold"><mtext>else</mtext></mstyle><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mi>a</mi><mi>n</mi><mi>y</mi><mo>+</mo><mi>f</mi><mi>p</mi><mi>a</mi><mi>r</mi><mi>s</mi></math>
+</listitem>
+</varlistentry>
+</variablelist>
+<simpara>Parameters (in <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>p</mi><mi>a</mi><mi>r</mi><mi>s</mi></math>) have the following properties:</simpara>
+<variablelist>
+<varlistentry>
+<term><literal>name</literal> </term>
+<listitem>
+<simpara>Name of the parameter.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>type</literal> </term>
+<listitem>
+<simpara>Type (expression) of the parameter. Note that only parameter types can
+be variadic or optional.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+<simpara>The function definition can be annotated similar to <xref linkend="_methods"/> except that the <literal>final</literal> and <literal>abstract</literal> modifiers aren’t supported for function declarations.
+A function declaration is always final and never abstract.
+Also, a function has no property advice set.</simpara>
+<bridgehead xml:id="_semantics-7" renderas="sect3">Semantics</bridgehead>
+<requirement xml:id="IDE-79">
+<title>Function Type</title>
+<simpara>
+<anchor xml:id="Req-IDE-79" xreflabel="[Req-IDE-79]"/>
+<emphasis role="strong">Requirement: IDE-79:</emphasis>
+<link linkend="Req-IDE-79">Function Type</link> (ver. 1)</simpara>
+    <simpara>
+
+Type Given a function type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>F</mi></math>, the following constraints must be true:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>Optional parameters must be defined at the end of the (formal) parameter list.
+In particular, an optional parameter must not be followed by a non-optional parameter:</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mi>F</mi><mo>.</mo><mi>f</mi><mi>p</mi><mi>a</mi><mi>r</mi><msub><mi>s</mi><mi>i</mi></msub><mo>.</mo><mi>o</mi><mi>p</mi><mi>t</mi><mi>i</mi><mi>o</mi><mi>n</mi><mi>a</mi><mi>l</mi><mo>→</mo><mo>∄</mo><mi>k</mi><mo>&gt;</mo><mi>i</mi><mi>:</mi><mo>¬</mo><mi>F</mi><mo>.</mo><mi>f</mi><mi>p</mi><mi>a</mi><mi>r</mi><msub><mi>s</mi><mi>k</mi></msub><mo>.</mo><mi>o</mi><mi>p</mi><mi>t</mi><mi>v</mi><mi>a</mi><mi>r</mi></math>
+</listitem>
+<listitem>
+<simpara>Only the last parameter of a method may be defined as variadic parameter:</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mi>F</mi><mo>.</mo><mi>f</mi><mi>p</mi><mi>a</mi><mi>r</mi><msub><mi>s</mi><mi>i</mi></msub><mo>.</mo><mi>v</mi><mi>a</mi><mi>r</mi><mi>i</mi><mi>a</mi><mi>d</mi><mi>i</mi><mi>c</mi><mo>→</mo><mi>i</mi><mo>=</mo><mo>|</mo><mi>F</mi><mo>.</mo><mi>f</mi><mi>p</mi><mi>a</mi><mi>r</mi><mi>s</mi><mo>|</mo><mo>-</mo><mn>1</mn></math>
+</listitem>
+<listitem>
+<simpara>If a function explicitly defines a return type, the last statement of the transitive closure of statements of the body must be a return statement:</simpara>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>F</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mo>≠</mo><mi>U</mi><mi>n</mi><mi>d</mi><mi>e</mi><mi>f</mi><mi>i</mi><mi>n</mi><mi>e</mi><mi>d</mi><mo>→</mo></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mo>|</mo><mi>f</mi><mo>.</mo><mi>b</mi><mi>o</mi><mi>d</mi><mi>y</mi><mo>.</mo><mi>s</mi><mi>t</mi><mi>m</mi><mi>t</mi><mi>s</mi><mo>|</mo><mo>&gt;</mo><mn>0</mn></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∧</mo><mi>f</mi><mo>.</mo><mi>b</mi><mi>o</mi><mi>d</mi><mi>y</mi><mo>.</mo><mi>s</mi><mi>t</mi><mi>m</mi><mi>t</mi><msubsup><mi>s</mi><mrow><mo>|</mo><mi>f</mi><mo>.</mo><mi>b</mi><mi>o</mi><mi>d</mi><mi>y</mi><mo>.</mo><mi>s</mi><mi>t</mi><mi>m</mi><mi>t</mi><msup><mi>s</mi><mo>*</mo></msup><mo>|</mo><mo>-</mo><mn>1</mn></mrow><mo>*</mo></msubsup><mi>i</mi><mi>s</mi><mi>a</mi><mi> </mi><mstyle mathvariant="monospace"><mtext>ReturnStatement</mtext></mstyle></math></simpara>
+</listitem>
+<listitem>
+<simpara>If a function explicitly defines a return type, all return
+statements must return a type conform to that type:</simpara>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mi>F</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mo>≠</mo><mi>U</mi><mi>n</mi><mi>d</mi><mi>e</mi><mi>f</mi><mi>i</mi><mi>n</mi><mi>e</mi><mi>d</mi></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mo>⇔</mo></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mo>∀</mo><mi>r</mi><mo>∈</mo><mi>F</mi><mo>.</mo><mi>b</mi><mi>o</mi><mi>d</mi><mi>y</mi><mo>.</mo><mi>s</mi><mi>t</mi><mi>m</mi><mi>t</mi><mi>s</mi><mo>,</mo><mi>r</mi><mi> </mi><mi>i</mi><mi>s</mi><mi>a</mi><mi> </mi><mstyle mathvariant="monospace"><mtext>ReturnStatement</mtext></mstyle><mi>:</mi></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mi>r</mi><mo>.</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mo>≠</mo><mi>n</mi><mi>u</mi><mi>l</mi><mi>l</mi><mo>∧</mo><mrow><mo>[</mo><mspace width="-0.167em"/><mrow><mo>[</mo></mrow></mrow><mrow><mi>r</mi><mo>.</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi></mrow><mrow><mrow><mo>]</mo></mrow><mspace width="-0.167em"/><mo>]</mo></mrow><mo>&lt;</mo><mi>:</mi><mrow><mo>[</mo><mspace width="-0.167em"/><mrow><mo>[</mo></mrow></mrow><mrow><mi>F</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi></mrow><mrow><mrow><mo>]</mo></mrow><mspace width="-0.167em"/><mo>]</mo></mrow></math></simpara>
+</listitem>
+</orderedlist>
+</requirement>
+</section>
+<section xml:id="function-type-inference">
+<title>Type Inference</title>
+<definition xml:id="function_type_conformance_non_parameterized">
+<title>Function Type Conformance Non-Parameterized</title>
+<simpara>
+<anchor xml:id="function_type_conformance_non-parameterized" xreflabel="[function_type_conformance_non-parameterized]"/>
+<emphasis role="strong">Definition:</emphasis>
+<link linkend="function_type_conformance_non-parameterized">Function Type Conformance Non-Parameterized</link></simpara>
+<simpara>
+
+<emphasis>For the given non-parameterized function types</emphasis>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>F</mi><mrow><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi></mrow></msub></math> with
+<math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>F</mi><mrow><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi></mrow></msub><mo>.</mo><mi>t</mi><mi>f</mi><mi>p</mi><mi>a</mi><mi>r</mi><mi>s</mi><mo>=</mo><msub><mi>L</mi><mn>0</mn></msub><mo>,</mo><msub><mi>L</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><msub><mi>L</mi><mi>k</mi></msub></math> and
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mo>|</mo><msub><mi>F</mi><mrow><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi></mrow></msub><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>s</mi><mi>P</mi><mi>a</mi><mi>r</mi><mi>s</mi><mo>|</mo><mo>=</mo><mn>0</mn></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>F</mi><mrow><mi>r</mi><mi>i</mi><mi>g</mi><mi>h</mi><mi>t</mi></mrow></msub></math> with
+<math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>F</mi><mrow><mi>r</mi><mi>i</mi><mi>g</mi><mi>h</mi><mi>t</mi></mrow></msub><mo>.</mo><mi>t</mi><mi>f</mi><mi>p</mi><mi>a</mi><mi>r</mi><mi>s</mi><mo>=</mo><msub><mi>R</mi><mn>0</mn></msub><mo>,</mo><msub><mi>R</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><msub><mi>R</mi><mi>n</mi></msub></math> and
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mo>|</mo><msub><mi>F</mi><mrow><mi>r</mi><mi>i</mi><mi>g</mi><mi>h</mi><mi>t</mi></mrow></msub><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>s</mi><mi>P</mi><mi>a</mi><mi>r</mi><mi>s</mi><mo>|</mo><mo>=</mo><mn>0</mn></math>,<?asciidoc-br?>
+we say <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>F</mi><mrow><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi></mrow></msub></math> conforms to <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>F</mi><mrow><mi>r</mi><mi>i</mi><mi>g</mi><mi>h</mi><mi>t</mi></mrow></msub></math>,
+written as <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>F</mi><mrow><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi></mrow></msub><mo>&lt;</mo><mi>:</mi><msub><mi>F</mi><mrow><mi>r</mi><mi>i</mi><mi>g</mi><mi>h</mi><mi>t</mi></mrow></msub></math>, if and only if:</simpara>
+<itemizedlist>
+<listitem>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>F</mi><mrow><mi>r</mi><mi>i</mi><mi>g</mi><mi>h</mi><mi>t</mi></mrow></msub><mo>.</mo><mi>r</mi><mi>e</mi><mi>t</mi><mi>u</mi><mi>r</mi><mi>n</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>void</mtext></mstyle></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∨</mo><mfenced close=")" open="("><mrow><msub><mi>F</mi><mrow><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi></mrow></msub><mo>.</mo><mi>r</mi><mi>e</mi><mi>t</mi><mi>u</mi><mi>r</mi><mi>n</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>void</mtext></mstyle><mo>∧</mo><msub><mi>F</mi><mrow><mi>r</mi><mi>i</mi><mi>g</mi><mi>h</mi><mi>t</mi></mrow></msub><mo>.</mo><mi>o</mi><mi>p</mi><mi>t</mi></mrow></mfenced></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∨</mo><mrow><mo>(</mo><mrow><msub><mi>F</mi><mrow><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi></mrow></msub><mo>.</mo><mi>r</mi><mi>e</mi><mi>t</mi><mi>u</mi><mi>r</mi><mi>n</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi><mo>&lt;</mo><mi>:</mi><msub><mi>F</mi><mrow><mi>r</mi><mi>i</mi><mi>g</mi><mi>h</mi><mi>t</mi></mrow></msub><mo>.</mo><mi>r</mi><mi>e</mi><mi>t</mi><mi>u</mi><mi>r</mi><mi>n</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi><mo>∧</mo><mo>¬</mo><mfenced close=")" open="("><mrow><msub><mi>F</mi><mrow><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi></mrow></msub><mo>.</mo><mi>o</mi><mi>p</mi><mi>t</mi><mo>∧</mo><mo>¬</mo><msub><mi>F</mi><mrow><mi>r</mi><mi>i</mi><mi>g</mi><mi>h</mi><mi>t</mi></mrow></msub><mo>.</mo><mi>o</mi><mi>p</mi><mi>t</mi></mrow></mfenced><mo>)</mo></mrow></mrow></math></simpara>
+</listitem>
+<listitem>
+<simpara>if <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>k</mi><mo>≤</mo><mi>n</mi></math>:</simpara>
+<itemizedlist>
+<listitem>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∀</mo><mi> </mi><mi>i</mi><mo>,</mo><mn>1</mn><mo>≤</mo><mi>i</mi><mo>≤</mo><mi>k</mi><mi>:</mi><mfenced close=")" open="("><mrow><msub><mi>R</mi><mi>i</mi></msub><mo>.</mo><mi>o</mi><mi>p</mi><mi>t</mi><mo>→</mo><mfenced close=")" open="("><mrow><msub><mi>L</mi><mi>i</mi></msub><mo>.</mo><mi>o</mi><mi>p</mi><mi>t</mi><mo>∨</mo><msub><mi>L</mi><mi>i</mi></msub><mo>.</mo><mi>v</mi><mi>a</mi><mi>r</mi></mrow></mfenced></mrow></mfenced><mo>∧</mo><mfenced close=")" open="("><mrow><msub><mi>R</mi><mi>i</mi></msub><mo>.</mo><mi>v</mi><mi>a</mi><mi>r</mi><mo>→</mo><msub><mi>L</mi><mi>i</mi></msub><mo>.</mo><mi>v</mi><mi>a</mi><mi>r</mi></mrow></mfenced></math></simpara>
+</listitem>
+<listitem>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∀</mo><mi> </mi><mi>i</mi><mo>,</mo><mn>1</mn><mo>≤</mo><mi>i</mi><mo>≤</mo><mi>k</mi><mi>:</mi><msub><mi>L</mi><mi>i</mi></msub><mi>:</mi><mo>&gt;</mo><msub><mi>R</mi><mi>i</mi></msub></math></simpara>
+</listitem>
+<listitem>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>L</mi><mi>k</mi></msub><mo>.</mo><mi>v</mi><mi>a</mi><mi>r</mi><mo>=</mo><mi>t</mi><mi>r</mi><mi>u</mi><mi>e</mi><mo>→</mo><mo>∀</mo><mi> </mi><mi>i</mi><mo>,</mo><mi>k</mi><mo>&lt;</mo><mi>i</mi><mo>≤</mo><mi>n</mi><mi>:</mi><msub><mi>L</mi><mi>K</mi></msub><mi>:</mi><mo>&gt;</mo><msub><mi>R</mi><mi>i</mi></msub></math></simpara>
+<simpara>else (<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>k</mi><mo>&gt;</mo><mi>n</mi></math>):</simpara>
+</listitem>
+<listitem>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∀</mo><mi> </mi><mi>i</mi><mo>,</mo><mn>1</mn><mo>≤</mo><mi>i</mi><mo>≤</mo><mi>n</mi><mi>:</mi><mfenced close=")" open="("><mrow><msub><mi>R</mi><mi>i</mi></msub><mo>.</mo><mi>o</mi><mi>p</mi><mi>t</mi><mo>→</mo><mfenced close=")" open="("><mrow><msub><mi>L</mi><mi>i</mi></msub><mo>.</mo><mi>o</mi><mi>p</mi><mi>t</mi><mo>∨</mo><msub><mi>L</mi><mi>i</mi></msub><mo>.</mo><mi>v</mi><mi>a</mi><mi>r</mi></mrow></mfenced></mrow></mfenced><mo>∧</mo><mfenced close=")" open="("><mrow><msub><mi>R</mi><mi>i</mi></msub><mo>.</mo><mi>v</mi><mi>a</mi><mi>r</mi><mo>→</mo><msub><mi>L</mi><mi>i</mi></msub><mo>.</mo><mi>v</mi><mi>a</mi><mi>r</mi></mrow></mfenced></math></simpara>
+</listitem>
+<listitem>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∀</mo><mi> </mi><mi>i</mi><mo>,</mo><mn>1</mn><mo>≤</mo><mi>i</mi><mo>≤</mo><mi>n</mi><mi>:</mi><msub><mi>L</mi><mi>i</mi></msub><mi>:</mi><mo>&gt;</mo><msub><mi>R</mi><mi>i</mi></msub></math></simpara>
+</listitem>
+<listitem>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∀</mo><mi> </mi><mi>n</mi><mo>&lt;</mo><mi>i</mi><mo>≤</mo><mi>k</mi><mi>:</mi><msub><mi>L</mi><mi>i</mi></msub><mo>.</mo><mi>o</mi><mi>p</mi><mi>t</mi><mo>∨</mo><msub><mi>L</mi><mi>i</mi></msub><mo>.</mo><mi>v</mi><mi>a</mi><mi>r</mi></math></simpara>
+</listitem>
+<listitem>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>R</mi><mi>n</mi></msub><mo>.</mo><mi>v</mi><mi>a</mi><mi>r</mi><mo>=</mo><mi>t</mi><mi>r</mi><mi>u</mi><mi>e</mi><mo>→</mo><mo>∀</mo><mi> </mi><mi>i</mi><mo>,</mo><mi>n</mi><mo>&lt;</mo><mi>i</mi><mo>≤</mo><mi>k</mi><mi>:</mi><msub><mi>L</mi><mi>i</mi></msub><mi>:</mi><mo>&gt;</mo><msub><mi>R</mi><mi>n</mi></msub></math></simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+</itemizedlist>
+<simpara><xref linkend="cdVarianceFunctionChart"/> shows a simple example with the function type conformance relations.</simpara>
+<figure xml:id="cdVarianceFunctionChart">
+<title>Function Variance Chart</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/06_functions/fig/cdVarianceFunctionChart.svg" width="60%" scalefit="1"/>
+</imageobject>
+<textobject><phrase>cdVarianceFunctionChart</phrase></textobject>
+</mediaobject>
+</figure>
+<simpara><literal>{function()}</literal> <math xmlns="http://www.w3.org/1998/Math/MathML"><mo>&lt;</mo><mi>:</mi></math> <literal>{function(A)}</literal> <math xmlns="http://www.w3.org/1998/Math/MathML"><mo>&lt;</mo><mi>:</mi></math> <literal>{function(A, A)}</literal> might be surprising for Java programmers. However, in JavaScript it is
+possible to call a function with any number of arguments independently
+from how many formal parameters the function defines.</simpara>
+<simpara>If a function does not define a return type, <literal>any</literal> is assumed if at least one
+of the (indirectly) contained return statements contains an expression.
+Otherwise <literal>void</literal> is assumed. This is also true if there is an error due to
+other constraint violations.</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mtable><mtr><mtd><mspace width="3.0mm"/><mfrac><mrow><mi>b</mi><mi>i</mi><mi>n</mi><mi>d</mi><mi>s</mi><mfenced close=")" open="("><mi>f</mi><mi>F</mi></mfenced><mspace width="3.0mm"/><mi>F</mi><mo>.</mo><mi>r</mi><mi>e</mi><mi>t</mi><mi>u</mi><mi>r</mi><mi>n</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>null</mtext></mstyle><mspace width="3.0mm"/><mo>∃</mo><mi>r</mi><mo>∈</mo><mi>r</mi><mi>e</mi><mi>t</mi><mi>u</mi><mi>r</mi><mi>n</mi><mi>s</mi><mfenced close=")" open="("><mi>F</mi></mfenced><mi>:</mi><mi>r</mi><mo>.</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>e</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>o</mi><mi>n</mi><mo>≠</mo><mstyle mathvariant="monospace"><mtext>null</mtext></mstyle></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mi>f</mi><mstyle mathvariant="monospace"><mtext>’(’</mtext></mstyle><mi>a</mi><mi>r</mi><mi>g</mi><mi>l</mi><mi>i</mi><mi>s</mi><mi>t</mi><mi> </mi><mstyle mathvariant="monospace"><mtext>’)’</mtext></mstyle><mi>:</mi><mstyle mathvariant="monospace"><mtext>any</mtext></mstyle></mrow></mfrac></mtd></mtr><mtr><mtd><mspace width="3.0mm"/><mfrac><mrow><mi>b</mi><mi>i</mi><mi>n</mi><mi>d</mi><mi>s</mi><mfenced close=")" open="("><mi>f</mi><mi>F</mi></mfenced><mspace width="3.0mm"/><mi>F</mi><mo>.</mo><mi>r</mi><mi>e</mi><mi>t</mi><mi>u</mi><mi>r</mi><mi>n</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>null</mtext></mstyle><mspace width="3.0mm"/><mo>∀</mo><mi>r</mi><mo>∈</mo><mi>r</mi><mi>e</mi><mi>t</mi><mi>u</mi><mi>r</mi><mi>n</mi><mi>s</mi><mfenced close=")" open="("><mi>F</mi></mfenced><mi>:</mi><mi>r</mi><mo>.</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>e</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>o</mi><mi>n</mi><mo>≠</mo><mstyle mathvariant="monospace"><mtext>null</mtext></mstyle></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mi>f</mi><mstyle mathvariant="monospace"><mtext>’(’</mtext></mstyle><mi>a</mi><mi>r</mi><mi>g</mi><mi>l</mi><mi>i</mi><mi>s</mi><mi>t</mi><mi> </mi><mstyle mathvariant="monospace"><mtext>’)’</mtext></mstyle><mi>:</mi><mstyle mathvariant="monospace"><mtext>void</mtext></mstyle></mrow></mfrac></mtd></mtr></mtable></math>
+<simpara>with</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mtable><mtr><mtd><mspace width="3.0mm"/><mfrac><mrow><mfenced close="}" open="{"><mrow><mi>r</mi><mo>∈</mo><mi>F</mi><mo>.</mo><mi>b</mi><mi>o</mi><mi>d</mi><mi>y</mi><mo>.</mo><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>e</mi><mi>m</mi><mi>e</mi><mi>n</mi><mi>t</mi><mi>s</mi><mo>|</mo><mi>μ</mi><mfenced close=")" open="("><mi>r</mi></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>ReturnStatement</mtext></mstyle></mrow></mfenced><mo>∪</mo><munder><mo>⋃</mo><mrow><mi>s</mi><mo>∈</mo><mi>F</mi><mo>.</mo><mi>b</mi><mi>o</mi><mi>d</mi><mi>y</mi><mo>.</mo><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>e</mi><mi>m</mi><mi>e</mi><mi>n</mi><mi>t</mi><mi>s</mi></mrow></munder><mi>r</mi><mi>e</mi><mi>t</mi><mi>u</mi><mi>r</mi><mi>n</mi><mi>s</mi><mfenced close=")" open="("><mi>s</mi></mfenced></mrow><mrow><mi>r</mi><mi>e</mi><mi>t</mi><mi>u</mi><mi>r</mi><mi>n</mi><mi>s</mi><mfenced close=")" open="("><mi>F</mi></mfenced><mi>:</mi><mi>R</mi><mi>E</mi><mi>T</mi><mi>S</mi></mrow></mfrac></mtd></mtr><mtr><mtd><mspace width="3.0mm"/><mfrac><mrow><mfenced close="}" open="{"><mrow><mi>s</mi><mi>u</mi><mi>b</mi><mo>∈</mo><mi>s</mi><mo>.</mo><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>e</mi><mi>m</mi><mi>e</mi><mi>n</mi><mi>t</mi><mi>s</mi><mo>|</mo><mi>μ</mi><mfenced close=")" open="("><mrow><mi>s</mi><mi>u</mi><mi>b</mi></mrow></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>ReturnStatement</mtext></mstyle></mrow></mfenced><mo>∪</mo><munder><mo>⋃</mo><mrow><mi>s</mi><mi>u</mi><mi>b</mi><mo>∈</mo><mi>s</mi><mo>.</mo><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>e</mi><mi>m</mi><mi>e</mi><mi>n</mi><mi>t</mi><mi>s</mi></mrow></munder><mi>r</mi><mi>e</mi><mi>t</mi><mi>u</mi><mi>r</mi><mi>n</mi><mi>s</mi><mfenced close=")" open="("><mrow><mi>s</mi><mi>u</mi><mi>b</mi></mrow></mfenced></mrow><mrow><mi>r</mi><mi>e</mi><mi>t</mi><mi>u</mi><mi>r</mi><mi>n</mi><mi>s</mi><mfenced close=")" open="("><mi>s</mi></mfenced><mi>:</mi><mi>R</mi><mi>E</mi><mi>T</mi><mi>S</mi></mrow></mfrac></mtd></mtr></mtable></math>
+</definition>
+<example>
+<title>Function type conformance</title>
+<simpara>The following incomplete snippet demonstrates the usage of two function variables <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>f</mi><mn>1</mn></math> and <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>f</mi><mn>2</mn></math>, in which <math xmlns="http://www.w3.org/1998/Math/MathML"><mrow><mo>[</mo><mspace width="-0.167em"/><mrow><mo>[</mo></mrow></mrow><mrow><mi>f</mi><mn>2</mn></mrow><mrow><mrow><mo>]</mo></mrow><mspace width="-0.167em"/><mo>]</mo></mrow><mo>&lt;</mo><mi>:</mi><mrow><mo>[</mo><mspace width="-0.167em"/><mrow><mo>[</mo></mrow></mrow><mrow><mi>f</mi><mn>1</mn></mrow><mrow><mrow><mo>]</mo></mrow><mspace width="-0.167em"/><mo>]</mo></mrow></math> must hold true according to the aforementioned constraints.
+A function <literal>bar</literal> declares a parameter <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>f</mi><mn>1</mn></math>, which is actually a function itself.
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>f</mi><mn>2</mn></math> is a variable, to which a function expression is a assigned.
+Function <literal>bar</literal> is then called with <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>f</mi><mn>2</mn></math> as an argument.
+Thus, the type of <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>f</mi><mn>2</mn></math> must be a subtype of the <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>f</mi><mn>1</mn></math>’s type.</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">function bar(f1: {function(A,B):C}) { ... }
+
+var f2: {function(A,B):C} = function(p1,p2){...};
+bar(f1);</programlisting>
+</example>
+<simpara>The type of <literal>this</literal> can be explicitly set via the <literal>@This</literal> annotation.</simpara>
+<example>
+<title>Function Subtyping</title>
+<programlisting language="n4js" linenumbering="unnumbered">function f(): A {..}
+function p(): void {..}
+
+fAny(log: {function():any}) {...}
+fVoid(f: {function():void}) {..}
+fA(g: {function():A}) {...}
+
+fAny(f);    // --&gt; ok       A &lt;: any
+fVoid(f);   // --&gt;error     A !&lt;: void
+fA(f);      // --&gt; ok (easy)    A &lt;: A
+
+fAny(p);    // --&gt; ok       void &lt;: any
+fVoid(p);   // --&gt; ok       void &lt;: void
+fA(p);      // --&gt; error    void !&lt;: A</programlisting>
+</example>
+<example>
+<title>Subtyping with function types</title>
+<simpara>If classes A, B, and C are defined as previously mentioned, i.e. <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>C</mi><mo>&lt;</mo><mi>:</mi><mi>B</mi><mo>&lt;</mo><mi>:</mi><mi>A</mi></math>, then
+the following subtyping relations with function types are to be evaluated as follows:</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">       {function(B):B} &lt;: {function(B):B}           -&gt; true
+        {function():A} &lt;: {function():B}            -&gt; false
+        {function():C} &lt;: {function():B}            -&gt; true
+         {function(A)} &lt;: {function(B)}             -&gt; true
+         {function(C)} &lt;: {function(B)}             -&gt; false
+
+     {function():void} &lt;: {function():void}         -&gt; true
+{function():undefined} &lt;: {function():void}         -&gt; true
+     {function():void} &lt;: {function():undefined}    -&gt; true (!)
+
+        {function():B} &lt;: {function():void}         -&gt; true (!)
+        {function():B} &lt;: {function():undefined}    -&gt; false (!)
+     {function():void} &lt;: {function():B}            -&gt; false
+{function():undefined} &lt;: {function():B}            -&gt; true</programlisting>
+<simpara>The following examples demonstrate the effect of optional and variadic parameters:</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">{function(A)} &lt;: {function(B)}                      -&gt; true
+{function(A...)} &lt;: {function(A)}                   -&gt; true
+{function(A, A)} &lt;: {function(A)}                   -&gt; false
+{function(A)} &lt;: {function(A,A)}                    -&gt; true (!)
+{function(A, A...)} &lt;: {function(A)}                -&gt; true
+{function(A)} &lt;: {function(A,A...)}                 -&gt; true (!)
+{function(A, A...)} &lt;: {function(B)}                -&gt; true
+{function(A?)} &lt;: {function(A?)}                    -&gt; true
+{function(A...)} &lt;: {function(A...)}                -&gt; true
+{function(A?)} &lt;: {function(A)}                     -&gt; true
+{function(A)} &lt;: {function(A?)}                     -&gt; false
+{function(A...)} &lt;: {function(A?)}                  -&gt; true
+{function(A?)} &lt;: {function(A...)}                  -&gt; true (!)
+{function(A,A...)} &lt;: {function(A...)}              -&gt; false
+{function(A,A?)} &lt;: {function(A...)}                -&gt; false
+{function(A?,A...)} &lt;: {function(A...)}             -&gt; true
+{function(A...)} &lt;: {function(A?,A...)}             -&gt; true
+{function(A...)} &lt;: {function(A?)}                  -&gt; true
+{function(A?,A?)} &lt;: {function(A...)}               -&gt; true (!)
+{function(A?,A?,A?)} &lt;: {function(A...)}            -&gt; true (!)
+{function(A?)} &lt;: {function()}                      -&gt; true (!)
+{function(A...)} &lt;: {function()}                    -&gt; true (!)</programlisting>
+<simpara>The following examples demonstrate the effect of optional return types:</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">{function():void} &lt;: {function():void}              -&gt; true
+{function():X}    &lt;: {function():void}              -&gt; true
+{function():X?}   &lt;: {function():void}              -&gt; true
+{function():void} &lt;: {function():Y}                 -&gt; false
+{function():X}    &lt;: {function():Y}                 -&gt; X &lt;: Y
+{function():X?}   &lt;: {function():Y}                 -&gt; false (!)
+{function():void} &lt;: {function():Y?}                -&gt; true (!)
+{function():X}    &lt;: {function():Y?}                -&gt; X &lt;: Y
+{function():X?}   &lt;: {function():Y?}                -&gt; X &lt;: Y
+       {function():B?} &lt;: {function():undefined}    -&gt; false (!)
+{function():undefined} &lt;: {function():B?}           -&gt; true</programlisting>
+<simpara>The following examples show the effect of the <literal>@This</literal> annotation:</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">{@This(A) function():void} &lt;: {@This(X) function():void}    -&gt; false
+{@This(B) function():void} &lt;: {@This(A) function():void}    -&gt; false
+{@This(A) function():void} &lt;: {@This(B) function():void}    -&gt; true
+{@This(any) function():void} &lt;: {@This(X) function():void}  -&gt; true
+{function():void} &lt;: {@This(X) function():void}             -&gt; true
+{@This(A) function():void} &lt;: {@This(any) function():void}  -&gt; false
+{@This(A) function():void} &lt;: {function():void}             -&gt; false</programlisting>
+</example>
+<definition>
+<title>Function Type Conformance</title>
+<simpara>
+<anchor xml:id="function_type_conformance" xreflabel="[function_type_conformance]"/>
+<emphasis role="strong">Definition:</emphasis>
+<link linkend="function_type_conformance">Function Type Conformance</link></simpara>
+<simpara>
+
+For the given function types<?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>F</mi><mrow><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi></mrow></msub></math> with
+<math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>F</mi><mrow><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi></mrow></msub><mo>.</mo><mi>t</mi><mi>f</mi><mi>p</mi><mi>a</mi><mi>r</mi><mi>s</mi><mo>=</mo><msub><mi>L</mi><mn>0</mn></msub><mo>,</mo><msub><mi>L</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><msub><mi>L</mi><mi>k</mi></msub></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>F</mi><mrow><mi>r</mi><mi>i</mi><mi>g</mi><mi>h</mi><mi>t</mi></mrow></msub></math> with
+<math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>F</mi><mrow><mi>r</mi><mi>i</mi><mi>g</mi><mi>h</mi><mi>t</mi></mrow></msub><mo>.</mo><mi>t</mi><mi>f</mi><mi>p</mi><mi>a</mi><mi>r</mi><mi>s</mi><mo>=</mo><msub><mi>R</mi><mn>0</mn></msub><mo>,</mo><msub><mi>R</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><msub><mi>R</mi><mi>n</mi></msub></math>,<?asciidoc-br?>
+we say <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>F</mi><mrow><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi></mrow></msub></math> conforms to <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>F</mi><mrow><mi>r</mi><mi>i</mi><mi>g</mi><mi>h</mi><mi>t</mi></mrow></msub></math>, written as <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>F</mi><mrow><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi></mrow></msub><mo>&lt;</mo><mi>:</mi><msub><mi>F</mi><mrow><mi>r</mi><mi>i</mi><mi>g</mi><mi>h</mi><mi>t</mi></mrow></msub></math>, if and only if:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>if <math xmlns="http://www.w3.org/1998/Math/MathML"><mo>|</mo><msub><mi>F</mi><mrow><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi></mrow></msub><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>P</mi><mi>a</mi><mi>r</mi><mi>s</mi><mo>|</mo><mo>=</mo><mo>|</mo><msub><mi>F</mi><mrow><mi>r</mi><mi>i</mi><mi>g</mi><mi>h</mi><mi>t</mi></mrow></msub><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>P</mi><mi>a</mi><mi>r</mi><mi>s</mi><mo>|</mo><mo>=</mo><mn>0</mn></math>:</simpara>
+<itemizedlist>
+<listitem>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>F</mi><mrow><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi></mrow></msub><mo>&lt;</mo><mi>:</mi><msub><mi>F</mi><mrow><mi>r</mi><mi>i</mi><mi>g</mi><mi>h</mi><mi>t</mi></mrow></msub></math>
+(cf. <link linkend="function_type_conformance_non_parameterized">Function Type Conformance Non-Parameterized</link>)</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+<listitem>
+<simpara>else if<?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mo>|</mo><msub><mi>F</mi><mrow><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi></mrow></msub><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>P</mi><mi>a</mi><mi>r</mi><mi>s</mi><mo>|</mo><mo>&gt;</mo><mn>0</mn><mo>∧</mo><mo>|</mo><msub><mi>F</mi><mrow><mi>r</mi><mi>i</mi><mi>g</mi><mi>h</mi><mi>t</mi></mrow></msub><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>P</mi><mi>a</mi><mi>r</mi><mi>s</mi><mo>|</mo><mo>=</mo><mn>0</mn></math>:</simpara>
+<itemizedlist>
+<listitem>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∃</mo><mi>θ</mi><mi>:</mi><mfenced close=")" open="("><mrow><mi>Γ</mi><mo>←</mo><mi>θ</mi></mrow></mfenced><mo>⊢</mo><msub><mi>F</mi><mrow><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi></mrow></msub><mo>&lt;</mo><mi>:</mi><msub><mi>F</mi><mrow><mi>r</mi><mi>i</mi><mi>g</mi><mi>h</mi><mi>t</mi></mrow></msub></math> (cf. <link linkend="function_type_conformance_non_parameterized">Function Type Conformance Non-Parameterized</link> )</simpara>
+<simpara>(i.e. there exists a substitution <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>θ</mi></math> of type variables in <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>F</mi><mrow><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi></mrow></msub></math> so that after substitution it becomes a subtype of <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>F</mi><mrow><mi>r</mi><mi>i</mi><mi>g</mi><mi>h</mi><mi>t</mi></mrow></msub></math> as defined by <link linkend="function_type_conformance_non_parameterized">Function Type Conformance Non-Parameterized</link>)</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+<listitem>
+<simpara>else if <math xmlns="http://www.w3.org/1998/Math/MathML"><mo>|</mo><msub><mi>F</mi><mrow><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi></mrow></msub><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>P</mi><mi>a</mi><mi>r</mi><mi>s</mi><mo>|</mo><mo>=</mo><mo>|</mo><msub><mi>F</mi><mrow><mi>r</mi><mi>i</mi><mi>g</mi><mi>h</mi><mi>t</mi></mrow></msub><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>P</mi><mi>a</mi><mi>r</mi><mi>s</mi><mo>|</mo></math>:</simpara>
+<itemizedlist>
+<listitem>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>Γ</mi><mo>←</mo><mfenced close="}" open="{"><mrow><msubsup><mi>V</mi><mi>i</mi><mi>r</mi></msubsup><mo>←</mo><msubsup><mi>V</mi><mi>i</mi><mi>l</mi></msubsup><mo>|</mo><mn>0</mn><mo>≤</mo><mi>i</mi><mo>≤</mo><mi>n</mi></mrow></mfenced><mo>⊢</mo><msub><mi>F</mi><mrow><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi></mrow></msub><mo>&lt;</mo><mi>:</mi><msub><mi>F</mi><mrow><mi>r</mi><mi>i</mi><mi>g</mi><mi>h</mi><mi>t</mi></mrow></msub></math>
+( accordingly)</simpara>
+</listitem>
+<listitem>
+<simpara>-</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mtable><mtr><mtd><mo>∀</mo><mn>0</mn><mo>≤</mo><mi>i</mi><mo>≤</mo><mi>n</mi><mi>:</mi></mtd></mtr><mtr><mtd><mi>i</mi><mi>n</mi><mi>t</mi><mi>e</mi><mi>r</mi><mi>s</mi><mi>e</mi><mi>c</mi><mi>t</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><msubsup><mi>V</mi><mi>i</mi><mi>l</mi></msubsup><mo>.</mo><mstyle mathvariant="italic"><mi>u</mi><mi>p</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>B</mi><mi>o</mi><mi>u</mi><mi>n</mi><mi>d</mi><mi>s</mi></mstyle></mrow></mfenced><mi>:</mi><mo>&gt;</mo><mi>i</mi><mi>n</mi><mi>t</mi><mi>e</mi><mi>r</mi><mi>s</mi><mi>e</mi><mi>c</mi><mi>t</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><msubsup><mi>V</mi><mi>i</mi><mi>r</mi></msubsup><mo>.</mo><mstyle mathvariant="italic"><mi>u</mi><mi>p</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>B</mi><mi>o</mi><mi>u</mi><mi>n</mi><mi>d</mi><mi>s</mi></mstyle></mrow></mfenced></mtd></mtr></mtable></math>
+<simpara>with <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>F</mi><mrow><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi></mrow></msub><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>P</mi><mi>a</mi><mi>r</mi><mi>s</mi><mo>=</mo><msubsup><mi>V</mi><mn>0</mn><mi>l</mi></msubsup><mo>,</mo><msubsup><mi>V</mi><mn>1</mn><mi>l</mi></msubsup><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><msubsup><mi>V</mi><mi>n</mi><mi>l</mi></msubsup></math> and <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>F</mi><mrow><mi>r</mi><mi>i</mi><mi>g</mi><mi>h</mi><mi>t</mi></mrow></msub><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>P</mi><mi>a</mi><mi>r</mi><mi>s</mi><mo>=</mo><msubsup><mi>V</mi><mn>0</mn><mi>r</mi></msubsup><mo>,</mo><msubsup><mi>V</mi><mn>1</mn><mi>r</mi></msubsup><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><msubsup><mi>V</mi><mi>n</mi><mi>r</mi></msubsup></math><?asciidoc-br?>
+(i.e. we replace each type variable in <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>F</mi><mrow><mi>r</mi><mi>i</mi><mi>g</mi><mi>h</mi><mi>t</mi></mrow></msub></math> by the corresponding type variable at the same index in <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>F</mi><mrow><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi></mrow></msub></math>
+and check the constraints from <link linkend="function_type_conformance_non_parameterized">Function Type Conformance Non-Parameterized</link>  as if <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>F</mi><mrow><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi></mrow></msub></math> and <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>F</mi><mrow><mi>r</mi><mi>i</mi><mi>g</mi><mi>h</mi><mi>t</mi></mrow></msub></math> were non-parameterized functions and, in
+addition, the upper bounds on the left side need to be supertypes of the upper bounds on the right side).</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+</itemizedlist>
+</definition>
+<simpara>Note that the upper bounds on the left must be supertypes of the right-side upper bounds (for similar reasons why types of formal parameters on the left are
+required to be supertypes of the formal parameters’ types in ).
+Where a particular type variable is used, on co- or contra-variant position, is not relevant:</simpara>
+<example>
+<title>Bounded type variable at co-variant position in function type</title>
+<programlisting language="n4js" linenumbering="unnumbered">class A {}
+class B extends A {}
+
+class X {
+    &lt;T extends B&gt; m(): T { return null; }
+}
+class Y extends X {
+    @Override
+    &lt;T extends A&gt; m(): T { return null; }
+}</programlisting>
+<simpara>Method <literal>m</literal> in <literal>Y</literal> may return an <literal>A</literal>, thus breaking the contract of m in <literal>X</literal>, but only if it is parameterized to do so, which is not allowed for clients of <literal>X</literal>, only those of <literal>Y</literal>.
+Therefore, the override in the above example is valid.</simpara>
+</example>
+<simpara>The subtype relation for function types is also applied for method overriding to ensure that an overriding method’s signature conforms to that of the overridden method,
+see <xref linkend="Req-IDE-72"/> (applies to method comnsumption and implementation accordingly, see <xref linkend="Req-IDE-73"/> and <xref linkend="Req-IDE-74"/>).
+Note that this is very different from Java which is far more restrictive when checking overriding methods.
+As Java also supports method overloading: given two types <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>A</mi><mo>,</mo><mi>B</mi></math> with <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>B</mi><mo>&lt;</mo><mi>:</mi><mi>A</mi></math> and a super class method <literal>void m(B param)</literal>, it is valid to override <literal>m</literal> as <literal>void m(A param)</literal> in N4JS but not in Java.
+In Java this would be handled as method overloading and therefore an <literal>@Override</literal> annotation on <literal>m</literal> would produce an error.</simpara>
+<requirement xml:id="IDE-80">
+<title>Upper and Lower Bound of a Function Type</title>
+<simpara>
+<anchor xml:id="Req-IDE-80" xreflabel="[Req-IDE-80]"/>
+<emphasis role="strong">Requirement: IDE-80:</emphasis>
+<link linkend="Req-IDE-80">Upper and Lower Bound of a Function Type</link> (ver. 1)</simpara>
+    <simpara>
+
+The upper bound of a function type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>F</mi></math> is a function type with the lower bound types of the parameters and the upper bound of the return type:<?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>u</mi><mi>p</mi><mi>p</mi><mi>e</mi><mi>r</mi><mfenced close=")" open="("><mrow><mstyle mathvariant="monospace"><mtext>function</mtext></mstyle><mfenced close=")" open="("><msub><mi>P</mi><mn>1</mn></msub><mrow><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/></mrow><msub><mi>P</mi><mi>n</mi></msub></mfenced><mi>:</mi><mi>R</mi></mrow></mfenced><mi>:</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>function</mtext></mstyle><mfenced close=")" open="("><mrow><mi>l</mi><mi>o</mi><mi>w</mi><mi>e</mi><mi>r</mi><mfenced close=")" open="("><msub><mi>P</mi><mn>1</mn></msub></mfenced></mrow><mrow><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/></mrow><mrow><mi>l</mi><mi>o</mi><mi>w</mi><mi>e</mi><mi>r</mi><mfenced close=")" open="("><msub><mi>P</mi><mi>n</mi></msub></mfenced></mrow></mfenced><mi>:</mi><mi>u</mi><mi>p</mi><mi>p</mi><mi>e</mi><mi>r</mi><mfenced close=")" open="("><mi>R</mi></mfenced></math></simpara>
+<simpara>The lower bound of a function type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>F</mi></math> is a function type with the upper bound types of the parameters and the lower bound of the return type:<?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>l</mi><mi>o</mi><mi>w</mi><mi>e</mi><mi>r</mi><mfenced close=")" open="("><mrow><mstyle mathvariant="monospace"><mtext>function</mtext></mstyle><mfenced close=")" open="("><msub><mi>P</mi><mn>1</mn></msub><mrow><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/></mrow><msub><mi>P</mi><mi>n</mi></msub></mfenced><mi>:</mi><mi>R</mi></mrow></mfenced><mi>:</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>function</mtext></mstyle><mfenced close=")" open="("><mrow><mi>u</mi><mi>p</mi><mi>p</mi><mi>e</mi><mi>r</mi><mfenced close=")" open="("><msub><mi>P</mi><mn>1</mn></msub></mfenced></mrow><mrow><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/></mrow><mrow><mi>u</mi><mi>p</mi><mi>p</mi><mi>e</mi><mi>r</mi><mfenced close=")" open="("><msub><mi>P</mi><mi>n</mi></msub></mfenced></mrow></mfenced><mi>:</mi><mi>l</mi><mi>o</mi><mi>w</mi><mi>e</mi><mi>r</mi><mfenced close=")" open="("><mi>R</mi></mfenced></math></simpara>
+</requirement>
+</section>
+<section xml:id="_autoboxing-of-function-type">
+<title>Autoboxing of Function Type</title>
+<simpara>Function types, compared to other types like String, come only in on flavour: the Function object representation.
+There is no primitive function type.
+Nevertheless, for function type expressions and function declarations, it is possible to call the properties of Function object directly.
+This is similar to autoboxing for strings.</simpara>
+<formalpara>
+<title>Access of Function properties on functions</title>
+<para>
+<programlisting language="n4js" linenumbering="unnumbered">// function declaration
+var param: number = function(a,b){}.length // 2
+
+function a(x: number) : number { return x*x; }
+// function reference
+a.length; // 1
+
+// function variable
+var f = function(m,l,b){/*...*/};
+f.length; // 3
+
+class A {
+    s: string;
+    sayS(): string{ return this.s; }
+}
+
+var objA: A = new A();
+objA.s = "A";
+
+var objB = {s:"B"}
+
+// function variable
+var m = objA.sayS; // method as function, detached from objA
+var mA: {function(any)} = m.bind(objA); // bind to objA
+var mB: {function(any)} = m.bind(objB); // bind to objB
+
+m()  // returns: undefined
+mA() // returns: A
+mB() // returns: B
+
+m.call(objA,1,2,3);  // returns: A
+m.apply(objB,[1,2,3]); // returns: B
+m.toString(); // returns: function sayS(){ return this.s; }</programlisting>
+</para>
+</formalpara>
+</section>
+<section xml:id="_arguments-object">
+<title>Arguments Object</title>
+<simpara>A special arguments object is defined within the body of a function.
+It is accessible through the implicitly-defined local variable named ,
+unless it is shadowed by a local variable, a formal parameter or a
+function named <literal>arguments</literal> or in the rare case that the function itself is called ’arguments’ [<link linkend="ECMA11a">ECMA11a(p.S10.5, p.p.59)</link>].
+The argument object has array-like behavior even though it is not of type <literal>array</literal>:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>All actual passed-in parameters of the current execution context can be retrieved by <math xmlns="http://www.w3.org/1998/Math/MathML"><mn>0</mn><mo>-</mo><mi>b</mi><mi>a</mi><mi>s</mi><mi>e</mi><mi>d</mi></math> index access.</simpara>
+</listitem>
+<listitem>
+<simpara>The <literal>length</literal> property of the arguments object stores the actual number of passed-in arguments which may differ from the number of formally defined number of parameters <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>f</mi><mi>p</mi><mi>a</mi><mi>r</mi><mi>s</mi></math> of the containing function.</simpara>
+</listitem>
+<listitem>
+<simpara>It is possible to store custom values in the arguments object, even outside the original index boundaries.</simpara>
+</listitem>
+<listitem>
+<simpara>All obtained values from the arguments object are of type <literal>any</literal>.</simpara>
+</listitem>
+</itemizedlist>
+<simpara>In non-strict ES mode the <literal>callee</literal> property holds a reference to the function executed [<link linkend="ECMA11a">ECMA11a(p.S10.6, p.p.61)</link>].</simpara>
+<requirement xml:id="IDE-81">
+<title>Arguments.callee</title>
+<simpara>
+<anchor xml:id="Req-IDE-81" xreflabel="[Req-IDE-81]"/>
+<emphasis role="strong">Requirement: IDE-81:</emphasis>
+<link linkend="Req-IDE-81">Arguments.callee</link> (ver. 1)</simpara>
+    <simpara>
+
+In N4JS and in ES strict mode the use of <literal>arguments.callee</literal> is prohibited.</simpara>
+</requirement>
+<requirement xml:id="IDE-82">
+<title>Arguments as formal parameter name</title>
+<simpara>
+<anchor xml:id="Req-IDE-82" xreflabel="[Req-IDE-82]"/>
+<emphasis role="strong">Requirement: IDE-82:</emphasis>
+<link linkend="Req-IDE-82">Arguments as formal parameter name</link> (ver. 1)</simpara>
+    <simpara>
+
+In N4JS, the formal parameters of the function cannot be named <literal>arguments</literal>.
+This applies to all variable execution environments like field accessors (getter/setter, <xref linkend="_field-accessors-getter-setter"/>),
+methods (<xref linkend="_methods"/>) and constructors (<xref linkend="_constructor-and-classifier-type"/>), where <literal>FormalParameter</literal> type is used.</simpara>
+</requirement>
+<programlisting language="n4js" linenumbering="unnumbered">// regular function
+function a1(s1: string, n2: number) {
+    var l: number = arguments.length;
+    var s: string = arguments[0] as string;
+}
+
+class A {
+    // property access
+    get s(): string { return ""+arguments.length; } // 0
+    set s(n: number) { console.log( arguments.length ); }  // 1
+    // method
+    m(arg: string) {
+        var l: number = arguments.length;
+        var s: string = arguments[0]  as string;
+    }
+}
+
+// property access in object literals
+var x = {
+    a:5,
+    get b(): string {
+        return ""+arguments.length
+    }
+}
+
+// invalid:
+function z(){
+    arguments.length // illegal, see next lines
+    // define arguments to be a plain variable of type number:
+    var arguments: number = 4;
+}</programlisting>
+</section>
+</section>
+<section xml:id="_ecmascript-5-function-definition" role="language-n4js">
+<title>ECMAScript 5 Function Definition</title>
+<section xml:id="_function-declaration">
+<title>Function Declaration</title>
+<section xml:id="_syntax-9">
+<title>Syntax</title>
+<simpara>A function can be defined as described in [<link linkend="ECMA11a">ECMA11a(p.S13, p.p.98)</link>] and additional annotations can be specified.
+Since N4JS is based on [<link linkend="ECMA15a">ECMA15a</link>], the syntax contains constructs not available in [<link linkend="ECMA11a">ECMA11a</link>].
+The newer constructs defined only in [<link linkend="ECMA15a">ECMA15a</link>] and proposals already implemented in N4JS are described in <xref linkend="_ecmascript-2015-function-definition"/> and <xref linkend="_ecmascript-proposals-function-definition"/>.</simpara>
+<note>
+<simpara>In contrast to plain JavaScript, function declarations can be used in blocks in N4JS.
+This is only true, however, for N4JS files, not for plain JS files.</simpara>
+</note>
+<formalpara>
+<title>Syntax Function Declaration and Expression</title>
+<para>
+<programlisting language="xtext" linenumbering="unnumbered">FunctionDeclaration &lt;Yield&gt;:
+    =&gt; ({FunctionDeclaration}
+        annotations+=Annotation*
+        (declaredModifiers+=N4Modifier)*
+        -&gt; FunctionImpl &lt;Yield,Yield,Expression=false&gt;
+    ) =&gt; Semi?
+;
+
+
+fragment AsyncNoTrailingLineBreak *: (declaredAsync?='async' NoLineTerminator)?;
+
+fragment FunctionImpl&lt;Yield, YieldIfGenerator, Expression&gt;*:
+    'function'
+    (
+        generator?='*' FunctionHeader&lt;YieldIfGenerator,Generator=true&gt; FunctionBody&lt;Yield=true,Expression&gt;
+    |   FunctionHeader&lt;Yield,Generator=false&gt; FunctionBody&lt;Yield=false,Expression&gt;
+    )
+;
+
+fragment FunctionHeader&lt;Yield, Generator&gt;*:
+    TypeVariables?
+    name=BindingIdentifier&lt;Yield&gt;?
+    StrictFormalParameters&lt;Yield=Generator&gt;
+    (-&gt; ':' returnTypeRef=TypeRef)?
+;
+
+fragment FunctionBody &lt;Yield, Expression&gt;*:
+        &lt;Expression&gt; body=Block&lt;Yield&gt;
+    |   &lt;!Expression&gt; body=Block&lt;Yield&gt;?
+;</programlisting>
+</para>
+</formalpara>
+<simpara>Properties of the function declaration and expression are described in <xref linkend="_function-type"/>.</simpara>
+<simpara>For this specification, we introduce a supertype <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>F</mi><mi>u</mi><mi>n</mi><mi>c</mi><mi>t</mi><mi>i</mi><mi>o</mi><mi>n</mi><mi>D</mi><mi>e</mi><mi>f</mi><mi>i</mi><mi>n</mi><mi>i</mi><mi>t</mi><mi>i</mi><mi>o</mi><mi>n</mi></math> for both, <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>F</mi><mi>u</mi><mi>n</mi><mi>c</mi><mi>t</mi><mi>i</mi><mi>o</mi><mi>n</mi><mi>D</mi><mi>e</mi><mi>c</mi><mi>l</mi><mi>a</mi><mi>r</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>o</mi><mi>n</mi></math> and <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>F</mi><mi>u</mi><mi>n</mi><mi>c</mi><mi>t</mi><mi>i</mi><mi>o</mi><mi>n</mi><mi>E</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>e</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>o</mi><mi>n</mi></math>.
+This supertype contains all common properties of these two subtypes, that is, all properties of <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>F</mi><mi>u</mi><mi>n</mi><mi>c</mi><mi>t</mi><mi>i</mi><mi>o</mi><mi>n</mi><mi>E</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>e</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>o</mi><mi>n</mi></math>.</simpara>
+<example>
+<title>Function Declaration with Type Annotation</title>
+<programlisting language="n4js" linenumbering="unnumbered">// plain JS
+function f(p) { return p.length }
+// N4JS
+function f(p: string): number { return p.length }</programlisting>
+</example>
+</section>
+<section xml:id="_semantics-8">
+<title>Semantics</title>
+<simpara>A function defined in a class’s method (or method modifier) builder is a method, see <xref linkend="_methods"/> for details and additional constraints.
+The metatype of a function definition is function type (<xref linkend="_function-type"/>), as a function declaration is only a different syntax for creating a <literal>Function</literal> object.
+Constraints for function type are described in <xref linkend="_function-type"/>.
+Another consequence is that the inferred type of a function definition <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>f</mi><mi>d</mi><mi>e</mi><mi>c</mi><mi>l</mi></math> is simply its function type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>F</mi></math>.</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><mrow><mo>[</mo><mspace width="-0.167em"/><mrow><mo>[</mo></mrow></mrow><mrow><mi>f</mi><mi>d</mi><mi>e</mi><mi>c</mi><mi>l</mi></mrow><mrow><mrow><mo>]</mo></mrow><mspace width="-0.167em"/><mo>]</mo></mrow></mrow><mrow><mrow><mo>[</mo><mspace width="-0.167em"/><mrow><mo>[</mo></mrow></mrow><mi>F</mi><mrow><mrow><mo>]</mo></mrow><mspace width="-0.167em"/><mo>]</mo></mrow></mrow></mfrac></math>
+<simpara>Note that the type of a function definition is different from its return type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>f</mi><mo>.</mo><mi>d</mi><mi>e</mi><mi>c</mi><mi>l</mi></math>!</simpara>
+<requirement xml:id="IDE-83">
+<title>Function Declaration only on Top-Level</title>
+<simpara>
+<anchor xml:id="Req-IDE-83" xreflabel="[Req-IDE-83]"/>
+<emphasis role="strong">Requirement: IDE-83:</emphasis>
+<link linkend="Req-IDE-83">Function Declaration only on Top-Level</link> (ver. 1)</simpara>
+    <simpara>
+</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>In plain JavaScript, function declarations must only be located on top-level, that is they must not be nested in blocks.
+Since this is supported by most JavaScript engines, only a warning is issued.</simpara>
+</listitem>
+</orderedlist>
+</requirement>
+</section>
+</section>
+<section xml:id="_function-expression">
+<title>Function Expression</title>
+<simpara>A function expression [<link linkend="ECMA11a">ECMA11a(p.S11.2.5)</link>] is quite similar to a function declaration.
+Thus, most details are explained in <xref linkend="_ecmascript-5-function-definition"/>.</simpara>
+<section xml:id="function-expression-syntax">
+<title>Syntax</title>
+<programlisting language="xtext" linenumbering="unnumbered">FunctionExpression:
+         ({FunctionExpression}
+            FunctionImpl&lt;Yield=false,YieldIfGenerator=true,Expression=true&gt;
+         )
+;</programlisting>
+</section>
+<section xml:id="_semantics-and-type-inference">
+<title>Semantics and Type Inference</title>
+<simpara>In general, the inferred type of a function expression simply is the function type as described in <xref linkend="_function-type"/>.
+Often, the signature of a function expression is not explicitly specified but it can be inferred from the context.
+The following context information is used to infer the full signature:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>If the function expression is used on the right hand side of an assignment, the expected return type can be inferred from the left hand side.</simpara>
+</listitem>
+<listitem>
+<simpara>If the function expression is used as an argument in a call to another function, the full signature can be inferred from the corresponding type of the formal parameter declaration.</simpara>
+</listitem>
+</itemizedlist>
+<simpara>Although the signature of the function expression may be inferred from the formal parameter if the function expression is used as argument, this inference has some conceptual limitations.
+This is demonstrated in the next example.</simpara>
+<example>
+<title>Inference Of Function Expression’s Signature</title>
+<simpara>In general, <literal>{function():any}</literal> is a subtype of <literal>{function():void}</literal> (cf. <xref linkend="_function-type"/>).
+When the return type of a function expression is inferred, this relation is taken into account which may lead to unexpected results as shown in the following code snippet:</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">function f(cb: {function():void}) { cb() }
+f(function() { return 1; });</programlisting>
+<simpara>No error is issued: The type of the function expression actually is inferred to <literal>{function():any}</literal>, because there is a return statement with an expression.
+It is not inferred to <literal>{function():void}</literal>, even if the formal parameter of <literal>f</literal> suggests that.
+Due to the previously-stated relation <literal>{function():any} &lt;: {function():void}</literal> this is correct – the client (in this
+case function <literal>f</literal>) works perfectly well even if <literal>cb</literal> returns something.
+The contract of arguments states that the type of the argument is a subtype of the type of the formal parameter.
+This is what the inferencer takes into account!</simpara>
+</example>
+</section>
+</section>
+</section>
+<section xml:id="_ecmascript-2015-function-definition" role="language-n4js">
+<title>ECMAScript 2015 Function Definition</title>
+<section xml:id="_formal-parameters">
+<title>Formal Parameters</title>
+<simpara>Parameter handling has been significantly upgraded in ECMAScript 6.
+It now supports parameter default values, rest parameters (variadics) and destructuring.
+Formal parameters can be modified to be either default or variadic.
+In case a formal parameter has no modifier, it is called normal.
+Modified parameters also become optional.</simpara>
+<simpara>Modifiers of formal parameters such as default or rest are neither evaluated nor rewritten in the transpiler.</simpara>
+<section xml:id="Type_Modifiers_Optional">
+<title>Optional Parameters</title>
+<simpara>An optional formal parameter can be omitted when calling a function/method.
+An omitted parameter has the value <literal>undefined</literal>.
+In case the omitted parameter is variadic, the value is an empty array.</simpara>
+<simpara>Parameters can not be declared as optional explicitly.
+Instead, being optional is true when a parameter is declared as default or variadic.
+Note that any formal parameter that follows a default parameter is itself also a default thus an optional parameter.</simpara>
+</section>
+<section xml:id="Type_Modifiers_Default">
+<title>Default Parameters</title>
+<simpara>A default parameter value is specified for a parameter via an equals sign (<literal>=</literal>).
+If a caller doesn’t provide a value for the parameter, the default value is used.</simpara>
+<simpara>Default initializers of parameters are specified at a formal parameter of a function or method after the equal sign using an arbitrary initializer expression, such as <literal>var = "s"</literal>.
+However, this default initializer can be omitted.
+When a formal parameter has a declared type, the default initializer is specified at the end, such as: <literal>var : string = "s"</literal>.
+The initializer expression is only evaluated in case no actual argument is given for the formal parameter.
+Also, the initializer expression is evaluated when the actual argument value is <literal>undefined</literal>.</simpara>
+<simpara>Formal parameters become default parameters implicitly when they are preceded by an explicit default parameter.
+In such cases, the default initializer is <literal>undefined</literal>.</simpara>
+<requirement xml:id="IDE-14501">
+<title>Default parameters</title>
+<simpara>
+<anchor xml:id="Req-IDE-14501" xreflabel="[Req-IDE-14501]"/>
+<emphasis role="strong">Requirement: IDE-14501:</emphasis>
+<link linkend="Req-IDE-14501">Default parameters</link> (ver. 1)</simpara>
+    <simpara>
+
+Any normal parameter which is preceded by a default parameter also becomes a default parameter.
+Its initializer is <literal>undefined</literal>.</simpara>
+</requirement>
+<simpara>When a method is overwritten, its default parameters are not part of the overwriting method.
+Consequently, initializers of default parameters in abstract methods are obsolete.</simpara>
+</section>
+<section xml:id="Type_Modifiers_Variadic">
+<title>Variadic</title>
+<simpara>Variadic parameters are also called <emphasis>rest parameters</emphasis>.
+Marking a parameter as variadic indicates that method accepts a variable number of parameters.
+A variadic parameter implies that the parameter is also optional as the cardinality is defined as <math xmlns="http://www.w3.org/1998/Math/MathML"><mfenced close="]" open="["><mrow><mn>0.</mn><mo>.</mo><mo>*</mo></mrow></mfenced></math>.
+No further parameter can be defined after a variadic parameter.
+When no argument is given for a variadic parameter, an empty array is provided when using the parameter in the body of the function or method.</simpara>
+<requirement xml:id="IDE-16">
+<title>Variadic and optional parameters</title>
+<simpara>
+<anchor xml:id="Req-IDE-16" xreflabel="[Req-IDE-16]"/>
+<emphasis role="strong">Requirement: IDE-16:</emphasis>
+<link linkend="Req-IDE-16">Variadic and optional parameters</link> (ver. 1)</simpara>
+    <simpara>
+
+For a parameter <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>p</mi></math>, the following condition must hold:
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>p</mi><mo>.</mo><mi>v</mi><mi>a</mi><mi>r</mi><mo>→</mo><mi>p</mi><mo>.</mo><mi>o</mi><mi>p</mi><mi>t</mi></math>.</simpara>
+<simpara>A parameter can not be declared both variadic and with a default value.
+That is to say that one can either write <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>v</mi><mi>a</mi><mi>r</mi><mi>N</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo></math> (default) or <math xmlns="http://www.w3.org/1998/Math/MathML"><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mi>v</mi><mi>a</mi><mi>r</mi><mi>N</mi><mi>a</mi><mi>m</mi><mi>e</mi></math>, but not <math xmlns="http://www.w3.org/1998/Math/MathML"><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mi>v</mi><mi>a</mi><mi>r</mi><mi>N</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo></math>.</simpara>
+</requirement>
+<simpara>Declaring a variadic parameter of type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi></math> causes the type of the method parameter to become <literal>Array&lt;T&gt;</literal>.
+That is, declaring <literal>function(&#8230;&#8203;tags : string)</literal> causes <literal>tags</literal> to be an <literal>Array&lt;string&gt;</literal> and not just a scalar <literal>string</literal> value.</simpara>
+<simpara>To make this work at runtime, the compiler will generate code that constructs the <literal>parameter</literal> from the <literal>arguments</literal> parameter explicitly passed to the function.</simpara>
+<requirement xml:id="IDE-17">
+<title>Variadic at Runtime</title>
+<simpara>
+<anchor xml:id="Req-IDE-17" xreflabel="[Req-IDE-17]"/>
+<emphasis role="strong">Requirement: IDE-17:</emphasis>
+<link linkend="Req-IDE-17">Variadic at Runtime</link> (ver. 1)</simpara>
+    <simpara>
+</simpara>
+<simpara>At runtime, a variadic parameter is never set to undefined.
+Instead, the array may be empty.
+This must be true even if preceding parameters are optional and no arguments are passed at runtime.</simpara>
+</requirement>
+<simpara>For more constraints on using the variadic modifier, see <xref linkend="_function-object-type"/>.</simpara>
+</section>
+</section>
+<section xml:id="_generator-functions">
+<title>Generator Functions</title>
+<simpara>Generators come together with the <literal>yield</literal> expression and can play three roles:
+the role of an iterator (data producer), of an observer (data consumer), and a combined role which is called coroutines.
+When calling a generator function or method, the returned generator object of type <literal>Generator&lt;TYield,TReturn,TNext&gt;</literal> can be controlled by its methods
+(cf. [<link linkend="ECMA15a">ECMA15a(p.S14.4)</link>], also see [<link linkend="Kuizinas14a">Kuizinas14a</link>]).</simpara>
+<section xml:id="generator-functions-syntax">
+<title>Syntax</title>
+<simpara>Generator functions and methods differ from ordinary functions and methods only in the additional <literal>*</literal> symbol before the function or method name.
+The following syntax rules are extracted from the real syntax rules.
+They only display parts relevant to declaring a function or method as a generator.</simpara>
+<programlisting language="xtext" linenumbering="unnumbered">GeneratorFunctionDeclaration &lt;Yield&gt;:
+        (declaredModifiers+=N4Modifier)*
+        'function' generator?='*'
+        FunctionHeader&lt;YieldIfGenerator,Generator=true&gt;
+        FunctionBody&lt;Yield=true,Expression=false&gt;
+;
+
+GeneratorFunctionExpression:
+        'function' generator?='*'
+        FunctionHeader&lt;YieldIfGenerator,Generator=true&gt;
+        FunctionBody&lt;Yield=true,Expression=true&gt;
+;
+
+GeneratorMethodDeclaration:
+    annotations+=Annotation+ (declaredModifiers+=N4Modifier)* TypeVariables?
+    generator?='*' NoLineTerminator LiteralOrComputedPropertyName&lt;Yield&gt;
+    MethodParamsReturnAndBody&lt;Generator=true&gt;</programlisting>
+</section>
+<section xml:id="generator-functions-semantics">
+<title>Semantics</title>
+<simpara>The basic idea is to make code dealing with Generators easier to write and more readable without changing their functionality.
+Take this example:</simpara>
+<example xml:id="ex:two-simple-generator-functions">
+<title>Two simple generator functions</title>
+<programlisting language="n4js" linenumbering="unnumbered">// explicit form of the return type
+function * countTo(iMax:int) : Generator&lt;int,string,undefined&gt; {
+	for (int i=0; i&lt;=iMax; i++)
+		yield i;
+	return "finished";
+}
+val genObj1 = countTo(3);
+val values1 = [...genObj1]; // is [0,1,2,3]
+val lastObj1 = genObj1.next(); // is {value="finished",done=true}
+
+// shorthand form of the return type
+function * countFrom(start:int) : int {
+	for (int i=start; i&gt;=0; i--)
+		yield i;
+	return finished;
+}
+val genObj2 = countFrom(3);
+val values2 = [...genObj2]; // is [3,2,1,0]
+val lastObj2 = genObj2.next(); // is {value="finished",done=true}</programlisting>
+<simpara>In the example above, two generator functions are declared.
+The first declares its return type explicitly whereas the second uses a shorthand form.</simpara>
+</example>
+<simpara>Generator functions and methods return objects of the type <literal>Generator&lt;TYield,TReturn,TNext&gt;</literal> which is a subtype of the <literal>Iterable&lt;TYield&gt;</literal> and <literal>Iterator&lt;TYield&gt;</literal> interfaces.
+Moreover, it provides the methods <literal>throw(exception:any)</literal> and <literal>return(value:TNext?)</literal> for advanced control of the generator object.
+The complete interface of the generator class is given below.</simpara>
+<formalpara>
+<title>The generator class</title>
+<para>
+<programlisting language="n4js" linenumbering="unnumbered">public providedByRuntime interface Generator&lt;out TYield, out TReturn, in TNext&gt;
+	extends Iterable&lt;TYield&gt;, Iterator&lt;TYield&gt; {
+	public abstract next(value: TNext?): IteratorEntry&lt;TYield&gt;
+	public abstract [Symbol.iterator](): Generator&lt;TYield, TReturn, TNext&gt;
+	public abstract throw(exception: any): IteratorEntry&lt;TYield&gt;;
+	public abstract return(value: TNext?): IteratorEntry&lt;TReturn&gt;;
+}</programlisting>
+</para>
+</formalpara>
+<requirement xml:id="IDE-14370">
+<title>Modifier <literal>*</literal></title>
+<simpara>
+<anchor xml:id="Req-IDE-14370" xreflabel="[Req-IDE-14370]"/>
+<emphasis role="strong">Requirement: IDE-14370:</emphasis>
+<link linkend="Req-IDE-14370">Modifier `pass:[*]`</link> (ver. 1)</simpara>
+    <simpara>
+
+. <literal>*</literal> may be used on declared functions and methods, and for function expressions.
+.  A function or method <emphasis>f</emphasis> with a declared return type <emphasis>R</emphasis> that is declared <literal>*</literal> has an actual return type of <literal>Generator&lt;TYield,TReturn,TNext&gt;</literal>.
+.  A generator function or method can have no declared return type, a shorthand form of a return type or an explicitly declared return type.
+..  The explicitly declared return type is of the form <literal>Generator&lt;TYield,TReturn,TNext&gt;</literal> with the type variables:
+&#8230;&#8203;  <emphasis>TYield</emphasis> as the expected type of the yield expression argument,
+&#8230;&#8203;  <emphasis>TReturn</emphasis> as the expected type of the return expression, and
+&#8230;&#8203;  <emphasis>TNext</emphasis> as both the return type of the yield expression.
+..  The shorthand form only declares the type of <emphasis>TYield</emphasis> which implicitly translates to <literal>Generator&lt;TYield,TReturn,any&gt;</literal> as the return type.
+&#8230;&#8203;  The type <emphasis>TReturn</emphasis> is inferred to either <literal>undefined</literal> or <literal>any</literal> from the body.
+&#8230;&#8203;  In case the declared type is <literal>void</literal>, actual return type evaluates to <literal>Generator&lt;undefined,undefined,any&gt;</literal>.
+..  If no return type is declared, both <emphasis>TYield</emphasis> and <emphasis>TReturn</emphasis> are inferred from the body to either <literal>any</literal> or <literal>undefined</literal>. <emphasis>TNext</emphasis> is <literal>any</literal>.
+.  Given a generator function or method <emphasis>f</emphasis> with an actual return type <literal>Generator&lt;TYield,TReturn,TNext&gt;</literal>:
+..  all yield statements in <emphasis>f</emphasis> must have an expression of type <emphasis>TYield</emphasis>.
+..  all return statements in <emphasis>f</emphasis> must have an expression of type <emphasis>TReturn</emphasis>.
+.  Return statements in generator functions or methods are always optional.</simpara>
+</requirement>
+<requirement xml:id="IDE-14371">
+<title>Modifier <literal>yield</literal> and <literal>yield*</literal></title>
+<simpara>
+<anchor xml:id="Req-IDE-14371" xreflabel="[Req-IDE-14371]"/>
+<emphasis role="strong">Requirement: IDE-14371:</emphasis>
+<link linkend="Req-IDE-14371">Modifier `yield` and `yield*`</link> (ver. 1)</simpara>
+    <simpara>
+
+. <literal>yield</literal> and <literal>yield*</literal> may only be in body of generator functions or methods.
+. <literal>yield expr</literal> takes only expressions <emphasis>expr</emphasis> of type <emphasis>TYield</emphasis> in a generator function or methods with the actual type <literal>Generator&lt;TYield,TReturn,TNext&gt;</literal>.
+. The return type of the <literal>yield</literal> expression is <emphasis>TNext</emphasis>.
+. <literal>yield* fg()</literal> takes only iterators of type <literal>Iterator&lt;TYield&gt;</literal>, and generator functions or methods <emphasis>fg</emphasis> with the actual return type <literal>Generator&lt;? extends TYield,? extends TReturn,? super TNext&gt;</literal>.
+. The return type of the <literal>yield*</literal> expression is <emphasis>any</emphasis>, since a custom iterator could return an entry <literal>{done=true,value}</literal> and any value for the variable <literal>value</literal>.</simpara>
+</requirement>
+<simpara>Similar to <literal>async</literal> functions, shorthand and explicit form <literal>* function():int{};</literal> and <literal>* function():Generator&lt;int,TResult,any&gt;</literal> are equal,
+given that the inferred <emphasis>TResult</emphasis> of the former functions equals to <emphasis>TResult</emphasis> in the latter function).
+In other words, the return type of generator functions or methods is wrapped when it is not explicitly defined as <literal>Generator</literal> already.
+Thus, whenever a nested generator type is desired, it has to be defined explicitly.
+Consider the example below.</simpara>
+<formalpara>
+<title>Type variables with async methods.</title>
+<para>
+<programlisting language="n4js" linenumbering="unnumbered">class C&lt;T&gt; {
+	genFoo(): T{} // equals to genFoo(): Generator&lt;T, undefined, any&gt;;
+				// note that TResult depends on the body of genFoo()
+}
+function fn(C&lt;int&gt; c1, C&lt;Generator&lt;int,any,any&gt;&gt; c2) {
+	c1.genFoo();  // returns Generator&lt;int, undefined, any&gt;
+	c2.genFoo();  // returns Generator&lt;Generator&lt;int,any,any&gt;, undefined, any&gt;
+}</programlisting>
+</para>
+</formalpara>
+</section>
+<section xml:id="_generator-arrow-functions">
+<title>Generator Arrow Functions</title>
+<simpara>As of now, generator arrow functions are not supported by EcmaScript 6 and also, the support is not planned.
+However, introducing generator arrow function in EcmaScript is still under discussion.
+For more information, please refer to <link xl:href="https://esdiscuss.org/topic/generator-arrow-functions">ESDiscuss.org</link> and <link xl:href="https://esdiscuss.org/topic/why-do-generator-expressions-return-generators">StackOverflow.com</link>.</simpara>
+</section>
+</section>
+<section xml:id="_arrow-function-expression">
+<title>Arrow Function Expression</title>
+<simpara>This is an ECMAScript 6 expression (see [<link linkend="ECMA15a">ECMA15a(p.S14.2)</link>]) for simplifying the definition of anonymous function expressions, a.k.a. lambdas or closures.
+The ECMAScript Specification calls this a function definition even though they may only appear in the context of expressions.</simpara>
+<simpara>Along with Assignments, Arrow function expressions have the least precedence, e.g. they serve as the entry point for the expression tree.</simpara>
+<simpara>Arrow function expressions can be considered syntactic window-dressing for old-school function expressions and therefore do not support the
+benefits regarding parameter annotations although parameter types may be given explicitly.
+The return type can be given as type hint if desired, but this is not mandatory (if left out, the return type is inferred).
+The notation <literal>@=></literal> stands for an async arrow function (<xref linkend="_asynchronous-arrow-functions"/>).</simpara>
+<section xml:id="arrow-function-expression-syntax">
+<title>Syntax</title>
+<simpara>The simplified syntax reads like this:</simpara>
+<programlisting language="xtext" linenumbering="unnumbered">ArrowExpression returns ArrowFunction:
+    =&gt;(
+        {ArrowFunction}
+        (
+            '('
+                ( fpars+=FormalParameterNoAnnotations ( ',' fpars+=FormalParameterNoAnnotations )* )?
+            ')'
+            (':' returnTypeRef=TypeRef)?
+        |   fpars+=FormalParameterNoType
+        )
+        '=&gt;'
+    ) (
+        (=&gt; hasBracesAroundBody?='{' body=BlockMinusBraces '}') | body=ExpressionDisguisedAsBlock
+    )
+;
+
+FormalParameterNoAnnotations returns FormalParameter:
+    (declaredTypeRef=TypeRef variadic?='...'?)? name=JSIdentifier
+;
+FormalParameterNoType returns FormalParameter: name=JSIdentifier;
+
+BlockMinusBraces returns Block: {Block} statements+=Statement*;
+
+ExpressionDisguisedAsBlock returns Block:
+    {Block} statements+=AssignmentExpressionStatement
+;
+
+AssignmentExpressionStatement returns ExpressionStatement: expression=AssignmentExpression;</programlisting>
+</section>
+<section xml:id="arrow-function-expression-semantics-and-type-inference">
+<title>Semantics and Type Inference</title>
+<simpara>Generally speaking, the semantics are very similar to the function
+expressions but the devil’s in the details:</simpara>
+<itemizedlist>
+<listitem>
+<simpara><literal>arguments</literal>: Unlike normal function expressions, an arrow function does not introduce an implicit <literal>arguments</literal> variable (<xref linkend="_arguments-object"/>),
+therefore any occurrence of it in the arrow function’s body has always the same binding as an occurrence of <literal>arguments</literal> in the lexical context enclosing the arrow function.</simpara>
+</listitem>
+<listitem>
+<simpara><literal>this</literal>: An arrow function does not introduce a binding of its own for the <literal>this</literal> keyword. That explains why uses in the body of arrow function have the same meaning as occurrences in the enclosing lexical scope.
+As a consequence, an arrow function at the top level has both usages of <literal>arguments</literal> and <literal>this</literal> flagged as error (the outer lexical context doesn’t provide definitionsfor them).</simpara>
+</listitem>
+<listitem>
+<simpara><literal>super</literal>: As with function expressions in general, whether of the arrow variety or not, the usage of <literal>super</literal> isn’t allowed in the body of arrow functions.</simpara>
+</listitem>
+</itemizedlist>
+<requirement xml:id="IDE-84">
+<title>No This in Top Level Arrow Function in N4JS Mode</title>
+<simpara>
+<anchor xml:id="Req-IDE-84" xreflabel="[Req-IDE-84]"/>
+<emphasis role="strong">Requirement: IDE-84:</emphasis>
+<link linkend="Req-IDE-84">No This in Top Level Arrow Function in N4JS Mode</link> (ver. 1)</simpara>
+    <simpara>
+
+In N4JS, a top-level arrow function can’t refer to <literal>this</literal> as there’s no outer lexical context that provides a binding for it.</simpara>
+</requirement>
+<requirement xml:id="IDE-85">
+<title>No Arguments in Top Level Arrow Function</title>
+<simpara>
+<anchor xml:id="Req-IDE-85" xreflabel="[Req-IDE-85]"/>
+<emphasis role="strong">Requirement: IDE-85:</emphasis>
+<link linkend="Req-IDE-85">No Arguments in Top Level Arrow Function</link> (ver. 1)</simpara>
+    <simpara>
+
+In N4JS, a top-level arrow function can’t include usages of <literal>arguments</literal> in its body, again because of the missing binding for it.</simpara>
+</requirement>
+</section>
+</section>
+</section>
+<section xml:id="_ecmascript-proposals-function-definition" role="language-n4js">
+<title>ECMAScript Proposals Function Definition</title>
+<section xml:id="_asynchronous-functions">
+<title>Asynchronous Functions</title>
+<simpara>To improve language-level support for asynchronous code, there exists an ECMAScript proposal <footnote><simpara>see <link xl:href="http://tc39.github.io/ecmascript-asyncawait/">http://tc39.github.io/ecmascript-asyncawait/</link></simpara></footnote> based on Promises which are provided by ES6 as built-in types.
+N4JS implements this proposal.
+This concept is supported for declared functions and methods (<xref linkend="_asynchronous-methods"/>) as well
+as for function expressions and arrow functions (<xref linkend="_asynchronous-arrow-functions"/>).</simpara>
+<section xml:id="asynchronous-functions-syntax">
+<title>Syntax</title>
+<simpara>The following syntax rules are extracted from the real syntax rules.
+They only display parts relevant to declaring a function or method as
+asynchronous.</simpara>
+<programlisting language="xtext" linenumbering="unnumbered">AsyncFunctionDeclaration &lt;Yield&gt;:
+        (declaredModifiers+=N4Modifier)*
+        declaredAsync?='async' NoLineTerminator 'function'
+        FunctionHeader&lt;Yield,Generator=false&gt;
+        FunctionBody&lt;Yield=false,Expression=false&gt;
+;
+
+AsyncFunctionExpression:
+        declaredAsync?='async' NoLineTerminator 'function'
+        FunctionHeader&lt;Yield=false,Generator=false&gt;
+        FunctionBody&lt;Yield=false,Expression=true&gt;
+;
+
+AsyncArrowExpression &lt;In, Yield&gt;:
+        declaredAsync?='async' NoLineTerminator '('
+            (fpars+=FormalParameter&lt;Yield&gt;
+                (',' fpars+=FormalParameter&lt;Yield&gt;)*)?
+        ')' (':' returnTypeRef=TypeRef)? '=&gt;'
+        (   '{' body=BlockMinusBraces&lt;Yield&gt; '}'
+            | body=ExpressionDisguisedAsBlock&lt;In&gt;
+        )
+;
+
+AsyncMethodDeclaration:
+    annotations+=Annotation+ (declaredModifiers+=N4Modifier)* TypeVariables?
+    declaredAsync?='async' NoLineTerminator LiteralOrComputedPropertyName&lt;Yield&gt;
+    MethodParamsReturnAndBody</programlisting>
+<simpara>’async’ is not a reserved word in ECMAScript and it can therefore be
+used either as an identifier or as a keyword, depending on the context.
+When used as a modifier to declare a function as asynchronous, then
+there must be no line terminator after the <literal>async</literal> modifier. This enables the
+parser to distinguish between using <literal>async</literal> as an identifier reference and a
+keyword, as shown in the next example.</simpara>
+<example>
+<title>Async as keyword and identifier</title>
+<programlisting language="n4js" linenumbering="unnumbered">async <co xml:id="CO2-1"/>
+function foo() {}
+// vs
+async function bar(); <co xml:id="CO2-2"/></programlisting>
+<calloutlist>
+<callout arearefs="CO2-1">
+<para>In this snippet, the <literal>async</literal> on line 1 is an identifier reference (referencing a
+variable or parameter) and the function defined on line 2 is a
+non-asynchronous function. The automatic semicolon insertion adds a
+semicolon after the reference on line 1.</para>
+</callout>
+<callout arearefs="CO2-2">
+<para>In contrast, <literal>async</literal> on line 4 is recognized as a modifier declaring the function as asynchronous.</para>
+</callout>
+</calloutlist>
+</example>
+</section>
+<section xml:id="asynchronous-functions-semantics">
+<title>Semantics</title>
+<simpara>The basic idea is to make code dealing with Promises easier to write and
+more readable without changing the functionality of Promises. Take this
+example:</simpara>
+<formalpara>
+<title>A simple asynchronous function using async/await.</title>
+<para>
+<programlisting language="n4js" linenumbering="unnumbered">// some asynchronous legacy API using promises
+interface DB {}
+interface DBAccess {
+    getDataBase(): Promise&lt;DB,?&gt;
+    loadEntry(db: DB, id: string): Promise&lt;string,?&gt;
+}
+
+var access: DBAccess;
+
+// our own function using async/await
+async function loadAddress(id: string) : string {
+    try {
+        var db: DB = await access.getDataBase();
+        var entry: string = await access.loadEntry(db, id);
+        return entry.address;
+    }
+    catch(err) {
+        // either getDataBase() or loadEntry() failed
+        throw err;
+    }
+}</programlisting>
+</para>
+</formalpara>
+<simpara>The modifier <literal>async</literal> changes the return type of <literal>loadAddress()</literal> from <literal>string</literal> (the declared return type) to <literal>Promise&lt;string,?&gt;</literal> (the actual return type).
+For code inside the function, the return type is still <literal>string</literal>:
+the value in the return statement of the last line will be wrapped in a Promise.
+For client code outside the function and in case of recursive invocations, the return type is <literal>Promise&lt;string,?&gt;</literal>.
+To raise an error, simply throw an exception, its value will become the error value of the returned Promise.</simpara>
+<simpara>If the expression after an <literal>await</literal> evaluates to a <literal>Promise</literal>, execution of the enclosing asynchronous function will be suspended until either a success value is available
+(which will then make the entire await-expression evaluate to this success value and continue execution)
+or until the Promise is rejected (which will then cause an exception to be thrown at the location of the await-expression).
+If, on the other hand, the expression after an <literal>await</literal> evaluates to a non-promise, the value will be simply passed through.
+In addition, a warning is shown to indicate the unnecessary <literal>await</literal> expression.</simpara>
+<simpara>Note how method <literal>loadAddress()</literal> above can be implemented without any explicit references to the built-in type Promise.
+In the above example we handle the errors of the nested asynchronous calls to <literal>getDataBase()</literal> and <literal>loadEntry()</literal> for demonstration purposes only;
+if we are not interested in the errors we could simply remove the try/catch block and any errors would be forwarded to the caller of <literal>loadAddress()</literal>.</simpara>
+<simpara>Invoking an async function commonly adopts one of two forms:</simpara>
+<itemizedlist>
+<listitem>
+<simpara><literal>var p: Promise&lt;successType,?&gt; = asyncFn()</literal></simpara>
+</listitem>
+<listitem>
+<simpara><literal>await asyncFn()</literal></simpara>
+</listitem>
+</itemizedlist>
+<simpara>These patterns are so common that a warning is available whenever both</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara><literal>Promise</literal> is omitted as expected type; and</simpara>
+</listitem>
+<listitem>
+<simpara><literal>await</literal> is also omitted.</simpara>
+</listitem>
+</orderedlist>
+<simpara>The warning aims at hinting about forgetting to wait for the result, while remaining non-noisy.</simpara>
+<requirement xml:id="IDE-86">
+<title>Modifier <literal>async</literal> and <literal>await</literal></title>
+<simpara>
+<anchor xml:id="Req-IDE-86" xreflabel="[Req-IDE-86]"/>
+<emphasis role="strong">Requirement: IDE-86:</emphasis>
+<link linkend="Req-IDE-86">Modifier `async` and `await`</link> (ver. 1)</simpara>
+    <simpara>
+</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara><literal>async</literal> may be used on declared functions and methods as well as for function expressions and arrow functions.</simpara>
+</listitem>
+<listitem>
+<simpara>A function or method that is declared <literal>async</literal> can have no declared return type, a shorthand form of a return type or an explicitly declared return type.</simpara>
+<orderedlist numeration="loweralpha">
+<listitem>
+<simpara>The explicitly declared return type is of the form <literal>Promise&lt;R,E&gt;</literal> where <emphasis>R</emphasis> is the type of all return statements in the body, and E is the type of exceptions that are thrown in the body.</simpara>
+</listitem>
+<listitem>
+<simpara>The shorthand form only declares the type of <emphasis>R</emphasis> which implicitly translates to <literal>Promise&lt;R,?&gt;</literal> as the actual return type.</simpara>
+</listitem>
+<listitem>
+<simpara>In case no return type is declared, the type <emphasis>R</emphasis> of <literal>Promise&lt;R,?&gt;</literal> is inferred from the body.</simpara>
+</listitem>
+</orderedlist>
+</listitem>
+<listitem>
+<simpara>A function or method <emphasis>f</emphasis> with a declared return type <emphasis>R</emphasis> that is declared <literal>async</literal> has an actual return type of</simpara>
+<orderedlist numeration="loweralpha">
+<listitem>
+<simpara><literal>R</literal> if <emphasis>R</emphasis> is a subtype of <literal>Promise&lt;?,?&gt;</literal>,</simpara>
+</listitem>
+<listitem>
+<simpara><literal>Promise&lt;undefined,?&gt;</literal> if <emphasis>R</emphasis> is type <literal>void</literal>.</simpara>
+</listitem>
+<listitem>
+<simpara><literal>Promise&lt;R,?&gt;</literal> in all other cases (i.e. the declared return type <emphasis>R</emphasis> is being wrapped in a <literal>Promise</literal>).</simpara>
+</listitem>
+</orderedlist>
+</listitem>
+<listitem>
+<simpara>Return type inference is only performed when no return type is declared.</simpara>
+<orderedlist numeration="loweralpha">
+<listitem>
+<simpara>The return type <literal>R</literal> of <literal>Promise&lt;R,?&gt;</literal> is inferred either as <literal>void</literal> or as <literal>any</literal>.</simpara>
+</listitem>
+</orderedlist>
+</listitem>
+<listitem>
+<simpara>Given a function or method <emphasis>f</emphasis> that is declared <literal>async</literal> with a declared return type <emphasis>R</emphasis>, or with a declared return type <literal>Promise&lt;R,?&gt;</literal>,
+all return statements in <emphasis>f</emphasis> must have an expression of type <emphasis>R</emphasis> (and not of type <literal>Promise&lt;R,?&gt;</literal>).</simpara>
+</listitem>
+<listitem>
+<simpara><literal>await</literal> can be used in expressions directly enclosed in an async function, and behaves like a unary operator with the same precedence as <literal>yield</literal> in ES6.</simpara>
+</listitem>
+<listitem>
+<simpara>Given an expression <emphasis>expr</emphasis> of type
+<emphasis>T</emphasis>, the type of (<literal>await</literal> <emphasis>expr</emphasis>) is inferred to <emphasis>T</emphasis> if
+<emphasis>T</emphasis> is not a Promise, or it is inferred to <emphasis>S</emphasis> if
+<emphasis>T</emphasis> is a Promise with a success value of type
+<emphasis>S</emphasis>, i.e. <emphasis>T &lt;: Promise&lt;S,?&gt;</emphasis> .</simpara>
+</listitem>
+</orderedlist>
+</requirement>
+<simpara>In other words, the return type <emphasis>R</emphasis> of <literal>async</literal> functions and methods will always be wrapped to <literal>Promise&lt;R,?&gt;</literal> unless <emphasis>R</emphasis> is a <literal>Promise</literal> already.
+As a consequence, nested <literal>Promise</literal>s as a return type of a async function or method have to be stated explicitly like <literal>Promise&lt;Promise&lt;R,?&gt;,?&gt;</literal>.</simpara>
+<simpara>When a type variable <literal>T</literal> is used to define the the return type of an async function or method, it will always be wrapped.
+Consider the example below.</simpara>
+<example>
+<title>Type variables with async methods.</title>
+<programlisting language="n4js" linenumbering="unnumbered">interface I&lt;T&gt; {
+	async foo(): T;  // amounts to foo(): Promise&lt;T,?&gt;
+}
+function snafu(i1: I&lt;int&gt;, i2: I&lt;Promise&lt;int,?&gt;&gt;) {
+	i1.foo();  // returns Promise&lt;int,?&gt;
+	i2.foo();  // returns Promise&lt;Promise&lt;int,?&gt;,?&gt;
+}</programlisting>
+</example>
+</section>
+<section xml:id="_asynchronous-arrow-functions">
+<title>Asynchronous Arrow Functions</title>
+<simpara>An <literal>await</literal> expression is allowed in the body of an async arrow function but not
+in the body of a non-async arrow function. The semantics here are
+intentional and are in line with similar constraint for function
+expressions.</simpara>
+</section>
+</section>
+</section>
+<section xml:id="_n4js-extended-function-definition" role="language-n4js">
+<title>N4JS Extended Function Definition</title>
+<section xml:id="_generic-functions">
+<title>Generic Functions</title>
+<simpara>A generic function is a function with a list of generic type parameters.
+These type parameters can be used in the function signature to declare the types of formal parameters and the return type.
+In addition, the type parameters can be used in the function body, for example when declaring the type of a local variable.</simpara>
+<simpara>In the following listing, a generic function <literal>foo</literal> is defined that has two type parameters <literal>S</literal> and <literal>T</literal>.
+Thereby <literal>S</literal> is used as to declare the parameter type <literal>Array&lt;S&gt;</literal> and <literal>T</literal> is used as the return type and to construct the returned value in the function body.</simpara>
+<formalpara>
+<title>Generic Function Definition</title>
+<para>
+<programlisting language="n4js" linenumbering="unnumbered">function &lt;S,T&gt; foo(s: Array&lt;S&gt;): T { return new T(s); }</programlisting>
+</para>
+</formalpara>
+<simpara>If a generic type parameter is not used as a formal parameter type or
+the return type, a warning is generated.</simpara>
+</section>
+<section xml:id="_promisifiable-functions">
+<title>Promisifiable Functions</title>
+<simpara>In many existing libraries, which have been developed in pre-ES6-promise-API times, callback methods are used for asynchronous behavior.
+An asynchronous function follows the following conventions:</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">'function' name '(' arbitraryParameters ',' callbackFunction ')'</programlisting>
+<simpara>Usually the function returns nothing (<literal>void</literal>).
+The callback function usually takes two arguments,in which the first is an error object and the other is the result value of the asynchronous operation.
+The callback function is called from the asynchronous function, leading to nested function calls (aka ’callback hell’).</simpara>
+<simpara>In order to simplify usage of this pattern, it is possible to mark such a function or method as <literal>@Promisifiable</literal>.
+It is then possible to ’promisify’ an invocation of this function or method, which means no callback function argument has to be provided and a will be returned.
+The function or method can then be used as if it were declared with <literal>async</literal>.
+This is particularly useful in N4JS definition files (.n4jsd) to allow using an existing callback-based API from N4JS code with the more convenient <literal>await</literal>.</simpara>
+<example>
+<title>Promisifiable</title>
+<simpara>Given a function with an N4JS signature</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">f(x: int, cb: {function(Error, string)}): void</programlisting>
+<simpara>This method can be annotated with <literal>Promisifiable</literal> as follows:</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">@Promisifiable f(x: int, cb: {function(Error, string)}): void</programlisting>
+<simpara>With this annotation, the function can be invoked in four different
+ways:</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">f(42, function(err, result1) { /* ... */ });            // traditional
+var promise: Promise&lt;string,Error&gt; = @Promisify f(42);  // promise
+var result3: string = await @Promisify f(42);           // long
+var result4: string = await f(42);                      // short</programlisting>
+<simpara>The first line is only provided for completeness and shows that a promisifiable function can still be used in the ordinary way by providing a callback - no special handling will occur in this case.
+The second line shows how <literal>f</literal> can be promisified using the <literal>@Promisify</literal> annotation - no callback needs to be provided and instead, a <literal>Promise</literal> will be returned.
+We can either use this promise directly or immediately <literal>await</literal> on it, as shown in line 3.
+The syntax shown in line 4 is merely shorthand for <literal>await @Promisify</literal>, i.e. the annotation is optional after <literal>await</literal>.</simpara>
+</example>
+<requirement xml:id="IDE-87">
+<title>Promisifiable</title>
+<simpara>
+<anchor xml:id="Req-IDE-87" xreflabel="[Req-IDE-87]"/>
+<emphasis role="strong">Requirement: IDE-87:</emphasis>
+<link linkend="Req-IDE-87">Promisifiable</link> (ver. 1)</simpara>
+    <simpara>
+
+A function or method <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>f</mi></math> can be annotated with <literal>@Promisifiable</literal> if and only if the following constraints hold:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>Last parameter of <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>f</mi></math> is a function (the <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>c</mi><mi>a</mi><mi>l</mi><mi>l</mi><mi>b</mi><mi>a</mi><mi>c</mi><mi>k</mi></math>).</simpara>
+</listitem>
+<listitem>
+<simpara>The <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>c</mi><mi>a</mi><mi>l</mi><mi>l</mi><mi>b</mi><mi>a</mi><mi>c</mi><mi>k</mi></math> has a signature of</simpara>
+<itemizedlist>
+<listitem>
+<simpara><literal>{function(E, T0, T1, &#8230;&#8203;, Tn): V}</literal>, or</simpara>
+</listitem>
+<listitem>
+<simpara><literal>{function(T0, T1, &#8230;&#8203;, Tn): V}</literal></simpara>
+<simpara>in which <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>E</mi></math> is type <literal>Error</literal> or a subtype thereof, <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>T</mi><mn>0</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>T</mi><mi>n</mi></msub></math> are arbitrary types except or its subtypes.
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>E</mi></math>, if given, is then the type of the error value, and <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>T</mi><mn>0</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>T</mi><mi>n</mi></msub></math> are the types of the success values of the asynchronous operation.<?asciidoc-br?>
+Since the return value of the synchronous function call is not available when using <literal>@Promisify</literal>, <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>V</mi></math> is recommended to be <literal>void</literal>, but it can be any type.</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+<listitem>
+<simpara>The callback parameter may be optional.<footnote><simpara>Even in this case, the function will actually be called with the callback method which is then created by the transpiler. However, the callback is not given in the N4JS code).</simpara></footnote></simpara>
+</listitem>
+</orderedlist>
+</requirement>
+<simpara>According to <xref linkend="Req-IDE-87"/>, a promisifiable function or method may or may not have a non-void return type, and that only the first parameter of the callback is allowed to be of type <literal>Error</literal>, all other parameters must be of other types.</simpara>
+<requirement xml:id="IDE-88">
+<title>@Promisify and await with promisifiable functions</title>
+<simpara>
+<anchor xml:id="Req-IDE-88" xreflabel="[Req-IDE-88]"/>
+<emphasis role="strong">Requirement: IDE-88:</emphasis>
+<link linkend="Req-IDE-88">@Promisify and await with promisifiable functions</link> (ver. 1)</simpara>
+    <simpara>
+
+A promisifiable function <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>f</mi></math> with one of the two valid
+signatures given in <xref linkend="Req-IDE-87"/> can be promisified with <literal>Promisify</literal> or
+used with <literal>await</literal>, if and only if the following constraints hold:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>Function <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>f</mi></math> must be annotated with <literal>@Promisifiable</literal>.</simpara>
+</listitem>
+<listitem>
+<simpara>Using <literal>@Promisify f()</literal> without <literal>await</literal> returns a promise of type <literal>Promise&lt;S,F&gt;</literal> where</simpara>
+<itemizedlist>
+<listitem>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>S</mi></math> is <literal>IterableN&lt;T0,&#8230;&#8203;,Tn&gt;</literal> if <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>n</mi><mo>≥</mo><mn>2</mn></math>, <literal>T</literal> if <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>n</mi><mo>=</mo><mn>1</mn></math>, and <literal>undefined</literal> if <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>n</mi><mo>=</mo><mn>0</mn></math>.</simpara>
+</listitem>
+<listitem>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>F</mi></math> is <literal>E</literal> if given, <literal>undefined</literal> otherwise.</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+<listitem>
+<simpara>Using <literal>await @Promisify f()</literal> returns a value of type <literal>IterableN&lt;T0,&#8230;&#8203;,Tn&gt;</literal> if <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>n</mi><mo>≥</mo><mn>2</mn></math>, of type <literal>T</literal> if <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>n</mi><mo>=</mo><mn>1</mn></math>, and of type <literal>undefined</literal> if <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>n</mi><mo>=</mo><mn>0</mn></math>.</simpara>
+</listitem>
+<listitem>
+<simpara>In case of using an <literal>await</literal>, the annotation can be omitted.<?asciidoc-br?>
+I.e., <literal>await @Promisify f()</literal> is equivalent to <literal>await f()</literal>.</simpara>
+</listitem>
+<listitem>
+<simpara>Only call expressions using f as target can be promisified, in other
+words this is illegal:</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">var pf = @Promisify f; // illegal code!</programlisting>
+</listitem>
+</orderedlist>
+</requirement>
+</section>
+</section>
+</chapter>
+<chapter xml:id="_conversions-and-reflection">
+<title>Conversions and Reflection</title>
+<section xml:id="_autoboxing-and-coercing" role="language-n4js">
+<title>Autoboxing and Coercing</title>
+<simpara>Coercing is the ability to implicitly cast one (primitive) type to another.
+Autoboxing is a special kind of coercing in that is the ability to automatically convert a primitive value type, such as <literal>string</literal>, <literal>number</literal>, or <literal>boolean</literal>,
+to its corresponding Object type version <literal>String</literal>, <literal>Number</literal>, <literal>Boolean</literal>.
+The capital letters in the latter are an essential distinction.</simpara>
+<simpara>Conversion between primitives and object-representations of a datatype are not automatic in N4JS. Only in the cases of object-method invocations on a primitive type
+(for <literal>string</literal> to call <literal>"abc".length</literal>, for example) automatic conversion is applied.</simpara>
+<simpara>Note that N4JS specific primitive types <literal>pathselector</literal> and <literal>i18nkey</literal> are handled similarly to <literal>string</literal>.</simpara>
+<section xml:id="_coercing">
+<title>Coercing</title>
+<simpara>In [<link linkend="ECMA11a">ECMA11a</link>], coercing is defined by means of the abstract specification method <literal>ToPrimitive</literal> [<link linkend="ECMA11a">ECMA11a(p.S9.1)</link>], also see [<link linkend="ECMA11a">ECMA11a(p.S9.10)</link>]).
+Other conversions, such as <literal>ToNumber</literal>, are not directly supported but reflected in the typing rules of expressions.</simpara>
+<simpara>We express absence of automatic coercion here by means of subtype
+relations:</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mtable><mtr><mtd><mfrac><mrow/><mrow><mi>Γ</mi><mo>⊢</mo><mstyle mathvariant="monospace"><mtext>Boolean</mtext></mstyle><mspace width="1.0mm"/><mo>≮</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mstyle mathvariant="monospace"><mtext>boolean</mtext></mstyle></mrow></mfrac><mspace width="3.0mm"/><mfrac><mrow/><mrow><mi>Γ</mi><mo>⊢</mo><mstyle mathvariant="monospace"><mtext>boolean</mtext></mstyle><mspace width="1.0mm"/><mo>≮</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mstyle mathvariant="monospace"><mtext>Boolean</mtext></mstyle></mrow></mfrac></mtd></mtr><mtr><mtd><mfrac><mrow/><mrow><mi>Γ</mi><mo>⊢</mo><mstyle mathvariant="monospace"><mtext>Number</mtext></mstyle><mspace width="1.0mm"/><mo>≮</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mstyle mathvariant="monospace"><mtext>number</mtext></mstyle></mrow></mfrac><mspace width="3.0mm"/><mfrac><mrow/><mrow><mi>Γ</mi><mo>⊢</mo><mstyle mathvariant="monospace"><mtext>number</mtext></mstyle><mspace width="1.0mm"/><mo>≮</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mstyle mathvariant="monospace"><mtext>Number</mtext></mstyle></mrow></mfrac></mtd></mtr><mtr><mtd><mfrac><mrow/><mrow><mi>Γ</mi><mo>⊢</mo><mstyle mathvariant="monospace"><mtext>String</mtext></mstyle><mspace width="1.0mm"/><mo>≮</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mstyle mathvariant="monospace"><mtext>string</mtext></mstyle></mrow></mfrac><mspace width="3.0mm"/><mfrac><mrow/><mrow><mi>Γ</mi><mo>⊢</mo><mstyle mathvariant="monospace"><mtext>string</mtext></mstyle><mspace width="1.0mm"/><mo>≮</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mstyle mathvariant="monospace"><mtext>String</mtext></mstyle></mrow></mfrac></mtd></mtr></mtable></math>
+<simpara>and for the N4JS specific types:</simpara>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mfrac><mrow/><mrow><mi>Γ</mi><mo>⊢</mo><mstyle mathvariant="monospace"><mtext>pathSelector</mtext></mstyle><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>T</mtext></mstyle><mo>&gt;</mo><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mstyle mathvariant="monospace"><mtext>string</mtext></mstyle></mrow></mfrac></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mfrac><mrow/><mrow><mi>Γ</mi><mo>⊢</mo><mstyle mathvariant="monospace"><mtext>i18nKey</mtext></mstyle><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mstyle mathvariant="monospace"><mtext>string</mtext></mstyle></mrow></mfrac></math></simpara>
+<simpara>If a conversion between primitive and object type is desired, we require the user of N4JS to actively convert the values.
+The reason for that is the notably different behavior of object- and primitive-variants of a type in expression evaluation:</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">var bool: boolean = false;
+var Bool: Boolean = new Boolean( false );
+
+console.log( bool ? "true" : "false"); // prints "false"
+console.log( Bool ? "true" : "false"); // prints "true"!</programlisting>
+<simpara>Conversion between a primitive type to its object-variant is achieved by the <literal>new</literal> operator.
+The <literal>valueOf()</literal> method converts the object-variant back to a primitive value.</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">// objects from literals:
+var bo: Boolean = new Boolean( true ); // typeof bo: object
+var no: Number = new Number( 42 ); // typeof no: object
+var so: String = new String( "foo" ); // typeof so: object
+
+// to primitive
+var b: boolean = bo.valueOf(); // typeof b: boolean -- true
+var n: number = no.valueOf(); // typeof n: number -- 42
+var s: string = so.valueOf(); // typeof s: string -- "foo"
+
+// to object-type
+bo = new Boolean( b );
+no = new Number( n );
+so = new String( s );</programlisting>
+<simpara>Conversion of variables of type <literal>Object</literal> or from one primitive type to another is expressed in terms of typing rules for expressions.
+That is, it is not possible to convert any <literal>Object</literal> to a primitive in general, but it is possible to do so in the context of certain expressions such as additive operator.
+The applied conversions are described in <xref linkend="_auto-conversion-of-class-instances"/></simpara>
+</section>
+<section xml:id="_autoboxing-of-primitives">
+<title>Autoboxing of Primitives</title>
+<simpara>In [<link linkend="ECMA11a">ECMA11a</link>], autoboxing is defined by <literal>ToObject</literal> [<link linkend="ECMA11a">ECMA11a(p.S9.9)</link>].</simpara>
+<simpara>Autoboxing is not directly supported in N4JS. Instead, primitive types virtually have the same members as their corresponding object types.
+It is then possible to use the Autoboxing feature when calling a member.
+In general, Autoboxing is only supported for accessing built-in read-only (immutable) properties.
+For example, <literal>"some string value".split(" ");</literal> is supported but <literal>"some string value".foo=1;</literal> will be rejected as String does not allow properties to be added (cf. <literal>String</literal> vs. <literal>String+</literal>, see <xref linkend="_dynamic"/>).</simpara>
+<simpara>Autoboxing often leads to problems, in particular in combination with dynamic types – this is why it is not directly supported in N4JS.</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">var s: String+ = "Hello"; <co xml:id="CO3-1"/>
+
+s.prop = 1;
+console.log(s.prop); <co xml:id="CO3-2"/></programlisting>
+<calloutlist>
+<callout arearefs="CO3-1">
+<para>will produce an error to prevent the following scenario:</para>
+</callout>
+<callout arearefs="CO3-2">
+<para>prints "undefined"</para>
+</callout>
+</calloutlist>
+</section>
+<section xml:id="_autoboxing-of-function-expressions-and-declarations">
+<title>Autoboxing of Function Expressions and Declarations</title>
+<simpara>Function expressions and declarations always define an object of type <literal>Function</literal>, thus coercing or Autoboxing is not required in case of functions:</simpara>
+<simpara>It is always possible to use a function expression where a <literal>Function</literal> is required, and to use an object of type <literal>Function</literal> where a function expression is expected.
+This is only possible if the function signatures are subtype-compatible, see <xref linkend="_function-type"/> for details.</simpara>
+<simpara>Still, it is always possible to call members of <literal>Function</literal>, e.g., <literal>function(){}.length()</literal>.</simpara>
+</section>
+</section>
+<section xml:id="_auto-conversion-of-objects" role="language-n4js">
+<title>Auto-Conversion of Objects</title>
+<section xml:id="_auto-conversion-of-class-instances">
+<title>Auto-Conversion of Class Instances</title>
+<simpara>All classes defined in N4JS modules implicitly subclass <literal>N4Object</literal>, which is a plain JavaScript Object type.
+The same auto-conversion rules defined for JavaScript <literal>Object</literal> therefore apply to <literal>N4Object</literal> instances as well.</simpara>
+<simpara>The basic conversion uses the abstract JavaScript function <literal>ToPrimitive</literal> [<link linkend="ECMA11a">ECMA11a(p.S9.1)</link>], which relays on the specification method <literal>Object</literal> [<link linkend="ECMA11a">ECMA11a(p.S8.12.8)</link>].
+<literal>DefaultValue</literal> calls <literal>valueOf</literal> or <literal>toString</literal> methods if they are defined by the class (in the <literal>methods</literal>-builder).</simpara>
+<simpara>Note that according to the [<link linkend="ECMA11a">ECMA11a</link>], in most cases, objects are first converted into primitives.
+That is, in most cases, no extra hint is passed to <literal>DefaultValue</literal>. Thus <literal>valueOf</literal> usually takes precedence over toString as demonstrated in the following example:</simpara>
+<example>
+<title>Auto-Conversion</title>
+<simpara>Assume some classes and corresponding instances defined as follows:</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">class A {}
+class B{
+    @Override public toString(): string { return "MyB"}
+}
+class C{
+    @Override public valueOf(): any { return 10}
+}
+class D{
+    @Override public toString(): string { return "MyD"}
+    @Override public valueOf(): any { return 20}
+}
+var a = new A(), b = new B(), c = new C(), d = new D();</programlisting>
+<simpara>Instances of these classes will be converted as demonstrated as follows:</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">console.log(a+"");                      // [object Object]
+console.log(a+1);                       // [object Object]1
+
+console.log(""+b+"");                   // MyB
+console.log(1+b+1);                     // 1MyB1
+
+console.log(c+"");                      // 10
+console.log(c+1);                       // 11
+
+console.log(d+"");                      // 20
+console.log(d+1);                       // 21</programlisting>
+</example>
+<section xml:id="_auto-conversion-of-interface-instances">
+<title>Auto-Conversion of Interface Instances</title>
+<simpara>Instances of interfaces actually are instances of classes at runtime.
+The auto-conversion rules described in <xref linkend="_auto-conversion-of-class-instances"/> are applied to instances declared as instances of interfaces as well.</simpara>
+</section>
+</section>
+<section xml:id="_auto-conversion-of-enum-literals">
+<title>Auto-Conversion of Enum Literals</title>
+<simpara>Enumeration values are objects and thus follow the behavior for ECMAScript <literal>Object</literal> and <literal>Function</literal>.
+They have a custom <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>t</mi><mi>o</mi><mi>S</mi><mi>t</mi><mi>r</mi><mi>i</mi><mi>n</mi><mi>g</mi></math> method which returns the name of the enumeration value.</simpara>
+</section>
+</section>
+<section xml:id="_type-cast-and-type-check" role="language-n4js">
+<title>Type Cast and Type Check</title>
+<section xml:id="_type-cast">
+<title>Type Cast</title>
+<literallayout class="monospaced">(IDEBUG-56): Casting to TypeVars</literallayout>
+<simpara>Type casts are expressed with the cast expression (<literal>as</literal>), see <xref linkend="_cast-as-expression"/> for details.</simpara>
+<simpara>We first define helper rules for the type cast constraints as follows:</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mtable><mtr><mtd><mfrac><mrow><mi>μ</mi><mfenced close=")" open="("><mi>T</mi></mfenced><mo>∈</mo><mfenced close="}" open="{"><mstyle mathvariant="monospace"><mtext>TEnum</mtext></mstyle><mstyle mathvariant="monospace"><mtext>Class</mtext></mstyle><mstyle mathvariant="monospace"><mtext>Primitive</mtext></mstyle><mstyle mathvariant="monospace"><mtext>ObjectType</mtext></mstyle></mfenced></mrow><mrow><mi>i</mi><mi>s</mi><mi>C</mi><mi>P</mi><mi>O</mi><mi>E</mi><mfenced close=")" open="("><mi>T</mi></mfenced></mrow></mfrac></mtd></mtr><mtr><mtd><mfrac><mrow><mi>μ</mi><mi>T</mi><mo>∈</mo><mfenced close="}" open="{"><mstyle mathvariant="monospace"><mtext>ClassifierType</mtext></mstyle><mstyle mathvariant="monospace"><mtext>TypeType</mtext></mstyle></mfenced><mo>∧</mo><mi>μ</mi><mfenced close=")" open="("><mrow><mi>T</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi></mrow></mfenced><mo>≠</mo><mstyle mathvariant="monospace"><mtext>TypeVariable</mtext></mstyle></mrow><mrow><mi>i</mi><mi>s</mi><mi>C</mi><mi>P</mi><mi>O</mi><mi>E</mi><mfenced close=")" open="("><mi>T</mi></mfenced></mrow></mfrac></mtd></mtr><mtr><mtd><mfrac><mrow><mi>μ</mi><mfenced close=")" open="("><mi>T</mi></mfenced><mo>∈</mo><mfenced close="}" open="{"><mstyle mathvariant="monospace"><mtext>Interface</mtext></mstyle></mfenced></mrow><mrow><mi>i</mi><mi>s</mi><mi>I</mi><mi>n</mi><mi>t</mi><mi>e</mi><mi>r</mi><mi>f</mi><mi>a</mi><mi>c</mi><mi>e</mi><mfenced close=")" open="("><mi>T</mi></mfenced></mrow></mfrac></mtd></mtr><mtr><mtd><mfrac><mrow><mi>μ</mi><mfenced close=")" open="("><mi>T</mi></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>TypeVariable</mtext></mstyle><mo>∧</mo><mi>T</mi><mo>.</mo><mi>u</mi><mi>p</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>B</mi><mi>o</mi><mi>u</mi><mi>n</mi><mi>d</mi><mi>s</mi><mo>≠</mo><mi>∅</mi></mrow><mrow><mi>i</mi><mi>s</mi><mi>B</mi><mi>o</mi><mi>u</mi><mi>n</mi><mi>d</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>V</mi><mi>a</mi><mi>r</mi><mfenced close=")" open="("><mi>T</mi></mfenced></mrow></mfrac></mtd></mtr><mtr><mtd><mfrac><mrow><mi>μ</mi><mfenced close=")" open="("><mi>T</mi></mfenced><mo>∈</mo><mfenced close="}" open="{"><mrow><mi> </mi><mstyle mathvariant="monospace"><mtext>TEnum</mtext></mstyle></mrow><mstyle mathvariant="monospace"><mtext>Primitive</mtext></mstyle></mfenced><mo>∨</mo><mfenced close="}" open="("><mrow><mi>μ</mi><mfenced close=")" open="("><mi>T</mi></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>Class</mtext></mstyle><mo>∧</mo><mi>T</mi><mo>.</mo><mi>e</mi><mi>x</mi><mi>t</mi><mi>e</mi><mi>n</mi><mi>s</mi><mi>i</mi><mi>b</mi><mi>i</mi><mi>l</mi><mi>i</mi><mi>t</mi><mi>y</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>final</mtext></mstyle></mrow></mfenced><mo>)</mo></mrow><mrow><mi>i</mi><mi>s</mi><mi>F</mi><mi>i</mi><mi>n</mi><mi>a</mi><mi>l</mi><mi>B</mi><mi>y</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi><mfenced close=")" open="("><mi>T</mi></mfenced></mrow></mfrac></mtd></mtr></mtable></math>
+<requirement xml:id="IDE-89">
+<title>Cast Validation At Compile Time</title>
+<simpara>
+<anchor xml:id="Req-IDE-89" xreflabel="[Req-IDE-89]"/>
+<emphasis role="strong">Requirement: IDE-89:</emphasis>
+<link linkend="Req-IDE-89">Cast Validation At Compile Time</link> (ver. 1)</simpara>
+    <simpara>
+
+Given a type cast expression <literal>e</literal> in which
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>Γ</mi><mo>⊢</mo><mi>e</mi><mo>.</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>:</mi><mi>S</mi></math> and and target type <literal>T</literal>, the
+following constraints must hold:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara><literal>T</literal> must be a classifier, enum, primitive, function type expression, classifier type, type variable, union or intersection type:</simpara>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>μ</mi><mfenced close=")" open="("><mi>T</mi></mfenced><mo>∈</mo><mspace width="3.0mm"/><mrow><mo>{</mo><mstyle mathvariant="monospace"><mtext>any</mtext></mstyle><mo>,</mo><mstyle mathvariant="monospace"><mtext>Class</mtext></mstyle><mo>,</mo><mstyle mathvariant="monospace"><mtext>Interface</mtext></mstyle><mo>,</mo><mstyle mathvariant="monospace"><mtext>Enum</mtext></mstyle><mo>,</mo><mstyle mathvariant="monospace"><mtext>Primitive</mtext></mstyle><mo>,</mo><mstyle mathvariant="monospace"><mtext>ObjectType</mtext></mstyle><mo>,</mo></mrow></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mrow><mspace width="3.0mm"/><mstyle mathvariant="monospace"><mtext>FunctionTypeExpression</mtext></mstyle><mo>,</mo><mstyle mathvariant="monospace"><mtext>ClassifierType</mtext></mstyle><mo>,</mo><mstyle mathvariant="monospace"><mtext>TypeVariable</mtext></mstyle><mo>,</mo><mstyle mathvariant="monospace"><mtext>Union</mtext></mstyle><mo>,</mo><mstyle mathvariant="monospace"><mtext>Intersection</mtext></mstyle><mo>}</mo></mrow></math></simpara>
+</listitem>
+<listitem>
+<simpara>if <literal>S</literal> is a subtype of <literal>T</literal>, the cast is unnecessary and a warning will be generated.</simpara>
+</listitem>
+<listitem>
+<simpara>if <literal>S</literal> and <literal>T</literal> are classes, enums or primitive types, then <literal>T</literal> must be a subtype of <literal>S</literal>.
+This is also true if <literal>T</literal> is an interface and the type of <literal>S</literal> cannot have subtypes, or vice versa.</simpara>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mrow><mo>(</mo><mi>i</mi><mi>s</mi><mi>C</mi><mi>P</mi><mi>O</mi><mi>E</mi><mfenced close=")" open="("><mi>T</mi></mfenced></mrow></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="2.0em"/><mo>∧</mo><mrow><mo>(</mo><mi>i</mi><mi>s</mi><mi>C</mi><mi>P</mi><mi>O</mi><mi>E</mi><mfenced close=")" open="("><mi>S</mi></mfenced></mrow></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mrow><mspace width="4.0em"/><mo>∨</mo><mfenced close=")" open="("><mrow><mi>μ</mi><mfenced close=")" open="("><mi>S</mi></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>Intersection</mtext></mstyle><mo>∧</mo><mo>∃</mo><msup><mi>S</mi><mi>'</mi></msup><mo>∈</mo><mi>S</mi><mi>:</mi><mi>i</mi><mi>s</mi><mi>C</mi><mi>P</mi><mi>O</mi><mi>E</mi><mfenced close=")" open="("><msup><mi>S</mi><mi>'</mi></msup></mfenced></mrow></mfenced><mo>)</mo></mrow></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∨</mo><mfenced close=")" open="("><mrow><mi>i</mi><mi>s</mi><mi>I</mi><mi>n</mi><mi>t</mi><mi>e</mi><mi>r</mi><mi>f</mi><mi>a</mi><mi>c</mi><mi>e</mi><mfenced close=")" open="("><mi>T</mi></mfenced><mo>∧</mo><mi>i</mi><mi>s</mi><mi>F</mi><mi>i</mi><mi>n</mi><mi>a</mi><mi>l</mi><mi>B</mi><mi>y</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi><mfenced close=")" open="("><mi>S</mi></mfenced></mrow></mfenced></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mrow><mo>∨</mo><mfenced close=")" open="("><mrow><mi>i</mi><mi>s</mi><mi>F</mi><mi>i</mi><mi>n</mi><mi>a</mi><mi>l</mi><mi>B</mi><mi>y</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi><mfenced close=")" open="("><mi>T</mi></mfenced><mo>∧</mo><mi>i</mi><mi>s</mi><mi>I</mi><mi>n</mi><mi>t</mi><mi>e</mi><mi>r</mi><mi>f</mi><mi>a</mi><mi>c</mi><mi>e</mi><mfenced close=")" open="("><mi>S</mi></mfenced></mrow></mfenced><mo>)</mo></mrow><mo>→</mo><mi>Γ</mi><mo>⊢</mo><mi>T</mi><mo>&lt;</mo><mi>:</mi><mi>S</mi></math></simpara>
+</listitem>
+<listitem>
+<simpara>if <literal>S</literal> is a class, enum or primitive type and <literal>T</literal> is a type-variable, then for each given boundary <math xmlns="http://www.w3.org/1998/Math/MathML"><msubsup><mi>T</mi><mi>i</mi><mrow><mi>u</mi><mi>p</mi></mrow></msubsup></math> of <literal>T</literal>
+of type class, enum or primitive <literal>S</literal> must be a member of the type hierarchy: <footnote><simpara><literal>i</literal> iterates over all boundaries</simpara></footnote></simpara>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mfenced close=")" open="("><mrow><mi>i</mi><mi>s</mi><mi>B</mi><mi>o</mi><mi>u</mi><mi>n</mi><mi>d</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>V</mi><mi>a</mi><mi>r</mi><mfenced close=")" open="("><mi>T</mi></mfenced><mo>∧</mo><mi>i</mi><mi>s</mi><mi>C</mi><mi>P</mi><mi>O</mi><mi>E</mi><mfenced close=")" open="("><mi>S</mi></mfenced></mrow></mfenced></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mo>→</mo><msub><mo>∀</mo><mrow><msubsup><mi>T</mi><mi>i</mi><mrow><mi>u</mi><mi>p</mi></mrow></msubsup><mo>∈</mo><mi>T</mi><mo>.</mo><mi>u</mi><mi>p</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>B</mi><mi>o</mi><mi>u</mi><mi>n</mi><mi>d</mi><mi>s</mi></mrow></msub><mrow><mo>(</mo><mi>i</mi><mi>s</mi><mi>C</mi><mi>P</mi><mi>O</mi><mi>E</mi><mfenced close=")" open="("><msubsup><mi>T</mi><mi>i</mi><mrow><mi>u</mi><mi>p</mi></mrow></msubsup></mfenced><mo>→</mo><mi>Γ</mi><mo>⊢</mo><mrow><mo>(</mo><mrow><mrow><msubsup><mi>T</mi><mi>i</mi><mrow><mi>u</mi><mi>p</mi></mrow></msubsup><mo>&lt;</mo><mi>:</mi><mi>S</mi><mo>∨</mo><msubsup><mi>T</mi><mi>i</mi><mrow><mi>u</mi><mi>p</mi></mrow></msubsup><mi>:</mi><mo>&gt;</mo><mi>S</mi><mo>)</mo></mrow><mo>)</mo></mrow></mrow></mrow></math></simpara>
+</listitem>
+<listitem>
+<simpara>if <literal>S</literal> is a union or intersection type, then the type cast is valid if it is valid for at least one element of <literal>S</literal>.</simpara>
+</listitem>
+<listitem>
+<simpara>if <literal>S</literal> and <literal>T</literal> are generics, and if <math xmlns="http://www.w3.org/1998/Math/MathML"><msup><mi>S</mi><mn>0</mn></msup><mo>=</mo><msup><mi>T</mi><mn>0</mn></msup></math>,
+a cast is possible if type arguments are sub- or supertypes of each other: <footnote><simpara><literal>i</literal> iterates over all type args</simpara></footnote></simpara>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>μ</mi><mfenced close=")" open="("><mi>S</mi></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>Classifier</mtext></mstyle><mo>∧</mo><mi>μ</mi><mfenced close=")" open="("><mi>T</mi></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>Classifier</mtext></mstyle><mo>∧</mo><msup><mi>S</mi><mn>0</mn></msup><mo>=</mo><msup><mi>T</mi><mn>0</mn></msup><mo>→</mo></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="2.0em"/><mrow><mo>(</mo><mrow><mo>∀</mo><mi> </mi><mi>S</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>A</mi><mi>r</mi><msub><mi>g</mi><mi>i</mi></msub><mo>&lt;</mo><mi>:</mi><mi>T</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>A</mi><mi>r</mi><msub><mi>g</mi><mi>i</mi></msub><mo>)</mo></mrow><mo>∨</mo><mrow><mo>(</mo><mrow><mo>∀</mo><mi> </mi><mi>T</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>A</mi><mi>r</mi><msub><mi>g</mi><mi>i</mi></msub><mo>&lt;</mo><mi>:</mi><mi>S</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>A</mi><mi>r</mi><msub><mi>g</mi><mi>i</mi></msub><mo>)</mo></mrow></mrow></mrow></math></simpara>
+</listitem>
+<listitem>
+<simpara>If <literal>T</literal> is a union type, then the type cast is valid if it is valid for at least one element of <literal>T</literal>.</simpara>
+</listitem>
+<listitem>
+<simpara>If <literal>T</literal> is an intersection type, then the type cast is valid if it is valid for all elements of <literal>T</literal>.</simpara>
+</listitem>
+</orderedlist>
+<note>
+<simpara><literal>any</literal> is a supertype of all other types, thus it is always possible to cast a variable of type <literal>any</literal> to other (non-composed) types.</simpara>
+</note>
+</requirement>
+</section>
+<section xml:id="_type-check">
+<title>Type Check</title>
+<simpara>There are basically two ways of testing the type of a variable: <literal>typeof</literal> and <literal>instanceof</literal>.
+N4JS supports type comparison via the ECMAScript <literal>instanceof</literal> operator.
+The operator <literal>instanceof</literal> retains its standard ECMAScript behavior (e.g. checking whether a value is an instance of a constructor function), but has additional functionality when used with N4JS types.</simpara>
+<simpara>When used with an N4JS class, <literal>instanceof</literal> also supports checking against an interface. For N4JS enumeration values, it can be used to check whether the value is part of a specific enumeration.</simpara>
+<simpara><literal>typeof</literal> only returns a string with the name of the ECMAScript type, which is <literal>Object</literal> for all class instances.</simpara>
+<simpara>N4JS specific <literal>string</literal> types, that is <literal>pathSelector</literal> and <literal>i18nkey</literal> cannot be tested during runtime.
+These types, therefore, must not be used in <literal>instanceof</literal> expressions.
+The same is true for string-based enums and arrays which cannot be tested during runtime, thus string-based enum and array types are not permitted on the right-hand side of <literal>instancesof</literal> constructs.
+For all types for which the evaluation result of <literal>instanceof</literal> could be computed at compile time, the check is unnecessary and thus it is refused by the compiler.
+Using structural types on the right-hand side of <literal>instancesof</literal> constructs is also not permitted.</simpara>
+<simpara>In order to avoid errors at runtime, the <literal>instanceof</literal> operator defines appropriate constraints, see <xref linkend="_relational-expression"/> for details.</simpara>
+<example>
+<title>Type Check Example</title>
+<simpara>Given the following classes and variable:</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">interface I{}
+class S{}
+class Sub extends S implements I{}
+
+var x = new Sub();</programlisting>
+</example>
+<simpara><literal>typeof x</literal> will simply return <literal>object</literal>. The following table shows the difference between plain JavaScript <literal>instanceof</literal> and N4JS’s <literal>instanceof</literal>:</simpara>
+<informaltable frame="all" rowsep="1" colsep="1">
+<tgroup cols="3">
+<colspec colname="col_1" colwidth="33.3333*"/>
+<colspec colname="col_2" colwidth="33.3333*"/>
+<colspec colname="col_3" colwidth="33.3334*"/>
+<thead>
+<row>
+<entry align="left" valign="top">Check</entry>
+<entry align="center" valign="top">JavaScript</entry>
+<entry align="center" valign="top">N4JS</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry align="left" valign="top"><simpara><literal>x instanceof Sub</literal></simpara></entry>
+<entry align="center" valign="top"><simpara><literal>true</literal></simpara></entry>
+<entry align="center" valign="top"><simpara><literal>true</literal></simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><literal>x instanceof S</literal></simpara></entry>
+<entry align="center" valign="top"><simpara><literal>true</literal></simpara></entry>
+<entry align="center" valign="top"><simpara><literal>true</literal></simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><literal>x instanceof I</literal></simpara></entry>
+<entry align="center" valign="top"><simpara><literal>false</literal></simpara></entry>
+<entry align="center" valign="top"><simpara><literal>true</literal></simpara></entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+</section>
+</section>
+<section xml:id="_reflection-meta-information" role="language-n4js">
+<title>Reflection meta-information</title>
+<simpara>All N4JS classes, interfaces and enumerations provide meta-information
+that is used by the runtime and standard library.
+All classifiers (including enums) provide meta-information by means of a static getter <literal>n4type</literal>.
+Since it is static getter, it is actually an instance getter of the
+constructor (or classifier) of a type, which is the only way to retrieve
+that information in case of interfaces. For enums, this can be retrieved
+from instances as well.</simpara>
+<simpara>This getter is of type <literal>N4Class</literal> which is a built-in type just like <literal>N4Object</literal>. It contains the following members:</simpara>
+<variablelist>
+<varlistentry>
+<term><literal>fqn</literal> </term>
+<listitem>
+<simpara>The <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>F</mi><mi>Q</mi><mi>N</mi></math> of the type.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>n4superType</literal> </term>
+<listitem>
+<simpara>The <literal>N4Class</literal> of the supertype, may be null if supertype is a not an <literal>N4Class</literal>.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>allImplementedInterfaces</literal> </term>
+<listitem>
+<simpara>List of The <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>F</mi><mi>Q</mi><mi>N</mi></math> of implemented interfaces (transitively
+but without interfaces implemented by supertype)</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>get isClass</literal> </term>
+<listitem>
+<simpara>True if the type is an N4Class.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>get isInterface</literal> </term>
+<listitem>
+<simpara>True if the type is an N4Interface.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+<section xml:id="_reflection-for-classes">
+<title>Reflection for Classes</title>
+<simpara>The meta-information for classes is available by means of <literal>N4Object</literal>’s static
+getter <literal>n4type</literal>. Since it is static getter, it is actually an instance getter of the constructor of a type.</simpara>
+<simpara>In addition, the static method <literal>of</literal> in <literal>N4Type</literal> is available to retrieve the meta-information for a given instance or
+constructor. This also allows to retrieve meta-information directly for an instance of some class <literal>C</literal> without having
+the constructor of <literal>C</literal> available, for example because the constructor is not accessible.</simpara>
+<example>
+<title>Reflection with <literal>N4class</literal></title>
+<simpara>This example demonstrates how these reflective features are accessed:</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">class A {}
+class B extends A {}
+var b = new B();
+console.log(B.n4type.fqn);
+console.log(b.constructor.n4type.fqn);
+console.log(b.constructor.n4type.n4superType.fqn);
+console.log(N4Type.of(b));
+console.log(N4Type.of(B.n4type).fqn);</programlisting>
+<simpara>Assuming this code is defined in file <literal>A</literal>, this will output</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">A.B
+A.B
+A.A
+A.B
+N4BuiltInClasses.N4Class</programlisting>
+</example>
+<simpara>The built-in types <literal>N4Object</literal> and <literal>N4Class</literal> are also accessible.
+They are not defined in a module, thus their <link linkend="_acronyms">FQN</link> returns only their simple name.</simpara>
+<example>
+<title>Reflection with Built-In Types</title>
+<programlisting language="n4js" linenumbering="unnumbered">console.log('N4Object.n4class.fqn:      ' + N4Object.n4class.fqn)
+console.log('N4Class.n4class.fqn:       ' + N4Class.n4class.fqn)
+
+class A {}
+console.log('A.n4class.fqn:             ' + A.n4class.fqn)
+console.log('A.n4class.n4superType.fqn: ' + A.n4class.n4superType.fqn)</programlisting>
+<simpara>Assuming this code is defined in file <literal>A</literal>, this will output</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">N4Object.n4class.fqn:      N4Object
+N4Class.n4class.fqn:       N4Class
+A.n4class.fqn:             A.A
+A.n4class.n4superType.fqn: N4Object</programlisting>
+<simpara>Note that classes extending <literal>Object</literal> do not provide the static <literal>n4class</literal> getter, hat is</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">class B extends Object {}
+console.log('B.n4class.fqn:             ' + B.n4class.fqn)</programlisting>
+<simpara>would issue an error as cannot be resolved.</simpara>
+</example>
+<example>
+<title>N4Class.of</title>
+<simpara>The type has a method to retrieve the meta-information from instances (i.e. or enumeration literals using )
+without using the constructor.</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">class C { }
+interface I {}  class IImpl implements I {}
+enum E { L }
+
+var c: C = new C();
+var i: I = new IImpl();
+var e: E = E.L;
+
+console.log(C.n4type.fqn);
+console.log(N4Class.of(c).fqn);
+
+console.log(I.n4type.fqn);
+console.log(N4Class.of(i).fqn);
+
+console.log(E.n4type.fqn);
+console.log(N4EnumType.of(e).fqn);</programlisting>
+</example>
+</section>
+<section xml:id="_reflection-for-interfaces">
+<title>Reflection for Interfaces</title>
+<simpara>The meta-information of an interface <literal>X</literal> is available via getter <literal>n4class</literal> defined in the <literal>type{X}</literal>.
+This field is of type <literal>N4Class</literal> as well.
+Since an interface cannot have a super classs, the property <literal>n4superTypes</literal> will always be empty.
+Calling <literal>isInterface</literal> respectively on the returned <literal>N4Class</literal> instance will return true.</simpara>
+</section>
+<section xml:id="_reflection-for-enumerations">
+<title>Reflection for Enumerations</title>
+<programlisting language="n4js" linenumbering="unnumbered">var n: number; var b: boolean; var s: string;</programlisting>
+<simpara>The meta-information for enumerations is available by means of the getter <literal>n4class</literal>, either statically by using the enumeration type or (in terms of an instance getter) via a literal.
+Calling <literal>isEnum</literal> on the returned <literal>N4Class</literal> instance will return true.</simpara>
+</section>
+</section>
+<section xml:id="_conversion-of-primitive-types" role="language-n4js">
+<title>Conversion of primitive types</title>
+<simpara>Conversion between primitives is given as follows:</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">var n: number; var b: boolean; var s: string;</programlisting>
+<informaltable frame="all" rowsep="1" colsep="1">
+<tgroup cols="4">
+<colspec colname="col_1" colwidth="11.1111*"/>
+<colspec colname="col_2" colwidth="11.1111*"/>
+<colspec colname="col_3" colwidth="44.4444*"/>
+<colspec colname="col_4" colwidth="33.3334*"/>
+<thead>
+<row>
+<entry align="center" valign="middle">From</entry>
+<entry align="center" valign="middle">To</entry>
+<entry align="left" valign="middle">Conversion</entry>
+<entry align="center" valign="top">Example</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry align="center" valign="middle"><simpara><literal>string</literal></simpara></entry>
+<entry align="center" valign="middle"><simpara><literal>number</literal></simpara></entry>
+<entry align="left" valign="middle"><simpara><literal>Number&#8230;&#8203;</literal></simpara></entry>
+<entry align="left" valign="top"><programlisting language="n4js" linenumbering="unnumbered">n = Number("42");//42</programlisting></entry>
+</row>
+<row>
+<entry align="center" valign="middle"><simpara><literal>string</literal></simpara></entry>
+<entry align="center" valign="middle"><simpara><literal>boolean</literal></simpara></entry>
+<entry align="left" valign="middle"><simpara><literal>N4Primitives.parseBoolean(&#8230;&#8203;)</literal></simpara></entry>
+<entry align="left" valign="top"><programlisting language="n4js" linenumbering="unnumbered"> b=N4Primitives.parseBoolean("false");</programlisting></entry>
+</row>
+<row>
+<entry align="center" valign="middle"><simpara><literal>number</literal></simpara></entry>
+<entry align="center" valign="middle"><simpara><literal>boolean</literal></simpara></entry>
+<entry align="left" valign="middle"><simpara><literal>Boolean(&#8230;&#8203;)</literal></simpara></entry>
+<entry align="left" valign="top"><programlisting language="n4js" linenumbering="unnumbered">b=Boolean(17.5); //true</programlisting></entry>
+</row>
+<row>
+<entry align="center" valign="middle"><simpara><literal>number</literal></simpara></entry>
+<entry align="center" valign="middle"><simpara><literal>string</literal></simpara></entry>
+<entry align="left" valign="middle"><simpara><literal>Number.toString()</literal></simpara></entry>
+<entry align="left" valign="top"><programlisting language="n4js" linenumbering="unnumbered">s=42.toString(); //"42"</programlisting></entry>
+</row>
+<row>
+<entry align="center" valign="middle"><simpara><literal>boolean</literal></simpara></entry>
+<entry align="center" valign="middle"><simpara><literal>number</literal></simpara></entry>
+<entry align="left" valign="middle"><simpara><literal>N4Primitives.toNumber(&#8230;&#8203;)</literal></simpara></entry>
+<entry align="left" valign="top"><programlisting language="n4js" linenumbering="unnumbered">n=N4Primitives.toNumber(true);</programlisting></entry>
+</row>
+<row>
+<entry align="center" valign="middle"><simpara><literal>boolean</literal></simpara></entry>
+<entry align="center" valign="middle"><simpara><literal>string</literal></simpara></entry>
+<entry align="left" valign="middle"><simpara><literal>Boolean.toString()</literal></simpara></entry>
+<entry align="left" valign="top"><programlisting language="n4js" linenumbering="unnumbered"> s=true.toString();//"true" }</programlisting></entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+<simpara>Remarks:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>ECMAScript doesn’t define explicit conversion from string content.
+Implicit handling states all strings with <math xmlns="http://www.w3.org/1998/Math/MathML"><mo>&gt;</mo><mn>0</mn><mo>=</mo><mo>=</mo><mi>t</mi><mi>r</mi><mi>u</mi><mi>e</mi></math>. <literal>N4Primitives.parseBoolean(x)</literal> yields true for <literal>x.trim().toLowerCase().equals("true")</literal></simpara>
+</listitem>
+<listitem>
+<simpara>The call to <literal>Boolean(..)</literal> for the arguments <literal>0</literal>, <literal>-0</literal>, <literal>null</literal>, <literal>false</literal>, <literal>NaN</literal>, <literal>undefined</literal> and <literal>""</literal> evaluate to <literal>false</literal>.
+All other values evaluate to <literal>true</literal>.</simpara>
+</listitem>
+<listitem>
+<simpara><literal>Number</literal> has several methods for converting a value to string [<link linkend="ECMA11a">ECMA11a(p.S15.7.4)</link>]: <literal>toExponential()</literal>, to <literal>Fixed()</literal>, <literal>toPrecision()</literal>.</simpara>
+</listitem>
+<listitem>
+<simpara>ECMAScript doesn’t define explicit conversion from boolean to number.
+Implicit handling states true <math xmlns="http://www.w3.org/1998/Math/MathML"><mo>→</mo></math> 1 and false <math xmlns="http://www.w3.org/1998/Math/MathML"><mo>→</mo></math> 0, which <literal>N4Primitives.toNumber()</literal> yields.</simpara>
+</listitem>
+</orderedlist>
+</section>
+</chapter>
+<chapter xml:id="_expressions">
+<title>Expressions</title>
+<simpara>For all expressions, we define the following pseudo properties:</simpara>
+<variablelist>
+<varlistentry>
+<term><literal>containingExpression</literal> </term>
+<listitem>
+<simpara>The parent expression, in which an expression is contained, may be null.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>containingStatement</literal> </term>
+<listitem>
+<simpara>The statement in which the expression is (indirectly) contained.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>containingFunctionOrAccessor</literal> </term>
+<listitem>
+<simpara>The function, method, getter or setter in which the expression is (indirectly) contained, may be null.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>containingClass</literal> </term>
+<listitem>
+<simpara>The class in which the expression is (indirectly) contained, may be null.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>probableThisTarget</literal> </term>
+<listitem>
+<simpara>The potential target of a this keyword binding, this is not necessarily the containing class or object literal.
+In case of instance methods of a class <literal>T</literal>, this usually is the classifier <literal>T</literal>; in case of static methods, it is the classifier type <literal>type{type}</literal>.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>container</literal> </term>
+<listitem>
+<simpara>The direct owner of the expression.
+z</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+<simpara>The expressions and statements are ordered, describing first the constructs available in the 5th edition of ECMA-262, referred to as [<link linkend="ECMA11a">ECMA11a</link>] in the following.
+It is worth noting that the grammar snippets already use newer constructs in some cases.</simpara>
+<section xml:id="_ecmascript-5-expressions" role="language-n4js">
+<title>ECMAScript 5 Expressions</title>
+<simpara>N4JS supports the same expressions as ECMAScript.
+The semantics are described in [<link linkend="ECMA11a">ECMA11a(p.S11)</link>].
+In N4JS, some expressions are extended for supporting the declaration of types, annotations, or parameterized usages.
+These extensions and type-related aspects as well as specific N4JS constraints are described in this section.</simpara>
+<simpara>Some operators come in different ’flavors’, that is as binary operator, unary pre- or postfix operators, or assignment operators.
+For these operators, type constraints are only defined for the binary operator version and the other variants are deduced to that binary version.
+E.g., <literal>++</literal> and <literal>+=</literal> are deduced to <literal>+</literal> (and simple assignment).</simpara>
+<section xml:id="_the-this-literal">
+<title>The this Literal</title>
+<simpara>This section describes the <literal>this</literal> literal and the semantics of the <literal>@This</literal> annotation, the type <literal>this</literal> is described in <xref linkend="_this-type"/>.</simpara>
+<bridgehead xml:id="_semantics-9" renderas="sect4">Semantics</bridgehead>
+<simpara>Semantics are similar to the original ECMAScript this keyword, see [<link linkend="ECMA11a">ECMA11a(p.11.1.1, p.p.63)</link>])
+Also see [<link linkend="West06a">West06a</link>] and <link xl:href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/this">MozillaJSRef</link></simpara>
+<simpara>Regarding the location where <literal>this</literal> may be used, the following restrictions apply:</simpara>
+<requirement xml:id="IDE-173">
+<title>Valid location for this literal</title>
+<simpara>
+<anchor xml:id="Req-IDE-173" xreflabel="[Req-IDE-173]"/>
+<emphasis role="strong">Requirement: IDE-173:</emphasis>
+<link linkend="Req-IDE-173">Valid location for this literal</link> (ver. 1)</simpara>
+    <simpara>
+
+The literal may not be used in</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>the initializer expression of static data fields in classes.</simpara>
+</listitem>
+<listitem>
+<simpara>the initializer expression of data fields in interfaces (applies to both static and non-static).</simpara>
+</listitem>
+<listitem>
+<simpara>static methods of interfaces and static field accessors of interfaces.</simpara>
+</listitem>
+</orderedlist>
+<simpara>See also <xref linkend="Req-IDE-69"/>.</simpara>
+</requirement>
+<simpara>Note: <xref linkend="Req-IDE-173"/> also applies for this literals inside arrow expressions in initializers.</simpara>
+<simpara>The use of <literal>this</literal> is illustrated with some examples as it can often be confusing.
+Type inference heuristics and explanations are provided in the next section.</simpara>
+<example>
+<title>This in Unrestricted Mode</title>
+<simpara>In unrestricted mode, <literal>this</literal> is bound to the receiver.
+If there is no receiver it is bound to the global object, however, we often do not know exactly what the global object would be.</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">var name = "global a"; // assume the top level is similar to the global object
+this.name; // &lt;-- "global a"
+function f() {
+    return this.name; // &lt;-- depends on call, usually "global a"
+}
+var ol1 = {
+    name: "John",
+    greeting: "Hello " + this.name, // "Hello global a" -- we do not greet John!
+}
+var ol2 = {
+    name: "John",
+    f: function() {
+        this.name; // usually "John", as we assume f is called like ol2.f()
+        var g = function() {
+           return this.name; // "global a"
+        }
+        return g(); // no receiver, this in nested function g will be global scope
+    }
+}</programlisting>
+</example>
+<example>
+<title>This in strict mode</title>
+<simpara>In strict mode, <literal>this</literal> is bound to the receiver.
+If there is no receiver, it is bound to <literal>undefined</literal>.
+Thus, we will probably get a lot of errors:</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">"use strict"
+var name = "global a"; // assume the top level is similar to the global object
+this.name; // &lt;-- error, this is undefined, there is no receiver
+function f() {
+    return this.name; // &lt;-- depends on call, usually this produces an error as this is undefined
+}
+var ol1 = {
+    name: "John",
+    greeting: "Hello " + this.name, // will produce an error, as this is undefined
+}
+var ol2 = {
+    name: "John",
+    f: function() {
+        this.name; // usually "John", as we assume f is called like ol2.f()
+        var g = function() {
+           this.name; // an error, see call below:
+        }
+        return g(); // no receiver, this in nested function g is undefined
+    }
+}</programlisting>
+</example>
+<example>
+<title>This in N4JS mode</title>
+<simpara>As in strict mode, <literal>this</literal> is bound to the receiver and if there is no receiver, it is bound to <literal>undefined</literal>. So the example above is also true for N4JS mode.
+Classes behave slightly differently:</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">class A {
+    name = "John";
+    greeting  = "Hello " + this.name; // works, in N4JS classes, greeting is "Hello John"
+
+    f() {
+        return this.name; // this usually is instance object, similar to object literals.
+    }
+
+    g() {
+        var h = function() {
+            return this.name; // as in object literals: no receiver, no this.
+        }
+        return h();
+    }
+}</programlisting>
+</example>
+<note>
+<simpara>In N4JS classes, <literal>this</literal> is always bound to the instance when used in field initialization.</simpara>
+</note>
+<bridgehead xml:id="_type-inference-2" renderas="sect4">Type Inference</bridgehead>
+<simpara>The type is inferred from the <literal>this</literal> type is bound to. The inference,
+therefore, has to consider the original semantics as described in [<link linkend="ECMA11a">ECMA11a(p.10.4., p.10.4.3, p.p.58)</link>].
+In ECMAScript the type of this is unfortunately determined by the function call and not by the function definition:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>By default, <literal>this</literal> is bound to the global object [<link linkend="ECMA11a">ECMA11a(p.10.4.1.1)</link>].
+Unfortunately it is often unknown what the global object will be at run time (e.g., node.js differs from browsers).</simpara>
+</listitem>
+<listitem>
+<simpara>If a function is called without a receiver, <literal>this</literal> is bound to</simpara>
+<itemizedlist>
+<listitem>
+<simpara>the global object or</simpara>
+</listitem>
+<listitem>
+<simpara>to <literal>undefined</literal> in strict mode.</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+<listitem>
+<simpara>If a function is called with a receiver,<literal>this</literal> is bound to the receiver object.</simpara>
+</listitem>
+</itemizedlist>
+<simpara>Actually, <literal>this</literal> is bound to the newly created object if a function is called with the <literal>new</literal> operator.
+If a function is known to be invoked with an explicit <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>t</mi><mi>h</mi><mi>i</mi><mi>s</mi><mi>A</mi><mi>r</mi><mi>g</mi></math> (<literal>apply()</literal> etc.), the <literal>@This</literal> annotation can be used to explicitly set the this type.
+This annotation has precedence over otherwise inferred bindings.</simpara>
+<requirement xml:id="IDE-90">
+<title>Type Inference Heuristic for This-Keyword</title>
+<simpara>
+<anchor xml:id="Req-IDE-90" xreflabel="[Req-IDE-90]"/>
+<emphasis role="strong">Requirement: IDE-90:</emphasis>
+<link linkend="Req-IDE-90">Type Inference Heuristic for This-Keyword</link> (ver. 1)</simpara>
+    <simpara>
+
+In general, the actual this target can not be inferred from the context of the this keyword.
+A heuristic is defined, however, to compute the probable this type:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara><anchor xml:id="this-keyword-constraint-1" xreflabel="[this-keyword-constraint-1]"/> If the this keyword is used in some function annotated with an annotation <literal>@This</literal>, the type specified in the annotation is used.
+The inferred type is always nominal.</simpara>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>f</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>"this"</mtext></mstyle><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>t</mi><mi>a</mi><mi>i</mi><mi>n</mi><mi>i</mi><mi>n</mi><mi>g</mi><mi>F</mi><mi>u</mi><mi>n</mi><mi>c</mi><mi>t</mi><mi>i</mi><mi>o</mi><mi>n</mi><mi>O</mi><mi>r</mi><mi>A</mi><mi>c</mi><mi>c</mi><mi>e</mi><mi>s</mi><mi>s</mi><mi>o</mi><mi>r</mi></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mfrac><mrow><mi>f</mi><mo>.</mo><mi>h</mi><mi>a</mi><mi>s</mi><mi>A</mi><mi>n</mi><mi>n</mi><mi>o</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close=")" open="("><mstyle mathvariant="monospace"><mtext>"@This"</mtext></mstyle></mfenced><mspace width="3.0mm"/><mi>T</mi><mo>=</mo><mi>f</mi><mo>.</mo><mi>a</mi><mi>n</mi><mi>n</mi><mi>o</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>o</mi><mi>n</mi><mstyle mathvariant="monospace"><mtext>["@This"]</mtext></mstyle></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mstyle mathvariant="monospace"><mtext>"this"</mtext></mstyle><mi>:</mi><mo>≁</mo><mi>T</mi></mrow></mfrac></math></simpara>
+</listitem>
+<listitem>
+<simpara><anchor xml:id="this-keyword-constraint-2" xreflabel="[this-keyword-constraint-2]"/> If the this keyword is used in some <emphasis>instance</emphasis> method of a  classifier or in an <emphasis>instance</emphasis> field initializer,<literal>this</literal> is bound to the <literal>T</literal> itself.
+If the this keyword is used in some <emphasis>static</emphasis> method of a classifier <literal>T</literal> or in a <emphasis>static</emphasis> field initializer, the prototype type (or constructor) of the classifier is used, that is <literal>type[T]</literal>.
+In both cases, the target is determined by using the expressions’s pseudo property <literal>probableThisTarget</literal>.
+If the this keyword is used in a function expression assigned to an property of an object literal, the type of the object literal is used.
+Note that usually this is the <literal>this</literal> type in instance methods, and the <literal>this</literal> type in static methods.</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><mi>T</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>"this"</mtext></mstyle><mo>.</mo><mi>p</mi><mi>r</mi><mi>o</mi><mi>b</mi><mi>a</mi><mi>b</mi><mi>l</mi><mi>e</mi><mi>T</mi><mi>h</mi><mi>i</mi><mi>s</mi><mi>T</mi><mi>a</mi><mi>r</mi><mi>g</mi><mi>e</mi><mi>t</mi><mspace width="3.0mm"/><mi>T</mi><mo>≠</mo><mstyle mathvariant="monospace"><mtext>null</mtext></mstyle></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mstyle mathvariant="monospace"><mtext>"this"</mtext></mstyle><mi>:</mi><mo>≁</mo><mi>T</mi></mrow></mfrac><mtext>
+</mtext></math>
+</listitem>
+<listitem>
+<simpara>In all other cases: Non-strict mode:</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><mi>m</mi><mi>o</mi><mi>d</mi><mi>e</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>unrestricted</mtext></mstyle></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mstyle mathvariant="monospace"><mtext>"this"</mtext></mstyle><mi>:</mi><mstyle mathvariant="monospace"><mtext>global</mtext></mstyle></mrow></mfrac><mtext>
+</mtext></math>
+</listitem>
+</orderedlist>
+<simpara>Strict mode and N4JS mode:</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><mi>m</mi><mi>o</mi><mi>d</mi><mi>e</mi><mo>≠</mo><mstyle mathvariant="monospace"><mtext>unrestricted</mtext></mstyle></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mstyle mathvariant="monospace"><mtext>"this"</mtext></mstyle><mi>:</mi><mstyle mathvariant="monospace"><mtext>global</mtext></mstyle><mstyle mathvariant="monospace"><mtext>undefined</mtext></mstyle></mrow></mfrac><mtext>
+</mtext></math>
+</requirement>
+<simpara>If the actual this type is defined as a structural type, the structural type information is moved to the this type itself.
+This is transparent to the user in general but maybe visible in case of error messages.
+That is to say that the actual this type is always a nominal type.
+This is indicated by the nominal modifier <math xmlns="http://www.w3.org/1998/Math/MathML"><mo>≁</mo></math> (cf. <xref linkend="Req-IDE-90"/> constraints <link linkend="this-keyword-constraint-1">1</link> and <link linkend="this-keyword-constraint-2">2</link>.).</simpara>
+<requirement xml:id="IDE-91">
+<title>Valid Target and Argument for @This Annotation</title>
+<simpara>
+<anchor xml:id="Req-IDE-91" xreflabel="[Req-IDE-91]"/>
+<emphasis role="strong">Requirement: IDE-91:</emphasis>
+<link linkend="Req-IDE-91">Valid Target and Argument for @This Annotation</link> (ver. 1)</simpara>
+    <simpara>
+</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>The <literal>@This</literal> annotation is only allowed on declared functions, function expressions (including arrow functions), methods, and field accessors, i.e. getters and setters, except static members of interfaces.</simpara>
+</listitem>
+<listitem>
+<simpara>The type declared by way of <literal>@This(..)</literal> an annotation of a method or field accessor must be a subtype of the member’s containing classifier.</simpara>
+</listitem>
+</orderedlist>
+</requirement>
+<requirement xml:id="IDE-92">
+<title>Single @This Annotation</title>
+<simpara>
+<anchor xml:id="Req-IDE-92" xreflabel="[Req-IDE-92]"/>
+<emphasis role="strong">Requirement: IDE-92:</emphasis>
+<link linkend="Req-IDE-92">Single @This Annotation</link> (ver. 1)</simpara>
+    <simpara>
+</simpara>
+<simpara>It is not allowed to use more then one <literal>@This(..)</literal> annotation on an element.</simpara>
+</requirement>
+<example>
+<title>Effect of Nominal This Type</title>
+<simpara>Given the following declaration</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">@This(~Object with {a: string;}) f() {}</programlisting>
+<simpara>Since the this type is always nominal, <literal>~ Object</literal> becomes <literal>Object</literal>.
+In case of method call, however, the returned value becomes structural again.
+In case of error messages the type of the return type is then</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">~this[Object] with {a: string;}</programlisting>
+<simpara>For the sake of simplicity, additional structural members are usually
+omitted in error messages, leading to</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">~this[Object]</programlisting>
+<simpara>instead of</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">this[~Object]</programlisting>
+</example>
+<example>
+<title>This and Function Declaration</title>
+<simpara>This example demonstrates the usage of functions annotated with <literal>@This</literal>.
+By using the argument  <literal>union{A,B}</literal> it is possible to have two completely unrelated classes as the receiver type of the function <literal>logger</literal>.
+To pass an actual object the <literal>apply()</literal> method of the function is used.</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">class A {
+    log: string() { return "A was logged"; }
+}
+
+class B {
+    log: string() { return "B was logged"; }
+}
+
+@This(union{A,B})
+function logger() { console.log("~ "+this.log()+" ~"); }
+
+
+var a: A = new A();
+logger.apply(a,[]); // prints "~ A was logged ~"
+logger.apply( new B(),[]) // prints "~ B was logged ~"</programlisting>
+</example>
+<example>
+<title>This and Function Expressions</title>
+<simpara>In this example a function is created via a function expression.
+The function is then assigned to member field of class B.
+Via annotating the expression with <literal>@This(B)</literal>, access to the receiver of type B is enabled.</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">class B {
+    log(): string { return "B was logged"; }     // method
+    logMe : {@This(B) function():void}; // reference to a function
+}
+
+var b: B = new B();
+b.logMe = @This(B) function() { console.log("*&gt;"+this.log()+"&lt;*"); }
+b.logMe(); // prints "*&gt;B was logged&lt;*"</programlisting>
+
+<simpara>Note that if a function is called as a constructor function with new, the
+type of <literal>this</literal> can be declared via annotation <literal>@This(..)</literal>, as shown in the following
+snippet:</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">@This(
+    ~Object with {
+        w: number; h: number;
+        area: {function():number};
+    })
+function Box(w: number w, h: number) {
+    this.w = w;
+    this.h = h;
+    this.area = @This(
+        ~Object with {
+            w: number; h: number;
+            area: {function():number};
+        }) function() { return this.w * this.h }
+}
+var bError = Box(1,2)
+var bOK = new Box(1,2)</programlisting>
+</example>
+<simpara>Inside the constructor function <literal>Box</literal>, <literal>this</literal> is bound to the structural type definition due to the annotation.</simpara>
+<simpara>Inside the nested function <literal>area</literal>, <literal>this</literal> is bound to the receiver object (if the function is called like <literal>bOk.area()</literal>).
+Again, this depends on the way the nested function is called, which can usually not be determined at the declaration location.
+The nested function must then be annotated accordingly.</simpara>
+<simpara>When calling this function, the type of this is checked against the declared this type, which would cause an error in the first case.</simpara>
+<simpara>The use of the <literal>@This</literal> annotation is not allowed on methods.</simpara>
+<tip>
+<simpara>Using constructor functions is not recommended and an error or warning will be created.
+This is only useful for adapting third-party library code.
+Even in the latter case, it would probably make more sense to declare a (library) <emphasis role="strong">class</emphasis> Rectangle rather then defining the constructor function.</simpara>
+</tip>
+</section>
+<section xml:id="_identifier">
+<title>Identifier</title>
+<bridgehead xml:id="_syntax-10" renderas="sect4">Syntax</bridgehead>
+<simpara>Identifiers as expressions are identifier references.
+They are defined as follows:</simpara>
+<programlisting language="xtext" linenumbering="unnumbered">IdentifierRef &lt;Yield&gt;:
+    id=[types::IdentifiableElement|BindingIdentifier&lt;Yield&gt;]
+;
+
+BindingIdentifier &lt;Yield&gt;:
+    IDENTIFIER
+    | &lt;!Yield&gt; 'yield'
+    | N4Keyword
+;</programlisting>
+<bridgehead xml:id="_semantics-10" renderas="sect4">Semantics</bridgehead>
+<simpara>The type of an identifier <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>i</mi></math> is resolved depending on its binding and scope respectively (cf. [<link linkend="ECMA11a">ECMA11a(p.10.2.2.1GetIdentifierReference, p.p.56)</link>].
+The following scopes (aka <emphasis>Lexical Environments</emphasis>) are defined:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>function local; local variables, parameters</simpara>
+</listitem>
+<listitem>
+<simpara>zero or more function closure in case of nested functions</simpara>
+</listitem>
+<listitem>
+<simpara>module</simpara>
+</listitem>
+<listitem>
+<simpara>global</simpara>
+</listitem>
+</itemizedlist>
+<simpara>These scope are nested as illustrated in <xref linkend="fig:scopes"/>.</simpara>
+<simpara>Note that classes definitions and object literal do not define a scope: members of a class or properties of an object literal are to be accessed via <literal>this</literal>.
+Identifier references always reference declared elements, that is to say either variable, function, or class declarations.
+Properties of object literals or members of a class are referenced via <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>P</mi><mi>r</mi><mi>o</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>t</mi><mi>y</mi><mi>A</mi><mi>c</mi><mi>c</mi><mi>e</mi><mi>s</mi><mi>s</mi><mo>-</mo><mi>E</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>e</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>o</mi><mi>n</mi><mo>.</mo><mi>p</mi><mi>r</mi><mi>o</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>t</mi><mi>y</mi></math> (see <xref linkend="_property-accessors"/>).</simpara>
+<figure xml:id="fig:scopes">
+<title>Scopes</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/08_expressions/fig/scopes.svg" width="40%" scalefit="1" align="center"/>
+</imageobject>
+<textobject><phrase>scopes</phrase></textobject>
+</mediaobject>
+</figure>
+<simpara>An identifier may be bound to a variable (global or local variable, parameter, variable defined in a function’s closure), or to a property of an object.
+The latter case is known as property access as further described in <xref linkend="_property-accessors"/>.</simpara>
+<requirement xml:id="IDE-93">
+<title>Read Access to Identifier</title>
+<simpara>
+<anchor xml:id="Req-IDE-93" xreflabel="[Req-IDE-93]"/>
+<emphasis role="strong">Requirement: IDE-93:</emphasis>
+<link linkend="Req-IDE-93">Read Access to Identifier</link> (ver. 1)</simpara>
+    <simpara>
+
+If an identifier <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>i</mi></math> is accessed, the bound declared element <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>D</mi></math> must be readable if it is not used on the left-hand side of an assignment expression.</simpara>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mi>b</mi><mi>i</mi><mi>n</mi><mi>d</mi><mfenced close=")" open="("><mi>i</mi><mi>D</mi></mfenced></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mspace width="2.0em"/><mo>∧</mo><mo>∄</mo><mi> </mi><mstyle mathvariant="monospace"><mtext>AssignmentExpression</mtext></mstyle><mi> </mi><mi>a</mi><mi>e</mi><mo>∈</mo><mi>i</mi><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>t</mi><mi>a</mi><mi>i</mi><mi>n</mi><mi>e</mi><msup><mi>r</mi><mo>*</mo></msup><mi>:</mi></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mspace width="3.0em"/><mi>a</mi><mi>e</mi><mo>.</mo><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi><mo>=</mo><mi>i</mi></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mspace width="4.0em"/><mo>∨</mo><mfenced close=")" open="("><mrow><mi>μ</mi><mfenced close=")" open="("><mrow><mi>a</mi><mi>e</mi><mo>.</mo><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi></mrow></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>PropertyAccessExpression</mtext></mstyle><mo>∧</mo><mi>a</mi><mi>e</mi><mo>.</mo><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi><mo>.</mo><mi>p</mi><mi>r</mi><mi>o</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>t</mi><mi>y</mi><mo>=</mo><mi>i</mi></mrow></mfenced><mi>:</mi></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mo>⇒</mo><mi>D</mi><mo>.</mo><mi>r</mi><mi>e</mi><mi>a</mi><mi>d</mi><mi>a</mi><mi>b</mi><mi>l</mi><mi>e</mi></math></simpara>
+</requirement>
+<bridgehead xml:id="_type-inference-3" renderas="sect4">Type Inference</bridgehead>
+<simpara>An identifier reference <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>i</mi></math> is bound to an identifiable element <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>i</mi><mo>.</mo><mi>i</mi><mi>d</mi></math>, which is expressed with the function <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>b</mi><mi>i</mi><mi>n</mi><mi>d</mi><mfenced close=")" open="("><mi>i</mi><mrow><mi>i</mi><mo>.</mo><mi>i</mi><mi>d</mi></mrow></mfenced></math>.
+The type of the reference is then inferred as follows:</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><mi>Γ</mi><mo>⊢</mo><mi>i</mi><mi>d</mi><mi>r</mi><mi>e</mi><mi>f</mi><mo>.</mo><mi>i</mi><mi>d</mi><mi>:</mi><mi>T</mi></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mstyle mathvariant="monospace"><mtext>IdentifierRef</mtext></mstyle><mi> </mi><mi>i</mi><mi>d</mi><mi>r</mi><mi>e</mi><mi>f</mi><mi>:</mi><mi>T</mi></mrow></mfrac></math>
+</section>
+<section xml:id="_literals">
+<title>Literals</title>
+<simpara>cf. [<link linkend="ECMA11a">ECMA11a(p.S11.1.3p.63, p.S7.8p.19ff)</link>].</simpara>
+<bridgehead xml:id="_type-inference-4" renderas="sect4">Type Inference</bridgehead>
+<simpara>The type of a literal can directly be derived from the grammar.
+The following axioms are defined for literals:</simpara>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="13.0em"/><mfrac><mrow/><mrow><mstyle mathvariant="monospace"><mtext>NullLiteral</mtext></mstyle><mi>:</mi><mstyle mathvariant="monospace"><mtext>null</mtext></mstyle></mrow></mfrac></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="13.0em"/><mfrac><mrow/><mrow><mstyle mathvariant="monospace"><mtext>BooleanLiteral</mtext></mstyle><mi>:</mi><mstyle mathvariant="monospace"><mtext>boolean</mtext></mstyle></mrow></mfrac></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="13.0em"/><mfrac><mrow/><mrow><mstyle mathvariant="monospace"><mtext>NumericLiteral</mtext></mstyle><mi>:</mi><mstyle mathvariant="monospace"><mtext>int</mtext></mstyle><mi>o</mi><mi>r</mi><mstyle mathvariant="monospace"><mtext>number</mtext></mstyle></mrow></mfrac></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="13.0em"/><mfrac><mrow/><mrow><mstyle mathvariant="monospace"><mtext>StringLiteral</mtext></mstyle><mi>:</mi><mstyle mathvariant="monospace"><mtext>string</mtext></mstyle></mrow></mfrac></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="13.0em"/><mfrac><mrow/><mrow><mstyle mathvariant="monospace"><mtext>RegularExpressionLiteral</mtext></mstyle><mi>:</mi><mstyle mathvariant="monospace"><mtext>RegExpr</mtext></mstyle></mrow></mfrac></math></simpara>
+<simpara>Note that there are no literals specific for <literal>pathSelector</literal> or <literal>i18nkey</literal>.</simpara>
+<section xml:id="_integer-literals">
+<title>Integer Literals</title>
+<simpara>Numeric literals representing integers in the range of JavaScript’s int32 are inferred to the built-in primitive type <literal>int</literal> instead of <literal>number</literal>.
+The following rules apply:</simpara>
+<requirement xml:id="IDE-94">
+<title>Numeric literals</title>
+<simpara>
+<anchor xml:id="Req-IDE-94" xreflabel="[Req-IDE-94]"/>
+<emphasis role="strong">Requirement: IDE-94:</emphasis>
+<link linkend="Req-IDE-94">Numeric literals</link> (ver. 1)</simpara>
+    <simpara>
+</simpara>
+<itemizedlist>
+<listitem>
+<simpara>Numeric literals with a fraction or using scientific notation, e.g. <literal>2.0</literal> and <literal>2e0</literal>, respectively, are always inferred to <literal>number</literal>, even if they represent integers in the range of int32.</simpara>
+</listitem>
+<listitem>
+<simpara>Numeric literals that represent integers in the range of JavaScript’s int32, i.e. from <math xmlns="http://www.w3.org/1998/Math/MathML"><msup><mn>-2</mn><mn>31</mn></msup></math> to <math xmlns="http://www.w3.org/1998/Math/MathML"><msup><mn>2</mn><mn>31</mn></msup><mo>-</mo><mn>1</mn></math>, are inferred to <literal>int</literal>.</simpara>
+</listitem>
+<listitem>
+<simpara>Hexadecimal and octal literals are always interpreted as positive numbers, so all values above <literal>0x7fffffff</literal> and <literal>017777777777</literal> lie outside the range of int32 and will thus
+be inferred to <literal>number</literal>; this is an important difference to Java. See below for further elaboration.</simpara>
+</listitem>
+</itemizedlist>
+<simpara>There are differences to numeric literals in Java:</simpara>
+<informaltable frame="all" rowsep="1" colsep="1">
+<tgroup cols="5">
+<colspec colname="col_1" colwidth="25*"/>
+<colspec colname="col_2" colwidth="25*"/>
+<colspec colname="col_3" colwidth="12.5*"/>
+<colspec colname="col_4" colwidth="25*"/>
+<colspec colname="col_5" colwidth="12.5*"/>
+<thead>
+<row>
+<entry align="left" valign="top"></entry>
+<entry align="center" valign="top" namest="col_2" nameend="col_3">Java</entry>
+<entry align="center" valign="top" namest="col_3" nameend="col_4">JavaScript  N4JS</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry align="left" valign="top"><simpara><emphasis role="strong">Literal</emphasis></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">Value</emphasis></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">Type</emphasis></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">Value</emphasis></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">Type</emphasis></simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><literal>2147483648</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis>-2147483648</emphasis></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>int</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis>-2147483648</emphasis></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>int</literal></simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><literal>2147483647</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis>2147483647</emphasis></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>int</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis>2147483647</emphasis></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>int</literal></simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><literal>0x7fffffff</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis>2147483647</emphasis></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>int</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis>2147483647</emphasis></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>int</literal></simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><literal>0x80000000</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis>-2147483648</emphasis></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>int</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis>+2147483648</emphasis></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>number</literal></simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><literal>0xffffffff</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis>-1</emphasis></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>int</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis>4294967295</emphasis></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>number</literal></simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><literal>0x100000000</literal></simpara></entry>
+<entry align="center" valign="top" namest="col_2" nameend="col_3"><simpara><emphasis role="strong">n/a</emphasis></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis>4294967296</emphasis></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>number</literal></simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><literal>017777777777</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis>2147483647</emphasis></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>int</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis>2147483647</emphasis></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>int</literal></simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><literal>020000000000</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis>-2147483648</emphasis></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>int</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis>+2147483648</emphasis></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>number</literal></simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><literal>037777777777</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis>-1</emphasis></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>int</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis>4294967295</emphasis></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>number</literal></simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><literal>040000000000</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis>0</emphasis></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>int</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis>4294967296</emphasis></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>number</literal></simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><literal>0100000000000</literal></simpara></entry>
+<entry align="center" valign="top" namest="col_2" nameend="col_3"><simpara><emphasis role="strong">n/a</emphasis></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis>8589934592</emphasis></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>number</literal></simpara></entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+<simpara>The literals <literal>0x100000000</literal> and <literal>0100000000000</literal> produce a syntax error in Java.</simpara>
+<simpara>Until IDE-1881  is complete, all built-in operations always return a <literal>number</literal> even if all operands are of type <literal>int</literal>.
+For the time being, we therefore interpret <literal>-1</literal> as a negative integer literal (inferred to <literal>int</literal>), but <literal>-(1)</literal> as the negation of a positive integer literal (inferred to <literal>number</literal>).</simpara>
+</requirement>
+</section>
+</section>
+<section xml:id="_array-literal">
+<title>Array Literal</title>
+<bridgehead xml:id="_syntax-11" renderas="sect4">Syntax</bridgehead>
+<simpara>cf [<link linkend="ECMA11a">ECMA11a(p.S11.1.4, p.p.63)</link>]</simpara>
+<programlisting language="xtext" linenumbering="unnumbered">ArrayLiteral &lt;Yield&gt; returns ArrayLiteral:
+    {ArrayLiteral} '['
+        elements+=ArrayPadding* (
+            elements+=ArrayElement&lt;Yield&gt;
+            (',' elements+=ArrayPadding* elements+=ArrayElement&lt;Yield&gt;)*
+            (trailingComma?=',' elements+=ArrayPadding*)?
+        )?
+    ']'
+;
+
+/**
+ * This array element is used to pad the remaining elements, e.g. to get the
+ * length and index right
+ */
+ArrayPadding returns ArrayElement: {ArrayPadding} ',';
+
+ArrayElement &lt;Yield&gt; returns ArrayElement: {ArrayElement} spread?='...'? expression=AssignmentExpression&lt;In=true,Yield&gt;;</programlisting>
+<bridgehead xml:id="_type-inference-5" renderas="sect4">Type Inference</bridgehead>
+<simpara>In general, an array literal is inferred as <literal>Array&lt;T&gt;</literal> (similar to the type of <literal>new Array()</literal>).
+The interesting question is the binding of the type variable <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi></math>.</simpara>
+<simpara>The type of an array padding <emphasis>p</emphasis> is inferred as follows:</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow/><mrow><mi>Γ</mi><mo>⊢</mo><mi>p</mi><mi>:</mi><mstyle mathvariant="monospace"><mtext>undefined</mtext></mstyle></mrow></mfrac><mtext>
+</mtext></math>
+<simpara>The element type of an array literal is simply inferred as the (simplified) union of the type elements of the array.
+Thus, the type of an array literal <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>a</mi></math> is inferred as follows:</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><mi>Γ</mi><mo>⊢</mo><mi>a</mi><mo>.</mo><mover accent="true"><mrow><mi>e</mi><mi>l</mi><mi>e</mi><mi>m</mi><mi>e</mi><mi>n</mi><mi>t</mi><mi>s</mi></mrow><mo>¯</mo></mover><mi>:</mi><mover accent="true"><msub><mi>T</mi><mi>e</mi></msub><mo>¯</mo></mover><mi>T</mi><mo>=</mo><mo>⋃</mo><mover accent="true"><msub><mi>T</mi><mi>e</mi></msub><mo>¯</mo></mover></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mfenced close=")" open="("><mi>a</mi></mfenced><mi>:</mi><mi>A</mi><mi>r</mi><mi>r</mi><mi>a</mi><mi>y</mi><mo>&lt;</mo><mi>T</mi><mo>&gt;</mo></mrow></mfrac></math>
+<simpara>In other languages not supporting union types, the element type is often inferred as the join (<link linkend="_acronyms">LCST</link>) of the element types.
+Using a union type here preserves more information (as the actual types are still known).
+For many use cases the behavior is similar though, as the members of a union type are the members of the join of the elements of the union.</simpara>
+<simpara>Note that <literal>typeof [1,2,3]</literal> does not return <literal>Array&lt;number&gt;</literal> (as ECMAScript is not aware of the generic array type), but <literal>Object</literal>.</simpara>
+<example>
+<title>Array Type Inference</title>
+<simpara>The type for all variables declared in this example is inferred to <literal>Array&lt;string&gt;</literal>:</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">var names1          = ["Walter", "Werner"];
+var names2          = new Array("Wim", "Wendelin");
+var names3          = new Array&lt;string&gt;(3); // length is 3
+var names4: Array&lt;string&gt;;</programlisting>
+<simpara>Empty array literals are inferred to <literal>any</literal>, by default.
+We are not using <literal>Array&lt;?&gt;</literal> here because then a typical JavaScript pattern would no longer be supported:</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">var a = [];
+a.push('hello'); <co xml:id="CO4-1"/></programlisting>
+<calloutlist>
+<callout arearefs="CO4-1">
+<para>This would fail if <literal>a</literal> and thus <literal>[]</literal> were inferred to <literal>Array&lt;?&gt;</literal></para>
+</callout>
+</calloutlist>
+</example>
+<important>
+<simpara>An important exception; if a type expectation exists for the empty array literal and the expected type is <literal>Array&lt;T&gt;</literal>, this will be used as the type of the array literal.</simpara>
+</important>
+<requirement xml:id="IDE-95">
+<title>Empty array literal</title>
+<simpara>
+<anchor xml:id="Req-IDE-95" xreflabel="[Req-IDE-95]"/>
+<emphasis role="strong">Requirement: IDE-95:</emphasis>
+<link linkend="Req-IDE-95">Empty array literal</link> (ver. 1)</simpara>
+    <simpara>
+
+An empty array literal will be inferred as follows:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>If there is a type expectation for the empty array literal and the expected type is <literal>Array&lt;T&gt;</literal>, for any type <literal>T</literal>, then the type of the empty array literal will be inferred to <literal>Array&lt;T&gt;</literal>.</simpara>
+</listitem>
+<listitem>
+<simpara>Otherwise, the type of the empty array literal will be inferred to <literal>Array&lt;any&gt;</literal>.</simpara>
+</listitem>
+</itemizedlist>
+</requirement>
+</section>
+<section xml:id="_object-literal">
+<title>Object Literal</title>
+<simpara>In addition to ordinary Javascript object literals, N4JS supports the spread operator within object literals as introduced in [<link linkend="ECMA18a">ECMA18a</link>].</simpara>
+<bridgehead xml:id="object-literal-syntax" renderas="sect4">Syntax</bridgehead>
+<simpara>Cf. [<link linkend="ECMA11a">ECMA11a(p.S11.1.5, p.p.65ff)</link>]
+The syntax of an object literal is given by:</simpara>
+<programlisting language="xtext" linenumbering="unnumbered">ObjectLiteral &lt;Yield&gt;: {ObjectLiteral}
+    '{'
+        ( propertyAssignments+=PropertyAssignment&lt;Yield&gt;
+          (',' propertyAssignments+=PropertyAssignment&lt;Yield&gt;)* ','?
+        )?
+    '}'
+;
+
+PropertyAssignment &lt;Yield&gt;:
+      PropertyNameValuePair&lt;Yield&gt;
+    | PropertyGetterDeclaration&lt;Yield&gt;
+    | PropertySetterDeclaration&lt;Yield&gt;
+    | PropertyMethodDeclaration&lt;Yield&gt;
+    | PropertyNameValuePairSingleName&lt;Yield&gt;
+    | PropertySpread&lt;Yield&gt;
+;
+
+
+PropertyMethodDeclaration &lt;Yield&gt;:
+    =&gt; ({PropertyMethodDeclaration}
+        annotations+=Annotation*
+        TypeVariables? returnTypeRef=TypeRef?
+            (
+                generator?='*'  LiteralOrComputedPropertyName&lt;Yield&gt; -&gt;MethodParamsAndBody&lt;Generator=true&gt;
+                | LiteralOrComputedPropertyName&lt;Yield&gt; -&gt;MethodParamsAndBody &lt;Generator=false&gt;
+            )
+        )
+    ';'?
+;
+
+PropertyNameValuePair &lt;Yield&gt;:
+    =&gt; (
+        {PropertyNameValuePair}
+        annotations+=Annotation*
+        declaredTypeRef=TypeRef? LiteralOrComputedPropertyName&lt;Yield&gt; ':'
+    )
+    expression=AssignmentExpression&lt;In=true,Yield&gt;
+;
+
+/*
+ * Support for single name syntax in ObjectLiteral (but disallowed in actual object literals by ASTStructureValidator
+ * except in assignment destructuring patterns)
+ */
+PropertyNameValuePairSingleName &lt;Yield&gt;:
+    declaredTypeRef=TypeRef?
+    identifierRef=IdentifierRef&lt;Yield&gt;
+    ('=' expression=AssignmentExpression&lt;In=true,Yield&gt;)?
+;
+
+PropertyGetterDeclaration &lt;Yield&gt;:
+    =&gt;(
+        {PropertyGetterDeclaration}
+        annotations+=Annotation*
+        GetterHeader&lt;Yield&gt;
+    )
+    body=Block&lt;Yield=false&gt;
+;
+
+PropertySetterDeclaration &lt;Yield&gt;:
+    =&gt;(
+        {PropertySetterDeclaration}
+        annotations+=Annotation*
+        'set'
+        -&gt;LiteralOrComputedPropertyName &lt;Yield&gt;
+    )
+    '(' fpar=FormalParameter&lt;Yield&gt; ')' body=Block&lt;Yield=false&gt;
+;
+
+PropertySpread &lt;Yield&gt;:
+	'...' expression=AssignmentExpression&lt;In=true,Yield&gt;
+;</programlisting>
+<programlisting language="n4js" linenumbering="unnumbered">import Address from "my/Address";
+var simple = {name: "Walter", age: 72, address: new Address()};</programlisting>
+<section xml:id="_properties-6">
+<title>Properties</title>
+<simpara>PropertyAssignments have common properties of PropertyNameValuePair, PropertyGetterDeclaration, and PropertySetterDeclaration:</simpara>
+<variablelist>
+<varlistentry>
+<term><literal>annotations</literal> </term>
+<listitem>
+<simpara>The annotations of the property assignment.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>name</literal> </term>
+<listitem>
+<simpara>The name of the property. This may be an identifier, a string or a numeric literal.
+When comparing names, we implicitly assume the name to be converted to an identifier, even if this identifier is not a valid ECMAScript identifier.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>declaredType</literal> </term>
+<listitem>
+<simpara>The declared type of the property which may be null.
+This property is a pseudo property for PropertySetterDeclaration, in this case it is derived from the declared type of the setter’s formal parameter.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+<simpara>Additionally, we introduce the following pseudo properties to simplify constraints:</simpara>
+<variablelist>
+<varlistentry>
+<term><literal>isAccessor</literal> </term>
+<listitem>
+<simpara>The read-only boolean property. This is true if the property assignment is a setter or getter declaration.
+This is comparable to ECMAScript’s spec function <literal>IsAccessoprDescriptor</literal>.
+For a given property assignment <emphasis>p</emphasis> this is semantically equivalent to <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>μ</mi><mfenced close=")" open="("><mi>p</mi></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>PropertyGetterDeclaration</mtext></mstyle><mo>∨</mo><mi>μ</mi><mfenced close=")" open="("><mi>p</mi></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>PropertySetterDeclaration</mtext></mstyle></math>.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>isData</literal> </term>
+<listitem>
+<simpara>The read-only boolean property.
+This is true if the property assignment is a name value pair.
+For a given property assignment <emphasis>p</emphasis> this is semantically equivalent to <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>μ</mi><mfenced close=")" open="("><mi>p</mi></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>PropertyNameValuePair</mtext></mstyle></math>.
+It is comparable to ECMAScript’s spec function <literal>isDataDescriptor</literal>.
+The equation <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>i</mi><mi>s</mi><mi>A</mi><mi>c</mi><mi>c</mi><mi>e</mi><mi>s</mi><mi>s</mi><mi>o</mi><mi>r</mi><mo>=</mo><mo>¬</mo><mi>i</mi><mi>s</mi><mi>D</mi><mi>a</mi><mi>t</mi><mi>a</mi></math> is always true.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+<bridgehead xml:id="properties-semantics" renderas="sect4">Semantics</bridgehead>
+<requirement xml:id="IDE-96">
+<title>Object literal</title>
+<simpara>
+<anchor xml:id="Req-IDE-96" xreflabel="[Req-IDE-96]"/>
+<emphasis role="strong">Requirement: IDE-96:</emphasis>
+<link linkend="Req-IDE-96">Object literal</link> (ver. 1)</simpara>
+    <simpara>
+
+For a given object literal <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>o</mi><mi>l</mi></math> the following constraints must hold (cf. [<link linkend="ECMA11a">ECMA11a(p.p.66)</link>]:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>the name of each property is given as an identifier, a string literal, a numeric literal, or as a computed property name with a compile-time expression (see <xref linkend="compile-time-expressions"/>). In particular, string literals, e.g. <literal>['myProp']</literal>, built-in symbols, e.g. <literal>[Symbol.iterator]</literal>, and literals of <literal>@StringBased</literal> enums are all valid computed property names.</simpara>
+</listitem>
+<listitem>
+<simpara>Object literal may not have two PropertyNameValuePairs with the same name in strict mode (cf. 4.a [<link linkend="ECMA11a">ECMA11a(p.p.66)</link>]):</simpara>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>m</mi><mi>o</mi><mi>d</mi><mi>e</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>strict</mtext></mstyle><mo>→</mo><mspace width="3.0mm"/><mo>∀</mo><mi>p</mi><mi>a</mi><mo>∈</mo><mi>o</mi><mi>l</mi><mo>.</mo><mi>p</mi><mi>r</mi><mi>o</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>t</mi><mi>y</mi><mi>A</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>g</mi><mi>n</mi><mi>m</mi><mi>e</mi><mi>n</mi><mi>t</mi><mi>s</mi><mo>,</mo><mi>p</mi><mi>a</mi><mo>.</mo><mi>i</mi><mi>s</mi><mi>D</mi><mi>a</mi><mi>t</mi><mi>a</mi><mi>:</mi></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mo>∄</mo><mi>p</mi><msup><mi>a</mi><mi>'</mi></msup><mo>∈</mo><mi>o</mi><mi>l</mi><mo>.</mo><mi>p</mi><mi>r</mi><mi>o</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>t</mi><mi>y</mi><mi>A</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>g</mi><mi>n</mi><mi>m</mi><mi>e</mi><mi>n</mi><mi>t</mi><mi>s</mi><mi>:</mi></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mi>p</mi><msup><mi>a</mi><mi>'</mi></msup><mo>.</mo><mi>i</mi><mi>s</mi><mi>A</mi><mi>c</mi><mi>c</mi><mi>e</mi><mi>s</mi><mi>s</mi><mi>o</mi><mi>r</mi><mo>∧</mo><mi>p</mi><msup><mi>a</mi><mi>'</mi></msup><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><mi>p</mi><mi>a</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi></math></simpara>
+</listitem>
+<listitem>
+<simpara>Object literal may not have PropertyNameValuePair and <literal>PropertyGetterDeclaration</literal>/<literal>PropertySetterDeclaration</literal> with the same name (cf. 4.b/c [<link linkend="ECMA11a">ECMA11a(p.p.66)</link>]):</simpara>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∀</mo><mspace width="3.0mm"/><mi>p</mi><mi>a</mi><mo>∈</mo><mi>o</mi><mi>l</mi><mo>.</mo><mi>p</mi><mi>r</mi><mi>o</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>t</mi><mi>y</mi><mi>A</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>g</mi><mi>n</mi><mi>m</mi><mi>e</mi><mi>n</mi><mi>t</mi><mi>s</mi><mo>,</mo><mi>p</mi><mi>a</mi><mo>.</mo><mi>i</mi><mi>s</mi><mi>D</mi><mi>a</mi><mi>t</mi><mi>a</mi><mi>:</mi></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∄</mo><mspace width="3.0mm"/><mi>p</mi><mi>g</mi><mi>s</mi><mi>d</mi><mo>∈</mo><mi>o</mi><mi>l</mi><mo>.</mo><mi>p</mi><mi>r</mi><mi>o</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>t</mi><mi>y</mi><mi>A</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>g</mi><mi>n</mi><mi>m</mi><mi>e</mi><mi>n</mi><mi>t</mi><mi>s</mi><mi>:</mi></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>μ</mi><mfenced close=")" open="("><mrow><mi>p</mi><mi>g</mi><mi>s</mi><mi>d</mi></mrow></mfenced><mo>≠</mo><mstyle mathvariant="monospace"><mtext>PropertyNameValuePair</mtext></mstyle><mo>∧</mo><mi>p</mi><mi>g</mi><mi>s</mi><mi>d</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><mi>p</mi><mi>a</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi></math></simpara>
+</listitem>
+<listitem>
+<simpara>Object literal may not have multiple <literal>PropertyGetterDeclaration</literal> or <literal>PropertySetterDeclaration</literal> with the same name (cf. 4.d [<link linkend="ECMA11a">ECMA11a(p.p.66)</link>]):</simpara>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∀</mo><mspace width="3.0mm"/><mi>p</mi><mi>g</mi><mo>∈</mo><mi>o</mi><mi>l</mi><mo>.</mo><mi>p</mi><mi>r</mi><mi>o</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>t</mi><mi>y</mi><mi>A</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>g</mi><mi>n</mi><mi>m</mi><mi>e</mi><mi>n</mi><mi>t</mi><mi>s</mi><mo>,</mo><mi>p</mi><mi>g</mi><mo>.</mo><mi>i</mi><mi>s</mi><mi>A</mi><mi>c</mi><mi>c</mi><mi>e</mi><mi>s</mi><mi>s</mi><mi>o</mi><mi>r</mi><mi>:</mi></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∄</mo><mspace width="3.0mm"/><mi>p</mi><msup><mi>g</mi><mi>'</mi></msup><mo>∈</mo><mi>o</mi><mi>l</mi><mo>.</mo><mi>p</mi><mi>r</mi><mi>o</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>t</mi><mi>y</mi><mi>A</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>g</mi><mi>n</mi><mi>m</mi><mi>e</mi><mi>n</mi><mi>t</mi><mi>s</mi><mfenced close="}" open="{"><mrow><mi>p</mi><mi>g</mi></mrow></mfenced><mi>:</mi></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mi>μ</mi><mfenced close=")" open="("><mrow><mi>p</mi><msup><mi>g</mi><mi>'</mi></msup></mrow></mfenced><mo>=</mo><mi>μ</mi><mfenced close=")" open="("><mrow><mi>p</mi><mi>g</mi></mrow></mfenced><mo>∧</mo><mi>p</mi><msup><mi>g</mi><mi>'</mi></msup><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><mi>p</mi><mi>g</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi></math></simpara>
+</listitem>
+</itemizedlist>
+<blockquote>
+<simpara>It is a SyntaxError if the Identifier <literal>eval</literal> or the Identifier <literal>arguments</literal> occurs as the Identifier in a <literal>PropertySetParameterList</literal> of a <literal>PropertyAssignment</literal> that is contained in strict code or if its
+<literal>FunctionBody</literal> is strict code. [<link linkend="ECMA11a">ECMA11a(p.p.66)</link>]</simpara>
+</blockquote>
+<itemizedlist>
+<listitem>
+<simpara>If two or more property assignments have the same name (and the previous conditions hold), then the types of these assignments must <emphasis>conform</emphasis>.
+That is to say that the inferred (but not declared) type of all assignments must be type of probably declared types and if the types are explicitly declared, they must be equal.</simpara>
+</listitem>
+<listitem>
+<simpara>In N4JS mode, the name of a property must be a valid N4JSIdentifier:</simpara>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>m</mi><mi>o</mi><mi>d</mi><mi>e</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>n4js</mtext></mstyle><mo>→</mo><mspace width="3.0mm"/><mo>∀</mo><mi>p</mi><mi>a</mi><mo>∈</mo><mi>o</mi><mi>l</mi><mo>.</mo><mi>p</mi><mi>r</mi><mi>o</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>t</mi><mi>y</mi><mi>A</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>g</mi><mi>n</mi><mi>m</mi><mi>e</mi><mi>n</mi><mi>t</mi><mi>s</mi><mi>:</mi></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mi>μ</mi><mfenced close=")" open="("><mrow><mi>p</mi><mi>a</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi></mrow></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>N4JSIdentifier</mtext></mstyle></math></simpara>
+</listitem>
+</itemizedlist>
+</requirement>
+<requirement xml:id="IDE-22501">
+<title>Superfluous properties of an object literal</title>
+<simpara>
+<anchor xml:id="Req-IDE-22501" xreflabel="[Req-IDE-22501]"/>
+<emphasis role="strong">Requirement: IDE-22501:</emphasis>
+<link linkend="Req-IDE-22501">Superfluous properties of an object literal</link> (ver. 1)</simpara>
+    <simpara>
+
+Let <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>E</mi></math> be the expected type of an object literal <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>O</mi></math> as defined by the context in which <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>O</mi></math> is used.
+If <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>E</mi></math> is not type <literal>Object</literal> and not dynamic, then the compiler creates a warning <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>O</mi></math> contains properties not found in <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>E</mi></math>.</simpara>
+<simpara>This is true in particular for object literals passed in as arguments of a spec-constructor.</simpara>
+</requirement>
+</section>
+<section xml:id="_scoping-and-linking">
+<title>Scoping and linking</title>
+<example>
+<title>Scoping and linking</title>
+<programlisting language="n4js" linenumbering="unnumbered">var p = {
+    f: function() {
+        console.log("p´s f");
+    },
+    b: function() {
+        this.f();
+    },
+    o: {
+        nested: "Hello"
+    }
+};
+p.b();
+p.o.nested;</programlisting>
+<itemizedlist>
+<listitem>
+<simpara>Other properties within an object literal property can be accessed using this.
+In the expression of property name value pairs, however, <literal>this</literal> is not be bound to the containing object literal, but usually to undefined or global.</simpara>
+</listitem>
+<listitem>
+<simpara>The properties of an object literal are accessible from outside.</simpara>
+</listitem>
+<listitem>
+<simpara>Nested properties of an object literal are also accessible from outside.</simpara>
+</listitem>
+</itemizedlist>
+</example>
+<bridgehead xml:id="type-inference-3" renderas="sect4">Type Inference</bridgehead>
+<simpara>An object literal implicitly extends <literal>~Object</literal>, therefore, object literal types use structural typing.
+For details see <xref linkend="_structural-typing"/>.
+From a type systems point of view, the two variables <literal>ol</literal> and <literal>st</literal> below have the same type.</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">var ol = {
+    s: "hello",
+    n: 42
+}
+var st: ~Object with { s: string; n: number;};</programlisting>
+</section>
+</section>
+<section xml:id="_parenthesized-expression-and-grouping-operator">
+<title>Parenthesized Expression and Grouping Operator</title>
+<simpara>The grouping operator is defined here as a parenthesized expression.</simpara>
+<bridgehead xml:id="parenthesized-expression-grouping-syntax" renderas="sect4">Syntax</bridgehead>
+<simpara>cf. [<link linkend="ECMA11a">ECMA11a(p.S11.1.6, p.p.67)</link>]</simpara>
+<programlisting language="xtext" linenumbering="unnumbered">ParenExpression &lt;Yield&gt;: '(' expression=Expression&lt;In=true,Yield&gt; ')';</programlisting>
+<bridgehead xml:id="Grouping-Operator-type-inference" renderas="sect4">Type Inference</bridgehead>
+<simpara>The type of the grouping operator simply is the type of its nested expression.
+The type if a parenthesized expression <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>p</mi><mi>e</mi></math> is inferred as follows:</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><mi>Γ</mi><mo>⊢</mo><mi>e</mi><mi>:</mi><mi>T</mi></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mstyle mathvariant="monospace"><mtext>’(’</mtext></mstyle><mi>e</mi><mstyle mathvariant="monospace"><mtext>’)’</mtext></mstyle><mi>:</mi><mi>T</mi></mrow></mfrac></math>
+<example>
+<title>Parenthesized Expression Type Examples</title>
+<simpara>In the following listing, the type of the plain expressions is equivalent to the parenthesized versions:</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">class A{} class B extends A{}
+var f: boolean; var a: A a; var b: B;
+
+/* simple       &lt;-&gt;     parenthesized */
+10;                     (10);
+"hello";                ("hello");
+true;                   (true);
+a;                      (a);
+10-5;                   (10-5);
+f?a:b                   (f?a:b);</programlisting>
+</example>
+</section>
+<section xml:id="_property-accessors">
+<title>Property Accessors</title>
+<bridgehead xml:id="property-accessor-syntax" renderas="sect4">Syntax</bridgehead>
+<simpara>Property accessors in N4JS are based on [<link linkend="ECMA11a">ECMA11a(p.S11.2.1, p.p.67ff)</link>].
+They cannot only be used for accessing properties of an object, but also for accessing members of a class instance.
+In order to support parameterized calls, the syntax is extended to optionally allow type arguments.</simpara>
+<programlisting language="xtext" linenumbering="unnumbered">ParameterizedPropertyAccessExpression:
+    target=PrimaryExpression&lt;Yield&gt; ParameterizedPropertyAccessExpressionTail&lt;Yield&gt;
+;
+
+IndexedAccessExpression:
+    target=PrimaryExpression&lt;Yield&gt; IndexedAccessExpressionTail&lt;Yield&gt;
+;
+
+fragment IndexedAccessExpressionTail &lt;Yield&gt;*:
+    '[' index=Expression&lt;In=true,Yield&gt; ']'
+;
+
+fragment ParameterizedPropertyAccessExpressionTail &lt;Yield&gt;*:
+    '.' TypeArguments? property=[types::IdentifiableElement|IdentifierName]
+;</programlisting>
+<simpara>Note that in [<link linkend="ECMA11a">ECMA11a</link>], the <literal>index access</literal> is called <literal><emphasis>bracket notation</emphasis></literal>.</simpara>
+<bridgehead xml:id="property-access-direct" renderas="sect4">Direct Property Access</bridgehead>
+<simpara>We define a special case of property access as follows:</simpara>
+<definition>
+<title>Direct Property Access</title>
+<simpara>
+<anchor xml:id="direct_property_access" xreflabel="[direct_property_access]"/>
+<emphasis role="strong">Definition:</emphasis>
+<link linkend="direct_property_access">Direct Property Access</link></simpara>
+<simpara>
+
+A property access expression is called <emphasis>direct</emphasis>, iff</simpara>
+<itemizedlist>
+<listitem>
+<simpara>its target is an identifier reference to a class, interface, enum, or the built-in object <literal>Symbol</literal>, and</simpara>
+</listitem>
+<listitem>
+<simpara>its property name denotes an <emphasis>owned</emphasis> member of the target classifier (not an inherited, consumed, or polyfilled member) or a literal if the target is an enum.</simpara>
+</listitem>
+</itemizedlist>
+</definition>
+<simpara>As a consequence, a direct property access can only refer to static members.</simpara>
+<simpara>The first requirement of the above definition rules out property access expressions that do not directly point to their target classifier or enum, as shown in the following example:</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">class C {
+  const field = 'hello';
+}
+C.field;  // direct property access to 'field'
+let ctor = C;
+ctor.field;  // *not* a direct property access to 'field'</programlisting>
+<simpara>Direct property access is the only form of property access allowed in compile-time expressions, cf. <xref linkend="compile-time-expressions"/>.</simpara>
+<section xml:id="properties-1">
+<title>Properties</title>
+<simpara>We define the following properties:</simpara>
+<variablelist>
+<varlistentry>
+<term><literal>target</literal> </term>
+<listitem>
+<simpara>The receiver of the property access.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>index</literal> </term>
+<listitem>
+<simpara>The index expression in case of an IndexedAccessExpression (returns <math xmlns="http://www.w3.org/1998/Math/MathML"><mstyle mathvariant="monospace"><mtext>null</mtext></mstyle></math> otherwise).</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>property</literal> </term>
+<listitem>
+<simpara>The name of the property in case of non-indexed-access expressions (returns <math xmlns="http://www.w3.org/1998/Math/MathML"><mstyle mathvariant="monospace"><mtext>null</mtext></mstyle></math> otherwise, although the index may be interpreted as property name).</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+<simpara>We define the following pseudo properties:</simpara>
+<variablelist>
+<varlistentry>
+<term><literal>isDotAccess</literal> </term>
+<listitem>
+<simpara>Read-only boolean property, returns true for non-index access expression (similar to <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>μ</mi><mfenced close=")" open="("><mi>p</mi></mfenced><mo>≠</mo><mstyle mathvariant="monospace"><mtext>IndexedAccessExpression</mtext></mstyle></math>).</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>isIndexAccess</literal> </term>
+<listitem>
+<simpara>Read-only boolean property, returns true for index access expression (similar to <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>μ</mi><mfenced close=")" open="("><mi>p</mi></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>IndexedAccessExpression</mtext></mstyle></math>.<?asciidoc-br?>
+The equation <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>p</mi><mo>.</mo><mi>i</mi><mi>s</mi><mi>D</mi><mi>o</mi><mi>t</mi><mi>A</mi><mi>c</mi><mi>c</mi><mi>e</mi><mi>s</mi><mi>s</mi><mo>=</mo><mo>¬</mo><mi>p</mi><mo>.</mo><mi>i</mi><mi>s</mi><mi>I</mi><mi>n</mi><mi>d</mi><mi>e</mi><mi>x</mi><mi>A</mi><mi>c</mi><mi>c</mi><mi>e</mi><mi>s</mi><mi>s</mi></math> is always true.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>name</literal> </term>
+<listitem>
+<simpara>Returns the name of the property.
+This is either the <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>p</mi><mi>r</mi><mi>o</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>t</mi><mi>y</mi></math> converted to a simple name or the index converted to a name (where possible) if it is an indexed-accessed expression.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+<bridgehead xml:id="property-acessors-semantics" renderas="sect4">Semantics</bridgehead>
+<simpara>The parameterization is part of the property access in case of generic methods.
+For generic functions, a parameterized function call is introduced (cf. <xref linkend="_function-calls"/>).
+The constraints are basically similar.</simpara>
+<requirement xml:id="IDE-97">
+<title>Property Access and Dot Notation</title>
+<simpara>
+<anchor xml:id="Req-IDE-97" xreflabel="[Req-IDE-97]"/>
+<emphasis role="strong">Requirement: IDE-97:</emphasis>
+<link linkend="Req-IDE-97">Property Access and Dot Notation</link> (ver. 1)</simpara>
+    <simpara>
+</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>If dot notation is used in N4JS mode, the referenced property must exist unless receiver is a dynamic type:</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mspace width="3.0mm"/><mi>p</mi><mi>a</mi><mi>e</mi><mo>.</mo><mi>i</mi><mi>s</mi><mi>D</mi><mi>o</mi><mi>t</mi><mi>A</mi><mi>c</mi><mi>c</mi><mi>e</mi><mi>s</mi><mi>s</mi><mo>∧</mo><mo>¬</mo><mi>R</mi><mo>.</mo><mi>d</mi><mi>y</mi><mi>n</mi><mo>→</mo><mtext>
+</mtext><mspace width="3.0mm"/><mo>∃</mo><mi>m</mi><mo>∈</mo><mi>p</mi><mi>a</mi><mi>e</mi><mo>.</mo><mi>t</mi><mi>a</mi><mi>r</mi><mi>g</mi><mi>e</mi><mi>t</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mo>.</mo><mi>p</mi><mi>r</mi><mi>o</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>t</mi><mi>i</mi><mi>e</mi><mi>s</mi><mi>:</mi><mi>m</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><mi>p</mi><mi>a</mi><mi>e</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi></math>
+</listitem>
+<listitem>
+<simpara>If dot notation is used and the referenced property exists, then the property must be accessible:</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mspace width="3.0mm"/><mi>p</mi><mi>a</mi><mi>e</mi><mo>.</mo><mi>i</mi><mi>s</mi><mi>D</mi><mi>o</mi><mi>t</mi><mi>A</mi><mi>c</mi><mi>c</mi><mi>e</mi><mi>s</mi><mi>s</mi><mo>∧</mo><mo>¬</mo><mi>R</mi><mo>.</mo><mi>d</mi><mi>y</mi><mi>n</mi><mo>→</mo><mtext>
+</mtext><mspace width="3.0mm"/><mfenced close=")" open="("><mrow><mo>∃</mo><mi>m</mi><mo>∈</mo><mi>p</mi><mi>a</mi><mi>e</mi><mo>.</mo><mi>t</mi><mi>a</mi><mi>r</mi><mi>g</mi><mi>e</mi><mi>t</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mo>.</mo><mi>p</mi><mi>r</mi><mi>o</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>t</mi><mi>i</mi><mi>e</mi><mi>s</mi><mi>:</mi><mi>m</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><mi>p</mi><mi>a</mi><mi>e</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi></mrow></mfenced><mo>→</mo><mi>α</mi><mfenced close=")" open="("><mrow><mi>p</mi><mi>a</mi><mi>e</mi></mrow><mi>m</mi></mfenced></math>
+</listitem>
+<listitem>
+<simpara>If dot notation is used and the referenced property exists and this property is a member with a declared <literal>@This</literal> type (only possible for methods or field accessors),
+then the receiver must be a subtype of the declared <literal>@This</literal> type.</simpara>
+</listitem>
+</orderedlist>
+</requirement>
+<requirement xml:id="IDE-98">
+<title>Index Access</title>
+<simpara>
+<anchor xml:id="Req-IDE-98" xreflabel="[Req-IDE-98]"/>
+<emphasis role="strong">Requirement: IDE-98:</emphasis>
+<link linkend="Req-IDE-98">Index Access</link> (ver. 1)</simpara>
+    <simpara>
+</simpara>
+<simpara>An index access expression is valid iff one of the following cases applies:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>the receiver is of a dynamic type. In this case, the index may be any expression (need not be a compile-time expression).</simpara>
+</listitem>
+<listitem>
+<simpara>the receiver is an immediate instance of <literal>Object</literal>, i.e. it is a subtype of <literal>Object</literal> and its super types but <emphasis role="strong">not</emphasis> of any other type including <literal>~Object</literal> and <literal>~~Object</literal>.</simpara>
+</listitem>
+<listitem>
+<simpara>the receiver is of type Array, ArgumentType, string, or String (including their subtypes) <emphasis role="strong">and</emphasis> the index is an expression of type <literal>number</literal>.</simpara>
+</listitem>
+<listitem>
+<simpara>the index expression is a compile-time expression</simpara>
+<itemizedlist>
+<listitem>
+<simpara><emphasis role="strong">and</emphasis> the receiver type defines a member with a name equal to the string representation of the index expression&#8217;s compile-time value<?asciidoc-br?></simpara>
+</listitem>
+<listitem>
+<simpara><emphasis role="strong">and</emphasis> the receiver is not an enum.</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+</orderedlist>
+</requirement>
+<simpara>Although index access is very limited, it is still possible to use immediate instances of <literal>Object</literal> in terms of a map (but this applies only to index access, not the dot notation):</simpara>
+<example>
+<title>Object as Map</title>
+<programlisting language="n4js" linenumbering="unnumbered">var map: Object = new Object();
+map["Kant"] = "Imperative";
+map["Hegel"] = "Dialectic";
+map.spinoza = "Am I?";  // error: Couldn't resolve reference to IdentifiableElement 'spinoza'.</programlisting>
+</example>
+<requirement xml:id="IDE-99">
+<title>Parameterized Property Access</title>
+<simpara>
+<anchor xml:id="Req-IDE-99" xreflabel="[Req-IDE-99]"/>
+<emphasis role="strong">Requirement: IDE-99:</emphasis>
+<link linkend="Req-IDE-99">Parameterized Property Access</link> (ver. 1)</simpara>
+    <simpara>
+
+For a parameterized property access expression <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>p</mi><mi>a</mi><mi>e</mi></math>, the following constraints must hold:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>The receiver or target must be a function or method:<?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>p</mi><mi>a</mi><mi>e</mi><mo>.</mo><mi>t</mi><mi>a</mi><mi>r</mi><mi>g</mi><mi>e</mi><mi>t</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mstyle mathvariant="monospace"><mtext>Function</mtext></mstyle></math></simpara>
+</listitem>
+<listitem>
+<simpara>The number of type arguments must match the number of type parameters of the generic function or method:<?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mo>|</mo><mi>p</mi><mi>a</mi><mi>e</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>A</mi><mi>r</mi><mi>g</mi><mi>s</mi><mo>|</mo><mo>=</mo><mo>|</mo><mi>p</mi><mi>a</mi><mi>e</mi><mo>.</mo><mi>t</mi><mi>a</mi><mi>r</mi><mi>g</mi><mi>e</mi><mi>t</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>V</mi><mi>a</mi><mi>r</mi><mi>s</mi><mo>|</mo></math></simpara>
+</listitem>
+<listitem>
+<simpara>The type arguments of a parameterized property access expression must be subtypes of the boundaries of the parameters of the called generic method.</simpara>
+</listitem>
+</orderedlist>
+<simpara>Also see constraints on read (<xref linkend="Req-IDE-93"/>) and write (<xref linkend="Req-IDE-121"/>) access.</simpara>
+</requirement>
+<bridgehead xml:id="type-inference-5" renderas="sect4">Type Inference</bridgehead>
+<simpara>Cf. [<link linkend="ECMA11a">ECMA11a(p.S11.2.1, p.p.67ff)</link>]</simpara>
+<simpara>We define the following type inferencing rules for property accessors:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>The type of an indexed-access expression <emphasis>p</emphasis> is inferred as follows:</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mtable><mtr><mtd><mfrac><mrow><mo>¬</mo><mi>p</mi><mo>.</mo><mi>t</mi><mi>a</mi><mi>r</mi><mi>g</mi><mi>e</mi><mi>t</mi><mo>.</mo><mi>d</mi><mi>y</mi><mi>n</mi><mo>∨</mo><mi>p</mi><mo>.</mo><mi>i</mi><mi>n</mi><mi>d</mi><mi>e</mi><mi>x</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mfenced close="]" open="["><mrow><mi>n</mi><mi>u</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi></mrow></mfenced><mspace width="3.0mm"/><mi>Γ</mi><mo>⊢</mo><mi>p</mi><mo>.</mo><mi>t</mi><mi>a</mi><mi>r</mi><mi>g</mi><mi>e</mi><mi>t</mi><mi>:</mi><mstyle mathvariant="monospace"><mtext>Array</mtext></mstyle><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>T</mtext></mstyle><mo>&gt;</mo></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mi>p</mi><mi>:</mi><mi>T</mi></mrow></mfrac></mtd></mtr><mtr><mtd><mfrac><mrow><mi>e</mi><mi>l</mi><mi>s</mi><mi>e</mi></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mi>p</mi><mi>:</mi><mstyle mathvariant="monospace"><mtext>any</mtext></mstyle></mrow></mfrac></mtd></mtr></mtable></math>
+</listitem>
+<listitem>
+<simpara>The type of a property access expression is inferred as follows:</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mtable><mtr><mtd><mfrac><mrow><mi>Γ</mi><mo>←</mo><mi>θ</mi><mfenced close=")" open="("><mi>R</mi></mfenced><mo>⊢</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mo>.</mo><mi>t</mi><mi>a</mi><mi>r</mi><mi>g</mi><mi>e</mi><mi>t</mi><mi>:</mi><mi>R</mi><mspace width="3.0mm"/><mi>Γ</mi><mo>⊢</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mo>.</mo><mi>p</mi><mi>r</mi><mi>o</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>t</mi><mi>y</mi><mi>:</mi><mi>T</mi></mrow><mrow><mstyle mathvariant="monospace"><mtext>PropertyAccessExpression</mtext></mstyle><mi> </mi><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>:</mi><mi>T</mi></mrow></mfrac></mtd></mtr></mtable></math>
+</listitem>
+<listitem>
+<simpara>The type of a parameterized access expression <emphasis>p</emphasis> is inferred as follows:</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mtable><mtr><mtd><mfrac><mrow><mo>∃</mo><mi>m</mi><mo>∈</mo><mi>p</mi><mo>.</mo><mi>t</mi><mi>a</mi><mi>r</mi><mi>g</mi><mi>e</mi><mi>t</mi><mi>:</mi><mi>m</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><mi>p</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mspace width="3.0mm"/><mi>Γ</mi><mo>⊢</mo><mi>m</mi><mi>:</mi><mi>T</mi></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mi>p</mi><mi>:</mi><mi>T</mi></mrow></mfrac></mtd></mtr><mtr><mtd><mfrac><mrow/><mrow><mi>Γ</mi><mo>⊢</mo><mi>p</mi><mi>:</mi><mstyle mathvariant="monospace"><mtext>any</mtext></mstyle></mrow></mfrac></mtd></mtr></mtable></math>
+</listitem>
+</itemizedlist>
+</section>
+</section>
+<section xml:id="_new-expression">
+<title>New Expression</title>
+<simpara>cf. [<link linkend="ECMA11a">ECMA11a(p.S11.2.2, p.p.68)</link>]</simpara>
+<bridgehead xml:id="new-expression-syntax" renderas="sect4">Syntax</bridgehead>
+<programlisting language="xtext" linenumbering="unnumbered">NewExpression: 'new' callee=MemberExpression&lt;Yield&gt; (-&gt; TypeArguments)?
+        (=&gt; withArgs?='(' Arguments&lt;Yield&gt;? ')' )?</programlisting>
+<programlisting language="n4js" linenumbering="unnumbered">import Address from "my/Address";
+
+var a = new Address();
+// a.type := my/Address
+
+class C&lt;T&gt; {
+    constructor(param: T) {}
+}
+var c = new C&lt;string&gt;("hello");</programlisting>
+<bridgehead xml:id="new-expression-semantics" renderas="sect4">Semantics</bridgehead>
+<requirement xml:id="IDE-100">
+<title>New expression</title>
+<simpara>
+<anchor xml:id="Req-IDE-100" xreflabel="[Req-IDE-100]"/>
+<emphasis role="strong">Requirement: IDE-100:</emphasis>
+<link linkend="Req-IDE-100">New expression</link> (ver. 1)</simpara>
+    <simpara>
+
+Let <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>n</mi><mi>e</mi></math> be a new expression, with <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>Γ</mi><mo>⊢</mo><mi>n</mi><mi>e</mi><mo>.</mo><mi>c</mi><mi>a</mi><mi>l</mi><mi>l</mi><mi>e</mi><mi>e</mi><mi>:</mi><mi>C</mi></math>.
+The following constraints must hold:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara><anchor xml:id="new-expression-1" xreflabel="[new-expression-1]"/> The callee must be a constructor type: <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>C</mi><mo>&lt;</mo><mi>:</mi><mstyle mathvariant="monospace"><mtext>constructor</mtext></mstyle><mfenced close="}" open="{"><mi>?</mi></mfenced></math>  or a constructable type.</simpara>
+</listitem>
+<listitem>
+<simpara><anchor xml:id="new-expression-2" xreflabel="[new-expression-2]"/> Let <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>O</mi></math> be the type argument of <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>C</mi></math>, that is <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>C</mi><mo>=</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>s</mi><mi>t</mi><mi>r</mi><mi>u</mi><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi><mfenced close="}" open="{"><mi>O</mi></mfenced></math>. In that case,</simpara>
+<orderedlist numeration="loweralpha">
+<listitem>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>O</mi></math> must not be an interface or enum: <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>μ</mi><mfenced close=")" open="("><mi>C</mi></mfenced><mo>∉</mo><mfenced close="}" open="{"><mstyle mathvariant="monospace"><mtext>Interface</mtext></mstyle><mstyle mathvariant="monospace"><mtext>Enum</mtext></mstyle></mfenced></math></simpara>
+</listitem>
+<listitem>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>O</mi></math> must not contain any wildcards.</simpara>
+</listitem>
+<listitem>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>O</mi></math> must not be a type variable.</simpara>
+</listitem>
+</orderedlist>
+</listitem>
+<listitem>
+<simpara><anchor xml:id="new-expression-3" xreflabel="[new-expression-3]"/> If <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>C</mi></math> is not a constructor type, it must be a constructable type, that is one of the following:</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfenced close="}" open="{"><mtable><mtr><mtd><mstyle mathvariant="monospace"><mtext>Object, Function, String, Boolean,</mtext></mstyle></mtd></mtr><mtr><mtd><mstyle mathvariant="monospace"><mtext>Number, Array, Date, RegExp, Error</mtext></mstyle></mtd></mtr></mtable></mfenced></math>
+<simpara>In particular, it must not refer to a primitive type or a defined
+functions (i.e., subtypes of <literal>Function</literal>) cannot be used in new-expressions in
+N4JS.</simpara>
+</listitem>
+</orderedlist>
+</requirement>
+<simpara>Remarks:</simpara>
+<simpara>to <link linkend="new-expression-1">1</link> The type of an abstract class <literal>A</literal> is <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mfenced close="}" open="{"><mi>A</mi></mfenced></math>.
+Or in other words: Only instantiable classes have an inferred type of <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>c</mi><mi>o</mi><mi>n</mi><mi>s</mi><mi>t</mi><mi>r</mi><mi>u</mi><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi><mfenced close="}" open="{"><mrow><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/></mrow></mfenced></math>.</simpara>
+<simpara>to <link linkend="new-expression-2">2</link> Even though it is possible to use the constructor type of an abstract class – concrete subclasses with override compatible constructor signature will be subclasses of this constructor.</simpara>
+<simpara>to <link linkend="new-expression-3">3</link> It is not possible to refer to union or intersection at that location. So this is not explicitly denied here since it is not possible anyway.</simpara>
+<example>
+<title>Abstract classes and construction</title>
+<simpara>The following examples demonstrates the usage of abstract classes and constructor types, to make the first two constraints more clearer:</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">/* XPECT_SETUP org.eclipse.n4js.spec.tests.N4JSSpecTest END_SETUP */
+
+abstract class A {}
+class B extends A {}
+
+// XPECT errors --&gt; "Cannot instantiate abstract class A." at "A"
+var x = new A();
+// XPECT noerrors --&gt;
+var y = new B();
+
+function foo(ctor : constructor{A}) {
+    // XPECT noerrors --&gt;
+    return new ctor();
+}
+
+// XPECT errors --&gt; "type{A} is not a subtype of constructor{A}." at "A"
+foo(A);
+// XPECT noerrors --&gt;
+foo(B);</programlisting>
+</example>
+<bridgehead xml:id="type-inference-6" renderas="sect4">Type Inference</bridgehead>
+<simpara>The type of a new expression <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>n</mi><mi>e</mi></math> is inferred as follows:</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><mi>Γ</mi><mo>⊢</mo><mi>n</mi><mi>e</mi><mo>.</mo><mi>c</mi><mi>a</mi><mi>l</mi><mi>l</mi><mi>e</mi><mi>e</mi><mi>:</mi><mstyle mathvariant="monospace"><mtext>constructor</mtext><mtext>C</mtext></mstyle></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mi>n</mi><mi>e</mi><mi>:</mi><mi>C</mi></mrow></mfrac></math>
+<simpara>For classes, constructors are described in <xref linkend="_constructor-and-classifier-type"/>.</simpara>
+<simpara>In N4JS it is not allowed to call new on a plain function.
+For example:</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">function foo() {}
+var x = new foo();</programlisting>
+<simpara>will issue an error.</simpara>
+</section>
+<section xml:id="_function-expression-2">
+<title>Function Expression</title>
+<simpara>See <xref linkend="_functions"/> for details.</simpara>
+</section>
+<section xml:id="_function-calls">
+<title>Function Calls</title>
+<simpara>In N4JS, a function call [<link linkend="ECMA11a">ECMA11a(p.S11.2.3)</link>] is similar to a method call.
+Additionally to the ECMAScript’s CallExpression, a ParameterizedCallExpression is introduced to allow type arguments passed to plain functions.</simpara>
+<bridgehead xml:id="_syntax-12" renderas="sect4">Syntax</bridgehead>
+<literallayout class="monospaced">[[function-calls-syntax]]</literallayout>
+<simpara>Similar to [<link linkend="ECMA11a">ECMA11a(p.S11.2.3, p.p.68ff)</link>], a function call is defined as follows:</simpara>
+<programlisting language="xtext" linenumbering="unnumbered">CallExpression &lt;Yield&gt;:
+    target=IdentifierRef&lt;Yield&gt;
+    ArgumentsWithParentheses&lt;Yield&gt;
+;
+
+ParameterizedCallExpression &lt;Yield&gt;:
+    TypeArguments
+    target=IdentifierRef&lt;Yield&gt;
+    ArgumentsWithParentheses&lt;Yield&gt;
+;
+
+fragment ArgumentsWithParentheses &lt;Yield&gt;*:
+    '(' Arguments&lt;Yield&gt;? ')'
+;
+
+fragment Arguments &lt;Yield&gt;*:
+    arguments+=AssignmentExpression&lt;In=true,Yield&gt; (',' arguments+=AssignmentExpression&lt;In=true,Yield&gt;)* (',' spread?='...' arguments+=AssignmentExpression&lt;In=true,Yield&gt;)?
+    | spread?='...' arguments+=AssignmentExpression&lt;In=true,Yield&gt;
+;</programlisting>
+<bridgehead xml:id="function-calls-semantics" renderas="sect4">Semantics</bridgehead>
+<requirement xml:id="IDE-101">
+<title>Function Call Constraints</title>
+<simpara>
+<anchor xml:id="Req-IDE-101" xreflabel="[Req-IDE-101]"/>
+<emphasis role="strong">Requirement: IDE-101:</emphasis>
+<link linkend="Req-IDE-101">Function Call Constraints</link> (ver. 1)</simpara>
+    <simpara>
+
+For a given call expression <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>f</mi></math> bound to a method or function declaration <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>F</mi></math>, the following constraints must hold:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>If less arguments are provided than formal parameters were declared, the missing formal parameters must have been declared optional:<?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mo>|</mo><mi>f</mi><mo>.</mo><mi>a</mi><mi>r</mi><mi>g</mi><mi>s</mi><mo>|</mo><mo>&lt;</mo><mo>|</mo><mi>F</mi><mo>.</mo><mi>p</mi><mi>a</mi><mi>r</mi><mi>s</mi><mo>|</mo><mo>→</mo><mo>∀</mo><mo>|</mo><mi>f</mi><mo>.</mo><mi>a</mi><mi>r</mi><mi>g</mi><mi>s</mi><mo>|</mo><mo>&lt;</mo><mi>i</mi><mo>≤</mo><mo>|</mo><mi>F</mi><mo>.</mo><mi>p</mi><mi>a</mi><mi>r</mi><mi>s</mi><mo>|</mo><mi>:</mi><msub><mi>F</mi><mi>p</mi></msub><mi>a</mi><mi>r</mi><msub><mi>s</mi><mi>i</mi></msub><mo>.</mo><mi>o</mi><mi>p</mi><mi>t</mi><mi>i</mi><mi>o</mi><mi>n</mi><mi>a</mi><mi>l</mi></math></simpara>
+</listitem>
+<listitem>
+<simpara>If more arguments are provided than formal parameters were declared, the last formal parameter must have been declared variadic:<?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mo>|</mo><mi>f</mi><mo>.</mo><mi>a</mi><mi>r</mi><mi>g</mi><mi>s</mi><mo>|</mo><mo>&gt;</mo><mo>|</mo><mi>F</mi><mo>.</mo><mi>p</mi><mi>a</mi><mi>r</mi><mi>s</mi><mo>|</mo><mo>→</mo><mi>F</mi><mo>.</mo><mi>p</mi><mi>a</mi><mi>r</mi><msub><mi>s</mi><mrow><mo>|</mo><mi>F</mi><mo>.</mo><mi>p</mi><mi>a</mi><mi>r</mi><mi>s</mi><mo>|</mo><mo>-</mo><mn>1</mn></mrow></msub><mo>.</mo><mi>v</mi><mi>a</mi><mi>r</mi><mi>i</mi><mi>a</mi><mi>d</mi><mi>i</mi><mi>c</mi></math></simpara>
+</listitem>
+<listitem>
+<simpara>Types of provided arguments must be subtypes of the formal parameter types:<?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∀</mo><mn>0</mn><mo>&lt;</mo><mi>i</mi><mo>&lt;</mo><mi>m</mi><mi>i</mi><mi>n</mi><mfenced close=")" open="("><mrow><mo>|</mo><mi>f</mi><mo>.</mo><mi>a</mi><mi>r</mi><mi>g</mi><mi>s</mi><mo>|</mo></mrow><mrow><mo>|</mo><mi>F</mi><mo>.</mo><mi>p</mi><mi>a</mi><mi>r</mi><mi>s</mi><mo>|</mo></mrow></mfenced><mi>:</mi><mi>f</mi><mo>.</mo><mi>a</mi><mi>r</mi><mi>g</mi><msub><mi>s</mi><mi>i</mi></msub><mo>&lt;</mo><mi>:</mi><mi>F</mi><mo>.</mo><mi>p</mi><mi>a</mi><mi>r</mi><msub><mi>s</mi><mi>i</mi></msub></math></simpara>
+</listitem>
+<listitem>
+<simpara>If more arguments are provided than formal parameters were declared, the type of the exceeding arguments must be a subtype of the last (variadic) formal parameter type:<?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∀</mo><mo>|</mo><mi>F</mi><mo>.</mo><mi>p</mi><mi>a</mi><mi>r</mi><mi>s</mi><mo>|</mo><mo>&lt;</mo><mi>i</mi><mo>≤</mo><mo>|</mo><mi>f</mi><mo>.</mo><mi>a</mi><mi>r</mi><mi>g</mi><mi>s</mi><mo>|</mo><mi>:</mi><mi>f</mi><mo>.</mo><mi>a</mi><mi>r</mi><mi>g</mi><msub><mi>s</mi><mi>i</mi></msub><mo>&lt;</mo><mi>:</mi><mi>F</mi><mo>.</mo><mi>p</mi><mi>a</mi><mi>r</mi><msub><mi>s</mi><mrow><mo>|</mo><mi>F</mi><mo>.</mo><mi>p</mi><mi>a</mi><mi>r</mi><mi>s</mi><mo>|</mo><mo>-</mo><mn>1</mn></mrow></msub></math></simpara>
+</listitem>
+</itemizedlist>
+</requirement>
+<requirement xml:id="IDE-102">
+<title>Parameterized Function Call Constraints</title>
+<simpara>
+<anchor xml:id="Req-IDE-102" xreflabel="[Req-IDE-102]"/>
+<emphasis role="strong">Requirement: IDE-102:</emphasis>
+<link linkend="Req-IDE-102">Parameterized Function Call Constraints</link> (ver. 1)</simpara>
+    <simpara>
+
+* The number of type arguments in a parameterized call expression must be equal to the number of type parameters of the generic function / method and the
+type arguments must be subtypes of the corresponding declared upper boundaries of the type parameters of the called generic function.</simpara>
+<simpara>Note that (for a limited time), constraints <xref linkend="Req-IDE-101"/> and <xref linkend="Req-IDE-102"/> are not applied if the the type of <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>F</mi></math> is <literal>Function</literal>.
+See <xref linkend="_function-object-type"/>.</simpara>
+</requirement>
+<bridgehead xml:id="type-inference-7" renderas="sect4">Type Inference</bridgehead>
+<simpara>A call expression <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi></math> is bound to a method (<xref linkend="_methods"/>) or function declaration (which may be part of a function definition
+(<xref linkend="_function-declaration"/> or specified via a function type <xref linkend="_function-type"/>) <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>F</mi></math> (via evaluation of <literal>MemberExpression</literal>.
+The type of the call is inferred from the function declaration or type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>F</mi></math> as follows:</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><mi>b</mi><mi>i</mi><mi>n</mi><mi>d</mi><mfenced close=")" open="("><mrow><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mo>.</mo><mi>t</mi><mi>a</mi><mi>r</mi><mi>g</mi><mi>e</mi><mi>t</mi></mrow><mi>F</mi></mfenced><mspace width="3.0mm"/><mi>F</mi><mo>.</mo><mi>r</mi><mi>e</mi><mi>t</mi><mi>u</mi><mi>r</mi><mi>n</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>:</mi><mi>T</mi></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>:</mi><mi>T</mi></mrow></mfrac></math>
+<simpara>A generic method invocation may be parameterized as well.
+This is rarely required as the function argument types are usually inferred from the given arguments.
+In some cases, for instance with pathSelectors, this is useful.
+In that case, the type variable defined in the generic method declaration is explicitly bound to types by using type arguments.
+See <xref linkend="_property-accessors"/> for semantics and type inference.</simpara>
+<example>
+<title>Generic Method Invocation</title>
+<simpara>This examples demonstrate how to explicitly
+define the type argument in a method call in case it cannot be inferred
+automatically.</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">class C {
+    static &lt;T&gt; foo(p: pathSelector&lt;T&gt;): void {..}
+};
+C.&lt;my.Address&gt;foo("street.number");</programlisting>
+<simpara>Note that in many cases, the type inferencer should be able to infer the type automatically.
+For example, for a method</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">function &lt;T&gt; bar(c: T, p: pathSelector&lt;T&gt;): void {..};</programlisting>
+<simpara>and a function call</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">bar(context, "some.path.selector");
+[source,n4js]</programlisting>
+<simpara>the type variable <literal>T</literal> can be automatically bound to the type of variable <literal>context</literal>.</simpara>
+</example>
+</section>
+<section xml:id="_postfix-expression">
+<title>Postfix Expression</title>
+<bridgehead xml:id="postfix-expression-syntax" renderas="sect4">Syntax</bridgehead>
+<programlisting language="xtext" linenumbering="unnumbered">PostfixExpression returns Expression: LeftHandSideExpression
+         (=&gt;({PostfixExpression.expression=current} /* no line terminator here */ op=PostfixOperator))?
+    ;
+enum PostfixOperator: inc='++' | dec='--';</programlisting>
+<bridgehead xml:id="semantics-and-type-inference" renderas="sect4">Semantics and Type Inference</bridgehead>
+<simpara>The type inference and constraints for postfix operators <literal>++</literal> and <literal>--</literal>, cf. [<link linkend="ECMA11a">ECMA11a(p.S11.3.1, p.p.70)</link>], [<link linkend="ECMA11a">ECMA11a(p.S11.3.1, p.p.70)</link>],
+are defined similarly to their prefix variants (unary expressions), see <xref linkend="_unary-expression"/>.</simpara>
+<requirement xml:id="IDE-103">
+<title>Postfix Expression Constraints</title>
+<simpara>
+<anchor xml:id="Req-IDE-103" xreflabel="[Req-IDE-103]"/>
+<emphasis role="strong">Requirement: IDE-103:</emphasis>
+<link linkend="Req-IDE-103">Postfix Expression Constraints</link> (ver. 1)</simpara>
+    <simpara>
+</simpara>
+<simpara>For a given postfix expression <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>u</mi></math> <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>u</mi></math> with <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>u</mi><mo>.</mo><mi>o</mi><mi>p</mi><mo>∈</mo><mfenced close="}" open="{"><mrow><mo>+</mo><mo>+</mo></mrow><mrow><mo>-</mo><mo>-</mo></mrow></mfenced></math> and <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>u</mi><mo>.</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>e</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>o</mi><mi>n</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>:</mi><mi>T</mi></math>, the following constraints must hold:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>In N4JS mode, the type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi></math> of the expression must be a number.</simpara>
+</listitem>
+<listitem>
+<simpara>If <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>u</mi><mo>.</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>e</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>o</mi><mi>n</mi><mo>=</mo><mi>P</mi><mi>r</mi><mi>o</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>t</mi><mi>y</mi><mi>A</mi><mi>c</mi><mi>c</mi><mi>e</mi><mi>s</mi><mi>s</mi><mspace width="0.278em"/><mi>p</mi><mi>a</mi><mfenced close=")" open="("><mi>p</mi></mfenced><mo>∧</mo><mi>p</mi><mi>a</mi><mo>.</mo><mi>i</mi><mi>s</mi><mi>D</mi><mi>o</mi><mi>t</mi><mi>A</mi><mi>c</mi><mi>c</mi><mi>e</mi><mi>s</mi><mi>s</mi><mo>→</mo></math> both <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>g</mi><mi>e</mi><mi>t</mi></math> <emphasis>p</emphasis> and <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>s</mi><mi>e</mi><mi>t</mi></math> <emphasis>p</emphasis> must be defined.</simpara>
+</listitem>
+</itemizedlist>
+</requirement>
+</section>
+<section xml:id="_unary-expression">
+<title>Unary Expression</title>
+<bridgehead xml:id="unary-expression-syntax" renderas="sect4">Syntax</bridgehead>
+<simpara>We define the following unary operators and expression, similar to [<link linkend="ECMA11a">ECMA11a(p.p.70ff)</link>]:</simpara>
+<programlisting language="xtext" linenumbering="unnumbered">UnaryExpression returns Expression:
+      PostfixExpression
+    | ({UnaryExpression} op=UnaryOperator expression=UnaryExpression);
+enum UnaryOperator: delete | void | typeof | inc='++' | dec='--' | pos='+' | neg='-' | inv='$\sim$' | not='!';</programlisting>
+<bridgehead xml:id="unary-expression-semantics" renderas="sect4">Semantics</bridgehead>
+<simpara>For semantics of the delete operator, see also [<link linkend="MozillaJSRef">MozillaJSRef</link>]</simpara>
+<requirement xml:id="IDE-104">
+<title>Delete Operator Constraints</title>
+<simpara>
+<anchor xml:id="Req-IDE-104" xreflabel="[Req-IDE-104]"/>
+<emphasis role="strong">Requirement: IDE-104:</emphasis>
+<link linkend="Req-IDE-104">Delete Operator Constraints</link> (ver. 1)</simpara>
+    <simpara>
+
+For a given unary expression <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>u</mi></math> with <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>u</mi><mo>.</mo><mi>o</mi><mi>p</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>delete</mtext></mstyle></math>, the following constraints must hold:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>In strict mode, <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>u</mi><mo>.</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>e</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>o</mi><mi>n</mi></math> must be a reference to a property of an object literal, a member of a class type, or to a property of the global type
+(i.e., the reference must be bound, and the bound target must not be a variable).</simpara>
+</listitem>
+<listitem>
+<simpara>In N4JS mode, the referenced property or member must not be declared in the containing type and the containing type reference must be declared dynamic.</simpara>
+</listitem>
+</itemizedlist>
+</requirement>
+<requirement xml:id="IDE-105">
+<title>Void Operator Constraints</title>
+<simpara>
+<anchor xml:id="Req-IDE-105" xreflabel="[Req-IDE-105]"/>
+<emphasis role="strong">Requirement: IDE-105:</emphasis>
+<link linkend="Req-IDE-105">Void Operator Constraints</link> (ver. 1)</simpara>
+    <simpara>
+
+There are no specific constraints defined for with <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>u</mi><mo>.</mo><mi>o</mi><mi>p</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>void</mtext></mstyle></math></simpara>
+</requirement>
+<requirement xml:id="IDE-106">
+<title>Typeof Operator Constraints</title>
+<simpara>
+<anchor xml:id="Req-IDE-106" xreflabel="[Req-IDE-106]"/>
+<emphasis role="strong">Requirement: IDE-106:</emphasis>
+<link linkend="Req-IDE-106">Typeof Operator Constraints</link> (ver. 1)</simpara>
+    <simpara>
+
+There are no specific constraints defined for unary expression <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>u</mi></math> with <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>u</mi><mo>.</mo><mi>o</mi><mi>p</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>typeof</mtext></mstyle></math>.</simpara>
+</requirement>
+<requirement xml:id="IDE-107">
+<title>Increment/Decrement Constraints</title>
+<simpara>
+<anchor xml:id="Req-IDE-107" xreflabel="[Req-IDE-107]"/>
+<emphasis role="strong">Requirement: IDE-107:</emphasis>
+<link linkend="Req-IDE-107">Increment/Decrement Constraints</link> (ver. 1)</simpara>
+    <simpara>
+
+For a given unary expression <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>u</mi></math> <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>u</mi></math> with <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>u</mi><mo>.</mo><mi>o</mi><mi>p</mi><mo>∈</mo><mfenced close="}" open="{"><mrow><mo>+</mo><mo>+</mo></mrow><mrow><mo>-</mo><mo>-</mo></mrow></mfenced></math> and <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>u</mi><mo>.</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>e</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>o</mi><mi>n</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>:</mi><mi>T</mi></math>, the following constraints must hold:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>If mode is N4JS,  the type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi></math> of the expression must be a number</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow/><mrow><mi>Γ</mi><mo>⊢</mo><mstyle mathvariant="monospace"><mtext>UnaryExpression</mtext></mstyle><mo>⊲</mo><mstyle mathvariant="monospace"><mtext>Expression</mtext></mstyle><mi>:</mi><mstyle mathvariant="monospace"><mtext>number</mtext></mstyle></mrow></mfrac></math>
+</listitem>
+<listitem>
+<simpara>If <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>u</mi><mo>.</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>e</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>o</mi><mi>n</mi><mo>=</mo><mi>P</mi><mi>r</mi><mi>o</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>t</mi><mi>y</mi><mi>A</mi><mi>c</mi><mi>c</mi><mi>e</mi><mi>s</mi><mi>s</mi><mspace width="0.278em"/><mi>p</mi><mi>a</mi><mfenced close=")" open="("><mi>p</mi></mfenced><mo>∧</mo><mi>p</mi><mi>a</mi><mo>.</mo><mi>i</mi><mi>s</mi><mi>D</mi><mi>o</mi><mi>t</mi><mi>A</mi><mi>c</mi><mi>c</mi><mi>e</mi><mi>s</mi><mi>s</mi></math> <math xmlns="http://www.w3.org/1998/Math/MathML"><mo>→</mo></math> both <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>g</mi><mi>e</mi><mi>t</mi></math> <emphasis>p</emphasis> and <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>s</mi><mi>e</mi><mi>t</mi></math> <emphasis>p</emphasis> must be defined.</simpara>
+</listitem>
+</itemizedlist>
+</requirement>
+<requirement xml:id="IDE-108">
+<title>Unary Plus/Minus/Bitwise Not Operator Constraints</title>
+<simpara>
+<anchor xml:id="Req-IDE-108" xreflabel="[Req-IDE-108]"/>
+<emphasis role="strong">Requirement: IDE-108:</emphasis>
+<link linkend="Req-IDE-108">Unary Plus/Minus/Bitwise Not Operator Constraints</link> (ver. 1)</simpara>
+    <simpara>
+
+For a given unary expression <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>u</mi></math> <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>u</mi></math> with <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>u</mi><mo>.</mo><mi>o</mi><mi>p</mi><mo>∈</mo><mfenced close="}" open="{"><mo>+</mo><mo>-</mo><mo>∼</mo></mfenced></math> and <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>u</mi><mo>.</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>e</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>o</mi><mi>n</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>:</mi><mi>T</mi></math>, the following constraints must hold:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>In N4JS mode, the type T of the expression must be a number:</simpara>
+</listitem>
+</itemizedlist>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow/><mrow><mi>Γ</mi><mo>⊢</mo><mstyle mathvariant="monospace"><mtext>UnaryExpression</mtext></mstyle><mo>⊲</mo><mstyle mathvariant="monospace"><mtext>Expression</mtext></mstyle><mi>:</mi><mstyle mathvariant="monospace"><mtext>number</mtext></mstyle></mrow></mfrac></math>
+</requirement>
+<requirement xml:id="IDE-109">
+<title>Logical Not Operator Constraints</title>
+<simpara>
+<anchor xml:id="Req-IDE-109" xreflabel="[Req-IDE-109]"/>
+<emphasis role="strong">Requirement: IDE-109:</emphasis>
+<link linkend="Req-IDE-109">Logical Not Operator Constraints</link> (ver. 1)</simpara>
+    <simpara>
+
+There are no specific constraints defined for with <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>u</mi><mo>.</mo><mi>o</mi><mi>p</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>!</mtext></mstyle></math>.</simpara>
+</requirement>
+<bridgehead xml:id="type-inference-8" renderas="sect4">Type Inference</bridgehead>
+<simpara>The following operators have fixed types independent of their operand types:</simpara>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mfrac><mrow/><mrow><mi>Γ</mi><mo>⊢</mo><mstyle mathvariant="monospace"><mtext>’delete’</mtext></mstyle><mi> </mi><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>e</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>o</mi><mi>n</mi><mi>:</mi><mstyle mathvariant="monospace"><mtext>boolean</mtext></mstyle></mrow></mfrac></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mfrac><mrow/><mrow><mi>Γ</mi><mo>⊢</mo><mstyle mathvariant="monospace"><mtext>’void’</mtext></mstyle><mi> </mi><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>e</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>o</mi><mi>n</mi><mi>:</mi><mstyle mathvariant="monospace"><mtext>undefined</mtext></mstyle></mrow></mfrac></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mfrac><mrow/><mrow><mi>Γ</mi><mo>⊢</mo><mstyle mathvariant="monospace"><mtext>’typeof’</mtext></mstyle><mi> </mi><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>e</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>o</mi><mi>n</mi><mi>:</mi><mstyle mathvariant="monospace"><mtext>string</mtext></mstyle></mrow></mfrac></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mfrac><mrow/><mrow><mi>Γ</mi><mo>⊢</mo><mstyle mathvariant="monospace"><mtext>(’++’—’–’—’+’—’-’—’ ’)</mtext></mstyle><mi> </mi><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>e</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>o</mi><mi>n</mi><mi>:</mi><mstyle mathvariant="monospace"><mtext>number</mtext></mstyle></mrow></mfrac></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mfrac><mrow/><mrow><mi>Γ</mi><mo>⊢</mo><mstyle mathvariant="monospace"><mtext>’!’</mtext></mstyle><mi> </mi><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>e</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>o</mi><mi>n</mi><mi>:</mi><mstyle mathvariant="monospace"><mtext>boolean</mtext></mstyle></mrow></mfrac></math></simpara>
+</section>
+<section xml:id="_multiplicative-expression">
+<title>Multiplicative Expression</title>
+<bridgehead xml:id="multiplicative-expression-syntax" renderas="sect4">Syntax</bridgehead>
+<simpara>Cf. [<link linkend="ECMA11a">ECMA11a(p.p.73ff)</link>]</simpara>
+<programlisting language="xtext" linenumbering="unnumbered">MultiplicativeExpression returns Expression: UnaryExpression
+      (=&gt;({MultiplicativeExpression.lhs=current} op=MultiplicativeOperator) rhs=UnaryExpression)*;
+enum MultiplicativeOperator: times='*' | div='/' | mod='%';</programlisting>
+<bridgehead xml:id="multiplicative-expression-semantics" renderas="sect4">Semantics</bridgehead>
+<requirement xml:id="IDE-110">
+<title>Multiplicative Expression Constraints</title>
+<simpara>
+<anchor xml:id="Req-IDE-110" xreflabel="[Req-IDE-110]"/>
+<emphasis role="strong">Requirement: IDE-110:</emphasis>
+<link linkend="Req-IDE-110">Multiplicative Expression Constraints</link> (ver. 1)</simpara>
+    <simpara>
+
+For a given multiplicative expression the following constraints must hold in N4JS mode :</simpara>
+<itemizedlist>
+<listitem>
+<simpara>The types of the operands may be any type:</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow/><mrow><mi>Γ</mi><mo>⊢</mo><mstyle mathvariant="monospace"><mtext>MultiplicativeExpression</mtext></mstyle><mo>⊲</mo><mstyle mathvariant="monospace"><mtext>Expression</mtext></mstyle><mi>:</mi><mstyle mathvariant="monospace"><mtext>any</mtext></mstyle></mrow></mfrac><mrow/></math>
+</listitem>
+</itemizedlist>
+</requirement>
+<simpara>If a non-numeric operand is used, the result may be <literal>NaN</literal> which actually is a number as well.</simpara>
+<bridgehead xml:id="_type-inference-6" renderas="sect4">Type Inference</bridgehead>
+<literallayout class="monospaced">[[type-inference-9]]</literallayout>
+<simpara>The inferred type of a multiplicative expression always is number:</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow/><mrow><mi>Γ</mi><mo>⊢</mo><mstyle mathvariant="monospace"><mtext>MultiplicativeExpression</mtext></mstyle><mi>:</mi><mstyle mathvariant="monospace"><mtext>number</mtext></mstyle></mrow></mfrac></math>
+</section>
+<section xml:id="_additive-expression">
+<title>Additive Expression</title>
+<bridgehead xml:id="additive-expression-syntax" renderas="sect4">Syntax</bridgehead>
+<simpara>Cf. [<link linkend="ECMA11a">ECMA11a(p.p.75ff)</link>]</simpara>
+<programlisting language="xtext" linenumbering="unnumbered">AdditiveExpression returns Expression: MultiplicativeExpression
+    (=&gt;({AdditiveExpression.lhs=current} op=AdditiveOperator) rhs=MultiplicativeExpression)*;
+enum AdditiveOperator: add='+' | sub='-';</programlisting>
+<bridgehead xml:id="additive-expression-semantics" renderas="sect4">Semantics</bridgehead>
+<requirement xml:id="IDE-111">
+<title>Additive Expression Constraints</title>
+<simpara>
+<anchor xml:id="Req-IDE-111" xreflabel="[Req-IDE-111]"/>
+<emphasis role="strong">Requirement: IDE-111:</emphasis>
+<link linkend="Req-IDE-111">Additive Expression Constraints</link> (ver. 1)</simpara>
+    <simpara>
+</simpara>
+<simpara>For a given additive expression the following constraints must hold in N4JS mode:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>The type of the operand can be any type:</simpara>
+</listitem>
+</itemizedlist>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mtable><mtr><mtd><mfrac><mrow/><mrow><mi>Γ</mi><mo>⊢</mo><mstyle mathvariant="monospace"><mtext>AdditiveExpression</mtext></mstyle><mi> </mi><mi>e</mi><mo>⊲</mo><mstyle mathvariant="monospace"><mtext>Expression</mtext></mstyle><mi>:</mi><mstyle mathvariant="monospace"><mtext>any</mtext></mstyle></mrow></mfrac></mtd></mtr></mtable></math>
+</requirement>
+<simpara>In JavaScript it is possible to subtract two non-numerics, leading to <literal>NaN</literal>. Also <literal>undefined</literal> or <literal>null</literal> may be used. The real difference is what type is to be returned (string or number, see below).</simpara>
+<section xml:id="type-inference-10">
+<title>Type Inference</title>
+<simpara role="language-n4js">The type of an additive expression is usually inferred to <literal>number</literal>, except for addition which may lead to string as well.
+The result for the addition operator is only be a number if both operands are numbers, booleans, null, or undefined.
+Using <literal>undefined</literal> in an additive expression leads to <literal>NaN</literal> which actually is a number from the type system&#8217;s point of view. Additional analysis may create errors in the latter case though.</simpara>
+<simpara>We first define two helper rules to simplify the addition operator condition:</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mtable><mtr><mtd><mfrac><mrow><mo>∃</mo><mi>N</mi><mi>i</mi><mi>n</mi><mfenced close="}" open="{"><mstyle mathvariant="monospace"><mtext>number, int, boolean, null, undefined</mtext></mstyle></mfenced><mi>:</mi><mi>T</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mo>=</mo><mi>N</mi></mrow><mrow><mi>n</mi><mi>b</mi><mfenced close=")" open="("><mi>T</mi></mfenced></mrow></mfrac><mstyle mathvariant="monospace"><mtext>nb</mtext></mstyle></mtd></mtr><mtr><mtd><mfrac><mrow><mi>n</mi><mi>b</mi><mfenced close=")" open="("><mi>T</mi></mfenced><mo>∨</mo><mi> </mi><mrow><mo>(</mo><mi>μ</mi><mfenced close=")" open="("><mi>T</mi></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>Union</mtext></mstyle><mi> </mi><mo>∧</mo><mi> </mi><mo>∃</mo><mi> </mi><mi>E</mi><mo>∈</mo><mi>T</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mi>s</mi><mi>:</mi><mi>m</mi><mi>n</mi><mi>b</mi><mfenced close=")" open="("><mi>E</mi></mfenced></mrow></mrow><mrow><mi>m</mi><mi>n</mi><mi>b</mi><mfenced close=")" open="("><mi>T</mi></mfenced></mrow></mfrac><mstyle mathvariant="monospace"><mtext>mnb</mtext></mstyle></mtd></mtr><mtr><mtd><mfrac><mrow><mi>Γ</mi><mo>⊢</mo><mi>e</mi><mo>.</mo><mi>l</mi><mi>h</mi><mi>s</mi><mi>:</mi><mi>L</mi><mspace width="3.0mm"/><mi>Γ</mi><mo>⊢</mo><mi>e</mi><mo>.</mo><mi>r</mi><mi>h</mi><mi>s</mi><mi>:</mi><mi>R</mi><mspace width="3.0mm"/><mi>n</mi><mi>b</mi><mfenced close=")" open="("><mi>L</mi></mfenced><mspace width="3.0mm"/><mi>n</mi><mi>b</mi><mfenced close=")" open="("><mi>R</mi></mfenced></mrow><mrow><mi>t</mi><mi>o</mi><mi>N</mi><mi>u</mi><mi>m</mi><mfenced close=")" open="("><mrow><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi></mrow></mfenced></mrow></mfrac><mstyle mathvariant="monospace"><mtext>toNum</mtext></mstyle></mtd></mtr><mtr><mtd><mfrac><mrow><mi>Γ</mi><mo>⊢</mo><mi>e</mi><mo>.</mo><mi>l</mi><mi>h</mi><mi>s</mi><mi>:</mi><mi>L</mi><mspace width="3.0mm"/><mi>Γ</mi><mo>⊢</mo><mi>e</mi><mo>.</mo><mi>r</mi><mi>h</mi><mi>s</mi><mi>:</mi><mi>R</mi><mspace width="3.0mm"/><mi>m</mi><mi>n</mi><mi>b</mi><mfenced close=")" open="("><mi>L</mi></mfenced><mspace width="3.0mm"/><mi>m</mi><mi>n</mi><mi>b</mi><mfenced close=")" open="("><mi>R</mi></mfenced></mrow><mrow><mi>m</mi><mi>a</mi><mi>y</mi><mi>N</mi><mi>u</mi><mi>m</mi><mfenced close=")" open="("><mrow><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi></mrow></mfenced></mrow></mfrac><mstyle mathvariant="monospace"><mtext>mayNum</mtext></mstyle></mtd></mtr></mtable></math>
+<simpara>The type of an additive expression <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>e</mi></math> is inferred as follows:</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mtable><mtr><mtd><mfrac><mrow><mi>e</mi><mo>.</mo><mi>o</mi><mi>p</mi><msup><mo>=</mo><mi>'</mi></msup><msup><mo>+</mo><mi>'</mi></msup><mspace width="3.0mm"/><mo>¬</mo><mi>t</mi><mi>o</mi><mi>N</mi><mi>u</mi><mi>m</mi><mfenced close=")" open="("><mi>e</mi></mfenced><mspace width="3.0mm"/><mo>¬</mo><mi>m</mi><mi>a</mi><mi>y</mi><mi>N</mi><mi>u</mi><mi>m</mi><mfenced close=")" open="("><mi>e</mi></mfenced></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mi>e</mi><mi>:</mi><mstyle mathvariant="monospace"><mtext>string</mtext></mstyle></mrow></mfrac></mtd></mtr><mtr><mtd><mfrac><mrow><mi>e</mi><mo>.</mo><mi>o</mi><mi>p</mi><msup><mo>=</mo><mi>'</mi></msup><msup><mo>+</mo><mi>'</mi></msup><mspace width="3.0mm"/><mo>¬</mo><mi>t</mi><mi>o</mi><mi>N</mi><mi>u</mi><mi>m</mi><mfenced close=")" open="("><mi>e</mi></mfenced><mspace width="3.0mm"/><mi>m</mi><mi>a</mi><mi>y</mi><mi>N</mi><mi>u</mi><mi>m</mi><mfenced close=")" open="("><mi>e</mi></mfenced></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mi>e</mi><mi>:</mi><mi>u</mi><mi>n</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><mi>n</mi><mi>u</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi><mo>,</mo><mi>s</mi><mi>t</mi><mi>r</mi><mi>i</mi><mi>n</mi><mi>g</mi></mrow></mfenced></mrow></mfrac></mtd></mtr><mtr><mtd><mfrac><mrow><mi>e</mi><mo>.</mo><mi>o</mi><mi>p</mi><msup><mo>=</mo><mi>'</mi></msup><msup><mo>+</mo><mi>'</mi></msup><mspace width="3.0mm"/><mi>t</mi><mi>o</mi><mi>N</mi><mi>u</mi><mi>m</mi><mfenced close=")" open="("><mi>e</mi></mfenced></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mi>e</mi><mi>:</mi><mstyle mathvariant="monospace"><mtext>number</mtext></mstyle></mrow></mfrac></mtd></mtr><mtr><mtd><mfrac><mrow><mi>e</mi><mo>.</mo><mi>o</mi><mi>p</mi><msup><mo>≤</mo><mi>'</mi></msup><msup><mo>+</mo><mi>'</mi></msup></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mi>e</mi><mi>:</mi><mstyle mathvariant="monospace"><mtext>number</mtext></mstyle></mrow></mfrac></mtd></mtr></mtable></math>
+<simpara>That is, if both operands are number, int, boolean, null, or even undefined, then the 'plus' is interpreted as
+mathematical addition and the result is a number. In other cases the 'plus' is interpreted as string concatenation and the result is a string. In case of union types, the result may be a union of number and string.</simpara>
+<simpara>Adding two integers (int) leads to a number, since the result may not be represented as an (JavaScript) int anymore.</simpara>
+<example>
+<title>Type of addition expression</title>
+<programlisting language="xtext" linenumbering="unnumbered">1+2;            // number 3
+"1"+"2";        // string "12"
+"1"+2;          // string "12"
+1+true;         // number 2
+false+1;        // number 1
+"1"+true;       // string "1true"
+"1"+null;       // string "1null"
+1+null;         // number 1
+1+undefined;    // number NaN
+"1"+undefined;  // string "1undefined"</programlisting>
+</example>
+<simpara>Support new <literal>Symbol.toPrimitive</literal>.</simpara>
+</section>
+</section>
+<section xml:id="_bitwise-shift-expression">
+<title>Bitwise Shift Expression</title>
+<bridgehead xml:id="bitwise-shift-expression-syntax" renderas="sect4">Syntax</bridgehead>
+<literallayout class="monospaced">Cf. +[+&lt;&lt;ECMA11a,ECMA11a(p.p.76f)&gt;&gt;+]+</literallayout>
+<programlisting language="xtext" linenumbering="unnumbered">ShiftExpression returns Expression: AdditiveExpression
+    (=&gt;({ShiftExpression.lhs=current} op=ShiftOperator rhs=AdditiveExpression))*
+;
+
+ShiftOperator returns ShiftOperator:
+      '&gt;' '&gt;' '&gt;'? // SHR, USHR
+    | '&lt;' '&lt;'  // SHL
+    ;</programlisting>
+<bridgehead xml:id="bitwise-shift-expression-semantics" renderas="sect4">Semantics</bridgehead>
+<requirement xml:id="IDE-112">
+<title>Bitwise Shift Expression Constraints</title>
+<simpara>
+<anchor xml:id="Req-IDE-112" xreflabel="[Req-IDE-112]"/>
+<emphasis role="strong">Requirement: IDE-112:</emphasis>
+<link linkend="Req-IDE-112">Bitwise Shift Expression Constraints</link> (ver. 1)</simpara>
+    <simpara>
+
+For a given bitwise shift expression <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>e</mi></math> the following constraints must hold in N4JS mode:
+* The types of the operands can be any.</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow/><mrow><mi>Γ</mi><mo>⊢</mo><mstyle mathvariant="monospace"><mtext>BitwiseShiftExpression</mtext></mstyle><mi> </mi><mo>⊲</mo><mi> </mi><mstyle mathvariant="monospace"><mtext>Expression</mtext></mstyle><mi>:</mi><mstyle mathvariant="monospace"><mtext>any</mtext></mstyle></mrow></mfrac></math>
+</requirement>
+<bridgehead xml:id="type-inference-11" renderas="sect4">Type Inference</bridgehead>
+<simpara>The type returned by a bitwise shift expression is always <literal>number</literal>:</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mspace width="3.0mm"/><mfrac><mrow/><mrow><mi>Γ</mi><mo>⊢</mo><mi> </mi><mrow><mo>(</mo><mrow><mstyle mathvariant="monospace"><mtext>Expression (’</mtext></mstyle><mo>&lt;</mo><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>’—’</mtext></mstyle><mo>&gt;</mo><mo>&gt;</mo><mstyle mathvariant="monospace"><mtext>’—’</mtext></mstyle><mo>&gt;</mo><mo>&gt;</mo><mo>&gt;</mo><mstyle mathvariant="monospace"><mtext>’)</mtext> <mtext>Expression</mtext></mstyle><mo>)</mo></mrow><mi>:</mi><mstyle mathvariant="monospace"><mtext>number</mtext></mstyle></mrow></mrow></mfrac><mtext>
+</mtext></math>
+<simpara>A non-numeric operand is interpreted as 0, except for <literal>true</literal> which is interpreted as <literal>1</literal>; or objects implementing the symbol <literal>toPrimitive</literal>.</simpara>
+</section>
+<section xml:id="_relational-expression">
+<title>Relational Expression</title>
+<bridgehead xml:id="relational-expression-syntax" renderas="sect4">Syntax</bridgehead>
+<simpara>Cf. [<link linkend="ECMA11a">ECMA11a(p.p.77ff)</link>]</simpara>
+<programlisting language="xtext" linenumbering="unnumbered">RelationalExpression returns Expression: ShiftExpression
+    (=&gt;({RelationalExpression.lhs=current} op=RelationalOperator) rhs=ShiftExpression)*;
+
+RelationalExpressionNoIn returns Expression: ShiftExpression
+    (=&gt;({RelationalExpression.lhs=current} op=RelationalOperatorNoIn) rhs=ShiftExpression)*;
+
+enum RelationalOperator:
+    lt='&lt;' | gt='&gt;' | lte='&lt;=' | gte='&gt;=' | instanceof | in;
+RelationalOperatorNoIn returns RelationalOperator:
+    '&lt;' | '&gt;' | '&lt;=' | '&gt;=' | 'instanceof';</programlisting>
+<bridgehead xml:id="relational-expression-semantics" renderas="sect4">Semantics</bridgehead>
+<requirement xml:id="IDE-113">
+<title>Greater/Less (Equals) Operator Constraints</title>
+<simpara>
+<anchor xml:id="Req-IDE-113" xreflabel="[Req-IDE-113]"/>
+<emphasis role="strong">Requirement: IDE-113:</emphasis>
+<link linkend="Req-IDE-113">Greater/Less (Equals) Operator Constraints</link> (ver. 1)</simpara>
+    <simpara>
+</simpara>
+<simpara>For a given relational expression <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>e</mi></math> with <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>e</mi><mo>.</mo><mi>o</mi><mi>p</mi><mo>∈</mo><mrow><mo>{</mo><mrow><mo>&lt;</mo><mo>,</mo><mo>&gt;</mo><mo>,</mo><mo>&lt;</mo><mo>=</mo><mo>,</mo><mo>&gt;</mo><mo>=</mo><mo>}</mo></mrow></mrow></math> in N4JS mode,
+the following constraints must hold:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>The operands must have the same type and the type must be either a number, string, or boolean:</simpara>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mfrac><mrow><mi>Γ</mi><mo>⊢</mo><mi>r</mi><mi>h</mi><mi>s</mi><mi>:</mi><mi>T</mi><mspace width="3.0mm"/><mi>T</mi><mo>∈</mo><mfenced close="}" open="{"><mstyle mathvariant="monospace"><mtext>number,string,boolean</mtext></mstyle></mfenced></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mi>l</mi><mi>h</mi><mi>s</mi><mi> </mi><mrow><mo>(</mo><mrow><mi>'</mi><msup><mo>&lt;</mo><mi>'</mi></msup><msup><mo>|</mo><mi>'</mi></msup><mo>&lt;</mo><msup><mo>=</mo><mi>'</mi></msup><msup><mo>|</mo><mi>'</mi></msup><msup><mo>&gt;</mo><mi>'</mi></msup><msup><mo>|</mo><mi>'</mi></msup><mo>&gt;</mo><msup><mo>=</mo><mi>'</mi></msup><mo>)</mo></mrow><mi>r</mi><mi>h</mi><mi>s</mi><mi> </mi><mo>⊲</mo><mi> </mi><mi>l</mi><mi>h</mi><mi>s</mi><mi>:</mi><mi>T</mi></mrow></mrow></mfrac></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mfrac><mrow><mi>Γ</mi><mo>⊢</mo><mi>r</mi><mi>h</mi><mi>s</mi><mi>:</mi><mi>O</mi><mspace width="3.0mm"/><mi>O</mi><mo>∉</mo><mfenced close="}" open="{"><mstyle mathvariant="monospace"><mtext>number,string,boolean</mtext></mstyle></mfenced><mspace width="3.0mm"/><mi>T</mi><mo>=</mo><mi>u</mi><mi>n</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mstyle mathvariant="monospace"><mtext>number,string,boolean</mtext></mstyle></mfenced></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mi>l</mi><mi>h</mi><mi>s</mi><mi> </mi><mrow><mo>(</mo><mrow><mi>'</mi><msup><mo>&lt;</mo><mi>'</mi></msup><msup><mo>|</mo><mi>'</mi></msup><mo>&lt;</mo><msup><mo>=</mo><mi>'</mi></msup><msup><mo>|</mo><mi>'</mi></msup><msup><mo>&gt;</mo><mi>'</mi></msup><msup><mo>|</mo><mi>'</mi></msup><mo>&gt;</mo><msup><mo>=</mo><mi>'</mi></msup><mo>)</mo></mrow><mi>r</mi><mi>h</mi><mi>s</mi><mi> </mi><mo>⊲</mo><mi> </mi><mi>l</mi><mi>h</mi><mi>s</mi><mi>:</mi><mi>T</mi></mrow></mrow></mfrac></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mfrac><mrow><mi>Γ</mi><mo>⊢</mo><mi>l</mi><mi>h</mi><mi>s</mi><mi>:</mi><mi>T</mi><mspace width="3.0mm"/><mi>T</mi><mo>∈</mo><mfenced close="}" open="{"><mstyle mathvariant="monospace"><mtext>number,string,boolean</mtext></mstyle></mfenced></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mi>l</mi><mi>h</mi><mi>s</mi><mi> </mi><mrow><mo>(</mo><mrow><mi>'</mi><msup><mo>&lt;</mo><mi>'</mi></msup><msup><mo>|</mo><mi>'</mi></msup><mo>&lt;</mo><msup><mo>=</mo><mi>'</mi></msup><msup><mo>|</mo><mi>'</mi></msup><msup><mo>&gt;</mo><mi>'</mi></msup><msup><mo>|</mo><mi>'</mi></msup><mo>&gt;</mo><msup><mo>=</mo><mi>'</mi></msup><mo>)</mo></mrow><mi>r</mi><mi>h</mi><mi>s</mi><mi> </mi><mo>⊲</mo><mi> </mi><mi>r</mi><mi>h</mi><mi>s</mi><mi>:</mi><mi>T</mi></mrow></mrow></mfrac></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mfrac><mrow><mi>Γ</mi><mo>⊢</mo><mi>l</mi><mi>h</mi><mi>s</mi><mi>:</mi><mi>O</mi><mspace width="3.0mm"/><mi>O</mi><mo>∉</mo><mfenced close="}" open="{"><mstyle mathvariant="monospace"><mtext>number,string,boolean</mtext></mstyle></mfenced><mspace width="3.0mm"/><mi>T</mi><mo>=</mo><mi>u</mi><mi>n</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mstyle mathvariant="monospace"><mtext>number,string,boolean</mtext></mstyle></mfenced></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mi>l</mi><mi>h</mi><mi>s</mi><mi> </mi><mrow><mo>(</mo><mrow><mi>'</mi><msup><mo>&lt;</mo><mi>'</mi></msup><msup><mo>|</mo><mi>'</mi></msup><mo>&lt;</mo><msup><mo>=</mo><mi>'</mi></msup><msup><mo>|</mo><mi>'</mi></msup><msup><mo>&gt;</mo><mi>'</mi></msup><msup><mo>|</mo><mi>'</mi></msup><mo>&gt;</mo><msup><mo>=</mo><mi>'</mi></msup><mo>)</mo></mrow><mi>r</mi><mi>h</mi><mi>s</mi><mi> </mi><mo>⊲</mo><mi> </mi><mi>r</mi><mi>h</mi><mi>s</mi><mi>:</mi><mi>T</mi></mrow></mrow></mfrac></math></simpara>
+</listitem>
+</itemizedlist>
+</requirement>
+<requirement xml:id="IDE-114">
+<title>Instanceof Operator Constraints</title>
+<simpara>
+<anchor xml:id="Req-IDE-114" xreflabel="[Req-IDE-114]"/>
+<emphasis role="strong">Requirement: IDE-114:</emphasis>
+<link linkend="Req-IDE-114">Instanceof Operator Constraints</link> (ver. 1)</simpara>
+    <simpara>
+
+For a given relational expression <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>e</mi></math> with  <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>e</mi><mo>.</mo><mi>o</mi><mi>p</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>instanceof</mtext></mstyle></math>, the following constraints must hold:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>The right operand of the instanceof operator must be a <literal>Function</literal> <footnote><simpara>Only <literal role="language-n4js">Function</literal> implements the ECMAScript specification property <literal role="language-n4js">hasInstance</literal>. Thus instanceof expressions are rewritten by the compiler for other types. Note that a reference to a class returns the constructor type, which actually is a function itself.</simpara></footnote></simpara>
+</listitem>
+</itemizedlist>
+<simpara>In other words,</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow/><mrow><mi>Γ</mi><mo>⊢</mo><mi>l</mi><mi>h</mi><mi>s</mi><mi> </mi><mstyle mathvariant="monospace"><mtext>’instanceof’</mtext></mstyle><mi> </mi><mi>r</mi><mi>h</mi><mi>s</mi><mi> </mi><mo>⊲</mo><mi> </mi><mi>r</mi><mi>h</mi><mi>s</mi><mi>:</mi><mstyle mathvariant="monospace"><mtext>type</mtext></mstyle><mfenced close="}" open="{"><mstyle mathvariant="monospace"><mtext>Class</mtext></mstyle></mfenced></mrow></mfrac><mrow/></math>
+<simpara>is contained in the the first type rule, an object type reference <footnote><simpara>Includes interfaces, since an interface type reference is a subtype of object type reference: <math xmlns="http://www.w3.org/1998/Math/MathML"><mstyle mathvariant="monospace"><mtext>type</mtext></mstyle><mfenced close="}" open="{"><mstyle mathvariant="monospace"><mtext>Interface</mtext></mstyle></mfenced><mo>&lt;</mo><mi>:</mi><mstyle mathvariant="monospace"><mtext>type</mtext></mstyle><mfenced close="}" open="{"><mstyle mathvariant="monospace"><mtext>Object</mtext></mstyle></mfenced></math></simpara></footnote>
+or an enum type reference.</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mtable><mtr><mtd><mspace width="3.0mm"/><mfrac><mrow/><mrow><mi>Γ</mi><mo>⊢</mo><mi>l</mi><mi>h</mi><mi>s</mi><mi> </mi><mstyle mathvariant="monospace"><mtext>’instanceof’</mtext></mstyle><mi> </mi><mi>r</mi><mi>h</mi><mi>s</mi><mi> </mi><mo>⊲</mo><mi> </mi><mi>r</mi><mi>h</mi><mi>s</mi><mi>:</mi><mstyle mathvariant="monospace"><mtext>Function</mtext></mstyle></mrow></mfrac></mtd></mtr><mtr><mtd><mspace width="3.0mm"/><mfrac><mrow/><mrow><mi>Γ</mi><mo>⊢</mo><mi>l</mi><mi>h</mi><mi>s</mi><mi> </mi><mstyle mathvariant="monospace"><mtext>’instanceof’</mtext></mstyle><mi> </mi><mi>r</mi><mi>h</mi><mi>s</mi><mi> </mi><mo>⊲</mo><mi> </mi><mi>r</mi><mi>h</mi><mi>s</mi><mi>:</mi><mstyle mathvariant="monospace"><mtext>type</mtext></mstyle><mfenced close="}" open="{"><mstyle mathvariant="monospace"><mtext>Object</mtext></mstyle></mfenced></mrow></mfrac></mtd></mtr><mtr><mtd><mspace width="3.0mm"/><mfrac><mrow/><mrow><mi>Γ</mi><mo>⊢</mo><mi>l</mi><mi>h</mi><mi>s</mi><mi> </mi><mstyle mathvariant="monospace"><mtext>’instanceof’</mtext></mstyle><mi> </mi><mi>r</mi><mi>h</mi><mi>s</mi><mi> </mi><mo>⊲</mo><mi> </mi><mi>r</mi><mi>h</mi><mi>s</mi><mi>:</mi><mstyle mathvariant="monospace"><mtext>type</mtext></mstyle><mfenced close="}" open="{"><mstyle mathvariant="monospace"><mtext>N4Enum</mtext></mstyle></mfenced></mrow></mfrac></mtd></mtr></mtable></math>
+<simpara>The type of a definition site structural classifier <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>C</mi></math> is not of type <literal>C</literal>.
+Thus, the <literal>instanceof</literal> operator cannot be used for structural types.
+Use-site structural typing is also not possible since <literal>~</literal> would be interpreted (by the parser) as a binary operator.</simpara>
+</requirement>
+<requirement xml:id="IDE-115">
+<title>Operator Constraints</title>
+<simpara>
+<anchor xml:id="Req-IDE-115" xreflabel="[Req-IDE-115]"/>
+<emphasis role="strong">Requirement: IDE-115:</emphasis>
+<link linkend="Req-IDE-115">Operator Constraints</link> (ver. 1)</simpara>
+    <simpara>
+</simpara>
+<simpara>For a given relational expression <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>e</mi></math> with <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>e</mi><mo>.</mo><mi>o</mi><mi>p</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>in</mtext></mstyle></math>, the following constraints must hold:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>The right operand of the in operator must be an <literal>Object</literal>:</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mspace width="3.0mm"/><mfrac><mrow/><mrow><mi>Γ</mi><mo>⊢</mo><mi>l</mi><mi>h</mi><mi>s</mi><mi> </mi><mstyle mathvariant="monospace"><mtext>’in’</mtext></mstyle><mi> </mi><mi>r</mi><mi>h</mi><mi>s</mi><mi> </mi><mo>⊲</mo><mi> </mi><mi>r</mi><mi>h</mi><mi>s</mi><mi>:</mi><mstyle mathvariant="monospace"><mtext>Object</mtext></mstyle></mrow></mfrac></math>
+</listitem>
+<listitem>
+<simpara>In N4JS mode, the left operand is restricted to be of type <literal>string</literal> or <literal>number</literal>:</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mspace width="3.0mm"/><mfrac><mrow/><mrow><mi>Γ</mi><mo>⊢</mo><mi>l</mi><mi>h</mi><mi>s</mi><mi> </mi><mstyle mathvariant="monospace"><mtext>’in’</mtext></mstyle><mi> </mi><mi>r</mi><mi>h</mi><mi>s</mi><mi> </mi><mo>⊲</mo><mi> </mi><mi>l</mi><mi>h</mi><mi>s</mi><mi>:</mi><mi>u</mi><mi>n</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mstyle mathvariant="monospace"><mtext>string,number</mtext></mstyle></mfenced></mrow></mfrac></math>
+</listitem>
+</orderedlist>
+</requirement>
+<simpara>A special feature of N4JS is support for interface type references in combination with the <literal>instance of</literal> operator.
+The compiler rewrites the code to make this work.</simpara>
+<example>
+<title><literal>instanceof</literal> with Interface</title>
+<simpara>The following example demonstrates the use of the operator with an interface.
+This is, of course, not working in pure ECMAScript.</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">interface I {}
+
+class A implements I {}
+class B extends A {}
+class C {}
+
+function f(name: string, p: any) {
+    if (p instanceof I) {
+        console.log(name + " is instance of I");
+    }
+}
+
+f("A", new A())
+f("B", new B())
+f("C", new C())</programlisting>
+<simpara>This will print out</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">A is instance of I
+B is instance of I</programlisting>
+</example>
+<bridgehead xml:id="type-inference-12" renderas="sect4">Type Inference</bridgehead>
+<simpara>The type of a relational expression always is <literal>boolean</literal>;</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mspace width="3.0mm"/><mfrac><mrow/><mrow><mi>Γ</mi><mo>⊢</mo><mi>l</mi><mi>h</mi><mi>s</mi><mi> </mi><mfenced close=")" open="("><mrow><mstyle mathvariant="monospace"><mtext>’¡’</mtext></mstyle><mo>|</mo><mstyle mathvariant="monospace"><mtext>’¡=’</mtext></mstyle><mo>|</mo><mstyle mathvariant="monospace"><mtext>’¿’</mtext></mstyle><mo>|</mo><mstyle mathvariant="monospace"><mtext>’¿=’</mtext></mstyle><mo>|</mo><mstyle mathvariant="monospace"><mtext>’instanceof’</mtext></mstyle><mo>|</mo><mstyle mathvariant="monospace"><mtext>’in’</mtext></mstyle></mrow></mfenced><mi> </mi><mi>r</mi><mi>h</mi><mi>s</mi><mi> </mi><mi>:</mi><mstyle mathvariant="monospace"><mtext>boolean</mtext></mstyle></mrow></mfrac></math>
+</section>
+<section xml:id="_equality-expression">
+<title>Equality Expression</title>
+<bridgehead xml:id="equality-expression-syntax" renderas="sect4">Syntax</bridgehead>
+<simpara>Cf. [<link linkend="ECMA11a">ECMA11a(p.p.80ff)</link>]</simpara>
+<programlisting language="xtext" linenumbering="unnumbered">EqualityExpression returns Expression: RelationalExpression
+    (=&gt;({EqualityExpression.lhs=current} op=EqualityOperator) rhs=RelationalExpression)*;
+
+EqualityExpressionNoIn returns Expression: RelationalExpressionNoIn
+    (=&gt;({EqualityExpression.lhs=current} op=EqualityOperator) rhs=RelationalExpressionNoIn)*;
+
+
+enum EqualityOperator: same='===' | nsame='!==' | eq='==' | neq='!=';</programlisting>
+<bridgehead xml:id="equality-expression-semantics" renderas="sect4">Semantics</bridgehead>
+<simpara>There are no hard constraints defined for equality expressions.</simpara>
+<simpara>In N4JSmode, a warning is created if for a given expression <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>l</mi><mi>h</mi><mi>s</mi><mstyle mathvariant="monospace"><mtext>(’===’—’!==’)</mtext></mstyle><mi>r</mi><mi>h</mi><mi>s</mi></math>, neither <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>Γ</mi><mo>⊢</mo><mi>l</mi><mi>h</mi><mi>s</mi><mo>.</mo><mi>u</mi><mi>p</mi><mi>p</mi><mi>e</mi><mi>r</mi><mo>&lt;</mo><mi>:</mi><mi>r</mi><mi>h</mi><mi>s</mi><mo>.</mo><mi>u</mi><mi>p</mi><mi>p</mi><mi>e</mi><mi>r</mi></math> nor <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>Γ</mi><mo>⊢</mo><mi>r</mi><mi>h</mi><mi>s</mi><mo>.</mo><mi>u</mi><mi>p</mi><mi>p</mi><mi>e</mi><mi>r</mi><mo>&lt;</mo><mi>:</mi><mi>l</mi><mi>h</mi><mi>s</mi><mo>.</mo><mi>u</mi><mi>p</mi><mi>p</mi><mi>e</mi><mi>r</mi></math>
+and no interface or composed type is involved as the result is constant in these cases.</simpara>
+<simpara>Note that a warning is only created if the upper bounds do not match the described constraints.
+This is necessary for wildcards. For example in</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">// with
+class A{} class B extends A{}
+function isFirst(ar: Array&lt;? extends A&gt;, b: B): boolean {
+    return b === ar[0]
+}</programlisting>
+<simpara>the type of array elements is <literal>? extends A</literal>.<?asciidoc-br?>
+Neither <math xmlns="http://www.w3.org/1998/Math/MathML"><mstyle mathvariant="monospace"><mtext>? extends A</mtext></mstyle><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mstyle mathvariant="monospace"><mtext>B</mtext></mstyle></math> nor <math xmlns="http://www.w3.org/1998/Math/MathML"><mstyle mathvariant="monospace"><mtext>B</mtext></mstyle><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mstyle mathvariant="monospace"><mtext>? extends A</mtext></mstyle></math> is true.
+This is why the upper bounds are to be used.</simpara>
+<bridgehead xml:id="type-inference-13" renderas="sect4">Type Inference</bridgehead>
+<simpara>The inferred type of an equality expression always is <literal>boolean</literal>.</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mspace width="3.0mm"/><mfrac><mrow/><mrow><mi>Γ</mi><mo>⊢</mo><mi>l</mi><mi>h</mi><mi>s</mi><mi> </mi><mfenced close=")" open="("><mrow><mstyle mathvariant="monospace"><mtext>’==’</mtext></mstyle><mo>|</mo><mstyle mathvariant="monospace"><mtext>’!=’</mtext></mstyle><mo>|</mo><mstyle mathvariant="monospace"><mtext>’===’</mtext></mstyle><mo>|</mo><mstyle mathvariant="monospace"><mtext>’!==’</mtext></mstyle></mrow></mfenced><mi> </mi><mi>r</mi><mi>h</mi><mi>s</mi><mi> </mi><mi>:</mi><mstyle mathvariant="monospace"><mtext>boolean</mtext></mstyle></mrow></mfrac></math>
+</section>
+<section xml:id="_binary-bitwise-expression">
+<title>Binary Bitwise Expression</title>
+<bridgehead xml:id="binary-bitwise-expression-syntax" renderas="sect4">Syntax</bridgehead>
+<simpara>Cf. [<link linkend="ECMA11a">ECMA11a(p.p.82ff)</link>]</simpara>
+<programlisting language="xtext" linenumbering="unnumbered">BitwiseANDExpression returns Expression: EqualityExpression
+    (=&gt; ({BitwiseANDExpression.lhs=current} '&amp;') rhs=EqualityExpression)*;
+
+BitwiseANDExpressionNoIn returns Expression: EqualityExpressionNoIn
+    (=&gt; ({BitwiseANDExpression.lhs=current} '&amp;') rhs=EqualityExpressionNoIn)*;
+
+BitwiseXORExpression returns Expression: BitwiseANDExpression
+    (=&gt; ({BitwiseXORExpression.lhs=current} '^') rhs=BitwiseANDExpression)*;
+
+BitwiseXORExpressionNoIn returns Expression: BitwiseANDExpressionNoIn
+    (=&gt; ({BitwiseXORExpression.lhs=current} '^') rhs=BitwiseANDExpressionNoIn)*;
+
+BitwiseORExpression returns Expression: BitwiseXORExpression
+    (=&gt; ({BitwiseORExpression.lhs=current} '|') rhs=BitwiseXORExpression)*;
+
+BitwiseORExpressionNoIn returns Expression: BitwiseXORExpressionNoIn
+    (=&gt; ({BitwiseORExpression.lhs=current} '|') rhs=BitwiseXORExpressionNoIn)*;</programlisting>
+<bridgehead xml:id="binary-bitwise-expression-semantics" renderas="sect4">Semantics</bridgehead>
+<requirement xml:id="IDE-116">
+<title>Bitwise Bitwise Expression Constraints</title>
+<simpara>
+<anchor xml:id="Req-IDE-116" xreflabel="[Req-IDE-116]"/>
+<emphasis role="strong">Requirement: IDE-116:</emphasis>
+<link linkend="Req-IDE-116">Bitwise Bitwise Expression Constraints</link> (ver. 1)</simpara>
+    <simpara>
+
+For a given bitwise bitwise expression <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>e</mi></math> the following constraints must hold in N4JS mode:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>The types of the operands must be both number.</simpara>
+</listitem>
+</itemizedlist>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow/><mrow><mi>Γ</mi><mo>⊢</mo><mstyle mathvariant="monospace"><mtext>BitwiseBitwiseExpression</mtext></mstyle><mi> </mi><mo>⊲</mo><mi> </mi><mstyle mathvariant="monospace"><mtext>Expression</mtext></mstyle><mi>:</mi><mstyle mathvariant="monospace"><mtext>number</mtext></mstyle></mrow></mfrac></math>
+</requirement>
+<bridgehead xml:id="type-inference-14" renderas="sect4">Type Inference</bridgehead>
+<simpara>The type returned by a binary bitwise expression is always <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>n</mi><mi>u</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi></math>:</simpara>
+
+</section>
+<section xml:id="_binary-logical-expression">
+<title>Binary Logical Expression</title>
+<bridgehead xml:id="binary-logical-expression-syntax" renderas="sect4">Syntax</bridgehead>
+<programlisting language="xtext" linenumbering="unnumbered">LogicalANDExpression returns Expression: BitwiseORExpression
+    (=&gt; ({LogicalANDExpression.lhs=current} '&amp;&amp;') rhs=BitwiseORExpression)*;
+LogicalANDExpressionNoIn returns Expression: BitwiseORExpressionNoIn
+    (=&gt; ({LogicalANDExpression.lhs=current} '&amp;&amp;') rhs=BitwiseORExpressionNoIn)*;
+
+LogicalORExpression returns Expression: LogicalANDExpression
+    (=&gt; ({LogicalORExpression.lhs=current} '||') rhs=LogicalANDExpression)*;
+LogicalORExpressionNoIn returns Expression: LogicalANDExpressionNoIn
+    (=&gt; ({LogicalORExpression.lhs=current} '||') rhs=LogicalANDExpressionNoIn)*;</programlisting>
+<bridgehead xml:id="binary-logical-expression-semantics" renderas="sect4">Semantics</bridgehead>
+<requirement xml:id="IDE-117">
+<title>Binary Logical Expression Constraints</title>
+<simpara>
+<anchor xml:id="Req-IDE-117" xreflabel="[Req-IDE-117]"/>
+<emphasis role="strong">Requirement: IDE-117:</emphasis>
+<link linkend="Req-IDE-117">Binary Logical Expression Constraints</link> (ver. 1)</simpara>
+    <simpara>
+
+For a given binary logical expression <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>e</mi></math> with <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>e</mi><mo>.</mo><mi>l</mi><mi>h</mi><mi>s</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>:</mi><mi>L</mi></math> and <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>e</mi><mo>.</mo><mi>r</mi><mi>h</mi><mi>s</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>:</mi><mi>R</mi></math> the following constraints must hold:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>In N4JS mode <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>L</mi></math> must not be <literal>undefined</literal> or <literal>null</literal>.</simpara>
+</listitem>
+</itemizedlist>
+</requirement>
+<bridgehead xml:id="type-inference-15" renderas="sect4">Type Inference</bridgehead>
+<simpara>The evaluation relies on ECMAScript’s abstract operation <literal>ToBoolean</literal> [<link linkend="ECMA11a">ECMA11a(p.p.43)</link>].
+A short-circuit evaluation strategy is used so that depending on the types of the operands, different result types may be inferred.
+In particular, the inferred type usually is not <literal>boolean</literal> ((cf. [<link linkend="ECMA11a">ECMA11a(p.S11.11., p.p.83ff)</link>] ).
+The type inference does not take this short-circuit evaluation strategy into account, as it will affect the result in case one of the types is <literal>null</literal>
+either or <literal>undefined</literal>, which is not allowed in N4JS mode.</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow/><mrow><mi>Γ</mi><mo>⊢</mo><mi>l</mi><mi>h</mi><mi>s</mi><mstyle mathvariant="monospace"><mtext>’</mtext></mstyle><mi>&amp;</mi><mi>&amp;</mi><mstyle mathvariant="monospace"><mtext>’—’——’</mtext></mstyle><mi>r</mi><mi>h</mi><mi>s</mi><mi>:</mi><mi>u</mi><mi>n</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><mi>Γ</mi><mo>⊢</mo><mi>l</mi><mi>h</mi><mi>s</mi></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mi>r</mi><mi>h</mi><mi>s</mi></mrow></mfenced></mrow></mfrac></math>
+</section>
+<section xml:id="_conditional-expression">
+<title>Conditional Expression</title>
+<bridgehead xml:id="conditional-expression-syntax" renderas="sect4">Syntax</bridgehead>
+<simpara>Cf. [<link linkend="ECMA11a">ECMA11a(p.S11.12, p.p.84)</link>]</simpara>
+<programlisting language="xtext" linenumbering="unnumbered">ConditionalExpression returns Expression: LogicalORExpression
+    (=&gt; ({ConditionalExpression.expression=current} '?') trueExpression=AssignmentExpression  ':' falseExpression=AssignmentExpression)?;
+
+ConditionalExpressionNoIn returns Expression: LogicalORExpressionNoIn
+    (=&gt; ({ConditionalExpression.expression=current} '?') trueExpression=AssignmentExpression  ':' falseExpression=AssignmentExpressionNoIn)?;</programlisting>
+<bridgehead xml:id="conditional-expression-semantics" renderas="sect4">Semantics</bridgehead>
+<requirement xml:id="IDE-118">
+<title>Conditional Expression Constraints</title>
+<simpara>
+<anchor xml:id="Req-IDE-118" xreflabel="[Req-IDE-118]"/>
+<emphasis role="strong">Requirement: IDE-118:</emphasis>
+<link linkend="Req-IDE-118">Conditional Expression Constraints</link> (ver. 1)</simpara>
+    <simpara>
+
+For a given conditional expression <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>e</mi></math> with</simpara>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>e</mi><mo>.</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>e</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>o</mi><mi>n</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>:</mi><mi>C</mi><mo>,</mo></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>e</mi><mo>.</mo><mi>t</mi><mi>r</mi><mi>u</mi><mi>e</mi><mi>E</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>e</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>o</mi><mi>n</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>:</mi><mi>T</mi><mo>,</mo></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>e</mi><mo>.</mo><mi>f</mi><mi>a</mi><mi>l</mi><mi>s</mi><mi>e</mi><mo>-</mo><mi>E</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>e</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>o</mi><mi>n</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>:</mi><mi>F</mi></math></simpara>
+<simpara>the following constraints must hold:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>A warning will be issued in N4JSmode if <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>e</mi><mo>.</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>e</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>o</mi><mi>n</mi></math> evaluates to a constant value.
+That is to say<?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>e</mi><mo>.</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>e</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>o</mi><mi>n</mi><mo>∈</mo><mfenced close="}" open="{"><mrow><mi>f</mi><mi>a</mi><mi>l</mi><mi>s</mi><mi>e</mi></mrow><mrow><mi>t</mi><mi>r</mi><mi>u</mi><mi>e</mi></mrow><mrow><mi>n</mi><mi>u</mi><mi>l</mi><mi>l</mi></mrow><mrow><mi>u</mi><mi>n</mi><mi>d</mi><mi>e</mi><mi>f</mi><mi>i</mi><mi>n</mi><mi>e</mi><mi>d</mi></mrow></mfenced></math> or
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>C</mi><mo>∈</mo><mfenced close="}" open="{"><mstyle mathvariant="monospace"><mtext>void</mtext></mstyle><mstyle mathvariant="monospace"><mtext>undefined</mtext></mstyle></mfenced></math>.</simpara>
+</listitem>
+</itemizedlist>
+<simpara>There are no specific constraints defined for the condition.
+The ECMAScript operation <literal>ToBoolean</literal> [<link linkend="ECMA11a">ECMA11a(p.S9.2, p.p.43)</link>] is used to convert any type to boolean.</simpara>
+</requirement>
+<bridgehead xml:id="type-inference-16" renderas="sect4">Type Inference</bridgehead>
+<simpara>The inferred type of a conditional expression is the union of the true and false expression (cf. [<link linkend="ECMA11a">ECMA11a(p.S11.12, p.p.84)</link>]   ():</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><mi>T</mi><mo>=</mo><mi>u</mi><mi>n</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><mi>Γ</mi><mo>⊢</mo><mi>e</mi><mi>t</mi><mo>,</mo><mi>Γ</mi><mo>⊢</mo><mi>e</mi><mi>f</mi></mrow></mfenced></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>d</mi><mi> </mi><mstyle mathvariant="monospace"><mtext>’?’</mtext></mstyle><mi>e</mi><mi>t</mi><mi> </mi><mstyle mathvariant="monospace"><mtext>’:’</mtext></mstyle><mi>e</mi><mi>f</mi><mi>:</mi><mi>T</mi></mrow></mfrac></math>
+<example>
+<title>Type of Conditional Expressions</title>
+<simpara>Given the following declarations:</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">class A{}       class B extends A{}
+class C{}       class D extends A{}
+class G&lt;T&gt; { field: T; }
+
+var ga: G&lt;A&gt;, gb: G&lt;B&gt;;
+    a: A, b: B, c: C, d: D;
+var boolean cond;</programlisting>
+<simpara>Then the type of the following conditional expression is inferred as noted in the comments:</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">cond ? a : a;                           // A
+cond ? a : b;                           // union{A,B}
+cond ? a : c;                           // union{A,C}
+cond ? b : d;                           // union{B,D}
+cond ? (cond ? a : b) : (cond ? c : d); // union{A,B,C,D}
+cond ? (cond ? a : b) : (cond ? b : d); // union{A,B,D}
+cond ? ga : gb;                         // union{G&lt;A&gt;,G&lt;B&gt;}</programlisting>
+</example>
+</section>
+<section xml:id="_assignment-expression">
+<title>Assignment Expression</title>
+<bridgehead xml:id="assignment-expression-syntax" renderas="sect4">Syntax</bridgehead>
+<programlisting language="xtext" linenumbering="unnumbered">AssignmentExpression &lt;In, Yield&gt;:
+    lhs=Expression op=AssignmentOperator rhs=AssignmentExpression&lt;In,Yield&gt;
+;
+AssignmentOperator:
+      '='
+    | '*=' | '/=' | '%=' | '+=' | '-='
+    | '&lt;&lt;=' | '&gt;&gt;=' | '&gt;&gt;&gt;='
+    | '&amp;=' | '^=' | '|='
+;</programlisting>
+<bridgehead xml:id="assignment-expression-semantics" renderas="sect4">Semantics</bridgehead>
+<requirement xml:id="IDE-119">
+<title>Simple Assignment</title>
+<simpara>
+<anchor xml:id="Req-IDE-119" xreflabel="[Req-IDE-119]"/>
+<emphasis role="strong">Requirement: IDE-119:</emphasis>
+<link linkend="Req-IDE-119">Simple Assignment</link> (ver. 1)</simpara>
+    <simpara>
+
+For a given assignment <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>a</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>g</mi><mi>n</mi><mi>m</mi><mi>e</mi><mi>n</mi><mi>t</mi></math> with</simpara>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>a</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>g</mi><mi>n</mi><mi>m</mi><mi>e</mi><mi>n</mi><mi>t</mi><mo>.</mo><mi>o</mi><mi>p</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>’=’</mtext></mstyle></math></simpara>
+<simpara>the following constraints must hold:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mrow><mo>[</mo><mspace width="-0.167em"/><mrow><mo>[</mo></mrow></mrow><mrow><mi>a</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>g</mi><mi>n</mi><mi>m</mi><mi>e</mi><mi>n</mi><mi>t</mi><mo>.</mo><mi>l</mi><mi>h</mi><mi>s</mi></mrow><mrow><mrow><mo>]</mo></mrow><mspace width="-0.167em"/><mo>]</mo></mrow><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mrow><mo>[</mo><mspace width="-0.167em"/><mrow><mo>[</mo></mrow></mrow><mrow><mi>a</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>g</mi><mi>n</mi><mi>m</mi><mi>e</mi><mi>n</mi><mi>t</mi><mo>.</mo><mi>r</mi><mi>h</mi><mi>s</mi></mrow><mrow><mrow><mo>]</mo></mrow><mspace width="-0.167em"/><mo>]</mo></mrow></math></simpara>
+<simpara>In the following inference rule and the constraint, ’@’ is to be replaced with the right part of one of the assignment operators listed above, that is,</simpara>
+
+</listitem>
+</orderedlist>
+</requirement>
+<requirement xml:id="IDE-120">
+<title>Compound Assignment</title>
+<simpara>
+<anchor xml:id="Req-IDE-120" xreflabel="[Req-IDE-120]"/>
+<emphasis role="strong">Requirement: IDE-120:</emphasis>
+<link linkend="Req-IDE-120">Compound Assignment</link> (ver. 1)</simpara>
+    <simpara>
+
+For a given assignment <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi><mi> </mi><mi>o</mi><mi>p</mi><mi> </mi><mi>r</mi><mi>i</mi><mi>g</mi><mi>h</mi><mi>t</mi></math>, with <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>o</mi><mi>p</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>’@=’</mtext></mstyle></math> but not <literal>+=</literal>, both, left and right must be subtypes of <literal>number</literal>.<?asciidoc-br?>
+For operator <literal>+=</literal>,</simpara>
+<itemizedlist>
+<listitem>
+<simpara>if the left-hand side is a <literal>number</literal>, then <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi><mi> </mi><mstyle mathvariant="monospace"><mtext>’+’</mtext></mstyle><mi>r</mi><mi>i</mi><mi>g</mi><mi>h</mi><mi>t</mi></math> must return a number as well.
+The right-hand side must, in fact, be a <literal>number</literal> (and not a <literal>boolean</literal>) here in order to avoid unexpected results.</simpara>
+</listitem>
+<listitem>
+<simpara>if the left-hand side is a <literal>string</literal>, then <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi><mstyle mathvariant="monospace"><mtext>’+’</mtext></mstyle><mi>r</mi><mi>i</mi><mi>g</mi><mi>h</mi><mi>t</mi></math> must return a string as well.
+That means that the right-hand side can be of <literal>any</literal> type.</simpara>
+</listitem>
+</itemizedlist>
+<simpara>The expected type for the left-hand side is <literal>union{number,string}</literal>.</simpara>
+<simpara>The basic idea behind these constraints is that the type of the left-hand side is not to be changed by the compound assignment.</simpara>
+</requirement>
+<requirement xml:id="IDE-121">
+<title>Write Acccess</title>
+<simpara>
+<anchor xml:id="Req-IDE-121" xreflabel="[Req-IDE-121]"/>
+<emphasis role="strong">Requirement: IDE-121:</emphasis>
+<link linkend="Req-IDE-121">Write Acccess</link> (ver. 1)</simpara>
+    <simpara>
+
+For a given assignment expression <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>a</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>g</mi><mi>n</mi><mi>E</mi><mi>x</mi><mi>p</mi><mi>r</mi></math>, the left-hand side must be writeable or a final data field and the assignment must be in the constructor.
+Let <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>v</mi></math> be the bound variable (or field) with <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>b</mi><mi>i</mi><mi>n</mi><mi>d</mi><mfenced close=")" open="("><mrow><mi>a</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>g</mi><mi>n</mi><mi>E</mi><mi>x</mi><mi>p</mi><mi>r</mi><mo>.</mo><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi></mrow><mi>v</mi></mfenced></math></simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mtable><mtr><mtd><mi>v</mi><mo>.</mo><mi>w</mi><mi>r</mi><mi>i</mi><mi>t</mi><mi>e</mi><mi>a</mi><mi>b</mi><mi>l</mi><mi>e</mi><mo>∨</mo><mi>v</mi><mo>.</mo><mi>f</mi><mi>i</mi><mi>n</mi><mi>a</mi><mi>l</mi><mo>∧</mo><mspace width="3.0mm"/><mspace width="2.0em"/><mi>v</mi><mo>.</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>null</mtext></mstyle></mtd></mtr><mtr><mtd><mspace width="3.0mm"/><mspace width="2.0em"/><mo>∧</mo><mi>a</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>g</mi><mi>n</mi><mi>E</mi><mi>x</mi><mi>p</mi><mi>r</mi><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>t</mi><mi>a</mi><mi>i</mi><mi>n</mi><mi>i</mi><mi>n</mi><mi>g</mi><mi>F</mi><mi>u</mi><mi>n</mi><mi>c</mi><mi>t</mi><mi>i</mi><mi>o</mi><mi>n</mi><mo>=</mo><mi>v</mi><mo>.</mo><mi>o</mi><mi>w</mi><mi>n</mi><mi>e</mi><mi>r</mi><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>s</mi><mi>t</mi><mi>r</mi><mi>u</mi><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi></mtd></mtr><mtr><mtd><mspace width="3.0mm"/><mspace width="2.0em"/><mo>∧</mo><mi>μ</mi><mfenced close=")" open="("><mrow><mi>a</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>g</mi><mi>n</mi><mi>E</mi><mi>x</mi><mi>p</mi><mi>r</mi><mo>.</mo><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi></mrow></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>PropertyAccess</mtext></mstyle></mtd></mtr><mtr><mtd><mspace width="3.0mm"/><mspace width="4.0em"/><mo>∧</mo><mi>a</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>g</mi><mi>n</mi><mi>E</mi><mi>x</mi><mi>p</mi><mi>r</mi><mo>.</mo><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi><mo>.</mo><mi>t</mi><mi>a</mi><mi>r</mi><mi>g</mi><mi>e</mi><mi>t</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>"this"</mtext></mstyle></mtd></mtr></mtable></math>
+<simpara>The value of writeable is true for setters and usually for variables and data fields.
+Assignability of variables and data fields can be restricted via <literal>const</literal> or the <literal>@Final</literal> annotation.
+See <xref linkend="_assignment-modifiers"/>(data fields) and <xref linkend="_const"/> (const variables) for details.</simpara>
+<simpara>Also see <xref linkend="Req-IDE-93"/> for read access constraint.</simpara>
+<simpara>The left-hand side of an assignment expression may be an array or object literal and the assignment expression is then treated as a destructuring assignment.
+See <xref linkend="_array-and-object-destructuring"/> for details.</simpara>
+</requirement>
+<bridgehead xml:id="type-inference-17" renderas="sect4">Type Inference</bridgehead>
+<simpara>Similarly to [<link linkend="ECMA11a">ECMA11a(p.S11.1, p.p.84ff)</link>], we define type inference for simple assignment (<literal>=</literal>) and compound assignment (<literal>op=</literal>) individually.</simpara>
+<simpara>The type of the assignment is simply the type of the right-hand side:</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mspace width="3.0mm"/><mfrac><mrow><mi>Γ</mi><mo>⊢</mo><mi>r</mi><mi>i</mi><mi>g</mi><mi>h</mi><mi>t</mi><mi>:</mi><mi>T</mi></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi><mi> </mi><mstyle mathvariant="monospace"><mtext>’=’</mtext></mstyle><mi>r</mi><mi>i</mi><mi>g</mi><mi>h</mi><mi>t</mi><mi>:</mi><mi>T</mi></mrow></mfrac></math>
+<simpara>Compound assignments are reduced to the former by splitting an operator <literal>@=</literal>, in which <literal>@</literal> is a simple operator,
+into a simple operator expression with operator <literal>@</literal> and a simple assignment <literal>=</literal>.
+Since the type of the latter is the right-hand side, we can define:</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><mi>Γ</mi><mo>⊢</mo><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi><mi> </mi><mstyle mathvariant="monospace"><mtext>’@’</mtext></mstyle><mi>r</mi><mi>i</mi><mi>g</mi><mi>h</mi><mi>t</mi><mi>:</mi><mi>T</mi></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi><mi> </mi><mstyle mathvariant="monospace"><mtext>’@=’</mtext></mstyle><mi>r</mi><mi>i</mi><mi>g</mi><mi>h</mi><mi>t</mi><mi>:</mi><mi>T</mi></mrow></mfrac></math>
+</section>
+<section xml:id="_comma-expression">
+<title>Comma Expression</title>
+<bridgehead xml:id="comma-expression-syntax" renderas="sect4">Syntax</bridgehead>
+<simpara>Cf. [<link linkend="ECMA11a">ECMA11a(p.S11.14, p.p.85)</link>]</simpara>
+<programlisting language="xtext" linenumbering="unnumbered">CommaExpression &lt;In, Yield&gt;:
+    exprs+=AssignmentExpression&lt;In,Yield&gt; ',' exprs+=AssignmentExpression&lt;In,Yield&gt;
+    (','    exprs+=AssignmentExpression&lt;In,Yield&gt;)*
+;</programlisting>
+<bridgehead xml:id="comma-expression-semantics" renderas="sect4">Semantics</bridgehead>
+<simpara>All expressions will be evaluated even though only the value of the last expression will be the result.</simpara>
+<example>
+<title>Comma Expression</title>
+<simpara>Assignment expressions preceed comma expressions:</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">var b: boolean;
+b = (12, 34, true); // ok, b=true
+b =  12, 34, true ; // error, b=12 is invalid</programlisting>
+</example>
+<bridgehead xml:id="type-inference-18" renderas="sect4">Type Inference</bridgehead>
+<simpara>Cf. [<link linkend="ECMA11a">ECMA11a(p.S11.14, p.p.85)</link>]</simpara>
+<simpara>The type of a comma expression <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>c</mi><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi></math> is inferred to the last expression:</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><mi>n</mi><mo>=</mo><mo>|</mo><mi>c</mi><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mo>.</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>s</mi><mo>|</mo><mo>,</mo><mi>Γ</mi><mo>⊢</mo><mi>c</mi><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mo>.</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><msub><mi>s</mi><mi>n</mi></msub><mi>:</mi><mi>T</mi></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mi>c</mi><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>:</mi><mi>T</mi></mrow></mfrac></math>
+</section>
+</section>
+<section xml:id="_ecmascript-6-expressions" role="language-n4js">
+<title>ECMAScript 6 Expressions</title>
+<section xml:id="_the-super-keyword">
+<title>The super Keyword</title>
+<programlisting language="n4js" linenumbering="unnumbered">SuperLiteral: {SuperLiteral} 'super';</programlisting>
+<simpara>Apart from the use of keyword <literal>super</literal> in wildcards of type expressions (cf. <xref linkend="_type-expressions"/>),
+there are two use cases for keyword <literal>super</literal>: super member access and super constructor calls.</simpara>
+<example>
+<title>Super Keyword</title>
+<simpara>Two use cases for keyword super:</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">class B extends A {
+    constructor() {
+        // super call
+        super();
+    }
+    @Override
+    m();: void {
+        // super member access
+        super.m();
+    }
+}</programlisting>
+</example>
+<bridgehead xml:id="super-keyword-semantics" renderas="sect4">Semantics</bridgehead>
+<simpara><literal>super</literal> can be used to access the supertype’s constructor, methods, getters and setters.
+The supertype is defined lexically, which is different from how <literal>this</literal> works.<footnote><simpara>See [<link linkend="ECMA15a">ECMA15a</link>], Chapter 12.3.5 "The Super Keyword"; note the use of <literal>HomeObject</literal> instead of <literal>thisValue</literal>; also see this blog - <link xl:href="http://www.2ality.com/2011/11/super-references.html">http://www.2ality.com/2011/11/super-references.html</link>.</simpara></footnote></simpara>
+<simpara>Note that in [<link linkend="ECMA15a">ECMA15a</link>] Chapter 12.3.5 <literal>The Super Keyword</literal>, <literal>super</literal> is defined as a keyword but the syntax and semantics are defined in conjunction of member access.</simpara>
+<requirement xml:id="IDE-122">
+<title>Type of Super is Always Nominal</title>
+<simpara>
+<anchor xml:id="Req-IDE-122" xreflabel="[Req-IDE-122]"/>
+<emphasis role="strong">Requirement: IDE-122:</emphasis>
+<link linkend="Req-IDE-122">Type of Super is Always Nominal</link> (ver. 1)</simpara>
+    <simpara>
+
+The type referenced with the super literal is always nominal.
+This is a consequence of references to types in extend clauses to be nominal.</simpara>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>Γ</mi><mo>⊢</mo><mstyle mathvariant="monospace"><mtext>super</mtext></mstyle><mi>:</mi><mi>T</mi><mo>∧</mo><mi>T</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>i</mi><mi>n</mi><mi>g</mi><mi>S</mi><mi>t</mi><mi>r</mi><mi>a</mi><mi>t</mi><mi>e</mi><mi>g</mi><mi>y</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>nominal</mtext></mstyle></math></simpara>
+</requirement>
+<requirement xml:id="IDE-123">
+<title>Access Super Constructor with Super Literal</title>
+<simpara>
+<anchor xml:id="Req-IDE-123" xreflabel="[Req-IDE-123]"/>
+<emphasis role="strong">Requirement: IDE-123:</emphasis>
+<link linkend="Req-IDE-123">Access Super Constructor with Super Literal</link> (ver. 1)</simpara>
+    <simpara>
+
+If the super literal <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>s</mi></math> is used to access the super constructor of a class, all of the following constraints must hold:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>The super constructor access must be a call expression:</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mi>μ</mi><mfenced close=")" open="("><mrow><mi>c</mi><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi></mrow></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>CallExpression</mtext></mstyle><mo>∧</mo><mi>c</mi><mo>.</mo><mi>t</mi><mi>a</mi><mi>r</mi><mi>g</mi><mi>e</mi><mi>t</mi><mo>=</mo><mi>c</mi><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi></math>
+</listitem>
+<listitem>
+<simpara>The super constructor call must be the expression of an expression statement <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>S</mi><mi>t</mi><mi>m</mi><mi>t</mi></math>:</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>S</mi><mi>t</mi><mi>m</mi><mi>t</mi><mo>=</mo><mi>c</mi><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>t</mi><mi>a</mi><mi>i</mi><mi>n</mi><mi>e</mi><mi>r</mi><mo>∧</mo><mi>μ</mi><mfenced close=")" open="("><mrow><mi>c</mi><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>t</mi><mi>a</mi><mi>i</mi><mi>n</mi><mi>e</mi><mi>r</mi></mrow></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>ExpressionStatement</mtext></mstyle></math>
+</listitem>
+<listitem>
+<simpara>The containing statement <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>s</mi><mi>t</mi><mi>m</mi><mi>t</mi><mi>E</mi><mi>x</mi><mi>p</mi><mi>r</mi></math> must be directly contained in a constructor body:</simpara>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mrow><mi>μ</mi><mfenced close=")" open="("><mrow><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>S</mi><mi>t</mi><mi>m</mi><mi>t</mi><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>t</mi><mi>a</mi><mi>i</mi><mi>n</mi><mi>i</mi><mi>n</mi><mi>g</mi><mi>F</mi><mi>u</mi><mi>n</mi><mi>c</mi><mi>t</mi><mi>i</mi><mi>o</mi><mi>n</mi></mrow></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>Constructor</mtext></mstyle><mo>)</mo></mrow></math>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mo>∧</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>S</mi><mi>t</mi><mi>m</mi><mi>t</mi><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>t</mi><mi>a</mi><mi>i</mi><mi>n</mi><mi>e</mi><mi>r</mi><mo>=</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>S</mi><mi>t</mi><mi>m</mi><mi>t</mi><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>t</mi><mi>a</mi><mi>i</mi><mi>n</mi><mi>i</mi><mi>n</mi><mi>g</mi><mi>F</mi><mi>u</mi><mi>n</mi><mi>c</mi><mi>t</mi><mi>i</mi><mi>o</mi><mi>n</mi><mo>.</mo><mi>b</mi><mi>o</mi><mi>d</mi><mi>y</mi></math></simpara>
+</listitem>
+<listitem>
+<simpara>There must be no access to and not return statement before the containing statement <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>S</mi><mi>t</mi><mi>m</mi><mi>t</mi></math>.</simpara>
+<simpara>Let <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>s</mi><mi>i</mi></math> be the index of <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>S</mi><mi>t</mi><mi>m</mi><mi>t</mi></math> in the constructor body:</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>S</mi><mi>t</mi><mi>m</mi><mi>t</mi><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>t</mi><mi>a</mi><mi>i</mi><mi>n</mi><mi>e</mi><mi>r</mi><mo>.</mo><mi>s</mi><mi>t</mi><mi>m</mi><mi>t</mi><msub><mi>s</mi><mrow><mi>s</mi><mi>i</mi></mrow></msub><mo>=</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>S</mi><mi>t</mi><mi>m</mi><mi>t</mi></math>
+<simpara>Then, the following constraint must hold: <footnote><simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>e</mi><msup><mo>∈</mo><mo>*</mo></msup><mi>c</mi></math> is the transitive version of <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>e</mi><mo>∈</mo><mi>c</mi></math>, that is, it <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>e</mi></math> directly or indirectly contained in <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>c</mi></math>.</simpara></footnote></simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mspace width="3.0mm"/><mo>∀</mo><mi>i</mi><mo>&lt;</mo><mi>s</mi><mi>i</mi><mi>:</mi><mo>∄</mo><mi>e</mi><mi>l</mi><mi>e</mi><mi>m</mi><mi>e</mi><mi>n</mi><mi>t</mi><msup><mo>∈</mo><mo>*</mo></msup><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>S</mi><mi>t</mi><mi>m</mi><mi>t</mi><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>t</mi><mi>a</mi><mi>i</mi><mi>n</mi><mi>e</mi><mi>r</mi><mo>.</mo><mi>s</mi><mi>t</mi><mi>m</mi><mi>t</mi><msub><mi>s</mi><mi>i</mi></msub><mi>:</mi><mtext>
+</mtext><mspace width="3.0mm"/><mspace width="3.0em"/><mi>μ</mi><mfenced close=")" open="("><mi>i</mi></mfenced><mo>∈</mo><mstyle mathvariant="monospace"><mtext>ThisLiteral, ReturnStatement</mtext></mstyle></math>
+</listitem>
+</orderedlist>
+<simpara>Further constraints with regard to super constructor calls are described in <xref linkend="_constructor-and-classifier-type"/>.</simpara>
+</requirement>
+<requirement xml:id="IDE-124">
+<title>Access Super Member with Super Literal</title>
+<simpara>
+<anchor xml:id="Req-IDE-124" xreflabel="[Req-IDE-124]"/>
+<emphasis role="strong">Requirement: IDE-124:</emphasis>
+<link linkend="Req-IDE-124">Access Super Member with Super Literal</link> (ver. 1)</simpara>
+    <simpara>
+
+If the super literal <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>s</mi></math> is used to access a member of the super class, all of the following constraints must hold, with <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>c</mi><mo>=</mo><mi>s</mi><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>t</mi><mi>a</mi><mi>i</mi><mi>n</mi><mi>e</mi><mi>r</mi><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>t</mi><mi>a</mi><mi>i</mi><mi>n</mi><mi>e</mi><mi>r</mi></math></simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>The super literal must be the receiver of a method call (cf. remarks below):</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mtable><mtr><mtd><mspace width="3.0mm"/><mi>μ</mi><mfenced close=")" open="("><mi>c</mi></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>CallExpression</mtext></mstyle></mtd></mtr><mtr><mtd><mo>∧</mo><mspace width="3.0mm"/><mi>c</mi><mo>.</mo><mi>t</mi><mi>a</mi><mi>r</mi><mi>g</mi><mi>e</mi><mi>t</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>PropertyAccessExpression</mtext></mstyle></mtd></mtr><mtr><mtd><mo>∧</mo><mspace width="3.0mm"/><mi>c</mi><mo>.</mo><mi>t</mi><mi>a</mi><mi>r</mi><mi>g</mi><mi>e</mi><mi>t</mi><mo>.</mo><mi>t</mi><mi>a</mi><mi>r</mi><mi>g</mi><mi>e</mi><mi>t</mi><mo>=</mo><mi>s</mi></mtd></mtr></mtable></math>
+</listitem>
+<listitem>
+<simpara>The super literal is used in a method or field accessor of a class:</simpara>
+</listitem>
+</orderedlist>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>μ</mi><mfenced close=")" open="("><mrow><mi>s</mi><mo>.</mo><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>t</mi><mi>a</mi><mi>i</mi><mi>n</mi><mi>i</mi><mi>n</mi><mi>g</mi><mi>C</mi><mi>l</mi><mi>a</mi><mi>s</mi><mi>s</mi></mrow></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>Class</mtext></mstyle></math>
+3.  The super literal must not be used in a nested function expression:</simpara>
+<simpara>+
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>μ</mi><mfenced close=")" open="("><mrow><mi>s</mi><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>t</mi><mi>a</mi><mi>i</mi><mi>n</mi><mi>i</mi><mi>n</mi><mi>g</mi><mi>F</mi><mi>u</mi><mi>n</mi><mi>c</mi><mi>t</mi><mi>i</mi><mi>o</mi><mi>n</mi></mrow></mfenced><mo>=</mo><mi>s</mi><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>t</mi><mi>a</mi><mi>i</mi><mi>n</mi><mi>i</mi><mi>n</mi><mi>g</mi><mi>M</mi><mi>e</mi><mi>t</mi><mi>h</mi><mi>o</mi><mi>d</mi><mi>O</mi><mi>r</mi><mi>F</mi><mi>i</mi><mi>e</mi><mi>l</mi><mi>d</mi><mi>A</mi><mi>c</mi><mi>c</mi><mi>e</mi><mi>s</mi><mi>s</mi><mi>o</mi><mi>r</mi></math>
+4.  If the return type of the method access via super is this, the actually bound this type will be the type of the calling class (and not of the class defining the method).</simpara>
+<simpara>+</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><mi>s</mi><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>t</mi><mi>a</mi><mi>i</mi><mi>n</mi><mi>i</mi><mi>n</mi><mi>g</mi><mi>C</mi><mi>l</mi><mi>a</mi><mi>s</mi><mi>s</mi><mo>=</mo><mi>T</mi><mspace width="3.0mm"/><mi>μ</mi><mfenced close=")" open="("><mi>m</mi></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>Method</mtext></mstyle><mspace width="3.0mm"/><mi>m</mi><mo>.</mo><mi>r</mi><mi>e</mi><mi>t</mi><mi>u</mi><mi>r</mi><mi>n</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>this</mtext></mstyle></mrow><mrow><mstyle mathvariant="monospace"><mtext>function():T</mtext></mstyle><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>s</mi><mo>.</mo><mi>m</mi></mrow></mfrac></math>
+</requirement>
+<requirement xml:id="IDE-125">
+<title>Super Literal Usage</title>
+<simpara>
+<anchor xml:id="Req-IDE-125" xreflabel="[Req-IDE-125]"/>
+<emphasis role="strong">Requirement: IDE-125:</emphasis>
+<link linkend="Req-IDE-125">Super Literal Usage</link> (ver. 1)</simpara>
+    <simpara>
+
+For super literals, either <xref linkend="Req-IDE-123"/> or <xref linkend="Req-IDE-124"/> must hold, no other usage
+is allowed.</simpara>
+<simpara>Consequences:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>Since fields cannot be overridden (except for changing the access modifier), it is not possible nor allowed to access a field via <literal>super</literal>.</simpara>
+</listitem>
+<listitem>
+<simpara>Super literals must not be used with index access (e.g., <literal>super["foo"]</literal>)</simpara>
+</listitem>
+<listitem>
+<simpara>It is not possible to chain super keywords. That is, it is not possible to call <literal>super.super.m()</literal>.</simpara>
+</listitem>
+<listitem>
+<simpara>It is not allowed to use the super literal in interfaces or non-methods/accessors.</simpara>
+</listitem>
+<listitem>
+<simpara>Super cannot be used to call an overridden method of an implemented method from the overriding method in the implementing class.</simpara>
+</listitem>
+<listitem>
+<simpara>In order to be able to access a super method of a method <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>M</mi></math> of a class <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>C</mi></math>, exactly one non-abstract super method <math xmlns="http://www.w3.org/1998/Math/MathML"><msup><mi>M</mi><mi>'</mi></msup></math> in a super class <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>S</mi></math> of <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>C</mi></math> must exist.
+This is assured by the standard rules for binding identifiers.</simpara>
+</listitem>
+</itemizedlist>
+<simpara>If super is used to access a super member, the receiver type is not changed.
+This is important in particular for static methods as demonstrated in the following example:</simpara>
+<example>
+<title>Super Call in Static Methods</title>
+<programlisting language="n4js" linenumbering="unnumbered">class A {
+    static foo(): void { console.log("A") }
+    static bar(): void {
+        this.foo();
+    }
+}
+
+class B extends A {
+
+    @Override
+    static foo(): void { console.log("B") }
+    @Override
+    static bar(): void {
+        A.bar();        <co xml:id="CO5-1"/>
+        super.bar();    <co xml:id="CO5-2"/>
+    }
+}
+
+B.bar();</programlisting>
+</example>
+<calloutlist>
+<callout arearefs="CO5-1">
+<para>The receiver (which is similar to the this-binding in ECMAScript) is changed to <literal>A</literal>.</para>
+</callout>
+<callout arearefs="CO5-2">
+<para>Using super, the receiver is preserved, i.e. <literal>B</literal>.</para>
+</callout>
+</calloutlist>
+</requirement>
+</section>
+</section>
+<section xml:id="_ecmascript-7-expressions" role="language-n4js">
+<title>ECMAScript 7 Expressions</title>
+<section xml:id="_await-expression">
+<title>Await Expression</title>
+<simpara>In N4JS, <literal>await</literal> is implemented as a unary operator with the same precedence as <literal>yield</literal> in ECMAScript 6.</simpara>
+<simpara>Constraints governing the use of <literal>await</literal> are given together with those for <literal>async</literal> in <xref linkend="_asynchronous-functions"/>.</simpara>
+</section>
+</section>
+<section xml:id="_n4js-specific-expressions" role="language-n4js">
+<title>N4JS Specific Expressions</title>
+<section xml:id="_class-expression">
+<title>Class Expression</title>
+<simpara>A class expression in N4JS is similar to a class expression in ECMAScript 6 [<link linkend="ECMA15a">ECMA15a(p.14.5)</link>].</simpara>
+<note>
+<simpara>Class expressions are not part of version 0.3</simpara>
+</note>
+<bridgehead xml:id="class-expression-syntax" renderas="sect4">Syntax</bridgehead>
+<simpara>See <xref linkend="_classes"/>.</simpara>
+<bridgehead xml:id="class-expression-semantics-type-inference" renderas="sect4">Semantics and Type Inference</bridgehead>
+<simpara>The inferred type of a class expression simply is the class type as described in <xref linkend="_constructor-and-classifier-type"/>.</simpara>
+</section>
+<section xml:id="_cast-as-expression">
+<title>Cast (As) Expression</title>
+<bridgehead xml:id="cast-as-expression-syntax" renderas="sect4">Syntax</bridgehead>
+<programlisting language="xtext" linenumbering="unnumbered">CastExpression &lt;Yield&gt; returns Expression: expression=Expression 'as' targetTypeRef=TypeRefForCast;
+
+TypeRefForCast returns StaticBaseTypeRef:
+      ParameterizedTypeRef
+    | ThisTypeRef
+    | ConstructorTypeRef
+    | ClassifierTypeRef
+    | FunctionTypeExpression
+    | UnionTypeExpression
+    | IntersectionTypeExpression</programlisting>
+<section xml:id="cast-as-expression-semantics-type-inference">
+<title>Semantics and Type Inference</title>
+<simpara>The inferred type of the type cast expression is the target type:</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow/><mrow><mi>Γ</mi><mo>⊢</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi> </mi><mstyle mathvariant="monospace"><mtext>"as"</mtext></mstyle><mi> </mi><mi>T</mi><mi>:</mi><mi>T</mi></mrow></mfrac></math>
+<simpara>The type cast returns the expression without further modifications.
+Type casts are simply removed during compilation so there will be no exceptions thrown at the cast until later when accessing properties which may not be present in case of a failed cast.</simpara>
+<simpara>An error is issued if the cast is either unnecessary or cannot succeed.
+See further details in <xref linkend="_type-cast"/>.</simpara>
+</section>
+</section>
+<section xml:id="Import_Calls">
+<title>Import Calls</title>
+<simpara>Import calls as specified by the corresponding <link xl:href="https://github.com/tc39/proposal-dynamic-import">ECMA TC39 proposal</link> are
+available in N4JS. Such an import call has the form</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">import(moduleSpecifier)</programlisting>
+<simpara>and may appear in the source code wherever an expression may appear. It&#8217;s argument need not be a string literal, as is
+the case with module specifiers of ordinary imports; instead, any expression that evaluates to a string at runtime is
+accepted. Hence, it can be used to import from a target module that is not yet known at compile time.</simpara>
+<simpara>A note on terminology: import calls covered in this section are sometimes referred to as "dynamic import". In N4JS
+that term is already used for imports of the form <literal>import * as N+ from "&#8230;&#8203;"</literal>, i.e. compile-time imports that do not
+require type information of the module imported from, see <xref linkend="Dynamic_Imports"/>, and stems from the term "dynamic type"
+(see <xref linkend="Type_Modifiers_Dynamic"/>). To avoid confusion, we will usually avoid referring to import calls as a "dynamic
+import".</simpara>
+</section>
+</section>
+<section xml:id="compile-time-expressions" role="language-n4js">
+<title>Compile-Time Expressions</title>
+<simpara>A compile-time expression is an expression that can be fully evaluated at compile time. Not all expressions introduced
+in the previous sections qualify as compile-time expressions. Some forms of expressions always qualify (e.g. a string
+literal is always a compile-time expression), some never (e.g. call expressions), and for some expressions the operands
+must be of a certain value. The latter applies, for example, to divison: <literal>5 / 0</literal> is a valid ECMAScript expression (evaluating
+to <literal>NaN</literal>) but is not a compile-time expression. So it&#8217;s the actual compile-time value of the divisor that makes the difference,
+here. In any case, if an expression has operands, it is a compile-time expression only if all operands are compile-time expressions.</simpara>
+<simpara>The value a compile-time expression evaluates to at compile-time is called <emphasis>compile-time value</emphasis>. So, an expression has a compile-time
+value if and only if it is a compile-time expression.</simpara>
+<definition>
+<title>Compile-Time Expression</title>
+<simpara>
+<anchor xml:id="compile-time_expression" xreflabel="[compile-time_expression]"/>
+<emphasis role="strong">Definition:</emphasis>
+<link linkend="compile-time_expression">Compile-Time Expression</link></simpara>
+<simpara>
+
+The following expressions are called compile-time expressions:</simpara>
+<itemizedlist>
+<listitem>
+<simpara><literal>undefined</literal> (but not <literal>NaN</literal> or <literal>Infinity</literal>).</simpara>
+</listitem>
+<listitem>
+<simpara>the <literal>null</literal> literal.</simpara>
+</listitem>
+<listitem>
+<simpara>all boolean, numeric, and string literals.</simpara>
+</listitem>
+<listitem>
+<simpara>template string literals, iff all embedded expressions are compile-time expressions.</simpara>
+</listitem>
+<listitem>
+<simpara>a parenthesis expression, iff its nested expression is a compile-time expression.</simpara>
+</listitem>
+<listitem>
+<simpara>unary expressions in case of the following operators:</simpara>
+<itemizedlist>
+<listitem>
+<simpara><literal>!</literal> iff the operand is a compile-time expression and evaluates to a boolean value.</simpara>
+</listitem>
+<listitem>
+<simpara><literal>+</literal> iff the operand is a compile-time expression and evaluates to a numeric value.</simpara>
+</listitem>
+<listitem>
+<simpara><literal>-</literal> iff the operand is a compile-time expression and evaluates to a numeric value.</simpara>
+</listitem>
+<listitem>
+<simpara><literal>void</literal>.</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+<listitem>
+<simpara>binary expressions in case of the following operators:</simpara>
+<itemizedlist>
+<listitem>
+<simpara><literal>+</literal> iff both operands are compile-time expressions and</simpara>
+<itemizedlist>
+<listitem>
+<simpara>both evaluate to numeric values, or</simpara>
+</listitem>
+<listitem>
+<simpara>at least one evaluates to a string value.</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+<listitem>
+<simpara><literal>-</literal>, <literal>*</literal> iff both operands are compile-time expressions and evaluate to numeric values.</simpara>
+</listitem>
+<listitem>
+<simpara><literal>/</literal>, <literal>%</literal> iff both operands are compile-time expressions and evaluate to numeric values and the right-hand operand is non-zero (i.e. division by zero is disallowed in compile-time expression, because <literal>NaN</literal> is not a supported compile-time value).</simpara>
+</listitem>
+<listitem>
+<simpara><literal>&amp;&amp;</literal>, <literal>||</literal> iff both operands are compile-time expressions and evaluate to boolean values.</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+<listitem>
+<simpara>a tertiary conditional expression, iff the first operand is a compile-time expression evaluating to a boolean value B and</simpara>
+<itemizedlist>
+<listitem>
+<simpara>in case B is true, the second operand is a compile-time expression.</simpara>
+</listitem>
+<listitem>
+<simpara>in case B is false, the third operand is a compile-time expression.</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+<listitem>
+<simpara>an identifier reference to a const variable, iff its initializer expression is a compile-time expression.</simpara>
+</listitem>
+<listitem>
+<simpara>a property access expression, iff it is direct (see <xref linkend="property-access-direct"/>) and refers to</simpara>
+<itemizedlist>
+<listitem>
+<simpara>a built-in symbol, e.g. <literal>Symbol.iterator</literal>,</simpara>
+</listitem>
+<listitem>
+<simpara>a literal of a <literal>@StringBased</literal> enum, or</simpara>
+</listitem>
+<listitem>
+<simpara>a const field with a compile-time initializer expression.</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+</itemizedlist>
+<simpara>In all other cases, the expression is not a compile-time expression.</simpara>
+</definition>
+<simpara>Every expression in the code may be a compile-time expression, but in most places this has no particular
+effect and is simply ignored. They are of significance only in computed property names, in index access
+expressions, as initializers of const variables and fields (as stated above) and when nested as an operand
+inside an expression at these locations.</simpara>
+</section>
+</chapter>
+<chapter xml:id="_statements">
+<title>Statements</title>
+<simpara>For all statements, we define the following pseudo properties:</simpara>
+<variablelist>
+<varlistentry>
+<term><literal>containingFunction</literal> </term>
+<listitem>
+<simpara>The function or method in which the statement is (indirectly) contained, this may be null.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>containingClass</literal> </term>
+<listitem>
+<simpara>The class in which the statement is (indirectly) contained, this may be null.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+<simpara>The expressions and statements are ordered, at first describing the constructs available in the 5th edition of ECMA-262
+referred to as  [<link linkend="ECMA11a">ECMA11a</link>] in the following.
+The grammar snippets already use newer constructs in some cases.</simpara>
+<section xml:id="_ecmascript-5-statements" role="language-n4js">
+<title>ECMAScript 5 Statements</title>
+<simpara>N4JS supports the same statements as
+ECMAScript. Some of these statements are enhanced with annotations <xref linkend="_annotations"/> and type information.</simpara>
+<simpara>Although some statements may return a value which can be used via certain constructs such as <literal>eval</literal>), no type is inferred for any statement.
+The compiler will always create a warning if a statement is used instead of an expression.</simpara>
+<simpara>The following sections, therefore, do not define how to infer types for statement but how types and type annotations
+are used in these statements and the specific type constraints for a given statement.</simpara>
+<simpara>All syntax definitions taken from  [<link linkend="ECMA11a">ECMA11a</link>]  are repeated here for convenience reasons and in order to define temporary variables for simplifying constraint definitions.
+If non-terminals are not defined here, the definition specified in  [<link linkend="ECMA11a">ECMA11a</link>]   is to be used.</simpara>
+<section xml:id="_function-or-field-accessor-bodies">
+<title>Function or Field Accessor Bodies</title>
+<requirement xml:id="IDE-126">
+<title>Dead Code</title>
+<simpara>
+<anchor xml:id="Req-IDE-126" xreflabel="[Req-IDE-126]"/>
+<emphasis role="strong">Requirement: IDE-126:</emphasis>
+<link linkend="Req-IDE-126">Dead Code</link> (ver. 1)</simpara>
+    <simpara>
+
+For all statements in a function or field accessor (getter/setter) body, the following constraints must hold:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>Statements appearing directly after return, throw, break, or continue statements (in the same block) are considered to be dead code and a warning is issued in these cases.</simpara>
+</listitem>
+</orderedlist>
+</requirement>
+</section>
+<section xml:id="_variable-statement">
+<title>Variable Statement</title>
+<bridgehead xml:id="variable-statement-syntax" renderas="sect4">Syntax</bridgehead>
+<simpara>A var statement can declare the type of the variable with a type
+reference. This is described with the following grammar similar to
+[<link linkend="ECMA11a">ECMA11a(p.S12.2, p.p.87)</link>]:</simpara>
+<programlisting language="xtext" linenumbering="unnumbered">VariableStatement &lt;In, Yield&gt;:
+    =&gt;({VariableStatement}
+        'var'
+    )
+    varDeclsOrBindings+=VariableDeclarationOrBinding&lt;In,Yield,false&gt; (',' varDeclsOrBindings+=VariableDeclarationOrBinding&lt;In,Yield,false&gt;)* Semi
+;
+
+VariableDeclarationOrBinding &lt;In, Yield, OptionalInit&gt;:
+        VariableBinding&lt;In,Yield,OptionalInit&gt;
+    |   VariableDeclaration&lt;In,Yield,true&gt;
+;
+
+VariableBinding &lt;In, Yield, OptionalInit&gt;:
+    =&gt; pattern=BindingPattern&lt;Yield&gt; (
+            &lt;OptionalInit&gt; ('=' expression=AssignmentExpression&lt;In,Yield&gt;)?
+        |   &lt;!OptionalInit&gt; '=' expression=AssignmentExpression&lt;In,Yield&gt;
+    )
+;
+
+VariableDeclaration &lt;In, Yield, AllowType&gt;:
+    {VariableDeclaration} VariableDeclarationImpl&lt;In,Yield,AllowType&gt;;
+
+fragment VariableDeclarationImpl &lt;In, Yield, AllowType&gt;*:
+    annotations+=Annotation*
+    (
+        &lt;AllowType&gt; =&gt;(
+            name=BindingIdentifier&lt;Yield&gt; ColonSepTypeRef?
+        ) ('=' expression=AssignmentExpression&lt;In,Yield&gt;)?
+    |   &lt;!AllowType&gt; =&gt;(
+        name=BindingIdentifier&lt;Yield&gt;
+        ) ('=' expression=AssignmentExpression&lt;In,Yield&gt;)?
+    )
+;</programlisting>
+<example>
+<title>Variable Statement</title>
+<programlisting language="n4js" linenumbering="unnumbered">var any: any;
+// any.type := any
+
+var anyNull = null;
+// anyNull.type := any
+
+var s: string;
+// s.type := string
+
+var init = "Hi";
+// init.type := string
+
+const MESSAGE = "Hello World";
+// MESSAGE.type := string</programlisting>
+</example>
+<bridgehead xml:id="variable-statement-semantics" renderas="sect4">Semantics</bridgehead>
+<simpara>From a model and type inference point of view, variable and constant statements and declarations are similar except that the pseudo property <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>c</mi><mi>o</mi><mi>n</mi><mi>s</mi><mi>t</mi></math> is set to false for variables and true for constants.
+Also see exported variable statement (<xref linkend="_export-statement"/>) and constant statement and declaration (<xref linkend="_const"/>).</simpara>
+<requirement xml:id="IDE-127">
+<title>Variable declaration</title>
+<simpara>
+<anchor xml:id="Req-IDE-127" xreflabel="[Req-IDE-127]"/>
+<emphasis role="strong">Requirement: IDE-127:</emphasis>
+<link linkend="Req-IDE-127">Variable declaration</link> (ver. 1)</simpara>
+    <simpara>
+
+For a given variable declaration <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>d</mi></math>, the following constraints must hold:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>The type of the initializer expression must conform to the declared type:</simpara>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>d</mi><mo>.</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>e</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>o</mi><mi>n</mi><mo>≠</mo><mstyle mathvariant="monospace"><mtext>null</mtext></mstyle><mo>∧</mo><mi>d</mi><mo>.</mo><mi>d</mi><mi>e</mi><mi>c</mi><mi>l</mi><mi>a</mi><mi>r</mi><mi>e</mi><mi>d</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mo>≠</mo><mstyle mathvariant="monospace"><mtext>null</mtext></mstyle></math><?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mo>→</mo><mi>Γ</mi><mo>⊢</mo><mi>d</mi><mo>.</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>e</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>o</mi><mi>n</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>Γ</mi><mo>⊢</mo><mi>d</mi><mo>.</mo><mi>d</mi><mi>e</mi><mi>c</mi><mi>l</mi><mi>a</mi><mi>r</mi><mi>e</mi><mi>d</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi></math></simpara>
+</listitem>
+<listitem>
+<simpara>The initializer expression should not contain a reference to <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>d</mi></math> except where the reference is contained in a class expression or function expression and
+the class is not immediately initialized or the function is not immediately invoked.
+In these cases, the code is executed later and the self-reference is not a problem.<?asciidoc-br?>
+To clarify: <emphasis>should not</emphasis> means that only a warning will be produced.</simpara>
+</listitem>
+</itemizedlist>
+<programlisting language="n4js" linenumbering="unnumbered">// not ok (simple case)
+var n = n + 1;
+
+// ok (class expression not fully supported)
+// var cls1 = class { static sfield1 = "hello"; field2 = cls1.sfield1; };
+
+// not ok, immediately instantiated (class expression not fully supported)
+// var cls2 = new class { field1 = "hello"; field2 = cls2.field1; };
+
+// ok
+var fun1 = function() : number { var x = fun1; return -42; };
+
+// not ok, immediately invoked
+var fun2 = function() : number { var x = fun2;  return -42; }();</programlisting>
+<simpara>The variable statement may contain array or object destructuring patterns, see <xref linkend="_array-and-object-destructuring"/> for details.</simpara>
+</requirement>
+<bridgehead xml:id="variable-statement-type-inference" renderas="sect4">Type Inference</bridgehead>
+<simpara>The type of a variable is the type of its declaration:</simpara>
+
+<simpara>The type of a variable declaration is either the declared type or the inferred type of the initializer expression:</simpara>
+
+</section>
+<section xml:id="_if-statement" role="language-n4js">
+<title>If Statement</title>
+<bridgehead xml:id="if-statement-syntax" renderas="sect4">Syntax</bridgehead>
+<simpara>Cf. [<link linkend="ECMA11a">ECMA11a(p.S12.5, p.p.89)</link>]</simpara>
+<programlisting language="xtext" linenumbering="unnumbered">IfStatement &lt;Yield&gt;:
+    'if' '(' expression=Expression&lt;In=true,Yield&gt; ')'
+    ifStmt=Statement&lt;Yield&gt;
+    (=&gt; 'else' elseStmt=Statement&lt;Yield&gt;)?;</programlisting>
+<bridgehead xml:id="if-statement-semantics" renderas="sect4">Semantics</bridgehead>
+<simpara>There are no specific constraints defined for the condition, the ECMAScript operation <literal>ToBoolean</literal> [<link linkend="ECMA11a">ECMA11a(p.S9.2, p.p.43)</link>] is used to convert any type to boolean.</simpara>
+<requirement xml:id="IDE-128">
+<title>If Statement</title>
+<simpara>
+<anchor xml:id="Req-IDE-128" xreflabel="[Req-IDE-128]"/>
+<emphasis role="strong">Requirement: IDE-128:</emphasis>
+<link linkend="Req-IDE-128">If Statement</link> (ver. 1)</simpara>
+    <simpara>
+
+In N4JS, the expression of an if statement must not evaluate to <literal>void</literal>.
+If the expressions is a function call in particular, the called function must not be declared to return <literal>void</literal>.</simpara>
+</requirement>
+</section>
+<section xml:id="_iteration-statements">
+<title>Iteration Statements</title>
+<bridgehead xml:id="iterations-statements-syntax" renderas="sect4">Syntax</bridgehead>
+<simpara>Cf. [<link linkend="ECMA11a">ECMA11a(p.S12.6, p.p.90ff)</link>]</simpara>
+<simpara>The syntax already considers the for-of style described in <xref linkend="_for-of-statement"/>.</simpara>
+<programlisting language="xtext" linenumbering="unnumbered">IterationStatement &lt;Yield&gt;:
+        DoStatement&lt;Yield&gt;
+    |   WhileStatement&lt;Yield&gt;
+    |   ForStatement&lt;Yield&gt;
+;
+
+DoStatement &lt;Yield&gt;: 'do' statement=Statement&lt;Yield&gt; 'while' '(' expression=Expression&lt;In=true,Yield&gt; ')' =&gt; Semi?;
+WhileStatement &lt;Yield&gt;: 'while' '(' expression=Expression&lt;In=true,Yield&gt; ')' statement=Statement&lt;Yield&gt;;
+
+ForStatement &lt;Yield&gt;:
+    {ForStatement} 'for' '('
+    (
+        // this is not in the spec as far as I can tell, but there are tests that rely on this to be valid JS
+            =&gt;(initExpr=LetIdentifierRef forIn?='in' expression=Expression&lt;In=true,Yield&gt; ')')
+        |   (   -&gt;varStmtKeyword=VariableStatementKeyword
+                (
+                        =&gt;(varDeclsOrBindings+=BindingIdentifierAsVariableDeclaration&lt;In=false,Yield&gt; (forIn?='in' | forOf?='of') -&gt;expression=AssignmentExpression&lt;In=true,Yield&gt;?)
+                    |   varDeclsOrBindings+=VariableDeclarationOrBinding&lt;In=false,Yield,OptionalInit=true&gt;
+                        (
+                                (',' varDeclsOrBindings+=VariableDeclarationOrBinding&lt;In=false,Yield,false&gt;)* ';' expression=Expression&lt;In=true,Yield&gt;? ';' updateExpr=Expression&lt;In=true,Yield&gt;?
+                            |   forIn?='in' expression=Expression&lt;In=true,Yield&gt;?
+                            |   forOf?='of' expression=AssignmentExpression&lt;In=true,Yield&gt;?
+                        )
+                )
+            |   initExpr=Expression&lt;In=false,Yield&gt;
+                (
+                        ';' expression=Expression&lt;In=true,Yield&gt;? ';' updateExpr=Expression&lt;In=true,Yield&gt;?
+                    |   forIn?='in' expression=Expression&lt;In=true,Yield&gt;?
+                    |   forOf?='of' expression=AssignmentExpression&lt;In=true,Yield&gt;?
+                )
+            |   ';' expression=Expression&lt;In=true,Yield&gt;? ';' updateExpr=Expression&lt;In=true,Yield&gt;?
+            )
+        ')'
+    ) statement=Statement&lt;Yield&gt;
+;
+
+ContinueStatement &lt;Yield&gt;: {ContinueStatement} 'continue' (label=[LabelledStatement|BindingIdentifier&lt;Yield&gt;])? Semi;
+BreakStatement &lt;Yield&gt;: {BreakStatement} 'break' (label=[LabelledStatement|BindingIdentifier&lt;Yield&gt;])? Semi;</programlisting>
+<simpara>Since <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>v</mi><mi>a</mi><mi>r</mi><mi>D</mi><mi>e</mi><mi>c</mi><mi>l</mi><mfenced close=")" open="("><mi>s</mi></mfenced></math> are <literal>VariableStatement</literal>s as described in <xref linkend="_variable-statement"/>, the declared variables can be type annotated.</simpara>
+<tip>
+<simpara>Using for-in is not recommended, instead <literal>_each</literal> should be used.</simpara>
+</tip>
+<bridgehead xml:id="iterations-statements-semantics" renderas="sect4">Semantics</bridgehead>
+<simpara>There are no specific constraints defined for the condition, the
+ECMAScript operation <literal>ToBoolean</literal> [<link linkend="ECMA11a">ECMA11a(p.S9.2, p.p.43)</link>] is used to convert any type to boolean.</simpara>
+<requirement xml:id="IDE-129">
+<title>For-In-Statement Constraints</title>
+<simpara>
+<anchor xml:id="Req-IDE-129" xreflabel="[Req-IDE-129]"/>
+<emphasis role="strong">Requirement: IDE-129:</emphasis>
+<link linkend="Req-IDE-129">For-In-Statement Constraints</link> (ver. 1)</simpara>
+    <simpara>
+
+For a given <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>f</mi></math> the following conditions must hold:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>The type of the expression must be conform to object:<?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>Γ</mi><mo>⊢</mo><mi>f</mi><mo>.</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>e</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>o</mi><mi>n</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mstyle mathvariant="monospace"><mtext>union</mtext><mtext>Object,string,ArgumentType</mtext></mstyle></math></simpara>
+</listitem>
+<listitem>
+<simpara>Either a new loop variable must be declared or an rvalue must be provided as init expression:<?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>f</mi><mo>.</mo><mi>v</mi><mi>a</mi><mi>r</mi><mi>D</mi><mi>e</mi><mi>c</mi><mi>l</mi><mo>≠</mo><mi>n</mi><mi>u</mi><mi>l</mi><mi>l</mi><mo>∨</mo><mfenced close=")" open="("><mrow><mi>f</mi><mo>.</mo><mi>i</mi><mi>n</mi><mi>i</mi><mi>t</mi><mi>E</mi><mi>x</mi><mi>p</mi><mi>r</mi><mo>≠</mo><mi>n</mi><mi>u</mi><mi>l</mi><mi>l</mi><mo>∧</mo><mi>i</mi><mi>s</mi><mi>R</mi><mi>V</mi><mi>a</mi><mi>l</mi><mi>u</mi><mi>e</mi><mfenced close=")" open="("><mrow><mi>f</mi><mo>.</mo><mi>i</mi><mi>n</mi><mi>i</mi><mi>t</mi><mi>E</mi><mi>x</mi><mi>p</mi><mi>r</mi></mrow></mfenced></mrow></mfenced></math></simpara>
+</listitem>
+<listitem>
+<simpara>The type of the loop variable must be a string (or a super type of string, i.e. any):</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mtable><mtr><mtd/><mtd><mrow><mo>(</mo><mrow><mi>f</mi><mo>.</mo><mi>v</mi><mi>a</mi><mi>r</mi><mi>D</mi><mi>e</mi><mi>c</mi><mi>l</mi><mo>≠</mo><mi>n</mi><mi>u</mi><mi>l</mi><mi>l</mi><mo>∧</mo><mi>Γ</mi><mo>⊢</mo><mi>f</mi><mo>.</mo><mi>v</mi><mi>a</mi><mi>r</mi><mi>D</mi><mi>e</mi><mi>c</mi><mi>l</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mstyle mathvariant="monospace"><mtext>string</mtext></mstyle><mo>)</mo></mrow></mrow></mtd></mtr><mtr><mtd><mo>∨</mo></mtd><mtd><mrow><mo>(</mo><mrow><mi>f</mi><mo>.</mo><mi>i</mi><mi>n</mi><mi>i</mi><mi>t</mi><mi>E</mi><mi>x</mi><mi>p</mi><mo>≠</mo><mi>n</mi><mi>u</mi><mi>l</mi><mi>l</mi><mo>∧</mo><mi>Γ</mi><mo>⊢</mo><mstyle mathvariant="monospace"><mtext>string</mtext></mstyle><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>f</mi><mo>.</mo><mi>i</mi><mi>n</mi><mi>i</mi><mi>t</mi><mi>E</mi><mi>x</mi><mi>p</mi><mi>r</mi><mo>)</mo></mrow></mrow></mtd></mtr></mtable></math>
+</listitem>
+</itemizedlist>
+</requirement>
+</section>
+<section xml:id="_return-statement" role="language-n4js">
+<title>Return Statement</title>
+<bridgehead xml:id="return-statement-syntax" renderas="sect4">Syntax</bridgehead>
+<simpara>The returns statement is defined as in [<link linkend="ECMA11a">ECMA11a(p.S12.9, p.p.93)</link>] with</simpara>
+<programlisting language="xtext" linenumbering="unnumbered">ReturnStatement &lt;Yield&gt;:
+    'return' (expression=Expression&lt;In=true,Yield&gt;)? Semi;</programlisting>
+<bridgehead xml:id="return-statement-semantics" renderas="sect4">Semantics</bridgehead>
+<requirement xml:id="IDE-130">
+<title>Return statement</title>
+<simpara>
+<anchor xml:id="Req-IDE-130" xreflabel="[Req-IDE-130]"/>
+<emphasis role="strong">Requirement: IDE-130:</emphasis>
+<link linkend="Req-IDE-130">Return statement</link> (ver. 1)</simpara>
+    <simpara>
+
+1.  Expected type of expression in a return statement must be a sub type of the return type of the enclosing function:</simpara>
+<simpara>+</simpara>
+
+<simpara>Note that the expression may be evaluated to <literal>void</literal>.
+2.  If enclosing function is declared to return <literal>void</literal>, then either
+* no return statement must be defined
+* return statement has no expression
+* type of expression of return statement is <literal>void</literal>
+3.  If enclosing function is declared to to return a type different from <literal>void</literal>, then
+* all return statements must have a return expression
+* all control flows must either end with a return or throw statement
+4.  Returns statements must be enclosed in a function.
+A return statement, for example, must not be a top-level statement.</simpara>
+</requirement>
+</section>
+<section xml:id="_with-statement">
+<title>With Statement</title>
+<bridgehead xml:id="with-statement-syntax" renderas="sect4">Syntax</bridgehead>
+<simpara>The with statement is not allowed in N4JS, thus an error is issued.</simpara>
+<programlisting language="xtext" linenumbering="unnumbered">WithStatement &lt;Yield&gt;:
+    'with' '(' expression=Expression&lt;In=true,Yield&gt; ')'
+    statement=Statement&lt;Yield&gt;;</programlisting>
+<bridgehead xml:id="with-statement-semantics" renderas="sect4">Semantics</bridgehead>
+<simpara>N4JS is based on strict mode and the with statement is not allowed in
+strict mode, cf. [<link linkend="ECMA11a">ECMA11a(p.S12.10.1, p.p.94)</link>].</simpara>
+<requirement xml:id="IDE-131">
+<title>With Statement</title>
+<simpara>
+<anchor xml:id="Req-IDE-131" xreflabel="[Req-IDE-131]"/>
+<emphasis role="strong">Requirement: IDE-131:</emphasis>
+<link linkend="Req-IDE-131">With Statement</link> (ver. 1)</simpara>
+    <simpara>
+
+With statements are not allowed in N4JS or strict mode.</simpara>
+</requirement>
+</section>
+<section xml:id="_switch-statement">
+<title>Switch Statement</title>
+<bridgehead xml:id="switch-statement-syntax" renderas="sect4">Syntax</bridgehead>
+<simpara>Cf. [<link linkend="ECMA11a">ECMA11a(p.S12.11, p.p.94ff)</link>]</simpara>
+<programlisting language="xtext" linenumbering="unnumbered">SwitchStatement &lt;Yield&gt;:
+    'switch' '(' expression=Expression&lt;In=true,Yield&gt; ')' '{'
+    (cases+=CaseClause&lt;Yield&gt;)*
+    ((cases+=DefaultClause&lt;Yield&gt;)
+    (cases+=CaseClause&lt;Yield&gt;)*)? '}'
+;
+
+CaseClause &lt;Yield&gt;: 'case' expression=Expression&lt;In=true,Yield&gt; ':' (statements+=Statement&lt;Yield&gt;)*;
+DefaultClause &lt;Yield&gt;: {DefaultClause} 'default' ':' (statements+=Statement&lt;Yield&gt;)*;</programlisting>
+<bridgehead xml:id="switch-statement-semantics" renderas="sect4">Semantics</bridgehead>
+<requirement xml:id="IDE-132">
+<title>Switch Constraints</title>
+<simpara>
+<anchor xml:id="Req-IDE-132" xreflabel="[Req-IDE-132]"/>
+<emphasis role="strong">Requirement: IDE-132:</emphasis>
+<link linkend="Req-IDE-132">Switch Constraints</link> (ver. 1)</simpara>
+    <simpara>
+
+For a given switch statement <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>s</mi></math>, the following constraints must hold:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>For all cases <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>c</mi><mo>∈</mo><mi>s</mi><mo>.</mo><mi>c</mi><mi>a</mi><mi>s</mi><mi>e</mi><mi>s</mi></math>, <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>s</mi><mo>.</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi></math>===<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>c</mi><mo>.</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi></math> must be valid according to the constraints defined in <xref linkend="_equality-expression"/>.</simpara>
+</listitem>
+</itemizedlist>
+</requirement>
+</section>
+<section xml:id="_throw-try-and-catch-statements">
+<title>Throw, Try, and Catch Statements</title>
+<bridgehead xml:id="throw-try-catch-syntax" renderas="sect4">Syntax</bridgehead>
+<simpara>Cf. [<link linkend="ECMA11a">ECMA11a(p.S12.13/14, p.p.96ff)</link>]</simpara>
+<programlisting language="xtext" linenumbering="unnumbered">ThrowStatement &lt;Yield&gt;:
+    'throw' expression=Expression&lt;In=true,Yield&gt; Semi;
+
+TryStatement &lt;Yield&gt;:
+    'try' block=Block&lt;Yield&gt;
+    ((catch=CatchBlock&lt;Yield&gt; finally=FinallyBlock&lt;Yield&gt;?) | finally=FinallyBlock&lt;Yield&gt;)
+;
+
+CatchBlock &lt;Yield&gt;: {CatchBlock} 'catch' '(' catchVariable=CatchVariable&lt;Yield&gt; ')' block=Block&lt;Yield&gt;;
+
+CatchVariable &lt;Yield&gt;:
+        =&gt;bindingPattern=BindingPattern&lt;Yield&gt;
+    |   name=BindingIdentifier&lt;Yield&gt;
+;
+
+FinallyBlock &lt;Yield&gt;: {FinallyBlock} 'finally' block=Block&lt;Yield&gt;;</programlisting>
+<simpara>There must be not type annotation for the catch variable, as this would lead to the wrong assumption that a type can be specified.</simpara>
+<bridgehead xml:id="throw-try-catch-type-inference" renderas="sect4">Type Inference</bridgehead>
+<simpara>The type of the catch variable is always assumed to be <literal>any</literal>.</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow/><mrow><mi>Γ</mi><mo>⊢</mo><mi>c</mi><mi>a</mi><mi>t</mi><mi>c</mi><mi>h</mi><mi>B</mi><mi>l</mi><mi>o</mi><mi>c</mi><mi>k</mi><mo>.</mo><mi>c</mi><mi>a</mi><mi>t</mi><mi>c</mi><mi>h</mi><mi>V</mi><mi>a</mi><mi>r</mi><mi>i</mi><mi>a</mi><mi>b</mi><mi>l</mi><mi>e</mi><mi>:</mi><mstyle mathvariant="monospace"><mtext>any</mtext></mstyle></mrow></mfrac></math>
+</section>
+<section xml:id="_debugger-statement">
+<title>Debugger Statement</title>
+<bridgehead xml:id="debugger-statement-syntax" renderas="sect4">Syntax</bridgehead>
+<simpara>Cf. [<link linkend="ECMA11a">ECMA11a(p.S12.15, p.p.97ff)</link>])</simpara>
+<programlisting language="xtext" linenumbering="unnumbered">DebuggerStatement: {DebuggerStatement} 'debugger' Semi;</programlisting>
+<bridgehead xml:id="debugger-statement--semantics" renderas="sect4">Semantics</bridgehead>
+<simpara>na</simpara>
+</section>
+</section>
+<section xml:id="_ecmascript-6-statements" role="language-n4js">
+<title>ECMAScript 6 Statements</title>
+<simpara>N4JS export and import statements are similar to ES6 with some minor d ifferences which are elaborated on below.</simpara>
+<section xml:id="_let">
+<title>Let</title>
+<simpara>Cf. [<link linkend="ECMA11a">ECMA11a(p.13.2.1)</link>], also <link xl:href="http://www.2ality.com/2015/02/es6-scoping.html">Rauschmayer, 2ality: <emphasis role="strong">Variables and scoping in ECMAScript 6</emphasis></link></simpara>
+</section>
+<section xml:id="_const">
+<title>Const</title>
+<simpara>Cf. [<link linkend="ECMA15a">ECMA15a(p.13.2.1)</link>], also <link xl:href="http://www.2ality.com/2015/02/es6-scoping.html">Rauschmayer, 2ality: <emphasis role="strong">Variables and scoping in ECMAScript 6</emphasis></link></simpara>
+<simpara>Additionally to the <literal>var</literal> statement, the <literal>const</literal> statement is supported.
+It allows for declaring variables which must be assigned to a value in the declaration and their value must not change.
+That is to say that constants are not allowed to be on the left-hand side of other assignments.</simpara>
+<programlisting language="xtext" linenumbering="unnumbered">ConstStatement returns VariableStatement: 'const' varDecl+=ConstDeclaration ( ',' varDecl+=ConstDeclaration )* Semi;
+
+ConstDeclaration returns VariableDeclaration: typeRef=TypeRef? name=IDENTIFIER const?='=' expression=AssignmentExpression;</programlisting>
+<bridgehead xml:id="const-semantics" renderas="sect4">Semantics</bridgehead>
+<simpara>A const variable statement is more or less a normal variable statement (see <xref linkend="_variable-statement"/>), except that all variables declared by that
+statement are not writable (cf. <xref linkend="Req-IDE-121"/>).
+This is similar to constant data fields (cf. <xref linkend="_assignment-modifiers"/>).</simpara>
+<requirement xml:id="IDE-133">
+<title>Writability of const variables</title>
+<simpara>
+<anchor xml:id="Req-IDE-133" xreflabel="[Req-IDE-133]"/>
+<emphasis role="strong">Requirement: IDE-133:</emphasis>
+<link linkend="Req-IDE-133">Writability of const variables</link> (ver. 1)</simpara>
+    <simpara>
+
+All variable declarations of a const variable statement
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>c</mi><mi>o</mi><mi>n</mi><mi>s</mi><mi>t</mi><mi>S</mi><mi>t</mi><mi>m</mi><mi>t</mi></math> are not writeable:
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∀</mo><mi>v</mi><mi>d</mi><mi>e</mi><mi>c</mi><mi>l</mi><mo>∈</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>s</mi><mi>t</mi><mi>S</mi><mi>t</mi><mi>m</mi><mi>t</mi><mo>.</mo><mi>v</mi><mi>a</mi><mi>r</mi><mi>D</mi><mi>e</mi><mi>c</mi><mi>l</mi><mi>:</mi><mo>¬</mo><mi>v</mi><mi>d</mi><mi>e</mi><mi>c</mi><mi>l</mi><mo>.</mo><mi>w</mi><mi>r</mi><mi>i</mi><mi>t</mi><mi>a</mi><mi>b</mi><mi>l</mi><mi>e</mi></math></simpara>
+</requirement>
+</section>
+<section xml:id="_for-of-statement">
+<title><literal>for &#8230;&#8203; of</literal> statement</title>
+<simpara>ES6 introduced a new form of <literal>for</literal> statement: <literal>for &#8230;&#8203; of</literal> to iterate over the elements of an  <literal>Iterable</literal>, cf. <xref linkend="_iterablen"/>.</simpara>
+<bridgehead xml:id="for-of-statement-syntax" renderas="sect4">Syntax</bridgehead>
+<simpara>See <xref linkend="_iteration-statements"/></simpara>
+<bridgehead xml:id="for-of-statement-semantics" renderas="sect4">Semantics</bridgehead>
+<requirement xml:id="IDE-134">
+<title>for &#8230;&#8203; of statement</title>
+<simpara>
+<anchor xml:id="Req-IDE-134" xreflabel="[Req-IDE-134]"/>
+<emphasis role="strong">Requirement: IDE-134:</emphasis>
+<link linkend="Req-IDE-134">for ... of statement</link> (ver. 1)</simpara>
+    <simpara>
+
+For a given <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>f</mi></math> the following conditions must hold:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>The value provided after <literal>of</literal> in a <literal>for &#8230;&#8203; of</literal> statement must be a subtype of <literal>Iterable&lt;?&gt;</literal>.</simpara>
+</listitem>
+<listitem>
+<simpara>Either a new loop variable must be declared or an rvalue must be provided as init expression:<?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>f</mi><mo>.</mo><mi>v</mi><mi>a</mi><mi>r</mi><mi>D</mi><mi>e</mi><mi>c</mi><mi>l</mi><mo>≠</mo><mi>n</mi><mi>u</mi><mi>l</mi><mi>l</mi><mo>∨</mo><mfenced close=")" open="("><mrow><mi>f</mi><mo>.</mo><mi>i</mi><mi>n</mi><mi>i</mi><mi>t</mi><mi>E</mi><mi>x</mi><mi>p</mi><mi>r</mi><mo>≠</mo><mi>n</mi><mi>u</mi><mi>l</mi><mi>l</mi><mo>∧</mo><mi>i</mi><mi>s</mi><mi>R</mi><mi>V</mi><mi>a</mi><mi>l</mi><mi>u</mi><mi>e</mi><mfenced close=")" open="("><mrow><mi>f</mi><mo>.</mo><mi>i</mi><mi>n</mi><mi>i</mi><mi>t</mi><mi>E</mi><mi>x</mi><mi>p</mi><mi>r</mi></mrow></mfenced></mrow></mfenced></math></simpara>
+</listitem>
+<listitem>
+<simpara>If a new variable <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>v</mi></math> is declared before <literal>of</literal> and it has a declared type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi></math>, the value provided after must be a subtype of <literal>Iterable&lt;?extendsT&gt;</literal>.
+If <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>v</mi></math> does not have a declared type, the type of <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>v</mi></math> is inferred to the type of the first type argument of the actual type of the value provided after <literal>of</literal>.</simpara>
+</listitem>
+<listitem>
+<simpara>If a previously-declared variable is referenced before with a declared or inferred type of <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi></math>, the value provided after <literal>of</literal> must be a subtype of <literal>Iterable&lt;?extendsT&gt;</literal>.</simpara>
+</listitem>
+</orderedlist>
+<note>
+<simpara><literal>Iterable</literal> is structurally typed on definition-site so non-N4JS types can meet the above requirements by simply implementing the only method in interface <literal>Iterable</literal> (with a correct return type).</simpara>
+</note>
+<note>
+<simpara>The first of the above constraints (the type required by the ’of’ part in a <literal>for &#8230;&#8203; of</literal> loop is <literal>Iterable</literal>) was changed during the definition of ECMAScript 6.
+This is implemented differently in separate implementations and even in different versions of the same implementation (for instance in different versions of V8).
+Older implementations require an <literal>Iterator</literal> or accept both <literal>Iterator</literal> an or <literal>Iterable</literal>.</simpara>
+</note>
+<simpara>Requiring an <literal>Iterable</literal> and not accepting a plain <literal>Iterator</literal> seems to be the final decision (as of Dec. 2014).
+For reference, see abstract operations <literal>GetIterator</literal> in [<link linkend="ECMA15a">ECMA15a(p.S7.4.2)</link>] and "CheckIterable" [<link linkend="ECMA15a">ECMA15a(p.S7.4.1)</link>] and their
+application in "ForIn/OfExpressionEvaluation" [<link linkend="ECMA15a">ECMA15a(p.S13.6.4.8)</link>] and <literal>CheckIterable</literal> and their application in <literal>ForIn/OfExpressionEvaluation</literal>.
+See also a related blog post <footnote><simpara>available at: <link xl:href="http://www.2ality.com/2013/06/iterators-generators.html">http://www.2ality.com/2013/06/iterators-generators.html</link></simpara></footnote> that is kept up to date with changes to ECMAScript 6:</simpara>
+<blockquote>
+<simpara><emphasis>ECMAScript 6 has a new loop, for-of. That loop works with iterables. Before we can use it with createArrayIterator(), we need to turn the result into an iterable.</emphasis></simpara>
+</blockquote>
+<simpara>An array or object destructuring pattern may be used left of the <literal>of</literal>.
+This is used to destructure the elements of the <literal>Iterable</literal> on the right-hand side (not the <literal>Iterable</literal> itself).
+For detais, see <xref linkend="_array-and-object-destructuring"/>.</simpara>
+</requirement>
+</section>
+<section xml:id="_import-statement">
+<title>Import Statement</title>
+<simpara>Cf. ES6 import [<link linkend="ECMA15a">ECMA15a(p.15.2.2)</link>], see also <link xl:href="https://babeljs.io/docs/usage/modules/">https://babeljs.io/docs/usage/modules/</link></simpara>
+<bridgehead xml:id="import-statement-syntax" renderas="sect4">Syntax</bridgehead>
+<simpara>The grammar of import declarations is defined as follows:</simpara>
+<programlisting language="xtext" linenumbering="unnumbered">ImportDeclaration:
+    {ImportDeclaration}
+    ImportDeclarationImpl
+;
+
+fragment ImportDeclarationImpl*:
+    'import' (
+        ImportClause importFrom?='from'
+    )? module=[types::TModule|ModuleSpecifier] Semi
+;
+
+fragment ImportClause*:
+        importSpecifiers+=DefaultImportSpecifier (',' ImportSpecifiersExceptDefault)?
+    |   ImportSpecifiersExceptDefault
+;
+
+fragment ImportSpecifiersExceptDefault*:
+        importSpecifiers+=NamespaceImportSpecifier
+    |   '{' (importSpecifiers+=NamedImportSpecifier (',' importSpecifiers+=NamedImportSpecifier)* ','?)? '}'
+;
+
+NamedImportSpecifier:
+        importedElement=[types::TExportableElement|BindingIdentifier&lt;Yield=false&gt;]
+    |   importedElement=[types::TExportableElement|IdentifierName] 'as' alias=BindingIdentifier&lt;Yield=false&gt;
+;
+
+DefaultImportSpecifier:
+    importedElement=[types::TExportableElement|BindingIdentifier&lt;Yield=false&gt;]
+;
+
+NamespaceImportSpecifier: {NamespaceImportSpecifier} '*' 'as' alias=BindingIdentifier&lt;false&gt; (declaredDynamic?='+')?;
+
+ModuleSpecifier: STRING;</programlisting>
+<simpara>These are the properties of import declaration which can be specified by the user:</simpara>
+<variablelist>
+<varlistentry>
+<term><literal>annotations</literal> </term>
+<listitem>
+<simpara>Arbitrary annotations, see <xref linkend="_annotations"/> and below for details.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>importSpecifiers</literal> </term>
+<listitem>
+<simpara>The elements to be imported with their names.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+<simpara>Also see compilation as described in <xref linkend="_modules"/>, for semantics see <xref linkend="import-statement-semantics"/>.</simpara>
+<example>
+<title>Import</title>
+<programlisting language="n4js" linenumbering="unnumbered">import A from "p/A"
+import {C,D,E} from "p/E"
+import * as F from "p/F"
+import {A as G} from "p/G"
+import {A as H, B as I} from "p/H"</programlisting>
+</example>
+<bridgehead xml:id="import-statement-semantics" xreflabel="Import Statement Semantics" renderas="sect4">Semantics</bridgehead>
+<simpara>Import statements are used to import identifiable elements from another module.
+Identifiable elements are</simpara>
+<itemizedlist>
+<listitem>
+<simpara>types (via their type declaration), in particular</simpara>
+<itemizedlist>
+<listitem>
+<simpara>classifiers (classes, interfaces)</simpara>
+</listitem>
+<listitem>
+<simpara>functions</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+<listitem>
+<simpara>variables and constants.</simpara>
+</listitem>
+</itemizedlist>
+<simpara>The module to import from is identified by the string literal following keyword <literal>from</literal>.
+This string must be a valid</simpara>
+<itemizedlist>
+<listitem>
+<simpara>complete module specifier <footnote><simpara>For more details on module specifiers, see <xref linkend="_qualified-names"/>.</simpara></footnote>:</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">    import {A} from "ProjectA/a/b/c/M"</programlisting>
+</listitem>
+<listitem>
+<simpara>plain module specifier:</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">    import {A} from "a/b/c/M"</programlisting>
+</listitem>
+<listitem>
+<simpara>or project name only, assuming the project defines a main module in its <literal>package.json</literal> file (using the <literal>mainModule</literal> package.json property, see <xref linkend="package-json-mainModule"/>):</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">    import {A} from "ProjectA"</programlisting>
+</listitem>
+</itemizedlist>
+<simpara>For choosing the element to import, there are the exact same options as in ECMAScript6:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>named imports select one or more elements by name, optionally introducing a local alias:</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">    import {C} from "M"
+    import {D as MyD} from "M"
+    import {E, F as MyF, G, H} from "M"</programlisting>
+</listitem>
+<listitem>
+<simpara>namespace imports select all elements of the remote module for import and define a namespace name; the imported elements are then accessed via the namespace name:</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">    import * as N from "M"
+    var c: N.C = new N.C();</programlisting>
+</listitem>
+<listitem>
+<simpara>default imports select whatever element was exported by the remote module as the default (there can be at most one default export per module):</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">    import C from "M"</programlisting>
+</listitem>
+<listitem>
+<simpara>namespace imports provide access to the default export:</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">    import * as N from "M"
+    var c: N.default = new N.default();</programlisting>
+</listitem>
+</itemizedlist>
+<simpara>The following constraints are defined on a (non-dynamic) import statement <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>i</mi></math>:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>The imported module needs to be accessible from the current project.</simpara>
+</listitem>
+<listitem>
+<simpara>The imported declarations need to be accessible from the current module.</simpara>
+</listitem>
+</itemizedlist>
+<simpara>For named imports, the following constraints must hold:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>No declaration must be imported multiple times, even if aliases are used.</simpara>
+</listitem>
+<listitem>
+<simpara>The names must be unique in the module. They must not conflict with each other or locally declared variables, types, or functions.</simpara>
+</listitem>
+<listitem>
+<simpara>Declarations imported via named imports are accessible only via used name (or alias) and not via original name directly.</simpara>
+</listitem>
+</itemizedlist>
+<simpara>For wildcard imports, the following constraints must hold:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>Only one namespace import can be used per (target) module, even if different namespace name is used.</simpara>
+</listitem>
+<listitem>
+<simpara>The namespace name must be unique in the module. They must not conflict with each other or locally declared variables, types, or functions.</simpara>
+</listitem>
+<listitem>
+<simpara>Declarations imported via namespace import are accessible via namespace only and not with original name directly.</simpara>
+</listitem>
+</itemizedlist>
+<simpara>For namespace imports, the following constraints must hold:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>If the referenced module is a plain <literal>js</literal> file, a warning will be created to use the dynamic import instead.</simpara>
+</listitem>
+</itemizedlist>
+<simpara>For default imports, the following constraints must hold:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>The referenced module must have a default export.</simpara>
+</listitem>
+</itemizedlist>
+<simpara>Cross-cutting constraints:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>No declaration can be imported via named import and namespace import at the same time.</simpara>
+</listitem>
+</itemizedlist>
+<example>
+<title>Imports</title>
+<simpara>Imports cannot be duplicated:</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">import * as A from 'A';
+import * as A from 'A';//error, duplicated import statement
+
+import B from 'B';
+import B from 'B';//error, duplicated import statement</programlisting>
+<simpara>Given element cannot be imported multiple times:</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">import * as A1 from 'A';
+import * as A2 from 'A';//error, elements from A already imported in A1
+
+import B from 'B';
+import B as B1 from 'B';//error, B/B is already imported as B
+
+import C as C1 from 'C';
+import C from 'C';//error, C/C is already imported as C1
+
+import D as D1 from 'D';
+import D as D2 from 'D';//error, D/D is already imported as D1
+
+import * as NE from 'E';
+import E from 'E';//error, E/E is already imported as NE.E
+
+import F from 'F';
+import * as NF from 'F';//error, F/F is already imported as F</programlisting>
+<simpara><?asciidoc-pagebreak?></simpara>
+<simpara>Names used in imports must not not conflict with each other or local
+declarations:</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">import * as A from 'A1';
+import * as A from 'A2';//A is already used as namespace for A1
+
+import B from 'B1';
+import B1 as B from 'B2';//B us already used as import B/B1
+
+import C1 as C from 'C1';
+import * as C from 'C2'; //C is already used as import C1/C1
+
+import * as D from 'D1';
+import D2 as D from 'D2';//D is already used as namespace for D1
+
+import E from 'E';
+var E: any; // conflict with named import E/E
+
+import * as F from 'F';
+var F: any; // conflict with namespace F</programlisting>
+<simpara>Using named imports, aliases and namespaces allows to refer to mulitple
+types of the same name such as  <literal>A/A</literal>, <literal>B/A</literal> and <literal>C/A</literal>:</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">import A from 'A';// local name A referencess to A/A
+import A as B from 'B';//local name B referencess to B/A
+import * as C from 'C';//local name C.A referencess to C/A</programlisting>
+<simpara><?asciidoc-pagebreak?></simpara>
+<simpara>If a declaration has been imported with an alias or namespace, it is not
+accessible via its original name:</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">import * as B from 'A1';
+import A2 as C from 'A2';
+
+var a1_bad: A1;//error, A1/A1 is not directly accessible with original name
+var a1_correct: B.A1;// A1/A1 is accessible via namespace B
+var a2_bad: A2;//error, A2/A2 is not directly accessible with original name
+var a2_correct: C;// A2/A2 is accessible via alias C</programlisting>
+</example>
+<section xml:id="Dynamic_Imports">
+<title>Dynamic Imports</title>
+<simpara>N4JS extends the ES6 module import in order that modules without a <literal>n4jsd</literal> or <literal>n4js</literal> file (plain <literal>js</literal> modules) can be imported.
+This is done by adding <literal>+</literal> to the name of the named import. This form of compile-time import without type information is not
+to be confused with import calls as described in <xref linkend="Import_Calls"/>, which are sometimes referred to as "dynamic import" as well.</simpara>
+<requirement xml:id="IDE-136">
+<title>Dynamic Import</title>
+<simpara>
+<anchor xml:id="Req-IDE-136" xreflabel="[Req-IDE-136]"/>
+<emphasis role="strong">Requirement: IDE-136:</emphasis>
+<link linkend="Req-IDE-136">Dynamic Import</link> (ver. 1)</simpara>
+    <simpara>
+
+Let <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>i</mi></math> be an import
+statement <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>i</mi></math> with a dynamic namespace specifier. The
+following constraints must hold:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>i</mi><mo>.</mo><mi>m</mi><mi>o</mi><mi>d</mi><mi>u</mi><mi>l</mi><mi>e</mi></math> must not reference an <literal>n4js</literal> file.</simpara>
+</listitem>
+<listitem>
+<simpara>If <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>i</mi><mo>.</mo><mi>m</mi><mi>o</mi><mi>d</mi><mi>u</mi><mi>l</mi><mi>e</mi></math> references an <literal>n4jsd</literal> file, a warning is
+to be created.</simpara>
+</listitem>
+<listitem>
+<simpara>If the file referenced by <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>i</mi><mo>.</mo><mi>m</mi><mi>o</mi><mi>d</mi><mi>u</mi><mi>l</mi><mi>e</mi></math> is not found, an
+error is created just as in the static case.</simpara>
+</listitem>
+</orderedlist>
+<simpara>These constraints define the error level when using dynamic import: we receive no error for <literal>js</literal>, a warning for <literal>n4jsd</literal>, and an error for <literal>n4js</literal> files.
+The idea behind these distinct error levels is as follows:<?asciidoc-br?>
+If only a plain <literal>js</literal> file is available, using the dynamic import is the only way to access elements from the <literal>js</literal> module.
+This might be an unsafe way, but it allows the access and simplifies the first steps.
+An <literal>n4jsd</literal> file may then be made available either by the developer using the <literal>js</literal> module or by a third-party library.
+In this case, we do not want to break existing code.
+There is only a warning created in the case of an available <literal>n4jsd</literal> file and a <literal>js</literal> file still must be provided by the user.
+Having an <literal>n4js</literal> file is a completely different story; no <literal>n4jsd</literal> file is required, no <literal>js</literal> file is needed
+(since the transpiler creates one from the <literal>n4js</literal> file) and there is absolutely no reason to use the module dynamically.</simpara>
+</requirement>
+</section>
+<section xml:id="_immutabilaty-of-imports">
+<title>Immutabilaty of Imports</title>
+<simpara>Imports create always immutable bindings, c.f.
+[<link linkend="ECMA15a">ECMA15a(p.8.1.1.5)</link>]
+<link xl:href="http://www.ecma-international.org/ecma-262/6.0/index.html#sec-createimportbinding">http://www.ecma-international.org/ecma-262/6.0/index.html#sec-createimportbinding</link></simpara>
+<requirement xml:id="IDE-137">
+<title>Immutable Import</title>
+<simpara>
+<anchor xml:id="Req-IDE-137" xreflabel="[Req-IDE-137]"/>
+<emphasis role="strong">Requirement: IDE-137:</emphasis>
+<link linkend="Req-IDE-137">Immutable Import</link> (ver. 1)</simpara>
+    <simpara>
+
+Let <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>i</mi></math> be a binding to an imported element.
+It is an error if</simpara>
+<itemizedlist>
+<listitem>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>i</mi></math> occurs on the left-hand side as the assignment-target of an assignment expression (this also includes any level in a destructuring pattern on the left-hand side),</simpara>
+</listitem>
+<listitem>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>i</mi></math> as a direct argument of a postfix operator (<literal>i++</literal>/<literal>i--</literal>),</simpara>
+</listitem>
+<listitem>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>i</mi></math> as a direct argument of a <literal>delete</literal> operator,</simpara>
+</listitem>
+<listitem>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>i</mi></math> as a direct argument of the <literal>increment</literal> or <literal>decrement</literal> unary operator (<literal>i++</literal>/<literal>i--</literal>)</simpara>
+</listitem>
+</itemizedlist>
+</requirement>
+</section>
+</section>
+<section xml:id="_export-statement">
+<title>Export Statement</title>
+<simpara>Cf. ES6 import [<link linkend="ECMA15a">ECMA15a(p.15.2.3)</link>]</simpara>
+<bridgehead xml:id="export-statement-syntax" renderas="sect4">Syntax</bridgehead>
+<simpara>Grammar of export declarations is defined as follows:</simpara>
+<programlisting language="xtext" linenumbering="unnumbered">ExportDeclaration:
+    {ExportDeclaration}
+    ExportDeclarationImpl
+;
+
+fragment ExportDeclarationImpl*:
+    'export' (
+        wildcardExport?='*' ExportFromClause Semi
+    |   ExportClause -&gt;ExportFromClause? Semi
+    |   exportedElement=ExportableElement
+    |   defaultExport?='default' (-&gt;exportedElement=ExportableElement | defaultExportedExpression=AssignmentExpression&lt;In=true,Yield=false&gt; Semi)
+    )
+;
+
+fragment ExportFromClause*:
+    'from' reexportedFrom=[types::TModule|ModuleSpecifier]
+;
+
+fragment ExportClause*:
+    '{'
+        (namedExports+=ExportSpecifier (',' namedExports+=ExportSpecifier)* ','?)?
+    '}'
+;
+
+ExportSpecifier:
+    element=IdentifierRef&lt;Yield=false&gt; ('as' alias=IdentifierName)?
+;
+
+ExportableElement:
+      N4ClassDeclaration&lt;Yield=false&gt;
+    | N4InterfaceDeclaration&lt;Yield=false&gt;
+    | N4EnumDeclaration&lt;Yield=false&gt;
+    | ExportedFunctionDeclaration&lt;Yield=false&gt;
+    | ExportedVariableStatement
+;</programlisting>
+<simpara>These are the properties of export declaration, which can be specified by the user:</simpara>
+<variablelist>
+<varlistentry>
+<term><literal>exportedElement</literal> </term>
+<listitem>
+<simpara>The element to be exported, can be a declaration or a variable/const statement.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+<example>
+<title>Export</title>
+<programlisting language="n4js" linenumbering="unnumbered">export public class A{}
+export interface B{}
+export function foo() {}
+export var a;
+export const c="Hello";</programlisting>
+</example>
+<bridgehead xml:id="export-statement-semantics" renderas="sect4">Semantics</bridgehead>
+<simpara>With regard to type inference, export statements are not handled at all.
+Only the exported element is inferred and the <literal>export</literal> keyword is ignored.</simpara>
+<simpara>In order to use types defined in other compilation units, these types have to be explicitly imported with an import statement.</simpara>
+<simpara>Imported namespaces cannot be exported.</simpara>
+<simpara>Declared elements (types, variables, functions) are usually only visible outside the declaring module if the elements are exported and imported (by the using module, cf. <xref linkend="_import-statement"/>).</simpara>
+<simpara>Some special components (runtime environment and libraries, cf. <xref linkend="_runtime-environment-and-runtime-libraries"/>, may export elements globally.
+This is done by annotating the export (or the whole module) with <literal>@Global</literal>, see <xref linkend="_global-definitions"/> for details.</simpara>
+<simpara>By adding <literal>default</literal> after the keyword <literal>export</literal>, the identifiable element can be exported as ’the default’.
+This can then be imported from other modules via default imports (see <xref linkend="_import-statement"/>).</simpara>
+</section>
+</section>
+</chapter>
+<chapter xml:id="_annotations">
+<title>Annotations</title>
+<section xml:id="_introduction-2" role="language-n4js">
+<title>Introduction</title>
+<simpara>Annotations are used to further define meta properties of language elements such as types, variables and functions.
+These annotations are used by the compiler and validator to prohibit the developer from introducing constructs which are either not allowed or are unnecessary in certain contexts.</simpara>
+<simpara>Since annotations are to be processed by the compiler and the compilation cannot be extended by third-party users for security reasons, annotations cannot be defined by developers.
+Instead, the compiler comes with a predefined set of annotations which are summarized here.</simpara>
+<section xml:id="_syntax-13">
+<title>Syntax</title>
+<simpara>Annotations are used similarly as in Java (although new annotations cannot be defined by the user).
+They are formally defined as follows:</simpara>
+<programlisting language="xtext" linenumbering="unnumbered">Annotation:'@' AnnotationNoAtSign;
+ScriptAnnotation returns Annotation: '@@' AnnotationNoAtSign;
+
+AnnotationNoAtSign returns Annotation:
+    name=AnnotationName (=&gt; '(' (args+=AnnotationArgument (',' args+=AnnotationArgument)*)? ')')?;
+
+AnnotationArgument:
+    LiteralAnnotationArgument | TypeRefAnnotationArgument
+;
+
+LiteralAnnotationArgument:
+    literal=Literal
+;
+
+TypeRefAnnotationArgument:
+    typeRef=TypeRef
+;</programlisting>
+</section>
+<section xml:id="_properties-7">
+<title>Properties</title>
+<simpara>We use the map notation for retrieving annotation properties and values from a list of annotations,
+for example <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>x</mi><mo>.</mo><mi>a</mi><mi>n</mi><mi>n</mi><mi>o</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>o</mi><mi>n</mi><mi>s</mi><mfenced close="]" open="["><mrow><mi>R</mi><mi>e</mi><mi>q</mi><mi>u</mi><mi>i</mi><mi>r</mi><mi>e</mi><mi>d</mi></mrow></mfenced></math>, or shorter <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>x</mi><mi>@</mi><mi>R</mi><mi>e</mi><mi>q</mi><mi>u</mi><mi>i</mi><mi>r</mi><mi>e</mi><mi>d</mi></math>.</simpara>
+<simpara><?asciidoc-pagebreak?></simpara>
+</section>
+<section xml:id="_element-specific-annotations">
+<title>Element-Specific Annotations</title>
+<simpara>The following annotations are element-specific and are explained in the corresponding sections:</simpara>
+<table frame="all" rowsep="1" colsep="1">
+<title>Element-Specific Annotations</title>
+<tgroup cols="3">
+<colspec colname="col_1" colwidth="33.3333*"/>
+<colspec colname="col_2" colwidth="33.3333*"/>
+<colspec colname="col_3" colwidth="33.3334*"/>
+<thead>
+<row>
+<entry align="left" valign="top">Annotation</entry>
+<entry align="center" valign="top">Element Types</entry>
+<entry align="left" valign="top">Section</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry align="left" valign="top"><simpara><literal>@Internal</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>TypeDefiningElement, Member, Function, Export</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><xref linkend="_access-control"/></simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><literal>@Undefined</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>Variable</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><xref linkend="_undefined-type"/></simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><literal>@StringBased</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>Enum</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><xref linkend="_string-based-enums"/></simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><literal>@Final</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>Class, Member</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><xref linkend="_final-methods"/></simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><literal>@Spec</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>FPar</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><xref linkend="Req-IDE-59"/></simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><literal>@Override</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>Method</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><xref linkend="_redefinition-of-members"/></simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><literal>@Promisifiable</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>Function</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><xref linkend="_promisifiable-functions"/></simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><literal>@Promisify</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>CallExpression</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><xref linkend="_promisifiable-functions"/></simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><literal>@This</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>Function</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><xref linkend="_this-keyword"/></simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><literal>@N4JS</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>Class, Export Statement</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><xref linkend="_external-declarations"/></simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><literal>@IgnoreImplementation</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>Script, ExportDeclaration, ExportableElement</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><xref linkend="_external-declarations"/></simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><literal>@Global</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>External Declaration</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><xref linkend="_global-definitions"/></simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><literal>@ProvidedByRuntime</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>External Declaration</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><xref linkend="_runtime-definitions"/></simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><literal>@TestAPI</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>TypeDefiningElement, Member</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><xref linkend="_test-support"/></simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><literal>@Polyfill</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>Class</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><xref linkend="_polyfill-definitions"/></simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><literal>@StaticPolyfill</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>Class</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><xref linkend="_static-polyfill-definitions"/></simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><literal>@StaticPolyfillAware</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>Script</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><xref linkend="_static-polyfill-definitions"/></simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><literal>@StaticPolyfillModule</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>Script</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><xref linkend="_static-polyfill-definitions"/></simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara><literal>@Transient</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><literal>Field</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><footnote><simpara>intended for internal use only; will be removed</simpara></footnote></simpara></entry>
+</row>
+</tbody>
+</tgroup>
+</table>
+</section>
+<section xml:id="_general-annotations">
+<title>General Annotations</title>
+<section xml:id="_idebug">
+<title>IDEBUG</title>
+<simpara><literal>@IDEBUG</literal> is an annotation similar to Java’s <literal>@SuppressWarnings</literal>.
+It changes the severity of an issue from an error to a warning so that code can be compiled regardless of validation errors.
+This is to be used for known IDE bugs only.</simpara>
+</section>
+</section>
+<section xml:id="idebug-syntax">
+<title>Syntax</title>
+<programlisting language="xtext" linenumbering="unnumbered">'@IDEBUG' '(' bugID = INT ',' errorMessage=STRING ')'</programlisting>
+<simpara>The annotation is defined transitively and repeatable on script, type declaration, function and method level.</simpara>
+<section xml:id="_semantics-11">
+<title>Semantics</title>
+<simpara>This annotation will cause errors issued in the scope of the annotation (in the defined script, type, or method) to be transformed to warnings if their message text is similar to the <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>e</mi><mi>r</mi><mi>r</mi><mi>o</mi><mi>r</mi><mi>M</mi><mi>e</mi><mi>s</mi><mi>s</mi><mi>a</mi><mi>g</mi><mi>e</mi></math> text.
+If <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>e</mi><mi>r</mi><mi>r</mi><mi>o</mi><mi>r</mi><mi>M</mi><mi>e</mi><mi>s</mi><mi>s</mi><mi>a</mi><mi>g</mi><mi>e</mi></math> ends with <literal>…</literal> (three dots as a single character, created by Eclipse to abbreviate messages), then the error’s message text must start with the specified text.</simpara>
+<simpara>If no matching error is found, the annotation itself will issue an error.</simpara>
+<example xml:id="ex:IDEBUG">
+<title>IDEBUG Example</title>
+<simpara>In the following code snippet, two errors are to be transformed to warnings.</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">export class TestDataBridge with IModuleTest {
+    @IDEBUG(166, "{function(number):void} is not a subtype of {function(T):void}.") <co xml:id="CO6-1"/>
+    @IDEBUG(91, "Incorrect number of arguments: expected 1, got 2.") <co xml:id="CO6-2"/>
+    @Override public run(): void {
+        var foo = new Foo(),
+            cb = function(val: number): void {},
+            db = DataBridge.&lt;number&gt;bind(foo, "bar");
+        db.add(cb); <co xml:id="CO6-3"/>
+        Assert.isTrue(called);
+    }
+}</programlisting>
+<calloutlist>
+<callout arearefs="CO6-1">
+<para>The annotation transforms the error <literal>{function(number):void} is not a subtype of {function(T):void}</literal> into a warning with the following text:</para>
+<programlisting language="n4js" linenumbering="unnumbered">IDEBUG-166: {function(number):void} is not a subtype of {function(T):void}.</programlisting>
+<simpara>where <literal>IDEBUG-166</literal> refers to the corresponding bug report, that is <link xl:href="https://github.com/NumberFour/n4js/issues/166">IDEBUG-166</link>.</simpara>
+</callout>
+<callout arearefs="CO6-2">
+<para>This annotation was proposed as a workaround for <link xl:href="https://github.com/NumberFour/n4js/issues/91">IDEBUG-91</link> which has been fixed.<?asciidoc-br?>
+No error message is produced and an error will be issued on this line instead:</para>
+<programlisting language="n4js" linenumbering="unnumbered">No matching error found, apparently bug IDEBUG-91 has been fixed or does not occur here.</programlisting>
+</callout>
+<callout arearefs="CO6-3">
+<para>The first error occurs since there is a bug in the IDE type system (as of writing this example) where type arguments are not correctly bound in the case of function expressions used as callback methods.</para>
+</callout>
+</calloutlist>
+</example>
+</section>
+<section xml:id="_suppress-warnings">
+<title>Suppress Warnings</title>
+<tip>
+<simpara>This is not part of the current version</simpara>
+</tip>
+</section>
+</section>
+</section>
+<section xml:id="_declaration-of-annotations">
+<title>Declaration of Annotations</title>
+<tip>
+<simpara>This is not part of the current version</simpara>
+</tip>
+</section>
+</chapter>
+<chapter xml:id="_extended-fetaures">
+<title>Extended Fetaures</title>
+<section xml:id="_array-and-object-destructuring" role="language-n4js">
+<title>Array and Object Destructuring</title>
+<simpara>N4JS supports array and object destructuring as provided in ES6.
+This is used to conveniently assign selected elements of an array or object to a number of newly-declared or pre-existing variables or to further destructure them by using nested
+destructuring patterns <footnote><simpara>Further reading on <link linkend="_acronyms">DI</link> Basics: [<link linkend="Fowler04b">Fowler04b</link>; <link linkend="Prasanna09a">Prasanna09a</link>], Verification [<link linkend="Zhu13a">Zhu13a</link>; <link linkend="Hudli13a">Hudli13a</link>], Frameworks [<link linkend="Lesiecki08a">Lesiecki08a</link>; <link linkend="Betts13a">Betts13a</link>; <link linkend="Knol13a">Knol13a</link>; <link linkend="Dagger">Dagger</link>]</simpara></footnote>.</simpara>
+<section xml:id="_syntax-14">
+<title>Syntax</title>
+<programlisting language="ebnf" linenumbering="unnumbered">BindingPattern &lt;Yield&gt;:
+    ObjectBindingPattern&lt;Yield&gt;
+    | ArrayBindingPattern&lt;Yield&gt;
+;
+
+ObjectBindingPattern &lt;Yield&gt; returns BindingPattern:
+    {BindingPattern}
+    '{' (properties+=BindingProperty&lt;Yield,AllowType=false&gt; (',' properties+=BindingProperty&lt;Yield,AllowType=false&gt;)*)? '}'
+;
+
+ArrayBindingPattern &lt;Yield&gt; returns BindingPattern:
+    {BindingPattern}
+    '['
+        elements+=Elision* (
+            elements+=BindingRestElement&lt;Yield&gt;
+            (',' elements+=Elision* elements+=BindingRestElement&lt;Yield&gt;)*
+            (',' elements+=Elision*)?
+        )?
+    ']'
+;
+
+BindingProperty &lt;Yield, AllowType&gt;:
+      =&gt;(LiteralBindingPropertyName&lt;Yield&gt; ':') value=BindingElement&lt;Yield&gt;
+    | value=SingleNameBinding&lt;Yield,AllowType&gt;
+;
+
+fragment LiteralBindingPropertyName &lt;Yield&gt;*:
+    declaredName=IdentifierName | declaredName=STRING | declaredName=NumericLiteralAsString
+    // this is added here due to special treatment for a known set of expressions
+    | '[' (declaredName=SymbolLiteralComputedName&lt;Yield&gt; | declaredName=STRING) ']'
+;</programlisting>
+</section>
+<section xml:id="_semantics-12">
+<title>Semantics</title>
+<simpara>The following example declares four variables <literal>a</literal>, <literal>b</literal>, <literal>x</literal>, and <literal>prop2</literal>. Variables <literal>a</literal> and <literal>x</literal> will have the value <literal>hello</literal>, whereas <literal>b</literal> and <literal>prop2</literal> will have value 42.</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">var [a,b] = ["hello", 42];
+
+var {prop1:x, prop2} = {prop1:"hello", prop2:42};</programlisting>
+<simpara>In the case of <literal>prop2</literal>, we do not provide a property name and variable name separately; this is useful in cases where the property name also makes for a
+suitable variable name (called <literal>single name binding</literal>).</simpara>
+<simpara>One of the most useful use cases of destructuring is in a <literal>for..of</literal> loop.
+Take this example:</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">var arr1 = [ ["hello",1,2,3], ["goodbye",4,5,6] ];
+for(var [head,...tail] of arr1) {
+    console.log(head,'/',tail);
+}
+// will print:
+//   hello / [ 1, 2, 3 ]
+//   goodbye / [ 4, 5, 6 ]
+
+var arr2 = [ {key:"hello", value:42}, {key:"goodbye", value:43} ];
+for(var {key,value} of arr2) {
+    console.log(key,'/',value);
+}
+// will print:
+//   hello / 42
+//   goodbye / 43</programlisting>
+<simpara>Array and object destructuring pattern can appear in many different places:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>In a variable declaration (not just in variable statements but also in other places where variable declarations are allowed, e.g. plain for loops; called <emphasis>destructuring binding</emphasis>; see <xref linkend="_variable-statement"/>).</simpara>
+</listitem>
+<listitem>
+<simpara>On the left-hand side of an assignment expression (the assignment expression is then called <emphasis>destructuring assignment</emphasis>; see <xref linkend="_assignment-expression"/>).</simpara>
+</listitem>
+<listitem>
+<simpara>In a <literal>for..in</literal> or <literal>for..of</literal> loop on the left side of the <literal>in</literal>/<literal>of</literal> (see <xref linkend="_for-of-statement"/>).</simpara>
+<note>
+<simpara>It can also be used in plain statements, but then we actually have one of the above two use cases.</simpara>
+</note>
+</listitem>
+<listitem>
+<simpara>With lists of formal parameters or function arguments (not supported yet).</simpara>
+</listitem>
+</itemizedlist>
+<simpara>For further details on array and object destructuring please refer to the ECMAScript 6 specification - [<link linkend="ECMA15a">ECMA15a</link>].</simpara>
+<simpara>Type annotations can only be added when a new variable name is introduced since the short version would be ambiguous with the long one.
+For example:</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">var {x: someTypeOrNewVar} = ol</programlisting>
+<simpara>could either mean that a new variable <literal>someTypeOrNewVar</literal> is declared and <literal>ol.x</literal> is assigned to it, or that a new variable <literal>x</literal> is declared with type <literal>someTypeOrNewVar</literal>.
+The longer form would look like this:</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">var {x: x: someType} = ol</programlisting>
+<simpara>We can make this more readable:</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">var {propOfOl: newVar: typeOfNewVar} = ol</programlisting>
+</section>
+</section>
+<section xml:id="_dependency-injection" role="language-n4js">
+<title>Dependency Injection</title>
+<simpara>This chapter describes <link linkend="_acronyms">DI</link> mechanisms for N4JS.
+This includes compiler, validation and language extensions that allow to achieve DI mechanisms built in into the N4JS language and IDE.</simpara>
+<simpara>N4JS <link linkend="_acronyms">DI</link> support specifies a means for obtaining objects in such a way as to maximize reusability, testability and maintainability,
+especially compared to traditional approaches such as constructors, factories and service locators.
+While this can be achieved manually (without tooling support) it is difficult for nontrivial applications.
+The solutions that DI provides should empower N4JS users to achieve the above goals without the burden of maintaining so-called ’boilerplate’ code.</simpara>
+<figure xml:id="fig-di-terms">
+<title>DI Basic Terms</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/11_extFeatures/fig/diBasicTerms.png" width="60%" scalefit="1" align="center"/>
+</imageobject>
+<textobject><phrase>diBasicTerms</phrase></textobject>
+</mediaobject>
+</figure>
+<simpara><emphasis>key: pass the dependency instead of letting the client create or find it</emphasis></simpara>
+<simpara>Core terms</simpara>
+<itemizedlist>
+<listitem>
+<simpara><emphasis role="strong">Service</emphasis> - A set of APIs describing the functionality of the service.</simpara>
+</listitem>
+<listitem>
+<simpara><emphasis role="strong">Service Implementation</emphasis>s - One or more implementations of given service API.</simpara>
+</listitem>
+<listitem>
+<simpara><emphasis role="strong">Client</emphasis> - Consumer of a given functionality, uses the given <emphasis role="strong">Service Implementation</emphasis>.</simpara>
+</listitem>
+<listitem>
+<simpara><emphasis role="strong">Injector</emphasis> - Object providing <emphasis role="strong">Service Implementation</emphasis> of a specific <emphasis role="strong">Service</emphasis>, according to configuration.</simpara>
+</listitem>
+<listitem>
+<simpara><emphasis role="strong">Binding</emphasis> - Part of configuration describing which interface implementing a subtype will be injected, when a given interface is requested.</simpara>
+</listitem>
+<listitem>
+<simpara><emphasis role="strong">Provider</emphasis> - Factory used to create instances of a given <emphasis role="strong">Service Implementation</emphasis> or its sub-components, can be a method.</simpara>
+</listitem>
+<listitem>
+<simpara><emphasis role="strong">Injection Point</emphasis> - Part of the user’s code that will have the given dependency injected. This is usually fields, method parameters, constructor parameters etc.</simpara>
+</listitem>
+<listitem>
+<simpara><emphasis role="strong">DI configuration</emphasis> - This describes which elements of the user’s code are used in mechanisms and how they are wired.
+It is derived from user code elements being marked with appropriate annotations, bindings and providers.</simpara>
+</listitem>
+<listitem>
+<simpara><emphasis role="strong">di wiring</emphasis> - The code responsible for creating user objects.
+These are injectors, type factories/providers, fields initiators etc.</simpara>
+</listitem>
+</itemizedlist>
+<section xml:id="_di-components-and-injectors">
+<title>DI Components and Injectors</title>
+<simpara>N4JS’ <xref linkend="_dependency-injection"/> systems is based on the notion of <link linkend="_acronyms">DIC</link>.</simpara>
+<definition>
+<title>DI Component</title>
+<simpara>
+<anchor xml:id="di_component" xreflabel="[di_component]"/>
+<emphasis role="strong">Definition:</emphasis>
+<link linkend="di_component">DI Component</link></simpara>
+<simpara>
+
+A <link linkend="_acronyms">DIC</link> is a N4Class annotated with <literal>@GenerateInjector</literal>.</simpara>
+</definition>
+<simpara>This annotation causes an <emphasis>injector</emphasis> to be created for (and associated to) the <link linkend="_acronyms">DI</link>.
+DIC can be composed; meaning that when requested to inject an instance of a type, a DIC’s injector can delegate this request to the injector of the containing DIC.
+An injector always prioritizes its own configuration before delegating to the container’s injector.
+For validation purposes, a child DI can be annotated with <literal>@WithParent</literal> to ensure that it is always used with a proper parent.</simpara>
+<simpara><emphasis>Injector</emphasis> is the main object of DI mechanisms responsible for creating object graphs of the application.
+At runtime, injectors are instances of <literal>N4Injector</literal>.</simpara>
+<requirement xml:id="IDE-138">
+<title>DI Component and Injector</title>
+<simpara>
+<anchor xml:id="Req-IDE-138" xreflabel="[Req-IDE-138]"/>
+<emphasis role="strong">Requirement: IDE-138:</emphasis>
+<link linkend="Req-IDE-138">DI Component and Injector</link> (ver. 1)</simpara>
+    <simpara>
+</simpara>
+<simpara>The following constraints must hold for a class <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>C</mi></math> marked as DIC:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>A subclass <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>S</mi></math> of <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>C</mi></math> is a DIC as well and it must be marked with <literal>GenerateInjector</literal>.</simpara>
+</listitem>
+<listitem>
+<simpara>If a parent <link linkend="_dicomponent-relations">DIC</link> <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>P</mi></math> is specified via <literal>WithParent</literal>, then <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>P</mi></math> must be a DIC as well.</simpara>
+</listitem>
+<listitem>
+<simpara>The injector associated to a DIC is of type <literal>N4Injector</literal>. It can be retrieved via <literal>N4Injector.of(DIC)</literal> in which <literal>DIC</literal> is the <literal>DIC</literal>.</simpara>
+</listitem>
+<listitem>
+<simpara>Injectors associated to DIC a are DI-singletons (cf. <xref linkend="_singleton-scope"/>).
+Two calls to <literal>N4Injector.of(DIC)</literal> are different (as different DIC are assumed).</simpara>
+</listitem>
+</orderedlist>
+</requirement>
+<requirement xml:id="IDE-139">
+<title>Injection Phase</title>
+<simpara>
+<anchor xml:id="Req-IDE-139" xreflabel="[Req-IDE-139]"/>
+<emphasis role="strong">Requirement: IDE-139:</emphasis>
+<link linkend="Req-IDE-139">Injection Phase</link> (ver. 1)</simpara>
+    <simpara>
+</simpara>
+<simpara>We call the (transitive) creation and setting of values by an injector <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>I</mi></math> caused by the creation of an root object <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>R</mi></math> the <emphasis>injection phase</emphasis>.
+If an instance <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>C</mi></math> is newly created by the injector <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>I</mi></math> (regardless of the injection point being used), the injection is transitively applied on <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>C</mi></math>.
+The following constraints have to hold:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>Root objects are created by one of the following mechanisms:</simpara>
+<orderedlist numeration="loweralpha">
+<listitem>
+<simpara>Any class or interface can be created as root objects via an injector associated to a DIC:<?asciidoc-br?>
+<literal>var x: X = N4Injector.of(DIC).create(X);</literal><?asciidoc-br?>
+in which <literal>DIC</literal> is a DIC.</simpara>
+<simpara>Of course, an appropriate binding must exist. <footnote><simpara>Usually, only the <literal>DIC</literal> itself is created like that, e.g., <literal role="language-n4js">var dic = N4Injector.of(DIC).create(DIC);</literal></simpara></footnote></simpara>
+</listitem>
+<listitem>
+<simpara>If a type has the injector being injected, e.g. via field injection <literal>@Inject injector: N4Injector;</literal>, then this injector can be used anytime in the control flow to create
+a new root object similar as above (using <literal>create</literal> method).</simpara>
+</listitem>
+<listitem>
+<simpara>If a provider has been injected (i.e. an instance of <literal>{N4Provider}</literal>), then its <literal>get()</literal> method can be used to create a root object causing a new injection phase to take place.</simpara>
+</listitem>
+</orderedlist>
+</listitem>
+<listitem>
+<simpara>If <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>C</mi><mo>.</mo><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi></math> is marked as injection point, all its arguments are set by the injector.
+This is also true for an inherited constructor marked as an injection point.
+See <xref linkend="Req-IDE-143"/> . For all arguments the injection phase constraints have to hold as well.</simpara>
+</listitem>
+<listitem>
+<simpara>All fields of <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>C</mi></math>, including <emphasis>inherited</emphasis> once, marked as injection points are set by the injector.
+For all fields the injection phase constraints have to hold as well.</simpara>
+</listitem>
+</orderedlist>
+<simpara>The injector may use a provider method (of a binder) to create nested instances.</simpara>
+<simpara>The injector is configured with <emphasis>Binders</emphasis> and it tracks <emphasis>Bindings</emphasis> between types (<xref linkend="_binders-and-bindings"/>).
+An N4JS developer normally would not interact with this object directly except when defining an entry-point to his application.
+<emphasis>Injector</emphasis>s are configured with <emphasis>Binder</emphasis>s which contain explicit <emphasis>Binding</emphasis>s defined by an N4JS developer.
+A set of these combined with <emphasis>implicit bindings</emphasis> creates the <emphasis>di configuration</emphasis> used by a given injector.
+To configure given <emphasis>Injector</emphasis>s with given <emphasis>Binder</emphasis>(s) use <literal>@UseBinder</literal> annotation.</simpara>
+</requirement>
+<section xml:id="_dicomponent-relations">
+<title>DIComponent Relations</title>
+<simpara>A Parent-Child relation can be established between two DIComponents.
+Child DIComponents use the parent bindings but can also be configured with their own bindings or <emphasis>change</emphasis> targets used by a parent.
+The final circumstance is local to the child and is referred to as <emphasis>rebinding</emphasis>.
+For more information about bindings see <xref linkend="_binders-and-bindings"/>.
+A Child-Parent relation is expressed by the <literal>@WithParentInjector</literal> annotation attached to a given DIComponent.
+When this relation is defined between DIComponents, the user needs to take care to preserve the proper relation between injectors.
+In other words, the user must provide an instance of the parent injector (the injector of the DIComponent passes as a parameter to <literal>@WithParentInjector</literal>) when creating the child injector
+(injector of the DIComponent annotated with <literal>@WithParentInjector</literal>).</simpara>
+<example>
+<title>Simple DIComponents Relation</title>
+<programlisting language="n4js" linenumbering="unnumbered">@GenerateInjector
+class ParentDIComponent{}
+
+@GenerateInjector
+@WithParentInjector(ParentDIComponent)
+class ChildDIComponent{}
+
+var parentInejctor = N4Inejctor.of(ParentDiCompoennt);
+var childInjector = N4Inejctor.of(ChildDIComponent, parentInjector);</programlisting>
+</example>
+<simpara>With complex DIComponent structures, injector instances can be created with a directly-declared parent and also with any of its children.
+This is due to the fact that any child can rebind types, add new bindings, but not remove them.
+Any child is, therefore, <emphasis>compatible</emphasis> with its parents.</simpara>
+<definition>
+<title>Compatible DIComponent</title>
+<simpara>
+<anchor xml:id="compatible_dicomponent" xreflabel="[compatible_dicomponent]"/>
+<emphasis role="strong">Definition:</emphasis>
+<link linkend="compatible_dicomponent">Compatible DIComponent</link></simpara>
+<simpara>
+
+A given DIComponent is compatible with another DIComponent if it has bindings for all keys in other component bindings.</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mo>∃</mo><mi>D</mi><mi>I</mi><mi>C</mi><mn>1</mn><mo>,</mo><mi>D</mi><mi>I</mi><mi>C</mi><mn>2</mn><mi>:</mi><mi>D</mi><mi>I</mi><mi>C</mi><mn>1.</mn><mover accent="true"><mrow><mi>b</mi><mi>i</mi><mi>n</mi><mi>d</mi><mi>i</mi><mi>n</mi><mi>g</mi></mrow><mo>¯</mo></mover><mo>.</mo><mover accent="true"><mrow><mi>k</mi><mi>e</mi><mi>y</mi></mrow><mo>¯</mo></mover><mo>⇒</mo><mi>D</mi><mi>I</mi><mi>C</mi><mn>2.</mn><mover accent="true"><mrow><mi>b</mi><mi>i</mi><mi>n</mi><mi>d</mi><mi>i</mi><mi>n</mi><mi>g</mi></mrow><mo>¯</mo></mover><mo>.</mo><mover accent="true"><mrow><mi>k</mi><mi>e</mi><mi>y</mi></mrow><mo>¯</mo></mover><mo>⇔</mo><mi>D</mi><mi>I</mi><mi>C</mi><mn>2</mn><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>D</mi><mi>I</mi><mi>C</mi><mn>1</mn></math>
+<note>
+<simpara>Although subtype notation <math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/></math> is used here it does <emphasis role="strong">not</emphasis> imply actual subtype relations.
+It was used in this instance for of lack of formal notations for DI concepts and because this is similar to the Liskov Substitution principle.</simpara>
+</note>
+<simpara>A complex Child-Parent relation between components is depicted in <xref linkend="fig-complex-dicomponents-relations"/> and <xref linkend="ex:complex-dicomponents-relations"/> below.</simpara>
+<figure xml:id="fig-complex-dicomponents-relations">
+<title>Complex DIComponents Relations</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/11_extFeatures/fig/diagDICParentChild.svg" width="50%" scalefit="1" align="center"/>
+</imageobject>
+<textobject><phrase>diagDICParentChild</phrase></textobject>
+</mediaobject>
+</figure>
+</definition>
+<example xml:id="ex:complex-dicomponents-relations">
+<title>Complex DIComponents Relations</title>
+<programlisting language="n4js" linenumbering="unnumbered">@GenerateInjector class A {}
+@GenerateInjector @WithParentInjector(A) class B {}
+@GenerateInjector @WithParentInjector(B) class C {}
+@GenerateInjector @WithParentInjector(C) class D {}
+@GenerateInjector @WithParentInjector(A) class B2 {}
+@GenerateInjector @WithParentInjector(B2) class C2 {}
+@GenerateInjector @WithParentInjector(C2) class D2 {}
+@GenerateInjector @WithParentInjector(A) class X {}
+@GenerateInjector @WithParentInjector(C) class Y {}
+
+// creating injectors
+var injectorA = N4Injector.of(A);
+//following throws DIConfigurationError, expected parent is not provided
+//var injectorB =  N4Injector.of(B);
+//correct declarations
+var injectorB =  N4Injector.of(B, injectorA);
+var injectorC = N4Injector.of(C, injectorB);
+var injectorD = N4Injector.of(D, injectorC);
+var injectorB2 = N4Injector.of(B2, injectorA);
+var injectorC2 = N4Injector.of(C2, injectorB2);
+var injectorD2 = N4Injector.of(D2, injectorC2);
+
+//Any injector of {A,B,C,D,b2,C2,D2} s valid parent for injector of X, e.g. D or D2
+N4Injector.of(X, injectorD);//is ok as compatible parent is provided
+N4Injector.of(X, injectorD2);//is ok as compatible parent is provided
+
+N4Injector.of(Y, injectorC);//is ok as direct parent is provided
+N4Injector.of(Y, injectorD);//is ok as compatible parent is provided
+
+N4Injector.of(Y, injectorB2);//throws DIConfigurationError, incompatible parent is provided
+N4Injector.of(Y, injectorC2);//throws DIConfigurationError, incompatible parent is provided
+N4Injector.of(Y, injectorD2);//throws DIConfigurationError, incompatible parent is provided</programlisting>
+</example>
+</section>
+</section>
+<section xml:id="_binders-and-bindings">
+<title>Binders and Bindings</title>
+<simpara><emphasis>Binder</emphasis> allows an N4JS developer to (explicitly) define a set of <emphasis>Binding</emphasis>s that will be used by an <emphasis>Injector</emphasis> configured with a given <emphasis>Binder</emphasis>.
+There are two ways for <emphasis>Binder</emphasis> to define <emphasis>Binding</emphasis>s: <literal>@Bind</literal> (<xref linkend="_n4js-di-bind"/>) annotations and a method annotated with <literal>@Provides</literal>.</simpara>
+<simpara><emphasis>Binder</emphasis> is declared by annotating a class with the <literal>@Binder</literal> annotation.</simpara>
+<simpara>A <emphasis>Binding</emphasis> is part of a configuration that defines which instance of
+what type should be injected into an <emphasis>injection point</emphasis> (<xref linkend="_injection-points"/>) with an expected type.</simpara>
+<simpara><emphasis>Provider Method</emphasis> is essentially a <emphasis>factory method</emphasis> that is used to create an instance of a type.
+N4JS allows a developer to declare those methods (see <xref linkend="_n4js-di-provides"/>) which gives them a hook in instance creation process.
+Those methods will be used when creating instances by the <emphasis>Injector</emphasis> configured with the corresponding <emphasis>Binder</emphasis>.
+A provider method is a special kind of binding (<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>k</mi><mi>e</mi><mi>y</mi></math>) in which the return type of the method is the <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>k</mi><mi>e</mi><mi>y</mi></math>.
+The <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>t</mi><mi>a</mi><mi>r</mi><mi>g</mi><mi>e</mi><mi>t</mi></math> type is unknown at compile time (although it may be inferred by examining the return statements of the provide method).</simpara>
+<definition>
+<title>Binding</title>
+<simpara>
+<anchor xml:id="binding" xreflabel="[binding]"/>
+<emphasis role="strong">Definition:</emphasis>
+<link linkend="binding">Binding</link></simpara>
+<simpara>
+
+A <emphasis>binding</emphasis> is a pair <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>b</mi><mi>i</mi><mi>n</mi><mi>d</mi><mfenced close=")" open="("><mrow><mi>k</mi><mi>e</mi><mi>y</mi></mrow><mrow><mi>t</mi><mi>a</mi><mi>r</mi><mi>g</mi><mi>e</mi><mi>t</mi></mrow></mfenced></math>.
+It defines that for a dependency with a given key which usually is the expected type at the injection point.
+An instance of type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>t</mi><mi>a</mi><mi>r</mi><mi>g</mi><mi>e</mi><mi>t</mi></math> is injected.</simpara>
+<simpara>A <emphasis>binding</emphasis> is called <emphasis>explicit</emphasis> if it is declared in the code, i.e. via <literal>@Bind</literal>
+annotation or <literal>@Provides</literal> annotation).</simpara>
+<simpara>A <emphasis>binding</emphasis> is called <emphasis>implicit</emphasis> if it is not declared.
+An implicit binding can only be used if the <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>k</mi><mi>e</mi><mi>y</mi></math> is a class and derived from the type at the injection point, i.e. the type of the field or parameter to be injected.
+In that case, the <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>t</mi><mi>a</mi><mi>r</mi><mi>g</mi><mi>e</mi><mi>t</mi></math> equals the <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>k</mi><mi>e</mi><mi>y</mi></math>.</simpara>
+<simpara>A provider method <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>M</mi></math> (in the binder) defines a binding</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mi>b</mi><mi>i</mi><mi>n</mi><mi>d</mi><mfenced close=")" open="("><mrow><mi>M</mi><mo>.</mo><mi>r</mi><mi>e</mi><mi>t</mi><mi>u</mi><mi>r</mi><mi>n</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi></mrow><mi>X</mi></mfenced></math>
+<simpara>(in which <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>X</mi></math> is an existential type with <math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∃</mo><mi>X</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>t</mi><mi>a</mi><mi>r</mi><mi>g</mi><mi>e</mi><mi>t</mi><mo>.</mo><mi>r</mi><mi>e</mi><mi>t</mi><mi>u</mi><mi>r</mi><mi>n</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi></math>).</simpara>
+<simpara>For simplification, we define:</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mtable><mtr><mtd><mi>k</mi><mi>e</mi><mi>y</mi><mo>*</mo><mo>=</mo><mfenced close="" open="{"><mtable><mtr><mtd><mi>t</mi><mi>a</mi><mi>r</mi><mi>g</mi><mi>e</mi><mi>t</mi><mo>.</mo><mi>r</mi><mi>e</mi><mi>t</mi><mi>u</mi><mi>r</mi><mi>n</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi><mo>,</mo></mtd><mtd><mstyle mathvariant="bold"><mtext>if target is provider method</mtext></mstyle></mtd></mtr><mtr><mtd><mi>k</mi><mi>e</mi><mi>y</mi><mo>,</mo></mtd><mtd><mstyle mathvariant="bold"><mtext>otherwise (key is a type reference)</mtext></mstyle></mtd></mtr></mtable></mfenced></mtd></mtr></mtable></math>
+<simpara>and</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mtable><mtr><mtd><mi>t</mi><mi>a</mi><mi>r</mi><mi>g</mi><mi>e</mi><mi>t</mi><mo>*</mo><mo>=</mo><mfenced close="" open="{"><mtable><mtr><mtd><mi>X</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>t</mi><mi>a</mi><mi>r</mi><mi>g</mi><mi>e</mi><mi>t</mi><mo>.</mo><mi>r</mi><mi>e</mi><mi>t</mi><mi>u</mi><mi>r</mi><mi>n</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi><mo>,</mo></mtd><mtd><mstyle mathvariant="bold"><mtext>if target is provider method</mtext></mstyle></mtd></mtr><mtr><mtd><mi>t</mi><mi>a</mi><mi>r</mi><mi>g</mi><mi>e</mi><mi>t</mi><mo>,</mo></mtd><mtd><mstyle mathvariant="bold"><mtext>otherwise (target is a type reference)</mtext></mstyle></mtd></mtr></mtable></mfenced></mtd></mtr></mtable></math>
+</definition>
+<requirement xml:id="IDE-140">
+<title>Bindings</title>
+<simpara>
+<anchor xml:id="Req-IDE-140" xreflabel="[Req-IDE-140]"/>
+<emphasis role="strong">Requirement: IDE-140:</emphasis>
+<link linkend="Req-IDE-140">Bindings</link> (ver. 1)</simpara>
+    <simpara>
+
+For a given binding <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>b</mi><mo>=</mo><mfenced close=")" open="("><mrow><mi>k</mi><mi>e</mi><mi>y</mi></mrow><mrow><mi>t</mi><mi>a</mi><mi>r</mi><mi>g</mi><mi>e</mi><mi>t</mi></mrow></mfenced></math>, the following constraints must hold: <footnote><simpara>Note that other frameworks may define other constraints, e.g., arbitrary keys.</simpara></footnote></simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>k</mi><mi>e</mi><mi>y</mi></math> must be either a class or an interface.</simpara>
+</listitem>
+<listitem>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>t</mi><mi>a</mi><mi>r</mi><mi>g</mi><mi>e</mi><mi>t</mi></math> must either be a class or a provider method.</simpara>
+</listitem>
+<listitem>
+<simpara>If <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>b</mi></math> is implicit, then <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>k</mi><mi>e</mi><mi>y</mi></math> must be a class.
+If <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>k</mi><mi>e</mi><mi>y</mi></math> references a type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi></math>, then <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>t</mi><mi>a</mi><mi>r</mi><mi>g</mi><mi>e</mi><mi>t</mi><mo>=</mo><mi>T</mi></math> – even if <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>k</mi><mi>e</mi><mi>y</mi></math> is a use-site structural type.</simpara>
+</listitem>
+<listitem>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>k</mi><mi>e</mi><mi>y</mi></math> and <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>t</mi><mi>a</mi><mi>r</mi><mi>g</mi><mi>e</mi><mi>t</mi><mo>*</mo></math> can be nominal, structural or field-structural types, either definition-site or use-site.
+The injector and binder needs to take the different structural reference into account at runtime!</simpara>
+</listitem>
+<listitem>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>t</mi><mi>a</mi><mi>r</mi><mi>g</mi><mi>e</mi><mi>t</mi><mo>*</mo><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>k</mi><mi>e</mi><mi>y</mi></math> must hold</simpara>
+</listitem>
+<listitem>
+<simpara>If during injection phase no binding for a given key is found, an <literal>DIUnsatisfiedBindingError</literal> is thrown.</simpara>
+</listitem>
+</orderedlist>
+</requirement>
+<requirement xml:id="IDE-141">
+<title>Transitive Bindings</title>
+<simpara>
+<anchor xml:id="Req-IDE-141" xreflabel="[Req-IDE-141]"/>
+<emphasis role="strong">Requirement: IDE-141:</emphasis>
+<link linkend="Req-IDE-141">Transitive Bindings</link> (ver. 1)</simpara>
+    <simpara>
+
+If an injector contains two given bindings <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>b</mi><mn>1</mn></msub><mo>=</mo><mfenced close=")" open="("><mrow><mi>k</mi><mi>e</mi><msub><mi>y</mi><mn>1</mn></msub></mrow><mrow><mi>t</mi><mi>a</mi><mi>r</mi><mi>g</mi><mi>e</mi><msub><mi>t</mi><mn>1</mn></msub></mrow></mfenced></math> and
+<math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>b</mi><mn>2</mn></msub><mo>=</mo><mfenced close=")" open="("><mrow><mi>k</mi><mi>e</mi><msub><mi>y</mi><mn>2</mn></msub></mrow><mrow><mi>k</mi><mi>e</mi><msub><mi>y</mi><mn>1</mn></msub></mrow></mfenced></math>, an effective binding
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>b</mi><mo>=</mo><mfenced close=")" open="("><mrow><mi>k</mi><mi>e</mi><msub><mi>y</mi><mn>2</mn></msub></mrow><mrow><mi>t</mi><mi>a</mi><mi>r</mi><mi>g</mi><mi>e</mi><msub><mi>t</mi><mn>1</mn></msub></mrow></mfenced></math> is derived (replacing
+<math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>b</mi><mn>1</mn></msub></math>).</simpara>
+<simpara>N4JS <link linkend="_acronyms">DI</link> mechanisms don’t allow for injection of primitives or built-in types.
+Only user-defined N4Types can be used. In cases where a user needs to inject a primitive or a built-in type, the developer must wrap it into its own
+class <footnote><simpara>Cf. a blog post about micro types - <link xl:href="http://www.markhneedham.com/blog/2009/03/10/oo-micro-types/">http://www.markhneedham.com/blog/2009/03/10/oo-micro-types/</link>, and tiny types - <link xl:href="http://darrenhobbs.com/2007/04/11/tiny-types/">http://darrenhobbs.com/2007/04/11/tiny-types/</link></simpara></footnote>.
+This is to say that none of the following metatypes can be bound: primitive types, enumerations, functions, object types, union- or intersection types. It is possible to (implicitly) bind to built-in classes.</simpara>
+<simpara>While direct binding overriding or rebinding is not allowed, <emphasis>Injector</emphasis> can be configured in a way where one type can be separately bound to different types with implicit binding,
+<emphasis>explicit binding</emphasis> and in bindings of the child injectors.
+<emphasis>Binding precedence</emphasis> is a mechanism of <emphasis>Injector</emphasis> selecting a binding use for a type.
+It operates in the following order:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>Try to use explicit binding, if this is not available:</simpara>
+</listitem>
+<listitem>
+<simpara>Try to delegate to parent injectors (order of lookup is not guaranteed, first found is selected). If this is not available then:</simpara>
+</listitem>
+<listitem>
+<simpara>Try to use use implicit binding, which is simply to attempt to create the instance.</simpara>
+</listitem>
+</orderedlist>
+<simpara>If no binding for a requested type is available an error will be thrown.</simpara>
+</requirement>
+</section>
+<section xml:id="_injection-points">
+<title>Injection Points</title>
+<simpara>By <emphasis>injection point</emphasis> we mean a place in the source code which, at runtime, will be expected to hold a reference to a particular type instance.</simpara>
+<section xml:id="_field-injection">
+<title>Field Injection</title>
+<simpara>In its simplest form, this is a class field annotated with <literal>@Inject</literal> annotation.
+At runtime, an instance of the containing class will be expected to hold reference to an instance of the field declared type.
+Usually that case
+is called <emphasis>Field Injection</emphasis>.</simpara>
+<requirement xml:id="IDE-142">
+<title>Field Injection</title>
+<simpara>
+<anchor xml:id="Req-IDE-142" xreflabel="[Req-IDE-142]"/>
+<emphasis role="strong">Requirement: IDE-142:</emphasis>
+<link linkend="Req-IDE-142">Field Injection</link> (ver. 1)</simpara>
+    <simpara>
+
+The injector will inject the
+following fields:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>All directly contained fields annotated with <literal>@Inject</literal>.</simpara>
+</listitem>
+<listitem>
+<simpara>All inherited fields annotated with <literal>@Inject</literal>.</simpara>
+</listitem>
+<listitem>
+<simpara>The injected fields will be created by the injector and their fields will be injected as well.</simpara>
+</listitem>
+</orderedlist>
+</requirement>
+<example>
+<title>Simple Field Injection</title>
+<simpara><xref linkend="ex:field-injection"/> demonstrates simple field injection using default bindings.
+Note that all inherited fields (i.e. <literal>A.xInA</literal>) are injected and also fields in injected fields (i.e. <literal>x.y</literal>)</simpara>
+<formalpara xml:id="ex:field-injection">
+<title>Simple Field Injection</title>
+<para>
+<programlisting language="n4js" linenumbering="unnumbered">class X {
+    @Inject y: Y;
+}
+class Y {}
+
+class A {
+    @Inject xInA: X;
+}
+class B extends A {
+    @Inject xInB: X;
+}
+
+@GenerateInjector
+export public class DIC {
+    @Inject a: B;
+}
+
+var dic = N4Injector.of(DIC).create(DIC);
+console.log(dic);              // --&gt; DIC
+console.log(dic.a);            // --&gt; B
+console.log(dic.a.xInA);       // --&gt; X
+console.log(dic.a.xInA.y);     // --&gt; Y
+console.log(dic.a.xInB);       // --&gt; X
+console.log(dic.a.xInB.y);     // --&gt; Y</programlisting>
+</para>
+</formalpara>
+</example>
+</section>
+<section xml:id="_constructor-injection">
+<title>Constructor Injection</title>
+<simpara>Parameters of the constructor can also be injected, in which case this is usually referred to as <emphasis>Constructor Inejction</emphasis>.
+This is similar to <emphasis>Method Injection</emphasis> and while constructor injection is supported in N4JS, method injection is not (see remarks below).</simpara>
+<simpara>When a constructor is annotated with <literal>@Inject</literal> annotation, all user-defined, non-generic types given as the parameters will be injected into the instance’s constructor created by the dependency injection framework.
+Currently, optional constructor parameters are always initialized and created by the framework, therefore, they are ensured to be available at the constructor invocation time.
+Unlike optional parameters, variadic parameters cannot be injected into a type’s constructor.
+In case of annotating a constructor with <literal>@Inject</literal> that has variadic parameters, a validation error will be reported.
+When a class’s constructor is annotated with <literal>@Inject</literal> annotation, it is highly recommended to annotate all explicitly-defined constructors at the subclass level.
+If this is not done, the injection chain can break and runtime errors might occur due to undefined constructor parameters.
+In the case of a possible broken injection chain due to missing <literal>@Inject</literal> annotations for any subclasses, a validation warning will
+be reported.</simpara>
+<requirement xml:id="IDE-143">
+<title>Constructor Injection</title>
+<simpara>
+<anchor xml:id="Req-IDE-143" xreflabel="[Req-IDE-143]"/>
+<emphasis role="strong">Requirement: IDE-143:</emphasis>
+<link linkend="Req-IDE-143">Constructor Injection</link> (ver. 1)</simpara>
+    <simpara>
+
+If a class <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>C</mi></math> has a constructor marked as injection point, the
+following applies:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>If <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>C</mi></math> is subclassed by <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>S</mi></math>, and if <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>S</mi></math> has no explicit constructor, then <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>S</mi></math> inherits the constructor from <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>C</mi></math> and it will be an injection point handled by the injector during injection phase.</simpara>
+</listitem>
+<listitem>
+<simpara>If <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>S</mi></math> provides its own injector, <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>C</mi><mo>.</mo><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi></math> is no longer recognized by the injector during the injection phase.
+There will be a warning generated in <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>S</mi><mo>.</mo><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi></math> to mark it as injection point as well in order to prevent inconsistent injection behavior.
+Still, <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>C</mi><mo>.</mo><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi></math> must be called in <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>S</mi><mo>.</mo><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi></math> similarly to other overridden constructors.</simpara>
+</listitem>
+</orderedlist>
+</requirement>
+</section>
+<section xml:id="_method-injection">
+<title>Method Injection</title>
+<simpara>Other kinds of injector points are method parameters where (usually) all method parameters are injected when the method is called.
+In a way, constructor injection is a special case of the method itself.</simpara>
+<section xml:id="_provider">
+<title>Provider</title>
+<simpara><emphasis>Provider</emphasis> is essentially a <emphasis>factory</emphasis> for a given type.
+By injecting an <literal>N4Provider</literal> into any injection point, one can acquire new instances of a given type provided by the injected provider.
+The providers prove useful when one has to solve re-injection issues since the depended type can be wired and injected via the provider rather than the dependency itself and can therefore obtain
+new instances from it if required.
+Provider can be also used as a means of delaying the instantiation time of a given type.</simpara>
+<simpara><literal>N4Provider</literal> is a public generic built-in interface that is used to support the re-injection.
+The generic type represents the dependent type that has to be obtained.
+The <literal>N4Provider</literal> interface has one single public method: <literal>public T get()</literal> which should be invoked from the client code when a new instance of the dependent type is required.
+Unlike any other unbound interfaces, the <literal>N4Provider</literal> can be injected without any explicit binding.</simpara>
+<simpara>The following snippet demonstrates the usage of <literal>N4Provider</literal>:</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">class SomeService { }
+
+@Singleton
+class SomeSingletonService { }
+
+class SomeClass {
+
+    @Inject serviceProvider: N4Provider&lt;SomeService&gt;;
+    @Inject singletonServiceProvider: N4Provider&lt;SomeSingletonService&gt;;
+
+    void foo() {
+        console.log(serviceProvider.get() ===
+            serviceProvider.get()); //false
+
+        console.log(singletonServiceProvider.get() ===
+            singletonServiceProvider.get()); //true
+    }
+
+}</programlisting>
+<simpara>It is important to note that the <literal>N4Provider</literal> interface can be extended by any user-defined interfaces and/or can be implemented by any user-defined classes.
+For those user-defined providers, consider all binding-related rules; the extended interface, for example, must be explicitly bound via a binder to be injected.
+The binding can be omitted only for the built-in <literal>N4Provider</literal>s.</simpara>
+</section>
+</section>
+</section>
+<section xml:id="_n4js-di-life-cycle-and-scopes">
+<title>N4JS DI Life Cycle and Scopes</title>
+<simpara><link linkend="_acronyms">DI</link> Life Cycle defines when a new instance is created by the injector as its destruction is handled by JavaScript.
+The creation depends on the scope of the type.
+Aside from the scopes, note that it is also possible to implement custom scopes and life cycle management via <literal>N4JSProvider</literal> and <literal>Binder@Provides</literal> methods.</simpara>
+<section xml:id="_injection-cylces">
+<title>Injection Cylces</title>
+<definition>
+<title>Injection Cycle</title>
+<simpara>
+<anchor xml:id="injection_cycle" xreflabel="[injection_cycle]"/>
+<emphasis role="strong">Definition:</emphasis>
+<link linkend="injection_cycle">Injection Cycle</link></simpara>
+<simpara>
+
+We define an injection graph <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>G</mi><mfenced close=")" open="("><mi>V</mi><mi>E</mi></mfenced></math> as a directed graph as follows: <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>V</mi></math> (the vertices) is the set types of which instances are created during the injection phase and which use .
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>E</mi></math> (the edges) is a set of directed and labeled edges <math xmlns="http://www.w3.org/1998/Math/MathML"><mfenced close=")" open="("><msub><mi>v</mi><mn>1</mn></msub><msub><mi>v</mi><mn>2</mn></msub><mrow><mi>l</mi><mi>a</mi><mi>b</mi><mi>e</mi><mi>l</mi></mrow></mfenced></math>, where label indicates the injection point:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mfenced close=")" open="("><msub><mi>T</mi><mi>o</mi></msub><msub><mi>T</mi><mi>f</mi></msub><mrow><mi>"</mi><mi>f</mi><mi>i</mi><mi>e</mi><mi>l</mi><mi>d</mi><mi>"</mi></mrow></mfenced></math>, if <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>T</mi><mi>f</mi></msub></math> is the actualy type of an an injected field of an instance of type <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>T</mi><mi>o</mi></msub></math></simpara>
+</listitem>
+<listitem>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mfenced close=")" open="("><msub><mi>T</mi><mi>c</mi></msub><msub><mi>T</mi><mi>p</mi></msub><mrow><mi>"</mi><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi><mi>"</mi></mrow></mfenced></math>, if <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>T</mi><mi>p</mi></msub></math> is the type of a parameter used in a constructor injection of type <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>T</mi><mi>c</mi></msub></math></simpara>
+</listitem>
+</orderedlist>
+<simpara>One cycle in this graph is an injection cycle.</simpara>
+</definition>
+<simpara>When injecting instances into an object, cycles have to be detected and handled independently from the scope.
+If this is not done, the following examples would result in an infinite loop causing the entire script to freeze until the engine reports an error:</simpara>
+<informaltable frame="none" rowsep="1" colsep="0">
+<tgroup cols="2">
+<colspec colname="col_1" colwidth="57.1428*"/>
+<colspec colname="col_2" colwidth="42.8572*"/>
+<tbody>
+<row>
+<entry align="left" valign="bottom"><programlisting language="n4js" linenumbering="unnumbered">class A { @Inject b: B; }
+class B { @Inject a: A; }</programlisting></entry>
+<entry align="center" valign="top"><figure xml:id="fig-field-cycle">
+<title>Field Cycle</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/11_extFeatures/fig/injectionGraph_cycleField.svg" width="40%" scalefit="1" align="center"/>
+</imageobject>
+<textobject><phrase>injectionGraph cycleField</phrase></textobject>
+</mediaobject>
+</figure></entry>
+</row>
+<row>
+<entry align="left" valign="bottom"><programlisting language="n4js" linenumbering="unnumbered">class C { @Inject constructor(d: D) {} }
+class D { @Inject c: C; }</programlisting></entry>
+<entry align="center" valign="top"><figure xml:id="fig-ctor-field">
+<title>Ctor Field Cycle</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/11_extFeatures/fig/injectionGraph_cycleCtorField.svg" width="40%" scalefit="1" align="center"/>
+</imageobject>
+<textobject><phrase>injectionGraph cycleCtorField</phrase></textobject>
+</mediaobject>
+</figure></entry>
+</row>
+<row>
+<entry align="left" valign="bottom"><programlisting language="n4js" linenumbering="unnumbered">class E { @Inject constructor(f: F) {} }
+class F { @Inject constructor(e: E) {} }</programlisting></entry>
+<entry align="center" valign="top"><figure xml:id="fig-ctor-cycle">
+<title>Ctor Cycle</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/11_extFeatures/fig/injectionGraph_cycleCtor.svg" width="40%" scalefit="1" align="center"/>
+</imageobject>
+<textobject><phrase>injectionGraph cycleCtor</phrase></textobject>
+</mediaobject>
+</figure></entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+<simpara>The injector needs to detect these cycles and resolve them.</simpara>
+<requirement xml:id="IDE-144">
+<title>Resolution of Injection Cycles</title>
+<simpara>
+<anchor xml:id="Req-IDE-144" xreflabel="[Req-IDE-144]"/>
+<emphasis role="strong">Requirement: IDE-144:</emphasis>
+<link linkend="Req-IDE-144">Resolution of Injection Cycles</link> (ver. 1)</simpara>
+    <simpara>
+
+A cycle <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>c</mi><mo>⊂</mo><mi>G</mi></math>, with <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>G</mi></math> being an injection graph, is resolved as follows:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>If <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>c</mi></math> contains no edge with <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>l</mi><mi>a</mi><mi>b</mi><mi>e</mi><mi>l</mi><mo>=</mo><mi>"</mi><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi><mi>"</mi></math>, the cycle is resolved using the algorithm described below.</simpara>
+</listitem>
+<listitem>
+<simpara>If <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>c</mi></math> contains at least one edge with <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>l</mi><mi>a</mi><mi>b</mi><mi>e</mi><mi>l</mi><mo>=</mo><mi>"</mi><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi><mi>"</mi></math>, a runtime exception is thrown.</simpara>
+</listitem>
+</orderedlist>
+</requirement>
+<simpara>Cycles stemming from field injection are resolved by halting the creation of new instances of types which have been already created by a containing instance.
+The previously-created instance is then reused.
+This makes injecting the instance of a (transitive) container less complicated and without the need to pass the container instance down the entire chain.
+The following pseudo code describes the algorithm to create new instances which are injected into a newly created object:</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">function injectDependencies(object) {
+    doInjectionWithCylceAwareness(object, {(typeof object -&gt; object)})
+}
+
+function doInjectionWithCylceAwareness(object, createdInstancesPerType) {
+    forall v $\in$ injectedVars of object {
+        var type = retrieveBoundType(v)
+        var instance = createdInstancesPerType.get(type)
+        if (not exists instance) {
+            instance = createInstance(type, createdInstancesPerType)
+            doInjectionWithCylceAwareness(instance,
+                createdInstancesPerType $\cap$ {(type-&gt;instance)})
+        }
+        v.value = instance;
+    }
+}</programlisting>
+<simpara>The actual instance is created in line 10 via <literal>createInstance</literal>.
+This function then takes scopes into account.
+The <literal>createdInstancesPerType</literal> map is passed to that function in order to enable cycle detection for constructor injection.
+The following scopes are supported by the N4JS DI, other scopes, cf. <link xl:href="https://jersey.java.net/documentation/latest/ioc.html">Jersey custom scopes</link> and <link xl:href="https://github.com/google/guice/wiki/CustomScopes">Guice custom scopes</link>, may be added in the future.</simpara>
+<simpara>This algorithm is not working for constructor injection because it is possible to already access all fields of the arguments passed to the constructor.
+In the algorithm, however, the instances may not be completely initialized.</simpara>
+</section>
+<section xml:id="_default-scope">
+<title>Default Scope</title>
+<simpara>The default scope always creates a new instance.</simpara>
+</section>
+<section xml:id="_singleton-scope">
+<title>Singleton Scope</title>
+<simpara>The singleton scope (per injector) creates one instance (of the type with <literal>@Singleton</literal> scope) per injector, which is then shared between clients.</simpara>
+<simpara>The injector will preserve a single instance of the type of <literal>S</literal> and will provide it to all injection points where type of <literal>S</literal> is used.
+Assuming nested injectors without any declared binding where the second parameter is <literal>S</literal>, the same preserved singleton instance will be available for all nested injectors at all injection points as well.</simpara>
+<simpara>The singleton preservation behavior changes when explicit bindings are declared for type <literal>S</literal> on the nested injector level.
+Let&#8217;s assume that the type <literal>S</literal> exists and the type is annotated with <literal>@Singleton</literal>.
+Furthermore, there is a declared binding where the binding&#8217;s second argument is <literal>S</literal>.
+In that case, unlike in other dependency injection frameworks, nested injectors may preserve a singleton for itself and all descendant injectors with <literal>@Bind</literal> annotation.
+In this case, the preserved singleton at the child injector level will be a different instance than the one at the parent injectors.</simpara>
+<simpara>The tables below depict the expected runtime behavior of singletons used at different injector levels.
+Assume the following are injectors: <literal>C</literal>, <literal>D</literal>, <literal>E</literal>, <literal>F</literal> and <literal>G</literal>. Injector <literal>C</literal> is the top most injector and its nesting injector <literal>D</literal>, hence injector <literal>C</literal> is the parent of the injector <literal>D</literal>.
+Injector <literal>D</literal> is nesting <literal>E</literal> and so on.
+The most nested injector is <literal>G</literal>. Let&#8217;s assume <literal>J</literal> is an interface, class <literal>U</literal> implements interface <literal>J</literal> and class <literal>V</literal> extends class <literal>U</literal>.
+Finally assume both <literal>U</literal> and <literal>V</literal> are annotated with <literal>@Singleton</literal> at definition-site.</simpara>
+<simpara><xref linkend="tab:diNoBindings"/> depicts the singleton preservation for nested injectors without any bindings.
+All injectors use the same instance from a type.
+Type <literal>J</literal> is not available at all since it is not bound to any concrete implementation:</simpara>
+<table xml:id="tab:diNoBindings" frame="all" rowsep="1" colsep="1">
+<title>DI No Bindings</title>
+<tgroup cols="6">
+<colspec colname="col_1" colwidth="28.5714*"/>
+<colspec colname="col_2" colwidth="14.2857*"/>
+<colspec colname="col_3" colwidth="14.2857*"/>
+<colspec colname="col_4" colwidth="14.2857*"/>
+<colspec colname="col_5" colwidth="14.2857*"/>
+<colspec colname="col_6" colwidth="14.2858*"/>
+<tbody>
+<row>
+<entry align="center" valign="top"><simpara><emphasis role="strong">Binding</emphasis></simpara></entry>
+<entry align="center" valign="top"></entry>
+<entry align="center" valign="top"></entry>
+<entry align="center" valign="top"></entry>
+<entry align="center" valign="top"></entry>
+<entry align="center" valign="top"></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><emphasis role="strong">Injector nesting (<math xmlns="http://www.w3.org/1998/Math/MathML"><mo>&gt;</mo></math>)</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara>C</simpara></entry>
+<entry align="center" valign="top"><simpara>D</simpara></entry>
+<entry align="center" valign="top"><simpara>E</simpara></entry>
+<entry align="center" valign="top"><simpara>F</simpara></entry>
+<entry align="center" valign="top"><simpara>G</simpara></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><emphasis role="strong">J</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>N</mi><mi>a</mi><mi>N</mi></math></simpara></entry>
+<entry align="center" valign="top"><simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>N</mi><mi>a</mi><mi>N</mi></math></simpara></entry>
+<entry align="center" valign="top"><simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>N</mi><mi>a</mi><mi>N</mi></math></simpara></entry>
+<entry align="center" valign="top"><simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>N</mi><mi>a</mi><mi>N</mi></math></simpara></entry>
+<entry align="center" valign="top"><simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>N</mi><mi>a</mi><mi>N</mi></math></simpara></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><emphasis role="strong">U</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>U</mi><mn>0</mn></msub></math></simpara></entry>
+<entry align="center" valign="top"><simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>U</mi><mn>0</mn></msub></math></simpara></entry>
+<entry align="center" valign="top"><simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>U</mi><mn>0</mn></msub></math></simpara></entry>
+<entry align="center" valign="top"><simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>U</mi><mn>0</mn></msub></math></simpara></entry>
+<entry align="center" valign="top"><simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>U</mi><mn>0</mn></msub></math></simpara></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><emphasis role="strong">V</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>V</mi><mn>0</mn></msub></math></simpara></entry>
+<entry align="center" valign="top"><simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>V</mi><mn>0</mn></msub></math></simpara></entry>
+<entry align="center" valign="top"><simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>V</mi><mn>0</mn></msub></math></simpara></entry>
+<entry align="center" valign="top"><simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>V</mi><mn>0</mn></msub></math></simpara></entry>
+<entry align="center" valign="top"><simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>V</mi><mn>0</mn></msub></math></simpara></entry>
+</row>
+</tbody>
+</tgroup>
+</table>
+<simpara><xref linkend="tab:diTransitiveBindings"/> is configured by explicit bindings. At the root injector level, type <literal>J</literal> is bound to type <literal>U</literal>.
+Since the second argument of the binding is declared as a singleton at the definition-site,
+this explicit binding implicitly ensures that the injector and all of its descendants preserve a singleton of the bound type <literal>U</literal>.
+At injector level <literal>C</literal>, <literal>D</literal> and <literal>E</literal>, the same instance is used for type <literal>J</literal> which is type <literal>U</literal> at runtime.
+At injector level <literal>E</literal> there is an additional binding from type <literal>U</literal> to type <literal>V</literal> that overrules the binding declared at the root injector level.
+With this binding, each places where <literal>J</literal> is declared, type <literal>U</literal> is used at runtime.</simpara>
+<simpara>Furthermore, since <literal>V</literal> is declared as a singleton, both injector <literal>F</literal> and <literal>G</literal> are using a shared singleton instance of type <literal>V</literal>.
+Finally, for type <literal>V</literal>, injector <literal>C</literal>, <literal>D</literal> and <literal>E</literal> should use a separate instance of <literal>V</literal> other than injector level <literal>F</literal> and <literal>G</literal> because <literal>V</literal> is preserved at injector level <literal>F</literal> with the <literal>U</literal> <math xmlns="http://www.w3.org/1998/Math/MathML"><mo>→</mo></math> <literal>V</literal> binding.</simpara>
+<table xml:id="tab:diTransitiveBindings" frame="all" rowsep="1" colsep="1">
+<title>DI Transitive Bindings</title>
+<tgroup cols="6">
+<colspec colname="col_1" colwidth="28.5714*"/>
+<colspec colname="col_2" colwidth="14.2857*"/>
+<colspec colname="col_3" colwidth="14.2857*"/>
+<colspec colname="col_4" colwidth="14.2857*"/>
+<colspec colname="col_5" colwidth="14.2857*"/>
+<colspec colname="col_6" colwidth="14.2858*"/>
+<thead>
+<row>
+<entry align="center" valign="top">Binding</entry>
+<entry align="center" valign="top">J &#8594; U</entry>
+<entry align="center" valign="top"></entry>
+<entry align="center" valign="top"></entry>
+<entry align="center" valign="top">U &#8594; V</entry>
+<entry align="center" valign="top"></entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry align="center" valign="top"><simpara><emphasis role="strong">Injector nesting (&gt;)</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara>C</simpara></entry>
+<entry align="center" valign="top"><simpara>D</simpara></entry>
+<entry align="center" valign="top"><simpara>E</simpara></entry>
+<entry align="center" valign="top"><simpara>F</simpara></entry>
+<entry align="center" valign="top"><simpara>G</simpara></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><emphasis role="strong">J</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>U</mi><mn>0</mn></msub></math></simpara></entry>
+<entry align="center" valign="top"><simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>U</mi><mn>0</mn></msub></math></simpara></entry>
+<entry align="center" valign="top"><simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>U</mi><mn>0</mn></msub></math></simpara></entry>
+<entry align="center" valign="top"><simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>V</mi><mn>0</mn></msub></math></simpara></entry>
+<entry align="center" valign="top"><simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>V</mi><mn>0</mn></msub></math></simpara></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><emphasis role="strong">U</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>U</mi><mn>0</mn></msub></math></simpara></entry>
+<entry align="center" valign="top"><simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>U</mi><mn>0</mn></msub></math></simpara></entry>
+<entry align="center" valign="top"><simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>U</mi><mn>0</mn></msub></math></simpara></entry>
+<entry align="center" valign="top"><simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>V</mi><mn>0</mn></msub></math></simpara></entry>
+<entry align="center" valign="top"><simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>V</mi><mn>0</mn></msub></math></simpara></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><emphasis role="strong">V</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>V</mi><mn>1</mn></msub></math></simpara></entry>
+<entry align="center" valign="top"><simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>V</mi><mn>1</mn></msub></math></simpara></entry>
+<entry align="center" valign="top"><simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>V</mi><mn>1</mn></msub></math></simpara></entry>
+<entry align="center" valign="top"><simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>V</mi><mn>0</mn></msub></math></simpara></entry>
+<entry align="center" valign="top"><simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>V</mi><mn>0</mn></msub></math></simpara></entry>
+</row>
+</tbody>
+</tgroup>
+</table>
+<simpara><xref linkend="tab:diReBinding"/> depicts the singleton behaviour but unlike the above
+table, the bindings are declared for the interface <literal>J</literal>.</simpara>
+<table xml:id="tab:diReBinding" frame="all" rowsep="1" colsep="1">
+<title>DI Re - Binding</title>
+<tgroup cols="6">
+<colspec colname="col_1" colwidth="28.5714*"/>
+<colspec colname="col_2" colwidth="14.2857*"/>
+<colspec colname="col_3" colwidth="14.2857*"/>
+<colspec colname="col_4" colwidth="14.2857*"/>
+<colspec colname="col_5" colwidth="14.2857*"/>
+<colspec colname="col_6" colwidth="14.2858*"/>
+<thead>
+<row>
+<entry align="center" valign="top">Binding</entry>
+<entry align="center" valign="top">J &#8594; U</entry>
+<entry align="center" valign="top"></entry>
+<entry align="center" valign="top"></entry>
+<entry align="center" valign="top">J &#8594; V</entry>
+<entry align="center" valign="top"></entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry align="center" valign="top"><simpara><emphasis role="strong">Injector nesting (<math xmlns="http://www.w3.org/1998/Math/MathML"><mo>&gt;</mo></math>)</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara>C</simpara></entry>
+<entry align="center" valign="top"><simpara>D</simpara></entry>
+<entry align="center" valign="top"><simpara>E</simpara></entry>
+<entry align="center" valign="top"><simpara>F</simpara></entry>
+<entry align="center" valign="top"><simpara>G</simpara></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><emphasis role="strong">J</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>U</mi><mn>0</mn></msub></math></simpara></entry>
+<entry align="center" valign="top"><simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>U</mi><mn>0</mn></msub></math></simpara></entry>
+<entry align="center" valign="top"><simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>U</mi><mn>0</mn></msub></math></simpara></entry>
+<entry align="center" valign="top"><simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>V</mi><mn>0</mn></msub></math></simpara></entry>
+<entry align="center" valign="top"><simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>V</mi><mn>0</mn></msub></math></simpara></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><emphasis role="strong">U</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>U</mi><mn>0</mn></msub></math></simpara></entry>
+<entry align="center" valign="top"><simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>U</mi><mn>0</mn></msub></math></simpara></entry>
+<entry align="center" valign="top"><simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>U</mi><mn>0</mn></msub></math></simpara></entry>
+<entry align="center" valign="top"><simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>U</mi><mn>0</mn></msub></math></simpara></entry>
+<entry align="center" valign="top"><simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>U</mi><mn>0</mn></msub></math></simpara></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><emphasis role="strong">V</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>V</mi><mn>1</mn></msub></math></simpara></entry>
+<entry align="center" valign="top"><simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>V</mi><mn>1</mn></msub></math></simpara></entry>
+<entry align="center" valign="top"><simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>V</mi><mn>1</mn></msub></math></simpara></entry>
+<entry align="center" valign="top"><simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>V</mi><mn>0</mn></msub></math></simpara></entry>
+<entry align="center" valign="top"><simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>V</mi><mn>0</mn></msub></math></simpara></entry>
+</row>
+</tbody>
+</tgroup>
+</table>
+<simpara><xref linkend="tab:diChildBinding"/> describes the singleton behavior when both bindings are configured at child injector levels but not the root injector level.</simpara>
+<table xml:id="tab:diChildBinding" frame="all" rowsep="1" colsep="1">
+<title>DI Child Binding</title>
+<tgroup cols="6">
+<colspec colname="col_1" colwidth="28.5714*"/>
+<colspec colname="col_2" colwidth="14.2857*"/>
+<colspec colname="col_3" colwidth="14.2857*"/>
+<colspec colname="col_4" colwidth="14.2857*"/>
+<colspec colname="col_5" colwidth="14.2857*"/>
+<colspec colname="col_6" colwidth="14.2858*"/>
+<thead>
+<row>
+<entry align="center" valign="top">Binding</entry>
+<entry align="center" valign="top"></entry>
+<entry align="center" valign="top">U <math xmlns="http://www.w3.org/1998/Math/MathML"><mo>→</mo></math> V</entry>
+<entry align="center" valign="top"></entry>
+<entry align="center" valign="top">J <math xmlns="http://www.w3.org/1998/Math/MathML"><mo>→</mo></math> U</entry>
+<entry align="center" valign="top"></entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry align="center" valign="top"><simpara><emphasis role="strong">Injector nesting (<math xmlns="http://www.w3.org/1998/Math/MathML"><mo>&gt;</mo></math>)</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara>C</simpara></entry>
+<entry align="center" valign="top"><simpara>D</simpara></entry>
+<entry align="center" valign="top"><simpara>E</simpara></entry>
+<entry align="center" valign="top"><simpara>F</simpara></entry>
+<entry align="center" valign="top"><simpara>G</simpara></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><emphasis role="strong">J</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>N</mi><mi>a</mi><mi>N</mi></math></simpara></entry>
+<entry align="center" valign="top"><simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>N</mi><mi>a</mi><mi>N</mi></math></simpara></entry>
+<entry align="center" valign="top"><simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>N</mi><mi>a</mi><mi>N</mi></math></simpara></entry>
+<entry align="center" valign="top"><simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>U</mi><mn>0</mn></msub></math></simpara></entry>
+<entry align="center" valign="top"><simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>U</mi><mn>0</mn></msub></math></simpara></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><emphasis role="strong">U</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>U</mi><mn>1</mn></msub></math></simpara></entry>
+<entry align="center" valign="top"><simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>V</mi><mn>0</mn></msub></math></simpara></entry>
+<entry align="center" valign="top"><simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>V</mi><mn>0</mn></msub></math></simpara></entry>
+<entry align="center" valign="top"><simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>U</mi><mn>0</mn></msub></math></simpara></entry>
+<entry align="center" valign="top"><simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>U</mi><mn>0</mn></msub></math></simpara></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><emphasis role="strong">V</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>V</mi><mn>1</mn></msub></math></simpara></entry>
+<entry align="center" valign="top"><simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>V</mi><mn>0</mn></msub></math></simpara></entry>
+<entry align="center" valign="top"><simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>V</mi><mn>0</mn></msub></math></simpara></entry>
+<entry align="center" valign="top"><simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>V</mi><mn>0</mn></msub></math></simpara></entry>
+<entry align="center" valign="top"><simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>V</mi><mn>0</mn></msub></math></simpara></entry>
+</row>
+</tbody>
+</tgroup>
+</table>
+</section>
+<section xml:id="_per-injection-chain-singleton">
+<title>Per Injection Chain Singleton</title>
+<simpara>The per injection chain singleton is ’between’ the default and singleton scope.
+It can be used in order to explicitly describe the situation which happens when a simple cycle is resolved automatically.
+It has more effects that lead to a more deterministic behavior.</simpara>
+<simpara>Assume a provider declared as</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">var pb: Provider&lt;B&gt;;</programlisting>
+<simpara>to be available:</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">@PerInjectionSingleton
+class A {  }
+
+class B { @Inject a: A; @Inject a1: A;}
+
+b1=pb.get();
+b2=pb.get();
+b1.a != b2.a
+b1.a == b1.a1
+b2.a == b2.a1</programlisting>
+<programlisting language="n4js" linenumbering="unnumbered">@Singleton
+class A {  }
+
+class B { @Inject a: A; @Inject a1: A;}
+
+b1=pb.get();
+b2=pb.get();
+b1.a == b2.a
+b1.a == b1.a1
+b2.a == b2.a1</programlisting>
+<programlisting language="n4js" linenumbering="unnumbered">// no annotation
+class A {  }
+
+class B { @Inject a A; @Inject a1: A;}
+
+b1=pb.get();
+b2=pb.get();
+b1.a != b2.a
+b1.a != b1.a1
+b2.a != b2.a1</programlisting>
+</section>
+</section>
+<section xml:id="_validation-of-callsites-targeting-n4injector-methods">
+<title>Validation of callsites targeting N4Injector methods</title>
+<simpara>Terminology for this section:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>a value is <emphasis role="strong">injectable</emphasis> if it</simpara>
+<itemizedlist>
+<listitem>
+<simpara>either conforms to a user-defined class or interface (a non-parameterized one, that is),</simpara>
+</listitem>
+<listitem>
+<simpara>or conforms to Provider-of-T where T is injectable itself.</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+<listitem>
+<simpara>a classifier declaring injected members is said to <emphasis role="strong">require injection</emphasis></simpara>
+</listitem>
+</itemizedlist>
+<simpara>To better understand the validations in effect for callsites targeting</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">N4Injector.of(ctorOfDIC: constructor{N4Object}, parentDIC: N4Injector?, ...providedBinders: N4Object)</programlisting>
+<simpara>we can recap that at runtime:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>The first argument denotes a DIC constructor.</simpara>
+</listitem>
+<listitem>
+<simpara>The second (optional) argument is an injector.</simpara>
+</listitem>
+<listitem>
+<simpara>Lastly, the purpose of <literal>providedBinders</literal> is as follows:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>The DIC above is marked with one or more <literal>@UseBinder</literal>.</simpara>
+</listitem>
+<listitem>
+<simpara>Some of those binders may require injection.</simpara>
+</listitem>
+<listitem>
+<simpara>Some of those binders may have constructor(s) taking parameters.</simpara>
+</listitem>
+<listitem>
+<simpara>The set of binders described above should match the providedBinders.</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+</itemizedlist>
+<simpara>Validations in effect for <literal>N4Injector.create(type{T} ctor)</literal> callsites:</simpara>
+<itemizedlist>
+<listitem>
+<simpara><literal>type{T}</literal> should be injectable (in particular, it may be an <literal>N4Provider</literal>).</simpara>
+</listitem>
+</itemizedlist>
+</section>
+<section xml:id="_n4js-di-annotations">
+<title>N4JS DI Annotations</title>
+<simpara>Following annotations describe API used to configure N4JSDI.</simpara>
+<section xml:id="_n4js-di-generateinjector">
+<title>N4JS DI @GenerateInjector</title>
+<informaltable frame="none" rowsep="0" colsep="0">
+<tgroup cols="3">
+<colspec colname="col_1" colwidth="33.3333*"/>
+<colspec colname="col_2" colwidth="33.3333*"/>
+<colspec colname="col_3" colwidth="33.3334*"/>
+<tbody>
+<row>
+<entry align="left" valign="top"><variablelist>
+<varlistentry>
+<term>name</term>
+<listitem>
+<simpara>@GenerateInjector</simpara>
+</listitem>
+</varlistentry>
+</variablelist></entry>
+<entry align="left" valign="top"><variablelist>
+<varlistentry>
+<term>targets</term>
+<listitem>
+<simpara>N4Class</simpara>
+</listitem>
+</varlistentry>
+</variablelist></entry>
+<entry align="left" valign="top"><variablelist>
+<varlistentry>
+<term>retention policy</term>
+<listitem>
+<simpara>RUNTIME</simpara>
+</listitem>
+</varlistentry>
+</variablelist></entry>
+</row>
+<row>
+<entry align="left" valign="top"><variablelist>
+<varlistentry>
+<term>transitive</term>
+<listitem>
+<simpara>NO</simpara>
+</listitem>
+</varlistentry>
+</variablelist></entry>
+<entry align="left" valign="top"><variablelist>
+<varlistentry>
+<term>repeatable</term>
+<listitem>
+<simpara>NO</simpara>
+</listitem>
+</varlistentry>
+</variablelist></entry>
+<entry align="left" valign="top"><variablelist>
+<varlistentry>
+<term>arguments</term>
+<listitem>
+<simpara>NO</simpara>
+</listitem>
+</varlistentry>
+</variablelist></entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+<simpara><literal>@GenerateInjector</literal> marks a given class as DIComponent of the graph.
+The generated injector will be responsible for creating an instance of that class and all of its dependencies.</simpara>
+</section>
+<section xml:id="_n4js-di-withparentinjector">
+<title>N4JS DI @WithParentInjector</title>
+<informaltable frame="none" rowsep="0" colsep="0">
+<tgroup cols="3">
+<colspec colname="col_1" colwidth="33.3333*"/>
+<colspec colname="col_2" colwidth="33.3333*"/>
+<colspec colname="col_3" colwidth="33.3334*"/>
+<tbody>
+<row>
+<entry align="left" valign="top"><variablelist>
+<varlistentry>
+<term>name</term>
+<listitem>
+<simpara>@WithParentInjector</simpara>
+</listitem>
+</varlistentry>
+</variablelist></entry>
+<entry align="left" valign="top"><variablelist>
+<varlistentry>
+<term>targets</term>
+<listitem>
+<simpara>N4Class</simpara>
+</listitem>
+</varlistentry>
+</variablelist></entry>
+<entry align="left" valign="top"><variablelist>
+<varlistentry>
+<term>retention policy</term>
+<listitem>
+<simpara>RUNTIME</simpara>
+</listitem>
+</varlistentry>
+</variablelist></entry>
+</row>
+<row>
+<entry align="left" valign="top"><variablelist>
+<varlistentry>
+<term>transitive</term>
+<listitem>
+<simpara>NO</simpara>
+</listitem>
+</varlistentry>
+</variablelist></entry>
+<entry align="left" valign="top"><variablelist>
+<varlistentry>
+<term>repeatable</term>
+<listitem>
+<simpara>NO</simpara>
+</listitem>
+</varlistentry>
+</variablelist></entry>
+<entry align="left" valign="top"><variablelist>
+<varlistentry>
+<term>arguments</term>
+<listitem>
+<simpara>TypeRef</simpara>
+</listitem>
+</varlistentry>
+</variablelist></entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+<simpara><literal>@WithParentInjector</literal> marks given <emphasis>injector</emphasis> as depended on other <emphasis>injector</emphasis>.
+The depended <emphasis>injector</emphasis> may use provided <emphasis>injector</emphasis> to create instances of objects required in its object graph.</simpara>
+<simpara>Additional <emphasis>WithParentInjector</emphasis> constraints:</simpara>
+<requirement xml:id="IDE-145">
+<title>DI WithParentInjector</title>
+<simpara>
+<anchor xml:id="Req-IDE-145" xreflabel="[Req-IDE-145]"/>
+<emphasis role="strong">Requirement: IDE-145:</emphasis>
+<link linkend="Req-IDE-145">DI WithParentInjector</link> (ver. 1)</simpara>
+    <simpara>
+
+1.  Allowed only on <literal>N4ClassDeclarations</literal> annotated with <literal>@GenerateInjector</literal>.
+2.  Its parameter can only be <literal>N4ClassDeclarations</literal> annotated with .</simpara>
+</requirement>
+</section>
+<section xml:id="_n4js-di-usebinder">
+<title>N4JS DI @UseBinder</title>
+<informaltable frame="none" rowsep="0" colsep="0">
+<tgroup cols="3">
+<colspec colname="col_1" colwidth="33.3333*"/>
+<colspec colname="col_2" colwidth="33.3333*"/>
+<colspec colname="col_3" colwidth="33.3334*"/>
+<tbody>
+<row>
+<entry align="left" valign="top"><variablelist>
+<varlistentry>
+<term>name</term>
+<listitem>
+<simpara>@UseBinder</simpara>
+</listitem>
+</varlistentry>
+</variablelist></entry>
+<entry align="left" valign="top"><variablelist>
+<varlistentry>
+<term>targets</term>
+<listitem>
+<simpara>N4Class</simpara>
+</listitem>
+</varlistentry>
+</variablelist></entry>
+<entry align="left" valign="top"><variablelist>
+<varlistentry>
+<term>retention policy</term>
+<listitem>
+<simpara>RUNTIME</simpara>
+</listitem>
+</varlistentry>
+</variablelist></entry>
+</row>
+<row>
+<entry align="left" valign="top"><variablelist>
+<varlistentry>
+<term>transitive</term>
+<listitem>
+<simpara>NO</simpara>
+</listitem>
+</varlistentry>
+</variablelist></entry>
+<entry align="left" valign="top"><variablelist>
+<varlistentry>
+<term>arguments</term>
+<listitem>
+<simpara>TypeRef</simpara>
+</listitem>
+</varlistentry>
+</variablelist></entry>
+<entry align="left" valign="top"><variablelist>
+<varlistentry>
+<term>arguments are optional</term>
+<listitem>
+<simpara>NO</simpara>
+</listitem>
+</varlistentry>
+</variablelist></entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+<simpara><literal>@UseBinder</literal> describes <emphasis>Binder</emphasis> to be used (configure) target <emphasis>Injector</emphasis>.</simpara>
+<requirement xml:id="IDE-146">
+<title>DI UseInjector</title>
+<simpara>
+<anchor xml:id="Req-IDE-146" xreflabel="[Req-IDE-146]"/>
+<emphasis role="strong">Requirement: IDE-146:</emphasis>
+<link linkend="Req-IDE-146">DI UseInjector</link> (ver. 1)</simpara>
+    <simpara>
+
+1.  Allowed only on <literal>N4ClassDeclarations</literal> annotated with <literal>@GenerateInjector</literal>.
+2.  Its parameter can only be <literal>N4ClassDeclarations</literal> annotated with <literal>@Binder</literal>.</simpara>
+</requirement>
+</section>
+<section xml:id="_n4js-di-binder">
+<title>N4JS DI @Binder</title>
+<informaltable frame="none" rowsep="0" colsep="0">
+<tgroup cols="3">
+<colspec colname="col_1" colwidth="33.3333*"/>
+<colspec colname="col_2" colwidth="33.3333*"/>
+<colspec colname="col_3" colwidth="33.3334*"/>
+<tbody>
+<row>
+<entry align="left" valign="top"><variablelist>
+<varlistentry>
+<term>name</term>
+<listitem>
+<simpara>@Binder</simpara>
+</listitem>
+</varlistentry>
+</variablelist></entry>
+<entry align="left" valign="top"><variablelist>
+<varlistentry>
+<term>targets</term>
+<listitem>
+<simpara>N4Class</simpara>
+</listitem>
+</varlistentry>
+</variablelist></entry>
+<entry align="left" valign="top"><variablelist>
+<varlistentry>
+<term>retention policy</term>
+<listitem>
+<simpara>RUNTIME</simpara>
+</listitem>
+</varlistentry>
+</variablelist></entry>
+</row>
+<row>
+<entry align="left" valign="top"><variablelist>
+<varlistentry>
+<term>transitive</term>
+<listitem>
+<simpara>NO</simpara>
+</listitem>
+</varlistentry>
+</variablelist></entry>
+<entry align="left" valign="top"><variablelist>
+<varlistentry>
+<term>repeatable</term>
+<listitem>
+<simpara>NO</simpara>
+</listitem>
+</varlistentry>
+</variablelist></entry>
+<entry align="left" valign="top"><variablelist>
+<varlistentry>
+<term>arguments</term>
+<listitem>
+<simpara>NONE</simpara>
+</listitem>
+</varlistentry>
+</variablelist></entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+<simpara><literal>@Binder</literal> defines a list of bind configurations.
+That can be either <literal>@Bind</literal> annotations on <literal>@Binder</literal> itself or its factory methods annotated with <literal>@Provides</literal>.</simpara>
+<requirement xml:id="IDE-147">
+<title>DI binder</title>
+<simpara>
+<anchor xml:id="Req-IDE-147" xreflabel="[Req-IDE-147]"/>
+<emphasis role="strong">Requirement: IDE-147:</emphasis>
+<link linkend="Req-IDE-147">DI binder</link> (ver. 1)</simpara>
+    <simpara>
+
+1.  Target <literal>N4ClassDeclaration</literal> must not be <emphasis>abstract</emphasis>.
+2.  Target <literal>N4ClassDeclaration</literal>  must not be annotated with <literal>@GenerateInjector</literal>.
+3.  Target class cannot have <emphasis>injection points</emphasis>.</simpara>
+</requirement>
+</section>
+<section xml:id="_n4js-di-bind">
+<title>N4JS DI @Bind</title>
+<informaltable frame="none" rowsep="0" colsep="0">
+<tgroup cols="3">
+<colspec colname="col_1" colwidth="33.3333*"/>
+<colspec colname="col_2" colwidth="33.3333*"/>
+<colspec colname="col_3" colwidth="33.3334*"/>
+<tbody>
+<row>
+<entry align="left" valign="top"><variablelist>
+<varlistentry>
+<term>name</term>
+<listitem>
+<simpara>@Bind</simpara>
+</listitem>
+</varlistentry>
+</variablelist></entry>
+<entry align="left" valign="top"><variablelist>
+<varlistentry>
+<term>targets</term>
+<listitem>
+<simpara>N4ClassDeclaration</simpara>
+</listitem>
+</varlistentry>
+</variablelist></entry>
+<entry align="left" valign="top"><variablelist>
+<varlistentry>
+<term>retention policy</term>
+<listitem>
+<simpara>RUNTIME</simpara>
+</listitem>
+</varlistentry>
+</variablelist></entry>
+</row>
+<row>
+<entry align="left" valign="top"><variablelist>
+<varlistentry>
+<term>transitive</term>
+<listitem>
+<simpara>NO</simpara>
+</listitem>
+</varlistentry>
+</variablelist></entry>
+<entry align="left" valign="top"><variablelist>
+<varlistentry>
+<term>arguments</term>
+<listitem>
+<simpara>TypeRef key, TypeRef target</simpara>
+</listitem>
+</varlistentry>
+</variablelist></entry>
+<entry align="left" valign="top"><variablelist>
+<varlistentry>
+<term>arguments are optional</term>
+<listitem>
+<simpara>NO</simpara>
+</listitem>
+</varlistentry>
+</variablelist></entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+<simpara>Defines <emphasis>binding</emphasis> between type and subtype that will be used by injector when configured with target <xref linkend="_n4js-di-binder"/>.
+See also <xref linkend="_validation-of-callsites-targeting-n4injector-methods"/> for description of injectable types.</simpara>
+<requirement xml:id="IDE-148">
+<title>DI Bind</title>
+<simpara>
+<anchor xml:id="Req-IDE-148" xreflabel="[Req-IDE-148]"/>
+<emphasis role="strong">Requirement: IDE-148:</emphasis>
+<link linkend="Req-IDE-148">DI Bind</link> (ver. 1)</simpara>
+    <simpara>
+
+1.  Allowed only on <literal>N4ClassDeclarations</literal> that are annotated with <literal>@Binder</literal>(<xref linkend="_n4js-di-binder"/>).
+2.  Parameters are instances of one of the values described in <xref linkend="_validation-of-callsites-targeting-n4injector-methods"/>.
+3.  The second parameter must be a subtype of the first one.</simpara>
+</requirement>
+</section>
+<section xml:id="_n4js-di-provides">
+<title>N4JS DI @Provides</title>
+<informaltable frame="none" rowsep="0" colsep="0">
+<tgroup cols="3">
+<colspec colname="col_1" colwidth="33.3333*"/>
+<colspec colname="col_2" colwidth="33.3333*"/>
+<colspec colname="col_3" colwidth="33.3334*"/>
+<tbody>
+<row>
+<entry align="left" valign="top"><variablelist>
+<varlistentry>
+<term>name</term>
+<listitem>
+<simpara>@Provides</simpara>
+</listitem>
+</varlistentry>
+</variablelist></entry>
+<entry align="left" valign="top"><variablelist>
+<varlistentry>
+<term>targets</term>
+<listitem>
+<simpara>N4MethodDeclaration</simpara>
+</listitem>
+</varlistentry>
+</variablelist></entry>
+<entry align="left" valign="top"><variablelist>
+<varlistentry>
+<term>retention policy</term>
+<listitem>
+<simpara>RUNTIME</simpara>
+</listitem>
+</varlistentry>
+</variablelist></entry>
+</row>
+<row>
+<entry align="left" valign="top"><variablelist>
+<varlistentry>
+<term>transitive</term>
+<listitem>
+<simpara>NO</simpara>
+</listitem>
+</varlistentry>
+</variablelist></entry>
+<entry align="left" valign="top"><variablelist>
+<varlistentry>
+<term>repeatable</term>
+<listitem>
+<simpara>NO</simpara>
+</listitem>
+</varlistentry>
+</variablelist></entry>
+<entry align="left" valign="top"><variablelist>
+<varlistentry>
+<term>arguments</term>
+<listitem>
+<simpara>NONE</simpara>
+</listitem>
+</varlistentry>
+</variablelist></entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+<simpara><literal>@Provides</literal> marks <emphasis>factory method</emphasis> to be used as part <link linkend="AC">DI</link>.
+This is treated as <emphasis>explicit binding</emphasis> between declared return type and actual return type.
+This method is expected to be part of the <literal>@Binder</literal>.
+Can be used to implement custom scopes.</simpara>
+<requirement xml:id="IDE-149">
+<title>DI Provides</title>
+<simpara>
+<anchor xml:id="Req-IDE-149" xreflabel="[Req-IDE-149]"/>
+<emphasis role="strong">Requirement: IDE-149:</emphasis>
+<link linkend="Req-IDE-149">DI Provides</link> (ver. 1)</simpara>
+    <simpara>
+</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>Allowed only on <literal>N4MethodDeclarations</literal> that are part of a classifier annotated with <literal>@Binder</literal>.</simpara>
+</listitem>
+<listitem>
+<simpara>Annotated method declared type returns instance of one of the types described in <emphasis>injectable values</emphasis>  <xref linkend="_validation-of-callsites-targeting-n4injector-methods"/>.</simpara>
+</listitem>
+</orderedlist>
+</requirement>
+</section>
+<section xml:id="_n4js-di-inject">
+<title>N4JS DI @Inject</title>
+<informaltable frame="none" rowsep="0" colsep="0">
+<tgroup cols="3">
+<colspec colname="col_1" colwidth="33.3333*"/>
+<colspec colname="col_2" colwidth="33.3333*"/>
+<colspec colname="col_3" colwidth="33.3334*"/>
+<tbody>
+<row>
+<entry align="left" valign="top"><variablelist>
+<varlistentry>
+<term>name</term>
+<listitem>
+<simpara>@Inject</simpara>
+</listitem>
+</varlistentry>
+</variablelist></entry>
+<entry align="left" valign="top"><variablelist>
+<varlistentry>
+<term>targets</term>
+<listitem>
+<simpara>N4Field, N4Method, constructor</simpara>
+</listitem>
+</varlistentry>
+</variablelist></entry>
+<entry align="left" valign="top"><variablelist>
+<varlistentry>
+<term>retention policy</term>
+<listitem>
+<simpara>RUNTIME</simpara>
+</listitem>
+</varlistentry>
+</variablelist></entry>
+</row>
+<row>
+<entry align="left" valign="top"><variablelist>
+<varlistentry>
+<term>transitive</term>
+<listitem>
+<simpara>NO</simpara>
+</listitem>
+</varlistentry>
+</variablelist></entry>
+<entry align="left" valign="top"><variablelist>
+<varlistentry>
+<term>repeatable</term>
+<listitem>
+<simpara>NO</simpara>
+</listitem>
+</varlistentry>
+</variablelist></entry>
+<entry align="left" valign="top"><variablelist>
+<varlistentry>
+<term>arguments</term>
+<listitem>
+<simpara>NO</simpara>
+</listitem>
+</varlistentry>
+</variablelist></entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+<simpara><literal>@Inject</literal> defines the injection point into which an instance object will be injected.
+The specific instance depends on the injector configuration (bindings) used.
+Class fields, methods and constructors can be annotated. See <xref linkend="_injection-points"/> for more information.</simpara>
+<requirement xml:id="IDE-150">
+<title>DI Inject</title>
+<simpara>
+<anchor xml:id="Req-IDE-150" xreflabel="[Req-IDE-150]"/>
+<emphasis role="strong">Requirement: IDE-150:</emphasis>
+<link linkend="Req-IDE-150">DI Inject</link> (ver. 1)</simpara>
+    <simpara>
+
+1.  Injection point bindings need to be resolvable.
+2.  Binding for given type must not be duplicated.
+3.  Annotated types must be instances of one of the types described in <xref linkend="_validation-of-callsites-targeting-n4injector-methods"/>.</simpara>
+</requirement>
+</section>
+<section xml:id="_n4js-di-singleton">
+<title>N4JS DI @Singleton</title>
+<informaltable frame="none" rowsep="0" colsep="0">
+<tgroup cols="3">
+<colspec colname="col_1" colwidth="33.3333*"/>
+<colspec colname="col_2" colwidth="33.3333*"/>
+<colspec colname="col_3" colwidth="33.3334*"/>
+<tbody>
+<row>
+<entry align="left" valign="top"><variablelist>
+<varlistentry>
+<term>name</term>
+<listitem>
+<simpara>@Singleton</simpara>
+</listitem>
+</varlistentry>
+</variablelist></entry>
+<entry align="left" valign="top"><variablelist>
+<varlistentry>
+<term>targets</term>
+<listitem>
+<simpara>N4Class</simpara>
+</listitem>
+</varlistentry>
+</variablelist></entry>
+<entry align="left" valign="top"><variablelist>
+<varlistentry>
+<term>retention policy</term>
+<listitem>
+<simpara>RUNTIME</simpara>
+</listitem>
+</varlistentry>
+</variablelist></entry>
+</row>
+<row>
+<entry align="left" valign="top"><variablelist>
+<varlistentry>
+<term>transitive</term>
+<listitem>
+<simpara>NO</simpara>
+</listitem>
+</varlistentry>
+</variablelist></entry>
+<entry align="left" valign="top"><variablelist>
+<varlistentry>
+<term>repeatable</term>
+<listitem>
+<simpara>NO</simpara>
+</listitem>
+</varlistentry>
+</variablelist></entry>
+<entry align="left" valign="top"><variablelist>
+<varlistentry>
+<term>arguments</term>
+<listitem>
+<simpara>NO</simpara>
+</listitem>
+</varlistentry>
+</variablelist></entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+<simpara>In the case of annotating a class <literal>S</literal> with <literal>@Singleton</literal> on the definition-site, the singleton scope will be used as described in <xref linkend="_singleton-scope"/>.</simpara>
+</section>
+</section>
+</section>
+<section xml:id="_test-support" role="language-n4js">
+<title>Test Support</title>
+<simpara>N4JS provides some annotations for testing. Most of these annotations are similar to annotations found in JUnit 4.
+For details see our Mangelhaft test framework (stdlib specification) and the N4JS-IDE specification.</simpara>
+<simpara>In order to enable tests for private methods, test projects may define which project they are testing.</simpara>
+<requirement xml:id="IDE-151">
+<title>Test API methods and types</title>
+<simpara>
+<anchor xml:id="Req-IDE-151" xreflabel="[Req-IDE-151]"/>
+<emphasis role="strong">Requirement: IDE-151:</emphasis>
+<link linkend="Req-IDE-151">Test API methods and types</link> (ver. 1)</simpara>
+    <simpara>
+</simpara>
+<simpara>In some cases, types or methods are only provided for testing purposes.
+In order to improve usability, e.g. content assist, these types and methods can be annotated with <literal>@TestAPI</literal>.
+There are no constraints defined for that annotation at the moment.</simpara>
+</requirement>
+</section>
+<section xml:id="_polyfill-definitions" role="language-n4js">
+<title>Polyfill Definitions</title>
+<simpara>In plain JavaScript, so called <emphasis>polyfill</emphasis> (or sometimes called <emphasis>shim</emphasis>) libraries are provided in order to modify existing classes which are only prototypes in plain JavaScript.
+In N4JS, this can be defined for declarations via the annotation <literal>@Polyfill</literal> or <literal>@StaticPolyfill</literal>.
+One of these annotations can be added to class declarations which do not look that much different from normal classes.
+In the case of polyfill classes, the extended class is modified (or filled) instead of being subclassed. It is therefore valid to polyfill a class even if it is declared <literal>@Final</literal>.</simpara>
+<simpara>We distinguish two flavours of polyfill classes: runtime and static.</simpara>
+<itemizedlist>
+<listitem>
+<simpara>Runtime polyfilling covers type enrichment for runtime libraries.
+For type modifications the annotation <literal>@Polyfill</literal> is used.</simpara>
+</listitem>
+<listitem>
+<simpara>Static polyfilling covers code modifications for adapting generated code.
+The annotation <literal>@StaticPolyfill</literal> denotes a polyfill in ordinary code, which usually provides executable implementations.</simpara>
+</listitem>
+</itemizedlist>
+<definition>
+<title>Polyfill Class</title>
+<simpara>
+<anchor xml:id="polyfill_class" xreflabel="[polyfill_class]"/>
+<emphasis role="strong">Definition:</emphasis>
+<link linkend="polyfill_class">Polyfill Class</link></simpara>
+<simpara>
+
+A <emphasis>polyfill class</emphasis> (or simply <emphasis>polyfill</emphasis>) is
+a class modifying an existing one. The polyfill is not a new class (or type) on its own.
+Instead, new members defined in the polyfill are added to the modified class and existing members can be modified similarly to overriding.
+We call the modified class the <emphasis>filled</emphasis> class and the modification <emphasis>filling</emphasis>.</simpara>
+<simpara>We add a new pseudo property <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>p</mi><mi>o</mi><mi>l</mi><mi>y</mi><mi>f</mi><mi>i</mi><mi>l</mi><mi>l</mi></math> to classes in order to distinguish between normal (sub-) classes and polyfill classes.</simpara>
+</definition>
+<requirement xml:id="IDE-152">
+<title>Polyfill Class</title>
+<simpara>
+<anchor xml:id="Req-IDE-152" xreflabel="[Req-IDE-152]"/>
+<emphasis role="strong">Requirement: IDE-152:</emphasis>
+<link linkend="Req-IDE-152">Polyfill Class</link> (ver. 1)</simpara>
+    <simpara>
+
+For a polyfill class <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>P</mi></math> annotated with <literal>@Polyfill</literal> or  <literal>@StaticPolyfill</literal>, that is <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>P</mi><mo>.</mo><mi>p</mi><mi>o</mi><mi>l</mi><mi>y</mi><mi>f</mi><mi>i</mi><mi>l</mi><mi>l</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>true</mtext></mstyle></math>, all the following constraints must hold:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>P</mi></math> must extend a class <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>F</mi></math>, <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>F</mi></math> is called the filled class:</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mi>P</mi><mo>.</mo><mi>s</mi><mi>u</mi><mi>p</mi><mi>e</mi><mi>r</mi><mo>=</mo><mi>F</mi></math>
+</listitem>
+<listitem>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>P</mi></math>’s name equals the name of the filled class and is contained in a module with same qualified name (specifier or global):<?asciidoc-br?></simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mtable><mtr><mtd><mspace width="3.0mm"/><mi>P</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><mi>F</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi></mtd></mtr><mtr><mtd><mspace width="3.0mm"/><mo>∧</mo><mi>P</mi><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>t</mi><mi>a</mi><mi>i</mi><mi>n</mi><mi>e</mi><mi>d</mi><mi>M</mi><mi>o</mi><mi>d</mi><mi>u</mi><mi>l</mi><mi>e</mi><mo>.</mo><mi>g</mi><mi>l</mi><mi>o</mi><mi>b</mi><mi>a</mi><mi>l</mi><mo>=</mo><mi>F</mi><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>t</mi><mi>a</mi><mi>i</mi><mi>n</mi><mi>e</mi><mi>d</mi><mi>M</mi><mi>o</mi><mi>d</mi><mi>u</mi><mi>l</mi><mi>e</mi><mo>.</mo><mi>g</mi><mi>l</mi><mi>o</mi><mi>b</mi><mi>a</mi><mi>l</mi></mtd></mtr><mtr><mtd><mspace width="3.0mm"/><mo>∧</mo><mrow><mo>(</mo><mi>P</mi><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>t</mi><mi>a</mi><mi>i</mi><mi>n</mi><mi>e</mi><mi>d</mi><mi>M</mi><mi>o</mi><mi>d</mi><mi>u</mi><mi>l</mi><mi>e</mi><mo>.</mo><mi>g</mi><mi>l</mi><mi>o</mi><mi>b</mi><mi>a</mi><mi>l</mi></mrow></mtd></mtr><mtr><mtd><mrow><mspace width="3.0mm"/><mspace width="3.0em"/><mo>∨</mo><mi>P</mi><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>t</mi><mi>a</mi><mi>i</mi><mi>n</mi><mi>e</mi><mi>d</mi><mi>M</mi><mi>o</mi><mi>d</mi><mi>u</mi><mi>l</mi><mi>e</mi><mo>.</mo><mi>s</mi><mi>p</mi><mi>e</mi><mi>c</mi><mi>i</mi><mi>f</mi><mi>i</mi><mi>e</mi><mi>r</mi><mo>=</mo><mi>F</mi><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>t</mi><mi>a</mi><mi>i</mi><mi>n</mi><mi>e</mi><mi>d</mi><mi>M</mi><mi>o</mi><mi>d</mi><mi>u</mi><mi>l</mi><mi>e</mi><mo>.</mo><mi>s</mi><mi>p</mi><mi>e</mi><mi>c</mi><mi>i</mi><mi>f</mi><mi>i</mi><mi>e</mi><mi>r</mi><mo>)</mo></mrow></mtd></mtr></mtable></math>
+</listitem>
+<listitem>
+<simpara>Both the polyfill and filled class must be top-level declarations (i.e., no class expression):<?asciidoc-br?></simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mi>P</mi><mo>.</mo><mi>t</mi><mi>o</mi><mi>p</mi><mi>L</mi><mi>e</mi><mi>v</mi><mi>e</mi><mi>l</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>true</mtext></mstyle><mo>∧</mo><mi>F</mi><mo>.</mo><mi>t</mi><mi>o</mi><mi>p</mi><mi>L</mi><mi>e</mi><mi>v</mi><mi>e</mi><mi>l</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>true</mtext></mstyle></math>
+</listitem>
+<listitem>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>P</mi></math> must not implement any interfaces:</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mi>P</mi><mo>.</mo><mi>i</mi><mi>m</mi><mi>p</mi><mi>l</mi><mi>e</mi><mi>m</mi><mi>e</mi><mi>n</mi><mi>t</mi><mi>e</mi><mi>d</mi><mi>I</mi><mi>n</mi><mi>t</mi><mi>e</mi><mi>r</mi><mi>f</mi><mi>a</mi><mi>c</mi><mi>e</mi><mi>s</mi><mo>=</mo><mi>∅</mi></math>
+</listitem>
+<listitem>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>P</mi></math> must have the same access modifier (access, abstract, final) as the filled class:<?asciidoc-br?></simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mtable><mtr><mtd><mi>P</mi><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mi>e</mi><mi>s</mi><mi>s</mi><mi>M</mi><mi>o</mi><mi>d</mi><mi>i</mi><mi>f</mi><mi>i</mi><mi>e</mi><mi>r</mi><mo>=</mo><mi>F</mi><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mi>e</mi><mi>s</mi><mi>s</mi><mi>M</mi><mi>o</mi><mi>d</mi><mi>i</mi><mi>f</mi><mi>i</mi><mi>e</mi><mi>r</mi></mtd></mtr><mtr><mtd><mi>P</mi><mo>.</mo><mi>a</mi><mi>b</mi><mi>s</mi><mi>t</mi><mi>r</mi><mi>a</mi><mi>c</mi><mi>t</mi><mo>=</mo><mi>F</mi><mo>.</mo><mi>a</mi><mi>b</mi><mi>s</mi><mi>t</mi><mi>r</mi><mi>a</mi><mi>c</mi><mi>t</mi></mtd></mtr><mtr><mtd><mi>P</mi><mo>.</mo><mi>f</mi><mi>i</mi><mi>n</mi><mi>a</mi><mi>l</mi><mo>=</mo><mi>F</mi><mo>.</mo><mi>f</mi><mi>i</mi><mi>n</mi><mi>a</mi><mi>l</mi></mtd></mtr></mtable></math>
+</listitem>
+<listitem>
+<simpara>If <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>P</mi></math> declares a constructor, it must be override compatible with the constructor of the filled class:</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mo>∃</mo><mi>P</mi><mo>.</mo><mi>o</mi><mi>w</mi><mi>n</mi><mi>e</mi><mi>d</mi><mi>C</mi><mi>t</mi><mi>o</mi><mi>r</mi><mi>:</mi><mi>P</mi><mo>.</mo><mi>o</mi><mi>w</mi><mi>n</mi><mi>e</mi><mi>d</mi><mi>C</mi><mi>t</mi><mi>o</mi><mi>r</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>F</mi><mo>.</mo><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi></math>
+</listitem>
+<listitem>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>P</mi></math> must define the same type variables as the filled class <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>F</mi></math> and the arguments must be in the same order as the parameters (with no further modifications):</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mtable><mtr><mtd><mo>∀</mo><mi>i</mi><mo>,</mo><mn>0</mn><mo>≤</mo><mi>i</mi><mo>&lt;</mo><mo>|</mo><mi>P</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>P</mi><mi>a</mi><mi>r</mi><mi>s</mi><mo>|</mo><mi>:</mi></mtd></mtr><mtr><mtd><mspace width="3.0em"/><mi>P</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>P</mi><mi>a</mi><mi>r</mi><msub><mi>s</mi><mi>i</mi></msub><mo>=</mo><mi>F</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>P</mi><mi>a</mi><mi>r</mi><msub><mi>s</mi><mi>i</mi></msub></mtd></mtr><mtr><mtd><mspace width="3.0em"/><mo>∧</mo><mi>P</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>P</mi><mi>a</mi><mi>r</mi><msub><mi>s</mi><mi>i</mi></msub><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><mi>P</mi><mo>.</mo><mi>s</mi><mi>u</mi><mi>p</mi><mi>e</mi><mi>r</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>A</mi><mi>r</mi><mi>g</mi><msub><mi>s</mi><mi>i</mi></msub><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi></mtd></mtr></mtable></math>
+</listitem>
+<listitem>
+<simpara>All constraints related to member redefinition (cf. <xref linkend="_redefinition-of-members"/>) have to hold.
+In the case of polyfills, this is true for constructors (cf. <xref linkend="Req-IDE-72"/>) and private members.</simpara>
+</listitem>
+</orderedlist>
+</requirement>
+<section xml:id="_runtime-polyfill-definitions">
+<title>Runtime Polyfill Definitions</title>
+<simpara>(Runtime) Libraries often do not provide completely new types but modify existing types.
+The ECMA-402 Internationalization Standard [<link linkend="ECMA12a">ECMA12a</link>], for example, changes methods of the built-in class <literal>Date</literal> to be timezone aware.
+Other scenarios include new functionality provided by browsers which are not part of an official standard yet.
+Even ECMAScript 6 [<link linkend="ECMA15a">ECMA15a</link>] extends the predecessor [<link linkend="ECMA11a">ECMA11a</link>]  in terms of new methods (or new method parameters) added to existing types (it also adds completely new classes and features, of course).</simpara>
+<simpara>Runtime polyfills are only applicable to runtime libraries or environments and thus are limited to n4jsd files.</simpara>
+<requirement xml:id="IDE-153">
+<title>Runtime Polyfill Class</title>
+<simpara>
+<anchor xml:id="Req-IDE-153" xreflabel="[Req-IDE-153]"/>
+<emphasis role="strong">Requirement: IDE-153:</emphasis>
+<link linkend="Req-IDE-153">Runtime Polyfill Class</link> (ver. 1)</simpara>
+    <simpara>
+
+For a runtime-polyfill class <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>P</mi></math> annotated with <literal>@Polyfill</literal>, that is <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>P</mi><mo>.</mo><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>c</mi><mi>p</mi><mi>o</mi><mi>l</mi><mi>y</mi><mi>f</mi><mi>i</mi><mi>l</mi><mi>l</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>false</mtext></mstyle></math>, all the following constraints must hold in addition to <xref linkend="Req-IDE-152"/>:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>Both the polyfill and filled class are provided by the runtime
+(annotated with <literal>@ProvidedByRuntime</literal>): <footnote><simpara>This restriction has two reasons: Firstly, user-defined types with implementations would require to ’bootstrap’ the polyfill, which is impossible to do automatically without serious constraints on bootstrap code in general. Secondly, instead of filling user-defined types, they can be subclasses. Mechanisms such as dependency injection could then solve almost all remaining problems.</simpara></footnote></simpara>
+</listitem>
+</orderedlist>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mi>P</mi><mo>.</mo><mi>p</mi><mi>r</mi><mi>o</mi><mi>v</mi><mi>i</mi><mi>d</mi><mi>e</mi><mi>d</mi><mi>B</mi><mi>y</mi><mi>R</mi><mi>u</mi><mi>n</mi><mi>t</mi><mi>i</mi><mi>m</mi><mi>e</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>true</mtext></mstyle><mo>∧</mo><mi>F</mi><mo>.</mo><mi>p</mi><mi>r</mi><mi>o</mi><mi>v</mi><mi>i</mi><mi>d</mi><mi>e</mi><mi>d</mi><mi>B</mi><mi>y</mi><mi>R</mi><mi>u</mi><mi>n</mi><mi>t</mi><mi>i</mi><mi>m</mi><mi>e</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>true</mtext></mstyle></math>
+</requirement>
+<requirement xml:id="IDE-154">
+<title>Applying Polyfills</title>
+<simpara>
+<anchor xml:id="Req-IDE-154" xreflabel="[Req-IDE-154]"/>
+<emphasis role="strong">Requirement: IDE-154:</emphasis>
+<link linkend="Req-IDE-154">Applying Polyfills</link> (ver. 1)</simpara>
+    <simpara>
+</simpara>
+<simpara>A polyfill is automatically applied if a runtime library or environment required by the current project provides it. In this case, the following constraints must hold:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>No member must be filled by more than one polyfill.</simpara>
+</listitem>
+</orderedlist>
+</requirement>
+</section>
+<section xml:id="_static-polyfill-definitions">
+<title>Static Polyfill Definitions</title>
+<simpara>Static polyfilling is a compile time feature to enrich the definition and usually also the implementation of generated code in N4JS. It is related to runtime polyfilling described in <xref linkend="_runtime-polyfill-definitions"/> in a sense that both fillings enrich the types they address. Despite this, static polyfilling and runtime polyfilling differ in the way they are handled.</simpara>
+<simpara>Static polyfills usually provide executable implementations and are thus usually found in n4js files. However, they are allowed in n4jsd files, as well, for example to enrich generated code in an API project.</simpara>
+<simpara>The motivation for static polyfills is to support automatic code generation.
+In many cases, automatically generated code is missing some information to make it sufficiently usable in the desired environment.
+Manual enhancements usually need to be applied.
+If we think of a toolchain, the question may arise how to preserve the manual work when a
+regeneration is triggered. Static polyfilling allows the separation of generated code and manual adjustments in separate files.
+The transpiler merges the two files into a single transpiled file.
+To enable this behaviour, the statically fillable types must be contained in a module annotated with <literal>@StaticPolyfillAware</literal>.
+The filling types must also be annotated with <literal>@StaticPolyfill</literal> and be contained in a different module with same specifier but annotated with <literal>@StaticPolyfillModule</literal>.
+Static polyfilling is restricted to a project, thus the module to be filled as well as the filling module must be contained in the same project.</simpara>
+<simpara>We add a new pseudo property <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>c</mi><mi>P</mi><mi>o</mi><mi>l</mi><mi>y</mi><mi>f</mi><mi>i</mi><mi>l</mi><mi>l</mi></math> to classes in order to distinguish between normal (sub-) classes and static polyfill classes.
+We add two new pseudo properties to modules in order to modify the transpilation process.
+The mutually-exclusive properties <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>c</mi><mi>P</mi><mi>o</mi><mi>l</mi><mi>y</mi><mi>f</mi><mi>i</mi><mi>l</mi><mi>l</mi><mi>A</mi><mi>w</mi><mi>a</mi><mi>r</mi><mi>e</mi></math> and <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>c</mi><mi>P</mi><mi>o</mi><mi>l</mi><mi>y</mi><mi>f</mi><mi>i</mi><mi>l</mi><mi>l</mi></math> signal the way these files are processed.</simpara>
+<simpara>In order to support efficient transpilation, the following constraint must hold in addition to constraints:</simpara>
+<requirement xml:id="IDE-155">
+<title>Static Polyfill Layout</title>
+<simpara>
+<anchor xml:id="Req-IDE-155" xreflabel="[Req-IDE-155]"/>
+<emphasis role="strong">Requirement: IDE-155:</emphasis>
+<link linkend="Req-IDE-155">Static Polyfill Layout</link> (ver. 1)</simpara>
+    <simpara>
+
+For a static polyfill class <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>P</mi></math> annotated with <literal>@StaticPolyfill</literal>, that is <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>P</mi><mo>.</mo><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>c</mi><mi>p</mi><mi>o</mi><mi>l</mi><mi>y</mi><mi>f</mi><mi>i</mi><mi>l</mi><mi>l</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>true</mtext></mstyle></math>, all the following constraints must hold in addition to <xref linkend="Req-IDE-152"/>:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>P</mi></math>’s name equals the name of the filled class and is contained in a module with the same qualified name:</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mtable><mtr><mtd><mi>P</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><mi>F</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi></mtd></mtr><mtr><mtd><mo>∧</mo><mi>P</mi><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>t</mi><mi>a</mi><mi>i</mi><mi>n</mi><mi>e</mi><mi>d</mi><mi>M</mi><mi>o</mi><mi>d</mi><mi>u</mi><mi>l</mi><mi>e</mi><mo>.</mo><mi>s</mi><mi>p</mi><mi>e</mi><mi>c</mi><mi>i</mi><mi>f</mi><mi>i</mi><mi>e</mi><mi>r</mi><mo>=</mo><mi>F</mi><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>t</mi><mi>a</mi><mi>i</mi><mi>n</mi><mi>e</mi><mi>d</mi><mi>M</mi><mi>o</mi><mi>d</mi><mi>u</mi><mi>l</mi><mi>e</mi><mo>.</mo><mi>s</mi><mi>p</mi><mi>e</mi><mi>c</mi><mi>i</mi><mi>f</mi><mi>i</mi><mi>e</mi><mi>r</mi></mtd></mtr></mtable></math>
+</listitem>
+<listitem>
+<simpara>Both the static polyfill and the filled class are part of the same project:</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mi>P</mi><mo>.</mo><mi>p</mi><mi>r</mi><mi>o</mi><mi>j</mi><mi>e</mi><mi>c</mi><mi>t</mi><mo>=</mo><mi>F</mi><mo>.</mo><mi>p</mi><mi>r</mi><mi>o</mi><mi>j</mi><mi>e</mi><mi>c</mi><mi>t</mi></math>
+</listitem>
+<listitem>
+<simpara>The filled class must be contained in a module annotated with <literal>@StaticPolyfillAware</literal>:</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mi>F</mi><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>t</mi><mi>a</mi><mi>i</mi><mi>n</mi><mi>e</mi><mi>d</mi><mi>M</mi><mi>o</mi><mi>d</mi><mi>u</mi><mi>l</mi><mi>e</mi><mo>.</mo><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>c</mi><mi>P</mi><mi>o</mi><mi>l</mi><mi>y</mi><mi>f</mi><mi>i</mi><mi>l</mi><mi>l</mi><mi>A</mi><mi>w</mi><mi>a</mi><mi>r</mi><mi>e</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>true</mtext></mstyle></math>
+</listitem>
+<listitem>
+<simpara>The static polyfill and the filled type must both be declared in an n4js file or both in an n4jsd file.</simpara>
+</listitem>
+<listitem>
+<simpara>The filling class must be contained in a module annotated with <literal>@StaticPolyfillModule</literal>:</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mi>P</mi><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>t</mi><mi>a</mi><mi>i</mi><mi>n</mi><mi>e</mi><mi>d</mi><mi>M</mi><mi>o</mi><mi>d</mi><mi>u</mi><mi>l</mi><mi>e</mi><mo>.</mo><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>c</mi><mi>P</mi><mi>o</mi><mi>l</mi><mi>y</mi><mi>f</mi><mi>i</mi><mi>l</mi><mi>l</mi><mi>M</mi><mi>o</mi><mi>d</mi><mi>u</mi><mi>l</mi><mi>e</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>true</mtext></mstyle></math>
+</listitem>
+<listitem>
+<simpara>For a statically-filled class <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>F</mi></math> there is at most one static polyfill:</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfenced close=")" open="("><mrow><msub><mi>P</mi><mn>1</mn></msub><mstyle mathvariant="monospace"><mspace width="1ex"/><mtext>is static polyfill of</mtext><mspace width="1ex"/></mstyle><mi>F</mi><mo>∧</mo><msub><mi>P</mi><mn>2</mn></msub><mstyle mathvariant="monospace"><mspace width="1ex"/><mtext>is static polyfill of</mtext><mspace width="1ex"/></mstyle><mi>F</mi></mrow></mfenced><mo>→</mo><msub><mi>P</mi><mn>1</mn></msub><mo>=</mo><msub><mi>P</mi><mn>2</mn></msub></math>
+</listitem>
+</orderedlist>
+</requirement>
+<requirement xml:id="IDE-156">
+<title>Restrictions on static polyfilling</title>
+<simpara>
+<anchor xml:id="Req-IDE-156" xreflabel="[Req-IDE-156]"/>
+<emphasis role="strong">Requirement: IDE-156:</emphasis>
+<link linkend="Req-IDE-156">Restrictions on static polyfilling</link> (ver. 1)</simpara>
+    <simpara>
+
+For a static polyfilling module <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>M</mi><mi>P</mi></msub></math> the following must hold:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>All top-level elements are static polyfills:</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><mo>∀</mo><mi>T</mi><mo>∈</mo><msub><mi>M</mi><mi>P</mi></msub><mo>∧</mo><mi>T</mi><mo>.</mo><mi>t</mi><mi>o</mi><mi>p</mi><mi>L</mi><mi>e</mi><mi>v</mi><mi>e</mi><mi>l</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>true</mtext></mstyle></mrow><mrow><mi>T</mi><mo>.</mo><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>c</mi><mi>P</mi><mi>o</mi><mi>l</mi><mi>y</mi><mi>f</mi><mi>i</mi><mi>l</mi><mi>l</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>true</mtext></mstyle></mrow></mfrac></math>
+</listitem>
+<listitem>
+<simpara>It exists exactly one filled module <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>M</mi><mi>F</mi></msub></math> annotated with <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>c</mi><mi>P</mi><mi>o</mi><mi>l</mi><mi>y</mi><mi>f</mi><mi>i</mi><mi>l</mi><mi>l</mi><mi>A</mi><mi>w</mi><mi>a</mi><mi>r</mi><mi>e</mi></math> in the same project.</simpara>
+</listitem>
+<listitem>
+<simpara>It is an error if two static polyfill modules for the same filled module exist in the same project:</simpara>
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><msub><mi>M</mi><mn>1.</mn></msub><mi>s</mi><mi>p</mi><mi>e</mi><mi>c</mi><mi>i</mi><mi>f</mi><mi>i</mi><mi>e</mi><mi>r</mi><mo>=</mo><msub><mi>M</mi><mn>2.</mn></msub><mi>s</mi><mi>p</mi><mi>e</mi><mi>c</mi><mi>i</mi><mi>f</mi><mi>i</mi><mi>e</mi><mi>r</mi><mo>∧</mo><msub><mi>M</mi><mn>1.</mn></msub><mi>p</mi><mi>r</mi><mi>o</mi><mi>j</mi><mi>e</mi><mi>c</mi><mi>t</mi><mo>=</mo><msub><mi>M</mi><mn>2.</mn></msub><mi>p</mi><mi>r</mi><mi>o</mi><mi>j</mi><mi>e</mi><mi>c</mi><mi>t</mi><mtext>
+</mtext><mo>∧</mo><msub><mi>M</mi><mn>1.</mn></msub><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>c</mi><mi>P</mi><mi>o</mi><mi>l</mi><mi>y</mi><mi>f</mi><mi>i</mi><mi>l</mi><mi>l</mi><mi>M</mi><mi>o</mi><mi>d</mi><mi>u</mi><mi>l</mi><mo>=</mo><msub><mi>M</mi><mn>2.</mn></msub><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>c</mi><mi>P</mi><mi>o</mi><mi>l</mi><mi>y</mi><mi>f</mi><mi>i</mi><mi>l</mi><mi>l</mi><mi>M</mi><mi>o</mi><mi>d</mi><mi>u</mi><mi>l</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>true</mtext></mstyle></mrow><mrow><msub><mi>M</mi><mn>1</mn></msub><mo>=</mo><msub><mi>M</mi><mn>2</mn></msub></mrow></mfrac></math>
+</listitem>
+</orderedlist>
+</requirement>
+<example>
+<title>Static polyfill</title>
+<simpara><xref linkend="ex:staticpolyfill-genmod"/> shows an example of generated code.
+<xref linkend="ex:staticpolyfill-polyfillmod"/> demonstrates the static polyfill.</simpara>
+<simpara>Note that the containing project has two source folders configured:<?asciidoc-br?>
+<literal>Project/src/n4js</literal> and <literal>Project/src/n4jsgen</literal>.</simpara>
+<formalpara xml:id="ex:staticpolyfill-polyfillmod">
+<title>Static Polyfill, Polyfillmod</title>
+<para>
+<programlisting language="n4js" linenumbering="unnumbered">@@StaticPolyfillAware
+export public class A {
+    constructor() {...}
+    m1(): void{...}
+}
+export public class B {
+    constructor() {...}
+    m2(): void{...}
+}</programlisting>
+</para>
+</formalpara>
+<formalpara xml:id="ex:staticpolyfill-genmod">
+<title>Static Polyfill, Genmod</title>
+<para>
+<programlisting language="n4js" linenumbering="unnumbered">@@StaticPolyfillModule
+@StaticPolyfill
+export public class B extends B {
+    @Override
+    constructor(){ ... } // replaces generated ctor of B
+    @Override
+    m1(): void {...} // adds overridden method m1 to B
+    @Override
+    m2(): void {...} // replaces method m2 in B
+    m3(): void {...} // adds new method m3 to B
+}</programlisting>
+</para>
+</formalpara>
+</example>
+</section>
+<section xml:id="_transpiling-static-polyfilled-classes">
+<title>Transpiling static polyfilled classes</title>
+<simpara>Transpiling static polyfilled classes encounters the special case that two different <literal>n4js</literal> source files with the same qualified name are part of the project.
+Since the current transpiler is file-based, both files would be transpiled to the same output destination and would therefore overwrite each other.
+The following pre-transpilation steps handle this situation:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>Current file to transpile is <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>M</mi></math></simpara>
+</listitem>
+<listitem>
+<simpara>If <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>M</mi><mo>.</mo><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>c</mi><mi>P</mi><mi>o</mi><mi>l</mi><mi>y</mi><mi>f</mi><mi>i</mi><mi>l</mi><mi>l</mi><mi>A</mi><mi>w</mi><mi>a</mi><mi>r</mi><mi>e</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>true</mtext></mstyle></math>, then</simpara>
+<itemizedlist>
+<listitem>
+<simpara>search for a second file <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>G</mi></math> with same qualified name:<?asciidoc-br?>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>G</mi><mo>.</mo><mi>s</mi><mi>p</mi><mi>e</mi><mi>c</mi><mi>i</mi><mi>f</mi><mi>i</mi><mi>e</mi><mi>r</mi><mo>=</mo><mi>M</mi><mo>.</mo><mi>s</mi><mi>p</mi><mi>e</mi><mi>c</mi><mi>i</mi><mi>f</mi><mi>i</mi><mi>e</mi><mi>r</mi><mo>∧</mo><mi>G</mi><mo>.</mo><mi>p</mi><mi>r</mi><mi>o</mi><mi>j</mi><mi>e</mi><mi>c</mi><mi>t</mi><mo>=</mo><mi>M</mi><mo>.</mo><mi>p</mi><mi>r</mi><mi>o</mi><mi>j</mi><mi>e</mi><mi>c</mi><mi>t</mi></math></simpara>
+</listitem>
+<listitem>
+<simpara>If <math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∃</mo><mi>G</mi></math>, then</simpara>
+<itemizedlist>
+<listitem>
+<simpara>merge <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>G</mi></math> into current file <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>M</mi><mo>→</mo><msup><mi>M</mi><mi>'</mi></msup></math></simpara>
+</listitem>
+<listitem>
+<simpara>conventionally transpile <math xmlns="http://www.w3.org/1998/Math/MathML"><msup><mi>M</mi><mi>'</mi></msup></math></simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+<listitem>
+<simpara>else conventionally transpile <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>M</mi></math></simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+<listitem>
+<simpara>else, if <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>M</mi><mo>.</mo><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>c</mi><mi>P</mi><mi>o</mi><mi>l</mi><mi>y</mi><mi>f</mi><mi>i</mi><mi>l</mi><mi>l</mi><mi>M</mi><mi>o</mi><mi>d</mi><mi>u</mi><mi>l</mi><mi>e</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>true</mtext></mstyle></math>,</simpara>
+<itemizedlist>
+<listitem>
+<simpara>then <emphasis>do nothing</emphasis>. (Transpilation will be triggered for filled type separately.)</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+<listitem>
+<simpara>else, conventionally transpile <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>M</mi></math></simpara>
+</listitem>
+</itemizedlist>
+</section>
+</section>
+</chapter>
+<chapter xml:id="_components">
+<title>Components</title>
+<section xml:id="_overview-2" role="language-n4js">
+<title>Overview</title>
+<simpara>For modularization purposes, N4JS code is managed in so-called <emphasis>components</emphasis>. These components correspond to what
+node and npm call <emphasis>packages</emphasis>, what OSGi calls <emphasis>bundle</emphasis>, and what Eclipse calls <emphasis>project</emphasis>.</simpara>
+<simpara>N4JS distinguishes several types of such components. <xref linkend="fig-cmpd_components_in_n4js"/> shows the N4JS component types
+described in detail in this chapter. <xref linkend="fig-cmp_components"/> shows a recently updated diagram, which is not yet fully
+reflected in the implementation.</simpara>
+<figure xml:id="fig-cmpd_components_in_n4js">
+<title>Overview of N4JS Components (OLD)</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/12_components/fig/cmpd_components_in_n4js.svg" align="center"/>
+</imageobject>
+<textobject><phrase>cmpd components in n4js</phrase></textobject>
+</mediaobject>
+</figure>
+<figure xml:id="fig-cmp_components">
+<title>Overview of N4JS Components and Dependencies (NEW)</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/12_components/fig/cmp_components.svg" align="center"/>
+</imageobject>
+<textobject><phrase>cmp components</phrase></textobject>
+</mediaobject>
+</figure>
+<simpara>The following types of components can only be created by internal developers:</simpara>
+<variablelist>
+<varlistentry>
+<term>Runtime Environment</term>
+<listitem>
+<simpara>Definition of a runtime environment such as ECMAScript 5, node.js, or Chrome.
+A Runtime Environment provides a number of base types which are usually globally available.
+Other components do not directly rely on runtime environments, but on runtime libraries.
+NOTE: runtime environments are not fully implemented at this time (see GH-1291).</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>Runtime Library</term>
+<listitem>
+<simpara>Contains type definitions for the base types provided by one or more runtime environments.
+These types may be extensions to certain language specifications.
+E.g., the ECMAScript 6 collection classes are already provided by some environments otherwise only supporting ECMAScript 5.
+The collections are defined in terms of a runtime library which can then be provided by these environments.
+Runtime libraries may also contain polyfills to alter types predefined in the environment.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+<simpara>The following components can be created by external developers:</simpara>
+<variablelist xml:id="App">
+<varlistentry>
+<term>App</term>
+<listitem>
+<simpara>User-written N4JS applications.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>Processor</term>
+<listitem>
+<simpara>User-written N4JS code running server-side on the N4 platform. Not implemented yet.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>Library</term>
+<listitem>
+<simpara>User-written libraries used by apps, processors, or other libraries.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+<simpara>The available component types are described in more detail in <xref linkend="Component_Types"/>.</simpara>
+<simpara>A component corresponds to a single project in the N4JS IDE. Generally, it contains the following:</simpara>
+<variablelist>
+<varlistentry>
+<term>Package.json File</term>
+<listitem>
+<simpara>The <literal>package.json</literal> file describing the contents, dependencies and metadata.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>Resources</term>
+<listitem>
+<simpara>Resources such as images, data files etc.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>Sources</term>
+<listitem>
+<simpara>Source files containing either N4JS code or plain Javascript. The actual code used in a project.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>Output Code</term>
+<listitem>
+<simpara>Compiled and possibly adjusted (e.g. minified, concatenated) versions of the N4JS source files and
+plain Javascript files.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>Tests</term>
+<listitem>
+<simpara>Optional test sources and compiled output code.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>Source Maps</term>
+<listitem>
+<simpara>Optional source maps.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+<simpara>Components contain modules. <xref linkend="fig-component_content"/> describes what can be contained in a component.</simpara>
+<figure xml:id="fig-component_content">
+<title>Content of a Component</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/12_components/fig/cmpd_component_content.svg" width="70%" scalefit="1" align="center"/>
+</imageobject>
+<textobject><phrase>cmpd component content</phrase></textobject>
+</mediaobject>
+</figure>
+<simpara>At both compile time and runtime, all components defined as dependency have to be available. Since dependencies
+are defined in <literal>package.json</literal> files in a form compliant to node/npm, this can be fully managed by npm (or yarn).</simpara>
+</section>
+<section xml:id="Component_Types" role="language-n4js">
+<title>Component Types</title>
+<simpara>Different N4JS component types are described in this section.</simpara>
+<section xml:id="_libraries">
+<title>Libraries</title>
+<simpara>A library is a user project providing modules with declaration.</simpara>
+</section>
+<section xml:id="_runtime-environment-and-runtime-libraries">
+<title>Runtime Environment and Runtime Libraries</title>
+<note>
+<simpara>runtime environments are not fully implemented at this time (see GH-1291).</simpara>
+</note>
+<simpara>Runtime environments and libraries define globally available elements (types, variables, functions) provided by the JavaScript engine.
+Both must contain <emphasis>only</emphasis> definition files (n4jsd) of which all elements are marked as <literal>@ProvidedByRuntime</literal> (<xref linkend="_runtime-definitions"/>) and <literal>@Global</literal> (<xref linkend="_global-definitions"/>).</simpara>
+<simpara>Other projects may refer to <emphasis>multiple</emphasis> runtime libraries in their <literal>package.json</literal> file via the property <xref linkend="package-json-requiredRuntimeLibraries"/>.</simpara>
+<simpara>The concrete runtime environment and library are selected by the JavaScript engine.
+Deployment and execution scripts must ensure that a component can run on the given engine; the required environments and libraries must all be compatible with the provided environment.
+If no runtime environment is specified, a default an ECMAScript 5 runtime is assumed to be present.</simpara>
+<simpara>Typical runtime environments are ES5 or ES6, typical runtime libraries are DOM or HTML.</simpara>
+<simpara>In JavaScript, browsers and other execution environments provide built-in objects.
+In browsers, for example, the whole DOM is made available via built-in object types.
+In this case, even the global object also becomes a different type (in N4JS terms).
+Besides execution environments such as browsers or Node.js, libraries also provide functionality by exposing globally available functions.
+This is often used to bridge execution environment inconsistencies.
+When browser API differences are adapted by a library, this is called a <emphasis>polyfil</emphasis>.
+Other adaptations, such as enabling ECMSScript 6 object types in ECMAScript 5 environments, are known as <emphasis>shim</emphasis>.
+Instead of directly supporting these kind of 'hacks', other components specify which runtime environment and libraries they depend on by specifying unique runtime ids.
+Possible shims (in case of environments) or polyfils (in case of libraries) are transparently provided by the execution environment and the bootstrap code.</simpara>
+</section>
+<section xml:id="_tests">
+<title>Tests</title>
+<simpara>Tests are special projects which contain tests for other projects.</simpara>
+<requirement xml:id="IDE-157">
+<title>Test Project</title>
+<simpara>
+<anchor xml:id="Req-IDE-157" xreflabel="[Req-IDE-157]"/>
+<emphasis role="strong">Requirement: IDE-157:</emphasis>
+<link linkend="Req-IDE-157">Test Project</link> (ver. 1)</simpara>
+    <simpara>
+</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>Tests have full access to the tested project including elements with <literal>project</literal> visibility.</simpara>
+</listitem>
+<listitem>
+<simpara>Only other test projects can depend on tests project.
+In other words, other components must not depend on test components.</simpara>
+</listitem>
+</orderedlist>
+<simpara>In a test project, the tested projects can be specified via <literal>testee</literal>.</simpara>
+</requirement>
+</section>
+<section xml:id="_type-definitions">
+<title>Type Definitions</title>
+<simpara>Projects of type "definition" are special projects which only provide type information for another so-called <emphasis>implementation project</emphasis>,  which only provides executable JS files.</simpara>
+<simpara>Generally, client projects that depend on a given <emphasis>implementation project</emphasis> may additionally declare a dependency on a corresponding type definitions project, in order to integrate type information on the implementation project.
+This is implemented by means of module-level shadowing.
+More specifically, given a client imports a module with module specifier <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>M</mi></math> from the implementation project.
+When resolving the module specifier, <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>M</mi></math> will first be resolved against the implementation project&#8217;s type definitions and only secondarily against the implementation project.
+As a consequence, type definition projects may only provide partial type information, while the remaining modules of the implementation project remain accessible through dynamic namespace imports.</simpara>
+<requirement xml:id="GH-821002">
+<title>Type Definition Project Configuration</title>
+<simpara>
+<anchor xml:id="Req-GH-821002" xreflabel="[Req-GH-821002]"/>
+<emphasis role="strong">Requirement: GH-821002:</emphasis>
+<link linkend="Req-GH-821002">Type Definition Project Configuration</link> (ver. 1)</simpara>
+    <simpara>
+</simpara>
+<simpara>For type definition projects, the following constraints must hold true with regard to their project configuration:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>They must declare their <emphasis>implementation project</emphasis> via the <xref linkend="package-json-definesPackage"/> property in their <literal>package.json</literal> file.</simpara>
+</listitem>
+<listitem>
+<simpara>They must not declare an output folder.</simpara>
+</listitem>
+</orderedlist>
+</requirement>
+</section>
+</section>
+<section xml:id="package-json" role="language-n4js" xreflabel="Package.json File">
+<title>Package.json File</title>
+<simpara>A folder is a "component" if and only if it contains a <literal>package.json</literal> file. Being a component means
+that this folder is recognized by all N4JS-related tools but does not necessarily mean the component
+contains N4JS code (it could just contain plain Javascript). The main benefit of being a component
+in this sense is that this unit of code can be used by other N4JS components as a dependency.</simpara>
+<simpara>For example, a plain npm project containing only plain Javascript can be a component and
+can therefore be used as a project dependency of a full-blown N4JS component.</simpara>
+<section xml:id="_basic-properties">
+<title>Basic Properties</title>
+<simpara>The following standard <literal>package.json</literal> properties are used by N4JS tooling. Unless otherwise
+noted, all these properties have the exact same format and meaning as usual in <literal>package.json</literal>
+files.</simpara>
+<variablelist>
+<varlistentry>
+<term>name </term>
+<listitem>
+<simpara>Used as the globally unique identifier of the component.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>version </term>
+<listitem>
+<simpara>The component&#8217;s version.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+<variablelist xml:id="package-json-dependencies" xreflabel="dependencies">
+<varlistentry>
+<term>dependencies </term>
+<listitem>
+<simpara>List of components required at runtime and compile time.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+<variablelist xml:id="package-json-devDependencies" xreflabel="devDependencies">
+<varlistentry>
+<term>devDependencies </term>
+<listitem>
+<simpara>List of components required at compile time only.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>main </term>
+<listitem>
+<simpara>Path relative to the component&#8217;s root folder, pointing to a <literal>.js</literal> file
+located in a source container (the <literal>.js</literal> file extension is optional,
+i.e. may be omitted). This file then serves as the component&#8217;s
+default entry point, i.e. project imports pointing to this component from
+other components will import from the file denoted by this property. In
+addition, this property may denote a folder and is then assumed to point
+to a file <literal>index.js</literal> located in that folder. If this property denotes a file
+other than a <literal>.js</literal> file, it will be ignored. In particular, it cannot be
+used for <literal>.n4js</literal> files; in that case, property "mainModule" has to be used
+(see below).</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>workspaces </term>
+<listitem>
+<simpara>(array of strings) Property used by package management tool <literal>yarn</literal> to denote
+that a project serves as a "yarn workspace" and to denote the other projects
+that form the members of this yarn workspace. For details, see
+<link xl:href="https://yarnpkg.com/lang/en/docs/workspaces">here</link>.
+In N4JS, a project is called a "yarn workspace root" if and only if its
+<literal>package.json</literal> file contains top-level property "workspaces", no matter the property&#8217;s
+value (i.e. it will be called "yarn workspace root" even if the value of property
+"workspaces" is the empty array or an invalid value such as a number). The nested
+projects referred to via the strings in this property&#8217;s array value are called
+"member projects" of the yarn workspace.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+</section>
+<section xml:id="_n4js-properties">
+<title>N4JS Properties</title>
+<simpara>In addition to the standard properties above, there is a single N4JS-specific
+top-level property called "n4js". The value of this property must always be
+an object that may have any combination of the following properties:</simpara>
+<variablelist>
+<varlistentry>
+<term>projectType</term>
+<listitem>
+<simpara>(string) Must be one of the following strings:</simpara>
+<variablelist>
+<varlistentry>
+<term>application</term>
+<listitem>
+<simpara>An application. See <xref linkend="App"/>.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>library</term>
+<listitem>
+<simpara>A library. See <xref linkend="_libraries"/>.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>processor</term>
+<listitem>
+<simpara>For processors running server-side on the N4 platform. Not implemented yet.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>test</term>
+<listitem>
+<simpara>An N4JS project containing tests for one or more other N4JS projects specified
+via property "testedProjects".</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>api</term>
+<listitem>
+<simpara>For N4JS projects that contain only API (in <literal>.n4jsd</literal> files) to be implemented by other,
+so-called implementation projects. See properties "implementationId", "implementedProjects".
+NOTE: the API/Implementation concept is not fully implemented at this time (see GH-1291).</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>runtimeEnvironment</term>
+<listitem>
+<simpara>Runtime environments. See <xref linkend="Runtime Environment Resolution"/>.
+NOTE: runtime environments are not fully implemented at this time (see GH-1291).</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>runtimeLibrary</term>
+<listitem>
+<simpara>Runtime libraries. See <xref linkend="_runtime-environment-and-runtime-libraries"/>.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>validation</term>
+<listitem>
+<simpara>A project in which <literal>.n4js</literal> files are only being validated, not transpiled. This is used for projects
+that are implemented in terms of <literal>.js</literal> files but that also provide type information in terms of <literal>.n4jsd</literal> files.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>plainjs</term>
+<listitem>
+<simpara>A project which only contains <literal>.js</literal> files and no N4JS resources. The contained JS files are only indexed to allow
+for dynamic imports of specific JavaScript modules. Projects of this type are not being transpiled.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>vendorId</term>
+<listitem>
+<simpara>(string) Globally unique identifier for the component&#8217;s vendor.
+Used for the <literal>@Internal</literal> accessibility modifier.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>vendorName</term>
+<listitem>
+<simpara>(string) Human-readable name of the component&#8217;s vendor. Used only for informational
+purposes.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>output</term>
+<listitem>
+<simpara>(string) Path relative to the component&#8217;s root folder, pointing to a folder where
+all output files will be placed. In particular, this is where the N4JS transpiler
+will put the <literal>.js</literal> files created for each <literal>.n4js</literal> file.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>sources</term>
+<listitem>
+<simpara>(object) Defines various sub-folders where sources, etc. are located. All properties
+of the given object must have the following format: the name must be "source", "external",
+or "test"; the value must be an array of strings, with each string defining a
+path relative to the component&#8217;s root folder, pointing to a folder where
+source files of the corresponding type are located. For example, paths given via name
+"source" tell the N4JS transpiler where to look for <literal>.n4js</literal> source files to be compiled.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>moduleFilters</term>
+<listitem>
+<simpara>(object) Filters for fine-tuning the validator and compiler. A filter is applied to modules
+matching the given module specifier which may contain wildcards, optionally restricted to
+modules defined in a specific source path.</simpara>
+<simpara>All properties of the given object must have the following format: the name must be a valid
+module filter type (see below); the value must be an array of strings, with each string
+defining a pattern of files inside one of the source containers for which validation or
+module wrapping is to be turned off. Instead of a plain string, the inner array may
+contain an object with properties "module" and "sourceContainer" to make this filter apply
+to only one of the source containers (instead of all source containers, which is the default).</simpara>
+<variablelist>
+<varlistentry>
+<term>noValidate</term>
+<listitem>
+<simpara>Modules matching this filter are not semantically validated.
+That is, they are still syntactically validated.
+If they are contained in source or test source fragments, it must be possible to bind references
+to declarations inside these modules.
+Note that switching off validation for n4js files is disallowed.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+</variablelist>
+<example>
+<title>Module Filters</title>
+<simpara>A simple and a source-container-specific module filter in the <literal>n4js</literal> section of a package.json file.</simpara>
+<programlisting language="json" linenumbering="unnumbered">"moduleFilters": {
+	"noValidate": [
+		"abc*",
+		{
+			"module": "xyz*",
+			"sourceContainer": "src/n4js"
+		}
+	]
+}</programlisting>
+</example>
+<variablelist xml:id="package-json-mainModule" xreflabel="mainModule">
+<varlistentry>
+<term>mainModule</term>
+<listitem>
+<simpara>(string) A plain module specifier defining the project’s 'main module'.
+If this property is defined, other projects can import from this project using imports where the string following
+keyword <literal>from</literal> states only the project name and not the complete module specifier (see <xref linkend="import-statement-semantics"/>).
+If this property is defined, top-level property <literal>main</literal> will be ignored.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>testedProjects</term>
+<listitem>
+<simpara>  (array) List of N4JS components being tested by this project.
+ <?asciidoc-br?>
+Only components of project type "test" may declare this property. Furthermore, the referenced
+projects must all be of the same project type and must not be of type "test" themselves.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+<variablelist xml:id="package-json-implementationId" xreflabel="implementationId">
+<varlistentry>
+<term>implementationId</term>
+<listitem>
+<simpara>(string) If this property is defined, this component is called an "implementation project" and the string value
+  provides a unique identifier for the implementation provided in this component. If this is defined, property
+  "implementedProjects" must be defined as well. For details, see <xref linkend="API and Implementation Components"/>.</simpara>
+<simpara>Only projects of type "application", "processor", "library", "api" or "validation" may declare this property.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+<variablelist xml:id="package-json-implementedProjects" xreflabel="implementedProjects">
+<varlistentry>
+<term>implementedProjects</term>
+<listitem>
+<simpara>(array) A list of API components (components of type "api") that are implemented by this component. If this
+is defined, property "implementationId" must be defined as well. For details, see
+<xref linkend="API and Implementation Components"/>. Only components of type  "application", "processor", "library", "api"
+or "validation" may declare this property.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+<variablelist xml:id="package-json-requiredRuntimeLibraries" xreflabel="requiredRuntimeLibraries">
+<varlistentry>
+<term>requiredRuntimeLibraries</term>
+<listitem>
+<simpara>(array) The list of required runtime library components that are required for the execution of this
+ component. All components but components of type "runtime environment" may declare this property. Each
+ required runtime library must also be specified as a dependency using one of the top-level
+ properties <literal>dependencies</literal> or <literal>devDependencies</literal>.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>extendedRuntimeEnvironment</term>
+<listitem>
+<simpara>(string) The name of the runtime environment project that is extended by this component. Only components of
+type "runtime environment" may declare this property.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>providedRuntimeLibraries</term>
+<listitem>
+<simpara>(array) The list of runtime library components that are provided by this component. Only components of
+type "runtime environment" may declare this property.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+<variablelist xml:id="package-json-definesPackage" xreflabel="definesPackage">
+<varlistentry>
+<term>definesPackage</term>
+<listitem>
+<simpara>(string) The name of the package this component provides type definitions for. Only components of project type "definition" may declare this property.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+<simpara>All properties described above are optional. The following default values apply:</simpara>
+<informaltable frame="all" rowsep="1" colsep="1">
+<tgroup cols="2">
+<colspec colname="col_1" colwidth="50*"/>
+<colspec colname="col_2" colwidth="50*"/>
+<tbody>
+<row>
+<entry align="left" valign="top"><simpara><emphasis role="strong">Property</emphasis></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">Default Value</emphasis></simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara>name</simpara></entry>
+<entry align="left" valign="top"><simpara>name of the folder containing the <literal>package.json</literal> file</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara>version</simpara></entry>
+<entry align="left" valign="top"><simpara>"0.0.1"</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara>projectType</simpara></entry>
+<entry align="left" valign="top"><simpara>"plainjs"</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara>vendorId</simpara></entry>
+<entry align="left" valign="top"><simpara>"vendor.default"</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara>mainModule</simpara></entry>
+<entry align="left" valign="top"><simpara>"index"</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara>output</simpara></entry>
+<entry align="left" valign="top"><simpara>"."</simpara></entry>
+</row>
+<row>
+<entry align="left" valign="top"><simpara>sources</simpara></entry>
+<entry align="left" valign="top"><simpara>a single source-container of type "source" with path "." (except for yarn workspace roots, see below)</simpara></entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+<simpara>All other properties are undefined if not given in the <literal>package.json</literal> file. The default source folder of "." does not
+apply to projects that represent the root folder of a yarn workspace; those projects do not have any source folder,
+by default.</simpara>
+<example>
+<title>A package.json file with N4JS-specific properties.</title>
+<simpara>The following example illustrates how to use the N4JS-related package.json properties.</simpara>
+<screen>{
+	"name": "SampleProject",
+	"version": "0.0.1",
+	"author": "Enfore AG",
+	"main": "./src/js/main.js",
+	"dependencies": {
+		"OtherProject": "&gt;=1.2.3 &lt;2.0.0",
+		"n4js-runtime-es2015": "latest"
+	},
+	"devDependencies": {
+		"org.eclipse.n4js.mangelhaft": "latest"
+	},
+	"n4js": {
+		"projectType": "library",
+		"vendorId": "org.eclipse.n4js",
+		"vendorName": "Eclipse N4JS Project",
+		"output": "src-gen",
+		"mainModule": "a/b/Main",
+		"sources": {
+			"source": [
+				"src/n4js",
+				"src/n4js-gen"
+			],
+			"external": [
+				"src-ext"
+			],
+			"test": [
+				"src-test"
+			]
+		},
+		"moduleFilters": {
+			"noValidate": [
+				"abc*",
+				{
+					"module": "xyz*",
+					"sourceContainer": "src/n4js"
+				}
+			]
+		},
+		"requiredRuntimeLibraries": [
+			"n4js-runtime-es2015"
+		]
+	}
+}</screen>
+</example>
+</section>
+<section xml:id="_constraints">
+<title>Constraints</title>
+<simpara>The following constraints apply.</simpara>
+<requirement xml:id="IDE-158">
+<title>GeneralConstraints</title>
+<simpara>
+<anchor xml:id="Req-IDE-158" xreflabel="[Req-IDE-158]"/>
+<emphasis role="strong">Requirement: IDE-158:</emphasis>
+<link linkend="Req-IDE-158">GeneralConstraints</link> (ver. 1)</simpara>
+    <simpara>
+
+1.  There must be an output directory specified so the compiler(s) can run.</simpara>
+</requirement>
+<requirement xml:id="IDE-159">
+<title>Paths</title>
+<simpara>
+<anchor xml:id="Req-IDE-159" xreflabel="[Req-IDE-159]"/>
+<emphasis role="strong">Requirement: IDE-159:</emphasis>
+<link linkend="Req-IDE-159">Paths</link> (ver. 1)</simpara>
+    <simpara>
+
+Paths Paths are constrained in the following way:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>A path cannot appear more than one time within a source fragment type (same applies to paths in the resources section).</simpara>
+</listitem>
+<listitem>
+<simpara>A path cannot be used in different source fragment types at same times.</simpara>
+</listitem>
+<listitem>
+<simpara>A path can only be declared exclusively in one of the sections Output, Libraries, Resources or Sources.</simpara>
+</listitem>
+<listitem>
+<simpara>A path must not contain wild cards.</simpara>
+</listitem>
+<listitem>
+<simpara>A path has to be relative to the project path.</simpara>
+</listitem>
+<listitem>
+<simpara>A path has to point to folder.</simpara>
+</listitem>
+<listitem>
+<simpara>The folder a defined path points to must exist in the project (but in case of non-existent folders of source fragments, only a warning is shown).</simpara>
+</listitem>
+</orderedlist>
+</requirement>
+<requirement xml:id="IDE-160">
+<title>Module Specifiers</title>
+<simpara>
+<anchor xml:id="Req-IDE-160" xreflabel="[Req-IDE-160]"/>
+<emphasis role="strong">Requirement: IDE-160:</emphasis>
+<link linkend="Req-IDE-160">Module Specifiers</link> (ver. 1)</simpara>
+    <simpara>
+
+Module Specifiers are constrained in the following
+way:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>Within a module filter type no duplicate specifiers are allowed.</simpara>
+</listitem>
+<listitem>
+<simpara>A module specifier is by default applied relatively to all defined source containers, i.e. if there src and src2 defined as source containers in both folders files are looked up that matches the given module specifier</simpara>
+</listitem>
+<listitem>
+<simpara>A module specifier can be constrained to be applied only to a certain source container.</simpara>
+</listitem>
+<listitem>
+<simpara>A module specifier is allowed to contain wildcards but it must resolve to some existing files in the project</simpara>
+</listitem>
+</orderedlist>
+</requirement>
+<requirement xml:id="IDE-161">
+<title>Module Specifier Wildcard Constraints</title>
+<simpara>
+<anchor xml:id="Req-IDE-161" xreflabel="[Req-IDE-161]"/>
+<emphasis role="strong">Requirement: IDE-161:</emphasis>
+<link linkend="Req-IDE-161">Module Specifier Wildcard Constraints</link> (ver. 1)</simpara>
+    <simpara>
+
+. All path patterns are case sensitive.
+. <literal>**</literal> all module specifiers will be matched.
+. <literal>**/*</literal> all module specifiers will be matched.
+. <literal>test/A??</literal> matches all module specifiers whose qualified name consists of two segments where the first part matches test and the second part starts with an <literal>A</literal> and then two more characters.
+.  <literal>**/test/**/XYZ</literal> - matches all module specifiers whose qualified name contains a segment that matches test and the last segment ends with an ’XYZ’.
+.  A module specifier wild card isn’t allowed to contain <literal>***</literal>.
+.  A module specifier wild card isn’t allowed to contain relative navigation.
+.  A module specifier wild card shouldn’t contain the file extension (only state the file name (pattern) without extension, valid file extensions will then be used to match the file).</simpara>
+</requirement>
+<simpara>Examples of using external source fragments and filters are given in <xref linkend="_implementation-of-external-declarations"/>, see <xref linkend="external-definitions-and-implementations"/>.</simpara>
+<requirement xml:id="GH-821001">
+<title>Dependencies to Definition Projects</title>
+<simpara>
+<anchor xml:id="Req-GH-821001" xreflabel="[Req-GH-821001]"/>
+<emphasis role="strong">Requirement: GH-821001:</emphasis>
+<link linkend="Req-GH-821001">Dependencies to Definition Projects</link> (ver. 1)</simpara>
+    <simpara>
+
+. For each listed project dependency of type "definition", a corresponding dependency (in the (dev)dependencies section) must be declared, whose "name" matches the "definesPackage" property value of the definition project.</simpara>
+</requirement>
+</section>
+</section>
+<section xml:id="_support-for-npm-scopes" role="language-n4js">
+<title>Support for NPM Scopes</title>
+<simpara>NPM supports a namespace concept for npm packages. Such namespaces are called "scopes". For details see
+<link xl:href="https://docs.npmjs.com/misc/scope">https://docs.npmjs.com/misc/scope</link> and <link xl:href="https://docs.npmjs.com/getting-started/scoped-packages">https://docs.npmjs.com/getting-started/scoped-packages</link>.
+In N4JS, this is supported too.</simpara>
+<simpara>Terminology:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>A project&#8217;s <emphasis>plain project name</emphasis> is its name without mentioning the project&#8217;s scope (if any),
+e.g. <literal>myProject</literal>.</simpara>
+</listitem>
+<listitem>
+<simpara>A project&#8217;s <emphasis>scope name</emphasis> is the name of the npm scope a project resides in, including a leading <literal>@</literal>.
+E.g. <literal>@myScope</literal>.</simpara>
+</listitem>
+<listitem>
+<simpara>A project&#8217;s <emphasis>N4JS project name</emphasis> is its plain project name, prefixed by its scope name (if any),
+separated by a <literal>/</literal>. For unscoped projects, this is identical to the plain project name.
+E.g., <literal>myProject</literal> (if unscoped), <literal>@myScope/myProject</literal> (if scoped).</simpara>
+</listitem>
+<listitem>
+<simpara>A project&#8217;s <emphasis>Eclipse project name</emphasis> is an ancillary name used only within the Eclipse UI for
+the project in the workspace. It is equal to the N4JS project name, except that <literal>:</literal> instead of <literal>/</literal> is
+used as separator between the scope and plain project name.
+E.g., <literal>myProject</literal> (if unscoped), <literal>@myScope:myProject</literal> (if scoped).</simpara>
+</listitem>
+</orderedlist>
+<simpara>In case the intended meaning is apparent from the context, the "N4JS project name" can simply be referred to
+as "project name" (as is common practice in the context of npm).</simpara>
+<simpara>In N4JS, when importing from a module <literal>M</literal> contained in a scoped project <literal>@myScope/myProject</literal>, the import statement&#8217;s
+module specifier should have one of the following forms:</simpara>
+<itemizedlist>
+<listitem>
+<simpara><literal>import * as N from "a/b/c/M";</literal></simpara>
+</listitem>
+<listitem>
+<simpara><literal>import * as N from "@myScope/myProject/a/b/c/M";</literal></simpara>
+</listitem>
+<listitem>
+<simpara><literal>import * as N from "@myScope/myProject";</literal> (if <literal>M</literal> is specified as main module in `myProject&#8217;s package.json)</simpara>
+</listitem>
+</itemizedlist>
+<simpara>Thus, the N4JS project name, which includes the scope name, is simply used in place of an ordinary, non-scoped
+project&#8217;s name. This is in line with conventions in Javascript.</simpara>
+<requirement xml:id="GH-1026">
+<title>General Constraints</title>
+<simpara>
+<anchor xml:id="Req-GH-1026" xreflabel="[Req-GH-1026]"/>
+<emphasis role="strong">Requirement: GH-1026:</emphasis>
+<link linkend="Req-GH-1026">General Constraints</link> (ver. 1)</simpara>
+    <simpara>
+
+1. The name given in the package.json file (i.e. value of top-level property "name") must be equal to
+   the project&#8217;s "N4JS project name", as defined above.
+2. The name of the project folder on disk (i.e. folder containing the package.json file) must be equal to
+   the project&#8217;s "plain project name", as defined above.
+3. Iff the project is scoped, this project folder must have a parent folder with a name equal to
+   the project&#8217;s "scope name", including the leading <literal>@</literal>.
+4. Within Eclipse, the name of of an N4JS project in the workspace UI must be equal to the project&#8217;s
+   "Eclipse project name", as defined above.</simpara>
+</requirement>
+</section>
+<section xml:id="sec:N4JS-Type-Definitions">
+<title>N4JS Type Definitions</title>
+<simpara>N4JS projects can depend on ordinary JavaScript projects by including them in the package.json file.
+From there on, modules of those JavaScript projects can be imported when writing N4JS code.
+However, since JavaScript is untyped there will not be any type information for e.g. classes, functions
+of ordinary JavaScript projects unless this type information is provided by a type definition project.
+Type definition projects do only contain n4jsd files that reflect the classes and functions of a specific npm.
+To refer to a JavaScript npm, the term <emphasis>plain-JS project</emphasis> will be used.</simpara>
+<section xml:id="_specify-type-definition">
+<title>Specify Type Definition</title>
+<simpara>A type definition project is structured like a normal npm.
+The major difference is that it provides n4jsd files instead of js files.
+These n4jsd files are named like and located at the exact position in the file tree as their js-counterparts.
+This ensures the type definition module and the corresponding plain-JS module to have the same fully-qualified name.
+Besides the usual properties the package.json file usually needs to specify the following properties in the n4js section.</simpara>
+<formalpara>
+<title>Package.json: Important properties for type definition projects</title>
+<para>
+<screen>{
+	"n4js": {
+		"projectType": "definition"
+		"definesPackage": "..."
+		"mainModule": "..."
+	}
+}</screen>
+</para>
+</formalpara>
+<simpara>The project type declares this project to be a type definition projects.
+Consequently, it has to also declare the name for which plain-JS project its type definitions are provided (using <literal>definesPackage</literal>).
+Lastly, the main module has to be specified since this information will not be taken from the package.json of the plain-JS project.</simpara>
+<simpara>A type definition project may only define a main module if the corresponding plain-JS project defines a main module. In this case,
+the main module of the type definition project may have a different fully-qualified name / module specifier (but should, of course,
+define the types provided by the plain-JS project&#8217;s main module). This is possible, because in client code the import of a main
+module will always look the same, no matter the main module&#8217;s fully-qualified name / module specifier.</simpara>
+</section>
+<section xml:id="_name-conventions">
+<title>Name Conventions</title>
+<simpara>A type definition package can have an arbitrary name and define an arbitrary npm package.
+This can be handy for testing purposes or just creating some temporary type definitions for a local package.
+However, we chose to use a convention to simplify finding the right type definition package for a specific plain-JS project.
+First, the scope <literal>@n4jsd</literal> and second the exact name of the plain-JS project is used.
+For instance, when a user wants to install type definitions for the plain-JS project <literal>express</literal>,
+our related type definitions are called <literal>@n4jsd/express</literal>.</simpara>
+</section>
+<section xml:id="_version-conventions">
+<title>Version Conventions</title>
+<simpara>Since the plain-JS project will evolve over time and publish different versions, the need arises to also
+publish the type definition project in different versions that reflect this evolution.
+In addition to the evolution of the plain-JS project, a new version of the type definition project can
+also become necessary in case a bug in the type definitions was found or in case the language of N4JS changes
+and the type definitions have to be adjusted accordingly.
+Effectively, this will lead to a situation where both the implementation and the type definition project have
+a version that are technically unrelated from an npm point of view, but still are somehow related to each other
+from a semantical point of view.
+To keep the distinct versioning of both of the projects manageable,
+we propose the following conventions to partially align the type definition project&#8217;s version to that of the plain-JS project.</simpara>
+<section xml:id="_define-a-new-type-definition-package">
+<title>Define a New Type Definition Package</title>
+<simpara>We use the following convention to compute the version of type definition packages.</simpara>
+<simpara>&#160;&#160;&#160;&#160; Major<subscript>types</subscript>.Minor<subscript>types</subscript>.Patch<subscript>types</subscript> = Major<subscript>impl</subscript>.Minor<subscript>impl</subscript>.0</simpara>
+<simpara>&#160;&#160;&#160;&#160; Major<subscript>types</subscript>.Minor<subscript>types</subscript>.Patch<subscript>types</subscript> = 3.3.0</simpara>
+<simpara>Let&#8217;s say that a new version of a type definition package called <emphasis>types</emphasis> should be created
+that defines types for an npm called <emphasis>impl</emphasis> of version Major<subscript>impl</subscript>.Minor<subscript>impl</subscript>.Patch<subscript>impl</subscript>.
+According to our convention, the major and minor version numbers of the type definition package
+should just be copied from the version of the <emphasis>impl</emphasis> package.
+However, the version patch number of <emphasis>types</emphasis> should not be taken from <emphasis>impl</emphasis>.
+Instead, the patch number of <emphasis>types</emphasis> starts with <emphasis>0</emphasis> and increases with every update of this type definition version.
+For instance when a bug was found in version Major<subscript>types</subscript>.Minor<subscript>types</subscript>.0, the definitions have been extended, or
+adjusted to new language features, only the patch number increases to e.g. Major<subscript>types</subscript>.Minor<subscript>types</subscript>.1.</simpara>
+</section>
+<section xml:id="_using-a-type-definition-package">
+<title>Using a Type Definition Package</title>
+<simpara>On the client side, a type definition package is listed among the dependency section.
+Here we use the following convention to specify the required version of a type definition package.</simpara>
+<simpara>"dependencies": {<?asciidoc-br?>
+&#160;&#160;&#160;&#160; "@n4jsd/Types": "&lt;=Major<subscript>impl</subscript>.Minor<subscript>impl</subscript>.*"<?asciidoc-br?>
+}</simpara>
+<simpara>"dependencies": {<?asciidoc-br?>
+&#160;&#160;&#160;&#160; "express": "^3.3.3",<?asciidoc-br?>
+&#160;&#160;&#160;&#160; "@n4jsd/express": "&lt;=3.3.*"<?asciidoc-br?>
+}</simpara>
+<simpara>According to this convention, the major and minor version numbers of the implementation package are used,
+prepended with a smaller-equals and appended with an asterisk for the patch number.
+This also applies when the implementation version contains a tilde, a caret, etc., or is omitting a minor or patch number.
+In case a non SemVer version is given (e.g. <literal>latest</literal>, empty string, url, etc.)
+it is recommended to plain copy the non SemVer version when possible.</simpara>
+</section>
+<section xml:id="_rational">
+<title>Rational</title>
+<simpara>The rational behind this convention reflects the idea of semantic versioning:</simpara>
+<blockquote>
+<attribution>
+<link xl:href="https://www.semver.org">semver.org</link>
+</attribution>
+<simpara>Given a version number MAJOR.MINOR.PATCH, increment the:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>MAJOR version when you make incompatible API changes,</simpara>
+</listitem>
+<listitem>
+<simpara>MINOR version when you add functionality in a backwards-compatible manner, and</simpara>
+</listitem>
+<listitem>
+<simpara>PATCH version when you make backwards-compatible bug fixes.</simpara>
+</listitem>
+</itemizedlist>
+</blockquote>
+<simpara>Patch version increments are always backwards compatible according to SemVer.
+In addition also no further functionality is added since this would imply at least an increment of the minor version.
+Consequently, patch versions do not affect the interface or type information of an plain-JS project.
+This is why patch version number fully suffices to reflect bug fixes and language changes for a given major.minor version.</simpara>
+<simpara>On client side, we recommend to use a smaller-equals qualifier because most probably there will not be the exact version
+of a requested type definition project.
+Instead, only some major.minor versions will have a type definition counterpart.
+Using a smaller-equals qualifier will make sure that a client will always get the latest version of a requested plain-JS project version.
+In case a newer version of the plain-JS project was already published,
+this convention guarantees that a compatible version of the type definition project is installed.</simpara>
+</section>
+</section>
+</section>
+<section xml:id="_modules" role="language-n4js">
+<title>Modules</title>
+<simpara>Each N4JS source file defines a module in the sense of ECMAScript2015, [<link linkend="ECMA15a">ECMA15a(p.S14)</link>].
+This is the overall structure of a module, based on [<link linkend="ECMA15a">ECMA15a(p.S14)</link>].</simpara>
+<programlisting language="xtext" linenumbering="unnumbered">Script: {Script}
+    annotations+=ScriptAnnotation*
+    scriptElements+=ScriptElement*;
+
+/*
+ * The top level elements in a script are type declarations, exports, imports or statements
+ */
+ScriptElement:
+      AnnotatedScriptElement
+    | N4ClassDeclaration&lt;Yield=false&gt;
+    | N4InterfaceDeclaration&lt;Yield=false&gt;
+    | N4EnumDeclaration&lt;Yield=false&gt;
+    | ImportDeclaration
+    | ExportDeclaration
+    | RootStatement&lt;Yield=false&gt;
+;</programlisting>
+<simpara>Grammar and semantics of import statement is described in <xref linkend="_import-statement"/>; of export statement described in <xref linkend="_export-statement"/>.</simpara>
+<simpara>An import statement imports a variable declaration, function declaration, or N4 type declaration defined and exported by another module into the current
+module under the given alias (which is similar to the original name if no alias is defined).
+The name of the module is its project’s source folder’s relative path without any extension, see <xref linkend="_qualified-names"/> for details.</simpara>
+</section>
+<section xml:id="_api-and-implementation-component" role="language-n4js">
+<title>API and Implementation Component</title>
+<note>
+<simpara>the API/Implementation concept is not fully implemented at this time (see GH-1291).</simpara>
+</note>
+<simpara>Instead of providing an implementation, N4JS components may only define an API by way of one or more n4jsd files which is then implemented by separate implementation projects.
+For one such API project, several implementation projects may be provided.
+Client code using the API will always be bound to the API project only, i.e. only the API project will appear in the client project’s <literal>package.json</literal> file under <literal>dependencies</literal>.
+When launching the client code, the launcher will choose an appropriate implementation for each API project in the client code’s direct or indirect dependencies
+and transparently replace the API project by the implementation project.
+In other words, instead of the API project’s output folder, the implementation project’s output folder will be put on the class path.
+Static compile time validations ensure that the implementation projects comply to their corresponding API project.</simpara>
+<simpara>Note how this concept can be seen as an alternative way of providing the implementation for an n4jsd file: usually n4jsd files are used to define types
+that are implemented in plain JavaScript code or provided by the runtime; this concept allows for providing the implementation of an n4jsd file in form of ordinary N4JS code.</simpara>
+<simpara>At this time, the concept of API and implementation components is in a prototype phase and the tool support is limited.
+The goal is to gain experience from using the early prototype support and then refine the concept over time.</simpara>
+<simpara>Here is a summary of the most important details of this concept (they
+are all subject to discussion and change):</simpara>
+<itemizedlist>
+<listitem>
+<simpara>Support for this concept, esp. validations, should not be built into the core language but rather implemented as a separate validation/analysis tool.</simpara>
+</listitem>
+<listitem>
+<simpara>Validation is currently provided in the form of a separate view: the API / Implementation compare view.</simpara>
+</listitem>
+<listitem>
+<simpara>A project that defines one or more other projects in its <literal>package.json</literal> file under <literal>implementedProjects</literal> (cf. <xref linkend="package-json-implementedProjects"/>) is called <emphasis>implementation project</emphasis>.
+A project that has another project pointing to itself via <literal>ImplementedProjects</literal> is called <emphasis>API project</emphasis>.
+Note that, at the moment, there is no explicit definition making a project an API project.</simpara>
+</listitem>
+<listitem>
+<simpara>An implementation project must define an implementation ID in its <literal>package.json</literal> file using the <literal>implementationId</literal> property in the <literal>n4js</literal> section (cf. <xref linkend="package-json-implementationId"/>).</simpara>
+</listitem>
+<listitem>
+<simpara>For each public or public@Internal classifier or enum in an API project, there must be a corresponding type with the same fully-qualified name of the same or higher visibility in the  implementation project.
+For each member of such a type in the API, there must exist a corresponding, owned <emphasis>or</emphasis> inherited type-compatible member in the implementation type.</simpara>
+</listitem>
+<listitem>
+<simpara>Beyond type compatibility, formal parameters should have the same name on API and implementation side; however, different names are legal but should be highlighted by API / Implementation tool support as a (legal) change.</simpara>
+</listitem>
+<listitem>
+<simpara>Comments regarding the state of the API or implementation may be added to the JSDoc in the source code using the special tag @apiNote.
+API / Implementation tool support should extract and present this information to the user in an appropriate form.</simpara>
+</listitem>
+<listitem>
+<simpara>If an API class <literal>C</literal> implements an interface <literal>I</literal>, it has to explicitly (re-) declare all members of <literal>I</literal> similar to the implementation.
+This is necessary for abstract classes anyway in order to distinguish the implemented methods from the non-implemented ones.
+For concrete classes, we want all members in <literal>C</literal> in order to be complete and avoid problems when the interface is changed or <literal>C</literal> is made abstract.</simpara>
+</listitem>
+</itemizedlist>
+<section xml:id="_execution-of-api-and-implementation-components">
+<title>Execution of API and Implementation Components</title>
+<simpara>When launching an N4JS component <emphasis>C</emphasis> under runtime environment <link linkend="AC">RE</link>, the user may(!) provide an implementation ID <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>I</mi><mspace width="-0.167em"/><mi>I</mi><mspace width="-0.167em"/><mi>D</mi></math> to run.
+Then, for each API project <emphasis>A</emphasis> in the direct or indirect dependencies of <emphasis>C</emphasis> an implementation project is chosen as follows:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>Collect all implementation projects for <emphasis>A</emphasis> (i.e. projects that specify <emphasis>A</emphasis> in their <literal>package.json</literal> file under <literal>implementedProjects</literal>).</simpara>
+</listitem>
+<listitem>
+<simpara>Remove implementation projects that cannot be run under runtime environment <link linkend="AC">RE</link>, using the same logic as for running ordinary N4JS components (this step is not implemented yet!).</simpara>
+</listitem>
+<listitem>
+<simpara>If there are no implementation projects left, show an error.</simpara>
+</listitem>
+<listitem>
+<simpara>If <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>I</mi><mspace width="-0.167em"/><mi>I</mi><mspace width="-0.167em"/><mi>D</mi></math> is defined (i.e. user specified an implementation ID to run), then:</simpara>
+<orderedlist numeration="loweralpha">
+<listitem>
+<simpara>If there is an implementation project left with implementation ID <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>I</mi><mspace width="-0.167em"/><mi>I</mi><mspace width="-0.167em"/><mi>D</mi></math>, use that.</simpara>
+</listitem>
+<listitem>
+<simpara>Otherwise, show an error.</simpara>
+</listitem>
+</orderedlist>
+</listitem>
+<listitem>
+<simpara>If <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>I</mi><mspace width="-0.167em"/><mi>I</mi><mspace width="-0.167em"/><mi>D</mi></math> is undefined, then</simpara>
+<orderedlist numeration="loweralpha">
+<listitem>
+<simpara>If there is exactly 1 implementation project left, use it.</simpara>
+</listitem>
+<listitem>
+<simpara>Otherwise, in UI mode prompt the user for a choice, in headless mode  how an error.</simpara>
+</listitem>
+</orderedlist>
+</listitem>
+</orderedlist>
+<simpara>Having found an implementation project <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>I</mi><mi>n</mi></msub></math> for each API project <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>A</mi><mi>n</mi></msub></math>, launch as usual except that whenever <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>A</mi><mi>n</mi></msub></math>’s output folder would be used, use <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>I</mi><mi>n</mi></msub></math>’s
+output folder (esp. when constructing a <literal>class path</literal>) and when loading or importing a type from <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>A</mi><mi>n</mi></msub></math> return the corresponding type with the same fully-qualified name from <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>I</mi><mi>n</mi></msub></math>.</simpara>
+</section>
+<section xml:id="_api-and-implementation-with-di" role="language-n4js">
+<title>API and Implementation With DI</title>
+<simpara>API projects may use N4JS DI (<xref linkend="_dependency-injection"/>) language features which require Implementation projects to provide DI-compatible behaviour
+in order to allow a Client (implemented against an API project) to be executed with a given Implementation project.
+This is essential for normal execution and for test execution.</simpara>
+<simpara><xref linkend="diag_APITestsDI_Overview"/> shows some of those considerations from test client point of view.</simpara>
+<figure xml:id="diag_APITestsDI_Overview">
+<title>Overview of API tests with DI</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/12_components/fig/diag_ApiTestsDI_Overview.svg"/>
+</imageobject>
+<textobject><phrase>diag ApiTestsDI Overview</phrase></textobject>
+</mediaobject>
+</figure>
+<simpara>Static DI mechanisms in N4JS allow an API project to enforce Implementation projects to provide all necessary information.
+This allows clients to work seamlessly with various implementations without specific knowledge about them or without relying on extra tools for proper project wiring.</simpara>
+<simpara><xref linkend="diag_ApiTestsDI_StaticDI"/> shows how API project defines project wiring and enforces certain level of testability.</simpara>
+<figure xml:id="diag_ApiTestsDI_StaticDI">
+<title>API tests with static DI</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/12_components/fig/diag_ApiTestsDI_StaticDI.svg"/>
+</imageobject>
+<textobject><phrase>diag ApiTestsDI StaticDI</phrase></textobject>
+</mediaobject>
+</figure>
+<simpara>During Client execution, weather it is test execution or not, N4JS mechanisms will replace the API project with a proper Implementation project.
+During runtime DI mechanisms will take care of providing proper instances of implantation types.</simpara>
+<simpara><xref linkend="diag_ApiTestsDI_Views"/> shows Types View perspective of the client, and Instances View perspective of the client.</simpara>
+<figure xml:id="diag_ApiTestsDI_Views">
+<title>Types view and Instances view</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/12_components/fig/diag_ApiTestsDI_Views.svg" width="80%" scalefit="1" align="center"/>
+</imageobject>
+<textobject><phrase>diag ApiTestsDI Views</phrase></textobject>
+</mediaobject>
+</figure>
+</section>
+</section>
+</chapter>
+<chapter xml:id="_plainjs">
+<title>PlainJS</title>
+<simpara>Since N4JS is a super set of JavaScript, is it both possible to use plain JavaScript in N4JS and vice versa.
+There may be some obstacles due to concepts introduced by N4JS to make code more maintainable and robust:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>N4JS’ static type system may complain about some older JavaScript hacks. Declared types, in particular, are assumed to be implicitly frozen.</simpara>
+</listitem>
+<listitem>
+<simpara>In N4JS, modules are used as namespaces with explicit export and import statements.
+The notion of globals is not directly supported by N4JS as this leads to unexpected side effects (several components providing and thus overriding global definitions, for example).</simpara>
+</listitem>
+<listitem>
+<simpara>N4JS defines a (ECMAScript 6 compatible) concept of object-oriented programming which may conflict with other plain JavaScript solutions.</simpara>
+</listitem>
+</orderedlist>
+<simpara>To overcome these problems, N4JS provides a couple of techniques summarized in this chapter.</simpara>
+<section xml:id="_type-inference-and-validation-for-plain-js" role="language-n4js">
+<title>Type Inference and Validation for Plain JS</title>
+<simpara>In plain JavaScript mode:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>All declared variables are inferred to <literal>any+</literal>.</simpara>
+</listitem>
+<listitem>
+<simpara>All declared functions return and accept a variadic number of arguments of type <literal>any+</literal>.</simpara>
+</listitem>
+<listitem>
+<simpara>It is allowed to use the <literal>return</literal> statement with or without an expression.</simpara>
+</listitem>
+<listitem>
+<simpara>New expressions with a receiver of <literal>any+</literal> is allowed.</simpara>
+</listitem>
+<listitem>
+<simpara>No type arguments are required for generic built-in types.</simpara>
+</listitem>
+<listitem>
+<simpara>Assigning a value to a read-only variable is not checked.</simpara>
+</listitem>
+<listitem>
+<simpara>Undeclared variables are treated as <literal>any+</literal> as well.</simpara>
+</listitem>
+</orderedlist>
+<simpara>Note that this essentially disables all validation particularly since methods such as the ’import’-like function <literal>require</literal> are unknown.</simpara>
+</section>
+<section xml:id="_external-declarations" role="language-n4js">
+<title>External Declarations</title>
+<simpara>N4JS supports declaring external classes as a means to declare classes whose implementation is not N4JS so they can be used from N4JS.
+Together with structural typing, this allows N4JS to seamlessly integrate frameworks and libraries which have not been implemented in N4JS but in plain ECMAScript or another language.</simpara>
+<requirement xml:id="IDE-163">
+<title>External allowed occurrences</title>
+<simpara>
+<anchor xml:id="Req-IDE-163" xreflabel="[Req-IDE-163]"/>
+<emphasis role="strong">Requirement: IDE-163:</emphasis>
+<link linkend="Req-IDE-163">External allowed occurrences</link> (ver. 1)</simpara>
+    <simpara>
+</simpara>
+<itemizedlist>
+<listitem>
+<simpara>Declarations with external flags are only allowed in files with the extension <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>n</mi><mn>4</mn><mi>j</mi><mi>s</mi><mi>d</mi></math> (so called N4JS definition files).</simpara>
+</listitem>
+<listitem>
+<simpara>Only external classes, external interfaces marked with <literal>@N4JS</literal>, external enums, external function declarations and structurally typed interfaces are allowed in a <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>n</mi><mn>4</mn><mi>j</mi><mi>s</mi><mi>d</mi></math> file.</simpara>
+</listitem>
+<listitem>
+<simpara>Declarations with external flags are allowed to subclass built-in type <literal>Error</literal> type and all of its descendants such as
+<literal>EvalError</literal>, <literal>RangeError</literal>, <literal>ReferenceError</literal>, <literal>SyntaxError</literal>, <literal>TypeError</literal> and <literal>URIError</literal>, although any of the error types are annotated with <literal>@N4JS</literal>.</simpara>
+</listitem>
+</itemizedlist>
+<simpara>The following explanations apply to all external declarations except
+where stated otherwise.</simpara>
+<simpara>In general, an external declaration uses the same syntax as the declaration of a normal N4JS declaration with the addition of the modifier <literal>external</literal>.</simpara>
+<simpara>External classifiers are always ’entirely external’ in that it is not possible to combine defined methods and external methods within a single class or interface.</simpara>
+</requirement>
+<requirement xml:id="IDE-164">
+<title>External classes inheritance</title>
+<simpara>
+<anchor xml:id="Req-IDE-164" xreflabel="[Req-IDE-164]"/>
+<emphasis role="strong">Requirement: IDE-164:</emphasis>
+<link linkend="Req-IDE-164">External classes inheritance</link> (ver. 1)</simpara>
+    <simpara>
+
+1.  An external class <emphasis>without</emphasis> the <literal>@N4JS</literal> annotation can only inherit from another external class or from one of the built-in ECMAScript types (e.g. Object).
+That is, by default external classes are derived from <literal>Object</literal>.
+2.  An external class <emphasis>with</emphasis> the annotation <literal>@N4JS</literal> can only inherit from another external class annotated with <literal>@N4JS</literal> or from non-external N4JS classes.</simpara>
+</requirement>
+<requirement xml:id="IDE-165">
+<title>Structurally typed interface implementation</title>
+<simpara>
+<anchor xml:id="Req-IDE-165" xreflabel="[Req-IDE-165]"/>
+<emphasis role="strong">Requirement: IDE-165:</emphasis>
+<link linkend="Req-IDE-165">Structurally typed interface implementation</link> (ver. 1)</simpara>
+    <simpara>
+
+1.  An external class <emphasis>without</emphasis> the annotation <literal>@N4JS</literal> can only be implemented by structurally typed interfaces.
+2.  An external class <emphasis>with</emphasis> the annotation <literal>@N4JS</literal> can only be implemented by structurally typed interfaces annotated with <literal>@N4JS</literal>.
+3.  An external interface <emphasis>without</emphasis> the annotation <literal>@N4JS</literal> must be defined structurally.</simpara>
+</requirement>
+<requirement xml:id="IDE-166">
+<title>External interface inheritance</title>
+<simpara>
+<anchor xml:id="Req-IDE-166" xreflabel="[Req-IDE-166]"/>
+<emphasis role="strong">Requirement: IDE-166:</emphasis>
+<link linkend="Req-IDE-166">External interface inheritance</link> (ver. 1)</simpara>
+    <simpara>
+</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>An interface in a n4jsd file <emphasis>without</emphasis> the annotation <literal>@N4JS</literal> can only inherit from another interface within a n4jsd file.</simpara>
+</listitem>
+<listitem>
+<simpara>An interface <emphasis>with</emphasis> the <literal>@N4JS</literal> annotation can only inherit from another interface annotated with <literal>@N4JS</literal>.</simpara>
+</listitem>
+</orderedlist>
+</requirement>
+<requirement xml:id="IDE-167">
+<title>External class/interface members</title>
+<simpara>
+<anchor xml:id="Req-IDE-167" xreflabel="[Req-IDE-167]"/>
+<emphasis role="strong">Requirement: IDE-167:</emphasis>
+<link linkend="Req-IDE-167">External class/interface members</link> (ver. 1)</simpara>
+    <simpara>
+
+1.  The static and instance methods, getters and setters of an external class must not have a method body.
+2.  The static and instance fields of an external class must not have an initializer.
+3.  The constructor of an external class without the annotation <literal>@N4JS</literal> must not be declared private.
+4.  Methods in interfaces with default implementation which cannot be expressed in the definition file must be annotated with <literal>@ProvidesDefaultImplementation</literal>.
+This is only allowed in interfaces annotated with <literal>@N4JS</literal>.
+5.  Fields in interfaces or classes with initializers which cannot be expressed in the definition file, must be annotated with <literal>@ProvidesInitializer</literal>.
+This is only allowed in classes or interfaces annotated with <literal>@N4JS</literal>.</simpara>
+<simpara>This means that in external classes, all members except constructors may be declared private even if the class is not annotated with <literal>@N4JS</literal>. In interfaces, however, private members are disallowed anyway,
+cf. <xref linkend="Req-IDE-48"/>.</simpara>
+</requirement>
+<requirement xml:id="IDE-168">
+<title>Other external declarations</title>
+<simpara>
+<anchor xml:id="Req-IDE-168" xreflabel="[Req-IDE-168]"/>
+<emphasis role="strong">Requirement: IDE-168:</emphasis>
+<link linkend="Req-IDE-168">Other external declarations</link> (ver. 1)</simpara>
+    <simpara>
+</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>The literals of an external enum must not have a value.</simpara>
+</listitem>
+<listitem>
+<simpara>An external function declaration must not have a body.</simpara>
+</listitem>
+</orderedlist>
+</requirement>
+<section xml:id="_declaring-externals">
+<title>Declaring externals</title>
+<simpara>By default, the implicit supertype of an external class is Object.
+If the <literal>@N4JS</literal> annotation is provided it is N4Object.
+If a superclass is explicitly given, the constraints from the previous section apply.</simpara>
+</section>
+<section xml:id="_instantiating-external-classes">
+<title>Instantiating external classes</title>
+<simpara>In most cases, it is desirable to instantiate external classes from external projects.
+Publicly exporting the class definition and providing a public constructor is good practice.</simpara>
+<simpara>In some cases, the instantiation from an outer scope is not wanted.
+A possible approach is to use a structurally typed interface instead of a class to link to the implementation.</simpara>
+<simpara>In case of API-definitions (see <xref linkend="_api-and-implementation-components"/>), it might be useful to limit the visibility of classes to narrower scopes such as package or private.</simpara>
+<simpara>External declarations can be instantiated if the following three requirements are fulfilled (not a constraint!):</simpara>
+<itemizedlist>
+<listitem>
+<simpara>External declarations have to be exported and be marked as public so they are accessible from outside.</simpara>
+</listitem>
+<listitem>
+<simpara>The contained or inherited constructor of an external class must be public.</simpara>
+</listitem>
+<listitem>
+<simpara>The external class must be linked to an implementation module (see below <xref linkend="_implementation-of-external-declarations"/>).</simpara>
+</listitem>
+</itemizedlist>
+</section>
+<section xml:id="_implementation-of-external-declarations">
+<title>Implementation of External Declarations</title>
+<simpara>All external declarations must be associated with an external implementation module in one way or another.
+Any time the external declaration is imported, the compiler generates code that imports the corresponding implementation module at runtime.</simpara>
+<simpara>There are two possible ways of linking an external declaration to its corresponding implementation:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>By naming convention defined in the <literal>package.json</literal> file.</simpara>
+</listitem>
+<listitem>
+<simpara>By declaring that the implementation is provided by the JavaScript runtime, see <xref linkend="_runtime-definitions"/> for details.</simpara>
+</listitem>
+</orderedlist>
+<simpara>The naming convention is based on the <literal>external</literal> source fragments defined in the <literal>package.json</literal> file (<xref linkend="package-json"/>).
+If the implementation is provided by the runtime directly, then this can be also specified in the <literal>package.json</literal> file by a module filter.</simpara>
+<simpara>The implicit link via the naming convention is used to link an external class declaration to its non-N4JS implementation module.
+It does not effect validation, but only compilation and runtime.
+Essentially, this makes the compiler generate code so that at runtime, the linked implementation module is imported instead of the declaration module.</simpara>
+<simpara>In most use cases of external declarations you also want to disable validation and module wrapping by specifying appropriate filters in the <literal>package.json</literal> file.</simpara>
+<simpara>Occasionally it is not possible for the validation to correctly detect a corresponding implementation element.
+For that reason, it is possible to disable validation of implementations completely via <literal>@@IgnoreImplementation</literal>.</simpara>
+<requirement xml:id="IDE-169">
+<title>Implementation of External Declarations</title>
+<simpara>
+<anchor xml:id="Req-IDE-169" xreflabel="[Req-IDE-169]"/>
+<emphasis role="strong">Requirement: IDE-169:</emphasis>
+<link linkend="Req-IDE-169">Implementation of External Declarations</link> (ver. 1)</simpara>
+    <simpara>
+</simpara>
+<simpara>For a given external declaration <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>D</mi></math> but not for
+API-definitions <footnote><simpara><xref linkend="_api-and-implementation-components"/></simpara></footnote>, the
+following constraints must hold:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>If the declaration is neither provided by runtime nor validation of implementation is disabled,
+a corresponding implementation must be found by the naming convention.
+If no such implementation is found, a warning is generated.</simpara>
+</listitem>
+</orderedlist>
+</requirement>
+<example xml:id="external-definitions-and-implementations">
+<title>External Definitions and Their Implementations</title>
+<simpara>If, in addition to standard <literal>source</literal>, the <literal>source-external</literal> fragment is provided in <literal>Sources</literal>, <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>n</mi><mn>4</mn><mi>j</mi><mi>s</mi><mi>d</mi></math> files in the folder tree below source folders
+will be related to modules of the same name in the external folders. This is shown in <xref linkend="fig-external-class-naming"/>.</simpara>
+<figure xml:id="fig-external-class-naming">
+<title>External Class Implementation, Naming Convention</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/13_plainJS/fig/externalClassImplementation_naming.svg" width="60%" scalefit="1" align="center"/>
+</imageobject>
+<textobject><phrase>externalClassImplementation naming</phrase></textobject>
+</mediaobject>
+</figure>
+</example>
+</section>
+<section xml:id="_example">
+<title>Example</title>
+<simpara>Assume the following non-N4JS module:</simpara>
+<example xml:id="ex:External_Classes_Example">
+<title>External Classes</title>
+<programlisting language="javascript" linenumbering="unnumbered">module.exports = {
+    "Point": function Point(x, y) {
+        this.x = x;
+        this.y = y;
+    },
+
+    "Circle": function Circle(center, radius) {
+        this.center = center;
+        this.radius = radius;
+        this.scaleX = function(x){ this.x = x; }
+    this.scaleY= function(y){ this.y = y; }
+    }
+}</programlisting>
+<simpara>Assuming</simpara>
+<itemizedlist>
+<listitem>
+<simpara><literal>shapes.js</literal> is placed in project folder <emphasis role="strong">/external/a/b/shapes.js</emphasis></simpara>
+</listitem>
+<listitem>
+<simpara><literal>shapes.n4jsd</literal> is placed in project folder <emphasis role="strong">/src/a/b/shapes.n4jsd</emphasis></simpara>
+</listitem>
+<listitem>
+<simpara><literal>package.json</literal> defines <emphasis role="strong">src</emphasis> as source folder and <emphasis role="strong">external</emphasis> as external source folder</simpara>
+</listitem>
+</itemizedlist>
+<simpara>the following N4JS external class declarations in <emphasis role="strong">shapes.n4jsd</emphasis> are sufficient:</simpara>
+<programlisting language="javascript" linenumbering="unnumbered">export external public class Point {
+    x: number; y: number;
+    constructor(x: number, y: number);
+}
+
+export external public class Circle {
+    center: Point; radius: number;
+    constructor(center: Point, radius: number);
+}</programlisting>
+<simpara>Note that the class and interface names in n4jsd files must match those in the js files, respectively.</simpara>
+</example>
+<example>
+<title>Structurally-typed external interfaces</title>
+<programlisting language="javascript" linenumbering="unnumbered">export external public interface ~Scalable {
+    scaleX(factor: number);
+    scaleY(factor: number);
+}
+
+export external public class Circle implements Scalable {
+    center: Point;
+    radius: number; x: number; y: number;
+
+    @Override public scaleX(factor: number);
+    @Override public scaleY(factor: number);
+
+    constructor(center: Point, radius: number);
+}</programlisting>
+</example>
+</section>
+</section>
+<section xml:id="_global-definitions" role="language-n4js">
+<title>Global Definitions</title>
+<simpara>Existing JavaScript libraries and built-in objects provided by certain JavaScript environments often globally define variables.
+Although it is not recommended to use global definitions, this cannot always be avoided.</simpara>
+<simpara>N4JS supports global definitions via the annotation <literal>Global</literal>.
+This annotation can only be defined on modules (via <literal>@@Global</literal>) – this means that all declarations in the module are
+globally defined.<footnote><simpara>Global basically means that the module defines no namespace on its own. Thus the annotation is a script/module related annotation.</simpara></footnote></simpara>
+<simpara>We introduce a new pseudo property <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>g</mi><mi>l</mi><mi>o</mi><mi>b</mi><mi>a</mi><mi>l</mi></math> on all declared elements accordingly:</simpara>
+<variablelist>
+<varlistentry>
+<term><literal>@Global</literal> </term>
+<listitem>
+<simpara>Boolean flag set to true if annotation <literal>@Global</literal> is set in containing module. The flag indicates that the exported element is globally available and must not be imported.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+<simpara>Since definition of global elements is not supported by N4JS directly, this can be only used in external definitions.
+A declaration with <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>g</mi><mi>l</mi><mi>o</mi><mi>b</mi><mi>a</mi><mi>l</mi></math> can be used without explicit import statement. It is not possible to import these declarations.</simpara>
+<requirement xml:id="IDE-170">
+<title>Global Definitions</title>
+<simpara>
+<anchor xml:id="Req-IDE-170" xreflabel="[Req-IDE-170]"/>
+<emphasis role="strong">Requirement: IDE-170:</emphasis>
+<link linkend="Req-IDE-170">Global Definitions</link> (ver. 1)</simpara>
+    <simpara>
+
+Global Definitions</simpara>
+<simpara>For a declaration <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>D</mi></math> with <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>D</mi><mo>.</mo><mi>g</mi><mi>l</mi><mi>o</mi><mi>b</mi><mi>a</mi><mi>l</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>true</mtext></mstyle></math>, not a polyfill (<math xmlns="http://www.w3.org/1998/Math/MathML"><mrow><mi>D</mi><mo>.</mo><mi>p</mi><mi>o</mi><mi>l</mi><mi>y</mi><mi>f</mi><mi>i</mi><mi>l</mi><mi>l</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>false</mtext></mstyle><mo>)</mo></mrow></math>, the following constraints must hold:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>The name of the definition must not be equal to any primitive type (<literal>string</literal>, <literal>number</literal> etc.), <literal>any</literal>, or an built-in N4 type (<literal>N4Object</literal> etc.).</simpara>
+</listitem>
+<listitem>
+<simpara>If the name of the definition equals a basic runtime time Object Type then the project must be a runtime environment:</simpara>
+</listitem>
+</orderedlist>
+<simpara><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>D</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>∈</mo><mrow><mo>{</mo></mrow></math>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><msup><mspace width="3.0em"/><mi>'</mi></msup><mi>O</mi><mi>b</mi><mi>j</mi><mi>e</mi><mi>c</mi><msup><mi>t</mi><mi>'</mi></msup><msup><mo>,</mo><mi>'</mi></msup><mi>F</mi><mi>u</mi><mi>n</mi><mi>c</mi><mi>t</mi><mi>i</mi><mi>o</mi><msup><mi>n</mi><mi>'</mi></msup><msup><mo>,</mo><mi>'</mi></msup><mi>A</mi><mi>r</mi><mi>r</mi><mi>a</mi><msup><mi>y</mi><mi>'</mi></msup><msup><mo>,</mo><mi>'</mi></msup><mi>S</mi><mi>t</mi><mi>r</mi><mi>i</mi><mi>n</mi><msup><mi>g</mi><mi>'</mi></msup><msup><mo>,</mo><mi>'</mi></msup><mi>B</mi><mi>o</mi><mi>o</mi><mi>l</mi><mi>e</mi><mi>a</mi><msup><mi>n</mi><mi>'</mi></msup></math>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><msup><mspace width="3.0em"/><mi>'</mi></msup><mi>N</mi><mi>u</mi><mi>m</mi><mi>b</mi><mi>e</mi><msup><mi>r</mi><mi>'</mi></msup><msup><mo>,</mo><mi>'</mi></msup><mi>M</mi><mi>a</mi><mi>t</mi><msup><mi>h</mi><mi>'</mi></msup><msup><mo>,</mo><mi>'</mi></msup><mi>D</mi><mi>a</mi><mi>t</mi><msup><mi>e</mi><mi>'</mi></msup><msup><mo>,</mo><mi>'</mi></msup><mi>R</mi><mi>e</mi><mi>g</mi><mi>E</mi><mi>x</mi><msup><mi>p</mi><mi>'</mi></msup><msup><mo>,</mo><mi>'</mi></msup><mi>E</mi><mi>r</mi><mi>r</mi><mi>o</mi><msup><mi>r</mi><mi>'</mi></msup><msup><mo>,</mo><mi>'</mi></msup><mi>J</mi><mi>S</mi><mi>O</mi><msup><mi>N</mi><mi>'</mi></msup></math>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mrow><mo>}</mo></mrow></math>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mo>⇒</mo><mi>D</mi><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>t</mi><mi>a</mi><mi>i</mi><mi>n</mi><mi>i</mi><mi>n</mi><mi>g</mi><mi>P</mi><mi>r</mi><mi>o</mi><mi>j</mi><mi>e</mi><mi>c</mi><mi>t</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>runtimeEnvironment</mtext></mstyle></math></simpara>
+</requirement>
+</section>
+<section xml:id="_runtime-definitions" role="language-n4js">
+<title>Runtime Definitions</title>
+<simpara>Some elements are predefined by the JavaScript runtime such as DOM elements by the browser or built-in ECMAScript or non-standard objects.
+These elements can be defined by means of external definitions; however, no actual implementation can be provided as these elements are actually provided by the runtime itself.</simpara>
+<simpara>Since these cases are rather rare and in order to enable additional checks such as verification that a given runtime actually provides the elements,
+this kind of element can only be defined in components of type runtime environment or runtime library (cf <xref linkend="_runtime-environment-and-runtime-libraries"/>).</simpara>
+<simpara>N4JS supports runtime definitions via the annotation <literal>@ProvidedByRuntime</literal>.
+This annotation can be defined</simpara>
+<itemizedlist>
+<listitem>
+<simpara>on modules (via <literal>@@ProvidedByRuntime</literal>)– this means that all declarations in the module are provided by the runtime</simpara>
+</listitem>
+<listitem>
+<simpara>on export statements or declarations.</simpara>
+</listitem>
+</itemizedlist>
+<simpara>We introduce a new pseudo property <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>p</mi><mi>r</mi><mi>o</mi><mi>v</mi><mi>i</mi><mi>d</mi><mi>e</mi><mi>d</mi><mi>B</mi><mi>y</mi><mi>R</mi><mi>u</mi><mi>n</mi><mi>t</mi><mi>i</mi><mi>m</mi><mi>e</mi></math> accordingly:</simpara>
+<variablelist>
+<varlistentry>
+<term><literal>@ProvidedByRuntime</literal> </term>
+<listitem>
+<simpara>Boolean flag set to true if the annotation <literal>@ProvidedByRuntime</literal> is set.
+Flag indicates that the element is only declared in the module but its implementation is provided by the runtime.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+<simpara>Since built-in types are usually defined globally, the annotation <literal>@ProvidedByRuntime</literal> is usually used in combination with <literal>@Global</literal>.</simpara>
+<requirement xml:id="IDE-171">
+<title>Provided By Runtime</title>
+<simpara>
+<anchor xml:id="Req-IDE-171" xreflabel="[Req-IDE-171]"/>
+<emphasis role="strong">Requirement: IDE-171:</emphasis>
+<link linkend="Req-IDE-171">Provided By Runtime</link> (ver. 1)</simpara>
+    <simpara>
+</simpara>
+<simpara>For a declaration <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>D</mi></math> with <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>D</mi><mo>.</mo><mi>p</mi><mi>r</mi><mi>o</mi><mi>v</mi><mi>i</mi><mi>d</mi><mi>e</mi><mi>d</mi><mi>B</mi><mi>y</mi><mi>R</mi><mi>u</mi><mi>n</mi><mi>t</mi><mi>i</mi><mi>m</mi><mi>e</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>true</mtext></mstyle></math>, the following constraints must hold:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>The declaration must either be an export declaration itself or an exportable declaration.</simpara>
+</listitem>
+<listitem>
+<simpara>The declaration must be contained in a definition module.</simpara>
+</listitem>
+<listitem>
+<simpara>The declaration must be (indirectly) contained in a component of type <math xmlns="http://www.w3.org/1998/Math/MathML"><mstyle mathvariant="monospace"><mtext>runtimeEnvironment</mtext></mstyle></math> or <math xmlns="http://www.w3.org/1998/Math/MathML"><mstyle mathvariant="monospace"><mtext>runtimeLibrary</mtext></mstyle></math>.</simpara>
+</listitem>
+<listitem>
+<simpara>There must be no implementation file with the same name as the definition module if annotation is defined for a whole module.</simpara>
+</listitem>
+</orderedlist>
+</requirement>
+</section>
+<section xml:id="_applying-polyfills" role="language-n4js">
+<title>Applying Polyfills</title>
+<simpara>(Runtime) Libraries often do not provide completely new types but modify existing types.
+The ECMA-402 Internationalization Standard [<link linkend="ECMA12a">ECMA12a</link>], for example, changes methods of the built-in class <literal>Date</literal> to be timezone-aware.
+Other scenarios include new functionality provided by browsers which are not part of an official standard yet.
+Even ECMAScript 6 [<link linkend="ECMA15a">ECMA15a</link>] extends the predecessor [<link linkend="ECMA11a">ECMA11a</link>] in terms of new methods or new method parameters added to existing types.
+It also adds completely new classes and features, of course.</simpara>
+<simpara>The syntax of runtime polyfills is described in section <xref linkend="_polyfill-definitions"/>.
+Here, an example of applying a runtime polyfill is detailed.</simpara>
+<example>
+<title>Object.observe with Polyfill</title>
+<simpara>The following snippet demonstrates how to define a polyfill of the built-in class <literal>Object</literal> to add the new ECMAScript 7 observer functionality.
+This snippet has to be defined in a runtime library or environment.</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">@@ProvidedByRuntime
+@@Global
+
+@Polyfill
+export external public class Object extends Object {
+    public static Object observe(Object object, Function callback, Array&lt;string&gt;? accept);
+
+}</programlisting>
+<simpara>A client referring to this runtime library (or environment) can now access the observer methods as if it were defined directly in the original declaration of <literal>Object</literal>.</simpara>
+</example>
+</section>
+</chapter>
+<chapter xml:id="_jsdoc-2">
+<title>JSDoc</title>
+<simpara role="language-n4js">In N4JS, comments starting with two asterisks (in <literal>/** .. */</literal>) are interpreted as
+documentation comments. The format is similar to JavaDoc or Google
+Closure annotations.</simpara>
+<section xml:id="_general-n4jsdoc-features" role="language-n4js">
+<title>General N4JSDoc Features</title>
+<simpara>We distinguish between line and inline tags.
+The format of the content of a tag is specific to the tag.
+Most line tags, however, contain a description which is simply multiline text with nested inline tags.
+Every comment may start with a description.</simpara>
+<section xml:id="_provided-inline-tags">
+<title>Provided Inline Tags</title>
+<section xml:id="jsdoc_tag__code">
+<title>@code</title>
+<simpara>Small code snippet, not validated yet.</simpara>
+</section>
+<section xml:id="jsdoc_tag__link">
+<title>@link</title>
+<simpara>Link to a type of element, not validated or supported in navigation yet.</simpara>
+</section>
+</section>
+</section>
+<section xml:id="_n4jsdoc-for-user-projects" role="language-n4js">
+<title>N4JSdoc for User Projects</title>
+<section xml:id="_standard-tags">
+<title>Standard Tags</title>
+<section xml:id="_-author">
+<title>@author</title>
+<simpara>Name of author, repeat for multiple authors. Name of author is not
+validated.</simpara>
+</section>
+<section xml:id="jsdoc_tag_param">
+<title>@param</title>
+<simpara>Parameter description, not validated at the moment.</simpara>
+</section>
+<section xml:id="jsdoc_tag_return">
+<title>@return</title>
+<simpara>Return description, not validated at the moment.</simpara>
+</section>
+</section>
+<section xml:id="_test-related-tags">
+<title>Test Related Tags</title>
+<simpara>The following tags are supposed to be used only in tests.</simpara>
+<section xml:id="jsdoc_tag__testee">
+<title>@testee</title>
+<simpara>Link to type (maybe a function) or member tested by the test.</simpara>
+<requirement xml:id="IDE-172">
+<title>@testee Semantics</title>
+<simpara>
+<anchor xml:id="Req-IDE-172" xreflabel="[Req-IDE-172]"/>
+<emphasis role="strong">Requirement: IDE-172:</emphasis>
+<link linkend="Req-IDE-172">@testee Semantics</link> (ver. 1)</simpara>
+    <simpara>
+
+.  Tag can be only used on either
+..  methods annotated with <literal>@Test</literal>
+..  classes in test projects or folders, cf. <xref linkend="jsdoc_tag__testeeFromType"/>.
+.  Tag requires a single argument, which is a fully qualified name to a type, including the module specifier.
+The format is as follows: <literal>moduleSpecifier '.' typeName ( ('.'|'#') memberName)?</literal>
+.  Tag is <emphasis>not</emphasis> repeatable, that is a single test method (or class) can refer to only one testee.
+.  Tag precedes the <literal>reqid</literal> tag, i.e., if a <literal>@testee</literal> is specified, the <literal>reqid</literal> will be ignored.</simpara>
+</requirement>
+<example>
+<title>@testee</title>
+<simpara>The target element is to be fully qualified including the module specifier. The module specifier is simply
+the source folder relative path name with forward slashes. Type and
+element are added to that using dot as a separator. For example:</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">/**
+ * @testee some/package/Module.Type.member
+ */</programlisting>
+</example>
+</section>
+<section xml:id="jsdoc_tag__testeeFromType">
+<title>@testeeFromType</title>
+<simpara>Instead of directly linking a test method to a testee, the testee is to
+be derived from the linked testee of the test class. This is useful if a
+base test class is defined with generic tests, e.g., for testing methods
+defined in an interface and implemented by some classes. This base test
+class is then extended by concrete test classes, correctly setting up
+the test fixture, e.g., creating instances of some classes implementing
+the interfaces tested in the base class.</simpara>
+<example>
+<title>Usage of testeeFromType</title>
+<simpara>In the following example, the is used. This tag will lead to a test documentation for <literal>B.foo</literal> and <literal>C.foo</literal>.</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">abstract class Base {
+    /**
+     * @testeeFromType
+     */
+    @Test testFoo() {..}
+}
+
+/**
+ * @testee B.foo
+ */
+class TestB extends Base {}
+
+/**
+ * @testee C.foo
+ */
+class TestC extends Base {}</programlisting>
+</example>
+<note>
+<simpara>The resulting spec has to be double-checked for consistency
+since it is easily possible that too many constraints are generated.</simpara>
+</note>
+</section>
+<section xml:id="_testeeType_and__testeeMember">
+<title>@testeeType and @testeeMember</title>
+<simpara>Specifying the testee at the test method directly should be sufficient
+for most cases. The <literal>@testeeFromType</literal> tag already provides support for some cases in which a base test class is reused by subtypes. This case usually only works if
+the base test class tests a single method only. If the base test class
+tests several methods and if a sub test class only provides a different
+fixture, this mechanism is not sufficient. For that purpose, the two
+tags <literal>@testeeFromType</literal> and <literal>@@testeeMember</literal> are to be used.
+They enable the separation of a test related to a specific member and the concrete receiver type of the tested member.</simpara>
+<simpara>The <literal>@testeeType</literal> is to defined in the test class JSDoc (actually, it is not
+recognized when defined in a member JSDoc). The <literal>@testeeMember</literal> is specified in the test method JSDoc. The "real" testee is then computed from the testee type and the testee method.</simpara>
+<note>
+<simpara>1. This only works for instance members, so far!<?asciidoc-br?>
+2. There is no validation for invalid combinations!</simpara>
+</note>
+<example xml:id="ex:testeetype-and-testeemethod">
+<title>testeeType and testeeMethod</title>
+<simpara>Assume the following testees:</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">class A {
+    foo(): void {..}
+    bar(): void { .. this.foo(); ..}
+}
+class B extends A {
+    @Override foo() { .. }
+}</programlisting>
+</example>
+<simpara>Assume that the tests have to ensure the same semantics for <literal>bar</literal>, which is
+maybe changed by a wrong implementation of <literal>foo</literal>. That is, <literal>bar</literal> is to be tested in
+case of the receiver type <literal>A</literal> and <literal>B</literal>. This can be achieved by the following
+tests:</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">/**
+ * @testeeType A.A
+ */
+class ATest {
+    fixture(): A { return new A(); }
+
+    /**
+     * @testeeMember bar
+     */
+    @Test testBar(): void { assertBehavior( fixture().bar() ); }
+}
+/**
+ * @testeeType B.B
+ */
+class BTest extends ATest {
+    @Override fixture(): B { return new B(); }
+}</programlisting>
+<simpara>This actually defines two tests, which is also recognized by the spec
+exporter:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara><literal>testBar</literal> for a receiver of type <literal>A</literal>:</simpara>
+<simpara><literal>ATest</literal>'s JSDoc <literal>@testeeType</literal> + <literal>ATest.testBar</literal>'s JSDoc <literal>@testeeMember</literal> = testee <literal>A.A.bar</literal></simpara>
+</listitem>
+<listitem>
+<simpara><literal>testBar</literal> for a receiver of type <literal>B</literal>:</simpara>
+<simpara><literal>BTest</literal>'s JSDoc <literal>@testeeType</literal> + <literal>ATest.testBar</literal>'s JSDoc <literal>@testeeMember</literal> = testee <literal>B.B.bar</literal></simpara>
+</listitem>
+</orderedlist>
+<note>
+<simpara>In all cases when <literal>@testeeFromType</literal> or <literal>@testeeType</literal>/<literal>@testeeMember</literal> is used, the resulting spec has to be
+double-checked for consistency. Consider if the multiplication of spec
+constraints is truly required, in particular if the original semantics
+of a method is not changed. Remember: It is possible to write API tests
+and omit the spec constraint generation simply by not adding the testee
+links.</simpara>
+</note>
+<example>
+<title>testeeType and testeeMethod with omitted constraints</title>
+<simpara>Assume testees similar as in <xref linkend="ex:testeetype-and-testeemethod"/>. Since the semantics of <literal>bar</literal> is not changed in <literal>B</literal>, it is probably not necessary to generate the same constraint in the documentation for <literal>bar</literal> twice (one in the section for class <literal>A</literal> and another one in the section of class <literal>B</literal>).
+Still, we want the test to be executed for both receivers. This is how it is achieved:</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">abstract class BaseTest {
+    abstract fixture(): A;
+
+    /**
+     * @testeeMember bar
+     */
+    @Test testBar(): void { assertBehavior( fixture().bar() ); }
+}
+
+/**
+ * @testeeType A.A
+ */
+class ATest extends BaseTest {
+    fixture(): A { return new A(); }
+}
+
+class BTest extends BaseTest {
+    @Override fixture(): B { return new B(); }
+}</programlisting>
+<simpara>This actually defines two tests as in the previous example. Only one
+constraint is created in the spec by the spec exporter:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara><literal>testBar</literal> for a receiver of type <literal>A</literal>:<?asciidoc-br?>
+<literal>ATest</literal>'s JSDoc <literal>@testeeType</literal> + <literal>BaseTest.testBar</literal>'s JSDoc <literal>@testeeMember</literal> = testee <literal>A.A.bar</literal></simpara>
+</listitem>
+</orderedlist>
+<simpara>Although a test for receiver of type <literal>B</literal> is run, no additional constraint is
+created since there is no <literal>@testeeType</literal> available neither in <literal>BTest</literal> nor in <literal>BaseTest</literal>.</simpara>
+</example>
+</section>
+<section xml:id="jsdoc_tag_reqid_in_Tests">
+<title>@reqid in Tests</title>
+<simpara>ID of feature used in <literal>JSDoc</literal> for the requirements section. If no
+testee (via one of the tags above) is given, then the test is linked to
+the requirement with given id.</simpara>
+</section>
+</section>
+</section>
+<section xml:id="_n4jsdoc-for-api-and-implementation-projects" role="language-n4js">
+<title>N4JSDoc for API and Implementation Projects</title>
+<simpara>The following tags are supposed to be used in API and implementation
+projects.</simpara>
+<section xml:id="jsdoc_tag__apiNote">
+<title>@apiNote</title>
+<simpara>Simple note that is shown in the API compare view.</simpara>
+</section>
+<section xml:id="API_Project_Tags">
+<title>API Project Tags</title>
+<simpara>The following tags are supposed to be used in API projects only.</simpara>
+<section xml:id="jsdoc_tag_apiState">
+<title>@apiState</title>
+<simpara>State of type or member definition, e.g., stable or draft. This can be
+used to define a history. In this case, the tag has to be repeated. For
+example:</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">/**
+ * @apiState stable (WK)
+ * @apiState reviewed (JvP)
+ */</programlisting>
+</section>
+</section>
+</section>
+</chapter>
+<chapter xml:id="_jsx">
+<title>JSX</title>
+<section xml:id="_jsx-support" role="language-jsx">
+<title>JSX Support</title>
+<simpara>N4JS scripts with file extension "n4jsx" support the special <link xl:href="https://facebook.github.io/jsx/">JSX syntax</link>. Files ending with "jsx" are considered as plain Javascript.</simpara>
+<requirement xml:id="IDE-241101">
+<title>React Component</title>
+<simpara>
+<anchor xml:id="Req-IDE-241101" xreflabel="[Req-IDE-241101]"/>
+<emphasis role="strong">Requirement: IDE-241101:</emphasis>
+<link linkend="Req-IDE-241101">React Component</link> (ver. 1)</simpara>
+    <simpara>
+
+There are two ways of defining a React component:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>functional component: A function is a React component, iff</simpara>
+<itemizedlist>
+<listitem>
+<simpara>its return type is React.Element</simpara>
+</listitem>
+<listitem>
+<simpara>the function has at least one parameter. This first parameter is considered as the <literal>props</literal> property.
+The type of the first parameter only has public fields (or methods defined by Object).
+The fields may be defined as optional.</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+<listitem>
+<simpara>class component: A class is a React component, iff</simpara>
+<itemizedlist>
+<listitem>
+<simpara>it extends <literal>React.Component</literal>.</simpara>
+</listitem>
+<listitem>
+<simpara>the type parameters must be structural types.</simpara>
+<itemizedlist>
+<listitem>
+<simpara>The first parameter defines the <literal>props</literal> type, it must only define public fields (or methods defined by Object)</simpara>
+</listitem>
+<listitem>
+<simpara>The second parameter defines the <literal>state</literal> type, it must only define public fields (or methods defined by Object)</simpara>
+</listitem>
+</itemizedlist>
+</listitem>
+</itemizedlist>
+</listitem>
+</itemizedlist>
+<simpara>In both cases, the name must be capitalized (i.e., start with an upper case letter).</simpara>
+</requirement>
+<simpara>Component must be written capitalized (i.e. first letter upper case), html (or other xml elements) must be written lower case.</simpara>
+<requirement xml:id="IDE-241102">
+<title>JSX Basic Syntax</title>
+<simpara>
+<anchor xml:id="Req-IDE-241102" xreflabel="[Req-IDE-241102]"/>
+<emphasis role="strong">Requirement: IDE-241102:</emphasis>
+<link linkend="Req-IDE-241102">JSX Basic Syntax</link> (ver. 1)</simpara>
+    <simpara>
+</simpara>
+<simpara>The following JSX syntax is supported (EBNF with model element assignments as used in Xtext). All other ECMAScript 2015 and N4JS syntax constructs are unaffected by this addition.</simpara>
+<programlisting language="xtext" linenumbering="unnumbered">PrimaryExpression &lt;Yield&gt; returns n4js::Expression:
+	... // as in N4JS
+	| JSXElement
+;
+
+JSXElement:
+	'&lt;' jsxElementName=JSXElementName JSXAttributes
+	(('&gt;' jsxChildren+=JSXChild* JSXClosingElement) | ('/' '&gt;'));
+
+fragment JSXClosingElement *:
+	'&lt;' '/' jsxClosingName=JSXElementName '&gt;';
+
+JSXChild:
+	JSXElement | JSXExpression
+;
+
+JSXExpression: '{' expression=AssignmentExpression&lt;false,false&gt; '}';
+
+JSXElementName:
+	expression=JSXElementNameExpression
+	;
+
+JSXElementNameExpression returns n4js::Expression:
+	IdentifierRef&lt;false&gt;
+	({n4js::ParameterizedPropertyAccessExpression.target=current} ParameterizedPropertyAccessExpressionTail&lt;false&gt;)*
+;
+
+fragment JSXAttributes *:
+	jsxAttributes+=JSXAttribute*;
+
+JSXAttribute:
+	JSXSpreadAttribute
+	|
+	JSXPropertyAttribute;
+
+JSXSpreadAttribute:
+	'{' '...' expression=AssignmentExpression&lt;false,false&gt; '}';
+
+JSXPropertyAttribute:
+	property=[types::IdentifiableElement|IdentifierName] '=' (jsxAttributeValue=StringLiteral | ('{'
+	jsxAttributeValue=AssignmentExpression&lt;false,false&gt; '}'));</programlisting>
+<simpara>This syntax is similar to the syntax defined by <link xl:href="https://facebook.github.io/jsx/">JSX</link>, except that</simpara>
+<itemizedlist>
+<listitem>
+<simpara>JSXNamedspaceName is not supported</simpara>
+</listitem>
+<listitem>
+<simpara>JSXText is not supported, instead, string template literals are to be used</simpara>
+</listitem>
+</itemizedlist>
+</requirement>
+<simpara>Remarks on differences between the syntax defined in <xref linkend="Req-IDE-241102"/> and <link xl:href="https://facebook.github.io/jsx/">JSX</link>:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>JSXSelfClosingElement, JSXOpeningElement and JSXClosingElement are merged into one single rule JSXElement</simpara>
+</listitem>
+<listitem>
+<simpara>JSXAttributes is defined as fragment, that is, the attributes become fields of the JSXElement</simpara>
+</listitem>
+<listitem>
+<simpara>The different types of JSXElementName are defined by means of JSXElementNameExpression which is a simple expression, reusing the existing rules IdentifierRef and ParameterizedPropertyAccessExpression to model JSXIdentifer and JSXMemberExpression respectively</simpara>
+</listitem>
+<listitem>
+<simpara>JSXPropertyAttribute models the JSX non-spread JSXAttribute definition; again existing rules (IdentifierName, StringLiteral) are used to model JSX specific ones (JSXAttributeName, JSXDoubleStringCharacters, JSXSingleStringCharacters)</simpara>
+</listitem>
+</itemizedlist>
+<requirement xml:id="IDE-241401">
+<title>JSX Syntax With Free Text</title>
+<simpara>
+<anchor xml:id="Req-IDE-241401" xreflabel="[Req-IDE-241401]"/>
+<emphasis role="strong">Requirement: IDE-241401:</emphasis>
+<link linkend="Req-IDE-241401">JSX Syntax With Free Text</link> (ver. 1)</simpara>
+    <simpara>
+</simpara>
+<programlisting language="xtext" linenumbering="unnumbered">JSXChild:
+	JSXElement | JSXExpression | JSXText
+;</programlisting>
+</requirement>
+<requirement xml:id="IDE-241103">
+<title>JSX Extended Syntax Check</title>
+<simpara>
+<anchor xml:id="Req-IDE-241103" xreflabel="[Req-IDE-241103]"/>
+<emphasis role="strong">Requirement: IDE-241103:</emphasis>
+<link linkend="Req-IDE-241103">JSX Extended Syntax Check</link> (ver. 1)</simpara>
+    <simpara>
+
+* It is an error, if corresponding opening and closing JSXElements have different names.</simpara>
+</requirement>
+<requirement xml:id="IDE-241113">
+<title>JSX Expression Type</title>
+<simpara>
+<anchor xml:id="Req-IDE-241113" xreflabel="[Req-IDE-241113]"/>
+<emphasis role="strong">Requirement: IDE-241113:</emphasis>
+<link linkend="Req-IDE-241113">JSX Expression Type</link> (ver. 1)</simpara>
+    <simpara>
+
+The type of a JSX expression is React.Element.</simpara>
+</requirement>
+<requirement xml:id="IDE-241114">
+<title>React Symbol</title>
+<simpara>
+<anchor xml:id="Req-IDE-241114" xreflabel="[Req-IDE-241114]"/>
+<emphasis role="strong">Requirement: IDE-241114:</emphasis>
+<link linkend="Req-IDE-241114">React Symbol</link> (ver. 1)</simpara>
+    <simpara>
+
+If a JSX literal is used, it is an error if the React symbol is not imported via</simpara>
+<programlisting language="jsx" linenumbering="unnumbered">import React from "react"</programlisting>
+</requirement>
+<requirement xml:id="IDE-241115">
+<title>JSXElement names (tags)</title>
+<simpara>
+<anchor xml:id="Req-IDE-241115" xreflabel="[Req-IDE-241115]"/>
+<emphasis role="strong">Requirement: IDE-241115:</emphasis>
+<link linkend="Req-IDE-241115">JSXElement names (tags)</link> (ver. 1)</simpara>
+    <simpara>
+
+* It is an error if a capitalized tag cannot be bound to a function or class declaration.</simpara>
+</requirement>
+<requirement xml:id="IDE-241116">
+<title>JSXElements referring to React components</title>
+<simpara>
+<anchor xml:id="Req-IDE-241116" xreflabel="[Req-IDE-241116]"/>
+<emphasis role="strong">Requirement: IDE-241116:</emphasis>
+<link linkend="Req-IDE-241116">JSXElements referring to React components</link> (ver. 1)</simpara>
+    <simpara>
+
+* It is an error, if a tag binds to a function declaration, which is not conform to the functional component definition.
+* It is an error, if a tag binds to a class declaration, which is not conform to the class component definition.</simpara>
+</requirement>
+<requirement xml:id="IDE-241117">
+<title>JSXAttributes and React component properties</title>
+<simpara>
+<anchor xml:id="Req-IDE-241117" xreflabel="[Req-IDE-241117]"/>
+<emphasis role="strong">Requirement: IDE-241117:</emphasis>
+<link linkend="Req-IDE-241117">JSXAttributes and React component properties</link> (ver. 1)</simpara>
+    <simpara>
+
+If the tag binds to a component, the following constraints must hold:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>The attribute must be a non-private field of the properties type.</simpara>
+</listitem>
+<listitem>
+<simpara>The tag should define attributes for all non-optional fields of the properties type. If no attribute is defined for a non-optional field, a warning is issued.</simpara>
+</listitem>
+<listitem>
+<simpara>The type of the attribute expression must be conform to the type of the corresponding <literal>props</literal>'s property</simpara>
+</listitem>
+</itemizedlist>
+</requirement>
+<requirement xml:id="IDE-241118">
+<title>JSXElements referring to XML elements</title>
+<simpara>
+<anchor xml:id="Req-IDE-241118" xreflabel="[Req-IDE-241118]"/>
+<emphasis role="strong">Requirement: IDE-241118:</emphasis>
+<link linkend="Req-IDE-241118">JSXElements referring to XML elements</link> (ver. 1)</simpara>
+    <simpara>
+
+If the lower-case tag does not bind to a function or class declaration, the following constraints must be hold:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>If the tag is neither a pre-defined HTML tag nor an SVG tag, a warning is issued.</simpara>
+</listitem>
+<listitem>
+<simpara>If an attribute of the tag is not a pre-defined property of the html tag or react specific attributes, a warning is issued. This requirement is currently NOT supported.</simpara>
+</listitem>
+</itemizedlist>
+</requirement>
+<requirement xml:id="IDE-241119">
+<title>JSXSpreadAttribute behavior</title>
+<simpara>
+<anchor xml:id="Req-IDE-241119" xreflabel="[Req-IDE-241119]"/>
+<emphasis role="strong">Requirement: IDE-241119:</emphasis>
+<link linkend="Req-IDE-241119">JSXSpreadAttribute behavior</link> (ver. 1)</simpara>
+    <simpara>
+
+The use of spread operators within an JSX element for specifying multiple attributes should be allowed. In this case, all constraints regarding type conformity checking and non-optional properties mentioned in <xref linkend="Req-IDE-241117"/> apply to the attributes specified in the spread operator. In particular,</simpara>
+<itemizedlist>
+<listitem>
+<simpara>The type of each attribute specified in spread operator must be conform to the type of the corresponding property of <literal>props</literal>.</simpara>
+</listitem>
+<listitem>
+<simpara>If a non-optional property of <literal>props</literal> is specified neither as attribute nor in a spread operator, a warning is issued.</simpara>
+</listitem>
+</itemizedlist>
+</requirement>
+</section>
+<section xml:id="_jsx-backend">
+<title>JSX Backend</title>
+<simpara>The support for JSX in N4JS aims for an implementation that adheres to the idea of <link xl:href="https://reactjs.org/docs/jsx-in-depth.html">React JSX</link>. This means that JSX elements are transpiled to React Element factory calls (e.g. <literal>&lt;div prop="c"&gt;content&lt;/div&gt;</literal> transpiles to <literal>React.createElement('div', {prop: "c"}, null)</literal>). For that, the transpiler must be aware of a specific implementation of React and the corresponding <literal>createElement</literal> function.</simpara>
+<requirement xml:id="GH-687">
+<title>React Implementation</title>
+<simpara>
+<anchor xml:id="Req-GH-687" xreflabel="[Req-GH-687]"/>
+<emphasis role="strong">Requirement: GH-687:</emphasis>
+<link linkend="Req-GH-687">React Implementation</link> (ver. 1)</simpara>
+    <simpara>
+
+A react implementation is given in terms of a module that fulfils the following properties:</simpara>
+<itemizedlist>
+<listitem>
+<simpara>The FQN of the module is <literal>react</literal>.</simpara>
+</listitem>
+<listitem>
+<simpara>Type definitions are available for the module.</simpara>
+</listitem>
+<listitem>
+<simpara>The module exports a function of name <literal>createElement</literal>.</simpara>
+</listitem>
+</itemizedlist>
+</requirement>
+<simpara>If a react implementation is declared as project dependency, the N4JS transpiler automatically imports it to the module using JSX and generates the corresponding factory calls.</simpara>
+</section>
+</chapter>
+<chapter xml:id="_grammars">
+<title>Grammars</title>
+<simpara>N4JS extends the ECMAScript 2015 language grammar and combines it with type expression.</simpara>
+<note>
+<simpara>These grammars are slightly simplified versions of the "real" Xtext grammars used in the implementation.
+These grammars are post-processed and combined with additional validators so not all constructs are necessarily available in N4JS.</simpara>
+</note>
+<section xml:id="_type-expressions-grammar">
+<title>Type Expressions Grammar</title>
+<formalpara xml:id="lst:EBNFTypeExpression">
+<title>EBNF Type Expression Grammar</title>
+<para>
+<programlisting language="xtext" linenumbering="unnumbered">TypeRef:
+    TypeRefWithoutModifiers =&gt;undefModifier=UndefModifierToken?
+    | undefModifier=UndefModifierToken;
+
+TypeRefWithoutModifiers:
+      ((ParameterizedTypeRef | ThisTypeRef) =&gt; dynamic?='+'?)
+    | ConstructorTypeRef
+    | ClassifierTypeRef
+    | FunctionTypeExpression
+    | UnionTypeExpression
+    | IntersectionTypeExpression;
+
+TypeRefFunctionTypeExpression:
+      ParameterizedTypeRef
+    | ConstructorTypeRef
+    | ClassifierTypeRef
+    | UnionTypeExpression
+    | IntersectionTypeExpression
+    ;
+
+TypeRefForCast:
+      ParameterizedTypeRef
+    | ThisTypeRef
+    | ConstructorTypeRef
+    | ClassifierTypeRef
+    | FunctionTypeExpression;
+
+TypeRefInClassifierType:
+      ParameterizedTypeRefNominal
+    | ThisTypeRefNominal;
+
+
+ThisTypeRef:
+    ThisTypeRefNominal | ThisTypeRefStructural;
+
+ThisTypeRefNominal:
+    'this';
+
+ThisTypeRefStructural:
+    definedTypingStrategy=TypingStrategyUseSiteOperator
+    'this'
+    ('with' TStructMemberList)?;
+
+FunctionTypeExpression:
+    '{'
+    ('@' 'This' '(' declaredThisType=TypeRefFunctionTypeExpression ')')?
+    'function'
+    ('&lt;' ownedTypeVars+=TypeVariable (',' ownedTypeVars+=TypeVariable)* '&gt;')?
+    '(' TAnonymousFormalParameterList ')'
+    (':' returnTypeRef=TypeRef)?
+    '}';
+
+fragment TAnonymousFormalParameterList*:
+    (fpars+=TAnonymousFormalParameter (',' fpars+=TAnonymousFormalParameter)*)?
+;
+
+TAnonymousFormalParameter:
+    variadic?='...'? (=&gt; name=TIdentifier ':')? typeRef=TypeRef
+;
+
+UnionTypeExpression:
+    'union' '{' typeRefs+=TypeRefWithoutModifiers (',' typeRefs+=TypeRefWithoutModifiers)* '}';
+
+IntersectionTypeExpression:
+    'intersection' '{' typeRefs+=TypeRefWithoutModifiers (',' typeRefs+=TypeRefWithoutModifiers)* '}';
+
+ParameterizedTypeRef:
+    ParameterizedTypeRefNominal | ParameterizedTypeRefStructural;
+
+ParameterizedTypeRefStructural:
+    definedTypingStrategy=TypingStrategyUseSiteOperator
+    declaredType=[Type|TypeReferenceName]
+    (=&gt;'&lt;' typeArgs+=TypeArgument (',' typeArgs+=TypeArgument)* '&gt;')?
+    ('with' TStructMemberList)?;
+
+fragment TStructMemberList*:  '{' (astStructuralMembers+=TStructMember (';'|',')?)*  '}';
+
+TStructMember:
+      TStructGetter
+    | TStructSetter
+    | TStructMethod
+    | TStructField;
+
+TStructMethod:
+    =&gt;
+    (('&lt;' typeVars+=TypeVariable (',' typeVars+=TypeVariable)* '&gt;')?
+        name=TypesIdentifier '('
+    ) TAnonymousFormalParameterList ')'
+    (':' returnTypeRef=TypeRef)?
+;
+
+TStructField:
+    name=TypesIdentifier (':' typeRef=TypeRef)?
+;
+
+TStructGetter:
+    =&gt; ('get'
+    name=TypesIdentifier)
+    '(' ')' (':' declaredTypeRef=TypeRef)?
+;
+
+TStructSetter:
+    =&gt; ('set'
+    name=TypesIdentifier)
+    '(' fpar=TAnonymousFormalParameter ')'
+;
+
+ParameterizedTypeRefNominal:
+    declaredType=[Type|TypeReferenceName]
+    (=&gt; '&lt;' typeArgs+=TypeArgument (',' typeArgs+=TypeArgument)* '&gt;')?;
+
+TypingStrategyUseSiteOperator:
+    '~' ('~' | STRUCTMODSUFFIX)?;
+
+TypingStrategyDefSiteOperator:
+    '~';
+
+terminal STRUCTMODSUFFIX:
+    ('r' | 'i' | 'w') '~'
+;
+
+ConstructorTypeRef:
+    'constructor' '{' staticTypeRef=TypeRefInClassifierType '}';
+
+ClassifierTypeRef:
+    'type' '{' staticTypeRef=TypeRefInClassifierType '}';
+
+TypeReferenceName:
+    IDENTIFIER ('.' IDENTIFIER)*;
+
+TypeArgument:
+    Wildcard | TypeRef;
+
+Wildcard:
+    =&gt; ('?') (('extends' declaredUpperBound=TypeRef) | ('super'
+    declaredLowerBound=TypeRef))?;
+
+UndefModifierToken:
+    '?';
+
+TypeVariable:
+    name=IDENTIFIER ('extends' declaredUpperBounds+=ParameterizedTypeRef ('&amp;'
+    declaredUpperBounds+=ParameterizedTypeRef)*)?;
+
+TypesIdentifier:
+    IDENTIFIER
+    | 'get' | 'set' | 'abstract' | 'project'
+    | 'union' | 'intersection'
+    | 'as' | 'from' | 'type' | 'void' | 'null';
+
+TIdentifier:
+    TypesIdentifier
+    | 'implements' | 'interface'
+    | 'private' | 'protected' | 'public'
+    | 'static'
+;
+
+terminal IDENTIFIER:
+    IDENTIFIER_START IDENTIFIER_PART*;
+
+terminal INT:
+    DECIMAL_INTEGER_LITERAL_FRAGMENT;
+
+terminal ML_COMMENT:
+    ML_COMMENT_FRAGMENT;
+
+terminal SL_COMMENT:
+    '//' (!LINE_TERMINATOR_FRAGMENT)*;
+
+terminal EOL:
+    LINE_TERMINATOR_SEQUENCE_FRAGMENT;
+
+terminal WS:
+    WHITESPACE_FRAGMENT+;
+
+terminal fragment UNICODE_ESCAPE_FRAGMENT:
+    '\\' ('u' (
+        HEX_DIGIT (HEX_DIGIT (HEX_DIGIT HEX_DIGIT?)?)?
+      | '{' HEX_DIGIT* '}'?
+    )?)?;
+
+terminal fragment IDENTIFIER_START:
+      UNICODE_LETTER_FRAGMENT
+    | '$'
+    | '_'
+    | UNICODE_ESCAPE_FRAGMENT;
+
+terminal fragment IDENTIFIER_PART:
+      UNICODE_LETTER_FRAGMENT
+    | UNICODE_ESCAPE_FRAGMENT
+    | '$'
+    | UNICODE_COMBINING_MARK_FRAGMENT
+    | UNICODE_DIGIT_FRAGMENT
+    | UNICODE_CONNECTOR_PUNCTUATION_FRAGMENT
+    | ZWNJ
+    | ZWJ;
+
+terminal DOT_DOT:
+    '..'
+;</programlisting>
+</para>
+</formalpara>
+</section>
+<section xml:id="_n4js-language-grammar">
+<title>N4JS Language Grammar</title>
+<programlisting language="xtext" linenumbering="unnumbered">Script: annotations+=ScriptAnnotation*
+    scriptElements+=ScriptElement*;
+
+ScriptElement:
+      AnnotatedScriptElement
+    | N4ClassDeclaration&lt;Yield=false&gt;
+    | N4InterfaceDeclaration&lt;Yield=false&gt;
+    | N4EnumDeclaration&lt;Yield=false&gt;
+    | ImportDeclaration
+    | ExportDeclaration
+    | RootStatement&lt;Yield=false&gt;
+;
+
+AnnotatedScriptElement:
+    AnnotationList (
+        {ExportDeclaration.annotationList=current} ExportDeclarationImpl
+    |   {ImportDeclaration.annotationList=current} ImportDeclarationImpl
+    |   {FunctionDeclaration.annotationList=current}
+        =&gt;((declaredModifiers+=N4Modifier)* AsyncNoTrailingLineBreak
+            -&gt;FunctionImpl&lt;Yield=false,YieldIfGenerator=false,Expression=false&gt;)
+    |   (
+            (
+                {N4ClassDeclaration.annotationList=current}
+                (declaredModifiers+=N4Modifier)*
+                'class' typingStrategy=TypingStrategyDefSiteOperator?
+                name=BindingIdentifier&lt;Yield=false&gt;
+                TypeVariables?
+                ClassExtendsClause&lt;Yield=false&gt;?
+            |   {N4InterfaceDeclaration.annotationList=current}
+                (declaredModifiers+=N4Modifier)*
+                'interface' typingStrategy=TypingStrategyDefSiteOperator? name=BindingIdentifier&lt;Yield=false&gt;
+                TypeVariables?
+                InterfaceImplementsList?
+            )
+            Members&lt;Yield=false&gt;
+        )
+    |   {N4EnumDeclaration.annotationList=current}
+        (declaredModifiers+=N4Modifier)*
+        'enum' name=BindingIdentifier&lt;Yield=false&gt;
+        '{'
+            literals+=N4EnumLiteral (',' literals+= N4EnumLiteral)*
+        '}'
+    )
+;
+
+fragment TypeVariables*:
+    '&lt;' typeVars+=TypeVariable (',' typeVars+=TypeVariable)* '&gt;'
+;
+
+ExportDeclaration:
+    ExportDeclarationImpl
+;
+
+fragment ExportDeclarationImpl*:
+    'export' (
+        wildcardExport?='*' ExportFromClause Semi
+    |   ExportClause -&gt;ExportFromClause? Semi
+    |   exportedElement=ExportableElement
+    |   defaultExport?='default' (-&gt;exportedElement=ExportableElement | defaultExportedExpression=AssignmentExpression&lt;In=true,Yield=false&gt; Semi)
+    )
+;
+
+fragment ExportFromClause*:
+    'from' reexportedFrom=[types::TModule|ModuleSpecifier]
+;
+
+fragment ExportClause*:
+    '{'
+        (namedExports+=ExportSpecifier (',' namedExports+=ExportSpecifier)* ','?)?
+    '}'
+;
+
+ExportSpecifier:
+    element=IdentifierRef&lt;Yield=false&gt; ('as' alias=IdentifierName)?
+;
+
+ExportableElement:
+      AnnotatedExportableElement&lt;Yield=false&gt;
+    | N4ClassDeclaration&lt;Yield=false&gt;
+    | N4InterfaceDeclaration&lt;Yield=false&gt;
+    | N4EnumDeclaration&lt;Yield=false&gt;
+    | ExportedFunctionDeclaration&lt;Yield=false&gt;
+    | ExportedVariableStatement
+;
+
+AnnotatedExportableElement &lt;Yield&gt;:
+    AnnotationList (
+        {FunctionDeclaration.annotationList=current}
+        (declaredModifiers+=N4Modifier)* AsyncNoTrailingLineBreak
+        FunctionImpl&lt;Yield, Yield, Expression=false&gt;
+    |   {ExportedVariableStatement.annotationList=current}
+        (declaredModifiers+=N4Modifier)*
+        varStmtKeyword=VariableStatementKeyword
+        varDeclsOrBindings+=ExportedVariableDeclarationOrBinding&lt;Yield&gt; ( ',' varDeclsOrBindings+=ExportedVariableDeclarationOrBinding&lt;Yield&gt; )* Semi
+    |   (
+            (
+                {N4ClassDeclaration.annotationList=current}
+                (declaredModifiers+=N4Modifier)*
+                'class' typingStrategy=TypingStrategyDefSiteOperator?
+                name=BindingIdentifier&lt;Yield&gt;
+                TypeVariables?
+                ClassExtendsClause&lt;Yield&gt;?
+            |   {N4InterfaceDeclaration.annotationList=current}
+                (declaredModifiers+=N4Modifier)*
+                ('interface') typingStrategy=TypingStrategyDefSiteOperator? name=BindingIdentifier&lt;Yield&gt;
+                TypeVariables?
+                InterfaceImplementsList?
+            )
+            Members&lt;Yield&gt;
+        )
+    |   {N4EnumDeclaration.annotationList=current}
+        (declaredModifiers+=N4Modifier)*
+        'enum' name=BindingIdentifier&lt;Yield&gt;
+        '{'
+            literals+=N4EnumLiteral (',' literals+= N4EnumLiteral)*
+        '}'
+    )
+;
+
+ImportDeclaration:
+    ImportDeclarationImpl
+;
+
+fragment ImportDeclarationImpl*:
+    'import' (
+        ImportClause importFrom?='from'
+    )? module=[types::TModule|ModuleSpecifier] Semi
+;
+
+fragment ImportClause*:
+        importSpecifiers+=DefaultImportSpecifier (',' ImportSpecifiersExceptDefault)?
+    |   ImportSpecifiersExceptDefault
+;
+
+fragment ImportSpecifiersExceptDefault*:
+        importSpecifiers+=NamespaceImportSpecifier
+    |   '{' (importSpecifiers+=NamedImportSpecifier (',' importSpecifiers+=NamedImportSpecifier)* ','?)? '}'
+;
+
+NamedImportSpecifier:
+        importedElement=[types::TExportableElement|BindingIdentifier&lt;Yield=false&gt;]
+    |   importedElement=[types::TExportableElement|IdentifierName] 'as' alias=BindingIdentifier&lt;Yield=false&gt;
+;
+
+DefaultImportSpecifier:
+    importedElement=[types::TExportableElement|BindingIdentifier&lt;Yield=false&gt;]
+;
+
+NamespaceImportSpecifier: '*' 'as' alias=BindingIdentifier&lt;false&gt; (declaredDynamic?='+')?;
+
+ModuleSpecifier: STRING;
+
+FunctionDeclaration &lt;Yield&gt;:
+    =&gt; ((declaredModifiers+=N4Modifier)* AsyncNoTrailingLineBreak
+        -&gt; FunctionImpl &lt;Yield,Yield,Expression=false&gt;
+    ) =&gt; Semi?
+;
+
+fragment AsyncNoTrailingLineBreak *: (declaredAsync?='async' NoLineTerminator)?;
+
+fragment FunctionImpl&lt;Yield, YieldIfGenerator, Expression&gt;*:
+    'function'
+    (
+        generator?='*' FunctionHeader&lt;YieldIfGenerator,Generator=true&gt; FunctionBody&lt;Yield=true,Expression&gt;
+    |   FunctionHeader&lt;Yield,Generator=false&gt; FunctionBody&lt;Yield=false,Expression&gt;
+    )
+;
+
+fragment FunctionHeader&lt;Yield, Generator&gt;*:
+    TypeVariables?
+    name=BindingIdentifier&lt;Yield&gt;?
+    StrictFormalParameters&lt;Yield=Generator&gt;
+    (-&gt; ':' returnTypeRef=TypeRef)?
+;
+
+fragment FunctionBody &lt;Yield, Expression&gt;*:
+        &lt;Expression&gt; body=Block&lt;Yield&gt;
+    |   &lt;!Expression&gt; body=Block&lt;Yield&gt;?
+;
+
+ExportedFunctionDeclaration&lt;Yield&gt;:
+    FunctionDeclaration&lt;Yield&gt;
+;
+
+FunctionTypeExpression:
+    {types::FunctionTypeExpression}
+    '{'
+    ('@' 'This' '(' declaredThisType=TypeRefFunctionTypeExpression ')')?
+    'function'
+    ('&lt;' ownedTypeVars+=TypeVariable (',' ownedTypeVars+=TypeVariable)* '&gt;')?
+    '('
+    (fpars+=TAnonymousFormalParameter (',' fpars+=TAnonymousFormalParameter)*)?
+    ')'
+    (':' returnTypeRef=TypeRef)?
+    '}';
+
+AnnotatedFunctionDeclaration &lt;Yield, Default&gt;:
+    annotationList=AnnotationList
+    (declaredModifiers+=N4Modifier)* AsyncNoTrailingLineBreak
+    FunctionImpl&lt;Yield,Yield,Expression=false&gt;
+;
+
+
+FunctionExpression:
+         (FunctionImpl&lt;Yield=false,YieldIfGenerator=true,Expression=true&gt;
+         )
+;
+
+AsyncFunctionExpression:
+     =&gt;(declaredAsync?='async' NoLineTerminator 'function')
+        FunctionHeader&lt;Yield=false,Generator=false&gt; FunctionBody&lt;Yield=false,Expression=true&gt;
+;
+
+ArrowExpression &lt;In, Yield&gt;:
+    =&gt; (
+            (
+                    '(' (fpars+=FormalParameter&lt;Yield&gt;
+                        (',' fpars+=FormalParameter&lt;Yield&gt;)*)?
+                    ')' (':' returnTypeRef=TypeRef)?
+                |   =&gt;(declaredAsync?='async' NoLineTerminator '(')
+                    (fpars+=FormalParameter&lt;Yield&gt; (',' fpars+=FormalParameter&lt;Yield&gt;)*)?
+                    ')' (':' returnTypeRef=TypeRef)?
+                |   fpars+=BindingIdentifierAsFormalParameter&lt;Yield&gt;
+            )
+            '=&gt;'
+        )
+        (-&gt; hasBracesAroundBody?='{' body=BlockMinusBraces&lt;Yield&gt; '}'
+            | body=ExpressionDisguisedAsBlock&lt;In&gt;)
+;
+
+fragment StrictFormalParameters &lt;Yield&gt;*:
+    '(' (fpars+=FormalParameter&lt;Yield&gt; (',' fpars+=FormalParameter&lt;Yield&gt;)*)? ')'
+;
+
+BindingIdentifierAsFormalParameter &lt;Yield&gt;: name=BindingIdentifier&lt;Yield&gt;;
+
+BlockMinusBraces &lt;Yield&gt;:   statements+=Statement&lt;Yield&gt;*;
+
+ExpressionDisguisedAsBlock &lt;In&gt;:
+    statements+=AssignmentExpressionStatement&lt;In&gt;
+;
+
+AssignmentExpressionStatement &lt;In&gt;: expression=AssignmentExpression&lt;In,Yield=false&gt;;
+
+AnnotatedExpression &lt;Yield&gt;:
+    ExpressionAnnotationList (
+        {N4ClassExpression.annotationList=current}
+        'class' name=BindingIdentifier&lt;Yield&gt;?
+        ClassExtendsClause&lt;Yield&gt;?
+        Members&lt;Yield&gt;
+    |   {FunctionExpression.annotationList=current} AsyncNoTrailingLineBreak
+        FunctionImpl&lt;Yield=false,YieldIfGenerator=true,Expression=true&gt;
+    )
+;
+
+TypeVariable:
+    name=IdentifierOrThis
+    (   'extends' declaredUpperBounds+=ParameterizedTypeRefNominal
+        ('&amp;' declaredUpperBounds+=ParameterizedTypeRefNominal)*
+    )?
+;
+
+FormalParameter &lt;Yield&gt;:
+    BindingElementFragment&lt;Yield&gt;
+;
+
+fragment BindingElementFragment &lt;Yield&gt;*:
+    (=&gt; bindingPattern=BindingPattern&lt;Yield&gt;
+    | annotations+=Annotation*
+        (
+            variadic?='...'? name=BindingIdentifier&lt;Yield&gt; ColonSepTypeRef?
+        )
+    )
+    ('=' initializer=AssignmentExpression&lt;In=true, Yield&gt;)?
+;
+
+fragment ColonSepTypeRef*:
+    ':' declaredTypeRef=TypeRef
+;
+
+Block &lt;Yield&gt;: =&gt; ('{') statements+=Statement&lt;Yield&gt;* '}';
+RootStatement &lt;Yield&gt;:
+    Block&lt;Yield&gt;
+    | FunctionDeclaration&lt;Yield&gt;
+    | VariableStatement&lt;In=true,Yield&gt;
+    | EmptyStatement
+    | LabelledStatement&lt;Yield&gt;
+    | ExpressionStatement&lt;Yield&gt;
+    | IfStatement&lt;Yield&gt;
+    | IterationStatement&lt;Yield&gt;
+    | ContinueStatement&lt;Yield&gt;
+    | BreakStatement&lt;Yield&gt;
+    | ReturnStatement&lt;Yield&gt;
+    | WithStatement&lt;Yield&gt;
+    | SwitchStatement&lt;Yield&gt;
+    | ThrowStatement&lt;Yield&gt;
+    | TryStatement&lt;Yield&gt;
+    | DebuggerStatement
+;
+
+Statement &lt;Yield&gt;:
+    AnnotatedFunctionDeclaration&lt;Yield,Default=false&gt;
+    | RootStatement&lt;Yield&gt;
+;
+
+enum VariableStatementKeyword:
+    var='var' | const='const' | let='let'
+;
+
+VariableStatement &lt;In, Yield&gt;:
+    =&gt;(varStmtKeyword=VariableStatementKeyword
+    )
+    varDeclsOrBindings+=VariableDeclarationOrBinding&lt;In,Yield,false&gt;
+    (',' varDeclsOrBindings+=VariableDeclarationOrBinding&lt;In,Yield,false&gt;)* Semi
+;
+
+ExportedVariableStatement:
+    (declaredModifiers+=N4Modifier)*
+    varStmtKeyword=VariableStatementKeyword
+    varDeclsOrBindings+=ExportedVariableDeclarationOrBinding&lt;Yield=false&gt;
+    (',' varDeclsOrBindings+=ExportedVariableDeclarationOrBinding&lt;Yield=false&gt;)* Semi
+;
+
+VariableDeclarationOrBinding &lt;In, Yield, OptionalInit&gt;:
+        VariableBinding&lt;In,Yield,OptionalInit&gt;
+    |   VariableDeclaration&lt;In,Yield,true&gt;
+;
+
+VariableBinding &lt;In, Yield, OptionalInit&gt;:
+    =&gt; pattern=BindingPattern&lt;Yield&gt; (
+            &lt;OptionalInit&gt; ('=' expression=AssignmentExpression&lt;In,Yield&gt;)?
+        |   &lt;!OptionalInit&gt; '=' expression=AssignmentExpression&lt;In,Yield&gt;
+    )
+;
+
+VariableDeclaration &lt;In, Yield, AllowType&gt;:
+    VariableDeclarationImpl&lt;In,Yield,AllowType&gt;;
+
+fragment VariableDeclarationImpl &lt;In, Yield, AllowType&gt;*:
+    annotations+=Annotation*
+    (
+        &lt;AllowType&gt; =&gt;(
+            name=BindingIdentifier&lt;Yield&gt; ColonSepTypeRef?
+        ) ('=' expression=AssignmentExpression&lt;In,Yield&gt;)?
+    |   &lt;!AllowType&gt; =&gt;(
+        name=BindingIdentifier&lt;Yield&gt;
+        ) ('=' expression=AssignmentExpression&lt;In,Yield&gt;)?
+    )
+;
+
+ExportedVariableDeclarationOrBinding &lt;Yield&gt;:
+        ExportedVariableBinding&lt;Yield&gt;
+    |   ExportedVariableDeclaration&lt;Yield&gt;
+;
+
+ExportedVariableBinding &lt;Yield&gt;:
+    =&gt; pattern=BindingPattern&lt;Yield&gt; '=' expression=AssignmentExpression&lt;In=true,Yield&gt;
+;
+
+ExportedVariableDeclaration &lt;Yield&gt;:
+    VariableDeclarationImpl&lt;In=true,Yield,AllowType=true&gt;
+;
+EmptyStatement: ';';
+ExpressionStatement &lt;Yield&gt;: expression=Expression&lt;In=true,Yield&gt; Semi;
+
+IfStatement &lt;Yield&gt;: 'if' '(' expression=Expression&lt;In=true,Yield&gt; ')'
+    ifStmt=Statement&lt;Yield&gt; (=&gt; 'else' elseStmt=Statement&lt;Yield&gt;)?;
+
+IterationStatement &lt;Yield&gt;:
+        DoStatement&lt;Yield&gt;
+    |   WhileStatement&lt;Yield&gt;
+    |   ForStatement&lt;Yield&gt;
+;
+
+DoStatement &lt;Yield&gt;: 'do' statement=Statement&lt;Yield&gt; 'while'
+    '(' expression=Expression&lt;In=true,Yield&gt; ')' =&gt; Semi?;
+WhileStatement &lt;Yield&gt;: 'while' '(' expression=Expression&lt;In=true,Yield&gt; ')'
+    statement=Statement&lt;Yield&gt;;
+
+ForStatement &lt;Yield&gt;:
+    'for' '('
+    (
+            =&gt;(initExpr=LetIdentifierRef forIn?='in' expression=Expression&lt;In=true,Yield&gt; ')')
+        |   (   -&gt;varStmtKeyword=VariableStatementKeyword
+                (
+                        =&gt;(varDeclsOrBindings+=BindingIdentifierAsVariableDeclaration&lt;In=false,Yield&gt;
+                        (forIn?='in' | forOf?='of') -&gt;expression=AssignmentExpression&lt;In=true,Yield&gt;?)
+                    |   varDeclsOrBindings+=VariableDeclarationOrBinding&lt;In=false,Yield,OptionalInit=true&gt;
+                        (
+                                (',' varDeclsOrBindings+=VariableDeclarationOrBinding&lt;In=false,Yield,false&gt;)* ';'
+                                expression=Expression&lt;In=true,Yield&gt;? ';' updateExpr=Expression&lt;In=true,Yield&gt;?
+                            |   forIn?='in' expression=Expression&lt;In=true,Yield&gt;?
+                            |   forOf?='of' expression=AssignmentExpression&lt;In=true,Yield&gt;?
+                        )
+                )
+            |   initExpr=Expression&lt;In=false,Yield&gt;
+                (
+                        ';' expression=Expression&lt;In=true,Yield&gt;? ';' updateExpr=Expression&lt;In=true,Yield&gt;?
+                    |   forIn?='in' expression=Expression&lt;In=true,Yield&gt;?
+                    |   forOf?='of' expression=AssignmentExpression&lt;In=true,Yield&gt;?
+                )
+            |   ';' expression=Expression&lt;In=true,Yield&gt;? ';' updateExpr=Expression&lt;In=true,Yield&gt;?
+            )
+        ')'
+    ) statement=Statement&lt;Yield&gt;
+;
+
+LetIdentifierRef:
+    id=[types::IdentifiableElement|LetAsIdentifier]
+;
+
+LetAsIdentifier: 'let';
+
+BindingIdentifierAsVariableDeclaration &lt;In, Yield&gt;:
+    name=BindingIdentifier&lt;Yield&gt;
+;
+
+ContinueStatement &lt;Yield&gt;: 'continue' (label=[LabelledStatement|BindingIdentifier&lt;Yield&gt;])? Semi;
+
+BreakStatement &lt;Yield&gt;: 'break' (label=[LabelledStatement|BindingIdentifier&lt;Yield&gt;])? Semi;
+
+ReturnStatement &lt;Yield&gt;: 'return' (expression=Expression&lt;In=true,Yield&gt;)? Semi;
+
+WithStatement &lt;Yield&gt;: 'with' '(' expression=Expression&lt;In=true,Yield&gt; ')' statement=Statement&lt;Yield&gt;;
+
+SwitchStatement &lt;Yield&gt;:
+    'switch' '(' expression=Expression&lt;In=true,Yield&gt; ')' '{'
+    (cases+=CaseClause&lt;Yield&gt;)*
+    ((cases+=DefaultClause&lt;Yield&gt;)
+    (cases+=CaseClause&lt;Yield&gt;)*)? '}'
+;
+
+CaseClause &lt;Yield&gt;: 'case' expression=Expression&lt;In=true,Yield&gt; ':' (statements+=Statement&lt;Yield&gt;)*;
+
+DefaultClause &lt;Yield&gt;: 'default' ':' (statements+=Statement&lt;Yield&gt;)*;
+
+LabelledStatement &lt;Yield&gt;: =&gt; (name=BindingIdentifier&lt;Yield&gt; ':') statement=Statement&lt;Yield&gt;;
+
+ThrowStatement &lt;Yield&gt;:
+    'throw' expression=Expression&lt;In=true,Yield&gt; Semi;
+
+TryStatement &lt;Yield&gt;:
+    'try' block=Block&lt;Yield&gt;
+    ((catch=CatchBlock&lt;Yield&gt; finally=FinallyBlock&lt;Yield&gt;?) | finally=FinallyBlock&lt;Yield&gt;)
+;
+
+CatchBlock &lt;Yield&gt;: 'catch' '(' catchVariable=CatchVariable&lt;Yield&gt; ')' block=Block&lt;Yield&gt;;
+
+CatchVariable &lt;Yield&gt;:
+        =&gt;bindingPattern=BindingPattern&lt;Yield&gt;
+    |   =&gt;(name=BindingIdentifier&lt;Yield&gt; -&gt; ColonSepTypeRef)
+    |   name=BindingIdentifier&lt;Yield&gt;
+;
+
+FinallyBlock &lt;Yield&gt;: 'finally' block=Block&lt;Yield&gt;;
+
+DebuggerStatement:
+    'debugger' Semi;
+
+PrimaryExpression &lt;Yield&gt;:
+      ThisLiteral
+    | SuperLiteral
+    | IdentifierRef&lt;Yield&gt;
+    | ParameterizedCallExpression&lt;Yield&gt;
+    | Literal
+    | ArrayLiteral&lt;Yield&gt;
+    | ObjectLiteral&lt;Yield&gt;
+    | ParenExpression&lt;Yield&gt;
+    | AnnotatedExpression&lt;Yield&gt;
+    | FunctionExpression
+    | AsyncFunctionExpression
+    | N4ClassExpression&lt;Yield&gt;
+    | TemplateLiteral&lt;Yield&gt;
+;
+
+ParenExpression &lt;Yield&gt;: '(' expression=Expression&lt;In=true,Yield&gt; ')';
+
+IdentifierRef &lt;Yield&gt;:
+    id=[types::IdentifiableElement|BindingIdentifier&lt;Yield&gt;]
+;
+
+SuperLiteral: 'super';
+
+ThisLiteral: 'this';
+
+ArrayLiteral &lt;Yield&gt;:
+    '['
+        elements+=ArrayPadding* (
+            elements+=ArrayElement&lt;Yield&gt;
+            (',' elements+=ArrayPadding* elements+=ArrayElement&lt;Yield&gt;)*
+            (trailingComma?=',' elements+=ArrayPadding*)?
+        )?
+    ']'
+;
+
+ArrayPadding: ',';
+
+ArrayElement &lt;Yield&gt;: spread?='...'? expression=AssignmentExpression&lt;In=true,Yield&gt;;
+
+ObjectLiteral &lt;Yield&gt;: '{'
+        ( propertyAssignments+=PropertyAssignment&lt;Yield&gt;
+          (',' propertyAssignments+=PropertyAssignment&lt;Yield&gt;)* ','?
+        )?
+    '}'
+;
+
+PropertyAssignment &lt;Yield&gt;:
+      AnnotatedPropertyAssignment&lt;Yield&gt;
+    | PropertyNameValuePair&lt;Yield&gt;
+    | PropertyGetterDeclaration&lt;Yield&gt;
+    | PropertySetterDeclaration&lt;Yield&gt;
+    | PropertyMethodDeclaration&lt;Yield&gt;
+    | PropertyNameValuePairSingleName&lt;Yield&gt;
+;
+
+AnnotatedPropertyAssignment &lt;Yield&gt;:
+    PropertyAssignmentAnnotationList (
+    =&gt;( {PropertyNameValuePair.annotationList=current} declaredTypeRef=TypeRef?
+            LiteralOrComputedPropertyName&lt;Yield&gt; ':'
+        ) expression=AssignmentExpression&lt;In=true,Yield&gt;
+    | =&gt;({PropertyGetterDeclaration.annotationList=current}
+            GetterHeader&lt;Yield&gt;
+        ) body=Block&lt;Yield=false&gt;
+    | =&gt;({PropertySetterDeclaration.annotationList=current}
+            'set' -&gt;LiteralOrComputedPropertyName &lt;Yield&gt;
+        ) '(' fpar=FormalParameter&lt;Yield&gt; ')' body=Block&lt;Yield=false&gt;
+    | =&gt;({PropertyMethodDeclaration.annotationList=current}
+            TypeVariables? returnTypeRef=TypeRef?
+            (generator?='*' LiteralOrComputedPropertyName&lt;Yield&gt; -&gt;MethodParamsAndBody &lt;Generator=true&gt;
+                | LiteralOrComputedPropertyName&lt;Yield&gt; -&gt; MethodParamsAndBody &lt;Generator=false&gt;
+            )
+        ) ';'?
+    | {PropertyNameValuePairSingleName.annotationList=current}
+        declaredTypeRef=TypeRef? identifierRef=IdentifierRef&lt;Yield&gt;
+        ( '=' expression=AssignmentExpression&lt;In=true,Yield&gt;)?)
+;
+
+PropertyMethodDeclaration &lt;Yield&gt;:
+    =&gt; (TypeVariables? returnTypeRef=TypeRef?
+            (
+                generator?='*'  LiteralOrComputedPropertyName&lt;Yield&gt;
+                    -&gt;MethodParamsAndBody&lt;Generator=true&gt;
+                | LiteralOrComputedPropertyName&lt;Yield&gt; -&gt;MethodParamsAndBody &lt;Generator=false&gt;
+            )
+        )
+    ';'?
+;
+
+PropertyNameValuePair &lt;Yield&gt;:
+    =&gt; (
+        declaredTypeRef=TypeRef? LiteralOrComputedPropertyName&lt;Yield&gt; ':'
+    )
+    expression=AssignmentExpression&lt;In=true,Yield&gt;
+;
+
+PropertyNameValuePairSingleName &lt;Yield&gt;:
+    declaredTypeRef=TypeRef?
+    identifierRef=IdentifierRef&lt;Yield&gt;
+    ('=' expression=AssignmentExpression&lt;In=true,Yield&gt;)?
+;
+
+PropertyGetterDeclaration &lt;Yield&gt;:
+    =&gt;(
+        GetterHeader&lt;Yield&gt;
+    )
+    body=Block&lt;Yield=false&gt;
+;
+
+PropertySetterDeclaration &lt;Yield&gt;:
+    =&gt;(
+        'set'
+        -&gt;LiteralOrComputedPropertyName &lt;Yield&gt;
+    )
+    '(' fpar=FormalParameter&lt;Yield&gt; ')' body=Block&lt;Yield=false&gt;
+;
+
+ParameterizedCallExpression &lt;Yield&gt;:
+    TypeArguments
+    target=IdentifierRef&lt;Yield&gt;
+    ArgumentsWithParentheses&lt;Yield&gt;
+;
+
+LeftHandSideExpression &lt;Yield&gt;:
+    MemberExpression&lt;Yield&gt; (
+        {ParameterizedCallExpression.target=current} ArgumentsWithParentheses&lt;Yield&gt;
+        (
+              {ParameterizedCallExpression.target=current} ArgumentsWithParentheses&lt;Yield&gt;
+            | {IndexedAccessExpression.target=current} IndexedAccessExpressionTail&lt;Yield&gt;
+            | {ParameterizedPropertyAccessExpression.target=current}
+                ParameterizedPropertyAccessExpressionTail&lt;Yield&gt;
+            | -&gt;({TaggedTemplateString.target=current} template=TemplateLiteral&lt;Yield&gt;)
+        )*
+    )?
+;
+
+fragment Arguments &lt;Yield&gt;*:
+      arguments+=AssignmentExpression&lt;In=true,Yield&gt;
+      (',' arguments+=AssignmentExpression&lt;In=true,Yield&gt;)*
+      (',' spread?='...' arguments+=AssignmentExpression&lt;In=true,Yield&gt;)?
+    | spread?='...' arguments+=AssignmentExpression&lt;In=true,Yield&gt;
+;
+
+fragment TypeArguments*:
+    '&lt;' typeArgs+=TypeRef (',' typeArgs+=TypeRef)* '&gt;'
+;
+
+fragment ArgumentsWithParentheses &lt;Yield&gt;*:
+    '(' Arguments&lt;Yield&gt;? ')'
+;
+
+MemberExpression &lt;Yield&gt;:
+    =&gt;('new' '.') 'target'
+    | =&gt; ('new') callee=MemberExpression&lt;Yield&gt; (-&gt; TypeArguments)?
+        (=&gt; withArgs?='(' Arguments&lt;Yield&gt;? ')'
+            (
+                  {IndexedAccessExpression.target=current} IndexedAccessExpressionTail&lt;Yield&gt;
+                | {ParameterizedPropertyAccessExpression.target=current}
+                    ParameterizedPropertyAccessExpressionTail&lt;Yield&gt;
+                | {TaggedTemplateString.target=current} template=TemplateLiteral&lt;Yield&gt;
+            )*
+        )?
+    | PrimaryExpression&lt;Yield&gt; (
+          {IndexedAccessExpression.target=current} IndexedAccessExpressionTail&lt;Yield&gt;
+        | {ParameterizedPropertyAccessExpression.target=current}
+            ParameterizedPropertyAccessExpressionTail&lt;Yield&gt;
+        | {TaggedTemplateString.target=current} template=TemplateLiteral&lt;Yield&gt;
+        )*
+;
+
+fragment IndexedAccessExpressionTail &lt;Yield&gt;*:
+    '[' index=Expression&lt;In=true,Yield&gt; ']'
+;
+
+fragment ParameterizedPropertyAccessExpressionTail &lt;Yield&gt;*:
+    '.' TypeArguments? property=[types::IdentifiableElement|IdentifierName]
+;
+
+PostfixExpression &lt;Yield&gt;:
+    LeftHandSideExpression&lt;Yield&gt; (
+        =&gt;({PostfixExpression.expression=current} op=PostfixOperator
+        )
+    )?
+;
+
+enum PostfixOperator: inc='++' | dec='--';
+
+CastExpression &lt;Yield&gt;: PostfixExpression&lt;Yield&gt;
+    (=&gt;({CastExpression.expression=current} 'as') targetTypeRef=TypeRefForCast)?;
+
+UnaryExpression &lt;Yield&gt;:
+      CastExpression&lt;Yield&gt;
+    | (op=UnaryOperator expression=UnaryExpression&lt;Yield&gt;);
+
+enum UnaryOperator: delete | void | typeof | inc='++' | dec='--' | pos='+' | neg='-' | inv='~' | not='!';
+
+MultiplicativeExpression &lt;Yield&gt;: UnaryExpression&lt;Yield&gt;
+    (=&gt;({MultiplicativeExpression.lhs=current} op=MultiplicativeOperator)
+        rhs=UnaryExpression&lt;Yield&gt;)*;
+
+enum MultiplicativeOperator: times='*' | div='/' | mod='%';
+
+AdditiveExpression &lt;Yield&gt;: MultiplicativeExpression&lt;Yield&gt;
+    (=&gt;({AdditiveExpression.lhs=current} op=AdditiveOperator)
+        rhs=MultiplicativeExpression&lt;Yield&gt;)*;
+
+enum AdditiveOperator: add='+' | sub='-';
+
+ShiftExpression &lt;Yield&gt;: AdditiveExpression&lt;Yield&gt;
+    (=&gt;({ShiftExpression.lhs=current} op=ShiftOperator rhs=AdditiveExpression&lt;Yield&gt;))*
+;
+
+ShiftOperator:
+      '&gt;' '&gt;' '&gt;'?
+    | '&lt;&lt;'
+;
+
+RelationalExpression &lt;In, Yield&gt;: ShiftExpression&lt;Yield&gt;
+    =&gt;({RelationalExpression.lhs=current} op=RelationalOperator&lt;In&gt;
+        -&gt;rhs=ShiftExpression&lt;Yield&gt;)*;
+
+RelationalOperator &lt;In&gt;:
+    '&lt;' | '&gt;' | '&lt;=' | '&gt;=' | 'instanceof' | &lt;In&gt; 'in';
+
+EqualityExpression &lt;In, Yield&gt;: RelationalExpression&lt;In,Yield&gt;
+    (=&gt;({EqualityExpression.lhs=current} op=EqualityOperator) rhs=RelationalExpression&lt;In,Yield&gt;)*;
+
+enum EqualityOperator: same='===' | nsame='!==' | eq='==' | neq='!=';
+
+BitwiseANDExpression &lt;In, Yield&gt;: EqualityExpression&lt;In,Yield&gt;
+    (=&gt;({BinaryBitwiseExpression.lhs=current} op=BitwiseANDOperator) rhs=EqualityExpression&lt;In,Yield&gt;)*;
+
+BitwiseANDOperator: '&amp;';
+
+BitwiseXORExpression &lt;In, Yield&gt;: BitwiseANDExpression&lt;In,Yield&gt;
+    (=&gt;({BinaryBitwiseExpression.lhs=current} op=BitwiseXOROperator) rhs=BitwiseANDExpression&lt;In,Yield&gt;)*;
+
+BitwiseXOROperator: '^';
+
+BitwiseORExpression &lt;In, Yield&gt;: BitwiseXORExpression&lt;In,Yield&gt;
+    (=&gt;({BinaryBitwiseExpression.lhs=current} op=BitwiseOROperator) rhs=BitwiseXORExpression&lt;In,Yield&gt;)*;
+
+BitwiseOROperator: '|';
+
+LogicalANDExpression &lt;In, Yield&gt;: BitwiseORExpression&lt;In,Yield&gt;
+    (=&gt; ({BinaryLogicalExpression.lhs=current} op=LogicalANDOperator) rhs=BitwiseORExpression&lt;In,Yield&gt;)*;
+
+LogicalANDOperator: '&amp;&amp;';
+
+LogicalORExpression &lt;In, Yield&gt;: LogicalANDExpression&lt;In,Yield&gt;
+    (=&gt;({BinaryLogicalExpression.lhs=current} op=LogicalOROperator) rhs=LogicalANDExpression&lt;In,Yield&gt;)*;
+
+LogicalOROperator: '||';
+
+ConditionalExpression &lt;In, Yield&gt;: LogicalORExpression&lt;In,Yield&gt;
+    (=&gt; ({ConditionalExpression.expression=current} '?') trueExpression=AssignmentExpression&lt;In=true,Yield&gt;
+        ':' falseExpression=AssignmentExpression&lt;In,Yield&gt;)?;
+
+AssignmentExpression &lt;In, Yield&gt;:
+      AwaitExpression&lt;In,Yield&gt;
+    | PromisifyExpression&lt;In,Yield&gt;
+    | ArrowExpression&lt;In,Yield&gt;
+    | &lt;Yield&gt; YieldExpression&lt;In&gt;
+    | ConditionalExpression&lt;In,Yield&gt;
+        (=&gt; ({AssignmentExpression.lhs=current} op=AssignmentOperator)
+            rhs=AssignmentExpression&lt;In,Yield&gt;)?
+;
+
+YieldExpression &lt;In&gt;:
+    'yield' =&gt; many?='*'? -&gt; expression=AssignmentExpression&lt;In,Yield=true&gt;?
+;
+
+AssignmentOperator:
+      '=' | '*=' | '/=' | '%=' | '+=' | '-='
+    | '&lt;&lt;='
+    | '&gt;' '&gt;'? '&gt;='
+    | '&amp;=' | '^=' | '|='
+;
+
+AwaitExpression &lt;In, Yield&gt;:
+    =&gt;('await') expression=AssignmentExpression&lt;In,Yield&gt;;
+
+PromisifyExpression &lt;In, Yield&gt;:
+    =&gt; ('@' 'Promisify') expression=AssignmentExpression&lt;In,Yield&gt;;
+
+Expression &lt;In, Yield&gt;:
+    AssignmentExpression&lt;In,Yield&gt; ({CommaExpression.exprs+=current}
+    ',' exprs+=AssignmentExpression&lt;In,Yield&gt;
+    (','    exprs+=AssignmentExpression&lt;In,Yield&gt;)*)?
+;
+
+TemplateLiteral &lt;Yield&gt;:
+    (
+          segments+=NoSubstitutionTemplate
+        | segments+=TemplateHead segments+=Expression&lt;In=true,Yield&gt;? TemplateExpressionEnd
+            (
+                segments+=TemplateMiddle segments+=Expression&lt;In=true,Yield&gt;?
+                TemplateExpressionEnd
+            )*
+            segments+=TemplateTail
+    )
+;
+
+TemplateExpressionEnd:
+    '}'
+;
+
+NoSubstitutionTemplate:
+    rawValue=NO_SUBSTITUTION_TEMPLATE_LITERAL
+;
+
+TemplateHead:
+    rawValue=TEMPLATE_HEAD
+;
+
+TemplateTail:
+    rawValue=TemplateTailLiteral;
+
+TemplateMiddle:
+    rawValue=TemplateMiddleLiteral;
+
+Literal:
+      NumericLiteral | BooleanLiteral | StringLiteral
+    | NullLiteral | RegularExpressionLiteral;
+NullLiteral: 'null';
+BooleanLiteral: (true?='true' | 'false');
+StringLiteral: value=STRING;
+NumericLiteral:
+      DoubleLiteral | IntLiteral | BinaryIntLiteral | OctalIntLiteral
+    | LegacyOctalIntLiteral | HexIntLiteral | ScientificIntLiteral;
+DoubleLiteral: value=DOUBLE;
+IntLiteral: value=INT;
+OctalIntLiteral: value=OCTAL_INT;
+LegacyOctalIntLiteral: value=LEGACY_OCTAL_INT;
+HexIntLiteral: value=HEX_INT;
+BinaryIntLiteral: value=BINARY_INT;
+ScientificIntLiteral: value=SCIENTIFIC_INT;
+RegularExpressionLiteral: value=REGEX_LITERAL;
+
+NumericLiteralAsString:
+    DOUBLE | INT | OCTAL_INT | HEX_INT | SCIENTIFIC_INT
+;
+
+IdentifierOrThis:
+    IDENTIFIER
+    | 'This'
+    | 'Promisify'
+    | 'target';
+
+AnnotationName:
+    IDENTIFIER
+    | 'This'
+    | 'target';
+
+BindingIdentifier &lt;Yield&gt;:
+    IDENTIFIER
+    | &lt;!Yield&gt; 'yield'
+    | N4Keyword
+;
+
+IdentifierName:
+    IDENTIFIER | ReservedWord | N4Keyword
+;
+
+ReservedWord:
+    'break' | 'case' | 'catch' | 'class' | 'const' | 'continue' | 'debugger' | 'default' | 'delete'
+    | 'do' | 'else' | 'export' | 'extends' | 'finally' | 'for' | 'function' | 'if' | 'import'
+    | 'in' | 'instanceof' | 'new' | 'return' | 'super' | 'switch' | 'this' | 'throw' | 'try'
+    | 'typeof' | 'var' | 'void' | 'while' | 'with' | 'yield'
+    | 'null'
+    | 'true' | 'false'
+    | 'enum';
+
+N4Keyword:
+    'get' | 'set'
+    | 'let'
+    | 'project'
+    | 'external' | 'abstract' | 'static'
+    | 'as' | 'from' | 'constructor' | 'of' | 'target'
+    | 'type' | 'union' | 'intersection'
+    | 'This' | 'Await' | 'Promisify'
+    | 'await'
+    | 'async'
+    | 'implements' | 'interface'
+    | 'private' | 'protected' | 'public'
+;
+
+SymbolLiteralComputedName &lt;Yield&gt;:
+    BindingIdentifier&lt;Yield&gt; ('.' IdentifierName)?
+;
+
+terminal DOUBLE:
+    '.' DECIMAL_DIGIT_FRAGMENT+ EXPONENT_PART?
+    | DECIMAL_INTEGER_LITERAL_FRAGMENT '.' DECIMAL_DIGIT_FRAGMENT* EXPONENT_PART?
+;
+
+terminal HEX_INT: '0' ('x' | 'X') INT_SUFFIX;
+
+terminal BINARY_INT: '0' ('b' | 'B') INT_SUFFIX;
+
+terminal OCTAL_INT: '0' ('o' | 'O') INT_SUFFIX;
+
+terminal LEGACY_OCTAL_INT: '0' DECIMAL_DIGIT_FRAGMENT INT_SUFFIX;
+
+terminal fragment INT_SUFFIX: IDENTIFIER_PART*;
+
+terminal SCIENTIFIC_INT:
+    DECIMAL_INTEGER_LITERAL_FRAGMENT EXPONENT_PART
+;
+
+terminal fragment EXPONENT_PART:
+      ('e' | 'E') SIGNED_INT
+    | IDENTIFIER
+;
+
+terminal fragment SIGNED_INT:
+    ('+' | '-') DECIMAL_DIGIT_FRAGMENT+ IDENTIFIER?
+;
+
+terminal STRING:
+      '"' DOUBLE_STRING_CHAR* '"'?
+    | "'" SINGLE_STRING_CHAR* "'"?
+;
+
+terminal fragment DOUBLE_STRING_CHAR:
+      !(LINE_TERMINATOR_FRAGMENT | '"' | '\\')
+    | '\\' (LINE_TERMINATOR_SEQUENCE_FRAGMENT | !LINE_TERMINATOR_FRAGMENT)?
+;
+
+terminal fragment SINGLE_STRING_CHAR:
+      !(LINE_TERMINATOR_FRAGMENT | "'" | '\\')
+    | '\\' (LINE_TERMINATOR_SEQUENCE_FRAGMENT | !LINE_TERMINATOR_FRAGMENT)?
+;
+
+terminal fragment BACKSLASH_SEQUENCE:
+    '\\' !(LINE_TERMINATOR_FRAGMENT)?
+;
+
+terminal fragment REGEX_CHAR:
+      !(LINE_TERMINATOR_FRAGMENT | '\\' | '/' | '[')
+    | BACKSLASH_SEQUENCE
+    | '[' REGEX_CHAR_OR_BRACKET* ']'?
+;
+
+terminal fragment REGEX_CHAR_OR_BRACKET:
+      !(LINE_TERMINATOR_FRAGMENT | '\\' | ']')
+    | BACKSLASH_SEQUENCE
+;
+
+REGEX_LITERAL:
+    ('/' | '/=') REGEX_TAIL?
+;
+
+terminal fragment ACTUAL_REGEX_TAIL:
+      REGEX_CHAR+ ('/' IDENTIFIER_PART*)?
+    | '/' IDENTIFIER_PART*
+;
+
+terminal fragment REGEX_START:
+    ('/' | '/=')
+;
+
+terminal REGEX_TAIL: // post processed
+    '//1'
+;
+terminal TEMPLATE_HEAD:
+    "`" TEMPLATE_LITERAL_CHAR* '$'+ '{'
+;
+
+terminal NO_SUBSTITUTION_TEMPLATE_LITERAL:
+    '`' TEMPLATE_LITERAL_CHAR* '$'* "`"?
+;
+
+terminal fragment ACTUAL_TEMPLATE_END:
+    TEMPLATE_LITERAL_CHAR* ('$'+ ('{' | '`'?) | '`'?)
+;
+
+terminal fragment TEMPLATE_LITERAL_CHAR:
+      !(LINE_TERMINATOR_FRAGMENT | '`' | '\\' | '$')
+    | '$'+ !('{' | '`' | '$')
+    | LINE_TERMINATOR_SEQUENCE_FRAGMENT
+    | '\\' (LINE_TERMINATOR_SEQUENCE_FRAGMENT | !LINE_TERMINATOR_FRAGMENT)?
+;
+
+TemplateTailLiteral:
+    TEMPLATE_END?
+;
+
+TemplateMiddleLiteral:
+    TEMPLATE_MIDDLE
+;
+
+terminal TEMPLATE_MIDDLE:
+    '//2' // will never be lexed
+;
+
+terminal TEMPLATE_END:
+    '//3' // will never be lexed
+;
+
+terminal fragment TEMPLATE_CONTINUATION:
+    '//4' // actually '}'
+;
+
+Semi: ';'; // automatic semicolon instertion, post-processed
+
+fragment NoLineTerminator*: NO_LINE_TERMINATOR?;
+
+terminal NO_LINE_TERMINATOR:
+    '//5' // post-processed, will never be lexed
+;
+Annotation:'@' AnnotationNoAtSign;
+ScriptAnnotation: '@@' AnnotationNoAtSign;
+
+AnnotationNoAtSign:
+    name=AnnotationName (=&gt; '(' (args+=AnnotationArgument (',' args+=AnnotationArgument)*)? ')')?;
+
+AnnotationArgument:
+    LiteralAnnotationArgument | TypeRefAnnotationArgument
+;
+
+LiteralAnnotationArgument:
+    literal=Literal
+;
+
+TypeRefAnnotationArgument:
+    typeRef=TypeRef
+;
+
+AnnotationList:
+    =&gt;('@' -&gt; annotations+=AnnotationNoAtSign) annotations+=Annotation*
+;
+
+ExpressionAnnotationList:
+    annotations+=Annotation+
+;
+
+PropertyAssignmentAnnotationList:
+    annotations+=Annotation+
+;
+
+N4MemberAnnotationList:
+    {N4MemberAnnotationList} annotations+=Annotation+
+;
+
+TypeReferenceName:
+    'void' | 'This' | 'await' | 'Promisify' | 'target' | QualifiedTypeReferenceName
+;
+
+QualifiedTypeReferenceName:
+    IDENTIFIER ('.' IDENTIFIER)?
+;
+N4ClassDeclaration &lt;Yield&gt;:
+    =&gt;(
+        {N4ClassDeclaration}
+        (declaredModifiers+=N4Modifier)*
+        'class' typingStrategy=TypingStrategyDefSiteOperator? name=BindingIdentifier&lt;Yield&gt;?
+    )
+    TypeVariables?
+    ClassExtendsClause&lt;Yield&gt;?
+    Members&lt;Yield&gt;
+;
+
+fragment Members &lt;Yield&gt;*:
+    '{'
+    ownedMembersRaw+=N4MemberDeclaration&lt;Yield&gt;*
+    '}'
+;
+
+fragment ClassExtendsClause &lt;Yield&gt;*:
+    'extends' (
+          =&gt;superClassRef=ParameterizedTypeRefNominal ('implements' ClassImplementsList)?
+        | superClassExpression=LeftHandSideExpression&lt;Yield&gt;
+    )
+    | 'implements' ClassImplementsList
+;
+
+fragment ClassImplementsList*:
+    implementedInterfaceRefs+=ParameterizedTypeRefNominal
+    (',' implementedInterfaceRefs+=ParameterizedTypeRefNominal)*
+;
+
+N4ClassExpression &lt;Yield&gt;:
+    {N4ClassExpression}
+    'class' name=BindingIdentifier&lt;Yield&gt;?
+    ClassExtendsClause&lt;Yield&gt;?
+    Members&lt;Yield&gt;;
+N4InterfaceDeclaration &lt;Yield&gt;:
+    =&gt; (
+        {N4InterfaceDeclaration}
+        (declaredModifiers+=N4Modifier)*
+        'interface' typingStrategy=TypingStrategyDefSiteOperator? name=BindingIdentifier&lt;Yield&gt;?
+    )
+    TypeVariables?
+    InterfaceImplementsList?
+    Members&lt;Yield&gt;
+;
+
+fragment InterfaceImplementsList*:
+     'extends' superInterfaceRefs+=ParameterizedTypeRefNominal
+        (',' superInterfaceRefs+=ParameterizedTypeRefNominal)*
+;
+N4EnumDeclaration &lt;Yield&gt;:
+    =&gt;(
+        {N4EnumDeclaration}
+        (declaredModifiers+=N4Modifier)*
+        'enum' name=BindingIdentifier&lt;Yield&gt;?
+    )
+    '{'
+        (literals+=N4EnumLiteral (',' literals+=N4EnumLiteral)*)?
+    '}'
+;
+N4EnumLiteral: name=IdentifierOrThis (':' value=STRING)?;
+
+enum N4Modifier: // validator applies further checks
+      private | project | protected | public
+    | external | abstract | static | const;
+
+N4MemberDeclaration &lt;Yield&gt;:
+    AnnotatedN4MemberDeclaration&lt;Yield&gt;
+    | N4GetterDeclaration&lt;Yield&gt;
+    | N4SetterDeclaration&lt;Yield&gt;
+    | N4MethodDeclaration&lt;Yield&gt;
+    | N4FieldDeclaration&lt;Yield&gt;
+    | N4CallableConstructorDeclaration&lt;Yield&gt;
+;
+
+AnnotatedN4MemberDeclaration &lt;Yield&gt; returns N4MemberDeclaration:
+    N4MemberAnnotationList (
+            =&gt; ({N4GetterDeclaration.annotationList=current}
+                (declaredModifiers+=N4Modifier)* GetterHeader&lt;Yield&gt;) (body=Block&lt;Yield&gt;)? ';'?
+        |   =&gt; ({N4SetterDeclaration.annotationList=current}
+                (declaredModifiers+=N4Modifier)* 'set' -&gt; LiteralOrComputedPropertyName &lt;Yield&gt;)
+                '(' fpar=FormalParameter&lt;Yield&gt; ')' (body=Block&lt;Yield&gt;)? ';'?
+        |   =&gt; (
+                {N4MethodDeclaration.annotationList=current} (declaredModifiers+=N4Modifier)* TypeVariables?
+                (
+                        generator?='*' LiteralOrComputedPropertyName&lt;Yield&gt;
+                        -&gt;MethodParamsReturnAndBody &lt;Generator=true&gt;
+                    |   AsyncNoTrailingLineBreak LiteralOrComputedPropertyName&lt;Yield&gt;
+                        -&gt;MethodParamsReturnAndBody &lt;Generator=false&gt;
+                )
+                )';'?
+        |   {N4FieldDeclaration.annotationList=current} FieldDeclarationImpl&lt;Yield&gt;
+    )
+;
+
+fragment LiteralOrComputedPropertyName &lt;Yield&gt;*:
+    name=IdentifierName | name=STRING | name=NumericLiteralAsString
+    | '[' (=&gt;((name=SymbolLiteralComputedName&lt;Yield&gt; | name=StringLiteralAsName) ']')
+        |   computeNameFrom=AssignmentExpression&lt;In=true,Yield&gt; ']')
+;
+
+fragment LiteralPropertyName &lt;Yield&gt;*:
+    name=IdentifierName | name=STRING | name=NumericLiteralAsString
+    | '[' (name=SymbolLiteralComputedName&lt;Yield&gt; | name=StringLiteralAsName) ']'
+;
+
+StringLiteralAsName:
+    STRING
+;
+
+fragment FieldDeclarationImpl &lt;Yield&gt;*:
+    (declaredModifiers+=N4Modifier)*
+    LiteralPropertyName&lt;Yield&gt; ColonSepTypeRef? ('=' expression=Expression&lt;In=true,Yield&gt;)? ';'
+;
+
+N4FieldDeclaration &lt;Yield&gt;:
+    {N4FieldDeclaration}
+    FieldDeclarationImpl&lt;Yield&gt;
+;
+
+N4MethodDeclaration &lt;Yield&gt;:
+    =&gt; ({N4MethodDeclaration} (declaredModifiers+=N4Modifier)* TypeVariables?
+        (
+                generator?='*' LiteralOrComputedPropertyName&lt;Yield&gt;
+                -&gt;MethodParamsReturnAndBody &lt;Generator=true&gt;
+            |   AsyncNoTrailingLineBreak LiteralOrComputedPropertyName&lt;Yield&gt;
+                -&gt;MethodParamsReturnAndBody &lt;Generator=false&gt;
+        )
+    ) ';'?
+;
+
+N4CallableConstructorDeclaration &lt;Yield&gt; returns N4MethodDeclaration:
+    MethodParamsReturnAndBody &lt;Generator=false&gt; ';'?
+;
+
+fragment MethodParamsAndBody &lt;Generator&gt;*:
+    StrictFormalParameters&lt;Yield=Generator&gt;
+    (body=Block&lt;Yield=Generator&gt;)?
+;
+
+fragment MethodParamsReturnAndBody &lt;Generator&gt;*:
+    StrictFormalParameters&lt;Yield=Generator&gt;
+    (':' returnTypeRef=TypeRef)?
+    (body=Block&lt;Yield=Generator&gt;)?
+;
+
+N4GetterDeclaration &lt;Yield&gt;:
+    =&gt; ({N4GetterDeclaration}
+    (declaredModifiers+=N4Modifier)*
+    GetterHeader&lt;Yield&gt;)
+    (body=Block&lt;Yield&gt;)? ';'?
+;
+
+fragment GetterHeader &lt;Yield&gt;*:
+    ('get' -&gt; LiteralOrComputedPropertyName &lt;Yield&gt; '(' ')' ColonSepTypeRef?)
+;
+
+N4SetterDeclaration &lt;Yield&gt;:
+    =&gt;({N4SetterDeclaration}
+        (declaredModifiers+=N4Modifier)*
+        'set'
+        -&gt;LiteralOrComputedPropertyName &lt;Yield&gt;
+    )
+    '(' fpar=FormalParameter&lt;Yield&gt; ')' (body=Block&lt;Yield&gt;)? ';'?
+;
+
+BindingPattern &lt;Yield&gt;:
+    ObjectBindingPattern&lt;Yield&gt;
+    | ArrayBindingPattern&lt;Yield&gt;
+;
+
+ObjectBindingPattern &lt;Yield&gt;:
+    '{' (properties+=BindingProperty&lt;Yield,AllowType=false&gt;
+        (',' properties+=BindingProperty&lt;Yield,AllowType=false&gt;)*)? '}'
+;
+
+ArrayBindingPattern &lt;Yield&gt;:
+    '['
+        elements+=Elision* (
+            elements+=BindingRestElement&lt;Yield&gt;
+            (',' elements+=Elision* elements+=BindingRestElement&lt;Yield&gt;)*
+            (',' elements+=Elision*)?
+        )?
+    ']'
+;
+
+BindingProperty &lt;Yield, AllowType&gt;:
+      =&gt;(LiteralBindingPropertyName&lt;Yield&gt; ':') value=BindingElement&lt;Yield&gt;
+    | value=SingleNameBinding&lt;Yield,AllowType&gt;
+;
+
+fragment LiteralBindingPropertyName &lt;Yield&gt;*:
+    declaredName=IdentifierName | declaredName=STRING | declaredName=NumericLiteralAsString
+    | '[' (declaredName=SymbolLiteralComputedName&lt;Yield&gt; | declaredName=STRING) ']'
+;
+
+SingleNameBinding &lt;Yield, AllowType&gt;:
+    varDecl=VariableDeclaration&lt;In=true,Yield,AllowType&gt;
+;
+
+BindingElement &lt;Yield&gt;:
+      =&gt;(nestedPattern=BindingPattern&lt;Yield&gt;) ('=' expression=AssignmentExpression&lt;In=true,Yield&gt;)?
+    | varDecl=VariableDeclaration&lt;In=true,Yield,AllowType=true&gt;
+;
+
+BindingRestElement &lt;Yield&gt;:
+    rest?='...'?
+    (
+          =&gt;(nestedPattern=BindingPattern&lt;Yield&gt;)
+            ('=' expression=AssignmentExpression&lt;In=true,Yield&gt;)?
+        | varDecl=VariableDeclaration&lt;In=true,Yield,AllowType=true&gt;
+    )
+;
+
+Elision:
+    ','
+;</programlisting>
+</section>
+</chapter>
+<chapter xml:id="_jsobjects">
+<title>JSObjects</title>
+<simpara>The built-in ECMAScript Objects
+[<link linkend="ECMA11a">ECMA11a(p.S15, p.p.102)</link>] are supported and their properties are annotated with types as described in this chapter. The semantics of these properties do not change. The short description is copied from [<link linkend="ECMA11a">ECMA11a</link>] repeated here for convenience.</simpara>
+<section xml:id="_object" role="language-n4js">
+<title>Object</title>
+<simpara><literal>Object</literal> is the super type of all declared types and <literal>N4Object</literal>. It is almost similar to the JavaScript type <literal>Object</literal> except that no properties may be dynamically added to it. In order to declare a variable to which properties can be dynamically added, the <literal>Object+</literal> type has to be declared (cf.
+<xref linkend="_dynamic"/>).</simpara>
+<bridgehead xml:id="_attributes" renderas="sect3">Attributes</bridgehead>
+<variablelist>
+<varlistentry>
+<term><literal>constructor:Object</literal></term>
+<listitem>
+<simpara>Returns a reference to the Object function that created the instance’s
+prototype.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+<bridgehead xml:id="_methods-2" renderas="sect3">Methods</bridgehead>
+<variablelist>
+<varlistentry>
+<term><literal>toString():Object</literal></term>
+<listitem>
+<simpara>Returns a string representing the specified object.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>toLocaleString():Object</literal></term>
+<listitem>
+<simpara>Returns a string representing the object. This method is meant to be
+overridden by derived objects for locale-specific purposes.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>valueOf():Object</literal></term>
+<listitem>
+<simpara>Returns the primitive value of the specified object.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>hasOwnProperty(prop:String):Boolean</literal></term>
+<listitem>
+<simpara>Returns a boolean indicating whether an object contains the specified
+property as a direct property of that object and not inherited through
+the prototype chain.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>isPrototypeOf(object:Object):Boolean</literal></term>
+<listitem>
+<simpara>Returns a boolean indication whether the specified object is in the
+prototype chain of the object this method is called upon.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>propertyIsEnumerable(prop:String):Boolean</literal></term>
+<listitem>
+<simpara>Returns a boolean indicating if the internal ECMAScript DontEnum
+attribute is set.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+<bridgehead xml:id="_static-methods" renderas="sect3">Static Methods</bridgehead>
+<variablelist>
+<varlistentry>
+<term><literal>getPrototypeOf(object:Object):Object</literal></term>
+<listitem>
+<simpara>Returns the prototype of the specified object.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>create(object:Object,properties:Object=):Object</literal></term>
+<listitem>
+<simpara>Creates a new object with the specified prototype object and properties.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>defineProperty(object:Object,prop:Object,descriptor:Object):Object</literal></term>
+<listitem>
+<simpara>Defines a new property directly on an object or modifies an existing
+property on an object and returns the object.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>defineProperties(object:Object,properties:Object):Object</literal></term>
+<listitem>
+<simpara>Defines new or modifies existing properties directly on an object,
+returning the object.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>seal(object:Object,properties:Object)</literal></term>
+<listitem>
+<simpara>Seals an object, preventing new properties from being added to it and
+marking all existing properties as non-configurable. Values of present
+properties can still be changed as long as they are writable.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>freeze(object:Object):Object</literal></term>
+<listitem>
+<simpara>Freezes an object: that is, prevents new properties from being added to it, prevents existing properties from being removed, prevents existing properties or their enumerability, configurability, or writability from being changed.
+In essence, the object is made effectively immutable.
+The method returns the object being frozen.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>preventExtensions(object:Object):Object</literal></term>
+<listitem>
+<simpara>Prevents new properties from ever being added to an object (i.e.
+prevents future extensions to the object).</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>isSealed(object:Object):Boolean static</literal></term>
+<listitem>
+<simpara>Determine if an object is sealed.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>isFrozen(object:Object):Boolean</literal></term>
+<listitem>
+<simpara>Determine if an object is frozen.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>isExtensible(object:Object):Boolean</literal></term>
+<listitem>
+<simpara>Determines if an object is extensible (whether it can have new
+properties added to it).</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>keys(object:Object):Array&lt;String&gt;</literal></term>
+<listitem>
+<simpara>Returns an array of all own enumerable properties found upon a given
+object in the same order as that provided by a for-in loop (the
+difference being that a for-in loop enumerates properties in the
+prototype chain as well).</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+</section>
+<section xml:id="_string" role="language-n4js">
+<title>String</title>
+<simpara>String is a global object that may be used to construct String
+instances and is a sub class of Object.</simpara>
+<bridgehead xml:id="string-attributes" renderas="sect3">Attributes</bridgehead>
+<variablelist>
+<varlistentry>
+<term><literal>number: length</literal> </term>
+<listitem>
+<simpara>The length of a string.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+<bridgehead xml:id="methods-1" renderas="sect3">Methods</bridgehead>
+<variablelist>
+<varlistentry>
+<term><literal>String(thing:Object=)</literal></term>
+<listitem>
+<simpara>-</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>anchor(anchorname:String):String</literal></term>
+<listitem>
+<simpara>Creates an HTML anchor.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>big():String</literal></term>
+<listitem>
+<simpara>Returns a string in a big font.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>blink():String</literal></term>
+<listitem>
+<simpara>Returns a string in a blinking string.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>bold():String</literal></term>
+<listitem>
+<simpara>Returns a string in a bold font.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>charAt(index:Number):String</literal></term>
+<listitem>
+<simpara>Returns the character at a specified position.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>charCodeAt(index:Number):Number</literal></term>
+<listitem>
+<simpara>Returns the Unicode of the character at a specified position.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>concat(strings:String&#8230;&#8203;):String</literal></term>
+<listitem>
+<simpara>Joins two or more strings.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>equals(object:Object):Boolean</literal> </term>
+<listitem>
+<simpara>-</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>equalsIgnoreCase(object:Object):Boolean</literal>  </term>
+<listitem>
+<simpara>-</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>fromCharCode(num:Any&#8230;&#8203;):String</literal></term>
+<listitem>
+<simpara>Returns a string created by using the specified sequence of Unicode values.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>fixed():String</literal></term>
+<listitem>
+<simpara>Returns a string as teletype text.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>fontcolor(color):String</literal></term>
+<listitem>
+<simpara>Returns a string in a specified color.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>fontsize(size):String</literal></term>
+<listitem>
+<simpara>Returns a string in a specified size.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>indexOf(searchValue, fromIndex:Number=):Number</literal></term>
+<listitem>
+<simpara>Returns the position of the first occurrence of a specified string value in a string.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>italics():String</literal></term>
+<listitem>
+<simpara>Returns a string in italic.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>lastIndexOf(searchValue, fromIndex:Number=):Number</literal></term>
+<listitem>
+<simpara>Returns the position of the last occurrence of a specified string value, searching backwards from the specified position in a string.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>link(url):String</literal></term>
+<listitem>
+<simpara>Returns a string as a hyperlink.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>localeCompare(otherString):Number</literal></term>
+<listitem>
+<simpara>This method returns a number indicating whether a reference string comes before or after or is the same as the given string in sort order.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>match(search value):String</literal></term>
+<listitem>
+<simpara>Searches for a specified value in a string.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>replace(findString,newString):String</literal></term>
+<listitem>
+<simpara>Replaces some characters with some other characters in a string.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>search(search string):Number</literal></term>
+<listitem>
+<simpara>Searches a string for a specified value.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>slice(beginSlice:Number, endSclice:Number=):String</literal></term>
+<listitem>
+<simpara>Extracts a part of a string and returns the extracted part in a new string.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>small():String</literal></term>
+<listitem>
+<simpara>Returns a string in a small font.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>split(separator, howmany:Number=):Array&lt;String&gt;</literal></term>
+<listitem>
+<simpara>Splits a string into an array of strings.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>strike():String</literal></term>
+<listitem>
+<simpara>Returns a string with a strikethrough.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>sub():String</literal></term>
+<listitem>
+<simpara>Returns a string as subscript.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>substr(start:Number,length:Number=):String</literal></term>
+<listitem>
+<simpara>Extracts a specified number of characters in a string, from a start index.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>substring(beginIndex:number,endIndex:Number=):String</literal></term>
+<listitem>
+<simpara>Extracts the characters in a string between two specified indices.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>sup():String</literal></term>
+<listitem>
+<simpara>Returns a string as superscript.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>toLocaleUpperCase():String</literal></term>
+<listitem>
+<simpara>Returns a string in lowercase letters.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>toString():String</literal></term>
+<listitem>
+<simpara>Returns a String value for this object.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>toUpperCase():String</literal></term>
+<listitem>
+<simpara>Returns a string in uppercase letters.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>valueOf():String</literal></term>
+<listitem>
+<simpara>Returns the primitive value of a String object.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+<bridgehead xml:id="static-methods-1" renderas="sect3">Static Methods</bridgehead>
+<variablelist>
+<varlistentry>
+<term><literal>String(value:Object=)</literal></term>
+<listitem>
+<simpara>Static constructor.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+</section>
+<section xml:id="_boolean" role="language-n4js">
+<title>Boolean</title>
+<simpara><literal>Boolean</literal> does not have a super class.</simpara>
+<bridgehead xml:id="static-methods-2" renderas="sect3">Static Methods</bridgehead>
+<simpara><literal>Boolean(value:Object=):Boolean</literal></simpara>
+</section>
+<section xml:id="_number" role="language-n4js">
+<title>Number</title>
+<simpara><literal>Number</literal> does not have a super class.</simpara>
+<section xml:id="_static-attributes">
+<title>Static Attributes</title>
+<variablelist>
+<varlistentry>
+<term><literal>MAX_VALUE:Number</literal></term>
+<listitem>
+<simpara>The largest representable number.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>MIN_VALUE:Number</literal></term>
+<listitem>
+<simpara>The smallest representable number.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>NaN:Number</literal></term>
+<listitem>
+<simpara>Special 'not a number' value.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>NEGATIVE_INFINITY:Number</literal></term>
+<listitem>
+<simpara>Special value representing negative infinity, returned on overflow.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>POSITIVE_INFINITY:Number</literal></term>
+<listitem>
+<simpara>Special value representing infinity, returned on overflow.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+<bridgehead xml:id="methods-2" renderas="sect3">Methods</bridgehead>
+<variablelist>
+<varlistentry>
+<term><literal>toExponential(numberOfDecimals:Number=):String</literal></term>
+<listitem>
+<simpara>Converts the value of the object into an exponential notation.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>toFixed(numberOfDecimals:Number=):String</literal></term>
+<listitem>
+<simpara>Formats a number to the specified number of decimals.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>toPrecision(numberOfDecimals:Number=):String</literal></term>
+<listitem>
+<simpara>Converts a number into an exponential notation if it has more digits than specified.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>valueOf():Number</literal></term>
+<listitem>
+<simpara>Returns the primitive value of a Number object.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>toString(radix:Number=):String</literal></term>
+<listitem>
+<simpara>Returns a String value for this object. The toString method parses its first argument and attempts to return a string representation in the specified radix (base).</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>toLocaleString(locales: String|[String]=undefined, options: <subscript>r</subscript>NumberFormatOptions=undefined): String</literal></term>
+<listitem>
+<simpara>Returns a locale-specific String value for this object. The toLocalString accepts two optional arguments. The semantics of these arguments
+is defined in <link xl:href="https://www.ecma-international.org/ecma-402/4.0/index.html#sup-number.prototype.tolocalestring">ECMA-402 (Internationalization API Specification)</link>.
+In N4JS, the base definition does not define that method, instead Number inherits <literal>toLocaleString</literal> from Object. The specialized
+definition is found in the runtime library <literal>n4js-runtime-ecma402</literal>.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+<bridgehead xml:id="static-methods-3" renderas="sect3">Static Methods</bridgehead>
+<variablelist>
+<varlistentry>
+<term><literal>Number(value:Object=):Number</literal></term>
+<listitem>
+<simpara>Static constructor.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+</section>
+</section>
+<section xml:id="function" role="language-n4js">
+<title>Function</title>
+<simpara><literal>Function</literal> does not have a super class.</simpara>
+<bridgehead xml:id="attributes-2" renderas="sect3">Attributes</bridgehead>
+<variablelist>
+<varlistentry>
+<term><literal>prototype:Object</literal></term>
+<listitem>
+<simpara>Allows the addition of properties to the instance of the object created by the constructor function.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>length:Number</literal></term>
+<listitem>
+<simpara>Specifies the number of arguments expected by the functio</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+<bridgehead xml:id="methods-3" renderas="sect3">Methods</bridgehead>
+<variablelist>
+<varlistentry>
+<term><literal>apply(thisArg,argsArray:Array=):Object</literal></term>
+<listitem>
+<simpara>Applies the method of another object in the context of a different object (the calling object); arguments can be passed as an Array object.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>call(thisArg,arg&#8230;&#8203;):Object</literal></term>
+<listitem>
+<simpara>Calls (executes) a method of another object in the context of a different object (the calling object); arguments can be passed as they are.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>bind(thisArg:Object,arg&#8230;&#8203;):Function</literal></term>
+<listitem>
+<simpara>Creates a new function that, when called, itself calls this function in the context of the provided this value with a given sequence of arguments preceding any provided when the new function was called.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+</section>
+<section xml:id="_error" role="language-n4js">
+<title>Error</title>
+<simpara><literal>Error</literal> does not have a super class.</simpara>
+<bridgehead xml:id="attributes-3" renderas="sect3">Attributes</bridgehead>
+<variablelist>
+<varlistentry>
+<term><literal>name:String</literal></term>
+<listitem>
+<simpara>Error name.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>message:String</literal></term>
+<listitem>
+<simpara>Error message.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+<bridgehead xml:id="static-methods-4" renderas="sect3">Static Methods</bridgehead>
+<variablelist>
+<varlistentry>
+<term><literal>Error(message:Object=):Error</literal></term>
+<listitem>
+<simpara>Static Constructor.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+</section>
+<section xml:id="_array" role="language-n4js">
+<title>Array</title>
+<simpara><literal>Array</literal> is a generic type with the type parameter <literal>E</literal> and  does not have a super class.</simpara>
+<bridgehead xml:id="methods-4" renderas="sect3">Methods</bridgehead>
+<variablelist>
+<varlistentry>
+<term><literal>concat(array&#8230;&#8203;):Array&lt;E&gt;)</literal></term>
+<listitem>
+<simpara>Joins two or more arrays and returns the result.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>every(callback:Function):Boolean</literal></term>
+<listitem>
+<simpara>Tests whether all elements in the array pass the test implemented by the provided function. The callback will be called with 3 arguments (elementValue,elementIndex,traversedArray).</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>filter(callback:Function):Array&lt;E&gt;</literal></term>
+<listitem>
+<simpara>Creates a new array with all elements that pass the test implemented by the provided function. The callback will be called with 3 arguments (elementValue,elementIndex,traversedArray).</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>forEach(callback:Function,thisArg=)</literal></term>
+<listitem>
+<simpara>Calls a function for each element in the array. The callback will be called with 3 arguments (elementValue,elementIndex,traversedArray). Optionally with a thisObject argument to use as this when executing callback.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>indexOf(searchElement,fromIndex=):Number</literal></term>
+<listitem>
+<simpara>Returns the first index at which a given element can be found in the array, or -1 if it is not present.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>join(separator=):String</literal></term>
+<listitem>
+<simpara>Puts all the elements of an array into a string. The elements are separated by a specified delimiter.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>lastIndexOf(searchElement,fromIndex=):Number</literal></term>
+<listitem>
+<simpara>Returns the last (greatest) index of an element within the array equal to the specified value. Will return -1 if none are found.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>length():Number</literal></term>
+<listitem>
+<simpara>The length returns an integer representing the length of an array.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>map(callback:Function,thisArg=):Array</literal></term>
+<listitem>
+<simpara>Creates a new array with the results of calling a provided function on every element in this array. The callback will be called with 3 arguments (elementValue,elementIndex,traversedArray). Optionally, with a thisObject argument to use as this when executing callback.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>pop():E</literal></term>
+<listitem>
+<simpara>Removes and returns the last element of an array.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>push(element&#8230;&#8203;):E</literal></term>
+<listitem>
+<simpara>Adds one or more elements to the end of an array and returns the new length.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>reverse():Array&lt;E&gt;</literal></term>
+<listitem>
+<simpara>Reverses the order of the elements in an array.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>shift()</literal></term>
+<listitem>
+<simpara>Removes and returns the first element of an array.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>slice(start:Number,end:Number=):Array&lt;E&gt;</literal></term>
+<listitem>
+<simpara>Returns selected elements from an existing array.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>some(callback:Function,thisArg=):Boolean</literal></term>
+<listitem>
+<simpara>Tests whether some element in the array passes the test implemented by the provided function. The callback will be called with 3 arguments (elementValue,elementIndex,traversedArray). Optionally, with a thisObject argument to use as this when executing callback.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>sort(sortByFunction:Function=):Array&lt;E&gt;</literal></term>
+<listitem>
+<simpara>Sorts the elements of an array. The function will be called with 2 arguments (a,b).</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>splice(index:Number,how many:Number,element&#8230;&#8203;):Array&lt;E&gt;</literal></term>
+<listitem>
+<simpara>Removes and adds new elements to an array. Returns the removed elements as an Array.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>toLocaleString():String</literal></term>
+<term><literal>toString():String</literal></term>
+<listitem>
+<simpara>Returns a String value for Array.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>unshift(element&#8230;&#8203;):E</literal></term>
+<listitem>
+<simpara>Adds one or more elements to the beginning of an array and returns the new length.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+<bridgehead xml:id="static-methods-5" renderas="sect3">Static Methods</bridgehead>
+<variablelist>
+<varlistentry>
+<term><literal>Array(item:Object&#8230;&#8203;)</literal></term>
+<listitem>
+<simpara>Static constructor.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+</section>
+<section xml:id="_date" role="language-n4js">
+<title>Date</title>
+<simpara><literal>Date</literal> does not have a super class.</simpara>
+<bridgehead xml:id="static-methods-6" renderas="sect3">Static Methods</bridgehead>
+<variablelist>
+<varlistentry>
+<term><literal>Date():Date</literal></term>
+<listitem>
+<simpara>Static constructor.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>Date(milliseconds:Number):Date</literal></term>
+<listitem>
+<simpara>Constructor.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>Date(date:Date):Date</literal></term>
+<listitem>
+<simpara>Constructor.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>Date(dateString:String):Date</literal></term>
+<listitem>
+<simpara>Constructor.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>Date(year:Number,month:Number,day=Number=,hour:Number=,minute:Number=,second:Number=,millisecond:Number=):Date</literal></term>
+<listitem>
+<simpara>Constructor.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>parse(dateString:String):Date</literal></term>
+<listitem>
+<simpara>Parses a string representation of a date, and returns the number of milliseconds since midnight Jan 1, 1970.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>now():Number</literal></term>
+<listitem>
+<simpara>Returns the numeric value corresponding to the current time.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>UTC(year:Number,month:Number,date:Number=,hrs:Number=,min:Number=,sec:Number=,ms:Number=):Number</literal></term>
+<listitem>
+<simpara>UTC takes comma-delimited date parameters and returns the number of milliseconds between January 1, 1970, 00:00:00, Universal Time and the time you specified.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+<bridgehead xml:id="methods-5" renderas="sect3">Methods</bridgehead>
+<variablelist>
+<varlistentry>
+<term><literal>getDate():Number</literal></term>
+<listitem>
+<simpara>Returns the day of the month from a Date object (from 1-31).</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>getDay():Number</literal></term>
+<listitem>
+<simpara>Returns the day of the week from a Date object (from 0-6).</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>getFullYear():Number</literal></term>
+<listitem>
+<simpara>Returns the year, as a four-digit number.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>getHours():Number</literal></term>
+<listitem>
+<simpara>Returns the hour of a day (from 0-23).</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>getMilliseconds():Number</literal></term>
+<listitem>
+<simpara>Returns the milliseconds of a Date object (from 0-999).</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>getMinutes():Number</literal></term>
+<listitem>
+<simpara>Returns the minutes of a date (from 0-59).</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>getMonth():Number</literal></term>
+<listitem>
+<simpara>Returns the month from a date (from 0-11).</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>getSeconds():Number</literal></term>
+<listitem>
+<simpara>Returns the seconds of a date (from 0-59).</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>getTime():Number</literal></term>
+<listitem>
+<simpara>Returns the number of milliseconds since midnight Jan 1, 1970.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>valueOf():Number</literal></term>
+<listitem>
+<simpara>Returns the primitive value of a Date object as a number data type, the number of milliseconds since midnight 01 January, 1970 UTC. This method is functionally equivalent to the getTime method.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>getTimezoneOffset():Number</literal></term>
+<listitem>
+<simpara>Returns the difference in minutes between local time and Greenwich Mean Time (GMT).</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>getUTCDate():Number</literal></term>
+<listitem>
+<simpara>Returns the day of the month from a date according to Universal Time (from 1-31).</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>getUTCDay():Number</literal></term>
+<listitem>
+<simpara>Returns the day of the week from a date according to Universal Time (from 0-6).</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>getUTCFullYear():Number</literal></term>
+<listitem>
+<simpara>Returns the four-digit year from a date according to Universal Time.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>getUTCHours():Number</literal></term>
+<listitem>
+<simpara>Returns the hour of a date according to Universal Time (from 0-23).</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>getUTCMilliseconds():Number</literal></term>
+<listitem>
+<simpara>Returns the milliseconds of a date according to Universal Time (from 0-999).</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>getUTCMinutes():Number</literal></term>
+<listitem>
+<simpara>Returns the minutes of a date according to Universal Time (from 0-59).</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>getUTCMonth():Number</literal></term>
+<listitem>
+<simpara>Returns the month from a Date object according to Universal Time (from 0-11).</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>getUTCSeconds():Number</literal></term>
+<listitem>
+<simpara>Returns the seconds of a date according to Universal Time (from 0-59).</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>getYear():Number deprecated</literal></term>
+<listitem>
+<simpara>Returns the year as a two-digit or a three/four-digit number, depending on the browser. Use getFullYear() instead!</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>setDate(day):Number</literal></term>
+<listitem>
+<simpara>Sets the day of the month from a Date object (from 1-31).</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>setFullYear(full year, month=, day=):Number</literal></term>
+<listitem>
+<simpara>Sets the year as a four-digit number.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>setHours(hours,minutes=,seconds=,milis=):Number</literal></term>
+<listitem>
+<simpara>Sets the hour of a day (from 0-23).</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>setMilliseconds(mills):Number</literal></term>
+<listitem>
+<simpara>Sets the milliseconds of a Date object (from 0-999).</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>setMinutes(minutes,=seconds,=millis):Number</literal></term>
+<listitem>
+<simpara>Sets the minutes of a date (from 0-59).</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>setMonth" directType="Number(month,day=):Number</literal></term>
+<listitem>
+<simpara>Sets the month from a date (from 0-11).</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>setSeconds(seconds,millis=):number</literal></term>
+<listitem>
+<simpara>Sets the seconds of a date (from 0-59).</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>setTime(mills):Number</literal></term>
+<listitem>
+<simpara>Sets the number of milliseconds since midnight Jan 1, 1970.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>setUTCDate(day):Number</literal></term>
+<listitem>
+<simpara>Sets the day of the month from a date according to Universal Time (from 0-6).</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>setUTCFullYear(fullyear,month=,day=):Number</literal></term>
+<listitem>
+<simpara>Sets the four-digit year from a date according to Universal Time.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>setUTCHours(hours,minutes=,seconds=,millis=):Number</literal></term>
+<listitem>
+<simpara>Sets the hour of a date according to Universal Time (from 0-23).</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>setUTCMilliseconds(mills):Number</literal></term>
+<listitem>
+<simpara>Sets the milliseconds of a date according to Universal Time (from 0-999).</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>setUTCMinutes(minutes,seconds=,millis=):Number</literal></term>
+<listitem>
+<simpara>Sets the minutes of a date according to Universal Time time (from 0-59).</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>setUTCMonth(month,day=):Number</literal></term>
+<listitem>
+<simpara>Sets the month from a Date object according to Universal Time (from 0-11).</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>setUTCSeconds(seconds,millis=):Number</literal></term>
+<listitem>
+<simpara>Sets the seconds of a date according to Universal Time (from 0-59).</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>setYear(year):Number deprecated</literal></term>
+<listitem>
+<simpara>Sets the year, as a two-digit or a three/four-digit number, depending on the browser. Use setFullYear() instead!!</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>toDateString():String</literal></term>
+<listitem>
+<simpara>Returns the date portion of a Date object in readable form.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>toLocaleDateString(locales: String|[String]=undefined, options: <subscript>r</subscript>DateTimeFormatOptions=undefined): String</literal></term>
+<listitem>
+<simpara>Converts a Date object, using locales and options as defined in DateTimeFormat of ECMA-402 (Internationalization API), to a string and returns the date and time portion.
+The toLocalString accepts two optional arguments. The semantics of these arguments is defined in
+<link xl:href="https://www.ecma-international.org/ecma-402/4.0/index.html#sup-date.prototype.tolocaledatestring">ECMA-402 (Internationalization API Specification)</link>.
+The specialized definition is found in the runtime library <literal>n4js-runtime-ecma402</literal>.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>toLocaleString(locales: String|[String]=undefined, options: <subscript>r</subscript>DateTimeFormatOptions=undefined): String</literal></term>
+<listitem>
+<simpara>Converts a Date object, using locales and options as defined in DateTimeFormat of ECMA-402 (Internationalization API), to a string.
+The toLocalString accepts two optional arguments. The semantics of these arguments is defined in
+<link xl:href="https://www.ecma-international.org/ecma-402/4.0/index.html#sup-date.prototype.tolocalestring">ECMA-402 (Internationalization API Specification)</link>.
+In N4JS, the base definition does not define that method, instead Date inherits <literal>toLocaleString</literal> from Object. The specialized
+definition is found in the runtime library <literal>n4js-runtime-ecma402</literal>.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>toLocaleTimeString(locales: String|[String]=undefined, options: <subscript>r</subscript>DateTimeFormatOptions=undefined): String</literal></term>
+<listitem>
+<simpara>Converts a Date object, using locales and options as defined in DateTimeFormat of ECMA-402 (Internationalization API), to a string and returns the time portion.
+The semantics of these arguments is defined in
+<link xl:href="https://www.ecma-international.org/ecma-402/4.0/index.html#sup-date.prototype.tolocaletimestring">ECMA-402 (Internationalization API Specification)</link>.
+The specialized definition is found in the runtime library <literal>n4js-runtime-ecma402</literal>.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>toString():String</literal></term>
+<listitem>
+<simpara>Returns a String value for this object.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>toTimeString():String</literal></term>
+<listitem>
+<simpara>Returns the time portion of a Date object in readable form.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>toUTCString():String</literal></term>
+<listitem>
+<simpara>Converts a Date object, according to Universal Time, to a string.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+</section>
+<section xml:id="_math" role="language-n4js">
+<title>Math</title>
+<simpara><literal>Math</literal> is not instantiable and only provides static properties and methods.</simpara>
+<section xml:id="static-attributes-1">
+<title>Static Attributes</title>
+<variablelist>
+<varlistentry>
+<term><literal>E:Number</literal></term>
+<listitem>
+<simpara>Euler&#8217;s constant and the base of natural logarithms, approximately 2.718.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>LN2:Number</literal></term>
+<listitem>
+<simpara>Natural logarithm of 2, approximately 0.693.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>LN10:Number</literal></term>
+<listitem>
+<simpara>Natural logarithm of 10, approximately 2.302.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>LOG2E:Number</literal></term>
+<listitem>
+<simpara>Base 2 logarithm of E, approximately 1.442.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>LOG10E:Number</literal></term>
+<listitem>
+<simpara>Base 10 logarithm of E, approximately 0.434.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>PI:Number</literal></term>
+<listitem>
+<simpara>Ratio of the circumference of a circle to its diameter, approximately 3.14159.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>SQRT1_2:Number</literal></term>
+<listitem>
+<simpara>Square root of 1/2; equivalently, 1 over the square root of 2, approximately 0.707.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>SQRT2:Number</literal></term>
+<listitem>
+<simpara>Square root of 2, approximately 1.414.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+<bridgehead xml:id="static-methods-7" renderas="sect3">Static Methods</bridgehead>
+<variablelist>
+<varlistentry>
+<term><literal>abs(x):Number</literal></term>
+<listitem>
+<simpara>Returns the absolute value of a number.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>acos(x:Number):Number</literal></term>
+<listitem>
+<simpara>Returns the arccosine of a number.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>asinx:Number):Number</literal></term>
+<listitem>
+<simpara>Returns the arcsine of a number.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>atan(x:Number):Number</literal></term>
+<listitem>
+<simpara>Returns the arctangent of a number.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>atan2(y:Number,x:Number):Number</literal></term>
+<listitem>
+<simpara>Returns the arctangent of the quotient of its arguments.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>ceil(x):Number</literal></term>
+<listitem>
+<simpara>Returns the smallest integer greater than or equal to a number.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>cos(x):Number</literal></term>
+<listitem>
+<simpara>Returns the arctangent of the quotient of its arguments.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>exp(x):Number</literal></term>
+<listitem>
+<simpara>Returns Enumber, where number is the argument, and E is Euler&#8217;s constant (2.718&#8230;&#8203;), the base of the natural logarithm.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>floor(x):Number</literal></term>
+<listitem>
+<simpara>Returns the largest integer less than or equal to a number.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>log(x):Number</literal></term>
+<listitem>
+<simpara>Returns the natural logarithm (loge, also ln) of a number.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>max(value&#8230;&#8203;):Number</literal></term>
+<listitem>
+<simpara>Returns the largest of zero or more numbers.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>min(value&#8230;&#8203;):Number</literal></term>
+<listitem>
+<simpara>Returns the smallest of zero or more numbers.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>pow(base:Number,exponent:Number):Number</literal></term>
+<listitem>
+<simpara>Returns base to the exponent power, that is, baseexponent.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>random():Number</literal></term>
+<listitem>
+<simpara>Returns a pseudorandom number between 0 and 1.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>round(x:Number):Number</literal></term>
+<listitem>
+<simpara>Returns the value of a number rounded to the nearest integer.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>sin(x:Number):Number</literal></term>
+<listitem>
+<simpara>Returns the sine of a number.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>sqrt(x:Number):Number</literal></term>
+<listitem>
+<simpara>Returns the positive square root of a number.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>tan(x:Number):Number</literal></term>
+<listitem>
+<simpara>Returns the tangent of a number.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+</section>
+</section>
+<section xml:id="_regexp" role="language-n4js">
+<title>RegExp</title>
+<simpara><literal>RegExp</literal> does not have a super class.</simpara>
+<bridgehead xml:id="attributes-4" renderas="sect3">Attributes</bridgehead>
+<variablelist>
+<varlistentry>
+<term><literal>global:Boolean</literal></term>
+<listitem>
+<simpara>Whether to test the regular expression against all possible matches in a string, or only against the first.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>ignoreCase:Boolean</literal></term>
+<listitem>
+<simpara>Whether to ignore case while attempting a match in a string.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>lastIndex:Number</literal></term>
+<listitem>
+<simpara>The index at which to start the next match.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>multiline:Boolean</literal></term>
+<listitem>
+<simpara>Whether or not to search in strings across multiple lines.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>source:String</literal></term>
+<listitem>
+<simpara>The text of the pattern.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+<bridgehead xml:id="methods-6" renderas="sect3">Methods</bridgehead>
+<variablelist>
+<varlistentry>
+<term><literal>exec(str:String):Array</literal></term>
+<listitem>
+<simpara>Executes a search for a match in its string parameter.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>test(str:String):Boolean</literal></term>
+<listitem>
+<simpara>Tests for a match in its string parameter.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+</section>
+<section xml:id="_json" role="language-n4js">
+<title>JSON</title>
+<simpara><literal>JSON</literal> is a global object and a subclass of <literal>Object</literal>. Its functionality is provided by two static methods.
+It is not possible to create new instances of type JSON.</simpara>
+<bridgehead xml:id="attributes-5" renderas="sect3">Attributes</bridgehead>
+<simpara>The JSON object does not define own properties.</simpara>
+<bridgehead xml:id="methods-7" renderas="sect3">Methods</bridgehead>
+<simpara>The JSON object does not define own methods.</simpara>
+<bridgehead xml:id="static-methods-8" renderas="sect3">Static Methods</bridgehead>
+<simpara>The parse function parses a JSON text (a JSON-formatted String) and
+produces an ECMAScript value. The JSON format is a restricted form of
+ECMAScript literal. JSON objects are realized as ECMAScript objects.
+JSON arrays are realized as ECMAScript arrays. JSON strings, numbers,
+booleans, and null are realized as ECMAScript Strings, Numbers,
+Booleans, and null. For detailed information see [<link linkend="ECMA11a">ECMA11a(p.S15.12.2)</link>]</simpara>
+<simpara>The optional reviver parameter is a function that takes two parameters
+(key and value). It can filter and transform the results. It is called
+with each of the key/value pairs produced by the parse and its return
+value is used instead of the original value. If it returns what it
+received, the structure is not modified. If it returns then the property
+is deleted from the result.</simpara>
+<simpara>The stringify function returns a String in JSON format representing an
+ECMAScript value. It can take three parameters. The first parameter is
+required. The value parameter is an ECMAScript value which is usually an
+object or array, although it can also be a String, Boolean, Number or
+null.</simpara>
+<simpara>The optional replacer parameter is either a function that alters the way
+objects and arrays are stringified or an array of Strings and Numbers
+that act as a white list for selecting the object properties that will
+be stringified.</simpara>
+<simpara>The optional space parameter is a String or Number that allows the
+result to have whitespace injected into it to improve human readability.</simpara>
+<simpara>For detailed information see [<link linkend="ECMA11a">ECMA11a(p.S15.12.3)</link>].</simpara>
+</section>
+</chapter>
+<chapter xml:id="_n4js-objects">
+<title>N4JS Objects</title>
+<section xml:id="_reflection-model">
+<title>Reflection Model</title>
+<simpara>N4JS provided metadata for reflection (and introspection). This
+information is available via instances of some reflection model classes
+(described below) attached to types and (in some cases) functions.</simpara>
+<simpara>The following class diagrams shows the defined classes. Note that for
+performance reasons, the actual structure may vary from the model.</simpara>
+<figure xml:id="fig-n4js-reflection-classes">
+<title>N4JS Reflection Classes</title>
+<mediaobject>
+<imageobject>
+<imagedata fileref="chapters/a03_n4jsobjects/fig/cd_reflectionModel.svg"/>
+</imageobject>
+<textobject><phrase>cd reflectionModel</phrase></textobject>
+</mediaobject>
+</figure>
+<simpara>Remark: This section is work in progress. The final goal is to provide a
+metamodel similar to Ecore, but we will only add new features if needed.</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">/**
+ * Base class for all N4 reflective elements.
+ */
+export public abstract class N4Element extends Object {
+    /**
+     * Annotations attached to this element.
+     */
+    public Array&lt;N4Annotation&gt; annotations = [];
+
+    /**
+     * The origin string formed as &lt;ID-VERSION&gt;, where ID is containing project artefact id, and VERSION is its version
+     */
+    public String origin;
+
+    /**
+     * Returns true if an annotation with the given name is attached to the element.
+     */
+    public boolean hasAnnotation(string name) {
+        return !!this.anyAnnotation(name)
+    }
+
+    /**
+     * Returns any annotation with the given name attached to the element, or null if no such annotation is found.
+     */
+    public N4Annotation anyAnnotation(string name) {
+        for (var i=this.annotations.length-1; i&gt;=0; i--) {
+            var a = this.annotations[i];
+            if (a) {
+                return a;
+            }
+        }
+        return null;
+    }
+    /**
+     * Returns all annotations with the given name attached to the element, or an empty array if no such annotations are found.
+     */
+    public Array&lt;N4Annotation&gt; allAnnotations(string name) {
+        return this.annotations.filter(function(a){return a.name==name});
+    }
+}
+
+/**
+ * Base class for all reflective classes with a name.
+ */
+export public abstract class N4NamedElement extends N4Element {
+    /**
+     * The simple name of a named element.
+     */
+    public string name;
+}
+
+/**
+ * Base class for all reflective classes describing a type (declaration).
+ */
+export public abstract class N4Type extends N4NamedElement {
+    /**
+     * The FQN of the type.
+     */
+    public string fqn;
+
+    /**
+     * Returns true if this N4Class describes an N4-class declaration.
+     */
+    public boolean get isClass() { return false; }
+
+    /**
+     * Returns true if this N4Class describes an N4-interface declaration.
+     */
+    public boolean get isInterface() { return false; }
+
+    /**
+     * Returns true if this N4Class describes an N4-enumeration declaration.
+     */
+    public boolean get isEnum() { return false; }
+}
+
+/**
+ * Base class for meta types of classes or interfaces.
+ */
+export public abstract class N4Classifier extends N4Type {
+
+    /**
+     * The N4Class of the super type, may be null if super type is a not an N4Class.
+     */
+    public N4Class n4superType;
+
+    /**
+     * Array of the FQN of all (transitively) implemented interfaces, i.e. interfaces directly implemented by this class, its super
+     * class or interfaces extended by directly implemented interfaces.
+     */
+    public Array&lt;string&gt; allImplementedInterfaces;
+
+    /**
+     * Array of all owned members, that is members defined in the class directly.
+     * This field is private as it is an internal detail, members are accessed via methods defined in this class.
+     */
+    private Array&lt;N4Member&gt; ownedMembers;
+
+    /**
+     * Array of all consumed members, that is members mixed into the classifier via interface implementation and default methods.
+     * This field is private as it is an internal detail, members are accessed via methods defined in this class.
+     */
+    private Array&lt;N4Member&gt; consumedMembers;
+
+    /**
+     * Only used internally, must not be called by client.
+     */
+    protected constructor(@Spec ~~this spec) {}
+
+    /**
+     * Returns all members defined by this class directly, consumed, and inherited. The boolean flags control which members are returned.
+     *
+     * @param consumed if set, consumed members are returned as well (false by default)
+     * @param inherited if set, inherited members are returned as well (false by default)
+     * @param _static if set, static members are returned, otherwise instance members (false by default).
+     * @return array of members, may be empty but never null
+     */
+    public Array&lt;? extends N4Member&gt; members(boolean? consumed, boolean? inherited, boolean? _static) {
+        return null; // TODO
+    }
+
+    /**
+     * Returns all members defined in this classifier (or inherited) with an annotation
+     * of given name attached to it. The boolean flags control which methods are returned.
+     *
+     * @param name name of annotation to be used as filter
+     * @param consumed if set, consumed members are returned as well (false by default)
+     * @param inherited if set, inherited members are returned as well (false by default)
+     * @param _static if set, static members are returned, otherwise instance members (false by default).
+     * @return array of members, may be empty but never null
+     */
+    public Array&lt;? extends N4Member&gt; membersWithAnnotation(string name, boolean? consumed, boolean? inherited, boolean? _static) {
+        return null; // TODO
+    }
+
+    /**
+     * Returns all data fields defined by this class directly, consumed, and inherited. The boolean flags control which data fields are returned.
+     *
+     * @param consumed if set, consumed data fields are returned as well (false by default)
+     * @param inherited if set, inherited data fields are returned as well (false by default)
+     * @param _static if set, static data fields are returned, otherwise instance members (false by default).
+     * @return array of data fields, may be empty but never null
+     */
+    public Array&lt;? extends N4DataField&gt; dataFields(boolean? consumed, boolean? inherited, boolean? _static) {
+        return null; // TODO
+    }
+
+    /**
+     * Returns all data fields defined in this classifier (or inherited) with an annotation
+     * of given name attached to it. The boolean flags control which data fields are returned.
+     *
+     * @param name name of annotation to be used as filter
+     * @param consumed if set, consumed data fields are returned as well (false by default)
+     * @param inherited if set, inherited data fields are returned as well (false by default)
+     * @param _static if set, static data fields are returned, otherwise instance members (false by default).
+     * @return array of data fields, may be empty but never null
+     */
+    public Array&lt;? extends N4DataField&gt; dataFieldsWithAnnotation(string name, boolean? consumed, boolean? inherited, boolean? _static) {
+        return null; // TODO
+    }
+
+    /**
+     * Returns all methods defined by this class directly, consumed, and inherited. The boolean flags control which methods are returned.
+     *
+     * @param consumed if set, consumed methods are returned as well (false by default)
+     * @param inherited if set, inherited methods are returned as well (false by default)
+     * @param _static if set, static methods are returned, otherwise instance members (false by default).
+     * @return array of methods, may be empty but never null
+     */
+    public Array&lt;? extends N4Method&gt; methods(boolean? consumed, boolean? inherited, boolean? _static) {
+        return null; // TODO
+    }
+
+    /**
+     * Returns all methods defined in this classifier (or inherited) with an annotation
+     * of given name attached to it. The boolean flags control which methods are returned.
+     *
+     * @param name name of annotation to be used as filter
+     * @param consumed if set, consumed methods are returned as well (false by default)
+     * @param inherited if set, inherited methods are returned as well (false by default)
+     * @param _static if set, static methods are returned, otherwise instance members (false by default).
+     * @return array of methods, may be empty but never null
+     */
+    public Array&lt;? extends N4Method&gt; methodsWithAnnotation(string name, boolean? consumed, boolean? inherited, boolean? _static) {
+        return null; // TODO
+    }
+
+
+}
+
+/**
+ * Meta information of an n4 class.
+ */
+export @Final public class N4Class extends N4Classifier {
+
+    /**
+     * Returns the N4Class instance for a given n4object. This is similar to
+     * {@code n4object.constructor.n4type}, however it can also be used in interfaces
+     * to get reflective information of the implementor.
+     */
+    public static N4Class of(N4Object n4object) {
+        return n4object.constructor.n4type
+    }
+
+    /**
+     * Returns true if this N4Class describes an N4-class declaration.
+     */
+    @Override
+    public boolean get isClass() { return true; }
+}
+
+
+/**
+ * Meta information of an n4 interface.
+ */
+export @Final public class N4Interface extends N4Classifier {
+    /**
+     * Returns true if this N4Class describes an N4-interface declaration.
+     */
+    @Override
+    public boolean get isInterface() { return true; }
+}
+
+/**
+ * Description of a member, that is a method or field.
+ */
+export public abstract class N4Member extends N4Element {
+    public string name;
+}
+
+/**
+ * Description of a method.
+ */
+export @Final public class N4Method extends N4Member {
+    public Function jsFunction;
+}
+
+/**
+ * Description of a simple data field.
+ */
+export @Final public class N4DataField extends N4Member {
+}
+
+/**
+ * Description of an accessor, that is a getter or setter.
+ */
+export @Final public class N4Accessor extends N4Member {
+    /**
+     * Flag indicating whether accessor is a getter or setter, internal detail.
+     */
+    private boolean getter;
+    /**
+     * Returns true if accessor is a getter.
+     */
+    public boolean isGetter() { return this.getter; }
+    /**
+     * Returns true if accessor is a setter.
+     */
+    public boolean isSetter() { return ! this.getter; }
+}
+
+/**
+ * Description of an N4Enum
+ */
+export @Final public class N4EnumType extends N4Type {
+    /**
+     * Returns true if this N4Clasifier describes an N4-enumeration declaration.
+     */
+    @Override public boolean get isEnum() { return true; }
+    /**
+     * Returns the N4EnumType instance for a given enum literal. This is similar to
+     * {@code n4enum.constructor.n4type}.
+     */
+    public static N4EnumType of(N4Enum n4enum) {
+        return n4enum.constructor.n4type
+    }
+}
+
+/**
+ * Base class for all enumeration, literals are assumed to be static constant fields of concrete subclasses.
+ */
+export public abstract class N4Enum  extends Object {
+
+    /**
+     * Returns the name of a concrete literal
+     */
+    public abstract string get name();
+
+    /**
+     * Returns the value of a concrete literal. If no value is
+     * explicitly set, it is similar to the name.
+     */
+    public abstract string get value()
+
+    /**
+     * Returns a string representation of a concrete literal, it returns
+     * the same result as value()
+     */
+    @Override public string toString() { return this.value }
+
+    /**
+     * Returns the enum class object of this enum literal for reflection.
+     * The very same meta class object can be retrieved from the enumeration type directly.
+     */
+    public abstract N4Enum get n4Enum()
+
+    /**
+     * Natively overridden by concrete enums.
+     */
+    public static Array&lt;? extends N4Enum&gt; get values() { return null; }
+
+    /**
+     * Natively overridden by concrete enums.
+     */
+    public static N4Enum valueByName(string name) { return null; }
+
+    /**
+     * Returns the meta class object of this class for reflection.
+     * The very same meta class object can be retrieved from an instance by calling
+     * &lt;code&gt;instance.constructor.n4type&lt;/code&gt;
+     */
+    public static N4EnumType get n4type() { return null; }
+}
+
+/**
+ * Annotation with value.
+ */
+export @Final public class N4Annotation extends Object {
+    public string name;
+    public union{string,number} value;
+}
+
+/**
+ * The base class for all instances of n4 classes.
+ */
+export public class N4Object {
+    /**
+     * Returns the meta class object of this class for reflection.
+     * The very same meta class object can be retrieved from an instance by calling
+     * &lt;code&gt;instance.constructor.n4type&lt;/code&gt;
+     */
+    // defined in types model, added by $makeClass:
+    // public static N4Class get n4type() { return null; }
+}</programlisting>
+</section>
+<section xml:id="_error-types">
+<title>Error Types</title>
+<simpara>N4JS provides additional Error types as subtypes of <literal>Error</literal>.</simpara>
+<section xml:id="_n4apinotimplemented" role="language-n4js">
+<title>N4ApiNotImplemented</title>
+<simpara>Considering API definitions and concrete implementations of those APIs
+the error <literal>N4-Api-Not-Implemented-Error</literal> is introduced to specifically report missing implementations.
+Instances of this error type are inserted internally during the
+transpilation of API-implementing projects. Whenever a difference to the
+API in form of a missing implementation is encountered, the transpiler
+will insert stub-code throwing an instance of <literal>N4-Api-Not-Implemented-Error</literal>.</simpara>
+<simpara>API-testing projects can catch those errors and act accordingly. This
+enables tracking of completeness of implementations by counting the
+occasions an <literal>N4-Api-NotImplemented-Error</literal> was encountered.</simpara>
+<programlisting language="n4js" linenumbering="unnumbered">/**
+ * Error type reporting a not implemented situation.
+ */
+public class N4ApiNotImplementedError extends Error {  }</programlisting>
+</section>
+</section>
+</chapter>
+<appendix xml:id="_acronyms">
+<title>Acronyms</title>
+<informaltable xml:id="AC" role="language-bash" frame="all" rowsep="1" colsep="1">
+<tgroup cols="4">
+<colspec colname="col_1" colwidth="8.3333*"/>
+<colspec colname="col_2" colwidth="41.6666*"/>
+<colspec colname="col_3" colwidth="8.3333*"/>
+<colspec colname="col_4" colwidth="41.6668*"/>
+<tbody>
+<row>
+<entry align="center" valign="top"><simpara><literal>CDep</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">Compile-Time Dependency</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><literal>RDep</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">Run-Time Dependency</emphasis></simpara></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><literal>LDep</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">Load-Time Dependency</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><literal>IDep</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">Initialization-Time Dependency</emphasis></simpara></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><literal>EDep</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">Execution-Time Dependency</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><literal>ANTLR</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">ANother Tool for Language Recognition</emphasis></simpara></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><literal>API</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">Application Programming Interface</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><literal>AST</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">Abstract Syntax Tree</emphasis></simpara></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><literal>ASI</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">Automatic Semicolon Insertion</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><literal>BNF</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">Backus-Naur Form</emphasis></simpara></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><literal>CLI</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">Command Line Interface (including a headless compiler and runner.)</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><literal>DI</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">Dependency Injection</emphasis></simpara></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><literal>DIC</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">DI Component</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><literal>DOM</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">Document Object Model</emphasis></simpara></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><literal>DSL</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">Domain Specific Language</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><literal>EBNF</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">Extended Backus-Naur Form</emphasis></simpara></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><literal>EMF</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">Eclipse Modeling Framework <anchor xml:id="EMF" xreflabel="[EMF]"/></emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><literal>FQN</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">Fully Qualified Name</emphasis></simpara></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><literal>GLB</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">Greatest Lower Bound, also known as <emphasis>infimum</emphasis></emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><literal>GCST</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">Greatest Common Sub Type, also known as <emphasis>meet</emphasis></emphasis></simpara></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><literal>IDE</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">Integrated Development Environment</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><literal>IDL</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">Interface Definition Language</emphasis></simpara></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><literal>LSP</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">Liskov Substitution Principle [<link linkend="Martin96b">Martin96b</link>]</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><literal>LUB</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">Least Upper Bound, also known as <emphasis>supremum</emphasis></emphasis></simpara></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><literal>LCST</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">Least Common Super Type, also known as <emphasis>join</emphasis></emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><literal>N4JS</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">N4JS for JavaScript</emphasis></simpara></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><literal>N4JSED</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">N4JS Environment Definition</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><literal>N4JSIDE</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">N4JS Integrated Development Environment (Eclipse-based IDE for all N4JS related languages and projects)</emphasis></simpara></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><literal>VM</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">Virtual Machine</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><literal>XML</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">Extensible Markup Language</emphasis></simpara></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><literal>XSLT / XSL</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">XSL Transformations</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><literal>XSL</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">Extensible Stylesheet Language</emphasis></simpara></entry>
+</row>
+<row>
+<entry align="center" valign="top"><simpara><literal>WYSIWYG</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">What You See Is What You Get</emphasis></simpara></entry>
+<entry align="center" valign="top"><simpara><literal>WLOG</literal></simpara></entry>
+<entry align="left" valign="top"><simpara><emphasis role="strong">Without loss of generality</emphasis></simpara></entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+</appendix>
+<appendix xml:id="sec:License">
+<title>License</title>
+<simpara>This specification and the accompanying materials is made available
+under the terms of the Eclipse Public License v1.0 which accompanies
+this distribution, and is available at <link xl:href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</link></simpara>
+<bridgehead xml:id="_eclipse-public-license-v-1-0" renderas="sect2">Eclipse Public License - v 1.0</bridgehead>
+<simpara>THE ACCOMPANYING PROGRAM IS PROVIDED UNDER THE TERMS OF THIS ECLIPSE
+PUBLIC LICENSE (<literal>AGREEMENT</literal>). ANY USE, REPRODUCTION OR DISTRIBUTION OF
+THE PROGRAM CONSTITUTES RECIPIENT’S ACCEPTANCE OF THIS AGREEMENT.</simpara>
+<bridgehead xml:id="_1-definitions" renderas="sect3">1. DEFINITIONS</bridgehead>
+<variablelist>
+<varlistentry>
+<term><literal>Contribution</literal> means: </term>
+<listitem>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>in the case of the initial Contributor, the initial code and
+documentation distributed under this Agreement, and</simpara>
+</listitem>
+<listitem>
+<simpara>in the case of each subsequent Contributor:</simpara>
+<orderedlist numeration="loweralpha">
+<listitem>
+<simpara>changes to the Program, and</simpara>
+</listitem>
+<listitem>
+<simpara>additions to the Program;</simpara>
+<simpara>where such changes and/or additions to the Program originate from and
+are distributed by that particular Contributor. A Contribution
+’originates’ from a Contributor if it was added to the Program by such
+Contributor itself or anyone acting on such Contributor’s behalf.
+Contributions do not include additions to the Program which:</simpara>
+<orderedlist numeration="lowerroman">
+<listitem>
+<simpara>are separate modules of software distributed in conjunction with the Program
+under their own license agreement, and</simpara>
+</listitem>
+<listitem>
+<simpara>are not derivative works of the Program.</simpara>
+</listitem>
+</orderedlist>
+</listitem>
+</orderedlist>
+</listitem>
+</orderedlist>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>Contributor</literal></term>
+<listitem>
+<simpara>means any person or entity that distributes the Program.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>Licensed Patents</literal> </term>
+<listitem>
+<simpara>mean patent claims licensable by a Contributor
+which are necessarily infringed by the use or sale of its Contribution
+alone or when combined with the Program.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>Program</literal> </term>
+<listitem>
+<simpara>means the Contributions distributed in accordance with this
+Agreement.</simpara>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><literal>Recipient</literal> </term>
+<listitem>
+<simpara>means anyone who receives the Program under this
+Agreement, including all Contributors.</simpara>
+</listitem>
+</varlistentry>
+</variablelist>
+<bridgehead xml:id="_2-grant-of-rights" renderas="sect3">2. GRANT OF RIGHTS</bridgehead>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>Subject to the terms of this Agreement, each Contributor hereby
+grants Recipient a non-exclusive, worldwide, royalty-free copyright
+license to reproduce, prepare derivative works of, publicly display,
+publicly perform, distribute and sublicense the Contribution of such
+Contributor, if any, and such derivative works, in source code and
+object code form.</simpara>
+</listitem>
+<listitem>
+<simpara>Subject to the terms of this Agreement, each Contributor hereby
+grants Recipient a non-exclusive, worldwide, royalty-free patent license
+under Licensed Patents to make, use, sell, offer to sell, import and
+otherwise transfer the Contribution of such Contributor, if any, in
+source code and object code form. This patent license shall apply to the
+combination of the Contribution and the Program if, at the time the
+Contribution is added by the Contributor, such addition of the
+Contribution causes such combination to be covered by the Licensed
+Patents. The patent license shall not apply to any other combinations
+which include the Contribution. No hardware per se is licensed
+hereunder.</simpara>
+</listitem>
+<listitem>
+<simpara>Recipient understands that although each Contributor grants the
+licenses to its Contributions set forth herein, no assurances are
+provided by any Contributor that the Program does not infringe the
+patent or other intellectual property rights of any other entity. Each
+Contributor disclaims any liability to Recipient for claims brought by
+any other entity based on infringement of intellectual property rights
+or otherwise. As a condition to exercising the rights and licenses
+granted hereunder, each Recipient hereby assumes sole responsibility to
+secure any other intellectual property rights needed, if any. For
+example, if a third party patent license is required to allow Recipient
+to distribute the Program, it is Recipient’s responsibility to acquire
+that license before distributing the Program.</simpara>
+</listitem>
+<listitem>
+<simpara>Each Contributor represents that to its knowledge it has sufficient
+copyright rights in its Contribution, if any, to grant the copyright
+license set forth in this Agreement.</simpara>
+</listitem>
+</orderedlist>
+<bridgehead xml:id="_3-requirements" renderas="sect3">3. REQUIREMENTS</bridgehead>
+<simpara>A Contributor may choose to distribute the Program in object code form
+under its own license agreement, provided that:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>it complies with the terms and conditions of this Agreement; and</simpara>
+</listitem>
+<listitem>
+<simpara>its license agreement:</simpara>
+<orderedlist numeration="loweralpha">
+<listitem>
+<simpara>effectively disclaims on behalf of all Contributors all warranties
+and conditions, express and implied, including warranties or conditions
+of title and non-infringement, and implied warranties or conditions of
+merchantability and fitness for a particular purpose;</simpara>
+</listitem>
+<listitem>
+<simpara>effectively excludes on behalf of all Contributors all liability for
+damages, including direct, indirect, special, incidental and
+consequential damages, such as lost profits;</simpara>
+</listitem>
+<listitem>
+<simpara>states that any provisions which differ from this Agreement are
+offered by that Contributor alone and not by any other party; and</simpara>
+</listitem>
+<listitem>
+<simpara>states that source code for the Program is available from such
+Contributor, and informs licensees how to obtain it in a reasonable
+manner on or through a medium customarily used for software exchange.</simpara>
+</listitem>
+</orderedlist>
+</listitem>
+</orderedlist>
+<simpara>When the Program is made available in source code form:</simpara>
+<orderedlist numeration="arabic">
+<listitem>
+<simpara>it must be made available under this Agreement; and</simpara>
+</listitem>
+<listitem>
+<simpara>a copy of this Agreement must be included with each copy of the
+Program.</simpara>
+</listitem>
+</orderedlist>
+<simpara>Contributors may not remove or alter any copyright notices contained
+within the Program.</simpara>
+<simpara>Each Contributor must identify itself as the originator of its
+Contribution, if any, in a manner that reasonably allows subsequent
+Recipients to identify the originator of the Contribution.</simpara>
+<bridgehead xml:id="_4-commercial-distribution" renderas="sect3">4. COMMERCIAL DISTRIBUTION</bridgehead>
+<simpara>Commercial distributors of software may accept certain responsibilities
+with respect to end users, business partners and the like. While this
+license is intended to facilitate the commercial use of the Program, the
+Contributor who includes the Program in a commercial product offering
+should do so in a manner which does not create potential liability for
+other Contributors. Therefore, if a Contributor includes the Program in
+a commercial product offering, such Contributor (<literal>Commercial
+Contributor</literal>) hereby agrees to defend and indemnify every other
+Contributor (<literal>Indemnified Contributor</literal>) against any losses, damages
+and costs (collectively <literal>Losses</literal>) arising from claims, lawsuits and
+other legal actions brought by a third party against the Indemnified
+Contributor to the extent caused by the acts or omissions of such
+Commercial Contributor in connection with its distribution of the
+Program in a commercial product offering. The obligations in this
+section do not apply to any claims or Losses relating to any actual or
+alleged intellectual property infringement. In order to qualify, an
+Indemnified Contributor must: a) promptly notify the Commercial
+Contributor in writing of such claim, and b) allow the Commercial
+Contributor to control, and cooperate with the Commercial Contributor
+in, the defense and any related settlement negotiations. The Indemnified
+Contributor may participate in any such claim at its own expense.</simpara>
+<simpara>For example, a Contributor might include the Program in a commercial
+product offering, Product X. That Contributor is then a Commercial
+Contributor. If that Commercial Contributor then makes performance
+claims, or offers warranties related to Product X, those performance
+claims and warranties are such Commercial Contributor’s responsibility
+alone. Under this section, the Commercial Contributor would have to
+defend claims against the other Contributors related to those
+performance claims and warranties, and if a court requires any other
+Contributor to pay any damages as a result, the Commercial Contributor
+must pay those damages.</simpara>
+<bridgehead xml:id="_5-no-warranty" renderas="sect3">5. NO WARRANTY</bridgehead>
+<simpara>EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, THE PROGRAM IS PROVIDED
+ON AN <literal>AS IS</literal> BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,
+EITHER EXPRESS OR IMPLIED INCLUDING, WITHOUT LIMITATION, ANY WARRANTIES
+OR CONDITIONS OF TITLE, NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR
+A PARTICULAR PURPOSE. Each Recipient is solely responsible for
+determining the appropriateness of using and distributing the Program
+and assumes all risks associated with its exercise of rights under this
+Agreement , including but not limited to the risks and costs of program
+errors, compliance with applicable laws, damage to or loss of data,
+programs or equipment, and unavailability or interruption of operations.</simpara>
+<bridgehead xml:id="_6-disclaimer-of-liability" renderas="sect3">6. DISCLAIMER OF LIABILITY</bridgehead>
+<simpara>EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, NEITHER RECIPIENT NOR
+ANY CONTRIBUTORS SHALL HAVE ANY LIABILITY FOR ANY DIRECT, INDIRECT,
+INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING
+WITHOUT LIMITATION LOST PROFITS), HOWEVER CAUSED AND ON ANY THEORY OF
+LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OR
+DISTRIBUTION OF THE PROGRAM OR THE EXERCISE OF ANY RIGHTS GRANTED
+HEREUNDER, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.</simpara>
+<bridgehead xml:id="_7-general" renderas="sect3">7. GENERAL</bridgehead>
+<simpara>If any provision of this Agreement is invalid or unenforceable under
+applicable law, it shall not affect the validity or enforceability of
+the remainder of the terms of this Agreement, and without further action
+by the parties hereto, such provision shall be reformed to the minimum
+extent necessary to make such provision valid and enforceable.</simpara>
+<simpara>If Recipient institutes patent litigation against any entity (including
+a cross-claim or counterclaim in a lawsuit) alleging that the Program
+itself (excluding combinations of the Program with other software or
+hardware) infringes such Recipient’s patent(s), then such Recipient’s
+rights granted under Section 2(b) shall terminate as of the date such
+litigation is filed.</simpara>
+<simpara>All Recipient’s rights under this Agreement shall terminate if it fails
+to comply with any of the material terms or conditions of this Agreement
+and does not cure such failure in a reasonable period of time after
+becoming aware of such noncompliance. If all Recipient’s rights under
+this Agreement terminate, Recipient agrees to cease use and distribution
+of the Program as soon as reasonably practicable. However, Recipient’s
+obligations under this Agreement and any licenses granted by Recipient
+relating to the Program shall continue and survive.</simpara>
+<simpara>Everyone is permitted to copy and distribute copies of this Agreement,
+but in order to avoid inconsistency the Agreement is copyrighted and may
+only be modified in the following manner. The Agreement Steward reserves
+the right to publish new versions (including revisions) of this
+Agreement from time to time. No one other than the Agreement Steward has
+the right to modify this Agreement. The Eclipse Foundation is the
+initial Agreement Steward. The Eclipse Foundation may assign the
+responsibility to serve as the Agreement Steward to a suitable separate
+entity. Each new version of the Agreement will be given a distinguishing
+version number. The Program (including Contributions) may always be
+distributed subject to the version of the Agreement under which it was
+received. In addition, after a new version of the Agreement is
+published, Contributor may elect to distribute the Program (including
+its Contributions) under the new version. Except as expressly stated in
+Sections 2(a) and 2(b) above, Recipient receives no rights or licenses
+to the intellectual property of any Contributor under this Agreement,
+whether expressly, by implication, estoppel or otherwise. All rights in
+the Program not expressly granted under this Agreement are reserved.</simpara>
+<simpara>This Agreement is governed by the laws of the State of New York and the
+intellectual property laws of the United States of America. No party to
+this Agreement will bring a legal action under this Agreement more than
+one year after the cause of action arose. Each party waives its rights
+to a jury trial in any resulting litigation.</simpara>
+</appendix>
+<appendix xml:id="_bibliography">
+<title>Bibliography</title>
+<simpara><anchor xml:id="ECMA15a" xreflabel="[ECMA15a]"/>ECMA. (2015). <emphasis>ECMAScript 2015 Language Specification</emphasis>. Retrieved from <link xl:href="http://www.ecma-international.org/ecma-262/6.0/index.html">http://www.ecma-international.org/ecma-262/6.0/index.html</link></simpara>
+<simpara><anchor xml:id="ECMA11a" xreflabel="[ECMA11a]"/>(2011). <emphasis>ECMAScript Language Specification</emphasis>. Retrieved from <link xl:href="http://www.ecma-international.org/publications/standards/Ecma-262.htm">http://www.ecma-international.org/publications/standards/Ecma-262.htm</link></simpara>
+<simpara><anchor xml:id="Pierce02a" xreflabel="[Pierce02a]"/>Pierce, Benjamin C.. (2002). <emphasis>Types and Programming Languages</emphasis>. </simpara>
+<simpara><anchor xml:id="Gosling15a" xreflabel="[Gosling15a]"/>Gosling, James and Joy, Bill and Steele, Guy and Bracha, Gilad and Buckley, Alex. (2015). <emphasis>The Java Language Specification. Java SE 8 Edition</emphasis>. Retrieved from <link xl:href="http://docs.oracle.com/javase/specs/jls/se8/jls8.pdf">http://docs.oracle.com/javase/specs/jls/se8/jls8.pdf</link></simpara>
+<simpara><anchor xml:id="Gosling12a" xreflabel="[Gosling12a]"/>Gosling, James and Joy, Bill and Steele, Guy and Bracha, Gilad and Buckley, Alex. (2012). <emphasis>The Java Language Specification. Java SE 7 Edition</emphasis>. Retrieved from <link xl:href="http://docs.oracle.com/javase/specs/jls/se7/jls7.pdf">http://docs.oracle.com/javase/specs/jls/se7/jls7.pdf</link></simpara>
+<simpara><anchor xml:id="Nielson99a" xreflabel="[Nielson99a]"/>Nielson, Flemming and Nielson, HanneRiis. (1999). <emphasis>Type and Effect Systems</emphasis>. Retrieved from <link xl:href="http://dx.doi.org/10.1007/3-540-48092-7_6">http://dx.doi.org/10.1007/3-540-48092-7_6</link></simpara>
+<simpara><anchor xml:id="Crary02a" xreflabel="[Crary02a]"/>Crary, Karl and Weirich, Stephanie and Morrisett, Greg. (2002). <emphasis>Intensional polymorphism in type-erasure semantics</emphasis>. Retrieved from <link xl:href="http://journals.cambridge.org/article_S0956796801004282">http://journals.cambridge.org/article_S0956796801004282</link></simpara>
+<simpara><anchor xml:id="Igarashi01a" xreflabel="[Igarashi01a]"/>Igarashi, Atsushi and Pierce, Benjamin C. and Wadler, Philip. (2001). <emphasis>Featherweight Java: a minimal core calculus for Java and GJ</emphasis>. </simpara>
+<simpara><anchor xml:id="Torgersen05a" xreflabel="[Torgersen05a]"/>Torgersen, Mads and Ernst, Erik and Hansen, Christian Plesner. (2005). <emphasis>Wild FJ</emphasis>. Retrieved from <link xl:href="http://homepages.inf.ed.ac.uk/wadler/fool/program/14.html">http://homepages.inf.ed.ac.uk/wadler/fool/program/14.html</link></simpara>
+<simpara><anchor xml:id="Cameron08b" xreflabel="[Cameron08b]"/>Cameron, Nicholas and Drossopoulou, Sophia and Ernst, Erik. (2008). <emphasis>A Model for Java with Wildcards</emphasis>. Retrieved from <link xl:href="http://dx.doi.org/10.1007/978-3-540-70592-5_2">http://dx.doi.org/10.1007/978-3-540-70592-5_2</link></simpara>
+<simpara><anchor xml:id="Cameron09a" xreflabel="[Cameron09a]"/>Cameron, Nicholas. (2009). <emphasis>Existential Types for Variance&#8201;&#8212;&#8201;Java Wildcards and Ownership Types</emphasis>. Retrieved from <link xl:href="http://www.doc.ic.ac.uk/~ncameron/papers/cameron_thesis.pdf">http://www.doc.ic.ac.uk/~ncameron/papers/cameron_thesis.pdf</link></simpara>
+<simpara><anchor xml:id="Summers10a" xreflabel="[Summers10a]"/>Summers, Alexander J. and Cameron, Nicholas and Dezani-Ciancaglini, Mariangiola and Drossopoulou, Sophia. (2010). <emphasis>Towards a semantic model for Java wildcards</emphasis>. </simpara>
+<simpara><anchor xml:id="Wehr08a" xreflabel="[Wehr08a]"/>Wehr, Stefan and Thiemann, Peter. (2008). <emphasis>Subtyping Existential Types</emphasis>. Retrieved from <link xl:href="http://www.informatik.uni-freiburg.de/~wehr/publications/Wehr_Subtyping_existential_types.pdf">http://www.informatik.uni-freiburg.de/~wehr/publications/Wehr_Subtyping_existential_types.pdf</link></simpara>
+<simpara><anchor xml:id="Igarashi07a" xreflabel="[Igarashi07a]"/>Igarashi, Atsushi and Nagira, Hideshi. (2007). <emphasis>Union Types for Object-Oriented Programming</emphasis>. Retrieved from <link xl:href="http://www.jot.fm/issues/issue_2007_02/article3/">http://www.jot.fm/issues/issue_2007_02/article3/</link></simpara>
+<simpara><anchor xml:id="King13a" xreflabel="[King13a]"/>King, Gavin. (2013). <emphasis>The Ceylon Language</emphasis>. Red Hat, Inc.. Retrieved from <link xl:href="http://ceylon-lang.org/documentation/1.0/spec/pdf/ceylon-language-specification.pdf">http://ceylon-lang.org/documentation/1.0/spec/pdf/ceylon-language-specification.pdf</link></simpara>
+<simpara><anchor xml:id="Laurent12a" xreflabel="[Laurent12a]"/>Laurent, Olivier. (2012). <emphasis>Intersection types with subtyping by means of cut elimination</emphasis>. </simpara>
+<simpara><anchor xml:id="W3C:Steen:14:XL" xreflabel="[W3C:Steen:14:XL]"/>Steen, Hallvord and Aubourg, Julian and van Kesteren, Anne and Song, Jungkee. (2014). <emphasis>XMLHttpRequest Level 1</emphasis>. </simpara>
+<simpara><anchor xml:id="Dart13a" xreflabel="[Dart13a]"/>Dart Team. (2013). <emphasis>Dart Programming Language Specification</emphasis>. Retrieved from <link xl:href="http://www.dartlang.org/docs/spec/latest/dart-language-specification.pdf">http://www.dartlang.org/docs/spec/latest/dart-language-specification.pdf</link></simpara>
+<simpara><anchor xml:id="OMG14a" xreflabel="[OMG14a]"/>OMG. (2014). <emphasis>Interface Definition Language</emphasis>. Object Management Group. Retrieved from <link xl:href="http://www.omg.org/cgi-bin/doc?formal/2014-03-01.pdf">http://www.omg.org/cgi-bin/doc?formal/2014-03-01.pdf</link></simpara>
+<simpara><anchor xml:id="W3C12a" xreflabel="[W3C12a]"/>W3C. (2012). <emphasis>Web IDL Specification</emphasis>. Retrieved from <link xl:href="http://www.w3.org/TR/2012/CR-WebIDL-20120419/">http://www.w3.org/TR/2012/CR-WebIDL-20120419/</link></simpara>
+<simpara><anchor xml:id="Kuizinas14a" xreflabel="[Kuizinas14a]"/>Kuizinas, Gajus. (2014). <emphasis>The Definitive Guide to the JavaScript Generators</emphasis>. Retrieved from <link xl:href="http://gajus.com/blog/2/the-definetive-guide-to-the-javascript-generators">http://gajus.com/blog/2/the-definetive-guide-to-the-javascript-generators</link></simpara>
+<simpara><anchor xml:id="West06a" xreflabel="[West06a]"/>West, Mike. (2006). <emphasis>Scope in JavaScript</emphasis>. Retrieved from <link xl:href="http://www.digital-web.com/articles/scope_in_javascript/">http://www.digital-web.com/articles/scope_in_javascript/</link></simpara>
+<simpara><anchor xml:id="ECMA18a" xreflabel="[ECMA18a]"/>ECMA. (2018). <emphasis>ECMAScript 2018 Language Specification</emphasis>. Retrieved from <link xl:href="http://www.ecma-international.org/ecma-262/9.0/index.html">http://www.ecma-international.org/ecma-262/9.0/index.html</link></simpara>
+<simpara><anchor xml:id="MozillaJSRef" xreflabel="[MozillaJSRef]"/><emphasis>JavaScript Reference</emphasis>. Retrieved from <link xl:href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference">https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference</link></simpara>
+<simpara><anchor xml:id="Fowler04b" xreflabel="[Fowler04b]"/>Fowler, Martin. (2004). <emphasis>Inversion of Control Containers and the Dependency Injection pattern</emphasis>. Retrieved from <link xl:href="http://martinfowler.com/articles/injection.html">http://martinfowler.com/articles/injection.html</link></simpara>
+<simpara><anchor xml:id="Prasanna09a" xreflabel="[Prasanna09a]"/>Prasanna, Dhanji R. (2009). <emphasis>Dependency Injection: Design Patterns Using Spring and Guice</emphasis>. </simpara>
+<simpara><anchor xml:id="Zhu13a" xreflabel="[Zhu13a]"/>Zhu, He and Jagannathan, Suresh. (2013). <emphasis>Compositional and Lightweight Dependent Type Inference for ML</emphasis>. Retrieved from <link xl:href="http://dx.doi.org/10.1007/978-3-642-35873-9_19">http://dx.doi.org/10.1007/978-3-642-35873-9_19</link></simpara>
+<simpara><anchor xml:id="Hudli13a" xreflabel="[Hudli13a]"/>Hudli, Shrinidhi R. and Hudli, Raghu V.. (2013). <emphasis>A Verification Strategy for Dependency Injection</emphasis>. </simpara>
+<simpara><anchor xml:id="Lesiecki08a" xreflabel="[Lesiecki08a]"/>Lesiecki, Nicholas. (2008). <emphasis>Dependency injection with Guice</emphasis>. Retrieved from <link xl:href="http://www.ibm.com/developerworks/library/j-guice/">http://www.ibm.com/developerworks/library/j-guice/</link></simpara>
+<simpara><anchor xml:id="Betts13a" xreflabel="[Betts13a]"/>Betts, Dominic and Melnik, Grigori and Simonazzi, Fernando and Subramanian, Mani. (2013). <emphasis>Dependency Injection with Unity</emphasis>. </simpara>
+<simpara><anchor xml:id="Knol13a" xreflabel="[Knol13a]"/>Knol, Alex. (2013). <emphasis>Dependency injection with AngularJS</emphasis>. </simpara>
+<simpara><anchor xml:id="Dagger" xreflabel="[Dagger]"/><emphasis>Dagger, Project Website</emphasis>. Retrieved from <link xl:href="http://square.github.io/dagger/">http://square.github.io/dagger/</link></simpara>
+<simpara><anchor xml:id="ECMA12a" xreflabel="[ECMA12a]"/>(2012). <emphasis>ECMAScript Internationalization API Specification</emphasis>. Retrieved from <link xl:href="http://www.ecma-international.org/publications/standards/Ecma-402.htm">http://www.ecma-international.org/publications/standards/Ecma-402.htm</link></simpara>
+<simpara><anchor xml:id="Martin96b" xreflabel="[Martin96b]"/>Martin, Robert C. (1996). <emphasis>The Liskov Substitution Principle</emphasis>. Retrieved from <link xl:href="http://www.objectmentor.com/publications/lsp.pdf">http://www.objectmentor.com/publications/lsp.pdf</link></simpara>
+</appendix>
+</book>
\ No newline at end of file
diff --git a/spec/annotations.html b/spec/annotations.html
new file mode 100644
index 0000000..5a749a7
--- /dev/null
+++ b/spec/annotations.html
@@ -0,0 +1,1223 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="generator" content="Asciidoctor 1.5.5">
+<meta name="author" content="2019-08-07 15:02:40 CEST">
+<title>N4JS Language Specification</title>
+<link rel="stylesheet" href="styles/spec.min.css">
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.6.3/css/font-awesome.min.css">
+<!-- ************* docinfo ******************************************************************* -->
+
+
+<!-- ************* Favicon ************-->
+<link rel="icon" href="images/favicon.ico" />
+
+<!-- ************* Back-to-top JQuery ************* -->
+<script src="https://code.jquery.com/jquery-1.12.4.js"></script>
+<script src="https://code.jquery.com/ui/1.12.0/jquery-ui.js"></script>
+
+
+<link href="styles/prism.min.css" rel="stylesheet" />
+<script type="text/javascript" async
+  src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2/MathJax.js?config=TeX-MML-AM_CHTML">
+</script>
+
+<!-- ************* Styles ************* -->
+<link rel="stylesheet" type="text/css" href="styles/n4jsspec-adoc.css">
+
+
+<!-- ****************** NavBar ****************** -->
+<div id="menubar">
+	<div class="banner">
+        <a href="https://www.eclipse.org/n4js/#"><img id="logo" src="images/n4js-logo.png" alt="Eclipse N4JS"></a>
+    </div>
+<ul>
+  <li><a href="index.html">Index</a></li>
+</ul>
+</div>
+<!-- ************* docinfo ******************************************************************* -->
+<style>
+      .admonitionblock td.icon .icon-todo:before{content:"\f249";color:#f4ee42}
+    </style>
+</head>
+<body class="book toc2 toc-left">
+<div id="header">
+<h1>N4JS Language Specification</h1>
+<div class="details">
+<span id="author" class="author">2019-08-07 15:02:40 CEST</span><br>
+<span id="revnumber">version 0.9</span>
+</div>
+<div id="toc" class="toc2">
+<div id="toctitle">Table of Contents</div>
+<ul class="sectlevel1">
+<li><a href="introduction.html#_introduction">1. Introduction</a>
+<ul class="sectlevel2">
+<li><a href="introduction.html#_notation">1.1. Notation</a>
+<ul class="sectlevel3">
+<li><a href="introduction.html#_grammar-notation">1.1.1. Grammar Notation</a></li>
+<li><a href="introduction.html#_type-judgments-and-rules-and-constraints-notation">1.1.2. Type Judgments and Rules and Constraints Notation</a>
+<ul class="sectlevel4">
+<li><a href="introduction.html#_typing-rules-and-judgments">1.1.2.1. Typing Rules and Judgments</a></li>
+<li><a href="introduction.html#_types-of-an-element">1.1.2.2. Types of an Element</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="introduction.html#_auxiliary-functions">1.2. Auxiliary Functions</a>
+<ul class="sectlevel3">
+<li><a href="introduction.html#_binding">1.2.1. Binding</a></li>
+<li><a href="introduction.html#_merging-types">1.2.2. Merging Types</a>
+<ul class="sectlevel4">
+<li><a href="introduction.html#_logic-formulas">1.2.2.1. Logic Formulas</a></li>
+</ul>
+</li>
+<li><a href="introduction.html#_symbols-and-font-convention">1.2.3. Symbols and Font Convention</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="grammar.html#_grammar">2. Grammar</a>
+<ul class="sectlevel2">
+<li><a href="grammar.html#_lexical-conventions">2.1. Lexical Conventions</a>
+<ul class="sectlevel3">
+<li><a href="grammar.html#_identifier-names-and-identifiers">2.1.1. Identifier Names and Identifiers</a></li>
+<li><a href="grammar.html#_this-keyword">2.1.2. This Keyword</a></li>
+<li><a href="grammar.html#_regular-expression-literals">2.1.3. Regular Expression Literals</a></li>
+<li><a href="grammar.html#_automatic-semicolon-insertion">2.1.4. Automatic Semicolon Insertion</a></li>
+<li><a href="grammar.html#_jsdoc">2.1.5. JSDoc</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="names.html#_names">3. Names</a>
+<ul class="sectlevel2">
+<li><a href="names.html#_access-control">3.1. Access Control</a></li>
+<li><a href="names.html#_accessibility-of-types-top-level-variables-and-function-declarations">3.2. Accessibility of Types, Top-Level Variables and Function Declarations</a>
+<ul class="sectlevel3">
+<li><a href="names.html#_accessibility-of-members">3.2.1. Accessibility of Members</a></li>
+<li><a href="names.html#_valid-names">3.2.2. Valid Names</a></li>
+<li><a href="names.html#_qualified-names">3.2.3. Qualified Names</a></li>
+<li><a href="names.html#_name-duplicates">3.2.4. Name Duplicates</a>
+<ul class="sectlevel4">
+<li><a href="names.html#_lexical-environment">3.2.4.1. Lexical Environment</a></li>
+<li><a href="names.html#_duplicates-and-shadowing">3.2.4.2. Duplicates and Shadowing</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="types.html#_types">4. Types</a>
+<ul class="sectlevel2">
+<li><a href="types.html#_overview">4.1. Overview</a></li>
+<li><a href="types.html#_type-expressions">4.2. Type Expressions</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_syntax">4.2.1. Syntax</a></li>
+<li><a href="types.html#_properties">4.2.2. Properties</a></li>
+<li><a href="types.html#_semantics">4.2.3. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_type-inference">4.3. Type Inference</a></li>
+<li><a href="types.html#_generic-and-parameterized-types">4.4. Generic and Parameterized Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_generic-types">4.4.1. Generic Types</a></li>
+<li><a href="types.html#_type-variables">4.4.2. Type Variables</a></li>
+<li><a href="types.html#_parameterized-types">4.4.3. Parameterized Types</a></li>
+</ul>
+</li>
+<li><a href="types.html#_primitive-ecmascript-types">4.5. Primitive ECMAScript Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_undefined-type">4.5.1. Undefined Type</a></li>
+<li><a href="types.html#_null-type">4.5.2. Null Type</a></li>
+<li><a href="types.html#_primitive-boolean-type">4.5.3. Primitive Boolean Type</a></li>
+<li><a href="types.html#_primitive-string-type">4.5.4. Primitive String Type</a></li>
+<li><a href="types.html#_primitive-number-type">4.5.5. Primitive Number Type</a></li>
+<li><a href="types.html#_primitive-type-int">4.5.6. Primitive Type int</a></li>
+<li><a href="types.html#_primitive-symbol-type">4.5.7. Primitive Symbol Type</a></li>
+</ul>
+</li>
+<li><a href="types.html#_primitive-n4js-types">4.6. Primitive N4JS Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_any-type">4.6.1. Any Type</a>
+<ul class="sectlevel4">
+<li><a href="types.html#any-type-semantics">4.6.1.1. Semantics</a></li>
+<li><a href="types.html#any-type-type-inference">4.6.1.2. Type Inference</a>
+<ul class="sectlevel5">
+<li><a href="types.html#_default-type-of-variables">4.6.1.2.1. Default Type of Variables</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="types.html#_void-type">4.6.2. Void Type</a>
+<ul class="sectlevel4">
+<li><a href="types.html#void-type-semantics">4.6.2.1. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_unknown-type">4.6.3. Unknown Type</a></li>
+<li><a href="types.html#_primitive-pathselector-and-i18nkey">4.6.4. Primitive Pathselector and I18nKey</a>
+<ul class="sectlevel4">
+<li><a href="types.html#pathselector-semantics">4.6.4.1. Semantics</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="types.html#_built-in-ecmascript-object-types">4.7. Built-in ECMAScript Object Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#ECMAScript-objects-semantics">4.7.1. Semantics</a></li>
+<li><a href="types.html#_object-type">4.7.2. Object Type</a></li>
+<li><a href="types.html#_function-object-type">4.7.3. Function-Object-Type</a></li>
+<li><a href="types.html#_array-object-type">4.7.4. Array Object Type</a></li>
+<li><a href="types.html#_string-object-type">4.7.5. String Object Type</a></li>
+<li><a href="types.html#_boolean-object-type">4.7.6. Boolean Object Type</a></li>
+<li><a href="types.html#_number-object-type">4.7.7. Number Object Type</a></li>
+<li><a href="types.html#_global-object-type">4.7.8. Global Object Type</a></li>
+<li><a href="types.html#_symbol">4.7.9. Symbol</a></li>
+<li><a href="types.html#_promise">4.7.10. Promise</a></li>
+<li><a href="types.html#_iterator-interface">4.7.11. Iterator Interface</a></li>
+<li><a href="types.html#_iterable-interface">4.7.12. Iterable Interface</a></li>
+</ul>
+</li>
+<li><a href="types.html#_built-in-n4js-types">4.8. Built-In N4JS Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_n4object">4.8.1. N4Object</a>
+<ul class="sectlevel4">
+<li><a href="types.html#N4Object-semantics">4.8.1.1. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_n4class">4.8.2. N4Class</a></li>
+<li><a href="types.html#IterableN">4.8.3. IterableN</a></li>
+</ul>
+</li>
+<li><a href="types.html#_type-modifiers">4.9. Type Modifiers</a>
+<ul class="sectlevel3">
+<li><a href="types.html#Type_Modifiers_Dynamic">4.9.1. Dynamic</a></li>
+<li><a href="types.html#_optional-return-types">4.9.2. Optional Return Types</a></li>
+</ul>
+</li>
+<li><a href="types.html#_union-and-intersection-type-composed-types">4.10. Union and Intersection Type (Composed Types)</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_union-type">4.10.1. Union Type</a>
+<ul class="sectlevel4">
+<li><a href="types.html#union-type-syntax">4.10.1.1. Syntax</a></li>
+<li><a href="types.html#union-type-semantics">4.10.1.2. Semantics</a></li>
+<li><a href="types.html#_warnings">4.10.1.3. Warnings</a></li>
+</ul>
+</li>
+<li><a href="types.html#_intersection-type">4.10.2. Intersection Type</a>
+<ul class="sectlevel4">
+<li><a href="types.html#intersection-type-syntax">4.10.2.1. Syntax</a></li>
+<li><a href="types.html#intersection-type-semantics">4.10.2.2. Semantics</a></li>
+<li><a href="types.html#_warnings-2">4.10.2.3. Warnings</a></li>
+</ul>
+</li>
+<li><a href="types.html#_composed-types-in-wildcards">4.10.3. Composed Types in Wildcards</a></li>
+<li><a href="types.html#_property-access-for-composed-types">4.10.4. Property Access for Composed Types</a>
+<ul class="sectlevel4">
+<li><a href="types.html#_properties-of-union-type">4.10.4.1. Properties of Union Type</a>
+<ul class="sectlevel5">
+<li><a href="types.html#_remarks-on-union-type-s-members">4.10.4.1.1. Remarks on union type’s members:</a></li>
+</ul>
+</li>
+<li><a href="types.html#_properties-of-intersection-type">4.10.4.2. Properties of Intersection Type</a>
+<ul class="sectlevel5">
+<li><a href="types.html#_remarks-on-intersection-type-s-methods">4.10.4.2.1. Remarks on intersection type’s methods:</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="types.html#_constructor-and-classifier-type">4.11. Constructor and Classifier Type</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_syntax-3">4.11.1. Syntax</a></li>
+<li><a href="types.html#_semantics-2">4.11.2. Semantics</a></li>
+<li><a href="types.html#_constructors-and-prototypes-in-ecmascript-2015">4.11.3. Constructors and Prototypes in ECMAScript 2015</a></li>
+</ul>
+</li>
+<li><a href="types.html#_this-type">4.12. This Type</a>
+<ul class="sectlevel3">
+<li><a href="types.html#this-type-syntax">4.12.1. Syntax</a></li>
+<li><a href="types.html#this-keyword-semantics">4.12.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_enums">4.13. Enums</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_enums-n4js">4.13.1. Enums (N4JS)</a>
+<ul class="sectlevel4">
+<li><a href="types.html#enums-syntax">4.13.1.1. Syntax</a></li>
+<li><a href="types.html#enums-semantics">4.13.1.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_string-based-enums">4.13.2. String-Based Enums</a></li>
+</ul>
+</li>
+<li><a href="types.html#_short-hand-syntax">4.14. Short-Hand Syntax</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_array-short-hand-syntax">4.14.1. Array Short-Hand Syntax</a></li>
+<li><a href="types.html#_iterablen-short-hand-syntax">4.14.2. IterableN Short-Hand Syntax</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="classifiers.html#_classifiers">5. Classifiers</a>
+<ul class="sectlevel2">
+<li><a href="classifiers.html#_n4js-specific-classifiers">5.1. N4JS Specific Classifiers</a>
+<ul class="sectlevel3">
+<li><a href="classifiers.html#_properties-2">5.1.1. Properties</a></li>
+<li><a href="classifiers.html#_common-semantics-of-classifiers">5.1.2. Common Semantics of Classifiers</a></li>
+<li><a href="classifiers.html#_classes">5.1.3. Classes</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_definition-of-classes">5.1.3.1. Definition of Classes</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#class-syntax">5.1.3.1.1. Syntax</a></li>
+<li><a href="classifiers.html#class-properties">5.1.3.1.2. Properties</a></li>
+<li><a href="classifiers.html#class-type-inference">5.1.3.1.3. Type Inference</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#class-semantics">5.1.3.2. Semantics</a></li>
+<li><a href="classifiers.html#_final-modifier">5.1.3.3. Final Modifier</a></li>
+<li><a href="classifiers.html#_abstract-classes">5.1.3.4. Abstract Classes</a></li>
+<li><a href="classifiers.html#_non-instantiable-classes">5.1.3.5. Non-Instantiable Classes</a></li>
+<li><a href="classifiers.html#_superclass">5.1.3.6. Superclass</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_interfaces">5.1.4. Interfaces</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_definition-of-interfaces">5.1.4.1. Definition of Interfaces</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#interfaces-syntax">5.1.4.1.1. Syntax</a></li>
+<li><a href="classifiers.html#interfaces-properties">5.1.4.1.2. Properties</a></li>
+<li><a href="classifiers.html#interfaces-type-inference">5.1.4.1.3. Type Inference</a></li>
+<li><a href="classifiers.html#interfaces-semantics">5.1.4.1.4. Semantics</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="classifiers.html#_generic-classifiers">5.1.5. Generic Classifiers</a></li>
+<li><a href="classifiers.html#sec:definition-site-variance">5.1.6. Definition-Site Variance</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_members">5.2. Members</a>
+<ul class="sectlevel3">
+<li><a href="classifiers.html#_syntax-4">5.2.1. Syntax</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_properties-3">5.2.1.1. Properties</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_semantics-3">5.2.2. Semantics</a></li>
+<li><a href="classifiers.html#_methods">5.2.3. Methods</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_syntax-5">5.2.3.1. Syntax</a></li>
+<li><a href="classifiers.html#_properties-4">5.2.3.2. Properties</a></li>
+<li><a href="classifiers.html#_semantics-4">5.2.3.3. Semantics</a></li>
+<li><a href="classifiers.html#_final-methods">5.2.3.4. Final Methods</a></li>
+<li><a href="classifiers.html#_abstract-methods">5.2.3.5. Abstract Methods</a></li>
+<li><a href="classifiers.html#_generic-methods">5.2.3.6. Generic Methods</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_default-methods-in-interfaces">5.2.4. Default Methods in Interfaces</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_asynchronous-methods">5.2.4.1. Asynchronous Methods</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_constructors">5.2.5. Constructors</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_structural-this-type-in-constructor">5.2.5.1. Structural This Type in Constructor</a></li>
+<li><a href="classifiers.html#spec-constructor">5.2.5.2. @Spec Constructor</a></li>
+<li><a href="classifiers.html#_callable-constructors">5.2.5.3. Callable Constructors</a></li>
+<li><a href="classifiers.html#_covariant-constructors">5.2.5.4. Covariant Constructors</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_data-fields">5.2.6. Data Fields</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#data-fields-syntax">5.2.6.1. Syntax</a></li>
+<li><a href="classifiers.html#data-fields-properties">5.2.6.2. Properties</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#data-fields-semantics">5.2.6.2.1. Semantics</a></li>
+<li><a href="classifiers.html#data-fields-type-inference">5.2.6.2.2. Type Inference</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_assignment-modifiers">5.2.6.3. Assignment Modifiers</a></li>
+<li><a href="classifiers.html#_field-accessors-getter-setter">5.2.6.4. Field Accessors (Getter/Setter)</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#field-acessors-syntax">5.2.6.4.1. Syntax</a></li>
+<li><a href="classifiers.html#field-acessors-properties">5.2.6.4.2. Properties</a></li>
+<li><a href="classifiers.html#field-accessors-semantics">5.2.6.4.3. Semantics</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#optional-fields">5.2.6.5. Optional Fields</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#_syntax-6">5.2.6.5.1. Syntax</a></li>
+<li><a href="classifiers.html#_semantics-5">5.2.6.5.2. Semantics</a></li>
+<li><a href="classifiers.html#_background">5.2.6.5.3. Background</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="classifiers.html#_static-members">5.2.7. Static Members</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_access-from-and-to-static-members">5.2.7.1. Access From and To Static Members</a></li>
+<li><a href="classifiers.html#_generic-static-methods">5.2.7.2. Generic static methods</a></li>
+<li><a href="classifiers.html#_static-members-of-interfaces">5.2.7.3. Static Members of Interfaces</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_redefinition-of-members">5.2.8. Redefinition of Members</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_overriding-of-members">5.2.8.1. Overriding of Members</a></li>
+<li><a href="classifiers.html#_implementation-of-members">5.2.8.2. Implementation of Members</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#_member-consumption">5.2.8.2.1. Member Consumption</a></li>
+<li><a href="classifiers.html#_member-implementation">5.2.8.2.2. Member Implementation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="classifiers.html#_structural-typing">5.3. Structural Typing</a>
+<ul class="sectlevel3">
+<li><a href="classifiers.html#_syntax-7">5.3.1. Syntax</a></li>
+<li><a href="classifiers.html#_definition-site-structural-typing">5.3.2. Definition Site Structural Typing</a></li>
+<li><a href="classifiers.html#_use-site-structural-typing">5.3.3. Use-Site Structural Typing</a></li>
+<li><a href="classifiers.html#structural-readWriteInit-field-typing">5.3.4. Structural Read-only, Write-only and Initializer Field Typing</a></li>
+<li><a href="classifiers.html#_public-setter-annotated-with-code-providesinitializer-code">5.3.5. Public Setter Annotated With <code>ProvidesInitializer</code></a></li>
+<li><a href="classifiers.html#_structural-types-with-optional-fields">5.3.6. Structural Types With Optional Fields</a></li>
+<li><a href="classifiers.html#_structural-types-with-access-modifier">5.3.7. Structural Types With Access Modifier</a></li>
+<li><a href="classifiers.html#_structural-types-with-additional-members">5.3.8. Structural Types With Additional Members</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_syntax-8">5.3.8.1. Syntax</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#_semantics-6">5.3.8.1.1. Semantics</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="functions.html#_functions">6. Functions</a>
+<ul class="sectlevel2">
+<li><a href="functions.html#_function-type">6.1. Function Type</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_properties-5">6.1.1. Properties</a></li>
+<li><a href="functions.html#function-type-inference">6.1.2. Type Inference</a></li>
+<li><a href="functions.html#_autoboxing-of-function-type">6.1.3. Autoboxing of Function Type</a></li>
+<li><a href="functions.html#_arguments-object">6.1.4. Arguments Object</a></li>
+</ul>
+</li>
+<li><a href="functions.html#_ecmascript-5-function-definition">6.2. ECMAScript 5 Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_function-declaration">6.2.1. Function Declaration</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#_syntax-9">6.2.1.1. Syntax</a></li>
+<li><a href="functions.html#_semantics-8">6.2.1.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="functions.html#_function-expression">6.2.2. Function Expression</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#function-expression-syntax">6.2.2.1. Syntax</a></li>
+<li><a href="functions.html#_semantics-and-type-inference">6.2.2.2. Semantics and Type Inference</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="functions.html#_ecmascript-2015-function-definition">6.3. ECMAScript 2015 Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_formal-parameters">6.3.1. Formal Parameters</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#Type_Modifiers_Optional">6.3.1.1. Optional Parameters</a></li>
+<li><a href="functions.html#Type_Modifiers_Default">6.3.1.2. Default Parameters</a></li>
+<li><a href="functions.html#Type_Modifiers_Variadic">6.3.1.3. Variadic</a></li>
+</ul>
+</li>
+<li><a href="functions.html#_generator-functions">6.3.2. Generator Functions</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#generator-functions-syntax">6.3.2.1. Syntax</a></li>
+<li><a href="functions.html#generator-functions-semantics">6.3.2.2. Semantics</a></li>
+<li><a href="functions.html#_generator-arrow-functions">6.3.2.3. Generator Arrow Functions</a></li>
+</ul>
+</li>
+<li><a href="functions.html#_arrow-function-expression">6.3.3. Arrow Function Expression</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#arrow-function-expression-syntax">6.3.3.1. Syntax</a></li>
+<li><a href="functions.html#arrow-function-expression-semantics-and-type-inference">6.3.3.2. Semantics and Type Inference</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="functions.html#_ecmascript-proposals-function-definition">6.4. ECMAScript Proposals Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_asynchronous-functions">6.4.1. Asynchronous Functions</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#asynchronous-functions-syntax">6.4.1.1. Syntax</a></li>
+<li><a href="functions.html#asynchronous-functions-semantics">6.4.1.2. Semantics</a></li>
+<li><a href="functions.html#_asynchronous-arrow-functions">6.4.1.3. Asynchronous Arrow Functions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="functions.html#_n4js-extended-function-definition">6.5. N4JS Extended Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_generic-functions">6.5.1. Generic Functions</a></li>
+<li><a href="functions.html#_promisifiable-functions">6.5.2. Promisifiable Functions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_conversions-and-reflection">7. Conversions and Reflection</a>
+<ul class="sectlevel2">
+<li><a href="conversions_and_reflection.html#_autoboxing-and-coercing">7.1. Autoboxing and Coercing</a>
+<ul class="sectlevel3">
+<li><a href="conversions_and_reflection.html#_coercing">7.1.1. Coercing</a></li>
+<li><a href="conversions_and_reflection.html#_autoboxing-of-primitives">7.1.2. Autoboxing of Primitives</a></li>
+<li><a href="conversions_and_reflection.html#_autoboxing-of-function-expressions-and-declarations">7.1.3. Autoboxing of Function Expressions and Declarations</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_auto-conversion-of-objects">7.2. Auto-Conversion of Objects</a>
+<ul class="sectlevel3">
+<li><a href="conversions_and_reflection.html#_auto-conversion-of-class-instances">7.2.1. Auto-Conversion of Class Instances</a>
+<ul class="sectlevel4">
+<li><a href="conversions_and_reflection.html#_auto-conversion-of-interface-instances">7.2.1.1. Auto-Conversion of Interface Instances</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_auto-conversion-of-enum-literals">7.2.2. Auto-Conversion of Enum Literals</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_type-cast-and-type-check">7.3. Type Cast and Type Check</a>
+<ul class="sectlevel3">
+<li><a href="conversions_and_reflection.html#_type-cast">7.3.1. Type Cast</a></li>
+<li><a href="conversions_and_reflection.html#_type-check">7.3.2. Type Check</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_reflection-meta-information">7.4. Reflection meta-information</a>
+<ul class="sectlevel3">
+<li><a href="conversions_and_reflection.html#_reflection-for-classes">7.4.1. Reflection for Classes</a></li>
+<li><a href="conversions_and_reflection.html#_reflection-for-interfaces">7.4.2. Reflection for Interfaces</a></li>
+<li><a href="conversions_and_reflection.html#_reflection-for-enumerations">7.4.3. Reflection for Enumerations</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_conversion-of-primitive-types">7.5. Conversion of primitive types</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_expressions">8. Expressions</a>
+<ul class="sectlevel2">
+<li><a href="expressions.html#_ecmascript-5-expressions">8.1. ECMAScript 5 Expressions</a>
+<ul class="sectlevel3">
+<li><a href="expressions.html#_the-this-literal">8.1.1. The this Literal</a></li>
+<li><a href="expressions.html#_identifier">8.1.2. Identifier</a></li>
+<li><a href="expressions.html#_literals">8.1.3. Literals</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#_integer-literals">8.1.3.1. Integer Literals</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_array-literal">8.1.4. Array Literal</a></li>
+<li><a href="expressions.html#_object-literal">8.1.5. Object Literal</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#_properties-6">8.1.5.1. Properties</a></li>
+<li><a href="expressions.html#_scoping-and-linking">8.1.5.2. Scoping and linking</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_parenthesized-expression-and-grouping-operator">8.1.6. Parenthesized Expression and Grouping Operator</a></li>
+<li><a href="expressions.html#_property-accessors">8.1.7. Property Accessors</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#properties-1">8.1.7.1. Properties</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_new-expression">8.1.8. New Expression</a></li>
+<li><a href="expressions.html#_function-expression-2">8.1.9. Function Expression</a></li>
+<li><a href="expressions.html#_function-calls">8.1.10. Function Calls</a></li>
+<li><a href="expressions.html#_postfix-expression">8.1.11. Postfix Expression</a></li>
+<li><a href="expressions.html#_unary-expression">8.1.12. Unary Expression</a></li>
+<li><a href="expressions.html#_multiplicative-expression">8.1.13. Multiplicative Expression</a></li>
+<li><a href="expressions.html#_additive-expression">8.1.14. Additive Expression</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#type-inference-10">8.1.14.1. Type Inference</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_bitwise-shift-expression">8.1.15. Bitwise Shift Expression</a></li>
+<li><a href="expressions.html#_relational-expression">8.1.16. Relational Expression</a></li>
+<li><a href="expressions.html#_equality-expression">8.1.17. Equality Expression</a></li>
+<li><a href="expressions.html#_binary-bitwise-expression">8.1.18. Binary Bitwise Expression</a></li>
+<li><a href="expressions.html#_binary-logical-expression">8.1.19. Binary Logical Expression</a></li>
+<li><a href="expressions.html#_conditional-expression">8.1.20. Conditional Expression</a></li>
+<li><a href="expressions.html#_assignment-expression">8.1.21. Assignment Expression</a></li>
+<li><a href="expressions.html#_comma-expression">8.1.22. Comma Expression</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_ecmascript-6-expressions">8.2. ECMAScript 6 Expressions</a>
+<ul class="sectlevel3">
+<li><a href="expressions.html#_the-super-keyword">8.2.1. The super Keyword</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_ecmascript-7-expressions">8.3. ECMAScript 7 Expressions</a>
+<ul class="sectlevel3">
+<li><a href="expressions.html#_await-expression">8.3.1. Await Expression</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_n4js-specific-expressions">8.4. N4JS Specific Expressions</a>
+<ul class="sectlevel3">
+<li><a href="expressions.html#_class-expression">8.4.1. Class Expression</a></li>
+<li><a href="expressions.html#_cast-as-expression">8.4.2. Cast (As) Expression</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#cast-as-expression-semantics-type-inference">8.4.2.1. Semantics and Type Inference</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#Import_Calls">8.4.3. Import Calls</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#compile-time-expressions">8.5. Compile-Time Expressions</a></li>
+</ul>
+</li>
+<li><a href="statements.html#_statements">9. Statements</a>
+<ul class="sectlevel2">
+<li><a href="statements.html#_ecmascript-5-statements">9.1. ECMAScript 5 Statements</a>
+<ul class="sectlevel3">
+<li><a href="statements.html#_function-or-field-accessor-bodies">9.1.1. Function or Field Accessor Bodies</a></li>
+<li><a href="statements.html#_variable-statement">9.1.2. Variable Statement</a></li>
+<li><a href="statements.html#_if-statement">9.1.3. If Statement</a></li>
+<li><a href="statements.html#_iteration-statements">9.1.4. Iteration Statements</a></li>
+<li><a href="statements.html#_return-statement">9.1.5. Return Statement</a></li>
+<li><a href="statements.html#_with-statement">9.1.6. With Statement</a></li>
+<li><a href="statements.html#_switch-statement">9.1.7. Switch Statement</a></li>
+<li><a href="statements.html#_throw-try-and-catch-statements">9.1.8. Throw, Try, and Catch Statements</a></li>
+<li><a href="statements.html#_debugger-statement">9.1.9. Debugger Statement</a></li>
+</ul>
+</li>
+<li><a href="statements.html#_ecmascript-6-statements">9.2. ECMAScript 6 Statements</a>
+<ul class="sectlevel3">
+<li><a href="statements.html#_let">9.2.1. Let</a></li>
+<li><a href="statements.html#_const">9.2.2. Const</a></li>
+<li><a href="statements.html#_for-of-statement">9.2.3. <code>for &#8230;&#8203; of</code> statement</a></li>
+<li><a href="statements.html#_import-statement">9.2.4. Import Statement</a>
+<ul class="sectlevel4">
+<li><a href="statements.html#Dynamic_Imports">9.2.4.1. Dynamic Imports</a></li>
+<li><a href="statements.html#_immutabilaty-of-imports">9.2.4.2. Immutabilaty of Imports</a></li>
+</ul>
+</li>
+<li><a href="statements.html#_export-statement">9.2.5. Export Statement</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#_annotations">10. Annotations</a>
+<ul class="sectlevel2">
+<li><a href="#_introduction-2">10.1. Introduction</a>
+<ul class="sectlevel3">
+<li><a href="#_syntax-13">10.1.1. Syntax</a></li>
+<li><a href="#_properties-7">10.1.2. Properties</a></li>
+<li><a href="#_element-specific-annotations">10.1.3. Element-Specific Annotations</a></li>
+<li><a href="#_general-annotations">10.1.4. General Annotations</a>
+<ul class="sectlevel4">
+<li><a href="#_idebug">10.1.4.1. IDEBUG</a></li>
+</ul>
+</li>
+<li><a href="#idebug-syntax">10.1.5. Syntax</a>
+<ul class="sectlevel4">
+<li><a href="#_semantics-11">10.1.5.1. Semantics</a></li>
+<li><a href="#_suppress-warnings">10.1.5.2. Suppress Warnings</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#_declaration-of-annotations">10.2. Declaration of Annotations</a></li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_extended-fetaures">11. Extended Fetaures</a>
+<ul class="sectlevel2">
+<li><a href="extended_fetaures.html#_array-and-object-destructuring">11.1. Array and Object Destructuring</a>
+<ul class="sectlevel3">
+<li><a href="extended_fetaures.html#_syntax-14">11.1.1. Syntax</a></li>
+<li><a href="extended_fetaures.html#_semantics-12">11.1.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_dependency-injection">11.2. Dependency Injection</a>
+<ul class="sectlevel3">
+<li><a href="extended_fetaures.html#_di-components-and-injectors">11.2.1. DI Components and Injectors</a>
+<ul class="sectlevel4">
+<li><a href="extended_fetaures.html#_dicomponent-relations">11.2.1.1. DIComponent Relations</a></li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_binders-and-bindings">11.2.2. Binders and Bindings</a></li>
+<li><a href="extended_fetaures.html#_injection-points">11.2.3. Injection Points</a>
+<ul class="sectlevel4">
+<li><a href="extended_fetaures.html#_field-injection">11.2.3.1. Field Injection</a></li>
+<li><a href="extended_fetaures.html#_constructor-injection">11.2.3.2. Constructor Injection</a></li>
+<li><a href="extended_fetaures.html#_method-injection">11.2.3.3. Method Injection</a>
+<ul class="sectlevel5">
+<li><a href="extended_fetaures.html#_provider">11.2.3.3.1. Provider</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_n4js-di-life-cycle-and-scopes">11.2.4. N4JS DI Life Cycle and Scopes</a>
+<ul class="sectlevel4">
+<li><a href="extended_fetaures.html#_injection-cylces">11.2.4.1. Injection Cylces</a></li>
+<li><a href="extended_fetaures.html#_default-scope">11.2.4.2. Default Scope</a></li>
+<li><a href="extended_fetaures.html#_singleton-scope">11.2.4.3. Singleton Scope</a></li>
+<li><a href="extended_fetaures.html#_per-injection-chain-singleton">11.2.4.4. Per Injection Chain Singleton</a></li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_validation-of-callsites-targeting-n4injector-methods">11.2.5. Validation of callsites targeting N4Injector methods</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-annotations">11.2.6. N4JS DI Annotations</a>
+<ul class="sectlevel4">
+<li><a href="extended_fetaures.html#_n4js-di-generateinjector">11.2.6.1. N4JS DI @GenerateInjector</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-withparentinjector">11.2.6.2. N4JS DI @WithParentInjector</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-usebinder">11.2.6.3. N4JS DI @UseBinder</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-binder">11.2.6.4. N4JS DI @Binder</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-bind">11.2.6.5. N4JS DI @Bind</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-provides">11.2.6.6. N4JS DI @Provides</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-inject">11.2.6.7. N4JS DI @Inject</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-singleton">11.2.6.8. N4JS DI @Singleton</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_test-support">11.3. Test Support</a></li>
+<li><a href="extended_fetaures.html#_polyfill-definitions">11.4. Polyfill Definitions</a>
+<ul class="sectlevel3">
+<li><a href="extended_fetaures.html#_runtime-polyfill-definitions">11.4.1. Runtime Polyfill Definitions</a></li>
+<li><a href="extended_fetaures.html#_static-polyfill-definitions">11.4.2. Static Polyfill Definitions</a></li>
+<li><a href="extended_fetaures.html#_transpiling-static-polyfilled-classes">11.4.3. Transpiling static polyfilled classes</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="components.html#_components">12. Components</a>
+<ul class="sectlevel2">
+<li><a href="components.html#_overview-2">12.1. Overview</a></li>
+<li><a href="components.html#Component_Types">12.2. Component Types</a>
+<ul class="sectlevel3">
+<li><a href="components.html#_libraries">12.2.1. Libraries</a></li>
+<li><a href="components.html#_runtime-environment-and-runtime-libraries">12.2.2. Runtime Environment and Runtime Libraries</a></li>
+<li><a href="components.html#_tests">12.2.3. Tests</a></li>
+<li><a href="components.html#_type-definitions">12.2.4. Type Definitions</a></li>
+</ul>
+</li>
+<li><a href="components.html#package-json">12.3. Package.json File</a>
+<ul class="sectlevel3">
+<li><a href="components.html#_basic-properties">12.3.1. Basic Properties</a></li>
+<li><a href="components.html#_n4js-properties">12.3.2. N4JS Properties</a></li>
+<li><a href="components.html#_constraints">12.3.3. Constraints</a></li>
+</ul>
+</li>
+<li><a href="components.html#_support-for-npm-scopes">12.4. Support for NPM Scopes</a></li>
+<li><a href="components.html#sec:N4JS-Type-Definitions">12.5. N4JS Type Definitions</a>
+<ul class="sectlevel3">
+<li><a href="components.html#_specify-type-definition">12.5.1. Specify Type Definition</a></li>
+<li><a href="components.html#_name-conventions">12.5.2. Name Conventions</a></li>
+<li><a href="components.html#_version-conventions">12.5.3. Version Conventions</a>
+<ul class="sectlevel4">
+<li><a href="components.html#_define-a-new-type-definition-package">12.5.3.1. Define a New Type Definition Package</a></li>
+<li><a href="components.html#_using-a-type-definition-package">12.5.3.2. Using a Type Definition Package</a></li>
+<li><a href="components.html#_rational">12.5.3.3. Rational</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="components.html#_modules">12.6. Modules</a></li>
+<li><a href="components.html#_api-and-implementation-component">12.7. API and Implementation Component</a>
+<ul class="sectlevel3">
+<li><a href="components.html#_execution-of-api-and-implementation-components">12.7.1. Execution of API and Implementation Components</a></li>
+<li><a href="components.html#_api-and-implementation-with-di">12.7.2. API and Implementation With DI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="plainjs.html#_plainjs">13. PlainJS</a>
+<ul class="sectlevel2">
+<li><a href="plainjs.html#_type-inference-and-validation-for-plain-js">13.1. Type Inference and Validation for Plain JS</a></li>
+<li><a href="plainjs.html#_external-declarations">13.2. External Declarations</a>
+<ul class="sectlevel3">
+<li><a href="plainjs.html#_declaring-externals">13.2.1. Declaring externals</a></li>
+<li><a href="plainjs.html#_instantiating-external-classes">13.2.2. Instantiating external classes</a></li>
+<li><a href="plainjs.html#_implementation-of-external-declarations">13.2.3. Implementation of External Declarations</a></li>
+<li><a href="plainjs.html#_example">13.2.4. Example</a></li>
+</ul>
+</li>
+<li><a href="plainjs.html#_global-definitions">13.3. Global Definitions</a></li>
+<li><a href="plainjs.html#_runtime-definitions">13.4. Runtime Definitions</a></li>
+<li><a href="plainjs.html#_applying-polyfills">13.5. Applying Polyfills</a></li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_jsdoc-2">14. JSDoc</a>
+<ul class="sectlevel2">
+<li><a href="jsdoc.html#_general-n4jsdoc-features">14.1. General N4JSDoc Features</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#_provided-inline-tags">14.1.1. Provided Inline Tags</a>
+<ul class="sectlevel4">
+<li><a href="jsdoc.html#jsdoc_tag__code">14.1.1.1. @code</a></li>
+<li><a href="jsdoc.html#jsdoc_tag__link">14.1.1.2. @link</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_n4jsdoc-for-user-projects">14.2. N4JSdoc for User Projects</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#_standard-tags">14.2.1. Standard Tags</a>
+<ul class="sectlevel4">
+<li><a href="jsdoc.html#_-author">14.2.1.1. @author</a></li>
+<li><a href="jsdoc.html#jsdoc_tag_param">14.2.1.2. @param</a></li>
+<li><a href="jsdoc.html#jsdoc_tag_return">14.2.1.3. @return</a></li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_test-related-tags">14.2.2. Test Related Tags</a>
+<ul class="sectlevel4">
+<li><a href="jsdoc.html#jsdoc_tag__testee">14.2.2.1. @testee</a></li>
+<li><a href="jsdoc.html#jsdoc_tag__testeeFromType">14.2.2.2. @testeeFromType</a></li>
+<li><a href="jsdoc.html#_testeeType_and__testeeMember">14.2.2.3. @testeeType and @testeeMember</a></li>
+<li><a href="jsdoc.html#jsdoc_tag_reqid_in_Tests">14.2.2.4. @reqid in Tests</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_n4jsdoc-for-api-and-implementation-projects">14.3. N4JSDoc for API and Implementation Projects</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#jsdoc_tag__apiNote">14.3.1. @apiNote</a></li>
+<li><a href="jsdoc.html#API_Project_Tags">14.3.2. API Project Tags</a>
+<ul class="sectlevel4">
+<li><a href="jsdoc.html#jsdoc_tag_apiState">14.3.2.1. @apiState</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsx.html#_jsx">15. JSX</a>
+<ul class="sectlevel2">
+<li><a href="jsx.html#_jsx-support">15.1. JSX Support</a></li>
+<li><a href="jsx.html#_jsx-backend">15.2. JSX Backend</a></li>
+</ul>
+</li>
+<li><a href="grammars.html#_grammars">16. Grammars</a>
+<ul class="sectlevel2">
+<li><a href="grammars.html#_type-expressions-grammar">16.1. Type Expressions Grammar</a></li>
+<li><a href="grammars.html#_n4js-language-grammar">16.2. N4JS Language Grammar</a></li>
+</ul>
+</li>
+<li><a href="jsobjects.html#_jsobjects">17. JSObjects</a>
+<ul class="sectlevel2">
+<li><a href="jsobjects.html#_object">17.1. Object</a></li>
+<li><a href="jsobjects.html#_string">17.2. String</a></li>
+<li><a href="jsobjects.html#_boolean">17.3. Boolean</a></li>
+<li><a href="jsobjects.html#_number">17.4. Number</a>
+<ul class="sectlevel3">
+<li><a href="jsobjects.html#_static-attributes">17.4.1. Static Attributes</a></li>
+</ul>
+</li>
+<li><a href="jsobjects.html#function">17.5. Function</a></li>
+<li><a href="jsobjects.html#_error">17.6. Error</a></li>
+<li><a href="jsobjects.html#_array">17.7. Array</a></li>
+<li><a href="jsobjects.html#_date">17.8. Date</a></li>
+<li><a href="jsobjects.html#_math">17.9. Math</a>
+<ul class="sectlevel3">
+<li><a href="jsobjects.html#static-attributes-1">17.9.1. Static Attributes</a></li>
+</ul>
+</li>
+<li><a href="jsobjects.html#_regexp">17.10. RegExp</a></li>
+<li><a href="jsobjects.html#_json">17.11. JSON</a></li>
+</ul>
+</li>
+<li><a href="n4js_objects.html#_n4js-objects">18. N4JS Objects</a>
+<ul class="sectlevel2">
+<li><a href="n4js_objects.html#_reflection-model">18.1. Reflection Model</a></li>
+<li><a href="n4js_objects.html#_error-types">18.2. Error Types</a>
+<ul class="sectlevel3">
+<li><a href="n4js_objects.html#_n4apinotimplemented">18.2.1. N4ApiNotImplemented</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_acronyms.html#_acronyms">Appendix A: Acronyms</a></li>
+<li><a href="appendix_b_license.html#sec:License">Appendix B: License</a></li>
+<li><a href="appendix_c_bibliography.html#_bibliography">Appendix C: Bibliography</a></li>
+</ul>
+</div>
+</div>
+<div id="content"><div class="sect1">
+<h2 id="_annotations"><a class="anchor" href="#_annotations"></a><a class="link" href="#_annotations">10. Annotations</a></h2>
+<div class="sectionbody">
+<div class="sect2 language-n4js">
+<h3 id="_introduction-2"><a class="anchor" href="#_introduction-2"></a><a class="link" href="#_introduction-2">10.1. Introduction</a></h3>
+<div class="paragraph">
+<p>Annotations are used to further define meta properties of language elements such as types, variables and functions.
+These annotations are used by the compiler and validator to prohibit the developer from introducing constructs which are either not allowed or are unnecessary in certain contexts.</p>
+</div>
+<div class="paragraph">
+<p>Since annotations are to be processed by the compiler and the compilation cannot be extended by third-party users for security reasons, annotations cannot be defined by developers.
+Instead, the compiler comes with a predefined set of annotations which are summarized here.</p>
+</div>
+<div class="sect3">
+<h4 id="_syntax-13"><a class="anchor" href="#_syntax-13"></a><a class="link" href="#_syntax-13">10.1.1. Syntax</a></h4>
+<div class="paragraph">
+<p>Annotations are used similarly as in Java (although new annotations cannot be defined by the user).
+They are formally defined as follows:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">Annotation:'@' AnnotationNoAtSign;
+ScriptAnnotation returns Annotation: '@@' AnnotationNoAtSign;
+
+AnnotationNoAtSign returns Annotation:
+    name=AnnotationName (=&gt; '(' (args+=AnnotationArgument (',' args+=AnnotationArgument)*)? ')')?;
+
+AnnotationArgument:
+    LiteralAnnotationArgument | TypeRefAnnotationArgument
+;
+
+LiteralAnnotationArgument:
+    literal=Literal
+;
+
+TypeRefAnnotationArgument:
+    typeRef=TypeRef
+;</code></pre>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_properties-7"><a class="anchor" href="#_properties-7"></a><a class="link" href="#_properties-7">10.1.2. Properties</a></h4>
+<div class="paragraph">
+<p>We use the map notation for retrieving annotation properties and values from a list of annotations,
+for example <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>x</mi><mo>.</mo><mi>a</mi><mi>n</mi><mi>n</mi><mi>o</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>o</mi><mi>n</mi><mi>s</mi><mfenced close="]" open="["><mrow><mi>R</mi><mi>e</mi><mi>q</mi><mi>u</mi><mi>i</mi><mi>r</mi><mi>e</mi><mi>d</mi></mrow></mfenced></math>, or shorter <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>x</mi><mi>@</mi><mi>R</mi><mi>e</mi><mi>q</mi><mi>u</mi><mi>i</mi><mi>r</mi><mi>e</mi><mi>d</mi></math>.</p>
+</div>
+<div style="page-break-after: always;"></div>
+</div>
+<div class="sect3">
+<h4 id="_element-specific-annotations"><a class="anchor" href="#_element-specific-annotations"></a><a class="link" href="#_element-specific-annotations">10.1.3. Element-Specific Annotations</a></h4>
+<div class="paragraph">
+<p>The following annotations are element-specific and are explained in the corresponding sections:</p>
+</div>
+<table class="tableblock frame-all grid-all spread">
+<caption class="title">Table 11. Element-Specific Annotations</caption>
+<colgroup>
+<col style="width: 33.3333%;">
+<col style="width: 33.3333%;">
+<col style="width: 33.3334%;">
+</colgroup>
+<thead>
+<tr>
+<th class="tableblock halign-left valign-top">Annotation</th>
+<th class="tableblock halign-center valign-top">Element Types</th>
+<th class="tableblock halign-left valign-top">Section</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>@Internal</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>TypeDefiningElement, Member, Function, Export</code></p></td>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p><a href="names.html#_access-control">Access Control</a></p>
+</div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>@Undefined</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Variable</code></p></td>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p><a href="types.html#_undefined-type">Undefined Type</a></p>
+</div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>@StringBased</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Enum</code></p></td>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p><a href="types.html#_string-based-enums">String-Based Enums</a></p>
+</div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>@Final</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Class, Member</code></p></td>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p><a href="classifiers.html#_final-methods">Final Methods</a></p>
+</div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>@Spec</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>FPar</code></p></td>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p><a href="classifiers.html#Req-IDE-59">[Req-IDE-59]</a></p>
+</div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>@Override</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Method</code></p></td>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p><a href="classifiers.html#_redefinition-of-members">Redefinition of Members</a></p>
+</div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>@Promisifiable</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Function</code></p></td>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p><a href="functions.html#_promisifiable-functions">Promisifiable Functions</a></p>
+</div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>@Promisify</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>CallExpression</code></p></td>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p><a href="functions.html#_promisifiable-functions">Promisifiable Functions</a></p>
+</div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>@This</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Function</code></p></td>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p><a href="grammar.html#_this-keyword">This Keyword</a></p>
+</div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>@N4JS</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Class, Export Statement</code></p></td>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p><a href="plainjs.html#_external-declarations">External Declarations</a></p>
+</div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>@IgnoreImplementation</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Script, ExportDeclaration, ExportableElement</code></p></td>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p><a href="plainjs.html#_external-declarations">External Declarations</a></p>
+</div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>@Global</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>External Declaration</code></p></td>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p><a href="plainjs.html#_global-definitions">Global Definitions</a></p>
+</div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>@ProvidedByRuntime</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>External Declaration</code></p></td>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p><a href="plainjs.html#_runtime-definitions">Runtime Definitions</a></p>
+</div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>@TestAPI</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>TypeDefiningElement, Member</code></p></td>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p><a href="extended_fetaures.html#_test-support">Test Support</a></p>
+</div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>@Polyfill</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Class</code></p></td>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p><a href="extended_fetaures.html#_polyfill-definitions">Polyfill Definitions</a></p>
+</div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>@StaticPolyfill</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Class</code></p></td>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p><a href="extended_fetaures.html#_static-polyfill-definitions">Static Polyfill Definitions</a></p>
+</div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>@StaticPolyfillAware</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Script</code></p></td>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p><a href="extended_fetaures.html#_static-polyfill-definitions">Static Polyfill Definitions</a></p>
+</div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>@StaticPolyfillModule</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Script</code></p></td>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p><a href="extended_fetaures.html#_static-polyfill-definitions">Static Polyfill Definitions</a></p>
+</div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>@Transient</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Field</code></p></td>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p><sup class="footnote">[<a id="_footnoteref_1" class="footnote" href="appendix_c_bibliography.html#_footnote_1" title="View footnote.">1</a>]</sup></p>
+</div>
+<div id="footnotes">
+<hr>
+<div class="footnote" id="_footnote_1">
+<a href="#_footnoteref_1">1</a>. intended for internal use only; will be removed
+</div>
+</div></div></td>
+</tr>
+</tbody>
+</table>
+</div>
+<div class="sect3">
+<h4 id="_general-annotations"><a class="anchor" href="#_general-annotations"></a><a class="link" href="#_general-annotations">10.1.4. General Annotations</a></h4>
+<div class="sect4">
+<h5 id="_idebug"><a class="anchor" href="#_idebug"></a><a class="link" href="#_idebug">10.1.4.1. IDEBUG</a></h5>
+<div class="paragraph">
+<p><code>@IDEBUG</code> is an annotation similar to Java’s <code>@SuppressWarnings</code>.
+It changes the severity of an issue from an error to a warning so that code can be compiled regardless of validation errors.
+This is to be used for known IDE bugs only.</p>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="idebug-syntax"><a class="anchor" href="#idebug-syntax"></a><a class="link" href="#idebug-syntax">10.1.5. Syntax</a></h4>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">'@IDEBUG' '(' bugID = INT ',' errorMessage=STRING ')'</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>The annotation is defined transitively and repeatable on script, type declaration, function and method level.</p>
+</div>
+<div class="sect4">
+<h5 id="_semantics-11"><a class="anchor" href="#_semantics-11"></a><a class="link" href="#_semantics-11">10.1.5.1. Semantics</a></h5>
+<div class="paragraph">
+<p>This annotation will cause errors issued in the scope of the annotation (in the defined script, type, or method) to be transformed to warnings if their message text is similar to the <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>e</mi><mi>r</mi><mi>r</mi><mi>o</mi><mi>r</mi><mi>M</mi><mi>e</mi><mi>s</mi><mi>s</mi><mi>a</mi><mi>g</mi><mi>e</mi></math> text.
+If <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>e</mi><mi>r</mi><mi>r</mi><mi>o</mi><mi>r</mi><mi>M</mi><mi>e</mi><mi>s</mi><mi>s</mi><mi>a</mi><mi>g</mi><mi>e</mi></math> ends with <code>…</code> (three dots as a single character, created by Eclipse to abbreviate messages), then the error’s message text must start with the specified text.</p>
+</div>
+<div class="paragraph">
+<p>If no matching error is found, the annotation itself will issue an error.</p>
+</div>
+<div id="ex:IDEBUG" class="exampleblock">
+<div class="title">Example 97. IDEBUG Example</div>
+<div class="content">
+<div class="paragraph">
+<p>In the following code snippet, two errors are to be transformed to warnings.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">export class TestDataBridge with IModuleTest {
+    @IDEBUG(166, "{function(number):void} is not a subtype of {function(T):void}.") <i class="conum" data-value="1"></i><b>(1)</b>
+    @IDEBUG(91, "Incorrect number of arguments: expected 1, got 2.") <i class="conum" data-value="2"></i><b>(2)</b>
+    @Override public run(): void {
+        var foo = new Foo(),
+            cb = function(val: number): void {},
+            db = DataBridge.&lt;number&gt;bind(foo, "bar");
+        db.add(cb); <i class="conum" data-value="3"></i><b>(3)</b>
+        Assert.isTrue(called);
+    }
+}</code></pre>
+</div>
+</div>
+<div class="colist arabic">
+<table>
+<tr>
+<td><i class="conum" data-value="1"></i><b>1</b></td>
+<td>The annotation transforms the error <code>{function(number):void} is not a subtype of {function(T):void}</code> into a warning with the following text:</td>
+</tr>
+<tr>
+<td><i class="conum" data-value="2"></i><b>2</b></td>
+<td>This annotation was proposed as a workaround for <a href="https://github.com/NumberFour/n4js/issues/91">IDEBUG-91</a> which has been fixed.<br>
+No error message is produced and an error will be issued on this line instead:</td>
+</tr>
+<tr>
+<td><i class="conum" data-value="3"></i><b>3</b></td>
+<td>The first error occurs since there is a bug in the IDE type system (as of writing this example) where type arguments are not correctly bound in the case of function expressions used as callback methods.</td>
+</tr>
+</table>
+</div>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_suppress-warnings"><a class="anchor" href="#_suppress-warnings"></a><a class="link" href="#_suppress-warnings">10.1.5.2. Suppress Warnings</a></h5>
+<div class="admonitionblock tip">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-tip" title=""></i>
+</td>
+<td class="content">
+This is not part of the current version
+</td>
+</tr>
+</table>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_declaration-of-annotations"><a class="anchor" href="#_declaration-of-annotations"></a><a class="link" href="#_declaration-of-annotations">10.2. Declaration of Annotations</a></h3>
+<div class="admonitionblock tip">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-tip" title=""></i>
+</td>
+<td class="content">
+This is not part of the current version
+</td>
+</tr>
+</table>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div id="footer">
+<div id="footer-text">
+Version 0.9<br>
+Last updated 2019-08-07 15:02:40 CEST
+</div>
+</div>
+<!-- ************* docinfo-footer *************************************************************** -->
+<div class="Grid social" style="color:#d5dfea">
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <h2>Quick Links</h2>
+    <ul>
+      <li><a href="../downloads.html">Download</a></li>
+      <li><a href="../userguides/index.html">Documentation</a></li>
+      <li><a href="https://github.com/eclipse/n4js/">Source</a></li>
+      <li><a href="https://github.com/eclipse/n4js/issues">Issues</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="https://www.eclipse.org/forums/index.php/f/365/">Forum</a></li>
+      <li><a href="http://n4js.blogspot.de/">Blog</a></li>
+      <li><a href="https://dev.eclipse.org/mailman/listinfo/n4js-dev">Mailing List</a></li>
+      <li><a href="https://projects.eclipse.org/projects/technology.n4js">Eclipse Project Page</a></li>
+      <li><a href="https://twitter.com/n4jsdev">Tweets by n4jsdev</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="http://www.eclipse.org/">Eclipse Home</a></li>
+      <li><a href="http://www.eclipse.org/legal/privacy.php">Privacy Policy</a></li>
+      <li><a href="http://www.eclipse.org/legal/termsofuse.php">Terms of Use</a></li>
+      <li><a href="http://www.eclipse.org/legal/copyright.php">Copyright Agent</a></li>
+      <li><a href="http://www.eclipse.org/legal/">Legal</a></li>
+    </ul>
+  </div>
+  <div style="clear: both; height: 0; overflow: hidden;"></div>
+</div>
+
+<!-- ************* UI Scripts ************* -->
+<script type="text/javascript" src="scripts/back-to-top.js"></script>
+
+<script type="text/javascript" src="scripts/treeview.js"></script>
+<script type="text/javascript" src="scripts/toc.js"></script>
+
+<!-- ************* Prism.js Syntax Highlighting ************* -->
+<script src="scripts/prism.js"></script>
+
+<script type="text/javascript">
+	// Add the 'toclist' id for search function
+	$(".toc2 > ul").attr('id', 'toclist');
+	// Generate a Search input form
+	$("#toclist > li:first-of-type").before('<input type="text" id="pagesearch" onkeyup="search()" placeholder="Search for section...">');
+	$("#toclist > li:first-of-type").before('<i id="clear" class="fa fa-times-circle-o"></i>');
+	$("#clear").click(function(){
+	    $("#pagesearch").val('');
+	    search();
+	    $('.toc2 > ul').treeView('collapseAll');
+	});
+	// intialize Treeview.js
+	$(".toc2 > ul").treeView();
+	// Initialize Scrollspy
+</script>
+<!-- ************* docinfo-footer *************************************************************** -->
+</body>
+</html>
\ No newline at end of file
diff --git a/spec/appendix_a_acronyms.html b/spec/appendix_a_acronyms.html
new file mode 100644
index 0000000..2630b45
--- /dev/null
+++ b/spec/appendix_a_acronyms.html
@@ -0,0 +1,1024 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="generator" content="Asciidoctor 1.5.5">
+<meta name="author" content="2019-08-07 15:02:40 CEST">
+<title>N4JS Language Specification</title>
+<link rel="stylesheet" href="styles/spec.min.css">
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.6.3/css/font-awesome.min.css">
+<!-- ************* docinfo ******************************************************************* -->
+
+
+<!-- ************* Favicon ************-->
+<link rel="icon" href="images/favicon.ico" />
+
+<!-- ************* Back-to-top JQuery ************* -->
+<script src="https://code.jquery.com/jquery-1.12.4.js"></script>
+<script src="https://code.jquery.com/ui/1.12.0/jquery-ui.js"></script>
+
+
+<link href="styles/prism.min.css" rel="stylesheet" />
+<script type="text/javascript" async
+  src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2/MathJax.js?config=TeX-MML-AM_CHTML">
+</script>
+
+<!-- ************* Styles ************* -->
+<link rel="stylesheet" type="text/css" href="styles/n4jsspec-adoc.css">
+
+
+<!-- ****************** NavBar ****************** -->
+<div id="menubar">
+	<div class="banner">
+        <a href="https://www.eclipse.org/n4js/#"><img id="logo" src="images/n4js-logo.png" alt="Eclipse N4JS"></a>
+    </div>
+<ul>
+  <li><a href="index.html">Index</a></li>
+</ul>
+</div>
+<!-- ************* docinfo ******************************************************************* -->
+<style>
+      .admonitionblock td.icon .icon-todo:before{content:"\f249";color:#f4ee42}
+    </style>
+</head>
+<body class="book toc2 toc-left">
+<div id="header">
+<h1>N4JS Language Specification</h1>
+<div class="details">
+<span id="author" class="author">2019-08-07 15:02:40 CEST</span><br>
+<span id="revnumber">version 0.9</span>
+</div>
+<div id="toc" class="toc2">
+<div id="toctitle">Table of Contents</div>
+<ul class="sectlevel1">
+<li><a href="introduction.html#_introduction">1. Introduction</a>
+<ul class="sectlevel2">
+<li><a href="introduction.html#_notation">1.1. Notation</a>
+<ul class="sectlevel3">
+<li><a href="introduction.html#_grammar-notation">1.1.1. Grammar Notation</a></li>
+<li><a href="introduction.html#_type-judgments-and-rules-and-constraints-notation">1.1.2. Type Judgments and Rules and Constraints Notation</a>
+<ul class="sectlevel4">
+<li><a href="introduction.html#_typing-rules-and-judgments">1.1.2.1. Typing Rules and Judgments</a></li>
+<li><a href="introduction.html#_types-of-an-element">1.1.2.2. Types of an Element</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="introduction.html#_auxiliary-functions">1.2. Auxiliary Functions</a>
+<ul class="sectlevel3">
+<li><a href="introduction.html#_binding">1.2.1. Binding</a></li>
+<li><a href="introduction.html#_merging-types">1.2.2. Merging Types</a>
+<ul class="sectlevel4">
+<li><a href="introduction.html#_logic-formulas">1.2.2.1. Logic Formulas</a></li>
+</ul>
+</li>
+<li><a href="introduction.html#_symbols-and-font-convention">1.2.3. Symbols and Font Convention</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="grammar.html#_grammar">2. Grammar</a>
+<ul class="sectlevel2">
+<li><a href="grammar.html#_lexical-conventions">2.1. Lexical Conventions</a>
+<ul class="sectlevel3">
+<li><a href="grammar.html#_identifier-names-and-identifiers">2.1.1. Identifier Names and Identifiers</a></li>
+<li><a href="grammar.html#_this-keyword">2.1.2. This Keyword</a></li>
+<li><a href="grammar.html#_regular-expression-literals">2.1.3. Regular Expression Literals</a></li>
+<li><a href="grammar.html#_automatic-semicolon-insertion">2.1.4. Automatic Semicolon Insertion</a></li>
+<li><a href="grammar.html#_jsdoc">2.1.5. JSDoc</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="names.html#_names">3. Names</a>
+<ul class="sectlevel2">
+<li><a href="names.html#_access-control">3.1. Access Control</a></li>
+<li><a href="names.html#_accessibility-of-types-top-level-variables-and-function-declarations">3.2. Accessibility of Types, Top-Level Variables and Function Declarations</a>
+<ul class="sectlevel3">
+<li><a href="names.html#_accessibility-of-members">3.2.1. Accessibility of Members</a></li>
+<li><a href="names.html#_valid-names">3.2.2. Valid Names</a></li>
+<li><a href="names.html#_qualified-names">3.2.3. Qualified Names</a></li>
+<li><a href="names.html#_name-duplicates">3.2.4. Name Duplicates</a>
+<ul class="sectlevel4">
+<li><a href="names.html#_lexical-environment">3.2.4.1. Lexical Environment</a></li>
+<li><a href="names.html#_duplicates-and-shadowing">3.2.4.2. Duplicates and Shadowing</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="types.html#_types">4. Types</a>
+<ul class="sectlevel2">
+<li><a href="types.html#_overview">4.1. Overview</a></li>
+<li><a href="types.html#_type-expressions">4.2. Type Expressions</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_syntax">4.2.1. Syntax</a></li>
+<li><a href="types.html#_properties">4.2.2. Properties</a></li>
+<li><a href="types.html#_semantics">4.2.3. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_type-inference">4.3. Type Inference</a></li>
+<li><a href="types.html#_generic-and-parameterized-types">4.4. Generic and Parameterized Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_generic-types">4.4.1. Generic Types</a></li>
+<li><a href="types.html#_type-variables">4.4.2. Type Variables</a></li>
+<li><a href="types.html#_parameterized-types">4.4.3. Parameterized Types</a></li>
+</ul>
+</li>
+<li><a href="types.html#_primitive-ecmascript-types">4.5. Primitive ECMAScript Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_undefined-type">4.5.1. Undefined Type</a></li>
+<li><a href="types.html#_null-type">4.5.2. Null Type</a></li>
+<li><a href="types.html#_primitive-boolean-type">4.5.3. Primitive Boolean Type</a></li>
+<li><a href="types.html#_primitive-string-type">4.5.4. Primitive String Type</a></li>
+<li><a href="types.html#_primitive-number-type">4.5.5. Primitive Number Type</a></li>
+<li><a href="types.html#_primitive-type-int">4.5.6. Primitive Type int</a></li>
+<li><a href="types.html#_primitive-symbol-type">4.5.7. Primitive Symbol Type</a></li>
+</ul>
+</li>
+<li><a href="types.html#_primitive-n4js-types">4.6. Primitive N4JS Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_any-type">4.6.1. Any Type</a>
+<ul class="sectlevel4">
+<li><a href="types.html#any-type-semantics">4.6.1.1. Semantics</a></li>
+<li><a href="types.html#any-type-type-inference">4.6.1.2. Type Inference</a>
+<ul class="sectlevel5">
+<li><a href="types.html#_default-type-of-variables">4.6.1.2.1. Default Type of Variables</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="types.html#_void-type">4.6.2. Void Type</a>
+<ul class="sectlevel4">
+<li><a href="types.html#void-type-semantics">4.6.2.1. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_unknown-type">4.6.3. Unknown Type</a></li>
+<li><a href="types.html#_primitive-pathselector-and-i18nkey">4.6.4. Primitive Pathselector and I18nKey</a>
+<ul class="sectlevel4">
+<li><a href="types.html#pathselector-semantics">4.6.4.1. Semantics</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="types.html#_built-in-ecmascript-object-types">4.7. Built-in ECMAScript Object Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#ECMAScript-objects-semantics">4.7.1. Semantics</a></li>
+<li><a href="types.html#_object-type">4.7.2. Object Type</a></li>
+<li><a href="types.html#_function-object-type">4.7.3. Function-Object-Type</a></li>
+<li><a href="types.html#_array-object-type">4.7.4. Array Object Type</a></li>
+<li><a href="types.html#_string-object-type">4.7.5. String Object Type</a></li>
+<li><a href="types.html#_boolean-object-type">4.7.6. Boolean Object Type</a></li>
+<li><a href="types.html#_number-object-type">4.7.7. Number Object Type</a></li>
+<li><a href="types.html#_global-object-type">4.7.8. Global Object Type</a></li>
+<li><a href="types.html#_symbol">4.7.9. Symbol</a></li>
+<li><a href="types.html#_promise">4.7.10. Promise</a></li>
+<li><a href="types.html#_iterator-interface">4.7.11. Iterator Interface</a></li>
+<li><a href="types.html#_iterable-interface">4.7.12. Iterable Interface</a></li>
+</ul>
+</li>
+<li><a href="types.html#_built-in-n4js-types">4.8. Built-In N4JS Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_n4object">4.8.1. N4Object</a>
+<ul class="sectlevel4">
+<li><a href="types.html#N4Object-semantics">4.8.1.1. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_n4class">4.8.2. N4Class</a></li>
+<li><a href="types.html#IterableN">4.8.3. IterableN</a></li>
+</ul>
+</li>
+<li><a href="types.html#_type-modifiers">4.9. Type Modifiers</a>
+<ul class="sectlevel3">
+<li><a href="types.html#Type_Modifiers_Dynamic">4.9.1. Dynamic</a></li>
+<li><a href="types.html#_optional-return-types">4.9.2. Optional Return Types</a></li>
+</ul>
+</li>
+<li><a href="types.html#_union-and-intersection-type-composed-types">4.10. Union and Intersection Type (Composed Types)</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_union-type">4.10.1. Union Type</a>
+<ul class="sectlevel4">
+<li><a href="types.html#union-type-syntax">4.10.1.1. Syntax</a></li>
+<li><a href="types.html#union-type-semantics">4.10.1.2. Semantics</a></li>
+<li><a href="types.html#_warnings">4.10.1.3. Warnings</a></li>
+</ul>
+</li>
+<li><a href="types.html#_intersection-type">4.10.2. Intersection Type</a>
+<ul class="sectlevel4">
+<li><a href="types.html#intersection-type-syntax">4.10.2.1. Syntax</a></li>
+<li><a href="types.html#intersection-type-semantics">4.10.2.2. Semantics</a></li>
+<li><a href="types.html#_warnings-2">4.10.2.3. Warnings</a></li>
+</ul>
+</li>
+<li><a href="types.html#_composed-types-in-wildcards">4.10.3. Composed Types in Wildcards</a></li>
+<li><a href="types.html#_property-access-for-composed-types">4.10.4. Property Access for Composed Types</a>
+<ul class="sectlevel4">
+<li><a href="types.html#_properties-of-union-type">4.10.4.1. Properties of Union Type</a>
+<ul class="sectlevel5">
+<li><a href="types.html#_remarks-on-union-type-s-members">4.10.4.1.1. Remarks on union type’s members:</a></li>
+</ul>
+</li>
+<li><a href="types.html#_properties-of-intersection-type">4.10.4.2. Properties of Intersection Type</a>
+<ul class="sectlevel5">
+<li><a href="types.html#_remarks-on-intersection-type-s-methods">4.10.4.2.1. Remarks on intersection type’s methods:</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="types.html#_constructor-and-classifier-type">4.11. Constructor and Classifier Type</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_syntax-3">4.11.1. Syntax</a></li>
+<li><a href="types.html#_semantics-2">4.11.2. Semantics</a></li>
+<li><a href="types.html#_constructors-and-prototypes-in-ecmascript-2015">4.11.3. Constructors and Prototypes in ECMAScript 2015</a></li>
+</ul>
+</li>
+<li><a href="types.html#_this-type">4.12. This Type</a>
+<ul class="sectlevel3">
+<li><a href="types.html#this-type-syntax">4.12.1. Syntax</a></li>
+<li><a href="types.html#this-keyword-semantics">4.12.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_enums">4.13. Enums</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_enums-n4js">4.13.1. Enums (N4JS)</a>
+<ul class="sectlevel4">
+<li><a href="types.html#enums-syntax">4.13.1.1. Syntax</a></li>
+<li><a href="types.html#enums-semantics">4.13.1.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_string-based-enums">4.13.2. String-Based Enums</a></li>
+</ul>
+</li>
+<li><a href="types.html#_short-hand-syntax">4.14. Short-Hand Syntax</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_array-short-hand-syntax">4.14.1. Array Short-Hand Syntax</a></li>
+<li><a href="types.html#_iterablen-short-hand-syntax">4.14.2. IterableN Short-Hand Syntax</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="classifiers.html#_classifiers">5. Classifiers</a>
+<ul class="sectlevel2">
+<li><a href="classifiers.html#_n4js-specific-classifiers">5.1. N4JS Specific Classifiers</a>
+<ul class="sectlevel3">
+<li><a href="classifiers.html#_properties-2">5.1.1. Properties</a></li>
+<li><a href="classifiers.html#_common-semantics-of-classifiers">5.1.2. Common Semantics of Classifiers</a></li>
+<li><a href="classifiers.html#_classes">5.1.3. Classes</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_definition-of-classes">5.1.3.1. Definition of Classes</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#class-syntax">5.1.3.1.1. Syntax</a></li>
+<li><a href="classifiers.html#class-properties">5.1.3.1.2. Properties</a></li>
+<li><a href="classifiers.html#class-type-inference">5.1.3.1.3. Type Inference</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#class-semantics">5.1.3.2. Semantics</a></li>
+<li><a href="classifiers.html#_final-modifier">5.1.3.3. Final Modifier</a></li>
+<li><a href="classifiers.html#_abstract-classes">5.1.3.4. Abstract Classes</a></li>
+<li><a href="classifiers.html#_non-instantiable-classes">5.1.3.5. Non-Instantiable Classes</a></li>
+<li><a href="classifiers.html#_superclass">5.1.3.6. Superclass</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_interfaces">5.1.4. Interfaces</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_definition-of-interfaces">5.1.4.1. Definition of Interfaces</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#interfaces-syntax">5.1.4.1.1. Syntax</a></li>
+<li><a href="classifiers.html#interfaces-properties">5.1.4.1.2. Properties</a></li>
+<li><a href="classifiers.html#interfaces-type-inference">5.1.4.1.3. Type Inference</a></li>
+<li><a href="classifiers.html#interfaces-semantics">5.1.4.1.4. Semantics</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="classifiers.html#_generic-classifiers">5.1.5. Generic Classifiers</a></li>
+<li><a href="classifiers.html#sec:definition-site-variance">5.1.6. Definition-Site Variance</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_members">5.2. Members</a>
+<ul class="sectlevel3">
+<li><a href="classifiers.html#_syntax-4">5.2.1. Syntax</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_properties-3">5.2.1.1. Properties</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_semantics-3">5.2.2. Semantics</a></li>
+<li><a href="classifiers.html#_methods">5.2.3. Methods</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_syntax-5">5.2.3.1. Syntax</a></li>
+<li><a href="classifiers.html#_properties-4">5.2.3.2. Properties</a></li>
+<li><a href="classifiers.html#_semantics-4">5.2.3.3. Semantics</a></li>
+<li><a href="classifiers.html#_final-methods">5.2.3.4. Final Methods</a></li>
+<li><a href="classifiers.html#_abstract-methods">5.2.3.5. Abstract Methods</a></li>
+<li><a href="classifiers.html#_generic-methods">5.2.3.6. Generic Methods</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_default-methods-in-interfaces">5.2.4. Default Methods in Interfaces</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_asynchronous-methods">5.2.4.1. Asynchronous Methods</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_constructors">5.2.5. Constructors</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_structural-this-type-in-constructor">5.2.5.1. Structural This Type in Constructor</a></li>
+<li><a href="classifiers.html#spec-constructor">5.2.5.2. @Spec Constructor</a></li>
+<li><a href="classifiers.html#_callable-constructors">5.2.5.3. Callable Constructors</a></li>
+<li><a href="classifiers.html#_covariant-constructors">5.2.5.4. Covariant Constructors</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_data-fields">5.2.6. Data Fields</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#data-fields-syntax">5.2.6.1. Syntax</a></li>
+<li><a href="classifiers.html#data-fields-properties">5.2.6.2. Properties</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#data-fields-semantics">5.2.6.2.1. Semantics</a></li>
+<li><a href="classifiers.html#data-fields-type-inference">5.2.6.2.2. Type Inference</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_assignment-modifiers">5.2.6.3. Assignment Modifiers</a></li>
+<li><a href="classifiers.html#_field-accessors-getter-setter">5.2.6.4. Field Accessors (Getter/Setter)</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#field-acessors-syntax">5.2.6.4.1. Syntax</a></li>
+<li><a href="classifiers.html#field-acessors-properties">5.2.6.4.2. Properties</a></li>
+<li><a href="classifiers.html#field-accessors-semantics">5.2.6.4.3. Semantics</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#optional-fields">5.2.6.5. Optional Fields</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#_syntax-6">5.2.6.5.1. Syntax</a></li>
+<li><a href="classifiers.html#_semantics-5">5.2.6.5.2. Semantics</a></li>
+<li><a href="classifiers.html#_background">5.2.6.5.3. Background</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="classifiers.html#_static-members">5.2.7. Static Members</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_access-from-and-to-static-members">5.2.7.1. Access From and To Static Members</a></li>
+<li><a href="classifiers.html#_generic-static-methods">5.2.7.2. Generic static methods</a></li>
+<li><a href="classifiers.html#_static-members-of-interfaces">5.2.7.3. Static Members of Interfaces</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_redefinition-of-members">5.2.8. Redefinition of Members</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_overriding-of-members">5.2.8.1. Overriding of Members</a></li>
+<li><a href="classifiers.html#_implementation-of-members">5.2.8.2. Implementation of Members</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#_member-consumption">5.2.8.2.1. Member Consumption</a></li>
+<li><a href="classifiers.html#_member-implementation">5.2.8.2.2. Member Implementation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="classifiers.html#_structural-typing">5.3. Structural Typing</a>
+<ul class="sectlevel3">
+<li><a href="classifiers.html#_syntax-7">5.3.1. Syntax</a></li>
+<li><a href="classifiers.html#_definition-site-structural-typing">5.3.2. Definition Site Structural Typing</a></li>
+<li><a href="classifiers.html#_use-site-structural-typing">5.3.3. Use-Site Structural Typing</a></li>
+<li><a href="classifiers.html#structural-readWriteInit-field-typing">5.3.4. Structural Read-only, Write-only and Initializer Field Typing</a></li>
+<li><a href="classifiers.html#_public-setter-annotated-with-code-providesinitializer-code">5.3.5. Public Setter Annotated With <code>ProvidesInitializer</code></a></li>
+<li><a href="classifiers.html#_structural-types-with-optional-fields">5.3.6. Structural Types With Optional Fields</a></li>
+<li><a href="classifiers.html#_structural-types-with-access-modifier">5.3.7. Structural Types With Access Modifier</a></li>
+<li><a href="classifiers.html#_structural-types-with-additional-members">5.3.8. Structural Types With Additional Members</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_syntax-8">5.3.8.1. Syntax</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#_semantics-6">5.3.8.1.1. Semantics</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="functions.html#_functions">6. Functions</a>
+<ul class="sectlevel2">
+<li><a href="functions.html#_function-type">6.1. Function Type</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_properties-5">6.1.1. Properties</a></li>
+<li><a href="functions.html#function-type-inference">6.1.2. Type Inference</a></li>
+<li><a href="functions.html#_autoboxing-of-function-type">6.1.3. Autoboxing of Function Type</a></li>
+<li><a href="functions.html#_arguments-object">6.1.4. Arguments Object</a></li>
+</ul>
+</li>
+<li><a href="functions.html#_ecmascript-5-function-definition">6.2. ECMAScript 5 Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_function-declaration">6.2.1. Function Declaration</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#_syntax-9">6.2.1.1. Syntax</a></li>
+<li><a href="functions.html#_semantics-8">6.2.1.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="functions.html#_function-expression">6.2.2. Function Expression</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#function-expression-syntax">6.2.2.1. Syntax</a></li>
+<li><a href="functions.html#_semantics-and-type-inference">6.2.2.2. Semantics and Type Inference</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="functions.html#_ecmascript-2015-function-definition">6.3. ECMAScript 2015 Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_formal-parameters">6.3.1. Formal Parameters</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#Type_Modifiers_Optional">6.3.1.1. Optional Parameters</a></li>
+<li><a href="functions.html#Type_Modifiers_Default">6.3.1.2. Default Parameters</a></li>
+<li><a href="functions.html#Type_Modifiers_Variadic">6.3.1.3. Variadic</a></li>
+</ul>
+</li>
+<li><a href="functions.html#_generator-functions">6.3.2. Generator Functions</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#generator-functions-syntax">6.3.2.1. Syntax</a></li>
+<li><a href="functions.html#generator-functions-semantics">6.3.2.2. Semantics</a></li>
+<li><a href="functions.html#_generator-arrow-functions">6.3.2.3. Generator Arrow Functions</a></li>
+</ul>
+</li>
+<li><a href="functions.html#_arrow-function-expression">6.3.3. Arrow Function Expression</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#arrow-function-expression-syntax">6.3.3.1. Syntax</a></li>
+<li><a href="functions.html#arrow-function-expression-semantics-and-type-inference">6.3.3.2. Semantics and Type Inference</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="functions.html#_ecmascript-proposals-function-definition">6.4. ECMAScript Proposals Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_asynchronous-functions">6.4.1. Asynchronous Functions</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#asynchronous-functions-syntax">6.4.1.1. Syntax</a></li>
+<li><a href="functions.html#asynchronous-functions-semantics">6.4.1.2. Semantics</a></li>
+<li><a href="functions.html#_asynchronous-arrow-functions">6.4.1.3. Asynchronous Arrow Functions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="functions.html#_n4js-extended-function-definition">6.5. N4JS Extended Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_generic-functions">6.5.1. Generic Functions</a></li>
+<li><a href="functions.html#_promisifiable-functions">6.5.2. Promisifiable Functions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_conversions-and-reflection">7. Conversions and Reflection</a>
+<ul class="sectlevel2">
+<li><a href="conversions_and_reflection.html#_autoboxing-and-coercing">7.1. Autoboxing and Coercing</a>
+<ul class="sectlevel3">
+<li><a href="conversions_and_reflection.html#_coercing">7.1.1. Coercing</a></li>
+<li><a href="conversions_and_reflection.html#_autoboxing-of-primitives">7.1.2. Autoboxing of Primitives</a></li>
+<li><a href="conversions_and_reflection.html#_autoboxing-of-function-expressions-and-declarations">7.1.3. Autoboxing of Function Expressions and Declarations</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_auto-conversion-of-objects">7.2. Auto-Conversion of Objects</a>
+<ul class="sectlevel3">
+<li><a href="conversions_and_reflection.html#_auto-conversion-of-class-instances">7.2.1. Auto-Conversion of Class Instances</a>
+<ul class="sectlevel4">
+<li><a href="conversions_and_reflection.html#_auto-conversion-of-interface-instances">7.2.1.1. Auto-Conversion of Interface Instances</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_auto-conversion-of-enum-literals">7.2.2. Auto-Conversion of Enum Literals</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_type-cast-and-type-check">7.3. Type Cast and Type Check</a>
+<ul class="sectlevel3">
+<li><a href="conversions_and_reflection.html#_type-cast">7.3.1. Type Cast</a></li>
+<li><a href="conversions_and_reflection.html#_type-check">7.3.2. Type Check</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_reflection-meta-information">7.4. Reflection meta-information</a>
+<ul class="sectlevel3">
+<li><a href="conversions_and_reflection.html#_reflection-for-classes">7.4.1. Reflection for Classes</a></li>
+<li><a href="conversions_and_reflection.html#_reflection-for-interfaces">7.4.2. Reflection for Interfaces</a></li>
+<li><a href="conversions_and_reflection.html#_reflection-for-enumerations">7.4.3. Reflection for Enumerations</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_conversion-of-primitive-types">7.5. Conversion of primitive types</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_expressions">8. Expressions</a>
+<ul class="sectlevel2">
+<li><a href="expressions.html#_ecmascript-5-expressions">8.1. ECMAScript 5 Expressions</a>
+<ul class="sectlevel3">
+<li><a href="expressions.html#_the-this-literal">8.1.1. The this Literal</a></li>
+<li><a href="expressions.html#_identifier">8.1.2. Identifier</a></li>
+<li><a href="expressions.html#_literals">8.1.3. Literals</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#_integer-literals">8.1.3.1. Integer Literals</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_array-literal">8.1.4. Array Literal</a></li>
+<li><a href="expressions.html#_object-literal">8.1.5. Object Literal</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#_properties-6">8.1.5.1. Properties</a></li>
+<li><a href="expressions.html#_scoping-and-linking">8.1.5.2. Scoping and linking</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_parenthesized-expression-and-grouping-operator">8.1.6. Parenthesized Expression and Grouping Operator</a></li>
+<li><a href="expressions.html#_property-accessors">8.1.7. Property Accessors</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#properties-1">8.1.7.1. Properties</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_new-expression">8.1.8. New Expression</a></li>
+<li><a href="expressions.html#_function-expression-2">8.1.9. Function Expression</a></li>
+<li><a href="expressions.html#_function-calls">8.1.10. Function Calls</a></li>
+<li><a href="expressions.html#_postfix-expression">8.1.11. Postfix Expression</a></li>
+<li><a href="expressions.html#_unary-expression">8.1.12. Unary Expression</a></li>
+<li><a href="expressions.html#_multiplicative-expression">8.1.13. Multiplicative Expression</a></li>
+<li><a href="expressions.html#_additive-expression">8.1.14. Additive Expression</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#type-inference-10">8.1.14.1. Type Inference</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_bitwise-shift-expression">8.1.15. Bitwise Shift Expression</a></li>
+<li><a href="expressions.html#_relational-expression">8.1.16. Relational Expression</a></li>
+<li><a href="expressions.html#_equality-expression">8.1.17. Equality Expression</a></li>
+<li><a href="expressions.html#_binary-bitwise-expression">8.1.18. Binary Bitwise Expression</a></li>
+<li><a href="expressions.html#_binary-logical-expression">8.1.19. Binary Logical Expression</a></li>
+<li><a href="expressions.html#_conditional-expression">8.1.20. Conditional Expression</a></li>
+<li><a href="expressions.html#_assignment-expression">8.1.21. Assignment Expression</a></li>
+<li><a href="expressions.html#_comma-expression">8.1.22. Comma Expression</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_ecmascript-6-expressions">8.2. ECMAScript 6 Expressions</a>
+<ul class="sectlevel3">
+<li><a href="expressions.html#_the-super-keyword">8.2.1. The super Keyword</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_ecmascript-7-expressions">8.3. ECMAScript 7 Expressions</a>
+<ul class="sectlevel3">
+<li><a href="expressions.html#_await-expression">8.3.1. Await Expression</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_n4js-specific-expressions">8.4. N4JS Specific Expressions</a>
+<ul class="sectlevel3">
+<li><a href="expressions.html#_class-expression">8.4.1. Class Expression</a></li>
+<li><a href="expressions.html#_cast-as-expression">8.4.2. Cast (As) Expression</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#cast-as-expression-semantics-type-inference">8.4.2.1. Semantics and Type Inference</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#Import_Calls">8.4.3. Import Calls</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#compile-time-expressions">8.5. Compile-Time Expressions</a></li>
+</ul>
+</li>
+<li><a href="statements.html#_statements">9. Statements</a>
+<ul class="sectlevel2">
+<li><a href="statements.html#_ecmascript-5-statements">9.1. ECMAScript 5 Statements</a>
+<ul class="sectlevel3">
+<li><a href="statements.html#_function-or-field-accessor-bodies">9.1.1. Function or Field Accessor Bodies</a></li>
+<li><a href="statements.html#_variable-statement">9.1.2. Variable Statement</a></li>
+<li><a href="statements.html#_if-statement">9.1.3. If Statement</a></li>
+<li><a href="statements.html#_iteration-statements">9.1.4. Iteration Statements</a></li>
+<li><a href="statements.html#_return-statement">9.1.5. Return Statement</a></li>
+<li><a href="statements.html#_with-statement">9.1.6. With Statement</a></li>
+<li><a href="statements.html#_switch-statement">9.1.7. Switch Statement</a></li>
+<li><a href="statements.html#_throw-try-and-catch-statements">9.1.8. Throw, Try, and Catch Statements</a></li>
+<li><a href="statements.html#_debugger-statement">9.1.9. Debugger Statement</a></li>
+</ul>
+</li>
+<li><a href="statements.html#_ecmascript-6-statements">9.2. ECMAScript 6 Statements</a>
+<ul class="sectlevel3">
+<li><a href="statements.html#_let">9.2.1. Let</a></li>
+<li><a href="statements.html#_const">9.2.2. Const</a></li>
+<li><a href="statements.html#_for-of-statement">9.2.3. <code>for &#8230;&#8203; of</code> statement</a></li>
+<li><a href="statements.html#_import-statement">9.2.4. Import Statement</a>
+<ul class="sectlevel4">
+<li><a href="statements.html#Dynamic_Imports">9.2.4.1. Dynamic Imports</a></li>
+<li><a href="statements.html#_immutabilaty-of-imports">9.2.4.2. Immutabilaty of Imports</a></li>
+</ul>
+</li>
+<li><a href="statements.html#_export-statement">9.2.5. Export Statement</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="annotations.html#_annotations">10. Annotations</a>
+<ul class="sectlevel2">
+<li><a href="annotations.html#_introduction-2">10.1. Introduction</a>
+<ul class="sectlevel3">
+<li><a href="annotations.html#_syntax-13">10.1.1. Syntax</a></li>
+<li><a href="annotations.html#_properties-7">10.1.2. Properties</a></li>
+<li><a href="annotations.html#_element-specific-annotations">10.1.3. Element-Specific Annotations</a></li>
+<li><a href="annotations.html#_general-annotations">10.1.4. General Annotations</a>
+<ul class="sectlevel4">
+<li><a href="annotations.html#_idebug">10.1.4.1. IDEBUG</a></li>
+</ul>
+</li>
+<li><a href="annotations.html#idebug-syntax">10.1.5. Syntax</a>
+<ul class="sectlevel4">
+<li><a href="annotations.html#_semantics-11">10.1.5.1. Semantics</a></li>
+<li><a href="annotations.html#_suppress-warnings">10.1.5.2. Suppress Warnings</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="annotations.html#_declaration-of-annotations">10.2. Declaration of Annotations</a></li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_extended-fetaures">11. Extended Fetaures</a>
+<ul class="sectlevel2">
+<li><a href="extended_fetaures.html#_array-and-object-destructuring">11.1. Array and Object Destructuring</a>
+<ul class="sectlevel3">
+<li><a href="extended_fetaures.html#_syntax-14">11.1.1. Syntax</a></li>
+<li><a href="extended_fetaures.html#_semantics-12">11.1.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_dependency-injection">11.2. Dependency Injection</a>
+<ul class="sectlevel3">
+<li><a href="extended_fetaures.html#_di-components-and-injectors">11.2.1. DI Components and Injectors</a>
+<ul class="sectlevel4">
+<li><a href="extended_fetaures.html#_dicomponent-relations">11.2.1.1. DIComponent Relations</a></li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_binders-and-bindings">11.2.2. Binders and Bindings</a></li>
+<li><a href="extended_fetaures.html#_injection-points">11.2.3. Injection Points</a>
+<ul class="sectlevel4">
+<li><a href="extended_fetaures.html#_field-injection">11.2.3.1. Field Injection</a></li>
+<li><a href="extended_fetaures.html#_constructor-injection">11.2.3.2. Constructor Injection</a></li>
+<li><a href="extended_fetaures.html#_method-injection">11.2.3.3. Method Injection</a>
+<ul class="sectlevel5">
+<li><a href="extended_fetaures.html#_provider">11.2.3.3.1. Provider</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_n4js-di-life-cycle-and-scopes">11.2.4. N4JS DI Life Cycle and Scopes</a>
+<ul class="sectlevel4">
+<li><a href="extended_fetaures.html#_injection-cylces">11.2.4.1. Injection Cylces</a></li>
+<li><a href="extended_fetaures.html#_default-scope">11.2.4.2. Default Scope</a></li>
+<li><a href="extended_fetaures.html#_singleton-scope">11.2.4.3. Singleton Scope</a></li>
+<li><a href="extended_fetaures.html#_per-injection-chain-singleton">11.2.4.4. Per Injection Chain Singleton</a></li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_validation-of-callsites-targeting-n4injector-methods">11.2.5. Validation of callsites targeting N4Injector methods</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-annotations">11.2.6. N4JS DI Annotations</a>
+<ul class="sectlevel4">
+<li><a href="extended_fetaures.html#_n4js-di-generateinjector">11.2.6.1. N4JS DI @GenerateInjector</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-withparentinjector">11.2.6.2. N4JS DI @WithParentInjector</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-usebinder">11.2.6.3. N4JS DI @UseBinder</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-binder">11.2.6.4. N4JS DI @Binder</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-bind">11.2.6.5. N4JS DI @Bind</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-provides">11.2.6.6. N4JS DI @Provides</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-inject">11.2.6.7. N4JS DI @Inject</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-singleton">11.2.6.8. N4JS DI @Singleton</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_test-support">11.3. Test Support</a></li>
+<li><a href="extended_fetaures.html#_polyfill-definitions">11.4. Polyfill Definitions</a>
+<ul class="sectlevel3">
+<li><a href="extended_fetaures.html#_runtime-polyfill-definitions">11.4.1. Runtime Polyfill Definitions</a></li>
+<li><a href="extended_fetaures.html#_static-polyfill-definitions">11.4.2. Static Polyfill Definitions</a></li>
+<li><a href="extended_fetaures.html#_transpiling-static-polyfilled-classes">11.4.3. Transpiling static polyfilled classes</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="components.html#_components">12. Components</a>
+<ul class="sectlevel2">
+<li><a href="components.html#_overview-2">12.1. Overview</a></li>
+<li><a href="components.html#Component_Types">12.2. Component Types</a>
+<ul class="sectlevel3">
+<li><a href="components.html#_libraries">12.2.1. Libraries</a></li>
+<li><a href="components.html#_runtime-environment-and-runtime-libraries">12.2.2. Runtime Environment and Runtime Libraries</a></li>
+<li><a href="components.html#_tests">12.2.3. Tests</a></li>
+<li><a href="components.html#_type-definitions">12.2.4. Type Definitions</a></li>
+</ul>
+</li>
+<li><a href="components.html#package-json">12.3. Package.json File</a>
+<ul class="sectlevel3">
+<li><a href="components.html#_basic-properties">12.3.1. Basic Properties</a></li>
+<li><a href="components.html#_n4js-properties">12.3.2. N4JS Properties</a></li>
+<li><a href="components.html#_constraints">12.3.3. Constraints</a></li>
+</ul>
+</li>
+<li><a href="components.html#_support-for-npm-scopes">12.4. Support for NPM Scopes</a></li>
+<li><a href="components.html#sec:N4JS-Type-Definitions">12.5. N4JS Type Definitions</a>
+<ul class="sectlevel3">
+<li><a href="components.html#_specify-type-definition">12.5.1. Specify Type Definition</a></li>
+<li><a href="components.html#_name-conventions">12.5.2. Name Conventions</a></li>
+<li><a href="components.html#_version-conventions">12.5.3. Version Conventions</a>
+<ul class="sectlevel4">
+<li><a href="components.html#_define-a-new-type-definition-package">12.5.3.1. Define a New Type Definition Package</a></li>
+<li><a href="components.html#_using-a-type-definition-package">12.5.3.2. Using a Type Definition Package</a></li>
+<li><a href="components.html#_rational">12.5.3.3. Rational</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="components.html#_modules">12.6. Modules</a></li>
+<li><a href="components.html#_api-and-implementation-component">12.7. API and Implementation Component</a>
+<ul class="sectlevel3">
+<li><a href="components.html#_execution-of-api-and-implementation-components">12.7.1. Execution of API and Implementation Components</a></li>
+<li><a href="components.html#_api-and-implementation-with-di">12.7.2. API and Implementation With DI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="plainjs.html#_plainjs">13. PlainJS</a>
+<ul class="sectlevel2">
+<li><a href="plainjs.html#_type-inference-and-validation-for-plain-js">13.1. Type Inference and Validation for Plain JS</a></li>
+<li><a href="plainjs.html#_external-declarations">13.2. External Declarations</a>
+<ul class="sectlevel3">
+<li><a href="plainjs.html#_declaring-externals">13.2.1. Declaring externals</a></li>
+<li><a href="plainjs.html#_instantiating-external-classes">13.2.2. Instantiating external classes</a></li>
+<li><a href="plainjs.html#_implementation-of-external-declarations">13.2.3. Implementation of External Declarations</a></li>
+<li><a href="plainjs.html#_example">13.2.4. Example</a></li>
+</ul>
+</li>
+<li><a href="plainjs.html#_global-definitions">13.3. Global Definitions</a></li>
+<li><a href="plainjs.html#_runtime-definitions">13.4. Runtime Definitions</a></li>
+<li><a href="plainjs.html#_applying-polyfills">13.5. Applying Polyfills</a></li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_jsdoc-2">14. JSDoc</a>
+<ul class="sectlevel2">
+<li><a href="jsdoc.html#_general-n4jsdoc-features">14.1. General N4JSDoc Features</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#_provided-inline-tags">14.1.1. Provided Inline Tags</a>
+<ul class="sectlevel4">
+<li><a href="jsdoc.html#jsdoc_tag__code">14.1.1.1. @code</a></li>
+<li><a href="jsdoc.html#jsdoc_tag__link">14.1.1.2. @link</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_n4jsdoc-for-user-projects">14.2. N4JSdoc for User Projects</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#_standard-tags">14.2.1. Standard Tags</a>
+<ul class="sectlevel4">
+<li><a href="jsdoc.html#_-author">14.2.1.1. @author</a></li>
+<li><a href="jsdoc.html#jsdoc_tag_param">14.2.1.2. @param</a></li>
+<li><a href="jsdoc.html#jsdoc_tag_return">14.2.1.3. @return</a></li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_test-related-tags">14.2.2. Test Related Tags</a>
+<ul class="sectlevel4">
+<li><a href="jsdoc.html#jsdoc_tag__testee">14.2.2.1. @testee</a></li>
+<li><a href="jsdoc.html#jsdoc_tag__testeeFromType">14.2.2.2. @testeeFromType</a></li>
+<li><a href="jsdoc.html#_testeeType_and__testeeMember">14.2.2.3. @testeeType and @testeeMember</a></li>
+<li><a href="jsdoc.html#jsdoc_tag_reqid_in_Tests">14.2.2.4. @reqid in Tests</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_n4jsdoc-for-api-and-implementation-projects">14.3. N4JSDoc for API and Implementation Projects</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#jsdoc_tag__apiNote">14.3.1. @apiNote</a></li>
+<li><a href="jsdoc.html#API_Project_Tags">14.3.2. API Project Tags</a>
+<ul class="sectlevel4">
+<li><a href="jsdoc.html#jsdoc_tag_apiState">14.3.2.1. @apiState</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsx.html#_jsx">15. JSX</a>
+<ul class="sectlevel2">
+<li><a href="jsx.html#_jsx-support">15.1. JSX Support</a></li>
+<li><a href="jsx.html#_jsx-backend">15.2. JSX Backend</a></li>
+</ul>
+</li>
+<li><a href="grammars.html#_grammars">16. Grammars</a>
+<ul class="sectlevel2">
+<li><a href="grammars.html#_type-expressions-grammar">16.1. Type Expressions Grammar</a></li>
+<li><a href="grammars.html#_n4js-language-grammar">16.2. N4JS Language Grammar</a></li>
+</ul>
+</li>
+<li><a href="jsobjects.html#_jsobjects">17. JSObjects</a>
+<ul class="sectlevel2">
+<li><a href="jsobjects.html#_object">17.1. Object</a></li>
+<li><a href="jsobjects.html#_string">17.2. String</a></li>
+<li><a href="jsobjects.html#_boolean">17.3. Boolean</a></li>
+<li><a href="jsobjects.html#_number">17.4. Number</a>
+<ul class="sectlevel3">
+<li><a href="jsobjects.html#_static-attributes">17.4.1. Static Attributes</a></li>
+</ul>
+</li>
+<li><a href="jsobjects.html#function">17.5. Function</a></li>
+<li><a href="jsobjects.html#_error">17.6. Error</a></li>
+<li><a href="jsobjects.html#_array">17.7. Array</a></li>
+<li><a href="jsobjects.html#_date">17.8. Date</a></li>
+<li><a href="jsobjects.html#_math">17.9. Math</a>
+<ul class="sectlevel3">
+<li><a href="jsobjects.html#static-attributes-1">17.9.1. Static Attributes</a></li>
+</ul>
+</li>
+<li><a href="jsobjects.html#_regexp">17.10. RegExp</a></li>
+<li><a href="jsobjects.html#_json">17.11. JSON</a></li>
+</ul>
+</li>
+<li><a href="n4js_objects.html#_n4js-objects">18. N4JS Objects</a>
+<ul class="sectlevel2">
+<li><a href="n4js_objects.html#_reflection-model">18.1. Reflection Model</a></li>
+<li><a href="n4js_objects.html#_error-types">18.2. Error Types</a>
+<ul class="sectlevel3">
+<li><a href="n4js_objects.html#_n4apinotimplemented">18.2.1. N4ApiNotImplemented</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#_acronyms">Appendix A: Acronyms</a></li>
+<li><a href="appendix_b_license.html#sec:License">Appendix B: License</a></li>
+<li><a href="appendix_c_bibliography.html#_bibliography">Appendix C: Bibliography</a></li>
+</ul>
+</div>
+</div>
+<div id="content"><div class="sect1">
+<h2 id="_acronyms"><a class="anchor" href="#_acronyms"></a><a class="link" href="#_acronyms">Appendix A: Acronyms</a></h2>
+<div class="sectionbody">
+<table id="AC" class="tableblock frame-all grid-all spread language-bash">
+<colgroup>
+<col style="width: 8.3333%;">
+<col style="width: 41.6666%;">
+<col style="width: 8.3333%;">
+<col style="width: 41.6668%;">
+</colgroup>
+<tbody>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>CDep</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Compile-Time Dependency</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>RDep</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Run-Time Dependency</p></th>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>LDep</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Load-Time Dependency</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>IDep</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Initialization-Time Dependency</p></th>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>EDep</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Execution-Time Dependency</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>ANTLR</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">ANother Tool for Language Recognition</p></th>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>API</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Application Programming Interface</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>AST</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Abstract Syntax Tree</p></th>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>ASI</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Automatic Semicolon Insertion</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>BNF</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Backus-Naur Form</p></th>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>CLI</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Command Line Interface (including a headless compiler and runner.)</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>DI</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Dependency Injection</p></th>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>DIC</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">DI Component</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>DOM</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Document Object Model</p></th>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>DSL</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Domain Specific Language</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>EBNF</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Extended Backus-Naur Form</p></th>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>EMF</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Eclipse Modeling Framework <a id="EMF"></a></p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>FQN</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Fully Qualified Name</p></th>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>GLB</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Greatest Lower Bound, also known as <em>infimum</em></p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>GCST</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Greatest Common Sub Type, also known as <em>meet</em></p></th>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>IDE</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Integrated Development Environment</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>IDL</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Interface Definition Language</p></th>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>LSP</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Liskov Substitution Principle [<a href="appendix_c_bibliography.html#Martin96b">Martin96b</a>]</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>LUB</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Least Upper Bound, also known as <em>supremum</em></p></th>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>LCST</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Least Common Super Type, also known as <em>join</em></p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>N4JS</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">N4JS for JavaScript</p></th>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>N4JSED</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">N4JS Environment Definition</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>N4JSIDE</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">N4JS Integrated Development Environment (Eclipse-based IDE for all N4JS related languages and projects)</p></th>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>VM</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Virtual Machine</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>XML</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Extensible Markup Language</p></th>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>XSLT / XSL</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">XSL Transformations</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>XSL</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Extensible Stylesheet Language</p></th>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>WYSIWYG</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">What You See Is What You Get</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>WLOG</code></p></td>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Without loss of generality</p></th>
+</tr>
+</tbody>
+</table>
+</div>
+</div>
+</div>
+<div id="footer">
+<div id="footer-text">
+Version 0.9<br>
+Last updated 2019-08-07 15:02:40 CEST
+</div>
+</div>
+<!-- ************* docinfo-footer *************************************************************** -->
+<div class="Grid social" style="color:#d5dfea">
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <h2>Quick Links</h2>
+    <ul>
+      <li><a href="../downloads.html">Download</a></li>
+      <li><a href="../userguides/index.html">Documentation</a></li>
+      <li><a href="https://github.com/eclipse/n4js/">Source</a></li>
+      <li><a href="https://github.com/eclipse/n4js/issues">Issues</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="https://www.eclipse.org/forums/index.php/f/365/">Forum</a></li>
+      <li><a href="http://n4js.blogspot.de/">Blog</a></li>
+      <li><a href="https://dev.eclipse.org/mailman/listinfo/n4js-dev">Mailing List</a></li>
+      <li><a href="https://projects.eclipse.org/projects/technology.n4js">Eclipse Project Page</a></li>
+      <li><a href="https://twitter.com/n4jsdev">Tweets by n4jsdev</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="http://www.eclipse.org/">Eclipse Home</a></li>
+      <li><a href="http://www.eclipse.org/legal/privacy.php">Privacy Policy</a></li>
+      <li><a href="http://www.eclipse.org/legal/termsofuse.php">Terms of Use</a></li>
+      <li><a href="http://www.eclipse.org/legal/copyright.php">Copyright Agent</a></li>
+      <li><a href="http://www.eclipse.org/legal/">Legal</a></li>
+    </ul>
+  </div>
+  <div style="clear: both; height: 0; overflow: hidden;"></div>
+</div>
+
+<!-- ************* UI Scripts ************* -->
+<script type="text/javascript" src="scripts/back-to-top.js"></script>
+
+<script type="text/javascript" src="scripts/treeview.js"></script>
+<script type="text/javascript" src="scripts/toc.js"></script>
+
+<!-- ************* Prism.js Syntax Highlighting ************* -->
+<script src="scripts/prism.js"></script>
+
+<script type="text/javascript">
+	// Add the 'toclist' id for search function
+	$(".toc2 > ul").attr('id', 'toclist');
+	// Generate a Search input form
+	$("#toclist > li:first-of-type").before('<input type="text" id="pagesearch" onkeyup="search()" placeholder="Search for section...">');
+	$("#toclist > li:first-of-type").before('<i id="clear" class="fa fa-times-circle-o"></i>');
+	$("#clear").click(function(){
+	    $("#pagesearch").val('');
+	    search();
+	    $('.toc2 > ul').treeView('collapseAll');
+	});
+	// intialize Treeview.js
+	$(".toc2 > ul").treeView();
+	// Initialize Scrollspy
+</script>
+<!-- ************* docinfo-footer *************************************************************** -->
+</body>
+</html>
\ No newline at end of file
diff --git a/spec/appendix_b_license.html b/spec/appendix_b_license.html
new file mode 100644
index 0000000..a514546
--- /dev/null
+++ b/spec/appendix_b_license.html
@@ -0,0 +1,1210 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="generator" content="Asciidoctor 1.5.5">
+<meta name="author" content="2019-08-07 15:02:40 CEST">
+<title>N4JS Language Specification</title>
+<link rel="stylesheet" href="styles/spec.min.css">
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.6.3/css/font-awesome.min.css">
+<!-- ************* docinfo ******************************************************************* -->
+
+
+<!-- ************* Favicon ************-->
+<link rel="icon" href="images/favicon.ico" />
+
+<!-- ************* Back-to-top JQuery ************* -->
+<script src="https://code.jquery.com/jquery-1.12.4.js"></script>
+<script src="https://code.jquery.com/ui/1.12.0/jquery-ui.js"></script>
+
+
+<link href="styles/prism.min.css" rel="stylesheet" />
+<script type="text/javascript" async
+  src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2/MathJax.js?config=TeX-MML-AM_CHTML">
+</script>
+
+<!-- ************* Styles ************* -->
+<link rel="stylesheet" type="text/css" href="styles/n4jsspec-adoc.css">
+
+
+<!-- ****************** NavBar ****************** -->
+<div id="menubar">
+	<div class="banner">
+        <a href="https://www.eclipse.org/n4js/#"><img id="logo" src="images/n4js-logo.png" alt="Eclipse N4JS"></a>
+    </div>
+<ul>
+  <li><a href="index.html">Index</a></li>
+</ul>
+</div>
+<!-- ************* docinfo ******************************************************************* -->
+<style>
+      .admonitionblock td.icon .icon-todo:before{content:"\f249";color:#f4ee42}
+    </style>
+</head>
+<body class="book toc2 toc-left">
+<div id="header">
+<h1>N4JS Language Specification</h1>
+<div class="details">
+<span id="author" class="author">2019-08-07 15:02:40 CEST</span><br>
+<span id="revnumber">version 0.9</span>
+</div>
+<div id="toc" class="toc2">
+<div id="toctitle">Table of Contents</div>
+<ul class="sectlevel1">
+<li><a href="introduction.html#_introduction">1. Introduction</a>
+<ul class="sectlevel2">
+<li><a href="introduction.html#_notation">1.1. Notation</a>
+<ul class="sectlevel3">
+<li><a href="introduction.html#_grammar-notation">1.1.1. Grammar Notation</a></li>
+<li><a href="introduction.html#_type-judgments-and-rules-and-constraints-notation">1.1.2. Type Judgments and Rules and Constraints Notation</a>
+<ul class="sectlevel4">
+<li><a href="introduction.html#_typing-rules-and-judgments">1.1.2.1. Typing Rules and Judgments</a></li>
+<li><a href="introduction.html#_types-of-an-element">1.1.2.2. Types of an Element</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="introduction.html#_auxiliary-functions">1.2. Auxiliary Functions</a>
+<ul class="sectlevel3">
+<li><a href="introduction.html#_binding">1.2.1. Binding</a></li>
+<li><a href="introduction.html#_merging-types">1.2.2. Merging Types</a>
+<ul class="sectlevel4">
+<li><a href="introduction.html#_logic-formulas">1.2.2.1. Logic Formulas</a></li>
+</ul>
+</li>
+<li><a href="introduction.html#_symbols-and-font-convention">1.2.3. Symbols and Font Convention</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="grammar.html#_grammar">2. Grammar</a>
+<ul class="sectlevel2">
+<li><a href="grammar.html#_lexical-conventions">2.1. Lexical Conventions</a>
+<ul class="sectlevel3">
+<li><a href="grammar.html#_identifier-names-and-identifiers">2.1.1. Identifier Names and Identifiers</a></li>
+<li><a href="grammar.html#_this-keyword">2.1.2. This Keyword</a></li>
+<li><a href="grammar.html#_regular-expression-literals">2.1.3. Regular Expression Literals</a></li>
+<li><a href="grammar.html#_automatic-semicolon-insertion">2.1.4. Automatic Semicolon Insertion</a></li>
+<li><a href="grammar.html#_jsdoc">2.1.5. JSDoc</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="names.html#_names">3. Names</a>
+<ul class="sectlevel2">
+<li><a href="names.html#_access-control">3.1. Access Control</a></li>
+<li><a href="names.html#_accessibility-of-types-top-level-variables-and-function-declarations">3.2. Accessibility of Types, Top-Level Variables and Function Declarations</a>
+<ul class="sectlevel3">
+<li><a href="names.html#_accessibility-of-members">3.2.1. Accessibility of Members</a></li>
+<li><a href="names.html#_valid-names">3.2.2. Valid Names</a></li>
+<li><a href="names.html#_qualified-names">3.2.3. Qualified Names</a></li>
+<li><a href="names.html#_name-duplicates">3.2.4. Name Duplicates</a>
+<ul class="sectlevel4">
+<li><a href="names.html#_lexical-environment">3.2.4.1. Lexical Environment</a></li>
+<li><a href="names.html#_duplicates-and-shadowing">3.2.4.2. Duplicates and Shadowing</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="types.html#_types">4. Types</a>
+<ul class="sectlevel2">
+<li><a href="types.html#_overview">4.1. Overview</a></li>
+<li><a href="types.html#_type-expressions">4.2. Type Expressions</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_syntax">4.2.1. Syntax</a></li>
+<li><a href="types.html#_properties">4.2.2. Properties</a></li>
+<li><a href="types.html#_semantics">4.2.3. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_type-inference">4.3. Type Inference</a></li>
+<li><a href="types.html#_generic-and-parameterized-types">4.4. Generic and Parameterized Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_generic-types">4.4.1. Generic Types</a></li>
+<li><a href="types.html#_type-variables">4.4.2. Type Variables</a></li>
+<li><a href="types.html#_parameterized-types">4.4.3. Parameterized Types</a></li>
+</ul>
+</li>
+<li><a href="types.html#_primitive-ecmascript-types">4.5. Primitive ECMAScript Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_undefined-type">4.5.1. Undefined Type</a></li>
+<li><a href="types.html#_null-type">4.5.2. Null Type</a></li>
+<li><a href="types.html#_primitive-boolean-type">4.5.3. Primitive Boolean Type</a></li>
+<li><a href="types.html#_primitive-string-type">4.5.4. Primitive String Type</a></li>
+<li><a href="types.html#_primitive-number-type">4.5.5. Primitive Number Type</a></li>
+<li><a href="types.html#_primitive-type-int">4.5.6. Primitive Type int</a></li>
+<li><a href="types.html#_primitive-symbol-type">4.5.7. Primitive Symbol Type</a></li>
+</ul>
+</li>
+<li><a href="types.html#_primitive-n4js-types">4.6. Primitive N4JS Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_any-type">4.6.1. Any Type</a>
+<ul class="sectlevel4">
+<li><a href="types.html#any-type-semantics">4.6.1.1. Semantics</a></li>
+<li><a href="types.html#any-type-type-inference">4.6.1.2. Type Inference</a>
+<ul class="sectlevel5">
+<li><a href="types.html#_default-type-of-variables">4.6.1.2.1. Default Type of Variables</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="types.html#_void-type">4.6.2. Void Type</a>
+<ul class="sectlevel4">
+<li><a href="types.html#void-type-semantics">4.6.2.1. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_unknown-type">4.6.3. Unknown Type</a></li>
+<li><a href="types.html#_primitive-pathselector-and-i18nkey">4.6.4. Primitive Pathselector and I18nKey</a>
+<ul class="sectlevel4">
+<li><a href="types.html#pathselector-semantics">4.6.4.1. Semantics</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="types.html#_built-in-ecmascript-object-types">4.7. Built-in ECMAScript Object Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#ECMAScript-objects-semantics">4.7.1. Semantics</a></li>
+<li><a href="types.html#_object-type">4.7.2. Object Type</a></li>
+<li><a href="types.html#_function-object-type">4.7.3. Function-Object-Type</a></li>
+<li><a href="types.html#_array-object-type">4.7.4. Array Object Type</a></li>
+<li><a href="types.html#_string-object-type">4.7.5. String Object Type</a></li>
+<li><a href="types.html#_boolean-object-type">4.7.6. Boolean Object Type</a></li>
+<li><a href="types.html#_number-object-type">4.7.7. Number Object Type</a></li>
+<li><a href="types.html#_global-object-type">4.7.8. Global Object Type</a></li>
+<li><a href="types.html#_symbol">4.7.9. Symbol</a></li>
+<li><a href="types.html#_promise">4.7.10. Promise</a></li>
+<li><a href="types.html#_iterator-interface">4.7.11. Iterator Interface</a></li>
+<li><a href="types.html#_iterable-interface">4.7.12. Iterable Interface</a></li>
+</ul>
+</li>
+<li><a href="types.html#_built-in-n4js-types">4.8. Built-In N4JS Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_n4object">4.8.1. N4Object</a>
+<ul class="sectlevel4">
+<li><a href="types.html#N4Object-semantics">4.8.1.1. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_n4class">4.8.2. N4Class</a></li>
+<li><a href="types.html#IterableN">4.8.3. IterableN</a></li>
+</ul>
+</li>
+<li><a href="types.html#_type-modifiers">4.9. Type Modifiers</a>
+<ul class="sectlevel3">
+<li><a href="types.html#Type_Modifiers_Dynamic">4.9.1. Dynamic</a></li>
+<li><a href="types.html#_optional-return-types">4.9.2. Optional Return Types</a></li>
+</ul>
+</li>
+<li><a href="types.html#_union-and-intersection-type-composed-types">4.10. Union and Intersection Type (Composed Types)</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_union-type">4.10.1. Union Type</a>
+<ul class="sectlevel4">
+<li><a href="types.html#union-type-syntax">4.10.1.1. Syntax</a></li>
+<li><a href="types.html#union-type-semantics">4.10.1.2. Semantics</a></li>
+<li><a href="types.html#_warnings">4.10.1.3. Warnings</a></li>
+</ul>
+</li>
+<li><a href="types.html#_intersection-type">4.10.2. Intersection Type</a>
+<ul class="sectlevel4">
+<li><a href="types.html#intersection-type-syntax">4.10.2.1. Syntax</a></li>
+<li><a href="types.html#intersection-type-semantics">4.10.2.2. Semantics</a></li>
+<li><a href="types.html#_warnings-2">4.10.2.3. Warnings</a></li>
+</ul>
+</li>
+<li><a href="types.html#_composed-types-in-wildcards">4.10.3. Composed Types in Wildcards</a></li>
+<li><a href="types.html#_property-access-for-composed-types">4.10.4. Property Access for Composed Types</a>
+<ul class="sectlevel4">
+<li><a href="types.html#_properties-of-union-type">4.10.4.1. Properties of Union Type</a>
+<ul class="sectlevel5">
+<li><a href="types.html#_remarks-on-union-type-s-members">4.10.4.1.1. Remarks on union type’s members:</a></li>
+</ul>
+</li>
+<li><a href="types.html#_properties-of-intersection-type">4.10.4.2. Properties of Intersection Type</a>
+<ul class="sectlevel5">
+<li><a href="types.html#_remarks-on-intersection-type-s-methods">4.10.4.2.1. Remarks on intersection type’s methods:</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="types.html#_constructor-and-classifier-type">4.11. Constructor and Classifier Type</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_syntax-3">4.11.1. Syntax</a></li>
+<li><a href="types.html#_semantics-2">4.11.2. Semantics</a></li>
+<li><a href="types.html#_constructors-and-prototypes-in-ecmascript-2015">4.11.3. Constructors and Prototypes in ECMAScript 2015</a></li>
+</ul>
+</li>
+<li><a href="types.html#_this-type">4.12. This Type</a>
+<ul class="sectlevel3">
+<li><a href="types.html#this-type-syntax">4.12.1. Syntax</a></li>
+<li><a href="types.html#this-keyword-semantics">4.12.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_enums">4.13. Enums</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_enums-n4js">4.13.1. Enums (N4JS)</a>
+<ul class="sectlevel4">
+<li><a href="types.html#enums-syntax">4.13.1.1. Syntax</a></li>
+<li><a href="types.html#enums-semantics">4.13.1.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_string-based-enums">4.13.2. String-Based Enums</a></li>
+</ul>
+</li>
+<li><a href="types.html#_short-hand-syntax">4.14. Short-Hand Syntax</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_array-short-hand-syntax">4.14.1. Array Short-Hand Syntax</a></li>
+<li><a href="types.html#_iterablen-short-hand-syntax">4.14.2. IterableN Short-Hand Syntax</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="classifiers.html#_classifiers">5. Classifiers</a>
+<ul class="sectlevel2">
+<li><a href="classifiers.html#_n4js-specific-classifiers">5.1. N4JS Specific Classifiers</a>
+<ul class="sectlevel3">
+<li><a href="classifiers.html#_properties-2">5.1.1. Properties</a></li>
+<li><a href="classifiers.html#_common-semantics-of-classifiers">5.1.2. Common Semantics of Classifiers</a></li>
+<li><a href="classifiers.html#_classes">5.1.3. Classes</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_definition-of-classes">5.1.3.1. Definition of Classes</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#class-syntax">5.1.3.1.1. Syntax</a></li>
+<li><a href="classifiers.html#class-properties">5.1.3.1.2. Properties</a></li>
+<li><a href="classifiers.html#class-type-inference">5.1.3.1.3. Type Inference</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#class-semantics">5.1.3.2. Semantics</a></li>
+<li><a href="classifiers.html#_final-modifier">5.1.3.3. Final Modifier</a></li>
+<li><a href="classifiers.html#_abstract-classes">5.1.3.4. Abstract Classes</a></li>
+<li><a href="classifiers.html#_non-instantiable-classes">5.1.3.5. Non-Instantiable Classes</a></li>
+<li><a href="classifiers.html#_superclass">5.1.3.6. Superclass</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_interfaces">5.1.4. Interfaces</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_definition-of-interfaces">5.1.4.1. Definition of Interfaces</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#interfaces-syntax">5.1.4.1.1. Syntax</a></li>
+<li><a href="classifiers.html#interfaces-properties">5.1.4.1.2. Properties</a></li>
+<li><a href="classifiers.html#interfaces-type-inference">5.1.4.1.3. Type Inference</a></li>
+<li><a href="classifiers.html#interfaces-semantics">5.1.4.1.4. Semantics</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="classifiers.html#_generic-classifiers">5.1.5. Generic Classifiers</a></li>
+<li><a href="classifiers.html#sec:definition-site-variance">5.1.6. Definition-Site Variance</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_members">5.2. Members</a>
+<ul class="sectlevel3">
+<li><a href="classifiers.html#_syntax-4">5.2.1. Syntax</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_properties-3">5.2.1.1. Properties</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_semantics-3">5.2.2. Semantics</a></li>
+<li><a href="classifiers.html#_methods">5.2.3. Methods</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_syntax-5">5.2.3.1. Syntax</a></li>
+<li><a href="classifiers.html#_properties-4">5.2.3.2. Properties</a></li>
+<li><a href="classifiers.html#_semantics-4">5.2.3.3. Semantics</a></li>
+<li><a href="classifiers.html#_final-methods">5.2.3.4. Final Methods</a></li>
+<li><a href="classifiers.html#_abstract-methods">5.2.3.5. Abstract Methods</a></li>
+<li><a href="classifiers.html#_generic-methods">5.2.3.6. Generic Methods</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_default-methods-in-interfaces">5.2.4. Default Methods in Interfaces</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_asynchronous-methods">5.2.4.1. Asynchronous Methods</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_constructors">5.2.5. Constructors</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_structural-this-type-in-constructor">5.2.5.1. Structural This Type in Constructor</a></li>
+<li><a href="classifiers.html#spec-constructor">5.2.5.2. @Spec Constructor</a></li>
+<li><a href="classifiers.html#_callable-constructors">5.2.5.3. Callable Constructors</a></li>
+<li><a href="classifiers.html#_covariant-constructors">5.2.5.4. Covariant Constructors</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_data-fields">5.2.6. Data Fields</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#data-fields-syntax">5.2.6.1. Syntax</a></li>
+<li><a href="classifiers.html#data-fields-properties">5.2.6.2. Properties</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#data-fields-semantics">5.2.6.2.1. Semantics</a></li>
+<li><a href="classifiers.html#data-fields-type-inference">5.2.6.2.2. Type Inference</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_assignment-modifiers">5.2.6.3. Assignment Modifiers</a></li>
+<li><a href="classifiers.html#_field-accessors-getter-setter">5.2.6.4. Field Accessors (Getter/Setter)</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#field-acessors-syntax">5.2.6.4.1. Syntax</a></li>
+<li><a href="classifiers.html#field-acessors-properties">5.2.6.4.2. Properties</a></li>
+<li><a href="classifiers.html#field-accessors-semantics">5.2.6.4.3. Semantics</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#optional-fields">5.2.6.5. Optional Fields</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#_syntax-6">5.2.6.5.1. Syntax</a></li>
+<li><a href="classifiers.html#_semantics-5">5.2.6.5.2. Semantics</a></li>
+<li><a href="classifiers.html#_background">5.2.6.5.3. Background</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="classifiers.html#_static-members">5.2.7. Static Members</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_access-from-and-to-static-members">5.2.7.1. Access From and To Static Members</a></li>
+<li><a href="classifiers.html#_generic-static-methods">5.2.7.2. Generic static methods</a></li>
+<li><a href="classifiers.html#_static-members-of-interfaces">5.2.7.3. Static Members of Interfaces</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_redefinition-of-members">5.2.8. Redefinition of Members</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_overriding-of-members">5.2.8.1. Overriding of Members</a></li>
+<li><a href="classifiers.html#_implementation-of-members">5.2.8.2. Implementation of Members</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#_member-consumption">5.2.8.2.1. Member Consumption</a></li>
+<li><a href="classifiers.html#_member-implementation">5.2.8.2.2. Member Implementation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="classifiers.html#_structural-typing">5.3. Structural Typing</a>
+<ul class="sectlevel3">
+<li><a href="classifiers.html#_syntax-7">5.3.1. Syntax</a></li>
+<li><a href="classifiers.html#_definition-site-structural-typing">5.3.2. Definition Site Structural Typing</a></li>
+<li><a href="classifiers.html#_use-site-structural-typing">5.3.3. Use-Site Structural Typing</a></li>
+<li><a href="classifiers.html#structural-readWriteInit-field-typing">5.3.4. Structural Read-only, Write-only and Initializer Field Typing</a></li>
+<li><a href="classifiers.html#_public-setter-annotated-with-code-providesinitializer-code">5.3.5. Public Setter Annotated With <code>ProvidesInitializer</code></a></li>
+<li><a href="classifiers.html#_structural-types-with-optional-fields">5.3.6. Structural Types With Optional Fields</a></li>
+<li><a href="classifiers.html#_structural-types-with-access-modifier">5.3.7. Structural Types With Access Modifier</a></li>
+<li><a href="classifiers.html#_structural-types-with-additional-members">5.3.8. Structural Types With Additional Members</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_syntax-8">5.3.8.1. Syntax</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#_semantics-6">5.3.8.1.1. Semantics</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="functions.html#_functions">6. Functions</a>
+<ul class="sectlevel2">
+<li><a href="functions.html#_function-type">6.1. Function Type</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_properties-5">6.1.1. Properties</a></li>
+<li><a href="functions.html#function-type-inference">6.1.2. Type Inference</a></li>
+<li><a href="functions.html#_autoboxing-of-function-type">6.1.3. Autoboxing of Function Type</a></li>
+<li><a href="functions.html#_arguments-object">6.1.4. Arguments Object</a></li>
+</ul>
+</li>
+<li><a href="functions.html#_ecmascript-5-function-definition">6.2. ECMAScript 5 Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_function-declaration">6.2.1. Function Declaration</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#_syntax-9">6.2.1.1. Syntax</a></li>
+<li><a href="functions.html#_semantics-8">6.2.1.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="functions.html#_function-expression">6.2.2. Function Expression</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#function-expression-syntax">6.2.2.1. Syntax</a></li>
+<li><a href="functions.html#_semantics-and-type-inference">6.2.2.2. Semantics and Type Inference</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="functions.html#_ecmascript-2015-function-definition">6.3. ECMAScript 2015 Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_formal-parameters">6.3.1. Formal Parameters</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#Type_Modifiers_Optional">6.3.1.1. Optional Parameters</a></li>
+<li><a href="functions.html#Type_Modifiers_Default">6.3.1.2. Default Parameters</a></li>
+<li><a href="functions.html#Type_Modifiers_Variadic">6.3.1.3. Variadic</a></li>
+</ul>
+</li>
+<li><a href="functions.html#_generator-functions">6.3.2. Generator Functions</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#generator-functions-syntax">6.3.2.1. Syntax</a></li>
+<li><a href="functions.html#generator-functions-semantics">6.3.2.2. Semantics</a></li>
+<li><a href="functions.html#_generator-arrow-functions">6.3.2.3. Generator Arrow Functions</a></li>
+</ul>
+</li>
+<li><a href="functions.html#_arrow-function-expression">6.3.3. Arrow Function Expression</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#arrow-function-expression-syntax">6.3.3.1. Syntax</a></li>
+<li><a href="functions.html#arrow-function-expression-semantics-and-type-inference">6.3.3.2. Semantics and Type Inference</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="functions.html#_ecmascript-proposals-function-definition">6.4. ECMAScript Proposals Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_asynchronous-functions">6.4.1. Asynchronous Functions</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#asynchronous-functions-syntax">6.4.1.1. Syntax</a></li>
+<li><a href="functions.html#asynchronous-functions-semantics">6.4.1.2. Semantics</a></li>
+<li><a href="functions.html#_asynchronous-arrow-functions">6.4.1.3. Asynchronous Arrow Functions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="functions.html#_n4js-extended-function-definition">6.5. N4JS Extended Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_generic-functions">6.5.1. Generic Functions</a></li>
+<li><a href="functions.html#_promisifiable-functions">6.5.2. Promisifiable Functions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_conversions-and-reflection">7. Conversions and Reflection</a>
+<ul class="sectlevel2">
+<li><a href="conversions_and_reflection.html#_autoboxing-and-coercing">7.1. Autoboxing and Coercing</a>
+<ul class="sectlevel3">
+<li><a href="conversions_and_reflection.html#_coercing">7.1.1. Coercing</a></li>
+<li><a href="conversions_and_reflection.html#_autoboxing-of-primitives">7.1.2. Autoboxing of Primitives</a></li>
+<li><a href="conversions_and_reflection.html#_autoboxing-of-function-expressions-and-declarations">7.1.3. Autoboxing of Function Expressions and Declarations</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_auto-conversion-of-objects">7.2. Auto-Conversion of Objects</a>
+<ul class="sectlevel3">
+<li><a href="conversions_and_reflection.html#_auto-conversion-of-class-instances">7.2.1. Auto-Conversion of Class Instances</a>
+<ul class="sectlevel4">
+<li><a href="conversions_and_reflection.html#_auto-conversion-of-interface-instances">7.2.1.1. Auto-Conversion of Interface Instances</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_auto-conversion-of-enum-literals">7.2.2. Auto-Conversion of Enum Literals</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_type-cast-and-type-check">7.3. Type Cast and Type Check</a>
+<ul class="sectlevel3">
+<li><a href="conversions_and_reflection.html#_type-cast">7.3.1. Type Cast</a></li>
+<li><a href="conversions_and_reflection.html#_type-check">7.3.2. Type Check</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_reflection-meta-information">7.4. Reflection meta-information</a>
+<ul class="sectlevel3">
+<li><a href="conversions_and_reflection.html#_reflection-for-classes">7.4.1. Reflection for Classes</a></li>
+<li><a href="conversions_and_reflection.html#_reflection-for-interfaces">7.4.2. Reflection for Interfaces</a></li>
+<li><a href="conversions_and_reflection.html#_reflection-for-enumerations">7.4.3. Reflection for Enumerations</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_conversion-of-primitive-types">7.5. Conversion of primitive types</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_expressions">8. Expressions</a>
+<ul class="sectlevel2">
+<li><a href="expressions.html#_ecmascript-5-expressions">8.1. ECMAScript 5 Expressions</a>
+<ul class="sectlevel3">
+<li><a href="expressions.html#_the-this-literal">8.1.1. The this Literal</a></li>
+<li><a href="expressions.html#_identifier">8.1.2. Identifier</a></li>
+<li><a href="expressions.html#_literals">8.1.3. Literals</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#_integer-literals">8.1.3.1. Integer Literals</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_array-literal">8.1.4. Array Literal</a></li>
+<li><a href="expressions.html#_object-literal">8.1.5. Object Literal</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#_properties-6">8.1.5.1. Properties</a></li>
+<li><a href="expressions.html#_scoping-and-linking">8.1.5.2. Scoping and linking</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_parenthesized-expression-and-grouping-operator">8.1.6. Parenthesized Expression and Grouping Operator</a></li>
+<li><a href="expressions.html#_property-accessors">8.1.7. Property Accessors</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#properties-1">8.1.7.1. Properties</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_new-expression">8.1.8. New Expression</a></li>
+<li><a href="expressions.html#_function-expression-2">8.1.9. Function Expression</a></li>
+<li><a href="expressions.html#_function-calls">8.1.10. Function Calls</a></li>
+<li><a href="expressions.html#_postfix-expression">8.1.11. Postfix Expression</a></li>
+<li><a href="expressions.html#_unary-expression">8.1.12. Unary Expression</a></li>
+<li><a href="expressions.html#_multiplicative-expression">8.1.13. Multiplicative Expression</a></li>
+<li><a href="expressions.html#_additive-expression">8.1.14. Additive Expression</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#type-inference-10">8.1.14.1. Type Inference</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_bitwise-shift-expression">8.1.15. Bitwise Shift Expression</a></li>
+<li><a href="expressions.html#_relational-expression">8.1.16. Relational Expression</a></li>
+<li><a href="expressions.html#_equality-expression">8.1.17. Equality Expression</a></li>
+<li><a href="expressions.html#_binary-bitwise-expression">8.1.18. Binary Bitwise Expression</a></li>
+<li><a href="expressions.html#_binary-logical-expression">8.1.19. Binary Logical Expression</a></li>
+<li><a href="expressions.html#_conditional-expression">8.1.20. Conditional Expression</a></li>
+<li><a href="expressions.html#_assignment-expression">8.1.21. Assignment Expression</a></li>
+<li><a href="expressions.html#_comma-expression">8.1.22. Comma Expression</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_ecmascript-6-expressions">8.2. ECMAScript 6 Expressions</a>
+<ul class="sectlevel3">
+<li><a href="expressions.html#_the-super-keyword">8.2.1. The super Keyword</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_ecmascript-7-expressions">8.3. ECMAScript 7 Expressions</a>
+<ul class="sectlevel3">
+<li><a href="expressions.html#_await-expression">8.3.1. Await Expression</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_n4js-specific-expressions">8.4. N4JS Specific Expressions</a>
+<ul class="sectlevel3">
+<li><a href="expressions.html#_class-expression">8.4.1. Class Expression</a></li>
+<li><a href="expressions.html#_cast-as-expression">8.4.2. Cast (As) Expression</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#cast-as-expression-semantics-type-inference">8.4.2.1. Semantics and Type Inference</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#Import_Calls">8.4.3. Import Calls</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#compile-time-expressions">8.5. Compile-Time Expressions</a></li>
+</ul>
+</li>
+<li><a href="statements.html#_statements">9. Statements</a>
+<ul class="sectlevel2">
+<li><a href="statements.html#_ecmascript-5-statements">9.1. ECMAScript 5 Statements</a>
+<ul class="sectlevel3">
+<li><a href="statements.html#_function-or-field-accessor-bodies">9.1.1. Function or Field Accessor Bodies</a></li>
+<li><a href="statements.html#_variable-statement">9.1.2. Variable Statement</a></li>
+<li><a href="statements.html#_if-statement">9.1.3. If Statement</a></li>
+<li><a href="statements.html#_iteration-statements">9.1.4. Iteration Statements</a></li>
+<li><a href="statements.html#_return-statement">9.1.5. Return Statement</a></li>
+<li><a href="statements.html#_with-statement">9.1.6. With Statement</a></li>
+<li><a href="statements.html#_switch-statement">9.1.7. Switch Statement</a></li>
+<li><a href="statements.html#_throw-try-and-catch-statements">9.1.8. Throw, Try, and Catch Statements</a></li>
+<li><a href="statements.html#_debugger-statement">9.1.9. Debugger Statement</a></li>
+</ul>
+</li>
+<li><a href="statements.html#_ecmascript-6-statements">9.2. ECMAScript 6 Statements</a>
+<ul class="sectlevel3">
+<li><a href="statements.html#_let">9.2.1. Let</a></li>
+<li><a href="statements.html#_const">9.2.2. Const</a></li>
+<li><a href="statements.html#_for-of-statement">9.2.3. <code>for &#8230;&#8203; of</code> statement</a></li>
+<li><a href="statements.html#_import-statement">9.2.4. Import Statement</a>
+<ul class="sectlevel4">
+<li><a href="statements.html#Dynamic_Imports">9.2.4.1. Dynamic Imports</a></li>
+<li><a href="statements.html#_immutabilaty-of-imports">9.2.4.2. Immutabilaty of Imports</a></li>
+</ul>
+</li>
+<li><a href="statements.html#_export-statement">9.2.5. Export Statement</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="annotations.html#_annotations">10. Annotations</a>
+<ul class="sectlevel2">
+<li><a href="annotations.html#_introduction-2">10.1. Introduction</a>
+<ul class="sectlevel3">
+<li><a href="annotations.html#_syntax-13">10.1.1. Syntax</a></li>
+<li><a href="annotations.html#_properties-7">10.1.2. Properties</a></li>
+<li><a href="annotations.html#_element-specific-annotations">10.1.3. Element-Specific Annotations</a></li>
+<li><a href="annotations.html#_general-annotations">10.1.4. General Annotations</a>
+<ul class="sectlevel4">
+<li><a href="annotations.html#_idebug">10.1.4.1. IDEBUG</a></li>
+</ul>
+</li>
+<li><a href="annotations.html#idebug-syntax">10.1.5. Syntax</a>
+<ul class="sectlevel4">
+<li><a href="annotations.html#_semantics-11">10.1.5.1. Semantics</a></li>
+<li><a href="annotations.html#_suppress-warnings">10.1.5.2. Suppress Warnings</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="annotations.html#_declaration-of-annotations">10.2. Declaration of Annotations</a></li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_extended-fetaures">11. Extended Fetaures</a>
+<ul class="sectlevel2">
+<li><a href="extended_fetaures.html#_array-and-object-destructuring">11.1. Array and Object Destructuring</a>
+<ul class="sectlevel3">
+<li><a href="extended_fetaures.html#_syntax-14">11.1.1. Syntax</a></li>
+<li><a href="extended_fetaures.html#_semantics-12">11.1.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_dependency-injection">11.2. Dependency Injection</a>
+<ul class="sectlevel3">
+<li><a href="extended_fetaures.html#_di-components-and-injectors">11.2.1. DI Components and Injectors</a>
+<ul class="sectlevel4">
+<li><a href="extended_fetaures.html#_dicomponent-relations">11.2.1.1. DIComponent Relations</a></li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_binders-and-bindings">11.2.2. Binders and Bindings</a></li>
+<li><a href="extended_fetaures.html#_injection-points">11.2.3. Injection Points</a>
+<ul class="sectlevel4">
+<li><a href="extended_fetaures.html#_field-injection">11.2.3.1. Field Injection</a></li>
+<li><a href="extended_fetaures.html#_constructor-injection">11.2.3.2. Constructor Injection</a></li>
+<li><a href="extended_fetaures.html#_method-injection">11.2.3.3. Method Injection</a>
+<ul class="sectlevel5">
+<li><a href="extended_fetaures.html#_provider">11.2.3.3.1. Provider</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_n4js-di-life-cycle-and-scopes">11.2.4. N4JS DI Life Cycle and Scopes</a>
+<ul class="sectlevel4">
+<li><a href="extended_fetaures.html#_injection-cylces">11.2.4.1. Injection Cylces</a></li>
+<li><a href="extended_fetaures.html#_default-scope">11.2.4.2. Default Scope</a></li>
+<li><a href="extended_fetaures.html#_singleton-scope">11.2.4.3. Singleton Scope</a></li>
+<li><a href="extended_fetaures.html#_per-injection-chain-singleton">11.2.4.4. Per Injection Chain Singleton</a></li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_validation-of-callsites-targeting-n4injector-methods">11.2.5. Validation of callsites targeting N4Injector methods</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-annotations">11.2.6. N4JS DI Annotations</a>
+<ul class="sectlevel4">
+<li><a href="extended_fetaures.html#_n4js-di-generateinjector">11.2.6.1. N4JS DI @GenerateInjector</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-withparentinjector">11.2.6.2. N4JS DI @WithParentInjector</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-usebinder">11.2.6.3. N4JS DI @UseBinder</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-binder">11.2.6.4. N4JS DI @Binder</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-bind">11.2.6.5. N4JS DI @Bind</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-provides">11.2.6.6. N4JS DI @Provides</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-inject">11.2.6.7. N4JS DI @Inject</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-singleton">11.2.6.8. N4JS DI @Singleton</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_test-support">11.3. Test Support</a></li>
+<li><a href="extended_fetaures.html#_polyfill-definitions">11.4. Polyfill Definitions</a>
+<ul class="sectlevel3">
+<li><a href="extended_fetaures.html#_runtime-polyfill-definitions">11.4.1. Runtime Polyfill Definitions</a></li>
+<li><a href="extended_fetaures.html#_static-polyfill-definitions">11.4.2. Static Polyfill Definitions</a></li>
+<li><a href="extended_fetaures.html#_transpiling-static-polyfilled-classes">11.4.3. Transpiling static polyfilled classes</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="components.html#_components">12. Components</a>
+<ul class="sectlevel2">
+<li><a href="components.html#_overview-2">12.1. Overview</a></li>
+<li><a href="components.html#Component_Types">12.2. Component Types</a>
+<ul class="sectlevel3">
+<li><a href="components.html#_libraries">12.2.1. Libraries</a></li>
+<li><a href="components.html#_runtime-environment-and-runtime-libraries">12.2.2. Runtime Environment and Runtime Libraries</a></li>
+<li><a href="components.html#_tests">12.2.3. Tests</a></li>
+<li><a href="components.html#_type-definitions">12.2.4. Type Definitions</a></li>
+</ul>
+</li>
+<li><a href="components.html#package-json">12.3. Package.json File</a>
+<ul class="sectlevel3">
+<li><a href="components.html#_basic-properties">12.3.1. Basic Properties</a></li>
+<li><a href="components.html#_n4js-properties">12.3.2. N4JS Properties</a></li>
+<li><a href="components.html#_constraints">12.3.3. Constraints</a></li>
+</ul>
+</li>
+<li><a href="components.html#_support-for-npm-scopes">12.4. Support for NPM Scopes</a></li>
+<li><a href="components.html#sec:N4JS-Type-Definitions">12.5. N4JS Type Definitions</a>
+<ul class="sectlevel3">
+<li><a href="components.html#_specify-type-definition">12.5.1. Specify Type Definition</a></li>
+<li><a href="components.html#_name-conventions">12.5.2. Name Conventions</a></li>
+<li><a href="components.html#_version-conventions">12.5.3. Version Conventions</a>
+<ul class="sectlevel4">
+<li><a href="components.html#_define-a-new-type-definition-package">12.5.3.1. Define a New Type Definition Package</a></li>
+<li><a href="components.html#_using-a-type-definition-package">12.5.3.2. Using a Type Definition Package</a></li>
+<li><a href="components.html#_rational">12.5.3.3. Rational</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="components.html#_modules">12.6. Modules</a></li>
+<li><a href="components.html#_api-and-implementation-component">12.7. API and Implementation Component</a>
+<ul class="sectlevel3">
+<li><a href="components.html#_execution-of-api-and-implementation-components">12.7.1. Execution of API and Implementation Components</a></li>
+<li><a href="components.html#_api-and-implementation-with-di">12.7.2. API and Implementation With DI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="plainjs.html#_plainjs">13. PlainJS</a>
+<ul class="sectlevel2">
+<li><a href="plainjs.html#_type-inference-and-validation-for-plain-js">13.1. Type Inference and Validation for Plain JS</a></li>
+<li><a href="plainjs.html#_external-declarations">13.2. External Declarations</a>
+<ul class="sectlevel3">
+<li><a href="plainjs.html#_declaring-externals">13.2.1. Declaring externals</a></li>
+<li><a href="plainjs.html#_instantiating-external-classes">13.2.2. Instantiating external classes</a></li>
+<li><a href="plainjs.html#_implementation-of-external-declarations">13.2.3. Implementation of External Declarations</a></li>
+<li><a href="plainjs.html#_example">13.2.4. Example</a></li>
+</ul>
+</li>
+<li><a href="plainjs.html#_global-definitions">13.3. Global Definitions</a></li>
+<li><a href="plainjs.html#_runtime-definitions">13.4. Runtime Definitions</a></li>
+<li><a href="plainjs.html#_applying-polyfills">13.5. Applying Polyfills</a></li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_jsdoc-2">14. JSDoc</a>
+<ul class="sectlevel2">
+<li><a href="jsdoc.html#_general-n4jsdoc-features">14.1. General N4JSDoc Features</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#_provided-inline-tags">14.1.1. Provided Inline Tags</a>
+<ul class="sectlevel4">
+<li><a href="jsdoc.html#jsdoc_tag__code">14.1.1.1. @code</a></li>
+<li><a href="jsdoc.html#jsdoc_tag__link">14.1.1.2. @link</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_n4jsdoc-for-user-projects">14.2. N4JSdoc for User Projects</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#_standard-tags">14.2.1. Standard Tags</a>
+<ul class="sectlevel4">
+<li><a href="jsdoc.html#_-author">14.2.1.1. @author</a></li>
+<li><a href="jsdoc.html#jsdoc_tag_param">14.2.1.2. @param</a></li>
+<li><a href="jsdoc.html#jsdoc_tag_return">14.2.1.3. @return</a></li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_test-related-tags">14.2.2. Test Related Tags</a>
+<ul class="sectlevel4">
+<li><a href="jsdoc.html#jsdoc_tag__testee">14.2.2.1. @testee</a></li>
+<li><a href="jsdoc.html#jsdoc_tag__testeeFromType">14.2.2.2. @testeeFromType</a></li>
+<li><a href="jsdoc.html#_testeeType_and__testeeMember">14.2.2.3. @testeeType and @testeeMember</a></li>
+<li><a href="jsdoc.html#jsdoc_tag_reqid_in_Tests">14.2.2.4. @reqid in Tests</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_n4jsdoc-for-api-and-implementation-projects">14.3. N4JSDoc for API and Implementation Projects</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#jsdoc_tag__apiNote">14.3.1. @apiNote</a></li>
+<li><a href="jsdoc.html#API_Project_Tags">14.3.2. API Project Tags</a>
+<ul class="sectlevel4">
+<li><a href="jsdoc.html#jsdoc_tag_apiState">14.3.2.1. @apiState</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsx.html#_jsx">15. JSX</a>
+<ul class="sectlevel2">
+<li><a href="jsx.html#_jsx-support">15.1. JSX Support</a></li>
+<li><a href="jsx.html#_jsx-backend">15.2. JSX Backend</a></li>
+</ul>
+</li>
+<li><a href="grammars.html#_grammars">16. Grammars</a>
+<ul class="sectlevel2">
+<li><a href="grammars.html#_type-expressions-grammar">16.1. Type Expressions Grammar</a></li>
+<li><a href="grammars.html#_n4js-language-grammar">16.2. N4JS Language Grammar</a></li>
+</ul>
+</li>
+<li><a href="jsobjects.html#_jsobjects">17. JSObjects</a>
+<ul class="sectlevel2">
+<li><a href="jsobjects.html#_object">17.1. Object</a></li>
+<li><a href="jsobjects.html#_string">17.2. String</a></li>
+<li><a href="jsobjects.html#_boolean">17.3. Boolean</a></li>
+<li><a href="jsobjects.html#_number">17.4. Number</a>
+<ul class="sectlevel3">
+<li><a href="jsobjects.html#_static-attributes">17.4.1. Static Attributes</a></li>
+</ul>
+</li>
+<li><a href="jsobjects.html#function">17.5. Function</a></li>
+<li><a href="jsobjects.html#_error">17.6. Error</a></li>
+<li><a href="jsobjects.html#_array">17.7. Array</a></li>
+<li><a href="jsobjects.html#_date">17.8. Date</a></li>
+<li><a href="jsobjects.html#_math">17.9. Math</a>
+<ul class="sectlevel3">
+<li><a href="jsobjects.html#static-attributes-1">17.9.1. Static Attributes</a></li>
+</ul>
+</li>
+<li><a href="jsobjects.html#_regexp">17.10. RegExp</a></li>
+<li><a href="jsobjects.html#_json">17.11. JSON</a></li>
+</ul>
+</li>
+<li><a href="n4js_objects.html#_n4js-objects">18. N4JS Objects</a>
+<ul class="sectlevel2">
+<li><a href="n4js_objects.html#_reflection-model">18.1. Reflection Model</a></li>
+<li><a href="n4js_objects.html#_error-types">18.2. Error Types</a>
+<ul class="sectlevel3">
+<li><a href="n4js_objects.html#_n4apinotimplemented">18.2.1. N4ApiNotImplemented</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_acronyms.html#_acronyms">Appendix A: Acronyms</a></li>
+<li><a href="#sec:License">Appendix B: License</a></li>
+<li><a href="appendix_c_bibliography.html#_bibliography">Appendix C: Bibliography</a></li>
+</ul>
+</div>
+</div>
+<div id="content"><div class="sect1">
+<h2 id="sec:License"><a class="anchor" href="#sec:License"></a><a class="link" href="#sec:License">Appendix B: License</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>This specification and the accompanying materials is made available
+under the terms of the Eclipse Public License v1.0 which accompanies
+this distribution, and is available at <a href="http://www.eclipse.org/legal/epl-v10.html" class="bare">http://www.eclipse.org/legal/epl-v10.html</a></p>
+</div>
+<h3 id="_eclipse-public-license-v-1-0" class="discrete">Eclipse Public License - v 1.0</h3>
+<div class="paragraph">
+<p>THE ACCOMPANYING PROGRAM IS PROVIDED UNDER THE TERMS OF THIS ECLIPSE
+PUBLIC LICENSE (<code>AGREEMENT</code>). ANY USE, REPRODUCTION OR DISTRIBUTION OF
+THE PROGRAM CONSTITUTES RECIPIENT’S ACCEPTANCE OF THIS AGREEMENT.</p>
+</div>
+<h4 id="_1-definitions" class="discrete">1. DEFINITIONS</h4>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><code>Contribution</code> means: </dt>
+<dd>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>in the case of the initial Contributor, the initial code and
+documentation distributed under this Agreement, and</p>
+</li>
+<li>
+<p>in the case of each subsequent Contributor:</p>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p>changes to the Program, and</p>
+</li>
+<li>
+<p>additions to the Program;</p>
+<div class="paragraph">
+<p>where such changes and/or additions to the Program originate from and
+are distributed by that particular Contributor. A Contribution
+’originates’ from a Contributor if it was added to the Program by such
+Contributor itself or anyone acting on such Contributor’s behalf.
+Contributions do not include additions to the Program which:</p>
+</div>
+<div class="olist lowerroman">
+<ol class="lowerroman" type="i">
+<li>
+<p>are separate modules of software distributed in conjunction with the Program
+under their own license agreement, and</p>
+</li>
+<li>
+<p>are not derivative works of the Program.</p>
+</li>
+</ol>
+</div>
+</li>
+</ol>
+</div>
+</li>
+</ol>
+</div>
+</dd>
+<dt class="hdlist1"><code>Contributor</code></dt>
+<dd>
+<p>means any person or entity that distributes the Program.</p>
+</dd>
+<dt class="hdlist1"><code>Licensed Patents</code> </dt>
+<dd>
+<p>mean patent claims licensable by a Contributor
+which are necessarily infringed by the use or sale of its Contribution
+alone or when combined with the Program.</p>
+</dd>
+<dt class="hdlist1"><code>Program</code> </dt>
+<dd>
+<p>means the Contributions distributed in accordance with this
+Agreement.</p>
+</dd>
+<dt class="hdlist1"><code>Recipient</code> </dt>
+<dd>
+<p>means anyone who receives the Program under this
+Agreement, including all Contributors.</p>
+</dd>
+</dl>
+</div>
+<h4 id="_2-grant-of-rights" class="discrete">2. GRANT OF RIGHTS</h4>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Subject to the terms of this Agreement, each Contributor hereby
+grants Recipient a non-exclusive, worldwide, royalty-free copyright
+license to reproduce, prepare derivative works of, publicly display,
+publicly perform, distribute and sublicense the Contribution of such
+Contributor, if any, and such derivative works, in source code and
+object code form.</p>
+</li>
+<li>
+<p>Subject to the terms of this Agreement, each Contributor hereby
+grants Recipient a non-exclusive, worldwide, royalty-free patent license
+under Licensed Patents to make, use, sell, offer to sell, import and
+otherwise transfer the Contribution of such Contributor, if any, in
+source code and object code form. This patent license shall apply to the
+combination of the Contribution and the Program if, at the time the
+Contribution is added by the Contributor, such addition of the
+Contribution causes such combination to be covered by the Licensed
+Patents. The patent license shall not apply to any other combinations
+which include the Contribution. No hardware per se is licensed
+hereunder.</p>
+</li>
+<li>
+<p>Recipient understands that although each Contributor grants the
+licenses to its Contributions set forth herein, no assurances are
+provided by any Contributor that the Program does not infringe the
+patent or other intellectual property rights of any other entity. Each
+Contributor disclaims any liability to Recipient for claims brought by
+any other entity based on infringement of intellectual property rights
+or otherwise. As a condition to exercising the rights and licenses
+granted hereunder, each Recipient hereby assumes sole responsibility to
+secure any other intellectual property rights needed, if any. For
+example, if a third party patent license is required to allow Recipient
+to distribute the Program, it is Recipient’s responsibility to acquire
+that license before distributing the Program.</p>
+</li>
+<li>
+<p>Each Contributor represents that to its knowledge it has sufficient
+copyright rights in its Contribution, if any, to grant the copyright
+license set forth in this Agreement.</p>
+</li>
+</ol>
+</div>
+<h4 id="_3-requirements" class="discrete">3. REQUIREMENTS</h4>
+<div class="paragraph">
+<p>A Contributor may choose to distribute the Program in object code form
+under its own license agreement, provided that:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>it complies with the terms and conditions of this Agreement; and</p>
+</li>
+<li>
+<p>its license agreement:</p>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p>effectively disclaims on behalf of all Contributors all warranties
+and conditions, express and implied, including warranties or conditions
+of title and non-infringement, and implied warranties or conditions of
+merchantability and fitness for a particular purpose;</p>
+</li>
+<li>
+<p>effectively excludes on behalf of all Contributors all liability for
+damages, including direct, indirect, special, incidental and
+consequential damages, such as lost profits;</p>
+</li>
+<li>
+<p>states that any provisions which differ from this Agreement are
+offered by that Contributor alone and not by any other party; and</p>
+</li>
+<li>
+<p>states that source code for the Program is available from such
+Contributor, and informs licensees how to obtain it in a reasonable
+manner on or through a medium customarily used for software exchange.</p>
+</li>
+</ol>
+</div>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>When the Program is made available in source code form:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>it must be made available under this Agreement; and</p>
+</li>
+<li>
+<p>a copy of this Agreement must be included with each copy of the
+Program.</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>Contributors may not remove or alter any copyright notices contained
+within the Program.</p>
+</div>
+<div class="paragraph">
+<p>Each Contributor must identify itself as the originator of its
+Contribution, if any, in a manner that reasonably allows subsequent
+Recipients to identify the originator of the Contribution.</p>
+</div>
+<h4 id="_4-commercial-distribution" class="discrete">4. COMMERCIAL DISTRIBUTION</h4>
+<div class="paragraph">
+<p>Commercial distributors of software may accept certain responsibilities
+with respect to end users, business partners and the like. While this
+license is intended to facilitate the commercial use of the Program, the
+Contributor who includes the Program in a commercial product offering
+should do so in a manner which does not create potential liability for
+other Contributors. Therefore, if a Contributor includes the Program in
+a commercial product offering, such Contributor (<code>Commercial
+Contributor</code>) hereby agrees to defend and indemnify every other
+Contributor (<code>Indemnified Contributor</code>) against any losses, damages
+and costs (collectively <code>Losses</code>) arising from claims, lawsuits and
+other legal actions brought by a third party against the Indemnified
+Contributor to the extent caused by the acts or omissions of such
+Commercial Contributor in connection with its distribution of the
+Program in a commercial product offering. The obligations in this
+section do not apply to any claims or Losses relating to any actual or
+alleged intellectual property infringement. In order to qualify, an
+Indemnified Contributor must: a) promptly notify the Commercial
+Contributor in writing of such claim, and b) allow the Commercial
+Contributor to control, and cooperate with the Commercial Contributor
+in, the defense and any related settlement negotiations. The Indemnified
+Contributor may participate in any such claim at its own expense.</p>
+</div>
+<div class="paragraph">
+<p>For example, a Contributor might include the Program in a commercial
+product offering, Product X. That Contributor is then a Commercial
+Contributor. If that Commercial Contributor then makes performance
+claims, or offers warranties related to Product X, those performance
+claims and warranties are such Commercial Contributor’s responsibility
+alone. Under this section, the Commercial Contributor would have to
+defend claims against the other Contributors related to those
+performance claims and warranties, and if a court requires any other
+Contributor to pay any damages as a result, the Commercial Contributor
+must pay those damages.</p>
+</div>
+<h4 id="_5-no-warranty" class="discrete">5. NO WARRANTY</h4>
+<div class="paragraph">
+<p>EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, THE PROGRAM IS PROVIDED
+ON AN <code>AS IS</code> BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,
+EITHER EXPRESS OR IMPLIED INCLUDING, WITHOUT LIMITATION, ANY WARRANTIES
+OR CONDITIONS OF TITLE, NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR
+A PARTICULAR PURPOSE. Each Recipient is solely responsible for
+determining the appropriateness of using and distributing the Program
+and assumes all risks associated with its exercise of rights under this
+Agreement , including but not limited to the risks and costs of program
+errors, compliance with applicable laws, damage to or loss of data,
+programs or equipment, and unavailability or interruption of operations.</p>
+</div>
+<h4 id="_6-disclaimer-of-liability" class="discrete">6. DISCLAIMER OF LIABILITY</h4>
+<div class="paragraph">
+<p>EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, NEITHER RECIPIENT NOR
+ANY CONTRIBUTORS SHALL HAVE ANY LIABILITY FOR ANY DIRECT, INDIRECT,
+INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING
+WITHOUT LIMITATION LOST PROFITS), HOWEVER CAUSED AND ON ANY THEORY OF
+LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OR
+DISTRIBUTION OF THE PROGRAM OR THE EXERCISE OF ANY RIGHTS GRANTED
+HEREUNDER, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.</p>
+</div>
+<h4 id="_7-general" class="discrete">7. GENERAL</h4>
+<div class="paragraph">
+<p>If any provision of this Agreement is invalid or unenforceable under
+applicable law, it shall not affect the validity or enforceability of
+the remainder of the terms of this Agreement, and without further action
+by the parties hereto, such provision shall be reformed to the minimum
+extent necessary to make such provision valid and enforceable.</p>
+</div>
+<div class="paragraph">
+<p>If Recipient institutes patent litigation against any entity (including
+a cross-claim or counterclaim in a lawsuit) alleging that the Program
+itself (excluding combinations of the Program with other software or
+hardware) infringes such Recipient’s patent(s), then such Recipient’s
+rights granted under Section 2(b) shall terminate as of the date such
+litigation is filed.</p>
+</div>
+<div class="paragraph">
+<p>All Recipient’s rights under this Agreement shall terminate if it fails
+to comply with any of the material terms or conditions of this Agreement
+and does not cure such failure in a reasonable period of time after
+becoming aware of such noncompliance. If all Recipient’s rights under
+this Agreement terminate, Recipient agrees to cease use and distribution
+of the Program as soon as reasonably practicable. However, Recipient’s
+obligations under this Agreement and any licenses granted by Recipient
+relating to the Program shall continue and survive.</p>
+</div>
+<div class="paragraph">
+<p>Everyone is permitted to copy and distribute copies of this Agreement,
+but in order to avoid inconsistency the Agreement is copyrighted and may
+only be modified in the following manner. The Agreement Steward reserves
+the right to publish new versions (including revisions) of this
+Agreement from time to time. No one other than the Agreement Steward has
+the right to modify this Agreement. The Eclipse Foundation is the
+initial Agreement Steward. The Eclipse Foundation may assign the
+responsibility to serve as the Agreement Steward to a suitable separate
+entity. Each new version of the Agreement will be given a distinguishing
+version number. The Program (including Contributions) may always be
+distributed subject to the version of the Agreement under which it was
+received. In addition, after a new version of the Agreement is
+published, Contributor may elect to distribute the Program (including
+its Contributions) under the new version. Except as expressly stated in
+Sections 2(a) and 2(b) above, Recipient receives no rights or licenses
+to the intellectual property of any Contributor under this Agreement,
+whether expressly, by implication, estoppel or otherwise. All rights in
+the Program not expressly granted under this Agreement are reserved.</p>
+</div>
+<div class="paragraph">
+<p>This Agreement is governed by the laws of the State of New York and the
+intellectual property laws of the United States of America. No party to
+this Agreement will bring a legal action under this Agreement more than
+one year after the cause of action arose. Each party waives its rights
+to a jury trial in any resulting litigation.</p>
+</div>
+</div>
+</div>
+</div>
+<div id="footer">
+<div id="footer-text">
+Version 0.9<br>
+Last updated 2019-08-07 15:02:40 CEST
+</div>
+</div>
+<!-- ************* docinfo-footer *************************************************************** -->
+<div class="Grid social" style="color:#d5dfea">
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <h2>Quick Links</h2>
+    <ul>
+      <li><a href="../downloads.html">Download</a></li>
+      <li><a href="../userguides/index.html">Documentation</a></li>
+      <li><a href="https://github.com/eclipse/n4js/">Source</a></li>
+      <li><a href="https://github.com/eclipse/n4js/issues">Issues</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="https://www.eclipse.org/forums/index.php/f/365/">Forum</a></li>
+      <li><a href="http://n4js.blogspot.de/">Blog</a></li>
+      <li><a href="https://dev.eclipse.org/mailman/listinfo/n4js-dev">Mailing List</a></li>
+      <li><a href="https://projects.eclipse.org/projects/technology.n4js">Eclipse Project Page</a></li>
+      <li><a href="https://twitter.com/n4jsdev">Tweets by n4jsdev</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="http://www.eclipse.org/">Eclipse Home</a></li>
+      <li><a href="http://www.eclipse.org/legal/privacy.php">Privacy Policy</a></li>
+      <li><a href="http://www.eclipse.org/legal/termsofuse.php">Terms of Use</a></li>
+      <li><a href="http://www.eclipse.org/legal/copyright.php">Copyright Agent</a></li>
+      <li><a href="http://www.eclipse.org/legal/">Legal</a></li>
+    </ul>
+  </div>
+  <div style="clear: both; height: 0; overflow: hidden;"></div>
+</div>
+
+<!-- ************* UI Scripts ************* -->
+<script type="text/javascript" src="scripts/back-to-top.js"></script>
+
+<script type="text/javascript" src="scripts/treeview.js"></script>
+<script type="text/javascript" src="scripts/toc.js"></script>
+
+<!-- ************* Prism.js Syntax Highlighting ************* -->
+<script src="scripts/prism.js"></script>
+
+<script type="text/javascript">
+	// Add the 'toclist' id for search function
+	$(".toc2 > ul").attr('id', 'toclist');
+	// Generate a Search input form
+	$("#toclist > li:first-of-type").before('<input type="text" id="pagesearch" onkeyup="search()" placeholder="Search for section...">');
+	$("#toclist > li:first-of-type").before('<i id="clear" class="fa fa-times-circle-o"></i>');
+	$("#clear").click(function(){
+	    $("#pagesearch").val('');
+	    search();
+	    $('.toc2 > ul').treeView('collapseAll');
+	});
+	// intialize Treeview.js
+	$(".toc2 > ul").treeView();
+	// Initialize Scrollspy
+</script>
+<!-- ************* docinfo-footer *************************************************************** -->
+</body>
+</html>
\ No newline at end of file
diff --git a/spec/appendix_c_bibliography.html b/spec/appendix_c_bibliography.html
new file mode 100644
index 0000000..f2ec876
--- /dev/null
+++ b/spec/appendix_c_bibliography.html
@@ -0,0 +1,1204 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="generator" content="Asciidoctor 1.5.5">
+<meta name="author" content="2019-08-07 15:02:40 CEST">
+<title>N4JS Language Specification</title>
+<link rel="stylesheet" href="styles/spec.min.css">
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.6.3/css/font-awesome.min.css">
+<!-- ************* docinfo ******************************************************************* -->
+
+
+<!-- ************* Favicon ************-->
+<link rel="icon" href="images/favicon.ico" />
+
+<!-- ************* Back-to-top JQuery ************* -->
+<script src="https://code.jquery.com/jquery-1.12.4.js"></script>
+<script src="https://code.jquery.com/ui/1.12.0/jquery-ui.js"></script>
+
+
+<link href="styles/prism.min.css" rel="stylesheet" />
+<script type="text/javascript" async
+  src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2/MathJax.js?config=TeX-MML-AM_CHTML">
+</script>
+
+<!-- ************* Styles ************* -->
+<link rel="stylesheet" type="text/css" href="styles/n4jsspec-adoc.css">
+
+
+<!-- ****************** NavBar ****************** -->
+<div id="menubar">
+	<div class="banner">
+        <a href="https://www.eclipse.org/n4js/#"><img id="logo" src="images/n4js-logo.png" alt="Eclipse N4JS"></a>
+    </div>
+<ul>
+  <li><a href="index.html">Index</a></li>
+</ul>
+</div>
+<!-- ************* docinfo ******************************************************************* -->
+<style>
+      .admonitionblock td.icon .icon-todo:before{content:"\f249";color:#f4ee42}
+    </style>
+</head>
+<body class="book toc2 toc-left">
+<div id="header">
+<h1>N4JS Language Specification</h1>
+<div class="details">
+<span id="author" class="author">2019-08-07 15:02:40 CEST</span><br>
+<span id="revnumber">version 0.9</span>
+</div>
+<div id="toc" class="toc2">
+<div id="toctitle">Table of Contents</div>
+<ul class="sectlevel1">
+<li><a href="introduction.html#_introduction">1. Introduction</a>
+<ul class="sectlevel2">
+<li><a href="introduction.html#_notation">1.1. Notation</a>
+<ul class="sectlevel3">
+<li><a href="introduction.html#_grammar-notation">1.1.1. Grammar Notation</a></li>
+<li><a href="introduction.html#_type-judgments-and-rules-and-constraints-notation">1.1.2. Type Judgments and Rules and Constraints Notation</a>
+<ul class="sectlevel4">
+<li><a href="introduction.html#_typing-rules-and-judgments">1.1.2.1. Typing Rules and Judgments</a></li>
+<li><a href="introduction.html#_types-of-an-element">1.1.2.2. Types of an Element</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="introduction.html#_auxiliary-functions">1.2. Auxiliary Functions</a>
+<ul class="sectlevel3">
+<li><a href="introduction.html#_binding">1.2.1. Binding</a></li>
+<li><a href="introduction.html#_merging-types">1.2.2. Merging Types</a>
+<ul class="sectlevel4">
+<li><a href="introduction.html#_logic-formulas">1.2.2.1. Logic Formulas</a></li>
+</ul>
+</li>
+<li><a href="introduction.html#_symbols-and-font-convention">1.2.3. Symbols and Font Convention</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="grammar.html#_grammar">2. Grammar</a>
+<ul class="sectlevel2">
+<li><a href="grammar.html#_lexical-conventions">2.1. Lexical Conventions</a>
+<ul class="sectlevel3">
+<li><a href="grammar.html#_identifier-names-and-identifiers">2.1.1. Identifier Names and Identifiers</a></li>
+<li><a href="grammar.html#_this-keyword">2.1.2. This Keyword</a></li>
+<li><a href="grammar.html#_regular-expression-literals">2.1.3. Regular Expression Literals</a></li>
+<li><a href="grammar.html#_automatic-semicolon-insertion">2.1.4. Automatic Semicolon Insertion</a></li>
+<li><a href="grammar.html#_jsdoc">2.1.5. JSDoc</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="names.html#_names">3. Names</a>
+<ul class="sectlevel2">
+<li><a href="names.html#_access-control">3.1. Access Control</a></li>
+<li><a href="names.html#_accessibility-of-types-top-level-variables-and-function-declarations">3.2. Accessibility of Types, Top-Level Variables and Function Declarations</a>
+<ul class="sectlevel3">
+<li><a href="names.html#_accessibility-of-members">3.2.1. Accessibility of Members</a></li>
+<li><a href="names.html#_valid-names">3.2.2. Valid Names</a></li>
+<li><a href="names.html#_qualified-names">3.2.3. Qualified Names</a></li>
+<li><a href="names.html#_name-duplicates">3.2.4. Name Duplicates</a>
+<ul class="sectlevel4">
+<li><a href="names.html#_lexical-environment">3.2.4.1. Lexical Environment</a></li>
+<li><a href="names.html#_duplicates-and-shadowing">3.2.4.2. Duplicates and Shadowing</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="types.html#_types">4. Types</a>
+<ul class="sectlevel2">
+<li><a href="types.html#_overview">4.1. Overview</a></li>
+<li><a href="types.html#_type-expressions">4.2. Type Expressions</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_syntax">4.2.1. Syntax</a></li>
+<li><a href="types.html#_properties">4.2.2. Properties</a></li>
+<li><a href="types.html#_semantics">4.2.3. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_type-inference">4.3. Type Inference</a></li>
+<li><a href="types.html#_generic-and-parameterized-types">4.4. Generic and Parameterized Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_generic-types">4.4.1. Generic Types</a></li>
+<li><a href="types.html#_type-variables">4.4.2. Type Variables</a></li>
+<li><a href="types.html#_parameterized-types">4.4.3. Parameterized Types</a></li>
+</ul>
+</li>
+<li><a href="types.html#_primitive-ecmascript-types">4.5. Primitive ECMAScript Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_undefined-type">4.5.1. Undefined Type</a></li>
+<li><a href="types.html#_null-type">4.5.2. Null Type</a></li>
+<li><a href="types.html#_primitive-boolean-type">4.5.3. Primitive Boolean Type</a></li>
+<li><a href="types.html#_primitive-string-type">4.5.4. Primitive String Type</a></li>
+<li><a href="types.html#_primitive-number-type">4.5.5. Primitive Number Type</a></li>
+<li><a href="types.html#_primitive-type-int">4.5.6. Primitive Type int</a></li>
+<li><a href="types.html#_primitive-symbol-type">4.5.7. Primitive Symbol Type</a></li>
+</ul>
+</li>
+<li><a href="types.html#_primitive-n4js-types">4.6. Primitive N4JS Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_any-type">4.6.1. Any Type</a>
+<ul class="sectlevel4">
+<li><a href="types.html#any-type-semantics">4.6.1.1. Semantics</a></li>
+<li><a href="types.html#any-type-type-inference">4.6.1.2. Type Inference</a>
+<ul class="sectlevel5">
+<li><a href="types.html#_default-type-of-variables">4.6.1.2.1. Default Type of Variables</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="types.html#_void-type">4.6.2. Void Type</a>
+<ul class="sectlevel4">
+<li><a href="types.html#void-type-semantics">4.6.2.1. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_unknown-type">4.6.3. Unknown Type</a></li>
+<li><a href="types.html#_primitive-pathselector-and-i18nkey">4.6.4. Primitive Pathselector and I18nKey</a>
+<ul class="sectlevel4">
+<li><a href="types.html#pathselector-semantics">4.6.4.1. Semantics</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="types.html#_built-in-ecmascript-object-types">4.7. Built-in ECMAScript Object Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#ECMAScript-objects-semantics">4.7.1. Semantics</a></li>
+<li><a href="types.html#_object-type">4.7.2. Object Type</a></li>
+<li><a href="types.html#_function-object-type">4.7.3. Function-Object-Type</a></li>
+<li><a href="types.html#_array-object-type">4.7.4. Array Object Type</a></li>
+<li><a href="types.html#_string-object-type">4.7.5. String Object Type</a></li>
+<li><a href="types.html#_boolean-object-type">4.7.6. Boolean Object Type</a></li>
+<li><a href="types.html#_number-object-type">4.7.7. Number Object Type</a></li>
+<li><a href="types.html#_global-object-type">4.7.8. Global Object Type</a></li>
+<li><a href="types.html#_symbol">4.7.9. Symbol</a></li>
+<li><a href="types.html#_promise">4.7.10. Promise</a></li>
+<li><a href="types.html#_iterator-interface">4.7.11. Iterator Interface</a></li>
+<li><a href="types.html#_iterable-interface">4.7.12. Iterable Interface</a></li>
+</ul>
+</li>
+<li><a href="types.html#_built-in-n4js-types">4.8. Built-In N4JS Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_n4object">4.8.1. N4Object</a>
+<ul class="sectlevel4">
+<li><a href="types.html#N4Object-semantics">4.8.1.1. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_n4class">4.8.2. N4Class</a></li>
+<li><a href="types.html#IterableN">4.8.3. IterableN</a></li>
+</ul>
+</li>
+<li><a href="types.html#_type-modifiers">4.9. Type Modifiers</a>
+<ul class="sectlevel3">
+<li><a href="types.html#Type_Modifiers_Dynamic">4.9.1. Dynamic</a></li>
+<li><a href="types.html#_optional-return-types">4.9.2. Optional Return Types</a></li>
+</ul>
+</li>
+<li><a href="types.html#_union-and-intersection-type-composed-types">4.10. Union and Intersection Type (Composed Types)</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_union-type">4.10.1. Union Type</a>
+<ul class="sectlevel4">
+<li><a href="types.html#union-type-syntax">4.10.1.1. Syntax</a></li>
+<li><a href="types.html#union-type-semantics">4.10.1.2. Semantics</a></li>
+<li><a href="types.html#_warnings">4.10.1.3. Warnings</a></li>
+</ul>
+</li>
+<li><a href="types.html#_intersection-type">4.10.2. Intersection Type</a>
+<ul class="sectlevel4">
+<li><a href="types.html#intersection-type-syntax">4.10.2.1. Syntax</a></li>
+<li><a href="types.html#intersection-type-semantics">4.10.2.2. Semantics</a></li>
+<li><a href="types.html#_warnings-2">4.10.2.3. Warnings</a></li>
+</ul>
+</li>
+<li><a href="types.html#_composed-types-in-wildcards">4.10.3. Composed Types in Wildcards</a></li>
+<li><a href="types.html#_property-access-for-composed-types">4.10.4. Property Access for Composed Types</a>
+<ul class="sectlevel4">
+<li><a href="types.html#_properties-of-union-type">4.10.4.1. Properties of Union Type</a>
+<ul class="sectlevel5">
+<li><a href="types.html#_remarks-on-union-type-s-members">4.10.4.1.1. Remarks on union type’s members:</a></li>
+</ul>
+</li>
+<li><a href="types.html#_properties-of-intersection-type">4.10.4.2. Properties of Intersection Type</a>
+<ul class="sectlevel5">
+<li><a href="types.html#_remarks-on-intersection-type-s-methods">4.10.4.2.1. Remarks on intersection type’s methods:</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="types.html#_constructor-and-classifier-type">4.11. Constructor and Classifier Type</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_syntax-3">4.11.1. Syntax</a></li>
+<li><a href="types.html#_semantics-2">4.11.2. Semantics</a></li>
+<li><a href="types.html#_constructors-and-prototypes-in-ecmascript-2015">4.11.3. Constructors and Prototypes in ECMAScript 2015</a></li>
+</ul>
+</li>
+<li><a href="types.html#_this-type">4.12. This Type</a>
+<ul class="sectlevel3">
+<li><a href="types.html#this-type-syntax">4.12.1. Syntax</a></li>
+<li><a href="types.html#this-keyword-semantics">4.12.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_enums">4.13. Enums</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_enums-n4js">4.13.1. Enums (N4JS)</a>
+<ul class="sectlevel4">
+<li><a href="types.html#enums-syntax">4.13.1.1. Syntax</a></li>
+<li><a href="types.html#enums-semantics">4.13.1.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_string-based-enums">4.13.2. String-Based Enums</a></li>
+</ul>
+</li>
+<li><a href="types.html#_short-hand-syntax">4.14. Short-Hand Syntax</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_array-short-hand-syntax">4.14.1. Array Short-Hand Syntax</a></li>
+<li><a href="types.html#_iterablen-short-hand-syntax">4.14.2. IterableN Short-Hand Syntax</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="classifiers.html#_classifiers">5. Classifiers</a>
+<ul class="sectlevel2">
+<li><a href="classifiers.html#_n4js-specific-classifiers">5.1. N4JS Specific Classifiers</a>
+<ul class="sectlevel3">
+<li><a href="classifiers.html#_properties-2">5.1.1. Properties</a></li>
+<li><a href="classifiers.html#_common-semantics-of-classifiers">5.1.2. Common Semantics of Classifiers</a></li>
+<li><a href="classifiers.html#_classes">5.1.3. Classes</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_definition-of-classes">5.1.3.1. Definition of Classes</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#class-syntax">5.1.3.1.1. Syntax</a></li>
+<li><a href="classifiers.html#class-properties">5.1.3.1.2. Properties</a></li>
+<li><a href="classifiers.html#class-type-inference">5.1.3.1.3. Type Inference</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#class-semantics">5.1.3.2. Semantics</a></li>
+<li><a href="classifiers.html#_final-modifier">5.1.3.3. Final Modifier</a></li>
+<li><a href="classifiers.html#_abstract-classes">5.1.3.4. Abstract Classes</a></li>
+<li><a href="classifiers.html#_non-instantiable-classes">5.1.3.5. Non-Instantiable Classes</a></li>
+<li><a href="classifiers.html#_superclass">5.1.3.6. Superclass</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_interfaces">5.1.4. Interfaces</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_definition-of-interfaces">5.1.4.1. Definition of Interfaces</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#interfaces-syntax">5.1.4.1.1. Syntax</a></li>
+<li><a href="classifiers.html#interfaces-properties">5.1.4.1.2. Properties</a></li>
+<li><a href="classifiers.html#interfaces-type-inference">5.1.4.1.3. Type Inference</a></li>
+<li><a href="classifiers.html#interfaces-semantics">5.1.4.1.4. Semantics</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="classifiers.html#_generic-classifiers">5.1.5. Generic Classifiers</a></li>
+<li><a href="classifiers.html#sec:definition-site-variance">5.1.6. Definition-Site Variance</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_members">5.2. Members</a>
+<ul class="sectlevel3">
+<li><a href="classifiers.html#_syntax-4">5.2.1. Syntax</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_properties-3">5.2.1.1. Properties</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_semantics-3">5.2.2. Semantics</a></li>
+<li><a href="classifiers.html#_methods">5.2.3. Methods</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_syntax-5">5.2.3.1. Syntax</a></li>
+<li><a href="classifiers.html#_properties-4">5.2.3.2. Properties</a></li>
+<li><a href="classifiers.html#_semantics-4">5.2.3.3. Semantics</a></li>
+<li><a href="classifiers.html#_final-methods">5.2.3.4. Final Methods</a></li>
+<li><a href="classifiers.html#_abstract-methods">5.2.3.5. Abstract Methods</a></li>
+<li><a href="classifiers.html#_generic-methods">5.2.3.6. Generic Methods</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_default-methods-in-interfaces">5.2.4. Default Methods in Interfaces</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_asynchronous-methods">5.2.4.1. Asynchronous Methods</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_constructors">5.2.5. Constructors</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_structural-this-type-in-constructor">5.2.5.1. Structural This Type in Constructor</a></li>
+<li><a href="classifiers.html#spec-constructor">5.2.5.2. @Spec Constructor</a></li>
+<li><a href="classifiers.html#_callable-constructors">5.2.5.3. Callable Constructors</a></li>
+<li><a href="classifiers.html#_covariant-constructors">5.2.5.4. Covariant Constructors</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_data-fields">5.2.6. Data Fields</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#data-fields-syntax">5.2.6.1. Syntax</a></li>
+<li><a href="classifiers.html#data-fields-properties">5.2.6.2. Properties</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#data-fields-semantics">5.2.6.2.1. Semantics</a></li>
+<li><a href="classifiers.html#data-fields-type-inference">5.2.6.2.2. Type Inference</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_assignment-modifiers">5.2.6.3. Assignment Modifiers</a></li>
+<li><a href="classifiers.html#_field-accessors-getter-setter">5.2.6.4. Field Accessors (Getter/Setter)</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#field-acessors-syntax">5.2.6.4.1. Syntax</a></li>
+<li><a href="classifiers.html#field-acessors-properties">5.2.6.4.2. Properties</a></li>
+<li><a href="classifiers.html#field-accessors-semantics">5.2.6.4.3. Semantics</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#optional-fields">5.2.6.5. Optional Fields</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#_syntax-6">5.2.6.5.1. Syntax</a></li>
+<li><a href="classifiers.html#_semantics-5">5.2.6.5.2. Semantics</a></li>
+<li><a href="classifiers.html#_background">5.2.6.5.3. Background</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="classifiers.html#_static-members">5.2.7. Static Members</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_access-from-and-to-static-members">5.2.7.1. Access From and To Static Members</a></li>
+<li><a href="classifiers.html#_generic-static-methods">5.2.7.2. Generic static methods</a></li>
+<li><a href="classifiers.html#_static-members-of-interfaces">5.2.7.3. Static Members of Interfaces</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_redefinition-of-members">5.2.8. Redefinition of Members</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_overriding-of-members">5.2.8.1. Overriding of Members</a></li>
+<li><a href="classifiers.html#_implementation-of-members">5.2.8.2. Implementation of Members</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#_member-consumption">5.2.8.2.1. Member Consumption</a></li>
+<li><a href="classifiers.html#_member-implementation">5.2.8.2.2. Member Implementation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="classifiers.html#_structural-typing">5.3. Structural Typing</a>
+<ul class="sectlevel3">
+<li><a href="classifiers.html#_syntax-7">5.3.1. Syntax</a></li>
+<li><a href="classifiers.html#_definition-site-structural-typing">5.3.2. Definition Site Structural Typing</a></li>
+<li><a href="classifiers.html#_use-site-structural-typing">5.3.3. Use-Site Structural Typing</a></li>
+<li><a href="classifiers.html#structural-readWriteInit-field-typing">5.3.4. Structural Read-only, Write-only and Initializer Field Typing</a></li>
+<li><a href="classifiers.html#_public-setter-annotated-with-code-providesinitializer-code">5.3.5. Public Setter Annotated With <code>ProvidesInitializer</code></a></li>
+<li><a href="classifiers.html#_structural-types-with-optional-fields">5.3.6. Structural Types With Optional Fields</a></li>
+<li><a href="classifiers.html#_structural-types-with-access-modifier">5.3.7. Structural Types With Access Modifier</a></li>
+<li><a href="classifiers.html#_structural-types-with-additional-members">5.3.8. Structural Types With Additional Members</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_syntax-8">5.3.8.1. Syntax</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#_semantics-6">5.3.8.1.1. Semantics</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="functions.html#_functions">6. Functions</a>
+<ul class="sectlevel2">
+<li><a href="functions.html#_function-type">6.1. Function Type</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_properties-5">6.1.1. Properties</a></li>
+<li><a href="functions.html#function-type-inference">6.1.2. Type Inference</a></li>
+<li><a href="functions.html#_autoboxing-of-function-type">6.1.3. Autoboxing of Function Type</a></li>
+<li><a href="functions.html#_arguments-object">6.1.4. Arguments Object</a></li>
+</ul>
+</li>
+<li><a href="functions.html#_ecmascript-5-function-definition">6.2. ECMAScript 5 Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_function-declaration">6.2.1. Function Declaration</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#_syntax-9">6.2.1.1. Syntax</a></li>
+<li><a href="functions.html#_semantics-8">6.2.1.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="functions.html#_function-expression">6.2.2. Function Expression</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#function-expression-syntax">6.2.2.1. Syntax</a></li>
+<li><a href="functions.html#_semantics-and-type-inference">6.2.2.2. Semantics and Type Inference</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="functions.html#_ecmascript-2015-function-definition">6.3. ECMAScript 2015 Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_formal-parameters">6.3.1. Formal Parameters</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#Type_Modifiers_Optional">6.3.1.1. Optional Parameters</a></li>
+<li><a href="functions.html#Type_Modifiers_Default">6.3.1.2. Default Parameters</a></li>
+<li><a href="functions.html#Type_Modifiers_Variadic">6.3.1.3. Variadic</a></li>
+</ul>
+</li>
+<li><a href="functions.html#_generator-functions">6.3.2. Generator Functions</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#generator-functions-syntax">6.3.2.1. Syntax</a></li>
+<li><a href="functions.html#generator-functions-semantics">6.3.2.2. Semantics</a></li>
+<li><a href="functions.html#_generator-arrow-functions">6.3.2.3. Generator Arrow Functions</a></li>
+</ul>
+</li>
+<li><a href="functions.html#_arrow-function-expression">6.3.3. Arrow Function Expression</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#arrow-function-expression-syntax">6.3.3.1. Syntax</a></li>
+<li><a href="functions.html#arrow-function-expression-semantics-and-type-inference">6.3.3.2. Semantics and Type Inference</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="functions.html#_ecmascript-proposals-function-definition">6.4. ECMAScript Proposals Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_asynchronous-functions">6.4.1. Asynchronous Functions</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#asynchronous-functions-syntax">6.4.1.1. Syntax</a></li>
+<li><a href="functions.html#asynchronous-functions-semantics">6.4.1.2. Semantics</a></li>
+<li><a href="functions.html#_asynchronous-arrow-functions">6.4.1.3. Asynchronous Arrow Functions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="functions.html#_n4js-extended-function-definition">6.5. N4JS Extended Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_generic-functions">6.5.1. Generic Functions</a></li>
+<li><a href="functions.html#_promisifiable-functions">6.5.2. Promisifiable Functions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_conversions-and-reflection">7. Conversions and Reflection</a>
+<ul class="sectlevel2">
+<li><a href="conversions_and_reflection.html#_autoboxing-and-coercing">7.1. Autoboxing and Coercing</a>
+<ul class="sectlevel3">
+<li><a href="conversions_and_reflection.html#_coercing">7.1.1. Coercing</a></li>
+<li><a href="conversions_and_reflection.html#_autoboxing-of-primitives">7.1.2. Autoboxing of Primitives</a></li>
+<li><a href="conversions_and_reflection.html#_autoboxing-of-function-expressions-and-declarations">7.1.3. Autoboxing of Function Expressions and Declarations</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_auto-conversion-of-objects">7.2. Auto-Conversion of Objects</a>
+<ul class="sectlevel3">
+<li><a href="conversions_and_reflection.html#_auto-conversion-of-class-instances">7.2.1. Auto-Conversion of Class Instances</a>
+<ul class="sectlevel4">
+<li><a href="conversions_and_reflection.html#_auto-conversion-of-interface-instances">7.2.1.1. Auto-Conversion of Interface Instances</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_auto-conversion-of-enum-literals">7.2.2. Auto-Conversion of Enum Literals</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_type-cast-and-type-check">7.3. Type Cast and Type Check</a>
+<ul class="sectlevel3">
+<li><a href="conversions_and_reflection.html#_type-cast">7.3.1. Type Cast</a></li>
+<li><a href="conversions_and_reflection.html#_type-check">7.3.2. Type Check</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_reflection-meta-information">7.4. Reflection meta-information</a>
+<ul class="sectlevel3">
+<li><a href="conversions_and_reflection.html#_reflection-for-classes">7.4.1. Reflection for Classes</a></li>
+<li><a href="conversions_and_reflection.html#_reflection-for-interfaces">7.4.2. Reflection for Interfaces</a></li>
+<li><a href="conversions_and_reflection.html#_reflection-for-enumerations">7.4.3. Reflection for Enumerations</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_conversion-of-primitive-types">7.5. Conversion of primitive types</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_expressions">8. Expressions</a>
+<ul class="sectlevel2">
+<li><a href="expressions.html#_ecmascript-5-expressions">8.1. ECMAScript 5 Expressions</a>
+<ul class="sectlevel3">
+<li><a href="expressions.html#_the-this-literal">8.1.1. The this Literal</a></li>
+<li><a href="expressions.html#_identifier">8.1.2. Identifier</a></li>
+<li><a href="expressions.html#_literals">8.1.3. Literals</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#_integer-literals">8.1.3.1. Integer Literals</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_array-literal">8.1.4. Array Literal</a></li>
+<li><a href="expressions.html#_object-literal">8.1.5. Object Literal</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#_properties-6">8.1.5.1. Properties</a></li>
+<li><a href="expressions.html#_scoping-and-linking">8.1.5.2. Scoping and linking</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_parenthesized-expression-and-grouping-operator">8.1.6. Parenthesized Expression and Grouping Operator</a></li>
+<li><a href="expressions.html#_property-accessors">8.1.7. Property Accessors</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#properties-1">8.1.7.1. Properties</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_new-expression">8.1.8. New Expression</a></li>
+<li><a href="expressions.html#_function-expression-2">8.1.9. Function Expression</a></li>
+<li><a href="expressions.html#_function-calls">8.1.10. Function Calls</a></li>
+<li><a href="expressions.html#_postfix-expression">8.1.11. Postfix Expression</a></li>
+<li><a href="expressions.html#_unary-expression">8.1.12. Unary Expression</a></li>
+<li><a href="expressions.html#_multiplicative-expression">8.1.13. Multiplicative Expression</a></li>
+<li><a href="expressions.html#_additive-expression">8.1.14. Additive Expression</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#type-inference-10">8.1.14.1. Type Inference</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_bitwise-shift-expression">8.1.15. Bitwise Shift Expression</a></li>
+<li><a href="expressions.html#_relational-expression">8.1.16. Relational Expression</a></li>
+<li><a href="expressions.html#_equality-expression">8.1.17. Equality Expression</a></li>
+<li><a href="expressions.html#_binary-bitwise-expression">8.1.18. Binary Bitwise Expression</a></li>
+<li><a href="expressions.html#_binary-logical-expression">8.1.19. Binary Logical Expression</a></li>
+<li><a href="expressions.html#_conditional-expression">8.1.20. Conditional Expression</a></li>
+<li><a href="expressions.html#_assignment-expression">8.1.21. Assignment Expression</a></li>
+<li><a href="expressions.html#_comma-expression">8.1.22. Comma Expression</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_ecmascript-6-expressions">8.2. ECMAScript 6 Expressions</a>
+<ul class="sectlevel3">
+<li><a href="expressions.html#_the-super-keyword">8.2.1. The super Keyword</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_ecmascript-7-expressions">8.3. ECMAScript 7 Expressions</a>
+<ul class="sectlevel3">
+<li><a href="expressions.html#_await-expression">8.3.1. Await Expression</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_n4js-specific-expressions">8.4. N4JS Specific Expressions</a>
+<ul class="sectlevel3">
+<li><a href="expressions.html#_class-expression">8.4.1. Class Expression</a></li>
+<li><a href="expressions.html#_cast-as-expression">8.4.2. Cast (As) Expression</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#cast-as-expression-semantics-type-inference">8.4.2.1. Semantics and Type Inference</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#Import_Calls">8.4.3. Import Calls</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#compile-time-expressions">8.5. Compile-Time Expressions</a></li>
+</ul>
+</li>
+<li><a href="statements.html#_statements">9. Statements</a>
+<ul class="sectlevel2">
+<li><a href="statements.html#_ecmascript-5-statements">9.1. ECMAScript 5 Statements</a>
+<ul class="sectlevel3">
+<li><a href="statements.html#_function-or-field-accessor-bodies">9.1.1. Function or Field Accessor Bodies</a></li>
+<li><a href="statements.html#_variable-statement">9.1.2. Variable Statement</a></li>
+<li><a href="statements.html#_if-statement">9.1.3. If Statement</a></li>
+<li><a href="statements.html#_iteration-statements">9.1.4. Iteration Statements</a></li>
+<li><a href="statements.html#_return-statement">9.1.5. Return Statement</a></li>
+<li><a href="statements.html#_with-statement">9.1.6. With Statement</a></li>
+<li><a href="statements.html#_switch-statement">9.1.7. Switch Statement</a></li>
+<li><a href="statements.html#_throw-try-and-catch-statements">9.1.8. Throw, Try, and Catch Statements</a></li>
+<li><a href="statements.html#_debugger-statement">9.1.9. Debugger Statement</a></li>
+</ul>
+</li>
+<li><a href="statements.html#_ecmascript-6-statements">9.2. ECMAScript 6 Statements</a>
+<ul class="sectlevel3">
+<li><a href="statements.html#_let">9.2.1. Let</a></li>
+<li><a href="statements.html#_const">9.2.2. Const</a></li>
+<li><a href="statements.html#_for-of-statement">9.2.3. <code>for &#8230;&#8203; of</code> statement</a></li>
+<li><a href="statements.html#_import-statement">9.2.4. Import Statement</a>
+<ul class="sectlevel4">
+<li><a href="statements.html#Dynamic_Imports">9.2.4.1. Dynamic Imports</a></li>
+<li><a href="statements.html#_immutabilaty-of-imports">9.2.4.2. Immutabilaty of Imports</a></li>
+</ul>
+</li>
+<li><a href="statements.html#_export-statement">9.2.5. Export Statement</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="annotations.html#_annotations">10. Annotations</a>
+<ul class="sectlevel2">
+<li><a href="annotations.html#_introduction-2">10.1. Introduction</a>
+<ul class="sectlevel3">
+<li><a href="annotations.html#_syntax-13">10.1.1. Syntax</a></li>
+<li><a href="annotations.html#_properties-7">10.1.2. Properties</a></li>
+<li><a href="annotations.html#_element-specific-annotations">10.1.3. Element-Specific Annotations</a></li>
+<li><a href="annotations.html#_general-annotations">10.1.4. General Annotations</a>
+<ul class="sectlevel4">
+<li><a href="annotations.html#_idebug">10.1.4.1. IDEBUG</a></li>
+</ul>
+</li>
+<li><a href="annotations.html#idebug-syntax">10.1.5. Syntax</a>
+<ul class="sectlevel4">
+<li><a href="annotations.html#_semantics-11">10.1.5.1. Semantics</a></li>
+<li><a href="annotations.html#_suppress-warnings">10.1.5.2. Suppress Warnings</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="annotations.html#_declaration-of-annotations">10.2. Declaration of Annotations</a></li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_extended-fetaures">11. Extended Fetaures</a>
+<ul class="sectlevel2">
+<li><a href="extended_fetaures.html#_array-and-object-destructuring">11.1. Array and Object Destructuring</a>
+<ul class="sectlevel3">
+<li><a href="extended_fetaures.html#_syntax-14">11.1.1. Syntax</a></li>
+<li><a href="extended_fetaures.html#_semantics-12">11.1.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_dependency-injection">11.2. Dependency Injection</a>
+<ul class="sectlevel3">
+<li><a href="extended_fetaures.html#_di-components-and-injectors">11.2.1. DI Components and Injectors</a>
+<ul class="sectlevel4">
+<li><a href="extended_fetaures.html#_dicomponent-relations">11.2.1.1. DIComponent Relations</a></li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_binders-and-bindings">11.2.2. Binders and Bindings</a></li>
+<li><a href="extended_fetaures.html#_injection-points">11.2.3. Injection Points</a>
+<ul class="sectlevel4">
+<li><a href="extended_fetaures.html#_field-injection">11.2.3.1. Field Injection</a></li>
+<li><a href="extended_fetaures.html#_constructor-injection">11.2.3.2. Constructor Injection</a></li>
+<li><a href="extended_fetaures.html#_method-injection">11.2.3.3. Method Injection</a>
+<ul class="sectlevel5">
+<li><a href="extended_fetaures.html#_provider">11.2.3.3.1. Provider</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_n4js-di-life-cycle-and-scopes">11.2.4. N4JS DI Life Cycle and Scopes</a>
+<ul class="sectlevel4">
+<li><a href="extended_fetaures.html#_injection-cylces">11.2.4.1. Injection Cylces</a></li>
+<li><a href="extended_fetaures.html#_default-scope">11.2.4.2. Default Scope</a></li>
+<li><a href="extended_fetaures.html#_singleton-scope">11.2.4.3. Singleton Scope</a></li>
+<li><a href="extended_fetaures.html#_per-injection-chain-singleton">11.2.4.4. Per Injection Chain Singleton</a></li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_validation-of-callsites-targeting-n4injector-methods">11.2.5. Validation of callsites targeting N4Injector methods</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-annotations">11.2.6. N4JS DI Annotations</a>
+<ul class="sectlevel4">
+<li><a href="extended_fetaures.html#_n4js-di-generateinjector">11.2.6.1. N4JS DI @GenerateInjector</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-withparentinjector">11.2.6.2. N4JS DI @WithParentInjector</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-usebinder">11.2.6.3. N4JS DI @UseBinder</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-binder">11.2.6.4. N4JS DI @Binder</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-bind">11.2.6.5. N4JS DI @Bind</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-provides">11.2.6.6. N4JS DI @Provides</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-inject">11.2.6.7. N4JS DI @Inject</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-singleton">11.2.6.8. N4JS DI @Singleton</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_test-support">11.3. Test Support</a></li>
+<li><a href="extended_fetaures.html#_polyfill-definitions">11.4. Polyfill Definitions</a>
+<ul class="sectlevel3">
+<li><a href="extended_fetaures.html#_runtime-polyfill-definitions">11.4.1. Runtime Polyfill Definitions</a></li>
+<li><a href="extended_fetaures.html#_static-polyfill-definitions">11.4.2. Static Polyfill Definitions</a></li>
+<li><a href="extended_fetaures.html#_transpiling-static-polyfilled-classes">11.4.3. Transpiling static polyfilled classes</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="components.html#_components">12. Components</a>
+<ul class="sectlevel2">
+<li><a href="components.html#_overview-2">12.1. Overview</a></li>
+<li><a href="components.html#Component_Types">12.2. Component Types</a>
+<ul class="sectlevel3">
+<li><a href="components.html#_libraries">12.2.1. Libraries</a></li>
+<li><a href="components.html#_runtime-environment-and-runtime-libraries">12.2.2. Runtime Environment and Runtime Libraries</a></li>
+<li><a href="components.html#_tests">12.2.3. Tests</a></li>
+<li><a href="components.html#_type-definitions">12.2.4. Type Definitions</a></li>
+</ul>
+</li>
+<li><a href="components.html#package-json">12.3. Package.json File</a>
+<ul class="sectlevel3">
+<li><a href="components.html#_basic-properties">12.3.1. Basic Properties</a></li>
+<li><a href="components.html#_n4js-properties">12.3.2. N4JS Properties</a></li>
+<li><a href="components.html#_constraints">12.3.3. Constraints</a></li>
+</ul>
+</li>
+<li><a href="components.html#_support-for-npm-scopes">12.4. Support for NPM Scopes</a></li>
+<li><a href="components.html#sec:N4JS-Type-Definitions">12.5. N4JS Type Definitions</a>
+<ul class="sectlevel3">
+<li><a href="components.html#_specify-type-definition">12.5.1. Specify Type Definition</a></li>
+<li><a href="components.html#_name-conventions">12.5.2. Name Conventions</a></li>
+<li><a href="components.html#_version-conventions">12.5.3. Version Conventions</a>
+<ul class="sectlevel4">
+<li><a href="components.html#_define-a-new-type-definition-package">12.5.3.1. Define a New Type Definition Package</a></li>
+<li><a href="components.html#_using-a-type-definition-package">12.5.3.2. Using a Type Definition Package</a></li>
+<li><a href="components.html#_rational">12.5.3.3. Rational</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="components.html#_modules">12.6. Modules</a></li>
+<li><a href="components.html#_api-and-implementation-component">12.7. API and Implementation Component</a>
+<ul class="sectlevel3">
+<li><a href="components.html#_execution-of-api-and-implementation-components">12.7.1. Execution of API and Implementation Components</a></li>
+<li><a href="components.html#_api-and-implementation-with-di">12.7.2. API and Implementation With DI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="plainjs.html#_plainjs">13. PlainJS</a>
+<ul class="sectlevel2">
+<li><a href="plainjs.html#_type-inference-and-validation-for-plain-js">13.1. Type Inference and Validation for Plain JS</a></li>
+<li><a href="plainjs.html#_external-declarations">13.2. External Declarations</a>
+<ul class="sectlevel3">
+<li><a href="plainjs.html#_declaring-externals">13.2.1. Declaring externals</a></li>
+<li><a href="plainjs.html#_instantiating-external-classes">13.2.2. Instantiating external classes</a></li>
+<li><a href="plainjs.html#_implementation-of-external-declarations">13.2.3. Implementation of External Declarations</a></li>
+<li><a href="plainjs.html#_example">13.2.4. Example</a></li>
+</ul>
+</li>
+<li><a href="plainjs.html#_global-definitions">13.3. Global Definitions</a></li>
+<li><a href="plainjs.html#_runtime-definitions">13.4. Runtime Definitions</a></li>
+<li><a href="plainjs.html#_applying-polyfills">13.5. Applying Polyfills</a></li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_jsdoc-2">14. JSDoc</a>
+<ul class="sectlevel2">
+<li><a href="jsdoc.html#_general-n4jsdoc-features">14.1. General N4JSDoc Features</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#_provided-inline-tags">14.1.1. Provided Inline Tags</a>
+<ul class="sectlevel4">
+<li><a href="jsdoc.html#jsdoc_tag__code">14.1.1.1. @code</a></li>
+<li><a href="jsdoc.html#jsdoc_tag__link">14.1.1.2. @link</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_n4jsdoc-for-user-projects">14.2. N4JSdoc for User Projects</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#_standard-tags">14.2.1. Standard Tags</a>
+<ul class="sectlevel4">
+<li><a href="jsdoc.html#_-author">14.2.1.1. @author</a></li>
+<li><a href="jsdoc.html#jsdoc_tag_param">14.2.1.2. @param</a></li>
+<li><a href="jsdoc.html#jsdoc_tag_return">14.2.1.3. @return</a></li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_test-related-tags">14.2.2. Test Related Tags</a>
+<ul class="sectlevel4">
+<li><a href="jsdoc.html#jsdoc_tag__testee">14.2.2.1. @testee</a></li>
+<li><a href="jsdoc.html#jsdoc_tag__testeeFromType">14.2.2.2. @testeeFromType</a></li>
+<li><a href="jsdoc.html#_testeeType_and__testeeMember">14.2.2.3. @testeeType and @testeeMember</a></li>
+<li><a href="jsdoc.html#jsdoc_tag_reqid_in_Tests">14.2.2.4. @reqid in Tests</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_n4jsdoc-for-api-and-implementation-projects">14.3. N4JSDoc for API and Implementation Projects</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#jsdoc_tag__apiNote">14.3.1. @apiNote</a></li>
+<li><a href="jsdoc.html#API_Project_Tags">14.3.2. API Project Tags</a>
+<ul class="sectlevel4">
+<li><a href="jsdoc.html#jsdoc_tag_apiState">14.3.2.1. @apiState</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsx.html#_jsx">15. JSX</a>
+<ul class="sectlevel2">
+<li><a href="jsx.html#_jsx-support">15.1. JSX Support</a></li>
+<li><a href="jsx.html#_jsx-backend">15.2. JSX Backend</a></li>
+</ul>
+</li>
+<li><a href="grammars.html#_grammars">16. Grammars</a>
+<ul class="sectlevel2">
+<li><a href="grammars.html#_type-expressions-grammar">16.1. Type Expressions Grammar</a></li>
+<li><a href="grammars.html#_n4js-language-grammar">16.2. N4JS Language Grammar</a></li>
+</ul>
+</li>
+<li><a href="jsobjects.html#_jsobjects">17. JSObjects</a>
+<ul class="sectlevel2">
+<li><a href="jsobjects.html#_object">17.1. Object</a></li>
+<li><a href="jsobjects.html#_string">17.2. String</a></li>
+<li><a href="jsobjects.html#_boolean">17.3. Boolean</a></li>
+<li><a href="jsobjects.html#_number">17.4. Number</a>
+<ul class="sectlevel3">
+<li><a href="jsobjects.html#_static-attributes">17.4.1. Static Attributes</a></li>
+</ul>
+</li>
+<li><a href="jsobjects.html#function">17.5. Function</a></li>
+<li><a href="jsobjects.html#_error">17.6. Error</a></li>
+<li><a href="jsobjects.html#_array">17.7. Array</a></li>
+<li><a href="jsobjects.html#_date">17.8. Date</a></li>
+<li><a href="jsobjects.html#_math">17.9. Math</a>
+<ul class="sectlevel3">
+<li><a href="jsobjects.html#static-attributes-1">17.9.1. Static Attributes</a></li>
+</ul>
+</li>
+<li><a href="jsobjects.html#_regexp">17.10. RegExp</a></li>
+<li><a href="jsobjects.html#_json">17.11. JSON</a></li>
+</ul>
+</li>
+<li><a href="n4js_objects.html#_n4js-objects">18. N4JS Objects</a>
+<ul class="sectlevel2">
+<li><a href="n4js_objects.html#_reflection-model">18.1. Reflection Model</a></li>
+<li><a href="n4js_objects.html#_error-types">18.2. Error Types</a>
+<ul class="sectlevel3">
+<li><a href="n4js_objects.html#_n4apinotimplemented">18.2.1. N4ApiNotImplemented</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_acronyms.html#_acronyms">Appendix A: Acronyms</a></li>
+<li><a href="appendix_b_license.html#sec:License">Appendix B: License</a></li>
+<li><a href="#_bibliography">Appendix C: Bibliography</a></li>
+</ul>
+</div>
+</div>
+<div id="content"><div class="sect1">
+<h2 id="_bibliography"><a class="anchor" href="#_bibliography"></a><a class="link" href="#_bibliography">Appendix C: Bibliography</a></h2>
+<div class="sectionbody">
+<div class="openblock bibliography">
+<div class="content">
+<div class="paragraph">
+<p><a id="ECMA15a"></a>ECMA. (2015). <em>ECMAScript 2015 Language Specification</em>. Retrieved from <a href="http://www.ecma-international.org/ecma-262/6.0/index.html" class="bare">http://www.ecma-international.org/ecma-262/6.0/index.html</a></p>
+</div>
+<div class="paragraph">
+<p><a id="ECMA11a"></a>(2011). <em>ECMAScript Language Specification</em>. Retrieved from <a href="http://www.ecma-international.org/publications/standards/Ecma-262.htm" class="bare">http://www.ecma-international.org/publications/standards/Ecma-262.htm</a></p>
+</div>
+<div class="paragraph">
+<p><a id="Pierce02a"></a>Pierce, Benjamin C.. (2002). <em>Types and Programming Languages</em>. </p>
+</div>
+<div class="paragraph">
+<p><a id="Gosling15a"></a>Gosling, James and Joy, Bill and Steele, Guy and Bracha, Gilad and Buckley, Alex. (2015). <em>The Java Language Specification. Java SE 8 Edition</em>. Retrieved from <a href="http://docs.oracle.com/javase/specs/jls/se8/jls8.pdf" class="bare">http://docs.oracle.com/javase/specs/jls/se8/jls8.pdf</a></p>
+</div>
+<div class="paragraph">
+<p><a id="Gosling12a"></a>Gosling, James and Joy, Bill and Steele, Guy and Bracha, Gilad and Buckley, Alex. (2012). <em>The Java Language Specification. Java SE 7 Edition</em>. Retrieved from <a href="http://docs.oracle.com/javase/specs/jls/se7/jls7.pdf" class="bare">http://docs.oracle.com/javase/specs/jls/se7/jls7.pdf</a></p>
+</div>
+<div class="paragraph">
+<p><a id="Nielson99a"></a>Nielson, Flemming and Nielson, HanneRiis. (1999). <em>Type and Effect Systems</em>. Retrieved from <a href="http://dx.doi.org/10.1007/3-540-48092-7_6" class="bare">http://dx.doi.org/10.1007/3-540-48092-7_6</a></p>
+</div>
+<div class="paragraph">
+<p><a id="Crary02a"></a>Crary, Karl and Weirich, Stephanie and Morrisett, Greg. (2002). <em>Intensional polymorphism in type-erasure semantics</em>. Retrieved from <a href="http://journals.cambridge.org/article_S0956796801004282" class="bare">http://journals.cambridge.org/article_S0956796801004282</a></p>
+</div>
+<div class="paragraph">
+<p><a id="Igarashi01a"></a>Igarashi, Atsushi and Pierce, Benjamin C. and Wadler, Philip. (2001). <em>Featherweight Java: a minimal core calculus for Java and GJ</em>. </p>
+</div>
+<div class="paragraph">
+<p><a id="Torgersen05a"></a>Torgersen, Mads and Ernst, Erik and Hansen, Christian Plesner. (2005). <em>Wild FJ</em>. Retrieved from <a href="http://homepages.inf.ed.ac.uk/wadler/fool/program/14.html" class="bare">http://homepages.inf.ed.ac.uk/wadler/fool/program/14.html</a></p>
+</div>
+<div class="paragraph">
+<p><a id="Cameron08b"></a>Cameron, Nicholas and Drossopoulou, Sophia and Ernst, Erik. (2008). <em>A Model for Java with Wildcards</em>. Retrieved from <a href="http://dx.doi.org/10.1007/978-3-540-70592-5_2" class="bare">http://dx.doi.org/10.1007/978-3-540-70592-5_2</a></p>
+</div>
+<div class="paragraph">
+<p><a id="Cameron09a"></a>Cameron, Nicholas. (2009). <em>Existential Types for Variance&#8201;&#8212;&#8201;Java Wildcards and Ownership Types</em>. Retrieved from <a href="http://www.doc.ic.ac.uk/~ncameron/papers/cameron_thesis.pdf" class="bare">http://www.doc.ic.ac.uk/~ncameron/papers/cameron_thesis.pdf</a></p>
+</div>
+<div class="paragraph">
+<p><a id="Summers10a"></a>Summers, Alexander J. and Cameron, Nicholas and Dezani-Ciancaglini, Mariangiola and Drossopoulou, Sophia. (2010). <em>Towards a semantic model for Java wildcards</em>. </p>
+</div>
+<div class="paragraph">
+<p><a id="Wehr08a"></a>Wehr, Stefan and Thiemann, Peter. (2008). <em>Subtyping Existential Types</em>. Retrieved from <a href="http://www.informatik.uni-freiburg.de/~wehr/publications/Wehr_Subtyping_existential_types.pdf" class="bare">http://www.informatik.uni-freiburg.de/~wehr/publications/Wehr_Subtyping_existential_types.pdf</a></p>
+</div>
+<div class="paragraph">
+<p><a id="Igarashi07a"></a>Igarashi, Atsushi and Nagira, Hideshi. (2007). <em>Union Types for Object-Oriented Programming</em>. Retrieved from <a href="http://www.jot.fm/issues/issue_2007_02/article3/" class="bare">http://www.jot.fm/issues/issue_2007_02/article3/</a></p>
+</div>
+<div class="paragraph">
+<p><a id="King13a"></a>King, Gavin. (2013). <em>The Ceylon Language</em>. Red Hat, Inc.. Retrieved from <a href="http://ceylon-lang.org/documentation/1.0/spec/pdf/ceylon-language-specification.pdf" class="bare">http://ceylon-lang.org/documentation/1.0/spec/pdf/ceylon-language-specification.pdf</a></p>
+</div>
+<div class="paragraph">
+<p><a id="Laurent12a"></a>Laurent, Olivier. (2012). <em>Intersection types with subtyping by means of cut elimination</em>. </p>
+</div>
+<div class="paragraph">
+<p><a id="W3C:Steen:14:XL"></a>Steen, Hallvord and Aubourg, Julian and van Kesteren, Anne and Song, Jungkee. (2014). <em>XMLHttpRequest Level 1</em>. </p>
+</div>
+<div class="paragraph">
+<p><a id="Dart13a"></a>Dart Team. (2013). <em>Dart Programming Language Specification</em>. Retrieved from <a href="http://www.dartlang.org/docs/spec/latest/dart-language-specification.pdf" class="bare">http://www.dartlang.org/docs/spec/latest/dart-language-specification.pdf</a></p>
+</div>
+<div class="paragraph">
+<p><a id="OMG14a"></a>OMG. (2014). <em>Interface Definition Language</em>. Object Management Group. Retrieved from <a href="http://www.omg.org/cgi-bin/doc?formal/2014-03-01.pdf" class="bare">http://www.omg.org/cgi-bin/doc?formal/2014-03-01.pdf</a></p>
+</div>
+<div class="paragraph">
+<p><a id="W3C12a"></a>W3C. (2012). <em>Web IDL Specification</em>. Retrieved from <a href="http://www.w3.org/TR/2012/CR-WebIDL-20120419/" class="bare">http://www.w3.org/TR/2012/CR-WebIDL-20120419/</a></p>
+</div>
+<div class="paragraph">
+<p><a id="Kuizinas14a"></a>Kuizinas, Gajus. (2014). <em>The Definitive Guide to the JavaScript Generators</em>. Retrieved from <a href="http://gajus.com/blog/2/the-definetive-guide-to-the-javascript-generators" class="bare">http://gajus.com/blog/2/the-definetive-guide-to-the-javascript-generators</a></p>
+</div>
+<div class="paragraph">
+<p><a id="West06a"></a>West, Mike. (2006). <em>Scope in JavaScript</em>. Retrieved from <a href="http://www.digital-web.com/articles/scope_in_javascript/" class="bare">http://www.digital-web.com/articles/scope_in_javascript/</a></p>
+</div>
+<div class="paragraph">
+<p><a id="ECMA18a"></a>ECMA. (2018). <em>ECMAScript 2018 Language Specification</em>. Retrieved from <a href="http://www.ecma-international.org/ecma-262/9.0/index.html" class="bare">http://www.ecma-international.org/ecma-262/9.0/index.html</a></p>
+</div>
+<div class="paragraph">
+<p><a id="MozillaJSRef"></a><em>JavaScript Reference</em>. Retrieved from <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference" class="bare">https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference</a></p>
+</div>
+<div class="paragraph">
+<p><a id="Fowler04b"></a>Fowler, Martin. (2004). <em>Inversion of Control Containers and the Dependency Injection pattern</em>. Retrieved from <a href="http://martinfowler.com/articles/injection.html" class="bare">http://martinfowler.com/articles/injection.html</a></p>
+</div>
+<div class="paragraph">
+<p><a id="Prasanna09a"></a>Prasanna, Dhanji R. (2009). <em>Dependency Injection: Design Patterns Using Spring and Guice</em>. </p>
+</div>
+<div class="paragraph">
+<p><a id="Zhu13a"></a>Zhu, He and Jagannathan, Suresh. (2013). <em>Compositional and Lightweight Dependent Type Inference for ML</em>. Retrieved from <a href="http://dx.doi.org/10.1007/978-3-642-35873-9_19" class="bare">http://dx.doi.org/10.1007/978-3-642-35873-9_19</a></p>
+</div>
+<div class="paragraph">
+<p><a id="Hudli13a"></a>Hudli, Shrinidhi R. and Hudli, Raghu V.. (2013). <em>A Verification Strategy for Dependency Injection</em>. </p>
+</div>
+<div class="paragraph">
+<p><a id="Lesiecki08a"></a>Lesiecki, Nicholas. (2008). <em>Dependency injection with Guice</em>. Retrieved from <a href="http://www.ibm.com/developerworks/library/j-guice/" class="bare">http://www.ibm.com/developerworks/library/j-guice/</a></p>
+</div>
+<div class="paragraph">
+<p><a id="Betts13a"></a>Betts, Dominic and Melnik, Grigori and Simonazzi, Fernando and Subramanian, Mani. (2013). <em>Dependency Injection with Unity</em>. </p>
+</div>
+<div class="paragraph">
+<p><a id="Knol13a"></a>Knol, Alex. (2013). <em>Dependency injection with AngularJS</em>. </p>
+</div>
+<div class="paragraph">
+<p><a id="Dagger"></a><em>Dagger, Project Website</em>. Retrieved from <a href="http://square.github.io/dagger/" class="bare">http://square.github.io/dagger/</a></p>
+</div>
+<div class="paragraph">
+<p><a id="ECMA12a"></a>(2012). <em>ECMAScript Internationalization API Specification</em>. Retrieved from <a href="http://www.ecma-international.org/publications/standards/Ecma-402.htm" class="bare">http://www.ecma-international.org/publications/standards/Ecma-402.htm</a></p>
+</div>
+<div class="paragraph">
+<p><a id="Martin96b"></a>Martin, Robert C. (1996). <em>The Liskov Substitution Principle</em>. Retrieved from <a href="http://www.objectmentor.com/publications/lsp.pdf" class="bare">http://www.objectmentor.com/publications/lsp.pdf</a></p>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div id="footnotes">
+<hr>
+<div class="footnote" id="_footnote_1">
+<a href="annotations.html#_footnoteref_1">1</a>. A brief introduction can be found at <a href="http://www.cs.cornell.edu/~ross/publications/mixedsite/tutorial.html" class="bare">http://www.cs.cornell.edu/~ross/publications/mixedsite/tutorial.html</a>. In general, we refer the reader to [<a href="#Pierce02a">Pierce02a</a>]
+</div>
+<div class="footnote" id="_footnote_2">
+<a href="introduction.html#_footnoteref_2">2</a>. One can interpret this similar to delegate methods, that is, instead of writing <code class="language-n4js">r.binding().getType()</code>, a method <code class="language-n4js">r.getType()\{return binding().getType();</code> is defined.
+</div>
+<div class="footnote" id="_footnote_3">
+<a href="grammar.html#_footnoteref_3">3</a>. <a href="http://javascript.crockford.com/code.html" class="bare">http://javascript.crockford.com/code.html</a>
+</div>
+<div class="footnote" id="_footnote_4">
+<a href="names.html#_footnoteref_4">4</a>. See for definitions of metatype properties.
+</div>
+<div class="footnote" id="_footnote_5">
+<a href="names.html#_footnoteref_5">5</a>. That is, for application developers not providing a library or a public API available to other vendors, member access modifiers behave almost similar to modifiers known from Java.
+</div>
+<div class="footnote" id="_footnote_6">
+<a href="names.html#_footnoteref_6">6</a>. See <a href="classifiers.html#_n4js-specific-classifiers">N4JS Specific Classifiers</a> for definitions of metatype properties. Note that <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>r</mi><mo>.</mo><mi>r</mi><mi>e</mi><mi>c</mi><mi>e</mi><mi>i</mi><mi>v</mi><mi>e</mi><mi>r</mi></math> always refers to a type declaration in the context of an expression as the receiver type of <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>r</mi></math>. The declaring type of the member declaration is considered to be the receiver type of the member reference rather than the type that originally declares the member declaration.
+</div>
+<div class="footnote" id="_footnote_7">
+<a href="names.html#_footnoteref_7">7</a>. Note the Java-like access restriction for members of visibility <code class="language-n4js">protected</code> or <code class="language-n4js">protected@Internal</code> to code that is responsible for the implementation of that object. [<a href="#Gosling15a">Gosling15a(p.S6.6.2, p.p.166)</a>]
+</div>
+<div class="footnote" id="_footnote_8">
+<a href="names.html#_footnoteref_8">8</a>. <code class="language-n4js">string, boolean, number, any, null</code>
+</div>
+<div class="footnote" id="_footnote_9">
+<a href="names.html#_footnoteref_9">9</a>. This conflicts with the implicit parameter arguments introduced by the transpiler when wrapping the script/module into a definition function.
+</div>
+<div class="footnote" id="_footnote_10">
+<a href="types.html#_footnoteref_10">10</a>. In the N4JS IDE, type annotations are highlighted differently than ordinary code.
+</div>
+<div class="footnote" id="_footnote_11">
+<a href="types.html#_footnoteref_11">11</a>. The notation <math xmlns="http://www.w3.org/1998/Math/MathML"><mo>|</mo><mi>T</mi><mo>|</mo></math> used in [<a href="#Gosling12a">Gosling12a</a>] conflicts with the notation of cardinality of sets, which we use in case of union or intersection types for types as well. The notation used here is inspired by [<a href="#Crary02a">Crary02a</a>], in which a mapping is defined between a typed language <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>λ</mi></math> to an untyped language <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>λ</mi></math><sup>o</sup>.
+</div>
+<div class="footnote" id="_footnote_12">
+<a href="types.html#_footnoteref_12">12</a>. Although raw type usage is prohibited, the N4JS validator interprets raw types according to the first case, which may lead to consequential errors.
+</div>
+<div class="footnote" id="_footnote_13">
+<a href="types.html#_footnoteref_13">13</a>. in the Java 8 spec and compiler, they are called type variables, which are types as well
+</div>
+<div class="footnote" id="_footnote_14">
+<a href="types.html#_footnoteref_14">14</a>. The rationale for having this limited implementation of type is that API designers already want to start providing hints where later only 32-bit integers will be used. For the time being, <strong>this is checked neither statically nor at runtime</strong>!
+</div>
+<div class="footnote" id="_footnote_15">
+<a href="types.html#_footnoteref_15">15</a>. This is a consequence of the syntax definition.
+</div>
+<div class="footnote" id="_footnote_16">
+<a href="types.html#_footnoteref_16">16</a>. For type theory about union types, [<a href="#Pierce02a">Pierce02a(p.15.7)</a>] and [<a href="#Igarashi07a">Igarashi07a</a>], other languages that explicitly support the notion of union type include Ceylon [<a href="#King13a">King13a(p.3.2.4/5)</a>]
+</div>
+<div class="footnote" id="_footnote_17">
+<a href="types.html#_footnoteref_17">17</a>. This is different from Ceylon ( [<a href="#King13a">King13a(p.3.2.3)</a>]), in which the union is defined to be <code>the same type as</code> <em>A</em>. Although the meaning of <code>same</code> is not clear, it is possibly used as a synonym for <code>equivalent</code>.
+</div>
+<div class="footnote" id="_footnote_18">
+<a href="types.html#_footnoteref_18">18</a>. See Example <a href="types.html#ex:class-hierarchy">Type Examples, Class Hierarchy</a> for class definitions.
+</div>
+<div class="footnote" id="_footnote_19">
+<a href="types.html#_footnoteref_19">19</a>. For type theory about intersection types, see [<a href="#Pierce02a">Pierce02a(p.15.7)</a>] and [<a href="#Laurent12a">Laurent12a</a>], other languages supporting explicit notion of intersection type include Ceylon [<a href="#King13a">King13a(p.3.2.4/5)</a>].
+</div>
+<div class="footnote" id="_footnote_20">
+<a href="types.html#_footnoteref_20">20</a>. This rule is a generalization of the subtyping rules given in [<a href="#Laurent12a">Laurent12a</a>] Table 2, <math xmlns="http://www.w3.org/1998/Math/MathML"><msubsup><mo>∩</mo><mi>l</mi><mn>1</mn></msubsup></math> and <math xmlns="http://www.w3.org/1998/Math/MathML"><msubsup><mo>∩</mo><mi>l</mi><mn>2</mn></msubsup></math>
+</div>
+<div class="footnote" id="_footnote_21">
+<a href="types.html#_footnoteref_21">21</a>. This rule is a generalization of the subtyping rules given in [<a href="#Laurent12a">Laurent12a</a>] Table 2, <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mo>∩</mo><mi>r</mi></msub></math>
+</div>
+<div class="footnote" id="_footnote_22">
+<a href="types.html#_footnoteref_22">22</a>. In Ceylon, for a given union type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>U</mi><mo>=</mo><msub><mi>T</mi><mn>1</mn></msub><mo>|</mo><msub><mi>T</mi><mn>2</mn></msub></math> and intersection type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>I</mi><mo>=</mo><msub><mi>T</mi><mn>1</mn></msub><mi>&amp;</mi><msub><mi>T</mi><mn>2</mn></msub></math> (with ’|’ is union and ’&amp;’ is intersection), <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>T</mi><mn>1</mn></msub><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>U</mi></math> and <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>T</mi><mn>2</mn></msub><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>U</mi></math> is true, and <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>T</mi><mn>1</mn></msub><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>I</mi></math> and <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>T</mi><mn>2</mn></msub><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>I</mi></math> is true. We should define that as well (if it is not already defined). Cf [<a href="#King13a">King13a(p.3.2.4/5)</a>]
+</div>
+<div class="footnote" id="_footnote_23">
+<a href="types.html#_footnoteref_23">23</a>. See Example <a href="types.html#ex:class-hierarchy">Type Examples, Class Hierarchy</a> for class definitions.
+</div>
+<div class="footnote" id="_footnote_24">
+<a href="types.html#_footnoteref_24">24</a>. see "Covariance and contravariance with unions and intersections" at <a href="http://ceylon-lang.org/documentation/1.1/tour/generics/" class="bare">http://ceylon-lang.org/documentation/1.1/tour/generics/</a>
+</div>
+<div class="footnote" id="_footnote_25">
+<a href="types.html#_footnoteref_25">25</a>. The classifier type is, in fact, the <code>type type</code> or <code>metatype</code> of a type. We use the term classifier type in the specification to avoid the bogus <code>type type</code> terminology.
+</div>
+<div class="footnote" id="_footnote_26">
+<a href="types.html#_footnoteref_26">26</a>. The phenomenon is described in IDEBUG-263
+</div>
+<div class="footnote" id="_footnote_27">
+<a href="classifiers.html#_footnoteref_27">27</a>. E.g., for given <code class="language-n4js">class A{ foo(A):A{}} class B{ foo(B):B{}}</code>, a class C could be defined as <code class="language-n4js">class C{ foo(union{A,B}):intersection{A,B}{}}</code>. In this case it would then be a syntactical problem (and even worse - a conceptual problem) of how to call the super methods defined in A and Bfrom C.
+</div>
+<div class="footnote" id="_footnote_28">
+<a href="classifiers.html#_footnoteref_28">28</a>. <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>a</mi><mi>c</mi><mi>c</mi><mi>e</mi><mi>s</mi><mi>s</mi><mi>o</mi><mi>r</mi><mi>P</mi><mi>a</mi><mi>i</mi><mi>r</mi><mfenced close=")" open="("><msub><mi>m</mi><mn>1</mn></msub><msub><mi>m</mi><mn>2</mn></msub></mfenced></math> is defined as follows: <math xmlns="http://www.w3.org/1998/Math/MathML"><mfenced close=")" open="("><mrow><mi>μ</mi><mfenced close=")" open="("><msub><mi>m</mi><mn>1</mn></msub></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>getter</mtext></mstyle><mo>∧</mo><mi>μ</mi><mfenced close=")" open="("><msub><mi>m</mi><mn>2</mn></msub></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>setter</mtext></mstyle></mrow></mfenced><mo>∨</mo><mfenced close=")" open="("><mrow><mi>μ</mi><mfenced close=")" open="("><msub><mi>m</mi><mn>1</mn></msub></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>setter</mtext></mstyle><mo>∧</mo><mi>μ</mi><mfenced close=")" open="("><msub><mi>m</mi><mn>2</mn></msub></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>getter</mtext></mstyle></mrow></mfenced></math>
+</div>
+<div class="footnote" id="_footnote_29">
+<a href="classifiers.html#_footnoteref_29">29</a>. not yet implemented
+</div>
+<div class="footnote" id="_footnote_30">
+<a href="classifiers.html#_footnoteref_30">30</a>. In order to emulate method overloading, union types are to be used.
+</div>
+<div class="footnote" id="_footnote_31">
+<a href="classifiers.html#_footnoteref_31">31</a>. [<a href="#ECMA15a">ECMA15a(p.p214)</a>], <code>ClassBody : ClassElementList</code> indicates that it is possible to have the same name for instance and static members.
+</div>
+<div class="footnote" id="_footnote_32">
+<a href="classifiers.html#_footnoteref_32">32</a>. version 4.0
+</div>
+<div class="footnote" id="_footnote_33">
+<a href="classifiers.html#_footnoteref_33">33</a>. This cannot be done w/o <code>null</code>/<code>undefined</code> analysis
+</div>
+<div class="footnote" id="_footnote_34">
+<a href="classifiers.html#_footnoteref_34">34</a>. This is required, because in Javascript a getter shadows a corresponding setter defined further up in the prototype chain; likewise a setter shadows a corresponding getter.
+</div>
+<div class="footnote" id="_footnote_35">
+<a href="classifiers.html#_footnoteref_35">35</a>. Thus, the type of one accessor is not used to infer the type of the other one. E.g., from <code>set x(string s)</code>, we cannot infer <code>get x()</code> to return <code>string</code> — instead, the getter is inferred to return <code>any</code>.
+</div>
+<div class="footnote" id="_footnote_36">
+<a href="classifiers.html#_footnoteref_36">36</a>. The technical reason for this rule is the way properties are stored in JavaScript. Take for an example subclass-write access : <code class="language-n4js">class C { static f="a";}</code> with <code class="language-n4js">class D extends C { }</code>. Now the data field <code>f</code> on <code>C</code> can also be queried using <code>D</code> (<code class="language-n4js">var q=D.f;</code>) but writing (<code class="language-n4js">D.f="b";</code>) would introduce a newly created property <code>f</code> on class <code>D</code>, which differs from the one defined on <code>C</code>. It would do this without explicitly overriding the inherited property. Subsequent reads to <code class="language-n4js">D.f</code> would route to this ’accidentally’ introduced property. Such a behavior would not be expected and therefore has been disallowed. Note that this write restriction applies to data-fields and to field setters.
+</div>
+<div class="footnote" id="_footnote_37">
+<a href="classifiers.html#_footnoteref_37">37</a>. There had been the idea of preventing static members of being consumed. However, this would break the type subtype relation.
+</div>
+<div class="footnote" id="_footnote_38">
+<a href="classifiers.html#_footnoteref_38">38</a>. <code>C</code> could either be a class or an interface.
+</div>
+<div class="footnote" id="_footnote_39">
+<a href="classifiers.html#_footnoteref_39">39</a>. As defined in <a href="functions.html#_function-type">Function Type</a> for function types.
+</div>
+<div class="footnote" id="_footnote_40">
+<a href="classifiers.html#_footnoteref_40">40</a>. This kind of typing is used by TypeScript only. By defining a structural typed classifier or reference, it basically behaves as it would behave – without that modifier – in TypeScript.
+</div>
+<div class="footnote" id="_footnote_41">
+<a href="classifiers.html#_footnoteref_41">41</a>. We enforce programmers of N4JS to use nominal typing, therefore, it is not possible to bypass that principle by declaring a type as structural for normally defined classes (except those explicitly derived from <code>N4Object</code>).
+</div>
+<div class="footnote" id="_footnote_42">
+<a href="classifiers.html#_footnoteref_42">42</a>. Since this is already prevented by the parser (the tilde is interpreted as an unary operator), error messages are likely to look a little strange.
+</div>
+<div class="footnote" id="_footnote_43">
+<a href="classifiers.html#_footnoteref_43">43</a>. Note that due to this relaxed definition (compared with definition-site structural types) it is possible to pass an <code>N4Object</code> instance to a function of method with a declared structural type parameter.
+</div>
+<div class="footnote" id="_footnote_44">
+<a href="classifiers.html#_footnoteref_44">44</a>. This is already constrained by the grammar.
+</div>
+<div class="footnote" id="_footnote_45">
+<a href="functions.html#_footnoteref_45">45</a>. see <a href="http://tc39.github.io/ecmascript-asyncawait/" class="bare">http://tc39.github.io/ecmascript-asyncawait/</a>
+</div>
+<div class="footnote" id="_footnote_46">
+<a href="functions.html#_footnoteref_46">46</a>. Even in this case, the function will actually be called with the callback method which is then created by the transpiler. However, the callback is not given in the N4JS code).
+</div>
+<div class="footnote" id="_footnote_47">
+<a href="conversions_and_reflection.html#_footnoteref_47">47</a>. <code>i</code> iterates over all boundaries
+</div>
+<div class="footnote" id="_footnote_48">
+<a href="conversions_and_reflection.html#_footnoteref_48">48</a>. <code>i</code> iterates over all type args
+</div>
+<div class="footnote" id="_footnote_49">
+<a href="expressions.html#_footnoteref_49">49</a>. Only <code class="language-n4js">Function</code> implements the ECMAScript specification property <code class="language-n4js">hasInstance</code>. Thus instanceof expressions are rewritten by the compiler for other types. Note that a reference to a class returns the constructor type, which actually is a function itself.
+</div>
+<div class="footnote" id="_footnote_50">
+<a href="expressions.html#_footnoteref_50">50</a>. Includes interfaces, since an interface type reference is a subtype of object type reference: <math xmlns="http://www.w3.org/1998/Math/MathML"><mstyle mathvariant="monospace"><mtext>type</mtext></mstyle><mfenced close="}" open="{"><mstyle mathvariant="monospace"><mtext>Interface</mtext></mstyle></mfenced><mo>&lt;</mo><mi>:</mi><mstyle mathvariant="monospace"><mtext>type</mtext></mstyle><mfenced close="}" open="{"><mstyle mathvariant="monospace"><mtext>Object</mtext></mstyle></mfenced></math>
+</div>
+<div class="footnote" id="_footnote_51">
+<a href="expressions.html#_footnoteref_51">51</a>. See [<a href="#ECMA15a">ECMA15a</a>], Chapter 12.3.5 "The Super Keyword"; note the use of <code>HomeObject</code> instead of <code>thisValue</code>; also see this blog - <a href="http://www.2ality.com/2011/11/super-references.html" class="bare">http://www.2ality.com/2011/11/super-references.html</a>.
+</div>
+<div class="footnote" id="_footnote_52">
+<a href="expressions.html#_footnoteref_52">52</a>. <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>e</mi><msup><mo>∈</mo><mo>*</mo></msup><mi>c</mi></math> is the transitive version of <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>e</mi><mo>∈</mo><mi>c</mi></math>, that is, it <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>e</mi></math> directly or indirectly contained in <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>c</mi></math>.
+</div>
+<div class="footnote" id="_footnote_53">
+<a href="statements.html#_footnoteref_53">53</a>. available at: <a href="http://www.2ality.com/2013/06/iterators-generators.html" class="bare">http://www.2ality.com/2013/06/iterators-generators.html</a>
+</div>
+<div class="footnote" id="_footnote_54">
+<a href="statements.html#_footnoteref_54">54</a>. For more details on module specifiers, see <a href="names.html#_qualified-names">Qualified Names</a>.
+</div>
+<div class="footnote" id="_footnote_55">
+<a href="extended_fetaures.html#_footnoteref_55">55</a>. Further reading on <a href="appendix_a_acronyms.html#_acronyms">DI</a> Basics: [<a href="#Fowler04b">Fowler04b</a>; <a href="#Prasanna09a">Prasanna09a</a>], Verification [<a href="#Zhu13a">Zhu13a</a>; <a href="#Hudli13a">Hudli13a</a>], Frameworks [<a href="#Lesiecki08a">Lesiecki08a</a>; <a href="#Betts13a">Betts13a</a>; <a href="#Knol13a">Knol13a</a>; <a href="#Dagger">Dagger</a>]
+</div>
+<div class="footnote" id="_footnote_56">
+<a href="extended_fetaures.html#_footnoteref_56">56</a>. Usually, only the <code>DIC</code> itself is created like that, e.g., <code class="language-n4js">var dic = N4Injector.of(DIC).create(DIC);</code>
+</div>
+<div class="footnote" id="_footnote_57">
+<a href="extended_fetaures.html#_footnoteref_57">57</a>. Note that other frameworks may define other constraints, e.g., arbitrary keys.
+</div>
+<div class="footnote" id="_footnote_58">
+<a href="extended_fetaures.html#_footnoteref_58">58</a>. Cf. a blog post about micro types - <a href="http://www.markhneedham.com/blog/2009/03/10/oo-micro-types/" class="bare">http://www.markhneedham.com/blog/2009/03/10/oo-micro-types/</a>, and tiny types - <a href="http://darrenhobbs.com/2007/04/11/tiny-types/" class="bare">http://darrenhobbs.com/2007/04/11/tiny-types/</a>
+</div>
+<div class="footnote" id="_footnote_59">
+<a href="extended_fetaures.html#_footnoteref_59">59</a>. This restriction has two reasons: Firstly, user-defined types with implementations would require to ’bootstrap’ the polyfill, which is impossible to do automatically without serious constraints on bootstrap code in general. Secondly, instead of filling user-defined types, they can be subclasses. Mechanisms such as dependency injection could then solve almost all remaining problems.
+</div>
+<div class="footnote" id="_footnote_60">
+<a href="plainjs.html#_footnoteref_60">60</a>. <a href="#_api-and-implementation-components">[_api-and-implementation-components]</a>
+</div>
+<div class="footnote" id="_footnote_61">
+<a href="plainjs.html#_footnoteref_61">61</a>. Global basically means that the module defines no namespace on its own. Thus the annotation is a script/module related annotation.
+</div>
+</div>
+<div id="footer">
+<div id="footer-text">
+Version 0.9<br>
+Last updated 2019-08-07 15:02:40 CEST
+</div>
+</div>
+<!-- ************* docinfo-footer *************************************************************** -->
+<div class="Grid social" style="color:#d5dfea">
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <h2>Quick Links</h2>
+    <ul>
+      <li><a href="../downloads.html">Download</a></li>
+      <li><a href="../userguides/index.html">Documentation</a></li>
+      <li><a href="https://github.com/eclipse/n4js/">Source</a></li>
+      <li><a href="https://github.com/eclipse/n4js/issues">Issues</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="https://www.eclipse.org/forums/index.php/f/365/">Forum</a></li>
+      <li><a href="http://n4js.blogspot.de/">Blog</a></li>
+      <li><a href="https://dev.eclipse.org/mailman/listinfo/n4js-dev">Mailing List</a></li>
+      <li><a href="https://projects.eclipse.org/projects/technology.n4js">Eclipse Project Page</a></li>
+      <li><a href="https://twitter.com/n4jsdev">Tweets by n4jsdev</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="http://www.eclipse.org/">Eclipse Home</a></li>
+      <li><a href="http://www.eclipse.org/legal/privacy.php">Privacy Policy</a></li>
+      <li><a href="http://www.eclipse.org/legal/termsofuse.php">Terms of Use</a></li>
+      <li><a href="http://www.eclipse.org/legal/copyright.php">Copyright Agent</a></li>
+      <li><a href="http://www.eclipse.org/legal/">Legal</a></li>
+    </ul>
+  </div>
+  <div style="clear: both; height: 0; overflow: hidden;"></div>
+</div>
+
+<!-- ************* UI Scripts ************* -->
+<script type="text/javascript" src="scripts/back-to-top.js"></script>
+
+<script type="text/javascript" src="scripts/treeview.js"></script>
+<script type="text/javascript" src="scripts/toc.js"></script>
+
+<!-- ************* Prism.js Syntax Highlighting ************* -->
+<script src="scripts/prism.js"></script>
+
+<script type="text/javascript">
+	// Add the 'toclist' id for search function
+	$(".toc2 > ul").attr('id', 'toclist');
+	// Generate a Search input form
+	$("#toclist > li:first-of-type").before('<input type="text" id="pagesearch" onkeyup="search()" placeholder="Search for section...">');
+	$("#toclist > li:first-of-type").before('<i id="clear" class="fa fa-times-circle-o"></i>');
+	$("#clear").click(function(){
+	    $("#pagesearch").val('');
+	    search();
+	    $('.toc2 > ul').treeView('collapseAll');
+	});
+	// intialize Treeview.js
+	$(".toc2 > ul").treeView();
+	// Initialize Scrollspy
+</script>
+<!-- ************* docinfo-footer *************************************************************** -->
+</body>
+</html>
\ No newline at end of file
diff --git a/spec/chapters/12_components/fig/cmp_components.svg b/spec/chapters/12_components/fig/cmp_components.svg
new file mode 100644
index 0000000..8e82c2b
--- /dev/null
+++ b/spec/chapters/12_components/fig/cmp_components.svg
@@ -0,0 +1,329 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:xl="http://www.w3.org/1999/xlink" version="1.1" xmlns="http://www.w3.org/2000/svg" viewBox="-25.5 -67.5 875 714.4413" width="875" height="714.4413">
+  <defs>
+    <font-face font-family="Helvetica" font-size="12" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="532.22656" cap-height="719.7266" ascent="770.0195" descent="-229.98047" font-weight="700">
+      <font-face-src>
+        <font-face-name name="Helvetica-Bold"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="12" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="UMLInheritance_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -8 14 16" markerWidth="14" markerHeight="16" color="black">
+      <g>
+        <path d="M 12 0 L 0 -7 L 0 7 Z" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="StickArrow_Marker" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -4 10 8" markerWidth="10" markerHeight="8" color="black">
+      <g>
+        <path d="M 8 0 L 0 0 M 0 -3 L 8 0 L 0 3" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <font-face font-family="Helvetica" font-size="10" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="400">
+      <font-face-src>
+        <font-face-name name="Helvetica"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="12" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="-1e3" x-height="539.5508" cap-height="719.7266" ascent="770.0195" descent="-229.98047" font-style="italic" font-weight="700">
+      <font-face-src>
+        <font-face-name name="Helvetica-BoldOblique"/>
+      </font-face-src>
+    </font-face>
+    <font-face font-family="Helvetica" font-size="10" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="532.22656" cap-height="719.7266" ascent="770.0195" descent="-229.98047" font-weight="700">
+      <font-face-src>
+        <font-face-name name="Helvetica-Bold"/>
+      </font-face-src>
+    </font-face>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="StickArrow_Marker_2" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -4 10 8" markerWidth="10" markerHeight="8" color="#cb0b00">
+      <g>
+        <path d="M 8 0 L 0 0 M 0 -3 L 8 0 L 0 3" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+    <font-face font-family="Helvetica Neue" font-size="11" panose-1="2 0 5 3 0 0 0 2 0 4" units-per-em="1000" underline-position="-100" underline-thickness="50" slope="0" x-height="517" cap-height="714" ascent="951.9958" descent="-212.99744" font-weight="400">
+      <font-face-src>
+        <font-face-name name="HelveticaNeue"/>
+      </font-face-src>
+    </font-face>
+    <marker orient="auto" overflow="visible" markerUnits="strokeWidth" id="StickArrow_Marker_3" stroke-linejoin="miter" stroke-miterlimit="10" viewBox="-1 -4 10 8" markerWidth="10" markerHeight="8" color="#cb0b00">
+      <g>
+        <path d="M 8 0 L 0 0 M 0 -3 L 8 0 L 0 3" fill="none" stroke="currentColor" stroke-width="1"/>
+      </g>
+    </marker>
+  </defs>
+  <metadata> Produced by OmniGraffle 7.8 
+    <dc:date>2019-05-10 14:52:26 +0000</dc:date>
+  </metadata>
+  <g id="Canvas_1" fill-opacity="1" stroke-dasharray="none" stroke="none" stroke-opacity="1" fill="none">
+    <title>Canvas 1</title>
+    <rect fill="white" x="-25.5" y="-67.5" width="875" height="714.4413"/>
+    <g id="Canvas_1: Layer 1">
+      <title>Layer 1</title>
+      <g id="Graphic_57">
+        <rect x="660.494" y="123.5" width="156.5" height="55.5" fill="white"/>
+        <rect x="660.494" y="123.5" width="156.5" height="55.5" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(665.494 130.25)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="60.916016" y="11">Impl</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="4.5634766" y="25">JS library written in N4JS, </tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="20.210938" y="39">types defined in API</tspan>
+        </text>
+      </g>
+      <g id="Line_56">
+        <path d="M 352.1 125.75 L 352.1 110.25 L 351.75 89.7727 L 351.75 87.7727" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_55">
+        <path d="M 34 139.625 L 22.1 139.625 L 22.1 96.38298 L 22.73759 96.38298 L 73.125 96.38298 L 73.125 113.85 L 73.125 115.85" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_54">
+        <text transform="translate(31.44185 96.38298)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«NPM»</tspan>
+        </text>
+      </g>
+      <g id="Graphic_53">
+        <rect x="273.5" y="10.5" width="156.5" height="63.7727" fill="white"/>
+        <rect x="273.5" y="10.5" width="156.5" height="63.7727" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(278.5 14.38635)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-style="italic" font-weight="700" fill="black" x="24.239258" y="11">NPMDependency</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="15.88086" y="25">listed in package.json </tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="28.882812" y="39">dependencies or </tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="1.5371094" y="53">devDependencies property</tspan>
+        </text>
+      </g>
+      <g id="Graphic_52">
+        <rect x="289.5" y="125.75" width="156.5" height="55.5" fill="white"/>
+        <rect x="289.5" y="125.75" width="156.5" height="55.5" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(294.5 139.5)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-style="italic" font-weight="700" fill="black" x="30.359375" y="11">Type Definition</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="12.883789" y="25">not required at runtime</tspan>
+        </text>
+      </g>
+      <g id="Graphic_51">
+        <rect x="445" y="311.17906" width="156.5" height="55.5" fill="white"/>
+        <rect x="445" y="311.17906" width="156.5" height="55.5" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(450 324.92906)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="63.24805" y="11">API</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="9.883789" y="25">Type definitions for Impl</tspan>
+        </text>
+      </g>
+      <g id="Line_50">
+        <path d="M 523.25 311.17906 L 523.25 295.67906 L 523.25 230.67906 L 414.7 230.67906 L 414.7 196.75 L 414.7 194.75" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_49">
+        <rect x="193" y="439.5" width="156.5" height="55.5" fill="white"/>
+        <rect x="193" y="439.5" width="156.5" height="55.5" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(198 446.25)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="30.58789" y="11">NPM Definition</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x=".875" y="25">Type definitions for existing </tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="32.56543" y="39">NPM pacakges</tspan>
+        </text>
+      </g>
+      <g id="Graphic_48">
+        <rect x="34" y="125.75" width="156.5" height="55.5" fill="white"/>
+        <rect x="34" y="125.75" width="156.5" height="55.5" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(39 139.5)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="35.56543" y="11">NPMPackage</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="26.881836" y="25">good old JS code</tspan>
+        </text>
+      </g>
+      <g id="Line_47">
+        <path d="M 112.25 125.75 L 112.25 110.25 L 112.25 97.25 L 312.625 97.25 L 312.625 89.7727 L 312.625 87.7727" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_46">
+        <rect x="383.5" y="439.5" width="156.5" height="55.5" fill="white"/>
+        <rect x="383.5" y="439.5" width="156.5" height="55.5" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(388.5 440.25)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="37.80078" y="11">Runtime API </tspan>
+          <tspan font-family="Helvetica" font-size="10" font-weight="700" fill="black" x="22.964355" y="24">(fka Runtime Library)</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x=".53808594" y="37">type definitions provided by </tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="53.243164" y="51">runtime</tspan>
+        </text>
+      </g>
+      <g id="Line_45">
+        <path d="M 422.625 439.5 L 422.625 424 L 422.625 295 L 383.4 295 L 383.4 196.75 L 383.4 194.75" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Graphic_44">
+        <rect x="366.5" y="523.4999" width="127" height="70.3456" fill="white"/>
+        <rect x="366.5" y="523.4999" width="127" height="70.3456" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(371.5 530.6727)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="21.829102" y="11">Runtime Env</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="5.1416016" y="25">collection of runtime </tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="13.142578" y="39">APIs provided by </tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x=".8144531" y="53">runtime or via polyfills</tspan>
+        </text>
+      </g>
+      <g id="Graphic_43">
+        <rect x="129.2997" y="311.17906" width="156.5" height="55.5" fill="white"/>
+        <rect x="129.2997" y="311.17906" width="156.5" height="55.5" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(134.2997 318.92906)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="33.88965" y="11">N4JSPackage</tspan>
+          <tspan font-family="Helvetica" font-size="10" font-weight="700" fill="black" x="44.353516" y="24">(fka Library)</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="6.230469" y="37">JS library written in N4JS</tspan>
+        </text>
+      </g>
+      <g id="Graphic_42">
+        <rect x="598" y="572" width="99" height="43.5" fill="white"/>
+        <rect x="598" y="572" width="99" height="43.5" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        <text transform="translate(603 572.75)" fill="black">
+          <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="11.833984" y="11">Application</tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="1.1435547" y="25">node or browser </tspan>
+          <tspan font-family="Helvetica" font-size="12" font-weight="400" fill="black" x="34.489258" y="39">app</tspan>
+        </text>
+      </g>
+      <g id="Line_41">
+        <path d="M 193 453.375 L 181.1 453.375 L 175.21986 453.375 L 175.21986 422.2695 L 232.125 422.2695 L 232.125 427.6 L 232.125 429.6" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_40">
+        <text transform="translate(187.03456 422.2695)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«NPM»</tspan>
+        </text>
+      </g>
+      <g id="Line_39">
+        <path d="M 562.375 311.17906 L 562.375 299.27906 L 562.375 170.85106 L 454.65 170.85106" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_38">
+        <text transform="translate(516.61786 170.85106)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«NPM»</tspan>
+        </text>
+      </g>
+      <g id="Line_37">
+        <path d="M 446 159.05 L 457.9 159.05 L 628.41135 159.05 L 628.41135 251.34752 L 628.41135 453.375 L 551.9 453.375 L 549.9 453.375" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_36">
+        <text transform="translate(583.4222 453.375)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«NPM»</tspan>
+        </text>
+      </g>
+      <g id="Line_35">
+        <path d="M 207.5497 311.17906 L 207.5497 299.27906 L 207.5497 170.15 L 277.6 170.15 L 279.6 170.15" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_34">
+        <text transform="translate(244 155.5)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«NPM»</tspan>
+        </text>
+      </g>
+      <g id="Line_33">
+        <path d="M 168.4247 311.17906 L 168.4247 295.67906 L 168.4247 230.67906 L 151.375 230.67906 L 151.375 196.75 L 151.375 194.75" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_32">
+        <path d="M 232.125 495 L 232.125 506.9 L 112.25 506.9 L 112.25 193.15 L 112.25 191.15" marker-end="url(#StickArrow_Marker_2)" stroke="#cb0b00" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_31">
+        <text transform="translate(89.3315 462.2687)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="11" font-weight="400" fill="black" x="0" y="10">«defines»</tspan>
+        </text>
+      </g>
+      <g id="Graphic_29">
+        <text transform="translate(665.992 295.90468)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="11" font-weight="400" fill="black" x="40500936e-20" y="10">«implements»</tspan>
+        </text>
+      </g>
+      <g id="Line_28">
+        <path d="M 738.744 123.5 L 738.744 108 L 738.744 97 L 390.875 97 L 390.875 89.7727 L 390.875 87.7727" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_27">
+        <path d="M 699.619 123.5 L 699.619 111.6 L 699.619 110.5461 L 205.7163 110.5461 L 151.375 110.5461 L 151.375 113.85 L 151.375 115.85" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_26">
+        <text transform="translate(461.4699 110.5461)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«NPM»</tspan>
+        </text>
+      </g>
+      <g id="Line_25">
+        <path d="M 660.494 137.375 L 648.594 137.375 L 541.594 137.375 L 541.594 136.85 L 457.9 136.85 L 455.9 136.85" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_24">
+        <text transform="translate(486.1672 136.85)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«NPM»</tspan>
+        </text>
+      </g>
+      <g id="Line_23">
+        <path d="M 697 593.75 L 708.9 593.75 L 777.869 593.75 L 777.869 190.9 L 777.869 188.9" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="miter" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_22">
+        <text transform="translate(767.1966 194.26887)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«NPM»</tspan>
+        </text>
+      </g>
+      <g id="Line_21">
+        <path d="M 598 604.625 L 586.1 604.625 L 22.1 604.625 L 22.1 167.375 L 24.1 167.375" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_20">
+        <text transform="translate(13.427637 186.0338)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«NPM»</tspan>
+        </text>
+      </g>
+      <g id="Line_19">
+        <path d="M 647.5 572 L 647.5 560.1 L 647.5 147.95 L 457.9 147.95 L 455.9 147.95" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_18">
+        <text transform="translate(497.8825 147.95)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«NPM»</tspan>
+        </text>
+      </g>
+      <g id="Line_17">
+        <path d="M 622.75 572 L 622.75 560.1 L 622.75 558.6727 L 505.4 558.6727 L 503.4 558.6727" marker-end="url(#StickArrow_Marker_2)" stroke="#cb0b00" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_16">
+        <text transform="translate(516.7149 545.6727)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«runsOn»</tspan>
+        </text>
+      </g>
+      <g id="Line_15">
+        <path d="M 366.5 541.0863 L 354.6 541.0863 L 73.125 541.0863 L 73.125 193.15 L 73.125 191.15" marker-end="url(#StickArrow_Marker_2)" stroke="#cb0b00" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_14">
+        <text transform="translate(48.38623 507.8486)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«enforces»</tspan>
+        </text>
+      </g>
+      <g id="Line_13">
+        <path d="M 461.75 523.4999 L 461.75 511.5999 L 461.75 506.9 L 461.75 504.9" marker-end="url(#StickArrow_Marker_2)" stroke="#cb0b00" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_12">
+        <text transform="translate(443.28955 504.80116)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«provides»</tspan>
+        </text>
+      </g>
+      <g id="Line_11">
+        <path d="M 697 582.875 L 708.9 582.875 L 738.246 582.875 L 738.246 557.7305 L 672.25 557.7305 L 672.25 560.1 L 672.25 562.1" marker-end="url(#StickArrow_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_10">
+        <text transform="translate(698.2529 557.7305)" fill="black">
+          <tspan font-family="Helvetica" font-size="10" font-weight="400" fill="black" x="0" y="10">«NPM»</tspan>
+        </text>
+      </g>
+      <g id="Line_9">
+        <path d="M 310.375 439.5 L 310.375 424 L 310.375 295 L 352.1 295 L 352.1 196.75 L 352.1 194.75" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_8">
+        <path d="M 246.6747 311.17906 L 246.6747 295.67906 L 246.6747 230.67906 L 320.8 230.67906 L 320.8 196.75 L 320.8 194.75" marker-end="url(#UMLInheritance_Marker)" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+      </g>
+      <g id="Line_7">
+        <path d="M 738.744 179 L 738.744 190.9 L 738.744 541.0863 L 653 541.0863 C 653 535.5863 642 535.5863 642 541.0863 L 513.3 541.0863" marker-end="url(#StickArrow_Marker_3)" stroke="#cb0b00" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+      <g id="Graphic_6">
+        <text transform="translate(529.4179 528.9323)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="11" font-weight="400" fill="black" x="34816594e-20" y="10">«runsOn»</tspan>
+        </text>
+      </g>
+      <g id="Group_58">
+        <g id="Graphic_60">
+          <rect x="-21" y="-63" width="866" height="705.4413" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+        </g>
+        <g id="Graphic_59">
+          <path d="M -21 -63 L 276.1565 -63 L 276.1565 -45.29139 L 251.39357 -27.58278 L -21 -27.582994 Z" fill="white"/>
+          <path d="M -21 -63 L 276.1565 -63 L 276.1565 -45.29139 L 251.39357 -27.58278 L -21 -27.582994 Z" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/>
+          <text transform="translate(-16 -59.29139)" fill="black">
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="0" y="11">cd Components and (inherited) dependencies</tspan>
+            <tspan font-family="Helvetica" font-size="12" font-weight="700" fill="black" x="0" y="25">ver. 1</tspan>
+          </text>
+        </g>
+      </g>
+      <g id="Line_30">
+        <path d="M 699.619 179 L 699.619 190.9 L 699.619 338.92906 L 653 338.92906 C 653 333.42906 642 333.42906 642 338.92906 L 633.91135 338.92906 C 633.91135 333.42906 622.91135 333.42906 622.91135 338.92906 L 621.3 338.92906" marker-end="url(#StickArrow_Marker_2)" stroke="#cb0b00" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="4.0,4.0" stroke-width="1"/>
+      </g>
+    </g>
+  </g>
+</svg>
diff --git a/spec/chapters/a03_n4jsobjects/fig/cd_reflectionModel.svg b/spec/chapters/a03_n4jsobjects/fig/cd_reflectionModel.svg
old mode 100755
new mode 100644
diff --git a/spec/classifiers.html b/spec/classifiers.html
new file mode 100644
index 0000000..805b3b3
--- /dev/null
+++ b/spec/classifiers.html
@@ -0,0 +1,6596 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="generator" content="Asciidoctor 1.5.5">
+<meta name="author" content="2019-08-07 15:02:40 CEST">
+<title>N4JS Language Specification</title>
+<link rel="stylesheet" href="styles/spec.min.css">
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.6.3/css/font-awesome.min.css">
+<!-- ************* docinfo ******************************************************************* -->
+
+
+<!-- ************* Favicon ************-->
+<link rel="icon" href="images/favicon.ico" />
+
+<!-- ************* Back-to-top JQuery ************* -->
+<script src="https://code.jquery.com/jquery-1.12.4.js"></script>
+<script src="https://code.jquery.com/ui/1.12.0/jquery-ui.js"></script>
+
+
+<link href="styles/prism.min.css" rel="stylesheet" />
+<script type="text/javascript" async
+  src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2/MathJax.js?config=TeX-MML-AM_CHTML">
+</script>
+
+<!-- ************* Styles ************* -->
+<link rel="stylesheet" type="text/css" href="styles/n4jsspec-adoc.css">
+
+
+<!-- ****************** NavBar ****************** -->
+<div id="menubar">
+	<div class="banner">
+        <a href="https://www.eclipse.org/n4js/#"><img id="logo" src="images/n4js-logo.png" alt="Eclipse N4JS"></a>
+    </div>
+<ul>
+  <li><a href="index.html">Index</a></li>
+</ul>
+</div>
+<!-- ************* docinfo ******************************************************************* -->
+<style>
+      .admonitionblock td.icon .icon-todo:before{content:"\f249";color:#f4ee42}
+    </style>
+</head>
+<body class="book toc2 toc-left">
+<div id="header">
+<h1>N4JS Language Specification</h1>
+<div class="details">
+<span id="author" class="author">2019-08-07 15:02:40 CEST</span><br>
+<span id="revnumber">version 0.9</span>
+</div>
+<div id="toc" class="toc2">
+<div id="toctitle">Table of Contents</div>
+<ul class="sectlevel1">
+<li><a href="introduction.html#_introduction">1. Introduction</a>
+<ul class="sectlevel2">
+<li><a href="introduction.html#_notation">1.1. Notation</a>
+<ul class="sectlevel3">
+<li><a href="introduction.html#_grammar-notation">1.1.1. Grammar Notation</a></li>
+<li><a href="introduction.html#_type-judgments-and-rules-and-constraints-notation">1.1.2. Type Judgments and Rules and Constraints Notation</a>
+<ul class="sectlevel4">
+<li><a href="introduction.html#_typing-rules-and-judgments">1.1.2.1. Typing Rules and Judgments</a></li>
+<li><a href="introduction.html#_types-of-an-element">1.1.2.2. Types of an Element</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="introduction.html#_auxiliary-functions">1.2. Auxiliary Functions</a>
+<ul class="sectlevel3">
+<li><a href="introduction.html#_binding">1.2.1. Binding</a></li>
+<li><a href="introduction.html#_merging-types">1.2.2. Merging Types</a>
+<ul class="sectlevel4">
+<li><a href="introduction.html#_logic-formulas">1.2.2.1. Logic Formulas</a></li>
+</ul>
+</li>
+<li><a href="introduction.html#_symbols-and-font-convention">1.2.3. Symbols and Font Convention</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="grammar.html#_grammar">2. Grammar</a>
+<ul class="sectlevel2">
+<li><a href="grammar.html#_lexical-conventions">2.1. Lexical Conventions</a>
+<ul class="sectlevel3">
+<li><a href="grammar.html#_identifier-names-and-identifiers">2.1.1. Identifier Names and Identifiers</a></li>
+<li><a href="grammar.html#_this-keyword">2.1.2. This Keyword</a></li>
+<li><a href="grammar.html#_regular-expression-literals">2.1.3. Regular Expression Literals</a></li>
+<li><a href="grammar.html#_automatic-semicolon-insertion">2.1.4. Automatic Semicolon Insertion</a></li>
+<li><a href="grammar.html#_jsdoc">2.1.5. JSDoc</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="names.html#_names">3. Names</a>
+<ul class="sectlevel2">
+<li><a href="names.html#_access-control">3.1. Access Control</a></li>
+<li><a href="names.html#_accessibility-of-types-top-level-variables-and-function-declarations">3.2. Accessibility of Types, Top-Level Variables and Function Declarations</a>
+<ul class="sectlevel3">
+<li><a href="names.html#_accessibility-of-members">3.2.1. Accessibility of Members</a></li>
+<li><a href="names.html#_valid-names">3.2.2. Valid Names</a></li>
+<li><a href="names.html#_qualified-names">3.2.3. Qualified Names</a></li>
+<li><a href="names.html#_name-duplicates">3.2.4. Name Duplicates</a>
+<ul class="sectlevel4">
+<li><a href="names.html#_lexical-environment">3.2.4.1. Lexical Environment</a></li>
+<li><a href="names.html#_duplicates-and-shadowing">3.2.4.2. Duplicates and Shadowing</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="types.html#_types">4. Types</a>
+<ul class="sectlevel2">
+<li><a href="types.html#_overview">4.1. Overview</a></li>
+<li><a href="types.html#_type-expressions">4.2. Type Expressions</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_syntax">4.2.1. Syntax</a></li>
+<li><a href="types.html#_properties">4.2.2. Properties</a></li>
+<li><a href="types.html#_semantics">4.2.3. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_type-inference">4.3. Type Inference</a></li>
+<li><a href="types.html#_generic-and-parameterized-types">4.4. Generic and Parameterized Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_generic-types">4.4.1. Generic Types</a></li>
+<li><a href="types.html#_type-variables">4.4.2. Type Variables</a></li>
+<li><a href="types.html#_parameterized-types">4.4.3. Parameterized Types</a></li>
+</ul>
+</li>
+<li><a href="types.html#_primitive-ecmascript-types">4.5. Primitive ECMAScript Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_undefined-type">4.5.1. Undefined Type</a></li>
+<li><a href="types.html#_null-type">4.5.2. Null Type</a></li>
+<li><a href="types.html#_primitive-boolean-type">4.5.3. Primitive Boolean Type</a></li>
+<li><a href="types.html#_primitive-string-type">4.5.4. Primitive String Type</a></li>
+<li><a href="types.html#_primitive-number-type">4.5.5. Primitive Number Type</a></li>
+<li><a href="types.html#_primitive-type-int">4.5.6. Primitive Type int</a></li>
+<li><a href="types.html#_primitive-symbol-type">4.5.7. Primitive Symbol Type</a></li>
+</ul>
+</li>
+<li><a href="types.html#_primitive-n4js-types">4.6. Primitive N4JS Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_any-type">4.6.1. Any Type</a>
+<ul class="sectlevel4">
+<li><a href="types.html#any-type-semantics">4.6.1.1. Semantics</a></li>
+<li><a href="types.html#any-type-type-inference">4.6.1.2. Type Inference</a>
+<ul class="sectlevel5">
+<li><a href="types.html#_default-type-of-variables">4.6.1.2.1. Default Type of Variables</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="types.html#_void-type">4.6.2. Void Type</a>
+<ul class="sectlevel4">
+<li><a href="types.html#void-type-semantics">4.6.2.1. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_unknown-type">4.6.3. Unknown Type</a></li>
+<li><a href="types.html#_primitive-pathselector-and-i18nkey">4.6.4. Primitive Pathselector and I18nKey</a>
+<ul class="sectlevel4">
+<li><a href="types.html#pathselector-semantics">4.6.4.1. Semantics</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="types.html#_built-in-ecmascript-object-types">4.7. Built-in ECMAScript Object Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#ECMAScript-objects-semantics">4.7.1. Semantics</a></li>
+<li><a href="types.html#_object-type">4.7.2. Object Type</a></li>
+<li><a href="types.html#_function-object-type">4.7.3. Function-Object-Type</a></li>
+<li><a href="types.html#_array-object-type">4.7.4. Array Object Type</a></li>
+<li><a href="types.html#_string-object-type">4.7.5. String Object Type</a></li>
+<li><a href="types.html#_boolean-object-type">4.7.6. Boolean Object Type</a></li>
+<li><a href="types.html#_number-object-type">4.7.7. Number Object Type</a></li>
+<li><a href="types.html#_global-object-type">4.7.8. Global Object Type</a></li>
+<li><a href="types.html#_symbol">4.7.9. Symbol</a></li>
+<li><a href="types.html#_promise">4.7.10. Promise</a></li>
+<li><a href="types.html#_iterator-interface">4.7.11. Iterator Interface</a></li>
+<li><a href="types.html#_iterable-interface">4.7.12. Iterable Interface</a></li>
+</ul>
+</li>
+<li><a href="types.html#_built-in-n4js-types">4.8. Built-In N4JS Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_n4object">4.8.1. N4Object</a>
+<ul class="sectlevel4">
+<li><a href="types.html#N4Object-semantics">4.8.1.1. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_n4class">4.8.2. N4Class</a></li>
+<li><a href="types.html#IterableN">4.8.3. IterableN</a></li>
+</ul>
+</li>
+<li><a href="types.html#_type-modifiers">4.9. Type Modifiers</a>
+<ul class="sectlevel3">
+<li><a href="types.html#Type_Modifiers_Dynamic">4.9.1. Dynamic</a></li>
+<li><a href="types.html#_optional-return-types">4.9.2. Optional Return Types</a></li>
+</ul>
+</li>
+<li><a href="types.html#_union-and-intersection-type-composed-types">4.10. Union and Intersection Type (Composed Types)</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_union-type">4.10.1. Union Type</a>
+<ul class="sectlevel4">
+<li><a href="types.html#union-type-syntax">4.10.1.1. Syntax</a></li>
+<li><a href="types.html#union-type-semantics">4.10.1.2. Semantics</a></li>
+<li><a href="types.html#_warnings">4.10.1.3. Warnings</a></li>
+</ul>
+</li>
+<li><a href="types.html#_intersection-type">4.10.2. Intersection Type</a>
+<ul class="sectlevel4">
+<li><a href="types.html#intersection-type-syntax">4.10.2.1. Syntax</a></li>
+<li><a href="types.html#intersection-type-semantics">4.10.2.2. Semantics</a></li>
+<li><a href="types.html#_warnings-2">4.10.2.3. Warnings</a></li>
+</ul>
+</li>
+<li><a href="types.html#_composed-types-in-wildcards">4.10.3. Composed Types in Wildcards</a></li>
+<li><a href="types.html#_property-access-for-composed-types">4.10.4. Property Access for Composed Types</a>
+<ul class="sectlevel4">
+<li><a href="types.html#_properties-of-union-type">4.10.4.1. Properties of Union Type</a>
+<ul class="sectlevel5">
+<li><a href="types.html#_remarks-on-union-type-s-members">4.10.4.1.1. Remarks on union type’s members:</a></li>
+</ul>
+</li>
+<li><a href="types.html#_properties-of-intersection-type">4.10.4.2. Properties of Intersection Type</a>
+<ul class="sectlevel5">
+<li><a href="types.html#_remarks-on-intersection-type-s-methods">4.10.4.2.1. Remarks on intersection type’s methods:</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="types.html#_constructor-and-classifier-type">4.11. Constructor and Classifier Type</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_syntax-3">4.11.1. Syntax</a></li>
+<li><a href="types.html#_semantics-2">4.11.2. Semantics</a></li>
+<li><a href="types.html#_constructors-and-prototypes-in-ecmascript-2015">4.11.3. Constructors and Prototypes in ECMAScript 2015</a></li>
+</ul>
+</li>
+<li><a href="types.html#_this-type">4.12. This Type</a>
+<ul class="sectlevel3">
+<li><a href="types.html#this-type-syntax">4.12.1. Syntax</a></li>
+<li><a href="types.html#this-keyword-semantics">4.12.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_enums">4.13. Enums</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_enums-n4js">4.13.1. Enums (N4JS)</a>
+<ul class="sectlevel4">
+<li><a href="types.html#enums-syntax">4.13.1.1. Syntax</a></li>
+<li><a href="types.html#enums-semantics">4.13.1.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_string-based-enums">4.13.2. String-Based Enums</a></li>
+</ul>
+</li>
+<li><a href="types.html#_short-hand-syntax">4.14. Short-Hand Syntax</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_array-short-hand-syntax">4.14.1. Array Short-Hand Syntax</a></li>
+<li><a href="types.html#_iterablen-short-hand-syntax">4.14.2. IterableN Short-Hand Syntax</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#_classifiers">5. Classifiers</a>
+<ul class="sectlevel2">
+<li><a href="#_n4js-specific-classifiers">5.1. N4JS Specific Classifiers</a>
+<ul class="sectlevel3">
+<li><a href="#_properties-2">5.1.1. Properties</a></li>
+<li><a href="#_common-semantics-of-classifiers">5.1.2. Common Semantics of Classifiers</a></li>
+<li><a href="#_classes">5.1.3. Classes</a>
+<ul class="sectlevel4">
+<li><a href="#_definition-of-classes">5.1.3.1. Definition of Classes</a>
+<ul class="sectlevel5">
+<li><a href="#class-syntax">5.1.3.1.1. Syntax</a></li>
+<li><a href="#class-properties">5.1.3.1.2. Properties</a></li>
+<li><a href="#class-type-inference">5.1.3.1.3. Type Inference</a></li>
+</ul>
+</li>
+<li><a href="#class-semantics">5.1.3.2. Semantics</a></li>
+<li><a href="#_final-modifier">5.1.3.3. Final Modifier</a></li>
+<li><a href="#_abstract-classes">5.1.3.4. Abstract Classes</a></li>
+<li><a href="#_non-instantiable-classes">5.1.3.5. Non-Instantiable Classes</a></li>
+<li><a href="#_superclass">5.1.3.6. Superclass</a></li>
+</ul>
+</li>
+<li><a href="#_interfaces">5.1.4. Interfaces</a>
+<ul class="sectlevel4">
+<li><a href="#_definition-of-interfaces">5.1.4.1. Definition of Interfaces</a>
+<ul class="sectlevel5">
+<li><a href="#interfaces-syntax">5.1.4.1.1. Syntax</a></li>
+<li><a href="#interfaces-properties">5.1.4.1.2. Properties</a></li>
+<li><a href="#interfaces-type-inference">5.1.4.1.3. Type Inference</a></li>
+<li><a href="#interfaces-semantics">5.1.4.1.4. Semantics</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#_generic-classifiers">5.1.5. Generic Classifiers</a></li>
+<li><a href="#sec:definition-site-variance">5.1.6. Definition-Site Variance</a></li>
+</ul>
+</li>
+<li><a href="#_members">5.2. Members</a>
+<ul class="sectlevel3">
+<li><a href="#_syntax-4">5.2.1. Syntax</a>
+<ul class="sectlevel4">
+<li><a href="#_properties-3">5.2.1.1. Properties</a></li>
+</ul>
+</li>
+<li><a href="#_semantics-3">5.2.2. Semantics</a></li>
+<li><a href="#_methods">5.2.3. Methods</a>
+<ul class="sectlevel4">
+<li><a href="#_syntax-5">5.2.3.1. Syntax</a></li>
+<li><a href="#_properties-4">5.2.3.2. Properties</a></li>
+<li><a href="#_semantics-4">5.2.3.3. Semantics</a></li>
+<li><a href="#_final-methods">5.2.3.4. Final Methods</a></li>
+<li><a href="#_abstract-methods">5.2.3.5. Abstract Methods</a></li>
+<li><a href="#_generic-methods">5.2.3.6. Generic Methods</a></li>
+</ul>
+</li>
+<li><a href="#_default-methods-in-interfaces">5.2.4. Default Methods in Interfaces</a>
+<ul class="sectlevel4">
+<li><a href="#_asynchronous-methods">5.2.4.1. Asynchronous Methods</a></li>
+</ul>
+</li>
+<li><a href="#_constructors">5.2.5. Constructors</a>
+<ul class="sectlevel4">
+<li><a href="#_structural-this-type-in-constructor">5.2.5.1. Structural This Type in Constructor</a></li>
+<li><a href="#spec-constructor">5.2.5.2. @Spec Constructor</a></li>
+<li><a href="#_callable-constructors">5.2.5.3. Callable Constructors</a></li>
+<li><a href="#_covariant-constructors">5.2.5.4. Covariant Constructors</a></li>
+</ul>
+</li>
+<li><a href="#_data-fields">5.2.6. Data Fields</a>
+<ul class="sectlevel4">
+<li><a href="#data-fields-syntax">5.2.6.1. Syntax</a></li>
+<li><a href="#data-fields-properties">5.2.6.2. Properties</a>
+<ul class="sectlevel5">
+<li><a href="#data-fields-semantics">5.2.6.2.1. Semantics</a></li>
+<li><a href="#data-fields-type-inference">5.2.6.2.2. Type Inference</a></li>
+</ul>
+</li>
+<li><a href="#_assignment-modifiers">5.2.6.3. Assignment Modifiers</a></li>
+<li><a href="#_field-accessors-getter-setter">5.2.6.4. Field Accessors (Getter/Setter)</a>
+<ul class="sectlevel5">
+<li><a href="#field-acessors-syntax">5.2.6.4.1. Syntax</a></li>
+<li><a href="#field-acessors-properties">5.2.6.4.2. Properties</a></li>
+<li><a href="#field-accessors-semantics">5.2.6.4.3. Semantics</a></li>
+</ul>
+</li>
+<li><a href="#optional-fields">5.2.6.5. Optional Fields</a>
+<ul class="sectlevel5">
+<li><a href="#_syntax-6">5.2.6.5.1. Syntax</a></li>
+<li><a href="#_semantics-5">5.2.6.5.2. Semantics</a></li>
+<li><a href="#_background">5.2.6.5.3. Background</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#_static-members">5.2.7. Static Members</a>
+<ul class="sectlevel4">
+<li><a href="#_access-from-and-to-static-members">5.2.7.1. Access From and To Static Members</a></li>
+<li><a href="#_generic-static-methods">5.2.7.2. Generic static methods</a></li>
+<li><a href="#_static-members-of-interfaces">5.2.7.3. Static Members of Interfaces</a></li>
+</ul>
+</li>
+<li><a href="#_redefinition-of-members">5.2.8. Redefinition of Members</a>
+<ul class="sectlevel4">
+<li><a href="#_overriding-of-members">5.2.8.1. Overriding of Members</a></li>
+<li><a href="#_implementation-of-members">5.2.8.2. Implementation of Members</a>
+<ul class="sectlevel5">
+<li><a href="#_member-consumption">5.2.8.2.1. Member Consumption</a></li>
+<li><a href="#_member-implementation">5.2.8.2.2. Member Implementation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#_structural-typing">5.3. Structural Typing</a>
+<ul class="sectlevel3">
+<li><a href="#_syntax-7">5.3.1. Syntax</a></li>
+<li><a href="#_definition-site-structural-typing">5.3.2. Definition Site Structural Typing</a></li>
+<li><a href="#_use-site-structural-typing">5.3.3. Use-Site Structural Typing</a></li>
+<li><a href="#structural-readWriteInit-field-typing">5.3.4. Structural Read-only, Write-only and Initializer Field Typing</a></li>
+<li><a href="#_public-setter-annotated-with-code-providesinitializer-code">5.3.5. Public Setter Annotated With <code>ProvidesInitializer</code></a></li>
+<li><a href="#_structural-types-with-optional-fields">5.3.6. Structural Types With Optional Fields</a></li>
+<li><a href="#_structural-types-with-access-modifier">5.3.7. Structural Types With Access Modifier</a></li>
+<li><a href="#_structural-types-with-additional-members">5.3.8. Structural Types With Additional Members</a>
+<ul class="sectlevel4">
+<li><a href="#_syntax-8">5.3.8.1. Syntax</a>
+<ul class="sectlevel5">
+<li><a href="#_semantics-6">5.3.8.1.1. Semantics</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="functions.html#_functions">6. Functions</a>
+<ul class="sectlevel2">
+<li><a href="functions.html#_function-type">6.1. Function Type</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_properties-5">6.1.1. Properties</a></li>
+<li><a href="functions.html#function-type-inference">6.1.2. Type Inference</a></li>
+<li><a href="functions.html#_autoboxing-of-function-type">6.1.3. Autoboxing of Function Type</a></li>
+<li><a href="functions.html#_arguments-object">6.1.4. Arguments Object</a></li>
+</ul>
+</li>
+<li><a href="functions.html#_ecmascript-5-function-definition">6.2. ECMAScript 5 Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_function-declaration">6.2.1. Function Declaration</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#_syntax-9">6.2.1.1. Syntax</a></li>
+<li><a href="functions.html#_semantics-8">6.2.1.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="functions.html#_function-expression">6.2.2. Function Expression</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#function-expression-syntax">6.2.2.1. Syntax</a></li>
+<li><a href="functions.html#_semantics-and-type-inference">6.2.2.2. Semantics and Type Inference</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="functions.html#_ecmascript-2015-function-definition">6.3. ECMAScript 2015 Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_formal-parameters">6.3.1. Formal Parameters</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#Type_Modifiers_Optional">6.3.1.1. Optional Parameters</a></li>
+<li><a href="functions.html#Type_Modifiers_Default">6.3.1.2. Default Parameters</a></li>
+<li><a href="functions.html#Type_Modifiers_Variadic">6.3.1.3. Variadic</a></li>
+</ul>
+</li>
+<li><a href="functions.html#_generator-functions">6.3.2. Generator Functions</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#generator-functions-syntax">6.3.2.1. Syntax</a></li>
+<li><a href="functions.html#generator-functions-semantics">6.3.2.2. Semantics</a></li>
+<li><a href="functions.html#_generator-arrow-functions">6.3.2.3. Generator Arrow Functions</a></li>
+</ul>
+</li>
+<li><a href="functions.html#_arrow-function-expression">6.3.3. Arrow Function Expression</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#arrow-function-expression-syntax">6.3.3.1. Syntax</a></li>
+<li><a href="functions.html#arrow-function-expression-semantics-and-type-inference">6.3.3.2. Semantics and Type Inference</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="functions.html#_ecmascript-proposals-function-definition">6.4. ECMAScript Proposals Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_asynchronous-functions">6.4.1. Asynchronous Functions</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#asynchronous-functions-syntax">6.4.1.1. Syntax</a></li>
+<li><a href="functions.html#asynchronous-functions-semantics">6.4.1.2. Semantics</a></li>
+<li><a href="functions.html#_asynchronous-arrow-functions">6.4.1.3. Asynchronous Arrow Functions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="functions.html#_n4js-extended-function-definition">6.5. N4JS Extended Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_generic-functions">6.5.1. Generic Functions</a></li>
+<li><a href="functions.html#_promisifiable-functions">6.5.2. Promisifiable Functions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_conversions-and-reflection">7. Conversions and Reflection</a>
+<ul class="sectlevel2">
+<li><a href="conversions_and_reflection.html#_autoboxing-and-coercing">7.1. Autoboxing and Coercing</a>
+<ul class="sectlevel3">
+<li><a href="conversions_and_reflection.html#_coercing">7.1.1. Coercing</a></li>
+<li><a href="conversions_and_reflection.html#_autoboxing-of-primitives">7.1.2. Autoboxing of Primitives</a></li>
+<li><a href="conversions_and_reflection.html#_autoboxing-of-function-expressions-and-declarations">7.1.3. Autoboxing of Function Expressions and Declarations</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_auto-conversion-of-objects">7.2. Auto-Conversion of Objects</a>
+<ul class="sectlevel3">
+<li><a href="conversions_and_reflection.html#_auto-conversion-of-class-instances">7.2.1. Auto-Conversion of Class Instances</a>
+<ul class="sectlevel4">
+<li><a href="conversions_and_reflection.html#_auto-conversion-of-interface-instances">7.2.1.1. Auto-Conversion of Interface Instances</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_auto-conversion-of-enum-literals">7.2.2. Auto-Conversion of Enum Literals</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_type-cast-and-type-check">7.3. Type Cast and Type Check</a>
+<ul class="sectlevel3">
+<li><a href="conversions_and_reflection.html#_type-cast">7.3.1. Type Cast</a></li>
+<li><a href="conversions_and_reflection.html#_type-check">7.3.2. Type Check</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_reflection-meta-information">7.4. Reflection meta-information</a>
+<ul class="sectlevel3">
+<li><a href="conversions_and_reflection.html#_reflection-for-classes">7.4.1. Reflection for Classes</a></li>
+<li><a href="conversions_and_reflection.html#_reflection-for-interfaces">7.4.2. Reflection for Interfaces</a></li>
+<li><a href="conversions_and_reflection.html#_reflection-for-enumerations">7.4.3. Reflection for Enumerations</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_conversion-of-primitive-types">7.5. Conversion of primitive types</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_expressions">8. Expressions</a>
+<ul class="sectlevel2">
+<li><a href="expressions.html#_ecmascript-5-expressions">8.1. ECMAScript 5 Expressions</a>
+<ul class="sectlevel3">
+<li><a href="expressions.html#_the-this-literal">8.1.1. The this Literal</a></li>
+<li><a href="expressions.html#_identifier">8.1.2. Identifier</a></li>
+<li><a href="expressions.html#_literals">8.1.3. Literals</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#_integer-literals">8.1.3.1. Integer Literals</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_array-literal">8.1.4. Array Literal</a></li>
+<li><a href="expressions.html#_object-literal">8.1.5. Object Literal</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#_properties-6">8.1.5.1. Properties</a></li>
+<li><a href="expressions.html#_scoping-and-linking">8.1.5.2. Scoping and linking</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_parenthesized-expression-and-grouping-operator">8.1.6. Parenthesized Expression and Grouping Operator</a></li>
+<li><a href="expressions.html#_property-accessors">8.1.7. Property Accessors</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#properties-1">8.1.7.1. Properties</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_new-expression">8.1.8. New Expression</a></li>
+<li><a href="expressions.html#_function-expression-2">8.1.9. Function Expression</a></li>
+<li><a href="expressions.html#_function-calls">8.1.10. Function Calls</a></li>
+<li><a href="expressions.html#_postfix-expression">8.1.11. Postfix Expression</a></li>
+<li><a href="expressions.html#_unary-expression">8.1.12. Unary Expression</a></li>
+<li><a href="expressions.html#_multiplicative-expression">8.1.13. Multiplicative Expression</a></li>
+<li><a href="expressions.html#_additive-expression">8.1.14. Additive Expression</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#type-inference-10">8.1.14.1. Type Inference</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_bitwise-shift-expression">8.1.15. Bitwise Shift Expression</a></li>
+<li><a href="expressions.html#_relational-expression">8.1.16. Relational Expression</a></li>
+<li><a href="expressions.html#_equality-expression">8.1.17. Equality Expression</a></li>
+<li><a href="expressions.html#_binary-bitwise-expression">8.1.18. Binary Bitwise Expression</a></li>
+<li><a href="expressions.html#_binary-logical-expression">8.1.19. Binary Logical Expression</a></li>
+<li><a href="expressions.html#_conditional-expression">8.1.20. Conditional Expression</a></li>
+<li><a href="expressions.html#_assignment-expression">8.1.21. Assignment Expression</a></li>
+<li><a href="expressions.html#_comma-expression">8.1.22. Comma Expression</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_ecmascript-6-expressions">8.2. ECMAScript 6 Expressions</a>
+<ul class="sectlevel3">
+<li><a href="expressions.html#_the-super-keyword">8.2.1. The super Keyword</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_ecmascript-7-expressions">8.3. ECMAScript 7 Expressions</a>
+<ul class="sectlevel3">
+<li><a href="expressions.html#_await-expression">8.3.1. Await Expression</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_n4js-specific-expressions">8.4. N4JS Specific Expressions</a>
+<ul class="sectlevel3">
+<li><a href="expressions.html#_class-expression">8.4.1. Class Expression</a></li>
+<li><a href="expressions.html#_cast-as-expression">8.4.2. Cast (As) Expression</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#cast-as-expression-semantics-type-inference">8.4.2.1. Semantics and Type Inference</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#Import_Calls">8.4.3. Import Calls</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#compile-time-expressions">8.5. Compile-Time Expressions</a></li>
+</ul>
+</li>
+<li><a href="statements.html#_statements">9. Statements</a>
+<ul class="sectlevel2">
+<li><a href="statements.html#_ecmascript-5-statements">9.1. ECMAScript 5 Statements</a>
+<ul class="sectlevel3">
+<li><a href="statements.html#_function-or-field-accessor-bodies">9.1.1. Function or Field Accessor Bodies</a></li>
+<li><a href="statements.html#_variable-statement">9.1.2. Variable Statement</a></li>
+<li><a href="statements.html#_if-statement">9.1.3. If Statement</a></li>
+<li><a href="statements.html#_iteration-statements">9.1.4. Iteration Statements</a></li>
+<li><a href="statements.html#_return-statement">9.1.5. Return Statement</a></li>
+<li><a href="statements.html#_with-statement">9.1.6. With Statement</a></li>
+<li><a href="statements.html#_switch-statement">9.1.7. Switch Statement</a></li>
+<li><a href="statements.html#_throw-try-and-catch-statements">9.1.8. Throw, Try, and Catch Statements</a></li>
+<li><a href="statements.html#_debugger-statement">9.1.9. Debugger Statement</a></li>
+</ul>
+</li>
+<li><a href="statements.html#_ecmascript-6-statements">9.2. ECMAScript 6 Statements</a>
+<ul class="sectlevel3">
+<li><a href="statements.html#_let">9.2.1. Let</a></li>
+<li><a href="statements.html#_const">9.2.2. Const</a></li>
+<li><a href="statements.html#_for-of-statement">9.2.3. <code>for &#8230;&#8203; of</code> statement</a></li>
+<li><a href="statements.html#_import-statement">9.2.4. Import Statement</a>
+<ul class="sectlevel4">
+<li><a href="statements.html#Dynamic_Imports">9.2.4.1. Dynamic Imports</a></li>
+<li><a href="statements.html#_immutabilaty-of-imports">9.2.4.2. Immutabilaty of Imports</a></li>
+</ul>
+</li>
+<li><a href="statements.html#_export-statement">9.2.5. Export Statement</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="annotations.html#_annotations">10. Annotations</a>
+<ul class="sectlevel2">
+<li><a href="annotations.html#_introduction-2">10.1. Introduction</a>
+<ul class="sectlevel3">
+<li><a href="annotations.html#_syntax-13">10.1.1. Syntax</a></li>
+<li><a href="annotations.html#_properties-7">10.1.2. Properties</a></li>
+<li><a href="annotations.html#_element-specific-annotations">10.1.3. Element-Specific Annotations</a></li>
+<li><a href="annotations.html#_general-annotations">10.1.4. General Annotations</a>
+<ul class="sectlevel4">
+<li><a href="annotations.html#_idebug">10.1.4.1. IDEBUG</a></li>
+</ul>
+</li>
+<li><a href="annotations.html#idebug-syntax">10.1.5. Syntax</a>
+<ul class="sectlevel4">
+<li><a href="annotations.html#_semantics-11">10.1.5.1. Semantics</a></li>
+<li><a href="annotations.html#_suppress-warnings">10.1.5.2. Suppress Warnings</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="annotations.html#_declaration-of-annotations">10.2. Declaration of Annotations</a></li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_extended-fetaures">11. Extended Fetaures</a>
+<ul class="sectlevel2">
+<li><a href="extended_fetaures.html#_array-and-object-destructuring">11.1. Array and Object Destructuring</a>
+<ul class="sectlevel3">
+<li><a href="extended_fetaures.html#_syntax-14">11.1.1. Syntax</a></li>
+<li><a href="extended_fetaures.html#_semantics-12">11.1.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_dependency-injection">11.2. Dependency Injection</a>
+<ul class="sectlevel3">
+<li><a href="extended_fetaures.html#_di-components-and-injectors">11.2.1. DI Components and Injectors</a>
+<ul class="sectlevel4">
+<li><a href="extended_fetaures.html#_dicomponent-relations">11.2.1.1. DIComponent Relations</a></li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_binders-and-bindings">11.2.2. Binders and Bindings</a></li>
+<li><a href="extended_fetaures.html#_injection-points">11.2.3. Injection Points</a>
+<ul class="sectlevel4">
+<li><a href="extended_fetaures.html#_field-injection">11.2.3.1. Field Injection</a></li>
+<li><a href="extended_fetaures.html#_constructor-injection">11.2.3.2. Constructor Injection</a></li>
+<li><a href="extended_fetaures.html#_method-injection">11.2.3.3. Method Injection</a>
+<ul class="sectlevel5">
+<li><a href="extended_fetaures.html#_provider">11.2.3.3.1. Provider</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_n4js-di-life-cycle-and-scopes">11.2.4. N4JS DI Life Cycle and Scopes</a>
+<ul class="sectlevel4">
+<li><a href="extended_fetaures.html#_injection-cylces">11.2.4.1. Injection Cylces</a></li>
+<li><a href="extended_fetaures.html#_default-scope">11.2.4.2. Default Scope</a></li>
+<li><a href="extended_fetaures.html#_singleton-scope">11.2.4.3. Singleton Scope</a></li>
+<li><a href="extended_fetaures.html#_per-injection-chain-singleton">11.2.4.4. Per Injection Chain Singleton</a></li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_validation-of-callsites-targeting-n4injector-methods">11.2.5. Validation of callsites targeting N4Injector methods</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-annotations">11.2.6. N4JS DI Annotations</a>
+<ul class="sectlevel4">
+<li><a href="extended_fetaures.html#_n4js-di-generateinjector">11.2.6.1. N4JS DI @GenerateInjector</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-withparentinjector">11.2.6.2. N4JS DI @WithParentInjector</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-usebinder">11.2.6.3. N4JS DI @UseBinder</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-binder">11.2.6.4. N4JS DI @Binder</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-bind">11.2.6.5. N4JS DI @Bind</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-provides">11.2.6.6. N4JS DI @Provides</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-inject">11.2.6.7. N4JS DI @Inject</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-singleton">11.2.6.8. N4JS DI @Singleton</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_test-support">11.3. Test Support</a></li>
+<li><a href="extended_fetaures.html#_polyfill-definitions">11.4. Polyfill Definitions</a>
+<ul class="sectlevel3">
+<li><a href="extended_fetaures.html#_runtime-polyfill-definitions">11.4.1. Runtime Polyfill Definitions</a></li>
+<li><a href="extended_fetaures.html#_static-polyfill-definitions">11.4.2. Static Polyfill Definitions</a></li>
+<li><a href="extended_fetaures.html#_transpiling-static-polyfilled-classes">11.4.3. Transpiling static polyfilled classes</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="components.html#_components">12. Components</a>
+<ul class="sectlevel2">
+<li><a href="components.html#_overview-2">12.1. Overview</a></li>
+<li><a href="components.html#Component_Types">12.2. Component Types</a>
+<ul class="sectlevel3">
+<li><a href="components.html#_libraries">12.2.1. Libraries</a></li>
+<li><a href="components.html#_runtime-environment-and-runtime-libraries">12.2.2. Runtime Environment and Runtime Libraries</a></li>
+<li><a href="components.html#_tests">12.2.3. Tests</a></li>
+<li><a href="components.html#_type-definitions">12.2.4. Type Definitions</a></li>
+</ul>
+</li>
+<li><a href="components.html#package-json">12.3. Package.json File</a>
+<ul class="sectlevel3">
+<li><a href="components.html#_basic-properties">12.3.1. Basic Properties</a></li>
+<li><a href="components.html#_n4js-properties">12.3.2. N4JS Properties</a></li>
+<li><a href="components.html#_constraints">12.3.3. Constraints</a></li>
+</ul>
+</li>
+<li><a href="components.html#_support-for-npm-scopes">12.4. Support for NPM Scopes</a></li>
+<li><a href="components.html#sec:N4JS-Type-Definitions">12.5. N4JS Type Definitions</a>
+<ul class="sectlevel3">
+<li><a href="components.html#_specify-type-definition">12.5.1. Specify Type Definition</a></li>
+<li><a href="components.html#_name-conventions">12.5.2. Name Conventions</a></li>
+<li><a href="components.html#_version-conventions">12.5.3. Version Conventions</a>
+<ul class="sectlevel4">
+<li><a href="components.html#_define-a-new-type-definition-package">12.5.3.1. Define a New Type Definition Package</a></li>
+<li><a href="components.html#_using-a-type-definition-package">12.5.3.2. Using a Type Definition Package</a></li>
+<li><a href="components.html#_rational">12.5.3.3. Rational</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="components.html#_modules">12.6. Modules</a></li>
+<li><a href="components.html#_api-and-implementation-component">12.7. API and Implementation Component</a>
+<ul class="sectlevel3">
+<li><a href="components.html#_execution-of-api-and-implementation-components">12.7.1. Execution of API and Implementation Components</a></li>
+<li><a href="components.html#_api-and-implementation-with-di">12.7.2. API and Implementation With DI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="plainjs.html#_plainjs">13. PlainJS</a>
+<ul class="sectlevel2">
+<li><a href="plainjs.html#_type-inference-and-validation-for-plain-js">13.1. Type Inference and Validation for Plain JS</a></li>
+<li><a href="plainjs.html#_external-declarations">13.2. External Declarations</a>
+<ul class="sectlevel3">
+<li><a href="plainjs.html#_declaring-externals">13.2.1. Declaring externals</a></li>
+<li><a href="plainjs.html#_instantiating-external-classes">13.2.2. Instantiating external classes</a></li>
+<li><a href="plainjs.html#_implementation-of-external-declarations">13.2.3. Implementation of External Declarations</a></li>
+<li><a href="plainjs.html#_example">13.2.4. Example</a></li>
+</ul>
+</li>
+<li><a href="plainjs.html#_global-definitions">13.3. Global Definitions</a></li>
+<li><a href="plainjs.html#_runtime-definitions">13.4. Runtime Definitions</a></li>
+<li><a href="plainjs.html#_applying-polyfills">13.5. Applying Polyfills</a></li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_jsdoc-2">14. JSDoc</a>
+<ul class="sectlevel2">
+<li><a href="jsdoc.html#_general-n4jsdoc-features">14.1. General N4JSDoc Features</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#_provided-inline-tags">14.1.1. Provided Inline Tags</a>
+<ul class="sectlevel4">
+<li><a href="jsdoc.html#jsdoc_tag__code">14.1.1.1. @code</a></li>
+<li><a href="jsdoc.html#jsdoc_tag__link">14.1.1.2. @link</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_n4jsdoc-for-user-projects">14.2. N4JSdoc for User Projects</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#_standard-tags">14.2.1. Standard Tags</a>
+<ul class="sectlevel4">
+<li><a href="jsdoc.html#_-author">14.2.1.1. @author</a></li>
+<li><a href="jsdoc.html#jsdoc_tag_param">14.2.1.2. @param</a></li>
+<li><a href="jsdoc.html#jsdoc_tag_return">14.2.1.3. @return</a></li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_test-related-tags">14.2.2. Test Related Tags</a>
+<ul class="sectlevel4">
+<li><a href="jsdoc.html#jsdoc_tag__testee">14.2.2.1. @testee</a></li>
+<li><a href="jsdoc.html#jsdoc_tag__testeeFromType">14.2.2.2. @testeeFromType</a></li>
+<li><a href="jsdoc.html#_testeeType_and__testeeMember">14.2.2.3. @testeeType and @testeeMember</a></li>
+<li><a href="jsdoc.html#jsdoc_tag_reqid_in_Tests">14.2.2.4. @reqid in Tests</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_n4jsdoc-for-api-and-implementation-projects">14.3. N4JSDoc for API and Implementation Projects</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#jsdoc_tag__apiNote">14.3.1. @apiNote</a></li>
+<li><a href="jsdoc.html#API_Project_Tags">14.3.2. API Project Tags</a>
+<ul class="sectlevel4">
+<li><a href="jsdoc.html#jsdoc_tag_apiState">14.3.2.1. @apiState</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsx.html#_jsx">15. JSX</a>
+<ul class="sectlevel2">
+<li><a href="jsx.html#_jsx-support">15.1. JSX Support</a></li>
+<li><a href="jsx.html#_jsx-backend">15.2. JSX Backend</a></li>
+</ul>
+</li>
+<li><a href="grammars.html#_grammars">16. Grammars</a>
+<ul class="sectlevel2">
+<li><a href="grammars.html#_type-expressions-grammar">16.1. Type Expressions Grammar</a></li>
+<li><a href="grammars.html#_n4js-language-grammar">16.2. N4JS Language Grammar</a></li>
+</ul>
+</li>
+<li><a href="jsobjects.html#_jsobjects">17. JSObjects</a>
+<ul class="sectlevel2">
+<li><a href="jsobjects.html#_object">17.1. Object</a></li>
+<li><a href="jsobjects.html#_string">17.2. String</a></li>
+<li><a href="jsobjects.html#_boolean">17.3. Boolean</a></li>
+<li><a href="jsobjects.html#_number">17.4. Number</a>
+<ul class="sectlevel3">
+<li><a href="jsobjects.html#_static-attributes">17.4.1. Static Attributes</a></li>
+</ul>
+</li>
+<li><a href="jsobjects.html#function">17.5. Function</a></li>
+<li><a href="jsobjects.html#_error">17.6. Error</a></li>
+<li><a href="jsobjects.html#_array">17.7. Array</a></li>
+<li><a href="jsobjects.html#_date">17.8. Date</a></li>
+<li><a href="jsobjects.html#_math">17.9. Math</a>
+<ul class="sectlevel3">
+<li><a href="jsobjects.html#static-attributes-1">17.9.1. Static Attributes</a></li>
+</ul>
+</li>
+<li><a href="jsobjects.html#_regexp">17.10. RegExp</a></li>
+<li><a href="jsobjects.html#_json">17.11. JSON</a></li>
+</ul>
+</li>
+<li><a href="n4js_objects.html#_n4js-objects">18. N4JS Objects</a>
+<ul class="sectlevel2">
+<li><a href="n4js_objects.html#_reflection-model">18.1. Reflection Model</a></li>
+<li><a href="n4js_objects.html#_error-types">18.2. Error Types</a>
+<ul class="sectlevel3">
+<li><a href="n4js_objects.html#_n4apinotimplemented">18.2.1. N4ApiNotImplemented</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_acronyms.html#_acronyms">Appendix A: Acronyms</a></li>
+<li><a href="appendix_b_license.html#sec:License">Appendix B: License</a></li>
+<li><a href="appendix_c_bibliography.html#_bibliography">Appendix C: Bibliography</a></li>
+</ul>
+</div>
+</div>
+<div id="content"><div class="sect1">
+<h2 id="_classifiers"><a class="anchor" href="#_classifiers"></a><a class="link" href="#_classifiers">5. Classifiers</a></h2>
+<div class="sectionbody">
+<div class="sect2">
+<h3 id="_n4js-specific-classifiers"><a class="anchor" href="#_n4js-specific-classifiers"></a><a class="link" href="#_n4js-specific-classifiers">5.1. N4JS Specific Classifiers</a></h3>
+<div class="paragraph">
+<p>N4JS provides three new metatypes: class, interface, and enums.
+In this section we describe classes and interfaces.
+These metatypes, called <em>classifiers</em>, share some common properties which are described before type specific properties are outlined in the following sections.</p>
+</div>
+<div class="paragraph">
+<p>All of these metatypes can be marked with type access modifiers:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">enum N4JSTypeAccessModifier: project | public;</code></pre>
+</div>
+</div>
+<div class="sect3 language-n4js">
+<h4 id="_properties-2"><a class="anchor" href="#_properties-2"></a><a class="link" href="#_properties-2">5.1.1. Properties</a></h4>
+<div class="paragraph">
+<p><strong>Properties defined by syntactic elements:</strong></p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><code>annotations</code> </dt>
+<dd>
+<p>Arbitrary annotations, see <a href="annotations.html#_annotations">Annotations</a> for details.</p>
+</dd>
+<dt class="hdlist1"><code>accessModifier</code> </dt>
+<dd>
+<p>N4JS type access modifier: <code>public</code>, or <code>project</code>;  <code>public</code> can be combined with <code>@Internal</code>; if
+<strong>export</strong> is <code>true</code> the default is else the default is <code>private</code>.</p>
+</dd>
+<dt class="hdlist1"><code>name</code> </dt>
+<dd>
+<p>The simple name of a classifier. If the classifier is defined by an anonymous class expression, an artificial but unique name is created.
+The name needs to be a valid identifier, see <a href="names.html#_valid-names">Valid Names</a>.</p>
+</dd>
+<dt class="hdlist1"><code>typePars</code> </dt>
+<dd>
+<p>Collection of type parameters of a generic classifier; empty by default.</p>
+</dd>
+<dt class="hdlist1"><code>ownedMembers</code> </dt>
+<dd>
+<p>Collection of owned members, i.e. methods and fields defined directly in the classifier and, if present, the explicitly defined constructor.
+Depending on the concrete classifier, additional constraints are defined.</p>
+</dd>
+<dt class="hdlist1"><code>typingStrategy</code> </dt>
+<dd>
+<p>The definition-site typing strategy. By default nominal typing is used.
+See <a href="#_structural-typing">Structural Typing</a> for details.</p>
+</dd>
+</dl>
+</div>
+<div class="paragraph">
+<p><strong>The following pseudo properties are defined via annotations:</strong></p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><code>export</code> </dt>
+<dd>
+<p>Boolean property set to true if the <code>export</code> modifier is set.
+If value is true, the classifier may be accessible outside the project.</p>
+</dd>
+<dt class="hdlist1"><code>final</code> </dt>
+<dd>
+<p>Boolean property which is set to final if annotation <code>@Final</code> is set.
+Also see <a href="#_final-modifier">Final Modifier</a></p>
+</dd>
+<dt class="hdlist1"><code>deprecated</code> </dt>
+<dd>
+<p>Boolean property set to true if annotation <code>@Deprecated</code> is set.</p>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title="Note"></i>
+</td>
+<td class="content">
+Version 0.4, not implemented in Version 0.3
+</td>
+</tr>
+</table>
+</div>
+</dd>
+</dl>
+</div>
+<div class="paragraph">
+<p><strong>We additionally define the following pseudo properties:</strong></p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><code>acc</code> </dt>
+<dd>
+<p>Type access modifier as described in <a href="names.html#_accessibility-of-types-top-level-variables-and-function-declarations">Accessibility of Types, Top-Level Variables and Function Declarations</a>, it is the aggregated value of the
+<code>accessModifier</code> and the <strong>export</strong> property.</p>
+</dd>
+<dt class="hdlist1"><code>owned{Fields|Methods|Getters|Setters|Accessors}</code> </dt>
+<dd>
+<p>Filters ownedMembers by metatype, short for<br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>x</mi><mo>∈</mo><mi>o</mi><mi>w</mi><mi>n</mi><mi>e</mi><mi>d</mi><mi>M</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi><mi>s</mi><mo>,</mo><mi>μ</mi><mfenced close=")" open="("><mi>x</mi></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>Field</mtext></mstyle></math> etc.</p>
+</dd>
+<dt class="hdlist1"><code>members</code> </dt>
+<dd>
+<p>Reflexive transitive closure of all members of a classifier and its super classifiers, see <a href="#_common-semantics-of-classifiers">Common Semantics of Classifiers</a> on how this is calculated.</p>
+</dd>
+<dt class="hdlist1"><code>fields|methods|getters|setters|accessors</code> </dt>
+<dd>
+<p>Filters members by metatype, short for<br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>x</mi><mo>∈</mo><mi>m</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi><mi>s</mi><mo>,</mo><mi>μ</mi><mfenced close=")" open="("><mi>x</mi></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>Field</mtext></mstyle></math> etc.</p>
+</dd>
+<dt class="hdlist1"><code>superClassifiers</code> </dt>
+<dd>
+<p>Classes and interface may extend or implement classes or interfaces.
+Any class or interface extended or interface implemented is called <em>super classifier</em>.
+We distinguish the directly subtyped classifiers and from the transitive closure of supertypes <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>s</mi><mi>u</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>C</mi><mi>l</mi><mi>a</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>f</mi><mi>i</mi><mi>e</mi><mi>r</mi><msup><mi>s</mi><mo>*</mo></msup></math></p>
+</dd>
+</dl>
+</div>
+</div>
+<div class="sect3 language-n4js">
+<h4 id="_common-semantics-of-classifiers"><a class="anchor" href="#_common-semantics-of-classifiers"></a><a class="link" href="#_common-semantics-of-classifiers">5.1.2. Common Semantics of Classifiers</a></h4>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-42"></a><strong>Req. IDE-42:</strong> <a href="#Req-IDE-42">Subtyping of Classifiers</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>For a given type <code>C</code>, and supertypes <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>s</mi><mi>u</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>C</mi><mi>l</mi><mi>a</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>f</mi><mi>i</mi><mi>e</mi><mi>r</mi><mi>s</mi><mo>=</mo><mfenced close="}" open="{"><msub><mi>S</mi><mn>1</mn></msub><mrow><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/></mrow><msub><mi>S</mi><mi>n</mi></msub></mfenced></math> directly subtyped
+<code>C</code>, the following constraints must be true:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>The supertypes must be accessible to the subtype:<br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>S</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>S</mi><mi>n</mi></msub></math> must be accessible to <code>C</code>.</p>
+</li>
+<li>
+<p>All type parameters of the direct supertypes have to be bound by type arguments in the subtype and the type arguments have to be substitutable types of the type parameters.</p>
+<div class="paragraph">
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∀</mo><mn>0</mn><mo>&lt;</mo><mi>i</mi><mo>≤</mo><mi>k</mi><mi>:</mi><mo>∀</mo><mi>P</mi><mo>∈</mo><msub><mi>S</mi><mi>i</mi></msub><mi>:</mi></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∃</mo><mi>A</mi><mo>∈</mo><msub><mi>C</mi><mo>.</mo></msub><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>A</mi><mi>r</mi><mi>g</mi><mi>s</mi><mi>:</mi><mi>b</mi><mi>i</mi><mi>n</mi><mi>d</mi><mfenced close=")" open="("><mi>A</mi><mi>P</mi></mfenced><mo>∧</mo><mi>A</mi><mo>.</mo><mi>u</mi><mi>p</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>B</mi><mi>o</mi><mi>u</mi><mi>n</mi><mi>d</mi><mo>&lt;</mo><mi>:</mi><mi>P</mi><mo>.</mo><mi>u</mi><mi>p</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>B</mi><mi>o</mi><mi>u</mi><mi>n</mi><mi>d</mi></math></p>
+</div>
+</li>
+<li>
+<p>Wildcards may not be used as type argument when binding a supertype’s type parameters.</p>
+</li>
+<li>
+<p>A classifier cannot be directly subtyped directly multiple times:<br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∀</mo><msub><mi>S</mi><mi>i</mi></msub><mo>,</mo><msub><mi>S</mi><mi>j</mi></msub><mfenced close=")" open="("><mi>i</mi><mrow><mi>j</mi><mo>∈</mo><mfenced close="}" open="{"><mrow><mn>1.</mn><mo>.</mo><mi>n</mi></mrow></mfenced></mrow></mfenced><mi>:</mi><msub><mi>S</mi><mi>i</mi></msub><mo>=</mo><msub><mi>S</mi><mi>j</mi></msub><mo>→</mo><mi>i</mi><mo>=</mo><mi>j</mi></math></p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>In order to simplify the following constraints, we use the pseudo property <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>m</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi><mi>s</mi></math> to refer to all members of a classifier.
+This includes all members directly declared by the classifier itself, i.e. the <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>o</mi><mi>w</mi><mi>n</mi><mi>e</mi><mi>d</mi><mi>M</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi></math>, and all members inherited from its super classifiers.
+The concrete mechanisms for inheriting a member are different and further constraint (cf. <a href="#_redefinition-of-members">Redefinition of Members</a>).
+A classifier only inherits its members from its direct supertypes, although the supertypes may contains members inherited from their supertypes.</p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3 language-n4js">
+<h4 id="_classes"><a class="anchor" href="#_classes"></a><a class="link" href="#_classes">5.1.3. Classes</a></h4>
+<div class="sect4">
+<h5 id="_definition-of-classes"><a class="anchor" href="#_definition-of-classes"></a><a class="link" href="#_definition-of-classes">5.1.3.1. Definition of Classes</a></h5>
+<div class="paragraph">
+<p>Classes are either declared with a class declaration on top level, or they can be used as anonymous classes in expressions.
+The latter may have a name, which may be used for error messages and reflection.</p>
+</div>
+<div class="paragraph">
+<p>At the current stage, class expressions are effectively disabled at least until the semantics of them are finalized in ECMAScript 6.</p>
+</div>
+<div class="paragraph">
+<p>In N4JS (as in many other languages) multi-inheritance of classes is not supported.
+Although the <code>diamond problem</code> (of functions being defined in both superclasses) could be solved via union and intersection types, this would lead to problems when calling these super implementations.
+This is particularly an issue due to JavaScript not supporting
+multiple prototypes.<sup class="footnote">[<a id="_footnoteref_27" class="footnote" href="appendix_c_bibliography.html#_footnote_27" title="View footnote.">27</a>]</sup>
+Interfaces, however, allow for multi-inheritance. Since the former can also define functions with bodies, this is not a hard restriction.</p>
+</div>
+<div class="sect5">
+<h6 id="class-syntax"><a class="anchor" href="#class-syntax"></a><a class="link" href="#class-syntax">5.1.3.1.1. Syntax</a></h6>
+<div class="listingblock">
+<div class="title">Syntax N4 Class Declaration and Expression</div>
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">N4ClassDeclaration &lt;Yield&gt;:
+    =&gt;(
+        {N4ClassDeclaration}
+        annotations+=Annotation*
+        (declaredModifiers+=N4Modifier)*
+        'class' typingStrategy=TypingStrategyDefSiteOperator? name=BindingIdentifier&lt;Yield&gt;?
+    )
+    TypeVariables?
+    ClassExtendsClause&lt;Yield&gt;?
+    Members&lt;Yield&gt;
+;
+
+N4ClassExpression &lt;Yield&gt;:
+    {N4ClassExpression}
+    'class' name=BindingIdentifier&lt;Yield&gt;?
+    ClassExtendsClause&lt;Yield&gt;?
+    Members&lt;Yield&gt;;
+
+
+fragment ClassExtendsClause &lt;Yield&gt;*:
+    'extends' (
+          =&gt;superClassRef=ParameterizedTypeRefNominal ('implements' ClassImplementsList)?
+        | superClassExpression=LeftHandSideExpression&lt;Yield&gt;
+    )
+    | 'implements' ClassImplementsList
+;
+
+fragment ClassImplementsList*:
+    implementedInterfaceRefs+=ParameterizedTypeRefNominal
+    (',' implementedInterfaceRefs+=ParameterizedTypeRefNominal)*
+;
+
+fragment Members &lt;Yield&gt;*:
+    '{'
+    ownedMembers+=N4MemberDeclaration&lt;Yield&gt;*
+    '}'
+;</code></pre>
+</div>
+</div>
+</div>
+<div class="sect5">
+<h6 id="class-properties"><a class="anchor" href="#class-properties"></a><a class="link" href="#class-properties">5.1.3.1.2. Properties</a></h6>
+<div class="paragraph">
+<p>These are the properties of class, which can be specified by the user:
+Syntax N4 Class Declaration and Expression</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><code>abstract</code> </dt>
+<dd>
+<p>Boolean flag indicating whether class may be instantiable; default is <code>false</code>, see <a href="#_abstract-classes">Abstract Classes</a>.</p>
+</dd>
+<dt class="hdlist1"><code>external</code> </dt>
+<dd>
+<p>Boolean flag indicating whether class is a declaration without implementation or with an external (non-N4JS) implementation; default is <code>false</code>, see <a href="#_definition-site-structural-typing">Definition Site Structural Typing</a>.</p>
+</dd>
+<dt class="hdlist1"><code>defStructural</code> </dt>
+<dd>
+<p>Boolean flag indicating whether subtype relation uses nominal or structural typing, see <a href="#_definition-site-structural-typing">Definition Site Structural Typing</a> for details.</p>
+</dd>
+<dt class="hdlist1"><code>superType/sup</code> </dt>
+<dd>
+<p>The type referenced by <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>s</mi><mi>u</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi></math> is called direct superclass of a class, and vice versa the class is a direct subclass of <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>s</mi><mi>u</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi></math>.
+Instead of <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>s</mi><mi>u</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi></math>, we sometimes simply write <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>s</mi><mi>u</mi><mi>p</mi></math>.
+The derived set <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>s</mi><mi>u</mi><msup><mi>p</mi><mo>+</mo></msup></math> is defined as the transitive closures of all direct and indirect superclasses of a class.
+If no supertype is explicitly stated, classes are derived from <code>N4Object</code>.</p>
+</dd>
+<dt class="hdlist1"><code>implementedInterfaces</code>/<code>interfaces</code> </dt>
+<dd>
+<p>Collection of interfaces directly <em>implemented</em> by the class; empty by default.
+Instead of <code>implementedInterfaces</code>, we simply write <code>interfaces</code>.</p>
+</dd>
+<dt class="hdlist1"><code>ownedCtor</code> </dt>
+<dd>
+<p>Explicit constructor of a class (if any), see <a href="types.html#_constructor-and-classifier-type">Constructor and Classifier Type</a>.</p>
+</dd>
+</dl>
+</div>
+<div class="paragraph">
+<p>And we additionally define the following pseudo properties:</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><code>ctor</code> </dt>
+<dd>
+<p>Explicit or implicit constructor of a class, see <a href="types.html#_constructor-and-classifier-type">Constructor and Classifier Type</a>.</p>
+</dd>
+<dt class="hdlist1"><code>fields</code> </dt>
+<dd>
+<p>Further derived properties for retrieving all methods (property <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>m</mi><mi>e</mi><mi>t</mi><mi>h</mi><mi>o</mi><mi>d</mi><mi>s</mi></math>), fields (property <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>f</mi><mi>i</mi><mi>e</mi><mi>l</mi><mi>d</mi><mi>s</mi></math>), static
+members (property <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>c</mi><mi>O</mi><mi>w</mi><mi>n</mi><mi>e</mi><mi>d</mi><mi>M</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi><mi>s</mi></math>), etc. can easily be added by filtering properties <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>m</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi><mi>s</mi></math> or <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>o</mi><mi>w</mi><mi>n</mi><mi>e</mi><mi>d</mi><mi>M</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi><mi>s</mi></math>.</p>
+</dd>
+</dl>
+</div>
+</div>
+<div class="sect5">
+<h6 id="class-type-inference"><a class="anchor" href="#class-type-inference"></a><a class="link" href="#class-type-inference">5.1.3.1.3. Type Inference</a></h6>
+<div class="paragraph">
+<p>The type of a class declaration or class expression <code>C</code> (i.e., a class definition in general) is of type <code>constructor{C}</code> if it is not abstract,
+that is if it can be instantiated.
+If it is abstract, the type of the definition simply is <code>type{C}</code>:</p>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mtable><mtr><mtd><mfrac><mrow><mo>¬</mo><mi>C</mi><mo>.</mo><mi>a</mi><mi>b</mi><mi>s</mi><mi>t</mi><mi>r</mi><mi>a</mi><mi>c</mi><mi>t</mi></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mi>C</mi><mi>:</mi><mstyle mathvariant="monospace"><mtext>constructor</mtext></mstyle><mfenced close="}" open="{"><mi>C</mi></mfenced></mrow></mfrac></mtd></mtr><mtr><mtd><mfrac><mrow><mi>C</mi><mo>.</mo><mi>a</mi><mi>b</mi><mi>s</mi><mi>t</mi><mi>r</mi><mi>a</mi><mi>c</mi><mi>t</mi></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mi>C</mi><mi>:</mi><mstyle mathvariant="monospace"><mtext>type</mtext></mstyle><mfenced close="}" open="{"><mi>C</mi></mfenced></mrow></mfrac></mtd></mtr></mtable></math>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-43"></a><strong>Req. IDE-43:</strong> <a href="#Req-IDE-43">Structural and Nominal Supertypes</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>The type of supertypes and implemented interfaces is always the nominal type, even if the supertype is declared structurally.</p>
+</div>
+<div class="openblock">
+<div class="content">
+
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="class-semantics"><a class="anchor" href="#class-semantics"></a><a class="link" href="#class-semantics">5.1.3.2. Semantics</a></h5>
+<div class="paragraph">
+<p>This section deals with the (more or less) type-independent constraints on classes.</p>
+</div>
+<div class="paragraph">
+<p>Class expressions are not fully supported at the moment.</p>
+</div>
+<div class="openblock definition">
+<div class="content">
+<div class="paragraph">
+<p><a id="transitive_closure_of_members"></a><strong>Definition:</strong> <a href="#transitive_closure_of_members">Transitive closure of members</a></p>
+</div>
+<div class="paragraph">
+<p>The reflexive transitive closure of members of a class is indirectly defined by the override and implementation constraints defined in <a href="#_redefinition-of-members">Redefinition of Members</a>.</p>
+</div>
+<div class="paragraph">
+<p>Note that since overloading is forbidden, the following constraint is true <sup class="footnote">[<a id="_footnoteref_28" class="footnote" href="appendix_c_bibliography.html#_footnote_28" title="View footnote.">28</a>]</sup>:</p>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mo>∀</mo><msub><mi>m</mi><mn>1</mn></msub><mo>,</mo><msub><mi>m</mi><mn>2</mn></msub><mo>∈</mo><mi>m</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi><mi>s</mi><mi>:</mi><msub><mi>m</mi><mn>1</mn></msub><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><msub><mi>m</mi><mn>2</mn></msub><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>⇔</mo><msub><mi>m</mi><mn>1</mn></msub><mo>=</mo><msub><mi>m</mi><mn>2</mn></msub><mo>∨</mo><mi>a</mi><mi>c</mi><mi>c</mi><mi>e</mi><mi>s</mi><mi>s</mi><mi>o</mi><mi>r</mi><mi>P</mi><mi>a</mi><mi>i</mi><mi>r</mi><mfenced close=")" open="("><msub><mi>m</mi><mn>1</mn></msub><msub><mi>m</mi><mn>2</mn></msub></mfenced></math>
+</div>
+</div>
+<div class="paragraph">
+<p>Remarks: Class and method definition is quite similar to the proposed ECMAScript version 6 draft [<a href="appendix_c_bibliography.html#ECMA15a">ECMA15a(p.S13.5)</a>], except that an N4 class and members may contain</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>annotations, abstract and access modifiers</p>
+</li>
+<li>
+<p>fields</p>
+</li>
+<li>
+<p>types</p>
+</li>
+<li>
+<p>implemented interfaces</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Note that even <code>static</code> is used in ECMAScript 6.</p>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Mixing in members (i.e. interface’s methods with default implementation or fields) is similar to mixing in members from roles as defined in [<a href="appendix_c_bibliography.html#Dart13a">Dart13a(p.S9.1)</a>].
+It is also similar to default implementations in Java 8 [<a href="appendix_c_bibliography.html#Gosling15a">Gosling15a</a>].
+In Java, however, more constraints exist, (for example, methods of interfaces must be public).</p>
+</div>
+<div class="exampleblock">
+<div class="title">Example 29. Simple Class</div>
+<div class="content">
+<div class="paragraph">
+<p>This first example shows a very simple class with a field, a constructor and a method.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">class C {
+    data: any;
+
+    constructor(data: any) {
+        this.data = data;
+    }
+
+    foo(): void { }
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="exampleblock">
+<div class="title">Example 30. Extend and implement</div>
+<div class="content">
+<div class="paragraph">
+<p>The following example demonstrate how a class can extend a superclass and implement an interface.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">interface I {
+    foo(): void
+}
+class C{}
+class X extends C implements I {
+    @Override
+    foo(): void {}
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>A class <code>C</code> is a subtype of another classifier <code>S</code> (which can be a class or interface) if the other classifier <code>S</code> is (transitively) contained in the supertypes (superclasses or implemented interfaces) of the class:</p>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi><mo>=</mo><mi>r</mi><mi>i</mi><mi>g</mi><mi>h</mi><mi>t</mi></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mstyle mathvariant="monospace"><mtext>TClass</mtext></mstyle><mi> </mi><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mfenced close="]" open="["><mrow><mi>T</mi><mi>C</mi><mi>l</mi><mi>a</mi><mi>s</mi><mi>s</mi></mrow></mfenced><mi> </mi><mi>r</mi><mi>i</mi><mi>g</mi><mi>h</mi><mi>t</mi></mrow></mfrac><mfenced close="]" open="["><mrow><mi>s</mi><mi>h</mi><mi>o</mi><mi>r</mi><mi>t</mi><mi>c</mi><mi>u</mi><mi>t</mi></mrow></mfenced><mtext>
+</mtext></math>
+</div>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><mi>Γ</mi><mo>⊢</mo><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi><mo>.</mo><mi>s</mi><mi>u</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi><mo>.</mo><mi>d</mi><mi>e</mi><mi>c</mi><mi>l</mi><mi>a</mi><mi>r</mi><mi>e</mi><mi>d</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>r</mi><mi>i</mi><mi>g</mi><mi>h</mi><mi>t</mi></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mstyle mathvariant="monospace"><mtext>TClass</mtext></mstyle><mi> </mi><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mfenced close="]" open="["><mrow><mi>T</mi><mi>C</mi><mi>l</mi><mi>a</mi><mi>s</mi><mi>s</mi></mrow></mfenced><mi> </mi><mi>r</mi><mi>i</mi><mi>g</mi><mi>h</mi><mi>t</mi></mrow></mfrac></math>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-44"></a><strong>Req. IDE-44:</strong> <a href="#Req-IDE-44">Implicit Supertype of Classes</a> (ver. 1)</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>The implicit supertype of all classes is <code>N4Object</code>.
+All classes with no explicit supertype are inherited from <code>N4Object</code>.</p>
+</li>
+<li>
+<p>If the supertype is explicitly set to <code>Object</code>, then the class is not derived from <code>N4Object</code>.
+Meta-information is created similar to an <code>N4Object</code>-derived class.
+Usually, there is no reason to explicitly derive a class from <code>Object</code>.</p>
+</li>
+<li>
+<p>External classes are implicitly derived from , unless they are annotated with <code>@N4JS</code>(cf.<a href="plainjs.html#_external-declarations">External Declarations</a>).</p>
+</li>
+</ol>
+</div>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_final-modifier"><a class="anchor" href="#_final-modifier"></a><a class="link" href="#_final-modifier">5.1.3.3. Final Modifier</a></h5>
+<div class="paragraph">
+<p>Extensibility refers to whether a given classifier can be subtyped.
+Accessibility is a prerequisite for extensibility.
+If a type cannot be seen, it cannot be subclassed.
+The only modifier influencing the extensibility directly is the annotation <code>@Final</code>, which prevents all subtyping.
+The following table shows how to prevent other projects or vendors from subtyping by also restricting the accessibility of the constructor:</p>
+</div>
+<table class="tableblock frame-all grid-all spread">
+<caption class="title">Table 6. Extensibility of Types</caption>
+<colgroup>
+<col style="width: 62.5%;">
+<col style="width: 12.5%;">
+<col style="width: 12.5%;">
+<col style="width: 12.5%;">
+</colgroup>
+<thead>
+<tr>
+<th class="tableblock halign-center valign-top">Type <code>C</code> Settings</th>
+<th class="tableblock halign-center valign-top" colspan="3">Subclassed in</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><strong>Project</strong></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><strong>Vendor</strong></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><strong>World</strong></p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>C.final</code></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">no</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">no</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">no</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>C.ctor.accessModifier=\lenum{project}</code></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">yes</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">no</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">no</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>C.ctor.accessModifier=\lenum{public@Internal}</code></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">yes</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">yes</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">no</p></td>
+</tr>
+</tbody>
+</table>
+<div class="paragraph">
+<p>Since interfaces are always to be implemented, they must not be declared final.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_abstract-classes"><a class="anchor" href="#_abstract-classes"></a><a class="link" href="#_abstract-classes">5.1.3.4. Abstract Classes</a></h5>
+<div class="paragraph">
+<p>A class with modifier <code>abstract</code> is called an <em>abstract class</em> and has its <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>a</mi><mi>b</mi><mi>s</mi><mi>t</mi><mi>r</mi><mi>a</mi><mi>c</mi><mi>t</mi></math> property set to true.
+Other classes are called <em>concrete</em> classes.</p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-45"></a><strong>Req. IDE-45:</strong> <a href="#Req-IDE-45">Abstract Class</a> (ver. 1)</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>A class <code>C</code> must be declared abstract if it owns or inherits one or more abstract members and neither C nor any interfaces implemented by C implements these members.
+A concrete class has to, therefore, implement all abstract members of its superclasses’ implemented interfaces.
+Note that a class may implement fields with field accessors and vice versa.</p>
+</li>
+<li>
+<p>An abstract class may not be instantiated.</p>
+</li>
+<li>
+<p>An abstract class cannot be set to final (with annotation <code>@Final</code>).</p>
+</li>
+</ol>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-46"></a><strong>Req. IDE-46:</strong> <a href="#Req-IDE-46">Abstract Member</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p></p>
+</div>
+<div class="sidebarblock">
+<div class="content">
+<a href="https://github.com/eclipse/n4js/issues/1047" class="gray" title="GitHub Issues"><span class="image"><img src="images/issue.svg" alt=""></span> #1047</a>
+</div>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>A member declared as abstract must not have a method body (in contrary a method not declared as abstract have to have a method body).</p>
+</li>
+<li>
+<p>Only methods, getters and setters can be declared as abstract (fields cannot be abstract).</p>
+</li>
+<li>
+<p>It is not possible to inherit from an abstract class which contains abstract members which are not visible in the subclass.</p>
+</li>
+<li>
+<p>An abstract member must not be set to final (with annotation <code>@Final</code>).</p>
+</li>
+<li>
+<p>Static members must not be declared abstract.</p>
+</li>
+</ol>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Remarks:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>We decided to disallow abstract static members, since we cannot guarantee that a static members is not accessed in all cases</p>
+</li>
+<li>
+<p>Only static members can override static members and only instance members can override other instance members of course.</p>
+</li>
+<li>
+<p>An abstract member must not be declared in a final class (i.e. a class annotated with <code>@Final</code>). This is not explicitly defined as constraint in <a href="#Req-IDE-46">[Req-IDE-46]</a> since abstract classes must not defined final anyway. We also do not produce error message for abstract members in final classes since these errors would be consequential errors.</p>
+</li>
+</ul>
+</div>
+<div class="admonitionblock warning">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-warning" title=""></i>
+</td>
+<td class="content">
+Abstract members might be declared private, as they can be accessed from within the module.
+This is to be changed in order to be aligned with TypeScript, cf. <a href="https://github.com/eclipse/n4js/issues/1221" class="gray" title="GitHub Issues"><span class="image"><img src="images/issue.svg" alt=""></span> #1221</a>. However we also want to add class expressions&#8201;&#8212;&#8201;and then the abstract members may be accessed (and overridden) in nested classes created by means of class expressions.
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_non-instantiable-classes"><a class="anchor" href="#_non-instantiable-classes"></a><a class="link" href="#_non-instantiable-classes">5.1.3.5. Non-Instantiable Classes</a></h5>
+<div class="paragraph">
+<p>To make a class non-instantiable outside a defining compilation unit, i.e. disallow creation of instances for this class, simply declare the constructor as private.
+This can be used for singletons.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_superclass"><a class="anchor" href="#_superclass"></a><a class="link" href="#_superclass">5.1.3.6. Superclass</a></h5>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-47"></a><strong>Req. IDE-47:</strong> <a href="#Req-IDE-47">Superclass</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>For a class <code>C</code> with a supertype <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>S</mi><mo>=</mo><mi>C</mi><mo>.</mo><mi>s</mi><mi>u</mi><mi>p</mi></math>, the following constraints must hold;</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>C</mi><mo>.</mo><mi>s</mi><mi>u</mi><mi>p</mi></math> must reference a class declaration <code>S</code></p>
+</li>
+<li>
+<p><code>S</code> must be be extendable in the project of <code>C</code></p>
+</li>
+<li>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>C</mi><mo>∉</mo><mi>C</mi><mo>.</mo><mi>s</mi><mi>u</mi><msup><mi>p</mi><mo>+</mo></msup></math></p>
+</li>
+<li>
+<p>All abstract members in <code>S</code> must be accessible from <code>C</code>:</p>
+<div class="paragraph">
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∀</mo><mi>M</mi><mo>∈</mo><mi>S</mi><mo>.</mo><mi>m</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi><mi>s</mi><mi>:</mi><mi>M</mi><mo>.</mo><mi>a</mi><mi>b</mi><mi>s</mi><mi>t</mi><mi>r</mi><mi>a</mi><mi>c</mi><mi>t</mi><mo>⇒</mo></math><br>
+<code>M</code> is accessible from <code>C</code>.<br>
+Note that <code>M</code> need not be an owned member of <code>S</code> and that this constraint applies even if <code>C</code> is abstract).</p>
+</div>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>All members of superclasses become members of a class.
+This is true even if the owning classes are not directly accessible to a class.
+The member-specific access control is not changed.</p>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3 language-n4js">
+<h4 id="_interfaces"><a class="anchor" href="#_interfaces"></a><a class="link" href="#_interfaces">5.1.4. Interfaces</a></h4>
+<div class="sect4">
+<h5 id="_definition-of-interfaces"><a class="anchor" href="#_definition-of-interfaces"></a><a class="link" href="#_definition-of-interfaces">5.1.4.1. Definition of Interfaces</a></h5>
+<div class="sect5">
+<h6 id="interfaces-syntax"><a class="anchor" href="#interfaces-syntax"></a><a class="link" href="#interfaces-syntax">5.1.4.1.1. Syntax</a></h6>
+<div class="listingblock">
+<div class="title">Syntax N4 Interface Declaration</div>
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">N4InterfaceDeclaration &lt;Yield&gt;:
+    =&gt; (
+        {N4InterfaceDeclaration}
+        annotations+=Annotation*
+        (declaredModifiers+=N4Modifier)*
+        'interface' typingStrategy=TypingStrategyDefSiteOperator? name=BindingIdentifier&lt;Yield&gt;?
+    )
+    TypeVariables?
+    InterfaceImplementsList?
+    Members&lt;Yield&gt;
+;
+
+fragment InterfaceImplementsList*:
+    'implements' superInterfaceRefs+=ParameterizedTypeRefNominal
+        (',' superInterfaceRefs+=ParameterizedTypeRefNominal)*
+;</code></pre>
+</div>
+</div>
+</div>
+<div class="sect5">
+<h6 id="interfaces-properties"><a class="anchor" href="#interfaces-properties"></a><a class="link" href="#interfaces-properties">5.1.4.1.2. Properties</a></h6>
+<div class="paragraph">
+<p>These are the additional properties of interfaces, which can be specified by the user:</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><code>superInterfaces</code></dt>
+<dd>
+<p>Collection of interfaces extended by this interface; empty by default.
+Instead of <code>superInterfaces</code>, we simply write <code>interfaces</code>.</p>
+</dd>
+</dl>
+</div>
+</div>
+<div class="sect5">
+<h6 id="interfaces-type-inference"><a class="anchor" href="#interfaces-type-inference"></a><a class="link" href="#interfaces-type-inference">5.1.4.1.3. Type Inference</a></h6>
+<div class="paragraph">
+<p>The type of an interface declaration <code>I</code> is of type <code>type{I}</code>:</p>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow/><mrow><mi>Γ</mi><mo>⊢</mo><mi>I</mi><mi>:</mi><mstyle mathvariant="monospace"><mtext>type</mtext></mstyle><mfenced close="}" open="{"><mi>I</mi></mfenced></mrow></mfrac></math>
+</div>
+</div>
+</div>
+<div class="sect5">
+<h6 id="interfaces-semantics"><a class="anchor" href="#interfaces-semantics"></a><a class="link" href="#interfaces-semantics">5.1.4.1.4. Semantics</a></h6>
+<div class="paragraph">
+<p>Interfaces are used to describe the public <a href="appendix_a_acronyms.html#_acronyms">API</a> of a classifier.
+The main requirement is that the instance of an interface, which must be an instance of a class since interfaces cannot have instances, provides all members declared in the interface.
+Thus, a (concrete) class implementing an interface must provide implementations for all the fields, methods, getters and setters of the interface (otherwise it the class must be declared abstract).
+The implementations have to be provided either directly in the class itself, through a superclass, or by the interface if the member has a default implementation.</p>
+</div>
+<div class="paragraph">
+<p>A field declaration in an interface denotes that all implementing classes can either provide a field of the same name and the same(!) type or corresponding field accessors.
+If no such members are defined in the class or a (transitive) superclass, the field is mixed in from the interface automatically.
+This is also true for the initializer of the field.</p>
+</div>
+<div class="paragraph">
+<p>All instance methods, getters and setters declared in an interface are implicitly abstract if they do not provide a default implementation.
+The modifier <code>abstract</code> is not required, therefore, in the source code.
+The following constraints apply:</p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-48"></a><strong>Req. IDE-48:</strong> <a href="#Req-IDE-48">Interfaces</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>For any interface <code>I</code>, the following must hold:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Interfaces may not be instantiated.</p>
+</li>
+<li>
+<p>Interfaces cannot be set to final (with annotation @Final): <math xmlns="http://www.w3.org/1998/Math/MathML"><mo>¬</mo><mi>I</mi><mo>.</mo><mi>f</mi><mi>i</mi><mi>n</mi><mi>a</mi><mi>l</mi></math>.</p>
+</li>
+<li>
+<p>Members of an interface must not be declared private.
+The default access modifier in interfaces is the the type’s visibility or <code>project</code>, if the type’s visibility is <code>private</code>.</p>
+</li>
+<li>
+<p>Members of an interface, except methods, must not be declared <code>@Final</code>:</p>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mo>∀</mo><mi>m</mi><mo>∈</mo><mi>I</mi><mo>.</mo><mi>m</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi><mi>:</mi><mi>m</mi><mo>.</mo><mi>f</mi><mi>i</mi><mi>n</mi><mi>a</mi><mi>l</mi><mo>→</mo><mi>m</mi><mo>∈</mo><mi>I</mi><mo>.</mo><mi>m</mi><mi>e</mi><mi>t</mi><mi>h</mi><mi>o</mi><mi>d</mi><mi>s</mi></math>
+</div>
+</div>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title=""></i>
+</td>
+<td class="content">
+not allowing field accessors to be declared final was a deliberate decision, because it would complicate the internal handling of member redefinition; might be reconsidered at a later time
+</td>
+</tr>
+</table>
+</div>
+</li>
+<li>
+<p>The literal may not be used in the initializer expression of a field of an interface.<br>
+This restriction is required, because the order of implementation of these fields in an implementing class cannot be guaranteed.
+This applies to both instance and static fields in interfaces, but in case of static fields, <code>this</code> is also disallowed due to <a href="#_static-members-of-interfaces">Static Members of Interfaces</a>.</p>
+</li>
+</ol>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>It is possible to declare members in interfaces with a smaller visibility as the interface itself.
+In that case, clients of the interface may be able to use the interface but not to implement it.</p>
+</div>
+<div class="paragraph">
+<p>In order to simplify modeling of runtime types, such as elements, interfaces do not only support the notation of static methods but constant data fields as well.
+Since <a href="appendix_a_acronyms.html#_acronyms">IDL</a> [<a href="appendix_c_bibliography.html#OMG14a">OMG14a</a>] is used to describe these elements in specifications (and mapped to JavaScript via rules described in [<a href="appendix_c_bibliography.html#W3C12a">W3C12a</a>])
+constant data fields are an often-used technique there and they can be modeled in N4JS 1:1.</p>
+</div>
+<div class="paragraph">
+<p>As specified in <a href="#Req-IDE-56">[Req-IDE-56]</a>, interfaces cannot contain a constructor i.e.<br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∀</mo><mi>m</mi><mo>∈</mo><mi>I</mi><mo>.</mo><mi>o</mi><mi>w</mi><mi>n</mi><mi>e</mi><mi>d</mi><mi>M</mi><mi>e</mi><mi>t</mi><mi>h</mi><mi>o</mi><mi>d</mi><mi>s</mi><mi>:</mi><mi>m</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><msup><mo>≠</mo><mi>'</mi></msup><mi>c</mi><mi>o</mi><mi>n</mi><mi>s</mi><mi>t</mi><mi>r</mi><mi>u</mi><mi>c</mi><mi>t</mi><mi>o</mi><msup><mi>r</mi><mi>'</mi></msup></math>.</p>
+</div>
+<div class="exampleblock">
+<div class="title">Example 31. Simple Interfaces</div>
+<div class="content">
+<div class="paragraph">
+<p>The following example shows the syntax for defining interfaces.
+The second interface extends the first one.
+Note that methods are implicitly defined abstract in interfaces.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">interface I {
+    foo(): void
+}
+interface I2 extends I {
+    someText: string;
+    bar(): void
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>If a classifier <code>C</code> <em>implements</em> an interface <code>I</code>, we say <code>I</code> is <em>implemented</em> by <code>C</code>.
+If <code>C</code> redefines members declared in <code>I</code>, we say that these members are <em>implemented</em> by <code>C</code>.
+Members not redefined by <code>C</code> but with a default implementations are <em>mixed in</em> or <em>consumed by</em> <code>C</code>.
+We all cases we call <code>C</code> the <em>implementor</em>.</p>
+</div>
+<div class="paragraph">
+<p>Besides the general constraints described in <a href="#_common-semantics-of-classifiers">Common Semantics of Classifiers</a>, the following constraints must hold for extending or implementing interfaces:</p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-49"></a><strong>Req. IDE-49:</strong> <a href="#Req-IDE-49">Extending Interfaces</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>For a given type
+<code>I</code>, and <math xmlns="http://www.w3.org/1998/Math/MathML"><mfenced close="}" open="{"><msub><mi>I</mi><mn>1</mn></msub><mrow><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/></mrow><msub><mi>I</mi><mi>n</mi></msub></mfenced></math> directly extended by <code>I</code>, the following constraints must be true:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Only interfaces can extend interfaces: <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>I</mi><mo>,</mo><msub><mi>I</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>I</mi><mi>n</mi></msub></math> must be interfaces.</p>
+</li>
+<li>
+<p>An interface may not directly extend the same interface more than once:<br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>I</mi><mi>i</mi></msub><mo>=</mo><msub><mi>I</mi><mi>j</mi></msub><mo>→</mo><mi>i</mi><mo>=</mo><mi>j</mi></math> for any
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>i</mi><mo>,</mo><mi>j</mi><mo>∈</mo><mfenced close="}" open="{"><mrow><mn>1</mn><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mi>n</mi></mrow></mfenced></math>.</p>
+</li>
+<li>
+<p>An interface may (indirectly) extend the same interface <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>J</mi></math> more than once only if</p>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>J</mi></math> is not parameterized, or</p>
+</li>
+<li>
+<p>in all cases <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>J</mi></math> is extended with the same type arguments for all invariant type parameters.<br>
+Note that for type parameters of <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>J</mi></math> that are declared covariant or contravariant on definition site, different type arguments may be used.</p>
+</li>
+</ol>
+</div>
+</li>
+<li>
+<p>All abstract members in <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>I</mi><mi>i</mi></msub></math>, <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>i</mi><mo>∈</mo><mfenced close="}" open="{"><mn>1</mn><mrow><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/></mrow><mi>n</mi></mfenced></math>, must be accessible from <code>I</code>:<br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∀</mo><mi>i</mi><mo>∈</mo><mfenced close="}" open="{"><mn>1</mn><mrow><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/></mrow><mi>n</mi></mfenced><mi>:</mi><mi>M</mi><mo>∈</mo><msub><mi>I</mi><mi>i</mi></msub><mo>.</mo><mi>m</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi><mi>s</mi><mo>∧</mo><mi>M</mi><mo>.</mo><mi>a</mi><mi>b</mi><mi>s</mi><mi>t</mi><mi>r</mi><mi>a</mi><mi>c</mi><mi>t</mi><mo>→</mo></math> <code>M</code> is accessible from <code>I</code>.<br>
+Note that <code>M</code> need not be an owned member of <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>I</mi><mi>i</mi></msub></math>.</p>
+</li>
+</ol>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-50"></a><strong>Req. IDE-50:</strong> <a href="#Req-IDE-50">Implementing Interfaces</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>For a given type
+<code>C</code>, and <math xmlns="http://www.w3.org/1998/Math/MathML"><mfenced close="}" open="{"><msub><mi>I</mi><mn>1</mn></msub><mrow><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/></mrow><msub><mi>I</mi><mi>n</mi></msub></mfenced></math> directly implemented
+by <code>C</code>, the following constraints must be true:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Only classes can implement interfaces: <code>C</code> must be a Class.</p>
+</li>
+<li>
+<p>A class can only implement interfaces: <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>I</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>I</mi><mi>n</mi></msub></math> must be interfaces.</p>
+</li>
+<li>
+<p>A class may not directly implement the same interface more than once:<br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>I</mi><mi>i</mi></msub><mo>=</mo><msub><mi>I</mi><mi>j</mi></msub><mo>⇒</mo><mi>i</mi><mo>=</mo><mi>j</mi></math> for any <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>i</mi><mo>,</mo><mi>j</mi><mo>∈</mo><mfenced close="}" open="{"><mn>1</mn><mrow><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/></mrow><mi>n</mi></mfenced></math>.</p>
+</li>
+<li>
+<p>A class may (indirectly) implement the same interface <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>J</mi></math> more than once only if</p>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>J</mi></math> is not parameterized, or</p>
+</li>
+<li>
+<p>in all cases <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>J</mi></math> is implemented with the same type arguments for all invariant type parameters.<br>
+Note that for type parameters of <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>J</mi></math> that are declared covariant or contravariant on definition site, different type arguments may be used.</p>
+</li>
+</ol>
+</div>
+</li>
+<li>
+<p>All abstract members in <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>I</mi><mi>i</mi></msub></math>, <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>i</mi><mo>∈</mo><mfenced close="}" open="{"><mn>1</mn><mrow><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/></mrow><mi>n</mi></mfenced></math>, must be accessible from <code>C</code>:<br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∀</mo><mi>i</mi><mo>∈</mo><mfenced close="}" open="{"><mn>1</mn><mrow><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/></mrow><mi>n</mi></mfenced><mi>:</mi><mi>M</mi><mo>∈</mo><msub><mi>I</mi><mi>i</mi></msub><mo>.</mo><mi>m</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi><mi>s</mi><mo>∧</mo><mi>M</mi><mo>.</mo><mi>a</mi><mi>b</mi><mi>s</mi><mi>t</mi><mi>r</mi><mi>a</mi><mi>c</mi><mi>t</mi><mo>→</mo></math> <code>M</code> is accessible from <code>C</code>.<br>
+Note that <code>M</code> need not be an owned member of <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>I</mi><mi>i</mi></msub></math>.</p>
+</li>
+</ol>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>For default methods in interfaces, see <a href="#_default-methods-in-interfaces">Default Methods in Interfaces</a>.</p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3 language-n4js">
+<h4 id="_generic-classifiers"><a class="anchor" href="#_generic-classifiers"></a><a class="link" href="#_generic-classifiers">5.1.5. Generic Classifiers</a></h4>
+<div class="paragraph">
+<p>Classifiers can be declared generic by defining a type parameter via <code>type-param</code>.</p>
+</div>
+<div class="openblock definition">
+<div class="content">
+<div class="paragraph">
+<p><a id="generic_classifiers"></a><strong>Definition:</strong> <a href="#generic_classifiers">Generic Classifiers</a></p>
+</div>
+<div class="paragraph">
+<p>A generic classifier is a classifier with at least one type parameter.
+That is, a given classifier <code>C</code> is generic if and only if <math xmlns="http://www.w3.org/1998/Math/MathML"><mo>|</mo><mi>C</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>P</mi><mi>a</mi><mi>r</mi><mi>s</mi><mo>|</mo><mo>≥</mo><mn>1</mn></math>.</p>
+</div>
+<div class="paragraph">
+<p>If a classifier does not define any type parameters, it is not generic, even if its superclass or any implemented interface is generic.</p>
+</div>
+<div class="paragraph">
+<p>The format of the type parameter expression is described in <a href="types.html#_parameterized-types">Parameterized Types</a>.
+The type variable defined by the type parameter’s type expression can be used just like a normal type inside the class definition.</p>
+</div>
+<div class="paragraph">
+<p>If using a generic classifier as type of a variable, it may be parameterized.
+This is usually done via a type expression (cf. <a href="types.html#_parameterized-types">Parameterized Types</a>) or via <code>typearg</code> in case of supertypes.
+If a generic classifier defines multiple type variables, these variables are bound in the order of their definition.
+In any case, all type variables have to be bound.
+That means in particular that raw types are not allowed. (cf <a href="types.html#_parameterized-types">Parameterized Types</a> for details).</p>
+</div>
+<div class="paragraph">
+<p>If a generic classifier is used as super classifier, the type arguments can be type variables.
+Note that the type variable of the super classifier is not lifted, that is to say that all type variables are to be explicitly bound in the type references used in the <code>extend</code>, <code>with</code>, or <code>implements</code> section using <code>typearg</code>.
+If a type variable is used in <code>typearg</code> to bound a type variable of a type parameter, it has to fulfil possible type constraints (upper/lower bound) specified in the type parameter.</p>
+</div>
+</div>
+</div>
+<div class="exampleblock">
+<div class="title">Example 32. Generic Type Definition and Usage as Type of Variable</div>
+<div class="content">
+<div class="paragraph">
+<p>This example demonstrates how to define a generic type and how to refer to it in a variable definition.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">export class Container&lt;T&gt; {
+    private item: T;
+
+    getItem(): T {
+        return this.item;
+    }
+
+    setItem(item: T): void {
+        this.item = item;
+    }
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>This type can now be used as a type of a variable as follows</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">import Container from "p/Container"
+
+var stringContainer: Container&lt;string&gt; = new Container&lt;string&gt;();
+stringContainer.setItem("Hello");
+var s: string = stringContainer.getItem();</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>In line 3, the type variable <code>T</code> of the generic class <code>Container</code> is bound to <code>string</code>.</p>
+</div>
+<div class="exampleblock">
+<div class="title">Example 33. Binding of type variables with multiple types</div>
+<div class="content">
+<div class="paragraph">
+<p>For a given generic class <code>G</code></p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">class A{}
+class B{}
+class C extends A{}
+
+class G&lt;S, T extends A, U extends B&gt; {
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>the variable definition</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">var x: G&lt;Number,C,B&gt;;</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>would bind the type variables as follows:</p>
+</div>
+<table class="tableblock frame-all grid-all spread">
+<colgroup>
+<col style="width: 16.6666%;">
+<col style="width: 16.6666%;">
+<col style="width: 66.6668%;">
+</colgroup>
+<tbody>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>S</code></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>Number</code></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">Bound by first type argument, no bound constraints defined for <code>S</code>.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>T</code></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>C</code></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">Bound by second type argument, <code>C</code> must be a subtype of in order to fulfill the type constraint.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>U</code></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>B</code></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">Bound by third type argument, <code>extends</code> is reflexive, that is <code>B</code> fulfills the
+type constraint.</p></td>
+</tr>
+</tbody>
+</table>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-51"></a><strong>Req. IDE-51:</strong> <a href="#Req-IDE-51">Generic Superclass, Type Argument with Type Variable</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>For a given generic superclass <code>SuperClass</code></p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">class SuperClass&lt;S, T extends A, U extends B&gt; {};</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>and a generic subclass <code>SubClass</code></p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">class SubClass&lt;X extends A&gt; extends SuperClass&lt;Number, X, B&gt; {..};</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>the variable definition</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">var s: SubClass&lt;C&gt;;</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>would bind the type variables as follows:<br></p>
+</div>
+<table class="tableblock frame-all grid-all spread">
+<colgroup>
+<col style="width: 16.6666%;">
+<col style="width: 16.6666%;">
+<col style="width: 66.6668%;">
+</colgroup>
+<thead>
+<tr>
+<th class="tableblock halign-center valign-top">TypeVariable</th>
+<th class="tableblock halign-center valign-top">Bound to</th>
+<th class="tableblock halign-center valign-top">Explanation</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>SuperClass.S</code></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>Number</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Type variable <code>s</code> of supertype <code>SuperClass</code> is bound to <code>Number</code>.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>SuperClass.T</code></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>SubClass.X=C</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Type variable <code>T</code> of supertype <code>SuperClass</code> is bound to type variable <code>X</code> of <code>SubClass</code>. It gets
+then indirectly bound to <code>C</code> as specified by the type argument of the
+variable definition.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>SuperClass.U</code></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>B</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Type variable <code>U</code> of supertype <code>SuperClass</code> is auto-bound to <code>C</code> as no explicit binding for the third type variable is specified.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>SubClass.X</code></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>C</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Bound by first type argument specified in variable definition.</p></td>
+</tr>
+</tbody>
+</table>
+</div>
+</div>
+</div>
+<div class="sect3 language-n4js">
+<h4 id="sec:definition-site-variance"><a class="anchor" href="#sec:definition-site-variance"></a><a class="link" href="#sec:definition-site-variance">5.1.6. Definition-Site Variance</a></h4>
+<div class="paragraph">
+<p>In addition to use-site declaration of variance in the form of Java-like wildcards, N4JS provides support for definition-site declaration of variance as known from languages such as C# and Scala.</p>
+</div>
+<div class="paragraph">
+<p>The <em>variance</em> of a parameterized type states how its subtyping relates to its type arguments’ subtyping.
+For example, given a parameterized type <code>G&lt;T&gt;</code> and plain types <code>A</code> and <code>B</code>, we know</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>if <code>G</code> is <strong>covariant</strong> w.r.t. its parameter <code>T</code>, then</p>
+<div class="paragraph">
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mstyle mathvariant="monospace"><mtext>B</mtext></mstyle><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mstyle mathvariant="monospace"><mtext>A</mtext></mstyle><mo>→</mo><mstyle mathvariant="monospace"><mtext>G</mtext></mstyle><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>B</mtext></mstyle><mo>&gt;</mo><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mstyle mathvariant="monospace"><mtext>G</mtext></mstyle><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>A</mtext></mstyle><mo>&gt;</mo></math></p>
+</div>
+</li>
+<li>
+<p>if <code>G</code> is <strong>contravariant</strong> w.r.t. its parameter <code>T</code>, then</p>
+<div class="paragraph">
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mstyle mathvariant="monospace"><mtext>B</mtext></mstyle><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mstyle mathvariant="monospace"><mtext>A</mtext></mstyle><mo>→</mo><mstyle mathvariant="monospace"><mtext>G</mtext></mstyle><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>A</mtext></mstyle><mo>&gt;</mo><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mstyle mathvariant="monospace"><mtext>G</mtext></mstyle><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>B</mtext></mstyle><mo>&gt;</mo></math></p>
+</div>
+</li>
+<li>
+<p>if <code>G</code> is <strong>invariant</strong> w.r.t. its parameter <code>T</code>, then</p>
+<div class="paragraph">
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mstyle mathvariant="monospace"><mtext>B</mtext></mstyle><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mstyle mathvariant="monospace"><mtext>A</mtext></mstyle><mo>→</mo><mstyle mathvariant="monospace"><mtext>G</mtext></mstyle><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>A</mtext></mstyle><mo>&gt;</mo><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mstyle mathvariant="monospace"><mtext>G</mtext></mstyle><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>B</mtext></mstyle><mo>&gt;</mo></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mstyle mathvariant="monospace"><mtext>B</mtext></mstyle><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mstyle mathvariant="monospace"><mtext>A</mtext></mstyle><mo>→</mo><mstyle mathvariant="monospace"><mtext>G</mtext></mstyle><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>A</mtext></mstyle><mo>&gt;</mo><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mstyle mathvariant="monospace"><mtext>G</mtext></mstyle><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>B</mtext></mstyle><mo>&gt;</mo></math></p>
+</div>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Note that variance is declared per type parameter, so a single parameterized type with more than one type parameter may be, for example, covariant w.r.t. one type parameter and contravariant w.r.t. another.</p>
+</div>
+<div class="paragraph">
+<p>Strictly speaking, a type parameter/variable itself is not co- or contravariant;<br>
+however, for the sake of simplicity we say <em><code>T</code> is covariant</em> as a short form for <em><code>G</code> is covariant with respect to its type parameter <code>T</code></em> (for contravariant and invariant accordingly).</p>
+</div>
+<div class="paragraph">
+<p>To declare the variance of a parameterized classifier on definition site, simply add keyword <code>in</code> or <code>out</code> before the corresponding type parameter:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">class ReadOnlyList&lt;out T&gt; { // covariance
+    // ...
+}
+
+interface Consumer&lt;in T&gt; { // contravariance
+    // ...
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>In such cases, the following constraints apply.</p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-174"></a><strong>Req. IDE-174:</strong> <a href="#Req-IDE-174">Definition-Site Variance</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>Given a parameterized type with a type parameter , the following must hold:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p><code>T</code> may only appear in variance-compatible positions:</p>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p>if <code>T</code> is declared on definition site to be <strong>covariant</strong>, then it may only appear in covariant positions within the type’s non-private member declarations.</p>
+</li>
+<li>
+<p>if <code>T</code> is declared on definition site to be <strong>contravariant</strong>, then it may only appear in contravariant positions within the type’s non-private member declarations.</p>
+</li>
+<li>
+<p>if <code>T</code> is <strong>invariant</strong>, i.e. neither declared covariant nor declared contravariant on definition site, then it may appear in any position (where type variables are allowed).</p>
+<div class="paragraph">
+<p>Thus, no restrictions apply within the declaration of private members and within the body of field accessors and methods.</p>
+</div>
+</li>
+</ol>
+</div>
+</li>
+<li>
+<p>definition-site variance may not be combined with incompatible use-site variance:</p>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p>if <code>T</code> is declared on definition site to be <strong>covariant</strong>, then no wildcard with a <strong>lower</strong> bound may be provided as type argument for <code>T</code>.</p>
+</li>
+<li>
+<p>if <code>T</code> is declared on definition site to be <strong>contravariant</strong>, then no wildcard with an <strong>upper</strong> bound may be provided as type argument for <code>T</code>.</p>
+</li>
+<li>
+<p>if <code>T</code> is <strong>invariant</strong>, i.e. neither declared covariant nor declared contravariant on definition site, then any kind of wildcard may be provided as type argument.</p>
+<div class="paragraph">
+<p>Unbounded wildcards are allowed in all cases.</p>
+</div>
+</li>
+</ol>
+</div>
+</li>
+</ol>
+</div>
+</div>
+</div>
+<div id="ex:use-site-declaration-variance" class="exampleblock">
+<div class="title">Example 34. Use-site declaration of variance</div>
+<div class="content">
+<div class="paragraph">
+<p>For illustration purposes, let’s compare use-site and definition-site declaration of variance.
+Since use-site variance is more familiar to the Java developer, we start with this flavor.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">class Person {
+    name: string;
+}
+class Employee extends Person {}
+
+interface List&lt;T&gt; {
+    add(elem: T)
+    read(idx: int): T
+}
+
+function getNameOfFirstPerson(list: List&lt;? extends Person&gt;): string {
+    return list.read(0).name;
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Function <code>getNameOfFirstPerson</code> below takes a list and returns the name of the first person in the list.
+Since it never adds new elements to the given list, it could accept <code>List</code>s of any subtype of <code>Person</code>, for example a <code>List&lt;Employee&gt;</code>.
+To allow this, its formal parameter has a type of <code>List&lt;? extends Person&gt;</code> instead of <code>List&lt;Person&gt;</code>.
+Such use-site variance is useful whenever an invariant type, like <code>List</code> above, is being used in a way such that it can be treated as if it were co- or contravariant.</p>
+</div>
+<div class="paragraph">
+<p>Sometimes, however, we are dealing with types that are inherently covariant or contravariant, for example an <code>ImmutableList</code> from which we can only read elements would be covariant.
+In such a case, use-site declaration of variance is tedious and error-prone: we would have to declare the variance wherever the type is being used and would have to
+make sure not to forget the declaration or otherwise limit the flexibility and reusability of the code (for example, in the above code we could not call <code>getNameOfFirstPerson</code> with a <code>List&lt;Employee&gt;</code>).</p>
+</div>
+<div class="paragraph">
+<p>The solution is to declare the variance on declaration site, as in the following code sample:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">interface ImmutableList&lt;out T&gt; {
+//  add(elem: T)  // error: such a method would now be disallowed
+    read(idx: int): T
+}
+
+function getNameOfFirstPerson2(list: ImmutableList&lt;Person&gt;): string {
+    return list.read(0).name;
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Now we can invoke <code>getNameOfFirstPerson2</code> with a <code>List&lt;Employee&gt;</code> even though the implementor of <code>getNameOfFirstPerson2</code> did not add a
+use-site declaration of covariance, because the type <code>ImmutableList</code> is declared to be covariant with respect to its parameter <code>T</code>, and this applies globally
+throughout the program.</p>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_members"><a class="anchor" href="#_members"></a><a class="link" href="#_members">5.2. Members</a></h3>
+<div class="paragraph">
+<p>A member is either a method (which may be a special constructor function), a data field, or a getter or a setter.
+The latter two implicitly define an accessor field.
+Similar to object literals, there must be no data field with the same name as a getter or setter.</p>
+</div>
+<div class="paragraph">
+<p>(overriding, implementation and consumption) is
+described in <a href="#_redefinition-of-members">Redefinition of Members</a>.</p>
+</div>
+<div class="sect3 language-n4js">
+<h4 id="_syntax-4"><a class="anchor" href="#_syntax-4"></a><a class="link" href="#_syntax-4">5.2.1. Syntax</a></h4>
+<div class="listingblock">
+<div class="title">Syntax N4JS member access modifier</div>
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">enum N4JSMemberAccessModifier: private | project | protected | public;
+
+N4MemberDeclaration: N4MethodDeclaration | N4FieldDeclaration | N4GetterDeclaration | N4SetterDeclaration;</code></pre>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_properties-3"><a class="anchor" href="#_properties-3"></a><a class="link" href="#_properties-3">5.2.1.1. Properties</a></h5>
+<div class="paragraph">
+<p>Members share the following properties:</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><code>annotations</code> </dt>
+<dd>
+<p>Arbitrary annotations, see <a href="annotations.html#_annotations">Annotations</a> for details.</p>
+</dd>
+<dt class="hdlist1"><code>accessModifier</code> </dt>
+<dd>
+<p>N4JS member access modifier: <code>private</code>, <code>project</code>, <code>potected</code>, or <code>public</code>; the latter two can be combined with <code>@Internal</code>; default is <code>project</code> for classes and private interfaces.
+For a non-private interface defaults to the interface’s visibility.</p>
+</dd>
+<dt class="hdlist1"><code>name</code> </dt>
+<dd>
+<p>The simple name of the member, that is an identifier name (cf. <a href="names.html#_valid-names">Valid Names</a>).</p>
+</dd>
+<dt class="hdlist1"><code>static</code> </dt>
+<dd>
+<p>Boolean property to distinguish instance from classifier members, see <a href="#_static-members">Static Members</a>.</p>
+</dd>
+</dl>
+</div>
+<div class="paragraph">
+<p>The following pseudo properties are defined via annotations:</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><code>deprecated</code> </dt>
+<dd>
+<p>Boolean property set to true if annotation <code>@Deprecated</code> is set. <sup class="footnote">[<a id="_footnoteref_29" class="footnote" href="appendix_c_bibliography.html#_footnote_29" title="View footnote.">29</a>]</sup></p>
+</dd>
+</dl>
+</div>
+<div class="paragraph">
+<p>And we additionally define the following pseudo properties:</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><code>acc</code> </dt>
+<dd>
+<p>Member access modifier as described in <a href="names.html#_accessibility-of-members">Accessibility of Members</a>, it is the aggregated value of
+the <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>a</mi><mi>c</mi><mi>c</mi><mi>e</mi><mi>s</mi><mi>s</mi><mi>M</mi><mi>o</mi><mi>d</mi><mi>i</mi><mi>f</mi><mi>i</mi><mi>e</mi><mi>r</mi></math> and the <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>e</mi><mi>x</mi><mi>p</mi><mi>o</mi><mi>r</mi><mi>t</mi></math> property.</p>
+</dd>
+<dt class="hdlist1"><code>owner</code> </dt>
+<dd>
+<p>Owner classifier of the member.</p>
+</dd>
+<dt class="hdlist1"><code>typeRef</code> </dt>
+<dd>
+<p>Type of the member—this is the type of a field or the type of the method which is a function type (and not the return type).</p>
+</dd>
+<dt class="hdlist1"><code>assignability</code> </dt>
+<dd>
+<p>Enumeration, may be one of the following values:</p>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><code>set</code></dt>
+<dd>
+<p>Member may only be set, i.e. it could only be used on the left hand   side of an assignment.</p>
+</dd>
+<dt class="hdlist1"><code>get</code></dt>
+<dd>
+<p>Member may only be retrieved, i.e. it could only be used on the right hand side of an assignment. This is the default setting for methods.</p>
+</dd>
+<dt class="hdlist1"><code>any</code></dt>
+<dd>
+<p>  Member may be set or retrieved, i.e. it could only be used on the left or right hand side of an assignment.
+This is the default setting for fields.</p>
+</dd>
+</dl>
+</div>
+</dd>
+</dl>
+</div>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title=""></i>
+</td>
+<td class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>a</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>g</mi><mi>n</mi><mi>a</mi><mi>b</mi><mi>i</mi><mi>l</mi><mi>i</mi><mi>t</mi><mi>y</mi></math> is related but not equal to writable modifiers used for fields.
+We define a partial order on this enumeration as follows:<br>
+</td>
+</tr>
+</table>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mo>&lt;</mo><mfenced close=")" open="("><mi>l</mi><mi>r</mi></mfenced><mspace width="3.0mm"/><mi>:</mi><mi>:</mi><mo>=</mo><mspace width="3.0mm"/><mfenced close="}" open="{"><mfenced close=")" open="("><mstyle mathvariant="monospace"><mtext>set</mtext></mstyle><mstyle mathvariant="monospace"><mtext>any</mtext></mstyle></mfenced><mfenced close=")" open="("><mstyle mathvariant="monospace"><mtext>get</mtext></mstyle><mstyle mathvariant="monospace"><mtext>any</mtext></mstyle></mfenced></mfenced></math>
+</div>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><code>abstract</code> </dt>
+<dd>
+<p>All members have a flag <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>a</mi><mi>b</mi><mi>s</mi><mi>t</mi><mi>r</mi><mi>a</mi><mi>c</mi><mi>t</mi></math>, which is user-defined for methods, getters and setter, but which is always false for fields.</p>
+</dd>
+</dl>
+</div>
+<div class="paragraph">
+<p>The following pseudo property is set to make fields compatible with properties of an object literal, however it cannot be changed:</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><code>configurable</code> </dt>
+<dd>
+<p>Boolean flag reflecting the property descriptor <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>c</mi><mi>o</mi><mi>n</mi><mi>f</mi><mi>i</mi><mi>g</mi><mi>u</mi><mi>r</mi><mi>a</mi><mi>b</mi><mi>l</mi><mi>e</mi></math>, this is always set to false for members.</p>
+</dd>
+</dl>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_semantics-3"><a class="anchor" href="#_semantics-3"></a><a class="link" href="#_semantics-3">5.2.2. Semantics</a></h4>
+<div class="paragraph">
+<p>The members of a given classifier <code>C</code> must be named such that the following constraints are met:</p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-52"></a><strong>Req. IDE-52:</strong> <a href="#Req-IDE-52">Member Names</a> (ver. 1)</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>The name of a member is given as an identifier, a string literal, a numeric literal, or as a computed property name with a compile-time expression (see <a href="expressions.html#compile-time-expressions">Compile-Time Expressions</a>). In particular, string literals, e.g. <code>['myProp']</code>, built-in symbols, e.g. <code>[Symbol.iterator]</code>, and literals of <code>@StringBased</code> enums are all valid computed property names.</p>
+</li>
+<li>
+<p>No two members may have the same name, except one is static and the
+other is non-static:</p>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mtable><mtr><mtd><mo>∀</mo><msub><mi>m</mi><mn>1</mn></msub><mo>,</mo><msub><mi>m</mi><mn>2</mn></msub><mo>∈</mo><mi>C</mi><mo>.</mo><mi>o</mi><mi>w</mi><mi>n</mi><mi>e</mi><mi>d</mi><mi>M</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi><mi>s</mi><mo>,</mo><msub><mi>m</mi><mn>1</mn></msub><mo>≠</mo><msub><mi>m</mi><mn>2</mn></msub><mi>:</mi><msub><mi>m</mi><mn>1</mn></msub><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>≠</mo><msub><mi>m</mi><mn>2</mn></msub><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>∨</mo><msub><mi>m</mi><mn>1</mn></msub><mo>.</mo><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>c</mi><mo>≠</mo><msub><mi>m</mi><mn>2</mn></msub><mo>.</mo><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>c</mi></mtd></mtr></mtable></math>
+</div>
+</div>
+</li>
+<li>
+<p>The member name must be a valid identifier name, see <a href="grammar.html#_identifier-names-and-identifiers">Identifier Grammar</a>.</p>
+</li>
+</ol>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Thus, over<em>loading</em> of methods is not supported <sup class="footnote">[<a id="_footnoteref_30" class="footnote" href="appendix_c_bibliography.html#_footnote_30" title="View footnote.">30</a>]</sup> and no field may have the same name as a method.
+However, over<em>riding</em> of methods, getters, and setters are possible, see <a href="#_redefinition-of-members">Redefinition of Members</a>.
+Static members may also have the same name as non-static members.<sup class="footnote">[<a id="_footnoteref_31" class="footnote" href="appendix_c_bibliography.html#_footnote_31" title="View footnote.">31</a>]</sup></p>
+</div>
+<div class="paragraph">
+<p>The dollar character <code>$</code> is not allowed for user-defined member identifiers as the dollar sign is used for rewriting private members.</p>
+</div>
+</div>
+<div class="sect3 language-n4js">
+<h4 id="_methods"><a class="anchor" href="#_methods"></a><a class="link" href="#_methods">5.2.3. Methods</a></h4>
+<div class="paragraph">
+<p>Methods are simply JavaScript functions.
+They are defined similarly to methods as proposed in [<a href="appendix_c_bibliography.html#ECMA15a">ECMA15a(p.S13.5)</a>] except for the type information and some modifiers.</p>
+</div>
+<div class="sect4">
+<h5 id="_syntax-5"><a class="anchor" href="#_syntax-5"></a><a class="link" href="#_syntax-5">5.2.3.1. Syntax</a></h5>
+<div class="listingblock">
+<div class="title">Syntax Method Declaration</div>
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">N4MethodDeclaration &lt;Yield&gt;:
+    =&gt; ({N4MethodDeclaration}
+        annotations+=Annotation*
+        accessModifier=N4JSMemberAccessModifier?
+        (abstract?=’abstract’ | static?=’static’)?
+        TypeVariables?
+        (
+                generator?='*' LiteralOrComputedPropertyName&lt;Yield&gt; -&gt; MethodParamsReturnAndBody &lt;Generator=true&gt;
+            |   AsyncNoTrailingLineBreak LiteralOrComputedPropertyName&lt;Yield&gt; -&gt; MethodParamsReturnAndBody &lt;Generator=false&gt;
+        )
+    ) ';'?
+;
+
+fragment MethodParamsAndBody &lt;Generator&gt;*:
+    StrictFormalParameters&lt;Yield=Generator&gt;
+    (body=Block&lt;Yield=Generator&gt;)?
+;
+
+fragment MethodParamsReturnAndBody &lt;Generator&gt;*:
+    StrictFormalParameters&lt;Yield=Generator&gt;
+    (':' returnTypeRef=TypeRef)?
+    (body=Block&lt;Yield=Generator&gt;)?
+;
+
+fragment LiteralOrComputedPropertyName &lt;Yield&gt;*:
+    name=IdentifierName | name=STRING | name=NumericLiteralAsString
+    | '[' (=&gt;((name=SymbolLiteralComputedName&lt;Yield&gt; | name=StringLiteralAsName) ']') | computeNameFrom=AssignmentExpression&lt;In=true,Yield&gt; ']')
+;
+
+SymbolLiteralComputedName &lt;Yield&gt;:
+    BindingIdentifier&lt;Yield&gt; ('.' IdentifierName)?
+;
+
+BindingIdentifier &lt;Yield&gt;:
+    IDENTIFIER
+    | &lt;!Yield&gt; 'yield'
+    | N4Keyword
+;
+
+IdentifierName: IDENTIFIER | ReservedWord | N4Keyword;
+NumericLiteralAsString: DOUBLE | INT | OCTAL_INT | HEX_INT | SCIENTIFIC_INT;
+StringLiteralAsName: STRING;
+
+fragment AsyncNoTrailingLineBreak *: (declaredAsync?='async' NoLineTerminator)?;  // See Asynchronous Functions
+
+fragment StrictFormalParameters &lt;Yield&gt;*:
+    '(' (fpars+=FormalParameter&lt;Yield&gt; (',' fpars+=FormalParameter&lt;Yield&gt;)*)? ')'
+;
+
+FormalParameter &lt;Yield&gt;:
+    {FormalParameter} BindingElementFragment&lt;Yield&gt;
+;
+
+fragment BindingElementFragment &lt;Yield&gt;*:
+    (=&gt; bindingPattern=BindingPattern&lt;Yield&gt;
+    | annotations+=Annotation*
+        (
+            variadic?='...'? name=BindingIdentifier&lt;Yield&gt; ColonSepTypeRef?
+        )
+    )
+    ('=' initializer=AssignmentExpression&lt;In=true, Yield&gt;)?
+;
+
+fragment ColonSepTypeRef*:
+    ':' declaredTypeRef=TypeRef
+;</code></pre>
+</div>
+</div>
+</div>
+<div class="sect4 language-n4js">
+<h5 id="_properties-4"><a class="anchor" href="#_properties-4"></a><a class="link" href="#_properties-4">5.2.3.2. Properties</a></h5>
+<div class="paragraph">
+<p>Methods have all the properties of members and the following additional properties can be explicitly defined:</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><code>abstract</code> </dt>
+<dd>
+<p>Method is declared but not defined.</p>
+</dd>
+<dt class="hdlist1"><code>typePars</code> </dt>
+<dd>
+<p>Collection of type parameters of a generic method; empty by default.</p>
+</dd>
+<dt class="hdlist1"><code>returnTypeRef</code> </dt>
+<dd>
+<p>Return type of the method, default return type is <math xmlns="http://www.w3.org/1998/Math/MathML"><mstyle mathvariant="italic"><mi>V</mi><mi>o</mi><mi>i</mi><mi>d</mi></mstyle></math>.
+The type of the method as a member of the owning classifier is not the method’s return type but is instead a function type.</p>
+</dd>
+<dt class="hdlist1"><code>fpars</code> </dt>
+<dd>
+<p>List of formal parameters, may be left empty.</p>
+</dd>
+<dt class="hdlist1"><code>body</code> </dt>
+<dd>
+<p>The body of the method (this is not available in the pure types model)</p>
+</dd>
+</dl>
+</div>
+<div class="paragraph">
+<p>The following pseudo properties are defined via annotations:</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><code>final</code> </dt>
+<dd>
+<p>Boolean flag set to true if annotation <code>@Final</code> is set.
+The flag indicates that method must not be overridden in subclasses; see <a href="#_final-methods">Final Methods</a>.</p>
+</dd>
+<dt class="hdlist1"><code>declaresOverride</code> </dt>
+<dd>
+<p>Flag set to true if annotation <code>@Overrides</code> is set. The flag indicates that method must override a method of a superclass; see <a href="#_overriding-of-members">Overriding of Members</a>.</p>
+</dd>
+</dl>
+</div>
+<div class="paragraph">
+<p>Additionally, we define the following pseudo properties:</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><code>overrides</code> </dt>
+<dd>
+<p>True if method overrides a super method or implements an interface method, false otherwise.</p>
+</dd>
+<dt class="hdlist1"><code>typeRef</code> </dt>
+<dd>
+<p>Type of the method. This is, in fact, a function type (and not the return type).</p>
+</dd>
+</dl>
+</div>
+<div class="paragraph">
+<p>The following pseudo property is set to make methods compatible with properties of an object literal, however it cannot be changed:</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><code>enumerable</code> </dt>
+<dd>
+<p>Boolean flag reflecting the property descriptor <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>e</mi><mi>n</mi><mi>u</mi><mi>m</mi><mi>e</mi><mi>r</mi><mi>a</mi><mi>b</mi><mi>l</mi><mi>e</mi></math>, this is always set to false for methods.</p>
+</dd>
+</dl>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_semantics-4"><a class="anchor" href="#_semantics-4"></a><a class="link" href="#_semantics-4">5.2.3.3. Semantics</a></h5>
+<div class="paragraph">
+<p>Since methods are ECMAScript functions, all constraints specified in <a href="functions.html#_function-type">Function Type</a> apply to methods as well.
+This section describes default values and function type conformance which is required for overriding and implementing methods.</p>
+</div>
+<div class="paragraph">
+<p>In addition, method declarations and definitions have to comply with the constraints for naming members of classifiers (cf. <a href="#Req-IDE-52">[Req-IDE-52]</a>)
+and with the constraints detailed in the following sections on final methods (<a href="#_final-methods">Final Methods</a>), abstract methods (<a href="#_abstract-methods">Abstract Methods</a> and
+method overriding and implementation (<a href="#_overriding-of-members">Overriding of Members</a>, <a href="#_implementation-of-members">Implementation of Members</a>).</p>
+</div>
+<div class="paragraph">
+<p>The following constraints are defined for methods in ECMAScript 6 [<a href="appendix_c_bibliography.html#ECMA15a">ECMA15a(p.207)</a>]</p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-53"></a><strong>Req. IDE-53:</strong> <a href="#Req-IDE-53">Method Definition ECMAScript 6</a> (ver. 1)</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>It is a Syntax Error if any element of the BoundNames of StrictFormalParameters also occurs in the VarDeclaredNames of FunctionBody.</p>
+</li>
+<li>
+<p>It is a Syntax Error if any element of the BoundNames of StrictFormalParameters also occurs in the LexicallyDeclaredNames of FunctionBody.</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Methods – like functions – define a variable execution environment and therefore provide access to the actual passed-in parameters through the implicit <code>arguments</code> variable inside of their bodies (c.f. <a href="functions.html#_arguments-object">Arguments Object</a>).</p>
+</div>
+<div class="paragraph">
+<p>Methods are similar to function definitions but they must not be assigned to or from variables.
+The following code issues an error although the type of the method would be compatible to the type of the variable <code>v</code>:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">class C {
+    m(): void {}
+}
+var v: {function():void} = new C().m;</code></pre>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-54"></a><strong>Req. IDE-54:</strong> <a href="#Req-IDE-54">Method Assignment</a> (ver. 1)</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>In contrast to ECMAScript 2015, methods are defined as readonly, that is, it is not possible to dynamically re-assign a property defined as method with a new value.
+This is because assigning or re-assigning a method breaks encapsulation. Methods are the <a href="appendix_a_acronyms.html#_acronyms">Acronyms</a> of a class, their implementation is internal to the class.</p>
+</li>
+<li>
+<p>When assigning a method to a variable, a warning is issued since this would lead to an detached this reference inside the method when it is called without explicitly providing the receiver. No warning is issued only if it is guaranteed that no problems will occur:</p>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p>The method’s body can be determined at compile time (i.e., it has been declared <code>@Final</code>) and it lacks usages of <code>this</code> or <code>super</code>. This is true for instance and static methods.</p>
+</li>
+<li>
+<p>The method is the constructor.</p>
+</li>
+</ol>
+</div>
+</li>
+</ol>
+</div>
+</div>
+</div>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title=""></i>
+</td>
+<td class="content">
+The following code demonstrates problems arising when methods are assigned to variables in terms of function expressions.
+Given are two classes and instances of each class as follows:
+</td>
+</tr>
+</table>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">class C {
+    m(): void { }
+    static k(): void {}
+}
+class D extends C {
+    @Override m(): void { this.f()}
+    f(): void {}
+
+    @Override static k(): void { this.f()}
+    static f(): void {}
+}
+var c: C = new C();
+var d: C = new D(); // d looks like a C</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Assigning an instance method to a variable could cause problems, as the method assumes this to be bound to the class in which it is defined.
+This may work in some cases, but will cause problems in particular in combination with method overriding:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">var v1: {@This(C)function():void} = c.m;
+var v2: {@This(C)function():void} = d.m;
+
+v1.call(c);
+v2.call(c);</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Calling <code>c.m</code> indirectly via <code>v1</code> with <code>c</code> as this object will work.
+However, it won’t work for <code>v2</code>: the method is overridden in <code>D</code>, and the method in expects other methods available in <code>D</code> but not in <code>C</code>.
+That is, the last call would lead to a runtime error as method <code>f</code> which is called in <code>D.m</code> won’t be available.</p>
+</div>
+<div class="paragraph">
+<p>The same scenario occurs in case of static methods if they are retrieved polymorphically via the variables of type <code>constructor{C}</code>:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">var ctor: constructor{C} = C;
+var dtor: constructor{C} = D;
+
+var v3: {@This(constructor{C})function():void} = ctor.k;
+var v4: {@This(constructor{C})function():void} = dtor.k;</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>In both cases, the problem could be solved by restricting these kinds of assignments to final methods only.
+In the static case, the problem would also be solved by accessing the static method directly via the class type (and not polymorphically via the constructor).
+Both restrictions are severe but would be necessary to avoid unexpected runtime problems.</p>
+</div>
+<div class="paragraph">
+<p>The following example shows a problem with breaking the encapsulation of a class.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">class C {
+    x: any = "";
+    f(): void { this.g(this); }
+    g(c: C): void { c.h(); }
+    h(): void {}
+}
+class D extends C {
+
+    @Override f(): void {
+        this.g(this.x);
+    }
+    @Override g(c: any) {
+        // do nothing, do not call h())
+    }
+}
+
+var c = new C();
+var d = new D();
+
+var v5: {@This(C)function():void} = c.f;
+var v6: {@This(C)function():void} = d.f;
+
+v5.call(c)
+v6.call(c)</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>In <code>D</code>, method <code>g</code> is overridden to accept more types as the original method defined in <code>C</code>.
+Calling this new method with receiver type <code>C</code> (as done in the last line) will cause problems, as in <code>D</code> not only <code>f</code> has been adapted but also <code>g</code>.
+Eventually, this would lead to a runtime error as well.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_final-methods"><a class="anchor" href="#_final-methods"></a><a class="link" href="#_final-methods">5.2.3.4. Final Methods</a></h5>
+<div class="paragraph">
+<p>By default, methods can be overridden.
+To prevent a method from being overridden, it must be annotated with <code>@Final</code>.</p>
+</div>
+<div class="paragraph">
+<p>Of course, a method cannot be declared both abstract and final (cf. <a href="#Req-IDE-46">[Req-IDE-46]</a>).
+Private methods are implicitly declared final.
+Because static methods can be overridden in subclasses (which is different to Java), they also can be marked as final.</p>
+</div>
+<div class="paragraph">
+<p>Default methods in interfaces, cf. <a href="#_default-methods-in-interfaces">Default Methods in Interfaces</a>, may also be declared <code>@Final</code>.</p>
+</div>
+<div class="exampleblock">
+<div class="title">Example 35. Final Methods in Interfaces</div>
+<div class="content">
+<div class="paragraph">
+<p>If a method in an interface is provided with a body, it may be declared final.
+This will ensure that the given method’s body will be in effect for all instances of the interface.
+Note that this means that;</p>
+</div>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p>a class implementing that interface must not define a method with the same name and</p>
+</li>
+<li>
+<p>a class inheriting a method of that name cannot implement this interface.</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>The latter case is illustrated here:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">interface I {
+    @Final m(): void {}
+}
+
+class C1 {
+    m(): void {}
+}
+
+// error at "I": "The method C1.m cannot override final method I.m."
+class C2 extends C1 implements I {
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_abstract-methods"><a class="anchor" href="#_abstract-methods"></a><a class="link" href="#_abstract-methods">5.2.3.5. Abstract Methods</a></h5>
+<div class="paragraph">
+<p>A method can be declared without defining it, i.e. without providing a method body, and is then called an <em>abstract method</em>.
+Such methods must be declared with modifier <code>abstract</code> and have their property <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>a</mi><mi>b</mi><mi>s</mi><mi>t</mi><mi>r</mi><mi>a</mi><mi>c</mi><mi>t</mi></math> set to true.
+Constraints for abstract methods are covered in <a href="#Req-IDE-46">[Req-IDE-46]</a> (see <a href="#_abstract-classes">Abstract Classes</a>).</p>
+</div>
+<div class="paragraph">
+<p>In interfaces, methods are always abstract by default and they do not have to be marked as abstract.
+If a method in an interface provides a body, then this is the default implementation.
+See <a href="#_implementation-of-members">Implementation of Members</a> about how the default implementation may be mixed in the consumer.</p>
+</div>
+</div>
+<div class="sect4 language-n4js">
+<h5 id="_generic-methods"><a class="anchor" href="#_generic-methods"></a><a class="link" href="#_generic-methods">5.2.3.6. Generic Methods</a></h5>
+<div class="paragraph">
+<p>Methods of generic classes can, of course, refer to the type variables defined by type parameters of the generic class.
+These type variables are used similarly to predefined or declared types.
+Additionally, methods may be declared generic independently from their containing class.
+That is to say that type parameters (with type variables) can be defined for methods as well, just like for generic functions (see <a href="functions.html#_generic-functions">Generic Functions</a>).</p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-55"></a><strong>Req. IDE-55:</strong> <a href="#Req-IDE-55">Type variable names for generic methods</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>For a given generic method <code>M</code> of a class <code>C</code>, the following
+constraint must hold:<br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∀</mo><mi> </mi><mi>t</mi><msub><mi>p</mi><mi>m</mi></msub><mo>∈</mo><mi>m</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>P</mi><mi>a</mi><mi>r</mi><mi>s</mi><mo>,</mo><mi>t</mi><msub><mi>p</mi><mi>C</mi></msub><mo>∈</mo><mi>C</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>P</mi><mi>a</mi><mi>r</mi><mi>s</mi><mi>:</mi><mi>t</mi><msub><mi>p</mi><mi>m</mi></msub><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>≠</mo><mi>t</mi><msub><mi>p</mi><mi>C</mi></msub><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi></math></p>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Since type variables can be used similarly to types in the scope of a generic class, a generic method may refer to a type variable of its containing class.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">class C {
+    &lt;T&gt; foo(p: T p): T { return p;}
+};</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>If a generic type parameter is not used as a formal parameter type or the return type, a warning is generated unless the method overrides a member inherited from a super class or interface.</p>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_default-methods-in-interfaces"><a class="anchor" href="#_default-methods-in-interfaces"></a><a class="link" href="#_default-methods-in-interfaces">5.2.4. Default Methods in Interfaces</a></h4>
+<div class="paragraph">
+<p>If a method declared in an interface defines a body, then this is the so-called <em>default implementation</em> and the method is called a <em>default method</em>.
+This will be mixed into an implementor of the interface if, and only if, neither the implementing class nor any of its direct or indirect superclasses already provides an implementation for this method;
+for details see <a href="#_member-consumption">Member Consumption</a>.
+Since the implementor is not known, some constraints exist for the body. I.e., no access to super is possible, cf. <a href="expressions.html#Req-IDE-124">[Req-IDE-124]</a>.</p>
+</div>
+<div class="paragraph">
+<p>In order to declare an interface to provide a default implementation in a definition file, annotation <code>@ProvidesDefaultImplementation</code> can be used, cf. <a href="plainjs.html#Req-IDE-167">[Req-IDE-167]</a>.</p>
+</div>
+<div class="paragraph">
+<p>When a method in an interface is provided with a default implementation, it may even be declared <code>@Final</code>, see <a href="#_final-methods">Final Methods</a>.</p>
+</div>
+<div class="sect4">
+<h5 id="_asynchronous-methods"><a class="anchor" href="#_asynchronous-methods"></a><a class="link" href="#_asynchronous-methods">5.2.4.1. Asynchronous Methods</a></h5>
+<div class="paragraph">
+<p>N4JS implements the async/await concept proposed for ECMAScript 7, which provides a more convenient and readable syntax for writing asynchronous code compared to using built-in type Promise directly.
+This concept can be applied to methods in exactly the same way as to declared functions.
+See <a href="functions.html#_asynchronous-functions">Asynchronous Functions</a> and <a href="functions.html#_asynchronous-arrow-functions">Asynchronous Arrow Functions</a> for details.</p>
+</div>
+</div>
+</div>
+<div class="sect3 language-n4js">
+<h4 id="_constructors"><a class="anchor" href="#_constructors"></a><a class="link" href="#_constructors">5.2.5. Constructors</a></h4>
+<div class="paragraph">
+<p>A constructor is a special function defined on a class which returns an instance of that class.
+The constructor looks like a normal method with name "constructor".
+The constructor can be defined explicitly or implicitly and every class has an (implicit) constructor.</p>
+</div>
+<div class="paragraph">
+<p>For a given a class <code>C</code>, the constructor is available via two properties:</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>o</mi><mi>w</mi><mi>n</mi><mi>e</mi><mi>d</mi><mi>C</mi><mi>t</mi><mi>o</mi><mi>r</mi></math></dt>
+<dd>
+<p>the explicitly defined constructor (if any).</p>
+</dd>
+<dt class="hdlist1"><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi></math></dt>
+<dd>
+<p>the explicit or implicit constructor.</p>
+</dd>
+</dl>
+</div>
+<div class="paragraph">
+<p>If <code>C</code> is provided with an explicit constructor, we have <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>C</mi><mo>.</mo><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi><mo>=</mo><mi>C</mi><mo>.</mo><mi>o</mi><mi>w</mi><mi>n</mi><mi>e</mi><mi>d</mi><mi>C</mi><mi>t</mi><mi>o</mi><mi>r</mi></math> and <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>C</mi><mo>.</mo><mi>o</mi><mi>w</mi><mi>n</mi><mi>e</mi><mi>d</mi><mi>C</mi><mi>t</mi><mi>o</mi><mi>r</mi><mo>∈</mo><mi>C</mi><mo>.</mo><mi>o</mi><mi>w</mi><mi>n</mi><mi>e</mi><mi>d</mi><mi>M</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi><mi>s</mi></math>.
+Note that <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>C</mi><mo>.</mo><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi><mo>∉</mo><mi>C</mi><mo>.</mo><mi>o</mi><mi>w</mi><mi>n</mi><mi>e</mi><mi>d</mi><mi>M</mi><mi>e</mi><mi>t</mi><mi>h</mi><mi>o</mi><mi>d</mi><mi>s</mi></math> in all cases.</p>
+</div>
+<div class="paragraph">
+<p>The return type of the constructor of a class <code>C</code> is <code>C</code>.
+If <code>C</code> has type parameters <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>T</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>T</mi><mi>n</mi></msub></math>, then the return type is <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>C</mi><mo>&lt;</mo><msub><mi>T</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>T</mi><mi>n</mi></msub><mo>&gt;</mo></math>. The constructor is called with the operator.
+Since the return type of a constructor is implicitly defined by the class, it is to be omitted.
+By this definition, a constructor looks like the following:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">class C {
+    public constructor(s: string) {
+        // init something
+    }
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Constructors define a variable execution environment and therefore provide access to the actual passed-in parameters through the implicit variable inside of their bodies (c.f. <a href="functions.html#_arguments-object">Arguments Object</a>).</p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-56"></a><strong>Req. IDE-56:</strong> <a href="#Req-IDE-56">Defining and Calling Constructors</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>For a constructor <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi></math> of a class <code>C</code>, the following conditions
+must hold:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi></math> must neither be abstract nor static nor final and it must not be annotated with <code>@Override</code>.</p>
+</li>
+<li>
+<p>If a class does not explicitly define a constructor then the constructor’s signature of the superclass constructor is assumed.</p>
+</li>
+<li>
+<p>If a class defines a constructor with formal parameters then this constructor has to be called explicitly in constructors defined in subclasses.</p>
+</li>
+<li>
+<p>If a super constructor is called explicitly, this call must be the only expression of an expression statement which has to be the first statement of the body.</p>
+</li>
+<li>
+<p>Constructors may appear in interfaces, but some restrictions apply:</p>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p>constructors in interfaces must not have a body.</p>
+</li>
+<li>
+<p>constructors in interfaces or their containing interface or one of its direct or indirect super interfaces must be annotated with <code>@CovariantConstructor</code>.</p>
+</li>
+</ol>
+</div>
+</li>
+<li>
+<p>A constructor must not have an explicit return type declaration.</p>
+</li>
+<li>
+<p>The implicit return type of a constructor is <code>this?</code>.</p>
+</li>
+<li>
+<p>A constructor must not have any type parameters.</p>
+</li>
+</ol>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Properties of object literals may be called <code>constructor</code>.
+However they are not recognized as constructors in these cases.</p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-57"></a><strong>Req. IDE-57:</strong> <a href="#Req-IDE-57">Initialization of Final Fields in the Constructor</a> (ver. 1)</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Required attributes must be initialized:<br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∀</mo><mi>a</mi><mo>∈</mo><mi>C</mi><mo>.</mo><mi>a</mi><mi>t</mi><mi>t</mi><mi>r</mi><mi>:</mi><mi>a</mi><mo>.</mo><mi>r</mi><mi>e</mi><mi>q</mi><mi>u</mi><mi>i</mi><mi>r</mi><mi>e</mi><mi>d</mi><mo>⇒</mo><mo>∃</mo><mi>e</mi><mo>∈</mo><mi>r</mi><mo>.</mo><mi>e</mi><mi>l</mi><mi>e</mi><mi>m</mi><mi>e</mi><mi>n</mi><mi>t</mi><mi>s</mi><mi>:</mi><mi>a</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><mi>e</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi></math></p>
+</li>
+</ol>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Note on syntax: ECMAScript 6 defines constructors similarly, [<a href="appendix_c_bibliography.html#ECMA15a">ECMA15a(p.S13.5)</a>]. In
+ECMAScript 6 the super constructor is not called automatically as well.</p>
+</div>
+<div class="paragraph">
+<p>The super literal used in order to call super methods is further
+described in <a href="expressions.html#_the-super-keyword">The super Keyword</a>.</p>
+</div>
+<div class="sect4">
+<h5 id="_structural-this-type-in-constructor"><a class="anchor" href="#_structural-this-type-in-constructor"></a><a class="link" href="#_structural-this-type-in-constructor">5.2.5.1. Structural This Type in Constructor</a></h5>
+<div class="paragraph">
+<p>The use of a structural this reference as a formal parameter type is possible only in constructors.
+This parameter can be annotated with <code>@Spec</code> which causes the compiler to generate initialization code.</p>
+</div>
+<div class="paragraph">
+<p>Simply using <code>this</code> as a type in the constructor causes the constructor to require an object providing all public fields of the class for initialization purposes.
+The fields have to be set manually as shown in the following code snippet.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">class A{
+    public s: string;
+    public constructor(src: ~~this) {
+        this.s = src.s;
+    }
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Remarks:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>The type of the formal parameter <code>~~this</code> refers to the structural field type, see <a href="#_structural-typing">Structural Typing</a> for details on structural typing.
+It contains all public fields of the type.</p>
+</li>
+<li>
+<p>Subclasses may override the constructor and introduce additional parameters.
+They have to call the super constructor explicitly, however, providing a parameter with at least all required attributes of the superclass.
+Usually the type <code>this</code> is replaced with the actual subclass, but in the case of a <code>super()</code> call the <code>this</code> type of structural formal parameters is replaced with the <code>this</code> type of the superclass,
+hence only required fields of the superclass must be present.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>As with other structural references, it is possible to add the structural reference with additional structural members, which can be used to initialize private fields which
+become not automatically part of the structural field type. For example:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">class A{
+    public s: string;
+    private myPrivateNumber: number;
+    public constructor(src: ~~this with { x: number; }) {
+        this.s = src.s;
+        this.myPrivateNumber = src.x;
+    }
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Defining additional members may become a problem if a subclass defines  public fields with the same name, as the <code>~~this</code> type will contain these fields in the subclass.
+This is marked as an error in the subclass.</p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-58"></a><strong>Req. IDE-58:</strong> <a href="#Req-IDE-58">Names of additional members of structural this type in constructor</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>If the structural this type is used in a constructor of a class <code>C</code>, and if this structural reference contains an additional structural member <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>S</mi><mi>M</mi></math>, the following constraints must hold true:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>For any subclass <code>S</code> of <code>C</code>, with <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>S</mi><mo>.</mo><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi><mo>=</mo><mi>C</mi><mo>.</mo><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi></math> (the subclass does not define its own constructor), <code>S</code> must not contain a public member with same name as <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>S</mi><mi>M</mi></math>:</p>
+<div class="paragraph">
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>S</mi><mo>&lt;</mo><mi>:</mi><mi>C</mi><mo>,</mo><mi>S</mi><mo>.</mo><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi><mo>=</mo><mi>C</mi><mo>.</mo><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi></math>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0em"/><mo>⇒</mo><mo>∄</mo><mi>M</mi><mo>∈</mo><mi>S</mi><mo>.</mo><mi>m</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi><mi>s</mi><mi>:</mi></math>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="5.0em"/><mi>M</mi><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>public</mtext></mstyle><mo>∧</mo><mi>M</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><mi>S</mi><mi>M</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi></math></p>
+</div>
+</li>
+<li>
+<p><code>C</code> itself must not contain a public member with same name as <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>S</mi><mi>M</mi></math>:</p>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mo>∄</mo><mi>M</mi><mo>∈</mo><mi>C</mi><mo>.</mo><mi>m</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi><mi>s</mi><mi>:</mi><mi>M</mi><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>public</mtext></mstyle><mo>∧</mo><mi>M</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><mi>S</mi><mi>M</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi></math>
+</div>
+</div>
+</li>
+</ol>
+</div>
+</div>
+</div>
+<div class="exampleblock">
+<div class="title">Example 36. Field name conflicts with structural member name</div>
+<div class="content">
+<div class="paragraph">
+<p>The situation described in <a href="#Req-IDE-58">[Req-IDE-58]</a> is demonstrated in the following code fragment:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">class A {
+    private myPrivateNumber: number;
+    public constructor(src: ~~this with { x: number; }) {
+        this.myPrivateNumber = src.x;
+    }
+}
+
+class B extends A {
+    public x: number; // will cause an error message
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="spec-constructor"><a class="anchor" href="#spec-constructor"></a><a class="link" href="#spec-constructor">5.2.5.2. @Spec Constructor</a></h5>
+<div class="paragraph">
+<p>The tedious process of copying the members of the parameter to the fields of the class can be automated via the <code>@Spec</code>
+annotation if the argument has <code>~i~this</code> structural initializer field typing. More details about this typing can be
+found in <a href="#structural-readWriteInit-field-typing">Structural Read-only, Write-only and Initializer Field Typing</a>. This can be used as shown in the following listing:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">class A {
+    public field: string;
+    public constructor(@Spec spec: ~i~this) {}
+}
+let a = new A({field: 'hello'});
+console.log(a.field); // prints: hello</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>The code for initializing the public field of <code>A</code> is automatically generated, thanks to the <code>@Spec</code> annotation being
+given in the constructor.</p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-59"></a><strong>Req. IDE-59:</strong> <a href="#Req-IDE-59">@Spec Constructor</a> (ver. 1)</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Annotation <code>@Spec</code> may only appear on a formal parameter of a constructor. Such a formal parameter is then called
+<em>@Spec parameter</em> or simply <em>spec parameter</em> and its owning constructor is referred to as a <em>@Spec constructor</em> or
+<em>spec constructor</em>. An argument to the spec parameter is called <em>spec object</em>.</p>
+</li>
+<li>
+<p>Only a single formal parameter of a constructor may be annotated with <code>@Spec</code>.</p>
+</li>
+<li>
+<p>If a formal parameter is annotated with <code>@Spec</code>, the parameter’s type must be <code>~i~this</code> (i.e. a use-site
+structural initializer field type of <code>this</code>, see <a href="#structural-readWriteInit-field-typing">Structural Read-only, Write-only and Initializer Field Typing</a>).</p>
+</li>
+<li>
+<p>Using the data provided in the spec object, i.e. in the argument to the spec parameter, a spec constructor will
+automatically initialize</p>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p>all <strong>owned</strong> data fields and <strong>owned</strong> setters of the containing class, and</p>
+</li>
+<li>
+<p>all data fields and setters from interfaces implemented by the containing class</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>if and only if those members are also part of the spec parameter&#8217;s structural initializer field type.</p>
+</div>
+</li>
+<li>
+<p>Fields explicitly added to the spec parameter, e.g. <code>@Spec spec: ~i~this with {name:string}</code>, are used for initialization
+if a non-public field of the same name exists in the class, either as an owned member or from an implemented interface.
+The type of such an additional field must be a subtype of the declared type of the field being initialized:</p>
+<div class="paragraph">
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∀</mo><mi>s</mi><mo>∈</mo><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi><mo>.</mo><mi>f</mi><mi>p</mi><mi>a</mi><mi>r</mi><mo>.</mo><mi>s</mi><mi>t</mi><mi>r</mi><mi>u</mi><mi>c</mi><mi>t</mi><mi>u</mi><mi>r</mi><mi>a</mi><mi>l</mi><mi>M</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi><mi>s</mi><mo>,</mo><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi><mo>.</mo><mi>f</mi><mi>p</mi><mi>a</mi><mi>r</mi><mo>.</mo><mi>s</mi><mi>p</mi><mi>e</mi><mi>c</mi><mi>:</mi></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="2.0em"/><mo>∃</mo><mi>f</mi><mo>∈</mo><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi><mo>.</mo><mi>o</mi><mi>w</mi><mi>n</mi><mi>e</mi><mi>r</mi><mo>.</mo><mi>o</mi><mi>w</mi><mi>n</mi><mi>e</mi><mi>d</mi><mi>F</mi><mi>i</mi><mi>e</mi><mi>l</mi><mi>d</mi><mi>s</mi><mo>⇒</mo><mi>Γ</mi><mo>⊢</mo><mi>s</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>f</mi></math></p>
+</div>
+</li>
+<li>
+<p>Even if the <code>@Spec</code> annotation is used, the super constructor must be invoked explicitly (as usual).</p>
+</li>
+</ol>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>It follows from no. 4 above that</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>non-public data fields and setters are never initialized (because they will never be part of the spec parameter&#8217;s
+structural initializer field type),</p>
+</li>
+<li>
+<p>properties provided in the spec object but not defined in the parameter&#8217;s structural initializer field type, are
+<em>not</em> used for initialization, even if a (protected or private) field of the same name exists in the class,</p>
+</li>
+<li>
+<p>data fields and setters inherited from a super class are never initialized by a spec constructor (instead, this will
+happen in the spec constructor of the super class).</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>The last of these implications will be detailed further at the end of the coming section.</p>
+</div>
+<div class="paragraph">
+<p><strong>@Spec Constructors and Inheritance</strong></p>
+</div>
+<div class="paragraph">
+<p>Spec constructors are inherited by subclasses that do not have a constructor and, when creating instances of the
+subclass, will then require properties for writable public fields of the subclass in the spec object <strong>and</strong> include
+initialization code for them.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">class A {
+    public fa;
+    public constructor(@Spec spec: ~i~this) {}
+}
+class B extends A {
+    public fb;
+}
+
+const b = new B({fa: 'hello', fb: 'world'}); // requires &amp; initializes fb too!
+console.log(b.fa); // prints: hello
+console.log(b.fb); // prints: world</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Public writable fields from implemented interfaces are included as well, i.e. required as property in spec object <strong>and</strong>
+initialized by auto-generated code in the <code>@Spec</code> constructor:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">interface I {
+    public fi;
+}
+class B implements I {
+    public fb;
+    public constructor(@Spec spec: ~i~this) {}
+}
+
+const a = new B({fb: 'hello', fi: 'world'}); // requires &amp; initializes fi too!
+console.log(a.fb); // prints: hello
+console.log(a.fi); // prints: world</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>When having a spec constructor in a class <code>B</code> that extends a super class <code>A</code> without an owned or inherited spec
+constructor, it should be noted that the <code>~i~this</code> type will require properties for public writable fields of <code>A</code>,
+but the initialization code automatically generated due to the <code>@Spec</code> annotation will <strong>not</strong> initialize those members.
+For public writable fields from an interface <code>I</code> implemented by <code>B</code>, however, both a property will be required by
+<code>~i~this</code> <strong>and</strong> initialization code will be generated in the <code>@Spec</code> constructor. This is illustrated in the
+following code example.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">class A {
+    public fa;
+}
+interface I {
+    public fi;
+}
+class B extends A implements I {
+    public fb;
+    public constructor(@Spec spec: ~i~this) { // &lt;- fa, fi, fb required in spec object
+        // Constructor is responsible for initializing fa, fi, fb.
+        // The @Spec annotation will generate initialization code
+        // for fb and fi, but not for fa!
+    }
+}
+
+let b = new B({
+    fa: 'hello', // &lt;- fa is required (removing it would be a compile error)
+    fi: 'world',
+    fb: '!!'
+});
+
+console.log(b.fa); // undefined
+console.log(b.fi); // world
+console.log(b.fb); // !!</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>The rationale for this different handling of fields from super classes and implemented interfaces is
+1. fields from an implemented interface are not seen as inherited but rather implemented by implementing class, so from
+   the <code>@Spec</code> annotation&#8217;s perspective the field is a field of the implementing class, and
+2. in case of a field inherited from a super class the correct way of initialization may depend on details of the super
+   class and has to be taken care of by custom code in the constructor of the subclass (usually by invoking the non-<code>@Spec</code>
+   constructor of the superclass with <code>super</code>).</p>
+</div>
+<div class="paragraph">
+<p><strong>Special Use Cases</strong></p>
+</div>
+<div class="paragraph">
+<p>The following examples illustrate further details of other use cases of spec constructors.</p>
+</div>
+<div class="exampleblock">
+<div class="title">Example 37. Anonymous Interface in Constructor</div>
+<div class="content">
+<div class="paragraph">
+<p>The base class <code>A</code> in the examples redefines the constructor already defined in <code>N4Object</code>. This is not
+generally necessary and is only used here to make the example legible.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">class A {
+    public s: string;
+    public constructor(@Spec spec: ~i~this) {
+        // initialization of s is automatically generated
+    }
+}
+class B extends A {
+    public t: string;
+    private n: number;
+    public constructor(spec: ~~this with {n: number;}) {
+        super(spec);    // only inherited field s is set in super constructor
+    }
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="exampleblock">
+<div class="title">Example 38. Spec Object and Subclasses</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">class A1 {
+    public s: string;
+    public n: number;
+    public constructor(@Spec spec: ~i~this) {}
+}
+class B extends A1 {
+    public constructor() {
+        super({s:"Hello"}); // &lt;-- error, n must be set in object literal
+    }
+}
+class C extends A1 {
+    public constructor() {
+        super({s:"Hello"}); // &lt;-- error, n must be set in object literal
+        this.n = 10; // &lt;-- this has no effect on the super constructor!
+    }
+}
+
+class A2 {
+    public s: string;
+    public n: number?; // now n is optional!
+    public constructor(@Spec spec: ~i~this) {}
+}
+class D extends A2 {
+    public constructor() {
+        super({s:"Hello"}); // and this is ok now!
+        this.n = 10; // this explains why it is optional
+    }
+}
+
+class A3 {
+    public s: string;
+    public n: number = 10; // now n is not required in ~~this
+    public constructor(@Spec spec: ~i~this) {}
+}
+class E extends A3 {
+    public constructor() {
+        super({s:"Hello"}); // and this is ok now!
+    }
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>The last case (class E) demonstrates a special feature of the typing strategy modifier in combination with the <code>this</code> type, see <a href="#_structural-typing">Structural Typing</a> for details.</p>
+</div>
+<div class="paragraph">
+<p>The constructor in class <code>B</code> contains an error because the super constructor expects all required attributes in <code>A1</code> to be set.
+The additional initialization of the required field <code>A1.n</code> as seen in <code>C</code> does not change that expectation.
+In this example, the field <code>n</code> should not have been defined as required in the first place.</p>
+</div>
+<div class="paragraph">
+<p>Optional fields like <code>n?</code> in class <code>A2</code> or fields with default values like <code>n=10</code> in class <code>A3</code> are not required to be part of the <code>spec</code> object.</p>
+</div>
+</div>
+</div>
+<div class="exampleblock">
+<div class="title">Example 39. Superfluous Properties in @Spec Constructors</div>
+<div class="content">
+<div class="paragraph">
+<p>Each non-<math xmlns="http://www.w3.org/1998/Math/MathML"><mstyle mathvariant="monospace"><mtext>public</mtext></mstyle></math> field has to be set in the constructor via the <math xmlns="http://www.w3.org/1998/Math/MathML"><mstyle mathvariant="monospace"><mtext>with</mtext></mstyle></math> to the parameter otherwise properties are <em>not</em> used to set non-<math xmlns="http://www.w3.org/1998/Math/MathML"><mstyle mathvariant="monospace"><mtext>public</mtext></mstyle></math> fields.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">class C {
+    public s: string;
+    n: number;
+    constructor(@Spec spec: ~i~this) {}
+}
+
+// n is ignored here
+new C( { s: "Hello", n: 42 });
+
+// but:
+var ol = { s: "Hello", n: 42 };
+// "ol may be used elsewhere, we cannot issue warning here" at "ol"
+new C(ol) ;
+
+// of course this is true for all superfluous properties
+// weird is not used in constructor
+new C( { s: "Hello", weird: true } );</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Restriction when initializing interface fields via @Spec constructor <a id="restriction-interface-field-spec-constructor"></a> </dt>
+<dd>
+<p>In most cases, interface definitions in <code>n4jsd</code> files simply declare functions and fields that are supposed to be provided by the runtime environment.
+As a result, there are restrictions as to whether fields of interfaces defined in <code>n4jsd</code> files can initialized via <code>@Spec</code> constructors or not.
+In particular, fields of an interface declared in a <code>n4jsd</code> file  cannot be initialized via @Spec constructor if the interface</p>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>is a built-in or</p>
+</li>
+<li>
+<p>does not have an <code>@N4JS</code> annotation</p>
+</li>
+</ol>
+</div>
+</dd>
+</dl>
+</div>
+<div class="paragraph">
+<p>The following example illustrates this restriction.</p>
+</div>
+<div class="exampleblock">
+<div class="title">Example 40. Interface fields that cannot be initialized via @Spec constructors</div>
+<div class="content">
+<div class="listingblock">
+<div class="title">Inf.n4jsd</div>
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">export external interface I  {
+    public m: string;
+}
+
+@N4JS
+export external interface J  {
+    public n: string;
+}</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="title">Test.n4js</div>
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">import { I } from "Inf";
+// I is an external interface WITHOUT @N4JS annotation
+class C implements I {
+    constructor(@Spec spec:~i~this) {}
+}
+
+// J is an external interface with @N4JS annotation
+class D implements J {
+    constructor(@Spec spec:~i~this) {}
+}
+
+// XPECT warnings --&gt; "m is a property of built-in / provided by runtime / external without @N4JS annotation interface I and can not be initialized in Spec constructor." at "m"
+let c:C = new C({m: "Hello"});
+
+// XPECT nowarnings
+let d:D = new D({n: "Bye"});
+
+console.log(c.m)
+console.log(d.n)
+
+/* XPECT output ---
+&lt;==
+stdout:
+undefined
+Bye
+stderr:
+==&gt;
+--- */</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>In this example, the interface <code>I</code> is defined in the <code>Inf.n4jsd</code> file without the <code>@N4JS</code> annotation. As a result, its field <code>m</code> cannot be initialized via the <code>@Spec</code> constructor and hence the output of <code>console.log(c.m)</code> is <code>undefined</code>. On the other hand,  since the interface <code>J</code> is declared with the annotation <code>@N4JS</code>, it is possible to initialize its field <code>n</code> in the <code>@Spec</code> constructor. That&#8217;s why the result of <code>console.log(d.n)</code> is <code>Bye</code>.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_callable-constructors"><a class="anchor" href="#_callable-constructors"></a><a class="link" href="#_callable-constructors">5.2.5.3. Callable Constructors</a></h5>
+
+</div>
+<div class="sect4">
+<h5 id="_covariant-constructors"><a class="anchor" href="#_covariant-constructors"></a><a class="link" href="#_covariant-constructors">5.2.5.4. Covariant Constructors</a></h5>
+<div class="paragraph">
+<p>Usually, the constructor of a subclass need not be override compatible with the constructor of its super class.
+By way of annotation <code>@CovariantConstructor</code> it is possible to change this default behavior and enforce all subclasses to have constructors with override compatible signatures.
+A subclass can achieve this by either inheriting the constructor from the super class (which is usually override compatible,
+with the special case of <code>@Spec</code> constructors) or by defining a new constructor with a signature compatible to the inherited constructor.
+The same rules as for method overriding apply.</p>
+</div>
+<div class="paragraph">
+<p>The <code>@CovariantConstructor</code> annotation may be applied to the constructor, the containing classifier, or both.
+It can also be used for interfaces; in fact, constructors are allowed in interfaces only if they themselves or the interface is annotated with <code>@CovariantConstructor</code> (see <a href="#Req-IDE-60">[Req-IDE-60]</a>).</p>
+</div>
+<div class="openblock definition">
+<div class="content">
+<div class="paragraph">
+<p><a id="covariant_constructor"></a><strong>Definition:</strong> <a href="#covariant_constructor">Covariant Constructor</a></p>
+</div>
+<div class="paragraph">
+<p>A classifier <code>C</code> is said to <code><em>have a covariant constructor</em></code> if and
+only if one of the following applies:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p><code>C</code> has a direct super class <math xmlns="http://www.w3.org/1998/Math/MathML"><msup><mi>C</mi><mi>'</mi></msup></math> and <math xmlns="http://www.w3.org/1998/Math/MathML"><msup><mi>C</mi><mi>'</mi></msup></math> is annotated with <code>@CovariantConstructor</code> or <math xmlns="http://www.w3.org/1998/Math/MathML"><msup><mi>C</mi><mi>'</mi></msup></math> has a constructor annotated with <code>@CovariantConstructor</code>.</p>
+</li>
+<li>
+<p><code>C</code> has a directly implemented interface <code>I and `I</code> is annotated with  <code>@CovariantConstructor</code> or <code>I</code> has a constructor annotated with <code>@CovariantConstructor</code>.</p>
+</li>
+<li>
+<p><code>C</code> has a direct super class or directly implemented interface that <code><em>has a covariant constructor</em></code> (as defined here).</p>
+</li>
+</ol>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Note that <code>C</code> does not need to have an owned(!) constructor; also a constructor inherited from a super class can be declared covariant.</p>
+</div>
+<div class="paragraph">
+<p>The following rules apply to covariant constructors.</p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-60"></a><strong>Req. IDE-60:</strong> <a href="#Req-IDE-60">Covariant Constructors</a> (ver. 1)</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Annotation <code>@CovariantConstructor</code> may only be applied to classes, interfaces, and constructors.
+Annotating a constructor with this annotation, or its containing classifier, or both have all the same effect.</p>
+</li>
+<li>
+<p>Given a class <code>C</code> with an owned constructor <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi></math> and a super class <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>S</mi><mi>u</mi><mi>p</mi></math> that has a covariant constructor (owned or inherited, see <a href="#_covariant-constructors">Covariant Constructors</a>),
+then <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>S</mi><mi>u</mi><mi>p</mi><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>s</mi><mi>t</mi><mi>r</mi><mi>u</mi><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi></math> must be accessible from <code>C</code>,</p>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi></math> must be override compatible with <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>S</mi><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>s</mi><mi>t</mi><mi>r</mi><mi>u</mi><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi></math>:</p>
+<div class="paragraph">
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>o</mi><mi>v</mi><mi>e</mi><mi>r</mi><mi>r</mi><mi>i</mi><mi>d</mi><mi>e</mi><mi>C</mi><mi>o</mi><mi>m</mi><mi>p</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>b</mi><mi>l</mi><mi>e</mi><mfenced close=")" open="("><mrow><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi></mrow><mrow><mi>S</mi><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>s</mi><mi>t</mi><mi>r</mi><mi>u</mi><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi></mrow></mfenced></math></p>
+</div>
+<div class="paragraph">
+<p>This constraint corresponds to <a href="#Req-IDE-72">[Req-IDE-72]</a> except for the <code>Override</code> annotation which is not required here.</p>
+</div>
+</li>
+</ol>
+</div>
+</li>
+<li>
+<p>Given a classifier <code>C</code> implementing interface <code>I</code> and <code>I</code> has a covariant constructor (owned or inherited, see <a href="#_covariant-constructors">Covariant Constructors</a>), we require</p>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>I</mi><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>s</mi><mi>t</mi><mi>r</mi><mi>u</mi><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi></math> must be accessible from <code>C</code>,</p>
+</li>
+<li>
+<p>an implementation-compatible constructor <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi></math> must be defined in C with</p>
+<div class="paragraph">
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>o</mi><mi>v</mi><mi>e</mi><mi>r</mi><mi>r</mi><mi>i</mi><mi>d</mi><mi>e</mi><mi>C</mi><mi>o</mi><mi>m</mi><mi>p</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>b</mi><mi>l</mi><mi>e</mi><mfenced close=")" open="("><mrow><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi></mrow><mrow><mi>I</mi><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>s</mi><mi>t</mi><mi>r</mi><mi>u</mi><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi></mrow></mfenced></math></p>
+</div>
+<div class="paragraph">
+<p>This constraint corresponds to <a href="#Req-IDE-74">[Req-IDE-74]</a> except for the <code>@Override</code> annotation, which is not required, here.</p>
+</div>
+</li>
+<li>
+<p>Given a classifier <code>C</code> without an owned constructor and an extended class or interface <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>S</mi><mi>u</mi><mi>p</mi></math> that has a covariant constructor (owned or inherited, see <a href="#_covariant-constructors">Covariant Constructors</a>),
+we require the inherited constructor <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi></math> of <code>C</code> within the context of <code>C</code> to be override compatible to itself in the context of <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>S</mi><mi>u</mi><mi>p</mi></math>.
+Using notation <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>m</mi><mfenced close="]" open="["><mi>T</mi></mfenced></math> to denote that a member <code>M</code> is to be treated as defined in container type <code>T</code>, which means the this-binding is set to <code>T</code>, we can write:</p>
+<div class="paragraph">
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>o</mi><mi>v</mi><mi>e</mi><mi>r</mi><mi>r</mi><mi>i</mi><mi>d</mi><mi>e</mi><mi>C</mi><mi>o</mi><mi>m</mi><mi>p</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>b</mi><mi>l</mi><mi>e</mi><mfenced close=")" open="("><mrow><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi><mfenced close="]" open="["><mi>C</mi></mfenced></mrow><mrow><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi><mfenced close="]" open="["><mrow><mi>S</mi><mi>u</mi><mi>p</mi></mrow></mfenced></mrow></mfenced></math></p>
+</div>
+<div class="paragraph">
+<p>This constraint does not correspond to any of the constraints for the redefinition of ordinary members.</p>
+</div>
+</li>
+</ol>
+</div>
+</li>
+</ol>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>The following example demonstrates a use case for covariant constructors.
+It shows a small class hierarchy using covariant constructors, <code>Cls</code> and <code>Cls2</code>, together with a helper function <code>createAnother</code> that creates and returns a new instance of the same type as its argument <code>value</code>.</p>
+</div>
+<div id="ex:covariant_constructors" class="exampleblock">
+<div class="title">Example 41. Covariant Constructors</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">class A {}
+class B extends A {}
+
+@CovariantConstructor
+class Cls {
+    constructor(p: B) {}
+}
+class Cls2 extends Cls {
+    constructor(p: A) { // it's legal to generalize the type of parameter 'p'
+        super(null);
+    }
+}
+
+function &lt;T extends Cls&gt; createAnother(value: T, p: B): T {
+    let ctor = value.constructor;
+    return new ctor(p);
+}
+
+let x = new Cls2(new A());
+let y: Cls2;
+
+y = createAnother(x, new B());</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>In the code of <a href="#ex:covariant_constructors">Covariant Constructors</a>, we would get an error if we changed the type of parameter <code>p</code> in the constructor of <code>Cls2</code> to some other type that
+is not a super type of <code>B</code>, i.e. the type of the corresponding parameter of <code>Cls</code>’s constructor.
+If we removed the <code>@CovariantConstructor</code> annotation on <code>Cls</code>, we would get an error in the new expression inside function <code>createAnother</code>.</p>
+</div>
+<div class="paragraph">
+<p>The next example illustrates how to use <code>@CovariantConstructor</code> with interfaces and shows a behavior that might be surprising at first sight.</p>
+</div>
+<div id="ex:covariant-constructors-in-interfaces" class="exampleblock">
+<div class="title">Example 42. Covariant Constructors in Interfaces</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">@CovariantConstructor
+interface I {
+    constructor(p: number)
+}
+
+class C implements I {
+    // no constructor required!
+}
+
+class D extends C {
+    // XPECT errors --&gt; "Signature of constructor of class D does not conform to overridden constructor of class N4Object: {function(number)} is not a subtype of {function()}." at "constructor"
+    constructor(p: number) {}
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Interface <code>I</code> declares a covariant constructor expecting a single parameter of type <code>number</code>.
+Even though class <code>C</code> implements <code>I</code>, it does not need to define an owned constructor with such a parameter.
+According to <a href="#Req-IDE-60">[Req-IDE-60]</a>, it is enough for <code>C</code> to have a constructor, either owned or inherited, that is override compatible with the one declared by <code>I</code>.
+Class <code>C</code> inherits the default constructor from <code>N4Object</code>, which does not have any arguments and is thus override compatible to <code>I</code>’s constructor.</p>
+</div>
+<div class="paragraph">
+<p>In addition, subclasses are now required to have constructors which are override compatible with the constructor of class <code>C</code>, i.e. the one inherited from <code>N4Object</code>.
+<a href="#ex:covariant-constructors-in-interfaces">Covariant Constructors in Interfaces</a> shows that this is violated even when repeating the exact same constructor signature from interface <code>I</code>,
+because that constructor now appears on the other side of the subtype test during checking override compatibility.</p>
+</div>
+</div>
+</div>
+<div class="sect3 language-n4js">
+<h4 id="_data-fields"><a class="anchor" href="#_data-fields"></a><a class="link" href="#_data-fields">5.2.6. Data Fields</a></h4>
+<div class="paragraph">
+<p>A data field is a simple property of a class.
+There must be no getter or setter defined with the same name as the data field.
+In ECMAScript 6, a class has no explicit data fields.
+It is possible, however, to implicitly define a data field by simply assigning a value to a variable of the this element (e.g. <code>this.x = 10</code> implicitly defines a field <code>x</code>).
+Data fields in N4JS are similar to these implicit fields in ECMAScript 6 except that they are defined explicitly in order to simplify validation and user assistance.</p>
+</div>
+<div class="sect4">
+<h5 id="data-fields-syntax"><a class="anchor" href="#data-fields-syntax"></a><a class="link" href="#data-fields-syntax">5.2.6.1. Syntax</a></h5>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">N4FieldDeclaration &lt;Yield&gt;:
+    {N4FieldDeclaration}
+    FieldDeclarationImpl&lt;Yield&gt;
+;
+
+fragment FieldDeclarationImpl &lt;Yield&gt;*:
+    (declaredModifiers+=N4Modifier)* BogusTypeRefFragment?
+    declaredName=LiteralOrComputedPropertyName&lt;Yield&gt;
+    (declaredOptional?='?')?
+    ColonSepTypeRef?
+    ('=' expression=Expression&lt;In=true,Yield&gt;)?
+    Semi
+;</code></pre>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="data-fields-properties"><a class="anchor" href="#data-fields-properties"></a><a class="link" href="#data-fields-properties">5.2.6.2. Properties</a></h5>
+<div class="paragraph">
+<p>Fields have the following properties which can be explicitly defined:</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><code>declaredOptional</code> </dt>
+<dd>
+<p>Tells whether the accessor was declared optional.</p>
+</dd>
+<dt class="hdlist1"><code>typeRef</code> </dt>
+<dd>
+<p>Type of the field; default value is <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>A</mi><mi>n</mi><mi>y</mi></math>.</p>
+</dd>
+<dt class="hdlist1"><code>expr</code> </dt>
+<dd>
+<p>Initializer expression, i.e. sets default value.</p>
+</dd>
+<dt class="hdlist1"><code>static</code> </dt>
+<dd>
+<p>Boolean flag set to true if field is a static field.</p>
+</dd>
+<dt class="hdlist1"><code>const</code> </dt>
+<dd>
+<p>Boolean flag set to true if field cannot be changed. Note that const fields are automatically static.
+Const fields need an initializer. Also see <a href="#_assignment-modifiers">Assignment Modifiers</a>.</p>
+</dd>
+</dl>
+</div>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title=""></i>
+</td>
+<td class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>c</mi><mi>o</mi><mi>n</mi><mi>s</mi><mi>t</mi></math> is <em>not</em> the (reversed) value of the property descriptor <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>w</mi><mi>r</mi><mi>i</mi><mi>t</mi><mi>a</mi><mi>b</mi><mi>l</mi><mi>e</mi></math> as the latter is checked at runtime while const may or may not be checked at runtime.
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>The following pseudo properties are defined via annotations for setting the values of the property descriptor:</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><code>enumerable</code> </dt>
+<dd>
+<p>Boolean flag reflecting the property descriptor <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>e</mi><mi>n</mi><mi>u</mi><mi>m</mi><mi>e</mi><mi>r</mi><mi>a</mi><mi>b</mi><mi>l</mi><mi>e</mi></math>, set via annotation <code>@Enumerable(true|false)</code>.
+The default value is <math xmlns="http://www.w3.org/1998/Math/MathML"><mstyle mathvariant="monospace"><mtext>true</mtext></mstyle></math>.<sup class="footnote">[<a id="_footnoteref_32" class="footnote" href="appendix_c_bibliography.html#_footnote_32" title="View footnote.">32</a>]</sup></p>
+</dd>
+<dt class="hdlist1"><code>declaredWriteable</code> </dt>
+<dd>
+<p>Boolean flag reflecting the property descriptor <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>w</mi><mi>r</mi><mi>i</mi><mi>t</mi><mi>e</mi><mi>a</mi><mi>b</mi><mi>l</mi><mi>e</mi></math>, set via annotation <code>@Writeable(true|false)</code>.
+The default value is <math xmlns="http://www.w3.org/1998/Math/MathML"><mstyle mathvariant="monospace"><mtext>true</mtext></mstyle></math>.<sup class="footnote">[<a id="_footnoteref_33" class="footnote" href="appendix_c_bibliography.html#_footnote_33" title="View footnote.">33</a>]</sup></p>
+</dd>
+<dt class="hdlist1"><code>final</code> </dt>
+<dd>
+<p>Boolean flag making the field read-only, and it must be set in the constructor. Also see <a href="#_assignment-modifiers">Assignment Modifiers</a>.</p>
+</dd>
+</dl>
+</div>
+<h6 id="data-fields-derived-values" class="discrete">Derived values for fields</h6>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><code>readable</code> </dt>
+<dd>
+<p>Always true for fields.</p>
+</dd>
+<dt class="hdlist1"><code>abstract</code> </dt>
+<dd>
+<p>Always false for fields.</p>
+</dd>
+<dt class="hdlist1"><code>writeable</code> </dt>
+<dd>
+<p>Set to false if field is declared const or final. In the latter case, it may be set in the constructor (cf. <a href="#_assignment-modifiers">Assignment Modifiers</a>).</p>
+</dd>
+</dl>
+</div>
+<div class="sect5">
+<h6 id="data-fields-semantics"><a class="anchor" href="#data-fields-semantics"></a><a class="link" href="#data-fields-semantics">5.2.6.2.1. Semantics</a></h6>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-61"></a><strong>Req. IDE-61:</strong> <a href="#Req-IDE-61">Attributes</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>For any attribute <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>a</mi></math> if a
+class <code>C</code>, the following constraints must hold:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>A required data field must not define an initializer:<br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>a</mi><mo>.</mo><mi>r</mi><mi>e</mi><mi>q</mi><mi>u</mi><mi>i</mi><mi>r</mi><mi>e</mi><mi>d</mi><mo>⇒</mo><mi>a</mi><mo>.</mo><mi>i</mi><mi>n</mi><mi>i</mi><mi>t</mi><mo>=</mo><mi>n</mi><mi>u</mi><mi>l</mi><mi>l</mi></math></p>
+</li>
+<li>
+<p>There must be no other member with the same name of a data field <code>f</code>.
+In particular, there must be no getter or setter defined with the same name:<br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mo>∀</mo><mi> </mi><mi>m</mi><mo>∈</mo><mi>f</mi><mo>.</mo><mi>o</mi><mi>w</mi><mi>n</mi><mi>e</mi><mi>r</mi><mo>.</mo><mi>m</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi><mi>s</mi><mi>:</mi><mi>m</mi><mo>≠</mo><mi>f</mi><mo>⇒</mo><mi>m</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>≠</mo><mi>f</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi></math></p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>If a subclass should set a different default value, this has to be done in the constructor of the subclass.</p>
+</div>
+<div class="paragraph">
+<p>For the relation of data fields and field accessors in the context of extending classes or implementing interfaces see <a href="#_redefinition-of-members">Redefinition of Members</a>.</p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect5">
+<h6 id="data-fields-type-inference"><a class="anchor" href="#data-fields-type-inference"></a><a class="link" href="#data-fields-type-inference">5.2.6.2.2. Type Inference</a></h6>
+<div class="paragraph">
+<p>The type of a field is the type of its declaration:</p>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow/><mrow><mi>Γ</mi><mo>⊢</mo><mi>f</mi><mi>:</mi><mi>Γ</mi><mo>⊢</mo><mi>d</mi></mrow></mfrac></math>
+</div>
+</div>
+<div class="paragraph">
+<p>The type of a field declaration is either the declared type or the inferred type of the initializer expression:</p>
+</div>
+<div class="paragraph">
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mfrac><mrow><mi>d</mi><mo>.</mo><mi>d</mi><mi>e</mi><mi>c</mi><mi>l</mi><mi>a</mi><mi>r</mi><mi>e</mi><mi>d</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi><mo>≠</mo><mstyle mathvariant="monospace"><mtext>null</mtext></mstyle><mspace width="3.0mm"/><mi>T</mi><mo>=</mo><mi>d</mi><mo>.</mo><mi>d</mi><mi>e</mi><mi>c</mi><mi>l</mi><mi>a</mi><mi>r</mi><mi>e</mi><mi>d</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mi>d</mi><mi>:</mi><mi>T</mi></mrow></mfrac></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mfrac><mrow><mi>d</mi><mo>.</mo><mi>d</mi><mi>e</mi><mi>c</mi><mi>l</mi><mi>a</mi><mi>r</mi><mi>e</mi><mi>d</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>null</mtext></mstyle><mspace width="3.0mm"/><mi>d</mi><mo>.</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>e</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>o</mi><mi>n</mi><mo>≠</mo><mstyle mathvariant="monospace"><mtext>null</mtext></mstyle></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mi>d</mi><mi>:</mi><mi>T</mi></mrow></mfrac></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mi>E</mi><mo>=</mo><mi>Γ</mi><mo>⊢</mo><mi>d</mi><mo>.</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>e</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>o</mi><mi>n</mi><mspace width="3.0mm"/><mi>E</mi><mo>∉</mo><mfenced close="}" open="{"><mstyle mathvariant="monospace"><mtext>null, undefined</mtext></mstyle></mfenced><mspace width="3.0mm"/><mi>T</mi><mo>=</mo><mi>E</mi><mi>}</mi></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mfrac><mrow><mi>e</mi><mi>l</mi><mi>s</mi><mi>e</mi></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mi>d</mi><mi>:</mi><mstyle mathvariant="monospace"><mtext>any</mtext></mstyle></mrow></mfrac></math></p>
+</div>
+<div class="paragraph">
+<p>If the type contains type variables they are substituted according to
+type parameters which are provided by the reference:</p>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><mi>Γ</mi><mo>⊢</mo><mi>t</mi><mi>f</mi><mi>i</mi><mi>e</mi><mi>l</mi><mi>d</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mi>:</mi><mi>T</mi></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mstyle mathvariant="monospace"><mtext>TField</mtext></mstyle><mi> </mi><mi>t</mi><mi>f</mi><mi>i</mi><mi>e</mi><mi>l</mi><mi>d</mi><mi>:</mi><mi>T</mi></mrow></mfrac></math>
+</div>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_assignment-modifiers"><a class="anchor" href="#_assignment-modifiers"></a><a class="link" href="#_assignment-modifiers">5.2.6.3. Assignment Modifiers</a></h5>
+<div class="paragraph">
+<p>Assignment of data fields can be modified by the assignment modifiers <code>const</code> (similar to constant variable declarations, see <a href="statements.html#_const">Const</a>) and <code>@Final</code>.</p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-62"></a><strong>Req. IDE-62:</strong> <a href="#Req-IDE-62">Const Data Fields</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>For a data field <code>f</code> marked as <code>const</code>, the following constraints must hold:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>An initializer expression must be provided in the declaration (except in n4jsd files):<br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>f</mi><mo>.</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mo>≠</mo><mstyle mathvariant="monospace"><mtext>null</mtext></mstyle></math></p>
+</li>
+<li>
+<p>A constant data field is implicitly static and must be accessed only via the classifier type.
+It is not possible, therefore, to use the <code>this</code> keyword in the initializer expression of a constant field:<br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∄</mo><mi>s</mi><mi>u</mi><mi>b</mi><mo>∈</mo><mi>f</mi><mo>.</mo><mi>e</mi><mi>x</mi><mi>p</mi><msup><mi>r</mi><mo>*</mo></msup><mi>:</mi><mi>s</mi><mi>u</mi><mi>b</mi><mo>=</mo><mi>"</mi><mi>t</mi><mi>h</mi><mi>i</mi><mi>s</mi><mi>"</mi></math></p>
+</li>
+<li>
+<p>A constant data field must not be annotated with <code>@Final</code>:<br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>f</mi><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>s</mi><mi>t</mi><mo>→</mo><mo>¬</mo><mi>f</mi><mo>.</mo><mi>f</mi><mi>i</mi><mi>n</mi><mi>a</mi><mi>l</mi></math></p>
+</li>
+<li>
+<p>Constant data fields are not writeable (cf. <a href="#Req-IDE-68">[Req-IDE-68]</a>):<br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>f</mi><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>s</mi><mi>t</mi><mo>→</mo><mo>¬</mo><mi>f</mi><mo>.</mo><mi>w</mi><mi>r</mi><mi>i</mi><mi>t</mi><mi>e</mi><mi>a</mi><mi>b</mi><mi>l</mi><mi>e</mi></math></p>
+</li>
+</ol>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-63"></a><strong>Req. IDE-63:</strong> <a href="#Req-IDE-63">Final Data Fields</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>For a data field <code>f</code> marked as <code>@Final</code>, the following constraints must hold:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>A final data field must not be modified with <code>const</code> or <code>static</code>:<br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>f</mi><mo>.</mo><mi>f</mi><mi>i</mi><mi>n</mi><mi>a</mi><mi>l</mi><mo>→</mo><mo>¬</mo><mi>f</mi><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>s</mi><mi>t</mi><mo>∧</mo><mo>¬</mo><mi>f</mi><mo>.</mo><mi>d</mi><mi>e</mi><mi>c</mi><mi>l</mi><mi>a</mi><mi>r</mi><mi>e</mi><mi>d</mi><mi>S</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>c</mi></math></p>
+</li>
+<li>
+<p>A final data field is not writeable:<br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>f</mi><mo>.</mo><mi>f</mi><mi>i</mi><mi>n</mi><mi>a</mi><mi>l</mi><mo>→</mo><mo>¬</mo><mi>f</mi><mo>.</mo><mi>w</mi><mi>r</mi><mi>i</mi><mi>t</mi><mi>e</mi><mi>a</mi><mi>b</mi><mi>l</mi><mi>e</mi></math><br>
+A final field may, however, be set in the constructor.
+See <a href="#Req-IDE-68">[Req-IDE-68]</a> for details.</p>
+</li>
+<li>
+<p>A final data field must be either initialized by an initializer expression or in the constructor.
+If the field is initialized in the constructor, this may be done either explicitly or via a spec style constructor.</p>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mtable><mtr><mtd><mspace width="3.0mm"/><mi>f</mi><mo>.</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mo>≠</mo><mstyle mathvariant="monospace"><mtext>null</mtext></mstyle></mtd></mtr><mtr><mtd><mspace width="3.0mm"/><mo>∨</mo><mrow><mo>(</mo><mo>∃</mo><mi>a</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>g</mi><mi>n</mi><mi>E</mi><mi>x</mi><mi>p</mi><mi>:</mi><mi>a</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>g</mi><mi>n</mi><mi>E</mi><mi>x</mi><mi>p</mi><mi>r</mi><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>t</mi><mi>a</mi><mi>i</mi><mi>n</mi><mi>i</mi><mi>n</mi><mi>g</mi><mi>F</mi><mi>u</mi><mi>n</mi><mi>c</mi><mi>t</mi><mi>i</mi><mi>o</mi><mi>n</mi><mo>=</mo><mi>f</mi><mo>.</mo><mi>o</mi><mi>w</mi><mi>n</mi><mi>e</mi><mi>r</mi><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>s</mi><mi>t</mi><mi>r</mi><mi>u</mi><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi></mrow></mtd></mtr><mtr><mtd><mspace width="3.0mm"/><mspace width="3.0em"/><mo>∧</mo><mi>a</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>g</mi><mi>n</mi><mi>E</mi><mi>x</mi><mi>p</mi><mi>r</mi><mo>.</mo><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi><mo>.</mo><mi>t</mi><mi>a</mi><mi>r</mi><mi>g</mi><mi>e</mi><mi>t</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>"this"</mtext></mstyle></mtd></mtr><mtr><mtd><mrow><mspace width="3.0mm"/><mspace width="3.0em"/><mo>∧</mo><mi>b</mi><mi>i</mi><mi>n</mi><mi>d</mi><mfenced close=")" open="("><mrow><mi>a</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>g</mi><mi>n</mi><mi>E</mi><mi>x</mi><mi>p</mi><mi>r</mi><mo>.</mo><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi><mo>.</mo><mi>p</mi><mi>r</mi><mi>o</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>t</mi><mi>y</mi></mrow><mi>f</mi></mfenced><mo>)</mo></mrow></mtd></mtr><mtr><mtd><mspace width="3.0mm"/><mo>∨</mo><mrow><mo>(</mo><mi>f</mi><mo>.</mo><mi>p</mi><mi>u</mi><mi>b</mi><mi>l</mi><mi>i</mi><mi>c</mi><mo>∧</mo><mo>∃</mo><mi>f</mi><mi>p</mi><mi>a</mi><mi>r</mi><mo>∈</mo><mi>f</mi><mo>.</mo><mi>o</mi><mi>w</mi><mi>n</mi><mi>e</mi><mi>r</mi><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>s</mi><mi>t</mi><mi>r</mi><mi>u</mi><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi><mo>.</mo><mi>f</mi><mi>p</mi><mi>a</mi><mi>r</mi><mi>s</mi><mi>:</mi></mrow></mtd></mtr><mtr><mtd><mrow><mspace width="3.0mm"/><mspace width="3.0em"/><mi>f</mi><mi>p</mi><mi>a</mi><mi>r</mi><mo>.</mo><mi>s</mi><mi>p</mi><mi>e</mi><mi>c</mi><mo>∧</mo><mo>∃</mo><mi>s</mi><mi>m</mi><mo>∈</mo><mi>s</mi><mi>t</mi><mi>r</mi><mi>u</mi><mi>c</mi><mi>t</mi><mi>u</mi><mi>r</mi><mi>a</mi><mi>l</mi><mi>M</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi><mi>s</mi><mi>:</mi><mi>s</mi><mi>m</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><mi>f</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>)</mo></mrow></mtd></mtr></mtable></math>
+</div>
+</div>
+</li>
+</ol>
+</div>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_field-accessors-getter-setter"><a class="anchor" href="#_field-accessors-getter-setter"></a><a class="link" href="#_field-accessors-getter-setter">5.2.6.4. Field Accessors (Getter/Setter)</a></h5>
+<div class="paragraph">
+<p>Instead of a simple data field, a field can be defined by means of the getter and setter accessor methods.
+These accessor methods are similar to the accuser methods in object literals:</p>
+</div>
+<div class="sect5">
+<h6 id="field-acessors-syntax"><a class="anchor" href="#field-acessors-syntax"></a><a class="link" href="#field-acessors-syntax">5.2.6.4.1. Syntax</a></h6>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">N4GetterDeclaration &lt;Yield&gt;:
+    =&gt; ({N4GetterDeclaration}
+    (declaredModifiers+=N4Modifier)*
+    GetterHeader&lt;Yield&gt;)
+    (body=Block&lt;Yield&gt;)? ';'?
+;
+
+fragment GetterHeader &lt;Yield&gt;*:
+    BogusTypeRefFragment? 'get' -&gt; declaredName=LiteralOrComputedPropertyName&lt;Yield&gt;
+    (declaredOptional?='?')?
+    '(' ')'
+    ColonSepTypeRef?
+;
+
+N4SetterDeclaration &lt;Yield&gt;:
+    =&gt;({N4SetterDeclaration}
+        (declaredModifiers+=N4Modifier)*
+        'set'
+        -&gt;declaredName=LiteralOrComputedPropertyName &lt;Yield&gt;
+    )
+    (declaredOptional?='?')?
+    '(' fpar=FormalParameter&lt;Yield&gt; ')' (body=Block&lt;Yield&gt;)? ';'?
+;</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Notes with regard to syntax: Although ECMAScript 6 does not define fields in classes, it defines getter and setter methods similarly (cf. [<a href="appendix_c_bibliography.html#ECMA15a">ECMA15a(p.S13.3, p.p.209)</a>]).</p>
+</div>
+<div class="exampleblock">
+<div class="title">Example 43. Getter and Setter</div>
+<div class="content">
+<div class="paragraph">
+<p>The getter and setter implementations usually reference data fields internally.
+These are to be declared explicitly (although ECMAScript allows creating fields on the fly on their first usage).
+The following example demonstrates a typical usage of getter and setter in combination with a data field.
+The getter lazily initializes the field on demand.
+The setter performs some notification.</p>
+</div>
+<div class="listingblock">
+<div class="title">Getter Setter</div>
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">class A {}
+
+class C {
+    private _data: A = null;
+
+    public get data(): A {
+        if (this._data==null) {
+            this._data = new A();
+        }
+        return this._data;
+    }
+
+    public set data(data: A) {
+        this._data = data;
+        this.notifyListeners();
+    }
+
+    notifyListeners(): void {
+        // ...
+    }
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect5">
+<h6 id="field-acessors-properties"><a class="anchor" href="#field-acessors-properties"></a><a class="link" href="#field-acessors-properties">5.2.6.4.2. Properties</a></h6>
+<div class="paragraph">
+<p>Properties for field accessors:</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><code>declaredOptional</code> </dt>
+<dd>
+<p>Tells whether the accessor was declared optional.</p>
+</dd>
+<dt class="hdlist1"><code>readable</code> </dt>
+<dd>
+<p>Derived value: true for getters and false for setters.</p>
+</dd>
+<dt class="hdlist1"><code>writable</code> </dt>
+<dd>
+<p>Derived value: false for getters and true for setters.</p>
+</dd>
+</dl>
+</div>
+</div>
+<div class="sect5">
+<h6 id="field-accessors-semantics"><a class="anchor" href="#field-accessors-semantics"></a><a class="link" href="#field-accessors-semantics">5.2.6.4.3. Semantics</a></h6>
+<div class="paragraph">
+<p>There must be no field or method with the same name as a field accessor (follows from <a href="#Req-IDE-52">[Req-IDE-52]</a>). In addition, the following constraints must hold:</p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-64"></a><strong>Req. IDE-64:</strong> <a href="#Req-IDE-64">Field Accessors</a> (ver. 1)</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>The return type of a getter must not be <code>void</code>.</p>
+</li>
+<li>
+<p>The type of the parameter of a setter must not be <code>void</code>.</p>
+</li>
+<li>
+<p>If a getter <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>g</mi></math> is defined or consumed (from an interface) or merged-in (via static polyfill) in a class <code>C</code> and a setter <code>S</code> with <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>s</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><mi>g</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>∧</mo><mi>s</mi><mo>.</mo><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>c</mi><mo>=</mo><mi>g</mi><mo>.</mo><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>c</mi></math> is inherited by
+<code>C</code> from one of its super classes, then <code>C</code> must define a setter <math xmlns="http://www.w3.org/1998/Math/MathML"><msup><mi>s</mi><mi>'</mi></msup></math> with
+<math xmlns="http://www.w3.org/1998/Math/MathML"><msup><mi>s</mi><mi>'</mi></msup><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><mi>g</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>∧</mo><msup><mi>s</mi><mi>'</mi></msup><mo>.</mo><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>c</mi><mo>=</mo><mi>g</mi><mo>.</mo><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>c</mi></math> <sup class="footnote">[<a id="_footnoteref_34" class="footnote" href="appendix_c_bibliography.html#_footnote_34" title="View footnote.">34</a>]</sup>.</p>
+</li>
+<li>
+<p>A setter must have exactly one formal parameter, i.e. variadic or default modifiers are not allowed.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>The same applies to setters, accordingly.</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><a href="#Req-IDE-72">[Req-IDE-72]</a>, <a href="#Req-IDE-73">[Req-IDE-73]</a>, and <a href="#Req-IDE-74">[Req-IDE-74]</a> apply to field accessors accordingly (getter / setter overriding).</p>
+</li>
+</ul>
+</div>
+<div class="admonitionblock note language-n4js">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title=""></i>
+</td>
+<td class="content">
+A getter and setter with the same name need not have the same type, i.e. the getter’s return type need not be the same as a subtype of
+the type of the setter’s parameter (the types can be completely unrelated).<sup class="footnote">[<a id="_footnoteref_35" class="footnote" href="appendix_c_bibliography.html#_footnote_35" title="View footnote.">35</a>]</sup>
+</td>
+</tr>
+</table>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Getters and setters – like functions – define a variable execution environment and therefore provide access to the actual passed-in parameters through the implicit <code>arguments</code>
+variable inside of their bodies (c.f. <a href="functions.html#_arguments-object">Arguments Object</a>).</p>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="optional-fields"><a class="anchor" href="#optional-fields"></a><a class="link" href="#optional-fields">5.2.6.5. Optional Fields</a></h5>
+<div class="paragraph">
+<p>Data fields and field accessors of a classifier C can be declared optional, meaning that a structural subtype of C
+need not provide this field, but if it does, the field must be of correct type. However, to ensure overall type safety,
+the scope of application of this optionality is limited to a small number of specific use cases, as described in the
+following.</p>
+</div>
+<div class="sect5">
+<h6 id="_syntax-6"><a class="anchor" href="#_syntax-6"></a><a class="link" href="#_syntax-6">5.2.6.5.1. Syntax</a></h6>
+<div class="paragraph">
+<p>To denote a data field or accessor as optional, a question mark is placed right after the name:</p>
+</div>
+<div class="listingblock">
+<div class="title">Syntax of optional fields</div>
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">class C {
+    public field?: string;
+
+    public get getter?(): number {
+        return 42;
+    }
+    public set setter?(value: number) {}
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>The detailed grammar is given in the sections for data fields, cf. <a href="#data-fields-syntax">Syntax</a>,
+and field accessors, cf. <a href="#field-acessors-syntax">Syntax</a>.</p>
+</div>
+</div>
+<div class="sect5">
+<h6 id="_semantics-5"><a class="anchor" href="#_semantics-5"></a><a class="link" href="#_semantics-5">5.2.6.5.2. Semantics</a></h6>
+<div class="paragraph">
+<p>It is important to note that the optionality of a field is, by default and in most cases, ignored and
+has an effect only in certain special cases.</p>
+</div>
+<div class="paragraph">
+<p>The effect of a field being optional is defined by the following requirement.</p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-240500"></a><strong>Req. IDE-240500:</strong> <a href="#Req-IDE-240500">Optional Fields</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>By default, a data field, getter, or setter that is declared optional is handled in the
+exact same way as if no optionality were involved (i.e. by default, optionality is ignored).</p>
+</div>
+<div class="paragraph">
+<p>Optionality has an effect only in case of structural subtype checks <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>L</mi><mo>&lt;</mo><mi>:</mi><mi>R</mi></math> in which
+the left-hand side is one of the following:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>an object literal.</p>
+</li>
+<li>
+<p>a new expression.</p>
+</li>
+<li>
+<p>an instance of a final class, i.e. the type of the value on left-hand side must be nominal and refer to a final class.</p>
+</li>
+<li>
+<p>a reference to a const variable if its initializer expression is one of the following:</p>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p>an object literal.</p>
+</li>
+<li>
+<p>a new expression.</p>
+</li>
+<li>
+<p>an instance of a final class (as explained above).</p>
+</li>
+<li>
+<p>an ternary expression</p>
+</li>
+</ol>
+</div>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>and then</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>in cases 1 and 4a, <strong>both</strong> fields and accessors (getters and setters) are optional.
+That means, an optional data field, getter, or setter of <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>R</mi></math> needs not be present in <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>L</mi></math>.</p>
+</li>
+<li>
+<p>in cases 2, 3, 4b, and 4c, only <strong>getters</strong> are optional, setters are not optional.
+That means, an optional getter of <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>R</mi></math> needs not be present in <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>L</mi></math> and an optional field of <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>R</mi></math> requires only a setter in <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>L</mi></math>. Note that these cases are more restricted than the cases 1 and 4a.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Moreover, optionality has an effect in case of ternary expression <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>L</mi><mo>&lt;</mo><mi>:</mi><mi>R</mi></math> in which the left-hand side is a ternary expression, e.g. <code>l = b? trueExpr : falseExpr</code> whose <code>trueExpr</code> or <code>falseExpr</code> possibly recursively contains an expression of the kind mentioned above. In this case, the optionality effect is the more restricted optinality of <code>trueExpr</code> and <code>falseExpr</code>.</p>
+</div>
+<div class="paragraph">
+<p>If, according to these rules, a data field / getter / setter of <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>R</mi></math> need not be present in
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>L</mi></math> but a member with the same name and access is actually present in <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>L</mi></math>, that member in <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>L</mi></math>
+must be a data field / getter / setter of the same type / a subtype / a super type, respectively.
+In other words, if a not actually required member is present in the subtype, ordinary rules
+for member compatibility apply as if no optionality were involved (cf. general subtyping rules
+for structural types).</p>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>In other words, in object literals (cases 1 and 4a) neither optional getters, optional setters,
+nor optional data fields are required. However, in case of new expressions and instances of
+final classes (cases 2, 3, 4b, 4c) only optional getters are not required in a subtype;
+optional setters are required as normal (i.e. optionality ignored) and optional data fields
+require at least a setter.</p>
+</div>
+<div class="paragraph">
+<p>The following table summarizes the most common cases and shows how this relates to the different
+forms of structural typing.</p>
+</div>
+<table id="tab:optionalFields" class="tableblock frame-all grid-all spread">
+<caption class="title">Table 7. Optional Fields</caption>
+<colgroup>
+<col style="width: 25%;">
+<col style="width: 8.3333%;">
+<col style="width: 8.3333%;">
+<col style="width: 8.3333%;">
+<col style="width: 8.3333%;">
+<col style="width: 8.3333%;">
+<col style="width: 8.3333%;">
+<col style="width: 25.0002%;">
+</colgroup>
+<tbody>
+<tr>
+<th class="tableblock halign-left valign-top"></th>
+<td class="tableblock halign-center valign-top" colspan="5"><p class="tableblock">&#916;</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">Case</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Comment</p></td>
+</tr>
+<tr>
+<th class="tableblock halign-left valign-top"></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>~</code></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>~~</code></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>~w~</code></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>~r~</code></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>~i~</code></p></td>
+<td class="tableblock halign-center valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+</tr>
+<tr>
+<th class="tableblock halign-left valign-top"></th>
+<td class="tableblock halign-center valign-top" colspan="3"><p class="tableblock">may have setter</p></td>
+<td class="tableblock halign-center valign-top" colspan="2"><p class="tableblock">never has setter</p></td>
+<td class="tableblock halign-center valign-top"></td>
+<td class="tableblock halign-center valign-top"></td>
+</tr>
+<tr>
+<th class="tableblock halign-left valign-top"><p class="tableblock"><code>let x: &#916;C = {};</code></p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">1</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">nothing mandatory</p></td>
+</tr>
+<tr>
+<th class="tableblock halign-left valign-top"><p class="tableblock"><code>let x: &#916;C = new D0();</code></p></th>
+<td class="tableblock halign-center valign-top"></td>
+<td class="tableblock halign-center valign-top"></td>
+<td class="tableblock halign-center valign-top"></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">2</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">setters mandatory</p></td>
+</tr>
+<tr>
+<th class="tableblock halign-left valign-top"><p class="tableblock"><code>let x: &#916;C = new DG();</code></p></th>
+<td class="tableblock halign-center valign-top"></td>
+<td class="tableblock halign-center valign-top"></td>
+<td class="tableblock halign-center valign-top"></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">2</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">setters mandatory</p></td>
+</tr>
+<tr>
+<th class="tableblock halign-left valign-top"><p class="tableblock"><code>let x: &#916;C = new DS();</code></p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">2</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">setters mandatory</p></td>
+</tr>
+<tr>
+<th class="tableblock halign-left valign-top"><p class="tableblock"><code>let x: &#916;C = fooD0();</code></p></th>
+<td class="tableblock halign-center valign-top"></td>
+<td class="tableblock halign-center valign-top"></td>
+<td class="tableblock halign-center valign-top"></td>
+<td class="tableblock halign-center valign-top"></td>
+<td class="tableblock halign-center valign-top"></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">none</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">D0 not final</p></td>
+</tr>
+<tr>
+<th class="tableblock halign-left valign-top"><p class="tableblock"><code>let x: &#916;C = fooSF0();</code></p></th>
+<td class="tableblock halign-center valign-top"></td>
+<td class="tableblock halign-center valign-top"></td>
+<td class="tableblock halign-center valign-top"></td>
+<td class="tableblock halign-center valign-top"></td>
+<td class="tableblock halign-center valign-top"></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">none</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">fooSF0() not nominal</p></td>
+</tr>
+<tr>
+<th class="tableblock halign-left valign-top"><p class="tableblock"><code>let x: &#916;C = fooF0();</code></p></th>
+<td class="tableblock halign-center valign-top"></td>
+<td class="tableblock halign-center valign-top"></td>
+<td class="tableblock halign-center valign-top"></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">3</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">setters mandatory</p></td>
+</tr>
+</tbody>
+</table>
+<div class="paragraph">
+<p>In the table, a "✓" means that the particular example is valid; in all other cases an error would
+be shown in N4JS source code. Here are the classes and functions used in the above table:</p>
+</div>
+<div class="listingblock">
+<div class="title">Classes and functions used in table</div>
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">class C {
+    public field?: string;
+}
+
+class D0 {}
+
+class DG {
+    public get field(): string { return "hello"; }
+}
+
+class DS {
+    public set field(value: string) {}
+}
+
+@Final class F0 {}
+
+function fooD0(): D0   { return new D0(); }
+function fooSF0(): ~F0 { return new F0(); }
+function fooF0(): F0   { return new F0(); }</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>It follows from the above definitions in Requirements <a href="#Req-IDE-240500">[Req-IDE-240500]</a> that cases 4a and 4b are not
+transitive across a chain of several <code>const</code> variables, whereas case 4c is transitive. For example:</p>
+</div>
+<div class="listingblock">
+<div class="title">Transitivity of the use cases of optional fields</div>
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">class C {
+	public get getter?(): string {return null;}
+}
+class D {}
+@Final class F {}
+
+let c: ~C;
+
+
+// no transitivity via several const variables in use case "object literal":
+
+const ol1 = {};
+const ol2 = ol1;
+
+// XPECT errors --&gt; "~Object is not a structural subtype of ~C: missing getter getter." at "ol2"
+c = ol2;
+
+
+// no transitivity via several const variables in use case "new expression":
+
+const new1 = new D();
+const new2 = new1;
+
+// XPECT errors --&gt; "D is not a structural subtype of ~C: missing getter getter." at "new2"
+c = new2;
+
+
+// BUT: we do have transitivity via several const variables in use case "final nominal type":
+
+const finalNominal1 = new F();
+const finalNominal2 = finalNominal1;
+
+// XPECT noerrors --&gt;
+c = finalNominal1;
+// XPECT noerrors --&gt; "transitivity applies in this case"
+c = finalNominal2;</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>The following example demonstrates how optionality behaves in ternay expressions.</p>
+</div>
+<div class="listingblock">
+<div class="title">Optional fields in ternay expressions</div>
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">interface ~I {
+    public m?: int;
+}
+
+class ~C { }
+
+@Final class F { }
+
+let b: boolean;
+const cc: C = {}
+let f1 = new F();
+let f2: ~F = {};
+
+// True expression is a const object literal, so both fields and accessors in I are optional.
+// False expression is a new expression, so only getters in I are optionals.
+// As a result, only getters in I are optional.
+// XPECT errors --&gt; "C is not a structural subtype of I: missing field m." at "b? cc : new C()"
+var te1: I = b? cc : new C()
+
+// No errors because both true and false expressions are object literal constants and hence
+// Both fields and accessors in I are optional.
+// XPECT noerrors
+var te2: I = b? cc : {}</code></pre>
+</div>
+</div>
+</div>
+<div class="sect5">
+<h6 id="_background"><a class="anchor" href="#_background"></a><a class="link" href="#_background">5.2.6.5.3. Background</a></h6>
+<div class="paragraph">
+<p>The following example illustrates why optionality of fields has to be restricted
+to the few special cases defined above (i.e. object literals, new expressions, etc.).</p>
+</div>
+<div class="listingblock">
+<div class="title">Problem 1 of optional fields</div>
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">class C {
+	public field?: string = "hello";
+}
+
+class D {}
+class DD extends D {
+	public field: number = 42;
+}
+
+let c: ~C;
+let d: D;
+
+d = new DD();
+
+c = d;  // without the restrictive semantics of optional fields, this assignment would be allowed (but shows compile-time error in N4JS)
+
+console.log(c.field); // prints 42 even though the type is string
+c.field.charAt(0); // exception at runtime: c.field.charAt is not a function</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>In the last line of the above example, <code>c.field</code> is actually <code>42</code> but the type systems claims it is of type <code>string</code> and
+thus allows accessing member <code>charAt</code> of type <code>string</code> which is undefined at runtime the actual value <code>42</code>.</p>
+</div>
+<div class="paragraph">
+<p>The next example shows why cases 2 and 3 (i.e. new expressions and instances of final classes) have to be handled in
+a more restrictive manner than case 1 (i.e. object literals).</p>
+</div>
+<div class="listingblock">
+<div class="title">Problem 2 of optional fields</div>
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">class C {
+	public field?: string;
+}
+
+class D {}
+
+let c: ~C;
+
+c = new D(); // error: new expression but D is missing setter
+
+c.field = "hello";</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>In the previous code, if <code>c = new D()</code> were allowed, we would add a new property <code>field</code> to the instance of class
+<code>D</code> in the last line, which N4JS aims to avoid in general, unless unsafe language features such as dynamic types
+are being employed.</p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3 language-n4js">
+<h4 id="_static-members"><a class="anchor" href="#_static-members"></a><a class="link" href="#_static-members">5.2.7. Static Members</a></h4>
+<div class="paragraph">
+<p>Static data fields, field accessors and methods are quite similar to instance members, however they are not members of instances of the type but the type itself.
+They are defined similarly to instance members except that they are specified with the modifier <code>static</code>.
+Since they are members of the type, the <code>this</code> keyword is not bound to instances of the class, but again to the type itself.
+This is similar as in ECMAScript 6 ([<a href="appendix_c_bibliography.html#ECMA15a">ECMA15a(p.14.5.15)</a>]).
+Since static members are not instance but type members, it is even possible that a static member has the same name as an instance member.</p>
+</div>
+<div class="paragraph">
+<p>Note that static members are not only allowed in classes but also in interfaces, but there are important differences
+(for example, no inheritance of static members of interfaces, cf. Section <a href="#_static-members-of-interfaces">Static Members of Interfaces</a>).</p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-65"></a><strong>Req. IDE-65:</strong> <a href="#Req-IDE-65">Static member not abstract</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>For a static field accessor or method <code>S</code>, the following constraint must hold:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>s</mi><mo>.</mo><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>c</mi><mo>⇔</mo><mo>¬</mo><mi>s</mi><mo>.</mo><mi>a</mi><mi>b</mi><mi>s</mi><mi>t</mi><mi>r</mi><mi>a</mi><mi>c</mi><mi>t</mi></math></p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Like instance methods, static methods of classes are inherited by subclasses and it is possible to override static methods in subclasses.
+The very same override constraints are valid in this case as well.</p>
+</div>
+<div class="sect4">
+<h5 id="_access-from-and-to-static-members"><a class="anchor" href="#_access-from-and-to-static-members"></a><a class="link" href="#_access-from-and-to-static-members">5.2.7.1. Access From and To Static Members</a></h5>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-66"></a><strong>Req. IDE-66:</strong> <a href="#Req-IDE-66">Accessing Static Members</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>Let <code>M</code> be a static member of class <code>C</code>. Except for write-access to
+fields, which will be explained later, you can access <code>M</code>
+via:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>The class declaration instance, i.e. the classifier or constructor type, <code>constructor{C}</code>, i.e. <code>C.m</code></p>
+</li>
+<li>
+<p>The class declaration instance of a subtype, i.e. the classifier or constructor type, i.e. <code>D.m</code>, if <code>D</code> is a subclass of <code>C</code>.</p>
+</li>
+<li>
+<p><code>v.m</code>, if <code>v</code> is a variable of type <code>C</code> (i.e. classifier type as defined in <a href="types.html#_constructor-and-classifier-type">Constructor and Classifier Type</a>) or a subtype thereof.</p>
+</li>
+<li>
+<p><code>this.m</code> inside the body of any static method declared in <code>C</code> or any sub-class of <code>C</code>.</p>
+</li>
+<li>
+<p>Via a type variable <code>T</code> which upper bound is a subclassof <code>C</code> e.g., <code>function &lt;T extends C&gt; f(){T.m}</code></p>
+</li>
+</ol>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-67"></a><strong>Req. IDE-67:</strong> <a href="#Req-IDE-67">Static Member Access</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>It is not possible to access instance members from static members.
+This is true in particular for type variables defined by a generic classifier.</p>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-68"></a><strong>Req. IDE-68:</strong> <a href="#Req-IDE-68">Write-access to static data fields and static setter</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>For static data fields and static setter <code>f</code> the following constraint must hold:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>For every assign expression <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>a</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>g</mi><mi>n</mi><mi>E</mi><mi>x</mi><mi>p</mi><mi>r</mi></math> with <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>f</mi><mo>.</mo><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>c</mi><mo>∧</mo><mi>a</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>g</mi><mi>n</mi><mi>E</mi><mi>x</mi><mi>p</mi><mi>r</mi><mo>.</mo><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi><mo>=</mo><mi>T</mi><mo>.</mo><mi>f</mi><mo>⇒</mo><mi>T</mi><mo>=</mo><mi>f</mi><mo>.</mo><mi>o</mi><mi>w</mi><mi>n</mi><mi>e</mi><mi>r</mi></math>.</p>
+</li>
+<li>
+<p>For every writing unary expression <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>u</mi></math> with <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>u</mi><mo>.</mo><mi>o</mi><mi>p</mi><mo>∈</mo><mfenced close="}" open="{"><mrow><mo>+</mo><mo>+</mo></mrow><mrow><mo>-</mo><mo>-</mo></mrow></mfenced><mo>∧</mo><mi>f</mi><mo>.</mo><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>c</mi><mo>∧</mo><mi>u</mi><mo>.</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>e</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>o</mi><mi>n</mi><mo>=</mo><mi>T</mi><mo>.</mo><mi>f</mi><mo>⇒</mo><mi>T</mi><mo>=</mo><mi>f</mi><mo>.</mo><mi>o</mi><mi>w</mi><mi>n</mi><mi>e</mi><mi>r</mi></math>.</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>In the special case of <code>m</code> being a static data field, write-access is only possible via the defining type name <code>C.m</code>.
+In the list above, only the first line can be used when assigning values to a field. Note that this only applies to fields and set-accessors.<sup class="footnote">[<a id="_footnoteref_36" class="footnote" href="appendix_c_bibliography.html#_footnote_36" title="View footnote.">36</a>]</sup></p>
+</div>
+<div class="paragraph">
+<p>It is even possible to call a static field accessor or method of a class using dynamic polymorphism, as demonstrated in the following example:</p>
+</div>
+<div id="ex:Polymorphism_and_static_methods" class="exampleblock">
+<div class="title">Example 44. Static members of classes, inheritance and polymorphism</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">class A {
+    static m(): void { console.log('A#m'); }
+
+    static foo(): void { console.log('A#foo'); }
+
+    static bar(): void {
+        this.foo();
+    }
+}
+
+class B extends A {
+    @Override
+    static foo(): void { console.log('B#foo'); }
+}
+
+A.m(); // will print "A#m"
+B.m(); // will print "A#m" (m is inherited by B)
+
+var t: type{A} = A;
+t.foo(); // will print "A#foo"
+t = B;
+t.foo(); // will print "B#foo"
+
+// using 'this':
+
+A.bar(); // will print "A#foo"
+B.bar(); // will print "B#foo"</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>This is quite different from Java where static methods are not inherited and references to static methods are statically bound at compile time
+depending on the declared type of the receiver (and not its value):</p>
+</div>
+<div class="exampleblock">
+<div class="title">Example 45. Static members in Java</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-java" data-lang="java">// !!! JAVA CODE !!!
+public class C {
+
+    static void m() { System.out.println("C#m"); }
+
+    public static void main(String[] args) {
+        final C c = null;
+        c.m();  // will print "C#m" (no NullPointerException at runtime)
+    }
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_generic-static-methods"><a class="anchor" href="#_generic-static-methods"></a><a class="link" href="#_generic-static-methods">5.2.7.2. Generic static methods</a></h5>
+<div class="paragraph">
+<p>It is not possible to refer to type variables of a generic class, as these type variables are never bound to any concrete types.
+A static method can, however, be declared generic.
+Generic static methods are defined similarly to generic instance methods.
+Since they cannot refer to type variables of a generic class, the constraint to avoid type variables with equal names (see <a href="#Req-IDE-55">[Req-IDE-55]</a>) does not need to hold for generic static methods.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_static-members-of-interfaces"><a class="anchor" href="#_static-members-of-interfaces"></a><a class="link" href="#_static-members-of-interfaces">5.2.7.3. Static Members of Interfaces</a></h5>
+<div class="paragraph">
+<p>Data fields, field accessors and methods of interfaces may be declared
+static. A few restrictions apply:</p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-69"></a><strong>Req. IDE-69:</strong> <a href="#Req-IDE-69">Static Members of Interfaces</a> (ver. 1)</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Static members of interfaces may only be accessed directly via the containing interface’s type name
+(this means, of the four ways of accessing static members of classes defined in <a href="#Req-IDE-66">[Req-IDE-66]</a> above, only the first one applies to static members of interfaces).</p>
+</li>
+<li>
+<p>The <code>this</code> literal may not be used in static methods or field accessors of interfaces and it may not be used in the initializer expression of static fields of interfaces. See <a href="expressions.html#Req-IDE-173">[Req-IDE-173]</a>.</p>
+</li>
+<li>
+<p>The <code>super</code> literal may not be used in static methods or field accessors of interfaces (in fact, it may not be used in interfaces at all, cf. <a href="expressions.html#Req-IDE-123">[Req-IDE-123]</a>).</p>
+</li>
+</ol>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Note that the <code>this</code> type as a return type for methods is only allowed for instance methods and as an argument type only in constructors (structurally typed).
+There is no need to disallow these cases for static interface methods in the constraints above.</p>
+</div>
+<div class="paragraph">
+<p>In general, static members may not be abstract, cf. <a href="#Req-IDE-46">[Req-IDE-46]</a>, which applies here as well.
+Static methods and field accessors of interfaces, therefore, always have to provide a body.</p>
+</div>
+<div class="paragraph">
+<p>Static members of interfaces are much more restricted than those of classes.
+Compare the following example to <a href="types.html#_polymorphism-and-static-methods">Static Polymorphism</a> for classes above:</p>
+</div>
+<div class="exampleblock">
+<div class="title">Example 46. Static members of interfaces</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">interface I {
+    static m(): void { console.log('I#m'); }
+}
+
+interface J extends I {}
+
+I.m(); // prints "I#m"
+J.m(); // ERROR! (m is not inherited by J)
+
+var ti: type{I} = I;
+ti.m(); // ERROR! (access to m only allowed directly via type name I)
+ti = J;
+ti.m(); // ERROR! (access to m only allowed directly via type name I)</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>The last line in is the reason why access to static members has to be restricted to direct access via the type name of the containing interfaces.</p>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_redefinition-of-members"><a class="anchor" href="#_redefinition-of-members"></a><a class="link" href="#_redefinition-of-members">5.2.8. Redefinition of Members</a></h4>
+<div class="paragraph">
+<p>Members defined in classes or interfaces can be redefined by means of being overridden or implemented in subclasses, sub-interfaces, or implementing classes.
+Fields and methods with default implementation defined in interfaces can be consumed by the implementor, but certain restrictions apply.</p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-70"></a><strong>Req. IDE-70:</strong> <a href="#Req-IDE-70">Override Compatible</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>A member <code>M</code> is <em>override compatible</em> to a member <code>S</code> if and only if the
+following constraints hold:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>The name and static modifiers are equal:<br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>M</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><mi>S</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>∧</mo><mi>M</mi><mo>.</mo><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>c</mi><mo>=</mo><mi>S</mi><mo>.</mo><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>c</mi></math></p>
+</li>
+<li>
+<p>The metatypes are compatible:</p>
+<div class="paragraph">
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>μ</mi><mfenced close=")" open="("><mi>S</mi></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>Method</mtext></mstyle><mspace width="3.0mm"/><mo>→</mo><mspace width="3.0mm"/><mi>μ</mi><mfenced close=")" open="("><mi>M</mi></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>Method</mtext></mstyle></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>μ</mi><mfenced close=")" open="("><mi>S</mi></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>Field</mtext></mstyle><mspace width="3.0mm"/><mo>→</mo><mspace width="3.0mm"/><mi>μ</mi><mfenced close=")" open="("><mi>M</mi></mfenced><mo>∈</mo><mstyle mathvariant="monospace"><mtext>Field, Getter, Setter</mtext></mstyle></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>μ</mi><mfenced close=")" open="("><mi>S</mi></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>Getter</mtext></mstyle><mspace width="3.0mm"/><mo>→</mo><mspace width="3.0mm"/><mi>μ</mi><mfenced close=")" open="("><mi>M</mi></mfenced><mo>∈</mo><mstyle mathvariant="monospace"><mtext>Field, Getter</mtext></mstyle></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>μ</mi><mfenced close=")" open="("><mi>S</mi></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>Setter</mtext></mstyle><mspace width="3.0mm"/><mo>→</mo><mspace width="3.0mm"/><mi>μ</mi><mfenced close=")" open="("><mi>M</mi></mfenced><mo>∈</mo><mstyle mathvariant="monospace"><mtext>Field, Setter</mtext></mstyle></math></p>
+</div>
+</li>
+<li>
+<p>The overridden member must not be declared final:<br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mo>¬</mo><mi>S</mi><mo>.</mo><mi>f</mi><mi>i</mi><mi>n</mi><mi>a</mi><mi>l</mi></math></p>
+</li>
+<li>
+<p>Overridden member declared const can only be overridden (redefined) by const members:<br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>S</mi><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>s</mi><mi>t</mi><mo>⇔</mo><mi>M</mi><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>s</mi><mi>t</mi></math></p>
+</li>
+<li>
+<p>It is not possible to override a non-final / non-const field or a setter with a final / const field:<br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mfenced close=")" open="("><mrow><mi>μ</mi><mfenced close=")" open="("><mi>S</mi></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>Field</mtext></mstyle><mo>∧</mo><mo>¬</mo><mfenced close=")" open="("><mrow><mi>S</mi><mo>.</mo><mi>f</mi><mi>i</mi><mi>n</mi><mi>a</mi><mi>l</mi><mo>∨</mo><mi>S</mi><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>s</mi><mi>t</mi></mrow></mfenced></mrow></mfenced><mo>∨</mo><mi>μ</mi><mfenced close=")" open="("><mi>S</mi></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>Setter</mtext></mstyle><mo>⇒</mo><mo>¬</mo><mfenced close=")" open="("><mrow><mi>μ</mi><mfenced close=")" open="("><mi>M</mi></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>Field</mtext></mstyle><mo>∧</mo><mfenced close=")" open="("><mrow><mi>M</mi><mo>.</mo><mi>f</mi><mi>i</mi><mi>n</mi><mi>a</mi><mi>l</mi><mo>∨</mo><mi>M</mi><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>s</mi><mi>t</mi></mrow></mfenced></mrow></mfenced></math></p>
+</li>
+<li>
+<p>It is not possible to override a non-abstract member with an abstract one:<br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mo>¬</mo><mi>M</mi><mo>.</mo><mi>a</mi><mi>b</mi><mi>s</mi><mi>t</mi><mi>r</mi><mi>a</mi><mi>c</mi><mi>t</mi><mo>∨</mo><mi>S</mi><mo>.</mo><mi>a</mi><mi>b</mi><mi>s</mi><mi>t</mi><mi>r</mi><mi>a</mi><mi>c</mi><mi>t</mi></math></p>
+</li>
+<li>
+<p>The types are compatible:</p>
+<div class="paragraph">
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mfenced close=")" open="("><mrow><mi>μ</mi><mfenced close=")" open="("><mi>M</mi></mfenced><mo>∈</mo><mstyle mathvariant="monospace"><mtext>Method, Getter, Field</mtext></mstyle><mo>∧</mo><mi>μ</mi><mfenced close=")" open="("><mi>S</mi></mfenced><mo>≠</mo><mstyle mathvariant="monospace"><mtext>Setter</mtext></mstyle></mrow></mfenced><mspace width="3.0mm"/><mo>→</mo><mi>Γ</mi><mo>⊢</mo><mi>M</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>S</mi></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mfenced close=")" open="("><mrow><mi>μ</mi><mfenced close=")" open="("><mi>M</mi></mfenced><mo>∈</mo><mstyle mathvariant="monospace"><mtext>Setter, Field</mtext></mstyle><mo>∧</mo><mi>μ</mi><mfenced close=")" open="("><mi>S</mi></mfenced><mo>≠</mo><mstyle mathvariant="monospace"><mtext>Getter</mtext></mstyle><mo>∧</mo><mo>¬</mo><mi>S</mi><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>s</mi><mi>t</mi></mrow></mfenced><mspace width="3.0mm"/><mo>→</mo><mi>Γ</mi><mo>⊢</mo><mi>S</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>M</mi></math>4</p>
+</div>
+</li>
+<li>
+<p>The access modifier is compatible:<br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>M</mi><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mo>≥</mo><mi>S</mi><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi></math></p>
+</li>
+</ol>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>We define a relation <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>o</mi><mi>v</mi><mi>e</mi><mi>r</mi><mi>r</mi><mi>i</mi><mi>d</mi><mi>e</mi><mi>C</mi><mi>o</mi><mi>m</mi><mi>p</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>b</mi><mi>l</mi><mi>e</mi><mfenced close=")" open="("><mi>M</mi><mi>S</mi></mfenced></math> accordingly.</p>
+</div>
+<div class="paragraph">
+<p>Members overriding or implementing other members must be declared as override.
+If a member does not override another, however, it must not be declared as override.</p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-71"></a><strong>Req. IDE-71:</strong> <a href="#Req-IDE-71">Non-Override Declaration</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>If and only if a member <code>M</code> of a class <code>C</code> (extending a class <code>S</code> and interfaces <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>I</mi><mi>i</mi></msub></math>) does not override or implement another member, then it must not be declared as override.
+That is the following constraint must hold:</p>
+</div>
+<div class="paragraph">
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mo>¬</mo><mi>M</mi><mo>.</mo><mi>o</mi><mi>v</mi><mi>e</mi><mi>r</mi><mi>r</mi><mi>i</mi><mi>d</mi><mi>e</mi></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mo>∧</mo></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mo>∄</mo><msup><mi>M</mi><mi>'</mi></msup><mo>∈</mo><mi>C</mi><mo>.</mo><mi>s</mi><mi>u</mi><mi>p</mi><mi>e</mi><mi>r</mi><mo>.</mo><mi>m</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi><mi>s</mi><mo>∪</mo><msubsup><mo>⋃</mo><mrow><mi>i</mi><mo>=</mo><mn>1</mn></mrow><mi>n</mi></msubsup><msub><mi>I</mi><mi>i</mi></msub><mo>.</mo><mi>m</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi><mi>s</mi><mi>:</mi></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><msup><mi>M</mi><mi>'</mi></msup><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><mi>M</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>∧</mo><msup><mi>M</mi><mi>'</mi></msup><mo>.</mo><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>c</mi><mo>=</mo><mi>M</mi><mo>.</mo><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>c</mi></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mo>∧</mo><msup><mi>M</mi><mi>'</mi></msup><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mo>&gt;</mo><mstyle mathvariant="monospace"><mtext>private</mtext></mstyle></math></p>
+</div>
+</div>
+</div>
+<div class="sect4 language-n4js">
+<h5 id="_overriding-of-members"><a class="anchor" href="#_overriding-of-members"></a><a class="link" href="#_overriding-of-members">5.2.8.1. Overriding of Members</a></h5>
+<div class="paragraph">
+<p>In general, the N4JS platform supports overriding members by redefining them in sub-classes.
+This definition allows for overriding of static methods, but it does not apply to constructors because <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>C</mi><mo>.</mo><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi><mo>∉</mo><mi>C</mi><mo>.</mo><mi>o</mi><mi>w</mi><mi>n</mi><mi>e</mi><mi>d</mi><mi>M</mi><mi>e</mi><mi>t</mi><mi>h</mi><mi>o</mi><mi>d</mi><mi>s</mi></math>.</p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-72"></a><strong>Req. IDE-72:</strong> <a href="#Req-IDE-72">Overriding Members</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>Given a class <code>C</code> and a superclass <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>S</mi><mi>u</mi><mi>p</mi></math>.
+If for an instance or static member <code>M</code> defined in <code>C</code> a member <code>S</code> exists with null
+then we call <code>M</code> the overriding member and <code>S</code> the overridden member.
+In that case the following constraints must hold:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p><code>S</code> must be accessible from <code>C</code></p>
+</li>
+<li>
+<p><code>M</code> must be override compatible with <code>S</code>:<br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>o</mi><mi>v</mi><mi>e</mi><mi>r</mi><mi>r</mi><mi>i</mi><mi>d</mi><mi>e</mi><mi>C</mi><mi>o</mi><mi>m</mi><mi>p</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>b</mi><mi>l</mi><mi>e</mi><mfenced close=")" open="("><mi>M</mi><mi>S</mi></mfenced></math></p>
+</li>
+<li>
+<p>If <code>S</code> is a field and <code>M</code> is an accessor, then an additional accessor <math xmlns="http://www.w3.org/1998/Math/MathML"><msup><mi>M</mi><mi>'</mi></msup></math> must exists so that <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>M</mi><mo>,</mo><msup><mi>M</mi><mi>'</mi></msup></math> are an accessor pair for <code>S</code>:</p>
+<div class="paragraph">
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mi>μ</mi><mfenced close=")" open="("><mi>S</mi></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>Field</mtext></mstyle><mo>∧</mo><mi>μ</mi><mfenced close=")" open="("><mi>M</mi></mfenced><mo>=</mo><mrow><mi>A</mi><mi>c</mi><mi>c</mi><mi>e</mi><mi>s</mi><mi>s</mi><mi>o</mi><mi>r</mi></mrow></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mo>→</mo><mo>∃</mo><msup><mi>M</mi><mi>'</mi></msup><mo>∈</mo><mi>C</mi><mo>.</mo><mi>m</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi><mi>:</mi></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mspace width="4.0em"/><mi>o</mi><mi>v</mi><mi>e</mi><mi>r</mi><mi>r</mi><mi>i</mi><mi>d</mi><mi>e</mi><mi>C</mi><mi>o</mi><mi>m</mi><mi>p</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>b</mi><mi>l</mi><mi>e</mi><mfenced close=")" open="("><msup><mi>M</mi><mi>'</mi></msup><mi>S</mi></mfenced><mo>∧</mo><mfenced close="}" open="{"><mrow><mi>μ</mi><mfenced close=")" open="("><mi>M</mi></mfenced></mrow><mrow><mi>μ</mi><mfenced close=")" open="("><msup><mi>M</mi><mi>'</mi></msup></mfenced></mrow></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>Getter,Setter</mtext></mstyle></math></p>
+</div>
+</li>
+<li>
+<p><code>M</code> must be declared as override:<br>
+<code>M.override</code></p>
+</li>
+</ol>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Remarks:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>An overridden method, getter, or setter may called via <code>super</code>.
+Note that this is not possible for fields.</p>
+</li>
+<li>
+<p>There is no ’hiding’ of fields as in Java, instead there is field overriding.</p>
+</li>
+<li>
+<p>It is not possible to override a field with a consumed getter and an overridden setter, because the getter is not consumed if there exists a field in a superclass.
+In this case, the consuming and extending class needs to define the accessor pair explicitly.
+The same is true for other combination of accessors and fields.</p>
+</li>
+<li>
+<p>Overriding a field usually makes only sense if the visibility of the field is to be increased.</p>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_implementation-of-members"><a class="anchor" href="#_implementation-of-members"></a><a class="link" href="#_implementation-of-members">5.2.8.2. Implementation of Members</a></h5>
+<div class="openblock definition">
+<div class="content">
+<div class="paragraph">
+<p><a id="interface_and_class_member_sets"></a><strong>Definition:</strong> <a href="#interface_and_class_member_sets">Interface and Class Member Sets</a></p>
+</div>
+<div class="paragraph">
+<p>For the following constraints, we define two helper sets <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>M</mi><mi>C</mi></msub></math> and <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>M</mi><mi>I</mi></msub></math> as follows:</p>
+</div>
+<div class="paragraph">
+<p>Given a <code>C</code>, and interface <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>I</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>I</mi><mi>n</mi></msub></math>, implemented by <code>C</code>, with</p>
+</div>
+<div class="paragraph">
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>M</mi><mi>C</mi></msub><mspace width="3.0mm"/><mo>=</mo><mi>C</mi><mo>.</mo><mi>o</mi><mi>w</mi><mi>n</mi><mi>e</mi><mi>d</mi><mi>M</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi><mi>s</mi><mo>∪</mo><mrow><mo>{</mo><mrow><mi>m</mi><mo>∈</mo><mi>C</mi><mo>.</mo><mi>s</mi><mi>u</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi><mo>.</mo><mi>m</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi><mi>s</mi><mo>|</mo><mi>m</mi><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mo>&gt;</mo><mstyle mathvariant="monospace"><mtext>private</mtext></mstyle><mo>}</mo></mrow></mrow></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>M</mi><mi>I</mi></msub><mspace width="3.0mm"/><mo>=</mo><msubsup><mo>⋃</mo><mrow><mi>i</mi><mo>=</mo><mn>1</mn></mrow><mi>n</mi></msubsup><msub><mi>I</mi><mi>i</mi></msub><mo>.</mo><mi>m</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi><mi>s</mi></math></p>
+</div>
+<div class="paragraph">
+<p>Note that these sets already contain only non-private data fields.</p>
+</div>
+</div>
+</div>
+<div class="sect5">
+<h6 id="_member-consumption"><a class="anchor" href="#_member-consumption"></a><a class="link" href="#_member-consumption">5.2.8.2.1. Member Consumption</a></h6>
+<div class="openblock definition">
+<div class="content">
+<div class="paragraph">
+<p><a id="member_consumption_and_implementation"></a><strong>Definition:</strong> <a href="#member_consumption_and_implementation">Member Consumption and Implementation</a></p>
+</div>
+<div class="paragraph">
+<p>A member <code>M</code> defined in an interface <code>I</code> is <em>consumed</em> by an implementor <code>C</code>, if it becomes a member of the class, that is, <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>M</mi><mo>∈</mo><mi>C</mi><mo>.</mo><mi>m</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi><mi>s</mi></math>.</p>
+</div>
+<div class="paragraph">
+<p>A member <code>M</code> is consumed if there is no member defined in the implementor with the same name and if there is no non-private,
+non-abstract member with that name inherited by the implementor from its superclass. <sup class="footnote">[<a id="_footnoteref_37" class="footnote" href="appendix_c_bibliography.html#_footnote_37" title="View footnote.">37</a>]</sup></p>
+</div>
+<div class="paragraph">
+<p>If the implementor defines the member itself, then the member is implemented rather than consumed.</p>
+</div>
+<div class="paragraph">
+<p>The concrete rules are described in the following;</p>
+</div>
+<div class="paragraph">
+<p>It is not always possible to directly consume a member.
+In general, a rather conservative strategy is used: if two implemented interfaces define the same (non-abstract) member then the implementor must redefine the member in order to solve conflicts.
+Even if the two conflicting members have the same types, the implementor must redefine them as we generally assume semantic differences which the consumer has to be aware of.
+Data fields defined in interfaces, in particular, are assumed to be concrete.
+It is not, therefore, possible to consume a field defined in two implemented interfaces.</p>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-73"></a><strong>Req. IDE-73:</strong> <a href="#Req-IDE-73">Consumption of Interface Members</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>Given a classifier <code>C</code> <sup class="footnote">[<a id="_footnoteref_38" class="footnote" href="appendix_c_bibliography.html#_footnote_38" title="View footnote.">38</a>]</sup>, and interfaces <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>I</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>I</mi><mi>n</mi></msub></math> implemented (or extended) by <code>C</code>, and sets <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>M</mi><mi>C</mi></msub></math> and <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>M</mi><mi>I</mi></msub></math> as defined in <a href="#interface_and_class_member_sets">[interface_and_class_member_sets]</a>.
+A non-static member <code>M</code> defined in any interface <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>I</mi><mi>i</mi></msub></math> is merged into the consumer (<code>C</code>), if for all other (possible) members <math xmlns="http://www.w3.org/1998/Math/MathML"><msup><mi>M</mi><mi>'</mi></msup></math> of <code>C</code></p>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mo>∀</mo><msup><mi>M</mi><mi>'</mi></msup><mo>∈</mo><msub><mi>M</mi><mi>C</mi></msub><mo>∪</mo><msub><mi>M</mi><mi>I</mi></msub><mo>∖</mo><mfenced close="}" open="{"><mi>M</mi></mfenced><mi>:</mi><mi>M</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><msup><mi>M</mi><mi>'</mi></msup><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>∧</mo><mo>¬</mo><msup><mi>M</mi><mi>'</mi></msup><mo>.</mo><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>c</mi></math>
+</div>
+</div>
+<div class="paragraph">
+<p>the following constraints hold:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>The other member’s meta type matches the meta type of the merge candiate:</p>
+<div class="paragraph">
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>μ</mi><mfenced close=")" open="("><mi>M</mi></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>Method</mtext></mstyle><mspace width="3.0mm"/><mo>→</mo><mi>μ</mi><mfenced close=")" open="("><msup><mi>M</mi><mi>'</mi></msup></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>Method</mtext></mstyle></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>μ</mi><mfenced close=")" open="("><mi>M</mi></mfenced><mo>≠</mo><mstyle mathvariant="monospace"><mtext>Method</mtext></mstyle><mspace width="3.0mm"/><mo>→</mo><mi>μ</mi><mfenced close=")" open="("><msup><mi>M</mi><mi>'</mi></msup></mfenced><mo>∈</mo><mstyle mathvariant="monospace"><mtext>Field, FieldAccessor</mtext></mstyle></math></p>
+</div>
+</li>
+<li>
+<p>The other member is abstract and not owned by the consumer:</p>
+<div class="paragraph">
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mi>μ</mi><mfenced close=")" open="("><mi>M</mi></mfenced><mo>=</mo><mi>μ</mi><mfenced close=")" open="("><msup><mi>M</mi><mi>'</mi></msup></mfenced><mo>∨</mo><mi>μ</mi><mfenced close=")" open="("><mi>M</mi></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>Field</mtext></mstyle></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mspace width="2.0em"/><mo>→</mo><msup><mi>M</mi><mi>'</mi></msup><mo>.</mo><mi>a</mi><mi>b</mi><mi>s</mi><mi>t</mi><mi>r</mi><mi>a</mi><mi>c</mi><mi>t</mi><mo>∧</mo><msup><mi>M</mi><mi>'</mi></msup><mo>∉</mo><mi>C</mi><mo>.</mo><mi>o</mi><mi>w</mi><mi>n</mi><mi>e</mi><mi>d</mi><mi>M</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi><mi>s</mi></math></p>
+</div>
+</li>
+<li>
+<p>The merge candidate’s access modifier is not less than the modifier of the other member:</p>
+<div class="paragraph">
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mi>μ</mi><mfenced close=")" open="("><mi>M</mi></mfenced><mo>=</mo><mi>μ</mi><mfenced close=")" open="("><msup><mi>M</mi><mi>'</mi></msup></mfenced><mo>∨</mo><mi>μ</mi><mfenced close=")" open="("><mi>M</mi></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>Field</mtext></mstyle></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mspace width="2.0em"/><mo>→</mo><mi>M</mi><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mo>≥</mo><msup><mi>M</mi><mi>'</mi></msup><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi></math></p>
+</div>
+</li>
+<li>
+<p>The merge candidate’s type compatible with the other member:</p>
+<div class="paragraph">
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>μ</mi><mfenced close=")" open="("><mi>M</mi></mfenced><mo>∈</mo><mfenced close="}" open="{"><mstyle mathvariant="monospace"><mtext>Method, Getter, Field</mtext></mstyle></mfenced><mo>∧</mo><mi>μ</mi><mfenced close=")" open="("><msup><mi>M</mi><mi>'</mi></msup></mfenced><mo>≠</mo><mstyle mathvariant="monospace"><mtext>Setter</mtext></mstyle><mspace width="3.0mm"/><mo>→</mo><mi>Γ</mi><mo>⊢</mo><mi>M</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><msup><mi>M</mi><mi>'</mi></msup></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>μ</mi><mfenced close=")" open="("><mi>M</mi></mfenced><mo>∈</mo><mfenced close="}" open="{"><mstyle mathvariant="monospace"><mtext>Setter, Field</mtext></mstyle></mfenced><mo>∧</mo><mi>μ</mi><mfenced close=")" open="("><msup><mi>M</mi><mi>'</mi></msup></mfenced><mo>≠</mo><mstyle mathvariant="monospace"><mtext>Getter</mtext></mstyle><mspace width="3.0mm"/><mo>→</mo><mi>Γ</mi><mo>⊢</mo><msup><mi>M</mi><mi>'</mi></msup><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>M</mi></math></p>
+</div>
+</li>
+</ol>
+</div>
+</div>
+</div>
+</div>
+<div class="sect5 language-n4js">
+<h6 id="_member-implementation"><a class="anchor" href="#_member-implementation"></a><a class="link" href="#_member-implementation">5.2.8.2.2. Member Implementation</a></h6>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-74"></a><strong>Req. IDE-74:</strong> <a href="#Req-IDE-74">Implementation of Interface Members</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>For any non-static abstract member <code>M</code> defined in an interface <code>I implemented (or extended) by a classifier `C</code>, <code>M</code> must be accessible
+from <code>C</code> and one or two member(s) in <code>C</code> must exist which are implementation-compatible with <code>M</code>.
+The implementing member(s) must be declared as override if they are directly defined in the consumer.</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p><code>M</code> must be accessible from <code>C</code>.</p>
+</li>
+<li>
+<p>An implementation-compatible member <math xmlns="http://www.w3.org/1998/Math/MathML"><msup><mi>M</mi><mi>'</mi></msup></math> must exist in <code>C</code>:</p>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p>if <code>M</code> is not a field:</p>
+<div class="paragraph">
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>μ</mi><mfenced close=")" open="("><mi>M</mi></mfenced><mo>≠</mo><mstyle mathvariant="monospace"><mtext>Field</mtext></mstyle><mspace width="3.0mm"/><mo>→</mo></math><br>
+            <math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mo>∃</mo><msup><mi>M</mi><mi>'</mi></msup><mo>∈</mo><mi>C</mi><mo>.</mo><mi>m</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi><mi>s</mi><mi>:</mi></math><br>
+            <math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mspace width="3.0em"/><mi>o</mi><mi>v</mi><mi>e</mi><mi>r</mi><mi>r</mi><mi>i</mi><mi>d</mi><mi>e</mi><mi>C</mi><mi>o</mi><mi>m</mi><mi>p</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>b</mi><mi>l</mi><mi>e</mi><mfenced close=")" open="("><msup><mi>M</mi><mi>'</mi></msup><mi>M</mi></mfenced></math><br>
+            <math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mspace width="3.0em"/><mo>∧</mo><mfenced close=")" open="("><mrow><msup><mi>M</mi><mi>'</mi></msup><mo>∈</mo><mi>C</mi><mo>.</mo><mi>o</mi><mi>w</mi><mi>n</mi><mi>e</mi><mi>d</mi><mi>M</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi><mi>s</mi><mo>→</mo><msup><mi>M</mi><mi>'</mi></msup><mo>.</mo><mi>o</mi><mi>v</mi><mi>e</mi><mi>r</mi><mi>r</mi><mi>i</mi><mi>d</mi><mi>e</mi></mrow></mfenced></math></p>
+</div>
+</li>
+<li>
+<p>if <code>M</code> is a field, then either an
+implementation-compatible field <math xmlns="http://www.w3.org/1998/Math/MathML"><msup><mi>F</mi><mi>'</mi></msup></math> or accessor pair <math xmlns="http://www.w3.org/1998/Math/MathML"><msup><mi>G</mi><mi>'</mi></msup><mo>,</mo><msup><mi>S</mi><mi>'</mi></msup></math> must exist:</p>
+<div class="paragraph">
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>μ</mi><mfenced close=")" open="("><mi>M</mi></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>Field</mtext></mstyle><mspace width="3.0mm"/><mo>→</mo></math><br>
+                        <math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mo>∃</mo><msup><mi>F</mi><mi>'</mi></msup><mo>∈</mo><mi>C</mi><mo>.</mo><mi>f</mi><mi>i</mi><mi>e</mi><mi>l</mi><mi>d</mi><mi>s</mi><mi>:</mi></math><br>
+                            <math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mspace width="3.0em"/><mi>o</mi><mi>v</mi><mi>e</mi><mi>r</mi><mi>r</mi><mi>i</mi><mi>d</mi><mi>e</mi><mi>C</mi><mi>o</mi><mi>m</mi><mi>p</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>b</mi><mi>l</mi><mi>e</mi><mfenced close=")" open="("><msup><mi>F</mi><mi>'</mi></msup><mi>M</mi></mfenced></math><br>
+                            <math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mspace width="3.0em"/><mo>∧</mo><mfenced close=")" open="("><mrow><msup><mi>F</mi><mi>'</mi></msup><mo>∈</mo><mi>C</mi><mo>.</mo><mi>o</mi><mi>w</mi><mi>n</mi><mi>e</mi><mi>d</mi><mi>M</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi><mi>s</mi><mo>→</mo><msup><mi>F</mi><mi>'</mi></msup><mo>.</mo><mi>o</mi><mi>v</mi><mi>e</mi><mi>r</mi><mi>r</mi><mi>i</mi><mi>d</mi><mi>e</mi></mrow></mfenced></math><br>
+                        <math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mo>∨</mo></math><br>
+                        <math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mo>∃</mo><msup><mi>G</mi><mi>'</mi></msup><mo>∈</mo><mi>C</mi><mo>.</mo><mi>g</mi><mi>e</mi><mi>t</mi><mi>t</mi><mi>e</mi><mi>r</mi><mi>s</mi><mo>,</mo><msup><mi>S</mi><mi>'</mi></msup><mo>∈</mo><mi>C</mi><mo>.</mo><mi>s</mi><mi>e</mi><mi>t</mi><mi>t</mi><mi>e</mi><mi>r</mi><mi>s</mi><mi>:</mi></math><br>
+                            <math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mspace width="3.0em"/><mi>o</mi><mi>v</mi><mi>e</mi><mi>r</mi><mi>r</mi><mi>i</mi><mi>d</mi><mi>e</mi><mi>C</mi><mi>o</mi><mi>m</mi><mi>p</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>b</mi><mi>l</mi><mi>e</mi><mfenced close=")" open="("><msup><mi>G</mi><mi>'</mi></msup><mi>M</mi></mfenced></math><br>
+                            <math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mspace width="3.0em"/><mo>∧</mo><mi>o</mi><mi>v</mi><mi>e</mi><mi>r</mi><mi>r</mi><mi>i</mi><mi>d</mi><mi>e</mi><mi>C</mi><mi>o</mi><mi>m</mi><mi>p</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>b</mi><mi>l</mi><mi>e</mi><mfenced close=")" open="("><msup><mi>S</mi><mi>'</mi></msup><mi>M</mi></mfenced></math><br>
+                            <math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mspace width="3.0em"/><mo>∧</mo><mfenced close=")" open="("><mrow><msup><mi>G</mi><mi>'</mi></msup><mo>∈</mo><mi>C</mi><mo>.</mo><mi>o</mi><mi>w</mi><mi>n</mi><mi>e</mi><mi>d</mi><mi>M</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi><mi>s</mi><mo>→</mo><msup><mi>G</mi><mi>'</mi></msup><mo>.</mo><mi>o</mi><mi>v</mi><mi>e</mi><mi>r</mi><mi>r</mi><mi>i</mi><mi>d</mi><mi>e</mi></mrow></mfenced></math><br>
+                            <math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mspace width="3.0em"/><mo>∧</mo><mfenced close=")" open="("><mrow><msup><mi>S</mi><mi>'</mi></msup><mo>∈</mo><mi>C</mi><mo>.</mo><mi>o</mi><mi>w</mi><mi>n</mi><mi>e</mi><mi>d</mi><mi>M</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi><mi>s</mi><mo>→</mo><msup><mi>S</mi><mi>'</mi></msup><mo>.</mo><mi>o</mi><mi>v</mi><mi>e</mi><mi>r</mi><mi>r</mi><mi>i</mi><mi>d</mi><mi>e</mi></mrow></mfenced></math></p>
+</div>
+</li>
+</ol>
+</div>
+</li>
+</ol>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Methods defined in interfaces are automatically declared abstract if they do not provide a default implementation.
+This can also be expressed explicitly via adding the <code>abstract</code> modifier.
+If a class implementing an abstract interface does not implement a method declared in the interface, the class needs to be declared abstract (cf. <a href="#_abstract-classes">Abstract Classes</a>).</p>
+</div>
+<div class="paragraph">
+<p>Consequences for method implementation:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>It may be require the implementor to explicitly define a method in order to solve type conflicts produced by methods of different interfaces with same name but different signatures.</p>
+</li>
+<li>
+<p>Methods in an implementor cannot decrease the accessibility of methods from implemented interfaces, that is</p>
+<div class="paragraph">
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mo>∀</mo><mi>M</mi><mo>∈</mo><mi>C</mi><mo>.</mo><mi>m</mi><mi>e</mi><mi>t</mi><mi>h</mi><mi>o</mi><mi>d</mi><mi>s</mi><mo>,</mo><msup><mi>M</mi><mi>'</mi></msup><mo>∈</mo><msub><mi>I</mi><mi>i</mi></msub><mo>.</mo><mi>m</mi><mi>e</mi><mi>t</mi><mi>h</mi><mi>o</mi><mi>d</mi><mi>s</mi><mfenced close=")" open="("><mrow><mi>i</mi><mo>=</mo><mn>1</mn><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mi>n</mi></mrow></mfenced><mi>:</mi></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mspace width="2.0em"/><mi>M</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><msup><mi>M</mi><mi>'</mi></msup><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>→</mo><mi>M</mi><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mo>≠</mo><mi>p</mi><mi>r</mi><mi>i</mi><mi>v</mi><mi>a</mi><mi>t</mi><mi>e</mi><mo>⇒</mo><mi>M</mi><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mo>≥</mo><msup><mi>M</mi><mi>'</mi></msup><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi></math></p>
+</div>
+</li>
+<li>
+<p>Methods in the implementor must be a supertype <sup class="footnote">[<a id="_footnoteref_39" class="footnote" href="appendix_c_bibliography.html#_footnote_39" title="View footnote.">39</a>]</sup> of methods from implemented interfaces.
+That is to say the implemented methods are override-compatible.</p>
+</li>
+<li>
+<p>There may be several methods <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>M</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>M</mi><mi>n</mi></msub></math> defined in different implemented interfaces and a single owned method <math xmlns="http://www.w3.org/1998/Math/MathML"><msup><mi>M</mi><mi>'</mi></msup></math> in <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>M</mi><mi>C</mi></msub></math>.
+In this case, the above constraints must hold for <em>all</em> methods. In particular, <math xmlns="http://www.w3.org/1998/Math/MathML"><msup><mi>M</mi><mi>'</mi></msup></math>’s signature must conform to all conflicting methods’ signatures.
+This is possible by using union types for the arguments and an intersection type as return type.
+Such a method <math xmlns="http://www.w3.org/1998/Math/MathML"><msup><mi>M</mi><mi>'</mi></msup></math> is said to <em>resolve</em> the conflict between the implemented (and also inherited) methods.</p>
+</li>
+<li>
+<p>Since abstracts methods may become part of the implementor methods, the implementor must either define these methods or it must be declared abstract itself.
+Since interfaces are abstract by default, responsibility for implementing abstract methods is passed on to any implementor of interfaces.</p>
+</li>
+<li>
+<p>If two implemented interfaces provide (non-abstract) members with the same name, they are not automatically consumed by the implementor even if the types would be similar.
+In these cases, the implementor has to redefine the members in order to be aware of possible semantic differences.</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>There is currently no separate annotation to indicate that methods are implemented or overridden in order to solve conflicts.
+We always use the <code>@Override</code> annotation.</p>
+</div>
+<div class="exampleblock">
+<div class="title">Example 47. Method Consumption</div>
+<div class="content">
+<div class="paragraph">
+<p><a href="#tab:methodConsumption">Consumption of methods</a> shows simple examples of above rules.
+Assuming that <code>class C</code> extends super <code>class S</code> and implements interface <code>I1</code> and <code>I2</code>:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">class C extends S implements I1, I2 {...}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>The columns describe different scenarios in which a method (with same name) is defined in different classifiers.
+We assume that the defined methods are always non-abstract (i.e. have default implementations), non-private and have the same signature.
+The last row shows which method will be actually used in class <code>C</code>.
+If the method is defined in class <code>C</code>, and if this method is printed bold, then this means that the method is required to be defined in <code>C</code> in order to solve conflicts.</p>
+</div>
+<table id="tab:methodConsumption" class="tableblock frame-all grid-all spread">
+<caption class="title">Table 8. Consumption of methods</caption>
+<colgroup>
+<col style="width: 25%;">
+<col style="width: 12.5%;">
+<col style="width: 12.5%;">
+<col style="width: 12.5%;">
+<col style="width: 12.5%;">
+<col style="width: 12.5%;">
+<col style="width: 12.5%;">
+</colgroup>
+<tbody>
+<tr>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Interface <code>I1</code></p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><em>M<sub>I1</sub></em></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><em>M<sub>I1</sub></em></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><em>M<sub>I1</sub></em></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><em>M<sub>I1</sub></em></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><em>M<sub>I1</sub></em></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><em>M<sub>I1</sub></em></p></td>
+</tr>
+<tr>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Interface <code>I2</code></p></th>
+<td class="tableblock halign-center valign-top"></td>
+<td class="tableblock halign-center valign-top"></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><em>M<sub>I2</sub></em></p></td>
+<td class="tableblock halign-center valign-top"></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><em>M<sub>I2</sub></em></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><em>M<sub>I2</sub></em></p></td>
+</tr>
+<tr>
+<th class="tableblock halign-left valign-top"><p class="tableblock">class <code>S</code></p></th>
+<td class="tableblock halign-center valign-top"></td>
+<td class="tableblock halign-center valign-top"></td>
+<td class="tableblock halign-center valign-top"></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><em>M<sub>S</sub></em></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><em>M<sub>S</sub></em></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><em>M<sub>S</sub></em></p></td>
+</tr>
+<tr>
+<th class="tableblock halign-left valign-top"><p class="tableblock">class <code>C</code></p></th>
+<td class="tableblock halign-center valign-top"></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><em>M<sub>C</sub></em></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><strong>M<sub>C</sub></strong></p></td>
+<td class="tableblock halign-center valign-top"></td>
+<td class="tableblock halign-center valign-top"></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><em>M<sub>C</sub></em></p></td>
+</tr>
+<tr>
+<th class="tableblock halign-left valign-top"><p class="tableblock"><math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∈</mo><mi>C</mi><mo>.</mo><mi>m</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi><mi>s</mi></math></p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><em>M<sub>I1</sub></em></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><em>M<sub>C</sub></em></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><em>M<sub>C</sub></em></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><em>M<sub>S</sub></em></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><em>M<sub>S</sub></em></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><em>M<sub>C</sub></em></p></td>
+</tr>
+</tbody>
+</table>
+<div id="consuming-field-initializers" class="dlist">
+<dl>
+<dt class="hdlist1">Consuming Field Initializers </dt>
+<dd>
+<p>Aside from the fields themselves, an implementor <em>always</em> consumes the field initialization if the field is consumed – this is how the consumption is noticed at runtime.</p>
+</dd>
+</dl>
+</div>
+<div class="exampleblock">
+<div class="title">Example 48. Field and Field Initializer Consumption</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">/* XPECT  output ~~~
+&lt;==
+stdout:
+s: C , t: D ,u: I1 ,v: I2
+stderr:
+==&gt;
+~~~ */
+
+interface I0 {
+    v: string = "I0";
+}
+
+interface I1 {
+    s: string = "I1";
+    t: string = "I1";
+    u: string = "I1";
+}
+
+interface I2 extends I1, I0 {
+    @Override
+    t: string = "I2";
+    @Override
+    v: string = "I2";
+}
+
+class C {
+    s: string = "C";
+}
+
+class D extends C implements I1, I2 {
+    @Override
+    t: string = "D";
+}
+
+var d = new D();
+
+console.log(
+    "s:", d.s, ", t:", d.t, ",u:", d.u, ",v:", d.v
+)</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>We expect the following output (for each field):</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>d.s = "C"</code> : <code>s</code>: is inherited from <code>C</code>, so it is not consumed from <code>I1</code> (or <code>I2</code>).
+Consequently, the initializer of <code>s</code> in <code>C</code> is used.</p>
+</li>
+<li>
+<p><code>d.t = "D"</code>: <code>t</code> is defined in <code>D</code>, solving a conflict stemming from the definition of <code>t</code> in <code>I1</code> and <code>I2</code>. Thus, the initializer of <code>t</code> in <code>D</code> is used.</p>
+</li>
+<li>
+<p><code>d.u = "I1"</code> : <code>u</code> is only defined in <code>I1</code>, thus the initializer defined in <code>I1</code> is used.</p>
+</li>
+<li>
+<p><code>d.v = "I2"</code> : <code>v</code> is overridden in <code>I2</code>, so is the field initializer. This is why <code>d.v</code> must be assigned to <code>I2</code> and not <code>I0</code>.</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_structural-typing"><a class="anchor" href="#_structural-typing"></a><a class="link" href="#_structural-typing">5.3. Structural Typing</a></h3>
+<div class="paragraph">
+<p>In general, N4JS uses nominal typing.
+This is to say that a duck is a duck only if it is declared to be a duck.
+In particular when working with external APIs, it is more convenient to use structural or duck typing.
+That is, a thing that can swim and quacks like a duck, is a duck.</p>
+</div>
+<div class="paragraph language-n4js">
+<p>Interfaces or classes can be used for this purpose with a <em>typing strategy modifier</em>.
+Given a type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi></math>, the simple <code>~</code> (tilde) can be added to its declaration (on definition-site) or in a reference (on use-site) to indicate that the type system should use structural typing
+rather than nominal typing.<sup class="footnote">[<a id="_footnoteref_40" class="footnote" href="appendix_c_bibliography.html#_footnote_40" title="View footnote.">40</a>]</sup>
+This means that some other type must provide the same members as type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi></math> to be deemed a structural subtype.
+However, the operator cannot be used anymore with the type or reference as this operator relies on the declaration information (or at least the closest thing available at runtime).
+In this case, <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi></math> is, therefore, always a structural subtype of <em>~T</em>.</p>
+</div>
+<div class="paragraph language-n4js">
+<p>Sometimes it is convenient to refer only to the fields of a classifier, for example when the initial field values are to be provided in a variable passed to the constructor.
+In that case, the type can be modified with <code>~~</code> (two tildes). This is only possible on use-site, i.e. on type references.
+Furthermore, only on the use-site, it is possible to consider only either readable or writable or fields by using the read-only <code>~r~</code> or write-only <code>~w~</code> structural field typing.
+For initialization blocks, it is even possible to use structural initializer field typing via the <code>~i~</code> operator.</p>
+</div>
+<div class="sect3 language-n4js">
+<h4 id="_syntax-7"><a class="anchor" href="#_syntax-7"></a><a class="link" href="#_syntax-7">5.3.1. Syntax</a></h4>
+<div class="paragraph">
+<p>Structural typing is specified using the typing strategy modifier. There
+are two modifiers defined; one for definition-site and one for use-site
+structural typing.</p>
+</div>
+<div id="lst:Structural_Type_Operator_and_References" class="listingblock">
+<div class="title">Structural Type Operator and References</div>
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">TypingStrategyUseSiteOperator returns TypingStrategy:
+    '~' ('~' | STRUCTMODSUFFIX)?;
+
+TypingStrategyDefSiteOperator returns TypingStrategy:
+    '~';
+
+terminal STRUCTMODSUFFIX:
+    ('r' | 'i' | 'w') '~'
+;
+
+ParameterizedTypeRefStructural returns ParameterizedTypeRefStructural:
+    definedTypingStrategy=TypingStrategyUseSiteOperator
+    declaredType=[Type|TypeReferenceName]
+    (=&gt; '&lt;' typeArgs+=TypeArgument (',' typeArgs+=TypeArgument)* '&gt;')?
+    (=&gt; 'with' '{' astStructuralMembers+=TStructMember* '}')?
+;
+
+ThisTypeRefStructural returns ThisTypeRefStructural:
+    definedTypingStrategy=TypingStrategyUseSiteOperator
+    'this'
+    ('with' '{' astStructuralMembers+=TStructMember* '}')?
+;</code></pre>
+</div>
+</div>
+</div>
+<div class="sect3 language-n4js">
+<h4 id="_definition-site-structural-typing"><a class="anchor" href="#_definition-site-structural-typing"></a><a class="link" href="#_definition-site-structural-typing">5.3.2. Definition Site Structural Typing</a></h4>
+<div class="paragraph">
+<p>An interface or class can be defined to be used with structural typing by adding the structural modifier to its definition (or, in case of external classes, to the declaration).
+This changes the default type system strategy from nominal to structural typing for that type.
+That means that all types with the same members as the specified type are subtypes of that type, except for subtypes of <code>N4Object</code>.
+In the latter case, programmers are enforced to nominal declare the type relation.</p>
+</div>
+<div class="paragraph">
+<p>If a type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi></math> is declared as structural at its definition, <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi><mo>.</mo><mi>d</mi><mi>e</mi><mi>f</mi><mi>S</mi><mi>t</mi><mi>r</mi><mi>u</mi><mi>c</mi><mi>t</mi><mi>u</mi><mi>r</mi><mi>a</mi><mi>l</mi></math> is true.</p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-75"></a><strong>Req. IDE-75:</strong> <a href="#Req-IDE-75">Definition Site Structural Typing</a> (ver. 1)</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>The structurally defined type cannot be used on the right hand side of the <code>instanceof</code> operator:
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>x</mi><mi> </mi><mstyle mathvariant="monospace"><mtext>instanceof</mtext></mstyle><mi> </mi><mi>T</mi><mo>⇒</mo><mo>¬</mo><mi>T</mi><mo>.</mo><mi>d</mi><mi>e</mi><mi>f</mi><mi>S</mi><mi>t</mi><mi>r</mi><mi>u</mi><mi>c</mi><mi>t</mi><mi>u</mi><mi>r</mi><mi>a</mi><mi>l</mi></math></p>
+</li>
+<li>
+<p>A type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>X</mi></math> is a subtype of a structurally defined type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi></math> either</p>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p>if it is not a subtype of <code>N4Object</code> <sup class="footnote">[<a id="_footnoteref_41" class="footnote" href="appendix_c_bibliography.html#_footnote_41" title="View footnote.">41</a>]</sup>
+but it contains all public, non-static members of that type</p>
+<div class="paragraph">
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>X</mi><mspace width="1.0mm"/><mo>≮</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mfenced close="}" open="{"><mstyle mathvariant="monospace"><mtext>N4Object</mtext></mstyle></mfenced><mspace width="3.0em"/><mi>T</mi><mo>.</mo><mi>d</mi><mi>e</mi><mi>f</mi><mi>S</mi><mi>t</mi><mi>r</mi><mi>u</mi><mi>c</mi><mi>t</mi><mi>u</mi><mi>r</mi><mi>a</mi><mi>l</mi><mi>}</mi></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∀</mo><mi>m</mi><mo>∈</mo><mi>T</mi><mo>.</mo><mi>m</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi><mi>s</mi><mo>,</mo><mi>m</mi><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>public</mtext></mstyle><mo>,</mo><mo>¬</mo><mi>m</mi><mo>.</mo><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>c</mi><mo>,</mo><mi>m</mi><mo>≠</mo><mi>T</mi><mo>.</mo><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi><mi>:</mi><mi>}</mi></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="1.0em"/><mo>∃</mo><msup><mi>m</mi><mi>'</mi></msup><mo>∈</mo><mi>X</mi><mo>.</mo><mi>m</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi><mi>s</mi><mi>:</mi><mi>}</mi></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="2.0em"/><msup><mi>m</mi><mi>'</mi></msup><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>public</mtext></mstyle><mo>∧</mo><mo>¬</mo><msup><mi>m</mi><mi>'</mi></msup><mo>.</mo><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>c</mi><mo>∧</mo><msup><mi>m</mi><mi>'</mi></msup><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><mi>m</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mi>}</mi></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="2.0em"/><mo>∧</mo><mi>Γ</mi><mo>⊢</mo><msup><mi>m</mi><mi>'</mi></msup><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>m</mi><mi>}</mi></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mfrac><mrow><mspace width="2.0em"/><mo>∧</mo><mi>μ</mi><mfenced close=")" open="("><mi>m</mi></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>Field</mtext></mstyle><mo>⇒</mo><mi>Γ</mi><mo>⊢</mo><mi>m</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><msup><mi>m</mi><mi>'</mi></msup></mrow><mrow><mspace width="13.0em"/><mi>Γ</mi><mo>⊢</mo><mi>X</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>T</mi><mspace width="13.0em"/></mrow></mfrac></math><br>
+or</p>
+</div>
+</li>
+<li>
+<p>if it is a subtype of <code>N4Object</code> which explicitly extends or implements the
+structurally defined type.</p>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><mi>X</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mfenced close="}" open="{"><mstyle mathvariant="monospace"><mtext>N4Object</mtext></mstyle></mfenced><mspace width="3.0mm"/><mi>T</mi><mo>.</mo><mi>d</mi><mi>e</mi><mi>f</mi><mi>S</mi><mi>t</mi><mi>r</mi><mi>u</mi><mi>c</mi><mi>t</mi><mi>u</mi><mi>r</mi><mi>a</mi><mi>l</mi><mspace width="3.0mm"/><mrow><mi>T</mi><mo>∈</mo><mi>X</mi><mo>.</mo><mi>s</mi><mi>u</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi><msup><mi>s</mi><mo>*</mo></msup></mrow></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mi>X</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>T</mi></mrow></mfrac></math>
+</div>
+</div>
+</li>
+<li>
+<p>A structurally defined type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi></math> is implicitly derived
+from <code>Object</code> if no other type is specified. In particular, a structurally
+defined type must not be inherited from</p>
+<div class="paragraph">
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mfrac><mrow><mi>T</mi><mo>.</mo><mi>d</mi><mi>e</mi><mi>f</mi><mi>S</mi><mi>t</mi><mi>r</mi><mi>u</mi><mi>c</mi><mi>t</mi><mi>u</mi><mi>r</mi><mi>a</mi><mi>l</mi></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mi>T</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mstyle mathvariant="monospace"><mtext>Object</mtext></mstyle></mrow></mfrac></math></p>
+</div>
+<div class="paragraph">
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi><mo>.</mo><mi>d</mi><mi>e</mi><mi>f</mi><mi>S</mi><mi>t</mi><mi>r</mi><mi>u</mi><mi>c</mi><mi>t</mi><mi>u</mi><mi>r</mi><mi>a</mi><mi>l</mi><mo>⇒</mo><mi>Γ</mi><mo>⊢</mo><mi>T</mi><mspace width="1.0mm"/><mo>≮</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mstyle mathvariant="monospace"><mtext>N4Object</mtext></mstyle><mo>∧</mo><mstyle mathvariant="monospace"><mtext>N4Object</mtext></mstyle><mo>∉</mo><mi>T</mi><mo>.</mo><mi>s</mi><mi>u</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi><msup><mi>s</mi><mo>*</mo></msup></math></p>
+</div>
+</li>
+</ol>
+</div>
+</li>
+</ol>
+</div>
+</div>
+</div>
+<div class="exampleblock">
+<div class="title">Example 49. Declaration Site Structural Typing</div>
+<div class="content">
+<div class="paragraph">
+<p>The following snippet demonstrates the effect of definition-site structural types by comparing them to
+nominal declared types: <a id="ex:declaration-site-structural-typing"></a></p>
+</div>
+<div class="listingblock">
+<div class="title">Declaration Site Structural Typing</div>
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">interface ~Tilde { x; y; }
+interface Nominal { x; y; }
+class C { public x; public y;}
+class D extends C implements Tilde { }
+
+function f(p: Tilde) {}
+function g(p: Nominal) {}
+
+f(new C());         // error: nominal typing, C does not implement ~Tilde
+f(new D());         // ok, D is a nominal subtype (as it implements Tilde)
+f({x:10,y:10});     // ok: Tilde is used with structural typing for non-N4-classifiers</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Definition site structural typing may lead to unexpected results. For
+example;</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">class C{}
+class ~E extends C{}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>It may be unexpected, but <code>E</code> is not a subtype of <code>C</code>, i.e.
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>E</mi><mspace width="1.0mm"/><mo>≮</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>C</mi></math>! E.g., <code>instanceof</code> won’t work with <code>E</code>, while it works
+with <code>C</code>!</p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3 language-n4js">
+<h4 id="_use-site-structural-typing"><a class="anchor" href="#_use-site-structural-typing"></a><a class="link" href="#_use-site-structural-typing">5.3.3. Use-Site Structural Typing</a></h4>
+<div class="paragraph">
+<p>Use-site structural typing offers several typing strategy modifiers to define the accessability of public properties of classes and interfaces.
+They can be used e.g. on variable declarations like this: <code>var c : ~C</code>.
+The table <a href="#tab:available-fields-of-structural-types">Available Fields of Structural Types</a> shows which properties of structural types can be accessed in the different type strategies.
+For example, when using the write-only structural strategy (i.e. <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>~</mi><mstyle mathvariant="monospace"><mtext>w</mtext></mstyle><mi>~</mi><mstyle mathvariant="monospace"><mtext>X</mtext></mstyle></math>), only the writeable fields, can be accessed for writing.
+In the table, the term field to both, public datafields and accessors of type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>X</mi></math>.
+Non-public properties are never accessable in use-site structural types.
+In any field-structural type, methods of the referenced nominal type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>X</mi></math> are not available.
+The initializer structural typing provides readable fields for every writeable field of the references type.</p>
+</div>
+<table id="tab:available-fields-of-structural-types" class="tableblock frame-all grid-all spread">
+<caption class="title">Table 9. Available Fields of Structural Types</caption>
+<colgroup>
+<col style="width: 16.6666%;">
+<col style="width: 16.6666%;">
+<col style="width: 16.6666%;">
+<col style="width: 16.6666%;">
+<col style="width: 16.6666%;">
+<col style="width: 16.667%;">
+</colgroup>
+<thead>
+<tr>
+<th class="tableblock halign-left valign-top">Property of <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>X</mi></math></th>
+<th class="tableblock halign-center valign-top"><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>~</mi><mstyle mathvariant="monospace"><mtext>X</mtext></mstyle></math></th>
+<th class="tableblock halign-center valign-top"><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>~</mi><mi>~</mi><mstyle mathvariant="monospace"><mtext>X</mtext></mstyle></math></th>
+<th class="tableblock halign-center valign-top"><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>~</mi><mstyle mathvariant="monospace"><mtext>r</mtext></mstyle><mi>~</mi><mstyle mathvariant="monospace"><mtext>X</mtext></mstyle></math></th>
+<th class="tableblock halign-center valign-top"><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>~</mi><mstyle mathvariant="monospace"><mtext>w</mtext></mstyle><mi>~</mi><mstyle mathvariant="monospace"><mtext>X</mtext></mstyle></math></th>
+<th class="tableblock halign-center valign-top"><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>~</mi><mstyle mathvariant="monospace"><mtext>i</mtext></mstyle><mi>~</mi><mstyle mathvariant="monospace"><mtext>X</mtext></mstyle></math></th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">public method</p></td>
+<td class="tableblock halign-center valign-top"></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>∅</mi></math></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>∅</mi></math></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>∅</mi></math></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>∅</mi></math></p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">public writable field</p></td>
+<td class="tableblock halign-center valign-top"></td>
+<td class="tableblock halign-center valign-top"></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>∅</mi></math></p></td>
+<td class="tableblock halign-center valign-top"></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>∅</mi></math></p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">public readable field</p></td>
+<td class="tableblock halign-center valign-top"></td>
+<td class="tableblock halign-center valign-top"></td>
+<td class="tableblock halign-center valign-top"></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>∅</mi></math></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">writable fields</p></td>
+</tr>
+</tbody>
+</table>
+<div class="paragraph">
+<p>Multiple structural typing strategies can be nested when there are multiple use sites, like in the example <a href="#ex:nested-structural-typing-strategies">Nested Structural Typing Strategies</a> below at the locations ST1 and ST2.
+In the example, the datafield <code>a.field</code> has the nested structural type <code>~r~ ~i~ A</code> and thus the datafield <code>a.field.df</code> is readable.
+Nested structural types are evaluated on the fly when doing subtype checks.</p>
+</div>
+<div id="ex:nested-structural-typing-strategies" class="exampleblock">
+<div class="title">Example 50. Nested Structural Typing Strategies</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">class A {
+    public df : string;
+}
+interface I&lt;T&gt; {
+    public field : ~r~T; // ST1
+}
+var a : ~i~A; // ST2</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>The following example demonstrates the effect of the structural type modifiers:</p>
+</div>
+<div class="exampleblock">
+<div class="title">Example 51. Effect of structural type modifiers on use-site</div>
+<div class="content">
+<div class="paragraph">
+<p>Let’s assume the type defined on the left.
+The following <em>pseudo</em> code snippets explicitly list the type with its members virtually created by a structural modifier.
+Note that this is pseudo code, as there are no real or virtual types created.
+Instead, only the subtype relation is defined accordingly:</p>
+</div>
+<div class="paragraph">
+<p>Effect of structural type modifiers on use-site</p>
+</div>
+<table class="tableblock frame-all grid-all spread">
+<colgroup>
+<col style="width: 33.3333%;">
+<col style="width: 33.3333%;">
+<col style="width: 33.3334%;">
+</colgroup>
+<tbody>
+<tr>
+<th class="tableblock halign-center valign-top" colspan="3"><p class="tableblock">Effect of structural type modifiers on use-site</p></th>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><div><div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">var c:C
+
+class C {
+    private x;
+    public y;
+    public f()
+    private g()
+    public get z():Z
+    public set z(z:Z)
+}
+interface I {
+    a;
+    func();
+}</code></pre>
+</div>
+</div></div></td>
+<td class="tableblock halign-left valign-top"><div><div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">var cstructural:~C
+
+class cstructural {
+
+    public y;
+    public f()
+
+    public get z():Z
+    public set z(z:Z)
+}
+interface ~I {
+    a;
+    func();
+}</code></pre>
+</div>
+</div></div></td>
+<td class="tableblock halign-left valign-top"><div><div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">var cfields:~~C
+
+class cfields {
+
+    public y;
+
+
+    public get z():Z
+    public set z(z:Z)
+}
+interface ~~I {
+    a;
+
+}</code></pre>
+</div>
+</div></div></td>
+</tr>
+<tr>
+<th class="tableblock halign-center valign-top"><p class="tableblock">Type</p></th>
+<th class="tableblock halign-center valign-top"><p class="tableblock">Structural Type</p></th>
+<th class="tableblock halign-center valign-top"><p class="tableblock">Structural Field Type</p></th>
+</tr>
+</tbody>
+</table>
+<table class="tableblock frame-all grid-all spread">
+<colgroup>
+<col style="width: 33.3333%;">
+<col style="width: 33.3333%;">
+<col style="width: 33.3334%;">
+</colgroup>
+<tbody>
+<tr>
+<td class="tableblock halign-left valign-top"><div><div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">var crofields:~r~C
+
+class crofields {
+
+    public get y():Y
+
+
+    public get z():Z
+
+}
+interface ~r~I {
+    public get a():A
+
+}</code></pre>
+</div>
+</div></div></td>
+<td class="tableblock halign-left valign-top"><div><div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">var cwofields:~w~C
+
+class cwofields {
+
+    public set y(y:Y)
+
+
+
+    public set z(z:Z)
+}
+interface ~w~I {
+    public set a(a:A)
+
+}</code></pre>
+</div>
+</div></div></td>
+<td class="tableblock halign-left valign-top"><div><div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">var cinitfields:~i~C
+
+class cinitfields {
+
+    public get y():Y
+
+
+    public get z():Z
+
+}
+interface ~i~I {
+    public get a():A
+
+}</code></pre>
+</div>
+</div></div></td>
+</tr>
+<tr>
+<th class="tableblock halign-center valign-top"><p class="tableblock">Structural Read-only Field Type</p></th>
+<th class="tableblock halign-center valign-top"><p class="tableblock">Structural Write-only Field Type</p></th>
+<th class="tableblock halign-center valign-top"><p class="tableblock">Structural Initializer Field Type</p></th>
+</tr>
+</tbody>
+</table>
+<div style="page-break-after: always;"></div>
+<div class="paragraph">
+<p>Note that even if a type is defined without the structural modifier, it is not possible to use <code>instanceof</code> for variables declared as structural, as shown in the next example:</p>
+</div>
+<table class="tableblock frame-all grid-all spread">
+<colgroup>
+<col style="width: 33.3333%;">
+<col style="width: 33.3333%;">
+<col style="width: 33.3334%;">
+</colgroup>
+<tbody>
+<tr>
+<td class="tableblock halign-left valign-top"><div><div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">class C {..}
+interface I {..}
+
+foo(c: C, i: I) {
+    c instanceof C; // ok
+    c instanceof I; // ok
+}</code></pre>
+</div>
+</div></div></td>
+<td class="tableblock halign-left valign-top"><div><div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">class C {..}
+interface I {..}
+
+foo(c: ~C, i: ~I) {
+    c instanceof C; // error
+    c instanceof I; // error
+}</code></pre>
+</div>
+</div></div></td>
+<td class="tableblock halign-left valign-top"><div><div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">class C {..}
+interface I {..}
+
+foo(c: ~~C, i: ~~I) {
+    c instanceof C; // error
+    C instanceof I; // error
+}</code></pre>
+</div>
+</div></div></td>
+</tr>
+<tr>
+<th class="tableblock halign-center valign-top"><p class="tableblock">Type</p></th>
+<th class="tableblock halign-center valign-top"><p class="tableblock">Structural Type</p></th>
+<th class="tableblock halign-center valign-top"><p class="tableblock">Structural Field Type</p></th>
+</tr>
+</tbody>
+</table>
+<div class="ulist">
+<ul>
+<li>
+<p>If a type is referenced with the structural type modifier <code>~</code> , the property <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi><mo>.</mo><mi>r</mi><mi>e</mi><mi>f</mi><mi>S</mi><mi>t</mi><mi>r</mi><mi>u</mi><mi>c</mi><mi>t</mi><mi>u</mi><mi>r</mi><mi>a</mi><mi>l</mi></math> is true.</p>
+</li>
+<li>
+<p>If a type is referenced with the structural field type modifier <code>~~</code>, the property <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi><mo>.</mo><mi>r</mi><mi>e</mi><mi>f</mi><mi>S</mi><mi>t</mi><mi>r</mi><mi>u</mi><mi>c</mi><mi>t</mi><mi>u</mi><mi>r</mi><mi>a</mi><mi>l</mi><mi>F</mi><mi>i</mi><mi>e</mi><mi>l</mi><mi>d</mi></math> is true.</p>
+</li>
+<li>
+<p>If a type is referenced with the structural read-only field type modifier <code>~r~</code>, the property <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi><mo>.</mo><mi>r</mi><mi>e</mi><mi>f</mi><mi>S</mi><mi>t</mi><mi>r</mi><mi>u</mi><mi>c</mi><mi>t</mi><mi>u</mi><mi>r</mi><mi>a</mi><mi>l</mi><mi>R</mi><mi>e</mi><mi>a</mi><mi>d</mi><mi>O</mi><mi>n</mi><mi>l</mi><mi>y</mi><mi>F</mi><mi>i</mi><mi>e</mi><mi>l</mi><mi>d</mi></math> is true.</p>
+</li>
+<li>
+<p>If a type is referenced with the structural write-only field type modifier <code>~w~</code>, then the property <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi><mo>.</mo><mi>r</mi><mi>e</mi><mi>f</mi><mi>S</mi><mi>t</mi><mi>r</mi><mi>u</mi><mi>c</mi><mi>t</mi><mi>u</mi><mi>r</mi><mi>a</mi><mi>l</mi><mi>W</mi><mi>r</mi><mi>i</mi><mi>t</mi><mi>e</mi><mi>O</mi><mi>n</mi><mi>l</mi><mi>y</mi><mi>F</mi><mi>i</mi><mi>e</mi><mi>l</mi><mi>d</mi></math> is true.</p>
+</li>
+<li>
+<p>If a type is referenced with the structural initializer field type modifier <code>~i~</code>, then the property <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi><mo>.</mo><mi>r</mi><mi>e</mi><mi>f</mi><mi>S</mi><mi>t</mi><mi>r</mi><mi>u</mi><mi>c</mi><mi>t</mi><mi>u</mi><mi>r</mi><mi>a</mi><mi>l</mi><mi>I</mi><mi>n</mi><mi>i</mi><mi>t</mi><mi>F</mi><mi>i</mi><mi>e</mi><mi>l</mi><mi>d</mi></math> is true.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>We call the following:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi></math> the (nominal) type T,</p>
+</li>
+<li>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>~</mi><mstyle mathvariant="monospace"><mtext>T</mtext></mstyle></math> the structural version of <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi></math>,</p>
+</li>
+<li>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>~</mi><mi>~</mi><mstyle mathvariant="monospace"><mtext>T</mtext></mstyle></math> the structural field version of <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi></math>,</p>
+</li>
+<li>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>~</mi><mstyle mathvariant="monospace"><mtext>r</mtext></mstyle><mi>~</mi><mstyle mathvariant="monospace"><mtext>T</mtext></mstyle></math> the structural read-only field,</p>
+</li>
+<li>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>~</mi><mstyle mathvariant="monospace"><mtext>w</mtext></mstyle><mi>~</mi><mstyle mathvariant="monospace"><mtext>T</mtext></mstyle></math> the structural write-only field and</p>
+</li>
+<li>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>~</mi><mstyle mathvariant="monospace"><mtext>i</mtext></mstyle><mi>~</mi><mstyle mathvariant="monospace"><mtext>T</mtext></mstyle></math> the structural initializer field version of <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi></math>.</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-76"></a><strong>Req. IDE-76:</strong> <a href="#Req-IDE-76">Use-Site Structural Typing</a> (ver. 1)</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>The structural version of a type is a supertype of the nominal type:<br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>:</mi><mi>~</mi><mstyle mathvariant="monospace"><mtext>T</mtext></mstyle></math></p>
+</li>
+<li>
+<p>The structural field version of a type is a supertype of the structural type:<br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>~</mi><mstyle mathvariant="monospace"><mtext>T</mtext></mstyle><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>:</mi><mi>~</mi><mi>~</mi><mstyle mathvariant="monospace"><mtext>T</mtext></mstyle></math></p>
+</li>
+<li>
+<p>The structural read-only field version of a type is a supertype of the structural field type:<br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>~</mi><mi>~</mi><mstyle mathvariant="monospace"><mtext>T</mtext></mstyle><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>:</mi><mi>~</mi><mstyle mathvariant="monospace"><mtext>r</mtext></mstyle><mi>~</mi><mstyle mathvariant="monospace"><mtext>T</mtext></mstyle></math></p>
+</li>
+<li>
+<p>The structural write-only field version of a type is a supertype of the structural field type:<br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>~</mi><mi>~</mi><mstyle mathvariant="monospace"><mtext>T</mtext></mstyle><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>:</mi><mi>~</mi><mstyle mathvariant="monospace"><mtext>w</mtext></mstyle><mi>~</mi><mstyle mathvariant="monospace"><mtext>T</mtext></mstyle></math></p>
+</li>
+<li>
+<p>The structural (field) version of a type cannot be used on the right hand side of the <code>instanceof</code> operator:</p>
+<div class="paragraph">
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mi>x</mi><mi> </mi><mstyle mathvariant="monospace"><mtext>instanceof</mtext></mstyle><mi> </mi><mi>E</mi><mo>⇒</mo><mi>Γ</mi><mo>⊢</mo><mi>E</mi><mi>:</mi><mi>T</mi></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mspace width="3.0em"/><mo>⇒</mo><mo>¬</mo><mrow><mo>(</mo><mi>T</mi><mo>.</mo><mi>r</mi><mi>e</mi><mi>f</mi><mi>S</mi><mi>t</mi><mi>r</mi><mi>u</mi><mi>c</mi><mi>t</mi><mi>u</mi><mi>r</mi><mi>a</mi><mi>l</mi></mrow></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mspace width="6.0em"/><mo>∨</mo><mi>T</mi><mo>.</mo><mi>r</mi><mi>e</mi><mi>f</mi><mi>S</mi><mi>t</mi><mi>r</mi><mi>u</mi><mi>c</mi><mi>t</mi><mi>u</mi><mi>r</mi><mi>a</mi><mi>l</mi><mi>F</mi><mi>i</mi><mi>e</mi><mi>l</mi><mi>d</mi></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mspace width="6.0em"/><mo>∨</mo><mi>T</mi><mo>.</mo><mi>r</mi><mi>e</mi><mi>f</mi><mi>S</mi><mi>t</mi><mi>r</mi><mi>u</mi><mi>c</mi><mi>t</mi><mi>u</mi><mi>r</mi><mi>a</mi><mi>l</mi><mi>R</mi><mi>e</mi><mi>a</mi><mi>d</mi><mi>O</mi><mi>n</mi><mi>l</mi><mi>y</mi><mi>F</mi><mi>i</mi><mi>e</mi><mi>l</mi><mi>d</mi></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mspace width="6.0em"/><mo>∨</mo><mi>T</mi><mo>.</mo><mi>r</mi><mi>e</mi><mi>f</mi><mi>S</mi><mi>t</mi><mi>r</mi><mi>u</mi><mi>c</mi><mi>t</mi><mi>u</mi><mi>r</mi><mi>a</mi><mi>l</mi><mi>W</mi><mi>r</mi><mi>i</mi><mi>t</mi><mi>e</mi><mi>O</mi><mi>n</mi><mi>l</mi><mi>y</mi><mi>F</mi><mi>i</mi><mi>e</mi><mi>l</mi><mi>d</mi></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mrow><mspace width="3.0mm"/><mspace width="6.0em"/><mo>∨</mo><mi>T</mi><mo>.</mo><mi>r</mi><mi>e</mi><mi>f</mi><mi>S</mi><mi>t</mi><mi>r</mi><mi>u</mi><mi>c</mi><mi>t</mi><mi>u</mi><mi>r</mi><mi>a</mi><mi>l</mi><mi>I</mi><mi>n</mi><mi>i</mi><mi>t</mi><mi>F</mi><mi>i</mi><mi>e</mi><mi>l</mi><mi>d</mi><mo>)</mo></mrow></math></p>
+</div>
+<div class="paragraph">
+<p>That is, the following code will always issue an error: <code>x instanceof ~T</code> <sup class="footnote">[<a id="_footnoteref_42" class="footnote" href="appendix_c_bibliography.html#_footnote_42" title="View footnote.">42</a>]</sup>.</p>
+</div>
+</li>
+<li>
+<p>A type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>X</mi></math> is a subtype of a structural version of a type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>~</mi><mstyle mathvariant="monospace"><mtext>T</mtext></mstyle></math>, if it contains all public, non-static members of the type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi></math>: <sup class="footnote">[<a id="_footnoteref_43" class="footnote" href="appendix_c_bibliography.html#_footnote_43" title="View footnote.">43</a>]</sup></p>
+<div class="paragraph">
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∀</mo><mi>m</mi><mo>∈</mo><mi>T</mi><mo>.</mo><mi>m</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi><mi>s</mi><mo>,</mo><mi>m</mi><mo>.</mo><mi>o</mi><mi>w</mi><mi>n</mi><mi>e</mi><mi>r</mi><mo>∉</mo><mstyle mathvariant="monospace"><mtext>N4Object</mtext></mstyle><mo>,</mo><mi>m</mi><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>public</mtext></mstyle><mo>,</mo><mo>¬</mo><mi>m</mi><mo>.</mo><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>c</mi><mo>,</mo><mi>m</mi><mo>≠</mo><mi>T</mi><mo>.</mo><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi><mi>:</mi></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="1.0em"/><mo>∃</mo><msup><mi>m</mi><mi>'</mi></msup><mo>∈</mo><mi>X</mi><mo>.</mo><mi>m</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi><mi>s</mi><mi>:</mi></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="2.0em"/><msup><mi>m</mi><mi>'</mi></msup><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>public</mtext></mstyle><mo>∧</mo><mo>¬</mo><msup><mi>m</mi><mi>'</mi></msup><mo>.</mo><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>c</mi><mo>∧</mo><msup><mi>m</mi><mi>'</mi></msup><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><mi>m</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mfrac><mrow><mspace width="2.0em"/><mo>∧</mo><mi>Γ</mi><mo>⊢</mo><msup><mi>m</mi><mi>'</mi></msup><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>Γ</mi><mo>⊢</mo><mi>m</mi></mrow><mrow><mspace width="13.0em"/><mi>Γ</mi><mo>⊢</mo><mi>X</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>Γ</mi><mo>⊢</mo><mi>~</mi><mstyle mathvariant="monospace"><mtext>T</mtext></mstyle><mspace width="13.0em"/></mrow></mfrac></math></p>
+</div>
+</li>
+<li>
+<p>A type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>X</mi></math> is a subtype of a structural field version of a type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>~</mi><mi>~</mi><mstyle mathvariant="monospace"><mtext>T</mtext></mstyle></math>, if it contains all public, non-static fields of the type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi></math>.
+Special cases regarding optional fields are described in <a href="#optional-fields">Optional Fields</a>.</p>
+<div class="paragraph">
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∀</mo><mi>m</mi><mo>∈</mo><mi>T</mi><mo>.</mo><mi>f</mi><mi>i</mi><mi>e</mi><mi>l</mi><mi>d</mi><mi>s</mi><mo>,</mo><mi>m</mi><mo>.</mo><mi>o</mi><mi>w</mi><mi>n</mi><mi>e</mi><mi>r</mi><mo>∉</mo><mstyle mathvariant="monospace"><mtext>N4Object</mtext></mstyle><mo>,</mo><mi>m</mi><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>public</mtext></mstyle><mo>,</mo><mo>¬</mo><mi>m</mi><mo>.</mo><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>c</mi></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="1.0em"/><mo>∨</mo><mi> </mi><mo>∃</mo><msup><mi>m</mi><mi>'</mi></msup><mo>∈</mo><mi>X</mi><mo>.</mo><mi>f</mi><mi>i</mi><mi>e</mi><mi>l</mi><mi>d</mi><mi>s</mi><mi>:</mi></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0em"/><msup><mi>m</mi><mi>'</mi></msup><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>public</mtext></mstyle><mo>∧</mo><mo>¬</mo><msup><mi>m</mi><mi>'</mi></msup><mo>.</mo><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>c</mi><mo>∧</mo><msup><mi>m</mi><mi>'</mi></msup><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><mi>m</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0em"/><mo>∧</mo><mi>Γ</mi><mo>⊢</mo><msup><mi>m</mi><mi>'</mi></msup><mi>:</mi><msub><mi>T</mi><mi>m</mi></msub><mo>∧</mo><mi>Γ</mi><mo>⊢</mo><mi>m</mi><mi>:</mi><msub><mi>T</mi><msup><mi>m</mi><mi>'</mi></msup></msub><mo>∧</mo><msub><mi>T</mi><mi>m</mi></msub><mo>=</mo><msub><mi>T</mi><msup><mi>m</mi><mi>'</mi></msup></msub><mi>}</mi></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mfrac><mrow><mspace width="3.0em"/><mo>∧</mo><msup><mi>m</mi><mi>'</mi></msup><mo>.</mo><mi>a</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>g</mi><mi>n</mi><mi>a</mi><mi>b</mi><mi>i</mi><mi>l</mi><mi>i</mi><mi>t</mi><mi>y</mi><mo>≥</mo><mi>m</mi><mo>.</mo><mi>a</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>g</mi><mi>n</mi><mi>a</mi><mi>b</mi><mi>i</mi><mi>l</mi><mi>i</mi><mi>t</mi><mi>y</mi></mrow><mrow><mspace width="13.0em"/><mi>Γ</mi><mo>⊢</mo><mi>X</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>~</mi><mi>~</mi><mstyle mathvariant="monospace"><mtext>T</mtext></mstyle><mspace width="13.0em"/></mrow></mfrac></math></p>
+</div>
+</li>
+<li>
+<p>A type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>X</mi></math> is a subtype of a structural read-only field version of a type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>~</mi><mstyle mathvariant="monospace"><mtext>r</mtext></mstyle><mi>~</mi><mstyle mathvariant="monospace"><mtext>T</mtext></mstyle></math>, if it contains all public and non-static readable fields of the type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi></math>.
+Special cases regarding optional fields are described in <a href="#optional-fields">Optional Fields</a>.</p>
+<div class="paragraph">
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∀</mo><mi>m</mi><mo>∈</mo><mi>T</mi><mo>.</mo><mi>f</mi><mi>i</mi><mi>e</mi><mi>l</mi><mi>d</mi><mi>s</mi><mo>∪</mo><mi>T</mi><mo>.</mo><mi>g</mi><mi>e</mi><mi>t</mi><mi>t</mi><mi>e</mi><mi>r</mi><mi>s</mi><mo>,</mo><mi>m</mi><mo>.</mo><mi>o</mi><mi>w</mi><mi>n</mi><mi>e</mi><mi>r</mi><mo>∉</mo><mstyle mathvariant="monospace"><mtext>N4Object</mtext></mstyle><mo>,</mo><mi>m</mi><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>public</mtext></mstyle><mo>,</mo><mo>¬</mo><mi>m</mi><mo>.</mo><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>c</mi></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="1.0em"/><mo>∨</mo><mi> </mi><mo>∃</mo><msup><mi>m</mi><mi>'</mi></msup><mo>∈</mo><mi>X</mi><mo>.</mo><mi>f</mi><mi>i</mi><mi>e</mi><mi>l</mi><mi>d</mi><mi>s</mi><mo>∪</mo><mi>X</mi><mo>.</mo><mi>g</mi><mi>e</mi><mi>t</mi><mi>t</mi><mi>e</mi><mi>r</mi><mi>s</mi><mi>:</mi></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0em"/><msup><mi>m</mi><mi>'</mi></msup><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>public</mtext></mstyle><mo>∧</mo><mo>¬</mo><msup><mi>m</mi><mi>'</mi></msup><mo>.</mo><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>c</mi><mo>∧</mo><msup><mi>m</mi><mi>'</mi></msup><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><mi>m</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0em"/><mo>∧</mo><mi>Γ</mi><mo>⊢</mo><msup><mi>m</mi><mi>'</mi></msup><mi>:</mi><msub><mi>T</mi><mi>m</mi></msub><mo>∧</mo><mi>Γ</mi><mo>⊢</mo><mi>m</mi><mi>:</mi><msub><mi>T</mi><msup><mi>m</mi><mi>'</mi></msup></msub><mo>∧</mo><msub><mi>T</mi><mi>m</mi></msub><mo>=</mo><msub><mi>T</mi><msup><mi>m</mi><mi>'</mi></msup></msub></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mfrac><mrow><mspace width="3.0em"/><mo>∧</mo><msup><mi>m</mi><mi>'</mi></msup><mo>.</mo><mi>a</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>g</mi><mi>n</mi><mi>a</mi><mi>b</mi><mi>i</mi><mi>l</mi><mi>i</mi><mi>t</mi><mi>y</mi><mo>≥</mo><mi>m</mi><mo>.</mo><mi>a</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>g</mi><mi>n</mi><mi>a</mi><mi>b</mi><mi>i</mi><mi>l</mi><mi>i</mi><mi>t</mi><mi>y</mi></mrow><mrow><mspace width="13.0em"/><mi>Γ</mi><mo>⊢</mo><mi>X</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>~</mi><mstyle mathvariant="monospace"><mtext>r</mtext></mstyle><mi>~</mi><mstyle mathvariant="monospace"><mtext>T</mtext></mstyle><mspace width="13.0em"/></mrow></mfrac></math></p>
+</div>
+</li>
+<li>
+<p>A type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>X</mi></math> is a subtype of a structural write-only field version of a type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>~</mi><mstyle mathvariant="monospace"><mtext>w</mtext></mstyle><mi>~</mi><mstyle mathvariant="monospace"><mtext>T</mtext></mstyle></math>, if it contains all public and non-static writable fields of the type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi></math>. Special cases regarding optional fields are described in <a href="#optional-fields">Optional Fields</a>.</p>
+<div class="paragraph">
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∀</mo><mi>m</mi><mo>∈</mo><mi>T</mi><mo>.</mo><mi>f</mi><mi>i</mi><mi>e</mi><mi>l</mi><mi>d</mi><mi>s</mi><mo>∪</mo><mi>T</mi><mo>.</mo><mi>s</mi><mi>e</mi><mi>t</mi><mi>t</mi><mi>e</mi><mi>r</mi><mi>s</mi><mo>,</mo><mi>m</mi><mo>.</mo><mi>o</mi><mi>w</mi><mi>n</mi><mi>e</mi><mi>r</mi><mo>∉</mo><mstyle mathvariant="monospace"><mtext>N4Object</mtext></mstyle><mo>,</mo><mi>m</mi><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>public</mtext></mstyle><mo>,</mo><mo>¬</mo><mi>m</mi><mo>.</mo><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>c</mi><mo>,</mo><mo>¬</mo><mi>m</mi><mo>.</mo><mi>f</mi><mi>i</mi><mi>n</mi><mi>a</mi><mi>l</mi></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="1.0em"/><mo>∨</mo><mi> </mi><mo>∃</mo><msup><mi>m</mi><mi>'</mi></msup><mo>∈</mo><mi>X</mi><mo>.</mo><mi>f</mi><mi>i</mi><mi>e</mi><mi>l</mi><mi>d</mi><mi>s</mi><mo>∪</mo><mi>X</mi><mo>.</mo><mi>s</mi><mi>e</mi><mi>t</mi><mi>t</mi><mi>e</mi><mi>r</mi><mi>s</mi><mi>:</mi></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0em"/><msup><mi>m</mi><mi>'</mi></msup><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>public</mtext></mstyle><mo>∧</mo><mo>¬</mo><msup><mi>m</mi><mi>'</mi></msup><mo>.</mo><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>c</mi><mo>∧</mo><msup><mi>m</mi><mi>'</mi></msup><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><mi>m</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0em"/><mo>∧</mo><mi>Γ</mi><mo>⊢</mo><msup><mi>m</mi><mi>'</mi></msup><mi>:</mi><msub><mi>T</mi><mi>m</mi></msub><mo>∧</mo><mi>Γ</mi><mo>⊢</mo><mi>m</mi><mi>:</mi><msub><mi>T</mi><msup><mi>m</mi><mi>'</mi></msup></msub><mo>∧</mo><msub><mi>T</mi><mi>m</mi></msub><mo>=</mo><msub><mi>T</mi><msup><mi>m</mi><mi>'</mi></msup></msub></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mfrac><mrow><mspace width="3.0em"/><mo>∧</mo><msup><mi>m</mi><mi>'</mi></msup><mo>.</mo><mi>a</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>g</mi><mi>n</mi><mi>a</mi><mi>b</mi><mi>i</mi><mi>l</mi><mi>i</mi><mi>t</mi><mi>y</mi><mo>≥</mo><mi>m</mi><mo>.</mo><mi>a</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>g</mi><mi>n</mi><mi>a</mi><mi>b</mi><mi>i</mi><mi>l</mi><mi>i</mi><mi>t</mi><mi>y</mi></mrow><mrow><mspace width="13.0em"/><mi>Γ</mi><mo>⊢</mo><mi>X</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>~</mi><mstyle mathvariant="monospace"><mtext>w</mtext></mstyle><mi>~</mi><mstyle mathvariant="monospace"><mtext>T</mtext></mstyle><mspace width="13.0em"/></mrow></mfrac></math></p>
+</div>
+</li>
+<li>
+<p>A type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>X</mi></math> is a subtype of a structural field version of a type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>~</mi><mi>~</mi><mstyle mathvariant="monospace"><mtext>this</mtext></mstyle></math>, if it contains all public, non-static fields,
+either defined via data fields or field get accessors, of the inferred type of <code>this</code>.
+Special cases regarding optional fields are described in <a href="#optional-fields">Optional Fields</a>.</p>
+<div class="paragraph">
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>Γ</mi><mo>⊢</mo><mi>t</mi><mi>h</mi><mi>i</mi><mi>s</mi><mi>:</mi><mi>T</mi></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∀</mo><mi>m</mi><mo>∈</mo><mi>T</mi><mo>.</mo><mi>f</mi><mi>i</mi><mi>e</mi><mi>l</mi><mi>d</mi><mi>s</mi><mo>∪</mo><mi>T</mi><mo>.</mo><mi>s</mi><mi>e</mi><mi>t</mi><mi>t</mi><mi>e</mi><mi>r</mi><mi>s</mi><mo>,</mo><mi>m</mi><mo>.</mo><mi>o</mi><mi>w</mi><mi>n</mi><mi>e</mi><mi>r</mi><mo>∉</mo><mstyle mathvariant="monospace"><mtext>N4Object</mtext></mstyle><mo>,</mo><mi>m</mi><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>public</mtext></mstyle><mo>,</mo><mo>¬</mo><mi>m</mi><mo>.</mo><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>c</mi></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∨</mo><mi>m</mi><mo>.</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mo>≠</mo><mstyle mathvariant="monospace"><mtext>null</mtext></mstyle></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="1.0em"/><mo>∨</mo><mi> </mi><mo>∃</mo><msup><mi>m</mi><mi>'</mi></msup><mo>∈</mo><mi>X</mi><mo>.</mo><mi>f</mi><mi>i</mi><mi>e</mi><mi>l</mi><mi>d</mi><mi>s</mi><mo>∪</mo><mi>X</mi><mo>.</mo><mi>g</mi><mi>e</mi><mi>t</mi><mi>t</mi><mi>e</mi><mi>r</mi><mi>s</mi><mi>:</mi></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0em"/><msup><mi>m</mi><mi>'</mi></msup><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>public</mtext></mstyle><mo>∧</mo><mo>¬</mo><msup><mi>m</mi><mi>'</mi></msup><mo>.</mo><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>c</mi><mo>∧</mo><msup><mi>m</mi><mi>'</mi></msup><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><mi>m</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mfrac><mrow><mspace width="3.0em"/><mo>∧</mo><mi>Γ</mi><mo>⊢</mo><msup><mi>m</mi><mi>'</mi></msup><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>m</mi><mo>∧</mo><msup><mi>m</mi><mi>'</mi></msup><mo>.</mo><mi>a</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>g</mi><mi>n</mi><mi>a</mi><mi>b</mi><mi>i</mi><mi>l</mi><mi>i</mi><mi>t</mi><mi>y</mi><mo>≥</mo><mi>m</mi><mo>.</mo><mi>a</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>g</mi><mi>n</mi><mi>a</mi><mi>b</mi><mi>i</mi><mi>l</mi><mi>i</mi><mi>t</mi><mi>y</mi></mrow><mrow><mspace width="13.0em"/><mi>Γ</mi><mo>⊢</mo><mi>X</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>~</mi><mi>~</mi><mstyle mathvariant="monospace"><mtext>t</mtext></mstyle><mi>h</mi><mi>i</mi><mi>s</mi><mspace width="13.0em"/></mrow></mfrac></math></p>
+</div>
+</li>
+<li>
+<p>A structural field type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>~</mi><mi>~</mi><mstyle mathvariant="monospace"><mtext>T</mtext></mstyle></math> is a subtype of a structural type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>~</mi><mstyle mathvariant="monospace"><mtext>X</mtext></mstyle></math>, if <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>~</mi><mstyle mathvariant="monospace"><mtext>X</mtext></mstyle></math> only contains fields (except methods inherited from <code>Object</code>) and if <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>~</mi><mi>~</mi><mstyle mathvariant="monospace"><mtext>T</mtext></mstyle><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>~</mi><mi>~</mi><mstyle mathvariant="monospace"><mtext>X</mtext></mstyle></math>.</p>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><mi>X</mi><mo>.</mo><mi>m</mi><mi>e</mi><mi>t</mi><mi>h</mi><mi>o</mi><mi>d</mi><mi>s</mi><mo>∖</mo><mstyle mathvariant="monospace"><mtext>Object</mtext></mstyle><mo>.</mo><mi>m</mi><mi>e</mi><mi>t</mi><mi>h</mi><mi>o</mi><mi>d</mi><mi>s</mi><mo>=</mo><mi>∅</mi><mo>∧</mo><mi>Γ</mi><mo>⊢</mo><mi>~</mi><mi>~</mi><mstyle mathvariant="monospace"><mtext>T</mtext></mstyle><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>~</mi><mi>~</mi><mstyle mathvariant="monospace"><mtext>X</mtext></mstyle></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mi>~</mi><mi>~</mi><mstyle mathvariant="monospace"><mtext>T</mtext></mstyle><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>~</mi><mstyle mathvariant="monospace"><mtext>X</mtext></mstyle></mrow></mfrac></math>
+</div>
+</div>
+</li>
+<li>
+<p>Use-site structural typing cannot be used for declaring supertypes of classes or interfaces.
+That is to say that structural types cannot be used after <code>extends</code>, <code>implements</code> or <code>with</code> in type declarations <sup class="footnote">[<a id="_footnoteref_44" class="footnote" href="appendix_c_bibliography.html#_footnote_44" title="View footnote.">44</a>]</sup>.</p>
+</li>
+</ol>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Note that all members of <code>N4Object</code> are excluded.
+This implies that extended reflective features (cf. <a href="conversions_and_reflection.html#_reflection-meta-information">Reflection meta-information</a> ) are not available in the context of structural typing.
+The <code>instanceof</code> operator is still working as described in <a href="expressions.html#_relational-expression">Relational Expression</a>, in that it can be used to check the type of an instance.</p>
+</div>
+<div class="paragraph">
+<p>If a type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>X</mi></math> is a (nominal) subtype of T, it is, of course, also a subtype of <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>~</mi><mstyle mathvariant="monospace"><mtext>T</mtext></mstyle></math>:</p>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><mi>Γ</mi><mo>⊢</mo><mi>X</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>Γ</mi><mo>⊢</mo><mi>T</mi></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mi>X</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>Γ</mi><mo>⊢</mo><mi>~</mi><mstyle mathvariant="monospace"><mtext>T</mtext></mstyle></mrow></mfrac></math>
+</div>
+</div>
+<div class="paragraph">
+<p>This is only a shortcut for the type inference defined above.</p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-77"></a><strong>Req. IDE-77:</strong> <a href="#Req-IDE-77">Definition and Use-Site Precedence</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>If a type is structurally typed on both definition and use-site, the rules for
+use-site structural typing (<a href="#Req-IDE-76">[Req-IDE-76]</a>) are
+applied.</p>
+</div>
+<div class="exampleblock">
+<div class="title">Example 52. Use-Site Structural Typing</div>
+<div class="content">
+<div class="paragraph">
+<p>The following example demonstrates the effect of the structural (field) modifier, used in this case for function parameters.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">interface I { public x: number; public foo()};
+class C { public x: number; public foo() {}};
+
+function n(p: I) {}
+function f(p: ~I) {}
+function g(p: ~~I) {}
+
+n(new C());     // error: nominal typing, C does not implement I
+f(new C());     // ok: C is a (structural) subtype of ~I
+f({x:10});      // error, the object literal does not provide function foo()
+g({x:10});      // ok: object literal provides all fields of I</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="exampleblock">
+<div class="title">Example 53. Structural types variable and instanceof operator</div>
+<div class="content">
+<div class="paragraph">
+<p>It is possible to use a variable typed with a structural version of a type on the left hand side of the <code>instanceof</code> operator, as demonstrated in this example:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">class C {
+    public x;
+    public betterX() { return this.x||1;}
+}
+
+function f(p: ~~C) {
+    if (p instanceof C) {
+        console.log((p as C).betterX);
+    } else {
+        console.log(p.x||1);
+    }
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>The following table describes the member availability of <code>X</code> in various
+typing scenarios. Such as <code>~~X</code>, <code>~r~X</code>, <code>~w~X</code>,  <code>~i~X</code>.</p>
+</div>
+<table class="tableblock frame-all grid-all spread language-n4js">
+<caption class="title">Table 10. Member Availability in various Typing Scenarios</caption>
+<colgroup>
+<col style="width: 33.3333%;">
+<col style="width: 16.6666%;">
+<col style="width: 16.6666%;">
+<col style="width: 16.6666%;">
+<col style="width: 16.6669%;">
+</colgroup>
+<thead>
+<tr>
+<th class="tableblock halign-left valign-top">Member of type <em>X</em></th>
+<th class="tableblock halign-center valign-top"><code>~~X</code></th>
+<th class="tableblock halign-center valign-top"><code>~r~X</code></th>
+<th class="tableblock halign-center valign-top"><code>~w~X</code></th>
+<th class="tableblock halign-center valign-top"><code>~i~X</code></th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>private m0;</code></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">&#8201;&#8212;&#8201;</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">&#8201;&#8212;&#8201;</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">&#8201;&#8212;&#8201;</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">&#8201;&#8212;&#8201;</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>public set m1(m) { }</code></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">write</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">&#8201;&#8212;&#8201;</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">write</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">read</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>public get m2() {&#8230;&#8203;}</code></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">read</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">read</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">&#8201;&#8212;&#8201;</p></td>
+<td class="tableblock halign-center valign-top"></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>public m3;</code></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">read/write</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">read</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">write</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">read</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>public m4 = 'init.m4';</code></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">read/write</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">read</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">write</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">read <em>?</em></p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>public m5: any?;</code></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">read<em>?</em>/write</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">read<em>?</em></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">write</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">read<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>?</mi></math></p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>@Final public m6 = 'init.m6';</code></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">read</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">read</p></td>
+<td class="tableblock halign-center valign-top"></td>
+<td class="tableblock halign-center valign-top"></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>@Final public m7;</code></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">read</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">read</p></td>
+<td class="tableblock halign-center valign-top"></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">read</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>public get m8() {&#8230;&#8203;}</code></p></td>
+<td class="tableblock halign-center valign-middle" rowspan="2"><p class="tableblock">read/write</p></td>
+<td class="tableblock halign-center valign-middle" rowspan="2"><p class="tableblock">read</p></td>
+<td class="tableblock halign-center valign-middle" rowspan="2"><p class="tableblock">write</p></td>
+<td class="tableblock halign-center valign-middle" rowspan="2"><p class="tableblock">read</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>public set m8(m) { }</code></p></td>
+</tr>
+</tbody>
+</table>
+</div>
+</div>
+</div>
+<div class="sect3 language-n4js">
+<h4 id="structural-readWriteInit-field-typing"><a class="anchor" href="#structural-readWriteInit-field-typing"></a><a class="link" href="#structural-readWriteInit-field-typing">5.3.4. Structural Read-only, Write-only and Initializer Field Typing</a></h4>
+<div class="paragraph">
+<p>Structural read-only, write-only and initializer field typings are extensions of structural field typing.
+Everything that is defined for the field structural typing must comply with these extension field typings.
+For the read-only type, readable fields (mutable and <code>@Final</code> ones) and setters are considered, for the write-only type; only the setters and mutable fields are considered.
+Due to the hybrid nature of the initializer type it can act two different ways.
+To be more precise, a type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>X</mi></math> (structural initializer field type) is a supertype of <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>Y</mi></math> (structural initializer field type) if for each public, non-static, non-optional writable field (mutable data field of setter) of <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>X</mi></math>, there is a corresponding, public, non-static readable field of <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>Y</mi></math>.
+All public member fields with <code>@Final</code> annotation are considered to be mandatory in the initializer field typing  <code>@Spec</code> constructors.
+The already-initialized <code>@Final</code> fields can be either omitted from, or can be re-initialized via, an initializer field typing <code>@Spec</code> style constructor.</p>
+</div>
+<div class="exampleblock">
+<div class="title">Example 54. Subtype relationship between structural field typing</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">class A1 {
+    public s: string;
+}
+
+class A2 {
+    public set s(s: string) { }
+    public get s(): string { return null; }
+}
+
+class A3 {
+    @Final public s: string = null;
+}
+
+class A4 {
+    public get s(): string { return null; }
+}
+
+class A5 {
+    public set s(s: string) { }
+}</code></pre>
+</div>
+</div>
+<div style="page-break-after: always;"></div>
+<table class="tableblock frame-all grid-all spread small">
+<colgroup>
+<col style="width: 5.2631%;">
+<col style="width: 5.2631%;">
+<col style="width: 5.2631%;">
+<col style="width: 5.2631%;">
+<col style="width: 5.2631%;">
+<col style="width: 5.2631%;">
+<col style="width: 5.2631%;">
+<col style="width: 5.2631%;">
+<col style="width: 5.2631%;">
+<col style="width: 5.2631%;">
+<col style="width: 5.2631%;">
+<col style="width: 5.2631%;">
+<col style="width: 5.2631%;">
+<col style="width: 5.2631%;">
+<col style="width: 5.2631%;">
+<col style="width: 5.2631%;">
+<col style="width: 5.2631%;">
+<col style="width: 5.2631%;">
+<col style="width: 5.2642%;">
+</colgroup>
+<tbody>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">A1</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">~A1</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">~~A1</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">~r~A1</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">~r~A2</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">~r~A3</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">~r~A4</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">~r~A5</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">~w~A1</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">~w~A2</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">~w~A3</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">~w~A4</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">~w~A5</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">~i~A1</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">~i~A2</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">~i~A3</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">~r~A4</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">~r~A5</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">A1</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">~A1</p></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">~~A1</p></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">~r~A1</p></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">~r~A2</p></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">~r~A3</p></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">~r~A4</p></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">~r~A5</p></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">~w~A1</p></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">~w~A2</p></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">~w~A3</p></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">~w~A4</p></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">~w~A5</p></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">~i~A1</p></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">~i~A2</p></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">~i~A3</p></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">~r~A4</p></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">~r~A5</p></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">✓</p></td>
+<td class="tableblock halign-left valign-top"></td>
+</tr>
+</tbody>
+</table>
+</div>
+</div>
+</div>
+<div class="sect3 language-n4js">
+<h4 id="_public-setter-annotated-with-code-providesinitializer-code"><a class="anchor" href="#_public-setter-annotated-with-code-providesinitializer-code"></a><a class="link" href="#_public-setter-annotated-with-code-providesinitializer-code">5.3.5. Public Setter Annotated With <code>ProvidesInitializer</code></a></h4>
+<div class="paragraph">
+<p>Public setters with <code>ProvidesInitializer</code> annotation can declare optional fields implemented by means of field accessors instead of data fields.
+Data fields with an initializer are treated as optional in the initializer field type.</p>
+</div>
+<div class="paragraph">
+<p>It is important to note that it is valid to use the <code>ProvidesInitializer</code> annotation for setters in <code>n4js</code> files and not only definition files.</p>
+</div>
+<div class="exampleblock">
+<div class="title">Example 55. Setters with <code>@ProvidesInitializer</code> treated as optional</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">class C {
+    private _y: int = 1;
+
+    public get y() { return this._y; }
+    @ProvidesInitializer
+    public set y(v: int) { this._y = v; }
+
+    public constructor(@Spec spec: ~i~this) { }
+}
+
+console.log(new C({}).y); // 1
+console.log(new C({y: 42}).y); //24</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3 language-n4js">
+<h4 id="_structural-types-with-optional-fields"><a class="anchor" href="#_structural-types-with-optional-fields"></a><a class="link" href="#_structural-types-with-optional-fields">5.3.6. Structural Types With Optional Fields</a></h4>
+<div class="paragraph">
+<p>Public optional fields become a member of the structural (field) type as
+well. To ensure the overall type safety, the semantics of optionality (e.g. on or off) depends on the context, in which the optional fields are currently being used (See <a href="#optional-fields">Optional Fields</a>).</p>
+</div>
+</div>
+<div class="sect3 language-n4js">
+<h4 id="_structural-types-with-access-modifier"><a class="anchor" href="#_structural-types-with-access-modifier"></a><a class="link" href="#_structural-types-with-access-modifier">5.3.7. Structural Types With Access Modifier</a></h4>
+<div class="paragraph">
+<p>The access modifier of the subtype have to provide equal or higher
+visibility.</p>
+</div>
+<div class="exampleblock">
+<div class="title">Example 56. Access modifier in structural typing</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">class C {
+    public s: number;
+}
+class D {
+    project s: number;
+}
+function f(c: ~C) {}
+f(new D()); // error: D is no (structural) subtype of ~C, as visibility of s in D is lower
+function g(d: ~D) {}
+g(new C()); // ok: C is a (structural) subtype of ~D, as visibility of s in C is greater-than-or-equal to s in D</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3 language-n4js">
+<h4 id="_structural-types-with-additional-members"><a class="anchor" href="#_structural-types-with-additional-members"></a><a class="link" href="#_structural-types-with-additional-members">5.3.8. Structural Types With Additional Members</a></h4>
+<div class="paragraph">
+<p>It is possible to add additional members when structurally referencing a
+declared type.</p>
+</div>
+<div class="sect4">
+<h5 id="_syntax-8"><a class="anchor" href="#_syntax-8"></a><a class="link" href="#_syntax-8">5.3.8.1. Syntax</a></h5>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">TStructMember:
+    TStructGetter | TStructGetterES4 | TStructSetter | TStructMethod | TStructMethodES4 | TStructField;
+
+TStructMethod:
+    =&gt;
+    ({TStructMethod} ('&lt;' typeVars+=TypeVariable (',' typeVars+=TypeVariable)* '&gt;')?
+    returnTypeRef=TypeRef name=TypesIdentifier '(')
+        (fpars+=TAnonymousFormalParameter (',' fpars+=TAnonymousFormalParameter)*)? ')'
+    ';'?;
+
+TStructMethodES4 returns TStructMethod:
+    =&gt;
+    ({TStructMethod} ('&lt;' typeVars+=TypeVariable (',' typeVars+=TypeVariable)* '&gt;')?
+        name=TypesIdentifier '(')
+        (fpars+=TAnonymousFormalParameter (',' fpars+=TAnonymousFormalParameter)*)? ')'
+        (':' returnTypeRef=TypeRef)?
+    ';'?;
+
+TStructField:
+    (
+        typeRef=TypeRef name=TypesIdentifier
+        | name=TypesIdentifier (':' typeRef=TypeRef)?
+    )
+    ';';
+
+TStructGetter:
+    =&gt; ({TStructGetter}
+    declaredTypeRef=TypeRef
+    'get'
+    name=TypesIdentifier)
+    '(' ')' ';'?;
+
+TStructGetterES4 returns TStructGetter:
+    =&gt; ({TStructGetter}
+    'get'
+    name=TypesIdentifier)
+    '(' ')' (':' declaredTypeRef=TypeRef)? ';'?;
+
+TStructSetter:
+    =&gt; ({TStructSetter}
+    'set'
+    name=TypesIdentifier)
+    '(' fpar=TAnonymousFormalParameter ')' ';'?;
+
+TAnonymousFormalParameter:
+    typeRef=TypeRef variadic?='...'? name=TIdentifier?
+    | variadic?='...'? (=&gt; name=TIdentifier ':') typeRef=TypeRef;</code></pre>
+</div>
+</div>
+<div class="sect5">
+<h6 id="_semantics-6"><a class="anchor" href="#_semantics-6"></a><a class="link" href="#_semantics-6">5.3.8.1.1. Semantics</a></h6>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-78"></a><strong>Req. IDE-78:</strong> <a href="#Req-IDE-78">Additional structural members</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>It is only possible to add additional members to a type if use-site structural typing is used.</p>
+</div>
+<div class="paragraph">
+<p>The following constraints must hold:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>For all additional members defined in a structural type reference, the constraints for member overriding (<a href="#Req-IDE-72">[Req-IDE-72]</a>) apply as well.</p>
+</li>
+<li>
+<p>All additional members have the access modifier set to <code>public</code>.</p>
+</li>
+<li>
+<p>Type variables must not be augmented with additional structural members.</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>Additional fields may be declared optional in the same way as fields in classes.
+The rules given in <a href="#_structural-types-with-optional-fields">Structural Types With Optional Fields</a> apply accordingly.
+Consider the following example:</p>
+</div>
+</div>
+</div>
+<div class="exampleblock">
+<div class="title">Example 57. Additional optional members in structural typing</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">class C {
+    public f1: number;
+}
+
+var c1: ~C with { f3: string; } c1;
+var c2: ~C with { f3: string?; } c2;
+
+c1 = { f1:42 };  // error: "~Object with { number f1; } is not a subtype of ~C with { string f3; }."
+c2 = { f1:42 };  // ok!!</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Augmenting a type variable T with additional structural members can cause collisions with another member of a type argument for T.
+Hence, type variables must not be augmented with additional structural members like in the following example.</p>
+</div>
+<div class="exampleblock">
+<div class="title">Example 58. Forbidden additional structural members on type variables</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">interface I&lt;T&gt; {
+    public field : ~T with {prop : int} // error "No additional structural members allowed on type variables."
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Using an additional structural member on a type variable T could be seen as a constraint to T.
+However, constraints like this should be rather stated using an explicit interface like in the example below.</p>
+</div>
+<div class="exampleblock">
+<div class="title">Example 59. Use explicitly defined Interfaces</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">interface ~J {
+    prop : int;
+}
+interface II&lt;T extends J&gt; {
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div id="footer">
+<div id="footer-text">
+Version 0.9<br>
+Last updated 2019-08-07 15:02:40 CEST
+</div>
+</div>
+<!-- ************* docinfo-footer *************************************************************** -->
+<div class="Grid social" style="color:#d5dfea">
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <h2>Quick Links</h2>
+    <ul>
+      <li><a href="../downloads.html">Download</a></li>
+      <li><a href="../userguides/index.html">Documentation</a></li>
+      <li><a href="https://github.com/eclipse/n4js/">Source</a></li>
+      <li><a href="https://github.com/eclipse/n4js/issues">Issues</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="https://www.eclipse.org/forums/index.php/f/365/">Forum</a></li>
+      <li><a href="http://n4js.blogspot.de/">Blog</a></li>
+      <li><a href="https://dev.eclipse.org/mailman/listinfo/n4js-dev">Mailing List</a></li>
+      <li><a href="https://projects.eclipse.org/projects/technology.n4js">Eclipse Project Page</a></li>
+      <li><a href="https://twitter.com/n4jsdev">Tweets by n4jsdev</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="http://www.eclipse.org/">Eclipse Home</a></li>
+      <li><a href="http://www.eclipse.org/legal/privacy.php">Privacy Policy</a></li>
+      <li><a href="http://www.eclipse.org/legal/termsofuse.php">Terms of Use</a></li>
+      <li><a href="http://www.eclipse.org/legal/copyright.php">Copyright Agent</a></li>
+      <li><a href="http://www.eclipse.org/legal/">Legal</a></li>
+    </ul>
+  </div>
+  <div style="clear: both; height: 0; overflow: hidden;"></div>
+</div>
+
+<!-- ************* UI Scripts ************* -->
+<script type="text/javascript" src="scripts/back-to-top.js"></script>
+
+<script type="text/javascript" src="scripts/treeview.js"></script>
+<script type="text/javascript" src="scripts/toc.js"></script>
+
+<!-- ************* Prism.js Syntax Highlighting ************* -->
+<script src="scripts/prism.js"></script>
+
+<script type="text/javascript">
+	// Add the 'toclist' id for search function
+	$(".toc2 > ul").attr('id', 'toclist');
+	// Generate a Search input form
+	$("#toclist > li:first-of-type").before('<input type="text" id="pagesearch" onkeyup="search()" placeholder="Search for section...">');
+	$("#toclist > li:first-of-type").before('<i id="clear" class="fa fa-times-circle-o"></i>');
+	$("#clear").click(function(){
+	    $("#pagesearch").val('');
+	    search();
+	    $('.toc2 > ul').treeView('collapseAll');
+	});
+	// intialize Treeview.js
+	$(".toc2 > ul").treeView();
+	// Initialize Scrollspy
+</script>
+<!-- ************* docinfo-footer *************************************************************** -->
+</body>
+</html>
\ No newline at end of file
diff --git a/spec/components.html b/spec/components.html
new file mode 100644
index 0000000..066d5f0
--- /dev/null
+++ b/spec/components.html
@@ -0,0 +1,2120 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="generator" content="Asciidoctor 1.5.5">
+<meta name="author" content="2019-08-07 15:02:40 CEST">
+<title>N4JS Language Specification</title>
+<link rel="stylesheet" href="styles/spec.min.css">
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.6.3/css/font-awesome.min.css">
+<!-- ************* docinfo ******************************************************************* -->
+
+
+<!-- ************* Favicon ************-->
+<link rel="icon" href="images/favicon.ico" />
+
+<!-- ************* Back-to-top JQuery ************* -->
+<script src="https://code.jquery.com/jquery-1.12.4.js"></script>
+<script src="https://code.jquery.com/ui/1.12.0/jquery-ui.js"></script>
+
+
+<link href="styles/prism.min.css" rel="stylesheet" />
+<script type="text/javascript" async
+  src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2/MathJax.js?config=TeX-MML-AM_CHTML">
+</script>
+
+<!-- ************* Styles ************* -->
+<link rel="stylesheet" type="text/css" href="styles/n4jsspec-adoc.css">
+
+
+<!-- ****************** NavBar ****************** -->
+<div id="menubar">
+	<div class="banner">
+        <a href="https://www.eclipse.org/n4js/#"><img id="logo" src="images/n4js-logo.png" alt="Eclipse N4JS"></a>
+    </div>
+<ul>
+  <li><a href="index.html">Index</a></li>
+</ul>
+</div>
+<!-- ************* docinfo ******************************************************************* -->
+<style>
+      .admonitionblock td.icon .icon-todo:before{content:"\f249";color:#f4ee42}
+    </style>
+</head>
+<body class="book toc2 toc-left">
+<div id="header">
+<h1>N4JS Language Specification</h1>
+<div class="details">
+<span id="author" class="author">2019-08-07 15:02:40 CEST</span><br>
+<span id="revnumber">version 0.9</span>
+</div>
+<div id="toc" class="toc2">
+<div id="toctitle">Table of Contents</div>
+<ul class="sectlevel1">
+<li><a href="introduction.html#_introduction">1. Introduction</a>
+<ul class="sectlevel2">
+<li><a href="introduction.html#_notation">1.1. Notation</a>
+<ul class="sectlevel3">
+<li><a href="introduction.html#_grammar-notation">1.1.1. Grammar Notation</a></li>
+<li><a href="introduction.html#_type-judgments-and-rules-and-constraints-notation">1.1.2. Type Judgments and Rules and Constraints Notation</a>
+<ul class="sectlevel4">
+<li><a href="introduction.html#_typing-rules-and-judgments">1.1.2.1. Typing Rules and Judgments</a></li>
+<li><a href="introduction.html#_types-of-an-element">1.1.2.2. Types of an Element</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="introduction.html#_auxiliary-functions">1.2. Auxiliary Functions</a>
+<ul class="sectlevel3">
+<li><a href="introduction.html#_binding">1.2.1. Binding</a></li>
+<li><a href="introduction.html#_merging-types">1.2.2. Merging Types</a>
+<ul class="sectlevel4">
+<li><a href="introduction.html#_logic-formulas">1.2.2.1. Logic Formulas</a></li>
+</ul>
+</li>
+<li><a href="introduction.html#_symbols-and-font-convention">1.2.3. Symbols and Font Convention</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="grammar.html#_grammar">2. Grammar</a>
+<ul class="sectlevel2">
+<li><a href="grammar.html#_lexical-conventions">2.1. Lexical Conventions</a>
+<ul class="sectlevel3">
+<li><a href="grammar.html#_identifier-names-and-identifiers">2.1.1. Identifier Names and Identifiers</a></li>
+<li><a href="grammar.html#_this-keyword">2.1.2. This Keyword</a></li>
+<li><a href="grammar.html#_regular-expression-literals">2.1.3. Regular Expression Literals</a></li>
+<li><a href="grammar.html#_automatic-semicolon-insertion">2.1.4. Automatic Semicolon Insertion</a></li>
+<li><a href="grammar.html#_jsdoc">2.1.5. JSDoc</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="names.html#_names">3. Names</a>
+<ul class="sectlevel2">
+<li><a href="names.html#_access-control">3.1. Access Control</a></li>
+<li><a href="names.html#_accessibility-of-types-top-level-variables-and-function-declarations">3.2. Accessibility of Types, Top-Level Variables and Function Declarations</a>
+<ul class="sectlevel3">
+<li><a href="names.html#_accessibility-of-members">3.2.1. Accessibility of Members</a></li>
+<li><a href="names.html#_valid-names">3.2.2. Valid Names</a></li>
+<li><a href="names.html#_qualified-names">3.2.3. Qualified Names</a></li>
+<li><a href="names.html#_name-duplicates">3.2.4. Name Duplicates</a>
+<ul class="sectlevel4">
+<li><a href="names.html#_lexical-environment">3.2.4.1. Lexical Environment</a></li>
+<li><a href="names.html#_duplicates-and-shadowing">3.2.4.2. Duplicates and Shadowing</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="types.html#_types">4. Types</a>
+<ul class="sectlevel2">
+<li><a href="types.html#_overview">4.1. Overview</a></li>
+<li><a href="types.html#_type-expressions">4.2. Type Expressions</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_syntax">4.2.1. Syntax</a></li>
+<li><a href="types.html#_properties">4.2.2. Properties</a></li>
+<li><a href="types.html#_semantics">4.2.3. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_type-inference">4.3. Type Inference</a></li>
+<li><a href="types.html#_generic-and-parameterized-types">4.4. Generic and Parameterized Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_generic-types">4.4.1. Generic Types</a></li>
+<li><a href="types.html#_type-variables">4.4.2. Type Variables</a></li>
+<li><a href="types.html#_parameterized-types">4.4.3. Parameterized Types</a></li>
+</ul>
+</li>
+<li><a href="types.html#_primitive-ecmascript-types">4.5. Primitive ECMAScript Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_undefined-type">4.5.1. Undefined Type</a></li>
+<li><a href="types.html#_null-type">4.5.2. Null Type</a></li>
+<li><a href="types.html#_primitive-boolean-type">4.5.3. Primitive Boolean Type</a></li>
+<li><a href="types.html#_primitive-string-type">4.5.4. Primitive String Type</a></li>
+<li><a href="types.html#_primitive-number-type">4.5.5. Primitive Number Type</a></li>
+<li><a href="types.html#_primitive-type-int">4.5.6. Primitive Type int</a></li>
+<li><a href="types.html#_primitive-symbol-type">4.5.7. Primitive Symbol Type</a></li>
+</ul>
+</li>
+<li><a href="types.html#_primitive-n4js-types">4.6. Primitive N4JS Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_any-type">4.6.1. Any Type</a>
+<ul class="sectlevel4">
+<li><a href="types.html#any-type-semantics">4.6.1.1. Semantics</a></li>
+<li><a href="types.html#any-type-type-inference">4.6.1.2. Type Inference</a>
+<ul class="sectlevel5">
+<li><a href="types.html#_default-type-of-variables">4.6.1.2.1. Default Type of Variables</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="types.html#_void-type">4.6.2. Void Type</a>
+<ul class="sectlevel4">
+<li><a href="types.html#void-type-semantics">4.6.2.1. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_unknown-type">4.6.3. Unknown Type</a></li>
+<li><a href="types.html#_primitive-pathselector-and-i18nkey">4.6.4. Primitive Pathselector and I18nKey</a>
+<ul class="sectlevel4">
+<li><a href="types.html#pathselector-semantics">4.6.4.1. Semantics</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="types.html#_built-in-ecmascript-object-types">4.7. Built-in ECMAScript Object Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#ECMAScript-objects-semantics">4.7.1. Semantics</a></li>
+<li><a href="types.html#_object-type">4.7.2. Object Type</a></li>
+<li><a href="types.html#_function-object-type">4.7.3. Function-Object-Type</a></li>
+<li><a href="types.html#_array-object-type">4.7.4. Array Object Type</a></li>
+<li><a href="types.html#_string-object-type">4.7.5. String Object Type</a></li>
+<li><a href="types.html#_boolean-object-type">4.7.6. Boolean Object Type</a></li>
+<li><a href="types.html#_number-object-type">4.7.7. Number Object Type</a></li>
+<li><a href="types.html#_global-object-type">4.7.8. Global Object Type</a></li>
+<li><a href="types.html#_symbol">4.7.9. Symbol</a></li>
+<li><a href="types.html#_promise">4.7.10. Promise</a></li>
+<li><a href="types.html#_iterator-interface">4.7.11. Iterator Interface</a></li>
+<li><a href="types.html#_iterable-interface">4.7.12. Iterable Interface</a></li>
+</ul>
+</li>
+<li><a href="types.html#_built-in-n4js-types">4.8. Built-In N4JS Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_n4object">4.8.1. N4Object</a>
+<ul class="sectlevel4">
+<li><a href="types.html#N4Object-semantics">4.8.1.1. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_n4class">4.8.2. N4Class</a></li>
+<li><a href="types.html#IterableN">4.8.3. IterableN</a></li>
+</ul>
+</li>
+<li><a href="types.html#_type-modifiers">4.9. Type Modifiers</a>
+<ul class="sectlevel3">
+<li><a href="types.html#Type_Modifiers_Dynamic">4.9.1. Dynamic</a></li>
+<li><a href="types.html#_optional-return-types">4.9.2. Optional Return Types</a></li>
+</ul>
+</li>
+<li><a href="types.html#_union-and-intersection-type-composed-types">4.10. Union and Intersection Type (Composed Types)</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_union-type">4.10.1. Union Type</a>
+<ul class="sectlevel4">
+<li><a href="types.html#union-type-syntax">4.10.1.1. Syntax</a></li>
+<li><a href="types.html#union-type-semantics">4.10.1.2. Semantics</a></li>
+<li><a href="types.html#_warnings">4.10.1.3. Warnings</a></li>
+</ul>
+</li>
+<li><a href="types.html#_intersection-type">4.10.2. Intersection Type</a>
+<ul class="sectlevel4">
+<li><a href="types.html#intersection-type-syntax">4.10.2.1. Syntax</a></li>
+<li><a href="types.html#intersection-type-semantics">4.10.2.2. Semantics</a></li>
+<li><a href="types.html#_warnings-2">4.10.2.3. Warnings</a></li>
+</ul>
+</li>
+<li><a href="types.html#_composed-types-in-wildcards">4.10.3. Composed Types in Wildcards</a></li>
+<li><a href="types.html#_property-access-for-composed-types">4.10.4. Property Access for Composed Types</a>
+<ul class="sectlevel4">
+<li><a href="types.html#_properties-of-union-type">4.10.4.1. Properties of Union Type</a>
+<ul class="sectlevel5">
+<li><a href="types.html#_remarks-on-union-type-s-members">4.10.4.1.1. Remarks on union type’s members:</a></li>
+</ul>
+</li>
+<li><a href="types.html#_properties-of-intersection-type">4.10.4.2. Properties of Intersection Type</a>
+<ul class="sectlevel5">
+<li><a href="types.html#_remarks-on-intersection-type-s-methods">4.10.4.2.1. Remarks on intersection type’s methods:</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="types.html#_constructor-and-classifier-type">4.11. Constructor and Classifier Type</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_syntax-3">4.11.1. Syntax</a></li>
+<li><a href="types.html#_semantics-2">4.11.2. Semantics</a></li>
+<li><a href="types.html#_constructors-and-prototypes-in-ecmascript-2015">4.11.3. Constructors and Prototypes in ECMAScript 2015</a></li>
+</ul>
+</li>
+<li><a href="types.html#_this-type">4.12. This Type</a>
+<ul class="sectlevel3">
+<li><a href="types.html#this-type-syntax">4.12.1. Syntax</a></li>
+<li><a href="types.html#this-keyword-semantics">4.12.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_enums">4.13. Enums</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_enums-n4js">4.13.1. Enums (N4JS)</a>
+<ul class="sectlevel4">
+<li><a href="types.html#enums-syntax">4.13.1.1. Syntax</a></li>
+<li><a href="types.html#enums-semantics">4.13.1.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_string-based-enums">4.13.2. String-Based Enums</a></li>
+</ul>
+</li>
+<li><a href="types.html#_short-hand-syntax">4.14. Short-Hand Syntax</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_array-short-hand-syntax">4.14.1. Array Short-Hand Syntax</a></li>
+<li><a href="types.html#_iterablen-short-hand-syntax">4.14.2. IterableN Short-Hand Syntax</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="classifiers.html#_classifiers">5. Classifiers</a>
+<ul class="sectlevel2">
+<li><a href="classifiers.html#_n4js-specific-classifiers">5.1. N4JS Specific Classifiers</a>
+<ul class="sectlevel3">
+<li><a href="classifiers.html#_properties-2">5.1.1. Properties</a></li>
+<li><a href="classifiers.html#_common-semantics-of-classifiers">5.1.2. Common Semantics of Classifiers</a></li>
+<li><a href="classifiers.html#_classes">5.1.3. Classes</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_definition-of-classes">5.1.3.1. Definition of Classes</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#class-syntax">5.1.3.1.1. Syntax</a></li>
+<li><a href="classifiers.html#class-properties">5.1.3.1.2. Properties</a></li>
+<li><a href="classifiers.html#class-type-inference">5.1.3.1.3. Type Inference</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#class-semantics">5.1.3.2. Semantics</a></li>
+<li><a href="classifiers.html#_final-modifier">5.1.3.3. Final Modifier</a></li>
+<li><a href="classifiers.html#_abstract-classes">5.1.3.4. Abstract Classes</a></li>
+<li><a href="classifiers.html#_non-instantiable-classes">5.1.3.5. Non-Instantiable Classes</a></li>
+<li><a href="classifiers.html#_superclass">5.1.3.6. Superclass</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_interfaces">5.1.4. Interfaces</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_definition-of-interfaces">5.1.4.1. Definition of Interfaces</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#interfaces-syntax">5.1.4.1.1. Syntax</a></li>
+<li><a href="classifiers.html#interfaces-properties">5.1.4.1.2. Properties</a></li>
+<li><a href="classifiers.html#interfaces-type-inference">5.1.4.1.3. Type Inference</a></li>
+<li><a href="classifiers.html#interfaces-semantics">5.1.4.1.4. Semantics</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="classifiers.html#_generic-classifiers">5.1.5. Generic Classifiers</a></li>
+<li><a href="classifiers.html#sec:definition-site-variance">5.1.6. Definition-Site Variance</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_members">5.2. Members</a>
+<ul class="sectlevel3">
+<li><a href="classifiers.html#_syntax-4">5.2.1. Syntax</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_properties-3">5.2.1.1. Properties</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_semantics-3">5.2.2. Semantics</a></li>
+<li><a href="classifiers.html#_methods">5.2.3. Methods</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_syntax-5">5.2.3.1. Syntax</a></li>
+<li><a href="classifiers.html#_properties-4">5.2.3.2. Properties</a></li>
+<li><a href="classifiers.html#_semantics-4">5.2.3.3. Semantics</a></li>
+<li><a href="classifiers.html#_final-methods">5.2.3.4. Final Methods</a></li>
+<li><a href="classifiers.html#_abstract-methods">5.2.3.5. Abstract Methods</a></li>
+<li><a href="classifiers.html#_generic-methods">5.2.3.6. Generic Methods</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_default-methods-in-interfaces">5.2.4. Default Methods in Interfaces</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_asynchronous-methods">5.2.4.1. Asynchronous Methods</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_constructors">5.2.5. Constructors</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_structural-this-type-in-constructor">5.2.5.1. Structural This Type in Constructor</a></li>
+<li><a href="classifiers.html#spec-constructor">5.2.5.2. @Spec Constructor</a></li>
+<li><a href="classifiers.html#_callable-constructors">5.2.5.3. Callable Constructors</a></li>
+<li><a href="classifiers.html#_covariant-constructors">5.2.5.4. Covariant Constructors</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_data-fields">5.2.6. Data Fields</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#data-fields-syntax">5.2.6.1. Syntax</a></li>
+<li><a href="classifiers.html#data-fields-properties">5.2.6.2. Properties</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#data-fields-semantics">5.2.6.2.1. Semantics</a></li>
+<li><a href="classifiers.html#data-fields-type-inference">5.2.6.2.2. Type Inference</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_assignment-modifiers">5.2.6.3. Assignment Modifiers</a></li>
+<li><a href="classifiers.html#_field-accessors-getter-setter">5.2.6.4. Field Accessors (Getter/Setter)</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#field-acessors-syntax">5.2.6.4.1. Syntax</a></li>
+<li><a href="classifiers.html#field-acessors-properties">5.2.6.4.2. Properties</a></li>
+<li><a href="classifiers.html#field-accessors-semantics">5.2.6.4.3. Semantics</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#optional-fields">5.2.6.5. Optional Fields</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#_syntax-6">5.2.6.5.1. Syntax</a></li>
+<li><a href="classifiers.html#_semantics-5">5.2.6.5.2. Semantics</a></li>
+<li><a href="classifiers.html#_background">5.2.6.5.3. Background</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="classifiers.html#_static-members">5.2.7. Static Members</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_access-from-and-to-static-members">5.2.7.1. Access From and To Static Members</a></li>
+<li><a href="classifiers.html#_generic-static-methods">5.2.7.2. Generic static methods</a></li>
+<li><a href="classifiers.html#_static-members-of-interfaces">5.2.7.3. Static Members of Interfaces</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_redefinition-of-members">5.2.8. Redefinition of Members</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_overriding-of-members">5.2.8.1. Overriding of Members</a></li>
+<li><a href="classifiers.html#_implementation-of-members">5.2.8.2. Implementation of Members</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#_member-consumption">5.2.8.2.1. Member Consumption</a></li>
+<li><a href="classifiers.html#_member-implementation">5.2.8.2.2. Member Implementation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="classifiers.html#_structural-typing">5.3. Structural Typing</a>
+<ul class="sectlevel3">
+<li><a href="classifiers.html#_syntax-7">5.3.1. Syntax</a></li>
+<li><a href="classifiers.html#_definition-site-structural-typing">5.3.2. Definition Site Structural Typing</a></li>
+<li><a href="classifiers.html#_use-site-structural-typing">5.3.3. Use-Site Structural Typing</a></li>
+<li><a href="classifiers.html#structural-readWriteInit-field-typing">5.3.4. Structural Read-only, Write-only and Initializer Field Typing</a></li>
+<li><a href="classifiers.html#_public-setter-annotated-with-code-providesinitializer-code">5.3.5. Public Setter Annotated With <code>ProvidesInitializer</code></a></li>
+<li><a href="classifiers.html#_structural-types-with-optional-fields">5.3.6. Structural Types With Optional Fields</a></li>
+<li><a href="classifiers.html#_structural-types-with-access-modifier">5.3.7. Structural Types With Access Modifier</a></li>
+<li><a href="classifiers.html#_structural-types-with-additional-members">5.3.8. Structural Types With Additional Members</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_syntax-8">5.3.8.1. Syntax</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#_semantics-6">5.3.8.1.1. Semantics</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="functions.html#_functions">6. Functions</a>
+<ul class="sectlevel2">
+<li><a href="functions.html#_function-type">6.1. Function Type</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_properties-5">6.1.1. Properties</a></li>
+<li><a href="functions.html#function-type-inference">6.1.2. Type Inference</a></li>
+<li><a href="functions.html#_autoboxing-of-function-type">6.1.3. Autoboxing of Function Type</a></li>
+<li><a href="functions.html#_arguments-object">6.1.4. Arguments Object</a></li>
+</ul>
+</li>
+<li><a href="functions.html#_ecmascript-5-function-definition">6.2. ECMAScript 5 Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_function-declaration">6.2.1. Function Declaration</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#_syntax-9">6.2.1.1. Syntax</a></li>
+<li><a href="functions.html#_semantics-8">6.2.1.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="functions.html#_function-expression">6.2.2. Function Expression</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#function-expression-syntax">6.2.2.1. Syntax</a></li>
+<li><a href="functions.html#_semantics-and-type-inference">6.2.2.2. Semantics and Type Inference</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="functions.html#_ecmascript-2015-function-definition">6.3. ECMAScript 2015 Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_formal-parameters">6.3.1. Formal Parameters</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#Type_Modifiers_Optional">6.3.1.1. Optional Parameters</a></li>
+<li><a href="functions.html#Type_Modifiers_Default">6.3.1.2. Default Parameters</a></li>
+<li><a href="functions.html#Type_Modifiers_Variadic">6.3.1.3. Variadic</a></li>
+</ul>
+</li>
+<li><a href="functions.html#_generator-functions">6.3.2. Generator Functions</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#generator-functions-syntax">6.3.2.1. Syntax</a></li>
+<li><a href="functions.html#generator-functions-semantics">6.3.2.2. Semantics</a></li>
+<li><a href="functions.html#_generator-arrow-functions">6.3.2.3. Generator Arrow Functions</a></li>
+</ul>
+</li>
+<li><a href="functions.html#_arrow-function-expression">6.3.3. Arrow Function Expression</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#arrow-function-expression-syntax">6.3.3.1. Syntax</a></li>
+<li><a href="functions.html#arrow-function-expression-semantics-and-type-inference">6.3.3.2. Semantics and Type Inference</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="functions.html#_ecmascript-proposals-function-definition">6.4. ECMAScript Proposals Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_asynchronous-functions">6.4.1. Asynchronous Functions</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#asynchronous-functions-syntax">6.4.1.1. Syntax</a></li>
+<li><a href="functions.html#asynchronous-functions-semantics">6.4.1.2. Semantics</a></li>
+<li><a href="functions.html#_asynchronous-arrow-functions">6.4.1.3. Asynchronous Arrow Functions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="functions.html#_n4js-extended-function-definition">6.5. N4JS Extended Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_generic-functions">6.5.1. Generic Functions</a></li>
+<li><a href="functions.html#_promisifiable-functions">6.5.2. Promisifiable Functions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_conversions-and-reflection">7. Conversions and Reflection</a>
+<ul class="sectlevel2">
+<li><a href="conversions_and_reflection.html#_autoboxing-and-coercing">7.1. Autoboxing and Coercing</a>
+<ul class="sectlevel3">
+<li><a href="conversions_and_reflection.html#_coercing">7.1.1. Coercing</a></li>
+<li><a href="conversions_and_reflection.html#_autoboxing-of-primitives">7.1.2. Autoboxing of Primitives</a></li>
+<li><a href="conversions_and_reflection.html#_autoboxing-of-function-expressions-and-declarations">7.1.3. Autoboxing of Function Expressions and Declarations</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_auto-conversion-of-objects">7.2. Auto-Conversion of Objects</a>
+<ul class="sectlevel3">
+<li><a href="conversions_and_reflection.html#_auto-conversion-of-class-instances">7.2.1. Auto-Conversion of Class Instances</a>
+<ul class="sectlevel4">
+<li><a href="conversions_and_reflection.html#_auto-conversion-of-interface-instances">7.2.1.1. Auto-Conversion of Interface Instances</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_auto-conversion-of-enum-literals">7.2.2. Auto-Conversion of Enum Literals</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_type-cast-and-type-check">7.3. Type Cast and Type Check</a>
+<ul class="sectlevel3">
+<li><a href="conversions_and_reflection.html#_type-cast">7.3.1. Type Cast</a></li>
+<li><a href="conversions_and_reflection.html#_type-check">7.3.2. Type Check</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_reflection-meta-information">7.4. Reflection meta-information</a>
+<ul class="sectlevel3">
+<li><a href="conversions_and_reflection.html#_reflection-for-classes">7.4.1. Reflection for Classes</a></li>
+<li><a href="conversions_and_reflection.html#_reflection-for-interfaces">7.4.2. Reflection for Interfaces</a></li>
+<li><a href="conversions_and_reflection.html#_reflection-for-enumerations">7.4.3. Reflection for Enumerations</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_conversion-of-primitive-types">7.5. Conversion of primitive types</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_expressions">8. Expressions</a>
+<ul class="sectlevel2">
+<li><a href="expressions.html#_ecmascript-5-expressions">8.1. ECMAScript 5 Expressions</a>
+<ul class="sectlevel3">
+<li><a href="expressions.html#_the-this-literal">8.1.1. The this Literal</a></li>
+<li><a href="expressions.html#_identifier">8.1.2. Identifier</a></li>
+<li><a href="expressions.html#_literals">8.1.3. Literals</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#_integer-literals">8.1.3.1. Integer Literals</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_array-literal">8.1.4. Array Literal</a></li>
+<li><a href="expressions.html#_object-literal">8.1.5. Object Literal</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#_properties-6">8.1.5.1. Properties</a></li>
+<li><a href="expressions.html#_scoping-and-linking">8.1.5.2. Scoping and linking</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_parenthesized-expression-and-grouping-operator">8.1.6. Parenthesized Expression and Grouping Operator</a></li>
+<li><a href="expressions.html#_property-accessors">8.1.7. Property Accessors</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#properties-1">8.1.7.1. Properties</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_new-expression">8.1.8. New Expression</a></li>
+<li><a href="expressions.html#_function-expression-2">8.1.9. Function Expression</a></li>
+<li><a href="expressions.html#_function-calls">8.1.10. Function Calls</a></li>
+<li><a href="expressions.html#_postfix-expression">8.1.11. Postfix Expression</a></li>
+<li><a href="expressions.html#_unary-expression">8.1.12. Unary Expression</a></li>
+<li><a href="expressions.html#_multiplicative-expression">8.1.13. Multiplicative Expression</a></li>
+<li><a href="expressions.html#_additive-expression">8.1.14. Additive Expression</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#type-inference-10">8.1.14.1. Type Inference</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_bitwise-shift-expression">8.1.15. Bitwise Shift Expression</a></li>
+<li><a href="expressions.html#_relational-expression">8.1.16. Relational Expression</a></li>
+<li><a href="expressions.html#_equality-expression">8.1.17. Equality Expression</a></li>
+<li><a href="expressions.html#_binary-bitwise-expression">8.1.18. Binary Bitwise Expression</a></li>
+<li><a href="expressions.html#_binary-logical-expression">8.1.19. Binary Logical Expression</a></li>
+<li><a href="expressions.html#_conditional-expression">8.1.20. Conditional Expression</a></li>
+<li><a href="expressions.html#_assignment-expression">8.1.21. Assignment Expression</a></li>
+<li><a href="expressions.html#_comma-expression">8.1.22. Comma Expression</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_ecmascript-6-expressions">8.2. ECMAScript 6 Expressions</a>
+<ul class="sectlevel3">
+<li><a href="expressions.html#_the-super-keyword">8.2.1. The super Keyword</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_ecmascript-7-expressions">8.3. ECMAScript 7 Expressions</a>
+<ul class="sectlevel3">
+<li><a href="expressions.html#_await-expression">8.3.1. Await Expression</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_n4js-specific-expressions">8.4. N4JS Specific Expressions</a>
+<ul class="sectlevel3">
+<li><a href="expressions.html#_class-expression">8.4.1. Class Expression</a></li>
+<li><a href="expressions.html#_cast-as-expression">8.4.2. Cast (As) Expression</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#cast-as-expression-semantics-type-inference">8.4.2.1. Semantics and Type Inference</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#Import_Calls">8.4.3. Import Calls</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#compile-time-expressions">8.5. Compile-Time Expressions</a></li>
+</ul>
+</li>
+<li><a href="statements.html#_statements">9. Statements</a>
+<ul class="sectlevel2">
+<li><a href="statements.html#_ecmascript-5-statements">9.1. ECMAScript 5 Statements</a>
+<ul class="sectlevel3">
+<li><a href="statements.html#_function-or-field-accessor-bodies">9.1.1. Function or Field Accessor Bodies</a></li>
+<li><a href="statements.html#_variable-statement">9.1.2. Variable Statement</a></li>
+<li><a href="statements.html#_if-statement">9.1.3. If Statement</a></li>
+<li><a href="statements.html#_iteration-statements">9.1.4. Iteration Statements</a></li>
+<li><a href="statements.html#_return-statement">9.1.5. Return Statement</a></li>
+<li><a href="statements.html#_with-statement">9.1.6. With Statement</a></li>
+<li><a href="statements.html#_switch-statement">9.1.7. Switch Statement</a></li>
+<li><a href="statements.html#_throw-try-and-catch-statements">9.1.8. Throw, Try, and Catch Statements</a></li>
+<li><a href="statements.html#_debugger-statement">9.1.9. Debugger Statement</a></li>
+</ul>
+</li>
+<li><a href="statements.html#_ecmascript-6-statements">9.2. ECMAScript 6 Statements</a>
+<ul class="sectlevel3">
+<li><a href="statements.html#_let">9.2.1. Let</a></li>
+<li><a href="statements.html#_const">9.2.2. Const</a></li>
+<li><a href="statements.html#_for-of-statement">9.2.3. <code>for &#8230;&#8203; of</code> statement</a></li>
+<li><a href="statements.html#_import-statement">9.2.4. Import Statement</a>
+<ul class="sectlevel4">
+<li><a href="statements.html#Dynamic_Imports">9.2.4.1. Dynamic Imports</a></li>
+<li><a href="statements.html#_immutabilaty-of-imports">9.2.4.2. Immutabilaty of Imports</a></li>
+</ul>
+</li>
+<li><a href="statements.html#_export-statement">9.2.5. Export Statement</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="annotations.html#_annotations">10. Annotations</a>
+<ul class="sectlevel2">
+<li><a href="annotations.html#_introduction-2">10.1. Introduction</a>
+<ul class="sectlevel3">
+<li><a href="annotations.html#_syntax-13">10.1.1. Syntax</a></li>
+<li><a href="annotations.html#_properties-7">10.1.2. Properties</a></li>
+<li><a href="annotations.html#_element-specific-annotations">10.1.3. Element-Specific Annotations</a></li>
+<li><a href="annotations.html#_general-annotations">10.1.4. General Annotations</a>
+<ul class="sectlevel4">
+<li><a href="annotations.html#_idebug">10.1.4.1. IDEBUG</a></li>
+</ul>
+</li>
+<li><a href="annotations.html#idebug-syntax">10.1.5. Syntax</a>
+<ul class="sectlevel4">
+<li><a href="annotations.html#_semantics-11">10.1.5.1. Semantics</a></li>
+<li><a href="annotations.html#_suppress-warnings">10.1.5.2. Suppress Warnings</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="annotations.html#_declaration-of-annotations">10.2. Declaration of Annotations</a></li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_extended-fetaures">11. Extended Fetaures</a>
+<ul class="sectlevel2">
+<li><a href="extended_fetaures.html#_array-and-object-destructuring">11.1. Array and Object Destructuring</a>
+<ul class="sectlevel3">
+<li><a href="extended_fetaures.html#_syntax-14">11.1.1. Syntax</a></li>
+<li><a href="extended_fetaures.html#_semantics-12">11.1.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_dependency-injection">11.2. Dependency Injection</a>
+<ul class="sectlevel3">
+<li><a href="extended_fetaures.html#_di-components-and-injectors">11.2.1. DI Components and Injectors</a>
+<ul class="sectlevel4">
+<li><a href="extended_fetaures.html#_dicomponent-relations">11.2.1.1. DIComponent Relations</a></li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_binders-and-bindings">11.2.2. Binders and Bindings</a></li>
+<li><a href="extended_fetaures.html#_injection-points">11.2.3. Injection Points</a>
+<ul class="sectlevel4">
+<li><a href="extended_fetaures.html#_field-injection">11.2.3.1. Field Injection</a></li>
+<li><a href="extended_fetaures.html#_constructor-injection">11.2.3.2. Constructor Injection</a></li>
+<li><a href="extended_fetaures.html#_method-injection">11.2.3.3. Method Injection</a>
+<ul class="sectlevel5">
+<li><a href="extended_fetaures.html#_provider">11.2.3.3.1. Provider</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_n4js-di-life-cycle-and-scopes">11.2.4. N4JS DI Life Cycle and Scopes</a>
+<ul class="sectlevel4">
+<li><a href="extended_fetaures.html#_injection-cylces">11.2.4.1. Injection Cylces</a></li>
+<li><a href="extended_fetaures.html#_default-scope">11.2.4.2. Default Scope</a></li>
+<li><a href="extended_fetaures.html#_singleton-scope">11.2.4.3. Singleton Scope</a></li>
+<li><a href="extended_fetaures.html#_per-injection-chain-singleton">11.2.4.4. Per Injection Chain Singleton</a></li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_validation-of-callsites-targeting-n4injector-methods">11.2.5. Validation of callsites targeting N4Injector methods</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-annotations">11.2.6. N4JS DI Annotations</a>
+<ul class="sectlevel4">
+<li><a href="extended_fetaures.html#_n4js-di-generateinjector">11.2.6.1. N4JS DI @GenerateInjector</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-withparentinjector">11.2.6.2. N4JS DI @WithParentInjector</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-usebinder">11.2.6.3. N4JS DI @UseBinder</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-binder">11.2.6.4. N4JS DI @Binder</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-bind">11.2.6.5. N4JS DI @Bind</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-provides">11.2.6.6. N4JS DI @Provides</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-inject">11.2.6.7. N4JS DI @Inject</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-singleton">11.2.6.8. N4JS DI @Singleton</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_test-support">11.3. Test Support</a></li>
+<li><a href="extended_fetaures.html#_polyfill-definitions">11.4. Polyfill Definitions</a>
+<ul class="sectlevel3">
+<li><a href="extended_fetaures.html#_runtime-polyfill-definitions">11.4.1. Runtime Polyfill Definitions</a></li>
+<li><a href="extended_fetaures.html#_static-polyfill-definitions">11.4.2. Static Polyfill Definitions</a></li>
+<li><a href="extended_fetaures.html#_transpiling-static-polyfilled-classes">11.4.3. Transpiling static polyfilled classes</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#_components">12. Components</a>
+<ul class="sectlevel2">
+<li><a href="#_overview-2">12.1. Overview</a></li>
+<li><a href="#Component_Types">12.2. Component Types</a>
+<ul class="sectlevel3">
+<li><a href="#_libraries">12.2.1. Libraries</a></li>
+<li><a href="#_runtime-environment-and-runtime-libraries">12.2.2. Runtime Environment and Runtime Libraries</a></li>
+<li><a href="#_tests">12.2.3. Tests</a></li>
+<li><a href="#_type-definitions">12.2.4. Type Definitions</a></li>
+</ul>
+</li>
+<li><a href="#package-json">12.3. Package.json File</a>
+<ul class="sectlevel3">
+<li><a href="#_basic-properties">12.3.1. Basic Properties</a></li>
+<li><a href="#_n4js-properties">12.3.2. N4JS Properties</a></li>
+<li><a href="#_constraints">12.3.3. Constraints</a></li>
+</ul>
+</li>
+<li><a href="#_support-for-npm-scopes">12.4. Support for NPM Scopes</a></li>
+<li><a href="#sec:N4JS-Type-Definitions">12.5. N4JS Type Definitions</a>
+<ul class="sectlevel3">
+<li><a href="#_specify-type-definition">12.5.1. Specify Type Definition</a></li>
+<li><a href="#_name-conventions">12.5.2. Name Conventions</a></li>
+<li><a href="#_version-conventions">12.5.3. Version Conventions</a>
+<ul class="sectlevel4">
+<li><a href="#_define-a-new-type-definition-package">12.5.3.1. Define a New Type Definition Package</a></li>
+<li><a href="#_using-a-type-definition-package">12.5.3.2. Using a Type Definition Package</a></li>
+<li><a href="#_rational">12.5.3.3. Rational</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#_modules">12.6. Modules</a></li>
+<li><a href="#_api-and-implementation-component">12.7. API and Implementation Component</a>
+<ul class="sectlevel3">
+<li><a href="#_execution-of-api-and-implementation-components">12.7.1. Execution of API and Implementation Components</a></li>
+<li><a href="#_api-and-implementation-with-di">12.7.2. API and Implementation With DI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="plainjs.html#_plainjs">13. PlainJS</a>
+<ul class="sectlevel2">
+<li><a href="plainjs.html#_type-inference-and-validation-for-plain-js">13.1. Type Inference and Validation for Plain JS</a></li>
+<li><a href="plainjs.html#_external-declarations">13.2. External Declarations</a>
+<ul class="sectlevel3">
+<li><a href="plainjs.html#_declaring-externals">13.2.1. Declaring externals</a></li>
+<li><a href="plainjs.html#_instantiating-external-classes">13.2.2. Instantiating external classes</a></li>
+<li><a href="plainjs.html#_implementation-of-external-declarations">13.2.3. Implementation of External Declarations</a></li>
+<li><a href="plainjs.html#_example">13.2.4. Example</a></li>
+</ul>
+</li>
+<li><a href="plainjs.html#_global-definitions">13.3. Global Definitions</a></li>
+<li><a href="plainjs.html#_runtime-definitions">13.4. Runtime Definitions</a></li>
+<li><a href="plainjs.html#_applying-polyfills">13.5. Applying Polyfills</a></li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_jsdoc-2">14. JSDoc</a>
+<ul class="sectlevel2">
+<li><a href="jsdoc.html#_general-n4jsdoc-features">14.1. General N4JSDoc Features</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#_provided-inline-tags">14.1.1. Provided Inline Tags</a>
+<ul class="sectlevel4">
+<li><a href="jsdoc.html#jsdoc_tag__code">14.1.1.1. @code</a></li>
+<li><a href="jsdoc.html#jsdoc_tag__link">14.1.1.2. @link</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_n4jsdoc-for-user-projects">14.2. N4JSdoc for User Projects</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#_standard-tags">14.2.1. Standard Tags</a>
+<ul class="sectlevel4">
+<li><a href="jsdoc.html#_-author">14.2.1.1. @author</a></li>
+<li><a href="jsdoc.html#jsdoc_tag_param">14.2.1.2. @param</a></li>
+<li><a href="jsdoc.html#jsdoc_tag_return">14.2.1.3. @return</a></li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_test-related-tags">14.2.2. Test Related Tags</a>
+<ul class="sectlevel4">
+<li><a href="jsdoc.html#jsdoc_tag__testee">14.2.2.1. @testee</a></li>
+<li><a href="jsdoc.html#jsdoc_tag__testeeFromType">14.2.2.2. @testeeFromType</a></li>
+<li><a href="jsdoc.html#_testeeType_and__testeeMember">14.2.2.3. @testeeType and @testeeMember</a></li>
+<li><a href="jsdoc.html#jsdoc_tag_reqid_in_Tests">14.2.2.4. @reqid in Tests</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_n4jsdoc-for-api-and-implementation-projects">14.3. N4JSDoc for API and Implementation Projects</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#jsdoc_tag__apiNote">14.3.1. @apiNote</a></li>
+<li><a href="jsdoc.html#API_Project_Tags">14.3.2. API Project Tags</a>
+<ul class="sectlevel4">
+<li><a href="jsdoc.html#jsdoc_tag_apiState">14.3.2.1. @apiState</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsx.html#_jsx">15. JSX</a>
+<ul class="sectlevel2">
+<li><a href="jsx.html#_jsx-support">15.1. JSX Support</a></li>
+<li><a href="jsx.html#_jsx-backend">15.2. JSX Backend</a></li>
+</ul>
+</li>
+<li><a href="grammars.html#_grammars">16. Grammars</a>
+<ul class="sectlevel2">
+<li><a href="grammars.html#_type-expressions-grammar">16.1. Type Expressions Grammar</a></li>
+<li><a href="grammars.html#_n4js-language-grammar">16.2. N4JS Language Grammar</a></li>
+</ul>
+</li>
+<li><a href="jsobjects.html#_jsobjects">17. JSObjects</a>
+<ul class="sectlevel2">
+<li><a href="jsobjects.html#_object">17.1. Object</a></li>
+<li><a href="jsobjects.html#_string">17.2. String</a></li>
+<li><a href="jsobjects.html#_boolean">17.3. Boolean</a></li>
+<li><a href="jsobjects.html#_number">17.4. Number</a>
+<ul class="sectlevel3">
+<li><a href="jsobjects.html#_static-attributes">17.4.1. Static Attributes</a></li>
+</ul>
+</li>
+<li><a href="jsobjects.html#function">17.5. Function</a></li>
+<li><a href="jsobjects.html#_error">17.6. Error</a></li>
+<li><a href="jsobjects.html#_array">17.7. Array</a></li>
+<li><a href="jsobjects.html#_date">17.8. Date</a></li>
+<li><a href="jsobjects.html#_math">17.9. Math</a>
+<ul class="sectlevel3">
+<li><a href="jsobjects.html#static-attributes-1">17.9.1. Static Attributes</a></li>
+</ul>
+</li>
+<li><a href="jsobjects.html#_regexp">17.10. RegExp</a></li>
+<li><a href="jsobjects.html#_json">17.11. JSON</a></li>
+</ul>
+</li>
+<li><a href="n4js_objects.html#_n4js-objects">18. N4JS Objects</a>
+<ul class="sectlevel2">
+<li><a href="n4js_objects.html#_reflection-model">18.1. Reflection Model</a></li>
+<li><a href="n4js_objects.html#_error-types">18.2. Error Types</a>
+<ul class="sectlevel3">
+<li><a href="n4js_objects.html#_n4apinotimplemented">18.2.1. N4ApiNotImplemented</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_acronyms.html#_acronyms">Appendix A: Acronyms</a></li>
+<li><a href="appendix_b_license.html#sec:License">Appendix B: License</a></li>
+<li><a href="appendix_c_bibliography.html#_bibliography">Appendix C: Bibliography</a></li>
+</ul>
+</div>
+</div>
+<div id="content"><div class="sect1">
+<h2 id="_components"><a class="anchor" href="#_components"></a><a class="link" href="#_components">12. Components</a></h2>
+<div class="sectionbody">
+<div class="sect2 language-n4js">
+<h3 id="_overview-2"><a class="anchor" href="#_overview-2"></a><a class="link" href="#_overview-2">12.1. Overview</a></h3>
+<div class="paragraph">
+<p>For modularization purposes, N4JS code is managed in so-called <em>components</em>. These components correspond to what
+node and npm call <em>packages</em>, what OSGi calls <em>bundle</em>, and what Eclipse calls <em>project</em>.</p>
+</div>
+<div class="paragraph">
+<p>N4JS distinguishes several types of such components. <a href="#fig-cmpd_components_in_n4js">Overview of N4JS Components (OLD)</a> shows the N4JS component types
+described in detail in this chapter. <a href="#fig-cmp_components">Overview of N4JS Components and Dependencies (NEW)</a> shows a recently updated diagram, which is not yet fully
+reflected in the implementation.</p>
+</div>
+<div id="fig-cmpd_components_in_n4js" class="imageblock" style="text-align: center">
+<div class="content">
+<img src="chapters/12_components/fig/cmpd_components_in_n4js.svg" alt="cmpd components in n4js">
+</div>
+<div class="title">Figure 10. Overview of N4JS Components (OLD)</div>
+</div>
+<div id="fig-cmp_components" class="imageblock" style="text-align: center">
+<div class="content">
+<img src="chapters/12_components/fig/cmp_components.svg" alt="cmp components">
+</div>
+<div class="title">Figure 11. Overview of N4JS Components and Dependencies (NEW)</div>
+</div>
+<div class="paragraph">
+<p>The following types of components can only be created by internal developers:</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Runtime Environment</dt>
+<dd>
+<p>Definition of a runtime environment such as ECMAScript 5, node.js, or Chrome.
+A Runtime Environment provides a number of base types which are usually globally available.
+Other components do not directly rely on runtime environments, but on runtime libraries.
+NOTE: runtime environments are not fully implemented at this time (see GH-1291).</p>
+</dd>
+<dt class="hdlist1">Runtime Library</dt>
+<dd>
+<p>Contains type definitions for the base types provided by one or more runtime environments.
+These types may be extensions to certain language specifications.
+E.g., the ECMAScript 6 collection classes are already provided by some environments otherwise only supporting ECMAScript 5.
+The collections are defined in terms of a runtime library which can then be provided by these environments.
+Runtime libraries may also contain polyfills to alter types predefined in the environment.</p>
+</dd>
+</dl>
+</div>
+<div class="paragraph">
+<p>The following components can be created by external developers:</p>
+</div>
+<div id="App" class="dlist">
+<dl>
+<dt class="hdlist1">App</dt>
+<dd>
+<p>User-written N4JS applications.</p>
+</dd>
+<dt class="hdlist1">Processor</dt>
+<dd>
+<p>User-written N4JS code running server-side on the N4 platform. Not implemented yet.</p>
+</dd>
+<dt class="hdlist1">Library</dt>
+<dd>
+<p>User-written libraries used by apps, processors, or other libraries.</p>
+</dd>
+</dl>
+</div>
+<div class="paragraph">
+<p>The available component types are described in more detail in <a href="#Component_Types">Component Types</a>.</p>
+</div>
+<div class="paragraph">
+<p>A component corresponds to a single project in the N4JS IDE. Generally, it contains the following:</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Package.json File</dt>
+<dd>
+<p>The <code>package.json</code> file describing the contents, dependencies and metadata.</p>
+</dd>
+<dt class="hdlist1">Resources</dt>
+<dd>
+<p>Resources such as images, data files etc.</p>
+</dd>
+<dt class="hdlist1">Sources</dt>
+<dd>
+<p>Source files containing either N4JS code or plain Javascript. The actual code used in a project.</p>
+</dd>
+<dt class="hdlist1">Output Code</dt>
+<dd>
+<p>Compiled and possibly adjusted (e.g. minified, concatenated) versions of the N4JS source files and
+plain Javascript files.</p>
+</dd>
+<dt class="hdlist1">Tests</dt>
+<dd>
+<p>Optional test sources and compiled output code.</p>
+</dd>
+<dt class="hdlist1">Source Maps</dt>
+<dd>
+<p>Optional source maps.</p>
+</dd>
+</dl>
+</div>
+<div class="paragraph">
+<p>Components contain modules. <a href="#fig-component_content">Content of a Component</a> describes what can be contained in a component.</p>
+</div>
+<div id="fig-component_content" class="imageblock" style="text-align: center">
+<div class="content">
+<img src="chapters/12_components/fig/cmpd_component_content.svg" alt="cmpd component content">
+</div>
+<div class="title">Figure 12. Content of a Component</div>
+</div>
+<div class="paragraph">
+<p>At both compile time and runtime, all components defined as dependency have to be available. Since dependencies
+are defined in <code>package.json</code> files in a form compliant to node/npm, this can be fully managed by npm (or yarn).</p>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="Component_Types"><a class="anchor" href="#Component_Types"></a><a class="link" href="#Component_Types">12.2. Component Types</a></h3>
+<div class="paragraph">
+<p>Different N4JS component types are described in this section.</p>
+</div>
+<div class="sect3">
+<h4 id="_libraries"><a class="anchor" href="#_libraries"></a><a class="link" href="#_libraries">12.2.1. Libraries</a></h4>
+<div class="paragraph">
+<p>A library is a user project providing modules with declaration.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_runtime-environment-and-runtime-libraries"><a class="anchor" href="#_runtime-environment-and-runtime-libraries"></a><a class="link" href="#_runtime-environment-and-runtime-libraries">12.2.2. Runtime Environment and Runtime Libraries</a></h4>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title=""></i>
+</td>
+<td class="content">
+runtime environments are not fully implemented at this time (see GH-1291).
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>Runtime environments and libraries define globally available elements (types, variables, functions) provided by the JavaScript engine.
+Both must contain <em>only</em> definition files (n4jsd) of which all elements are marked as <code>@ProvidedByRuntime</code> (<a href="plainjs.html#_runtime-definitions">Runtime Definitions</a>) and <code>@Global</code> (<a href="plainjs.html#_global-definitions">Global Definitions</a>).</p>
+</div>
+<div class="paragraph">
+<p>Other projects may refer to <em>multiple</em> runtime libraries in their <code>package.json</code> file via the property <a href="#package-json-requiredRuntimeLibraries">requiredRuntimeLibraries</a>.</p>
+</div>
+<div class="paragraph">
+<p>The concrete runtime environment and library are selected by the JavaScript engine.
+Deployment and execution scripts must ensure that a component can run on the given engine; the required environments and libraries must all be compatible with the provided environment.
+If no runtime environment is specified, a default an ECMAScript 5 runtime is assumed to be present.</p>
+</div>
+<div class="paragraph">
+<p>Typical runtime environments are ES5 or ES6, typical runtime libraries are DOM or HTML.</p>
+</div>
+<div class="paragraph">
+<p>In JavaScript, browsers and other execution environments provide built-in objects.
+In browsers, for example, the whole DOM is made available via built-in object types.
+In this case, even the global object also becomes a different type (in N4JS terms).
+Besides execution environments such as browsers or Node.js, libraries also provide functionality by exposing globally available functions.
+This is often used to bridge execution environment inconsistencies.
+When browser API differences are adapted by a library, this is called a <em>polyfil</em>.
+Other adaptations, such as enabling ECMSScript 6 object types in ECMAScript 5 environments, are known as <em>shim</em>.
+Instead of directly supporting these kind of 'hacks', other components specify which runtime environment and libraries they depend on by specifying unique runtime ids.
+Possible shims (in case of environments) or polyfils (in case of libraries) are transparently provided by the execution environment and the bootstrap code.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_tests"><a class="anchor" href="#_tests"></a><a class="link" href="#_tests">12.2.3. Tests</a></h4>
+<div class="paragraph">
+<p>Tests are special projects which contain tests for other projects.</p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-157"></a><strong>Req. IDE-157:</strong> <a href="#Req-IDE-157">Test Project</a> (ver. 1)</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Tests have full access to the tested project including elements with <code>project</code> visibility.</p>
+</li>
+<li>
+<p>Only other test projects can depend on tests project.
+In other words, other components must not depend on test components.</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>In a test project, the tested projects can be specified via <code>testee</code>.</p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_type-definitions"><a class="anchor" href="#_type-definitions"></a><a class="link" href="#_type-definitions">12.2.4. Type Definitions</a></h4>
+<div class="paragraph">
+<p>Projects of type "definition" are special projects which only provide type information for another so-called <em>implementation project</em>,  which only provides executable JS files.</p>
+</div>
+<div class="paragraph">
+<p>Generally, client projects that depend on a given <em>implementation project</em> may additionally declare a dependency on a corresponding type definitions project, in order to integrate type information on the implementation project.
+This is implemented by means of module-level shadowing.
+More specifically, given a client imports a module with module specifier <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>M</mi></math> from the implementation project.
+When resolving the module specifier, <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>M</mi></math> will first be resolved against the implementation project&#8217;s type definitions and only secondarily against the implementation project.
+As a consequence, type definition projects may only provide partial type information, while the remaining modules of the implementation project remain accessible through dynamic namespace imports.</p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-GH-821002"></a><strong>Req. GH-821002:</strong> <a href="#Req-GH-821002">Type Definition Project Configuration</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>For type definition projects, the following constraints must hold true with regard to their project configuration:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>They must declare their <em>implementation project</em> via the <a href="#package-json-definesPackage">definesPackage</a> property in their <code>package.json</code> file.</p>
+</li>
+<li>
+<p>They must not declare an output folder.</p>
+</li>
+</ol>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="package-json"><a class="anchor" href="#package-json"></a><a class="link" href="#package-json">12.3. Package.json File</a></h3>
+<div class="paragraph">
+<p>A folder is a "component" if and only if it contains a <code>package.json</code> file. Being a component means
+that this folder is recognized by all N4JS-related tools but does not necessarily mean the component
+contains N4JS code (it could just contain plain Javascript). The main benefit of being a component
+in this sense is that this unit of code can be used by other N4JS components as a dependency.</p>
+</div>
+<div class="paragraph">
+<p>For example, a plain npm project containing only plain Javascript can be a component and
+can therefore be used as a project dependency of a full-blown N4JS component.</p>
+</div>
+<div class="sect3">
+<h4 id="_basic-properties"><a class="anchor" href="#_basic-properties"></a><a class="link" href="#_basic-properties">12.3.1. Basic Properties</a></h4>
+<div class="paragraph">
+<p>The following standard <code>package.json</code> properties are used by N4JS tooling. Unless otherwise
+noted, all these properties have the exact same format and meaning as usual in <code>package.json</code>
+files.</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">name </dt>
+<dd>
+<p>Used as the globally unique identifier of the component.</p>
+</dd>
+<dt class="hdlist1">version </dt>
+<dd>
+<p>The component&#8217;s version.</p>
+</dd>
+</dl>
+</div>
+<div id="package-json-dependencies" class="dlist">
+<dl>
+<dt class="hdlist1">dependencies </dt>
+<dd>
+<p>List of components required at runtime and compile time.</p>
+</dd>
+</dl>
+</div>
+<div id="package-json-devDependencies" class="dlist">
+<dl>
+<dt class="hdlist1">devDependencies </dt>
+<dd>
+<p>List of components required at compile time only.</p>
+</dd>
+<dt class="hdlist1">main </dt>
+<dd>
+<p>Path relative to the component&#8217;s root folder, pointing to a <code>.js</code> file
+located in a source container (the <code>.js</code> file extension is optional,
+i.e. may be omitted). This file then serves as the component&#8217;s
+default entry point, i.e. project imports pointing to this component from
+other components will import from the file denoted by this property. In
+addition, this property may denote a folder and is then assumed to point
+to a file <code>index.js</code> located in that folder. If this property denotes a file
+other than a <code>.js</code> file, it will be ignored. In particular, it cannot be
+used for <code>.n4js</code> files; in that case, property "mainModule" has to be used
+(see below).</p>
+</dd>
+<dt class="hdlist1">workspaces </dt>
+<dd>
+<p>(array of strings) Property used by package management tool <code>yarn</code> to denote
+that a project serves as a "yarn workspace" and to denote the other projects
+that form the members of this yarn workspace. For details, see
+<a href="https://yarnpkg.com/lang/en/docs/workspaces">here</a>.
+In N4JS, a project is called a "yarn workspace root" if and only if its
+<code>package.json</code> file contains top-level property "workspaces", no matter the property&#8217;s
+value (i.e. it will be called "yarn workspace root" even if the value of property
+"workspaces" is the empty array or an invalid value such as a number). The nested
+projects referred to via the strings in this property&#8217;s array value are called
+"member projects" of the yarn workspace.</p>
+</dd>
+</dl>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_n4js-properties"><a class="anchor" href="#_n4js-properties"></a><a class="link" href="#_n4js-properties">12.3.2. N4JS Properties</a></h4>
+<div class="paragraph">
+<p>In addition to the standard properties above, there is a single N4JS-specific
+top-level property called "n4js". The value of this property must always be
+an object that may have any combination of the following properties:</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">projectType</dt>
+<dd>
+<p>(string) Must be one of the following strings:</p>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">application</dt>
+<dd>
+<p>An application. See <a href="#App">[App]</a>.</p>
+</dd>
+<dt class="hdlist1">library</dt>
+<dd>
+<p>A library. See <a href="#_libraries">Libraries</a>.</p>
+</dd>
+<dt class="hdlist1">processor</dt>
+<dd>
+<p>For processors running server-side on the N4 platform. Not implemented yet.</p>
+</dd>
+<dt class="hdlist1">test</dt>
+<dd>
+<p>An N4JS project containing tests for one or more other N4JS projects specified
+via property "testedProjects".</p>
+</dd>
+<dt class="hdlist1">api</dt>
+<dd>
+<p>For N4JS projects that contain only API (in <code>.n4jsd</code> files) to be implemented by other,
+so-called implementation projects. See properties "implementationId", "implementedProjects".
+NOTE: the API/Implementation concept is not fully implemented at this time (see GH-1291).</p>
+</dd>
+<dt class="hdlist1">runtimeEnvironment</dt>
+<dd>
+<p>Runtime environments. See <a href="#Runtime Environment Resolution">[Runtime Environment Resolution]</a>.
+NOTE: runtime environments are not fully implemented at this time (see GH-1291).</p>
+</dd>
+<dt class="hdlist1">runtimeLibrary</dt>
+<dd>
+<p>Runtime libraries. See <a href="#_runtime-environment-and-runtime-libraries">Runtime Environment and Runtime Libraries</a>.</p>
+</dd>
+<dt class="hdlist1">validation</dt>
+<dd>
+<p>A project in which <code>.n4js</code> files are only being validated, not transpiled. This is used for projects
+that are implemented in terms of <code>.js</code> files but that also provide type information in terms of <code>.n4jsd</code> files.</p>
+</dd>
+<dt class="hdlist1">plainjs</dt>
+<dd>
+<p>A project which only contains <code>.js</code> files and no N4JS resources. The contained JS files are only indexed to allow
+for dynamic imports of specific JavaScript modules. Projects of this type are not being transpiled.</p>
+</dd>
+</dl>
+</div>
+</dd>
+<dt class="hdlist1">vendorId</dt>
+<dd>
+<p>(string) Globally unique identifier for the component&#8217;s vendor.
+Used for the <code>@Internal</code> accessibility modifier.</p>
+</dd>
+<dt class="hdlist1">vendorName</dt>
+<dd>
+<p>(string) Human-readable name of the component&#8217;s vendor. Used only for informational
+purposes.</p>
+</dd>
+<dt class="hdlist1">output</dt>
+<dd>
+<p>(string) Path relative to the component&#8217;s root folder, pointing to a folder where
+all output files will be placed. In particular, this is where the N4JS transpiler
+will put the <code>.js</code> files created for each <code>.n4js</code> file.</p>
+</dd>
+<dt class="hdlist1">sources</dt>
+<dd>
+<p>(object) Defines various sub-folders where sources, etc. are located. All properties
+of the given object must have the following format: the name must be "source", "external",
+or "test"; the value must be an array of strings, with each string defining a
+path relative to the component&#8217;s root folder, pointing to a folder where
+source files of the corresponding type are located. For example, paths given via name
+"source" tell the N4JS transpiler where to look for <code>.n4js</code> source files to be compiled.</p>
+</dd>
+<dt class="hdlist1">moduleFilters</dt>
+<dd>
+<p>(object) Filters for fine-tuning the validator and compiler. A filter is applied to modules
+matching the given module specifier which may contain wildcards, optionally restricted to
+modules defined in a specific source path.</p>
+<div class="paragraph">
+<p>All properties of the given object must have the following format: the name must be a valid
+module filter type (see below); the value must be an array of strings, with each string
+defining a pattern of files inside one of the source containers for which validation or
+module wrapping is to be turned off. Instead of a plain string, the inner array may
+contain an object with properties "module" and "sourceContainer" to make this filter apply
+to only one of the source containers (instead of all source containers, which is the default).</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">noValidate</dt>
+<dd>
+<p>Modules matching this filter are not semantically validated.
+That is, they are still syntactically validated.
+If they are contained in source or test source fragments, it must be possible to bind references
+to declarations inside these modules.
+Note that switching off validation for n4js files is disallowed.</p>
+</dd>
+</dl>
+</div>
+</dd>
+</dl>
+</div>
+<div class="exampleblock">
+<div class="title">Example 102. Module Filters</div>
+<div class="content">
+<div class="paragraph">
+<p>A simple and a source-container-specific module filter in the <code>n4js</code> section of a package.json file.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-json" data-lang="json">"moduleFilters": {
+	"noValidate": [
+		"abc*",
+		{
+			"module": "xyz*",
+			"sourceContainer": "src/n4js"
+		}
+	]
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div id="package-json-mainModule" class="dlist">
+<dl>
+<dt class="hdlist1">mainModule</dt>
+<dd>
+<p>(string) A plain module specifier defining the project’s 'main module'.
+If this property is defined, other projects can import from this project using imports where the string following
+keyword <code>from</code> states only the project name and not the complete module specifier (see <a href="statements.html#import-statement-semantics">Import Statement Semantics</a>).
+If this property is defined, top-level property <code>main</code> will be ignored.</p>
+</dd>
+<dt class="hdlist1">testedProjects</dt>
+<dd>
+<p>  (array) List of N4JS components being tested by this project.
+ <br>
+Only components of project type "test" may declare this property. Furthermore, the referenced
+projects must all be of the same project type and must not be of type "test" themselves.</p>
+</dd>
+</dl>
+</div>
+<div id="package-json-implementationId" class="dlist">
+<dl>
+<dt class="hdlist1">implementationId</dt>
+<dd>
+<p>(string) If this property is defined, this component is called an "implementation project" and the string value
+  provides a unique identifier for the implementation provided in this component. If this is defined, property
+  "implementedProjects" must be defined as well. For details, see <a href="#API and Implementation Components">[API and Implementation Components]</a>.</p>
+<div class="paragraph">
+<p>Only projects of type "application", "processor", "library", "api" or "validation" may declare this property.</p>
+</div>
+</dd>
+</dl>
+</div>
+<div id="package-json-implementedProjects" class="dlist">
+<dl>
+<dt class="hdlist1">implementedProjects</dt>
+<dd>
+<p>(array) A list of API components (components of type "api") that are implemented by this component. If this
+is defined, property "implementationId" must be defined as well. For details, see
+<a href="#API and Implementation Components">[API and Implementation Components]</a>. Only components of type  "application", "processor", "library", "api"
+or "validation" may declare this property.</p>
+</dd>
+</dl>
+</div>
+<div id="package-json-requiredRuntimeLibraries" class="dlist">
+<dl>
+<dt class="hdlist1">requiredRuntimeLibraries</dt>
+<dd>
+<p>(array) The list of required runtime library components that are required for the execution of this
+ component. All components but components of type "runtime environment" may declare this property. Each
+ required runtime library must also be specified as a dependency using one of the top-level
+ properties <code>dependencies</code> or <code>devDependencies</code>.</p>
+</dd>
+<dt class="hdlist1">extendedRuntimeEnvironment</dt>
+<dd>
+<p>(string) The name of the runtime environment project that is extended by this component. Only components of
+type "runtime environment" may declare this property.</p>
+</dd>
+<dt class="hdlist1">providedRuntimeLibraries</dt>
+<dd>
+<p>(array) The list of runtime library components that are provided by this component. Only components of
+type "runtime environment" may declare this property.</p>
+</dd>
+</dl>
+</div>
+<div id="package-json-definesPackage" class="dlist">
+<dl>
+<dt class="hdlist1">definesPackage</dt>
+<dd>
+<p>(string) The name of the package this component provides type definitions for. Only components of project type "definition" may declare this property.</p>
+</dd>
+</dl>
+</div>
+<div class="paragraph">
+<p>All properties described above are optional. The following default values apply:</p>
+</div>
+<table class="tableblock frame-all grid-all spread">
+<colgroup>
+<col style="width: 50%;">
+<col style="width: 50%;">
+</colgroup>
+<tbody>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Property</strong></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Default Value</strong></p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">name</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">name of the folder containing the <code>package.json</code> file</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">version</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">"0.0.1"</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">projectType</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">"plainjs"</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">vendorId</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">"vendor.default"</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">mainModule</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">"index"</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">output</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">"."</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">sources</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">a single source-container of type "source" with path "." (except for yarn workspace roots, see below)</p></td>
+</tr>
+</tbody>
+</table>
+<div class="paragraph">
+<p>All other properties are undefined if not given in the <code>package.json</code> file. The default source folder of "." does not
+apply to projects that represent the root folder of a yarn workspace; those projects do not have any source folder,
+by default.</p>
+</div>
+<div class="exampleblock">
+<div class="title">Example 103. A package.json file with N4JS-specific properties.</div>
+<div class="content">
+<div class="paragraph">
+<p>The following example illustrates how to use the N4JS-related package.json properties.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code>{
+	"name": "SampleProject",
+	"version": "0.0.1",
+	"author": "Enfore AG",
+	"main": "./src/js/main.js",
+	"dependencies": {
+		"OtherProject": "&gt;=1.2.3 &lt;2.0.0",
+		"n4js-runtime-es2015": "latest"
+	},
+	"devDependencies": {
+		"org.eclipse.n4js.mangelhaft": "latest"
+	},
+	"n4js": {
+		"projectType": "library",
+		"vendorId": "org.eclipse.n4js",
+		"vendorName": "Eclipse N4JS Project",
+		"output": "src-gen",
+		"mainModule": "a/b/Main",
+		"sources": {
+			"source": [
+				"src/n4js",
+				"src/n4js-gen"
+			],
+			"external": [
+				"src-ext"
+			],
+			"test": [
+				"src-test"
+			]
+		},
+		"moduleFilters": {
+			"noValidate": [
+				"abc*",
+				{
+					"module": "xyz*",
+					"sourceContainer": "src/n4js"
+				}
+			]
+		},
+		"requiredRuntimeLibraries": [
+			"n4js-runtime-es2015"
+		]
+	}
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_constraints"><a class="anchor" href="#_constraints"></a><a class="link" href="#_constraints">12.3.3. Constraints</a></h4>
+<div class="paragraph">
+<p>The following constraints apply.</p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-158"></a><strong>Req. IDE-158:</strong> <a href="#Req-IDE-158">GeneralConstraints</a> (ver. 1)</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>There must be an output directory specified so the compiler(s) can run.</p>
+</li>
+</ol>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-159"></a><strong>Req. IDE-159:</strong> <a href="#Req-IDE-159">Paths</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>Paths Paths are constrained in the following way:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>A path cannot appear more than one time within a source fragment type (same applies to paths in the resources section).</p>
+</li>
+<li>
+<p>A path cannot be used in different source fragment types at same times.</p>
+</li>
+<li>
+<p>A path can only be declared exclusively in one of the sections Output, Libraries, Resources or Sources.</p>
+</li>
+<li>
+<p>A path must not contain wild cards.</p>
+</li>
+<li>
+<p>A path has to be relative to the project path.</p>
+</li>
+<li>
+<p>A path has to point to folder.</p>
+</li>
+<li>
+<p>The folder a defined path points to must exist in the project (but in case of non-existent folders of source fragments, only a warning is shown).</p>
+</li>
+</ol>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-160"></a><strong>Req. IDE-160:</strong> <a href="#Req-IDE-160">Module Specifiers</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>Module Specifiers are constrained in the following
+way:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Within a module filter type no duplicate specifiers are allowed.</p>
+</li>
+<li>
+<p>A module specifier is by default applied relatively to all defined source containers, i.e. if there src and src2 defined as source containers in both folders files are looked up that matches the given module specifier</p>
+</li>
+<li>
+<p>A module specifier can be constrained to be applied only to a certain source container.</p>
+</li>
+<li>
+<p>A module specifier is allowed to contain wildcards but it must resolve to some existing files in the project</p>
+</li>
+</ol>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-161"></a><strong>Req. IDE-161:</strong> <a href="#Req-IDE-161">Module Specifier Wildcard Constraints</a> (ver. 1)</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>All path patterns are case sensitive.</p>
+</li>
+<li>
+<p><code>**</code> all module specifiers will be matched.</p>
+</li>
+<li>
+<p><code>**/*</code> all module specifiers will be matched.</p>
+</li>
+<li>
+<p><code>test/A??</code> matches all module specifiers whose qualified name consists of two segments where the first part matches test and the second part starts with an <code>A</code> and then two more characters.</p>
+</li>
+<li>
+<p><code>**/test/**/XYZ</code> - matches all module specifiers whose qualified name contains a segment that matches test and the last segment ends with an ’XYZ’.</p>
+</li>
+<li>
+<p>A module specifier wild card isn’t allowed to contain <code>***</code>.</p>
+</li>
+<li>
+<p>A module specifier wild card isn’t allowed to contain relative navigation.</p>
+</li>
+<li>
+<p>A module specifier wild card shouldn’t contain the file extension (only state the file name (pattern) without extension, valid file extensions will then be used to match the file).</p>
+</li>
+</ol>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Examples of using external source fragments and filters are given in <a href="plainjs.html#_implementation-of-external-declarations">Implementation of External Declarations</a>, see <a href="plainjs.html#external-definitions-and-implementations">External Definitions and Their Implementations</a>.</p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-GH-821001"></a><strong>Req. GH-821001:</strong> <a href="#Req-GH-821001">Dependencies to Definition Projects</a> (ver. 1)</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>For each listed project dependency of type "definition", a corresponding dependency (in the (dev)dependencies section) must be declared, whose "name" matches the "definesPackage" property value of the definition project.</p>
+</li>
+</ol>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="_support-for-npm-scopes"><a class="anchor" href="#_support-for-npm-scopes"></a><a class="link" href="#_support-for-npm-scopes">12.4. Support for NPM Scopes</a></h3>
+<div class="paragraph">
+<p>NPM supports a namespace concept for npm packages. Such namespaces are called "scopes". For details see
+<a href="https://docs.npmjs.com/misc/scope" class="bare">https://docs.npmjs.com/misc/scope</a> and <a href="https://docs.npmjs.com/getting-started/scoped-packages" class="bare">https://docs.npmjs.com/getting-started/scoped-packages</a>.
+In N4JS, this is supported too.</p>
+</div>
+<div class="paragraph">
+<p>Terminology:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>A project&#8217;s <em>plain project name</em> is its name without mentioning the project&#8217;s scope (if any),
+e.g. <code>myProject</code>.</p>
+</li>
+<li>
+<p>A project&#8217;s <em>scope name</em> is the name of the npm scope a project resides in, including a leading <code>@</code>.
+E.g. <code>@myScope</code>.</p>
+</li>
+<li>
+<p>A project&#8217;s <em>N4JS project name</em> is its plain project name, prefixed by its scope name (if any),
+separated by a <code>/</code>. For unscoped projects, this is identical to the plain project name.
+E.g., <code>myProject</code> (if unscoped), <code>@myScope/myProject</code> (if scoped).</p>
+</li>
+<li>
+<p>A project&#8217;s <em>Eclipse project name</em> is an ancillary name used only within the Eclipse UI for
+the project in the workspace. It is equal to the N4JS project name, except that <code>:</code> instead of <code>/</code> is
+used as separator between the scope and plain project name.
+E.g., <code>myProject</code> (if unscoped), <code>@myScope:myProject</code> (if scoped).</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>In case the intended meaning is apparent from the context, the "N4JS project name" can simply be referred to
+as "project name" (as is common practice in the context of npm).</p>
+</div>
+<div class="paragraph">
+<p>In N4JS, when importing from a module <code>M</code> contained in a scoped project <code>@myScope/myProject</code>, the import statement&#8217;s
+module specifier should have one of the following forms:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>import * as N from "a/b/c/M";</code></p>
+</li>
+<li>
+<p><code>import * as N from "@myScope/myProject/a/b/c/M";</code></p>
+</li>
+<li>
+<p><code>import * as N from "@myScope/myProject";</code> (if <code>M</code> is specified as main module in `myProject&#8217;s package.json)</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Thus, the N4JS project name, which includes the scope name, is simply used in place of an ordinary, non-scoped
+project&#8217;s name. This is in line with conventions in Javascript.</p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-GH-1026"></a><strong>Req. GH-1026:</strong> <a href="#Req-GH-1026">General Constraints</a> (ver. 1)</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>The name given in the package.json file (i.e. value of top-level property "name") must be equal to
+the project&#8217;s "N4JS project name", as defined above.</p>
+</li>
+<li>
+<p>The name of the project folder on disk (i.e. folder containing the package.json file) must be equal to
+the project&#8217;s "plain project name", as defined above.</p>
+</li>
+<li>
+<p>Iff the project is scoped, this project folder must have a parent folder with a name equal to
+the project&#8217;s "scope name", including the leading <code>@</code>.</p>
+</li>
+<li>
+<p>Within Eclipse, the name of of an N4JS project in the workspace UI must be equal to the project&#8217;s
+"Eclipse project name", as defined above.</p>
+</li>
+</ol>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="sec:N4JS-Type-Definitions"><a class="anchor" href="#sec:N4JS-Type-Definitions"></a><a class="link" href="#sec:N4JS-Type-Definitions">12.5. N4JS Type Definitions</a></h3>
+<div class="paragraph">
+<p>N4JS projects can depend on ordinary JavaScript projects by including them in the package.json file.
+From there on, modules of those JavaScript projects can be imported when writing N4JS code.
+However, since JavaScript is untyped there will not be any type information for e.g. classes, functions
+of ordinary JavaScript projects unless this type information is provided by a type definition project.
+Type definition projects do only contain n4jsd files that reflect the classes and functions of a specific npm.
+To refer to a JavaScript npm, the term <em>plain-JS project</em> will be used.</p>
+</div>
+<div class="sect3">
+<h4 id="_specify-type-definition"><a class="anchor" href="#_specify-type-definition"></a><a class="link" href="#_specify-type-definition">12.5.1. Specify Type Definition</a></h4>
+<div class="paragraph">
+<p>A type definition project is structured like a normal npm.
+The major difference is that it provides n4jsd files instead of js files.
+These n4jsd files are named like and located at the exact position in the file tree as their js-counterparts.
+This ensures the type definition module and the corresponding plain-JS module to have the same fully-qualified name.
+Besides the usual properties the package.json file usually needs to specify the following properties in the n4js section.</p>
+</div>
+<div class="listingblock">
+<div class="title">Package.json: Important properties for type definition projects</div>
+<div class="content">
+<pre class="highlight"><code>{
+	"n4js": {
+		"projectType": "definition"
+		"definesPackage": "..."
+		"mainModule": "..."
+	}
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>The project type declares this project to be a type definition projects.
+Consequently, it has to also declare the name for which plain-JS project its type definitions are provided (using <code>definesPackage</code>).
+Lastly, the main module has to be specified since this information will not be taken from the package.json of the plain-JS project.</p>
+</div>
+<div class="paragraph">
+<p>A type definition project may only define a main module if the corresponding plain-JS project defines a main module. In this case,
+the main module of the type definition project may have a different fully-qualified name / module specifier (but should, of course,
+define the types provided by the plain-JS project&#8217;s main module). This is possible, because in client code the import of a main
+module will always look the same, no matter the main module&#8217;s fully-qualified name / module specifier.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_name-conventions"><a class="anchor" href="#_name-conventions"></a><a class="link" href="#_name-conventions">12.5.2. Name Conventions</a></h4>
+<div class="paragraph">
+<p>A type definition package can have an arbitrary name and define an arbitrary npm package.
+This can be handy for testing purposes or just creating some temporary type definitions for a local package.
+However, we chose to use a convention to simplify finding the right type definition package for a specific plain-JS project.
+First, the scope <code>@n4jsd</code> and second the exact name of the plain-JS project is used.
+For instance, when a user wants to install type definitions for the plain-JS project <code>express</code>,
+our related type definitions are called <code>@n4jsd/express</code>.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_version-conventions"><a class="anchor" href="#_version-conventions"></a><a class="link" href="#_version-conventions">12.5.3. Version Conventions</a></h4>
+<div class="paragraph">
+<p>Since the plain-JS project will evolve over time and publish different versions, the need arises to also
+publish the type definition project in different versions that reflect this evolution.
+In addition to the evolution of the plain-JS project, a new version of the type definition project can
+also become necessary in case a bug in the type definitions was found or in case the language of N4JS changes
+and the type definitions have to be adjusted accordingly.
+Effectively, this will lead to a situation where both the implementation and the type definition project have
+a version that are technically unrelated from an npm point of view, but still are somehow related to each other
+from a semantical point of view.
+To keep the distinct versioning of both of the projects manageable,
+we propose the following conventions to partially align the type definition project&#8217;s version to that of the plain-JS project.</p>
+</div>
+<div class="sect4">
+<h5 id="_define-a-new-type-definition-package"><a class="anchor" href="#_define-a-new-type-definition-package"></a><a class="link" href="#_define-a-new-type-definition-package">12.5.3.1. Define a New Type Definition Package</a></h5>
+<div class="paragraph">
+<p>We use the following convention to compute the version of type definition packages.</p>
+</div>
+<div class="openblock">
+<div class="title">Convention for initial type definition versions</div>
+<div class="content">
+<div class="paragraph">
+<p>&#160;&#160;&#160;&#160; Major<sub>types</sub>.Minor<sub>types</sub>.Patch<sub>types</sub> = Major<sub>impl</sub>.Minor<sub>impl</sub>.0</p>
+</div>
+</div>
+</div>
+<div class="openblock">
+<div class="title">Example for initial type definition of express@3.3.3</div>
+<div class="content">
+<div class="paragraph">
+<p>&#160;&#160;&#160;&#160; Major<sub>types</sub>.Minor<sub>types</sub>.Patch<sub>types</sub> = 3.3.0</p>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Let&#8217;s say that a new version of a type definition package called <em>types</em> should be created
+that defines types for an npm called <em>impl</em> of version Major<sub>impl</sub>.Minor<sub>impl</sub>.Patch<sub>impl</sub>.
+According to our convention, the major and minor version numbers of the type definition package
+should just be copied from the version of the <em>impl</em> package.
+However, the version patch number of <em>types</em> should not be taken from <em>impl</em>.
+Instead, the patch number of <em>types</em> starts with <em>0</em> and increases with every update of this type definition version.
+For instance when a bug was found in version Major<sub>types</sub>.Minor<sub>types</sub>.0, the definitions have been extended, or
+adjusted to new language features, only the patch number increases to e.g. Major<sub>types</sub>.Minor<sub>types</sub>.1.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_using-a-type-definition-package"><a class="anchor" href="#_using-a-type-definition-package"></a><a class="link" href="#_using-a-type-definition-package">12.5.3.2. Using a Type Definition Package</a></h5>
+<div class="paragraph">
+<p>On the client side, a type definition package is listed among the dependency section.
+Here we use the following convention to specify the required version of a type definition package.</p>
+</div>
+<div class="openblock">
+<div class="title">Convention for dependencies</div>
+<div class="content">
+<div class="paragraph">
+<p>"dependencies": {<br>
+&#160;&#160;&#160;&#160; "@n4jsd/Types": "&lt;=Major<sub>impl</sub>.Minor<sub>impl</sub>.*"<br>
+}</p>
+</div>
+</div>
+</div>
+<div class="openblock">
+<div class="title">Example of dependencies to express and its type definition project</div>
+<div class="content">
+<div class="paragraph">
+<p>"dependencies": {<br>
+&#160;&#160;&#160;&#160; "express": "^3.3.3",<br>
+&#160;&#160;&#160;&#160; "@n4jsd/express": "&lt;=3.3.*"<br>
+}</p>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>According to this convention, the major and minor version numbers of the implementation package are used,
+prepended with a smaller-equals and appended with an asterisk for the patch number.
+This also applies when the implementation version contains a tilde, a caret, etc., or is omitting a minor or patch number.
+In case a non SemVer version is given (e.g. <code>latest</code>, empty string, url, etc.)
+it is recommended to plain copy the non SemVer version when possible.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_rational"><a class="anchor" href="#_rational"></a><a class="link" href="#_rational">12.5.3.3. Rational</a></h5>
+<div class="paragraph">
+<p>The rational behind this convention reflects the idea of semantic versioning:</p>
+</div>
+<div class="quoteblock">
+<blockquote>
+<div class="paragraph">
+<p>Given a version number MAJOR.MINOR.PATCH, increment the:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>MAJOR version when you make incompatible API changes,</p>
+</li>
+<li>
+<p>MINOR version when you add functionality in a backwards-compatible manner, and</p>
+</li>
+<li>
+<p>PATCH version when you make backwards-compatible bug fixes.</p>
+</li>
+</ul>
+</div>
+</blockquote>
+<div class="attribution">
+&#8212; <a href="https://www.semver.org">semver.org</a>
+</div>
+</div>
+<div class="paragraph">
+<p>Patch version increments are always backwards compatible according to SemVer.
+In addition also no further functionality is added since this would imply at least an increment of the minor version.
+Consequently, patch versions do not affect the interface or type information of an plain-JS project.
+This is why patch version number fully suffices to reflect bug fixes and language changes for a given major.minor version.</p>
+</div>
+<div class="paragraph">
+<p>On client side, we recommend to use a smaller-equals qualifier because most probably there will not be the exact version
+of a requested type definition project.
+Instead, only some major.minor versions will have a type definition counterpart.
+Using a smaller-equals qualifier will make sure that a client will always get the latest version of a requested plain-JS project version.
+In case a newer version of the plain-JS project was already published,
+this convention guarantees that a compatible version of the type definition project is installed.</p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="_modules"><a class="anchor" href="#_modules"></a><a class="link" href="#_modules">12.6. Modules</a></h3>
+<div class="paragraph">
+<p>Each N4JS source file defines a module in the sense of ECMAScript2015, [<a href="appendix_c_bibliography.html#ECMA15a">ECMA15a(p.S14)</a>].
+This is the overall structure of a module, based on [<a href="appendix_c_bibliography.html#ECMA15a">ECMA15a(p.S14)</a>].</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">Script: {Script}
+    annotations+=ScriptAnnotation*
+    scriptElements+=ScriptElement*;
+
+/*
+ * The top level elements in a script are type declarations, exports, imports or statements
+ */
+ScriptElement:
+      AnnotatedScriptElement
+    | N4ClassDeclaration&lt;Yield=false&gt;
+    | N4InterfaceDeclaration&lt;Yield=false&gt;
+    | N4EnumDeclaration&lt;Yield=false&gt;
+    | ImportDeclaration
+    | ExportDeclaration
+    | RootStatement&lt;Yield=false&gt;
+;</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Grammar and semantics of import statement is described in <a href="statements.html#_import-statement">Import Statement</a>; of export statement described in <a href="statements.html#_export-statement">Export Statement</a>.</p>
+</div>
+<div class="paragraph">
+<p>An import statement imports a variable declaration, function declaration, or N4 type declaration defined and exported by another module into the current
+module under the given alias (which is similar to the original name if no alias is defined).
+The name of the module is its project’s source folder’s relative path without any extension, see <a href="names.html#_qualified-names">Qualified Names</a> for details.</p>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="_api-and-implementation-component"><a class="anchor" href="#_api-and-implementation-component"></a><a class="link" href="#_api-and-implementation-component">12.7. API and Implementation Component</a></h3>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title=""></i>
+</td>
+<td class="content">
+the API/Implementation concept is not fully implemented at this time (see GH-1291).
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>Instead of providing an implementation, N4JS components may only define an API by way of one or more n4jsd files which is then implemented by separate implementation projects.
+For one such API project, several implementation projects may be provided.
+Client code using the API will always be bound to the API project only, i.e. only the API project will appear in the client project’s <code>package.json</code> file under <code>dependencies</code>.
+When launching the client code, the launcher will choose an appropriate implementation for each API project in the client code’s direct or indirect dependencies
+and transparently replace the API project by the implementation project.
+In other words, instead of the API project’s output folder, the implementation project’s output folder will be put on the class path.
+Static compile time validations ensure that the implementation projects comply to their corresponding API project.</p>
+</div>
+<div class="paragraph">
+<p>Note how this concept can be seen as an alternative way of providing the implementation for an n4jsd file: usually n4jsd files are used to define types
+that are implemented in plain JavaScript code or provided by the runtime; this concept allows for providing the implementation of an n4jsd file in form of ordinary N4JS code.</p>
+</div>
+<div class="paragraph">
+<p>At this time, the concept of API and implementation components is in a prototype phase and the tool support is limited.
+The goal is to gain experience from using the early prototype support and then refine the concept over time.</p>
+</div>
+<div class="paragraph">
+<p>Here is a summary of the most important details of this concept (they
+are all subject to discussion and change):</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Support for this concept, esp. validations, should not be built into the core language but rather implemented as a separate validation/analysis tool.</p>
+</li>
+<li>
+<p>Validation is currently provided in the form of a separate view: the API / Implementation compare view.</p>
+</li>
+<li>
+<p>A project that defines one or more other projects in its <code>package.json</code> file under <code>implementedProjects</code> (cf. <a href="#package-json-implementedProjects">implementedProjects</a>) is called <em>implementation project</em>.
+A project that has another project pointing to itself via <code>ImplementedProjects</code> is called <em>API project</em>.
+Note that, at the moment, there is no explicit definition making a project an API project.</p>
+</li>
+<li>
+<p>An implementation project must define an implementation ID in its <code>package.json</code> file using the <code>implementationId</code> property in the <code>n4js</code> section (cf. <a href="#package-json-implementationId">implementationId</a>).</p>
+</li>
+<li>
+<p>For each public or public@Internal classifier or enum in an API project, there must be a corresponding type with the same fully-qualified name of the same or higher visibility in the  implementation project.
+For each member of such a type in the API, there must exist a corresponding, owned <em>or</em> inherited type-compatible member in the implementation type.</p>
+</li>
+<li>
+<p>Beyond type compatibility, formal parameters should have the same name on API and implementation side; however, different names are legal but should be highlighted by API / Implementation tool support as a (legal) change.</p>
+</li>
+<li>
+<p>Comments regarding the state of the API or implementation may be added to the JSDoc in the source code using the special tag @apiNote.
+API / Implementation tool support should extract and present this information to the user in an appropriate form.</p>
+</li>
+<li>
+<p>If an API class <code>C</code> implements an interface <code>I</code>, it has to explicitly (re-) declare all members of <code>I</code> similar to the implementation.
+This is necessary for abstract classes anyway in order to distinguish the implemented methods from the non-implemented ones.
+For concrete classes, we want all members in <code>C</code> in order to be complete and avoid problems when the interface is changed or <code>C</code> is made abstract.</p>
+</li>
+</ul>
+</div>
+<div class="sect3">
+<h4 id="_execution-of-api-and-implementation-components"><a class="anchor" href="#_execution-of-api-and-implementation-components"></a><a class="link" href="#_execution-of-api-and-implementation-components">12.7.1. Execution of API and Implementation Components</a></h4>
+<div class="paragraph">
+<p>When launching an N4JS component <em>C</em> under runtime environment <a href="appendix_a_acronyms.html#AC">RE</a>, the user may(!) provide an implementation ID <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>I</mi><mspace width="-0.167em"/><mi>I</mi><mspace width="-0.167em"/><mi>D</mi></math> to run.
+Then, for each API project <em>A</em> in the direct or indirect dependencies of <em>C</em> an implementation project is chosen as follows:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Collect all implementation projects for <em>A</em> (i.e. projects that specify <em>A</em> in their <code>package.json</code> file under <code>implementedProjects</code>).</p>
+</li>
+<li>
+<p>Remove implementation projects that cannot be run under runtime environment <a href="appendix_a_acronyms.html#AC">RE</a>, using the same logic as for running ordinary N4JS components (this step is not implemented yet!).</p>
+</li>
+<li>
+<p>If there are no implementation projects left, show an error.</p>
+</li>
+<li>
+<p>If <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>I</mi><mspace width="-0.167em"/><mi>I</mi><mspace width="-0.167em"/><mi>D</mi></math> is defined (i.e. user specified an implementation ID to run), then:</p>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p>If there is an implementation project left with implementation ID <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>I</mi><mspace width="-0.167em"/><mi>I</mi><mspace width="-0.167em"/><mi>D</mi></math>, use that.</p>
+</li>
+<li>
+<p>Otherwise, show an error.</p>
+</li>
+</ol>
+</div>
+</li>
+<li>
+<p>If <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>I</mi><mspace width="-0.167em"/><mi>I</mi><mspace width="-0.167em"/><mi>D</mi></math> is undefined, then</p>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p>If there is exactly 1 implementation project left, use it.</p>
+</li>
+<li>
+<p>Otherwise, in UI mode prompt the user for a choice, in headless mode  how an error.</p>
+</li>
+</ol>
+</div>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>Having found an implementation project <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>I</mi><mi>n</mi></msub></math> for each API project <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>A</mi><mi>n</mi></msub></math>, launch as usual except that whenever <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>A</mi><mi>n</mi></msub></math>’s output folder would be used, use <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>I</mi><mi>n</mi></msub></math>’s
+output folder (esp. when constructing a <code>class path</code>) and when loading or importing a type from <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>A</mi><mi>n</mi></msub></math> return the corresponding type with the same fully-qualified name from <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>I</mi><mi>n</mi></msub></math>.</p>
+</div>
+</div>
+<div class="sect3 language-n4js">
+<h4 id="_api-and-implementation-with-di"><a class="anchor" href="#_api-and-implementation-with-di"></a><a class="link" href="#_api-and-implementation-with-di">12.7.2. API and Implementation With DI</a></h4>
+<div class="paragraph">
+<p>API projects may use N4JS DI (<a href="extended_fetaures.html#_dependency-injection">Dependency Injection</a>) language features which require Implementation projects to provide DI-compatible behaviour
+in order to allow a Client (implemented against an API project) to be executed with a given Implementation project.
+This is essential for normal execution and for test execution.</p>
+</div>
+<div class="paragraph">
+<p><a href="#diag_APITestsDI_Overview">Overview of API tests with DI</a> shows some of those considerations from test client point of view.</p>
+</div>
+<div id="diag_APITestsDI_Overview" class="imageblock">
+<div class="content">
+<img src="chapters/12_components/fig/diag_ApiTestsDI_Overview.svg" alt="diag ApiTestsDI Overview">
+</div>
+<div class="title">Figure 13. Overview of API tests with DI</div>
+</div>
+<div class="paragraph">
+<p>Static DI mechanisms in N4JS allow an API project to enforce Implementation projects to provide all necessary information.
+This allows clients to work seamlessly with various implementations without specific knowledge about them or without relying on extra tools for proper project wiring.</p>
+</div>
+<div class="paragraph">
+<p><a href="#diag_ApiTestsDI_StaticDI">API tests with static DI</a> shows how API project defines project wiring and enforces certain level of testability.</p>
+</div>
+<div id="diag_ApiTestsDI_StaticDI" class="imageblock">
+<div class="content">
+<img src="chapters/12_components/fig/diag_ApiTestsDI_StaticDI.svg" alt="diag ApiTestsDI StaticDI">
+</div>
+<div class="title">Figure 14. API tests with static DI</div>
+</div>
+<div class="paragraph">
+<p>During Client execution, weather it is test execution or not, N4JS mechanisms will replace the API project with a proper Implementation project.
+During runtime DI mechanisms will take care of providing proper instances of implantation types.</p>
+</div>
+<div class="paragraph">
+<p><a href="#diag_ApiTestsDI_Views">Types view and Instances view</a> shows Types View perspective of the client, and Instances View perspective of the client.</p>
+</div>
+<div id="diag_ApiTestsDI_Views" class="imageblock" style="text-align: center">
+<div class="content">
+<img src="chapters/12_components/fig/diag_ApiTestsDI_Views.svg" alt="diag ApiTestsDI Views">
+</div>
+<div class="title">Figure 15. Types view and Instances view</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div id="footer">
+<div id="footer-text">
+Version 0.9<br>
+Last updated 2019-08-07 15:02:40 CEST
+</div>
+</div>
+<!-- ************* docinfo-footer *************************************************************** -->
+<div class="Grid social" style="color:#d5dfea">
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <h2>Quick Links</h2>
+    <ul>
+      <li><a href="../downloads.html">Download</a></li>
+      <li><a href="../userguides/index.html">Documentation</a></li>
+      <li><a href="https://github.com/eclipse/n4js/">Source</a></li>
+      <li><a href="https://github.com/eclipse/n4js/issues">Issues</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="https://www.eclipse.org/forums/index.php/f/365/">Forum</a></li>
+      <li><a href="http://n4js.blogspot.de/">Blog</a></li>
+      <li><a href="https://dev.eclipse.org/mailman/listinfo/n4js-dev">Mailing List</a></li>
+      <li><a href="https://projects.eclipse.org/projects/technology.n4js">Eclipse Project Page</a></li>
+      <li><a href="https://twitter.com/n4jsdev">Tweets by n4jsdev</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="http://www.eclipse.org/">Eclipse Home</a></li>
+      <li><a href="http://www.eclipse.org/legal/privacy.php">Privacy Policy</a></li>
+      <li><a href="http://www.eclipse.org/legal/termsofuse.php">Terms of Use</a></li>
+      <li><a href="http://www.eclipse.org/legal/copyright.php">Copyright Agent</a></li>
+      <li><a href="http://www.eclipse.org/legal/">Legal</a></li>
+    </ul>
+  </div>
+  <div style="clear: both; height: 0; overflow: hidden;"></div>
+</div>
+
+<!-- ************* UI Scripts ************* -->
+<script type="text/javascript" src="scripts/back-to-top.js"></script>
+
+<script type="text/javascript" src="scripts/treeview.js"></script>
+<script type="text/javascript" src="scripts/toc.js"></script>
+
+<!-- ************* Prism.js Syntax Highlighting ************* -->
+<script src="scripts/prism.js"></script>
+
+<script type="text/javascript">
+	// Add the 'toclist' id for search function
+	$(".toc2 > ul").attr('id', 'toclist');
+	// Generate a Search input form
+	$("#toclist > li:first-of-type").before('<input type="text" id="pagesearch" onkeyup="search()" placeholder="Search for section...">');
+	$("#toclist > li:first-of-type").before('<i id="clear" class="fa fa-times-circle-o"></i>');
+	$("#clear").click(function(){
+	    $("#pagesearch").val('');
+	    search();
+	    $('.toc2 > ul').treeView('collapseAll');
+	});
+	// intialize Treeview.js
+	$(".toc2 > ul").treeView();
+	// Initialize Scrollspy
+</script>
+<!-- ************* docinfo-footer *************************************************************** -->
+</body>
+</html>
\ No newline at end of file
diff --git a/spec/conversions_and_reflection.html b/spec/conversions_and_reflection.html
new file mode 100644
index 0000000..f03954e
--- /dev/null
+++ b/spec/conversions_and_reflection.html
@@ -0,0 +1,1571 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="generator" content="Asciidoctor 1.5.5">
+<meta name="author" content="2019-08-07 15:02:40 CEST">
+<title>N4JS Language Specification</title>
+<link rel="stylesheet" href="styles/spec.min.css">
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.6.3/css/font-awesome.min.css">
+<!-- ************* docinfo ******************************************************************* -->
+
+
+<!-- ************* Favicon ************-->
+<link rel="icon" href="images/favicon.ico" />
+
+<!-- ************* Back-to-top JQuery ************* -->
+<script src="https://code.jquery.com/jquery-1.12.4.js"></script>
+<script src="https://code.jquery.com/ui/1.12.0/jquery-ui.js"></script>
+
+
+<link href="styles/prism.min.css" rel="stylesheet" />
+<script type="text/javascript" async
+  src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2/MathJax.js?config=TeX-MML-AM_CHTML">
+</script>
+
+<!-- ************* Styles ************* -->
+<link rel="stylesheet" type="text/css" href="styles/n4jsspec-adoc.css">
+
+
+<!-- ****************** NavBar ****************** -->
+<div id="menubar">
+	<div class="banner">
+        <a href="https://www.eclipse.org/n4js/#"><img id="logo" src="images/n4js-logo.png" alt="Eclipse N4JS"></a>
+    </div>
+<ul>
+  <li><a href="index.html">Index</a></li>
+</ul>
+</div>
+<!-- ************* docinfo ******************************************************************* -->
+<style>
+      .admonitionblock td.icon .icon-todo:before{content:"\f249";color:#f4ee42}
+    </style>
+</head>
+<body class="book toc2 toc-left">
+<div id="header">
+<h1>N4JS Language Specification</h1>
+<div class="details">
+<span id="author" class="author">2019-08-07 15:02:40 CEST</span><br>
+<span id="revnumber">version 0.9</span>
+</div>
+<div id="toc" class="toc2">
+<div id="toctitle">Table of Contents</div>
+<ul class="sectlevel1">
+<li><a href="introduction.html#_introduction">1. Introduction</a>
+<ul class="sectlevel2">
+<li><a href="introduction.html#_notation">1.1. Notation</a>
+<ul class="sectlevel3">
+<li><a href="introduction.html#_grammar-notation">1.1.1. Grammar Notation</a></li>
+<li><a href="introduction.html#_type-judgments-and-rules-and-constraints-notation">1.1.2. Type Judgments and Rules and Constraints Notation</a>
+<ul class="sectlevel4">
+<li><a href="introduction.html#_typing-rules-and-judgments">1.1.2.1. Typing Rules and Judgments</a></li>
+<li><a href="introduction.html#_types-of-an-element">1.1.2.2. Types of an Element</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="introduction.html#_auxiliary-functions">1.2. Auxiliary Functions</a>
+<ul class="sectlevel3">
+<li><a href="introduction.html#_binding">1.2.1. Binding</a></li>
+<li><a href="introduction.html#_merging-types">1.2.2. Merging Types</a>
+<ul class="sectlevel4">
+<li><a href="introduction.html#_logic-formulas">1.2.2.1. Logic Formulas</a></li>
+</ul>
+</li>
+<li><a href="introduction.html#_symbols-and-font-convention">1.2.3. Symbols and Font Convention</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="grammar.html#_grammar">2. Grammar</a>
+<ul class="sectlevel2">
+<li><a href="grammar.html#_lexical-conventions">2.1. Lexical Conventions</a>
+<ul class="sectlevel3">
+<li><a href="grammar.html#_identifier-names-and-identifiers">2.1.1. Identifier Names and Identifiers</a></li>
+<li><a href="grammar.html#_this-keyword">2.1.2. This Keyword</a></li>
+<li><a href="grammar.html#_regular-expression-literals">2.1.3. Regular Expression Literals</a></li>
+<li><a href="grammar.html#_automatic-semicolon-insertion">2.1.4. Automatic Semicolon Insertion</a></li>
+<li><a href="grammar.html#_jsdoc">2.1.5. JSDoc</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="names.html#_names">3. Names</a>
+<ul class="sectlevel2">
+<li><a href="names.html#_access-control">3.1. Access Control</a></li>
+<li><a href="names.html#_accessibility-of-types-top-level-variables-and-function-declarations">3.2. Accessibility of Types, Top-Level Variables and Function Declarations</a>
+<ul class="sectlevel3">
+<li><a href="names.html#_accessibility-of-members">3.2.1. Accessibility of Members</a></li>
+<li><a href="names.html#_valid-names">3.2.2. Valid Names</a></li>
+<li><a href="names.html#_qualified-names">3.2.3. Qualified Names</a></li>
+<li><a href="names.html#_name-duplicates">3.2.4. Name Duplicates</a>
+<ul class="sectlevel4">
+<li><a href="names.html#_lexical-environment">3.2.4.1. Lexical Environment</a></li>
+<li><a href="names.html#_duplicates-and-shadowing">3.2.4.2. Duplicates and Shadowing</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="types.html#_types">4. Types</a>
+<ul class="sectlevel2">
+<li><a href="types.html#_overview">4.1. Overview</a></li>
+<li><a href="types.html#_type-expressions">4.2. Type Expressions</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_syntax">4.2.1. Syntax</a></li>
+<li><a href="types.html#_properties">4.2.2. Properties</a></li>
+<li><a href="types.html#_semantics">4.2.3. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_type-inference">4.3. Type Inference</a></li>
+<li><a href="types.html#_generic-and-parameterized-types">4.4. Generic and Parameterized Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_generic-types">4.4.1. Generic Types</a></li>
+<li><a href="types.html#_type-variables">4.4.2. Type Variables</a></li>
+<li><a href="types.html#_parameterized-types">4.4.3. Parameterized Types</a></li>
+</ul>
+</li>
+<li><a href="types.html#_primitive-ecmascript-types">4.5. Primitive ECMAScript Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_undefined-type">4.5.1. Undefined Type</a></li>
+<li><a href="types.html#_null-type">4.5.2. Null Type</a></li>
+<li><a href="types.html#_primitive-boolean-type">4.5.3. Primitive Boolean Type</a></li>
+<li><a href="types.html#_primitive-string-type">4.5.4. Primitive String Type</a></li>
+<li><a href="types.html#_primitive-number-type">4.5.5. Primitive Number Type</a></li>
+<li><a href="types.html#_primitive-type-int">4.5.6. Primitive Type int</a></li>
+<li><a href="types.html#_primitive-symbol-type">4.5.7. Primitive Symbol Type</a></li>
+</ul>
+</li>
+<li><a href="types.html#_primitive-n4js-types">4.6. Primitive N4JS Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_any-type">4.6.1. Any Type</a>
+<ul class="sectlevel4">
+<li><a href="types.html#any-type-semantics">4.6.1.1. Semantics</a></li>
+<li><a href="types.html#any-type-type-inference">4.6.1.2. Type Inference</a>
+<ul class="sectlevel5">
+<li><a href="types.html#_default-type-of-variables">4.6.1.2.1. Default Type of Variables</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="types.html#_void-type">4.6.2. Void Type</a>
+<ul class="sectlevel4">
+<li><a href="types.html#void-type-semantics">4.6.2.1. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_unknown-type">4.6.3. Unknown Type</a></li>
+<li><a href="types.html#_primitive-pathselector-and-i18nkey">4.6.4. Primitive Pathselector and I18nKey</a>
+<ul class="sectlevel4">
+<li><a href="types.html#pathselector-semantics">4.6.4.1. Semantics</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="types.html#_built-in-ecmascript-object-types">4.7. Built-in ECMAScript Object Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#ECMAScript-objects-semantics">4.7.1. Semantics</a></li>
+<li><a href="types.html#_object-type">4.7.2. Object Type</a></li>
+<li><a href="types.html#_function-object-type">4.7.3. Function-Object-Type</a></li>
+<li><a href="types.html#_array-object-type">4.7.4. Array Object Type</a></li>
+<li><a href="types.html#_string-object-type">4.7.5. String Object Type</a></li>
+<li><a href="types.html#_boolean-object-type">4.7.6. Boolean Object Type</a></li>
+<li><a href="types.html#_number-object-type">4.7.7. Number Object Type</a></li>
+<li><a href="types.html#_global-object-type">4.7.8. Global Object Type</a></li>
+<li><a href="types.html#_symbol">4.7.9. Symbol</a></li>
+<li><a href="types.html#_promise">4.7.10. Promise</a></li>
+<li><a href="types.html#_iterator-interface">4.7.11. Iterator Interface</a></li>
+<li><a href="types.html#_iterable-interface">4.7.12. Iterable Interface</a></li>
+</ul>
+</li>
+<li><a href="types.html#_built-in-n4js-types">4.8. Built-In N4JS Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_n4object">4.8.1. N4Object</a>
+<ul class="sectlevel4">
+<li><a href="types.html#N4Object-semantics">4.8.1.1. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_n4class">4.8.2. N4Class</a></li>
+<li><a href="types.html#IterableN">4.8.3. IterableN</a></li>
+</ul>
+</li>
+<li><a href="types.html#_type-modifiers">4.9. Type Modifiers</a>
+<ul class="sectlevel3">
+<li><a href="types.html#Type_Modifiers_Dynamic">4.9.1. Dynamic</a></li>
+<li><a href="types.html#_optional-return-types">4.9.2. Optional Return Types</a></li>
+</ul>
+</li>
+<li><a href="types.html#_union-and-intersection-type-composed-types">4.10. Union and Intersection Type (Composed Types)</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_union-type">4.10.1. Union Type</a>
+<ul class="sectlevel4">
+<li><a href="types.html#union-type-syntax">4.10.1.1. Syntax</a></li>
+<li><a href="types.html#union-type-semantics">4.10.1.2. Semantics</a></li>
+<li><a href="types.html#_warnings">4.10.1.3. Warnings</a></li>
+</ul>
+</li>
+<li><a href="types.html#_intersection-type">4.10.2. Intersection Type</a>
+<ul class="sectlevel4">
+<li><a href="types.html#intersection-type-syntax">4.10.2.1. Syntax</a></li>
+<li><a href="types.html#intersection-type-semantics">4.10.2.2. Semantics</a></li>
+<li><a href="types.html#_warnings-2">4.10.2.3. Warnings</a></li>
+</ul>
+</li>
+<li><a href="types.html#_composed-types-in-wildcards">4.10.3. Composed Types in Wildcards</a></li>
+<li><a href="types.html#_property-access-for-composed-types">4.10.4. Property Access for Composed Types</a>
+<ul class="sectlevel4">
+<li><a href="types.html#_properties-of-union-type">4.10.4.1. Properties of Union Type</a>
+<ul class="sectlevel5">
+<li><a href="types.html#_remarks-on-union-type-s-members">4.10.4.1.1. Remarks on union type’s members:</a></li>
+</ul>
+</li>
+<li><a href="types.html#_properties-of-intersection-type">4.10.4.2. Properties of Intersection Type</a>
+<ul class="sectlevel5">
+<li><a href="types.html#_remarks-on-intersection-type-s-methods">4.10.4.2.1. Remarks on intersection type’s methods:</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="types.html#_constructor-and-classifier-type">4.11. Constructor and Classifier Type</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_syntax-3">4.11.1. Syntax</a></li>
+<li><a href="types.html#_semantics-2">4.11.2. Semantics</a></li>
+<li><a href="types.html#_constructors-and-prototypes-in-ecmascript-2015">4.11.3. Constructors and Prototypes in ECMAScript 2015</a></li>
+</ul>
+</li>
+<li><a href="types.html#_this-type">4.12. This Type</a>
+<ul class="sectlevel3">
+<li><a href="types.html#this-type-syntax">4.12.1. Syntax</a></li>
+<li><a href="types.html#this-keyword-semantics">4.12.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_enums">4.13. Enums</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_enums-n4js">4.13.1. Enums (N4JS)</a>
+<ul class="sectlevel4">
+<li><a href="types.html#enums-syntax">4.13.1.1. Syntax</a></li>
+<li><a href="types.html#enums-semantics">4.13.1.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_string-based-enums">4.13.2. String-Based Enums</a></li>
+</ul>
+</li>
+<li><a href="types.html#_short-hand-syntax">4.14. Short-Hand Syntax</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_array-short-hand-syntax">4.14.1. Array Short-Hand Syntax</a></li>
+<li><a href="types.html#_iterablen-short-hand-syntax">4.14.2. IterableN Short-Hand Syntax</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="classifiers.html#_classifiers">5. Classifiers</a>
+<ul class="sectlevel2">
+<li><a href="classifiers.html#_n4js-specific-classifiers">5.1. N4JS Specific Classifiers</a>
+<ul class="sectlevel3">
+<li><a href="classifiers.html#_properties-2">5.1.1. Properties</a></li>
+<li><a href="classifiers.html#_common-semantics-of-classifiers">5.1.2. Common Semantics of Classifiers</a></li>
+<li><a href="classifiers.html#_classes">5.1.3. Classes</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_definition-of-classes">5.1.3.1. Definition of Classes</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#class-syntax">5.1.3.1.1. Syntax</a></li>
+<li><a href="classifiers.html#class-properties">5.1.3.1.2. Properties</a></li>
+<li><a href="classifiers.html#class-type-inference">5.1.3.1.3. Type Inference</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#class-semantics">5.1.3.2. Semantics</a></li>
+<li><a href="classifiers.html#_final-modifier">5.1.3.3. Final Modifier</a></li>
+<li><a href="classifiers.html#_abstract-classes">5.1.3.4. Abstract Classes</a></li>
+<li><a href="classifiers.html#_non-instantiable-classes">5.1.3.5. Non-Instantiable Classes</a></li>
+<li><a href="classifiers.html#_superclass">5.1.3.6. Superclass</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_interfaces">5.1.4. Interfaces</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_definition-of-interfaces">5.1.4.1. Definition of Interfaces</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#interfaces-syntax">5.1.4.1.1. Syntax</a></li>
+<li><a href="classifiers.html#interfaces-properties">5.1.4.1.2. Properties</a></li>
+<li><a href="classifiers.html#interfaces-type-inference">5.1.4.1.3. Type Inference</a></li>
+<li><a href="classifiers.html#interfaces-semantics">5.1.4.1.4. Semantics</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="classifiers.html#_generic-classifiers">5.1.5. Generic Classifiers</a></li>
+<li><a href="classifiers.html#sec:definition-site-variance">5.1.6. Definition-Site Variance</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_members">5.2. Members</a>
+<ul class="sectlevel3">
+<li><a href="classifiers.html#_syntax-4">5.2.1. Syntax</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_properties-3">5.2.1.1. Properties</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_semantics-3">5.2.2. Semantics</a></li>
+<li><a href="classifiers.html#_methods">5.2.3. Methods</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_syntax-5">5.2.3.1. Syntax</a></li>
+<li><a href="classifiers.html#_properties-4">5.2.3.2. Properties</a></li>
+<li><a href="classifiers.html#_semantics-4">5.2.3.3. Semantics</a></li>
+<li><a href="classifiers.html#_final-methods">5.2.3.4. Final Methods</a></li>
+<li><a href="classifiers.html#_abstract-methods">5.2.3.5. Abstract Methods</a></li>
+<li><a href="classifiers.html#_generic-methods">5.2.3.6. Generic Methods</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_default-methods-in-interfaces">5.2.4. Default Methods in Interfaces</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_asynchronous-methods">5.2.4.1. Asynchronous Methods</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_constructors">5.2.5. Constructors</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_structural-this-type-in-constructor">5.2.5.1. Structural This Type in Constructor</a></li>
+<li><a href="classifiers.html#spec-constructor">5.2.5.2. @Spec Constructor</a></li>
+<li><a href="classifiers.html#_callable-constructors">5.2.5.3. Callable Constructors</a></li>
+<li><a href="classifiers.html#_covariant-constructors">5.2.5.4. Covariant Constructors</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_data-fields">5.2.6. Data Fields</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#data-fields-syntax">5.2.6.1. Syntax</a></li>
+<li><a href="classifiers.html#data-fields-properties">5.2.6.2. Properties</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#data-fields-semantics">5.2.6.2.1. Semantics</a></li>
+<li><a href="classifiers.html#data-fields-type-inference">5.2.6.2.2. Type Inference</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_assignment-modifiers">5.2.6.3. Assignment Modifiers</a></li>
+<li><a href="classifiers.html#_field-accessors-getter-setter">5.2.6.4. Field Accessors (Getter/Setter)</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#field-acessors-syntax">5.2.6.4.1. Syntax</a></li>
+<li><a href="classifiers.html#field-acessors-properties">5.2.6.4.2. Properties</a></li>
+<li><a href="classifiers.html#field-accessors-semantics">5.2.6.4.3. Semantics</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#optional-fields">5.2.6.5. Optional Fields</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#_syntax-6">5.2.6.5.1. Syntax</a></li>
+<li><a href="classifiers.html#_semantics-5">5.2.6.5.2. Semantics</a></li>
+<li><a href="classifiers.html#_background">5.2.6.5.3. Background</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="classifiers.html#_static-members">5.2.7. Static Members</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_access-from-and-to-static-members">5.2.7.1. Access From and To Static Members</a></li>
+<li><a href="classifiers.html#_generic-static-methods">5.2.7.2. Generic static methods</a></li>
+<li><a href="classifiers.html#_static-members-of-interfaces">5.2.7.3. Static Members of Interfaces</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_redefinition-of-members">5.2.8. Redefinition of Members</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_overriding-of-members">5.2.8.1. Overriding of Members</a></li>
+<li><a href="classifiers.html#_implementation-of-members">5.2.8.2. Implementation of Members</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#_member-consumption">5.2.8.2.1. Member Consumption</a></li>
+<li><a href="classifiers.html#_member-implementation">5.2.8.2.2. Member Implementation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="classifiers.html#_structural-typing">5.3. Structural Typing</a>
+<ul class="sectlevel3">
+<li><a href="classifiers.html#_syntax-7">5.3.1. Syntax</a></li>
+<li><a href="classifiers.html#_definition-site-structural-typing">5.3.2. Definition Site Structural Typing</a></li>
+<li><a href="classifiers.html#_use-site-structural-typing">5.3.3. Use-Site Structural Typing</a></li>
+<li><a href="classifiers.html#structural-readWriteInit-field-typing">5.3.4. Structural Read-only, Write-only and Initializer Field Typing</a></li>
+<li><a href="classifiers.html#_public-setter-annotated-with-code-providesinitializer-code">5.3.5. Public Setter Annotated With <code>ProvidesInitializer</code></a></li>
+<li><a href="classifiers.html#_structural-types-with-optional-fields">5.3.6. Structural Types With Optional Fields</a></li>
+<li><a href="classifiers.html#_structural-types-with-access-modifier">5.3.7. Structural Types With Access Modifier</a></li>
+<li><a href="classifiers.html#_structural-types-with-additional-members">5.3.8. Structural Types With Additional Members</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_syntax-8">5.3.8.1. Syntax</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#_semantics-6">5.3.8.1.1. Semantics</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="functions.html#_functions">6. Functions</a>
+<ul class="sectlevel2">
+<li><a href="functions.html#_function-type">6.1. Function Type</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_properties-5">6.1.1. Properties</a></li>
+<li><a href="functions.html#function-type-inference">6.1.2. Type Inference</a></li>
+<li><a href="functions.html#_autoboxing-of-function-type">6.1.3. Autoboxing of Function Type</a></li>
+<li><a href="functions.html#_arguments-object">6.1.4. Arguments Object</a></li>
+</ul>
+</li>
+<li><a href="functions.html#_ecmascript-5-function-definition">6.2. ECMAScript 5 Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_function-declaration">6.2.1. Function Declaration</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#_syntax-9">6.2.1.1. Syntax</a></li>
+<li><a href="functions.html#_semantics-8">6.2.1.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="functions.html#_function-expression">6.2.2. Function Expression</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#function-expression-syntax">6.2.2.1. Syntax</a></li>
+<li><a href="functions.html#_semantics-and-type-inference">6.2.2.2. Semantics and Type Inference</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="functions.html#_ecmascript-2015-function-definition">6.3. ECMAScript 2015 Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_formal-parameters">6.3.1. Formal Parameters</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#Type_Modifiers_Optional">6.3.1.1. Optional Parameters</a></li>
+<li><a href="functions.html#Type_Modifiers_Default">6.3.1.2. Default Parameters</a></li>
+<li><a href="functions.html#Type_Modifiers_Variadic">6.3.1.3. Variadic</a></li>
+</ul>
+</li>
+<li><a href="functions.html#_generator-functions">6.3.2. Generator Functions</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#generator-functions-syntax">6.3.2.1. Syntax</a></li>
+<li><a href="functions.html#generator-functions-semantics">6.3.2.2. Semantics</a></li>
+<li><a href="functions.html#_generator-arrow-functions">6.3.2.3. Generator Arrow Functions</a></li>
+</ul>
+</li>
+<li><a href="functions.html#_arrow-function-expression">6.3.3. Arrow Function Expression</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#arrow-function-expression-syntax">6.3.3.1. Syntax</a></li>
+<li><a href="functions.html#arrow-function-expression-semantics-and-type-inference">6.3.3.2. Semantics and Type Inference</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="functions.html#_ecmascript-proposals-function-definition">6.4. ECMAScript Proposals Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_asynchronous-functions">6.4.1. Asynchronous Functions</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#asynchronous-functions-syntax">6.4.1.1. Syntax</a></li>
+<li><a href="functions.html#asynchronous-functions-semantics">6.4.1.2. Semantics</a></li>
+<li><a href="functions.html#_asynchronous-arrow-functions">6.4.1.3. Asynchronous Arrow Functions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="functions.html#_n4js-extended-function-definition">6.5. N4JS Extended Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_generic-functions">6.5.1. Generic Functions</a></li>
+<li><a href="functions.html#_promisifiable-functions">6.5.2. Promisifiable Functions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#_conversions-and-reflection">7. Conversions and Reflection</a>
+<ul class="sectlevel2">
+<li><a href="#_autoboxing-and-coercing">7.1. Autoboxing and Coercing</a>
+<ul class="sectlevel3">
+<li><a href="#_coercing">7.1.1. Coercing</a></li>
+<li><a href="#_autoboxing-of-primitives">7.1.2. Autoboxing of Primitives</a></li>
+<li><a href="#_autoboxing-of-function-expressions-and-declarations">7.1.3. Autoboxing of Function Expressions and Declarations</a></li>
+</ul>
+</li>
+<li><a href="#_auto-conversion-of-objects">7.2. Auto-Conversion of Objects</a>
+<ul class="sectlevel3">
+<li><a href="#_auto-conversion-of-class-instances">7.2.1. Auto-Conversion of Class Instances</a>
+<ul class="sectlevel4">
+<li><a href="#_auto-conversion-of-interface-instances">7.2.1.1. Auto-Conversion of Interface Instances</a></li>
+</ul>
+</li>
+<li><a href="#_auto-conversion-of-enum-literals">7.2.2. Auto-Conversion of Enum Literals</a></li>
+</ul>
+</li>
+<li><a href="#_type-cast-and-type-check">7.3. Type Cast and Type Check</a>
+<ul class="sectlevel3">
+<li><a href="#_type-cast">7.3.1. Type Cast</a></li>
+<li><a href="#_type-check">7.3.2. Type Check</a></li>
+</ul>
+</li>
+<li><a href="#_reflection-meta-information">7.4. Reflection meta-information</a>
+<ul class="sectlevel3">
+<li><a href="#_reflection-for-classes">7.4.1. Reflection for Classes</a></li>
+<li><a href="#_reflection-for-interfaces">7.4.2. Reflection for Interfaces</a></li>
+<li><a href="#_reflection-for-enumerations">7.4.3. Reflection for Enumerations</a></li>
+</ul>
+</li>
+<li><a href="#_conversion-of-primitive-types">7.5. Conversion of primitive types</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_expressions">8. Expressions</a>
+<ul class="sectlevel2">
+<li><a href="expressions.html#_ecmascript-5-expressions">8.1. ECMAScript 5 Expressions</a>
+<ul class="sectlevel3">
+<li><a href="expressions.html#_the-this-literal">8.1.1. The this Literal</a></li>
+<li><a href="expressions.html#_identifier">8.1.2. Identifier</a></li>
+<li><a href="expressions.html#_literals">8.1.3. Literals</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#_integer-literals">8.1.3.1. Integer Literals</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_array-literal">8.1.4. Array Literal</a></li>
+<li><a href="expressions.html#_object-literal">8.1.5. Object Literal</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#_properties-6">8.1.5.1. Properties</a></li>
+<li><a href="expressions.html#_scoping-and-linking">8.1.5.2. Scoping and linking</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_parenthesized-expression-and-grouping-operator">8.1.6. Parenthesized Expression and Grouping Operator</a></li>
+<li><a href="expressions.html#_property-accessors">8.1.7. Property Accessors</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#properties-1">8.1.7.1. Properties</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_new-expression">8.1.8. New Expression</a></li>
+<li><a href="expressions.html#_function-expression-2">8.1.9. Function Expression</a></li>
+<li><a href="expressions.html#_function-calls">8.1.10. Function Calls</a></li>
+<li><a href="expressions.html#_postfix-expression">8.1.11. Postfix Expression</a></li>
+<li><a href="expressions.html#_unary-expression">8.1.12. Unary Expression</a></li>
+<li><a href="expressions.html#_multiplicative-expression">8.1.13. Multiplicative Expression</a></li>
+<li><a href="expressions.html#_additive-expression">8.1.14. Additive Expression</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#type-inference-10">8.1.14.1. Type Inference</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_bitwise-shift-expression">8.1.15. Bitwise Shift Expression</a></li>
+<li><a href="expressions.html#_relational-expression">8.1.16. Relational Expression</a></li>
+<li><a href="expressions.html#_equality-expression">8.1.17. Equality Expression</a></li>
+<li><a href="expressions.html#_binary-bitwise-expression">8.1.18. Binary Bitwise Expression</a></li>
+<li><a href="expressions.html#_binary-logical-expression">8.1.19. Binary Logical Expression</a></li>
+<li><a href="expressions.html#_conditional-expression">8.1.20. Conditional Expression</a></li>
+<li><a href="expressions.html#_assignment-expression">8.1.21. Assignment Expression</a></li>
+<li><a href="expressions.html#_comma-expression">8.1.22. Comma Expression</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_ecmascript-6-expressions">8.2. ECMAScript 6 Expressions</a>
+<ul class="sectlevel3">
+<li><a href="expressions.html#_the-super-keyword">8.2.1. The super Keyword</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_ecmascript-7-expressions">8.3. ECMAScript 7 Expressions</a>
+<ul class="sectlevel3">
+<li><a href="expressions.html#_await-expression">8.3.1. Await Expression</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_n4js-specific-expressions">8.4. N4JS Specific Expressions</a>
+<ul class="sectlevel3">
+<li><a href="expressions.html#_class-expression">8.4.1. Class Expression</a></li>
+<li><a href="expressions.html#_cast-as-expression">8.4.2. Cast (As) Expression</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#cast-as-expression-semantics-type-inference">8.4.2.1. Semantics and Type Inference</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#Import_Calls">8.4.3. Import Calls</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#compile-time-expressions">8.5. Compile-Time Expressions</a></li>
+</ul>
+</li>
+<li><a href="statements.html#_statements">9. Statements</a>
+<ul class="sectlevel2">
+<li><a href="statements.html#_ecmascript-5-statements">9.1. ECMAScript 5 Statements</a>
+<ul class="sectlevel3">
+<li><a href="statements.html#_function-or-field-accessor-bodies">9.1.1. Function or Field Accessor Bodies</a></li>
+<li><a href="statements.html#_variable-statement">9.1.2. Variable Statement</a></li>
+<li><a href="statements.html#_if-statement">9.1.3. If Statement</a></li>
+<li><a href="statements.html#_iteration-statements">9.1.4. Iteration Statements</a></li>
+<li><a href="statements.html#_return-statement">9.1.5. Return Statement</a></li>
+<li><a href="statements.html#_with-statement">9.1.6. With Statement</a></li>
+<li><a href="statements.html#_switch-statement">9.1.7. Switch Statement</a></li>
+<li><a href="statements.html#_throw-try-and-catch-statements">9.1.8. Throw, Try, and Catch Statements</a></li>
+<li><a href="statements.html#_debugger-statement">9.1.9. Debugger Statement</a></li>
+</ul>
+</li>
+<li><a href="statements.html#_ecmascript-6-statements">9.2. ECMAScript 6 Statements</a>
+<ul class="sectlevel3">
+<li><a href="statements.html#_let">9.2.1. Let</a></li>
+<li><a href="statements.html#_const">9.2.2. Const</a></li>
+<li><a href="statements.html#_for-of-statement">9.2.3. <code>for &#8230;&#8203; of</code> statement</a></li>
+<li><a href="statements.html#_import-statement">9.2.4. Import Statement</a>
+<ul class="sectlevel4">
+<li><a href="statements.html#Dynamic_Imports">9.2.4.1. Dynamic Imports</a></li>
+<li><a href="statements.html#_immutabilaty-of-imports">9.2.4.2. Immutabilaty of Imports</a></li>
+</ul>
+</li>
+<li><a href="statements.html#_export-statement">9.2.5. Export Statement</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="annotations.html#_annotations">10. Annotations</a>
+<ul class="sectlevel2">
+<li><a href="annotations.html#_introduction-2">10.1. Introduction</a>
+<ul class="sectlevel3">
+<li><a href="annotations.html#_syntax-13">10.1.1. Syntax</a></li>
+<li><a href="annotations.html#_properties-7">10.1.2. Properties</a></li>
+<li><a href="annotations.html#_element-specific-annotations">10.1.3. Element-Specific Annotations</a></li>
+<li><a href="annotations.html#_general-annotations">10.1.4. General Annotations</a>
+<ul class="sectlevel4">
+<li><a href="annotations.html#_idebug">10.1.4.1. IDEBUG</a></li>
+</ul>
+</li>
+<li><a href="annotations.html#idebug-syntax">10.1.5. Syntax</a>
+<ul class="sectlevel4">
+<li><a href="annotations.html#_semantics-11">10.1.5.1. Semantics</a></li>
+<li><a href="annotations.html#_suppress-warnings">10.1.5.2. Suppress Warnings</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="annotations.html#_declaration-of-annotations">10.2. Declaration of Annotations</a></li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_extended-fetaures">11. Extended Fetaures</a>
+<ul class="sectlevel2">
+<li><a href="extended_fetaures.html#_array-and-object-destructuring">11.1. Array and Object Destructuring</a>
+<ul class="sectlevel3">
+<li><a href="extended_fetaures.html#_syntax-14">11.1.1. Syntax</a></li>
+<li><a href="extended_fetaures.html#_semantics-12">11.1.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_dependency-injection">11.2. Dependency Injection</a>
+<ul class="sectlevel3">
+<li><a href="extended_fetaures.html#_di-components-and-injectors">11.2.1. DI Components and Injectors</a>
+<ul class="sectlevel4">
+<li><a href="extended_fetaures.html#_dicomponent-relations">11.2.1.1. DIComponent Relations</a></li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_binders-and-bindings">11.2.2. Binders and Bindings</a></li>
+<li><a href="extended_fetaures.html#_injection-points">11.2.3. Injection Points</a>
+<ul class="sectlevel4">
+<li><a href="extended_fetaures.html#_field-injection">11.2.3.1. Field Injection</a></li>
+<li><a href="extended_fetaures.html#_constructor-injection">11.2.3.2. Constructor Injection</a></li>
+<li><a href="extended_fetaures.html#_method-injection">11.2.3.3. Method Injection</a>
+<ul class="sectlevel5">
+<li><a href="extended_fetaures.html#_provider">11.2.3.3.1. Provider</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_n4js-di-life-cycle-and-scopes">11.2.4. N4JS DI Life Cycle and Scopes</a>
+<ul class="sectlevel4">
+<li><a href="extended_fetaures.html#_injection-cylces">11.2.4.1. Injection Cylces</a></li>
+<li><a href="extended_fetaures.html#_default-scope">11.2.4.2. Default Scope</a></li>
+<li><a href="extended_fetaures.html#_singleton-scope">11.2.4.3. Singleton Scope</a></li>
+<li><a href="extended_fetaures.html#_per-injection-chain-singleton">11.2.4.4. Per Injection Chain Singleton</a></li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_validation-of-callsites-targeting-n4injector-methods">11.2.5. Validation of callsites targeting N4Injector methods</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-annotations">11.2.6. N4JS DI Annotations</a>
+<ul class="sectlevel4">
+<li><a href="extended_fetaures.html#_n4js-di-generateinjector">11.2.6.1. N4JS DI @GenerateInjector</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-withparentinjector">11.2.6.2. N4JS DI @WithParentInjector</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-usebinder">11.2.6.3. N4JS DI @UseBinder</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-binder">11.2.6.4. N4JS DI @Binder</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-bind">11.2.6.5. N4JS DI @Bind</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-provides">11.2.6.6. N4JS DI @Provides</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-inject">11.2.6.7. N4JS DI @Inject</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-singleton">11.2.6.8. N4JS DI @Singleton</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_test-support">11.3. Test Support</a></li>
+<li><a href="extended_fetaures.html#_polyfill-definitions">11.4. Polyfill Definitions</a>
+<ul class="sectlevel3">
+<li><a href="extended_fetaures.html#_runtime-polyfill-definitions">11.4.1. Runtime Polyfill Definitions</a></li>
+<li><a href="extended_fetaures.html#_static-polyfill-definitions">11.4.2. Static Polyfill Definitions</a></li>
+<li><a href="extended_fetaures.html#_transpiling-static-polyfilled-classes">11.4.3. Transpiling static polyfilled classes</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="components.html#_components">12. Components</a>
+<ul class="sectlevel2">
+<li><a href="components.html#_overview-2">12.1. Overview</a></li>
+<li><a href="components.html#Component_Types">12.2. Component Types</a>
+<ul class="sectlevel3">
+<li><a href="components.html#_libraries">12.2.1. Libraries</a></li>
+<li><a href="components.html#_runtime-environment-and-runtime-libraries">12.2.2. Runtime Environment and Runtime Libraries</a></li>
+<li><a href="components.html#_tests">12.2.3. Tests</a></li>
+<li><a href="components.html#_type-definitions">12.2.4. Type Definitions</a></li>
+</ul>
+</li>
+<li><a href="components.html#package-json">12.3. Package.json File</a>
+<ul class="sectlevel3">
+<li><a href="components.html#_basic-properties">12.3.1. Basic Properties</a></li>
+<li><a href="components.html#_n4js-properties">12.3.2. N4JS Properties</a></li>
+<li><a href="components.html#_constraints">12.3.3. Constraints</a></li>
+</ul>
+</li>
+<li><a href="components.html#_support-for-npm-scopes">12.4. Support for NPM Scopes</a></li>
+<li><a href="components.html#sec:N4JS-Type-Definitions">12.5. N4JS Type Definitions</a>
+<ul class="sectlevel3">
+<li><a href="components.html#_specify-type-definition">12.5.1. Specify Type Definition</a></li>
+<li><a href="components.html#_name-conventions">12.5.2. Name Conventions</a></li>
+<li><a href="components.html#_version-conventions">12.5.3. Version Conventions</a>
+<ul class="sectlevel4">
+<li><a href="components.html#_define-a-new-type-definition-package">12.5.3.1. Define a New Type Definition Package</a></li>
+<li><a href="components.html#_using-a-type-definition-package">12.5.3.2. Using a Type Definition Package</a></li>
+<li><a href="components.html#_rational">12.5.3.3. Rational</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="components.html#_modules">12.6. Modules</a></li>
+<li><a href="components.html#_api-and-implementation-component">12.7. API and Implementation Component</a>
+<ul class="sectlevel3">
+<li><a href="components.html#_execution-of-api-and-implementation-components">12.7.1. Execution of API and Implementation Components</a></li>
+<li><a href="components.html#_api-and-implementation-with-di">12.7.2. API and Implementation With DI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="plainjs.html#_plainjs">13. PlainJS</a>
+<ul class="sectlevel2">
+<li><a href="plainjs.html#_type-inference-and-validation-for-plain-js">13.1. Type Inference and Validation for Plain JS</a></li>
+<li><a href="plainjs.html#_external-declarations">13.2. External Declarations</a>
+<ul class="sectlevel3">
+<li><a href="plainjs.html#_declaring-externals">13.2.1. Declaring externals</a></li>
+<li><a href="plainjs.html#_instantiating-external-classes">13.2.2. Instantiating external classes</a></li>
+<li><a href="plainjs.html#_implementation-of-external-declarations">13.2.3. Implementation of External Declarations</a></li>
+<li><a href="plainjs.html#_example">13.2.4. Example</a></li>
+</ul>
+</li>
+<li><a href="plainjs.html#_global-definitions">13.3. Global Definitions</a></li>
+<li><a href="plainjs.html#_runtime-definitions">13.4. Runtime Definitions</a></li>
+<li><a href="plainjs.html#_applying-polyfills">13.5. Applying Polyfills</a></li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_jsdoc-2">14. JSDoc</a>
+<ul class="sectlevel2">
+<li><a href="jsdoc.html#_general-n4jsdoc-features">14.1. General N4JSDoc Features</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#_provided-inline-tags">14.1.1. Provided Inline Tags</a>
+<ul class="sectlevel4">
+<li><a href="jsdoc.html#jsdoc_tag__code">14.1.1.1. @code</a></li>
+<li><a href="jsdoc.html#jsdoc_tag__link">14.1.1.2. @link</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_n4jsdoc-for-user-projects">14.2. N4JSdoc for User Projects</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#_standard-tags">14.2.1. Standard Tags</a>
+<ul class="sectlevel4">
+<li><a href="jsdoc.html#_-author">14.2.1.1. @author</a></li>
+<li><a href="jsdoc.html#jsdoc_tag_param">14.2.1.2. @param</a></li>
+<li><a href="jsdoc.html#jsdoc_tag_return">14.2.1.3. @return</a></li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_test-related-tags">14.2.2. Test Related Tags</a>
+<ul class="sectlevel4">
+<li><a href="jsdoc.html#jsdoc_tag__testee">14.2.2.1. @testee</a></li>
+<li><a href="jsdoc.html#jsdoc_tag__testeeFromType">14.2.2.2. @testeeFromType</a></li>
+<li><a href="jsdoc.html#_testeeType_and__testeeMember">14.2.2.3. @testeeType and @testeeMember</a></li>
+<li><a href="jsdoc.html#jsdoc_tag_reqid_in_Tests">14.2.2.4. @reqid in Tests</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_n4jsdoc-for-api-and-implementation-projects">14.3. N4JSDoc for API and Implementation Projects</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#jsdoc_tag__apiNote">14.3.1. @apiNote</a></li>
+<li><a href="jsdoc.html#API_Project_Tags">14.3.2. API Project Tags</a>
+<ul class="sectlevel4">
+<li><a href="jsdoc.html#jsdoc_tag_apiState">14.3.2.1. @apiState</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsx.html#_jsx">15. JSX</a>
+<ul class="sectlevel2">
+<li><a href="jsx.html#_jsx-support">15.1. JSX Support</a></li>
+<li><a href="jsx.html#_jsx-backend">15.2. JSX Backend</a></li>
+</ul>
+</li>
+<li><a href="grammars.html#_grammars">16. Grammars</a>
+<ul class="sectlevel2">
+<li><a href="grammars.html#_type-expressions-grammar">16.1. Type Expressions Grammar</a></li>
+<li><a href="grammars.html#_n4js-language-grammar">16.2. N4JS Language Grammar</a></li>
+</ul>
+</li>
+<li><a href="jsobjects.html#_jsobjects">17. JSObjects</a>
+<ul class="sectlevel2">
+<li><a href="jsobjects.html#_object">17.1. Object</a></li>
+<li><a href="jsobjects.html#_string">17.2. String</a></li>
+<li><a href="jsobjects.html#_boolean">17.3. Boolean</a></li>
+<li><a href="jsobjects.html#_number">17.4. Number</a>
+<ul class="sectlevel3">
+<li><a href="jsobjects.html#_static-attributes">17.4.1. Static Attributes</a></li>
+</ul>
+</li>
+<li><a href="jsobjects.html#function">17.5. Function</a></li>
+<li><a href="jsobjects.html#_error">17.6. Error</a></li>
+<li><a href="jsobjects.html#_array">17.7. Array</a></li>
+<li><a href="jsobjects.html#_date">17.8. Date</a></li>
+<li><a href="jsobjects.html#_math">17.9. Math</a>
+<ul class="sectlevel3">
+<li><a href="jsobjects.html#static-attributes-1">17.9.1. Static Attributes</a></li>
+</ul>
+</li>
+<li><a href="jsobjects.html#_regexp">17.10. RegExp</a></li>
+<li><a href="jsobjects.html#_json">17.11. JSON</a></li>
+</ul>
+</li>
+<li><a href="n4js_objects.html#_n4js-objects">18. N4JS Objects</a>
+<ul class="sectlevel2">
+<li><a href="n4js_objects.html#_reflection-model">18.1. Reflection Model</a></li>
+<li><a href="n4js_objects.html#_error-types">18.2. Error Types</a>
+<ul class="sectlevel3">
+<li><a href="n4js_objects.html#_n4apinotimplemented">18.2.1. N4ApiNotImplemented</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_acronyms.html#_acronyms">Appendix A: Acronyms</a></li>
+<li><a href="appendix_b_license.html#sec:License">Appendix B: License</a></li>
+<li><a href="appendix_c_bibliography.html#_bibliography">Appendix C: Bibliography</a></li>
+</ul>
+</div>
+</div>
+<div id="content"><div class="sect1">
+<h2 id="_conversions-and-reflection"><a class="anchor" href="#_conversions-and-reflection"></a><a class="link" href="#_conversions-and-reflection">7. Conversions and Reflection</a></h2>
+<div class="sectionbody">
+<div class="sect2 language-n4js">
+<h3 id="_autoboxing-and-coercing"><a class="anchor" href="#_autoboxing-and-coercing"></a><a class="link" href="#_autoboxing-and-coercing">7.1. Autoboxing and Coercing</a></h3>
+<div class="paragraph">
+<p>Coercing is the ability to implicitly cast one (primitive) type to another.
+Autoboxing is a special kind of coercing in that is the ability to automatically convert a primitive value type, such as <code>string</code>, <code>number</code>, or <code>boolean</code>,
+to its corresponding Object type version <code>String</code>, <code>Number</code>, <code>Boolean</code>.
+The capital letters in the latter are an essential distinction.</p>
+</div>
+<div class="paragraph">
+<p>Conversion between primitives and object-representations of a datatype are not automatic in N4JS. Only in the cases of object-method invocations on a primitive type
+(for <code>string</code> to call <code>"abc".length</code>, for example) automatic conversion is applied.</p>
+</div>
+<div class="paragraph">
+<p>Note that N4JS specific primitive types <code>pathselector</code> and <code>i18nkey</code> are handled similarly to <code>string</code>.</p>
+</div>
+<div class="sect3">
+<h4 id="_coercing"><a class="anchor" href="#_coercing"></a><a class="link" href="#_coercing">7.1.1. Coercing</a></h4>
+<div class="paragraph">
+<p>In [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a</a>], coercing is defined by means of the abstract specification method <code>ToPrimitive</code> [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.S9.1)</a>], also see [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.S9.10)</a>]).
+Other conversions, such as <code>ToNumber</code>, are not directly supported but reflected in the typing rules of expressions.</p>
+</div>
+<div class="paragraph">
+<p>We express absence of automatic coercion here by means of subtype
+relations:</p>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mtable><mtr><mtd><mfrac><mrow/><mrow><mi>Γ</mi><mo>⊢</mo><mstyle mathvariant="monospace"><mtext>Boolean</mtext></mstyle><mspace width="1.0mm"/><mo>≮</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mstyle mathvariant="monospace"><mtext>boolean</mtext></mstyle></mrow></mfrac><mspace width="3.0mm"/><mfrac><mrow/><mrow><mi>Γ</mi><mo>⊢</mo><mstyle mathvariant="monospace"><mtext>boolean</mtext></mstyle><mspace width="1.0mm"/><mo>≮</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mstyle mathvariant="monospace"><mtext>Boolean</mtext></mstyle></mrow></mfrac></mtd></mtr><mtr><mtd><mfrac><mrow/><mrow><mi>Γ</mi><mo>⊢</mo><mstyle mathvariant="monospace"><mtext>Number</mtext></mstyle><mspace width="1.0mm"/><mo>≮</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mstyle mathvariant="monospace"><mtext>number</mtext></mstyle></mrow></mfrac><mspace width="3.0mm"/><mfrac><mrow/><mrow><mi>Γ</mi><mo>⊢</mo><mstyle mathvariant="monospace"><mtext>number</mtext></mstyle><mspace width="1.0mm"/><mo>≮</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mstyle mathvariant="monospace"><mtext>Number</mtext></mstyle></mrow></mfrac></mtd></mtr><mtr><mtd><mfrac><mrow/><mrow><mi>Γ</mi><mo>⊢</mo><mstyle mathvariant="monospace"><mtext>String</mtext></mstyle><mspace width="1.0mm"/><mo>≮</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mstyle mathvariant="monospace"><mtext>string</mtext></mstyle></mrow></mfrac><mspace width="3.0mm"/><mfrac><mrow/><mrow><mi>Γ</mi><mo>⊢</mo><mstyle mathvariant="monospace"><mtext>string</mtext></mstyle><mspace width="1.0mm"/><mo>≮</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mstyle mathvariant="monospace"><mtext>String</mtext></mstyle></mrow></mfrac></mtd></mtr></mtable></math>
+</div>
+</div>
+<div class="paragraph">
+<p>and for the N4JS specific types:</p>
+</div>
+<div class="paragraph">
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mfrac><mrow/><mrow><mi>Γ</mi><mo>⊢</mo><mstyle mathvariant="monospace"><mtext>pathSelector</mtext></mstyle><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>T</mtext></mstyle><mo>&gt;</mo><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mstyle mathvariant="monospace"><mtext>string</mtext></mstyle></mrow></mfrac></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mfrac><mrow/><mrow><mi>Γ</mi><mo>⊢</mo><mstyle mathvariant="monospace"><mtext>i18nKey</mtext></mstyle><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mstyle mathvariant="monospace"><mtext>string</mtext></mstyle></mrow></mfrac></math></p>
+</div>
+<div class="paragraph">
+<p>If a conversion between primitive and object type is desired, we require the user of N4JS to actively convert the values.
+The reason for that is the notably different behavior of object- and primitive-variants of a type in expression evaluation:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">var bool: boolean = false;
+var Bool: Boolean = new Boolean( false );
+
+console.log( bool ? "true" : "false"); // prints "false"
+console.log( Bool ? "true" : "false"); // prints "true"!</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Conversion between a primitive type to its object-variant is achieved by the <code>new</code> operator.
+The <code>valueOf()</code> method converts the object-variant back to a primitive value.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">// objects from literals:
+var bo: Boolean = new Boolean( true ); // typeof bo: object
+var no: Number = new Number( 42 ); // typeof no: object
+var so: String = new String( "foo" ); // typeof so: object
+
+// to primitive
+var b: boolean = bo.valueOf(); // typeof b: boolean -- true
+var n: number = no.valueOf(); // typeof n: number -- 42
+var s: string = so.valueOf(); // typeof s: string -- "foo"
+
+// to object-type
+bo = new Boolean( b );
+no = new Number( n );
+so = new String( s );</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Conversion of variables of type <code>Object</code> or from one primitive type to another is expressed in terms of typing rules for expressions.
+That is, it is not possible to convert any <code>Object</code> to a primitive in general, but it is possible to do so in the context of certain expressions such as additive operator.
+The applied conversions are described in <a href="#_auto-conversion-of-class-instances">Auto-Conversion of Class Instances</a></p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_autoboxing-of-primitives"><a class="anchor" href="#_autoboxing-of-primitives"></a><a class="link" href="#_autoboxing-of-primitives">7.1.2. Autoboxing of Primitives</a></h4>
+<div class="paragraph">
+<p>In [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a</a>], autoboxing is defined by <code>ToObject</code> [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.S9.9)</a>].</p>
+</div>
+<div class="paragraph">
+<p>Autoboxing is not directly supported in N4JS. Instead, primitive types virtually have the same members as their corresponding object types.
+It is then possible to use the Autoboxing feature when calling a member.
+In general, Autoboxing is only supported for accessing built-in read-only (immutable) properties.
+For example, <code>"some string value".split(" ");</code> is supported but <code>"some string value".foo=1;</code> will be rejected as String does not allow properties to be added (cf. <code>String</code> vs. <code>String+</code>, see <a href="#_dynamic">[_dynamic]</a>).</p>
+</div>
+<div class="paragraph">
+<p>Autoboxing often leads to problems, in particular in combination with dynamic types – this is why it is not directly supported in N4JS.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">var s: String+ = "Hello"; <i class="conum" data-value="1"></i><b>(1)</b>
+
+s.prop = 1;
+console.log(s.prop); <i class="conum" data-value="2"></i><b>(2)</b></code></pre>
+</div>
+</div>
+<div class="colist arabic">
+<table>
+<tr>
+<td><i class="conum" data-value="1"></i><b>1</b></td>
+<td>will produce an error to prevent the following scenario:</td>
+</tr>
+<tr>
+<td><i class="conum" data-value="2"></i><b>2</b></td>
+<td>prints "undefined"</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_autoboxing-of-function-expressions-and-declarations"><a class="anchor" href="#_autoboxing-of-function-expressions-and-declarations"></a><a class="link" href="#_autoboxing-of-function-expressions-and-declarations">7.1.3. Autoboxing of Function Expressions and Declarations</a></h4>
+<div class="paragraph">
+<p>Function expressions and declarations always define an object of type <code>Function</code>, thus coercing or Autoboxing is not required in case of functions:</p>
+</div>
+<div class="paragraph">
+<p>It is always possible to use a function expression where a <code>Function</code> is required, and to use an object of type <code>Function</code> where a function expression is expected.
+This is only possible if the function signatures are subtype-compatible, see <a href="functions.html#_function-type">Function Type</a> for details.</p>
+</div>
+<div class="paragraph">
+<p>Still, it is always possible to call members of <code>Function</code>, e.g., <code>function(){}.length()</code>.</p>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="_auto-conversion-of-objects"><a class="anchor" href="#_auto-conversion-of-objects"></a><a class="link" href="#_auto-conversion-of-objects">7.2. Auto-Conversion of Objects</a></h3>
+<div class="sect3">
+<h4 id="_auto-conversion-of-class-instances"><a class="anchor" href="#_auto-conversion-of-class-instances"></a><a class="link" href="#_auto-conversion-of-class-instances">7.2.1. Auto-Conversion of Class Instances</a></h4>
+<div class="paragraph">
+<p>All classes defined in N4JS modules implicitly subclass <code>N4Object</code>, which is a plain JavaScript Object type.
+The same auto-conversion rules defined for JavaScript <code>Object</code> therefore apply to <code>N4Object</code> instances as well.</p>
+</div>
+<div class="paragraph">
+<p>The basic conversion uses the abstract JavaScript function <code>ToPrimitive</code> [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.S9.1)</a>], which relays on the specification method <code>Object</code> [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.S8.12.8)</a>].
+<code>DefaultValue</code> calls <code>valueOf</code> or <code>toString</code> methods if they are defined by the class (in the <code>methods</code>-builder).</p>
+</div>
+<div class="paragraph">
+<p>Note that according to the [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a</a>], in most cases, objects are first converted into primitives.
+That is, in most cases, no extra hint is passed to <code>DefaultValue</code>. Thus <code>valueOf</code> usually takes precedence over toString as demonstrated in the following example:</p>
+</div>
+<div class="exampleblock">
+<div class="title">Example 70. Auto-Conversion</div>
+<div class="content">
+<div class="paragraph">
+<p>Assume some classes and corresponding instances defined as follows:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">class A {}
+class B{
+    @Override public toString(): string { return "MyB"}
+}
+class C{
+    @Override public valueOf(): any { return 10}
+}
+class D{
+    @Override public toString(): string { return "MyD"}
+    @Override public valueOf(): any { return 20}
+}
+var a = new A(), b = new B(), c = new C(), d = new D();</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Instances of these classes will be converted as demonstrated as follows:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">console.log(a+"");                      // [object Object]
+console.log(a+1);                       // [object Object]1
+
+console.log(""+b+"");                   // MyB
+console.log(1+b+1);                     // 1MyB1
+
+console.log(c+"");                      // 10
+console.log(c+1);                       // 11
+
+console.log(d+"");                      // 20
+console.log(d+1);                       // 21</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_auto-conversion-of-interface-instances"><a class="anchor" href="#_auto-conversion-of-interface-instances"></a><a class="link" href="#_auto-conversion-of-interface-instances">7.2.1.1. Auto-Conversion of Interface Instances</a></h5>
+<div class="paragraph">
+<p>Instances of interfaces actually are instances of classes at runtime.
+The auto-conversion rules described in <a href="#_auto-conversion-of-class-instances">Auto-Conversion of Class Instances</a> are applied to instances declared as instances of interfaces as well.</p>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_auto-conversion-of-enum-literals"><a class="anchor" href="#_auto-conversion-of-enum-literals"></a><a class="link" href="#_auto-conversion-of-enum-literals">7.2.2. Auto-Conversion of Enum Literals</a></h4>
+<div class="paragraph">
+<p>Enumeration values are objects and thus follow the behavior for ECMAScript <code>Object</code> and <code>Function</code>.
+They have a custom <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>t</mi><mi>o</mi><mi>S</mi><mi>t</mi><mi>r</mi><mi>i</mi><mi>n</mi><mi>g</mi></math> method which returns the name of the enumeration value.</p>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="_type-cast-and-type-check"><a class="anchor" href="#_type-cast-and-type-check"></a><a class="link" href="#_type-cast-and-type-check">7.3. Type Cast and Type Check</a></h3>
+<div class="sect3">
+<h4 id="_type-cast"><a class="anchor" href="#_type-cast"></a><a class="link" href="#_type-cast">7.3.1. Type Cast</a></h4>
+<div class="literalblock">
+<div class="content">
+<pre>(IDEBUG-56): Casting to TypeVars</pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Type casts are expressed with the cast expression (<code>as</code>), see <a href="expressions.html#_cast-as-expression">Cast (As) Expression</a> for details.</p>
+</div>
+<div class="paragraph">
+<p>We first define helper rules for the type cast constraints as follows:</p>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mtable><mtr><mtd><mfrac><mrow><mi>μ</mi><mfenced close=")" open="("><mi>T</mi></mfenced><mo>∈</mo><mfenced close="}" open="{"><mstyle mathvariant="monospace"><mtext>TEnum</mtext></mstyle><mstyle mathvariant="monospace"><mtext>Class</mtext></mstyle><mstyle mathvariant="monospace"><mtext>Primitive</mtext></mstyle><mstyle mathvariant="monospace"><mtext>ObjectType</mtext></mstyle></mfenced></mrow><mrow><mi>i</mi><mi>s</mi><mi>C</mi><mi>P</mi><mi>O</mi><mi>E</mi><mfenced close=")" open="("><mi>T</mi></mfenced></mrow></mfrac></mtd></mtr><mtr><mtd><mfrac><mrow><mi>μ</mi><mi>T</mi><mo>∈</mo><mfenced close="}" open="{"><mstyle mathvariant="monospace"><mtext>ClassifierType</mtext></mstyle><mstyle mathvariant="monospace"><mtext>TypeType</mtext></mstyle></mfenced><mo>∧</mo><mi>μ</mi><mfenced close=")" open="("><mrow><mi>T</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi></mrow></mfenced><mo>≠</mo><mstyle mathvariant="monospace"><mtext>TypeVariable</mtext></mstyle></mrow><mrow><mi>i</mi><mi>s</mi><mi>C</mi><mi>P</mi><mi>O</mi><mi>E</mi><mfenced close=")" open="("><mi>T</mi></mfenced></mrow></mfrac></mtd></mtr><mtr><mtd><mfrac><mrow><mi>μ</mi><mfenced close=")" open="("><mi>T</mi></mfenced><mo>∈</mo><mfenced close="}" open="{"><mstyle mathvariant="monospace"><mtext>Interface</mtext></mstyle></mfenced></mrow><mrow><mi>i</mi><mi>s</mi><mi>I</mi><mi>n</mi><mi>t</mi><mi>e</mi><mi>r</mi><mi>f</mi><mi>a</mi><mi>c</mi><mi>e</mi><mfenced close=")" open="("><mi>T</mi></mfenced></mrow></mfrac></mtd></mtr><mtr><mtd><mfrac><mrow><mi>μ</mi><mfenced close=")" open="("><mi>T</mi></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>TypeVariable</mtext></mstyle><mo>∧</mo><mi>T</mi><mo>.</mo><mi>u</mi><mi>p</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>B</mi><mi>o</mi><mi>u</mi><mi>n</mi><mi>d</mi><mi>s</mi><mo>≠</mo><mi>∅</mi></mrow><mrow><mi>i</mi><mi>s</mi><mi>B</mi><mi>o</mi><mi>u</mi><mi>n</mi><mi>d</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>V</mi><mi>a</mi><mi>r</mi><mfenced close=")" open="("><mi>T</mi></mfenced></mrow></mfrac></mtd></mtr><mtr><mtd><mfrac><mrow><mi>μ</mi><mfenced close=")" open="("><mi>T</mi></mfenced><mo>∈</mo><mfenced close="}" open="{"><mrow><mi> </mi><mstyle mathvariant="monospace"><mtext>TEnum</mtext></mstyle></mrow><mstyle mathvariant="monospace"><mtext>Primitive</mtext></mstyle></mfenced><mo>∨</mo><mfenced close="}" open="("><mrow><mi>μ</mi><mfenced close=")" open="("><mi>T</mi></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>Class</mtext></mstyle><mo>∧</mo><mi>T</mi><mo>.</mo><mi>e</mi><mi>x</mi><mi>t</mi><mi>e</mi><mi>n</mi><mi>s</mi><mi>i</mi><mi>b</mi><mi>i</mi><mi>l</mi><mi>i</mi><mi>t</mi><mi>y</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>final</mtext></mstyle></mrow></mfenced><mo>)</mo></mrow><mrow><mi>i</mi><mi>s</mi><mi>F</mi><mi>i</mi><mi>n</mi><mi>a</mi><mi>l</mi><mi>B</mi><mi>y</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi><mfenced close=")" open="("><mi>T</mi></mfenced></mrow></mfrac></mtd></mtr></mtable></math>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-89"></a><strong>Req. IDE-89:</strong> <a href="#Req-IDE-89">Cast Validation At Compile Time</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>Given a type cast expression <code>e</code> in which
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>Γ</mi><mo>⊢</mo><mi>e</mi><mo>.</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>:</mi><mi>S</mi></math> and and target type <code>T</code>, the
+following constraints must hold:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p><code>T</code> must be a classifier, enum, primitive, function type expression, classifier type, type variable, union or intersection type:</p>
+<div class="paragraph">
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>μ</mi><mfenced close=")" open="("><mi>T</mi></mfenced><mo>∈</mo><mspace width="3.0mm"/><mrow><mo>{</mo><mstyle mathvariant="monospace"><mtext>any</mtext></mstyle><mo>,</mo><mstyle mathvariant="monospace"><mtext>Class</mtext></mstyle><mo>,</mo><mstyle mathvariant="monospace"><mtext>Interface</mtext></mstyle><mo>,</mo><mstyle mathvariant="monospace"><mtext>Enum</mtext></mstyle><mo>,</mo><mstyle mathvariant="monospace"><mtext>Primitive</mtext></mstyle><mo>,</mo><mstyle mathvariant="monospace"><mtext>ObjectType</mtext></mstyle><mo>,</mo></mrow></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mrow><mspace width="3.0mm"/><mstyle mathvariant="monospace"><mtext>FunctionTypeExpression</mtext></mstyle><mo>,</mo><mstyle mathvariant="monospace"><mtext>ClassifierType</mtext></mstyle><mo>,</mo><mstyle mathvariant="monospace"><mtext>TypeVariable</mtext></mstyle><mo>,</mo><mstyle mathvariant="monospace"><mtext>Union</mtext></mstyle><mo>,</mo><mstyle mathvariant="monospace"><mtext>Intersection</mtext></mstyle><mo>}</mo></mrow></math></p>
+</div>
+</li>
+<li>
+<p>if <code>S</code> is a subtype of <code>T</code>, the cast is unnecessary and a warning will be generated.</p>
+</li>
+<li>
+<p>if <code>S</code> and <code>T</code> are classes, enums or primitive types, then <code>T</code> must be a subtype of <code>S</code>.
+This is also true if <code>T</code> is an interface and the type of <code>S</code> cannot have subtypes, or vice versa.</p>
+<div class="paragraph">
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mrow><mo>(</mo><mi>i</mi><mi>s</mi><mi>C</mi><mi>P</mi><mi>O</mi><mi>E</mi><mfenced close=")" open="("><mi>T</mi></mfenced></mrow></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="2.0em"/><mo>∧</mo><mrow><mo>(</mo><mi>i</mi><mi>s</mi><mi>C</mi><mi>P</mi><mi>O</mi><mi>E</mi><mfenced close=")" open="("><mi>S</mi></mfenced></mrow></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mrow><mspace width="4.0em"/><mo>∨</mo><mfenced close=")" open="("><mrow><mi>μ</mi><mfenced close=")" open="("><mi>S</mi></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>Intersection</mtext></mstyle><mo>∧</mo><mo>∃</mo><msup><mi>S</mi><mi>'</mi></msup><mo>∈</mo><mi>S</mi><mi>:</mi><mi>i</mi><mi>s</mi><mi>C</mi><mi>P</mi><mi>O</mi><mi>E</mi><mfenced close=")" open="("><msup><mi>S</mi><mi>'</mi></msup></mfenced></mrow></mfenced><mo>)</mo></mrow></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∨</mo><mfenced close=")" open="("><mrow><mi>i</mi><mi>s</mi><mi>I</mi><mi>n</mi><mi>t</mi><mi>e</mi><mi>r</mi><mi>f</mi><mi>a</mi><mi>c</mi><mi>e</mi><mfenced close=")" open="("><mi>T</mi></mfenced><mo>∧</mo><mi>i</mi><mi>s</mi><mi>F</mi><mi>i</mi><mi>n</mi><mi>a</mi><mi>l</mi><mi>B</mi><mi>y</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi><mfenced close=")" open="("><mi>S</mi></mfenced></mrow></mfenced></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mrow><mo>∨</mo><mfenced close=")" open="("><mrow><mi>i</mi><mi>s</mi><mi>F</mi><mi>i</mi><mi>n</mi><mi>a</mi><mi>l</mi><mi>B</mi><mi>y</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi><mfenced close=")" open="("><mi>T</mi></mfenced><mo>∧</mo><mi>i</mi><mi>s</mi><mi>I</mi><mi>n</mi><mi>t</mi><mi>e</mi><mi>r</mi><mi>f</mi><mi>a</mi><mi>c</mi><mi>e</mi><mfenced close=")" open="("><mi>S</mi></mfenced></mrow></mfenced><mo>)</mo></mrow><mo>→</mo><mi>Γ</mi><mo>⊢</mo><mi>T</mi><mo>&lt;</mo><mi>:</mi><mi>S</mi></math></p>
+</div>
+</li>
+<li>
+<p>if <code>S</code> is a class, enum or primitive type and <code>T</code> is a type-variable, then for each given boundary <math xmlns="http://www.w3.org/1998/Math/MathML"><msubsup><mi>T</mi><mi>i</mi><mrow><mi>u</mi><mi>p</mi></mrow></msubsup></math> of <code>T</code>
+of type class, enum or primitive <code>S</code> must be a member of the type hierarchy: <sup class="footnote">[<a id="_footnoteref_47" class="footnote" href="appendix_c_bibliography.html#_footnote_47" title="View footnote.">47</a>]</sup></p>
+<div class="paragraph">
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mfenced close=")" open="("><mrow><mi>i</mi><mi>s</mi><mi>B</mi><mi>o</mi><mi>u</mi><mi>n</mi><mi>d</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>V</mi><mi>a</mi><mi>r</mi><mfenced close=")" open="("><mi>T</mi></mfenced><mo>∧</mo><mi>i</mi><mi>s</mi><mi>C</mi><mi>P</mi><mi>O</mi><mi>E</mi><mfenced close=")" open="("><mi>S</mi></mfenced></mrow></mfenced></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mo>→</mo><msub><mo>∀</mo><mrow><msubsup><mi>T</mi><mi>i</mi><mrow><mi>u</mi><mi>p</mi></mrow></msubsup><mo>∈</mo><mi>T</mi><mo>.</mo><mi>u</mi><mi>p</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>B</mi><mi>o</mi><mi>u</mi><mi>n</mi><mi>d</mi><mi>s</mi></mrow></msub><mrow><mo>(</mo><mi>i</mi><mi>s</mi><mi>C</mi><mi>P</mi><mi>O</mi><mi>E</mi><mfenced close=")" open="("><msubsup><mi>T</mi><mi>i</mi><mrow><mi>u</mi><mi>p</mi></mrow></msubsup></mfenced><mo>→</mo><mi>Γ</mi><mo>⊢</mo><mrow><mo>(</mo><mrow><mrow><msubsup><mi>T</mi><mi>i</mi><mrow><mi>u</mi><mi>p</mi></mrow></msubsup><mo>&lt;</mo><mi>:</mi><mi>S</mi><mo>∨</mo><msubsup><mi>T</mi><mi>i</mi><mrow><mi>u</mi><mi>p</mi></mrow></msubsup><mi>:</mi><mo>&gt;</mo><mi>S</mi><mo>)</mo></mrow><mo>)</mo></mrow></mrow></mrow></math></p>
+</div>
+</li>
+<li>
+<p>if <code>S</code> is a union or intersection type, then the type cast is valid if it is valid for at least one element of <code>S</code>.</p>
+</li>
+<li>
+<p>if <code>S</code> and <code>T</code> are generics, and if <math xmlns="http://www.w3.org/1998/Math/MathML"><msup><mi>S</mi><mn>0</mn></msup><mo>=</mo><msup><mi>T</mi><mn>0</mn></msup></math>,
+a cast is possible if type arguments are sub- or supertypes of each other: <sup class="footnote">[<a id="_footnoteref_48" class="footnote" href="appendix_c_bibliography.html#_footnote_48" title="View footnote.">48</a>]</sup></p>
+<div class="paragraph">
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>μ</mi><mfenced close=")" open="("><mi>S</mi></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>Classifier</mtext></mstyle><mo>∧</mo><mi>μ</mi><mfenced close=")" open="("><mi>T</mi></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>Classifier</mtext></mstyle><mo>∧</mo><msup><mi>S</mi><mn>0</mn></msup><mo>=</mo><msup><mi>T</mi><mn>0</mn></msup><mo>→</mo></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="2.0em"/><mrow><mo>(</mo><mrow><mo>∀</mo><mi> </mi><mi>S</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>A</mi><mi>r</mi><msub><mi>g</mi><mi>i</mi></msub><mo>&lt;</mo><mi>:</mi><mi>T</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>A</mi><mi>r</mi><msub><mi>g</mi><mi>i</mi></msub><mo>)</mo></mrow><mo>∨</mo><mrow><mo>(</mo><mrow><mo>∀</mo><mi> </mi><mi>T</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>A</mi><mi>r</mi><msub><mi>g</mi><mi>i</mi></msub><mo>&lt;</mo><mi>:</mi><mi>S</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>A</mi><mi>r</mi><msub><mi>g</mi><mi>i</mi></msub><mo>)</mo></mrow></mrow></mrow></math></p>
+</div>
+</li>
+<li>
+<p>If <code>T</code> is a union type, then the type cast is valid if it is valid for at least one element of <code>T</code>.</p>
+</li>
+<li>
+<p>If <code>T</code> is an intersection type, then the type cast is valid if it is valid for all elements of <code>T</code>.</p>
+</li>
+</ol>
+</div>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title=""></i>
+</td>
+<td class="content">
+<code>any</code> is a supertype of all other types, thus it is always possible to cast a variable of type <code>any</code> to other (non-composed) types.
+</td>
+</tr>
+</table>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_type-check"><a class="anchor" href="#_type-check"></a><a class="link" href="#_type-check">7.3.2. Type Check</a></h4>
+<div class="paragraph">
+<p>There are basically two ways of testing the type of a variable: <code>typeof</code> and <code>instanceof</code>.
+N4JS supports type comparison via the ECMAScript <code>instanceof</code> operator.
+The operator <code>instanceof</code> retains its standard ECMAScript behavior (e.g. checking whether a value is an instance of a constructor function), but has additional functionality when used with N4JS types.</p>
+</div>
+<div class="paragraph">
+<p>When used with an N4JS class, <code>instanceof</code> also supports checking against an interface. For N4JS enumeration values, it can be used to check whether the value is part of a specific enumeration.</p>
+</div>
+<div class="paragraph">
+<p><code>typeof</code> only returns a string with the name of the ECMAScript type, which is <code>Object</code> for all class instances.</p>
+</div>
+<div class="paragraph">
+<p>N4JS specific <code>string</code> types, that is <code>pathSelector</code> and <code>i18nkey</code> cannot be tested during runtime.
+These types, therefore, must not be used in <code>instanceof</code> expressions.
+The same is true for string-based enums and arrays which cannot be tested during runtime, thus string-based enum and array types are not permitted on the right-hand side of <code>instancesof</code> constructs.
+For all types for which the evaluation result of <code>instanceof</code> could be computed at compile time, the check is unnecessary and thus it is refused by the compiler.
+Using structural types on the right-hand side of <code>instancesof</code> constructs is also not permitted.</p>
+</div>
+<div class="paragraph">
+<p>In order to avoid errors at runtime, the <code>instanceof</code> operator defines appropriate constraints, see <a href="expressions.html#_relational-expression">Relational Expression</a> for details.</p>
+</div>
+<div class="exampleblock">
+<div class="title">Example 71. Type Check Example</div>
+<div class="content">
+<div class="paragraph">
+<p>Given the following classes and variable:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">interface I{}
+class S{}
+class Sub extends S implements I{}
+
+var x = new Sub();</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p><code>typeof x</code> will simply return <code>object</code>. The following table shows the difference between plain JavaScript <code>instanceof</code> and N4JS’s <code>instanceof</code>:</p>
+</div>
+<table class="tableblock frame-all grid-all spread">
+<colgroup>
+<col style="width: 33.3333%;">
+<col style="width: 33.3333%;">
+<col style="width: 33.3334%;">
+</colgroup>
+<thead>
+<tr>
+<th class="tableblock halign-left valign-top">Check</th>
+<th class="tableblock halign-center valign-top">JavaScript</th>
+<th class="tableblock halign-center valign-top">N4JS</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>x instanceof Sub</code></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>true</code></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>true</code></p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>x instanceof S</code></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>true</code></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>true</code></p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>x instanceof I</code></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>false</code></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>true</code></p></td>
+</tr>
+</tbody>
+</table>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="_reflection-meta-information"><a class="anchor" href="#_reflection-meta-information"></a><a class="link" href="#_reflection-meta-information">7.4. Reflection meta-information</a></h3>
+<div class="paragraph">
+<p>All N4JS classes, interfaces and enumerations provide meta-information
+that is used by the runtime and standard library.
+All classifiers (including enums) provide meta-information by means of a static getter <code>n4type</code>.
+Since it is static getter, it is actually an instance getter of the
+constructor (or classifier) of a type, which is the only way to retrieve
+that information in case of interfaces. For enums, this can be retrieved
+from instances as well.</p>
+</div>
+<div class="paragraph">
+<p>This getter is of type <code>N4Class</code> which is a built-in type just like <code>N4Object</code>. It contains the following members:</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><code>fqn</code> </dt>
+<dd>
+<p>The <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>F</mi><mi>Q</mi><mi>N</mi></math> of the type.</p>
+</dd>
+<dt class="hdlist1"><code>n4superType</code> </dt>
+<dd>
+<p>The <code>N4Class</code> of the supertype, may be null if supertype is a not an <code>N4Class</code>.</p>
+</dd>
+<dt class="hdlist1"><code>allImplementedInterfaces</code> </dt>
+<dd>
+<p>List of The <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>F</mi><mi>Q</mi><mi>N</mi></math> of implemented interfaces (transitively
+but without interfaces implemented by supertype)</p>
+</dd>
+<dt class="hdlist1"><code>get isClass</code> </dt>
+<dd>
+<p>True if the type is an N4Class.</p>
+</dd>
+<dt class="hdlist1"><code>get isInterface</code> </dt>
+<dd>
+<p>True if the type is an N4Interface.</p>
+</dd>
+</dl>
+</div>
+<div class="sect3">
+<h4 id="_reflection-for-classes"><a class="anchor" href="#_reflection-for-classes"></a><a class="link" href="#_reflection-for-classes">7.4.1. Reflection for Classes</a></h4>
+<div class="paragraph">
+<p>The meta-information for classes is available by means of <code>N4Object</code>’s static
+getter <code>n4type</code>. Since it is static getter, it is actually an instance getter of the constructor of a type.</p>
+</div>
+<div class="paragraph">
+<p>In addition, the static method <code>of</code> in <code>N4Type</code> is available to retrieve the meta-information for a given instance or
+constructor. This also allows to retrieve meta-information directly for an instance of some class <code>C</code> without having
+the constructor of <code>C</code> available, for example because the constructor is not accessible.</p>
+</div>
+<div class="exampleblock">
+<div class="title">Example 72. Reflection with <code>N4class</code></div>
+<div class="content">
+<div class="paragraph">
+<p>This example demonstrates how these reflective features are accessed:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">class A {}
+class B extends A {}
+var b = new B();
+console.log(B.n4type.fqn);
+console.log(b.constructor.n4type.fqn);
+console.log(b.constructor.n4type.n4superType.fqn);
+console.log(N4Type.of(b));
+console.log(N4Type.of(B.n4type).fqn);</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Assuming this code is defined in file <code>A</code>, this will output</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">A.B
+A.B
+A.A
+A.B
+N4BuiltInClasses.N4Class</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>The built-in types <code>N4Object</code> and <code>N4Class</code> are also accessible.
+They are not defined in a module, thus their <a href="appendix_a_acronyms.html#_acronyms">FQN</a> returns only their simple name.</p>
+</div>
+<div class="exampleblock">
+<div class="title">Example 73. Reflection with Built-In Types</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">console.log('N4Object.n4class.fqn:      ' + N4Object.n4class.fqn)
+console.log('N4Class.n4class.fqn:       ' + N4Class.n4class.fqn)
+
+class A {}
+console.log('A.n4class.fqn:             ' + A.n4class.fqn)
+console.log('A.n4class.n4superType.fqn: ' + A.n4class.n4superType.fqn)</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Assuming this code is defined in file <code>A</code>, this will output</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">N4Object.n4class.fqn:      N4Object
+N4Class.n4class.fqn:       N4Class
+A.n4class.fqn:             A.A
+A.n4class.n4superType.fqn: N4Object</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Note that classes extending <code>Object</code> do not provide the static <code>n4class</code> getter, hat is</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">class B extends Object {}
+console.log('B.n4class.fqn:             ' + B.n4class.fqn)</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>would issue an error as cannot be resolved.</p>
+</div>
+</div>
+</div>
+<div class="exampleblock">
+<div class="title">Example 74. N4Class.of</div>
+<div class="content">
+<div class="paragraph">
+<p>The type has a method to retrieve the meta-information from instances (i.e. or enumeration literals using )
+without using the constructor.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">class C { }
+interface I {}  class IImpl implements I {}
+enum E { L }
+
+var c: C = new C();
+var i: I = new IImpl();
+var e: E = E.L;
+
+console.log(C.n4type.fqn);
+console.log(N4Class.of(c).fqn);
+
+console.log(I.n4type.fqn);
+console.log(N4Class.of(i).fqn);
+
+console.log(E.n4type.fqn);
+console.log(N4EnumType.of(e).fqn);</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_reflection-for-interfaces"><a class="anchor" href="#_reflection-for-interfaces"></a><a class="link" href="#_reflection-for-interfaces">7.4.2. Reflection for Interfaces</a></h4>
+<div class="paragraph">
+<p>The meta-information of an interface <code>X</code> is available via getter <code>n4class</code> defined in the <code>type{X}</code>.
+This field is of type <code>N4Class</code> as well.
+Since an interface cannot have a super classs, the property <code>n4superTypes</code> will always be empty.
+Calling <code>isInterface</code> respectively on the returned <code>N4Class</code> instance will return true.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_reflection-for-enumerations"><a class="anchor" href="#_reflection-for-enumerations"></a><a class="link" href="#_reflection-for-enumerations">7.4.3. Reflection for Enumerations</a></h4>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">var n: number; var b: boolean; var s: string;</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>The meta-information for enumerations is available by means of the getter <code>n4class</code>, either statically by using the enumeration type or (in terms of an instance getter) via a literal.
+Calling <code>isEnum</code> on the returned <code>N4Class</code> instance will return true.</p>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="_conversion-of-primitive-types"><a class="anchor" href="#_conversion-of-primitive-types"></a><a class="link" href="#_conversion-of-primitive-types">7.5. Conversion of primitive types</a></h3>
+<div class="paragraph">
+<p>Conversion between primitives is given as follows:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">var n: number; var b: boolean; var s: string;</code></pre>
+</div>
+</div>
+<table class="tableblock frame-all grid-all spread">
+<colgroup>
+<col style="width: 11.1111%;">
+<col style="width: 11.1111%;">
+<col style="width: 44.4444%;">
+<col style="width: 33.3334%;">
+</colgroup>
+<thead>
+<tr>
+<th class="tableblock halign-center valign-middle">From</th>
+<th class="tableblock halign-center valign-middle">To</th>
+<th class="tableblock halign-left valign-middle">Conversion</th>
+<th class="tableblock halign-center valign-top">Example</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td class="tableblock halign-center valign-middle"><p class="tableblock"><code>string</code></p></td>
+<td class="tableblock halign-center valign-middle"><p class="tableblock"><code>number</code></p></td>
+<td class="tableblock halign-left valign-middle"><p class="tableblock"><code>Number&#8230;&#8203;</code></p></td>
+<td class="tableblock halign-left valign-top"><div><div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">n = Number("42");//42</code></pre>
+</div>
+</div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-middle"><p class="tableblock"><code>string</code></p></td>
+<td class="tableblock halign-center valign-middle"><p class="tableblock"><code>boolean</code></p></td>
+<td class="tableblock halign-left valign-middle"><p class="tableblock"><code>N4Primitives.parseBoolean(&#8230;&#8203;)</code></p></td>
+<td class="tableblock halign-left valign-top"><div><div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js"> b=N4Primitives.parseBoolean("false");</code></pre>
+</div>
+</div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-middle"><p class="tableblock"><code>number</code></p></td>
+<td class="tableblock halign-center valign-middle"><p class="tableblock"><code>boolean</code></p></td>
+<td class="tableblock halign-left valign-middle"><p class="tableblock"><code>Boolean(&#8230;&#8203;)</code></p></td>
+<td class="tableblock halign-left valign-top"><div><div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">b=Boolean(17.5); //true</code></pre>
+</div>
+</div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-middle"><p class="tableblock"><code>number</code></p></td>
+<td class="tableblock halign-center valign-middle"><p class="tableblock"><code>string</code></p></td>
+<td class="tableblock halign-left valign-middle"><p class="tableblock"><code>Number.toString()</code></p></td>
+<td class="tableblock halign-left valign-top"><div><div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">s=42.toString(); //"42"</code></pre>
+</div>
+</div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-middle"><p class="tableblock"><code>boolean</code></p></td>
+<td class="tableblock halign-center valign-middle"><p class="tableblock"><code>number</code></p></td>
+<td class="tableblock halign-left valign-middle"><p class="tableblock"><code>N4Primitives.toNumber(&#8230;&#8203;)</code></p></td>
+<td class="tableblock halign-left valign-top"><div><div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">n=N4Primitives.toNumber(true);</code></pre>
+</div>
+</div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-middle"><p class="tableblock"><code>boolean</code></p></td>
+<td class="tableblock halign-center valign-middle"><p class="tableblock"><code>string</code></p></td>
+<td class="tableblock halign-left valign-middle"><p class="tableblock"><code>Boolean.toString()</code></p></td>
+<td class="tableblock halign-left valign-top"><div><div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js"> s=true.toString();//"true" }</code></pre>
+</div>
+</div></div></td>
+</tr>
+</tbody>
+</table>
+<div class="paragraph">
+<p>Remarks:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>ECMAScript doesn’t define explicit conversion from string content.
+Implicit handling states all strings with <math xmlns="http://www.w3.org/1998/Math/MathML"><mo>&gt;</mo><mn>0</mn><mo>=</mo><mo>=</mo><mi>t</mi><mi>r</mi><mi>u</mi><mi>e</mi></math>. <code>N4Primitives.parseBoolean(x)</code> yields true for <code>x.trim().toLowerCase().equals("true")</code></p>
+</li>
+<li>
+<p>The call to <code>Boolean(..)</code> for the arguments <code>0</code>, <code>-0</code>, <code>null</code>, <code>false</code>, <code>NaN</code>, <code>undefined</code> and <code>""</code> evaluate to <code>false</code>.
+All other values evaluate to <code>true</code>.</p>
+</li>
+<li>
+<p><code>Number</code> has several methods for converting a value to string [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.S15.7.4)</a>]: <code>toExponential()</code>, to <code>Fixed()</code>, <code>toPrecision()</code>.</p>
+</li>
+<li>
+<p>ECMAScript doesn’t define explicit conversion from boolean to number.
+Implicit handling states true <math xmlns="http://www.w3.org/1998/Math/MathML"><mo>→</mo></math> 1 and false <math xmlns="http://www.w3.org/1998/Math/MathML"><mo>→</mo></math> 0, which <code>N4Primitives.toNumber()</code> yields.</p>
+</li>
+</ol>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div id="footer">
+<div id="footer-text">
+Version 0.9<br>
+Last updated 2019-08-07 15:02:40 CEST
+</div>
+</div>
+<!-- ************* docinfo-footer *************************************************************** -->
+<div class="Grid social" style="color:#d5dfea">
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <h2>Quick Links</h2>
+    <ul>
+      <li><a href="../downloads.html">Download</a></li>
+      <li><a href="../userguides/index.html">Documentation</a></li>
+      <li><a href="https://github.com/eclipse/n4js/">Source</a></li>
+      <li><a href="https://github.com/eclipse/n4js/issues">Issues</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="https://www.eclipse.org/forums/index.php/f/365/">Forum</a></li>
+      <li><a href="http://n4js.blogspot.de/">Blog</a></li>
+      <li><a href="https://dev.eclipse.org/mailman/listinfo/n4js-dev">Mailing List</a></li>
+      <li><a href="https://projects.eclipse.org/projects/technology.n4js">Eclipse Project Page</a></li>
+      <li><a href="https://twitter.com/n4jsdev">Tweets by n4jsdev</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="http://www.eclipse.org/">Eclipse Home</a></li>
+      <li><a href="http://www.eclipse.org/legal/privacy.php">Privacy Policy</a></li>
+      <li><a href="http://www.eclipse.org/legal/termsofuse.php">Terms of Use</a></li>
+      <li><a href="http://www.eclipse.org/legal/copyright.php">Copyright Agent</a></li>
+      <li><a href="http://www.eclipse.org/legal/">Legal</a></li>
+    </ul>
+  </div>
+  <div style="clear: both; height: 0; overflow: hidden;"></div>
+</div>
+
+<!-- ************* UI Scripts ************* -->
+<script type="text/javascript" src="scripts/back-to-top.js"></script>
+
+<script type="text/javascript" src="scripts/treeview.js"></script>
+<script type="text/javascript" src="scripts/toc.js"></script>
+
+<!-- ************* Prism.js Syntax Highlighting ************* -->
+<script src="scripts/prism.js"></script>
+
+<script type="text/javascript">
+	// Add the 'toclist' id for search function
+	$(".toc2 > ul").attr('id', 'toclist');
+	// Generate a Search input form
+	$("#toclist > li:first-of-type").before('<input type="text" id="pagesearch" onkeyup="search()" placeholder="Search for section...">');
+	$("#toclist > li:first-of-type").before('<i id="clear" class="fa fa-times-circle-o"></i>');
+	$("#clear").click(function(){
+	    $("#pagesearch").val('');
+	    search();
+	    $('.toc2 > ul').treeView('collapseAll');
+	});
+	// intialize Treeview.js
+	$(".toc2 > ul").treeView();
+	// Initialize Scrollspy
+</script>
+<!-- ************* docinfo-footer *************************************************************** -->
+</body>
+</html>
\ No newline at end of file
diff --git a/spec/expressions.html b/spec/expressions.html
new file mode 100644
index 0000000..cd7b864
--- /dev/null
+++ b/spec/expressions.html
@@ -0,0 +1,4080 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="generator" content="Asciidoctor 1.5.5">
+<meta name="author" content="2019-08-07 15:02:40 CEST">
+<title>N4JS Language Specification</title>
+<link rel="stylesheet" href="styles/spec.min.css">
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.6.3/css/font-awesome.min.css">
+<!-- ************* docinfo ******************************************************************* -->
+
+
+<!-- ************* Favicon ************-->
+<link rel="icon" href="images/favicon.ico" />
+
+<!-- ************* Back-to-top JQuery ************* -->
+<script src="https://code.jquery.com/jquery-1.12.4.js"></script>
+<script src="https://code.jquery.com/ui/1.12.0/jquery-ui.js"></script>
+
+
+<link href="styles/prism.min.css" rel="stylesheet" />
+<script type="text/javascript" async
+  src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2/MathJax.js?config=TeX-MML-AM_CHTML">
+</script>
+
+<!-- ************* Styles ************* -->
+<link rel="stylesheet" type="text/css" href="styles/n4jsspec-adoc.css">
+
+
+<!-- ****************** NavBar ****************** -->
+<div id="menubar">
+	<div class="banner">
+        <a href="https://www.eclipse.org/n4js/#"><img id="logo" src="images/n4js-logo.png" alt="Eclipse N4JS"></a>
+    </div>
+<ul>
+  <li><a href="index.html">Index</a></li>
+</ul>
+</div>
+<!-- ************* docinfo ******************************************************************* -->
+<style>
+      .admonitionblock td.icon .icon-todo:before{content:"\f249";color:#f4ee42}
+    </style>
+</head>
+<body class="book toc2 toc-left">
+<div id="header">
+<h1>N4JS Language Specification</h1>
+<div class="details">
+<span id="author" class="author">2019-08-07 15:02:40 CEST</span><br>
+<span id="revnumber">version 0.9</span>
+</div>
+<div id="toc" class="toc2">
+<div id="toctitle">Table of Contents</div>
+<ul class="sectlevel1">
+<li><a href="introduction.html#_introduction">1. Introduction</a>
+<ul class="sectlevel2">
+<li><a href="introduction.html#_notation">1.1. Notation</a>
+<ul class="sectlevel3">
+<li><a href="introduction.html#_grammar-notation">1.1.1. Grammar Notation</a></li>
+<li><a href="introduction.html#_type-judgments-and-rules-and-constraints-notation">1.1.2. Type Judgments and Rules and Constraints Notation</a>
+<ul class="sectlevel4">
+<li><a href="introduction.html#_typing-rules-and-judgments">1.1.2.1. Typing Rules and Judgments</a></li>
+<li><a href="introduction.html#_types-of-an-element">1.1.2.2. Types of an Element</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="introduction.html#_auxiliary-functions">1.2. Auxiliary Functions</a>
+<ul class="sectlevel3">
+<li><a href="introduction.html#_binding">1.2.1. Binding</a></li>
+<li><a href="introduction.html#_merging-types">1.2.2. Merging Types</a>
+<ul class="sectlevel4">
+<li><a href="introduction.html#_logic-formulas">1.2.2.1. Logic Formulas</a></li>
+</ul>
+</li>
+<li><a href="introduction.html#_symbols-and-font-convention">1.2.3. Symbols and Font Convention</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="grammar.html#_grammar">2. Grammar</a>
+<ul class="sectlevel2">
+<li><a href="grammar.html#_lexical-conventions">2.1. Lexical Conventions</a>
+<ul class="sectlevel3">
+<li><a href="grammar.html#_identifier-names-and-identifiers">2.1.1. Identifier Names and Identifiers</a></li>
+<li><a href="grammar.html#_this-keyword">2.1.2. This Keyword</a></li>
+<li><a href="grammar.html#_regular-expression-literals">2.1.3. Regular Expression Literals</a></li>
+<li><a href="grammar.html#_automatic-semicolon-insertion">2.1.4. Automatic Semicolon Insertion</a></li>
+<li><a href="grammar.html#_jsdoc">2.1.5. JSDoc</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="names.html#_names">3. Names</a>
+<ul class="sectlevel2">
+<li><a href="names.html#_access-control">3.1. Access Control</a></li>
+<li><a href="names.html#_accessibility-of-types-top-level-variables-and-function-declarations">3.2. Accessibility of Types, Top-Level Variables and Function Declarations</a>
+<ul class="sectlevel3">
+<li><a href="names.html#_accessibility-of-members">3.2.1. Accessibility of Members</a></li>
+<li><a href="names.html#_valid-names">3.2.2. Valid Names</a></li>
+<li><a href="names.html#_qualified-names">3.2.3. Qualified Names</a></li>
+<li><a href="names.html#_name-duplicates">3.2.4. Name Duplicates</a>
+<ul class="sectlevel4">
+<li><a href="names.html#_lexical-environment">3.2.4.1. Lexical Environment</a></li>
+<li><a href="names.html#_duplicates-and-shadowing">3.2.4.2. Duplicates and Shadowing</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="types.html#_types">4. Types</a>
+<ul class="sectlevel2">
+<li><a href="types.html#_overview">4.1. Overview</a></li>
+<li><a href="types.html#_type-expressions">4.2. Type Expressions</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_syntax">4.2.1. Syntax</a></li>
+<li><a href="types.html#_properties">4.2.2. Properties</a></li>
+<li><a href="types.html#_semantics">4.2.3. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_type-inference">4.3. Type Inference</a></li>
+<li><a href="types.html#_generic-and-parameterized-types">4.4. Generic and Parameterized Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_generic-types">4.4.1. Generic Types</a></li>
+<li><a href="types.html#_type-variables">4.4.2. Type Variables</a></li>
+<li><a href="types.html#_parameterized-types">4.4.3. Parameterized Types</a></li>
+</ul>
+</li>
+<li><a href="types.html#_primitive-ecmascript-types">4.5. Primitive ECMAScript Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_undefined-type">4.5.1. Undefined Type</a></li>
+<li><a href="types.html#_null-type">4.5.2. Null Type</a></li>
+<li><a href="types.html#_primitive-boolean-type">4.5.3. Primitive Boolean Type</a></li>
+<li><a href="types.html#_primitive-string-type">4.5.4. Primitive String Type</a></li>
+<li><a href="types.html#_primitive-number-type">4.5.5. Primitive Number Type</a></li>
+<li><a href="types.html#_primitive-type-int">4.5.6. Primitive Type int</a></li>
+<li><a href="types.html#_primitive-symbol-type">4.5.7. Primitive Symbol Type</a></li>
+</ul>
+</li>
+<li><a href="types.html#_primitive-n4js-types">4.6. Primitive N4JS Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_any-type">4.6.1. Any Type</a>
+<ul class="sectlevel4">
+<li><a href="types.html#any-type-semantics">4.6.1.1. Semantics</a></li>
+<li><a href="types.html#any-type-type-inference">4.6.1.2. Type Inference</a>
+<ul class="sectlevel5">
+<li><a href="types.html#_default-type-of-variables">4.6.1.2.1. Default Type of Variables</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="types.html#_void-type">4.6.2. Void Type</a>
+<ul class="sectlevel4">
+<li><a href="types.html#void-type-semantics">4.6.2.1. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_unknown-type">4.6.3. Unknown Type</a></li>
+<li><a href="types.html#_primitive-pathselector-and-i18nkey">4.6.4. Primitive Pathselector and I18nKey</a>
+<ul class="sectlevel4">
+<li><a href="types.html#pathselector-semantics">4.6.4.1. Semantics</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="types.html#_built-in-ecmascript-object-types">4.7. Built-in ECMAScript Object Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#ECMAScript-objects-semantics">4.7.1. Semantics</a></li>
+<li><a href="types.html#_object-type">4.7.2. Object Type</a></li>
+<li><a href="types.html#_function-object-type">4.7.3. Function-Object-Type</a></li>
+<li><a href="types.html#_array-object-type">4.7.4. Array Object Type</a></li>
+<li><a href="types.html#_string-object-type">4.7.5. String Object Type</a></li>
+<li><a href="types.html#_boolean-object-type">4.7.6. Boolean Object Type</a></li>
+<li><a href="types.html#_number-object-type">4.7.7. Number Object Type</a></li>
+<li><a href="types.html#_global-object-type">4.7.8. Global Object Type</a></li>
+<li><a href="types.html#_symbol">4.7.9. Symbol</a></li>
+<li><a href="types.html#_promise">4.7.10. Promise</a></li>
+<li><a href="types.html#_iterator-interface">4.7.11. Iterator Interface</a></li>
+<li><a href="types.html#_iterable-interface">4.7.12. Iterable Interface</a></li>
+</ul>
+</li>
+<li><a href="types.html#_built-in-n4js-types">4.8. Built-In N4JS Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_n4object">4.8.1. N4Object</a>
+<ul class="sectlevel4">
+<li><a href="types.html#N4Object-semantics">4.8.1.1. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_n4class">4.8.2. N4Class</a></li>
+<li><a href="types.html#IterableN">4.8.3. IterableN</a></li>
+</ul>
+</li>
+<li><a href="types.html#_type-modifiers">4.9. Type Modifiers</a>
+<ul class="sectlevel3">
+<li><a href="types.html#Type_Modifiers_Dynamic">4.9.1. Dynamic</a></li>
+<li><a href="types.html#_optional-return-types">4.9.2. Optional Return Types</a></li>
+</ul>
+</li>
+<li><a href="types.html#_union-and-intersection-type-composed-types">4.10. Union and Intersection Type (Composed Types)</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_union-type">4.10.1. Union Type</a>
+<ul class="sectlevel4">
+<li><a href="types.html#union-type-syntax">4.10.1.1. Syntax</a></li>
+<li><a href="types.html#union-type-semantics">4.10.1.2. Semantics</a></li>
+<li><a href="types.html#_warnings">4.10.1.3. Warnings</a></li>
+</ul>
+</li>
+<li><a href="types.html#_intersection-type">4.10.2. Intersection Type</a>
+<ul class="sectlevel4">
+<li><a href="types.html#intersection-type-syntax">4.10.2.1. Syntax</a></li>
+<li><a href="types.html#intersection-type-semantics">4.10.2.2. Semantics</a></li>
+<li><a href="types.html#_warnings-2">4.10.2.3. Warnings</a></li>
+</ul>
+</li>
+<li><a href="types.html#_composed-types-in-wildcards">4.10.3. Composed Types in Wildcards</a></li>
+<li><a href="types.html#_property-access-for-composed-types">4.10.4. Property Access for Composed Types</a>
+<ul class="sectlevel4">
+<li><a href="types.html#_properties-of-union-type">4.10.4.1. Properties of Union Type</a>
+<ul class="sectlevel5">
+<li><a href="types.html#_remarks-on-union-type-s-members">4.10.4.1.1. Remarks on union type’s members:</a></li>
+</ul>
+</li>
+<li><a href="types.html#_properties-of-intersection-type">4.10.4.2. Properties of Intersection Type</a>
+<ul class="sectlevel5">
+<li><a href="types.html#_remarks-on-intersection-type-s-methods">4.10.4.2.1. Remarks on intersection type’s methods:</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="types.html#_constructor-and-classifier-type">4.11. Constructor and Classifier Type</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_syntax-3">4.11.1. Syntax</a></li>
+<li><a href="types.html#_semantics-2">4.11.2. Semantics</a></li>
+<li><a href="types.html#_constructors-and-prototypes-in-ecmascript-2015">4.11.3. Constructors and Prototypes in ECMAScript 2015</a></li>
+</ul>
+</li>
+<li><a href="types.html#_this-type">4.12. This Type</a>
+<ul class="sectlevel3">
+<li><a href="types.html#this-type-syntax">4.12.1. Syntax</a></li>
+<li><a href="types.html#this-keyword-semantics">4.12.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_enums">4.13. Enums</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_enums-n4js">4.13.1. Enums (N4JS)</a>
+<ul class="sectlevel4">
+<li><a href="types.html#enums-syntax">4.13.1.1. Syntax</a></li>
+<li><a href="types.html#enums-semantics">4.13.1.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_string-based-enums">4.13.2. String-Based Enums</a></li>
+</ul>
+</li>
+<li><a href="types.html#_short-hand-syntax">4.14. Short-Hand Syntax</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_array-short-hand-syntax">4.14.1. Array Short-Hand Syntax</a></li>
+<li><a href="types.html#_iterablen-short-hand-syntax">4.14.2. IterableN Short-Hand Syntax</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="classifiers.html#_classifiers">5. Classifiers</a>
+<ul class="sectlevel2">
+<li><a href="classifiers.html#_n4js-specific-classifiers">5.1. N4JS Specific Classifiers</a>
+<ul class="sectlevel3">
+<li><a href="classifiers.html#_properties-2">5.1.1. Properties</a></li>
+<li><a href="classifiers.html#_common-semantics-of-classifiers">5.1.2. Common Semantics of Classifiers</a></li>
+<li><a href="classifiers.html#_classes">5.1.3. Classes</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_definition-of-classes">5.1.3.1. Definition of Classes</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#class-syntax">5.1.3.1.1. Syntax</a></li>
+<li><a href="classifiers.html#class-properties">5.1.3.1.2. Properties</a></li>
+<li><a href="classifiers.html#class-type-inference">5.1.3.1.3. Type Inference</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#class-semantics">5.1.3.2. Semantics</a></li>
+<li><a href="classifiers.html#_final-modifier">5.1.3.3. Final Modifier</a></li>
+<li><a href="classifiers.html#_abstract-classes">5.1.3.4. Abstract Classes</a></li>
+<li><a href="classifiers.html#_non-instantiable-classes">5.1.3.5. Non-Instantiable Classes</a></li>
+<li><a href="classifiers.html#_superclass">5.1.3.6. Superclass</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_interfaces">5.1.4. Interfaces</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_definition-of-interfaces">5.1.4.1. Definition of Interfaces</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#interfaces-syntax">5.1.4.1.1. Syntax</a></li>
+<li><a href="classifiers.html#interfaces-properties">5.1.4.1.2. Properties</a></li>
+<li><a href="classifiers.html#interfaces-type-inference">5.1.4.1.3. Type Inference</a></li>
+<li><a href="classifiers.html#interfaces-semantics">5.1.4.1.4. Semantics</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="classifiers.html#_generic-classifiers">5.1.5. Generic Classifiers</a></li>
+<li><a href="classifiers.html#sec:definition-site-variance">5.1.6. Definition-Site Variance</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_members">5.2. Members</a>
+<ul class="sectlevel3">
+<li><a href="classifiers.html#_syntax-4">5.2.1. Syntax</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_properties-3">5.2.1.1. Properties</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_semantics-3">5.2.2. Semantics</a></li>
+<li><a href="classifiers.html#_methods">5.2.3. Methods</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_syntax-5">5.2.3.1. Syntax</a></li>
+<li><a href="classifiers.html#_properties-4">5.2.3.2. Properties</a></li>
+<li><a href="classifiers.html#_semantics-4">5.2.3.3. Semantics</a></li>
+<li><a href="classifiers.html#_final-methods">5.2.3.4. Final Methods</a></li>
+<li><a href="classifiers.html#_abstract-methods">5.2.3.5. Abstract Methods</a></li>
+<li><a href="classifiers.html#_generic-methods">5.2.3.6. Generic Methods</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_default-methods-in-interfaces">5.2.4. Default Methods in Interfaces</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_asynchronous-methods">5.2.4.1. Asynchronous Methods</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_constructors">5.2.5. Constructors</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_structural-this-type-in-constructor">5.2.5.1. Structural This Type in Constructor</a></li>
+<li><a href="classifiers.html#spec-constructor">5.2.5.2. @Spec Constructor</a></li>
+<li><a href="classifiers.html#_callable-constructors">5.2.5.3. Callable Constructors</a></li>
+<li><a href="classifiers.html#_covariant-constructors">5.2.5.4. Covariant Constructors</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_data-fields">5.2.6. Data Fields</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#data-fields-syntax">5.2.6.1. Syntax</a></li>
+<li><a href="classifiers.html#data-fields-properties">5.2.6.2. Properties</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#data-fields-semantics">5.2.6.2.1. Semantics</a></li>
+<li><a href="classifiers.html#data-fields-type-inference">5.2.6.2.2. Type Inference</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_assignment-modifiers">5.2.6.3. Assignment Modifiers</a></li>
+<li><a href="classifiers.html#_field-accessors-getter-setter">5.2.6.4. Field Accessors (Getter/Setter)</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#field-acessors-syntax">5.2.6.4.1. Syntax</a></li>
+<li><a href="classifiers.html#field-acessors-properties">5.2.6.4.2. Properties</a></li>
+<li><a href="classifiers.html#field-accessors-semantics">5.2.6.4.3. Semantics</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#optional-fields">5.2.6.5. Optional Fields</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#_syntax-6">5.2.6.5.1. Syntax</a></li>
+<li><a href="classifiers.html#_semantics-5">5.2.6.5.2. Semantics</a></li>
+<li><a href="classifiers.html#_background">5.2.6.5.3. Background</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="classifiers.html#_static-members">5.2.7. Static Members</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_access-from-and-to-static-members">5.2.7.1. Access From and To Static Members</a></li>
+<li><a href="classifiers.html#_generic-static-methods">5.2.7.2. Generic static methods</a></li>
+<li><a href="classifiers.html#_static-members-of-interfaces">5.2.7.3. Static Members of Interfaces</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_redefinition-of-members">5.2.8. Redefinition of Members</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_overriding-of-members">5.2.8.1. Overriding of Members</a></li>
+<li><a href="classifiers.html#_implementation-of-members">5.2.8.2. Implementation of Members</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#_member-consumption">5.2.8.2.1. Member Consumption</a></li>
+<li><a href="classifiers.html#_member-implementation">5.2.8.2.2. Member Implementation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="classifiers.html#_structural-typing">5.3. Structural Typing</a>
+<ul class="sectlevel3">
+<li><a href="classifiers.html#_syntax-7">5.3.1. Syntax</a></li>
+<li><a href="classifiers.html#_definition-site-structural-typing">5.3.2. Definition Site Structural Typing</a></li>
+<li><a href="classifiers.html#_use-site-structural-typing">5.3.3. Use-Site Structural Typing</a></li>
+<li><a href="classifiers.html#structural-readWriteInit-field-typing">5.3.4. Structural Read-only, Write-only and Initializer Field Typing</a></li>
+<li><a href="classifiers.html#_public-setter-annotated-with-code-providesinitializer-code">5.3.5. Public Setter Annotated With <code>ProvidesInitializer</code></a></li>
+<li><a href="classifiers.html#_structural-types-with-optional-fields">5.3.6. Structural Types With Optional Fields</a></li>
+<li><a href="classifiers.html#_structural-types-with-access-modifier">5.3.7. Structural Types With Access Modifier</a></li>
+<li><a href="classifiers.html#_structural-types-with-additional-members">5.3.8. Structural Types With Additional Members</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_syntax-8">5.3.8.1. Syntax</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#_semantics-6">5.3.8.1.1. Semantics</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="functions.html#_functions">6. Functions</a>
+<ul class="sectlevel2">
+<li><a href="functions.html#_function-type">6.1. Function Type</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_properties-5">6.1.1. Properties</a></li>
+<li><a href="functions.html#function-type-inference">6.1.2. Type Inference</a></li>
+<li><a href="functions.html#_autoboxing-of-function-type">6.1.3. Autoboxing of Function Type</a></li>
+<li><a href="functions.html#_arguments-object">6.1.4. Arguments Object</a></li>
+</ul>
+</li>
+<li><a href="functions.html#_ecmascript-5-function-definition">6.2. ECMAScript 5 Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_function-declaration">6.2.1. Function Declaration</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#_syntax-9">6.2.1.1. Syntax</a></li>
+<li><a href="functions.html#_semantics-8">6.2.1.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="functions.html#_function-expression">6.2.2. Function Expression</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#function-expression-syntax">6.2.2.1. Syntax</a></li>
+<li><a href="functions.html#_semantics-and-type-inference">6.2.2.2. Semantics and Type Inference</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="functions.html#_ecmascript-2015-function-definition">6.3. ECMAScript 2015 Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_formal-parameters">6.3.1. Formal Parameters</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#Type_Modifiers_Optional">6.3.1.1. Optional Parameters</a></li>
+<li><a href="functions.html#Type_Modifiers_Default">6.3.1.2. Default Parameters</a></li>
+<li><a href="functions.html#Type_Modifiers_Variadic">6.3.1.3. Variadic</a></li>
+</ul>
+</li>
+<li><a href="functions.html#_generator-functions">6.3.2. Generator Functions</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#generator-functions-syntax">6.3.2.1. Syntax</a></li>
+<li><a href="functions.html#generator-functions-semantics">6.3.2.2. Semantics</a></li>
+<li><a href="functions.html#_generator-arrow-functions">6.3.2.3. Generator Arrow Functions</a></li>
+</ul>
+</li>
+<li><a href="functions.html#_arrow-function-expression">6.3.3. Arrow Function Expression</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#arrow-function-expression-syntax">6.3.3.1. Syntax</a></li>
+<li><a href="functions.html#arrow-function-expression-semantics-and-type-inference">6.3.3.2. Semantics and Type Inference</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="functions.html#_ecmascript-proposals-function-definition">6.4. ECMAScript Proposals Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_asynchronous-functions">6.4.1. Asynchronous Functions</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#asynchronous-functions-syntax">6.4.1.1. Syntax</a></li>
+<li><a href="functions.html#asynchronous-functions-semantics">6.4.1.2. Semantics</a></li>
+<li><a href="functions.html#_asynchronous-arrow-functions">6.4.1.3. Asynchronous Arrow Functions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="functions.html#_n4js-extended-function-definition">6.5. N4JS Extended Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_generic-functions">6.5.1. Generic Functions</a></li>
+<li><a href="functions.html#_promisifiable-functions">6.5.2. Promisifiable Functions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_conversions-and-reflection">7. Conversions and Reflection</a>
+<ul class="sectlevel2">
+<li><a href="conversions_and_reflection.html#_autoboxing-and-coercing">7.1. Autoboxing and Coercing</a>
+<ul class="sectlevel3">
+<li><a href="conversions_and_reflection.html#_coercing">7.1.1. Coercing</a></li>
+<li><a href="conversions_and_reflection.html#_autoboxing-of-primitives">7.1.2. Autoboxing of Primitives</a></li>
+<li><a href="conversions_and_reflection.html#_autoboxing-of-function-expressions-and-declarations">7.1.3. Autoboxing of Function Expressions and Declarations</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_auto-conversion-of-objects">7.2. Auto-Conversion of Objects</a>
+<ul class="sectlevel3">
+<li><a href="conversions_and_reflection.html#_auto-conversion-of-class-instances">7.2.1. Auto-Conversion of Class Instances</a>
+<ul class="sectlevel4">
+<li><a href="conversions_and_reflection.html#_auto-conversion-of-interface-instances">7.2.1.1. Auto-Conversion of Interface Instances</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_auto-conversion-of-enum-literals">7.2.2. Auto-Conversion of Enum Literals</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_type-cast-and-type-check">7.3. Type Cast and Type Check</a>
+<ul class="sectlevel3">
+<li><a href="conversions_and_reflection.html#_type-cast">7.3.1. Type Cast</a></li>
+<li><a href="conversions_and_reflection.html#_type-check">7.3.2. Type Check</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_reflection-meta-information">7.4. Reflection meta-information</a>
+<ul class="sectlevel3">
+<li><a href="conversions_and_reflection.html#_reflection-for-classes">7.4.1. Reflection for Classes</a></li>
+<li><a href="conversions_and_reflection.html#_reflection-for-interfaces">7.4.2. Reflection for Interfaces</a></li>
+<li><a href="conversions_and_reflection.html#_reflection-for-enumerations">7.4.3. Reflection for Enumerations</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_conversion-of-primitive-types">7.5. Conversion of primitive types</a></li>
+</ul>
+</li>
+<li><a href="#_expressions">8. Expressions</a>
+<ul class="sectlevel2">
+<li><a href="#_ecmascript-5-expressions">8.1. ECMAScript 5 Expressions</a>
+<ul class="sectlevel3">
+<li><a href="#_the-this-literal">8.1.1. The this Literal</a></li>
+<li><a href="#_identifier">8.1.2. Identifier</a></li>
+<li><a href="#_literals">8.1.3. Literals</a>
+<ul class="sectlevel4">
+<li><a href="#_integer-literals">8.1.3.1. Integer Literals</a></li>
+</ul>
+</li>
+<li><a href="#_array-literal">8.1.4. Array Literal</a></li>
+<li><a href="#_object-literal">8.1.5. Object Literal</a>
+<ul class="sectlevel4">
+<li><a href="#_properties-6">8.1.5.1. Properties</a></li>
+<li><a href="#_scoping-and-linking">8.1.5.2. Scoping and linking</a></li>
+</ul>
+</li>
+<li><a href="#_parenthesized-expression-and-grouping-operator">8.1.6. Parenthesized Expression and Grouping Operator</a></li>
+<li><a href="#_property-accessors">8.1.7. Property Accessors</a>
+<ul class="sectlevel4">
+<li><a href="#properties-1">8.1.7.1. Properties</a></li>
+</ul>
+</li>
+<li><a href="#_new-expression">8.1.8. New Expression</a></li>
+<li><a href="#_function-expression-2">8.1.9. Function Expression</a></li>
+<li><a href="#_function-calls">8.1.10. Function Calls</a></li>
+<li><a href="#_postfix-expression">8.1.11. Postfix Expression</a></li>
+<li><a href="#_unary-expression">8.1.12. Unary Expression</a></li>
+<li><a href="#_multiplicative-expression">8.1.13. Multiplicative Expression</a></li>
+<li><a href="#_additive-expression">8.1.14. Additive Expression</a>
+<ul class="sectlevel4">
+<li><a href="#type-inference-10">8.1.14.1. Type Inference</a></li>
+</ul>
+</li>
+<li><a href="#_bitwise-shift-expression">8.1.15. Bitwise Shift Expression</a></li>
+<li><a href="#_relational-expression">8.1.16. Relational Expression</a></li>
+<li><a href="#_equality-expression">8.1.17. Equality Expression</a></li>
+<li><a href="#_binary-bitwise-expression">8.1.18. Binary Bitwise Expression</a></li>
+<li><a href="#_binary-logical-expression">8.1.19. Binary Logical Expression</a></li>
+<li><a href="#_conditional-expression">8.1.20. Conditional Expression</a></li>
+<li><a href="#_assignment-expression">8.1.21. Assignment Expression</a></li>
+<li><a href="#_comma-expression">8.1.22. Comma Expression</a></li>
+</ul>
+</li>
+<li><a href="#_ecmascript-6-expressions">8.2. ECMAScript 6 Expressions</a>
+<ul class="sectlevel3">
+<li><a href="#_the-super-keyword">8.2.1. The super Keyword</a></li>
+</ul>
+</li>
+<li><a href="#_ecmascript-7-expressions">8.3. ECMAScript 7 Expressions</a>
+<ul class="sectlevel3">
+<li><a href="#_await-expression">8.3.1. Await Expression</a></li>
+</ul>
+</li>
+<li><a href="#_n4js-specific-expressions">8.4. N4JS Specific Expressions</a>
+<ul class="sectlevel3">
+<li><a href="#_class-expression">8.4.1. Class Expression</a></li>
+<li><a href="#_cast-as-expression">8.4.2. Cast (As) Expression</a>
+<ul class="sectlevel4">
+<li><a href="#cast-as-expression-semantics-type-inference">8.4.2.1. Semantics and Type Inference</a></li>
+</ul>
+</li>
+<li><a href="#Import_Calls">8.4.3. Import Calls</a></li>
+</ul>
+</li>
+<li><a href="#compile-time-expressions">8.5. Compile-Time Expressions</a></li>
+</ul>
+</li>
+<li><a href="statements.html#_statements">9. Statements</a>
+<ul class="sectlevel2">
+<li><a href="statements.html#_ecmascript-5-statements">9.1. ECMAScript 5 Statements</a>
+<ul class="sectlevel3">
+<li><a href="statements.html#_function-or-field-accessor-bodies">9.1.1. Function or Field Accessor Bodies</a></li>
+<li><a href="statements.html#_variable-statement">9.1.2. Variable Statement</a></li>
+<li><a href="statements.html#_if-statement">9.1.3. If Statement</a></li>
+<li><a href="statements.html#_iteration-statements">9.1.4. Iteration Statements</a></li>
+<li><a href="statements.html#_return-statement">9.1.5. Return Statement</a></li>
+<li><a href="statements.html#_with-statement">9.1.6. With Statement</a></li>
+<li><a href="statements.html#_switch-statement">9.1.7. Switch Statement</a></li>
+<li><a href="statements.html#_throw-try-and-catch-statements">9.1.8. Throw, Try, and Catch Statements</a></li>
+<li><a href="statements.html#_debugger-statement">9.1.9. Debugger Statement</a></li>
+</ul>
+</li>
+<li><a href="statements.html#_ecmascript-6-statements">9.2. ECMAScript 6 Statements</a>
+<ul class="sectlevel3">
+<li><a href="statements.html#_let">9.2.1. Let</a></li>
+<li><a href="statements.html#_const">9.2.2. Const</a></li>
+<li><a href="statements.html#_for-of-statement">9.2.3. <code>for &#8230;&#8203; of</code> statement</a></li>
+<li><a href="statements.html#_import-statement">9.2.4. Import Statement</a>
+<ul class="sectlevel4">
+<li><a href="statements.html#Dynamic_Imports">9.2.4.1. Dynamic Imports</a></li>
+<li><a href="statements.html#_immutabilaty-of-imports">9.2.4.2. Immutabilaty of Imports</a></li>
+</ul>
+</li>
+<li><a href="statements.html#_export-statement">9.2.5. Export Statement</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="annotations.html#_annotations">10. Annotations</a>
+<ul class="sectlevel2">
+<li><a href="annotations.html#_introduction-2">10.1. Introduction</a>
+<ul class="sectlevel3">
+<li><a href="annotations.html#_syntax-13">10.1.1. Syntax</a></li>
+<li><a href="annotations.html#_properties-7">10.1.2. Properties</a></li>
+<li><a href="annotations.html#_element-specific-annotations">10.1.3. Element-Specific Annotations</a></li>
+<li><a href="annotations.html#_general-annotations">10.1.4. General Annotations</a>
+<ul class="sectlevel4">
+<li><a href="annotations.html#_idebug">10.1.4.1. IDEBUG</a></li>
+</ul>
+</li>
+<li><a href="annotations.html#idebug-syntax">10.1.5. Syntax</a>
+<ul class="sectlevel4">
+<li><a href="annotations.html#_semantics-11">10.1.5.1. Semantics</a></li>
+<li><a href="annotations.html#_suppress-warnings">10.1.5.2. Suppress Warnings</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="annotations.html#_declaration-of-annotations">10.2. Declaration of Annotations</a></li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_extended-fetaures">11. Extended Fetaures</a>
+<ul class="sectlevel2">
+<li><a href="extended_fetaures.html#_array-and-object-destructuring">11.1. Array and Object Destructuring</a>
+<ul class="sectlevel3">
+<li><a href="extended_fetaures.html#_syntax-14">11.1.1. Syntax</a></li>
+<li><a href="extended_fetaures.html#_semantics-12">11.1.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_dependency-injection">11.2. Dependency Injection</a>
+<ul class="sectlevel3">
+<li><a href="extended_fetaures.html#_di-components-and-injectors">11.2.1. DI Components and Injectors</a>
+<ul class="sectlevel4">
+<li><a href="extended_fetaures.html#_dicomponent-relations">11.2.1.1. DIComponent Relations</a></li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_binders-and-bindings">11.2.2. Binders and Bindings</a></li>
+<li><a href="extended_fetaures.html#_injection-points">11.2.3. Injection Points</a>
+<ul class="sectlevel4">
+<li><a href="extended_fetaures.html#_field-injection">11.2.3.1. Field Injection</a></li>
+<li><a href="extended_fetaures.html#_constructor-injection">11.2.3.2. Constructor Injection</a></li>
+<li><a href="extended_fetaures.html#_method-injection">11.2.3.3. Method Injection</a>
+<ul class="sectlevel5">
+<li><a href="extended_fetaures.html#_provider">11.2.3.3.1. Provider</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_n4js-di-life-cycle-and-scopes">11.2.4. N4JS DI Life Cycle and Scopes</a>
+<ul class="sectlevel4">
+<li><a href="extended_fetaures.html#_injection-cylces">11.2.4.1. Injection Cylces</a></li>
+<li><a href="extended_fetaures.html#_default-scope">11.2.4.2. Default Scope</a></li>
+<li><a href="extended_fetaures.html#_singleton-scope">11.2.4.3. Singleton Scope</a></li>
+<li><a href="extended_fetaures.html#_per-injection-chain-singleton">11.2.4.4. Per Injection Chain Singleton</a></li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_validation-of-callsites-targeting-n4injector-methods">11.2.5. Validation of callsites targeting N4Injector methods</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-annotations">11.2.6. N4JS DI Annotations</a>
+<ul class="sectlevel4">
+<li><a href="extended_fetaures.html#_n4js-di-generateinjector">11.2.6.1. N4JS DI @GenerateInjector</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-withparentinjector">11.2.6.2. N4JS DI @WithParentInjector</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-usebinder">11.2.6.3. N4JS DI @UseBinder</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-binder">11.2.6.4. N4JS DI @Binder</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-bind">11.2.6.5. N4JS DI @Bind</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-provides">11.2.6.6. N4JS DI @Provides</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-inject">11.2.6.7. N4JS DI @Inject</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-singleton">11.2.6.8. N4JS DI @Singleton</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_test-support">11.3. Test Support</a></li>
+<li><a href="extended_fetaures.html#_polyfill-definitions">11.4. Polyfill Definitions</a>
+<ul class="sectlevel3">
+<li><a href="extended_fetaures.html#_runtime-polyfill-definitions">11.4.1. Runtime Polyfill Definitions</a></li>
+<li><a href="extended_fetaures.html#_static-polyfill-definitions">11.4.2. Static Polyfill Definitions</a></li>
+<li><a href="extended_fetaures.html#_transpiling-static-polyfilled-classes">11.4.3. Transpiling static polyfilled classes</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="components.html#_components">12. Components</a>
+<ul class="sectlevel2">
+<li><a href="components.html#_overview-2">12.1. Overview</a></li>
+<li><a href="components.html#Component_Types">12.2. Component Types</a>
+<ul class="sectlevel3">
+<li><a href="components.html#_libraries">12.2.1. Libraries</a></li>
+<li><a href="components.html#_runtime-environment-and-runtime-libraries">12.2.2. Runtime Environment and Runtime Libraries</a></li>
+<li><a href="components.html#_tests">12.2.3. Tests</a></li>
+<li><a href="components.html#_type-definitions">12.2.4. Type Definitions</a></li>
+</ul>
+</li>
+<li><a href="components.html#package-json">12.3. Package.json File</a>
+<ul class="sectlevel3">
+<li><a href="components.html#_basic-properties">12.3.1. Basic Properties</a></li>
+<li><a href="components.html#_n4js-properties">12.3.2. N4JS Properties</a></li>
+<li><a href="components.html#_constraints">12.3.3. Constraints</a></li>
+</ul>
+</li>
+<li><a href="components.html#_support-for-npm-scopes">12.4. Support for NPM Scopes</a></li>
+<li><a href="components.html#sec:N4JS-Type-Definitions">12.5. N4JS Type Definitions</a>
+<ul class="sectlevel3">
+<li><a href="components.html#_specify-type-definition">12.5.1. Specify Type Definition</a></li>
+<li><a href="components.html#_name-conventions">12.5.2. Name Conventions</a></li>
+<li><a href="components.html#_version-conventions">12.5.3. Version Conventions</a>
+<ul class="sectlevel4">
+<li><a href="components.html#_define-a-new-type-definition-package">12.5.3.1. Define a New Type Definition Package</a></li>
+<li><a href="components.html#_using-a-type-definition-package">12.5.3.2. Using a Type Definition Package</a></li>
+<li><a href="components.html#_rational">12.5.3.3. Rational</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="components.html#_modules">12.6. Modules</a></li>
+<li><a href="components.html#_api-and-implementation-component">12.7. API and Implementation Component</a>
+<ul class="sectlevel3">
+<li><a href="components.html#_execution-of-api-and-implementation-components">12.7.1. Execution of API and Implementation Components</a></li>
+<li><a href="components.html#_api-and-implementation-with-di">12.7.2. API and Implementation With DI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="plainjs.html#_plainjs">13. PlainJS</a>
+<ul class="sectlevel2">
+<li><a href="plainjs.html#_type-inference-and-validation-for-plain-js">13.1. Type Inference and Validation for Plain JS</a></li>
+<li><a href="plainjs.html#_external-declarations">13.2. External Declarations</a>
+<ul class="sectlevel3">
+<li><a href="plainjs.html#_declaring-externals">13.2.1. Declaring externals</a></li>
+<li><a href="plainjs.html#_instantiating-external-classes">13.2.2. Instantiating external classes</a></li>
+<li><a href="plainjs.html#_implementation-of-external-declarations">13.2.3. Implementation of External Declarations</a></li>
+<li><a href="plainjs.html#_example">13.2.4. Example</a></li>
+</ul>
+</li>
+<li><a href="plainjs.html#_global-definitions">13.3. Global Definitions</a></li>
+<li><a href="plainjs.html#_runtime-definitions">13.4. Runtime Definitions</a></li>
+<li><a href="plainjs.html#_applying-polyfills">13.5. Applying Polyfills</a></li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_jsdoc-2">14. JSDoc</a>
+<ul class="sectlevel2">
+<li><a href="jsdoc.html#_general-n4jsdoc-features">14.1. General N4JSDoc Features</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#_provided-inline-tags">14.1.1. Provided Inline Tags</a>
+<ul class="sectlevel4">
+<li><a href="jsdoc.html#jsdoc_tag__code">14.1.1.1. @code</a></li>
+<li><a href="jsdoc.html#jsdoc_tag__link">14.1.1.2. @link</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_n4jsdoc-for-user-projects">14.2. N4JSdoc for User Projects</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#_standard-tags">14.2.1. Standard Tags</a>
+<ul class="sectlevel4">
+<li><a href="jsdoc.html#_-author">14.2.1.1. @author</a></li>
+<li><a href="jsdoc.html#jsdoc_tag_param">14.2.1.2. @param</a></li>
+<li><a href="jsdoc.html#jsdoc_tag_return">14.2.1.3. @return</a></li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_test-related-tags">14.2.2. Test Related Tags</a>
+<ul class="sectlevel4">
+<li><a href="jsdoc.html#jsdoc_tag__testee">14.2.2.1. @testee</a></li>
+<li><a href="jsdoc.html#jsdoc_tag__testeeFromType">14.2.2.2. @testeeFromType</a></li>
+<li><a href="jsdoc.html#_testeeType_and__testeeMember">14.2.2.3. @testeeType and @testeeMember</a></li>
+<li><a href="jsdoc.html#jsdoc_tag_reqid_in_Tests">14.2.2.4. @reqid in Tests</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_n4jsdoc-for-api-and-implementation-projects">14.3. N4JSDoc for API and Implementation Projects</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#jsdoc_tag__apiNote">14.3.1. @apiNote</a></li>
+<li><a href="jsdoc.html#API_Project_Tags">14.3.2. API Project Tags</a>
+<ul class="sectlevel4">
+<li><a href="jsdoc.html#jsdoc_tag_apiState">14.3.2.1. @apiState</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsx.html#_jsx">15. JSX</a>
+<ul class="sectlevel2">
+<li><a href="jsx.html#_jsx-support">15.1. JSX Support</a></li>
+<li><a href="jsx.html#_jsx-backend">15.2. JSX Backend</a></li>
+</ul>
+</li>
+<li><a href="grammars.html#_grammars">16. Grammars</a>
+<ul class="sectlevel2">
+<li><a href="grammars.html#_type-expressions-grammar">16.1. Type Expressions Grammar</a></li>
+<li><a href="grammars.html#_n4js-language-grammar">16.2. N4JS Language Grammar</a></li>
+</ul>
+</li>
+<li><a href="jsobjects.html#_jsobjects">17. JSObjects</a>
+<ul class="sectlevel2">
+<li><a href="jsobjects.html#_object">17.1. Object</a></li>
+<li><a href="jsobjects.html#_string">17.2. String</a></li>
+<li><a href="jsobjects.html#_boolean">17.3. Boolean</a></li>
+<li><a href="jsobjects.html#_number">17.4. Number</a>
+<ul class="sectlevel3">
+<li><a href="jsobjects.html#_static-attributes">17.4.1. Static Attributes</a></li>
+</ul>
+</li>
+<li><a href="jsobjects.html#function">17.5. Function</a></li>
+<li><a href="jsobjects.html#_error">17.6. Error</a></li>
+<li><a href="jsobjects.html#_array">17.7. Array</a></li>
+<li><a href="jsobjects.html#_date">17.8. Date</a></li>
+<li><a href="jsobjects.html#_math">17.9. Math</a>
+<ul class="sectlevel3">
+<li><a href="jsobjects.html#static-attributes-1">17.9.1. Static Attributes</a></li>
+</ul>
+</li>
+<li><a href="jsobjects.html#_regexp">17.10. RegExp</a></li>
+<li><a href="jsobjects.html#_json">17.11. JSON</a></li>
+</ul>
+</li>
+<li><a href="n4js_objects.html#_n4js-objects">18. N4JS Objects</a>
+<ul class="sectlevel2">
+<li><a href="n4js_objects.html#_reflection-model">18.1. Reflection Model</a></li>
+<li><a href="n4js_objects.html#_error-types">18.2. Error Types</a>
+<ul class="sectlevel3">
+<li><a href="n4js_objects.html#_n4apinotimplemented">18.2.1. N4ApiNotImplemented</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_acronyms.html#_acronyms">Appendix A: Acronyms</a></li>
+<li><a href="appendix_b_license.html#sec:License">Appendix B: License</a></li>
+<li><a href="appendix_c_bibliography.html#_bibliography">Appendix C: Bibliography</a></li>
+</ul>
+</div>
+</div>
+<div id="content"><div class="sect1">
+<h2 id="_expressions"><a class="anchor" href="#_expressions"></a><a class="link" href="#_expressions">8. Expressions</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>For all expressions, we define the following pseudo properties:</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><code>containingExpression</code> </dt>
+<dd>
+<p>The parent expression, in which an expression is contained, may be null.</p>
+</dd>
+<dt class="hdlist1"><code>containingStatement</code> </dt>
+<dd>
+<p>The statement in which the expression is (indirectly) contained.</p>
+</dd>
+<dt class="hdlist1"><code>containingFunctionOrAccessor</code> </dt>
+<dd>
+<p>The function, method, getter or setter in which the expression is (indirectly) contained, may be null.</p>
+</dd>
+<dt class="hdlist1"><code>containingClass</code> </dt>
+<dd>
+<p>The class in which the expression is (indirectly) contained, may be null.</p>
+</dd>
+<dt class="hdlist1"><code>probableThisTarget</code> </dt>
+<dd>
+<p>The potential target of a this keyword binding, this is not necessarily the containing class or object literal.
+In case of instance methods of a class <code>T</code>, this usually is the classifier <code>T</code>; in case of static methods, it is the classifier type <code>type{type}</code>.</p>
+</dd>
+<dt class="hdlist1"><code>container</code> </dt>
+<dd>
+<p>The direct owner of the expression.
+z</p>
+</dd>
+</dl>
+</div>
+<div class="paragraph">
+<p>The expressions and statements are ordered, describing first the constructs available in the 5th edition of ECMA-262, referred to as [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a</a>] in the following.
+It is worth noting that the grammar snippets already use newer constructs in some cases.</p>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="_ecmascript-5-expressions"><a class="anchor" href="#_ecmascript-5-expressions"></a><a class="link" href="#_ecmascript-5-expressions">8.1. ECMAScript 5 Expressions</a></h3>
+<div class="paragraph">
+<p>N4JS supports the same expressions as ECMAScript.
+The semantics are described in [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.S11)</a>].
+In N4JS, some expressions are extended for supporting the declaration of types, annotations, or parameterized usages.
+These extensions and type-related aspects as well as specific N4JS constraints are described in this section.</p>
+</div>
+<div class="paragraph">
+<p>Some operators come in different ’flavors’, that is as binary operator, unary pre- or postfix operators, or assignment operators.
+For these operators, type constraints are only defined for the binary operator version and the other variants are deduced to that binary version.
+E.g., <code>++</code> and <code>+=</code> are deduced to <code>+</code> (and simple assignment).</p>
+</div>
+<div class="sect3">
+<h4 id="_the-this-literal"><a class="anchor" href="#_the-this-literal"></a><a class="link" href="#_the-this-literal">8.1.1. The this Literal</a></h4>
+<div class="paragraph">
+<p>This section describes the <code>this</code> literal and the semantics of the <code>@This</code> annotation, the type <code>this</code> is described in <a href="types.html#_this-type">This Type</a>.</p>
+</div>
+<h5 id="_semantics-9" class="discrete">Semantics</h5>
+<div class="paragraph">
+<p>Semantics are similar to the original ECMAScript this keyword, see [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.11.1.1, p.p.63)</a>])
+Also see [<a href="appendix_c_bibliography.html#West06a">West06a</a>] and <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/this">MozillaJSRef</a></p>
+</div>
+<div class="paragraph">
+<p>Regarding the location where <code>this</code> may be used, the following restrictions apply:</p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-173"></a><strong>Req. IDE-173:</strong> <a href="#Req-IDE-173">Valid location for this literal</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>The literal may not be used in</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>the initializer expression of static data fields in classes.</p>
+</li>
+<li>
+<p>the initializer expression of data fields in interfaces (applies to both static and non-static).</p>
+</li>
+<li>
+<p>static methods of interfaces and static field accessors of interfaces.</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>See also <a href="classifiers.html#Req-IDE-69">[Req-IDE-69]</a>.</p>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Note: <a href="#Req-IDE-173">[Req-IDE-173]</a> also applies for this literals inside arrow expressions in initializers.</p>
+</div>
+<div class="paragraph">
+<p>The use of <code>this</code> is illustrated with some examples as it can often be confusing.
+Type inference heuristics and explanations are provided in the next section.</p>
+</div>
+<div class="exampleblock">
+<div class="title">Example 75. This in Unrestricted Mode</div>
+<div class="content">
+<div class="paragraph">
+<p>In unrestricted mode, <code>this</code> is bound to the receiver.
+If there is no receiver it is bound to the global object, however, we often do not know exactly what the global object would be.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">var name = "global a"; // assume the top level is similar to the global object
+this.name; // &lt;-- "global a"
+function f() {
+    return this.name; // &lt;-- depends on call, usually "global a"
+}
+var ol1 = {
+    name: "John",
+    greeting: "Hello " + this.name, // "Hello global a" -- we do not greet John!
+}
+var ol2 = {
+    name: "John",
+    f: function() {
+        this.name; // usually "John", as we assume f is called like ol2.f()
+        var g = function() {
+           return this.name; // "global a"
+        }
+        return g(); // no receiver, this in nested function g will be global scope
+    }
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="exampleblock">
+<div class="title">Example 76. This in strict mode</div>
+<div class="content">
+<div class="paragraph">
+<p>In strict mode, <code>this</code> is bound to the receiver.
+If there is no receiver, it is bound to <code>undefined</code>.
+Thus, we will probably get a lot of errors:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">"use strict"
+var name = "global a"; // assume the top level is similar to the global object
+this.name; // &lt;-- error, this is undefined, there is no receiver
+function f() {
+    return this.name; // &lt;-- depends on call, usually this produces an error as this is undefined
+}
+var ol1 = {
+    name: "John",
+    greeting: "Hello " + this.name, // will produce an error, as this is undefined
+}
+var ol2 = {
+    name: "John",
+    f: function() {
+        this.name; // usually "John", as we assume f is called like ol2.f()
+        var g = function() {
+           this.name; // an error, see call below:
+        }
+        return g(); // no receiver, this in nested function g is undefined
+    }
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="exampleblock">
+<div class="title">Example 77. This in N4JS mode</div>
+<div class="content">
+<div class="paragraph">
+<p>As in strict mode, <code>this</code> is bound to the receiver and if there is no receiver, it is bound to <code>undefined</code>. So the example above is also true for N4JS mode.
+Classes behave slightly differently:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">class A {
+    name = "John";
+    greeting  = "Hello " + this.name; // works, in N4JS classes, greeting is "Hello John"
+
+    f() {
+        return this.name; // this usually is instance object, similar to object literals.
+    }
+
+    g() {
+        var h = function() {
+            return this.name; // as in object literals: no receiver, no this.
+        }
+        return h();
+    }
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title=""></i>
+</td>
+<td class="content">
+In N4JS classes, <code>this</code> is always bound to the instance when used in field initialization.
+</td>
+</tr>
+</table>
+</div>
+<h5 id="_type-inference-2" class="discrete">Type Inference</h5>
+<div class="openblock language-n4js">
+<div class="content">
+<div class="paragraph">
+<p>The type is inferred from the <code>this</code> type is bound to. The inference,
+therefore, has to consider the original semantics as described in [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.10.4., p.10.4.3, p.p.58)</a>].
+In ECMAScript the type of this is unfortunately determined by the function call and not by the function definition:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>By default, <code>this</code> is bound to the global object [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.10.4.1.1)</a>].
+Unfortunately it is often unknown what the global object will be at run time (e.g., node.js differs from browsers).</p>
+</li>
+<li>
+<p>If a function is called without a receiver, <code>this</code> is bound to</p>
+<div class="ulist">
+<ul>
+<li>
+<p>the global object or</p>
+</li>
+<li>
+<p>to <code>undefined</code> in strict mode.</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>If a function is called with a receiver,<code>this</code> is bound to the receiver object.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Actually, <code>this</code> is bound to the newly created object if a function is called with the <code>new</code> operator.
+If a function is known to be invoked with an explicit <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>t</mi><mi>h</mi><mi>i</mi><mi>s</mi><mi>A</mi><mi>r</mi><mi>g</mi></math> (<code>apply()</code> etc.), the <code>@This</code> annotation can be used to explicitly set the this type.
+This annotation has precedence over otherwise inferred bindings.</p>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-90"></a><strong>Req. IDE-90:</strong> <a href="#Req-IDE-90">Type Inference Heuristic for This-Keyword</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>In general, the actual this target can not be inferred from the context of the this keyword.
+A heuristic is defined, however, to compute the probable this type:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p><a id="this-keyword-constraint-1"></a> If the this keyword is used in some function annotated with an annotation <code>@This</code>, the type specified in the annotation is used.
+The inferred type is always nominal.</p>
+<div class="paragraph">
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>f</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>"this"</mtext></mstyle><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>t</mi><mi>a</mi><mi>i</mi><mi>n</mi><mi>i</mi><mi>n</mi><mi>g</mi><mi>F</mi><mi>u</mi><mi>n</mi><mi>c</mi><mi>t</mi><mi>i</mi><mi>o</mi><mi>n</mi><mi>O</mi><mi>r</mi><mi>A</mi><mi>c</mi><mi>c</mi><mi>e</mi><mi>s</mi><mi>s</mi><mi>o</mi><mi>r</mi></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mfrac><mrow><mi>f</mi><mo>.</mo><mi>h</mi><mi>a</mi><mi>s</mi><mi>A</mi><mi>n</mi><mi>n</mi><mi>o</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close=")" open="("><mstyle mathvariant="monospace"><mtext>"@This"</mtext></mstyle></mfenced><mspace width="3.0mm"/><mi>T</mi><mo>=</mo><mi>f</mi><mo>.</mo><mi>a</mi><mi>n</mi><mi>n</mi><mi>o</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>o</mi><mi>n</mi><mstyle mathvariant="monospace"><mtext>["@This"]</mtext></mstyle></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mstyle mathvariant="monospace"><mtext>"this"</mtext></mstyle><mi>:</mi><mo>≁</mo><mi>T</mi></mrow></mfrac></math></p>
+</div>
+</li>
+<li>
+<p><a id="this-keyword-constraint-2"></a> If the this keyword is used in some <em>instance</em> method of a  classifier or in an <em>instance</em> field initializer,<code>this</code> is bound to the <code>T</code> itself.
+If the this keyword is used in some <em>static</em> method of a classifier <code>T</code> or in a <em>static</em> field initializer, the prototype type (or constructor) of the classifier is used, that is <code>type[T]</code>.
+In both cases, the target is determined by using the expressions’s pseudo property <code>probableThisTarget</code>.
+If the this keyword is used in a function expression assigned to an property of an object literal, the type of the object literal is used.
+Note that usually this is the <code>this</code> type in instance methods, and the <code>this</code> type in static methods.</p>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><mi>T</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>"this"</mtext></mstyle><mo>.</mo><mi>p</mi><mi>r</mi><mi>o</mi><mi>b</mi><mi>a</mi><mi>b</mi><mi>l</mi><mi>e</mi><mi>T</mi><mi>h</mi><mi>i</mi><mi>s</mi><mi>T</mi><mi>a</mi><mi>r</mi><mi>g</mi><mi>e</mi><mi>t</mi><mspace width="3.0mm"/><mi>T</mi><mo>≠</mo><mstyle mathvariant="monospace"><mtext>null</mtext></mstyle></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mstyle mathvariant="monospace"><mtext>"this"</mtext></mstyle><mi>:</mi><mo>≁</mo><mi>T</mi></mrow></mfrac><mtext>
+</mtext></math>
+</div>
+</div>
+</li>
+<li>
+<p>In all other cases: Non-strict mode:</p>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><mi>m</mi><mi>o</mi><mi>d</mi><mi>e</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>unrestricted</mtext></mstyle></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mstyle mathvariant="monospace"><mtext>"this"</mtext></mstyle><mi>:</mi><mstyle mathvariant="monospace"><mtext>global</mtext></mstyle></mrow></mfrac><mtext>
+</mtext></math>
+</div>
+</div>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>Strict mode and N4JS mode:</p>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><mi>m</mi><mi>o</mi><mi>d</mi><mi>e</mi><mo>≠</mo><mstyle mathvariant="monospace"><mtext>unrestricted</mtext></mstyle></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mstyle mathvariant="monospace"><mtext>"this"</mtext></mstyle><mi>:</mi><mstyle mathvariant="monospace"><mtext>global</mtext></mstyle><mstyle mathvariant="monospace"><mtext>undefined</mtext></mstyle></mrow></mfrac><mtext>
+</mtext></math>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>If the actual this type is defined as a structural type, the structural type information is moved to the this type itself.
+This is transparent to the user in general but maybe visible in case of error messages.
+That is to say that the actual this type is always a nominal type.
+This is indicated by the nominal modifier <math xmlns="http://www.w3.org/1998/Math/MathML"><mo>≁</mo></math> (cf. <a href="#Req-IDE-90">[Req-IDE-90]</a> constraints <a href="#this-keyword-constraint-1">1</a> and <a href="#this-keyword-constraint-2">2</a>.).</p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-91"></a><strong>Req. IDE-91:</strong> <a href="#Req-IDE-91">Valid Target and Argument for @This Annotation</a> (ver. 1)</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>The <code>@This</code> annotation is only allowed on declared functions, function expressions (including arrow functions), methods, and field accessors, i.e. getters and setters, except static members of interfaces.</p>
+</li>
+<li>
+<p>The type declared by way of <code>@This(..)</code> an annotation of a method or field accessor must be a subtype of the member’s containing classifier.</p>
+</li>
+</ol>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-92"></a><strong>Req. IDE-92:</strong> <a href="#Req-IDE-92">Single @This Annotation</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>It is not allowed to use more then one <code>@This(..)</code> annotation on an element.</p>
+</div>
+</div>
+</div>
+<div class="exampleblock">
+<div class="title">Example 78. Effect of Nominal This Type</div>
+<div class="content">
+<div class="paragraph">
+<p>Given the following declaration</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">@This(~Object with {a: string;}) f() {}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Since the this type is always nominal, <code>~ Object</code> becomes <code>Object</code>.
+In case of method call, however, the returned value becomes structural again.
+In case of error messages the type of the return type is then</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">~this[Object] with {a: string;}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>For the sake of simplicity, additional structural members are usually
+omitted in error messages, leading to</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">~this[Object]</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>instead of</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">this[~Object]</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="exampleblock">
+<div class="title">Example 79. This and Function Declaration</div>
+<div class="content">
+<div class="paragraph">
+<p>This example demonstrates the usage of functions annotated with <code>@This</code>.
+By using the argument  <code>union{A,B}</code> it is possible to have two completely unrelated classes as the receiver type of the function <code>logger</code>.
+To pass an actual object the <code>apply()</code> method of the function is used.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">class A {
+    log: string() { return "A was logged"; }
+}
+
+class B {
+    log: string() { return "B was logged"; }
+}
+
+@This(union{A,B})
+function logger() { console.log("~ "+this.log()+" ~"); }
+
+
+var a: A = new A();
+logger.apply(a,[]); // prints "~ A was logged ~"
+logger.apply( new B(),[]) // prints "~ B was logged ~"</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="exampleblock">
+<div class="title">Example 80. This and Function Expressions</div>
+<div class="content">
+<div class="paragraph">
+<p>In this example a function is created via a function expression.
+The function is then assigned to member field of class B.
+Via annotating the expression with <code>@This(B)</code>, access to the receiver of type B is enabled.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">class B {
+    log(): string { return "B was logged"; }     // method
+    logMe : {@This(B) function():void}; // reference to a function
+}
+
+var b: B = new B();
+b.logMe = @This(B) function() { console.log("*&gt;"+this.log()+"&lt;*"); }
+b.logMe(); // prints "*&gt;B was logged&lt;*"</code></pre>
+</div>
+</div>
+<div class="openblock">
+<div class="content">
+
+</div>
+</div>
+<div class="paragraph">
+<p>Note that if a function is called as a constructor function with new, the
+type of <code>this</code> can be declared via annotation <code>@This(..)</code>, as shown in the following
+snippet:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">@This(
+    ~Object with {
+        w: number; h: number;
+        area: {function():number};
+    })
+function Box(w: number w, h: number) {
+    this.w = w;
+    this.h = h;
+    this.area = @This(
+        ~Object with {
+            w: number; h: number;
+            area: {function():number};
+        }) function() { return this.w * this.h }
+}
+var bError = Box(1,2)
+var bOK = new Box(1,2)</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Inside the constructor function <code>Box</code>, <code>this</code> is bound to the structural type definition due to the annotation.</p>
+</div>
+<div class="paragraph">
+<p>Inside the nested function <code>area</code>, <code>this</code> is bound to the receiver object (if the function is called like <code>bOk.area()</code>).
+Again, this depends on the way the nested function is called, which can usually not be determined at the declaration location.
+The nested function must then be annotated accordingly.</p>
+</div>
+<div class="paragraph">
+<p>When calling this function, the type of this is checked against the declared this type, which would cause an error in the first case.</p>
+</div>
+<div class="paragraph">
+<p>The use of the <code>@This</code> annotation is not allowed on methods.</p>
+</div>
+<div class="admonitionblock tip">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-tip" title=""></i>
+</td>
+<td class="content">
+Using constructor functions is not recommended and an error or warning will be created.
+This is only useful for adapting third-party library code.
+Even in the latter case, it would probably make more sense to declare a (library) <strong>class</strong> Rectangle rather then defining the constructor function.
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_identifier"><a class="anchor" href="#_identifier"></a><a class="link" href="#_identifier">8.1.2. Identifier</a></h4>
+<h5 id="_syntax-10" class="discrete">Syntax</h5>
+<div class="paragraph">
+<p>Identifiers as expressions are identifier references.
+They are defined as follows:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">IdentifierRef &lt;Yield&gt;:
+    id=[types::IdentifiableElement|BindingIdentifier&lt;Yield&gt;]
+;
+
+BindingIdentifier &lt;Yield&gt;:
+    IDENTIFIER
+    | &lt;!Yield&gt; 'yield'
+    | N4Keyword
+;</code></pre>
+</div>
+</div>
+<h5 id="_semantics-10" class="discrete">Semantics</h5>
+<div class="paragraph">
+<p>The type of an identifier <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>i</mi></math> is resolved depending on its binding and scope respectively (cf. [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.10.2.2.1GetIdentifierReference, p.p.56)</a>].
+The following scopes (aka <em>Lexical Environments</em>) are defined:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>function local; local variables, parameters</p>
+</li>
+<li>
+<p>zero or more function closure in case of nested functions</p>
+</li>
+<li>
+<p>module</p>
+</li>
+<li>
+<p>global</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>These scope are nested as illustrated in <a href="#fig:scopes">Scopes</a>.</p>
+</div>
+<div class="paragraph">
+<p>Note that classes definitions and object literal do not define a scope: members of a class or properties of an object literal are to be accessed via <code>this</code>.
+Identifier references always reference declared elements, that is to say either variable, function, or class declarations.
+Properties of object literals or members of a class are referenced via <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>P</mi><mi>r</mi><mi>o</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>t</mi><mi>y</mi><mi>A</mi><mi>c</mi><mi>c</mi><mi>e</mi><mi>s</mi><mi>s</mi><mo>-</mo><mi>E</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>e</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>o</mi><mi>n</mi><mo>.</mo><mi>p</mi><mi>r</mi><mi>o</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>t</mi><mi>y</mi></math> (see <a href="#_property-accessors">Property Accessors</a>).</p>
+</div>
+<div id="fig:scopes" class="imageblock" style="text-align: center">
+<div class="content">
+<img src="chapters/08_expressions/fig/scopes.svg" alt="scopes">
+</div>
+<div class="title">Figure 7. Scopes</div>
+</div>
+<div class="paragraph">
+<p>An identifier may be bound to a variable (global or local variable, parameter, variable defined in a function’s closure), or to a property of an object.
+The latter case is known as property access as further described in <a href="#_property-accessors">Property Accessors</a>.</p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-93"></a><strong>Req. IDE-93:</strong> <a href="#Req-IDE-93">Read Access to Identifier</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>If an identifier <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>i</mi></math> is accessed, the bound declared element <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>D</mi></math> must be readable if it is not used on the left-hand side of an assignment expression.</p>
+</div>
+<div class="paragraph">
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mi>b</mi><mi>i</mi><mi>n</mi><mi>d</mi><mfenced close=")" open="("><mi>i</mi><mi>D</mi></mfenced></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mspace width="2.0em"/><mo>∧</mo><mo>∄</mo><mi> </mi><mstyle mathvariant="monospace"><mtext>AssignmentExpression</mtext></mstyle><mi> </mi><mi>a</mi><mi>e</mi><mo>∈</mo><mi>i</mi><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>t</mi><mi>a</mi><mi>i</mi><mi>n</mi><mi>e</mi><msup><mi>r</mi><mo>*</mo></msup><mi>:</mi></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mspace width="3.0em"/><mi>a</mi><mi>e</mi><mo>.</mo><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi><mo>=</mo><mi>i</mi></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mspace width="4.0em"/><mo>∨</mo><mfenced close=")" open="("><mrow><mi>μ</mi><mfenced close=")" open="("><mrow><mi>a</mi><mi>e</mi><mo>.</mo><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi></mrow></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>PropertyAccessExpression</mtext></mstyle><mo>∧</mo><mi>a</mi><mi>e</mi><mo>.</mo><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi><mo>.</mo><mi>p</mi><mi>r</mi><mi>o</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>t</mi><mi>y</mi><mo>=</mo><mi>i</mi></mrow></mfenced><mi>:</mi></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mo>⇒</mo><mi>D</mi><mo>.</mo><mi>r</mi><mi>e</mi><mi>a</mi><mi>d</mi><mi>a</mi><mi>b</mi><mi>l</mi><mi>e</mi></math></p>
+</div>
+</div>
+</div>
+<h5 id="_type-inference-3" class="discrete">Type Inference</h5>
+<div class="paragraph">
+<p>An identifier reference <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>i</mi></math> is bound to an identifiable element <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>i</mi><mo>.</mo><mi>i</mi><mi>d</mi></math>, which is expressed with the function <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>b</mi><mi>i</mi><mi>n</mi><mi>d</mi><mfenced close=")" open="("><mi>i</mi><mrow><mi>i</mi><mo>.</mo><mi>i</mi><mi>d</mi></mrow></mfenced></math>.
+The type of the reference is then inferred as follows:</p>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><mi>Γ</mi><mo>⊢</mo><mi>i</mi><mi>d</mi><mi>r</mi><mi>e</mi><mi>f</mi><mo>.</mo><mi>i</mi><mi>d</mi><mi>:</mi><mi>T</mi></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mstyle mathvariant="monospace"><mtext>IdentifierRef</mtext></mstyle><mi> </mi><mi>i</mi><mi>d</mi><mi>r</mi><mi>e</mi><mi>f</mi><mi>:</mi><mi>T</mi></mrow></mfrac></math>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_literals"><a class="anchor" href="#_literals"></a><a class="link" href="#_literals">8.1.3. Literals</a></h4>
+<div class="paragraph">
+<p>cf. [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.S11.1.3p.63, p.S7.8p.19ff)</a>].</p>
+</div>
+<h5 id="_type-inference-4" class="discrete">Type Inference</h5>
+<div class="paragraph">
+<p>The type of a literal can directly be derived from the grammar.
+The following axioms are defined for literals:</p>
+</div>
+<div class="paragraph">
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="13.0em"/><mfrac><mrow/><mrow><mstyle mathvariant="monospace"><mtext>NullLiteral</mtext></mstyle><mi>:</mi><mstyle mathvariant="monospace"><mtext>null</mtext></mstyle></mrow></mfrac></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="13.0em"/><mfrac><mrow/><mrow><mstyle mathvariant="monospace"><mtext>BooleanLiteral</mtext></mstyle><mi>:</mi><mstyle mathvariant="monospace"><mtext>boolean</mtext></mstyle></mrow></mfrac></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="13.0em"/><mfrac><mrow/><mrow><mstyle mathvariant="monospace"><mtext>NumericLiteral</mtext></mstyle><mi>:</mi><mstyle mathvariant="monospace"><mtext>int</mtext></mstyle><mi>o</mi><mi>r</mi><mstyle mathvariant="monospace"><mtext>number</mtext></mstyle></mrow></mfrac></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="13.0em"/><mfrac><mrow/><mrow><mstyle mathvariant="monospace"><mtext>StringLiteral</mtext></mstyle><mi>:</mi><mstyle mathvariant="monospace"><mtext>string</mtext></mstyle></mrow></mfrac></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="13.0em"/><mfrac><mrow/><mrow><mstyle mathvariant="monospace"><mtext>RegularExpressionLiteral</mtext></mstyle><mi>:</mi><mstyle mathvariant="monospace"><mtext>RegExpr</mtext></mstyle></mrow></mfrac></math></p>
+</div>
+<div class="paragraph">
+<p>Note that there are no literals specific for <code>pathSelector</code> or <code>i18nkey</code>.</p>
+</div>
+<div class="sect4">
+<h5 id="_integer-literals"><a class="anchor" href="#_integer-literals"></a><a class="link" href="#_integer-literals">8.1.3.1. Integer Literals</a></h5>
+<div class="paragraph">
+<p>Numeric literals representing integers in the range of JavaScript’s int32 are inferred to the built-in primitive type <code>int</code> instead of <code>number</code>.
+The following rules apply:</p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-94"></a><strong>Req. IDE-94:</strong> <a href="#Req-IDE-94">Numeric literals</a> (ver. 1)</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Numeric literals with a fraction or using scientific notation, e.g. <code>2.0</code> and <code>2e0</code>, respectively, are always inferred to <code>number</code>, even if they represent integers in the range of int32.</p>
+</li>
+<li>
+<p>Numeric literals that represent integers in the range of JavaScript’s int32, i.e. from <math xmlns="http://www.w3.org/1998/Math/MathML"><msup><mn>-2</mn><mn>31</mn></msup></math> to <math xmlns="http://www.w3.org/1998/Math/MathML"><msup><mn>2</mn><mn>31</mn></msup><mo>-</mo><mn>1</mn></math>, are inferred to <code>int</code>.</p>
+</li>
+<li>
+<p>Hexadecimal and octal literals are always interpreted as positive numbers, so all values above <code>0x7fffffff</code> and <code>017777777777</code> lie outside the range of int32 and will thus
+be inferred to <code>number</code>; this is an important difference to Java. See below for further elaboration.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>There are differences to numeric literals in Java:</p>
+</div>
+<table class="tableblock frame-all grid-all spread">
+<colgroup>
+<col style="width: 25%;">
+<col style="width: 25%;">
+<col style="width: 12.5%;">
+<col style="width: 25%;">
+<col style="width: 12.5%;">
+</colgroup>
+<thead>
+<tr>
+<th class="tableblock halign-left valign-top"></th>
+<th class="tableblock halign-center valign-top" colspan="2">Java</th>
+<th class="tableblock halign-center valign-top" colspan="2">JavaScript  N4JS</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Literal</p></th>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Value</p></th>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Type</p></th>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Value</p></th>
+<th class="tableblock halign-left valign-top"><p class="tableblock">Type</p></th>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>2147483648</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><em>-2147483648</em></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>int</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><em>-2147483648</em></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>int</code></p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>2147483647</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><em>2147483647</em></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>int</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><em>2147483647</em></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>int</code></p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>0x7fffffff</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><em>2147483647</em></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>int</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><em>2147483647</em></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>int</code></p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>0x80000000</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><em>-2147483648</em></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>int</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><em>+2147483648</em></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>number</code></p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>0xffffffff</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><em>-1</em></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>int</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><em>4294967295</em></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>number</code></p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>0x100000000</code></p></td>
+<th class="tableblock halign-center valign-top" colspan="2"><p class="tableblock">n/a</p></th>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><em>4294967296</em></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>number</code></p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>017777777777</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><em>2147483647</em></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>int</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><em>2147483647</em></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>int</code></p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>020000000000</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><em>-2147483648</em></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>int</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><em>+2147483648</em></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>number</code></p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>037777777777</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><em>-1</em></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>int</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><em>4294967295</em></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>number</code></p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>040000000000</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><em>0</em></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>int</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><em>4294967296</em></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>number</code></p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>0100000000000</code></p></td>
+<th class="tableblock halign-center valign-top" colspan="2"><p class="tableblock">n/a</p></th>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><em>8589934592</em></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>number</code></p></td>
+</tr>
+</tbody>
+</table>
+<div class="paragraph">
+<p>The literals <code>0x100000000</code> and <code>0100000000000</code> produce a syntax error in Java.</p>
+</div>
+<div class="paragraph">
+<p>Until IDE-1881  is complete, all built-in operations always return a <code>number</code> even if all operands are of type <code>int</code>.
+For the time being, we therefore interpret <code>-1</code> as a negative integer literal (inferred to <code>int</code>), but <code>-(1)</code> as the negation of a positive integer literal (inferred to <code>number</code>).</p>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_array-literal"><a class="anchor" href="#_array-literal"></a><a class="link" href="#_array-literal">8.1.4. Array Literal</a></h4>
+<h5 id="_syntax-11" class="discrete">Syntax</h5>
+<div class="paragraph">
+<p>cf [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.S11.1.4, p.p.63)</a>]</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">ArrayLiteral &lt;Yield&gt; returns ArrayLiteral:
+    {ArrayLiteral} '['
+        elements+=ArrayPadding* (
+            elements+=ArrayElement&lt;Yield&gt;
+            (',' elements+=ArrayPadding* elements+=ArrayElement&lt;Yield&gt;)*
+            (trailingComma?=',' elements+=ArrayPadding*)?
+        )?
+    ']'
+;
+
+/**
+ * This array element is used to pad the remaining elements, e.g. to get the
+ * length and index right
+ */
+ArrayPadding returns ArrayElement: {ArrayPadding} ',';
+
+ArrayElement &lt;Yield&gt; returns ArrayElement: {ArrayElement} spread?='...'? expression=AssignmentExpression&lt;In=true,Yield&gt;;</code></pre>
+</div>
+</div>
+<h5 id="_type-inference-5" class="discrete">Type Inference</h5>
+<div class="paragraph">
+<p>In general, an array literal is inferred as <code>Array&lt;T&gt;</code> (similar to the type of <code>new Array()</code>).
+The interesting question is the binding of the type variable <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi></math>.</p>
+</div>
+<div class="paragraph">
+<p>The type of an array padding <em>p</em> is inferred as follows:</p>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow/><mrow><mi>Γ</mi><mo>⊢</mo><mi>p</mi><mi>:</mi><mstyle mathvariant="monospace"><mtext>undefined</mtext></mstyle></mrow></mfrac><mtext>
+</mtext></math>
+</div>
+</div>
+<div class="paragraph">
+<p>The element type of an array literal is simply inferred as the (simplified) union of the type elements of the array.
+Thus, the type of an array literal <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>a</mi></math> is inferred as follows:</p>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><mi>Γ</mi><mo>⊢</mo><mi>a</mi><mo>.</mo><mover accent="true"><mrow><mi>e</mi><mi>l</mi><mi>e</mi><mi>m</mi><mi>e</mi><mi>n</mi><mi>t</mi><mi>s</mi></mrow><mo>¯</mo></mover><mi>:</mi><mover accent="true"><msub><mi>T</mi><mi>e</mi></msub><mo>¯</mo></mover><mi>T</mi><mo>=</mo><mo>⋃</mo><mover accent="true"><msub><mi>T</mi><mi>e</mi></msub><mo>¯</mo></mover></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mfenced close=")" open="("><mi>a</mi></mfenced><mi>:</mi><mi>A</mi><mi>r</mi><mi>r</mi><mi>a</mi><mi>y</mi><mo>&lt;</mo><mi>T</mi><mo>&gt;</mo></mrow></mfrac></math>
+</div>
+</div>
+<div class="paragraph">
+<p>In other languages not supporting union types, the element type is often inferred as the join (<a href="appendix_a_acronyms.html#_acronyms">LCST</a>) of the element types.
+Using a union type here preserves more information (as the actual types are still known).
+For many use cases the behavior is similar though, as the members of a union type are the members of the join of the elements of the union.</p>
+</div>
+<div class="paragraph">
+<p>Note that <code>typeof [1,2,3]</code> does not return <code>Array&lt;number&gt;</code> (as ECMAScript is not aware of the generic array type), but <code>Object</code>.</p>
+</div>
+<div class="exampleblock">
+<div class="title">Example 81. Array Type Inference</div>
+<div class="content">
+<div class="paragraph">
+<p>The type for all variables declared in this example is inferred to <code>Array&lt;string&gt;</code>:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">var names1          = ["Walter", "Werner"];
+var names2          = new Array("Wim", "Wendelin");
+var names3          = new Array&lt;string&gt;(3); // length is 3
+var names4: Array&lt;string&gt;;</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Empty array literals are inferred to <code>any</code>, by default.
+We are not using <code>Array&lt;?&gt;</code> here because then a typical JavaScript pattern would no longer be supported:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">var a = [];
+a.push('hello'); <i class="conum" data-value="1"></i><b>(1)</b></code></pre>
+</div>
+</div>
+<div class="colist arabic">
+<table>
+<tr>
+<td><i class="conum" data-value="1"></i><b>1</b></td>
+<td>This would fail if <code>a</code> and thus <code>[]</code> were inferred to <code>Array&lt;?&gt;</code></td>
+</tr>
+</table>
+</div>
+</div>
+</div>
+<div class="admonitionblock important">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-important" title=""></i>
+</td>
+<td class="content">
+An important exception; if a type expectation exists for the empty array literal and the expected type is <code>Array&lt;T&gt;</code>, this will be used as the type of the array literal.
+</td>
+</tr>
+</table>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-95"></a><strong>Req. IDE-95:</strong> <a href="#Req-IDE-95">Empty array literal</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>An empty array literal will be inferred as follows:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>If there is a type expectation for the empty array literal and the expected type is <code>Array&lt;T&gt;</code>, for any type <code>T</code>, then the type of the empty array literal will be inferred to <code>Array&lt;T&gt;</code>.</p>
+</li>
+<li>
+<p>Otherwise, the type of the empty array literal will be inferred to <code>Array&lt;any&gt;</code>.</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_object-literal"><a class="anchor" href="#_object-literal"></a><a class="link" href="#_object-literal">8.1.5. Object Literal</a></h4>
+<div class="paragraph">
+<p>In addition to ordinary Javascript object literals, N4JS supports the spread operator within object literals as introduced in [<a href="appendix_c_bibliography.html#ECMA18a">ECMA18a</a>].</p>
+</div>
+<h5 id="object-literal-syntax" class="discrete">Syntax</h5>
+<div class="paragraph">
+<p>Cf. [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.S11.1.5, p.p.65ff)</a>]
+The syntax of an object literal is given by:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">ObjectLiteral &lt;Yield&gt;: {ObjectLiteral}
+    '{'
+        ( propertyAssignments+=PropertyAssignment&lt;Yield&gt;
+          (',' propertyAssignments+=PropertyAssignment&lt;Yield&gt;)* ','?
+        )?
+    '}'
+;
+
+PropertyAssignment &lt;Yield&gt;:
+      PropertyNameValuePair&lt;Yield&gt;
+    | PropertyGetterDeclaration&lt;Yield&gt;
+    | PropertySetterDeclaration&lt;Yield&gt;
+    | PropertyMethodDeclaration&lt;Yield&gt;
+    | PropertyNameValuePairSingleName&lt;Yield&gt;
+    | PropertySpread&lt;Yield&gt;
+;
+
+
+PropertyMethodDeclaration &lt;Yield&gt;:
+    =&gt; ({PropertyMethodDeclaration}
+        annotations+=Annotation*
+        TypeVariables? returnTypeRef=TypeRef?
+            (
+                generator?='*'  LiteralOrComputedPropertyName&lt;Yield&gt; -&gt;MethodParamsAndBody&lt;Generator=true&gt;
+                | LiteralOrComputedPropertyName&lt;Yield&gt; -&gt;MethodParamsAndBody &lt;Generator=false&gt;
+            )
+        )
+    ';'?
+;
+
+PropertyNameValuePair &lt;Yield&gt;:
+    =&gt; (
+        {PropertyNameValuePair}
+        annotations+=Annotation*
+        declaredTypeRef=TypeRef? LiteralOrComputedPropertyName&lt;Yield&gt; ':'
+    )
+    expression=AssignmentExpression&lt;In=true,Yield&gt;
+;
+
+/*
+ * Support for single name syntax in ObjectLiteral (but disallowed in actual object literals by ASTStructureValidator
+ * except in assignment destructuring patterns)
+ */
+PropertyNameValuePairSingleName &lt;Yield&gt;:
+    declaredTypeRef=TypeRef?
+    identifierRef=IdentifierRef&lt;Yield&gt;
+    ('=' expression=AssignmentExpression&lt;In=true,Yield&gt;)?
+;
+
+PropertyGetterDeclaration &lt;Yield&gt;:
+    =&gt;(
+        {PropertyGetterDeclaration}
+        annotations+=Annotation*
+        GetterHeader&lt;Yield&gt;
+    )
+    body=Block&lt;Yield=false&gt;
+;
+
+PropertySetterDeclaration &lt;Yield&gt;:
+    =&gt;(
+        {PropertySetterDeclaration}
+        annotations+=Annotation*
+        'set'
+        -&gt;LiteralOrComputedPropertyName &lt;Yield&gt;
+    )
+    '(' fpar=FormalParameter&lt;Yield&gt; ')' body=Block&lt;Yield=false&gt;
+;
+
+PropertySpread &lt;Yield&gt;:
+	'...' expression=AssignmentExpression&lt;In=true,Yield&gt;
+;</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">import Address from "my/Address";
+var simple = {name: "Walter", age: 72, address: new Address()};</code></pre>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_properties-6"><a class="anchor" href="#_properties-6"></a><a class="link" href="#_properties-6">8.1.5.1. Properties</a></h5>
+<div class="paragraph">
+<p>PropertyAssignments have common properties of PropertyNameValuePair, PropertyGetterDeclaration, and PropertySetterDeclaration:</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><code>annotations</code> </dt>
+<dd>
+<p>The annotations of the property assignment.</p>
+</dd>
+<dt class="hdlist1"><code>name</code> </dt>
+<dd>
+<p>The name of the property. This may be an identifier, a string or a numeric literal.
+When comparing names, we implicitly assume the name to be converted to an identifier, even if this identifier is not a valid ECMAScript identifier.</p>
+</dd>
+<dt class="hdlist1"><code>declaredType</code> </dt>
+<dd>
+<p>The declared type of the property which may be null.
+This property is a pseudo property for PropertySetterDeclaration, in this case it is derived from the declared type of the setter’s formal parameter.</p>
+</dd>
+</dl>
+</div>
+<div class="paragraph">
+<p>Additionally, we introduce the following pseudo properties to simplify constraints:</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><code>isAccessor</code> </dt>
+<dd>
+<p>The read-only boolean property. This is true if the property assignment is a setter or getter declaration.
+This is comparable to ECMAScript’s spec function <code>IsAccessoprDescriptor</code>.
+For a given property assignment <em>p</em> this is semantically equivalent to <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>μ</mi><mfenced close=")" open="("><mi>p</mi></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>PropertyGetterDeclaration</mtext></mstyle><mo>∨</mo><mi>μ</mi><mfenced close=")" open="("><mi>p</mi></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>PropertySetterDeclaration</mtext></mstyle></math>.</p>
+</dd>
+<dt class="hdlist1"><code>isData</code> </dt>
+<dd>
+<p>The read-only boolean property.
+This is true if the property assignment is a name value pair.
+For a given property assignment <em>p</em> this is semantically equivalent to <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>μ</mi><mfenced close=")" open="("><mi>p</mi></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>PropertyNameValuePair</mtext></mstyle></math>.
+It is comparable to ECMAScript’s spec function <code>isDataDescriptor</code>.
+The equation <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>i</mi><mi>s</mi><mi>A</mi><mi>c</mi><mi>c</mi><mi>e</mi><mi>s</mi><mi>s</mi><mi>o</mi><mi>r</mi><mo>=</mo><mo>¬</mo><mi>i</mi><mi>s</mi><mi>D</mi><mi>a</mi><mi>t</mi><mi>a</mi></math> is always true.</p>
+</dd>
+</dl>
+</div>
+<h5 id="properties-semantics" class="discrete">Semantics</h5>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-96"></a><strong>Req. IDE-96:</strong> <a href="#Req-IDE-96">Object literal</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>For a given object literal <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>o</mi><mi>l</mi></math> the following constraints must hold (cf. [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.p.66)</a>]:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>the name of each property is given as an identifier, a string literal, a numeric literal, or as a computed property name with a compile-time expression (see <a href="#compile-time-expressions">Compile-Time Expressions</a>). In particular, string literals, e.g. <code>['myProp']</code>, built-in symbols, e.g. <code>[Symbol.iterator]</code>, and literals of <code>@StringBased</code> enums are all valid computed property names.</p>
+</li>
+<li>
+<p>Object literal may not have two PropertyNameValuePairs with the same name in strict mode (cf. 4.a [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.p.66)</a>]):</p>
+<div class="paragraph">
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>m</mi><mi>o</mi><mi>d</mi><mi>e</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>strict</mtext></mstyle><mo>→</mo><mspace width="3.0mm"/><mo>∀</mo><mi>p</mi><mi>a</mi><mo>∈</mo><mi>o</mi><mi>l</mi><mo>.</mo><mi>p</mi><mi>r</mi><mi>o</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>t</mi><mi>y</mi><mi>A</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>g</mi><mi>n</mi><mi>m</mi><mi>e</mi><mi>n</mi><mi>t</mi><mi>s</mi><mo>,</mo><mi>p</mi><mi>a</mi><mo>.</mo><mi>i</mi><mi>s</mi><mi>D</mi><mi>a</mi><mi>t</mi><mi>a</mi><mi>:</mi></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mo>∄</mo><mi>p</mi><msup><mi>a</mi><mi>'</mi></msup><mo>∈</mo><mi>o</mi><mi>l</mi><mo>.</mo><mi>p</mi><mi>r</mi><mi>o</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>t</mi><mi>y</mi><mi>A</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>g</mi><mi>n</mi><mi>m</mi><mi>e</mi><mi>n</mi><mi>t</mi><mi>s</mi><mi>:</mi></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mi>p</mi><msup><mi>a</mi><mi>'</mi></msup><mo>.</mo><mi>i</mi><mi>s</mi><mi>A</mi><mi>c</mi><mi>c</mi><mi>e</mi><mi>s</mi><mi>s</mi><mi>o</mi><mi>r</mi><mo>∧</mo><mi>p</mi><msup><mi>a</mi><mi>'</mi></msup><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><mi>p</mi><mi>a</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi></math></p>
+</div>
+</li>
+<li>
+<p>Object literal may not have PropertyNameValuePair and <code>PropertyGetterDeclaration</code>/<code>PropertySetterDeclaration</code> with the same name (cf. 4.b/c [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.p.66)</a>]):</p>
+<div class="paragraph">
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∀</mo><mspace width="3.0mm"/><mi>p</mi><mi>a</mi><mo>∈</mo><mi>o</mi><mi>l</mi><mo>.</mo><mi>p</mi><mi>r</mi><mi>o</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>t</mi><mi>y</mi><mi>A</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>g</mi><mi>n</mi><mi>m</mi><mi>e</mi><mi>n</mi><mi>t</mi><mi>s</mi><mo>,</mo><mi>p</mi><mi>a</mi><mo>.</mo><mi>i</mi><mi>s</mi><mi>D</mi><mi>a</mi><mi>t</mi><mi>a</mi><mi>:</mi></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∄</mo><mspace width="3.0mm"/><mi>p</mi><mi>g</mi><mi>s</mi><mi>d</mi><mo>∈</mo><mi>o</mi><mi>l</mi><mo>.</mo><mi>p</mi><mi>r</mi><mi>o</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>t</mi><mi>y</mi><mi>A</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>g</mi><mi>n</mi><mi>m</mi><mi>e</mi><mi>n</mi><mi>t</mi><mi>s</mi><mi>:</mi></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>μ</mi><mfenced close=")" open="("><mrow><mi>p</mi><mi>g</mi><mi>s</mi><mi>d</mi></mrow></mfenced><mo>≠</mo><mstyle mathvariant="monospace"><mtext>PropertyNameValuePair</mtext></mstyle><mo>∧</mo><mi>p</mi><mi>g</mi><mi>s</mi><mi>d</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><mi>p</mi><mi>a</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi></math></p>
+</div>
+</li>
+<li>
+<p>Object literal may not have multiple <code>PropertyGetterDeclaration</code> or <code>PropertySetterDeclaration</code> with the same name (cf. 4.d [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.p.66)</a>]):</p>
+<div class="paragraph">
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∀</mo><mspace width="3.0mm"/><mi>p</mi><mi>g</mi><mo>∈</mo><mi>o</mi><mi>l</mi><mo>.</mo><mi>p</mi><mi>r</mi><mi>o</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>t</mi><mi>y</mi><mi>A</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>g</mi><mi>n</mi><mi>m</mi><mi>e</mi><mi>n</mi><mi>t</mi><mi>s</mi><mo>,</mo><mi>p</mi><mi>g</mi><mo>.</mo><mi>i</mi><mi>s</mi><mi>A</mi><mi>c</mi><mi>c</mi><mi>e</mi><mi>s</mi><mi>s</mi><mi>o</mi><mi>r</mi><mi>:</mi></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∄</mo><mspace width="3.0mm"/><mi>p</mi><msup><mi>g</mi><mi>'</mi></msup><mo>∈</mo><mi>o</mi><mi>l</mi><mo>.</mo><mi>p</mi><mi>r</mi><mi>o</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>t</mi><mi>y</mi><mi>A</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>g</mi><mi>n</mi><mi>m</mi><mi>e</mi><mi>n</mi><mi>t</mi><mi>s</mi><mfenced close="}" open="{"><mrow><mi>p</mi><mi>g</mi></mrow></mfenced><mi>:</mi></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mi>μ</mi><mfenced close=")" open="("><mrow><mi>p</mi><msup><mi>g</mi><mi>'</mi></msup></mrow></mfenced><mo>=</mo><mi>μ</mi><mfenced close=")" open="("><mrow><mi>p</mi><mi>g</mi></mrow></mfenced><mo>∧</mo><mi>p</mi><msup><mi>g</mi><mi>'</mi></msup><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><mi>p</mi><mi>g</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi></math></p>
+</div>
+</li>
+</ul>
+</div>
+<div class="quoteblock">
+<blockquote>
+It is a SyntaxError if the Identifier <code>eval</code> or the Identifier <code>arguments</code> occurs as the Identifier in a <code>PropertySetParameterList</code> of a <code>PropertyAssignment</code> that is contained in strict code or if its
+<code>FunctionBody</code> is strict code. [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.p.66)</a>]
+</blockquote>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>If two or more property assignments have the same name (and the previous conditions hold), then the types of these assignments must <em>conform</em>.
+That is to say that the inferred (but not declared) type of all assignments must be type of probably declared types and if the types are explicitly declared, they must be equal.</p>
+</li>
+<li>
+<p>In N4JS mode, the name of a property must be a valid N4JSIdentifier:</p>
+<div class="paragraph">
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>m</mi><mi>o</mi><mi>d</mi><mi>e</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>n4js</mtext></mstyle><mo>→</mo><mspace width="3.0mm"/><mo>∀</mo><mi>p</mi><mi>a</mi><mo>∈</mo><mi>o</mi><mi>l</mi><mo>.</mo><mi>p</mi><mi>r</mi><mi>o</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>t</mi><mi>y</mi><mi>A</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>g</mi><mi>n</mi><mi>m</mi><mi>e</mi><mi>n</mi><mi>t</mi><mi>s</mi><mi>:</mi></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mi>μ</mi><mfenced close=")" open="("><mrow><mi>p</mi><mi>a</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi></mrow></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>N4JSIdentifier</mtext></mstyle></math></p>
+</div>
+</li>
+</ul>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-22501"></a><strong>Req. IDE-22501:</strong> <a href="#Req-IDE-22501">Superfluous properties of an object literal</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>Let <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>E</mi></math> be the expected type of an object literal <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>O</mi></math> as defined by the context in which <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>O</mi></math> is used.
+If <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>E</mi></math> is not type <code>Object</code> and not dynamic, then the compiler creates a warning <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>O</mi></math> contains properties not found in <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>E</mi></math>.</p>
+</div>
+<div class="paragraph">
+<p>This is true in particular for object literals passed in as arguments of a spec-constructor.</p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_scoping-and-linking"><a class="anchor" href="#_scoping-and-linking"></a><a class="link" href="#_scoping-and-linking">8.1.5.2. Scoping and linking</a></h5>
+<div class="exampleblock">
+<div class="title">Example 82. Scoping and linking</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">var p = {
+    f: function() {
+        console.log("p´s f");
+    },
+    b: function() {
+        this.f();
+    },
+    o: {
+        nested: "Hello"
+    }
+};
+p.b();
+p.o.nested;</code></pre>
+</div>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Other properties within an object literal property can be accessed using this.
+In the expression of property name value pairs, however, <code>this</code> is not be bound to the containing object literal, but usually to undefined or global.</p>
+</li>
+<li>
+<p>The properties of an object literal are accessible from outside.</p>
+</li>
+<li>
+<p>Nested properties of an object literal are also accessible from outside.</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+<h5 id="type-inference-3" class="discrete">Type Inference</h5>
+<div class="paragraph">
+<p>An object literal implicitly extends <code>~Object</code>, therefore, object literal types use structural typing.
+For details see <a href="classifiers.html#_structural-typing">Structural Typing</a>.
+From a type systems point of view, the two variables <code>ol</code> and <code>st</code> below have the same type.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">var ol = {
+    s: "hello",
+    n: 42
+}
+var st: ~Object with { s: string; n: number;};</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_parenthesized-expression-and-grouping-operator"><a class="anchor" href="#_parenthesized-expression-and-grouping-operator"></a><a class="link" href="#_parenthesized-expression-and-grouping-operator">8.1.6. Parenthesized Expression and Grouping Operator</a></h4>
+<div class="paragraph">
+<p>The grouping operator is defined here as a parenthesized expression.</p>
+</div>
+<h5 id="parenthesized-expression-grouping-syntax" class="discrete">Syntax</h5>
+<div class="paragraph">
+<p>cf. [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.S11.1.6, p.p.67)</a>]</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">ParenExpression &lt;Yield&gt;: '(' expression=Expression&lt;In=true,Yield&gt; ')';</code></pre>
+</div>
+</div>
+<h5 id="Grouping-Operator-type-inference" class="discrete">Type Inference</h5>
+<div class="paragraph">
+<p>The type of the grouping operator simply is the type of its nested expression.
+The type if a parenthesized expression <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>p</mi><mi>e</mi></math> is inferred as follows:</p>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><mi>Γ</mi><mo>⊢</mo><mi>e</mi><mi>:</mi><mi>T</mi></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mstyle mathvariant="monospace"><mtext>’(’</mtext></mstyle><mi>e</mi><mstyle mathvariant="monospace"><mtext>’)’</mtext></mstyle><mi>:</mi><mi>T</mi></mrow></mfrac></math>
+</div>
+</div>
+<div class="exampleblock">
+<div class="title">Example 83. Parenthesized Expression Type Examples</div>
+<div class="content">
+<div class="paragraph">
+<p>In the following listing, the type of the plain expressions is equivalent to the parenthesized versions:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">class A{} class B extends A{}
+var f: boolean; var a: A a; var b: B;
+
+/* simple       &lt;-&gt;     parenthesized */
+10;                     (10);
+"hello";                ("hello");
+true;                   (true);
+a;                      (a);
+10-5;                   (10-5);
+f?a:b                   (f?a:b);</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_property-accessors"><a class="anchor" href="#_property-accessors"></a><a class="link" href="#_property-accessors">8.1.7. Property Accessors</a></h4>
+<h5 id="property-accessor-syntax" class="discrete">Syntax</h5>
+<div class="paragraph">
+<p>Property accessors in N4JS are based on [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.S11.2.1, p.p.67ff)</a>].
+They cannot only be used for accessing properties of an object, but also for accessing members of a class instance.
+In order to support parameterized calls, the syntax is extended to optionally allow type arguments.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">ParameterizedPropertyAccessExpression:
+    target=PrimaryExpression&lt;Yield&gt; ParameterizedPropertyAccessExpressionTail&lt;Yield&gt;
+;
+
+IndexedAccessExpression:
+    target=PrimaryExpression&lt;Yield&gt; IndexedAccessExpressionTail&lt;Yield&gt;
+;
+
+fragment IndexedAccessExpressionTail &lt;Yield&gt;*:
+    '[' index=Expression&lt;In=true,Yield&gt; ']'
+;
+
+fragment ParameterizedPropertyAccessExpressionTail &lt;Yield&gt;*:
+    '.' TypeArguments? property=[types::IdentifiableElement|IdentifierName]
+;</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Note that in [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a</a>], the <code>index access</code> is called <code><em>bracket notation</em></code>.</p>
+</div>
+<h5 id="property-access-direct" class="discrete">Direct Property Access</h5>
+<div class="paragraph">
+<p>We define a special case of property access as follows:</p>
+</div>
+<div class="openblock definition">
+<div class="content">
+<div class="paragraph">
+<p><a id="direct_property_access"></a><strong>Definition:</strong> <a href="#direct_property_access">Direct Property Access</a></p>
+</div>
+<div class="paragraph">
+<p>A property access expression is called <em>direct</em>, iff</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>its target is an identifier reference to a class, interface, enum, or the built-in object <code>Symbol</code>, and</p>
+</li>
+<li>
+<p>its property name denotes an <em>owned</em> member of the target classifier (not an inherited, consumed, or polyfilled member) or a literal if the target is an enum.</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>As a consequence, a direct property access can only refer to static members.</p>
+</div>
+<div class="paragraph">
+<p>The first requirement of the above definition rules out property access expressions that do not directly point to their target classifier or enum, as shown in the following example:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">class C {
+  const field = 'hello';
+}
+C.field;  // direct property access to 'field'
+let ctor = C;
+ctor.field;  // *not* a direct property access to 'field'</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Direct property access is the only form of property access allowed in compile-time expressions, cf. <a href="#compile-time-expressions">Compile-Time Expressions</a>.</p>
+</div>
+<div class="sect4">
+<h5 id="properties-1"><a class="anchor" href="#properties-1"></a><a class="link" href="#properties-1">8.1.7.1. Properties</a></h5>
+<div class="paragraph">
+<p>We define the following properties:</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><code>target</code> </dt>
+<dd>
+<p>The receiver of the property access.</p>
+</dd>
+<dt class="hdlist1"><code>index</code> </dt>
+<dd>
+<p>The index expression in case of an IndexedAccessExpression (returns <math xmlns="http://www.w3.org/1998/Math/MathML"><mstyle mathvariant="monospace"><mtext>null</mtext></mstyle></math> otherwise).</p>
+</dd>
+<dt class="hdlist1"><code>property</code> </dt>
+<dd>
+<p>The name of the property in case of non-indexed-access expressions (returns <math xmlns="http://www.w3.org/1998/Math/MathML"><mstyle mathvariant="monospace"><mtext>null</mtext></mstyle></math> otherwise, although the index may be interpreted as property name).</p>
+</dd>
+</dl>
+</div>
+<div class="paragraph">
+<p>We define the following pseudo properties:</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><code>isDotAccess</code> </dt>
+<dd>
+<p>Read-only boolean property, returns true for non-index access expression (similar to <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>μ</mi><mfenced close=")" open="("><mi>p</mi></mfenced><mo>≠</mo><mstyle mathvariant="monospace"><mtext>IndexedAccessExpression</mtext></mstyle></math>).</p>
+</dd>
+<dt class="hdlist1"><code>isIndexAccess</code> </dt>
+<dd>
+<p>Read-only boolean property, returns true for index access expression (similar to <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>μ</mi><mfenced close=")" open="("><mi>p</mi></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>IndexedAccessExpression</mtext></mstyle></math>.<br>
+The equation <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>p</mi><mo>.</mo><mi>i</mi><mi>s</mi><mi>D</mi><mi>o</mi><mi>t</mi><mi>A</mi><mi>c</mi><mi>c</mi><mi>e</mi><mi>s</mi><mi>s</mi><mo>=</mo><mo>¬</mo><mi>p</mi><mo>.</mo><mi>i</mi><mi>s</mi><mi>I</mi><mi>n</mi><mi>d</mi><mi>e</mi><mi>x</mi><mi>A</mi><mi>c</mi><mi>c</mi><mi>e</mi><mi>s</mi><mi>s</mi></math> is always true.</p>
+</dd>
+<dt class="hdlist1"><code>name</code> </dt>
+<dd>
+<p>Returns the name of the property.
+This is either the <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>p</mi><mi>r</mi><mi>o</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>t</mi><mi>y</mi></math> converted to a simple name or the index converted to a name (where possible) if it is an indexed-accessed expression.</p>
+</dd>
+</dl>
+</div>
+<h5 id="property-acessors-semantics" class="discrete">Semantics</h5>
+<div class="paragraph">
+<p>The parameterization is part of the property access in case of generic methods.
+For generic functions, a parameterized function call is introduced (cf. <a href="#_function-calls">Function Calls</a>).
+The constraints are basically similar.</p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-97"></a><strong>Req. IDE-97:</strong> <a href="#Req-IDE-97">Property Access and Dot Notation</a> (ver. 1)</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>If dot notation is used in N4JS mode, the referenced property must exist unless receiver is a dynamic type:</p>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mspace width="3.0mm"/><mi>p</mi><mi>a</mi><mi>e</mi><mo>.</mo><mi>i</mi><mi>s</mi><mi>D</mi><mi>o</mi><mi>t</mi><mi>A</mi><mi>c</mi><mi>c</mi><mi>e</mi><mi>s</mi><mi>s</mi><mo>∧</mo><mo>¬</mo><mi>R</mi><mo>.</mo><mi>d</mi><mi>y</mi><mi>n</mi><mo>→</mo><mtext>
+</mtext><mspace width="3.0mm"/><mo>∃</mo><mi>m</mi><mo>∈</mo><mi>p</mi><mi>a</mi><mi>e</mi><mo>.</mo><mi>t</mi><mi>a</mi><mi>r</mi><mi>g</mi><mi>e</mi><mi>t</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mo>.</mo><mi>p</mi><mi>r</mi><mi>o</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>t</mi><mi>i</mi><mi>e</mi><mi>s</mi><mi>:</mi><mi>m</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><mi>p</mi><mi>a</mi><mi>e</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi></math>
+</div>
+</div>
+</li>
+<li>
+<p>If dot notation is used and the referenced property exists, then the property must be accessible:</p>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mspace width="3.0mm"/><mi>p</mi><mi>a</mi><mi>e</mi><mo>.</mo><mi>i</mi><mi>s</mi><mi>D</mi><mi>o</mi><mi>t</mi><mi>A</mi><mi>c</mi><mi>c</mi><mi>e</mi><mi>s</mi><mi>s</mi><mo>∧</mo><mo>¬</mo><mi>R</mi><mo>.</mo><mi>d</mi><mi>y</mi><mi>n</mi><mo>→</mo><mtext>
+</mtext><mspace width="3.0mm"/><mfenced close=")" open="("><mrow><mo>∃</mo><mi>m</mi><mo>∈</mo><mi>p</mi><mi>a</mi><mi>e</mi><mo>.</mo><mi>t</mi><mi>a</mi><mi>r</mi><mi>g</mi><mi>e</mi><mi>t</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mo>.</mo><mi>p</mi><mi>r</mi><mi>o</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>t</mi><mi>i</mi><mi>e</mi><mi>s</mi><mi>:</mi><mi>m</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><mi>p</mi><mi>a</mi><mi>e</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi></mrow></mfenced><mo>→</mo><mi>α</mi><mfenced close=")" open="("><mrow><mi>p</mi><mi>a</mi><mi>e</mi></mrow><mi>m</mi></mfenced></math>
+</div>
+</div>
+</li>
+<li>
+<p>If dot notation is used and the referenced property exists and this property is a member with a declared <code>@This</code> type (only possible for methods or field accessors),
+then the receiver must be a subtype of the declared <code>@This</code> type.</p>
+</li>
+</ol>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-98"></a><strong>Req. IDE-98:</strong> <a href="#Req-IDE-98">Index Access</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>An index access expression is valid iff one of the following cases applies:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>the receiver is of a dynamic type. In this case, the index may be any expression (need not be a compile-time expression).</p>
+</li>
+<li>
+<p>the receiver is an immediate instance of <code>Object</code>, i.e. it is a subtype of <code>Object</code> and its super types but <strong>not</strong> of any other type including <code>~Object</code> and <code>~~Object</code>.</p>
+</li>
+<li>
+<p>the receiver is of type Array, ArgumentType, string, or String (including their subtypes) <strong>and</strong> the index is an expression of type <code>number</code>.</p>
+</li>
+<li>
+<p>the index expression is a compile-time expression</p>
+<div class="ulist">
+<ul>
+<li>
+<p><strong>and</strong> the receiver type defines a member with a name equal to the string representation of the index expression&#8217;s compile-time value<br></p>
+</li>
+<li>
+<p><strong>and</strong> the receiver is not an enum.</p>
+</li>
+</ul>
+</div>
+</li>
+</ol>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Although index access is very limited, it is still possible to use immediate instances of <code>Object</code> in terms of a map (but this applies only to index access, not the dot notation):</p>
+</div>
+<div class="exampleblock">
+<div class="title">Example 84. Object as Map</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">var map: Object = new Object();
+map["Kant"] = "Imperative";
+map["Hegel"] = "Dialectic";
+map.spinoza = "Am I?";  // error: Couldn't resolve reference to IdentifiableElement 'spinoza'.</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-99"></a><strong>Req. IDE-99:</strong> <a href="#Req-IDE-99">Parameterized Property Access</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>For a parameterized property access expression <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>p</mi><mi>a</mi><mi>e</mi></math>, the following constraints must hold:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>The receiver or target must be a function or method:<br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>p</mi><mi>a</mi><mi>e</mi><mo>.</mo><mi>t</mi><mi>a</mi><mi>r</mi><mi>g</mi><mi>e</mi><mi>t</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mstyle mathvariant="monospace"><mtext>Function</mtext></mstyle></math></p>
+</li>
+<li>
+<p>The number of type arguments must match the number of type parameters of the generic function or method:<br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mo>|</mo><mi>p</mi><mi>a</mi><mi>e</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>A</mi><mi>r</mi><mi>g</mi><mi>s</mi><mo>|</mo><mo>=</mo><mo>|</mo><mi>p</mi><mi>a</mi><mi>e</mi><mo>.</mo><mi>t</mi><mi>a</mi><mi>r</mi><mi>g</mi><mi>e</mi><mi>t</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>V</mi><mi>a</mi><mi>r</mi><mi>s</mi><mo>|</mo></math></p>
+</li>
+<li>
+<p>The type arguments of a parameterized property access expression must be subtypes of the boundaries of the parameters of the called generic method.</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>Also see constraints on read (<a href="#Req-IDE-93">[Req-IDE-93]</a>) and write (<a href="#Req-IDE-121">[Req-IDE-121]</a>) access.</p>
+</div>
+</div>
+</div>
+<h5 id="type-inference-5" class="discrete">Type Inference</h5>
+<div class="paragraph">
+<p>Cf. [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.S11.2.1, p.p.67ff)</a>]</p>
+</div>
+<div class="paragraph">
+<p>We define the following type inferencing rules for property accessors:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>The type of an indexed-access expression <em>p</em> is inferred as follows:</p>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mtable><mtr><mtd><mfrac><mrow><mo>¬</mo><mi>p</mi><mo>.</mo><mi>t</mi><mi>a</mi><mi>r</mi><mi>g</mi><mi>e</mi><mi>t</mi><mo>.</mo><mi>d</mi><mi>y</mi><mi>n</mi><mo>∨</mo><mi>p</mi><mo>.</mo><mi>i</mi><mi>n</mi><mi>d</mi><mi>e</mi><mi>x</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mfenced close="]" open="["><mrow><mi>n</mi><mi>u</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi></mrow></mfenced><mspace width="3.0mm"/><mi>Γ</mi><mo>⊢</mo><mi>p</mi><mo>.</mo><mi>t</mi><mi>a</mi><mi>r</mi><mi>g</mi><mi>e</mi><mi>t</mi><mi>:</mi><mstyle mathvariant="monospace"><mtext>Array</mtext></mstyle><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>T</mtext></mstyle><mo>&gt;</mo></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mi>p</mi><mi>:</mi><mi>T</mi></mrow></mfrac></mtd></mtr><mtr><mtd><mfrac><mrow><mi>e</mi><mi>l</mi><mi>s</mi><mi>e</mi></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mi>p</mi><mi>:</mi><mstyle mathvariant="monospace"><mtext>any</mtext></mstyle></mrow></mfrac></mtd></mtr></mtable></math>
+</div>
+</div>
+</li>
+<li>
+<p>The type of a property access expression is inferred as follows:</p>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mtable><mtr><mtd><mfrac><mrow><mi>Γ</mi><mo>←</mo><mi>θ</mi><mfenced close=")" open="("><mi>R</mi></mfenced><mo>⊢</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mo>.</mo><mi>t</mi><mi>a</mi><mi>r</mi><mi>g</mi><mi>e</mi><mi>t</mi><mi>:</mi><mi>R</mi><mspace width="3.0mm"/><mi>Γ</mi><mo>⊢</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mo>.</mo><mi>p</mi><mi>r</mi><mi>o</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>t</mi><mi>y</mi><mi>:</mi><mi>T</mi></mrow><mrow><mstyle mathvariant="monospace"><mtext>PropertyAccessExpression</mtext></mstyle><mi> </mi><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>:</mi><mi>T</mi></mrow></mfrac></mtd></mtr></mtable></math>
+</div>
+</div>
+</li>
+<li>
+<p>The type of a parameterized access expression <em>p</em> is inferred as follows:</p>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mtable><mtr><mtd><mfrac><mrow><mo>∃</mo><mi>m</mi><mo>∈</mo><mi>p</mi><mo>.</mo><mi>t</mi><mi>a</mi><mi>r</mi><mi>g</mi><mi>e</mi><mi>t</mi><mi>:</mi><mi>m</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><mi>p</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mspace width="3.0mm"/><mi>Γ</mi><mo>⊢</mo><mi>m</mi><mi>:</mi><mi>T</mi></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mi>p</mi><mi>:</mi><mi>T</mi></mrow></mfrac></mtd></mtr><mtr><mtd><mfrac><mrow/><mrow><mi>Γ</mi><mo>⊢</mo><mi>p</mi><mi>:</mi><mstyle mathvariant="monospace"><mtext>any</mtext></mstyle></mrow></mfrac></mtd></mtr></mtable></math>
+</div>
+</div>
+</li>
+</ul>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_new-expression"><a class="anchor" href="#_new-expression"></a><a class="link" href="#_new-expression">8.1.8. New Expression</a></h4>
+<div class="paragraph">
+<p>cf. [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.S11.2.2, p.p.68)</a>]</p>
+</div>
+<h5 id="new-expression-syntax" class="discrete">Syntax</h5>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">NewExpression: 'new' callee=MemberExpression&lt;Yield&gt; (-&gt; TypeArguments)?
+        (=&gt; withArgs?='(' Arguments&lt;Yield&gt;? ')' )?</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">import Address from "my/Address";
+
+var a = new Address();
+// a.type := my/Address
+
+class C&lt;T&gt; {
+    constructor(param: T) {}
+}
+var c = new C&lt;string&gt;("hello");</code></pre>
+</div>
+</div>
+<h5 id="new-expression-semantics" class="discrete">Semantics</h5>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-100"></a><strong>Req. IDE-100:</strong> <a href="#Req-IDE-100">New expression</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>Let <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>n</mi><mi>e</mi></math> be a new expression, with <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>Γ</mi><mo>⊢</mo><mi>n</mi><mi>e</mi><mo>.</mo><mi>c</mi><mi>a</mi><mi>l</mi><mi>l</mi><mi>e</mi><mi>e</mi><mi>:</mi><mi>C</mi></math>.
+The following constraints must hold:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p><a id="new-expression-1"></a> The callee must be a constructor type: <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>C</mi><mo>&lt;</mo><mi>:</mi><mstyle mathvariant="monospace"><mtext>constructor</mtext></mstyle><mfenced close="}" open="{"><mi>?</mi></mfenced></math>  or a constructable type.</p>
+</li>
+<li>
+<p><a id="new-expression-2"></a> Let <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>O</mi></math> be the type argument of <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>C</mi></math>, that is <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>C</mi><mo>=</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>s</mi><mi>t</mi><mi>r</mi><mi>u</mi><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi><mfenced close="}" open="{"><mi>O</mi></mfenced></math>. In that case,</p>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>O</mi></math> must not be an interface or enum: <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>μ</mi><mfenced close=")" open="("><mi>C</mi></mfenced><mo>∉</mo><mfenced close="}" open="{"><mstyle mathvariant="monospace"><mtext>Interface</mtext></mstyle><mstyle mathvariant="monospace"><mtext>Enum</mtext></mstyle></mfenced></math></p>
+</li>
+<li>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>O</mi></math> must not contain any wildcards.</p>
+</li>
+<li>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>O</mi></math> must not be a type variable.</p>
+</li>
+</ol>
+</div>
+</li>
+<li>
+<p><a id="new-expression-3"></a> If <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>C</mi></math> is not a constructor type, it must be a constructable type, that is one of the following:</p>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfenced close="}" open="{"><mtable><mtr><mtd><mstyle mathvariant="monospace"><mtext>Object, Function, String, Boolean,</mtext></mstyle></mtd></mtr><mtr><mtd><mstyle mathvariant="monospace"><mtext>Number, Array, Date, RegExp, Error</mtext></mstyle></mtd></mtr></mtable></mfenced></math>
+</div>
+</div>
+<div class="paragraph">
+<p>In particular, it must not refer to a primitive type or a defined
+functions (i.e., subtypes of <code>Function</code>) cannot be used in new-expressions in
+N4JS.</p>
+</div>
+</li>
+</ol>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Remarks:</p>
+</div>
+<div class="paragraph">
+<p>to <a href="#new-expression-1">1</a> The type of an abstract class <code>A</code> is <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mfenced close="}" open="{"><mi>A</mi></mfenced></math>.
+Or in other words: Only instantiable classes have an inferred type of <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>c</mi><mi>o</mi><mi>n</mi><mi>s</mi><mi>t</mi><mi>r</mi><mi>u</mi><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi><mfenced close="}" open="{"><mrow><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/></mrow></mfenced></math>.</p>
+</div>
+<div class="paragraph">
+<p>to <a href="#new-expression-2">2</a> Even though it is possible to use the constructor type of an abstract class – concrete subclasses with override compatible constructor signature will be subclasses of this constructor.</p>
+</div>
+<div class="paragraph">
+<p>to <a href="#new-expression-3">3</a> It is not possible to refer to union or intersection at that location. So this is not explicitly denied here since it is not possible anyway.</p>
+</div>
+<div class="exampleblock">
+<div class="title">Example 85. Abstract classes and construction</div>
+<div class="content">
+<div class="paragraph">
+<p>The following examples demonstrates the usage of abstract classes and constructor types, to make the first two constraints more clearer:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">/* XPECT_SETUP org.eclipse.n4js.spec.tests.N4JSSpecTest END_SETUP */
+
+abstract class A {}
+class B extends A {}
+
+// XPECT errors --&gt; "Cannot instantiate abstract class A." at "A"
+var x = new A();
+// XPECT noerrors --&gt;
+var y = new B();
+
+function foo(ctor : constructor{A}) {
+    // XPECT noerrors --&gt;
+    return new ctor();
+}
+
+// XPECT errors --&gt; "type{A} is not a subtype of constructor{A}." at "A"
+foo(A);
+// XPECT noerrors --&gt;
+foo(B);</code></pre>
+</div>
+</div>
+</div>
+</div>
+<h5 id="type-inference-6" class="discrete">Type Inference</h5>
+<div class="paragraph">
+<p>The type of a new expression <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>n</mi><mi>e</mi></math> is inferred as follows:</p>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><mi>Γ</mi><mo>⊢</mo><mi>n</mi><mi>e</mi><mo>.</mo><mi>c</mi><mi>a</mi><mi>l</mi><mi>l</mi><mi>e</mi><mi>e</mi><mi>:</mi><mstyle mathvariant="monospace"><mtext>constructor</mtext><mtext>C</mtext></mstyle></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mi>n</mi><mi>e</mi><mi>:</mi><mi>C</mi></mrow></mfrac></math>
+</div>
+</div>
+<div class="paragraph">
+<p>For classes, constructors are described in <a href="types.html#_constructor-and-classifier-type">Constructor and Classifier Type</a>.</p>
+</div>
+<div class="paragraph">
+<p>In N4JS it is not allowed to call new on a plain function.
+For example:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">function foo() {}
+var x = new foo();</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>will issue an error.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_function-expression-2"><a class="anchor" href="#_function-expression-2"></a><a class="link" href="#_function-expression-2">8.1.9. Function Expression</a></h4>
+<div class="paragraph">
+<p>See <a href="functions.html#_functions">Functions</a> for details.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_function-calls"><a class="anchor" href="#_function-calls"></a><a class="link" href="#_function-calls">8.1.10. Function Calls</a></h4>
+<div class="paragraph">
+<p>In N4JS, a function call [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.S11.2.3)</a>] is similar to a method call.
+Additionally to the ECMAScript’s CallExpression, a ParameterizedCallExpression is introduced to allow type arguments passed to plain functions.</p>
+</div>
+<h5 id="_syntax-12" class="discrete">Syntax</h5>
+<div class="literalblock">
+<div class="content">
+<pre>[[function-calls-syntax]]</pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Similar to [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.S11.2.3, p.p.68ff)</a>], a function call is defined as follows:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">CallExpression &lt;Yield&gt;:
+    target=IdentifierRef&lt;Yield&gt;
+    ArgumentsWithParentheses&lt;Yield&gt;
+;
+
+ParameterizedCallExpression &lt;Yield&gt;:
+    TypeArguments
+    target=IdentifierRef&lt;Yield&gt;
+    ArgumentsWithParentheses&lt;Yield&gt;
+;
+
+fragment ArgumentsWithParentheses &lt;Yield&gt;*:
+    '(' Arguments&lt;Yield&gt;? ')'
+;
+
+fragment Arguments &lt;Yield&gt;*:
+    arguments+=AssignmentExpression&lt;In=true,Yield&gt; (',' arguments+=AssignmentExpression&lt;In=true,Yield&gt;)* (',' spread?='...' arguments+=AssignmentExpression&lt;In=true,Yield&gt;)?
+    | spread?='...' arguments+=AssignmentExpression&lt;In=true,Yield&gt;
+;</code></pre>
+</div>
+</div>
+<h5 id="function-calls-semantics" class="discrete">Semantics</h5>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-101"></a><strong>Req. IDE-101:</strong> <a href="#Req-IDE-101">Function Call Constraints</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>For a given call expression <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>f</mi></math> bound to a method or function declaration <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>F</mi></math>, the following constraints must hold:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>If less arguments are provided than formal parameters were declared, the missing formal parameters must have been declared optional:<br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mo>|</mo><mi>f</mi><mo>.</mo><mi>a</mi><mi>r</mi><mi>g</mi><mi>s</mi><mo>|</mo><mo>&lt;</mo><mo>|</mo><mi>F</mi><mo>.</mo><mi>p</mi><mi>a</mi><mi>r</mi><mi>s</mi><mo>|</mo><mo>→</mo><mo>∀</mo><mo>|</mo><mi>f</mi><mo>.</mo><mi>a</mi><mi>r</mi><mi>g</mi><mi>s</mi><mo>|</mo><mo>&lt;</mo><mi>i</mi><mo>≤</mo><mo>|</mo><mi>F</mi><mo>.</mo><mi>p</mi><mi>a</mi><mi>r</mi><mi>s</mi><mo>|</mo><mi>:</mi><msub><mi>F</mi><mi>p</mi></msub><mi>a</mi><mi>r</mi><msub><mi>s</mi><mi>i</mi></msub><mo>.</mo><mi>o</mi><mi>p</mi><mi>t</mi><mi>i</mi><mi>o</mi><mi>n</mi><mi>a</mi><mi>l</mi></math></p>
+</li>
+<li>
+<p>If more arguments are provided than formal parameters were declared, the last formal parameter must have been declared variadic:<br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mo>|</mo><mi>f</mi><mo>.</mo><mi>a</mi><mi>r</mi><mi>g</mi><mi>s</mi><mo>|</mo><mo>&gt;</mo><mo>|</mo><mi>F</mi><mo>.</mo><mi>p</mi><mi>a</mi><mi>r</mi><mi>s</mi><mo>|</mo><mo>→</mo><mi>F</mi><mo>.</mo><mi>p</mi><mi>a</mi><mi>r</mi><msub><mi>s</mi><mrow><mo>|</mo><mi>F</mi><mo>.</mo><mi>p</mi><mi>a</mi><mi>r</mi><mi>s</mi><mo>|</mo><mo>-</mo><mn>1</mn></mrow></msub><mo>.</mo><mi>v</mi><mi>a</mi><mi>r</mi><mi>i</mi><mi>a</mi><mi>d</mi><mi>i</mi><mi>c</mi></math></p>
+</li>
+<li>
+<p>Types of provided arguments must be subtypes of the formal parameter types:<br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∀</mo><mn>0</mn><mo>&lt;</mo><mi>i</mi><mo>&lt;</mo><mi>m</mi><mi>i</mi><mi>n</mi><mfenced close=")" open="("><mrow><mo>|</mo><mi>f</mi><mo>.</mo><mi>a</mi><mi>r</mi><mi>g</mi><mi>s</mi><mo>|</mo></mrow><mrow><mo>|</mo><mi>F</mi><mo>.</mo><mi>p</mi><mi>a</mi><mi>r</mi><mi>s</mi><mo>|</mo></mrow></mfenced><mi>:</mi><mi>f</mi><mo>.</mo><mi>a</mi><mi>r</mi><mi>g</mi><msub><mi>s</mi><mi>i</mi></msub><mo>&lt;</mo><mi>:</mi><mi>F</mi><mo>.</mo><mi>p</mi><mi>a</mi><mi>r</mi><msub><mi>s</mi><mi>i</mi></msub></math></p>
+</li>
+<li>
+<p>If more arguments are provided than formal parameters were declared, the type of the exceeding arguments must be a subtype of the last (variadic) formal parameter type:<br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∀</mo><mo>|</mo><mi>F</mi><mo>.</mo><mi>p</mi><mi>a</mi><mi>r</mi><mi>s</mi><mo>|</mo><mo>&lt;</mo><mi>i</mi><mo>≤</mo><mo>|</mo><mi>f</mi><mo>.</mo><mi>a</mi><mi>r</mi><mi>g</mi><mi>s</mi><mo>|</mo><mi>:</mi><mi>f</mi><mo>.</mo><mi>a</mi><mi>r</mi><mi>g</mi><msub><mi>s</mi><mi>i</mi></msub><mo>&lt;</mo><mi>:</mi><mi>F</mi><mo>.</mo><mi>p</mi><mi>a</mi><mi>r</mi><msub><mi>s</mi><mrow><mo>|</mo><mi>F</mi><mo>.</mo><mi>p</mi><mi>a</mi><mi>r</mi><mi>s</mi><mo>|</mo><mo>-</mo><mn>1</mn></mrow></msub></math></p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-102"></a><strong>Req. IDE-102:</strong> <a href="#Req-IDE-102">Parameterized Function Call Constraints</a> (ver. 1)</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>The number of type arguments in a parameterized call expression must be equal to the number of type parameters of the generic function / method and the
+type arguments must be subtypes of the corresponding declared upper boundaries of the type parameters of the called generic function.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Note that (for a limited time), constraints <a href="#Req-IDE-101">[Req-IDE-101]</a> and <a href="#Req-IDE-102">[Req-IDE-102]</a> are not applied if the the type of <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>F</mi></math> is <code>Function</code>.
+See <a href="types.html#_function-object-type">Function-Object-Type</a>.</p>
+</div>
+</div>
+</div>
+<h5 id="type-inference-7" class="discrete">Type Inference</h5>
+<div class="paragraph">
+<p>A call expression <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi></math> is bound to a method (<a href="classifiers.html#_methods">Methods</a>) or function declaration (which may be part of a function definition
+(<a href="functions.html#_function-declaration">Function Declaration</a> or specified via a function type <a href="functions.html#_function-type">Function Type</a>) <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>F</mi></math> (via evaluation of <code>MemberExpression</code>.
+The type of the call is inferred from the function declaration or type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>F</mi></math> as follows:</p>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><mi>b</mi><mi>i</mi><mi>n</mi><mi>d</mi><mfenced close=")" open="("><mrow><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mo>.</mo><mi>t</mi><mi>a</mi><mi>r</mi><mi>g</mi><mi>e</mi><mi>t</mi></mrow><mi>F</mi></mfenced><mspace width="3.0mm"/><mi>F</mi><mo>.</mo><mi>r</mi><mi>e</mi><mi>t</mi><mi>u</mi><mi>r</mi><mi>n</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>:</mi><mi>T</mi></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>:</mi><mi>T</mi></mrow></mfrac></math>
+</div>
+</div>
+<div class="paragraph">
+<p>A generic method invocation may be parameterized as well.
+This is rarely required as the function argument types are usually inferred from the given arguments.
+In some cases, for instance with pathSelectors, this is useful.
+In that case, the type variable defined in the generic method declaration is explicitly bound to types by using type arguments.
+See <a href="#_property-accessors">Property Accessors</a> for semantics and type inference.</p>
+</div>
+<div class="exampleblock">
+<div class="title">Example 86. Generic Method Invocation</div>
+<div class="content">
+<div class="paragraph">
+<p>This examples demonstrate how to explicitly
+define the type argument in a method call in case it cannot be inferred
+automatically.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">class C {
+    static &lt;T&gt; foo(p: pathSelector&lt;T&gt;): void {..}
+};
+C.&lt;my.Address&gt;foo("street.number");</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Note that in many cases, the type inferencer should be able to infer the type automatically.
+For example, for a method</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">function &lt;T&gt; bar(c: T, p: pathSelector&lt;T&gt;): void {..};</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>and a function call</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">bar(context, "some.path.selector");
+[source,n4js]</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>the type variable <code>T</code> can be automatically bound to the type of variable <code>context</code>.</p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_postfix-expression"><a class="anchor" href="#_postfix-expression"></a><a class="link" href="#_postfix-expression">8.1.11. Postfix Expression</a></h4>
+<h5 id="postfix-expression-syntax" class="discrete">Syntax</h5>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">PostfixExpression returns Expression: LeftHandSideExpression
+         (=&gt;({PostfixExpression.expression=current} /* no line terminator here */ op=PostfixOperator))?
+    ;
+enum PostfixOperator: inc='++' | dec='--';</code></pre>
+</div>
+</div>
+<h5 id="semantics-and-type-inference" class="discrete">Semantics and Type Inference</h5>
+<div class="paragraph">
+<p>The type inference and constraints for postfix operators <code>++</code> and <code>--</code>, cf. [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.S11.3.1, p.p.70)</a>], [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.S11.3.1, p.p.70)</a>],
+are defined similarly to their prefix variants (unary expressions), see <a href="#_unary-expression">Unary Expression</a>.</p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-103"></a><strong>Req. IDE-103:</strong> <a href="#Req-IDE-103">Postfix Expression Constraints</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>For a given postfix expression <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>u</mi></math> <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>u</mi></math> with <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>u</mi><mo>.</mo><mi>o</mi><mi>p</mi><mo>∈</mo><mfenced close="}" open="{"><mrow><mo>+</mo><mo>+</mo></mrow><mrow><mo>-</mo><mo>-</mo></mrow></mfenced></math> and <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>u</mi><mo>.</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>e</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>o</mi><mi>n</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>:</mi><mi>T</mi></math>, the following constraints must hold:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>In N4JS mode, the type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi></math> of the expression must be a number.</p>
+</li>
+<li>
+<p>If <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>u</mi><mo>.</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>e</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>o</mi><mi>n</mi><mo>=</mo><mi>P</mi><mi>r</mi><mi>o</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>t</mi><mi>y</mi><mi>A</mi><mi>c</mi><mi>c</mi><mi>e</mi><mi>s</mi><mi>s</mi><mspace width="0.278em"/><mi>p</mi><mi>a</mi><mfenced close=")" open="("><mi>p</mi></mfenced><mo>∧</mo><mi>p</mi><mi>a</mi><mo>.</mo><mi>i</mi><mi>s</mi><mi>D</mi><mi>o</mi><mi>t</mi><mi>A</mi><mi>c</mi><mi>c</mi><mi>e</mi><mi>s</mi><mi>s</mi><mo>→</mo></math> both <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>g</mi><mi>e</mi><mi>t</mi></math> <em>p</em> and <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>s</mi><mi>e</mi><mi>t</mi></math> <em>p</em> must be defined.</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_unary-expression"><a class="anchor" href="#_unary-expression"></a><a class="link" href="#_unary-expression">8.1.12. Unary Expression</a></h4>
+<h5 id="unary-expression-syntax" class="discrete">Syntax</h5>
+<div class="paragraph">
+<p>We define the following unary operators and expression, similar to [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.p.70ff)</a>]:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">UnaryExpression returns Expression:
+      PostfixExpression
+    | ({UnaryExpression} op=UnaryOperator expression=UnaryExpression);
+enum UnaryOperator: delete | void | typeof | inc='++' | dec='--' | pos='+' | neg='-' | inv='$\sim$' | not='!';</code></pre>
+</div>
+</div>
+<h5 id="unary-expression-semantics" class="discrete">Semantics</h5>
+<div class="paragraph">
+<p>For semantics of the delete operator, see also [<a href="appendix_c_bibliography.html#MozillaJSRef">MozillaJSRef</a>]</p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-104"></a><strong>Req. IDE-104:</strong> <a href="#Req-IDE-104">Delete Operator Constraints</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>For a given unary expression <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>u</mi></math> with <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>u</mi><mo>.</mo><mi>o</mi><mi>p</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>delete</mtext></mstyle></math>, the following constraints must hold:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>In strict mode, <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>u</mi><mo>.</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>e</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>o</mi><mi>n</mi></math> must be a reference to a property of an object literal, a member of a class type, or to a property of the global type
+(i.e., the reference must be bound, and the bound target must not be a variable).</p>
+</li>
+<li>
+<p>In N4JS mode, the referenced property or member must not be declared in the containing type and the containing type reference must be declared dynamic.</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-105"></a><strong>Req. IDE-105:</strong> <a href="#Req-IDE-105">Void Operator Constraints</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>There are no specific constraints defined for with <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>u</mi><mo>.</mo><mi>o</mi><mi>p</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>void</mtext></mstyle></math></p>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-106"></a><strong>Req. IDE-106:</strong> <a href="#Req-IDE-106">Typeof Operator Constraints</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>There are no specific constraints defined for unary expression <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>u</mi></math> with <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>u</mi><mo>.</mo><mi>o</mi><mi>p</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>typeof</mtext></mstyle></math>.</p>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-107"></a><strong>Req. IDE-107:</strong> <a href="#Req-IDE-107">Increment/Decrement Constraints</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>For a given unary expression <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>u</mi></math> <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>u</mi></math> with <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>u</mi><mo>.</mo><mi>o</mi><mi>p</mi><mo>∈</mo><mfenced close="}" open="{"><mrow><mo>+</mo><mo>+</mo></mrow><mrow><mo>-</mo><mo>-</mo></mrow></mfenced></math> and <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>u</mi><mo>.</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>e</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>o</mi><mi>n</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>:</mi><mi>T</mi></math>, the following constraints must hold:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>If mode is N4JS,  the type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi></math> of the expression must be a number</p>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow/><mrow><mi>Γ</mi><mo>⊢</mo><mstyle mathvariant="monospace"><mtext>UnaryExpression</mtext></mstyle><mo>⊲</mo><mstyle mathvariant="monospace"><mtext>Expression</mtext></mstyle><mi>:</mi><mstyle mathvariant="monospace"><mtext>number</mtext></mstyle></mrow></mfrac></math>
+</div>
+</div>
+</li>
+<li>
+<p>If <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>u</mi><mo>.</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>e</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>o</mi><mi>n</mi><mo>=</mo><mi>P</mi><mi>r</mi><mi>o</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>t</mi><mi>y</mi><mi>A</mi><mi>c</mi><mi>c</mi><mi>e</mi><mi>s</mi><mi>s</mi><mspace width="0.278em"/><mi>p</mi><mi>a</mi><mfenced close=")" open="("><mi>p</mi></mfenced><mo>∧</mo><mi>p</mi><mi>a</mi><mo>.</mo><mi>i</mi><mi>s</mi><mi>D</mi><mi>o</mi><mi>t</mi><mi>A</mi><mi>c</mi><mi>c</mi><mi>e</mi><mi>s</mi><mi>s</mi></math> <math xmlns="http://www.w3.org/1998/Math/MathML"><mo>→</mo></math> both <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>g</mi><mi>e</mi><mi>t</mi></math> <em>p</em> and <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>s</mi><mi>e</mi><mi>t</mi></math> <em>p</em> must be defined.</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-108"></a><strong>Req. IDE-108:</strong> <a href="#Req-IDE-108">Unary Plus/Minus/Bitwise Not Operator Constraints</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>For a given unary expression <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>u</mi></math> <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>u</mi></math> with <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>u</mi><mo>.</mo><mi>o</mi><mi>p</mi><mo>∈</mo><mfenced close="}" open="{"><mo>+</mo><mo>-</mo><mo>∼</mo></mfenced></math> and <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>u</mi><mo>.</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>e</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>o</mi><mi>n</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>:</mi><mi>T</mi></math>, the following constraints must hold:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>In N4JS mode, the type T of the expression must be a number:</p>
+</li>
+</ul>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow/><mrow><mi>Γ</mi><mo>⊢</mo><mstyle mathvariant="monospace"><mtext>UnaryExpression</mtext></mstyle><mo>⊲</mo><mstyle mathvariant="monospace"><mtext>Expression</mtext></mstyle><mi>:</mi><mstyle mathvariant="monospace"><mtext>number</mtext></mstyle></mrow></mfrac></math>
+</div>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-109"></a><strong>Req. IDE-109:</strong> <a href="#Req-IDE-109">Logical Not Operator Constraints</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>There are no specific constraints defined for with <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>u</mi><mo>.</mo><mi>o</mi><mi>p</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>!</mtext></mstyle></math>.</p>
+</div>
+</div>
+</div>
+<h5 id="type-inference-8" class="discrete">Type Inference</h5>
+<div class="paragraph">
+<p>The following operators have fixed types independent of their operand types:</p>
+</div>
+<div class="paragraph">
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mfrac><mrow/><mrow><mi>Γ</mi><mo>⊢</mo><mstyle mathvariant="monospace"><mtext>’delete’</mtext></mstyle><mi> </mi><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>e</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>o</mi><mi>n</mi><mi>:</mi><mstyle mathvariant="monospace"><mtext>boolean</mtext></mstyle></mrow></mfrac></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mfrac><mrow/><mrow><mi>Γ</mi><mo>⊢</mo><mstyle mathvariant="monospace"><mtext>’void’</mtext></mstyle><mi> </mi><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>e</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>o</mi><mi>n</mi><mi>:</mi><mstyle mathvariant="monospace"><mtext>undefined</mtext></mstyle></mrow></mfrac></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mfrac><mrow/><mrow><mi>Γ</mi><mo>⊢</mo><mstyle mathvariant="monospace"><mtext>’typeof’</mtext></mstyle><mi> </mi><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>e</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>o</mi><mi>n</mi><mi>:</mi><mstyle mathvariant="monospace"><mtext>string</mtext></mstyle></mrow></mfrac></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mfrac><mrow/><mrow><mi>Γ</mi><mo>⊢</mo><mstyle mathvariant="monospace"><mtext>(’++’—’–’—’+’—’-’—’ ’)</mtext></mstyle><mi> </mi><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>e</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>o</mi><mi>n</mi><mi>:</mi><mstyle mathvariant="monospace"><mtext>number</mtext></mstyle></mrow></mfrac></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mfrac><mrow/><mrow><mi>Γ</mi><mo>⊢</mo><mstyle mathvariant="monospace"><mtext>’!’</mtext></mstyle><mi> </mi><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>e</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>o</mi><mi>n</mi><mi>:</mi><mstyle mathvariant="monospace"><mtext>boolean</mtext></mstyle></mrow></mfrac></math></p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_multiplicative-expression"><a class="anchor" href="#_multiplicative-expression"></a><a class="link" href="#_multiplicative-expression">8.1.13. Multiplicative Expression</a></h4>
+<h5 id="multiplicative-expression-syntax" class="discrete">Syntax</h5>
+<div class="paragraph">
+<p>Cf. [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.p.73ff)</a>]</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">MultiplicativeExpression returns Expression: UnaryExpression
+      (=&gt;({MultiplicativeExpression.lhs=current} op=MultiplicativeOperator) rhs=UnaryExpression)*;
+enum MultiplicativeOperator: times='*' | div='/' | mod='%';</code></pre>
+</div>
+</div>
+<h5 id="multiplicative-expression-semantics" class="discrete">Semantics</h5>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-110"></a><strong>Req. IDE-110:</strong> <a href="#Req-IDE-110">Multiplicative Expression Constraints</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>For a given multiplicative expression the following constraints must hold in N4JS mode :</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>The types of the operands may be any type:</p>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow/><mrow><mi>Γ</mi><mo>⊢</mo><mstyle mathvariant="monospace"><mtext>MultiplicativeExpression</mtext></mstyle><mo>⊲</mo><mstyle mathvariant="monospace"><mtext>Expression</mtext></mstyle><mi>:</mi><mstyle mathvariant="monospace"><mtext>any</mtext></mstyle></mrow></mfrac><mrow/></math>
+</div>
+</div>
+</li>
+</ul>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>If a non-numeric operand is used, the result may be <code>NaN</code> which actually is a number as well.</p>
+</div>
+<h5 id="_type-inference-6" class="discrete">Type Inference</h5>
+<div class="literalblock">
+<div class="content">
+<pre>[[type-inference-9]]</pre>
+</div>
+</div>
+<div class="paragraph">
+<p>The inferred type of a multiplicative expression always is number:</p>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow/><mrow><mi>Γ</mi><mo>⊢</mo><mstyle mathvariant="monospace"><mtext>MultiplicativeExpression</mtext></mstyle><mi>:</mi><mstyle mathvariant="monospace"><mtext>number</mtext></mstyle></mrow></mfrac></math>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_additive-expression"><a class="anchor" href="#_additive-expression"></a><a class="link" href="#_additive-expression">8.1.14. Additive Expression</a></h4>
+<h5 id="additive-expression-syntax" class="discrete">Syntax</h5>
+<div class="paragraph">
+<p>Cf. [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.p.75ff)</a>]</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">AdditiveExpression returns Expression: MultiplicativeExpression
+    (=&gt;({AdditiveExpression.lhs=current} op=AdditiveOperator) rhs=MultiplicativeExpression)*;
+enum AdditiveOperator: add='+' | sub='-';</code></pre>
+</div>
+</div>
+<h5 id="additive-expression-semantics" class="discrete">Semantics</h5>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-111"></a><strong>Req. IDE-111:</strong> <a href="#Req-IDE-111">Additive Expression Constraints</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>For a given additive expression the following constraints must hold in N4JS mode:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>The type of the operand can be any type:</p>
+</li>
+</ul>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mtable><mtr><mtd><mfrac><mrow/><mrow><mi>Γ</mi><mo>⊢</mo><mstyle mathvariant="monospace"><mtext>AdditiveExpression</mtext></mstyle><mi> </mi><mi>e</mi><mo>⊲</mo><mstyle mathvariant="monospace"><mtext>Expression</mtext></mstyle><mi>:</mi><mstyle mathvariant="monospace"><mtext>any</mtext></mstyle></mrow></mfrac></mtd></mtr></mtable></math>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>In JavaScript it is possible to subtract two non-numerics, leading to <code>NaN</code>. Also <code>undefined</code> or <code>null</code> may be used. The real difference is what type is to be returned (string or number, see below).</p>
+</div>
+<div class="sect4">
+<h5 id="type-inference-10"><a class="anchor" href="#type-inference-10"></a><a class="link" href="#type-inference-10">8.1.14.1. Type Inference</a></h5>
+<div class="paragraph language-n4js">
+<p>The type of an additive expression is usually inferred to <code>number</code>, except for addition which may lead to string as well.
+The result for the addition operator is only be a number if both operands are numbers, booleans, null, or undefined.
+Using <code>undefined</code> in an additive expression leads to <code>NaN</code> which actually is a number from the type system&#8217;s point of view. Additional analysis may create errors in the latter case though.</p>
+</div>
+<div class="paragraph">
+<p>We first define two helper rules to simplify the addition operator condition:</p>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mtable><mtr><mtd><mfrac><mrow><mo>∃</mo><mi>N</mi><mi>i</mi><mi>n</mi><mfenced close="}" open="{"><mstyle mathvariant="monospace"><mtext>number, int, boolean, null, undefined</mtext></mstyle></mfenced><mi>:</mi><mi>T</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mo>=</mo><mi>N</mi></mrow><mrow><mi>n</mi><mi>b</mi><mfenced close=")" open="("><mi>T</mi></mfenced></mrow></mfrac><mstyle mathvariant="monospace"><mtext>nb</mtext></mstyle></mtd></mtr><mtr><mtd><mfrac><mrow><mi>n</mi><mi>b</mi><mfenced close=")" open="("><mi>T</mi></mfenced><mo>∨</mo><mi> </mi><mrow><mo>(</mo><mi>μ</mi><mfenced close=")" open="("><mi>T</mi></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>Union</mtext></mstyle><mi> </mi><mo>∧</mo><mi> </mi><mo>∃</mo><mi> </mi><mi>E</mi><mo>∈</mo><mi>T</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mi>s</mi><mi>:</mi><mi>m</mi><mi>n</mi><mi>b</mi><mfenced close=")" open="("><mi>E</mi></mfenced></mrow></mrow><mrow><mi>m</mi><mi>n</mi><mi>b</mi><mfenced close=")" open="("><mi>T</mi></mfenced></mrow></mfrac><mstyle mathvariant="monospace"><mtext>mnb</mtext></mstyle></mtd></mtr><mtr><mtd><mfrac><mrow><mi>Γ</mi><mo>⊢</mo><mi>e</mi><mo>.</mo><mi>l</mi><mi>h</mi><mi>s</mi><mi>:</mi><mi>L</mi><mspace width="3.0mm"/><mi>Γ</mi><mo>⊢</mo><mi>e</mi><mo>.</mo><mi>r</mi><mi>h</mi><mi>s</mi><mi>:</mi><mi>R</mi><mspace width="3.0mm"/><mi>n</mi><mi>b</mi><mfenced close=")" open="("><mi>L</mi></mfenced><mspace width="3.0mm"/><mi>n</mi><mi>b</mi><mfenced close=")" open="("><mi>R</mi></mfenced></mrow><mrow><mi>t</mi><mi>o</mi><mi>N</mi><mi>u</mi><mi>m</mi><mfenced close=")" open="("><mrow><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi></mrow></mfenced></mrow></mfrac><mstyle mathvariant="monospace"><mtext>toNum</mtext></mstyle></mtd></mtr><mtr><mtd><mfrac><mrow><mi>Γ</mi><mo>⊢</mo><mi>e</mi><mo>.</mo><mi>l</mi><mi>h</mi><mi>s</mi><mi>:</mi><mi>L</mi><mspace width="3.0mm"/><mi>Γ</mi><mo>⊢</mo><mi>e</mi><mo>.</mo><mi>r</mi><mi>h</mi><mi>s</mi><mi>:</mi><mi>R</mi><mspace width="3.0mm"/><mi>m</mi><mi>n</mi><mi>b</mi><mfenced close=")" open="("><mi>L</mi></mfenced><mspace width="3.0mm"/><mi>m</mi><mi>n</mi><mi>b</mi><mfenced close=")" open="("><mi>R</mi></mfenced></mrow><mrow><mi>m</mi><mi>a</mi><mi>y</mi><mi>N</mi><mi>u</mi><mi>m</mi><mfenced close=")" open="("><mrow><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi></mrow></mfenced></mrow></mfrac><mstyle mathvariant="monospace"><mtext>mayNum</mtext></mstyle></mtd></mtr></mtable></math>
+</div>
+</div>
+<div class="paragraph">
+<p>The type of an additive expression <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>e</mi></math> is inferred as follows:</p>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mtable><mtr><mtd><mfrac><mrow><mi>e</mi><mo>.</mo><mi>o</mi><mi>p</mi><msup><mo>=</mo><mi>'</mi></msup><msup><mo>+</mo><mi>'</mi></msup><mspace width="3.0mm"/><mo>¬</mo><mi>t</mi><mi>o</mi><mi>N</mi><mi>u</mi><mi>m</mi><mfenced close=")" open="("><mi>e</mi></mfenced><mspace width="3.0mm"/><mo>¬</mo><mi>m</mi><mi>a</mi><mi>y</mi><mi>N</mi><mi>u</mi><mi>m</mi><mfenced close=")" open="("><mi>e</mi></mfenced></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mi>e</mi><mi>:</mi><mstyle mathvariant="monospace"><mtext>string</mtext></mstyle></mrow></mfrac></mtd></mtr><mtr><mtd><mfrac><mrow><mi>e</mi><mo>.</mo><mi>o</mi><mi>p</mi><msup><mo>=</mo><mi>'</mi></msup><msup><mo>+</mo><mi>'</mi></msup><mspace width="3.0mm"/><mo>¬</mo><mi>t</mi><mi>o</mi><mi>N</mi><mi>u</mi><mi>m</mi><mfenced close=")" open="("><mi>e</mi></mfenced><mspace width="3.0mm"/><mi>m</mi><mi>a</mi><mi>y</mi><mi>N</mi><mi>u</mi><mi>m</mi><mfenced close=")" open="("><mi>e</mi></mfenced></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mi>e</mi><mi>:</mi><mi>u</mi><mi>n</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><mi>n</mi><mi>u</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi><mo>,</mo><mi>s</mi><mi>t</mi><mi>r</mi><mi>i</mi><mi>n</mi><mi>g</mi></mrow></mfenced></mrow></mfrac></mtd></mtr><mtr><mtd><mfrac><mrow><mi>e</mi><mo>.</mo><mi>o</mi><mi>p</mi><msup><mo>=</mo><mi>'</mi></msup><msup><mo>+</mo><mi>'</mi></msup><mspace width="3.0mm"/><mi>t</mi><mi>o</mi><mi>N</mi><mi>u</mi><mi>m</mi><mfenced close=")" open="("><mi>e</mi></mfenced></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mi>e</mi><mi>:</mi><mstyle mathvariant="monospace"><mtext>number</mtext></mstyle></mrow></mfrac></mtd></mtr><mtr><mtd><mfrac><mrow><mi>e</mi><mo>.</mo><mi>o</mi><mi>p</mi><msup><mo>≤</mo><mi>'</mi></msup><msup><mo>+</mo><mi>'</mi></msup></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mi>e</mi><mi>:</mi><mstyle mathvariant="monospace"><mtext>number</mtext></mstyle></mrow></mfrac></mtd></mtr></mtable></math>
+</div>
+</div>
+<div class="paragraph">
+<p>That is, if both operands are number, int, boolean, null, or even undefined, then the 'plus' is interpreted as
+mathematical addition and the result is a number. In other cases the 'plus' is interpreted as string concatenation and the result is a string. In case of union types, the result may be a union of number and string.</p>
+</div>
+<div class="paragraph">
+<p>Adding two integers (int) leads to a number, since the result may not be represented as an (JavaScript) int anymore.</p>
+</div>
+<div class="exampleblock">
+<div class="title">Example 87. Type of addition expression</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">1+2;            // number 3
+"1"+"2";        // string "12"
+"1"+2;          // string "12"
+1+true;         // number 2
+false+1;        // number 1
+"1"+true;       // string "1true"
+"1"+null;       // string "1null"
+1+null;         // number 1
+1+undefined;    // number NaN
+"1"+undefined;  // string "1undefined"</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="openblock todo">
+<div class="content">
+<div class="paragraph">
+<p>Support new <code>Symbol.toPrimitive</code>.</p>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_bitwise-shift-expression"><a class="anchor" href="#_bitwise-shift-expression"></a><a class="link" href="#_bitwise-shift-expression">8.1.15. Bitwise Shift Expression</a></h4>
+<h5 id="bitwise-shift-expression-syntax" class="discrete">Syntax</h5>
+<div class="literalblock">
+<div class="content">
+<pre>Cf. +[+&lt;&lt;ECMA11a,ECMA11a(p.p.76f)&gt;&gt;+]+</pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">ShiftExpression returns Expression: AdditiveExpression
+    (=&gt;({ShiftExpression.lhs=current} op=ShiftOperator rhs=AdditiveExpression))*
+;
+
+ShiftOperator returns ShiftOperator:
+      '&gt;' '&gt;' '&gt;'? // SHR, USHR
+    | '&lt;' '&lt;'  // SHL
+    ;</code></pre>
+</div>
+</div>
+<h5 id="bitwise-shift-expression-semantics" class="discrete">Semantics</h5>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-112"></a><strong>Req. IDE-112:</strong> <a href="#Req-IDE-112">Bitwise Shift Expression Constraints</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>For a given bitwise shift expression <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>e</mi></math> the following constraints must hold in N4JS mode:
+* The types of the operands can be any.</p>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow/><mrow><mi>Γ</mi><mo>⊢</mo><mstyle mathvariant="monospace"><mtext>BitwiseShiftExpression</mtext></mstyle><mi> </mi><mo>⊲</mo><mi> </mi><mstyle mathvariant="monospace"><mtext>Expression</mtext></mstyle><mi>:</mi><mstyle mathvariant="monospace"><mtext>any</mtext></mstyle></mrow></mfrac></math>
+</div>
+</div>
+</div>
+</div>
+<h5 id="type-inference-11" class="discrete">Type Inference</h5>
+<div class="paragraph">
+<p>The type returned by a bitwise shift expression is always <code>number</code>:</p>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mspace width="3.0mm"/><mfrac><mrow/><mrow><mi>Γ</mi><mo>⊢</mo><mi> </mi><mrow><mo>(</mo><mrow><mstyle mathvariant="monospace"><mtext>Expression (’</mtext></mstyle><mo>&lt;</mo><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>’—’</mtext></mstyle><mo>&gt;</mo><mo>&gt;</mo><mstyle mathvariant="monospace"><mtext>’—’</mtext></mstyle><mo>&gt;</mo><mo>&gt;</mo><mo>&gt;</mo><mstyle mathvariant="monospace"><mtext>’)</mtext> <mtext>Expression</mtext></mstyle><mo>)</mo></mrow><mi>:</mi><mstyle mathvariant="monospace"><mtext>number</mtext></mstyle></mrow></mrow></mfrac><mtext>
+</mtext></math>
+</div>
+</div>
+<div class="paragraph">
+<p>A non-numeric operand is interpreted as 0, except for <code>true</code> which is interpreted as <code>1</code>; or objects implementing the symbol <code>toPrimitive</code>.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_relational-expression"><a class="anchor" href="#_relational-expression"></a><a class="link" href="#_relational-expression">8.1.16. Relational Expression</a></h4>
+<h5 id="relational-expression-syntax" class="discrete">Syntax</h5>
+<div class="paragraph">
+<p>Cf. [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.p.77ff)</a>]</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">RelationalExpression returns Expression: ShiftExpression
+    (=&gt;({RelationalExpression.lhs=current} op=RelationalOperator) rhs=ShiftExpression)*;
+
+RelationalExpressionNoIn returns Expression: ShiftExpression
+    (=&gt;({RelationalExpression.lhs=current} op=RelationalOperatorNoIn) rhs=ShiftExpression)*;
+
+enum RelationalOperator:
+    lt='&lt;' | gt='&gt;' | lte='&lt;=' | gte='&gt;=' | instanceof | in;
+RelationalOperatorNoIn returns RelationalOperator:
+    '&lt;' | '&gt;' | '&lt;=' | '&gt;=' | 'instanceof';</code></pre>
+</div>
+</div>
+<h5 id="relational-expression-semantics" class="discrete">Semantics</h5>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-113"></a><strong>Req. IDE-113:</strong> <a href="#Req-IDE-113">Greater/Less (Equals) Operator Constraints</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>For a given relational expression <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>e</mi></math> with <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>e</mi><mo>.</mo><mi>o</mi><mi>p</mi><mo>∈</mo><mrow><mo>{</mo><mrow><mo>&lt;</mo><mo>,</mo><mo>&gt;</mo><mo>,</mo><mo>&lt;</mo><mo>=</mo><mo>,</mo><mo>&gt;</mo><mo>=</mo><mo>}</mo></mrow></mrow></math> in N4JS mode,
+the following constraints must hold:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>The operands must have the same type and the type must be either a number, string, or boolean:</p>
+<div class="paragraph">
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mfrac><mrow><mi>Γ</mi><mo>⊢</mo><mi>r</mi><mi>h</mi><mi>s</mi><mi>:</mi><mi>T</mi><mspace width="3.0mm"/><mi>T</mi><mo>∈</mo><mfenced close="}" open="{"><mstyle mathvariant="monospace"><mtext>number,string,boolean</mtext></mstyle></mfenced></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mi>l</mi><mi>h</mi><mi>s</mi><mi> </mi><mrow><mo>(</mo><mrow><mi>'</mi><msup><mo>&lt;</mo><mi>'</mi></msup><msup><mo>|</mo><mi>'</mi></msup><mo>&lt;</mo><msup><mo>=</mo><mi>'</mi></msup><msup><mo>|</mo><mi>'</mi></msup><msup><mo>&gt;</mo><mi>'</mi></msup><msup><mo>|</mo><mi>'</mi></msup><mo>&gt;</mo><msup><mo>=</mo><mi>'</mi></msup><mo>)</mo></mrow><mi>r</mi><mi>h</mi><mi>s</mi><mi> </mi><mo>⊲</mo><mi> </mi><mi>l</mi><mi>h</mi><mi>s</mi><mi>:</mi><mi>T</mi></mrow></mrow></mfrac></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mfrac><mrow><mi>Γ</mi><mo>⊢</mo><mi>r</mi><mi>h</mi><mi>s</mi><mi>:</mi><mi>O</mi><mspace width="3.0mm"/><mi>O</mi><mo>∉</mo><mfenced close="}" open="{"><mstyle mathvariant="monospace"><mtext>number,string,boolean</mtext></mstyle></mfenced><mspace width="3.0mm"/><mi>T</mi><mo>=</mo><mi>u</mi><mi>n</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mstyle mathvariant="monospace"><mtext>number,string,boolean</mtext></mstyle></mfenced></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mi>l</mi><mi>h</mi><mi>s</mi><mi> </mi><mrow><mo>(</mo><mrow><mi>'</mi><msup><mo>&lt;</mo><mi>'</mi></msup><msup><mo>|</mo><mi>'</mi></msup><mo>&lt;</mo><msup><mo>=</mo><mi>'</mi></msup><msup><mo>|</mo><mi>'</mi></msup><msup><mo>&gt;</mo><mi>'</mi></msup><msup><mo>|</mo><mi>'</mi></msup><mo>&gt;</mo><msup><mo>=</mo><mi>'</mi></msup><mo>)</mo></mrow><mi>r</mi><mi>h</mi><mi>s</mi><mi> </mi><mo>⊲</mo><mi> </mi><mi>l</mi><mi>h</mi><mi>s</mi><mi>:</mi><mi>T</mi></mrow></mrow></mfrac></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mfrac><mrow><mi>Γ</mi><mo>⊢</mo><mi>l</mi><mi>h</mi><mi>s</mi><mi>:</mi><mi>T</mi><mspace width="3.0mm"/><mi>T</mi><mo>∈</mo><mfenced close="}" open="{"><mstyle mathvariant="monospace"><mtext>number,string,boolean</mtext></mstyle></mfenced></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mi>l</mi><mi>h</mi><mi>s</mi><mi> </mi><mrow><mo>(</mo><mrow><mi>'</mi><msup><mo>&lt;</mo><mi>'</mi></msup><msup><mo>|</mo><mi>'</mi></msup><mo>&lt;</mo><msup><mo>=</mo><mi>'</mi></msup><msup><mo>|</mo><mi>'</mi></msup><msup><mo>&gt;</mo><mi>'</mi></msup><msup><mo>|</mo><mi>'</mi></msup><mo>&gt;</mo><msup><mo>=</mo><mi>'</mi></msup><mo>)</mo></mrow><mi>r</mi><mi>h</mi><mi>s</mi><mi> </mi><mo>⊲</mo><mi> </mi><mi>r</mi><mi>h</mi><mi>s</mi><mi>:</mi><mi>T</mi></mrow></mrow></mfrac></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mfrac><mrow><mi>Γ</mi><mo>⊢</mo><mi>l</mi><mi>h</mi><mi>s</mi><mi>:</mi><mi>O</mi><mspace width="3.0mm"/><mi>O</mi><mo>∉</mo><mfenced close="}" open="{"><mstyle mathvariant="monospace"><mtext>number,string,boolean</mtext></mstyle></mfenced><mspace width="3.0mm"/><mi>T</mi><mo>=</mo><mi>u</mi><mi>n</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mstyle mathvariant="monospace"><mtext>number,string,boolean</mtext></mstyle></mfenced></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mi>l</mi><mi>h</mi><mi>s</mi><mi> </mi><mrow><mo>(</mo><mrow><mi>'</mi><msup><mo>&lt;</mo><mi>'</mi></msup><msup><mo>|</mo><mi>'</mi></msup><mo>&lt;</mo><msup><mo>=</mo><mi>'</mi></msup><msup><mo>|</mo><mi>'</mi></msup><msup><mo>&gt;</mo><mi>'</mi></msup><msup><mo>|</mo><mi>'</mi></msup><mo>&gt;</mo><msup><mo>=</mo><mi>'</mi></msup><mo>)</mo></mrow><mi>r</mi><mi>h</mi><mi>s</mi><mi> </mi><mo>⊲</mo><mi> </mi><mi>r</mi><mi>h</mi><mi>s</mi><mi>:</mi><mi>T</mi></mrow></mrow></mfrac></math></p>
+</div>
+</li>
+</ul>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-114"></a><strong>Req. IDE-114:</strong> <a href="#Req-IDE-114">Instanceof Operator Constraints</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>For a given relational expression <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>e</mi></math> with  <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>e</mi><mo>.</mo><mi>o</mi><mi>p</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>instanceof</mtext></mstyle></math>, the following constraints must hold:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>The right operand of the instanceof operator must be a <code>Function</code> <sup class="footnote">[<a id="_footnoteref_49" class="footnote" href="appendix_c_bibliography.html#_footnote_49" title="View footnote.">49</a>]</sup></p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>In other words,</p>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow/><mrow><mi>Γ</mi><mo>⊢</mo><mi>l</mi><mi>h</mi><mi>s</mi><mi> </mi><mstyle mathvariant="monospace"><mtext>’instanceof’</mtext></mstyle><mi> </mi><mi>r</mi><mi>h</mi><mi>s</mi><mi> </mi><mo>⊲</mo><mi> </mi><mi>r</mi><mi>h</mi><mi>s</mi><mi>:</mi><mstyle mathvariant="monospace"><mtext>type</mtext></mstyle><mfenced close="}" open="{"><mstyle mathvariant="monospace"><mtext>Class</mtext></mstyle></mfenced></mrow></mfrac><mrow/></math>
+</div>
+</div>
+<div class="paragraph">
+<p>is contained in the the first type rule, an object type reference <sup class="footnote">[<a id="_footnoteref_50" class="footnote" href="appendix_c_bibliography.html#_footnote_50" title="View footnote.">50</a>]</sup>
+or an enum type reference.</p>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mtable><mtr><mtd><mspace width="3.0mm"/><mfrac><mrow/><mrow><mi>Γ</mi><mo>⊢</mo><mi>l</mi><mi>h</mi><mi>s</mi><mi> </mi><mstyle mathvariant="monospace"><mtext>’instanceof’</mtext></mstyle><mi> </mi><mi>r</mi><mi>h</mi><mi>s</mi><mi> </mi><mo>⊲</mo><mi> </mi><mi>r</mi><mi>h</mi><mi>s</mi><mi>:</mi><mstyle mathvariant="monospace"><mtext>Function</mtext></mstyle></mrow></mfrac></mtd></mtr><mtr><mtd><mspace width="3.0mm"/><mfrac><mrow/><mrow><mi>Γ</mi><mo>⊢</mo><mi>l</mi><mi>h</mi><mi>s</mi><mi> </mi><mstyle mathvariant="monospace"><mtext>’instanceof’</mtext></mstyle><mi> </mi><mi>r</mi><mi>h</mi><mi>s</mi><mi> </mi><mo>⊲</mo><mi> </mi><mi>r</mi><mi>h</mi><mi>s</mi><mi>:</mi><mstyle mathvariant="monospace"><mtext>type</mtext></mstyle><mfenced close="}" open="{"><mstyle mathvariant="monospace"><mtext>Object</mtext></mstyle></mfenced></mrow></mfrac></mtd></mtr><mtr><mtd><mspace width="3.0mm"/><mfrac><mrow/><mrow><mi>Γ</mi><mo>⊢</mo><mi>l</mi><mi>h</mi><mi>s</mi><mi> </mi><mstyle mathvariant="monospace"><mtext>’instanceof’</mtext></mstyle><mi> </mi><mi>r</mi><mi>h</mi><mi>s</mi><mi> </mi><mo>⊲</mo><mi> </mi><mi>r</mi><mi>h</mi><mi>s</mi><mi>:</mi><mstyle mathvariant="monospace"><mtext>type</mtext></mstyle><mfenced close="}" open="{"><mstyle mathvariant="monospace"><mtext>N4Enum</mtext></mstyle></mfenced></mrow></mfrac></mtd></mtr></mtable></math>
+</div>
+</div>
+<div class="paragraph">
+<p>The type of a definition site structural classifier <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>C</mi></math> is not of type <code>C</code>.
+Thus, the <code>instanceof</code> operator cannot be used for structural types.
+Use-site structural typing is also not possible since <code>~</code> would be interpreted (by the parser) as a binary operator.</p>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-115"></a><strong>Req. IDE-115:</strong> <a href="#Req-IDE-115">Operator Constraints</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>For a given relational expression <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>e</mi></math> with <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>e</mi><mo>.</mo><mi>o</mi><mi>p</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>in</mtext></mstyle></math>, the following constraints must hold:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>The right operand of the in operator must be an <code>Object</code>:</p>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mspace width="3.0mm"/><mfrac><mrow/><mrow><mi>Γ</mi><mo>⊢</mo><mi>l</mi><mi>h</mi><mi>s</mi><mi> </mi><mstyle mathvariant="monospace"><mtext>’in’</mtext></mstyle><mi> </mi><mi>r</mi><mi>h</mi><mi>s</mi><mi> </mi><mo>⊲</mo><mi> </mi><mi>r</mi><mi>h</mi><mi>s</mi><mi>:</mi><mstyle mathvariant="monospace"><mtext>Object</mtext></mstyle></mrow></mfrac></math>
+</div>
+</div>
+</li>
+<li>
+<p>In N4JS mode, the left operand is restricted to be of type <code>string</code> or <code>number</code>:</p>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mspace width="3.0mm"/><mfrac><mrow/><mrow><mi>Γ</mi><mo>⊢</mo><mi>l</mi><mi>h</mi><mi>s</mi><mi> </mi><mstyle mathvariant="monospace"><mtext>’in’</mtext></mstyle><mi> </mi><mi>r</mi><mi>h</mi><mi>s</mi><mi> </mi><mo>⊲</mo><mi> </mi><mi>l</mi><mi>h</mi><mi>s</mi><mi>:</mi><mi>u</mi><mi>n</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mstyle mathvariant="monospace"><mtext>string,number</mtext></mstyle></mfenced></mrow></mfrac></math>
+</div>
+</div>
+</li>
+</ol>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>A special feature of N4JS is support for interface type references in combination with the <code>instance of</code> operator.
+The compiler rewrites the code to make this work.</p>
+</div>
+<div class="exampleblock">
+<div class="title">Example 88. <code>instanceof</code> with Interface</div>
+<div class="content">
+<div class="paragraph">
+<p>The following example demonstrates the use of the operator with an interface.
+This is, of course, not working in pure ECMAScript.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">interface I {}
+
+class A implements I {}
+class B extends A {}
+class C {}
+
+function f(name: string, p: any) {
+    if (p instanceof I) {
+        console.log(name + " is instance of I");
+    }
+}
+
+f("A", new A())
+f("B", new B())
+f("C", new C())</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>This will print out</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">A is instance of I
+B is instance of I</code></pre>
+</div>
+</div>
+</div>
+</div>
+<h5 id="type-inference-12" class="discrete">Type Inference</h5>
+<div class="paragraph">
+<p>The type of a relational expression always is <code>boolean</code>;</p>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mspace width="3.0mm"/><mfrac><mrow/><mrow><mi>Γ</mi><mo>⊢</mo><mi>l</mi><mi>h</mi><mi>s</mi><mi> </mi><mfenced close=")" open="("><mrow><mstyle mathvariant="monospace"><mtext>’¡’</mtext></mstyle><mo>|</mo><mstyle mathvariant="monospace"><mtext>’¡=’</mtext></mstyle><mo>|</mo><mstyle mathvariant="monospace"><mtext>’¿’</mtext></mstyle><mo>|</mo><mstyle mathvariant="monospace"><mtext>’¿=’</mtext></mstyle><mo>|</mo><mstyle mathvariant="monospace"><mtext>’instanceof’</mtext></mstyle><mo>|</mo><mstyle mathvariant="monospace"><mtext>’in’</mtext></mstyle></mrow></mfenced><mi> </mi><mi>r</mi><mi>h</mi><mi>s</mi><mi> </mi><mi>:</mi><mstyle mathvariant="monospace"><mtext>boolean</mtext></mstyle></mrow></mfrac></math>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_equality-expression"><a class="anchor" href="#_equality-expression"></a><a class="link" href="#_equality-expression">8.1.17. Equality Expression</a></h4>
+<h5 id="equality-expression-syntax" class="discrete">Syntax</h5>
+<div class="paragraph">
+<p>Cf. [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.p.80ff)</a>]</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">EqualityExpression returns Expression: RelationalExpression
+    (=&gt;({EqualityExpression.lhs=current} op=EqualityOperator) rhs=RelationalExpression)*;
+
+EqualityExpressionNoIn returns Expression: RelationalExpressionNoIn
+    (=&gt;({EqualityExpression.lhs=current} op=EqualityOperator) rhs=RelationalExpressionNoIn)*;
+
+
+enum EqualityOperator: same='===' | nsame='!==' | eq='==' | neq='!=';</code></pre>
+</div>
+</div>
+<h5 id="equality-expression-semantics" class="discrete">Semantics</h5>
+<div class="paragraph">
+<p>There are no hard constraints defined for equality expressions.</p>
+</div>
+<div class="paragraph">
+<p>In N4JSmode, a warning is created if for a given expression <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>l</mi><mi>h</mi><mi>s</mi><mstyle mathvariant="monospace"><mtext>(’===’—’!==’)</mtext></mstyle><mi>r</mi><mi>h</mi><mi>s</mi></math>, neither <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>Γ</mi><mo>⊢</mo><mi>l</mi><mi>h</mi><mi>s</mi><mo>.</mo><mi>u</mi><mi>p</mi><mi>p</mi><mi>e</mi><mi>r</mi><mo>&lt;</mo><mi>:</mi><mi>r</mi><mi>h</mi><mi>s</mi><mo>.</mo><mi>u</mi><mi>p</mi><mi>p</mi><mi>e</mi><mi>r</mi></math> nor <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>Γ</mi><mo>⊢</mo><mi>r</mi><mi>h</mi><mi>s</mi><mo>.</mo><mi>u</mi><mi>p</mi><mi>p</mi><mi>e</mi><mi>r</mi><mo>&lt;</mo><mi>:</mi><mi>l</mi><mi>h</mi><mi>s</mi><mo>.</mo><mi>u</mi><mi>p</mi><mi>p</mi><mi>e</mi><mi>r</mi></math>
+and no interface or composed type is involved as the result is constant in these cases.</p>
+</div>
+<div class="paragraph">
+<p>Note that a warning is only created if the upper bounds do not match the described constraints.
+This is necessary for wildcards. For example in</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">// with
+class A{} class B extends A{}
+function isFirst(ar: Array&lt;? extends A&gt;, b: B): boolean {
+    return b === ar[0]
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>the type of array elements is <code>? extends A</code>.<br>
+Neither <math xmlns="http://www.w3.org/1998/Math/MathML"><mstyle mathvariant="monospace"><mtext>? extends A</mtext></mstyle><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mstyle mathvariant="monospace"><mtext>B</mtext></mstyle></math> nor <math xmlns="http://www.w3.org/1998/Math/MathML"><mstyle mathvariant="monospace"><mtext>B</mtext></mstyle><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mstyle mathvariant="monospace"><mtext>? extends A</mtext></mstyle></math> is true.
+This is why the upper bounds are to be used.</p>
+</div>
+<h5 id="type-inference-13" class="discrete">Type Inference</h5>
+<div class="paragraph">
+<p>The inferred type of an equality expression always is <code>boolean</code>.</p>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mspace width="3.0mm"/><mfrac><mrow/><mrow><mi>Γ</mi><mo>⊢</mo><mi>l</mi><mi>h</mi><mi>s</mi><mi> </mi><mfenced close=")" open="("><mrow><mstyle mathvariant="monospace"><mtext>’==’</mtext></mstyle><mo>|</mo><mstyle mathvariant="monospace"><mtext>’!=’</mtext></mstyle><mo>|</mo><mstyle mathvariant="monospace"><mtext>’===’</mtext></mstyle><mo>|</mo><mstyle mathvariant="monospace"><mtext>’!==’</mtext></mstyle></mrow></mfenced><mi> </mi><mi>r</mi><mi>h</mi><mi>s</mi><mi> </mi><mi>:</mi><mstyle mathvariant="monospace"><mtext>boolean</mtext></mstyle></mrow></mfrac></math>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_binary-bitwise-expression"><a class="anchor" href="#_binary-bitwise-expression"></a><a class="link" href="#_binary-bitwise-expression">8.1.18. Binary Bitwise Expression</a></h4>
+<h5 id="binary-bitwise-expression-syntax" class="discrete">Syntax</h5>
+<div class="paragraph">
+<p>Cf. [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.p.82ff)</a>]</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">BitwiseANDExpression returns Expression: EqualityExpression
+    (=&gt; ({BitwiseANDExpression.lhs=current} '&amp;') rhs=EqualityExpression)*;
+
+BitwiseANDExpressionNoIn returns Expression: EqualityExpressionNoIn
+    (=&gt; ({BitwiseANDExpression.lhs=current} '&amp;') rhs=EqualityExpressionNoIn)*;
+
+BitwiseXORExpression returns Expression: BitwiseANDExpression
+    (=&gt; ({BitwiseXORExpression.lhs=current} '^') rhs=BitwiseANDExpression)*;
+
+BitwiseXORExpressionNoIn returns Expression: BitwiseANDExpressionNoIn
+    (=&gt; ({BitwiseXORExpression.lhs=current} '^') rhs=BitwiseANDExpressionNoIn)*;
+
+BitwiseORExpression returns Expression: BitwiseXORExpression
+    (=&gt; ({BitwiseORExpression.lhs=current} '|') rhs=BitwiseXORExpression)*;
+
+BitwiseORExpressionNoIn returns Expression: BitwiseXORExpressionNoIn
+    (=&gt; ({BitwiseORExpression.lhs=current} '|') rhs=BitwiseXORExpressionNoIn)*;</code></pre>
+</div>
+</div>
+<h5 id="binary-bitwise-expression-semantics" class="discrete">Semantics</h5>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-116"></a><strong>Req. IDE-116:</strong> <a href="#Req-IDE-116">Bitwise Bitwise Expression Constraints</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>For a given bitwise bitwise expression <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>e</mi></math> the following constraints must hold in N4JS mode:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>The types of the operands must be both number.</p>
+</li>
+</ul>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow/><mrow><mi>Γ</mi><mo>⊢</mo><mstyle mathvariant="monospace"><mtext>BitwiseBitwiseExpression</mtext></mstyle><mi> </mi><mo>⊲</mo><mi> </mi><mstyle mathvariant="monospace"><mtext>Expression</mtext></mstyle><mi>:</mi><mstyle mathvariant="monospace"><mtext>number</mtext></mstyle></mrow></mfrac></math>
+</div>
+</div>
+</div>
+</div>
+<h5 id="type-inference-14" class="discrete">Type Inference</h5>
+<div class="paragraph">
+<p>The type returned by a binary bitwise expression is always <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>n</mi><mi>u</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi></math>:</p>
+</div>
+<div class="openblock">
+<div class="content">
+
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_binary-logical-expression"><a class="anchor" href="#_binary-logical-expression"></a><a class="link" href="#_binary-logical-expression">8.1.19. Binary Logical Expression</a></h4>
+<h5 id="binary-logical-expression-syntax" class="discrete">Syntax</h5>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">LogicalANDExpression returns Expression: BitwiseORExpression
+    (=&gt; ({LogicalANDExpression.lhs=current} '&amp;&amp;') rhs=BitwiseORExpression)*;
+LogicalANDExpressionNoIn returns Expression: BitwiseORExpressionNoIn
+    (=&gt; ({LogicalANDExpression.lhs=current} '&amp;&amp;') rhs=BitwiseORExpressionNoIn)*;
+
+LogicalORExpression returns Expression: LogicalANDExpression
+    (=&gt; ({LogicalORExpression.lhs=current} '||') rhs=LogicalANDExpression)*;
+LogicalORExpressionNoIn returns Expression: LogicalANDExpressionNoIn
+    (=&gt; ({LogicalORExpression.lhs=current} '||') rhs=LogicalANDExpressionNoIn)*;</code></pre>
+</div>
+</div>
+<h5 id="binary-logical-expression-semantics" class="discrete">Semantics</h5>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-117"></a><strong>Req. IDE-117:</strong> <a href="#Req-IDE-117">Binary Logical Expression Constraints</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>For a given binary logical expression <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>e</mi></math> with <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>e</mi><mo>.</mo><mi>l</mi><mi>h</mi><mi>s</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>:</mi><mi>L</mi></math> and <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>e</mi><mo>.</mo><mi>r</mi><mi>h</mi><mi>s</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>:</mi><mi>R</mi></math> the following constraints must hold:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>In N4JS mode <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>L</mi></math> must not be <code>undefined</code> or <code>null</code>.</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+<h5 id="type-inference-15" class="discrete">Type Inference</h5>
+<div class="paragraph">
+<p>The evaluation relies on ECMAScript’s abstract operation <code>ToBoolean</code> [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.p.43)</a>].
+A short-circuit evaluation strategy is used so that depending on the types of the operands, different result types may be inferred.
+In particular, the inferred type usually is not <code>boolean</code> ((cf. [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.S11.11., p.p.83ff)</a>] ).
+The type inference does not take this short-circuit evaluation strategy into account, as it will affect the result in case one of the types is <code>null</code>
+either or <code>undefined</code>, which is not allowed in N4JS mode.</p>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow/><mrow><mi>Γ</mi><mo>⊢</mo><mi>l</mi><mi>h</mi><mi>s</mi><mstyle mathvariant="monospace"><mtext>’</mtext></mstyle><mi>&amp;</mi><mi>&amp;</mi><mstyle mathvariant="monospace"><mtext>’—’——’</mtext></mstyle><mi>r</mi><mi>h</mi><mi>s</mi><mi>:</mi><mi>u</mi><mi>n</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><mi>Γ</mi><mo>⊢</mo><mi>l</mi><mi>h</mi><mi>s</mi></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mi>r</mi><mi>h</mi><mi>s</mi></mrow></mfenced></mrow></mfrac></math>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_conditional-expression"><a class="anchor" href="#_conditional-expression"></a><a class="link" href="#_conditional-expression">8.1.20. Conditional Expression</a></h4>
+<h5 id="conditional-expression-syntax" class="discrete">Syntax</h5>
+<div class="paragraph">
+<p>Cf. [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.S11.12, p.p.84)</a>]</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">ConditionalExpression returns Expression: LogicalORExpression
+    (=&gt; ({ConditionalExpression.expression=current} '?') trueExpression=AssignmentExpression  ':' falseExpression=AssignmentExpression)?;
+
+ConditionalExpressionNoIn returns Expression: LogicalORExpressionNoIn
+    (=&gt; ({ConditionalExpression.expression=current} '?') trueExpression=AssignmentExpression  ':' falseExpression=AssignmentExpressionNoIn)?;</code></pre>
+</div>
+</div>
+<h5 id="conditional-expression-semantics" class="discrete">Semantics</h5>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-118"></a><strong>Req. IDE-118:</strong> <a href="#Req-IDE-118">Conditional Expression Constraints</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>For a given conditional expression <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>e</mi></math> with</p>
+</div>
+<div class="paragraph">
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>e</mi><mo>.</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>e</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>o</mi><mi>n</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>:</mi><mi>C</mi><mo>,</mo></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>e</mi><mo>.</mo><mi>t</mi><mi>r</mi><mi>u</mi><mi>e</mi><mi>E</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>e</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>o</mi><mi>n</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>:</mi><mi>T</mi><mo>,</mo></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>e</mi><mo>.</mo><mi>f</mi><mi>a</mi><mi>l</mi><mi>s</mi><mi>e</mi><mo>-</mo><mi>E</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>e</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>o</mi><mi>n</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>:</mi><mi>F</mi></math></p>
+</div>
+<div class="paragraph">
+<p>the following constraints must hold:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>A warning will be issued in N4JSmode if <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>e</mi><mo>.</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>e</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>o</mi><mi>n</mi></math> evaluates to a constant value.
+That is to say<br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>e</mi><mo>.</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>e</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>o</mi><mi>n</mi><mo>∈</mo><mfenced close="}" open="{"><mrow><mi>f</mi><mi>a</mi><mi>l</mi><mi>s</mi><mi>e</mi></mrow><mrow><mi>t</mi><mi>r</mi><mi>u</mi><mi>e</mi></mrow><mrow><mi>n</mi><mi>u</mi><mi>l</mi><mi>l</mi></mrow><mrow><mi>u</mi><mi>n</mi><mi>d</mi><mi>e</mi><mi>f</mi><mi>i</mi><mi>n</mi><mi>e</mi><mi>d</mi></mrow></mfenced></math> or
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>C</mi><mo>∈</mo><mfenced close="}" open="{"><mstyle mathvariant="monospace"><mtext>void</mtext></mstyle><mstyle mathvariant="monospace"><mtext>undefined</mtext></mstyle></mfenced></math>.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>There are no specific constraints defined for the condition.
+The ECMAScript operation <code>ToBoolean</code> [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.S9.2, p.p.43)</a>] is used to convert any type to boolean.</p>
+</div>
+</div>
+</div>
+<h5 id="type-inference-16" class="discrete">Type Inference</h5>
+<div class="paragraph">
+<p>The inferred type of a conditional expression is the union of the true and false expression (cf. [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.S11.12, p.p.84)</a>]   ():</p>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><mi>T</mi><mo>=</mo><mi>u</mi><mi>n</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><mi>Γ</mi><mo>⊢</mo><mi>e</mi><mi>t</mi><mo>,</mo><mi>Γ</mi><mo>⊢</mo><mi>e</mi><mi>f</mi></mrow></mfenced></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>d</mi><mi> </mi><mstyle mathvariant="monospace"><mtext>’?’</mtext></mstyle><mi>e</mi><mi>t</mi><mi> </mi><mstyle mathvariant="monospace"><mtext>’:’</mtext></mstyle><mi>e</mi><mi>f</mi><mi>:</mi><mi>T</mi></mrow></mfrac></math>
+</div>
+</div>
+<div class="exampleblock">
+<div class="title">Example 89. Type of Conditional Expressions</div>
+<div class="content">
+<div class="paragraph">
+<p>Given the following declarations:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">class A{}       class B extends A{}
+class C{}       class D extends A{}
+class G&lt;T&gt; { field: T; }
+
+var ga: G&lt;A&gt;, gb: G&lt;B&gt;;
+    a: A, b: B, c: C, d: D;
+var boolean cond;</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Then the type of the following conditional expression is inferred as noted in the comments:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">cond ? a : a;                           // A
+cond ? a : b;                           // union{A,B}
+cond ? a : c;                           // union{A,C}
+cond ? b : d;                           // union{B,D}
+cond ? (cond ? a : b) : (cond ? c : d); // union{A,B,C,D}
+cond ? (cond ? a : b) : (cond ? b : d); // union{A,B,D}
+cond ? ga : gb;                         // union{G&lt;A&gt;,G&lt;B&gt;}</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_assignment-expression"><a class="anchor" href="#_assignment-expression"></a><a class="link" href="#_assignment-expression">8.1.21. Assignment Expression</a></h4>
+<h5 id="assignment-expression-syntax" class="discrete">Syntax</h5>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">AssignmentExpression &lt;In, Yield&gt;:
+    lhs=Expression op=AssignmentOperator rhs=AssignmentExpression&lt;In,Yield&gt;
+;
+AssignmentOperator:
+      '='
+    | '*=' | '/=' | '%=' | '+=' | '-='
+    | '&lt;&lt;=' | '&gt;&gt;=' | '&gt;&gt;&gt;='
+    | '&amp;=' | '^=' | '|='
+;</code></pre>
+</div>
+</div>
+<h5 id="assignment-expression-semantics" class="discrete">Semantics</h5>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-119"></a><strong>Req. IDE-119:</strong> <a href="#Req-IDE-119">Simple Assignment</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>For a given assignment <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>a</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>g</mi><mi>n</mi><mi>m</mi><mi>e</mi><mi>n</mi><mi>t</mi></math> with</p>
+</div>
+<div class="paragraph">
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>a</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>g</mi><mi>n</mi><mi>m</mi><mi>e</mi><mi>n</mi><mi>t</mi><mo>.</mo><mi>o</mi><mi>p</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>’=’</mtext></mstyle></math></p>
+</div>
+<div class="paragraph">
+<p>the following constraints must hold:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mrow><mo>[</mo><mspace width="-0.167em"/><mrow><mo>[</mo></mrow></mrow><mrow><mi>a</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>g</mi><mi>n</mi><mi>m</mi><mi>e</mi><mi>n</mi><mi>t</mi><mo>.</mo><mi>l</mi><mi>h</mi><mi>s</mi></mrow><mrow><mrow><mo>]</mo></mrow><mspace width="-0.167em"/><mo>]</mo></mrow><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mrow><mo>[</mo><mspace width="-0.167em"/><mrow><mo>[</mo></mrow></mrow><mrow><mi>a</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>g</mi><mi>n</mi><mi>m</mi><mi>e</mi><mi>n</mi><mi>t</mi><mo>.</mo><mi>r</mi><mi>h</mi><mi>s</mi></mrow><mrow><mrow><mo>]</mo></mrow><mspace width="-0.167em"/><mo>]</mo></mrow></math></p>
+<div class="paragraph">
+<p>In the following inference rule and the constraint, ’@’ is to be replaced with the right part of one of the assignment operators listed above, that is,</p>
+</div>
+<div class="openblock">
+<div class="content">
+
+</div>
+</div>
+</li>
+</ol>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-120"></a><strong>Req. IDE-120:</strong> <a href="#Req-IDE-120">Compound Assignment</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>For a given assignment <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi><mi> </mi><mi>o</mi><mi>p</mi><mi> </mi><mi>r</mi><mi>i</mi><mi>g</mi><mi>h</mi><mi>t</mi></math>, with <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>o</mi><mi>p</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>’@=’</mtext></mstyle></math> but not <code>+=</code>, both, left and right must be subtypes of <code>number</code>.<br>
+For operator <code>+=</code>,</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>if the left-hand side is a <code>number</code>, then <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi><mi> </mi><mstyle mathvariant="monospace"><mtext>’+’</mtext></mstyle><mi>r</mi><mi>i</mi><mi>g</mi><mi>h</mi><mi>t</mi></math> must return a number as well.
+The right-hand side must, in fact, be a <code>number</code> (and not a <code>boolean</code>) here in order to avoid unexpected results.</p>
+</li>
+<li>
+<p>if the left-hand side is a <code>string</code>, then <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi><mstyle mathvariant="monospace"><mtext>’+’</mtext></mstyle><mi>r</mi><mi>i</mi><mi>g</mi><mi>h</mi><mi>t</mi></math> must return a string as well.
+That means that the right-hand side can be of <code>any</code> type.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>The expected type for the left-hand side is <code>union{number,string}</code>.</p>
+</div>
+<div class="paragraph">
+<p>The basic idea behind these constraints is that the type of the left-hand side is not to be changed by the compound assignment.</p>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-121"></a><strong>Req. IDE-121:</strong> <a href="#Req-IDE-121">Write Acccess</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>For a given assignment expression <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>a</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>g</mi><mi>n</mi><mi>E</mi><mi>x</mi><mi>p</mi><mi>r</mi></math>, the left-hand side must be writeable or a final data field and the assignment must be in the constructor.
+Let <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>v</mi></math> be the bound variable (or field) with <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>b</mi><mi>i</mi><mi>n</mi><mi>d</mi><mfenced close=")" open="("><mrow><mi>a</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>g</mi><mi>n</mi><mi>E</mi><mi>x</mi><mi>p</mi><mi>r</mi><mo>.</mo><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi></mrow><mi>v</mi></mfenced></math></p>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mtable><mtr><mtd><mi>v</mi><mo>.</mo><mi>w</mi><mi>r</mi><mi>i</mi><mi>t</mi><mi>e</mi><mi>a</mi><mi>b</mi><mi>l</mi><mi>e</mi><mo>∨</mo><mi>v</mi><mo>.</mo><mi>f</mi><mi>i</mi><mi>n</mi><mi>a</mi><mi>l</mi><mo>∧</mo><mspace width="3.0mm"/><mspace width="2.0em"/><mi>v</mi><mo>.</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>null</mtext></mstyle></mtd></mtr><mtr><mtd><mspace width="3.0mm"/><mspace width="2.0em"/><mo>∧</mo><mi>a</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>g</mi><mi>n</mi><mi>E</mi><mi>x</mi><mi>p</mi><mi>r</mi><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>t</mi><mi>a</mi><mi>i</mi><mi>n</mi><mi>i</mi><mi>n</mi><mi>g</mi><mi>F</mi><mi>u</mi><mi>n</mi><mi>c</mi><mi>t</mi><mi>i</mi><mi>o</mi><mi>n</mi><mo>=</mo><mi>v</mi><mo>.</mo><mi>o</mi><mi>w</mi><mi>n</mi><mi>e</mi><mi>r</mi><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>s</mi><mi>t</mi><mi>r</mi><mi>u</mi><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi></mtd></mtr><mtr><mtd><mspace width="3.0mm"/><mspace width="2.0em"/><mo>∧</mo><mi>μ</mi><mfenced close=")" open="("><mrow><mi>a</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>g</mi><mi>n</mi><mi>E</mi><mi>x</mi><mi>p</mi><mi>r</mi><mo>.</mo><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi></mrow></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>PropertyAccess</mtext></mstyle></mtd></mtr><mtr><mtd><mspace width="3.0mm"/><mspace width="4.0em"/><mo>∧</mo><mi>a</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>g</mi><mi>n</mi><mi>E</mi><mi>x</mi><mi>p</mi><mi>r</mi><mo>.</mo><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi><mo>.</mo><mi>t</mi><mi>a</mi><mi>r</mi><mi>g</mi><mi>e</mi><mi>t</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>"this"</mtext></mstyle></mtd></mtr></mtable></math>
+</div>
+</div>
+<div class="paragraph">
+<p>The value of writeable is true for setters and usually for variables and data fields.
+Assignability of variables and data fields can be restricted via <code>const</code> or the <code>@Final</code> annotation.
+See <a href="classifiers.html#_assignment-modifiers">Assignment Modifiers</a>(data fields) and <a href="statements.html#_const">Const</a> (const variables) for details.</p>
+</div>
+<div class="paragraph">
+<p>Also see <a href="#Req-IDE-93">[Req-IDE-93]</a> for read access constraint.</p>
+</div>
+<div class="paragraph">
+<p>The left-hand side of an assignment expression may be an array or object literal and the assignment expression is then treated as a destructuring assignment.
+See <a href="extended_fetaures.html#_array-and-object-destructuring">Array and Object Destructuring</a> for details.</p>
+</div>
+</div>
+</div>
+<h5 id="type-inference-17" class="discrete">Type Inference</h5>
+<div class="paragraph">
+<p>Similarly to [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.S11.1, p.p.84ff)</a>], we define type inference for simple assignment (<code>=</code>) and compound assignment (<code>op=</code>) individually.</p>
+</div>
+<div class="paragraph">
+<p>The type of the assignment is simply the type of the right-hand side:</p>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mspace width="3.0mm"/><mfrac><mrow><mi>Γ</mi><mo>⊢</mo><mi>r</mi><mi>i</mi><mi>g</mi><mi>h</mi><mi>t</mi><mi>:</mi><mi>T</mi></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi><mi> </mi><mstyle mathvariant="monospace"><mtext>’=’</mtext></mstyle><mi>r</mi><mi>i</mi><mi>g</mi><mi>h</mi><mi>t</mi><mi>:</mi><mi>T</mi></mrow></mfrac></math>
+</div>
+</div>
+<div class="paragraph">
+<p>Compound assignments are reduced to the former by splitting an operator <code>@=</code>, in which <code>@</code> is a simple operator,
+into a simple operator expression with operator <code>@</code> and a simple assignment <code>=</code>.
+Since the type of the latter is the right-hand side, we can define:</p>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><mi>Γ</mi><mo>⊢</mo><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi><mi> </mi><mstyle mathvariant="monospace"><mtext>’@’</mtext></mstyle><mi>r</mi><mi>i</mi><mi>g</mi><mi>h</mi><mi>t</mi><mi>:</mi><mi>T</mi></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi><mi> </mi><mstyle mathvariant="monospace"><mtext>’@=’</mtext></mstyle><mi>r</mi><mi>i</mi><mi>g</mi><mi>h</mi><mi>t</mi><mi>:</mi><mi>T</mi></mrow></mfrac></math>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_comma-expression"><a class="anchor" href="#_comma-expression"></a><a class="link" href="#_comma-expression">8.1.22. Comma Expression</a></h4>
+<h5 id="comma-expression-syntax" class="discrete">Syntax</h5>
+<div class="paragraph">
+<p>Cf. [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.S11.14, p.p.85)</a>]</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">CommaExpression &lt;In, Yield&gt;:
+    exprs+=AssignmentExpression&lt;In,Yield&gt; ',' exprs+=AssignmentExpression&lt;In,Yield&gt;
+    (','    exprs+=AssignmentExpression&lt;In,Yield&gt;)*
+;</code></pre>
+</div>
+</div>
+<h5 id="comma-expression-semantics" class="discrete">Semantics</h5>
+<div class="paragraph">
+<p>All expressions will be evaluated even though only the value of the last expression will be the result.</p>
+</div>
+<div class="exampleblock">
+<div class="title">Example 90. Comma Expression</div>
+<div class="content">
+<div class="paragraph">
+<p>Assignment expressions preceed comma expressions:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">var b: boolean;
+b = (12, 34, true); // ok, b=true
+b =  12, 34, true ; // error, b=12 is invalid</code></pre>
+</div>
+</div>
+</div>
+</div>
+<h5 id="type-inference-18" class="discrete">Type Inference</h5>
+<div class="paragraph">
+<p>Cf. [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.S11.14, p.p.85)</a>]</p>
+</div>
+<div class="paragraph">
+<p>The type of a comma expression <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>c</mi><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi></math> is inferred to the last expression:</p>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><mi>n</mi><mo>=</mo><mo>|</mo><mi>c</mi><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mo>.</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>s</mi><mo>|</mo><mo>,</mo><mi>Γ</mi><mo>⊢</mo><mi>c</mi><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mo>.</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><msub><mi>s</mi><mi>n</mi></msub><mi>:</mi><mi>T</mi></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mi>c</mi><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>:</mi><mi>T</mi></mrow></mfrac></math>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="_ecmascript-6-expressions"><a class="anchor" href="#_ecmascript-6-expressions"></a><a class="link" href="#_ecmascript-6-expressions">8.2. ECMAScript 6 Expressions</a></h3>
+<div class="sect3">
+<h4 id="_the-super-keyword"><a class="anchor" href="#_the-super-keyword"></a><a class="link" href="#_the-super-keyword">8.2.1. The super Keyword</a></h4>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">SuperLiteral: {SuperLiteral} 'super';</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Apart from the use of keyword <code>super</code> in wildcards of type expressions (cf. <a href="types.html#_type-expressions">Type Expressions</a>),
+there are two use cases for keyword <code>super</code>: super member access and super constructor calls.</p>
+</div>
+<div class="exampleblock">
+<div class="title">Example 91. Super Keyword</div>
+<div class="content">
+<div class="paragraph">
+<p>Two use cases for keyword super:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">class B extends A {
+    constructor() {
+        // super call
+        super();
+    }
+    @Override
+    m();: void {
+        // super member access
+        super.m();
+    }
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<h5 id="super-keyword-semantics" class="discrete">Semantics</h5>
+<div class="paragraph">
+<p><code>super</code> can be used to access the supertype’s constructor, methods, getters and setters.
+The supertype is defined lexically, which is different from how <code>this</code> works.<sup class="footnote">[<a id="_footnoteref_51" class="footnote" href="appendix_c_bibliography.html#_footnote_51" title="View footnote.">51</a>]</sup></p>
+</div>
+<div class="paragraph">
+<p>Note that in [<a href="appendix_c_bibliography.html#ECMA15a">ECMA15a</a>] Chapter 12.3.5 <code>The Super Keyword</code>, <code>super</code> is defined as a keyword but the syntax and semantics are defined in conjunction of member access.</p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-122"></a><strong>Req. IDE-122:</strong> <a href="#Req-IDE-122">Type of Super is Always Nominal</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>The type referenced with the super literal is always nominal.
+This is a consequence of references to types in extend clauses to be nominal.</p>
+</div>
+<div class="paragraph">
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>Γ</mi><mo>⊢</mo><mstyle mathvariant="monospace"><mtext>super</mtext></mstyle><mi>:</mi><mi>T</mi><mo>∧</mo><mi>T</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>i</mi><mi>n</mi><mi>g</mi><mi>S</mi><mi>t</mi><mi>r</mi><mi>a</mi><mi>t</mi><mi>e</mi><mi>g</mi><mi>y</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>nominal</mtext></mstyle></math></p>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-123"></a><strong>Req. IDE-123:</strong> <a href="#Req-IDE-123">Access Super Constructor with Super Literal</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>If the super literal <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>s</mi></math> is used to access the super constructor of a class, all of the following constraints must hold:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>The super constructor access must be a call expression:</p>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mi>μ</mi><mfenced close=")" open="("><mrow><mi>c</mi><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi></mrow></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>CallExpression</mtext></mstyle><mo>∧</mo><mi>c</mi><mo>.</mo><mi>t</mi><mi>a</mi><mi>r</mi><mi>g</mi><mi>e</mi><mi>t</mi><mo>=</mo><mi>c</mi><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi></math>
+</div>
+</div>
+</li>
+<li>
+<p>The super constructor call must be the expression of an expression statement <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>S</mi><mi>t</mi><mi>m</mi><mi>t</mi></math>:</p>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>S</mi><mi>t</mi><mi>m</mi><mi>t</mi><mo>=</mo><mi>c</mi><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>t</mi><mi>a</mi><mi>i</mi><mi>n</mi><mi>e</mi><mi>r</mi><mo>∧</mo><mi>μ</mi><mfenced close=")" open="("><mrow><mi>c</mi><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>t</mi><mi>a</mi><mi>i</mi><mi>n</mi><mi>e</mi><mi>r</mi></mrow></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>ExpressionStatement</mtext></mstyle></math>
+</div>
+</div>
+</li>
+<li>
+<p>The containing statement <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>s</mi><mi>t</mi><mi>m</mi><mi>t</mi><mi>E</mi><mi>x</mi><mi>p</mi><mi>r</mi></math> must be directly contained in a constructor body:</p>
+<div class="paragraph">
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mrow><mi>μ</mi><mfenced close=")" open="("><mrow><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>S</mi><mi>t</mi><mi>m</mi><mi>t</mi><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>t</mi><mi>a</mi><mi>i</mi><mi>n</mi><mi>i</mi><mi>n</mi><mi>g</mi><mi>F</mi><mi>u</mi><mi>n</mi><mi>c</mi><mi>t</mi><mi>i</mi><mi>o</mi><mi>n</mi></mrow></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>Constructor</mtext></mstyle><mo>)</mo></mrow></math>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mo>∧</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>S</mi><mi>t</mi><mi>m</mi><mi>t</mi><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>t</mi><mi>a</mi><mi>i</mi><mi>n</mi><mi>e</mi><mi>r</mi><mo>=</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>S</mi><mi>t</mi><mi>m</mi><mi>t</mi><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>t</mi><mi>a</mi><mi>i</mi><mi>n</mi><mi>i</mi><mi>n</mi><mi>g</mi><mi>F</mi><mi>u</mi><mi>n</mi><mi>c</mi><mi>t</mi><mi>i</mi><mi>o</mi><mi>n</mi><mo>.</mo><mi>b</mi><mi>o</mi><mi>d</mi><mi>y</mi></math></p>
+</div>
+</li>
+<li>
+<p>There must be no access to and not return statement before the containing statement <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>S</mi><mi>t</mi><mi>m</mi><mi>t</mi></math>.</p>
+<div class="paragraph">
+<p>Let <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>s</mi><mi>i</mi></math> be the index of <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>S</mi><mi>t</mi><mi>m</mi><mi>t</mi></math> in the constructor body:</p>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>S</mi><mi>t</mi><mi>m</mi><mi>t</mi><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>t</mi><mi>a</mi><mi>i</mi><mi>n</mi><mi>e</mi><mi>r</mi><mo>.</mo><mi>s</mi><mi>t</mi><mi>m</mi><mi>t</mi><msub><mi>s</mi><mrow><mi>s</mi><mi>i</mi></mrow></msub><mo>=</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>S</mi><mi>t</mi><mi>m</mi><mi>t</mi></math>
+</div>
+</div>
+<div class="paragraph">
+<p>Then, the following constraint must hold: <sup class="footnote">[<a id="_footnoteref_52" class="footnote" href="appendix_c_bibliography.html#_footnote_52" title="View footnote.">52</a>]</sup></p>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mspace width="3.0mm"/><mo>∀</mo><mi>i</mi><mo>&lt;</mo><mi>s</mi><mi>i</mi><mi>:</mi><mo>∄</mo><mi>e</mi><mi>l</mi><mi>e</mi><mi>m</mi><mi>e</mi><mi>n</mi><mi>t</mi><msup><mo>∈</mo><mo>*</mo></msup><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>S</mi><mi>t</mi><mi>m</mi><mi>t</mi><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>t</mi><mi>a</mi><mi>i</mi><mi>n</mi><mi>e</mi><mi>r</mi><mo>.</mo><mi>s</mi><mi>t</mi><mi>m</mi><mi>t</mi><msub><mi>s</mi><mi>i</mi></msub><mi>:</mi><mtext>
+</mtext><mspace width="3.0mm"/><mspace width="3.0em"/><mi>μ</mi><mfenced close=")" open="("><mi>i</mi></mfenced><mo>∈</mo><mstyle mathvariant="monospace"><mtext>ThisLiteral, ReturnStatement</mtext></mstyle></math>
+</div>
+</div>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>Further constraints with regard to super constructor calls are described in <a href="types.html#_constructor-and-classifier-type">Constructor and Classifier Type</a>.</p>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-124"></a><strong>Req. IDE-124:</strong> <a href="#Req-IDE-124">Access Super Member with Super Literal</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>If the super literal <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>s</mi></math> is used to access a member of the super class, all of the following constraints must hold, with <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>c</mi><mo>=</mo><mi>s</mi><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>t</mi><mi>a</mi><mi>i</mi><mi>n</mi><mi>e</mi><mi>r</mi><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>t</mi><mi>a</mi><mi>i</mi><mi>n</mi><mi>e</mi><mi>r</mi></math></p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>The super literal must be the receiver of a method call (cf. remarks below):</p>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mtable><mtr><mtd><mspace width="3.0mm"/><mi>μ</mi><mfenced close=")" open="("><mi>c</mi></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>CallExpression</mtext></mstyle></mtd></mtr><mtr><mtd><mo>∧</mo><mspace width="3.0mm"/><mi>c</mi><mo>.</mo><mi>t</mi><mi>a</mi><mi>r</mi><mi>g</mi><mi>e</mi><mi>t</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>PropertyAccessExpression</mtext></mstyle></mtd></mtr><mtr><mtd><mo>∧</mo><mspace width="3.0mm"/><mi>c</mi><mo>.</mo><mi>t</mi><mi>a</mi><mi>r</mi><mi>g</mi><mi>e</mi><mi>t</mi><mo>.</mo><mi>t</mi><mi>a</mi><mi>r</mi><mi>g</mi><mi>e</mi><mi>t</mi><mo>=</mo><mi>s</mi></mtd></mtr></mtable></math>
+</div>
+</div>
+</li>
+<li>
+<p>The super literal is used in a method or field accessor of a class:</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>μ</mi><mfenced close=")" open="("><mrow><mi>s</mi><mo>.</mo><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>t</mi><mi>a</mi><mi>i</mi><mi>n</mi><mi>i</mi><mi>n</mi><mi>g</mi><mi>C</mi><mi>l</mi><mi>a</mi><mi>s</mi><mi>s</mi></mrow></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>Class</mtext></mstyle></math>
+3.  The super literal must not be used in a nested function expression:</p>
+</div>
+<div class="paragraph">
+<p>+
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>μ</mi><mfenced close=")" open="("><mrow><mi>s</mi><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>t</mi><mi>a</mi><mi>i</mi><mi>n</mi><mi>i</mi><mi>n</mi><mi>g</mi><mi>F</mi><mi>u</mi><mi>n</mi><mi>c</mi><mi>t</mi><mi>i</mi><mi>o</mi><mi>n</mi></mrow></mfenced><mo>=</mo><mi>s</mi><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>t</mi><mi>a</mi><mi>i</mi><mi>n</mi><mi>i</mi><mi>n</mi><mi>g</mi><mi>M</mi><mi>e</mi><mi>t</mi><mi>h</mi><mi>o</mi><mi>d</mi><mi>O</mi><mi>r</mi><mi>F</mi><mi>i</mi><mi>e</mi><mi>l</mi><mi>d</mi><mi>A</mi><mi>c</mi><mi>c</mi><mi>e</mi><mi>s</mi><mi>s</mi><mi>o</mi><mi>r</mi></math>
+4.  If the return type of the method access via super is this, the actually bound this type will be the type of the calling class (and not of the class defining the method).</p>
+</div>
+<div class="paragraph">
+<p>+</p>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><mi>s</mi><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>t</mi><mi>a</mi><mi>i</mi><mi>n</mi><mi>i</mi><mi>n</mi><mi>g</mi><mi>C</mi><mi>l</mi><mi>a</mi><mi>s</mi><mi>s</mi><mo>=</mo><mi>T</mi><mspace width="3.0mm"/><mi>μ</mi><mfenced close=")" open="("><mi>m</mi></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>Method</mtext></mstyle><mspace width="3.0mm"/><mi>m</mi><mo>.</mo><mi>r</mi><mi>e</mi><mi>t</mi><mi>u</mi><mi>r</mi><mi>n</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>this</mtext></mstyle></mrow><mrow><mstyle mathvariant="monospace"><mtext>function():T</mtext></mstyle><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>s</mi><mo>.</mo><mi>m</mi></mrow></mfrac></math>
+</div>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-125"></a><strong>Req. IDE-125:</strong> <a href="#Req-IDE-125">Super Literal Usage</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>For super literals, either <a href="#Req-IDE-123">[Req-IDE-123]</a> or <a href="#Req-IDE-124">[Req-IDE-124]</a> must hold, no other usage
+is allowed.</p>
+</div>
+<div class="paragraph">
+<p>Consequences:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Since fields cannot be overridden (except for changing the access modifier), it is not possible nor allowed to access a field via <code>super</code>.</p>
+</li>
+<li>
+<p>Super literals must not be used with index access (e.g., <code>super["foo"]</code>)</p>
+</li>
+<li>
+<p>It is not possible to chain super keywords. That is, it is not possible to call <code>super.super.m()</code>.</p>
+</li>
+<li>
+<p>It is not allowed to use the super literal in interfaces or non-methods/accessors.</p>
+</li>
+<li>
+<p>Super cannot be used to call an overridden method of an implemented method from the overriding method in the implementing class.</p>
+</li>
+<li>
+<p>In order to be able to access a super method of a method <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>M</mi></math> of a class <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>C</mi></math>, exactly one non-abstract super method <math xmlns="http://www.w3.org/1998/Math/MathML"><msup><mi>M</mi><mi>'</mi></msup></math> in a super class <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>S</mi></math> of <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>C</mi></math> must exist.
+This is assured by the standard rules for binding identifiers.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>If super is used to access a super member, the receiver type is not changed.
+This is important in particular for static methods as demonstrated in the following example:</p>
+</div>
+<div class="exampleblock">
+<div class="title">Example 92. Super Call in Static Methods</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">class A {
+    static foo(): void { console.log("A") }
+    static bar(): void {
+        this.foo();
+    }
+}
+
+class B extends A {
+
+    @Override
+    static foo(): void { console.log("B") }
+    @Override
+    static bar(): void {
+        A.bar();        <i class="conum" data-value="1"></i><b>(1)</b>
+        super.bar();    <i class="conum" data-value="2"></i><b>(2)</b>
+    }
+}
+
+B.bar();</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="colist arabic">
+<table>
+<tr>
+<td><i class="conum" data-value="1"></i><b>1</b></td>
+<td>The receiver (which is similar to the this-binding in ECMAScript) is changed to <code>A</code>.</td>
+</tr>
+<tr>
+<td><i class="conum" data-value="2"></i><b>2</b></td>
+<td>Using super, the receiver is preserved, i.e. <code>B</code>.</td>
+</tr>
+</table>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="_ecmascript-7-expressions"><a class="anchor" href="#_ecmascript-7-expressions"></a><a class="link" href="#_ecmascript-7-expressions">8.3. ECMAScript 7 Expressions</a></h3>
+<div class="sect3">
+<h4 id="_await-expression"><a class="anchor" href="#_await-expression"></a><a class="link" href="#_await-expression">8.3.1. Await Expression</a></h4>
+<div class="paragraph">
+<p>In N4JS, <code>await</code> is implemented as a unary operator with the same precedence as <code>yield</code> in ECMAScript 6.</p>
+</div>
+<div class="paragraph">
+<p>Constraints governing the use of <code>await</code> are given together with those for <code>async</code> in <a href="functions.html#_asynchronous-functions">Asynchronous Functions</a>.</p>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="_n4js-specific-expressions"><a class="anchor" href="#_n4js-specific-expressions"></a><a class="link" href="#_n4js-specific-expressions">8.4. N4JS Specific Expressions</a></h3>
+<div class="sect3">
+<h4 id="_class-expression"><a class="anchor" href="#_class-expression"></a><a class="link" href="#_class-expression">8.4.1. Class Expression</a></h4>
+<div class="paragraph">
+<p>A class expression in N4JS is similar to a class expression in ECMAScript 6 [<a href="appendix_c_bibliography.html#ECMA15a">ECMA15a(p.14.5)</a>].</p>
+</div>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title=""></i>
+</td>
+<td class="content">
+Class expressions are not part of version 0.3
+</td>
+</tr>
+</table>
+</div>
+<h5 id="class-expression-syntax" class="discrete">Syntax</h5>
+<div class="paragraph">
+<p>See <a href="classifiers.html#_classes">Classes</a>.</p>
+</div>
+<h5 id="class-expression-semantics-type-inference" class="discrete">Semantics and Type Inference</h5>
+<div class="paragraph">
+<p>The inferred type of a class expression simply is the class type as described in <a href="types.html#_constructor-and-classifier-type">Constructor and Classifier Type</a>.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_cast-as-expression"><a class="anchor" href="#_cast-as-expression"></a><a class="link" href="#_cast-as-expression">8.4.2. Cast (As) Expression</a></h4>
+<h5 id="cast-as-expression-syntax" class="discrete">Syntax</h5>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">CastExpression &lt;Yield&gt; returns Expression: expression=Expression 'as' targetTypeRef=TypeRefForCast;
+
+TypeRefForCast returns StaticBaseTypeRef:
+      ParameterizedTypeRef
+    | ThisTypeRef
+    | ConstructorTypeRef
+    | ClassifierTypeRef
+    | FunctionTypeExpression
+    | UnionTypeExpression
+    | IntersectionTypeExpression</code></pre>
+</div>
+</div>
+<div class="sect4">
+<h5 id="cast-as-expression-semantics-type-inference"><a class="anchor" href="#cast-as-expression-semantics-type-inference"></a><a class="link" href="#cast-as-expression-semantics-type-inference">8.4.2.1. Semantics and Type Inference</a></h5>
+<div class="paragraph">
+<p>The inferred type of the type cast expression is the target type:</p>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow/><mrow><mi>Γ</mi><mo>⊢</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi> </mi><mstyle mathvariant="monospace"><mtext>"as"</mtext></mstyle><mi> </mi><mi>T</mi><mi>:</mi><mi>T</mi></mrow></mfrac></math>
+</div>
+</div>
+<div class="paragraph">
+<p>The type cast returns the expression without further modifications.
+Type casts are simply removed during compilation so there will be no exceptions thrown at the cast until later when accessing properties which may not be present in case of a failed cast.</p>
+</div>
+<div class="paragraph">
+<p>An error is issued if the cast is either unnecessary or cannot succeed.
+See further details in <a href="conversions_and_reflection.html#_type-cast">Type Cast</a>.</p>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="Import_Calls"><a class="anchor" href="#Import_Calls"></a><a class="link" href="#Import_Calls">8.4.3. Import Calls</a></h4>
+<div class="paragraph">
+<p>Import calls as specified by the corresponding <a href="https://github.com/tc39/proposal-dynamic-import">ECMA TC39 proposal</a> are
+available in N4JS. Such an import call has the form</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">import(moduleSpecifier)</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>and may appear in the source code wherever an expression may appear. It&#8217;s argument need not be a string literal, as is
+the case with module specifiers of ordinary imports; instead, any expression that evaluates to a string at runtime is
+accepted. Hence, it can be used to import from a target module that is not yet known at compile time.</p>
+</div>
+<div class="paragraph">
+<p>A note on terminology: import calls covered in this section are sometimes referred to as "dynamic import". In N4JS
+that term is already used for imports of the form <code>import * as N+ from "&#8230;&#8203;"</code>, i.e. compile-time imports that do not
+require type information of the module imported from, see <a href="statements.html#Dynamic_Imports">Dynamic Imports</a>, and stems from the term "dynamic type"
+(see <a href="types.html#Type_Modifiers_Dynamic">Dynamic</a>). To avoid confusion, we will usually avoid referring to import calls as a "dynamic
+import".</p>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="compile-time-expressions"><a class="anchor" href="#compile-time-expressions"></a><a class="link" href="#compile-time-expressions">8.5. Compile-Time Expressions</a></h3>
+<div class="paragraph">
+<p>A compile-time expression is an expression that can be fully evaluated at compile time. Not all expressions introduced
+in the previous sections qualify as compile-time expressions. Some forms of expressions always qualify (e.g. a string
+literal is always a compile-time expression), some never (e.g. call expressions), and for some expressions the operands
+must be of a certain value. The latter applies, for example, to divison: <code>5 / 0</code> is a valid ECMAScript expression (evaluating
+to <code>NaN</code>) but is not a compile-time expression. So it&#8217;s the actual compile-time value of the divisor that makes the difference,
+here. In any case, if an expression has operands, it is a compile-time expression only if all operands are compile-time expressions.</p>
+</div>
+<div class="paragraph">
+<p>The value a compile-time expression evaluates to at compile-time is called <em>compile-time value</em>. So, an expression has a compile-time
+value if and only if it is a compile-time expression.</p>
+</div>
+<div class="openblock definition">
+<div class="content">
+<div class="paragraph">
+<p><a id="compile_time_expression"></a><strong>Definition:</strong> <a href="#compile_time_expression">Compile-Time Expression</a></p>
+</div>
+<div class="paragraph">
+<p>The following expressions are called compile-time expressions:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>undefined</code> (but not <code>NaN</code> or <code>Infinity</code>).</p>
+</li>
+<li>
+<p>the <code>null</code> literal.</p>
+</li>
+<li>
+<p>all boolean, numeric, and string literals.</p>
+</li>
+<li>
+<p>template string literals, iff all embedded expressions are compile-time expressions.</p>
+</li>
+<li>
+<p>a parenthesis expression, iff its nested expression is a compile-time expression.</p>
+</li>
+<li>
+<p>unary expressions in case of the following operators:</p>
+<div class="ulist">
+<ul>
+<li>
+<p><code>!</code> iff the operand is a compile-time expression and evaluates to a boolean value.</p>
+</li>
+<li>
+<p><code>+</code> iff the operand is a compile-time expression and evaluates to a numeric value.</p>
+</li>
+<li>
+<p><code>-</code> iff the operand is a compile-time expression and evaluates to a numeric value.</p>
+</li>
+<li>
+<p><code>void</code>.</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>binary expressions in case of the following operators:</p>
+<div class="ulist">
+<ul>
+<li>
+<p><code>+</code> iff both operands are compile-time expressions and</p>
+<div class="ulist">
+<ul>
+<li>
+<p>both evaluate to numeric values, or</p>
+</li>
+<li>
+<p>at least one evaluates to a string value.</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p><code>-</code>, <code>*</code> iff both operands are compile-time expressions and evaluate to numeric values.</p>
+</li>
+<li>
+<p><code>/</code>, <code>%</code> iff both operands are compile-time expressions and evaluate to numeric values and the right-hand operand is non-zero (i.e. division by zero is disallowed in compile-time expression, because <code>NaN</code> is not a supported compile-time value).</p>
+</li>
+<li>
+<p><code>&amp;&amp;</code>, <code>||</code> iff both operands are compile-time expressions and evaluate to boolean values.</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>a tertiary conditional expression, iff the first operand is a compile-time expression evaluating to a boolean value B and</p>
+<div class="ulist">
+<ul>
+<li>
+<p>in case B is true, the second operand is a compile-time expression.</p>
+</li>
+<li>
+<p>in case B is false, the third operand is a compile-time expression.</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>an identifier reference to a const variable, iff its initializer expression is a compile-time expression.</p>
+</li>
+<li>
+<p>a property access expression, iff it is direct (see <a href="#property-access-direct">Direct Property Access</a>) and refers to</p>
+<div class="ulist">
+<ul>
+<li>
+<p>a built-in symbol, e.g. <code>Symbol.iterator</code>,</p>
+</li>
+<li>
+<p>a literal of a <code>@StringBased</code> enum, or</p>
+</li>
+<li>
+<p>a const field with a compile-time initializer expression.</p>
+</li>
+</ul>
+</div>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>In all other cases, the expression is not a compile-time expression.</p>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Every expression in the code may be a compile-time expression, but in most places this has no particular
+effect and is simply ignored. They are of significance only in computed property names, in index access
+expressions, as initializers of const variables and fields (as stated above) and when nested as an operand
+inside an expression at these locations.</p>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div id="footer">
+<div id="footer-text">
+Version 0.9<br>
+Last updated 2019-08-07 15:02:40 CEST
+</div>
+</div>
+<!-- ************* docinfo-footer *************************************************************** -->
+<div class="Grid social" style="color:#d5dfea">
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <h2>Quick Links</h2>
+    <ul>
+      <li><a href="../downloads.html">Download</a></li>
+      <li><a href="../userguides/index.html">Documentation</a></li>
+      <li><a href="https://github.com/eclipse/n4js/">Source</a></li>
+      <li><a href="https://github.com/eclipse/n4js/issues">Issues</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="https://www.eclipse.org/forums/index.php/f/365/">Forum</a></li>
+      <li><a href="http://n4js.blogspot.de/">Blog</a></li>
+      <li><a href="https://dev.eclipse.org/mailman/listinfo/n4js-dev">Mailing List</a></li>
+      <li><a href="https://projects.eclipse.org/projects/technology.n4js">Eclipse Project Page</a></li>
+      <li><a href="https://twitter.com/n4jsdev">Tweets by n4jsdev</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="http://www.eclipse.org/">Eclipse Home</a></li>
+      <li><a href="http://www.eclipse.org/legal/privacy.php">Privacy Policy</a></li>
+      <li><a href="http://www.eclipse.org/legal/termsofuse.php">Terms of Use</a></li>
+      <li><a href="http://www.eclipse.org/legal/copyright.php">Copyright Agent</a></li>
+      <li><a href="http://www.eclipse.org/legal/">Legal</a></li>
+    </ul>
+  </div>
+  <div style="clear: both; height: 0; overflow: hidden;"></div>
+</div>
+
+<!-- ************* UI Scripts ************* -->
+<script type="text/javascript" src="scripts/back-to-top.js"></script>
+
+<script type="text/javascript" src="scripts/treeview.js"></script>
+<script type="text/javascript" src="scripts/toc.js"></script>
+
+<!-- ************* Prism.js Syntax Highlighting ************* -->
+<script src="scripts/prism.js"></script>
+
+<script type="text/javascript">
+	// Add the 'toclist' id for search function
+	$(".toc2 > ul").attr('id', 'toclist');
+	// Generate a Search input form
+	$("#toclist > li:first-of-type").before('<input type="text" id="pagesearch" onkeyup="search()" placeholder="Search for section...">');
+	$("#toclist > li:first-of-type").before('<i id="clear" class="fa fa-times-circle-o"></i>');
+	$("#clear").click(function(){
+	    $("#pagesearch").val('');
+	    search();
+	    $('.toc2 > ul').treeView('collapseAll');
+	});
+	// intialize Treeview.js
+	$(".toc2 > ul").treeView();
+	// Initialize Scrollspy
+</script>
+<!-- ************* docinfo-footer *************************************************************** -->
+</body>
+</html>
\ No newline at end of file
diff --git a/spec/extended_fetaures.html b/spec/extended_fetaures.html
new file mode 100644
index 0000000..d9a4bc4
--- /dev/null
+++ b/spec/extended_fetaures.html
@@ -0,0 +1,3282 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="generator" content="Asciidoctor 1.5.5">
+<meta name="author" content="2019-08-07 15:02:40 CEST">
+<title>N4JS Language Specification</title>
+<link rel="stylesheet" href="styles/spec.min.css">
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.6.3/css/font-awesome.min.css">
+<!-- ************* docinfo ******************************************************************* -->
+
+
+<!-- ************* Favicon ************-->
+<link rel="icon" href="images/favicon.ico" />
+
+<!-- ************* Back-to-top JQuery ************* -->
+<script src="https://code.jquery.com/jquery-1.12.4.js"></script>
+<script src="https://code.jquery.com/ui/1.12.0/jquery-ui.js"></script>
+
+
+<link href="styles/prism.min.css" rel="stylesheet" />
+<script type="text/javascript" async
+  src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2/MathJax.js?config=TeX-MML-AM_CHTML">
+</script>
+
+<!-- ************* Styles ************* -->
+<link rel="stylesheet" type="text/css" href="styles/n4jsspec-adoc.css">
+
+
+<!-- ****************** NavBar ****************** -->
+<div id="menubar">
+	<div class="banner">
+        <a href="https://www.eclipse.org/n4js/#"><img id="logo" src="images/n4js-logo.png" alt="Eclipse N4JS"></a>
+    </div>
+<ul>
+  <li><a href="index.html">Index</a></li>
+</ul>
+</div>
+<!-- ************* docinfo ******************************************************************* -->
+<style>
+      .admonitionblock td.icon .icon-todo:before{content:"\f249";color:#f4ee42}
+    </style>
+</head>
+<body class="book toc2 toc-left">
+<div id="header">
+<h1>N4JS Language Specification</h1>
+<div class="details">
+<span id="author" class="author">2019-08-07 15:02:40 CEST</span><br>
+<span id="revnumber">version 0.9</span>
+</div>
+<div id="toc" class="toc2">
+<div id="toctitle">Table of Contents</div>
+<ul class="sectlevel1">
+<li><a href="introduction.html#_introduction">1. Introduction</a>
+<ul class="sectlevel2">
+<li><a href="introduction.html#_notation">1.1. Notation</a>
+<ul class="sectlevel3">
+<li><a href="introduction.html#_grammar-notation">1.1.1. Grammar Notation</a></li>
+<li><a href="introduction.html#_type-judgments-and-rules-and-constraints-notation">1.1.2. Type Judgments and Rules and Constraints Notation</a>
+<ul class="sectlevel4">
+<li><a href="introduction.html#_typing-rules-and-judgments">1.1.2.1. Typing Rules and Judgments</a></li>
+<li><a href="introduction.html#_types-of-an-element">1.1.2.2. Types of an Element</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="introduction.html#_auxiliary-functions">1.2. Auxiliary Functions</a>
+<ul class="sectlevel3">
+<li><a href="introduction.html#_binding">1.2.1. Binding</a></li>
+<li><a href="introduction.html#_merging-types">1.2.2. Merging Types</a>
+<ul class="sectlevel4">
+<li><a href="introduction.html#_logic-formulas">1.2.2.1. Logic Formulas</a></li>
+</ul>
+</li>
+<li><a href="introduction.html#_symbols-and-font-convention">1.2.3. Symbols and Font Convention</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="grammar.html#_grammar">2. Grammar</a>
+<ul class="sectlevel2">
+<li><a href="grammar.html#_lexical-conventions">2.1. Lexical Conventions</a>
+<ul class="sectlevel3">
+<li><a href="grammar.html#_identifier-names-and-identifiers">2.1.1. Identifier Names and Identifiers</a></li>
+<li><a href="grammar.html#_this-keyword">2.1.2. This Keyword</a></li>
+<li><a href="grammar.html#_regular-expression-literals">2.1.3. Regular Expression Literals</a></li>
+<li><a href="grammar.html#_automatic-semicolon-insertion">2.1.4. Automatic Semicolon Insertion</a></li>
+<li><a href="grammar.html#_jsdoc">2.1.5. JSDoc</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="names.html#_names">3. Names</a>
+<ul class="sectlevel2">
+<li><a href="names.html#_access-control">3.1. Access Control</a></li>
+<li><a href="names.html#_accessibility-of-types-top-level-variables-and-function-declarations">3.2. Accessibility of Types, Top-Level Variables and Function Declarations</a>
+<ul class="sectlevel3">
+<li><a href="names.html#_accessibility-of-members">3.2.1. Accessibility of Members</a></li>
+<li><a href="names.html#_valid-names">3.2.2. Valid Names</a></li>
+<li><a href="names.html#_qualified-names">3.2.3. Qualified Names</a></li>
+<li><a href="names.html#_name-duplicates">3.2.4. Name Duplicates</a>
+<ul class="sectlevel4">
+<li><a href="names.html#_lexical-environment">3.2.4.1. Lexical Environment</a></li>
+<li><a href="names.html#_duplicates-and-shadowing">3.2.4.2. Duplicates and Shadowing</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="types.html#_types">4. Types</a>
+<ul class="sectlevel2">
+<li><a href="types.html#_overview">4.1. Overview</a></li>
+<li><a href="types.html#_type-expressions">4.2. Type Expressions</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_syntax">4.2.1. Syntax</a></li>
+<li><a href="types.html#_properties">4.2.2. Properties</a></li>
+<li><a href="types.html#_semantics">4.2.3. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_type-inference">4.3. Type Inference</a></li>
+<li><a href="types.html#_generic-and-parameterized-types">4.4. Generic and Parameterized Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_generic-types">4.4.1. Generic Types</a></li>
+<li><a href="types.html#_type-variables">4.4.2. Type Variables</a></li>
+<li><a href="types.html#_parameterized-types">4.4.3. Parameterized Types</a></li>
+</ul>
+</li>
+<li><a href="types.html#_primitive-ecmascript-types">4.5. Primitive ECMAScript Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_undefined-type">4.5.1. Undefined Type</a></li>
+<li><a href="types.html#_null-type">4.5.2. Null Type</a></li>
+<li><a href="types.html#_primitive-boolean-type">4.5.3. Primitive Boolean Type</a></li>
+<li><a href="types.html#_primitive-string-type">4.5.4. Primitive String Type</a></li>
+<li><a href="types.html#_primitive-number-type">4.5.5. Primitive Number Type</a></li>
+<li><a href="types.html#_primitive-type-int">4.5.6. Primitive Type int</a></li>
+<li><a href="types.html#_primitive-symbol-type">4.5.7. Primitive Symbol Type</a></li>
+</ul>
+</li>
+<li><a href="types.html#_primitive-n4js-types">4.6. Primitive N4JS Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_any-type">4.6.1. Any Type</a>
+<ul class="sectlevel4">
+<li><a href="types.html#any-type-semantics">4.6.1.1. Semantics</a></li>
+<li><a href="types.html#any-type-type-inference">4.6.1.2. Type Inference</a>
+<ul class="sectlevel5">
+<li><a href="types.html#_default-type-of-variables">4.6.1.2.1. Default Type of Variables</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="types.html#_void-type">4.6.2. Void Type</a>
+<ul class="sectlevel4">
+<li><a href="types.html#void-type-semantics">4.6.2.1. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_unknown-type">4.6.3. Unknown Type</a></li>
+<li><a href="types.html#_primitive-pathselector-and-i18nkey">4.6.4. Primitive Pathselector and I18nKey</a>
+<ul class="sectlevel4">
+<li><a href="types.html#pathselector-semantics">4.6.4.1. Semantics</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="types.html#_built-in-ecmascript-object-types">4.7. Built-in ECMAScript Object Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#ECMAScript-objects-semantics">4.7.1. Semantics</a></li>
+<li><a href="types.html#_object-type">4.7.2. Object Type</a></li>
+<li><a href="types.html#_function-object-type">4.7.3. Function-Object-Type</a></li>
+<li><a href="types.html#_array-object-type">4.7.4. Array Object Type</a></li>
+<li><a href="types.html#_string-object-type">4.7.5. String Object Type</a></li>
+<li><a href="types.html#_boolean-object-type">4.7.6. Boolean Object Type</a></li>
+<li><a href="types.html#_number-object-type">4.7.7. Number Object Type</a></li>
+<li><a href="types.html#_global-object-type">4.7.8. Global Object Type</a></li>
+<li><a href="types.html#_symbol">4.7.9. Symbol</a></li>
+<li><a href="types.html#_promise">4.7.10. Promise</a></li>
+<li><a href="types.html#_iterator-interface">4.7.11. Iterator Interface</a></li>
+<li><a href="types.html#_iterable-interface">4.7.12. Iterable Interface</a></li>
+</ul>
+</li>
+<li><a href="types.html#_built-in-n4js-types">4.8. Built-In N4JS Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_n4object">4.8.1. N4Object</a>
+<ul class="sectlevel4">
+<li><a href="types.html#N4Object-semantics">4.8.1.1. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_n4class">4.8.2. N4Class</a></li>
+<li><a href="types.html#IterableN">4.8.3. IterableN</a></li>
+</ul>
+</li>
+<li><a href="types.html#_type-modifiers">4.9. Type Modifiers</a>
+<ul class="sectlevel3">
+<li><a href="types.html#Type_Modifiers_Dynamic">4.9.1. Dynamic</a></li>
+<li><a href="types.html#_optional-return-types">4.9.2. Optional Return Types</a></li>
+</ul>
+</li>
+<li><a href="types.html#_union-and-intersection-type-composed-types">4.10. Union and Intersection Type (Composed Types)</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_union-type">4.10.1. Union Type</a>
+<ul class="sectlevel4">
+<li><a href="types.html#union-type-syntax">4.10.1.1. Syntax</a></li>
+<li><a href="types.html#union-type-semantics">4.10.1.2. Semantics</a></li>
+<li><a href="types.html#_warnings">4.10.1.3. Warnings</a></li>
+</ul>
+</li>
+<li><a href="types.html#_intersection-type">4.10.2. Intersection Type</a>
+<ul class="sectlevel4">
+<li><a href="types.html#intersection-type-syntax">4.10.2.1. Syntax</a></li>
+<li><a href="types.html#intersection-type-semantics">4.10.2.2. Semantics</a></li>
+<li><a href="types.html#_warnings-2">4.10.2.3. Warnings</a></li>
+</ul>
+</li>
+<li><a href="types.html#_composed-types-in-wildcards">4.10.3. Composed Types in Wildcards</a></li>
+<li><a href="types.html#_property-access-for-composed-types">4.10.4. Property Access for Composed Types</a>
+<ul class="sectlevel4">
+<li><a href="types.html#_properties-of-union-type">4.10.4.1. Properties of Union Type</a>
+<ul class="sectlevel5">
+<li><a href="types.html#_remarks-on-union-type-s-members">4.10.4.1.1. Remarks on union type’s members:</a></li>
+</ul>
+</li>
+<li><a href="types.html#_properties-of-intersection-type">4.10.4.2. Properties of Intersection Type</a>
+<ul class="sectlevel5">
+<li><a href="types.html#_remarks-on-intersection-type-s-methods">4.10.4.2.1. Remarks on intersection type’s methods:</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="types.html#_constructor-and-classifier-type">4.11. Constructor and Classifier Type</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_syntax-3">4.11.1. Syntax</a></li>
+<li><a href="types.html#_semantics-2">4.11.2. Semantics</a></li>
+<li><a href="types.html#_constructors-and-prototypes-in-ecmascript-2015">4.11.3. Constructors and Prototypes in ECMAScript 2015</a></li>
+</ul>
+</li>
+<li><a href="types.html#_this-type">4.12. This Type</a>
+<ul class="sectlevel3">
+<li><a href="types.html#this-type-syntax">4.12.1. Syntax</a></li>
+<li><a href="types.html#this-keyword-semantics">4.12.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_enums">4.13. Enums</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_enums-n4js">4.13.1. Enums (N4JS)</a>
+<ul class="sectlevel4">
+<li><a href="types.html#enums-syntax">4.13.1.1. Syntax</a></li>
+<li><a href="types.html#enums-semantics">4.13.1.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_string-based-enums">4.13.2. String-Based Enums</a></li>
+</ul>
+</li>
+<li><a href="types.html#_short-hand-syntax">4.14. Short-Hand Syntax</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_array-short-hand-syntax">4.14.1. Array Short-Hand Syntax</a></li>
+<li><a href="types.html#_iterablen-short-hand-syntax">4.14.2. IterableN Short-Hand Syntax</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="classifiers.html#_classifiers">5. Classifiers</a>
+<ul class="sectlevel2">
+<li><a href="classifiers.html#_n4js-specific-classifiers">5.1. N4JS Specific Classifiers</a>
+<ul class="sectlevel3">
+<li><a href="classifiers.html#_properties-2">5.1.1. Properties</a></li>
+<li><a href="classifiers.html#_common-semantics-of-classifiers">5.1.2. Common Semantics of Classifiers</a></li>
+<li><a href="classifiers.html#_classes">5.1.3. Classes</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_definition-of-classes">5.1.3.1. Definition of Classes</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#class-syntax">5.1.3.1.1. Syntax</a></li>
+<li><a href="classifiers.html#class-properties">5.1.3.1.2. Properties</a></li>
+<li><a href="classifiers.html#class-type-inference">5.1.3.1.3. Type Inference</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#class-semantics">5.1.3.2. Semantics</a></li>
+<li><a href="classifiers.html#_final-modifier">5.1.3.3. Final Modifier</a></li>
+<li><a href="classifiers.html#_abstract-classes">5.1.3.4. Abstract Classes</a></li>
+<li><a href="classifiers.html#_non-instantiable-classes">5.1.3.5. Non-Instantiable Classes</a></li>
+<li><a href="classifiers.html#_superclass">5.1.3.6. Superclass</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_interfaces">5.1.4. Interfaces</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_definition-of-interfaces">5.1.4.1. Definition of Interfaces</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#interfaces-syntax">5.1.4.1.1. Syntax</a></li>
+<li><a href="classifiers.html#interfaces-properties">5.1.4.1.2. Properties</a></li>
+<li><a href="classifiers.html#interfaces-type-inference">5.1.4.1.3. Type Inference</a></li>
+<li><a href="classifiers.html#interfaces-semantics">5.1.4.1.4. Semantics</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="classifiers.html#_generic-classifiers">5.1.5. Generic Classifiers</a></li>
+<li><a href="classifiers.html#sec:definition-site-variance">5.1.6. Definition-Site Variance</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_members">5.2. Members</a>
+<ul class="sectlevel3">
+<li><a href="classifiers.html#_syntax-4">5.2.1. Syntax</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_properties-3">5.2.1.1. Properties</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_semantics-3">5.2.2. Semantics</a></li>
+<li><a href="classifiers.html#_methods">5.2.3. Methods</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_syntax-5">5.2.3.1. Syntax</a></li>
+<li><a href="classifiers.html#_properties-4">5.2.3.2. Properties</a></li>
+<li><a href="classifiers.html#_semantics-4">5.2.3.3. Semantics</a></li>
+<li><a href="classifiers.html#_final-methods">5.2.3.4. Final Methods</a></li>
+<li><a href="classifiers.html#_abstract-methods">5.2.3.5. Abstract Methods</a></li>
+<li><a href="classifiers.html#_generic-methods">5.2.3.6. Generic Methods</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_default-methods-in-interfaces">5.2.4. Default Methods in Interfaces</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_asynchronous-methods">5.2.4.1. Asynchronous Methods</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_constructors">5.2.5. Constructors</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_structural-this-type-in-constructor">5.2.5.1. Structural This Type in Constructor</a></li>
+<li><a href="classifiers.html#spec-constructor">5.2.5.2. @Spec Constructor</a></li>
+<li><a href="classifiers.html#_callable-constructors">5.2.5.3. Callable Constructors</a></li>
+<li><a href="classifiers.html#_covariant-constructors">5.2.5.4. Covariant Constructors</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_data-fields">5.2.6. Data Fields</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#data-fields-syntax">5.2.6.1. Syntax</a></li>
+<li><a href="classifiers.html#data-fields-properties">5.2.6.2. Properties</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#data-fields-semantics">5.2.6.2.1. Semantics</a></li>
+<li><a href="classifiers.html#data-fields-type-inference">5.2.6.2.2. Type Inference</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_assignment-modifiers">5.2.6.3. Assignment Modifiers</a></li>
+<li><a href="classifiers.html#_field-accessors-getter-setter">5.2.6.4. Field Accessors (Getter/Setter)</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#field-acessors-syntax">5.2.6.4.1. Syntax</a></li>
+<li><a href="classifiers.html#field-acessors-properties">5.2.6.4.2. Properties</a></li>
+<li><a href="classifiers.html#field-accessors-semantics">5.2.6.4.3. Semantics</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#optional-fields">5.2.6.5. Optional Fields</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#_syntax-6">5.2.6.5.1. Syntax</a></li>
+<li><a href="classifiers.html#_semantics-5">5.2.6.5.2. Semantics</a></li>
+<li><a href="classifiers.html#_background">5.2.6.5.3. Background</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="classifiers.html#_static-members">5.2.7. Static Members</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_access-from-and-to-static-members">5.2.7.1. Access From and To Static Members</a></li>
+<li><a href="classifiers.html#_generic-static-methods">5.2.7.2. Generic static methods</a></li>
+<li><a href="classifiers.html#_static-members-of-interfaces">5.2.7.3. Static Members of Interfaces</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_redefinition-of-members">5.2.8. Redefinition of Members</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_overriding-of-members">5.2.8.1. Overriding of Members</a></li>
+<li><a href="classifiers.html#_implementation-of-members">5.2.8.2. Implementation of Members</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#_member-consumption">5.2.8.2.1. Member Consumption</a></li>
+<li><a href="classifiers.html#_member-implementation">5.2.8.2.2. Member Implementation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="classifiers.html#_structural-typing">5.3. Structural Typing</a>
+<ul class="sectlevel3">
+<li><a href="classifiers.html#_syntax-7">5.3.1. Syntax</a></li>
+<li><a href="classifiers.html#_definition-site-structural-typing">5.3.2. Definition Site Structural Typing</a></li>
+<li><a href="classifiers.html#_use-site-structural-typing">5.3.3. Use-Site Structural Typing</a></li>
+<li><a href="classifiers.html#structural-readWriteInit-field-typing">5.3.4. Structural Read-only, Write-only and Initializer Field Typing</a></li>
+<li><a href="classifiers.html#_public-setter-annotated-with-code-providesinitializer-code">5.3.5. Public Setter Annotated With <code>ProvidesInitializer</code></a></li>
+<li><a href="classifiers.html#_structural-types-with-optional-fields">5.3.6. Structural Types With Optional Fields</a></li>
+<li><a href="classifiers.html#_structural-types-with-access-modifier">5.3.7. Structural Types With Access Modifier</a></li>
+<li><a href="classifiers.html#_structural-types-with-additional-members">5.3.8. Structural Types With Additional Members</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_syntax-8">5.3.8.1. Syntax</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#_semantics-6">5.3.8.1.1. Semantics</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="functions.html#_functions">6. Functions</a>
+<ul class="sectlevel2">
+<li><a href="functions.html#_function-type">6.1. Function Type</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_properties-5">6.1.1. Properties</a></li>
+<li><a href="functions.html#function-type-inference">6.1.2. Type Inference</a></li>
+<li><a href="functions.html#_autoboxing-of-function-type">6.1.3. Autoboxing of Function Type</a></li>
+<li><a href="functions.html#_arguments-object">6.1.4. Arguments Object</a></li>
+</ul>
+</li>
+<li><a href="functions.html#_ecmascript-5-function-definition">6.2. ECMAScript 5 Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_function-declaration">6.2.1. Function Declaration</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#_syntax-9">6.2.1.1. Syntax</a></li>
+<li><a href="functions.html#_semantics-8">6.2.1.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="functions.html#_function-expression">6.2.2. Function Expression</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#function-expression-syntax">6.2.2.1. Syntax</a></li>
+<li><a href="functions.html#_semantics-and-type-inference">6.2.2.2. Semantics and Type Inference</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="functions.html#_ecmascript-2015-function-definition">6.3. ECMAScript 2015 Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_formal-parameters">6.3.1. Formal Parameters</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#Type_Modifiers_Optional">6.3.1.1. Optional Parameters</a></li>
+<li><a href="functions.html#Type_Modifiers_Default">6.3.1.2. Default Parameters</a></li>
+<li><a href="functions.html#Type_Modifiers_Variadic">6.3.1.3. Variadic</a></li>
+</ul>
+</li>
+<li><a href="functions.html#_generator-functions">6.3.2. Generator Functions</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#generator-functions-syntax">6.3.2.1. Syntax</a></li>
+<li><a href="functions.html#generator-functions-semantics">6.3.2.2. Semantics</a></li>
+<li><a href="functions.html#_generator-arrow-functions">6.3.2.3. Generator Arrow Functions</a></li>
+</ul>
+</li>
+<li><a href="functions.html#_arrow-function-expression">6.3.3. Arrow Function Expression</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#arrow-function-expression-syntax">6.3.3.1. Syntax</a></li>
+<li><a href="functions.html#arrow-function-expression-semantics-and-type-inference">6.3.3.2. Semantics and Type Inference</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="functions.html#_ecmascript-proposals-function-definition">6.4. ECMAScript Proposals Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_asynchronous-functions">6.4.1. Asynchronous Functions</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#asynchronous-functions-syntax">6.4.1.1. Syntax</a></li>
+<li><a href="functions.html#asynchronous-functions-semantics">6.4.1.2. Semantics</a></li>
+<li><a href="functions.html#_asynchronous-arrow-functions">6.4.1.3. Asynchronous Arrow Functions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="functions.html#_n4js-extended-function-definition">6.5. N4JS Extended Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_generic-functions">6.5.1. Generic Functions</a></li>
+<li><a href="functions.html#_promisifiable-functions">6.5.2. Promisifiable Functions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_conversions-and-reflection">7. Conversions and Reflection</a>
+<ul class="sectlevel2">
+<li><a href="conversions_and_reflection.html#_autoboxing-and-coercing">7.1. Autoboxing and Coercing</a>
+<ul class="sectlevel3">
+<li><a href="conversions_and_reflection.html#_coercing">7.1.1. Coercing</a></li>
+<li><a href="conversions_and_reflection.html#_autoboxing-of-primitives">7.1.2. Autoboxing of Primitives</a></li>
+<li><a href="conversions_and_reflection.html#_autoboxing-of-function-expressions-and-declarations">7.1.3. Autoboxing of Function Expressions and Declarations</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_auto-conversion-of-objects">7.2. Auto-Conversion of Objects</a>
+<ul class="sectlevel3">
+<li><a href="conversions_and_reflection.html#_auto-conversion-of-class-instances">7.2.1. Auto-Conversion of Class Instances</a>
+<ul class="sectlevel4">
+<li><a href="conversions_and_reflection.html#_auto-conversion-of-interface-instances">7.2.1.1. Auto-Conversion of Interface Instances</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_auto-conversion-of-enum-literals">7.2.2. Auto-Conversion of Enum Literals</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_type-cast-and-type-check">7.3. Type Cast and Type Check</a>
+<ul class="sectlevel3">
+<li><a href="conversions_and_reflection.html#_type-cast">7.3.1. Type Cast</a></li>
+<li><a href="conversions_and_reflection.html#_type-check">7.3.2. Type Check</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_reflection-meta-information">7.4. Reflection meta-information</a>
+<ul class="sectlevel3">
+<li><a href="conversions_and_reflection.html#_reflection-for-classes">7.4.1. Reflection for Classes</a></li>
+<li><a href="conversions_and_reflection.html#_reflection-for-interfaces">7.4.2. Reflection for Interfaces</a></li>
+<li><a href="conversions_and_reflection.html#_reflection-for-enumerations">7.4.3. Reflection for Enumerations</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_conversion-of-primitive-types">7.5. Conversion of primitive types</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_expressions">8. Expressions</a>
+<ul class="sectlevel2">
+<li><a href="expressions.html#_ecmascript-5-expressions">8.1. ECMAScript 5 Expressions</a>
+<ul class="sectlevel3">
+<li><a href="expressions.html#_the-this-literal">8.1.1. The this Literal</a></li>
+<li><a href="expressions.html#_identifier">8.1.2. Identifier</a></li>
+<li><a href="expressions.html#_literals">8.1.3. Literals</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#_integer-literals">8.1.3.1. Integer Literals</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_array-literal">8.1.4. Array Literal</a></li>
+<li><a href="expressions.html#_object-literal">8.1.5. Object Literal</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#_properties-6">8.1.5.1. Properties</a></li>
+<li><a href="expressions.html#_scoping-and-linking">8.1.5.2. Scoping and linking</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_parenthesized-expression-and-grouping-operator">8.1.6. Parenthesized Expression and Grouping Operator</a></li>
+<li><a href="expressions.html#_property-accessors">8.1.7. Property Accessors</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#properties-1">8.1.7.1. Properties</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_new-expression">8.1.8. New Expression</a></li>
+<li><a href="expressions.html#_function-expression-2">8.1.9. Function Expression</a></li>
+<li><a href="expressions.html#_function-calls">8.1.10. Function Calls</a></li>
+<li><a href="expressions.html#_postfix-expression">8.1.11. Postfix Expression</a></li>
+<li><a href="expressions.html#_unary-expression">8.1.12. Unary Expression</a></li>
+<li><a href="expressions.html#_multiplicative-expression">8.1.13. Multiplicative Expression</a></li>
+<li><a href="expressions.html#_additive-expression">8.1.14. Additive Expression</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#type-inference-10">8.1.14.1. Type Inference</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_bitwise-shift-expression">8.1.15. Bitwise Shift Expression</a></li>
+<li><a href="expressions.html#_relational-expression">8.1.16. Relational Expression</a></li>
+<li><a href="expressions.html#_equality-expression">8.1.17. Equality Expression</a></li>
+<li><a href="expressions.html#_binary-bitwise-expression">8.1.18. Binary Bitwise Expression</a></li>
+<li><a href="expressions.html#_binary-logical-expression">8.1.19. Binary Logical Expression</a></li>
+<li><a href="expressions.html#_conditional-expression">8.1.20. Conditional Expression</a></li>
+<li><a href="expressions.html#_assignment-expression">8.1.21. Assignment Expression</a></li>
+<li><a href="expressions.html#_comma-expression">8.1.22. Comma Expression</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_ecmascript-6-expressions">8.2. ECMAScript 6 Expressions</a>
+<ul class="sectlevel3">
+<li><a href="expressions.html#_the-super-keyword">8.2.1. The super Keyword</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_ecmascript-7-expressions">8.3. ECMAScript 7 Expressions</a>
+<ul class="sectlevel3">
+<li><a href="expressions.html#_await-expression">8.3.1. Await Expression</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_n4js-specific-expressions">8.4. N4JS Specific Expressions</a>
+<ul class="sectlevel3">
+<li><a href="expressions.html#_class-expression">8.4.1. Class Expression</a></li>
+<li><a href="expressions.html#_cast-as-expression">8.4.2. Cast (As) Expression</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#cast-as-expression-semantics-type-inference">8.4.2.1. Semantics and Type Inference</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#Import_Calls">8.4.3. Import Calls</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#compile-time-expressions">8.5. Compile-Time Expressions</a></li>
+</ul>
+</li>
+<li><a href="statements.html#_statements">9. Statements</a>
+<ul class="sectlevel2">
+<li><a href="statements.html#_ecmascript-5-statements">9.1. ECMAScript 5 Statements</a>
+<ul class="sectlevel3">
+<li><a href="statements.html#_function-or-field-accessor-bodies">9.1.1. Function or Field Accessor Bodies</a></li>
+<li><a href="statements.html#_variable-statement">9.1.2. Variable Statement</a></li>
+<li><a href="statements.html#_if-statement">9.1.3. If Statement</a></li>
+<li><a href="statements.html#_iteration-statements">9.1.4. Iteration Statements</a></li>
+<li><a href="statements.html#_return-statement">9.1.5. Return Statement</a></li>
+<li><a href="statements.html#_with-statement">9.1.6. With Statement</a></li>
+<li><a href="statements.html#_switch-statement">9.1.7. Switch Statement</a></li>
+<li><a href="statements.html#_throw-try-and-catch-statements">9.1.8. Throw, Try, and Catch Statements</a></li>
+<li><a href="statements.html#_debugger-statement">9.1.9. Debugger Statement</a></li>
+</ul>
+</li>
+<li><a href="statements.html#_ecmascript-6-statements">9.2. ECMAScript 6 Statements</a>
+<ul class="sectlevel3">
+<li><a href="statements.html#_let">9.2.1. Let</a></li>
+<li><a href="statements.html#_const">9.2.2. Const</a></li>
+<li><a href="statements.html#_for-of-statement">9.2.3. <code>for &#8230;&#8203; of</code> statement</a></li>
+<li><a href="statements.html#_import-statement">9.2.4. Import Statement</a>
+<ul class="sectlevel4">
+<li><a href="statements.html#Dynamic_Imports">9.2.4.1. Dynamic Imports</a></li>
+<li><a href="statements.html#_immutabilaty-of-imports">9.2.4.2. Immutabilaty of Imports</a></li>
+</ul>
+</li>
+<li><a href="statements.html#_export-statement">9.2.5. Export Statement</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="annotations.html#_annotations">10. Annotations</a>
+<ul class="sectlevel2">
+<li><a href="annotations.html#_introduction-2">10.1. Introduction</a>
+<ul class="sectlevel3">
+<li><a href="annotations.html#_syntax-13">10.1.1. Syntax</a></li>
+<li><a href="annotations.html#_properties-7">10.1.2. Properties</a></li>
+<li><a href="annotations.html#_element-specific-annotations">10.1.3. Element-Specific Annotations</a></li>
+<li><a href="annotations.html#_general-annotations">10.1.4. General Annotations</a>
+<ul class="sectlevel4">
+<li><a href="annotations.html#_idebug">10.1.4.1. IDEBUG</a></li>
+</ul>
+</li>
+<li><a href="annotations.html#idebug-syntax">10.1.5. Syntax</a>
+<ul class="sectlevel4">
+<li><a href="annotations.html#_semantics-11">10.1.5.1. Semantics</a></li>
+<li><a href="annotations.html#_suppress-warnings">10.1.5.2. Suppress Warnings</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="annotations.html#_declaration-of-annotations">10.2. Declaration of Annotations</a></li>
+</ul>
+</li>
+<li><a href="#_extended-fetaures">11. Extended Fetaures</a>
+<ul class="sectlevel2">
+<li><a href="#_array-and-object-destructuring">11.1. Array and Object Destructuring</a>
+<ul class="sectlevel3">
+<li><a href="#_syntax-14">11.1.1. Syntax</a></li>
+<li><a href="#_semantics-12">11.1.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="#_dependency-injection">11.2. Dependency Injection</a>
+<ul class="sectlevel3">
+<li><a href="#_di-components-and-injectors">11.2.1. DI Components and Injectors</a>
+<ul class="sectlevel4">
+<li><a href="#_dicomponent-relations">11.2.1.1. DIComponent Relations</a></li>
+</ul>
+</li>
+<li><a href="#_binders-and-bindings">11.2.2. Binders and Bindings</a></li>
+<li><a href="#_injection-points">11.2.3. Injection Points</a>
+<ul class="sectlevel4">
+<li><a href="#_field-injection">11.2.3.1. Field Injection</a></li>
+<li><a href="#_constructor-injection">11.2.3.2. Constructor Injection</a></li>
+<li><a href="#_method-injection">11.2.3.3. Method Injection</a>
+<ul class="sectlevel5">
+<li><a href="#_provider">11.2.3.3.1. Provider</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#_n4js-di-life-cycle-and-scopes">11.2.4. N4JS DI Life Cycle and Scopes</a>
+<ul class="sectlevel4">
+<li><a href="#_injection-cylces">11.2.4.1. Injection Cylces</a></li>
+<li><a href="#_default-scope">11.2.4.2. Default Scope</a></li>
+<li><a href="#_singleton-scope">11.2.4.3. Singleton Scope</a></li>
+<li><a href="#_per-injection-chain-singleton">11.2.4.4. Per Injection Chain Singleton</a></li>
+</ul>
+</li>
+<li><a href="#_validation-of-callsites-targeting-n4injector-methods">11.2.5. Validation of callsites targeting N4Injector methods</a></li>
+<li><a href="#_n4js-di-annotations">11.2.6. N4JS DI Annotations</a>
+<ul class="sectlevel4">
+<li><a href="#_n4js-di-generateinjector">11.2.6.1. N4JS DI @GenerateInjector</a></li>
+<li><a href="#_n4js-di-withparentinjector">11.2.6.2. N4JS DI @WithParentInjector</a></li>
+<li><a href="#_n4js-di-usebinder">11.2.6.3. N4JS DI @UseBinder</a></li>
+<li><a href="#_n4js-di-binder">11.2.6.4. N4JS DI @Binder</a></li>
+<li><a href="#_n4js-di-bind">11.2.6.5. N4JS DI @Bind</a></li>
+<li><a href="#_n4js-di-provides">11.2.6.6. N4JS DI @Provides</a></li>
+<li><a href="#_n4js-di-inject">11.2.6.7. N4JS DI @Inject</a></li>
+<li><a href="#_n4js-di-singleton">11.2.6.8. N4JS DI @Singleton</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#_test-support">11.3. Test Support</a></li>
+<li><a href="#_polyfill-definitions">11.4. Polyfill Definitions</a>
+<ul class="sectlevel3">
+<li><a href="#_runtime-polyfill-definitions">11.4.1. Runtime Polyfill Definitions</a></li>
+<li><a href="#_static-polyfill-definitions">11.4.2. Static Polyfill Definitions</a></li>
+<li><a href="#_transpiling-static-polyfilled-classes">11.4.3. Transpiling static polyfilled classes</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="components.html#_components">12. Components</a>
+<ul class="sectlevel2">
+<li><a href="components.html#_overview-2">12.1. Overview</a></li>
+<li><a href="components.html#Component_Types">12.2. Component Types</a>
+<ul class="sectlevel3">
+<li><a href="components.html#_libraries">12.2.1. Libraries</a></li>
+<li><a href="components.html#_runtime-environment-and-runtime-libraries">12.2.2. Runtime Environment and Runtime Libraries</a></li>
+<li><a href="components.html#_tests">12.2.3. Tests</a></li>
+<li><a href="components.html#_type-definitions">12.2.4. Type Definitions</a></li>
+</ul>
+</li>
+<li><a href="components.html#package-json">12.3. Package.json File</a>
+<ul class="sectlevel3">
+<li><a href="components.html#_basic-properties">12.3.1. Basic Properties</a></li>
+<li><a href="components.html#_n4js-properties">12.3.2. N4JS Properties</a></li>
+<li><a href="components.html#_constraints">12.3.3. Constraints</a></li>
+</ul>
+</li>
+<li><a href="components.html#_support-for-npm-scopes">12.4. Support for NPM Scopes</a></li>
+<li><a href="components.html#sec:N4JS-Type-Definitions">12.5. N4JS Type Definitions</a>
+<ul class="sectlevel3">
+<li><a href="components.html#_specify-type-definition">12.5.1. Specify Type Definition</a></li>
+<li><a href="components.html#_name-conventions">12.5.2. Name Conventions</a></li>
+<li><a href="components.html#_version-conventions">12.5.3. Version Conventions</a>
+<ul class="sectlevel4">
+<li><a href="components.html#_define-a-new-type-definition-package">12.5.3.1. Define a New Type Definition Package</a></li>
+<li><a href="components.html#_using-a-type-definition-package">12.5.3.2. Using a Type Definition Package</a></li>
+<li><a href="components.html#_rational">12.5.3.3. Rational</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="components.html#_modules">12.6. Modules</a></li>
+<li><a href="components.html#_api-and-implementation-component">12.7. API and Implementation Component</a>
+<ul class="sectlevel3">
+<li><a href="components.html#_execution-of-api-and-implementation-components">12.7.1. Execution of API and Implementation Components</a></li>
+<li><a href="components.html#_api-and-implementation-with-di">12.7.2. API and Implementation With DI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="plainjs.html#_plainjs">13. PlainJS</a>
+<ul class="sectlevel2">
+<li><a href="plainjs.html#_type-inference-and-validation-for-plain-js">13.1. Type Inference and Validation for Plain JS</a></li>
+<li><a href="plainjs.html#_external-declarations">13.2. External Declarations</a>
+<ul class="sectlevel3">
+<li><a href="plainjs.html#_declaring-externals">13.2.1. Declaring externals</a></li>
+<li><a href="plainjs.html#_instantiating-external-classes">13.2.2. Instantiating external classes</a></li>
+<li><a href="plainjs.html#_implementation-of-external-declarations">13.2.3. Implementation of External Declarations</a></li>
+<li><a href="plainjs.html#_example">13.2.4. Example</a></li>
+</ul>
+</li>
+<li><a href="plainjs.html#_global-definitions">13.3. Global Definitions</a></li>
+<li><a href="plainjs.html#_runtime-definitions">13.4. Runtime Definitions</a></li>
+<li><a href="plainjs.html#_applying-polyfills">13.5. Applying Polyfills</a></li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_jsdoc-2">14. JSDoc</a>
+<ul class="sectlevel2">
+<li><a href="jsdoc.html#_general-n4jsdoc-features">14.1. General N4JSDoc Features</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#_provided-inline-tags">14.1.1. Provided Inline Tags</a>
+<ul class="sectlevel4">
+<li><a href="jsdoc.html#jsdoc_tag__code">14.1.1.1. @code</a></li>
+<li><a href="jsdoc.html#jsdoc_tag__link">14.1.1.2. @link</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_n4jsdoc-for-user-projects">14.2. N4JSdoc for User Projects</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#_standard-tags">14.2.1. Standard Tags</a>
+<ul class="sectlevel4">
+<li><a href="jsdoc.html#_-author">14.2.1.1. @author</a></li>
+<li><a href="jsdoc.html#jsdoc_tag_param">14.2.1.2. @param</a></li>
+<li><a href="jsdoc.html#jsdoc_tag_return">14.2.1.3. @return</a></li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_test-related-tags">14.2.2. Test Related Tags</a>
+<ul class="sectlevel4">
+<li><a href="jsdoc.html#jsdoc_tag__testee">14.2.2.1. @testee</a></li>
+<li><a href="jsdoc.html#jsdoc_tag__testeeFromType">14.2.2.2. @testeeFromType</a></li>
+<li><a href="jsdoc.html#_testeeType_and__testeeMember">14.2.2.3. @testeeType and @testeeMember</a></li>
+<li><a href="jsdoc.html#jsdoc_tag_reqid_in_Tests">14.2.2.4. @reqid in Tests</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_n4jsdoc-for-api-and-implementation-projects">14.3. N4JSDoc for API and Implementation Projects</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#jsdoc_tag__apiNote">14.3.1. @apiNote</a></li>
+<li><a href="jsdoc.html#API_Project_Tags">14.3.2. API Project Tags</a>
+<ul class="sectlevel4">
+<li><a href="jsdoc.html#jsdoc_tag_apiState">14.3.2.1. @apiState</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsx.html#_jsx">15. JSX</a>
+<ul class="sectlevel2">
+<li><a href="jsx.html#_jsx-support">15.1. JSX Support</a></li>
+<li><a href="jsx.html#_jsx-backend">15.2. JSX Backend</a></li>
+</ul>
+</li>
+<li><a href="grammars.html#_grammars">16. Grammars</a>
+<ul class="sectlevel2">
+<li><a href="grammars.html#_type-expressions-grammar">16.1. Type Expressions Grammar</a></li>
+<li><a href="grammars.html#_n4js-language-grammar">16.2. N4JS Language Grammar</a></li>
+</ul>
+</li>
+<li><a href="jsobjects.html#_jsobjects">17. JSObjects</a>
+<ul class="sectlevel2">
+<li><a href="jsobjects.html#_object">17.1. Object</a></li>
+<li><a href="jsobjects.html#_string">17.2. String</a></li>
+<li><a href="jsobjects.html#_boolean">17.3. Boolean</a></li>
+<li><a href="jsobjects.html#_number">17.4. Number</a>
+<ul class="sectlevel3">
+<li><a href="jsobjects.html#_static-attributes">17.4.1. Static Attributes</a></li>
+</ul>
+</li>
+<li><a href="jsobjects.html#function">17.5. Function</a></li>
+<li><a href="jsobjects.html#_error">17.6. Error</a></li>
+<li><a href="jsobjects.html#_array">17.7. Array</a></li>
+<li><a href="jsobjects.html#_date">17.8. Date</a></li>
+<li><a href="jsobjects.html#_math">17.9. Math</a>
+<ul class="sectlevel3">
+<li><a href="jsobjects.html#static-attributes-1">17.9.1. Static Attributes</a></li>
+</ul>
+</li>
+<li><a href="jsobjects.html#_regexp">17.10. RegExp</a></li>
+<li><a href="jsobjects.html#_json">17.11. JSON</a></li>
+</ul>
+</li>
+<li><a href="n4js_objects.html#_n4js-objects">18. N4JS Objects</a>
+<ul class="sectlevel2">
+<li><a href="n4js_objects.html#_reflection-model">18.1. Reflection Model</a></li>
+<li><a href="n4js_objects.html#_error-types">18.2. Error Types</a>
+<ul class="sectlevel3">
+<li><a href="n4js_objects.html#_n4apinotimplemented">18.2.1. N4ApiNotImplemented</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_acronyms.html#_acronyms">Appendix A: Acronyms</a></li>
+<li><a href="appendix_b_license.html#sec:License">Appendix B: License</a></li>
+<li><a href="appendix_c_bibliography.html#_bibliography">Appendix C: Bibliography</a></li>
+</ul>
+</div>
+</div>
+<div id="content"><div class="sect1">
+<h2 id="_extended-fetaures"><a class="anchor" href="#_extended-fetaures"></a><a class="link" href="#_extended-fetaures">11. Extended Fetaures</a></h2>
+<div class="sectionbody">
+<div class="sect2 language-n4js">
+<h3 id="_array-and-object-destructuring"><a class="anchor" href="#_array-and-object-destructuring"></a><a class="link" href="#_array-and-object-destructuring">11.1. Array and Object Destructuring</a></h3>
+<div class="paragraph">
+<p>N4JS supports array and object destructuring as provided in ES6.
+This is used to conveniently assign selected elements of an array or object to a number of newly-declared or pre-existing variables or to further destructure them by using nested
+destructuring patterns <sup class="footnote">[<a id="_footnoteref_55" class="footnote" href="appendix_c_bibliography.html#_footnote_55" title="View footnote.">55</a>]</sup>.</p>
+</div>
+<div class="sect3">
+<h4 id="_syntax-14"><a class="anchor" href="#_syntax-14"></a><a class="link" href="#_syntax-14">11.1.1. Syntax</a></h4>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-ebnf" data-lang="ebnf">BindingPattern &lt;Yield&gt;:
+    ObjectBindingPattern&lt;Yield&gt;
+    | ArrayBindingPattern&lt;Yield&gt;
+;
+
+ObjectBindingPattern &lt;Yield&gt; returns BindingPattern:
+    {BindingPattern}
+    '{' (properties+=BindingProperty&lt;Yield,AllowType=false&gt; (',' properties+=BindingProperty&lt;Yield,AllowType=false&gt;)*)? '}'
+;
+
+ArrayBindingPattern &lt;Yield&gt; returns BindingPattern:
+    {BindingPattern}
+    '['
+        elements+=Elision* (
+            elements+=BindingRestElement&lt;Yield&gt;
+            (',' elements+=Elision* elements+=BindingRestElement&lt;Yield&gt;)*
+            (',' elements+=Elision*)?
+        )?
+    ']'
+;
+
+BindingProperty &lt;Yield, AllowType&gt;:
+      =&gt;(LiteralBindingPropertyName&lt;Yield&gt; ':') value=BindingElement&lt;Yield&gt;
+    | value=SingleNameBinding&lt;Yield,AllowType&gt;
+;
+
+fragment LiteralBindingPropertyName &lt;Yield&gt;*:
+    declaredName=IdentifierName | declaredName=STRING | declaredName=NumericLiteralAsString
+    // this is added here due to special treatment for a known set of expressions
+    | '[' (declaredName=SymbolLiteralComputedName&lt;Yield&gt; | declaredName=STRING) ']'
+;</code></pre>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_semantics-12"><a class="anchor" href="#_semantics-12"></a><a class="link" href="#_semantics-12">11.1.2. Semantics</a></h4>
+<div class="paragraph">
+<p>The following example declares four variables <code>a</code>, <code>b</code>, <code>x</code>, and <code>prop2</code>. Variables <code>a</code> and <code>x</code> will have the value <code>hello</code>, whereas <code>b</code> and <code>prop2</code> will have value 42.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">var [a,b] = ["hello", 42];
+
+var {prop1:x, prop2} = {prop1:"hello", prop2:42};</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>In the case of <code>prop2</code>, we do not provide a property name and variable name separately; this is useful in cases where the property name also makes for a
+suitable variable name (called <code>single name binding</code>).</p>
+</div>
+<div class="paragraph">
+<p>One of the most useful use cases of destructuring is in a <code>for..of</code> loop.
+Take this example:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">var arr1 = [ ["hello",1,2,3], ["goodbye",4,5,6] ];
+for(var [head,...tail] of arr1) {
+    console.log(head,'/',tail);
+}
+// will print:
+//   hello / [ 1, 2, 3 ]
+//   goodbye / [ 4, 5, 6 ]
+
+var arr2 = [ {key:"hello", value:42}, {key:"goodbye", value:43} ];
+for(var {key,value} of arr2) {
+    console.log(key,'/',value);
+}
+// will print:
+//   hello / 42
+//   goodbye / 43</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Array and object destructuring pattern can appear in many different places:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>In a variable declaration (not just in variable statements but also in other places where variable declarations are allowed, e.g. plain for loops; called <em>destructuring binding</em>; see <a href="statements.html#_variable-statement">Variable Statement</a>).</p>
+</li>
+<li>
+<p>On the left-hand side of an assignment expression (the assignment expression is then called <em>destructuring assignment</em>; see <a href="expressions.html#_assignment-expression">Assignment Expression</a>).</p>
+</li>
+<li>
+<p>In a <code>for..in</code> or <code>for..of</code> loop on the left side of the <code>in</code>/<code>of</code> (see <a href="statements.html#_for-of-statement"><code>for &#8230;&#8203; of</code> statement</a>).</p>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title=""></i>
+</td>
+<td class="content">
+It can also be used in plain statements, but then we actually have one of the above two use cases.
+</td>
+</tr>
+</table>
+</div>
+</li>
+<li>
+<p>With lists of formal parameters or function arguments (not supported yet).</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>For further details on array and object destructuring please refer to the ECMAScript 6 specification - [<a href="appendix_c_bibliography.html#ECMA15a">ECMA15a</a>].</p>
+</div>
+<div class="paragraph">
+<p>Type annotations can only be added when a new variable name is introduced since the short version would be ambiguous with the long one.
+For example:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">var {x: someTypeOrNewVar} = ol</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>could either mean that a new variable <code>someTypeOrNewVar</code> is declared and <code>ol.x</code> is assigned to it, or that a new variable <code>x</code> is declared with type <code>someTypeOrNewVar</code>.
+The longer form would look like this:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">var {x: x: someType} = ol</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>We can make this more readable:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">var {propOfOl: newVar: typeOfNewVar} = ol</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="_dependency-injection"><a class="anchor" href="#_dependency-injection"></a><a class="link" href="#_dependency-injection">11.2. Dependency Injection</a></h3>
+<div class="paragraph">
+<p>This chapter describes <a href="appendix_a_acronyms.html#_acronyms">DI</a> mechanisms for N4JS.
+This includes compiler, validation and language extensions that allow to achieve DI mechanisms built in into the N4JS language and IDE.</p>
+</div>
+<div class="paragraph">
+<p>N4JS <a href="appendix_a_acronyms.html#_acronyms">DI</a> support specifies a means for obtaining objects in such a way as to maximize reusability, testability and maintainability,
+especially compared to traditional approaches such as constructors, factories and service locators.
+While this can be achieved manually (without tooling support) it is difficult for nontrivial applications.
+The solutions that DI provides should empower N4JS users to achieve the above goals without the burden of maintaining so-called ’boilerplate’ code.</p>
+</div>
+<div id="fig-di-terms" class="imageblock" style="text-align: center">
+<div class="content">
+<img src="chapters/11_extFeatures/fig/diBasicTerms.png" alt="diBasicTerms">
+</div>
+<div class="title">Figure 8. DI Basic Terms</div>
+</div>
+<div class="paragraph">
+<p><em>key: pass the dependency instead of letting the client create or find it</em></p>
+</div>
+<div class="paragraph">
+<p>Core terms</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><strong>Service</strong> - A set of APIs describing the functionality of the service.</p>
+</li>
+<li>
+<p><strong>Service Implementation</strong>s - One or more implementations of given service API.</p>
+</li>
+<li>
+<p><strong>Client</strong> - Consumer of a given functionality, uses the given <strong>Service Implementation</strong>.</p>
+</li>
+<li>
+<p><strong>Injector</strong> - Object providing <strong>Service Implementation</strong> of a specific <strong>Service</strong>, according to configuration.</p>
+</li>
+<li>
+<p><strong>Binding</strong> - Part of configuration describing which interface implementing a subtype will be injected, when a given interface is requested.</p>
+</li>
+<li>
+<p><strong>Provider</strong> - Factory used to create instances of a given <strong>Service Implementation</strong> or its sub-components, can be a method.</p>
+</li>
+<li>
+<p><strong>Injection Point</strong> - Part of the user’s code that will have the given dependency injected. This is usually fields, method parameters, constructor parameters etc.</p>
+</li>
+<li>
+<p><strong>DI configuration</strong> - This describes which elements of the user’s code are used in mechanisms and how they are wired.
+It is derived from user code elements being marked with appropriate annotations, bindings and providers.</p>
+</li>
+<li>
+<p><strong>di wiring</strong> - The code responsible for creating user objects.
+These are injectors, type factories/providers, fields initiators etc.</p>
+</li>
+</ul>
+</div>
+<div class="sect3">
+<h4 id="_di-components-and-injectors"><a class="anchor" href="#_di-components-and-injectors"></a><a class="link" href="#_di-components-and-injectors">11.2.1. DI Components and Injectors</a></h4>
+<div class="paragraph">
+<p>N4JS’ <a href="#_dependency-injection">Dependency Injection</a> systems is based on the notion of <a href="appendix_a_acronyms.html#_acronyms">DIC</a>.</p>
+</div>
+<div class="openblock definition">
+<div class="content">
+<div class="paragraph">
+<p><a id="di_component"></a><strong>Definition:</strong> <a href="#di_component">DI Component</a></p>
+</div>
+<div class="paragraph">
+<p>A <a href="appendix_a_acronyms.html#_acronyms">DIC</a> is a N4Class annotated with <code>@GenerateInjector</code>.</p>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>This annotation causes an <em>injector</em> to be created for (and associated to) the <a href="appendix_a_acronyms.html#_acronyms">DI</a>.
+DIC can be composed; meaning that when requested to inject an instance of a type, a DIC’s injector can delegate this request to the injector of the containing DIC.
+An injector always prioritizes its own configuration before delegating to the container’s injector.
+For validation purposes, a child DI can be annotated with <code>@WithParent</code> to ensure that it is always used with a proper parent.</p>
+</div>
+<div class="paragraph">
+<p><em>Injector</em> is the main object of DI mechanisms responsible for creating object graphs of the application.
+At runtime, injectors are instances of <code>N4Injector</code>.</p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-138"></a><strong>Req. IDE-138:</strong> <a href="#Req-IDE-138">DI Component and Injector</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>The following constraints must hold for a class <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>C</mi></math> marked as DIC:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>A subclass <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>S</mi></math> of <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>C</mi></math> is a DIC as well and it must be marked with <code>GenerateInjector</code>.</p>
+</li>
+<li>
+<p>If a parent <a href="#_dicomponent-relations">DIC</a> <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>P</mi></math> is specified via <code>WithParent</code>, then <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>P</mi></math> must be a DIC as well.</p>
+</li>
+<li>
+<p>The injector associated to a DIC is of type <code>N4Injector</code>. It can be retrieved via <code>N4Injector.of(DIC)</code> in which <code>DIC</code> is the <code>DIC</code>.</p>
+</li>
+<li>
+<p>Injectors associated to DIC a are DI-singletons (cf. <a href="#_singleton-scope">Singleton Scope</a>).
+Two calls to <code>N4Injector.of(DIC)</code> are different (as different DIC are assumed).</p>
+</li>
+</ol>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-139"></a><strong>Req. IDE-139:</strong> <a href="#Req-IDE-139">Injection Phase</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>We call the (transitive) creation and setting of values by an injector <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>I</mi></math> caused by the creation of an root object <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>R</mi></math> the <em>injection phase</em>.
+If an instance <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>C</mi></math> is newly created by the injector <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>I</mi></math> (regardless of the injection point being used), the injection is transitively applied on <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>C</mi></math>.
+The following constraints have to hold:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Root objects are created by one of the following mechanisms:</p>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p>Any class or interface can be created as root objects via an injector associated to a DIC:<br>
+<code>var x: X = N4Injector.of(DIC).create(X);</code><br>
+in which <code>DIC</code> is a DIC.</p>
+<div class="paragraph">
+<p>Of course, an appropriate binding must exist. <sup class="footnote">[<a id="_footnoteref_56" class="footnote" href="appendix_c_bibliography.html#_footnote_56" title="View footnote.">56</a>]</sup></p>
+</div>
+</li>
+<li>
+<p>If a type has the injector being injected, e.g. via field injection <code>@Inject injector: N4Injector;</code>, then this injector can be used anytime in the control flow to create
+a new root object similar as above (using <code>create</code> method).</p>
+</li>
+<li>
+<p>If a provider has been injected (i.e. an instance of <code>{N4Provider}</code>), then its <code>get()</code> method can be used to create a root object causing a new injection phase to take place.</p>
+</li>
+</ol>
+</div>
+</li>
+<li>
+<p>If <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>C</mi><mo>.</mo><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi></math> is marked as injection point, all its arguments are set by the injector.
+This is also true for an inherited constructor marked as an injection point.
+See <a href="#Req-IDE-143">[Req-IDE-143]</a> . For all arguments the injection phase constraints have to hold as well.</p>
+</li>
+<li>
+<p>All fields of <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>C</mi></math>, including <em>inherited</em> once, marked as injection points are set by the injector.
+For all fields the injection phase constraints have to hold as well.</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>The injector may use a provider method (of a binder) to create nested instances.</p>
+</div>
+<div class="paragraph">
+<p>The injector is configured with <em>Binders</em> and it tracks <em>Bindings</em> between types (<a href="#_binders-and-bindings">Binders and Bindings</a>).
+An N4JS developer normally would not interact with this object directly except when defining an entry-point to his application.
+<em>Injector</em>s are configured with <em>Binder</em>s which contain explicit <em>Binding</em>s defined by an N4JS developer.
+A set of these combined with <em>implicit bindings</em> creates the <em>di configuration</em> used by a given injector.
+To configure given <em>Injector</em>s with given <em>Binder</em>(s) use <code>@UseBinder</code> annotation.</p>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_dicomponent-relations"><a class="anchor" href="#_dicomponent-relations"></a><a class="link" href="#_dicomponent-relations">11.2.1.1. DIComponent Relations</a></h5>
+<div class="paragraph">
+<p>A Parent-Child relation can be established between two DIComponents.
+Child DIComponents use the parent bindings but can also be configured with their own bindings or <em>change</em> targets used by a parent.
+The final circumstance is local to the child and is referred to as <em>rebinding</em>.
+For more information about bindings see <a href="#_binders-and-bindings">Binders and Bindings</a>.
+A Child-Parent relation is expressed by the <code>@WithParentInjector</code> annotation attached to a given DIComponent.
+When this relation is defined between DIComponents, the user needs to take care to preserve the proper relation between injectors.
+In other words, the user must provide an instance of the parent injector (the injector of the DIComponent passes as a parameter to <code>@WithParentInjector</code>) when creating the child injector
+(injector of the DIComponent annotated with <code>@WithParentInjector</code>).</p>
+</div>
+<div class="exampleblock">
+<div class="title">Example 98. Simple DIComponents Relation</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">@GenerateInjector
+class ParentDIComponent{}
+
+@GenerateInjector
+@WithParentInjector(ParentDIComponent)
+class ChildDIComponent{}
+
+var parentInejctor = N4Inejctor.of(ParentDiCompoennt);
+var childInjector = N4Inejctor.of(ChildDIComponent, parentInjector);</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>With complex DIComponent structures, injector instances can be created with a directly-declared parent and also with any of its children.
+This is due to the fact that any child can rebind types, add new bindings, but not remove them.
+Any child is, therefore, <em>compatible</em> with its parents.</p>
+</div>
+<div class="openblock definition">
+<div class="content">
+<div class="paragraph">
+<p><a id="compatible_dicomponent"></a><strong>Definition:</strong> <a href="#compatible_dicomponent">Compatible DIComponent</a></p>
+</div>
+<div class="paragraph">
+<p>A given DIComponent is compatible with another DIComponent if it has bindings for all keys in other component bindings.</p>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mo>∃</mo><mi>D</mi><mi>I</mi><mi>C</mi><mn>1</mn><mo>,</mo><mi>D</mi><mi>I</mi><mi>C</mi><mn>2</mn><mi>:</mi><mi>D</mi><mi>I</mi><mi>C</mi><mn>1.</mn><mover accent="true"><mrow><mi>b</mi><mi>i</mi><mi>n</mi><mi>d</mi><mi>i</mi><mi>n</mi><mi>g</mi></mrow><mo>¯</mo></mover><mo>.</mo><mover accent="true"><mrow><mi>k</mi><mi>e</mi><mi>y</mi></mrow><mo>¯</mo></mover><mo>⇒</mo><mi>D</mi><mi>I</mi><mi>C</mi><mn>2.</mn><mover accent="true"><mrow><mi>b</mi><mi>i</mi><mi>n</mi><mi>d</mi><mi>i</mi><mi>n</mi><mi>g</mi></mrow><mo>¯</mo></mover><mo>.</mo><mover accent="true"><mrow><mi>k</mi><mi>e</mi><mi>y</mi></mrow><mo>¯</mo></mover><mo>⇔</mo><mi>D</mi><mi>I</mi><mi>C</mi><mn>2</mn><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>D</mi><mi>I</mi><mi>C</mi><mn>1</mn></math>
+</div>
+</div>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title=""></i>
+</td>
+<td class="content">
+Although subtype notation <math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/></math> is used here it does <strong>not</strong> imply actual subtype relations.
+It was used in this instance for of lack of formal notations for DI concepts and because this is similar to the Liskov Substitution principle.
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>A complex Child-Parent relation between components is depicted in <a href="#fig-complex-dicomponents-relations">Complex DIComponents Relations</a> and <a href="#ex:complex-dicomponents-relations">Complex DIComponents Relations</a> below.</p>
+</div>
+<div id="fig-complex-dicomponents-relations" class="imageblock" style="text-align: center">
+<div class="content">
+<img src="chapters/11_extFeatures/fig/diagDICParentChild.svg" alt="diagDICParentChild">
+</div>
+<div class="title">Figure 9. Complex DIComponents Relations</div>
+</div>
+</div>
+</div>
+<div id="ex:complex-dicomponents-relations" class="exampleblock">
+<div class="title">Example 99. Complex DIComponents Relations</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">@GenerateInjector class A {}
+@GenerateInjector @WithParentInjector(A) class B {}
+@GenerateInjector @WithParentInjector(B) class C {}
+@GenerateInjector @WithParentInjector(C) class D {}
+@GenerateInjector @WithParentInjector(A) class B2 {}
+@GenerateInjector @WithParentInjector(B2) class C2 {}
+@GenerateInjector @WithParentInjector(C2) class D2 {}
+@GenerateInjector @WithParentInjector(A) class X {}
+@GenerateInjector @WithParentInjector(C) class Y {}
+
+// creating injectors
+var injectorA = N4Injector.of(A);
+//following throws DIConfigurationError, expected parent is not provided
+//var injectorB =  N4Injector.of(B);
+//correct declarations
+var injectorB =  N4Injector.of(B, injectorA);
+var injectorC = N4Injector.of(C, injectorB);
+var injectorD = N4Injector.of(D, injectorC);
+var injectorB2 = N4Injector.of(B2, injectorA);
+var injectorC2 = N4Injector.of(C2, injectorB2);
+var injectorD2 = N4Injector.of(D2, injectorC2);
+
+//Any injector of {A,B,C,D,b2,C2,D2} s valid parent for injector of X, e.g. D or D2
+N4Injector.of(X, injectorD);//is ok as compatible parent is provided
+N4Injector.of(X, injectorD2);//is ok as compatible parent is provided
+
+N4Injector.of(Y, injectorC);//is ok as direct parent is provided
+N4Injector.of(Y, injectorD);//is ok as compatible parent is provided
+
+N4Injector.of(Y, injectorB2);//throws DIConfigurationError, incompatible parent is provided
+N4Injector.of(Y, injectorC2);//throws DIConfigurationError, incompatible parent is provided
+N4Injector.of(Y, injectorD2);//throws DIConfigurationError, incompatible parent is provided</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_binders-and-bindings"><a class="anchor" href="#_binders-and-bindings"></a><a class="link" href="#_binders-and-bindings">11.2.2. Binders and Bindings</a></h4>
+<div class="paragraph">
+<p><em>Binder</em> allows an N4JS developer to (explicitly) define a set of <em>Binding</em>s that will be used by an <em>Injector</em> configured with a given <em>Binder</em>.
+There are two ways for <em>Binder</em> to define <em>Binding</em>s: <code>@Bind</code> (<a href="#_n4js-di-bind">N4JS DI @Bind</a>) annotations and a method annotated with <code>@Provides</code>.</p>
+</div>
+<div class="paragraph">
+<p><em>Binder</em> is declared by annotating a class with the <code>@Binder</code> annotation.</p>
+</div>
+<div class="paragraph">
+<p>A <em>Binding</em> is part of a configuration that defines which instance of
+what type should be injected into an <em>injection point</em> (<a href="#_injection-points">Injection Points</a>) with an expected type.</p>
+</div>
+<div class="paragraph">
+<p><em>Provider Method</em> is essentially a <em>factory method</em> that is used to create an instance of a type.
+N4JS allows a developer to declare those methods (see <a href="#_n4js-di-provides">N4JS DI @Provides</a>) which gives them a hook in instance creation process.
+Those methods will be used when creating instances by the <em>Injector</em> configured with the corresponding <em>Binder</em>.
+A provider method is a special kind of binding (<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>k</mi><mi>e</mi><mi>y</mi></math>) in which the return type of the method is the <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>k</mi><mi>e</mi><mi>y</mi></math>.
+The <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>t</mi><mi>a</mi><mi>r</mi><mi>g</mi><mi>e</mi><mi>t</mi></math> type is unknown at compile time (although it may be inferred by examining the return statements of the provide method).</p>
+</div>
+<div class="openblock definition">
+<div class="content">
+<div class="paragraph">
+<p><a id="binding"></a><strong>Definition:</strong> <a href="#binding">Binding</a></p>
+</div>
+<div class="paragraph">
+<p>A <em>binding</em> is a pair <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>b</mi><mi>i</mi><mi>n</mi><mi>d</mi><mfenced close=")" open="("><mrow><mi>k</mi><mi>e</mi><mi>y</mi></mrow><mrow><mi>t</mi><mi>a</mi><mi>r</mi><mi>g</mi><mi>e</mi><mi>t</mi></mrow></mfenced></math>.
+It defines that for a dependency with a given key which usually is the expected type at the injection point.
+An instance of type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>t</mi><mi>a</mi><mi>r</mi><mi>g</mi><mi>e</mi><mi>t</mi></math> is injected.</p>
+</div>
+<div class="paragraph">
+<p>A <em>binding</em> is called <em>explicit</em> if it is declared in the code, i.e. via <code>@Bind</code>
+annotation or <code>@Provides</code> annotation).</p>
+</div>
+<div class="paragraph">
+<p>A <em>binding</em> is called <em>implicit</em> if it is not declared.
+An implicit binding can only be used if the <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>k</mi><mi>e</mi><mi>y</mi></math> is a class and derived from the type at the injection point, i.e. the type of the field or parameter to be injected.
+In that case, the <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>t</mi><mi>a</mi><mi>r</mi><mi>g</mi><mi>e</mi><mi>t</mi></math> equals the <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>k</mi><mi>e</mi><mi>y</mi></math>.</p>
+</div>
+<div class="paragraph">
+<p>A provider method <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>M</mi></math> (in the binder) defines a binding</p>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mi>b</mi><mi>i</mi><mi>n</mi><mi>d</mi><mfenced close=")" open="("><mrow><mi>M</mi><mo>.</mo><mi>r</mi><mi>e</mi><mi>t</mi><mi>u</mi><mi>r</mi><mi>n</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi></mrow><mi>X</mi></mfenced></math>
+</div>
+</div>
+<div class="paragraph">
+<p>(in which <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>X</mi></math> is an existential type with <math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∃</mo><mi>X</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>t</mi><mi>a</mi><mi>r</mi><mi>g</mi><mi>e</mi><mi>t</mi><mo>.</mo><mi>r</mi><mi>e</mi><mi>t</mi><mi>u</mi><mi>r</mi><mi>n</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi></math>).</p>
+</div>
+<div class="paragraph">
+<p>For simplification, we define:</p>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mtable><mtr><mtd><mi>k</mi><mi>e</mi><mi>y</mi><mo>*</mo><mo>=</mo><mfenced close="" open="{"><mtable><mtr><mtd><mi>t</mi><mi>a</mi><mi>r</mi><mi>g</mi><mi>e</mi><mi>t</mi><mo>.</mo><mi>r</mi><mi>e</mi><mi>t</mi><mi>u</mi><mi>r</mi><mi>n</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi><mo>,</mo></mtd><mtd><mstyle mathvariant="bold"><mtext>if target is provider method</mtext></mstyle></mtd></mtr><mtr><mtd><mi>k</mi><mi>e</mi><mi>y</mi><mo>,</mo></mtd><mtd><mstyle mathvariant="bold"><mtext>otherwise (key is a type reference)</mtext></mstyle></mtd></mtr></mtable></mfenced></mtd></mtr></mtable></math>
+</div>
+</div>
+<div class="paragraph">
+<p>and</p>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mtable><mtr><mtd><mi>t</mi><mi>a</mi><mi>r</mi><mi>g</mi><mi>e</mi><mi>t</mi><mo>*</mo><mo>=</mo><mfenced close="" open="{"><mtable><mtr><mtd><mi>X</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>t</mi><mi>a</mi><mi>r</mi><mi>g</mi><mi>e</mi><mi>t</mi><mo>.</mo><mi>r</mi><mi>e</mi><mi>t</mi><mi>u</mi><mi>r</mi><mi>n</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi><mo>,</mo></mtd><mtd><mstyle mathvariant="bold"><mtext>if target is provider method</mtext></mstyle></mtd></mtr><mtr><mtd><mi>t</mi><mi>a</mi><mi>r</mi><mi>g</mi><mi>e</mi><mi>t</mi><mo>,</mo></mtd><mtd><mstyle mathvariant="bold"><mtext>otherwise (target is a type reference)</mtext></mstyle></mtd></mtr></mtable></mfenced></mtd></mtr></mtable></math>
+</div>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-140"></a><strong>Req. IDE-140:</strong> <a href="#Req-IDE-140">Bindings</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>For a given binding <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>b</mi><mo>=</mo><mfenced close=")" open="("><mrow><mi>k</mi><mi>e</mi><mi>y</mi></mrow><mrow><mi>t</mi><mi>a</mi><mi>r</mi><mi>g</mi><mi>e</mi><mi>t</mi></mrow></mfenced></math>, the following constraints must hold: <sup class="footnote">[<a id="_footnoteref_57" class="footnote" href="appendix_c_bibliography.html#_footnote_57" title="View footnote.">57</a>]</sup></p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>k</mi><mi>e</mi><mi>y</mi></math> must be either a class or an interface.</p>
+</li>
+<li>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>t</mi><mi>a</mi><mi>r</mi><mi>g</mi><mi>e</mi><mi>t</mi></math> must either be a class or a provider method.</p>
+</li>
+<li>
+<p>If <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>b</mi></math> is implicit, then <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>k</mi><mi>e</mi><mi>y</mi></math> must be a class.
+If <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>k</mi><mi>e</mi><mi>y</mi></math> references a type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi></math>, then <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>t</mi><mi>a</mi><mi>r</mi><mi>g</mi><mi>e</mi><mi>t</mi><mo>=</mo><mi>T</mi></math> – even if <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>k</mi><mi>e</mi><mi>y</mi></math> is a use-site structural type.</p>
+</li>
+<li>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>k</mi><mi>e</mi><mi>y</mi></math> and <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>t</mi><mi>a</mi><mi>r</mi><mi>g</mi><mi>e</mi><mi>t</mi><mo>*</mo></math> can be nominal, structural or field-structural types, either definition-site or use-site.
+The injector and binder needs to take the different structural reference into account at runtime!</p>
+</li>
+<li>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>t</mi><mi>a</mi><mi>r</mi><mi>g</mi><mi>e</mi><mi>t</mi><mo>*</mo><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>k</mi><mi>e</mi><mi>y</mi></math> must hold</p>
+</li>
+<li>
+<p>If during injection phase no binding for a given key is found, an <code>DIUnsatisfiedBindingError</code> is thrown.</p>
+</li>
+</ol>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-141"></a><strong>Req. IDE-141:</strong> <a href="#Req-IDE-141">Transitive Bindings</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>If an injector contains two given bindings <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>b</mi><mn>1</mn></msub><mo>=</mo><mfenced close=")" open="("><mrow><mi>k</mi><mi>e</mi><msub><mi>y</mi><mn>1</mn></msub></mrow><mrow><mi>t</mi><mi>a</mi><mi>r</mi><mi>g</mi><mi>e</mi><msub><mi>t</mi><mn>1</mn></msub></mrow></mfenced></math> and
+<math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>b</mi><mn>2</mn></msub><mo>=</mo><mfenced close=")" open="("><mrow><mi>k</mi><mi>e</mi><msub><mi>y</mi><mn>2</mn></msub></mrow><mrow><mi>k</mi><mi>e</mi><msub><mi>y</mi><mn>1</mn></msub></mrow></mfenced></math>, an effective binding
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>b</mi><mo>=</mo><mfenced close=")" open="("><mrow><mi>k</mi><mi>e</mi><msub><mi>y</mi><mn>2</mn></msub></mrow><mrow><mi>t</mi><mi>a</mi><mi>r</mi><mi>g</mi><mi>e</mi><msub><mi>t</mi><mn>1</mn></msub></mrow></mfenced></math> is derived (replacing
+<math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>b</mi><mn>1</mn></msub></math>).</p>
+</div>
+<div class="paragraph">
+<p>N4JS <a href="appendix_a_acronyms.html#_acronyms">DI</a> mechanisms don’t allow for injection of primitives or built-in types.
+Only user-defined N4Types can be used. In cases where a user needs to inject a primitive or a built-in type, the developer must wrap it into its own
+class <sup class="footnote">[<a id="_footnoteref_58" class="footnote" href="appendix_c_bibliography.html#_footnote_58" title="View footnote.">58</a>]</sup>.
+This is to say that none of the following metatypes can be bound: primitive types, enumerations, functions, object types, union- or intersection types. It is possible to (implicitly) bind to built-in classes.</p>
+</div>
+<div class="paragraph">
+<p>While direct binding overriding or rebinding is not allowed, <em>Injector</em> can be configured in a way where one type can be separately bound to different types with implicit binding,
+<em>explicit binding</em> and in bindings of the child injectors.
+<em>Binding precedence</em> is a mechanism of <em>Injector</em> selecting a binding use for a type.
+It operates in the following order:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Try to use explicit binding, if this is not available:</p>
+</li>
+<li>
+<p>Try to delegate to parent injectors (order of lookup is not guaranteed, first found is selected). If this is not available then:</p>
+</li>
+<li>
+<p>Try to use use implicit binding, which is simply to attempt to create the instance.</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>If no binding for a requested type is available an error will be thrown.</p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_injection-points"><a class="anchor" href="#_injection-points"></a><a class="link" href="#_injection-points">11.2.3. Injection Points</a></h4>
+<div class="paragraph">
+<p>By <em>injection point</em> we mean a place in the source code which, at runtime, will be expected to hold a reference to a particular type instance.</p>
+</div>
+<div class="sect4">
+<h5 id="_field-injection"><a class="anchor" href="#_field-injection"></a><a class="link" href="#_field-injection">11.2.3.1. Field Injection</a></h5>
+<div class="paragraph">
+<p>In its simplest form, this is a class field annotated with <code>@Inject</code> annotation.
+At runtime, an instance of the containing class will be expected to hold reference to an instance of the field declared type.
+Usually that case
+is called <em>Field Injection</em>.</p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-142"></a><strong>Req. IDE-142:</strong> <a href="#Req-IDE-142">Field Injection</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>The injector will inject the
+following fields:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>All directly contained fields annotated with <code>@Inject</code>.</p>
+</li>
+<li>
+<p>All inherited fields annotated with <code>@Inject</code>.</p>
+</li>
+<li>
+<p>The injected fields will be created by the injector and their fields will be injected as well.</p>
+</li>
+</ol>
+</div>
+</div>
+</div>
+<div class="exampleblock">
+<div class="title">Example 100. Simple Field Injection</div>
+<div class="content">
+<div class="paragraph">
+<p><a href="#ex:field-injection">Simple Field Injection</a> demonstrates simple field injection using default bindings.
+Note that all inherited fields (i.e. <code>A.xInA</code>) are injected and also fields in injected fields (i.e. <code>x.y</code>)</p>
+</div>
+<div id="ex:field-injection" class="listingblock">
+<div class="title">Simple Field Injection</div>
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">class X {
+    @Inject y: Y;
+}
+class Y {}
+
+class A {
+    @Inject xInA: X;
+}
+class B extends A {
+    @Inject xInB: X;
+}
+
+@GenerateInjector
+export public class DIC {
+    @Inject a: B;
+}
+
+var dic = N4Injector.of(DIC).create(DIC);
+console.log(dic);              // --&gt; DIC
+console.log(dic.a);            // --&gt; B
+console.log(dic.a.xInA);       // --&gt; X
+console.log(dic.a.xInA.y);     // --&gt; Y
+console.log(dic.a.xInB);       // --&gt; X
+console.log(dic.a.xInB.y);     // --&gt; Y</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_constructor-injection"><a class="anchor" href="#_constructor-injection"></a><a class="link" href="#_constructor-injection">11.2.3.2. Constructor Injection</a></h5>
+<div class="paragraph">
+<p>Parameters of the constructor can also be injected, in which case this is usually referred to as <em>Constructor Inejction</em>.
+This is similar to <em>Method Injection</em> and while constructor injection is supported in N4JS, method injection is not (see remarks below).</p>
+</div>
+<div class="paragraph">
+<p>When a constructor is annotated with <code>@Inject</code> annotation, all user-defined, non-generic types given as the parameters will be injected into the instance’s constructor created by the dependency injection framework.
+Currently, optional constructor parameters are always initialized and created by the framework, therefore, they are ensured to be available at the constructor invocation time.
+Unlike optional parameters, variadic parameters cannot be injected into a type’s constructor.
+In case of annotating a constructor with <code>@Inject</code> that has variadic parameters, a validation error will be reported.
+When a class’s constructor is annotated with <code>@Inject</code> annotation, it is highly recommended to annotate all explicitly-defined constructors at the subclass level.
+If this is not done, the injection chain can break and runtime errors might occur due to undefined constructor parameters.
+In the case of a possible broken injection chain due to missing <code>@Inject</code> annotations for any subclasses, a validation warning will
+be reported.</p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-143"></a><strong>Req. IDE-143:</strong> <a href="#Req-IDE-143">Constructor Injection</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>If a class <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>C</mi></math> has a constructor marked as injection point, the
+following applies:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>If <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>C</mi></math> is subclassed by <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>S</mi></math>, and if <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>S</mi></math> has no explicit constructor, then <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>S</mi></math> inherits the constructor from <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>C</mi></math> and it will be an injection point handled by the injector during injection phase.</p>
+</li>
+<li>
+<p>If <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>S</mi></math> provides its own injector, <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>C</mi><mo>.</mo><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi></math> is no longer recognized by the injector during the injection phase.
+There will be a warning generated in <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>S</mi><mo>.</mo><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi></math> to mark it as injection point as well in order to prevent inconsistent injection behavior.
+Still, <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>C</mi><mo>.</mo><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi></math> must be called in <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>S</mi><mo>.</mo><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi></math> similarly to other overridden constructors.</p>
+</li>
+</ol>
+</div>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_method-injection"><a class="anchor" href="#_method-injection"></a><a class="link" href="#_method-injection">11.2.3.3. Method Injection</a></h5>
+<div class="paragraph">
+<p>Other kinds of injector points are method parameters where (usually) all method parameters are injected when the method is called.
+In a way, constructor injection is a special case of the method itself.</p>
+</div>
+<div class="sect5">
+<h6 id="_provider"><a class="anchor" href="#_provider"></a><a class="link" href="#_provider">11.2.3.3.1. Provider</a></h6>
+<div class="paragraph">
+<p><em>Provider</em> is essentially a <em>factory</em> for a given type.
+By injecting an <code>N4Provider</code> into any injection point, one can acquire new instances of a given type provided by the injected provider.
+The providers prove useful when one has to solve re-injection issues since the depended type can be wired and injected via the provider rather than the dependency itself and can therefore obtain
+new instances from it if required.
+Provider can be also used as a means of delaying the instantiation time of a given type.</p>
+</div>
+<div class="paragraph">
+<p><code>N4Provider</code> is a public generic built-in interface that is used to support the re-injection.
+The generic type represents the dependent type that has to be obtained.
+The <code>N4Provider</code> interface has one single public method: <code>public T get()</code> which should be invoked from the client code when a new instance of the dependent type is required.
+Unlike any other unbound interfaces, the <code>N4Provider</code> can be injected without any explicit binding.</p>
+</div>
+<div class="paragraph">
+<p>The following snippet demonstrates the usage of <code>N4Provider</code>:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">class SomeService { }
+
+@Singleton
+class SomeSingletonService { }
+
+class SomeClass {
+
+    @Inject serviceProvider: N4Provider&lt;SomeService&gt;;
+    @Inject singletonServiceProvider: N4Provider&lt;SomeSingletonService&gt;;
+
+    void foo() {
+        console.log(serviceProvider.get() ===
+            serviceProvider.get()); //false
+
+        console.log(singletonServiceProvider.get() ===
+            singletonServiceProvider.get()); //true
+    }
+
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>It is important to note that the <code>N4Provider</code> interface can be extended by any user-defined interfaces and/or can be implemented by any user-defined classes.
+For those user-defined providers, consider all binding-related rules; the extended interface, for example, must be explicitly bound via a binder to be injected.
+The binding can be omitted only for the built-in <code>N4Provider</code>s.</p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_n4js-di-life-cycle-and-scopes"><a class="anchor" href="#_n4js-di-life-cycle-and-scopes"></a><a class="link" href="#_n4js-di-life-cycle-and-scopes">11.2.4. N4JS DI Life Cycle and Scopes</a></h4>
+<div class="paragraph">
+<p><a href="appendix_a_acronyms.html#_acronyms">DI</a> Life Cycle defines when a new instance is created by the injector as its destruction is handled by JavaScript.
+The creation depends on the scope of the type.
+Aside from the scopes, note that it is also possible to implement custom scopes and life cycle management via <code>N4JSProvider</code> and <code>Binder@Provides</code> methods.</p>
+</div>
+<div class="sect4">
+<h5 id="_injection-cylces"><a class="anchor" href="#_injection-cylces"></a><a class="link" href="#_injection-cylces">11.2.4.1. Injection Cylces</a></h5>
+<div class="openblock definition">
+<div class="content">
+<div class="paragraph">
+<p><a id="injection_cycle"></a><strong>Definition:</strong> <a href="#injection_cycle">Injection Cycle</a></p>
+</div>
+<div class="paragraph">
+<p>We define an injection graph <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>G</mi><mfenced close=")" open="("><mi>V</mi><mi>E</mi></mfenced></math> as a directed graph as follows: <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>V</mi></math> (the vertices) is the set types of which instances are created during the injection phase and which use .
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>E</mi></math> (the edges) is a set of directed and labeled edges <math xmlns="http://www.w3.org/1998/Math/MathML"><mfenced close=")" open="("><msub><mi>v</mi><mn>1</mn></msub><msub><mi>v</mi><mn>2</mn></msub><mrow><mi>l</mi><mi>a</mi><mi>b</mi><mi>e</mi><mi>l</mi></mrow></mfenced></math>, where label indicates the injection point:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mfenced close=")" open="("><msub><mi>T</mi><mi>o</mi></msub><msub><mi>T</mi><mi>f</mi></msub><mrow><mi>"</mi><mi>f</mi><mi>i</mi><mi>e</mi><mi>l</mi><mi>d</mi><mi>"</mi></mrow></mfenced></math>, if <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>T</mi><mi>f</mi></msub></math> is the actualy type of an an injected field of an instance of type <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>T</mi><mi>o</mi></msub></math></p>
+</li>
+<li>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mfenced close=")" open="("><msub><mi>T</mi><mi>c</mi></msub><msub><mi>T</mi><mi>p</mi></msub><mrow><mi>"</mi><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi><mi>"</mi></mrow></mfenced></math>, if <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>T</mi><mi>p</mi></msub></math> is the type of a parameter used in a constructor injection of type <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>T</mi><mi>c</mi></msub></math></p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>One cycle in this graph is an injection cycle.</p>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>When injecting instances into an object, cycles have to be detected and handled independently from the scope.
+If this is not done, the following examples would result in an infinite loop causing the entire script to freeze until the engine reports an error:</p>
+</div>
+<table class="tableblock frame-none grid-rows spread">
+<colgroup>
+<col style="width: 57.1428%;">
+<col style="width: 42.8572%;">
+</colgroup>
+<tbody>
+<tr>
+<td class="tableblock halign-left valign-bottom"><div><div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">class A { @Inject b: B; }
+class B { @Inject a: A; }</code></pre>
+</div>
+</div></div></td>
+<td class="tableblock halign-center valign-top"><div><div id="fig-field-cycle" class="imageblock" style="text-align: center">
+<div class="content">
+<img src="chapters/11_extFeatures/fig/injectionGraph_cycleField.svg" alt="injectionGraph cycleField">
+</div>
+<div class="title">Figure 10. Field Cycle</div>
+</div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-bottom"><div><div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">class C { @Inject constructor(d: D) {} }
+class D { @Inject c: C; }</code></pre>
+</div>
+</div></div></td>
+<td class="tableblock halign-center valign-top"><div><div id="fig-ctor-field" class="imageblock" style="text-align: center">
+<div class="content">
+<img src="chapters/11_extFeatures/fig/injectionGraph_cycleCtorField.svg" alt="injectionGraph cycleCtorField">
+</div>
+<div class="title">Figure 10. Ctor Field Cycle</div>
+</div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-bottom"><div><div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">class E { @Inject constructor(f: F) {} }
+class F { @Inject constructor(e: E) {} }</code></pre>
+</div>
+</div></div></td>
+<td class="tableblock halign-center valign-top"><div><div id="fig-ctor-cycle" class="imageblock" style="text-align: center">
+<div class="content">
+<img src="chapters/11_extFeatures/fig/injectionGraph_cycleCtor.svg" alt="injectionGraph cycleCtor">
+</div>
+<div class="title">Figure 10. Ctor Cycle</div>
+</div></div></td>
+</tr>
+</tbody>
+</table>
+<div class="paragraph">
+<p>The injector needs to detect these cycles and resolve them.</p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-144"></a><strong>Req. IDE-144:</strong> <a href="#Req-IDE-144">Resolution of Injection Cycles</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>A cycle <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>c</mi><mo>⊂</mo><mi>G</mi></math>, with <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>G</mi></math> being an injection graph, is resolved as follows:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>If <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>c</mi></math> contains no edge with <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>l</mi><mi>a</mi><mi>b</mi><mi>e</mi><mi>l</mi><mo>=</mo><mi>"</mi><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi><mi>"</mi></math>, the cycle is resolved using the algorithm described below.</p>
+</li>
+<li>
+<p>If <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>c</mi></math> contains at least one edge with <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>l</mi><mi>a</mi><mi>b</mi><mi>e</mi><mi>l</mi><mo>=</mo><mi>"</mi><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi><mi>"</mi></math>, a runtime exception is thrown.</p>
+</li>
+</ol>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Cycles stemming from field injection are resolved by halting the creation of new instances of types which have been already created by a containing instance.
+The previously-created instance is then reused.
+This makes injecting the instance of a (transitive) container less complicated and without the need to pass the container instance down the entire chain.
+The following pseudo code describes the algorithm to create new instances which are injected into a newly created object:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">function injectDependencies(object) {
+    doInjectionWithCylceAwareness(object, {(typeof object -&gt; object)})
+}
+
+function doInjectionWithCylceAwareness(object, createdInstancesPerType) {
+    forall v $\in$ injectedVars of object {
+        var type = retrieveBoundType(v)
+        var instance = createdInstancesPerType.get(type)
+        if (not exists instance) {
+            instance = createInstance(type, createdInstancesPerType)
+            doInjectionWithCylceAwareness(instance,
+                createdInstancesPerType $\cap$ {(type-&gt;instance)})
+        }
+        v.value = instance;
+    }
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>The actual instance is created in line 10 via <code>createInstance</code>.
+This function then takes scopes into account.
+The <code>createdInstancesPerType</code> map is passed to that function in order to enable cycle detection for constructor injection.
+The following scopes are supported by the N4JS DI, other scopes, cf. <a href="https://jersey.java.net/documentation/latest/ioc.html">Jersey custom scopes</a> and <a href="https://github.com/google/guice/wiki/CustomScopes">Guice custom scopes</a>, may be added in the future.</p>
+</div>
+<div class="paragraph">
+<p>This algorithm is not working for constructor injection because it is possible to already access all fields of the arguments passed to the constructor.
+In the algorithm, however, the instances may not be completely initialized.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_default-scope"><a class="anchor" href="#_default-scope"></a><a class="link" href="#_default-scope">11.2.4.2. Default Scope</a></h5>
+<div class="paragraph">
+<p>The default scope always creates a new instance.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_singleton-scope"><a class="anchor" href="#_singleton-scope"></a><a class="link" href="#_singleton-scope">11.2.4.3. Singleton Scope</a></h5>
+<div class="paragraph">
+<p>The singleton scope (per injector) creates one instance (of the type with <code>@Singleton</code> scope) per injector, which is then shared between clients.</p>
+</div>
+<div class="paragraph">
+<p>The injector will preserve a single instance of the type of <code>S</code> and will provide it to all injection points where type of <code>S</code> is used.
+Assuming nested injectors without any declared binding where the second parameter is <code>S</code>, the same preserved singleton instance will be available for all nested injectors at all injection points as well.</p>
+</div>
+<div class="paragraph">
+<p>The singleton preservation behavior changes when explicit bindings are declared for type <code>S</code> on the nested injector level.
+Let&#8217;s assume that the type <code>S</code> exists and the type is annotated with <code>@Singleton</code>.
+Furthermore, there is a declared binding where the binding&#8217;s second argument is <code>S</code>.
+In that case, unlike in other dependency injection frameworks, nested injectors may preserve a singleton for itself and all descendant injectors with <code>@Bind</code> annotation.
+In this case, the preserved singleton at the child injector level will be a different instance than the one at the parent injectors.</p>
+</div>
+<div class="paragraph">
+<p>The tables below depict the expected runtime behavior of singletons used at different injector levels.
+Assume the following are injectors: <code>C</code>, <code>D</code>, <code>E</code>, <code>F</code> and <code>G</code>. Injector <code>C</code> is the top most injector and its nesting injector <code>D</code>, hence injector <code>C</code> is the parent of the injector <code>D</code>.
+Injector <code>D</code> is nesting <code>E</code> and so on.
+The most nested injector is <code>G</code>. Let&#8217;s assume <code>J</code> is an interface, class <code>U</code> implements interface <code>J</code> and class <code>V</code> extends class <code>U</code>.
+Finally assume both <code>U</code> and <code>V</code> are annotated with <code>@Singleton</code> at definition-site.</p>
+</div>
+<div class="paragraph">
+<p><a href="#tab:diNoBindings">DI No Bindings</a> depicts the singleton preservation for nested injectors without any bindings.
+All injectors use the same instance from a type.
+Type <code>J</code> is not available at all since it is not bound to any concrete implementation:</p>
+</div>
+<table id="tab:diNoBindings" class="tableblock frame-all grid-all spread">
+<caption class="title">Table 12. DI No Bindings</caption>
+<colgroup>
+<col style="width: 28.5714%;">
+<col style="width: 14.2857%;">
+<col style="width: 14.2857%;">
+<col style="width: 14.2857%;">
+<col style="width: 14.2857%;">
+<col style="width: 14.2858%;">
+</colgroup>
+<tbody>
+<tr>
+<th class="tableblock halign-center valign-top"><p class="tableblock">Binding</p></th>
+<td class="tableblock halign-center valign-top"></td>
+<td class="tableblock halign-center valign-top"></td>
+<td class="tableblock halign-center valign-top"></td>
+<td class="tableblock halign-center valign-top"></td>
+<td class="tableblock halign-center valign-top"></td>
+</tr>
+<tr>
+<th class="tableblock halign-center valign-top"><p class="tableblock">Injector nesting (<math xmlns="http://www.w3.org/1998/Math/MathML"><mo>&gt;</mo></math>)</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock">C</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">D</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">E</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">F</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">G</p></td>
+</tr>
+<tr>
+<th class="tableblock halign-center valign-top"><p class="tableblock">J</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>N</mi><mi>a</mi><mi>N</mi></math></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>N</mi><mi>a</mi><mi>N</mi></math></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>N</mi><mi>a</mi><mi>N</mi></math></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>N</mi><mi>a</mi><mi>N</mi></math></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>N</mi><mi>a</mi><mi>N</mi></math></p></td>
+</tr>
+<tr>
+<th class="tableblock halign-center valign-top"><p class="tableblock">U</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>U</mi><mn>0</mn></msub></math></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>U</mi><mn>0</mn></msub></math></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>U</mi><mn>0</mn></msub></math></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>U</mi><mn>0</mn></msub></math></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>U</mi><mn>0</mn></msub></math></p></td>
+</tr>
+<tr>
+<th class="tableblock halign-center valign-top"><p class="tableblock">V</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>V</mi><mn>0</mn></msub></math></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>V</mi><mn>0</mn></msub></math></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>V</mi><mn>0</mn></msub></math></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>V</mi><mn>0</mn></msub></math></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>V</mi><mn>0</mn></msub></math></p></td>
+</tr>
+</tbody>
+</table>
+<div class="paragraph">
+<p><a href="#tab:diTransitiveBindings">DI Transitive Bindings</a> is configured by explicit bindings. At the root injector level, type <code>J</code> is bound to type <code>U</code>.
+Since the second argument of the binding is declared as a singleton at the definition-site,
+this explicit binding implicitly ensures that the injector and all of its descendants preserve a singleton of the bound type <code>U</code>.
+At injector level <code>C</code>, <code>D</code> and <code>E</code>, the same instance is used for type <code>J</code> which is type <code>U</code> at runtime.
+At injector level <code>E</code> there is an additional binding from type <code>U</code> to type <code>V</code> that overrules the binding declared at the root injector level.
+With this binding, each places where <code>J</code> is declared, type <code>U</code> is used at runtime.</p>
+</div>
+<div class="paragraph">
+<p>Furthermore, since <code>V</code> is declared as a singleton, both injector <code>F</code> and <code>G</code> are using a shared singleton instance of type <code>V</code>.
+Finally, for type <code>V</code>, injector <code>C</code>, <code>D</code> and <code>E</code> should use a separate instance of <code>V</code> other than injector level <code>F</code> and <code>G</code> because <code>V</code> is preserved at injector level <code>F</code> with the <code>U</code> <math xmlns="http://www.w3.org/1998/Math/MathML"><mo>→</mo></math> <code>V</code> binding.</p>
+</div>
+<table id="tab:diTransitiveBindings" class="tableblock frame-all grid-all spread">
+<caption class="title">Table 13. DI Transitive Bindings</caption>
+<colgroup>
+<col style="width: 28.5714%;">
+<col style="width: 14.2857%;">
+<col style="width: 14.2857%;">
+<col style="width: 14.2857%;">
+<col style="width: 14.2857%;">
+<col style="width: 14.2858%;">
+</colgroup>
+<thead>
+<tr>
+<th class="tableblock halign-center valign-top">Binding</th>
+<th class="tableblock halign-center valign-top">J &#8594; U</th>
+<th class="tableblock halign-center valign-top"></th>
+<th class="tableblock halign-center valign-top"></th>
+<th class="tableblock halign-center valign-top">U &#8594; V</th>
+<th class="tableblock halign-center valign-top"></th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<th class="tableblock halign-center valign-top"><p class="tableblock">Injector nesting (&gt;)</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock">C</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">D</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">E</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">F</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">G</p></td>
+</tr>
+<tr>
+<th class="tableblock halign-center valign-top"><p class="tableblock">J</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>U</mi><mn>0</mn></msub></math></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>U</mi><mn>0</mn></msub></math></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>U</mi><mn>0</mn></msub></math></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>V</mi><mn>0</mn></msub></math></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>V</mi><mn>0</mn></msub></math></p></td>
+</tr>
+<tr>
+<th class="tableblock halign-center valign-top"><p class="tableblock">U</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>U</mi><mn>0</mn></msub></math></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>U</mi><mn>0</mn></msub></math></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>U</mi><mn>0</mn></msub></math></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>V</mi><mn>0</mn></msub></math></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>V</mi><mn>0</mn></msub></math></p></td>
+</tr>
+<tr>
+<th class="tableblock halign-center valign-top"><p class="tableblock">V</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>V</mi><mn>1</mn></msub></math></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>V</mi><mn>1</mn></msub></math></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>V</mi><mn>1</mn></msub></math></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>V</mi><mn>0</mn></msub></math></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>V</mi><mn>0</mn></msub></math></p></td>
+</tr>
+</tbody>
+</table>
+<div class="paragraph">
+<p><a href="#tab:diReBinding">DI Re - Binding</a> depicts the singleton behaviour but unlike the above
+table, the bindings are declared for the interface <code>J</code>.</p>
+</div>
+<table id="tab:diReBinding" class="tableblock frame-all grid-all spread">
+<caption class="title">Table 14. DI Re - Binding</caption>
+<colgroup>
+<col style="width: 28.5714%;">
+<col style="width: 14.2857%;">
+<col style="width: 14.2857%;">
+<col style="width: 14.2857%;">
+<col style="width: 14.2857%;">
+<col style="width: 14.2858%;">
+</colgroup>
+<thead>
+<tr>
+<th class="tableblock halign-center valign-top">Binding</th>
+<th class="tableblock halign-center valign-top">J &#8594; U</th>
+<th class="tableblock halign-center valign-top"></th>
+<th class="tableblock halign-center valign-top"></th>
+<th class="tableblock halign-center valign-top">J &#8594; V</th>
+<th class="tableblock halign-center valign-top"></th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<th class="tableblock halign-center valign-top"><p class="tableblock">Injector nesting (<math xmlns="http://www.w3.org/1998/Math/MathML"><mo>&gt;</mo></math>)</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock">C</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">D</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">E</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">F</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">G</p></td>
+</tr>
+<tr>
+<th class="tableblock halign-center valign-top"><p class="tableblock">J</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>U</mi><mn>0</mn></msub></math></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>U</mi><mn>0</mn></msub></math></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>U</mi><mn>0</mn></msub></math></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>V</mi><mn>0</mn></msub></math></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>V</mi><mn>0</mn></msub></math></p></td>
+</tr>
+<tr>
+<th class="tableblock halign-center valign-top"><p class="tableblock">U</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>U</mi><mn>0</mn></msub></math></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>U</mi><mn>0</mn></msub></math></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>U</mi><mn>0</mn></msub></math></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>U</mi><mn>0</mn></msub></math></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>U</mi><mn>0</mn></msub></math></p></td>
+</tr>
+<tr>
+<th class="tableblock halign-center valign-top"><p class="tableblock">V</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>V</mi><mn>1</mn></msub></math></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>V</mi><mn>1</mn></msub></math></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>V</mi><mn>1</mn></msub></math></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>V</mi><mn>0</mn></msub></math></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>V</mi><mn>0</mn></msub></math></p></td>
+</tr>
+</tbody>
+</table>
+<div class="paragraph">
+<p><a href="#tab:diChildBinding">DI Child Binding</a> describes the singleton behavior when both bindings are configured at child injector levels but not the root injector level.</p>
+</div>
+<table id="tab:diChildBinding" class="tableblock frame-all grid-all spread">
+<caption class="title">Table 15. DI Child Binding</caption>
+<colgroup>
+<col style="width: 28.5714%;">
+<col style="width: 14.2857%;">
+<col style="width: 14.2857%;">
+<col style="width: 14.2857%;">
+<col style="width: 14.2857%;">
+<col style="width: 14.2858%;">
+</colgroup>
+<thead>
+<tr>
+<th class="tableblock halign-center valign-top">Binding</th>
+<th class="tableblock halign-center valign-top"></th>
+<th class="tableblock halign-center valign-top">U <math xmlns="http://www.w3.org/1998/Math/MathML"><mo>→</mo></math> V</th>
+<th class="tableblock halign-center valign-top"></th>
+<th class="tableblock halign-center valign-top">J <math xmlns="http://www.w3.org/1998/Math/MathML"><mo>→</mo></math> U</th>
+<th class="tableblock halign-center valign-top"></th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<th class="tableblock halign-center valign-top"><p class="tableblock">Injector nesting (<math xmlns="http://www.w3.org/1998/Math/MathML"><mo>&gt;</mo></math>)</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock">C</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">D</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">E</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">F</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">G</p></td>
+</tr>
+<tr>
+<th class="tableblock halign-center valign-top"><p class="tableblock">J</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>N</mi><mi>a</mi><mi>N</mi></math></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>N</mi><mi>a</mi><mi>N</mi></math></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>N</mi><mi>a</mi><mi>N</mi></math></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>U</mi><mn>0</mn></msub></math></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>U</mi><mn>0</mn></msub></math></p></td>
+</tr>
+<tr>
+<th class="tableblock halign-center valign-top"><p class="tableblock">U</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>U</mi><mn>1</mn></msub></math></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>V</mi><mn>0</mn></msub></math></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>V</mi><mn>0</mn></msub></math></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>U</mi><mn>0</mn></msub></math></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>U</mi><mn>0</mn></msub></math></p></td>
+</tr>
+<tr>
+<th class="tableblock halign-center valign-top"><p class="tableblock">V</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>V</mi><mn>1</mn></msub></math></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>V</mi><mn>0</mn></msub></math></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>V</mi><mn>0</mn></msub></math></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>V</mi><mn>0</mn></msub></math></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>V</mi><mn>0</mn></msub></math></p></td>
+</tr>
+</tbody>
+</table>
+</div>
+<div class="sect4">
+<h5 id="_per-injection-chain-singleton"><a class="anchor" href="#_per-injection-chain-singleton"></a><a class="link" href="#_per-injection-chain-singleton">11.2.4.4. Per Injection Chain Singleton</a></h5>
+<div class="paragraph">
+<p>The per injection chain singleton is ’between’ the default and singleton scope.
+It can be used in order to explicitly describe the situation which happens when a simple cycle is resolved automatically.
+It has more effects that lead to a more deterministic behavior.</p>
+</div>
+<div class="paragraph">
+<p>Assume a provider declared as</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">var pb: Provider&lt;B&gt;;</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>to be available:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">@PerInjectionSingleton
+class A {  }
+
+class B { @Inject a: A; @Inject a1: A;}
+
+b1=pb.get();
+b2=pb.get();
+b1.a != b2.a
+b1.a == b1.a1
+b2.a == b2.a1</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">@Singleton
+class A {  }
+
+class B { @Inject a: A; @Inject a1: A;}
+
+b1=pb.get();
+b2=pb.get();
+b1.a == b2.a
+b1.a == b1.a1
+b2.a == b2.a1</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">// no annotation
+class A {  }
+
+class B { @Inject a A; @Inject a1: A;}
+
+b1=pb.get();
+b2=pb.get();
+b1.a != b2.a
+b1.a != b1.a1
+b2.a != b2.a1</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_validation-of-callsites-targeting-n4injector-methods"><a class="anchor" href="#_validation-of-callsites-targeting-n4injector-methods"></a><a class="link" href="#_validation-of-callsites-targeting-n4injector-methods">11.2.5. Validation of callsites targeting N4Injector methods</a></h4>
+<div class="paragraph">
+<p>Terminology for this section:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>a value is <strong>injectable</strong> if it</p>
+<div class="ulist">
+<ul>
+<li>
+<p>either conforms to a user-defined class or interface (a non-parameterized one, that is),</p>
+</li>
+<li>
+<p>or conforms to Provider-of-T where T is injectable itself.</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>a classifier declaring injected members is said to <strong>require injection</strong></p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>To better understand the validations in effect for callsites targeting</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">N4Injector.of(ctorOfDIC: constructor{N4Object}, parentDIC: N4Injector?, ...providedBinders: N4Object)</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>we can recap that at runtime:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>The first argument denotes a DIC constructor.</p>
+</li>
+<li>
+<p>The second (optional) argument is an injector.</p>
+</li>
+<li>
+<p>Lastly, the purpose of <code>providedBinders</code> is as follows:</p>
+<div class="ulist">
+<ul>
+<li>
+<p>The DIC above is marked with one or more <code>@UseBinder</code>.</p>
+</li>
+<li>
+<p>Some of those binders may require injection.</p>
+</li>
+<li>
+<p>Some of those binders may have constructor(s) taking parameters.</p>
+</li>
+<li>
+<p>The set of binders described above should match the providedBinders.</p>
+</li>
+</ul>
+</div>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Validations in effect for <code>N4Injector.create(type{T} ctor)</code> callsites:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>type{T}</code> should be injectable (in particular, it may be an <code>N4Provider</code>).</p>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_n4js-di-annotations"><a class="anchor" href="#_n4js-di-annotations"></a><a class="link" href="#_n4js-di-annotations">11.2.6. N4JS DI Annotations</a></h4>
+<div class="paragraph">
+<p>Following annotations describe API used to configure N4JSDI.</p>
+</div>
+<div class="sect4">
+<h5 id="_n4js-di-generateinjector"><a class="anchor" href="#_n4js-di-generateinjector"></a><a class="link" href="#_n4js-di-generateinjector">11.2.6.1. N4JS DI @GenerateInjector</a></h5>
+<table class="tableblock frame-none grid-none spread">
+<colgroup>
+<col style="width: 33.3333%;">
+<col style="width: 33.3333%;">
+<col style="width: 33.3334%;">
+</colgroup>
+<tbody>
+<tr>
+<td class="tableblock halign-left valign-top"><div><div class="dlist">
+<dl>
+<dt class="hdlist1">name</dt>
+<dd>
+<p>@GenerateInjector</p>
+</dd>
+</dl>
+</div></div></td>
+<td class="tableblock halign-left valign-top"><div><div class="dlist">
+<dl>
+<dt class="hdlist1">targets</dt>
+<dd>
+<p>N4Class</p>
+</dd>
+</dl>
+</div></div></td>
+<td class="tableblock halign-left valign-top"><div><div class="dlist">
+<dl>
+<dt class="hdlist1">retention policy</dt>
+<dd>
+<p>RUNTIME</p>
+</dd>
+</dl>
+</div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><div><div class="dlist">
+<dl>
+<dt class="hdlist1">transitive</dt>
+<dd>
+<p>NO</p>
+</dd>
+</dl>
+</div></div></td>
+<td class="tableblock halign-left valign-top"><div><div class="dlist">
+<dl>
+<dt class="hdlist1">repeatable</dt>
+<dd>
+<p>NO</p>
+</dd>
+</dl>
+</div></div></td>
+<td class="tableblock halign-left valign-top"><div><div class="dlist">
+<dl>
+<dt class="hdlist1">arguments</dt>
+<dd>
+<p>NO</p>
+</dd>
+</dl>
+</div></div></td>
+</tr>
+</tbody>
+</table>
+<div class="paragraph">
+<p><code>@GenerateInjector</code> marks a given class as DIComponent of the graph.
+The generated injector will be responsible for creating an instance of that class and all of its dependencies.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_n4js-di-withparentinjector"><a class="anchor" href="#_n4js-di-withparentinjector"></a><a class="link" href="#_n4js-di-withparentinjector">11.2.6.2. N4JS DI @WithParentInjector</a></h5>
+<table class="tableblock frame-none grid-none spread">
+<colgroup>
+<col style="width: 33.3333%;">
+<col style="width: 33.3333%;">
+<col style="width: 33.3334%;">
+</colgroup>
+<tbody>
+<tr>
+<td class="tableblock halign-left valign-top"><div><div class="dlist">
+<dl>
+<dt class="hdlist1">name</dt>
+<dd>
+<p>@WithParentInjector</p>
+</dd>
+</dl>
+</div></div></td>
+<td class="tableblock halign-left valign-top"><div><div class="dlist">
+<dl>
+<dt class="hdlist1">targets</dt>
+<dd>
+<p>N4Class</p>
+</dd>
+</dl>
+</div></div></td>
+<td class="tableblock halign-left valign-top"><div><div class="dlist">
+<dl>
+<dt class="hdlist1">retention policy</dt>
+<dd>
+<p>RUNTIME</p>
+</dd>
+</dl>
+</div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><div><div class="dlist">
+<dl>
+<dt class="hdlist1">transitive</dt>
+<dd>
+<p>NO</p>
+</dd>
+</dl>
+</div></div></td>
+<td class="tableblock halign-left valign-top"><div><div class="dlist">
+<dl>
+<dt class="hdlist1">repeatable</dt>
+<dd>
+<p>NO</p>
+</dd>
+</dl>
+</div></div></td>
+<td class="tableblock halign-left valign-top"><div><div class="dlist">
+<dl>
+<dt class="hdlist1">arguments</dt>
+<dd>
+<p>TypeRef</p>
+</dd>
+</dl>
+</div></div></td>
+</tr>
+</tbody>
+</table>
+<div class="paragraph">
+<p><code>@WithParentInjector</code> marks given <em>injector</em> as depended on other <em>injector</em>.
+The depended <em>injector</em> may use provided <em>injector</em> to create instances of objects required in its object graph.</p>
+</div>
+<div class="paragraph">
+<p>Additional <em>WithParentInjector</em> constraints:</p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-145"></a><strong>Req. IDE-145:</strong> <a href="#Req-IDE-145">DI WithParentInjector</a> (ver. 1)</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Allowed only on <code>N4ClassDeclarations</code> annotated with <code>@GenerateInjector</code>.</p>
+</li>
+<li>
+<p>Its parameter can only be <code>N4ClassDeclarations</code> annotated with .</p>
+</li>
+</ol>
+</div>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_n4js-di-usebinder"><a class="anchor" href="#_n4js-di-usebinder"></a><a class="link" href="#_n4js-di-usebinder">11.2.6.3. N4JS DI @UseBinder</a></h5>
+<table class="tableblock frame-none grid-none spread">
+<colgroup>
+<col style="width: 33.3333%;">
+<col style="width: 33.3333%;">
+<col style="width: 33.3334%;">
+</colgroup>
+<tbody>
+<tr>
+<td class="tableblock halign-left valign-top"><div><div class="dlist">
+<dl>
+<dt class="hdlist1">name</dt>
+<dd>
+<p>@UseBinder</p>
+</dd>
+</dl>
+</div></div></td>
+<td class="tableblock halign-left valign-top"><div><div class="dlist">
+<dl>
+<dt class="hdlist1">targets</dt>
+<dd>
+<p>N4Class</p>
+</dd>
+</dl>
+</div></div></td>
+<td class="tableblock halign-left valign-top"><div><div class="dlist">
+<dl>
+<dt class="hdlist1">retention policy</dt>
+<dd>
+<p>RUNTIME</p>
+</dd>
+</dl>
+</div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><div><div class="dlist">
+<dl>
+<dt class="hdlist1">transitive</dt>
+<dd>
+<p>NO</p>
+</dd>
+</dl>
+</div></div></td>
+<td class="tableblock halign-left valign-top"><div><div class="dlist">
+<dl>
+<dt class="hdlist1">arguments</dt>
+<dd>
+<p>TypeRef</p>
+</dd>
+</dl>
+</div></div></td>
+<td class="tableblock halign-left valign-top"><div><div class="dlist">
+<dl>
+<dt class="hdlist1">arguments are optional</dt>
+<dd>
+<p>NO</p>
+</dd>
+</dl>
+</div></div></td>
+</tr>
+</tbody>
+</table>
+<div class="paragraph">
+<p><code>@UseBinder</code> describes <em>Binder</em> to be used (configure) target <em>Injector</em>.</p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-146"></a><strong>Req. IDE-146:</strong> <a href="#Req-IDE-146">DI UseInjector</a> (ver. 1)</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Allowed only on <code>N4ClassDeclarations</code> annotated with <code>@GenerateInjector</code>.</p>
+</li>
+<li>
+<p>Its parameter can only be <code>N4ClassDeclarations</code> annotated with <code>@Binder</code>.</p>
+</li>
+</ol>
+</div>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_n4js-di-binder"><a class="anchor" href="#_n4js-di-binder"></a><a class="link" href="#_n4js-di-binder">11.2.6.4. N4JS DI @Binder</a></h5>
+<table class="tableblock frame-none grid-none spread">
+<colgroup>
+<col style="width: 33.3333%;">
+<col style="width: 33.3333%;">
+<col style="width: 33.3334%;">
+</colgroup>
+<tbody>
+<tr>
+<td class="tableblock halign-left valign-top"><div><div class="dlist">
+<dl>
+<dt class="hdlist1">name</dt>
+<dd>
+<p>@Binder</p>
+</dd>
+</dl>
+</div></div></td>
+<td class="tableblock halign-left valign-top"><div><div class="dlist">
+<dl>
+<dt class="hdlist1">targets</dt>
+<dd>
+<p>N4Class</p>
+</dd>
+</dl>
+</div></div></td>
+<td class="tableblock halign-left valign-top"><div><div class="dlist">
+<dl>
+<dt class="hdlist1">retention policy</dt>
+<dd>
+<p>RUNTIME</p>
+</dd>
+</dl>
+</div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><div><div class="dlist">
+<dl>
+<dt class="hdlist1">transitive</dt>
+<dd>
+<p>NO</p>
+</dd>
+</dl>
+</div></div></td>
+<td class="tableblock halign-left valign-top"><div><div class="dlist">
+<dl>
+<dt class="hdlist1">repeatable</dt>
+<dd>
+<p>NO</p>
+</dd>
+</dl>
+</div></div></td>
+<td class="tableblock halign-left valign-top"><div><div class="dlist">
+<dl>
+<dt class="hdlist1">arguments</dt>
+<dd>
+<p>NONE</p>
+</dd>
+</dl>
+</div></div></td>
+</tr>
+</tbody>
+</table>
+<div class="paragraph">
+<p><code>@Binder</code> defines a list of bind configurations.
+That can be either <code>@Bind</code> annotations on <code>@Binder</code> itself or its factory methods annotated with <code>@Provides</code>.</p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-147"></a><strong>Req. IDE-147:</strong> <a href="#Req-IDE-147">DI binder</a> (ver. 1)</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Target <code>N4ClassDeclaration</code> must not be <em>abstract</em>.</p>
+</li>
+<li>
+<p>Target <code>N4ClassDeclaration</code>  must not be annotated with <code>@GenerateInjector</code>.</p>
+</li>
+<li>
+<p>Target class cannot have <em>injection points</em>.</p>
+</li>
+</ol>
+</div>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_n4js-di-bind"><a class="anchor" href="#_n4js-di-bind"></a><a class="link" href="#_n4js-di-bind">11.2.6.5. N4JS DI @Bind</a></h5>
+<table class="tableblock frame-none grid-none spread">
+<colgroup>
+<col style="width: 33.3333%;">
+<col style="width: 33.3333%;">
+<col style="width: 33.3334%;">
+</colgroup>
+<tbody>
+<tr>
+<td class="tableblock halign-left valign-top"><div><div class="dlist">
+<dl>
+<dt class="hdlist1">name</dt>
+<dd>
+<p>@Bind</p>
+</dd>
+</dl>
+</div></div></td>
+<td class="tableblock halign-left valign-top"><div><div class="dlist">
+<dl>
+<dt class="hdlist1">targets</dt>
+<dd>
+<p>N4ClassDeclaration</p>
+</dd>
+</dl>
+</div></div></td>
+<td class="tableblock halign-left valign-top"><div><div class="dlist">
+<dl>
+<dt class="hdlist1">retention policy</dt>
+<dd>
+<p>RUNTIME</p>
+</dd>
+</dl>
+</div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><div><div class="dlist">
+<dl>
+<dt class="hdlist1">transitive</dt>
+<dd>
+<p>NO</p>
+</dd>
+</dl>
+</div></div></td>
+<td class="tableblock halign-left valign-top"><div><div class="dlist">
+<dl>
+<dt class="hdlist1">arguments</dt>
+<dd>
+<p>TypeRef key, TypeRef target</p>
+</dd>
+</dl>
+</div></div></td>
+<td class="tableblock halign-left valign-top"><div><div class="dlist">
+<dl>
+<dt class="hdlist1">arguments are optional</dt>
+<dd>
+<p>NO</p>
+</dd>
+</dl>
+</div></div></td>
+</tr>
+</tbody>
+</table>
+<div class="paragraph">
+<p>Defines <em>binding</em> between type and subtype that will be used by injector when configured with target <a href="#_n4js-di-binder">N4JS DI @Binder</a>.
+See also <a href="#_validation-of-callsites-targeting-n4injector-methods">Validation of callsites targeting N4Injector methods</a> for description of injectable types.</p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-148"></a><strong>Req. IDE-148:</strong> <a href="#Req-IDE-148">DI Bind</a> (ver. 1)</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Allowed only on <code>N4ClassDeclarations</code> that are annotated with <code>@Binder</code>(<a href="#_n4js-di-binder">N4JS DI @Binder</a>).</p>
+</li>
+<li>
+<p>Parameters are instances of one of the values described in <a href="#_validation-of-callsites-targeting-n4injector-methods">Validation of callsites targeting N4Injector methods</a>.</p>
+</li>
+<li>
+<p>The second parameter must be a subtype of the first one.</p>
+</li>
+</ol>
+</div>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_n4js-di-provides"><a class="anchor" href="#_n4js-di-provides"></a><a class="link" href="#_n4js-di-provides">11.2.6.6. N4JS DI @Provides</a></h5>
+<table class="tableblock frame-none grid-none spread">
+<colgroup>
+<col style="width: 33.3333%;">
+<col style="width: 33.3333%;">
+<col style="width: 33.3334%;">
+</colgroup>
+<tbody>
+<tr>
+<td class="tableblock halign-left valign-top"><div><div class="dlist">
+<dl>
+<dt class="hdlist1">name</dt>
+<dd>
+<p>@Provides</p>
+</dd>
+</dl>
+</div></div></td>
+<td class="tableblock halign-left valign-top"><div><div class="dlist">
+<dl>
+<dt class="hdlist1">targets</dt>
+<dd>
+<p>N4MethodDeclaration</p>
+</dd>
+</dl>
+</div></div></td>
+<td class="tableblock halign-left valign-top"><div><div class="dlist">
+<dl>
+<dt class="hdlist1">retention policy</dt>
+<dd>
+<p>RUNTIME</p>
+</dd>
+</dl>
+</div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><div><div class="dlist">
+<dl>
+<dt class="hdlist1">transitive</dt>
+<dd>
+<p>NO</p>
+</dd>
+</dl>
+</div></div></td>
+<td class="tableblock halign-left valign-top"><div><div class="dlist">
+<dl>
+<dt class="hdlist1">repeatable</dt>
+<dd>
+<p>NO</p>
+</dd>
+</dl>
+</div></div></td>
+<td class="tableblock halign-left valign-top"><div><div class="dlist">
+<dl>
+<dt class="hdlist1">arguments</dt>
+<dd>
+<p>NONE</p>
+</dd>
+</dl>
+</div></div></td>
+</tr>
+</tbody>
+</table>
+<div class="paragraph">
+<p><code>@Provides</code> marks <em>factory method</em> to be used as part <a href="appendix_a_acronyms.html#AC">DI</a>.
+This is treated as <em>explicit binding</em> between declared return type and actual return type.
+This method is expected to be part of the <code>@Binder</code>.
+Can be used to implement custom scopes.</p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-149"></a><strong>Req. IDE-149:</strong> <a href="#Req-IDE-149">DI Provides</a> (ver. 1)</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Allowed only on <code>N4MethodDeclarations</code> that are part of a classifier annotated with <code>@Binder</code>.</p>
+</li>
+<li>
+<p>Annotated method declared type returns instance of one of the types described in <em>injectable values</em>  <a href="#_validation-of-callsites-targeting-n4injector-methods">Validation of callsites targeting N4Injector methods</a>.</p>
+</li>
+</ol>
+</div>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_n4js-di-inject"><a class="anchor" href="#_n4js-di-inject"></a><a class="link" href="#_n4js-di-inject">11.2.6.7. N4JS DI @Inject</a></h5>
+<table class="tableblock frame-none grid-none spread">
+<colgroup>
+<col style="width: 33.3333%;">
+<col style="width: 33.3333%;">
+<col style="width: 33.3334%;">
+</colgroup>
+<tbody>
+<tr>
+<td class="tableblock halign-left valign-top"><div><div class="dlist">
+<dl>
+<dt class="hdlist1">name</dt>
+<dd>
+<p>@Inject</p>
+</dd>
+</dl>
+</div></div></td>
+<td class="tableblock halign-left valign-top"><div><div class="dlist">
+<dl>
+<dt class="hdlist1">targets</dt>
+<dd>
+<p>N4Field, N4Method, constructor</p>
+</dd>
+</dl>
+</div></div></td>
+<td class="tableblock halign-left valign-top"><div><div class="dlist">
+<dl>
+<dt class="hdlist1">retention policy</dt>
+<dd>
+<p>RUNTIME</p>
+</dd>
+</dl>
+</div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><div><div class="dlist">
+<dl>
+<dt class="hdlist1">transitive</dt>
+<dd>
+<p>NO</p>
+</dd>
+</dl>
+</div></div></td>
+<td class="tableblock halign-left valign-top"><div><div class="dlist">
+<dl>
+<dt class="hdlist1">repeatable</dt>
+<dd>
+<p>NO</p>
+</dd>
+</dl>
+</div></div></td>
+<td class="tableblock halign-left valign-top"><div><div class="dlist">
+<dl>
+<dt class="hdlist1">arguments</dt>
+<dd>
+<p>NO</p>
+</dd>
+</dl>
+</div></div></td>
+</tr>
+</tbody>
+</table>
+<div class="paragraph">
+<p><code>@Inject</code> defines the injection point into which an instance object will be injected.
+The specific instance depends on the injector configuration (bindings) used.
+Class fields, methods and constructors can be annotated. See <a href="#_injection-points">Injection Points</a> for more information.</p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-150"></a><strong>Req. IDE-150:</strong> <a href="#Req-IDE-150">DI Inject</a> (ver. 1)</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Injection point bindings need to be resolvable.</p>
+</li>
+<li>
+<p>Binding for given type must not be duplicated.</p>
+</li>
+<li>
+<p>Annotated types must be instances of one of the types described in <a href="#_validation-of-callsites-targeting-n4injector-methods">Validation of callsites targeting N4Injector methods</a>.</p>
+</li>
+</ol>
+</div>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_n4js-di-singleton"><a class="anchor" href="#_n4js-di-singleton"></a><a class="link" href="#_n4js-di-singleton">11.2.6.8. N4JS DI @Singleton</a></h5>
+<table class="tableblock frame-none grid-none spread">
+<colgroup>
+<col style="width: 33.3333%;">
+<col style="width: 33.3333%;">
+<col style="width: 33.3334%;">
+</colgroup>
+<tbody>
+<tr>
+<td class="tableblock halign-left valign-top"><div><div class="dlist">
+<dl>
+<dt class="hdlist1">name</dt>
+<dd>
+<p>@Singleton</p>
+</dd>
+</dl>
+</div></div></td>
+<td class="tableblock halign-left valign-top"><div><div class="dlist">
+<dl>
+<dt class="hdlist1">targets</dt>
+<dd>
+<p>N4Class</p>
+</dd>
+</dl>
+</div></div></td>
+<td class="tableblock halign-left valign-top"><div><div class="dlist">
+<dl>
+<dt class="hdlist1">retention policy</dt>
+<dd>
+<p>RUNTIME</p>
+</dd>
+</dl>
+</div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><div><div class="dlist">
+<dl>
+<dt class="hdlist1">transitive</dt>
+<dd>
+<p>NO</p>
+</dd>
+</dl>
+</div></div></td>
+<td class="tableblock halign-left valign-top"><div><div class="dlist">
+<dl>
+<dt class="hdlist1">repeatable</dt>
+<dd>
+<p>NO</p>
+</dd>
+</dl>
+</div></div></td>
+<td class="tableblock halign-left valign-top"><div><div class="dlist">
+<dl>
+<dt class="hdlist1">arguments</dt>
+<dd>
+<p>NO</p>
+</dd>
+</dl>
+</div></div></td>
+</tr>
+</tbody>
+</table>
+<div class="paragraph">
+<p>In the case of annotating a class <code>S</code> with <code>@Singleton</code> on the definition-site, the singleton scope will be used as described in <a href="#_singleton-scope">Singleton Scope</a>.</p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="_test-support"><a class="anchor" href="#_test-support"></a><a class="link" href="#_test-support">11.3. Test Support</a></h3>
+<div class="paragraph">
+<p>N4JS provides some annotations for testing. Most of these annotations are similar to annotations found in JUnit 4.
+For details see our Mangelhaft test framework (stdlib specification) and the N4JS-IDE specification.</p>
+</div>
+<div class="paragraph">
+<p>In order to enable tests for private methods, test projects may define which project they are testing.</p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-151"></a><strong>Req. IDE-151:</strong> <a href="#Req-IDE-151">Test API methods and types</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>In some cases, types or methods are only provided for testing purposes.
+In order to improve usability, e.g. content assist, these types and methods can be annotated with <code>@TestAPI</code>.
+There are no constraints defined for that annotation at the moment.</p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="_polyfill-definitions"><a class="anchor" href="#_polyfill-definitions"></a><a class="link" href="#_polyfill-definitions">11.4. Polyfill Definitions</a></h3>
+<div class="paragraph">
+<p>In plain JavaScript, so called <em>polyfill</em> (or sometimes called <em>shim</em>) libraries are provided in order to modify existing classes which are only prototypes in plain JavaScript.
+In N4JS, this can be defined for declarations via the annotation <code>@Polyfill</code> or <code>@StaticPolyfill</code>.
+One of these annotations can be added to class declarations which do not look that much different from normal classes.
+In the case of polyfill classes, the extended class is modified (or filled) instead of being subclassed. It is therefore valid to polyfill a class even if it is declared <code>@Final</code>.</p>
+</div>
+<div class="paragraph">
+<p>We distinguish two flavours of polyfill classes: runtime and static.</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Runtime polyfilling covers type enrichment for runtime libraries.
+For type modifications the annotation <code>@Polyfill</code> is used.</p>
+</li>
+<li>
+<p>Static polyfilling covers code modifications for adapting generated code.
+The annotation <code>@StaticPolyfill</code> denotes a polyfill in ordinary code, which usually provides executable implementations.</p>
+</li>
+</ul>
+</div>
+<div class="openblock definition">
+<div class="content">
+<div class="paragraph">
+<p><a id="polyfill_class"></a><strong>Definition:</strong> <a href="#polyfill_class">Polyfill Class</a></p>
+</div>
+<div class="paragraph">
+<p>A <em>polyfill class</em> (or simply <em>polyfill</em>) is
+a class modifying an existing one. The polyfill is not a new class (or type) on its own.
+Instead, new members defined in the polyfill are added to the modified class and existing members can be modified similarly to overriding.
+We call the modified class the <em>filled</em> class and the modification <em>filling</em>.</p>
+</div>
+<div class="paragraph">
+<p>We add a new pseudo property <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>p</mi><mi>o</mi><mi>l</mi><mi>y</mi><mi>f</mi><mi>i</mi><mi>l</mi><mi>l</mi></math> to classes in order to distinguish between normal (sub-) classes and polyfill classes.</p>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-152"></a><strong>Req. IDE-152:</strong> <a href="#Req-IDE-152">Polyfill Class</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>For a polyfill class <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>P</mi></math> annotated with <code>@Polyfill</code> or  <code>@StaticPolyfill</code>, that is <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>P</mi><mo>.</mo><mi>p</mi><mi>o</mi><mi>l</mi><mi>y</mi><mi>f</mi><mi>i</mi><mi>l</mi><mi>l</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>true</mtext></mstyle></math>, all the following constraints must hold:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>P</mi></math> must extend a class <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>F</mi></math>, <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>F</mi></math> is called the filled class:</p>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mi>P</mi><mo>.</mo><mi>s</mi><mi>u</mi><mi>p</mi><mi>e</mi><mi>r</mi><mo>=</mo><mi>F</mi></math>
+</div>
+</div>
+</li>
+<li>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>P</mi></math>’s name equals the name of the filled class and is contained in a module with same qualified name (specifier or global):<br></p>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mtable><mtr><mtd><mspace width="3.0mm"/><mi>P</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><mi>F</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi></mtd></mtr><mtr><mtd><mspace width="3.0mm"/><mo>∧</mo><mi>P</mi><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>t</mi><mi>a</mi><mi>i</mi><mi>n</mi><mi>e</mi><mi>d</mi><mi>M</mi><mi>o</mi><mi>d</mi><mi>u</mi><mi>l</mi><mi>e</mi><mo>.</mo><mi>g</mi><mi>l</mi><mi>o</mi><mi>b</mi><mi>a</mi><mi>l</mi><mo>=</mo><mi>F</mi><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>t</mi><mi>a</mi><mi>i</mi><mi>n</mi><mi>e</mi><mi>d</mi><mi>M</mi><mi>o</mi><mi>d</mi><mi>u</mi><mi>l</mi><mi>e</mi><mo>.</mo><mi>g</mi><mi>l</mi><mi>o</mi><mi>b</mi><mi>a</mi><mi>l</mi></mtd></mtr><mtr><mtd><mspace width="3.0mm"/><mo>∧</mo><mrow><mo>(</mo><mi>P</mi><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>t</mi><mi>a</mi><mi>i</mi><mi>n</mi><mi>e</mi><mi>d</mi><mi>M</mi><mi>o</mi><mi>d</mi><mi>u</mi><mi>l</mi><mi>e</mi><mo>.</mo><mi>g</mi><mi>l</mi><mi>o</mi><mi>b</mi><mi>a</mi><mi>l</mi></mrow></mtd></mtr><mtr><mtd><mrow><mspace width="3.0mm"/><mspace width="3.0em"/><mo>∨</mo><mi>P</mi><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>t</mi><mi>a</mi><mi>i</mi><mi>n</mi><mi>e</mi><mi>d</mi><mi>M</mi><mi>o</mi><mi>d</mi><mi>u</mi><mi>l</mi><mi>e</mi><mo>.</mo><mi>s</mi><mi>p</mi><mi>e</mi><mi>c</mi><mi>i</mi><mi>f</mi><mi>i</mi><mi>e</mi><mi>r</mi><mo>=</mo><mi>F</mi><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>t</mi><mi>a</mi><mi>i</mi><mi>n</mi><mi>e</mi><mi>d</mi><mi>M</mi><mi>o</mi><mi>d</mi><mi>u</mi><mi>l</mi><mi>e</mi><mo>.</mo><mi>s</mi><mi>p</mi><mi>e</mi><mi>c</mi><mi>i</mi><mi>f</mi><mi>i</mi><mi>e</mi><mi>r</mi><mo>)</mo></mrow></mtd></mtr></mtable></math>
+</div>
+</div>
+</li>
+<li>
+<p>Both the polyfill and filled class must be top-level declarations (i.e., no class expression):<br></p>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mi>P</mi><mo>.</mo><mi>t</mi><mi>o</mi><mi>p</mi><mi>L</mi><mi>e</mi><mi>v</mi><mi>e</mi><mi>l</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>true</mtext></mstyle><mo>∧</mo><mi>F</mi><mo>.</mo><mi>t</mi><mi>o</mi><mi>p</mi><mi>L</mi><mi>e</mi><mi>v</mi><mi>e</mi><mi>l</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>true</mtext></mstyle></math>
+</div>
+</div>
+</li>
+<li>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>P</mi></math> must not implement any interfaces:</p>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mi>P</mi><mo>.</mo><mi>i</mi><mi>m</mi><mi>p</mi><mi>l</mi><mi>e</mi><mi>m</mi><mi>e</mi><mi>n</mi><mi>t</mi><mi>e</mi><mi>d</mi><mi>I</mi><mi>n</mi><mi>t</mi><mi>e</mi><mi>r</mi><mi>f</mi><mi>a</mi><mi>c</mi><mi>e</mi><mi>s</mi><mo>=</mo><mi>∅</mi></math>
+</div>
+</div>
+</li>
+<li>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>P</mi></math> must have the same access modifier (access, abstract, final) as the filled class:<br></p>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mtable><mtr><mtd><mi>P</mi><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mi>e</mi><mi>s</mi><mi>s</mi><mi>M</mi><mi>o</mi><mi>d</mi><mi>i</mi><mi>f</mi><mi>i</mi><mi>e</mi><mi>r</mi><mo>=</mo><mi>F</mi><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mi>e</mi><mi>s</mi><mi>s</mi><mi>M</mi><mi>o</mi><mi>d</mi><mi>i</mi><mi>f</mi><mi>i</mi><mi>e</mi><mi>r</mi></mtd></mtr><mtr><mtd><mi>P</mi><mo>.</mo><mi>a</mi><mi>b</mi><mi>s</mi><mi>t</mi><mi>r</mi><mi>a</mi><mi>c</mi><mi>t</mi><mo>=</mo><mi>F</mi><mo>.</mo><mi>a</mi><mi>b</mi><mi>s</mi><mi>t</mi><mi>r</mi><mi>a</mi><mi>c</mi><mi>t</mi></mtd></mtr><mtr><mtd><mi>P</mi><mo>.</mo><mi>f</mi><mi>i</mi><mi>n</mi><mi>a</mi><mi>l</mi><mo>=</mo><mi>F</mi><mo>.</mo><mi>f</mi><mi>i</mi><mi>n</mi><mi>a</mi><mi>l</mi></mtd></mtr></mtable></math>
+</div>
+</div>
+</li>
+<li>
+<p>If <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>P</mi></math> declares a constructor, it must be override compatible with the constructor of the filled class:</p>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mo>∃</mo><mi>P</mi><mo>.</mo><mi>o</mi><mi>w</mi><mi>n</mi><mi>e</mi><mi>d</mi><mi>C</mi><mi>t</mi><mi>o</mi><mi>r</mi><mi>:</mi><mi>P</mi><mo>.</mo><mi>o</mi><mi>w</mi><mi>n</mi><mi>e</mi><mi>d</mi><mi>C</mi><mi>t</mi><mi>o</mi><mi>r</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>F</mi><mo>.</mo><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi></math>
+</div>
+</div>
+</li>
+<li>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>P</mi></math> must define the same type variables as the filled class <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>F</mi></math> and the arguments must be in the same order as the parameters (with no further modifications):</p>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mtable><mtr><mtd><mo>∀</mo><mi>i</mi><mo>,</mo><mn>0</mn><mo>≤</mo><mi>i</mi><mo>&lt;</mo><mo>|</mo><mi>P</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>P</mi><mi>a</mi><mi>r</mi><mi>s</mi><mo>|</mo><mi>:</mi></mtd></mtr><mtr><mtd><mspace width="3.0em"/><mi>P</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>P</mi><mi>a</mi><mi>r</mi><msub><mi>s</mi><mi>i</mi></msub><mo>=</mo><mi>F</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>P</mi><mi>a</mi><mi>r</mi><msub><mi>s</mi><mi>i</mi></msub></mtd></mtr><mtr><mtd><mspace width="3.0em"/><mo>∧</mo><mi>P</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>P</mi><mi>a</mi><mi>r</mi><msub><mi>s</mi><mi>i</mi></msub><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><mi>P</mi><mo>.</mo><mi>s</mi><mi>u</mi><mi>p</mi><mi>e</mi><mi>r</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>A</mi><mi>r</mi><mi>g</mi><msub><mi>s</mi><mi>i</mi></msub><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi></mtd></mtr></mtable></math>
+</div>
+</div>
+</li>
+<li>
+<p>All constraints related to member redefinition (cf. <a href="classifiers.html#_redefinition-of-members">Redefinition of Members</a>) have to hold.
+In the case of polyfills, this is true for constructors (cf. <a href="classifiers.html#Req-IDE-72">[Req-IDE-72]</a>) and private members.</p>
+</li>
+</ol>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_runtime-polyfill-definitions"><a class="anchor" href="#_runtime-polyfill-definitions"></a><a class="link" href="#_runtime-polyfill-definitions">11.4.1. Runtime Polyfill Definitions</a></h4>
+<div class="paragraph">
+<p>(Runtime) Libraries often do not provide completely new types but modify existing types.
+The ECMA-402 Internationalization Standard [<a href="appendix_c_bibliography.html#ECMA12a">ECMA12a</a>], for example, changes methods of the built-in class <code>Date</code> to be timezone aware.
+Other scenarios include new functionality provided by browsers which are not part of an official standard yet.
+Even ECMAScript 6 [<a href="appendix_c_bibliography.html#ECMA15a">ECMA15a</a>] extends the predecessor [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a</a>]  in terms of new methods (or new method parameters) added to existing types (it also adds completely new classes and features, of course).</p>
+</div>
+<div class="paragraph">
+<p>Runtime polyfills are only applicable to runtime libraries or environments and thus are limited to n4jsd files.</p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-153"></a><strong>Req. IDE-153:</strong> <a href="#Req-IDE-153">Runtime Polyfill Class</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>For a runtime-polyfill class <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>P</mi></math> annotated with <code>@Polyfill</code>, that is <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>P</mi><mo>.</mo><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>c</mi><mi>p</mi><mi>o</mi><mi>l</mi><mi>y</mi><mi>f</mi><mi>i</mi><mi>l</mi><mi>l</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>false</mtext></mstyle></math>, all the following constraints must hold in addition to <a href="#Req-IDE-152">[Req-IDE-152]</a>:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Both the polyfill and filled class are provided by the runtime
+(annotated with <code>@ProvidedByRuntime</code>): <sup class="footnote">[<a id="_footnoteref_59" class="footnote" href="appendix_c_bibliography.html#_footnote_59" title="View footnote.">59</a>]</sup></p>
+</li>
+</ol>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mi>P</mi><mo>.</mo><mi>p</mi><mi>r</mi><mi>o</mi><mi>v</mi><mi>i</mi><mi>d</mi><mi>e</mi><mi>d</mi><mi>B</mi><mi>y</mi><mi>R</mi><mi>u</mi><mi>n</mi><mi>t</mi><mi>i</mi><mi>m</mi><mi>e</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>true</mtext></mstyle><mo>∧</mo><mi>F</mi><mo>.</mo><mi>p</mi><mi>r</mi><mi>o</mi><mi>v</mi><mi>i</mi><mi>d</mi><mi>e</mi><mi>d</mi><mi>B</mi><mi>y</mi><mi>R</mi><mi>u</mi><mi>n</mi><mi>t</mi><mi>i</mi><mi>m</mi><mi>e</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>true</mtext></mstyle></math>
+</div>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-154"></a><strong>Req. IDE-154:</strong> <a href="#Req-IDE-154">Applying Polyfills</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>A polyfill is automatically applied if a runtime library or environment required by the current project provides it. In this case, the following constraints must hold:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>No member must be filled by more than one polyfill.</p>
+</li>
+</ol>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_static-polyfill-definitions"><a class="anchor" href="#_static-polyfill-definitions"></a><a class="link" href="#_static-polyfill-definitions">11.4.2. Static Polyfill Definitions</a></h4>
+<div class="paragraph">
+<p>Static polyfilling is a compile time feature to enrich the definition and usually also the implementation of generated code in N4JS. It is related to runtime polyfilling described in <a href="#_runtime-polyfill-definitions">Runtime Polyfill Definitions</a> in a sense that both fillings enrich the types they address. Despite this, static polyfilling and runtime polyfilling differ in the way they are handled.</p>
+</div>
+<div class="paragraph">
+<p>Static polyfills usually provide executable implementations and are thus usually found in n4js files. However, they are allowed in n4jsd files, as well, for example to enrich generated code in an API project.</p>
+</div>
+<div class="paragraph">
+<p>The motivation for static polyfills is to support automatic code generation.
+In many cases, automatically generated code is missing some information to make it sufficiently usable in the desired environment.
+Manual enhancements usually need to be applied.
+If we think of a toolchain, the question may arise how to preserve the manual work when a
+regeneration is triggered. Static polyfilling allows the separation of generated code and manual adjustments in separate files.
+The transpiler merges the two files into a single transpiled file.
+To enable this behaviour, the statically fillable types must be contained in a module annotated with <code>@StaticPolyfillAware</code>.
+The filling types must also be annotated with <code>@StaticPolyfill</code> and be contained in a different module with same specifier but annotated with <code>@StaticPolyfillModule</code>.
+Static polyfilling is restricted to a project, thus the module to be filled as well as the filling module must be contained in the same project.</p>
+</div>
+<div class="paragraph">
+<p>We add a new pseudo property <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>c</mi><mi>P</mi><mi>o</mi><mi>l</mi><mi>y</mi><mi>f</mi><mi>i</mi><mi>l</mi><mi>l</mi></math> to classes in order to distinguish between normal (sub-) classes and static polyfill classes.
+We add two new pseudo properties to modules in order to modify the transpilation process.
+The mutually-exclusive properties <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>c</mi><mi>P</mi><mi>o</mi><mi>l</mi><mi>y</mi><mi>f</mi><mi>i</mi><mi>l</mi><mi>l</mi><mi>A</mi><mi>w</mi><mi>a</mi><mi>r</mi><mi>e</mi></math> and <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>c</mi><mi>P</mi><mi>o</mi><mi>l</mi><mi>y</mi><mi>f</mi><mi>i</mi><mi>l</mi><mi>l</mi></math> signal the way these files are processed.</p>
+</div>
+<div class="paragraph">
+<p>In order to support efficient transpilation, the following constraint must hold in addition to constraints:</p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-155"></a><strong>Req. IDE-155:</strong> <a href="#Req-IDE-155">Static Polyfill Layout</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>For a static polyfill class <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>P</mi></math> annotated with <code>@StaticPolyfill</code>, that is <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>P</mi><mo>.</mo><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>c</mi><mi>p</mi><mi>o</mi><mi>l</mi><mi>y</mi><mi>f</mi><mi>i</mi><mi>l</mi><mi>l</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>true</mtext></mstyle></math>, all the following constraints must hold in addition to <a href="#Req-IDE-152">[Req-IDE-152]</a>:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>P</mi></math>’s name equals the name of the filled class and is contained in a module with the same qualified name:</p>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mtable><mtr><mtd><mi>P</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><mi>F</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi></mtd></mtr><mtr><mtd><mo>∧</mo><mi>P</mi><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>t</mi><mi>a</mi><mi>i</mi><mi>n</mi><mi>e</mi><mi>d</mi><mi>M</mi><mi>o</mi><mi>d</mi><mi>u</mi><mi>l</mi><mi>e</mi><mo>.</mo><mi>s</mi><mi>p</mi><mi>e</mi><mi>c</mi><mi>i</mi><mi>f</mi><mi>i</mi><mi>e</mi><mi>r</mi><mo>=</mo><mi>F</mi><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>t</mi><mi>a</mi><mi>i</mi><mi>n</mi><mi>e</mi><mi>d</mi><mi>M</mi><mi>o</mi><mi>d</mi><mi>u</mi><mi>l</mi><mi>e</mi><mo>.</mo><mi>s</mi><mi>p</mi><mi>e</mi><mi>c</mi><mi>i</mi><mi>f</mi><mi>i</mi><mi>e</mi><mi>r</mi></mtd></mtr></mtable></math>
+</div>
+</div>
+</li>
+<li>
+<p>Both the static polyfill and the filled class are part of the same project:</p>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mi>P</mi><mo>.</mo><mi>p</mi><mi>r</mi><mi>o</mi><mi>j</mi><mi>e</mi><mi>c</mi><mi>t</mi><mo>=</mo><mi>F</mi><mo>.</mo><mi>p</mi><mi>r</mi><mi>o</mi><mi>j</mi><mi>e</mi><mi>c</mi><mi>t</mi></math>
+</div>
+</div>
+</li>
+<li>
+<p>The filled class must be contained in a module annotated with <code>@StaticPolyfillAware</code>:</p>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mi>F</mi><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>t</mi><mi>a</mi><mi>i</mi><mi>n</mi><mi>e</mi><mi>d</mi><mi>M</mi><mi>o</mi><mi>d</mi><mi>u</mi><mi>l</mi><mi>e</mi><mo>.</mo><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>c</mi><mi>P</mi><mi>o</mi><mi>l</mi><mi>y</mi><mi>f</mi><mi>i</mi><mi>l</mi><mi>l</mi><mi>A</mi><mi>w</mi><mi>a</mi><mi>r</mi><mi>e</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>true</mtext></mstyle></math>
+</div>
+</div>
+</li>
+<li>
+<p>The static polyfill and the filled type must both be declared in an n4js file or both in an n4jsd file.</p>
+</li>
+<li>
+<p>The filling class must be contained in a module annotated with <code>@StaticPolyfillModule</code>:</p>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mi>P</mi><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>t</mi><mi>a</mi><mi>i</mi><mi>n</mi><mi>e</mi><mi>d</mi><mi>M</mi><mi>o</mi><mi>d</mi><mi>u</mi><mi>l</mi><mi>e</mi><mo>.</mo><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>c</mi><mi>P</mi><mi>o</mi><mi>l</mi><mi>y</mi><mi>f</mi><mi>i</mi><mi>l</mi><mi>l</mi><mi>M</mi><mi>o</mi><mi>d</mi><mi>u</mi><mi>l</mi><mi>e</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>true</mtext></mstyle></math>
+</div>
+</div>
+</li>
+<li>
+<p>For a statically-filled class <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>F</mi></math> there is at most one static polyfill:</p>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfenced close=")" open="("><mrow><msub><mi>P</mi><mn>1</mn></msub><mstyle mathvariant="monospace"><mspace width="1ex"/><mtext>is static polyfill of</mtext><mspace width="1ex"/></mstyle><mi>F</mi><mo>∧</mo><msub><mi>P</mi><mn>2</mn></msub><mstyle mathvariant="monospace"><mspace width="1ex"/><mtext>is static polyfill of</mtext><mspace width="1ex"/></mstyle><mi>F</mi></mrow></mfenced><mo>→</mo><msub><mi>P</mi><mn>1</mn></msub><mo>=</mo><msub><mi>P</mi><mn>2</mn></msub></math>
+</div>
+</div>
+</li>
+</ol>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-156"></a><strong>Req. IDE-156:</strong> <a href="#Req-IDE-156">Restrictions on static polyfilling</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>For a static polyfilling module <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>M</mi><mi>P</mi></msub></math> the following must hold:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>All top-level elements are static polyfills:</p>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><mo>∀</mo><mi>T</mi><mo>∈</mo><msub><mi>M</mi><mi>P</mi></msub><mo>∧</mo><mi>T</mi><mo>.</mo><mi>t</mi><mi>o</mi><mi>p</mi><mi>L</mi><mi>e</mi><mi>v</mi><mi>e</mi><mi>l</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>true</mtext></mstyle></mrow><mrow><mi>T</mi><mo>.</mo><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>c</mi><mi>P</mi><mi>o</mi><mi>l</mi><mi>y</mi><mi>f</mi><mi>i</mi><mi>l</mi><mi>l</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>true</mtext></mstyle></mrow></mfrac></math>
+</div>
+</div>
+</li>
+<li>
+<p>It exists exactly one filled module <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>M</mi><mi>F</mi></msub></math> annotated with <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>c</mi><mi>P</mi><mi>o</mi><mi>l</mi><mi>y</mi><mi>f</mi><mi>i</mi><mi>l</mi><mi>l</mi><mi>A</mi><mi>w</mi><mi>a</mi><mi>r</mi><mi>e</mi></math> in the same project.</p>
+</li>
+<li>
+<p>It is an error if two static polyfill modules for the same filled module exist in the same project:</p>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><msub><mi>M</mi><mn>1.</mn></msub><mi>s</mi><mi>p</mi><mi>e</mi><mi>c</mi><mi>i</mi><mi>f</mi><mi>i</mi><mi>e</mi><mi>r</mi><mo>=</mo><msub><mi>M</mi><mn>2.</mn></msub><mi>s</mi><mi>p</mi><mi>e</mi><mi>c</mi><mi>i</mi><mi>f</mi><mi>i</mi><mi>e</mi><mi>r</mi><mo>∧</mo><msub><mi>M</mi><mn>1.</mn></msub><mi>p</mi><mi>r</mi><mi>o</mi><mi>j</mi><mi>e</mi><mi>c</mi><mi>t</mi><mo>=</mo><msub><mi>M</mi><mn>2.</mn></msub><mi>p</mi><mi>r</mi><mi>o</mi><mi>j</mi><mi>e</mi><mi>c</mi><mi>t</mi><mtext>
+</mtext><mo>∧</mo><msub><mi>M</mi><mn>1.</mn></msub><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>c</mi><mi>P</mi><mi>o</mi><mi>l</mi><mi>y</mi><mi>f</mi><mi>i</mi><mi>l</mi><mi>l</mi><mi>M</mi><mi>o</mi><mi>d</mi><mi>u</mi><mi>l</mi><mo>=</mo><msub><mi>M</mi><mn>2.</mn></msub><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>c</mi><mi>P</mi><mi>o</mi><mi>l</mi><mi>y</mi><mi>f</mi><mi>i</mi><mi>l</mi><mi>l</mi><mi>M</mi><mi>o</mi><mi>d</mi><mi>u</mi><mi>l</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>true</mtext></mstyle></mrow><mrow><msub><mi>M</mi><mn>1</mn></msub><mo>=</mo><msub><mi>M</mi><mn>2</mn></msub></mrow></mfrac></math>
+</div>
+</div>
+</li>
+</ol>
+</div>
+</div>
+</div>
+<div class="exampleblock">
+<div class="title">Example 101. Static polyfill</div>
+<div class="content">
+<div class="paragraph">
+<p><a href="#ex:staticpolyfill-genmod">Static Polyfill, Genmod</a> shows an example of generated code.
+<a href="#ex:staticpolyfill-polyfillmod">Static Polyfill, Polyfillmod</a> demonstrates the static polyfill.</p>
+</div>
+<div class="paragraph">
+<p>Note that the containing project has two source folders configured:<br>
+<code>Project/src/n4js</code> and <code>Project/src/n4jsgen</code>.</p>
+</div>
+<div id="ex:staticpolyfill-polyfillmod" class="listingblock">
+<div class="title">Static Polyfill, Polyfillmod</div>
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">@@StaticPolyfillAware
+export public class A {
+    constructor() {...}
+    m1(): void{...}
+}
+export public class B {
+    constructor() {...}
+    m2(): void{...}
+}</code></pre>
+</div>
+</div>
+<div id="ex:staticpolyfill-genmod" class="listingblock">
+<div class="title">Static Polyfill, Genmod</div>
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">@@StaticPolyfillModule
+@StaticPolyfill
+export public class B extends B {
+    @Override
+    constructor(){ ... } // replaces generated ctor of B
+    @Override
+    m1(): void {...} // adds overridden method m1 to B
+    @Override
+    m2(): void {...} // replaces method m2 in B
+    m3(): void {...} // adds new method m3 to B
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_transpiling-static-polyfilled-classes"><a class="anchor" href="#_transpiling-static-polyfilled-classes"></a><a class="link" href="#_transpiling-static-polyfilled-classes">11.4.3. Transpiling static polyfilled classes</a></h4>
+<div class="paragraph">
+<p>Transpiling static polyfilled classes encounters the special case that two different <code>n4js</code> source files with the same qualified name are part of the project.
+Since the current transpiler is file-based, both files would be transpiled to the same output destination and would therefore overwrite each other.
+The following pre-transpilation steps handle this situation:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Current file to transpile is <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>M</mi></math></p>
+</li>
+<li>
+<p>If <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>M</mi><mo>.</mo><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>c</mi><mi>P</mi><mi>o</mi><mi>l</mi><mi>y</mi><mi>f</mi><mi>i</mi><mi>l</mi><mi>l</mi><mi>A</mi><mi>w</mi><mi>a</mi><mi>r</mi><mi>e</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>true</mtext></mstyle></math>, then</p>
+<div class="ulist">
+<ul>
+<li>
+<p>search for a second file <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>G</mi></math> with same qualified name:<br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>G</mi><mo>.</mo><mi>s</mi><mi>p</mi><mi>e</mi><mi>c</mi><mi>i</mi><mi>f</mi><mi>i</mi><mi>e</mi><mi>r</mi><mo>=</mo><mi>M</mi><mo>.</mo><mi>s</mi><mi>p</mi><mi>e</mi><mi>c</mi><mi>i</mi><mi>f</mi><mi>i</mi><mi>e</mi><mi>r</mi><mo>∧</mo><mi>G</mi><mo>.</mo><mi>p</mi><mi>r</mi><mi>o</mi><mi>j</mi><mi>e</mi><mi>c</mi><mi>t</mi><mo>=</mo><mi>M</mi><mo>.</mo><mi>p</mi><mi>r</mi><mi>o</mi><mi>j</mi><mi>e</mi><mi>c</mi><mi>t</mi></math></p>
+</li>
+<li>
+<p>If <math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∃</mo><mi>G</mi></math>, then</p>
+<div class="ulist">
+<ul>
+<li>
+<p>merge <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>G</mi></math> into current file <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>M</mi><mo>→</mo><msup><mi>M</mi><mi>'</mi></msup></math></p>
+</li>
+<li>
+<p>conventionally transpile <math xmlns="http://www.w3.org/1998/Math/MathML"><msup><mi>M</mi><mi>'</mi></msup></math></p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>else conventionally transpile <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>M</mi></math></p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>else, if <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>M</mi><mo>.</mo><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>c</mi><mi>P</mi><mi>o</mi><mi>l</mi><mi>y</mi><mi>f</mi><mi>i</mi><mi>l</mi><mi>l</mi><mi>M</mi><mi>o</mi><mi>d</mi><mi>u</mi><mi>l</mi><mi>e</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>true</mtext></mstyle></math>,</p>
+<div class="ulist">
+<ul>
+<li>
+<p>then <em>do nothing</em>. (Transpilation will be triggered for filled type separately.)</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>else, conventionally transpile <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>M</mi></math></p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div id="footer">
+<div id="footer-text">
+Version 0.9<br>
+Last updated 2019-08-07 15:02:40 CEST
+</div>
+</div>
+<!-- ************* docinfo-footer *************************************************************** -->
+<div class="Grid social" style="color:#d5dfea">
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <h2>Quick Links</h2>
+    <ul>
+      <li><a href="../downloads.html">Download</a></li>
+      <li><a href="../userguides/index.html">Documentation</a></li>
+      <li><a href="https://github.com/eclipse/n4js/">Source</a></li>
+      <li><a href="https://github.com/eclipse/n4js/issues">Issues</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="https://www.eclipse.org/forums/index.php/f/365/">Forum</a></li>
+      <li><a href="http://n4js.blogspot.de/">Blog</a></li>
+      <li><a href="https://dev.eclipse.org/mailman/listinfo/n4js-dev">Mailing List</a></li>
+      <li><a href="https://projects.eclipse.org/projects/technology.n4js">Eclipse Project Page</a></li>
+      <li><a href="https://twitter.com/n4jsdev">Tweets by n4jsdev</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="http://www.eclipse.org/">Eclipse Home</a></li>
+      <li><a href="http://www.eclipse.org/legal/privacy.php">Privacy Policy</a></li>
+      <li><a href="http://www.eclipse.org/legal/termsofuse.php">Terms of Use</a></li>
+      <li><a href="http://www.eclipse.org/legal/copyright.php">Copyright Agent</a></li>
+      <li><a href="http://www.eclipse.org/legal/">Legal</a></li>
+    </ul>
+  </div>
+  <div style="clear: both; height: 0; overflow: hidden;"></div>
+</div>
+
+<!-- ************* UI Scripts ************* -->
+<script type="text/javascript" src="scripts/back-to-top.js"></script>
+
+<script type="text/javascript" src="scripts/treeview.js"></script>
+<script type="text/javascript" src="scripts/toc.js"></script>
+
+<!-- ************* Prism.js Syntax Highlighting ************* -->
+<script src="scripts/prism.js"></script>
+
+<script type="text/javascript">
+	// Add the 'toclist' id for search function
+	$(".toc2 > ul").attr('id', 'toclist');
+	// Generate a Search input form
+	$("#toclist > li:first-of-type").before('<input type="text" id="pagesearch" onkeyup="search()" placeholder="Search for section...">');
+	$("#toclist > li:first-of-type").before('<i id="clear" class="fa fa-times-circle-o"></i>');
+	$("#clear").click(function(){
+	    $("#pagesearch").val('');
+	    search();
+	    $('.toc2 > ul').treeView('collapseAll');
+	});
+	// intialize Treeview.js
+	$(".toc2 > ul").treeView();
+	// Initialize Scrollspy
+</script>
+<!-- ************* docinfo-footer *************************************************************** -->
+</body>
+</html>
\ No newline at end of file
diff --git a/spec/functions.html b/spec/functions.html
new file mode 100644
index 0000000..8b17c1b
--- /dev/null
+++ b/spec/functions.html
@@ -0,0 +1,2602 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="generator" content="Asciidoctor 1.5.5">
+<meta name="author" content="2019-08-07 15:02:40 CEST">
+<title>N4JS Language Specification</title>
+<link rel="stylesheet" href="styles/spec.min.css">
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.6.3/css/font-awesome.min.css">
+<!-- ************* docinfo ******************************************************************* -->
+
+
+<!-- ************* Favicon ************-->
+<link rel="icon" href="images/favicon.ico" />
+
+<!-- ************* Back-to-top JQuery ************* -->
+<script src="https://code.jquery.com/jquery-1.12.4.js"></script>
+<script src="https://code.jquery.com/ui/1.12.0/jquery-ui.js"></script>
+
+
+<link href="styles/prism.min.css" rel="stylesheet" />
+<script type="text/javascript" async
+  src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2/MathJax.js?config=TeX-MML-AM_CHTML">
+</script>
+
+<!-- ************* Styles ************* -->
+<link rel="stylesheet" type="text/css" href="styles/n4jsspec-adoc.css">
+
+
+<!-- ****************** NavBar ****************** -->
+<div id="menubar">
+	<div class="banner">
+        <a href="https://www.eclipse.org/n4js/#"><img id="logo" src="images/n4js-logo.png" alt="Eclipse N4JS"></a>
+    </div>
+<ul>
+  <li><a href="index.html">Index</a></li>
+</ul>
+</div>
+<!-- ************* docinfo ******************************************************************* -->
+<style>
+      .admonitionblock td.icon .icon-todo:before{content:"\f249";color:#f4ee42}
+    </style>
+</head>
+<body class="book toc2 toc-left">
+<div id="header">
+<h1>N4JS Language Specification</h1>
+<div class="details">
+<span id="author" class="author">2019-08-07 15:02:40 CEST</span><br>
+<span id="revnumber">version 0.9</span>
+</div>
+<div id="toc" class="toc2">
+<div id="toctitle">Table of Contents</div>
+<ul class="sectlevel1">
+<li><a href="introduction.html#_introduction">1. Introduction</a>
+<ul class="sectlevel2">
+<li><a href="introduction.html#_notation">1.1. Notation</a>
+<ul class="sectlevel3">
+<li><a href="introduction.html#_grammar-notation">1.1.1. Grammar Notation</a></li>
+<li><a href="introduction.html#_type-judgments-and-rules-and-constraints-notation">1.1.2. Type Judgments and Rules and Constraints Notation</a>
+<ul class="sectlevel4">
+<li><a href="introduction.html#_typing-rules-and-judgments">1.1.2.1. Typing Rules and Judgments</a></li>
+<li><a href="introduction.html#_types-of-an-element">1.1.2.2. Types of an Element</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="introduction.html#_auxiliary-functions">1.2. Auxiliary Functions</a>
+<ul class="sectlevel3">
+<li><a href="introduction.html#_binding">1.2.1. Binding</a></li>
+<li><a href="introduction.html#_merging-types">1.2.2. Merging Types</a>
+<ul class="sectlevel4">
+<li><a href="introduction.html#_logic-formulas">1.2.2.1. Logic Formulas</a></li>
+</ul>
+</li>
+<li><a href="introduction.html#_symbols-and-font-convention">1.2.3. Symbols and Font Convention</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="grammar.html#_grammar">2. Grammar</a>
+<ul class="sectlevel2">
+<li><a href="grammar.html#_lexical-conventions">2.1. Lexical Conventions</a>
+<ul class="sectlevel3">
+<li><a href="grammar.html#_identifier-names-and-identifiers">2.1.1. Identifier Names and Identifiers</a></li>
+<li><a href="grammar.html#_this-keyword">2.1.2. This Keyword</a></li>
+<li><a href="grammar.html#_regular-expression-literals">2.1.3. Regular Expression Literals</a></li>
+<li><a href="grammar.html#_automatic-semicolon-insertion">2.1.4. Automatic Semicolon Insertion</a></li>
+<li><a href="grammar.html#_jsdoc">2.1.5. JSDoc</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="names.html#_names">3. Names</a>
+<ul class="sectlevel2">
+<li><a href="names.html#_access-control">3.1. Access Control</a></li>
+<li><a href="names.html#_accessibility-of-types-top-level-variables-and-function-declarations">3.2. Accessibility of Types, Top-Level Variables and Function Declarations</a>
+<ul class="sectlevel3">
+<li><a href="names.html#_accessibility-of-members">3.2.1. Accessibility of Members</a></li>
+<li><a href="names.html#_valid-names">3.2.2. Valid Names</a></li>
+<li><a href="names.html#_qualified-names">3.2.3. Qualified Names</a></li>
+<li><a href="names.html#_name-duplicates">3.2.4. Name Duplicates</a>
+<ul class="sectlevel4">
+<li><a href="names.html#_lexical-environment">3.2.4.1. Lexical Environment</a></li>
+<li><a href="names.html#_duplicates-and-shadowing">3.2.4.2. Duplicates and Shadowing</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="types.html#_types">4. Types</a>
+<ul class="sectlevel2">
+<li><a href="types.html#_overview">4.1. Overview</a></li>
+<li><a href="types.html#_type-expressions">4.2. Type Expressions</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_syntax">4.2.1. Syntax</a></li>
+<li><a href="types.html#_properties">4.2.2. Properties</a></li>
+<li><a href="types.html#_semantics">4.2.3. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_type-inference">4.3. Type Inference</a></li>
+<li><a href="types.html#_generic-and-parameterized-types">4.4. Generic and Parameterized Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_generic-types">4.4.1. Generic Types</a></li>
+<li><a href="types.html#_type-variables">4.4.2. Type Variables</a></li>
+<li><a href="types.html#_parameterized-types">4.4.3. Parameterized Types</a></li>
+</ul>
+</li>
+<li><a href="types.html#_primitive-ecmascript-types">4.5. Primitive ECMAScript Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_undefined-type">4.5.1. Undefined Type</a></li>
+<li><a href="types.html#_null-type">4.5.2. Null Type</a></li>
+<li><a href="types.html#_primitive-boolean-type">4.5.3. Primitive Boolean Type</a></li>
+<li><a href="types.html#_primitive-string-type">4.5.4. Primitive String Type</a></li>
+<li><a href="types.html#_primitive-number-type">4.5.5. Primitive Number Type</a></li>
+<li><a href="types.html#_primitive-type-int">4.5.6. Primitive Type int</a></li>
+<li><a href="types.html#_primitive-symbol-type">4.5.7. Primitive Symbol Type</a></li>
+</ul>
+</li>
+<li><a href="types.html#_primitive-n4js-types">4.6. Primitive N4JS Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_any-type">4.6.1. Any Type</a>
+<ul class="sectlevel4">
+<li><a href="types.html#any-type-semantics">4.6.1.1. Semantics</a></li>
+<li><a href="types.html#any-type-type-inference">4.6.1.2. Type Inference</a>
+<ul class="sectlevel5">
+<li><a href="types.html#_default-type-of-variables">4.6.1.2.1. Default Type of Variables</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="types.html#_void-type">4.6.2. Void Type</a>
+<ul class="sectlevel4">
+<li><a href="types.html#void-type-semantics">4.6.2.1. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_unknown-type">4.6.3. Unknown Type</a></li>
+<li><a href="types.html#_primitive-pathselector-and-i18nkey">4.6.4. Primitive Pathselector and I18nKey</a>
+<ul class="sectlevel4">
+<li><a href="types.html#pathselector-semantics">4.6.4.1. Semantics</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="types.html#_built-in-ecmascript-object-types">4.7. Built-in ECMAScript Object Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#ECMAScript-objects-semantics">4.7.1. Semantics</a></li>
+<li><a href="types.html#_object-type">4.7.2. Object Type</a></li>
+<li><a href="types.html#_function-object-type">4.7.3. Function-Object-Type</a></li>
+<li><a href="types.html#_array-object-type">4.7.4. Array Object Type</a></li>
+<li><a href="types.html#_string-object-type">4.7.5. String Object Type</a></li>
+<li><a href="types.html#_boolean-object-type">4.7.6. Boolean Object Type</a></li>
+<li><a href="types.html#_number-object-type">4.7.7. Number Object Type</a></li>
+<li><a href="types.html#_global-object-type">4.7.8. Global Object Type</a></li>
+<li><a href="types.html#_symbol">4.7.9. Symbol</a></li>
+<li><a href="types.html#_promise">4.7.10. Promise</a></li>
+<li><a href="types.html#_iterator-interface">4.7.11. Iterator Interface</a></li>
+<li><a href="types.html#_iterable-interface">4.7.12. Iterable Interface</a></li>
+</ul>
+</li>
+<li><a href="types.html#_built-in-n4js-types">4.8. Built-In N4JS Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_n4object">4.8.1. N4Object</a>
+<ul class="sectlevel4">
+<li><a href="types.html#N4Object-semantics">4.8.1.1. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_n4class">4.8.2. N4Class</a></li>
+<li><a href="types.html#IterableN">4.8.3. IterableN</a></li>
+</ul>
+</li>
+<li><a href="types.html#_type-modifiers">4.9. Type Modifiers</a>
+<ul class="sectlevel3">
+<li><a href="types.html#Type_Modifiers_Dynamic">4.9.1. Dynamic</a></li>
+<li><a href="types.html#_optional-return-types">4.9.2. Optional Return Types</a></li>
+</ul>
+</li>
+<li><a href="types.html#_union-and-intersection-type-composed-types">4.10. Union and Intersection Type (Composed Types)</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_union-type">4.10.1. Union Type</a>
+<ul class="sectlevel4">
+<li><a href="types.html#union-type-syntax">4.10.1.1. Syntax</a></li>
+<li><a href="types.html#union-type-semantics">4.10.1.2. Semantics</a></li>
+<li><a href="types.html#_warnings">4.10.1.3. Warnings</a></li>
+</ul>
+</li>
+<li><a href="types.html#_intersection-type">4.10.2. Intersection Type</a>
+<ul class="sectlevel4">
+<li><a href="types.html#intersection-type-syntax">4.10.2.1. Syntax</a></li>
+<li><a href="types.html#intersection-type-semantics">4.10.2.2. Semantics</a></li>
+<li><a href="types.html#_warnings-2">4.10.2.3. Warnings</a></li>
+</ul>
+</li>
+<li><a href="types.html#_composed-types-in-wildcards">4.10.3. Composed Types in Wildcards</a></li>
+<li><a href="types.html#_property-access-for-composed-types">4.10.4. Property Access for Composed Types</a>
+<ul class="sectlevel4">
+<li><a href="types.html#_properties-of-union-type">4.10.4.1. Properties of Union Type</a>
+<ul class="sectlevel5">
+<li><a href="types.html#_remarks-on-union-type-s-members">4.10.4.1.1. Remarks on union type’s members:</a></li>
+</ul>
+</li>
+<li><a href="types.html#_properties-of-intersection-type">4.10.4.2. Properties of Intersection Type</a>
+<ul class="sectlevel5">
+<li><a href="types.html#_remarks-on-intersection-type-s-methods">4.10.4.2.1. Remarks on intersection type’s methods:</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="types.html#_constructor-and-classifier-type">4.11. Constructor and Classifier Type</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_syntax-3">4.11.1. Syntax</a></li>
+<li><a href="types.html#_semantics-2">4.11.2. Semantics</a></li>
+<li><a href="types.html#_constructors-and-prototypes-in-ecmascript-2015">4.11.3. Constructors and Prototypes in ECMAScript 2015</a></li>
+</ul>
+</li>
+<li><a href="types.html#_this-type">4.12. This Type</a>
+<ul class="sectlevel3">
+<li><a href="types.html#this-type-syntax">4.12.1. Syntax</a></li>
+<li><a href="types.html#this-keyword-semantics">4.12.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_enums">4.13. Enums</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_enums-n4js">4.13.1. Enums (N4JS)</a>
+<ul class="sectlevel4">
+<li><a href="types.html#enums-syntax">4.13.1.1. Syntax</a></li>
+<li><a href="types.html#enums-semantics">4.13.1.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_string-based-enums">4.13.2. String-Based Enums</a></li>
+</ul>
+</li>
+<li><a href="types.html#_short-hand-syntax">4.14. Short-Hand Syntax</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_array-short-hand-syntax">4.14.1. Array Short-Hand Syntax</a></li>
+<li><a href="types.html#_iterablen-short-hand-syntax">4.14.2. IterableN Short-Hand Syntax</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="classifiers.html#_classifiers">5. Classifiers</a>
+<ul class="sectlevel2">
+<li><a href="classifiers.html#_n4js-specific-classifiers">5.1. N4JS Specific Classifiers</a>
+<ul class="sectlevel3">
+<li><a href="classifiers.html#_properties-2">5.1.1. Properties</a></li>
+<li><a href="classifiers.html#_common-semantics-of-classifiers">5.1.2. Common Semantics of Classifiers</a></li>
+<li><a href="classifiers.html#_classes">5.1.3. Classes</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_definition-of-classes">5.1.3.1. Definition of Classes</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#class-syntax">5.1.3.1.1. Syntax</a></li>
+<li><a href="classifiers.html#class-properties">5.1.3.1.2. Properties</a></li>
+<li><a href="classifiers.html#class-type-inference">5.1.3.1.3. Type Inference</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#class-semantics">5.1.3.2. Semantics</a></li>
+<li><a href="classifiers.html#_final-modifier">5.1.3.3. Final Modifier</a></li>
+<li><a href="classifiers.html#_abstract-classes">5.1.3.4. Abstract Classes</a></li>
+<li><a href="classifiers.html#_non-instantiable-classes">5.1.3.5. Non-Instantiable Classes</a></li>
+<li><a href="classifiers.html#_superclass">5.1.3.6. Superclass</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_interfaces">5.1.4. Interfaces</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_definition-of-interfaces">5.1.4.1. Definition of Interfaces</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#interfaces-syntax">5.1.4.1.1. Syntax</a></li>
+<li><a href="classifiers.html#interfaces-properties">5.1.4.1.2. Properties</a></li>
+<li><a href="classifiers.html#interfaces-type-inference">5.1.4.1.3. Type Inference</a></li>
+<li><a href="classifiers.html#interfaces-semantics">5.1.4.1.4. Semantics</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="classifiers.html#_generic-classifiers">5.1.5. Generic Classifiers</a></li>
+<li><a href="classifiers.html#sec:definition-site-variance">5.1.6. Definition-Site Variance</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_members">5.2. Members</a>
+<ul class="sectlevel3">
+<li><a href="classifiers.html#_syntax-4">5.2.1. Syntax</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_properties-3">5.2.1.1. Properties</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_semantics-3">5.2.2. Semantics</a></li>
+<li><a href="classifiers.html#_methods">5.2.3. Methods</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_syntax-5">5.2.3.1. Syntax</a></li>
+<li><a href="classifiers.html#_properties-4">5.2.3.2. Properties</a></li>
+<li><a href="classifiers.html#_semantics-4">5.2.3.3. Semantics</a></li>
+<li><a href="classifiers.html#_final-methods">5.2.3.4. Final Methods</a></li>
+<li><a href="classifiers.html#_abstract-methods">5.2.3.5. Abstract Methods</a></li>
+<li><a href="classifiers.html#_generic-methods">5.2.3.6. Generic Methods</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_default-methods-in-interfaces">5.2.4. Default Methods in Interfaces</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_asynchronous-methods">5.2.4.1. Asynchronous Methods</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_constructors">5.2.5. Constructors</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_structural-this-type-in-constructor">5.2.5.1. Structural This Type in Constructor</a></li>
+<li><a href="classifiers.html#spec-constructor">5.2.5.2. @Spec Constructor</a></li>
+<li><a href="classifiers.html#_callable-constructors">5.2.5.3. Callable Constructors</a></li>
+<li><a href="classifiers.html#_covariant-constructors">5.2.5.4. Covariant Constructors</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_data-fields">5.2.6. Data Fields</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#data-fields-syntax">5.2.6.1. Syntax</a></li>
+<li><a href="classifiers.html#data-fields-properties">5.2.6.2. Properties</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#data-fields-semantics">5.2.6.2.1. Semantics</a></li>
+<li><a href="classifiers.html#data-fields-type-inference">5.2.6.2.2. Type Inference</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_assignment-modifiers">5.2.6.3. Assignment Modifiers</a></li>
+<li><a href="classifiers.html#_field-accessors-getter-setter">5.2.6.4. Field Accessors (Getter/Setter)</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#field-acessors-syntax">5.2.6.4.1. Syntax</a></li>
+<li><a href="classifiers.html#field-acessors-properties">5.2.6.4.2. Properties</a></li>
+<li><a href="classifiers.html#field-accessors-semantics">5.2.6.4.3. Semantics</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#optional-fields">5.2.6.5. Optional Fields</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#_syntax-6">5.2.6.5.1. Syntax</a></li>
+<li><a href="classifiers.html#_semantics-5">5.2.6.5.2. Semantics</a></li>
+<li><a href="classifiers.html#_background">5.2.6.5.3. Background</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="classifiers.html#_static-members">5.2.7. Static Members</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_access-from-and-to-static-members">5.2.7.1. Access From and To Static Members</a></li>
+<li><a href="classifiers.html#_generic-static-methods">5.2.7.2. Generic static methods</a></li>
+<li><a href="classifiers.html#_static-members-of-interfaces">5.2.7.3. Static Members of Interfaces</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_redefinition-of-members">5.2.8. Redefinition of Members</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_overriding-of-members">5.2.8.1. Overriding of Members</a></li>
+<li><a href="classifiers.html#_implementation-of-members">5.2.8.2. Implementation of Members</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#_member-consumption">5.2.8.2.1. Member Consumption</a></li>
+<li><a href="classifiers.html#_member-implementation">5.2.8.2.2. Member Implementation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="classifiers.html#_structural-typing">5.3. Structural Typing</a>
+<ul class="sectlevel3">
+<li><a href="classifiers.html#_syntax-7">5.3.1. Syntax</a></li>
+<li><a href="classifiers.html#_definition-site-structural-typing">5.3.2. Definition Site Structural Typing</a></li>
+<li><a href="classifiers.html#_use-site-structural-typing">5.3.3. Use-Site Structural Typing</a></li>
+<li><a href="classifiers.html#structural-readWriteInit-field-typing">5.3.4. Structural Read-only, Write-only and Initializer Field Typing</a></li>
+<li><a href="classifiers.html#_public-setter-annotated-with-code-providesinitializer-code">5.3.5. Public Setter Annotated With <code>ProvidesInitializer</code></a></li>
+<li><a href="classifiers.html#_structural-types-with-optional-fields">5.3.6. Structural Types With Optional Fields</a></li>
+<li><a href="classifiers.html#_structural-types-with-access-modifier">5.3.7. Structural Types With Access Modifier</a></li>
+<li><a href="classifiers.html#_structural-types-with-additional-members">5.3.8. Structural Types With Additional Members</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_syntax-8">5.3.8.1. Syntax</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#_semantics-6">5.3.8.1.1. Semantics</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#_functions">6. Functions</a>
+<ul class="sectlevel2">
+<li><a href="#_function-type">6.1. Function Type</a>
+<ul class="sectlevel3">
+<li><a href="#_properties-5">6.1.1. Properties</a></li>
+<li><a href="#function-type-inference">6.1.2. Type Inference</a></li>
+<li><a href="#_autoboxing-of-function-type">6.1.3. Autoboxing of Function Type</a></li>
+<li><a href="#_arguments-object">6.1.4. Arguments Object</a></li>
+</ul>
+</li>
+<li><a href="#_ecmascript-5-function-definition">6.2. ECMAScript 5 Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="#_function-declaration">6.2.1. Function Declaration</a>
+<ul class="sectlevel4">
+<li><a href="#_syntax-9">6.2.1.1. Syntax</a></li>
+<li><a href="#_semantics-8">6.2.1.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="#_function-expression">6.2.2. Function Expression</a>
+<ul class="sectlevel4">
+<li><a href="#function-expression-syntax">6.2.2.1. Syntax</a></li>
+<li><a href="#_semantics-and-type-inference">6.2.2.2. Semantics and Type Inference</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#_ecmascript-2015-function-definition">6.3. ECMAScript 2015 Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="#_formal-parameters">6.3.1. Formal Parameters</a>
+<ul class="sectlevel4">
+<li><a href="#Type_Modifiers_Optional">6.3.1.1. Optional Parameters</a></li>
+<li><a href="#Type_Modifiers_Default">6.3.1.2. Default Parameters</a></li>
+<li><a href="#Type_Modifiers_Variadic">6.3.1.3. Variadic</a></li>
+</ul>
+</li>
+<li><a href="#_generator-functions">6.3.2. Generator Functions</a>
+<ul class="sectlevel4">
+<li><a href="#generator-functions-syntax">6.3.2.1. Syntax</a></li>
+<li><a href="#generator-functions-semantics">6.3.2.2. Semantics</a></li>
+<li><a href="#_generator-arrow-functions">6.3.2.3. Generator Arrow Functions</a></li>
+</ul>
+</li>
+<li><a href="#_arrow-function-expression">6.3.3. Arrow Function Expression</a>
+<ul class="sectlevel4">
+<li><a href="#arrow-function-expression-syntax">6.3.3.1. Syntax</a></li>
+<li><a href="#arrow-function-expression-semantics-and-type-inference">6.3.3.2. Semantics and Type Inference</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#_ecmascript-proposals-function-definition">6.4. ECMAScript Proposals Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="#_asynchronous-functions">6.4.1. Asynchronous Functions</a>
+<ul class="sectlevel4">
+<li><a href="#asynchronous-functions-syntax">6.4.1.1. Syntax</a></li>
+<li><a href="#asynchronous-functions-semantics">6.4.1.2. Semantics</a></li>
+<li><a href="#_asynchronous-arrow-functions">6.4.1.3. Asynchronous Arrow Functions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#_n4js-extended-function-definition">6.5. N4JS Extended Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="#_generic-functions">6.5.1. Generic Functions</a></li>
+<li><a href="#_promisifiable-functions">6.5.2. Promisifiable Functions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_conversions-and-reflection">7. Conversions and Reflection</a>
+<ul class="sectlevel2">
+<li><a href="conversions_and_reflection.html#_autoboxing-and-coercing">7.1. Autoboxing and Coercing</a>
+<ul class="sectlevel3">
+<li><a href="conversions_and_reflection.html#_coercing">7.1.1. Coercing</a></li>
+<li><a href="conversions_and_reflection.html#_autoboxing-of-primitives">7.1.2. Autoboxing of Primitives</a></li>
+<li><a href="conversions_and_reflection.html#_autoboxing-of-function-expressions-and-declarations">7.1.3. Autoboxing of Function Expressions and Declarations</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_auto-conversion-of-objects">7.2. Auto-Conversion of Objects</a>
+<ul class="sectlevel3">
+<li><a href="conversions_and_reflection.html#_auto-conversion-of-class-instances">7.2.1. Auto-Conversion of Class Instances</a>
+<ul class="sectlevel4">
+<li><a href="conversions_and_reflection.html#_auto-conversion-of-interface-instances">7.2.1.1. Auto-Conversion of Interface Instances</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_auto-conversion-of-enum-literals">7.2.2. Auto-Conversion of Enum Literals</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_type-cast-and-type-check">7.3. Type Cast and Type Check</a>
+<ul class="sectlevel3">
+<li><a href="conversions_and_reflection.html#_type-cast">7.3.1. Type Cast</a></li>
+<li><a href="conversions_and_reflection.html#_type-check">7.3.2. Type Check</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_reflection-meta-information">7.4. Reflection meta-information</a>
+<ul class="sectlevel3">
+<li><a href="conversions_and_reflection.html#_reflection-for-classes">7.4.1. Reflection for Classes</a></li>
+<li><a href="conversions_and_reflection.html#_reflection-for-interfaces">7.4.2. Reflection for Interfaces</a></li>
+<li><a href="conversions_and_reflection.html#_reflection-for-enumerations">7.4.3. Reflection for Enumerations</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_conversion-of-primitive-types">7.5. Conversion of primitive types</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_expressions">8. Expressions</a>
+<ul class="sectlevel2">
+<li><a href="expressions.html#_ecmascript-5-expressions">8.1. ECMAScript 5 Expressions</a>
+<ul class="sectlevel3">
+<li><a href="expressions.html#_the-this-literal">8.1.1. The this Literal</a></li>
+<li><a href="expressions.html#_identifier">8.1.2. Identifier</a></li>
+<li><a href="expressions.html#_literals">8.1.3. Literals</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#_integer-literals">8.1.3.1. Integer Literals</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_array-literal">8.1.4. Array Literal</a></li>
+<li><a href="expressions.html#_object-literal">8.1.5. Object Literal</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#_properties-6">8.1.5.1. Properties</a></li>
+<li><a href="expressions.html#_scoping-and-linking">8.1.5.2. Scoping and linking</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_parenthesized-expression-and-grouping-operator">8.1.6. Parenthesized Expression and Grouping Operator</a></li>
+<li><a href="expressions.html#_property-accessors">8.1.7. Property Accessors</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#properties-1">8.1.7.1. Properties</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_new-expression">8.1.8. New Expression</a></li>
+<li><a href="expressions.html#_function-expression-2">8.1.9. Function Expression</a></li>
+<li><a href="expressions.html#_function-calls">8.1.10. Function Calls</a></li>
+<li><a href="expressions.html#_postfix-expression">8.1.11. Postfix Expression</a></li>
+<li><a href="expressions.html#_unary-expression">8.1.12. Unary Expression</a></li>
+<li><a href="expressions.html#_multiplicative-expression">8.1.13. Multiplicative Expression</a></li>
+<li><a href="expressions.html#_additive-expression">8.1.14. Additive Expression</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#type-inference-10">8.1.14.1. Type Inference</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_bitwise-shift-expression">8.1.15. Bitwise Shift Expression</a></li>
+<li><a href="expressions.html#_relational-expression">8.1.16. Relational Expression</a></li>
+<li><a href="expressions.html#_equality-expression">8.1.17. Equality Expression</a></li>
+<li><a href="expressions.html#_binary-bitwise-expression">8.1.18. Binary Bitwise Expression</a></li>
+<li><a href="expressions.html#_binary-logical-expression">8.1.19. Binary Logical Expression</a></li>
+<li><a href="expressions.html#_conditional-expression">8.1.20. Conditional Expression</a></li>
+<li><a href="expressions.html#_assignment-expression">8.1.21. Assignment Expression</a></li>
+<li><a href="expressions.html#_comma-expression">8.1.22. Comma Expression</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_ecmascript-6-expressions">8.2. ECMAScript 6 Expressions</a>
+<ul class="sectlevel3">
+<li><a href="expressions.html#_the-super-keyword">8.2.1. The super Keyword</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_ecmascript-7-expressions">8.3. ECMAScript 7 Expressions</a>
+<ul class="sectlevel3">
+<li><a href="expressions.html#_await-expression">8.3.1. Await Expression</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_n4js-specific-expressions">8.4. N4JS Specific Expressions</a>
+<ul class="sectlevel3">
+<li><a href="expressions.html#_class-expression">8.4.1. Class Expression</a></li>
+<li><a href="expressions.html#_cast-as-expression">8.4.2. Cast (As) Expression</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#cast-as-expression-semantics-type-inference">8.4.2.1. Semantics and Type Inference</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#Import_Calls">8.4.3. Import Calls</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#compile-time-expressions">8.5. Compile-Time Expressions</a></li>
+</ul>
+</li>
+<li><a href="statements.html#_statements">9. Statements</a>
+<ul class="sectlevel2">
+<li><a href="statements.html#_ecmascript-5-statements">9.1. ECMAScript 5 Statements</a>
+<ul class="sectlevel3">
+<li><a href="statements.html#_function-or-field-accessor-bodies">9.1.1. Function or Field Accessor Bodies</a></li>
+<li><a href="statements.html#_variable-statement">9.1.2. Variable Statement</a></li>
+<li><a href="statements.html#_if-statement">9.1.3. If Statement</a></li>
+<li><a href="statements.html#_iteration-statements">9.1.4. Iteration Statements</a></li>
+<li><a href="statements.html#_return-statement">9.1.5. Return Statement</a></li>
+<li><a href="statements.html#_with-statement">9.1.6. With Statement</a></li>
+<li><a href="statements.html#_switch-statement">9.1.7. Switch Statement</a></li>
+<li><a href="statements.html#_throw-try-and-catch-statements">9.1.8. Throw, Try, and Catch Statements</a></li>
+<li><a href="statements.html#_debugger-statement">9.1.9. Debugger Statement</a></li>
+</ul>
+</li>
+<li><a href="statements.html#_ecmascript-6-statements">9.2. ECMAScript 6 Statements</a>
+<ul class="sectlevel3">
+<li><a href="statements.html#_let">9.2.1. Let</a></li>
+<li><a href="statements.html#_const">9.2.2. Const</a></li>
+<li><a href="statements.html#_for-of-statement">9.2.3. <code>for &#8230;&#8203; of</code> statement</a></li>
+<li><a href="statements.html#_import-statement">9.2.4. Import Statement</a>
+<ul class="sectlevel4">
+<li><a href="statements.html#Dynamic_Imports">9.2.4.1. Dynamic Imports</a></li>
+<li><a href="statements.html#_immutabilaty-of-imports">9.2.4.2. Immutabilaty of Imports</a></li>
+</ul>
+</li>
+<li><a href="statements.html#_export-statement">9.2.5. Export Statement</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="annotations.html#_annotations">10. Annotations</a>
+<ul class="sectlevel2">
+<li><a href="annotations.html#_introduction-2">10.1. Introduction</a>
+<ul class="sectlevel3">
+<li><a href="annotations.html#_syntax-13">10.1.1. Syntax</a></li>
+<li><a href="annotations.html#_properties-7">10.1.2. Properties</a></li>
+<li><a href="annotations.html#_element-specific-annotations">10.1.3. Element-Specific Annotations</a></li>
+<li><a href="annotations.html#_general-annotations">10.1.4. General Annotations</a>
+<ul class="sectlevel4">
+<li><a href="annotations.html#_idebug">10.1.4.1. IDEBUG</a></li>
+</ul>
+</li>
+<li><a href="annotations.html#idebug-syntax">10.1.5. Syntax</a>
+<ul class="sectlevel4">
+<li><a href="annotations.html#_semantics-11">10.1.5.1. Semantics</a></li>
+<li><a href="annotations.html#_suppress-warnings">10.1.5.2. Suppress Warnings</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="annotations.html#_declaration-of-annotations">10.2. Declaration of Annotations</a></li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_extended-fetaures">11. Extended Fetaures</a>
+<ul class="sectlevel2">
+<li><a href="extended_fetaures.html#_array-and-object-destructuring">11.1. Array and Object Destructuring</a>
+<ul class="sectlevel3">
+<li><a href="extended_fetaures.html#_syntax-14">11.1.1. Syntax</a></li>
+<li><a href="extended_fetaures.html#_semantics-12">11.1.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_dependency-injection">11.2. Dependency Injection</a>
+<ul class="sectlevel3">
+<li><a href="extended_fetaures.html#_di-components-and-injectors">11.2.1. DI Components and Injectors</a>
+<ul class="sectlevel4">
+<li><a href="extended_fetaures.html#_dicomponent-relations">11.2.1.1. DIComponent Relations</a></li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_binders-and-bindings">11.2.2. Binders and Bindings</a></li>
+<li><a href="extended_fetaures.html#_injection-points">11.2.3. Injection Points</a>
+<ul class="sectlevel4">
+<li><a href="extended_fetaures.html#_field-injection">11.2.3.1. Field Injection</a></li>
+<li><a href="extended_fetaures.html#_constructor-injection">11.2.3.2. Constructor Injection</a></li>
+<li><a href="extended_fetaures.html#_method-injection">11.2.3.3. Method Injection</a>
+<ul class="sectlevel5">
+<li><a href="extended_fetaures.html#_provider">11.2.3.3.1. Provider</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_n4js-di-life-cycle-and-scopes">11.2.4. N4JS DI Life Cycle and Scopes</a>
+<ul class="sectlevel4">
+<li><a href="extended_fetaures.html#_injection-cylces">11.2.4.1. Injection Cylces</a></li>
+<li><a href="extended_fetaures.html#_default-scope">11.2.4.2. Default Scope</a></li>
+<li><a href="extended_fetaures.html#_singleton-scope">11.2.4.3. Singleton Scope</a></li>
+<li><a href="extended_fetaures.html#_per-injection-chain-singleton">11.2.4.4. Per Injection Chain Singleton</a></li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_validation-of-callsites-targeting-n4injector-methods">11.2.5. Validation of callsites targeting N4Injector methods</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-annotations">11.2.6. N4JS DI Annotations</a>
+<ul class="sectlevel4">
+<li><a href="extended_fetaures.html#_n4js-di-generateinjector">11.2.6.1. N4JS DI @GenerateInjector</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-withparentinjector">11.2.6.2. N4JS DI @WithParentInjector</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-usebinder">11.2.6.3. N4JS DI @UseBinder</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-binder">11.2.6.4. N4JS DI @Binder</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-bind">11.2.6.5. N4JS DI @Bind</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-provides">11.2.6.6. N4JS DI @Provides</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-inject">11.2.6.7. N4JS DI @Inject</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-singleton">11.2.6.8. N4JS DI @Singleton</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_test-support">11.3. Test Support</a></li>
+<li><a href="extended_fetaures.html#_polyfill-definitions">11.4. Polyfill Definitions</a>
+<ul class="sectlevel3">
+<li><a href="extended_fetaures.html#_runtime-polyfill-definitions">11.4.1. Runtime Polyfill Definitions</a></li>
+<li><a href="extended_fetaures.html#_static-polyfill-definitions">11.4.2. Static Polyfill Definitions</a></li>
+<li><a href="extended_fetaures.html#_transpiling-static-polyfilled-classes">11.4.3. Transpiling static polyfilled classes</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="components.html#_components">12. Components</a>
+<ul class="sectlevel2">
+<li><a href="components.html#_overview-2">12.1. Overview</a></li>
+<li><a href="components.html#Component_Types">12.2. Component Types</a>
+<ul class="sectlevel3">
+<li><a href="components.html#_libraries">12.2.1. Libraries</a></li>
+<li><a href="components.html#_runtime-environment-and-runtime-libraries">12.2.2. Runtime Environment and Runtime Libraries</a></li>
+<li><a href="components.html#_tests">12.2.3. Tests</a></li>
+<li><a href="components.html#_type-definitions">12.2.4. Type Definitions</a></li>
+</ul>
+</li>
+<li><a href="components.html#package-json">12.3. Package.json File</a>
+<ul class="sectlevel3">
+<li><a href="components.html#_basic-properties">12.3.1. Basic Properties</a></li>
+<li><a href="components.html#_n4js-properties">12.3.2. N4JS Properties</a></li>
+<li><a href="components.html#_constraints">12.3.3. Constraints</a></li>
+</ul>
+</li>
+<li><a href="components.html#_support-for-npm-scopes">12.4. Support for NPM Scopes</a></li>
+<li><a href="components.html#sec:N4JS-Type-Definitions">12.5. N4JS Type Definitions</a>
+<ul class="sectlevel3">
+<li><a href="components.html#_specify-type-definition">12.5.1. Specify Type Definition</a></li>
+<li><a href="components.html#_name-conventions">12.5.2. Name Conventions</a></li>
+<li><a href="components.html#_version-conventions">12.5.3. Version Conventions</a>
+<ul class="sectlevel4">
+<li><a href="components.html#_define-a-new-type-definition-package">12.5.3.1. Define a New Type Definition Package</a></li>
+<li><a href="components.html#_using-a-type-definition-package">12.5.3.2. Using a Type Definition Package</a></li>
+<li><a href="components.html#_rational">12.5.3.3. Rational</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="components.html#_modules">12.6. Modules</a></li>
+<li><a href="components.html#_api-and-implementation-component">12.7. API and Implementation Component</a>
+<ul class="sectlevel3">
+<li><a href="components.html#_execution-of-api-and-implementation-components">12.7.1. Execution of API and Implementation Components</a></li>
+<li><a href="components.html#_api-and-implementation-with-di">12.7.2. API and Implementation With DI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="plainjs.html#_plainjs">13. PlainJS</a>
+<ul class="sectlevel2">
+<li><a href="plainjs.html#_type-inference-and-validation-for-plain-js">13.1. Type Inference and Validation for Plain JS</a></li>
+<li><a href="plainjs.html#_external-declarations">13.2. External Declarations</a>
+<ul class="sectlevel3">
+<li><a href="plainjs.html#_declaring-externals">13.2.1. Declaring externals</a></li>
+<li><a href="plainjs.html#_instantiating-external-classes">13.2.2. Instantiating external classes</a></li>
+<li><a href="plainjs.html#_implementation-of-external-declarations">13.2.3. Implementation of External Declarations</a></li>
+<li><a href="plainjs.html#_example">13.2.4. Example</a></li>
+</ul>
+</li>
+<li><a href="plainjs.html#_global-definitions">13.3. Global Definitions</a></li>
+<li><a href="plainjs.html#_runtime-definitions">13.4. Runtime Definitions</a></li>
+<li><a href="plainjs.html#_applying-polyfills">13.5. Applying Polyfills</a></li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_jsdoc-2">14. JSDoc</a>
+<ul class="sectlevel2">
+<li><a href="jsdoc.html#_general-n4jsdoc-features">14.1. General N4JSDoc Features</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#_provided-inline-tags">14.1.1. Provided Inline Tags</a>
+<ul class="sectlevel4">
+<li><a href="jsdoc.html#jsdoc_tag__code">14.1.1.1. @code</a></li>
+<li><a href="jsdoc.html#jsdoc_tag__link">14.1.1.2. @link</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_n4jsdoc-for-user-projects">14.2. N4JSdoc for User Projects</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#_standard-tags">14.2.1. Standard Tags</a>
+<ul class="sectlevel4">
+<li><a href="jsdoc.html#_-author">14.2.1.1. @author</a></li>
+<li><a href="jsdoc.html#jsdoc_tag_param">14.2.1.2. @param</a></li>
+<li><a href="jsdoc.html#jsdoc_tag_return">14.2.1.3. @return</a></li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_test-related-tags">14.2.2. Test Related Tags</a>
+<ul class="sectlevel4">
+<li><a href="jsdoc.html#jsdoc_tag__testee">14.2.2.1. @testee</a></li>
+<li><a href="jsdoc.html#jsdoc_tag__testeeFromType">14.2.2.2. @testeeFromType</a></li>
+<li><a href="jsdoc.html#_testeeType_and__testeeMember">14.2.2.3. @testeeType and @testeeMember</a></li>
+<li><a href="jsdoc.html#jsdoc_tag_reqid_in_Tests">14.2.2.4. @reqid in Tests</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_n4jsdoc-for-api-and-implementation-projects">14.3. N4JSDoc for API and Implementation Projects</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#jsdoc_tag__apiNote">14.3.1. @apiNote</a></li>
+<li><a href="jsdoc.html#API_Project_Tags">14.3.2. API Project Tags</a>
+<ul class="sectlevel4">
+<li><a href="jsdoc.html#jsdoc_tag_apiState">14.3.2.1. @apiState</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsx.html#_jsx">15. JSX</a>
+<ul class="sectlevel2">
+<li><a href="jsx.html#_jsx-support">15.1. JSX Support</a></li>
+<li><a href="jsx.html#_jsx-backend">15.2. JSX Backend</a></li>
+</ul>
+</li>
+<li><a href="grammars.html#_grammars">16. Grammars</a>
+<ul class="sectlevel2">
+<li><a href="grammars.html#_type-expressions-grammar">16.1. Type Expressions Grammar</a></li>
+<li><a href="grammars.html#_n4js-language-grammar">16.2. N4JS Language Grammar</a></li>
+</ul>
+</li>
+<li><a href="jsobjects.html#_jsobjects">17. JSObjects</a>
+<ul class="sectlevel2">
+<li><a href="jsobjects.html#_object">17.1. Object</a></li>
+<li><a href="jsobjects.html#_string">17.2. String</a></li>
+<li><a href="jsobjects.html#_boolean">17.3. Boolean</a></li>
+<li><a href="jsobjects.html#_number">17.4. Number</a>
+<ul class="sectlevel3">
+<li><a href="jsobjects.html#_static-attributes">17.4.1. Static Attributes</a></li>
+</ul>
+</li>
+<li><a href="jsobjects.html#function">17.5. Function</a></li>
+<li><a href="jsobjects.html#_error">17.6. Error</a></li>
+<li><a href="jsobjects.html#_array">17.7. Array</a></li>
+<li><a href="jsobjects.html#_date">17.8. Date</a></li>
+<li><a href="jsobjects.html#_math">17.9. Math</a>
+<ul class="sectlevel3">
+<li><a href="jsobjects.html#static-attributes-1">17.9.1. Static Attributes</a></li>
+</ul>
+</li>
+<li><a href="jsobjects.html#_regexp">17.10. RegExp</a></li>
+<li><a href="jsobjects.html#_json">17.11. JSON</a></li>
+</ul>
+</li>
+<li><a href="n4js_objects.html#_n4js-objects">18. N4JS Objects</a>
+<ul class="sectlevel2">
+<li><a href="n4js_objects.html#_reflection-model">18.1. Reflection Model</a></li>
+<li><a href="n4js_objects.html#_error-types">18.2. Error Types</a>
+<ul class="sectlevel3">
+<li><a href="n4js_objects.html#_n4apinotimplemented">18.2.1. N4ApiNotImplemented</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_acronyms.html#_acronyms">Appendix A: Acronyms</a></li>
+<li><a href="appendix_b_license.html#sec:License">Appendix B: License</a></li>
+<li><a href="appendix_c_bibliography.html#_bibliography">Appendix C: Bibliography</a></li>
+</ul>
+</div>
+</div>
+<div id="content"><div class="sect1">
+<h2 id="_functions"><a class="anchor" href="#_functions"></a><a class="link" href="#_functions">6. Functions</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>Functions, be they function declarations, expressions or even methods, are internally modeled by means of a function type.
+In this chapter, the general function type is described along with its semantics and type constraints.
+Function definitions and expressions are then introduced in terms of statements and expressions.
+Method definitions and special usages are described in <a href="classifiers.html#_methods">Methods</a>.</p>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="_function-type"><a class="anchor" href="#_function-type"></a><a class="link" href="#_function-type">6.1. Function Type</a></h3>
+<div class="paragraph">
+<p>A function type is modeled as <code>Object</code> (see [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.S13, p.p.98)</a>] in ECMAScript.</p>
+</div>
+<div class="paragraph">
+<p>Function types can be defined by means of;</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>A function object (<a href="types.html#_function-object-type">Function-Object-Type</a>).</p>
+</li>
+<li>
+<p>A function type expression (<a href="types.html#_type-expressions">Type Expressions</a>).</p>
+</li>
+<li>
+<p>A function declaration (<a href="#_function-declaration">Function Declaration</a>).</p>
+</li>
+<li>
+<p>A method declaration (<a href="classifiers.html#_methods">Methods</a>).</p>
+</li>
+</ul>
+</div>
+<div class="sect3">
+<h4 id="_properties-5"><a class="anchor" href="#_properties-5"></a><a class="link" href="#_properties-5">6.1.1. Properties</a></h4>
+<div class="paragraph">
+<p>In any case, a function type declares the signature of a function and allows validation of calls to that function.
+A function type has the following properties:</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><code>typePars</code>  </dt>
+<dd>
+<p>(0-indexed) list of type parameters (i.e. type variables) for generic functions.</p>
+</dd>
+<dt class="hdlist1"><code>fpars</code>  </dt>
+<dd>
+<p>(0-indexed) list of formal parameters.</p>
+</dd>
+<dt class="hdlist1"><code>returnType</code> </dt>
+<dd>
+<p>(possibly inferred) return type (expression) of the function or method.</p>
+</dd>
+<dt class="hdlist1"><code>name</code> </dt>
+<dd>
+<p>Name of function or method, may be empty or automatically generated (for messages).</p>
+</dd>
+<dt class="hdlist1"><code>body</code> </dt>
+<dd>
+<p>The body of the function, it contains statements <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>s</mi><mi>t</mi><mi>m</mi><mi>t</mi><mi>s</mi></math>.
+The body is null if a function type is defined in a type expression, and it is the last argument in case of a function object constructor, or the content of the function definition body.</p>
+</dd>
+</dl>
+</div>
+<div class="paragraph">
+<p>Additionally, the following pseudo properties for functions are defined:</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><code>thisTypeRef</code> </dt>
+<dd>
+<p>The this type ref is the type to which the <code>this</code>-keyword would be evaluated
+if used inside the function or member. The inference rules are described
+in <a href="grammar.html#_this-keyword">This Keyword</a>.</p>
+</dd>
+<dt class="hdlist1"><code>fpars</code> </dt>
+<dd>
+<p>List of formal parameters and the this type ref.
+This is only used for sub typing rules.
+If <code>this</code> is not used inside the function, then <code>any</code> is set instead of the inferred thisTypeRef to allow for more usages.
+The property is computed as follows:</p>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mi>t</mi><mi>f</mi><mi>p</mi><mi>a</mi><mi>r</mi><mi>s</mi><mo>=</mo><mstyle mathvariant="bold"><mtext>if</mtext></mstyle><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mspace width="3.0mm"/><mstyle mathvariant="bold"><mtext>this is used or explicitly declared</mtext></mstyle><mspace width="3.0mm"/><mstyle mathvariant="bold"><mtext>then</mtext></mstyle><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mi>t</mi><mi>h</mi><mi>i</mi><mi>s</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mo>+</mo><mi>f</mi><mi>p</mi><mi>a</mi><mi>r</mi><mi>s</mi><mspace width="3.0mm"/><mstyle mathvariant="bold"><mtext>else</mtext></mstyle><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mi>a</mi><mi>n</mi><mi>y</mi><mo>+</mo><mi>f</mi><mi>p</mi><mi>a</mi><mi>r</mi><mi>s</mi></math>
+</div>
+</div>
+</dd>
+</dl>
+</div>
+<div class="paragraph">
+<p>Parameters (in <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>p</mi><mi>a</mi><mi>r</mi><mi>s</mi></math>) have the following properties:</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><code>name</code> </dt>
+<dd>
+<p>Name of the parameter.</p>
+</dd>
+<dt class="hdlist1"><code>type</code> </dt>
+<dd>
+<p>Type (expression) of the parameter. Note that only parameter types can
+be variadic or optional.</p>
+</dd>
+</dl>
+</div>
+<div class="paragraph">
+<p>The function definition can be annotated similar to <a href="classifiers.html#_methods">Methods</a> except that the <code>final</code> and <code>abstract</code> modifiers aren’t supported for function declarations.
+A function declaration is always final and never abstract.
+Also, a function has no property advice set.</p>
+</div>
+<h4 id="_semantics-7" class="discrete">Semantics</h4>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-79"></a><strong>Req. IDE-79:</strong> <a href="#Req-IDE-79">Function Type</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>Type Given a function type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>F</mi></math>, the following constraints must be true:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Optional parameters must be defined at the end of the (formal) parameter list.
+In particular, an optional parameter must not be followed by a non-optional parameter:</p>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mi>F</mi><mo>.</mo><mi>f</mi><mi>p</mi><mi>a</mi><mi>r</mi><msub><mi>s</mi><mi>i</mi></msub><mo>.</mo><mi>o</mi><mi>p</mi><mi>t</mi><mi>i</mi><mi>o</mi><mi>n</mi><mi>a</mi><mi>l</mi><mo>→</mo><mo>∄</mo><mi>k</mi><mo>&gt;</mo><mi>i</mi><mi>:</mi><mo>¬</mo><mi>F</mi><mo>.</mo><mi>f</mi><mi>p</mi><mi>a</mi><mi>r</mi><msub><mi>s</mi><mi>k</mi></msub><mo>.</mo><mi>o</mi><mi>p</mi><mi>t</mi><mi>v</mi><mi>a</mi><mi>r</mi></math>
+</div>
+</div>
+</li>
+<li>
+<p>Only the last parameter of a method may be defined as variadic parameter:</p>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mi>F</mi><mo>.</mo><mi>f</mi><mi>p</mi><mi>a</mi><mi>r</mi><msub><mi>s</mi><mi>i</mi></msub><mo>.</mo><mi>v</mi><mi>a</mi><mi>r</mi><mi>i</mi><mi>a</mi><mi>d</mi><mi>i</mi><mi>c</mi><mo>→</mo><mi>i</mi><mo>=</mo><mo>|</mo><mi>F</mi><mo>.</mo><mi>f</mi><mi>p</mi><mi>a</mi><mi>r</mi><mi>s</mi><mo>|</mo><mo>-</mo><mn>1</mn></math>
+</div>
+</div>
+</li>
+<li>
+<p>If a function explicitly defines a return type, the last statement of the transitive closure of statements of the body must be a return statement:</p>
+<div class="paragraph">
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>F</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mo>≠</mo><mi>U</mi><mi>n</mi><mi>d</mi><mi>e</mi><mi>f</mi><mi>i</mi><mi>n</mi><mi>e</mi><mi>d</mi><mo>→</mo></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mo>|</mo><mi>f</mi><mo>.</mo><mi>b</mi><mi>o</mi><mi>d</mi><mi>y</mi><mo>.</mo><mi>s</mi><mi>t</mi><mi>m</mi><mi>t</mi><mi>s</mi><mo>|</mo><mo>&gt;</mo><mn>0</mn></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∧</mo><mi>f</mi><mo>.</mo><mi>b</mi><mi>o</mi><mi>d</mi><mi>y</mi><mo>.</mo><mi>s</mi><mi>t</mi><mi>m</mi><mi>t</mi><msubsup><mi>s</mi><mrow><mo>|</mo><mi>f</mi><mo>.</mo><mi>b</mi><mi>o</mi><mi>d</mi><mi>y</mi><mo>.</mo><mi>s</mi><mi>t</mi><mi>m</mi><mi>t</mi><msup><mi>s</mi><mo>*</mo></msup><mo>|</mo><mo>-</mo><mn>1</mn></mrow><mo>*</mo></msubsup><mi>i</mi><mi>s</mi><mi>a</mi><mi> </mi><mstyle mathvariant="monospace"><mtext>ReturnStatement</mtext></mstyle></math></p>
+</div>
+</li>
+<li>
+<p>If a function explicitly defines a return type, all return
+statements must return a type conform to that type:</p>
+<div class="paragraph">
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mi>F</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mo>≠</mo><mi>U</mi><mi>n</mi><mi>d</mi><mi>e</mi><mi>f</mi><mi>i</mi><mi>n</mi><mi>e</mi><mi>d</mi></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mo>⇔</mo></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mo>∀</mo><mi>r</mi><mo>∈</mo><mi>F</mi><mo>.</mo><mi>b</mi><mi>o</mi><mi>d</mi><mi>y</mi><mo>.</mo><mi>s</mi><mi>t</mi><mi>m</mi><mi>t</mi><mi>s</mi><mo>,</mo><mi>r</mi><mi> </mi><mi>i</mi><mi>s</mi><mi>a</mi><mi> </mi><mstyle mathvariant="monospace"><mtext>ReturnStatement</mtext></mstyle><mi>:</mi></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="3.0mm"/><mi>r</mi><mo>.</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mo>≠</mo><mi>n</mi><mi>u</mi><mi>l</mi><mi>l</mi><mo>∧</mo><mrow><mo>[</mo><mspace width="-0.167em"/><mrow><mo>[</mo></mrow></mrow><mrow><mi>r</mi><mo>.</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi></mrow><mrow><mrow><mo>]</mo></mrow><mspace width="-0.167em"/><mo>]</mo></mrow><mo>&lt;</mo><mi>:</mi><mrow><mo>[</mo><mspace width="-0.167em"/><mrow><mo>[</mo></mrow></mrow><mrow><mi>F</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi></mrow><mrow><mrow><mo>]</mo></mrow><mspace width="-0.167em"/><mo>]</mo></mrow></math></p>
+</div>
+</li>
+</ol>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="function-type-inference"><a class="anchor" href="#function-type-inference"></a><a class="link" href="#function-type-inference">6.1.2. Type Inference</a></h4>
+<div id="function_type_conformance_non_parameterized" class="openblock definition">
+<div class="content">
+<div class="paragraph">
+<p><a id="function_type_conformance_non_parameterized"></a><strong>Definition:</strong> <a href="#function_type_conformance_non_parameterized">Function Type Conformance Non-Parameterized</a></p>
+</div>
+<div class="paragraph">
+<p><em>For the given non-parameterized function types</em>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>F</mi><mrow><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi></mrow></msub></math> with
+<math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>F</mi><mrow><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi></mrow></msub><mo>.</mo><mi>t</mi><mi>f</mi><mi>p</mi><mi>a</mi><mi>r</mi><mi>s</mi><mo>=</mo><msub><mi>L</mi><mn>0</mn></msub><mo>,</mo><msub><mi>L</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><msub><mi>L</mi><mi>k</mi></msub></math> and
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mo>|</mo><msub><mi>F</mi><mrow><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi></mrow></msub><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>s</mi><mi>P</mi><mi>a</mi><mi>r</mi><mi>s</mi><mo>|</mo><mo>=</mo><mn>0</mn></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>F</mi><mrow><mi>r</mi><mi>i</mi><mi>g</mi><mi>h</mi><mi>t</mi></mrow></msub></math> with
+<math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>F</mi><mrow><mi>r</mi><mi>i</mi><mi>g</mi><mi>h</mi><mi>t</mi></mrow></msub><mo>.</mo><mi>t</mi><mi>f</mi><mi>p</mi><mi>a</mi><mi>r</mi><mi>s</mi><mo>=</mo><msub><mi>R</mi><mn>0</mn></msub><mo>,</mo><msub><mi>R</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><msub><mi>R</mi><mi>n</mi></msub></math> and
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mo>|</mo><msub><mi>F</mi><mrow><mi>r</mi><mi>i</mi><mi>g</mi><mi>h</mi><mi>t</mi></mrow></msub><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>s</mi><mi>P</mi><mi>a</mi><mi>r</mi><mi>s</mi><mo>|</mo><mo>=</mo><mn>0</mn></math>,<br>
+we say <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>F</mi><mrow><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi></mrow></msub></math> conforms to <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>F</mi><mrow><mi>r</mi><mi>i</mi><mi>g</mi><mi>h</mi><mi>t</mi></mrow></msub></math>,
+written as <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>F</mi><mrow><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi></mrow></msub><mo>&lt;</mo><mi>:</mi><msub><mi>F</mi><mrow><mi>r</mi><mi>i</mi><mi>g</mi><mi>h</mi><mi>t</mi></mrow></msub></math>, if and only if:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>F</mi><mrow><mi>r</mi><mi>i</mi><mi>g</mi><mi>h</mi><mi>t</mi></mrow></msub><mo>.</mo><mi>r</mi><mi>e</mi><mi>t</mi><mi>u</mi><mi>r</mi><mi>n</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>void</mtext></mstyle></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∨</mo><mfenced close=")" open="("><mrow><msub><mi>F</mi><mrow><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi></mrow></msub><mo>.</mo><mi>r</mi><mi>e</mi><mi>t</mi><mi>u</mi><mi>r</mi><mi>n</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>void</mtext></mstyle><mo>∧</mo><msub><mi>F</mi><mrow><mi>r</mi><mi>i</mi><mi>g</mi><mi>h</mi><mi>t</mi></mrow></msub><mo>.</mo><mi>o</mi><mi>p</mi><mi>t</mi></mrow></mfenced></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∨</mo><mrow><mo>(</mo><mrow><msub><mi>F</mi><mrow><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi></mrow></msub><mo>.</mo><mi>r</mi><mi>e</mi><mi>t</mi><mi>u</mi><mi>r</mi><mi>n</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi><mo>&lt;</mo><mi>:</mi><msub><mi>F</mi><mrow><mi>r</mi><mi>i</mi><mi>g</mi><mi>h</mi><mi>t</mi></mrow></msub><mo>.</mo><mi>r</mi><mi>e</mi><mi>t</mi><mi>u</mi><mi>r</mi><mi>n</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi><mo>∧</mo><mo>¬</mo><mfenced close=")" open="("><mrow><msub><mi>F</mi><mrow><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi></mrow></msub><mo>.</mo><mi>o</mi><mi>p</mi><mi>t</mi><mo>∧</mo><mo>¬</mo><msub><mi>F</mi><mrow><mi>r</mi><mi>i</mi><mi>g</mi><mi>h</mi><mi>t</mi></mrow></msub><mo>.</mo><mi>o</mi><mi>p</mi><mi>t</mi></mrow></mfenced><mo>)</mo></mrow></mrow></math></p>
+</li>
+<li>
+<p>if <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>k</mi><mo>≤</mo><mi>n</mi></math>:</p>
+<div class="ulist">
+<ul>
+<li>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∀</mo><mi> </mi><mi>i</mi><mo>,</mo><mn>1</mn><mo>≤</mo><mi>i</mi><mo>≤</mo><mi>k</mi><mi>:</mi><mfenced close=")" open="("><mrow><msub><mi>R</mi><mi>i</mi></msub><mo>.</mo><mi>o</mi><mi>p</mi><mi>t</mi><mo>→</mo><mfenced close=")" open="("><mrow><msub><mi>L</mi><mi>i</mi></msub><mo>.</mo><mi>o</mi><mi>p</mi><mi>t</mi><mo>∨</mo><msub><mi>L</mi><mi>i</mi></msub><mo>.</mo><mi>v</mi><mi>a</mi><mi>r</mi></mrow></mfenced></mrow></mfenced><mo>∧</mo><mfenced close=")" open="("><mrow><msub><mi>R</mi><mi>i</mi></msub><mo>.</mo><mi>v</mi><mi>a</mi><mi>r</mi><mo>→</mo><msub><mi>L</mi><mi>i</mi></msub><mo>.</mo><mi>v</mi><mi>a</mi><mi>r</mi></mrow></mfenced></math></p>
+</li>
+<li>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∀</mo><mi> </mi><mi>i</mi><mo>,</mo><mn>1</mn><mo>≤</mo><mi>i</mi><mo>≤</mo><mi>k</mi><mi>:</mi><msub><mi>L</mi><mi>i</mi></msub><mi>:</mi><mo>&gt;</mo><msub><mi>R</mi><mi>i</mi></msub></math></p>
+</li>
+<li>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>L</mi><mi>k</mi></msub><mo>.</mo><mi>v</mi><mi>a</mi><mi>r</mi><mo>=</mo><mi>t</mi><mi>r</mi><mi>u</mi><mi>e</mi><mo>→</mo><mo>∀</mo><mi> </mi><mi>i</mi><mo>,</mo><mi>k</mi><mo>&lt;</mo><mi>i</mi><mo>≤</mo><mi>n</mi><mi>:</mi><msub><mi>L</mi><mi>K</mi></msub><mi>:</mi><mo>&gt;</mo><msub><mi>R</mi><mi>i</mi></msub></math></p>
+<div class="paragraph">
+<p>else (<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>k</mi><mo>&gt;</mo><mi>n</mi></math>):</p>
+</div>
+</li>
+<li>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∀</mo><mi> </mi><mi>i</mi><mo>,</mo><mn>1</mn><mo>≤</mo><mi>i</mi><mo>≤</mo><mi>n</mi><mi>:</mi><mfenced close=")" open="("><mrow><msub><mi>R</mi><mi>i</mi></msub><mo>.</mo><mi>o</mi><mi>p</mi><mi>t</mi><mo>→</mo><mfenced close=")" open="("><mrow><msub><mi>L</mi><mi>i</mi></msub><mo>.</mo><mi>o</mi><mi>p</mi><mi>t</mi><mo>∨</mo><msub><mi>L</mi><mi>i</mi></msub><mo>.</mo><mi>v</mi><mi>a</mi><mi>r</mi></mrow></mfenced></mrow></mfenced><mo>∧</mo><mfenced close=")" open="("><mrow><msub><mi>R</mi><mi>i</mi></msub><mo>.</mo><mi>v</mi><mi>a</mi><mi>r</mi><mo>→</mo><msub><mi>L</mi><mi>i</mi></msub><mo>.</mo><mi>v</mi><mi>a</mi><mi>r</mi></mrow></mfenced></math></p>
+</li>
+<li>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∀</mo><mi> </mi><mi>i</mi><mo>,</mo><mn>1</mn><mo>≤</mo><mi>i</mi><mo>≤</mo><mi>n</mi><mi>:</mi><msub><mi>L</mi><mi>i</mi></msub><mi>:</mi><mo>&gt;</mo><msub><mi>R</mi><mi>i</mi></msub></math></p>
+</li>
+<li>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∀</mo><mi> </mi><mi>n</mi><mo>&lt;</mo><mi>i</mi><mo>≤</mo><mi>k</mi><mi>:</mi><msub><mi>L</mi><mi>i</mi></msub><mo>.</mo><mi>o</mi><mi>p</mi><mi>t</mi><mo>∨</mo><msub><mi>L</mi><mi>i</mi></msub><mo>.</mo><mi>v</mi><mi>a</mi><mi>r</mi></math></p>
+</li>
+<li>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>R</mi><mi>n</mi></msub><mo>.</mo><mi>v</mi><mi>a</mi><mi>r</mi><mo>=</mo><mi>t</mi><mi>r</mi><mi>u</mi><mi>e</mi><mo>→</mo><mo>∀</mo><mi> </mi><mi>i</mi><mo>,</mo><mi>n</mi><mo>&lt;</mo><mi>i</mi><mo>≤</mo><mi>k</mi><mi>:</mi><msub><mi>L</mi><mi>i</mi></msub><mi>:</mi><mo>&gt;</mo><msub><mi>R</mi><mi>n</mi></msub></math></p>
+</li>
+</ul>
+</div>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p><a href="#cdVarianceFunctionChart">Function Variance Chart</a> shows a simple example with the function type conformance relations.</p>
+</div>
+<div id="cdVarianceFunctionChart" class="imageblock">
+<div class="content">
+<img src="chapters/06_functions/fig/cdVarianceFunctionChart.svg" alt="cdVarianceFunctionChart">
+</div>
+<div class="title">Figure 6. Function Variance Chart</div>
+</div>
+<div class="paragraph">
+<p><code>{function()}</code> <math xmlns="http://www.w3.org/1998/Math/MathML"><mo>&lt;</mo><mi>:</mi></math> <code>{function(A)}</code> <math xmlns="http://www.w3.org/1998/Math/MathML"><mo>&lt;</mo><mi>:</mi></math> <code>{function(A, A)}</code> might be surprising for Java programmers. However, in JavaScript it is
+possible to call a function with any number of arguments independently
+from how many formal parameters the function defines.</p>
+</div>
+<div class="paragraph">
+<p>If a function does not define a return type, <code>any</code> is assumed if at least one
+of the (indirectly) contained return statements contains an expression.
+Otherwise <code>void</code> is assumed. This is also true if there is an error due to
+other constraint violations.</p>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mtable><mtr><mtd><mspace width="3.0mm"/><mfrac><mrow><mi>b</mi><mi>i</mi><mi>n</mi><mi>d</mi><mi>s</mi><mfenced close=")" open="("><mi>f</mi><mi>F</mi></mfenced><mspace width="3.0mm"/><mi>F</mi><mo>.</mo><mi>r</mi><mi>e</mi><mi>t</mi><mi>u</mi><mi>r</mi><mi>n</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>null</mtext></mstyle><mspace width="3.0mm"/><mo>∃</mo><mi>r</mi><mo>∈</mo><mi>r</mi><mi>e</mi><mi>t</mi><mi>u</mi><mi>r</mi><mi>n</mi><mi>s</mi><mfenced close=")" open="("><mi>F</mi></mfenced><mi>:</mi><mi>r</mi><mo>.</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>e</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>o</mi><mi>n</mi><mo>≠</mo><mstyle mathvariant="monospace"><mtext>null</mtext></mstyle></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mi>f</mi><mstyle mathvariant="monospace"><mtext>’(’</mtext></mstyle><mi>a</mi><mi>r</mi><mi>g</mi><mi>l</mi><mi>i</mi><mi>s</mi><mi>t</mi><mi> </mi><mstyle mathvariant="monospace"><mtext>’)’</mtext></mstyle><mi>:</mi><mstyle mathvariant="monospace"><mtext>any</mtext></mstyle></mrow></mfrac></mtd></mtr><mtr><mtd><mspace width="3.0mm"/><mfrac><mrow><mi>b</mi><mi>i</mi><mi>n</mi><mi>d</mi><mi>s</mi><mfenced close=")" open="("><mi>f</mi><mi>F</mi></mfenced><mspace width="3.0mm"/><mi>F</mi><mo>.</mo><mi>r</mi><mi>e</mi><mi>t</mi><mi>u</mi><mi>r</mi><mi>n</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>null</mtext></mstyle><mspace width="3.0mm"/><mo>∀</mo><mi>r</mi><mo>∈</mo><mi>r</mi><mi>e</mi><mi>t</mi><mi>u</mi><mi>r</mi><mi>n</mi><mi>s</mi><mfenced close=")" open="("><mi>F</mi></mfenced><mi>:</mi><mi>r</mi><mo>.</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>e</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>o</mi><mi>n</mi><mo>≠</mo><mstyle mathvariant="monospace"><mtext>null</mtext></mstyle></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mi>f</mi><mstyle mathvariant="monospace"><mtext>’(’</mtext></mstyle><mi>a</mi><mi>r</mi><mi>g</mi><mi>l</mi><mi>i</mi><mi>s</mi><mi>t</mi><mi> </mi><mstyle mathvariant="monospace"><mtext>’)’</mtext></mstyle><mi>:</mi><mstyle mathvariant="monospace"><mtext>void</mtext></mstyle></mrow></mfrac></mtd></mtr></mtable></math>
+</div>
+</div>
+<div class="paragraph">
+<p>with</p>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mtable><mtr><mtd><mspace width="3.0mm"/><mfrac><mrow><mfenced close="}" open="{"><mrow><mi>r</mi><mo>∈</mo><mi>F</mi><mo>.</mo><mi>b</mi><mi>o</mi><mi>d</mi><mi>y</mi><mo>.</mo><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>e</mi><mi>m</mi><mi>e</mi><mi>n</mi><mi>t</mi><mi>s</mi><mo>|</mo><mi>μ</mi><mfenced close=")" open="("><mi>r</mi></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>ReturnStatement</mtext></mstyle></mrow></mfenced><mo>∪</mo><munder><mo>⋃</mo><mrow><mi>s</mi><mo>∈</mo><mi>F</mi><mo>.</mo><mi>b</mi><mi>o</mi><mi>d</mi><mi>y</mi><mo>.</mo><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>e</mi><mi>m</mi><mi>e</mi><mi>n</mi><mi>t</mi><mi>s</mi></mrow></munder><mi>r</mi><mi>e</mi><mi>t</mi><mi>u</mi><mi>r</mi><mi>n</mi><mi>s</mi><mfenced close=")" open="("><mi>s</mi></mfenced></mrow><mrow><mi>r</mi><mi>e</mi><mi>t</mi><mi>u</mi><mi>r</mi><mi>n</mi><mi>s</mi><mfenced close=")" open="("><mi>F</mi></mfenced><mi>:</mi><mi>R</mi><mi>E</mi><mi>T</mi><mi>S</mi></mrow></mfrac></mtd></mtr><mtr><mtd><mspace width="3.0mm"/><mfrac><mrow><mfenced close="}" open="{"><mrow><mi>s</mi><mi>u</mi><mi>b</mi><mo>∈</mo><mi>s</mi><mo>.</mo><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>e</mi><mi>m</mi><mi>e</mi><mi>n</mi><mi>t</mi><mi>s</mi><mo>|</mo><mi>μ</mi><mfenced close=")" open="("><mrow><mi>s</mi><mi>u</mi><mi>b</mi></mrow></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>ReturnStatement</mtext></mstyle></mrow></mfenced><mo>∪</mo><munder><mo>⋃</mo><mrow><mi>s</mi><mi>u</mi><mi>b</mi><mo>∈</mo><mi>s</mi><mo>.</mo><mi>s</mi><mi>t</mi><mi>a</mi><mi>t</mi><mi>e</mi><mi>m</mi><mi>e</mi><mi>n</mi><mi>t</mi><mi>s</mi></mrow></munder><mi>r</mi><mi>e</mi><mi>t</mi><mi>u</mi><mi>r</mi><mi>n</mi><mi>s</mi><mfenced close=")" open="("><mrow><mi>s</mi><mi>u</mi><mi>b</mi></mrow></mfenced></mrow><mrow><mi>r</mi><mi>e</mi><mi>t</mi><mi>u</mi><mi>r</mi><mi>n</mi><mi>s</mi><mfenced close=")" open="("><mi>s</mi></mfenced><mi>:</mi><mi>R</mi><mi>E</mi><mi>T</mi><mi>S</mi></mrow></mfrac></mtd></mtr></mtable></math>
+</div>
+</div>
+</div>
+</div>
+<div class="exampleblock">
+<div class="title">Example 60. Function type conformance</div>
+<div class="content">
+<div class="paragraph">
+<p>The following incomplete snippet demonstrates the usage of two function variables <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>f</mi><mn>1</mn></math> and <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>f</mi><mn>2</mn></math>, in which <math xmlns="http://www.w3.org/1998/Math/MathML"><mrow><mo>[</mo><mspace width="-0.167em"/><mrow><mo>[</mo></mrow></mrow><mrow><mi>f</mi><mn>2</mn></mrow><mrow><mrow><mo>]</mo></mrow><mspace width="-0.167em"/><mo>]</mo></mrow><mo>&lt;</mo><mi>:</mi><mrow><mo>[</mo><mspace width="-0.167em"/><mrow><mo>[</mo></mrow></mrow><mrow><mi>f</mi><mn>1</mn></mrow><mrow><mrow><mo>]</mo></mrow><mspace width="-0.167em"/><mo>]</mo></mrow></math> must hold true according to the aforementioned constraints.
+A function <code>bar</code> declares a parameter <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>f</mi><mn>1</mn></math>, which is actually a function itself.
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>f</mi><mn>2</mn></math> is a variable, to which a function expression is a assigned.
+Function <code>bar</code> is then called with <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>f</mi><mn>2</mn></math> as an argument.
+Thus, the type of <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>f</mi><mn>2</mn></math> must be a subtype of the <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>f</mi><mn>1</mn></math>’s type.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">function bar(f1: {function(A,B):C}) { ... }
+
+var f2: {function(A,B):C} = function(p1,p2){...};
+bar(f1);</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>The type of <code>this</code> can be explicitly set via the <code>@This</code> annotation.</p>
+</div>
+<div class="exampleblock">
+<div class="title">Example 61. Function Subtyping</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">function f(): A {..}
+function p(): void {..}
+
+fAny(log: {function():any}) {...}
+fVoid(f: {function():void}) {..}
+fA(g: {function():A}) {...}
+
+fAny(f);    // --&gt; ok       A &lt;: any
+fVoid(f);   // --&gt;error     A !&lt;: void
+fA(f);      // --&gt; ok (easy)    A &lt;: A
+
+fAny(p);    // --&gt; ok       void &lt;: any
+fVoid(p);   // --&gt; ok       void &lt;: void
+fA(p);      // --&gt; error    void !&lt;: A</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="exampleblock">
+<div class="title">Example 62. Subtyping with function types</div>
+<div class="content">
+<div class="paragraph">
+<p>If classes A, B, and C are defined as previously mentioned, i.e. <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>C</mi><mo>&lt;</mo><mi>:</mi><mi>B</mi><mo>&lt;</mo><mi>:</mi><mi>A</mi></math>, then
+the following subtyping relations with function types are to be evaluated as follows:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">       {function(B):B} &lt;: {function(B):B}           -&gt; true
+        {function():A} &lt;: {function():B}            -&gt; false
+        {function():C} &lt;: {function():B}            -&gt; true
+         {function(A)} &lt;: {function(B)}             -&gt; true
+         {function(C)} &lt;: {function(B)}             -&gt; false
+
+     {function():void} &lt;: {function():void}         -&gt; true
+{function():undefined} &lt;: {function():void}         -&gt; true
+     {function():void} &lt;: {function():undefined}    -&gt; true (!)
+
+        {function():B} &lt;: {function():void}         -&gt; true (!)
+        {function():B} &lt;: {function():undefined}    -&gt; false (!)
+     {function():void} &lt;: {function():B}            -&gt; false
+{function():undefined} &lt;: {function():B}            -&gt; true</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>The following examples demonstrate the effect of optional and variadic parameters:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">{function(A)} &lt;: {function(B)}                      -&gt; true
+{function(A...)} &lt;: {function(A)}                   -&gt; true
+{function(A, A)} &lt;: {function(A)}                   -&gt; false
+{function(A)} &lt;: {function(A,A)}                    -&gt; true (!)
+{function(A, A...)} &lt;: {function(A)}                -&gt; true
+{function(A)} &lt;: {function(A,A...)}                 -&gt; true (!)
+{function(A, A...)} &lt;: {function(B)}                -&gt; true
+{function(A?)} &lt;: {function(A?)}                    -&gt; true
+{function(A...)} &lt;: {function(A...)}                -&gt; true
+{function(A?)} &lt;: {function(A)}                     -&gt; true
+{function(A)} &lt;: {function(A?)}                     -&gt; false
+{function(A...)} &lt;: {function(A?)}                  -&gt; true
+{function(A?)} &lt;: {function(A...)}                  -&gt; true (!)
+{function(A,A...)} &lt;: {function(A...)}              -&gt; false
+{function(A,A?)} &lt;: {function(A...)}                -&gt; false
+{function(A?,A...)} &lt;: {function(A...)}             -&gt; true
+{function(A...)} &lt;: {function(A?,A...)}             -&gt; true
+{function(A...)} &lt;: {function(A?)}                  -&gt; true
+{function(A?,A?)} &lt;: {function(A...)}               -&gt; true (!)
+{function(A?,A?,A?)} &lt;: {function(A...)}            -&gt; true (!)
+{function(A?)} &lt;: {function()}                      -&gt; true (!)
+{function(A...)} &lt;: {function()}                    -&gt; true (!)</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>The following examples demonstrate the effect of optional return types:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">{function():void} &lt;: {function():void}              -&gt; true
+{function():X}    &lt;: {function():void}              -&gt; true
+{function():X?}   &lt;: {function():void}              -&gt; true
+{function():void} &lt;: {function():Y}                 -&gt; false
+{function():X}    &lt;: {function():Y}                 -&gt; X &lt;: Y
+{function():X?}   &lt;: {function():Y}                 -&gt; false (!)
+{function():void} &lt;: {function():Y?}                -&gt; true (!)
+{function():X}    &lt;: {function():Y?}                -&gt; X &lt;: Y
+{function():X?}   &lt;: {function():Y?}                -&gt; X &lt;: Y
+       {function():B?} &lt;: {function():undefined}    -&gt; false (!)
+{function():undefined} &lt;: {function():B?}           -&gt; true</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>The following examples show the effect of the <code>@This</code> annotation:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">{@This(A) function():void} &lt;: {@This(X) function():void}    -&gt; false
+{@This(B) function():void} &lt;: {@This(A) function():void}    -&gt; false
+{@This(A) function():void} &lt;: {@This(B) function():void}    -&gt; true
+{@This(any) function():void} &lt;: {@This(X) function():void}  -&gt; true
+{function():void} &lt;: {@This(X) function():void}             -&gt; true
+{@This(A) function():void} &lt;: {@This(any) function():void}  -&gt; false
+{@This(A) function():void} &lt;: {function():void}             -&gt; false</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="openblock definition">
+<div class="content">
+<div class="paragraph">
+<p><a id="function_type_conformance"></a><strong>Definition:</strong> <a href="#function_type_conformance">Function Type Conformance</a></p>
+</div>
+<div class="paragraph">
+<p>For the given function types<br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>F</mi><mrow><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi></mrow></msub></math> with
+<math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>F</mi><mrow><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi></mrow></msub><mo>.</mo><mi>t</mi><mi>f</mi><mi>p</mi><mi>a</mi><mi>r</mi><mi>s</mi><mo>=</mo><msub><mi>L</mi><mn>0</mn></msub><mo>,</mo><msub><mi>L</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><msub><mi>L</mi><mi>k</mi></msub></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>F</mi><mrow><mi>r</mi><mi>i</mi><mi>g</mi><mi>h</mi><mi>t</mi></mrow></msub></math> with
+<math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>F</mi><mrow><mi>r</mi><mi>i</mi><mi>g</mi><mi>h</mi><mi>t</mi></mrow></msub><mo>.</mo><mi>t</mi><mi>f</mi><mi>p</mi><mi>a</mi><mi>r</mi><mi>s</mi><mo>=</mo><msub><mi>R</mi><mn>0</mn></msub><mo>,</mo><msub><mi>R</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><msub><mi>R</mi><mi>n</mi></msub></math>,<br>
+we say <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>F</mi><mrow><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi></mrow></msub></math> conforms to <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>F</mi><mrow><mi>r</mi><mi>i</mi><mi>g</mi><mi>h</mi><mi>t</mi></mrow></msub></math>, written as <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>F</mi><mrow><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi></mrow></msub><mo>&lt;</mo><mi>:</mi><msub><mi>F</mi><mrow><mi>r</mi><mi>i</mi><mi>g</mi><mi>h</mi><mi>t</mi></mrow></msub></math>, if and only if:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>if <math xmlns="http://www.w3.org/1998/Math/MathML"><mo>|</mo><msub><mi>F</mi><mrow><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi></mrow></msub><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>P</mi><mi>a</mi><mi>r</mi><mi>s</mi><mo>|</mo><mo>=</mo><mo>|</mo><msub><mi>F</mi><mrow><mi>r</mi><mi>i</mi><mi>g</mi><mi>h</mi><mi>t</mi></mrow></msub><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>P</mi><mi>a</mi><mi>r</mi><mi>s</mi><mo>|</mo><mo>=</mo><mn>0</mn></math>:</p>
+<div class="ulist">
+<ul>
+<li>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>F</mi><mrow><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi></mrow></msub><mo>&lt;</mo><mi>:</mi><msub><mi>F</mi><mrow><mi>r</mi><mi>i</mi><mi>g</mi><mi>h</mi><mi>t</mi></mrow></msub></math>
+(cf. <a href="#function_type_conformance_non_parameterized">Function Type Conformance Non-Parameterized</a>)</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>else if<br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mo>|</mo><msub><mi>F</mi><mrow><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi></mrow></msub><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>P</mi><mi>a</mi><mi>r</mi><mi>s</mi><mo>|</mo><mo>&gt;</mo><mn>0</mn><mo>∧</mo><mo>|</mo><msub><mi>F</mi><mrow><mi>r</mi><mi>i</mi><mi>g</mi><mi>h</mi><mi>t</mi></mrow></msub><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>P</mi><mi>a</mi><mi>r</mi><mi>s</mi><mo>|</mo><mo>=</mo><mn>0</mn></math>:</p>
+<div class="ulist">
+<ul>
+<li>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∃</mo><mi>θ</mi><mi>:</mi><mfenced close=")" open="("><mrow><mi>Γ</mi><mo>←</mo><mi>θ</mi></mrow></mfenced><mo>⊢</mo><msub><mi>F</mi><mrow><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi></mrow></msub><mo>&lt;</mo><mi>:</mi><msub><mi>F</mi><mrow><mi>r</mi><mi>i</mi><mi>g</mi><mi>h</mi><mi>t</mi></mrow></msub></math> (cf. <a href="#function_type_conformance_non_parameterized">Function Type Conformance Non-Parameterized</a> )</p>
+<div class="paragraph">
+<p>(i.e. there exists a substitution <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>θ</mi></math> of type variables in <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>F</mi><mrow><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi></mrow></msub></math> so that after substitution it becomes a subtype of <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>F</mi><mrow><mi>r</mi><mi>i</mi><mi>g</mi><mi>h</mi><mi>t</mi></mrow></msub></math> as defined by <a href="#function_type_conformance_non_parameterized">Function Type Conformance Non-Parameterized</a>)</p>
+</div>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>else if <math xmlns="http://www.w3.org/1998/Math/MathML"><mo>|</mo><msub><mi>F</mi><mrow><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi></mrow></msub><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>P</mi><mi>a</mi><mi>r</mi><mi>s</mi><mo>|</mo><mo>=</mo><mo>|</mo><msub><mi>F</mi><mrow><mi>r</mi><mi>i</mi><mi>g</mi><mi>h</mi><mi>t</mi></mrow></msub><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>P</mi><mi>a</mi><mi>r</mi><mi>s</mi><mo>|</mo></math>:</p>
+<div class="ulist">
+<ul>
+<li>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>Γ</mi><mo>←</mo><mfenced close="}" open="{"><mrow><msubsup><mi>V</mi><mi>i</mi><mi>r</mi></msubsup><mo>←</mo><msubsup><mi>V</mi><mi>i</mi><mi>l</mi></msubsup><mo>|</mo><mn>0</mn><mo>≤</mo><mi>i</mi><mo>≤</mo><mi>n</mi></mrow></mfenced><mo>⊢</mo><msub><mi>F</mi><mrow><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi></mrow></msub><mo>&lt;</mo><mi>:</mi><msub><mi>F</mi><mrow><mi>r</mi><mi>i</mi><mi>g</mi><mi>h</mi><mi>t</mi></mrow></msub></math>
+( accordingly)</p>
+</li>
+<li>
+<p>-</p>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mtable><mtr><mtd><mo>∀</mo><mn>0</mn><mo>≤</mo><mi>i</mi><mo>≤</mo><mi>n</mi><mi>:</mi></mtd></mtr><mtr><mtd><mi>i</mi><mi>n</mi><mi>t</mi><mi>e</mi><mi>r</mi><mi>s</mi><mi>e</mi><mi>c</mi><mi>t</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><msubsup><mi>V</mi><mi>i</mi><mi>l</mi></msubsup><mo>.</mo><mstyle mathvariant="italic"><mi>u</mi><mi>p</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>B</mi><mi>o</mi><mi>u</mi><mi>n</mi><mi>d</mi><mi>s</mi></mstyle></mrow></mfenced><mi>:</mi><mo>&gt;</mo><mi>i</mi><mi>n</mi><mi>t</mi><mi>e</mi><mi>r</mi><mi>s</mi><mi>e</mi><mi>c</mi><mi>t</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><msubsup><mi>V</mi><mi>i</mi><mi>r</mi></msubsup><mo>.</mo><mstyle mathvariant="italic"><mi>u</mi><mi>p</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>B</mi><mi>o</mi><mi>u</mi><mi>n</mi><mi>d</mi><mi>s</mi></mstyle></mrow></mfenced></mtd></mtr></mtable></math>
+</div>
+</div>
+<div class="paragraph">
+<p>with <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>F</mi><mrow><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi></mrow></msub><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>P</mi><mi>a</mi><mi>r</mi><mi>s</mi><mo>=</mo><msubsup><mi>V</mi><mn>0</mn><mi>l</mi></msubsup><mo>,</mo><msubsup><mi>V</mi><mn>1</mn><mi>l</mi></msubsup><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><msubsup><mi>V</mi><mi>n</mi><mi>l</mi></msubsup></math> and <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>F</mi><mrow><mi>r</mi><mi>i</mi><mi>g</mi><mi>h</mi><mi>t</mi></mrow></msub><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>P</mi><mi>a</mi><mi>r</mi><mi>s</mi><mo>=</mo><msubsup><mi>V</mi><mn>0</mn><mi>r</mi></msubsup><mo>,</mo><msubsup><mi>V</mi><mn>1</mn><mi>r</mi></msubsup><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><msubsup><mi>V</mi><mi>n</mi><mi>r</mi></msubsup></math><br>
+(i.e. we replace each type variable in <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>F</mi><mrow><mi>r</mi><mi>i</mi><mi>g</mi><mi>h</mi><mi>t</mi></mrow></msub></math> by the corresponding type variable at the same index in <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>F</mi><mrow><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi></mrow></msub></math>
+and check the constraints from <a href="#function_type_conformance_non_parameterized">Function Type Conformance Non-Parameterized</a>  as if <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>F</mi><mrow><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi></mrow></msub></math> and <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>F</mi><mrow><mi>r</mi><mi>i</mi><mi>g</mi><mi>h</mi><mi>t</mi></mrow></msub></math> were non-parameterized functions and, in
+addition, the upper bounds on the left side need to be supertypes of the upper bounds on the right side).</p>
+</div>
+</li>
+</ul>
+</div>
+</li>
+</ul>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Note that the upper bounds on the left must be supertypes of the right-side upper bounds (for similar reasons why types of formal parameters on the left are
+required to be supertypes of the formal parameters’ types in ).
+Where a particular type variable is used, on co- or contra-variant position, is not relevant:</p>
+</div>
+<div class="exampleblock">
+<div class="title">Example 63. Bounded type variable at co-variant position in function type</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">class A {}
+class B extends A {}
+
+class X {
+    &lt;T extends B&gt; m(): T { return null; }
+}
+class Y extends X {
+    @Override
+    &lt;T extends A&gt; m(): T { return null; }
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Method <code>m</code> in <code>Y</code> may return an <code>A</code>, thus breaking the contract of m in <code>X</code>, but only if it is parameterized to do so, which is not allowed for clients of <code>X</code>, only those of <code>Y</code>.
+Therefore, the override in the above example is valid.</p>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>The subtype relation for function types is also applied for method overriding to ensure that an overriding method’s signature conforms to that of the overridden method,
+see <a href="classifiers.html#Req-IDE-72">[Req-IDE-72]</a> (applies to method comnsumption and implementation accordingly, see <a href="classifiers.html#Req-IDE-73">[Req-IDE-73]</a> and <a href="classifiers.html#Req-IDE-74">[Req-IDE-74]</a>).
+Note that this is very different from Java which is far more restrictive when checking overriding methods.
+As Java also supports method overloading: given two types <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>A</mi><mo>,</mo><mi>B</mi></math> with <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>B</mi><mo>&lt;</mo><mi>:</mi><mi>A</mi></math> and a super class method <code>void m(B param)</code>, it is valid to override <code>m</code> as <code>void m(A param)</code> in N4JS but not in Java.
+In Java this would be handled as method overloading and therefore an <code>@Override</code> annotation on <code>m</code> would produce an error.</p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-80"></a><strong>Req. IDE-80:</strong> <a href="#Req-IDE-80">Upper and Lower Bound of a Function Type</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>The upper bound of a function type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>F</mi></math> is a function type with the lower bound types of the parameters and the upper bound of the return type:<br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>u</mi><mi>p</mi><mi>p</mi><mi>e</mi><mi>r</mi><mfenced close=")" open="("><mrow><mstyle mathvariant="monospace"><mtext>function</mtext></mstyle><mfenced close=")" open="("><msub><mi>P</mi><mn>1</mn></msub><mrow><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/></mrow><msub><mi>P</mi><mi>n</mi></msub></mfenced><mi>:</mi><mi>R</mi></mrow></mfenced><mi>:</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>function</mtext></mstyle><mfenced close=")" open="("><mrow><mi>l</mi><mi>o</mi><mi>w</mi><mi>e</mi><mi>r</mi><mfenced close=")" open="("><msub><mi>P</mi><mn>1</mn></msub></mfenced></mrow><mrow><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/></mrow><mrow><mi>l</mi><mi>o</mi><mi>w</mi><mi>e</mi><mi>r</mi><mfenced close=")" open="("><msub><mi>P</mi><mi>n</mi></msub></mfenced></mrow></mfenced><mi>:</mi><mi>u</mi><mi>p</mi><mi>p</mi><mi>e</mi><mi>r</mi><mfenced close=")" open="("><mi>R</mi></mfenced></math></p>
+</div>
+<div class="paragraph">
+<p>The lower bound of a function type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>F</mi></math> is a function type with the upper bound types of the parameters and the lower bound of the return type:<br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>l</mi><mi>o</mi><mi>w</mi><mi>e</mi><mi>r</mi><mfenced close=")" open="("><mrow><mstyle mathvariant="monospace"><mtext>function</mtext></mstyle><mfenced close=")" open="("><msub><mi>P</mi><mn>1</mn></msub><mrow><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/></mrow><msub><mi>P</mi><mi>n</mi></msub></mfenced><mi>:</mi><mi>R</mi></mrow></mfenced><mi>:</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>function</mtext></mstyle><mfenced close=")" open="("><mrow><mi>u</mi><mi>p</mi><mi>p</mi><mi>e</mi><mi>r</mi><mfenced close=")" open="("><msub><mi>P</mi><mn>1</mn></msub></mfenced></mrow><mrow><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/></mrow><mrow><mi>u</mi><mi>p</mi><mi>p</mi><mi>e</mi><mi>r</mi><mfenced close=")" open="("><msub><mi>P</mi><mi>n</mi></msub></mfenced></mrow></mfenced><mi>:</mi><mi>l</mi><mi>o</mi><mi>w</mi><mi>e</mi><mi>r</mi><mfenced close=")" open="("><mi>R</mi></mfenced></math></p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_autoboxing-of-function-type"><a class="anchor" href="#_autoboxing-of-function-type"></a><a class="link" href="#_autoboxing-of-function-type">6.1.3. Autoboxing of Function Type</a></h4>
+<div class="paragraph">
+<p>Function types, compared to other types like String, come only in on flavour: the Function object representation.
+There is no primitive function type.
+Nevertheless, for function type expressions and function declarations, it is possible to call the properties of Function object directly.
+This is similar to autoboxing for strings.</p>
+</div>
+<div class="listingblock">
+<div class="title">Access of Function properties on functions</div>
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">// function declaration
+var param: number = function(a,b){}.length // 2
+
+function a(x: number) : number { return x*x; }
+// function reference
+a.length; // 1
+
+// function variable
+var f = function(m,l,b){/*...*/};
+f.length; // 3
+
+class A {
+    s: string;
+    sayS(): string{ return this.s; }
+}
+
+var objA: A = new A();
+objA.s = "A";
+
+var objB = {s:"B"}
+
+// function variable
+var m = objA.sayS; // method as function, detached from objA
+var mA: {function(any)} = m.bind(objA); // bind to objA
+var mB: {function(any)} = m.bind(objB); // bind to objB
+
+m()  // returns: undefined
+mA() // returns: A
+mB() // returns: B
+
+m.call(objA,1,2,3);  // returns: A
+m.apply(objB,[1,2,3]); // returns: B
+m.toString(); // returns: function sayS(){ return this.s; }</code></pre>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_arguments-object"><a class="anchor" href="#_arguments-object"></a><a class="link" href="#_arguments-object">6.1.4. Arguments Object</a></h4>
+<div class="paragraph">
+<p>A special arguments object is defined within the body of a function.
+It is accessible through the implicitly-defined local variable named ,
+unless it is shadowed by a local variable, a formal parameter or a
+function named <code>arguments</code> or in the rare case that the function itself is called ’arguments’ [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.S10.5, p.p.59)</a>].
+The argument object has array-like behavior even though it is not of type <code>array</code>:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>All actual passed-in parameters of the current execution context can be retrieved by <math xmlns="http://www.w3.org/1998/Math/MathML"><mn>0</mn><mo>-</mo><mi>b</mi><mi>a</mi><mi>s</mi><mi>e</mi><mi>d</mi></math> index access.</p>
+</li>
+<li>
+<p>The <code>length</code> property of the arguments object stores the actual number of passed-in arguments which may differ from the number of formally defined number of parameters <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>f</mi><mi>p</mi><mi>a</mi><mi>r</mi><mi>s</mi></math> of the containing function.</p>
+</li>
+<li>
+<p>It is possible to store custom values in the arguments object, even outside the original index boundaries.</p>
+</li>
+<li>
+<p>All obtained values from the arguments object are of type <code>any</code>.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>In non-strict ES mode the <code>callee</code> property holds a reference to the function executed [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.S10.6, p.p.61)</a>].</p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-81"></a><strong>Req. IDE-81:</strong> <a href="#Req-IDE-81">Arguments.callee</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>In N4JS and in ES strict mode the use of <code>arguments.callee</code> is prohibited.</p>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-82"></a><strong>Req. IDE-82:</strong> <a href="#Req-IDE-82">Arguments as formal parameter name</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>In N4JS, the formal parameters of the function cannot be named <code>arguments</code>.
+This applies to all variable execution environments like field accessors (getter/setter, <a href="classifiers.html#_field-accessors-getter-setter">Field Accessors (Getter/Setter)</a>),
+methods (<a href="classifiers.html#_methods">Methods</a>) and constructors (<a href="types.html#_constructor-and-classifier-type">Constructor and Classifier Type</a>), where <code>FormalParameter</code> type is used.</p>
+</div>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">// regular function
+function a1(s1: string, n2: number) {
+    var l: number = arguments.length;
+    var s: string = arguments[0] as string;
+}
+
+class A {
+    // property access
+    get s(): string { return ""+arguments.length; } // 0
+    set s(n: number) { console.log( arguments.length ); }  // 1
+    // method
+    m(arg: string) {
+        var l: number = arguments.length;
+        var s: string = arguments[0]  as string;
+    }
+}
+
+// property access in object literals
+var x = {
+    a:5,
+    get b(): string {
+        return ""+arguments.length
+    }
+}
+
+// invalid:
+function z(){
+    arguments.length // illegal, see next lines
+    // define arguments to be a plain variable of type number:
+    var arguments: number = 4;
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="_ecmascript-5-function-definition"><a class="anchor" href="#_ecmascript-5-function-definition"></a><a class="link" href="#_ecmascript-5-function-definition">6.2. ECMAScript 5 Function Definition</a></h3>
+<div class="sect3">
+<h4 id="_function-declaration"><a class="anchor" href="#_function-declaration"></a><a class="link" href="#_function-declaration">6.2.1. Function Declaration</a></h4>
+<div class="sect4">
+<h5 id="_syntax-9"><a class="anchor" href="#_syntax-9"></a><a class="link" href="#_syntax-9">6.2.1.1. Syntax</a></h5>
+<div class="paragraph">
+<p>A function can be defined as described in [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.S13, p.p.98)</a>] and additional annotations can be specified.
+Since N4JS is based on [<a href="appendix_c_bibliography.html#ECMA15a">ECMA15a</a>], the syntax contains constructs not available in [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a</a>].
+The newer constructs defined only in [<a href="appendix_c_bibliography.html#ECMA15a">ECMA15a</a>] and proposals already implemented in N4JS are described in <a href="#_ecmascript-2015-function-definition">ECMAScript 2015 Function Definition</a> and <a href="#_ecmascript-proposals-function-definition">ECMAScript Proposals Function Definition</a>.</p>
+</div>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title=""></i>
+</td>
+<td class="content">
+In contrast to plain JavaScript, function declarations can be used in blocks in N4JS.
+This is only true, however, for N4JS files, not for plain JS files.
+</td>
+</tr>
+</table>
+</div>
+<div class="listingblock">
+<div class="title">Syntax Function Declaration and Expression</div>
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">FunctionDeclaration &lt;Yield&gt;:
+    =&gt; ({FunctionDeclaration}
+        annotations+=Annotation*
+        (declaredModifiers+=N4Modifier)*
+        -&gt; FunctionImpl &lt;Yield,Yield,Expression=false&gt;
+    ) =&gt; Semi?
+;
+
+
+fragment AsyncNoTrailingLineBreak *: (declaredAsync?='async' NoLineTerminator)?;
+
+fragment FunctionImpl&lt;Yield, YieldIfGenerator, Expression&gt;*:
+    'function'
+    (
+        generator?='*' FunctionHeader&lt;YieldIfGenerator,Generator=true&gt; FunctionBody&lt;Yield=true,Expression&gt;
+    |   FunctionHeader&lt;Yield,Generator=false&gt; FunctionBody&lt;Yield=false,Expression&gt;
+    )
+;
+
+fragment FunctionHeader&lt;Yield, Generator&gt;*:
+    TypeVariables?
+    name=BindingIdentifier&lt;Yield&gt;?
+    StrictFormalParameters&lt;Yield=Generator&gt;
+    (-&gt; ':' returnTypeRef=TypeRef)?
+;
+
+fragment FunctionBody &lt;Yield, Expression&gt;*:
+        &lt;Expression&gt; body=Block&lt;Yield&gt;
+    |   &lt;!Expression&gt; body=Block&lt;Yield&gt;?
+;</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Properties of the function declaration and expression are described in <a href="#_function-type">Function Type</a>.</p>
+</div>
+<div class="paragraph">
+<p>For this specification, we introduce a supertype <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>F</mi><mi>u</mi><mi>n</mi><mi>c</mi><mi>t</mi><mi>i</mi><mi>o</mi><mi>n</mi><mi>D</mi><mi>e</mi><mi>f</mi><mi>i</mi><mi>n</mi><mi>i</mi><mi>t</mi><mi>i</mi><mi>o</mi><mi>n</mi></math> for both, <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>F</mi><mi>u</mi><mi>n</mi><mi>c</mi><mi>t</mi><mi>i</mi><mi>o</mi><mi>n</mi><mi>D</mi><mi>e</mi><mi>c</mi><mi>l</mi><mi>a</mi><mi>r</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>o</mi><mi>n</mi></math> and <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>F</mi><mi>u</mi><mi>n</mi><mi>c</mi><mi>t</mi><mi>i</mi><mi>o</mi><mi>n</mi><mi>E</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>e</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>o</mi><mi>n</mi></math>.
+This supertype contains all common properties of these two subtypes, that is, all properties of <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>F</mi><mi>u</mi><mi>n</mi><mi>c</mi><mi>t</mi><mi>i</mi><mi>o</mi><mi>n</mi><mi>E</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>e</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>o</mi><mi>n</mi></math>.</p>
+</div>
+<div class="exampleblock">
+<div class="title">Example 64. Function Declaration with Type Annotation</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">// plain JS
+function f(p) { return p.length }
+// N4JS
+function f(p: string): number { return p.length }</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_semantics-8"><a class="anchor" href="#_semantics-8"></a><a class="link" href="#_semantics-8">6.2.1.2. Semantics</a></h5>
+<div class="paragraph">
+<p>A function defined in a class’s method (or method modifier) builder is a method, see <a href="classifiers.html#_methods">Methods</a> for details and additional constraints.
+The metatype of a function definition is function type (<a href="#_function-type">Function Type</a>), as a function declaration is only a different syntax for creating a <code>Function</code> object.
+Constraints for function type are described in <a href="#_function-type">Function Type</a>.
+Another consequence is that the inferred type of a function definition <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>f</mi><mi>d</mi><mi>e</mi><mi>c</mi><mi>l</mi></math> is simply its function type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>F</mi></math>.</p>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><mrow><mo>[</mo><mspace width="-0.167em"/><mrow><mo>[</mo></mrow></mrow><mrow><mi>f</mi><mi>d</mi><mi>e</mi><mi>c</mi><mi>l</mi></mrow><mrow><mrow><mo>]</mo></mrow><mspace width="-0.167em"/><mo>]</mo></mrow></mrow><mrow><mrow><mo>[</mo><mspace width="-0.167em"/><mrow><mo>[</mo></mrow></mrow><mi>F</mi><mrow><mrow><mo>]</mo></mrow><mspace width="-0.167em"/><mo>]</mo></mrow></mrow></mfrac></math>
+</div>
+</div>
+<div class="paragraph">
+<p>Note that the type of a function definition is different from its return type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>f</mi><mo>.</mo><mi>d</mi><mi>e</mi><mi>c</mi><mi>l</mi></math>!</p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-83"></a><strong>Req. IDE-83:</strong> <a href="#Req-IDE-83">Function Declaration only on Top-Level</a> (ver. 1)</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>In plain JavaScript, function declarations must only be located on top-level, that is they must not be nested in blocks.
+Since this is supported by most JavaScript engines, only a warning is issued.</p>
+</li>
+</ol>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_function-expression"><a class="anchor" href="#_function-expression"></a><a class="link" href="#_function-expression">6.2.2. Function Expression</a></h4>
+<div class="paragraph">
+<p>A function expression [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.S11.2.5)</a>] is quite similar to a function declaration.
+Thus, most details are explained in <a href="#_ecmascript-5-function-definition">ECMAScript 5 Function Definition</a>.</p>
+</div>
+<div class="sect4">
+<h5 id="function-expression-syntax"><a class="anchor" href="#function-expression-syntax"></a><a class="link" href="#function-expression-syntax">6.2.2.1. Syntax</a></h5>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">FunctionExpression:
+         ({FunctionExpression}
+            FunctionImpl&lt;Yield=false,YieldIfGenerator=true,Expression=true&gt;
+         )
+;</code></pre>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_semantics-and-type-inference"><a class="anchor" href="#_semantics-and-type-inference"></a><a class="link" href="#_semantics-and-type-inference">6.2.2.2. Semantics and Type Inference</a></h5>
+<div class="paragraph">
+<p>In general, the inferred type of a function expression simply is the function type as described in <a href="#_function-type">Function Type</a>.
+Often, the signature of a function expression is not explicitly specified but it can be inferred from the context.
+The following context information is used to infer the full signature:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>If the function expression is used on the right hand side of an assignment, the expected return type can be inferred from the left hand side.</p>
+</li>
+<li>
+<p>If the function expression is used as an argument in a call to another function, the full signature can be inferred from the corresponding type of the formal parameter declaration.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Although the signature of the function expression may be inferred from the formal parameter if the function expression is used as argument, this inference has some conceptual limitations.
+This is demonstrated in the next example.</p>
+</div>
+<div class="exampleblock">
+<div class="title">Example 65. Inference Of Function Expression’s Signature</div>
+<div class="content">
+<div class="paragraph">
+<p>In general, <code>{function():any}</code> is a subtype of <code>{function():void}</code> (cf. <a href="#_function-type">Function Type</a>).
+When the return type of a function expression is inferred, this relation is taken into account which may lead to unexpected results as shown in the following code snippet:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">function f(cb: {function():void}) { cb() }
+f(function() { return 1; });</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>No error is issued: The type of the function expression actually is inferred to <code>{function():any}</code>, because there is a return statement with an expression.
+It is not inferred to <code>{function():void}</code>, even if the formal parameter of <code>f</code> suggests that.
+Due to the previously-stated relation <code>{function():any} &lt;: {function():void}</code> this is correct – the client (in this
+case function <code>f</code>) works perfectly well even if <code>cb</code> returns something.
+The contract of arguments states that the type of the argument is a subtype of the type of the formal parameter.
+This is what the inferencer takes into account!</p>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="_ecmascript-2015-function-definition"><a class="anchor" href="#_ecmascript-2015-function-definition"></a><a class="link" href="#_ecmascript-2015-function-definition">6.3. ECMAScript 2015 Function Definition</a></h3>
+<div class="sect3">
+<h4 id="_formal-parameters"><a class="anchor" href="#_formal-parameters"></a><a class="link" href="#_formal-parameters">6.3.1. Formal Parameters</a></h4>
+<div class="paragraph">
+<p>Parameter handling has been significantly upgraded in ECMAScript 6.
+It now supports parameter default values, rest parameters (variadics) and destructuring.
+Formal parameters can be modified to be either default or variadic.
+In case a formal parameter has no modifier, it is called normal.
+Modified parameters also become optional.</p>
+</div>
+<div class="paragraph">
+<p>Modifiers of formal parameters such as default or rest are neither evaluated nor rewritten in the transpiler.</p>
+</div>
+<div class="sect4">
+<h5 id="Type_Modifiers_Optional"><a class="anchor" href="#Type_Modifiers_Optional"></a><a class="link" href="#Type_Modifiers_Optional">6.3.1.1. Optional Parameters</a></h5>
+<div class="paragraph">
+<p>An optional formal parameter can be omitted when calling a function/method.
+An omitted parameter has the value <code>undefined</code>.
+In case the omitted parameter is variadic, the value is an empty array.</p>
+</div>
+<div class="paragraph">
+<p>Parameters can not be declared as optional explicitly.
+Instead, being optional is true when a parameter is declared as default or variadic.
+Note that any formal parameter that follows a default parameter is itself also a default thus an optional parameter.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="Type_Modifiers_Default"><a class="anchor" href="#Type_Modifiers_Default"></a><a class="link" href="#Type_Modifiers_Default">6.3.1.2. Default Parameters</a></h5>
+<div class="paragraph">
+<p>A default parameter value is specified for a parameter via an equals sign (<code>=</code>).
+If a caller doesn’t provide a value for the parameter, the default value is used.</p>
+</div>
+<div class="paragraph">
+<p>Default initializers of parameters are specified at a formal parameter of a function or method after the equal sign using an arbitrary initializer expression, such as <code>var = "s"</code>.
+However, this default initializer can be omitted.
+When a formal parameter has a declared type, the default initializer is specified at the end, such as: <code>var : string = "s"</code>.
+The initializer expression is only evaluated in case no actual argument is given for the formal parameter.
+Also, the initializer expression is evaluated when the actual argument value is <code>undefined</code>.</p>
+</div>
+<div class="paragraph">
+<p>Formal parameters become default parameters implicitly when they are preceded by an explicit default parameter.
+In such cases, the default initializer is <code>undefined</code>.</p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-14501"></a><strong>Req. IDE-14501:</strong> <a href="#Req-IDE-14501">Default parameters</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>Any normal parameter which is preceded by a default parameter also becomes a default parameter.
+Its initializer is <code>undefined</code>.</p>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>When a method is overwritten, its default parameters are not part of the overwriting method.
+Consequently, initializers of default parameters in abstract methods are obsolete.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="Type_Modifiers_Variadic"><a class="anchor" href="#Type_Modifiers_Variadic"></a><a class="link" href="#Type_Modifiers_Variadic">6.3.1.3. Variadic</a></h5>
+<div class="paragraph">
+<p>Variadic parameters are also called <em>rest parameters</em>.
+Marking a parameter as variadic indicates that method accepts a variable number of parameters.
+A variadic parameter implies that the parameter is also optional as the cardinality is defined as <math xmlns="http://www.w3.org/1998/Math/MathML"><mfenced close="]" open="["><mrow><mn>0.</mn><mo>.</mo><mo>*</mo></mrow></mfenced></math>.
+No further parameter can be defined after a variadic parameter.
+When no argument is given for a variadic parameter, an empty array is provided when using the parameter in the body of the function or method.</p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-16"></a><strong>Req. IDE-16:</strong> <a href="#Req-IDE-16">Variadic and optional parameters</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>For a parameter <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>p</mi></math>, the following condition must hold:
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>p</mi><mo>.</mo><mi>v</mi><mi>a</mi><mi>r</mi><mo>→</mo><mi>p</mi><mo>.</mo><mi>o</mi><mi>p</mi><mi>t</mi></math>.</p>
+</div>
+<div class="paragraph">
+<p>A parameter can not be declared both variadic and with a default value.
+That is to say that one can either write <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>v</mi><mi>a</mi><mi>r</mi><mi>N</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo></math> (default) or <math xmlns="http://www.w3.org/1998/Math/MathML"><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mi>v</mi><mi>a</mi><mi>r</mi><mi>N</mi><mi>a</mi><mi>m</mi><mi>e</mi></math>, but not <math xmlns="http://www.w3.org/1998/Math/MathML"><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mi>v</mi><mi>a</mi><mi>r</mi><mi>N</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo></math>.</p>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Declaring a variadic parameter of type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi></math> causes the type of the method parameter to become <code>Array&lt;T&gt;</code>.
+That is, declaring <code>function(&#8230;&#8203;tags : string)</code> causes <code>tags</code> to be an <code>Array&lt;string&gt;</code> and not just a scalar <code>string</code> value.</p>
+</div>
+<div class="paragraph">
+<p>To make this work at runtime, the compiler will generate code that constructs the <code>parameter</code> from the <code>arguments</code> parameter explicitly passed to the function.</p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-17"></a><strong>Req. IDE-17:</strong> <a href="#Req-IDE-17">Variadic at Runtime</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>At runtime, a variadic parameter is never set to undefined.
+Instead, the array may be empty.
+This must be true even if preceding parameters are optional and no arguments are passed at runtime.</p>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>For more constraints on using the variadic modifier, see <a href="types.html#_function-object-type">Function-Object-Type</a>.</p>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_generator-functions"><a class="anchor" href="#_generator-functions"></a><a class="link" href="#_generator-functions">6.3.2. Generator Functions</a></h4>
+<div class="paragraph">
+<p>Generators come together with the <code>yield</code> expression and can play three roles:
+the role of an iterator (data producer), of an observer (data consumer), and a combined role which is called coroutines.
+When calling a generator function or method, the returned generator object of type <code>Generator&lt;TYield,TReturn,TNext&gt;</code> can be controlled by its methods
+(cf. [<a href="appendix_c_bibliography.html#ECMA15a">ECMA15a(p.S14.4)</a>], also see [<a href="appendix_c_bibliography.html#Kuizinas14a">Kuizinas14a</a>]).</p>
+</div>
+<div class="sect4">
+<h5 id="generator-functions-syntax"><a class="anchor" href="#generator-functions-syntax"></a><a class="link" href="#generator-functions-syntax">6.3.2.1. Syntax</a></h5>
+<div class="paragraph">
+<p>Generator functions and methods differ from ordinary functions and methods only in the additional <code>*</code> symbol before the function or method name.
+The following syntax rules are extracted from the real syntax rules.
+They only display parts relevant to declaring a function or method as a generator.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">GeneratorFunctionDeclaration &lt;Yield&gt;:
+        (declaredModifiers+=N4Modifier)*
+        'function' generator?='*'
+        FunctionHeader&lt;YieldIfGenerator,Generator=true&gt;
+        FunctionBody&lt;Yield=true,Expression=false&gt;
+;
+
+GeneratorFunctionExpression:
+        'function' generator?='*'
+        FunctionHeader&lt;YieldIfGenerator,Generator=true&gt;
+        FunctionBody&lt;Yield=true,Expression=true&gt;
+;
+
+GeneratorMethodDeclaration:
+    annotations+=Annotation+ (declaredModifiers+=N4Modifier)* TypeVariables?
+    generator?='*' NoLineTerminator LiteralOrComputedPropertyName&lt;Yield&gt;
+    MethodParamsReturnAndBody&lt;Generator=true&gt;</code></pre>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="generator-functions-semantics"><a class="anchor" href="#generator-functions-semantics"></a><a class="link" href="#generator-functions-semantics">6.3.2.2. Semantics</a></h5>
+<div class="paragraph">
+<p>The basic idea is to make code dealing with Generators easier to write and more readable without changing their functionality.
+Take this example:</p>
+</div>
+<div id="ex:two-simple-generator-functions" class="exampleblock">
+<div class="title">Example 66. Two simple generator functions</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">// explicit form of the return type
+function * countTo(iMax:int) : Generator&lt;int,string,undefined&gt; {
+	for (int i=0; i&lt;=iMax; i++)
+		yield i;
+	return "finished";
+}
+val genObj1 = countTo(3);
+val values1 = [...genObj1]; // is [0,1,2,3]
+val lastObj1 = genObj1.next(); // is {value="finished",done=true}
+
+// shorthand form of the return type
+function * countFrom(start:int) : int {
+	for (int i=start; i&gt;=0; i--)
+		yield i;
+	return finished;
+}
+val genObj2 = countFrom(3);
+val values2 = [...genObj2]; // is [3,2,1,0]
+val lastObj2 = genObj2.next(); // is {value="finished",done=true}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>In the example above, two generator functions are declared.
+The first declares its return type explicitly whereas the second uses a shorthand form.</p>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Generator functions and methods return objects of the type <code>Generator&lt;TYield,TReturn,TNext&gt;</code> which is a subtype of the <code>Iterable&lt;TYield&gt;</code> and <code>Iterator&lt;TYield&gt;</code> interfaces.
+Moreover, it provides the methods <code>throw(exception:any)</code> and <code>return(value:TNext?)</code> for advanced control of the generator object.
+The complete interface of the generator class is given below.</p>
+</div>
+<div class="listingblock">
+<div class="title">The generator class</div>
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">public providedByRuntime interface Generator&lt;out TYield, out TReturn, in TNext&gt;
+	extends Iterable&lt;TYield&gt;, Iterator&lt;TYield&gt; {
+	public abstract next(value: TNext?): IteratorEntry&lt;TYield&gt;
+	public abstract [Symbol.iterator](): Generator&lt;TYield, TReturn, TNext&gt;
+	public abstract throw(exception: any): IteratorEntry&lt;TYield&gt;;
+	public abstract return(value: TNext?): IteratorEntry&lt;TReturn&gt;;
+}</code></pre>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-14370"></a><strong>Req. IDE-14370:</strong> <a href="#Req-IDE-14370">Modifier <code>*</code></a> (ver. 1)</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p><code>*</code> may be used on declared functions and methods, and for function expressions.</p>
+</li>
+<li>
+<p>A function or method <em>f</em> with a declared return type <em>R</em> that is declared <code>*</code> has an actual return type of <code>Generator&lt;TYield,TReturn,TNext&gt;</code>.</p>
+</li>
+<li>
+<p>A generator function or method can have no declared return type, a shorthand form of a return type or an explicitly declared return type.</p>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p>The explicitly declared return type is of the form <code>Generator&lt;TYield,TReturn,TNext&gt;</code> with the type variables:</p>
+<div class="olist lowerroman">
+<ol class="lowerroman" type="i">
+<li>
+<p><em>TYield</em> as the expected type of the yield expression argument,</p>
+</li>
+<li>
+<p><em>TReturn</em> as the expected type of the return expression, and</p>
+</li>
+<li>
+<p><em>TNext</em> as both the return type of the yield expression.</p>
+</li>
+</ol>
+</div>
+</li>
+<li>
+<p>The shorthand form only declares the type of <em>TYield</em> which implicitly translates to <code>Generator&lt;TYield,TReturn,any&gt;</code> as the return type.</p>
+<div class="olist lowerroman">
+<ol class="lowerroman" type="i">
+<li>
+<p>The type <em>TReturn</em> is inferred to either <code>undefined</code> or <code>any</code> from the body.</p>
+</li>
+<li>
+<p>In case the declared type is <code>void</code>, actual return type evaluates to <code>Generator&lt;undefined,undefined,any&gt;</code>.</p>
+</li>
+</ol>
+</div>
+</li>
+<li>
+<p>If no return type is declared, both <em>TYield</em> and <em>TReturn</em> are inferred from the body to either <code>any</code> or <code>undefined</code>. <em>TNext</em> is <code>any</code>.</p>
+</li>
+</ol>
+</div>
+</li>
+<li>
+<p>Given a generator function or method <em>f</em> with an actual return type <code>Generator&lt;TYield,TReturn,TNext&gt;</code>:</p>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p>all yield statements in <em>f</em> must have an expression of type <em>TYield</em>.</p>
+</li>
+<li>
+<p>all return statements in <em>f</em> must have an expression of type <em>TReturn</em>.</p>
+</li>
+</ol>
+</div>
+</li>
+<li>
+<p>Return statements in generator functions or methods are always optional.</p>
+</li>
+</ol>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-14371"></a><strong>Req. IDE-14371:</strong> <a href="#Req-IDE-14371">Modifier <code>yield</code> and <code>yield*</code></a> (ver. 1)</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p><code>yield</code> and <code>yield*</code> may only be in body of generator functions or methods.</p>
+</li>
+<li>
+<p><code>yield expr</code> takes only expressions <em>expr</em> of type <em>TYield</em> in a generator function or methods with the actual type <code>Generator&lt;TYield,TReturn,TNext&gt;</code>.</p>
+</li>
+<li>
+<p>The return type of the <code>yield</code> expression is <em>TNext</em>.</p>
+</li>
+<li>
+<p><code>yield* fg()</code> takes only iterators of type <code>Iterator&lt;TYield&gt;</code>, and generator functions or methods <em>fg</em> with the actual return type <code>Generator&lt;? extends TYield,? extends TReturn,? super TNext&gt;</code>.</p>
+</li>
+<li>
+<p>The return type of the <code>yield*</code> expression is <em>any</em>, since a custom iterator could return an entry <code>{done=true,value}</code> and any value for the variable <code>value</code>.</p>
+</li>
+</ol>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Similar to <code>async</code> functions, shorthand and explicit form <code>* function():int{};</code> and <code>* function():Generator&lt;int,TResult,any&gt;</code> are equal,
+given that the inferred <em>TResult</em> of the former functions equals to <em>TResult</em> in the latter function).
+In other words, the return type of generator functions or methods is wrapped when it is not explicitly defined as <code>Generator</code> already.
+Thus, whenever a nested generator type is desired, it has to be defined explicitly.
+Consider the example below.</p>
+</div>
+<div class="listingblock">
+<div class="title">Type variables with async methods.</div>
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">class C&lt;T&gt; {
+	genFoo(): T{} // equals to genFoo(): Generator&lt;T, undefined, any&gt;;
+				// note that TResult depends on the body of genFoo()
+}
+function fn(C&lt;int&gt; c1, C&lt;Generator&lt;int,any,any&gt;&gt; c2) {
+	c1.genFoo();  // returns Generator&lt;int, undefined, any&gt;
+	c2.genFoo();  // returns Generator&lt;Generator&lt;int,any,any&gt;, undefined, any&gt;
+}</code></pre>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_generator-arrow-functions"><a class="anchor" href="#_generator-arrow-functions"></a><a class="link" href="#_generator-arrow-functions">6.3.2.3. Generator Arrow Functions</a></h5>
+<div class="paragraph">
+<p>As of now, generator arrow functions are not supported by EcmaScript 6 and also, the support is not planned.
+However, introducing generator arrow function in EcmaScript is still under discussion.
+For more information, please refer to <a href="https://esdiscuss.org/topic/generator-arrow-functions">ESDiscuss.org</a> and <a href="https://esdiscuss.org/topic/why-do-generator-expressions-return-generators">StackOverflow.com</a>.</p>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_arrow-function-expression"><a class="anchor" href="#_arrow-function-expression"></a><a class="link" href="#_arrow-function-expression">6.3.3. Arrow Function Expression</a></h4>
+<div class="paragraph">
+<p>This is an ECMAScript 6 expression (see [<a href="appendix_c_bibliography.html#ECMA15a">ECMA15a(p.S14.2)</a>]) for simplifying the definition of anonymous function expressions, a.k.a. lambdas or closures.
+The ECMAScript Specification calls this a function definition even though they may only appear in the context of expressions.</p>
+</div>
+<div class="paragraph">
+<p>Along with Assignments, Arrow function expressions have the least precedence, e.g. they serve as the entry point for the expression tree.</p>
+</div>
+<div class="paragraph">
+<p>Arrow function expressions can be considered syntactic window-dressing for old-school function expressions and therefore do not support the
+benefits regarding parameter annotations although parameter types may be given explicitly.
+The return type can be given as type hint if desired, but this is not mandatory (if left out, the return type is inferred).
+The notation <code>@=></code> stands for an async arrow function (<a href="#_asynchronous-arrow-functions">Asynchronous Arrow Functions</a>).</p>
+</div>
+<div class="sect4">
+<h5 id="arrow-function-expression-syntax"><a class="anchor" href="#arrow-function-expression-syntax"></a><a class="link" href="#arrow-function-expression-syntax">6.3.3.1. Syntax</a></h5>
+<div class="paragraph">
+<p>The simplified syntax reads like this:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">ArrowExpression returns ArrowFunction:
+    =&gt;(
+        {ArrowFunction}
+        (
+            '('
+                ( fpars+=FormalParameterNoAnnotations ( ',' fpars+=FormalParameterNoAnnotations )* )?
+            ')'
+            (':' returnTypeRef=TypeRef)?
+        |   fpars+=FormalParameterNoType
+        )
+        '=&gt;'
+    ) (
+        (=&gt; hasBracesAroundBody?='{' body=BlockMinusBraces '}') | body=ExpressionDisguisedAsBlock
+    )
+;
+
+FormalParameterNoAnnotations returns FormalParameter:
+    (declaredTypeRef=TypeRef variadic?='...'?)? name=JSIdentifier
+;
+FormalParameterNoType returns FormalParameter: name=JSIdentifier;
+
+BlockMinusBraces returns Block: {Block} statements+=Statement*;
+
+ExpressionDisguisedAsBlock returns Block:
+    {Block} statements+=AssignmentExpressionStatement
+;
+
+AssignmentExpressionStatement returns ExpressionStatement: expression=AssignmentExpression;</code></pre>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="arrow-function-expression-semantics-and-type-inference"><a class="anchor" href="#arrow-function-expression-semantics-and-type-inference"></a><a class="link" href="#arrow-function-expression-semantics-and-type-inference">6.3.3.2. Semantics and Type Inference</a></h5>
+<div class="paragraph">
+<p>Generally speaking, the semantics are very similar to the function
+expressions but the devil’s in the details:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>arguments</code>: Unlike normal function expressions, an arrow function does not introduce an implicit <code>arguments</code> variable (<a href="#_arguments-object">Arguments Object</a>),
+therefore any occurrence of it in the arrow function’s body has always the same binding as an occurrence of <code>arguments</code> in the lexical context enclosing the arrow function.</p>
+</li>
+<li>
+<p><code>this</code>: An arrow function does not introduce a binding of its own for the <code>this</code> keyword. That explains why uses in the body of arrow function have the same meaning as occurrences in the enclosing lexical scope.
+As a consequence, an arrow function at the top level has both usages of <code>arguments</code> and <code>this</code> flagged as error (the outer lexical context doesn’t provide definitionsfor them).</p>
+</li>
+<li>
+<p><code>super</code>: As with function expressions in general, whether of the arrow variety or not, the usage of <code>super</code> isn’t allowed in the body of arrow functions.</p>
+</li>
+</ul>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-84"></a><strong>Req. IDE-84:</strong> <a href="#Req-IDE-84">No This in Top Level Arrow Function in N4JS Mode</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>In N4JS, a top-level arrow function can’t refer to <code>this</code> as there’s no outer lexical context that provides a binding for it.</p>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-85"></a><strong>Req. IDE-85:</strong> <a href="#Req-IDE-85">No Arguments in Top Level Arrow Function</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>In N4JS, a top-level arrow function can’t include usages of <code>arguments</code> in its body, again because of the missing binding for it.</p>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="_ecmascript-proposals-function-definition"><a class="anchor" href="#_ecmascript-proposals-function-definition"></a><a class="link" href="#_ecmascript-proposals-function-definition">6.4. ECMAScript Proposals Function Definition</a></h3>
+<div class="sect3">
+<h4 id="_asynchronous-functions"><a class="anchor" href="#_asynchronous-functions"></a><a class="link" href="#_asynchronous-functions">6.4.1. Asynchronous Functions</a></h4>
+<div class="paragraph">
+<p>To improve language-level support for asynchronous code, there exists an ECMAScript proposal <sup class="footnote">[<a id="_footnoteref_45" class="footnote" href="appendix_c_bibliography.html#_footnote_45" title="View footnote.">45</a>]</sup> based on Promises which are provided by ES6 as built-in types.
+N4JS implements this proposal.
+This concept is supported for declared functions and methods (<a href="classifiers.html#_asynchronous-methods">Asynchronous Methods</a>) as well
+as for function expressions and arrow functions (<a href="#_asynchronous-arrow-functions">Asynchronous Arrow Functions</a>).</p>
+</div>
+<div class="sect4">
+<h5 id="asynchronous-functions-syntax"><a class="anchor" href="#asynchronous-functions-syntax"></a><a class="link" href="#asynchronous-functions-syntax">6.4.1.1. Syntax</a></h5>
+<div class="paragraph">
+<p>The following syntax rules are extracted from the real syntax rules.
+They only display parts relevant to declaring a function or method as
+asynchronous.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">AsyncFunctionDeclaration &lt;Yield&gt;:
+        (declaredModifiers+=N4Modifier)*
+        declaredAsync?='async' NoLineTerminator 'function'
+        FunctionHeader&lt;Yield,Generator=false&gt;
+        FunctionBody&lt;Yield=false,Expression=false&gt;
+;
+
+AsyncFunctionExpression:
+        declaredAsync?='async' NoLineTerminator 'function'
+        FunctionHeader&lt;Yield=false,Generator=false&gt;
+        FunctionBody&lt;Yield=false,Expression=true&gt;
+;
+
+AsyncArrowExpression &lt;In, Yield&gt;:
+        declaredAsync?='async' NoLineTerminator '('
+            (fpars+=FormalParameter&lt;Yield&gt;
+                (',' fpars+=FormalParameter&lt;Yield&gt;)*)?
+        ')' (':' returnTypeRef=TypeRef)? '=&gt;'
+        (   '{' body=BlockMinusBraces&lt;Yield&gt; '}'
+            | body=ExpressionDisguisedAsBlock&lt;In&gt;
+        )
+;
+
+AsyncMethodDeclaration:
+    annotations+=Annotation+ (declaredModifiers+=N4Modifier)* TypeVariables?
+    declaredAsync?='async' NoLineTerminator LiteralOrComputedPropertyName&lt;Yield&gt;
+    MethodParamsReturnAndBody</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>’async’ is not a reserved word in ECMAScript and it can therefore be
+used either as an identifier or as a keyword, depending on the context.
+When used as a modifier to declare a function as asynchronous, then
+there must be no line terminator after the <code>async</code> modifier. This enables the
+parser to distinguish between using <code>async</code> as an identifier reference and a
+keyword, as shown in the next example.</p>
+</div>
+<div class="exampleblock">
+<div class="title">Example 67. Async as keyword and identifier</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">async <i class="conum" data-value="1"></i><b>(1)</b>
+function foo() {}
+// vs
+async function bar(); <i class="conum" data-value="2"></i><b>(2)</b></code></pre>
+</div>
+</div>
+<div class="colist arabic">
+<table>
+<tr>
+<td><i class="conum" data-value="1"></i><b>1</b></td>
+<td>In this snippet, the <code>async</code> on line 1 is an identifier reference (referencing a
+variable or parameter) and the function defined on line 2 is a
+non-asynchronous function. The automatic semicolon insertion adds a
+semicolon after the reference on line 1.</td>
+</tr>
+<tr>
+<td><i class="conum" data-value="2"></i><b>2</b></td>
+<td>In contrast, <code>async</code> on line 4 is recognized as a modifier declaring the function as asynchronous.</td>
+</tr>
+</table>
+</div>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="asynchronous-functions-semantics"><a class="anchor" href="#asynchronous-functions-semantics"></a><a class="link" href="#asynchronous-functions-semantics">6.4.1.2. Semantics</a></h5>
+<div class="paragraph">
+<p>The basic idea is to make code dealing with Promises easier to write and
+more readable without changing the functionality of Promises. Take this
+example:</p>
+</div>
+<div class="listingblock">
+<div class="title">A simple asynchronous function using async/await.</div>
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">// some asynchronous legacy API using promises
+interface DB {}
+interface DBAccess {
+    getDataBase(): Promise&lt;DB,?&gt;
+    loadEntry(db: DB, id: string): Promise&lt;string,?&gt;
+}
+
+var access: DBAccess;
+
+// our own function using async/await
+async function loadAddress(id: string) : string {
+    try {
+        var db: DB = await access.getDataBase();
+        var entry: string = await access.loadEntry(db, id);
+        return entry.address;
+    }
+    catch(err) {
+        // either getDataBase() or loadEntry() failed
+        throw err;
+    }
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>The modifier <code>async</code> changes the return type of <code>loadAddress()</code> from <code>string</code> (the declared return type) to <code>Promise&lt;string,?&gt;</code> (the actual return type).
+For code inside the function, the return type is still <code>string</code>:
+the value in the return statement of the last line will be wrapped in a Promise.
+For client code outside the function and in case of recursive invocations, the return type is <code>Promise&lt;string,?&gt;</code>.
+To raise an error, simply throw an exception, its value will become the error value of the returned Promise.</p>
+</div>
+<div class="paragraph">
+<p>If the expression after an <code>await</code> evaluates to a <code>Promise</code>, execution of the enclosing asynchronous function will be suspended until either a success value is available
+(which will then make the entire await-expression evaluate to this success value and continue execution)
+or until the Promise is rejected (which will then cause an exception to be thrown at the location of the await-expression).
+If, on the other hand, the expression after an <code>await</code> evaluates to a non-promise, the value will be simply passed through.
+In addition, a warning is shown to indicate the unnecessary <code>await</code> expression.</p>
+</div>
+<div class="paragraph">
+<p>Note how method <code>loadAddress()</code> above can be implemented without any explicit references to the built-in type Promise.
+In the above example we handle the errors of the nested asynchronous calls to <code>getDataBase()</code> and <code>loadEntry()</code> for demonstration purposes only;
+if we are not interested in the errors we could simply remove the try/catch block and any errors would be forwarded to the caller of <code>loadAddress()</code>.</p>
+</div>
+<div class="paragraph">
+<p>Invoking an async function commonly adopts one of two forms:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>var p: Promise&lt;successType,?&gt; = asyncFn()</code></p>
+</li>
+<li>
+<p><code>await asyncFn()</code></p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>These patterns are so common that a warning is available whenever both</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p><code>Promise</code> is omitted as expected type; and</p>
+</li>
+<li>
+<p><code>await</code> is also omitted.</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>The warning aims at hinting about forgetting to wait for the result, while remaining non-noisy.</p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-86"></a><strong>Req. IDE-86:</strong> <a href="#Req-IDE-86">Modifier <code>async</code> and <code>await</code></a> (ver. 1)</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p><code>async</code> may be used on declared functions and methods as well as for function expressions and arrow functions.</p>
+</li>
+<li>
+<p>A function or method that is declared <code>async</code> can have no declared return type, a shorthand form of a return type or an explicitly declared return type.</p>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p>The explicitly declared return type is of the form <code>Promise&lt;R,E&gt;</code> where <em>R</em> is the type of all return statements in the body, and E is the type of exceptions that are thrown in the body.</p>
+</li>
+<li>
+<p>The shorthand form only declares the type of <em>R</em> which implicitly translates to <code>Promise&lt;R,?&gt;</code> as the actual return type.</p>
+</li>
+<li>
+<p>In case no return type is declared, the type <em>R</em> of <code>Promise&lt;R,?&gt;</code> is inferred from the body.</p>
+</li>
+</ol>
+</div>
+</li>
+<li>
+<p>A function or method <em>f</em> with a declared return type <em>R</em> that is declared <code>async</code> has an actual return type of</p>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p><code>R</code> if <em>R</em> is a subtype of <code>Promise&lt;?,?&gt;</code>,</p>
+</li>
+<li>
+<p><code>Promise&lt;undefined,?&gt;</code> if <em>R</em> is type <code>void</code>.</p>
+</li>
+<li>
+<p><code>Promise&lt;R,?&gt;</code> in all other cases (i.e. the declared return type <em>R</em> is being wrapped in a <code>Promise</code>).</p>
+</li>
+</ol>
+</div>
+</li>
+<li>
+<p>Return type inference is only performed when no return type is declared.</p>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p>The return type <code>R</code> of <code>Promise&lt;R,?&gt;</code> is inferred either as <code>void</code> or as <code>any</code>.</p>
+</li>
+</ol>
+</div>
+</li>
+<li>
+<p>Given a function or method <em>f</em> that is declared <code>async</code> with a declared return type <em>R</em>, or with a declared return type <code>Promise&lt;R,?&gt;</code>,
+all return statements in <em>f</em> must have an expression of type <em>R</em> (and not of type <code>Promise&lt;R,?&gt;</code>).</p>
+</li>
+<li>
+<p><code>await</code> can be used in expressions directly enclosed in an async function, and behaves like a unary operator with the same precedence as <code>yield</code> in ES6.</p>
+</li>
+<li>
+<p>Given an expression <em>expr</em> of type
+<em>T</em>, the type of (<code>await</code> <em>expr</em>) is inferred to <em>T</em> if
+<em>T</em> is not a Promise, or it is inferred to <em>S</em> if
+<em>T</em> is a Promise with a success value of type
+<em>S</em>, i.e. <em>T &lt;: Promise&lt;S,?&gt;</em> .</p>
+</li>
+</ol>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>In other words, the return type <em>R</em> of <code>async</code> functions and methods will always be wrapped to <code>Promise&lt;R,?&gt;</code> unless <em>R</em> is a <code>Promise</code> already.
+As a consequence, nested <code>Promise</code>s as a return type of a async function or method have to be stated explicitly like <code>Promise&lt;Promise&lt;R,?&gt;,?&gt;</code>.</p>
+</div>
+<div class="paragraph">
+<p>When a type variable <code>T</code> is used to define the the return type of an async function or method, it will always be wrapped.
+Consider the example below.</p>
+</div>
+<div class="exampleblock">
+<div class="title">Example 68. Type variables with async methods.</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">interface I&lt;T&gt; {
+	async foo(): T;  // amounts to foo(): Promise&lt;T,?&gt;
+}
+function snafu(i1: I&lt;int&gt;, i2: I&lt;Promise&lt;int,?&gt;&gt;) {
+	i1.foo();  // returns Promise&lt;int,?&gt;
+	i2.foo();  // returns Promise&lt;Promise&lt;int,?&gt;,?&gt;
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_asynchronous-arrow-functions"><a class="anchor" href="#_asynchronous-arrow-functions"></a><a class="link" href="#_asynchronous-arrow-functions">6.4.1.3. Asynchronous Arrow Functions</a></h5>
+<div class="paragraph">
+<p>An <code>await</code> expression is allowed in the body of an async arrow function but not
+in the body of a non-async arrow function. The semantics here are
+intentional and are in line with similar constraint for function
+expressions.</p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="_n4js-extended-function-definition"><a class="anchor" href="#_n4js-extended-function-definition"></a><a class="link" href="#_n4js-extended-function-definition">6.5. N4JS Extended Function Definition</a></h3>
+<div class="sect3">
+<h4 id="_generic-functions"><a class="anchor" href="#_generic-functions"></a><a class="link" href="#_generic-functions">6.5.1. Generic Functions</a></h4>
+<div class="paragraph">
+<p>A generic function is a function with a list of generic type parameters.
+These type parameters can be used in the function signature to declare the types of formal parameters and the return type.
+In addition, the type parameters can be used in the function body, for example when declaring the type of a local variable.</p>
+</div>
+<div class="paragraph">
+<p>In the following listing, a generic function <code>foo</code> is defined that has two type parameters <code>S</code> and <code>T</code>.
+Thereby <code>S</code> is used as to declare the parameter type <code>Array&lt;S&gt;</code> and <code>T</code> is used as the return type and to construct the returned value in the function body.</p>
+</div>
+<div class="listingblock">
+<div class="title">Generic Function Definition</div>
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">function &lt;S,T&gt; foo(s: Array&lt;S&gt;): T { return new T(s); }</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>If a generic type parameter is not used as a formal parameter type or
+the return type, a warning is generated.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_promisifiable-functions"><a class="anchor" href="#_promisifiable-functions"></a><a class="link" href="#_promisifiable-functions">6.5.2. Promisifiable Functions</a></h4>
+<div class="paragraph">
+<p>In many existing libraries, which have been developed in pre-ES6-promise-API times, callback methods are used for asynchronous behavior.
+An asynchronous function follows the following conventions:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">'function' name '(' arbitraryParameters ',' callbackFunction ')'</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Usually the function returns nothing (<code>void</code>).
+The callback function usually takes two arguments,in which the first is an error object and the other is the result value of the asynchronous operation.
+The callback function is called from the asynchronous function, leading to nested function calls (aka ’callback hell’).</p>
+</div>
+<div class="paragraph">
+<p>In order to simplify usage of this pattern, it is possible to mark such a function or method as <code>@Promisifiable</code>.
+It is then possible to ’promisify’ an invocation of this function or method, which means no callback function argument has to be provided and a will be returned.
+The function or method can then be used as if it were declared with <code>async</code>.
+This is particularly useful in N4JS definition files (.n4jsd) to allow using an existing callback-based API from N4JS code with the more convenient <code>await</code>.</p>
+</div>
+<div class="exampleblock">
+<div class="title">Example 69. Promisifiable</div>
+<div class="content">
+<div class="paragraph">
+<p>Given a function with an N4JS signature</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">f(x: int, cb: {function(Error, string)}): void</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>This method can be annotated with <code>Promisifiable</code> as follows:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">@Promisifiable f(x: int, cb: {function(Error, string)}): void</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>With this annotation, the function can be invoked in four different
+ways:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">f(42, function(err, result1) { /* ... */ });            // traditional
+var promise: Promise&lt;string,Error&gt; = @Promisify f(42);  // promise
+var result3: string = await @Promisify f(42);           // long
+var result4: string = await f(42);                      // short</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>The first line is only provided for completeness and shows that a promisifiable function can still be used in the ordinary way by providing a callback - no special handling will occur in this case.
+The second line shows how <code>f</code> can be promisified using the <code>@Promisify</code> annotation - no callback needs to be provided and instead, a <code>Promise</code> will be returned.
+We can either use this promise directly or immediately <code>await</code> on it, as shown in line 3.
+The syntax shown in line 4 is merely shorthand for <code>await @Promisify</code>, i.e. the annotation is optional after <code>await</code>.</p>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-87"></a><strong>Req. IDE-87:</strong> <a href="#Req-IDE-87">Promisifiable</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>A function or method <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>f</mi></math> can be annotated with <code>@Promisifiable</code> if and only if the following constraints hold:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Last parameter of <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>f</mi></math> is a function (the <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>c</mi><mi>a</mi><mi>l</mi><mi>l</mi><mi>b</mi><mi>a</mi><mi>c</mi><mi>k</mi></math>).</p>
+</li>
+<li>
+<p>The <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>c</mi><mi>a</mi><mi>l</mi><mi>l</mi><mi>b</mi><mi>a</mi><mi>c</mi><mi>k</mi></math> has a signature of</p>
+<div class="ulist">
+<ul>
+<li>
+<p><code>{function(E, T0, T1, &#8230;&#8203;, Tn): V}</code>, or</p>
+</li>
+<li>
+<p><code>{function(T0, T1, &#8230;&#8203;, Tn): V}</code></p>
+<div class="paragraph">
+<p>in which <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>E</mi></math> is type <code>Error</code> or a subtype thereof, <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>T</mi><mn>0</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>T</mi><mi>n</mi></msub></math> are arbitrary types except or its subtypes.
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>E</mi></math>, if given, is then the type of the error value, and <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>T</mi><mn>0</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>T</mi><mi>n</mi></msub></math> are the types of the success values of the asynchronous operation.<br>
+Since the return value of the synchronous function call is not available when using <code>@Promisify</code>, <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>V</mi></math> is recommended to be <code>void</code>, but it can be any type.</p>
+</div>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>The callback parameter may be optional.<sup class="footnote">[<a id="_footnoteref_46" class="footnote" href="appendix_c_bibliography.html#_footnote_46" title="View footnote.">46</a>]</sup></p>
+</li>
+</ol>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>According to <a href="#Req-IDE-87">[Req-IDE-87]</a>, a promisifiable function or method may or may not have a non-void return type, and that only the first parameter of the callback is allowed to be of type <code>Error</code>, all other parameters must be of other types.</p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-88"></a><strong>Req. IDE-88:</strong> <a href="#Req-IDE-88">@Promisify and await with promisifiable functions</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>A promisifiable function <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>f</mi></math> with one of the two valid
+signatures given in <a href="#Req-IDE-87">[Req-IDE-87]</a> can be promisified with <code>Promisify</code> or
+used with <code>await</code>, if and only if the following constraints hold:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Function <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>f</mi></math> must be annotated with <code>@Promisifiable</code>.</p>
+</li>
+<li>
+<p>Using <code>@Promisify f()</code> without <code>await</code> returns a promise of type <code>Promise&lt;S,F&gt;</code> where</p>
+<div class="ulist">
+<ul>
+<li>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>S</mi></math> is <code>IterableN&lt;T0,&#8230;&#8203;,Tn&gt;</code> if <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>n</mi><mo>≥</mo><mn>2</mn></math>, <code>T</code> if <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>n</mi><mo>=</mo><mn>1</mn></math>, and <code>undefined</code> if <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>n</mi><mo>=</mo><mn>0</mn></math>.</p>
+</li>
+<li>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>F</mi></math> is <code>E</code> if given, <code>undefined</code> otherwise.</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>Using <code>await @Promisify f()</code> returns a value of type <code>IterableN&lt;T0,&#8230;&#8203;,Tn&gt;</code> if <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>n</mi><mo>≥</mo><mn>2</mn></math>, of type <code>T</code> if <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>n</mi><mo>=</mo><mn>1</mn></math>, and of type <code>undefined</code> if <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>n</mi><mo>=</mo><mn>0</mn></math>.</p>
+</li>
+<li>
+<p>In case of using an <code>await</code>, the annotation can be omitted.<br>
+I.e., <code>await @Promisify f()</code> is equivalent to <code>await f()</code>.</p>
+</li>
+<li>
+<p>Only call expressions using f as target can be promisified, in other
+words this is illegal:</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">var pf = @Promisify f; // illegal code!</code></pre>
+</div>
+</div>
+</li>
+</ol>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div id="footer">
+<div id="footer-text">
+Version 0.9<br>
+Last updated 2019-08-07 15:02:40 CEST
+</div>
+</div>
+<!-- ************* docinfo-footer *************************************************************** -->
+<div class="Grid social" style="color:#d5dfea">
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <h2>Quick Links</h2>
+    <ul>
+      <li><a href="../downloads.html">Download</a></li>
+      <li><a href="../userguides/index.html">Documentation</a></li>
+      <li><a href="https://github.com/eclipse/n4js/">Source</a></li>
+      <li><a href="https://github.com/eclipse/n4js/issues">Issues</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="https://www.eclipse.org/forums/index.php/f/365/">Forum</a></li>
+      <li><a href="http://n4js.blogspot.de/">Blog</a></li>
+      <li><a href="https://dev.eclipse.org/mailman/listinfo/n4js-dev">Mailing List</a></li>
+      <li><a href="https://projects.eclipse.org/projects/technology.n4js">Eclipse Project Page</a></li>
+      <li><a href="https://twitter.com/n4jsdev">Tweets by n4jsdev</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="http://www.eclipse.org/">Eclipse Home</a></li>
+      <li><a href="http://www.eclipse.org/legal/privacy.php">Privacy Policy</a></li>
+      <li><a href="http://www.eclipse.org/legal/termsofuse.php">Terms of Use</a></li>
+      <li><a href="http://www.eclipse.org/legal/copyright.php">Copyright Agent</a></li>
+      <li><a href="http://www.eclipse.org/legal/">Legal</a></li>
+    </ul>
+  </div>
+  <div style="clear: both; height: 0; overflow: hidden;"></div>
+</div>
+
+<!-- ************* UI Scripts ************* -->
+<script type="text/javascript" src="scripts/back-to-top.js"></script>
+
+<script type="text/javascript" src="scripts/treeview.js"></script>
+<script type="text/javascript" src="scripts/toc.js"></script>
+
+<!-- ************* Prism.js Syntax Highlighting ************* -->
+<script src="scripts/prism.js"></script>
+
+<script type="text/javascript">
+	// Add the 'toclist' id for search function
+	$(".toc2 > ul").attr('id', 'toclist');
+	// Generate a Search input form
+	$("#toclist > li:first-of-type").before('<input type="text" id="pagesearch" onkeyup="search()" placeholder="Search for section...">');
+	$("#toclist > li:first-of-type").before('<i id="clear" class="fa fa-times-circle-o"></i>');
+	$("#clear").click(function(){
+	    $("#pagesearch").val('');
+	    search();
+	    $('.toc2 > ul').treeView('collapseAll');
+	});
+	// intialize Treeview.js
+	$(".toc2 > ul").treeView();
+	// Initialize Scrollspy
+</script>
+<!-- ************* docinfo-footer *************************************************************** -->
+</body>
+</html>
\ No newline at end of file
diff --git a/spec/grammar.html b/spec/grammar.html
new file mode 100644
index 0000000..61df051
--- /dev/null
+++ b/spec/grammar.html
@@ -0,0 +1,1144 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="generator" content="Asciidoctor 1.5.5">
+<meta name="author" content="2019-08-07 15:02:40 CEST">
+<title>N4JS Language Specification</title>
+<link rel="stylesheet" href="styles/spec.min.css">
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.6.3/css/font-awesome.min.css">
+<!-- ************* docinfo ******************************************************************* -->
+
+
+<!-- ************* Favicon ************-->
+<link rel="icon" href="images/favicon.ico" />
+
+<!-- ************* Back-to-top JQuery ************* -->
+<script src="https://code.jquery.com/jquery-1.12.4.js"></script>
+<script src="https://code.jquery.com/ui/1.12.0/jquery-ui.js"></script>
+
+
+<link href="styles/prism.min.css" rel="stylesheet" />
+<script type="text/javascript" async
+  src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2/MathJax.js?config=TeX-MML-AM_CHTML">
+</script>
+
+<!-- ************* Styles ************* -->
+<link rel="stylesheet" type="text/css" href="styles/n4jsspec-adoc.css">
+
+
+<!-- ****************** NavBar ****************** -->
+<div id="menubar">
+	<div class="banner">
+        <a href="https://www.eclipse.org/n4js/#"><img id="logo" src="images/n4js-logo.png" alt="Eclipse N4JS"></a>
+    </div>
+<ul>
+  <li><a href="index.html">Index</a></li>
+</ul>
+</div>
+<!-- ************* docinfo ******************************************************************* -->
+<style>
+      .admonitionblock td.icon .icon-todo:before{content:"\f249";color:#f4ee42}
+    </style>
+</head>
+<body class="book toc2 toc-left">
+<div id="header">
+<h1>N4JS Language Specification</h1>
+<div class="details">
+<span id="author" class="author">2019-08-07 15:02:40 CEST</span><br>
+<span id="revnumber">version 0.9</span>
+</div>
+<div id="toc" class="toc2">
+<div id="toctitle">Table of Contents</div>
+<ul class="sectlevel1">
+<li><a href="introduction.html#_introduction">1. Introduction</a>
+<ul class="sectlevel2">
+<li><a href="introduction.html#_notation">1.1. Notation</a>
+<ul class="sectlevel3">
+<li><a href="introduction.html#_grammar-notation">1.1.1. Grammar Notation</a></li>
+<li><a href="introduction.html#_type-judgments-and-rules-and-constraints-notation">1.1.2. Type Judgments and Rules and Constraints Notation</a>
+<ul class="sectlevel4">
+<li><a href="introduction.html#_typing-rules-and-judgments">1.1.2.1. Typing Rules and Judgments</a></li>
+<li><a href="introduction.html#_types-of-an-element">1.1.2.2. Types of an Element</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="introduction.html#_auxiliary-functions">1.2. Auxiliary Functions</a>
+<ul class="sectlevel3">
+<li><a href="introduction.html#_binding">1.2.1. Binding</a></li>
+<li><a href="introduction.html#_merging-types">1.2.2. Merging Types</a>
+<ul class="sectlevel4">
+<li><a href="introduction.html#_logic-formulas">1.2.2.1. Logic Formulas</a></li>
+</ul>
+</li>
+<li><a href="introduction.html#_symbols-and-font-convention">1.2.3. Symbols and Font Convention</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#_grammar">2. Grammar</a>
+<ul class="sectlevel2">
+<li><a href="#_lexical-conventions">2.1. Lexical Conventions</a>
+<ul class="sectlevel3">
+<li><a href="#_identifier-names-and-identifiers">2.1.1. Identifier Names and Identifiers</a></li>
+<li><a href="#_this-keyword">2.1.2. This Keyword</a></li>
+<li><a href="#_regular-expression-literals">2.1.3. Regular Expression Literals</a></li>
+<li><a href="#_automatic-semicolon-insertion">2.1.4. Automatic Semicolon Insertion</a></li>
+<li><a href="#_jsdoc">2.1.5. JSDoc</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="names.html#_names">3. Names</a>
+<ul class="sectlevel2">
+<li><a href="names.html#_access-control">3.1. Access Control</a></li>
+<li><a href="names.html#_accessibility-of-types-top-level-variables-and-function-declarations">3.2. Accessibility of Types, Top-Level Variables and Function Declarations</a>
+<ul class="sectlevel3">
+<li><a href="names.html#_accessibility-of-members">3.2.1. Accessibility of Members</a></li>
+<li><a href="names.html#_valid-names">3.2.2. Valid Names</a></li>
+<li><a href="names.html#_qualified-names">3.2.3. Qualified Names</a></li>
+<li><a href="names.html#_name-duplicates">3.2.4. Name Duplicates</a>
+<ul class="sectlevel4">
+<li><a href="names.html#_lexical-environment">3.2.4.1. Lexical Environment</a></li>
+<li><a href="names.html#_duplicates-and-shadowing">3.2.4.2. Duplicates and Shadowing</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="types.html#_types">4. Types</a>
+<ul class="sectlevel2">
+<li><a href="types.html#_overview">4.1. Overview</a></li>
+<li><a href="types.html#_type-expressions">4.2. Type Expressions</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_syntax">4.2.1. Syntax</a></li>
+<li><a href="types.html#_properties">4.2.2. Properties</a></li>
+<li><a href="types.html#_semantics">4.2.3. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_type-inference">4.3. Type Inference</a></li>
+<li><a href="types.html#_generic-and-parameterized-types">4.4. Generic and Parameterized Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_generic-types">4.4.1. Generic Types</a></li>
+<li><a href="types.html#_type-variables">4.4.2. Type Variables</a></li>
+<li><a href="types.html#_parameterized-types">4.4.3. Parameterized Types</a></li>
+</ul>
+</li>
+<li><a href="types.html#_primitive-ecmascript-types">4.5. Primitive ECMAScript Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_undefined-type">4.5.1. Undefined Type</a></li>
+<li><a href="types.html#_null-type">4.5.2. Null Type</a></li>
+<li><a href="types.html#_primitive-boolean-type">4.5.3. Primitive Boolean Type</a></li>
+<li><a href="types.html#_primitive-string-type">4.5.4. Primitive String Type</a></li>
+<li><a href="types.html#_primitive-number-type">4.5.5. Primitive Number Type</a></li>
+<li><a href="types.html#_primitive-type-int">4.5.6. Primitive Type int</a></li>
+<li><a href="types.html#_primitive-symbol-type">4.5.7. Primitive Symbol Type</a></li>
+</ul>
+</li>
+<li><a href="types.html#_primitive-n4js-types">4.6. Primitive N4JS Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_any-type">4.6.1. Any Type</a>
+<ul class="sectlevel4">
+<li><a href="types.html#any-type-semantics">4.6.1.1. Semantics</a></li>
+<li><a href="types.html#any-type-type-inference">4.6.1.2. Type Inference</a>
+<ul class="sectlevel5">
+<li><a href="types.html#_default-type-of-variables">4.6.1.2.1. Default Type of Variables</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="types.html#_void-type">4.6.2. Void Type</a>
+<ul class="sectlevel4">
+<li><a href="types.html#void-type-semantics">4.6.2.1. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_unknown-type">4.6.3. Unknown Type</a></li>
+<li><a href="types.html#_primitive-pathselector-and-i18nkey">4.6.4. Primitive Pathselector and I18nKey</a>
+<ul class="sectlevel4">
+<li><a href="types.html#pathselector-semantics">4.6.4.1. Semantics</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="types.html#_built-in-ecmascript-object-types">4.7. Built-in ECMAScript Object Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#ECMAScript-objects-semantics">4.7.1. Semantics</a></li>
+<li><a href="types.html#_object-type">4.7.2. Object Type</a></li>
+<li><a href="types.html#_function-object-type">4.7.3. Function-Object-Type</a></li>
+<li><a href="types.html#_array-object-type">4.7.4. Array Object Type</a></li>
+<li><a href="types.html#_string-object-type">4.7.5. String Object Type</a></li>
+<li><a href="types.html#_boolean-object-type">4.7.6. Boolean Object Type</a></li>
+<li><a href="types.html#_number-object-type">4.7.7. Number Object Type</a></li>
+<li><a href="types.html#_global-object-type">4.7.8. Global Object Type</a></li>
+<li><a href="types.html#_symbol">4.7.9. Symbol</a></li>
+<li><a href="types.html#_promise">4.7.10. Promise</a></li>
+<li><a href="types.html#_iterator-interface">4.7.11. Iterator Interface</a></li>
+<li><a href="types.html#_iterable-interface">4.7.12. Iterable Interface</a></li>
+</ul>
+</li>
+<li><a href="types.html#_built-in-n4js-types">4.8. Built-In N4JS Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_n4object">4.8.1. N4Object</a>
+<ul class="sectlevel4">
+<li><a href="types.html#N4Object-semantics">4.8.1.1. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_n4class">4.8.2. N4Class</a></li>
+<li><a href="types.html#IterableN">4.8.3. IterableN</a></li>
+</ul>
+</li>
+<li><a href="types.html#_type-modifiers">4.9. Type Modifiers</a>
+<ul class="sectlevel3">
+<li><a href="types.html#Type_Modifiers_Dynamic">4.9.1. Dynamic</a></li>
+<li><a href="types.html#_optional-return-types">4.9.2. Optional Return Types</a></li>
+</ul>
+</li>
+<li><a href="types.html#_union-and-intersection-type-composed-types">4.10. Union and Intersection Type (Composed Types)</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_union-type">4.10.1. Union Type</a>
+<ul class="sectlevel4">
+<li><a href="types.html#union-type-syntax">4.10.1.1. Syntax</a></li>
+<li><a href="types.html#union-type-semantics">4.10.1.2. Semantics</a></li>
+<li><a href="types.html#_warnings">4.10.1.3. Warnings</a></li>
+</ul>
+</li>
+<li><a href="types.html#_intersection-type">4.10.2. Intersection Type</a>
+<ul class="sectlevel4">
+<li><a href="types.html#intersection-type-syntax">4.10.2.1. Syntax</a></li>
+<li><a href="types.html#intersection-type-semantics">4.10.2.2. Semantics</a></li>
+<li><a href="types.html#_warnings-2">4.10.2.3. Warnings</a></li>
+</ul>
+</li>
+<li><a href="types.html#_composed-types-in-wildcards">4.10.3. Composed Types in Wildcards</a></li>
+<li><a href="types.html#_property-access-for-composed-types">4.10.4. Property Access for Composed Types</a>
+<ul class="sectlevel4">
+<li><a href="types.html#_properties-of-union-type">4.10.4.1. Properties of Union Type</a>
+<ul class="sectlevel5">
+<li><a href="types.html#_remarks-on-union-type-s-members">4.10.4.1.1. Remarks on union type’s members:</a></li>
+</ul>
+</li>
+<li><a href="types.html#_properties-of-intersection-type">4.10.4.2. Properties of Intersection Type</a>
+<ul class="sectlevel5">
+<li><a href="types.html#_remarks-on-intersection-type-s-methods">4.10.4.2.1. Remarks on intersection type’s methods:</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="types.html#_constructor-and-classifier-type">4.11. Constructor and Classifier Type</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_syntax-3">4.11.1. Syntax</a></li>
+<li><a href="types.html#_semantics-2">4.11.2. Semantics</a></li>
+<li><a href="types.html#_constructors-and-prototypes-in-ecmascript-2015">4.11.3. Constructors and Prototypes in ECMAScript 2015</a></li>
+</ul>
+</li>
+<li><a href="types.html#_this-type">4.12. This Type</a>
+<ul class="sectlevel3">
+<li><a href="types.html#this-type-syntax">4.12.1. Syntax</a></li>
+<li><a href="types.html#this-keyword-semantics">4.12.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_enums">4.13. Enums</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_enums-n4js">4.13.1. Enums (N4JS)</a>
+<ul class="sectlevel4">
+<li><a href="types.html#enums-syntax">4.13.1.1. Syntax</a></li>
+<li><a href="types.html#enums-semantics">4.13.1.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_string-based-enums">4.13.2. String-Based Enums</a></li>
+</ul>
+</li>
+<li><a href="types.html#_short-hand-syntax">4.14. Short-Hand Syntax</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_array-short-hand-syntax">4.14.1. Array Short-Hand Syntax</a></li>
+<li><a href="types.html#_iterablen-short-hand-syntax">4.14.2. IterableN Short-Hand Syntax</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="classifiers.html#_classifiers">5. Classifiers</a>
+<ul class="sectlevel2">
+<li><a href="classifiers.html#_n4js-specific-classifiers">5.1. N4JS Specific Classifiers</a>
+<ul class="sectlevel3">
+<li><a href="classifiers.html#_properties-2">5.1.1. Properties</a></li>
+<li><a href="classifiers.html#_common-semantics-of-classifiers">5.1.2. Common Semantics of Classifiers</a></li>
+<li><a href="classifiers.html#_classes">5.1.3. Classes</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_definition-of-classes">5.1.3.1. Definition of Classes</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#class-syntax">5.1.3.1.1. Syntax</a></li>
+<li><a href="classifiers.html#class-properties">5.1.3.1.2. Properties</a></li>
+<li><a href="classifiers.html#class-type-inference">5.1.3.1.3. Type Inference</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#class-semantics">5.1.3.2. Semantics</a></li>
+<li><a href="classifiers.html#_final-modifier">5.1.3.3. Final Modifier</a></li>
+<li><a href="classifiers.html#_abstract-classes">5.1.3.4. Abstract Classes</a></li>
+<li><a href="classifiers.html#_non-instantiable-classes">5.1.3.5. Non-Instantiable Classes</a></li>
+<li><a href="classifiers.html#_superclass">5.1.3.6. Superclass</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_interfaces">5.1.4. Interfaces</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_definition-of-interfaces">5.1.4.1. Definition of Interfaces</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#interfaces-syntax">5.1.4.1.1. Syntax</a></li>
+<li><a href="classifiers.html#interfaces-properties">5.1.4.1.2. Properties</a></li>
+<li><a href="classifiers.html#interfaces-type-inference">5.1.4.1.3. Type Inference</a></li>
+<li><a href="classifiers.html#interfaces-semantics">5.1.4.1.4. Semantics</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="classifiers.html#_generic-classifiers">5.1.5. Generic Classifiers</a></li>
+<li><a href="classifiers.html#sec:definition-site-variance">5.1.6. Definition-Site Variance</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_members">5.2. Members</a>
+<ul class="sectlevel3">
+<li><a href="classifiers.html#_syntax-4">5.2.1. Syntax</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_properties-3">5.2.1.1. Properties</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_semantics-3">5.2.2. Semantics</a></li>
+<li><a href="classifiers.html#_methods">5.2.3. Methods</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_syntax-5">5.2.3.1. Syntax</a></li>
+<li><a href="classifiers.html#_properties-4">5.2.3.2. Properties</a></li>
+<li><a href="classifiers.html#_semantics-4">5.2.3.3. Semantics</a></li>
+<li><a href="classifiers.html#_final-methods">5.2.3.4. Final Methods</a></li>
+<li><a href="classifiers.html#_abstract-methods">5.2.3.5. Abstract Methods</a></li>
+<li><a href="classifiers.html#_generic-methods">5.2.3.6. Generic Methods</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_default-methods-in-interfaces">5.2.4. Default Methods in Interfaces</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_asynchronous-methods">5.2.4.1. Asynchronous Methods</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_constructors">5.2.5. Constructors</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_structural-this-type-in-constructor">5.2.5.1. Structural This Type in Constructor</a></li>
+<li><a href="classifiers.html#spec-constructor">5.2.5.2. @Spec Constructor</a></li>
+<li><a href="classifiers.html#_callable-constructors">5.2.5.3. Callable Constructors</a></li>
+<li><a href="classifiers.html#_covariant-constructors">5.2.5.4. Covariant Constructors</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_data-fields">5.2.6. Data Fields</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#data-fields-syntax">5.2.6.1. Syntax</a></li>
+<li><a href="classifiers.html#data-fields-properties">5.2.6.2. Properties</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#data-fields-semantics">5.2.6.2.1. Semantics</a></li>
+<li><a href="classifiers.html#data-fields-type-inference">5.2.6.2.2. Type Inference</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_assignment-modifiers">5.2.6.3. Assignment Modifiers</a></li>
+<li><a href="classifiers.html#_field-accessors-getter-setter">5.2.6.4. Field Accessors (Getter/Setter)</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#field-acessors-syntax">5.2.6.4.1. Syntax</a></li>
+<li><a href="classifiers.html#field-acessors-properties">5.2.6.4.2. Properties</a></li>
+<li><a href="classifiers.html#field-accessors-semantics">5.2.6.4.3. Semantics</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#optional-fields">5.2.6.5. Optional Fields</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#_syntax-6">5.2.6.5.1. Syntax</a></li>
+<li><a href="classifiers.html#_semantics-5">5.2.6.5.2. Semantics</a></li>
+<li><a href="classifiers.html#_background">5.2.6.5.3. Background</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="classifiers.html#_static-members">5.2.7. Static Members</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_access-from-and-to-static-members">5.2.7.1. Access From and To Static Members</a></li>
+<li><a href="classifiers.html#_generic-static-methods">5.2.7.2. Generic static methods</a></li>
+<li><a href="classifiers.html#_static-members-of-interfaces">5.2.7.3. Static Members of Interfaces</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_redefinition-of-members">5.2.8. Redefinition of Members</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_overriding-of-members">5.2.8.1. Overriding of Members</a></li>
+<li><a href="classifiers.html#_implementation-of-members">5.2.8.2. Implementation of Members</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#_member-consumption">5.2.8.2.1. Member Consumption</a></li>
+<li><a href="classifiers.html#_member-implementation">5.2.8.2.2. Member Implementation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="classifiers.html#_structural-typing">5.3. Structural Typing</a>
+<ul class="sectlevel3">
+<li><a href="classifiers.html#_syntax-7">5.3.1. Syntax</a></li>
+<li><a href="classifiers.html#_definition-site-structural-typing">5.3.2. Definition Site Structural Typing</a></li>
+<li><a href="classifiers.html#_use-site-structural-typing">5.3.3. Use-Site Structural Typing</a></li>
+<li><a href="classifiers.html#structural-readWriteInit-field-typing">5.3.4. Structural Read-only, Write-only and Initializer Field Typing</a></li>
+<li><a href="classifiers.html#_public-setter-annotated-with-code-providesinitializer-code">5.3.5. Public Setter Annotated With <code>ProvidesInitializer</code></a></li>
+<li><a href="classifiers.html#_structural-types-with-optional-fields">5.3.6. Structural Types With Optional Fields</a></li>
+<li><a href="classifiers.html#_structural-types-with-access-modifier">5.3.7. Structural Types With Access Modifier</a></li>
+<li><a href="classifiers.html#_structural-types-with-additional-members">5.3.8. Structural Types With Additional Members</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_syntax-8">5.3.8.1. Syntax</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#_semantics-6">5.3.8.1.1. Semantics</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="functions.html#_functions">6. Functions</a>
+<ul class="sectlevel2">
+<li><a href="functions.html#_function-type">6.1. Function Type</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_properties-5">6.1.1. Properties</a></li>
+<li><a href="functions.html#function-type-inference">6.1.2. Type Inference</a></li>
+<li><a href="functions.html#_autoboxing-of-function-type">6.1.3. Autoboxing of Function Type</a></li>
+<li><a href="functions.html#_arguments-object">6.1.4. Arguments Object</a></li>
+</ul>
+</li>
+<li><a href="functions.html#_ecmascript-5-function-definition">6.2. ECMAScript 5 Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_function-declaration">6.2.1. Function Declaration</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#_syntax-9">6.2.1.1. Syntax</a></li>
+<li><a href="functions.html#_semantics-8">6.2.1.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="functions.html#_function-expression">6.2.2. Function Expression</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#function-expression-syntax">6.2.2.1. Syntax</a></li>
+<li><a href="functions.html#_semantics-and-type-inference">6.2.2.2. Semantics and Type Inference</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="functions.html#_ecmascript-2015-function-definition">6.3. ECMAScript 2015 Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_formal-parameters">6.3.1. Formal Parameters</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#Type_Modifiers_Optional">6.3.1.1. Optional Parameters</a></li>
+<li><a href="functions.html#Type_Modifiers_Default">6.3.1.2. Default Parameters</a></li>
+<li><a href="functions.html#Type_Modifiers_Variadic">6.3.1.3. Variadic</a></li>
+</ul>
+</li>
+<li><a href="functions.html#_generator-functions">6.3.2. Generator Functions</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#generator-functions-syntax">6.3.2.1. Syntax</a></li>
+<li><a href="functions.html#generator-functions-semantics">6.3.2.2. Semantics</a></li>
+<li><a href="functions.html#_generator-arrow-functions">6.3.2.3. Generator Arrow Functions</a></li>
+</ul>
+</li>
+<li><a href="functions.html#_arrow-function-expression">6.3.3. Arrow Function Expression</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#arrow-function-expression-syntax">6.3.3.1. Syntax</a></li>
+<li><a href="functions.html#arrow-function-expression-semantics-and-type-inference">6.3.3.2. Semantics and Type Inference</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="functions.html#_ecmascript-proposals-function-definition">6.4. ECMAScript Proposals Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_asynchronous-functions">6.4.1. Asynchronous Functions</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#asynchronous-functions-syntax">6.4.1.1. Syntax</a></li>
+<li><a href="functions.html#asynchronous-functions-semantics">6.4.1.2. Semantics</a></li>
+<li><a href="functions.html#_asynchronous-arrow-functions">6.4.1.3. Asynchronous Arrow Functions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="functions.html#_n4js-extended-function-definition">6.5. N4JS Extended Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_generic-functions">6.5.1. Generic Functions</a></li>
+<li><a href="functions.html#_promisifiable-functions">6.5.2. Promisifiable Functions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_conversions-and-reflection">7. Conversions and Reflection</a>
+<ul class="sectlevel2">
+<li><a href="conversions_and_reflection.html#_autoboxing-and-coercing">7.1. Autoboxing and Coercing</a>
+<ul class="sectlevel3">
+<li><a href="conversions_and_reflection.html#_coercing">7.1.1. Coercing</a></li>
+<li><a href="conversions_and_reflection.html#_autoboxing-of-primitives">7.1.2. Autoboxing of Primitives</a></li>
+<li><a href="conversions_and_reflection.html#_autoboxing-of-function-expressions-and-declarations">7.1.3. Autoboxing of Function Expressions and Declarations</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_auto-conversion-of-objects">7.2. Auto-Conversion of Objects</a>
+<ul class="sectlevel3">
+<li><a href="conversions_and_reflection.html#_auto-conversion-of-class-instances">7.2.1. Auto-Conversion of Class Instances</a>
+<ul class="sectlevel4">
+<li><a href="conversions_and_reflection.html#_auto-conversion-of-interface-instances">7.2.1.1. Auto-Conversion of Interface Instances</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_auto-conversion-of-enum-literals">7.2.2. Auto-Conversion of Enum Literals</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_type-cast-and-type-check">7.3. Type Cast and Type Check</a>
+<ul class="sectlevel3">
+<li><a href="conversions_and_reflection.html#_type-cast">7.3.1. Type Cast</a></li>
+<li><a href="conversions_and_reflection.html#_type-check">7.3.2. Type Check</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_reflection-meta-information">7.4. Reflection meta-information</a>
+<ul class="sectlevel3">
+<li><a href="conversions_and_reflection.html#_reflection-for-classes">7.4.1. Reflection for Classes</a></li>
+<li><a href="conversions_and_reflection.html#_reflection-for-interfaces">7.4.2. Reflection for Interfaces</a></li>
+<li><a href="conversions_and_reflection.html#_reflection-for-enumerations">7.4.3. Reflection for Enumerations</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_conversion-of-primitive-types">7.5. Conversion of primitive types</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_expressions">8. Expressions</a>
+<ul class="sectlevel2">
+<li><a href="expressions.html#_ecmascript-5-expressions">8.1. ECMAScript 5 Expressions</a>
+<ul class="sectlevel3">
+<li><a href="expressions.html#_the-this-literal">8.1.1. The this Literal</a></li>
+<li><a href="expressions.html#_identifier">8.1.2. Identifier</a></li>
+<li><a href="expressions.html#_literals">8.1.3. Literals</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#_integer-literals">8.1.3.1. Integer Literals</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_array-literal">8.1.4. Array Literal</a></li>
+<li><a href="expressions.html#_object-literal">8.1.5. Object Literal</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#_properties-6">8.1.5.1. Properties</a></li>
+<li><a href="expressions.html#_scoping-and-linking">8.1.5.2. Scoping and linking</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_parenthesized-expression-and-grouping-operator">8.1.6. Parenthesized Expression and Grouping Operator</a></li>
+<li><a href="expressions.html#_property-accessors">8.1.7. Property Accessors</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#properties-1">8.1.7.1. Properties</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_new-expression">8.1.8. New Expression</a></li>
+<li><a href="expressions.html#_function-expression-2">8.1.9. Function Expression</a></li>
+<li><a href="expressions.html#_function-calls">8.1.10. Function Calls</a></li>
+<li><a href="expressions.html#_postfix-expression">8.1.11. Postfix Expression</a></li>
+<li><a href="expressions.html#_unary-expression">8.1.12. Unary Expression</a></li>
+<li><a href="expressions.html#_multiplicative-expression">8.1.13. Multiplicative Expression</a></li>
+<li><a href="expressions.html#_additive-expression">8.1.14. Additive Expression</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#type-inference-10">8.1.14.1. Type Inference</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_bitwise-shift-expression">8.1.15. Bitwise Shift Expression</a></li>
+<li><a href="expressions.html#_relational-expression">8.1.16. Relational Expression</a></li>
+<li><a href="expressions.html#_equality-expression">8.1.17. Equality Expression</a></li>
+<li><a href="expressions.html#_binary-bitwise-expression">8.1.18. Binary Bitwise Expression</a></li>
+<li><a href="expressions.html#_binary-logical-expression">8.1.19. Binary Logical Expression</a></li>
+<li><a href="expressions.html#_conditional-expression">8.1.20. Conditional Expression</a></li>
+<li><a href="expressions.html#_assignment-expression">8.1.21. Assignment Expression</a></li>
+<li><a href="expressions.html#_comma-expression">8.1.22. Comma Expression</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_ecmascript-6-expressions">8.2. ECMAScript 6 Expressions</a>
+<ul class="sectlevel3">
+<li><a href="expressions.html#_the-super-keyword">8.2.1. The super Keyword</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_ecmascript-7-expressions">8.3. ECMAScript 7 Expressions</a>
+<ul class="sectlevel3">
+<li><a href="expressions.html#_await-expression">8.3.1. Await Expression</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_n4js-specific-expressions">8.4. N4JS Specific Expressions</a>
+<ul class="sectlevel3">
+<li><a href="expressions.html#_class-expression">8.4.1. Class Expression</a></li>
+<li><a href="expressions.html#_cast-as-expression">8.4.2. Cast (As) Expression</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#cast-as-expression-semantics-type-inference">8.4.2.1. Semantics and Type Inference</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#Import_Calls">8.4.3. Import Calls</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#compile-time-expressions">8.5. Compile-Time Expressions</a></li>
+</ul>
+</li>
+<li><a href="statements.html#_statements">9. Statements</a>
+<ul class="sectlevel2">
+<li><a href="statements.html#_ecmascript-5-statements">9.1. ECMAScript 5 Statements</a>
+<ul class="sectlevel3">
+<li><a href="statements.html#_function-or-field-accessor-bodies">9.1.1. Function or Field Accessor Bodies</a></li>
+<li><a href="statements.html#_variable-statement">9.1.2. Variable Statement</a></li>
+<li><a href="statements.html#_if-statement">9.1.3. If Statement</a></li>
+<li><a href="statements.html#_iteration-statements">9.1.4. Iteration Statements</a></li>
+<li><a href="statements.html#_return-statement">9.1.5. Return Statement</a></li>
+<li><a href="statements.html#_with-statement">9.1.6. With Statement</a></li>
+<li><a href="statements.html#_switch-statement">9.1.7. Switch Statement</a></li>
+<li><a href="statements.html#_throw-try-and-catch-statements">9.1.8. Throw, Try, and Catch Statements</a></li>
+<li><a href="statements.html#_debugger-statement">9.1.9. Debugger Statement</a></li>
+</ul>
+</li>
+<li><a href="statements.html#_ecmascript-6-statements">9.2. ECMAScript 6 Statements</a>
+<ul class="sectlevel3">
+<li><a href="statements.html#_let">9.2.1. Let</a></li>
+<li><a href="statements.html#_const">9.2.2. Const</a></li>
+<li><a href="statements.html#_for-of-statement">9.2.3. <code>for &#8230;&#8203; of</code> statement</a></li>
+<li><a href="statements.html#_import-statement">9.2.4. Import Statement</a>
+<ul class="sectlevel4">
+<li><a href="statements.html#Dynamic_Imports">9.2.4.1. Dynamic Imports</a></li>
+<li><a href="statements.html#_immutabilaty-of-imports">9.2.4.2. Immutabilaty of Imports</a></li>
+</ul>
+</li>
+<li><a href="statements.html#_export-statement">9.2.5. Export Statement</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="annotations.html#_annotations">10. Annotations</a>
+<ul class="sectlevel2">
+<li><a href="annotations.html#_introduction-2">10.1. Introduction</a>
+<ul class="sectlevel3">
+<li><a href="annotations.html#_syntax-13">10.1.1. Syntax</a></li>
+<li><a href="annotations.html#_properties-7">10.1.2. Properties</a></li>
+<li><a href="annotations.html#_element-specific-annotations">10.1.3. Element-Specific Annotations</a></li>
+<li><a href="annotations.html#_general-annotations">10.1.4. General Annotations</a>
+<ul class="sectlevel4">
+<li><a href="annotations.html#_idebug">10.1.4.1. IDEBUG</a></li>
+</ul>
+</li>
+<li><a href="annotations.html#idebug-syntax">10.1.5. Syntax</a>
+<ul class="sectlevel4">
+<li><a href="annotations.html#_semantics-11">10.1.5.1. Semantics</a></li>
+<li><a href="annotations.html#_suppress-warnings">10.1.5.2. Suppress Warnings</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="annotations.html#_declaration-of-annotations">10.2. Declaration of Annotations</a></li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_extended-fetaures">11. Extended Fetaures</a>
+<ul class="sectlevel2">
+<li><a href="extended_fetaures.html#_array-and-object-destructuring">11.1. Array and Object Destructuring</a>
+<ul class="sectlevel3">
+<li><a href="extended_fetaures.html#_syntax-14">11.1.1. Syntax</a></li>
+<li><a href="extended_fetaures.html#_semantics-12">11.1.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_dependency-injection">11.2. Dependency Injection</a>
+<ul class="sectlevel3">
+<li><a href="extended_fetaures.html#_di-components-and-injectors">11.2.1. DI Components and Injectors</a>
+<ul class="sectlevel4">
+<li><a href="extended_fetaures.html#_dicomponent-relations">11.2.1.1. DIComponent Relations</a></li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_binders-and-bindings">11.2.2. Binders and Bindings</a></li>
+<li><a href="extended_fetaures.html#_injection-points">11.2.3. Injection Points</a>
+<ul class="sectlevel4">
+<li><a href="extended_fetaures.html#_field-injection">11.2.3.1. Field Injection</a></li>
+<li><a href="extended_fetaures.html#_constructor-injection">11.2.3.2. Constructor Injection</a></li>
+<li><a href="extended_fetaures.html#_method-injection">11.2.3.3. Method Injection</a>
+<ul class="sectlevel5">
+<li><a href="extended_fetaures.html#_provider">11.2.3.3.1. Provider</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_n4js-di-life-cycle-and-scopes">11.2.4. N4JS DI Life Cycle and Scopes</a>
+<ul class="sectlevel4">
+<li><a href="extended_fetaures.html#_injection-cylces">11.2.4.1. Injection Cylces</a></li>
+<li><a href="extended_fetaures.html#_default-scope">11.2.4.2. Default Scope</a></li>
+<li><a href="extended_fetaures.html#_singleton-scope">11.2.4.3. Singleton Scope</a></li>
+<li><a href="extended_fetaures.html#_per-injection-chain-singleton">11.2.4.4. Per Injection Chain Singleton</a></li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_validation-of-callsites-targeting-n4injector-methods">11.2.5. Validation of callsites targeting N4Injector methods</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-annotations">11.2.6. N4JS DI Annotations</a>
+<ul class="sectlevel4">
+<li><a href="extended_fetaures.html#_n4js-di-generateinjector">11.2.6.1. N4JS DI @GenerateInjector</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-withparentinjector">11.2.6.2. N4JS DI @WithParentInjector</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-usebinder">11.2.6.3. N4JS DI @UseBinder</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-binder">11.2.6.4. N4JS DI @Binder</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-bind">11.2.6.5. N4JS DI @Bind</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-provides">11.2.6.6. N4JS DI @Provides</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-inject">11.2.6.7. N4JS DI @Inject</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-singleton">11.2.6.8. N4JS DI @Singleton</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_test-support">11.3. Test Support</a></li>
+<li><a href="extended_fetaures.html#_polyfill-definitions">11.4. Polyfill Definitions</a>
+<ul class="sectlevel3">
+<li><a href="extended_fetaures.html#_runtime-polyfill-definitions">11.4.1. Runtime Polyfill Definitions</a></li>
+<li><a href="extended_fetaures.html#_static-polyfill-definitions">11.4.2. Static Polyfill Definitions</a></li>
+<li><a href="extended_fetaures.html#_transpiling-static-polyfilled-classes">11.4.3. Transpiling static polyfilled classes</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="components.html#_components">12. Components</a>
+<ul class="sectlevel2">
+<li><a href="components.html#_overview-2">12.1. Overview</a></li>
+<li><a href="components.html#Component_Types">12.2. Component Types</a>
+<ul class="sectlevel3">
+<li><a href="components.html#_libraries">12.2.1. Libraries</a></li>
+<li><a href="components.html#_runtime-environment-and-runtime-libraries">12.2.2. Runtime Environment and Runtime Libraries</a></li>
+<li><a href="components.html#_tests">12.2.3. Tests</a></li>
+<li><a href="components.html#_type-definitions">12.2.4. Type Definitions</a></li>
+</ul>
+</li>
+<li><a href="components.html#package-json">12.3. Package.json File</a>
+<ul class="sectlevel3">
+<li><a href="components.html#_basic-properties">12.3.1. Basic Properties</a></li>
+<li><a href="components.html#_n4js-properties">12.3.2. N4JS Properties</a></li>
+<li><a href="components.html#_constraints">12.3.3. Constraints</a></li>
+</ul>
+</li>
+<li><a href="components.html#_support-for-npm-scopes">12.4. Support for NPM Scopes</a></li>
+<li><a href="components.html#sec:N4JS-Type-Definitions">12.5. N4JS Type Definitions</a>
+<ul class="sectlevel3">
+<li><a href="components.html#_specify-type-definition">12.5.1. Specify Type Definition</a></li>
+<li><a href="components.html#_name-conventions">12.5.2. Name Conventions</a></li>
+<li><a href="components.html#_version-conventions">12.5.3. Version Conventions</a>
+<ul class="sectlevel4">
+<li><a href="components.html#_define-a-new-type-definition-package">12.5.3.1. Define a New Type Definition Package</a></li>
+<li><a href="components.html#_using-a-type-definition-package">12.5.3.2. Using a Type Definition Package</a></li>
+<li><a href="components.html#_rational">12.5.3.3. Rational</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="components.html#_modules">12.6. Modules</a></li>
+<li><a href="components.html#_api-and-implementation-component">12.7. API and Implementation Component</a>
+<ul class="sectlevel3">
+<li><a href="components.html#_execution-of-api-and-implementation-components">12.7.1. Execution of API and Implementation Components</a></li>
+<li><a href="components.html#_api-and-implementation-with-di">12.7.2. API and Implementation With DI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="plainjs.html#_plainjs">13. PlainJS</a>
+<ul class="sectlevel2">
+<li><a href="plainjs.html#_type-inference-and-validation-for-plain-js">13.1. Type Inference and Validation for Plain JS</a></li>
+<li><a href="plainjs.html#_external-declarations">13.2. External Declarations</a>
+<ul class="sectlevel3">
+<li><a href="plainjs.html#_declaring-externals">13.2.1. Declaring externals</a></li>
+<li><a href="plainjs.html#_instantiating-external-classes">13.2.2. Instantiating external classes</a></li>
+<li><a href="plainjs.html#_implementation-of-external-declarations">13.2.3. Implementation of External Declarations</a></li>
+<li><a href="plainjs.html#_example">13.2.4. Example</a></li>
+</ul>
+</li>
+<li><a href="plainjs.html#_global-definitions">13.3. Global Definitions</a></li>
+<li><a href="plainjs.html#_runtime-definitions">13.4. Runtime Definitions</a></li>
+<li><a href="plainjs.html#_applying-polyfills">13.5. Applying Polyfills</a></li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_jsdoc-2">14. JSDoc</a>
+<ul class="sectlevel2">
+<li><a href="jsdoc.html#_general-n4jsdoc-features">14.1. General N4JSDoc Features</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#_provided-inline-tags">14.1.1. Provided Inline Tags</a>
+<ul class="sectlevel4">
+<li><a href="jsdoc.html#jsdoc_tag__code">14.1.1.1. @code</a></li>
+<li><a href="jsdoc.html#jsdoc_tag__link">14.1.1.2. @link</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_n4jsdoc-for-user-projects">14.2. N4JSdoc for User Projects</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#_standard-tags">14.2.1. Standard Tags</a>
+<ul class="sectlevel4">
+<li><a href="jsdoc.html#_-author">14.2.1.1. @author</a></li>
+<li><a href="jsdoc.html#jsdoc_tag_param">14.2.1.2. @param</a></li>
+<li><a href="jsdoc.html#jsdoc_tag_return">14.2.1.3. @return</a></li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_test-related-tags">14.2.2. Test Related Tags</a>
+<ul class="sectlevel4">
+<li><a href="jsdoc.html#jsdoc_tag__testee">14.2.2.1. @testee</a></li>
+<li><a href="jsdoc.html#jsdoc_tag__testeeFromType">14.2.2.2. @testeeFromType</a></li>
+<li><a href="jsdoc.html#_testeeType_and__testeeMember">14.2.2.3. @testeeType and @testeeMember</a></li>
+<li><a href="jsdoc.html#jsdoc_tag_reqid_in_Tests">14.2.2.4. @reqid in Tests</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_n4jsdoc-for-api-and-implementation-projects">14.3. N4JSDoc for API and Implementation Projects</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#jsdoc_tag__apiNote">14.3.1. @apiNote</a></li>
+<li><a href="jsdoc.html#API_Project_Tags">14.3.2. API Project Tags</a>
+<ul class="sectlevel4">
+<li><a href="jsdoc.html#jsdoc_tag_apiState">14.3.2.1. @apiState</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsx.html#_jsx">15. JSX</a>
+<ul class="sectlevel2">
+<li><a href="jsx.html#_jsx-support">15.1. JSX Support</a></li>
+<li><a href="jsx.html#_jsx-backend">15.2. JSX Backend</a></li>
+</ul>
+</li>
+<li><a href="grammars.html#_grammars">16. Grammars</a>
+<ul class="sectlevel2">
+<li><a href="grammars.html#_type-expressions-grammar">16.1. Type Expressions Grammar</a></li>
+<li><a href="grammars.html#_n4js-language-grammar">16.2. N4JS Language Grammar</a></li>
+</ul>
+</li>
+<li><a href="jsobjects.html#_jsobjects">17. JSObjects</a>
+<ul class="sectlevel2">
+<li><a href="jsobjects.html#_object">17.1. Object</a></li>
+<li><a href="jsobjects.html#_string">17.2. String</a></li>
+<li><a href="jsobjects.html#_boolean">17.3. Boolean</a></li>
+<li><a href="jsobjects.html#_number">17.4. Number</a>
+<ul class="sectlevel3">
+<li><a href="jsobjects.html#_static-attributes">17.4.1. Static Attributes</a></li>
+</ul>
+</li>
+<li><a href="jsobjects.html#function">17.5. Function</a></li>
+<li><a href="jsobjects.html#_error">17.6. Error</a></li>
+<li><a href="jsobjects.html#_array">17.7. Array</a></li>
+<li><a href="jsobjects.html#_date">17.8. Date</a></li>
+<li><a href="jsobjects.html#_math">17.9. Math</a>
+<ul class="sectlevel3">
+<li><a href="jsobjects.html#static-attributes-1">17.9.1. Static Attributes</a></li>
+</ul>
+</li>
+<li><a href="jsobjects.html#_regexp">17.10. RegExp</a></li>
+<li><a href="jsobjects.html#_json">17.11. JSON</a></li>
+</ul>
+</li>
+<li><a href="n4js_objects.html#_n4js-objects">18. N4JS Objects</a>
+<ul class="sectlevel2">
+<li><a href="n4js_objects.html#_reflection-model">18.1. Reflection Model</a></li>
+<li><a href="n4js_objects.html#_error-types">18.2. Error Types</a>
+<ul class="sectlevel3">
+<li><a href="n4js_objects.html#_n4apinotimplemented">18.2.1. N4ApiNotImplemented</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_acronyms.html#_acronyms">Appendix A: Acronyms</a></li>
+<li><a href="appendix_b_license.html#sec:License">Appendix B: License</a></li>
+<li><a href="appendix_c_bibliography.html#_bibliography">Appendix C: Bibliography</a></li>
+</ul>
+</div>
+</div>
+<div id="content"><div class="sect1">
+<h2 id="_grammar"><a class="anchor" href="#_grammar"></a><a class="link" href="#_grammar">2. Grammar</a></h2>
+<div class="sectionbody">
+<div class="sect2 language-n4js">
+<h3 id="_lexical-conventions"><a class="anchor" href="#_lexical-conventions"></a><a class="link" href="#_lexical-conventions">2.1. Lexical Conventions</a></h3>
+<div class="paragraph">
+<p>As a super language on top of ECMAScript, the same lexical conventions are supported as described in [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.S7)</a>] within strict mode.
+Some further constraints are defined, however, restricting certain constructs. These constraints are described in the following.</p>
+</div>
+<div class="sect3">
+<h4 id="_identifier-names-and-identifiers"><a class="anchor" href="#_identifier-names-and-identifiers"></a><a class="link" href="#_identifier-names-and-identifiers">2.1.1. Identifier Names and Identifiers</a></h4>
+<div class="paragraph">
+<p>Cf. [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.S7.6)</a>], [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.S11.1.2, p.p.63)</a>] and [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.S01.2, p.p.51ff)</a>].</p>
+</div>
+<div class="paragraph">
+<p>As a reminder, identifiers are defined as follows in the ECMAScript specification:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">IdentifierName: IdentifierStart* IdentifierPart;
+IdentifierStart : UnicodeLetter | '_';
+                \ UnicodeEscapeSequence</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>N4JS supports a limited form of computed-names for member declarations:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">N4JSPropertyComputedName:
+    '[' (SymbolLiteralComputedName | StringLiteralComputedName) ']'
+;
+
+SymbolLiteralComputedName: N4JSIdentifier '.' N4JSIdentifier ;
+
+StringLiteralComputedName: STRING ;</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>As can be seen, a computed-name must be either</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>a symbol reference, e.g., <code>Symbol.iterator</code></p>
+</li>
+<li>
+<p>a string literal, i.e., a compile time known constant.
+This notation is useful when interoperating with libraries that define members whose names contain special characters (e.g., a field name starting with commercial-at)</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>In N4JS, identifiers are further constrained in order to avoid ambiguities and to make code more readable.
+Some of these constraints will lead to errors, others only to warnings.
+They do not apply for identifiers declared in definitions file (n4jsd) in order to enable declaration of external entities.</p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-1"></a><strong>Req. IDE-1:</strong> <a href="#Req-IDE-1">N4JS Identifier Restrictions</a> (ver. 1)</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>If the following constraints do not hold, errors are created.</p>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p>Leading <code>$</code> (dollar sign) character is prohibited for any variable name such as fields, variables, types functions and methods.</p>
+</li>
+<li>
+<p>Leading <code>_</code> (underscore) character is not allowed for identifying any functions or methods.</p>
+</li>
+</ol>
+</div>
+</li>
+</ol>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-2"></a><strong>Req. IDE-2:</strong> <a href="#Req-IDE-2">N4JS identifier recommendations</a> (ver. 1)</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>If the following constraints do not hold, warnings are created.</p>
+</li>
+<li>
+<p>Variable names should, in general, be constructed form the 26 ASCII upper and lower case alphabetic letters (a..z, A..Z), from the 10 decimal digits (0..9) and from the <code>_</code> (underscore).
+Although the usage of the international characters are allowed (according to the ECMAScript specification)
+it is discouraged because these characters may not be read or understood well in every circumstance <sup class="footnote">[<a id="_footnoteref_3" class="footnote" href="appendix_c_bibliography.html#_footnote_3" title="View footnote.">3</a>]</sup>.</p>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Type (and Type Variable) Identifiers</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">TypeIdentifier: [_A-Z][_a-zA-Z0-9]*
+TypeVariableIdentifier: [_A-Z][_a-zA-Z0-9]*</code></pre>
+</div>
+</div>
+</li>
+<li>
+<p>Package Identifiers</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">PackageIdentifier: [_a-z][._a-zA-Z0-9]*; // i.e. the folder names, must not end with .</code></pre>
+</div>
+</div>
+</li>
+<li>
+<p>Member Identifiers and Enum Literals</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">InstanceFieldIdentifier: [_a-z][_a-zA-Z0-9]*
+StaticFieldIdentifier: [_A-Z][_A-Z0-9]*([_A-Z0-9]+)*
+EnumLiteral: [_A-Z][_A-Z0-9]*([_A-Z0-9]+)*</code></pre>
+</div>
+</div>
+</li>
+<li>
+<p>Variable and Parameter Names</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">VariableIdentifier: [_a-zA-Z0-9]*
+􏰀ParameterIdentifier: [_a-z][_a-zA-Z0-9]*</code></pre>
+</div>
+</div>
+</li>
+<li>
+<p>Methods</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">MethodIdentifier: [_a-z][_a-zA-Z0-9]*;</code></pre>
+</div>
+</div>
+</li>
+<li>
+<p>Annotations</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">AnnotationIdentifier: [_A-Z][_a-zA-Z0-9]*</code></pre>
+</div>
+</div>
+</li>
+</ol>
+</div>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>The following rules describe how fully qualified names of elements are created.
+Note that these fully qualified names cannot be used in N4JS directly.
+Though they may be shown in error messages etc. to identify elements.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">TypeIdentifier:         [A-Z][a-zA-Z0-9]*;
+PackageIdentifier:      [a-z][a-zA-Z0-9]*;
+FQNType:                (PackageIdentifier '.')+ TypeIdentifier;</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_this-keyword"><a class="anchor" href="#_this-keyword"></a><a class="link" href="#_this-keyword">2.1.2. This Keyword</a></h4>
+<div class="paragraph">
+<p>Cf. [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.S11.1.1, p.p.63)</a>]</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_regular-expression-literals"><a class="anchor" href="#_regular-expression-literals"></a><a class="link" href="#_regular-expression-literals">2.1.3. Regular Expression Literals</a></h4>
+<div class="paragraph">
+<p>Cf. [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.S7.8.5)</a>]</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_automatic-semicolon-insertion"><a class="anchor" href="#_automatic-semicolon-insertion"></a><a class="link" href="#_automatic-semicolon-insertion">2.1.4. Automatic Semicolon Insertion</a></h4>
+<div class="paragraph">
+<p>Cf. [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.S7.9)</a>]</p>
+</div>
+<div class="paragraph">
+<p><a href="appendix_a_acronyms.html#_acronyms">ASI</a> is supported by the parser, however warnings are issued.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_jsdoc"><a class="anchor" href="#_jsdoc"></a><a class="link" href="#_jsdoc">2.1.5. JSDoc</a></h4>
+<div class="paragraph">
+<p>JSDoc are comments similar to JavaDoc in Java for documenting types, functions and members.
+There is no semantic information expressed in JSDoc, that is, the behavior of a program must not change if all the JSDoc is removed.
+The JSDoc tags and overall syntax is a mixture of tags defined by the <a href="https://developers.google.com/closure/compiler/docs/js-for-compiler">Google Closure Compiler</a>, Java&#8217;s <a href="http://www.oracle.com/technetwork/java/javase/documentation/index-jsp-135444.html">JavaDoc</a> tool and N4-specific tags.</p>
+</div>
+<div class="paragraph">
+<p>JSDoc comments are multiline comments, starting with <code>/**</code> (instead of simple multiline comments, starting with <code>/*</code>).</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">MultiLineComment: '/*' MultiLineCommentChars? '*/'  // from ECMAScript specification
+JSDoc:            '/**' MultiLineCommentChars? '*/'</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>In general, JSDoc comments are placed directly before the annotated language element.
+In some cases, this is slightly different, such as for method parameters, for example, where it is then explicitly specified.</p>
+</div>
+<div class="paragraph">
+<p>The content of JSDoc comments will be covered in more detail in upcoming chapters.
+For documentation purposes, multi- and single-line descriptions are used in several constructs.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">MLVALUE:         ([^@]+[^\n]+)+;
+SLVALUE:         ([^\n]+);</code></pre>
+</div>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><code>MLVALUE</code> </dt>
+<dd>
+<p>short for <code>multi-line value</code>. This is usually only used for the general description of types or members.</p>
+</dd>
+<dt class="hdlist1"><code>SLVALUE</code> </dt>
+<dd>
+<p>short for <code>single-line value</code>. This is a description which ends at the end of a line.
+It is usually used in combination with other tags, e.g., to further describe a parameter of a method.</p>
+</dd>
+</dl>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div id="footer">
+<div id="footer-text">
+Version 0.9<br>
+Last updated 2019-08-07 15:02:40 CEST
+</div>
+</div>
+<!-- ************* docinfo-footer *************************************************************** -->
+<div class="Grid social" style="color:#d5dfea">
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <h2>Quick Links</h2>
+    <ul>
+      <li><a href="../downloads.html">Download</a></li>
+      <li><a href="../userguides/index.html">Documentation</a></li>
+      <li><a href="https://github.com/eclipse/n4js/">Source</a></li>
+      <li><a href="https://github.com/eclipse/n4js/issues">Issues</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="https://www.eclipse.org/forums/index.php/f/365/">Forum</a></li>
+      <li><a href="http://n4js.blogspot.de/">Blog</a></li>
+      <li><a href="https://dev.eclipse.org/mailman/listinfo/n4js-dev">Mailing List</a></li>
+      <li><a href="https://projects.eclipse.org/projects/technology.n4js">Eclipse Project Page</a></li>
+      <li><a href="https://twitter.com/n4jsdev">Tweets by n4jsdev</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="http://www.eclipse.org/">Eclipse Home</a></li>
+      <li><a href="http://www.eclipse.org/legal/privacy.php">Privacy Policy</a></li>
+      <li><a href="http://www.eclipse.org/legal/termsofuse.php">Terms of Use</a></li>
+      <li><a href="http://www.eclipse.org/legal/copyright.php">Copyright Agent</a></li>
+      <li><a href="http://www.eclipse.org/legal/">Legal</a></li>
+    </ul>
+  </div>
+  <div style="clear: both; height: 0; overflow: hidden;"></div>
+</div>
+
+<!-- ************* UI Scripts ************* -->
+<script type="text/javascript" src="scripts/back-to-top.js"></script>
+
+<script type="text/javascript" src="scripts/treeview.js"></script>
+<script type="text/javascript" src="scripts/toc.js"></script>
+
+<!-- ************* Prism.js Syntax Highlighting ************* -->
+<script src="scripts/prism.js"></script>
+
+<script type="text/javascript">
+	// Add the 'toclist' id for search function
+	$(".toc2 > ul").attr('id', 'toclist');
+	// Generate a Search input form
+	$("#toclist > li:first-of-type").before('<input type="text" id="pagesearch" onkeyup="search()" placeholder="Search for section...">');
+	$("#toclist > li:first-of-type").before('<i id="clear" class="fa fa-times-circle-o"></i>');
+	$("#clear").click(function(){
+	    $("#pagesearch").val('');
+	    search();
+	    $('.toc2 > ul').treeView('collapseAll');
+	});
+	// intialize Treeview.js
+	$(".toc2 > ul").treeView();
+	// Initialize Scrollspy
+</script>
+<!-- ************* docinfo-footer *************************************************************** -->
+</body>
+</html>
\ No newline at end of file
diff --git a/spec/grammars.html b/spec/grammars.html
new file mode 100644
index 0000000..39a4351
--- /dev/null
+++ b/spec/grammars.html
@@ -0,0 +1,2371 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="generator" content="Asciidoctor 1.5.5">
+<meta name="author" content="2019-08-07 15:02:40 CEST">
+<title>N4JS Language Specification</title>
+<link rel="stylesheet" href="styles/spec.min.css">
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.6.3/css/font-awesome.min.css">
+<!-- ************* docinfo ******************************************************************* -->
+
+
+<!-- ************* Favicon ************-->
+<link rel="icon" href="images/favicon.ico" />
+
+<!-- ************* Back-to-top JQuery ************* -->
+<script src="https://code.jquery.com/jquery-1.12.4.js"></script>
+<script src="https://code.jquery.com/ui/1.12.0/jquery-ui.js"></script>
+
+
+<link href="styles/prism.min.css" rel="stylesheet" />
+<script type="text/javascript" async
+  src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2/MathJax.js?config=TeX-MML-AM_CHTML">
+</script>
+
+<!-- ************* Styles ************* -->
+<link rel="stylesheet" type="text/css" href="styles/n4jsspec-adoc.css">
+
+
+<!-- ****************** NavBar ****************** -->
+<div id="menubar">
+	<div class="banner">
+        <a href="https://www.eclipse.org/n4js/#"><img id="logo" src="images/n4js-logo.png" alt="Eclipse N4JS"></a>
+    </div>
+<ul>
+  <li><a href="index.html">Index</a></li>
+</ul>
+</div>
+<!-- ************* docinfo ******************************************************************* -->
+<style>
+      .admonitionblock td.icon .icon-todo:before{content:"\f249";color:#f4ee42}
+    </style>
+</head>
+<body class="book toc2 toc-left">
+<div id="header">
+<h1>N4JS Language Specification</h1>
+<div class="details">
+<span id="author" class="author">2019-08-07 15:02:40 CEST</span><br>
+<span id="revnumber">version 0.9</span>
+</div>
+<div id="toc" class="toc2">
+<div id="toctitle">Table of Contents</div>
+<ul class="sectlevel1">
+<li><a href="introduction.html#_introduction">1. Introduction</a>
+<ul class="sectlevel2">
+<li><a href="introduction.html#_notation">1.1. Notation</a>
+<ul class="sectlevel3">
+<li><a href="introduction.html#_grammar-notation">1.1.1. Grammar Notation</a></li>
+<li><a href="introduction.html#_type-judgments-and-rules-and-constraints-notation">1.1.2. Type Judgments and Rules and Constraints Notation</a>
+<ul class="sectlevel4">
+<li><a href="introduction.html#_typing-rules-and-judgments">1.1.2.1. Typing Rules and Judgments</a></li>
+<li><a href="introduction.html#_types-of-an-element">1.1.2.2. Types of an Element</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="introduction.html#_auxiliary-functions">1.2. Auxiliary Functions</a>
+<ul class="sectlevel3">
+<li><a href="introduction.html#_binding">1.2.1. Binding</a></li>
+<li><a href="introduction.html#_merging-types">1.2.2. Merging Types</a>
+<ul class="sectlevel4">
+<li><a href="introduction.html#_logic-formulas">1.2.2.1. Logic Formulas</a></li>
+</ul>
+</li>
+<li><a href="introduction.html#_symbols-and-font-convention">1.2.3. Symbols and Font Convention</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="grammar.html#_grammar">2. Grammar</a>
+<ul class="sectlevel2">
+<li><a href="grammar.html#_lexical-conventions">2.1. Lexical Conventions</a>
+<ul class="sectlevel3">
+<li><a href="grammar.html#_identifier-names-and-identifiers">2.1.1. Identifier Names and Identifiers</a></li>
+<li><a href="grammar.html#_this-keyword">2.1.2. This Keyword</a></li>
+<li><a href="grammar.html#_regular-expression-literals">2.1.3. Regular Expression Literals</a></li>
+<li><a href="grammar.html#_automatic-semicolon-insertion">2.1.4. Automatic Semicolon Insertion</a></li>
+<li><a href="grammar.html#_jsdoc">2.1.5. JSDoc</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="names.html#_names">3. Names</a>
+<ul class="sectlevel2">
+<li><a href="names.html#_access-control">3.1. Access Control</a></li>
+<li><a href="names.html#_accessibility-of-types-top-level-variables-and-function-declarations">3.2. Accessibility of Types, Top-Level Variables and Function Declarations</a>
+<ul class="sectlevel3">
+<li><a href="names.html#_accessibility-of-members">3.2.1. Accessibility of Members</a></li>
+<li><a href="names.html#_valid-names">3.2.2. Valid Names</a></li>
+<li><a href="names.html#_qualified-names">3.2.3. Qualified Names</a></li>
+<li><a href="names.html#_name-duplicates">3.2.4. Name Duplicates</a>
+<ul class="sectlevel4">
+<li><a href="names.html#_lexical-environment">3.2.4.1. Lexical Environment</a></li>
+<li><a href="names.html#_duplicates-and-shadowing">3.2.4.2. Duplicates and Shadowing</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="types.html#_types">4. Types</a>
+<ul class="sectlevel2">
+<li><a href="types.html#_overview">4.1. Overview</a></li>
+<li><a href="types.html#_type-expressions">4.2. Type Expressions</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_syntax">4.2.1. Syntax</a></li>
+<li><a href="types.html#_properties">4.2.2. Properties</a></li>
+<li><a href="types.html#_semantics">4.2.3. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_type-inference">4.3. Type Inference</a></li>
+<li><a href="types.html#_generic-and-parameterized-types">4.4. Generic and Parameterized Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_generic-types">4.4.1. Generic Types</a></li>
+<li><a href="types.html#_type-variables">4.4.2. Type Variables</a></li>
+<li><a href="types.html#_parameterized-types">4.4.3. Parameterized Types</a></li>
+</ul>
+</li>
+<li><a href="types.html#_primitive-ecmascript-types">4.5. Primitive ECMAScript Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_undefined-type">4.5.1. Undefined Type</a></li>
+<li><a href="types.html#_null-type">4.5.2. Null Type</a></li>
+<li><a href="types.html#_primitive-boolean-type">4.5.3. Primitive Boolean Type</a></li>
+<li><a href="types.html#_primitive-string-type">4.5.4. Primitive String Type</a></li>
+<li><a href="types.html#_primitive-number-type">4.5.5. Primitive Number Type</a></li>
+<li><a href="types.html#_primitive-type-int">4.5.6. Primitive Type int</a></li>
+<li><a href="types.html#_primitive-symbol-type">4.5.7. Primitive Symbol Type</a></li>
+</ul>
+</li>
+<li><a href="types.html#_primitive-n4js-types">4.6. Primitive N4JS Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_any-type">4.6.1. Any Type</a>
+<ul class="sectlevel4">
+<li><a href="types.html#any-type-semantics">4.6.1.1. Semantics</a></li>
+<li><a href="types.html#any-type-type-inference">4.6.1.2. Type Inference</a>
+<ul class="sectlevel5">
+<li><a href="types.html#_default-type-of-variables">4.6.1.2.1. Default Type of Variables</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="types.html#_void-type">4.6.2. Void Type</a>
+<ul class="sectlevel4">
+<li><a href="types.html#void-type-semantics">4.6.2.1. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_unknown-type">4.6.3. Unknown Type</a></li>
+<li><a href="types.html#_primitive-pathselector-and-i18nkey">4.6.4. Primitive Pathselector and I18nKey</a>
+<ul class="sectlevel4">
+<li><a href="types.html#pathselector-semantics">4.6.4.1. Semantics</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="types.html#_built-in-ecmascript-object-types">4.7. Built-in ECMAScript Object Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#ECMAScript-objects-semantics">4.7.1. Semantics</a></li>
+<li><a href="types.html#_object-type">4.7.2. Object Type</a></li>
+<li><a href="types.html#_function-object-type">4.7.3. Function-Object-Type</a></li>
+<li><a href="types.html#_array-object-type">4.7.4. Array Object Type</a></li>
+<li><a href="types.html#_string-object-type">4.7.5. String Object Type</a></li>
+<li><a href="types.html#_boolean-object-type">4.7.6. Boolean Object Type</a></li>
+<li><a href="types.html#_number-object-type">4.7.7. Number Object Type</a></li>
+<li><a href="types.html#_global-object-type">4.7.8. Global Object Type</a></li>
+<li><a href="types.html#_symbol">4.7.9. Symbol</a></li>
+<li><a href="types.html#_promise">4.7.10. Promise</a></li>
+<li><a href="types.html#_iterator-interface">4.7.11. Iterator Interface</a></li>
+<li><a href="types.html#_iterable-interface">4.7.12. Iterable Interface</a></li>
+</ul>
+</li>
+<li><a href="types.html#_built-in-n4js-types">4.8. Built-In N4JS Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_n4object">4.8.1. N4Object</a>
+<ul class="sectlevel4">
+<li><a href="types.html#N4Object-semantics">4.8.1.1. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_n4class">4.8.2. N4Class</a></li>
+<li><a href="types.html#IterableN">4.8.3. IterableN</a></li>
+</ul>
+</li>
+<li><a href="types.html#_type-modifiers">4.9. Type Modifiers</a>
+<ul class="sectlevel3">
+<li><a href="types.html#Type_Modifiers_Dynamic">4.9.1. Dynamic</a></li>
+<li><a href="types.html#_optional-return-types">4.9.2. Optional Return Types</a></li>
+</ul>
+</li>
+<li><a href="types.html#_union-and-intersection-type-composed-types">4.10. Union and Intersection Type (Composed Types)</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_union-type">4.10.1. Union Type</a>
+<ul class="sectlevel4">
+<li><a href="types.html#union-type-syntax">4.10.1.1. Syntax</a></li>
+<li><a href="types.html#union-type-semantics">4.10.1.2. Semantics</a></li>
+<li><a href="types.html#_warnings">4.10.1.3. Warnings</a></li>
+</ul>
+</li>
+<li><a href="types.html#_intersection-type">4.10.2. Intersection Type</a>
+<ul class="sectlevel4">
+<li><a href="types.html#intersection-type-syntax">4.10.2.1. Syntax</a></li>
+<li><a href="types.html#intersection-type-semantics">4.10.2.2. Semantics</a></li>
+<li><a href="types.html#_warnings-2">4.10.2.3. Warnings</a></li>
+</ul>
+</li>
+<li><a href="types.html#_composed-types-in-wildcards">4.10.3. Composed Types in Wildcards</a></li>
+<li><a href="types.html#_property-access-for-composed-types">4.10.4. Property Access for Composed Types</a>
+<ul class="sectlevel4">
+<li><a href="types.html#_properties-of-union-type">4.10.4.1. Properties of Union Type</a>
+<ul class="sectlevel5">
+<li><a href="types.html#_remarks-on-union-type-s-members">4.10.4.1.1. Remarks on union type’s members:</a></li>
+</ul>
+</li>
+<li><a href="types.html#_properties-of-intersection-type">4.10.4.2. Properties of Intersection Type</a>
+<ul class="sectlevel5">
+<li><a href="types.html#_remarks-on-intersection-type-s-methods">4.10.4.2.1. Remarks on intersection type’s methods:</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="types.html#_constructor-and-classifier-type">4.11. Constructor and Classifier Type</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_syntax-3">4.11.1. Syntax</a></li>
+<li><a href="types.html#_semantics-2">4.11.2. Semantics</a></li>
+<li><a href="types.html#_constructors-and-prototypes-in-ecmascript-2015">4.11.3. Constructors and Prototypes in ECMAScript 2015</a></li>
+</ul>
+</li>
+<li><a href="types.html#_this-type">4.12. This Type</a>
+<ul class="sectlevel3">
+<li><a href="types.html#this-type-syntax">4.12.1. Syntax</a></li>
+<li><a href="types.html#this-keyword-semantics">4.12.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_enums">4.13. Enums</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_enums-n4js">4.13.1. Enums (N4JS)</a>
+<ul class="sectlevel4">
+<li><a href="types.html#enums-syntax">4.13.1.1. Syntax</a></li>
+<li><a href="types.html#enums-semantics">4.13.1.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_string-based-enums">4.13.2. String-Based Enums</a></li>
+</ul>
+</li>
+<li><a href="types.html#_short-hand-syntax">4.14. Short-Hand Syntax</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_array-short-hand-syntax">4.14.1. Array Short-Hand Syntax</a></li>
+<li><a href="types.html#_iterablen-short-hand-syntax">4.14.2. IterableN Short-Hand Syntax</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="classifiers.html#_classifiers">5. Classifiers</a>
+<ul class="sectlevel2">
+<li><a href="classifiers.html#_n4js-specific-classifiers">5.1. N4JS Specific Classifiers</a>
+<ul class="sectlevel3">
+<li><a href="classifiers.html#_properties-2">5.1.1. Properties</a></li>
+<li><a href="classifiers.html#_common-semantics-of-classifiers">5.1.2. Common Semantics of Classifiers</a></li>
+<li><a href="classifiers.html#_classes">5.1.3. Classes</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_definition-of-classes">5.1.3.1. Definition of Classes</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#class-syntax">5.1.3.1.1. Syntax</a></li>
+<li><a href="classifiers.html#class-properties">5.1.3.1.2. Properties</a></li>
+<li><a href="classifiers.html#class-type-inference">5.1.3.1.3. Type Inference</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#class-semantics">5.1.3.2. Semantics</a></li>
+<li><a href="classifiers.html#_final-modifier">5.1.3.3. Final Modifier</a></li>
+<li><a href="classifiers.html#_abstract-classes">5.1.3.4. Abstract Classes</a></li>
+<li><a href="classifiers.html#_non-instantiable-classes">5.1.3.5. Non-Instantiable Classes</a></li>
+<li><a href="classifiers.html#_superclass">5.1.3.6. Superclass</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_interfaces">5.1.4. Interfaces</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_definition-of-interfaces">5.1.4.1. Definition of Interfaces</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#interfaces-syntax">5.1.4.1.1. Syntax</a></li>
+<li><a href="classifiers.html#interfaces-properties">5.1.4.1.2. Properties</a></li>
+<li><a href="classifiers.html#interfaces-type-inference">5.1.4.1.3. Type Inference</a></li>
+<li><a href="classifiers.html#interfaces-semantics">5.1.4.1.4. Semantics</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="classifiers.html#_generic-classifiers">5.1.5. Generic Classifiers</a></li>
+<li><a href="classifiers.html#sec:definition-site-variance">5.1.6. Definition-Site Variance</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_members">5.2. Members</a>
+<ul class="sectlevel3">
+<li><a href="classifiers.html#_syntax-4">5.2.1. Syntax</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_properties-3">5.2.1.1. Properties</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_semantics-3">5.2.2. Semantics</a></li>
+<li><a href="classifiers.html#_methods">5.2.3. Methods</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_syntax-5">5.2.3.1. Syntax</a></li>
+<li><a href="classifiers.html#_properties-4">5.2.3.2. Properties</a></li>
+<li><a href="classifiers.html#_semantics-4">5.2.3.3. Semantics</a></li>
+<li><a href="classifiers.html#_final-methods">5.2.3.4. Final Methods</a></li>
+<li><a href="classifiers.html#_abstract-methods">5.2.3.5. Abstract Methods</a></li>
+<li><a href="classifiers.html#_generic-methods">5.2.3.6. Generic Methods</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_default-methods-in-interfaces">5.2.4. Default Methods in Interfaces</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_asynchronous-methods">5.2.4.1. Asynchronous Methods</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_constructors">5.2.5. Constructors</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_structural-this-type-in-constructor">5.2.5.1. Structural This Type in Constructor</a></li>
+<li><a href="classifiers.html#spec-constructor">5.2.5.2. @Spec Constructor</a></li>
+<li><a href="classifiers.html#_callable-constructors">5.2.5.3. Callable Constructors</a></li>
+<li><a href="classifiers.html#_covariant-constructors">5.2.5.4. Covariant Constructors</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_data-fields">5.2.6. Data Fields</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#data-fields-syntax">5.2.6.1. Syntax</a></li>
+<li><a href="classifiers.html#data-fields-properties">5.2.6.2. Properties</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#data-fields-semantics">5.2.6.2.1. Semantics</a></li>
+<li><a href="classifiers.html#data-fields-type-inference">5.2.6.2.2. Type Inference</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_assignment-modifiers">5.2.6.3. Assignment Modifiers</a></li>
+<li><a href="classifiers.html#_field-accessors-getter-setter">5.2.6.4. Field Accessors (Getter/Setter)</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#field-acessors-syntax">5.2.6.4.1. Syntax</a></li>
+<li><a href="classifiers.html#field-acessors-properties">5.2.6.4.2. Properties</a></li>
+<li><a href="classifiers.html#field-accessors-semantics">5.2.6.4.3. Semantics</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#optional-fields">5.2.6.5. Optional Fields</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#_syntax-6">5.2.6.5.1. Syntax</a></li>
+<li><a href="classifiers.html#_semantics-5">5.2.6.5.2. Semantics</a></li>
+<li><a href="classifiers.html#_background">5.2.6.5.3. Background</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="classifiers.html#_static-members">5.2.7. Static Members</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_access-from-and-to-static-members">5.2.7.1. Access From and To Static Members</a></li>
+<li><a href="classifiers.html#_generic-static-methods">5.2.7.2. Generic static methods</a></li>
+<li><a href="classifiers.html#_static-members-of-interfaces">5.2.7.3. Static Members of Interfaces</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_redefinition-of-members">5.2.8. Redefinition of Members</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_overriding-of-members">5.2.8.1. Overriding of Members</a></li>
+<li><a href="classifiers.html#_implementation-of-members">5.2.8.2. Implementation of Members</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#_member-consumption">5.2.8.2.1. Member Consumption</a></li>
+<li><a href="classifiers.html#_member-implementation">5.2.8.2.2. Member Implementation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="classifiers.html#_structural-typing">5.3. Structural Typing</a>
+<ul class="sectlevel3">
+<li><a href="classifiers.html#_syntax-7">5.3.1. Syntax</a></li>
+<li><a href="classifiers.html#_definition-site-structural-typing">5.3.2. Definition Site Structural Typing</a></li>
+<li><a href="classifiers.html#_use-site-structural-typing">5.3.3. Use-Site Structural Typing</a></li>
+<li><a href="classifiers.html#structural-readWriteInit-field-typing">5.3.4. Structural Read-only, Write-only and Initializer Field Typing</a></li>
+<li><a href="classifiers.html#_public-setter-annotated-with-code-providesinitializer-code">5.3.5. Public Setter Annotated With <code>ProvidesInitializer</code></a></li>
+<li><a href="classifiers.html#_structural-types-with-optional-fields">5.3.6. Structural Types With Optional Fields</a></li>
+<li><a href="classifiers.html#_structural-types-with-access-modifier">5.3.7. Structural Types With Access Modifier</a></li>
+<li><a href="classifiers.html#_structural-types-with-additional-members">5.3.8. Structural Types With Additional Members</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_syntax-8">5.3.8.1. Syntax</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#_semantics-6">5.3.8.1.1. Semantics</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="functions.html#_functions">6. Functions</a>
+<ul class="sectlevel2">
+<li><a href="functions.html#_function-type">6.1. Function Type</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_properties-5">6.1.1. Properties</a></li>
+<li><a href="functions.html#function-type-inference">6.1.2. Type Inference</a></li>
+<li><a href="functions.html#_autoboxing-of-function-type">6.1.3. Autoboxing of Function Type</a></li>
+<li><a href="functions.html#_arguments-object">6.1.4. Arguments Object</a></li>
+</ul>
+</li>
+<li><a href="functions.html#_ecmascript-5-function-definition">6.2. ECMAScript 5 Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_function-declaration">6.2.1. Function Declaration</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#_syntax-9">6.2.1.1. Syntax</a></li>
+<li><a href="functions.html#_semantics-8">6.2.1.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="functions.html#_function-expression">6.2.2. Function Expression</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#function-expression-syntax">6.2.2.1. Syntax</a></li>
+<li><a href="functions.html#_semantics-and-type-inference">6.2.2.2. Semantics and Type Inference</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="functions.html#_ecmascript-2015-function-definition">6.3. ECMAScript 2015 Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_formal-parameters">6.3.1. Formal Parameters</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#Type_Modifiers_Optional">6.3.1.1. Optional Parameters</a></li>
+<li><a href="functions.html#Type_Modifiers_Default">6.3.1.2. Default Parameters</a></li>
+<li><a href="functions.html#Type_Modifiers_Variadic">6.3.1.3. Variadic</a></li>
+</ul>
+</li>
+<li><a href="functions.html#_generator-functions">6.3.2. Generator Functions</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#generator-functions-syntax">6.3.2.1. Syntax</a></li>
+<li><a href="functions.html#generator-functions-semantics">6.3.2.2. Semantics</a></li>
+<li><a href="functions.html#_generator-arrow-functions">6.3.2.3. Generator Arrow Functions</a></li>
+</ul>
+</li>
+<li><a href="functions.html#_arrow-function-expression">6.3.3. Arrow Function Expression</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#arrow-function-expression-syntax">6.3.3.1. Syntax</a></li>
+<li><a href="functions.html#arrow-function-expression-semantics-and-type-inference">6.3.3.2. Semantics and Type Inference</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="functions.html#_ecmascript-proposals-function-definition">6.4. ECMAScript Proposals Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_asynchronous-functions">6.4.1. Asynchronous Functions</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#asynchronous-functions-syntax">6.4.1.1. Syntax</a></li>
+<li><a href="functions.html#asynchronous-functions-semantics">6.4.1.2. Semantics</a></li>
+<li><a href="functions.html#_asynchronous-arrow-functions">6.4.1.3. Asynchronous Arrow Functions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="functions.html#_n4js-extended-function-definition">6.5. N4JS Extended Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_generic-functions">6.5.1. Generic Functions</a></li>
+<li><a href="functions.html#_promisifiable-functions">6.5.2. Promisifiable Functions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_conversions-and-reflection">7. Conversions and Reflection</a>
+<ul class="sectlevel2">
+<li><a href="conversions_and_reflection.html#_autoboxing-and-coercing">7.1. Autoboxing and Coercing</a>
+<ul class="sectlevel3">
+<li><a href="conversions_and_reflection.html#_coercing">7.1.1. Coercing</a></li>
+<li><a href="conversions_and_reflection.html#_autoboxing-of-primitives">7.1.2. Autoboxing of Primitives</a></li>
+<li><a href="conversions_and_reflection.html#_autoboxing-of-function-expressions-and-declarations">7.1.3. Autoboxing of Function Expressions and Declarations</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_auto-conversion-of-objects">7.2. Auto-Conversion of Objects</a>
+<ul class="sectlevel3">
+<li><a href="conversions_and_reflection.html#_auto-conversion-of-class-instances">7.2.1. Auto-Conversion of Class Instances</a>
+<ul class="sectlevel4">
+<li><a href="conversions_and_reflection.html#_auto-conversion-of-interface-instances">7.2.1.1. Auto-Conversion of Interface Instances</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_auto-conversion-of-enum-literals">7.2.2. Auto-Conversion of Enum Literals</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_type-cast-and-type-check">7.3. Type Cast and Type Check</a>
+<ul class="sectlevel3">
+<li><a href="conversions_and_reflection.html#_type-cast">7.3.1. Type Cast</a></li>
+<li><a href="conversions_and_reflection.html#_type-check">7.3.2. Type Check</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_reflection-meta-information">7.4. Reflection meta-information</a>
+<ul class="sectlevel3">
+<li><a href="conversions_and_reflection.html#_reflection-for-classes">7.4.1. Reflection for Classes</a></li>
+<li><a href="conversions_and_reflection.html#_reflection-for-interfaces">7.4.2. Reflection for Interfaces</a></li>
+<li><a href="conversions_and_reflection.html#_reflection-for-enumerations">7.4.3. Reflection for Enumerations</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_conversion-of-primitive-types">7.5. Conversion of primitive types</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_expressions">8. Expressions</a>
+<ul class="sectlevel2">
+<li><a href="expressions.html#_ecmascript-5-expressions">8.1. ECMAScript 5 Expressions</a>
+<ul class="sectlevel3">
+<li><a href="expressions.html#_the-this-literal">8.1.1. The this Literal</a></li>
+<li><a href="expressions.html#_identifier">8.1.2. Identifier</a></li>
+<li><a href="expressions.html#_literals">8.1.3. Literals</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#_integer-literals">8.1.3.1. Integer Literals</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_array-literal">8.1.4. Array Literal</a></li>
+<li><a href="expressions.html#_object-literal">8.1.5. Object Literal</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#_properties-6">8.1.5.1. Properties</a></li>
+<li><a href="expressions.html#_scoping-and-linking">8.1.5.2. Scoping and linking</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_parenthesized-expression-and-grouping-operator">8.1.6. Parenthesized Expression and Grouping Operator</a></li>
+<li><a href="expressions.html#_property-accessors">8.1.7. Property Accessors</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#properties-1">8.1.7.1. Properties</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_new-expression">8.1.8. New Expression</a></li>
+<li><a href="expressions.html#_function-expression-2">8.1.9. Function Expression</a></li>
+<li><a href="expressions.html#_function-calls">8.1.10. Function Calls</a></li>
+<li><a href="expressions.html#_postfix-expression">8.1.11. Postfix Expression</a></li>
+<li><a href="expressions.html#_unary-expression">8.1.12. Unary Expression</a></li>
+<li><a href="expressions.html#_multiplicative-expression">8.1.13. Multiplicative Expression</a></li>
+<li><a href="expressions.html#_additive-expression">8.1.14. Additive Expression</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#type-inference-10">8.1.14.1. Type Inference</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_bitwise-shift-expression">8.1.15. Bitwise Shift Expression</a></li>
+<li><a href="expressions.html#_relational-expression">8.1.16. Relational Expression</a></li>
+<li><a href="expressions.html#_equality-expression">8.1.17. Equality Expression</a></li>
+<li><a href="expressions.html#_binary-bitwise-expression">8.1.18. Binary Bitwise Expression</a></li>
+<li><a href="expressions.html#_binary-logical-expression">8.1.19. Binary Logical Expression</a></li>
+<li><a href="expressions.html#_conditional-expression">8.1.20. Conditional Expression</a></li>
+<li><a href="expressions.html#_assignment-expression">8.1.21. Assignment Expression</a></li>
+<li><a href="expressions.html#_comma-expression">8.1.22. Comma Expression</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_ecmascript-6-expressions">8.2. ECMAScript 6 Expressions</a>
+<ul class="sectlevel3">
+<li><a href="expressions.html#_the-super-keyword">8.2.1. The super Keyword</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_ecmascript-7-expressions">8.3. ECMAScript 7 Expressions</a>
+<ul class="sectlevel3">
+<li><a href="expressions.html#_await-expression">8.3.1. Await Expression</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_n4js-specific-expressions">8.4. N4JS Specific Expressions</a>
+<ul class="sectlevel3">
+<li><a href="expressions.html#_class-expression">8.4.1. Class Expression</a></li>
+<li><a href="expressions.html#_cast-as-expression">8.4.2. Cast (As) Expression</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#cast-as-expression-semantics-type-inference">8.4.2.1. Semantics and Type Inference</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#Import_Calls">8.4.3. Import Calls</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#compile-time-expressions">8.5. Compile-Time Expressions</a></li>
+</ul>
+</li>
+<li><a href="statements.html#_statements">9. Statements</a>
+<ul class="sectlevel2">
+<li><a href="statements.html#_ecmascript-5-statements">9.1. ECMAScript 5 Statements</a>
+<ul class="sectlevel3">
+<li><a href="statements.html#_function-or-field-accessor-bodies">9.1.1. Function or Field Accessor Bodies</a></li>
+<li><a href="statements.html#_variable-statement">9.1.2. Variable Statement</a></li>
+<li><a href="statements.html#_if-statement">9.1.3. If Statement</a></li>
+<li><a href="statements.html#_iteration-statements">9.1.4. Iteration Statements</a></li>
+<li><a href="statements.html#_return-statement">9.1.5. Return Statement</a></li>
+<li><a href="statements.html#_with-statement">9.1.6. With Statement</a></li>
+<li><a href="statements.html#_switch-statement">9.1.7. Switch Statement</a></li>
+<li><a href="statements.html#_throw-try-and-catch-statements">9.1.8. Throw, Try, and Catch Statements</a></li>
+<li><a href="statements.html#_debugger-statement">9.1.9. Debugger Statement</a></li>
+</ul>
+</li>
+<li><a href="statements.html#_ecmascript-6-statements">9.2. ECMAScript 6 Statements</a>
+<ul class="sectlevel3">
+<li><a href="statements.html#_let">9.2.1. Let</a></li>
+<li><a href="statements.html#_const">9.2.2. Const</a></li>
+<li><a href="statements.html#_for-of-statement">9.2.3. <code>for &#8230;&#8203; of</code> statement</a></li>
+<li><a href="statements.html#_import-statement">9.2.4. Import Statement</a>
+<ul class="sectlevel4">
+<li><a href="statements.html#Dynamic_Imports">9.2.4.1. Dynamic Imports</a></li>
+<li><a href="statements.html#_immutabilaty-of-imports">9.2.4.2. Immutabilaty of Imports</a></li>
+</ul>
+</li>
+<li><a href="statements.html#_export-statement">9.2.5. Export Statement</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="annotations.html#_annotations">10. Annotations</a>
+<ul class="sectlevel2">
+<li><a href="annotations.html#_introduction-2">10.1. Introduction</a>
+<ul class="sectlevel3">
+<li><a href="annotations.html#_syntax-13">10.1.1. Syntax</a></li>
+<li><a href="annotations.html#_properties-7">10.1.2. Properties</a></li>
+<li><a href="annotations.html#_element-specific-annotations">10.1.3. Element-Specific Annotations</a></li>
+<li><a href="annotations.html#_general-annotations">10.1.4. General Annotations</a>
+<ul class="sectlevel4">
+<li><a href="annotations.html#_idebug">10.1.4.1. IDEBUG</a></li>
+</ul>
+</li>
+<li><a href="annotations.html#idebug-syntax">10.1.5. Syntax</a>
+<ul class="sectlevel4">
+<li><a href="annotations.html#_semantics-11">10.1.5.1. Semantics</a></li>
+<li><a href="annotations.html#_suppress-warnings">10.1.5.2. Suppress Warnings</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="annotations.html#_declaration-of-annotations">10.2. Declaration of Annotations</a></li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_extended-fetaures">11. Extended Fetaures</a>
+<ul class="sectlevel2">
+<li><a href="extended_fetaures.html#_array-and-object-destructuring">11.1. Array and Object Destructuring</a>
+<ul class="sectlevel3">
+<li><a href="extended_fetaures.html#_syntax-14">11.1.1. Syntax</a></li>
+<li><a href="extended_fetaures.html#_semantics-12">11.1.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_dependency-injection">11.2. Dependency Injection</a>
+<ul class="sectlevel3">
+<li><a href="extended_fetaures.html#_di-components-and-injectors">11.2.1. DI Components and Injectors</a>
+<ul class="sectlevel4">
+<li><a href="extended_fetaures.html#_dicomponent-relations">11.2.1.1. DIComponent Relations</a></li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_binders-and-bindings">11.2.2. Binders and Bindings</a></li>
+<li><a href="extended_fetaures.html#_injection-points">11.2.3. Injection Points</a>
+<ul class="sectlevel4">
+<li><a href="extended_fetaures.html#_field-injection">11.2.3.1. Field Injection</a></li>
+<li><a href="extended_fetaures.html#_constructor-injection">11.2.3.2. Constructor Injection</a></li>
+<li><a href="extended_fetaures.html#_method-injection">11.2.3.3. Method Injection</a>
+<ul class="sectlevel5">
+<li><a href="extended_fetaures.html#_provider">11.2.3.3.1. Provider</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_n4js-di-life-cycle-and-scopes">11.2.4. N4JS DI Life Cycle and Scopes</a>
+<ul class="sectlevel4">
+<li><a href="extended_fetaures.html#_injection-cylces">11.2.4.1. Injection Cylces</a></li>
+<li><a href="extended_fetaures.html#_default-scope">11.2.4.2. Default Scope</a></li>
+<li><a href="extended_fetaures.html#_singleton-scope">11.2.4.3. Singleton Scope</a></li>
+<li><a href="extended_fetaures.html#_per-injection-chain-singleton">11.2.4.4. Per Injection Chain Singleton</a></li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_validation-of-callsites-targeting-n4injector-methods">11.2.5. Validation of callsites targeting N4Injector methods</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-annotations">11.2.6. N4JS DI Annotations</a>
+<ul class="sectlevel4">
+<li><a href="extended_fetaures.html#_n4js-di-generateinjector">11.2.6.1. N4JS DI @GenerateInjector</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-withparentinjector">11.2.6.2. N4JS DI @WithParentInjector</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-usebinder">11.2.6.3. N4JS DI @UseBinder</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-binder">11.2.6.4. N4JS DI @Binder</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-bind">11.2.6.5. N4JS DI @Bind</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-provides">11.2.6.6. N4JS DI @Provides</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-inject">11.2.6.7. N4JS DI @Inject</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-singleton">11.2.6.8. N4JS DI @Singleton</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_test-support">11.3. Test Support</a></li>
+<li><a href="extended_fetaures.html#_polyfill-definitions">11.4. Polyfill Definitions</a>
+<ul class="sectlevel3">
+<li><a href="extended_fetaures.html#_runtime-polyfill-definitions">11.4.1. Runtime Polyfill Definitions</a></li>
+<li><a href="extended_fetaures.html#_static-polyfill-definitions">11.4.2. Static Polyfill Definitions</a></li>
+<li><a href="extended_fetaures.html#_transpiling-static-polyfilled-classes">11.4.3. Transpiling static polyfilled classes</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="components.html#_components">12. Components</a>
+<ul class="sectlevel2">
+<li><a href="components.html#_overview-2">12.1. Overview</a></li>
+<li><a href="components.html#Component_Types">12.2. Component Types</a>
+<ul class="sectlevel3">
+<li><a href="components.html#_libraries">12.2.1. Libraries</a></li>
+<li><a href="components.html#_runtime-environment-and-runtime-libraries">12.2.2. Runtime Environment and Runtime Libraries</a></li>
+<li><a href="components.html#_tests">12.2.3. Tests</a></li>
+<li><a href="components.html#_type-definitions">12.2.4. Type Definitions</a></li>
+</ul>
+</li>
+<li><a href="components.html#package-json">12.3. Package.json File</a>
+<ul class="sectlevel3">
+<li><a href="components.html#_basic-properties">12.3.1. Basic Properties</a></li>
+<li><a href="components.html#_n4js-properties">12.3.2. N4JS Properties</a></li>
+<li><a href="components.html#_constraints">12.3.3. Constraints</a></li>
+</ul>
+</li>
+<li><a href="components.html#_support-for-npm-scopes">12.4. Support for NPM Scopes</a></li>
+<li><a href="components.html#sec:N4JS-Type-Definitions">12.5. N4JS Type Definitions</a>
+<ul class="sectlevel3">
+<li><a href="components.html#_specify-type-definition">12.5.1. Specify Type Definition</a></li>
+<li><a href="components.html#_name-conventions">12.5.2. Name Conventions</a></li>
+<li><a href="components.html#_version-conventions">12.5.3. Version Conventions</a>
+<ul class="sectlevel4">
+<li><a href="components.html#_define-a-new-type-definition-package">12.5.3.1. Define a New Type Definition Package</a></li>
+<li><a href="components.html#_using-a-type-definition-package">12.5.3.2. Using a Type Definition Package</a></li>
+<li><a href="components.html#_rational">12.5.3.3. Rational</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="components.html#_modules">12.6. Modules</a></li>
+<li><a href="components.html#_api-and-implementation-component">12.7. API and Implementation Component</a>
+<ul class="sectlevel3">
+<li><a href="components.html#_execution-of-api-and-implementation-components">12.7.1. Execution of API and Implementation Components</a></li>
+<li><a href="components.html#_api-and-implementation-with-di">12.7.2. API and Implementation With DI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="plainjs.html#_plainjs">13. PlainJS</a>
+<ul class="sectlevel2">
+<li><a href="plainjs.html#_type-inference-and-validation-for-plain-js">13.1. Type Inference and Validation for Plain JS</a></li>
+<li><a href="plainjs.html#_external-declarations">13.2. External Declarations</a>
+<ul class="sectlevel3">
+<li><a href="plainjs.html#_declaring-externals">13.2.1. Declaring externals</a></li>
+<li><a href="plainjs.html#_instantiating-external-classes">13.2.2. Instantiating external classes</a></li>
+<li><a href="plainjs.html#_implementation-of-external-declarations">13.2.3. Implementation of External Declarations</a></li>
+<li><a href="plainjs.html#_example">13.2.4. Example</a></li>
+</ul>
+</li>
+<li><a href="plainjs.html#_global-definitions">13.3. Global Definitions</a></li>
+<li><a href="plainjs.html#_runtime-definitions">13.4. Runtime Definitions</a></li>
+<li><a href="plainjs.html#_applying-polyfills">13.5. Applying Polyfills</a></li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_jsdoc-2">14. JSDoc</a>
+<ul class="sectlevel2">
+<li><a href="jsdoc.html#_general-n4jsdoc-features">14.1. General N4JSDoc Features</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#_provided-inline-tags">14.1.1. Provided Inline Tags</a>
+<ul class="sectlevel4">
+<li><a href="jsdoc.html#jsdoc_tag__code">14.1.1.1. @code</a></li>
+<li><a href="jsdoc.html#jsdoc_tag__link">14.1.1.2. @link</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_n4jsdoc-for-user-projects">14.2. N4JSdoc for User Projects</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#_standard-tags">14.2.1. Standard Tags</a>
+<ul class="sectlevel4">
+<li><a href="jsdoc.html#_-author">14.2.1.1. @author</a></li>
+<li><a href="jsdoc.html#jsdoc_tag_param">14.2.1.2. @param</a></li>
+<li><a href="jsdoc.html#jsdoc_tag_return">14.2.1.3. @return</a></li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_test-related-tags">14.2.2. Test Related Tags</a>
+<ul class="sectlevel4">
+<li><a href="jsdoc.html#jsdoc_tag__testee">14.2.2.1. @testee</a></li>
+<li><a href="jsdoc.html#jsdoc_tag__testeeFromType">14.2.2.2. @testeeFromType</a></li>
+<li><a href="jsdoc.html#_testeeType_and__testeeMember">14.2.2.3. @testeeType and @testeeMember</a></li>
+<li><a href="jsdoc.html#jsdoc_tag_reqid_in_Tests">14.2.2.4. @reqid in Tests</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_n4jsdoc-for-api-and-implementation-projects">14.3. N4JSDoc for API and Implementation Projects</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#jsdoc_tag__apiNote">14.3.1. @apiNote</a></li>
+<li><a href="jsdoc.html#API_Project_Tags">14.3.2. API Project Tags</a>
+<ul class="sectlevel4">
+<li><a href="jsdoc.html#jsdoc_tag_apiState">14.3.2.1. @apiState</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsx.html#_jsx">15. JSX</a>
+<ul class="sectlevel2">
+<li><a href="jsx.html#_jsx-support">15.1. JSX Support</a></li>
+<li><a href="jsx.html#_jsx-backend">15.2. JSX Backend</a></li>
+</ul>
+</li>
+<li><a href="#_grammars">16. Grammars</a>
+<ul class="sectlevel2">
+<li><a href="#_type-expressions-grammar">16.1. Type Expressions Grammar</a></li>
+<li><a href="#_n4js-language-grammar">16.2. N4JS Language Grammar</a></li>
+</ul>
+</li>
+<li><a href="jsobjects.html#_jsobjects">17. JSObjects</a>
+<ul class="sectlevel2">
+<li><a href="jsobjects.html#_object">17.1. Object</a></li>
+<li><a href="jsobjects.html#_string">17.2. String</a></li>
+<li><a href="jsobjects.html#_boolean">17.3. Boolean</a></li>
+<li><a href="jsobjects.html#_number">17.4. Number</a>
+<ul class="sectlevel3">
+<li><a href="jsobjects.html#_static-attributes">17.4.1. Static Attributes</a></li>
+</ul>
+</li>
+<li><a href="jsobjects.html#function">17.5. Function</a></li>
+<li><a href="jsobjects.html#_error">17.6. Error</a></li>
+<li><a href="jsobjects.html#_array">17.7. Array</a></li>
+<li><a href="jsobjects.html#_date">17.8. Date</a></li>
+<li><a href="jsobjects.html#_math">17.9. Math</a>
+<ul class="sectlevel3">
+<li><a href="jsobjects.html#static-attributes-1">17.9.1. Static Attributes</a></li>
+</ul>
+</li>
+<li><a href="jsobjects.html#_regexp">17.10. RegExp</a></li>
+<li><a href="jsobjects.html#_json">17.11. JSON</a></li>
+</ul>
+</li>
+<li><a href="n4js_objects.html#_n4js-objects">18. N4JS Objects</a>
+<ul class="sectlevel2">
+<li><a href="n4js_objects.html#_reflection-model">18.1. Reflection Model</a></li>
+<li><a href="n4js_objects.html#_error-types">18.2. Error Types</a>
+<ul class="sectlevel3">
+<li><a href="n4js_objects.html#_n4apinotimplemented">18.2.1. N4ApiNotImplemented</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_acronyms.html#_acronyms">Appendix A: Acronyms</a></li>
+<li><a href="appendix_b_license.html#sec:License">Appendix B: License</a></li>
+<li><a href="appendix_c_bibliography.html#_bibliography">Appendix C: Bibliography</a></li>
+</ul>
+</div>
+</div>
+<div id="content"><div class="sect1">
+<h2 id="_grammars"><a class="anchor" href="#_grammars"></a><a class="link" href="#_grammars">16. Grammars</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>N4JS extends the ECMAScript 2015 language grammar and combines it with type expression.</p>
+</div>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title=""></i>
+</td>
+<td class="content">
+These grammars are slightly simplified versions of the "real" Xtext grammars used in the implementation.
+These grammars are post-processed and combined with additional validators so not all constructs are necessarily available in N4JS.
+</td>
+</tr>
+</table>
+</div>
+<div class="sect2">
+<h3 id="_type-expressions-grammar"><a class="anchor" href="#_type-expressions-grammar"></a><a class="link" href="#_type-expressions-grammar">16.1. Type Expressions Grammar</a></h3>
+<div id="lst:EBNFTypeExpression" class="listingblock">
+<div class="title">EBNF Type Expression Grammar</div>
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">TypeRef:
+    TypeRefWithoutModifiers =&gt;undefModifier=UndefModifierToken?
+    | undefModifier=UndefModifierToken;
+
+TypeRefWithoutModifiers:
+      ((ParameterizedTypeRef | ThisTypeRef) =&gt; dynamic?='+'?)
+    | ConstructorTypeRef
+    | ClassifierTypeRef
+    | FunctionTypeExpression
+    | UnionTypeExpression
+    | IntersectionTypeExpression;
+
+TypeRefFunctionTypeExpression:
+      ParameterizedTypeRef
+    | ConstructorTypeRef
+    | ClassifierTypeRef
+    | UnionTypeExpression
+    | IntersectionTypeExpression
+    ;
+
+TypeRefForCast:
+      ParameterizedTypeRef
+    | ThisTypeRef
+    | ConstructorTypeRef
+    | ClassifierTypeRef
+    | FunctionTypeExpression;
+
+TypeRefInClassifierType:
+      ParameterizedTypeRefNominal
+    | ThisTypeRefNominal;
+
+
+ThisTypeRef:
+    ThisTypeRefNominal | ThisTypeRefStructural;
+
+ThisTypeRefNominal:
+    'this';
+
+ThisTypeRefStructural:
+    definedTypingStrategy=TypingStrategyUseSiteOperator
+    'this'
+    ('with' TStructMemberList)?;
+
+FunctionTypeExpression:
+    '{'
+    ('@' 'This' '(' declaredThisType=TypeRefFunctionTypeExpression ')')?
+    'function'
+    ('&lt;' ownedTypeVars+=TypeVariable (',' ownedTypeVars+=TypeVariable)* '&gt;')?
+    '(' TAnonymousFormalParameterList ')'
+    (':' returnTypeRef=TypeRef)?
+    '}';
+
+fragment TAnonymousFormalParameterList*:
+    (fpars+=TAnonymousFormalParameter (',' fpars+=TAnonymousFormalParameter)*)?
+;
+
+TAnonymousFormalParameter:
+    variadic?='...'? (=&gt; name=TIdentifier ':')? typeRef=TypeRef
+;
+
+UnionTypeExpression:
+    'union' '{' typeRefs+=TypeRefWithoutModifiers (',' typeRefs+=TypeRefWithoutModifiers)* '}';
+
+IntersectionTypeExpression:
+    'intersection' '{' typeRefs+=TypeRefWithoutModifiers (',' typeRefs+=TypeRefWithoutModifiers)* '}';
+
+ParameterizedTypeRef:
+    ParameterizedTypeRefNominal | ParameterizedTypeRefStructural;
+
+ParameterizedTypeRefStructural:
+    definedTypingStrategy=TypingStrategyUseSiteOperator
+    declaredType=[Type|TypeReferenceName]
+    (=&gt;'&lt;' typeArgs+=TypeArgument (',' typeArgs+=TypeArgument)* '&gt;')?
+    ('with' TStructMemberList)?;
+
+fragment TStructMemberList*:  '{' (astStructuralMembers+=TStructMember (';'|',')?)*  '}';
+
+TStructMember:
+      TStructGetter
+    | TStructSetter
+    | TStructMethod
+    | TStructField;
+
+TStructMethod:
+    =&gt;
+    (('&lt;' typeVars+=TypeVariable (',' typeVars+=TypeVariable)* '&gt;')?
+        name=TypesIdentifier '('
+    ) TAnonymousFormalParameterList ')'
+    (':' returnTypeRef=TypeRef)?
+;
+
+TStructField:
+    name=TypesIdentifier (':' typeRef=TypeRef)?
+;
+
+TStructGetter:
+    =&gt; ('get'
+    name=TypesIdentifier)
+    '(' ')' (':' declaredTypeRef=TypeRef)?
+;
+
+TStructSetter:
+    =&gt; ('set'
+    name=TypesIdentifier)
+    '(' fpar=TAnonymousFormalParameter ')'
+;
+
+ParameterizedTypeRefNominal:
+    declaredType=[Type|TypeReferenceName]
+    (=&gt; '&lt;' typeArgs+=TypeArgument (',' typeArgs+=TypeArgument)* '&gt;')?;
+
+TypingStrategyUseSiteOperator:
+    '~' ('~' | STRUCTMODSUFFIX)?;
+
+TypingStrategyDefSiteOperator:
+    '~';
+
+terminal STRUCTMODSUFFIX:
+    ('r' | 'i' | 'w') '~'
+;
+
+ConstructorTypeRef:
+    'constructor' '{' staticTypeRef=TypeRefInClassifierType '}';
+
+ClassifierTypeRef:
+    'type' '{' staticTypeRef=TypeRefInClassifierType '}';
+
+TypeReferenceName:
+    IDENTIFIER ('.' IDENTIFIER)*;
+
+TypeArgument:
+    Wildcard | TypeRef;
+
+Wildcard:
+    =&gt; ('?') (('extends' declaredUpperBound=TypeRef) | ('super'
+    declaredLowerBound=TypeRef))?;
+
+UndefModifierToken:
+    '?';
+
+TypeVariable:
+    name=IDENTIFIER ('extends' declaredUpperBounds+=ParameterizedTypeRef ('&amp;'
+    declaredUpperBounds+=ParameterizedTypeRef)*)?;
+
+TypesIdentifier:
+    IDENTIFIER
+    | 'get' | 'set' | 'abstract' | 'project'
+    | 'union' | 'intersection'
+    | 'as' | 'from' | 'type' | 'void' | 'null';
+
+TIdentifier:
+    TypesIdentifier
+    | 'implements' | 'interface'
+    | 'private' | 'protected' | 'public'
+    | 'static'
+;
+
+terminal IDENTIFIER:
+    IDENTIFIER_START IDENTIFIER_PART*;
+
+terminal INT:
+    DECIMAL_INTEGER_LITERAL_FRAGMENT;
+
+terminal ML_COMMENT:
+    ML_COMMENT_FRAGMENT;
+
+terminal SL_COMMENT:
+    '//' (!LINE_TERMINATOR_FRAGMENT)*;
+
+terminal EOL:
+    LINE_TERMINATOR_SEQUENCE_FRAGMENT;
+
+terminal WS:
+    WHITESPACE_FRAGMENT+;
+
+terminal fragment UNICODE_ESCAPE_FRAGMENT:
+    '\\' ('u' (
+        HEX_DIGIT (HEX_DIGIT (HEX_DIGIT HEX_DIGIT?)?)?
+      | '{' HEX_DIGIT* '}'?
+    )?)?;
+
+terminal fragment IDENTIFIER_START:
+      UNICODE_LETTER_FRAGMENT
+    | '$'
+    | '_'
+    | UNICODE_ESCAPE_FRAGMENT;
+
+terminal fragment IDENTIFIER_PART:
+      UNICODE_LETTER_FRAGMENT
+    | UNICODE_ESCAPE_FRAGMENT
+    | '$'
+    | UNICODE_COMBINING_MARK_FRAGMENT
+    | UNICODE_DIGIT_FRAGMENT
+    | UNICODE_CONNECTOR_PUNCTUATION_FRAGMENT
+    | ZWNJ
+    | ZWJ;
+
+terminal DOT_DOT:
+    '..'
+;</code></pre>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_n4js-language-grammar"><a class="anchor" href="#_n4js-language-grammar"></a><a class="link" href="#_n4js-language-grammar">16.2. N4JS Language Grammar</a></h3>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">Script: annotations+=ScriptAnnotation*
+    scriptElements+=ScriptElement*;
+
+ScriptElement:
+      AnnotatedScriptElement
+    | N4ClassDeclaration&lt;Yield=false&gt;
+    | N4InterfaceDeclaration&lt;Yield=false&gt;
+    | N4EnumDeclaration&lt;Yield=false&gt;
+    | ImportDeclaration
+    | ExportDeclaration
+    | RootStatement&lt;Yield=false&gt;
+;
+
+AnnotatedScriptElement:
+    AnnotationList (
+        {ExportDeclaration.annotationList=current} ExportDeclarationImpl
+    |   {ImportDeclaration.annotationList=current} ImportDeclarationImpl
+    |   {FunctionDeclaration.annotationList=current}
+        =&gt;((declaredModifiers+=N4Modifier)* AsyncNoTrailingLineBreak
+            -&gt;FunctionImpl&lt;Yield=false,YieldIfGenerator=false,Expression=false&gt;)
+    |   (
+            (
+                {N4ClassDeclaration.annotationList=current}
+                (declaredModifiers+=N4Modifier)*
+                'class' typingStrategy=TypingStrategyDefSiteOperator?
+                name=BindingIdentifier&lt;Yield=false&gt;
+                TypeVariables?
+                ClassExtendsClause&lt;Yield=false&gt;?
+            |   {N4InterfaceDeclaration.annotationList=current}
+                (declaredModifiers+=N4Modifier)*
+                'interface' typingStrategy=TypingStrategyDefSiteOperator? name=BindingIdentifier&lt;Yield=false&gt;
+                TypeVariables?
+                InterfaceImplementsList?
+            )
+            Members&lt;Yield=false&gt;
+        )
+    |   {N4EnumDeclaration.annotationList=current}
+        (declaredModifiers+=N4Modifier)*
+        'enum' name=BindingIdentifier&lt;Yield=false&gt;
+        '{'
+            literals+=N4EnumLiteral (',' literals+= N4EnumLiteral)*
+        '}'
+    )
+;
+
+fragment TypeVariables*:
+    '&lt;' typeVars+=TypeVariable (',' typeVars+=TypeVariable)* '&gt;'
+;
+
+ExportDeclaration:
+    ExportDeclarationImpl
+;
+
+fragment ExportDeclarationImpl*:
+    'export' (
+        wildcardExport?='*' ExportFromClause Semi
+    |   ExportClause -&gt;ExportFromClause? Semi
+    |   exportedElement=ExportableElement
+    |   defaultExport?='default' (-&gt;exportedElement=ExportableElement | defaultExportedExpression=AssignmentExpression&lt;In=true,Yield=false&gt; Semi)
+    )
+;
+
+fragment ExportFromClause*:
+    'from' reexportedFrom=[types::TModule|ModuleSpecifier]
+;
+
+fragment ExportClause*:
+    '{'
+        (namedExports+=ExportSpecifier (',' namedExports+=ExportSpecifier)* ','?)?
+    '}'
+;
+
+ExportSpecifier:
+    element=IdentifierRef&lt;Yield=false&gt; ('as' alias=IdentifierName)?
+;
+
+ExportableElement:
+      AnnotatedExportableElement&lt;Yield=false&gt;
+    | N4ClassDeclaration&lt;Yield=false&gt;
+    | N4InterfaceDeclaration&lt;Yield=false&gt;
+    | N4EnumDeclaration&lt;Yield=false&gt;
+    | ExportedFunctionDeclaration&lt;Yield=false&gt;
+    | ExportedVariableStatement
+;
+
+AnnotatedExportableElement &lt;Yield&gt;:
+    AnnotationList (
+        {FunctionDeclaration.annotationList=current}
+        (declaredModifiers+=N4Modifier)* AsyncNoTrailingLineBreak
+        FunctionImpl&lt;Yield, Yield, Expression=false&gt;
+    |   {ExportedVariableStatement.annotationList=current}
+        (declaredModifiers+=N4Modifier)*
+        varStmtKeyword=VariableStatementKeyword
+        varDeclsOrBindings+=ExportedVariableDeclarationOrBinding&lt;Yield&gt; ( ',' varDeclsOrBindings+=ExportedVariableDeclarationOrBinding&lt;Yield&gt; )* Semi
+    |   (
+            (
+                {N4ClassDeclaration.annotationList=current}
+                (declaredModifiers+=N4Modifier)*
+                'class' typingStrategy=TypingStrategyDefSiteOperator?
+                name=BindingIdentifier&lt;Yield&gt;
+                TypeVariables?
+                ClassExtendsClause&lt;Yield&gt;?
+            |   {N4InterfaceDeclaration.annotationList=current}
+                (declaredModifiers+=N4Modifier)*
+                ('interface') typingStrategy=TypingStrategyDefSiteOperator? name=BindingIdentifier&lt;Yield&gt;
+                TypeVariables?
+                InterfaceImplementsList?
+            )
+            Members&lt;Yield&gt;
+        )
+    |   {N4EnumDeclaration.annotationList=current}
+        (declaredModifiers+=N4Modifier)*
+        'enum' name=BindingIdentifier&lt;Yield&gt;
+        '{'
+            literals+=N4EnumLiteral (',' literals+= N4EnumLiteral)*
+        '}'
+    )
+;
+
+ImportDeclaration:
+    ImportDeclarationImpl
+;
+
+fragment ImportDeclarationImpl*:
+    'import' (
+        ImportClause importFrom?='from'
+    )? module=[types::TModule|ModuleSpecifier] Semi
+;
+
+fragment ImportClause*:
+        importSpecifiers+=DefaultImportSpecifier (',' ImportSpecifiersExceptDefault)?
+    |   ImportSpecifiersExceptDefault
+;
+
+fragment ImportSpecifiersExceptDefault*:
+        importSpecifiers+=NamespaceImportSpecifier
+    |   '{' (importSpecifiers+=NamedImportSpecifier (',' importSpecifiers+=NamedImportSpecifier)* ','?)? '}'
+;
+
+NamedImportSpecifier:
+        importedElement=[types::TExportableElement|BindingIdentifier&lt;Yield=false&gt;]
+    |   importedElement=[types::TExportableElement|IdentifierName] 'as' alias=BindingIdentifier&lt;Yield=false&gt;
+;
+
+DefaultImportSpecifier:
+    importedElement=[types::TExportableElement|BindingIdentifier&lt;Yield=false&gt;]
+;
+
+NamespaceImportSpecifier: '*' 'as' alias=BindingIdentifier&lt;false&gt; (declaredDynamic?='+')?;
+
+ModuleSpecifier: STRING;
+
+FunctionDeclaration &lt;Yield&gt;:
+    =&gt; ((declaredModifiers+=N4Modifier)* AsyncNoTrailingLineBreak
+        -&gt; FunctionImpl &lt;Yield,Yield,Expression=false&gt;
+    ) =&gt; Semi?
+;
+
+fragment AsyncNoTrailingLineBreak *: (declaredAsync?='async' NoLineTerminator)?;
+
+fragment FunctionImpl&lt;Yield, YieldIfGenerator, Expression&gt;*:
+    'function'
+    (
+        generator?='*' FunctionHeader&lt;YieldIfGenerator,Generator=true&gt; FunctionBody&lt;Yield=true,Expression&gt;
+    |   FunctionHeader&lt;Yield,Generator=false&gt; FunctionBody&lt;Yield=false,Expression&gt;
+    )
+;
+
+fragment FunctionHeader&lt;Yield, Generator&gt;*:
+    TypeVariables?
+    name=BindingIdentifier&lt;Yield&gt;?
+    StrictFormalParameters&lt;Yield=Generator&gt;
+    (-&gt; ':' returnTypeRef=TypeRef)?
+;
+
+fragment FunctionBody &lt;Yield, Expression&gt;*:
+        &lt;Expression&gt; body=Block&lt;Yield&gt;
+    |   &lt;!Expression&gt; body=Block&lt;Yield&gt;?
+;
+
+ExportedFunctionDeclaration&lt;Yield&gt;:
+    FunctionDeclaration&lt;Yield&gt;
+;
+
+FunctionTypeExpression:
+    {types::FunctionTypeExpression}
+    '{'
+    ('@' 'This' '(' declaredThisType=TypeRefFunctionTypeExpression ')')?
+    'function'
+    ('&lt;' ownedTypeVars+=TypeVariable (',' ownedTypeVars+=TypeVariable)* '&gt;')?
+    '('
+    (fpars+=TAnonymousFormalParameter (',' fpars+=TAnonymousFormalParameter)*)?
+    ')'
+    (':' returnTypeRef=TypeRef)?
+    '}';
+
+AnnotatedFunctionDeclaration &lt;Yield, Default&gt;:
+    annotationList=AnnotationList
+    (declaredModifiers+=N4Modifier)* AsyncNoTrailingLineBreak
+    FunctionImpl&lt;Yield,Yield,Expression=false&gt;
+;
+
+
+FunctionExpression:
+         (FunctionImpl&lt;Yield=false,YieldIfGenerator=true,Expression=true&gt;
+         )
+;
+
+AsyncFunctionExpression:
+     =&gt;(declaredAsync?='async' NoLineTerminator 'function')
+        FunctionHeader&lt;Yield=false,Generator=false&gt; FunctionBody&lt;Yield=false,Expression=true&gt;
+;
+
+ArrowExpression &lt;In, Yield&gt;:
+    =&gt; (
+            (
+                    '(' (fpars+=FormalParameter&lt;Yield&gt;
+                        (',' fpars+=FormalParameter&lt;Yield&gt;)*)?
+                    ')' (':' returnTypeRef=TypeRef)?
+                |   =&gt;(declaredAsync?='async' NoLineTerminator '(')
+                    (fpars+=FormalParameter&lt;Yield&gt; (',' fpars+=FormalParameter&lt;Yield&gt;)*)?
+                    ')' (':' returnTypeRef=TypeRef)?
+                |   fpars+=BindingIdentifierAsFormalParameter&lt;Yield&gt;
+            )
+            '=&gt;'
+        )
+        (-&gt; hasBracesAroundBody?='{' body=BlockMinusBraces&lt;Yield&gt; '}'
+            | body=ExpressionDisguisedAsBlock&lt;In&gt;)
+;
+
+fragment StrictFormalParameters &lt;Yield&gt;*:
+    '(' (fpars+=FormalParameter&lt;Yield&gt; (',' fpars+=FormalParameter&lt;Yield&gt;)*)? ')'
+;
+
+BindingIdentifierAsFormalParameter &lt;Yield&gt;: name=BindingIdentifier&lt;Yield&gt;;
+
+BlockMinusBraces &lt;Yield&gt;:   statements+=Statement&lt;Yield&gt;*;
+
+ExpressionDisguisedAsBlock &lt;In&gt;:
+    statements+=AssignmentExpressionStatement&lt;In&gt;
+;
+
+AssignmentExpressionStatement &lt;In&gt;: expression=AssignmentExpression&lt;In,Yield=false&gt;;
+
+AnnotatedExpression &lt;Yield&gt;:
+    ExpressionAnnotationList (
+        {N4ClassExpression.annotationList=current}
+        'class' name=BindingIdentifier&lt;Yield&gt;?
+        ClassExtendsClause&lt;Yield&gt;?
+        Members&lt;Yield&gt;
+    |   {FunctionExpression.annotationList=current} AsyncNoTrailingLineBreak
+        FunctionImpl&lt;Yield=false,YieldIfGenerator=true,Expression=true&gt;
+    )
+;
+
+TypeVariable:
+    name=IdentifierOrThis
+    (   'extends' declaredUpperBounds+=ParameterizedTypeRefNominal
+        ('&amp;' declaredUpperBounds+=ParameterizedTypeRefNominal)*
+    )?
+;
+
+FormalParameter &lt;Yield&gt;:
+    BindingElementFragment&lt;Yield&gt;
+;
+
+fragment BindingElementFragment &lt;Yield&gt;*:
+    (=&gt; bindingPattern=BindingPattern&lt;Yield&gt;
+    | annotations+=Annotation*
+        (
+            variadic?='...'? name=BindingIdentifier&lt;Yield&gt; ColonSepTypeRef?
+        )
+    )
+    ('=' initializer=AssignmentExpression&lt;In=true, Yield&gt;)?
+;
+
+fragment ColonSepTypeRef*:
+    ':' declaredTypeRef=TypeRef
+;
+
+Block &lt;Yield&gt;: =&gt; ('{') statements+=Statement&lt;Yield&gt;* '}';
+RootStatement &lt;Yield&gt;:
+    Block&lt;Yield&gt;
+    | FunctionDeclaration&lt;Yield&gt;
+    | VariableStatement&lt;In=true,Yield&gt;
+    | EmptyStatement
+    | LabelledStatement&lt;Yield&gt;
+    | ExpressionStatement&lt;Yield&gt;
+    | IfStatement&lt;Yield&gt;
+    | IterationStatement&lt;Yield&gt;
+    | ContinueStatement&lt;Yield&gt;
+    | BreakStatement&lt;Yield&gt;
+    | ReturnStatement&lt;Yield&gt;
+    | WithStatement&lt;Yield&gt;
+    | SwitchStatement&lt;Yield&gt;
+    | ThrowStatement&lt;Yield&gt;
+    | TryStatement&lt;Yield&gt;
+    | DebuggerStatement
+;
+
+Statement &lt;Yield&gt;:
+    AnnotatedFunctionDeclaration&lt;Yield,Default=false&gt;
+    | RootStatement&lt;Yield&gt;
+;
+
+enum VariableStatementKeyword:
+    var='var' | const='const' | let='let'
+;
+
+VariableStatement &lt;In, Yield&gt;:
+    =&gt;(varStmtKeyword=VariableStatementKeyword
+    )
+    varDeclsOrBindings+=VariableDeclarationOrBinding&lt;In,Yield,false&gt;
+    (',' varDeclsOrBindings+=VariableDeclarationOrBinding&lt;In,Yield,false&gt;)* Semi
+;
+
+ExportedVariableStatement:
+    (declaredModifiers+=N4Modifier)*
+    varStmtKeyword=VariableStatementKeyword
+    varDeclsOrBindings+=ExportedVariableDeclarationOrBinding&lt;Yield=false&gt;
+    (',' varDeclsOrBindings+=ExportedVariableDeclarationOrBinding&lt;Yield=false&gt;)* Semi
+;
+
+VariableDeclarationOrBinding &lt;In, Yield, OptionalInit&gt;:
+        VariableBinding&lt;In,Yield,OptionalInit&gt;
+    |   VariableDeclaration&lt;In,Yield,true&gt;
+;
+
+VariableBinding &lt;In, Yield, OptionalInit&gt;:
+    =&gt; pattern=BindingPattern&lt;Yield&gt; (
+            &lt;OptionalInit&gt; ('=' expression=AssignmentExpression&lt;In,Yield&gt;)?
+        |   &lt;!OptionalInit&gt; '=' expression=AssignmentExpression&lt;In,Yield&gt;
+    )
+;
+
+VariableDeclaration &lt;In, Yield, AllowType&gt;:
+    VariableDeclarationImpl&lt;In,Yield,AllowType&gt;;
+
+fragment VariableDeclarationImpl &lt;In, Yield, AllowType&gt;*:
+    annotations+=Annotation*
+    (
+        &lt;AllowType&gt; =&gt;(
+            name=BindingIdentifier&lt;Yield&gt; ColonSepTypeRef?
+        ) ('=' expression=AssignmentExpression&lt;In,Yield&gt;)?
+    |   &lt;!AllowType&gt; =&gt;(
+        name=BindingIdentifier&lt;Yield&gt;
+        ) ('=' expression=AssignmentExpression&lt;In,Yield&gt;)?
+    )
+;
+
+ExportedVariableDeclarationOrBinding &lt;Yield&gt;:
+        ExportedVariableBinding&lt;Yield&gt;
+    |   ExportedVariableDeclaration&lt;Yield&gt;
+;
+
+ExportedVariableBinding &lt;Yield&gt;:
+    =&gt; pattern=BindingPattern&lt;Yield&gt; '=' expression=AssignmentExpression&lt;In=true,Yield&gt;
+;
+
+ExportedVariableDeclaration &lt;Yield&gt;:
+    VariableDeclarationImpl&lt;In=true,Yield,AllowType=true&gt;
+;
+EmptyStatement: ';';
+ExpressionStatement &lt;Yield&gt;: expression=Expression&lt;In=true,Yield&gt; Semi;
+
+IfStatement &lt;Yield&gt;: 'if' '(' expression=Expression&lt;In=true,Yield&gt; ')'
+    ifStmt=Statement&lt;Yield&gt; (=&gt; 'else' elseStmt=Statement&lt;Yield&gt;)?;
+
+IterationStatement &lt;Yield&gt;:
+        DoStatement&lt;Yield&gt;
+    |   WhileStatement&lt;Yield&gt;
+    |   ForStatement&lt;Yield&gt;
+;
+
+DoStatement &lt;Yield&gt;: 'do' statement=Statement&lt;Yield&gt; 'while'
+    '(' expression=Expression&lt;In=true,Yield&gt; ')' =&gt; Semi?;
+WhileStatement &lt;Yield&gt;: 'while' '(' expression=Expression&lt;In=true,Yield&gt; ')'
+    statement=Statement&lt;Yield&gt;;
+
+ForStatement &lt;Yield&gt;:
+    'for' '('
+    (
+            =&gt;(initExpr=LetIdentifierRef forIn?='in' expression=Expression&lt;In=true,Yield&gt; ')')
+        |   (   -&gt;varStmtKeyword=VariableStatementKeyword
+                (
+                        =&gt;(varDeclsOrBindings+=BindingIdentifierAsVariableDeclaration&lt;In=false,Yield&gt;
+                        (forIn?='in' | forOf?='of') -&gt;expression=AssignmentExpression&lt;In=true,Yield&gt;?)
+                    |   varDeclsOrBindings+=VariableDeclarationOrBinding&lt;In=false,Yield,OptionalInit=true&gt;
+                        (
+                                (',' varDeclsOrBindings+=VariableDeclarationOrBinding&lt;In=false,Yield,false&gt;)* ';'
+                                expression=Expression&lt;In=true,Yield&gt;? ';' updateExpr=Expression&lt;In=true,Yield&gt;?
+                            |   forIn?='in' expression=Expression&lt;In=true,Yield&gt;?
+                            |   forOf?='of' expression=AssignmentExpression&lt;In=true,Yield&gt;?
+                        )
+                )
+            |   initExpr=Expression&lt;In=false,Yield&gt;
+                (
+                        ';' expression=Expression&lt;In=true,Yield&gt;? ';' updateExpr=Expression&lt;In=true,Yield&gt;?
+                    |   forIn?='in' expression=Expression&lt;In=true,Yield&gt;?
+                    |   forOf?='of' expression=AssignmentExpression&lt;In=true,Yield&gt;?
+                )
+            |   ';' expression=Expression&lt;In=true,Yield&gt;? ';' updateExpr=Expression&lt;In=true,Yield&gt;?
+            )
+        ')'
+    ) statement=Statement&lt;Yield&gt;
+;
+
+LetIdentifierRef:
+    id=[types::IdentifiableElement|LetAsIdentifier]
+;
+
+LetAsIdentifier: 'let';
+
+BindingIdentifierAsVariableDeclaration &lt;In, Yield&gt;:
+    name=BindingIdentifier&lt;Yield&gt;
+;
+
+ContinueStatement &lt;Yield&gt;: 'continue' (label=[LabelledStatement|BindingIdentifier&lt;Yield&gt;])? Semi;
+
+BreakStatement &lt;Yield&gt;: 'break' (label=[LabelledStatement|BindingIdentifier&lt;Yield&gt;])? Semi;
+
+ReturnStatement &lt;Yield&gt;: 'return' (expression=Expression&lt;In=true,Yield&gt;)? Semi;
+
+WithStatement &lt;Yield&gt;: 'with' '(' expression=Expression&lt;In=true,Yield&gt; ')' statement=Statement&lt;Yield&gt;;
+
+SwitchStatement &lt;Yield&gt;:
+    'switch' '(' expression=Expression&lt;In=true,Yield&gt; ')' '{'
+    (cases+=CaseClause&lt;Yield&gt;)*
+    ((cases+=DefaultClause&lt;Yield&gt;)
+    (cases+=CaseClause&lt;Yield&gt;)*)? '}'
+;
+
+CaseClause &lt;Yield&gt;: 'case' expression=Expression&lt;In=true,Yield&gt; ':' (statements+=Statement&lt;Yield&gt;)*;
+
+DefaultClause &lt;Yield&gt;: 'default' ':' (statements+=Statement&lt;Yield&gt;)*;
+
+LabelledStatement &lt;Yield&gt;: =&gt; (name=BindingIdentifier&lt;Yield&gt; ':') statement=Statement&lt;Yield&gt;;
+
+ThrowStatement &lt;Yield&gt;:
+    'throw' expression=Expression&lt;In=true,Yield&gt; Semi;
+
+TryStatement &lt;Yield&gt;:
+    'try' block=Block&lt;Yield&gt;
+    ((catch=CatchBlock&lt;Yield&gt; finally=FinallyBlock&lt;Yield&gt;?) | finally=FinallyBlock&lt;Yield&gt;)
+;
+
+CatchBlock &lt;Yield&gt;: 'catch' '(' catchVariable=CatchVariable&lt;Yield&gt; ')' block=Block&lt;Yield&gt;;
+
+CatchVariable &lt;Yield&gt;:
+        =&gt;bindingPattern=BindingPattern&lt;Yield&gt;
+    |   =&gt;(name=BindingIdentifier&lt;Yield&gt; -&gt; ColonSepTypeRef)
+    |   name=BindingIdentifier&lt;Yield&gt;
+;
+
+FinallyBlock &lt;Yield&gt;: 'finally' block=Block&lt;Yield&gt;;
+
+DebuggerStatement:
+    'debugger' Semi;
+
+PrimaryExpression &lt;Yield&gt;:
+      ThisLiteral
+    | SuperLiteral
+    | IdentifierRef&lt;Yield&gt;
+    | ParameterizedCallExpression&lt;Yield&gt;
+    | Literal
+    | ArrayLiteral&lt;Yield&gt;
+    | ObjectLiteral&lt;Yield&gt;
+    | ParenExpression&lt;Yield&gt;
+    | AnnotatedExpression&lt;Yield&gt;
+    | FunctionExpression
+    | AsyncFunctionExpression
+    | N4ClassExpression&lt;Yield&gt;
+    | TemplateLiteral&lt;Yield&gt;
+;
+
+ParenExpression &lt;Yield&gt;: '(' expression=Expression&lt;In=true,Yield&gt; ')';
+
+IdentifierRef &lt;Yield&gt;:
+    id=[types::IdentifiableElement|BindingIdentifier&lt;Yield&gt;]
+;
+
+SuperLiteral: 'super';
+
+ThisLiteral: 'this';
+
+ArrayLiteral &lt;Yield&gt;:
+    '['
+        elements+=ArrayPadding* (
+            elements+=ArrayElement&lt;Yield&gt;
+            (',' elements+=ArrayPadding* elements+=ArrayElement&lt;Yield&gt;)*
+            (trailingComma?=',' elements+=ArrayPadding*)?
+        )?
+    ']'
+;
+
+ArrayPadding: ',';
+
+ArrayElement &lt;Yield&gt;: spread?='...'? expression=AssignmentExpression&lt;In=true,Yield&gt;;
+
+ObjectLiteral &lt;Yield&gt;: '{'
+        ( propertyAssignments+=PropertyAssignment&lt;Yield&gt;
+          (',' propertyAssignments+=PropertyAssignment&lt;Yield&gt;)* ','?
+        )?
+    '}'
+;
+
+PropertyAssignment &lt;Yield&gt;:
+      AnnotatedPropertyAssignment&lt;Yield&gt;
+    | PropertyNameValuePair&lt;Yield&gt;
+    | PropertyGetterDeclaration&lt;Yield&gt;
+    | PropertySetterDeclaration&lt;Yield&gt;
+    | PropertyMethodDeclaration&lt;Yield&gt;
+    | PropertyNameValuePairSingleName&lt;Yield&gt;
+;
+
+AnnotatedPropertyAssignment &lt;Yield&gt;:
+    PropertyAssignmentAnnotationList (
+    =&gt;( {PropertyNameValuePair.annotationList=current} declaredTypeRef=TypeRef?
+            LiteralOrComputedPropertyName&lt;Yield&gt; ':'
+        ) expression=AssignmentExpression&lt;In=true,Yield&gt;
+    | =&gt;({PropertyGetterDeclaration.annotationList=current}
+            GetterHeader&lt;Yield&gt;
+        ) body=Block&lt;Yield=false&gt;
+    | =&gt;({PropertySetterDeclaration.annotationList=current}
+            'set' -&gt;LiteralOrComputedPropertyName &lt;Yield&gt;
+        ) '(' fpar=FormalParameter&lt;Yield&gt; ')' body=Block&lt;Yield=false&gt;
+    | =&gt;({PropertyMethodDeclaration.annotationList=current}
+            TypeVariables? returnTypeRef=TypeRef?
+            (generator?='*' LiteralOrComputedPropertyName&lt;Yield&gt; -&gt;MethodParamsAndBody &lt;Generator=true&gt;
+                | LiteralOrComputedPropertyName&lt;Yield&gt; -&gt; MethodParamsAndBody &lt;Generator=false&gt;
+            )
+        ) ';'?
+    | {PropertyNameValuePairSingleName.annotationList=current}
+        declaredTypeRef=TypeRef? identifierRef=IdentifierRef&lt;Yield&gt;
+        ( '=' expression=AssignmentExpression&lt;In=true,Yield&gt;)?)
+;
+
+PropertyMethodDeclaration &lt;Yield&gt;:
+    =&gt; (TypeVariables? returnTypeRef=TypeRef?
+            (
+                generator?='*'  LiteralOrComputedPropertyName&lt;Yield&gt;
+                    -&gt;MethodParamsAndBody&lt;Generator=true&gt;
+                | LiteralOrComputedPropertyName&lt;Yield&gt; -&gt;MethodParamsAndBody &lt;Generator=false&gt;
+            )
+        )
+    ';'?
+;
+
+PropertyNameValuePair &lt;Yield&gt;:
+    =&gt; (
+        declaredTypeRef=TypeRef? LiteralOrComputedPropertyName&lt;Yield&gt; ':'
+    )
+    expression=AssignmentExpression&lt;In=true,Yield&gt;
+;
+
+PropertyNameValuePairSingleName &lt;Yield&gt;:
+    declaredTypeRef=TypeRef?
+    identifierRef=IdentifierRef&lt;Yield&gt;
+    ('=' expression=AssignmentExpression&lt;In=true,Yield&gt;)?
+;
+
+PropertyGetterDeclaration &lt;Yield&gt;:
+    =&gt;(
+        GetterHeader&lt;Yield&gt;
+    )
+    body=Block&lt;Yield=false&gt;
+;
+
+PropertySetterDeclaration &lt;Yield&gt;:
+    =&gt;(
+        'set'
+        -&gt;LiteralOrComputedPropertyName &lt;Yield&gt;
+    )
+    '(' fpar=FormalParameter&lt;Yield&gt; ')' body=Block&lt;Yield=false&gt;
+;
+
+ParameterizedCallExpression &lt;Yield&gt;:
+    TypeArguments
+    target=IdentifierRef&lt;Yield&gt;
+    ArgumentsWithParentheses&lt;Yield&gt;
+;
+
+LeftHandSideExpression &lt;Yield&gt;:
+    MemberExpression&lt;Yield&gt; (
+        {ParameterizedCallExpression.target=current} ArgumentsWithParentheses&lt;Yield&gt;
+        (
+              {ParameterizedCallExpression.target=current} ArgumentsWithParentheses&lt;Yield&gt;
+            | {IndexedAccessExpression.target=current} IndexedAccessExpressionTail&lt;Yield&gt;
+            | {ParameterizedPropertyAccessExpression.target=current}
+                ParameterizedPropertyAccessExpressionTail&lt;Yield&gt;
+            | -&gt;({TaggedTemplateString.target=current} template=TemplateLiteral&lt;Yield&gt;)
+        )*
+    )?
+;
+
+fragment Arguments &lt;Yield&gt;*:
+      arguments+=AssignmentExpression&lt;In=true,Yield&gt;
+      (',' arguments+=AssignmentExpression&lt;In=true,Yield&gt;)*
+      (',' spread?='...' arguments+=AssignmentExpression&lt;In=true,Yield&gt;)?
+    | spread?='...' arguments+=AssignmentExpression&lt;In=true,Yield&gt;
+;
+
+fragment TypeArguments*:
+    '&lt;' typeArgs+=TypeRef (',' typeArgs+=TypeRef)* '&gt;'
+;
+
+fragment ArgumentsWithParentheses &lt;Yield&gt;*:
+    '(' Arguments&lt;Yield&gt;? ')'
+;
+
+MemberExpression &lt;Yield&gt;:
+    =&gt;('new' '.') 'target'
+    | =&gt; ('new') callee=MemberExpression&lt;Yield&gt; (-&gt; TypeArguments)?
+        (=&gt; withArgs?='(' Arguments&lt;Yield&gt;? ')'
+            (
+                  {IndexedAccessExpression.target=current} IndexedAccessExpressionTail&lt;Yield&gt;
+                | {ParameterizedPropertyAccessExpression.target=current}
+                    ParameterizedPropertyAccessExpressionTail&lt;Yield&gt;
+                | {TaggedTemplateString.target=current} template=TemplateLiteral&lt;Yield&gt;
+            )*
+        )?
+    | PrimaryExpression&lt;Yield&gt; (
+          {IndexedAccessExpression.target=current} IndexedAccessExpressionTail&lt;Yield&gt;
+        | {ParameterizedPropertyAccessExpression.target=current}
+            ParameterizedPropertyAccessExpressionTail&lt;Yield&gt;
+        | {TaggedTemplateString.target=current} template=TemplateLiteral&lt;Yield&gt;
+        )*
+;
+
+fragment IndexedAccessExpressionTail &lt;Yield&gt;*:
+    '[' index=Expression&lt;In=true,Yield&gt; ']'
+;
+
+fragment ParameterizedPropertyAccessExpressionTail &lt;Yield&gt;*:
+    '.' TypeArguments? property=[types::IdentifiableElement|IdentifierName]
+;
+
+PostfixExpression &lt;Yield&gt;:
+    LeftHandSideExpression&lt;Yield&gt; (
+        =&gt;({PostfixExpression.expression=current} op=PostfixOperator
+        )
+    )?
+;
+
+enum PostfixOperator: inc='++' | dec='--';
+
+CastExpression &lt;Yield&gt;: PostfixExpression&lt;Yield&gt;
+    (=&gt;({CastExpression.expression=current} 'as') targetTypeRef=TypeRefForCast)?;
+
+UnaryExpression &lt;Yield&gt;:
+      CastExpression&lt;Yield&gt;
+    | (op=UnaryOperator expression=UnaryExpression&lt;Yield&gt;);
+
+enum UnaryOperator: delete | void | typeof | inc='++' | dec='--' | pos='+' | neg='-' | inv='~' | not='!';
+
+MultiplicativeExpression &lt;Yield&gt;: UnaryExpression&lt;Yield&gt;
+    (=&gt;({MultiplicativeExpression.lhs=current} op=MultiplicativeOperator)
+        rhs=UnaryExpression&lt;Yield&gt;)*;
+
+enum MultiplicativeOperator: times='*' | div='/' | mod='%';
+
+AdditiveExpression &lt;Yield&gt;: MultiplicativeExpression&lt;Yield&gt;
+    (=&gt;({AdditiveExpression.lhs=current} op=AdditiveOperator)
+        rhs=MultiplicativeExpression&lt;Yield&gt;)*;
+
+enum AdditiveOperator: add='+' | sub='-';
+
+ShiftExpression &lt;Yield&gt;: AdditiveExpression&lt;Yield&gt;
+    (=&gt;({ShiftExpression.lhs=current} op=ShiftOperator rhs=AdditiveExpression&lt;Yield&gt;))*
+;
+
+ShiftOperator:
+      '&gt;' '&gt;' '&gt;'?
+    | '&lt;&lt;'
+;
+
+RelationalExpression &lt;In, Yield&gt;: ShiftExpression&lt;Yield&gt;
+    =&gt;({RelationalExpression.lhs=current} op=RelationalOperator&lt;In&gt;
+        -&gt;rhs=ShiftExpression&lt;Yield&gt;)*;
+
+RelationalOperator &lt;In&gt;:
+    '&lt;' | '&gt;' | '&lt;=' | '&gt;=' | 'instanceof' | &lt;In&gt; 'in';
+
+EqualityExpression &lt;In, Yield&gt;: RelationalExpression&lt;In,Yield&gt;
+    (=&gt;({EqualityExpression.lhs=current} op=EqualityOperator) rhs=RelationalExpression&lt;In,Yield&gt;)*;
+
+enum EqualityOperator: same='===' | nsame='!==' | eq='==' | neq='!=';
+
+BitwiseANDExpression &lt;In, Yield&gt;: EqualityExpression&lt;In,Yield&gt;
+    (=&gt;({BinaryBitwiseExpression.lhs=current} op=BitwiseANDOperator) rhs=EqualityExpression&lt;In,Yield&gt;)*;
+
+BitwiseANDOperator: '&amp;';
+
+BitwiseXORExpression &lt;In, Yield&gt;: BitwiseANDExpression&lt;In,Yield&gt;
+    (=&gt;({BinaryBitwiseExpression.lhs=current} op=BitwiseXOROperator) rhs=BitwiseANDExpression&lt;In,Yield&gt;)*;
+
+BitwiseXOROperator: '^';
+
+BitwiseORExpression &lt;In, Yield&gt;: BitwiseXORExpression&lt;In,Yield&gt;
+    (=&gt;({BinaryBitwiseExpression.lhs=current} op=BitwiseOROperator) rhs=BitwiseXORExpression&lt;In,Yield&gt;)*;
+
+BitwiseOROperator: '|';
+
+LogicalANDExpression &lt;In, Yield&gt;: BitwiseORExpression&lt;In,Yield&gt;
+    (=&gt; ({BinaryLogicalExpression.lhs=current} op=LogicalANDOperator) rhs=BitwiseORExpression&lt;In,Yield&gt;)*;
+
+LogicalANDOperator: '&amp;&amp;';
+
+LogicalORExpression &lt;In, Yield&gt;: LogicalANDExpression&lt;In,Yield&gt;
+    (=&gt;({BinaryLogicalExpression.lhs=current} op=LogicalOROperator) rhs=LogicalANDExpression&lt;In,Yield&gt;)*;
+
+LogicalOROperator: '||';
+
+ConditionalExpression &lt;In, Yield&gt;: LogicalORExpression&lt;In,Yield&gt;
+    (=&gt; ({ConditionalExpression.expression=current} '?') trueExpression=AssignmentExpression&lt;In=true,Yield&gt;
+        ':' falseExpression=AssignmentExpression&lt;In,Yield&gt;)?;
+
+AssignmentExpression &lt;In, Yield&gt;:
+      AwaitExpression&lt;In,Yield&gt;
+    | PromisifyExpression&lt;In,Yield&gt;
+    | ArrowExpression&lt;In,Yield&gt;
+    | &lt;Yield&gt; YieldExpression&lt;In&gt;
+    | ConditionalExpression&lt;In,Yield&gt;
+        (=&gt; ({AssignmentExpression.lhs=current} op=AssignmentOperator)
+            rhs=AssignmentExpression&lt;In,Yield&gt;)?
+;
+
+YieldExpression &lt;In&gt;:
+    'yield' =&gt; many?='*'? -&gt; expression=AssignmentExpression&lt;In,Yield=true&gt;?
+;
+
+AssignmentOperator:
+      '=' | '*=' | '/=' | '%=' | '+=' | '-='
+    | '&lt;&lt;='
+    | '&gt;' '&gt;'? '&gt;='
+    | '&amp;=' | '^=' | '|='
+;
+
+AwaitExpression &lt;In, Yield&gt;:
+    =&gt;('await') expression=AssignmentExpression&lt;In,Yield&gt;;
+
+PromisifyExpression &lt;In, Yield&gt;:
+    =&gt; ('@' 'Promisify') expression=AssignmentExpression&lt;In,Yield&gt;;
+
+Expression &lt;In, Yield&gt;:
+    AssignmentExpression&lt;In,Yield&gt; ({CommaExpression.exprs+=current}
+    ',' exprs+=AssignmentExpression&lt;In,Yield&gt;
+    (','    exprs+=AssignmentExpression&lt;In,Yield&gt;)*)?
+;
+
+TemplateLiteral &lt;Yield&gt;:
+    (
+          segments+=NoSubstitutionTemplate
+        | segments+=TemplateHead segments+=Expression&lt;In=true,Yield&gt;? TemplateExpressionEnd
+            (
+                segments+=TemplateMiddle segments+=Expression&lt;In=true,Yield&gt;?
+                TemplateExpressionEnd
+            )*
+            segments+=TemplateTail
+    )
+;
+
+TemplateExpressionEnd:
+    '}'
+;
+
+NoSubstitutionTemplate:
+    rawValue=NO_SUBSTITUTION_TEMPLATE_LITERAL
+;
+
+TemplateHead:
+    rawValue=TEMPLATE_HEAD
+;
+
+TemplateTail:
+    rawValue=TemplateTailLiteral;
+
+TemplateMiddle:
+    rawValue=TemplateMiddleLiteral;
+
+Literal:
+      NumericLiteral | BooleanLiteral | StringLiteral
+    | NullLiteral | RegularExpressionLiteral;
+NullLiteral: 'null';
+BooleanLiteral: (true?='true' | 'false');
+StringLiteral: value=STRING;
+NumericLiteral:
+      DoubleLiteral | IntLiteral | BinaryIntLiteral | OctalIntLiteral
+    | LegacyOctalIntLiteral | HexIntLiteral | ScientificIntLiteral;
+DoubleLiteral: value=DOUBLE;
+IntLiteral: value=INT;
+OctalIntLiteral: value=OCTAL_INT;
+LegacyOctalIntLiteral: value=LEGACY_OCTAL_INT;
+HexIntLiteral: value=HEX_INT;
+BinaryIntLiteral: value=BINARY_INT;
+ScientificIntLiteral: value=SCIENTIFIC_INT;
+RegularExpressionLiteral: value=REGEX_LITERAL;
+
+NumericLiteralAsString:
+    DOUBLE | INT | OCTAL_INT | HEX_INT | SCIENTIFIC_INT
+;
+
+IdentifierOrThis:
+    IDENTIFIER
+    | 'This'
+    | 'Promisify'
+    | 'target';
+
+AnnotationName:
+    IDENTIFIER
+    | 'This'
+    | 'target';
+
+BindingIdentifier &lt;Yield&gt;:
+    IDENTIFIER
+    | &lt;!Yield&gt; 'yield'
+    | N4Keyword
+;
+
+IdentifierName:
+    IDENTIFIER | ReservedWord | N4Keyword
+;
+
+ReservedWord:
+    'break' | 'case' | 'catch' | 'class' | 'const' | 'continue' | 'debugger' | 'default' | 'delete'
+    | 'do' | 'else' | 'export' | 'extends' | 'finally' | 'for' | 'function' | 'if' | 'import'
+    | 'in' | 'instanceof' | 'new' | 'return' | 'super' | 'switch' | 'this' | 'throw' | 'try'
+    | 'typeof' | 'var' | 'void' | 'while' | 'with' | 'yield'
+    | 'null'
+    | 'true' | 'false'
+    | 'enum';
+
+N4Keyword:
+    'get' | 'set'
+    | 'let'
+    | 'project'
+    | 'external' | 'abstract' | 'static'
+    | 'as' | 'from' | 'constructor' | 'of' | 'target'
+    | 'type' | 'union' | 'intersection'
+    | 'This' | 'Await' | 'Promisify'
+    | 'await'
+    | 'async'
+    | 'implements' | 'interface'
+    | 'private' | 'protected' | 'public'
+;
+
+SymbolLiteralComputedName &lt;Yield&gt;:
+    BindingIdentifier&lt;Yield&gt; ('.' IdentifierName)?
+;
+
+terminal DOUBLE:
+    '.' DECIMAL_DIGIT_FRAGMENT+ EXPONENT_PART?
+    | DECIMAL_INTEGER_LITERAL_FRAGMENT '.' DECIMAL_DIGIT_FRAGMENT* EXPONENT_PART?
+;
+
+terminal HEX_INT: '0' ('x' | 'X') INT_SUFFIX;
+
+terminal BINARY_INT: '0' ('b' | 'B') INT_SUFFIX;
+
+terminal OCTAL_INT: '0' ('o' | 'O') INT_SUFFIX;
+
+terminal LEGACY_OCTAL_INT: '0' DECIMAL_DIGIT_FRAGMENT INT_SUFFIX;
+
+terminal fragment INT_SUFFIX: IDENTIFIER_PART*;
+
+terminal SCIENTIFIC_INT:
+    DECIMAL_INTEGER_LITERAL_FRAGMENT EXPONENT_PART
+;
+
+terminal fragment EXPONENT_PART:
+      ('e' | 'E') SIGNED_INT
+    | IDENTIFIER
+;
+
+terminal fragment SIGNED_INT:
+    ('+' | '-') DECIMAL_DIGIT_FRAGMENT+ IDENTIFIER?
+;
+
+terminal STRING:
+      '"' DOUBLE_STRING_CHAR* '"'?
+    | "'" SINGLE_STRING_CHAR* "'"?
+;
+
+terminal fragment DOUBLE_STRING_CHAR:
+      !(LINE_TERMINATOR_FRAGMENT | '"' | '\\')
+    | '\\' (LINE_TERMINATOR_SEQUENCE_FRAGMENT | !LINE_TERMINATOR_FRAGMENT)?
+;
+
+terminal fragment SINGLE_STRING_CHAR:
+      !(LINE_TERMINATOR_FRAGMENT | "'" | '\\')
+    | '\\' (LINE_TERMINATOR_SEQUENCE_FRAGMENT | !LINE_TERMINATOR_FRAGMENT)?
+;
+
+terminal fragment BACKSLASH_SEQUENCE:
+    '\\' !(LINE_TERMINATOR_FRAGMENT)?
+;
+
+terminal fragment REGEX_CHAR:
+      !(LINE_TERMINATOR_FRAGMENT | '\\' | '/' | '[')
+    | BACKSLASH_SEQUENCE
+    | '[' REGEX_CHAR_OR_BRACKET* ']'?
+;
+
+terminal fragment REGEX_CHAR_OR_BRACKET:
+      !(LINE_TERMINATOR_FRAGMENT | '\\' | ']')
+    | BACKSLASH_SEQUENCE
+;
+
+REGEX_LITERAL:
+    ('/' | '/=') REGEX_TAIL?
+;
+
+terminal fragment ACTUAL_REGEX_TAIL:
+      REGEX_CHAR+ ('/' IDENTIFIER_PART*)?
+    | '/' IDENTIFIER_PART*
+;
+
+terminal fragment REGEX_START:
+    ('/' | '/=')
+;
+
+terminal REGEX_TAIL: // post processed
+    '//1'
+;
+terminal TEMPLATE_HEAD:
+    "`" TEMPLATE_LITERAL_CHAR* '$'+ '{'
+;
+
+terminal NO_SUBSTITUTION_TEMPLATE_LITERAL:
+    '`' TEMPLATE_LITERAL_CHAR* '$'* "`"?
+;
+
+terminal fragment ACTUAL_TEMPLATE_END:
+    TEMPLATE_LITERAL_CHAR* ('$'+ ('{' | '`'?) | '`'?)
+;
+
+terminal fragment TEMPLATE_LITERAL_CHAR:
+      !(LINE_TERMINATOR_FRAGMENT | '`' | '\\' | '$')
+    | '$'+ !('{' | '`' | '$')
+    | LINE_TERMINATOR_SEQUENCE_FRAGMENT
+    | '\\' (LINE_TERMINATOR_SEQUENCE_FRAGMENT | !LINE_TERMINATOR_FRAGMENT)?
+;
+
+TemplateTailLiteral:
+    TEMPLATE_END?
+;
+
+TemplateMiddleLiteral:
+    TEMPLATE_MIDDLE
+;
+
+terminal TEMPLATE_MIDDLE:
+    '//2' // will never be lexed
+;
+
+terminal TEMPLATE_END:
+    '//3' // will never be lexed
+;
+
+terminal fragment TEMPLATE_CONTINUATION:
+    '//4' // actually '}'
+;
+
+Semi: ';'; // automatic semicolon instertion, post-processed
+
+fragment NoLineTerminator*: NO_LINE_TERMINATOR?;
+
+terminal NO_LINE_TERMINATOR:
+    '//5' // post-processed, will never be lexed
+;
+Annotation:'@' AnnotationNoAtSign;
+ScriptAnnotation: '@@' AnnotationNoAtSign;
+
+AnnotationNoAtSign:
+    name=AnnotationName (=&gt; '(' (args+=AnnotationArgument (',' args+=AnnotationArgument)*)? ')')?;
+
+AnnotationArgument:
+    LiteralAnnotationArgument | TypeRefAnnotationArgument
+;
+
+LiteralAnnotationArgument:
+    literal=Literal
+;
+
+TypeRefAnnotationArgument:
+    typeRef=TypeRef
+;
+
+AnnotationList:
+    =&gt;('@' -&gt; annotations+=AnnotationNoAtSign) annotations+=Annotation*
+;
+
+ExpressionAnnotationList:
+    annotations+=Annotation+
+;
+
+PropertyAssignmentAnnotationList:
+    annotations+=Annotation+
+;
+
+N4MemberAnnotationList:
+    {N4MemberAnnotationList} annotations+=Annotation+
+;
+
+TypeReferenceName:
+    'void' | 'This' | 'await' | 'Promisify' | 'target' | QualifiedTypeReferenceName
+;
+
+QualifiedTypeReferenceName:
+    IDENTIFIER ('.' IDENTIFIER)?
+;
+N4ClassDeclaration &lt;Yield&gt;:
+    =&gt;(
+        {N4ClassDeclaration}
+        (declaredModifiers+=N4Modifier)*
+        'class' typingStrategy=TypingStrategyDefSiteOperator? name=BindingIdentifier&lt;Yield&gt;?
+    )
+    TypeVariables?
+    ClassExtendsClause&lt;Yield&gt;?
+    Members&lt;Yield&gt;
+;
+
+fragment Members &lt;Yield&gt;*:
+    '{'
+    ownedMembersRaw+=N4MemberDeclaration&lt;Yield&gt;*
+    '}'
+;
+
+fragment ClassExtendsClause &lt;Yield&gt;*:
+    'extends' (
+          =&gt;superClassRef=ParameterizedTypeRefNominal ('implements' ClassImplementsList)?
+        | superClassExpression=LeftHandSideExpression&lt;Yield&gt;
+    )
+    | 'implements' ClassImplementsList
+;
+
+fragment ClassImplementsList*:
+    implementedInterfaceRefs+=ParameterizedTypeRefNominal
+    (',' implementedInterfaceRefs+=ParameterizedTypeRefNominal)*
+;
+
+N4ClassExpression &lt;Yield&gt;:
+    {N4ClassExpression}
+    'class' name=BindingIdentifier&lt;Yield&gt;?
+    ClassExtendsClause&lt;Yield&gt;?
+    Members&lt;Yield&gt;;
+N4InterfaceDeclaration &lt;Yield&gt;:
+    =&gt; (
+        {N4InterfaceDeclaration}
+        (declaredModifiers+=N4Modifier)*
+        'interface' typingStrategy=TypingStrategyDefSiteOperator? name=BindingIdentifier&lt;Yield&gt;?
+    )
+    TypeVariables?
+    InterfaceImplementsList?
+    Members&lt;Yield&gt;
+;
+
+fragment InterfaceImplementsList*:
+     'extends' superInterfaceRefs+=ParameterizedTypeRefNominal
+        (',' superInterfaceRefs+=ParameterizedTypeRefNominal)*
+;
+N4EnumDeclaration &lt;Yield&gt;:
+    =&gt;(
+        {N4EnumDeclaration}
+        (declaredModifiers+=N4Modifier)*
+        'enum' name=BindingIdentifier&lt;Yield&gt;?
+    )
+    '{'
+        (literals+=N4EnumLiteral (',' literals+=N4EnumLiteral)*)?
+    '}'
+;
+N4EnumLiteral: name=IdentifierOrThis (':' value=STRING)?;
+
+enum N4Modifier: // validator applies further checks
+      private | project | protected | public
+    | external | abstract | static | const;
+
+N4MemberDeclaration &lt;Yield&gt;:
+    AnnotatedN4MemberDeclaration&lt;Yield&gt;
+    | N4GetterDeclaration&lt;Yield&gt;
+    | N4SetterDeclaration&lt;Yield&gt;
+    | N4MethodDeclaration&lt;Yield&gt;
+    | N4FieldDeclaration&lt;Yield&gt;
+    | N4CallableConstructorDeclaration&lt;Yield&gt;
+;
+
+AnnotatedN4MemberDeclaration &lt;Yield&gt; returns N4MemberDeclaration:
+    N4MemberAnnotationList (
+            =&gt; ({N4GetterDeclaration.annotationList=current}
+                (declaredModifiers+=N4Modifier)* GetterHeader&lt;Yield&gt;) (body=Block&lt;Yield&gt;)? ';'?
+        |   =&gt; ({N4SetterDeclaration.annotationList=current}
+                (declaredModifiers+=N4Modifier)* 'set' -&gt; LiteralOrComputedPropertyName &lt;Yield&gt;)
+                '(' fpar=FormalParameter&lt;Yield&gt; ')' (body=Block&lt;Yield&gt;)? ';'?
+        |   =&gt; (
+                {N4MethodDeclaration.annotationList=current} (declaredModifiers+=N4Modifier)* TypeVariables?
+                (
+                        generator?='*' LiteralOrComputedPropertyName&lt;Yield&gt;
+                        -&gt;MethodParamsReturnAndBody &lt;Generator=true&gt;
+                    |   AsyncNoTrailingLineBreak LiteralOrComputedPropertyName&lt;Yield&gt;
+                        -&gt;MethodParamsReturnAndBody &lt;Generator=false&gt;
+                )
+                )';'?
+        |   {N4FieldDeclaration.annotationList=current} FieldDeclarationImpl&lt;Yield&gt;
+    )
+;
+
+fragment LiteralOrComputedPropertyName &lt;Yield&gt;*:
+    name=IdentifierName | name=STRING | name=NumericLiteralAsString
+    | '[' (=&gt;((name=SymbolLiteralComputedName&lt;Yield&gt; | name=StringLiteralAsName) ']')
+        |   computeNameFrom=AssignmentExpression&lt;In=true,Yield&gt; ']')
+;
+
+fragment LiteralPropertyName &lt;Yield&gt;*:
+    name=IdentifierName | name=STRING | name=NumericLiteralAsString
+    | '[' (name=SymbolLiteralComputedName&lt;Yield&gt; | name=StringLiteralAsName) ']'
+;
+
+StringLiteralAsName:
+    STRING
+;
+
+fragment FieldDeclarationImpl &lt;Yield&gt;*:
+    (declaredModifiers+=N4Modifier)*
+    LiteralPropertyName&lt;Yield&gt; ColonSepTypeRef? ('=' expression=Expression&lt;In=true,Yield&gt;)? ';'
+;
+
+N4FieldDeclaration &lt;Yield&gt;:
+    {N4FieldDeclaration}
+    FieldDeclarationImpl&lt;Yield&gt;
+;
+
+N4MethodDeclaration &lt;Yield&gt;:
+    =&gt; ({N4MethodDeclaration} (declaredModifiers+=N4Modifier)* TypeVariables?
+        (
+                generator?='*' LiteralOrComputedPropertyName&lt;Yield&gt;
+                -&gt;MethodParamsReturnAndBody &lt;Generator=true&gt;
+            |   AsyncNoTrailingLineBreak LiteralOrComputedPropertyName&lt;Yield&gt;
+                -&gt;MethodParamsReturnAndBody &lt;Generator=false&gt;
+        )
+    ) ';'?
+;
+
+N4CallableConstructorDeclaration &lt;Yield&gt; returns N4MethodDeclaration:
+    MethodParamsReturnAndBody &lt;Generator=false&gt; ';'?
+;
+
+fragment MethodParamsAndBody &lt;Generator&gt;*:
+    StrictFormalParameters&lt;Yield=Generator&gt;
+    (body=Block&lt;Yield=Generator&gt;)?
+;
+
+fragment MethodParamsReturnAndBody &lt;Generator&gt;*:
+    StrictFormalParameters&lt;Yield=Generator&gt;
+    (':' returnTypeRef=TypeRef)?
+    (body=Block&lt;Yield=Generator&gt;)?
+;
+
+N4GetterDeclaration &lt;Yield&gt;:
+    =&gt; ({N4GetterDeclaration}
+    (declaredModifiers+=N4Modifier)*
+    GetterHeader&lt;Yield&gt;)
+    (body=Block&lt;Yield&gt;)? ';'?
+;
+
+fragment GetterHeader &lt;Yield&gt;*:
+    ('get' -&gt; LiteralOrComputedPropertyName &lt;Yield&gt; '(' ')' ColonSepTypeRef?)
+;
+
+N4SetterDeclaration &lt;Yield&gt;:
+    =&gt;({N4SetterDeclaration}
+        (declaredModifiers+=N4Modifier)*
+        'set'
+        -&gt;LiteralOrComputedPropertyName &lt;Yield&gt;
+    )
+    '(' fpar=FormalParameter&lt;Yield&gt; ')' (body=Block&lt;Yield&gt;)? ';'?
+;
+
+BindingPattern &lt;Yield&gt;:
+    ObjectBindingPattern&lt;Yield&gt;
+    | ArrayBindingPattern&lt;Yield&gt;
+;
+
+ObjectBindingPattern &lt;Yield&gt;:
+    '{' (properties+=BindingProperty&lt;Yield,AllowType=false&gt;
+        (',' properties+=BindingProperty&lt;Yield,AllowType=false&gt;)*)? '}'
+;
+
+ArrayBindingPattern &lt;Yield&gt;:
+    '['
+        elements+=Elision* (
+            elements+=BindingRestElement&lt;Yield&gt;
+            (',' elements+=Elision* elements+=BindingRestElement&lt;Yield&gt;)*
+            (',' elements+=Elision*)?
+        )?
+    ']'
+;
+
+BindingProperty &lt;Yield, AllowType&gt;:
+      =&gt;(LiteralBindingPropertyName&lt;Yield&gt; ':') value=BindingElement&lt;Yield&gt;
+    | value=SingleNameBinding&lt;Yield,AllowType&gt;
+;
+
+fragment LiteralBindingPropertyName &lt;Yield&gt;*:
+    declaredName=IdentifierName | declaredName=STRING | declaredName=NumericLiteralAsString
+    | '[' (declaredName=SymbolLiteralComputedName&lt;Yield&gt; | declaredName=STRING) ']'
+;
+
+SingleNameBinding &lt;Yield, AllowType&gt;:
+    varDecl=VariableDeclaration&lt;In=true,Yield,AllowType&gt;
+;
+
+BindingElement &lt;Yield&gt;:
+      =&gt;(nestedPattern=BindingPattern&lt;Yield&gt;) ('=' expression=AssignmentExpression&lt;In=true,Yield&gt;)?
+    | varDecl=VariableDeclaration&lt;In=true,Yield,AllowType=true&gt;
+;
+
+BindingRestElement &lt;Yield&gt;:
+    rest?='...'?
+    (
+          =&gt;(nestedPattern=BindingPattern&lt;Yield&gt;)
+            ('=' expression=AssignmentExpression&lt;In=true,Yield&gt;)?
+        | varDecl=VariableDeclaration&lt;In=true,Yield,AllowType=true&gt;
+    )
+;
+
+Elision:
+    ','
+;</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div id="footer">
+<div id="footer-text">
+Version 0.9<br>
+Last updated 2019-08-07 15:02:40 CEST
+</div>
+</div>
+<!-- ************* docinfo-footer *************************************************************** -->
+<div class="Grid social" style="color:#d5dfea">
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <h2>Quick Links</h2>
+    <ul>
+      <li><a href="../downloads.html">Download</a></li>
+      <li><a href="../userguides/index.html">Documentation</a></li>
+      <li><a href="https://github.com/eclipse/n4js/">Source</a></li>
+      <li><a href="https://github.com/eclipse/n4js/issues">Issues</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="https://www.eclipse.org/forums/index.php/f/365/">Forum</a></li>
+      <li><a href="http://n4js.blogspot.de/">Blog</a></li>
+      <li><a href="https://dev.eclipse.org/mailman/listinfo/n4js-dev">Mailing List</a></li>
+      <li><a href="https://projects.eclipse.org/projects/technology.n4js">Eclipse Project Page</a></li>
+      <li><a href="https://twitter.com/n4jsdev">Tweets by n4jsdev</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="http://www.eclipse.org/">Eclipse Home</a></li>
+      <li><a href="http://www.eclipse.org/legal/privacy.php">Privacy Policy</a></li>
+      <li><a href="http://www.eclipse.org/legal/termsofuse.php">Terms of Use</a></li>
+      <li><a href="http://www.eclipse.org/legal/copyright.php">Copyright Agent</a></li>
+      <li><a href="http://www.eclipse.org/legal/">Legal</a></li>
+    </ul>
+  </div>
+  <div style="clear: both; height: 0; overflow: hidden;"></div>
+</div>
+
+<!-- ************* UI Scripts ************* -->
+<script type="text/javascript" src="scripts/back-to-top.js"></script>
+
+<script type="text/javascript" src="scripts/treeview.js"></script>
+<script type="text/javascript" src="scripts/toc.js"></script>
+
+<!-- ************* Prism.js Syntax Highlighting ************* -->
+<script src="scripts/prism.js"></script>
+
+<script type="text/javascript">
+	// Add the 'toclist' id for search function
+	$(".toc2 > ul").attr('id', 'toclist');
+	// Generate a Search input form
+	$("#toclist > li:first-of-type").before('<input type="text" id="pagesearch" onkeyup="search()" placeholder="Search for section...">');
+	$("#toclist > li:first-of-type").before('<i id="clear" class="fa fa-times-circle-o"></i>');
+	$("#clear").click(function(){
+	    $("#pagesearch").val('');
+	    search();
+	    $('.toc2 > ul').treeView('collapseAll');
+	});
+	// intialize Treeview.js
+	$(".toc2 > ul").treeView();
+	// Initialize Scrollspy
+</script>
+<!-- ************* docinfo-footer *************************************************************** -->
+</body>
+</html>
\ No newline at end of file
diff --git a/spec/images/issue.svg b/spec/images/issue.svg
new file mode 100644
index 0000000..f1651d2
--- /dev/null
+++ b/spec/images/issue.svg
@@ -0,0 +1,29 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:xl="http://www.w3.org/1999/xlink" version="1.1" xmlns="http://www.w3.org/2000/svg" viewBox="342 217 26 27" width="26" height="27">
+  <defs>
+    <font-face font-family="Helvetica Neue" font-size="21" panose-1="2 0 8 3 0 0 0 9 0 4" units-per-em="1000" underline-position="-100" underline-thickness="50" slope="0" x-height="517" cap-height="714" ascent="975.0061" descent="-216.99524" font-weight="700">
+      <font-face-src>
+        <font-face-name name="HelveticaNeue-Bold"/>
+      </font-face-src>
+    </font-face>
+  </defs>
+  <metadata> Produced by OmniGraffle 7.8.2 
+    <dc:date>2018-11-22 16:16:36 +0000</dc:date>
+  </metadata>
+  <g id="Canvas_1" fill-opacity="1" stroke-dasharray="none" stroke="none" stroke-opacity="1" fill="none">
+    <title>Canvas 1</title>
+    <g id="Canvas_1: Layer 1">
+      <title>Layer 1</title>
+      <g id="Graphic_4">
+        <circle cx="354.8125" cy="230.25" r="11.2500179763964" fill="white"/>
+        <circle cx="354.8125" cy="230.25" r="11.2500179763964" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="2"/>
+      </g>
+      <g id="Graphic_2">
+        <text transform="translate(351.8125 217.44543)" fill="black">
+          <tspan font-family="Helvetica Neue" font-size="21" font-weight="700" fill="black" x=".081" y="20">!</tspan>
+        </text>
+      </g>
+    </g>
+  </g>
+</svg>
diff --git a/spec/images/n4js-logo.png b/spec/images/n4js-logo.png
new file mode 100644
index 0000000..e0b8340
--- /dev/null
+++ b/spec/images/n4js-logo.png
Binary files differ
diff --git a/spec/images/n4jslogo.svg b/spec/images/n4jslogo.svg
old mode 100755
new mode 100644
diff --git a/spec/images/up-arrow.png b/spec/images/up-arrow.png
old mode 100755
new mode 100644
Binary files differ
diff --git a/spec/index.html b/spec/index.html
new file mode 100644
index 0000000..80d654d
--- /dev/null
+++ b/spec/index.html
@@ -0,0 +1,968 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="generator" content="Asciidoctor 1.5.5">
+<meta name="author" content="2019-08-07 15:02:40 CEST">
+<title>N4JS Language Specification</title>
+<link rel="stylesheet" href="styles/spec.min.css">
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.6.3/css/font-awesome.min.css">
+<!-- ************* docinfo ******************************************************************* -->
+
+
+<!-- ************* Favicon ************-->
+<link rel="icon" href="images/favicon.ico" />
+
+<!-- ************* Back-to-top JQuery ************* -->
+<script src="https://code.jquery.com/jquery-1.12.4.js"></script>
+<script src="https://code.jquery.com/ui/1.12.0/jquery-ui.js"></script>
+
+
+<link href="styles/prism.min.css" rel="stylesheet" />
+<script type="text/javascript" async
+  src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2/MathJax.js?config=TeX-MML-AM_CHTML">
+</script>
+
+<!-- ************* Styles ************* -->
+<link rel="stylesheet" type="text/css" href="styles/n4jsspec-adoc.css">
+
+
+<!-- ****************** NavBar ****************** -->
+<div id="menubar">
+	<div class="banner">
+        <a href="https://www.eclipse.org/n4js/#"><img id="logo" src="images/n4js-logo.png" alt="Eclipse N4JS"></a>
+    </div>
+<ul>
+  <li><a href="index.html">Index</a></li>
+</ul>
+</div>
+<!-- ************* docinfo ******************************************************************* -->
+<style>
+      .admonitionblock td.icon .icon-todo:before{content:"\f249";color:#f4ee42}
+    </style>
+</head>
+<body class="book toc2 toc-left">
+<div id="header">
+<h1>N4JS Language Specification</h1>
+<div class="details">
+<span id="author" class="author">2019-08-07 15:02:40 CEST</span><br>
+<span id="revnumber">version 0.9</span>
+</div>
+<div id="toc" class="toc2">
+<div id="toctitle">Table of Contents</div>
+<ul class="sectlevel1">
+<li><a href="introduction.html#_introduction">1. Introduction</a>
+<ul class="sectlevel2">
+<li><a href="introduction.html#_notation">1.1. Notation</a>
+<ul class="sectlevel3">
+<li><a href="introduction.html#_grammar-notation">1.1.1. Grammar Notation</a></li>
+<li><a href="introduction.html#_type-judgments-and-rules-and-constraints-notation">1.1.2. Type Judgments and Rules and Constraints Notation</a>
+<ul class="sectlevel4">
+<li><a href="introduction.html#_typing-rules-and-judgments">1.1.2.1. Typing Rules and Judgments</a></li>
+<li><a href="introduction.html#_types-of-an-element">1.1.2.2. Types of an Element</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="introduction.html#_auxiliary-functions">1.2. Auxiliary Functions</a>
+<ul class="sectlevel3">
+<li><a href="introduction.html#_binding">1.2.1. Binding</a></li>
+<li><a href="introduction.html#_merging-types">1.2.2. Merging Types</a>
+<ul class="sectlevel4">
+<li><a href="introduction.html#_logic-formulas">1.2.2.1. Logic Formulas</a></li>
+</ul>
+</li>
+<li><a href="introduction.html#_symbols-and-font-convention">1.2.3. Symbols and Font Convention</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="grammar.html#_grammar">2. Grammar</a>
+<ul class="sectlevel2">
+<li><a href="grammar.html#_lexical-conventions">2.1. Lexical Conventions</a>
+<ul class="sectlevel3">
+<li><a href="grammar.html#_identifier-names-and-identifiers">2.1.1. Identifier Names and Identifiers</a></li>
+<li><a href="grammar.html#_this-keyword">2.1.2. This Keyword</a></li>
+<li><a href="grammar.html#_regular-expression-literals">2.1.3. Regular Expression Literals</a></li>
+<li><a href="grammar.html#_automatic-semicolon-insertion">2.1.4. Automatic Semicolon Insertion</a></li>
+<li><a href="grammar.html#_jsdoc">2.1.5. JSDoc</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="names.html#_names">3. Names</a>
+<ul class="sectlevel2">
+<li><a href="names.html#_access-control">3.1. Access Control</a></li>
+<li><a href="names.html#_accessibility-of-types-top-level-variables-and-function-declarations">3.2. Accessibility of Types, Top-Level Variables and Function Declarations</a>
+<ul class="sectlevel3">
+<li><a href="names.html#_accessibility-of-members">3.2.1. Accessibility of Members</a></li>
+<li><a href="names.html#_valid-names">3.2.2. Valid Names</a></li>
+<li><a href="names.html#_qualified-names">3.2.3. Qualified Names</a></li>
+<li><a href="names.html#_name-duplicates">3.2.4. Name Duplicates</a>
+<ul class="sectlevel4">
+<li><a href="names.html#_lexical-environment">3.2.4.1. Lexical Environment</a></li>
+<li><a href="names.html#_duplicates-and-shadowing">3.2.4.2. Duplicates and Shadowing</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="types.html#_types">4. Types</a>
+<ul class="sectlevel2">
+<li><a href="types.html#_overview">4.1. Overview</a></li>
+<li><a href="types.html#_type-expressions">4.2. Type Expressions</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_syntax">4.2.1. Syntax</a></li>
+<li><a href="types.html#_properties">4.2.2. Properties</a></li>
+<li><a href="types.html#_semantics">4.2.3. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_type-inference">4.3. Type Inference</a></li>
+<li><a href="types.html#_generic-and-parameterized-types">4.4. Generic and Parameterized Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_generic-types">4.4.1. Generic Types</a></li>
+<li><a href="types.html#_type-variables">4.4.2. Type Variables</a></li>
+<li><a href="types.html#_parameterized-types">4.4.3. Parameterized Types</a></li>
+</ul>
+</li>
+<li><a href="types.html#_primitive-ecmascript-types">4.5. Primitive ECMAScript Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_undefined-type">4.5.1. Undefined Type</a></li>
+<li><a href="types.html#_null-type">4.5.2. Null Type</a></li>
+<li><a href="types.html#_primitive-boolean-type">4.5.3. Primitive Boolean Type</a></li>
+<li><a href="types.html#_primitive-string-type">4.5.4. Primitive String Type</a></li>
+<li><a href="types.html#_primitive-number-type">4.5.5. Primitive Number Type</a></li>
+<li><a href="types.html#_primitive-type-int">4.5.6. Primitive Type int</a></li>
+<li><a href="types.html#_primitive-symbol-type">4.5.7. Primitive Symbol Type</a></li>
+</ul>
+</li>
+<li><a href="types.html#_primitive-n4js-types">4.6. Primitive N4JS Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_any-type">4.6.1. Any Type</a>
+<ul class="sectlevel4">
+<li><a href="types.html#any-type-semantics">4.6.1.1. Semantics</a></li>
+<li><a href="types.html#any-type-type-inference">4.6.1.2. Type Inference</a>
+<ul class="sectlevel5">
+<li><a href="types.html#_default-type-of-variables">4.6.1.2.1. Default Type of Variables</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="types.html#_void-type">4.6.2. Void Type</a>
+<ul class="sectlevel4">
+<li><a href="types.html#void-type-semantics">4.6.2.1. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_unknown-type">4.6.3. Unknown Type</a></li>
+<li><a href="types.html#_primitive-pathselector-and-i18nkey">4.6.4. Primitive Pathselector and I18nKey</a>
+<ul class="sectlevel4">
+<li><a href="types.html#pathselector-semantics">4.6.4.1. Semantics</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="types.html#_built-in-ecmascript-object-types">4.7. Built-in ECMAScript Object Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#ECMAScript-objects-semantics">4.7.1. Semantics</a></li>
+<li><a href="types.html#_object-type">4.7.2. Object Type</a></li>
+<li><a href="types.html#_function-object-type">4.7.3. Function-Object-Type</a></li>
+<li><a href="types.html#_array-object-type">4.7.4. Array Object Type</a></li>
+<li><a href="types.html#_string-object-type">4.7.5. String Object Type</a></li>
+<li><a href="types.html#_boolean-object-type">4.7.6. Boolean Object Type</a></li>
+<li><a href="types.html#_number-object-type">4.7.7. Number Object Type</a></li>
+<li><a href="types.html#_global-object-type">4.7.8. Global Object Type</a></li>
+<li><a href="types.html#_symbol">4.7.9. Symbol</a></li>
+<li><a href="types.html#_promise">4.7.10. Promise</a></li>
+<li><a href="types.html#_iterator-interface">4.7.11. Iterator Interface</a></li>
+<li><a href="types.html#_iterable-interface">4.7.12. Iterable Interface</a></li>
+</ul>
+</li>
+<li><a href="types.html#_built-in-n4js-types">4.8. Built-In N4JS Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_n4object">4.8.1. N4Object</a>
+<ul class="sectlevel4">
+<li><a href="types.html#N4Object-semantics">4.8.1.1. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_n4class">4.8.2. N4Class</a></li>
+<li><a href="types.html#IterableN">4.8.3. IterableN</a></li>
+</ul>
+</li>
+<li><a href="types.html#_type-modifiers">4.9. Type Modifiers</a>
+<ul class="sectlevel3">
+<li><a href="types.html#Type_Modifiers_Dynamic">4.9.1. Dynamic</a></li>
+<li><a href="types.html#_optional-return-types">4.9.2. Optional Return Types</a></li>
+</ul>
+</li>
+<li><a href="types.html#_union-and-intersection-type-composed-types">4.10. Union and Intersection Type (Composed Types)</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_union-type">4.10.1. Union Type</a>
+<ul class="sectlevel4">
+<li><a href="types.html#union-type-syntax">4.10.1.1. Syntax</a></li>
+<li><a href="types.html#union-type-semantics">4.10.1.2. Semantics</a></li>
+<li><a href="types.html#_warnings">4.10.1.3. Warnings</a></li>
+</ul>
+</li>
+<li><a href="types.html#_intersection-type">4.10.2. Intersection Type</a>
+<ul class="sectlevel4">
+<li><a href="types.html#intersection-type-syntax">4.10.2.1. Syntax</a></li>
+<li><a href="types.html#intersection-type-semantics">4.10.2.2. Semantics</a></li>
+<li><a href="types.html#_warnings-2">4.10.2.3. Warnings</a></li>
+</ul>
+</li>
+<li><a href="types.html#_composed-types-in-wildcards">4.10.3. Composed Types in Wildcards</a></li>
+<li><a href="types.html#_property-access-for-composed-types">4.10.4. Property Access for Composed Types</a>
+<ul class="sectlevel4">
+<li><a href="types.html#_properties-of-union-type">4.10.4.1. Properties of Union Type</a>
+<ul class="sectlevel5">
+<li><a href="types.html#_remarks-on-union-type-s-members">4.10.4.1.1. Remarks on union type’s members:</a></li>
+</ul>
+</li>
+<li><a href="types.html#_properties-of-intersection-type">4.10.4.2. Properties of Intersection Type</a>
+<ul class="sectlevel5">
+<li><a href="types.html#_remarks-on-intersection-type-s-methods">4.10.4.2.1. Remarks on intersection type’s methods:</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="types.html#_constructor-and-classifier-type">4.11. Constructor and Classifier Type</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_syntax-3">4.11.1. Syntax</a></li>
+<li><a href="types.html#_semantics-2">4.11.2. Semantics</a></li>
+<li><a href="types.html#_constructors-and-prototypes-in-ecmascript-2015">4.11.3. Constructors and Prototypes in ECMAScript 2015</a></li>
+</ul>
+</li>
+<li><a href="types.html#_this-type">4.12. This Type</a>
+<ul class="sectlevel3">
+<li><a href="types.html#this-type-syntax">4.12.1. Syntax</a></li>
+<li><a href="types.html#this-keyword-semantics">4.12.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_enums">4.13. Enums</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_enums-n4js">4.13.1. Enums (N4JS)</a>
+<ul class="sectlevel4">
+<li><a href="types.html#enums-syntax">4.13.1.1. Syntax</a></li>
+<li><a href="types.html#enums-semantics">4.13.1.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_string-based-enums">4.13.2. String-Based Enums</a></li>
+</ul>
+</li>
+<li><a href="types.html#_short-hand-syntax">4.14. Short-Hand Syntax</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_array-short-hand-syntax">4.14.1. Array Short-Hand Syntax</a></li>
+<li><a href="types.html#_iterablen-short-hand-syntax">4.14.2. IterableN Short-Hand Syntax</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="classifiers.html#_classifiers">5. Classifiers</a>
+<ul class="sectlevel2">
+<li><a href="classifiers.html#_n4js-specific-classifiers">5.1. N4JS Specific Classifiers</a>
+<ul class="sectlevel3">
+<li><a href="classifiers.html#_properties-2">5.1.1. Properties</a></li>
+<li><a href="classifiers.html#_common-semantics-of-classifiers">5.1.2. Common Semantics of Classifiers</a></li>
+<li><a href="classifiers.html#_classes">5.1.3. Classes</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_definition-of-classes">5.1.3.1. Definition of Classes</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#class-syntax">5.1.3.1.1. Syntax</a></li>
+<li><a href="classifiers.html#class-properties">5.1.3.1.2. Properties</a></li>
+<li><a href="classifiers.html#class-type-inference">5.1.3.1.3. Type Inference</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#class-semantics">5.1.3.2. Semantics</a></li>
+<li><a href="classifiers.html#_final-modifier">5.1.3.3. Final Modifier</a></li>
+<li><a href="classifiers.html#_abstract-classes">5.1.3.4. Abstract Classes</a></li>
+<li><a href="classifiers.html#_non-instantiable-classes">5.1.3.5. Non-Instantiable Classes</a></li>
+<li><a href="classifiers.html#_superclass">5.1.3.6. Superclass</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_interfaces">5.1.4. Interfaces</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_definition-of-interfaces">5.1.4.1. Definition of Interfaces</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#interfaces-syntax">5.1.4.1.1. Syntax</a></li>
+<li><a href="classifiers.html#interfaces-properties">5.1.4.1.2. Properties</a></li>
+<li><a href="classifiers.html#interfaces-type-inference">5.1.4.1.3. Type Inference</a></li>
+<li><a href="classifiers.html#interfaces-semantics">5.1.4.1.4. Semantics</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="classifiers.html#_generic-classifiers">5.1.5. Generic Classifiers</a></li>
+<li><a href="classifiers.html#sec:definition-site-variance">5.1.6. Definition-Site Variance</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_members">5.2. Members</a>
+<ul class="sectlevel3">
+<li><a href="classifiers.html#_syntax-4">5.2.1. Syntax</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_properties-3">5.2.1.1. Properties</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_semantics-3">5.2.2. Semantics</a></li>
+<li><a href="classifiers.html#_methods">5.2.3. Methods</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_syntax-5">5.2.3.1. Syntax</a></li>
+<li><a href="classifiers.html#_properties-4">5.2.3.2. Properties</a></li>
+<li><a href="classifiers.html#_semantics-4">5.2.3.3. Semantics</a></li>
+<li><a href="classifiers.html#_final-methods">5.2.3.4. Final Methods</a></li>
+<li><a href="classifiers.html#_abstract-methods">5.2.3.5. Abstract Methods</a></li>
+<li><a href="classifiers.html#_generic-methods">5.2.3.6. Generic Methods</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_default-methods-in-interfaces">5.2.4. Default Methods in Interfaces</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_asynchronous-methods">5.2.4.1. Asynchronous Methods</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_constructors">5.2.5. Constructors</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_structural-this-type-in-constructor">5.2.5.1. Structural This Type in Constructor</a></li>
+<li><a href="classifiers.html#spec-constructor">5.2.5.2. @Spec Constructor</a></li>
+<li><a href="classifiers.html#_callable-constructors">5.2.5.3. Callable Constructors</a></li>
+<li><a href="classifiers.html#_covariant-constructors">5.2.5.4. Covariant Constructors</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_data-fields">5.2.6. Data Fields</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#data-fields-syntax">5.2.6.1. Syntax</a></li>
+<li><a href="classifiers.html#data-fields-properties">5.2.6.2. Properties</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#data-fields-semantics">5.2.6.2.1. Semantics</a></li>
+<li><a href="classifiers.html#data-fields-type-inference">5.2.6.2.2. Type Inference</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_assignment-modifiers">5.2.6.3. Assignment Modifiers</a></li>
+<li><a href="classifiers.html#_field-accessors-getter-setter">5.2.6.4. Field Accessors (Getter/Setter)</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#field-acessors-syntax">5.2.6.4.1. Syntax</a></li>
+<li><a href="classifiers.html#field-acessors-properties">5.2.6.4.2. Properties</a></li>
+<li><a href="classifiers.html#field-accessors-semantics">5.2.6.4.3. Semantics</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#optional-fields">5.2.6.5. Optional Fields</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#_syntax-6">5.2.6.5.1. Syntax</a></li>
+<li><a href="classifiers.html#_semantics-5">5.2.6.5.2. Semantics</a></li>
+<li><a href="classifiers.html#_background">5.2.6.5.3. Background</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="classifiers.html#_static-members">5.2.7. Static Members</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_access-from-and-to-static-members">5.2.7.1. Access From and To Static Members</a></li>
+<li><a href="classifiers.html#_generic-static-methods">5.2.7.2. Generic static methods</a></li>
+<li><a href="classifiers.html#_static-members-of-interfaces">5.2.7.3. Static Members of Interfaces</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_redefinition-of-members">5.2.8. Redefinition of Members</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_overriding-of-members">5.2.8.1. Overriding of Members</a></li>
+<li><a href="classifiers.html#_implementation-of-members">5.2.8.2. Implementation of Members</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#_member-consumption">5.2.8.2.1. Member Consumption</a></li>
+<li><a href="classifiers.html#_member-implementation">5.2.8.2.2. Member Implementation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="classifiers.html#_structural-typing">5.3. Structural Typing</a>
+<ul class="sectlevel3">
+<li><a href="classifiers.html#_syntax-7">5.3.1. Syntax</a></li>
+<li><a href="classifiers.html#_definition-site-structural-typing">5.3.2. Definition Site Structural Typing</a></li>
+<li><a href="classifiers.html#_use-site-structural-typing">5.3.3. Use-Site Structural Typing</a></li>
+<li><a href="classifiers.html#structural-readWriteInit-field-typing">5.3.4. Structural Read-only, Write-only and Initializer Field Typing</a></li>
+<li><a href="classifiers.html#_public-setter-annotated-with-code-providesinitializer-code">5.3.5. Public Setter Annotated With <code>ProvidesInitializer</code></a></li>
+<li><a href="classifiers.html#_structural-types-with-optional-fields">5.3.6. Structural Types With Optional Fields</a></li>
+<li><a href="classifiers.html#_structural-types-with-access-modifier">5.3.7. Structural Types With Access Modifier</a></li>
+<li><a href="classifiers.html#_structural-types-with-additional-members">5.3.8. Structural Types With Additional Members</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_syntax-8">5.3.8.1. Syntax</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#_semantics-6">5.3.8.1.1. Semantics</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="functions.html#_functions">6. Functions</a>
+<ul class="sectlevel2">
+<li><a href="functions.html#_function-type">6.1. Function Type</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_properties-5">6.1.1. Properties</a></li>
+<li><a href="functions.html#function-type-inference">6.1.2. Type Inference</a></li>
+<li><a href="functions.html#_autoboxing-of-function-type">6.1.3. Autoboxing of Function Type</a></li>
+<li><a href="functions.html#_arguments-object">6.1.4. Arguments Object</a></li>
+</ul>
+</li>
+<li><a href="functions.html#_ecmascript-5-function-definition">6.2. ECMAScript 5 Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_function-declaration">6.2.1. Function Declaration</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#_syntax-9">6.2.1.1. Syntax</a></li>
+<li><a href="functions.html#_semantics-8">6.2.1.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="functions.html#_function-expression">6.2.2. Function Expression</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#function-expression-syntax">6.2.2.1. Syntax</a></li>
+<li><a href="functions.html#_semantics-and-type-inference">6.2.2.2. Semantics and Type Inference</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="functions.html#_ecmascript-2015-function-definition">6.3. ECMAScript 2015 Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_formal-parameters">6.3.1. Formal Parameters</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#Type_Modifiers_Optional">6.3.1.1. Optional Parameters</a></li>
+<li><a href="functions.html#Type_Modifiers_Default">6.3.1.2. Default Parameters</a></li>
+<li><a href="functions.html#Type_Modifiers_Variadic">6.3.1.3. Variadic</a></li>
+</ul>
+</li>
+<li><a href="functions.html#_generator-functions">6.3.2. Generator Functions</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#generator-functions-syntax">6.3.2.1. Syntax</a></li>
+<li><a href="functions.html#generator-functions-semantics">6.3.2.2. Semantics</a></li>
+<li><a href="functions.html#_generator-arrow-functions">6.3.2.3. Generator Arrow Functions</a></li>
+</ul>
+</li>
+<li><a href="functions.html#_arrow-function-expression">6.3.3. Arrow Function Expression</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#arrow-function-expression-syntax">6.3.3.1. Syntax</a></li>
+<li><a href="functions.html#arrow-function-expression-semantics-and-type-inference">6.3.3.2. Semantics and Type Inference</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="functions.html#_ecmascript-proposals-function-definition">6.4. ECMAScript Proposals Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_asynchronous-functions">6.4.1. Asynchronous Functions</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#asynchronous-functions-syntax">6.4.1.1. Syntax</a></li>
+<li><a href="functions.html#asynchronous-functions-semantics">6.4.1.2. Semantics</a></li>
+<li><a href="functions.html#_asynchronous-arrow-functions">6.4.1.3. Asynchronous Arrow Functions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="functions.html#_n4js-extended-function-definition">6.5. N4JS Extended Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_generic-functions">6.5.1. Generic Functions</a></li>
+<li><a href="functions.html#_promisifiable-functions">6.5.2. Promisifiable Functions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_conversions-and-reflection">7. Conversions and Reflection</a>
+<ul class="sectlevel2">
+<li><a href="conversions_and_reflection.html#_autoboxing-and-coercing">7.1. Autoboxing and Coercing</a>
+<ul class="sectlevel3">
+<li><a href="conversions_and_reflection.html#_coercing">7.1.1. Coercing</a></li>
+<li><a href="conversions_and_reflection.html#_autoboxing-of-primitives">7.1.2. Autoboxing of Primitives</a></li>
+<li><a href="conversions_and_reflection.html#_autoboxing-of-function-expressions-and-declarations">7.1.3. Autoboxing of Function Expressions and Declarations</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_auto-conversion-of-objects">7.2. Auto-Conversion of Objects</a>
+<ul class="sectlevel3">
+<li><a href="conversions_and_reflection.html#_auto-conversion-of-class-instances">7.2.1. Auto-Conversion of Class Instances</a>
+<ul class="sectlevel4">
+<li><a href="conversions_and_reflection.html#_auto-conversion-of-interface-instances">7.2.1.1. Auto-Conversion of Interface Instances</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_auto-conversion-of-enum-literals">7.2.2. Auto-Conversion of Enum Literals</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_type-cast-and-type-check">7.3. Type Cast and Type Check</a>
+<ul class="sectlevel3">
+<li><a href="conversions_and_reflection.html#_type-cast">7.3.1. Type Cast</a></li>
+<li><a href="conversions_and_reflection.html#_type-check">7.3.2. Type Check</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_reflection-meta-information">7.4. Reflection meta-information</a>
+<ul class="sectlevel3">
+<li><a href="conversions_and_reflection.html#_reflection-for-classes">7.4.1. Reflection for Classes</a></li>
+<li><a href="conversions_and_reflection.html#_reflection-for-interfaces">7.4.2. Reflection for Interfaces</a></li>
+<li><a href="conversions_and_reflection.html#_reflection-for-enumerations">7.4.3. Reflection for Enumerations</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_conversion-of-primitive-types">7.5. Conversion of primitive types</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_expressions">8. Expressions</a>
+<ul class="sectlevel2">
+<li><a href="expressions.html#_ecmascript-5-expressions">8.1. ECMAScript 5 Expressions</a>
+<ul class="sectlevel3">
+<li><a href="expressions.html#_the-this-literal">8.1.1. The this Literal</a></li>
+<li><a href="expressions.html#_identifier">8.1.2. Identifier</a></li>
+<li><a href="expressions.html#_literals">8.1.3. Literals</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#_integer-literals">8.1.3.1. Integer Literals</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_array-literal">8.1.4. Array Literal</a></li>
+<li><a href="expressions.html#_object-literal">8.1.5. Object Literal</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#_properties-6">8.1.5.1. Properties</a></li>
+<li><a href="expressions.html#_scoping-and-linking">8.1.5.2. Scoping and linking</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_parenthesized-expression-and-grouping-operator">8.1.6. Parenthesized Expression and Grouping Operator</a></li>
+<li><a href="expressions.html#_property-accessors">8.1.7. Property Accessors</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#properties-1">8.1.7.1. Properties</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_new-expression">8.1.8. New Expression</a></li>
+<li><a href="expressions.html#_function-expression-2">8.1.9. Function Expression</a></li>
+<li><a href="expressions.html#_function-calls">8.1.10. Function Calls</a></li>
+<li><a href="expressions.html#_postfix-expression">8.1.11. Postfix Expression</a></li>
+<li><a href="expressions.html#_unary-expression">8.1.12. Unary Expression</a></li>
+<li><a href="expressions.html#_multiplicative-expression">8.1.13. Multiplicative Expression</a></li>
+<li><a href="expressions.html#_additive-expression">8.1.14. Additive Expression</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#type-inference-10">8.1.14.1. Type Inference</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_bitwise-shift-expression">8.1.15. Bitwise Shift Expression</a></li>
+<li><a href="expressions.html#_relational-expression">8.1.16. Relational Expression</a></li>
+<li><a href="expressions.html#_equality-expression">8.1.17. Equality Expression</a></li>
+<li><a href="expressions.html#_binary-bitwise-expression">8.1.18. Binary Bitwise Expression</a></li>
+<li><a href="expressions.html#_binary-logical-expression">8.1.19. Binary Logical Expression</a></li>
+<li><a href="expressions.html#_conditional-expression">8.1.20. Conditional Expression</a></li>
+<li><a href="expressions.html#_assignment-expression">8.1.21. Assignment Expression</a></li>
+<li><a href="expressions.html#_comma-expression">8.1.22. Comma Expression</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_ecmascript-6-expressions">8.2. ECMAScript 6 Expressions</a>
+<ul class="sectlevel3">
+<li><a href="expressions.html#_the-super-keyword">8.2.1. The super Keyword</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_ecmascript-7-expressions">8.3. ECMAScript 7 Expressions</a>
+<ul class="sectlevel3">
+<li><a href="expressions.html#_await-expression">8.3.1. Await Expression</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_n4js-specific-expressions">8.4. N4JS Specific Expressions</a>
+<ul class="sectlevel3">
+<li><a href="expressions.html#_class-expression">8.4.1. Class Expression</a></li>
+<li><a href="expressions.html#_cast-as-expression">8.4.2. Cast (As) Expression</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#cast-as-expression-semantics-type-inference">8.4.2.1. Semantics and Type Inference</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#Import_Calls">8.4.3. Import Calls</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#compile-time-expressions">8.5. Compile-Time Expressions</a></li>
+</ul>
+</li>
+<li><a href="statements.html#_statements">9. Statements</a>
+<ul class="sectlevel2">
+<li><a href="statements.html#_ecmascript-5-statements">9.1. ECMAScript 5 Statements</a>
+<ul class="sectlevel3">
+<li><a href="statements.html#_function-or-field-accessor-bodies">9.1.1. Function or Field Accessor Bodies</a></li>
+<li><a href="statements.html#_variable-statement">9.1.2. Variable Statement</a></li>
+<li><a href="statements.html#_if-statement">9.1.3. If Statement</a></li>
+<li><a href="statements.html#_iteration-statements">9.1.4. Iteration Statements</a></li>
+<li><a href="statements.html#_return-statement">9.1.5. Return Statement</a></li>
+<li><a href="statements.html#_with-statement">9.1.6. With Statement</a></li>
+<li><a href="statements.html#_switch-statement">9.1.7. Switch Statement</a></li>
+<li><a href="statements.html#_throw-try-and-catch-statements">9.1.8. Throw, Try, and Catch Statements</a></li>
+<li><a href="statements.html#_debugger-statement">9.1.9. Debugger Statement</a></li>
+</ul>
+</li>
+<li><a href="statements.html#_ecmascript-6-statements">9.2. ECMAScript 6 Statements</a>
+<ul class="sectlevel3">
+<li><a href="statements.html#_let">9.2.1. Let</a></li>
+<li><a href="statements.html#_const">9.2.2. Const</a></li>
+<li><a href="statements.html#_for-of-statement">9.2.3. <code>for &#8230;&#8203; of</code> statement</a></li>
+<li><a href="statements.html#_import-statement">9.2.4. Import Statement</a>
+<ul class="sectlevel4">
+<li><a href="statements.html#Dynamic_Imports">9.2.4.1. Dynamic Imports</a></li>
+<li><a href="statements.html#_immutabilaty-of-imports">9.2.4.2. Immutabilaty of Imports</a></li>
+</ul>
+</li>
+<li><a href="statements.html#_export-statement">9.2.5. Export Statement</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="annotations.html#_annotations">10. Annotations</a>
+<ul class="sectlevel2">
+<li><a href="annotations.html#_introduction-2">10.1. Introduction</a>
+<ul class="sectlevel3">
+<li><a href="annotations.html#_syntax-13">10.1.1. Syntax</a></li>
+<li><a href="annotations.html#_properties-7">10.1.2. Properties</a></li>
+<li><a href="annotations.html#_element-specific-annotations">10.1.3. Element-Specific Annotations</a></li>
+<li><a href="annotations.html#_general-annotations">10.1.4. General Annotations</a>
+<ul class="sectlevel4">
+<li><a href="annotations.html#_idebug">10.1.4.1. IDEBUG</a></li>
+</ul>
+</li>
+<li><a href="annotations.html#idebug-syntax">10.1.5. Syntax</a>
+<ul class="sectlevel4">
+<li><a href="annotations.html#_semantics-11">10.1.5.1. Semantics</a></li>
+<li><a href="annotations.html#_suppress-warnings">10.1.5.2. Suppress Warnings</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="annotations.html#_declaration-of-annotations">10.2. Declaration of Annotations</a></li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_extended-fetaures">11. Extended Fetaures</a>
+<ul class="sectlevel2">
+<li><a href="extended_fetaures.html#_array-and-object-destructuring">11.1. Array and Object Destructuring</a>
+<ul class="sectlevel3">
+<li><a href="extended_fetaures.html#_syntax-14">11.1.1. Syntax</a></li>
+<li><a href="extended_fetaures.html#_semantics-12">11.1.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_dependency-injection">11.2. Dependency Injection</a>
+<ul class="sectlevel3">
+<li><a href="extended_fetaures.html#_di-components-and-injectors">11.2.1. DI Components and Injectors</a>
+<ul class="sectlevel4">
+<li><a href="extended_fetaures.html#_dicomponent-relations">11.2.1.1. DIComponent Relations</a></li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_binders-and-bindings">11.2.2. Binders and Bindings</a></li>
+<li><a href="extended_fetaures.html#_injection-points">11.2.3. Injection Points</a>
+<ul class="sectlevel4">
+<li><a href="extended_fetaures.html#_field-injection">11.2.3.1. Field Injection</a></li>
+<li><a href="extended_fetaures.html#_constructor-injection">11.2.3.2. Constructor Injection</a></li>
+<li><a href="extended_fetaures.html#_method-injection">11.2.3.3. Method Injection</a>
+<ul class="sectlevel5">
+<li><a href="extended_fetaures.html#_provider">11.2.3.3.1. Provider</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_n4js-di-life-cycle-and-scopes">11.2.4. N4JS DI Life Cycle and Scopes</a>
+<ul class="sectlevel4">
+<li><a href="extended_fetaures.html#_injection-cylces">11.2.4.1. Injection Cylces</a></li>
+<li><a href="extended_fetaures.html#_default-scope">11.2.4.2. Default Scope</a></li>
+<li><a href="extended_fetaures.html#_singleton-scope">11.2.4.3. Singleton Scope</a></li>
+<li><a href="extended_fetaures.html#_per-injection-chain-singleton">11.2.4.4. Per Injection Chain Singleton</a></li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_validation-of-callsites-targeting-n4injector-methods">11.2.5. Validation of callsites targeting N4Injector methods</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-annotations">11.2.6. N4JS DI Annotations</a>
+<ul class="sectlevel4">
+<li><a href="extended_fetaures.html#_n4js-di-generateinjector">11.2.6.1. N4JS DI @GenerateInjector</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-withparentinjector">11.2.6.2. N4JS DI @WithParentInjector</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-usebinder">11.2.6.3. N4JS DI @UseBinder</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-binder">11.2.6.4. N4JS DI @Binder</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-bind">11.2.6.5. N4JS DI @Bind</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-provides">11.2.6.6. N4JS DI @Provides</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-inject">11.2.6.7. N4JS DI @Inject</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-singleton">11.2.6.8. N4JS DI @Singleton</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_test-support">11.3. Test Support</a></li>
+<li><a href="extended_fetaures.html#_polyfill-definitions">11.4. Polyfill Definitions</a>
+<ul class="sectlevel3">
+<li><a href="extended_fetaures.html#_runtime-polyfill-definitions">11.4.1. Runtime Polyfill Definitions</a></li>
+<li><a href="extended_fetaures.html#_static-polyfill-definitions">11.4.2. Static Polyfill Definitions</a></li>
+<li><a href="extended_fetaures.html#_transpiling-static-polyfilled-classes">11.4.3. Transpiling static polyfilled classes</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="components.html#_components">12. Components</a>
+<ul class="sectlevel2">
+<li><a href="components.html#_overview-2">12.1. Overview</a></li>
+<li><a href="components.html#Component_Types">12.2. Component Types</a>
+<ul class="sectlevel3">
+<li><a href="components.html#_libraries">12.2.1. Libraries</a></li>
+<li><a href="components.html#_runtime-environment-and-runtime-libraries">12.2.2. Runtime Environment and Runtime Libraries</a></li>
+<li><a href="components.html#_tests">12.2.3. Tests</a></li>
+<li><a href="components.html#_type-definitions">12.2.4. Type Definitions</a></li>
+</ul>
+</li>
+<li><a href="components.html#package-json">12.3. Package.json File</a>
+<ul class="sectlevel3">
+<li><a href="components.html#_basic-properties">12.3.1. Basic Properties</a></li>
+<li><a href="components.html#_n4js-properties">12.3.2. N4JS Properties</a></li>
+<li><a href="components.html#_constraints">12.3.3. Constraints</a></li>
+</ul>
+</li>
+<li><a href="components.html#_support-for-npm-scopes">12.4. Support for NPM Scopes</a></li>
+<li><a href="components.html#sec:N4JS-Type-Definitions">12.5. N4JS Type Definitions</a>
+<ul class="sectlevel3">
+<li><a href="components.html#_specify-type-definition">12.5.1. Specify Type Definition</a></li>
+<li><a href="components.html#_name-conventions">12.5.2. Name Conventions</a></li>
+<li><a href="components.html#_version-conventions">12.5.3. Version Conventions</a>
+<ul class="sectlevel4">
+<li><a href="components.html#_define-a-new-type-definition-package">12.5.3.1. Define a New Type Definition Package</a></li>
+<li><a href="components.html#_using-a-type-definition-package">12.5.3.2. Using a Type Definition Package</a></li>
+<li><a href="components.html#_rational">12.5.3.3. Rational</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="components.html#_modules">12.6. Modules</a></li>
+<li><a href="components.html#_api-and-implementation-component">12.7. API and Implementation Component</a>
+<ul class="sectlevel3">
+<li><a href="components.html#_execution-of-api-and-implementation-components">12.7.1. Execution of API and Implementation Components</a></li>
+<li><a href="components.html#_api-and-implementation-with-di">12.7.2. API and Implementation With DI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="plainjs.html#_plainjs">13. PlainJS</a>
+<ul class="sectlevel2">
+<li><a href="plainjs.html#_type-inference-and-validation-for-plain-js">13.1. Type Inference and Validation for Plain JS</a></li>
+<li><a href="plainjs.html#_external-declarations">13.2. External Declarations</a>
+<ul class="sectlevel3">
+<li><a href="plainjs.html#_declaring-externals">13.2.1. Declaring externals</a></li>
+<li><a href="plainjs.html#_instantiating-external-classes">13.2.2. Instantiating external classes</a></li>
+<li><a href="plainjs.html#_implementation-of-external-declarations">13.2.3. Implementation of External Declarations</a></li>
+<li><a href="plainjs.html#_example">13.2.4. Example</a></li>
+</ul>
+</li>
+<li><a href="plainjs.html#_global-definitions">13.3. Global Definitions</a></li>
+<li><a href="plainjs.html#_runtime-definitions">13.4. Runtime Definitions</a></li>
+<li><a href="plainjs.html#_applying-polyfills">13.5. Applying Polyfills</a></li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_jsdoc-2">14. JSDoc</a>
+<ul class="sectlevel2">
+<li><a href="jsdoc.html#_general-n4jsdoc-features">14.1. General N4JSDoc Features</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#_provided-inline-tags">14.1.1. Provided Inline Tags</a>
+<ul class="sectlevel4">
+<li><a href="jsdoc.html#jsdoc_tag__code">14.1.1.1. @code</a></li>
+<li><a href="jsdoc.html#jsdoc_tag__link">14.1.1.2. @link</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_n4jsdoc-for-user-projects">14.2. N4JSdoc for User Projects</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#_standard-tags">14.2.1. Standard Tags</a>
+<ul class="sectlevel4">
+<li><a href="jsdoc.html#_-author">14.2.1.1. @author</a></li>
+<li><a href="jsdoc.html#jsdoc_tag_param">14.2.1.2. @param</a></li>
+<li><a href="jsdoc.html#jsdoc_tag_return">14.2.1.3. @return</a></li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_test-related-tags">14.2.2. Test Related Tags</a>
+<ul class="sectlevel4">
+<li><a href="jsdoc.html#jsdoc_tag__testee">14.2.2.1. @testee</a></li>
+<li><a href="jsdoc.html#jsdoc_tag__testeeFromType">14.2.2.2. @testeeFromType</a></li>
+<li><a href="jsdoc.html#_testeeType_and__testeeMember">14.2.2.3. @testeeType and @testeeMember</a></li>
+<li><a href="jsdoc.html#jsdoc_tag_reqid_in_Tests">14.2.2.4. @reqid in Tests</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_n4jsdoc-for-api-and-implementation-projects">14.3. N4JSDoc for API and Implementation Projects</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#jsdoc_tag__apiNote">14.3.1. @apiNote</a></li>
+<li><a href="jsdoc.html#API_Project_Tags">14.3.2. API Project Tags</a>
+<ul class="sectlevel4">
+<li><a href="jsdoc.html#jsdoc_tag_apiState">14.3.2.1. @apiState</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsx.html#_jsx">15. JSX</a>
+<ul class="sectlevel2">
+<li><a href="jsx.html#_jsx-support">15.1. JSX Support</a></li>
+<li><a href="jsx.html#_jsx-backend">15.2. JSX Backend</a></li>
+</ul>
+</li>
+<li><a href="grammars.html#_grammars">16. Grammars</a>
+<ul class="sectlevel2">
+<li><a href="grammars.html#_type-expressions-grammar">16.1. Type Expressions Grammar</a></li>
+<li><a href="grammars.html#_n4js-language-grammar">16.2. N4JS Language Grammar</a></li>
+</ul>
+</li>
+<li><a href="jsobjects.html#_jsobjects">17. JSObjects</a>
+<ul class="sectlevel2">
+<li><a href="jsobjects.html#_object">17.1. Object</a></li>
+<li><a href="jsobjects.html#_string">17.2. String</a></li>
+<li><a href="jsobjects.html#_boolean">17.3. Boolean</a></li>
+<li><a href="jsobjects.html#_number">17.4. Number</a>
+<ul class="sectlevel3">
+<li><a href="jsobjects.html#_static-attributes">17.4.1. Static Attributes</a></li>
+</ul>
+</li>
+<li><a href="jsobjects.html#function">17.5. Function</a></li>
+<li><a href="jsobjects.html#_error">17.6. Error</a></li>
+<li><a href="jsobjects.html#_array">17.7. Array</a></li>
+<li><a href="jsobjects.html#_date">17.8. Date</a></li>
+<li><a href="jsobjects.html#_math">17.9. Math</a>
+<ul class="sectlevel3">
+<li><a href="jsobjects.html#static-attributes-1">17.9.1. Static Attributes</a></li>
+</ul>
+</li>
+<li><a href="jsobjects.html#_regexp">17.10. RegExp</a></li>
+<li><a href="jsobjects.html#_json">17.11. JSON</a></li>
+</ul>
+</li>
+<li><a href="n4js_objects.html#_n4js-objects">18. N4JS Objects</a>
+<ul class="sectlevel2">
+<li><a href="n4js_objects.html#_reflection-model">18.1. Reflection Model</a></li>
+<li><a href="n4js_objects.html#_error-types">18.2. Error Types</a>
+<ul class="sectlevel3">
+<li><a href="n4js_objects.html#_n4apinotimplemented">18.2.1. N4ApiNotImplemented</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_acronyms.html#_acronyms">Appendix A: Acronyms</a></li>
+<li><a href="appendix_b_license.html#sec:License">Appendix B: License</a></li>
+<li><a href="appendix_c_bibliography.html#_bibliography">Appendix C: Bibliography</a></li>
+</ul>
+</div>
+</div>
+<div id="content">
+<div id="preamble">
+<div class="sectionbody">
+<div class="paragraph center">
+<p><strong>Last Updated: 2019-08-07</strong></p>
+</div>
+<div class="paragraph center">
+<p><strong>Authors:</strong><br>
+Jens von Pilgrim, Jakub Siberski, Mark-Oliver Reiser, Torsten Krämer, Ákos Kitta, Sebastian Zarnekow, Lorenzo Bettini, Jörg Reichert, Kristian Duske, Marcus Mews, Minh Quang Tran, Luca Beurer-Kellner</p>
+</div>
+<div style="page-break-after: always;"></div>
+<h2 id="_abstract" class="discrete">Abstract</h2>
+<div class="paragraph">
+<p>This document contains the N4JS Specification.</p>
+</div>
+</div>
+</div>
+<ol>
+
+	<li><a href="./introduction.html#_introduction">Introduction</a>
+	</li>
+	<li><a href="./grammar.html#_grammar">Grammar</a>
+	</li>
+	<li><a href="./names.html#_names">Names</a>
+	</li>
+	<li><a href="./types.html#_types">Types</a>
+	</li>
+	<li><a href="./classifiers.html#_classifiers">Classifiers</a>
+	</li>
+	<li><a href="./functions.html#_functions">Functions</a>
+	</li>
+	<li><a href="./conversions_and_reflection.html#_conversions-and-reflection">Conversions and Reflection</a>
+	</li>
+	<li><a href="./expressions.html#_expressions">Expressions</a>
+	</li>
+	<li><a href="./statements.html#_statements">Statements</a>
+	</li>
+	<li><a href="./annotations.html#_annotations">Annotations</a>
+	</li>
+	<li><a href="./extended_fetaures.html#_extended-fetaures">Extended Fetaures</a>
+	</li>
+	<li><a href="./components.html#_components">Components</a>
+	</li>
+	<li><a href="./plainjs.html#_plainjs">PlainJS</a>
+	</li>
+	<li><a href="./jsdoc.html#_jsdoc-2">JSDoc</a>
+	</li>
+	<li><a href="./jsx.html#_jsx">JSX</a>
+	</li>
+	<li><a href="./grammars.html#_grammars">Grammars</a>
+	</li>
+	<li><a href="./jsobjects.html#_jsobjects">JSObjects</a>
+	</li>
+	<li><a href="./n4js_objects.html#_n4js-objects">N4JS Objects</a>
+	</li><li>Appendix
+<ol>
+
+	<li><a href="./appendix_a_acronyms.html#_acronyms">Acronyms</a></li>
+	<li><a href="./appendix_b_license.html#sec:License">License</a></li>
+	<li><a href="./appendix_c_bibliography.html#_bibliography">Bibliography</a></li></ol></li>
+
+</ol></div>
+<div id="footer">
+<div id="footer-text">
+Version 0.9<br>
+Last updated 2019-08-07 15:02:40 CEST
+</div>
+</div>
+<!-- ************* docinfo-footer *************************************************************** -->
+<div class="Grid social" style="color:#d5dfea">
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <h2>Quick Links</h2>
+    <ul>
+      <li><a href="../downloads.html">Download</a></li>
+      <li><a href="../userguides/index.html">Documentation</a></li>
+      <li><a href="https://github.com/eclipse/n4js/">Source</a></li>
+      <li><a href="https://github.com/eclipse/n4js/issues">Issues</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="https://www.eclipse.org/forums/index.php/f/365/">Forum</a></li>
+      <li><a href="http://n4js.blogspot.de/">Blog</a></li>
+      <li><a href="https://dev.eclipse.org/mailman/listinfo/n4js-dev">Mailing List</a></li>
+      <li><a href="https://projects.eclipse.org/projects/technology.n4js">Eclipse Project Page</a></li>
+      <li><a href="https://twitter.com/n4jsdev">Tweets by n4jsdev</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="http://www.eclipse.org/">Eclipse Home</a></li>
+      <li><a href="http://www.eclipse.org/legal/privacy.php">Privacy Policy</a></li>
+      <li><a href="http://www.eclipse.org/legal/termsofuse.php">Terms of Use</a></li>
+      <li><a href="http://www.eclipse.org/legal/copyright.php">Copyright Agent</a></li>
+      <li><a href="http://www.eclipse.org/legal/">Legal</a></li>
+    </ul>
+  </div>
+  <div style="clear: both; height: 0; overflow: hidden;"></div>
+</div>
+
+<!-- ************* UI Scripts ************* -->
+<script type="text/javascript" src="scripts/back-to-top.js"></script>
+
+<script type="text/javascript" src="scripts/treeview.js"></script>
+<script type="text/javascript" src="scripts/toc.js"></script>
+
+<!-- ************* Prism.js Syntax Highlighting ************* -->
+<script src="scripts/prism.js"></script>
+
+<script type="text/javascript">
+	// Add the 'toclist' id for search function
+	$(".toc2 > ul").attr('id', 'toclist');
+	// Generate a Search input form
+	$("#toclist > li:first-of-type").before('<input type="text" id="pagesearch" onkeyup="search()" placeholder="Search for section...">');
+	$("#toclist > li:first-of-type").before('<i id="clear" class="fa fa-times-circle-o"></i>');
+	$("#clear").click(function(){
+	    $("#pagesearch").val('');
+	    search();
+	    $('.toc2 > ul').treeView('collapseAll');
+	});
+	// intialize Treeview.js
+	$(".toc2 > ul").treeView();
+	// Initialize Scrollspy
+</script>
+<!-- ************* docinfo-footer *************************************************************** -->
+</body>
+</html>
\ No newline at end of file
diff --git a/spec/introduction.html b/spec/introduction.html
new file mode 100644
index 0000000..2057270
--- /dev/null
+++ b/spec/introduction.html
@@ -0,0 +1,1313 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="generator" content="Asciidoctor 1.5.5">
+<meta name="author" content="2019-08-07 15:02:40 CEST">
+<title>N4JS Language Specification</title>
+<link rel="stylesheet" href="styles/spec.min.css">
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.6.3/css/font-awesome.min.css">
+<!-- ************* docinfo ******************************************************************* -->
+
+
+<!-- ************* Favicon ************-->
+<link rel="icon" href="images/favicon.ico" />
+
+<!-- ************* Back-to-top JQuery ************* -->
+<script src="https://code.jquery.com/jquery-1.12.4.js"></script>
+<script src="https://code.jquery.com/ui/1.12.0/jquery-ui.js"></script>
+
+
+<link href="styles/prism.min.css" rel="stylesheet" />
+<script type="text/javascript" async
+  src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2/MathJax.js?config=TeX-MML-AM_CHTML">
+</script>
+
+<!-- ************* Styles ************* -->
+<link rel="stylesheet" type="text/css" href="styles/n4jsspec-adoc.css">
+
+
+<!-- ****************** NavBar ****************** -->
+<div id="menubar">
+	<div class="banner">
+        <a href="https://www.eclipse.org/n4js/#"><img id="logo" src="images/n4js-logo.png" alt="Eclipse N4JS"></a>
+    </div>
+<ul>
+  <li><a href="index.html">Index</a></li>
+</ul>
+</div>
+<!-- ************* docinfo ******************************************************************* -->
+<style>
+      .admonitionblock td.icon .icon-todo:before{content:"\f249";color:#f4ee42}
+    </style>
+</head>
+<body class="book toc2 toc-left">
+<div id="header">
+<h1>N4JS Language Specification</h1>
+<div class="details">
+<span id="author" class="author">2019-08-07 15:02:40 CEST</span><br>
+<span id="revnumber">version 0.9</span>
+</div>
+<div id="toc" class="toc2">
+<div id="toctitle">Table of Contents</div>
+<ul class="sectlevel1">
+<li><a href="#_introduction">1. Introduction</a>
+<ul class="sectlevel2">
+<li><a href="#_notation">1.1. Notation</a>
+<ul class="sectlevel3">
+<li><a href="#_grammar-notation">1.1.1. Grammar Notation</a></li>
+<li><a href="#_type-judgments-and-rules-and-constraints-notation">1.1.2. Type Judgments and Rules and Constraints Notation</a>
+<ul class="sectlevel4">
+<li><a href="#_typing-rules-and-judgments">1.1.2.1. Typing Rules and Judgments</a></li>
+<li><a href="#_types-of-an-element">1.1.2.2. Types of an Element</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#_auxiliary-functions">1.2. Auxiliary Functions</a>
+<ul class="sectlevel3">
+<li><a href="#_binding">1.2.1. Binding</a></li>
+<li><a href="#_merging-types">1.2.2. Merging Types</a>
+<ul class="sectlevel4">
+<li><a href="#_logic-formulas">1.2.2.1. Logic Formulas</a></li>
+</ul>
+</li>
+<li><a href="#_symbols-and-font-convention">1.2.3. Symbols and Font Convention</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="grammar.html#_grammar">2. Grammar</a>
+<ul class="sectlevel2">
+<li><a href="grammar.html#_lexical-conventions">2.1. Lexical Conventions</a>
+<ul class="sectlevel3">
+<li><a href="grammar.html#_identifier-names-and-identifiers">2.1.1. Identifier Names and Identifiers</a></li>
+<li><a href="grammar.html#_this-keyword">2.1.2. This Keyword</a></li>
+<li><a href="grammar.html#_regular-expression-literals">2.1.3. Regular Expression Literals</a></li>
+<li><a href="grammar.html#_automatic-semicolon-insertion">2.1.4. Automatic Semicolon Insertion</a></li>
+<li><a href="grammar.html#_jsdoc">2.1.5. JSDoc</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="names.html#_names">3. Names</a>
+<ul class="sectlevel2">
+<li><a href="names.html#_access-control">3.1. Access Control</a></li>
+<li><a href="names.html#_accessibility-of-types-top-level-variables-and-function-declarations">3.2. Accessibility of Types, Top-Level Variables and Function Declarations</a>
+<ul class="sectlevel3">
+<li><a href="names.html#_accessibility-of-members">3.2.1. Accessibility of Members</a></li>
+<li><a href="names.html#_valid-names">3.2.2. Valid Names</a></li>
+<li><a href="names.html#_qualified-names">3.2.3. Qualified Names</a></li>
+<li><a href="names.html#_name-duplicates">3.2.4. Name Duplicates</a>
+<ul class="sectlevel4">
+<li><a href="names.html#_lexical-environment">3.2.4.1. Lexical Environment</a></li>
+<li><a href="names.html#_duplicates-and-shadowing">3.2.4.2. Duplicates and Shadowing</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="types.html#_types">4. Types</a>
+<ul class="sectlevel2">
+<li><a href="types.html#_overview">4.1. Overview</a></li>
+<li><a href="types.html#_type-expressions">4.2. Type Expressions</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_syntax">4.2.1. Syntax</a></li>
+<li><a href="types.html#_properties">4.2.2. Properties</a></li>
+<li><a href="types.html#_semantics">4.2.3. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_type-inference">4.3. Type Inference</a></li>
+<li><a href="types.html#_generic-and-parameterized-types">4.4. Generic and Parameterized Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_generic-types">4.4.1. Generic Types</a></li>
+<li><a href="types.html#_type-variables">4.4.2. Type Variables</a></li>
+<li><a href="types.html#_parameterized-types">4.4.3. Parameterized Types</a></li>
+</ul>
+</li>
+<li><a href="types.html#_primitive-ecmascript-types">4.5. Primitive ECMAScript Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_undefined-type">4.5.1. Undefined Type</a></li>
+<li><a href="types.html#_null-type">4.5.2. Null Type</a></li>
+<li><a href="types.html#_primitive-boolean-type">4.5.3. Primitive Boolean Type</a></li>
+<li><a href="types.html#_primitive-string-type">4.5.4. Primitive String Type</a></li>
+<li><a href="types.html#_primitive-number-type">4.5.5. Primitive Number Type</a></li>
+<li><a href="types.html#_primitive-type-int">4.5.6. Primitive Type int</a></li>
+<li><a href="types.html#_primitive-symbol-type">4.5.7. Primitive Symbol Type</a></li>
+</ul>
+</li>
+<li><a href="types.html#_primitive-n4js-types">4.6. Primitive N4JS Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_any-type">4.6.1. Any Type</a>
+<ul class="sectlevel4">
+<li><a href="types.html#any-type-semantics">4.6.1.1. Semantics</a></li>
+<li><a href="types.html#any-type-type-inference">4.6.1.2. Type Inference</a>
+<ul class="sectlevel5">
+<li><a href="types.html#_default-type-of-variables">4.6.1.2.1. Default Type of Variables</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="types.html#_void-type">4.6.2. Void Type</a>
+<ul class="sectlevel4">
+<li><a href="types.html#void-type-semantics">4.6.2.1. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_unknown-type">4.6.3. Unknown Type</a></li>
+<li><a href="types.html#_primitive-pathselector-and-i18nkey">4.6.4. Primitive Pathselector and I18nKey</a>
+<ul class="sectlevel4">
+<li><a href="types.html#pathselector-semantics">4.6.4.1. Semantics</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="types.html#_built-in-ecmascript-object-types">4.7. Built-in ECMAScript Object Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#ECMAScript-objects-semantics">4.7.1. Semantics</a></li>
+<li><a href="types.html#_object-type">4.7.2. Object Type</a></li>
+<li><a href="types.html#_function-object-type">4.7.3. Function-Object-Type</a></li>
+<li><a href="types.html#_array-object-type">4.7.4. Array Object Type</a></li>
+<li><a href="types.html#_string-object-type">4.7.5. String Object Type</a></li>
+<li><a href="types.html#_boolean-object-type">4.7.6. Boolean Object Type</a></li>
+<li><a href="types.html#_number-object-type">4.7.7. Number Object Type</a></li>
+<li><a href="types.html#_global-object-type">4.7.8. Global Object Type</a></li>
+<li><a href="types.html#_symbol">4.7.9. Symbol</a></li>
+<li><a href="types.html#_promise">4.7.10. Promise</a></li>
+<li><a href="types.html#_iterator-interface">4.7.11. Iterator Interface</a></li>
+<li><a href="types.html#_iterable-interface">4.7.12. Iterable Interface</a></li>
+</ul>
+</li>
+<li><a href="types.html#_built-in-n4js-types">4.8. Built-In N4JS Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_n4object">4.8.1. N4Object</a>
+<ul class="sectlevel4">
+<li><a href="types.html#N4Object-semantics">4.8.1.1. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_n4class">4.8.2. N4Class</a></li>
+<li><a href="types.html#IterableN">4.8.3. IterableN</a></li>
+</ul>
+</li>
+<li><a href="types.html#_type-modifiers">4.9. Type Modifiers</a>
+<ul class="sectlevel3">
+<li><a href="types.html#Type_Modifiers_Dynamic">4.9.1. Dynamic</a></li>
+<li><a href="types.html#_optional-return-types">4.9.2. Optional Return Types</a></li>
+</ul>
+</li>
+<li><a href="types.html#_union-and-intersection-type-composed-types">4.10. Union and Intersection Type (Composed Types)</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_union-type">4.10.1. Union Type</a>
+<ul class="sectlevel4">
+<li><a href="types.html#union-type-syntax">4.10.1.1. Syntax</a></li>
+<li><a href="types.html#union-type-semantics">4.10.1.2. Semantics</a></li>
+<li><a href="types.html#_warnings">4.10.1.3. Warnings</a></li>
+</ul>
+</li>
+<li><a href="types.html#_intersection-type">4.10.2. Intersection Type</a>
+<ul class="sectlevel4">
+<li><a href="types.html#intersection-type-syntax">4.10.2.1. Syntax</a></li>
+<li><a href="types.html#intersection-type-semantics">4.10.2.2. Semantics</a></li>
+<li><a href="types.html#_warnings-2">4.10.2.3. Warnings</a></li>
+</ul>
+</li>
+<li><a href="types.html#_composed-types-in-wildcards">4.10.3. Composed Types in Wildcards</a></li>
+<li><a href="types.html#_property-access-for-composed-types">4.10.4. Property Access for Composed Types</a>
+<ul class="sectlevel4">
+<li><a href="types.html#_properties-of-union-type">4.10.4.1. Properties of Union Type</a>
+<ul class="sectlevel5">
+<li><a href="types.html#_remarks-on-union-type-s-members">4.10.4.1.1. Remarks on union type’s members:</a></li>
+</ul>
+</li>
+<li><a href="types.html#_properties-of-intersection-type">4.10.4.2. Properties of Intersection Type</a>
+<ul class="sectlevel5">
+<li><a href="types.html#_remarks-on-intersection-type-s-methods">4.10.4.2.1. Remarks on intersection type’s methods:</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="types.html#_constructor-and-classifier-type">4.11. Constructor and Classifier Type</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_syntax-3">4.11.1. Syntax</a></li>
+<li><a href="types.html#_semantics-2">4.11.2. Semantics</a></li>
+<li><a href="types.html#_constructors-and-prototypes-in-ecmascript-2015">4.11.3. Constructors and Prototypes in ECMAScript 2015</a></li>
+</ul>
+</li>
+<li><a href="types.html#_this-type">4.12. This Type</a>
+<ul class="sectlevel3">
+<li><a href="types.html#this-type-syntax">4.12.1. Syntax</a></li>
+<li><a href="types.html#this-keyword-semantics">4.12.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_enums">4.13. Enums</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_enums-n4js">4.13.1. Enums (N4JS)</a>
+<ul class="sectlevel4">
+<li><a href="types.html#enums-syntax">4.13.1.1. Syntax</a></li>
+<li><a href="types.html#enums-semantics">4.13.1.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_string-based-enums">4.13.2. String-Based Enums</a></li>
+</ul>
+</li>
+<li><a href="types.html#_short-hand-syntax">4.14. Short-Hand Syntax</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_array-short-hand-syntax">4.14.1. Array Short-Hand Syntax</a></li>
+<li><a href="types.html#_iterablen-short-hand-syntax">4.14.2. IterableN Short-Hand Syntax</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="classifiers.html#_classifiers">5. Classifiers</a>
+<ul class="sectlevel2">
+<li><a href="classifiers.html#_n4js-specific-classifiers">5.1. N4JS Specific Classifiers</a>
+<ul class="sectlevel3">
+<li><a href="classifiers.html#_properties-2">5.1.1. Properties</a></li>
+<li><a href="classifiers.html#_common-semantics-of-classifiers">5.1.2. Common Semantics of Classifiers</a></li>
+<li><a href="classifiers.html#_classes">5.1.3. Classes</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_definition-of-classes">5.1.3.1. Definition of Classes</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#class-syntax">5.1.3.1.1. Syntax</a></li>
+<li><a href="classifiers.html#class-properties">5.1.3.1.2. Properties</a></li>
+<li><a href="classifiers.html#class-type-inference">5.1.3.1.3. Type Inference</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#class-semantics">5.1.3.2. Semantics</a></li>
+<li><a href="classifiers.html#_final-modifier">5.1.3.3. Final Modifier</a></li>
+<li><a href="classifiers.html#_abstract-classes">5.1.3.4. Abstract Classes</a></li>
+<li><a href="classifiers.html#_non-instantiable-classes">5.1.3.5. Non-Instantiable Classes</a></li>
+<li><a href="classifiers.html#_superclass">5.1.3.6. Superclass</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_interfaces">5.1.4. Interfaces</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_definition-of-interfaces">5.1.4.1. Definition of Interfaces</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#interfaces-syntax">5.1.4.1.1. Syntax</a></li>
+<li><a href="classifiers.html#interfaces-properties">5.1.4.1.2. Properties</a></li>
+<li><a href="classifiers.html#interfaces-type-inference">5.1.4.1.3. Type Inference</a></li>
+<li><a href="classifiers.html#interfaces-semantics">5.1.4.1.4. Semantics</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="classifiers.html#_generic-classifiers">5.1.5. Generic Classifiers</a></li>
+<li><a href="classifiers.html#sec:definition-site-variance">5.1.6. Definition-Site Variance</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_members">5.2. Members</a>
+<ul class="sectlevel3">
+<li><a href="classifiers.html#_syntax-4">5.2.1. Syntax</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_properties-3">5.2.1.1. Properties</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_semantics-3">5.2.2. Semantics</a></li>
+<li><a href="classifiers.html#_methods">5.2.3. Methods</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_syntax-5">5.2.3.1. Syntax</a></li>
+<li><a href="classifiers.html#_properties-4">5.2.3.2. Properties</a></li>
+<li><a href="classifiers.html#_semantics-4">5.2.3.3. Semantics</a></li>
+<li><a href="classifiers.html#_final-methods">5.2.3.4. Final Methods</a></li>
+<li><a href="classifiers.html#_abstract-methods">5.2.3.5. Abstract Methods</a></li>
+<li><a href="classifiers.html#_generic-methods">5.2.3.6. Generic Methods</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_default-methods-in-interfaces">5.2.4. Default Methods in Interfaces</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_asynchronous-methods">5.2.4.1. Asynchronous Methods</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_constructors">5.2.5. Constructors</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_structural-this-type-in-constructor">5.2.5.1. Structural This Type in Constructor</a></li>
+<li><a href="classifiers.html#spec-constructor">5.2.5.2. @Spec Constructor</a></li>
+<li><a href="classifiers.html#_callable-constructors">5.2.5.3. Callable Constructors</a></li>
+<li><a href="classifiers.html#_covariant-constructors">5.2.5.4. Covariant Constructors</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_data-fields">5.2.6. Data Fields</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#data-fields-syntax">5.2.6.1. Syntax</a></li>
+<li><a href="classifiers.html#data-fields-properties">5.2.6.2. Properties</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#data-fields-semantics">5.2.6.2.1. Semantics</a></li>
+<li><a href="classifiers.html#data-fields-type-inference">5.2.6.2.2. Type Inference</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_assignment-modifiers">5.2.6.3. Assignment Modifiers</a></li>
+<li><a href="classifiers.html#_field-accessors-getter-setter">5.2.6.4. Field Accessors (Getter/Setter)</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#field-acessors-syntax">5.2.6.4.1. Syntax</a></li>
+<li><a href="classifiers.html#field-acessors-properties">5.2.6.4.2. Properties</a></li>
+<li><a href="classifiers.html#field-accessors-semantics">5.2.6.4.3. Semantics</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#optional-fields">5.2.6.5. Optional Fields</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#_syntax-6">5.2.6.5.1. Syntax</a></li>
+<li><a href="classifiers.html#_semantics-5">5.2.6.5.2. Semantics</a></li>
+<li><a href="classifiers.html#_background">5.2.6.5.3. Background</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="classifiers.html#_static-members">5.2.7. Static Members</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_access-from-and-to-static-members">5.2.7.1. Access From and To Static Members</a></li>
+<li><a href="classifiers.html#_generic-static-methods">5.2.7.2. Generic static methods</a></li>
+<li><a href="classifiers.html#_static-members-of-interfaces">5.2.7.3. Static Members of Interfaces</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_redefinition-of-members">5.2.8. Redefinition of Members</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_overriding-of-members">5.2.8.1. Overriding of Members</a></li>
+<li><a href="classifiers.html#_implementation-of-members">5.2.8.2. Implementation of Members</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#_member-consumption">5.2.8.2.1. Member Consumption</a></li>
+<li><a href="classifiers.html#_member-implementation">5.2.8.2.2. Member Implementation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="classifiers.html#_structural-typing">5.3. Structural Typing</a>
+<ul class="sectlevel3">
+<li><a href="classifiers.html#_syntax-7">5.3.1. Syntax</a></li>
+<li><a href="classifiers.html#_definition-site-structural-typing">5.3.2. Definition Site Structural Typing</a></li>
+<li><a href="classifiers.html#_use-site-structural-typing">5.3.3. Use-Site Structural Typing</a></li>
+<li><a href="classifiers.html#structural-readWriteInit-field-typing">5.3.4. Structural Read-only, Write-only and Initializer Field Typing</a></li>
+<li><a href="classifiers.html#_public-setter-annotated-with-code-providesinitializer-code">5.3.5. Public Setter Annotated With <code>ProvidesInitializer</code></a></li>
+<li><a href="classifiers.html#_structural-types-with-optional-fields">5.3.6. Structural Types With Optional Fields</a></li>
+<li><a href="classifiers.html#_structural-types-with-access-modifier">5.3.7. Structural Types With Access Modifier</a></li>
+<li><a href="classifiers.html#_structural-types-with-additional-members">5.3.8. Structural Types With Additional Members</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_syntax-8">5.3.8.1. Syntax</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#_semantics-6">5.3.8.1.1. Semantics</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="functions.html#_functions">6. Functions</a>
+<ul class="sectlevel2">
+<li><a href="functions.html#_function-type">6.1. Function Type</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_properties-5">6.1.1. Properties</a></li>
+<li><a href="functions.html#function-type-inference">6.1.2. Type Inference</a></li>
+<li><a href="functions.html#_autoboxing-of-function-type">6.1.3. Autoboxing of Function Type</a></li>
+<li><a href="functions.html#_arguments-object">6.1.4. Arguments Object</a></li>
+</ul>
+</li>
+<li><a href="functions.html#_ecmascript-5-function-definition">6.2. ECMAScript 5 Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_function-declaration">6.2.1. Function Declaration</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#_syntax-9">6.2.1.1. Syntax</a></li>
+<li><a href="functions.html#_semantics-8">6.2.1.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="functions.html#_function-expression">6.2.2. Function Expression</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#function-expression-syntax">6.2.2.1. Syntax</a></li>
+<li><a href="functions.html#_semantics-and-type-inference">6.2.2.2. Semantics and Type Inference</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="functions.html#_ecmascript-2015-function-definition">6.3. ECMAScript 2015 Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_formal-parameters">6.3.1. Formal Parameters</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#Type_Modifiers_Optional">6.3.1.1. Optional Parameters</a></li>
+<li><a href="functions.html#Type_Modifiers_Default">6.3.1.2. Default Parameters</a></li>
+<li><a href="functions.html#Type_Modifiers_Variadic">6.3.1.3. Variadic</a></li>
+</ul>
+</li>
+<li><a href="functions.html#_generator-functions">6.3.2. Generator Functions</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#generator-functions-syntax">6.3.2.1. Syntax</a></li>
+<li><a href="functions.html#generator-functions-semantics">6.3.2.2. Semantics</a></li>
+<li><a href="functions.html#_generator-arrow-functions">6.3.2.3. Generator Arrow Functions</a></li>
+</ul>
+</li>
+<li><a href="functions.html#_arrow-function-expression">6.3.3. Arrow Function Expression</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#arrow-function-expression-syntax">6.3.3.1. Syntax</a></li>
+<li><a href="functions.html#arrow-function-expression-semantics-and-type-inference">6.3.3.2. Semantics and Type Inference</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="functions.html#_ecmascript-proposals-function-definition">6.4. ECMAScript Proposals Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_asynchronous-functions">6.4.1. Asynchronous Functions</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#asynchronous-functions-syntax">6.4.1.1. Syntax</a></li>
+<li><a href="functions.html#asynchronous-functions-semantics">6.4.1.2. Semantics</a></li>
+<li><a href="functions.html#_asynchronous-arrow-functions">6.4.1.3. Asynchronous Arrow Functions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="functions.html#_n4js-extended-function-definition">6.5. N4JS Extended Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_generic-functions">6.5.1. Generic Functions</a></li>
+<li><a href="functions.html#_promisifiable-functions">6.5.2. Promisifiable Functions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_conversions-and-reflection">7. Conversions and Reflection</a>
+<ul class="sectlevel2">
+<li><a href="conversions_and_reflection.html#_autoboxing-and-coercing">7.1. Autoboxing and Coercing</a>
+<ul class="sectlevel3">
+<li><a href="conversions_and_reflection.html#_coercing">7.1.1. Coercing</a></li>
+<li><a href="conversions_and_reflection.html#_autoboxing-of-primitives">7.1.2. Autoboxing of Primitives</a></li>
+<li><a href="conversions_and_reflection.html#_autoboxing-of-function-expressions-and-declarations">7.1.3. Autoboxing of Function Expressions and Declarations</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_auto-conversion-of-objects">7.2. Auto-Conversion of Objects</a>
+<ul class="sectlevel3">
+<li><a href="conversions_and_reflection.html#_auto-conversion-of-class-instances">7.2.1. Auto-Conversion of Class Instances</a>
+<ul class="sectlevel4">
+<li><a href="conversions_and_reflection.html#_auto-conversion-of-interface-instances">7.2.1.1. Auto-Conversion of Interface Instances</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_auto-conversion-of-enum-literals">7.2.2. Auto-Conversion of Enum Literals</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_type-cast-and-type-check">7.3. Type Cast and Type Check</a>
+<ul class="sectlevel3">
+<li><a href="conversions_and_reflection.html#_type-cast">7.3.1. Type Cast</a></li>
+<li><a href="conversions_and_reflection.html#_type-check">7.3.2. Type Check</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_reflection-meta-information">7.4. Reflection meta-information</a>
+<ul class="sectlevel3">
+<li><a href="conversions_and_reflection.html#_reflection-for-classes">7.4.1. Reflection for Classes</a></li>
+<li><a href="conversions_and_reflection.html#_reflection-for-interfaces">7.4.2. Reflection for Interfaces</a></li>
+<li><a href="conversions_and_reflection.html#_reflection-for-enumerations">7.4.3. Reflection for Enumerations</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_conversion-of-primitive-types">7.5. Conversion of primitive types</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_expressions">8. Expressions</a>
+<ul class="sectlevel2">
+<li><a href="expressions.html#_ecmascript-5-expressions">8.1. ECMAScript 5 Expressions</a>
+<ul class="sectlevel3">
+<li><a href="expressions.html#_the-this-literal">8.1.1. The this Literal</a></li>
+<li><a href="expressions.html#_identifier">8.1.2. Identifier</a></li>
+<li><a href="expressions.html#_literals">8.1.3. Literals</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#_integer-literals">8.1.3.1. Integer Literals</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_array-literal">8.1.4. Array Literal</a></li>
+<li><a href="expressions.html#_object-literal">8.1.5. Object Literal</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#_properties-6">8.1.5.1. Properties</a></li>
+<li><a href="expressions.html#_scoping-and-linking">8.1.5.2. Scoping and linking</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_parenthesized-expression-and-grouping-operator">8.1.6. Parenthesized Expression and Grouping Operator</a></li>
+<li><a href="expressions.html#_property-accessors">8.1.7. Property Accessors</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#properties-1">8.1.7.1. Properties</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_new-expression">8.1.8. New Expression</a></li>
+<li><a href="expressions.html#_function-expression-2">8.1.9. Function Expression</a></li>
+<li><a href="expressions.html#_function-calls">8.1.10. Function Calls</a></li>
+<li><a href="expressions.html#_postfix-expression">8.1.11. Postfix Expression</a></li>
+<li><a href="expressions.html#_unary-expression">8.1.12. Unary Expression</a></li>
+<li><a href="expressions.html#_multiplicative-expression">8.1.13. Multiplicative Expression</a></li>
+<li><a href="expressions.html#_additive-expression">8.1.14. Additive Expression</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#type-inference-10">8.1.14.1. Type Inference</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_bitwise-shift-expression">8.1.15. Bitwise Shift Expression</a></li>
+<li><a href="expressions.html#_relational-expression">8.1.16. Relational Expression</a></li>
+<li><a href="expressions.html#_equality-expression">8.1.17. Equality Expression</a></li>
+<li><a href="expressions.html#_binary-bitwise-expression">8.1.18. Binary Bitwise Expression</a></li>
+<li><a href="expressions.html#_binary-logical-expression">8.1.19. Binary Logical Expression</a></li>
+<li><a href="expressions.html#_conditional-expression">8.1.20. Conditional Expression</a></li>
+<li><a href="expressions.html#_assignment-expression">8.1.21. Assignment Expression</a></li>
+<li><a href="expressions.html#_comma-expression">8.1.22. Comma Expression</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_ecmascript-6-expressions">8.2. ECMAScript 6 Expressions</a>
+<ul class="sectlevel3">
+<li><a href="expressions.html#_the-super-keyword">8.2.1. The super Keyword</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_ecmascript-7-expressions">8.3. ECMAScript 7 Expressions</a>
+<ul class="sectlevel3">
+<li><a href="expressions.html#_await-expression">8.3.1. Await Expression</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_n4js-specific-expressions">8.4. N4JS Specific Expressions</a>
+<ul class="sectlevel3">
+<li><a href="expressions.html#_class-expression">8.4.1. Class Expression</a></li>
+<li><a href="expressions.html#_cast-as-expression">8.4.2. Cast (As) Expression</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#cast-as-expression-semantics-type-inference">8.4.2.1. Semantics and Type Inference</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#Import_Calls">8.4.3. Import Calls</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#compile-time-expressions">8.5. Compile-Time Expressions</a></li>
+</ul>
+</li>
+<li><a href="statements.html#_statements">9. Statements</a>
+<ul class="sectlevel2">
+<li><a href="statements.html#_ecmascript-5-statements">9.1. ECMAScript 5 Statements</a>
+<ul class="sectlevel3">
+<li><a href="statements.html#_function-or-field-accessor-bodies">9.1.1. Function or Field Accessor Bodies</a></li>
+<li><a href="statements.html#_variable-statement">9.1.2. Variable Statement</a></li>
+<li><a href="statements.html#_if-statement">9.1.3. If Statement</a></li>
+<li><a href="statements.html#_iteration-statements">9.1.4. Iteration Statements</a></li>
+<li><a href="statements.html#_return-statement">9.1.5. Return Statement</a></li>
+<li><a href="statements.html#_with-statement">9.1.6. With Statement</a></li>
+<li><a href="statements.html#_switch-statement">9.1.7. Switch Statement</a></li>
+<li><a href="statements.html#_throw-try-and-catch-statements">9.1.8. Throw, Try, and Catch Statements</a></li>
+<li><a href="statements.html#_debugger-statement">9.1.9. Debugger Statement</a></li>
+</ul>
+</li>
+<li><a href="statements.html#_ecmascript-6-statements">9.2. ECMAScript 6 Statements</a>
+<ul class="sectlevel3">
+<li><a href="statements.html#_let">9.2.1. Let</a></li>
+<li><a href="statements.html#_const">9.2.2. Const</a></li>
+<li><a href="statements.html#_for-of-statement">9.2.3. <code>for &#8230;&#8203; of</code> statement</a></li>
+<li><a href="statements.html#_import-statement">9.2.4. Import Statement</a>
+<ul class="sectlevel4">
+<li><a href="statements.html#Dynamic_Imports">9.2.4.1. Dynamic Imports</a></li>
+<li><a href="statements.html#_immutabilaty-of-imports">9.2.4.2. Immutabilaty of Imports</a></li>
+</ul>
+</li>
+<li><a href="statements.html#_export-statement">9.2.5. Export Statement</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="annotations.html#_annotations">10. Annotations</a>
+<ul class="sectlevel2">
+<li><a href="annotations.html#_introduction-2">10.1. Introduction</a>
+<ul class="sectlevel3">
+<li><a href="annotations.html#_syntax-13">10.1.1. Syntax</a></li>
+<li><a href="annotations.html#_properties-7">10.1.2. Properties</a></li>
+<li><a href="annotations.html#_element-specific-annotations">10.1.3. Element-Specific Annotations</a></li>
+<li><a href="annotations.html#_general-annotations">10.1.4. General Annotations</a>
+<ul class="sectlevel4">
+<li><a href="annotations.html#_idebug">10.1.4.1. IDEBUG</a></li>
+</ul>
+</li>
+<li><a href="annotations.html#idebug-syntax">10.1.5. Syntax</a>
+<ul class="sectlevel4">
+<li><a href="annotations.html#_semantics-11">10.1.5.1. Semantics</a></li>
+<li><a href="annotations.html#_suppress-warnings">10.1.5.2. Suppress Warnings</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="annotations.html#_declaration-of-annotations">10.2. Declaration of Annotations</a></li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_extended-fetaures">11. Extended Fetaures</a>
+<ul class="sectlevel2">
+<li><a href="extended_fetaures.html#_array-and-object-destructuring">11.1. Array and Object Destructuring</a>
+<ul class="sectlevel3">
+<li><a href="extended_fetaures.html#_syntax-14">11.1.1. Syntax</a></li>
+<li><a href="extended_fetaures.html#_semantics-12">11.1.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_dependency-injection">11.2. Dependency Injection</a>
+<ul class="sectlevel3">
+<li><a href="extended_fetaures.html#_di-components-and-injectors">11.2.1. DI Components and Injectors</a>
+<ul class="sectlevel4">
+<li><a href="extended_fetaures.html#_dicomponent-relations">11.2.1.1. DIComponent Relations</a></li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_binders-and-bindings">11.2.2. Binders and Bindings</a></li>
+<li><a href="extended_fetaures.html#_injection-points">11.2.3. Injection Points</a>
+<ul class="sectlevel4">
+<li><a href="extended_fetaures.html#_field-injection">11.2.3.1. Field Injection</a></li>
+<li><a href="extended_fetaures.html#_constructor-injection">11.2.3.2. Constructor Injection</a></li>
+<li><a href="extended_fetaures.html#_method-injection">11.2.3.3. Method Injection</a>
+<ul class="sectlevel5">
+<li><a href="extended_fetaures.html#_provider">11.2.3.3.1. Provider</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_n4js-di-life-cycle-and-scopes">11.2.4. N4JS DI Life Cycle and Scopes</a>
+<ul class="sectlevel4">
+<li><a href="extended_fetaures.html#_injection-cylces">11.2.4.1. Injection Cylces</a></li>
+<li><a href="extended_fetaures.html#_default-scope">11.2.4.2. Default Scope</a></li>
+<li><a href="extended_fetaures.html#_singleton-scope">11.2.4.3. Singleton Scope</a></li>
+<li><a href="extended_fetaures.html#_per-injection-chain-singleton">11.2.4.4. Per Injection Chain Singleton</a></li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_validation-of-callsites-targeting-n4injector-methods">11.2.5. Validation of callsites targeting N4Injector methods</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-annotations">11.2.6. N4JS DI Annotations</a>
+<ul class="sectlevel4">
+<li><a href="extended_fetaures.html#_n4js-di-generateinjector">11.2.6.1. N4JS DI @GenerateInjector</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-withparentinjector">11.2.6.2. N4JS DI @WithParentInjector</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-usebinder">11.2.6.3. N4JS DI @UseBinder</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-binder">11.2.6.4. N4JS DI @Binder</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-bind">11.2.6.5. N4JS DI @Bind</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-provides">11.2.6.6. N4JS DI @Provides</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-inject">11.2.6.7. N4JS DI @Inject</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-singleton">11.2.6.8. N4JS DI @Singleton</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_test-support">11.3. Test Support</a></li>
+<li><a href="extended_fetaures.html#_polyfill-definitions">11.4. Polyfill Definitions</a>
+<ul class="sectlevel3">
+<li><a href="extended_fetaures.html#_runtime-polyfill-definitions">11.4.1. Runtime Polyfill Definitions</a></li>
+<li><a href="extended_fetaures.html#_static-polyfill-definitions">11.4.2. Static Polyfill Definitions</a></li>
+<li><a href="extended_fetaures.html#_transpiling-static-polyfilled-classes">11.4.3. Transpiling static polyfilled classes</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="components.html#_components">12. Components</a>
+<ul class="sectlevel2">
+<li><a href="components.html#_overview-2">12.1. Overview</a></li>
+<li><a href="components.html#Component_Types">12.2. Component Types</a>
+<ul class="sectlevel3">
+<li><a href="components.html#_libraries">12.2.1. Libraries</a></li>
+<li><a href="components.html#_runtime-environment-and-runtime-libraries">12.2.2. Runtime Environment and Runtime Libraries</a></li>
+<li><a href="components.html#_tests">12.2.3. Tests</a></li>
+<li><a href="components.html#_type-definitions">12.2.4. Type Definitions</a></li>
+</ul>
+</li>
+<li><a href="components.html#package-json">12.3. Package.json File</a>
+<ul class="sectlevel3">
+<li><a href="components.html#_basic-properties">12.3.1. Basic Properties</a></li>
+<li><a href="components.html#_n4js-properties">12.3.2. N4JS Properties</a></li>
+<li><a href="components.html#_constraints">12.3.3. Constraints</a></li>
+</ul>
+</li>
+<li><a href="components.html#_support-for-npm-scopes">12.4. Support for NPM Scopes</a></li>
+<li><a href="components.html#sec:N4JS-Type-Definitions">12.5. N4JS Type Definitions</a>
+<ul class="sectlevel3">
+<li><a href="components.html#_specify-type-definition">12.5.1. Specify Type Definition</a></li>
+<li><a href="components.html#_name-conventions">12.5.2. Name Conventions</a></li>
+<li><a href="components.html#_version-conventions">12.5.3. Version Conventions</a>
+<ul class="sectlevel4">
+<li><a href="components.html#_define-a-new-type-definition-package">12.5.3.1. Define a New Type Definition Package</a></li>
+<li><a href="components.html#_using-a-type-definition-package">12.5.3.2. Using a Type Definition Package</a></li>
+<li><a href="components.html#_rational">12.5.3.3. Rational</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="components.html#_modules">12.6. Modules</a></li>
+<li><a href="components.html#_api-and-implementation-component">12.7. API and Implementation Component</a>
+<ul class="sectlevel3">
+<li><a href="components.html#_execution-of-api-and-implementation-components">12.7.1. Execution of API and Implementation Components</a></li>
+<li><a href="components.html#_api-and-implementation-with-di">12.7.2. API and Implementation With DI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="plainjs.html#_plainjs">13. PlainJS</a>
+<ul class="sectlevel2">
+<li><a href="plainjs.html#_type-inference-and-validation-for-plain-js">13.1. Type Inference and Validation for Plain JS</a></li>
+<li><a href="plainjs.html#_external-declarations">13.2. External Declarations</a>
+<ul class="sectlevel3">
+<li><a href="plainjs.html#_declaring-externals">13.2.1. Declaring externals</a></li>
+<li><a href="plainjs.html#_instantiating-external-classes">13.2.2. Instantiating external classes</a></li>
+<li><a href="plainjs.html#_implementation-of-external-declarations">13.2.3. Implementation of External Declarations</a></li>
+<li><a href="plainjs.html#_example">13.2.4. Example</a></li>
+</ul>
+</li>
+<li><a href="plainjs.html#_global-definitions">13.3. Global Definitions</a></li>
+<li><a href="plainjs.html#_runtime-definitions">13.4. Runtime Definitions</a></li>
+<li><a href="plainjs.html#_applying-polyfills">13.5. Applying Polyfills</a></li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_jsdoc-2">14. JSDoc</a>
+<ul class="sectlevel2">
+<li><a href="jsdoc.html#_general-n4jsdoc-features">14.1. General N4JSDoc Features</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#_provided-inline-tags">14.1.1. Provided Inline Tags</a>
+<ul class="sectlevel4">
+<li><a href="jsdoc.html#jsdoc_tag__code">14.1.1.1. @code</a></li>
+<li><a href="jsdoc.html#jsdoc_tag__link">14.1.1.2. @link</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_n4jsdoc-for-user-projects">14.2. N4JSdoc for User Projects</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#_standard-tags">14.2.1. Standard Tags</a>
+<ul class="sectlevel4">
+<li><a href="jsdoc.html#_-author">14.2.1.1. @author</a></li>
+<li><a href="jsdoc.html#jsdoc_tag_param">14.2.1.2. @param</a></li>
+<li><a href="jsdoc.html#jsdoc_tag_return">14.2.1.3. @return</a></li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_test-related-tags">14.2.2. Test Related Tags</a>
+<ul class="sectlevel4">
+<li><a href="jsdoc.html#jsdoc_tag__testee">14.2.2.1. @testee</a></li>
+<li><a href="jsdoc.html#jsdoc_tag__testeeFromType">14.2.2.2. @testeeFromType</a></li>
+<li><a href="jsdoc.html#_testeeType_and__testeeMember">14.2.2.3. @testeeType and @testeeMember</a></li>
+<li><a href="jsdoc.html#jsdoc_tag_reqid_in_Tests">14.2.2.4. @reqid in Tests</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_n4jsdoc-for-api-and-implementation-projects">14.3. N4JSDoc for API and Implementation Projects</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#jsdoc_tag__apiNote">14.3.1. @apiNote</a></li>
+<li><a href="jsdoc.html#API_Project_Tags">14.3.2. API Project Tags</a>
+<ul class="sectlevel4">
+<li><a href="jsdoc.html#jsdoc_tag_apiState">14.3.2.1. @apiState</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsx.html#_jsx">15. JSX</a>
+<ul class="sectlevel2">
+<li><a href="jsx.html#_jsx-support">15.1. JSX Support</a></li>
+<li><a href="jsx.html#_jsx-backend">15.2. JSX Backend</a></li>
+</ul>
+</li>
+<li><a href="grammars.html#_grammars">16. Grammars</a>
+<ul class="sectlevel2">
+<li><a href="grammars.html#_type-expressions-grammar">16.1. Type Expressions Grammar</a></li>
+<li><a href="grammars.html#_n4js-language-grammar">16.2. N4JS Language Grammar</a></li>
+</ul>
+</li>
+<li><a href="jsobjects.html#_jsobjects">17. JSObjects</a>
+<ul class="sectlevel2">
+<li><a href="jsobjects.html#_object">17.1. Object</a></li>
+<li><a href="jsobjects.html#_string">17.2. String</a></li>
+<li><a href="jsobjects.html#_boolean">17.3. Boolean</a></li>
+<li><a href="jsobjects.html#_number">17.4. Number</a>
+<ul class="sectlevel3">
+<li><a href="jsobjects.html#_static-attributes">17.4.1. Static Attributes</a></li>
+</ul>
+</li>
+<li><a href="jsobjects.html#function">17.5. Function</a></li>
+<li><a href="jsobjects.html#_error">17.6. Error</a></li>
+<li><a href="jsobjects.html#_array">17.7. Array</a></li>
+<li><a href="jsobjects.html#_date">17.8. Date</a></li>
+<li><a href="jsobjects.html#_math">17.9. Math</a>
+<ul class="sectlevel3">
+<li><a href="jsobjects.html#static-attributes-1">17.9.1. Static Attributes</a></li>
+</ul>
+</li>
+<li><a href="jsobjects.html#_regexp">17.10. RegExp</a></li>
+<li><a href="jsobjects.html#_json">17.11. JSON</a></li>
+</ul>
+</li>
+<li><a href="n4js_objects.html#_n4js-objects">18. N4JS Objects</a>
+<ul class="sectlevel2">
+<li><a href="n4js_objects.html#_reflection-model">18.1. Reflection Model</a></li>
+<li><a href="n4js_objects.html#_error-types">18.2. Error Types</a>
+<ul class="sectlevel3">
+<li><a href="n4js_objects.html#_n4apinotimplemented">18.2.1. N4ApiNotImplemented</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_acronyms.html#_acronyms">Appendix A: Acronyms</a></li>
+<li><a href="appendix_b_license.html#sec:License">Appendix B: License</a></li>
+<li><a href="appendix_c_bibliography.html#_bibliography">Appendix C: Bibliography</a></li>
+</ul>
+</div>
+</div>
+<div id="content"><div class="sect1">
+<h2 id="_introduction"><a class="anchor" href="#_introduction"></a><a class="link" href="#_introduction">1. Introduction</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>This specification defines the N4JS language.</p>
+</div>
+<div class="paragraph">
+<p>In general, the N4JS JavaScript dialect used is identical to the standard ECMAScript as defined in the 6th edition of
+ECMA-262, also known as ECMAScript 2015, referred to as [<a href="appendix_c_bibliography.html#ECMA15a">ECMA15a</a>].</p>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="_notation"><a class="anchor" href="#_notation"></a><a class="link" href="#_notation">1.1. Notation</a></h3>
+<div class="sect3">
+<h4 id="_grammar-notation"><a class="anchor" href="#_grammar-notation"></a><a class="link" href="#_grammar-notation">1.1.1. Grammar Notation</a></h4>
+<div class="paragraph">
+<p>For the specification of the syntax and structure of elements, we use a
+slightly augmented similar to the grammar language of Xtext <a href="http://www.eclipse.org/Xtext/documentation/301_grammarlanguage.html">Grammar Language</a>.</p>
+</div>
+<div class="paragraph">
+<p>Similar to [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a</a>], we define types with properties only for the purpose of explanation and usage within this specification.
+We use the Xtext notation style to assign values to meta-properties.
+Particularly, we use the Xtext notation for collection (<code>+=</code>) and boolean (<code>?=</code>) values.
+These properties are written in italics. Enumerations are defined similar to Xtext.
+In order to allow the specification of default values, which are often defined by omitting the value, we always define the literal explicitly if it can be defined by the user.</p>
+</div>
+<div class="paragraph">
+<p>The following lists informally defines the grammar:</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Terminal</dt>
+<dd>
+<p>Terminals (or terminal strings) are enclosed in single quotes, e.g., <code>terminal</code>.</p>
+</dd>
+<dt class="hdlist1">Enumerations</dt>
+<dd>
+<p>Rules which contain only terminals used as values for properties are
+marked with <code>enum</code> for enumeration.</p>
+</dd>
+<dt class="hdlist1">Properties</dt>
+<dd>
+<p>Values of non-terminals, e.g., other rules, can be assigned to
+properties. The property name and the assignment are not part of the
+original syntax and only used for the meta description. E.g., <code><em>name=</em>Identifier</code>.</p>
+</dd>
+<dt class="hdlist1">Collection Properties</dt>
+<dd>
+<p>If a property is a collection, values are added to that list via <code>+=</code>.
+E.g.,<code><em>property+=</em>Value</code> .</p>
+</dd>
+<dt class="hdlist1">Boolean Properties</dt>
+<dd>
+<p>Boolean properties are set to false by default, if the value (usually
+a terminal) is found, the boolean value is set to true. Often, the
+name of the property is similar to the terminal. E.g., <code><em>final?</em>='final'?</code>.</p>
+</dd>
+</dl>
+</div>
+<div class="paragraph">
+<p>Properties of a non-terminal are sometimes listed again below the
+grammar. In that case, often pseudo properties are introduced which are
+derived from other properties and which are only used for
+simplification.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_type-judgments-and-rules-and-constraints-notation"><a class="anchor" href="#_type-judgments-and-rules-and-constraints-notation"></a><a class="link" href="#_type-judgments-and-rules-and-constraints-notation">1.1.2. Type Judgments and Rules and Constraints Notation</a></h4>
+<div class="sect4">
+<h5 id="_typing-rules-and-judgments"><a class="anchor" href="#_typing-rules-and-judgments"></a><a class="link" href="#_typing-rules-and-judgments">1.1.2.1. Typing Rules and Judgments</a></h5>
+<div class="openblock definition">
+<div class="content">
+<div class="paragraph">
+<p><a id="rule"></a><strong>Definition:</strong> <a href="#rule">Rule</a></p>
+</div>
+<div class="paragraph">
+<p>We use the common notation for rules such as type inference rules <sup class="footnote">[<a id="_footnoteref_1" class="footnote" href="appendix_c_bibliography.html#_footnote_1" title="View footnote.">1</a>]</sup>, that is</p>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><mi>p</mi><mi>r</mi><mi>e</mi><mi>m</mi><mi>i</mi><mi>s</mi><mi>e</mi><mi>s</mi></mrow><mrow><mi>c</mi><mi>o</mi><mi>n</mi><mi>c</mi><mi>l</mi><mi>u</mi><mi>s</mi><mi>i</mi><mi>o</mi><mi>n</mi></mrow></mfrac><mspace width="5.0mm"/><mstyle mathvariant="normal"><mtext>rule name</mtext></mstyle></math>
+</div>
+</div>
+<div class="paragraph">
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>p</mi><mi>r</mi><mi>e</mi><mi>m</mi><mi>i</mi><mi>s</mi><mi>e</mi><mi>s</mi></math> is the rule’s premises (e.g., the expression to be inferred), <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>c</mi><mi>o</mi><mi>n</mi><mi>c</mi><mi>l</mi><mi>u</mi><mi>s</mi><mi>i</mi><mi>o</mi><mi>n</mi></math> the result of the rule.
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>r</mi><mi>u</mi><mi>l</mi><mi>e</mi><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi></math> is an optional condition which may be omitted.</p>
+</div>
+<div class="paragraph">
+<p>Both parts of the rule may contain multiple expressions, which are concatenated via 'and'.</p>
+</div>
+<div class="paragraph">
+<p>For example, the following</p>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><msub><mi>P</mi><mn>1</mn></msub><mspace width="5.0mm"/><msub><mi>P</mi><mn>2</mn></msub><mspace width="5.0mm"/><msub><mi>P</mi><mn>3</mn></msub></mrow><mi>C</mi></mfrac></math>
+</div>
+</div>
+<div class="paragraph">
+<p>can be read as</p>
+</div>
+<div class="quoteblock">
+<blockquote>
+if <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>P</mi><mn>1</mn></msub></math>, <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>P</mi><mn>2</mn></msub></math>, <em>and</em> <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>P</mi><mn>3</mn></msub></math> are all true, then <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>C</mi></math> is true as well.
+</blockquote>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>The following judgments (with relation symbols) are used:</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">subtype <math xmlns="http://www.w3.org/1998/Math/MathML"><mo>&lt;</mo></math> </dt>
+<dd>
+<p>-</p>
+</dd>
+<dt class="hdlist1">type <math xmlns="http://www.w3.org/1998/Math/MathML"><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle></math> </dt>
+<dd>
+<p>in which the left hand side is a declaration or expression, and the right hand side a type.
+We also use <math xmlns="http://www.w3.org/1998/Math/MathML"><mrow><mo>[</mo><mspace width="-0.167em"/><mrow><mo>[</mo></mrow></mrow><mrow><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/></mrow><mrow><mrow><mo>]</mo></mrow><mspace width="-0.167em"/><mo>]</mo></mrow></math> as a function returning the (inferred) type of an expression.</p>
+</dd>
+<dt class="hdlist1">expectedTypeIn <math xmlns="http://www.w3.org/1998/Math/MathML"><mo>⊲</mo><mi>:</mi></math> </dt>
+<dd>
+<p>a relation with three arguments:
+  <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>c</mi><mi>o</mi><mi>n</mi><mi>t</mi><mi>a</mi><mi>i</mi><mi>n</mi><mi>e</mi><mi>r</mi><mo>⊲</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>e</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>o</mi><mi>n</mi><mi>:</mi><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi></math> means, that
+  <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>e</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>o</mi><mi>n</mi></math> is expected to be a subtype of
+  <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi></math> inside <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>c</mi><mi>o</mi><mi>n</mi><mi>t</mi><mi>a</mi><mi>i</mi><mi>n</mi><mi>e</mi><mi>r</mi></math></p>
+</dd>
+</dl>
+</div>
+<div class="paragraph">
+<p>The following statement, for example, defines transitivity of subtypes
+(in a simplified manner):</p>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><mi>Γ</mi><mo>⊢</mo><mi>B</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>A</mi><mspace width="5.0mm"/><mi>Γ</mi><mo>⊢</mo><mi>C</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>B</mi></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mi>C</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>A</mi></mrow></mfrac></math>
+</div>
+</div>
+<div class="paragraph">
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mo>⊢</mo></math> is the context containing (bound) type variables etc., <math xmlns="http://www.w3.org/1998/Math/MathML"><mo>⊢</mo></math> can be read as <code>entails</code>.
+Thus, the rule can be read as follows:</p>
+</div>
+<div class="quoteblock">
+<blockquote>
+if the type B is a subtype of type A in context <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>Γ</mi></math> (i.e. with constraints on type variables specified in <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>Γ</mi></math>), and if type C is a subtype of B, then C is also a subtype of A in context <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>Γ</mi></math>.
+</blockquote>
+</div>
+<div class="paragraph">
+<p>In rules, we sometimes omit the environment if it is not needed.
+New information is sometimes added to the environment, in particular, substitutions (that is binding type variables to a type).
+The set of substitutions is written with <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>θ</mi></math> (theta).
+If new substitutions are explicitly added to that set, we write <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>θ</mi><mfenced close=")" open="("><mrow><mi>V</mi><mo>←</mo><mi>T</mi></mrow></mfenced></math> (<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>V</mi></math> is substituted with type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi></math>).
+Often, these bindings are computed from a parameterized type reference which declares type arguments which are bound to the type variables of the generic declaration.
+In this case we simply write <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>θ</mi><mfenced close=")" open="("><mi>p</mi></mfenced></math>, in which <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>p</mi></math> is the parameterized type declaration.
+As these new substitutions must become part of a (newly) created environment, we then usually write <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>Γ</mi><mo>←</mo><mi>θ</mi><mfenced close=")" open="("><mi>p</mi></mfenced></math>.
+These substitutions are usually omitted.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_types-of-an-element"><a class="anchor" href="#_types-of-an-element"></a><a class="link" href="#_types-of-an-element">1.1.2.2. Types of an Element</a></h5>
+<div class="paragraph">
+<p>A variable or other typed element may be associated with three types:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Declared type: the type explicitly specified in the code, e.g., <code>var s: string</code>.</p>
+</li>
+<li>
+<p>Inferred type: the type inferred by the type inferencer, e.g., <code>var s = "Hello"</code> infers the type of s to <code>string</code>. I.e.
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>Γ</mi><mo>⊢</mo><mi>s</mi><mi>:</mi><mrow><mi>s</mi><mi>t</mi><mi>r</mi><mi>i</mi><mi>n</mi><mi>g</mi></mrow></math> will be true, or <math xmlns="http://www.w3.org/1998/Math/MathML"><mrow><mo>[</mo><mspace width="-0.167em"/><mrow><mo>[</mo></mrow></mrow><mi>s</mi><mrow><mrow><mo>]</mo></mrow><mspace width="-0.167em"/><mo>]</mo></mrow><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>s</mi><mi>t</mi><mi>r</mi><mi>i</mi><mi>n</mi><mi>g</mi></math>.
+If an element is annotated with a type ,i.e. it has a declared type, the inferred type will always be the declared type.</p>
+</li>
+<li>
+<p>Actual type: the actual type of a variable during runtime.
+This type information is not available at compile time and ignored in this specification.</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>These types are not type declarations but type references, in fact, as they may be parameterized.
+For the sake of simplicity, we often omit the <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>R</mi><mi>e</mi><mi>f</mi></math> suffix to shorten formulas.
+Consequently, we define the following properties and pseudo properties for typed elements such as variables:</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">declaredType<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>R</mi><mi>e</mi><mi>f</mi></math> </dt>
+<dd>
+<p>The explicitly declared type, this is usually a real property of the construct.
+Not all elements allow the specification of a declared type, such as expressions.</p>
+</dd>
+<dt class="hdlist1">inferredType<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>R</mi><mi>e</mi><mi>f</mi></math> or <math xmlns="http://www.w3.org/1998/Math/MathML"><mrow><mo>[</mo><mspace width="-0.167em"/><mrow><mo>[</mo></mrow></mrow><mrow><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/></mrow><mrow><mrow><mo>]</mo></mrow><mspace width="-0.167em"/><mo>]</mo></mrow></math></dt>
+<dd>
+<p>This pseudo property is the inferred type computed by the type inferencer.</p>
+</dd>
+<dt class="hdlist1">type<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>R</mi><mi>e</mi><mi>f</mi></math> </dt>
+<dd>
+<p>A pseudo property for elements with a <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>d</mi><mi>e</mi><mi>c</mi><mi>l</mi><mi>a</mi><mi>r</mi><mi>e</mi><mi>d</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi></math> property.
+It is similar to the inferred type, i.e. <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>e</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mo>=</mo><mrow><mo>[</mo><mspace width="-0.167em"/><mrow><mo>[</mo></mrow></mrow><mi>e</mi><mrow><mrow><mo>]</mo></mrow><mspace width="-0.167em"/><mo>]</mo></mrow></math></p>
+</dd>
+</dl>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="_auxiliary-functions"><a class="anchor" href="#_auxiliary-functions"></a><a class="link" href="#_auxiliary-functions">1.2. Auxiliary Functions</a></h3>
+<div class="paragraph">
+<p>This section describes some auxiliary functions required for definition of type inference rules later on.</p>
+</div>
+<div class="sect3">
+<h4 id="_binding"><a class="anchor" href="#_binding"></a><a class="link" href="#_binding">1.2.1. Binding</a></h4>
+<div class="paragraph">
+<p>Binding an identifier (variable reference) to a variable declaration (or
+variable definition) is not part of this specification as this is
+standard ECMAScript functionality. However, some valid ECMAScript
+bindings are permitted due to visibility constraints.</p>
+</div>
+<div class="openblock definition">
+<div class="content">
+<div class="paragraph">
+<p><a id="binding_relation"></a><strong>Definition:</strong> <a href="#binding_relation">Binding Relation</a></p>
+</div>
+<div class="paragraph">
+<p>We define a pseudo relation</p>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mi>b</mi><mi>i</mi><mi>n</mi><mi>d</mi><mi>:</mi><mi>V</mi><mi>a</mi><mi>r</mi><mi>i</mi><mi>a</mi><mi>b</mi><mi>l</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mi>e</mi><mi>r</mi><mi>e</mi><mi>n</mi><mi>c</mi><mi>e</mi><mo>×</mo><mi>V</mi><mi>a</mi><mi>r</mi><mi>i</mi><mi>a</mi><mi>b</mi><mi>l</mi><mi>e</mi><mi>D</mi><mi>e</mi><mi>c</mi><mi>l</mi><mi>a</mi><mi>r</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>o</mi><mi>n</mi></math>
+</div>
+</div>
+<div class="paragraph">
+<p>which binds a reference, i.e. an identifier, to a declaration (e.g.,variable declaration).</p>
+</div>
+<div class="paragraph">
+<p>Binding of variable references to declaration is defined by ECMAScript already.
+Type references only occur in type expressions, how these are handled is explained in <a href="types.html#_type-expressions">Type Expressions</a>.</p>
+</div>
+<div class="paragraph">
+<p>We usually omit this binding mechanism in most rules and use the reference similarly to the declaration or definition it is bound to.
+If a variable reference <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>r</mi></math>, for example, is bound to a variable declaration <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>D</mi></math>, i.e. <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>b</mi><mi>i</mi><mi>n</mi><mi>d</mi><mfenced close=")" open="("><mi>r</mi><mi>D</mi></mfenced></math>, we simply write <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>r</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi></math> instead of <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>b</mi><mi>i</mi><mi>n</mi><mi>d</mi><mfenced close=")" open="("><mi>r</mi><mi>D</mi></mfenced><mo>,</mo><mi>D</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi></math> to refer to the type expression
+(of the variable).<sup class="footnote">[<a id="_footnoteref_2" class="footnote" href="appendix_c_bibliography.html#_footnote_2" title="View footnote.">2</a>]</sup></p>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>A <code>DeclaredType</code> references the type declaration by its simple name that has been imported from a module specifier.
+We define the method <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>b</mi><mi>i</mi><mi>n</mi><mi>d</mi></math> for declared types as well:</p>
+</div>
+<div class="openblock definition">
+<div class="content">
+<div class="paragraph">
+<p><a id="binding_relation_of_types"></a><strong>Definition:</strong> <a href="#binding_relation_of_types">Binding Relation of Types</a></p>
+</div>
+<div class="paragraph">
+<p>We define a pseudo relation</p>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mi>b</mi><mi>i</mi><mi>n</mi><mi>d</mi><mi>:</mi><mi>D</mi><mi>e</mi><mi>c</mi><mi>l</mi><mi>a</mi><mi>r</mi><mi>e</mi><mi>d</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi><mo>×</mo><mi>C</mi><mi>l</mi><mi>a</mi><mi>s</mi><mi>s</mi><mo>|</mo><mi>I</mi><mi>n</mi><mi>t</mi><mi>e</mi><mi>r</mi><mi>f</mi><mi>a</mi><mi>c</mi><mi>e</mi><mo>|</mo><mi>E</mi><mi>n</mi><mi>u</mi><mi>m</mi></math>
+</div>
+</div>
+<div class="paragraph">
+<p>which binds a type reference, i.e. a simple name, to the type declaration.</p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_merging-types"><a class="anchor" href="#_merging-types"></a><a class="link" href="#_merging-types">1.2.2. Merging Types</a></h4>
+<div class="paragraph">
+<p>In some cases we have to merge types, e.g., types of a union type or item types of an array.
+For that purpose, we define a method <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>m</mi><mi>e</mi><mi>r</mi><mi>g</mi><mi>e</mi></math> as follows.</p>
+</div>
+<div class="openblock definition">
+<div class="content">
+<div class="paragraph">
+<p><a id="merge_function"></a><strong>Definition:</strong> <a href="#merge_function">Merge Function</a></p>
+</div>
+<div class="paragraph">
+<p>We define a pseudo function</p>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mi>m</mi><mi>e</mi><mi>r</mi><mi>g</mi><mi>e</mi><mi>:</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi><mo>×</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>×</mo><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi><mo>⇒</mo><mi mathvariant="script">P</mi><mfenced close=")" open="("><mrow><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi></mrow></mfenced></math>
+</div>
+</div>
+<div class="paragraph">
+<p>The idea of this function is to remove duplicates.
+For example; if a union type contains two type expressions <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>t</mi><msub><mi>e</mi><mn>1</mn></msub></math> and <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>t</mi><msub><mi>e</mi><mi>k</mi></msub></math>, and if <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>τ</mi><mfenced close=")" open="("><mrow><mi>t</mi><msub><mi>e</mi><mn>1</mn></msub></mrow></mfenced><mo>=</mo><mi>τ</mi><mfenced close=")" open="("><mrow><mi>t</mi><msub><mi>e</mi><mn>2</mn></msub></mrow></mfenced></math>, then <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>m</mi><mi>e</mi><mi>r</mi><mi>g</mi><mi>e</mi><mfenced close=")" open="("><mrow><mi>τ</mi><mfenced close=")" open="("><mrow><mi>t</mi><msub><mi>e</mi><mn>1</mn></msub></mrow></mfenced></mrow><mrow><mi>τ</mi><mfenced close=")" open="("><mrow><mi>t</mi><msub><mi>e</mi><mn>2</mn></msub></mrow></mfenced></mrow></mfenced></math> contains only one element.
+The order of the elements is lost, however.</p>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_logic-formulas"><a class="anchor" href="#_logic-formulas"></a><a class="link" href="#_logic-formulas">1.2.2.1. Logic Formulas</a></h5>
+<div class="paragraph">
+<p>In general, we use a pragmatic mixture of pseudo code, predicate logic, and OCL.
+Within constraints (also within the inference rules), the properties defined in the grammar are used.</p>
+</div>
+<div class="paragraph">
+<p>In some rules, it is necessary to type the rule variables.
+Instead of explicitly checking the metatype (via <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>μ</mi><mfenced close=")" open="("><mi>X</mi></mfenced><mo>=</mo><mi>:</mi><mrow><mi>M</mi><mi>e</mi><mi>t</mi><mi>a</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi></mrow></math>), we precede the variable with the type, that is: <math xmlns="http://www.w3.org/1998/Math/MathML"><mrow><mi>M</mi><mi>e</mi><mi>t</mi><mi>a</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi></mrow><mi>X</mi></math>.</p>
+</div>
+<div class="paragraph">
+<p>Instead of "type casting" elements, often properties are simply accessed.
+If an element does not define that element, it is either assumed to be false or null by default.</p>
+</div>
+<div class="paragraph">
+<p>If a property <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>p</mi></math> is optional and not set, we write <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>p</mi><mo>=</mo><mi>n</mi><mi>u</mi><mi>l</mi><mi>l</mi></math> to test its absence.
+Note that <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>p</mi><mo>=</mo><mi>n</mi><mi>u</mi><mi>l</mi><mi>l</mi></math> is different from <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>p</mi><mo>=</mo><mi>N</mi><mi>u</mi><mi>l</mi><mi>l</mi></math>, as the latter refers to the null type.
+Non-terminals may implicitly be subclasses.
+In that case, the concrete non-terminal, or type, of a property may be subject for a test in a constraint.</p>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_symbols-and-font-convention"><a class="anchor" href="#_symbols-and-font-convention"></a><a class="link" href="#_symbols-and-font-convention">1.2.3. Symbols and Font Convention</a></h4>
+<div class="paragraph">
+<p>Variables and their properties are printed in italic when used in formulas (such as rules).
+A dot-notation is used for member access, e.g. <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>v</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi></math>.
+Also defined functions are printed in italic, e.g., <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>a</mi><mi>c</mi><mi>c</mi><mfenced close=")" open="("><mi>r</mi><mi>D</mi></mfenced></math>.
+Properties which define sets are usually ordered and we assume 0-indexed access to elements, the index subscripted, e.g., <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>v</mi><mo>.</mo><mi>m</mi><mi>e</mi><mi>t</mi><mi>h</mi><mi>o</mi><mi>d</mi><msub><mi>s</mi><mi>i</mi></msub></math>.</p>
+</div>
+<div class="paragraph">
+<p>We use the following symbols and font conventions:</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∧</mo></math>, <math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∨</mo></math>, <math xmlns="http://www.w3.org/1998/Math/MathML"><mo>⊕</mo></math>, <math xmlns="http://www.w3.org/1998/Math/MathML"><mo>¬</mo></math></dt>
+<dd>
+<p>Logical and, or, exclusive or (xor), and not.</p>
+</dd>
+<dt class="hdlist1"><math xmlns="http://www.w3.org/1998/Math/MathML"><mo>⇒</mo></math>, <math xmlns="http://www.w3.org/1998/Math/MathML"><mo>⇔</mo></math>, <math xmlns="http://www.w3.org/1998/Math/MathML"><mstyle mathvariant="bold"><mtext>if</mtext></mstyle><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/></math>, <math xmlns="http://www.w3.org/1998/Math/MathML"><mstyle mathvariant="bold"><mtext>then</mtext></mstyle><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/></math>, <math xmlns="http://www.w3.org/1998/Math/MathML"><mstyle mathvariant="bold"><mtext>else</mtext></mstyle><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/></math> </dt>
+<dd>
+<p>Logical implication, if and only if, and if-then-else.</p>
+</dd>
+<dt class="hdlist1"><math xmlns="http://www.w3.org/1998/Math/MathML"><mstyle mathvariant="monospace"><mtext>true</mtext></mstyle></math>, <math xmlns="http://www.w3.org/1998/Math/MathML"><mstyle mathvariant="monospace"><mtext>false</mtext></mstyle></math>, <math xmlns="http://www.w3.org/1998/Math/MathML"><mstyle mathvariant="monospace"><mtext>null</mtext></mstyle></math>, <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>∅</mi></math></dt>
+<dd>
+<p>Boolean true, boolean false, null (i.e., not specified, e.g.,
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>v</mi><mo>.</mo><mi>s</mi><mi>u</mi><mi>p</mi><mo>=</mo></math> means that there are is no <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>s</mi><mi>u</mi><mi>p</mi></math>
+(super class) specified), empty set.</p>
+</dd>
+<dt class="hdlist1"><math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∈</mo></math>, <math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∉</mo></math>, <math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∪</mo></math>, <math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∩</mo></math>, <math xmlns="http://www.w3.org/1998/Math/MathML"><mo>|</mo><mi>x</mi><mo>|</mo></math></dt>
+<dd>
+<p>Element of, not an element of, union set, intersection set,
+cardinality of set x.</p>
+</dd>
+<dt class="hdlist1"><math xmlns="http://www.w3.org/1998/Math/MathML"><mi mathvariant="script">P</mi><mfenced close=")" open="("><mi>X</mi></mfenced></math></dt>
+<dd>
+<p>Power set of <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>X</mi></math>, i.e.
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi mathvariant="script">P</mi><mfenced close=")" open="("><mi>X</mi></mfenced><mo>=</mo><mfenced close="}" open="{"><mrow><mi>U</mi><mi>:</mi><mi>U</mi><mo>⊆</mo><mi>X</mi></mrow></mfenced></math>.</p>
+</dd>
+<dt class="hdlist1"><math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∃</mo></math>, <math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∄</mo></math>, <math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∀</mo></math></dt>
+<dd>
+<p>Exists, not exists, for all; we write <math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∃</mo><mi>x</mi><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><mi>z</mi><mi>:</mi><mi>P</mi><mfenced close=")" open="("><mi>x</mi><mrow><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/></mrow><mi>z</mi></mfenced></math> and say</p>
+<div class="quoteblock">
+<blockquote>
+"there exists <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>x</mi><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><mi>z</mi></math> such that predicate <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>P</mi></math> is true".
+</blockquote>
+</div>
+<div class="paragraph">
+<p>Note that <math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∄</mo><mi>x</mi><mi>:</mi><mi>P</mi><mfenced close=")" open="("><mi>x</mi></mfenced><mo>⇔</mo><mo>∀</mo><mi>x</mi><mi>:</mi><mo>¬</mo><mi>P</mi><mfenced close=")" open="("><mi>x</mi></mfenced></math>.</p>
+</div>
+</dd>
+<dt class="hdlist1"><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>μ</mi><mfenced close=")" open="("><mrow><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/></mrow></mfenced></math></dt>
+<dd>
+<p>(mu) read "<strong>metatype of</strong>"; metatype of a variable or property, e.g.,</p>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mstyle mathvariant="bold"><mtext>if</mtext></mstyle><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mi>μ</mi><mfenced close=")" open="("><mi>x</mi></mfenced><mo>=</mo><mi>:</mi><mrow><mi>C</mi><mi>l</mi><mi>a</mi><mi>s</mi><mi>s</mi></mrow><mstyle mathvariant="bold"><mtext>then</mtext></mstyle><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mstyle mathvariant="bold"><mtext>else</mtext></mstyle><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/></math>
+</div>
+</div>
+</dd>
+<dt class="hdlist1"><math xmlns="http://www.w3.org/1998/Math/MathML"><mover accent="true"><mi>x</mi><mo>¯</mo></mover></math></dt>
+<dd>
+<p>Sequence of elements <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>x</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>x</mi><mi>n</mi></msub></math>. E.g., if we want to
+define a constraint that the owner of a members of a class
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>C</mi></math> is the class, we simply write</p>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mi>C</mi><mo>.</mo><mover accent="true"><mrow><mi>m</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi><mi>s</mi></mrow><mo>¯</mo></mover><mo>.</mo><mi>o</mi><mi>w</mi><mi>n</mi><mi>e</mi><mi>r</mi><mo>=</mo><mi>C</mi></math>
+</div>
+</div>
+<div class="paragraph">
+<p>instead of</p>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mo>∀</mo><mi>m</mi><mo>∈</mo><mi>C</mi><mo>.</mo><mi>m</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi><mi>s</mi><mi>:</mi><mi>m</mi><mo>.</mo><mi>o</mi><mi>w</mi><mi>n</mi><mi>e</mi><mi>r</mi><mo>=</mo><mi>C</mi></math>
+</div>
+</div>
+<div class="paragraph">
+<p>or even more complicated with index variables.</p>
+</div>
+</dd>
+</dl>
+</div>
+<div class="paragraph">
+<p>Sequences are 1-based, e.g., a sequence <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>s</mi></math> with length <math xmlns="http://www.w3.org/1998/Math/MathML"><mo>|</mo><mi>s</mi><mo>|</mo><mo>=</mo><mi>n</mi></math>, has elements <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>s</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>s</mi><mi>n</mi></msub></math>.</p>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div id="footer">
+<div id="footer-text">
+Version 0.9<br>
+Last updated 2019-08-07 15:02:40 CEST
+</div>
+</div>
+<!-- ************* docinfo-footer *************************************************************** -->
+<div class="Grid social" style="color:#d5dfea">
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <h2>Quick Links</h2>
+    <ul>
+      <li><a href="../downloads.html">Download</a></li>
+      <li><a href="../userguides/index.html">Documentation</a></li>
+      <li><a href="https://github.com/eclipse/n4js/">Source</a></li>
+      <li><a href="https://github.com/eclipse/n4js/issues">Issues</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="https://www.eclipse.org/forums/index.php/f/365/">Forum</a></li>
+      <li><a href="http://n4js.blogspot.de/">Blog</a></li>
+      <li><a href="https://dev.eclipse.org/mailman/listinfo/n4js-dev">Mailing List</a></li>
+      <li><a href="https://projects.eclipse.org/projects/technology.n4js">Eclipse Project Page</a></li>
+      <li><a href="https://twitter.com/n4jsdev">Tweets by n4jsdev</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="http://www.eclipse.org/">Eclipse Home</a></li>
+      <li><a href="http://www.eclipse.org/legal/privacy.php">Privacy Policy</a></li>
+      <li><a href="http://www.eclipse.org/legal/termsofuse.php">Terms of Use</a></li>
+      <li><a href="http://www.eclipse.org/legal/copyright.php">Copyright Agent</a></li>
+      <li><a href="http://www.eclipse.org/legal/">Legal</a></li>
+    </ul>
+  </div>
+  <div style="clear: both; height: 0; overflow: hidden;"></div>
+</div>
+
+<!-- ************* UI Scripts ************* -->
+<script type="text/javascript" src="scripts/back-to-top.js"></script>
+
+<script type="text/javascript" src="scripts/treeview.js"></script>
+<script type="text/javascript" src="scripts/toc.js"></script>
+
+<!-- ************* Prism.js Syntax Highlighting ************* -->
+<script src="scripts/prism.js"></script>
+
+<script type="text/javascript">
+	// Add the 'toclist' id for search function
+	$(".toc2 > ul").attr('id', 'toclist');
+	// Generate a Search input form
+	$("#toclist > li:first-of-type").before('<input type="text" id="pagesearch" onkeyup="search()" placeholder="Search for section...">');
+	$("#toclist > li:first-of-type").before('<i id="clear" class="fa fa-times-circle-o"></i>');
+	$("#clear").click(function(){
+	    $("#pagesearch").val('');
+	    search();
+	    $('.toc2 > ul').treeView('collapseAll');
+	});
+	// intialize Treeview.js
+	$(".toc2 > ul").treeView();
+	// Initialize Scrollspy
+</script>
+<!-- ************* docinfo-footer *************************************************************** -->
+</body>
+</html>
\ No newline at end of file
diff --git a/spec/jsdoc.html b/spec/jsdoc.html
new file mode 100644
index 0000000..5ac5b9d
--- /dev/null
+++ b/spec/jsdoc.html
@@ -0,0 +1,1285 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="generator" content="Asciidoctor 1.5.5">
+<meta name="author" content="2019-08-07 15:02:40 CEST">
+<title>N4JS Language Specification</title>
+<link rel="stylesheet" href="styles/spec.min.css">
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.6.3/css/font-awesome.min.css">
+<!-- ************* docinfo ******************************************************************* -->
+
+
+<!-- ************* Favicon ************-->
+<link rel="icon" href="images/favicon.ico" />
+
+<!-- ************* Back-to-top JQuery ************* -->
+<script src="https://code.jquery.com/jquery-1.12.4.js"></script>
+<script src="https://code.jquery.com/ui/1.12.0/jquery-ui.js"></script>
+
+
+<link href="styles/prism.min.css" rel="stylesheet" />
+<script type="text/javascript" async
+  src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2/MathJax.js?config=TeX-MML-AM_CHTML">
+</script>
+
+<!-- ************* Styles ************* -->
+<link rel="stylesheet" type="text/css" href="styles/n4jsspec-adoc.css">
+
+
+<!-- ****************** NavBar ****************** -->
+<div id="menubar">
+	<div class="banner">
+        <a href="https://www.eclipse.org/n4js/#"><img id="logo" src="images/n4js-logo.png" alt="Eclipse N4JS"></a>
+    </div>
+<ul>
+  <li><a href="index.html">Index</a></li>
+</ul>
+</div>
+<!-- ************* docinfo ******************************************************************* -->
+<style>
+      .admonitionblock td.icon .icon-todo:before{content:"\f249";color:#f4ee42}
+    </style>
+</head>
+<body class="book toc2 toc-left">
+<div id="header">
+<h1>N4JS Language Specification</h1>
+<div class="details">
+<span id="author" class="author">2019-08-07 15:02:40 CEST</span><br>
+<span id="revnumber">version 0.9</span>
+</div>
+<div id="toc" class="toc2">
+<div id="toctitle">Table of Contents</div>
+<ul class="sectlevel1">
+<li><a href="introduction.html#_introduction">1. Introduction</a>
+<ul class="sectlevel2">
+<li><a href="introduction.html#_notation">1.1. Notation</a>
+<ul class="sectlevel3">
+<li><a href="introduction.html#_grammar-notation">1.1.1. Grammar Notation</a></li>
+<li><a href="introduction.html#_type-judgments-and-rules-and-constraints-notation">1.1.2. Type Judgments and Rules and Constraints Notation</a>
+<ul class="sectlevel4">
+<li><a href="introduction.html#_typing-rules-and-judgments">1.1.2.1. Typing Rules and Judgments</a></li>
+<li><a href="introduction.html#_types-of-an-element">1.1.2.2. Types of an Element</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="introduction.html#_auxiliary-functions">1.2. Auxiliary Functions</a>
+<ul class="sectlevel3">
+<li><a href="introduction.html#_binding">1.2.1. Binding</a></li>
+<li><a href="introduction.html#_merging-types">1.2.2. Merging Types</a>
+<ul class="sectlevel4">
+<li><a href="introduction.html#_logic-formulas">1.2.2.1. Logic Formulas</a></li>
+</ul>
+</li>
+<li><a href="introduction.html#_symbols-and-font-convention">1.2.3. Symbols and Font Convention</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="grammar.html#_grammar">2. Grammar</a>
+<ul class="sectlevel2">
+<li><a href="grammar.html#_lexical-conventions">2.1. Lexical Conventions</a>
+<ul class="sectlevel3">
+<li><a href="grammar.html#_identifier-names-and-identifiers">2.1.1. Identifier Names and Identifiers</a></li>
+<li><a href="grammar.html#_this-keyword">2.1.2. This Keyword</a></li>
+<li><a href="grammar.html#_regular-expression-literals">2.1.3. Regular Expression Literals</a></li>
+<li><a href="grammar.html#_automatic-semicolon-insertion">2.1.4. Automatic Semicolon Insertion</a></li>
+<li><a href="grammar.html#_jsdoc">2.1.5. JSDoc</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="names.html#_names">3. Names</a>
+<ul class="sectlevel2">
+<li><a href="names.html#_access-control">3.1. Access Control</a></li>
+<li><a href="names.html#_accessibility-of-types-top-level-variables-and-function-declarations">3.2. Accessibility of Types, Top-Level Variables and Function Declarations</a>
+<ul class="sectlevel3">
+<li><a href="names.html#_accessibility-of-members">3.2.1. Accessibility of Members</a></li>
+<li><a href="names.html#_valid-names">3.2.2. Valid Names</a></li>
+<li><a href="names.html#_qualified-names">3.2.3. Qualified Names</a></li>
+<li><a href="names.html#_name-duplicates">3.2.4. Name Duplicates</a>
+<ul class="sectlevel4">
+<li><a href="names.html#_lexical-environment">3.2.4.1. Lexical Environment</a></li>
+<li><a href="names.html#_duplicates-and-shadowing">3.2.4.2. Duplicates and Shadowing</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="types.html#_types">4. Types</a>
+<ul class="sectlevel2">
+<li><a href="types.html#_overview">4.1. Overview</a></li>
+<li><a href="types.html#_type-expressions">4.2. Type Expressions</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_syntax">4.2.1. Syntax</a></li>
+<li><a href="types.html#_properties">4.2.2. Properties</a></li>
+<li><a href="types.html#_semantics">4.2.3. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_type-inference">4.3. Type Inference</a></li>
+<li><a href="types.html#_generic-and-parameterized-types">4.4. Generic and Parameterized Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_generic-types">4.4.1. Generic Types</a></li>
+<li><a href="types.html#_type-variables">4.4.2. Type Variables</a></li>
+<li><a href="types.html#_parameterized-types">4.4.3. Parameterized Types</a></li>
+</ul>
+</li>
+<li><a href="types.html#_primitive-ecmascript-types">4.5. Primitive ECMAScript Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_undefined-type">4.5.1. Undefined Type</a></li>
+<li><a href="types.html#_null-type">4.5.2. Null Type</a></li>
+<li><a href="types.html#_primitive-boolean-type">4.5.3. Primitive Boolean Type</a></li>
+<li><a href="types.html#_primitive-string-type">4.5.4. Primitive String Type</a></li>
+<li><a href="types.html#_primitive-number-type">4.5.5. Primitive Number Type</a></li>
+<li><a href="types.html#_primitive-type-int">4.5.6. Primitive Type int</a></li>
+<li><a href="types.html#_primitive-symbol-type">4.5.7. Primitive Symbol Type</a></li>
+</ul>
+</li>
+<li><a href="types.html#_primitive-n4js-types">4.6. Primitive N4JS Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_any-type">4.6.1. Any Type</a>
+<ul class="sectlevel4">
+<li><a href="types.html#any-type-semantics">4.6.1.1. Semantics</a></li>
+<li><a href="types.html#any-type-type-inference">4.6.1.2. Type Inference</a>
+<ul class="sectlevel5">
+<li><a href="types.html#_default-type-of-variables">4.6.1.2.1. Default Type of Variables</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="types.html#_void-type">4.6.2. Void Type</a>
+<ul class="sectlevel4">
+<li><a href="types.html#void-type-semantics">4.6.2.1. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_unknown-type">4.6.3. Unknown Type</a></li>
+<li><a href="types.html#_primitive-pathselector-and-i18nkey">4.6.4. Primitive Pathselector and I18nKey</a>
+<ul class="sectlevel4">
+<li><a href="types.html#pathselector-semantics">4.6.4.1. Semantics</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="types.html#_built-in-ecmascript-object-types">4.7. Built-in ECMAScript Object Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#ECMAScript-objects-semantics">4.7.1. Semantics</a></li>
+<li><a href="types.html#_object-type">4.7.2. Object Type</a></li>
+<li><a href="types.html#_function-object-type">4.7.3. Function-Object-Type</a></li>
+<li><a href="types.html#_array-object-type">4.7.4. Array Object Type</a></li>
+<li><a href="types.html#_string-object-type">4.7.5. String Object Type</a></li>
+<li><a href="types.html#_boolean-object-type">4.7.6. Boolean Object Type</a></li>
+<li><a href="types.html#_number-object-type">4.7.7. Number Object Type</a></li>
+<li><a href="types.html#_global-object-type">4.7.8. Global Object Type</a></li>
+<li><a href="types.html#_symbol">4.7.9. Symbol</a></li>
+<li><a href="types.html#_promise">4.7.10. Promise</a></li>
+<li><a href="types.html#_iterator-interface">4.7.11. Iterator Interface</a></li>
+<li><a href="types.html#_iterable-interface">4.7.12. Iterable Interface</a></li>
+</ul>
+</li>
+<li><a href="types.html#_built-in-n4js-types">4.8. Built-In N4JS Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_n4object">4.8.1. N4Object</a>
+<ul class="sectlevel4">
+<li><a href="types.html#N4Object-semantics">4.8.1.1. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_n4class">4.8.2. N4Class</a></li>
+<li><a href="types.html#IterableN">4.8.3. IterableN</a></li>
+</ul>
+</li>
+<li><a href="types.html#_type-modifiers">4.9. Type Modifiers</a>
+<ul class="sectlevel3">
+<li><a href="types.html#Type_Modifiers_Dynamic">4.9.1. Dynamic</a></li>
+<li><a href="types.html#_optional-return-types">4.9.2. Optional Return Types</a></li>
+</ul>
+</li>
+<li><a href="types.html#_union-and-intersection-type-composed-types">4.10. Union and Intersection Type (Composed Types)</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_union-type">4.10.1. Union Type</a>
+<ul class="sectlevel4">
+<li><a href="types.html#union-type-syntax">4.10.1.1. Syntax</a></li>
+<li><a href="types.html#union-type-semantics">4.10.1.2. Semantics</a></li>
+<li><a href="types.html#_warnings">4.10.1.3. Warnings</a></li>
+</ul>
+</li>
+<li><a href="types.html#_intersection-type">4.10.2. Intersection Type</a>
+<ul class="sectlevel4">
+<li><a href="types.html#intersection-type-syntax">4.10.2.1. Syntax</a></li>
+<li><a href="types.html#intersection-type-semantics">4.10.2.2. Semantics</a></li>
+<li><a href="types.html#_warnings-2">4.10.2.3. Warnings</a></li>
+</ul>
+</li>
+<li><a href="types.html#_composed-types-in-wildcards">4.10.3. Composed Types in Wildcards</a></li>
+<li><a href="types.html#_property-access-for-composed-types">4.10.4. Property Access for Composed Types</a>
+<ul class="sectlevel4">
+<li><a href="types.html#_properties-of-union-type">4.10.4.1. Properties of Union Type</a>
+<ul class="sectlevel5">
+<li><a href="types.html#_remarks-on-union-type-s-members">4.10.4.1.1. Remarks on union type’s members:</a></li>
+</ul>
+</li>
+<li><a href="types.html#_properties-of-intersection-type">4.10.4.2. Properties of Intersection Type</a>
+<ul class="sectlevel5">
+<li><a href="types.html#_remarks-on-intersection-type-s-methods">4.10.4.2.1. Remarks on intersection type’s methods:</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="types.html#_constructor-and-classifier-type">4.11. Constructor and Classifier Type</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_syntax-3">4.11.1. Syntax</a></li>
+<li><a href="types.html#_semantics-2">4.11.2. Semantics</a></li>
+<li><a href="types.html#_constructors-and-prototypes-in-ecmascript-2015">4.11.3. Constructors and Prototypes in ECMAScript 2015</a></li>
+</ul>
+</li>
+<li><a href="types.html#_this-type">4.12. This Type</a>
+<ul class="sectlevel3">
+<li><a href="types.html#this-type-syntax">4.12.1. Syntax</a></li>
+<li><a href="types.html#this-keyword-semantics">4.12.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_enums">4.13. Enums</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_enums-n4js">4.13.1. Enums (N4JS)</a>
+<ul class="sectlevel4">
+<li><a href="types.html#enums-syntax">4.13.1.1. Syntax</a></li>
+<li><a href="types.html#enums-semantics">4.13.1.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_string-based-enums">4.13.2. String-Based Enums</a></li>
+</ul>
+</li>
+<li><a href="types.html#_short-hand-syntax">4.14. Short-Hand Syntax</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_array-short-hand-syntax">4.14.1. Array Short-Hand Syntax</a></li>
+<li><a href="types.html#_iterablen-short-hand-syntax">4.14.2. IterableN Short-Hand Syntax</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="classifiers.html#_classifiers">5. Classifiers</a>
+<ul class="sectlevel2">
+<li><a href="classifiers.html#_n4js-specific-classifiers">5.1. N4JS Specific Classifiers</a>
+<ul class="sectlevel3">
+<li><a href="classifiers.html#_properties-2">5.1.1. Properties</a></li>
+<li><a href="classifiers.html#_common-semantics-of-classifiers">5.1.2. Common Semantics of Classifiers</a></li>
+<li><a href="classifiers.html#_classes">5.1.3. Classes</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_definition-of-classes">5.1.3.1. Definition of Classes</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#class-syntax">5.1.3.1.1. Syntax</a></li>
+<li><a href="classifiers.html#class-properties">5.1.3.1.2. Properties</a></li>
+<li><a href="classifiers.html#class-type-inference">5.1.3.1.3. Type Inference</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#class-semantics">5.1.3.2. Semantics</a></li>
+<li><a href="classifiers.html#_final-modifier">5.1.3.3. Final Modifier</a></li>
+<li><a href="classifiers.html#_abstract-classes">5.1.3.4. Abstract Classes</a></li>
+<li><a href="classifiers.html#_non-instantiable-classes">5.1.3.5. Non-Instantiable Classes</a></li>
+<li><a href="classifiers.html#_superclass">5.1.3.6. Superclass</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_interfaces">5.1.4. Interfaces</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_definition-of-interfaces">5.1.4.1. Definition of Interfaces</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#interfaces-syntax">5.1.4.1.1. Syntax</a></li>
+<li><a href="classifiers.html#interfaces-properties">5.1.4.1.2. Properties</a></li>
+<li><a href="classifiers.html#interfaces-type-inference">5.1.4.1.3. Type Inference</a></li>
+<li><a href="classifiers.html#interfaces-semantics">5.1.4.1.4. Semantics</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="classifiers.html#_generic-classifiers">5.1.5. Generic Classifiers</a></li>
+<li><a href="classifiers.html#sec:definition-site-variance">5.1.6. Definition-Site Variance</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_members">5.2. Members</a>
+<ul class="sectlevel3">
+<li><a href="classifiers.html#_syntax-4">5.2.1. Syntax</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_properties-3">5.2.1.1. Properties</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_semantics-3">5.2.2. Semantics</a></li>
+<li><a href="classifiers.html#_methods">5.2.3. Methods</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_syntax-5">5.2.3.1. Syntax</a></li>
+<li><a href="classifiers.html#_properties-4">5.2.3.2. Properties</a></li>
+<li><a href="classifiers.html#_semantics-4">5.2.3.3. Semantics</a></li>
+<li><a href="classifiers.html#_final-methods">5.2.3.4. Final Methods</a></li>
+<li><a href="classifiers.html#_abstract-methods">5.2.3.5. Abstract Methods</a></li>
+<li><a href="classifiers.html#_generic-methods">5.2.3.6. Generic Methods</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_default-methods-in-interfaces">5.2.4. Default Methods in Interfaces</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_asynchronous-methods">5.2.4.1. Asynchronous Methods</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_constructors">5.2.5. Constructors</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_structural-this-type-in-constructor">5.2.5.1. Structural This Type in Constructor</a></li>
+<li><a href="classifiers.html#spec-constructor">5.2.5.2. @Spec Constructor</a></li>
+<li><a href="classifiers.html#_callable-constructors">5.2.5.3. Callable Constructors</a></li>
+<li><a href="classifiers.html#_covariant-constructors">5.2.5.4. Covariant Constructors</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_data-fields">5.2.6. Data Fields</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#data-fields-syntax">5.2.6.1. Syntax</a></li>
+<li><a href="classifiers.html#data-fields-properties">5.2.6.2. Properties</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#data-fields-semantics">5.2.6.2.1. Semantics</a></li>
+<li><a href="classifiers.html#data-fields-type-inference">5.2.6.2.2. Type Inference</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_assignment-modifiers">5.2.6.3. Assignment Modifiers</a></li>
+<li><a href="classifiers.html#_field-accessors-getter-setter">5.2.6.4. Field Accessors (Getter/Setter)</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#field-acessors-syntax">5.2.6.4.1. Syntax</a></li>
+<li><a href="classifiers.html#field-acessors-properties">5.2.6.4.2. Properties</a></li>
+<li><a href="classifiers.html#field-accessors-semantics">5.2.6.4.3. Semantics</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#optional-fields">5.2.6.5. Optional Fields</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#_syntax-6">5.2.6.5.1. Syntax</a></li>
+<li><a href="classifiers.html#_semantics-5">5.2.6.5.2. Semantics</a></li>
+<li><a href="classifiers.html#_background">5.2.6.5.3. Background</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="classifiers.html#_static-members">5.2.7. Static Members</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_access-from-and-to-static-members">5.2.7.1. Access From and To Static Members</a></li>
+<li><a href="classifiers.html#_generic-static-methods">5.2.7.2. Generic static methods</a></li>
+<li><a href="classifiers.html#_static-members-of-interfaces">5.2.7.3. Static Members of Interfaces</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_redefinition-of-members">5.2.8. Redefinition of Members</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_overriding-of-members">5.2.8.1. Overriding of Members</a></li>
+<li><a href="classifiers.html#_implementation-of-members">5.2.8.2. Implementation of Members</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#_member-consumption">5.2.8.2.1. Member Consumption</a></li>
+<li><a href="classifiers.html#_member-implementation">5.2.8.2.2. Member Implementation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="classifiers.html#_structural-typing">5.3. Structural Typing</a>
+<ul class="sectlevel3">
+<li><a href="classifiers.html#_syntax-7">5.3.1. Syntax</a></li>
+<li><a href="classifiers.html#_definition-site-structural-typing">5.3.2. Definition Site Structural Typing</a></li>
+<li><a href="classifiers.html#_use-site-structural-typing">5.3.3. Use-Site Structural Typing</a></li>
+<li><a href="classifiers.html#structural-readWriteInit-field-typing">5.3.4. Structural Read-only, Write-only and Initializer Field Typing</a></li>
+<li><a href="classifiers.html#_public-setter-annotated-with-code-providesinitializer-code">5.3.5. Public Setter Annotated With <code>ProvidesInitializer</code></a></li>
+<li><a href="classifiers.html#_structural-types-with-optional-fields">5.3.6. Structural Types With Optional Fields</a></li>
+<li><a href="classifiers.html#_structural-types-with-access-modifier">5.3.7. Structural Types With Access Modifier</a></li>
+<li><a href="classifiers.html#_structural-types-with-additional-members">5.3.8. Structural Types With Additional Members</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_syntax-8">5.3.8.1. Syntax</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#_semantics-6">5.3.8.1.1. Semantics</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="functions.html#_functions">6. Functions</a>
+<ul class="sectlevel2">
+<li><a href="functions.html#_function-type">6.1. Function Type</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_properties-5">6.1.1. Properties</a></li>
+<li><a href="functions.html#function-type-inference">6.1.2. Type Inference</a></li>
+<li><a href="functions.html#_autoboxing-of-function-type">6.1.3. Autoboxing of Function Type</a></li>
+<li><a href="functions.html#_arguments-object">6.1.4. Arguments Object</a></li>
+</ul>
+</li>
+<li><a href="functions.html#_ecmascript-5-function-definition">6.2. ECMAScript 5 Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_function-declaration">6.2.1. Function Declaration</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#_syntax-9">6.2.1.1. Syntax</a></li>
+<li><a href="functions.html#_semantics-8">6.2.1.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="functions.html#_function-expression">6.2.2. Function Expression</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#function-expression-syntax">6.2.2.1. Syntax</a></li>
+<li><a href="functions.html#_semantics-and-type-inference">6.2.2.2. Semantics and Type Inference</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="functions.html#_ecmascript-2015-function-definition">6.3. ECMAScript 2015 Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_formal-parameters">6.3.1. Formal Parameters</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#Type_Modifiers_Optional">6.3.1.1. Optional Parameters</a></li>
+<li><a href="functions.html#Type_Modifiers_Default">6.3.1.2. Default Parameters</a></li>
+<li><a href="functions.html#Type_Modifiers_Variadic">6.3.1.3. Variadic</a></li>
+</ul>
+</li>
+<li><a href="functions.html#_generator-functions">6.3.2. Generator Functions</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#generator-functions-syntax">6.3.2.1. Syntax</a></li>
+<li><a href="functions.html#generator-functions-semantics">6.3.2.2. Semantics</a></li>
+<li><a href="functions.html#_generator-arrow-functions">6.3.2.3. Generator Arrow Functions</a></li>
+</ul>
+</li>
+<li><a href="functions.html#_arrow-function-expression">6.3.3. Arrow Function Expression</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#arrow-function-expression-syntax">6.3.3.1. Syntax</a></li>
+<li><a href="functions.html#arrow-function-expression-semantics-and-type-inference">6.3.3.2. Semantics and Type Inference</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="functions.html#_ecmascript-proposals-function-definition">6.4. ECMAScript Proposals Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_asynchronous-functions">6.4.1. Asynchronous Functions</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#asynchronous-functions-syntax">6.4.1.1. Syntax</a></li>
+<li><a href="functions.html#asynchronous-functions-semantics">6.4.1.2. Semantics</a></li>
+<li><a href="functions.html#_asynchronous-arrow-functions">6.4.1.3. Asynchronous Arrow Functions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="functions.html#_n4js-extended-function-definition">6.5. N4JS Extended Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_generic-functions">6.5.1. Generic Functions</a></li>
+<li><a href="functions.html#_promisifiable-functions">6.5.2. Promisifiable Functions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_conversions-and-reflection">7. Conversions and Reflection</a>
+<ul class="sectlevel2">
+<li><a href="conversions_and_reflection.html#_autoboxing-and-coercing">7.1. Autoboxing and Coercing</a>
+<ul class="sectlevel3">
+<li><a href="conversions_and_reflection.html#_coercing">7.1.1. Coercing</a></li>
+<li><a href="conversions_and_reflection.html#_autoboxing-of-primitives">7.1.2. Autoboxing of Primitives</a></li>
+<li><a href="conversions_and_reflection.html#_autoboxing-of-function-expressions-and-declarations">7.1.3. Autoboxing of Function Expressions and Declarations</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_auto-conversion-of-objects">7.2. Auto-Conversion of Objects</a>
+<ul class="sectlevel3">
+<li><a href="conversions_and_reflection.html#_auto-conversion-of-class-instances">7.2.1. Auto-Conversion of Class Instances</a>
+<ul class="sectlevel4">
+<li><a href="conversions_and_reflection.html#_auto-conversion-of-interface-instances">7.2.1.1. Auto-Conversion of Interface Instances</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_auto-conversion-of-enum-literals">7.2.2. Auto-Conversion of Enum Literals</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_type-cast-and-type-check">7.3. Type Cast and Type Check</a>
+<ul class="sectlevel3">
+<li><a href="conversions_and_reflection.html#_type-cast">7.3.1. Type Cast</a></li>
+<li><a href="conversions_and_reflection.html#_type-check">7.3.2. Type Check</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_reflection-meta-information">7.4. Reflection meta-information</a>
+<ul class="sectlevel3">
+<li><a href="conversions_and_reflection.html#_reflection-for-classes">7.4.1. Reflection for Classes</a></li>
+<li><a href="conversions_and_reflection.html#_reflection-for-interfaces">7.4.2. Reflection for Interfaces</a></li>
+<li><a href="conversions_and_reflection.html#_reflection-for-enumerations">7.4.3. Reflection for Enumerations</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_conversion-of-primitive-types">7.5. Conversion of primitive types</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_expressions">8. Expressions</a>
+<ul class="sectlevel2">
+<li><a href="expressions.html#_ecmascript-5-expressions">8.1. ECMAScript 5 Expressions</a>
+<ul class="sectlevel3">
+<li><a href="expressions.html#_the-this-literal">8.1.1. The this Literal</a></li>
+<li><a href="expressions.html#_identifier">8.1.2. Identifier</a></li>
+<li><a href="expressions.html#_literals">8.1.3. Literals</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#_integer-literals">8.1.3.1. Integer Literals</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_array-literal">8.1.4. Array Literal</a></li>
+<li><a href="expressions.html#_object-literal">8.1.5. Object Literal</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#_properties-6">8.1.5.1. Properties</a></li>
+<li><a href="expressions.html#_scoping-and-linking">8.1.5.2. Scoping and linking</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_parenthesized-expression-and-grouping-operator">8.1.6. Parenthesized Expression and Grouping Operator</a></li>
+<li><a href="expressions.html#_property-accessors">8.1.7. Property Accessors</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#properties-1">8.1.7.1. Properties</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_new-expression">8.1.8. New Expression</a></li>
+<li><a href="expressions.html#_function-expression-2">8.1.9. Function Expression</a></li>
+<li><a href="expressions.html#_function-calls">8.1.10. Function Calls</a></li>
+<li><a href="expressions.html#_postfix-expression">8.1.11. Postfix Expression</a></li>
+<li><a href="expressions.html#_unary-expression">8.1.12. Unary Expression</a></li>
+<li><a href="expressions.html#_multiplicative-expression">8.1.13. Multiplicative Expression</a></li>
+<li><a href="expressions.html#_additive-expression">8.1.14. Additive Expression</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#type-inference-10">8.1.14.1. Type Inference</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_bitwise-shift-expression">8.1.15. Bitwise Shift Expression</a></li>
+<li><a href="expressions.html#_relational-expression">8.1.16. Relational Expression</a></li>
+<li><a href="expressions.html#_equality-expression">8.1.17. Equality Expression</a></li>
+<li><a href="expressions.html#_binary-bitwise-expression">8.1.18. Binary Bitwise Expression</a></li>
+<li><a href="expressions.html#_binary-logical-expression">8.1.19. Binary Logical Expression</a></li>
+<li><a href="expressions.html#_conditional-expression">8.1.20. Conditional Expression</a></li>
+<li><a href="expressions.html#_assignment-expression">8.1.21. Assignment Expression</a></li>
+<li><a href="expressions.html#_comma-expression">8.1.22. Comma Expression</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_ecmascript-6-expressions">8.2. ECMAScript 6 Expressions</a>
+<ul class="sectlevel3">
+<li><a href="expressions.html#_the-super-keyword">8.2.1. The super Keyword</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_ecmascript-7-expressions">8.3. ECMAScript 7 Expressions</a>
+<ul class="sectlevel3">
+<li><a href="expressions.html#_await-expression">8.3.1. Await Expression</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_n4js-specific-expressions">8.4. N4JS Specific Expressions</a>
+<ul class="sectlevel3">
+<li><a href="expressions.html#_class-expression">8.4.1. Class Expression</a></li>
+<li><a href="expressions.html#_cast-as-expression">8.4.2. Cast (As) Expression</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#cast-as-expression-semantics-type-inference">8.4.2.1. Semantics and Type Inference</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#Import_Calls">8.4.3. Import Calls</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#compile-time-expressions">8.5. Compile-Time Expressions</a></li>
+</ul>
+</li>
+<li><a href="statements.html#_statements">9. Statements</a>
+<ul class="sectlevel2">
+<li><a href="statements.html#_ecmascript-5-statements">9.1. ECMAScript 5 Statements</a>
+<ul class="sectlevel3">
+<li><a href="statements.html#_function-or-field-accessor-bodies">9.1.1. Function or Field Accessor Bodies</a></li>
+<li><a href="statements.html#_variable-statement">9.1.2. Variable Statement</a></li>
+<li><a href="statements.html#_if-statement">9.1.3. If Statement</a></li>
+<li><a href="statements.html#_iteration-statements">9.1.4. Iteration Statements</a></li>
+<li><a href="statements.html#_return-statement">9.1.5. Return Statement</a></li>
+<li><a href="statements.html#_with-statement">9.1.6. With Statement</a></li>
+<li><a href="statements.html#_switch-statement">9.1.7. Switch Statement</a></li>
+<li><a href="statements.html#_throw-try-and-catch-statements">9.1.8. Throw, Try, and Catch Statements</a></li>
+<li><a href="statements.html#_debugger-statement">9.1.9. Debugger Statement</a></li>
+</ul>
+</li>
+<li><a href="statements.html#_ecmascript-6-statements">9.2. ECMAScript 6 Statements</a>
+<ul class="sectlevel3">
+<li><a href="statements.html#_let">9.2.1. Let</a></li>
+<li><a href="statements.html#_const">9.2.2. Const</a></li>
+<li><a href="statements.html#_for-of-statement">9.2.3. <code>for &#8230;&#8203; of</code> statement</a></li>
+<li><a href="statements.html#_import-statement">9.2.4. Import Statement</a>
+<ul class="sectlevel4">
+<li><a href="statements.html#Dynamic_Imports">9.2.4.1. Dynamic Imports</a></li>
+<li><a href="statements.html#_immutabilaty-of-imports">9.2.4.2. Immutabilaty of Imports</a></li>
+</ul>
+</li>
+<li><a href="statements.html#_export-statement">9.2.5. Export Statement</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="annotations.html#_annotations">10. Annotations</a>
+<ul class="sectlevel2">
+<li><a href="annotations.html#_introduction-2">10.1. Introduction</a>
+<ul class="sectlevel3">
+<li><a href="annotations.html#_syntax-13">10.1.1. Syntax</a></li>
+<li><a href="annotations.html#_properties-7">10.1.2. Properties</a></li>
+<li><a href="annotations.html#_element-specific-annotations">10.1.3. Element-Specific Annotations</a></li>
+<li><a href="annotations.html#_general-annotations">10.1.4. General Annotations</a>
+<ul class="sectlevel4">
+<li><a href="annotations.html#_idebug">10.1.4.1. IDEBUG</a></li>
+</ul>
+</li>
+<li><a href="annotations.html#idebug-syntax">10.1.5. Syntax</a>
+<ul class="sectlevel4">
+<li><a href="annotations.html#_semantics-11">10.1.5.1. Semantics</a></li>
+<li><a href="annotations.html#_suppress-warnings">10.1.5.2. Suppress Warnings</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="annotations.html#_declaration-of-annotations">10.2. Declaration of Annotations</a></li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_extended-fetaures">11. Extended Fetaures</a>
+<ul class="sectlevel2">
+<li><a href="extended_fetaures.html#_array-and-object-destructuring">11.1. Array and Object Destructuring</a>
+<ul class="sectlevel3">
+<li><a href="extended_fetaures.html#_syntax-14">11.1.1. Syntax</a></li>
+<li><a href="extended_fetaures.html#_semantics-12">11.1.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_dependency-injection">11.2. Dependency Injection</a>
+<ul class="sectlevel3">
+<li><a href="extended_fetaures.html#_di-components-and-injectors">11.2.1. DI Components and Injectors</a>
+<ul class="sectlevel4">
+<li><a href="extended_fetaures.html#_dicomponent-relations">11.2.1.1. DIComponent Relations</a></li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_binders-and-bindings">11.2.2. Binders and Bindings</a></li>
+<li><a href="extended_fetaures.html#_injection-points">11.2.3. Injection Points</a>
+<ul class="sectlevel4">
+<li><a href="extended_fetaures.html#_field-injection">11.2.3.1. Field Injection</a></li>
+<li><a href="extended_fetaures.html#_constructor-injection">11.2.3.2. Constructor Injection</a></li>
+<li><a href="extended_fetaures.html#_method-injection">11.2.3.3. Method Injection</a>
+<ul class="sectlevel5">
+<li><a href="extended_fetaures.html#_provider">11.2.3.3.1. Provider</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_n4js-di-life-cycle-and-scopes">11.2.4. N4JS DI Life Cycle and Scopes</a>
+<ul class="sectlevel4">
+<li><a href="extended_fetaures.html#_injection-cylces">11.2.4.1. Injection Cylces</a></li>
+<li><a href="extended_fetaures.html#_default-scope">11.2.4.2. Default Scope</a></li>
+<li><a href="extended_fetaures.html#_singleton-scope">11.2.4.3. Singleton Scope</a></li>
+<li><a href="extended_fetaures.html#_per-injection-chain-singleton">11.2.4.4. Per Injection Chain Singleton</a></li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_validation-of-callsites-targeting-n4injector-methods">11.2.5. Validation of callsites targeting N4Injector methods</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-annotations">11.2.6. N4JS DI Annotations</a>
+<ul class="sectlevel4">
+<li><a href="extended_fetaures.html#_n4js-di-generateinjector">11.2.6.1. N4JS DI @GenerateInjector</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-withparentinjector">11.2.6.2. N4JS DI @WithParentInjector</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-usebinder">11.2.6.3. N4JS DI @UseBinder</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-binder">11.2.6.4. N4JS DI @Binder</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-bind">11.2.6.5. N4JS DI @Bind</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-provides">11.2.6.6. N4JS DI @Provides</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-inject">11.2.6.7. N4JS DI @Inject</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-singleton">11.2.6.8. N4JS DI @Singleton</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_test-support">11.3. Test Support</a></li>
+<li><a href="extended_fetaures.html#_polyfill-definitions">11.4. Polyfill Definitions</a>
+<ul class="sectlevel3">
+<li><a href="extended_fetaures.html#_runtime-polyfill-definitions">11.4.1. Runtime Polyfill Definitions</a></li>
+<li><a href="extended_fetaures.html#_static-polyfill-definitions">11.4.2. Static Polyfill Definitions</a></li>
+<li><a href="extended_fetaures.html#_transpiling-static-polyfilled-classes">11.4.3. Transpiling static polyfilled classes</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="components.html#_components">12. Components</a>
+<ul class="sectlevel2">
+<li><a href="components.html#_overview-2">12.1. Overview</a></li>
+<li><a href="components.html#Component_Types">12.2. Component Types</a>
+<ul class="sectlevel3">
+<li><a href="components.html#_libraries">12.2.1. Libraries</a></li>
+<li><a href="components.html#_runtime-environment-and-runtime-libraries">12.2.2. Runtime Environment and Runtime Libraries</a></li>
+<li><a href="components.html#_tests">12.2.3. Tests</a></li>
+<li><a href="components.html#_type-definitions">12.2.4. Type Definitions</a></li>
+</ul>
+</li>
+<li><a href="components.html#package-json">12.3. Package.json File</a>
+<ul class="sectlevel3">
+<li><a href="components.html#_basic-properties">12.3.1. Basic Properties</a></li>
+<li><a href="components.html#_n4js-properties">12.3.2. N4JS Properties</a></li>
+<li><a href="components.html#_constraints">12.3.3. Constraints</a></li>
+</ul>
+</li>
+<li><a href="components.html#_support-for-npm-scopes">12.4. Support for NPM Scopes</a></li>
+<li><a href="components.html#sec:N4JS-Type-Definitions">12.5. N4JS Type Definitions</a>
+<ul class="sectlevel3">
+<li><a href="components.html#_specify-type-definition">12.5.1. Specify Type Definition</a></li>
+<li><a href="components.html#_name-conventions">12.5.2. Name Conventions</a></li>
+<li><a href="components.html#_version-conventions">12.5.3. Version Conventions</a>
+<ul class="sectlevel4">
+<li><a href="components.html#_define-a-new-type-definition-package">12.5.3.1. Define a New Type Definition Package</a></li>
+<li><a href="components.html#_using-a-type-definition-package">12.5.3.2. Using a Type Definition Package</a></li>
+<li><a href="components.html#_rational">12.5.3.3. Rational</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="components.html#_modules">12.6. Modules</a></li>
+<li><a href="components.html#_api-and-implementation-component">12.7. API and Implementation Component</a>
+<ul class="sectlevel3">
+<li><a href="components.html#_execution-of-api-and-implementation-components">12.7.1. Execution of API and Implementation Components</a></li>
+<li><a href="components.html#_api-and-implementation-with-di">12.7.2. API and Implementation With DI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="plainjs.html#_plainjs">13. PlainJS</a>
+<ul class="sectlevel2">
+<li><a href="plainjs.html#_type-inference-and-validation-for-plain-js">13.1. Type Inference and Validation for Plain JS</a></li>
+<li><a href="plainjs.html#_external-declarations">13.2. External Declarations</a>
+<ul class="sectlevel3">
+<li><a href="plainjs.html#_declaring-externals">13.2.1. Declaring externals</a></li>
+<li><a href="plainjs.html#_instantiating-external-classes">13.2.2. Instantiating external classes</a></li>
+<li><a href="plainjs.html#_implementation-of-external-declarations">13.2.3. Implementation of External Declarations</a></li>
+<li><a href="plainjs.html#_example">13.2.4. Example</a></li>
+</ul>
+</li>
+<li><a href="plainjs.html#_global-definitions">13.3. Global Definitions</a></li>
+<li><a href="plainjs.html#_runtime-definitions">13.4. Runtime Definitions</a></li>
+<li><a href="plainjs.html#_applying-polyfills">13.5. Applying Polyfills</a></li>
+</ul>
+</li>
+<li><a href="#_jsdoc-2">14. JSDoc</a>
+<ul class="sectlevel2">
+<li><a href="#_general-n4jsdoc-features">14.1. General N4JSDoc Features</a>
+<ul class="sectlevel3">
+<li><a href="#_provided-inline-tags">14.1.1. Provided Inline Tags</a>
+<ul class="sectlevel4">
+<li><a href="#jsdoc_tag__code">14.1.1.1. @code</a></li>
+<li><a href="#jsdoc_tag__link">14.1.1.2. @link</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#_n4jsdoc-for-user-projects">14.2. N4JSdoc for User Projects</a>
+<ul class="sectlevel3">
+<li><a href="#_standard-tags">14.2.1. Standard Tags</a>
+<ul class="sectlevel4">
+<li><a href="#_-author">14.2.1.1. @author</a></li>
+<li><a href="#jsdoc_tag_param">14.2.1.2. @param</a></li>
+<li><a href="#jsdoc_tag_return">14.2.1.3. @return</a></li>
+</ul>
+</li>
+<li><a href="#_test-related-tags">14.2.2. Test Related Tags</a>
+<ul class="sectlevel4">
+<li><a href="#jsdoc_tag__testee">14.2.2.1. @testee</a></li>
+<li><a href="#jsdoc_tag__testeeFromType">14.2.2.2. @testeeFromType</a></li>
+<li><a href="#_testeeType_and__testeeMember">14.2.2.3. @testeeType and @testeeMember</a></li>
+<li><a href="#jsdoc_tag_reqid_in_Tests">14.2.2.4. @reqid in Tests</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#_n4jsdoc-for-api-and-implementation-projects">14.3. N4JSDoc for API and Implementation Projects</a>
+<ul class="sectlevel3">
+<li><a href="#jsdoc_tag__apiNote">14.3.1. @apiNote</a></li>
+<li><a href="#API_Project_Tags">14.3.2. API Project Tags</a>
+<ul class="sectlevel4">
+<li><a href="#jsdoc_tag_apiState">14.3.2.1. @apiState</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsx.html#_jsx">15. JSX</a>
+<ul class="sectlevel2">
+<li><a href="jsx.html#_jsx-support">15.1. JSX Support</a></li>
+<li><a href="jsx.html#_jsx-backend">15.2. JSX Backend</a></li>
+</ul>
+</li>
+<li><a href="grammars.html#_grammars">16. Grammars</a>
+<ul class="sectlevel2">
+<li><a href="grammars.html#_type-expressions-grammar">16.1. Type Expressions Grammar</a></li>
+<li><a href="grammars.html#_n4js-language-grammar">16.2. N4JS Language Grammar</a></li>
+</ul>
+</li>
+<li><a href="jsobjects.html#_jsobjects">17. JSObjects</a>
+<ul class="sectlevel2">
+<li><a href="jsobjects.html#_object">17.1. Object</a></li>
+<li><a href="jsobjects.html#_string">17.2. String</a></li>
+<li><a href="jsobjects.html#_boolean">17.3. Boolean</a></li>
+<li><a href="jsobjects.html#_number">17.4. Number</a>
+<ul class="sectlevel3">
+<li><a href="jsobjects.html#_static-attributes">17.4.1. Static Attributes</a></li>
+</ul>
+</li>
+<li><a href="jsobjects.html#function">17.5. Function</a></li>
+<li><a href="jsobjects.html#_error">17.6. Error</a></li>
+<li><a href="jsobjects.html#_array">17.7. Array</a></li>
+<li><a href="jsobjects.html#_date">17.8. Date</a></li>
+<li><a href="jsobjects.html#_math">17.9. Math</a>
+<ul class="sectlevel3">
+<li><a href="jsobjects.html#static-attributes-1">17.9.1. Static Attributes</a></li>
+</ul>
+</li>
+<li><a href="jsobjects.html#_regexp">17.10. RegExp</a></li>
+<li><a href="jsobjects.html#_json">17.11. JSON</a></li>
+</ul>
+</li>
+<li><a href="n4js_objects.html#_n4js-objects">18. N4JS Objects</a>
+<ul class="sectlevel2">
+<li><a href="n4js_objects.html#_reflection-model">18.1. Reflection Model</a></li>
+<li><a href="n4js_objects.html#_error-types">18.2. Error Types</a>
+<ul class="sectlevel3">
+<li><a href="n4js_objects.html#_n4apinotimplemented">18.2.1. N4ApiNotImplemented</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_acronyms.html#_acronyms">Appendix A: Acronyms</a></li>
+<li><a href="appendix_b_license.html#sec:License">Appendix B: License</a></li>
+<li><a href="appendix_c_bibliography.html#_bibliography">Appendix C: Bibliography</a></li>
+</ul>
+</div>
+</div>
+<div id="content"><div class="sect1">
+<h2 id="_jsdoc-2"><a class="anchor" href="#_jsdoc-2"></a><a class="link" href="#_jsdoc-2">14. JSDoc</a></h2>
+<div class="sectionbody">
+<div class="paragraph language-n4js">
+<p>In N4JS, comments starting with two asterisks (in <code>/** .. */</code>) are interpreted as
+documentation comments. The format is similar to JavaDoc or Google
+Closure annotations.</p>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="_general-n4jsdoc-features"><a class="anchor" href="#_general-n4jsdoc-features"></a><a class="link" href="#_general-n4jsdoc-features">14.1. General N4JSDoc Features</a></h3>
+<div class="paragraph">
+<p>We distinguish between line and inline tags.
+The format of the content of a tag is specific to the tag.
+Most line tags, however, contain a description which is simply multiline text with nested inline tags.
+Every comment may start with a description.</p>
+</div>
+<div class="sect3">
+<h4 id="_provided-inline-tags"><a class="anchor" href="#_provided-inline-tags"></a><a class="link" href="#_provided-inline-tags">14.1.1. Provided Inline Tags</a></h4>
+<div class="sect4">
+<h5 id="jsdoc_tag__code"><a class="anchor" href="#jsdoc_tag__code"></a><a class="link" href="#jsdoc_tag__code">14.1.1.1. @code</a></h5>
+<div class="paragraph">
+<p>Small code snippet, not validated yet.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="jsdoc_tag__link"><a class="anchor" href="#jsdoc_tag__link"></a><a class="link" href="#jsdoc_tag__link">14.1.1.2. @link</a></h5>
+<div class="paragraph">
+<p>Link to a type of element, not validated or supported in navigation yet.</p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="_n4jsdoc-for-user-projects"><a class="anchor" href="#_n4jsdoc-for-user-projects"></a><a class="link" href="#_n4jsdoc-for-user-projects">14.2. N4JSdoc for User Projects</a></h3>
+<div class="sect3">
+<h4 id="_standard-tags"><a class="anchor" href="#_standard-tags"></a><a class="link" href="#_standard-tags">14.2.1. Standard Tags</a></h4>
+<div class="sect4">
+<h5 id="_-author"><a class="anchor" href="#_-author"></a><a class="link" href="#_-author">14.2.1.1. @author</a></h5>
+<div class="paragraph">
+<p>Name of author, repeat for multiple authors. Name of author is not
+validated.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="jsdoc_tag_param"><a class="anchor" href="#jsdoc_tag_param"></a><a class="link" href="#jsdoc_tag_param">14.2.1.2. @param</a></h5>
+<div class="paragraph">
+<p>Parameter description, not validated at the moment.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="jsdoc_tag_return"><a class="anchor" href="#jsdoc_tag_return"></a><a class="link" href="#jsdoc_tag_return">14.2.1.3. @return</a></h5>
+<div class="paragraph">
+<p>Return description, not validated at the moment.</p>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_test-related-tags"><a class="anchor" href="#_test-related-tags"></a><a class="link" href="#_test-related-tags">14.2.2. Test Related Tags</a></h4>
+<div class="paragraph">
+<p>The following tags are supposed to be used only in tests.</p>
+</div>
+<div class="sect4">
+<h5 id="jsdoc_tag__testee"><a class="anchor" href="#jsdoc_tag__testee"></a><a class="link" href="#jsdoc_tag__testee">14.2.2.1. @testee</a></h5>
+<div class="paragraph">
+<p>Link to type (maybe a function) or member tested by the test.</p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-172"></a><strong>Req. IDE-172:</strong> <a href="#Req-IDE-172">@testee Semantics</a> (ver. 1)</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Tag can be only used on either</p>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p>methods annotated with <code>@Test</code></p>
+</li>
+<li>
+<p>classes in test projects or folders, cf. <a href="#jsdoc_tag__testeeFromType">@testeeFromType</a>.</p>
+</li>
+</ol>
+</div>
+</li>
+<li>
+<p>Tag requires a single argument, which is a fully qualified name to a type, including the module specifier.
+The format is as follows: <code>moduleSpecifier '.' typeName ( ('.'|'#') memberName)?</code></p>
+</li>
+<li>
+<p>Tag is <em>not</em> repeatable, that is a single test method (or class) can refer to only one testee.</p>
+</li>
+<li>
+<p>Tag precedes the <code>reqid</code> tag, i.e., if a <code>@testee</code> is specified, the <code>reqid</code> will be ignored.</p>
+</li>
+</ol>
+</div>
+</div>
+</div>
+<div class="exampleblock">
+<div class="title">Example 108. @testee</div>
+<div class="content">
+<div class="paragraph">
+<p>The target element is to be fully qualified including the module specifier. The module specifier is simply
+the source folder relative path name with forward slashes. Type and
+element are added to that using dot as a separator. For example:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">/**
+ * @testee some/package/Module.Type.member
+ */</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="jsdoc_tag__testeeFromType"><a class="anchor" href="#jsdoc_tag__testeeFromType"></a><a class="link" href="#jsdoc_tag__testeeFromType">14.2.2.2. @testeeFromType</a></h5>
+<div class="paragraph">
+<p>Instead of directly linking a test method to a testee, the testee is to
+be derived from the linked testee of the test class. This is useful if a
+base test class is defined with generic tests, e.g., for testing methods
+defined in an interface and implemented by some classes. This base test
+class is then extended by concrete test classes, correctly setting up
+the test fixture, e.g., creating instances of some classes implementing
+the interfaces tested in the base class.</p>
+</div>
+<div class="exampleblock">
+<div class="title">Example 109. Usage of testeeFromType</div>
+<div class="content">
+<div class="paragraph">
+<p>In the following example, the is used. This tag will lead to a test documentation for <code>B.foo</code> and <code>C.foo</code>.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">abstract class Base {
+    /**
+     * @testeeFromType
+     */
+    @Test testFoo() {..}
+}
+
+/**
+ * @testee B.foo
+ */
+class TestB extends Base {}
+
+/**
+ * @testee C.foo
+ */
+class TestC extends Base {}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title=""></i>
+</td>
+<td class="content">
+The resulting spec has to be double-checked for consistency
+since it is easily possible that too many constraints are generated.
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_testeeType_and__testeeMember"><a class="anchor" href="#_testeeType_and__testeeMember"></a><a class="link" href="#_testeeType_and__testeeMember">14.2.2.3. @testeeType and @testeeMember</a></h5>
+<div class="paragraph">
+<p>Specifying the testee at the test method directly should be sufficient
+for most cases. The <code>@testeeFromType</code> tag already provides support for some cases in which a base test class is reused by subtypes. This case usually only works if
+the base test class tests a single method only. If the base test class
+tests several methods and if a sub test class only provides a different
+fixture, this mechanism is not sufficient. For that purpose, the two
+tags <code>@testeeFromType</code> and <code>@@testeeMember</code> are to be used.
+They enable the separation of a test related to a specific member and the concrete receiver type of the tested member.</p>
+</div>
+<div class="paragraph">
+<p>The <code>@testeeType</code> is to defined in the test class JSDoc (actually, it is not
+recognized when defined in a member JSDoc). The <code>@testeeMember</code> is specified in the test method JSDoc. The "real" testee is then computed from the testee type and the testee method.</p>
+</div>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title=""></i>
+</td>
+<td class="content">
+1. This only works for instance members, so far!<br>
+2. There is no validation for invalid combinations!
+</td>
+</tr>
+</table>
+</div>
+<div id="ex:testeetype-and-testeemethod" class="exampleblock">
+<div class="title">Example 110. testeeType and testeeMethod</div>
+<div class="content">
+<div class="paragraph">
+<p>Assume the following testees:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">class A {
+    foo(): void {..}
+    bar(): void { .. this.foo(); ..}
+}
+class B extends A {
+    @Override foo() { .. }
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Assume that the tests have to ensure the same semantics for <code>bar</code>, which is
+maybe changed by a wrong implementation of <code>foo</code>. That is, <code>bar</code> is to be tested in
+case of the receiver type <code>A</code> and <code>B</code>. This can be achieved by the following
+tests:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">/**
+ * @testeeType A.A
+ */
+class ATest {
+    fixture(): A { return new A(); }
+
+    /**
+     * @testeeMember bar
+     */
+    @Test testBar(): void { assertBehavior( fixture().bar() ); }
+}
+/**
+ * @testeeType B.B
+ */
+class BTest extends ATest {
+    @Override fixture(): B { return new B(); }
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>This actually defines two tests, which is also recognized by the spec
+exporter:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p><code>testBar</code> for a receiver of type <code>A</code>:</p>
+<div class="paragraph">
+<p><code>ATest</code>'s JSDoc <code>@testeeType</code> + <code>ATest.testBar</code>'s JSDoc <code>@testeeMember</code> = testee <code>A.A.bar</code></p>
+</div>
+</li>
+<li>
+<p><code>testBar</code> for a receiver of type <code>B</code>:</p>
+<div class="paragraph">
+<p><code>BTest</code>'s JSDoc <code>@testeeType</code> + <code>ATest.testBar</code>'s JSDoc <code>@testeeMember</code> = testee <code>B.B.bar</code></p>
+</div>
+</li>
+</ol>
+</div>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title=""></i>
+</td>
+<td class="content">
+In all cases when <code>@testeeFromType</code> or <code>@testeeType</code>/<code>@testeeMember</code> is used, the resulting spec has to be
+double-checked for consistency. Consider if the multiplication of spec
+constraints is truly required, in particular if the original semantics
+of a method is not changed. Remember: It is possible to write API tests
+and omit the spec constraint generation simply by not adding the testee
+links.
+</td>
+</tr>
+</table>
+</div>
+<div class="exampleblock">
+<div class="title">Example 111. testeeType and testeeMethod with omitted constraints</div>
+<div class="content">
+<div class="paragraph">
+<p>Assume testees similar as in <a href="#ex:testeetype-and-testeemethod">testeeType and testeeMethod</a>. Since the semantics of <code>bar</code> is not changed in <code>B</code>, it is probably not necessary to generate the same constraint in the documentation for <code>bar</code> twice (one in the section for class <code>A</code> and another one in the section of class <code>B</code>).
+Still, we want the test to be executed for both receivers. This is how it is achieved:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">abstract class BaseTest {
+    abstract fixture(): A;
+
+    /**
+     * @testeeMember bar
+     */
+    @Test testBar(): void { assertBehavior( fixture().bar() ); }
+}
+
+/**
+ * @testeeType A.A
+ */
+class ATest extends BaseTest {
+    fixture(): A { return new A(); }
+}
+
+class BTest extends BaseTest {
+    @Override fixture(): B { return new B(); }
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>This actually defines two tests as in the previous example. Only one
+constraint is created in the spec by the spec exporter:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p><code>testBar</code> for a receiver of type <code>A</code>:<br>
+<code>ATest</code>'s JSDoc <code>@testeeType</code> + <code>BaseTest.testBar</code>'s JSDoc <code>@testeeMember</code> = testee <code>A.A.bar</code></p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>Although a test for receiver of type <code>B</code> is run, no additional constraint is
+created since there is no <code>@testeeType</code> available neither in <code>BTest</code> nor in <code>BaseTest</code>.</p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="jsdoc_tag_reqid_in_Tests"><a class="anchor" href="#jsdoc_tag_reqid_in_Tests"></a><a class="link" href="#jsdoc_tag_reqid_in_Tests">14.2.2.4. @reqid in Tests</a></h5>
+<div class="paragraph">
+<p>ID of feature used in <code>JSDoc</code> for the requirements section. If no
+testee (via one of the tags above) is given, then the test is linked to
+the requirement with given id.</p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="_n4jsdoc-for-api-and-implementation-projects"><a class="anchor" href="#_n4jsdoc-for-api-and-implementation-projects"></a><a class="link" href="#_n4jsdoc-for-api-and-implementation-projects">14.3. N4JSDoc for API and Implementation Projects</a></h3>
+<div class="paragraph">
+<p>The following tags are supposed to be used in API and implementation
+projects.</p>
+</div>
+<div class="sect3">
+<h4 id="jsdoc_tag__apiNote"><a class="anchor" href="#jsdoc_tag__apiNote"></a><a class="link" href="#jsdoc_tag__apiNote">14.3.1. @apiNote</a></h4>
+<div class="paragraph">
+<p>Simple note that is shown in the API compare view.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="API_Project_Tags"><a class="anchor" href="#API_Project_Tags"></a><a class="link" href="#API_Project_Tags">14.3.2. API Project Tags</a></h4>
+<div class="paragraph">
+<p>The following tags are supposed to be used in API projects only.</p>
+</div>
+<div class="sect4">
+<h5 id="jsdoc_tag_apiState"><a class="anchor" href="#jsdoc_tag_apiState"></a><a class="link" href="#jsdoc_tag_apiState">14.3.2.1. @apiState</a></h5>
+<div class="paragraph">
+<p>State of type or member definition, e.g., stable or draft. This can be
+used to define a history. In this case, the tag has to be repeated. For
+example:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">/**
+ * @apiState stable (WK)
+ * @apiState reviewed (JvP)
+ */</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div id="footer">
+<div id="footer-text">
+Version 0.9<br>
+Last updated 2019-08-07 15:02:40 CEST
+</div>
+</div>
+<!-- ************* docinfo-footer *************************************************************** -->
+<div class="Grid social" style="color:#d5dfea">
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <h2>Quick Links</h2>
+    <ul>
+      <li><a href="../downloads.html">Download</a></li>
+      <li><a href="../userguides/index.html">Documentation</a></li>
+      <li><a href="https://github.com/eclipse/n4js/">Source</a></li>
+      <li><a href="https://github.com/eclipse/n4js/issues">Issues</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="https://www.eclipse.org/forums/index.php/f/365/">Forum</a></li>
+      <li><a href="http://n4js.blogspot.de/">Blog</a></li>
+      <li><a href="https://dev.eclipse.org/mailman/listinfo/n4js-dev">Mailing List</a></li>
+      <li><a href="https://projects.eclipse.org/projects/technology.n4js">Eclipse Project Page</a></li>
+      <li><a href="https://twitter.com/n4jsdev">Tweets by n4jsdev</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="http://www.eclipse.org/">Eclipse Home</a></li>
+      <li><a href="http://www.eclipse.org/legal/privacy.php">Privacy Policy</a></li>
+      <li><a href="http://www.eclipse.org/legal/termsofuse.php">Terms of Use</a></li>
+      <li><a href="http://www.eclipse.org/legal/copyright.php">Copyright Agent</a></li>
+      <li><a href="http://www.eclipse.org/legal/">Legal</a></li>
+    </ul>
+  </div>
+  <div style="clear: both; height: 0; overflow: hidden;"></div>
+</div>
+
+<!-- ************* UI Scripts ************* -->
+<script type="text/javascript" src="scripts/back-to-top.js"></script>
+
+<script type="text/javascript" src="scripts/treeview.js"></script>
+<script type="text/javascript" src="scripts/toc.js"></script>
+
+<!-- ************* Prism.js Syntax Highlighting ************* -->
+<script src="scripts/prism.js"></script>
+
+<script type="text/javascript">
+	// Add the 'toclist' id for search function
+	$(".toc2 > ul").attr('id', 'toclist');
+	// Generate a Search input form
+	$("#toclist > li:first-of-type").before('<input type="text" id="pagesearch" onkeyup="search()" placeholder="Search for section...">');
+	$("#toclist > li:first-of-type").before('<i id="clear" class="fa fa-times-circle-o"></i>');
+	$("#clear").click(function(){
+	    $("#pagesearch").val('');
+	    search();
+	    $('.toc2 > ul').treeView('collapseAll');
+	});
+	// intialize Treeview.js
+	$(".toc2 > ul").treeView();
+	// Initialize Scrollspy
+</script>
+<!-- ************* docinfo-footer *************************************************************** -->
+</body>
+</html>
\ No newline at end of file
diff --git a/spec/jsobjects.html b/spec/jsobjects.html
new file mode 100644
index 0000000..5b2b071
--- /dev/null
+++ b/spec/jsobjects.html
@@ -0,0 +1,1886 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="generator" content="Asciidoctor 1.5.5">
+<meta name="author" content="2019-08-07 15:02:40 CEST">
+<title>N4JS Language Specification</title>
+<link rel="stylesheet" href="styles/spec.min.css">
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.6.3/css/font-awesome.min.css">
+<!-- ************* docinfo ******************************************************************* -->
+
+
+<!-- ************* Favicon ************-->
+<link rel="icon" href="images/favicon.ico" />
+
+<!-- ************* Back-to-top JQuery ************* -->
+<script src="https://code.jquery.com/jquery-1.12.4.js"></script>
+<script src="https://code.jquery.com/ui/1.12.0/jquery-ui.js"></script>
+
+
+<link href="styles/prism.min.css" rel="stylesheet" />
+<script type="text/javascript" async
+  src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2/MathJax.js?config=TeX-MML-AM_CHTML">
+</script>
+
+<!-- ************* Styles ************* -->
+<link rel="stylesheet" type="text/css" href="styles/n4jsspec-adoc.css">
+
+
+<!-- ****************** NavBar ****************** -->
+<div id="menubar">
+	<div class="banner">
+        <a href="https://www.eclipse.org/n4js/#"><img id="logo" src="images/n4js-logo.png" alt="Eclipse N4JS"></a>
+    </div>
+<ul>
+  <li><a href="index.html">Index</a></li>
+</ul>
+</div>
+<!-- ************* docinfo ******************************************************************* -->
+<style>
+      .admonitionblock td.icon .icon-todo:before{content:"\f249";color:#f4ee42}
+    </style>
+</head>
+<body class="book toc2 toc-left">
+<div id="header">
+<h1>N4JS Language Specification</h1>
+<div class="details">
+<span id="author" class="author">2019-08-07 15:02:40 CEST</span><br>
+<span id="revnumber">version 0.9</span>
+</div>
+<div id="toc" class="toc2">
+<div id="toctitle">Table of Contents</div>
+<ul class="sectlevel1">
+<li><a href="introduction.html#_introduction">1. Introduction</a>
+<ul class="sectlevel2">
+<li><a href="introduction.html#_notation">1.1. Notation</a>
+<ul class="sectlevel3">
+<li><a href="introduction.html#_grammar-notation">1.1.1. Grammar Notation</a></li>
+<li><a href="introduction.html#_type-judgments-and-rules-and-constraints-notation">1.1.2. Type Judgments and Rules and Constraints Notation</a>
+<ul class="sectlevel4">
+<li><a href="introduction.html#_typing-rules-and-judgments">1.1.2.1. Typing Rules and Judgments</a></li>
+<li><a href="introduction.html#_types-of-an-element">1.1.2.2. Types of an Element</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="introduction.html#_auxiliary-functions">1.2. Auxiliary Functions</a>
+<ul class="sectlevel3">
+<li><a href="introduction.html#_binding">1.2.1. Binding</a></li>
+<li><a href="introduction.html#_merging-types">1.2.2. Merging Types</a>
+<ul class="sectlevel4">
+<li><a href="introduction.html#_logic-formulas">1.2.2.1. Logic Formulas</a></li>
+</ul>
+</li>
+<li><a href="introduction.html#_symbols-and-font-convention">1.2.3. Symbols and Font Convention</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="grammar.html#_grammar">2. Grammar</a>
+<ul class="sectlevel2">
+<li><a href="grammar.html#_lexical-conventions">2.1. Lexical Conventions</a>
+<ul class="sectlevel3">
+<li><a href="grammar.html#_identifier-names-and-identifiers">2.1.1. Identifier Names and Identifiers</a></li>
+<li><a href="grammar.html#_this-keyword">2.1.2. This Keyword</a></li>
+<li><a href="grammar.html#_regular-expression-literals">2.1.3. Regular Expression Literals</a></li>
+<li><a href="grammar.html#_automatic-semicolon-insertion">2.1.4. Automatic Semicolon Insertion</a></li>
+<li><a href="grammar.html#_jsdoc">2.1.5. JSDoc</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="names.html#_names">3. Names</a>
+<ul class="sectlevel2">
+<li><a href="names.html#_access-control">3.1. Access Control</a></li>
+<li><a href="names.html#_accessibility-of-types-top-level-variables-and-function-declarations">3.2. Accessibility of Types, Top-Level Variables and Function Declarations</a>
+<ul class="sectlevel3">
+<li><a href="names.html#_accessibility-of-members">3.2.1. Accessibility of Members</a></li>
+<li><a href="names.html#_valid-names">3.2.2. Valid Names</a></li>
+<li><a href="names.html#_qualified-names">3.2.3. Qualified Names</a></li>
+<li><a href="names.html#_name-duplicates">3.2.4. Name Duplicates</a>
+<ul class="sectlevel4">
+<li><a href="names.html#_lexical-environment">3.2.4.1. Lexical Environment</a></li>
+<li><a href="names.html#_duplicates-and-shadowing">3.2.4.2. Duplicates and Shadowing</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="types.html#_types">4. Types</a>
+<ul class="sectlevel2">
+<li><a href="types.html#_overview">4.1. Overview</a></li>
+<li><a href="types.html#_type-expressions">4.2. Type Expressions</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_syntax">4.2.1. Syntax</a></li>
+<li><a href="types.html#_properties">4.2.2. Properties</a></li>
+<li><a href="types.html#_semantics">4.2.3. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_type-inference">4.3. Type Inference</a></li>
+<li><a href="types.html#_generic-and-parameterized-types">4.4. Generic and Parameterized Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_generic-types">4.4.1. Generic Types</a></li>
+<li><a href="types.html#_type-variables">4.4.2. Type Variables</a></li>
+<li><a href="types.html#_parameterized-types">4.4.3. Parameterized Types</a></li>
+</ul>
+</li>
+<li><a href="types.html#_primitive-ecmascript-types">4.5. Primitive ECMAScript Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_undefined-type">4.5.1. Undefined Type</a></li>
+<li><a href="types.html#_null-type">4.5.2. Null Type</a></li>
+<li><a href="types.html#_primitive-boolean-type">4.5.3. Primitive Boolean Type</a></li>
+<li><a href="types.html#_primitive-string-type">4.5.4. Primitive String Type</a></li>
+<li><a href="types.html#_primitive-number-type">4.5.5. Primitive Number Type</a></li>
+<li><a href="types.html#_primitive-type-int">4.5.6. Primitive Type int</a></li>
+<li><a href="types.html#_primitive-symbol-type">4.5.7. Primitive Symbol Type</a></li>
+</ul>
+</li>
+<li><a href="types.html#_primitive-n4js-types">4.6. Primitive N4JS Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_any-type">4.6.1. Any Type</a>
+<ul class="sectlevel4">
+<li><a href="types.html#any-type-semantics">4.6.1.1. Semantics</a></li>
+<li><a href="types.html#any-type-type-inference">4.6.1.2. Type Inference</a>
+<ul class="sectlevel5">
+<li><a href="types.html#_default-type-of-variables">4.6.1.2.1. Default Type of Variables</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="types.html#_void-type">4.6.2. Void Type</a>
+<ul class="sectlevel4">
+<li><a href="types.html#void-type-semantics">4.6.2.1. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_unknown-type">4.6.3. Unknown Type</a></li>
+<li><a href="types.html#_primitive-pathselector-and-i18nkey">4.6.4. Primitive Pathselector and I18nKey</a>
+<ul class="sectlevel4">
+<li><a href="types.html#pathselector-semantics">4.6.4.1. Semantics</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="types.html#_built-in-ecmascript-object-types">4.7. Built-in ECMAScript Object Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#ECMAScript-objects-semantics">4.7.1. Semantics</a></li>
+<li><a href="types.html#_object-type">4.7.2. Object Type</a></li>
+<li><a href="types.html#_function-object-type">4.7.3. Function-Object-Type</a></li>
+<li><a href="types.html#_array-object-type">4.7.4. Array Object Type</a></li>
+<li><a href="types.html#_string-object-type">4.7.5. String Object Type</a></li>
+<li><a href="types.html#_boolean-object-type">4.7.6. Boolean Object Type</a></li>
+<li><a href="types.html#_number-object-type">4.7.7. Number Object Type</a></li>
+<li><a href="types.html#_global-object-type">4.7.8. Global Object Type</a></li>
+<li><a href="types.html#_symbol">4.7.9. Symbol</a></li>
+<li><a href="types.html#_promise">4.7.10. Promise</a></li>
+<li><a href="types.html#_iterator-interface">4.7.11. Iterator Interface</a></li>
+<li><a href="types.html#_iterable-interface">4.7.12. Iterable Interface</a></li>
+</ul>
+</li>
+<li><a href="types.html#_built-in-n4js-types">4.8. Built-In N4JS Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_n4object">4.8.1. N4Object</a>
+<ul class="sectlevel4">
+<li><a href="types.html#N4Object-semantics">4.8.1.1. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_n4class">4.8.2. N4Class</a></li>
+<li><a href="types.html#IterableN">4.8.3. IterableN</a></li>
+</ul>
+</li>
+<li><a href="types.html#_type-modifiers">4.9. Type Modifiers</a>
+<ul class="sectlevel3">
+<li><a href="types.html#Type_Modifiers_Dynamic">4.9.1. Dynamic</a></li>
+<li><a href="types.html#_optional-return-types">4.9.2. Optional Return Types</a></li>
+</ul>
+</li>
+<li><a href="types.html#_union-and-intersection-type-composed-types">4.10. Union and Intersection Type (Composed Types)</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_union-type">4.10.1. Union Type</a>
+<ul class="sectlevel4">
+<li><a href="types.html#union-type-syntax">4.10.1.1. Syntax</a></li>
+<li><a href="types.html#union-type-semantics">4.10.1.2. Semantics</a></li>
+<li><a href="types.html#_warnings">4.10.1.3. Warnings</a></li>
+</ul>
+</li>
+<li><a href="types.html#_intersection-type">4.10.2. Intersection Type</a>
+<ul class="sectlevel4">
+<li><a href="types.html#intersection-type-syntax">4.10.2.1. Syntax</a></li>
+<li><a href="types.html#intersection-type-semantics">4.10.2.2. Semantics</a></li>
+<li><a href="types.html#_warnings-2">4.10.2.3. Warnings</a></li>
+</ul>
+</li>
+<li><a href="types.html#_composed-types-in-wildcards">4.10.3. Composed Types in Wildcards</a></li>
+<li><a href="types.html#_property-access-for-composed-types">4.10.4. Property Access for Composed Types</a>
+<ul class="sectlevel4">
+<li><a href="types.html#_properties-of-union-type">4.10.4.1. Properties of Union Type</a>
+<ul class="sectlevel5">
+<li><a href="types.html#_remarks-on-union-type-s-members">4.10.4.1.1. Remarks on union type’s members:</a></li>
+</ul>
+</li>
+<li><a href="types.html#_properties-of-intersection-type">4.10.4.2. Properties of Intersection Type</a>
+<ul class="sectlevel5">
+<li><a href="types.html#_remarks-on-intersection-type-s-methods">4.10.4.2.1. Remarks on intersection type’s methods:</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="types.html#_constructor-and-classifier-type">4.11. Constructor and Classifier Type</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_syntax-3">4.11.1. Syntax</a></li>
+<li><a href="types.html#_semantics-2">4.11.2. Semantics</a></li>
+<li><a href="types.html#_constructors-and-prototypes-in-ecmascript-2015">4.11.3. Constructors and Prototypes in ECMAScript 2015</a></li>
+</ul>
+</li>
+<li><a href="types.html#_this-type">4.12. This Type</a>
+<ul class="sectlevel3">
+<li><a href="types.html#this-type-syntax">4.12.1. Syntax</a></li>
+<li><a href="types.html#this-keyword-semantics">4.12.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_enums">4.13. Enums</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_enums-n4js">4.13.1. Enums (N4JS)</a>
+<ul class="sectlevel4">
+<li><a href="types.html#enums-syntax">4.13.1.1. Syntax</a></li>
+<li><a href="types.html#enums-semantics">4.13.1.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_string-based-enums">4.13.2. String-Based Enums</a></li>
+</ul>
+</li>
+<li><a href="types.html#_short-hand-syntax">4.14. Short-Hand Syntax</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_array-short-hand-syntax">4.14.1. Array Short-Hand Syntax</a></li>
+<li><a href="types.html#_iterablen-short-hand-syntax">4.14.2. IterableN Short-Hand Syntax</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="classifiers.html#_classifiers">5. Classifiers</a>
+<ul class="sectlevel2">
+<li><a href="classifiers.html#_n4js-specific-classifiers">5.1. N4JS Specific Classifiers</a>
+<ul class="sectlevel3">
+<li><a href="classifiers.html#_properties-2">5.1.1. Properties</a></li>
+<li><a href="classifiers.html#_common-semantics-of-classifiers">5.1.2. Common Semantics of Classifiers</a></li>
+<li><a href="classifiers.html#_classes">5.1.3. Classes</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_definition-of-classes">5.1.3.1. Definition of Classes</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#class-syntax">5.1.3.1.1. Syntax</a></li>
+<li><a href="classifiers.html#class-properties">5.1.3.1.2. Properties</a></li>
+<li><a href="classifiers.html#class-type-inference">5.1.3.1.3. Type Inference</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#class-semantics">5.1.3.2. Semantics</a></li>
+<li><a href="classifiers.html#_final-modifier">5.1.3.3. Final Modifier</a></li>
+<li><a href="classifiers.html#_abstract-classes">5.1.3.4. Abstract Classes</a></li>
+<li><a href="classifiers.html#_non-instantiable-classes">5.1.3.5. Non-Instantiable Classes</a></li>
+<li><a href="classifiers.html#_superclass">5.1.3.6. Superclass</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_interfaces">5.1.4. Interfaces</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_definition-of-interfaces">5.1.4.1. Definition of Interfaces</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#interfaces-syntax">5.1.4.1.1. Syntax</a></li>
+<li><a href="classifiers.html#interfaces-properties">5.1.4.1.2. Properties</a></li>
+<li><a href="classifiers.html#interfaces-type-inference">5.1.4.1.3. Type Inference</a></li>
+<li><a href="classifiers.html#interfaces-semantics">5.1.4.1.4. Semantics</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="classifiers.html#_generic-classifiers">5.1.5. Generic Classifiers</a></li>
+<li><a href="classifiers.html#sec:definition-site-variance">5.1.6. Definition-Site Variance</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_members">5.2. Members</a>
+<ul class="sectlevel3">
+<li><a href="classifiers.html#_syntax-4">5.2.1. Syntax</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_properties-3">5.2.1.1. Properties</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_semantics-3">5.2.2. Semantics</a></li>
+<li><a href="classifiers.html#_methods">5.2.3. Methods</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_syntax-5">5.2.3.1. Syntax</a></li>
+<li><a href="classifiers.html#_properties-4">5.2.3.2. Properties</a></li>
+<li><a href="classifiers.html#_semantics-4">5.2.3.3. Semantics</a></li>
+<li><a href="classifiers.html#_final-methods">5.2.3.4. Final Methods</a></li>
+<li><a href="classifiers.html#_abstract-methods">5.2.3.5. Abstract Methods</a></li>
+<li><a href="classifiers.html#_generic-methods">5.2.3.6. Generic Methods</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_default-methods-in-interfaces">5.2.4. Default Methods in Interfaces</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_asynchronous-methods">5.2.4.1. Asynchronous Methods</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_constructors">5.2.5. Constructors</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_structural-this-type-in-constructor">5.2.5.1. Structural This Type in Constructor</a></li>
+<li><a href="classifiers.html#spec-constructor">5.2.5.2. @Spec Constructor</a></li>
+<li><a href="classifiers.html#_callable-constructors">5.2.5.3. Callable Constructors</a></li>
+<li><a href="classifiers.html#_covariant-constructors">5.2.5.4. Covariant Constructors</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_data-fields">5.2.6. Data Fields</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#data-fields-syntax">5.2.6.1. Syntax</a></li>
+<li><a href="classifiers.html#data-fields-properties">5.2.6.2. Properties</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#data-fields-semantics">5.2.6.2.1. Semantics</a></li>
+<li><a href="classifiers.html#data-fields-type-inference">5.2.6.2.2. Type Inference</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_assignment-modifiers">5.2.6.3. Assignment Modifiers</a></li>
+<li><a href="classifiers.html#_field-accessors-getter-setter">5.2.6.4. Field Accessors (Getter/Setter)</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#field-acessors-syntax">5.2.6.4.1. Syntax</a></li>
+<li><a href="classifiers.html#field-acessors-properties">5.2.6.4.2. Properties</a></li>
+<li><a href="classifiers.html#field-accessors-semantics">5.2.6.4.3. Semantics</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#optional-fields">5.2.6.5. Optional Fields</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#_syntax-6">5.2.6.5.1. Syntax</a></li>
+<li><a href="classifiers.html#_semantics-5">5.2.6.5.2. Semantics</a></li>
+<li><a href="classifiers.html#_background">5.2.6.5.3. Background</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="classifiers.html#_static-members">5.2.7. Static Members</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_access-from-and-to-static-members">5.2.7.1. Access From and To Static Members</a></li>
+<li><a href="classifiers.html#_generic-static-methods">5.2.7.2. Generic static methods</a></li>
+<li><a href="classifiers.html#_static-members-of-interfaces">5.2.7.3. Static Members of Interfaces</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_redefinition-of-members">5.2.8. Redefinition of Members</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_overriding-of-members">5.2.8.1. Overriding of Members</a></li>
+<li><a href="classifiers.html#_implementation-of-members">5.2.8.2. Implementation of Members</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#_member-consumption">5.2.8.2.1. Member Consumption</a></li>
+<li><a href="classifiers.html#_member-implementation">5.2.8.2.2. Member Implementation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="classifiers.html#_structural-typing">5.3. Structural Typing</a>
+<ul class="sectlevel3">
+<li><a href="classifiers.html#_syntax-7">5.3.1. Syntax</a></li>
+<li><a href="classifiers.html#_definition-site-structural-typing">5.3.2. Definition Site Structural Typing</a></li>
+<li><a href="classifiers.html#_use-site-structural-typing">5.3.3. Use-Site Structural Typing</a></li>
+<li><a href="classifiers.html#structural-readWriteInit-field-typing">5.3.4. Structural Read-only, Write-only and Initializer Field Typing</a></li>
+<li><a href="classifiers.html#_public-setter-annotated-with-code-providesinitializer-code">5.3.5. Public Setter Annotated With <code>ProvidesInitializer</code></a></li>
+<li><a href="classifiers.html#_structural-types-with-optional-fields">5.3.6. Structural Types With Optional Fields</a></li>
+<li><a href="classifiers.html#_structural-types-with-access-modifier">5.3.7. Structural Types With Access Modifier</a></li>
+<li><a href="classifiers.html#_structural-types-with-additional-members">5.3.8. Structural Types With Additional Members</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_syntax-8">5.3.8.1. Syntax</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#_semantics-6">5.3.8.1.1. Semantics</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="functions.html#_functions">6. Functions</a>
+<ul class="sectlevel2">
+<li><a href="functions.html#_function-type">6.1. Function Type</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_properties-5">6.1.1. Properties</a></li>
+<li><a href="functions.html#function-type-inference">6.1.2. Type Inference</a></li>
+<li><a href="functions.html#_autoboxing-of-function-type">6.1.3. Autoboxing of Function Type</a></li>
+<li><a href="functions.html#_arguments-object">6.1.4. Arguments Object</a></li>
+</ul>
+</li>
+<li><a href="functions.html#_ecmascript-5-function-definition">6.2. ECMAScript 5 Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_function-declaration">6.2.1. Function Declaration</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#_syntax-9">6.2.1.1. Syntax</a></li>
+<li><a href="functions.html#_semantics-8">6.2.1.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="functions.html#_function-expression">6.2.2. Function Expression</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#function-expression-syntax">6.2.2.1. Syntax</a></li>
+<li><a href="functions.html#_semantics-and-type-inference">6.2.2.2. Semantics and Type Inference</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="functions.html#_ecmascript-2015-function-definition">6.3. ECMAScript 2015 Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_formal-parameters">6.3.1. Formal Parameters</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#Type_Modifiers_Optional">6.3.1.1. Optional Parameters</a></li>
+<li><a href="functions.html#Type_Modifiers_Default">6.3.1.2. Default Parameters</a></li>
+<li><a href="functions.html#Type_Modifiers_Variadic">6.3.1.3. Variadic</a></li>
+</ul>
+</li>
+<li><a href="functions.html#_generator-functions">6.3.2. Generator Functions</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#generator-functions-syntax">6.3.2.1. Syntax</a></li>
+<li><a href="functions.html#generator-functions-semantics">6.3.2.2. Semantics</a></li>
+<li><a href="functions.html#_generator-arrow-functions">6.3.2.3. Generator Arrow Functions</a></li>
+</ul>
+</li>
+<li><a href="functions.html#_arrow-function-expression">6.3.3. Arrow Function Expression</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#arrow-function-expression-syntax">6.3.3.1. Syntax</a></li>
+<li><a href="functions.html#arrow-function-expression-semantics-and-type-inference">6.3.3.2. Semantics and Type Inference</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="functions.html#_ecmascript-proposals-function-definition">6.4. ECMAScript Proposals Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_asynchronous-functions">6.4.1. Asynchronous Functions</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#asynchronous-functions-syntax">6.4.1.1. Syntax</a></li>
+<li><a href="functions.html#asynchronous-functions-semantics">6.4.1.2. Semantics</a></li>
+<li><a href="functions.html#_asynchronous-arrow-functions">6.4.1.3. Asynchronous Arrow Functions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="functions.html#_n4js-extended-function-definition">6.5. N4JS Extended Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_generic-functions">6.5.1. Generic Functions</a></li>
+<li><a href="functions.html#_promisifiable-functions">6.5.2. Promisifiable Functions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_conversions-and-reflection">7. Conversions and Reflection</a>
+<ul class="sectlevel2">
+<li><a href="conversions_and_reflection.html#_autoboxing-and-coercing">7.1. Autoboxing and Coercing</a>
+<ul class="sectlevel3">
+<li><a href="conversions_and_reflection.html#_coercing">7.1.1. Coercing</a></li>
+<li><a href="conversions_and_reflection.html#_autoboxing-of-primitives">7.1.2. Autoboxing of Primitives</a></li>
+<li><a href="conversions_and_reflection.html#_autoboxing-of-function-expressions-and-declarations">7.1.3. Autoboxing of Function Expressions and Declarations</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_auto-conversion-of-objects">7.2. Auto-Conversion of Objects</a>
+<ul class="sectlevel3">
+<li><a href="conversions_and_reflection.html#_auto-conversion-of-class-instances">7.2.1. Auto-Conversion of Class Instances</a>
+<ul class="sectlevel4">
+<li><a href="conversions_and_reflection.html#_auto-conversion-of-interface-instances">7.2.1.1. Auto-Conversion of Interface Instances</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_auto-conversion-of-enum-literals">7.2.2. Auto-Conversion of Enum Literals</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_type-cast-and-type-check">7.3. Type Cast and Type Check</a>
+<ul class="sectlevel3">
+<li><a href="conversions_and_reflection.html#_type-cast">7.3.1. Type Cast</a></li>
+<li><a href="conversions_and_reflection.html#_type-check">7.3.2. Type Check</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_reflection-meta-information">7.4. Reflection meta-information</a>
+<ul class="sectlevel3">
+<li><a href="conversions_and_reflection.html#_reflection-for-classes">7.4.1. Reflection for Classes</a></li>
+<li><a href="conversions_and_reflection.html#_reflection-for-interfaces">7.4.2. Reflection for Interfaces</a></li>
+<li><a href="conversions_and_reflection.html#_reflection-for-enumerations">7.4.3. Reflection for Enumerations</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_conversion-of-primitive-types">7.5. Conversion of primitive types</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_expressions">8. Expressions</a>
+<ul class="sectlevel2">
+<li><a href="expressions.html#_ecmascript-5-expressions">8.1. ECMAScript 5 Expressions</a>
+<ul class="sectlevel3">
+<li><a href="expressions.html#_the-this-literal">8.1.1. The this Literal</a></li>
+<li><a href="expressions.html#_identifier">8.1.2. Identifier</a></li>
+<li><a href="expressions.html#_literals">8.1.3. Literals</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#_integer-literals">8.1.3.1. Integer Literals</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_array-literal">8.1.4. Array Literal</a></li>
+<li><a href="expressions.html#_object-literal">8.1.5. Object Literal</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#_properties-6">8.1.5.1. Properties</a></li>
+<li><a href="expressions.html#_scoping-and-linking">8.1.5.2. Scoping and linking</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_parenthesized-expression-and-grouping-operator">8.1.6. Parenthesized Expression and Grouping Operator</a></li>
+<li><a href="expressions.html#_property-accessors">8.1.7. Property Accessors</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#properties-1">8.1.7.1. Properties</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_new-expression">8.1.8. New Expression</a></li>
+<li><a href="expressions.html#_function-expression-2">8.1.9. Function Expression</a></li>
+<li><a href="expressions.html#_function-calls">8.1.10. Function Calls</a></li>
+<li><a href="expressions.html#_postfix-expression">8.1.11. Postfix Expression</a></li>
+<li><a href="expressions.html#_unary-expression">8.1.12. Unary Expression</a></li>
+<li><a href="expressions.html#_multiplicative-expression">8.1.13. Multiplicative Expression</a></li>
+<li><a href="expressions.html#_additive-expression">8.1.14. Additive Expression</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#type-inference-10">8.1.14.1. Type Inference</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_bitwise-shift-expression">8.1.15. Bitwise Shift Expression</a></li>
+<li><a href="expressions.html#_relational-expression">8.1.16. Relational Expression</a></li>
+<li><a href="expressions.html#_equality-expression">8.1.17. Equality Expression</a></li>
+<li><a href="expressions.html#_binary-bitwise-expression">8.1.18. Binary Bitwise Expression</a></li>
+<li><a href="expressions.html#_binary-logical-expression">8.1.19. Binary Logical Expression</a></li>
+<li><a href="expressions.html#_conditional-expression">8.1.20. Conditional Expression</a></li>
+<li><a href="expressions.html#_assignment-expression">8.1.21. Assignment Expression</a></li>
+<li><a href="expressions.html#_comma-expression">8.1.22. Comma Expression</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_ecmascript-6-expressions">8.2. ECMAScript 6 Expressions</a>
+<ul class="sectlevel3">
+<li><a href="expressions.html#_the-super-keyword">8.2.1. The super Keyword</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_ecmascript-7-expressions">8.3. ECMAScript 7 Expressions</a>
+<ul class="sectlevel3">
+<li><a href="expressions.html#_await-expression">8.3.1. Await Expression</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_n4js-specific-expressions">8.4. N4JS Specific Expressions</a>
+<ul class="sectlevel3">
+<li><a href="expressions.html#_class-expression">8.4.1. Class Expression</a></li>
+<li><a href="expressions.html#_cast-as-expression">8.4.2. Cast (As) Expression</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#cast-as-expression-semantics-type-inference">8.4.2.1. Semantics and Type Inference</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#Import_Calls">8.4.3. Import Calls</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#compile-time-expressions">8.5. Compile-Time Expressions</a></li>
+</ul>
+</li>
+<li><a href="statements.html#_statements">9. Statements</a>
+<ul class="sectlevel2">
+<li><a href="statements.html#_ecmascript-5-statements">9.1. ECMAScript 5 Statements</a>
+<ul class="sectlevel3">
+<li><a href="statements.html#_function-or-field-accessor-bodies">9.1.1. Function or Field Accessor Bodies</a></li>
+<li><a href="statements.html#_variable-statement">9.1.2. Variable Statement</a></li>
+<li><a href="statements.html#_if-statement">9.1.3. If Statement</a></li>
+<li><a href="statements.html#_iteration-statements">9.1.4. Iteration Statements</a></li>
+<li><a href="statements.html#_return-statement">9.1.5. Return Statement</a></li>
+<li><a href="statements.html#_with-statement">9.1.6. With Statement</a></li>
+<li><a href="statements.html#_switch-statement">9.1.7. Switch Statement</a></li>
+<li><a href="statements.html#_throw-try-and-catch-statements">9.1.8. Throw, Try, and Catch Statements</a></li>
+<li><a href="statements.html#_debugger-statement">9.1.9. Debugger Statement</a></li>
+</ul>
+</li>
+<li><a href="statements.html#_ecmascript-6-statements">9.2. ECMAScript 6 Statements</a>
+<ul class="sectlevel3">
+<li><a href="statements.html#_let">9.2.1. Let</a></li>
+<li><a href="statements.html#_const">9.2.2. Const</a></li>
+<li><a href="statements.html#_for-of-statement">9.2.3. <code>for &#8230;&#8203; of</code> statement</a></li>
+<li><a href="statements.html#_import-statement">9.2.4. Import Statement</a>
+<ul class="sectlevel4">
+<li><a href="statements.html#Dynamic_Imports">9.2.4.1. Dynamic Imports</a></li>
+<li><a href="statements.html#_immutabilaty-of-imports">9.2.4.2. Immutabilaty of Imports</a></li>
+</ul>
+</li>
+<li><a href="statements.html#_export-statement">9.2.5. Export Statement</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="annotations.html#_annotations">10. Annotations</a>
+<ul class="sectlevel2">
+<li><a href="annotations.html#_introduction-2">10.1. Introduction</a>
+<ul class="sectlevel3">
+<li><a href="annotations.html#_syntax-13">10.1.1. Syntax</a></li>
+<li><a href="annotations.html#_properties-7">10.1.2. Properties</a></li>
+<li><a href="annotations.html#_element-specific-annotations">10.1.3. Element-Specific Annotations</a></li>
+<li><a href="annotations.html#_general-annotations">10.1.4. General Annotations</a>
+<ul class="sectlevel4">
+<li><a href="annotations.html#_idebug">10.1.4.1. IDEBUG</a></li>
+</ul>
+</li>
+<li><a href="annotations.html#idebug-syntax">10.1.5. Syntax</a>
+<ul class="sectlevel4">
+<li><a href="annotations.html#_semantics-11">10.1.5.1. Semantics</a></li>
+<li><a href="annotations.html#_suppress-warnings">10.1.5.2. Suppress Warnings</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="annotations.html#_declaration-of-annotations">10.2. Declaration of Annotations</a></li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_extended-fetaures">11. Extended Fetaures</a>
+<ul class="sectlevel2">
+<li><a href="extended_fetaures.html#_array-and-object-destructuring">11.1. Array and Object Destructuring</a>
+<ul class="sectlevel3">
+<li><a href="extended_fetaures.html#_syntax-14">11.1.1. Syntax</a></li>
+<li><a href="extended_fetaures.html#_semantics-12">11.1.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_dependency-injection">11.2. Dependency Injection</a>
+<ul class="sectlevel3">
+<li><a href="extended_fetaures.html#_di-components-and-injectors">11.2.1. DI Components and Injectors</a>
+<ul class="sectlevel4">
+<li><a href="extended_fetaures.html#_dicomponent-relations">11.2.1.1. DIComponent Relations</a></li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_binders-and-bindings">11.2.2. Binders and Bindings</a></li>
+<li><a href="extended_fetaures.html#_injection-points">11.2.3. Injection Points</a>
+<ul class="sectlevel4">
+<li><a href="extended_fetaures.html#_field-injection">11.2.3.1. Field Injection</a></li>
+<li><a href="extended_fetaures.html#_constructor-injection">11.2.3.2. Constructor Injection</a></li>
+<li><a href="extended_fetaures.html#_method-injection">11.2.3.3. Method Injection</a>
+<ul class="sectlevel5">
+<li><a href="extended_fetaures.html#_provider">11.2.3.3.1. Provider</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_n4js-di-life-cycle-and-scopes">11.2.4. N4JS DI Life Cycle and Scopes</a>
+<ul class="sectlevel4">
+<li><a href="extended_fetaures.html#_injection-cylces">11.2.4.1. Injection Cylces</a></li>
+<li><a href="extended_fetaures.html#_default-scope">11.2.4.2. Default Scope</a></li>
+<li><a href="extended_fetaures.html#_singleton-scope">11.2.4.3. Singleton Scope</a></li>
+<li><a href="extended_fetaures.html#_per-injection-chain-singleton">11.2.4.4. Per Injection Chain Singleton</a></li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_validation-of-callsites-targeting-n4injector-methods">11.2.5. Validation of callsites targeting N4Injector methods</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-annotations">11.2.6. N4JS DI Annotations</a>
+<ul class="sectlevel4">
+<li><a href="extended_fetaures.html#_n4js-di-generateinjector">11.2.6.1. N4JS DI @GenerateInjector</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-withparentinjector">11.2.6.2. N4JS DI @WithParentInjector</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-usebinder">11.2.6.3. N4JS DI @UseBinder</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-binder">11.2.6.4. N4JS DI @Binder</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-bind">11.2.6.5. N4JS DI @Bind</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-provides">11.2.6.6. N4JS DI @Provides</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-inject">11.2.6.7. N4JS DI @Inject</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-singleton">11.2.6.8. N4JS DI @Singleton</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_test-support">11.3. Test Support</a></li>
+<li><a href="extended_fetaures.html#_polyfill-definitions">11.4. Polyfill Definitions</a>
+<ul class="sectlevel3">
+<li><a href="extended_fetaures.html#_runtime-polyfill-definitions">11.4.1. Runtime Polyfill Definitions</a></li>
+<li><a href="extended_fetaures.html#_static-polyfill-definitions">11.4.2. Static Polyfill Definitions</a></li>
+<li><a href="extended_fetaures.html#_transpiling-static-polyfilled-classes">11.4.3. Transpiling static polyfilled classes</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="components.html#_components">12. Components</a>
+<ul class="sectlevel2">
+<li><a href="components.html#_overview-2">12.1. Overview</a></li>
+<li><a href="components.html#Component_Types">12.2. Component Types</a>
+<ul class="sectlevel3">
+<li><a href="components.html#_libraries">12.2.1. Libraries</a></li>
+<li><a href="components.html#_runtime-environment-and-runtime-libraries">12.2.2. Runtime Environment and Runtime Libraries</a></li>
+<li><a href="components.html#_tests">12.2.3. Tests</a></li>
+<li><a href="components.html#_type-definitions">12.2.4. Type Definitions</a></li>
+</ul>
+</li>
+<li><a href="components.html#package-json">12.3. Package.json File</a>
+<ul class="sectlevel3">
+<li><a href="components.html#_basic-properties">12.3.1. Basic Properties</a></li>
+<li><a href="components.html#_n4js-properties">12.3.2. N4JS Properties</a></li>
+<li><a href="components.html#_constraints">12.3.3. Constraints</a></li>
+</ul>
+</li>
+<li><a href="components.html#_support-for-npm-scopes">12.4. Support for NPM Scopes</a></li>
+<li><a href="components.html#sec:N4JS-Type-Definitions">12.5. N4JS Type Definitions</a>
+<ul class="sectlevel3">
+<li><a href="components.html#_specify-type-definition">12.5.1. Specify Type Definition</a></li>
+<li><a href="components.html#_name-conventions">12.5.2. Name Conventions</a></li>
+<li><a href="components.html#_version-conventions">12.5.3. Version Conventions</a>
+<ul class="sectlevel4">
+<li><a href="components.html#_define-a-new-type-definition-package">12.5.3.1. Define a New Type Definition Package</a></li>
+<li><a href="components.html#_using-a-type-definition-package">12.5.3.2. Using a Type Definition Package</a></li>
+<li><a href="components.html#_rational">12.5.3.3. Rational</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="components.html#_modules">12.6. Modules</a></li>
+<li><a href="components.html#_api-and-implementation-component">12.7. API and Implementation Component</a>
+<ul class="sectlevel3">
+<li><a href="components.html#_execution-of-api-and-implementation-components">12.7.1. Execution of API and Implementation Components</a></li>
+<li><a href="components.html#_api-and-implementation-with-di">12.7.2. API and Implementation With DI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="plainjs.html#_plainjs">13. PlainJS</a>
+<ul class="sectlevel2">
+<li><a href="plainjs.html#_type-inference-and-validation-for-plain-js">13.1. Type Inference and Validation for Plain JS</a></li>
+<li><a href="plainjs.html#_external-declarations">13.2. External Declarations</a>
+<ul class="sectlevel3">
+<li><a href="plainjs.html#_declaring-externals">13.2.1. Declaring externals</a></li>
+<li><a href="plainjs.html#_instantiating-external-classes">13.2.2. Instantiating external classes</a></li>
+<li><a href="plainjs.html#_implementation-of-external-declarations">13.2.3. Implementation of External Declarations</a></li>
+<li><a href="plainjs.html#_example">13.2.4. Example</a></li>
+</ul>
+</li>
+<li><a href="plainjs.html#_global-definitions">13.3. Global Definitions</a></li>
+<li><a href="plainjs.html#_runtime-definitions">13.4. Runtime Definitions</a></li>
+<li><a href="plainjs.html#_applying-polyfills">13.5. Applying Polyfills</a></li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_jsdoc-2">14. JSDoc</a>
+<ul class="sectlevel2">
+<li><a href="jsdoc.html#_general-n4jsdoc-features">14.1. General N4JSDoc Features</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#_provided-inline-tags">14.1.1. Provided Inline Tags</a>
+<ul class="sectlevel4">
+<li><a href="jsdoc.html#jsdoc_tag__code">14.1.1.1. @code</a></li>
+<li><a href="jsdoc.html#jsdoc_tag__link">14.1.1.2. @link</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_n4jsdoc-for-user-projects">14.2. N4JSdoc for User Projects</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#_standard-tags">14.2.1. Standard Tags</a>
+<ul class="sectlevel4">
+<li><a href="jsdoc.html#_-author">14.2.1.1. @author</a></li>
+<li><a href="jsdoc.html#jsdoc_tag_param">14.2.1.2. @param</a></li>
+<li><a href="jsdoc.html#jsdoc_tag_return">14.2.1.3. @return</a></li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_test-related-tags">14.2.2. Test Related Tags</a>
+<ul class="sectlevel4">
+<li><a href="jsdoc.html#jsdoc_tag__testee">14.2.2.1. @testee</a></li>
+<li><a href="jsdoc.html#jsdoc_tag__testeeFromType">14.2.2.2. @testeeFromType</a></li>
+<li><a href="jsdoc.html#_testeeType_and__testeeMember">14.2.2.3. @testeeType and @testeeMember</a></li>
+<li><a href="jsdoc.html#jsdoc_tag_reqid_in_Tests">14.2.2.4. @reqid in Tests</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_n4jsdoc-for-api-and-implementation-projects">14.3. N4JSDoc for API and Implementation Projects</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#jsdoc_tag__apiNote">14.3.1. @apiNote</a></li>
+<li><a href="jsdoc.html#API_Project_Tags">14.3.2. API Project Tags</a>
+<ul class="sectlevel4">
+<li><a href="jsdoc.html#jsdoc_tag_apiState">14.3.2.1. @apiState</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsx.html#_jsx">15. JSX</a>
+<ul class="sectlevel2">
+<li><a href="jsx.html#_jsx-support">15.1. JSX Support</a></li>
+<li><a href="jsx.html#_jsx-backend">15.2. JSX Backend</a></li>
+</ul>
+</li>
+<li><a href="grammars.html#_grammars">16. Grammars</a>
+<ul class="sectlevel2">
+<li><a href="grammars.html#_type-expressions-grammar">16.1. Type Expressions Grammar</a></li>
+<li><a href="grammars.html#_n4js-language-grammar">16.2. N4JS Language Grammar</a></li>
+</ul>
+</li>
+<li><a href="#_jsobjects">17. JSObjects</a>
+<ul class="sectlevel2">
+<li><a href="#_object">17.1. Object</a></li>
+<li><a href="#_string">17.2. String</a></li>
+<li><a href="#_boolean">17.3. Boolean</a></li>
+<li><a href="#_number">17.4. Number</a>
+<ul class="sectlevel3">
+<li><a href="#_static-attributes">17.4.1. Static Attributes</a></li>
+</ul>
+</li>
+<li><a href="#function">17.5. Function</a></li>
+<li><a href="#_error">17.6. Error</a></li>
+<li><a href="#_array">17.7. Array</a></li>
+<li><a href="#_date">17.8. Date</a></li>
+<li><a href="#_math">17.9. Math</a>
+<ul class="sectlevel3">
+<li><a href="#static-attributes-1">17.9.1. Static Attributes</a></li>
+</ul>
+</li>
+<li><a href="#_regexp">17.10. RegExp</a></li>
+<li><a href="#_json">17.11. JSON</a></li>
+</ul>
+</li>
+<li><a href="n4js_objects.html#_n4js-objects">18. N4JS Objects</a>
+<ul class="sectlevel2">
+<li><a href="n4js_objects.html#_reflection-model">18.1. Reflection Model</a></li>
+<li><a href="n4js_objects.html#_error-types">18.2. Error Types</a>
+<ul class="sectlevel3">
+<li><a href="n4js_objects.html#_n4apinotimplemented">18.2.1. N4ApiNotImplemented</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_acronyms.html#_acronyms">Appendix A: Acronyms</a></li>
+<li><a href="appendix_b_license.html#sec:License">Appendix B: License</a></li>
+<li><a href="appendix_c_bibliography.html#_bibliography">Appendix C: Bibliography</a></li>
+</ul>
+</div>
+</div>
+<div id="content"><div class="sect1">
+<h2 id="_jsobjects"><a class="anchor" href="#_jsobjects"></a><a class="link" href="#_jsobjects">17. JSObjects</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>The built-in ECMAScript Objects
+[<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.S15, p.p.102)</a>] are supported and their properties are annotated with types as described in this chapter. The semantics of these properties do not change. The short description is copied from [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a</a>] repeated here for convenience.</p>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="_object"><a class="anchor" href="#_object"></a><a class="link" href="#_object">17.1. Object</a></h3>
+<div class="paragraph">
+<p><code>Object</code> is the super type of all declared types and <code>N4Object</code>. It is almost similar to the JavaScript type <code>Object</code> except that no properties may be dynamically added to it. In order to declare a variable to which properties can be dynamically added, the <code>Object+</code> type has to be declared (cf.
+<a href="#_dynamic">[_dynamic]</a>).</p>
+</div>
+<h4 id="_attributes" class="discrete">Attributes</h4>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><code>constructor:Object</code></dt>
+<dd>
+<p>Returns a reference to the Object function that created the instance’s
+prototype.</p>
+</dd>
+</dl>
+</div>
+<h4 id="_methods-2" class="discrete">Methods</h4>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><code>toString():Object</code></dt>
+<dd>
+<p>Returns a string representing the specified object.</p>
+</dd>
+<dt class="hdlist1"><code>toLocaleString():Object</code></dt>
+<dd>
+<p>Returns a string representing the object. This method is meant to be
+overridden by derived objects for locale-specific purposes.</p>
+</dd>
+<dt class="hdlist1"><code>valueOf():Object</code></dt>
+<dd>
+<p>Returns the primitive value of the specified object.</p>
+</dd>
+<dt class="hdlist1"><code>hasOwnProperty(prop:String):Boolean</code></dt>
+<dd>
+<p>Returns a boolean indicating whether an object contains the specified
+property as a direct property of that object and not inherited through
+the prototype chain.</p>
+</dd>
+<dt class="hdlist1"><code>isPrototypeOf(object:Object):Boolean</code></dt>
+<dd>
+<p>Returns a boolean indication whether the specified object is in the
+prototype chain of the object this method is called upon.</p>
+</dd>
+<dt class="hdlist1"><code>propertyIsEnumerable(prop:String):Boolean</code></dt>
+<dd>
+<p>Returns a boolean indicating if the internal ECMAScript DontEnum
+attribute is set.</p>
+</dd>
+</dl>
+</div>
+<h4 id="_static-methods" class="discrete">Static Methods</h4>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><code>getPrototypeOf(object:Object):Object</code></dt>
+<dd>
+<p>Returns the prototype of the specified object.</p>
+</dd>
+<dt class="hdlist1"><code>create(object:Object,properties:Object=):Object</code></dt>
+<dd>
+<p>Creates a new object with the specified prototype object and properties.</p>
+</dd>
+<dt class="hdlist1"><code>defineProperty(object:Object,prop:Object,descriptor:Object):Object</code></dt>
+<dd>
+<p>Defines a new property directly on an object or modifies an existing
+property on an object and returns the object.</p>
+</dd>
+<dt class="hdlist1"><code>defineProperties(object:Object,properties:Object):Object</code></dt>
+<dd>
+<p>Defines new or modifies existing properties directly on an object,
+returning the object.</p>
+</dd>
+<dt class="hdlist1"><code>seal(object:Object,properties:Object)</code></dt>
+<dd>
+<p>Seals an object, preventing new properties from being added to it and
+marking all existing properties as non-configurable. Values of present
+properties can still be changed as long as they are writable.</p>
+</dd>
+<dt class="hdlist1"><code>freeze(object:Object):Object</code></dt>
+<dd>
+<p>Freezes an object: that is, prevents new properties from being added to it, prevents existing properties from being removed, prevents existing properties or their enumerability, configurability, or writability from being changed.
+In essence, the object is made effectively immutable.
+The method returns the object being frozen.</p>
+</dd>
+<dt class="hdlist1"><code>preventExtensions(object:Object):Object</code></dt>
+<dd>
+<p>Prevents new properties from ever being added to an object (i.e.
+prevents future extensions to the object).</p>
+</dd>
+<dt class="hdlist1"><code>isSealed(object:Object):Boolean static</code></dt>
+<dd>
+<p>Determine if an object is sealed.</p>
+</dd>
+<dt class="hdlist1"><code>isFrozen(object:Object):Boolean</code></dt>
+<dd>
+<p>Determine if an object is frozen.</p>
+</dd>
+<dt class="hdlist1"><code>isExtensible(object:Object):Boolean</code></dt>
+<dd>
+<p>Determines if an object is extensible (whether it can have new
+properties added to it).</p>
+</dd>
+<dt class="hdlist1"><code>keys(object:Object):Array&lt;String&gt;</code></dt>
+<dd>
+<p>Returns an array of all own enumerable properties found upon a given
+object in the same order as that provided by a for-in loop (the
+difference being that a for-in loop enumerates properties in the
+prototype chain as well).</p>
+</dd>
+</dl>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="_string"><a class="anchor" href="#_string"></a><a class="link" href="#_string">17.2. String</a></h3>
+<div class="paragraph">
+<p>String is a global object that may be used to construct String
+instances and is a sub class of Object.</p>
+</div>
+<h4 id="string-attributes" class="discrete">Attributes</h4>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><code>number: length</code> </dt>
+<dd>
+<p>The length of a string.</p>
+</dd>
+</dl>
+</div>
+<h4 id="methods-1" class="discrete">Methods</h4>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><code>String(thing:Object=)</code></dt>
+<dd>
+<p>-</p>
+</dd>
+<dt class="hdlist1"><code>anchor(anchorname:String):String</code></dt>
+<dd>
+<p>Creates an HTML anchor.</p>
+</dd>
+<dt class="hdlist1"><code>big():String</code></dt>
+<dd>
+<p>Returns a string in a big font.</p>
+</dd>
+<dt class="hdlist1"><code>blink():String</code></dt>
+<dd>
+<p>Returns a string in a blinking string.</p>
+</dd>
+<dt class="hdlist1"><code>bold():String</code></dt>
+<dd>
+<p>Returns a string in a bold font.</p>
+</dd>
+<dt class="hdlist1"><code>charAt(index:Number):String</code></dt>
+<dd>
+<p>Returns the character at a specified position.</p>
+</dd>
+<dt class="hdlist1"><code>charCodeAt(index:Number):Number</code></dt>
+<dd>
+<p>Returns the Unicode of the character at a specified position.</p>
+</dd>
+<dt class="hdlist1"><code>concat(strings:String&#8230;&#8203;):String</code></dt>
+<dd>
+<p>Joins two or more strings.</p>
+</dd>
+<dt class="hdlist1"><code>equals(object:Object):Boolean</code> </dt>
+<dd>
+<p>-</p>
+</dd>
+<dt class="hdlist1"><code>equalsIgnoreCase(object:Object):Boolean</code>  </dt>
+<dd>
+<p>-</p>
+</dd>
+<dt class="hdlist1"><code>fromCharCode(num:Any&#8230;&#8203;):String</code></dt>
+<dd>
+<p>Returns a string created by using the specified sequence of Unicode values.</p>
+</dd>
+<dt class="hdlist1"><code>fixed():String</code></dt>
+<dd>
+<p>Returns a string as teletype text.</p>
+</dd>
+<dt class="hdlist1"><code>fontcolor(color):String</code></dt>
+<dd>
+<p>Returns a string in a specified color.</p>
+</dd>
+<dt class="hdlist1"><code>fontsize(size):String</code></dt>
+<dd>
+<p>Returns a string in a specified size.</p>
+</dd>
+<dt class="hdlist1"><code>indexOf(searchValue, fromIndex:Number=):Number</code></dt>
+<dd>
+<p>Returns the position of the first occurrence of a specified string value in a string.</p>
+</dd>
+<dt class="hdlist1"><code>italics():String</code></dt>
+<dd>
+<p>Returns a string in italic.</p>
+</dd>
+<dt class="hdlist1"><code>lastIndexOf(searchValue, fromIndex:Number=):Number</code></dt>
+<dd>
+<p>Returns the position of the last occurrence of a specified string value, searching backwards from the specified position in a string.</p>
+</dd>
+<dt class="hdlist1"><code>link(url):String</code></dt>
+<dd>
+<p>Returns a string as a hyperlink.</p>
+</dd>
+<dt class="hdlist1"><code>localeCompare(otherString):Number</code></dt>
+<dd>
+<p>This method returns a number indicating whether a reference string comes before or after or is the same as the given string in sort order.</p>
+</dd>
+<dt class="hdlist1"><code>match(search value):String</code></dt>
+<dd>
+<p>Searches for a specified value in a string.</p>
+</dd>
+<dt class="hdlist1"><code>replace(findString,newString):String</code></dt>
+<dd>
+<p>Replaces some characters with some other characters in a string.</p>
+</dd>
+<dt class="hdlist1"><code>search(search string):Number</code></dt>
+<dd>
+<p>Searches a string for a specified value.</p>
+</dd>
+<dt class="hdlist1"><code>slice(beginSlice:Number, endSclice:Number=):String</code></dt>
+<dd>
+<p>Extracts a part of a string and returns the extracted part in a new string.</p>
+</dd>
+<dt class="hdlist1"><code>small():String</code></dt>
+<dd>
+<p>Returns a string in a small font.</p>
+</dd>
+<dt class="hdlist1"><code>split(separator, howmany:Number=):Array&lt;String&gt;</code></dt>
+<dd>
+<p>Splits a string into an array of strings.</p>
+</dd>
+<dt class="hdlist1"><code>strike():String</code></dt>
+<dd>
+<p>Returns a string with a strikethrough.</p>
+</dd>
+<dt class="hdlist1"><code>sub():String</code></dt>
+<dd>
+<p>Returns a string as subscript.</p>
+</dd>
+<dt class="hdlist1"><code>substr(start:Number,length:Number=):String</code></dt>
+<dd>
+<p>Extracts a specified number of characters in a string, from a start index.</p>
+</dd>
+<dt class="hdlist1"><code>substring(beginIndex:number,endIndex:Number=):String</code></dt>
+<dd>
+<p>Extracts the characters in a string between two specified indices.</p>
+</dd>
+<dt class="hdlist1"><code>sup():String</code></dt>
+<dd>
+<p>Returns a string as superscript.</p>
+</dd>
+<dt class="hdlist1"><code>toLocaleUpperCase():String</code></dt>
+<dd>
+<p>Returns a string in lowercase letters.</p>
+</dd>
+<dt class="hdlist1"><code>toString():String</code></dt>
+<dd>
+<p>Returns a String value for this object.</p>
+</dd>
+<dt class="hdlist1"><code>toUpperCase():String</code></dt>
+<dd>
+<p>Returns a string in uppercase letters.</p>
+</dd>
+<dt class="hdlist1"><code>valueOf():String</code></dt>
+<dd>
+<p>Returns the primitive value of a String object.</p>
+</dd>
+</dl>
+</div>
+<h4 id="static-methods-1" class="discrete">Static Methods</h4>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><code>String(value:Object=)</code></dt>
+<dd>
+<p>Static constructor.</p>
+</dd>
+</dl>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="_boolean"><a class="anchor" href="#_boolean"></a><a class="link" href="#_boolean">17.3. Boolean</a></h3>
+<div class="paragraph">
+<p><code>Boolean</code> does not have a super class.</p>
+</div>
+<h4 id="static-methods-2" class="discrete">Static Methods</h4>
+<div class="paragraph">
+<p><code>Boolean(value:Object=):Boolean</code></p>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="_number"><a class="anchor" href="#_number"></a><a class="link" href="#_number">17.4. Number</a></h3>
+<div class="paragraph">
+<p><code>Number</code> does not have a super class.</p>
+</div>
+<div class="sect3">
+<h4 id="_static-attributes"><a class="anchor" href="#_static-attributes"></a><a class="link" href="#_static-attributes">17.4.1. Static Attributes</a></h4>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><code>MAX_VALUE:Number</code></dt>
+<dd>
+<p>The largest representable number.</p>
+</dd>
+<dt class="hdlist1"><code>MIN_VALUE:Number</code></dt>
+<dd>
+<p>The smallest representable number.</p>
+</dd>
+<dt class="hdlist1"><code>NaN:Number</code></dt>
+<dd>
+<p>Special 'not a number' value.</p>
+</dd>
+<dt class="hdlist1"><code>NEGATIVE_INFINITY:Number</code></dt>
+<dd>
+<p>Special value representing negative infinity, returned on overflow.</p>
+</dd>
+<dt class="hdlist1"><code>POSITIVE_INFINITY:Number</code></dt>
+<dd>
+<p>Special value representing infinity, returned on overflow.</p>
+</dd>
+</dl>
+</div>
+<h4 id="methods-2" class="discrete">Methods</h4>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><code>toExponential(numberOfDecimals:Number=):String</code></dt>
+<dd>
+<p>Converts the value of the object into an exponential notation.</p>
+</dd>
+<dt class="hdlist1"><code>toFixed(numberOfDecimals:Number=):String</code></dt>
+<dd>
+<p>Formats a number to the specified number of decimals.</p>
+</dd>
+<dt class="hdlist1"><code>toPrecision(numberOfDecimals:Number=):String</code></dt>
+<dd>
+<p>Converts a number into an exponential notation if it has more digits than specified.</p>
+</dd>
+<dt class="hdlist1"><code>valueOf():Number</code></dt>
+<dd>
+<p>Returns the primitive value of a Number object.</p>
+</dd>
+<dt class="hdlist1"><code>toString(radix:Number=):String</code></dt>
+<dd>
+<p>Returns a String value for this object. The toString method parses its first argument and attempts to return a string representation in the specified radix (base).</p>
+</dd>
+<dt class="hdlist1"><code>toLocaleString(locales: String|[String]=undefined, options: <sub>r</sub>NumberFormatOptions=undefined): String</code></dt>
+<dd>
+<p>Returns a locale-specific String value for this object. The toLocalString accepts two optional arguments. The semantics of these arguments
+is defined in <a href="https://www.ecma-international.org/ecma-402/4.0/index.html#sup-number.prototype.tolocalestring">ECMA-402 (Internationalization API Specification)</a>.
+In N4JS, the base definition does not define that method, instead Number inherits <code>toLocaleString</code> from Object. The specialized
+definition is found in the runtime library <code>n4js-runtime-ecma402</code>.</p>
+</dd>
+</dl>
+</div>
+<h4 id="static-methods-3" class="discrete">Static Methods</h4>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><code>Number(value:Object=):Number</code></dt>
+<dd>
+<p>Static constructor.</p>
+</dd>
+</dl>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="function"><a class="anchor" href="#function"></a><a class="link" href="#function">17.5. Function</a></h3>
+<div class="paragraph">
+<p><code>Function</code> does not have a super class.</p>
+</div>
+<h4 id="attributes-2" class="discrete">Attributes</h4>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><code>prototype:Object</code></dt>
+<dd>
+<p>Allows the addition of properties to the instance of the object created by the constructor function.</p>
+</dd>
+<dt class="hdlist1"><code>length:Number</code></dt>
+<dd>
+<p>Specifies the number of arguments expected by the functio</p>
+</dd>
+</dl>
+</div>
+<h4 id="methods-3" class="discrete">Methods</h4>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><code>apply(thisArg,argsArray:Array=):Object</code></dt>
+<dd>
+<p>Applies the method of another object in the context of a different object (the calling object); arguments can be passed as an Array object.</p>
+</dd>
+<dt class="hdlist1"><code>call(thisArg,arg&#8230;&#8203;):Object</code></dt>
+<dd>
+<p>Calls (executes) a method of another object in the context of a different object (the calling object); arguments can be passed as they are.</p>
+</dd>
+<dt class="hdlist1"><code>bind(thisArg:Object,arg&#8230;&#8203;):Function</code></dt>
+<dd>
+<p>Creates a new function that, when called, itself calls this function in the context of the provided this value with a given sequence of arguments preceding any provided when the new function was called.</p>
+</dd>
+</dl>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="_error"><a class="anchor" href="#_error"></a><a class="link" href="#_error">17.6. Error</a></h3>
+<div class="paragraph">
+<p><code>Error</code> does not have a super class.</p>
+</div>
+<h4 id="attributes-3" class="discrete">Attributes</h4>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><code>name:String</code></dt>
+<dd>
+<p>Error name.</p>
+</dd>
+<dt class="hdlist1"><code>message:String</code></dt>
+<dd>
+<p>Error message.</p>
+</dd>
+</dl>
+</div>
+<h4 id="static-methods-4" class="discrete">Static Methods</h4>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><code>Error(message:Object=):Error</code></dt>
+<dd>
+<p>Static Constructor.</p>
+</dd>
+</dl>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="_array"><a class="anchor" href="#_array"></a><a class="link" href="#_array">17.7. Array</a></h3>
+<div class="paragraph">
+<p><code>Array</code> is a generic type with the type parameter <code>E</code> and  does not have a super class.</p>
+</div>
+<h4 id="methods-4" class="discrete">Methods</h4>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><code>concat(array&#8230;&#8203;):Array&lt;E&gt;)</code></dt>
+<dd>
+<p>Joins two or more arrays and returns the result.</p>
+</dd>
+<dt class="hdlist1"><code>every(callback:Function):Boolean</code></dt>
+<dd>
+<p>Tests whether all elements in the array pass the test implemented by the provided function. The callback will be called with 3 arguments (elementValue,elementIndex,traversedArray).</p>
+</dd>
+<dt class="hdlist1"><code>filter(callback:Function):Array&lt;E&gt;</code></dt>
+<dd>
+<p>Creates a new array with all elements that pass the test implemented by the provided function. The callback will be called with 3 arguments (elementValue,elementIndex,traversedArray).</p>
+</dd>
+<dt class="hdlist1"><code>forEach(callback:Function,thisArg=)</code></dt>
+<dd>
+<p>Calls a function for each element in the array. The callback will be called with 3 arguments (elementValue,elementIndex,traversedArray). Optionally with a thisObject argument to use as this when executing callback.</p>
+</dd>
+<dt class="hdlist1"><code>indexOf(searchElement,fromIndex=):Number</code></dt>
+<dd>
+<p>Returns the first index at which a given element can be found in the array, or -1 if it is not present.</p>
+</dd>
+<dt class="hdlist1"><code>join(separator=):String</code></dt>
+<dd>
+<p>Puts all the elements of an array into a string. The elements are separated by a specified delimiter.</p>
+</dd>
+<dt class="hdlist1"><code>lastIndexOf(searchElement,fromIndex=):Number</code></dt>
+<dd>
+<p>Returns the last (greatest) index of an element within the array equal to the specified value. Will return -1 if none are found.</p>
+</dd>
+<dt class="hdlist1"><code>length():Number</code></dt>
+<dd>
+<p>The length returns an integer representing the length of an array.</p>
+</dd>
+<dt class="hdlist1"><code>map(callback:Function,thisArg=):Array</code></dt>
+<dd>
+<p>Creates a new array with the results of calling a provided function on every element in this array. The callback will be called with 3 arguments (elementValue,elementIndex,traversedArray). Optionally, with a thisObject argument to use as this when executing callback.</p>
+</dd>
+<dt class="hdlist1"><code>pop():E</code></dt>
+<dd>
+<p>Removes and returns the last element of an array.</p>
+</dd>
+<dt class="hdlist1"><code>push(element&#8230;&#8203;):E</code></dt>
+<dd>
+<p>Adds one or more elements to the end of an array and returns the new length.</p>
+</dd>
+<dt class="hdlist1"><code>reverse():Array&lt;E&gt;</code></dt>
+<dd>
+<p>Reverses the order of the elements in an array.</p>
+</dd>
+<dt class="hdlist1"><code>shift()</code></dt>
+<dd>
+<p>Removes and returns the first element of an array.</p>
+</dd>
+<dt class="hdlist1"><code>slice(start:Number,end:Number=):Array&lt;E&gt;</code></dt>
+<dd>
+<p>Returns selected elements from an existing array.</p>
+</dd>
+<dt class="hdlist1"><code>some(callback:Function,thisArg=):Boolean</code></dt>
+<dd>
+<p>Tests whether some element in the array passes the test implemented by the provided function. The callback will be called with 3 arguments (elementValue,elementIndex,traversedArray). Optionally, with a thisObject argument to use as this when executing callback.</p>
+</dd>
+<dt class="hdlist1"><code>sort(sortByFunction:Function=):Array&lt;E&gt;</code></dt>
+<dd>
+<p>Sorts the elements of an array. The function will be called with 2 arguments (a,b).</p>
+</dd>
+<dt class="hdlist1"><code>splice(index:Number,how many:Number,element&#8230;&#8203;):Array&lt;E&gt;</code></dt>
+<dd>
+<p>Removes and adds new elements to an array. Returns the removed elements as an Array.</p>
+</dd>
+<dt class="hdlist1"><code>toLocaleString():String</code></dt>
+<dt class="hdlist1"><code>toString():String</code></dt>
+<dd>
+<p>Returns a String value for Array.</p>
+</dd>
+<dt class="hdlist1"><code>unshift(element&#8230;&#8203;):E</code></dt>
+<dd>
+<p>Adds one or more elements to the beginning of an array and returns the new length.</p>
+</dd>
+</dl>
+</div>
+<h4 id="static-methods-5" class="discrete">Static Methods</h4>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><code>Array(item:Object&#8230;&#8203;)</code></dt>
+<dd>
+<p>Static constructor.</p>
+</dd>
+</dl>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="_date"><a class="anchor" href="#_date"></a><a class="link" href="#_date">17.8. Date</a></h3>
+<div class="paragraph">
+<p><code>Date</code> does not have a super class.</p>
+</div>
+<h4 id="static-methods-6" class="discrete">Static Methods</h4>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><code>Date():Date</code></dt>
+<dd>
+<p>Static constructor.</p>
+</dd>
+<dt class="hdlist1"><code>Date(milliseconds:Number):Date</code></dt>
+<dd>
+<p>Constructor.</p>
+</dd>
+<dt class="hdlist1"><code>Date(date:Date):Date</code></dt>
+<dd>
+<p>Constructor.</p>
+</dd>
+<dt class="hdlist1"><code>Date(dateString:String):Date</code></dt>
+<dd>
+<p>Constructor.</p>
+</dd>
+<dt class="hdlist1"><code>Date(year:Number,month:Number,day=Number=,hour:Number=,minute:Number=,second:Number=,millisecond:Number=):Date</code></dt>
+<dd>
+<p>Constructor.</p>
+</dd>
+<dt class="hdlist1"><code>parse(dateString:String):Date</code></dt>
+<dd>
+<p>Parses a string representation of a date, and returns the number of milliseconds since midnight Jan 1, 1970.</p>
+</dd>
+<dt class="hdlist1"><code>now():Number</code></dt>
+<dd>
+<p>Returns the numeric value corresponding to the current time.</p>
+</dd>
+<dt class="hdlist1"><code>UTC(year:Number,month:Number,date:Number=,hrs:Number=,min:Number=,sec:Number=,ms:Number=):Number</code></dt>
+<dd>
+<p>UTC takes comma-delimited date parameters and returns the number of milliseconds between January 1, 1970, 00:00:00, Universal Time and the time you specified.</p>
+</dd>
+</dl>
+</div>
+<h4 id="methods-5" class="discrete">Methods</h4>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><code>getDate():Number</code></dt>
+<dd>
+<p>Returns the day of the month from a Date object (from 1-31).</p>
+</dd>
+<dt class="hdlist1"><code>getDay():Number</code></dt>
+<dd>
+<p>Returns the day of the week from a Date object (from 0-6).</p>
+</dd>
+<dt class="hdlist1"><code>getFullYear():Number</code></dt>
+<dd>
+<p>Returns the year, as a four-digit number.</p>
+</dd>
+<dt class="hdlist1"><code>getHours():Number</code></dt>
+<dd>
+<p>Returns the hour of a day (from 0-23).</p>
+</dd>
+<dt class="hdlist1"><code>getMilliseconds():Number</code></dt>
+<dd>
+<p>Returns the milliseconds of a Date object (from 0-999).</p>
+</dd>
+<dt class="hdlist1"><code>getMinutes():Number</code></dt>
+<dd>
+<p>Returns the minutes of a date (from 0-59).</p>
+</dd>
+<dt class="hdlist1"><code>getMonth():Number</code></dt>
+<dd>
+<p>Returns the month from a date (from 0-11).</p>
+</dd>
+<dt class="hdlist1"><code>getSeconds():Number</code></dt>
+<dd>
+<p>Returns the seconds of a date (from 0-59).</p>
+</dd>
+<dt class="hdlist1"><code>getTime():Number</code></dt>
+<dd>
+<p>Returns the number of milliseconds since midnight Jan 1, 1970.</p>
+</dd>
+<dt class="hdlist1"><code>valueOf():Number</code></dt>
+<dd>
+<p>Returns the primitive value of a Date object as a number data type, the number of milliseconds since midnight 01 January, 1970 UTC. This method is functionally equivalent to the getTime method.</p>
+</dd>
+<dt class="hdlist1"><code>getTimezoneOffset():Number</code></dt>
+<dd>
+<p>Returns the difference in minutes between local time and Greenwich Mean Time (GMT).</p>
+</dd>
+<dt class="hdlist1"><code>getUTCDate():Number</code></dt>
+<dd>
+<p>Returns the day of the month from a date according to Universal Time (from 1-31).</p>
+</dd>
+<dt class="hdlist1"><code>getUTCDay():Number</code></dt>
+<dd>
+<p>Returns the day of the week from a date according to Universal Time (from 0-6).</p>
+</dd>
+<dt class="hdlist1"><code>getUTCFullYear():Number</code></dt>
+<dd>
+<p>Returns the four-digit year from a date according to Universal Time.</p>
+</dd>
+<dt class="hdlist1"><code>getUTCHours():Number</code></dt>
+<dd>
+<p>Returns the hour of a date according to Universal Time (from 0-23).</p>
+</dd>
+<dt class="hdlist1"><code>getUTCMilliseconds():Number</code></dt>
+<dd>
+<p>Returns the milliseconds of a date according to Universal Time (from 0-999).</p>
+</dd>
+<dt class="hdlist1"><code>getUTCMinutes():Number</code></dt>
+<dd>
+<p>Returns the minutes of a date according to Universal Time (from 0-59).</p>
+</dd>
+<dt class="hdlist1"><code>getUTCMonth():Number</code></dt>
+<dd>
+<p>Returns the month from a Date object according to Universal Time (from 0-11).</p>
+</dd>
+<dt class="hdlist1"><code>getUTCSeconds():Number</code></dt>
+<dd>
+<p>Returns the seconds of a date according to Universal Time (from 0-59).</p>
+</dd>
+<dt class="hdlist1"><code>getYear():Number deprecated</code></dt>
+<dd>
+<p>Returns the year as a two-digit or a three/four-digit number, depending on the browser. Use getFullYear() instead!</p>
+</dd>
+<dt class="hdlist1"><code>setDate(day):Number</code></dt>
+<dd>
+<p>Sets the day of the month from a Date object (from 1-31).</p>
+</dd>
+<dt class="hdlist1"><code>setFullYear(full year, month=, day=):Number</code></dt>
+<dd>
+<p>Sets the year as a four-digit number.</p>
+</dd>
+<dt class="hdlist1"><code>setHours(hours,minutes=,seconds=,milis=):Number</code></dt>
+<dd>
+<p>Sets the hour of a day (from 0-23).</p>
+</dd>
+<dt class="hdlist1"><code>setMilliseconds(mills):Number</code></dt>
+<dd>
+<p>Sets the milliseconds of a Date object (from 0-999).</p>
+</dd>
+<dt class="hdlist1"><code>setMinutes(minutes,=seconds,=millis):Number</code></dt>
+<dd>
+<p>Sets the minutes of a date (from 0-59).</p>
+</dd>
+<dt class="hdlist1"><code>setMonth" directType="Number(month,day=):Number</code></dt>
+<dd>
+<p>Sets the month from a date (from 0-11).</p>
+</dd>
+<dt class="hdlist1"><code>setSeconds(seconds,millis=):number</code></dt>
+<dd>
+<p>Sets the seconds of a date (from 0-59).</p>
+</dd>
+<dt class="hdlist1"><code>setTime(mills):Number</code></dt>
+<dd>
+<p>Sets the number of milliseconds since midnight Jan 1, 1970.</p>
+</dd>
+<dt class="hdlist1"><code>setUTCDate(day):Number</code></dt>
+<dd>
+<p>Sets the day of the month from a date according to Universal Time (from 0-6).</p>
+</dd>
+<dt class="hdlist1"><code>setUTCFullYear(fullyear,month=,day=):Number</code></dt>
+<dd>
+<p>Sets the four-digit year from a date according to Universal Time.</p>
+</dd>
+<dt class="hdlist1"><code>setUTCHours(hours,minutes=,seconds=,millis=):Number</code></dt>
+<dd>
+<p>Sets the hour of a date according to Universal Time (from 0-23).</p>
+</dd>
+<dt class="hdlist1"><code>setUTCMilliseconds(mills):Number</code></dt>
+<dd>
+<p>Sets the milliseconds of a date according to Universal Time (from 0-999).</p>
+</dd>
+<dt class="hdlist1"><code>setUTCMinutes(minutes,seconds=,millis=):Number</code></dt>
+<dd>
+<p>Sets the minutes of a date according to Universal Time time (from 0-59).</p>
+</dd>
+<dt class="hdlist1"><code>setUTCMonth(month,day=):Number</code></dt>
+<dd>
+<p>Sets the month from a Date object according to Universal Time (from 0-11).</p>
+</dd>
+<dt class="hdlist1"><code>setUTCSeconds(seconds,millis=):Number</code></dt>
+<dd>
+<p>Sets the seconds of a date according to Universal Time (from 0-59).</p>
+</dd>
+<dt class="hdlist1"><code>setYear(year):Number deprecated</code></dt>
+<dd>
+<p>Sets the year, as a two-digit or a three/four-digit number, depending on the browser. Use setFullYear() instead!!</p>
+</dd>
+<dt class="hdlist1"><code>toDateString():String</code></dt>
+<dd>
+<p>Returns the date portion of a Date object in readable form.</p>
+</dd>
+<dt class="hdlist1"><code>toLocaleDateString(locales: String|[String]=undefined, options: <sub>r</sub>DateTimeFormatOptions=undefined): String</code></dt>
+<dd>
+<p>Converts a Date object, using locales and options as defined in DateTimeFormat of ECMA-402 (Internationalization API), to a string and returns the date and time portion.
+The toLocalString accepts two optional arguments. The semantics of these arguments is defined in
+<a href="https://www.ecma-international.org/ecma-402/4.0/index.html#sup-date.prototype.tolocaledatestring">ECMA-402 (Internationalization API Specification)</a>.
+The specialized definition is found in the runtime library <code>n4js-runtime-ecma402</code>.</p>
+</dd>
+<dt class="hdlist1"><code>toLocaleString(locales: String|[String]=undefined, options: <sub>r</sub>DateTimeFormatOptions=undefined): String</code></dt>
+<dd>
+<p>Converts a Date object, using locales and options as defined in DateTimeFormat of ECMA-402 (Internationalization API), to a string.
+The toLocalString accepts two optional arguments. The semantics of these arguments is defined in
+<a href="https://www.ecma-international.org/ecma-402/4.0/index.html#sup-date.prototype.tolocalestring">ECMA-402 (Internationalization API Specification)</a>.
+In N4JS, the base definition does not define that method, instead Date inherits <code>toLocaleString</code> from Object. The specialized
+definition is found in the runtime library <code>n4js-runtime-ecma402</code>.</p>
+</dd>
+<dt class="hdlist1"><code>toLocaleTimeString(locales: String|[String]=undefined, options: <sub>r</sub>DateTimeFormatOptions=undefined): String</code></dt>
+<dd>
+<p>Converts a Date object, using locales and options as defined in DateTimeFormat of ECMA-402 (Internationalization API), to a string and returns the time portion.
+The semantics of these arguments is defined in
+<a href="https://www.ecma-international.org/ecma-402/4.0/index.html#sup-date.prototype.tolocaletimestring">ECMA-402 (Internationalization API Specification)</a>.
+The specialized definition is found in the runtime library <code>n4js-runtime-ecma402</code>.</p>
+</dd>
+<dt class="hdlist1"><code>toString():String</code></dt>
+<dd>
+<p>Returns a String value for this object.</p>
+</dd>
+<dt class="hdlist1"><code>toTimeString():String</code></dt>
+<dd>
+<p>Returns the time portion of a Date object in readable form.</p>
+</dd>
+<dt class="hdlist1"><code>toUTCString():String</code></dt>
+<dd>
+<p>Converts a Date object, according to Universal Time, to a string.</p>
+</dd>
+</dl>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="_math"><a class="anchor" href="#_math"></a><a class="link" href="#_math">17.9. Math</a></h3>
+<div class="paragraph">
+<p><code>Math</code> is not instantiable and only provides static properties and methods.</p>
+</div>
+<div class="sect3">
+<h4 id="static-attributes-1"><a class="anchor" href="#static-attributes-1"></a><a class="link" href="#static-attributes-1">17.9.1. Static Attributes</a></h4>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><code>E:Number</code></dt>
+<dd>
+<p>Euler&#8217;s constant and the base of natural logarithms, approximately 2.718.</p>
+</dd>
+<dt class="hdlist1"><code>LN2:Number</code></dt>
+<dd>
+<p>Natural logarithm of 2, approximately 0.693.</p>
+</dd>
+<dt class="hdlist1"><code>LN10:Number</code></dt>
+<dd>
+<p>Natural logarithm of 10, approximately 2.302.</p>
+</dd>
+<dt class="hdlist1"><code>LOG2E:Number</code></dt>
+<dd>
+<p>Base 2 logarithm of E, approximately 1.442.</p>
+</dd>
+<dt class="hdlist1"><code>LOG10E:Number</code></dt>
+<dd>
+<p>Base 10 logarithm of E, approximately 0.434.</p>
+</dd>
+<dt class="hdlist1"><code>PI:Number</code></dt>
+<dd>
+<p>Ratio of the circumference of a circle to its diameter, approximately 3.14159.</p>
+</dd>
+<dt class="hdlist1"><code>SQRT1_2:Number</code></dt>
+<dd>
+<p>Square root of 1/2; equivalently, 1 over the square root of 2, approximately 0.707.</p>
+</dd>
+<dt class="hdlist1"><code>SQRT2:Number</code></dt>
+<dd>
+<p>Square root of 2, approximately 1.414.</p>
+</dd>
+</dl>
+</div>
+<h4 id="static-methods-7" class="discrete">Static Methods</h4>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><code>abs(x):Number</code></dt>
+<dd>
+<p>Returns the absolute value of a number.</p>
+</dd>
+<dt class="hdlist1"><code>acos(x:Number):Number</code></dt>
+<dd>
+<p>Returns the arccosine of a number.</p>
+</dd>
+<dt class="hdlist1"><code>asinx:Number):Number</code></dt>
+<dd>
+<p>Returns the arcsine of a number.</p>
+</dd>
+<dt class="hdlist1"><code>atan(x:Number):Number</code></dt>
+<dd>
+<p>Returns the arctangent of a number.</p>
+</dd>
+<dt class="hdlist1"><code>atan2(y:Number,x:Number):Number</code></dt>
+<dd>
+<p>Returns the arctangent of the quotient of its arguments.</p>
+</dd>
+<dt class="hdlist1"><code>ceil(x):Number</code></dt>
+<dd>
+<p>Returns the smallest integer greater than or equal to a number.</p>
+</dd>
+<dt class="hdlist1"><code>cos(x):Number</code></dt>
+<dd>
+<p>Returns the arctangent of the quotient of its arguments.</p>
+</dd>
+<dt class="hdlist1"><code>exp(x):Number</code></dt>
+<dd>
+<p>Returns Enumber, where number is the argument, and E is Euler&#8217;s constant (2.718&#8230;&#8203;), the base of the natural logarithm.</p>
+</dd>
+<dt class="hdlist1"><code>floor(x):Number</code></dt>
+<dd>
+<p>Returns the largest integer less than or equal to a number.</p>
+</dd>
+<dt class="hdlist1"><code>log(x):Number</code></dt>
+<dd>
+<p>Returns the natural logarithm (loge, also ln) of a number.</p>
+</dd>
+<dt class="hdlist1"><code>max(value&#8230;&#8203;):Number</code></dt>
+<dd>
+<p>Returns the largest of zero or more numbers.</p>
+</dd>
+<dt class="hdlist1"><code>min(value&#8230;&#8203;):Number</code></dt>
+<dd>
+<p>Returns the smallest of zero or more numbers.</p>
+</dd>
+<dt class="hdlist1"><code>pow(base:Number,exponent:Number):Number</code></dt>
+<dd>
+<p>Returns base to the exponent power, that is, baseexponent.</p>
+</dd>
+<dt class="hdlist1"><code>random():Number</code></dt>
+<dd>
+<p>Returns a pseudorandom number between 0 and 1.</p>
+</dd>
+<dt class="hdlist1"><code>round(x:Number):Number</code></dt>
+<dd>
+<p>Returns the value of a number rounded to the nearest integer.</p>
+</dd>
+<dt class="hdlist1"><code>sin(x:Number):Number</code></dt>
+<dd>
+<p>Returns the sine of a number.</p>
+</dd>
+<dt class="hdlist1"><code>sqrt(x:Number):Number</code></dt>
+<dd>
+<p>Returns the positive square root of a number.</p>
+</dd>
+<dt class="hdlist1"><code>tan(x:Number):Number</code></dt>
+<dd>
+<p>Returns the tangent of a number.</p>
+</dd>
+</dl>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="_regexp"><a class="anchor" href="#_regexp"></a><a class="link" href="#_regexp">17.10. RegExp</a></h3>
+<div class="paragraph">
+<p><code>RegExp</code> does not have a super class.</p>
+</div>
+<h4 id="attributes-4" class="discrete">Attributes</h4>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><code>global:Boolean</code></dt>
+<dd>
+<p>Whether to test the regular expression against all possible matches in a string, or only against the first.</p>
+</dd>
+<dt class="hdlist1"><code>ignoreCase:Boolean</code></dt>
+<dd>
+<p>Whether to ignore case while attempting a match in a string.</p>
+</dd>
+<dt class="hdlist1"><code>lastIndex:Number</code></dt>
+<dd>
+<p>The index at which to start the next match.</p>
+</dd>
+<dt class="hdlist1"><code>multiline:Boolean</code></dt>
+<dd>
+<p>Whether or not to search in strings across multiple lines.</p>
+</dd>
+<dt class="hdlist1"><code>source:String</code></dt>
+<dd>
+<p>The text of the pattern.</p>
+</dd>
+</dl>
+</div>
+<h4 id="methods-6" class="discrete">Methods</h4>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><code>exec(str:String):Array</code></dt>
+<dd>
+<p>Executes a search for a match in its string parameter.</p>
+</dd>
+<dt class="hdlist1"><code>test(str:String):Boolean</code></dt>
+<dd>
+<p>Tests for a match in its string parameter.</p>
+</dd>
+</dl>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="_json"><a class="anchor" href="#_json"></a><a class="link" href="#_json">17.11. JSON</a></h3>
+<div class="paragraph">
+<p><code>JSON</code> is a global object and a subclass of <code>Object</code>. Its functionality is provided by two static methods.
+It is not possible to create new instances of type JSON.</p>
+</div>
+<h4 id="attributes-5" class="discrete">Attributes</h4>
+<div class="paragraph">
+<p>The JSON object does not define own properties.</p>
+</div>
+<h4 id="methods-7" class="discrete">Methods</h4>
+<div class="paragraph">
+<p>The JSON object does not define own methods.</p>
+</div>
+<h4 id="static-methods-8" class="discrete">Static Methods</h4>
+<div class="paragraph">
+<p>The parse function parses a JSON text (a JSON-formatted String) and
+produces an ECMAScript value. The JSON format is a restricted form of
+ECMAScript literal. JSON objects are realized as ECMAScript objects.
+JSON arrays are realized as ECMAScript arrays. JSON strings, numbers,
+booleans, and null are realized as ECMAScript Strings, Numbers,
+Booleans, and null. For detailed information see [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.S15.12.2)</a>]</p>
+</div>
+<div class="paragraph">
+<p>The optional reviver parameter is a function that takes two parameters
+(key and value). It can filter and transform the results. It is called
+with each of the key/value pairs produced by the parse and its return
+value is used instead of the original value. If it returns what it
+received, the structure is not modified. If it returns then the property
+is deleted from the result.</p>
+</div>
+<div class="paragraph">
+<p>The stringify function returns a String in JSON format representing an
+ECMAScript value. It can take three parameters. The first parameter is
+required. The value parameter is an ECMAScript value which is usually an
+object or array, although it can also be a String, Boolean, Number or
+null.</p>
+</div>
+<div class="paragraph">
+<p>The optional replacer parameter is either a function that alters the way
+objects and arrays are stringified or an array of Strings and Numbers
+that act as a white list for selecting the object properties that will
+be stringified.</p>
+</div>
+<div class="paragraph">
+<p>The optional space parameter is a String or Number that allows the
+result to have whitespace injected into it to improve human readability.</p>
+</div>
+<div class="paragraph">
+<p>For detailed information see [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.S15.12.3)</a>].</p>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div id="footer">
+<div id="footer-text">
+Version 0.9<br>
+Last updated 2019-08-07 15:02:40 CEST
+</div>
+</div>
+<!-- ************* docinfo-footer *************************************************************** -->
+<div class="Grid social" style="color:#d5dfea">
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <h2>Quick Links</h2>
+    <ul>
+      <li><a href="../downloads.html">Download</a></li>
+      <li><a href="../userguides/index.html">Documentation</a></li>
+      <li><a href="https://github.com/eclipse/n4js/">Source</a></li>
+      <li><a href="https://github.com/eclipse/n4js/issues">Issues</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="https://www.eclipse.org/forums/index.php/f/365/">Forum</a></li>
+      <li><a href="http://n4js.blogspot.de/">Blog</a></li>
+      <li><a href="https://dev.eclipse.org/mailman/listinfo/n4js-dev">Mailing List</a></li>
+      <li><a href="https://projects.eclipse.org/projects/technology.n4js">Eclipse Project Page</a></li>
+      <li><a href="https://twitter.com/n4jsdev">Tweets by n4jsdev</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="http://www.eclipse.org/">Eclipse Home</a></li>
+      <li><a href="http://www.eclipse.org/legal/privacy.php">Privacy Policy</a></li>
+      <li><a href="http://www.eclipse.org/legal/termsofuse.php">Terms of Use</a></li>
+      <li><a href="http://www.eclipse.org/legal/copyright.php">Copyright Agent</a></li>
+      <li><a href="http://www.eclipse.org/legal/">Legal</a></li>
+    </ul>
+  </div>
+  <div style="clear: both; height: 0; overflow: hidden;"></div>
+</div>
+
+<!-- ************* UI Scripts ************* -->
+<script type="text/javascript" src="scripts/back-to-top.js"></script>
+
+<script type="text/javascript" src="scripts/treeview.js"></script>
+<script type="text/javascript" src="scripts/toc.js"></script>
+
+<!-- ************* Prism.js Syntax Highlighting ************* -->
+<script src="scripts/prism.js"></script>
+
+<script type="text/javascript">
+	// Add the 'toclist' id for search function
+	$(".toc2 > ul").attr('id', 'toclist');
+	// Generate a Search input form
+	$("#toclist > li:first-of-type").before('<input type="text" id="pagesearch" onkeyup="search()" placeholder="Search for section...">');
+	$("#toclist > li:first-of-type").before('<i id="clear" class="fa fa-times-circle-o"></i>');
+	$("#clear").click(function(){
+	    $("#pagesearch").val('');
+	    search();
+	    $('.toc2 > ul').treeView('collapseAll');
+	});
+	// intialize Treeview.js
+	$(".toc2 > ul").treeView();
+	// Initialize Scrollspy
+</script>
+<!-- ************* docinfo-footer *************************************************************** -->
+</body>
+</html>
\ No newline at end of file
diff --git a/spec/jsx.html b/spec/jsx.html
new file mode 100644
index 0000000..3727008
--- /dev/null
+++ b/spec/jsx.html
@@ -0,0 +1,1242 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="generator" content="Asciidoctor 1.5.5">
+<meta name="author" content="2019-08-07 15:02:40 CEST">
+<title>N4JS Language Specification</title>
+<link rel="stylesheet" href="styles/spec.min.css">
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.6.3/css/font-awesome.min.css">
+<!-- ************* docinfo ******************************************************************* -->
+
+
+<!-- ************* Favicon ************-->
+<link rel="icon" href="images/favicon.ico" />
+
+<!-- ************* Back-to-top JQuery ************* -->
+<script src="https://code.jquery.com/jquery-1.12.4.js"></script>
+<script src="https://code.jquery.com/ui/1.12.0/jquery-ui.js"></script>
+
+
+<link href="styles/prism.min.css" rel="stylesheet" />
+<script type="text/javascript" async
+  src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2/MathJax.js?config=TeX-MML-AM_CHTML">
+</script>
+
+<!-- ************* Styles ************* -->
+<link rel="stylesheet" type="text/css" href="styles/n4jsspec-adoc.css">
+
+
+<!-- ****************** NavBar ****************** -->
+<div id="menubar">
+	<div class="banner">
+        <a href="https://www.eclipse.org/n4js/#"><img id="logo" src="images/n4js-logo.png" alt="Eclipse N4JS"></a>
+    </div>
+<ul>
+  <li><a href="index.html">Index</a></li>
+</ul>
+</div>
+<!-- ************* docinfo ******************************************************************* -->
+<style>
+      .admonitionblock td.icon .icon-todo:before{content:"\f249";color:#f4ee42}
+    </style>
+</head>
+<body class="book toc2 toc-left">
+<div id="header">
+<h1>N4JS Language Specification</h1>
+<div class="details">
+<span id="author" class="author">2019-08-07 15:02:40 CEST</span><br>
+<span id="revnumber">version 0.9</span>
+</div>
+<div id="toc" class="toc2">
+<div id="toctitle">Table of Contents</div>
+<ul class="sectlevel1">
+<li><a href="introduction.html#_introduction">1. Introduction</a>
+<ul class="sectlevel2">
+<li><a href="introduction.html#_notation">1.1. Notation</a>
+<ul class="sectlevel3">
+<li><a href="introduction.html#_grammar-notation">1.1.1. Grammar Notation</a></li>
+<li><a href="introduction.html#_type-judgments-and-rules-and-constraints-notation">1.1.2. Type Judgments and Rules and Constraints Notation</a>
+<ul class="sectlevel4">
+<li><a href="introduction.html#_typing-rules-and-judgments">1.1.2.1. Typing Rules and Judgments</a></li>
+<li><a href="introduction.html#_types-of-an-element">1.1.2.2. Types of an Element</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="introduction.html#_auxiliary-functions">1.2. Auxiliary Functions</a>
+<ul class="sectlevel3">
+<li><a href="introduction.html#_binding">1.2.1. Binding</a></li>
+<li><a href="introduction.html#_merging-types">1.2.2. Merging Types</a>
+<ul class="sectlevel4">
+<li><a href="introduction.html#_logic-formulas">1.2.2.1. Logic Formulas</a></li>
+</ul>
+</li>
+<li><a href="introduction.html#_symbols-and-font-convention">1.2.3. Symbols and Font Convention</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="grammar.html#_grammar">2. Grammar</a>
+<ul class="sectlevel2">
+<li><a href="grammar.html#_lexical-conventions">2.1. Lexical Conventions</a>
+<ul class="sectlevel3">
+<li><a href="grammar.html#_identifier-names-and-identifiers">2.1.1. Identifier Names and Identifiers</a></li>
+<li><a href="grammar.html#_this-keyword">2.1.2. This Keyword</a></li>
+<li><a href="grammar.html#_regular-expression-literals">2.1.3. Regular Expression Literals</a></li>
+<li><a href="grammar.html#_automatic-semicolon-insertion">2.1.4. Automatic Semicolon Insertion</a></li>
+<li><a href="grammar.html#_jsdoc">2.1.5. JSDoc</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="names.html#_names">3. Names</a>
+<ul class="sectlevel2">
+<li><a href="names.html#_access-control">3.1. Access Control</a></li>
+<li><a href="names.html#_accessibility-of-types-top-level-variables-and-function-declarations">3.2. Accessibility of Types, Top-Level Variables and Function Declarations</a>
+<ul class="sectlevel3">
+<li><a href="names.html#_accessibility-of-members">3.2.1. Accessibility of Members</a></li>
+<li><a href="names.html#_valid-names">3.2.2. Valid Names</a></li>
+<li><a href="names.html#_qualified-names">3.2.3. Qualified Names</a></li>
+<li><a href="names.html#_name-duplicates">3.2.4. Name Duplicates</a>
+<ul class="sectlevel4">
+<li><a href="names.html#_lexical-environment">3.2.4.1. Lexical Environment</a></li>
+<li><a href="names.html#_duplicates-and-shadowing">3.2.4.2. Duplicates and Shadowing</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="types.html#_types">4. Types</a>
+<ul class="sectlevel2">
+<li><a href="types.html#_overview">4.1. Overview</a></li>
+<li><a href="types.html#_type-expressions">4.2. Type Expressions</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_syntax">4.2.1. Syntax</a></li>
+<li><a href="types.html#_properties">4.2.2. Properties</a></li>
+<li><a href="types.html#_semantics">4.2.3. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_type-inference">4.3. Type Inference</a></li>
+<li><a href="types.html#_generic-and-parameterized-types">4.4. Generic and Parameterized Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_generic-types">4.4.1. Generic Types</a></li>
+<li><a href="types.html#_type-variables">4.4.2. Type Variables</a></li>
+<li><a href="types.html#_parameterized-types">4.4.3. Parameterized Types</a></li>
+</ul>
+</li>
+<li><a href="types.html#_primitive-ecmascript-types">4.5. Primitive ECMAScript Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_undefined-type">4.5.1. Undefined Type</a></li>
+<li><a href="types.html#_null-type">4.5.2. Null Type</a></li>
+<li><a href="types.html#_primitive-boolean-type">4.5.3. Primitive Boolean Type</a></li>
+<li><a href="types.html#_primitive-string-type">4.5.4. Primitive String Type</a></li>
+<li><a href="types.html#_primitive-number-type">4.5.5. Primitive Number Type</a></li>
+<li><a href="types.html#_primitive-type-int">4.5.6. Primitive Type int</a></li>
+<li><a href="types.html#_primitive-symbol-type">4.5.7. Primitive Symbol Type</a></li>
+</ul>
+</li>
+<li><a href="types.html#_primitive-n4js-types">4.6. Primitive N4JS Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_any-type">4.6.1. Any Type</a>
+<ul class="sectlevel4">
+<li><a href="types.html#any-type-semantics">4.6.1.1. Semantics</a></li>
+<li><a href="types.html#any-type-type-inference">4.6.1.2. Type Inference</a>
+<ul class="sectlevel5">
+<li><a href="types.html#_default-type-of-variables">4.6.1.2.1. Default Type of Variables</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="types.html#_void-type">4.6.2. Void Type</a>
+<ul class="sectlevel4">
+<li><a href="types.html#void-type-semantics">4.6.2.1. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_unknown-type">4.6.3. Unknown Type</a></li>
+<li><a href="types.html#_primitive-pathselector-and-i18nkey">4.6.4. Primitive Pathselector and I18nKey</a>
+<ul class="sectlevel4">
+<li><a href="types.html#pathselector-semantics">4.6.4.1. Semantics</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="types.html#_built-in-ecmascript-object-types">4.7. Built-in ECMAScript Object Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#ECMAScript-objects-semantics">4.7.1. Semantics</a></li>
+<li><a href="types.html#_object-type">4.7.2. Object Type</a></li>
+<li><a href="types.html#_function-object-type">4.7.3. Function-Object-Type</a></li>
+<li><a href="types.html#_array-object-type">4.7.4. Array Object Type</a></li>
+<li><a href="types.html#_string-object-type">4.7.5. String Object Type</a></li>
+<li><a href="types.html#_boolean-object-type">4.7.6. Boolean Object Type</a></li>
+<li><a href="types.html#_number-object-type">4.7.7. Number Object Type</a></li>
+<li><a href="types.html#_global-object-type">4.7.8. Global Object Type</a></li>
+<li><a href="types.html#_symbol">4.7.9. Symbol</a></li>
+<li><a href="types.html#_promise">4.7.10. Promise</a></li>
+<li><a href="types.html#_iterator-interface">4.7.11. Iterator Interface</a></li>
+<li><a href="types.html#_iterable-interface">4.7.12. Iterable Interface</a></li>
+</ul>
+</li>
+<li><a href="types.html#_built-in-n4js-types">4.8. Built-In N4JS Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_n4object">4.8.1. N4Object</a>
+<ul class="sectlevel4">
+<li><a href="types.html#N4Object-semantics">4.8.1.1. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_n4class">4.8.2. N4Class</a></li>
+<li><a href="types.html#IterableN">4.8.3. IterableN</a></li>
+</ul>
+</li>
+<li><a href="types.html#_type-modifiers">4.9. Type Modifiers</a>
+<ul class="sectlevel3">
+<li><a href="types.html#Type_Modifiers_Dynamic">4.9.1. Dynamic</a></li>
+<li><a href="types.html#_optional-return-types">4.9.2. Optional Return Types</a></li>
+</ul>
+</li>
+<li><a href="types.html#_union-and-intersection-type-composed-types">4.10. Union and Intersection Type (Composed Types)</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_union-type">4.10.1. Union Type</a>
+<ul class="sectlevel4">
+<li><a href="types.html#union-type-syntax">4.10.1.1. Syntax</a></li>
+<li><a href="types.html#union-type-semantics">4.10.1.2. Semantics</a></li>
+<li><a href="types.html#_warnings">4.10.1.3. Warnings</a></li>
+</ul>
+</li>
+<li><a href="types.html#_intersection-type">4.10.2. Intersection Type</a>
+<ul class="sectlevel4">
+<li><a href="types.html#intersection-type-syntax">4.10.2.1. Syntax</a></li>
+<li><a href="types.html#intersection-type-semantics">4.10.2.2. Semantics</a></li>
+<li><a href="types.html#_warnings-2">4.10.2.3. Warnings</a></li>
+</ul>
+</li>
+<li><a href="types.html#_composed-types-in-wildcards">4.10.3. Composed Types in Wildcards</a></li>
+<li><a href="types.html#_property-access-for-composed-types">4.10.4. Property Access for Composed Types</a>
+<ul class="sectlevel4">
+<li><a href="types.html#_properties-of-union-type">4.10.4.1. Properties of Union Type</a>
+<ul class="sectlevel5">
+<li><a href="types.html#_remarks-on-union-type-s-members">4.10.4.1.1. Remarks on union type’s members:</a></li>
+</ul>
+</li>
+<li><a href="types.html#_properties-of-intersection-type">4.10.4.2. Properties of Intersection Type</a>
+<ul class="sectlevel5">
+<li><a href="types.html#_remarks-on-intersection-type-s-methods">4.10.4.2.1. Remarks on intersection type’s methods:</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="types.html#_constructor-and-classifier-type">4.11. Constructor and Classifier Type</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_syntax-3">4.11.1. Syntax</a></li>
+<li><a href="types.html#_semantics-2">4.11.2. Semantics</a></li>
+<li><a href="types.html#_constructors-and-prototypes-in-ecmascript-2015">4.11.3. Constructors and Prototypes in ECMAScript 2015</a></li>
+</ul>
+</li>
+<li><a href="types.html#_this-type">4.12. This Type</a>
+<ul class="sectlevel3">
+<li><a href="types.html#this-type-syntax">4.12.1. Syntax</a></li>
+<li><a href="types.html#this-keyword-semantics">4.12.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_enums">4.13. Enums</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_enums-n4js">4.13.1. Enums (N4JS)</a>
+<ul class="sectlevel4">
+<li><a href="types.html#enums-syntax">4.13.1.1. Syntax</a></li>
+<li><a href="types.html#enums-semantics">4.13.1.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_string-based-enums">4.13.2. String-Based Enums</a></li>
+</ul>
+</li>
+<li><a href="types.html#_short-hand-syntax">4.14. Short-Hand Syntax</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_array-short-hand-syntax">4.14.1. Array Short-Hand Syntax</a></li>
+<li><a href="types.html#_iterablen-short-hand-syntax">4.14.2. IterableN Short-Hand Syntax</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="classifiers.html#_classifiers">5. Classifiers</a>
+<ul class="sectlevel2">
+<li><a href="classifiers.html#_n4js-specific-classifiers">5.1. N4JS Specific Classifiers</a>
+<ul class="sectlevel3">
+<li><a href="classifiers.html#_properties-2">5.1.1. Properties</a></li>
+<li><a href="classifiers.html#_common-semantics-of-classifiers">5.1.2. Common Semantics of Classifiers</a></li>
+<li><a href="classifiers.html#_classes">5.1.3. Classes</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_definition-of-classes">5.1.3.1. Definition of Classes</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#class-syntax">5.1.3.1.1. Syntax</a></li>
+<li><a href="classifiers.html#class-properties">5.1.3.1.2. Properties</a></li>
+<li><a href="classifiers.html#class-type-inference">5.1.3.1.3. Type Inference</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#class-semantics">5.1.3.2. Semantics</a></li>
+<li><a href="classifiers.html#_final-modifier">5.1.3.3. Final Modifier</a></li>
+<li><a href="classifiers.html#_abstract-classes">5.1.3.4. Abstract Classes</a></li>
+<li><a href="classifiers.html#_non-instantiable-classes">5.1.3.5. Non-Instantiable Classes</a></li>
+<li><a href="classifiers.html#_superclass">5.1.3.6. Superclass</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_interfaces">5.1.4. Interfaces</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_definition-of-interfaces">5.1.4.1. Definition of Interfaces</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#interfaces-syntax">5.1.4.1.1. Syntax</a></li>
+<li><a href="classifiers.html#interfaces-properties">5.1.4.1.2. Properties</a></li>
+<li><a href="classifiers.html#interfaces-type-inference">5.1.4.1.3. Type Inference</a></li>
+<li><a href="classifiers.html#interfaces-semantics">5.1.4.1.4. Semantics</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="classifiers.html#_generic-classifiers">5.1.5. Generic Classifiers</a></li>
+<li><a href="classifiers.html#sec:definition-site-variance">5.1.6. Definition-Site Variance</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_members">5.2. Members</a>
+<ul class="sectlevel3">
+<li><a href="classifiers.html#_syntax-4">5.2.1. Syntax</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_properties-3">5.2.1.1. Properties</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_semantics-3">5.2.2. Semantics</a></li>
+<li><a href="classifiers.html#_methods">5.2.3. Methods</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_syntax-5">5.2.3.1. Syntax</a></li>
+<li><a href="classifiers.html#_properties-4">5.2.3.2. Properties</a></li>
+<li><a href="classifiers.html#_semantics-4">5.2.3.3. Semantics</a></li>
+<li><a href="classifiers.html#_final-methods">5.2.3.4. Final Methods</a></li>
+<li><a href="classifiers.html#_abstract-methods">5.2.3.5. Abstract Methods</a></li>
+<li><a href="classifiers.html#_generic-methods">5.2.3.6. Generic Methods</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_default-methods-in-interfaces">5.2.4. Default Methods in Interfaces</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_asynchronous-methods">5.2.4.1. Asynchronous Methods</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_constructors">5.2.5. Constructors</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_structural-this-type-in-constructor">5.2.5.1. Structural This Type in Constructor</a></li>
+<li><a href="classifiers.html#spec-constructor">5.2.5.2. @Spec Constructor</a></li>
+<li><a href="classifiers.html#_callable-constructors">5.2.5.3. Callable Constructors</a></li>
+<li><a href="classifiers.html#_covariant-constructors">5.2.5.4. Covariant Constructors</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_data-fields">5.2.6. Data Fields</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#data-fields-syntax">5.2.6.1. Syntax</a></li>
+<li><a href="classifiers.html#data-fields-properties">5.2.6.2. Properties</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#data-fields-semantics">5.2.6.2.1. Semantics</a></li>
+<li><a href="classifiers.html#data-fields-type-inference">5.2.6.2.2. Type Inference</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_assignment-modifiers">5.2.6.3. Assignment Modifiers</a></li>
+<li><a href="classifiers.html#_field-accessors-getter-setter">5.2.6.4. Field Accessors (Getter/Setter)</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#field-acessors-syntax">5.2.6.4.1. Syntax</a></li>
+<li><a href="classifiers.html#field-acessors-properties">5.2.6.4.2. Properties</a></li>
+<li><a href="classifiers.html#field-accessors-semantics">5.2.6.4.3. Semantics</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#optional-fields">5.2.6.5. Optional Fields</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#_syntax-6">5.2.6.5.1. Syntax</a></li>
+<li><a href="classifiers.html#_semantics-5">5.2.6.5.2. Semantics</a></li>
+<li><a href="classifiers.html#_background">5.2.6.5.3. Background</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="classifiers.html#_static-members">5.2.7. Static Members</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_access-from-and-to-static-members">5.2.7.1. Access From and To Static Members</a></li>
+<li><a href="classifiers.html#_generic-static-methods">5.2.7.2. Generic static methods</a></li>
+<li><a href="classifiers.html#_static-members-of-interfaces">5.2.7.3. Static Members of Interfaces</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_redefinition-of-members">5.2.8. Redefinition of Members</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_overriding-of-members">5.2.8.1. Overriding of Members</a></li>
+<li><a href="classifiers.html#_implementation-of-members">5.2.8.2. Implementation of Members</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#_member-consumption">5.2.8.2.1. Member Consumption</a></li>
+<li><a href="classifiers.html#_member-implementation">5.2.8.2.2. Member Implementation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="classifiers.html#_structural-typing">5.3. Structural Typing</a>
+<ul class="sectlevel3">
+<li><a href="classifiers.html#_syntax-7">5.3.1. Syntax</a></li>
+<li><a href="classifiers.html#_definition-site-structural-typing">5.3.2. Definition Site Structural Typing</a></li>
+<li><a href="classifiers.html#_use-site-structural-typing">5.3.3. Use-Site Structural Typing</a></li>
+<li><a href="classifiers.html#structural-readWriteInit-field-typing">5.3.4. Structural Read-only, Write-only and Initializer Field Typing</a></li>
+<li><a href="classifiers.html#_public-setter-annotated-with-code-providesinitializer-code">5.3.5. Public Setter Annotated With <code>ProvidesInitializer</code></a></li>
+<li><a href="classifiers.html#_structural-types-with-optional-fields">5.3.6. Structural Types With Optional Fields</a></li>
+<li><a href="classifiers.html#_structural-types-with-access-modifier">5.3.7. Structural Types With Access Modifier</a></li>
+<li><a href="classifiers.html#_structural-types-with-additional-members">5.3.8. Structural Types With Additional Members</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_syntax-8">5.3.8.1. Syntax</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#_semantics-6">5.3.8.1.1. Semantics</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="functions.html#_functions">6. Functions</a>
+<ul class="sectlevel2">
+<li><a href="functions.html#_function-type">6.1. Function Type</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_properties-5">6.1.1. Properties</a></li>
+<li><a href="functions.html#function-type-inference">6.1.2. Type Inference</a></li>
+<li><a href="functions.html#_autoboxing-of-function-type">6.1.3. Autoboxing of Function Type</a></li>
+<li><a href="functions.html#_arguments-object">6.1.4. Arguments Object</a></li>
+</ul>
+</li>
+<li><a href="functions.html#_ecmascript-5-function-definition">6.2. ECMAScript 5 Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_function-declaration">6.2.1. Function Declaration</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#_syntax-9">6.2.1.1. Syntax</a></li>
+<li><a href="functions.html#_semantics-8">6.2.1.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="functions.html#_function-expression">6.2.2. Function Expression</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#function-expression-syntax">6.2.2.1. Syntax</a></li>
+<li><a href="functions.html#_semantics-and-type-inference">6.2.2.2. Semantics and Type Inference</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="functions.html#_ecmascript-2015-function-definition">6.3. ECMAScript 2015 Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_formal-parameters">6.3.1. Formal Parameters</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#Type_Modifiers_Optional">6.3.1.1. Optional Parameters</a></li>
+<li><a href="functions.html#Type_Modifiers_Default">6.3.1.2. Default Parameters</a></li>
+<li><a href="functions.html#Type_Modifiers_Variadic">6.3.1.3. Variadic</a></li>
+</ul>
+</li>
+<li><a href="functions.html#_generator-functions">6.3.2. Generator Functions</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#generator-functions-syntax">6.3.2.1. Syntax</a></li>
+<li><a href="functions.html#generator-functions-semantics">6.3.2.2. Semantics</a></li>
+<li><a href="functions.html#_generator-arrow-functions">6.3.2.3. Generator Arrow Functions</a></li>
+</ul>
+</li>
+<li><a href="functions.html#_arrow-function-expression">6.3.3. Arrow Function Expression</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#arrow-function-expression-syntax">6.3.3.1. Syntax</a></li>
+<li><a href="functions.html#arrow-function-expression-semantics-and-type-inference">6.3.3.2. Semantics and Type Inference</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="functions.html#_ecmascript-proposals-function-definition">6.4. ECMAScript Proposals Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_asynchronous-functions">6.4.1. Asynchronous Functions</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#asynchronous-functions-syntax">6.4.1.1. Syntax</a></li>
+<li><a href="functions.html#asynchronous-functions-semantics">6.4.1.2. Semantics</a></li>
+<li><a href="functions.html#_asynchronous-arrow-functions">6.4.1.3. Asynchronous Arrow Functions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="functions.html#_n4js-extended-function-definition">6.5. N4JS Extended Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_generic-functions">6.5.1. Generic Functions</a></li>
+<li><a href="functions.html#_promisifiable-functions">6.5.2. Promisifiable Functions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_conversions-and-reflection">7. Conversions and Reflection</a>
+<ul class="sectlevel2">
+<li><a href="conversions_and_reflection.html#_autoboxing-and-coercing">7.1. Autoboxing and Coercing</a>
+<ul class="sectlevel3">
+<li><a href="conversions_and_reflection.html#_coercing">7.1.1. Coercing</a></li>
+<li><a href="conversions_and_reflection.html#_autoboxing-of-primitives">7.1.2. Autoboxing of Primitives</a></li>
+<li><a href="conversions_and_reflection.html#_autoboxing-of-function-expressions-and-declarations">7.1.3. Autoboxing of Function Expressions and Declarations</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_auto-conversion-of-objects">7.2. Auto-Conversion of Objects</a>
+<ul class="sectlevel3">
+<li><a href="conversions_and_reflection.html#_auto-conversion-of-class-instances">7.2.1. Auto-Conversion of Class Instances</a>
+<ul class="sectlevel4">
+<li><a href="conversions_and_reflection.html#_auto-conversion-of-interface-instances">7.2.1.1. Auto-Conversion of Interface Instances</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_auto-conversion-of-enum-literals">7.2.2. Auto-Conversion of Enum Literals</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_type-cast-and-type-check">7.3. Type Cast and Type Check</a>
+<ul class="sectlevel3">
+<li><a href="conversions_and_reflection.html#_type-cast">7.3.1. Type Cast</a></li>
+<li><a href="conversions_and_reflection.html#_type-check">7.3.2. Type Check</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_reflection-meta-information">7.4. Reflection meta-information</a>
+<ul class="sectlevel3">
+<li><a href="conversions_and_reflection.html#_reflection-for-classes">7.4.1. Reflection for Classes</a></li>
+<li><a href="conversions_and_reflection.html#_reflection-for-interfaces">7.4.2. Reflection for Interfaces</a></li>
+<li><a href="conversions_and_reflection.html#_reflection-for-enumerations">7.4.3. Reflection for Enumerations</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_conversion-of-primitive-types">7.5. Conversion of primitive types</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_expressions">8. Expressions</a>
+<ul class="sectlevel2">
+<li><a href="expressions.html#_ecmascript-5-expressions">8.1. ECMAScript 5 Expressions</a>
+<ul class="sectlevel3">
+<li><a href="expressions.html#_the-this-literal">8.1.1. The this Literal</a></li>
+<li><a href="expressions.html#_identifier">8.1.2. Identifier</a></li>
+<li><a href="expressions.html#_literals">8.1.3. Literals</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#_integer-literals">8.1.3.1. Integer Literals</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_array-literal">8.1.4. Array Literal</a></li>
+<li><a href="expressions.html#_object-literal">8.1.5. Object Literal</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#_properties-6">8.1.5.1. Properties</a></li>
+<li><a href="expressions.html#_scoping-and-linking">8.1.5.2. Scoping and linking</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_parenthesized-expression-and-grouping-operator">8.1.6. Parenthesized Expression and Grouping Operator</a></li>
+<li><a href="expressions.html#_property-accessors">8.1.7. Property Accessors</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#properties-1">8.1.7.1. Properties</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_new-expression">8.1.8. New Expression</a></li>
+<li><a href="expressions.html#_function-expression-2">8.1.9. Function Expression</a></li>
+<li><a href="expressions.html#_function-calls">8.1.10. Function Calls</a></li>
+<li><a href="expressions.html#_postfix-expression">8.1.11. Postfix Expression</a></li>
+<li><a href="expressions.html#_unary-expression">8.1.12. Unary Expression</a></li>
+<li><a href="expressions.html#_multiplicative-expression">8.1.13. Multiplicative Expression</a></li>
+<li><a href="expressions.html#_additive-expression">8.1.14. Additive Expression</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#type-inference-10">8.1.14.1. Type Inference</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_bitwise-shift-expression">8.1.15. Bitwise Shift Expression</a></li>
+<li><a href="expressions.html#_relational-expression">8.1.16. Relational Expression</a></li>
+<li><a href="expressions.html#_equality-expression">8.1.17. Equality Expression</a></li>
+<li><a href="expressions.html#_binary-bitwise-expression">8.1.18. Binary Bitwise Expression</a></li>
+<li><a href="expressions.html#_binary-logical-expression">8.1.19. Binary Logical Expression</a></li>
+<li><a href="expressions.html#_conditional-expression">8.1.20. Conditional Expression</a></li>
+<li><a href="expressions.html#_assignment-expression">8.1.21. Assignment Expression</a></li>
+<li><a href="expressions.html#_comma-expression">8.1.22. Comma Expression</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_ecmascript-6-expressions">8.2. ECMAScript 6 Expressions</a>
+<ul class="sectlevel3">
+<li><a href="expressions.html#_the-super-keyword">8.2.1. The super Keyword</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_ecmascript-7-expressions">8.3. ECMAScript 7 Expressions</a>
+<ul class="sectlevel3">
+<li><a href="expressions.html#_await-expression">8.3.1. Await Expression</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_n4js-specific-expressions">8.4. N4JS Specific Expressions</a>
+<ul class="sectlevel3">
+<li><a href="expressions.html#_class-expression">8.4.1. Class Expression</a></li>
+<li><a href="expressions.html#_cast-as-expression">8.4.2. Cast (As) Expression</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#cast-as-expression-semantics-type-inference">8.4.2.1. Semantics and Type Inference</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#Import_Calls">8.4.3. Import Calls</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#compile-time-expressions">8.5. Compile-Time Expressions</a></li>
+</ul>
+</li>
+<li><a href="statements.html#_statements">9. Statements</a>
+<ul class="sectlevel2">
+<li><a href="statements.html#_ecmascript-5-statements">9.1. ECMAScript 5 Statements</a>
+<ul class="sectlevel3">
+<li><a href="statements.html#_function-or-field-accessor-bodies">9.1.1. Function or Field Accessor Bodies</a></li>
+<li><a href="statements.html#_variable-statement">9.1.2. Variable Statement</a></li>
+<li><a href="statements.html#_if-statement">9.1.3. If Statement</a></li>
+<li><a href="statements.html#_iteration-statements">9.1.4. Iteration Statements</a></li>
+<li><a href="statements.html#_return-statement">9.1.5. Return Statement</a></li>
+<li><a href="statements.html#_with-statement">9.1.6. With Statement</a></li>
+<li><a href="statements.html#_switch-statement">9.1.7. Switch Statement</a></li>
+<li><a href="statements.html#_throw-try-and-catch-statements">9.1.8. Throw, Try, and Catch Statements</a></li>
+<li><a href="statements.html#_debugger-statement">9.1.9. Debugger Statement</a></li>
+</ul>
+</li>
+<li><a href="statements.html#_ecmascript-6-statements">9.2. ECMAScript 6 Statements</a>
+<ul class="sectlevel3">
+<li><a href="statements.html#_let">9.2.1. Let</a></li>
+<li><a href="statements.html#_const">9.2.2. Const</a></li>
+<li><a href="statements.html#_for-of-statement">9.2.3. <code>for &#8230;&#8203; of</code> statement</a></li>
+<li><a href="statements.html#_import-statement">9.2.4. Import Statement</a>
+<ul class="sectlevel4">
+<li><a href="statements.html#Dynamic_Imports">9.2.4.1. Dynamic Imports</a></li>
+<li><a href="statements.html#_immutabilaty-of-imports">9.2.4.2. Immutabilaty of Imports</a></li>
+</ul>
+</li>
+<li><a href="statements.html#_export-statement">9.2.5. Export Statement</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="annotations.html#_annotations">10. Annotations</a>
+<ul class="sectlevel2">
+<li><a href="annotations.html#_introduction-2">10.1. Introduction</a>
+<ul class="sectlevel3">
+<li><a href="annotations.html#_syntax-13">10.1.1. Syntax</a></li>
+<li><a href="annotations.html#_properties-7">10.1.2. Properties</a></li>
+<li><a href="annotations.html#_element-specific-annotations">10.1.3. Element-Specific Annotations</a></li>
+<li><a href="annotations.html#_general-annotations">10.1.4. General Annotations</a>
+<ul class="sectlevel4">
+<li><a href="annotations.html#_idebug">10.1.4.1. IDEBUG</a></li>
+</ul>
+</li>
+<li><a href="annotations.html#idebug-syntax">10.1.5. Syntax</a>
+<ul class="sectlevel4">
+<li><a href="annotations.html#_semantics-11">10.1.5.1. Semantics</a></li>
+<li><a href="annotations.html#_suppress-warnings">10.1.5.2. Suppress Warnings</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="annotations.html#_declaration-of-annotations">10.2. Declaration of Annotations</a></li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_extended-fetaures">11. Extended Fetaures</a>
+<ul class="sectlevel2">
+<li><a href="extended_fetaures.html#_array-and-object-destructuring">11.1. Array and Object Destructuring</a>
+<ul class="sectlevel3">
+<li><a href="extended_fetaures.html#_syntax-14">11.1.1. Syntax</a></li>
+<li><a href="extended_fetaures.html#_semantics-12">11.1.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_dependency-injection">11.2. Dependency Injection</a>
+<ul class="sectlevel3">
+<li><a href="extended_fetaures.html#_di-components-and-injectors">11.2.1. DI Components and Injectors</a>
+<ul class="sectlevel4">
+<li><a href="extended_fetaures.html#_dicomponent-relations">11.2.1.1. DIComponent Relations</a></li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_binders-and-bindings">11.2.2. Binders and Bindings</a></li>
+<li><a href="extended_fetaures.html#_injection-points">11.2.3. Injection Points</a>
+<ul class="sectlevel4">
+<li><a href="extended_fetaures.html#_field-injection">11.2.3.1. Field Injection</a></li>
+<li><a href="extended_fetaures.html#_constructor-injection">11.2.3.2. Constructor Injection</a></li>
+<li><a href="extended_fetaures.html#_method-injection">11.2.3.3. Method Injection</a>
+<ul class="sectlevel5">
+<li><a href="extended_fetaures.html#_provider">11.2.3.3.1. Provider</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_n4js-di-life-cycle-and-scopes">11.2.4. N4JS DI Life Cycle and Scopes</a>
+<ul class="sectlevel4">
+<li><a href="extended_fetaures.html#_injection-cylces">11.2.4.1. Injection Cylces</a></li>
+<li><a href="extended_fetaures.html#_default-scope">11.2.4.2. Default Scope</a></li>
+<li><a href="extended_fetaures.html#_singleton-scope">11.2.4.3. Singleton Scope</a></li>
+<li><a href="extended_fetaures.html#_per-injection-chain-singleton">11.2.4.4. Per Injection Chain Singleton</a></li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_validation-of-callsites-targeting-n4injector-methods">11.2.5. Validation of callsites targeting N4Injector methods</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-annotations">11.2.6. N4JS DI Annotations</a>
+<ul class="sectlevel4">
+<li><a href="extended_fetaures.html#_n4js-di-generateinjector">11.2.6.1. N4JS DI @GenerateInjector</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-withparentinjector">11.2.6.2. N4JS DI @WithParentInjector</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-usebinder">11.2.6.3. N4JS DI @UseBinder</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-binder">11.2.6.4. N4JS DI @Binder</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-bind">11.2.6.5. N4JS DI @Bind</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-provides">11.2.6.6. N4JS DI @Provides</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-inject">11.2.6.7. N4JS DI @Inject</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-singleton">11.2.6.8. N4JS DI @Singleton</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_test-support">11.3. Test Support</a></li>
+<li><a href="extended_fetaures.html#_polyfill-definitions">11.4. Polyfill Definitions</a>
+<ul class="sectlevel3">
+<li><a href="extended_fetaures.html#_runtime-polyfill-definitions">11.4.1. Runtime Polyfill Definitions</a></li>
+<li><a href="extended_fetaures.html#_static-polyfill-definitions">11.4.2. Static Polyfill Definitions</a></li>
+<li><a href="extended_fetaures.html#_transpiling-static-polyfilled-classes">11.4.3. Transpiling static polyfilled classes</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="components.html#_components">12. Components</a>
+<ul class="sectlevel2">
+<li><a href="components.html#_overview-2">12.1. Overview</a></li>
+<li><a href="components.html#Component_Types">12.2. Component Types</a>
+<ul class="sectlevel3">
+<li><a href="components.html#_libraries">12.2.1. Libraries</a></li>
+<li><a href="components.html#_runtime-environment-and-runtime-libraries">12.2.2. Runtime Environment and Runtime Libraries</a></li>
+<li><a href="components.html#_tests">12.2.3. Tests</a></li>
+<li><a href="components.html#_type-definitions">12.2.4. Type Definitions</a></li>
+</ul>
+</li>
+<li><a href="components.html#package-json">12.3. Package.json File</a>
+<ul class="sectlevel3">
+<li><a href="components.html#_basic-properties">12.3.1. Basic Properties</a></li>
+<li><a href="components.html#_n4js-properties">12.3.2. N4JS Properties</a></li>
+<li><a href="components.html#_constraints">12.3.3. Constraints</a></li>
+</ul>
+</li>
+<li><a href="components.html#_support-for-npm-scopes">12.4. Support for NPM Scopes</a></li>
+<li><a href="components.html#sec:N4JS-Type-Definitions">12.5. N4JS Type Definitions</a>
+<ul class="sectlevel3">
+<li><a href="components.html#_specify-type-definition">12.5.1. Specify Type Definition</a></li>
+<li><a href="components.html#_name-conventions">12.5.2. Name Conventions</a></li>
+<li><a href="components.html#_version-conventions">12.5.3. Version Conventions</a>
+<ul class="sectlevel4">
+<li><a href="components.html#_define-a-new-type-definition-package">12.5.3.1. Define a New Type Definition Package</a></li>
+<li><a href="components.html#_using-a-type-definition-package">12.5.3.2. Using a Type Definition Package</a></li>
+<li><a href="components.html#_rational">12.5.3.3. Rational</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="components.html#_modules">12.6. Modules</a></li>
+<li><a href="components.html#_api-and-implementation-component">12.7. API and Implementation Component</a>
+<ul class="sectlevel3">
+<li><a href="components.html#_execution-of-api-and-implementation-components">12.7.1. Execution of API and Implementation Components</a></li>
+<li><a href="components.html#_api-and-implementation-with-di">12.7.2. API and Implementation With DI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="plainjs.html#_plainjs">13. PlainJS</a>
+<ul class="sectlevel2">
+<li><a href="plainjs.html#_type-inference-and-validation-for-plain-js">13.1. Type Inference and Validation for Plain JS</a></li>
+<li><a href="plainjs.html#_external-declarations">13.2. External Declarations</a>
+<ul class="sectlevel3">
+<li><a href="plainjs.html#_declaring-externals">13.2.1. Declaring externals</a></li>
+<li><a href="plainjs.html#_instantiating-external-classes">13.2.2. Instantiating external classes</a></li>
+<li><a href="plainjs.html#_implementation-of-external-declarations">13.2.3. Implementation of External Declarations</a></li>
+<li><a href="plainjs.html#_example">13.2.4. Example</a></li>
+</ul>
+</li>
+<li><a href="plainjs.html#_global-definitions">13.3. Global Definitions</a></li>
+<li><a href="plainjs.html#_runtime-definitions">13.4. Runtime Definitions</a></li>
+<li><a href="plainjs.html#_applying-polyfills">13.5. Applying Polyfills</a></li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_jsdoc-2">14. JSDoc</a>
+<ul class="sectlevel2">
+<li><a href="jsdoc.html#_general-n4jsdoc-features">14.1. General N4JSDoc Features</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#_provided-inline-tags">14.1.1. Provided Inline Tags</a>
+<ul class="sectlevel4">
+<li><a href="jsdoc.html#jsdoc_tag__code">14.1.1.1. @code</a></li>
+<li><a href="jsdoc.html#jsdoc_tag__link">14.1.1.2. @link</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_n4jsdoc-for-user-projects">14.2. N4JSdoc for User Projects</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#_standard-tags">14.2.1. Standard Tags</a>
+<ul class="sectlevel4">
+<li><a href="jsdoc.html#_-author">14.2.1.1. @author</a></li>
+<li><a href="jsdoc.html#jsdoc_tag_param">14.2.1.2. @param</a></li>
+<li><a href="jsdoc.html#jsdoc_tag_return">14.2.1.3. @return</a></li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_test-related-tags">14.2.2. Test Related Tags</a>
+<ul class="sectlevel4">
+<li><a href="jsdoc.html#jsdoc_tag__testee">14.2.2.1. @testee</a></li>
+<li><a href="jsdoc.html#jsdoc_tag__testeeFromType">14.2.2.2. @testeeFromType</a></li>
+<li><a href="jsdoc.html#_testeeType_and__testeeMember">14.2.2.3. @testeeType and @testeeMember</a></li>
+<li><a href="jsdoc.html#jsdoc_tag_reqid_in_Tests">14.2.2.4. @reqid in Tests</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_n4jsdoc-for-api-and-implementation-projects">14.3. N4JSDoc for API and Implementation Projects</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#jsdoc_tag__apiNote">14.3.1. @apiNote</a></li>
+<li><a href="jsdoc.html#API_Project_Tags">14.3.2. API Project Tags</a>
+<ul class="sectlevel4">
+<li><a href="jsdoc.html#jsdoc_tag_apiState">14.3.2.1. @apiState</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#_jsx">15. JSX</a>
+<ul class="sectlevel2">
+<li><a href="#_jsx-support">15.1. JSX Support</a></li>
+<li><a href="#_jsx-backend">15.2. JSX Backend</a></li>
+</ul>
+</li>
+<li><a href="grammars.html#_grammars">16. Grammars</a>
+<ul class="sectlevel2">
+<li><a href="grammars.html#_type-expressions-grammar">16.1. Type Expressions Grammar</a></li>
+<li><a href="grammars.html#_n4js-language-grammar">16.2. N4JS Language Grammar</a></li>
+</ul>
+</li>
+<li><a href="jsobjects.html#_jsobjects">17. JSObjects</a>
+<ul class="sectlevel2">
+<li><a href="jsobjects.html#_object">17.1. Object</a></li>
+<li><a href="jsobjects.html#_string">17.2. String</a></li>
+<li><a href="jsobjects.html#_boolean">17.3. Boolean</a></li>
+<li><a href="jsobjects.html#_number">17.4. Number</a>
+<ul class="sectlevel3">
+<li><a href="jsobjects.html#_static-attributes">17.4.1. Static Attributes</a></li>
+</ul>
+</li>
+<li><a href="jsobjects.html#function">17.5. Function</a></li>
+<li><a href="jsobjects.html#_error">17.6. Error</a></li>
+<li><a href="jsobjects.html#_array">17.7. Array</a></li>
+<li><a href="jsobjects.html#_date">17.8. Date</a></li>
+<li><a href="jsobjects.html#_math">17.9. Math</a>
+<ul class="sectlevel3">
+<li><a href="jsobjects.html#static-attributes-1">17.9.1. Static Attributes</a></li>
+</ul>
+</li>
+<li><a href="jsobjects.html#_regexp">17.10. RegExp</a></li>
+<li><a href="jsobjects.html#_json">17.11. JSON</a></li>
+</ul>
+</li>
+<li><a href="n4js_objects.html#_n4js-objects">18. N4JS Objects</a>
+<ul class="sectlevel2">
+<li><a href="n4js_objects.html#_reflection-model">18.1. Reflection Model</a></li>
+<li><a href="n4js_objects.html#_error-types">18.2. Error Types</a>
+<ul class="sectlevel3">
+<li><a href="n4js_objects.html#_n4apinotimplemented">18.2.1. N4ApiNotImplemented</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_acronyms.html#_acronyms">Appendix A: Acronyms</a></li>
+<li><a href="appendix_b_license.html#sec:License">Appendix B: License</a></li>
+<li><a href="appendix_c_bibliography.html#_bibliography">Appendix C: Bibliography</a></li>
+</ul>
+</div>
+</div>
+<div id="content"><div class="sect1">
+<h2 id="_jsx"><a class="anchor" href="#_jsx"></a><a class="link" href="#_jsx">15. JSX</a></h2>
+<div class="sectionbody">
+<div class="sect2 language-jsx">
+<h3 id="_jsx-support"><a class="anchor" href="#_jsx-support"></a><a class="link" href="#_jsx-support">15.1. JSX Support</a></h3>
+<div class="paragraph">
+<p>N4JS scripts with file extension "n4jsx" support the special <a href="https://facebook.github.io/jsx/">JSX syntax</a>. Files ending with "jsx" are considered as plain Javascript.</p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-241101"></a><strong>Req. IDE-241101:</strong> <a href="#Req-IDE-241101">React Component</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>There are two ways of defining a React component:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>functional component: A function is a React component, iff</p>
+<div class="ulist">
+<ul>
+<li>
+<p>its return type is React.Element</p>
+</li>
+<li>
+<p>the function has at least one parameter. This first parameter is considered as the <code>props</code> property.
+The type of the first parameter only has public fields (or methods defined by Object).
+The fields may be defined as optional.</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>class component: A class is a React component, iff</p>
+<div class="ulist">
+<ul>
+<li>
+<p>it extends <code>React.Component</code>.</p>
+</li>
+<li>
+<p>the type parameters must be structural types.</p>
+<div class="ulist">
+<ul>
+<li>
+<p>The first parameter defines the <code>props</code> type, it must only define public fields (or methods defined by Object)</p>
+</li>
+<li>
+<p>The second parameter defines the <code>state</code> type, it must only define public fields (or methods defined by Object)</p>
+</li>
+</ul>
+</div>
+</li>
+</ul>
+</div>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>In both cases, the name must be capitalized (i.e., start with an upper case letter).</p>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Component must be written capitalized (i.e. first letter upper case), html (or other xml elements) must be written lower case.</p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-241102"></a><strong>Req. IDE-241102:</strong> <a href="#Req-IDE-241102">JSX Basic Syntax</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>The following JSX syntax is supported (EBNF with model element assignments as used in Xtext). All other ECMAScript 2015 and N4JS syntax constructs are unaffected by this addition.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">PrimaryExpression &lt;Yield&gt; returns n4js::Expression:
+	... // as in N4JS
+	| JSXElement
+;
+
+JSXElement:
+	'&lt;' jsxElementName=JSXElementName JSXAttributes
+	(('&gt;' jsxChildren+=JSXChild* JSXClosingElement) | ('/' '&gt;'));
+
+fragment JSXClosingElement *:
+	'&lt;' '/' jsxClosingName=JSXElementName '&gt;';
+
+JSXChild:
+	JSXElement | JSXExpression
+;
+
+JSXExpression: '{' expression=AssignmentExpression&lt;false,false&gt; '}';
+
+JSXElementName:
+	expression=JSXElementNameExpression
+	;
+
+JSXElementNameExpression returns n4js::Expression:
+	IdentifierRef&lt;false&gt;
+	({n4js::ParameterizedPropertyAccessExpression.target=current} ParameterizedPropertyAccessExpressionTail&lt;false&gt;)*
+;
+
+fragment JSXAttributes *:
+	jsxAttributes+=JSXAttribute*;
+
+JSXAttribute:
+	JSXSpreadAttribute
+	|
+	JSXPropertyAttribute;
+
+JSXSpreadAttribute:
+	'{' '...' expression=AssignmentExpression&lt;false,false&gt; '}';
+
+JSXPropertyAttribute:
+	property=[types::IdentifiableElement|IdentifierName] '=' (jsxAttributeValue=StringLiteral | ('{'
+	jsxAttributeValue=AssignmentExpression&lt;false,false&gt; '}'));</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>This syntax is similar to the syntax defined by <a href="https://facebook.github.io/jsx/">JSX</a>, except that</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>JSXNamedspaceName is not supported</p>
+</li>
+<li>
+<p>JSXText is not supported, instead, string template literals are to be used</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Remarks on differences between the syntax defined in <a href="#Req-IDE-241102">[Req-IDE-241102]</a> and <a href="https://facebook.github.io/jsx/">JSX</a>:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>JSXSelfClosingElement, JSXOpeningElement and JSXClosingElement are merged into one single rule JSXElement</p>
+</li>
+<li>
+<p>JSXAttributes is defined as fragment, that is, the attributes become fields of the JSXElement</p>
+</li>
+<li>
+<p>The different types of JSXElementName are defined by means of JSXElementNameExpression which is a simple expression, reusing the existing rules IdentifierRef and ParameterizedPropertyAccessExpression to model JSXIdentifer and JSXMemberExpression respectively</p>
+</li>
+<li>
+<p>JSXPropertyAttribute models the JSX non-spread JSXAttribute definition; again existing rules (IdentifierName, StringLiteral) are used to model JSX specific ones (JSXAttributeName, JSXDoubleStringCharacters, JSXSingleStringCharacters)</p>
+</li>
+</ul>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-241401"></a><strong>Req. IDE-241401:</strong> <a href="#Req-IDE-241401">JSX Syntax With Free Text</a> (ver. 1)</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">JSXChild:
+	JSXElement | JSXExpression | JSXText
+;</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-241103"></a><strong>Req. IDE-241103:</strong> <a href="#Req-IDE-241103">JSX Extended Syntax Check</a> (ver. 1)</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>It is an error, if corresponding opening and closing JSXElements have different names.</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-241113"></a><strong>Req. IDE-241113:</strong> <a href="#Req-IDE-241113">JSX Expression Type</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>The type of a JSX expression is React.Element.</p>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-241114"></a><strong>Req. IDE-241114:</strong> <a href="#Req-IDE-241114">React Symbol</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>If a JSX literal is used, it is an error if the React symbol is not imported via</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-jsx" data-lang="jsx">import React from "react"</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-241115"></a><strong>Req. IDE-241115:</strong> <a href="#Req-IDE-241115">JSXElement names (tags)</a> (ver. 1)</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>It is an error if a capitalized tag cannot be bound to a function or class declaration.</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-241116"></a><strong>Req. IDE-241116:</strong> <a href="#Req-IDE-241116">JSXElements referring to React components</a> (ver. 1)</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>It is an error, if a tag binds to a function declaration, which is not conform to the functional component definition.</p>
+</li>
+<li>
+<p>It is an error, if a tag binds to a class declaration, which is not conform to the class component definition.</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-241117"></a><strong>Req. IDE-241117:</strong> <a href="#Req-IDE-241117">JSXAttributes and React component properties</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>If the tag binds to a component, the following constraints must hold:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>The attribute must be a non-private field of the properties type.</p>
+</li>
+<li>
+<p>The tag should define attributes for all non-optional fields of the properties type. If no attribute is defined for a non-optional field, a warning is issued.</p>
+</li>
+<li>
+<p>The type of the attribute expression must be conform to the type of the corresponding <code>props</code>'s property</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-241118"></a><strong>Req. IDE-241118:</strong> <a href="#Req-IDE-241118">JSXElements referring to XML elements</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>If the lower-case tag does not bind to a function or class declaration, the following constraints must be hold:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>If the tag is neither a pre-defined HTML tag nor an SVG tag, a warning is issued.</p>
+</li>
+<li>
+<p>If an attribute of the tag is not a pre-defined property of the html tag or react specific attributes, a warning is issued. This requirement is currently NOT supported.</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-241119"></a><strong>Req. IDE-241119:</strong> <a href="#Req-IDE-241119">JSXSpreadAttribute behavior</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>The use of spread operators within an JSX element for specifying multiple attributes should be allowed. In this case, all constraints regarding type conformity checking and non-optional properties mentioned in <a href="#Req-IDE-241117">[Req-IDE-241117]</a> apply to the attributes specified in the spread operator. In particular,</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>The type of each attribute specified in spread operator must be conform to the type of the corresponding property of <code>props</code>.</p>
+</li>
+<li>
+<p>If a non-optional property of <code>props</code> is specified neither as attribute nor in a spread operator, a warning is issued.</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_jsx-backend"><a class="anchor" href="#_jsx-backend"></a><a class="link" href="#_jsx-backend">15.2. JSX Backend</a></h3>
+<div class="paragraph">
+<p>The support for JSX in N4JS aims for an implementation that adheres to the idea of <a href="https://reactjs.org/docs/jsx-in-depth.html">React JSX</a>. This means that JSX elements are transpiled to React Element factory calls (e.g. <code>&lt;div prop="c"&gt;content&lt;/div&gt;</code> transpiles to <code>React.createElement('div', {prop: "c"}, null)</code>). For that, the transpiler must be aware of a specific implementation of React and the corresponding <code>createElement</code> function.</p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-GH-687"></a><strong>Req. GH-687:</strong> <a href="#Req-GH-687">React Implementation</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>A react implementation is given in terms of a module that fulfils the following properties:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>The FQN of the module is <code>react</code>.</p>
+</li>
+<li>
+<p>Type definitions are available for the module.</p>
+</li>
+<li>
+<p>The module exports a function of name <code>createElement</code>.</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>If a react implementation is declared as project dependency, the N4JS transpiler automatically imports it to the module using JSX and generates the corresponding factory calls.</p>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div id="footer">
+<div id="footer-text">
+Version 0.9<br>
+Last updated 2019-08-07 15:02:40 CEST
+</div>
+</div>
+<!-- ************* docinfo-footer *************************************************************** -->
+<div class="Grid social" style="color:#d5dfea">
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <h2>Quick Links</h2>
+    <ul>
+      <li><a href="../downloads.html">Download</a></li>
+      <li><a href="../userguides/index.html">Documentation</a></li>
+      <li><a href="https://github.com/eclipse/n4js/">Source</a></li>
+      <li><a href="https://github.com/eclipse/n4js/issues">Issues</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="https://www.eclipse.org/forums/index.php/f/365/">Forum</a></li>
+      <li><a href="http://n4js.blogspot.de/">Blog</a></li>
+      <li><a href="https://dev.eclipse.org/mailman/listinfo/n4js-dev">Mailing List</a></li>
+      <li><a href="https://projects.eclipse.org/projects/technology.n4js">Eclipse Project Page</a></li>
+      <li><a href="https://twitter.com/n4jsdev">Tweets by n4jsdev</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="http://www.eclipse.org/">Eclipse Home</a></li>
+      <li><a href="http://www.eclipse.org/legal/privacy.php">Privacy Policy</a></li>
+      <li><a href="http://www.eclipse.org/legal/termsofuse.php">Terms of Use</a></li>
+      <li><a href="http://www.eclipse.org/legal/copyright.php">Copyright Agent</a></li>
+      <li><a href="http://www.eclipse.org/legal/">Legal</a></li>
+    </ul>
+  </div>
+  <div style="clear: both; height: 0; overflow: hidden;"></div>
+</div>
+
+<!-- ************* UI Scripts ************* -->
+<script type="text/javascript" src="scripts/back-to-top.js"></script>
+
+<script type="text/javascript" src="scripts/treeview.js"></script>
+<script type="text/javascript" src="scripts/toc.js"></script>
+
+<!-- ************* Prism.js Syntax Highlighting ************* -->
+<script src="scripts/prism.js"></script>
+
+<script type="text/javascript">
+	// Add the 'toclist' id for search function
+	$(".toc2 > ul").attr('id', 'toclist');
+	// Generate a Search input form
+	$("#toclist > li:first-of-type").before('<input type="text" id="pagesearch" onkeyup="search()" placeholder="Search for section...">');
+	$("#toclist > li:first-of-type").before('<i id="clear" class="fa fa-times-circle-o"></i>');
+	$("#clear").click(function(){
+	    $("#pagesearch").val('');
+	    search();
+	    $('.toc2 > ul').treeView('collapseAll');
+	});
+	// intialize Treeview.js
+	$(".toc2 > ul").treeView();
+	// Initialize Scrollspy
+</script>
+<!-- ************* docinfo-footer *************************************************************** -->
+</body>
+</html>
\ No newline at end of file
diff --git a/spec/n4js_objects.html b/spec/n4js_objects.html
new file mode 100644
index 0000000..19b3e48
--- /dev/null
+++ b/spec/n4js_objects.html
@@ -0,0 +1,1312 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="generator" content="Asciidoctor 1.5.5">
+<meta name="author" content="2019-08-07 15:02:40 CEST">
+<title>N4JS Language Specification</title>
+<link rel="stylesheet" href="styles/spec.min.css">
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.6.3/css/font-awesome.min.css">
+<!-- ************* docinfo ******************************************************************* -->
+
+
+<!-- ************* Favicon ************-->
+<link rel="icon" href="images/favicon.ico" />
+
+<!-- ************* Back-to-top JQuery ************* -->
+<script src="https://code.jquery.com/jquery-1.12.4.js"></script>
+<script src="https://code.jquery.com/ui/1.12.0/jquery-ui.js"></script>
+
+
+<link href="styles/prism.min.css" rel="stylesheet" />
+<script type="text/javascript" async
+  src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2/MathJax.js?config=TeX-MML-AM_CHTML">
+</script>
+
+<!-- ************* Styles ************* -->
+<link rel="stylesheet" type="text/css" href="styles/n4jsspec-adoc.css">
+
+
+<!-- ****************** NavBar ****************** -->
+<div id="menubar">
+	<div class="banner">
+        <a href="https://www.eclipse.org/n4js/#"><img id="logo" src="images/n4js-logo.png" alt="Eclipse N4JS"></a>
+    </div>
+<ul>
+  <li><a href="index.html">Index</a></li>
+</ul>
+</div>
+<!-- ************* docinfo ******************************************************************* -->
+<style>
+      .admonitionblock td.icon .icon-todo:before{content:"\f249";color:#f4ee42}
+    </style>
+</head>
+<body class="book toc2 toc-left">
+<div id="header">
+<h1>N4JS Language Specification</h1>
+<div class="details">
+<span id="author" class="author">2019-08-07 15:02:40 CEST</span><br>
+<span id="revnumber">version 0.9</span>
+</div>
+<div id="toc" class="toc2">
+<div id="toctitle">Table of Contents</div>
+<ul class="sectlevel1">
+<li><a href="introduction.html#_introduction">1. Introduction</a>
+<ul class="sectlevel2">
+<li><a href="introduction.html#_notation">1.1. Notation</a>
+<ul class="sectlevel3">
+<li><a href="introduction.html#_grammar-notation">1.1.1. Grammar Notation</a></li>
+<li><a href="introduction.html#_type-judgments-and-rules-and-constraints-notation">1.1.2. Type Judgments and Rules and Constraints Notation</a>
+<ul class="sectlevel4">
+<li><a href="introduction.html#_typing-rules-and-judgments">1.1.2.1. Typing Rules and Judgments</a></li>
+<li><a href="introduction.html#_types-of-an-element">1.1.2.2. Types of an Element</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="introduction.html#_auxiliary-functions">1.2. Auxiliary Functions</a>
+<ul class="sectlevel3">
+<li><a href="introduction.html#_binding">1.2.1. Binding</a></li>
+<li><a href="introduction.html#_merging-types">1.2.2. Merging Types</a>
+<ul class="sectlevel4">
+<li><a href="introduction.html#_logic-formulas">1.2.2.1. Logic Formulas</a></li>
+</ul>
+</li>
+<li><a href="introduction.html#_symbols-and-font-convention">1.2.3. Symbols and Font Convention</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="grammar.html#_grammar">2. Grammar</a>
+<ul class="sectlevel2">
+<li><a href="grammar.html#_lexical-conventions">2.1. Lexical Conventions</a>
+<ul class="sectlevel3">
+<li><a href="grammar.html#_identifier-names-and-identifiers">2.1.1. Identifier Names and Identifiers</a></li>
+<li><a href="grammar.html#_this-keyword">2.1.2. This Keyword</a></li>
+<li><a href="grammar.html#_regular-expression-literals">2.1.3. Regular Expression Literals</a></li>
+<li><a href="grammar.html#_automatic-semicolon-insertion">2.1.4. Automatic Semicolon Insertion</a></li>
+<li><a href="grammar.html#_jsdoc">2.1.5. JSDoc</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="names.html#_names">3. Names</a>
+<ul class="sectlevel2">
+<li><a href="names.html#_access-control">3.1. Access Control</a></li>
+<li><a href="names.html#_accessibility-of-types-top-level-variables-and-function-declarations">3.2. Accessibility of Types, Top-Level Variables and Function Declarations</a>
+<ul class="sectlevel3">
+<li><a href="names.html#_accessibility-of-members">3.2.1. Accessibility of Members</a></li>
+<li><a href="names.html#_valid-names">3.2.2. Valid Names</a></li>
+<li><a href="names.html#_qualified-names">3.2.3. Qualified Names</a></li>
+<li><a href="names.html#_name-duplicates">3.2.4. Name Duplicates</a>
+<ul class="sectlevel4">
+<li><a href="names.html#_lexical-environment">3.2.4.1. Lexical Environment</a></li>
+<li><a href="names.html#_duplicates-and-shadowing">3.2.4.2. Duplicates and Shadowing</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="types.html#_types">4. Types</a>
+<ul class="sectlevel2">
+<li><a href="types.html#_overview">4.1. Overview</a></li>
+<li><a href="types.html#_type-expressions">4.2. Type Expressions</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_syntax">4.2.1. Syntax</a></li>
+<li><a href="types.html#_properties">4.2.2. Properties</a></li>
+<li><a href="types.html#_semantics">4.2.3. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_type-inference">4.3. Type Inference</a></li>
+<li><a href="types.html#_generic-and-parameterized-types">4.4. Generic and Parameterized Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_generic-types">4.4.1. Generic Types</a></li>
+<li><a href="types.html#_type-variables">4.4.2. Type Variables</a></li>
+<li><a href="types.html#_parameterized-types">4.4.3. Parameterized Types</a></li>
+</ul>
+</li>
+<li><a href="types.html#_primitive-ecmascript-types">4.5. Primitive ECMAScript Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_undefined-type">4.5.1. Undefined Type</a></li>
+<li><a href="types.html#_null-type">4.5.2. Null Type</a></li>
+<li><a href="types.html#_primitive-boolean-type">4.5.3. Primitive Boolean Type</a></li>
+<li><a href="types.html#_primitive-string-type">4.5.4. Primitive String Type</a></li>
+<li><a href="types.html#_primitive-number-type">4.5.5. Primitive Number Type</a></li>
+<li><a href="types.html#_primitive-type-int">4.5.6. Primitive Type int</a></li>
+<li><a href="types.html#_primitive-symbol-type">4.5.7. Primitive Symbol Type</a></li>
+</ul>
+</li>
+<li><a href="types.html#_primitive-n4js-types">4.6. Primitive N4JS Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_any-type">4.6.1. Any Type</a>
+<ul class="sectlevel4">
+<li><a href="types.html#any-type-semantics">4.6.1.1. Semantics</a></li>
+<li><a href="types.html#any-type-type-inference">4.6.1.2. Type Inference</a>
+<ul class="sectlevel5">
+<li><a href="types.html#_default-type-of-variables">4.6.1.2.1. Default Type of Variables</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="types.html#_void-type">4.6.2. Void Type</a>
+<ul class="sectlevel4">
+<li><a href="types.html#void-type-semantics">4.6.2.1. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_unknown-type">4.6.3. Unknown Type</a></li>
+<li><a href="types.html#_primitive-pathselector-and-i18nkey">4.6.4. Primitive Pathselector and I18nKey</a>
+<ul class="sectlevel4">
+<li><a href="types.html#pathselector-semantics">4.6.4.1. Semantics</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="types.html#_built-in-ecmascript-object-types">4.7. Built-in ECMAScript Object Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#ECMAScript-objects-semantics">4.7.1. Semantics</a></li>
+<li><a href="types.html#_object-type">4.7.2. Object Type</a></li>
+<li><a href="types.html#_function-object-type">4.7.3. Function-Object-Type</a></li>
+<li><a href="types.html#_array-object-type">4.7.4. Array Object Type</a></li>
+<li><a href="types.html#_string-object-type">4.7.5. String Object Type</a></li>
+<li><a href="types.html#_boolean-object-type">4.7.6. Boolean Object Type</a></li>
+<li><a href="types.html#_number-object-type">4.7.7. Number Object Type</a></li>
+<li><a href="types.html#_global-object-type">4.7.8. Global Object Type</a></li>
+<li><a href="types.html#_symbol">4.7.9. Symbol</a></li>
+<li><a href="types.html#_promise">4.7.10. Promise</a></li>
+<li><a href="types.html#_iterator-interface">4.7.11. Iterator Interface</a></li>
+<li><a href="types.html#_iterable-interface">4.7.12. Iterable Interface</a></li>
+</ul>
+</li>
+<li><a href="types.html#_built-in-n4js-types">4.8. Built-In N4JS Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_n4object">4.8.1. N4Object</a>
+<ul class="sectlevel4">
+<li><a href="types.html#N4Object-semantics">4.8.1.1. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_n4class">4.8.2. N4Class</a></li>
+<li><a href="types.html#IterableN">4.8.3. IterableN</a></li>
+</ul>
+</li>
+<li><a href="types.html#_type-modifiers">4.9. Type Modifiers</a>
+<ul class="sectlevel3">
+<li><a href="types.html#Type_Modifiers_Dynamic">4.9.1. Dynamic</a></li>
+<li><a href="types.html#_optional-return-types">4.9.2. Optional Return Types</a></li>
+</ul>
+</li>
+<li><a href="types.html#_union-and-intersection-type-composed-types">4.10. Union and Intersection Type (Composed Types)</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_union-type">4.10.1. Union Type</a>
+<ul class="sectlevel4">
+<li><a href="types.html#union-type-syntax">4.10.1.1. Syntax</a></li>
+<li><a href="types.html#union-type-semantics">4.10.1.2. Semantics</a></li>
+<li><a href="types.html#_warnings">4.10.1.3. Warnings</a></li>
+</ul>
+</li>
+<li><a href="types.html#_intersection-type">4.10.2. Intersection Type</a>
+<ul class="sectlevel4">
+<li><a href="types.html#intersection-type-syntax">4.10.2.1. Syntax</a></li>
+<li><a href="types.html#intersection-type-semantics">4.10.2.2. Semantics</a></li>
+<li><a href="types.html#_warnings-2">4.10.2.3. Warnings</a></li>
+</ul>
+</li>
+<li><a href="types.html#_composed-types-in-wildcards">4.10.3. Composed Types in Wildcards</a></li>
+<li><a href="types.html#_property-access-for-composed-types">4.10.4. Property Access for Composed Types</a>
+<ul class="sectlevel4">
+<li><a href="types.html#_properties-of-union-type">4.10.4.1. Properties of Union Type</a>
+<ul class="sectlevel5">
+<li><a href="types.html#_remarks-on-union-type-s-members">4.10.4.1.1. Remarks on union type’s members:</a></li>
+</ul>
+</li>
+<li><a href="types.html#_properties-of-intersection-type">4.10.4.2. Properties of Intersection Type</a>
+<ul class="sectlevel5">
+<li><a href="types.html#_remarks-on-intersection-type-s-methods">4.10.4.2.1. Remarks on intersection type’s methods:</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="types.html#_constructor-and-classifier-type">4.11. Constructor and Classifier Type</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_syntax-3">4.11.1. Syntax</a></li>
+<li><a href="types.html#_semantics-2">4.11.2. Semantics</a></li>
+<li><a href="types.html#_constructors-and-prototypes-in-ecmascript-2015">4.11.3. Constructors and Prototypes in ECMAScript 2015</a></li>
+</ul>
+</li>
+<li><a href="types.html#_this-type">4.12. This Type</a>
+<ul class="sectlevel3">
+<li><a href="types.html#this-type-syntax">4.12.1. Syntax</a></li>
+<li><a href="types.html#this-keyword-semantics">4.12.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_enums">4.13. Enums</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_enums-n4js">4.13.1. Enums (N4JS)</a>
+<ul class="sectlevel4">
+<li><a href="types.html#enums-syntax">4.13.1.1. Syntax</a></li>
+<li><a href="types.html#enums-semantics">4.13.1.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_string-based-enums">4.13.2. String-Based Enums</a></li>
+</ul>
+</li>
+<li><a href="types.html#_short-hand-syntax">4.14. Short-Hand Syntax</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_array-short-hand-syntax">4.14.1. Array Short-Hand Syntax</a></li>
+<li><a href="types.html#_iterablen-short-hand-syntax">4.14.2. IterableN Short-Hand Syntax</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="classifiers.html#_classifiers">5. Classifiers</a>
+<ul class="sectlevel2">
+<li><a href="classifiers.html#_n4js-specific-classifiers">5.1. N4JS Specific Classifiers</a>
+<ul class="sectlevel3">
+<li><a href="classifiers.html#_properties-2">5.1.1. Properties</a></li>
+<li><a href="classifiers.html#_common-semantics-of-classifiers">5.1.2. Common Semantics of Classifiers</a></li>
+<li><a href="classifiers.html#_classes">5.1.3. Classes</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_definition-of-classes">5.1.3.1. Definition of Classes</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#class-syntax">5.1.3.1.1. Syntax</a></li>
+<li><a href="classifiers.html#class-properties">5.1.3.1.2. Properties</a></li>
+<li><a href="classifiers.html#class-type-inference">5.1.3.1.3. Type Inference</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#class-semantics">5.1.3.2. Semantics</a></li>
+<li><a href="classifiers.html#_final-modifier">5.1.3.3. Final Modifier</a></li>
+<li><a href="classifiers.html#_abstract-classes">5.1.3.4. Abstract Classes</a></li>
+<li><a href="classifiers.html#_non-instantiable-classes">5.1.3.5. Non-Instantiable Classes</a></li>
+<li><a href="classifiers.html#_superclass">5.1.3.6. Superclass</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_interfaces">5.1.4. Interfaces</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_definition-of-interfaces">5.1.4.1. Definition of Interfaces</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#interfaces-syntax">5.1.4.1.1. Syntax</a></li>
+<li><a href="classifiers.html#interfaces-properties">5.1.4.1.2. Properties</a></li>
+<li><a href="classifiers.html#interfaces-type-inference">5.1.4.1.3. Type Inference</a></li>
+<li><a href="classifiers.html#interfaces-semantics">5.1.4.1.4. Semantics</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="classifiers.html#_generic-classifiers">5.1.5. Generic Classifiers</a></li>
+<li><a href="classifiers.html#sec:definition-site-variance">5.1.6. Definition-Site Variance</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_members">5.2. Members</a>
+<ul class="sectlevel3">
+<li><a href="classifiers.html#_syntax-4">5.2.1. Syntax</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_properties-3">5.2.1.1. Properties</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_semantics-3">5.2.2. Semantics</a></li>
+<li><a href="classifiers.html#_methods">5.2.3. Methods</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_syntax-5">5.2.3.1. Syntax</a></li>
+<li><a href="classifiers.html#_properties-4">5.2.3.2. Properties</a></li>
+<li><a href="classifiers.html#_semantics-4">5.2.3.3. Semantics</a></li>
+<li><a href="classifiers.html#_final-methods">5.2.3.4. Final Methods</a></li>
+<li><a href="classifiers.html#_abstract-methods">5.2.3.5. Abstract Methods</a></li>
+<li><a href="classifiers.html#_generic-methods">5.2.3.6. Generic Methods</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_default-methods-in-interfaces">5.2.4. Default Methods in Interfaces</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_asynchronous-methods">5.2.4.1. Asynchronous Methods</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_constructors">5.2.5. Constructors</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_structural-this-type-in-constructor">5.2.5.1. Structural This Type in Constructor</a></li>
+<li><a href="classifiers.html#spec-constructor">5.2.5.2. @Spec Constructor</a></li>
+<li><a href="classifiers.html#_callable-constructors">5.2.5.3. Callable Constructors</a></li>
+<li><a href="classifiers.html#_covariant-constructors">5.2.5.4. Covariant Constructors</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_data-fields">5.2.6. Data Fields</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#data-fields-syntax">5.2.6.1. Syntax</a></li>
+<li><a href="classifiers.html#data-fields-properties">5.2.6.2. Properties</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#data-fields-semantics">5.2.6.2.1. Semantics</a></li>
+<li><a href="classifiers.html#data-fields-type-inference">5.2.6.2.2. Type Inference</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_assignment-modifiers">5.2.6.3. Assignment Modifiers</a></li>
+<li><a href="classifiers.html#_field-accessors-getter-setter">5.2.6.4. Field Accessors (Getter/Setter)</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#field-acessors-syntax">5.2.6.4.1. Syntax</a></li>
+<li><a href="classifiers.html#field-acessors-properties">5.2.6.4.2. Properties</a></li>
+<li><a href="classifiers.html#field-accessors-semantics">5.2.6.4.3. Semantics</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#optional-fields">5.2.6.5. Optional Fields</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#_syntax-6">5.2.6.5.1. Syntax</a></li>
+<li><a href="classifiers.html#_semantics-5">5.2.6.5.2. Semantics</a></li>
+<li><a href="classifiers.html#_background">5.2.6.5.3. Background</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="classifiers.html#_static-members">5.2.7. Static Members</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_access-from-and-to-static-members">5.2.7.1. Access From and To Static Members</a></li>
+<li><a href="classifiers.html#_generic-static-methods">5.2.7.2. Generic static methods</a></li>
+<li><a href="classifiers.html#_static-members-of-interfaces">5.2.7.3. Static Members of Interfaces</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_redefinition-of-members">5.2.8. Redefinition of Members</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_overriding-of-members">5.2.8.1. Overriding of Members</a></li>
+<li><a href="classifiers.html#_implementation-of-members">5.2.8.2. Implementation of Members</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#_member-consumption">5.2.8.2.1. Member Consumption</a></li>
+<li><a href="classifiers.html#_member-implementation">5.2.8.2.2. Member Implementation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="classifiers.html#_structural-typing">5.3. Structural Typing</a>
+<ul class="sectlevel3">
+<li><a href="classifiers.html#_syntax-7">5.3.1. Syntax</a></li>
+<li><a href="classifiers.html#_definition-site-structural-typing">5.3.2. Definition Site Structural Typing</a></li>
+<li><a href="classifiers.html#_use-site-structural-typing">5.3.3. Use-Site Structural Typing</a></li>
+<li><a href="classifiers.html#structural-readWriteInit-field-typing">5.3.4. Structural Read-only, Write-only and Initializer Field Typing</a></li>
+<li><a href="classifiers.html#_public-setter-annotated-with-code-providesinitializer-code">5.3.5. Public Setter Annotated With <code>ProvidesInitializer</code></a></li>
+<li><a href="classifiers.html#_structural-types-with-optional-fields">5.3.6. Structural Types With Optional Fields</a></li>
+<li><a href="classifiers.html#_structural-types-with-access-modifier">5.3.7. Structural Types With Access Modifier</a></li>
+<li><a href="classifiers.html#_structural-types-with-additional-members">5.3.8. Structural Types With Additional Members</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_syntax-8">5.3.8.1. Syntax</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#_semantics-6">5.3.8.1.1. Semantics</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="functions.html#_functions">6. Functions</a>
+<ul class="sectlevel2">
+<li><a href="functions.html#_function-type">6.1. Function Type</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_properties-5">6.1.1. Properties</a></li>
+<li><a href="functions.html#function-type-inference">6.1.2. Type Inference</a></li>
+<li><a href="functions.html#_autoboxing-of-function-type">6.1.3. Autoboxing of Function Type</a></li>
+<li><a href="functions.html#_arguments-object">6.1.4. Arguments Object</a></li>
+</ul>
+</li>
+<li><a href="functions.html#_ecmascript-5-function-definition">6.2. ECMAScript 5 Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_function-declaration">6.2.1. Function Declaration</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#_syntax-9">6.2.1.1. Syntax</a></li>
+<li><a href="functions.html#_semantics-8">6.2.1.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="functions.html#_function-expression">6.2.2. Function Expression</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#function-expression-syntax">6.2.2.1. Syntax</a></li>
+<li><a href="functions.html#_semantics-and-type-inference">6.2.2.2. Semantics and Type Inference</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="functions.html#_ecmascript-2015-function-definition">6.3. ECMAScript 2015 Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_formal-parameters">6.3.1. Formal Parameters</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#Type_Modifiers_Optional">6.3.1.1. Optional Parameters</a></li>
+<li><a href="functions.html#Type_Modifiers_Default">6.3.1.2. Default Parameters</a></li>
+<li><a href="functions.html#Type_Modifiers_Variadic">6.3.1.3. Variadic</a></li>
+</ul>
+</li>
+<li><a href="functions.html#_generator-functions">6.3.2. Generator Functions</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#generator-functions-syntax">6.3.2.1. Syntax</a></li>
+<li><a href="functions.html#generator-functions-semantics">6.3.2.2. Semantics</a></li>
+<li><a href="functions.html#_generator-arrow-functions">6.3.2.3. Generator Arrow Functions</a></li>
+</ul>
+</li>
+<li><a href="functions.html#_arrow-function-expression">6.3.3. Arrow Function Expression</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#arrow-function-expression-syntax">6.3.3.1. Syntax</a></li>
+<li><a href="functions.html#arrow-function-expression-semantics-and-type-inference">6.3.3.2. Semantics and Type Inference</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="functions.html#_ecmascript-proposals-function-definition">6.4. ECMAScript Proposals Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_asynchronous-functions">6.4.1. Asynchronous Functions</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#asynchronous-functions-syntax">6.4.1.1. Syntax</a></li>
+<li><a href="functions.html#asynchronous-functions-semantics">6.4.1.2. Semantics</a></li>
+<li><a href="functions.html#_asynchronous-arrow-functions">6.4.1.3. Asynchronous Arrow Functions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="functions.html#_n4js-extended-function-definition">6.5. N4JS Extended Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_generic-functions">6.5.1. Generic Functions</a></li>
+<li><a href="functions.html#_promisifiable-functions">6.5.2. Promisifiable Functions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_conversions-and-reflection">7. Conversions and Reflection</a>
+<ul class="sectlevel2">
+<li><a href="conversions_and_reflection.html#_autoboxing-and-coercing">7.1. Autoboxing and Coercing</a>
+<ul class="sectlevel3">
+<li><a href="conversions_and_reflection.html#_coercing">7.1.1. Coercing</a></li>
+<li><a href="conversions_and_reflection.html#_autoboxing-of-primitives">7.1.2. Autoboxing of Primitives</a></li>
+<li><a href="conversions_and_reflection.html#_autoboxing-of-function-expressions-and-declarations">7.1.3. Autoboxing of Function Expressions and Declarations</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_auto-conversion-of-objects">7.2. Auto-Conversion of Objects</a>
+<ul class="sectlevel3">
+<li><a href="conversions_and_reflection.html#_auto-conversion-of-class-instances">7.2.1. Auto-Conversion of Class Instances</a>
+<ul class="sectlevel4">
+<li><a href="conversions_and_reflection.html#_auto-conversion-of-interface-instances">7.2.1.1. Auto-Conversion of Interface Instances</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_auto-conversion-of-enum-literals">7.2.2. Auto-Conversion of Enum Literals</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_type-cast-and-type-check">7.3. Type Cast and Type Check</a>
+<ul class="sectlevel3">
+<li><a href="conversions_and_reflection.html#_type-cast">7.3.1. Type Cast</a></li>
+<li><a href="conversions_and_reflection.html#_type-check">7.3.2. Type Check</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_reflection-meta-information">7.4. Reflection meta-information</a>
+<ul class="sectlevel3">
+<li><a href="conversions_and_reflection.html#_reflection-for-classes">7.4.1. Reflection for Classes</a></li>
+<li><a href="conversions_and_reflection.html#_reflection-for-interfaces">7.4.2. Reflection for Interfaces</a></li>
+<li><a href="conversions_and_reflection.html#_reflection-for-enumerations">7.4.3. Reflection for Enumerations</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_conversion-of-primitive-types">7.5. Conversion of primitive types</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_expressions">8. Expressions</a>
+<ul class="sectlevel2">
+<li><a href="expressions.html#_ecmascript-5-expressions">8.1. ECMAScript 5 Expressions</a>
+<ul class="sectlevel3">
+<li><a href="expressions.html#_the-this-literal">8.1.1. The this Literal</a></li>
+<li><a href="expressions.html#_identifier">8.1.2. Identifier</a></li>
+<li><a href="expressions.html#_literals">8.1.3. Literals</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#_integer-literals">8.1.3.1. Integer Literals</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_array-literal">8.1.4. Array Literal</a></li>
+<li><a href="expressions.html#_object-literal">8.1.5. Object Literal</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#_properties-6">8.1.5.1. Properties</a></li>
+<li><a href="expressions.html#_scoping-and-linking">8.1.5.2. Scoping and linking</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_parenthesized-expression-and-grouping-operator">8.1.6. Parenthesized Expression and Grouping Operator</a></li>
+<li><a href="expressions.html#_property-accessors">8.1.7. Property Accessors</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#properties-1">8.1.7.1. Properties</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_new-expression">8.1.8. New Expression</a></li>
+<li><a href="expressions.html#_function-expression-2">8.1.9. Function Expression</a></li>
+<li><a href="expressions.html#_function-calls">8.1.10. Function Calls</a></li>
+<li><a href="expressions.html#_postfix-expression">8.1.11. Postfix Expression</a></li>
+<li><a href="expressions.html#_unary-expression">8.1.12. Unary Expression</a></li>
+<li><a href="expressions.html#_multiplicative-expression">8.1.13. Multiplicative Expression</a></li>
+<li><a href="expressions.html#_additive-expression">8.1.14. Additive Expression</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#type-inference-10">8.1.14.1. Type Inference</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_bitwise-shift-expression">8.1.15. Bitwise Shift Expression</a></li>
+<li><a href="expressions.html#_relational-expression">8.1.16. Relational Expression</a></li>
+<li><a href="expressions.html#_equality-expression">8.1.17. Equality Expression</a></li>
+<li><a href="expressions.html#_binary-bitwise-expression">8.1.18. Binary Bitwise Expression</a></li>
+<li><a href="expressions.html#_binary-logical-expression">8.1.19. Binary Logical Expression</a></li>
+<li><a href="expressions.html#_conditional-expression">8.1.20. Conditional Expression</a></li>
+<li><a href="expressions.html#_assignment-expression">8.1.21. Assignment Expression</a></li>
+<li><a href="expressions.html#_comma-expression">8.1.22. Comma Expression</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_ecmascript-6-expressions">8.2. ECMAScript 6 Expressions</a>
+<ul class="sectlevel3">
+<li><a href="expressions.html#_the-super-keyword">8.2.1. The super Keyword</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_ecmascript-7-expressions">8.3. ECMAScript 7 Expressions</a>
+<ul class="sectlevel3">
+<li><a href="expressions.html#_await-expression">8.3.1. Await Expression</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_n4js-specific-expressions">8.4. N4JS Specific Expressions</a>
+<ul class="sectlevel3">
+<li><a href="expressions.html#_class-expression">8.4.1. Class Expression</a></li>
+<li><a href="expressions.html#_cast-as-expression">8.4.2. Cast (As) Expression</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#cast-as-expression-semantics-type-inference">8.4.2.1. Semantics and Type Inference</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#Import_Calls">8.4.3. Import Calls</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#compile-time-expressions">8.5. Compile-Time Expressions</a></li>
+</ul>
+</li>
+<li><a href="statements.html#_statements">9. Statements</a>
+<ul class="sectlevel2">
+<li><a href="statements.html#_ecmascript-5-statements">9.1. ECMAScript 5 Statements</a>
+<ul class="sectlevel3">
+<li><a href="statements.html#_function-or-field-accessor-bodies">9.1.1. Function or Field Accessor Bodies</a></li>
+<li><a href="statements.html#_variable-statement">9.1.2. Variable Statement</a></li>
+<li><a href="statements.html#_if-statement">9.1.3. If Statement</a></li>
+<li><a href="statements.html#_iteration-statements">9.1.4. Iteration Statements</a></li>
+<li><a href="statements.html#_return-statement">9.1.5. Return Statement</a></li>
+<li><a href="statements.html#_with-statement">9.1.6. With Statement</a></li>
+<li><a href="statements.html#_switch-statement">9.1.7. Switch Statement</a></li>
+<li><a href="statements.html#_throw-try-and-catch-statements">9.1.8. Throw, Try, and Catch Statements</a></li>
+<li><a href="statements.html#_debugger-statement">9.1.9. Debugger Statement</a></li>
+</ul>
+</li>
+<li><a href="statements.html#_ecmascript-6-statements">9.2. ECMAScript 6 Statements</a>
+<ul class="sectlevel3">
+<li><a href="statements.html#_let">9.2.1. Let</a></li>
+<li><a href="statements.html#_const">9.2.2. Const</a></li>
+<li><a href="statements.html#_for-of-statement">9.2.3. <code>for &#8230;&#8203; of</code> statement</a></li>
+<li><a href="statements.html#_import-statement">9.2.4. Import Statement</a>
+<ul class="sectlevel4">
+<li><a href="statements.html#Dynamic_Imports">9.2.4.1. Dynamic Imports</a></li>
+<li><a href="statements.html#_immutabilaty-of-imports">9.2.4.2. Immutabilaty of Imports</a></li>
+</ul>
+</li>
+<li><a href="statements.html#_export-statement">9.2.5. Export Statement</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="annotations.html#_annotations">10. Annotations</a>
+<ul class="sectlevel2">
+<li><a href="annotations.html#_introduction-2">10.1. Introduction</a>
+<ul class="sectlevel3">
+<li><a href="annotations.html#_syntax-13">10.1.1. Syntax</a></li>
+<li><a href="annotations.html#_properties-7">10.1.2. Properties</a></li>
+<li><a href="annotations.html#_element-specific-annotations">10.1.3. Element-Specific Annotations</a></li>
+<li><a href="annotations.html#_general-annotations">10.1.4. General Annotations</a>
+<ul class="sectlevel4">
+<li><a href="annotations.html#_idebug">10.1.4.1. IDEBUG</a></li>
+</ul>
+</li>
+<li><a href="annotations.html#idebug-syntax">10.1.5. Syntax</a>
+<ul class="sectlevel4">
+<li><a href="annotations.html#_semantics-11">10.1.5.1. Semantics</a></li>
+<li><a href="annotations.html#_suppress-warnings">10.1.5.2. Suppress Warnings</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="annotations.html#_declaration-of-annotations">10.2. Declaration of Annotations</a></li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_extended-fetaures">11. Extended Fetaures</a>
+<ul class="sectlevel2">
+<li><a href="extended_fetaures.html#_array-and-object-destructuring">11.1. Array and Object Destructuring</a>
+<ul class="sectlevel3">
+<li><a href="extended_fetaures.html#_syntax-14">11.1.1. Syntax</a></li>
+<li><a href="extended_fetaures.html#_semantics-12">11.1.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_dependency-injection">11.2. Dependency Injection</a>
+<ul class="sectlevel3">
+<li><a href="extended_fetaures.html#_di-components-and-injectors">11.2.1. DI Components and Injectors</a>
+<ul class="sectlevel4">
+<li><a href="extended_fetaures.html#_dicomponent-relations">11.2.1.1. DIComponent Relations</a></li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_binders-and-bindings">11.2.2. Binders and Bindings</a></li>
+<li><a href="extended_fetaures.html#_injection-points">11.2.3. Injection Points</a>
+<ul class="sectlevel4">
+<li><a href="extended_fetaures.html#_field-injection">11.2.3.1. Field Injection</a></li>
+<li><a href="extended_fetaures.html#_constructor-injection">11.2.3.2. Constructor Injection</a></li>
+<li><a href="extended_fetaures.html#_method-injection">11.2.3.3. Method Injection</a>
+<ul class="sectlevel5">
+<li><a href="extended_fetaures.html#_provider">11.2.3.3.1. Provider</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_n4js-di-life-cycle-and-scopes">11.2.4. N4JS DI Life Cycle and Scopes</a>
+<ul class="sectlevel4">
+<li><a href="extended_fetaures.html#_injection-cylces">11.2.4.1. Injection Cylces</a></li>
+<li><a href="extended_fetaures.html#_default-scope">11.2.4.2. Default Scope</a></li>
+<li><a href="extended_fetaures.html#_singleton-scope">11.2.4.3. Singleton Scope</a></li>
+<li><a href="extended_fetaures.html#_per-injection-chain-singleton">11.2.4.4. Per Injection Chain Singleton</a></li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_validation-of-callsites-targeting-n4injector-methods">11.2.5. Validation of callsites targeting N4Injector methods</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-annotations">11.2.6. N4JS DI Annotations</a>
+<ul class="sectlevel4">
+<li><a href="extended_fetaures.html#_n4js-di-generateinjector">11.2.6.1. N4JS DI @GenerateInjector</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-withparentinjector">11.2.6.2. N4JS DI @WithParentInjector</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-usebinder">11.2.6.3. N4JS DI @UseBinder</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-binder">11.2.6.4. N4JS DI @Binder</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-bind">11.2.6.5. N4JS DI @Bind</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-provides">11.2.6.6. N4JS DI @Provides</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-inject">11.2.6.7. N4JS DI @Inject</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-singleton">11.2.6.8. N4JS DI @Singleton</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_test-support">11.3. Test Support</a></li>
+<li><a href="extended_fetaures.html#_polyfill-definitions">11.4. Polyfill Definitions</a>
+<ul class="sectlevel3">
+<li><a href="extended_fetaures.html#_runtime-polyfill-definitions">11.4.1. Runtime Polyfill Definitions</a></li>
+<li><a href="extended_fetaures.html#_static-polyfill-definitions">11.4.2. Static Polyfill Definitions</a></li>
+<li><a href="extended_fetaures.html#_transpiling-static-polyfilled-classes">11.4.3. Transpiling static polyfilled classes</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="components.html#_components">12. Components</a>
+<ul class="sectlevel2">
+<li><a href="components.html#_overview-2">12.1. Overview</a></li>
+<li><a href="components.html#Component_Types">12.2. Component Types</a>
+<ul class="sectlevel3">
+<li><a href="components.html#_libraries">12.2.1. Libraries</a></li>
+<li><a href="components.html#_runtime-environment-and-runtime-libraries">12.2.2. Runtime Environment and Runtime Libraries</a></li>
+<li><a href="components.html#_tests">12.2.3. Tests</a></li>
+<li><a href="components.html#_type-definitions">12.2.4. Type Definitions</a></li>
+</ul>
+</li>
+<li><a href="components.html#package-json">12.3. Package.json File</a>
+<ul class="sectlevel3">
+<li><a href="components.html#_basic-properties">12.3.1. Basic Properties</a></li>
+<li><a href="components.html#_n4js-properties">12.3.2. N4JS Properties</a></li>
+<li><a href="components.html#_constraints">12.3.3. Constraints</a></li>
+</ul>
+</li>
+<li><a href="components.html#_support-for-npm-scopes">12.4. Support for NPM Scopes</a></li>
+<li><a href="components.html#sec:N4JS-Type-Definitions">12.5. N4JS Type Definitions</a>
+<ul class="sectlevel3">
+<li><a href="components.html#_specify-type-definition">12.5.1. Specify Type Definition</a></li>
+<li><a href="components.html#_name-conventions">12.5.2. Name Conventions</a></li>
+<li><a href="components.html#_version-conventions">12.5.3. Version Conventions</a>
+<ul class="sectlevel4">
+<li><a href="components.html#_define-a-new-type-definition-package">12.5.3.1. Define a New Type Definition Package</a></li>
+<li><a href="components.html#_using-a-type-definition-package">12.5.3.2. Using a Type Definition Package</a></li>
+<li><a href="components.html#_rational">12.5.3.3. Rational</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="components.html#_modules">12.6. Modules</a></li>
+<li><a href="components.html#_api-and-implementation-component">12.7. API and Implementation Component</a>
+<ul class="sectlevel3">
+<li><a href="components.html#_execution-of-api-and-implementation-components">12.7.1. Execution of API and Implementation Components</a></li>
+<li><a href="components.html#_api-and-implementation-with-di">12.7.2. API and Implementation With DI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="plainjs.html#_plainjs">13. PlainJS</a>
+<ul class="sectlevel2">
+<li><a href="plainjs.html#_type-inference-and-validation-for-plain-js">13.1. Type Inference and Validation for Plain JS</a></li>
+<li><a href="plainjs.html#_external-declarations">13.2. External Declarations</a>
+<ul class="sectlevel3">
+<li><a href="plainjs.html#_declaring-externals">13.2.1. Declaring externals</a></li>
+<li><a href="plainjs.html#_instantiating-external-classes">13.2.2. Instantiating external classes</a></li>
+<li><a href="plainjs.html#_implementation-of-external-declarations">13.2.3. Implementation of External Declarations</a></li>
+<li><a href="plainjs.html#_example">13.2.4. Example</a></li>
+</ul>
+</li>
+<li><a href="plainjs.html#_global-definitions">13.3. Global Definitions</a></li>
+<li><a href="plainjs.html#_runtime-definitions">13.4. Runtime Definitions</a></li>
+<li><a href="plainjs.html#_applying-polyfills">13.5. Applying Polyfills</a></li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_jsdoc-2">14. JSDoc</a>
+<ul class="sectlevel2">
+<li><a href="jsdoc.html#_general-n4jsdoc-features">14.1. General N4JSDoc Features</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#_provided-inline-tags">14.1.1. Provided Inline Tags</a>
+<ul class="sectlevel4">
+<li><a href="jsdoc.html#jsdoc_tag__code">14.1.1.1. @code</a></li>
+<li><a href="jsdoc.html#jsdoc_tag__link">14.1.1.2. @link</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_n4jsdoc-for-user-projects">14.2. N4JSdoc for User Projects</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#_standard-tags">14.2.1. Standard Tags</a>
+<ul class="sectlevel4">
+<li><a href="jsdoc.html#_-author">14.2.1.1. @author</a></li>
+<li><a href="jsdoc.html#jsdoc_tag_param">14.2.1.2. @param</a></li>
+<li><a href="jsdoc.html#jsdoc_tag_return">14.2.1.3. @return</a></li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_test-related-tags">14.2.2. Test Related Tags</a>
+<ul class="sectlevel4">
+<li><a href="jsdoc.html#jsdoc_tag__testee">14.2.2.1. @testee</a></li>
+<li><a href="jsdoc.html#jsdoc_tag__testeeFromType">14.2.2.2. @testeeFromType</a></li>
+<li><a href="jsdoc.html#_testeeType_and__testeeMember">14.2.2.3. @testeeType and @testeeMember</a></li>
+<li><a href="jsdoc.html#jsdoc_tag_reqid_in_Tests">14.2.2.4. @reqid in Tests</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_n4jsdoc-for-api-and-implementation-projects">14.3. N4JSDoc for API and Implementation Projects</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#jsdoc_tag__apiNote">14.3.1. @apiNote</a></li>
+<li><a href="jsdoc.html#API_Project_Tags">14.3.2. API Project Tags</a>
+<ul class="sectlevel4">
+<li><a href="jsdoc.html#jsdoc_tag_apiState">14.3.2.1. @apiState</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsx.html#_jsx">15. JSX</a>
+<ul class="sectlevel2">
+<li><a href="jsx.html#_jsx-support">15.1. JSX Support</a></li>
+<li><a href="jsx.html#_jsx-backend">15.2. JSX Backend</a></li>
+</ul>
+</li>
+<li><a href="grammars.html#_grammars">16. Grammars</a>
+<ul class="sectlevel2">
+<li><a href="grammars.html#_type-expressions-grammar">16.1. Type Expressions Grammar</a></li>
+<li><a href="grammars.html#_n4js-language-grammar">16.2. N4JS Language Grammar</a></li>
+</ul>
+</li>
+<li><a href="jsobjects.html#_jsobjects">17. JSObjects</a>
+<ul class="sectlevel2">
+<li><a href="jsobjects.html#_object">17.1. Object</a></li>
+<li><a href="jsobjects.html#_string">17.2. String</a></li>
+<li><a href="jsobjects.html#_boolean">17.3. Boolean</a></li>
+<li><a href="jsobjects.html#_number">17.4. Number</a>
+<ul class="sectlevel3">
+<li><a href="jsobjects.html#_static-attributes">17.4.1. Static Attributes</a></li>
+</ul>
+</li>
+<li><a href="jsobjects.html#function">17.5. Function</a></li>
+<li><a href="jsobjects.html#_error">17.6. Error</a></li>
+<li><a href="jsobjects.html#_array">17.7. Array</a></li>
+<li><a href="jsobjects.html#_date">17.8. Date</a></li>
+<li><a href="jsobjects.html#_math">17.9. Math</a>
+<ul class="sectlevel3">
+<li><a href="jsobjects.html#static-attributes-1">17.9.1. Static Attributes</a></li>
+</ul>
+</li>
+<li><a href="jsobjects.html#_regexp">17.10. RegExp</a></li>
+<li><a href="jsobjects.html#_json">17.11. JSON</a></li>
+</ul>
+</li>
+<li><a href="#_n4js-objects">18. N4JS Objects</a>
+<ul class="sectlevel2">
+<li><a href="#_reflection-model">18.1. Reflection Model</a></li>
+<li><a href="#_error-types">18.2. Error Types</a>
+<ul class="sectlevel3">
+<li><a href="#_n4apinotimplemented">18.2.1. N4ApiNotImplemented</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_acronyms.html#_acronyms">Appendix A: Acronyms</a></li>
+<li><a href="appendix_b_license.html#sec:License">Appendix B: License</a></li>
+<li><a href="appendix_c_bibliography.html#_bibliography">Appendix C: Bibliography</a></li>
+</ul>
+</div>
+</div>
+<div id="content"><div class="sect1">
+<h2 id="_n4js-objects"><a class="anchor" href="#_n4js-objects"></a><a class="link" href="#_n4js-objects">18. N4JS Objects</a></h2>
+<div class="sectionbody">
+<div class="sect2">
+<h3 id="_reflection-model"><a class="anchor" href="#_reflection-model"></a><a class="link" href="#_reflection-model">18.1. Reflection Model</a></h3>
+<div class="paragraph">
+<p>N4JS provided metadata for reflection (and introspection). This
+information is available via instances of some reflection model classes
+(described below) attached to types and (in some cases) functions.</p>
+</div>
+<div class="paragraph">
+<p>The following class diagrams shows the defined classes. Note that for
+performance reasons, the actual structure may vary from the model.</p>
+</div>
+<div id="fig-n4js-reflection-classes" class="imageblock">
+<div class="content">
+<img src="chapters/a03_n4jsobjects/fig/cd_reflectionModel.svg" alt="cd reflectionModel">
+</div>
+<div class="title">Figure 17. N4JS Reflection Classes</div>
+</div>
+<div class="paragraph">
+<p>Remark: This section is work in progress. The final goal is to provide a
+metamodel similar to Ecore, but we will only add new features if needed.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">/**
+ * Base class for all N4 reflective elements.
+ */
+export public abstract class N4Element extends Object {
+    /**
+     * Annotations attached to this element.
+     */
+    public Array&lt;N4Annotation&gt; annotations = [];
+
+    /**
+     * The origin string formed as &lt;ID-VERSION&gt;, where ID is containing project artefact id, and VERSION is its version
+     */
+    public String origin;
+
+    /**
+     * Returns true if an annotation with the given name is attached to the element.
+     */
+    public boolean hasAnnotation(string name) {
+        return !!this.anyAnnotation(name)
+    }
+
+    /**
+     * Returns any annotation with the given name attached to the element, or null if no such annotation is found.
+     */
+    public N4Annotation anyAnnotation(string name) {
+        for (var i=this.annotations.length-1; i&gt;=0; i--) {
+            var a = this.annotations[i];
+            if (a) {
+                return a;
+            }
+        }
+        return null;
+    }
+    /**
+     * Returns all annotations with the given name attached to the element, or an empty array if no such annotations are found.
+     */
+    public Array&lt;N4Annotation&gt; allAnnotations(string name) {
+        return this.annotations.filter(function(a){return a.name==name});
+    }
+}
+
+/**
+ * Base class for all reflective classes with a name.
+ */
+export public abstract class N4NamedElement extends N4Element {
+    /**
+     * The simple name of a named element.
+     */
+    public string name;
+}
+
+/**
+ * Base class for all reflective classes describing a type (declaration).
+ */
+export public abstract class N4Type extends N4NamedElement {
+    /**
+     * The FQN of the type.
+     */
+    public string fqn;
+
+    /**
+     * Returns true if this N4Class describes an N4-class declaration.
+     */
+    public boolean get isClass() { return false; }
+
+    /**
+     * Returns true if this N4Class describes an N4-interface declaration.
+     */
+    public boolean get isInterface() { return false; }
+
+    /**
+     * Returns true if this N4Class describes an N4-enumeration declaration.
+     */
+    public boolean get isEnum() { return false; }
+}
+
+/**
+ * Base class for meta types of classes or interfaces.
+ */
+export public abstract class N4Classifier extends N4Type {
+
+    /**
+     * The N4Class of the super type, may be null if super type is a not an N4Class.
+     */
+    public N4Class n4superType;
+
+    /**
+     * Array of the FQN of all (transitively) implemented interfaces, i.e. interfaces directly implemented by this class, its super
+     * class or interfaces extended by directly implemented interfaces.
+     */
+    public Array&lt;string&gt; allImplementedInterfaces;
+
+    /**
+     * Array of all owned members, that is members defined in the class directly.
+     * This field is private as it is an internal detail, members are accessed via methods defined in this class.
+     */
+    private Array&lt;N4Member&gt; ownedMembers;
+
+    /**
+     * Array of all consumed members, that is members mixed into the classifier via interface implementation and default methods.
+     * This field is private as it is an internal detail, members are accessed via methods defined in this class.
+     */
+    private Array&lt;N4Member&gt; consumedMembers;
+
+    /**
+     * Only used internally, must not be called by client.
+     */
+    protected constructor(@Spec ~~this spec) {}
+
+    /**
+     * Returns all members defined by this class directly, consumed, and inherited. The boolean flags control which members are returned.
+     *
+     * @param consumed if set, consumed members are returned as well (false by default)
+     * @param inherited if set, inherited members are returned as well (false by default)
+     * @param _static if set, static members are returned, otherwise instance members (false by default).
+     * @return array of members, may be empty but never null
+     */
+    public Array&lt;? extends N4Member&gt; members(boolean? consumed, boolean? inherited, boolean? _static) {
+        return null; // TODO
+    }
+
+    /**
+     * Returns all members defined in this classifier (or inherited) with an annotation
+     * of given name attached to it. The boolean flags control which methods are returned.
+     *
+     * @param name name of annotation to be used as filter
+     * @param consumed if set, consumed members are returned as well (false by default)
+     * @param inherited if set, inherited members are returned as well (false by default)
+     * @param _static if set, static members are returned, otherwise instance members (false by default).
+     * @return array of members, may be empty but never null
+     */
+    public Array&lt;? extends N4Member&gt; membersWithAnnotation(string name, boolean? consumed, boolean? inherited, boolean? _static) {
+        return null; // TODO
+    }
+
+    /**
+     * Returns all data fields defined by this class directly, consumed, and inherited. The boolean flags control which data fields are returned.
+     *
+     * @param consumed if set, consumed data fields are returned as well (false by default)
+     * @param inherited if set, inherited data fields are returned as well (false by default)
+     * @param _static if set, static data fields are returned, otherwise instance members (false by default).
+     * @return array of data fields, may be empty but never null
+     */
+    public Array&lt;? extends N4DataField&gt; dataFields(boolean? consumed, boolean? inherited, boolean? _static) {
+        return null; // TODO
+    }
+
+    /**
+     * Returns all data fields defined in this classifier (or inherited) with an annotation
+     * of given name attached to it. The boolean flags control which data fields are returned.
+     *
+     * @param name name of annotation to be used as filter
+     * @param consumed if set, consumed data fields are returned as well (false by default)
+     * @param inherited if set, inherited data fields are returned as well (false by default)
+     * @param _static if set, static data fields are returned, otherwise instance members (false by default).
+     * @return array of data fields, may be empty but never null
+     */
+    public Array&lt;? extends N4DataField&gt; dataFieldsWithAnnotation(string name, boolean? consumed, boolean? inherited, boolean? _static) {
+        return null; // TODO
+    }
+
+    /**
+     * Returns all methods defined by this class directly, consumed, and inherited. The boolean flags control which methods are returned.
+     *
+     * @param consumed if set, consumed methods are returned as well (false by default)
+     * @param inherited if set, inherited methods are returned as well (false by default)
+     * @param _static if set, static methods are returned, otherwise instance members (false by default).
+     * @return array of methods, may be empty but never null
+     */
+    public Array&lt;? extends N4Method&gt; methods(boolean? consumed, boolean? inherited, boolean? _static) {
+        return null; // TODO
+    }
+
+    /**
+     * Returns all methods defined in this classifier (or inherited) with an annotation
+     * of given name attached to it. The boolean flags control which methods are returned.
+     *
+     * @param name name of annotation to be used as filter
+     * @param consumed if set, consumed methods are returned as well (false by default)
+     * @param inherited if set, inherited methods are returned as well (false by default)
+     * @param _static if set, static methods are returned, otherwise instance members (false by default).
+     * @return array of methods, may be empty but never null
+     */
+    public Array&lt;? extends N4Method&gt; methodsWithAnnotation(string name, boolean? consumed, boolean? inherited, boolean? _static) {
+        return null; // TODO
+    }
+
+
+}
+
+/**
+ * Meta information of an n4 class.
+ */
+export @Final public class N4Class extends N4Classifier {
+
+    /**
+     * Returns the N4Class instance for a given n4object. This is similar to
+     * {@code n4object.constructor.n4type}, however it can also be used in interfaces
+     * to get reflective information of the implementor.
+     */
+    public static N4Class of(N4Object n4object) {
+        return n4object.constructor.n4type
+    }
+
+    /**
+     * Returns true if this N4Class describes an N4-class declaration.
+     */
+    @Override
+    public boolean get isClass() { return true; }
+}
+
+
+/**
+ * Meta information of an n4 interface.
+ */
+export @Final public class N4Interface extends N4Classifier {
+    /**
+     * Returns true if this N4Class describes an N4-interface declaration.
+     */
+    @Override
+    public boolean get isInterface() { return true; }
+}
+
+/**
+ * Description of a member, that is a method or field.
+ */
+export public abstract class N4Member extends N4Element {
+    public string name;
+}
+
+/**
+ * Description of a method.
+ */
+export @Final public class N4Method extends N4Member {
+    public Function jsFunction;
+}
+
+/**
+ * Description of a simple data field.
+ */
+export @Final public class N4DataField extends N4Member {
+}
+
+/**
+ * Description of an accessor, that is a getter or setter.
+ */
+export @Final public class N4Accessor extends N4Member {
+    /**
+     * Flag indicating whether accessor is a getter or setter, internal detail.
+     */
+    private boolean getter;
+    /**
+     * Returns true if accessor is a getter.
+     */
+    public boolean isGetter() { return this.getter; }
+    /**
+     * Returns true if accessor is a setter.
+     */
+    public boolean isSetter() { return ! this.getter; }
+}
+
+/**
+ * Description of an N4Enum
+ */
+export @Final public class N4EnumType extends N4Type {
+    /**
+     * Returns true if this N4Clasifier describes an N4-enumeration declaration.
+     */
+    @Override public boolean get isEnum() { return true; }
+    /**
+     * Returns the N4EnumType instance for a given enum literal. This is similar to
+     * {@code n4enum.constructor.n4type}.
+     */
+    public static N4EnumType of(N4Enum n4enum) {
+        return n4enum.constructor.n4type
+    }
+}
+
+/**
+ * Base class for all enumeration, literals are assumed to be static constant fields of concrete subclasses.
+ */
+export public abstract class N4Enum  extends Object {
+
+    /**
+     * Returns the name of a concrete literal
+     */
+    public abstract string get name();
+
+    /**
+     * Returns the value of a concrete literal. If no value is
+     * explicitly set, it is similar to the name.
+     */
+    public abstract string get value()
+
+    /**
+     * Returns a string representation of a concrete literal, it returns
+     * the same result as value()
+     */
+    @Override public string toString() { return this.value }
+
+    /**
+     * Returns the enum class object of this enum literal for reflection.
+     * The very same meta class object can be retrieved from the enumeration type directly.
+     */
+    public abstract N4Enum get n4Enum()
+
+    /**
+     * Natively overridden by concrete enums.
+     */
+    public static Array&lt;? extends N4Enum&gt; get values() { return null; }
+
+    /**
+     * Natively overridden by concrete enums.
+     */
+    public static N4Enum valueByName(string name) { return null; }
+
+    /**
+     * Returns the meta class object of this class for reflection.
+     * The very same meta class object can be retrieved from an instance by calling
+     * &lt;code&gt;instance.constructor.n4type&lt;/code&gt;
+     */
+    public static N4EnumType get n4type() { return null; }
+}
+
+/**
+ * Annotation with value.
+ */
+export @Final public class N4Annotation extends Object {
+    public string name;
+    public union{string,number} value;
+}
+
+/**
+ * The base class for all instances of n4 classes.
+ */
+export public class N4Object {
+    /**
+     * Returns the meta class object of this class for reflection.
+     * The very same meta class object can be retrieved from an instance by calling
+     * &lt;code&gt;instance.constructor.n4type&lt;/code&gt;
+     */
+    // defined in types model, added by $makeClass:
+    // public static N4Class get n4type() { return null; }
+}</code></pre>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_error-types"><a class="anchor" href="#_error-types"></a><a class="link" href="#_error-types">18.2. Error Types</a></h3>
+<div class="paragraph">
+<p>N4JS provides additional Error types as subtypes of <code>Error</code>.</p>
+</div>
+<div class="sect3 language-n4js">
+<h4 id="_n4apinotimplemented"><a class="anchor" href="#_n4apinotimplemented"></a><a class="link" href="#_n4apinotimplemented">18.2.1. N4ApiNotImplemented</a></h4>
+<div class="paragraph">
+<p>Considering API definitions and concrete implementations of those APIs
+the error <code>N4-Api-Not-Implemented-Error</code> is introduced to specifically report missing implementations.
+Instances of this error type are inserted internally during the
+transpilation of API-implementing projects. Whenever a difference to the
+API in form of a missing implementation is encountered, the transpiler
+will insert stub-code throwing an instance of <code>N4-Api-Not-Implemented-Error</code>.</p>
+</div>
+<div class="paragraph">
+<p>API-testing projects can catch those errors and act accordingly. This
+enables tracking of completeness of implementations by counting the
+occasions an <code>N4-Api-NotImplemented-Error</code> was encountered.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">/**
+ * Error type reporting a not implemented situation.
+ */
+public class N4ApiNotImplementedError extends Error {  }</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div id="footer">
+<div id="footer-text">
+Version 0.9<br>
+Last updated 2019-08-07 15:02:40 CEST
+</div>
+</div>
+<!-- ************* docinfo-footer *************************************************************** -->
+<div class="Grid social" style="color:#d5dfea">
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <h2>Quick Links</h2>
+    <ul>
+      <li><a href="../downloads.html">Download</a></li>
+      <li><a href="../userguides/index.html">Documentation</a></li>
+      <li><a href="https://github.com/eclipse/n4js/">Source</a></li>
+      <li><a href="https://github.com/eclipse/n4js/issues">Issues</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="https://www.eclipse.org/forums/index.php/f/365/">Forum</a></li>
+      <li><a href="http://n4js.blogspot.de/">Blog</a></li>
+      <li><a href="https://dev.eclipse.org/mailman/listinfo/n4js-dev">Mailing List</a></li>
+      <li><a href="https://projects.eclipse.org/projects/technology.n4js">Eclipse Project Page</a></li>
+      <li><a href="https://twitter.com/n4jsdev">Tweets by n4jsdev</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="http://www.eclipse.org/">Eclipse Home</a></li>
+      <li><a href="http://www.eclipse.org/legal/privacy.php">Privacy Policy</a></li>
+      <li><a href="http://www.eclipse.org/legal/termsofuse.php">Terms of Use</a></li>
+      <li><a href="http://www.eclipse.org/legal/copyright.php">Copyright Agent</a></li>
+      <li><a href="http://www.eclipse.org/legal/">Legal</a></li>
+    </ul>
+  </div>
+  <div style="clear: both; height: 0; overflow: hidden;"></div>
+</div>
+
+<!-- ************* UI Scripts ************* -->
+<script type="text/javascript" src="scripts/back-to-top.js"></script>
+
+<script type="text/javascript" src="scripts/treeview.js"></script>
+<script type="text/javascript" src="scripts/toc.js"></script>
+
+<!-- ************* Prism.js Syntax Highlighting ************* -->
+<script src="scripts/prism.js"></script>
+
+<script type="text/javascript">
+	// Add the 'toclist' id for search function
+	$(".toc2 > ul").attr('id', 'toclist');
+	// Generate a Search input form
+	$("#toclist > li:first-of-type").before('<input type="text" id="pagesearch" onkeyup="search()" placeholder="Search for section...">');
+	$("#toclist > li:first-of-type").before('<i id="clear" class="fa fa-times-circle-o"></i>');
+	$("#clear").click(function(){
+	    $("#pagesearch").val('');
+	    search();
+	    $('.toc2 > ul').treeView('collapseAll');
+	});
+	// intialize Treeview.js
+	$(".toc2 > ul").treeView();
+	// Initialize Scrollspy
+</script>
+<!-- ************* docinfo-footer *************************************************************** -->
+</body>
+</html>
\ No newline at end of file
diff --git a/spec/names.html b/spec/names.html
new file mode 100644
index 0000000..5c28221
--- /dev/null
+++ b/spec/names.html
@@ -0,0 +1,1881 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="generator" content="Asciidoctor 1.5.5">
+<meta name="author" content="2019-08-07 15:02:40 CEST">
+<title>N4JS Language Specification</title>
+<link rel="stylesheet" href="styles/spec.min.css">
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.6.3/css/font-awesome.min.css">
+<!-- ************* docinfo ******************************************************************* -->
+
+
+<!-- ************* Favicon ************-->
+<link rel="icon" href="images/favicon.ico" />
+
+<!-- ************* Back-to-top JQuery ************* -->
+<script src="https://code.jquery.com/jquery-1.12.4.js"></script>
+<script src="https://code.jquery.com/ui/1.12.0/jquery-ui.js"></script>
+
+
+<link href="styles/prism.min.css" rel="stylesheet" />
+<script type="text/javascript" async
+  src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2/MathJax.js?config=TeX-MML-AM_CHTML">
+</script>
+
+<!-- ************* Styles ************* -->
+<link rel="stylesheet" type="text/css" href="styles/n4jsspec-adoc.css">
+
+
+<!-- ****************** NavBar ****************** -->
+<div id="menubar">
+	<div class="banner">
+        <a href="https://www.eclipse.org/n4js/#"><img id="logo" src="images/n4js-logo.png" alt="Eclipse N4JS"></a>
+    </div>
+<ul>
+  <li><a href="index.html">Index</a></li>
+</ul>
+</div>
+<!-- ************* docinfo ******************************************************************* -->
+<style>
+      .admonitionblock td.icon .icon-todo:before{content:"\f249";color:#f4ee42}
+    </style>
+</head>
+<body class="book toc2 toc-left">
+<div id="header">
+<h1>N4JS Language Specification</h1>
+<div class="details">
+<span id="author" class="author">2019-08-07 15:02:40 CEST</span><br>
+<span id="revnumber">version 0.9</span>
+</div>
+<div id="toc" class="toc2">
+<div id="toctitle">Table of Contents</div>
+<ul class="sectlevel1">
+<li><a href="introduction.html#_introduction">1. Introduction</a>
+<ul class="sectlevel2">
+<li><a href="introduction.html#_notation">1.1. Notation</a>
+<ul class="sectlevel3">
+<li><a href="introduction.html#_grammar-notation">1.1.1. Grammar Notation</a></li>
+<li><a href="introduction.html#_type-judgments-and-rules-and-constraints-notation">1.1.2. Type Judgments and Rules and Constraints Notation</a>
+<ul class="sectlevel4">
+<li><a href="introduction.html#_typing-rules-and-judgments">1.1.2.1. Typing Rules and Judgments</a></li>
+<li><a href="introduction.html#_types-of-an-element">1.1.2.2. Types of an Element</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="introduction.html#_auxiliary-functions">1.2. Auxiliary Functions</a>
+<ul class="sectlevel3">
+<li><a href="introduction.html#_binding">1.2.1. Binding</a></li>
+<li><a href="introduction.html#_merging-types">1.2.2. Merging Types</a>
+<ul class="sectlevel4">
+<li><a href="introduction.html#_logic-formulas">1.2.2.1. Logic Formulas</a></li>
+</ul>
+</li>
+<li><a href="introduction.html#_symbols-and-font-convention">1.2.3. Symbols and Font Convention</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="grammar.html#_grammar">2. Grammar</a>
+<ul class="sectlevel2">
+<li><a href="grammar.html#_lexical-conventions">2.1. Lexical Conventions</a>
+<ul class="sectlevel3">
+<li><a href="grammar.html#_identifier-names-and-identifiers">2.1.1. Identifier Names and Identifiers</a></li>
+<li><a href="grammar.html#_this-keyword">2.1.2. This Keyword</a></li>
+<li><a href="grammar.html#_regular-expression-literals">2.1.3. Regular Expression Literals</a></li>
+<li><a href="grammar.html#_automatic-semicolon-insertion">2.1.4. Automatic Semicolon Insertion</a></li>
+<li><a href="grammar.html#_jsdoc">2.1.5. JSDoc</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#_names">3. Names</a>
+<ul class="sectlevel2">
+<li><a href="#_access-control">3.1. Access Control</a></li>
+<li><a href="#_accessibility-of-types-top-level-variables-and-function-declarations">3.2. Accessibility of Types, Top-Level Variables and Function Declarations</a>
+<ul class="sectlevel3">
+<li><a href="#_accessibility-of-members">3.2.1. Accessibility of Members</a></li>
+<li><a href="#_valid-names">3.2.2. Valid Names</a></li>
+<li><a href="#_qualified-names">3.2.3. Qualified Names</a></li>
+<li><a href="#_name-duplicates">3.2.4. Name Duplicates</a>
+<ul class="sectlevel4">
+<li><a href="#_lexical-environment">3.2.4.1. Lexical Environment</a></li>
+<li><a href="#_duplicates-and-shadowing">3.2.4.2. Duplicates and Shadowing</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="types.html#_types">4. Types</a>
+<ul class="sectlevel2">
+<li><a href="types.html#_overview">4.1. Overview</a></li>
+<li><a href="types.html#_type-expressions">4.2. Type Expressions</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_syntax">4.2.1. Syntax</a></li>
+<li><a href="types.html#_properties">4.2.2. Properties</a></li>
+<li><a href="types.html#_semantics">4.2.3. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_type-inference">4.3. Type Inference</a></li>
+<li><a href="types.html#_generic-and-parameterized-types">4.4. Generic and Parameterized Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_generic-types">4.4.1. Generic Types</a></li>
+<li><a href="types.html#_type-variables">4.4.2. Type Variables</a></li>
+<li><a href="types.html#_parameterized-types">4.4.3. Parameterized Types</a></li>
+</ul>
+</li>
+<li><a href="types.html#_primitive-ecmascript-types">4.5. Primitive ECMAScript Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_undefined-type">4.5.1. Undefined Type</a></li>
+<li><a href="types.html#_null-type">4.5.2. Null Type</a></li>
+<li><a href="types.html#_primitive-boolean-type">4.5.3. Primitive Boolean Type</a></li>
+<li><a href="types.html#_primitive-string-type">4.5.4. Primitive String Type</a></li>
+<li><a href="types.html#_primitive-number-type">4.5.5. Primitive Number Type</a></li>
+<li><a href="types.html#_primitive-type-int">4.5.6. Primitive Type int</a></li>
+<li><a href="types.html#_primitive-symbol-type">4.5.7. Primitive Symbol Type</a></li>
+</ul>
+</li>
+<li><a href="types.html#_primitive-n4js-types">4.6. Primitive N4JS Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_any-type">4.6.1. Any Type</a>
+<ul class="sectlevel4">
+<li><a href="types.html#any-type-semantics">4.6.1.1. Semantics</a></li>
+<li><a href="types.html#any-type-type-inference">4.6.1.2. Type Inference</a>
+<ul class="sectlevel5">
+<li><a href="types.html#_default-type-of-variables">4.6.1.2.1. Default Type of Variables</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="types.html#_void-type">4.6.2. Void Type</a>
+<ul class="sectlevel4">
+<li><a href="types.html#void-type-semantics">4.6.2.1. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_unknown-type">4.6.3. Unknown Type</a></li>
+<li><a href="types.html#_primitive-pathselector-and-i18nkey">4.6.4. Primitive Pathselector and I18nKey</a>
+<ul class="sectlevel4">
+<li><a href="types.html#pathselector-semantics">4.6.4.1. Semantics</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="types.html#_built-in-ecmascript-object-types">4.7. Built-in ECMAScript Object Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#ECMAScript-objects-semantics">4.7.1. Semantics</a></li>
+<li><a href="types.html#_object-type">4.7.2. Object Type</a></li>
+<li><a href="types.html#_function-object-type">4.7.3. Function-Object-Type</a></li>
+<li><a href="types.html#_array-object-type">4.7.4. Array Object Type</a></li>
+<li><a href="types.html#_string-object-type">4.7.5. String Object Type</a></li>
+<li><a href="types.html#_boolean-object-type">4.7.6. Boolean Object Type</a></li>
+<li><a href="types.html#_number-object-type">4.7.7. Number Object Type</a></li>
+<li><a href="types.html#_global-object-type">4.7.8. Global Object Type</a></li>
+<li><a href="types.html#_symbol">4.7.9. Symbol</a></li>
+<li><a href="types.html#_promise">4.7.10. Promise</a></li>
+<li><a href="types.html#_iterator-interface">4.7.11. Iterator Interface</a></li>
+<li><a href="types.html#_iterable-interface">4.7.12. Iterable Interface</a></li>
+</ul>
+</li>
+<li><a href="types.html#_built-in-n4js-types">4.8. Built-In N4JS Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_n4object">4.8.1. N4Object</a>
+<ul class="sectlevel4">
+<li><a href="types.html#N4Object-semantics">4.8.1.1. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_n4class">4.8.2. N4Class</a></li>
+<li><a href="types.html#IterableN">4.8.3. IterableN</a></li>
+</ul>
+</li>
+<li><a href="types.html#_type-modifiers">4.9. Type Modifiers</a>
+<ul class="sectlevel3">
+<li><a href="types.html#Type_Modifiers_Dynamic">4.9.1. Dynamic</a></li>
+<li><a href="types.html#_optional-return-types">4.9.2. Optional Return Types</a></li>
+</ul>
+</li>
+<li><a href="types.html#_union-and-intersection-type-composed-types">4.10. Union and Intersection Type (Composed Types)</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_union-type">4.10.1. Union Type</a>
+<ul class="sectlevel4">
+<li><a href="types.html#union-type-syntax">4.10.1.1. Syntax</a></li>
+<li><a href="types.html#union-type-semantics">4.10.1.2. Semantics</a></li>
+<li><a href="types.html#_warnings">4.10.1.3. Warnings</a></li>
+</ul>
+</li>
+<li><a href="types.html#_intersection-type">4.10.2. Intersection Type</a>
+<ul class="sectlevel4">
+<li><a href="types.html#intersection-type-syntax">4.10.2.1. Syntax</a></li>
+<li><a href="types.html#intersection-type-semantics">4.10.2.2. Semantics</a></li>
+<li><a href="types.html#_warnings-2">4.10.2.3. Warnings</a></li>
+</ul>
+</li>
+<li><a href="types.html#_composed-types-in-wildcards">4.10.3. Composed Types in Wildcards</a></li>
+<li><a href="types.html#_property-access-for-composed-types">4.10.4. Property Access for Composed Types</a>
+<ul class="sectlevel4">
+<li><a href="types.html#_properties-of-union-type">4.10.4.1. Properties of Union Type</a>
+<ul class="sectlevel5">
+<li><a href="types.html#_remarks-on-union-type-s-members">4.10.4.1.1. Remarks on union type’s members:</a></li>
+</ul>
+</li>
+<li><a href="types.html#_properties-of-intersection-type">4.10.4.2. Properties of Intersection Type</a>
+<ul class="sectlevel5">
+<li><a href="types.html#_remarks-on-intersection-type-s-methods">4.10.4.2.1. Remarks on intersection type’s methods:</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="types.html#_constructor-and-classifier-type">4.11. Constructor and Classifier Type</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_syntax-3">4.11.1. Syntax</a></li>
+<li><a href="types.html#_semantics-2">4.11.2. Semantics</a></li>
+<li><a href="types.html#_constructors-and-prototypes-in-ecmascript-2015">4.11.3. Constructors and Prototypes in ECMAScript 2015</a></li>
+</ul>
+</li>
+<li><a href="types.html#_this-type">4.12. This Type</a>
+<ul class="sectlevel3">
+<li><a href="types.html#this-type-syntax">4.12.1. Syntax</a></li>
+<li><a href="types.html#this-keyword-semantics">4.12.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_enums">4.13. Enums</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_enums-n4js">4.13.1. Enums (N4JS)</a>
+<ul class="sectlevel4">
+<li><a href="types.html#enums-syntax">4.13.1.1. Syntax</a></li>
+<li><a href="types.html#enums-semantics">4.13.1.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_string-based-enums">4.13.2. String-Based Enums</a></li>
+</ul>
+</li>
+<li><a href="types.html#_short-hand-syntax">4.14. Short-Hand Syntax</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_array-short-hand-syntax">4.14.1. Array Short-Hand Syntax</a></li>
+<li><a href="types.html#_iterablen-short-hand-syntax">4.14.2. IterableN Short-Hand Syntax</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="classifiers.html#_classifiers">5. Classifiers</a>
+<ul class="sectlevel2">
+<li><a href="classifiers.html#_n4js-specific-classifiers">5.1. N4JS Specific Classifiers</a>
+<ul class="sectlevel3">
+<li><a href="classifiers.html#_properties-2">5.1.1. Properties</a></li>
+<li><a href="classifiers.html#_common-semantics-of-classifiers">5.1.2. Common Semantics of Classifiers</a></li>
+<li><a href="classifiers.html#_classes">5.1.3. Classes</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_definition-of-classes">5.1.3.1. Definition of Classes</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#class-syntax">5.1.3.1.1. Syntax</a></li>
+<li><a href="classifiers.html#class-properties">5.1.3.1.2. Properties</a></li>
+<li><a href="classifiers.html#class-type-inference">5.1.3.1.3. Type Inference</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#class-semantics">5.1.3.2. Semantics</a></li>
+<li><a href="classifiers.html#_final-modifier">5.1.3.3. Final Modifier</a></li>
+<li><a href="classifiers.html#_abstract-classes">5.1.3.4. Abstract Classes</a></li>
+<li><a href="classifiers.html#_non-instantiable-classes">5.1.3.5. Non-Instantiable Classes</a></li>
+<li><a href="classifiers.html#_superclass">5.1.3.6. Superclass</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_interfaces">5.1.4. Interfaces</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_definition-of-interfaces">5.1.4.1. Definition of Interfaces</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#interfaces-syntax">5.1.4.1.1. Syntax</a></li>
+<li><a href="classifiers.html#interfaces-properties">5.1.4.1.2. Properties</a></li>
+<li><a href="classifiers.html#interfaces-type-inference">5.1.4.1.3. Type Inference</a></li>
+<li><a href="classifiers.html#interfaces-semantics">5.1.4.1.4. Semantics</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="classifiers.html#_generic-classifiers">5.1.5. Generic Classifiers</a></li>
+<li><a href="classifiers.html#sec:definition-site-variance">5.1.6. Definition-Site Variance</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_members">5.2. Members</a>
+<ul class="sectlevel3">
+<li><a href="classifiers.html#_syntax-4">5.2.1. Syntax</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_properties-3">5.2.1.1. Properties</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_semantics-3">5.2.2. Semantics</a></li>
+<li><a href="classifiers.html#_methods">5.2.3. Methods</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_syntax-5">5.2.3.1. Syntax</a></li>
+<li><a href="classifiers.html#_properties-4">5.2.3.2. Properties</a></li>
+<li><a href="classifiers.html#_semantics-4">5.2.3.3. Semantics</a></li>
+<li><a href="classifiers.html#_final-methods">5.2.3.4. Final Methods</a></li>
+<li><a href="classifiers.html#_abstract-methods">5.2.3.5. Abstract Methods</a></li>
+<li><a href="classifiers.html#_generic-methods">5.2.3.6. Generic Methods</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_default-methods-in-interfaces">5.2.4. Default Methods in Interfaces</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_asynchronous-methods">5.2.4.1. Asynchronous Methods</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_constructors">5.2.5. Constructors</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_structural-this-type-in-constructor">5.2.5.1. Structural This Type in Constructor</a></li>
+<li><a href="classifiers.html#spec-constructor">5.2.5.2. @Spec Constructor</a></li>
+<li><a href="classifiers.html#_callable-constructors">5.2.5.3. Callable Constructors</a></li>
+<li><a href="classifiers.html#_covariant-constructors">5.2.5.4. Covariant Constructors</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_data-fields">5.2.6. Data Fields</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#data-fields-syntax">5.2.6.1. Syntax</a></li>
+<li><a href="classifiers.html#data-fields-properties">5.2.6.2. Properties</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#data-fields-semantics">5.2.6.2.1. Semantics</a></li>
+<li><a href="classifiers.html#data-fields-type-inference">5.2.6.2.2. Type Inference</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_assignment-modifiers">5.2.6.3. Assignment Modifiers</a></li>
+<li><a href="classifiers.html#_field-accessors-getter-setter">5.2.6.4. Field Accessors (Getter/Setter)</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#field-acessors-syntax">5.2.6.4.1. Syntax</a></li>
+<li><a href="classifiers.html#field-acessors-properties">5.2.6.4.2. Properties</a></li>
+<li><a href="classifiers.html#field-accessors-semantics">5.2.6.4.3. Semantics</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#optional-fields">5.2.6.5. Optional Fields</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#_syntax-6">5.2.6.5.1. Syntax</a></li>
+<li><a href="classifiers.html#_semantics-5">5.2.6.5.2. Semantics</a></li>
+<li><a href="classifiers.html#_background">5.2.6.5.3. Background</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="classifiers.html#_static-members">5.2.7. Static Members</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_access-from-and-to-static-members">5.2.7.1. Access From and To Static Members</a></li>
+<li><a href="classifiers.html#_generic-static-methods">5.2.7.2. Generic static methods</a></li>
+<li><a href="classifiers.html#_static-members-of-interfaces">5.2.7.3. Static Members of Interfaces</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_redefinition-of-members">5.2.8. Redefinition of Members</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_overriding-of-members">5.2.8.1. Overriding of Members</a></li>
+<li><a href="classifiers.html#_implementation-of-members">5.2.8.2. Implementation of Members</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#_member-consumption">5.2.8.2.1. Member Consumption</a></li>
+<li><a href="classifiers.html#_member-implementation">5.2.8.2.2. Member Implementation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="classifiers.html#_structural-typing">5.3. Structural Typing</a>
+<ul class="sectlevel3">
+<li><a href="classifiers.html#_syntax-7">5.3.1. Syntax</a></li>
+<li><a href="classifiers.html#_definition-site-structural-typing">5.3.2. Definition Site Structural Typing</a></li>
+<li><a href="classifiers.html#_use-site-structural-typing">5.3.3. Use-Site Structural Typing</a></li>
+<li><a href="classifiers.html#structural-readWriteInit-field-typing">5.3.4. Structural Read-only, Write-only and Initializer Field Typing</a></li>
+<li><a href="classifiers.html#_public-setter-annotated-with-code-providesinitializer-code">5.3.5. Public Setter Annotated With <code>ProvidesInitializer</code></a></li>
+<li><a href="classifiers.html#_structural-types-with-optional-fields">5.3.6. Structural Types With Optional Fields</a></li>
+<li><a href="classifiers.html#_structural-types-with-access-modifier">5.3.7. Structural Types With Access Modifier</a></li>
+<li><a href="classifiers.html#_structural-types-with-additional-members">5.3.8. Structural Types With Additional Members</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_syntax-8">5.3.8.1. Syntax</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#_semantics-6">5.3.8.1.1. Semantics</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="functions.html#_functions">6. Functions</a>
+<ul class="sectlevel2">
+<li><a href="functions.html#_function-type">6.1. Function Type</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_properties-5">6.1.1. Properties</a></li>
+<li><a href="functions.html#function-type-inference">6.1.2. Type Inference</a></li>
+<li><a href="functions.html#_autoboxing-of-function-type">6.1.3. Autoboxing of Function Type</a></li>
+<li><a href="functions.html#_arguments-object">6.1.4. Arguments Object</a></li>
+</ul>
+</li>
+<li><a href="functions.html#_ecmascript-5-function-definition">6.2. ECMAScript 5 Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_function-declaration">6.2.1. Function Declaration</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#_syntax-9">6.2.1.1. Syntax</a></li>
+<li><a href="functions.html#_semantics-8">6.2.1.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="functions.html#_function-expression">6.2.2. Function Expression</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#function-expression-syntax">6.2.2.1. Syntax</a></li>
+<li><a href="functions.html#_semantics-and-type-inference">6.2.2.2. Semantics and Type Inference</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="functions.html#_ecmascript-2015-function-definition">6.3. ECMAScript 2015 Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_formal-parameters">6.3.1. Formal Parameters</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#Type_Modifiers_Optional">6.3.1.1. Optional Parameters</a></li>
+<li><a href="functions.html#Type_Modifiers_Default">6.3.1.2. Default Parameters</a></li>
+<li><a href="functions.html#Type_Modifiers_Variadic">6.3.1.3. Variadic</a></li>
+</ul>
+</li>
+<li><a href="functions.html#_generator-functions">6.3.2. Generator Functions</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#generator-functions-syntax">6.3.2.1. Syntax</a></li>
+<li><a href="functions.html#generator-functions-semantics">6.3.2.2. Semantics</a></li>
+<li><a href="functions.html#_generator-arrow-functions">6.3.2.3. Generator Arrow Functions</a></li>
+</ul>
+</li>
+<li><a href="functions.html#_arrow-function-expression">6.3.3. Arrow Function Expression</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#arrow-function-expression-syntax">6.3.3.1. Syntax</a></li>
+<li><a href="functions.html#arrow-function-expression-semantics-and-type-inference">6.3.3.2. Semantics and Type Inference</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="functions.html#_ecmascript-proposals-function-definition">6.4. ECMAScript Proposals Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_asynchronous-functions">6.4.1. Asynchronous Functions</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#asynchronous-functions-syntax">6.4.1.1. Syntax</a></li>
+<li><a href="functions.html#asynchronous-functions-semantics">6.4.1.2. Semantics</a></li>
+<li><a href="functions.html#_asynchronous-arrow-functions">6.4.1.3. Asynchronous Arrow Functions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="functions.html#_n4js-extended-function-definition">6.5. N4JS Extended Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_generic-functions">6.5.1. Generic Functions</a></li>
+<li><a href="functions.html#_promisifiable-functions">6.5.2. Promisifiable Functions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_conversions-and-reflection">7. Conversions and Reflection</a>
+<ul class="sectlevel2">
+<li><a href="conversions_and_reflection.html#_autoboxing-and-coercing">7.1. Autoboxing and Coercing</a>
+<ul class="sectlevel3">
+<li><a href="conversions_and_reflection.html#_coercing">7.1.1. Coercing</a></li>
+<li><a href="conversions_and_reflection.html#_autoboxing-of-primitives">7.1.2. Autoboxing of Primitives</a></li>
+<li><a href="conversions_and_reflection.html#_autoboxing-of-function-expressions-and-declarations">7.1.3. Autoboxing of Function Expressions and Declarations</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_auto-conversion-of-objects">7.2. Auto-Conversion of Objects</a>
+<ul class="sectlevel3">
+<li><a href="conversions_and_reflection.html#_auto-conversion-of-class-instances">7.2.1. Auto-Conversion of Class Instances</a>
+<ul class="sectlevel4">
+<li><a href="conversions_and_reflection.html#_auto-conversion-of-interface-instances">7.2.1.1. Auto-Conversion of Interface Instances</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_auto-conversion-of-enum-literals">7.2.2. Auto-Conversion of Enum Literals</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_type-cast-and-type-check">7.3. Type Cast and Type Check</a>
+<ul class="sectlevel3">
+<li><a href="conversions_and_reflection.html#_type-cast">7.3.1. Type Cast</a></li>
+<li><a href="conversions_and_reflection.html#_type-check">7.3.2. Type Check</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_reflection-meta-information">7.4. Reflection meta-information</a>
+<ul class="sectlevel3">
+<li><a href="conversions_and_reflection.html#_reflection-for-classes">7.4.1. Reflection for Classes</a></li>
+<li><a href="conversions_and_reflection.html#_reflection-for-interfaces">7.4.2. Reflection for Interfaces</a></li>
+<li><a href="conversions_and_reflection.html#_reflection-for-enumerations">7.4.3. Reflection for Enumerations</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_conversion-of-primitive-types">7.5. Conversion of primitive types</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_expressions">8. Expressions</a>
+<ul class="sectlevel2">
+<li><a href="expressions.html#_ecmascript-5-expressions">8.1. ECMAScript 5 Expressions</a>
+<ul class="sectlevel3">
+<li><a href="expressions.html#_the-this-literal">8.1.1. The this Literal</a></li>
+<li><a href="expressions.html#_identifier">8.1.2. Identifier</a></li>
+<li><a href="expressions.html#_literals">8.1.3. Literals</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#_integer-literals">8.1.3.1. Integer Literals</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_array-literal">8.1.4. Array Literal</a></li>
+<li><a href="expressions.html#_object-literal">8.1.5. Object Literal</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#_properties-6">8.1.5.1. Properties</a></li>
+<li><a href="expressions.html#_scoping-and-linking">8.1.5.2. Scoping and linking</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_parenthesized-expression-and-grouping-operator">8.1.6. Parenthesized Expression and Grouping Operator</a></li>
+<li><a href="expressions.html#_property-accessors">8.1.7. Property Accessors</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#properties-1">8.1.7.1. Properties</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_new-expression">8.1.8. New Expression</a></li>
+<li><a href="expressions.html#_function-expression-2">8.1.9. Function Expression</a></li>
+<li><a href="expressions.html#_function-calls">8.1.10. Function Calls</a></li>
+<li><a href="expressions.html#_postfix-expression">8.1.11. Postfix Expression</a></li>
+<li><a href="expressions.html#_unary-expression">8.1.12. Unary Expression</a></li>
+<li><a href="expressions.html#_multiplicative-expression">8.1.13. Multiplicative Expression</a></li>
+<li><a href="expressions.html#_additive-expression">8.1.14. Additive Expression</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#type-inference-10">8.1.14.1. Type Inference</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_bitwise-shift-expression">8.1.15. Bitwise Shift Expression</a></li>
+<li><a href="expressions.html#_relational-expression">8.1.16. Relational Expression</a></li>
+<li><a href="expressions.html#_equality-expression">8.1.17. Equality Expression</a></li>
+<li><a href="expressions.html#_binary-bitwise-expression">8.1.18. Binary Bitwise Expression</a></li>
+<li><a href="expressions.html#_binary-logical-expression">8.1.19. Binary Logical Expression</a></li>
+<li><a href="expressions.html#_conditional-expression">8.1.20. Conditional Expression</a></li>
+<li><a href="expressions.html#_assignment-expression">8.1.21. Assignment Expression</a></li>
+<li><a href="expressions.html#_comma-expression">8.1.22. Comma Expression</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_ecmascript-6-expressions">8.2. ECMAScript 6 Expressions</a>
+<ul class="sectlevel3">
+<li><a href="expressions.html#_the-super-keyword">8.2.1. The super Keyword</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_ecmascript-7-expressions">8.3. ECMAScript 7 Expressions</a>
+<ul class="sectlevel3">
+<li><a href="expressions.html#_await-expression">8.3.1. Await Expression</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_n4js-specific-expressions">8.4. N4JS Specific Expressions</a>
+<ul class="sectlevel3">
+<li><a href="expressions.html#_class-expression">8.4.1. Class Expression</a></li>
+<li><a href="expressions.html#_cast-as-expression">8.4.2. Cast (As) Expression</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#cast-as-expression-semantics-type-inference">8.4.2.1. Semantics and Type Inference</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#Import_Calls">8.4.3. Import Calls</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#compile-time-expressions">8.5. Compile-Time Expressions</a></li>
+</ul>
+</li>
+<li><a href="statements.html#_statements">9. Statements</a>
+<ul class="sectlevel2">
+<li><a href="statements.html#_ecmascript-5-statements">9.1. ECMAScript 5 Statements</a>
+<ul class="sectlevel3">
+<li><a href="statements.html#_function-or-field-accessor-bodies">9.1.1. Function or Field Accessor Bodies</a></li>
+<li><a href="statements.html#_variable-statement">9.1.2. Variable Statement</a></li>
+<li><a href="statements.html#_if-statement">9.1.3. If Statement</a></li>
+<li><a href="statements.html#_iteration-statements">9.1.4. Iteration Statements</a></li>
+<li><a href="statements.html#_return-statement">9.1.5. Return Statement</a></li>
+<li><a href="statements.html#_with-statement">9.1.6. With Statement</a></li>
+<li><a href="statements.html#_switch-statement">9.1.7. Switch Statement</a></li>
+<li><a href="statements.html#_throw-try-and-catch-statements">9.1.8. Throw, Try, and Catch Statements</a></li>
+<li><a href="statements.html#_debugger-statement">9.1.9. Debugger Statement</a></li>
+</ul>
+</li>
+<li><a href="statements.html#_ecmascript-6-statements">9.2. ECMAScript 6 Statements</a>
+<ul class="sectlevel3">
+<li><a href="statements.html#_let">9.2.1. Let</a></li>
+<li><a href="statements.html#_const">9.2.2. Const</a></li>
+<li><a href="statements.html#_for-of-statement">9.2.3. <code>for &#8230;&#8203; of</code> statement</a></li>
+<li><a href="statements.html#_import-statement">9.2.4. Import Statement</a>
+<ul class="sectlevel4">
+<li><a href="statements.html#Dynamic_Imports">9.2.4.1. Dynamic Imports</a></li>
+<li><a href="statements.html#_immutabilaty-of-imports">9.2.4.2. Immutabilaty of Imports</a></li>
+</ul>
+</li>
+<li><a href="statements.html#_export-statement">9.2.5. Export Statement</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="annotations.html#_annotations">10. Annotations</a>
+<ul class="sectlevel2">
+<li><a href="annotations.html#_introduction-2">10.1. Introduction</a>
+<ul class="sectlevel3">
+<li><a href="annotations.html#_syntax-13">10.1.1. Syntax</a></li>
+<li><a href="annotations.html#_properties-7">10.1.2. Properties</a></li>
+<li><a href="annotations.html#_element-specific-annotations">10.1.3. Element-Specific Annotations</a></li>
+<li><a href="annotations.html#_general-annotations">10.1.4. General Annotations</a>
+<ul class="sectlevel4">
+<li><a href="annotations.html#_idebug">10.1.4.1. IDEBUG</a></li>
+</ul>
+</li>
+<li><a href="annotations.html#idebug-syntax">10.1.5. Syntax</a>
+<ul class="sectlevel4">
+<li><a href="annotations.html#_semantics-11">10.1.5.1. Semantics</a></li>
+<li><a href="annotations.html#_suppress-warnings">10.1.5.2. Suppress Warnings</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="annotations.html#_declaration-of-annotations">10.2. Declaration of Annotations</a></li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_extended-fetaures">11. Extended Fetaures</a>
+<ul class="sectlevel2">
+<li><a href="extended_fetaures.html#_array-and-object-destructuring">11.1. Array and Object Destructuring</a>
+<ul class="sectlevel3">
+<li><a href="extended_fetaures.html#_syntax-14">11.1.1. Syntax</a></li>
+<li><a href="extended_fetaures.html#_semantics-12">11.1.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_dependency-injection">11.2. Dependency Injection</a>
+<ul class="sectlevel3">
+<li><a href="extended_fetaures.html#_di-components-and-injectors">11.2.1. DI Components and Injectors</a>
+<ul class="sectlevel4">
+<li><a href="extended_fetaures.html#_dicomponent-relations">11.2.1.1. DIComponent Relations</a></li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_binders-and-bindings">11.2.2. Binders and Bindings</a></li>
+<li><a href="extended_fetaures.html#_injection-points">11.2.3. Injection Points</a>
+<ul class="sectlevel4">
+<li><a href="extended_fetaures.html#_field-injection">11.2.3.1. Field Injection</a></li>
+<li><a href="extended_fetaures.html#_constructor-injection">11.2.3.2. Constructor Injection</a></li>
+<li><a href="extended_fetaures.html#_method-injection">11.2.3.3. Method Injection</a>
+<ul class="sectlevel5">
+<li><a href="extended_fetaures.html#_provider">11.2.3.3.1. Provider</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_n4js-di-life-cycle-and-scopes">11.2.4. N4JS DI Life Cycle and Scopes</a>
+<ul class="sectlevel4">
+<li><a href="extended_fetaures.html#_injection-cylces">11.2.4.1. Injection Cylces</a></li>
+<li><a href="extended_fetaures.html#_default-scope">11.2.4.2. Default Scope</a></li>
+<li><a href="extended_fetaures.html#_singleton-scope">11.2.4.3. Singleton Scope</a></li>
+<li><a href="extended_fetaures.html#_per-injection-chain-singleton">11.2.4.4. Per Injection Chain Singleton</a></li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_validation-of-callsites-targeting-n4injector-methods">11.2.5. Validation of callsites targeting N4Injector methods</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-annotations">11.2.6. N4JS DI Annotations</a>
+<ul class="sectlevel4">
+<li><a href="extended_fetaures.html#_n4js-di-generateinjector">11.2.6.1. N4JS DI @GenerateInjector</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-withparentinjector">11.2.6.2. N4JS DI @WithParentInjector</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-usebinder">11.2.6.3. N4JS DI @UseBinder</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-binder">11.2.6.4. N4JS DI @Binder</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-bind">11.2.6.5. N4JS DI @Bind</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-provides">11.2.6.6. N4JS DI @Provides</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-inject">11.2.6.7. N4JS DI @Inject</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-singleton">11.2.6.8. N4JS DI @Singleton</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_test-support">11.3. Test Support</a></li>
+<li><a href="extended_fetaures.html#_polyfill-definitions">11.4. Polyfill Definitions</a>
+<ul class="sectlevel3">
+<li><a href="extended_fetaures.html#_runtime-polyfill-definitions">11.4.1. Runtime Polyfill Definitions</a></li>
+<li><a href="extended_fetaures.html#_static-polyfill-definitions">11.4.2. Static Polyfill Definitions</a></li>
+<li><a href="extended_fetaures.html#_transpiling-static-polyfilled-classes">11.4.3. Transpiling static polyfilled classes</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="components.html#_components">12. Components</a>
+<ul class="sectlevel2">
+<li><a href="components.html#_overview-2">12.1. Overview</a></li>
+<li><a href="components.html#Component_Types">12.2. Component Types</a>
+<ul class="sectlevel3">
+<li><a href="components.html#_libraries">12.2.1. Libraries</a></li>
+<li><a href="components.html#_runtime-environment-and-runtime-libraries">12.2.2. Runtime Environment and Runtime Libraries</a></li>
+<li><a href="components.html#_tests">12.2.3. Tests</a></li>
+<li><a href="components.html#_type-definitions">12.2.4. Type Definitions</a></li>
+</ul>
+</li>
+<li><a href="components.html#package-json">12.3. Package.json File</a>
+<ul class="sectlevel3">
+<li><a href="components.html#_basic-properties">12.3.1. Basic Properties</a></li>
+<li><a href="components.html#_n4js-properties">12.3.2. N4JS Properties</a></li>
+<li><a href="components.html#_constraints">12.3.3. Constraints</a></li>
+</ul>
+</li>
+<li><a href="components.html#_support-for-npm-scopes">12.4. Support for NPM Scopes</a></li>
+<li><a href="components.html#sec:N4JS-Type-Definitions">12.5. N4JS Type Definitions</a>
+<ul class="sectlevel3">
+<li><a href="components.html#_specify-type-definition">12.5.1. Specify Type Definition</a></li>
+<li><a href="components.html#_name-conventions">12.5.2. Name Conventions</a></li>
+<li><a href="components.html#_version-conventions">12.5.3. Version Conventions</a>
+<ul class="sectlevel4">
+<li><a href="components.html#_define-a-new-type-definition-package">12.5.3.1. Define a New Type Definition Package</a></li>
+<li><a href="components.html#_using-a-type-definition-package">12.5.3.2. Using a Type Definition Package</a></li>
+<li><a href="components.html#_rational">12.5.3.3. Rational</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="components.html#_modules">12.6. Modules</a></li>
+<li><a href="components.html#_api-and-implementation-component">12.7. API and Implementation Component</a>
+<ul class="sectlevel3">
+<li><a href="components.html#_execution-of-api-and-implementation-components">12.7.1. Execution of API and Implementation Components</a></li>
+<li><a href="components.html#_api-and-implementation-with-di">12.7.2. API and Implementation With DI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="plainjs.html#_plainjs">13. PlainJS</a>
+<ul class="sectlevel2">
+<li><a href="plainjs.html#_type-inference-and-validation-for-plain-js">13.1. Type Inference and Validation for Plain JS</a></li>
+<li><a href="plainjs.html#_external-declarations">13.2. External Declarations</a>
+<ul class="sectlevel3">
+<li><a href="plainjs.html#_declaring-externals">13.2.1. Declaring externals</a></li>
+<li><a href="plainjs.html#_instantiating-external-classes">13.2.2. Instantiating external classes</a></li>
+<li><a href="plainjs.html#_implementation-of-external-declarations">13.2.3. Implementation of External Declarations</a></li>
+<li><a href="plainjs.html#_example">13.2.4. Example</a></li>
+</ul>
+</li>
+<li><a href="plainjs.html#_global-definitions">13.3. Global Definitions</a></li>
+<li><a href="plainjs.html#_runtime-definitions">13.4. Runtime Definitions</a></li>
+<li><a href="plainjs.html#_applying-polyfills">13.5. Applying Polyfills</a></li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_jsdoc-2">14. JSDoc</a>
+<ul class="sectlevel2">
+<li><a href="jsdoc.html#_general-n4jsdoc-features">14.1. General N4JSDoc Features</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#_provided-inline-tags">14.1.1. Provided Inline Tags</a>
+<ul class="sectlevel4">
+<li><a href="jsdoc.html#jsdoc_tag__code">14.1.1.1. @code</a></li>
+<li><a href="jsdoc.html#jsdoc_tag__link">14.1.1.2. @link</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_n4jsdoc-for-user-projects">14.2. N4JSdoc for User Projects</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#_standard-tags">14.2.1. Standard Tags</a>
+<ul class="sectlevel4">
+<li><a href="jsdoc.html#_-author">14.2.1.1. @author</a></li>
+<li><a href="jsdoc.html#jsdoc_tag_param">14.2.1.2. @param</a></li>
+<li><a href="jsdoc.html#jsdoc_tag_return">14.2.1.3. @return</a></li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_test-related-tags">14.2.2. Test Related Tags</a>
+<ul class="sectlevel4">
+<li><a href="jsdoc.html#jsdoc_tag__testee">14.2.2.1. @testee</a></li>
+<li><a href="jsdoc.html#jsdoc_tag__testeeFromType">14.2.2.2. @testeeFromType</a></li>
+<li><a href="jsdoc.html#_testeeType_and__testeeMember">14.2.2.3. @testeeType and @testeeMember</a></li>
+<li><a href="jsdoc.html#jsdoc_tag_reqid_in_Tests">14.2.2.4. @reqid in Tests</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_n4jsdoc-for-api-and-implementation-projects">14.3. N4JSDoc for API and Implementation Projects</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#jsdoc_tag__apiNote">14.3.1. @apiNote</a></li>
+<li><a href="jsdoc.html#API_Project_Tags">14.3.2. API Project Tags</a>
+<ul class="sectlevel4">
+<li><a href="jsdoc.html#jsdoc_tag_apiState">14.3.2.1. @apiState</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsx.html#_jsx">15. JSX</a>
+<ul class="sectlevel2">
+<li><a href="jsx.html#_jsx-support">15.1. JSX Support</a></li>
+<li><a href="jsx.html#_jsx-backend">15.2. JSX Backend</a></li>
+</ul>
+</li>
+<li><a href="grammars.html#_grammars">16. Grammars</a>
+<ul class="sectlevel2">
+<li><a href="grammars.html#_type-expressions-grammar">16.1. Type Expressions Grammar</a></li>
+<li><a href="grammars.html#_n4js-language-grammar">16.2. N4JS Language Grammar</a></li>
+</ul>
+</li>
+<li><a href="jsobjects.html#_jsobjects">17. JSObjects</a>
+<ul class="sectlevel2">
+<li><a href="jsobjects.html#_object">17.1. Object</a></li>
+<li><a href="jsobjects.html#_string">17.2. String</a></li>
+<li><a href="jsobjects.html#_boolean">17.3. Boolean</a></li>
+<li><a href="jsobjects.html#_number">17.4. Number</a>
+<ul class="sectlevel3">
+<li><a href="jsobjects.html#_static-attributes">17.4.1. Static Attributes</a></li>
+</ul>
+</li>
+<li><a href="jsobjects.html#function">17.5. Function</a></li>
+<li><a href="jsobjects.html#_error">17.6. Error</a></li>
+<li><a href="jsobjects.html#_array">17.7. Array</a></li>
+<li><a href="jsobjects.html#_date">17.8. Date</a></li>
+<li><a href="jsobjects.html#_math">17.9. Math</a>
+<ul class="sectlevel3">
+<li><a href="jsobjects.html#static-attributes-1">17.9.1. Static Attributes</a></li>
+</ul>
+</li>
+<li><a href="jsobjects.html#_regexp">17.10. RegExp</a></li>
+<li><a href="jsobjects.html#_json">17.11. JSON</a></li>
+</ul>
+</li>
+<li><a href="n4js_objects.html#_n4js-objects">18. N4JS Objects</a>
+<ul class="sectlevel2">
+<li><a href="n4js_objects.html#_reflection-model">18.1. Reflection Model</a></li>
+<li><a href="n4js_objects.html#_error-types">18.2. Error Types</a>
+<ul class="sectlevel3">
+<li><a href="n4js_objects.html#_n4apinotimplemented">18.2.1. N4ApiNotImplemented</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_acronyms.html#_acronyms">Appendix A: Acronyms</a></li>
+<li><a href="appendix_b_license.html#sec:License">Appendix B: License</a></li>
+<li><a href="appendix_c_bibliography.html#_bibliography">Appendix C: Bibliography</a></li>
+</ul>
+</div>
+</div>
+<div id="content"><div class="sect1">
+<h2 id="_names"><a class="anchor" href="#_names"></a><a class="link" href="#_names">3. Names</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p><em>Visibility</em> defines the scope in which a declaration is visible, that is in which context references can be bound to the declaration.
+<em>Access control</em> defines the extent to which types and members are accessible beyond their immediate context.
+Access control may, therefore, restrict the visibility of a declaration by limiting its scope.</p>
+</div>
+<div class="paragraph">
+<p><em>Extensibility</em> refers to whether a given type can be subtyped, or in the case of members, whether they can be overridden.
+Access control is a prerequisite for extensibility which is further explained in <a href="classifiers.html#_n4js-specific-classifiers">N4JS Specific Classifiers</a></p>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="_access-control"><a class="anchor" href="#_access-control"></a><a class="link" href="#_access-control">3.1. Access Control</a></h3>
+<div class="paragraph">
+<p>Types from one project may or may not be made accessible to another project.
+Likewise, members from a given type may or may not be made accessible to members existing outside that type.
+For example, if a developer writes an application which uses a library, which types within that library can the application see?
+Given a type that is set as visible, which members of that type can the application see?</p>
+</div>
+<div class="paragraph">
+<p>Accessing a type or member actually means that a reference is bound to a
+declaration with the same identifier.</p>
+</div>
+<div class="paragraph">
+<p>We distinguish the following contexts from which an element is accessed
+as follows:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p><strong>Module or type</strong>: access from elements in the same module or type.</p>
+</li>
+<li>
+<p><strong>Subtype</strong>: access from a subtype.</p>
+</li>
+<li>
+<p><strong>Project</strong>: access from the same project.</p>
+</li>
+<li>
+<p><strong>Vendor</strong>: access from different project of the same vendor.</p>
+</li>
+<li>
+<p><strong>World</strong>: access from anything else.</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>Accessibility is defined by modifiers on types and members, e.g <code>public</code>, <code>protected</code>, <code>project</code>, <code>private</code>, via the <code>export</code> statement, and by the <code>@Internal</code> annotation.
+Extensibility is defined by the <code>@Final</code> annotation respectively.</p>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="_accessibility-of-types-top-level-variables-and-function-declarations"><a class="anchor" href="#_accessibility-of-types-top-level-variables-and-function-declarations"></a><a class="link" href="#_accessibility-of-types-top-level-variables-and-function-declarations">3.2. Accessibility of Types, Top-Level Variables and Function Declarations</a></h3>
+<div class="paragraph">
+<p>We define types (classes, interfaces, enums) whereby each type has members (fields and methods, depending on the kind of type).
+When we define a type, we need to define whether it is visible only for the specifying module, project or whether that type should be accessible from outside of that project.</p>
+</div>
+<div class="paragraph">
+<p>The same is true for variable declarations and function declarations defined as top-level elements of a module.</p>
+</div>
+<div class="paragraph">
+<p>The following type access modifiers are supported by N4JS:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">enum TypeAccessModifier:      project
+                            | public;</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>If a type is not exported, its visibility is private.
+If a type has declared visibility <code>public</code>, it may additionally be marked as internal via the annotation <code>@Internal</code>.
+Thus, we have the following set of type access modifiers:</p>
+</div>
+<div class="paragraph">
+<p>TAM = <code>private</code> <code>project</code> <code>public@Internal</code> <code>public</code></p>
+</div>
+<div class="paragraph">
+<p>That is, in N4JS, only the type access modifiers and are available.
+The redundant <code>project</code> modifier serves only documentation purpose and can be synthesized if the <code>export</code> modifier is preset.</p>
+</div>
+<div class="paragraph">
+<p>All other modifiers used here are synthesized as shown in the next example:</p>
+</div>
+<div class="listingblock">
+<div class="title">Synthesized Type Access Modifiers in N4JS</div>
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">class C0 {}                         // private
+export class C1 {}                  // project
+export project class C1 {}          // project
+export @Internal public class C1 {} // public@Internal
+export public class C2 {}           // public
+
+var v0;                             // private
+export var v1;                      // project
+export project var v1;              // project
+export @Internal public var v3;     // public@Internal
+export public var v2;               // public
+
+
+function f0() {}                    // private
+export function f1() {}             // project
+export project function f1() {}     // project
+export @Internal public function f3() {} // public@Internal
+export public function f2() {}      // public</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>The access control levels are defined as listed in <a href="#tab:type-access-control">Type Access Control</a>.</p>
+</div>
+<table id="tab:type-access-control" class="tableblock frame-all grid-all spread">
+<caption class="title">Table 1. Type Access Control</caption>
+<colgroup>
+<col style="width: 20%;">
+<col style="width: 20%;">
+<col style="width: 20%;">
+<col style="width: 20%;">
+<col style="width: 20%;">
+</colgroup>
+<thead>
+<tr>
+<th class="tableblock halign-center valign-top" colspan="5"><strong>Type Access</strong></th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<th class="tableblock halign-center valign-top"><p class="tableblock">Modifier</p></th>
+<th class="tableblock halign-center valign-top"><p class="tableblock">Module</p></th>
+<th class="tableblock halign-center valign-top"><p class="tableblock">Project</p></th>
+<th class="tableblock halign-center valign-top"><p class="tableblock">Vendor</p></th>
+<th class="tableblock halign-center valign-top"><p class="tableblock">World</p></th>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>private</code></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">yes</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">no</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">no</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">no</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>project</code></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">yes</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">yes</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">no</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">no</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>public@Internal</code></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">yes</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">yes</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">yes</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">no</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>public</code></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">yes</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">yes</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">yes</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">yes</p></td>
+</tr>
+</tbody>
+</table>
+<div class="paragraph">
+<p><code>TAM</code> is a totally ordered set:</p>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mstyle mathvariant="monospace"><mtext>private</mtext></mstyle><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>project</mtext></mstyle><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>public@Internal</mtext></mstyle><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>public</mtext></mstyle></math>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-3"></a><strong>Req. IDE-3:</strong> <a href="#Req-IDE-3">Type Access Modifiers</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>The following constraints for type access modifiers for a given type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi></math> (which may be a classifier declaration, a function or a variable) must hold:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>It is an error if <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi></math> is not exported but defined as <code>project</code>, <code>public</code> or <code>public@Internal</code>.</p>
+</li>
+<li>
+<p>It is an error if an annotation <code>@Internal</code> is present on a module private or <code>project</code> visible type.</p>
+</li>
+<li>
+<p>The type modifier for all built-in ECMAScript types is <code>public</code>.</p>
+</li>
+<li>
+<p>The <em>default modifier</em> for user declared exported declarations is <code>project</code>.
+That is, this modifier is assumed if no modifier is explicitly specified.</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+<div class="openblock definition">
+<div class="content">
+<div class="paragraph">
+<p><a id="type_accessibility_t"></a><strong>Definition:</strong> <a href="#type_accessibility_t">Type Accessibility T</a></p>
+</div>
+<div class="paragraph">
+<p>The function <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>α</mi><mi>T</mi></msub><mi>:</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mi>e</mi><mi>r</mi><mi>e</mi><mi>n</mi><mi>c</mi><mi>e</mi><mo>×</mo><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>D</mi><mi>e</mi><mi>c</mi><mi>l</mi><mi>a</mi><mi>r</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>o</mi><mi>n</mi><mo>⇒</mo><mi>B</mi><mi>o</mi><mi>o</mi><mi>l</mi><mi>e</mi><mi>a</mi><mi>n</mi></math> computes whether a given type, (top-level) variable or function
+reference can access the declaration that it references.
+<math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>α</mi><mi>T</mi></msub></math> is defined with <a href="#tab:type-access-control">Type Access Control</a>.</p>
+</div>
+<div class="paragraph">
+<p>Formally, we define <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>α</mi><mi>T</mi></msub></math> for a given reference <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>r</mi></math> and a module top level variable, function or type declaration <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>D</mi></math> as follows <sup class="footnote">[<a id="_footnoteref_4" class="footnote" href="appendix_c_bibliography.html#_footnote_4" title="View footnote.">4</a>]</sup>:</p>
+</div>
+<div class="paragraph">
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mfrac><mrow><mi>D</mi><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>public</mtext></mstyle></mrow><mrow><msub><mi>α</mi><mi>T</mi></msub><mfenced close=")" open="("><mi>r</mi><mi>D</mi></mfenced></mrow></mfrac></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mfrac><mrow><mi>D</mi><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>public@Internal</mtext></mstyle><mspace width="3.0mm"/><mi>r</mi><mo>.</mo><mi>v</mi><mi>e</mi><mi>n</mi><mi>d</mi><mi>o</mi><mi>r</mi><mo>=</mo><mi>D</mi><mo>.</mo><mi>v</mi><mi>e</mi><mi>n</mi><mi>d</mi><mi>o</mi><mi>r</mi></mrow><mrow><msub><mi>α</mi><mi>T</mi></msub><mfenced close=")" open="("><mi>r</mi><mi>D</mi></mfenced></mrow></mfrac></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mfrac><mrow><mi>D</mi><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>project</mtext></mstyle><mspace width="3.0mm"/><mi>r</mi><mo>.</mo><mi>p</mi><mi>r</mi><mi>o</mi><mi>j</mi><mi>e</mi><mi>c</mi><mi>t</mi><mo>=</mo><mi>D</mi><mo>.</mo><mi>p</mi><mi>r</mi><mi>o</mi><mi>j</mi><mi>e</mi><mi>c</mi><mi>t</mi></mrow><mrow><msub><mi>α</mi><mi>T</mi></msub><mfenced close=")" open="("><mi>r</mi><mi>D</mi></mfenced></mrow></mfrac></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mfrac><mrow><mi>D</mi><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>private</mtext></mstyle><mspace width="3.0mm"/><mi>r</mi><mo>.</mo><mi>m</mi><mi>o</mi><mi>d</mi><mi>u</mi><mi>l</mi><mi>e</mi><mo>=</mo><mi>D</mi><mo>.</mo><mi>m</mi><mi>o</mi><mi>d</mi><mi>u</mi><mi>l</mi><mi>e</mi></mrow><mrow><msub><mi>α</mi><mi>T</mi></msub><mfenced close=")" open="("><mi>r</mi><mi>D</mi></mfenced></mrow></mfrac></math></p>
+</div>
+<div class="paragraph">
+<p>If the type of the arguments is clear from the context, we simply write <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>α</mi><mfenced close=")" open="("><mi>r</mi><mi>D</mi></mfenced></math> instead of <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>α</mi><mi>T</mi></msub><mfenced close=")" open="("><mi>r</mi><mi>D</mi></mfenced></math>.</p>
+</div>
+<div class="paragraph">
+<p>Accessibility for types is only checked for types that manifest themselves in the concrete syntax of the N4JS file.
+Types that do not have to be written to concrete syntax may be used even if they are generally not accessible.
+This is illustrated by <a href="#ex:implicit-type-references">Implicit, allowed type references in N4JS</a>:</p>
+</div>
+<div id="ex:implicit-type-references" class="exampleblock">
+<div class="title">Example 1. Implicit, allowed type references in N4JS</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">export public class D {
+    public takeC(): C { .. }
+    public acceptC(c: C): void { .. }
+}
+/* private */ class C {}</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">var d: D = new D()
+d.acceptC( d.takeC() )</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_accessibility-of-members"><a class="anchor" href="#_accessibility-of-members"></a><a class="link" href="#_accessibility-of-members">3.2.1. Accessibility of Members</a></h4>
+<div class="paragraph">
+<p>Accessibility at the member level is only applicable when the type itself is accessible.
+If you cannot access the type, you cannot access any of its members.
+Note that inherited members (from an interface or class) become members of a class.
+For example, if <code>B extends A</code>, and if <code>A</code> is not accessible to some client <code>C</code> but <code>B</code> is, then the members of <code>A</code> are indirectly accessible to <code>C</code> in so far as they are accessed via <code>B</code>.
+This is true in particular for interfaces, as their properties are possibly merged into the consuming class (cf. <a href="classifiers.html#_implementation-of-members">Implementation of Members</a>).</p>
+</div>
+<div class="paragraph">
+<p>The following member access modifiers are supported by N4JS:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">enum MemberAccessModifier:    private
+                            | project
+                            | protected
+                            | public;</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>The modifiers <code>protected</code> and <code>public</code> may be annotated with <code>@Internal</code>.
+Thus, we can define the following set of member access modifiers:</p>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mtable><mtr><mtd><mi>M</mi><mi>A</mi><mi>M</mi><mo>=</mo><mrow><mo>{</mo><mspace width="3.0mm"/></mrow></mtd></mtr><mtr><mtd><mstyle mathvariant="monospace"><mtext>private</mtext></mstyle><mo>,</mo><mstyle mathvariant="monospace"><mtext>protected@Internal</mtext></mstyle><mo>,</mo><mstyle mathvariant="monospace"><mtext>protected</mtext></mstyle><mo>,</mo></mtd></mtr><mtr><mtd><mstyle mathvariant="monospace"><mtext>project</mtext></mstyle><mo>,</mo><mstyle mathvariant="monospace"><mtext>public@Internal</mtext></mstyle><mo>,</mo><mstyle mathvariant="monospace"><mtext>public</mtext></mstyle></mtd></mtr><mtr><mtd><mrow><mo>}</mo></mrow></mtd></mtr></mtable></math>
+</div>
+</div>
+<div class="paragraph">
+<p><code>protected@Internal</code> and <code>public@Internal</code> are synthesized tags and were introduced as shorthand notation for the <code>@Internal</code> annotation together with <code>protected</code> or <code>public</code> access modifiers.
+The <code>project</code> modifier is the default one and it can be omitted.
+As with the type access modifiers, not all member access modifiers are available in N4JS.
+Instead, they are synthesized from different construct as shown in the next example.</p>
+</div>
+<div class="exampleblock">
+<div class="title">Example 2. Synthesized Member Access Modifiers in N4JS</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">export @Internal public class C {
+
+    private f0;                 // private
+    f1;                         // project
+    project f2;                 // project
+    @Internal protected f3;     // protected@Internal
+    protected f4;               // protected
+    @Internal public f5;        // public@Internal
+    public f6;                  // public
+
+    private m0() {}             // private
+    m1() {}                     // project
+    project m2() {}             // project
+    @Internal protected m3() {} // protected@Internal
+    protected m4() {}           // protected
+    @Internal public m5() {}    // public@Internal
+    public  m6() {}             // public
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p><code>MAM</code> does not define a totally ordered set. However, its subset</p>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mi>M</mi><mi>A</mi><mi>M</mi><mo>\</mo><mfenced close="}" open="{"><mstyle mathvariant="monospace"><mtext>public@Internal</mtext></mstyle></mfenced></math>
+</div>
+</div>
+<div class="paragraph">
+<p>is a totally ordered set <sup class="footnote">[<a id="_footnoteref_5" class="footnote" href="appendix_c_bibliography.html#_footnote_5" title="View footnote.">5</a>]</sup> :</p>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mstyle mathvariant="monospace"><mtext>private</mtext></mstyle><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>project</mtext></mstyle><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>protected@Internal</mtext></mstyle><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>protected</mtext></mstyle><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>public</mtext></mstyle></math>
+</div>
+</div>
+<div class="paragraph">
+<p><a href="#tab:Member-Access-Controls">Member Access Control</a> shows which members are accessible from where.</p>
+</div>
+<table id="tab:Member-Access-Controls" class="tableblock frame-all grid-all spread">
+<caption class="title">Table 2. Member Access Control</caption>
+<colgroup>
+<col style="width: 25%;">
+<col style="width: 12.5%;">
+<col style="width: 12.5%;">
+<col style="width: 12.5%;">
+<col style="width: 12.5%;">
+<col style="width: 12.5%;">
+<col style="width: 12.5%;">
+</colgroup>
+<thead>
+<tr>
+<th class="tableblock halign-left valign-top">Access Modifier</th>
+<th class="tableblock halign-center valign-top">Inside Module</th>
+<th class="tableblock halign-center valign-top">Inside Project</th>
+<th class="tableblock halign-center valign-top">Vendor</th>
+<th class="tableblock halign-center valign-top">Vendor Subtypes</th>
+<th class="tableblock halign-center valign-top">Other Projects</th>
+<th class="tableblock halign-center valign-top">Everywhere</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>private</code></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">yes</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">no</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">no</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">no</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">no</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">no</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>project</code></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">yes</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">yes</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">no</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">no</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">no</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">no</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>protected@Internal</code></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">yes</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">yes</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">yes</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">no</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">no</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">no</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>protected</code></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">yes</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">yes</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">yes</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">no</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">yes</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">no</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>public@Internal</code></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">yes</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">yes</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">yes</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">yes</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">no</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">no</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>public</code></p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">yes</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">yes</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">yes</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">yes</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">yes</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">yes</p></td>
+</tr>
+</tbody>
+</table>
+<div class="openblock definition">
+<div class="content">
+<div class="paragraph">
+<p><a id="type_and_member_accessibility_relation"></a><strong>Definition:</strong> <a href="#type_and_member_accessibility_relation">Type and Member Accessibility Relation</a></p>
+</div>
+<div class="paragraph">
+<p>We define the relation</p>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mo>=</mo><mspace width="1.0em"/><mi>:</mi><mspace width="1.0em"/><mi>T</mi><mi>A</mi><mi>M</mi><mo>×</mo><mi>M</mi><mi>A</mi><mi>M</mi></math>
+</div>
+</div>
+<div class="paragraph">
+<p>as follows:</p>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mtable><mtr><mtd><mo>=</mo><mspace width="1.0em"/><mi>:</mi><mi>:</mi><mo>=</mo><mrow><mo>{</mo></mrow></mtd><mtd><mfenced close=")" open="("><mstyle mathvariant="monospace"><mtext>private</mtext></mstyle><mstyle mathvariant="monospace"><mtext>private</mtext></mstyle></mfenced><mo>,</mo><mfenced close=")" open="("><mstyle mathvariant="monospace"><mtext>project</mtext></mstyle><mstyle mathvariant="monospace"><mtext>project</mtext></mstyle></mfenced><mo>,</mo></mtd></mtr><mtr><mtd/><mtd><mrow><mfenced close=")" open="("><mstyle mathvariant="monospace"><mtext>public@Internal</mtext></mstyle><mstyle mathvariant="monospace"><mtext>public@Internal</mtext></mstyle></mfenced><mo>,</mo><mfenced close=")" open="("><mstyle mathvariant="monospace"><mtext>public</mtext></mstyle><mstyle mathvariant="monospace"><mtext>public</mtext></mstyle></mfenced><mo>}</mo></mrow></mtd></mtr></mtable></math>
+</div>
+</div>
+<div class="paragraph">
+<p>We further define the relation <math xmlns="http://www.w3.org/1998/Math/MathML"><mo>≥</mo><mi>:</mi><mi>T</mi><mi>A</mi><mi>M</mi><mo>×</mo><mi>M</mi><mi>A</mi><mi>M</mi></math> as follows:</p>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><mo>∃</mo><mi>m</mi><mi>a</mi><msup><mi>m</mi><mi>'</mi></msup><mo>∈</mo><mi>M</mi><mi>A</mi><mi>M</mi><mi>:</mi><mi>t</mi><mi>a</mi><mi>m</mi><mo>=</mo><mi>m</mi><mi>a</mi><msup><mi>m</mi><mi>'</mi></msup><mo>∧</mo><mi>m</mi><mi>a</mi><msup><mi>m</mi><mi>'</mi></msup><mo>≥</mo><mi>m</mi><mi>a</mi><mi>m</mi></mrow><mrow><mi>t</mi><mi>a</mi><mi>m</mi><mo>≥</mo><mi>m</mi><mi>a</mi><mi>m</mi></mrow></mfrac></math>
+</div>
+</div>
+<div class="paragraph">
+<p>Less, greater then etc. are defined accordingly.</p>
+</div>
+</div>
+</div>
+<div class="openblock definition">
+<div class="content">
+<div class="paragraph">
+<p><a id="member_accessibility"></a><strong>Definition:</strong> <a href="#member_accessibility">Member Accessibility</a></p>
+</div>
+<div class="paragraph">
+<p>The function</p>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><msub><mi>α</mi><mi>m</mi></msub><mi>:</mi><mi>M</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi><mi>R</mi><mi>e</mi><mi>f</mi><mi>e</mi><mi>r</mi><mi>e</mi><mi>n</mi><mi>c</mi><mi>e</mi><mo>×</mo><mi>M</mi><mi>e</mi><mi>m</mi><mi>b</mi><mi>e</mi><mi>r</mi><mi>D</mi><mi>e</mi><mi>c</mi><mi>l</mi><mi>a</mi><mi>r</mi><mi>a</mi><mi>t</mi><mi>i</mi><mi>o</mi><mi>n</mi><mo>⇒</mo><mi>B</mi><mi>o</mi><mi>o</mi><mi>l</mi><mi>e</mi><mi>a</mi><mi>n</mi></math>
+</div>
+</div>
+<div class="paragraph">
+<p>computes if a given reference can access the member declaration that it
+references.</p>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Note that <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>α</mi><mi>m</mi></msub></math> and <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>b</mi><mi>i</mi><mi>n</mi><mi>d</mi></math> are different functions.
+A reference can only bind to a declaration if it can access the declaration.
+However, bind requires more condition to work (correct metatypes, no shadowing etc).</p>
+</div>
+<div class="paragraph">
+<p>Formally, we define <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>α</mi><mi>m</mi></msub></math> for a given reference <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>r</mi></math> and member declaration <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>M</mi></math> as follows: <sup class="footnote">[<a id="_footnoteref_6" class="footnote" href="appendix_c_bibliography.html#_footnote_6" title="View footnote.">6</a>]</sup> <sup class="footnote">[<a id="_footnoteref_7" class="footnote" href="appendix_c_bibliography.html#_footnote_7" title="View footnote.">7</a>]</sup></p>
+</div>
+<div class="paragraph">
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mfrac><mrow><mi>M</mi><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>public</mtext></mstyle></mrow><mrow><msub><mi>α</mi><mi>m</mi></msub><mfenced close=")" open="("><mi>r</mi><mi>M</mi></mfenced></mrow></mfrac></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mfrac><mrow><mi>r</mi><mo>.</mo><mi>v</mi><mi>e</mi><mi>n</mi><mi>d</mi><mi>o</mi><mi>r</mi><mo>=</mo><mi>M</mi><mo>.</mo><mi>v</mi><mi>e</mi><mi>n</mi><mi>d</mi><mi>o</mi><mi>r</mi><mspace width="3.0mm"/><mi>M</mi><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>public@Internal</mtext></mstyle></mrow><mrow><msub><mi>α</mi><mi>m</mi></msub><mfenced close=")" open="("><mi>r</mi><mi>M</mi></mfenced></mrow></mfrac></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mfrac><mrow><mi>r</mi><mo>.</mo><mi>o</mi><mi>w</mi><mi>n</mi><mi>e</mi><mi>r</mi><mo>∈</mo><mi>r</mi><mo>.</mo><mi>r</mi><mi>e</mi><mi>c</mi><mi>e</mi><mi>i</mi><mi>v</mi><mi>e</mi><mi>r</mi><mo>.</mo><mi>s</mi><mi>u</mi><mi>p</mi><mi>e</mi><msup><mi>r</mi><mo>*</mo></msup><mspace width="3.0mm"/><mi>M</mi><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>protected</mtext></mstyle></mrow><mrow><msub><mi>α</mi><mi>m</mi></msub><mfenced close=")" open="("><mi>r</mi><mi>M</mi></mfenced></mrow></mfrac></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mfrac><mrow><mi>r</mi><mo>.</mo><mi>o</mi><mi>w</mi><mi>n</mi><mi>e</mi><mi>r</mi><mo>∈</mo><mi>r</mi><mo>.</mo><mi>r</mi><mi>e</mi><mi>c</mi><mi>e</mi><mi>i</mi><mi>v</mi><mi>e</mi><mi>r</mi><mo>.</mo><mi>s</mi><mi>u</mi><mi>p</mi><mi>e</mi><msup><mi>r</mi><mo>*</mo></msup><mspace width="3.0mm"/><mi>r</mi><mo>.</mo><mi>v</mi><mi>e</mi><mi>n</mi><mi>d</mi><mi>o</mi><mi>r</mi><mo>=</mo><mi>M</mi><mo>.</mo><mi>v</mi><mi>e</mi><mi>n</mi><mi>d</mi><mi>o</mi><mi>r</mi><mspace width="3.0mm"/><mi>M</mi><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>protected@Internal</mtext></mstyle></mrow><mrow><msub><mi>α</mi><mi>m</mi></msub><mfenced close=")" open="("><mi>r</mi><mi>M</mi></mfenced></mrow></mfrac></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mfrac><mrow><mi>r</mi><mo>.</mo><mi>p</mi><mi>r</mi><mi>o</mi><mi>j</mi><mi>e</mi><mi>c</mi><mi>t</mi><mo>=</mo><mi>M</mi><mo>.</mo><mi>p</mi><mi>r</mi><mi>o</mi><mi>j</mi><mi>e</mi><mi>c</mi><mi>t</mi><mspace width="3.0mm"/><mi>M</mi><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>project</mtext></mstyle></mrow><mrow><msub><mi>α</mi><mi>m</mi></msub><mfenced close=")" open="("><mi>r</mi><mi>M</mi></mfenced></mrow></mfrac></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mfrac><mrow><mi>r</mi><mo>.</mo><mi>m</mi><mi>o</mi><mi>d</mi><mi>u</mi><mi>l</mi><mi>e</mi><mo>=</mo><mi>r</mi><mo>.</mo><mi>m</mi><mi>o</mi><mi>d</mi><mi>u</mi><mi>l</mi><mi>e</mi><mspace width="3.0mm"/><mi>M</mi><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>private</mtext></mstyle></mrow><mrow><msub><mi>α</mi><mi>m</mi></msub><mfenced close=")" open="("><mi>r</mi><mi>M</mi></mfenced></mrow></mfrac></math></p>
+</div>
+<div class="paragraph">
+<p>If the type of the arguments is clear from the context, we simply write <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>α</mi><mfenced close=")" open="("><mi>r</mi><mi>M</mi></mfenced></math> instead of <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>α</mi><mi>m</mi></msub><mfenced close=")" open="("><mi>r</mi><mi>M</mi></mfenced></math>.</p>
+</div>
+<div class="paragraph">
+<p>Although private members are accessible inside a module, it is not possible to redefine (override etc.) these members (see <a href="classifiers.html#_redefinition-of-members">Redefinition of Members</a>).</p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-4"></a><strong>Req. IDE-4:</strong> <a href="#Req-IDE-4">Default Member Access Modifiers</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>The following constraints for member access modifiers must hold:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>The <em>default modifier</em> for members of user-declared classes is <code>project</code>.</p>
+</li>
+<li>
+<p>The <em>default modifier</em> for members of interfaces is the same as the visibility of the interface itself, except for private interfaces.
+For private interfaces, the default modifier for members is <code>project</code>.</p>
+</li>
+<li>
+<p>The modifier for enum literals is always <code>public</code>.</p>
+</li>
+<li>
+<p>Private members of a classifier are visible and accessible within a module, i.e. you can access the private method of a class, for instance,
+when the use of the class as receiver is in the same module where the class has been defined.
+In case of inheritance, private members are visible if the host (e.g. the class) is in the same module as the provider (the extended class).
+This also means that abstract members of a class are allowed to be defined private as they may be overridden within a module.</p>
+</li>
+</ol>
+</div>
+</div>
+</div>
+<div class="exampleblock">
+<div class="title">Example 3. Type and Member Access Modifiers</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">export project interface I {
+    project foo();
+}
+
+// This interface may be used publicly, but since the inherited method foo() is project visible only,
+// it is not possible to implement that interface in other projects.
+export public interface J extends I {
+}
+
+// Since the visibility of foo is set to public here, it is possible to implement this interface in other projects.
+export public interface K extends I {
+    @Override public foo();
+}
+
+// Since foo is private, it is not possible to subclass the class in other modules. Still, it
+// is possible to use it in other projects.
+// XPECT noerrors --&gt;
+export public abstract class C {
+    private abstract foo();
+
+    public static C instance() {
+        // return some default instance
+        ...
+    }
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>As demonstrated in the following snippet, class <code>C</code> can be used but not subclassed in other modules:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">import C from "C"
+
+// XPECT errors --&gt; "Cannot extend class C: cannot implement one or more non-accessible abstract members: method C.foo." at "C"
+export public abstract class Sub extends C {
+}
+
+// XPECT noerrors --&gt;
+var c: C = C.instance();</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Members of non-visible types are, in general, not visible for a client.
+Members may become visible, however, if they are accessed via a visible type which inherits these members.
+The following examples demonstrate two different scenarios:</p>
+</div>
+<div class="exampleblock">
+<div class="title">Example 4. Declaring type vs receiver type</div>
+<div class="content">
+<div class="paragraph">
+<p>It is especially noteworthy that the declaring type of a member is
+generally not considered for the accessibility of that member but only
+the receiver type is relevant.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">class Base {
+    public m(b: Base): void {}
+}
+export public class ApiType extends Base {
+}</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">import * as N from "Base";
+
+var t = new N.ApiType();
+// member can be accessed although type Base is not exported:
+t.m(t);</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>The property access to the member <code>m</code> is valid because it fulfills the constraints for accessibility.
+The receiver of the property access is <code>t</code> of type <code>ApiType</code>.
+That type is exported and accessible.
+Therefore, the inherited member <code>m</code> is also considered valid since it is also defined <code>public</code>.</p>
+</div>
+<div class="paragraph">
+<p>This rule allows for defining a common functionality in module or project visible types that becomes accessible via exported, visible subtypes.</p>
+</div>
+<div class="exampleblock">
+<div class="title">Example 5. Member Access and Type Access Interplay</div>
+<div class="content">
+<div class="paragraph">
+<p>The following example demonstrates the behavior when
+non-visible types are used as return types. In this case, all the
+members of the non-visible types are not accessible, even if they have a
+public access modifier.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">class A {
+    foo(): void{}
+}
+export public class C {
+    public getHidden(): A { return new A() };
+}</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">import * as Nfrom "A"
+
+class Client {
+    f(): void {
+        var c = new N.C();
+        // XPECT noerrors --&gt; Getting an instance the hidden type is possible
+        var hidden = c.getHidden();
+        // XPECT errors --&gt; "The method foo is not visible." at "foo"
+        hidden.foo();
+    }
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_valid-names"><a class="anchor" href="#_valid-names"></a><a class="link" href="#_valid-names">3.2.2. Valid Names</a></h4>
+<div class="paragraph">
+<p>For identifier and property names, the same constraints as in ECMAScript
+[<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.S7.6)</a>]
+[<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.S7.6.1.2)</a>]
+[<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.S11.6)</a>] are applied.</p>
+</div>
+<div class="paragraph">
+<p>Identifier names in N4JS are defined similar to [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.S11.6)</a>], making it possible to even use reserved words (keywords etc.).
+For some element types, errors or warnings are issued in order to prevent problems when using these names.</p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-5"></a><strong>Req. IDE-5:</strong> <a href="#Req-IDE-5">Forbidden Identifier Names in N4JS</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>In N4JS mode, errors are generated in the following cases:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>A name of a type equals</p>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p>an access modifier</p>
+</li>
+<li>
+<p><code>set</code> or <code>get</code></p>
+</li>
+<li>
+<p>an ECMAScript keyword</p>
+</li>
+<li>
+<p>a boolean literal</p>
+</li>
+<li>
+<p>the name of a base type</p>
+</li>
+</ol>
+</div>
+</li>
+<li>
+<p>The name of a function or function expression equals (but not the method)</p>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p>an ECMAScript keyword</p>
+</li>
+<li>
+<p>a reserved future ECMAScript word</p>
+</li>
+</ol>
+</div>
+</li>
+</ol>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-6"></a><strong>Req. IDE-6:</strong> <a href="#Req-IDE-6">Undesired Identifier Names in N4JS</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>In N4JS mode, warnings are generated in the following cases:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>The name of a member (of a non external type)</p>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p>equals the name of a base type <sup class="footnote">[<a id="_footnoteref_8" class="footnote" href="appendix_c_bibliography.html#_footnote_8" title="View footnote.">8</a>]</sup> but the type of the variable is different from that type</p>
+</li>
+<li>
+<p>is not static nor const but starts with an upper case letter</p>
+</li>
+</ol>
+</div>
+</li>
+<li>
+<p>The name of a non-external N4 types (class, interface, enum) starts with a lower case letter</p>
+</li>
+<li>
+<p>The name of a variable (incl. formal parameter or catch variable and fields)</p>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p>equals an N4JS keyword</p>
+</li>
+<li>
+<p>equals the name of a base type but the type of the variable is different from that type</p>
+</li>
+<li>
+<p>is not const but starts with an upper case letter</p>
+</li>
+</ol>
+</div>
+</li>
+</ol>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_qualified-names"><a class="anchor" href="#_qualified-names"></a><a class="link" href="#_qualified-names">3.2.3. Qualified Names</a></h4>
+<div class="paragraph">
+<p>In N4JS source code, types can only be referenced using their simple name.
+There is no such thing as a fully-qualified type name in N4JS or ECMAScript.
+Types are uniquely identified by their simple name, maybe together with an import and the module specifier given there.
+Clashes between simple names of imported type and locally declared types can be resolved by importing the type under an alias.</p>
+</div>
+<div class="paragraph">
+<p>In some cases, however, we need to define references to types or even members.
+For example, if we want to reference certain members in JSDoc comments or for unambiguous error messages.
+For this reason, we formally define qualified names even if they cannot occur in source code.</p>
+</div>
+<div class="paragraph">
+<p><a href="#tab:typenames">Different forms of module and type specifiers.</a> shows the different names of a given type <code>C</code>, defined in a module
+<code>M.n4js</code>, defined in a package <code>p</code> of a project <code>MyProject</code>.</p>
+</div>
+<div class="paragraph">
+<p>Simple type names are used throughout N4JS code in order to refer to types.
+The different forms of module specifiers are only used in import declarations in the string following the <code>from</code> keyword.</p>
+</div>
+<table id="tab:typenames" class="tableblock frame-all grid-all spread">
+<caption class="title">Table 3. Different forms of module and type specifiers.</caption>
+<colgroup>
+<col style="width: 50%;">
+<col style="width: 50%;">
+</colgroup>
+<thead>
+<tr>
+<th class="tableblock halign-left valign-top">Name</th>
+<th class="tableblock halign-center valign-top">Example</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Simple Type Name</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>C</code></p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">(Plain) Module Specifier</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>p/M</code></p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Complete Module Specifier</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>MyProject/p/M</code></p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Complete Type Specifier</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock"><code>MyProject/p/M.C</code></p></td>
+</tr>
+</tbody>
+</table>
+</div>
+<div class="sect3">
+<h4 id="_name-duplicates"><a class="anchor" href="#_name-duplicates"></a><a class="link" href="#_name-duplicates">3.2.4. Name Duplicates</a></h4>
+<div class="paragraph">
+<p>There might be cases where two (or more) scopes created by different entities with the same (simple) name overlap.
+Those situations can be referred to as shadowing, hiding, or obscuring.
+While they are not the same, many of those cases are not allowed in N4JS.
+For simplicity we refer to them all as shadowing or duplication (see below).
+Rule of thumb is that N4JS allows everything that is allowed in JavaScript StrictMode.</p>
+</div>
+<div class="sect4">
+<h5 id="_lexical-environment"><a class="anchor" href="#_lexical-environment"></a><a class="link" href="#_lexical-environment">3.2.4.1. Lexical Environment</a></h5>
+<div class="paragraph">
+<p>N4JS handles scopes similar to ECMAScript, so that function scope is applied to variables declared with <code>var</code> (and parameters), and block scope for variables is declared with <code>let</code> or <code>const</code>.
+In general, ECMAScript defines <em>Lexical Environments</em> as a specification type used to define the association of Identifiers to specific variables and functions based upon the lexical nesting structure of ECMAScript code [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.10.2)</a>].</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Elements that introduce lexical environments: </dt>
+<dd>
+<p><code>FunctionDefinition</code>, <code>VariableDeclaration</code>, <code>CatchBlock</code>, <code>WithStatement</code>, <code>ImportDeclaration</code></p>
+</dd>
+<dt class="hdlist1">N4JS specific declarations: </dt>
+<dd>
+<p><code>N4ClassDeclaration</code>, <code>N4InterfaceDeclaration</code>,
+<code>N4EnumDeclaration</code>, <code>N4MethodDeclaration</code>.</p>
+</dd>
+</dl>
+</div>
+<div class="paragraph">
+<p>Additionally, a built-in lexical environment that defines global scope exists for every <code>Script</code>.</p>
+</div>
+<div class="paragraph">
+<p>Since N4JS is extended (and a bit more strict) JS strict mode, <em>Object environment record</em>s created by <code>WithStatement</code> are not taken into account when resolving duplicates.
+This applies to both N4JS mode and JS strict mode.
+In unrestricted JS the <code>WithStatement</code> is allowed but duplicates are not validated.</p>
+</div>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title=""></i>
+</td>
+<td class="content">
+In case of names introduced by <code>ImportDeclaration</code>s only <code>NamedImportSpecifiers</code>s are taken into account (their import name or its alias if available).
+<code>WildcardImportSpecifiers</code>s are not taken into account.
+Potential optimizations by compiler or user annotation are also not currently taken into account during analysis.
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_duplicates-and-shadowing"><a class="anchor" href="#_duplicates-and-shadowing"></a><a class="link" href="#_duplicates-and-shadowing">3.2.4.2. Duplicates and Shadowing</a></h5>
+<div class="openblock definition">
+<div class="content">
+<div class="paragraph">
+<p><a id="shadowing_overriding_duplicates"></a><strong>Definition:</strong> <a href="#shadowing_overriding_duplicates">Shadowing Overriding Duplicates</a></p>
+</div>
+<div class="paragraph">
+<p>Two elements with the same name declared in the same lexical environment (cf. [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.S10.2.2.1)</a>] are called <em>duplicates</em>.
+An element defined in an environment <em>shadows</em> all elements with the same name in outer environments.</p>
+</div>
+<div class="paragraph">
+<p>In class hierarchies, a member with the same name as a member defined in a supertype is said to override the latter.
+Overriding is discussed in <a href="classifiers.html#_redefinition-of-members">Redefinition of Members</a>.</p>
+</div>
+<div class="paragraph">
+<p>For the following constraints, we make the following assumptions:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Names of function expressions or declarations are handles similar to locally declared elements in the function.
+Function declarations are additionally declaring a name in their outer scope.</p>
+</li>
+<li>
+<p>The implicit formal parameter <code>arguments</code> is treated similar to declared formal parameters.</p>
+</li>
+<li>
+<p>Formal parameters are defined in the lexical environment of a function, that is, they are defined in the same lexical environment as local <code>var</code>-variables or other declarations in that function.</p>
+</li>
+<li>
+<p>The "global" environment contains objects globally defined by the execution environment.</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-7"></a><strong>Req. IDE-7:</strong> <a href="#Req-IDE-7">Forbidden Duplicates</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>There must be no two elements defined in the same lexical environment with the same name,
+that is, there must be no duplicates.</p>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-8"></a><strong>Req. IDE-8:</strong> <a href="#Req-IDE-8">Forbidden Shadowing</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>In general, shadowing is allowed in N4JS.
+But it is not allowed in the following cases:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>No element defined in the standard global scope must be shadowed.</p>
+</li>
+<li>
+<p>There must be no function shadowing another function.</p>
+</li>
+<li>
+<p>Elements defined in catch blocks must not shadow elements defined all parent non-catch-block environments.</p>
+</li>
+</ol>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-9"></a><strong>Req. IDE-9:</strong> <a href="#Req-IDE-9">Forbidden Names</a> (ver. 1)</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>In the script environment, it is not allowed to use the name
+’arguments’.<sup class="footnote">[<a id="_footnoteref_9" class="footnote" href="appendix_c_bibliography.html#_footnote_9" title="View footnote.">9</a>]</sup></p>
+<div class="paragraph">
+<p><a href="#fig-forbidden-shadowing">Forbidden Shadowing</a> shows nested lexical environments with named elements declared inside (all named <code>x</code> here), the forbidden cases are marked with arrows
+(the numbers at the left side refer to the numbers in <a href="#Req-IDE-8">[Req-IDE-8]</a>.</p>
+</div>
+</li>
+</ol>
+</div>
+<div id="fig-forbidden-shadowing" class="imageblock" style="text-align: center">
+<div class="content">
+<img src="chapters/03_names/fig/shadowing.png" alt="shadowing" width="50%">
+</div>
+<div class="title">Figure 1. Forbidden Shadowing</div>
+</div>
+<div class="paragraph">
+<p>Rationale:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>We expect only few named nested functions.
+Since this is expected to be a rare case, no shadowing should occur there as this is maybe not expected by the programmer.</p>
+</li>
+<li>
+<p>It is typical that nested environments define local variables.
+In particular helper variables (such as <code>i: number i</code> or <code>s: string</code> ) are expected to be used quite often.
+Since this is a typical case, we allow shadowing for local variables.</p>
+</li>
+<li>
+<p>Function declarations may shadow type declarations.
+However, both entities are to be handled completely differently, so that an error will occur if the shadowing is ignored by the programmer anyway.</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div id="footer">
+<div id="footer-text">
+Version 0.9<br>
+Last updated 2019-08-07 15:02:40 CEST
+</div>
+</div>
+<!-- ************* docinfo-footer *************************************************************** -->
+<div class="Grid social" style="color:#d5dfea">
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <h2>Quick Links</h2>
+    <ul>
+      <li><a href="../downloads.html">Download</a></li>
+      <li><a href="../userguides/index.html">Documentation</a></li>
+      <li><a href="https://github.com/eclipse/n4js/">Source</a></li>
+      <li><a href="https://github.com/eclipse/n4js/issues">Issues</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="https://www.eclipse.org/forums/index.php/f/365/">Forum</a></li>
+      <li><a href="http://n4js.blogspot.de/">Blog</a></li>
+      <li><a href="https://dev.eclipse.org/mailman/listinfo/n4js-dev">Mailing List</a></li>
+      <li><a href="https://projects.eclipse.org/projects/technology.n4js">Eclipse Project Page</a></li>
+      <li><a href="https://twitter.com/n4jsdev">Tweets by n4jsdev</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="http://www.eclipse.org/">Eclipse Home</a></li>
+      <li><a href="http://www.eclipse.org/legal/privacy.php">Privacy Policy</a></li>
+      <li><a href="http://www.eclipse.org/legal/termsofuse.php">Terms of Use</a></li>
+      <li><a href="http://www.eclipse.org/legal/copyright.php">Copyright Agent</a></li>
+      <li><a href="http://www.eclipse.org/legal/">Legal</a></li>
+    </ul>
+  </div>
+  <div style="clear: both; height: 0; overflow: hidden;"></div>
+</div>
+
+<!-- ************* UI Scripts ************* -->
+<script type="text/javascript" src="scripts/back-to-top.js"></script>
+
+<script type="text/javascript" src="scripts/treeview.js"></script>
+<script type="text/javascript" src="scripts/toc.js"></script>
+
+<!-- ************* Prism.js Syntax Highlighting ************* -->
+<script src="scripts/prism.js"></script>
+
+<script type="text/javascript">
+	// Add the 'toclist' id for search function
+	$(".toc2 > ul").attr('id', 'toclist');
+	// Generate a Search input form
+	$("#toclist > li:first-of-type").before('<input type="text" id="pagesearch" onkeyup="search()" placeholder="Search for section...">');
+	$("#toclist > li:first-of-type").before('<i id="clear" class="fa fa-times-circle-o"></i>');
+	$("#clear").click(function(){
+	    $("#pagesearch").val('');
+	    search();
+	    $('.toc2 > ul').treeView('collapseAll');
+	});
+	// intialize Treeview.js
+	$(".toc2 > ul").treeView();
+	// Initialize Scrollspy
+</script>
+<!-- ************* docinfo-footer *************************************************************** -->
+</body>
+</html>
\ No newline at end of file
diff --git a/spec/plainjs.html b/spec/plainjs.html
new file mode 100644
index 0000000..6992b31
--- /dev/null
+++ b/spec/plainjs.html
@@ -0,0 +1,1466 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="generator" content="Asciidoctor 1.5.5">
+<meta name="author" content="2019-08-07 15:02:40 CEST">
+<title>N4JS Language Specification</title>
+<link rel="stylesheet" href="styles/spec.min.css">
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.6.3/css/font-awesome.min.css">
+<!-- ************* docinfo ******************************************************************* -->
+
+
+<!-- ************* Favicon ************-->
+<link rel="icon" href="images/favicon.ico" />
+
+<!-- ************* Back-to-top JQuery ************* -->
+<script src="https://code.jquery.com/jquery-1.12.4.js"></script>
+<script src="https://code.jquery.com/ui/1.12.0/jquery-ui.js"></script>
+
+
+<link href="styles/prism.min.css" rel="stylesheet" />
+<script type="text/javascript" async
+  src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2/MathJax.js?config=TeX-MML-AM_CHTML">
+</script>
+
+<!-- ************* Styles ************* -->
+<link rel="stylesheet" type="text/css" href="styles/n4jsspec-adoc.css">
+
+
+<!-- ****************** NavBar ****************** -->
+<div id="menubar">
+	<div class="banner">
+        <a href="https://www.eclipse.org/n4js/#"><img id="logo" src="images/n4js-logo.png" alt="Eclipse N4JS"></a>
+    </div>
+<ul>
+  <li><a href="index.html">Index</a></li>
+</ul>
+</div>
+<!-- ************* docinfo ******************************************************************* -->
+<style>
+      .admonitionblock td.icon .icon-todo:before{content:"\f249";color:#f4ee42}
+    </style>
+</head>
+<body class="book toc2 toc-left">
+<div id="header">
+<h1>N4JS Language Specification</h1>
+<div class="details">
+<span id="author" class="author">2019-08-07 15:02:40 CEST</span><br>
+<span id="revnumber">version 0.9</span>
+</div>
+<div id="toc" class="toc2">
+<div id="toctitle">Table of Contents</div>
+<ul class="sectlevel1">
+<li><a href="introduction.html#_introduction">1. Introduction</a>
+<ul class="sectlevel2">
+<li><a href="introduction.html#_notation">1.1. Notation</a>
+<ul class="sectlevel3">
+<li><a href="introduction.html#_grammar-notation">1.1.1. Grammar Notation</a></li>
+<li><a href="introduction.html#_type-judgments-and-rules-and-constraints-notation">1.1.2. Type Judgments and Rules and Constraints Notation</a>
+<ul class="sectlevel4">
+<li><a href="introduction.html#_typing-rules-and-judgments">1.1.2.1. Typing Rules and Judgments</a></li>
+<li><a href="introduction.html#_types-of-an-element">1.1.2.2. Types of an Element</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="introduction.html#_auxiliary-functions">1.2. Auxiliary Functions</a>
+<ul class="sectlevel3">
+<li><a href="introduction.html#_binding">1.2.1. Binding</a></li>
+<li><a href="introduction.html#_merging-types">1.2.2. Merging Types</a>
+<ul class="sectlevel4">
+<li><a href="introduction.html#_logic-formulas">1.2.2.1. Logic Formulas</a></li>
+</ul>
+</li>
+<li><a href="introduction.html#_symbols-and-font-convention">1.2.3. Symbols and Font Convention</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="grammar.html#_grammar">2. Grammar</a>
+<ul class="sectlevel2">
+<li><a href="grammar.html#_lexical-conventions">2.1. Lexical Conventions</a>
+<ul class="sectlevel3">
+<li><a href="grammar.html#_identifier-names-and-identifiers">2.1.1. Identifier Names and Identifiers</a></li>
+<li><a href="grammar.html#_this-keyword">2.1.2. This Keyword</a></li>
+<li><a href="grammar.html#_regular-expression-literals">2.1.3. Regular Expression Literals</a></li>
+<li><a href="grammar.html#_automatic-semicolon-insertion">2.1.4. Automatic Semicolon Insertion</a></li>
+<li><a href="grammar.html#_jsdoc">2.1.5. JSDoc</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="names.html#_names">3. Names</a>
+<ul class="sectlevel2">
+<li><a href="names.html#_access-control">3.1. Access Control</a></li>
+<li><a href="names.html#_accessibility-of-types-top-level-variables-and-function-declarations">3.2. Accessibility of Types, Top-Level Variables and Function Declarations</a>
+<ul class="sectlevel3">
+<li><a href="names.html#_accessibility-of-members">3.2.1. Accessibility of Members</a></li>
+<li><a href="names.html#_valid-names">3.2.2. Valid Names</a></li>
+<li><a href="names.html#_qualified-names">3.2.3. Qualified Names</a></li>
+<li><a href="names.html#_name-duplicates">3.2.4. Name Duplicates</a>
+<ul class="sectlevel4">
+<li><a href="names.html#_lexical-environment">3.2.4.1. Lexical Environment</a></li>
+<li><a href="names.html#_duplicates-and-shadowing">3.2.4.2. Duplicates and Shadowing</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="types.html#_types">4. Types</a>
+<ul class="sectlevel2">
+<li><a href="types.html#_overview">4.1. Overview</a></li>
+<li><a href="types.html#_type-expressions">4.2. Type Expressions</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_syntax">4.2.1. Syntax</a></li>
+<li><a href="types.html#_properties">4.2.2. Properties</a></li>
+<li><a href="types.html#_semantics">4.2.3. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_type-inference">4.3. Type Inference</a></li>
+<li><a href="types.html#_generic-and-parameterized-types">4.4. Generic and Parameterized Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_generic-types">4.4.1. Generic Types</a></li>
+<li><a href="types.html#_type-variables">4.4.2. Type Variables</a></li>
+<li><a href="types.html#_parameterized-types">4.4.3. Parameterized Types</a></li>
+</ul>
+</li>
+<li><a href="types.html#_primitive-ecmascript-types">4.5. Primitive ECMAScript Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_undefined-type">4.5.1. Undefined Type</a></li>
+<li><a href="types.html#_null-type">4.5.2. Null Type</a></li>
+<li><a href="types.html#_primitive-boolean-type">4.5.3. Primitive Boolean Type</a></li>
+<li><a href="types.html#_primitive-string-type">4.5.4. Primitive String Type</a></li>
+<li><a href="types.html#_primitive-number-type">4.5.5. Primitive Number Type</a></li>
+<li><a href="types.html#_primitive-type-int">4.5.6. Primitive Type int</a></li>
+<li><a href="types.html#_primitive-symbol-type">4.5.7. Primitive Symbol Type</a></li>
+</ul>
+</li>
+<li><a href="types.html#_primitive-n4js-types">4.6. Primitive N4JS Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_any-type">4.6.1. Any Type</a>
+<ul class="sectlevel4">
+<li><a href="types.html#any-type-semantics">4.6.1.1. Semantics</a></li>
+<li><a href="types.html#any-type-type-inference">4.6.1.2. Type Inference</a>
+<ul class="sectlevel5">
+<li><a href="types.html#_default-type-of-variables">4.6.1.2.1. Default Type of Variables</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="types.html#_void-type">4.6.2. Void Type</a>
+<ul class="sectlevel4">
+<li><a href="types.html#void-type-semantics">4.6.2.1. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_unknown-type">4.6.3. Unknown Type</a></li>
+<li><a href="types.html#_primitive-pathselector-and-i18nkey">4.6.4. Primitive Pathselector and I18nKey</a>
+<ul class="sectlevel4">
+<li><a href="types.html#pathselector-semantics">4.6.4.1. Semantics</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="types.html#_built-in-ecmascript-object-types">4.7. Built-in ECMAScript Object Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#ECMAScript-objects-semantics">4.7.1. Semantics</a></li>
+<li><a href="types.html#_object-type">4.7.2. Object Type</a></li>
+<li><a href="types.html#_function-object-type">4.7.3. Function-Object-Type</a></li>
+<li><a href="types.html#_array-object-type">4.7.4. Array Object Type</a></li>
+<li><a href="types.html#_string-object-type">4.7.5. String Object Type</a></li>
+<li><a href="types.html#_boolean-object-type">4.7.6. Boolean Object Type</a></li>
+<li><a href="types.html#_number-object-type">4.7.7. Number Object Type</a></li>
+<li><a href="types.html#_global-object-type">4.7.8. Global Object Type</a></li>
+<li><a href="types.html#_symbol">4.7.9. Symbol</a></li>
+<li><a href="types.html#_promise">4.7.10. Promise</a></li>
+<li><a href="types.html#_iterator-interface">4.7.11. Iterator Interface</a></li>
+<li><a href="types.html#_iterable-interface">4.7.12. Iterable Interface</a></li>
+</ul>
+</li>
+<li><a href="types.html#_built-in-n4js-types">4.8. Built-In N4JS Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_n4object">4.8.1. N4Object</a>
+<ul class="sectlevel4">
+<li><a href="types.html#N4Object-semantics">4.8.1.1. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_n4class">4.8.2. N4Class</a></li>
+<li><a href="types.html#IterableN">4.8.3. IterableN</a></li>
+</ul>
+</li>
+<li><a href="types.html#_type-modifiers">4.9. Type Modifiers</a>
+<ul class="sectlevel3">
+<li><a href="types.html#Type_Modifiers_Dynamic">4.9.1. Dynamic</a></li>
+<li><a href="types.html#_optional-return-types">4.9.2. Optional Return Types</a></li>
+</ul>
+</li>
+<li><a href="types.html#_union-and-intersection-type-composed-types">4.10. Union and Intersection Type (Composed Types)</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_union-type">4.10.1. Union Type</a>
+<ul class="sectlevel4">
+<li><a href="types.html#union-type-syntax">4.10.1.1. Syntax</a></li>
+<li><a href="types.html#union-type-semantics">4.10.1.2. Semantics</a></li>
+<li><a href="types.html#_warnings">4.10.1.3. Warnings</a></li>
+</ul>
+</li>
+<li><a href="types.html#_intersection-type">4.10.2. Intersection Type</a>
+<ul class="sectlevel4">
+<li><a href="types.html#intersection-type-syntax">4.10.2.1. Syntax</a></li>
+<li><a href="types.html#intersection-type-semantics">4.10.2.2. Semantics</a></li>
+<li><a href="types.html#_warnings-2">4.10.2.3. Warnings</a></li>
+</ul>
+</li>
+<li><a href="types.html#_composed-types-in-wildcards">4.10.3. Composed Types in Wildcards</a></li>
+<li><a href="types.html#_property-access-for-composed-types">4.10.4. Property Access for Composed Types</a>
+<ul class="sectlevel4">
+<li><a href="types.html#_properties-of-union-type">4.10.4.1. Properties of Union Type</a>
+<ul class="sectlevel5">
+<li><a href="types.html#_remarks-on-union-type-s-members">4.10.4.1.1. Remarks on union type’s members:</a></li>
+</ul>
+</li>
+<li><a href="types.html#_properties-of-intersection-type">4.10.4.2. Properties of Intersection Type</a>
+<ul class="sectlevel5">
+<li><a href="types.html#_remarks-on-intersection-type-s-methods">4.10.4.2.1. Remarks on intersection type’s methods:</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="types.html#_constructor-and-classifier-type">4.11. Constructor and Classifier Type</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_syntax-3">4.11.1. Syntax</a></li>
+<li><a href="types.html#_semantics-2">4.11.2. Semantics</a></li>
+<li><a href="types.html#_constructors-and-prototypes-in-ecmascript-2015">4.11.3. Constructors and Prototypes in ECMAScript 2015</a></li>
+</ul>
+</li>
+<li><a href="types.html#_this-type">4.12. This Type</a>
+<ul class="sectlevel3">
+<li><a href="types.html#this-type-syntax">4.12.1. Syntax</a></li>
+<li><a href="types.html#this-keyword-semantics">4.12.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_enums">4.13. Enums</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_enums-n4js">4.13.1. Enums (N4JS)</a>
+<ul class="sectlevel4">
+<li><a href="types.html#enums-syntax">4.13.1.1. Syntax</a></li>
+<li><a href="types.html#enums-semantics">4.13.1.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_string-based-enums">4.13.2. String-Based Enums</a></li>
+</ul>
+</li>
+<li><a href="types.html#_short-hand-syntax">4.14. Short-Hand Syntax</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_array-short-hand-syntax">4.14.1. Array Short-Hand Syntax</a></li>
+<li><a href="types.html#_iterablen-short-hand-syntax">4.14.2. IterableN Short-Hand Syntax</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="classifiers.html#_classifiers">5. Classifiers</a>
+<ul class="sectlevel2">
+<li><a href="classifiers.html#_n4js-specific-classifiers">5.1. N4JS Specific Classifiers</a>
+<ul class="sectlevel3">
+<li><a href="classifiers.html#_properties-2">5.1.1. Properties</a></li>
+<li><a href="classifiers.html#_common-semantics-of-classifiers">5.1.2. Common Semantics of Classifiers</a></li>
+<li><a href="classifiers.html#_classes">5.1.3. Classes</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_definition-of-classes">5.1.3.1. Definition of Classes</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#class-syntax">5.1.3.1.1. Syntax</a></li>
+<li><a href="classifiers.html#class-properties">5.1.3.1.2. Properties</a></li>
+<li><a href="classifiers.html#class-type-inference">5.1.3.1.3. Type Inference</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#class-semantics">5.1.3.2. Semantics</a></li>
+<li><a href="classifiers.html#_final-modifier">5.1.3.3. Final Modifier</a></li>
+<li><a href="classifiers.html#_abstract-classes">5.1.3.4. Abstract Classes</a></li>
+<li><a href="classifiers.html#_non-instantiable-classes">5.1.3.5. Non-Instantiable Classes</a></li>
+<li><a href="classifiers.html#_superclass">5.1.3.6. Superclass</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_interfaces">5.1.4. Interfaces</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_definition-of-interfaces">5.1.4.1. Definition of Interfaces</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#interfaces-syntax">5.1.4.1.1. Syntax</a></li>
+<li><a href="classifiers.html#interfaces-properties">5.1.4.1.2. Properties</a></li>
+<li><a href="classifiers.html#interfaces-type-inference">5.1.4.1.3. Type Inference</a></li>
+<li><a href="classifiers.html#interfaces-semantics">5.1.4.1.4. Semantics</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="classifiers.html#_generic-classifiers">5.1.5. Generic Classifiers</a></li>
+<li><a href="classifiers.html#sec:definition-site-variance">5.1.6. Definition-Site Variance</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_members">5.2. Members</a>
+<ul class="sectlevel3">
+<li><a href="classifiers.html#_syntax-4">5.2.1. Syntax</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_properties-3">5.2.1.1. Properties</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_semantics-3">5.2.2. Semantics</a></li>
+<li><a href="classifiers.html#_methods">5.2.3. Methods</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_syntax-5">5.2.3.1. Syntax</a></li>
+<li><a href="classifiers.html#_properties-4">5.2.3.2. Properties</a></li>
+<li><a href="classifiers.html#_semantics-4">5.2.3.3. Semantics</a></li>
+<li><a href="classifiers.html#_final-methods">5.2.3.4. Final Methods</a></li>
+<li><a href="classifiers.html#_abstract-methods">5.2.3.5. Abstract Methods</a></li>
+<li><a href="classifiers.html#_generic-methods">5.2.3.6. Generic Methods</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_default-methods-in-interfaces">5.2.4. Default Methods in Interfaces</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_asynchronous-methods">5.2.4.1. Asynchronous Methods</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_constructors">5.2.5. Constructors</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_structural-this-type-in-constructor">5.2.5.1. Structural This Type in Constructor</a></li>
+<li><a href="classifiers.html#spec-constructor">5.2.5.2. @Spec Constructor</a></li>
+<li><a href="classifiers.html#_callable-constructors">5.2.5.3. Callable Constructors</a></li>
+<li><a href="classifiers.html#_covariant-constructors">5.2.5.4. Covariant Constructors</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_data-fields">5.2.6. Data Fields</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#data-fields-syntax">5.2.6.1. Syntax</a></li>
+<li><a href="classifiers.html#data-fields-properties">5.2.6.2. Properties</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#data-fields-semantics">5.2.6.2.1. Semantics</a></li>
+<li><a href="classifiers.html#data-fields-type-inference">5.2.6.2.2. Type Inference</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_assignment-modifiers">5.2.6.3. Assignment Modifiers</a></li>
+<li><a href="classifiers.html#_field-accessors-getter-setter">5.2.6.4. Field Accessors (Getter/Setter)</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#field-acessors-syntax">5.2.6.4.1. Syntax</a></li>
+<li><a href="classifiers.html#field-acessors-properties">5.2.6.4.2. Properties</a></li>
+<li><a href="classifiers.html#field-accessors-semantics">5.2.6.4.3. Semantics</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#optional-fields">5.2.6.5. Optional Fields</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#_syntax-6">5.2.6.5.1. Syntax</a></li>
+<li><a href="classifiers.html#_semantics-5">5.2.6.5.2. Semantics</a></li>
+<li><a href="classifiers.html#_background">5.2.6.5.3. Background</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="classifiers.html#_static-members">5.2.7. Static Members</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_access-from-and-to-static-members">5.2.7.1. Access From and To Static Members</a></li>
+<li><a href="classifiers.html#_generic-static-methods">5.2.7.2. Generic static methods</a></li>
+<li><a href="classifiers.html#_static-members-of-interfaces">5.2.7.3. Static Members of Interfaces</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_redefinition-of-members">5.2.8. Redefinition of Members</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_overriding-of-members">5.2.8.1. Overriding of Members</a></li>
+<li><a href="classifiers.html#_implementation-of-members">5.2.8.2. Implementation of Members</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#_member-consumption">5.2.8.2.1. Member Consumption</a></li>
+<li><a href="classifiers.html#_member-implementation">5.2.8.2.2. Member Implementation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="classifiers.html#_structural-typing">5.3. Structural Typing</a>
+<ul class="sectlevel3">
+<li><a href="classifiers.html#_syntax-7">5.3.1. Syntax</a></li>
+<li><a href="classifiers.html#_definition-site-structural-typing">5.3.2. Definition Site Structural Typing</a></li>
+<li><a href="classifiers.html#_use-site-structural-typing">5.3.3. Use-Site Structural Typing</a></li>
+<li><a href="classifiers.html#structural-readWriteInit-field-typing">5.3.4. Structural Read-only, Write-only and Initializer Field Typing</a></li>
+<li><a href="classifiers.html#_public-setter-annotated-with-code-providesinitializer-code">5.3.5. Public Setter Annotated With <code>ProvidesInitializer</code></a></li>
+<li><a href="classifiers.html#_structural-types-with-optional-fields">5.3.6. Structural Types With Optional Fields</a></li>
+<li><a href="classifiers.html#_structural-types-with-access-modifier">5.3.7. Structural Types With Access Modifier</a></li>
+<li><a href="classifiers.html#_structural-types-with-additional-members">5.3.8. Structural Types With Additional Members</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_syntax-8">5.3.8.1. Syntax</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#_semantics-6">5.3.8.1.1. Semantics</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="functions.html#_functions">6. Functions</a>
+<ul class="sectlevel2">
+<li><a href="functions.html#_function-type">6.1. Function Type</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_properties-5">6.1.1. Properties</a></li>
+<li><a href="functions.html#function-type-inference">6.1.2. Type Inference</a></li>
+<li><a href="functions.html#_autoboxing-of-function-type">6.1.3. Autoboxing of Function Type</a></li>
+<li><a href="functions.html#_arguments-object">6.1.4. Arguments Object</a></li>
+</ul>
+</li>
+<li><a href="functions.html#_ecmascript-5-function-definition">6.2. ECMAScript 5 Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_function-declaration">6.2.1. Function Declaration</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#_syntax-9">6.2.1.1. Syntax</a></li>
+<li><a href="functions.html#_semantics-8">6.2.1.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="functions.html#_function-expression">6.2.2. Function Expression</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#function-expression-syntax">6.2.2.1. Syntax</a></li>
+<li><a href="functions.html#_semantics-and-type-inference">6.2.2.2. Semantics and Type Inference</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="functions.html#_ecmascript-2015-function-definition">6.3. ECMAScript 2015 Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_formal-parameters">6.3.1. Formal Parameters</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#Type_Modifiers_Optional">6.3.1.1. Optional Parameters</a></li>
+<li><a href="functions.html#Type_Modifiers_Default">6.3.1.2. Default Parameters</a></li>
+<li><a href="functions.html#Type_Modifiers_Variadic">6.3.1.3. Variadic</a></li>
+</ul>
+</li>
+<li><a href="functions.html#_generator-functions">6.3.2. Generator Functions</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#generator-functions-syntax">6.3.2.1. Syntax</a></li>
+<li><a href="functions.html#generator-functions-semantics">6.3.2.2. Semantics</a></li>
+<li><a href="functions.html#_generator-arrow-functions">6.3.2.3. Generator Arrow Functions</a></li>
+</ul>
+</li>
+<li><a href="functions.html#_arrow-function-expression">6.3.3. Arrow Function Expression</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#arrow-function-expression-syntax">6.3.3.1. Syntax</a></li>
+<li><a href="functions.html#arrow-function-expression-semantics-and-type-inference">6.3.3.2. Semantics and Type Inference</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="functions.html#_ecmascript-proposals-function-definition">6.4. ECMAScript Proposals Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_asynchronous-functions">6.4.1. Asynchronous Functions</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#asynchronous-functions-syntax">6.4.1.1. Syntax</a></li>
+<li><a href="functions.html#asynchronous-functions-semantics">6.4.1.2. Semantics</a></li>
+<li><a href="functions.html#_asynchronous-arrow-functions">6.4.1.3. Asynchronous Arrow Functions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="functions.html#_n4js-extended-function-definition">6.5. N4JS Extended Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_generic-functions">6.5.1. Generic Functions</a></li>
+<li><a href="functions.html#_promisifiable-functions">6.5.2. Promisifiable Functions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_conversions-and-reflection">7. Conversions and Reflection</a>
+<ul class="sectlevel2">
+<li><a href="conversions_and_reflection.html#_autoboxing-and-coercing">7.1. Autoboxing and Coercing</a>
+<ul class="sectlevel3">
+<li><a href="conversions_and_reflection.html#_coercing">7.1.1. Coercing</a></li>
+<li><a href="conversions_and_reflection.html#_autoboxing-of-primitives">7.1.2. Autoboxing of Primitives</a></li>
+<li><a href="conversions_and_reflection.html#_autoboxing-of-function-expressions-and-declarations">7.1.3. Autoboxing of Function Expressions and Declarations</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_auto-conversion-of-objects">7.2. Auto-Conversion of Objects</a>
+<ul class="sectlevel3">
+<li><a href="conversions_and_reflection.html#_auto-conversion-of-class-instances">7.2.1. Auto-Conversion of Class Instances</a>
+<ul class="sectlevel4">
+<li><a href="conversions_and_reflection.html#_auto-conversion-of-interface-instances">7.2.1.1. Auto-Conversion of Interface Instances</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_auto-conversion-of-enum-literals">7.2.2. Auto-Conversion of Enum Literals</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_type-cast-and-type-check">7.3. Type Cast and Type Check</a>
+<ul class="sectlevel3">
+<li><a href="conversions_and_reflection.html#_type-cast">7.3.1. Type Cast</a></li>
+<li><a href="conversions_and_reflection.html#_type-check">7.3.2. Type Check</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_reflection-meta-information">7.4. Reflection meta-information</a>
+<ul class="sectlevel3">
+<li><a href="conversions_and_reflection.html#_reflection-for-classes">7.4.1. Reflection for Classes</a></li>
+<li><a href="conversions_and_reflection.html#_reflection-for-interfaces">7.4.2. Reflection for Interfaces</a></li>
+<li><a href="conversions_and_reflection.html#_reflection-for-enumerations">7.4.3. Reflection for Enumerations</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_conversion-of-primitive-types">7.5. Conversion of primitive types</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_expressions">8. Expressions</a>
+<ul class="sectlevel2">
+<li><a href="expressions.html#_ecmascript-5-expressions">8.1. ECMAScript 5 Expressions</a>
+<ul class="sectlevel3">
+<li><a href="expressions.html#_the-this-literal">8.1.1. The this Literal</a></li>
+<li><a href="expressions.html#_identifier">8.1.2. Identifier</a></li>
+<li><a href="expressions.html#_literals">8.1.3. Literals</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#_integer-literals">8.1.3.1. Integer Literals</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_array-literal">8.1.4. Array Literal</a></li>
+<li><a href="expressions.html#_object-literal">8.1.5. Object Literal</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#_properties-6">8.1.5.1. Properties</a></li>
+<li><a href="expressions.html#_scoping-and-linking">8.1.5.2. Scoping and linking</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_parenthesized-expression-and-grouping-operator">8.1.6. Parenthesized Expression and Grouping Operator</a></li>
+<li><a href="expressions.html#_property-accessors">8.1.7. Property Accessors</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#properties-1">8.1.7.1. Properties</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_new-expression">8.1.8. New Expression</a></li>
+<li><a href="expressions.html#_function-expression-2">8.1.9. Function Expression</a></li>
+<li><a href="expressions.html#_function-calls">8.1.10. Function Calls</a></li>
+<li><a href="expressions.html#_postfix-expression">8.1.11. Postfix Expression</a></li>
+<li><a href="expressions.html#_unary-expression">8.1.12. Unary Expression</a></li>
+<li><a href="expressions.html#_multiplicative-expression">8.1.13. Multiplicative Expression</a></li>
+<li><a href="expressions.html#_additive-expression">8.1.14. Additive Expression</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#type-inference-10">8.1.14.1. Type Inference</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_bitwise-shift-expression">8.1.15. Bitwise Shift Expression</a></li>
+<li><a href="expressions.html#_relational-expression">8.1.16. Relational Expression</a></li>
+<li><a href="expressions.html#_equality-expression">8.1.17. Equality Expression</a></li>
+<li><a href="expressions.html#_binary-bitwise-expression">8.1.18. Binary Bitwise Expression</a></li>
+<li><a href="expressions.html#_binary-logical-expression">8.1.19. Binary Logical Expression</a></li>
+<li><a href="expressions.html#_conditional-expression">8.1.20. Conditional Expression</a></li>
+<li><a href="expressions.html#_assignment-expression">8.1.21. Assignment Expression</a></li>
+<li><a href="expressions.html#_comma-expression">8.1.22. Comma Expression</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_ecmascript-6-expressions">8.2. ECMAScript 6 Expressions</a>
+<ul class="sectlevel3">
+<li><a href="expressions.html#_the-super-keyword">8.2.1. The super Keyword</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_ecmascript-7-expressions">8.3. ECMAScript 7 Expressions</a>
+<ul class="sectlevel3">
+<li><a href="expressions.html#_await-expression">8.3.1. Await Expression</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_n4js-specific-expressions">8.4. N4JS Specific Expressions</a>
+<ul class="sectlevel3">
+<li><a href="expressions.html#_class-expression">8.4.1. Class Expression</a></li>
+<li><a href="expressions.html#_cast-as-expression">8.4.2. Cast (As) Expression</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#cast-as-expression-semantics-type-inference">8.4.2.1. Semantics and Type Inference</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#Import_Calls">8.4.3. Import Calls</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#compile-time-expressions">8.5. Compile-Time Expressions</a></li>
+</ul>
+</li>
+<li><a href="statements.html#_statements">9. Statements</a>
+<ul class="sectlevel2">
+<li><a href="statements.html#_ecmascript-5-statements">9.1. ECMAScript 5 Statements</a>
+<ul class="sectlevel3">
+<li><a href="statements.html#_function-or-field-accessor-bodies">9.1.1. Function or Field Accessor Bodies</a></li>
+<li><a href="statements.html#_variable-statement">9.1.2. Variable Statement</a></li>
+<li><a href="statements.html#_if-statement">9.1.3. If Statement</a></li>
+<li><a href="statements.html#_iteration-statements">9.1.4. Iteration Statements</a></li>
+<li><a href="statements.html#_return-statement">9.1.5. Return Statement</a></li>
+<li><a href="statements.html#_with-statement">9.1.6. With Statement</a></li>
+<li><a href="statements.html#_switch-statement">9.1.7. Switch Statement</a></li>
+<li><a href="statements.html#_throw-try-and-catch-statements">9.1.8. Throw, Try, and Catch Statements</a></li>
+<li><a href="statements.html#_debugger-statement">9.1.9. Debugger Statement</a></li>
+</ul>
+</li>
+<li><a href="statements.html#_ecmascript-6-statements">9.2. ECMAScript 6 Statements</a>
+<ul class="sectlevel3">
+<li><a href="statements.html#_let">9.2.1. Let</a></li>
+<li><a href="statements.html#_const">9.2.2. Const</a></li>
+<li><a href="statements.html#_for-of-statement">9.2.3. <code>for &#8230;&#8203; of</code> statement</a></li>
+<li><a href="statements.html#_import-statement">9.2.4. Import Statement</a>
+<ul class="sectlevel4">
+<li><a href="statements.html#Dynamic_Imports">9.2.4.1. Dynamic Imports</a></li>
+<li><a href="statements.html#_immutabilaty-of-imports">9.2.4.2. Immutabilaty of Imports</a></li>
+</ul>
+</li>
+<li><a href="statements.html#_export-statement">9.2.5. Export Statement</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="annotations.html#_annotations">10. Annotations</a>
+<ul class="sectlevel2">
+<li><a href="annotations.html#_introduction-2">10.1. Introduction</a>
+<ul class="sectlevel3">
+<li><a href="annotations.html#_syntax-13">10.1.1. Syntax</a></li>
+<li><a href="annotations.html#_properties-7">10.1.2. Properties</a></li>
+<li><a href="annotations.html#_element-specific-annotations">10.1.3. Element-Specific Annotations</a></li>
+<li><a href="annotations.html#_general-annotations">10.1.4. General Annotations</a>
+<ul class="sectlevel4">
+<li><a href="annotations.html#_idebug">10.1.4.1. IDEBUG</a></li>
+</ul>
+</li>
+<li><a href="annotations.html#idebug-syntax">10.1.5. Syntax</a>
+<ul class="sectlevel4">
+<li><a href="annotations.html#_semantics-11">10.1.5.1. Semantics</a></li>
+<li><a href="annotations.html#_suppress-warnings">10.1.5.2. Suppress Warnings</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="annotations.html#_declaration-of-annotations">10.2. Declaration of Annotations</a></li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_extended-fetaures">11. Extended Fetaures</a>
+<ul class="sectlevel2">
+<li><a href="extended_fetaures.html#_array-and-object-destructuring">11.1. Array and Object Destructuring</a>
+<ul class="sectlevel3">
+<li><a href="extended_fetaures.html#_syntax-14">11.1.1. Syntax</a></li>
+<li><a href="extended_fetaures.html#_semantics-12">11.1.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_dependency-injection">11.2. Dependency Injection</a>
+<ul class="sectlevel3">
+<li><a href="extended_fetaures.html#_di-components-and-injectors">11.2.1. DI Components and Injectors</a>
+<ul class="sectlevel4">
+<li><a href="extended_fetaures.html#_dicomponent-relations">11.2.1.1. DIComponent Relations</a></li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_binders-and-bindings">11.2.2. Binders and Bindings</a></li>
+<li><a href="extended_fetaures.html#_injection-points">11.2.3. Injection Points</a>
+<ul class="sectlevel4">
+<li><a href="extended_fetaures.html#_field-injection">11.2.3.1. Field Injection</a></li>
+<li><a href="extended_fetaures.html#_constructor-injection">11.2.3.2. Constructor Injection</a></li>
+<li><a href="extended_fetaures.html#_method-injection">11.2.3.3. Method Injection</a>
+<ul class="sectlevel5">
+<li><a href="extended_fetaures.html#_provider">11.2.3.3.1. Provider</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_n4js-di-life-cycle-and-scopes">11.2.4. N4JS DI Life Cycle and Scopes</a>
+<ul class="sectlevel4">
+<li><a href="extended_fetaures.html#_injection-cylces">11.2.4.1. Injection Cylces</a></li>
+<li><a href="extended_fetaures.html#_default-scope">11.2.4.2. Default Scope</a></li>
+<li><a href="extended_fetaures.html#_singleton-scope">11.2.4.3. Singleton Scope</a></li>
+<li><a href="extended_fetaures.html#_per-injection-chain-singleton">11.2.4.4. Per Injection Chain Singleton</a></li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_validation-of-callsites-targeting-n4injector-methods">11.2.5. Validation of callsites targeting N4Injector methods</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-annotations">11.2.6. N4JS DI Annotations</a>
+<ul class="sectlevel4">
+<li><a href="extended_fetaures.html#_n4js-di-generateinjector">11.2.6.1. N4JS DI @GenerateInjector</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-withparentinjector">11.2.6.2. N4JS DI @WithParentInjector</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-usebinder">11.2.6.3. N4JS DI @UseBinder</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-binder">11.2.6.4. N4JS DI @Binder</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-bind">11.2.6.5. N4JS DI @Bind</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-provides">11.2.6.6. N4JS DI @Provides</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-inject">11.2.6.7. N4JS DI @Inject</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-singleton">11.2.6.8. N4JS DI @Singleton</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_test-support">11.3. Test Support</a></li>
+<li><a href="extended_fetaures.html#_polyfill-definitions">11.4. Polyfill Definitions</a>
+<ul class="sectlevel3">
+<li><a href="extended_fetaures.html#_runtime-polyfill-definitions">11.4.1. Runtime Polyfill Definitions</a></li>
+<li><a href="extended_fetaures.html#_static-polyfill-definitions">11.4.2. Static Polyfill Definitions</a></li>
+<li><a href="extended_fetaures.html#_transpiling-static-polyfilled-classes">11.4.3. Transpiling static polyfilled classes</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="components.html#_components">12. Components</a>
+<ul class="sectlevel2">
+<li><a href="components.html#_overview-2">12.1. Overview</a></li>
+<li><a href="components.html#Component_Types">12.2. Component Types</a>
+<ul class="sectlevel3">
+<li><a href="components.html#_libraries">12.2.1. Libraries</a></li>
+<li><a href="components.html#_runtime-environment-and-runtime-libraries">12.2.2. Runtime Environment and Runtime Libraries</a></li>
+<li><a href="components.html#_tests">12.2.3. Tests</a></li>
+<li><a href="components.html#_type-definitions">12.2.4. Type Definitions</a></li>
+</ul>
+</li>
+<li><a href="components.html#package-json">12.3. Package.json File</a>
+<ul class="sectlevel3">
+<li><a href="components.html#_basic-properties">12.3.1. Basic Properties</a></li>
+<li><a href="components.html#_n4js-properties">12.3.2. N4JS Properties</a></li>
+<li><a href="components.html#_constraints">12.3.3. Constraints</a></li>
+</ul>
+</li>
+<li><a href="components.html#_support-for-npm-scopes">12.4. Support for NPM Scopes</a></li>
+<li><a href="components.html#sec:N4JS-Type-Definitions">12.5. N4JS Type Definitions</a>
+<ul class="sectlevel3">
+<li><a href="components.html#_specify-type-definition">12.5.1. Specify Type Definition</a></li>
+<li><a href="components.html#_name-conventions">12.5.2. Name Conventions</a></li>
+<li><a href="components.html#_version-conventions">12.5.3. Version Conventions</a>
+<ul class="sectlevel4">
+<li><a href="components.html#_define-a-new-type-definition-package">12.5.3.1. Define a New Type Definition Package</a></li>
+<li><a href="components.html#_using-a-type-definition-package">12.5.3.2. Using a Type Definition Package</a></li>
+<li><a href="components.html#_rational">12.5.3.3. Rational</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="components.html#_modules">12.6. Modules</a></li>
+<li><a href="components.html#_api-and-implementation-component">12.7. API and Implementation Component</a>
+<ul class="sectlevel3">
+<li><a href="components.html#_execution-of-api-and-implementation-components">12.7.1. Execution of API and Implementation Components</a></li>
+<li><a href="components.html#_api-and-implementation-with-di">12.7.2. API and Implementation With DI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#_plainjs">13. PlainJS</a>
+<ul class="sectlevel2">
+<li><a href="#_type-inference-and-validation-for-plain-js">13.1. Type Inference and Validation for Plain JS</a></li>
+<li><a href="#_external-declarations">13.2. External Declarations</a>
+<ul class="sectlevel3">
+<li><a href="#_declaring-externals">13.2.1. Declaring externals</a></li>
+<li><a href="#_instantiating-external-classes">13.2.2. Instantiating external classes</a></li>
+<li><a href="#_implementation-of-external-declarations">13.2.3. Implementation of External Declarations</a></li>
+<li><a href="#_example">13.2.4. Example</a></li>
+</ul>
+</li>
+<li><a href="#_global-definitions">13.3. Global Definitions</a></li>
+<li><a href="#_runtime-definitions">13.4. Runtime Definitions</a></li>
+<li><a href="#_applying-polyfills">13.5. Applying Polyfills</a></li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_jsdoc-2">14. JSDoc</a>
+<ul class="sectlevel2">
+<li><a href="jsdoc.html#_general-n4jsdoc-features">14.1. General N4JSDoc Features</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#_provided-inline-tags">14.1.1. Provided Inline Tags</a>
+<ul class="sectlevel4">
+<li><a href="jsdoc.html#jsdoc_tag__code">14.1.1.1. @code</a></li>
+<li><a href="jsdoc.html#jsdoc_tag__link">14.1.1.2. @link</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_n4jsdoc-for-user-projects">14.2. N4JSdoc for User Projects</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#_standard-tags">14.2.1. Standard Tags</a>
+<ul class="sectlevel4">
+<li><a href="jsdoc.html#_-author">14.2.1.1. @author</a></li>
+<li><a href="jsdoc.html#jsdoc_tag_param">14.2.1.2. @param</a></li>
+<li><a href="jsdoc.html#jsdoc_tag_return">14.2.1.3. @return</a></li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_test-related-tags">14.2.2. Test Related Tags</a>
+<ul class="sectlevel4">
+<li><a href="jsdoc.html#jsdoc_tag__testee">14.2.2.1. @testee</a></li>
+<li><a href="jsdoc.html#jsdoc_tag__testeeFromType">14.2.2.2. @testeeFromType</a></li>
+<li><a href="jsdoc.html#_testeeType_and__testeeMember">14.2.2.3. @testeeType and @testeeMember</a></li>
+<li><a href="jsdoc.html#jsdoc_tag_reqid_in_Tests">14.2.2.4. @reqid in Tests</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_n4jsdoc-for-api-and-implementation-projects">14.3. N4JSDoc for API and Implementation Projects</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#jsdoc_tag__apiNote">14.3.1. @apiNote</a></li>
+<li><a href="jsdoc.html#API_Project_Tags">14.3.2. API Project Tags</a>
+<ul class="sectlevel4">
+<li><a href="jsdoc.html#jsdoc_tag_apiState">14.3.2.1. @apiState</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsx.html#_jsx">15. JSX</a>
+<ul class="sectlevel2">
+<li><a href="jsx.html#_jsx-support">15.1. JSX Support</a></li>
+<li><a href="jsx.html#_jsx-backend">15.2. JSX Backend</a></li>
+</ul>
+</li>
+<li><a href="grammars.html#_grammars">16. Grammars</a>
+<ul class="sectlevel2">
+<li><a href="grammars.html#_type-expressions-grammar">16.1. Type Expressions Grammar</a></li>
+<li><a href="grammars.html#_n4js-language-grammar">16.2. N4JS Language Grammar</a></li>
+</ul>
+</li>
+<li><a href="jsobjects.html#_jsobjects">17. JSObjects</a>
+<ul class="sectlevel2">
+<li><a href="jsobjects.html#_object">17.1. Object</a></li>
+<li><a href="jsobjects.html#_string">17.2. String</a></li>
+<li><a href="jsobjects.html#_boolean">17.3. Boolean</a></li>
+<li><a href="jsobjects.html#_number">17.4. Number</a>
+<ul class="sectlevel3">
+<li><a href="jsobjects.html#_static-attributes">17.4.1. Static Attributes</a></li>
+</ul>
+</li>
+<li><a href="jsobjects.html#function">17.5. Function</a></li>
+<li><a href="jsobjects.html#_error">17.6. Error</a></li>
+<li><a href="jsobjects.html#_array">17.7. Array</a></li>
+<li><a href="jsobjects.html#_date">17.8. Date</a></li>
+<li><a href="jsobjects.html#_math">17.9. Math</a>
+<ul class="sectlevel3">
+<li><a href="jsobjects.html#static-attributes-1">17.9.1. Static Attributes</a></li>
+</ul>
+</li>
+<li><a href="jsobjects.html#_regexp">17.10. RegExp</a></li>
+<li><a href="jsobjects.html#_json">17.11. JSON</a></li>
+</ul>
+</li>
+<li><a href="n4js_objects.html#_n4js-objects">18. N4JS Objects</a>
+<ul class="sectlevel2">
+<li><a href="n4js_objects.html#_reflection-model">18.1. Reflection Model</a></li>
+<li><a href="n4js_objects.html#_error-types">18.2. Error Types</a>
+<ul class="sectlevel3">
+<li><a href="n4js_objects.html#_n4apinotimplemented">18.2.1. N4ApiNotImplemented</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_acronyms.html#_acronyms">Appendix A: Acronyms</a></li>
+<li><a href="appendix_b_license.html#sec:License">Appendix B: License</a></li>
+<li><a href="appendix_c_bibliography.html#_bibliography">Appendix C: Bibliography</a></li>
+</ul>
+</div>
+</div>
+<div id="content"><div class="sect1">
+<h2 id="_plainjs"><a class="anchor" href="#_plainjs"></a><a class="link" href="#_plainjs">13. PlainJS</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>Since N4JS is a super set of JavaScript, is it both possible to use plain JavaScript in N4JS and vice versa.
+There may be some obstacles due to concepts introduced by N4JS to make code more maintainable and robust:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>N4JS’ static type system may complain about some older JavaScript hacks. Declared types, in particular, are assumed to be implicitly frozen.</p>
+</li>
+<li>
+<p>In N4JS, modules are used as namespaces with explicit export and import statements.
+The notion of globals is not directly supported by N4JS as this leads to unexpected side effects (several components providing and thus overriding global definitions, for example).</p>
+</li>
+<li>
+<p>N4JS defines a (ECMAScript 6 compatible) concept of object-oriented programming which may conflict with other plain JavaScript solutions.</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>To overcome these problems, N4JS provides a couple of techniques summarized in this chapter.</p>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="_type-inference-and-validation-for-plain-js"><a class="anchor" href="#_type-inference-and-validation-for-plain-js"></a><a class="link" href="#_type-inference-and-validation-for-plain-js">13.1. Type Inference and Validation for Plain JS</a></h3>
+<div class="paragraph">
+<p>In plain JavaScript mode:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>All declared variables are inferred to <code>any+</code>.</p>
+</li>
+<li>
+<p>All declared functions return and accept a variadic number of arguments of type <code>any+</code>.</p>
+</li>
+<li>
+<p>It is allowed to use the <code>return</code> statement with or without an expression.</p>
+</li>
+<li>
+<p>New expressions with a receiver of <code>any+</code> is allowed.</p>
+</li>
+<li>
+<p>No type arguments are required for generic built-in types.</p>
+</li>
+<li>
+<p>Assigning a value to a read-only variable is not checked.</p>
+</li>
+<li>
+<p>Undeclared variables are treated as <code>any+</code> as well.</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>Note that this essentially disables all validation particularly since methods such as the ’import’-like function <code>require</code> are unknown.</p>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="_external-declarations"><a class="anchor" href="#_external-declarations"></a><a class="link" href="#_external-declarations">13.2. External Declarations</a></h3>
+<div class="paragraph">
+<p>N4JS supports declaring external classes as a means to declare classes whose implementation is not N4JS so they can be used from N4JS.
+Together with structural typing, this allows N4JS to seamlessly integrate frameworks and libraries which have not been implemented in N4JS but in plain ECMAScript or another language.</p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-163"></a><strong>Req. IDE-163:</strong> <a href="#Req-IDE-163">External allowed occurrences</a> (ver. 1)</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Declarations with external flags are only allowed in files with the extension <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>n</mi><mn>4</mn><mi>j</mi><mi>s</mi><mi>d</mi></math> (so called N4JS definition files).</p>
+</li>
+<li>
+<p>Only external classes, external interfaces marked with <code>@N4JS</code>, external enums, external function declarations and structurally typed interfaces are allowed in a <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>n</mi><mn>4</mn><mi>j</mi><mi>s</mi><mi>d</mi></math> file.</p>
+</li>
+<li>
+<p>Declarations with external flags are allowed to subclass built-in type <code>Error</code> type and all of its descendants such as
+<code>EvalError</code>, <code>RangeError</code>, <code>ReferenceError</code>, <code>SyntaxError</code>, <code>TypeError</code> and <code>URIError</code>, although any of the error types are annotated with <code>@N4JS</code>.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>The following explanations apply to all external declarations except
+where stated otherwise.</p>
+</div>
+<div class="paragraph">
+<p>In general, an external declaration uses the same syntax as the declaration of a normal N4JS declaration with the addition of the modifier <code>external</code>.</p>
+</div>
+<div class="paragraph">
+<p>External classifiers are always ’entirely external’ in that it is not possible to combine defined methods and external methods within a single class or interface.</p>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-164"></a><strong>Req. IDE-164:</strong> <a href="#Req-IDE-164">External classes inheritance</a> (ver. 1)</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>An external class <em>without</em> the <code>@N4JS</code> annotation can only inherit from another external class or from one of the built-in ECMAScript types (e.g. Object).
+That is, by default external classes are derived from <code>Object</code>.</p>
+</li>
+<li>
+<p>An external class <em>with</em> the annotation <code>@N4JS</code> can only inherit from another external class annotated with <code>@N4JS</code> or from non-external N4JS classes.</p>
+</li>
+</ol>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-165"></a><strong>Req. IDE-165:</strong> <a href="#Req-IDE-165">Structurally typed interface implementation</a> (ver. 1)</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>An external class <em>without</em> the annotation <code>@N4JS</code> can only be implemented by structurally typed interfaces.</p>
+</li>
+<li>
+<p>An external class <em>with</em> the annotation <code>@N4JS</code> can only be implemented by structurally typed interfaces annotated with <code>@N4JS</code>.</p>
+</li>
+<li>
+<p>An external interface <em>without</em> the annotation <code>@N4JS</code> must be defined structurally.</p>
+</li>
+</ol>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-166"></a><strong>Req. IDE-166:</strong> <a href="#Req-IDE-166">External interface inheritance</a> (ver. 1)</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>An interface in a n4jsd file <em>without</em> the annotation <code>@N4JS</code> can only inherit from another interface within a n4jsd file.</p>
+</li>
+<li>
+<p>An interface <em>with</em> the <code>@N4JS</code> annotation can only inherit from another interface annotated with <code>@N4JS</code>.</p>
+</li>
+</ol>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-167"></a><strong>Req. IDE-167:</strong> <a href="#Req-IDE-167">External class/interface members</a> (ver. 1)</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>The static and instance methods, getters and setters of an external class must not have a method body.</p>
+</li>
+<li>
+<p>The static and instance fields of an external class must not have an initializer.</p>
+</li>
+<li>
+<p>The constructor of an external class without the annotation <code>@N4JS</code> must not be declared private.</p>
+</li>
+<li>
+<p>Methods in interfaces with default implementation which cannot be expressed in the definition file must be annotated with <code>@ProvidesDefaultImplementation</code>.
+This is only allowed in interfaces annotated with <code>@N4JS</code>.</p>
+</li>
+<li>
+<p>Fields in interfaces or classes with initializers which cannot be expressed in the definition file, must be annotated with <code>@ProvidesInitializer</code>.
+This is only allowed in classes or interfaces annotated with <code>@N4JS</code>.</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>This means that in external classes, all members except constructors may be declared private even if the class is not annotated with <code>@N4JS</code>. In interfaces, however, private members are disallowed anyway,
+cf. <a href="classifiers.html#Req-IDE-48">[Req-IDE-48]</a>.</p>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-168"></a><strong>Req. IDE-168:</strong> <a href="#Req-IDE-168">Other external declarations</a> (ver. 1)</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>The literals of an external enum must not have a value.</p>
+</li>
+<li>
+<p>An external function declaration must not have a body.</p>
+</li>
+</ol>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_declaring-externals"><a class="anchor" href="#_declaring-externals"></a><a class="link" href="#_declaring-externals">13.2.1. Declaring externals</a></h4>
+<div class="paragraph">
+<p>By default, the implicit supertype of an external class is Object.
+If the <code>@N4JS</code> annotation is provided it is N4Object.
+If a superclass is explicitly given, the constraints from the previous section apply.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_instantiating-external-classes"><a class="anchor" href="#_instantiating-external-classes"></a><a class="link" href="#_instantiating-external-classes">13.2.2. Instantiating external classes</a></h4>
+<div class="paragraph">
+<p>In most cases, it is desirable to instantiate external classes from external projects.
+Publicly exporting the class definition and providing a public constructor is good practice.</p>
+</div>
+<div class="paragraph">
+<p>In some cases, the instantiation from an outer scope is not wanted.
+A possible approach is to use a structurally typed interface instead of a class to link to the implementation.</p>
+</div>
+<div class="paragraph">
+<p>In case of API-definitions (see <a href="#_api-and-implementation-components">[_api-and-implementation-components]</a>), it might be useful to limit the visibility of classes to narrower scopes such as package or private.</p>
+</div>
+<div class="paragraph">
+<p>External declarations can be instantiated if the following three requirements are fulfilled (not a constraint!):</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>External declarations have to be exported and be marked as public so they are accessible from outside.</p>
+</li>
+<li>
+<p>The contained or inherited constructor of an external class must be public.</p>
+</li>
+<li>
+<p>The external class must be linked to an implementation module (see below <a href="#_implementation-of-external-declarations">Implementation of External Declarations</a>).</p>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_implementation-of-external-declarations"><a class="anchor" href="#_implementation-of-external-declarations"></a><a class="link" href="#_implementation-of-external-declarations">13.2.3. Implementation of External Declarations</a></h4>
+<div class="paragraph">
+<p>All external declarations must be associated with an external implementation module in one way or another.
+Any time the external declaration is imported, the compiler generates code that imports the corresponding implementation module at runtime.</p>
+</div>
+<div class="paragraph">
+<p>There are two possible ways of linking an external declaration to its corresponding implementation:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>By naming convention defined in the <code>package.json</code> file.</p>
+</li>
+<li>
+<p>By declaring that the implementation is provided by the JavaScript runtime, see <a href="#_runtime-definitions">Runtime Definitions</a> for details.</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>The naming convention is based on the <code>external</code> source fragments defined in the <code>package.json</code> file (<a href="components.html#package-json">Package.json File</a>).
+If the implementation is provided by the runtime directly, then this can be also specified in the <code>package.json</code> file by a module filter.</p>
+</div>
+<div class="paragraph">
+<p>The implicit link via the naming convention is used to link an external class declaration to its non-N4JS implementation module.
+It does not effect validation, but only compilation and runtime.
+Essentially, this makes the compiler generate code so that at runtime, the linked implementation module is imported instead of the declaration module.</p>
+</div>
+<div class="paragraph">
+<p>In most use cases of external declarations you also want to disable validation and module wrapping by specifying appropriate filters in the <code>package.json</code> file.</p>
+</div>
+<div class="paragraph">
+<p>Occasionally it is not possible for the validation to correctly detect a corresponding implementation element.
+For that reason, it is possible to disable validation of implementations completely via <code>@@IgnoreImplementation</code>.</p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-169"></a><strong>Req. IDE-169:</strong> <a href="#Req-IDE-169">Implementation of External Declarations</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>For a given external declaration <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>D</mi></math> but not for
+API-definitions <sup class="footnote">[<a id="_footnoteref_60" class="footnote" href="appendix_c_bibliography.html#_footnote_60" title="View footnote.">60</a>]</sup>, the
+following constraints must hold:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>If the declaration is neither provided by runtime nor validation of implementation is disabled,
+a corresponding implementation must be found by the naming convention.
+If no such implementation is found, a warning is generated.</p>
+</li>
+</ol>
+</div>
+</div>
+</div>
+<div id="external-definitions-and-implementations" class="exampleblock">
+<div class="title">Example 104. External Definitions and Their Implementations</div>
+<div class="content">
+<div class="paragraph">
+<p>If, in addition to standard <code>source</code>, the <code>source-external</code> fragment is provided in <code>Sources</code>, <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>n</mi><mn>4</mn><mi>j</mi><mi>s</mi><mi>d</mi></math> files in the folder tree below source folders
+will be related to modules of the same name in the external folders. This is shown in <a href="#fig-external-class-naming">External Class Implementation, Naming Convention</a>.</p>
+</div>
+<div id="fig-external-class-naming" class="imageblock" style="text-align: center">
+<div class="content">
+<img src="chapters/13_plainJS/fig/externalClassImplementation_naming.svg" alt="externalClassImplementation naming">
+</div>
+<div class="title">Figure 16. External Class Implementation, Naming Convention</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_example"><a class="anchor" href="#_example"></a><a class="link" href="#_example">13.2.4. Example</a></h4>
+<div class="paragraph">
+<p>Assume the following non-N4JS module:</p>
+</div>
+<div id="ex:External_Classes_Example" class="exampleblock">
+<div class="title">Example 105. External Classes</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-javascript" data-lang="javascript">module.exports = {
+    "Point": function Point(x, y) {
+        this.x = x;
+        this.y = y;
+    },
+
+    "Circle": function Circle(center, radius) {
+        this.center = center;
+        this.radius = radius;
+        this.scaleX = function(x){ this.x = x; }
+    this.scaleY= function(y){ this.y = y; }
+    }
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Assuming</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>shapes.js</code> is placed in project folder <strong>/external/a/b/shapes.js</strong></p>
+</li>
+<li>
+<p><code>shapes.n4jsd</code> is placed in project folder <strong>/src/a/b/shapes.n4jsd</strong></p>
+</li>
+<li>
+<p><code>package.json</code> defines <strong>src</strong> as source folder and <strong>external</strong> as external source folder</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>the following N4JS external class declarations in <strong>shapes.n4jsd</strong> are sufficient:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-javascript" data-lang="javascript">export external public class Point {
+    x: number; y: number;
+    constructor(x: number, y: number);
+}
+
+export external public class Circle {
+    center: Point; radius: number;
+    constructor(center: Point, radius: number);
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Note that the class and interface names in n4jsd files must match those in the js files, respectively.</p>
+</div>
+</div>
+</div>
+<div class="exampleblock">
+<div class="title">Example 106. Structurally-typed external interfaces</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-javascript" data-lang="javascript">export external public interface ~Scalable {
+    scaleX(factor: number);
+    scaleY(factor: number);
+}
+
+export external public class Circle implements Scalable {
+    center: Point;
+    radius: number; x: number; y: number;
+
+    @Override public scaleX(factor: number);
+    @Override public scaleY(factor: number);
+
+    constructor(center: Point, radius: number);
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="_global-definitions"><a class="anchor" href="#_global-definitions"></a><a class="link" href="#_global-definitions">13.3. Global Definitions</a></h3>
+<div class="paragraph">
+<p>Existing JavaScript libraries and built-in objects provided by certain JavaScript environments often globally define variables.
+Although it is not recommended to use global definitions, this cannot always be avoided.</p>
+</div>
+<div class="paragraph">
+<p>N4JS supports global definitions via the annotation <code>Global</code>.
+This annotation can only be defined on modules (via <code>@@Global</code>) – this means that all declarations in the module are
+globally defined.<sup class="footnote">[<a id="_footnoteref_61" class="footnote" href="appendix_c_bibliography.html#_footnote_61" title="View footnote.">61</a>]</sup></p>
+</div>
+<div class="paragraph">
+<p>We introduce a new pseudo property <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>g</mi><mi>l</mi><mi>o</mi><mi>b</mi><mi>a</mi><mi>l</mi></math> on all declared elements accordingly:</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><code>@Global</code> </dt>
+<dd>
+<p>Boolean flag set to true if annotation <code>@Global</code> is set in containing module. The flag indicates that the exported element is globally available and must not be imported.</p>
+</dd>
+</dl>
+</div>
+<div class="paragraph">
+<p>Since definition of global elements is not supported by N4JS directly, this can be only used in external definitions.
+A declaration with <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>g</mi><mi>l</mi><mi>o</mi><mi>b</mi><mi>a</mi><mi>l</mi></math> can be used without explicit import statement. It is not possible to import these declarations.</p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-170"></a><strong>Req. IDE-170:</strong> <a href="#Req-IDE-170">Global Definitions</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>Global Definitions</p>
+</div>
+<div class="paragraph">
+<p>For a declaration <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>D</mi></math> with <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>D</mi><mo>.</mo><mi>g</mi><mi>l</mi><mi>o</mi><mi>b</mi><mi>a</mi><mi>l</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>true</mtext></mstyle></math>, not a polyfill (<math xmlns="http://www.w3.org/1998/Math/MathML"><mrow><mi>D</mi><mo>.</mo><mi>p</mi><mi>o</mi><mi>l</mi><mi>y</mi><mi>f</mi><mi>i</mi><mi>l</mi><mi>l</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>false</mtext></mstyle><mo>)</mo></mrow></math>, the following constraints must hold:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>The name of the definition must not be equal to any primitive type (<code>string</code>, <code>number</code> etc.), <code>any</code>, or an built-in N4 type (<code>N4Object</code> etc.).</p>
+</li>
+<li>
+<p>If the name of the definition equals a basic runtime time Object Type then the project must be a runtime environment:</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>D</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>∈</mo><mrow><mo>{</mo></mrow></math>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><msup><mspace width="3.0em"/><mi>'</mi></msup><mi>O</mi><mi>b</mi><mi>j</mi><mi>e</mi><mi>c</mi><msup><mi>t</mi><mi>'</mi></msup><msup><mo>,</mo><mi>'</mi></msup><mi>F</mi><mi>u</mi><mi>n</mi><mi>c</mi><mi>t</mi><mi>i</mi><mi>o</mi><msup><mi>n</mi><mi>'</mi></msup><msup><mo>,</mo><mi>'</mi></msup><mi>A</mi><mi>r</mi><mi>r</mi><mi>a</mi><msup><mi>y</mi><mi>'</mi></msup><msup><mo>,</mo><mi>'</mi></msup><mi>S</mi><mi>t</mi><mi>r</mi><mi>i</mi><mi>n</mi><msup><mi>g</mi><mi>'</mi></msup><msup><mo>,</mo><mi>'</mi></msup><mi>B</mi><mi>o</mi><mi>o</mi><mi>l</mi><mi>e</mi><mi>a</mi><msup><mi>n</mi><mi>'</mi></msup></math>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><msup><mspace width="3.0em"/><mi>'</mi></msup><mi>N</mi><mi>u</mi><mi>m</mi><mi>b</mi><mi>e</mi><msup><mi>r</mi><mi>'</mi></msup><msup><mo>,</mo><mi>'</mi></msup><mi>M</mi><mi>a</mi><mi>t</mi><msup><mi>h</mi><mi>'</mi></msup><msup><mo>,</mo><mi>'</mi></msup><mi>D</mi><mi>a</mi><mi>t</mi><msup><mi>e</mi><mi>'</mi></msup><msup><mo>,</mo><mi>'</mi></msup><mi>R</mi><mi>e</mi><mi>g</mi><mi>E</mi><mi>x</mi><msup><mi>p</mi><mi>'</mi></msup><msup><mo>,</mo><mi>'</mi></msup><mi>E</mi><mi>r</mi><mi>r</mi><mi>o</mi><msup><mi>r</mi><mi>'</mi></msup><msup><mo>,</mo><mi>'</mi></msup><mi>J</mi><mi>S</mi><mi>O</mi><msup><mi>N</mi><mi>'</mi></msup></math>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mrow><mo>}</mo></mrow></math>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mo>⇒</mo><mi>D</mi><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>t</mi><mi>a</mi><mi>i</mi><mi>n</mi><mi>i</mi><mi>n</mi><mi>g</mi><mi>P</mi><mi>r</mi><mi>o</mi><mi>j</mi><mi>e</mi><mi>c</mi><mi>t</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>runtimeEnvironment</mtext></mstyle></math></p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="_runtime-definitions"><a class="anchor" href="#_runtime-definitions"></a><a class="link" href="#_runtime-definitions">13.4. Runtime Definitions</a></h3>
+<div class="paragraph">
+<p>Some elements are predefined by the JavaScript runtime such as DOM elements by the browser or built-in ECMAScript or non-standard objects.
+These elements can be defined by means of external definitions; however, no actual implementation can be provided as these elements are actually provided by the runtime itself.</p>
+</div>
+<div class="paragraph">
+<p>Since these cases are rather rare and in order to enable additional checks such as verification that a given runtime actually provides the elements,
+this kind of element can only be defined in components of type runtime environment or runtime library (cf <a href="components.html#_runtime-environment-and-runtime-libraries">Runtime Environment and Runtime Libraries</a>).</p>
+</div>
+<div class="paragraph">
+<p>N4JS supports runtime definitions via the annotation <code>@ProvidedByRuntime</code>.
+This annotation can be defined</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>on modules (via <code>@@ProvidedByRuntime</code>)– this means that all declarations in the module are provided by the runtime</p>
+</li>
+<li>
+<p>on export statements or declarations.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>We introduce a new pseudo property <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>p</mi><mi>r</mi><mi>o</mi><mi>v</mi><mi>i</mi><mi>d</mi><mi>e</mi><mi>d</mi><mi>B</mi><mi>y</mi><mi>R</mi><mi>u</mi><mi>n</mi><mi>t</mi><mi>i</mi><mi>m</mi><mi>e</mi></math> accordingly:</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><code>@ProvidedByRuntime</code> </dt>
+<dd>
+<p>Boolean flag set to true if the annotation <code>@ProvidedByRuntime</code> is set.
+Flag indicates that the element is only declared in the module but its implementation is provided by the runtime.</p>
+</dd>
+</dl>
+</div>
+<div class="paragraph">
+<p>Since built-in types are usually defined globally, the annotation <code>@ProvidedByRuntime</code> is usually used in combination with <code>@Global</code>.</p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-171"></a><strong>Req. IDE-171:</strong> <a href="#Req-IDE-171">Provided By Runtime</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>For a declaration <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>D</mi></math> with <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>D</mi><mo>.</mo><mi>p</mi><mi>r</mi><mi>o</mi><mi>v</mi><mi>i</mi><mi>d</mi><mi>e</mi><mi>d</mi><mi>B</mi><mi>y</mi><mi>R</mi><mi>u</mi><mi>n</mi><mi>t</mi><mi>i</mi><mi>m</mi><mi>e</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>true</mtext></mstyle></math>, the following constraints must hold:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>The declaration must either be an export declaration itself or an exportable declaration.</p>
+</li>
+<li>
+<p>The declaration must be contained in a definition module.</p>
+</li>
+<li>
+<p>The declaration must be (indirectly) contained in a component of type <math xmlns="http://www.w3.org/1998/Math/MathML"><mstyle mathvariant="monospace"><mtext>runtimeEnvironment</mtext></mstyle></math> or <math xmlns="http://www.w3.org/1998/Math/MathML"><mstyle mathvariant="monospace"><mtext>runtimeLibrary</mtext></mstyle></math>.</p>
+</li>
+<li>
+<p>There must be no implementation file with the same name as the definition module if annotation is defined for a whole module.</p>
+</li>
+</ol>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="_applying-polyfills"><a class="anchor" href="#_applying-polyfills"></a><a class="link" href="#_applying-polyfills">13.5. Applying Polyfills</a></h3>
+<div class="paragraph">
+<p>(Runtime) Libraries often do not provide completely new types but modify existing types.
+The ECMA-402 Internationalization Standard [<a href="appendix_c_bibliography.html#ECMA12a">ECMA12a</a>], for example, changes methods of the built-in class <code>Date</code> to be timezone-aware.
+Other scenarios include new functionality provided by browsers which are not part of an official standard yet.
+Even ECMAScript 6 [<a href="appendix_c_bibliography.html#ECMA15a">ECMA15a</a>] extends the predecessor [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a</a>] in terms of new methods or new method parameters added to existing types.
+It also adds completely new classes and features, of course.</p>
+</div>
+<div class="paragraph">
+<p>The syntax of runtime polyfills is described in section <a href="extended_fetaures.html#_polyfill-definitions">Polyfill Definitions</a>.
+Here, an example of applying a runtime polyfill is detailed.</p>
+</div>
+<div class="exampleblock">
+<div class="title">Example 107. Object.observe with Polyfill</div>
+<div class="content">
+<div class="paragraph">
+<p>The following snippet demonstrates how to define a polyfill of the built-in class <code>Object</code> to add the new ECMAScript 7 observer functionality.
+This snippet has to be defined in a runtime library or environment.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">@@ProvidedByRuntime
+@@Global
+
+@Polyfill
+export external public class Object extends Object {
+    public static Object observe(Object object, Function callback, Array&lt;string&gt;? accept);
+
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>A client referring to this runtime library (or environment) can now access the observer methods as if it were defined directly in the original declaration of <code>Object</code>.</p>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div id="footer">
+<div id="footer-text">
+Version 0.9<br>
+Last updated 2019-08-07 15:02:40 CEST
+</div>
+</div>
+<!-- ************* docinfo-footer *************************************************************** -->
+<div class="Grid social" style="color:#d5dfea">
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <h2>Quick Links</h2>
+    <ul>
+      <li><a href="../downloads.html">Download</a></li>
+      <li><a href="../userguides/index.html">Documentation</a></li>
+      <li><a href="https://github.com/eclipse/n4js/">Source</a></li>
+      <li><a href="https://github.com/eclipse/n4js/issues">Issues</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="https://www.eclipse.org/forums/index.php/f/365/">Forum</a></li>
+      <li><a href="http://n4js.blogspot.de/">Blog</a></li>
+      <li><a href="https://dev.eclipse.org/mailman/listinfo/n4js-dev">Mailing List</a></li>
+      <li><a href="https://projects.eclipse.org/projects/technology.n4js">Eclipse Project Page</a></li>
+      <li><a href="https://twitter.com/n4jsdev">Tweets by n4jsdev</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="http://www.eclipse.org/">Eclipse Home</a></li>
+      <li><a href="http://www.eclipse.org/legal/privacy.php">Privacy Policy</a></li>
+      <li><a href="http://www.eclipse.org/legal/termsofuse.php">Terms of Use</a></li>
+      <li><a href="http://www.eclipse.org/legal/copyright.php">Copyright Agent</a></li>
+      <li><a href="http://www.eclipse.org/legal/">Legal</a></li>
+    </ul>
+  </div>
+  <div style="clear: both; height: 0; overflow: hidden;"></div>
+</div>
+
+<!-- ************* UI Scripts ************* -->
+<script type="text/javascript" src="scripts/back-to-top.js"></script>
+
+<script type="text/javascript" src="scripts/treeview.js"></script>
+<script type="text/javascript" src="scripts/toc.js"></script>
+
+<!-- ************* Prism.js Syntax Highlighting ************* -->
+<script src="scripts/prism.js"></script>
+
+<script type="text/javascript">
+	// Add the 'toclist' id for search function
+	$(".toc2 > ul").attr('id', 'toclist');
+	// Generate a Search input form
+	$("#toclist > li:first-of-type").before('<input type="text" id="pagesearch" onkeyup="search()" placeholder="Search for section...">');
+	$("#toclist > li:first-of-type").before('<i id="clear" class="fa fa-times-circle-o"></i>');
+	$("#clear").click(function(){
+	    $("#pagesearch").val('');
+	    search();
+	    $('.toc2 > ul').treeView('collapseAll');
+	});
+	// intialize Treeview.js
+	$(".toc2 > ul").treeView();
+	// Initialize Scrollspy
+</script>
+<!-- ************* docinfo-footer *************************************************************** -->
+</body>
+</html>
\ No newline at end of file
diff --git a/spec/statements.html b/spec/statements.html
new file mode 100644
index 0000000..e1bdf90
--- /dev/null
+++ b/spec/statements.html
@@ -0,0 +1,2095 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="generator" content="Asciidoctor 1.5.5">
+<meta name="author" content="2019-08-07 15:02:40 CEST">
+<title>N4JS Language Specification</title>
+<link rel="stylesheet" href="styles/spec.min.css">
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.6.3/css/font-awesome.min.css">
+<!-- ************* docinfo ******************************************************************* -->
+
+
+<!-- ************* Favicon ************-->
+<link rel="icon" href="images/favicon.ico" />
+
+<!-- ************* Back-to-top JQuery ************* -->
+<script src="https://code.jquery.com/jquery-1.12.4.js"></script>
+<script src="https://code.jquery.com/ui/1.12.0/jquery-ui.js"></script>
+
+
+<link href="styles/prism.min.css" rel="stylesheet" />
+<script type="text/javascript" async
+  src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2/MathJax.js?config=TeX-MML-AM_CHTML">
+</script>
+
+<!-- ************* Styles ************* -->
+<link rel="stylesheet" type="text/css" href="styles/n4jsspec-adoc.css">
+
+
+<!-- ****************** NavBar ****************** -->
+<div id="menubar">
+	<div class="banner">
+        <a href="https://www.eclipse.org/n4js/#"><img id="logo" src="images/n4js-logo.png" alt="Eclipse N4JS"></a>
+    </div>
+<ul>
+  <li><a href="index.html">Index</a></li>
+</ul>
+</div>
+<!-- ************* docinfo ******************************************************************* -->
+<style>
+      .admonitionblock td.icon .icon-todo:before{content:"\f249";color:#f4ee42}
+    </style>
+</head>
+<body class="book toc2 toc-left">
+<div id="header">
+<h1>N4JS Language Specification</h1>
+<div class="details">
+<span id="author" class="author">2019-08-07 15:02:40 CEST</span><br>
+<span id="revnumber">version 0.9</span>
+</div>
+<div id="toc" class="toc2">
+<div id="toctitle">Table of Contents</div>
+<ul class="sectlevel1">
+<li><a href="introduction.html#_introduction">1. Introduction</a>
+<ul class="sectlevel2">
+<li><a href="introduction.html#_notation">1.1. Notation</a>
+<ul class="sectlevel3">
+<li><a href="introduction.html#_grammar-notation">1.1.1. Grammar Notation</a></li>
+<li><a href="introduction.html#_type-judgments-and-rules-and-constraints-notation">1.1.2. Type Judgments and Rules and Constraints Notation</a>
+<ul class="sectlevel4">
+<li><a href="introduction.html#_typing-rules-and-judgments">1.1.2.1. Typing Rules and Judgments</a></li>
+<li><a href="introduction.html#_types-of-an-element">1.1.2.2. Types of an Element</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="introduction.html#_auxiliary-functions">1.2. Auxiliary Functions</a>
+<ul class="sectlevel3">
+<li><a href="introduction.html#_binding">1.2.1. Binding</a></li>
+<li><a href="introduction.html#_merging-types">1.2.2. Merging Types</a>
+<ul class="sectlevel4">
+<li><a href="introduction.html#_logic-formulas">1.2.2.1. Logic Formulas</a></li>
+</ul>
+</li>
+<li><a href="introduction.html#_symbols-and-font-convention">1.2.3. Symbols and Font Convention</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="grammar.html#_grammar">2. Grammar</a>
+<ul class="sectlevel2">
+<li><a href="grammar.html#_lexical-conventions">2.1. Lexical Conventions</a>
+<ul class="sectlevel3">
+<li><a href="grammar.html#_identifier-names-and-identifiers">2.1.1. Identifier Names and Identifiers</a></li>
+<li><a href="grammar.html#_this-keyword">2.1.2. This Keyword</a></li>
+<li><a href="grammar.html#_regular-expression-literals">2.1.3. Regular Expression Literals</a></li>
+<li><a href="grammar.html#_automatic-semicolon-insertion">2.1.4. Automatic Semicolon Insertion</a></li>
+<li><a href="grammar.html#_jsdoc">2.1.5. JSDoc</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="names.html#_names">3. Names</a>
+<ul class="sectlevel2">
+<li><a href="names.html#_access-control">3.1. Access Control</a></li>
+<li><a href="names.html#_accessibility-of-types-top-level-variables-and-function-declarations">3.2. Accessibility of Types, Top-Level Variables and Function Declarations</a>
+<ul class="sectlevel3">
+<li><a href="names.html#_accessibility-of-members">3.2.1. Accessibility of Members</a></li>
+<li><a href="names.html#_valid-names">3.2.2. Valid Names</a></li>
+<li><a href="names.html#_qualified-names">3.2.3. Qualified Names</a></li>
+<li><a href="names.html#_name-duplicates">3.2.4. Name Duplicates</a>
+<ul class="sectlevel4">
+<li><a href="names.html#_lexical-environment">3.2.4.1. Lexical Environment</a></li>
+<li><a href="names.html#_duplicates-and-shadowing">3.2.4.2. Duplicates and Shadowing</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="types.html#_types">4. Types</a>
+<ul class="sectlevel2">
+<li><a href="types.html#_overview">4.1. Overview</a></li>
+<li><a href="types.html#_type-expressions">4.2. Type Expressions</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_syntax">4.2.1. Syntax</a></li>
+<li><a href="types.html#_properties">4.2.2. Properties</a></li>
+<li><a href="types.html#_semantics">4.2.3. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_type-inference">4.3. Type Inference</a></li>
+<li><a href="types.html#_generic-and-parameterized-types">4.4. Generic and Parameterized Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_generic-types">4.4.1. Generic Types</a></li>
+<li><a href="types.html#_type-variables">4.4.2. Type Variables</a></li>
+<li><a href="types.html#_parameterized-types">4.4.3. Parameterized Types</a></li>
+</ul>
+</li>
+<li><a href="types.html#_primitive-ecmascript-types">4.5. Primitive ECMAScript Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_undefined-type">4.5.1. Undefined Type</a></li>
+<li><a href="types.html#_null-type">4.5.2. Null Type</a></li>
+<li><a href="types.html#_primitive-boolean-type">4.5.3. Primitive Boolean Type</a></li>
+<li><a href="types.html#_primitive-string-type">4.5.4. Primitive String Type</a></li>
+<li><a href="types.html#_primitive-number-type">4.5.5. Primitive Number Type</a></li>
+<li><a href="types.html#_primitive-type-int">4.5.6. Primitive Type int</a></li>
+<li><a href="types.html#_primitive-symbol-type">4.5.7. Primitive Symbol Type</a></li>
+</ul>
+</li>
+<li><a href="types.html#_primitive-n4js-types">4.6. Primitive N4JS Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_any-type">4.6.1. Any Type</a>
+<ul class="sectlevel4">
+<li><a href="types.html#any-type-semantics">4.6.1.1. Semantics</a></li>
+<li><a href="types.html#any-type-type-inference">4.6.1.2. Type Inference</a>
+<ul class="sectlevel5">
+<li><a href="types.html#_default-type-of-variables">4.6.1.2.1. Default Type of Variables</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="types.html#_void-type">4.6.2. Void Type</a>
+<ul class="sectlevel4">
+<li><a href="types.html#void-type-semantics">4.6.2.1. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_unknown-type">4.6.3. Unknown Type</a></li>
+<li><a href="types.html#_primitive-pathselector-and-i18nkey">4.6.4. Primitive Pathselector and I18nKey</a>
+<ul class="sectlevel4">
+<li><a href="types.html#pathselector-semantics">4.6.4.1. Semantics</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="types.html#_built-in-ecmascript-object-types">4.7. Built-in ECMAScript Object Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#ECMAScript-objects-semantics">4.7.1. Semantics</a></li>
+<li><a href="types.html#_object-type">4.7.2. Object Type</a></li>
+<li><a href="types.html#_function-object-type">4.7.3. Function-Object-Type</a></li>
+<li><a href="types.html#_array-object-type">4.7.4. Array Object Type</a></li>
+<li><a href="types.html#_string-object-type">4.7.5. String Object Type</a></li>
+<li><a href="types.html#_boolean-object-type">4.7.6. Boolean Object Type</a></li>
+<li><a href="types.html#_number-object-type">4.7.7. Number Object Type</a></li>
+<li><a href="types.html#_global-object-type">4.7.8. Global Object Type</a></li>
+<li><a href="types.html#_symbol">4.7.9. Symbol</a></li>
+<li><a href="types.html#_promise">4.7.10. Promise</a></li>
+<li><a href="types.html#_iterator-interface">4.7.11. Iterator Interface</a></li>
+<li><a href="types.html#_iterable-interface">4.7.12. Iterable Interface</a></li>
+</ul>
+</li>
+<li><a href="types.html#_built-in-n4js-types">4.8. Built-In N4JS Types</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_n4object">4.8.1. N4Object</a>
+<ul class="sectlevel4">
+<li><a href="types.html#N4Object-semantics">4.8.1.1. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_n4class">4.8.2. N4Class</a></li>
+<li><a href="types.html#IterableN">4.8.3. IterableN</a></li>
+</ul>
+</li>
+<li><a href="types.html#_type-modifiers">4.9. Type Modifiers</a>
+<ul class="sectlevel3">
+<li><a href="types.html#Type_Modifiers_Dynamic">4.9.1. Dynamic</a></li>
+<li><a href="types.html#_optional-return-types">4.9.2. Optional Return Types</a></li>
+</ul>
+</li>
+<li><a href="types.html#_union-and-intersection-type-composed-types">4.10. Union and Intersection Type (Composed Types)</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_union-type">4.10.1. Union Type</a>
+<ul class="sectlevel4">
+<li><a href="types.html#union-type-syntax">4.10.1.1. Syntax</a></li>
+<li><a href="types.html#union-type-semantics">4.10.1.2. Semantics</a></li>
+<li><a href="types.html#_warnings">4.10.1.3. Warnings</a></li>
+</ul>
+</li>
+<li><a href="types.html#_intersection-type">4.10.2. Intersection Type</a>
+<ul class="sectlevel4">
+<li><a href="types.html#intersection-type-syntax">4.10.2.1. Syntax</a></li>
+<li><a href="types.html#intersection-type-semantics">4.10.2.2. Semantics</a></li>
+<li><a href="types.html#_warnings-2">4.10.2.3. Warnings</a></li>
+</ul>
+</li>
+<li><a href="types.html#_composed-types-in-wildcards">4.10.3. Composed Types in Wildcards</a></li>
+<li><a href="types.html#_property-access-for-composed-types">4.10.4. Property Access for Composed Types</a>
+<ul class="sectlevel4">
+<li><a href="types.html#_properties-of-union-type">4.10.4.1. Properties of Union Type</a>
+<ul class="sectlevel5">
+<li><a href="types.html#_remarks-on-union-type-s-members">4.10.4.1.1. Remarks on union type’s members:</a></li>
+</ul>
+</li>
+<li><a href="types.html#_properties-of-intersection-type">4.10.4.2. Properties of Intersection Type</a>
+<ul class="sectlevel5">
+<li><a href="types.html#_remarks-on-intersection-type-s-methods">4.10.4.2.1. Remarks on intersection type’s methods:</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="types.html#_constructor-and-classifier-type">4.11. Constructor and Classifier Type</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_syntax-3">4.11.1. Syntax</a></li>
+<li><a href="types.html#_semantics-2">4.11.2. Semantics</a></li>
+<li><a href="types.html#_constructors-and-prototypes-in-ecmascript-2015">4.11.3. Constructors and Prototypes in ECMAScript 2015</a></li>
+</ul>
+</li>
+<li><a href="types.html#_this-type">4.12. This Type</a>
+<ul class="sectlevel3">
+<li><a href="types.html#this-type-syntax">4.12.1. Syntax</a></li>
+<li><a href="types.html#this-keyword-semantics">4.12.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_enums">4.13. Enums</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_enums-n4js">4.13.1. Enums (N4JS)</a>
+<ul class="sectlevel4">
+<li><a href="types.html#enums-syntax">4.13.1.1. Syntax</a></li>
+<li><a href="types.html#enums-semantics">4.13.1.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="types.html#_string-based-enums">4.13.2. String-Based Enums</a></li>
+</ul>
+</li>
+<li><a href="types.html#_short-hand-syntax">4.14. Short-Hand Syntax</a>
+<ul class="sectlevel3">
+<li><a href="types.html#_array-short-hand-syntax">4.14.1. Array Short-Hand Syntax</a></li>
+<li><a href="types.html#_iterablen-short-hand-syntax">4.14.2. IterableN Short-Hand Syntax</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="classifiers.html#_classifiers">5. Classifiers</a>
+<ul class="sectlevel2">
+<li><a href="classifiers.html#_n4js-specific-classifiers">5.1. N4JS Specific Classifiers</a>
+<ul class="sectlevel3">
+<li><a href="classifiers.html#_properties-2">5.1.1. Properties</a></li>
+<li><a href="classifiers.html#_common-semantics-of-classifiers">5.1.2. Common Semantics of Classifiers</a></li>
+<li><a href="classifiers.html#_classes">5.1.3. Classes</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_definition-of-classes">5.1.3.1. Definition of Classes</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#class-syntax">5.1.3.1.1. Syntax</a></li>
+<li><a href="classifiers.html#class-properties">5.1.3.1.2. Properties</a></li>
+<li><a href="classifiers.html#class-type-inference">5.1.3.1.3. Type Inference</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#class-semantics">5.1.3.2. Semantics</a></li>
+<li><a href="classifiers.html#_final-modifier">5.1.3.3. Final Modifier</a></li>
+<li><a href="classifiers.html#_abstract-classes">5.1.3.4. Abstract Classes</a></li>
+<li><a href="classifiers.html#_non-instantiable-classes">5.1.3.5. Non-Instantiable Classes</a></li>
+<li><a href="classifiers.html#_superclass">5.1.3.6. Superclass</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_interfaces">5.1.4. Interfaces</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_definition-of-interfaces">5.1.4.1. Definition of Interfaces</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#interfaces-syntax">5.1.4.1.1. Syntax</a></li>
+<li><a href="classifiers.html#interfaces-properties">5.1.4.1.2. Properties</a></li>
+<li><a href="classifiers.html#interfaces-type-inference">5.1.4.1.3. Type Inference</a></li>
+<li><a href="classifiers.html#interfaces-semantics">5.1.4.1.4. Semantics</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="classifiers.html#_generic-classifiers">5.1.5. Generic Classifiers</a></li>
+<li><a href="classifiers.html#sec:definition-site-variance">5.1.6. Definition-Site Variance</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_members">5.2. Members</a>
+<ul class="sectlevel3">
+<li><a href="classifiers.html#_syntax-4">5.2.1. Syntax</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_properties-3">5.2.1.1. Properties</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_semantics-3">5.2.2. Semantics</a></li>
+<li><a href="classifiers.html#_methods">5.2.3. Methods</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_syntax-5">5.2.3.1. Syntax</a></li>
+<li><a href="classifiers.html#_properties-4">5.2.3.2. Properties</a></li>
+<li><a href="classifiers.html#_semantics-4">5.2.3.3. Semantics</a></li>
+<li><a href="classifiers.html#_final-methods">5.2.3.4. Final Methods</a></li>
+<li><a href="classifiers.html#_abstract-methods">5.2.3.5. Abstract Methods</a></li>
+<li><a href="classifiers.html#_generic-methods">5.2.3.6. Generic Methods</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_default-methods-in-interfaces">5.2.4. Default Methods in Interfaces</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_asynchronous-methods">5.2.4.1. Asynchronous Methods</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_constructors">5.2.5. Constructors</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_structural-this-type-in-constructor">5.2.5.1. Structural This Type in Constructor</a></li>
+<li><a href="classifiers.html#spec-constructor">5.2.5.2. @Spec Constructor</a></li>
+<li><a href="classifiers.html#_callable-constructors">5.2.5.3. Callable Constructors</a></li>
+<li><a href="classifiers.html#_covariant-constructors">5.2.5.4. Covariant Constructors</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_data-fields">5.2.6. Data Fields</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#data-fields-syntax">5.2.6.1. Syntax</a></li>
+<li><a href="classifiers.html#data-fields-properties">5.2.6.2. Properties</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#data-fields-semantics">5.2.6.2.1. Semantics</a></li>
+<li><a href="classifiers.html#data-fields-type-inference">5.2.6.2.2. Type Inference</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_assignment-modifiers">5.2.6.3. Assignment Modifiers</a></li>
+<li><a href="classifiers.html#_field-accessors-getter-setter">5.2.6.4. Field Accessors (Getter/Setter)</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#field-acessors-syntax">5.2.6.4.1. Syntax</a></li>
+<li><a href="classifiers.html#field-acessors-properties">5.2.6.4.2. Properties</a></li>
+<li><a href="classifiers.html#field-accessors-semantics">5.2.6.4.3. Semantics</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#optional-fields">5.2.6.5. Optional Fields</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#_syntax-6">5.2.6.5.1. Syntax</a></li>
+<li><a href="classifiers.html#_semantics-5">5.2.6.5.2. Semantics</a></li>
+<li><a href="classifiers.html#_background">5.2.6.5.3. Background</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="classifiers.html#_static-members">5.2.7. Static Members</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_access-from-and-to-static-members">5.2.7.1. Access From and To Static Members</a></li>
+<li><a href="classifiers.html#_generic-static-methods">5.2.7.2. Generic static methods</a></li>
+<li><a href="classifiers.html#_static-members-of-interfaces">5.2.7.3. Static Members of Interfaces</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_redefinition-of-members">5.2.8. Redefinition of Members</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_overriding-of-members">5.2.8.1. Overriding of Members</a></li>
+<li><a href="classifiers.html#_implementation-of-members">5.2.8.2. Implementation of Members</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#_member-consumption">5.2.8.2.1. Member Consumption</a></li>
+<li><a href="classifiers.html#_member-implementation">5.2.8.2.2. Member Implementation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="classifiers.html#_structural-typing">5.3. Structural Typing</a>
+<ul class="sectlevel3">
+<li><a href="classifiers.html#_syntax-7">5.3.1. Syntax</a></li>
+<li><a href="classifiers.html#_definition-site-structural-typing">5.3.2. Definition Site Structural Typing</a></li>
+<li><a href="classifiers.html#_use-site-structural-typing">5.3.3. Use-Site Structural Typing</a></li>
+<li><a href="classifiers.html#structural-readWriteInit-field-typing">5.3.4. Structural Read-only, Write-only and Initializer Field Typing</a></li>
+<li><a href="classifiers.html#_public-setter-annotated-with-code-providesinitializer-code">5.3.5. Public Setter Annotated With <code>ProvidesInitializer</code></a></li>
+<li><a href="classifiers.html#_structural-types-with-optional-fields">5.3.6. Structural Types With Optional Fields</a></li>
+<li><a href="classifiers.html#_structural-types-with-access-modifier">5.3.7. Structural Types With Access Modifier</a></li>
+<li><a href="classifiers.html#_structural-types-with-additional-members">5.3.8. Structural Types With Additional Members</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_syntax-8">5.3.8.1. Syntax</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#_semantics-6">5.3.8.1.1. Semantics</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="functions.html#_functions">6. Functions</a>
+<ul class="sectlevel2">
+<li><a href="functions.html#_function-type">6.1. Function Type</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_properties-5">6.1.1. Properties</a></li>
+<li><a href="functions.html#function-type-inference">6.1.2. Type Inference</a></li>
+<li><a href="functions.html#_autoboxing-of-function-type">6.1.3. Autoboxing of Function Type</a></li>
+<li><a href="functions.html#_arguments-object">6.1.4. Arguments Object</a></li>
+</ul>
+</li>
+<li><a href="functions.html#_ecmascript-5-function-definition">6.2. ECMAScript 5 Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_function-declaration">6.2.1. Function Declaration</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#_syntax-9">6.2.1.1. Syntax</a></li>
+<li><a href="functions.html#_semantics-8">6.2.1.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="functions.html#_function-expression">6.2.2. Function Expression</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#function-expression-syntax">6.2.2.1. Syntax</a></li>
+<li><a href="functions.html#_semantics-and-type-inference">6.2.2.2. Semantics and Type Inference</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="functions.html#_ecmascript-2015-function-definition">6.3. ECMAScript 2015 Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_formal-parameters">6.3.1. Formal Parameters</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#Type_Modifiers_Optional">6.3.1.1. Optional Parameters</a></li>
+<li><a href="functions.html#Type_Modifiers_Default">6.3.1.2. Default Parameters</a></li>
+<li><a href="functions.html#Type_Modifiers_Variadic">6.3.1.3. Variadic</a></li>
+</ul>
+</li>
+<li><a href="functions.html#_generator-functions">6.3.2. Generator Functions</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#generator-functions-syntax">6.3.2.1. Syntax</a></li>
+<li><a href="functions.html#generator-functions-semantics">6.3.2.2. Semantics</a></li>
+<li><a href="functions.html#_generator-arrow-functions">6.3.2.3. Generator Arrow Functions</a></li>
+</ul>
+</li>
+<li><a href="functions.html#_arrow-function-expression">6.3.3. Arrow Function Expression</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#arrow-function-expression-syntax">6.3.3.1. Syntax</a></li>
+<li><a href="functions.html#arrow-function-expression-semantics-and-type-inference">6.3.3.2. Semantics and Type Inference</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="functions.html#_ecmascript-proposals-function-definition">6.4. ECMAScript Proposals Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_asynchronous-functions">6.4.1. Asynchronous Functions</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#asynchronous-functions-syntax">6.4.1.1. Syntax</a></li>
+<li><a href="functions.html#asynchronous-functions-semantics">6.4.1.2. Semantics</a></li>
+<li><a href="functions.html#_asynchronous-arrow-functions">6.4.1.3. Asynchronous Arrow Functions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="functions.html#_n4js-extended-function-definition">6.5. N4JS Extended Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_generic-functions">6.5.1. Generic Functions</a></li>
+<li><a href="functions.html#_promisifiable-functions">6.5.2. Promisifiable Functions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_conversions-and-reflection">7. Conversions and Reflection</a>
+<ul class="sectlevel2">
+<li><a href="conversions_and_reflection.html#_autoboxing-and-coercing">7.1. Autoboxing and Coercing</a>
+<ul class="sectlevel3">
+<li><a href="conversions_and_reflection.html#_coercing">7.1.1. Coercing</a></li>
+<li><a href="conversions_and_reflection.html#_autoboxing-of-primitives">7.1.2. Autoboxing of Primitives</a></li>
+<li><a href="conversions_and_reflection.html#_autoboxing-of-function-expressions-and-declarations">7.1.3. Autoboxing of Function Expressions and Declarations</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_auto-conversion-of-objects">7.2. Auto-Conversion of Objects</a>
+<ul class="sectlevel3">
+<li><a href="conversions_and_reflection.html#_auto-conversion-of-class-instances">7.2.1. Auto-Conversion of Class Instances</a>
+<ul class="sectlevel4">
+<li><a href="conversions_and_reflection.html#_auto-conversion-of-interface-instances">7.2.1.1. Auto-Conversion of Interface Instances</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_auto-conversion-of-enum-literals">7.2.2. Auto-Conversion of Enum Literals</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_type-cast-and-type-check">7.3. Type Cast and Type Check</a>
+<ul class="sectlevel3">
+<li><a href="conversions_and_reflection.html#_type-cast">7.3.1. Type Cast</a></li>
+<li><a href="conversions_and_reflection.html#_type-check">7.3.2. Type Check</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_reflection-meta-information">7.4. Reflection meta-information</a>
+<ul class="sectlevel3">
+<li><a href="conversions_and_reflection.html#_reflection-for-classes">7.4.1. Reflection for Classes</a></li>
+<li><a href="conversions_and_reflection.html#_reflection-for-interfaces">7.4.2. Reflection for Interfaces</a></li>
+<li><a href="conversions_and_reflection.html#_reflection-for-enumerations">7.4.3. Reflection for Enumerations</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_conversion-of-primitive-types">7.5. Conversion of primitive types</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_expressions">8. Expressions</a>
+<ul class="sectlevel2">
+<li><a href="expressions.html#_ecmascript-5-expressions">8.1. ECMAScript 5 Expressions</a>
+<ul class="sectlevel3">
+<li><a href="expressions.html#_the-this-literal">8.1.1. The this Literal</a></li>
+<li><a href="expressions.html#_identifier">8.1.2. Identifier</a></li>
+<li><a href="expressions.html#_literals">8.1.3. Literals</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#_integer-literals">8.1.3.1. Integer Literals</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_array-literal">8.1.4. Array Literal</a></li>
+<li><a href="expressions.html#_object-literal">8.1.5. Object Literal</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#_properties-6">8.1.5.1. Properties</a></li>
+<li><a href="expressions.html#_scoping-and-linking">8.1.5.2. Scoping and linking</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_parenthesized-expression-and-grouping-operator">8.1.6. Parenthesized Expression and Grouping Operator</a></li>
+<li><a href="expressions.html#_property-accessors">8.1.7. Property Accessors</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#properties-1">8.1.7.1. Properties</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_new-expression">8.1.8. New Expression</a></li>
+<li><a href="expressions.html#_function-expression-2">8.1.9. Function Expression</a></li>
+<li><a href="expressions.html#_function-calls">8.1.10. Function Calls</a></li>
+<li><a href="expressions.html#_postfix-expression">8.1.11. Postfix Expression</a></li>
+<li><a href="expressions.html#_unary-expression">8.1.12. Unary Expression</a></li>
+<li><a href="expressions.html#_multiplicative-expression">8.1.13. Multiplicative Expression</a></li>
+<li><a href="expressions.html#_additive-expression">8.1.14. Additive Expression</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#type-inference-10">8.1.14.1. Type Inference</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_bitwise-shift-expression">8.1.15. Bitwise Shift Expression</a></li>
+<li><a href="expressions.html#_relational-expression">8.1.16. Relational Expression</a></li>
+<li><a href="expressions.html#_equality-expression">8.1.17. Equality Expression</a></li>
+<li><a href="expressions.html#_binary-bitwise-expression">8.1.18. Binary Bitwise Expression</a></li>
+<li><a href="expressions.html#_binary-logical-expression">8.1.19. Binary Logical Expression</a></li>
+<li><a href="expressions.html#_conditional-expression">8.1.20. Conditional Expression</a></li>
+<li><a href="expressions.html#_assignment-expression">8.1.21. Assignment Expression</a></li>
+<li><a href="expressions.html#_comma-expression">8.1.22. Comma Expression</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_ecmascript-6-expressions">8.2. ECMAScript 6 Expressions</a>
+<ul class="sectlevel3">
+<li><a href="expressions.html#_the-super-keyword">8.2.1. The super Keyword</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_ecmascript-7-expressions">8.3. ECMAScript 7 Expressions</a>
+<ul class="sectlevel3">
+<li><a href="expressions.html#_await-expression">8.3.1. Await Expression</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_n4js-specific-expressions">8.4. N4JS Specific Expressions</a>
+<ul class="sectlevel3">
+<li><a href="expressions.html#_class-expression">8.4.1. Class Expression</a></li>
+<li><a href="expressions.html#_cast-as-expression">8.4.2. Cast (As) Expression</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#cast-as-expression-semantics-type-inference">8.4.2.1. Semantics and Type Inference</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#Import_Calls">8.4.3. Import Calls</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#compile-time-expressions">8.5. Compile-Time Expressions</a></li>
+</ul>
+</li>
+<li><a href="#_statements">9. Statements</a>
+<ul class="sectlevel2">
+<li><a href="#_ecmascript-5-statements">9.1. ECMAScript 5 Statements</a>
+<ul class="sectlevel3">
+<li><a href="#_function-or-field-accessor-bodies">9.1.1. Function or Field Accessor Bodies</a></li>
+<li><a href="#_variable-statement">9.1.2. Variable Statement</a></li>
+<li><a href="#_if-statement">9.1.3. If Statement</a></li>
+<li><a href="#_iteration-statements">9.1.4. Iteration Statements</a></li>
+<li><a href="#_return-statement">9.1.5. Return Statement</a></li>
+<li><a href="#_with-statement">9.1.6. With Statement</a></li>
+<li><a href="#_switch-statement">9.1.7. Switch Statement</a></li>
+<li><a href="#_throw-try-and-catch-statements">9.1.8. Throw, Try, and Catch Statements</a></li>
+<li><a href="#_debugger-statement">9.1.9. Debugger Statement</a></li>
+</ul>
+</li>
+<li><a href="#_ecmascript-6-statements">9.2. ECMAScript 6 Statements</a>
+<ul class="sectlevel3">
+<li><a href="#_let">9.2.1. Let</a></li>
+<li><a href="#_const">9.2.2. Const</a></li>
+<li><a href="#_for-of-statement">9.2.3. <code>for &#8230;&#8203; of</code> statement</a></li>
+<li><a href="#_import-statement">9.2.4. Import Statement</a>
+<ul class="sectlevel4">
+<li><a href="#Dynamic_Imports">9.2.4.1. Dynamic Imports</a></li>
+<li><a href="#_immutabilaty-of-imports">9.2.4.2. Immutabilaty of Imports</a></li>
+</ul>
+</li>
+<li><a href="#_export-statement">9.2.5. Export Statement</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="annotations.html#_annotations">10. Annotations</a>
+<ul class="sectlevel2">
+<li><a href="annotations.html#_introduction-2">10.1. Introduction</a>
+<ul class="sectlevel3">
+<li><a href="annotations.html#_syntax-13">10.1.1. Syntax</a></li>
+<li><a href="annotations.html#_properties-7">10.1.2. Properties</a></li>
+<li><a href="annotations.html#_element-specific-annotations">10.1.3. Element-Specific Annotations</a></li>
+<li><a href="annotations.html#_general-annotations">10.1.4. General Annotations</a>
+<ul class="sectlevel4">
+<li><a href="annotations.html#_idebug">10.1.4.1. IDEBUG</a></li>
+</ul>
+</li>
+<li><a href="annotations.html#idebug-syntax">10.1.5. Syntax</a>
+<ul class="sectlevel4">
+<li><a href="annotations.html#_semantics-11">10.1.5.1. Semantics</a></li>
+<li><a href="annotations.html#_suppress-warnings">10.1.5.2. Suppress Warnings</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="annotations.html#_declaration-of-annotations">10.2. Declaration of Annotations</a></li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_extended-fetaures">11. Extended Fetaures</a>
+<ul class="sectlevel2">
+<li><a href="extended_fetaures.html#_array-and-object-destructuring">11.1. Array and Object Destructuring</a>
+<ul class="sectlevel3">
+<li><a href="extended_fetaures.html#_syntax-14">11.1.1. Syntax</a></li>
+<li><a href="extended_fetaures.html#_semantics-12">11.1.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_dependency-injection">11.2. Dependency Injection</a>
+<ul class="sectlevel3">
+<li><a href="extended_fetaures.html#_di-components-and-injectors">11.2.1. DI Components and Injectors</a>
+<ul class="sectlevel4">
+<li><a href="extended_fetaures.html#_dicomponent-relations">11.2.1.1. DIComponent Relations</a></li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_binders-and-bindings">11.2.2. Binders and Bindings</a></li>
+<li><a href="extended_fetaures.html#_injection-points">11.2.3. Injection Points</a>
+<ul class="sectlevel4">
+<li><a href="extended_fetaures.html#_field-injection">11.2.3.1. Field Injection</a></li>
+<li><a href="extended_fetaures.html#_constructor-injection">11.2.3.2. Constructor Injection</a></li>
+<li><a href="extended_fetaures.html#_method-injection">11.2.3.3. Method Injection</a>
+<ul class="sectlevel5">
+<li><a href="extended_fetaures.html#_provider">11.2.3.3.1. Provider</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_n4js-di-life-cycle-and-scopes">11.2.4. N4JS DI Life Cycle and Scopes</a>
+<ul class="sectlevel4">
+<li><a href="extended_fetaures.html#_injection-cylces">11.2.4.1. Injection Cylces</a></li>
+<li><a href="extended_fetaures.html#_default-scope">11.2.4.2. Default Scope</a></li>
+<li><a href="extended_fetaures.html#_singleton-scope">11.2.4.3. Singleton Scope</a></li>
+<li><a href="extended_fetaures.html#_per-injection-chain-singleton">11.2.4.4. Per Injection Chain Singleton</a></li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_validation-of-callsites-targeting-n4injector-methods">11.2.5. Validation of callsites targeting N4Injector methods</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-annotations">11.2.6. N4JS DI Annotations</a>
+<ul class="sectlevel4">
+<li><a href="extended_fetaures.html#_n4js-di-generateinjector">11.2.6.1. N4JS DI @GenerateInjector</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-withparentinjector">11.2.6.2. N4JS DI @WithParentInjector</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-usebinder">11.2.6.3. N4JS DI @UseBinder</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-binder">11.2.6.4. N4JS DI @Binder</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-bind">11.2.6.5. N4JS DI @Bind</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-provides">11.2.6.6. N4JS DI @Provides</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-inject">11.2.6.7. N4JS DI @Inject</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-singleton">11.2.6.8. N4JS DI @Singleton</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_test-support">11.3. Test Support</a></li>
+<li><a href="extended_fetaures.html#_polyfill-definitions">11.4. Polyfill Definitions</a>
+<ul class="sectlevel3">
+<li><a href="extended_fetaures.html#_runtime-polyfill-definitions">11.4.1. Runtime Polyfill Definitions</a></li>
+<li><a href="extended_fetaures.html#_static-polyfill-definitions">11.4.2. Static Polyfill Definitions</a></li>
+<li><a href="extended_fetaures.html#_transpiling-static-polyfilled-classes">11.4.3. Transpiling static polyfilled classes</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="components.html#_components">12. Components</a>
+<ul class="sectlevel2">
+<li><a href="components.html#_overview-2">12.1. Overview</a></li>
+<li><a href="components.html#Component_Types">12.2. Component Types</a>
+<ul class="sectlevel3">
+<li><a href="components.html#_libraries">12.2.1. Libraries</a></li>
+<li><a href="components.html#_runtime-environment-and-runtime-libraries">12.2.2. Runtime Environment and Runtime Libraries</a></li>
+<li><a href="components.html#_tests">12.2.3. Tests</a></li>
+<li><a href="components.html#_type-definitions">12.2.4. Type Definitions</a></li>
+</ul>
+</li>
+<li><a href="components.html#package-json">12.3. Package.json File</a>
+<ul class="sectlevel3">
+<li><a href="components.html#_basic-properties">12.3.1. Basic Properties</a></li>
+<li><a href="components.html#_n4js-properties">12.3.2. N4JS Properties</a></li>
+<li><a href="components.html#_constraints">12.3.3. Constraints</a></li>
+</ul>
+</li>
+<li><a href="components.html#_support-for-npm-scopes">12.4. Support for NPM Scopes</a></li>
+<li><a href="components.html#sec:N4JS-Type-Definitions">12.5. N4JS Type Definitions</a>
+<ul class="sectlevel3">
+<li><a href="components.html#_specify-type-definition">12.5.1. Specify Type Definition</a></li>
+<li><a href="components.html#_name-conventions">12.5.2. Name Conventions</a></li>
+<li><a href="components.html#_version-conventions">12.5.3. Version Conventions</a>
+<ul class="sectlevel4">
+<li><a href="components.html#_define-a-new-type-definition-package">12.5.3.1. Define a New Type Definition Package</a></li>
+<li><a href="components.html#_using-a-type-definition-package">12.5.3.2. Using a Type Definition Package</a></li>
+<li><a href="components.html#_rational">12.5.3.3. Rational</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="components.html#_modules">12.6. Modules</a></li>
+<li><a href="components.html#_api-and-implementation-component">12.7. API and Implementation Component</a>
+<ul class="sectlevel3">
+<li><a href="components.html#_execution-of-api-and-implementation-components">12.7.1. Execution of API and Implementation Components</a></li>
+<li><a href="components.html#_api-and-implementation-with-di">12.7.2. API and Implementation With DI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="plainjs.html#_plainjs">13. PlainJS</a>
+<ul class="sectlevel2">
+<li><a href="plainjs.html#_type-inference-and-validation-for-plain-js">13.1. Type Inference and Validation for Plain JS</a></li>
+<li><a href="plainjs.html#_external-declarations">13.2. External Declarations</a>
+<ul class="sectlevel3">
+<li><a href="plainjs.html#_declaring-externals">13.2.1. Declaring externals</a></li>
+<li><a href="plainjs.html#_instantiating-external-classes">13.2.2. Instantiating external classes</a></li>
+<li><a href="plainjs.html#_implementation-of-external-declarations">13.2.3. Implementation of External Declarations</a></li>
+<li><a href="plainjs.html#_example">13.2.4. Example</a></li>
+</ul>
+</li>
+<li><a href="plainjs.html#_global-definitions">13.3. Global Definitions</a></li>
+<li><a href="plainjs.html#_runtime-definitions">13.4. Runtime Definitions</a></li>
+<li><a href="plainjs.html#_applying-polyfills">13.5. Applying Polyfills</a></li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_jsdoc-2">14. JSDoc</a>
+<ul class="sectlevel2">
+<li><a href="jsdoc.html#_general-n4jsdoc-features">14.1. General N4JSDoc Features</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#_provided-inline-tags">14.1.1. Provided Inline Tags</a>
+<ul class="sectlevel4">
+<li><a href="jsdoc.html#jsdoc_tag__code">14.1.1.1. @code</a></li>
+<li><a href="jsdoc.html#jsdoc_tag__link">14.1.1.2. @link</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_n4jsdoc-for-user-projects">14.2. N4JSdoc for User Projects</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#_standard-tags">14.2.1. Standard Tags</a>
+<ul class="sectlevel4">
+<li><a href="jsdoc.html#_-author">14.2.1.1. @author</a></li>
+<li><a href="jsdoc.html#jsdoc_tag_param">14.2.1.2. @param</a></li>
+<li><a href="jsdoc.html#jsdoc_tag_return">14.2.1.3. @return</a></li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_test-related-tags">14.2.2. Test Related Tags</a>
+<ul class="sectlevel4">
+<li><a href="jsdoc.html#jsdoc_tag__testee">14.2.2.1. @testee</a></li>
+<li><a href="jsdoc.html#jsdoc_tag__testeeFromType">14.2.2.2. @testeeFromType</a></li>
+<li><a href="jsdoc.html#_testeeType_and__testeeMember">14.2.2.3. @testeeType and @testeeMember</a></li>
+<li><a href="jsdoc.html#jsdoc_tag_reqid_in_Tests">14.2.2.4. @reqid in Tests</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_n4jsdoc-for-api-and-implementation-projects">14.3. N4JSDoc for API and Implementation Projects</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#jsdoc_tag__apiNote">14.3.1. @apiNote</a></li>
+<li><a href="jsdoc.html#API_Project_Tags">14.3.2. API Project Tags</a>
+<ul class="sectlevel4">
+<li><a href="jsdoc.html#jsdoc_tag_apiState">14.3.2.1. @apiState</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsx.html#_jsx">15. JSX</a>
+<ul class="sectlevel2">
+<li><a href="jsx.html#_jsx-support">15.1. JSX Support</a></li>
+<li><a href="jsx.html#_jsx-backend">15.2. JSX Backend</a></li>
+</ul>
+</li>
+<li><a href="grammars.html#_grammars">16. Grammars</a>
+<ul class="sectlevel2">
+<li><a href="grammars.html#_type-expressions-grammar">16.1. Type Expressions Grammar</a></li>
+<li><a href="grammars.html#_n4js-language-grammar">16.2. N4JS Language Grammar</a></li>
+</ul>
+</li>
+<li><a href="jsobjects.html#_jsobjects">17. JSObjects</a>
+<ul class="sectlevel2">
+<li><a href="jsobjects.html#_object">17.1. Object</a></li>
+<li><a href="jsobjects.html#_string">17.2. String</a></li>
+<li><a href="jsobjects.html#_boolean">17.3. Boolean</a></li>
+<li><a href="jsobjects.html#_number">17.4. Number</a>
+<ul class="sectlevel3">
+<li><a href="jsobjects.html#_static-attributes">17.4.1. Static Attributes</a></li>
+</ul>
+</li>
+<li><a href="jsobjects.html#function">17.5. Function</a></li>
+<li><a href="jsobjects.html#_error">17.6. Error</a></li>
+<li><a href="jsobjects.html#_array">17.7. Array</a></li>
+<li><a href="jsobjects.html#_date">17.8. Date</a></li>
+<li><a href="jsobjects.html#_math">17.9. Math</a>
+<ul class="sectlevel3">
+<li><a href="jsobjects.html#static-attributes-1">17.9.1. Static Attributes</a></li>
+</ul>
+</li>
+<li><a href="jsobjects.html#_regexp">17.10. RegExp</a></li>
+<li><a href="jsobjects.html#_json">17.11. JSON</a></li>
+</ul>
+</li>
+<li><a href="n4js_objects.html#_n4js-objects">18. N4JS Objects</a>
+<ul class="sectlevel2">
+<li><a href="n4js_objects.html#_reflection-model">18.1. Reflection Model</a></li>
+<li><a href="n4js_objects.html#_error-types">18.2. Error Types</a>
+<ul class="sectlevel3">
+<li><a href="n4js_objects.html#_n4apinotimplemented">18.2.1. N4ApiNotImplemented</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_acronyms.html#_acronyms">Appendix A: Acronyms</a></li>
+<li><a href="appendix_b_license.html#sec:License">Appendix B: License</a></li>
+<li><a href="appendix_c_bibliography.html#_bibliography">Appendix C: Bibliography</a></li>
+</ul>
+</div>
+</div>
+<div id="content"><div class="sect1">
+<h2 id="_statements"><a class="anchor" href="#_statements"></a><a class="link" href="#_statements">9. Statements</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>For all statements, we define the following pseudo properties:</p>
+</div>
+<div class="openblock language-n4js">
+<div class="content">
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><code>containingFunction</code> </dt>
+<dd>
+<p>The function or method in which the statement is (indirectly) contained, this may be null.</p>
+</dd>
+<dt class="hdlist1"><code>containingClass</code> </dt>
+<dd>
+<p>The class in which the statement is (indirectly) contained, this may be null.</p>
+</dd>
+</dl>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>The expressions and statements are ordered, at first describing the constructs available in the 5th edition of ECMA-262
+referred to as  [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a</a>] in the following.
+The grammar snippets already use newer constructs in some cases.</p>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="_ecmascript-5-statements"><a class="anchor" href="#_ecmascript-5-statements"></a><a class="link" href="#_ecmascript-5-statements">9.1. ECMAScript 5 Statements</a></h3>
+<div class="paragraph">
+<p>N4JS supports the same statements as
+ECMAScript. Some of these statements are enhanced with annotations <a href="annotations.html#_annotations">Annotations</a> and type information.</p>
+</div>
+<div class="paragraph">
+<p>Although some statements may return a value which can be used via certain constructs such as <code>eval</code>), no type is inferred for any statement.
+The compiler will always create a warning if a statement is used instead of an expression.</p>
+</div>
+<div class="paragraph">
+<p>The following sections, therefore, do not define how to infer types for statement but how types and type annotations
+are used in these statements and the specific type constraints for a given statement.</p>
+</div>
+<div class="paragraph">
+<p>All syntax definitions taken from  [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a</a>]  are repeated here for convenience reasons and in order to define temporary variables for simplifying constraint definitions.
+If non-terminals are not defined here, the definition specified in  [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a</a>]   is to be used.</p>
+</div>
+<div class="sect3">
+<h4 id="_function-or-field-accessor-bodies"><a class="anchor" href="#_function-or-field-accessor-bodies"></a><a class="link" href="#_function-or-field-accessor-bodies">9.1.1. Function or Field Accessor Bodies</a></h4>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-126"></a><strong>Req. IDE-126:</strong> <a href="#Req-IDE-126">Dead Code</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>For all statements in a function or field accessor (getter/setter) body, the following constraints must hold:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Statements appearing directly after return, throw, break, or continue statements (in the same block) are considered to be dead code and a warning is issued in these cases.</p>
+</li>
+</ol>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_variable-statement"><a class="anchor" href="#_variable-statement"></a><a class="link" href="#_variable-statement">9.1.2. Variable Statement</a></h4>
+<h5 id="variable-statement-syntax" class="discrete">Syntax</h5>
+<div class="paragraph">
+<p>A var statement can declare the type of the variable with a type
+reference. This is described with the following grammar similar to
+[<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.S12.2, p.p.87)</a>]:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">VariableStatement &lt;In, Yield&gt;:
+    =&gt;({VariableStatement}
+        'var'
+    )
+    varDeclsOrBindings+=VariableDeclarationOrBinding&lt;In,Yield,false&gt; (',' varDeclsOrBindings+=VariableDeclarationOrBinding&lt;In,Yield,false&gt;)* Semi
+;
+
+VariableDeclarationOrBinding &lt;In, Yield, OptionalInit&gt;:
+        VariableBinding&lt;In,Yield,OptionalInit&gt;
+    |   VariableDeclaration&lt;In,Yield,true&gt;
+;
+
+VariableBinding &lt;In, Yield, OptionalInit&gt;:
+    =&gt; pattern=BindingPattern&lt;Yield&gt; (
+            &lt;OptionalInit&gt; ('=' expression=AssignmentExpression&lt;In,Yield&gt;)?
+        |   &lt;!OptionalInit&gt; '=' expression=AssignmentExpression&lt;In,Yield&gt;
+    )
+;
+
+VariableDeclaration &lt;In, Yield, AllowType&gt;:
+    {VariableDeclaration} VariableDeclarationImpl&lt;In,Yield,AllowType&gt;;
+
+fragment VariableDeclarationImpl &lt;In, Yield, AllowType&gt;*:
+    annotations+=Annotation*
+    (
+        &lt;AllowType&gt; =&gt;(
+            name=BindingIdentifier&lt;Yield&gt; ColonSepTypeRef?
+        ) ('=' expression=AssignmentExpression&lt;In,Yield&gt;)?
+    |   &lt;!AllowType&gt; =&gt;(
+        name=BindingIdentifier&lt;Yield&gt;
+        ) ('=' expression=AssignmentExpression&lt;In,Yield&gt;)?
+    )
+;</code></pre>
+</div>
+</div>
+<div class="exampleblock">
+<div class="title">Example 93. Variable Statement</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">var any: any;
+// any.type := any
+
+var anyNull = null;
+// anyNull.type := any
+
+var s: string;
+// s.type := string
+
+var init = "Hi";
+// init.type := string
+
+const MESSAGE = "Hello World";
+// MESSAGE.type := string</code></pre>
+</div>
+</div>
+</div>
+</div>
+<h5 id="variable-statement-semantics" class="discrete">Semantics</h5>
+<div class="paragraph">
+<p>From a model and type inference point of view, variable and constant statements and declarations are similar except that the pseudo property <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>c</mi><mi>o</mi><mi>n</mi><mi>s</mi><mi>t</mi></math> is set to false for variables and true for constants.
+Also see exported variable statement (<a href="#_export-statement">Export Statement</a>) and constant statement and declaration (<a href="#_const">Const</a>).</p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-127"></a><strong>Req. IDE-127:</strong> <a href="#Req-IDE-127">Variable declaration</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>For a given variable declaration <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>d</mi></math>, the following constraints must hold:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>The type of the initializer expression must conform to the declared type:</p>
+<div class="paragraph">
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>d</mi><mo>.</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>e</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>o</mi><mi>n</mi><mo>≠</mo><mstyle mathvariant="monospace"><mtext>null</mtext></mstyle><mo>∧</mo><mi>d</mi><mo>.</mo><mi>d</mi><mi>e</mi><mi>c</mi><mi>l</mi><mi>a</mi><mi>r</mi><mi>e</mi><mi>d</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mo>≠</mo><mstyle mathvariant="monospace"><mtext>null</mtext></mstyle></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mo>→</mo><mi>Γ</mi><mo>⊢</mo><mi>d</mi><mo>.</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>e</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>o</mi><mi>n</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>Γ</mi><mo>⊢</mo><mi>d</mi><mo>.</mo><mi>d</mi><mi>e</mi><mi>c</mi><mi>l</mi><mi>a</mi><mi>r</mi><mi>e</mi><mi>d</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi></math></p>
+</div>
+</li>
+<li>
+<p>The initializer expression should not contain a reference to <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>d</mi></math> except where the reference is contained in a class expression or function expression and
+the class is not immediately initialized or the function is not immediately invoked.
+In these cases, the code is executed later and the self-reference is not a problem.<br>
+To clarify: <em>should not</em> means that only a warning will be produced.</p>
+</li>
+</ul>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">// not ok (simple case)
+var n = n + 1;
+
+// ok (class expression not fully supported)
+// var cls1 = class { static sfield1 = "hello"; field2 = cls1.sfield1; };
+
+// not ok, immediately instantiated (class expression not fully supported)
+// var cls2 = new class { field1 = "hello"; field2 = cls2.field1; };
+
+// ok
+var fun1 = function() : number { var x = fun1; return -42; };
+
+// not ok, immediately invoked
+var fun2 = function() : number { var x = fun2;  return -42; }();</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>The variable statement may contain array or object destructuring patterns, see <a href="extended_fetaures.html#_array-and-object-destructuring">Array and Object Destructuring</a> for details.</p>
+</div>
+</div>
+</div>
+<h5 id="variable-statement-type-inference" class="discrete">Type Inference</h5>
+<div class="paragraph">
+<p>The type of a variable is the type of its declaration:</p>
+</div>
+<div class="openblock">
+<div class="content">
+
+</div>
+</div>
+<div class="paragraph">
+<p>The type of a variable declaration is either the declared type or the inferred type of the initializer expression:</p>
+</div>
+<div class="openblock">
+<div class="content">
+
+</div>
+</div>
+</div>
+<div class="sect3 language-n4js">
+<h4 id="_if-statement"><a class="anchor" href="#_if-statement"></a><a class="link" href="#_if-statement">9.1.3. If Statement</a></h4>
+<h5 id="if-statement-syntax" class="discrete">Syntax</h5>
+<div class="paragraph">
+<p>Cf. [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.S12.5, p.p.89)</a>]</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">IfStatement &lt;Yield&gt;:
+    'if' '(' expression=Expression&lt;In=true,Yield&gt; ')'
+    ifStmt=Statement&lt;Yield&gt;
+    (=&gt; 'else' elseStmt=Statement&lt;Yield&gt;)?;</code></pre>
+</div>
+</div>
+<h5 id="if-statement-semantics" class="discrete">Semantics</h5>
+<div class="paragraph">
+<p>There are no specific constraints defined for the condition, the ECMAScript operation <code>ToBoolean</code> [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.S9.2, p.p.43)</a>] is used to convert any type to boolean.</p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-128"></a><strong>Req. IDE-128:</strong> <a href="#Req-IDE-128">If Statement</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>In N4JS, the expression of an if statement must not evaluate to <code>void</code>.
+If the expressions is a function call in particular, the called function must not be declared to return <code>void</code>.</p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_iteration-statements"><a class="anchor" href="#_iteration-statements"></a><a class="link" href="#_iteration-statements">9.1.4. Iteration Statements</a></h4>
+<h5 id="iterations-statements-syntax" class="discrete">Syntax</h5>
+<div class="paragraph">
+<p>Cf. [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.S12.6, p.p.90ff)</a>]</p>
+</div>
+<div class="paragraph">
+<p>The syntax already considers the for-of style described in <a href="#_for-of-statement"><code>for &#8230;&#8203; of</code> statement</a>.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">IterationStatement &lt;Yield&gt;:
+        DoStatement&lt;Yield&gt;
+    |   WhileStatement&lt;Yield&gt;
+    |   ForStatement&lt;Yield&gt;
+;
+
+DoStatement &lt;Yield&gt;: 'do' statement=Statement&lt;Yield&gt; 'while' '(' expression=Expression&lt;In=true,Yield&gt; ')' =&gt; Semi?;
+WhileStatement &lt;Yield&gt;: 'while' '(' expression=Expression&lt;In=true,Yield&gt; ')' statement=Statement&lt;Yield&gt;;
+
+ForStatement &lt;Yield&gt;:
+    {ForStatement} 'for' '('
+    (
+        // this is not in the spec as far as I can tell, but there are tests that rely on this to be valid JS
+            =&gt;(initExpr=LetIdentifierRef forIn?='in' expression=Expression&lt;In=true,Yield&gt; ')')
+        |   (   -&gt;varStmtKeyword=VariableStatementKeyword
+                (
+                        =&gt;(varDeclsOrBindings+=BindingIdentifierAsVariableDeclaration&lt;In=false,Yield&gt; (forIn?='in' | forOf?='of') -&gt;expression=AssignmentExpression&lt;In=true,Yield&gt;?)
+                    |   varDeclsOrBindings+=VariableDeclarationOrBinding&lt;In=false,Yield,OptionalInit=true&gt;
+                        (
+                                (',' varDeclsOrBindings+=VariableDeclarationOrBinding&lt;In=false,Yield,false&gt;)* ';' expression=Expression&lt;In=true,Yield&gt;? ';' updateExpr=Expression&lt;In=true,Yield&gt;?
+                            |   forIn?='in' expression=Expression&lt;In=true,Yield&gt;?
+                            |   forOf?='of' expression=AssignmentExpression&lt;In=true,Yield&gt;?
+                        )
+                )
+            |   initExpr=Expression&lt;In=false,Yield&gt;
+                (
+                        ';' expression=Expression&lt;In=true,Yield&gt;? ';' updateExpr=Expression&lt;In=true,Yield&gt;?
+                    |   forIn?='in' expression=Expression&lt;In=true,Yield&gt;?
+                    |   forOf?='of' expression=AssignmentExpression&lt;In=true,Yield&gt;?
+                )
+            |   ';' expression=Expression&lt;In=true,Yield&gt;? ';' updateExpr=Expression&lt;In=true,Yield&gt;?
+            )
+        ')'
+    ) statement=Statement&lt;Yield&gt;
+;
+
+ContinueStatement &lt;Yield&gt;: {ContinueStatement} 'continue' (label=[LabelledStatement|BindingIdentifier&lt;Yield&gt;])? Semi;
+BreakStatement &lt;Yield&gt;: {BreakStatement} 'break' (label=[LabelledStatement|BindingIdentifier&lt;Yield&gt;])? Semi;</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Since <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>v</mi><mi>a</mi><mi>r</mi><mi>D</mi><mi>e</mi><mi>c</mi><mi>l</mi><mfenced close=")" open="("><mi>s</mi></mfenced></math> are <code>VariableStatement</code>s as described in <a href="#_variable-statement">Variable Statement</a>, the declared variables can be type annotated.</p>
+</div>
+<div class="admonitionblock tip">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-tip" title=""></i>
+</td>
+<td class="content">
+Using for-in is not recommended, instead <code>_each</code> should be used.
+</td>
+</tr>
+</table>
+</div>
+<h5 id="iterations-statements-semantics" class="discrete">Semantics</h5>
+<div class="paragraph">
+<p>There are no specific constraints defined for the condition, the
+ECMAScript operation <code>ToBoolean</code> [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.S9.2, p.p.43)</a>] is used to convert any type to boolean.</p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-129"></a><strong>Req. IDE-129:</strong> <a href="#Req-IDE-129">For-In-Statement Constraints</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>For a given <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>f</mi></math> the following conditions must hold:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>The type of the expression must be conform to object:<br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>Γ</mi><mo>⊢</mo><mi>f</mi><mo>.</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>e</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>o</mi><mi>n</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mstyle mathvariant="monospace"><mtext>union</mtext><mtext>Object,string,ArgumentType</mtext></mstyle></math></p>
+</li>
+<li>
+<p>Either a new loop variable must be declared or an rvalue must be provided as init expression:<br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>f</mi><mo>.</mo><mi>v</mi><mi>a</mi><mi>r</mi><mi>D</mi><mi>e</mi><mi>c</mi><mi>l</mi><mo>≠</mo><mi>n</mi><mi>u</mi><mi>l</mi><mi>l</mi><mo>∨</mo><mfenced close=")" open="("><mrow><mi>f</mi><mo>.</mo><mi>i</mi><mi>n</mi><mi>i</mi><mi>t</mi><mi>E</mi><mi>x</mi><mi>p</mi><mi>r</mi><mo>≠</mo><mi>n</mi><mi>u</mi><mi>l</mi><mi>l</mi><mo>∧</mo><mi>i</mi><mi>s</mi><mi>R</mi><mi>V</mi><mi>a</mi><mi>l</mi><mi>u</mi><mi>e</mi><mfenced close=")" open="("><mrow><mi>f</mi><mo>.</mo><mi>i</mi><mi>n</mi><mi>i</mi><mi>t</mi><mi>E</mi><mi>x</mi><mi>p</mi><mi>r</mi></mrow></mfenced></mrow></mfenced></math></p>
+</li>
+<li>
+<p>The type of the loop variable must be a string (or a super type of string, i.e. any):</p>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mtable><mtr><mtd/><mtd><mrow><mo>(</mo><mrow><mi>f</mi><mo>.</mo><mi>v</mi><mi>a</mi><mi>r</mi><mi>D</mi><mi>e</mi><mi>c</mi><mi>l</mi><mo>≠</mo><mi>n</mi><mi>u</mi><mi>l</mi><mi>l</mi><mo>∧</mo><mi>Γ</mi><mo>⊢</mo><mi>f</mi><mo>.</mo><mi>v</mi><mi>a</mi><mi>r</mi><mi>D</mi><mi>e</mi><mi>c</mi><mi>l</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mstyle mathvariant="monospace"><mtext>string</mtext></mstyle><mo>)</mo></mrow></mrow></mtd></mtr><mtr><mtd><mo>∨</mo></mtd><mtd><mrow><mo>(</mo><mrow><mi>f</mi><mo>.</mo><mi>i</mi><mi>n</mi><mi>i</mi><mi>t</mi><mi>E</mi><mi>x</mi><mi>p</mi><mo>≠</mo><mi>n</mi><mi>u</mi><mi>l</mi><mi>l</mi><mo>∧</mo><mi>Γ</mi><mo>⊢</mo><mstyle mathvariant="monospace"><mtext>string</mtext></mstyle><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>f</mi><mo>.</mo><mi>i</mi><mi>n</mi><mi>i</mi><mi>t</mi><mi>E</mi><mi>x</mi><mi>p</mi><mi>r</mi><mo>)</mo></mrow></mrow></mtd></mtr></mtable></math>
+</div>
+</div>
+</li>
+</ul>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3 language-n4js">
+<h4 id="_return-statement"><a class="anchor" href="#_return-statement"></a><a class="link" href="#_return-statement">9.1.5. Return Statement</a></h4>
+<h5 id="return-statement-syntax" class="discrete">Syntax</h5>
+<div class="paragraph">
+<p>The returns statement is defined as in [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.S12.9, p.p.93)</a>] with</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">ReturnStatement &lt;Yield&gt;:
+    'return' (expression=Expression&lt;In=true,Yield&gt;)? Semi;</code></pre>
+</div>
+</div>
+<h5 id="return-statement-semantics" class="discrete">Semantics</h5>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-130"></a><strong>Req. IDE-130:</strong> <a href="#Req-IDE-130">Return statement</a> (ver. 1)</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Expected type of expression in a return statement must be a sub type of the return type of the enclosing function:</p>
+<div class="openblock">
+<div class="content">
+
+</div>
+</div>
+<div class="paragraph">
+<p>Note that the expression may be evaluated to <code>void</code>.</p>
+</div>
+</li>
+<li>
+<p>If enclosing function is declared to return <code>void</code>, then either</p>
+<div class="ulist">
+<ul>
+<li>
+<p>no return statement must be defined</p>
+</li>
+<li>
+<p>return statement has no expression</p>
+</li>
+<li>
+<p>type of expression of return statement is <code>void</code></p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>If enclosing function is declared to to return a type different from <code>void</code>, then</p>
+<div class="ulist">
+<ul>
+<li>
+<p>all return statements must have a return expression</p>
+</li>
+<li>
+<p>all control flows must either end with a return or throw statement</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>Returns statements must be enclosed in a function.
+A return statement, for example, must not be a top-level statement.</p>
+</li>
+</ol>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_with-statement"><a class="anchor" href="#_with-statement"></a><a class="link" href="#_with-statement">9.1.6. With Statement</a></h4>
+<h5 id="with-statement-syntax" class="discrete">Syntax</h5>
+<div class="paragraph">
+<p>The with statement is not allowed in N4JS, thus an error is issued.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">WithStatement &lt;Yield&gt;:
+    'with' '(' expression=Expression&lt;In=true,Yield&gt; ')'
+    statement=Statement&lt;Yield&gt;;</code></pre>
+</div>
+</div>
+<h5 id="with-statement-semantics" class="discrete">Semantics</h5>
+<div class="paragraph">
+<p>N4JS is based on strict mode and the with statement is not allowed in
+strict mode, cf. [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.S12.10.1, p.p.94)</a>].</p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-131"></a><strong>Req. IDE-131:</strong> <a href="#Req-IDE-131">With Statement</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>With statements are not allowed in N4JS or strict mode.</p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_switch-statement"><a class="anchor" href="#_switch-statement"></a><a class="link" href="#_switch-statement">9.1.7. Switch Statement</a></h4>
+<h5 id="switch-statement-syntax" class="discrete">Syntax</h5>
+<div class="paragraph">
+<p>Cf. [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.S12.11, p.p.94ff)</a>]</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">SwitchStatement &lt;Yield&gt;:
+    'switch' '(' expression=Expression&lt;In=true,Yield&gt; ')' '{'
+    (cases+=CaseClause&lt;Yield&gt;)*
+    ((cases+=DefaultClause&lt;Yield&gt;)
+    (cases+=CaseClause&lt;Yield&gt;)*)? '}'
+;
+
+CaseClause &lt;Yield&gt;: 'case' expression=Expression&lt;In=true,Yield&gt; ':' (statements+=Statement&lt;Yield&gt;)*;
+DefaultClause &lt;Yield&gt;: {DefaultClause} 'default' ':' (statements+=Statement&lt;Yield&gt;)*;</code></pre>
+</div>
+</div>
+<h5 id="switch-statement-semantics" class="discrete">Semantics</h5>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-132"></a><strong>Req. IDE-132:</strong> <a href="#Req-IDE-132">Switch Constraints</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>For a given switch statement <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>s</mi></math>, the following constraints must hold:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>For all cases <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>c</mi><mo>∈</mo><mi>s</mi><mo>.</mo><mi>c</mi><mi>a</mi><mi>s</mi><mi>e</mi><mi>s</mi></math>, <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>s</mi><mo>.</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi></math>===<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>c</mi><mo>.</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi></math> must be valid according to the constraints defined in <a href="expressions.html#_equality-expression">Equality Expression</a>.</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_throw-try-and-catch-statements"><a class="anchor" href="#_throw-try-and-catch-statements"></a><a class="link" href="#_throw-try-and-catch-statements">9.1.8. Throw, Try, and Catch Statements</a></h4>
+<h5 id="throw-try-catch-syntax" class="discrete">Syntax</h5>
+<div class="paragraph">
+<p>Cf. [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.S12.13/14, p.p.96ff)</a>]</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">ThrowStatement &lt;Yield&gt;:
+    'throw' expression=Expression&lt;In=true,Yield&gt; Semi;
+
+TryStatement &lt;Yield&gt;:
+    'try' block=Block&lt;Yield&gt;
+    ((catch=CatchBlock&lt;Yield&gt; finally=FinallyBlock&lt;Yield&gt;?) | finally=FinallyBlock&lt;Yield&gt;)
+;
+
+CatchBlock &lt;Yield&gt;: {CatchBlock} 'catch' '(' catchVariable=CatchVariable&lt;Yield&gt; ')' block=Block&lt;Yield&gt;;
+
+CatchVariable &lt;Yield&gt;:
+        =&gt;bindingPattern=BindingPattern&lt;Yield&gt;
+    |   name=BindingIdentifier&lt;Yield&gt;
+;
+
+FinallyBlock &lt;Yield&gt;: {FinallyBlock} 'finally' block=Block&lt;Yield&gt;;</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>There must be not type annotation for the catch variable, as this would lead to the wrong assumption that a type can be specified.</p>
+</div>
+<h5 id="throw-try-catch-type-inference" class="discrete">Type Inference</h5>
+<div class="paragraph">
+<p>The type of the catch variable is always assumed to be <code>any</code>.</p>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow/><mrow><mi>Γ</mi><mo>⊢</mo><mi>c</mi><mi>a</mi><mi>t</mi><mi>c</mi><mi>h</mi><mi>B</mi><mi>l</mi><mi>o</mi><mi>c</mi><mi>k</mi><mo>.</mo><mi>c</mi><mi>a</mi><mi>t</mi><mi>c</mi><mi>h</mi><mi>V</mi><mi>a</mi><mi>r</mi><mi>i</mi><mi>a</mi><mi>b</mi><mi>l</mi><mi>e</mi><mi>:</mi><mstyle mathvariant="monospace"><mtext>any</mtext></mstyle></mrow></mfrac></math>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_debugger-statement"><a class="anchor" href="#_debugger-statement"></a><a class="link" href="#_debugger-statement">9.1.9. Debugger Statement</a></h4>
+<h5 id="debugger-statement-syntax" class="discrete">Syntax</h5>
+<div class="paragraph">
+<p>Cf. [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.S12.15, p.p.97ff)</a>])</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">DebuggerStatement: {DebuggerStatement} 'debugger' Semi;</code></pre>
+</div>
+</div>
+<h5 id="debugger-statement--semantics" class="discrete">Semantics</h5>
+<div class="paragraph">
+<p>na</p>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="_ecmascript-6-statements"><a class="anchor" href="#_ecmascript-6-statements"></a><a class="link" href="#_ecmascript-6-statements">9.2. ECMAScript 6 Statements</a></h3>
+<div class="paragraph">
+<p>N4JS export and import statements are similar to ES6 with some minor d ifferences which are elaborated on below.</p>
+</div>
+<div class="sect3">
+<h4 id="_let"><a class="anchor" href="#_let"></a><a class="link" href="#_let">9.2.1. Let</a></h4>
+<div class="paragraph">
+<p>Cf. [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.13.2.1)</a>], also <a href="http://www.2ality.com/2015/02/es6-scoping.html">Rauschmayer, 2ality: <strong>Variables and scoping in ECMAScript 6</strong></a></p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_const"><a class="anchor" href="#_const"></a><a class="link" href="#_const">9.2.2. Const</a></h4>
+<div class="paragraph">
+<p>Cf. [<a href="appendix_c_bibliography.html#ECMA15a">ECMA15a(p.13.2.1)</a>], also <a href="http://www.2ality.com/2015/02/es6-scoping.html">Rauschmayer, 2ality: <strong>Variables and scoping in ECMAScript 6</strong></a></p>
+</div>
+<div class="paragraph">
+<p>Additionally to the <code>var</code> statement, the <code>const</code> statement is supported.
+It allows for declaring variables which must be assigned to a value in the declaration and their value must not change.
+That is to say that constants are not allowed to be on the left-hand side of other assignments.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">ConstStatement returns VariableStatement: 'const' varDecl+=ConstDeclaration ( ',' varDecl+=ConstDeclaration )* Semi;
+
+ConstDeclaration returns VariableDeclaration: typeRef=TypeRef? name=IDENTIFIER const?='=' expression=AssignmentExpression;</code></pre>
+</div>
+</div>
+<h5 id="const-semantics" class="discrete">Semantics</h5>
+<div class="paragraph">
+<p>A const variable statement is more or less a normal variable statement (see <a href="#_variable-statement">Variable Statement</a>), except that all variables declared by that
+statement are not writable (cf. <a href="expressions.html#Req-IDE-121">[Req-IDE-121]</a>).
+This is similar to constant data fields (cf. <a href="classifiers.html#_assignment-modifiers">Assignment Modifiers</a>).</p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-133"></a><strong>Req. IDE-133:</strong> <a href="#Req-IDE-133">Writability of const variables</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>All variable declarations of a const variable statement
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>c</mi><mi>o</mi><mi>n</mi><mi>s</mi><mi>t</mi><mi>S</mi><mi>t</mi><mi>m</mi><mi>t</mi></math> are not writeable:
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∀</mo><mi>v</mi><mi>d</mi><mi>e</mi><mi>c</mi><mi>l</mi><mo>∈</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>s</mi><mi>t</mi><mi>S</mi><mi>t</mi><mi>m</mi><mi>t</mi><mo>.</mo><mi>v</mi><mi>a</mi><mi>r</mi><mi>D</mi><mi>e</mi><mi>c</mi><mi>l</mi><mi>:</mi><mo>¬</mo><mi>v</mi><mi>d</mi><mi>e</mi><mi>c</mi><mi>l</mi><mo>.</mo><mi>w</mi><mi>r</mi><mi>i</mi><mi>t</mi><mi>a</mi><mi>b</mi><mi>l</mi><mi>e</mi></math></p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_for-of-statement"><a class="anchor" href="#_for-of-statement"></a><a class="link" href="#_for-of-statement">9.2.3. <code>for &#8230;&#8203; of</code> statement</a></h4>
+<div class="paragraph">
+<p>ES6 introduced a new form of <code>for</code> statement: <code>for &#8230;&#8203; of</code> to iterate over the elements of an  <code>Iterable</code>, cf. <a href="#_iterablen">[_iterablen]</a>.</p>
+</div>
+<h5 id="for-of-statement-syntax" class="discrete">Syntax</h5>
+<div class="paragraph">
+<p>See <a href="#_iteration-statements">Iteration Statements</a></p>
+</div>
+<h5 id="for-of-statement-semantics" class="discrete">Semantics</h5>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-134"></a><strong>Req. IDE-134:</strong> <a href="#Req-IDE-134">for &#8230;&#8203; of statement</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>For a given <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>f</mi></math> the following conditions must hold:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>The value provided after <code>of</code> in a <code>for &#8230;&#8203; of</code> statement must be a subtype of <code>Iterable&lt;?&gt;</code>.</p>
+</li>
+<li>
+<p>Either a new loop variable must be declared or an rvalue must be provided as init expression:<br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>f</mi><mo>.</mo><mi>v</mi><mi>a</mi><mi>r</mi><mi>D</mi><mi>e</mi><mi>c</mi><mi>l</mi><mo>≠</mo><mi>n</mi><mi>u</mi><mi>l</mi><mi>l</mi><mo>∨</mo><mfenced close=")" open="("><mrow><mi>f</mi><mo>.</mo><mi>i</mi><mi>n</mi><mi>i</mi><mi>t</mi><mi>E</mi><mi>x</mi><mi>p</mi><mi>r</mi><mo>≠</mo><mi>n</mi><mi>u</mi><mi>l</mi><mi>l</mi><mo>∧</mo><mi>i</mi><mi>s</mi><mi>R</mi><mi>V</mi><mi>a</mi><mi>l</mi><mi>u</mi><mi>e</mi><mfenced close=")" open="("><mrow><mi>f</mi><mo>.</mo><mi>i</mi><mi>n</mi><mi>i</mi><mi>t</mi><mi>E</mi><mi>x</mi><mi>p</mi><mi>r</mi></mrow></mfenced></mrow></mfenced></math></p>
+</li>
+<li>
+<p>If a new variable <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>v</mi></math> is declared before <code>of</code> and it has a declared type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi></math>, the value provided after must be a subtype of <code>Iterable&lt;?extendsT&gt;</code>.
+If <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>v</mi></math> does not have a declared type, the type of <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>v</mi></math> is inferred to the type of the first type argument of the actual type of the value provided after <code>of</code>.</p>
+</li>
+<li>
+<p>If a previously-declared variable is referenced before with a declared or inferred type of <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi></math>, the value provided after <code>of</code> must be a subtype of <code>Iterable&lt;?extendsT&gt;</code>.</p>
+</li>
+</ol>
+</div>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title=""></i>
+</td>
+<td class="content">
+<code>Iterable</code> is structurally typed on definition-site so non-N4JS types can meet the above requirements by simply implementing the only method in interface <code>Iterable</code> (with a correct return type).
+</td>
+</tr>
+</table>
+</div>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title=""></i>
+</td>
+<td class="content">
+The first of the above constraints (the type required by the ’of’ part in a <code>for &#8230;&#8203; of</code> loop is <code>Iterable</code>) was changed during the definition of ECMAScript 6.
+This is implemented differently in separate implementations and even in different versions of the same implementation (for instance in different versions of V8).
+Older implementations require an <code>Iterator</code> or accept both <code>Iterator</code> an or <code>Iterable</code>.
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>Requiring an <code>Iterable</code> and not accepting a plain <code>Iterator</code> seems to be the final decision (as of Dec. 2014).
+For reference, see abstract operations <code>GetIterator</code> in [<a href="appendix_c_bibliography.html#ECMA15a">ECMA15a(p.S7.4.2)</a>] and "CheckIterable" [<a href="appendix_c_bibliography.html#ECMA15a">ECMA15a(p.S7.4.1)</a>] and their
+application in "ForIn/OfExpressionEvaluation" [<a href="appendix_c_bibliography.html#ECMA15a">ECMA15a(p.S13.6.4.8)</a>] and <code>CheckIterable</code> and their application in <code>ForIn/OfExpressionEvaluation</code>.
+See also a related blog post <sup class="footnote">[<a id="_footnoteref_53" class="footnote" href="appendix_c_bibliography.html#_footnote_53" title="View footnote.">53</a>]</sup> that is kept up to date with changes to ECMAScript 6:</p>
+</div>
+<div class="quoteblock">
+<blockquote>
+<em>ECMAScript 6 has a new loop, for-of. That loop works with iterables. Before we can use it with createArrayIterator(), we need to turn the result into an iterable.</em>
+</blockquote>
+</div>
+<div class="paragraph">
+<p>An array or object destructuring pattern may be used left of the <code>of</code>.
+This is used to destructure the elements of the <code>Iterable</code> on the right-hand side (not the <code>Iterable</code> itself).
+For detais, see <a href="extended_fetaures.html#_array-and-object-destructuring">Array and Object Destructuring</a>.</p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_import-statement"><a class="anchor" href="#_import-statement"></a><a class="link" href="#_import-statement">9.2.4. Import Statement</a></h4>
+<div class="paragraph">
+<p>Cf. ES6 import [<a href="appendix_c_bibliography.html#ECMA15a">ECMA15a(p.15.2.2)</a>], see also <a href="https://babeljs.io/docs/usage/modules/" class="bare">https://babeljs.io/docs/usage/modules/</a></p>
+</div>
+<h5 id="import-statement-syntax" class="discrete">Syntax</h5>
+<div class="paragraph">
+<p>The grammar of import declarations is defined as follows:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">ImportDeclaration:
+    {ImportDeclaration}
+    ImportDeclarationImpl
+;
+
+fragment ImportDeclarationImpl*:
+    'import' (
+        ImportClause importFrom?='from'
+    )? module=[types::TModule|ModuleSpecifier] Semi
+;
+
+fragment ImportClause*:
+        importSpecifiers+=DefaultImportSpecifier (',' ImportSpecifiersExceptDefault)?
+    |   ImportSpecifiersExceptDefault
+;
+
+fragment ImportSpecifiersExceptDefault*:
+        importSpecifiers+=NamespaceImportSpecifier
+    |   '{' (importSpecifiers+=NamedImportSpecifier (',' importSpecifiers+=NamedImportSpecifier)* ','?)? '}'
+;
+
+NamedImportSpecifier:
+        importedElement=[types::TExportableElement|BindingIdentifier&lt;Yield=false&gt;]
+    |   importedElement=[types::TExportableElement|IdentifierName] 'as' alias=BindingIdentifier&lt;Yield=false&gt;
+;
+
+DefaultImportSpecifier:
+    importedElement=[types::TExportableElement|BindingIdentifier&lt;Yield=false&gt;]
+;
+
+NamespaceImportSpecifier: {NamespaceImportSpecifier} '*' 'as' alias=BindingIdentifier&lt;false&gt; (declaredDynamic?='+')?;
+
+ModuleSpecifier: STRING;</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>These are the properties of import declaration which can be specified by the user:</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><code>annotations</code> </dt>
+<dd>
+<p>Arbitrary annotations, see <a href="annotations.html#_annotations">Annotations</a> and below for details.</p>
+</dd>
+<dt class="hdlist1"><code>importSpecifiers</code> </dt>
+<dd>
+<p>The elements to be imported with their names.</p>
+</dd>
+</dl>
+</div>
+<div class="paragraph">
+<p>Also see compilation as described in <a href="components.html#_modules">Modules</a>, for semantics see <a href="#import-statement-semantics">Import Statement Semantics</a>.</p>
+</div>
+<div class="exampleblock">
+<div class="title">Example 94. Import</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">import A from "p/A"
+import {C,D,E} from "p/E"
+import * as F from "p/F"
+import {A as G} from "p/G"
+import {A as H, B as I} from "p/H"</code></pre>
+</div>
+</div>
+</div>
+</div>
+<h5 id="import-statement-semantics" class="discrete">Semantics</h5>
+<div class="paragraph">
+<p>Import statements are used to import identifiable elements from another module.
+Identifiable elements are</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>types (via their type declaration), in particular</p>
+<div class="ulist">
+<ul>
+<li>
+<p>classifiers (classes, interfaces)</p>
+</li>
+<li>
+<p>functions</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>variables and constants.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>The module to import from is identified by the string literal following keyword <code>from</code>.
+This string must be a valid</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>complete module specifier <sup class="footnote">[<a id="_footnoteref_54" class="footnote" href="appendix_c_bibliography.html#_footnote_54" title="View footnote.">54</a>]</sup>:</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">    import {A} from "ProjectA/a/b/c/M"</code></pre>
+</div>
+</div>
+</li>
+<li>
+<p>plain module specifier:</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">    import {A} from "a/b/c/M"</code></pre>
+</div>
+</div>
+</li>
+<li>
+<p>or project name only, assuming the project defines a main module in its <code>package.json</code> file (using the <code>mainModule</code> package.json property, see <a href="components.html#package-json-mainModule">mainModule</a>):</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">    import {A} from "ProjectA"</code></pre>
+</div>
+</div>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>For choosing the element to import, there are the exact same options as in ECMAScript6:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>named imports select one or more elements by name, optionally introducing a local alias:</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">    import {C} from "M"
+    import {D as MyD} from "M"
+    import {E, F as MyF, G, H} from "M"</code></pre>
+</div>
+</div>
+</li>
+<li>
+<p>namespace imports select all elements of the remote module for import and define a namespace name; the imported elements are then accessed via the namespace name:</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">    import * as N from "M"
+    var c: N.C = new N.C();</code></pre>
+</div>
+</div>
+</li>
+<li>
+<p>default imports select whatever element was exported by the remote module as the default (there can be at most one default export per module):</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">    import C from "M"</code></pre>
+</div>
+</div>
+</li>
+<li>
+<p>namespace imports provide access to the default export:</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">    import * as N from "M"
+    var c: N.default = new N.default();</code></pre>
+</div>
+</div>
+</li>
+</ul>
+</div>
+<div class="openblock">
+<div class="content">
+<div class="paragraph">
+<p>The following constraints are defined on a (non-dynamic) import statement <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>i</mi></math>:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>The imported module needs to be accessible from the current project.</p>
+</li>
+<li>
+<p>The imported declarations need to be accessible from the current module.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>For named imports, the following constraints must hold:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>No declaration must be imported multiple times, even if aliases are used.</p>
+</li>
+<li>
+<p>The names must be unique in the module. They must not conflict with each other or locally declared variables, types, or functions.</p>
+</li>
+<li>
+<p>Declarations imported via named imports are accessible only via used name (or alias) and not via original name directly.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>For wildcard imports, the following constraints must hold:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Only one namespace import can be used per (target) module, even if different namespace name is used.</p>
+</li>
+<li>
+<p>The namespace name must be unique in the module. They must not conflict with each other or locally declared variables, types, or functions.</p>
+</li>
+<li>
+<p>Declarations imported via namespace import are accessible via namespace only and not with original name directly.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>For namespace imports, the following constraints must hold:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>If the referenced module is a plain <code>js</code> file, a warning will be created to use the dynamic import instead.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>For default imports, the following constraints must hold:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>The referenced module must have a default export.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Cross-cutting constraints:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>No declaration can be imported via named import and namespace import at the same time.</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+<div class="exampleblock">
+<div class="title">Example 95. Imports</div>
+<div class="content">
+<div class="paragraph">
+<p>Imports cannot be duplicated:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">import * as A from 'A';
+import * as A from 'A';//error, duplicated import statement
+
+import B from 'B';
+import B from 'B';//error, duplicated import statement</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Given element cannot be imported multiple times:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">import * as A1 from 'A';
+import * as A2 from 'A';//error, elements from A already imported in A1
+
+import B from 'B';
+import B as B1 from 'B';//error, B/B is already imported as B
+
+import C as C1 from 'C';
+import C from 'C';//error, C/C is already imported as C1
+
+import D as D1 from 'D';
+import D as D2 from 'D';//error, D/D is already imported as D1
+
+import * as NE from 'E';
+import E from 'E';//error, E/E is already imported as NE.E
+
+import F from 'F';
+import * as NF from 'F';//error, F/F is already imported as F</code></pre>
+</div>
+</div>
+<div style="page-break-after: always;"></div>
+<div class="paragraph">
+<p>Names used in imports must not not conflict with each other or local
+declarations:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">import * as A from 'A1';
+import * as A from 'A2';//A is already used as namespace for A1
+
+import B from 'B1';
+import B1 as B from 'B2';//B us already used as import B/B1
+
+import C1 as C from 'C1';
+import * as C from 'C2'; //C is already used as import C1/C1
+
+import * as D from 'D1';
+import D2 as D from 'D2';//D is already used as namespace for D1
+
+import E from 'E';
+var E: any; // conflict with named import E/E
+
+import * as F from 'F';
+var F: any; // conflict with namespace F</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Using named imports, aliases and namespaces allows to refer to mulitple
+types of the same name such as  <code>A/A</code>, <code>B/A</code> and <code>C/A</code>:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">import A from 'A';// local name A referencess to A/A
+import A as B from 'B';//local name B referencess to B/A
+import * as C from 'C';//local name C.A referencess to C/A</code></pre>
+</div>
+</div>
+<div style="page-break-after: always;"></div>
+<div class="paragraph">
+<p>If a declaration has been imported with an alias or namespace, it is not
+accessible via its original name:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">import * as B from 'A1';
+import A2 as C from 'A2';
+
+var a1_bad: A1;//error, A1/A1 is not directly accessible with original name
+var a1_correct: B.A1;// A1/A1 is accessible via namespace B
+var a2_bad: A2;//error, A2/A2 is not directly accessible with original name
+var a2_correct: C;// A2/A2 is accessible via alias C</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="Dynamic_Imports"><a class="anchor" href="#Dynamic_Imports"></a><a class="link" href="#Dynamic_Imports">9.2.4.1. Dynamic Imports</a></h5>
+<div class="paragraph">
+<p>N4JS extends the ES6 module import in order that modules without a <code>n4jsd</code> or <code>n4js</code> file (plain <code>js</code> modules) can be imported.
+This is done by adding <code>+</code> to the name of the named import. This form of compile-time import without type information is not
+to be confused with import calls as described in <a href="expressions.html#Import_Calls">Import Calls</a>, which are sometimes referred to as "dynamic import" as well.</p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-136"></a><strong>Req. IDE-136:</strong> <a href="#Req-IDE-136">Dynamic Import</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>Let <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>i</mi></math> be an import
+statement <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>i</mi></math> with a dynamic namespace specifier. The
+following constraints must hold:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>i</mi><mo>.</mo><mi>m</mi><mi>o</mi><mi>d</mi><mi>u</mi><mi>l</mi><mi>e</mi></math> must not reference an <code>n4js</code> file.</p>
+</li>
+<li>
+<p>If <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>i</mi><mo>.</mo><mi>m</mi><mi>o</mi><mi>d</mi><mi>u</mi><mi>l</mi><mi>e</mi></math> references an <code>n4jsd</code> file, a warning is
+to be created.</p>
+</li>
+<li>
+<p>If the file referenced by <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>i</mi><mo>.</mo><mi>m</mi><mi>o</mi><mi>d</mi><mi>u</mi><mi>l</mi><mi>e</mi></math> is not found, an
+error is created just as in the static case.</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>These constraints define the error level when using dynamic import: we receive no error for <code>js</code>, a warning for <code>n4jsd</code>, and an error for <code>n4js</code> files.
+The idea behind these distinct error levels is as follows:<br>
+If only a plain <code>js</code> file is available, using the dynamic import is the only way to access elements from the <code>js</code> module.
+This might be an unsafe way, but it allows the access and simplifies the first steps.
+An <code>n4jsd</code> file may then be made available either by the developer using the <code>js</code> module or by a third-party library.
+In this case, we do not want to break existing code.
+There is only a warning created in the case of an available <code>n4jsd</code> file and a <code>js</code> file still must be provided by the user.
+Having an <code>n4js</code> file is a completely different story; no <code>n4jsd</code> file is required, no <code>js</code> file is needed
+(since the transpiler creates one from the <code>n4js</code> file) and there is absolutely no reason to use the module dynamically.</p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_immutabilaty-of-imports"><a class="anchor" href="#_immutabilaty-of-imports"></a><a class="link" href="#_immutabilaty-of-imports">9.2.4.2. Immutabilaty of Imports</a></h5>
+<div class="paragraph">
+<p>Imports create always immutable bindings, c.f.
+[<a href="appendix_c_bibliography.html#ECMA15a">ECMA15a(p.8.1.1.5)</a>]
+<a href="http://www.ecma-international.org/ecma-262/6.0/index.html#sec-createimportbinding" class="bare">http://www.ecma-international.org/ecma-262/6.0/index.html#sec-createimportbinding</a></p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-137"></a><strong>Req. IDE-137:</strong> <a href="#Req-IDE-137">Immutable Import</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>Let <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>i</mi></math> be a binding to an imported element.
+It is an error if</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>i</mi></math> occurs on the left-hand side as the assignment-target of an assignment expression (this also includes any level in a destructuring pattern on the left-hand side),</p>
+</li>
+<li>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>i</mi></math> as a direct argument of a postfix operator (<code>i++</code>/<code>i--</code>),</p>
+</li>
+<li>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>i</mi></math> as a direct argument of a <code>delete</code> operator,</p>
+</li>
+<li>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>i</mi></math> as a direct argument of the <code>increment</code> or <code>decrement</code> unary operator (<code>i++</code>/<code>i--</code>)</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_export-statement"><a class="anchor" href="#_export-statement"></a><a class="link" href="#_export-statement">9.2.5. Export Statement</a></h4>
+<div class="paragraph">
+<p>Cf. ES6 import [<a href="appendix_c_bibliography.html#ECMA15a">ECMA15a(p.15.2.3)</a>]</p>
+</div>
+<h5 id="export-statement-syntax" class="discrete">Syntax</h5>
+<div class="paragraph">
+<p>Grammar of export declarations is defined as follows:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">ExportDeclaration:
+    {ExportDeclaration}
+    ExportDeclarationImpl
+;
+
+fragment ExportDeclarationImpl*:
+    'export' (
+        wildcardExport?='*' ExportFromClause Semi
+    |   ExportClause -&gt;ExportFromClause? Semi
+    |   exportedElement=ExportableElement
+    |   defaultExport?='default' (-&gt;exportedElement=ExportableElement | defaultExportedExpression=AssignmentExpression&lt;In=true,Yield=false&gt; Semi)
+    )
+;
+
+fragment ExportFromClause*:
+    'from' reexportedFrom=[types::TModule|ModuleSpecifier]
+;
+
+fragment ExportClause*:
+    '{'
+        (namedExports+=ExportSpecifier (',' namedExports+=ExportSpecifier)* ','?)?
+    '}'
+;
+
+ExportSpecifier:
+    element=IdentifierRef&lt;Yield=false&gt; ('as' alias=IdentifierName)?
+;
+
+ExportableElement:
+      N4ClassDeclaration&lt;Yield=false&gt;
+    | N4InterfaceDeclaration&lt;Yield=false&gt;
+    | N4EnumDeclaration&lt;Yield=false&gt;
+    | ExportedFunctionDeclaration&lt;Yield=false&gt;
+    | ExportedVariableStatement
+;</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>These are the properties of export declaration, which can be specified by the user:</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><code>exportedElement</code> </dt>
+<dd>
+<p>The element to be exported, can be a declaration or a variable/const statement.</p>
+</dd>
+</dl>
+</div>
+<div class="exampleblock">
+<div class="title">Example 96. Export</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">export public class A{}
+export interface B{}
+export function foo() {}
+export var a;
+export const c="Hello";</code></pre>
+</div>
+</div>
+</div>
+</div>
+<h5 id="export-statement-semantics" class="discrete">Semantics</h5>
+<div class="paragraph">
+<p>With regard to type inference, export statements are not handled at all.
+Only the exported element is inferred and the <code>export</code> keyword is ignored.</p>
+</div>
+<div class="paragraph">
+<p>In order to use types defined in other compilation units, these types have to be explicitly imported with an import statement.</p>
+</div>
+<div class="paragraph">
+<p>Imported namespaces cannot be exported.</p>
+</div>
+<div class="paragraph">
+<p>Declared elements (types, variables, functions) are usually only visible outside the declaring module if the elements are exported and imported (by the using module, cf. <a href="#_import-statement">Import Statement</a>).</p>
+</div>
+<div class="paragraph">
+<p>Some special components (runtime environment and libraries, cf. <a href="components.html#_runtime-environment-and-runtime-libraries">Runtime Environment and Runtime Libraries</a>, may export elements globally.
+This is done by annotating the export (or the whole module) with <code>@Global</code>, see <a href="plainjs.html#_global-definitions">Global Definitions</a> for details.</p>
+</div>
+<div class="paragraph">
+<p>By adding <code>default</code> after the keyword <code>export</code>, the identifiable element can be exported as ’the default’.
+This can then be imported from other modules via default imports (see <a href="#_import-statement">Import Statement</a>).</p>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div id="footer">
+<div id="footer-text">
+Version 0.9<br>
+Last updated 2019-08-07 15:02:40 CEST
+</div>
+</div>
+<!-- ************* docinfo-footer *************************************************************** -->
+<div class="Grid social" style="color:#d5dfea">
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <h2>Quick Links</h2>
+    <ul>
+      <li><a href="../downloads.html">Download</a></li>
+      <li><a href="../userguides/index.html">Documentation</a></li>
+      <li><a href="https://github.com/eclipse/n4js/">Source</a></li>
+      <li><a href="https://github.com/eclipse/n4js/issues">Issues</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="https://www.eclipse.org/forums/index.php/f/365/">Forum</a></li>
+      <li><a href="http://n4js.blogspot.de/">Blog</a></li>
+      <li><a href="https://dev.eclipse.org/mailman/listinfo/n4js-dev">Mailing List</a></li>
+      <li><a href="https://projects.eclipse.org/projects/technology.n4js">Eclipse Project Page</a></li>
+      <li><a href="https://twitter.com/n4jsdev">Tweets by n4jsdev</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="http://www.eclipse.org/">Eclipse Home</a></li>
+      <li><a href="http://www.eclipse.org/legal/privacy.php">Privacy Policy</a></li>
+      <li><a href="http://www.eclipse.org/legal/termsofuse.php">Terms of Use</a></li>
+      <li><a href="http://www.eclipse.org/legal/copyright.php">Copyright Agent</a></li>
+      <li><a href="http://www.eclipse.org/legal/">Legal</a></li>
+    </ul>
+  </div>
+  <div style="clear: both; height: 0; overflow: hidden;"></div>
+</div>
+
+<!-- ************* UI Scripts ************* -->
+<script type="text/javascript" src="scripts/back-to-top.js"></script>
+
+<script type="text/javascript" src="scripts/treeview.js"></script>
+<script type="text/javascript" src="scripts/toc.js"></script>
+
+<!-- ************* Prism.js Syntax Highlighting ************* -->
+<script src="scripts/prism.js"></script>
+
+<script type="text/javascript">
+	// Add the 'toclist' id for search function
+	$(".toc2 > ul").attr('id', 'toclist');
+	// Generate a Search input form
+	$("#toclist > li:first-of-type").before('<input type="text" id="pagesearch" onkeyup="search()" placeholder="Search for section...">');
+	$("#toclist > li:first-of-type").before('<i id="clear" class="fa fa-times-circle-o"></i>');
+	$("#clear").click(function(){
+	    $("#pagesearch").val('');
+	    search();
+	    $('.toc2 > ul').treeView('collapseAll');
+	});
+	// intialize Treeview.js
+	$(".toc2 > ul").treeView();
+	// Initialize Scrollspy
+</script>
+<!-- ************* docinfo-footer *************************************************************** -->
+</body>
+</html>
\ No newline at end of file
diff --git a/spec/styles/foundation.min.css b/spec/styles/foundation.min.css
new file mode 100644
index 0000000..a45c129
--- /dev/null
+++ b/spec/styles/foundation.min.css
@@ -0,0 +1 @@
+img,legend{border:0}body,figure{margin:0}body,table{background:#fff}#content:after,#footer:after,#footnotes:after,#header:after,.clearfix:after,.float-group:after,hr{clear:both}#toc,b.button:after,b.button:before,body,kbd,sub,sup{position:relative}#toc a,.vevent abbr,a,div.social>ul li{text-decoration:none}article,aside,details,figcaption,figure,footer,header,hgroup,main,nav,section,summary{display:block}audio,canvas,video{display:inline-block}audio:not([controls]){display:none;height:0}[hidden],template{display:none}script{display:none !important}html{font-family:sans-serif;-ms-text-size-adjust:100%;-webkit-text-size-adjust:100%}a:focus{outline:dotted thin}a:active,a:hover{outline:0}abbr[title]{border-bottom:1px dotted}b,strong{font-weight:700}dfn{font-style:italic}hr{-moz-box-sizing:content-box;box-sizing:content-box}mark{background:#ff0;color:#000}code,kbd,pre,samp{font-family:monospace, serif;font-size:1em}pre{white-space:pre-wrap}q{quotes:"\201C" "\201D" "\2018" "\2019"}sub,sup{font-size:75%;line-height:0;vertical-align:baseline}sup{top:-.5em}sub{bottom:-.25em}svg:not(:root){overflow:hidden}fieldset{border:1px solid silver;margin:0 2px;padding:.35em .625em .75em}legend{padding:0}button,input,select,textarea{font-family:inherit;font-size:100%;margin:0}button,input{line-height:normal}button,select{text-transform:none}button,html input[type=button],input[type=reset],input[type=submit]{-webkit-appearance:button;cursor:pointer}button[disabled],html input[disabled]{cursor:default}input[type=checkbox],input[type=radio]{box-sizing:border-box;padding:0}input[type=search]{-webkit-appearance:textfield;-moz-box-sizing:content-box;-webkit-box-sizing:content-box;box-sizing:content-box}input[type=search]::-webkit-search-cancel-button,input[type=search]::-webkit-search-decoration{-webkit-appearance:none}button::-moz-focus-inner,input::-moz-focus-inner{border:0;padding:0}textarea{overflow:auto;vertical-align:top;height:auto;min-height:50px}meta.foundation-mq-small{font-family:"only screen and (min-width: 500px)";width:500px}meta.foundation-mq-medium{font-family:"only screen and (min-width:1280px)";width:1280px}meta.foundation-mq-large{font-family:"only screen and (min-width:1440px)";width:1440px}.spread,select{width:100%}*,:after,:before{-moz-box-sizing:border-box;-webkit-box-sizing:border-box;box-sizing:border-box}body,html{font-size:100%}body{color:#595959;padding:0;font-family:"Helvetica Neue", Helvetica, Helvetica, Arial, sans-serif;font-weight:400;font-style:normal;line-height:1;cursor:auto max-width: 1280px;tab-size:4}a:hover{cursor:pointer}embed,img,object{max-width:100%;height:auto}embed,object{height:100%}#map_canvas embed,#map_canvas img,#map_canvas object,.map_canvas embed,.map_canvas img,.map_canvas object{max-width:none !important}.left{float:left !important}.right{float:right !important}.text-left{text-align:left !important}.text-right{text-align:right !important}.text-center{text-align:center !important}.text-justify{text-align:justify !important}.hide{display:none}img,object,svg{display:inline-block;vertical-align:middle}.antialiased,body{-webkit-font-smoothing:antialiased}img{-ms-interpolation-mode:bicubic}.center{margin-left:auto;margin-right:auto}#preamble>.sectionbody>.paragraph:first-of-type p,.paragraph.lead>p,p.lead{font-size:1.21875em;line-height:1.6}.admonitionblock td.content>.title,.audioblock>.title,.dlist>.title,.exampleblock>.title,.hdlist>.title,.imageblock>.title,.listingblock>.title,.literalblock>.title,.olist>.title,.openblock>.title,.paragraph>.title,.qlist>.title,.quoteblock>.title,.stemblock>.title,.subheader,.ulist>.title,.verseblock>.title,.videoblock>.title,table.tableblock>.title{line-height:1.4;color:#6f6f6f;font-weight:300;margin-top:.2em;margin-bottom:.5em}#toctitle,.sidebarblock>.content>.title,blockquote,dd,div,dl,dt,form,h1,h2,h3,h4,h5,h6,li,ol,p,pre,td,th,ul{margin:0;padding:0;direction:ltr}a{background:0 0;color:#2ba6cb;line-height:inherit}a:focus,a:hover{color:#2795b6}a img{border:none}p{font-family:inherit;font-weight:400;font-size:1em;line-height:1.6;margin-bottom:1.25em;text-rendering:optimizeLegibility}#toctitle,.admonitionblock>table td.icon .title,.sidebarblock>.content>.title,h1,h2,h3,h4,h5,h6{font-family:"Helvetica Neue", Helvetica, Helvetica, Arial, sans-serif}.vcard .fn,.vevent .summary,.vevent abbr,code,dl dt{font-weight:700}p aside{font-size:.875em;line-height:1.35;font-style:italic}#toctitle,.sidebarblock>.content>.title,h1,h2,h3,h4,h5,h6{font-weight:700;font-style:normal;color:#595959;text-rendering:optimizeLegibility;margin-top:1em;margin-bottom:.5em}dl,dl dd,ol,ul{margin-bottom:1.25em}#toctitle small,.sidebarblock>.content>.title small,h1 small,h2 small,h3 small,h4 small,h5 small,h6 small{font-size:60%;color:#6f6f6f;line-height:0}b,em,i,small,strong{line-height:inherit}h1{font-size:2.125em}h2{font-size:1.6875em}#toctitle,.sidebarblock>.content>.title,h3{font-size:1.375em}h4,h5{font-size:1.125em}h6{font-size:1em}hr{border:solid #ddd;border-width:1px 0 0;margin:1.25em 0 1.1875em;height:0}em,i{font-style:italic}small{font-size:60%}dl,ol,ul,ul li ol,ul li ul{font-size:1em}code{font-family:Consolas, "Liberation Mono", Courier, monospace;color:#7f0a0c}dl,ol,ul{line-height:1.6;list-style-position:outside;font-family:inherit}ol,ol.no-bullet,ul,ul.no-bullet{margin-left:1.5em}ol li ol,ol li ul,ul li ol,ul li ul{margin-left:1.25em;margin-bottom:0}ul.circle li ul,ul.disc li ul,ul.square li ul{list-style:inherit}#menubar ul,ul.inline,ul.inline>li,ul.no-bullet{list-style:none}ul.square{list-style-type:square}ul.circle{list-style-type:circle}ul.disc{list-style-type:disc}dl dt{margin-bottom:.3125em}.vcard,blockquote{margin:0 0 1.25em}abbr,acronym{text-transform:uppercase;font-size:90%;color:#222;border-bottom:1px dotted #ddd;cursor:help}abbr{text-transform:none}blockquote{padding:.5625em 1.25em 0 1.1875em;border-left:1px solid #ddd}blockquote cite{display:block;font-size:.8125em;color:#555}blockquote cite:before{content:"\2014 \0020"}blockquote cite a,blockquote cite a:visited{color:#555}blockquote,blockquote p{line-height:1.6;color:#6f6f6f}.vcard{display:inline-block;border:1px solid #ddd;padding:.625em .75em}.vcard li{margin:0;display:block}.vcard .fn{font-size:.9375em}.vevent abbr{cursor:auto;border:none;padding:0 .0625em}@media only screen and (min-width:500px){#toctitle,.sidebarblock>.content>.title,h1,h2,h3,h4,h5,h6{line-height:1.4}h1{font-size:2.75em}h2{font-size:2.3125em}#toctitle,.sidebarblock>.content>.title,h3{font-size:1.6875em}h4{font-size:1.4375em}}table{border-collapse:collapse;border-spacing:0;margin-bottom:1.25em;border:1px solid #ddd}table tfoot,table thead{background:#f5f5f5;font-weight:600}table tfoot tr td,table tfoot tr th,table thead tr td,table thead tr th{padding:.5em .625em .625em;font-size:inherit;color:#222;text-align:left}table tr td,table tr th{padding:.5625em .625em;font-size:inherit;color:#595959}table tr.alt,table tr.even,table tr:nth-of-type(even){background:#f9f9f9}table tbody tr td,table tfoot tr td,table tfoot tr th,table thead tr th,table tr td{display:table-cell;line-height:1.4}#toctitle,.sidebarblock>.content>.title,h1,h2,h3,h4,h5,h6{line-height:1.4}.clearfix:after,.clearfix:before,.float-group:after,.float-group:before{content:" ";display:table}:not(pre)>code{font-size:inherit;font-style:normal !important;letter-spacing:0;padding:0;line-height:inherit}pre,pre>code{line-height:1.4;color:#000;font-family:monospace, serif;font-weight:400}.keyseq{color:#555}kbd{font-family:Consolas, "Liberation Mono", Courier, monospace;display:inline-block;color:#222;font-size:.65em;line-height:1.45;background-color:#f7f7f7;border:1px solid #ccc;-webkit-border-radius:3px;border-radius:3px;-webkit-box-shadow:0 1px 0 rgba(0, 0, 0, .2), 0 0 0 .1em #fff inset;box-shadow:0 1px 0 rgba(0, 0, 0, .2), 0 0 0 .1em #fff inset;margin:0 .15em;padding:.2em .5em;vertical-align:middle;top:-.1em;white-space:nowrap}table.pyhltable td,td.valign-top,th.valign-top{vertical-align:top}.keyseq kbd:first-child{margin-left:0}.keyseq kbd:last-child{margin-right:0}.menu,.menuseq{color:#090909}b.button:after,b.button:before{top:-1px;font-weight:400}b.button:before{content:"[";padding:0 3px 0 2px}b.button:after{content:"]";padding:0 2px 0 3px}#content,#footer,#footnotes,#header{max-width:1300px;margin-right:80px;margin-top:0;margin-bottom:0;position:relative;padding-left:0;padding-right:.9375em;left:40px}#content:after,#content:before,#footer:after,#footer:before,#footnotes:after,#footnotes:before,#header:after,#header:before{content:" ";display:table}#content{margin-top:1.25em;padding-right:0;margin-right:115px}#content:before{content:none}#header>h1:first-child{color:#595959;margin-top:2.25rem;margin-bottom:0}#header>h1:first-child+#toc{margin-top:8px;border-top:1px solid #ddd}#header>h1:only-child,body.toc2 #header>h1:nth-last-child(2){border-bottom:1px solid #ddd;padding-bottom:8px}#header .details{border-bottom:1px solid #ddd;line-height:1.45;padding-top:.25em;padding-bottom:.25em;padding-left:.25em;color:#555;display:-ms-flexbox;display:-webkit-flex;display:flex;-ms-flex-flow:row wrap;-webkit-flex-flow:row wrap;flex-flow:row wrap}#header .details span:first-child{margin-left:-.125em}#header .details span.email a{color:#6f6f6f}#header .details br{display:none}#header .details br+span:before{content:"\00a0\2013\00a0"}#header .details br+span.author:before{content:"\00a0\22c5\00a0";color:#6f6f6f}#header .details br+span#revremark:before{content:"\00a0|\00a0"}#header #revnumber{text-transform:capitalize}#header #revnumber:after{content:"\00a0"}#content>h1:first-child:not([class]){color:#000;border-bottom:1px solid #ddd;padding-bottom:8px;margin-top:0;padding-top:1rem;margin-bottom:1.25rem}#toc ul li:before,div#faq li:before,div#features-nav li:before,div.ulist li:before{content:"";color:#244d82}#toc{border-bottom:1px solid #ddd;padding-bottom:.5em;left:0}#toc li{line-height:1.3334;margin-top:0;padding-left:5px}#toc ul li:before{margin-left:-.75em;margin-right:.4em}div.ulist li:before{position:absolute;font-size:x-large;line-height:1rem;margin:.2rem 0 -.75em -.75em}#faq,#features-nav{margin-bottom:20px;z-index:1;padding-left:2rem;border-left:1px solid #d3d3d3}#toctitle{color:#595959;font-size:1.2em;padding-left:1em}#faq{position:relative;right:9.3rem;top:9rem;left:45rem}@media only screen and (max-width:945px){div#faq{display:none}}#faq h2{font-size:25px;font-weight:600;margin-top:-8rem}div#faq li:before,div#features-nav li:before{position:absolute;font-size:x-large;margin-left:-.75em;margin-bottom:-.75em;margin-right:0;line-height:1rem}#features-nav{right:1rem;top:2rem;position:absolute}@media only screen and (max-width:993px){#features-nav{display:none}}#features-nav h2{font-size:25px;font-weight:600;margin-top:-1rem}#features-nav li{margin-top:.3rem}@media only screen and (min-width:500px){#toctitle{padding-top:0;font-size:1.375em}body.toc2{padding-left:2em;padding-right:1em}#toc.toc2{margin-top:0 !important;background-color:#f2f2f2;position:fixed;width:260px;left:0;top:0;border-right:1px solid #ddd;border-top-width:0 !important;border-bottom-width:0 !important;z-index:1000;padding:1.25em .25em 0;height:100%;overflow:auto}#toc.toc2 #toctitle{margin-top:0;margin-bottom:.8rem;font-size:1.2em;padding-left:1em}#toc.toc2>ul{font-size:.9em;margin-bottom:0}#toc.toc2 ul ul{margin-left:6px}#toc.toc2 ul.sectlevel0 ul.sectlevel1{padding-left:10px;margin-top:.5em;margin-bottom:.5em}body.toc2.toc-right{padding-left:2em;padding-right:2em}body.toc2.toc-right #toc.toc2{border-right-width:0;border-left:1px solid #ddd;left:auto;right:-260px}}body.toc2.toc-left #toc.toc2{left:0}@media only screen and (min-width:1000px){#toc.toc2 #toctitle,#toctitle{font-size:1.375em}#content{max-width:1260px}body.toc2{padding-left:260px;padding-right:2em}#toctitle{padding-top:0}#toc.toc2{width:260px}#toc.toc2>ul{font-size:.95em}#toc.toc2 ul ul{padding-left:0}body.toc2.toc-right{padding-left:2em;padding-right:2em}}#content #toc{border-style:solid;border-width:1px;border-color:#d9d9d9;margin-bottom:1.25em;padding:1.25em;background:#f2f2f2;-webkit-border-radius:0;border-radius:0}#content #toc>:first-child{margin-top:0}#footer,div.social{margin-top:2rem;color:#fff}#content #toc>:last-child{margin-bottom:0}#footer{padding:1.25em 1.25em 0}div.social{padding:1.25em 1.25em 0 30px}.exampleblock>.content>:first-child,.sidebarblock>:first-child{margin-top:0}div.social>ul li{color:#fff;line-height:1.44;font-size:1.2em;font-weight:800;font-style:bold;position:relative;list-style:none;display:inline}#bottomright{float:right}#footer-text{color:#ddd;line-height:1.44}.sect1{padding-bottom:.625em}@media only screen and (min-width:500px){.sect1{padding-bottom:1.25em}}.sect1+.sect1{border-top:1px solid #ddd}#content h1>a.anchor,#toctitle>a.anchor,.sidebarblock>.content>.title>a.anchor,h2>a.anchor,h3>a.anchor,h4>a.anchor,h5>a.anchor,h6>a.anchor{position:absolute;z-index:1001;width:1.5ex;margin-left:-1.5ex;display:block;text-decoration:none !important;visibility:hidden;text-align:center;font-weight:400}a.image,sup.footnote a,sup.footnoteref a{text-decoration:none}#content h1>a.anchor:before,#toctitle>a.anchor:before,.sidebarblock>.content>.title>a.anchor:before,h2>a.anchor:before,h3>a.anchor:before,h4>a.anchor:before,h5>a.anchor:before,h6>a.anchor:before{content:"\00A7";font-size:.85em;display:block;padding-top:.1em}#content h1:hover>a.anchor,#content h1>a.anchor:hover,#toctitle:hover>a.anchor,#toctitle>a.anchor:hover,.sidebarblock>.content>.title:hover>a.anchor,.sidebarblock>.content>.title>a.anchor:hover,h2:hover>a.anchor,h2>a.anchor:hover,h3:hover>a.anchor,h3>a.anchor:hover,h4:hover>a.anchor,h4>a.anchor:hover,h5:hover>a.anchor,h5>a.anchor:hover,h6:hover>a.anchor,h6>a.anchor:hover{visibility:visible}#content h1>a.link,#toctitle>a.link,.sidebarblock>.content>.title>a.link,h2>a.link,h3>a.link,h4>a.link,h5>a.link,h6>a.link{color:#595959;text-decoration:none}#content h1>a.link:hover,#toctitle>a.link:hover,.sidebarblock>.content>.title>a.link:hover,h2>a.link:hover,h3>a.link:hover,h4>a.link:hover,h5>a.link:hover,h6>a.link:hover{color:#151515}.audioblock,.imageblock,.listingblock,.literalblock,.stemblock,.videoblock{margin-bottom:1.25em}.admonitionblock td.content>.title,.audioblock>.title,.dlist>.title,.exampleblock>.title,.hdlist>.title,.imageblock>.title,.listingblock>.title,.literalblock>.title,.olist>.title,.openblock>.title,.paragraph>.title,.qlist>.title,.quoteblock>.title,.stemblock>.title,.ulist>.title,.verseblock>.title,.videoblock>.title,table.tableblock>.title{text-rendering:optimizeLegibility;text-align:left}table.tableblock>caption.title{white-space:nowrap;overflow:visible;max-width:0}#preamble>.sectionbody>.paragraph:first-of-type p,.paragraph.lead>p{color:#000}table.tableblock #preamble>.sectionbody>.paragraph:first-of-type p{font-size:inherit}.admonitionblock>table{border-collapse:separate;border:0;background:0 0;width:100%}.admonitionblock>table td.icon{text-align:center;width:80px}.admonitionblock>table td.icon img{max-width:none}.admonitionblock>table td.icon .title{font-weight:700;text-transform:uppercase}.admonitionblock>table td.content{padding-left:1.125em;padding-right:1.25em;border-left:1px solid #ddd;color:#555}.admonitionblock>table td.content>:last-child>:last-child{margin-bottom:0}.exampleblock>.content{border-style:solid;border-width:1px;border-color:#e6e6e6;margin-bottom:1.25em;padding:1.25em;background:#fff;-webkit-border-radius:0;border-radius:0}.exampleblock>.content .olist>ol>li:last-child>:last-child,.exampleblock>.content .qlist>ol>li:last-child>:last-child,.exampleblock>.content .ulist>ul>li:last-child>:last-child,.exampleblock>.content>:last-child,.exampleblock>.content>:last-child>:last-child,.sidebarblock>.content .olist>ol>li:last-child>:last-child,.sidebarblock>.content .qlist>ol>li:last-child>:last-child,.sidebarblock>.content .ulist>ul>li:last-child>:last-child,.sidebarblock>.content>:last-child>:last-child,.sidebarblock>:last-child,table.pyhltable{margin-bottom:0}.sidebarblock{position:absolute;border-style:solid;width:90px;border-width:1px;border-color:#d9d9d9;right:-90px;padding:.1rem;background:#f2f2f2;-webkit-border-radius:0;text-align:left;border-radius:5px}.sidebarblock>.content>.title{color:#6999d6;margin-top:0}.listingblock pre.CodeRay,.listingblock pre.prettyprint,.listingblock pre:not(.highlight),.listingblock pre[class=highlight],.listingblock pre[class^="highlight "],.literalblock pre{background:#eee}.sidebarblock .listingblock pre.CodeRay,.sidebarblock .listingblock pre.prettyprint,.sidebarblock .listingblock pre:not(.highlight),.sidebarblock .listingblock pre[class=highlight],.sidebarblock .listingblock pre[class^="highlight "],.sidebarblock .literalblock pre{background:#f2f1f1}.listingblock pre,.listingblock pre[class],.literalblock pre,.literalblock pre[class]{border:1px solid #ccc;-webkit-border-radius:0;border-radius:0;word-wrap:break-word;padding:.8em .8em .65em;font-size:.8125em}.listingblock pre.nowrap,.listingblock pre[class].nowrap,.literalblock pre.nowrap,.literalblock pre[class].nowrap{overflow-x:auto;white-space:pre;word-wrap:normal}#logo,ul.inline{overflow:hidden}@media only screen and (min-width:500px){.listingblock pre,.listingblock pre[class],.literalblock pre,.literalblock pre[class]{font-size:.90625em}}@media only screen and (min-width:1280px){.listingblock pre,.listingblock pre[class],.literalblock pre,.literalblock pre[class]{font-size:1em}}.literalblock.output pre{color:#eee;background-color:#000}.listingblock pre.highlightjs{padding:0}.listingblock pre.highlightjs>code{padding:.8em .8em .65em;-webkit-border-radius:0;border-radius:0}.listingblock>.content{position:relative}.listingblock.terminal pre .command:before{content:attr(data-prompt);padding-right:.5em;color:#999}.listingblock.terminal pre .command:not([data-prompt]):before{content:"$"}table.pyhltable{border-collapse:separate;border:0;background:0 0}table.pyhltable td{padding-top:0;padding-bottom:0;line-height:1.4}table.pyhltable td.code{padding-left:.75em;padding-right:0}pre.pygments .lineno,table.pyhltable td:not(.code){color:#999;padding-left:0;padding-right:.5em;border-right:1px solid #ddd}pre.pygments .lineno{display:inline-block;margin-right:.25em}table.pyhltable .linenodiv{background:0 0 !important;padding-right:0 !important}.quoteblock{margin:0 1em 1.25em 1.5em;display:table}.quoteblock .attribution br,.quoteblock .quoteblock blockquote:before,.verseblock .attribution br{display:none}.quoteblock>.title{margin-left:-1.5em;margin-bottom:.75em}.quoteblock blockquote,.quoteblock blockquote p{color:#6f6f6f;font-size:1.15rem;line-height:1.75;word-spacing:.1em;letter-spacing:0;font-style:italic;text-align:justify}.quoteblock blockquote{margin:0;padding:0;border:0}.quoteblock blockquote:before{content:"\201c";float:left;font-size:2.75em;font-weight:700;line-height:.6em;margin-left:-.6em;color:#6f6f6f;text-shadow:0 1px 2px rgba(0, 0, 0, .1)}.quoteblock blockquote>.paragraph:last-child p{margin-bottom:0}.quoteblock .attribution{margin-top:.5em;margin-right:.5ex;text-align:right}.quoteblock .quoteblock{margin-left:0;margin-right:0;padding:.5em 0;border-left:3px solid #555}.quoteblock .quoteblock blockquote{padding:0 0 0 .75em}.verseblock{margin:0 1em 1.25em}.verseblock pre{font-family:"Open Sans", "DejaVu Sans", sans;font-size:1.15rem;color:#6f6f6f;font-weight:300;text-rendering:optimizeLegibility}.verseblock pre strong{font-weight:400}.verseblock .attribution{margin-top:1.25rem;margin-left:.5ex}.quoteblock .attribution,.verseblock .attribution{font-size:.8125em;line-height:1.45;font-style:italic}.quoteblock .attribution cite,.verseblock .attribution cite{display:block;letter-spacing:-.025em;color:#555}.quoteblock.abstract{margin:0 0 1.25em;display:block}dl dd:last-child,dl dd:last-child>:last-child,table.tableblock td>.paragraph:last-child p>p:last-child,table.tableblock td>p:last-child,table.tableblock th>p:last-child{margin-bottom:0}.quoteblock.abstract blockquote,.quoteblock.abstract blockquote p{text-align:left;word-spacing:0}.quoteblock.abstract blockquote p:first-of-type:before,.quoteblock.abstract blockquote:before{display:none}table.tableblock{max-width:100%;border-collapse:separate}table.tableblock,td.tableblock,th.tableblock{border:0 solid #ddd}table.grid-all td.tableblock,table.grid-all th.tableblock{border-width:0 1px 1px 0}table.grid-all tfoot>tr>td.tableblock,table.grid-all tfoot>tr>th.tableblock{border-width:1px 1px 0 0}table.grid-cols td.tableblock,table.grid-cols th.tableblock{border-width:0 1px 0 0}table.grid-all *>tr>.tableblock:last-child,table.grid-cols *>tr>.tableblock:last-child{border-right-width:0}table.grid-rows td.tableblock,table.grid-rows th.tableblock{border-width:0 0 1px}table.grid-all tbody>tr:last-child>td.tableblock,table.grid-all tbody>tr:last-child>th.tableblock,table.grid-all thead:last-child>tr>th.tableblock,table.grid-rows tbody>tr:last-child>td.tableblock,table.grid-rows tbody>tr:last-child>th.tableblock,table.grid-rows thead:last-child>tr>th.tableblock{border-bottom-width:0}table.grid-rows tfoot>tr>td.tableblock,table.grid-rows tfoot>tr>th.tableblock{border-width:1px 0 0}table.frame-all{border-width:1px}table.frame-sides{border-width:0 1px}table.frame-topbot{border-width:1px 0}td.halign-left,th.halign-left{text-align:left}td.halign-right,th.halign-right{text-align:right}td.halign-center,th.halign-center{text-align:center}td.valign-bottom,th.valign-bottom{vertical-align:bottom}td.valign-middle,th.valign-middle{vertical-align:middle}table tfoot th,table thead th{font-weight:700}tbody tr th{display:table-cell;line-height:1.4;background:#f5f5f5}ul.inline>li,ul.inline>li>*{display:block}tbody tr th,tbody tr th p,tfoot tr th,tfoot tr th p{color:#222;font-weight:700}p.tableblock>code:only-child{background:0 0;padding:0}p.tableblock{font-size:1em}td>div.verse{white-space:pre}ol{margin-left:1.75em}ul li ol{margin-left:1.5em}dl dd{margin-left:1.125em}.olist .olist,.olist .ulist,.ulist .olist,.ulist .ulist,ol dd,ol>li p,ul dd,ul>li p{margin-bottom:.625em}ol.unnumbered,ul.checklist,ul.none,ul.unstyled{list-style-type:none}ol.unnumbered,ul.checklist,ul.unstyled{margin-left:.625em}ul.checklist li>p:first-child>.fa-check-square-o:first-child,ul.checklist li>p:first-child>.fa-square-o:first-child{width:1em;font-size:.85em}ul.checklist li>p:first-child>input[type=checkbox]:first-child{width:1em;position:relative;top:1px}ul.inline{margin:0 0 .625em -1.375em;padding:0}ul.inline>li{float:left;margin-left:1.375em}.conum[data-value],.th,.thumb,a.image{display:inline-block}.unstyled dl dt{font-weight:400;font-style:normal}ol.arabic{list-style-type:decimal}ol.decimal{list-style-type:decimal-leading-zero}ol.loweralpha{list-style-type:lower-alpha}ol.upperalpha{list-style-type:upper-alpha}ol.lowerroman{list-style-type:lower-roman}ol.upperroman{list-style-type:upper-roman}ol.lowergreek{list-style-type:lower-greek}.colist>table,.hdlist>table{border:0;background:0 0}.colist>table>tbody>tr,.hdlist>table>tbody>tr{background:0 0}td.hdlist1,td.hdlist2{vertical-align:top;padding:0 .625em}td.hdlist1{font-weight:700;padding-bottom:1.25em}.listingblock+.colist,.literalblock+.colist{margin-top:-.5em}.colist>table tr>td:first-of-type{padding:0 .75em;line-height:1}.colist>table tr>td:last-of-type{padding:.25em 0}.th,.thumb{line-height:0;border:4px solid #fff;-webkit-box-shadow:0 0 0 1px #ddd;box-shadow:0 0 0 1px #ddd}.imageblock.left,.imageblock[style*="float: left"]{margin:.25em .625em 1.25em 0}.imageblock.right,.imageblock[style*="float: right"]{margin:.25em 0 1.25em .625em}.imageblock>.title{margin-bottom:0}.imageblock.th,.imageblock.thumb{border-width:6px}.imageblock.th>.title,.imageblock.thumb>.title{padding:0 .125em}.image.left,.image.right{margin-top:.25em;margin-bottom:.25em;display:inline-block;line-height:0}.image.left{margin-right:.625em}.image.right{margin-left:.625em}a.image object{pointer-events:none}sup.footnote,sup.footnoteref{font-size:.875em;position:static;vertical-align:super}#logo,#menubar,#menubar>ul>li,#menubar>ul>li::after{position:relative}sup.footnote a:active,sup.footnoteref a:active{text-decoration:underline}#footnotes{padding-top:.75em;padding-bottom:.75em;margin-bottom:.625em}#footnotes hr{width:20%;min-width:6.25em;margin:-.25em 0 .75em;border-width:1px 0 0}#footnotes .footnote{padding:0 .375em .2em .225em;line-height:1.3334;font-size:.875em;margin-left:1.2em;text-indent:-1.05em;margin-bottom:.2em}#footnotes .footnote a:first-of-type{font-weight:700;text-decoration:none}#footnotes .footnote:last-of-type{margin-bottom:0}#content #footnotes{margin-top:-.625em;margin-bottom:0;padding:.75em 0}.gist .file-data>table{border:0;background:#fff;width:100%;margin-bottom:0}.gist .file-data>table td.line-data{width:99%}div.unbreakable{page-break-inside:avoid}.big{font-size:larger}.small{font-size:smaller}.x-small{font-size:x-small}.xx-small{font-size:xx-small}.x-large{font-size:x-large}.xx-large{font-size:xx-large}.underline{text-decoration:underline}.overline{text-decoration:overline}.line-through{text-decoration:line-through}.aqua{color:#00bfbf}.aqua-background{background-color:#00fafa}.black{color:#000}.black-background{background-color:#000}.blue{color:#0000bf}.blue-background{background-color:#0000fa}.fuchsia{color:#bf00bf}.fuchsia-background{background-color:#fa00fa}.gray{color:#606060}.gray-background{background-color:#7d7d7d}.green{color:#006000}.green-background{background-color:#007d00}.lime{color:#00bf00}.lime-background{background-color:#00fa00}.maroon{color:#600000}.maroon-background{background-color:#7d0000}.navy{color:#000060}.navy-background{background-color:#00007d}.olive{color:#606000}.olive-background{background-color:#7d7d00}.purple{color:#600060}.purple-background{background-color:#7d007d}.red{color:#bf0000}.red-background{background-color:#fa0000}.silver{color:#909090}.silver-background{background-color:#bcbcbc}.teal{color:#006060}.teal-background{background-color:#007d7d}.white{color:#bfbfbf}.white-background{background-color:#fafafa}.yellow{color:#bfbf00}.yellow-background{background-color:#fafa00}span.icon>.fa{cursor:default}.admonitionblock td.icon [class^="fa icon-"]{font-size:2.5em;text-shadow:1px 1px 2px rgba(0, 0, 0, .5);cursor:default}#clear,.treeview>li:hover{cursor:pointer}.admonitionblock td.icon .icon-note:before{content:"\f05a";color:#207c98}.admonitionblock td.icon .icon-tip:before{content:"\f0eb";text-shadow:1px 1px 2px rgba(155, 155, 0, .8);color:#111}.admonitionblock td.icon .icon-warning:before{content:"\f071";color:#bf6900}.admonitionblock td.icon .icon-caution:before{content:"\f06d";color:#bf3400}.admonitionblock td.icon .icon-important:before{content:"\f06a";color:#bf0000}.conum[data-value],.conum[data-value] *{color:#fff !important}.conum[data-value]{background-color:#222;-webkit-border-radius:100px;border-radius:100px;text-align:center;font-size:.75em;width:1.67em;height:1.67em;line-height:1.67em;font-family:"Open Sans", "DejaVu Sans", sans-serif;font-style:normal;font-weight:700}#menu,.conum:not([data-value]):empty,.conum[data-value]+b{display:none}.conum[data-value]:after{content:attr(data-value)}pre .conum[data-value]{position:relative;top:-.125em}b.conum *{color:inherit !important}.listingblock pre,.literalblock pre{background:#eee}div#remarks.ulist{max-width:70%}@media only screen and (max-width:800px){a#bottomright{visibility:hidden}#preamble>.sectionbody>.paragraph:first-of-type p,.paragraph.lead>p,.sectionbody.paragraph{max-width:100%}}#div.paragraph.faq-intro{max-width:66.66%}div.slicknav_menu{padding-top:5px;padding-right:15px;margin-left:200px;text-align:right;display:none;right:10px;font-size:1rem;color:#fff;padding-bottom:2rem;background:url(logo.png) 100px 0 no-repeat}span.slicknav_menutxt{margin-right:-20px;color:#fff}div.slicknav_menu a.scroll:first-of-type{color:#F7D425;font-size:120%;font-weight:600}div.slicknav_menu ul li a{color:#fff}div.slicknav_menu a:hover,div.slicknav_menu ul li a:hover{color:#F7D425}div.slicknav_menu a,div.slicknav_menu a:visited,li.slicknav_parent.slicknav_open{color:#fff}a.slicknav_btn{padding:1rem}@media screen and (max-width:890px){div.slicknav_menu{display:block;color:#fff}#mobile-banner{display:block}}@media screen and (max-width:470px){div.slicknav_menu ul:first-of-type{margin-top:1.5rem}div.slicknav_menu ul li{color:#fff}div.slicknav_menu ul li:hover{color:#F7D425}}div.slicknav_menu li:last-of-type{padding-bottom:.7rem}.banner{height:1rem;padding-right:2rem;max-height:1rem;max-width:50%;vertical-align:middle}@media (max-width:800px){.banner{flex-basis:66.66%;max-width:25%;margin:1rem}}#menubar ul{margin:0;padding:0 10px;white-space:nowrap;line-height:1.2rem}#menubar a,#menubar li{margin:0;padding:0}#menubar a{text-decoration:none}#menubar li{margin-left:0}#menubar{height:90px;max-width:1280px;margin-left:50px;color:#fff;font-size:1.9rem;border-bottom:#595959;border-bottom:2px solid #ddd}#menubar img{padding-left:45px;margin-top:15px;padding-top:.2rem}#menubar>ul>li{display:inline-block;margin:.2rem;z-index:10000;flex-basis:66.666%;font-weight:700}@media only screen and (max-width:500px){#menubar,#menubar>ul>li{visibility:hidden;display:none}#toc.toc2{display:none}}@media only screen and (max-width:500px){body.toc2.toc-right #tocbutton{visibility:hidden}#content,#footer,#footnotes,#header{margin-left:0;left:0}body.toc2{padding-left:20px;left:0}}@media only screen and (max-width:500px){#menubar{display:none}}#logo{margin-top:-55px;left:5px;top:10px}#menubar>ul>li::after{content:" · ";top:3px;padding-left:3px;font-weight:400}#menubar>ul>li:last-of-type::after{content:none}#menubar>ul>li>a{font-size:1.2rem;line-height:50px;font-weight:400;webkit-transition:color .15s;margin-left:0;-moz-transition:color .15s;-o-transition:color .15s;transition:color .15s;white-space:nowrap;-webkit-font-smoothing:auto;letter-spacing:-.01em;text-align:right}#iconTree li,#toc>ul>li>a,body.home li.home,body.tech li.tech{font-weight:700}#menubar>ul{margin-right:12px;margin-top:1px}#menubar>ul>li>a:hover{color:#F7D425}#menubar>ul>li>ul{opacity:0;visibility:hidden;padding:18px 0 20px;background-color:#FFF;text-align:left;position:absolute;top:55px;left:50%;margin-left:-90px;-webkit-transition:all .3s .1s;-moz-transition:all .3s .1s;-o-transition:all .3s .1s;transition:all .3s .1s;-webkit-border-radius:5px;-moz-border-radius:5px;border-radius:5px;-webkit-box-shadow:0 1px 3px rgba(0, 0, 0, .4);-moz-box-shadow:0 1px 3px rgba(0, 0, 0, .4);box-shadow:0 1px 3px rgba(0, 0, 0, .4)}#menubar>li li{width:100%}#menubar>ul>li:hover>ul{opacity:1;top:65px;visibility:visible}#menubar>ul>li>ul:before{content:'';display:block;border-color:transparent transparent #FFF;border-style:solid;border-width:10px;position:absolute;top:-20px;left:10%;margin-left:-10px}#menubar>ul ul>li{position:relative}#menubar ul ul a{color:#323232;font-family:ITC Officina Serif W01, sans-serif, Verdana, 'Lucida Grande';font-size:17px;background-color:#FFF;padding:5px 8px 7px 16px;display:block;-webkit-transition:background-color .1s;-moz-transition:background-color .1s;-o-transition:background-color .1s;transition:background-color .1s}#menubar ul ul ul{visibility:hidden;opacity:0;position:absolute;top:-16px;left:206px;padding:16px 0 20px;background-color:#527AA3;text-align:left;width:160px;-webkit-transition:all .3s;-moz-transition:all .3s;-o-transition:all .3s;transition:all .3s;-webkit-border-radius:5px;-moz-border-radius:5px;border-radius:5px;-webkit-box-shadow:0 1px 3px rgba(0, 0, 0, .4);-moz-box-shadow:0 1px 3px rgba(0, 0, 0, .4);box-shadow:0 1px 3px rgba(0, 0, 0, .4)}a.back-to-top,body.toc2.toc-right a.back-to-top{width:25px;height:25px;text-indent:-9999px;position:fixed;bottom:20px}#menubar ul ul>li:hover>ul{opacity:1;left:196px;visibility:visible}#menubar ul ul a:hover{background-color:#244D82;color:#F7D425}a.back-to-top{display:none;z-index:999;right:20px;background:url(up-arrow.png) center 43% no-repeat #2ba6cb;-webkit-border-radius:30px;-moz-border-radius:30px;border-radius:30px}a:hover.back-to-top{background-color:#F7D425}#tocbutton{visibility:hidden}#tocbuttonbars.fa.fa-bars{z-index:1000;right:0}#tocbutton:hover{background:url(yellowbars.png) center 50% no-repeat}body.toc2.toc-right a.back-to-top{z-index:1001;right:90px;background:url(up-arrow.png) center 43% no-repeat #2ba6cb;-webkit-border-radius:30px;-moz-border-radius:30px;border-radius:30px}body.toc2.toc-left #tocbutton,body.toc2.toc-right #tocbutton{visibility:visible;width:25px;text-indent:-9999px;border:none;height:25px;position:fixed;z-index:998}body.toc2.toc-right #tocbutton{right:25px;top:5px;background:url(yellowbars.png) center 50% no-repeat}body.toc2.toc-left #tocbutton{left:25px;top:25px;background:url(bars-blue.png) center 50% no-repeat}body.toc2.toc-right #tocbutton:hover{background:url(yellowbars.png) center 50% no-repeat}#pagesearch,.treeview li{background-repeat:no-repeat}body.toc2.toc-right a:hover.back-to-top{background-color:#F7D425}@media only screen and (max-width:1000px){#toc.toc2{display:none}}@media only screen and (max-width:500px){body.toc2.toc-left #tocbutton{visibility:hidden}#toc.toc2{width:100%;left:0}#content,#footer,#footnotes,#header{margin-left:0;margin-right:50px}}@media only screen and (max-width:1462px){a.back-to-top{left:90%}}div.openblock.definition{border:1px solid #aaa;margin-bottom:1rem;background-color:#f0f8ff;border-radius:10px;padding:1rem}.requirement{border:1px solid #aaa;margin-bottom:1rem;background-color:#f5f5f5;border-radius:10px;padding:1rem}.bibliography .content .paragraph p:first-child::before{color:#777;content:"[" attr(id) "] "}.bibliography .content .paragraph{padding-left:6em;text-indent:-6em}.hold,.todo{padding:12px;margin-bottom:15px}.todo{color:#dc143c;border:dotted #dc143c;border-width:2px;border-radius:15px;background-color:#fff8dc}.todo::before{content:"TODO"}.hold{color:#ff8c00;border:dotted #ff8c00;border-width:2px;border-radius:15px;background-color:#f5f5f5}.hold::before{content:"ON HOLD"}#toc>ul>li>a{color:#595959;font-size:medium}#toc a:hover,.active,.found{color:#000}#iconTree li,#toclist>li>ul>li{font-size:90%}.treeview,.treeview ul{list-style-type:none;overflow:hidden}.treeview li{text-indent:10%;margin-top:0;padding:.2em 0 0;line-height:20px;background-size:16px 16px;background-position-y:4px}#iconTree li{line-height:15px;background-size:16px 16px}.treeview li.contains-items{font-weight:700;background-image:url(expand.png);background-size:16px 16px}.treeview li.items-expanded{font-weight:400;background-image:url(collapse.png);background-size:16px 16px}.active,.found,.items-expanded>a::first-of-type{font-weight:700}.treview-dotted-lines li{margin-top:.4em !important}.treview-dotted-lines li.items-expanded li{font-weight:700;border-left:1px dotted #444;border-bottom:1px dotted #444;width:60%}.treeview span.has-node-icon{text-indent:2%;margin-top:.2em;padding:.15em 0 .5em 1em;line-height:22px;background-repeat:no-repeat;background-size:24px 24px}.treeview span{padding:5px}.treeview span:not(.has-node-icon):hover{background-color:rgba(246, 246, 246, .7)}#collapsetoc{outline:0;display:none;width:25px;height:25px;text-indent:-9999px;position:fixed;z-index:998;border:none;left:25px;top:55px;background:url(arrow-down.png) center 50% no-repeat}#collapsetoc.inactive{background-image:url(arrow-right.png)}.active{border-right:3px solid #2ba6cb}#toc{margin-top:0}#toc>ul{margin-left:0;padding-left:0}#toc ul.sectlevel0>li>a{font-style:italic}#toc ul.sectlevel0 ul.sectlevel1{margin:0}#toc ul{font-family:"Helvetica Neue", Helvetica, Helvetica, Arial, sans-serif;list-style-type:none}#toc a{color:#595959}#toc a:active{text-decoration:underline}#pagesearch{background-image:url(searchicon.png);background-position:5px 5px;width:100%;font-size:16px;padding:6px 10px 6px 40px;border:1px solid #ddd;margin-bottom:12px}#clear{position:absolute;right:10px;top:72px;bottom:0;height:14px;font-size:14px;color:#ccc}
diff --git a/spec/styles/n4jsspec-adoc.css b/spec/styles/n4jsspec-adoc.css
new file mode 100644
index 0000000..598cae4
--- /dev/null
+++ b/spec/styles/n4jsspec-adoc.css
@@ -0,0 +1,1292 @@
+@import url("backtotop.css");
+
+/* ========================================================================== HTML5 display definitions ========================================================================== */
+/** Correct `block` display not defined in IE 8/9. */
+@import url(https://fast.fonts.net/cssapi/20974f8a-0939-4574-aef9-681eda2faca8.css);
+article, aside, details, figcaption, figure, footer, header, hgroup, main, nav, section, summary { display: block; }
+
+/** Correct `inline-block` display not defined in IE 8/9. */
+audio, canvas, video { display: inline-block; }
+
+/** Prevent modern browsers from displaying `audio` without controls. Remove excess height in iOS 5 devices. */
+audio:not([controls]) { display: none; height: 0; }
+
+/** Address `[hidden]` styling not present in IE 8/9. Hide the `template` element in IE, Safari, and Firefox < 22. */
+[hidden], template { display: none; }
+
+script { display: none !important; }
+
+/* ========================================================================== Base ========================================================================== */
+/** 1. Set default font family to sans-serif. 2. Prevent iOS text size adjust after orientation change, without disabling user zoom. */
+html { /* 1 */ -ms-text-size-adjust: 100%; /* 2 */ -webkit-text-size-adjust: 100%; /* 2 */ background-color: #D5DFEA; }
+
+/** Remove default margin. */
+body { margin: 0; background-color: #D5DFEA; font-family:sans-serif; font-weight: 400} /* add margin-right 0 here for mobile*/
+
+/* ========================================================================== Links ========================================================================== */
+/** Remove the gray background color from active links in IE 10. */
+a { background: transparent; }
+
+/** Address `outline` inconsistency between Chrome and other browsers. */
+a:focus { outline: thin dotted; }
+
+/** Improve readability when focused and also mouse hovered in all browsers. */
+a:active, a:hover { outline: 0; }
+
+/* ========================================================================== Typography ========================================================================== */
+/** Address variable `h1` font-size and margin within `section` and `article` contexts in Firefox 4+, Safari 5, and Chrome. */
+h1 { font-size: 2em; margin: 0.67em 0; }
+
+/** Address styling not present in IE 8/9, Safari 5, and Chrome. */
+abbr[title] { border-bottom: 1px dotted; }
+
+/** Address style set to `bolder` in Firefox 4+, Safari 5, and Chrome. */
+b, strong { font-weight: 600; }
+
+/** Address styling not present in Safari 5 and Chrome. */
+dfn { font-style: italic; }
+
+/** Address differences between Firefox and other browsers. */
+hr { -moz-box-sizing: content-box; box-sizing: content-box; height: 0; }
+
+/** Address styling not present in IE 8/9. */
+mark { background: #ff0; color: #000; }
+
+/** Correct font family set oddly in Safari 5 and Chrome. */
+code, kbd, pre, samp { font-family: Fira Mono, monospace, serif; font-size: 1em; }
+
+/** Improve readability of pre-formatted text in all browsers. */
+pre { white-space: pre-wrap; }
+
+/** Set consistent quote types. */
+q { quotes: "\201C" "\201D" "\2018" "\2019"; }
+
+/** Address inconsistent and variable font size in all browsers. */
+small { font-size: 80%; }
+
+/** Prevent `sub` and `sup` affecting `line-height` in all browsers. */
+sub, sup { font-size: 75%; line-height: 0; position: relative; vertical-align: baseline; }
+
+sup { top: -0.5em; }
+
+sub { bottom: -0.25em; }
+
+/* ========================================================================== Embedded content ========================================================================== */
+/** Remove border when inside `a` element in IE 8/9. */
+img { border: 0; }
+
+/** Correct overflow displayed oddly in IE 9. */
+svg:not(:root) { overflow: hidden; }
+
+/* ========================================================================== Figures ========================================================================== */
+/** Address margin not present in IE 8/9 and Safari 5. */
+figure { margin: 0; }
+
+/* ========================================================================== Forms ========================================================================== */
+/** Define consistent border, margin, and padding. */
+fieldset { border: 1px solid #c0c0c0; margin: 0 2px; padding: 0.35em 0.625em 0.75em; }
+
+/** 1. Correct `color` not being inherited in IE 8/9. 2. Remove padding so people aren't caught out if they zero out fieldsets. */
+legend { border: 0; /* 1 */ padding: 0; /* 2 */ }
+
+/** 1. Correct font family not being inherited in all browsers. 2. Correct font size not being inherited in all browsers. 3. Address margins set differently in Firefox 4+, Safari 5, and Chrome. */
+button, input, select, textarea { font-family: inherit; /* 1 */ font-size: 100%; /* 2 */ margin: 0; /* 3 */ }
+
+/**
+#tocbutton {
+	top: 0;
+	left: 13rem;
+	position:fixed;
+	z-index: 1000;
+}
+*/
+/** Address Firefox 4+ setting `line-height` on `input` using `!important` in the UA stylesheet. */
+button, input { line-height: normal; }
+
+/** Address inconsistent `text-transform` inheritance for `button` and `select`. All other form control elements do not inherit `text-transform` values. Correct `button` style inheritance in Chrome, Safari 5+, and IE 8+. Correct `select` style inheritance in Firefox 4+ and Opera. */
+button, select { text-transform: none; }
+
+/** 1. Avoid the WebKit bug in Android 4.0.* where (2) destroys native `audio` and `video` controls. 2. Correct inability to style clickable `input` types in iOS. 3. Improve usability and consistency of cursor style between image-type `input` and others. */
+button, html input[type="button"], input[type="reset"], input[type="submit"] { -webkit-appearance: button; /* 2 */ cursor: pointer; /* 3 */ }
+
+/** Re-set default cursor for disabled elements. */
+button[disabled], html input[disabled] { cursor: default; }
+
+/** 1. Address box sizing set to `content-box` in IE 8/9. 2. Remove excess padding in IE 8/9. */
+input[type="checkbox"], input[type="radio"] { box-sizing: border-box; /* 1 */ padding: 0; /* 2 */ }
+
+/** 1. Address `appearance` set to `searchfield` in Safari 5 and Chrome. 2. Address `box-sizing` set to `border-box` in Safari 5 and Chrome (include `-moz` to future-proof). */
+input[type="search"] { -webkit-appearance: textfield; /* 1 */ -moz-box-sizing: content-box; -webkit-box-sizing: content-box; /* 2 */ box-sizing: content-box; }
+
+/** Remove inner padding and search cancel button in Safari 5 and Chrome on OS X. */
+input[type="search"]::-webkit-search-cancel-button, input[type="search"]::-webkit-search-decoration { -webkit-appearance: none; }
+
+/** Remove inner padding and border in Firefox 4+. */
+button::-moz-focus-inner, input::-moz-focus-inner { border: 0; padding: 0; }
+
+/** 1. Remove default vertical scrollbar in IE 8/9. 2. Improve readability and alignment in all browsers. */
+textarea { overflow: auto; /* 1 */ vertical-align: top; /* 2 */ }
+
+/* ========================================================================== Tables ========================================================================== */
+/** Remove most spacing between table cells. */
+table { border-collapse: collapse; border-spacing: 0; }
+
+meta.foundation-mq-small { font-family: "only screen and (min-width: 768px)"; width: 768px; }
+
+meta.foundation-mq-medium { font-family: "only screen and (min-width:1280px)"; width: 1280px; }
+
+meta.foundation-mq-large { font-family: "only screen and (min-width:1440px)"; width: 1440px; }
+
+*, *:before, *:after { -moz-box-sizing: border-box; -webkit-box-sizing: border-box; box-sizing: border-box; }
+
+html, body {  background-color:#527AA3; }
+
+body {  background: white; color: #222222;   padding: ; margin: 0; font-family:sans-serif, Helvetica, Arial, sans-serif; font-weight: 400; font-style: normal; position: relative; cursor: auto; padding-left: 2rem; padding-right: 2rem;}
+
+
+a:hover { cursor: pointer; }
+
+img, object, embed {  height: auto; max-width: 90%; }
+
+
+object, embed { height: 100%; }
+
+img { -ms-interpolation-mode: bicubic; }
+
+#map_canvas img, #map_canvas embed, #map_canvas object, .map_canvas img, .map_canvas embed, .map_canvas object { max-width: none !important; }
+
+.left { float: left !important; }
+
+.right { float: right !important; }	
+
+.text-left { text-align: left !important; }
+
+.text-right { text-align: right !important; }
+
+.text-center { text-align: center !important; }
+
+.text-justify { text-align: justify !important; }
+
+.hide { display: none; }
+
+.antialiased, body { -webkit-font-smoothing: antialiased; }
+
+img { display: inline-block; vertical-align: baseline; }
+
+textarea { height: auto; min-height: 50px; }
+
+select { width: 100%; }
+
+object, svg { display: inline-block; vertical-align: middle; }
+
+.center { margin-left: auto; margin-right: auto; }
+
+.spread { width: 100%; margin-right: 2rem; }
+
+p.lead, .paragraph.lead > p, #preamble > .sectionbody > .paragraph:first-of-type p { font-size: 1em; line-height: 1.6;  }
+
+
+/* Typography padding etc */
+.subheader, .admonitionblock td.content > .title, .audioblock > .title, .exampleblock > .title, .imageblock > .title, .listingblock > .title, .literalblock > .title, .stemblock > .title, .openblock > .title, .paragraph > .title, .quoteblock > .title, table.tableblock > .title, .verseblock > .title, .videoblock > .title, .dlist > .title, .olist > .title, .ulist > .title, .qlist > .title, .hdlist > .title { line-height: 2.4; color: #132445; font-weight: 400; margin-top: 0em; margin-bottom: 0.5em;  }
+
+
+/* Typography resets */
+div, dl, dt, dd, ul, ol, li, h1, h2, h3, #toctitle, .sidebarblock > .content > .title, h4, h5, h6, pre, form, p, blockquote, th, td { margin: 0; padding: 0; direction: ltr; }
+div.openblock.partintro, div.sectionbody.paragraph {font-weight: 500;  line-height: 1.4; margin-bottom: 1em; }
+div.sect1 {
+	padding-top: 1rem;
+	padding-right: 1rem;
+}
+
+div.paragraph.faq-intro {max-width: 66%;}
+
+
+/* Default Link Styles */
+a { color: #6999d6; text-decoration: none; line-height: inherit;  }
+a:hover, a:focus { color: #132445; }
+a img { border: none; }
+
+
+/* Grey links with black transition 
+
+a { color: #2ba6cb; text-decoration: none; line-height: inherit; color: rgba(0,0,0,.3); transition: .2s; }
+a:active, a:hover, a:focus { color: #212121; }
+a img { border: none; }
+
+*/
+
+
+
+/* Default paragraph styles */
+p { font-family:sans-serif; font-weight: 400; font-size: 1.2rem; line-height: 1.4; padding-bottom: 0.5em;    }
+p aside { font-size: 0.575em; line-height: 1.35; font-style: italic; }
+div.p, { width: 100% }
+
+
+/* Default header styles */
+h1, h2, h3, #toctitle, .sidebarblock > .content > .title, h4, h5, h6 { font-family: sans-serif; font-weight: 600; font-style: normal; color: #244d82; text-rendering: optimizeLegibility; margin-bottom: 0em; line-height: 1.2125em; margin-top:; 2rem;  }
+h1 small, h2 small, h3 small, #toctitle small, .sidebarblock > .content > .title small, h4 small, h5 small, h6 small { font-size: 60%; color: #6999d6; line-height: 0; }
+
+h1 { font-size: 2.125em; max-width:66.66%;}
+
+h2 { font-size: 1.6875em; }
+
+h3, #toctitle, .sidebarblock > .content > .title { font-size: 1.375em; }
+
+h4 { font-size: 1.125em; }
+
+h5 { font-size: 1.125em; }
+
+h6 { font-size: 1em; }
+
+hr { border: solid #dddddd; border-width: 1px 0 0; clear: both; margin: 1.25em 0 1.1875em; height: 0; }
+
+/* Helpful Typography Defaults */
+em, i { font-style: italic; line-height: inherit; }
+
+strong, b { font-weight: 600; line-height: inherit; }
+
+small { font-size: 60%; line-height: inherit; }
+
+code { font-family: Fira Mono, Consolas, "Liberation Mono", Courier, monospace;  }
+
+/* Lists */
+ul, ol, dl {  list-style-position: outside; font-family:sans-serif; padding-left: 0rem; list-style-type: none}
+
+ul, ol { margin-left: 0em;  }
+ul.no-bullet, ol.no-bullet { margin-left: 1.5em;  margin-bottom: 0;}
+
+/* Unordered Lists */
+ul li ul, ul li ol { margin-left: 1.25em; margin-bottom: 0; font-size: 1em; /* Override nested font-size change */  }
+ul.square li ul, ul.circle li ul, ul.disc li ul { list-style: inherit; }
+ul.square { list-style-type: square; }
+ul.circle { list-style-type: circle; }
+ul.disc { list-style-type: none; }
+ul.no-bullet { list-style: none; }
+
+/* Ordered Lists */
+ol li ul, ol li ol { margin-left: 1.25em; margin-bottom: 0;   }
+
+/* Definition Lists */
+dl dt { margin-bottom: 0.3125em; font-weight: bold; font-size: 1.2em; font-style: italic}
+dl dd { margin-bottom: 1.25em; }
+
+/* Abbreviations */
+abbr, acronym { text-transform: uppercase; font-size: 90%; color: #222222; border-bottom: 1px dotted #dddddd; cursor: help; }
+
+abbr { text-transform: none; }
+
+/* Blockquotes */
+blockquote { margin: 0 0 1.25em; padding: 0.5625em 1.25em 0 1.1875em; border-left: 1px solid #dddddd; }
+blockquote cite { display: block; font-size: inherit; color: color: #132445; }
+blockquote cite:before { content: "\2014 \0020"; }
+blockquote cite a, blockquote cite a:visited { color: #417dcb; }
+
+blockquote, blockquote p { line-height: 1.6; color: #132445; }
+
+/* Microformats */
+.vcard { display: inline-block; margin: 0 0 1.25em 0; border: 1px solid #dddddd; padding: 0.625em 0.75em; }
+.vcard li { margin: 0; display: block; }
+.vcard .fn { font-weight: bold; font-size: 0.9375em; }
+
+.vevent .summary { font-weight: bold; }
+.vevent abbr { cursor: auto; text-decoration: none; font-weight: bold; border: none; padding: 0 0.0625em; }
+
+@media only screen and (min-width: 768px) { h1, h2, h3, #toctitle, .sidebarblock > .content > .title, h4, h5, h6 { line-height: 1.4;  margin-top: 1rem; margin-bottom: 0.2rem;}
+  h1 { font-size: 2.75em; }
+  h2 { font-size: 2.3125em; }
+  h3, #toctitle, .sidebarblock > .content > .title { font-size: 1.6875em; }
+  h4 { font-size: 1.4375em; } }
+
+/* Tables */
+table { background: white; margin-bottom: 1.25em; border: solid 1px #dddddd; }
+table thead, table tfoot { background: whitesmoke; font-weight: 600; }
+table thead tr th, table thead tr td, table tfoot tr th, table tfoot tr td { padding: 0.5em 0.625em 0.625em; font-size: inherit; color: #222222; text-align: left; }
+table tr th, table tr td { padding: 0.5625em 0.625em; font-size: inherit; color: #222222; }
+table tr.even, table tr.alt, table tr:nth-of-type(even) { background: #f9f9f9; }
+table thead tr th, table tfoot tr th, table tbody tr td, table tr td, table tfoot tr td { display: table-cell; line-height: 1.4; }
+
+/* FEATURE TABLE */
+
+table.done, tr.done.alt, table.done tr:nth-of-type(even) {
+	background: #efe;
+	padding-top: 0;
+	padding-bottom: 0;
+	border: none;
+	margin-bottom: -1px;
+}
+
+table.most, tr.most.alt, table.most tr:nth-of-type(even) {
+	background: #ffd;
+	padding-top: 0;
+	padding-bottom: 0;
+	border: none;
+	margin-bottom: -1px;
+}
+
+table.tbc, tr.tbc.alt, table.tbc tr:nth-of-type(even) {
+	background: #fff6de;
+	padding-top: 0;
+	padding-bottom: 0;
+	border: none;
+	margin-bottom: -1px;
+}
+
+table.tbd, tr.tbd.alt, table.tbd tr:nth-of-type(even) {
+	background: #fee;
+	padding-top: 0;
+	padding-bottom: 0;
+	border: none;
+	margin-bottom: -1px;
+}
+
+table.done thead tr th, table.done tfoot tr th, table.done tfoot tr td, table.done.sect2, table.most thead tr th, table.most tfoot tr th, table.most tfoot tr td, table.most.sect2, table.tbc thead tr th, table.tbc tfoot tr th, table.tbc tfoot tr td, table.tbc.sect2, table.tbd thead tr th, table.tbd tfoot tr th, table.tbd tfoot tr td, table.tbd.sect2 {background: white; font-size: 1.9rem; color: #417dcb; }
+
+
+
+/* 
+green "done" = #efe
+yellow "most" = #ffd
+orange "tbc" = #fff6de
+red "tbd" = #fee
+ */
+
+
+
+body { tab-size: 4; max-width: 1250px; margin-right: auto; margin-left: auto; position: relative; margin-top: 0rem; margin-bottom: 0rem; padding-top: 0rem; /*  Fixes tables, breaks headers */}
+
+h1, h2, h3, #toctitle, .sidebarblock > .content > .title, h4, h5, h6 { line-height: 1.4;  margin-top: 0rem;}
+
+.clearfix:before, .clearfix:after, .float-group:before, .float-group:after { content: " "; display: table; }
+.clearfix:after, .float-group:after { clear: both; }
+
+*:not(pre) > code { font-size: inherit; font-style: normal !important; letter-spacing: 0; padding: 0; line-height: inherit; }
+
+pre, pre > code { line-height: 1.4; color: black; font-family: monospace, serif; font-weight: normal; }
+
+.keyseq { color: #555555; }
+
+kbd { font-family: Consolas, "Liberation Mono", Courier, monospace; display: inline-block; color: #222222; font-size: 0.65em; line-height: 1.45; background-color: #f7f7f7; border: 1px solid #ccc; -webkit-border-radius: 3px; border-radius: 3px; -webkit-box-shadow: 0 1px 0 rgba(0, 0, 0, 0.2), 0 0 0 0.1em white inset; box-shadow: 0 1px 0 rgba(0, 0, 0, 0.2), 0 0 0 0.1em white inset; margin: 0 0.15em; padding: 0.2em 0.5em; vertical-align: middle; position: relative; top: -0.1em; white-space: nowrap; }
+
+.keyseq kbd:first-child { margin-left: 0; }
+
+.keyseq kbd:last-child { margin-right: 0; }
+
+.menuseq, .menu { color: #090909; }
+
+b.button:before, b.button:after { position: relative; top: -1px; font-weight: normal; }
+
+b.button:before { content: "["; padding: 0 3px 0 2px; }
+
+b.button:after { content: "]"; padding: 0 2px 0 3px; }
+
+#header, #content, #footnotes, #footer {  
+	max-width: 1050px; margin-right: auto; margin-left: auto; position: relative; 
+	margin-top: 0rem; margin-bottom: 0rem; 
+	padding-top: 0rem;  padding-right: 1rem;}
+#header:before, #header:after, #content:before, #content:after, #footnotes:before, #footnotes:after, #footer:before, #footer:after { content: " "; display: table; }
+#header:after, #content:after, #footnotes:after, #footer:after { clear: both; }
+
+
+#content:before { content: none; }
+#content {padding-left: 0.5rem;}
+
+#header > h1:first-child { color: black; font-weight: bold; margin-top: 2.25rem; margin-bottom: 0; }
+#header > h1:first-child + #toc { margin-top: 8px; border-top: 1px solid #dddddd; }
+#header > h1:only-child, body.toc2 #header > h1:nth-last-child(2) { border-bottom: 1px solid #dddddd; padding-bottom: 8px; }
+#header .details { border-bottom: 1px solid #dddddd; line-height: 1.45; padding-top: 0.25em; padding-bottom: 0.25em; padding-left: 0.25em; color: #417dcb; display: -ms-flexbox; display: -webkit-flex; display: flex; -ms-flex-flow: row wrap; -webkit-flex-flow: row wrap; flex-flow: row wrap; }
+#header .details span:first-child { margin-left: -0.125em; }
+#header .details span.email a { color: #6999d6; }
+#header .details br { display: none; }
+#header .details br + span:before { content: "\00a0\2013\00a0"; }
+#header .details br + span.author:before { content: "\00a0\22c5\00a0"; color: #6999d6; }
+#header .details br + span#revremark:before { content: "\00a0|\00a0"; }
+#header #revnumber { text-transform: capitalize; }
+#header #revnumber:after { content: "\00a0"; }
+
+#content > h1:first-child:not([class]) { color: black; font-weight: bold; border-bottom: 1px solid #dddddd; max-width: 1050px; margin-right: auto; margin-left: auto; position: relative; margin-top: 4rem; margin-bottom: 4rem; padding-top: 0rem;   }
+
+/* ========================================================================== Table of Contents ======================================================================= */
+
+
+
+#toc { border-bottom: 1px solid #dddddd; padding-bottom: 0.5em; position: relative; left: 0;}
+#toc > ul { margin-left: 0.125em; padding-left: 1em; }
+#toc ul.sectlevel0 > li > a { font-style: italic; }
+#toc ul.sectlevel0 ul.sectlevel1 { margin: 0.5em 0; }
+#toc ul { font-family: "Helvetica Neue", "Helvetica", Helvetica, Arial, sans-serif; list-style-type: none; }
+#toc li { line-height: 1.3334; margin-top: 0.3334em; }
+#toc a { text-decoration: none; }
+#toc a:active { text-decoration: underline; }
+
+#toc ul li:before {
+    /* content: "›"; */
+    margin-left: -.75em;
+    margin-right: .4em;
+    color: #244d82
+}
+
+
+
+div.ulist li:before {
+    content: "›";
+    position: absolute;
+    margin-top: .2rem;
+    font-size: x-large;
+    margin-left: -.75em;
+    margin-bottom: -.75em;
+    margin-right: 0;
+    line-height: 1rem;
+    color: #244d82
+
+}
+
+
+#toctitle { color: #244d82; font-size: 1.2em; padding-left: 1em; }
+
+#faq {
+	position: relative;
+	right: 9.3rem;
+    top: 9rem;
+	margin-bottom: 20px;
+	left: 45rem;
+	z-index:1;padding-left:2rem;border-left:1px solid #d3d3d3
+
+}
+@media only screen and (max-width: 945px) {
+	div#faq { display: none; }
+}
+
+#faq h2 {
+	font-size: 25px;
+	font-weight: 600;
+	margin-top: -8rem;
+}
+
+div#faq li:before {
+    content: "›";
+    position: absolute;
+    font-size: x-large;
+    margin-left: -.75em;
+    margin-bottom: -.75em;
+    margin-right: 0;
+    line-height: 1rem;
+    color: #244d82
+}
+
+#features-nav {
+	position: absolute;
+	right: 1rem;
+	top: 2rem;
+	margin-bottom: 20px;
+	position:absolute;z-index:1;padding-left:2rem;border-left:1px solid #d3d3d3
+}
+
+@media only screen and (max-width: 993px) {
+	#features-nav { display: none; }
+}
+
+#features-nav h2 {
+	font-size: 25px;
+	font-weight: 600;
+	margin-top: -1rem;
+}
+#features-nav li {
+	margin-top: .3rem;
+}
+
+div#features-nav li:before {
+    content: "›";
+    position: absolute;
+    font-size: x-large;
+    margin-left: -.75em;
+    margin-bottom: -.75em;
+    margin-right: 0;
+    line-height: 1rem;
+    color: #244d82
+}
+
+
+
+@media only screen and (min-width: 1434px ) { 
+	body.toc2.toc-right #toc.toc2 { border-right-width: 0; border: none; left: 0px; }
+	#toctitle { padding-top: 1.5rem; font-size: 1.375em; }
+	body.toc2 { padding-left: 2em; padding-right: 1em; }
+	#toc.toc2 { margin-top: 0 !important; background-color: #f2f2f2; position: fixed; width: 12em; left: 0; top: 0; border-right: 1px solid #dddddd; border-top-width: 0 !important; border-bottom-width: 0 !important; z-index: 1000; padding: 1.25em 0.25em 0em 0.25em; height: 100%; overflow: auto; }
+	#toc.toc2 #toctitle { margin-top: 0; margin-bottom: 0.8rem; font-size: 1.2em; padding-left: 1em;}
+	#toc.toc2 > ul { font-size: 0.9em; margin-bottom: 0; }
+	#toc.toc2 ul ul { margin-left: 1em; padding-left: .3em; }
+	#toc.toc2 ul.sectlevel0 ul.sectlevel1 { padding-left: 0; margin-top: 0.5em; margin-bottom: 0.5em; }
+	body.toc2.toc-right { padding-left: 2em; padding-right: 2em; }
+	body.toc2.toc-right #toc.toc2 { border-right-width: 0; border-left: 1px solid #dddddd; left: auto; right: -13rem; } 
+}
+@media only screen and (min-width: 1535px) { 
+	body.toc2 { padding-left: 2em; padding-right: 2em; }
+	#toctitle { padding-top: 0rem; font-size: 1.375em; }
+	#toc.toc2 { width: 13em; }
+	
+	#toc.toc2 #toctitle { font-size: 1.375em; }
+	
+	#toc.toc2 > ul { font-size: 0.95em; }
+	#toc.toc2 ul ul { padding-left: 0; }
+	body.toc2.toc-right { padding-left: 2em; padding-right: 2em; } 
+}
+
+#content #toc { border-style: solid; border-width: 1px; border-color: #d9d9d9; margin-bottom: 1.25em; padding: 1.25em; background: #f2f2f2; -webkit-border-radius: 0; border-radius: 0; }
+#content #toc > :first-child { margin-top: 0; }
+#content #toc > :last-child { margin-bottom: 0; }
+
+
+
+div.social  { line-height: 1.4; color: #FFFFFF;font-size:  1.2rem; font-weight: 400; font-style: bold; background-color: #132445; margin-right: -2rem; margin-left: -2rem; text-align: left; padding-bottom: 4px; padding-left: 25px; }
+div.social li a {  margin-bottom: 2em;  color: #d5dfea;font-size:  1.2rem; font-weight: 800; font-style: bold; list-style: none; list-style-type: none; text-decoration-color: rgb(213, 223, 234); }
+/* div.social a:visited { color: #244D82; }*/
+div.social a:hover { color: #F7D425; }
+div.social :first-child { margin-top: 0; }
+div.social h2 {        margin-bottom: 20px;font-weight: 600;font-size: 1.3em;margin-top: 4rem;color: #244d82;font-family: sans-serif;}
+div.social li:before {content: "› "; color: #244d82;font-size: large;font-weight: 800;}
+div.social ul {margin-top: -10px;line-height: 30px;}
+div.social li {/* nothing */}
+
+#bottomright {float: right;}
+
+
+
+
+
+#footer-text { color: #dddddd; line-height: 1.44; }
+
+
+.sect1 { padding-bottom: 0.625em; }
+.sectionbody.paragraph {max-width: 66.666%}
+.sectionbody ul {padding-left: 1rem;}
+
+@media only screen and (min-width: 768px) { .sect1 { padding-bottom: 0em; } }
+.sect1 + .sect1 { border-top: 0px solid #dddddd; }
+
+#content h1 > a.anchor, h2 > a.anchor, h3 > a.anchor, #toctitle > a.anchor, .sidebarblock > .content > .title > a.anchor, h4 > a.anchor, h5 > a.anchor, h6 > a.anchor { position: absolute; z-index: 1001; width: 1.5ex; margin-left: -1.5ex; display: block; text-decoration: none !important; visibility: hidden; text-align: center; font-weight: 400; max-width: 1050px; }
+#content h1 > a.anchor:before, h2 > a.anchor:before, h3 > a.anchor:before, #toctitle > a.anchor:before, .sidebarblock > .content > .title > a.anchor:before, h4 > a.anchor:before, h5 > a.anchor:before, h6 > a.anchor:before { content: "\2771"; font-size: 0.85em; display: block; padding-top: 0.1em; vertical-align: bas }
+#content h1:hover > a.anchor, #content h1 > a.anchor:hover, h2:hover > a.anchor, h2 > a.anchor:hover, h3:hover > a.anchor, #toctitle:hover > a.anchor, .sidebarblock > .content > .title:hover > a.anchor, h3 > a.anchor:hover, #toctitle > a.anchor:hover, .sidebarblock > .content > .title > a.anchor:hover, h4:hover > a.anchor, h4 > a.anchor:hover, h5:hover > a.anchor, h5 > a.anchor:hover, h6:hover > a.anchor, h6 > a.anchor:hover { visibility: visible; }
+#content h1 > a.link, h2 > a.link, h3 > a.link, #toctitle > a.link, .sidebarblock > .content > .title > a.link, h4 > a.link, h5 > a.link, h6 > a.link { color: #244d82; text-decoration: none; font-family:  sans-serif}
+#content h1 > a.link:hover, h2 > a.link:hover, h3 > a.link:hover, #toctitle > a.link:hover, .sidebarblock > .content > .title > a.link:hover, h4 > a.link:hover, h5 > a.link:hover, h6 > a.link:hover { color: #1e416e; }
+
+.audioblock, .imageblock, .literalblock, .listingblock, .stemblock, .videoblock { margin-bottom: 1.25em; }
+
+.admonitionblock td.content > .title, .audioblock > .title, .exampleblock > .title, .imageblock > .title, .listingblock > .title, .literalblock > .title, .stemblock > .title, .openblock > .title, .paragraph > .title, .quoteblock > .title, table.tableblock > .title, .verseblock > .title, .videoblock > .title, .dlist > .title, .olist > .title, .ulist > .title, .qlist > .title, .hdlist > .title { text-rendering: optimizeLegibility; text-align: left;   }
+
+table.tableblock > caption.title { white-space: nowrap; overflow: visible; max-width: 0;  }
+
+.paragraph.lead > p, #preamble > .sectionbody > .paragraph:first-of-type p { color: black; max-width: 66%}
+
+table.tableblock #preamble > .sectionbody > .paragraph:first-of-type p { font-size: inherit; }
+
+.admonitionblock > table { border-collapse: separate; border: 0; background: none; max-width: 80%;}
+.admonitionblock > table td.icon { text-align: center; width: 80px; }
+.admonitionblock > table td.icon img { max-width: none; }
+.admonitionblock > table td.icon .title { font-weight: bold; font-family:  sans-serif, Georgia, Verdana, "Helvetica", Helvetica, Arial, sans-serif; text-transform: uppercase; }
+.admonitionblock > table td.content { padding-left: 1.125em; padding-right: 1.25em; border-left: 1px solid #dddddd; color: #417dcb; }
+.admonitionblock > table td.content > :last-child > :last-child { margin-bottom: 0; }
+
+.exampleblock > .content { border-style: solid; border-width: 1px; border-color: #e6e6e6; margin-bottom: 1.25em; padding: 1.25em; background-color: #fffef7; -webkit-border-radius: 0; border-radius: 0; }
+.exampleblock > .content > :first-child { margin-top: 0; }
+.exampleblock > .content > :last-child { margin-bottom: 0; }
+
+.sidebarblock { position: absolute; border-style: solid; border-width: 1px; border-color: #d9d9d9; margin: -2rem -7.5rem 0rem 63.65rem; padding: .2rem; background: #f2f2f2; -webkit-border-radius: 0; border-radius: 0; text-align: left; width: 5.5rem;}
+.sidebarblock > :first-child { margin-top: 0; }
+.sidebarblock > :last-child { margin-bottom: 0; }
+.sidebarblock > .content > .title { color: #6999d6; margin-top: 0; }
+
+@media only screen and (max-width: 1203px) { 
+.sidebarblock { position: absolute; right: 12%; }
+}
+@media only screen and (max-width: 817px) { 
+.sidebarblock { position: absolute; right: 18%; }
+}
+
+@media only screen and (max-width: 562px) { 
+.sidebarblock { position: absolute; right: 25%; }
+}
+
+.exampleblock > .content > :last-child > :last-child, .exampleblock > .content .olist > ol > li:last-child > :last-child, .exampleblock > .content .ulist > ul > li:last-child > :last-child, .exampleblock > .content .qlist > ol > li:last-child > :last-child, .sidebarblock > .content > :last-child > :last-child, .sidebarblock > .content .olist > ol > li:last-child > :last-child, .sidebarblock > .content .ulist > ul > li:last-child > :last-child, .sidebarblock > .content .qlist > ol > li:last-child > :last-child { margin-bottom: 0; }
+
+.literalblock pre, .listingblock pre:not(.highlight), .listingblock pre[class="highlight"], .listingblock pre[class^="highlight "], .listingblock pre.CodeRay, .listingblock pre.prettyprint { background: #eeeeee; }
+.sidebarblock .literalblock pre, .sidebarblock .listingblock pre:not(.highlight), .sidebarblock .listingblock pre[class="highlight"], .sidebarblock .listingblock pre[class^="highlight "], .sidebarblock .listingblock pre.CodeRay, .sidebarblock .listingblock pre.prettyprint { background: #f2f1f1; }
+
+.literalblock pre, .literalblock pre[class], .listingblock pre, .listingblock pre[class] { border: 1px solid #cccccc; -webkit-border-radius: 0; border-radius: 0; word-wrap: break-word; padding: 0.8em 0.8em 0.65em 0.8em; font-size: 0.8125em; }
+.literalblock pre.nowrap, .literalblock pre[class].nowrap, .listingblock pre.nowrap, .listingblock pre[class].nowrap { overflow-x: auto; white-space: pre; word-wrap: normal; }
+@media only screen and (min-width: 768px) { .literalblock pre, .literalblock pre[class], .listingblock pre, .listingblock pre[class] { font-size: 0.90625em; } }
+@media only screen and (min-width: 1280px) { .literalblock pre, .literalblock pre[class], .listingblock pre, .listingblock pre[class] { font-size: 1em; } }
+
+.literalblock.output pre { color: #eeeeee; background-color: black; }
+
+.listingblock pre.highlightjs { padding: 0;  margin-right: 0em; }
+.listingblock pre.highlightjs > code { padding: 0.8em 2rem 0.65em 0.8em; -webkit-border-radius: 0; border-radius: 0; padding-right: 2rem;}
+
+.listingblock > .content { position: relative; }
+
+.listingblock code[data-lang]:before { display: none; content: attr(data-lang); position: absolute; font-size: 0.75em; top: 0.425rem; right: 0.5rem; line-height: 1; text-transform: uppercase; color: #999; padding-right: 2rem; }
+
+.listingblock:hover code[data-lang]:before { display: none; }
+
+.listingblock.terminal pre .command:before { content: attr(data-prompt); padding-right: 0.5em; color: #999; }
+
+.listingblock.terminal pre .command:not([data-prompt]):before { content: "$"; }
+
+table.pyhltable { border-collapse: separate; border: 0; margin-bottom: 0; background: none; }
+
+table.pyhltable td { vertical-align: top; padding-top: 0; padding-bottom: 0; line-height: 1.4; }
+
+table.pyhltable td.code { padding-left: .75em; padding-right: 0; }
+
+pre.pygments .lineno, table.pyhltable td:not(.code) { color: #999; padding-left: 0; padding-right: .5em; border-right: 1px solid #dddddd; }
+
+pre.pygments .lineno { display: inline-block; margin-right: .25em; }
+
+table.pyhltable .linenodiv { background: none !important; padding-right: 0 !important; }
+
+.quoteblock { margin: 0 1em 1.25em 1.5em; display: table; }
+.quoteblock > .title { margin-left: -1.5em; margin-bottom: 0.75em; }
+.quoteblock blockquote, .quoteblock blockquote p { color: #132445; font-size: 1.15rem; line-height: 1.75; word-spacing: 0.1em; letter-spacing: 0; font-style: italic; text-align: justify; }
+.quoteblock blockquote { margin: 0; padding: 1rem; border: 0; }
+.quoteblock blockquote:before { content: "\201c"; float: left; font-size: 2.75em; font-weight: bold; line-height: 0.6em; margin-left: -0.6em; color: #6999d6; text-shadow: 0 1px 2px rgba(0, 0, 0, 0.1); }
+.quoteblock blockquote > .paragraph:last-child p { margin-bottom: 0; }
+.quoteblock .attribution { margin-top: 1em; margin-right: 0.5ex; text-align: right; }
+.quoteblock .quoteblock { margin-left: 0; margin-right: 0; padding: 0.5em 0; border-left: 3px solid #417dcb; }
+.quoteblock .quoteblock blockquote { padding: 0 0 0 0.75em; }
+.quoteblock .quoteblock blockquote:before { display: none; }
+
+.verseblock { margin: 0 1em 1.25em 1em; }
+.verseblock pre { font-family:  sans-serif, "Open Sans", "DejaVu Sans", sans; font-size: 1.15rem; color: #6999d6; font-weight: 300; text-rendering: optimizeLegibility; }
+.verseblock pre strong { font-weight: 400; }
+.verseblock .attribution { margin-top: 1.25rem; margin-left: 0.5ex; text-align: right;}
+
+.quoteblock .attribution, .verseblock .attribution { font-size: inherit; line-height: 1.45; font-style: italic; }
+.quoteblock .attribution br, .verseblock .attribution br { display: none; }
+.quoteblock .attribution cite, .verseblock .attribution cite { display: block; letter-spacing: -0.025em; color: #417dcb; }
+
+.quoteblock.abstract { margin: 0 0 1.25em 0; display: block; }
+.quoteblock.abstract blockquote, .quoteblock.abstract blockquote p { text-align: left; word-spacing: 0; }
+.quoteblock.abstract blockquote:before, .quoteblock.abstract blockquote p:first-of-type:before { display: none; }
+
+table.tableblock { max-width: 100%; border-collapse: separate;  }
+table.tableblock td > .paragraph:last-child p > p:last-child, table.tableblock th > p:last-child, table.tableblock td > p:last-child { margin-bottom: 0; }
+
+table.tableblock, th.tableblock, td.tableblock { border: 0 solid #dddddd; margin-right: 2rem;}
+
+table.grid-all th.tableblock, table.grid-all td.tableblock { border-width: 0 1px 1px 0; padding: 0.5rem;}
+
+table.grid-all tfoot > tr > th.tableblock, table.grid-all tfoot > tr > td.tableblock { border-width: 1px 1px 0 0; }
+
+table.grid-cols th.tableblock, table.grid-cols td.tableblock { border-width: 0 1px 0 0; }
+
+table.grid-all * > tr > .tableblock:last-child, table.grid-cols * > tr > .tableblock:last-child { border-right-width: 0; }
+
+table.grid-rows th.tableblock, table.grid-rows td.tableblock { border-width: 0 0 1px 0; }
+
+table.grid-all tbody > tr:last-child > th.tableblock, table.grid-all tbody > tr:last-child > td.tableblock, table.grid-all thead:last-child > tr > th.tableblock, table.grid-rows tbody > tr:last-child > th.tableblock, table.grid-rows tbody > tr:last-child > td.tableblock, table.grid-rows thead:last-child > tr > th.tableblock { border-bottom-width: 0;}
+
+table.grid-rows tfoot > tr > th.tableblock, table.grid-rows tfoot > tr > td.tableblock { border-width: 1px 0 0 0; }
+
+table.frame-all { border-width: 1px; }
+
+table.frame-sides { border-width: 0 1px; }
+
+table.frame-topbot { border-width: 1px 0; }
+
+th.halign-left, td.halign-left { text-align: left; }
+
+th.halign-right, td.halign-right { text-align: right; }
+
+th.halign-center, td.halign-center { text-align: center; }
+
+th.valign-top, td.valign-top { vertical-align: top; }
+
+th.valign-bottom, td.valign-bottom { vertical-align: bottom; }
+
+th.valign-middle, td.valign-middle { vertical-align: middle; }
+
+table thead th, table tfoot th { font-weight: 600; }
+
+tbody tr th { display: table-cell; line-height: 1.4; background: whitesmoke; }
+
+tbody tr th, tbody tr th p, tfoot tr th, tfoot tr th p { color: #222222; font-weight: 600; }
+
+p.tableblock > code:only-child { background: none; padding: 0; max-width: 100%}
+
+p.tableblock { font-size: 1em; max-width: 100% }
+
+td > div.verse { white-space: pre; }
+
+ol { margin-left: 1.75em; }
+
+ul li ol { margin-left: 1.5em; }
+
+
+dl dd { margin-left: 1.125em; }
+
+dl dd:last-child, dl dd:last-child > :last-child { margin-bottom: 0; }
+
+ol > li p, ul > li p, ul dd, ol dd, .olist .olist, .ulist .ulist, .ulist .olist, .olist .ulist { margin-bottom: -0.2em; }
+
+ul.unstyled, ol.unnumbered, ul.checklist, ul.none { list-style-type: none; }
+
+ul.unstyled, ol.unnumbered, ul.checklist { margin-left: 0.625em; }
+
+ul.checklist li > p:first-child > .fa-square-o:first-child, ul.checklist li > p:first-child > .fa-check-square-o:first-child { width: 1em; font-size: 0.85em; }
+
+ul.checklist li > p:first-child > input[type="checkbox"]:first-child { width: 1em; position: relative; top: 1px; }
+
+ul.inline { margin: 0 auto 0.625em auto; margin-left: -1.375em; margin-right: 0; padding: 0; list-style: none; overflow: hidden; }
+ul.inline > li { list-style: none; float: left; margin-left: 1.375em; display: block; }
+ul.inline > li > * { display: block; }
+
+.unstyled dl dt { font-weight: normal; font-style: normal; }
+
+ol.arabic { list-style-type: decimal; }
+
+ol.decimal { list-style-type: decimal-leading-zero; }
+
+ol.loweralpha { list-style-type: lower-alpha; }
+
+ol.upperalpha { list-style-type: upper-alpha; }
+
+ol.lowerroman { list-style-type: lower-roman; }
+
+ol.upperroman { list-style-type: upper-roman; }
+
+ol.lowergreek { list-style-type: lower-greek; }
+
+.hdlist > table, .colist > table { border: 0; background: none; }
+.hdlist > table > tbody > tr, .colist > table > tbody > tr { background: none; }
+
+td.hdlist1, td.hdlist2 { vertical-align: baseline; padding: 0 0.625em; }
+
+td.hdlist1 { font-weight: bold; padding-bottom: 1.25em; }
+
+.literalblock + .colist, .listingblock + .colist { margin-top: -0.5em;  }
+
+.colist > table tr > td:first-of-type { padding: 0 0.75em; line-height: 1; }
+.colist > table tr > td:last-of-type { padding: 0.25em 0; }
+
+.thumb, .th { line-height: 0; display: inline-block; border: solid 4px white; -webkit-box-shadow: 0 0 0 1px #dddddd; box-shadow: 0 0 0 1px #dddddd; }
+
+.imageblock.left, .imageblock[style*="float: left"] { margin: 0.25em 0.625em 1.25em 0;   }
+.imageblock.right, .imageblock[style*="float: right"] { margin: 0.25em 0 1.25em 0.625em;  }
+.imageblock > .title { margin-bottom: 0; }
+.imageblock.thumb, .imageblock.th { border-width: 6px; }
+.imageblock.thumb > .title, .imageblock.th > .title { padding: 0 0.125em; }
+
+.image.left, .image.right { margin-top: 0.25em; margin-bottom: 0.25em; display: inline-block; line-height: 0; }
+.image.left { margin-right: 0.625em; }
+.image.right { margin-left: 0.625em; }
+
+a.image { text-decoration: none; display: inline-block; }
+a.image object { pointer-events: none; }
+
+sup.footnote, sup.footnoteref { font-size: 0.875em; position: static; vertical-align: super; }
+sup.footnote a, sup.footnoteref a { text-decoration: none; }
+sup.footnote a:active, sup.footnoteref a:active { text-decoration: underline; }
+
+#footnotes { padding-top: 0.75em; padding-bottom: 0.75em; margin-bottom: 0.625em; }
+#footnotes hr { width: 20%; min-width: 6.25em; margin: -0.25em 0 0.75em 0; border-width: 1px 0 0 0; }
+#footnotes .footnote { padding: 0 0.375em 0 0.225em; line-height: 1.3334; font-size: 0.875em; margin-left: 1.2em; text-indent: -1.05em; margin-bottom: 0.2em; }
+#footnotes .footnote a:first-of-type { font-weight: bold; text-decoration: none; }
+#footnotes .footnote:last-of-type { margin-bottom: 0; }
+#content #footnotes { margin-top: -0.625em; margin-bottom: 0; padding: 0.75em 0; }
+
+.gist .file-data > table { border: 0; background: #fff; width: 100%; margin-bottom: 0; }
+.gist .file-data > table td.line-data { width: 99%; }
+
+div.github-block { text-align: right; margin-right: -1rem; }
+div.gist {padding-right: 2rem;}
+
+div.unbreakable { page-break-inside: avoid; }
+
+.big { font-size: larger; }
+
+.small { font-size: smaller; }
+
+.underline { text-decoration: underline; }
+
+.overline { text-decoration: overline; }
+
+.line-through { text-decoration: line-through; }
+
+.aqua { color: #00bfbf; }
+
+.aqua-background { background-color: #00fafa; }
+
+.black { color: black; }
+
+.black-background { background-color: black; }
+
+.blue { color: #0000bf; }
+
+.blue-background { background-color: #0000fa; }
+
+.fuchsia { color: #bf00bf; }
+
+.fuchsia-background { background-color: #fa00fa; }
+
+.gray { color: #606060; }
+
+.gray-background { background-color: #7d7d7d; }
+
+.green { color: #006000; }
+
+.green-background { background-color: #007d00; }
+
+.lime { color: #00bf00; }
+
+.lime-background { background-color: #00fa00; }
+
+.maroon { color: #600000; }
+
+.maroon-background { background-color: #7d0000; }
+
+.navy { color: #000060; }
+
+.navy-background { background-color: #00007d; }
+
+.olive { color: #606000; }
+
+.olive-background { background-color: #7d7d00; }
+
+.purple { color: #600060; }
+
+.purple-background { background-color: #7d007d; }
+
+.red { color: #bf0000; }
+
+.red-background { background-color: #fa0000; }
+
+.silver { color: #909090; }
+
+.silver-background { background-color: #bcbcbc; }
+
+.teal { color: #006060; }
+
+.teal-background { background-color: #007d7d; }
+
+.white { color: #bfbfbf; }
+
+.white-background { background-color: #fafafa; }
+
+.yellow { color: #bfbf00; }
+
+.yellow-background { background-color: #fafa00; }
+
+span.icon > .fa { cursor: default; }
+
+.admonitionblock td.icon [class^="fa icon-"] { font-size: 2.5em; text-shadow: 1px 1px 2px rgba(0, 0, 0, 0.5); cursor: default; }
+.admonitionblock td.icon .icon-note:before { content: "\f05a"; color: #207c98; }
+.admonitionblock td.icon .icon-tip:before { content: "\f0eb"; text-shadow: 1px 1px 2px rgba(155, 155, 0, 0.8); color: #111; }
+.admonitionblock td.icon .icon-warning:before { content: "\f071"; color: #bf6900; }
+.admonitionblock td.icon .icon-caution:before { content: "\f06d"; color: #bf3400; }
+.admonitionblock td.icon .icon-important:before { content: "\f06a"; color: #bf0000; }
+
+.conum[data-value] { display: inline-block; color: #fff !important; background-color: #222222; -webkit-border-radius: 100px; border-radius: 100px; text-align: center; font-size: 0.75em; width: 1.67em; height: 1.67em; line-height: 1.67em; font-family:sans-serif, "Open Sans", "DejaVu Sans", sans-serif; font-style: normal; font-weight: bold; }
+.conum[data-value] * { color: #fff !important; }
+.conum[data-value] + b { display: none; }
+.conum[data-value]:after { content: attr(data-value); }
+pre .conum[data-value] { position: relative; top: -0.125em; }
+
+b.conum * { color: inherit !important; }
+
+
+.conum:not([data-value]):empty { display: none; }
+
+.literalblock pre, .listingblock pre { background: #eeeeee; }
+
+div#remarks.ulist {
+	max-width: 70%;
+}
+
+div.title:first-of-type {
+    display: none;
+}
+
+/* Mobile */
+
+@media only screen and (max-width: 800px) {
+	a#bottomright {visibility: hidden;}
+	.sectionbody.paragraph {max-width: 100%}
+	.paragraph.lead > p, #preamble > .sectionbody > .paragraph:first-of-type p { max-width: 100% }
+}
+
+#div.paragraph.faq-intro {
+	max-width: 66.66%
+}
+/* ========================================================================== Mobile Menu ======================================================================= */
+#menu {
+    display: none;
+    }
+
+div.slicknav_menu {
+    padding-top: 5px;
+    padding-right: 15px;
+    background-color: #132445;
+    margin-left: -2rem;
+    margin-right: -2rem;
+    text-align: right;
+    display: none;
+    right: 10px;
+    font-size: 1rem;
+    color: white;
+    padding-bottom: 2rem;
+    background: url("n4js-logo.png");
+    background-position: 10px 10px;
+    background-size: 344.48px 40px;
+    background-repeat: no-repeat;
+    background-color: #132445;
+}
+
+span.slicknav_menutxt {
+    margin-right: -20px;
+    color: white;
+}
+
+div.slicknav_menu a.scroll:first-of-type {
+    color: #F7D425;
+    font-size: 120%;
+    font-weight: 600;
+}
+div.slicknav_menu ul li a {
+    color: white;
+}
+div.slicknav_menu ul li a:hover {
+    color: #F7D425;
+}
+
+div.slicknav_menu a:hover {color: #F7D425; }
+div.slicknav_menu a:visited {color: white; }
+div.slicknav_menu a {color: white;}
+a.slicknav_btn  {
+    padding: 1rem;
+}
+
+
+li.slicknav_parent.slicknav_open {
+    color: white;
+}
+
+li.slicknav_parent.slicknav_open  {
+    color: white;
+}
+
+@media screen and (max-width: 890px) {
+    div.slicknav_menu {
+        display: block;
+        color: white
+    }
+    #mobile-banner {
+        display: block;
+    }
+}
+
+@media screen and (max-width: 470px) {
+div.slicknav_menu ul:first-of-type {
+    margin-top: 1.5rem;
+}
+
+div.slicknav_menu ul li {
+    color: white;
+}
+div.slicknav_menu ul li:hover {
+    color: #F7D425;
+}
+}
+div.slicknav_menu li:last-of-type
+    {
+        padding-bottom: 0.7rem;
+    }
+/* ========================================================================== NavMenu ======================================================================= */
+
+.banner {
+  height: 1rem;
+  padding-right: 2rem;
+  max-height: 1rem;  
+  max-width: 50%;
+  vertical-align: middle;
+
+  @media (max-width: 800px) {
+    flex-basis: 66.666%%;
+    max-width: 25%;
+    margin: 1rem;
+
+  }
+}
+
+
+div.box p { 
+text-indent: 0px; 
+position: absolute;
+display: none;
+}
+
+
+#menubar ul { margin: 0; padding: 0; white-space:nowrap; padding-left: 10px; padding-right: 10px; line-height: 2rem;}
+#menubar li { margin: 0; padding: 0;   }
+#menubar a { margin: 0; padding: 0;}
+#menubar ul {list-style: none; text-align: right;}
+#menubar a {text-decoration: none;}
+#menubar li {margin-left: 0;}
+#menubar {height: 70px; background-color: #132445; /* box-shadow: 0px 2px 3px rgba(0,0,0,.4); */ position: relative; padding-right: 2rem; margin-left: -2rem;  margin-right: -2rem;  color: white; font-size: 1.9rem;}
+
+
+#menubar > ul > li {
+
+    display:inline-block;
+    margin: 0.2rem;
+    position: relative;
+    z-index: 10000;
+    flex-basis: 66.666%%;
+    font-weight: 700;
+
+}
+
+#footer {  
+	/*width: 850px;*/
+	background-color: #ffffff; padding: 1.25em; padding-bottom: 0rem;
+	margin-right: 3rem; margin-left: -2rem; margin-top: 1rem; 
+	color: white}
+
+@media only screen and (max-width: 890px) {
+
+#n4js-mobile-logo { 
+    position: absolute;
+    top: 0;
+    left: 0;
+    width: 178px;
+    height: 60px;
+    background-color: transparent;
+}
+
+div.box p { 
+text-indent: -999px; 
+position: absolute;
+}
+
+  #menubar > ul > li, #menubar {
+    visibility: hidden;
+    display: none;
+  }
+
+}
+
+@media only screen and (max-width: 500px) {
+
+
+
+
+#menubar {
+  display: none;
+}
+
+#logo {
+  margin-top: -55px;
+}
+
+}
+
+#logo {
+  height: 40px;
+  margin-left: 40px;
+  margin-top: 17px;
+  position: relative;
+  overflow: hidden;
+}
+
+#menubar > ul > li::after {
+    content: " · ";
+    position: relative;
+    top: 3px;
+    padding-left: 3px;
+    font-weight: 400;
+}
+
+#menubar > ul > li:last-of-type::after {
+  content: none;
+}
+#menubar > ul > li:last-of-type {
+  padding-right: -1rem;
+}
+
+#menubar > ul > li > a {
+    color: #FFFFFF;
+    font-size:  1.2rem;
+    line-height: 50px; 
+    font-weight: 400;
+    /* padding-top: 2rem; */
+    webkit-transition: color .15s;
+    -moz-transition: color .15s;
+    -o-transition: color .15s;
+    transition: color .15s;
+    white-space:nowrap; 
+    -webkit-font-smoothing: auto;
+    letter-spacing: -.01em;
+    padding-top: 0.2em;
+    padding-left: 0rem;
+    padding-right: 0.1rem;
+}
+
+#menubar > ul {
+    margin-right: 12px;
+    margin-top: 0px;
+}
+
+#menubar > ul > li > a:hover {color: #F7D425; }
+body.home li.home, body.tech li.tech {font-weight:bold; }
+
+#menubar > ul > li > ul {
+    opacity: 0;
+    visibility: hidden;
+    padding: 18px 0 20px 0;
+    background-color: #FFFFFF; /* rgb(15,26,54); top menu color */
+    text-align: left;
+    position: absolute;
+    top: 55px;
+    left: 50%;
+    margin-left: -200px;
+-webkit-transition: all .3s .1s;
+   -moz-transition: all .3s .1s;
+     -o-transition: all .3s .1s;
+        transition: all .3s .1s;
+-webkit-border-radius: 5px;
+   -moz-border-radius: 5px;
+        border-radius: 5px;
+-webkit-box-shadow: 0px 1px 3px rgba(0,0,0,.4);
+   -moz-box-shadow: 0px 1px 3px rgba(0,0,0,.4);
+        box-shadow: 0px 1px 3px rgba(0,0,0,.4);
+}
+
+#menubar > li li {
+    width:100%;
+}
+
+#menubar > ul > li:hover > ul {
+    opacity: 1;
+    top: 65px;
+    visibility: visible;
+}
+
+#menubar > ul > li > ul:before{
+    content: '';
+    display: block;
+    border-color: transparent transparent #FFFFFF transparent;
+    border-style: solid;
+    border-width: 10px;
+    position: absolute;
+    top: -20px;
+    left: 10%;
+    margin-left: -10px;
+}
+
+#menubar > ul ul > li { position: relative;}
+
+#menubar ul ul a{
+    color: rgb(50,50,50);
+    font-family:  sans-serif, Verdana, 'Lucida Grande';
+    font-size: 17px;
+    background-color: #FFFFFF; /* rgb(15,26,54); top menu color */
+    padding: 5px 8px 7px 16px;
+    display: block;
+-webkit-transition: background-color .1s;
+   -moz-transition: background-color .1s;
+     -o-transition: background-color .1s;
+        transition: background-color .1s;
+}
+
+#menubar ul ul a:hover {background-color: #244D82; color: #F7D425;}
+
+#menubar ul ul ul {
+    visibility: hidden;
+    opacity: 0;
+    position: absolute;
+    top: -16px;
+    left: 206px;
+    padding: 16px 0 20px 0;
+    background-color: #527AA3;
+    text-align: left;
+    width: 160px;
+-webkit-transition: all .3s;
+   -moz-transition: all .3s;
+     -o-transition: all .3s;
+        transition: all .3s;
+-webkit-border-radius: 5px;
+   -moz-border-radius: 5px;
+        border-radius: 5px;
+-webkit-box-shadow: 0px 1px 3px rgba(0,0,0,.4);
+   -moz-box-shadow: 0px 1px 3px rgba(0,0,0,.4);
+        box-shadow: 0px 1px 3px rgba(0,0,0,.4);
+}
+
+
+#menubar ul ul > li:hover > ul { opacity: 1; left: 196px; visibility: visible;}
+
+
+#menubar ul ul a:hover{
+    background-color: #244D82;
+    color: #F7D425;
+}
+
+
+.Cell--12-12 {
+    -webkit-flex-basis: 100%;
+    -ms-flex-preferred-size: 100%;
+    flex-basis: 100%;
+    max-width: 100%
+}
+
+.Grid {
+    display: -webkit-flex;
+    display: -ms-flexbox;
+    display: flex;
+    -webkit-align-items: stretch;
+    -ms-flex-align: stretch;
+    align-items: stretch;
+    -webkit-flex-wrap: wrap;
+    -ms-flex-wrap: wrap;
+    flex-wrap: wrap;
+    -webkit-flex: 0 1 auto;
+    -ms-flex: 0 1 auto;
+    flex: 0 1 auto;
+    -webkit-flex-direction: row;
+    -ms-flex-direction: row;
+    flex-direction: row
+}
+
+.Cell,
+.Comparison .Comparison-left,
+.Comparison .Comparison-right,
+.ExampleExplanation .ExampleExplanation-code,
+.ExampleExplanation .ExampleExplanation-text,
+.FeatureTabs .FeatureTabs-stage,
+.Intro .Intro-Slogan {
+    padding-left: 1rem;
+    padding-right: 1rem;
+    -webkit-flex: 0 0 auto;
+    -ms-flex: 0 0 auto;
+    flex: 0 0 auto
+}
+
+#_index, #_feature_table {display: none;}
+
+#_documentation {margin-top: -2rem;}
+
+h3 {padding-top: 1rem}
+
+/* ========================================================================== AsciiSpec ======================================================================= */
+.requirement {
+	border: 1px solid #aaaaaa;
+	padding: 0.5em;
+	margin-bottom: 1rem;
+}
+
+.bibliography .content .paragraph p :first-child::before { 
+	color:#777777;
+	content: "[" attr(id) "] "; }
+
+.bibliography .content .paragraph {
+	padding-left: 6em;
+	text-indent: -6em;
\ No newline at end of file
diff --git a/spec/styles/styles.min.css b/spec/styles/styles.min.css
new file mode 100644
index 0000000..8cc9d44
--- /dev/null
+++ b/spec/styles/styles.min.css
@@ -0,0 +1 @@
+@charset "UTF-8";*,:after,:before{position:relative;margin:0;padding:0;box-sizing:inherit}button,input,select,textarea{font:inherit;-webkit-appearance:none;-moz-appearance:none;appearance:none}input[type=checkbox]{-webkit-appearance:checkbox;-moz-appearance:checkbox;appearance:checkbox}input[type=radio]{-webkit-appearance:radio;-moz-appearance:radio;appearance:radio}table{border-collapse:collapse}html{box-sizing:border-box;font-size:10px}.Comparison,.ExampleExplanation,.FeatureTable,.Grid{display:-webkit-flex;display:-ms-flexbox;display:flex;-webkit-align-items:stretch;-ms-flex-align:stretch;align-items:stretch;-webkit-flex-wrap:wrap;-ms-flex-wrap:wrap;flex-wrap:wrap;-webkit-flex:0 1 auto;-ms-flex:0 1 auto;flex:0 1 auto;-webkit-flex-direction:row;-ms-flex-direction:row;flex-direction:row}.Comparison,.ExampleExplanation,.Grid--fullWidth{margin-left:-2rem;margin-right:-2rem}.Comparison .Cell:first-child,.Comparison .Comparison-left:first-child,.Comparison .Comparison-right:first-child,.Comparison .FeatureTabs .FeatureTabs-stage:first-child,.Comparison .Intro .Intro-Slogan:first-child,.ExampleExplanation .Cell:first-child,.ExampleExplanation .ExampleExplanation-code:first-child,.ExampleExplanation .ExampleExplanation-text:first-child,.ExampleExplanation .FeatureTabs .FeatureTabs-stage:first-child,.ExampleExplanation .Intro .Intro-Slogan:first-child,.FeatureTabs .Comparison .FeatureTabs-stage:first-child,.FeatureTabs .ExampleExplanation .FeatureTabs-stage:first-child,.FeatureTabs .Grid--fullWidth .FeatureTabs-stage:first-child,.Grid--fullWidth .Cell:first-child,.Grid--fullWidth .FeatureTabs .FeatureTabs-stage:first-child,.Grid--fullWidth .Intro .Intro-Slogan:first-child,.Intro .Comparison .Intro-Slogan:first-child,.Intro .ExampleExplanation .Intro-Slogan:first-child,.Intro .Grid--fullWidth .Intro-Slogan:first-child{padding-left:4rem}.Comparison .Cell:last-child,.Comparison .Comparison-left:last-child,.Comparison .Comparison-right:last-child,.Comparison .FeatureTabs .FeatureTabs-stage:last-child,.Comparison .Intro .Intro-Slogan:last-child,.ExampleExplanation .Cell:last-child,.ExampleExplanation .ExampleExplanation-code:last-child,.ExampleExplanation .ExampleExplanation-text:last-child,.ExampleExplanation .FeatureTabs .FeatureTabs-stage:last-child,.ExampleExplanation .Intro .Intro-Slogan:last-child,.FeatureTabs .Comparison .FeatureTabs-stage:last-child,.FeatureTabs .ExampleExplanation .FeatureTabs-stage:last-child,.FeatureTabs .Grid--fullWidth .FeatureTabs-stage:last-child,.Grid--fullWidth .Cell:last-child,.Grid--fullWidth .FeatureTabs .FeatureTabs-stage:last-child,.Grid--fullWidth .Intro .Intro-Slogan:last-child,.Intro .Comparison .Intro-Slogan:last-child,.Intro .ExampleExplanation .Intro-Slogan:last-child,.Intro .Grid--fullWidth .Intro-Slogan:last-child{padding-right:4rem}@media (max-width:800px){.Comparison,.ExampleExplanation,.Grid--fullWidth{margin-left:-.75rem;margin-right:-.75rem}.Comparison .Cell:first-child,.Comparison .Cell:last-child,.Comparison .Comparison-left:first-child,.Comparison .Comparison-left:last-child,.Comparison .Comparison-right:first-child,.Comparison .Comparison-right:last-child,.Comparison .FeatureTabs .FeatureTabs-stage:first-child,.Comparison .FeatureTabs .FeatureTabs-stage:last-child,.Comparison .Intro .Intro-Slogan:first-child,.Comparison .Intro .Intro-Slogan:last-child,.ExampleExplanation .Cell:first-child,.ExampleExplanation .Cell:last-child,.ExampleExplanation .ExampleExplanation-code:first-child,.ExampleExplanation .ExampleExplanation-code:last-child,.ExampleExplanation .ExampleExplanation-text:first-child,.ExampleExplanation .ExampleExplanation-text:last-child,.ExampleExplanation .FeatureTabs .FeatureTabs-stage:first-child,.ExampleExplanation .FeatureTabs .FeatureTabs-stage:last-child,.ExampleExplanation .Intro .Intro-Slogan:first-child,.ExampleExplanation .Intro .Intro-Slogan:last-child,.FeatureTabs .Comparison .FeatureTabs-stage:first-child,.FeatureTabs .Comparison .FeatureTabs-stage:last-child,.FeatureTabs .ExampleExplanation .FeatureTabs-stage:first-child,.FeatureTabs .ExampleExplanation .FeatureTabs-stage:last-child,.FeatureTabs .Grid--fullWidth .FeatureTabs-stage:first-child,.FeatureTabs .Grid--fullWidth .FeatureTabs-stage:last-child,.Grid--fullWidth .Cell:first-child,.Grid--fullWidth .Cell:last-child,.Grid--fullWidth .FeatureTabs .FeatureTabs-stage:first-child,.Grid--fullWidth .FeatureTabs .FeatureTabs-stage:last-child,.Grid--fullWidth .Intro .Intro-Slogan:first-child,.Grid--fullWidth .Intro .Intro-Slogan:last-child,.Intro .Comparison .Intro-Slogan:first-child,.Intro .Comparison .Intro-Slogan:last-child,.Intro .ExampleExplanation .Intro-Slogan:first-child,.Intro .ExampleExplanation .Intro-Slogan:last-child,.Intro .Grid--fullWidth .Intro-Slogan:first-child,.Intro .Grid--fullWidth .Intro-Slogan:last-child{padding-left:1.5rem}}.Example,.Image.Image--fullWidth,.TODO,.u-fullWidth{margin-left:-2rem;margin-right:-2rem;padding-left:4rem;padding-right:4rem}.Cell,.Comparison .Comparison-left,.Comparison .Comparison-right,.ExampleExplanation .ExampleExplanation-code,.ExampleExplanation .ExampleExplanation-text,.FeatureTabs .FeatureTabs-stage,.Intro .Intro-Slogan{padding-left:2rem;padding-right:2rem;-webkit-flex:0 0 auto;-ms-flex:0 0 auto;flex:0 0 auto}@media (max-width:800px){.Cell,.Comparison .Comparison-left,.Comparison .Comparison-right,.ExampleExplanation .ExampleExplanation-code,.ExampleExplanation .ExampleExplanation-text,.FeatureTabs .FeatureTabs-stage,.Intro .Intro-Slogan{-webkit-flex-basis:100%;-ms-flex-preferred-size:100%;flex-basis:100%;max-width:100%}.m-Cell--withMargin{margin-bottom:3rem}}.Cell--3-12{-webkit-flex-basis:25%;-ms-flex-preferred-size:25%;flex-basis:25%;max-width:25%}.Nav,.u-width--3-12,nav.Nav--bottom,nav.Nav--top{max-width:25%;width:100%}@media (max-width:800px){.Nav,.u-width--3-12,nav.Nav--bottom,nav.Nav--top{max-width:100%}}.Cell--4-12,.ExampleExplanation .ExampleExplanation-text{-webkit-flex-basis:33.333%;-ms-flex-preferred-size:33.333%;flex-basis:33.333%;max-width:33.333%}@media (max-width:800px){.Cell--4-12,.ExampleExplanation .ExampleExplanation-text{-webkit-flex-basis:100%;-ms-flex-preferred-size:100%;flex-basis:100%;max-width:100%}}.Cell--6-12,.Comparison .Comparison-left,.Comparison .Comparison-right{-webkit-flex-basis:50%;-ms-flex-preferred-size:50%;flex-basis:50%;max-width:50%}@media (max-width:800px){.Cell--6-12,.Comparison .Comparison-left,.Comparison .Comparison-right{-webkit-flex-basis:100%;-ms-flex-preferred-size:100%;flex-basis:100%;max-width:100%}}.Cell--8-12,.ExampleExplanation .ExampleExplanation-code{-webkit-flex-basis:66.666%;-ms-flex-preferred-size:66.666%;flex-basis:66.666%;max-width:66.666%}@media (max-width:800px){.Cell--8-12,.ExampleExplanation .ExampleExplanation-code{-webkit-flex-basis:100%;-ms-flex-preferred-size:100%;flex-basis:100%;max-width:100%}}.Main article.Article--noGrid>.Image:not(.Image--fullWidth),.Main article.Article--noGrid>h1,.Main article.Article--noGrid>h2,.Main article.Article--noGrid>h3,.Main article.Article--noGrid>h4,.Main article.Article--noGrid>img,.Main article.Article--noGrid>ol,.Main article.Article--noGrid>p,.Main article.Article--noGrid>table,.Main article.Article--noGrid>ul,.u-width--8-12,main article.Article--noGrid>.Image:not(.Image--fullWidth),main article.Article--noGrid>h1,main article.Article--noGrid>h2,main article.Article--noGrid>h3,main article.Article--noGrid>h4,main article.Article--noGrid>img,main article.Article--noGrid>ol,main article.Article--noGrid>p,main article.Article--noGrid>table,main article.Article--noGrid>ul{max-width:66.666%;width:100%}@media (max-width:800px){.Main article.Article--noGrid>.Image:not(.Image--fullWidth),.Main article.Article--noGrid>h1,.Main article.Article--noGrid>h2,.Main article.Article--noGrid>h3,.Main article.Article--noGrid>h4,.Main article.Article--noGrid>img,.Main article.Article--noGrid>ol,.Main article.Article--noGrid>p,.Main article.Article--noGrid>table,.Main article.Article--noGrid>ul,.u-width--8-12,main article.Article--noGrid>.Image:not(.Image--fullWidth),main article.Article--noGrid>h1,main article.Article--noGrid>h2,main article.Article--noGrid>h3,main article.Article--noGrid>h4,main article.Article--noGrid>img,main article.Article--noGrid>ol,main article.Article--noGrid>p,main article.Article--noGrid>table,main article.Article--noGrid>ul{max-width:100%}}.Cell--9-12,.FeatureTabs .FeatureTabs-stage,.Intro .Intro-Slogan{-webkit-flex-basis:75%;-ms-flex-preferred-size:75%;flex-basis:75%;max-width:75%}.Cell--12-12{-webkit-flex-basis:100%;-ms-flex-preferred-size:100%;flex-basis:100%;max-width:100%}.Sans,body{font-family:sans-serif;font-weight:400}.FeatureTable .section,.H2,.H3,.H4,.Introduction,.Sans--bold,.Serif--bold,h1,h2,h3,h4,ul li:before{font-family:sans-serif;font-weight:600}body{font-size:1.9rem;line-height:1.4;color:#212121;background-color:#527aa3}h1{font-size:2em;margin-top:0;margin-bottom:4rem;color:#244d82}.FeatureTable .section,.H2,.H3,h2,h3{margin-top:4rem;margin-bottom:2rem}.FeatureTable .section,.H2,h2{font-size:1.3em;color:#244d82}.H3,.H4,h3,h4{font-size:1em}.H4,h4{margin-top:.5em;margin-bottom:0}ol,p,ul{margin-bottom:.5em}.Link,a{color:#6999d6}a:hover{color:#132445}.Link.Link--action,a.Link--action{color:#f7d425;text-decoration:none}.Link.Link--action:hover,a.Link--action:hover{text-decoration:underline}.Example .Example-caption,.FeatureTable,.FeatureTabs .FeatureTabs-stage ul,.Image .Image-caption,.SystemRequirements,.u-small,small{font-size:.8em;line-height:1.4em}ol ol,ol ul,ul ol,ul ul{margin-left:2em}ol li,ul li{margin-bottom:.2em}ol{margin-left:1.2em}ul{margin-left:.75em}ul li{list-style:none}ul li:before{content:"›";margin-left:-.75em;margin-right:.4em;color:#244d82}code{font-family:Fira Mono,Monaco,Consolas,Courier New,Courier,mono,serif;font-size:.85em;letter-spacing:.02em}img{width:100%;height:auto}h1:first-child,h2:first-child,h3:first-child{margin-top:0}.Main,.Page,footer,header,main{width:100%;max-width:1050px;margin-right:auto;margin-left:auto;padding-left:2rem;padding-right:2rem}.Main,main{background-color:#fff;position:relative}footer,header{background-color:#132445}.Main article,main article{margin-top:4rem;margin-bottom:4rem}.Main article:first-of-type,main article:first-of-type{margin-top:0;padding-top:0}@media (max-width:800px){.Main,.Page,footer,header,main{padding-left:.75rem;padding-right:.75rem}.Main article:first-of-type,main article:first-of-type{padding-top:1.5rem}}.Main article:last-of-type,main article:last-of-type{margin-bottom:0;padding-bottom:4rem}.Main article.Article--noGrid>h1,.Main article.Article--noGrid>h2,.Main article.Article--noGrid>h3,.Main article.Article--noGrid>h4,.Main article.Article--noGrid>ol,.Main article.Article--noGrid>p,.Main article.Article--noGrid>ul,main article.Article--noGrid>h1,main article.Article--noGrid>h2,main article.Article--noGrid>h3,main article.Article--noGrid>h4,main article.Article--noGrid>ol,main article.Article--noGrid>p,main article.Article--noGrid>ul{padding-left:2rem}@media (max-width:800px){.Main article.Article--noGrid>h1,.Main article.Article--noGrid>h2,.Main article.Article--noGrid>h3,.Main article.Article--noGrid>h4,.Main article.Article--noGrid>ol,.Main article.Article--noGrid>p,.Main article.Article--noGrid>ul,main article.Article--noGrid>h1,main article.Article--noGrid>h2,main article.Article--noGrid>h3,main article.Article--noGrid>h4,main article.Article--noGrid>ol,main article.Article--noGrid>p,main article.Article--noGrid>ul{padding-left:.75rem;padding-right:.75rem}}.Main article.Article--noGrid>table,main article.Article--noGrid>table{margin-left:2rem;margin-right:2rem;margin-bottom:2rem}.Main article.Article--noGrid>table td,.Main article.Article--noGrid>table th,main article.Article--noGrid>table td,main article.Article--noGrid>table th{padding:.2em .5em}.Main article.Article--noGrid>table th,main article.Article--noGrid>table th{text-align:left}.Main article.Article--noGrid>.Image:not(.Image--fullWidth),.Main article.Article--noGrid>img,main article.Article--noGrid>.Image:not(.Image--fullWidth),main article.Article--noGrid>img{padding-left:2rem;margin-top:2rem;margin-bottom:2rem}header{height:7rem;color:#fff;padding-top:1.7rem;padding-bottom:.8rem}header img{height:4rem;width:auto;margin:0}header nav{border:none;line-height:1em;padding-top:1.8rem;text-align:right}header nav a{display:inline-block;text-decoration:none;padding:0 1rem;transition:color .3s;color:#fff}header nav a.is-active,header nav a:hover{color:#f7d425}header nav a:last-child{padding-right:16px}footer{color:#fff;padding-top:2rem;padding-bottom:2rem}footer a{color:#d5dfea}footer a:hover{color:#F7D425}footer .Link--action{float:right}footer a,footer a:hover{text-decoration:none}.Nav,nav.Nav--bottom,nav.Nav--top{position:absolute;z-index:1;padding-left:2rem;border-left:1px solid #d3d3d3}@media (max-width:800px){header{height:auto}header img{max-width:100%;max-height:4rem;height:auto}header nav{display:none}footer{text-align:center}footer .Link--action{display:block;width:100%;float:none}.Nav,nav.Nav--bottom,nav.Nav--top{position:static;width:100%;padding-left:.75rem;border-left:none;padding-top:1.5rem;padding-bottom:3rem;border-bottom:1px solid #d3d3d3}}.Nav li:last-child,.Nav ul,nav.Nav--bottom li:last-child,nav.Nav--bottom ul,nav.Nav--top li:last-child,nav.Nav--top ul{margin-bottom:0}.Nav a,nav.Nav--bottom a,nav.Nav--top a{text-decoration:none;color:rgba(0,0,0,.3);transition:.2s}.Nav a.is-active,.Nav a:hover,nav.Nav--bottom a.is-active,nav.Nav--bottom a:hover,nav.Nav--top a.is-active,nav.Nav--top a:hover{color:#212121}.Nav.Nav--top,nav.Nav--bottom.Nav--top,nav.Nav--top.Nav--top{right:4rem;top:4rem}.Nav.Nav--bottom,nav.Nav--bottom.Nav--bottom,nav.Nav--top.Nav--bottom{right:4rem;bottom:4rem}.Intro{background-color:#244d82;padding:4rem 0;margin-bottom:-4rem;position:relative}@media (max-width:800px){.Intro{padding:0}}.Intro .Intro-Slogan{color:#fff;font-size:2em;padding:1rem 0;margin:0 auto}@media (max-width:800px){.Intro .Intro-Slogan{-webkit-flex-basis:100%;-ms-flex-preferred-size:100%;flex-basis:100%;max-width:100%;font-size:1.4em;padding:.5rem 2.5rem 1rem;padding-left:2.5rem!important}}.Intro img{z-index:1;margin:0;height:100%;width:100%}.Intro:after{content:"";position:absolute;left:0;right:0;bottom:0;top:65%;z-index:0;background-color:#fff}.GettingStarted{background-color:#fbffb4;padding:4rem 0}@media (max-width:800px){.GettingStarted h2{padding-left:1.5rem}}.GettingStarted .GettingStarted-u-paddingLeft{padding-left:4rem}.GettingStarted .GettingStarted-u-paddingRight{padding-right:4rem}@media (max-width:800px){.GettingStarted .GettingStarted-u-paddingLeft{margin-bottom:3rem;padding-left:3rem}.GettingStarted .GettingStarted-u-paddingRight{padding-right:3rem}}.SystemRequirements{color:rgba(0,0,0,.3);margin-top:2rem}.Comparison,.TODO{margin-top:4rem;margin-bottom:4rem}.TODO{padding-top:.5em;padding-bottom:.5em;color:#fff;background-color:#f39797}.TODO:before{content:"TODO: ";font-weight:700}.Comparison .Comparison-left{border-right:1px solid #d3d3d3}.Comparison .Comparison-left .Example,.Comparison .Comparison-left .Example-caption{margin-left:-4rem;margin-right:-2rem;padding-left:4rem;padding-right:2rem}.Comparison .Comparison-right .Example,.Comparison .Comparison-right .Example-caption{margin-left:-2rem;margin-right:-4rem;padding-left:2rem;padding-right:4rem}@media (max-width:800px){.Comparison .Comparison-left .Example,.Comparison .Comparison-left .Example-caption,.Comparison .Comparison-right .Example{padding-left:4rem;padding-right:4rem}.Comparison .Comparison-left .Example-caption{margin-right:-4rem}.Comparison .Comparison-right .Example-caption{padding-left:4rem;padding-right:4rem;margin-left:-4rem}}.Example{margin-top:2rem;margin-bottom:2rem}.Example .Example-code,.Example .dp-highlighter{padding-top:2rem;padding-bottom:2rem}.Example .Example-caption{margin-left:-4rem;margin-right:-4rem;padding:.5rem 4rem;background-color:#d5dfea}.ExampleExplanation{margin-top:4rem;margin-bottom:4rem}.ExampleExplanation .ExampleExplanation-text{background-color:#d5dfea;padding-top:2rem;padding-bottom:2rem}.ExampleExplanation .ExampleExplanation-code{padding-top:2rem;padding-bottom:2rem}.ExampleExplanation .ExampleExplanation-code .Example,.ExampleExplanation .ExampleExplanation-code .dp-highlighter{margin:0;padding:0}.Example,.ExampleExplanation-code{background-color:#f5f7fa}.Example .dp-highlighter,.ExampleExplanation-code .dp-highlighter{font-family:Fira Mono,Monaco,Consolas,Courier New,Courier,mono,serif;font-size:.7em;line-height:1.4em;overflow:auto}.Example .dp-highlighter ol,.Example .dp-highlighter ol li,.Example .dp-highlighter ol li span,.ExampleExplanation-code .dp-highlighter ol,.ExampleExplanation-code .dp-highlighter ol li,.ExampleExplanation-code .dp-highlighter ol li span{margin:0;padding:0;border:none}.Example .dp-highlighter ol li,.ExampleExplanation-code .dp-highlighter ol li{white-space:nowrap}.Example .dp-highlighter a,.Example .dp-highlighter a:hover,.ExampleExplanation-code .dp-highlighter a,.ExampleExplanation-code .dp-highlighter a:hover{background:0 0;border:none;padding:0;margin:0}.Example .dp-highlighter .bar,.ExampleExplanation-code .dp-highlighter .bar{padding-left:45px}.Example .dp-highlighter.collapsed .bar,.Example .dp-highlighter.nogutter .bar,.ExampleExplanation-code .dp-highlighter.collapsed .bar,.ExampleExplanation-code .dp-highlighter.nogutter .bar{padding-left:0}.Example .dp-highlighter ol,.ExampleExplanation-code .dp-highlighter ol{list-style:decimal;margin:0 0 0 34px!important;padding:0;color:rgba(0,0,0,.3)}.Example .dp-highlighter.nogutter ol,.Example .dp-highlighter.nogutter ol li,.ExampleExplanation-code .dp-highlighter.nogutter ol,.ExampleExplanation-code .dp-highlighter.nogutter ol li{list-style:none!important;margin-left:0!important}.Example .dp-highlighter .columns div,.Example .dp-highlighter ol li,.ExampleExplanation-code .dp-highlighter .columns div,.ExampleExplanation-code .dp-highlighter ol li{list-style:decimal-leading-zero;list-style-position:outside!important;margin:0!important;line-height:1.4em}.Example .dp-highlighter.nogutter .columns div,.Example .dp-highlighter.nogutter ol li,.ExampleExplanation-code .dp-highlighter.nogutter .columns div,.ExampleExplanation-code .dp-highlighter.nogutter ol li{border:0}.Example .dp-highlighter .columns,.ExampleExplanation-code .dp-highlighter .columns{background-color:#f8f8f8;color:gray;overflow:hidden;width:100%}.Example .dp-highlighter .columns div,.ExampleExplanation-code .dp-highlighter .columns div{padding-bottom:5px}.Example .dp-highlighter ol li.alt,.ExampleExplanation-code .dp-highlighter ol li.alt{color:inherit}.Example .dp-highlighter ol li span,.ExampleExplanation-code .dp-highlighter ol li span{color:#000;background-color:inherit}.Example .dp-highlighter.collapsed ol,.ExampleExplanation-code .dp-highlighter.collapsed ol{margin:0}.Example .dp-highlighter.collapsed ol li,.ExampleExplanation-code .dp-highlighter.collapsed ol li{display:none}.Example .dp-highlighter.printing,.ExampleExplanation-code .dp-highlighter.printing{border:none}.Example .dp-highlighter.printing .tools,.ExampleExplanation-code .dp-highlighter.printing .tools{display:none!important}.Example .dp-highlighter.printing li,.ExampleExplanation-code .dp-highlighter.printing li{display:list-item!important}.Example .dp-highlighter .tools,.ExampleExplanation-code .dp-highlighter .tools{padding:3px 8px 10px 10px;font:9px Verdana,Geneva,Arial,Helvetica,sans-serif;color:silver;border-left:1px solid #000}.Example .dp-highlighter.nogutter .tools,.ExampleExplanation-code .dp-highlighter.nogutter .tools{border-left:0}.Example .dp-highlighter.collapsed .tools,.ExampleExplanation-code .dp-highlighter.collapsed .tools{border-bottom:0}.Example .dp-highlighter .tools a,.ExampleExplanation-code .dp-highlighter .tools a{font-size:9px;color:#a0a0a0;text-decoration:none;margin-right:10px}.Example .dp-highlighter .tools a:hover,.ExampleExplanation-code .dp-highlighter .tools a:hover{color:red;background-color:inherit;text-decoration:underline}.Example .dp-about,.ExampleExplanation-code .dp-about{background-color:#fff;color:#333;margin:0;padding:0}.Example .dp-about table,.ExampleExplanation-code .dp-about table{width:100%;height:100%;font-size:11px;font-family:Tahoma,Verdana,Arial,sans-serif!important}.Example .dp-about td,.ExampleExplanation-code .dp-about td{padding:10px;vertical-align:top}.Example .dp-about .copy,.ExampleExplanation-code .dp-about .copy{border-bottom:1px solid #aca899;height:95%}.Example .dp-about .title,.ExampleExplanation-code .dp-about .title{color:red;background-color:inherit;font-weight:700}.Example .dp-about .para,.ExampleExplanation-code .dp-about .para{margin:0 0 4px}.Image,.Table{margin-bottom:2rem;margin-top:2rem}.Example .dp-about .footer,.ExampleExplanation-code .dp-about .footer{background-color:#eceadb;color:#333;border-top:1px solid #fff;text-align:right}.Example .dp-about .close,.ExampleExplanation-code .dp-about .close{font-size:11px;font-family:Tahoma,Verdana,Arial,sans-serif!important;background-color:#eceadb;color:#333;width:60px;height:22px}.Example .dp-highlighter .comment,.Example .dp-highlighter .comments,.ExampleExplanation-code .dp-highlighter .comment,.ExampleExplanation-code .dp-highlighter .comments{color:#3f6a4d;background-color:inherit}.Example .dp-highlighter .string,.ExampleExplanation-code .dp-highlighter .string{color:#101af9;background-color:inherit}.Example .dp-highlighter .keyword,.ExampleExplanation-code .dp-highlighter .keyword{color:#5f1441;font-weight:700;background-color:inherit}.Example .dp-highlighter .annotation,.ExampleExplanation-code .dp-highlighter .annotation{color:red;font-weight:700;background-color:inherit}.Example .dp-highlighter .preprocessor,.ExampleExplanation-code .dp-highlighter .preprocessor{color:#0f0;background-color:inherit}.Image{position:relative;text-align:center}.Image .Image-caption{padding-top:.5rem;padding-bottom:.5rem;text-align:left}.Image img{max-width:100%;max-height:100%;height:auto;width:auto}.Table th{background-color:#d5dfea}.Table td,.Table th,.Table tr{border:0 solid #d3d3d3}.Table.Table--horizontalLines tr{border-top-width:1px}.Table.Table--horizontalLines tr:last-child{border-bottom-width:1px}.Table.Table--verticalLines td,.Table.Table--verticalLines th{border-left-width:1px}.Table.Table--verticalLines td:last-child,.Table.Table--verticalLines th:last-child{border-right-width:1px}.FeatureTable tr:first-child th:first-child{width:25%}.FeatureTable .section{padding:1.5em 0 .5em}.FeatureTable .done{background-color:#efe}.FeatureTable .most{background-color:#ffd}.FeatureTable .tbc{background-color:#fff6de}.FeatureTable .tbd{background-color:#fee}.FeatureTabs .FeatureTabs-nav{background-color:#f5f7fa}.FeatureTabs .FeatureTabs-nav ul{margin-bottom:0;margin-left:0}@media (max-width:800px){.FeatureTabs .FeatureTabs-nav ul{display:none}}.FeatureTabs .FeatureTabs-nav ul li{display:block;padding-top:2rem;padding-bottom:2rem;border-bottom:1px solid #d3d3d3}.FeatureTabs .FeatureTabs-nav ul li:before{display:none}.FeatureTabs .FeatureTabs-nav ul li:last-child{border-bottom:none}.FeatureTabs .FeatureTabs-nav a{text-decoration:none;color:rgba(0,0,0,.3);transition:.3s}.FeatureTabs .FeatureTabs-nav a.is-activeTab,.FeatureTabs .FeatureTabs-nav a:hover{color:#212121}.FeatureTabs .FeatureTabs-stage{display:none;background-color:#d5dfea;padding-top:2rem;padding-bottom:2rem}.FeatureTabs .FeatureTabs-stage.is-activeTab{display:block}.FeatureTabs .FeatureTabs-stage img{margin-bottom:2rem}@media (max-width:800px){.FeatureTabs .FeatureTabs-stage{display:block;-webkit-flex-basis:100%;-ms-flex-preferred-size:100%;flex-basis:100%;max-width:100%;border-bottom:1px solid #94afc9;padding-left:3.75rem;padding-right:3.75rem}.FeatureTabs .FeatureTabs-stage h2{margin-bottom:.5rem}}.FeatureTabs .FeatureTabs-stage ul{display:-webkit-flex;display:-ms-flexbox;display:flex;margin-left:0;margin-top:2rem;color:rgba(0,0,0,.3)}.FeatureTabs .FeatureTabs-stage ul li{-webkit-flex-grow:1;-ms-flex-positive:1;flex-grow:1;padding-right:1rem}@media (max-width:800px){.FeatureTabs .FeatureTabs-stage ul{margin-top:.5rem;margin-bottom:1.5rem;display:block}.FeatureTabs .FeatureTabs-stage ul li{-webkit-flex-grow:none;-ms-flex-positive:none;flex-grow:none;width:100%;display:block}}.FeatureTabs .FeatureTabs-stage ul li:before{content:"✓";margin:0 .3em 0 0}.FeatureTabs .FeatureTabs-stage a{text-decoration:none;color:#244d82}.FeatureTabs .FeatureTabs-stage a:hover{text-decoration:underline}#community ul{padding-bottom:1rem;padding-top:1em}footer.social{line-height:1.4;color:#FFF;font-size:1.2rem;font-weight:400;font-style:bold;background-color:#132445}footer.social li a{margin-bottom:2em;color:#d5dfea;font-size:1.8rem;font-weight:400;font-style:bold;list-style:none;text-decoration-color:#d5dfea}footer.social a:hover{color:#F7D425}footer.social:first-child{margin-top:0}footer.social h2{margin-bottom:20px;font-weight:600;font-size:1.3em;margin-top:4rem;color:#244d82;font-family:sans-serif}footer.social li:before{content:"› ";color:#244d82;font-size:large;font-weight:800}footer.social ul{margin-top:-10px;line-height:30px}footer.social li{display:-webkit-inline-box;padding-right:10rem;padding-bottom:1rem}
diff --git a/spec/types.html b/spec/types.html
new file mode 100644
index 0000000..1d358a6
--- /dev/null
+++ b/spec/types.html
@@ -0,0 +1,4867 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="generator" content="Asciidoctor 1.5.5">
+<meta name="author" content="2019-08-07 15:02:40 CEST">
+<title>N4JS Language Specification</title>
+<link rel="stylesheet" href="styles/spec.min.css">
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.6.3/css/font-awesome.min.css">
+<!-- ************* docinfo ******************************************************************* -->
+
+
+<!-- ************* Favicon ************-->
+<link rel="icon" href="images/favicon.ico" />
+
+<!-- ************* Back-to-top JQuery ************* -->
+<script src="https://code.jquery.com/jquery-1.12.4.js"></script>
+<script src="https://code.jquery.com/ui/1.12.0/jquery-ui.js"></script>
+
+
+<link href="styles/prism.min.css" rel="stylesheet" />
+<script type="text/javascript" async
+  src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2/MathJax.js?config=TeX-MML-AM_CHTML">
+</script>
+
+<!-- ************* Styles ************* -->
+<link rel="stylesheet" type="text/css" href="styles/n4jsspec-adoc.css">
+
+
+<!-- ****************** NavBar ****************** -->
+<div id="menubar">
+	<div class="banner">
+        <a href="https://www.eclipse.org/n4js/#"><img id="logo" src="images/n4js-logo.png" alt="Eclipse N4JS"></a>
+    </div>
+<ul>
+  <li><a href="index.html">Index</a></li>
+</ul>
+</div>
+<!-- ************* docinfo ******************************************************************* -->
+<style>
+      .admonitionblock td.icon .icon-todo:before{content:"\f249";color:#f4ee42}
+    </style>
+</head>
+<body class="book toc2 toc-left">
+<div id="header">
+<h1>N4JS Language Specification</h1>
+<div class="details">
+<span id="author" class="author">2019-08-07 15:02:40 CEST</span><br>
+<span id="revnumber">version 0.9</span>
+</div>
+<div id="toc" class="toc2">
+<div id="toctitle">Table of Contents</div>
+<ul class="sectlevel1">
+<li><a href="introduction.html#_introduction">1. Introduction</a>
+<ul class="sectlevel2">
+<li><a href="introduction.html#_notation">1.1. Notation</a>
+<ul class="sectlevel3">
+<li><a href="introduction.html#_grammar-notation">1.1.1. Grammar Notation</a></li>
+<li><a href="introduction.html#_type-judgments-and-rules-and-constraints-notation">1.1.2. Type Judgments and Rules and Constraints Notation</a>
+<ul class="sectlevel4">
+<li><a href="introduction.html#_typing-rules-and-judgments">1.1.2.1. Typing Rules and Judgments</a></li>
+<li><a href="introduction.html#_types-of-an-element">1.1.2.2. Types of an Element</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="introduction.html#_auxiliary-functions">1.2. Auxiliary Functions</a>
+<ul class="sectlevel3">
+<li><a href="introduction.html#_binding">1.2.1. Binding</a></li>
+<li><a href="introduction.html#_merging-types">1.2.2. Merging Types</a>
+<ul class="sectlevel4">
+<li><a href="introduction.html#_logic-formulas">1.2.2.1. Logic Formulas</a></li>
+</ul>
+</li>
+<li><a href="introduction.html#_symbols-and-font-convention">1.2.3. Symbols and Font Convention</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="grammar.html#_grammar">2. Grammar</a>
+<ul class="sectlevel2">
+<li><a href="grammar.html#_lexical-conventions">2.1. Lexical Conventions</a>
+<ul class="sectlevel3">
+<li><a href="grammar.html#_identifier-names-and-identifiers">2.1.1. Identifier Names and Identifiers</a></li>
+<li><a href="grammar.html#_this-keyword">2.1.2. This Keyword</a></li>
+<li><a href="grammar.html#_regular-expression-literals">2.1.3. Regular Expression Literals</a></li>
+<li><a href="grammar.html#_automatic-semicolon-insertion">2.1.4. Automatic Semicolon Insertion</a></li>
+<li><a href="grammar.html#_jsdoc">2.1.5. JSDoc</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="names.html#_names">3. Names</a>
+<ul class="sectlevel2">
+<li><a href="names.html#_access-control">3.1. Access Control</a></li>
+<li><a href="names.html#_accessibility-of-types-top-level-variables-and-function-declarations">3.2. Accessibility of Types, Top-Level Variables and Function Declarations</a>
+<ul class="sectlevel3">
+<li><a href="names.html#_accessibility-of-members">3.2.1. Accessibility of Members</a></li>
+<li><a href="names.html#_valid-names">3.2.2. Valid Names</a></li>
+<li><a href="names.html#_qualified-names">3.2.3. Qualified Names</a></li>
+<li><a href="names.html#_name-duplicates">3.2.4. Name Duplicates</a>
+<ul class="sectlevel4">
+<li><a href="names.html#_lexical-environment">3.2.4.1. Lexical Environment</a></li>
+<li><a href="names.html#_duplicates-and-shadowing">3.2.4.2. Duplicates and Shadowing</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#_types">4. Types</a>
+<ul class="sectlevel2">
+<li><a href="#_overview">4.1. Overview</a></li>
+<li><a href="#_type-expressions">4.2. Type Expressions</a>
+<ul class="sectlevel3">
+<li><a href="#_syntax">4.2.1. Syntax</a></li>
+<li><a href="#_properties">4.2.2. Properties</a></li>
+<li><a href="#_semantics">4.2.3. Semantics</a></li>
+</ul>
+</li>
+<li><a href="#_type-inference">4.3. Type Inference</a></li>
+<li><a href="#_generic-and-parameterized-types">4.4. Generic and Parameterized Types</a>
+<ul class="sectlevel3">
+<li><a href="#_generic-types">4.4.1. Generic Types</a></li>
+<li><a href="#_type-variables">4.4.2. Type Variables</a></li>
+<li><a href="#_parameterized-types">4.4.3. Parameterized Types</a></li>
+</ul>
+</li>
+<li><a href="#_primitive-ecmascript-types">4.5. Primitive ECMAScript Types</a>
+<ul class="sectlevel3">
+<li><a href="#_undefined-type">4.5.1. Undefined Type</a></li>
+<li><a href="#_null-type">4.5.2. Null Type</a></li>
+<li><a href="#_primitive-boolean-type">4.5.3. Primitive Boolean Type</a></li>
+<li><a href="#_primitive-string-type">4.5.4. Primitive String Type</a></li>
+<li><a href="#_primitive-number-type">4.5.5. Primitive Number Type</a></li>
+<li><a href="#_primitive-type-int">4.5.6. Primitive Type int</a></li>
+<li><a href="#_primitive-symbol-type">4.5.7. Primitive Symbol Type</a></li>
+</ul>
+</li>
+<li><a href="#_primitive-n4js-types">4.6. Primitive N4JS Types</a>
+<ul class="sectlevel3">
+<li><a href="#_any-type">4.6.1. Any Type</a>
+<ul class="sectlevel4">
+<li><a href="#any-type-semantics">4.6.1.1. Semantics</a></li>
+<li><a href="#any-type-type-inference">4.6.1.2. Type Inference</a>
+<ul class="sectlevel5">
+<li><a href="#_default-type-of-variables">4.6.1.2.1. Default Type of Variables</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#_void-type">4.6.2. Void Type</a>
+<ul class="sectlevel4">
+<li><a href="#void-type-semantics">4.6.2.1. Semantics</a></li>
+</ul>
+</li>
+<li><a href="#_unknown-type">4.6.3. Unknown Type</a></li>
+<li><a href="#_primitive-pathselector-and-i18nkey">4.6.4. Primitive Pathselector and I18nKey</a>
+<ul class="sectlevel4">
+<li><a href="#pathselector-semantics">4.6.4.1. Semantics</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#_built-in-ecmascript-object-types">4.7. Built-in ECMAScript Object Types</a>
+<ul class="sectlevel3">
+<li><a href="#ECMAScript-objects-semantics">4.7.1. Semantics</a></li>
+<li><a href="#_object-type">4.7.2. Object Type</a></li>
+<li><a href="#_function-object-type">4.7.3. Function-Object-Type</a></li>
+<li><a href="#_array-object-type">4.7.4. Array Object Type</a></li>
+<li><a href="#_string-object-type">4.7.5. String Object Type</a></li>
+<li><a href="#_boolean-object-type">4.7.6. Boolean Object Type</a></li>
+<li><a href="#_number-object-type">4.7.7. Number Object Type</a></li>
+<li><a href="#_global-object-type">4.7.8. Global Object Type</a></li>
+<li><a href="#_symbol">4.7.9. Symbol</a></li>
+<li><a href="#_promise">4.7.10. Promise</a></li>
+<li><a href="#_iterator-interface">4.7.11. Iterator Interface</a></li>
+<li><a href="#_iterable-interface">4.7.12. Iterable Interface</a></li>
+</ul>
+</li>
+<li><a href="#_built-in-n4js-types">4.8. Built-In N4JS Types</a>
+<ul class="sectlevel3">
+<li><a href="#_n4object">4.8.1. N4Object</a>
+<ul class="sectlevel4">
+<li><a href="#N4Object-semantics">4.8.1.1. Semantics</a></li>
+</ul>
+</li>
+<li><a href="#_n4class">4.8.2. N4Class</a></li>
+<li><a href="#IterableN">4.8.3. IterableN</a></li>
+</ul>
+</li>
+<li><a href="#_type-modifiers">4.9. Type Modifiers</a>
+<ul class="sectlevel3">
+<li><a href="#Type_Modifiers_Dynamic">4.9.1. Dynamic</a></li>
+<li><a href="#_optional-return-types">4.9.2. Optional Return Types</a></li>
+</ul>
+</li>
+<li><a href="#_union-and-intersection-type-composed-types">4.10. Union and Intersection Type (Composed Types)</a>
+<ul class="sectlevel3">
+<li><a href="#_union-type">4.10.1. Union Type</a>
+<ul class="sectlevel4">
+<li><a href="#union-type-syntax">4.10.1.1. Syntax</a></li>
+<li><a href="#union-type-semantics">4.10.1.2. Semantics</a></li>
+<li><a href="#_warnings">4.10.1.3. Warnings</a></li>
+</ul>
+</li>
+<li><a href="#_intersection-type">4.10.2. Intersection Type</a>
+<ul class="sectlevel4">
+<li><a href="#intersection-type-syntax">4.10.2.1. Syntax</a></li>
+<li><a href="#intersection-type-semantics">4.10.2.2. Semantics</a></li>
+<li><a href="#_warnings-2">4.10.2.3. Warnings</a></li>
+</ul>
+</li>
+<li><a href="#_composed-types-in-wildcards">4.10.3. Composed Types in Wildcards</a></li>
+<li><a href="#_property-access-for-composed-types">4.10.4. Property Access for Composed Types</a>
+<ul class="sectlevel4">
+<li><a href="#_properties-of-union-type">4.10.4.1. Properties of Union Type</a>
+<ul class="sectlevel5">
+<li><a href="#_remarks-on-union-type-s-members">4.10.4.1.1. Remarks on union type’s members:</a></li>
+</ul>
+</li>
+<li><a href="#_properties-of-intersection-type">4.10.4.2. Properties of Intersection Type</a>
+<ul class="sectlevel5">
+<li><a href="#_remarks-on-intersection-type-s-methods">4.10.4.2.1. Remarks on intersection type’s methods:</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#_constructor-and-classifier-type">4.11. Constructor and Classifier Type</a>
+<ul class="sectlevel3">
+<li><a href="#_syntax-3">4.11.1. Syntax</a></li>
+<li><a href="#_semantics-2">4.11.2. Semantics</a></li>
+<li><a href="#_constructors-and-prototypes-in-ecmascript-2015">4.11.3. Constructors and Prototypes in ECMAScript 2015</a></li>
+</ul>
+</li>
+<li><a href="#_this-type">4.12. This Type</a>
+<ul class="sectlevel3">
+<li><a href="#this-type-syntax">4.12.1. Syntax</a></li>
+<li><a href="#this-keyword-semantics">4.12.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="#_enums">4.13. Enums</a>
+<ul class="sectlevel3">
+<li><a href="#_enums-n4js">4.13.1. Enums (N4JS)</a>
+<ul class="sectlevel4">
+<li><a href="#enums-syntax">4.13.1.1. Syntax</a></li>
+<li><a href="#enums-semantics">4.13.1.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="#_string-based-enums">4.13.2. String-Based Enums</a></li>
+</ul>
+</li>
+<li><a href="#_short-hand-syntax">4.14. Short-Hand Syntax</a>
+<ul class="sectlevel3">
+<li><a href="#_array-short-hand-syntax">4.14.1. Array Short-Hand Syntax</a></li>
+<li><a href="#_iterablen-short-hand-syntax">4.14.2. IterableN Short-Hand Syntax</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="classifiers.html#_classifiers">5. Classifiers</a>
+<ul class="sectlevel2">
+<li><a href="classifiers.html#_n4js-specific-classifiers">5.1. N4JS Specific Classifiers</a>
+<ul class="sectlevel3">
+<li><a href="classifiers.html#_properties-2">5.1.1. Properties</a></li>
+<li><a href="classifiers.html#_common-semantics-of-classifiers">5.1.2. Common Semantics of Classifiers</a></li>
+<li><a href="classifiers.html#_classes">5.1.3. Classes</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_definition-of-classes">5.1.3.1. Definition of Classes</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#class-syntax">5.1.3.1.1. Syntax</a></li>
+<li><a href="classifiers.html#class-properties">5.1.3.1.2. Properties</a></li>
+<li><a href="classifiers.html#class-type-inference">5.1.3.1.3. Type Inference</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#class-semantics">5.1.3.2. Semantics</a></li>
+<li><a href="classifiers.html#_final-modifier">5.1.3.3. Final Modifier</a></li>
+<li><a href="classifiers.html#_abstract-classes">5.1.3.4. Abstract Classes</a></li>
+<li><a href="classifiers.html#_non-instantiable-classes">5.1.3.5. Non-Instantiable Classes</a></li>
+<li><a href="classifiers.html#_superclass">5.1.3.6. Superclass</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_interfaces">5.1.4. Interfaces</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_definition-of-interfaces">5.1.4.1. Definition of Interfaces</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#interfaces-syntax">5.1.4.1.1. Syntax</a></li>
+<li><a href="classifiers.html#interfaces-properties">5.1.4.1.2. Properties</a></li>
+<li><a href="classifiers.html#interfaces-type-inference">5.1.4.1.3. Type Inference</a></li>
+<li><a href="classifiers.html#interfaces-semantics">5.1.4.1.4. Semantics</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="classifiers.html#_generic-classifiers">5.1.5. Generic Classifiers</a></li>
+<li><a href="classifiers.html#sec:definition-site-variance">5.1.6. Definition-Site Variance</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_members">5.2. Members</a>
+<ul class="sectlevel3">
+<li><a href="classifiers.html#_syntax-4">5.2.1. Syntax</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_properties-3">5.2.1.1. Properties</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_semantics-3">5.2.2. Semantics</a></li>
+<li><a href="classifiers.html#_methods">5.2.3. Methods</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_syntax-5">5.2.3.1. Syntax</a></li>
+<li><a href="classifiers.html#_properties-4">5.2.3.2. Properties</a></li>
+<li><a href="classifiers.html#_semantics-4">5.2.3.3. Semantics</a></li>
+<li><a href="classifiers.html#_final-methods">5.2.3.4. Final Methods</a></li>
+<li><a href="classifiers.html#_abstract-methods">5.2.3.5. Abstract Methods</a></li>
+<li><a href="classifiers.html#_generic-methods">5.2.3.6. Generic Methods</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_default-methods-in-interfaces">5.2.4. Default Methods in Interfaces</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_asynchronous-methods">5.2.4.1. Asynchronous Methods</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_constructors">5.2.5. Constructors</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_structural-this-type-in-constructor">5.2.5.1. Structural This Type in Constructor</a></li>
+<li><a href="classifiers.html#spec-constructor">5.2.5.2. @Spec Constructor</a></li>
+<li><a href="classifiers.html#_callable-constructors">5.2.5.3. Callable Constructors</a></li>
+<li><a href="classifiers.html#_covariant-constructors">5.2.5.4. Covariant Constructors</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_data-fields">5.2.6. Data Fields</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#data-fields-syntax">5.2.6.1. Syntax</a></li>
+<li><a href="classifiers.html#data-fields-properties">5.2.6.2. Properties</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#data-fields-semantics">5.2.6.2.1. Semantics</a></li>
+<li><a href="classifiers.html#data-fields-type-inference">5.2.6.2.2. Type Inference</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_assignment-modifiers">5.2.6.3. Assignment Modifiers</a></li>
+<li><a href="classifiers.html#_field-accessors-getter-setter">5.2.6.4. Field Accessors (Getter/Setter)</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#field-acessors-syntax">5.2.6.4.1. Syntax</a></li>
+<li><a href="classifiers.html#field-acessors-properties">5.2.6.4.2. Properties</a></li>
+<li><a href="classifiers.html#field-accessors-semantics">5.2.6.4.3. Semantics</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#optional-fields">5.2.6.5. Optional Fields</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#_syntax-6">5.2.6.5.1. Syntax</a></li>
+<li><a href="classifiers.html#_semantics-5">5.2.6.5.2. Semantics</a></li>
+<li><a href="classifiers.html#_background">5.2.6.5.3. Background</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="classifiers.html#_static-members">5.2.7. Static Members</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_access-from-and-to-static-members">5.2.7.1. Access From and To Static Members</a></li>
+<li><a href="classifiers.html#_generic-static-methods">5.2.7.2. Generic static methods</a></li>
+<li><a href="classifiers.html#_static-members-of-interfaces">5.2.7.3. Static Members of Interfaces</a></li>
+</ul>
+</li>
+<li><a href="classifiers.html#_redefinition-of-members">5.2.8. Redefinition of Members</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_overriding-of-members">5.2.8.1. Overriding of Members</a></li>
+<li><a href="classifiers.html#_implementation-of-members">5.2.8.2. Implementation of Members</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#_member-consumption">5.2.8.2.1. Member Consumption</a></li>
+<li><a href="classifiers.html#_member-implementation">5.2.8.2.2. Member Implementation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="classifiers.html#_structural-typing">5.3. Structural Typing</a>
+<ul class="sectlevel3">
+<li><a href="classifiers.html#_syntax-7">5.3.1. Syntax</a></li>
+<li><a href="classifiers.html#_definition-site-structural-typing">5.3.2. Definition Site Structural Typing</a></li>
+<li><a href="classifiers.html#_use-site-structural-typing">5.3.3. Use-Site Structural Typing</a></li>
+<li><a href="classifiers.html#structural-readWriteInit-field-typing">5.3.4. Structural Read-only, Write-only and Initializer Field Typing</a></li>
+<li><a href="classifiers.html#_public-setter-annotated-with-code-providesinitializer-code">5.3.5. Public Setter Annotated With <code>ProvidesInitializer</code></a></li>
+<li><a href="classifiers.html#_structural-types-with-optional-fields">5.3.6. Structural Types With Optional Fields</a></li>
+<li><a href="classifiers.html#_structural-types-with-access-modifier">5.3.7. Structural Types With Access Modifier</a></li>
+<li><a href="classifiers.html#_structural-types-with-additional-members">5.3.8. Structural Types With Additional Members</a>
+<ul class="sectlevel4">
+<li><a href="classifiers.html#_syntax-8">5.3.8.1. Syntax</a>
+<ul class="sectlevel5">
+<li><a href="classifiers.html#_semantics-6">5.3.8.1.1. Semantics</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="functions.html#_functions">6. Functions</a>
+<ul class="sectlevel2">
+<li><a href="functions.html#_function-type">6.1. Function Type</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_properties-5">6.1.1. Properties</a></li>
+<li><a href="functions.html#function-type-inference">6.1.2. Type Inference</a></li>
+<li><a href="functions.html#_autoboxing-of-function-type">6.1.3. Autoboxing of Function Type</a></li>
+<li><a href="functions.html#_arguments-object">6.1.4. Arguments Object</a></li>
+</ul>
+</li>
+<li><a href="functions.html#_ecmascript-5-function-definition">6.2. ECMAScript 5 Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_function-declaration">6.2.1. Function Declaration</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#_syntax-9">6.2.1.1. Syntax</a></li>
+<li><a href="functions.html#_semantics-8">6.2.1.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="functions.html#_function-expression">6.2.2. Function Expression</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#function-expression-syntax">6.2.2.1. Syntax</a></li>
+<li><a href="functions.html#_semantics-and-type-inference">6.2.2.2. Semantics and Type Inference</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="functions.html#_ecmascript-2015-function-definition">6.3. ECMAScript 2015 Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_formal-parameters">6.3.1. Formal Parameters</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#Type_Modifiers_Optional">6.3.1.1. Optional Parameters</a></li>
+<li><a href="functions.html#Type_Modifiers_Default">6.3.1.2. Default Parameters</a></li>
+<li><a href="functions.html#Type_Modifiers_Variadic">6.3.1.3. Variadic</a></li>
+</ul>
+</li>
+<li><a href="functions.html#_generator-functions">6.3.2. Generator Functions</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#generator-functions-syntax">6.3.2.1. Syntax</a></li>
+<li><a href="functions.html#generator-functions-semantics">6.3.2.2. Semantics</a></li>
+<li><a href="functions.html#_generator-arrow-functions">6.3.2.3. Generator Arrow Functions</a></li>
+</ul>
+</li>
+<li><a href="functions.html#_arrow-function-expression">6.3.3. Arrow Function Expression</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#arrow-function-expression-syntax">6.3.3.1. Syntax</a></li>
+<li><a href="functions.html#arrow-function-expression-semantics-and-type-inference">6.3.3.2. Semantics and Type Inference</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="functions.html#_ecmascript-proposals-function-definition">6.4. ECMAScript Proposals Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_asynchronous-functions">6.4.1. Asynchronous Functions</a>
+<ul class="sectlevel4">
+<li><a href="functions.html#asynchronous-functions-syntax">6.4.1.1. Syntax</a></li>
+<li><a href="functions.html#asynchronous-functions-semantics">6.4.1.2. Semantics</a></li>
+<li><a href="functions.html#_asynchronous-arrow-functions">6.4.1.3. Asynchronous Arrow Functions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="functions.html#_n4js-extended-function-definition">6.5. N4JS Extended Function Definition</a>
+<ul class="sectlevel3">
+<li><a href="functions.html#_generic-functions">6.5.1. Generic Functions</a></li>
+<li><a href="functions.html#_promisifiable-functions">6.5.2. Promisifiable Functions</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_conversions-and-reflection">7. Conversions and Reflection</a>
+<ul class="sectlevel2">
+<li><a href="conversions_and_reflection.html#_autoboxing-and-coercing">7.1. Autoboxing and Coercing</a>
+<ul class="sectlevel3">
+<li><a href="conversions_and_reflection.html#_coercing">7.1.1. Coercing</a></li>
+<li><a href="conversions_and_reflection.html#_autoboxing-of-primitives">7.1.2. Autoboxing of Primitives</a></li>
+<li><a href="conversions_and_reflection.html#_autoboxing-of-function-expressions-and-declarations">7.1.3. Autoboxing of Function Expressions and Declarations</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_auto-conversion-of-objects">7.2. Auto-Conversion of Objects</a>
+<ul class="sectlevel3">
+<li><a href="conversions_and_reflection.html#_auto-conversion-of-class-instances">7.2.1. Auto-Conversion of Class Instances</a>
+<ul class="sectlevel4">
+<li><a href="conversions_and_reflection.html#_auto-conversion-of-interface-instances">7.2.1.1. Auto-Conversion of Interface Instances</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_auto-conversion-of-enum-literals">7.2.2. Auto-Conversion of Enum Literals</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_type-cast-and-type-check">7.3. Type Cast and Type Check</a>
+<ul class="sectlevel3">
+<li><a href="conversions_and_reflection.html#_type-cast">7.3.1. Type Cast</a></li>
+<li><a href="conversions_and_reflection.html#_type-check">7.3.2. Type Check</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_reflection-meta-information">7.4. Reflection meta-information</a>
+<ul class="sectlevel3">
+<li><a href="conversions_and_reflection.html#_reflection-for-classes">7.4.1. Reflection for Classes</a></li>
+<li><a href="conversions_and_reflection.html#_reflection-for-interfaces">7.4.2. Reflection for Interfaces</a></li>
+<li><a href="conversions_and_reflection.html#_reflection-for-enumerations">7.4.3. Reflection for Enumerations</a></li>
+</ul>
+</li>
+<li><a href="conversions_and_reflection.html#_conversion-of-primitive-types">7.5. Conversion of primitive types</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_expressions">8. Expressions</a>
+<ul class="sectlevel2">
+<li><a href="expressions.html#_ecmascript-5-expressions">8.1. ECMAScript 5 Expressions</a>
+<ul class="sectlevel3">
+<li><a href="expressions.html#_the-this-literal">8.1.1. The this Literal</a></li>
+<li><a href="expressions.html#_identifier">8.1.2. Identifier</a></li>
+<li><a href="expressions.html#_literals">8.1.3. Literals</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#_integer-literals">8.1.3.1. Integer Literals</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_array-literal">8.1.4. Array Literal</a></li>
+<li><a href="expressions.html#_object-literal">8.1.5. Object Literal</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#_properties-6">8.1.5.1. Properties</a></li>
+<li><a href="expressions.html#_scoping-and-linking">8.1.5.2. Scoping and linking</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_parenthesized-expression-and-grouping-operator">8.1.6. Parenthesized Expression and Grouping Operator</a></li>
+<li><a href="expressions.html#_property-accessors">8.1.7. Property Accessors</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#properties-1">8.1.7.1. Properties</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_new-expression">8.1.8. New Expression</a></li>
+<li><a href="expressions.html#_function-expression-2">8.1.9. Function Expression</a></li>
+<li><a href="expressions.html#_function-calls">8.1.10. Function Calls</a></li>
+<li><a href="expressions.html#_postfix-expression">8.1.11. Postfix Expression</a></li>
+<li><a href="expressions.html#_unary-expression">8.1.12. Unary Expression</a></li>
+<li><a href="expressions.html#_multiplicative-expression">8.1.13. Multiplicative Expression</a></li>
+<li><a href="expressions.html#_additive-expression">8.1.14. Additive Expression</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#type-inference-10">8.1.14.1. Type Inference</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_bitwise-shift-expression">8.1.15. Bitwise Shift Expression</a></li>
+<li><a href="expressions.html#_relational-expression">8.1.16. Relational Expression</a></li>
+<li><a href="expressions.html#_equality-expression">8.1.17. Equality Expression</a></li>
+<li><a href="expressions.html#_binary-bitwise-expression">8.1.18. Binary Bitwise Expression</a></li>
+<li><a href="expressions.html#_binary-logical-expression">8.1.19. Binary Logical Expression</a></li>
+<li><a href="expressions.html#_conditional-expression">8.1.20. Conditional Expression</a></li>
+<li><a href="expressions.html#_assignment-expression">8.1.21. Assignment Expression</a></li>
+<li><a href="expressions.html#_comma-expression">8.1.22. Comma Expression</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_ecmascript-6-expressions">8.2. ECMAScript 6 Expressions</a>
+<ul class="sectlevel3">
+<li><a href="expressions.html#_the-super-keyword">8.2.1. The super Keyword</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_ecmascript-7-expressions">8.3. ECMAScript 7 Expressions</a>
+<ul class="sectlevel3">
+<li><a href="expressions.html#_await-expression">8.3.1. Await Expression</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#_n4js-specific-expressions">8.4. N4JS Specific Expressions</a>
+<ul class="sectlevel3">
+<li><a href="expressions.html#_class-expression">8.4.1. Class Expression</a></li>
+<li><a href="expressions.html#_cast-as-expression">8.4.2. Cast (As) Expression</a>
+<ul class="sectlevel4">
+<li><a href="expressions.html#cast-as-expression-semantics-type-inference">8.4.2.1. Semantics and Type Inference</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#Import_Calls">8.4.3. Import Calls</a></li>
+</ul>
+</li>
+<li><a href="expressions.html#compile-time-expressions">8.5. Compile-Time Expressions</a></li>
+</ul>
+</li>
+<li><a href="statements.html#_statements">9. Statements</a>
+<ul class="sectlevel2">
+<li><a href="statements.html#_ecmascript-5-statements">9.1. ECMAScript 5 Statements</a>
+<ul class="sectlevel3">
+<li><a href="statements.html#_function-or-field-accessor-bodies">9.1.1. Function or Field Accessor Bodies</a></li>
+<li><a href="statements.html#_variable-statement">9.1.2. Variable Statement</a></li>
+<li><a href="statements.html#_if-statement">9.1.3. If Statement</a></li>
+<li><a href="statements.html#_iteration-statements">9.1.4. Iteration Statements</a></li>
+<li><a href="statements.html#_return-statement">9.1.5. Return Statement</a></li>
+<li><a href="statements.html#_with-statement">9.1.6. With Statement</a></li>
+<li><a href="statements.html#_switch-statement">9.1.7. Switch Statement</a></li>
+<li><a href="statements.html#_throw-try-and-catch-statements">9.1.8. Throw, Try, and Catch Statements</a></li>
+<li><a href="statements.html#_debugger-statement">9.1.9. Debugger Statement</a></li>
+</ul>
+</li>
+<li><a href="statements.html#_ecmascript-6-statements">9.2. ECMAScript 6 Statements</a>
+<ul class="sectlevel3">
+<li><a href="statements.html#_let">9.2.1. Let</a></li>
+<li><a href="statements.html#_const">9.2.2. Const</a></li>
+<li><a href="statements.html#_for-of-statement">9.2.3. <code>for &#8230;&#8203; of</code> statement</a></li>
+<li><a href="statements.html#_import-statement">9.2.4. Import Statement</a>
+<ul class="sectlevel4">
+<li><a href="statements.html#Dynamic_Imports">9.2.4.1. Dynamic Imports</a></li>
+<li><a href="statements.html#_immutabilaty-of-imports">9.2.4.2. Immutabilaty of Imports</a></li>
+</ul>
+</li>
+<li><a href="statements.html#_export-statement">9.2.5. Export Statement</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="annotations.html#_annotations">10. Annotations</a>
+<ul class="sectlevel2">
+<li><a href="annotations.html#_introduction-2">10.1. Introduction</a>
+<ul class="sectlevel3">
+<li><a href="annotations.html#_syntax-13">10.1.1. Syntax</a></li>
+<li><a href="annotations.html#_properties-7">10.1.2. Properties</a></li>
+<li><a href="annotations.html#_element-specific-annotations">10.1.3. Element-Specific Annotations</a></li>
+<li><a href="annotations.html#_general-annotations">10.1.4. General Annotations</a>
+<ul class="sectlevel4">
+<li><a href="annotations.html#_idebug">10.1.4.1. IDEBUG</a></li>
+</ul>
+</li>
+<li><a href="annotations.html#idebug-syntax">10.1.5. Syntax</a>
+<ul class="sectlevel4">
+<li><a href="annotations.html#_semantics-11">10.1.5.1. Semantics</a></li>
+<li><a href="annotations.html#_suppress-warnings">10.1.5.2. Suppress Warnings</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="annotations.html#_declaration-of-annotations">10.2. Declaration of Annotations</a></li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_extended-fetaures">11. Extended Fetaures</a>
+<ul class="sectlevel2">
+<li><a href="extended_fetaures.html#_array-and-object-destructuring">11.1. Array and Object Destructuring</a>
+<ul class="sectlevel3">
+<li><a href="extended_fetaures.html#_syntax-14">11.1.1. Syntax</a></li>
+<li><a href="extended_fetaures.html#_semantics-12">11.1.2. Semantics</a></li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_dependency-injection">11.2. Dependency Injection</a>
+<ul class="sectlevel3">
+<li><a href="extended_fetaures.html#_di-components-and-injectors">11.2.1. DI Components and Injectors</a>
+<ul class="sectlevel4">
+<li><a href="extended_fetaures.html#_dicomponent-relations">11.2.1.1. DIComponent Relations</a></li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_binders-and-bindings">11.2.2. Binders and Bindings</a></li>
+<li><a href="extended_fetaures.html#_injection-points">11.2.3. Injection Points</a>
+<ul class="sectlevel4">
+<li><a href="extended_fetaures.html#_field-injection">11.2.3.1. Field Injection</a></li>
+<li><a href="extended_fetaures.html#_constructor-injection">11.2.3.2. Constructor Injection</a></li>
+<li><a href="extended_fetaures.html#_method-injection">11.2.3.3. Method Injection</a>
+<ul class="sectlevel5">
+<li><a href="extended_fetaures.html#_provider">11.2.3.3.1. Provider</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_n4js-di-life-cycle-and-scopes">11.2.4. N4JS DI Life Cycle and Scopes</a>
+<ul class="sectlevel4">
+<li><a href="extended_fetaures.html#_injection-cylces">11.2.4.1. Injection Cylces</a></li>
+<li><a href="extended_fetaures.html#_default-scope">11.2.4.2. Default Scope</a></li>
+<li><a href="extended_fetaures.html#_singleton-scope">11.2.4.3. Singleton Scope</a></li>
+<li><a href="extended_fetaures.html#_per-injection-chain-singleton">11.2.4.4. Per Injection Chain Singleton</a></li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_validation-of-callsites-targeting-n4injector-methods">11.2.5. Validation of callsites targeting N4Injector methods</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-annotations">11.2.6. N4JS DI Annotations</a>
+<ul class="sectlevel4">
+<li><a href="extended_fetaures.html#_n4js-di-generateinjector">11.2.6.1. N4JS DI @GenerateInjector</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-withparentinjector">11.2.6.2. N4JS DI @WithParentInjector</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-usebinder">11.2.6.3. N4JS DI @UseBinder</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-binder">11.2.6.4. N4JS DI @Binder</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-bind">11.2.6.5. N4JS DI @Bind</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-provides">11.2.6.6. N4JS DI @Provides</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-inject">11.2.6.7. N4JS DI @Inject</a></li>
+<li><a href="extended_fetaures.html#_n4js-di-singleton">11.2.6.8. N4JS DI @Singleton</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="extended_fetaures.html#_test-support">11.3. Test Support</a></li>
+<li><a href="extended_fetaures.html#_polyfill-definitions">11.4. Polyfill Definitions</a>
+<ul class="sectlevel3">
+<li><a href="extended_fetaures.html#_runtime-polyfill-definitions">11.4.1. Runtime Polyfill Definitions</a></li>
+<li><a href="extended_fetaures.html#_static-polyfill-definitions">11.4.2. Static Polyfill Definitions</a></li>
+<li><a href="extended_fetaures.html#_transpiling-static-polyfilled-classes">11.4.3. Transpiling static polyfilled classes</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="components.html#_components">12. Components</a>
+<ul class="sectlevel2">
+<li><a href="components.html#_overview-2">12.1. Overview</a></li>
+<li><a href="components.html#Component_Types">12.2. Component Types</a>
+<ul class="sectlevel3">
+<li><a href="components.html#_libraries">12.2.1. Libraries</a></li>
+<li><a href="components.html#_runtime-environment-and-runtime-libraries">12.2.2. Runtime Environment and Runtime Libraries</a></li>
+<li><a href="components.html#_tests">12.2.3. Tests</a></li>
+<li><a href="components.html#_type-definitions">12.2.4. Type Definitions</a></li>
+</ul>
+</li>
+<li><a href="components.html#package-json">12.3. Package.json File</a>
+<ul class="sectlevel3">
+<li><a href="components.html#_basic-properties">12.3.1. Basic Properties</a></li>
+<li><a href="components.html#_n4js-properties">12.3.2. N4JS Properties</a></li>
+<li><a href="components.html#_constraints">12.3.3. Constraints</a></li>
+</ul>
+</li>
+<li><a href="components.html#_support-for-npm-scopes">12.4. Support for NPM Scopes</a></li>
+<li><a href="components.html#sec:N4JS-Type-Definitions">12.5. N4JS Type Definitions</a>
+<ul class="sectlevel3">
+<li><a href="components.html#_specify-type-definition">12.5.1. Specify Type Definition</a></li>
+<li><a href="components.html#_name-conventions">12.5.2. Name Conventions</a></li>
+<li><a href="components.html#_version-conventions">12.5.3. Version Conventions</a>
+<ul class="sectlevel4">
+<li><a href="components.html#_define-a-new-type-definition-package">12.5.3.1. Define a New Type Definition Package</a></li>
+<li><a href="components.html#_using-a-type-definition-package">12.5.3.2. Using a Type Definition Package</a></li>
+<li><a href="components.html#_rational">12.5.3.3. Rational</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="components.html#_modules">12.6. Modules</a></li>
+<li><a href="components.html#_api-and-implementation-component">12.7. API and Implementation Component</a>
+<ul class="sectlevel3">
+<li><a href="components.html#_execution-of-api-and-implementation-components">12.7.1. Execution of API and Implementation Components</a></li>
+<li><a href="components.html#_api-and-implementation-with-di">12.7.2. API and Implementation With DI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="plainjs.html#_plainjs">13. PlainJS</a>
+<ul class="sectlevel2">
+<li><a href="plainjs.html#_type-inference-and-validation-for-plain-js">13.1. Type Inference and Validation for Plain JS</a></li>
+<li><a href="plainjs.html#_external-declarations">13.2. External Declarations</a>
+<ul class="sectlevel3">
+<li><a href="plainjs.html#_declaring-externals">13.2.1. Declaring externals</a></li>
+<li><a href="plainjs.html#_instantiating-external-classes">13.2.2. Instantiating external classes</a></li>
+<li><a href="plainjs.html#_implementation-of-external-declarations">13.2.3. Implementation of External Declarations</a></li>
+<li><a href="plainjs.html#_example">13.2.4. Example</a></li>
+</ul>
+</li>
+<li><a href="plainjs.html#_global-definitions">13.3. Global Definitions</a></li>
+<li><a href="plainjs.html#_runtime-definitions">13.4. Runtime Definitions</a></li>
+<li><a href="plainjs.html#_applying-polyfills">13.5. Applying Polyfills</a></li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_jsdoc-2">14. JSDoc</a>
+<ul class="sectlevel2">
+<li><a href="jsdoc.html#_general-n4jsdoc-features">14.1. General N4JSDoc Features</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#_provided-inline-tags">14.1.1. Provided Inline Tags</a>
+<ul class="sectlevel4">
+<li><a href="jsdoc.html#jsdoc_tag__code">14.1.1.1. @code</a></li>
+<li><a href="jsdoc.html#jsdoc_tag__link">14.1.1.2. @link</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_n4jsdoc-for-user-projects">14.2. N4JSdoc for User Projects</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#_standard-tags">14.2.1. Standard Tags</a>
+<ul class="sectlevel4">
+<li><a href="jsdoc.html#_-author">14.2.1.1. @author</a></li>
+<li><a href="jsdoc.html#jsdoc_tag_param">14.2.1.2. @param</a></li>
+<li><a href="jsdoc.html#jsdoc_tag_return">14.2.1.3. @return</a></li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_test-related-tags">14.2.2. Test Related Tags</a>
+<ul class="sectlevel4">
+<li><a href="jsdoc.html#jsdoc_tag__testee">14.2.2.1. @testee</a></li>
+<li><a href="jsdoc.html#jsdoc_tag__testeeFromType">14.2.2.2. @testeeFromType</a></li>
+<li><a href="jsdoc.html#_testeeType_and__testeeMember">14.2.2.3. @testeeType and @testeeMember</a></li>
+<li><a href="jsdoc.html#jsdoc_tag_reqid_in_Tests">14.2.2.4. @reqid in Tests</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsdoc.html#_n4jsdoc-for-api-and-implementation-projects">14.3. N4JSDoc for API and Implementation Projects</a>
+<ul class="sectlevel3">
+<li><a href="jsdoc.html#jsdoc_tag__apiNote">14.3.1. @apiNote</a></li>
+<li><a href="jsdoc.html#API_Project_Tags">14.3.2. API Project Tags</a>
+<ul class="sectlevel4">
+<li><a href="jsdoc.html#jsdoc_tag_apiState">14.3.2.1. @apiState</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="jsx.html#_jsx">15. JSX</a>
+<ul class="sectlevel2">
+<li><a href="jsx.html#_jsx-support">15.1. JSX Support</a></li>
+<li><a href="jsx.html#_jsx-backend">15.2. JSX Backend</a></li>
+</ul>
+</li>
+<li><a href="grammars.html#_grammars">16. Grammars</a>
+<ul class="sectlevel2">
+<li><a href="grammars.html#_type-expressions-grammar">16.1. Type Expressions Grammar</a></li>
+<li><a href="grammars.html#_n4js-language-grammar">16.2. N4JS Language Grammar</a></li>
+</ul>
+</li>
+<li><a href="jsobjects.html#_jsobjects">17. JSObjects</a>
+<ul class="sectlevel2">
+<li><a href="jsobjects.html#_object">17.1. Object</a></li>
+<li><a href="jsobjects.html#_string">17.2. String</a></li>
+<li><a href="jsobjects.html#_boolean">17.3. Boolean</a></li>
+<li><a href="jsobjects.html#_number">17.4. Number</a>
+<ul class="sectlevel3">
+<li><a href="jsobjects.html#_static-attributes">17.4.1. Static Attributes</a></li>
+</ul>
+</li>
+<li><a href="jsobjects.html#function">17.5. Function</a></li>
+<li><a href="jsobjects.html#_error">17.6. Error</a></li>
+<li><a href="jsobjects.html#_array">17.7. Array</a></li>
+<li><a href="jsobjects.html#_date">17.8. Date</a></li>
+<li><a href="jsobjects.html#_math">17.9. Math</a>
+<ul class="sectlevel3">
+<li><a href="jsobjects.html#static-attributes-1">17.9.1. Static Attributes</a></li>
+</ul>
+</li>
+<li><a href="jsobjects.html#_regexp">17.10. RegExp</a></li>
+<li><a href="jsobjects.html#_json">17.11. JSON</a></li>
+</ul>
+</li>
+<li><a href="n4js_objects.html#_n4js-objects">18. N4JS Objects</a>
+<ul class="sectlevel2">
+<li><a href="n4js_objects.html#_reflection-model">18.1. Reflection Model</a></li>
+<li><a href="n4js_objects.html#_error-types">18.2. Error Types</a>
+<ul class="sectlevel3">
+<li><a href="n4js_objects.html#_n4apinotimplemented">18.2.1. N4ApiNotImplemented</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="appendix_a_acronyms.html#_acronyms">Appendix A: Acronyms</a></li>
+<li><a href="appendix_b_license.html#sec:License">Appendix B: License</a></li>
+<li><a href="appendix_c_bibliography.html#_bibliography">Appendix C: Bibliography</a></li>
+</ul>
+</div>
+</div>
+<div id="content"><div class="sect1">
+<h2 id="_types"><a class="anchor" href="#_types"></a><a class="link" href="#_types">4. Types</a></h2>
+<div class="sectionbody">
+<div class="sect2 language-n4js">
+<h3 id="_overview"><a class="anchor" href="#_overview"></a><a class="link" href="#_overview">4.1. Overview</a></h3>
+<div class="paragraph">
+<p>N4JS is essentially ECMAScript with the inclusion of types.
+In the following sections we will describe how types are defined and used in N4JS.</p>
+</div>
+<div class="paragraph">
+<p>Besides standard JavaScript types, the following metatypes are introduced:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Classifiers, that is class or interface (see <a href="classifiers.html#_classifiers">Classifiers</a>)</p>
+</li>
+<li>
+<p>Enum</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Classifiers, methods and functions may be declared generic.</p>
+</div>
+<div class="paragraph">
+<p>Types are related to each other by the subtype relation.</p>
+</div>
+<div class="openblock definition">
+<div class="content">
+<div class="paragraph">
+<p><a id="subtype_relation"></a><strong>Definition:</strong> <a href="#subtype_relation">Subtype Relation</a></p>
+</div>
+<div class="paragraph">
+<p>We use <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>s</mi><mi>u</mi><mi>b</mi><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi></math> for the general subtype relation or type conformance.</p>
+</div>
+<div class="paragraph">
+<p>In nominal typing, <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>S</mi></math> means that <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>S</mi></math> is a (transitive) supertype of <em>T</em>.
+Generally in structural typing, this means that <em>T</em> <em>conforms</em> to <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>S</mi></math>.
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/></math> is defined transitive reflexive by default.</p>
+</div>
+<div class="paragraph">
+<p>We write <math xmlns="http://www.w3.org/1998/Math/MathML"><mo>&lt;</mo></math> to refer to the transitive non-reflexive relation, that is <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi><mo>&lt;</mo><mi>S</mi><mo>⇔</mo><mi>T</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>S</mi><mo>∧</mo><mi>T</mi><mo>≠</mo><mi>S</mi></math></p>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Whether nominal or structural typing is used depends on the declaration of the type or the reference.
+This is explained further in <a href="classifiers.html#_structural-typing">Structural Typing</a>.</p>
+</div>
+<div class="paragraph">
+<p>For convenience reasons, we sometimes revert the operator, that is <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>S</mi><mo>⇔</mo><mi>S</mi><mi>:</mi><mo>&gt;</mo><mi>T</mi></math>.
+We write <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi><mspace width="1.0mm"/><mo>≮</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>S</mi></math> if <em>T</em> is not type conforming to <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>S</mi></math>. (cf. [<a href="appendix_c_bibliography.html#Gosling12a">Gosling12a(p.S4.10)</a>])</p>
+</div>
+<div class="paragraph">
+<p>Join and meet are defined as follows:</p>
+</div>
+<div class="openblock definition">
+<div class="content">
+<div class="paragraph">
+<p><a id="join_and_meet"></a><strong>Definition:</strong> <a href="#join_and_meet">Join and Meet</a></p>
+</div>
+<div class="paragraph">
+<p>A type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>J</mi></math> is called a <em>join</em> (or least common supertype, ) of a pair of types <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>S</mi></math> and <em>T</em>, written <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>S</mi><mo>∨</mo><mi>T</mi><mo>=</mo><mi>J</mi></math>, if</p>
+</div>
+<div class="paragraph">
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>S</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>J</mi></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>J</mi></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∀</mo><mi>L</mi><mi>:</mi><mrow><mo>(</mo><mrow><mi>S</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>L</mi><mo>)</mo></mrow><mo>∧</mo><mrow><mo>(</mo><mrow><mi>T</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>L</mi><mo>)</mo></mrow><mo>→</mo><mi>J</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>L</mi></mrow></mrow></math></p>
+</div>
+<div class="paragraph">
+<p>Similarly, we say that a type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>M</mi></math> is a <em>meet</em> (or greatest common subtype, ) of <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>S</mi></math> and <em>T</em>, written <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>S</mi><mo>∧</mo><mi>T</mi><mo>=</mo><mi>M</mi></math>, if<br></p>
+</div>
+<div class="paragraph">
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>M</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>S</mi></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>M</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>T</mi></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∀</mo><mi>L</mi><mi>:</mi><mrow><mo>(</mo><mrow><mi>L</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>S</mi><mo>)</mo></mrow><mo>∧</mo><mrow><mo>(</mo><mrow><mi>L</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>T</mi><mo>)</mo></mrow><mo>→</mo><mi>L</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>M</mi></mrow></mrow></math></p>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Note that this declarative definition needs to be specified in detail for special cases, such as union and intersection types.
+Usually, the union type of two types is also the join.</p>
+</div>
+<div class="paragraph">
+<p><a href="#fig-cd-predefined-type-hierarchy">Predefined Types Hierarchy</a> summarizes all predefined types,
+that is primitive and built-in ECMAScript and N4JS types.
+Specific rules for the subtype relation are defined in the following sections.
+This type hierarchy shows <code>any</code> and <code>undefined</code> as the top and bottom type (cf. [<a href="appendix_c_bibliography.html#Pierce02a">Pierce02a(p.15.4)</a>]) We define these types here explicitly:</p>
+</div>
+<div class="openblock definition">
+<div class="content">
+<div class="paragraph">
+<p><a id="top_and_bottom_type"></a><strong>Definition:</strong> <a href="#top_and_bottom_type">Top and Bottom Type</a></p>
+</div>
+<div class="paragraph">
+<p>We call <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi><mi>o</mi><mi>p</mi></math> the top type, if for all types <em>T</em> the relation  <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>T</mi><mi>o</mi><mi>p</mi></math> is true.
+We call <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>B</mi><mi>o</mi><mi>t</mi></math> the bottom type, if for all types <em>T</em> the relation <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>B</mi><mi>o</mi><mi>t</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>T</mi></math> is true.
+In N4JS, <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi><mi>o</mi><mi>p</mi><mo>=</mo><mi>a</mi><mi>n</mi><mi>y</mi></math>, the bottom type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>B</mi><mi>o</mi><mi>t</mi><mo>=</mo><mi>u</mi><mi>n</mi><mi>d</mi><mi>e</mi><mi>f</mi><mi>i</mi><mi>n</mi><mi>e</mi><mi>d</mi></math>.</p>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p><code>null</code> is almost similar to <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>B</mi><mi>o</mi><mi>t</mi></math>, except that it is not a subtype of <code>undefined</code>.</p>
+</div>
+<div id="fig-cd-predefined-type-hierarchy" class="imageblock" style="text-align: center">
+<div class="content">
+<img src="chapters/04_types/fig/cdPredefinedTypesHierarchy.svg" alt="cdPredefinedTypesHierarchy">
+</div>
+<div class="title">Figure 2. Predefined Types Hierarchy</div>
+</div>
+<div class="paragraph">
+<p>For every primitive type there is a corresponding built-in type as defined in [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a</a>], e.g. <code>string</code> and <code>String</code>.
+There is no inheritance supported for primitive types and built-in types – these types are final.</p>
+</div>
+<div class="paragraph">
+<p>Although the diagram shows inheritance between <code>void</code> and <code>undefined</code>, this relationship is only semantic: <code>void</code> is a refinement of <code>undefined</code> from a type system viewpoint.
+The same applies to the relation of <code>Object</code> as well as the subtypes shown for <code>string</code> and <code>String</code>.</p>
+</div>
+<div id="ex:class-hierarchy" class="exampleblock">
+<div class="title">Example 6. Type Examples, Class Hierarchy</div>
+<div class="content">
+<div class="paragraph">
+<p>In the following examples, we assume the following classes to be given:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">// C &lt;: B &lt;: A
+class A{}
+class B extends A{}
+class C extends B{}
+
+// independent types X, Y, and Z
+class X{} class Y{} class Z{}
+
+// interfaces I, I1 &lt;: I, I2 &lt;: I, I3
+interface I
+interface I1 extends I {}
+interface I2 extends I {}
+interface I3 {}
+
+// class implementing the interfaces
+class H1 implements I1{}
+class H12 implements I1,I2{}
+class H23 implements I2,I3{}
+
+// a generic class with getter (contra-variance) and setter (co-variance)
+class G&lt;T&gt; {
+    get(). T;
+    set(x: T): void;
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="_type-expressions"><a class="anchor" href="#_type-expressions"></a><a class="link" href="#_type-expressions">4.2. Type Expressions</a></h3>
+<div class="paragraph">
+<p>In contrast to ECMAScript, N4JS defines static types.
+Aside from simple type references, type expressions may be used to specify the type of variables.</p>
+</div>
+<div class="sect3">
+<h4 id="_syntax"><a class="anchor" href="#_syntax"></a><a class="link" href="#_syntax">4.2.1. Syntax</a></h4>
+<div class="paragraph">
+<p>The listing <a href="grammars.html#lst:EBNFTypeExpression">EBNF Type Expression Grammar</a> summarizes the type expression grammar.
+Depending on the context, not all constructs are allowed.
+For example, the variadic modifier is only allowed for function parameters.</p>
+</div>
+<div class="paragraph">
+<p>References to user-declared types are expressed via <code>ParameterizedTypeRef</code>.
+This is also true for non-generic types, as the type arguments are optional.
+See <a href="#_parameterized-types">Parameterized Types</a> for details on that reference.</p>
+</div>
+<div class="paragraph">
+<p>For qualified names and type reference names, see <a href="names.html#_qualified-names">Qualified Names</a></p>
+</div>
+<div class="paragraph">
+<p>The type expressions are usually added to parameter, field, or variable declarations as a suffix, separated with colon (<code>:</code>).
+The same is true for function, method, getter or setter return types.
+Exceptions in the cases of object literals or destructuring are explained later on.</p>
+</div>
+<div class="exampleblock">
+<div class="title">Example 7. Type Annotation Syntax</div>
+<div class="content">
+<div class="paragraph">
+<p>The following two listings show the very same code and type annotations are provided on
+the left hand side. For simplicity, <code>string</code> is always used as type expression.<sup class="footnote">[<a id="_footnoteref_10" class="footnote" href="appendix_c_bibliography.html#_footnote_10" title="View footnote.">10</a>]</sup></p>
+</div>
+<table class="tableblock frame-none grid-none spread">
+<colgroup>
+<col style="width: 50%;">
+<col style="width: 50%;">
+</colgroup>
+<tbody>
+<tr>
+<td class="tableblock halign-left valign-top"><div><div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">var x: string;
+var s: string = "Hello";
+function f(p: string): string {
+    return p;
+}
+class C {
+    f: string;
+    s: string = "Hello";
+    m(p: string): string {
+        return p;
+    }
+    get x(): string {
+        return this.f;
+    }
+    set x(v: string) {
+        this.f = v;
+    }
+}</code></pre>
+</div>
+</div></div></td>
+<td class="tableblock halign-left valign-top"><div><div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">var x;
+var s = "Hello";
+function f(p) {
+    return p;
+}
+class C {
+    f;
+    s = "Hello";
+    m(p) {
+        return p;
+    }
+    get x() {
+        return this.f;
+    }
+    set x(v) {
+        this.f = v;
+    }
+}</code></pre>
+</div>
+</div></div></td>
+</tr>
+</tbody>
+</table>
+<div class="paragraph">
+<p>The code on the right hand side is almost all valid ECMAScript 2015, with the exception of field declarations in the class.
+These are moved into the constructor by the N4JS transpiler.</p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_properties"><a class="anchor" href="#_properties"></a><a class="link" href="#_properties">4.2.2. Properties</a></h4>
+<div class="paragraph">
+<p>Besides the properties indirectly defined by the grammar, the following pseudo properties are used for type expressions:</p>
+</div>
+<div class="paragraph">
+<p>Properties of <code>TypeExpression</code>:</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>v</mi><mi>a</mi><mi>r</mi></math> </dt>
+<dd>
+<p>If true, variable of that type is variadic. This is only allowed for parameters. Default value: <code>false</code>.</p>
+</dd>
+<dt class="hdlist1"><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>o</mi><mi>p</mi><mi>t</mi></math> </dt>
+<dd>
+<p>If true, variable of that type is optional. This is only allowed for parameters and return types.
+This actually means that the type <em>T</em> actually is a union type of <code>Undef|<em>T</em></code>.
+Default value: <code>false</code>.</p>
+</dd>
+<dt class="hdlist1"><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>o</mi><mi>p</mi><mi>t</mi><mi>v</mi><mi>a</mi><mi>r</mi></math> </dt>
+<dd>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>o</mi><mi>p</mi><mi>t</mi><mi>v</mi><mi>a</mi><mi>r</mi><mo>=</mo><mi>v</mi><mi>a</mi><mi>r</mi><mo>∨</mo><mi>o</mi><mi>p</mi><mi>t</mi></math>, reflect the facts that a variadic parameter is also optional (as its cardinality is <math xmlns="http://www.w3.org/1998/Math/MathML"><mrow><mfenced close="]" open="["><mrow><mn>0</mn><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mi>n</mi></mrow></mfenced><mo>)</mo></mrow><mo>.</mo></math></p>
+</dd>
+<dt class="hdlist1"><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>e</mi><mi>n</mi><mi>t</mi><mi>i</mi><mi>t</mi><mi>y</mi></math> </dt>
+<dd>
+<p>Pseudo property referencing the variable declaration (or expression) which <code>owns</code> the type expression.</p>
+</dd>
+</dl>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_semantics"><a class="anchor" href="#_semantics"></a><a class="link" href="#_semantics">4.2.3. Semantics</a></h4>
+<div class="paragraph">
+<p>The ECMAScript types <em>undefined</em> and <em>null</em> are also supported.
+These types cannot be referenced directly, however.
+Note that <code>void</code> and <em>undefined</em> are almost similar.
+Actually, the inferred type of a types element with declared type of <code>void</code> will be <em>undefined</em>.
+The difference between void and undefined is that an element of type void can never have another type,
+while an element of type undefined may be assigned a value later on and thus become a different type.
+<code>void</code> is only used for function and method return types.</p>
+</div>
+<div class="paragraph">
+<p>Note that not any type reference is allowed in any context.
+Variables or formal parameters must not be declared <code>void</code> or union types must not be declared dynamic, for example.
+These constraints are explained in the following section.</p>
+</div>
+<div class="paragraph">
+<p>The types mentioned above are described in detail in the next sections.
+They are hierarchically defined and the following list displays all possible types.
+Note that all types are actually references to types.
+A type variable can only be used in some cases, e.g., the variable has to be visible in the given scope.</p>
+</div>
+<h5 id="_ecmascript-types" class="discrete">ECMAScript Types</h5>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Predefined Type</dt>
+<dd>
+<p>Predefined types, such as String, Number, or Object; and .</p>
+</dd>
+<dt class="hdlist1">Array Type</dt>
+<dd>
+<p><a href="#_array-object-type">Array Object Type</a>.</p>
+</dd>
+<dt class="hdlist1">Function Type</dt>
+<dd>
+<p>Described in <a href="functions.html#_functions">Functions</a>, <a href="functions.html#_function-type">Function Type</a>.</p>
+</dd>
+<dt class="hdlist1">Any Type</dt>
+<dd>
+<p><a href="#_any-type">Any Type</a>.</p>
+</dd>
+</dl>
+</div>
+<h5 id="_n4types" class="discrete">N4Types</h5>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Declared Type</dt>
+<dd>
+<p>(Unparameterized) Reference to defined class <a href="classifiers.html#_classes">Classes</a> or enum <a href="#_enums">Enums</a>.</p>
+</dd>
+<dt class="hdlist1">Parameterized Type</dt>
+<dd>
+<p>Parameterized reference to defined generic class or interface; <a href="#_parameterized-types">Parameterized Types</a>.</p>
+</dd>
+<dt class="hdlist1">This Type</dt>
+<dd>
+<p><a href="#_this-type">This Type</a>.</p>
+</dd>
+<dt class="hdlist1">Constructor and Type Type</dt>
+<dd>
+<p>Class type, that is the meta class of a defined class or interface, <a href="#_constructor-and-classifier-type">Constructor and Classifier Type</a>.</p>
+</dd>
+<dt class="hdlist1">Union Types</dt>
+<dd>
+<p>Union of types, <a href="#_union-type">Union Type</a>.</p>
+</dd>
+<dt class="hdlist1">Type Variable</dt>
+<dd>
+<p>Type variable, <a href="#_type-variables">Type Variables</a>.</p>
+</dd>
+</dl>
+</div>
+<div class="paragraph">
+<p>Type expressions are used to explicitly declare the type of a variable, parameter and return type of a function or method, fields (and object literal properties).</p>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="_type-inference"><a class="anchor" href="#_type-inference"></a><a class="link" href="#_type-inference">4.3. Type Inference</a></h3>
+<div class="paragraph">
+<p>If no type is explicitly declared, it is inferred based on the given context, as in the expected type of expressions or function parameters, for example.
+The type inference rules are described in the remainder of this specification.</p>
+</div>
+<div class="openblock definition">
+<div class="content">
+<div class="paragraph">
+<p><a id="default_type"></a><strong>Definition:</strong> <a href="#default_type">Default Type</a></p>
+</div>
+<div class="paragraph">
+<p>In N4JS mode , if no type is explicitly specified and if no type information can be inferred, <code>any</code> is assumed as the default type.</p>
+</div>
+<div class="paragraph">
+<p>In JS mode, the default type is <code>any+</code>.</p>
+</div>
+<div class="paragraph">
+<p>Once the type of a variable is either declared or inferred, it is not supposed to be changed.</p>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Given the following example.</p>
+</div>
+<div class="listingblock">
+<div class="title">Variable type is not changeable</div>
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">var x: any;
+x = 42;
+x-5; // error: any is not a subtype of number.</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Type of <code>x</code> is declared as <code>any</code> in line 1. Although a number is assigned to <code>x</code> in line 2, the type of <code>x</code> is not changed. Thus an error is issued in line 3 because the type of <code>x</code> is still <code>any</code>.</p>
+</div>
+<div class="paragraph todo">
+<p>At the moment, N4JS does not support type guards or, more general, effect system (cf. [<a href="appendix_c_bibliography.html#Nielson99a">Nielson99a</a>]).</p>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="_generic-and-parameterized-types"><a class="anchor" href="#_generic-and-parameterized-types"></a><a class="link" href="#_generic-and-parameterized-types">4.4. Generic and Parameterized Types</a></h3>
+<div class="paragraph">
+<p>Some notes on terminology:</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">Type Parameter vs. Type Argument</dt>
+<dd>
+<p>A type parameter is a declaration containing type variables.
+A type argument is a binding of a type parameter to a concrete type or to another type parameter.
+Binding to another type parameter can further restrict the bounds of the type parameter.</p>
+</dd>
+</dl>
+</div>
+<div class="paragraph">
+<p>This is similar to function declarations (with formal parameters) and function calls (with arguments).</p>
+</div>
+<div class="sect3">
+<h4 id="_generic-types"><a class="anchor" href="#_generic-types"></a><a class="link" href="#_generic-types">4.4.1. Generic Types</a></h4>
+<div class="paragraph">
+<p>A class declaration or interface declaration with type parameters declares a generic type.
+A generic type declares a family of types.
+The type parameters have to be bound with type arguments when referencing a generic type.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_type-variables"><a class="anchor" href="#_type-variables"></a><a class="link" href="#_type-variables">4.4.2. Type Variables</a></h4>
+<div class="paragraph">
+<p>A type variable is an identifier used as a type in the context of a generic class definition, generic interface definition or generic method definition.
+A type variable is declared in a type parameter as follows.</p>
+</div>
+<h5 id="_syntax-2" class="discrete">Syntax</h5>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">TypeVariable:
+	(declaredCovariant?='out' | declaredContravariant?='in')?
+	name=IdentifierOrThis ('extends' declaredUpperBound=TypeRef)?
+;</code></pre>
+</div>
+</div>
+<div class="exampleblock">
+<div class="title">Example 8. Type Variable as Upper Bound</div>
+<div class="content">
+<div class="paragraph">
+<p>Note that type variables are also interpreted as types.
+Thus, the upper bound of a type variable may be a type variable as shown in the following snippet:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">class G&lt;T&gt; {
+    &lt;X extends T&gt; foo(x: X): void { }
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<h5 id="type-variables-properties" class="discrete">Properties</h5>
+<div class="paragraph">
+<p>A type parameter defines a type variable, which type may be constrained with an upper bound.</p>
+</div>
+<div class="paragraph">
+<p>Properties of <code>TypeVariable</code>:</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi></math> </dt>
+<dd>
+<p>Type variable, as type variable contains only an identifier, we use type parameter instead of type variable (and vice versa) if the correct element is clear from the context.</p>
+</dd>
+<dt class="hdlist1"><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>d</mi><mi>e</mi><mi>c</mi><mi>l</mi><mi>a</mi><mi>r</mi><mi>e</mi><mi>d</mi><mi>U</mi><mi>p</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>B</mi><mi>o</mi><mi>u</mi><mi>n</mi><mi>d</mi></math> </dt>
+<dd>
+<p>Upper bound of the concrete type being bound to this type variable, i.e. a super class.</p>
+</dd>
+</dl>
+</div>
+<h5 id="type-variables-semantics" class="discrete">Semantics</h5>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-10"></a><strong>Req. IDE-10:</strong> <a href="#Req-IDE-10">Type Variable Semantics</a> (ver. 1)</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Enum is not a valid metatype in <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>d</mi><mi>e</mi><mi>c</mi><mi>l</mi><mi>a</mi><mi>r</mi><mi>e</mi><mi>d</mi><mi>U</mi><mi>p</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>B</mi><mi>o</mi><mi>u</mi><mi>n</mi><mi>d</mi><mi>s</mi></math>.</p>
+</li>
+<li>
+<p>Wildcards are not valid in <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>d</mi><mi>e</mi><mi>c</mi><mi>l</mi><mi>a</mi><mi>r</mi><mi>e</mi><mi>d</mi><mi>U</mi><mi>p</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>B</mi><mi>o</mi><mi>u</mi><mi>n</mi><mi>d</mi><mi>s</mi></math>.</p>
+</li>
+<li>
+<p>Primitives are not valid in <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>d</mi><mi>e</mi><mi>c</mi><mi>l</mi><mi>a</mi><mi>r</mi><mi>e</mi><mi>d</mi><mi>U</mi><mi>p</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>B</mi><mi>o</mi><mi>u</mi><mi>n</mi><mi>d</mi><mi>s</mi></math>.</p>
+</li>
+<li>
+<p>Type variables are valid in <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>d</mi><mi>e</mi><mi>c</mi><mi>l</mi><mi>a</mi><mi>r</mi><mi>e</mi><mi>d</mi><mi>U</mi><mi>p</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>B</mi><mi>o</mi><mi>u</mi><mi>n</mi><mi>d</mi><mi>s</mi></math>.</p>
+</li>
+</ol>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>A type variable can be used in any type expression contained in the generic class, generic interface, or generic function / method definition.</p>
+</div>
+<div class="exampleblock">
+<div class="title">Example 9. F bounded quantification</div>
+<div class="content">
+<div class="paragraph">
+<p>Using a type variable in the upper bound reference may lead to recursive definition.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">class Chain&lt;C extends Chain&lt;C, T&gt;, T&gt; {
+    next() : C { return null; }
+    m() : T { return null; }
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<h5 id="type-variables-type-inference" class="discrete">Type Inference</h5>
+<div class="paragraph">
+<p>In many cases, type variables are not directly used in subtype relations as they are substituted with the concrete types specified by some type arguments.
+In these cases, the ordinary subtype rules apply without change.
+However, there are other cases in which type variables cannot be substituted:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Inside a generic declaration.</p>
+</li>
+<li>
+<p>If the generic type is used as raw type.</p>
+</li>
+<li>
+<p>If a generic function / method is called without type arguments and without the possibility to infer the type from the context.</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>In these cases, an unbound type variable may appear on one or both sides of a subtype relation and we require subtype rules that take type variables into account.</p>
+</div>
+<div class="paragraph">
+<p>It is important to note that while type variables may have a declared upper bound, they cannot be simply replaced with that upper bound and treated like existential types.
+The following example illustrates this:</p>
+</div>
+<div class="exampleblock">
+<div class="title">Example 10. Type variables vs. existential types</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">class A {}
+class B extends A {}
+class C extends B {}
+
+class G&lt;T&gt; {}
+
+class X&lt;T extends A, S extends B&gt; {
+
+    m(): void {
+
+        // plain type variables:
+        var t: T;
+        var s: S;
+
+        t = s;  // ERROR: "S is not a subtype of T." at "s" <i class="conum" data-value="1"></i><b>(1)</b>
+
+        // existential types:
+        var ga: G&lt;? extends A&gt;;
+        var gb: G&lt;? extends B&gt;;
+
+        ga = gb;  <i class="conum" data-value="2"></i><b>(2)</b>
+    }
+}</code></pre>
+</div>
+</div>
+<div class="colist arabic">
+<table>
+<tr>
+<td><i class="conum" data-value="1"></i><b>1</b></td>
+<td>Even though the upper bound of <code>S</code> is a subtype of <code>T</code>’s upper bound (since <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>B</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>A</mi></math>), we cannot infer that <code>S</code> is a subtype of <code>T</code>,
+because there are valid concrete bindings for which this would not be true: for example, if <code>T</code> were bound to <code>C</code> and <code>S</code> to <code>B</code>.</td>
+</tr>
+<tr>
+<td><i class="conum" data-value="2"></i><b>2</b></td>
+<td>This differs from existential types (see <code>ga</code> and <code>gb</code> and line 21):<br>
+<code>G&lt;? extends B&gt;</code> <math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/></math> <code>G&lt;? extends A&gt;</code> ).</td>
+</tr>
+</table>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>We thus have to define subtype rules for type variables, taking the declared upper bound into account.
+If we have a subtype relation in which a type variable appears on one or both sides, we distinguish the following cases:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>If we have type variables on both sides: the result is true if and only if there is the identical type variable on both sides.</p>
+</li>
+<li>
+<p>If we have a type variable on the left side and no type variable on the right side:<br>
+the result is true if and only if the type variable on the left has one or more declared upper bounds.<br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>i</mi><mi>n</mi><mi>t</mi><mi>e</mi><mi>r</mi><mi>s</mi><mi>e</mi><mi>c</mi><mi>t</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close=")" open="("><mrow><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi><mo>.</mo><mi>d</mi><mi>e</mi><mi>c</mi><mi>l</mi><mi>a</mi><mi>r</mi><mi>e</mi><mi>d</mi><mi>U</mi><mi>p</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>B</mi><mi>o</mi><mi>u</mi><mi>n</mi><mi>d</mi><mi>s</mi></mrow></mfenced><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>r</mi><mi>i</mi><mi>g</mi><mi>h</mi><mi>t</mi></math><br>
+This is the case for</p>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfenced close=")" open="("><mrow><mi>T</mi><mspace width="3.0mm"/><mi>e</mi><mi>x</mi><mi>t</mi><mi>e</mi><mi>n</mi><mi>d</mi><mi>s</mi><mspace width="3.0mm"/><mi>B</mi></mrow></mfenced><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>A</mi></math>
+</div>
+</div>
+<div class="paragraph">
+<p>in which T is an unbound type variable and A, B two classes with <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>B</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>A</mi></math>.</p>
+</div>
+</li>
+<li>
+<p>In all other cases the result is false.<br>
+This includes cases such as</p>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mi>B</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mfenced close=")" open="("><mrow><mi>T</mi><mspace width="3.0mm"/><mi>e</mi><mi>x</mi><mi>t</mi><mi>e</mi><mi>n</mi><mi>d</mi><mi>s</mi><mspace width="3.0mm"/><mi>A</mi></mrow></mfenced></math>
+</div>
+</div>
+<div class="paragraph">
+<p>which is always false, even if <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>B</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>A</mi></math> or</p>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfenced close=")" open="("><mrow><mi>T</mi><mspace width="3.0mm"/><mi>e</mi><mi>x</mi><mi>t</mi><mi>e</mi><mi>n</mi><mi>d</mi><mi>s</mi><mspace width="3.0mm"/><mi>A</mi></mrow></mfenced><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mfenced close=")" open="("><mrow><mi>S</mi><mspace width="3.0mm"/><mi>e</mi><mi>x</mi><mi>t</mi><mi>e</mi><mi>n</mi><mi>d</mi><mi>s</mi><mspace width="3.0mm"/><mi>B</mi></mrow></mfenced></math>
+</div>
+</div>
+<div class="paragraph">
+<p>which is always false, even if <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>A</mi><mo>=</mo><mi>B</mi></math>.</p>
+</div>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>We thus obtain the following defintion:</p>
+</div>
+<div class="openblock definition">
+<div class="content">
+<div class="paragraph">
+<p><a id="subtype_relation_for_type_variables"></a><strong>Definition:</strong> <a href="#subtype_relation_for_type_variables">Subtype Relation for Type Variables</a></p>
+</div>
+<div class="paragraph">
+<p>For two types <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi><mo>,</mo><mi>S</mi></math> of which at least one is a type variable, we define</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>if both <em>T</em> and <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>S</mi></math> are type variables:</p>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><mi>T</mi><mo>=</mo><mi>S</mi></mrow><mrow><mi>T</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>S</mi></mrow></mfrac></math>
+</div>
+</div>
+</li>
+<li>
+<p>if <em>T</em> is a type variable and <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>S</mi></math> is not:</p>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><mrow><mi>T</mi><mo>.</mo><mstyle mathvariant="italic"><mi>d</mi><mi>e</mi><mi>c</mi><mi>l</mi><mi>a</mi><mi>r</mi><mi>e</mi><mi>d</mi><mi>U</mi><mi>p</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>B</mi><mi>o</mi><mi>u</mi><mi>n</mi><mi>d</mi><mi>s</mi></mstyle><mo>.</mo><mstyle mathvariant="italic"><mi>s</mi><mi>i</mi><mi>z</mi><mi>e</mi></mstyle><mo>&gt;</mo><mn>0</mn></mrow><mrow><mi> </mi><mo>∧</mo><mi> </mi><mo>∀</mo><mi>t</mi><mo>∈</mo><mi>T</mi><mo>.</mo><mstyle mathvariant="italic"><mi>d</mi><mi>e</mi><mi>c</mi><mi>l</mi><mi>a</mi><mi>r</mi><mi>e</mi><mi>d</mi><mi>U</mi><mi>p</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>B</mi><mi>o</mi><mi>u</mi><mi>n</mi><mi>d</mi><mi>s</mi></mstyle><mi>:</mi><mi>t</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>S</mi></mrow></mrow><mrow><mi>T</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>S</mi></mrow></mfrac></math>
+</div>
+</div>
+</li>
+</ul>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_parameterized-types"><a class="anchor" href="#_parameterized-types"></a><a class="link" href="#_parameterized-types">4.4.3. Parameterized Types</a></h4>
+<div class="paragraph">
+<p>References to generic types (cf. <a href="classifiers.html#_classes">Classes</a>) can be parameterized with type arguments.
+A type reference with type arguments is called parameterized type.</p>
+</div>
+<h5 id="parameterized-types-syntax" class="discrete">Syntax</h5>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">ParameterizedTypeRef:
+    ParameterizedTypeRefNominal | ParameterizedTypeRefStructural;
+
+ParameterizedTypeRefNominal:
+    declaredType=[Type|TypeReferenceName]
+    (=&gt; '&lt;' typeArgs+=TypeArgument (',' typeArgs+=TypeArgument)* '&gt;')?;
+
+ParameterizedTypeRefStructural:
+    definedTypingStrategy=TypingStrategyUseSiteOperator
+    declaredType=[Type|TypeReferenceName]
+    (=&gt;'&lt;' typeArgs+=TypeArgument (',' typeArgs+=TypeArgument)* '&gt;')?
+    ('with' TStructMemberList)?;
+
+TypeArgument returns TypeArgument:
+    Wildcard | TypeRef;
+
+Wildcard returns Wildcard:
+    '?'
+    (
+          'extends' declaredUpperBound=TypeRef
+        | 'super' declaredLowerBound=TypeRef
+    )?
+;</code></pre>
+</div>
+</div>
+<h5 id="parameterized-types-properties" class="discrete">Properties</h5>
+<div class="paragraph">
+<p>Properties of parameterized type references (nominal or structural):</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><code>declaredType</code> </dt>
+<dd>
+<p>Referenced type by type reference name (either the simple name or a qualified name, e.g. in case of namespace imports).</p>
+</dd>
+<dt class="hdlist1"><code>typeArgs</code> </dt>
+<dd>
+<p>The type arguments, may be empty.</p>
+</dd>
+<dt class="hdlist1"><code>definedTypingStrategy</code> </dt>
+<dd>
+<p>Typing strategy, by default nominal, see <a href="classifiers.html#_structural-typing">Structural Typing</a> for details</p>
+</dd>
+<dt class="hdlist1"><code>structuralMembers</code> </dt>
+<dd>
+<p>in case of structural typing, reference can add additional members to the structural type, see <a href="classifiers.html#_structural-typing">Structural Typing</a> for details.</p>
+</dd>
+</dl>
+</div>
+<div class="paragraph">
+<p><strong>Pseudo Properties:</strong></p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><code>importSpec</code> </dt>
+<dd>
+<p>The <code>ImportSpecifier</code>, may be null if this is a local type reference.
+Note that this may be a <code>NamedImportSpecifier</code>. See <a href="statements.html#_import-statement">Import Statement</a> for details for details.</p>
+</dd>
+<dt class="hdlist1"><code>moduleWideName</code> </dt>
+<dd>
+<p>Returns simple name of type, that is either the simple name as declared, or the alias in case of an imported type with alias in the import statement.</p>
+</dd>
+</dl>
+</div>
+<h5 id="parameterized-types-semantics" class="discrete">Semantics</h5>
+<div class="paragraph">
+<p>The main purpose of a parameterized type reference is to simply refer to the declared type.
+If the declared type is a generic type, the parameterized type references defines a <em>substitution</em> of the type parameters of a generic type with actual type arguments.
+A type argument can either be a concrete type, a wildcard or a type variable declared in the surrounding generic declaration.
+The actual type arguments must conform to the type parameters so that code referencing the generic type parameters is still valid.</p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-11"></a><strong>Req. IDE-11:</strong> <a href="#Req-IDE-11">Parameterized Types</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>For a given parameterized type reference <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>R</mi></math> with <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>G</mi><mo>=</mo><mi>R</mi><mo>.</mo><mi>d</mi><mi>e</mi><mi>c</mi><mi>l</mi><mi>a</mi><mi>r</mi><mi>e</mi><mi>d</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi></math>, the following constraints must hold:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>The actual type arguments must conform to the type parameters, that is:</p>
+<div class="paragraph">
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mo>|</mo><mi>G</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>P</mi><mi>a</mi><mi>r</mi><mi>s</mi><mo>|</mo><mo>=</mo><mo>|</mo><mi>R</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>A</mi><mi>r</mi><mi>g</mi><mi>s</mi><mo>|</mo></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∧</mo><mo>∀</mo><mi> </mi><mi>i</mi><mo>,</mo><mn>0</mn><mo>&lt;</mo><mi>i</mi><mo>&lt;</mo><mo>|</mo><mi>R</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>A</mi><mi>r</mi><mi>g</mi><mi>s</mi><mo>|</mo><mi>:</mi><mrow><mo>[</mo><mspace width="-0.167em"/><mrow><mo>[</mo></mrow></mrow><mrow><mi>R</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>A</mi><mi>r</mi><mi>g</mi><msub><mi>s</mi><mi>i</mi></msub></mrow><mrow><mrow><mo>]</mo></mrow><mspace width="-0.167em"/><mo>]</mo></mrow><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mrow><mo>[</mo><mspace width="-0.167em"/><mrow><mo>[</mo></mrow></mrow><mrow><mi>R</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>P</mi><mi>a</mi><mi>r</mi><msub><mi>s</mi><mi>i</mi></msub></mrow><mrow><mrow><mo>]</mo></mrow><mspace width="-0.167em"/><mo>]</mo></mrow></math></p>
+</div>
+</li>
+</ul>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>We define type erasure similar to Java [<a href="appendix_c_bibliography.html#Gosling12a">Gosling12a(p.S4.6)</a>] as 'mapping from types (possibly including parameterized types and type variables)
+to types (that are never parameterized types or type variables)'. We write <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi></math><sup>o</sup>
+for the erasure of type <em>T</em>.<sup class="footnote">[<a id="_footnoteref_11" class="footnote" href="appendix_c_bibliography.html#_footnote_11" title="View footnote.">11</a>]</sup></p>
+</div>
+<div class="openblock definition">
+<div class="content">
+<div class="paragraph">
+<p><a id="parameterized_type"></a><strong>Definition:</strong> <a href="#parameterized_type">Parameterized Type</a></p>
+</div>
+<div class="paragraph">
+<p>A parameterized type reference <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>R</mi></math> defines a parameterized type <em>T</em>, in which all type parameters of <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>R</mi><mo>.</mo><mi>d</mi><mi>e</mi><mi>c</mi><mi>l</mi><mi>a</mi><mi>r</mi><mi>e</mi><mi>d</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi></math> are substituted with the actual values of the type arguments.
+We call the type <math xmlns="http://www.w3.org/1998/Math/MathML"><msup><mi>T</mi><mn>0</mn></msup></math>, in which all type parameters of <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>R</mi><mo>.</mo><mi>d</mi><mi>e</mi><mi>c</mi><mi>l</mi><mi>a</mi><mi>r</mi><mi>e</mi><mi>d</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi></math> are ignored, the <em>raw type</em> or <em>erasure</em> of <em>T</em>.</p>
+</div>
+<div class="paragraph">
+<p>We define for types in general:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>The erasure <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>G</mi></math><sup>o</sup> of a parameterized type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>G</mi><mo>&lt;</mo><msub><mi>T</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>T</mi><mi>n</mi></msub><mo>&gt;</mo></math> is simply <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>G</mi></math>.</p>
+</li>
+<li>
+<p>The erasure of a type variable is the erasure of its upper bound.</p>
+</li>
+<li>
+<p>The erasure of any other type is the type itself.</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>This concept of type erasure is purely defined for specification purposes.
+It is not to be confused with the <code>real</code> type erasure which takes place at runtime, in which almost no types (except primitive types) are available.</p>
+</div>
+<div class="paragraph">
+<p>That is, the type reference in <code>var G&lt;string&gt; gs;</code> actually defines a type <code>G&lt;string&gt;</code>, so that <math xmlns="http://www.w3.org/1998/Math/MathML"><mrow><mo>[</mo><mspace width="-0.167em"/><mrow><mo>[</mo></mrow></mrow><mrow><mi>g</mi><mi>s</mi></mrow><mrow><mrow><mo>]</mo></mrow><mspace width="-0.167em"/><mo>]</mo></mrow><mo>=</mo><mstyle mathvariant="monospace"><mtext>G</mtext></mstyle><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>string</mtext></mstyle><mo>&gt;</mo></math>.
+It may reference a type defined by a class declaration <code>class G&lt;T&gt;</code>.
+It is important that the type <code>G&lt;string&gt;</code> is different from <code>G&lt;T&gt;</code>.</p>
+</div>
+<div class="paragraph">
+<p>If a parameterized type reference <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>R</mi></math> has no type arguments, then it is similar to the declared type.
+That is, <math xmlns="http://www.w3.org/1998/Math/MathML"><mrow><mo>[</mo><mspace width="-0.167em"/><mrow><mo>[</mo></mrow></mrow><mi>R</mi><mrow><mrow><mo>]</mo></mrow><mspace width="-0.167em"/><mo>]</mo></mrow><mo>=</mo><mi>T</mi><mo>=</mo><mi>R</mi><mo>.</mo><mi>d</mi><mi>e</mi><mi>c</mi><mi>l</mi><mi>a</mi><mi>r</mi><mi>e</mi><mi>d</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi></math> if (and only if) <math xmlns="http://www.w3.org/1998/Math/MathML"><mo>|</mo><mi>R</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>A</mi><mi>r</mi><mi>g</mi><mi>s</mi><mo>|</mo><mo>=</mo><mn>0</mn></math>.</p>
+</div>
+<div class="paragraph">
+<p>In the following, we do not distinguish between parameter type reference and parameter type – they are both two sides of the same coin.</p>
+</div>
+<div class="exampleblock">
+<div class="title">Example 11. Raw Types</div>
+<div class="content">
+<div class="paragraph">
+<p>In Java, due to backward compatibility (generics were only introduced in Java 1.5), it is possible to use raw types in which we refer to a generic type without specifying any type arguments.
+This is not possible in N4JS, as there is no unique interpretation of the type in that case as shown in the following example.
+Given the following declarations:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">class A{}
+class B extends A{}
+class G&lt;T extends A&gt; { t: T; }
+var g: G;</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>In this case, variable <code>g</code> refers to the <em>raw type</em> <code>G</code>.
+This is forbidden in N4JS, because two interpretations are possible:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p><code>g</code> is of type <code>G&lt;?  extends&gt;</code></p>
+</li>
+<li>
+<p><code>g</code> is of type <code>G&lt;A&gt;</code></p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>In the first case, an existential type would be created, and <code>g.t = new A();</code> must fail.</p>
+</div>
+<div class="paragraph">
+<p>In the second case, <code>g = new G&lt;B&gt;();</code> must fail.</p>
+</div>
+<div class="paragraph">
+<p>In Java, both assignments work with raw types, which is not really safe.
+To avoid problems due to different interpretations, usage of raw types
+is not allowed in N4JS. <sup class="footnote">[<a id="_footnoteref_12" class="footnote" href="appendix_c_bibliography.html#_footnote_12" title="View footnote.">12</a>]</sup></p>
+</div>
+<div class="paragraph">
+<p>Calls to generic functions and methods can also be parameterized, this is described in <a href="expressions.html#_function-calls">Function Calls</a>.
+Note that invocation of generic functions or methods does not need to be parameterized.</p>
+</div>
+<div class="openblock definition">
+<div class="content">
+<div class="paragraph">
+<p><a id="type_conformance"></a><strong>Definition:</strong> <a href="#type_conformance">Type Conformance</a></p>
+</div>
+<div class="paragraph">
+<p>We define type conformance for non-primitive type references as follows:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>For two non-parameterized types <math xmlns="http://www.w3.org/1998/Math/MathML"><msup><mi>T</mi><mn>0</mn></msup></math> and <math xmlns="http://www.w3.org/1998/Math/MathML"><msup><mi>S</mi><mn>0</mn></msup></math>,</p>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><msup><mi>S</mi><mn>0</mn></msup><mo>∈</mo><msup><mi>T</mi><mn>0</mn></msup><mo>.</mo><mi>s</mi><mi>u</mi><msup><mi>p</mi><mo>*</mo></msup><mo>∪</mo><msup><mi>T</mi><mn>0</mn></msup><mo>.</mo><mi>i</mi><mi>n</mi><mi>t</mi><mi>e</mi><mi>r</mi><mi>f</mi><mi>a</mi><mi>c</mi><mi>e</mi><msup><mi>s</mi><mo>*</mo></msup></mrow><mrow><msup><mi>T</mi><mn>0</mn></msup><mo>&lt;</mo><mi>:</mi><msup><mi>S</mi><mn>0</mn></msup></mrow></mfrac></math>
+</div>
+</div>
+</li>
+<li>
+<p>For two parameterized types <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>T</mi><mo>&lt;</mo><msub><mi>T</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>T</mi><mi>n</mi></msub><mo>&gt;</mo></math> and <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>S</mi><mo>&lt;</mo><msub><mi>S</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>S</mi><mi>m</mi></msub><mo>&gt;</mo></math></p>
+<div class="paragraph">
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mfrac><mrow><msup><mi>T</mi><mn>0</mn></msup><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><msup><mi>S</mi><mn>0</mn></msup></mrow><mrow><mspace width="10.0em"/><mi>T</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>S</mi><mspace width="10.0em"/></mrow></mfrac></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mrow><mo>(</mo><mi>n</mi><mo>=</mo><mn>0</mn><mo>∨</mo><mi>m</mi><mo>=</mo><mn>0</mn><mo>∨</mo><mrow><mo>(</mo><mi>n</mi><mo>=</mo><mi>m</mi><mo>→</mo><mo>∀</mo><mi>i</mi><mi>:</mi></mrow></mrow></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="2.0em"/><mrow><msub><mi>T</mi><mi>i</mi></msub><mo>.</mo><mi>u</mi><mi>p</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>B</mi><mi>o</mi><mi>u</mi><mi>n</mi><mi>d</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><msub><mi>S</mi><mi>i</mi></msub><mo>.</mo><mi>u</mi><mi>p</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>B</mi><mi>o</mi><mi>u</mi><mi>n</mi><mi>d</mi></mrow></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mrow><mrow><mspace width="1.0em"/><mo>∧</mo><mrow><msub><mi>T</mi><mi>i</mi></msub><mo>.</mo><mi>l</mi><mi>o</mi><mi>w</mi><mi>e</mi><mi>r</mi><mi>B</mi><mi>o</mi><mi>u</mi><mi>n</mi><mi>d</mi><mi>:</mi><mo>&gt;</mo><msub><mi>S</mi><mi>i</mi></msub><mo>.</mo><mi>l</mi><mi>o</mi><mi>w</mi><mi>e</mi><mi>r</mi><mi>B</mi><mi>o</mi><mi>u</mi><mi>n</mi><mi>d</mi></mrow><mo>)</mo></mrow><mo>)</mo></mrow><mi>}</mi></math></p>
+</div>
+</li>
+</ul>
+</div>
+</div>
+</div>
+<div class="exampleblock">
+<div class="title">Example 12. Subtyping with parameterized types</div>
+<div class="content">
+<div class="paragraph">
+<p>Let classes A, B, and C are defined as in the chapter beginning (<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>C</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>B</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>A</mi></math>).
+The following subtype relations are evaluated as indicated:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">G&lt;A&gt; &lt;: G&lt;B&gt;                        -&gt; false
+G&lt;B&gt; &lt;: G&lt;A&gt;                        -&gt; false
+G&lt;A&gt; &lt;: G&lt;A&gt;                        -&gt; true
+G&lt;A&gt; &lt;: G&lt;?&gt;                        -&gt; true
+G&lt;? extends A&gt; &lt;: G&lt;? extends A&gt;    -&gt; true
+G&lt;? super A&gt; &lt;: G&lt;? super A&gt;        -&gt; true
+G&lt;? extends A&gt; &lt;: G&lt;? extends B&gt;    -&gt; false
+G&lt;? extends B&gt; &lt;: G&lt;? extends A&gt;    -&gt; true
+G&lt;? super A&gt; &lt;: G&lt;? super B&gt;        -&gt; true
+G&lt;? super B&gt; &lt;: G&lt;? super A&gt;        -&gt; false
+G&lt;? extends A&gt; &lt;: G&lt;A&gt;              -&gt; false
+G&lt;A&gt; &lt;: G&lt;? extends A&gt;              -&gt; true
+G&lt;? super A&gt; &lt;: G&lt;A&gt;                -&gt; false
+G&lt;A&gt; &lt;: G&lt;? super A&gt;                -&gt; true
+G&lt;? super A&gt; &lt;: G&lt;? extends A&gt;      -&gt; false
+G&lt;? extends A&gt; &lt;: G&lt;? super A&gt;      -&gt; false
+G&lt;?&gt; &lt;: G&lt;? super A&gt;                -&gt; false
+G&lt;? super A&gt; &lt;: G&lt;?&gt;                -&gt; true
+G&lt;?&gt; &lt;: G&lt;? extends A&gt;              -&gt; false
+G&lt;? extends A&gt; &lt;: G&lt;?&gt;              -&gt; true</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>The figure <a href="#cdVarianceChart">Cheat Sheet: Subtype Relation of Parameterized Types</a> shows the subtype relations of parameterized types (of a single generic type), which can be used as a cheat sheet.</p>
+</div>
+<div id="cdVarianceChart" class="imageblock" style="text-align: center">
+<div class="content">
+<img src="chapters/04_types/fig/cdVarianceChart.svg" alt="cdVarianceChart">
+</div>
+<div class="title">Figure 3. Cheat Sheet: Subtype Relation of Parameterized Types</div>
+</div>
+<div class="exampleblock">
+<div class="title">Example 13. Subtyping between different generic types</div>
+<div class="content">
+<div class="paragraph">
+<p>Let classes <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>G</mi></math> and <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>H</mi></math> be two generic classes where:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">class G&lt;T&gt; {}
+class H&lt;T&gt; extends G&lt;T&gt; {}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Given a simple, non-parameterized class <em>A</em>, the following
+subtype relations are evaluated as indicated:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">G&lt;A&gt; &lt;: G&lt;A&gt;                        -&gt; true
+H&lt;A&gt; &lt;: G&lt;A&gt;                        -&gt; true
+G&lt;A&gt; &lt;: H&lt;A&gt;                        -&gt; false</code></pre>
+</div>
+</div>
+</div>
+</div>
+<h5 id="parameterized-types-type-inference" class="discrete">Type Inference</h5>
+<div class="paragraph">
+<p>Type inference for parameterized types uses the concept of existential types (in Java, a slightly modified version called capture conversion is implemented).</p>
+</div>
+<div class="paragraph">
+<p>The general concept for checking type conformance and inferring types for generic and parameterized types is described in [<a href="appendix_c_bibliography.html#Igarashi01a">Igarashi01a</a>] for <em>Featherweight Java with Generics</em>.</p>
+</div>
+<div class="paragraph">
+<p>The concept of existential types with wildcard capture (a special kind of existential type) is published in [<a href="appendix_c_bibliography.html#Torgersen05a">Torgersen05a</a>], further developed in [<a href="appendix_c_bibliography.html#Cameron08b">Cameron08b</a>] (further developed in  [<a href="appendix_c_bibliography.html#Cameron09a">Cameron09a</a>] [<a href="appendix_c_bibliography.html#Summers10a">Summers10a</a>], also see [<a href="appendix_c_bibliography.html#Wehr08a">Wehr08a</a>] for a similar approach).
+The key feature of the Java generic wildcard handling is called capture conversion, described in [<a href="appendix_c_bibliography.html#Gosling12a">Gosling12a(p.S5.1.10)</a>].
+However, there are some slight differences to Java 6 and 7, only with Java 8 similar results can be expected.
+All these papers include formal proofs of certain aspects, however even these paper lack proof of other aspect</p>
+</div>
+<div class="paragraph">
+<p>The idea is quite simple: All unbound wildcards are replaced with freshly created new types <sup class="footnote">[<a id="_footnoteref_13" class="footnote" href="appendix_c_bibliography.html#_footnote_13" title="View footnote.">13</a>]</sup>,
+fulfilling the constraints defined by the wildcard’s upper and lower bound.
+These newly created types are then handled similar to real types during type inference and type conformance validation.</p>
+</div>
+<div class="exampleblock">
+<div class="title">Example 14. Existential Type</div>
+<div class="content">
+<div class="paragraph">
+<p>The inferred type of a variable
+declared as</p>
+</div>
+<div class="paragraph">
+<p><code>var x: G&lt;? extends A&gt;;</code>,</p>
+</div>
+<div class="paragraph">
+<p>that is the parameterized type, is an existential type <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>E</mi><mn>1</mn></msub></math>, which is a subtype of A.
+If you have another variable declared as</p>
+</div>
+<div class="paragraph">
+<p><code>var y: G&lt;? extends A&gt;;</code></p>
+</div>
+<div class="paragraph">
+<p>another type <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>E</mi><mn>2</mn></msub></math> is created, which is also a subtype of A.
+Note that <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>E</mi><mn>1</mn></msub><mo>≠</mo><msub><mi>E</mi><mn>2</mn></msub></math>! Assuming typical setter or getter in G, e.g. <code>set(T t)</code> and <code>T get()</code>, the following code snippet will produce an error:</p>
+</div>
+<div class="paragraph">
+<p><code>y.set(x.get())</code></p>
+</div>
+<div class="paragraph">
+<p>This is no surprise, as <code>x.get()</code> actually returns a type <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>E</mi><mn>1</mn></msub></math>, which is not a subtype of <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>E</mi><mn>2</mn></msub></math>.</p>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>The upper and lower bound declarations are, of course, still available during type inference for these existential types.
+This enables the type inferencer to calculate the join and meet of parameterized types as well.</p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-12"></a><strong>Req. IDE-12:</strong> <a href="#Req-IDE-12">Join of Parameterized Types</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>The join of two parameterized types <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>G</mi><mo>&lt;</mo><msub><mi>T</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>T</mi><mi>n</mi></msub><mo>&gt;</mo></math> and <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>H</mi><mo>&lt;</mo><msub><mi>S</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>S</mi><mi>m</mi></msub><mo>&gt;</mo></math> is the join of the raw types, this join is then parameterized with the join of the
+upper bounds of of type arguments and the meet of the lower bounds of the type arguments.</p>
+</div>
+<div class="paragraph">
+<p>For all type rules, we assume that the upper and lower bounds of a non-generic type, including type variables,
+simply equal the type itself, that is for a given type <em>T</em>, the following constraints hold:<br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>u</mi><mi>p</mi><mi>p</mi><mi>e</mi><mi>r</mi><mfenced close=")" open="("><mi>T</mi></mfenced><mo>=</mo><mi>l</mi><mi>o</mi><mi>w</mi><mi>e</mi><mi>r</mi><mfenced close=")" open="("><mi>T</mi></mfenced><mo>=</mo><mi>T</mi></math></p>
+</div>
+</div>
+</div>
+<div class="exampleblock">
+<div class="title">Example 15. Upper and lower bound of parameterized types</div>
+<div class="content">
+<div class="paragraph">
+<p>Assuming the given classes listed above, the following upper and lower bounds are expected:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">G&lt;A&gt;            -&gt; upperBound = lowerBound = A
+G&lt;? extends A&gt;  -&gt; lowerBound = null, upperBound = A
+G&lt;? super A&gt;    -&gt; lowerBound = A, upperBound = any
+G&lt;?&gt;            -&gt; lowerBound = null, upperBound = any</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>This leads to the following expected subtype relations:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">(? extends A) &lt;: A  -&gt; true
+(? super A) &lt;: A    -&gt; false
+A &lt;: (? extends A)  -&gt; false
+A &lt;: (? super A)    -&gt; true</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Note that there is a slight difference to Java: In N4JS it is not possible to use a generic type in a raw fashion, that is to say without specifying any type arguments.
+In Java, this is possible due to backwards compatibility with early Java versions in which no generics were supported.</p>
+</div>
+<div class="paragraph">
+<p>In case an upper bound of a type variable shall consist only of a few members, it seems convenient to use additional structural members,
+like on interface I2 in the example <a href="#ex:use-declared-interfaces-for-lower-bounds">Use declared interfaces for lower bounds</a> below.
+However, type variables must not be constrained using structural types (see constraint <a href="classifiers.html#Req-IDE-76">[Req-IDE-76]</a>).
+Hence, the recommended solution is to use an explicitly declared interface that uses definition site structural typing for these constraints as an upper bound (see interface in <a href="#ex:use-declared-interfaces-for-lower-bounds">Use declared interfaces for lower bounds</a>).</p>
+</div>
+<div id="ex:use-declared-interfaces-for-lower-bounds" class="exampleblock">
+<div class="title">Example 16. Use declared interfaces for lower bounds</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">interface I1&lt;T extends any with {prop : int}&gt; { // error
+}
+
+interface ~J {
+    prop : int;
+}
+interface I2&lt;T extends J&gt; {
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="_primitive-ecmascript-types"><a class="anchor" href="#_primitive-ecmascript-types"></a><a class="link" href="#_primitive-ecmascript-types">4.5. Primitive ECMAScript Types</a></h3>
+<div class="paragraph">
+<p>N4JS provides the same basic types as ECMAScript [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.p.28)</a>].</p>
+</div>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title=""></i>
+</td>
+<td class="content">
+In ECMAScript, basic types come in two flavors: as primitive types [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.S8Types, p.p.28)</a>] and as Objects [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.S15, p.p.102)</a>].
+In N4JS, primitive types are written with lower cases, object types with first case capitalized.
+For example, <code>String</code> is the primitive ECMAScript string type, while <code>String</code> is an object.
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>The following ECMAScript primitive types are supported, they are written
+with lower case letters::</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>undefined</code>: [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.S8.3)</a>]; cannot be used in type expression, see void below.</p>
+</li>
+<li>
+<p><code>null</code> [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.S8.3)</a>]; cannot be used in type expression</p>
+</li>
+<li>
+<p><code>boolean</code>  [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.S8.3)</a>]</p>
+</li>
+<li>
+<p><code>string</code> [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.S8.4)</a>]</p>
+</li>
+<li>
+<p><code>number</code> [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.S8.5)</a>]</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Although Object is a primitive type in [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.S8.5)</a>], it is interpreted here as an object type and described in <a href="#_object-type">Object Type</a>.</p>
+</div>
+<div class="paragraph">
+<p>Please note that primitive types are values (= no objects) so they have no properties and you cannot inherit from them.</p>
+</div>
+<div class="sect3">
+<h4 id="_undefined-type"><a class="anchor" href="#_undefined-type"></a><a class="link" href="#_undefined-type">4.5.1. Undefined Type</a></h4>
+<div class="paragraph">
+<p>As a built-in type, the type <code>undefined</code> cannot be declared explicitly by the user by means of a type expression.
+Note in ECMAScript there are three distinct use cases of <code>undefined</code>:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>undefined</code> as type (as used here)</p>
+</li>
+<li>
+<p><code>undefined</code> as value (the only value of the undefined type)</p>
+</li>
+<li>
+<p><code>undefined</code> is a property of the global object with undefined (value) as initial value.
+Since ECMAScript 5 it is not allowed to reassign this property but this is not enforced by all ECMAScript/JavaScript engines.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>The type <code>undefined</code> will be inferred to false in a boolean expression.
+It is important to note that something that is not assigned to a value is <code>undefined</code> but not <code>null</code>.</p>
+</div>
+<div class="paragraph">
+<p>The type <code>undefined</code> is a subtype of all types. That is,</p>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow/><mrow><mi>Γ</mi><mo>⊢</mo><mstyle mathvariant="monospace"><mtext>undefined</mtext></mstyle><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>T</mi></mrow></mfrac></math>
+</div>
+</div>
+<div class="paragraph">
+<p>is an axiom and true for all types <em>T</em>.</p>
+</div>
+<div class="paragraph">
+<p>Whenever an expression <em>E</em> has an inferred type of <code>undefined</code>, which means it will always evaluate to
+value <code>undefined</code> at runtime, a warning is shown, unless <em>E</em> is &#8230;&#8203;</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>a <code>void</code> expression</p>
+</li>
+<li>
+<p>the direct child expression of a <code>void</code> expression,</p>
+</li>
+<li>
+<p>the direct child expression of an expression statement,</p>
+</li>
+<li>
+<p>the <code>undefined</code> literal (i.e. the literal representing the <code>undefined</code> value),</p>
+</li>
+<li>
+<p>the <code>this</code> literal.</p>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_null-type"><a class="anchor" href="#_null-type"></a><a class="link" href="#_null-type">4.5.2. Null Type</a></h4>
+<div class="paragraph">
+<p>The <code>null</code> type cannot be declared explicitly by the user. Only the keyword <code>null</code> is inferred to type <code>null</code>.</p>
+</div>
+<h5 id="null-type-semantics" class="discrete">Semantics</h5>
+<div class="paragraph">
+<p>In contrast to <code>undefined</code>, it expresses the intentional absence of a value.</p>
+</div>
+<div class="paragraph">
+<p>The <code>null</code> type can be assigned to any other type.
+That is, the type <code>null</code> is a subtype of all other types except <code>undefined</code>:</p>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><mi>r</mi><mi>i</mi><mi>g</mi><mi>h</mi><mi>t</mi><mo>≠</mo><mstyle mathvariant="monospace"><mtext>undefined</mtext></mstyle></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mstyle mathvariant="monospace"><mtext>null</mtext></mstyle><mi> </mi><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mstyle mathvariant="monospace"><mtext>Type</mtext></mstyle><mi>r</mi><mi>i</mi><mi>g</mi><mi>h</mi><mi>t</mi></mrow></mfrac></math>
+</div>
+</div>
+<div class="paragraph">
+<p>Please note that</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>null==undefined</code> evaluates to <code>true</code></p>
+</li>
+<li>
+<p><code>null===undefined</code> evaluates to <code>false</code></p>
+</li>
+<li>
+<p><code>typeof null</code> evaluates to <code>object</code></p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Only the <code>null</code> keyword is inferred to type null. If <code>null</code> is assigned to a variable, the type of the variable is not changed.
+This is true, in particular, for variable declarations.
+For example in</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">var x = null;</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>the type of variable <code>x</code> is inferred to <code>any</code> (cf. <a href="statements.html#_variable-statement">Variable Statement</a>).</p>
+</div>
+<div class="paragraph">
+<p>The type <code>null</code> will be inferred to false in a boolean expression.</p>
+</div>
+<div class="paragraph">
+<p>The call <code>typeof null</code> will return ’object’.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_primitive-boolean-type"><a class="anchor" href="#_primitive-boolean-type"></a><a class="link" href="#_primitive-boolean-type">4.5.3. Primitive Boolean Type</a></h4>
+<div class="paragraph">
+<p>Represents a logical entity having two values, true and false.</p>
+</div>
+<div class="paragraph">
+<p>Please note that a boolean primitive is coerced to a number in a comparison operation so that</p>
+</div>
+<table class="tableblock frame-all grid-all spread">
+<colgroup>
+<col style="width: 66.6666%;">
+<col style="width: 33.3334%;">
+</colgroup>
+<thead>
+<tr>
+<th class="tableblock halign-center valign-top">Source</th>
+<th class="tableblock halign-center valign-middle">Result</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td class="tableblock halign-left valign-top"><div><div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">var a = true; console.log(a == 1)</code></pre>
+</div>
+</div></div></td>
+<th class="tableblock halign-center valign-middle"><p class="tableblock">prints true</p></th>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><div><div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">var b = false; console.log(b == 0)</code></pre>
+</div>
+</div></div></td>
+<th class="tableblock halign-center valign-middle"><p class="tableblock">prints true</p></th>
+</tr>
+</tbody>
+</table>
+<h5 id="primitive-boolean-type-semantics" class="discrete">Semantics</h5>
+<div class="paragraph">
+<p>The type <code>boolean</code> is subtype of <code>any</code>:</p>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow/><mrow><mstyle mathvariant="monospace"><mtext>boolean</mtext></mstyle><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mstyle mathvariant="monospace"><mtext>any</mtext></mstyle></mrow></mfrac><mrow/></math>
+</div>
+</div>
+<div class="paragraph">
+<p>Variables of type <code>boolean</code> can be auto-converted (coerced) to <code>Boolean</code>, as described in <a href="conversions_and_reflection.html#_autoboxing-and-coercing">Autoboxing and Coercing</a>.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_primitive-string-type"><a class="anchor" href="#_primitive-string-type"></a><a class="link" href="#_primitive-string-type">4.5.4. Primitive String Type</a></h4>
+<div class="paragraph">
+<p>A finite sequence of zero or more 16-bit unsigned integer values (elements).
+Each element is considered to be a single UTF-16 code unit.</p>
+</div>
+<div class="paragraph">
+<p>Also string as primitive type has no properties, you can access the properties available on the object String as string will be coerced to String on the fly
+but just for that property call, the original variable keeps its type:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">var a = "MyString"
+console.log(typeof a) // string
+console.log(a.length) // 8
+console.log(typeof a) // string</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>You can handle a primitive <code>string</code> like an object type <code>String</code> but with these exceptions:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>typeof "MyString"</code> is <code>'string'</code> but <code>typeof new String("MyString")</code> is <code>'object'</code></p>
+</li>
+<li>
+<p><code>"MyString" instanceof String</code> or <code>instanceof Object</code> will return <code>false</code>, for <code>new String("MyString")</code> both checks evaluate to <code>true</code></p>
+</li>
+<li>
+<p><code>console.log(eval("2+2"))</code> returns <code>4</code>, <code>console.log(eval(new String("2+2")))</code> returns string <code>"2+2"</code></p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>This marks a difference to Java.
+In JavaScript, Unicode escape sequences are never interpreted as a special character.</p>
+</div>
+<h5 id="primitive-string-type-semantics" class="discrete">Semantics</h5>
+<div class="paragraph">
+<p>The <code>string</code> type is a subtype of <code>any</code>:</p>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow/><mrow><mstyle mathvariant="monospace"><mtext>string</mtext></mstyle><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mstyle mathvariant="monospace"><mtext>any</mtext></mstyle></mrow></mfrac><mrow/></math>
+</div>
+</div>
+<div class="paragraph">
+<p>It is supertype of the N4JS primitive type <code>pathselector</code>, <code>typeName</code> and <code>i18nKey</code>.
+<a href="#_primitive-pathselector-and-i18nkey">Primitive Pathselector and I18nKey</a></p>
+</div>
+<div class="paragraph">
+<p>However, variables of type <code>string</code> can be auto-converted (coerced) to <code>string</code>, as described in <a href="conversions_and_reflection.html#_autoboxing-and-coercing">Autoboxing and Coercing</a>.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_primitive-number-type"><a class="anchor" href="#_primitive-number-type"></a><a class="link" href="#_primitive-number-type">4.5.5. Primitive Number Type</a></h4>
+<div class="paragraph">
+<p>In ECMAScript numbers are usually 64-bit floating point numbers.
+For details see [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.8.5)</a>].
+The prefix <code>0</code> indicates that the number is octal-based and the prefix <code>0x</code> marks it as hexadecimal-based.</p>
+</div>
+<div class="paragraph">
+<p><code>NaN</code> can be produced by e.g. &#8216;0 / 0&#8217;' or &#8216;1 - x&#8217;. <code>typeof NaN</code> will return <code>number</code>.</p>
+</div>
+<h5 id="primitive-number-type-semantics" class="discrete">Semantics</h5>
+<div class="paragraph">
+<p>The type <code>number</code> is subtype of <code>any</code>:</p>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow/><mrow><mstyle mathvariant="monospace"><mtext>number</mtext></mstyle><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mstyle mathvariant="monospace"><mtext>any</mtext></mstyle></mrow></mfrac><mrow/></math>
+</div>
+</div>
+<div class="paragraph">
+<p>However, variables of type <code>number</code> can be auto-converted (coerced) to <code>Number</code>, as described in <a href="expressions.html#_integer-literals">Integer Literals</a> .</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_primitive-type-int"><a class="anchor" href="#_primitive-type-int"></a><a class="link" href="#_primitive-type-int">4.5.6. Primitive Type int</a></h4>
+<div class="paragraph">
+<p>Actually ECMAScript defines an internal type <code>int32</code>.
+A number of this type is returned by the binary or operation using zero as operand, e.g. ECMAScript’s internal type int32 can be represented in N4JS by a built-in primitive type called <code>int</code>.
+For details on how numeric literals map to types <code>number</code> and <code>int</code>, refer to <a href="expressions.html#_integer-literals">Integer Literals</a>.</p>
+</div>
+<div class="admonitionblock important">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-important" title=""></i>
+</td>
+<td class="content">
+for the time being, built-in type <code>int</code> is synonymous to type <code>number</code>.
+This means one can be assigned to the other and a value declared to be of type <code>int</code> may actually be a 64-bit floating
+point number.<sup class="footnote">[<a id="_footnoteref_14" class="footnote" href="appendix_c_bibliography.html#_footnote_14" title="View footnote.">14</a>]</sup>
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_primitive-symbol-type"><a class="anchor" href="#_primitive-symbol-type"></a><a class="link" href="#_primitive-symbol-type">4.5.7. Primitive Symbol Type</a></h4>
+<div class="paragraph">
+<p>The primitive type <code>symbol</code> is directly as in ECMAScript 6.
+Support for symbols is kept to a minimum in N4JS. While this primitive type can be used without any restrictions, the only value of this type available in N4JS is the built-in symbol <code>Symbol.iterator</code>.
+Other built-in symbols from ECMAScript 6 and the creation of new symbols are not supported.
+For more details, see <a href="#_symbol">Symbol</a>.</p>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="_primitive-n4js-types"><a class="anchor" href="#_primitive-n4js-types"></a><a class="link" href="#_primitive-n4js-types">4.6. Primitive N4JS Types</a></h3>
+<div class="paragraph">
+<p>Additionally to the primitive ECMAScript types, the following N4JS-specific primitive types are supported:</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><code>any</code></dt>
+<dd>
+<p>enables ECMAScript-like untyped variable declarations</p>
+</dd>
+<dt class="hdlist1"><code>void</code></dt>
+<dd>
+<p>almost similar to undefined, except it can be used as a return type of functions and methods</p>
+</dd>
+<dt class="hdlist1"><code>unknown</code></dt>
+<dd>
+<p>inferred in case of a type inference error</p>
+</dd>
+<dt class="hdlist1"><code>pathSelector&lt;T&gt;</code>, <code>i18nKey</code></dt>
+<dd>
+<p>subtypes of string</p>
+</dd>
+</dl>
+</div>
+<div class="sect3">
+<h4 id="_any-type"><a class="anchor" href="#_any-type"></a><a class="link" href="#_any-type">4.6.1. Any Type</a></h4>
+<div class="paragraph">
+<p>Any type is the default type of all variables for without a type declaration.
+It has no properties.
+A value of any other type can be assigned to a variable of type <code>any</code>, but a variable declared <code>any</code> can only be assigned to another variable declared with the type <code>any</code>.</p>
+</div>
+<div class="sect4">
+<h5 id="any-type-semantics"><a class="anchor" href="#any-type-semantics"></a><a class="link" href="#any-type-semantics">4.6.1.1. Semantics</a></h5>
+<div class="paragraph">
+<p><code>any</code> is supertype of all other types. That is,</p>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow/><mrow><mi>Γ</mi><mo>⊢</mo><mstyle mathvariant="monospace"><mtext>Type</mtext></mstyle><mi>l</mi><mi>e</mi><mi>f</mi><mi>t</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mrow><mi>a</mi><mi>n</mi><mi>y</mi></mrow></mrow></mfrac></math>
+</div>
+</div>
+<div class="paragraph">
+<p>is an axiom and true for all types.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="any-type-type-inference"><a class="anchor" href="#any-type-type-inference"></a><a class="link" href="#any-type-type-inference">4.6.1.2. Type Inference</a></h5>
+<div class="paragraph">
+<p>If a variable is explicitly declared as type <code>any</code>, the inferred type of that variable will always be <code>any</code>.</p>
+</div>
+<div class="sect5">
+<h6 id="_default-type-of-variables"><a class="anchor" href="#_default-type-of-variables"></a><a class="link" href="#_default-type-of-variables">4.6.1.2.1. Default Type of Variables</a></h6>
+<div class="paragraph">
+<p>If a type annotation is missing and no initializer is provided, then the type of a variable is implicitly set to <code>any</code>.</p>
+</div>
+<div class="paragraph">
+<p>In that case, the inferred type of that variable will always be <code>any</code> as well.
+If an initializer is provided, the declared type of the variable will be set to the inferred type of the initializer.
+Therefore in the latter case, the inferred type of the variable will always be the type of the initializer (cf. <a href="statements.html#_variable-statement">Variable Statement</a>).</p>
+</div>
+<div class="paragraph">
+<p>If a variable is declared as type , it can be used just as every variable can be used in raw ECMAScript.
+Since every property can be get and set, the types of properties is inferred as as well.
+This is formally expressed in <a href="expressions.html#_identifier">Identifier</a>.</p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_void-type"><a class="anchor" href="#_void-type"></a><a class="link" href="#_void-type">4.6.2. Void Type</a></h4>
+<div class="paragraph">
+<p>The type <code>void</code> is used to denote that there is no value at all, as opposed to type
+<code>undefined</code> which denotes that there is a value, but it is always undefined.</p>
+</div>
+<div class="paragraph">
+<p>The only valid use of type <code>void</code> is to declare that a function or method does not
+return anything. In particular, this means:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>void</code> is disallowed as type argument,</p>
+</li>
+<li>
+<p><code>void</code> is disallowed as upper/lower bound of type parameters and wild cards,</p>
+</li>
+<li>
+<p>when used as return type of functions or methods, <code>void</code> may not be nested, i.e.</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">function foo(): void {}  // ok
+function bar(): any|void {}  // error</code></pre>
+</div>
+</div>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>In all the above disallowed cases, type <code>undefined</code> should be used instead of <code>void</code>.</p>
+</div>
+<div class="sect4">
+<h5 id="void-type-semantics"><a class="anchor" href="#void-type-semantics"></a><a class="link" href="#void-type-semantics">4.6.2.1. Semantics</a></h5>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-13"></a><strong>Req. IDE-13:</strong> <a href="#Req-IDE-13">Void Type</a> (ver. 1)</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>The type <code>void</code> may only be used as the immediate return type of a function or method.</p>
+</li>
+<li>
+<p>If a function <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>f</mi></math> is declared to return <code>void</code>, an error is created if a return statement contains an expression:</p>
+<div class="paragraph">
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>f</mi><mo>.</mo><mi>r</mi><mi>e</mi><mi>t</mi><mi>u</mi><mi>r</mi><mi>n</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>void</mtext></mstyle><mo>→</mo></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∀</mo><mi>r</mi><mo>,</mo><mi>μ</mi><mfenced close=")" open="("><mi>r</mi></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>ReturnStatement</mtext></mstyle><mo>,</mo><mi>r</mi><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>t</mi><mi>a</mi><mi>i</mi><mi>n</mi><mi>i</mi><mi>n</mi><mi>g</mi><mi>F</mi><mi>u</mi><mi>n</mi><mi>c</mi><mi>t</mi><mi>i</mi><mi>o</mi><mi>n</mi><mo>=</mo><mi>f</mi><mi>:</mi><mi>r</mi><mo>.</mo><mi>e</mi><mi>x</mi><mi>p</mi><mi>r</mi><mi>e</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>o</mi><mi>n</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>null</mtext></mstyle></math></p>
+</div>
+</li>
+<li>
+<p>If a function <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>f</mi></math> is declared to return <code>void</code>, an error is issued if the function is called in any statement or expression but an expression statement directly:</p>
+<div class="paragraph">
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>f</mi><mo>.</mo><mi>r</mi><mi>e</mi><mi>t</mi><mi>u</mi><mi>r</mi><mi>n</mi><mi>T</mi><mi>y</mi><mi>p</mi><mi>e</mi><mo>=</mo><mstyle mathvariant="monospace"><mtext>void</mtext></mstyle><mo>→</mo></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∀</mo><mi>e</mi><mo>,</mo><mi>b</mi><mi>i</mi><mi>n</mi><mi>d</mi><mfenced close=")" open="("><mi>e</mi><mi>f</mi></mfenced><mi>:</mi><mi>μ</mi><mfenced close=")" open="("><mrow><mi>e</mi><mo>.</mo><mi>c</mi><mi>o</mi><mi>n</mi><mi>t</mi><mi>a</mi><mi>i</mi><mi>n</mi><mi>e</mi><mi>r</mi></mrow></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>ExpressionStatement</mtext></mstyle></math></p>
+</div>
+</li>
+</ul>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>The following type hierarchy is defined: <code>void</code> is only a subtype of itself but not of any other type and no other type is a subtype of void.</p>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow/><mrow><mstyle mathvariant="monospace"><mtext>void</mtext></mstyle><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mstyle mathvariant="monospace"><mtext>void</mtext></mstyle></mrow></mfrac></math>
+</div>
+</div>
+<div class="paragraph">
+<p>Since <code>void</code> cannot be used as the type of variables, fields, formal parameters, etc., a
+function or method with a return type of void cannot be used on the right-hand side of
+an assignment or in the argument list of a call expression (note the difference to plain
+JavaScript).</p>
+</div>
+<div class="paragraph">
+<p>The ECMAScript <code>void</code> operator (see <a href="expressions.html#_unary-expression">Unary Expressions</a>) has a type
+of <code>undefined</code>, not <code>void</code>, because it evaluates to value <code>undefined</code> and can be used
+on the right-hand side of assignments, etc.</p>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_unknown-type"><a class="anchor" href="#_unknown-type"></a><a class="link" href="#_unknown-type">4.6.3. Unknown Type</a></h4>
+<div class="paragraph">
+<p>Internally N4JS defines the type <code>unknown</code>.
+This type cannot be used by the user.
+Instead, it is inferred in case of errors.
+<code>unknown</code> behaves almost similar to <code>any+</code>.
+However no error messages once a variable or expression has been inferred to <code>unknown</code> in order to avoid consequential errors.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_primitive-pathselector-and-i18nkey"><a class="anchor" href="#_primitive-pathselector-and-i18nkey"></a><a class="link" href="#_primitive-pathselector-and-i18nkey">4.6.4. Primitive Pathselector and I18nKey</a></h4>
+<div class="paragraph">
+<p>N4JS introduces three new types which are subtypes of string.
+These types are, in fact, translated to strings and do not add any new functionality.
+They are solely defined for enabling additional validation.</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>pathSelector&lt;T&gt;</code> is a generic type for specifying path selector expressions. PathSelectors are used to specify a path to a property in a (JSON-like) model tree.</p>
+</li>
+<li>
+<p>The type variable <code>T</code> defines the context type (or type of the root of the tree) in which the selector is to be validated.
+A path selector is defined as a string literal that has to conform to the path selector grammar.
+The context type is then used to perform a semantic</p>
+</li>
+<li>
+<p><code>i18nKey</code> is a string which refers to an internationalization key.
+The <code>i18nKey</code> type is used to reference resource keys specified in resource files.
+In a project <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>p</mi></math>, the <code>i18nKey</code> type defines the transitive set of all resource keys accessible from <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>p</mi></math>.
+Since resource keys are specified as strings, this means that the <code>i18nKey</code> type defines a subset of all string literals that can be assigned to a variable of type <code>i18nKey</code> in the current project.
+That means that an assignment of a string literal to a variable of type <code>i18nKey</code> is only valid if that string literal is contained in the set defined by <code>i18nKey</code>.
+Resource keys are declared in the properties files of a project and all resource keys from a project are accessible to any project depending on it.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph todo">
+<p>I18nkeys are not yet validated</p>
+</div>
+<div class="sect4">
+<h5 id="pathselector-semantics"><a class="anchor" href="#pathselector-semantics"></a><a class="link" href="#pathselector-semantics">4.6.4.1. Semantics</a></h5>
+<div class="paragraph">
+<p>The N4JS primitive types <code>pathSelector&lt;T&gt;</code>, <code>i18nKey</code> and <code>pathSelector&lt;T&gt;</code> are basically only marker types of strings for enabling additional validation.
+Thus, they are completely interchangeable with string types:</p>
+</div>
+<div class="paragraph">
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mfrac><mrow/><mrow><mstyle mathvariant="monospace"><mtext>typeName</mtext></mstyle><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>T</mtext></mstyle><mo>&gt;</mo><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mstyle mathvariant="monospace"><mtext>string</mtext></mstyle></mrow></mfrac><mspace width="3.0mm"/><mfrac><mrow/><mrow><mstyle mathvariant="monospace"><mtext>string</mtext></mstyle><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mstyle mathvariant="monospace"><mtext>typeName</mtext></mstyle><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>T</mtext></mstyle><mo>&gt;</mo></mrow></mfrac></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mfrac><mrow/><mrow><mstyle mathvariant="monospace"><mtext>i18nKey</mtext></mstyle><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mstyle mathvariant="monospace"><mtext>string</mtext></mstyle></mrow></mfrac><mspace width="3.0mm"/><mfrac><mrow/><mrow><mstyle mathvariant="monospace"><mtext>string</mtext></mstyle><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mstyle mathvariant="monospace"><mtext>i18nKey</mtext></mstyle></mrow></mfrac></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mfrac><mrow/><mrow><mstyle mathvariant="monospace"><mtext>pathSelector</mtext></mstyle><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>T</mtext></mstyle><mo>&gt;</mo><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mstyle mathvariant="monospace"><mtext>string</mtext></mstyle></mrow></mfrac><mspace width="3.0mm"/><mfrac><mrow/><mrow><mstyle mathvariant="monospace"><mtext>string</mtext></mstyle><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mstyle mathvariant="monospace"><mtext>pathSelector</mtext></mstyle><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>T</mtext></mstyle><mo>&gt;</mo></mrow></mfrac></math></p>
+</div>
+<div class="paragraph">
+<p>As special literals for these N4JS types do not exist, the type has to be explicitly specified in order to enable the additional validation.
+Note that this validation cannot be applied for more complicated expressions with parts which cannot be evaluated at compile time.
+For example, <code>"some.path."segment".prop"</code> cannot be evaluated at compile time.</p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="_built-in-ecmascript-object-types"><a class="anchor" href="#_built-in-ecmascript-object-types"></a><a class="link" href="#_built-in-ecmascript-object-types">4.7. Built-in ECMAScript Object Types</a></h3>
+<div class="paragraph">
+<p>N4JS supports all built-in ECMAScript objects [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.S15)</a>], interpreted as classes.
+Some of these object types are object versions of primitive types.
+The object types have the same name as their corresponding primitive type, but start with an upper case letter.</p>
+</div>
+<div class="paragraph">
+<p>The following types, derived from certain ECMAScript predefined objects and constructs, are supported by means of built-in types as they are required by certain expressions.</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>Object</code>   [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.p.111)</a>];</p>
+</li>
+<li>
+<p><code>Function</code>  [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.p.117)</a>]; representing functions and function objects <a href="functions.html#_function-type">Function Type</a> but also methods (<a href="classifiers.html#_methods">Methods</a>)</p>
+</li>
+<li>
+<p><code>Array</code>    [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.p.122)</a>], representing array objects, see <a href="#_array-object-type">Array Object Type</a></p>
+</li>
+<li>
+<p><code>String</code> [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.p.141)</a>]</p>
+</li>
+<li>
+<p><code>Boolean</code> [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.p.141)</a>]</p>
+</li>
+<li>
+<p><code>Number</code> [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.p.141)</a>]</p>
+</li>
+<li>
+<p><code>RegExp</code> [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.p.180)</a>]; they can be constructed by means of special literals (cf. <a href="expressions.html#_literals">Literals</a>)</p>
+</li>
+<li>
+<p>global object type</p>
+</li>
+<li>
+<p><code>Symbol</code></p>
+</li>
+<li>
+<p><code>Promise</code></p>
+</li>
+<li>
+<p><code>Iterator</code> and <code>Iterable</code></p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>All other ECMAScript types ([<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.S15)</a>], such as <code>Math</code>, <code>Date</code>, or <code>Error</code> are supported by means of predefined classes.
+ECMAScript 2015 types are defined in the ECMAScript 2015 runtime environment.
+Since they are defined and used similar to user defined classes, they are not explained in further detail here.
+These predefined objects are kind of subtypes of <code>Object</code>.</p>
+</div>
+<div class="sect3">
+<h4 id="ECMAScript-objects-semantics"><a class="anchor" href="#ECMAScript-objects-semantics"></a><a class="link" href="#ECMAScript-objects-semantics">4.7.1. Semantics</a></h4>
+<div class="paragraph">
+<p>It is not possible to inherit from any of the built-in ECMAScript object types except for <code>Object</code> and <code>Error</code>, that is,
+to use one of these types as supertype of a class.
+From the N4JS language’s point of view, these built-in types are all final.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_object-type"><a class="anchor" href="#_object-type"></a><a class="link" href="#_object-type">4.7.2. Object Type</a></h4>
+<div class="paragraph">
+<p><code>Object</code> [<a href="appendix_c_bibliography.html#ECMA11a">ECMA11a(p.S8.6)</a>] is the (implicit) supertype of all declared (i.e., non-primtive) types, including native types.
+It models the ECMAScript type <code>Object</code>, except that no properties may be dynamically added to it.
+In order to declare a variable to which properties can be dynamically added, the type <code>Object+</code> has to be declared
+(cf. <a href="#_type-modifiers">Type Modifiers</a>).</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_function-object-type"><a class="anchor" href="#_function-object-type"></a><a class="link" href="#_function-object-type">4.7.3. Function-Object-Type</a></h4>
+<div class="paragraph">
+<p>The built-in object type <code>Function</code>, a subtype of <code>Object</code>, represents all functions, regardless of how they are defined (either via function expression,
+function declaration, or method declaration).
+They are described in detail in <a href="#_function-object-type">Function-Object-Type</a>.</p>
+</div>
+<div class="paragraph">
+<p>Since <code>Function</code> is the supertype of all functions regardless of number and types of formal parameters, return type, and number and bounds of type parameters,
+it would not normally be possible to invoke an instance of <code>Function</code>.
+For the time being, however, an instance of <code>Function</code> can be invoked, any number of arguments may be provided and the invocation may be parameterized with any number of
+type arguments (which will be ignored), i.e.  <a href="expressions.html#Req-IDE-101">[Req-IDE-101]</a> and <a href="expressions.html#Req-IDE-102">[Req-IDE-102]</a> do not apply.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_array-object-type"><a class="anchor" href="#_array-object-type"></a><a class="link" href="#_array-object-type">4.7.4. Array Object Type</a></h4>
+<div class="paragraph">
+<p>The <code>Array</code> type is generic with one type parameter, which is the item type. An array is accessed with the index operator, the type of the index parameter is <code>Number</code>.
+The type of the stored values is <em>typeArgs[0]</em> (cf. <a href="expressions.html#_array-literal">Array Literal</a>). Due to type erasure, the item type is not available during runtime,
+that is to say there are no reflective methods returning the item type of an array.</p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-14"></a><strong>Req. IDE-14:</strong> <a href="#Req-IDE-14">Array Type</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>For an array type <em>A</em>, the following conditions must be true:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mo>|</mo><mi>A</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>A</mi><mi>r</mi><mi>g</mi><mi>s</mi><mo>|</mo><mo>=</mo><mn>1</mn></math></p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_string-object-type"><a class="anchor" href="#_string-object-type"></a><a class="link" href="#_string-object-type">4.7.5. String Object Type</a></h4>
+<div class="paragraph">
+<p>Object type version of <code>string</code>. It is highly recommend to use the primitive version only.
+Note that is is not possible to assign a primitive typed value to an object typed variable.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_boolean-object-type"><a class="anchor" href="#_boolean-object-type"></a><a class="link" href="#_boolean-object-type">4.7.6. Boolean Object Type</a></h4>
+<div class="paragraph">
+<p>Object type version of <code>boolean</code>. It is highly recommend to use the primitive version only.
+Note that is is not possible to assign a primitive typed value to an object typed variable.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_number-object-type"><a class="anchor" href="#_number-object-type"></a><a class="link" href="#_number-object-type">4.7.7. Number Object Type</a></h4>
+<div class="paragraph">
+<p>Object type version of <code>number</code>. It is highly recommend to use the primitive version only.
+Note that is is not possible to assign a primitive typed value to an object typed variable.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_global-object-type"><a class="anchor" href="#_global-object-type"></a><a class="link" href="#_global-object-type">4.7.8. Global Object Type</a></h4>
+<div class="paragraph">
+<p>This is the globally accessible namespace which contains element such as undefined, and in case of browsers, window. Depending on the runtime environment,
+the global object may has different properties defined by means of dynamic polyfills.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_symbol"><a class="anchor" href="#_symbol"></a><a class="link" href="#_symbol">4.7.9. Symbol</a></h4>
+<div class="paragraph">
+<p>The symbol constructor function of ECMAScript 2015. Support for symbols
+is kept to a minimum in N4JS:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>creating symbols with <code>var sym = Symbol("description")</code> is not supported.</p>
+</li>
+<li>
+<p>creating shared symbols with <code>var sym = Symbol.for("key")</code> is not supported.
+Also the inverse <code>Symbol.keyFor(sym)</code> is not supported.</p>
+</li>
+<li>
+<p>retrieving built-in symbols via properties in <code>Symbol</code> is supported, however, the only built-in symbol available in N4JS is the iterator symbol that can be retrieved with <code>Symbol.iterator</code>.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>The rationale for this selective support for symbols in N4JS is to allow for the use (and custom definition) of iterators and iterables and their application in the <code>for&#8230;&#8203;of</code>
+loop with as little support for symbols as possible.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_promise"><a class="anchor" href="#_promise"></a><a class="link" href="#_promise">4.7.10. Promise</a></h4>
+<div class="paragraph">
+<p><code>Promise</code> is provided as a built-in type as in ECMAScript 2015.
+Also see <a href="functions.html#_asynchronous-functions">Asynchronous Functions</a> for asynchronous functions.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_iterator-interface"><a class="anchor" href="#_iterator-interface"></a><a class="link" href="#_iterator-interface">4.7.11. Iterator Interface</a></h4>
+<div class="paragraph">
+<p>A structurally typed interface for <em>iterators</em> as defined by theECMAScript 6 iterator protocol.</p>
+</div>
+<div class="listingblock">
+<div class="title">Iterable in N4JS</div>
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">// providedByRuntime
+export public interface ~Iterator&lt;T&gt;  {
+    public next(): IteratorEntry&lt;T&gt;
+}
+
+// providedByRuntime
+export public interface ~IteratorEntry&lt;T&gt; {
+    public done: boolean;
+    public value: T?;
+}</code></pre>
+</div>
+</div>
+<div class="paragraph todo">
+<p>Interface <code>IteratorEntry</code> was introduced mainly as a workaround; this interface could be removed and replaced with a corresponding
+structural type reference as return type of method <code>next()</code></p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_iterable-interface"><a class="anchor" href="#_iterable-interface"></a><a class="link" href="#_iterable-interface">4.7.12. Iterable Interface</a></h4>
+<div class="paragraph">
+<p>A structurally typed interface for objects that can be iterated over, i.e. <em>iterables</em> as defined by the ECMAScript 6 iterator protocol.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">// providedByRuntime
+export public interface ~Iterable&lt;T&gt; {
+    public [Symbol.iterator](): Iterator&lt;T&gt;
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Note that this interface’s method is special in that a symbol is used as identifier.
+You can use the ordinary syntax for computed property names in ECMAScript 6 for overriding / implementing or invoking this method.</p>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="_built-in-n4js-types"><a class="anchor" href="#_built-in-n4js-types"></a><a class="link" href="#_built-in-n4js-types">4.8. Built-In N4JS Types</a></h3>
+<div class="paragraph">
+<p>N4JS additionally provides some built-in classes which are always available with the need to explicitly import them.</p>
+</div>
+<div class="sect3">
+<h4 id="_n4object"><a class="anchor" href="#_n4object"></a><a class="link" href="#_n4object">4.8.1. N4Object</a></h4>
+<div class="paragraph">
+<p>Although <code>N4Object</code> is a built-in type, it is not the default supertype.
+It is a subtype of <code>Object</code>.</p>
+</div>
+<div class="sect4">
+<h5 id="N4Object-semantics"><a class="anchor" href="#N4Object-semantics"></a><a class="link" href="#N4Object-semantics">4.8.1.1. Semantics</a></h5>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow/><mrow><mstyle mathvariant="monospace"><mtext>N4Object</mtext></mstyle><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mstyle mathvariant="monospace"><mtext>Object</mtext></mstyle></mrow></mfrac></math>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_n4class"><a class="anchor" href="#_n4class"></a><a class="link" href="#_n4class">4.8.2. N4Class</a></h4>
+<div class="paragraph">
+<p>The type <code>N4Class</code> is used for extended reflection in N4JS.</p>
+</div>
+<div class="paragraph todo">
+<p>Add further docs for this type</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="IterableN"><a class="anchor" href="#IterableN"></a><a class="link" href="#IterableN">4.8.3. IterableN</a></h4>
+<div class="paragraph todo">
+<p>Work in progress.</p>
+</div>
+<div class="paragraph">
+<p>Currently there are built-in types <code>Iterable2&lt;T1,T2&gt;</code>&#8230;&#8203;<code>Iterable9&lt;T1,&#8230;&#8203;,T9&gt;</code>.
+They are mainly intended for type system support of array destructuring literals.</p>
+</div>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title=""></i>
+</td>
+<td class="content">
+This is not documented in detail yet, because we want to gain experience with the current solution first, major refinement may be incoming.
+</td>
+</tr>
+</table>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="_type-modifiers"><a class="anchor" href="#_type-modifiers"></a><a class="link" href="#_type-modifiers">4.9. Type Modifiers</a></h3>
+<div class="paragraph">
+<p>Type expressions can be further described with type modifiers.
+The type modifiers add additional constraints to the type expression which are then used to perform a stricter validation of the source code.
+Type modifiers can not be used in type arguments.</p>
+</div>
+<div class="paragraph">
+<p>The general type modifiers <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>n</mi><mi>u</mi><mi>l</mi><mi>l</mi><mi>a</mi><mi>b</mi><mi>l</mi><mi>e</mi></math>, <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>n</mi><mi>o</mi><mi>n</mi><mi>n</mi><mi>u</mi><mi>l</mi><mi>l</mi></math> and <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>d</mi><mi>y</mi><mi>n</mi><mi>a</mi><mi>m</mi><mi>i</mi><mi>c</mi></math> can be used for variables, attributes, method parameters and method types.
+Optional and variadic modifiers can only be applied for formal parameters.</p>
+</div>
+<div class="sect3">
+<h4 id="Type_Modifiers_Dynamic"><a class="anchor" href="#Type_Modifiers_Dynamic"></a><a class="link" href="#Type_Modifiers_Dynamic">4.9.1. Dynamic</a></h4>
+<div class="paragraph">
+<p>The dynamic type modifier marks a type as being dynamic.
+A dynamic type behaves like a normal JavaScript object, so you can read/write any property and call any method on it.
+The default behavior for a type is to be static, that is no new properties can be added and no unknown properties can be accessed.</p>
+</div>
+<div class="paragraph">
+<p><code>T</code> <math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/></math> <code>T+</code> and <code>T+</code> <math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/></math> <code>T</code> is always true.
+Using dynamically added members of a dynamic type is never type safe.
+Using the <code>delete</code> operator on a subtype of <code>N4Object</code> is not allowed.</p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-15"></a><strong>Req. IDE-15:</strong> <a href="#Req-IDE-15">Non-Dynamic Primitive Types</a> (ver. 1)</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>All primitive types except <code>any</code> must not be declared dynamic.</p>
+</li>
+<li>
+<p>Only parameterized type references and this type reference can be declared dynamic.<sup class="footnote">[<a id="_footnoteref_15" class="footnote" href="appendix_c_bibliography.html#_footnote_15" title="View footnote.">15</a>]</sup></p>
+</li>
+</ol>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_optional-return-types"><a class="anchor" href="#_optional-return-types"></a><a class="link" href="#_optional-return-types">4.9.2. Optional Return Types</a></h4>
+<div class="paragraph">
+<p>Only formal parameters and return types can be marked as optional.</p>
+</div>
+<div class="paragraph">
+<p>An optional return type indicates that the function / method need not be left via a return statement with an expression; in that case the return value is <code>undefined</code>.
+For constraints on using the optional modifier, see <a href="#_function-object-type">Function-Object-Type</a>.</p>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="_union-and-intersection-type-composed-types"><a class="anchor" href="#_union-and-intersection-type-composed-types"></a><a class="link" href="#_union-and-intersection-type-composed-types">4.10. Union and Intersection Type (Composed Types)</a></h3>
+<div class="paragraph">
+<p>Given two or more existing types, it is possible to compose a new type by forming either the union or intersection of the base types.
+The following example gives a small overview of common use cases of union and intersection types.</p>
+</div>
+<div class="exampleblock">
+<div class="title">Example 17. Composed types</div>
+<div class="content">
+<div class="paragraph">
+<p>This example shows how union and intersection types affect the types of their field members in case the fields have different types.
+It is for illustration purposes only.
+The type of the composed field depends on the access type:
+When reading, the field type of an intersection/union also resolves to the intersection/union.
+In contrast, when writing a field, the field type of an intersection/union resolves to the union/intersection respectively.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">interface A { f : int = 1; }
+interface B { f : string = "h"; }
+
+class CA implements A {}
+class CB implements B {}
+
+let aub : A|B; // union type
+let aib : A&amp;B; // intersection type
+
+function u() {
+    aub = (catIsAlive)? new CA() : new CB(); // catIsAlive is boolean
+    let x = aub.f; // x = {1 | "h"}
+    aub.f = undefined; // undefined can be assigned to int and string types
+}
+function i() {
+    let a = aib as A;
+    let b = aib as B;
+    a.f = 23;
+    b.f = "text";
+    let x = aib.f; // x = {23 &amp; "text"} which is impossible
+}
+// type of 'aub.f' --&gt; int|string
+let fu = aub.f;
+// type of 'aub.f' --&gt; int&amp;string
+aub.f = undefined;
+// type of 'aib.f' --&gt; int&amp;string
+let fi = aib.f;
+// type of 'aib.f' --&gt; int|string
+aib.f = undefined;</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Note that no instance <code>aib</code> of intersection type <code>A&amp;B</code> can be instantiated, since the instance&#8217;s class would have to define a field <code>f</code> which would have to comply to both of the interfaces <code>A</code> and <code>B</code>.
+Still the function <code>i()</code> shows in general how variables of intersection types can be casted and accessed.</p>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>The following sections define these <em>union</em> and <em>intersection types</em> in detail.</p>
+</div>
+<div class="sect3">
+<h4 id="_union-type"><a class="anchor" href="#_union-type"></a><a class="link" href="#_union-type">4.10.1. Union Type</a></h4>
+<div class="paragraph">
+<p>Union type reflect the dynamic nature of JavaScript. Union types can be used almost everywhere (e.g., in variable declarations or in formal method parameters).
+The type inferencer usually avoids returning union types and prefers single typed joins or meets.
+<em>The most common use case for union types is for emulating method overloading</em>, as
+we describe later on.<sup class="footnote">[<a id="_footnoteref_16" class="footnote" href="appendix_c_bibliography.html#_footnote_16" title="View footnote.">16</a>]</sup></p>
+</div>
+<div class="sect4">
+<h5 id="union-type-syntax"><a class="anchor" href="#union-type-syntax"></a><a class="link" href="#union-type-syntax">4.10.1.1. Syntax</a></h5>
+<div class="paragraph">
+<p>For convenience, we repeat the definition of union type expression:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">UnionTypeExpression: 'union' '{' typeRefs+=TypeRefWithoutModifiers (',' typeRefs+=TypeRefWithoutModifiers)* '}';</code></pre>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="union-type-semantics"><a class="anchor" href="#union-type-semantics"></a><a class="link" href="#union-type-semantics">4.10.1.2. Semantics</a></h5>
+<div class="paragraph">
+<p>An union type states that the type of a variable may be one or more types contained in the union type.
+In other words, a union type is a kind of type set, and the type of a variable is contained in the type set.
+Due to interfaces, a variable may conform to multiple types.</p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-18"></a><strong>Req. IDE-18:</strong> <a href="#Req-IDE-18">Union Type</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>For a given union type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>U</mi><mo>=</mo><mi>u</mi><mi>n</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><msub><mi>T</mi><mn>1</mn></msub><mrow><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/></mrow><msub><mi>T</mi><mi>n</mi></msub></mfenced></math>, the following conditions must hold:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Non-empty: At least one element has to be specified:<br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>U</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mi>s</mi><mo>≠</mo><mi>∅</mi></math> (<math xmlns="http://www.w3.org/1998/Math/MathML"><mrow><mi>n</mi><mo>≥</mo><mn>1</mn><mo>)</mo></mrow></math></p>
+</li>
+<li>
+<p>Non-dynamic: The union type itself must not be declared dynamic:<br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mo>¬</mo><mi>U</mi><mo>.</mo><mi>d</mi><mi>y</mi><mi>n</mi><mi>a</mi><mi>m</mi><mi>i</mi><mi>c</mi></math></p>
+</li>
+<li>
+<p>Non-optional elements:<br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∀</mo><mi>T</mi><mo>∈</mo><mi>U</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mi>s</mi><mo>→</mo><mo>¬</mo><mi>T</mi><mo>.</mo><mi>o</mi><mi>p</mi><mi>t</mi></math></p>
+</li>
+</ol>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-19"></a><strong>Req. IDE-19:</strong> <a href="#Req-IDE-19">Union Type Subtyping Rules</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>Let <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>U</mi></math> be an union type.</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>The union type is a common supertype of all its element types:</p>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><mi>T</mi><mo>∈</mo><mi>U</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mi>s</mi></mrow><mrow><mi>T</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>U</mi></mrow></mfrac></math>
+</div>
+</div>
+</li>
+<li>
+<p>More generally, a type is a subtype of a union type, if it is a
+subtype of at least one type contained in the union:</p>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><mo>∃</mo><mi>T</mi><mo>∈</mo><mi>U</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mi>s</mi><mi>:</mi><mi>S</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>T</mi></mrow><mrow><mi>S</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>U</mi></mrow></mfrac></math>
+</div>
+</div>
+</li>
+<li>
+<p>A union type is a subtype of a type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>S</mi></math>, if all types of the union are subtypes of that type.
+This rule is a generalization of the sub typing rules given in [<a href="appendix_c_bibliography.html#Igarashi07a">Igarashi07a(p.p.40)</a>]</p>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><mo>∀</mo><mi>T</mi><mo>∈</mo><mi>U</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mi>s</mi><mi>:</mi><mi>T</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>S</mi></mrow><mrow><mi>U</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>S</mi></mrow></mfrac></math>
+</div>
+</div>
+</li>
+<li>
+<p>Commutativity: The order of element does not matter:</p>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mi>u</mi><mi>n</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><mi>A</mi><mo>,</mo><mi>B</mi></mrow></mfenced><mo>=</mo><mi>u</mi><mi>n</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><mi>B</mi><mo>,</mo><mi>A</mi></mrow></mfenced></math>
+</div>
+</div>
+</li>
+<li>
+<p>Associativity:
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>u</mi><mi>n</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><mi>A</mi><mo>,</mo><mi>u</mi><mi>n</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><mi>B</mi><mo>,</mo><mi>C</mi></mrow></mfenced></mrow></mfenced><mo>=</mo><mi>u</mi><mi>n</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><mi>u</mi><mi>n</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><mi>A</mi><mo>,</mo><mi>B</mi></mrow></mfenced><mo>,</mo><mi>C</mi></mrow></mfenced></math></p>
+</li>
+<li>
+<p>Uniqueness of elements: A union type may not contain duplicates
+(similar to sets):</p>
+<div class="paragraph">
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∀</mo><mn>1</mn><mo>≤</mo><mi>i</mi><mo>&lt;</mo><mi>k</mi><mo>≤</mo><mi>n</mi><mo>,</mo><mi>u</mi><mi>n</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><msub><mi>T</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>T</mi><mi>n</mi></msub></mrow></mfenced><mi>:</mi><msub><mi>T</mi><mi>i</mi></msub><mo>≠</mo><msub><mi>T</mi><mi>k</mi></msub></math></p>
+</div>
+</li>
+</ul>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-20"></a><strong>Req. IDE-20:</strong> <a href="#Req-IDE-20">Implicit simplification of union types</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>Let <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>U</mi></math> be an union type.
+The following simplification rules are always automatically applied to union types.</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Simplification of union type with one element:
+If a union type contains only one element, it is reduced to the element:</p>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><mi>u</mi><mi>n</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mi>T</mi></mfenced></mrow><mi>T</mi></mfrac></math>
+</div>
+</div>
+</li>
+<li>
+<p>Simplification of union types of union types:
+A union type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>U</mi></math> containing another union type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>V</mi></math> is reduced to a single union type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>W</mi></math>, with
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>W</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mi>s</mi><mo>=</mo><mi>U</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mi>s</mi><mo>∪</mo><mi>V</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mi>s</mi></math>:</p>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><mi>u</mi><mi>n</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><msub><mi>S</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>S</mi><mrow><mi>k</mi><mo>-</mo><mn>1</mn></mrow></msub><mo>,</mo><mi>u</mi><mi>n</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><msub><mi>T</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>T</mi><mi>m</mi></msub></mrow></mfenced><mo>,</mo><msub><mi>S</mi><mrow><mi>k</mi><mo>+</mo><mn>1</mn></mrow></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>S</mi><mi>n</mi></msub></mrow></mfenced></mrow><mrow><mi>u</mi><mi>n</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><msub><mi>S</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>S</mi><mrow><mi>k</mi><mo>-</mo><mn>1</mn></mrow></msub><mo>,</mo><msub><mi>T</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>T</mi><mi>m</mi></msub><mo>,</mo><msub><mi>S</mi><mrow><mi>k</mi><mo>+</mo><mn>1</mn></mrow></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>S</mi><mi>n</mi></msub></mrow></mfenced></mrow></mfrac></math>
+</div>
+</div>
+</li>
+<li>
+<p>Simplification of union type with undefined or null:
+Since undefined is the bottom type, and null is kind of a second button type, they are removed from the union:</p>
+<div class="paragraph">
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mfrac><mrow><mi>u</mi><mi>n</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><msub><mi>T</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>T</mi><mrow><mi>k</mi><mo>-</mo><mn>1</mn></mrow></msub><mo>,</mo><msub><mi>T</mi><mi>k</mi></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>T</mi><mi>n</mi></msub></mrow></mfenced></mrow><mrow><mi>u</mi><mi>n</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><msub><mi>T</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>T</mi><mrow><mi>k</mi><mo>-</mo><mn>1</mn></mrow></msub><mo>,</mo><mi>u</mi><mi>n</mi><mi>d</mi><mi>e</mi><mi>f</mi><mi>i</mi><mi>n</mi><mi>e</mi><mi>d</mi></mrow></mfenced><mo>,</mo><msub><mi>T</mi><mi>k</mi></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>T</mi><mi>n</mi></msub></mrow></mfrac></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mfrac><mrow><mi>u</mi><mi>n</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><msub><mi>T</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>T</mi><mrow><mi>k</mi><mo>-</mo><mn>1</mn></mrow></msub><mo>,</mo><msub><mi>T</mi><mi>k</mi></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>T</mi><mi>n</mi></msub></mrow></mfenced></mrow><mrow><mi>u</mi><mi>n</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><msub><mi>T</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>T</mi><mrow><mi>k</mi><mo>-</mo><mn>1</mn></mrow></msub><mo>,</mo><mi>n</mi><mi>u</mi><mi>l</mi><mi>l</mi></mrow></mfenced><mo>,</mo><msub><mi>T</mi><mi>k</mi></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>T</mi><mi>n</mi></msub></mrow></mfrac></math></p>
+</div>
+</li>
+</ul>
+</div>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title=""></i>
+</td>
+<td class="content">
+Simplification rules for union types with one element are applied first.
+</td>
+</tr>
+</table>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>The structural typing strategy is propagated to the types of the union:</p>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><mi>~</mi><mi>u</mi><mi>n</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><msub><mi>T</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>T</mi><mi>n</mi></msub></mrow></mfenced></mrow><mrow><mi>u</mi><mi>n</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><mi>~</mi><msub><mstyle mathvariant="monospace"><mtext>T</mtext></mstyle><mn>1</mn></msub><mo>,</mo><mi>…</mi><mo>,</mo><mi>~</mi><msub><mstyle mathvariant="monospace"><mtext>T</mtext></mstyle><mi>n</mi></msub></mrow></mfenced></mrow></mfrac></math>
+</div>
+</div>
+</li>
+</ul>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Remarks:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>The simplification rules may be applied recursively.</p>
+</li>
+<li>
+<p>For given types <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>B</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>A</mi></math>, and the union type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>U</mi><mo>=</mo><mi>u</mi><mi>n</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><mi>A</mi><mo>,</mo><mi>B</mi></mrow></mfenced></math>, <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>U</mi><mo>≠</mo><mi>B</mi></math>.
+The types are equivalent, however: <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>A</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mo>=</mo><mi>U</mi></math> and <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>U</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mo>=</mo><mi>A</mi></math>.<sup class="footnote">[<a id="_footnoteref_17" class="footnote" href="appendix_c_bibliography.html#_footnote_17" title="View footnote.">17</a>]</sup></p>
+</li>
+</ul>
+</div>
+<div class="exampleblock">
+<div class="title">Example 18. Subtyping with union type</div>
+<div class="content">
+<div class="paragraph">
+<p>Let A, B, and C be defined as in the chapter beginning (<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>C</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>B</mi><mo>&lt;</mo><mi>:</mi><mi>A</mi></math>)</p>
+</div>
+<div class="paragraph">
+<p>The following subtyping relations with union types are to be evaluated as follows: <sup class="footnote">[<a id="_footnoteref_18" class="footnote" href="appendix_c_bibliography.html#_footnote_18" title="View footnote.">18</a>]</sup></p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">A &lt;: union{A}                                   -&gt; true
+A &lt;: union{A,B}                                 -&gt; true
+B &lt;: union{A,B}                                 -&gt; true
+C &lt;: union{A,B}                                 -&gt; true
+A &lt;: union{B,C}                                 -&gt; false
+B &lt;: union{B,C}                                 -&gt; true
+C &lt;: union{B,C}                                 -&gt; true
+union{A} &lt;: A                                   -&gt; true
+union{B} &lt;: A                                   -&gt; true
+union{B,C} &lt;: A                                 -&gt; true
+union{A,B} &lt;: B                                 -&gt; false
+union{X,Z} &lt;: union{Z,X}                        -&gt; true
+union{X,Y} &lt;: union{X,Y,Z}                      -&gt; true
+union{X,Y,Z} &lt;: union{X,Y}                      -&gt; false</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>The simplification constraints are used by the type inferrer.
+It may be useful, however, to define union types with superfluous elements, as the next example demonstrates</p>
+</div>
+<div class="exampleblock">
+<div class="title">Example 19. Superfluous elements in union type</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">class A{}
+class B extends A{}
+class C extends A{}
+
+function foo(p: union{A,B}) {..}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Although <code>B</code> is superfluous, it may indicate that the function handles parameters of type differently than one of type <code>A</code> or <code>C</code>.</p>
+</div>
+<div class="paragraph">
+<p>Although a union type is a <code><a href="appendix_a_acronyms.html#_acronyms">LCST</a></code> of its contained (non-superfluous) types, the type inferrer usually does not create new union types when computing the join of types.
+If the join of types including at least one union type is calculated, the union type is preserved if possible.
+The same is true for meet.</p>
+</div>
+<div class="paragraph">
+<p>For the definition of join and meet for union types, we define how a type is added to a union type:</p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-21"></a><strong>Req. IDE-21:</strong> <a href="#Req-IDE-21">Union of union type</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>The union of union types is defined similar to the union of sets.
+The union is not simplified, but it contains no duplicates.</p>
+</div>
+<div class="paragraph">
+<p>If a type A is contained in a union type, then the union type is a common supertype, and (since it is the union itself) also the <code><a href="appendix_a_acronyms.html#_acronyms">LCST</a></code> of both types.
+This finding is the foundation of the definition of join of a (non-union) type with a union type:</p>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-22"></a><strong>Req. IDE-22:</strong> <a href="#Req-IDE-22">Join with Union Type</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>The join <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>J</mi></math> of a union type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>U</mi></math> with a type <em>T</em> is the union of both types:</p>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><mi>J</mi><mo>=</mo><mi>U</mi><mo>∪</mo><mi>T</mi></mrow><mrow><mfenced close=")" open="("><mrow><mi>U</mi><mo>∨</mo><mi>T</mi></mrow></mfenced><mo>=</mo><mi>J</mi></mrow></mfrac></math>
+</div>
+</div>
+<div class="paragraph">
+<p>Remarks:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Joining a union type with another type is not similar to joining the elements of the union type directly with another type.
+That is</p>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mi>A</mi><mspace width="3.0mm"/><mstyle mathvariant="bold"><mi>j</mi><mi>o</mi><mi>i</mi><mi>n</mi></mstyle><mspace width="3.0mm"/><mi>u</mi><mi>n</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><mi>B</mi><mo>,</mo><mi>C</mi></mrow></mfenced><mo>≠</mo><mi>A</mi><mspace width="3.0mm"/><mstyle mathvariant="bold"><mi>j</mi><mi>o</mi><mi>i</mi><mi>n</mi></mstyle><mspace width="3.0mm"/><mi>B</mi><mspace width="3.0mm"/><mstyle mathvariant="bold"><mi>j</mi><mi>o</mi><mi>i</mi><mi>n</mi></mstyle><mspace width="3.0mm"/><mi>C</mi></math>
+</div>
+</div>
+</li>
+<li>
+<p>The computed join is simplified according to the constraints defined above.</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-23"></a><strong>Req. IDE-23:</strong> <a href="#Req-IDE-23">Meet with Union Type</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>The meet of union types is defined as the meet of the elements.
+That is</p>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mtable><mtr><mtd><mfrac><mrow><msub><mi>T</mi><mn>1</mn></msub><mo>∧</mo><mi>S</mi><mo>∧</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>∧</mo><msub><mi>T</mi><mi>n</mi></msub><mo>∧</mo><mi>S</mi></mrow><mrow><mi>u</mi><mi>n</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><msub><mi>T</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>T</mi><mi>n</mi></msub></mrow></mfenced><mo>∧</mo><mi>S</mi></mrow></mfrac></mtd></mtr><mtr><mtd><mfrac><mrow><msub><mi>T</mi><mn>1</mn></msub><mo>∧</mo><msub><mi>S</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>T</mi><mn>1</mn></msub><mo>∧</mo><msub><mi>S</mi><mi>m</mi></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>T</mi><mi>n</mi></msub><mo>∧</mo><msub><mi>S</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>T</mi><mi>n</mi></msub><mo>∧</mo><msub><mi>S</mi><mi>m</mi></msub></mrow><mrow><mi>u</mi><mi>n</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><msub><mi>T</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>T</mi><mi>n</mi></msub></mrow></mfenced><mo>∧</mo><mi>u</mi><mi>n</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><msub><mi>S</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>S</mi><mi>m</mi></msub></mrow></mfenced></mrow></mfrac></mtd></mtr></mtable></math>
+</div>
+</div>
+<div class="paragraph">
+<p>Remarks:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>The meet of a union type with another type is not a union type itself.
+This gets clear when looking at the definition of meet and union type.
+While for a given <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>U</mi><mo>=</mo><mi>u</mi><mi>n</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><mi>A</mi><mo>,</mo><mi>B</mi></mrow></mfenced></math>, <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>A</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>U</mi></math> and <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>B</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>U</mi></math>, the opposite <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>U</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>A</mi></math> is usually not true (unless <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>U</mi></math> can be simplified to <em>A</em>).
+So, for <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>A</mi><mo>∧</mo><mi>U</mi></math>, usually <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>U</mi></math> cannot be the meet.</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-24"></a><strong>Req. IDE-24:</strong> <a href="#Req-IDE-24">Upper and Lower Bound of a Union Type</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>The upper and lower bound of a union type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>U</mi></math> is a union type <math xmlns="http://www.w3.org/1998/Math/MathML"><msup><mi>U</mi><mi>'</mi></msup></math> containing the upper and lower bound of the elements of <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>U</mi></math>:</p>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mtable><mtr><mtd><mi>u</mi><mi>p</mi><mi>p</mi><mi>e</mi><mi>r</mi><mfenced close=")" open="("><mrow><mi>u</mi><mi>n</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><msub><mi>T</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>T</mi><mi>n</mi></msub></mrow></mfenced></mrow></mfenced><mi>:</mi><mo>=</mo><mi>u</mi><mi>n</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><mi>u</mi><mi>p</mi><mi>p</mi><mi>e</mi><mi>r</mi><mfenced close=")" open="("><msub><mi>T</mi><mn>1</mn></msub></mfenced><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><mi>u</mi><mi>p</mi><mi>p</mi><mi>e</mi><mi>r</mi><mfenced close=")" open="("><msub><mi>T</mi><mn>1</mn></msub></mfenced></mrow></mfenced></mtd></mtr><mtr><mtd><mi>l</mi><mi>o</mi><mi>w</mi><mi>e</mi><mi>r</mi><mfenced close=")" open="("><mrow><mi>u</mi><mi>n</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><msub><mi>T</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>T</mi><mi>n</mi></msub></mrow></mfenced></mrow></mfenced><mi>:</mi><mo>=</mo><mi>u</mi><mi>n</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><mi>l</mi><mi>o</mi><mi>w</mi><mi>e</mi><mi>r</mi><mfenced close=")" open="("><msub><mi>T</mi><mn>1</mn></msub></mfenced><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><mi>l</mi><mi>o</mi><mi>w</mi><mi>e</mi><mi>r</mi><mfenced close=")" open="("><msub><mi>T</mi><mn>1</mn></msub></mfenced></mrow></mfenced></mtd></mtr></mtable></math>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_warnings"><a class="anchor" href="#_warnings"></a><a class="link" href="#_warnings">4.10.1.3. Warnings</a></h5>
+<div class="paragraph">
+<p>In case the <code>any</code> type is used in a union type, all other types in the union type definition become obsolete.
+However, defining other typers along with the <code>any</code> type might seem reasonable in case those other types are treated specifically and thus are mentioned explicitly in the definition.
+Nevertheless the use of the <code>any</code> type produces a warning, since its use can indicate a misunderstanding of the union type concept and since documentation can also be done in a comment.</p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-25"></a><strong>Req. IDE-25:</strong> <a href="#Req-IDE-25">Any type in union types</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>No union type shall conatin an type:</p>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mo>∄</mo><mi>a</mi><mi>n</mi><mi>y</mi><mo>∈</mo><mi>U</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mi>s</mi></math>
+</div>
+</div>
+<div class="paragraph">
+<p>Similar to the documentary purpose of using specific classes along with the <code>any</code> type is the following case.
+When two types are used, one of them a subtype of the other, then this subtype is obsolete. Still it can be used for documentary purposes.
+However, a warning will be produced to indicate unecessary code.
+The warning is only produced when both of the types are either classes or interfaces, since e.g. structural types are supertypes of any classes or interfaces.</p>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-26"></a><strong>Req. IDE-26:</strong> <a href="#Req-IDE-26">Redundant subtypes in union types</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>Union types shall not
+contain class or interface types which are a subtype of another class or interface type that also is contained in the union type.</p>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mtable><mtr><mtd><mo>∄</mo><mi>T</mi><mi>T</mi><mo>∈</mo><mi>U</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mi>s</mi><mi>:</mi><mo>∃</mo><mi>T</mi><mo>∈</mo><mi>U</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mi>s</mi><mi>:</mi></mtd></mtr><mtr><mtd><mrow><mo>(</mo><mrow><mi>T</mi><mi>T</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>T</mi><mo>∧</mo><mi>i</mi><mi>s</mi><mi>C</mi><mi>l</mi><mi>a</mi><mi>s</mi><mi>s</mi><mi>O</mi><mi>r</mi><mi>I</mi><mi>n</mi><mi>t</mi><mi>e</mi><mi>r</mi><mi>f</mi><mi>a</mi><mi>c</mi><mi>e</mi><mfenced close=")" open="("><mi>T</mi></mfenced><mo>∧</mo><mi>i</mi><mi>s</mi><mi>C</mi><mi>l</mi><mi>a</mi><mi>s</mi><mi>s</mi><mi>O</mi><mi>r</mi><mi>I</mi><mi>n</mi><mi>t</mi><mi>e</mi><mi>r</mi><mi>f</mi><mi>a</mi><mi>c</mi><mi>e</mi><mfenced close=")" open="("><mrow><mi>T</mi><mi>T</mi></mrow></mfenced><mo>)</mo></mrow></mrow></mtd></mtr></mtable></math>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_intersection-type"><a class="anchor" href="#_intersection-type"></a><a class="link" href="#_intersection-type">4.10.2. Intersection Type</a></h4>
+<div class="paragraph">
+<p>Intersection type reflects the dynamic nature of JavaScript, similar to union type.
+As in Java, intersection type is used to define the type boundaries of type variables in type parameter definitions.
+They are inferred by the type inferencer for type checking (as a result of join or meet).
+In contrast to Java, however, intersection type can be declared explicitly by means of intersection type expression.<sup class="footnote">[<a id="_footnoteref_19" class="footnote" href="appendix_c_bibliography.html#_footnote_19" title="View footnote.">19</a>]</sup></p>
+</div>
+<div class="sect4">
+<h5 id="intersection-type-syntax"><a class="anchor" href="#intersection-type-syntax"></a><a class="link" href="#intersection-type-syntax">4.10.2.1. Syntax</a></h5>
+<div class="paragraph">
+<p>For convenience, we repeat the definition of intersection type expression and of type variables in which intersection types can be defined as in Java:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">InterSectionTypeExpression: 'intersection' '{' typeRefs+=TypeRefWithoutModifiers (',' typeRefs+=TypeRefWithoutModifiers)* '}';
+
+TypeVariable:   name=IDENTIFIER ('extends' declaredUpperBounds+=ParameterizedTypeRefNominal ('&amp;' declaredUpperBounds+=ParameterizedTypeRefNominal)*)?</code></pre>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="intersection-type-semantics"><a class="anchor" href="#intersection-type-semantics"></a><a class="link" href="#intersection-type-semantics">4.10.2.2. Semantics</a></h5>
+<div class="paragraph">
+<p>An intersection type may contain several interfaces but only one class.
+It virtually declares a subclass of this one class and implements all interfaces declared in the intersection type.
+If no class is declared in the intersection type, the intersection type virtually declares a subclass of an N4Object instead.
+This virtual subclass also explains why only one single class may be contained in the intersection.</p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-27"></a><strong>Req. IDE-27:</strong> <a href="#Req-IDE-27">Intersection Type</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>For a given intersection type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>I</mi></math>, the following conditions must hold:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>The intersection must contain at least one type:</p>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mi>I</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mi>s</mi><mo>≠</mo><mi>∅</mi></math>
+</div>
+</div>
+</li>
+<li>
+<p>Only one class must be contained in the intersection type:</p>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfenced close=")" open="("><mrow><mo>∃</mo><mi>C</mi><mo>∈</mo><mi>I</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mi>s</mi><mi>:</mi><mi>μ</mi><mfenced close=")" open="("><mi>C</mi></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>Class</mtext></mstyle></mrow></mfenced><mo>→</mo><mo>∄</mo><mi>T</mi><mo>∈</mo><mi>I</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mi>s</mi><mo>∖</mo><mfenced close="}" open="{"><mi>C</mi></mfenced><mi>:</mi><mi>μ</mi><mfenced close=")" open="("><mi>T</mi></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>Class</mtext></mstyle></math>
+</div>
+</div>
+<div class="paragraph">
+<p>For the time being, only a warning is produced when more than one class is contained in the intersection type .</p>
+</div>
+</li>
+<li>
+<p>Non-optional elements:</p>
+</li>
+</ol>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mo>∀</mo><mi>T</mi><mo>∈</mo><mi>I</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mi>s</mi><mo>→</mo><mo>¬</mo><mi>T</mi><mo>.</mo><mi>o</mi><mi>p</mi><mi>t</mi></math>
+</div>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-175"></a><strong>Req. IDE-175:</strong> <a href="#Req-IDE-175">Intersection Type Subtyping Rules</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>Let <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>I</mi></math> be an intersection type.</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>An intersection type is a subtype of another type, if at least one of
+its contained types is a subtype of that type: <sup class="footnote">[<a id="_footnoteref_20" class="footnote" href="appendix_c_bibliography.html#_footnote_20" title="View footnote.">20</a>]</sup></p>
+</li>
+</ul>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><mo>∃</mo><mi>T</mi><mo>∈</mo><mi>I</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mi>s</mi><mi>:</mi><mi>T</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>S</mi></mrow><mrow><mi>I</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>S</mi></mrow></mfrac></math>
+</div>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>A type is a subtype of an intersection type, if it is a subtype of all
+types contained in the intersection type: <sup class="footnote">[<a id="_footnoteref_21" class="footnote" href="appendix_c_bibliography.html#_footnote_21" title="View footnote.">21</a>]</sup></p>
+</li>
+</ul>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><mo>∀</mo><mi>T</mi><mo>∈</mo><mi>I</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mi>s</mi><mi>:</mi><mi>S</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>T</mi></mrow><mrow><mi>S</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>I</mi></mrow></mfrac></math>
+</div>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Non-optional elements:
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∀</mo><mi>T</mi><mo>∈</mo><mi>I</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mi>s</mi><mo>→</mo><mo>¬</mo><mi>T</mi><mo>.</mo><mi>o</mi><mi>p</mi><mi>t</mi></math></p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-28"></a><strong>Req. IDE-28:</strong> <a href="#Req-IDE-28">Implicit simplification of intersection types</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>Let <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>I</mi></math> be an intersection type.
+The following simplification rules are always automatically applied to intersection types.</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>The structural typing strategy is propagated to the types of the intersection:</p>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><mi>~</mi><mi>i</mi><mi>n</mi><mi>t</mi><mi>e</mi><mi>r</mi><mi>s</mi><mi>e</mi><mi>c</mi><mi>t</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><msub><mi>T</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>T</mi><mi>n</mi></msub></mrow></mfenced></mrow><mrow><mi>i</mi><mi>n</mi><mi>t</mi><mi>e</mi><mi>r</mi><mi>s</mi><mi>e</mi><mi>c</mi><mi>t</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><mi>~</mi><msub><mstyle mathvariant="monospace"><mtext>T</mtext></mstyle><mn>1</mn></msub><mo>,</mo><mi>…</mi><mo>,</mo><mi>~</mi><msub><mstyle mathvariant="monospace"><mtext>T</mtext></mstyle><mi>n</mi></msub></mrow></mfenced></mrow></mfrac></math>
+</div>
+</div>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>These subtyping rules are similar to Ceylon. <sup class="footnote">[<a id="_footnoteref_22" class="footnote" href="appendix_c_bibliography.html#_footnote_22" title="View footnote.">22</a>]</sup></p>
+</div>
+<div class="paragraph">
+<p>During validation, intersection types containing union or other intersection types may be inferred.
+In this case, the composed types are flattened.
+The aforementioned constraints must hold.
+We also implicitly use this representation in this specification.</p>
+</div>
+<div class="exampleblock">
+<div class="title">Example 20. Subtyping with intersection type</div>
+<div class="content">
+<div class="paragraph">
+<p>Let A, B, and C be defined as in the chapter beginning (<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>C</mi><mo>&lt;</mo><mi>:</mi><mi>B</mi><mo>&lt;</mo><mi>:</mi><mi>A</mi></math>)</p>
+</div>
+<div class="paragraph">
+<p>The following subtyping relations with intersection types are to be
+evaluated as follows: <sup class="footnote">[<a id="_footnoteref_23" class="footnote" href="appendix_c_bibliography.html#_footnote_23" title="View footnote.">23</a>]</sup></p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">A &lt;: intersection{A}                            -&gt; true
+A &lt;: intersection{A,A}                          -&gt; true
+intersection{A,X} &lt;: A                          -&gt; true
+intersection{X,A} &lt;: A                          -&gt; true
+A &lt;: intersection{A,X}                          -&gt; false
+intersection{A,X} &lt;: intersection{X,A}          -&gt; true
+H12 &lt;: intersection{I1,I2}                      -&gt; true
+intersection{I1,I2} &lt;: H12                      -&gt; false
+H1 &lt;: intersection{I1,I2}                       -&gt; false
+H23 &lt;: intersection{I1,I2}                      -&gt; false
+B &lt;: intersection{A}                            -&gt; true
+intersection{I1,I2} &lt;: I                        -&gt; true
+H12 &lt;: intersection{I,I2}                       -&gt; true
+A &lt;: intersection{A,Any}                        -&gt; true
+intersection{A,Any} &lt;: A                        -&gt; true</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>The join of intersection types is defined as the join of the elements.
+That is:</p>
+</div>
+<div class="paragraph">
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mfrac><mrow><msub><mi>T</mi><mn>1</mn></msub><mo>∨</mo><mi>S</mi><mo>∨</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>∨</mo><msub><mi>T</mi><mi>n</mi></msub><mo>∨</mo><mi>S</mi></mrow><mrow><mi>i</mi><mi>n</mi><mi>t</mi><mi>e</mi><mi>r</mi><mi>s</mi><mi>e</mi><mi>c</mi><mi>t</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><msub><mi>T</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>T</mi><mi>n</mi></msub></mrow></mfenced><mo>∨</mo><mi>S</mi></mrow></mfrac></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mfrac><mrow><msub><mi>T</mi><mn>1</mn></msub><mo>∨</mo><msub><mi>S</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>T</mi><mn>1</mn></msub><mo>∨</mo><msub><mi>S</mi><mi>m</mi></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>T</mi><mi>n</mi></msub><mo>∨</mo><msub><mi>S</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>T</mi><mi>n</mi></msub><mo>∨</mo><msub><mi>S</mi><mi>m</mi></msub></mrow><mrow><mi>i</mi><mi>n</mi><mi>t</mi><mi>e</mi><mi>r</mi><mi>s</mi><mi>e</mi><mi>c</mi><mi>t</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><msub><mi>T</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>T</mi><mi>n</mi></msub></mrow></mfenced><mo>∨</mo><mi>i</mi><mi>n</mi><mi>t</mi><mi>e</mi><mi>r</mi><mi>s</mi><mi>e</mi><mi>c</mi><mi>t</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><msub><mi>S</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>S</mi><mi>m</mi></msub></mrow></mfenced></mrow></mfrac></math></p>
+</div>
+<div class="openblock">
+<div class="content">
+
+</div>
+</div>
+<div class="paragraph">
+<p>The meet of intersection types is defined over their elements.
+That is:</p>
+</div>
+<div class="paragraph">
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mfrac><mrow><mi>i</mi><mi>n</mi><mi>t</mi><mi>e</mi><mi>r</mi><mi>s</mi><mi>e</mi><mi>c</mi><mi>t</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><msub><mi>T</mi><mn>1</mn></msub><mo>∧</mo><mi>S</mi><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>T</mi><mi>n</mi></msub><mo>∧</mo><mi>S</mi></mrow></mfenced></mrow><mrow><mi>i</mi><mi>n</mi><mi>t</mi><mi>e</mi><mi>r</mi><mi>s</mi><mi>e</mi><mi>c</mi><mi>t</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><msub><mi>T</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>T</mi><mi>n</mi></msub></mrow></mfenced><mo>∧</mo><mi>S</mi></mrow></mfrac></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mfrac><mrow><mi>i</mi><mi>n</mi><mi>t</mi><mi>e</mi><mi>r</mi><mi>s</mi><mi>e</mi><mi>c</mi><mi>t</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><msub><mi>T</mi><mn>1</mn></msub><mo>∧</mo><msub><mi>S</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>T</mi><mn>1</mn></msub><mo>∧</mo><msub><mi>S</mi><mi>m</mi></msub><mo>,</mo><mspace width="1em"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><mspace width="1em"/><msub><mi>T</mi><mi>n</mi></msub><mo>∧</mo><msub><mi>S</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>T</mi><mi>n</mi></msub><mo>∧</mo><msub><mi>S</mi><mi>m</mi></msub></mrow></mfenced></mrow><mrow><mi>i</mi><mi>n</mi><mi>t</mi><mi>e</mi><mi>r</mi><mi>s</mi><mi>e</mi><mi>c</mi><mi>t</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><msub><mi>T</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>T</mi><mi>n</mi></msub></mrow></mfenced><mo>∧</mo><mi>i</mi><mi>n</mi><mi>t</mi><mi>e</mi><mi>r</mi><mi>s</mi><mi>e</mi><mi>c</mi><mi>t</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><msub><mi>S</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>S</mi><mi>m</mi></msub></mrow></mfenced></mrow></mfrac></math></p>
+</div>
+<div class="openblock">
+<div class="content">
+
+</div>
+</div>
+<div class="paragraph">
+<p>The upper and lower bound of an intersection type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>I</mi></math> is a union type <math xmlns="http://www.w3.org/1998/Math/MathML"><msup><mi>I</mi><mi>'</mi></msup></math> containing the upper and lower bound of the elements of <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>I</mi></math>:</p>
+</div>
+<div class="paragraph">
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mi>u</mi><mi>p</mi><mi>p</mi><mi>e</mi><mi>r</mi><mfenced close=")" open="("><mrow><mi>i</mi><mi>n</mi><mi>t</mi><mi>e</mi><mi>r</mi><mi>s</mi><mi>e</mi><mi>c</mi><mi>t</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><msub><mi>T</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>T</mi><mi>n</mi></msub></mrow></mfenced></mrow></mfenced><mi>:</mi><mo>=</mo><mi>i</mi><mi>n</mi><mi>t</mi><mi>e</mi><mi>r</mi><mi>s</mi><mi>e</mi><mi>c</mi><mi>t</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><mi>u</mi><mi>p</mi><mi>p</mi><mi>e</mi><mi>r</mi><mfenced close=")" open="("><msub><mi>T</mi><mn>1</mn></msub></mfenced><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><mi>u</mi><mi>p</mi><mi>p</mi><mi>e</mi><mi>r</mi><mfenced close=")" open="("><msub><mi>T</mi><mn>1</mn></msub></mfenced></mrow></mfenced></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>l</mi><mi>o</mi><mi>w</mi><mi>e</mi><mi>r</mi><mfenced close=")" open="("><mrow><mi>i</mi><mi>n</mi><mi>t</mi><mi>e</mi><mi>r</mi><mi>s</mi><mi>e</mi><mi>c</mi><mi>t</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><msub><mi>T</mi><mn>1</mn></msub><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><msub><mi>T</mi><mi>n</mi></msub></mrow></mfenced></mrow></mfenced><mi>:</mi><mo>=</mo><mi>i</mi><mi>n</mi><mi>t</mi><mi>e</mi><mi>r</mi><mi>s</mi><mi>e</mi><mi>c</mi><mi>t</mi><mi>i</mi><mi>o</mi><mi>n</mi><mfenced close="}" open="{"><mrow><mi>l</mi><mi>o</mi><mi>w</mi><mi>e</mi><mi>r</mi><mfenced close=")" open="("><msub><mi>T</mi><mn>1</mn></msub></mfenced><mo>,</mo><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>.</mo><mspace width="1.0mm"/><mo>,</mo><mi>l</mi><mi>o</mi><mi>w</mi><mi>e</mi><mi>r</mi><mfenced close=")" open="("><msub><mi>T</mi><mn>1</mn></msub></mfenced></mrow></mfenced></math></p>
+</div>
+<div class="openblock">
+<div class="content">
+
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_warnings-2"><a class="anchor" href="#_warnings-2"></a><a class="link" href="#_warnings-2">4.10.2.3. Warnings</a></h5>
+<div class="paragraph">
+<p>Using <code>any</code> types in intersection types is obsolete since they do not change the resulting intersection type.
+E.g. the intersection type of A, B and <code>any</code> is equivialent to the intersection type of A and B.
+However, using the <code>any</code> type is no error because it can be seen as a neutral argument to the intersection.
+Nevertheless the use of the <code>any</code> type produces a warning, since its use can indicate a misunderstanding of the intersection type concept and since it always can be omitted.</p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-32"></a><strong>Req. IDE-32:</strong> <a href="#Req-IDE-32">Any type in intersection types</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>No intersection type shall contain an type:</p>
+</div>
+<div class="paragraph">
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∄</mo><mi>a</mi><mi>n</mi><mi>y</mi><mo>∈</mo><mi>I</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mi>s</mi></math></p>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>The use of the <code>any</code> type in an intersection type is similar to the following case.
+When two types are used, one of them a supertype of the other, then this supertype is obsolete.
+Hence, a warning will be produced to indicate unecessary code.
+The warning is only produced when both of the types are either classes or interfaces, since e.g. structural types are supertypes of any classes or interfaces.</p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-33"></a><strong>Req. IDE-33:</strong> <a href="#Req-IDE-33">Redundant supertypes in intersection types</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>Intersection types shall not contain class or interface types which are a supertype of another class or interface type that also is contained in the intersection type.</p>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mo>∄</mo><mi>T</mi><mo>∈</mo><mi>I</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mi>s</mi><mi>:</mi><mo>∃</mo><mi>T</mi><mi>T</mi><mo>∈</mo><mi>I</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mi>s</mi><mi>:</mi><mtext>
+</mtext><mrow><mo>(</mo><mrow><mi>T</mi><mi>T</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>T</mi><mo>∧</mo><mi>i</mi><mi>s</mi><mi>C</mi><mi>l</mi><mi>a</mi><mi>s</mi><mi>s</mi><mi>O</mi><mi>r</mi><mi>I</mi><mi>n</mi><mi>t</mi><mi>e</mi><mi>r</mi><mi>f</mi><mi>a</mi><mi>c</mi><mi>e</mi><mfenced close=")" open="("><mi>T</mi></mfenced><mo>∧</mo><mi>i</mi><mi>s</mi><mi>C</mi><mi>l</mi><mi>a</mi><mi>s</mi><mi>s</mi><mi>O</mi><mi>r</mi><mi>I</mi><mi>n</mi><mi>t</mi><mi>e</mi><mi>r</mi><mi>f</mi><mi>a</mi><mi>c</mi><mi>e</mi><mfenced close=")" open="("><mrow><mi>T</mi><mi>T</mi></mrow></mfenced><mo>)</mo></mrow></mrow></math>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_composed-types-in-wildcards"><a class="anchor" href="#_composed-types-in-wildcards"></a><a class="link" href="#_composed-types-in-wildcards">4.10.3. Composed Types in Wildcards</a></h4>
+<div class="paragraph">
+<p>Composed types may appear as the bound of a wildcard.
+The following constraints apply: <sup class="footnote">[<a id="_footnoteref_24" class="footnote" href="appendix_c_bibliography.html#_footnote_24" title="View footnote.">24</a>]</sup></p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-34"></a><strong>Req. IDE-34:</strong> <a href="#Req-IDE-34">Composed Types as Bound of a Wildcard</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>A composed type may appear as the upper or lower bound of a wildcard.
+In the covariant case, the following subtype relations apply:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-ebnf" data-lang="ebnf">union{ G&lt;? extends A&gt;, G&lt;? extends B&gt; }  \subtype  G&lt;? extends union{A,B}&gt;
+G&lt;? extends intersection{A,B}&gt;  \subtype  intersection{ G&lt;? extends A&gt;, G&lt;? extends B&gt; }</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>In the contra variant case, the following subtype relations apply:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-ebnf" data-lang="ebnf">union{ G&lt;? super A&gt;, G&lt;? super B&gt; }  \subtype  G&lt;? super intersection{A,B}&gt;
+G&lt;? super union{A,B}&gt;  \subtype  intersection{ G&lt;? super A&gt;, G&lt;? super B&gt; }</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_property-access-for-composed-types"><a class="anchor" href="#_property-access-for-composed-types"></a><a class="link" href="#_property-access-for-composed-types">4.10.4. Property Access for Composed Types</a></h4>
+<div class="paragraph">
+<p>It is possible to directly access properties of union and intersection types.
+The following sections define which properties are accessible.</p>
+</div>
+<div class="sect4">
+<h5 id="_properties-of-union-type"><a class="anchor" href="#_properties-of-union-type"></a><a class="link" href="#_properties-of-union-type">4.10.4.1. Properties of Union Type</a></h5>
+<div class="paragraph">
+<p>As an (oversimplified) rule of thumb, the properties of a union type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>U</mi><mo>=</mo><msub><mi>T</mi><mn>1</mn></msub><mo>|</mo><msub><mi>T</mi><mn>2</mn></msub></math> are simply the intersection of the properties <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>U</mi><mo>.</mo><mi>p</mi><mi>r</mi><mi>o</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>t</mi><mi>i</mi><mi>e</mi><mi>s</mi><mo>=</mo><msub><mi>T</mi><mn>1</mn></msub><mo>.</mo><mi>p</mi><mi>r</mi><mi>o</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>t</mi><mi>i</mi><mi>e</mi><mi>s</mi><mo>∩</mo><msub><mi>T</mi><mn>2</mn></msub><mo>.</mo><mi>p</mi><mi>r</mi><mi>o</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>t</mi><mi>i</mi><mi>e</mi><mi>s</mi></math>.
+In other words, a property 'p' in the union type is the least common denominator of all 'p' in T_{1} and T_{2}.
+It is not quite that simple, however, as the question of "equality" with regards to properties has to be answered.</p>
+</div>
+<hr>
+<div class="paragraph">
+<p>For a given union type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>U</mi><mo>=</mo><msub><mi>T</mi><mn>1</mn></msub><mo>|</mo><msub><mi>T</mi><mn>2</mn></msub></math>, the following constraints for its members must hold:</p>
+</div>
+<div class="paragraph">
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∀</mo><mi> </mi><mi>a</mi><mo>∈</mo><mi>U</mi><mo>.</mo><mi>a</mi><mi>t</mi><mi>t</mi><mi>r</mi><mi>i</mi><mi>b</mi><mi>u</mi><mi>t</mi><mi>e</mi><mi>s</mi><mi>:</mi></math></p>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mtable><mtr><mtd/><mtd><mo>∀</mo><mi> </mi><mi>k</mi><mo>∈</mo><mfenced close="}" open="{"><mn>1</mn><mn>2</mn></mfenced><mi>:</mi><mo>∃</mo><mi> </mi><msub><mi>a</mi><mi>k</mi></msub><mo>∈</mo><msub><mi>T</mi><mi>k</mi></msub><mo>.</mo><mi>a</mi><mi>t</mi><mi>t</mi><mi>r</mi><mi>i</mi><mi>b</mi><mi>u</mi><mi>t</mi><mi>e</mi><mi>s</mi><mi>:</mi><msub><mi>a</mi><mi>k</mi></msub><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mo>&gt;</mo><mi>p</mi><mi>r</mi><mi>i</mi><mi>v</mi><mi>a</mi><mi>t</mi><mi>e</mi></mtd></mtr><mtr><mtd/><mtd><mo>∧</mo><mi>a</mi><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mo>=</mo><mi>m</mi><mi>i</mi><mi>n</mi><mfenced close=")" open="("><mrow><msub><mi>a</mi><mn>1</mn></msub><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi></mrow><mrow><msub><mi>a</mi><mn>2</mn></msub><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi></mrow></mfenced></mtd></mtr><mtr><mtd/><mtd><mo>∧</mo><mi>a</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><msub><mi>a</mi><mn>1</mn></msub><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><msub><mi>a</mi><mn>2</mn></msub><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi></mtd></mtr><mtr><mtd/><mtd><mo>∧</mo><mi>a</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mo>=</mo><msub><mi>a</mi><mn>1</mn></msub><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mo>=</mo><msub><mi>a</mi><mn>2</mn></msub><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi></mtd></mtr></mtable></math>
+</div>
+</div>
+<div class="paragraph">
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∀</mo><mi> </mi><mi>m</mi><mo>∈</mo><mi>U</mi><mo>.</mo><mi>m</mi><mi>e</mi><mi>t</mi><mi>h</mi><mi>o</mi><mi>d</mi><mi>s</mi><mi>:</mi></math></p>
+</div>
+<div class="paragraph">
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∃</mo><mi> </mi><msub><mi>m</mi><mn>1</mn></msub><mo>∈</mo><msub><mi>T</mi><mn>1</mn></msub><mo>.</mo><mi>m</mi><mi>e</mi><mi>t</mi><mi>h</mi><mi>o</mi><mi>d</mi><mi>s</mi><mo>,</mo><msub><mi>m</mi><mn>2</mn></msub><mo>∈</mo><msub><mi>T</mi><mn>2</mn></msub><mo>.</mo><mi>m</mi><mi>e</mi><mi>t</mi><mi>h</mi><mi>o</mi><mi>d</mi><mi>s</mi><mo>,</mo></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="2.0em"/><mstyle mathvariant="bold"><mi>w</mi><mi>i</mi><mi>t</mi><mi>h</mi></mstyle><mi>p</mi><mo>=</mo><mi>m</mi><mo>.</mo><mi>f</mi><mi>p</mi><mi>a</mi><mi>r</mi><mi>s</mi><mo>∧</mo><msup><mi>p</mi><mi>'</mi></msup><mo>=</mo><msub><mi>m</mi><mn>1</mn></msub><mo>.</mo><mi>f</mi><mi>p</mi><mi>a</mi><mi>r</mi><mi>s</mi><mo>∧</mo><mi>p</mi><mi>"</mi><mo>=</mo><msub><mi>m</mi><mn>2</mn></msub><mo>.</mo><mi>f</mi><mi>p</mi><mi>a</mi><mi>r</mi><mi>s</mi><mo>,</mo><mstyle mathvariant="bold"><mi>W</mi><mi>L</mi><mi>O</mi><mi>G</mi></mstyle><mo>|</mo><msup><mi>p</mi><mi>'</mi></msup><mo>|</mo><mo>≤</mo><mo>|</mo><mi>p</mi><mi>"</mi><mo>|</mo><mi>:</mi></math><br></p>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mtable><mtr><mtd/><mtd><mspace width="1.2em"/><mo>∀</mo><mi>k</mi><mo>∈</mo><mfenced close="}" open="{"><mn>1</mn><mn>2</mn></mfenced><mi>:</mi><msub><mi>m</mi><mi>k</mi></msub><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mo>&gt;</mo><mi>p</mi><mi>r</mi><mi>i</mi><mi>v</mi><mi>a</mi><mi>t</mi><mi>e</mi></mtd></mtr><mtr><mtd/><mtd><mo>∧</mo><mi>m</mi><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mo>=</mo><mi>m</mi><mi>i</mi><mi>n</mi><mfenced close=")" open="("><mrow><msub><mi>m</mi><mn>1</mn></msub><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi></mrow><mrow><msub><mi>m</mi><mn>2</mn></msub><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi></mrow></mfenced></mtd></mtr><mtr><mtd/><mtd><mo>∧</mo><mi>m</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><msub><mi>m</mi><mn>1</mn></msub><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><msub><mi>m</mi><mn>2</mn></msub><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi></mtd></mtr><mtr><mtd/><mtd><mo>∧</mo><mi>m</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mo>=</mo><msub><mi>m</mi><mn>1</mn></msub><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mo>|</mo><msub><mi>m</mi><mn>2</mn></msub><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi></mtd></mtr><mtr><mtd/><mtd><mo>∧</mo><mo>∀</mo><mi> </mi><mi>i</mi><mo>&lt;</mo><mo>|</mo><mi>p</mi><mi>"</mi><mo>|</mo><mi>:</mi><msub><mi>p</mi><mi>i</mi></msub><mi> </mi><mstyle mathvariant="bold"><mi>e</mi><mi>x</mi><mi>i</mi><mi>s</mi><mi>t</mi><mi>s</mi></mstyle><mspace width="1.0mm"/><mstyle mathvariant="bold"><mi>w</mi><mi>i</mi><mi>t</mi><mi>h</mi></mstyle></mtd></mtr><mtr><mtd/><mtd><mspace width="2.0em"/><msub><mi>p</mi><mi>i</mi></msub><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><mfenced close="" open="{"><mtable><mtr><mtd><msub><mrow><mi>p</mi><mi>"</mi></mrow><mi>i</mi></msub><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi></mtd><mtd><mi>i</mi><mo>≥</mo><mo>|</mo><msup><mi>p</mi><mi>'</mi></msup><mo>|</mo><mo>∨</mo><msub><msup><mi>p</mi><mi>'</mi></msup><mi>i</mi></msub><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><msub><mrow><mi>p</mi><mi>"</mi></mrow><mi>i</mi></msub><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi></mtd></mtr><mtr><mtd><msub><msup><mi>p</mi><mi>'</mi></msup><mi>i</mi></msub><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>+</mo><mstyle mathvariant="bold"><mi>"</mi><mi>_</mi><mi>"</mi></mstyle><mo>+</mo><msub><mrow><mi>p</mi><mi>"</mi></mrow><mi>i</mi></msub><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi></mtd><mtd><mstyle mathvariant="bold"><mi>e</mi><mi>l</mi><mi>s</mi><mi>e</mi></mstyle></mtd></mtr></mtable></mfenced></mtd></mtr><mtr><mtd/><mtd><mspace width="2.0em"/><msub><mi>p</mi><mi>i</mi></msub><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mo>=</mo><mfenced close="" open="{"><mtable><mtr><mtd><msub><msup><mi>p</mi><mi>'</mi></msup><mi>i</mi></msub><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mi>&amp;</mi><msub><mrow><mi>p</mi><mi>"</mi></mrow><mi>i</mi></msub><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi></mtd><mtd><mi>i</mi><mo>&lt;</mo><mo>|</mo><msup><mi>p</mi><mi>'</mi></msup><mo>|</mo></mtd></mtr><mtr><mtd><msub><msup><mi>p</mi><mi>'</mi></msup><mrow><mo>|</mo><msup><mi>p</mi><mi>'</mi></msup><mo>|</mo><mo>-</mo><mn>1</mn></mrow></msub><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mi>&amp;</mi><msub><mrow><mi>p</mi><mi>"</mi></mrow><mi>i</mi></msub><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi></mtd><mtd><mi>i</mi><mo>≥</mo><mo>|</mo><msup><mi>p</mi><mi>'</mi></msup><mo>|</mo><mo>∧</mo><msub><msup><mi>p</mi><mi>'</mi></msup><mrow><mo>|</mo><msup><mi>p</mi><mi>'</mi></msup><mo>|</mo><mo>-</mo><mn>1</mn></mrow></msub><mo>.</mo><mi>v</mi><mi>a</mi><mi>r</mi></mtd></mtr><mtr><mtd><msub><mrow><mi>p</mi><mi>"</mi></mrow><mi>i</mi></msub><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi></mtd><mtd><mstyle mathvariant="bold"><mi>e</mi><mi>l</mi><mi>s</mi><mi>e</mi></mstyle></mtd></mtr></mtable></mfenced></mtd></mtr><mtr><mtd/><mtd><mspace width="2.0em"/><msub><mi>p</mi><mi>i</mi></msub><mo>.</mo><mi>o</mi><mi>p</mi><mi>t</mi><mo>=</mo><mfenced close="" open="{"><mtable><mtr><mtd><mfenced close=")" open="("><mrow><msub><msup><mi>p</mi><mi>'</mi></msup><mi>i</mi></msub><mo>.</mo><mi>o</mi><mi>p</mi><mi>t</mi><mo>∧</mo><msub><mrow><mi>p</mi><mi>"</mi></mrow><mi>i</mi></msub><mo>.</mo><mi>o</mi><mi>p</mi><mi>t</mi></mrow></mfenced></mtd><mtd><mi>i</mi><mo>&lt;</mo><mo>|</mo><msup><mi>p</mi><mi>'</mi></msup><mo>|</mo></mtd></mtr><mtr><mtd><msub><mrow><mi>p</mi><mi>"</mi></mrow><mi>i</mi></msub><mo>.</mo><mi>o</mi><mi>p</mi><mi>t</mi></mtd><mtd><mstyle mathvariant="bold"><mi>e</mi><mi>l</mi><mi>s</mi><mi>e</mi></mstyle></mtd></mtr></mtable></mfenced></mtd></mtr><mtr><mtd/><mtd><mspace width="2.0em"/><msub><mi>p</mi><mi>i</mi></msub><mo>.</mo><mi>v</mi><mi>a</mi><mi>r</mi><mo>=</mo><mfenced close="" open="{"><mtable><mtr><mtd><msub><msup><mi>p</mi><mi>'</mi></msup><mi>i</mi></msub><mo>.</mo><mi>v</mi><mi>a</mi><mi>r</mi><mo>∧</mo><msub><mrow><mi>p</mi><mi>"</mi></mrow><mi>i</mi></msub><mo>.</mo><mi>v</mi><mi>a</mi><mi>r</mi></mtd><mtd><mi>i</mi><mo>&lt;</mo><mo>|</mo><msup><mi>p</mi><mi>'</mi></msup><mo>|</mo><mo>∧</mo><mi>i</mi><mo>=</mo><mo>|</mo><mi>p</mi><mi>"</mi><mo>|</mo><mo>-</mo><mn>1</mn></mtd></mtr><mtr><mtd><msub><mrow><mi>p</mi><mi>"</mi></mrow><mi>i</mi></msub><mo>.</mo><mi>v</mi><mi>a</mi><mi>r</mi></mtd><mtd><mi>i</mi><mo>≥</mo><mo>|</mo><msup><mi>p</mi><mi>'</mi></msup><mo>|</mo><mo>∧</mo><mi>i</mi><mo>=</mo><mo>|</mo><mi>p</mi><mi>"</mi><mo>|</mo><mo>-</mo><mn>1</mn></mtd></mtr><mtr><mtd><mi>f</mi><mi>a</mi><mi>l</mi><mi>s</mi><mi>e</mi></mtd><mtd><mstyle mathvariant="bold"><mi>e</mi><mi>l</mi><mi>s</mi><mi>e</mi></mstyle></mtd></mtr></mtable></mfenced></mtd></mtr></mtable></math>
+</div>
+</div>
+<div class="paragraph">
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∧</mo><mrow><mo>(</mo><mi>l</mi><mo>=</mo><mo>|</mo><msup><mi>p</mi><mi>'</mi></msup><mo>|</mo><mo>=</mo><mo>|</mo><mi>p</mi><mi>"</mi><mo>|</mo><mo>∧</mo><mo>¬</mo><mfenced close=")" open="("><mrow><msub><msup><mi>p</mi><mi>'</mi></msup><mi>l</mi></msub><mo>-</mo><mn>1</mn><mo>.</mo><mi>o</mi><mi>p</mi><mi>t</mi><mo>∧</mo><msub><mrow><mi>p</mi><mi>"</mi></mrow><mrow><mi>l</mi><mo>-</mo><mn>1</mn></mrow></msub><mo>.</mo><mi>o</mi><mi>p</mi><mi>t</mi></mrow></mfenced><mo>∧</mo><mo>∃</mo><mi>v</mi><mo>∈</mo><mfenced close="}" open="{"><mrow><mi>p</mi><msub><mi>'</mi><mi>l</mi></msub><mo>-</mo><mn>1</mn></mrow><mrow><mi>p</mi><msub><mi>"</mi><mi>l</mi></msub><mo>-</mo><mn>1</mn></mrow></mfenced><mi>v</mi><mo>.</mo><mi>v</mi><mi>a</mi><mi>r</mi><mi>:</mi><msub><mi>p</mi><mi>l</mi></msub><mi> </mi><mstyle mathvariant="bold"><mi>e</mi><mi>x</mi><mi>i</mi><mi>s</mi><mi>t</mi><mi>s</mi></mstyle><mspace width="1.0mm"/><mstyle mathvariant="bold"><mi>w</mi><mi>i</mi><mi>t</mi><mi>h</mi></mstyle></mrow></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="2.0em"/><msub><mi>p</mi><mi>l</mi></msub><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><mi>v</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="2.0em"/><msub><mi>p</mi><mi>i</mi></msub><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mo>=</mo><mi>v</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="2.0em"/><msub><mi>p</mi><mi>i</mi></msub><mo>.</mo><mi>o</mi><mi>p</mi><mi>t</mi><mo>=</mo><mi>t</mi><mi>r</mi><mi>u</mi><mi>e</mi></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="2.0em"/><msub><mi>p</mi><mi>i</mi></msub><mo>.</mo><mi>v</mi><mi>a</mi><mi>r</mi><mo>=</mo><mi>t</mi><mi>r</mi><mi>u</mi><mi>e</mi></math></p>
+</div>
+<hr>
+<div class="paragraph">
+<p>The following table shows how non-method members of union types are merged.
+The resulting member type depends on whether the member is being accessed during a read (R) or write (W) operation.
+The type of a field, of a getter or of the parameter of a setter is indicated in brackets.</p>
+</div>
+<table class="tableblock frame-all grid-all spread">
+<caption class="title">Table 4. Merged Members of Unions</caption>
+<colgroup>
+<col style="width: 20%;">
+<col style="width: 20%;">
+<col style="width: 20%;">
+<col style="width: 20%;">
+<col style="width: 20%;">
+</colgroup>
+<thead>
+<tr>
+<th class="tableblock halign-center valign-top">Members</th>
+<th class="tableblock halign-center valign-top" colspan="2">S=T</th>
+<th class="tableblock halign-center valign-top" colspan="2">S≠T</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<th class="tableblock halign-center valign-top"></th>
+<th class="tableblock halign-center valign-top"><p class="tableblock">R</p></th>
+<th class="tableblock halign-center valign-top"><p class="tableblock">W</p></th>
+<th class="tableblock halign-center valign-top"><p class="tableblock">R</p></th>
+<th class="tableblock halign-center valign-top"><p class="tableblock">W</p></th>
+</tr>
+<tr>
+<th class="tableblock halign-center valign-top"><p class="tableblock">field:S  | field:T</p></th>
+<td class="tableblock halign-center valign-top" colspan="2"><p class="tableblock">field:S</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">getter:S|T</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">setter:S&amp;T</p></td>
+</tr>
+<tr>
+<th class="tableblock halign-center valign-top"><p class="tableblock">getter:S | getter:T</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock">getter:S</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">-</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">getter:S|T</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">-</p></td>
+</tr>
+<tr>
+<th class="tableblock halign-center valign-top"><p class="tableblock">setter:S | setter:T</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock">-</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">setter:S</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">-</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">setter:S&amp;T</p></td>
+</tr>
+<tr>
+<th class="tableblock halign-center valign-top"><p class="tableblock">field:S  | getter:T</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock">getter:S</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">-</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">getter:S|T</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">-</p></td>
+</tr>
+<tr>
+<th class="tableblock halign-center valign-top"><p class="tableblock">field:S  | setter:T</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock">-</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">setter:S</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">-</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">setter:S&amp;T</p></td>
+</tr>
+<tr>
+<th class="tableblock halign-center valign-top"><p class="tableblock">getter:S | setter:T</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock">-</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">-</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">-</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">-</p></td>
+</tr>
+</tbody>
+</table>
+<div class="sect5">
+<h6 id="_remarks-on-union-type-s-members"><a class="anchor" href="#_remarks-on-union-type-s-members"></a><a class="link" href="#_remarks-on-union-type-s-members">4.10.4.1.1. Remarks on union type’s members:</a></h6>
+<div class="ulist">
+<ul>
+<li>
+<p>Fields of the same type are merged to a composed field with the same type.
+Fields of different types are merged to a getter and setter.</p>
+</li>
+<li>
+<p>The return type of a composed getter is the <em>union</em> type of the return types of the merged getters.</p>
+</li>
+<li>
+<p>The type of a composed setter is the <em>intersection</em> type of the types of the merged setters.</p>
+</li>
+<li>
+<p>Fields can be combined with getters and/or setters:</p>
+<div class="ulist">
+<ul>
+<li>
+<p>fields combined with getters allow read-access.</p>
+</li>
+<li>
+<p>non-const fields combined with setters allow write-access.</p>
+</li>
+<li>
+<p>non-const fields combined with getters <em>and</em> setters, i.e. each type has either a non-const field or both a getter and a setter of the given name, allow both read- and write-access.</p>
+<div class="paragraph">
+<p>Again, types need not be identical; for read-access the <em>union</em> of the fields’ types and the getters’ return types is formed, for write-access the <em>intersection</em> of the fields’ types and the setters’ types is formed.
+In the third case above, types are combined independently for read- and write-access if the getters and setters have different types.</p>
+</div>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>The name of a method’s parameter is only used for error or warning messages and cannot be referenced otherwise.</p>
+</li>
+<li>
+<p>The return type of a composed method is the <em>union</em> type of the return types of the merged methods.</p>
+</li>
+<li>
+<p>A composed method parameter’s type is the <em>intersection</em> type of the merged parameters types.</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_properties-of-intersection-type"><a class="anchor" href="#_properties-of-intersection-type"></a><a class="link" href="#_properties-of-intersection-type">4.10.4.2. Properties of Intersection Type</a></h5>
+<div class="paragraph">
+<p>As an (oversimplified) rule of thumb, the properties of an intersection type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>I</mi><mo>=</mo><msub><mi>T</mi><mn>1</mn></msub><mi>&amp;</mi><msub><mi>T</mi><mn>2</mn></msub></math> are the union of properties <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>I</mi><mo>.</mo><mi>p</mi><mi>r</mi><mi>o</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>t</mi><mi>i</mi><mi>e</mi><mi>s</mi><mo>=</mo><msub><mi>T</mi><mn>1</mn></msub><mo>.</mo><mi>p</mi><mi>r</mi><mi>o</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>t</mi><mi>i</mi><mi>e</mi><mi>s</mi><mo>∪</mo><msub><mi>T</mi><mn>2</mn></msub><mo>.</mo><mi>p</mi><mi>r</mi><mi>o</mi><mi>p</mi><mi>e</mi><mi>r</mi><mi>t</mi><mi>i</mi><mi>e</mi><mi>s</mi></math>.
+In other words, a property 'p' in the union type is the greates common denominator of all 'p' in T_{1} and T_{2}.
+It is not quite that simple, however, as the question of "equality” with regards to properties has to be answered.</p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-36"></a><strong>Req. IDE-36:</strong> <a href="#Req-IDE-36">Members of an Intersection Type</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>For a given intersection type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>I</mi><mo>=</mo><msub><mi>T</mi><mn>1</mn></msub><mi>&amp;</mi><msub><mi>T</mi><mn>2</mn></msub></math>, the following constraints for its members must hold:</p>
+</div>
+<div class="paragraph">
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∀</mo><mi>a</mi><mo>∈</mo><mi>I</mi><mo>.</mo><mi>a</mi><mi>t</mi><mi>t</mi><mi>r</mi><mi>i</mi><mi>b</mi><mi>u</mi><mi>t</mi><mi>e</mi><mi>s</mi><mi>:</mi></math></p>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mtable><mtr><mtd/><mtd><mrow><mo>(</mo><mrow><mo>∃</mo><msub><mi>a</mi><mn>1</mn></msub><mo>∈</mo><msub><mi>T</mi><mn>1</mn></msub><mo>.</mo><mi>a</mi><mi>t</mi><mi>t</mi><mi>r</mi><mi>i</mi><mi>b</mi><mi>u</mi><mi>t</mi><mi>e</mi><mi>s</mi><mo>,</mo><msub><mi>a</mi><mn>1</mn></msub><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mo>&gt;</mo><mi>p</mi><mi>r</mi><mi>i</mi><mi>v</mi><mi>a</mi><mi>t</mi><mi>e</mi><mo>)</mo></mrow><mo>∨</mo><mrow><mo>(</mo><mrow><mo>∃</mo><msub><mi>a</mi><mn>2</mn></msub><mo>∈</mo><msub><mi>T</mi><mn>2</mn></msub><mo>.</mo><mi>a</mi><mi>t</mi><mi>t</mi><mi>r</mi><mi>i</mi><mi>b</mi><mi>u</mi><mi>t</mi><mi>e</mi><mi>s</mi><mo>,</mo><msub><mi>a</mi><mn>2</mn></msub><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mo>&gt;</mo><mi>p</mi><mi>r</mi><mi>i</mi><mi>v</mi><mi>a</mi><mi>t</mi><mi>e</mi><mo>)</mo></mrow></mrow></mrow></mtd></mtr><mtr><mtd/><mtd><mo>∧</mo><mi>a</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><mfenced close="" open="{"><mtable><mtr><mtd><msub><mi>a</mi><mn>1</mn></msub><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi></mtd><mtd><msub><mi>a</mi><mn>1</mn></msub><mo>≠</mo><mi>n</mi><mi>u</mi><mi>l</mi><mi>l</mi><mo>∧</mo><mfenced close=")" open="("><mrow><msub><mi>a</mi><mn>2</mn></msub><mo>=</mo><mi>n</mi><mi>u</mi><mi>l</mi><mi>l</mi><mo>∨</mo><msub><mi>a</mi><mn>2</mn></msub><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><msub><mi>a</mi><mn>1</mn></msub><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi></mrow></mfenced></mtd></mtr><mtr><mtd><msub><mi>a</mi><mn>2</mn></msub><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi></mtd><mtd><mstyle mathvariant="bold"><mi>e</mi><mi>l</mi><mi>s</mi><mi>e</mi></mstyle></mtd></mtr></mtable></mfenced></mtd></mtr><mtr><mtd/><mtd><mo>∧</mo><mi>a</mi><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mo>=</mo><mfenced close="" open="{"><mtable><mtr><mtd><msub><mi>a</mi><mn>1</mn></msub><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi></mtd><mtd><msub><mi>a</mi><mn>1</mn></msub><mo>≠</mo><mi>n</mi><mi>u</mi><mi>l</mi><mi>l</mi><mo>∧</mo><mfenced close=")" open="("><mrow><msub><mi>a</mi><mn>2</mn></msub><mo>=</mo><mi>n</mi><mi>u</mi><mi>l</mi><mi>l</mi><mo>∨</mo><msub><mi>a</mi><mn>2</mn></msub><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mo>≤</mo><msub><mi>a</mi><mn>1</mn></msub><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi></mrow></mfenced></mtd></mtr><mtr><mtd><msub><mi>a</mi><mn>2</mn></msub><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi></mtd><mtd><mstyle mathvariant="bold"><mi>e</mi><mi>l</mi><mi>s</mi><mi>e</mi></mstyle></mtd></mtr></mtable></mfenced></mtd></mtr><mtr><mtd/><mtd><mo>∧</mo><mi>a</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mo>=</mo><mfenced close="" open="{"><mtable><mtr><mtd><msub><mi>a</mi><mn>1</mn></msub><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mi>&amp;</mi><msub><mi>a</mi><mn>2</mn></msub><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi></mtd><mtd><msub><mi>a</mi><mn>1</mn></msub><mo>≠</mo><mi>n</mi><mi>u</mi><mi>l</mi><mi>l</mi><mo>∧</mo><msub><mi>a</mi><mn>2</mn></msub><mo>≠</mo><mi>n</mi><mi>u</mi><mi>l</mi><mi>l</mi></mtd></mtr><mtr><mtd><msub><mi>a</mi><mn>1</mn></msub><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi></mtd><mtd><msub><mi>a</mi><mn>1</mn></msub><mo>≠</mo><mi>n</mi><mi>u</mi><mi>l</mi><mi>l</mi></mtd></mtr><mtr><mtd><msub><mi>a</mi><mn>2</mn></msub><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi></mtd><mtd><mstyle mathvariant="bold"><mi>e</mi><mi>l</mi><mi>s</mi><mi>e</mi></mstyle><mfenced close=")" open="("><mrow><msub><mi>a</mi><mn>2</mn></msub><mo>≠</mo><mi>n</mi><mi>u</mi><mi>l</mi><mi>l</mi></mrow></mfenced></mtd></mtr></mtable></mfenced></mtd></mtr></mtable></math>
+</div>
+</div>
+<div style="page-break-after: always;"></div>
+<div class="paragraph">
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∀</mo><mi>m</mi><mo>∈</mo><mi>I</mi><mo>.</mo><mi>m</mi><mi>e</mi><mi>t</mi><mi>h</mi><mi>o</mi><mi>d</mi><mi>s</mi></math>:</p>
+</div>
+<div class="paragraph">
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mrow><mo>(</mo><mrow><mo>∃</mo><msub><mi>m</mi><mn>1</mn></msub><mo>∈</mo><msub><mi>T</mi><mn>1</mn></msub><mo>.</mo><mi>m</mi><mi>e</mi><mi>t</mi><mi>h</mi><mi>o</mi><mi>d</mi><mi>s</mi><mo>,</mo><msub><mi>m</mi><mn>1</mn></msub><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mo>&gt;</mo><mi>p</mi><mi>r</mi><mi>i</mi><mi>v</mi><mi>a</mi><mi>t</mi><mi>e</mi><mo>)</mo></mrow><mo>∨</mo><mrow><mo>(</mo><mrow><mo>∃</mo><msub><mi>m</mi><mn>2</mn></msub><mo>∈</mo><msub><mi>T</mi><mn>1</mn></msub><mo>.</mo><mi>m</mi><mi>e</mi><mi>t</mi><mi>h</mi><mi>o</mi><mi>d</mi><mi>s</mi><mo>,</mo><msub><mi>m</mi><mn>2</mn></msub><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mo>&gt;</mo><mi>p</mi><mi>r</mi><mi>i</mi><mi>v</mi><mi>a</mi><mi>t</mi><mi>e</mi><mo>)</mo></mrow><mi>:</mi></mrow></mrow></math></p>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mtable><mtr><mtd/><mtd><mspace width="2.0em"/><mstyle mathvariant="bold"><mi>w</mi><mi>i</mi><mi>t</mi><mi>h</mi></mstyle><mi>p</mi><mo>=</mo><mi>m</mi><mo>.</mo><mi>f</mi><mi>p</mi><mi>a</mi><mi>r</mi><mi>s</mi></mtd></mtr><mtr><mtd/><mtd><mspace width="3.0em"/><mo>∧</mo><mstyle mathvariant="bold"><mi>i</mi><mi>f</mi></mstyle><mi> </mi><msub><mi>m</mi><mn>1</mn></msub><mi> </mi><mstyle mathvariant="bold"><mi>e</mi><mi>x</mi><mi>i</mi><mi>s</mi><mi>t</mi><mi>s</mi></mstyle><mi> </mi><msup><mi>p</mi><mi>'</mi></msup><mo>=</mo><msub><mi>m</mi><mn>1</mn></msub><mo>.</mo><mi>f</mi><mi>p</mi><mi>a</mi><mi>r</mi><mi>s</mi><mi> </mi><mstyle mathvariant="bold"><mfenced close=")" open="("><mrow><mi>e</mi><mi>l</mi><mi>s</mi><mi>e</mi><msup><mi>p</mi><mi>'</mi></msup><mo>=</mo><mi>∅</mi></mrow></mfenced></mstyle><mo>,</mo></mtd></mtr><mtr><mtd/><mtd><mspace width="3.0em"/><mo>∧</mo><mstyle mathvariant="bold"><mi>i</mi><mi>f</mi></mstyle><mi> </mi><msub><mi>m</mi><mn>2</mn></msub><mi> </mi><mstyle mathvariant="bold"><mi>e</mi><mi>x</mi><mi>i</mi><mi>s</mi><mi>t</mi><mi>s</mi></mstyle><mi> </mi><mi>p</mi><mi>"</mi><mo>=</mo><msub><mi>m</mi><mn>2</mn></msub><mo>.</mo><mi>f</mi><mi>p</mi><mi>a</mi><mi>r</mi><mi>s</mi><mi> </mi><mstyle mathvariant="bold"><mfenced close=")" open="("><mrow><mi>e</mi><mi>l</mi><mi>s</mi><mi>e</mi><mi>p</mi><mi>"</mi><mo>=</mo><mi>∅</mi></mrow></mfenced></mstyle><mo>,</mo><mstyle mathvariant="bold"><mstyle mathvariant="bold"><mi>W</mi><mi>L</mi><mi>O</mi><mi>G</mi></mstyle></mstyle><mo>|</mo><msup><mi>p</mi><mi>'</mi></msup><mo>|</mo><mo>≤</mo><mo>|</mo><mi>p</mi><mi>"</mi><mo>|</mo><mi>:</mi></mtd></mtr><mtr><mtd/><mtd><mspace width="1.0em"/><mi>m</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><mfenced close="" open="{"><mtable><mtr><mtd><msub><mi>m</mi><mn>1</mn></msub><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi></mtd><mtd><msub><mi>m</mi><mn>1</mn></msub><mo>≠</mo><mi>n</mi><mi>u</mi><mi>l</mi><mi>l</mi><mo>∧</mo><mfenced close=")" open="("><mrow><msub><mi>m</mi><mn>2</mn></msub><mo>=</mo><mi>n</mi><mi>u</mi><mi>l</mi><mi>l</mi><mo>∨</mo><msub><mi>m</mi><mn>2</mn></msub><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><msub><mi>m</mi><mn>1</mn></msub><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi></mrow></mfenced></mtd></mtr><mtr><mtd><msub><mi>m</mi><mn>2</mn></msub><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi></mtd><mtd><mstyle mathvariant="bold"><mi>e</mi><mi>l</mi><mi>s</mi><mi>e</mi></mstyle></mtd></mtr></mtable></mfenced></mtd></mtr><mtr><mtd/><mtd><mo>∧</mo><mi>m</mi><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mo>=</mo><mfenced close="" open="{"><mtable><mtr><mtd><msub><mi>m</mi><mn>1</mn></msub><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi></mtd><mtd><msub><mi>m</mi><mn>1</mn></msub><mo>≠</mo><mi>n</mi><mi>u</mi><mi>l</mi><mi>l</mi><mo>∧</mo><mfenced close=")" open="("><mrow><msub><mi>m</mi><mn>2</mn></msub><mo>=</mo><mi>n</mi><mi>u</mi><mi>l</mi><mi>l</mi><mo>∨</mo><msub><mi>m</mi><mn>2</mn></msub><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi><mo>≤</mo><msub><mi>m</mi><mn>1</mn></msub><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi></mrow></mfenced></mtd></mtr><mtr><mtd><msub><mi>m</mi><mn>2</mn></msub><mo>.</mo><mi>a</mi><mi>c</mi><mi>c</mi></mtd><mtd><mstyle mathvariant="bold"><mi>e</mi><mi>l</mi><mi>s</mi><mi>e</mi></mstyle></mtd></mtr></mtable></mfenced></mtd></mtr><mtr><mtd/><mtd><mo>∧</mo><mi>m</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mo>=</mo><mfenced close="" open="{"><mtable><mtr><mtd><msub><mi>m</mi><mn>1</mn></msub><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mi>&amp;</mi><msub><mi>m</mi><mn>2</mn></msub><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi></mtd><mtd><msub><mi>m</mi><mn>1</mn></msub><mo>≠</mo><mi>n</mi><mi>u</mi><mi>l</mi><mi>l</mi><mo>∧</mo><msub><mi>m</mi><mn>2</mn></msub><mo>≠</mo><mi>n</mi><mi>u</mi><mi>l</mi><mi>l</mi></mtd></mtr><mtr><mtd><msub><mi>m</mi><mn>1</mn></msub><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi></mtd><mtd><msub><mi>m</mi><mn>1</mn></msub><mo>≠</mo><mi>n</mi><mi>u</mi><mi>l</mi><mi>l</mi></mtd></mtr><mtr><mtd><msub><mi>m</mi><mn>2</mn></msub><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi></mtd><mtd><mstyle mathvariant="bold"><mi>e</mi><mi>l</mi><mi>s</mi><mi>e</mi></mstyle><mfenced close=")" open="("><mrow><msub><mi>m</mi><mn>2</mn></msub><mo>≠</mo><mi>n</mi><mi>u</mi><mi>l</mi><mi>l</mi></mrow></mfenced></mtd></mtr></mtable></mfenced></mtd></mtr><mtr><mtd/><mtd><mo>∧</mo><mo>∀</mo><mi> </mi><mi>i</mi><mo>&lt;</mo><mo>|</mo><mi>p</mi><mi>"</mi><mo>|</mo><mi>:</mi><msub><mi>p</mi><mi>i</mi></msub><mi> </mi><mstyle mathvariant="bold"><mi>e</mi><mi>x</mi><mi>i</mi><mi>s</mi><mi>t</mi><mi>s</mi><mi>w</mi><mi>i</mi><mi>t</mi><mi>h</mi></mstyle></mtd></mtr><mtr><mtd/><mtd><mspace width="2.0em"/><msub><mi>p</mi><mi>i</mi></msub><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><mfenced close="" open="{"><mtable><mtr><mtd><msub><mrow><mi>p</mi><mi>"</mi></mrow><mi>i</mi></msub><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi></mtd><mtd><mi>i</mi><mo>≥</mo><mo>|</mo><msup><mi>p</mi><mi>'</mi></msup><mo>|</mo><mo>∨</mo><msub><mrow><mi>p</mi><mi>"</mi></mrow><mi>i</mi></msub><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><msub><msup><mi>p</mi><mi>'</mi></msup><mi>i</mi></msub><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi></mtd></mtr><mtr><mtd><msub><msup><mi>p</mi><mi>'</mi></msup><mi>i</mi></msub><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>+</mo><mstyle mathvariant="bold"><mi>"</mi><mi>_</mi><mi>"</mi></mstyle><mo>+</mo><msub><mrow><mi>p</mi><mi>"</mi></mrow><mi>i</mi></msub><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi></mtd><mtd><mstyle mathvariant="bold"><mi>e</mi><mi>l</mi><mi>s</mi><mi>e</mi></mstyle></mtd></mtr></mtable></mfenced></mtd></mtr><mtr><mtd/><mtd><mspace width="2.0em"/><msub><mi>p</mi><mi>i</mi></msub><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mo>=</mo><mfenced close="" open="{"><mtable><mtr><mtd><msub><msup><mi>p</mi><mi>'</mi></msup><mi>i</mi></msub><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mo>|</mo><msub><mrow><mi>p</mi><mi>"</mi></mrow><mi>i</mi></msub><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi></mtd><mtd><mi>i</mi><mo>&lt;</mo><mo>|</mo><msup><mi>p</mi><mi>'</mi></msup><mo>|</mo></mtd></mtr><mtr><mtd><msub><msup><mi>p</mi><mi>'</mi></msup><mrow><mo>|</mo><msup><mi>p</mi><mi>'</mi></msup><mo>|</mo><mo>-</mo><mn>1</mn></mrow></msub><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mo>|</mo><msub><mrow><mi>p</mi><mi>"</mi></mrow><mi>i</mi></msub><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi></mtd><mtd><mi>i</mi><mo>≥</mo><mo>|</mo><msup><mi>p</mi><mi>'</mi></msup><mo>|</mo><mo>∧</mo><msub><msup><mi>p</mi><mi>'</mi></msup><mrow><mo>|</mo><msup><mi>p</mi><mi>'</mi></msup><mo>|</mo><mo>-</mo><mn>1</mn></mrow></msub><mo>.</mo><mi>v</mi><mi>a</mi><mi>r</mi></mtd></mtr><mtr><mtd><msub><mrow><mi>p</mi><mi>"</mi></mrow><mi>i</mi></msub><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi></mtd><mtd><mstyle mathvariant="bold"><mi>e</mi><mi>l</mi><mi>s</mi><mi>e</mi></mstyle></mtd></mtr></mtable></mfenced></mtd></mtr><mtr><mtd/><mtd><mspace width="2.0em"/><msub><mi>p</mi><mi>i</mi></msub><mo>.</mo><mi>o</mi><mi>p</mi><mi>t</mi><mo>=</mo><mfenced close=")" open="("><mrow><mo>∃</mo><mi>k</mi><mo>≤</mo><mi>m</mi><mi>i</mi><mi>n</mi><mfenced close=")" open="("><mrow><mo>|</mo><msup><mi>p</mi><mi>'</mi></msup><mo>|</mo><mo>-</mo><mn>1</mn></mrow><mi>i</mi></mfenced><mi>:</mi><mi>p</mi><msub><mi>'</mi><mi>k</mi></msub><mo>.</mo><mi>o</mi><mi>p</mi><mi>t</mi></mrow></mfenced><mo>∨</mo><mfenced close=")" open="("><mrow><mo>∃</mo><mi>k</mi><mo>≤</mo><mi>i</mi><mi>:</mi><mi>p</mi><msub><mi>"</mi><mi>k</mi></msub><mo>.</mo><mi>o</mi><mi>p</mi><mi>t</mi></mrow></mfenced></mtd></mtr><mtr><mtd/><mtd><mspace width="2.0em"/><msub><mi>p</mi><mi>i</mi></msub><mo>.</mo><mi>v</mi><mi>a</mi><mi>r</mi><mo>=</mo><mfenced close="" open="{"><mtable><mtr><mtd><msub><mi>p</mi><mi>i</mi></msub><mo>.</mo><mi>o</mi><mi>p</mi><mi>t</mi><mo>∨</mo><mfenced close=")" open="("><mrow><msub><msup><mi>p</mi><mi>'</mi></msup><mi>i</mi></msub><mo>.</mo><mi>v</mi><mi>a</mi><mi>r</mi><mo>∨</mo><msub><mrow><mi>p</mi><mi>"</mi></mrow><mi>i</mi></msub><mo>.</mo><mi>v</mi><mi>a</mi><mi>r</mi></mrow></mfenced></mtd><mtd><mi>i</mi><mo>&lt;</mo><mo>|</mo><msup><mi>p</mi><mi>'</mi></msup><mo>|</mo><mo>∧</mo><mi>i</mi><mo>=</mo><mo>|</mo><mi>p</mi><mi>"</mi><mo>|</mo><mo>-</mo><mn>1</mn></mtd></mtr><mtr><mtd><msub><mrow><mi>p</mi><mi>"</mi></mrow><mi>i</mi></msub><mo>.</mo><mi>v</mi><mi>a</mi><mi>r</mi></mtd><mtd><mi>i</mi><mo>≥</mo><mo>|</mo><msup><mi>p</mi><mi>'</mi></msup><mo>|</mo><mo>∧</mo><mi>i</mi><mo>=</mo><mo>|</mo><mi>p</mi><mi>"</mi><mo>|</mo><mo>-</mo><mn>1</mn></mtd></mtr><mtr><mtd><mi>f</mi><mi>a</mi><mi>l</mi><mi>s</mi><mi>e</mi></mtd><mtd><mstyle mathvariant="bold"><mi>e</mi><mi>l</mi><mi>s</mi><mi>e</mi></mstyle></mtd></mtr></mtable></mfenced></mtd></mtr></mtable></math>
+</div>
+</div>
+<div class="paragraph">
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∧</mo><mrow><mo>(</mo><mi>l</mi><mo>=</mo><mo>|</mo><msup><mi>p</mi><mi>'</mi></msup><mo>|</mo><mo>=</mo><mo>|</mo><mi>p</mi><mi>"</mi><mo>|</mo><mo>∧</mo><mi>l</mi><mo>&gt;</mo><mn>0</mn><mo>∧</mo><mo>¬</mo><mfenced close=")" open="("><mrow><msub><mi>p</mi><mrow><mi>l</mi><mo>-</mo><mn>1</mn></mrow></msub><mo>.</mo><mi>o</mi><mi>p</mi><mi>t</mi></mrow></mfenced><mo>∧</mo><mo>∃</mo><mi>v</mi><mo>∈</mo><mfenced close="}" open="{"><mrow><mi>p</mi><msub><mi>'</mi><mrow><mi>l</mi><mo>-</mo><mn>1</mn></mrow></msub></mrow><mrow><mi>p</mi><msub><mi>"</mi><mrow><mi>l</mi><mo>-</mo><mn>1</mn></mrow></msub></mrow></mfenced><mi>v</mi><mo>.</mo><mi>v</mi><mi>a</mi><mi>r</mi><mi>:</mi><msub><mi>p</mi><mi>l</mi></msub><mi> </mi><mstyle mathvariant="bold"><mi>e</mi><mi>x</mi><mi>i</mi><mi>s</mi><mi>t</mi><mi>s</mi></mstyle><mspace width="1.0mm"/><mstyle mathvariant="bold"><mi>w</mi><mi>i</mi><mi>t</mi><mi>h</mi></mstyle></mrow></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="2.0em"/><msub><mi>p</mi><mi>l</mi></msub><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><mi>v</mi><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="2.0em"/><msub><mi>p</mi><mi>i</mi></msub><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi><mo>=</mo><mi>v</mi><mo>.</mo><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mi>R</mi><mi>e</mi><mi>f</mi></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="2.0em"/><msub><mi>p</mi><mi>i</mi></msub><mo>.</mo><mi>o</mi><mi>p</mi><mi>t</mi><mo>=</mo><mi>t</mi><mi>r</mi><mi>u</mi><mi>e</mi></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mspace width="2.0em"/><msub><mi>p</mi><mi>i</mi></msub><mo>.</mo><mi>v</mi><mi>a</mi><mi>r</mi><mo>=</mo><mi>t</mi><mi>r</mi><mi>u</mi><mi>e</mi></math></p>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>The following table shows how non-method members of intersection types are merged.
+The resulting member type depends on whether the member is being accessed during a read (R) or write (W) operation.
+The type of a field, of a getter or of the parameter of a setter is indicated in brackets.</p>
+</div>
+<table class="tableblock frame-all grid-all spread">
+<caption class="title">Table 5. Merged Members of Intersections</caption>
+<colgroup>
+<col style="width: 20%;">
+<col style="width: 20%;">
+<col style="width: 20%;">
+<col style="width: 20%;">
+<col style="width: 20%;">
+</colgroup>
+<thead>
+<tr>
+<th class="tableblock halign-center valign-top">Members</th>
+<th class="tableblock halign-center valign-top" colspan="2">S=T</th>
+<th class="tableblock halign-center valign-top" colspan="2">S≠T</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<th class="tableblock halign-center valign-top"></th>
+<th class="tableblock halign-center valign-top"><p class="tableblock">R</p></th>
+<th class="tableblock halign-center valign-top"><p class="tableblock">W</p></th>
+<th class="tableblock halign-center valign-top"><p class="tableblock">R</p></th>
+<th class="tableblock halign-center valign-top"><p class="tableblock">W</p></th>
+</tr>
+<tr>
+<th class="tableblock halign-center valign-top"><p class="tableblock">field:S   &amp; field:T</p></th>
+<td class="tableblock halign-center valign-top" colspan="2"><p class="tableblock">field:S</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">getter:S&amp;T</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">setter:S|T</p></td>
+</tr>
+<tr>
+<th class="tableblock halign-center valign-top"><p class="tableblock">getter:S  &amp; getter:T</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock">getter:S</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">-</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">getter:S&amp;T</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">-</p></td>
+</tr>
+<tr>
+<th class="tableblock halign-center valign-top"><p class="tableblock">setter:S  &amp; setter:T</p></th>
+<td class="tableblock halign-center valign-top"><p class="tableblock">-</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">setter:S</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">-</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">setter:S|T</p></td>
+</tr>
+<tr>
+<th class="tableblock halign-center valign-top"><p class="tableblock">field:S   &amp; getter:T</p></th>
+<td class="tableblock halign-center valign-top" colspan="2"><p class="tableblock">field:S</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">getter:S&amp;T</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">setter:S</p></td>
+</tr>
+<tr>
+<th class="tableblock halign-center valign-top"><p class="tableblock">field:S   &amp; setter:T</p></th>
+<td class="tableblock halign-center valign-top" colspan="2"><p class="tableblock">field:S</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">getter:S</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">setter:S|T</p></td>
+</tr>
+<tr>
+<th class="tableblock halign-center valign-top"><p class="tableblock">getter:S  &amp; setter:T</p></th>
+<td class="tableblock halign-center valign-top" colspan="2"><p class="tableblock">field:S</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">getter:S</p></td>
+<td class="tableblock halign-center valign-top"><p class="tableblock">setter:T</p></td>
+</tr>
+</tbody>
+</table>
+<div class="sect5">
+<h6 id="_remarks-on-intersection-type-s-methods"><a class="anchor" href="#_remarks-on-intersection-type-s-methods"></a><a class="link" href="#_remarks-on-intersection-type-s-methods">4.10.4.2.1. Remarks on intersection type’s methods:</a></h6>
+<div class="ulist">
+<ul>
+<li>
+<p>The name of a method’s parameter is only used for error or warning messages and cannot be referenced otherwise.</p>
+</li>
+<li>
+<p>The return type of a method is the <em>intersection</em> type of the return types of the merged methods.</p>
+</li>
+<li>
+<p>A method parameter’s type is the <em>union</em> type of the merged parameters types.</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="_constructor-and-classifier-type"><a class="anchor" href="#_constructor-and-classifier-type"></a><a class="link" href="#_constructor-and-classifier-type">4.11. Constructor and Classifier Type</a></h3>
+<div class="paragraph">
+<p>A class definition as described in <a href="classifiers.html#_classes">Classes</a> declares types.
+Often, it is necessary to access these types directly, for example to access staticmembers or for dynamic construction of instances.
+These two use cases are actually slightly different and N4JS provides two different types, one for each use case: constructor and classifier type.<sup class="footnote">[<a id="_footnoteref_25" class="footnote" href="appendix_c_bibliography.html#_footnote_25" title="View footnote.">25</a>]</sup>
+The constructor is basically the classifier type with the additional possibility to call it via <code>new</code> in order to create new instances of the declared type.</p>
+</div>
+<div class="paragraph">
+<p>Both <code>meta</code> types are different from Java’s type <code>Class&lt;T&gt;</code>, as the latter has a defined set of members, while the N4JS metatypes will have members according to a class definition.
+The concept of constructors as metatypes is similar to ECMAScript 2015 [<a href="appendix_c_bibliography.html#ECMA15a">ECMA15a(p.14.5)</a>].</p>
+</div>
+<div class="sect3">
+<h4 id="_syntax-3"><a class="anchor" href="#_syntax-3"></a><a class="link" href="#_syntax-3">4.11.1. Syntax</a></h4>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">ConstructorTypeRef returns ConstructorTypeRef: 'constructor' '{' typeArg = [TypeArgument] '}';
+
+ClassifierTypeRef returns ClassifierTypeRef: 'type' '{' typeArg = [TypeRef] '}';</code></pre>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_semantics-2"><a class="anchor" href="#_semantics-2"></a><a class="link" href="#_semantics-2">4.11.2. Semantics</a></h4>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Static members of a type <em>T</em> are actually members of the classifier type <code>type{T}</code>.</p>
+</li>
+<li>
+<p>The keyword <code>this</code> in a static method of a type <em>T</em> actually binds to the classifier type <code>type{T}</code>.</p>
+</li>
+<li>
+<p>The constructor type <code>constructor</code><em>{T}</em> is a subtype of the classifier type <code>type{T}</code>:</p>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mo>∀</mo><mi>T</mi><mi>:</mi><mi>c</mi><mi>o</mi><mi>n</mi><mi>s</mi><mi>t</mi><mi>r</mi><mi>u</mi><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi><mfenced close="}" open="{"><mi>T</mi></mfenced><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mfenced close="}" open="{"><mi>T</mi></mfenced></math>
+</div>
+</div>
+</li>
+<li>
+<p>If a class <em>B</em> is a subtype (subclass) of a class <em>A</em>, then the classifier type <code>type{B}</code> also is a subtype of <code>type{A}</code>:</p>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><mi>B</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>A</mi></mrow><mrow><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mfenced close="}" open="{"><mi>B</mi></mfenced><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi><mfenced close="}" open="{"><mi>A</mi></mfenced></mrow></mfrac></math>
+</div>
+</div>
+</li>
+<li>
+<p>If a class <em>B</em> is a subtype (subclass) of a class <em>A</em>, and if the constructor function of <em>B</em> is a subtype of the constructor function of <em>A</em>, then the
+classifier type <code>constructor{B}</code> also is a subtype of <code>constructor{A}</code> :</p>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><mi>B</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>A</mi><mspace width="3.0mm"/><mi>B</mi><mo>.</mo><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>A</mi><mo>.</mo><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi></mrow><mrow><mi>c</mi><mi>o</mi><mi>n</mi><mi>s</mi><mi>t</mi><mi>r</mi><mi>u</mi><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi><mfenced close="}" open="{"><mi>B</mi></mfenced><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>c</mi><mi>o</mi><mi>n</mi><mi>s</mi><mi>t</mi><mi>r</mi><mi>u</mi><mi>c</mi><mi>t</mi><mi>o</mi><mi>r</mi><mfenced close="}" open="{"><mi>A</mi></mfenced></mrow></mfrac></math>
+</div>
+</div>
+<div class="paragraph">
+<p>The subtype relation of the constructor function is defined in <a href="functions.html#_function-type">Function Type</a>.
+In the case of the default <code>N4Object</code> constructor, the type of the object literal argument depends on required attributes.</p>
+</div>
+<div class="paragraph">
+<p>This subtype relation for the constructor type is enforced if the constructor of the super class is marked as <code>final</code>, see <a href="#_constructor-and-classifier-type">Constructor and Classifier Type</a> for details.</p>
+</div>
+</li>
+<li>
+<p>The type of a classifier declaration or classifier expression is the constructor of that class:</p>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><mi>μ</mi><mfenced close=")" open="("><mi>C</mi></mfenced><mo>∈</mo><mfenced close="}" open="{"><mrow><mi>c</mi><mi>l</mi><mi>a</mi><mi>s</mi><mi>s</mi><mi>i</mi><mi>f</mi><mi>i</mi><mi>e</mi><mi>r</mi><mi>D</mi><mi>e</mi><mi>f</mi><mi>i</mi><mi>n</mi><mi>i</mi><mi>t</mi><mi>i</mi><mi>o</mi><mi>n</mi></mrow></mfenced></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mi>C</mi><mi>:</mi><mstyle mathvariant="monospace"><mtext>constructor[C]</mtext></mstyle></mrow></mfrac></math>
+</div>
+</div>
+</li>
+<li>
+<p>A class cannot be called as a function in ECMAScript.
+Thus, the constructor and type type are only subtype of <code>Object</code>:</p>
+<div class="paragraph">
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∀</mo><mi>T</mi><mi>:</mi></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mstyle mathvariant="monospace"><mtext>constructor</mtext></mstyle><mfenced close="}" open="{"><mstyle mathvariant="monospace"><mtext>T</mtext></mstyle></mfenced><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mstyle mathvariant="monospace"><mtext>Object</mtext></mstyle></math><br>
+<math xmlns="http://www.w3.org/1998/Math/MathML"><mstyle mathvariant="monospace"><mtext>type</mtext></mstyle><mfenced close="}" open="{"><mstyle mathvariant="monospace"><mtext>T</mtext></mstyle></mfenced><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mstyle mathvariant="monospace"><mtext>Object</mtext></mstyle></math></p>
+</div>
+</li>
+<li>
+<p>If the type argument of the constructor is not a declared type (i.e., a wildcard or a type variable with bounds), the constructor cannot be used in a new expression.
+Thus, the constructor function signature becomes irrelevant for subtype checking.
+In that case, the following rules apply:</p>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mtable><mtr><mtd><mfrac><mrow><mi>S</mi><mo>.</mo><mi>u</mi><mi>p</mi><mi>p</mi><mi>e</mi><mi>r</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>T</mi><mo>.</mo><mi>u</mi><mi>p</mi><mi>p</mi><mi>e</mi><mi>r</mi><mspace width="3.0mm"/><mi>T</mi><mo>.</mo><mi>l</mi><mi>o</mi><mi>w</mi><mi>e</mi><mi>r</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>S</mi><mo>.</mo><mi>l</mi><mi>o</mi><mi>w</mi><mi>e</mi><mi>r</mi><mspace width="3.0mm"/><mi>μ</mi><mfenced close=")" open="("><mi>T</mi></mfenced><mo>≠</mo><mstyle mathvariant="monospace"><mtext>DeclaredTypeWithAccessModifier</mtext></mstyle></mrow><mrow><mstyle mathvariant="monospace"><mtext>constructor</mtext><mtext>S</mtext></mstyle><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mstyle mathvariant="monospace"><mtext>constructor</mtext><mtext>T</mtext></mstyle></mrow></mfrac></mtd></mtr></mtable></math>
+</div>
+</div>
+<div class="paragraph">
+<p>Note that this is only true for the right hand side of the subtyping rule.
+A constructor type with a wildcard is never a subtype of a constructor type without a wildcard.</p>
+</div>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>The figure <a href="#cdConstructorClassifierType">Classifier and Constructor Type Subtype Relations</a> shows the subtype relations defined by the preceding rules.</p>
+</div>
+<div id="cdConstructorClassifierType" class="imageblock" style="text-align: center">
+<div class="content">
+<img src="chapters/04_types/fig/cdConstructorClassifierType.svg" alt="cdConstructorClassifierType">
+</div>
+<div class="title">Figure 4. Classifier and Constructor Type Subtype Relations</div>
+</div>
+<div class="paragraph">
+<p>Consequences:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Overriding of static methods is possible and by using the constructor or classifier type, polymorphism for static methods is possible as well.</p>
+<div id="_polymorphism-and-static-methods" class="exampleblock">
+<div class="title">Example 21. Static Polymorphism</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">class A {
+    static foo(): string { return "A"; }
+    static bar(): string { return this.foo(); }
+}
+class B extends A {
+    @Override
+    static foo(): string { return "B"; }
+}
+
+A.bar(); // will return "A"
+B.bar(); // will return "B", as foo() is called polymorphical</code></pre>
+</div>
+</div>
+</div>
+</div>
+</li>
+<li>
+<p>It is even possible to refer to the constructor of an abstract class.
+The abstract class itself cannot provide this constructor (it only provides a type..), that is to say only concrete subclasses can provide constructors compatible to the constructor.</p>
+<div class="exampleblock">
+<div class="title">Example 22. Constructor of Abstract Class</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">abstract class A {}
+class B extends A {}
+function f(ctor: constructor{A}): A { return new ctor(); }
+
+f(A); // not working: type{A} is not a subtype of constructor{A}.
+f(B); // ok</code></pre>
+</div>
+</div>
+</div>
+</div>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Allowing wildcards on constructor type references has pragmatic reasons.
+The usage of constructor references usually indicates very dynamic scenarios.
+In some of these scenarios, e.g., in case of dynamic creation of objects in the context of generic testing or injectors, arbitrary constructors may be used.
+Of course, it won’t be possible to check the correct new expression call in these cases – and using new expressions is prevented by N4JS if the constructor reference contains a wildcard.
+But other constraints, implemented by the client logic, may guarantee correct instantiation via more dynamic constructors, for example via the ECMAScript 2015 reflection API.
+In order to simplify these scenarios and preventing the use of <code>any</code>, wildcards are supported in constructors. Since a constructor with a wildcard cannot be used
+in a new expression anyway, using a classifier type is usually better than using a constructor type with wildcard.</p>
+</div>
+<div class="paragraph">
+<p>Using wildcards on classifier types would have the same meaning as using the upper bound directly.
+That is, a type reference <code>type{? extends C}</code> can simply be replaced with <code>type{c}</code>, and <code>type{?}</code> with <code>type{any}</code>.</p>
+</div>
+<div class="paragraph">
+<p>To conclude this chapter, let us compare the different types introduced above depending on whether they are used with wildcards or not:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>having a value of type <code>constructor{C}</code>, we know we have</p>
+<div class="ulist">
+<ul>
+<li>
+<p>a constructor function of <code>{C}</code> or a subclass of <code>{C}</code>,</p>
+</li>
+<li>
+<p>that can be used for instantiation (i.e. the represented class is not abstract),</p>
+</li>
+<li>
+<p>that has a signature compatible to the owned or inherited constructor of <code>{C}</code>.</p>
+<div class="paragraph">
+<p>This means we have the constructor function of class <code>{C}</code> (but only if is non-abstract) or the constructor function of any non-abstract
+subclass of <code>{C}</code> with an override compatible signature to that of <code>{C}</code>'s constructor function.</p>
+</div>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>having a value of type <code>constructor{? extends C}</code>, we know we have</p>
+<div class="ulist">
+<ul>
+<li>
+<p>a constructor function of <code>{C}</code> or a subclass of <code>{C}</code>,</p>
+</li>
+<li>
+<p>that can be used for instantiation (i.e. the represented class is not abstract).</p>
+<div class="paragraph">
+<p>So, same situation as before except that we know nothing about the constructor function’s signature.
+However, if <code>{C}</code> has a covariant constructor, cf. <a href="classifiers.html#_covariant-constructors">Covariant Constructors</a>, we can still conclude that we have an override compatible
+constructor function to that of <code>{C}</code>, because classes with covariant constructors enforce all their subclasses to have override compatible constructors.</p>
+</div>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>have a value of type <code>type{? extends C}</code> or <code>type{C}</code> (the two types are equivalent), we know we have:</p>
+<div class="ulist">
+<ul>
+<li>
+<p>an object representing a type (often constructor functions are used for this, e.g. in the case of classes, but could also be a plain object, e.g. in the case of interfaces),</p>
+</li>
+<li>
+<p>that represents type <code>{C}</code> or a subtype thereof,</p>
+</li>
+<li>
+<p>that cannot be used for instantiation (e.g. could be the constructor function of an abstract class, the object representing an interface, etc.).</p>
+</li>
+</ul>
+</div>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>Slightly simplified, we can say that in the first above case we can always use the value for creating an instance with <code>new</code>, in the second case only if the
+referenced type has a covariant constructor, cf. <a href="classifiers.html#_covariant-constructors">Covariant Constructors</a>, and never in the third case.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_constructors-and-prototypes-in-ecmascript-2015"><a class="anchor" href="#_constructors-and-prototypes-in-ecmascript-2015"></a><a class="link" href="#_constructors-and-prototypes-in-ecmascript-2015">4.11.3. Constructors and Prototypes in ECMAScript 2015</a></h4>
+<div class="paragraph">
+<p><a href="#fig-constructors-and-prototypes">Constructors and prototypes for two classes A and B in ECMAScript 2015 (not N4JS!)</a> for two classes A and B in ECMAScript 2015 shows the constructors, prototypes, and the relations between them for the ECMAScript 2015
+code shown in <a href="#ex-constructors-and-prototypes">Constructors and Prototypes</a>.</p>
+</div>
+<div id="ex-constructors-and-prototypes" class="exampleblock">
+<div class="title">Example 23. Constructors and Prototypes</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-javascript" data-lang="javascript">class A {}
+class B extends A {}
+
+var b = new B();</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title=""></i>
+</td>
+<td class="content">
+<a href="#fig-constructors-and-prototypes">Constructors and prototypes for two classes A and B in ECMAScript 2015 (not N4JS!)</a> shows plain ECMAScript 2015 only.
+Also note that <code>A</code> is defined without an <code>extends</code> clause, which is what ECMAScript 2015 calls a <em>base class</em> (as opposed to a <em>derived class</em>).
+The constructor of a base class always has Function.prototype as its prototype.
+If we had defined <code>A</code> as <code>class A extends Object {}</code> in the listing above, then the constructor of <code>A</code> would have Object’s constructor as its prototype
+(depicted in as a dashed red arrow), which would make a more consistent overall picture.
+</td>
+</tr>
+</table>
+</div>
+<div id="fig-constructors-and-prototypes" class="imageblock" style="text-align: center">
+<div class="content">
+<img src="chapters/04_types/fig/ctorsProtosInES6.svg" alt="ctorsProtosInES6">
+</div>
+<div class="title">Figure 5. Constructors and prototypes for two classes A and B in ECMAScript 2015 (not N4JS!)</div>
+</div>
+<div class="paragraph">
+<p>Base classes in the above sense are not available in N4JS.
+If an N4JS class does not provide an <code>extends</code> clause, it will implicitly inherit from built-in class <code>N4Object</code>,
+if it provides an <code>extends</code> clause stating <code>Object</code> as its super type, then it corresponds to what is shown in <a href="#fig-constructors-and-prototypes">Constructors and prototypes for two classes A and B in ECMAScript 2015 (not N4JS!)</a> with the red dashed arrow.</p>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="_this-type"><a class="anchor" href="#_this-type"></a><a class="link" href="#_this-type">4.12. This Type</a></h3>
+<div class="paragraph">
+<p>The <code>this</code> keyword may represent either a <code>this</code> literal (cf. <a href="#ex:this-keyword-and-type-in-instance-and-static-context">This keyword and type in instance and static context</a>) or may refer to the <code>this</code> type.
+In this section, we describe the latter case.</p>
+</div>
+<div class="paragraph">
+<p>Typical use cases of the <code>this</code> type include:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>declaring the return type of instance methods</p>
+</li>
+<li>
+<p>declaring the return type of static methods</p>
+</li>
+<li>
+<p>as formal parameter type of constructors in conjunction with use-site structural typing</p>
+</li>
+<li>
+<p>the parameter type of a function type expression, which appears as type of a method parameter</p>
+</li>
+<li>
+<p>the parameter type in a return type expression (<math xmlns="http://www.w3.org/1998/Math/MathML"><mi>t</mi><mi>y</mi><mi>p</mi><mi>e</mi></math><code>{this}</code>,<code>constructor{this}</code>)</p>
+</li>
+<li>
+<p>an existential type argument inside a return type expression for methods (e.g.<code>ArrayList&lt;? extends this&gt; method(){&#8230;&#8203;}</code>)</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>The precise rule where it may appear is given below in <a href="#Req-IDE-37">[Req-IDE-37]</a>.</p>
+</div>
+<div class="paragraph">
+<p>The <code>this</code> type is similar to a type variable, and it is bound to the declared or inferred type of the receiver.
+If it is used as return type, all return statements of the methods must return the <code>this</code> keyword or a variable value implicitly inferred to a <code>this</code> type (e.g. <code>var x = this; return x;</code>).</p>
+</div>
+<div class="listingblock">
+<div class="title">Simple This Type</div>
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">class A {
+    f(): this {
+        return this;
+    }
+})
+class B extends A {}
+
+var a: A; var b: B;
+a.f(); // returns something with the type of A
+b.f(); // returns something with the type of B</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p><code>this</code> can be thought of as a type variable which is implicitly substituted with the declaring class (i.e. this type used in a class <code>{A}</code> actually means <code>&lt;? extends A&gt;</code>).</p>
+</div>
+<div class="sect3">
+<h4 id="this-type-syntax"><a class="anchor" href="#this-type-syntax"></a><a class="link" href="#this-type-syntax">4.12.1. Syntax</a></h4>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">ThisTypeRef returns ThisTypeRef:
+    ThisTypeRefNominal | ThisTypeRefStructural;
+
+ThisTypeRefNominal returns ThisTypeRefNominal:
+    {ThisTypeRefNominal} 'this'
+;
+
+ThisTypeRefStructural  returns ThisTypeRefStructural:
+        typingStrategy=TypingStrategyUseSiteOperator
+        'this'
+        ('with' '{' ownedStructuralMembers+=TStructMember* '}')?
+;</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>The keyword <code>this</code> and the type expression <code>this</code> look similar, however they can refer to different types.
+The type always refers to the type of instances of a class.
+The <code>this</code> keyword refers to the type of instances of the class in case of instance methods, but to the classifier the of the class in case of static methods.
+See <a href="grammar.html#_this-keyword">This Keyword</a> for details.</p>
+</div>
+<div id="ex:this-keyword-and-type-in-instance-and-static-context" class="exampleblock">
+<div class="title">Example 24. This keyword and type in instance and static context</div>
+<div class="content">
+<div class="paragraph">
+<p>Note that the following code is not working, because some usages below are
+not valid in N4JS. This is only to demonstrate the types.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">class C {
+    instanceMethod() {
+        var c: this = this;
+    }
+    static staticMethod() {
+        var C: type{this} = this;
+    }
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Structural typing and additional members in structural referenced types is described in <a href="classifiers.html#_structural-typing">Structural Typing</a>.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="this-keyword-semantics"><a class="anchor" href="#this-keyword-semantics"></a><a class="link" href="#this-keyword-semantics">4.12.2. Semantics</a></h4>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-37"></a><strong>Req. IDE-37:</strong> <a href="#Req-IDE-37">This Type</a> (ver. 1)</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>this</code> used in the context of a class is actually inferred to an existential type <code>? extends A</code> inside the class itself.</p>
+</li>
+<li>
+<p>the <code>this</code> type may only be used</p>
+<div class="ulist">
+<ul>
+<li>
+<p>as the type of a formal parameter of a constructor, if and only if combined with use-site structural typing.</p>
+</li>
+<li>
+<p>at covariant positions within member declarations, except for static members of interfaces.</p>
+</li>
+</ul>
+</div>
+</li>
+</ul>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Remarks</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Due to the function subtype relation and constraints on overriding methods (in which the overriding method has to be a subtype of the overridden method),
+it is not possible to use the <code>this</code> type in formal parameters but only as return type. The following listing demonstrates that problem:</p>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">class A {
+    bar(x: this): void { ... } // error
+    // virtually defines: bar(x: A): void
+}
+class B extends A {
+    // virtually defines: bar(x: B): void
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>As the <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>t</mi><mi>h</mi><mi>i</mi><mi>s</mi></math> type is replaced similar to a type variable, the virtually defined method <code>bar</code> in is not override compatible with <code>bar</code> in <code>A</code>.</p>
+</div>
+<div class="paragraph">
+<p>In case of constructors, this problem does not occur because a subclass constructor does not need to be override compatible with the constructor of the super class.
+Using <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>t</mi><mi>h</mi><mi>i</mi><mi>s</mi></math> as the type of a constructor’s parameter, however, would mean that you can only create an instance of the class if you already have
+an instance (considering that due to the lack of method overloading a class can have only a single constructor), making creation of the first instance impossible.
+Therefore, <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>t</mi><mi>h</mi><mi>i</mi><mi>s</mi></math> is also disallowed as the type of a constructor’s parameter.</p>
+</div>
+</li>
+<li>
+<p>The difference between the type <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>t</mi><mi>h</mi><mi>i</mi><mi>s</mi></math> and the keyword <code>this</code> is when and how theactual type is set:
+the actual type of the <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>t</mi><mi>h</mi><mi>i</mi><mi>s</mi></math> type is computed at compile(or validation) time and is always the containing type (of the member in which the type expression is used)
+or a subtype of that type – this isnot a heuristic, this is so by definition.
+In contrast, the actual typeof the keyword <code>this</code> is only available at runtime, while the type used at compilation time is only a heuristically-computed type, in other words,a good guess.</p>
+</li>
+<li>
+<p>The value of the <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>t</mi><mi>h</mi><mi>i</mi><mi>s</mi></math> type is, in fact, not influenced by any <code>@This</code> annotations.
+Instead of using <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>t</mi><mi>h</mi><mi>i</mi><mi>s</mi></math> in these cases, the type expressions in the <code>@This</code> annotations can be used.</p>
+</li>
+<li>
+<p>The <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>t</mi><mi>h</mi><mi>i</mi><mi>s</mi></math> type is always bound to the instance-type regardless of the context it occurs in (non-static or static).
+To refer to the this-classifier (static type) the construct <code>type{this}</code> is used.</p>
+</li>
+</ul>
+</div>
+<div style="page-break-after: always;"></div>
+<div class="exampleblock">
+<div class="title">Example 25. This type in function-type-expression</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">class A {
+    alive: boolean = true;
+    methodA(func: {function(this)}): string {
+       func(this);   // applying the passed-in function
+       return "done";
+    }
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>The use of <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>t</mi><mi>h</mi><mi>i</mi><mi>s</mi></math> type is limited to situations where it cannot be referred in mixed co- and contra-variant ways.
+In the following example the problem is sketched up. <sup class="footnote">[<a id="_footnoteref_26" class="footnote" href="appendix_c_bibliography.html#_footnote_26" title="View footnote.">26</a>]</sup></p>
+</div>
+<div class="exampleblock">
+<div class="title">Example 26. Problems with this type and type arguments</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">// Non-working example, see problem in line 15.
+class M&lt;V&gt; {  public value: V;  }
+class A {
+    public store: M&lt;{function(this)}&gt;; // usually not allowed, but let's assume it would be possible----
+}
+class B extends A { public x=0; } // type of store is M&lt;{function(B)}&gt;
+
+var funcA = function(a: A) {/*...something with a...*/}
+var funcB = function(b: B) { console.log(b.x); }
+var a: A = new A();  var b: B = new B();
+b.store.value = funcA  // OK, since {function(A)} &lt;: {function(B)}
+b.store.value = funcB  // OK.
+
+var a2: A = b; // OK, since B is a subtype of A
+a2.store.value( a ) // RUNTIME ERROR, the types are all correct, but remember b.store.value was assigned to funcB, which can only handle subtypes of B!</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="_enums"><a class="anchor" href="#_enums"></a><a class="link" href="#_enums">4.13. Enums</a></h3>
+<div class="paragraph">
+<p>Enums are an ordered set of literals.
+Although enums are not true classes, they come with built-in methods for accessing value, name and type name of the enum.</p>
+</div>
+<div class="paragraph">
+<p>In N4JS, two flavours of enumerations are distinguished: ordinary enums (N4JS) and string based enums.
+Ordinary enums (or in short, enums) are used while programming in N4JS.
+String based enums are introduced to access enumerations derived from standards, mainly developed by the W3C, in order to access the closed set of string literals defined in webIDL syntax.</p>
+</div>
+<div class="sect3">
+<h4 id="_enums-n4js"><a class="anchor" href="#_enums-n4js"></a><a class="link" href="#_enums-n4js">4.13.1. Enums (N4JS)</a></h4>
+<div class="paragraph">
+<p>Definition and usage of an enumeration:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">// assume this file to be contained in a package "myPackage"
+enum Color {
+    RED, GREEN, BLUE
+}
+
+enum Country {
+    DE : "276",
+    US : "840",
+    TR : "792"
+}
+
+var red: Color = Color.RED;
+var us: Country = Country.US;
+
+console.log(red.name); // --&gt; RED
+console.log(red.value); // --&gt; RED
+console.log(red.n4class.fqn); // --&gt; myPackage.Color
+console.log(red.toString()); // --&gt; RED
+
+console.log(us.name); // --&gt; US
+console.log(us.value); // --&gt; 840
+console.log(us.n4classfqn); // --&gt; myPackage.Country
+console.log(us.toString()); // --&gt; 840</code></pre>
+</div>
+</div>
+<div class="sect4">
+<h5 id="enums-syntax"><a class="anchor" href="#enums-syntax"></a><a class="link" href="#enums-syntax">4.13.1.1. Syntax</a></h5>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xtext" data-lang="xtext">N4EnumDeclaration &lt;Yield&gt;:
+	=&gt;(	{N4EnumDeclaration}
+		(declaredModifiers+=N4Modifier)*
+		'enum' name=BindingIdentifier&lt;Yield&gt;? )
+	'{'
+		(literals+=N4EnumLiteral (',' literals+=N4EnumLiteral)*)?
+	'}';
+
+N4EnumLiteral: name=IdentifierName (':' value=STRING)?;</code></pre>
+</div>
+</div>
+</div>
+<div class="sect4 language-n4js">
+<h5 id="enums-semantics"><a class="anchor" href="#enums-semantics"></a><a class="link" href="#enums-semantics">4.13.1.2. Semantics</a></h5>
+<div class="paragraph">
+<p>The enum declaration <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>E</mi></math> is of type <code>type{E}</code> and every enumeration is implicitly derived from <code>N4Enum</code>.
+There are similarities to other languages such as Java, for example, where the literals of an enum are treated as final static fields with the type
+of the enumeration and the concrete enumeration provides specific static methods including the literals.
+This leads to the following typing rules:</p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-38"></a><strong>Req. IDE-38:</strong> <a href="#Req-IDE-38">Enum Type Rules</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>For a given enumeration declaration <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>E</mi></math> with literals <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>L</mi></math>, the following type rules are defined:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Every enumeration <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>E</mi></math> is a subtype of the base type <code>N4Enum</code>:</p>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow/><mrow><mi>Γ</mi><mo>⊢</mo><mi>E</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>N</mi><mn>4</mn><mi>E</mi><mi>n</mi><mi>u</mi><mi>m</mi></mrow></mfrac><mrow/></math>
+</div>
+</div>
+<div class="paragraph">
+<p>which itself is a subtype of <code>Object</code>:</p>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow/><mrow><mi>N</mi><mn>4</mn><mi>E</mi><mi>n</mi><mi>u</mi><mi>m</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>O</mi><mi>b</mi><mi>j</mi><mi>e</mi><mi>c</mi><mi>t</mi></mrow></mfrac></math>
+</div>
+</div>
+</li>
+<li>
+<p>Every literal <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>L</mi></math> of an enumeration <math xmlns="http://www.w3.org/1998/Math/MathML"><mi>E</mi></math> is
+of the type of the enumeration:</p>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><mi>L</mi><mo>∈</mo><mi>E</mi><mo>.</mo><mi>l</mi><mi>i</mi><mi>t</mi><mi>e</mi><mi>r</mi><mi>a</mi><mi>l</mi><mi>s</mi></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mi>L</mi><mi>:</mi><mi>E</mi></mrow></mfrac></math>
+</div>
+</div>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>This means that every literal is a subtype of <code>N4Enum</code> and <code>Object</code>:</p>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><mi>L</mi><mo>∈</mo><mi>E</mi><mo>.</mo><mi>l</mi><mi>i</mi><mi>t</mi><mi>e</mi><mi>r</mi><mi>a</mi><mi>l</mi><mi>s</mi></mrow><mrow><mi>L</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>N</mi><mn>4</mn><mi>E</mi><mi>n</mi><mi>u</mi><mi>m</mi><mo>∧</mo><mi>L</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mi>O</mi><mi>b</mi><mi>j</mi><mi>e</mi><mi>c</mi><mi>t</mi></mrow></mfrac></math>
+</div>
+</div>
+<div class="paragraph">
+<p>The base enumeration type <code>N4Enum</code> is defined as follows:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">/**
+ * Base class for all enumeration, literals are assumed to be static constant fields of concrete subclasses.
+ */
+public object N4Enum {
+
+    /**
+     * Returns the name of a concrete literal
+     */
+    public get name(): string
+
+    /**
+     * Returns the value of a concrete literal. If no value is
+     * explicitly set, it is similar to the name.
+     */
+    public get value(): string
+
+    /**
+     * Returns a string representation of a concrete literal, it returns
+     * the same result as value()
+     */
+     public toString(): string
+
+    /**
+     * Returns the meta class object of this enum literal for reflection.
+     * The very same meta class object can be retrieved from the enumeration type directly.
+     */
+    public static get n4type(): N4EnumType
+
+    //IDE-785 this as return type in static
+
+    /**
+     * Returns array of concrete enum literals
+     */
+    public static get literals(): Array&lt;? extends this&gt;
+
+    /**
+     * Returns concrete enum literal that matches provided name,
+     * if no match found returns undefined.
+     */
+    public static findLiteralByName(name: string): this
+
+    /**
+     * Returns concrete enum literal that matches provided value,
+     * if no match found returns undefined.
+     */
+    public static findLiteralByValue (value: string): this
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-39"></a><strong>Req. IDE-39:</strong> <a href="#Req-IDE-39">Unique literal names</a> (ver. 1)</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><math xmlns="http://www.w3.org/1998/Math/MathML"><mo>∀</mo><mi>i</mi><mo>,</mo><mi>j</mi><mi>:</mi><mi>l</mi><mi>i</mi><mi>t</mi><mi>e</mi><mi>r</mi><mi>a</mi><mi>l</mi><mi>s</mi><mfenced close="]" open="["><mi>i</mi></mfenced><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>=</mo><mi>l</mi><mi>i</mi><mi>t</mi><mi>e</mi><mi>r</mi><mi>a</mi><mi>l</mi><mi>s</mi><mfenced close="]" open="["><mi>j</mi></mfenced><mo>.</mo><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo>⇔</mo><mi>i</mi><mo>=</mo><mi>j</mi></math></p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Literal names have to be unique.</p>
+</div>
+</div>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-40"></a><strong>Req. IDE-40:</strong> <a href="#Req-IDE-40">Enum Literals are Singletons</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>Enum literals are singletons:</p>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mo>∀</mo><msub><mi>e</mi><mn>1</mn></msub><mo>,</mo><msub><mi>e</mi><mn>2</mn></msub><mo>,</mo><mi>μ</mi><mfenced close=")" open="("><msub><mi>e</mi><mn>1</mn></msub></mfenced><mo>=</mo><mi>μ</mi><mfenced close=")" open="("><msub><mi>e</mi><mn>2</mn></msub></mfenced><mo>=</mo><mstyle mathvariant="monospace"><mtext>N4EnumLiteral</mtext></mstyle><mo>∧</mo><mi>Γ</mi><mo>⊢</mo><msub><mi>e</mi><mn>1</mn></msub><mo>=</mo><mi>Γ</mi><mo>⊢</mo><msub><mi>e</mi><mn>2</mn></msub><mi>:</mi><msub><mi>e</mi><mn>1</mn></msub><mo>=</mo><mo>=</mo><msub><mi>e</mi><mn>2</mn></msub><mo>⇔</mo><msub><mi>e</mi><mn>1</mn></msub><mo>=</mo><mo>=</mo><mo>=</mo><msub><mi>e</mi><mn>2</mn></msub></math>
+</div>
+</div>
+</div>
+</div>
+<div class="exampleblock">
+<div class="title">Example 27. Enumeration List</div>
+<div class="content">
+<div class="paragraph">
+<p>Due to the common base type <code>N4Enum</code> it is possible to define generics accepting only enumeration, as shown in this example:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">enum Color { R, G, B}
+
+class EList&lt;T extends N4Enum&gt; {
+    add(t: T) {}
+    get(): T { return null; }
+}
+
+var colors: EList&lt;Color&gt;;
+colors.add(Color.R);
+var c: Color = colors.get();</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_string-based-enums"><a class="anchor" href="#_string-based-enums"></a><a class="link" href="#_string-based-enums">4.13.2. String-Based Enums</a></h4>
+<div class="paragraph">
+<p>In current web standards [<a href="appendix_c_bibliography.html#W3C:Steen:14:XL">W3C:Steen:14:XL</a>], definitions of enumerations are often given in webIDL syntax.
+While the webIDL-definition assembles a set of unique string literals as a named enum-entity, the language binding to ECMAScript refers to the usage of the members of these enumerations only.
+Hence, if an element of an enumeration is stored in a variable or field, passed as a parameter into a method or function or given back as a result, the actual type in JavaScript will be <code>string</code>.
+To provide the N4JS user with some validations regarding the validity of a statement at compile time, a special kind of subtypes of <code>string</code> are introduced: the string-based enum using the <code>@StringBased</code> annotation.
+(See also other string-based types like <code>typename&lt;T&gt;</code> <code>pathSelector&lt;T&gt;</code> and <code>i18nKey</code> in <a href="#_primitive-pathselector-and-i18nkey">Primitive Pathselector and I18nKey</a>.)</p>
+</div>
+<div class="paragraph">
+<p>String-based enums do not have any kind of runtime representation; instead, the transpiler will replace each reference to a literal of a string-based enum by a corresponding string literal in the output code.
+Furthermore, no meta-information is available for string-based enums, i.e. the <code>n4type</code> property is not available.
+The only exception is the static getter <code>literals</code>: it is available also for string-based enums and has the same meaning.
+In case of string-based enums, however, there won’t be a getter used at runtime; instead, the transpiler replaces every read access to this getter by an array literal containing a string literal for each of the enum’s literals.</p>
+</div>
+<div class="openblock requirement">
+<div class="content">
+<div class="paragraph">
+<p><a id="Req-IDE-41"></a><strong>Req. IDE-41:</strong> <a href="#Req-IDE-41">String-Based Enum Type Rules</a> (ver. 1)</p>
+</div>
+<div class="paragraph">
+<p>For a string-based enum declaration <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>E</mi><mi>S</mi></msub></math> with literals <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>L</mi><mi>S</mi></msub></math> the following type rules are defined:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Every string-based enumeration <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>E</mi><mi>S</mi></msub></math> is a subtype of the base type <code>N4StringBasedEnum</code>:</p>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow/><mrow><mi>Γ</mi><mo>⊢</mo><mstyle mathvariant="monospace"><mtext>type</mtext></mstyle><mfenced close="}" open="{"><msub><mi>E</mi><mi>S</mi></msub></mfenced><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mstyle mathvariant="monospace"><mtext>N4StringBasedEnum</mtext></mstyle></mrow></mfrac><mrow/></math>
+</div>
+</div>
+<div class="paragraph">
+<p>which itself is not related to the standard enumeration type <code>N4Enum</code></p>
+</div>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mtable><mtr><mtd><mfrac><mrow/><mrow><mstyle mathvariant="monospace"><mtext>N4StringBasedEnum</mtext></mstyle><mspace width="1.0mm"/><mo>≮</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mstyle mathvariant="monospace"><mtext>N4Enum</mtext></mstyle></mrow></mfrac></mtd></mtr><mtr><mtd><mfrac><mrow/><mrow><mstyle mathvariant="monospace"><mtext>N4Enum</mtext></mstyle><mspace width="1.0mm"/><mo>≮</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mstyle mathvariant="monospace"><mtext>N4StringBasedEnum</mtext></mstyle></mrow></mfrac></mtd></mtr></mtable></math>
+</div>
+</div>
+</li>
+<li>
+<p><code>N4StringBasedEnum</code> is a subtype of <code>string</code></p>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mtable><mtr><mtd><mfrac><mrow/><mrow><mstyle mathvariant="monospace"><mtext>N4StringBasedEnum</mtext></mstyle><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><mstyle mathvariant="monospace"><mtext>string</mtext></mstyle></mrow></mfrac></mtd></mtr></mtable></math>
+</div>
+</div>
+</li>
+<li>
+<p>Each literal in <math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>L</mi><mi>S</mi></msub></math> of a string-based enumeration
+<math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>E</mi><mi>S</mi></msub></math> is of the type of the string-based enumeration.</p>
+<div class="openblock">
+<div class="content">
+<math xmlns="http://www.w3.org/1998/Math/MathML" display="block"><mfrac><mrow><mi>l</mi><mo>∈</mo><msub><mi>E</mi><mi>S</mi></msub><mo>.</mo><msub><mi>L</mi><mi>S</mi></msub></mrow><mrow><mi>Γ</mi><mo>⊢</mo><mi>l</mi><mspace width="1.0mm"/><mo>&lt;</mo><mstyle mathvariant="monospace"><mtext>:</mtext></mstyle><mspace width="1.0mm"/><msub><mi>E</mi><mi>S</mi></msub></mrow></mfrac></math>
+</div>
+</div>
+</li>
+<li>
+<p><a href="#Req-IDE-39">[Req-IDE-39]</a> also applies for <code>N4StringBasedEnum</code>.</p>
+</li>
+<li>
+<p><a href="#Req-IDE-40">[Req-IDE-40]</a> also applies for <code>N4StringBasedEnum</code>.</p>
+</li>
+<li>
+<p>References to string-based enums may only be used in the following places:</p>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p>in type annotations</p>
+</li>
+<li>
+<p>in property access expressions to refer to one of the enum’s literals</p>
+</li>
+<li>
+<p>in property access expressions to read from the static getter <code>literals</code></p>
+<div class="paragraph">
+<p>In particular, it is invalid to use the type of a string-based enum as a
+value, as in</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">    @StringBased enum Color { RED, GREEN, BLUE }
+    var c = Color;</code></pre>
+</div>
+</div>
+</li>
+</ol>
+</div>
+</li>
+</ol>
+</div>
+<div class="exampleblock">
+<div class="title">Example 28. WebIDL example</div>
+<div class="content">
+<div class="listingblock">
+<div class="title">Gecko-Engine webIDL XMLHttpRequestResponseType as taken from [<a href="appendix_c_bibliography.html#W3C:Steen:14:XL">W3C:Steen:14:XL</a>]</div>
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">enum XMLHttpRequestResponseType {
+  "",
+  "arraybuffer",
+  "blob",
+  "document",
+  "json",
+  "text" //, ... and some mozilla-specific additions
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Compatible Definition of this Enumeration in N4JS, provided through a
+runtime-library definition:</p>
+</div>
+<div class="listingblock">
+<div class="title">File in source-folder: w3c/dom/XMLHttpRequestResponseType.n4js</div>
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">@StringBased enum XMLHttpRequestResponseType {
+  vacant : "",
+  arrayBuffer : "arraybuffer",
+  blob : "blob",
+  document : "document",
+  json : "json",
+  text : "text"
+ }</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Usage of the enumeration in the definition files of the runtime-library.
+Note the explicit import of the enumeration.</p>
+</div>
+<div class="listingblock">
+<div class="title">XMLHttpRequestResponse.n4jsd</div>
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">@@ProvidedByRuntime
+import XMLHttpRequestResponseType from "w3c/dom/XMLHttpRequestResponseType";
+@Global
+export external public class XMLHttpRequestResponse extends XMLHttpRequestEventTarget {
+  // ...
+  // Setter Throws TypeError Exception
+  public responseType: XMLHttpRequestResponseType;
+  // ...
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Client code importing the runtime-library as defined above can now use the Enumeration in a type-safe way:</p>
+</div>
+<div class="listingblock">
+<div class="title">String-Based Enumeration Usage</div>
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">import XMLHttpRequestResponseType from "w3c/dom/XMLHttpRequestResponseType";
+
+public function process(req: XMLHttpRequest) : void {
+  if( req.responseType == XMLHttpRequestResponseType.text ) {
+    // do stuff ...
+  } else {
+       // signal unrecognized type.
+       var errMessage: req.responseType + " is not supported"; // concatination of two strings.
+       show( errMessage );
+  }
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2 language-n4js">
+<h3 id="_short-hand-syntax"><a class="anchor" href="#_short-hand-syntax"></a><a class="link" href="#_short-hand-syntax">4.14. Short-Hand Syntax</a></h3>
+<div class="paragraph">
+<p>Short-hand syntax is available for a number of built-in types.</p>
+</div>
+<div class="sect3">
+<h4 id="_array-short-hand-syntax"><a class="anchor" href="#_array-short-hand-syntax"></a><a class="link" href="#_array-short-hand-syntax">4.14.1. Array Short-Hand Syntax</a></h4>
+<div class="paragraph">
+<p>For the built-in type <code>Array</code> a convenience short form is available. Thus, writing</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">let arr: string[];</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>is equivalent to</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">let arr: Array&lt;string&gt;;</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Multi-dimensional arrays can be declared as such:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">let arr: string[][][];</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>which is equivalent to</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">let arr: Array&lt;Array&lt;Array&lt;string&gt;&gt;&gt;;</code></pre>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_iterablen-short-hand-syntax"><a class="anchor" href="#_iterablen-short-hand-syntax"></a><a class="link" href="#_iterablen-short-hand-syntax">4.14.2. IterableN Short-Hand Syntax</a></h4>
+<div class="paragraph">
+<p>The built-in IterableN types (i.e. <code>Iterable2</code>, <code>Iterable3</code>, &#8230;&#8203; <code>Iterable9</code>, see <a href="#IterableN">IterableN</a>) are
+also provided with a short-hand syntax. For example, writing</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">let i3: [string,number,string[]];</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>would be equivalent to</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">let i3: Iterable3&lt;string,number,Array&lt;string&gt;&gt;;</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Note the following special cases:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">let i0: [];
+let i1: [string];
+let union: string|number[];</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>which is equivalent to</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-n4js" data-lang="n4js">let i0: Iterable&lt;?&gt;;
+let i1: Iterable&lt;string&gt;;
+let union: union{string,Array&lt;number&gt;}; // not: Array&lt;union{string,number}&gt;</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Further note: while this syntax is very similar to TypeScript&#8217;s tuple syntax, the semantics
+of tuples and IterableN are very different.</p>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div id="footer">
+<div id="footer-text">
+Version 0.9<br>
+Last updated 2019-08-07 15:02:40 CEST
+</div>
+</div>
+<!-- ************* docinfo-footer *************************************************************** -->
+<div class="Grid social" style="color:#d5dfea">
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <h2>Quick Links</h2>
+    <ul>
+      <li><a href="../downloads.html">Download</a></li>
+      <li><a href="../userguides/index.html">Documentation</a></li>
+      <li><a href="https://github.com/eclipse/n4js/">Source</a></li>
+      <li><a href="https://github.com/eclipse/n4js/issues">Issues</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="https://www.eclipse.org/forums/index.php/f/365/">Forum</a></li>
+      <li><a href="http://n4js.blogspot.de/">Blog</a></li>
+      <li><a href="https://dev.eclipse.org/mailman/listinfo/n4js-dev">Mailing List</a></li>
+      <li><a href="https://projects.eclipse.org/projects/technology.n4js">Eclipse Project Page</a></li>
+      <li><a href="https://twitter.com/n4jsdev">Tweets by n4jsdev</a></li>
+    </ul>
+  </div>
+  <div class="Cell Cell--2-12 m-Cell--withMargin">
+    <br/><br/>
+    <ul>
+      <li><a href="http://www.eclipse.org/">Eclipse Home</a></li>
+      <li><a href="http://www.eclipse.org/legal/privacy.php">Privacy Policy</a></li>
+      <li><a href="http://www.eclipse.org/legal/termsofuse.php">Terms of Use</a></li>
+      <li><a href="http://www.eclipse.org/legal/copyright.php">Copyright Agent</a></li>
+      <li><a href="http://www.eclipse.org/legal/">Legal</a></li>
+    </ul>
+  </div>
+  <div style="clear: both; height: 0; overflow: hidden;"></div>
+</div>
+
+<!-- ************* UI Scripts ************* -->
+<script type="text/javascript" src="scripts/back-to-top.js"></script>
+
+<script type="text/javascript" src="scripts/treeview.js"></script>
+<script type="text/javascript" src="scripts/toc.js"></script>
+
+<!-- ************* Prism.js Syntax Highlighting ************* -->
+<script src="scripts/prism.js"></script>
+
+<script type="text/javascript">
+	// Add the 'toclist' id for search function
+	$(".toc2 > ul").attr('id', 'toclist');
+	// Generate a Search input form
+	$("#toclist > li:first-of-type").before('<input type="text" id="pagesearch" onkeyup="search()" placeholder="Search for section...">');
+	$("#toclist > li:first-of-type").before('<i id="clear" class="fa fa-times-circle-o"></i>');
+	$("#clear").click(function(){
+	    $("#pagesearch").val('');
+	    search();
+	    $('.toc2 > ul').treeView('collapseAll');
+	});
+	// intialize Treeview.js
+	$(".toc2 > ul").treeView();
+	// Initialize Scrollspy
+</script>
+<!-- ************* docinfo-footer *************************************************************** -->
+</body>
+</html>
\ No newline at end of file
diff --git a/userguides/index.html b/userguides/index.html
index 1281d77..3e64c21 100644
--- a/userguides/index.html
+++ b/userguides/index.html
@@ -235,7 +235,7 @@
 </tr>
 </table>
 </div>
-<hr>
+
 </div>
 </div>
 </div>
@@ -271,20 +271,56 @@
 </div>
 
 <div class="sect1">
-<h2 id="_n4js_language_specification"><a class="link" href="#_n4js_language_specification">N4JS Language Specification</a></h2>
+<h2 id="_specifications"><a class="link" href="_specification">Specifications</a></h2>
 <div class="sectionbody">
+
+<h3 id="_n4js_language_specification"><a class="link" href="#_n4js_language_specification">N4JS Language Specification</a></h3>
 <div class="paragraph">
 <p>For a complete reference of the N4JS Language, the Specification is available at the following location:</p>
 </div>
 <div class="ulist">
 <ul>
 <li>
-<p><a href="https://www.eclipse.org/n4js/spec/N4JSSpec.html">N4JS Language Specification</a></p>
+<p><a href="../spec/index.html">N4JS Language Specification</a></p>
 </li>
 </ul>
+This is an HTML version of the asciidoc based documentation <a href="https://github.com/eclipse/n4js/tree/master/docs/org.eclipse.n4js.spec">on Github</a>.
+The language specification is also available in the Eclipse help of the N4JS IDE itself.
+</div>
+
+<h3 id="_n4js_ide_specification"><a class="link" href="#_n4js_ide_specification">N4JS IDE Specification</a></h3>
+<div class="paragraph">
+<p>For a reference of the N4JS IDE, i.e. the specific views and UI features of the Eclipse based IDE, the Specification is available at the following location:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><a href="../idespec/index.html">N4JS IDE Specification</a></p>
+</li>
+</ul>
+This is an HTML version of the asciidoc based documentation <a href="https://github.com/eclipse/n4js/tree/master/docs/org.eclipse.n4js.ide.spec">on GitHub</a>.
+The IDE specification is also available in the Eclipse help of the N4JS IDE itself.
+</div>
+
+
+<h3 id="_n4js_design"><a class="link" href="#_n4js_design">N4JS Design Documentation</a></h3>
+<div class="paragraph">
+<p>The design and other internal information valuable for contributors to Eclipse N4JS can be found at the following location:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><a href="../design/index.html">N4JS Design Documentation</a></p>
+</li>
+</ul>
+This is an HTML version of the asciidoc based documentation <a href="https://github.com/eclipse/n4js/tree/master/docs/org.eclipse.n4js.design">on GitHub</a>.
+</div>
+
+
 </div>
 </div>
-</div>
+<hr>
+
 <div class="sect1">
 <h2 id="_release_notes"><a class="link" href="#_release_notes">Release Notes</a></h2>
 <div class="sectionbody">